Halaman ini diterjemahkan oleh Cloud Translation API.

Azure DevOps

Konektor Azure DevOps memungkinkan Anda melakukan operasi penyisipan, penghapusan, pembaruan, dan pembacaan pada data Azure DevOps.

Versi yang didukung

Konektor ini mendukung versi Azure DevOps berikut.

Azure DevOps 2022, 2020, 2019
Team Foundation Server 2018

Sebelum memulai

Di project Google Cloud Anda, lakukan tugas berikut:

Pastikan konektivitas jaringan telah disiapkan. Untuk mengetahui informasi tentang pola jaringan, lihat Konektivitas jaringan.
Berikan peran IAM roles/connectors.admin kepada pengguna yang mengonfigurasi konektor.
Berikan peran IAM roles/secretmanager.viewer dan roles/secretmanager.secretAccessor ke akun layanan yang ingin Anda gunakan untuk konektor.
Aktifkan layanan berikut:
- secretmanager.googleapis.com (Secret Manager API)
- connectors.googleapis.com (Connectors API)
Untuk memahami cara mengaktifkan layanan, lihat Mengaktifkan layanan. Jika layanan atau izin ini belum diaktifkan untuk project Anda sebelumnya, Anda akan diminta untuk mengaktifkannya saat mengonfigurasi konektor.

Mengonfigurasi konektor

Koneksi khusus untuk sumber data. Artinya, jika Anda memiliki banyak sumber data, Anda harus membuat koneksi terpisah untuk setiap sumber data. Untuk membuat koneksi, lakukan hal berikut:

Di Konsol Cloud, buka halaman Integration Connectors > Connections lalu pilih atau buat project Google Cloud.
Buka halaman Koneksi
Klik + BUAT BARU untuk membuka halaman Buat Koneksi.
Di bagian Location, pilih lokasi untuk koneksi.
1. Wilayah: Pilih lokasi dari menu drop-down.
  Untuk mengetahui daftar semua region yang didukung, lihat Lokasi.
2. Klik NEXT.
Di bagian Detail Koneksi, selesaikan langkah-langkah berikut:
1. Konektor: Pilih Azure DevOps dari daftar drop-down Konektor yang tersedia.
2. Versi konektor: Pilih versi Konektor dari daftar drop-down versi yang tersedia.
3. Di kolom Connection Name, masukkan nama untuk instance Koneksi.
  Nama koneksi harus memenuhi kriteria berikut:
  - Nama koneksi dapat menggunakan huruf, angka, atau tanda hubung.
  - Huruf harus berupa huruf kecil.
  - Nama koneksi harus diawali dengan huruf dan diakhiri dengan huruf atau angka.
  - Nama koneksi tidak boleh melebihi 49 karakter.
4. Secara opsional, masukkan Deskripsi untuk instance koneksi.
5. Secara opsional, aktifkan Cloud Logging, lalu pilih level log. Secara default, level log ditetapkan ke Error.
6. Akun Layanan: Pilih akun layanan yang memiliki peran yang diperlukan.
7. Jika perlu, konfigurasikan Setelan node koneksi:
  - Jumlah minimum node: Masukkan jumlah minimum node koneksi.
  - Jumlah node maksimum: Masukkan jumlah maksimum node koneksi.
  Node adalah unit (atau replika) koneksi yang memproses transaksi. Jumlah node yang diperlukan untuk memproses lebih banyak transaksi untuk suatu koneksi akan bertambah dan sebaliknya, jumlah node yang diperlukan untuk memproses lebih sedikit transaksi akan berkurang. Untuk memahami pengaruh node terhadap harga konektor, lihat Harga untuk node koneksi. Jika Anda tidak memasukkan nilai apa pun, secara default node minimum ditetapkan ke 2 (untuk ketersediaan yang lebih baik) dan node maksimum ditetapkan ke 50.
8. Tenant Azure: Berikan nama atau ID tenant Azure DevOps.
9. Organisasi: Berikan nama organisasi atau kumpulan yang menggunakan Azure DevOps.
10. Skema: Masukkan skema, seperti informasi, project.
11. Katalog: Masukkan nama katalog.
12. Terapkan Transformasi: Masukkan daftar transformasi yang dipisahkan koma.
13. Edisi Azure DevOps: Masukkan edisi Azure DevOps.
14. Azure DevOps Service API: Masukkan versi Rest API Azure DevOps.
15. URL: Berikan URL instance Azure DevOps.
16. Sertakan Kolom Kustom: Pilih opsi ini untuk menyertakan kolom kustom dalam daftar kolom.
17. Secara opsional, klik + TAMBAHKAN LABEL untuk menambahkan label ke Koneksi dalam bentuk pasangan kunci/nilai.
18. Klik NEXT.
Di bagian Destinations, masukkan detail host jarak jauh (sistem backend) yang ingin Anda hubungkan.
1. Jenis Tujuan: Pilih Jenis Tujuan.
  - Untuk menentukan nama host atau alamat IP tujuan, pilih Alamat host dan masukkan alamat di kolom Host 1.
  - Untuk membuat koneksi pribadi, pilih Endpoint attachment dan pilih lampiran yang diperlukan dari daftar Endpoint Attachment.
    Catatan: Untuk memahami cara membuat lampiran endpoint, lihat Lampiran layanan PSC dan lampiran endpoint. Setelah Anda membuat lampiran endpoint, lampiran tersebut akan terlihat dalam daftar Lampiran Endpoint.
  Jika ingin membuat koneksi publik ke sistem backend dengan keamanan tambahan, Anda dapat mempertimbangkan mengonfigurasi alamat IP keluar statis untuk koneksi Anda, lalu mengonfigurasi aturan firewall untuk hanya mengizinkan alamat IP statis tertentu.
  
  Untuk memasukkan tujuan tambahan, klik +TAMBAHKAN TUJUAN.
2. Klik NEXT.
Di bagian Authentication, masukkan detail autentikasi.
1. Pilih Jenis autentikasi dan masukkan detail yang relevan.
  Jenis autentikasi berikut didukung oleh koneksi Azure DevOps:
  - AzureAD
  - Dasar
2. Klik NEXT.
Tinjau: Tinjau detail koneksi dan autentikasi Anda.
Klik Buat.

Mengonfigurasi autentikasi

Masukkan detail berdasarkan autentikasi yang ingin Anda gunakan.

AzureAD
- ClientID: Masukkan client ID untuk aplikasi yang Anda buat.
- Cakupan: Tentukan semua cakupan yang dipisahkan dengan koma, seperti read, write.
- Rahasia Klien: Masukkan secret manager secret yang berisi rahasia klien untuk aplikasi terhubung yang Anda buat.
- Versi Secret: Pilih versi secret untuk secret yang dipilih di atas.
- URL otorisasi: Berikan URL otorisasi klien.

Dasar
- Personal Access Token: Masukkan token akses pribadi yang dibuat.
- Versi Secret: Pilih versi secret untuk secret yang dimasukkan.

Contoh konfigurasi koneksi

Bagian ini mencantumkan contoh nilai untuk berbagai kolom yang Anda konfigurasi saat membuat koneksi.

Di Azure DevOps, berbagai skema data digunakan untuk mengatur dan mengelola berbagai aspek project. Setiap skema berfokus pada jenis data tertentu untuk menyusun informasi secara efektif berdasarkan kebutuhan project.

Model data project: Skema yang menentukan cara data terkait project, seperti item, repositori, pipeline, dan tim diatur, ditautkan, dan dikelola dalam Azure DevOps.
Model data informasi: Skema yang menentukan cara dokumentasi, metadata, dan artefak komunikasi disusun, disimpan, dan diakses di seluruh project Azure DevOps.
Model data repositori: Skema yang menentukan cara repositori kode, cabang, commit, permintaan pull, dan metadata terkait diatur dan dikelola dalam Azure DevOps.
Model data Analytics: Skema yang mengambil dan mengatur data historis dan real-time dari Azure DevOps untuk pelaporan, dasbor, dan analisis lanjutan.
Semua model data: Satu koneksi yang menyediakan akses ke semua model data dalam satu koneksi.

Nama kolom	Model informasi	Model project	Model repositori	Model Analytics	Semua model	Koneksi AzureAD
Lokasi	europe-west1	europe-west1	europe-west1	europe-west1	asia-east1	europe-west1
Konektor	Azure DevOps	Azure DevOps	Azure DevOps	Azure DevOps	Azure DevOps	Azure DevOps
Versi konektor	1	1	1	1	1	1
Nama Koneksi	azuredevops-informationmodel	azuredevops-projectmodel	azuredevops-repositorymodel	azuredevops-analyticsmodel	devops	azuredevops-oauth
Mengaktifkan Cloud Logging	Ya	Ya	Ya	Ya	Ya	Ya
Tingkat Log	Debug	Debug	Debug	Debug	Debug	Debug
Akun Layanan	Your_Project_Number@serviceaccount	Your_Project_Number@serviceaccount	Your_Project_Number@serviceaccount	Your_Project_Number@serviceaccount	Your_Project_Number@serviceaccount	Your_Project_Number@serviceaccount
Tenant Azure	Tenant_Id	Tenant_Id	Tenant_Id	Tenant_Id	Tenant_Id	Tenant_Id
Organisasi	Organization_Name	Organization_Name	Organization_Name	Organization_Name	Organization_Name	Organization_Name
Skema	Informasi	Project	Repository__RepositoryId	Analytics		Project
Katalog	Devops	Project_ProjectId	Project_ProjectId	Project_ProjectId		Project_ProjectId
Azure Dev Ops Edition	AzureDevOps Online	AzureDevOps Online	AzureDevOps Online	AzureDevOps Online	AzureDevOps Online	AzureDevOps Online
Azure Dev Ops Service API	6,0	6,0	6,0	6,0	6,0	6,0
Sertakan Kolom Kustom	Ya	Ya	Ya	Ya	Ya	Ya
CustomizedDefaultCatalogName	CustomizedDefaultCatalogName=Google				CustomizedDefaultCatalogName=Google
Jumlah minimum node	2	2	2	2	2	2
Jumlah maksimum node	50	50	50	50	50	50
Autentikasi	Ya	Ya	Ya	Ya	Ya	Ya
Dasar	Ya	Ya	Ya	Ya	Ya
Token API	Token API yang disediakan oleh aplikasi Anda	Token API yang disediakan oleh aplikasi Anda	Token API yang disediakan oleh aplikasi Anda	Token API yang disediakan oleh aplikasi Anda	Token API yang disediakan oleh aplikasi Anda
Versi rahasia	1	1	1	1	1	1
AzureAD						Ya
ID Klien						Client_Id
Nilai Rahasia Klien						Nilai Rahasia Klien
Cakupan						user_impersonation
URL otorisasi						https://login.microsoftonline.com/c6f32d0e-6725-4007-81c2-951e853061a6/oauth2/authorize

Anda dapat menggunakan properti koneksi berikut untuk mengelola data yang diambil dari Azure DevOps.

Katalog

Properti ini menentukan nama atau ID project yang ingin Anda hubungkan. Untuk mendapatkan daftar ID dan nama project, jalankan kueri SELECT terhadap tabel Project.

Untuk membuat kueri data project tertentu, tetapkan Catalog ke nama project atau ID-nya dalam format Project_projectname.
Jika nama project adalah dev dengan ID 2ee729d6-804d-4ece-84af-d5befa94abe8, tetapkan Catalog ke Project_dev atau Project_2ee729d6-804d-4ece-84af-d5befa94abe8.
Untuk membuat kueri data yang tidak bergantung pada project tertentu, tetapkan Katalog ke Devops. Jika nama katalognya adalah Devops, Anda dapat menggunakan nama apa pun sebagai pengganti Devops.

Skema

Properti ini menentukan skema yang akan digunakan. Skema yang tersedia bergantung pada repositori yang ditentukan. Untuk mendapatkan daftar ID dan nama repositori, jalankan kueri SELECT terhadap tabel Repositories.

Jika Anda menyetel Katalog dan Skema ke INFORMATION dalam konfigurasi koneksi, Anda hanya akan memiliki akses ke skema Model Data Informasi. Katalog atau skema project lainnya tidak akan diekspos.
Jika Catalog disetel ke katalog project, Anda dapat menyetel Schema ke salah satu dari berikut ini: Analytics, Project, atau salah satu skema repositori. Setelah memilih skema yang sesuai, Anda dapat membuat kueri data dalam repositori tertentu.
Untuk mengkueri data dari repositori dengan ID 3ee729d6-804d-4ece-84af-d5befa94abe8, tetapkan Catalog ke Repository_3ee729d6-804d-4ece-84af-d5befa94abe8.

Untuk membuat aplikasi di Azure Portal/MS Entra dan menggunakan semua parameter aplikasi yang dibuat di tingkat Koneksi Azure AD, lihat Panduan memulai: Mendaftarkan aplikasi dengan platform identitas Microsoft dan Mendaftarkan aplikasi klien di Microsoft Entra ID.

Batasan sistem

Konektor Azure DevOps dapat memproses maksimum 6 transaksi per detik, per node, dan membatasi transaksi apa pun yang melebihi batas ini. Secara default, Integration Connectors mengalokasikan 2 node (untuk ketersediaan yang lebih baik) untuk koneksi.

Untuk mengetahui informasi tentang batas yang berlaku untuk Integration Connectors, lihat Batas.

Catatan: Jumlah node Integration Connectors akan diskalakan otomatis secara dinamis berdasarkan penggunaan Anda. Namun, jika ingin mencadangkan kapasitas untuk volume besar tanpa menunggu penskalaan otomatis, Anda dapat menyesuaikan nilai node minimum untuk koneksi. Jumlah node yang diperlukan meningkat saat jumlah transaksi yang diproses untuk koneksi bertambah. Sebaliknya, jumlah node yang diperlukan lebih sedikit jika koneksi memproses lebih sedikit transaksi. Untuk mengonfigurasi nilai node, lakukan hal berikut:

Jika Anda adalah pelanggan prabayar, konfigurasikan nilai node minimum dan maksimum di halaman edit koneksi.
Jika Anda adalah pelanggan berbasis langganan, hubungi dukungan.

Jumlah transaksi maksimum yang dapat ditangani oleh sebuah node bergantung pada berbagai faktor. Jadi, sebelum menyesuaikan node minimum untuk mendapatkan throughput yang lebih baik, sebaiknya periksa apakah sistem backend Anda telah disiapkan secara optimal untuk menangani traffic yang diperlukan.

Menggunakan koneksi Azure DevOps dalam integrasi

Setelah Anda membuat koneksi, koneksi tersebut akan tersedia di Apigee Integration dan Application Integration. Anda dapat menggunakan koneksi dalam integrasi melalui tugas Konektor.

Untuk memahami cara membuat dan menggunakan tugas Konektor di Apigee Integration, lihat Tugas konektor.
Untuk memahami cara membuat dan menggunakan tugas Konektor di Integrasi Aplikasi, lihat Tugas konektor.

Tindakan

Bagian ini mencantumkan tindakan yang didukung oleh konektor. Untuk memahami cara mengonfigurasi tindakan, lihat Contoh tindakan.

Tindakan CreateWorkItem

Tindakan ini akan membuat item kerja.

Parameter input tindakan CreateWorkItem

Nama parameter	Jenis data	Wajib	Deskripsi
ProjectId	String	Ya	ID project Azure DevOps.
Jenis	String	Ya	Jenis item kerja yang akan dibuat.
Dari	String	Tidak	Jalur asal untuk operasi salin atau pindahkan.
Op	String	Ya	Operasi patch yang mengubah item kerja, seperti add, copy, move, remove, replace, atau test.
Jalur	String	Ya	Jalur untuk operasi.
Nilai	String	Ya	Nilai untuk operasi.

Untuk contoh cara mengonfigurasi tindakan CreateWorkItem, lihat Contoh.

Tindakan UpdateWorkItem

Parameter input tindakan UpdateWorkItem

Tindakan ini memperbarui item kerja.

Nama parameter	Jenis data	Wajib	Deskripsi
ProjectId	String	Ya	ID project Azure DevOps.
WorkItemId	String	Ya	ID item kerja.
Dari	String	Tidak	Jalur asal untuk operasi salin atau pindahkan.
Op	String	Ya	Operasi patch yang mengubah item kerja, seperti add, copy, move, remove, replace, atau test.
Jalur	String	Ya	Jalur untuk operasi.
Nilai	String	Ya	Nilai untuk operasi.

Untuk contoh cara mengonfigurasi tindakan UpdateWorkItem, lihat Contoh.

Tindakan GetPullRequestCommits

Tindakan ini akan mendapatkan commit untuk pull request yang ditentukan.

Parameter input tindakan GetPullRequestCommits

Nama parameter	Jenis data	Wajib	Deskripsi
ProjectId	String	Ya	ID project Azure DevOps.
RepositoryId	String	Ya	ID atau nama repositori. Jika ProjectId tidak disetel, Anda harus menyetel RepositoryId.
PullRequestId	String	Ya	ID permintaan pull.

Parameter output tindakan GetPullRequestCommits

Untuk contoh cara mengonfigurasi tindakan GetPullRequestCommits, lihat Contoh.

Tindakan PushChanges

Tindakan ini akan mengirimkan perubahan ke repositori di instance Azure DevOps Anda.

Parameter input tindakan PushChanges

Nama parameter	Jenis data	Wajib	Deskripsi
ProjectId	String	Ya	ID project Azure DevOps.
RepositoryId	String	Ya	ID atau nama repositori. Jika ProjectId tidak disetel, Anda harus menyetel RepositoryId.
BranchRefName	String	Ya	Nama cabang git.
OldObjectId	String	Ya	ID objek saat ini dari cabang.
CommitComment	String	Ya	Menentukan komentar yang disertakan dalam commit.
ChangesAggregate	String	Ya	Objek gabungan yang berisi detail setiap perubahan dalam commit.

Untuk contoh cara mengonfigurasi tindakan PushChanges, lihat Contoh.

Tindakan DownloadReleaseLogs

Tindakan ini akan mendownload log untuk rilis tertentu.

Parameter input tindakan DownloadReleaseLogs

Nama parameter	Jenis data	Wajib	Deskripsi
ProjectId	String	Ya	ID project Azure DevOps.
ReleaseId	Bilangan bulat	Ya	ID rilis.
FileLocation	String	Tidak	Lokasi file.
Encoding	String	Tidak	Jenis encoding input FileData. Nilai yang diizinkan adalah NONE, dan BASE64. Nilai defaultnya adalah BASE64.
FileStream	String	Tidak	Instance output stream tempat data file ditulis. Hanya digunakan jika FileLocation tidak diberikan.

Untuk contoh cara mengonfigurasi tindakan DownloadReleaseLogs, lihat Contoh.

Tindakan DownloadTestAttachment

Tindakan ini akan mendownload lampiran hasil/jalankan pengujian.

Parameter input tindakan DownloadTestAttachment

Nama parameter	Jenis data	Wajib	Deskripsi
ProjectId	String	Ya	ID project Azure DevOps.
ResultId	Bilangan bulat	Tidak	ID hasil pengujian.
RunId	Bilangan bulat	Ya	ID uji coba.
AttachmentId	String	Tidak	ID lampiran.
FileLocation	String	Tidak	Lokasi file.
Encoding	String	Tidak	Jenis encoding input FileData. Nilai yang diizinkan adalah NONE, dan BASE64. Nilai defaultnya adalah BASE64.
FileStream	String	Tidak	Instance output stream tempat data file ditulis. Hanya digunakan jika FileLocation tidak diberikan.

Untuk contoh cara mengonfigurasi tindakan DownloadTestAttachment, lihat Contoh.

Tindakan SetProjectProperties

Tindakan ini dapat membuat, memperbarui, dan menghapus properti project tim.

Parameter input tindakan SetProjectProperties

Nama parameter	Jenis data	Wajib	Deskripsi
ProjectId	String	Ya	ID project Azure DevOps.
Dari	String	Tidak	Jalur asal untuk operasi pemindahan atau penyalinan.
Op	String	Ya	Operasi patch yang mengubah properti project, seperti menambahkan, menyalin, memindahkan, menghapus, mengganti, atau menguji.
Jalur	String	Ya	Jalur untuk operasi.
Nilai	String	Ya	Nilai untuk operasi.

Untuk contoh cara mengonfigurasi tindakan SetProjectProperties, lihat Contoh.

Tindakan DeleteTestCase

Tindakan ini akan menghapus kasus pengujian.

Parameter input tindakan DeleteTestCase

Nama parameter	Jenis data	Wajib	Deskripsi
ProjectId	String	Ya	ID project Azure DevOps.
TestcaseId	Bilangan bulat	Ya	ID kasus pengujian.

Untuk contoh cara mengonfigurasi tindakan DeleteTestCase, lihat Contoh.

Tindakan RunPipeline

Tindakan ini menjalankan pipeline dengan konfigurasi yang ditentukan.

Parameter input tindakan RunPipeline

Nama parameter	Jenis data	Wajib	Deskripsi
ProjectId	String	Ya	ID project Azure DevOps.
PipelineId	Bilangan bulat	Ya	ID pipeline.
PipelineVersion	Bilangan bulat	Tidak	Versi pipeline yang akan dijalankan.
Resource	String	Ya	Resource yang diperlukan untuk menjalankan.
Variabel	String	Tidak	Daftar variabel dan nilai untuk digunakan selama eksekusi pipeline.
StagesToSkip	String	Tidak	Array nama tahap yang akan dilewati.
TemplateParameters	String	Tidak	Peta nilai kunci parameter yang digunakan selama eksekusi pipeline.

Untuk contoh cara mengonfigurasi tindakan RunPipeline, lihat Contoh.

Tindakan CreatePullRequest

Tindakan ini membuat pull request dengan konfigurasi yang ditentukan.

Parameter input tindakan CreatePullRequest

Nama parameter	Jenis data	Wajib	Deskripsi
ProjectId	String	Ya	ID project Azure DevOps.
RepositoryId	String	Ya	ID repositori.
Judul	String	Ya	Judul permintaan pull.
Deskripsi	String	Tidak	Deskripsi permintaan pull.
SourceRefName	String	Ya	Nama cabang sumber permintaan pull.
TargetRefName	String	Ya	Nama cabang target pull request.
CompletionOptions	String	Tidak	Opsi yang memengaruhi cara permintaan pull akan digabungkan saat selesai.
IsDraft	Boolean	Tidak	Permintaan pull draf / WIP.
Label	String	Tidak	Label yang terkait dengan pull request.
MergeOptions	String	Tidak	Opsi yang digunakan saat penggabungan pull request berjalan.
Peninjau	String	Tidak	Daftar peninjau pada permintaan pull.
WorkItemRefs	String	Tidak	Semua referensi item kerja yang terkait dengan permintaan pull ini.

Untuk contoh cara mengonfigurasi tindakan CreatePullRequest, lihat Contoh.

Tindakan UpdatePullRequest

Tindakan ini mengupdate permintaan pull dengan konfigurasi yang ditentukan.

Parameter input tindakan UpdatePullRequest

Nama parameter	Jenis data	Wajib	Deskripsi
ProjectId	String	Ya	ID project Azure DevOps.
RepositoryId	String	Ya	ID repositori.
PullRequestId	String	Ya	ID permintaan pull.
Judul	String	Tidak	Judul permintaan pull.
Deskripsi	String	Tidak	Deskripsi permintaan pull.
Status	String	Tidak	Status permintaan pull.
TargetRefName	String	Tidak	Nama cabang target pull request. Hanya tersedia jika fitur penargetan ulang PR diaktifkan.
CompletionOptions	String	Tidak	Opsi yang memengaruhi cara permintaan pull akan digabungkan saat selesai.
MergeOptions	String	Tidak	Opsi yang digunakan saat penggabungan pull request berjalan.
AutoCompleteSetById	String	Tidak	ID pengguna yang mengaktifkan autocomplete.

Untuk contoh cara mengonfigurasi tindakan UpdatePullRequest, lihat Contoh.

Tindakan GetPullRequestCommits

Tindakan ini mendapatkan commit untuk permintaan pull yang ditentukan dengan konfigurasi yang ditentukan.

Parameter input tindakan GetPullRequestCommits

Nama parameter	Jenis data	Wajib	Deskripsi
ProjectId	String	Ya	ID project Azure DevOps.
RepositoryId	String	Ya	ID repositori.
PullRequestId	String	Ya	ID permintaan pull.

Untuk contoh cara mengonfigurasi tindakan GetPullRequestCommits, lihat Contoh.

Tindakan AddBuildTag

Tindakan ini menambahkan tag ke build.

Parameter input tindakan AddBuildTag

Nama parameter	Jenis data	Wajib	Deskripsi
ProjectId	String	Ya	ID project Azure DevOps.
BuildId	String	Ya	ID build.
Tag	String	Ya	Tag yang akan ditambahkan ke build.

Untuk contoh cara mengonfigurasi tindakan AddBuildTag, lihat Contoh.

Tindakan DeleteBuildTag

Tindakan ini menghapus tag dari build.

Parameter input tindakan DeleteBuildTag

Nama parameter	Jenis data	Wajib	Deskripsi
ProjectId	String	Ya	ID project Azure DevOps.
BuildId	String	Ya	ID build.
Tag	String	Ya	Tag yang akan dihapus dari build.

Untuk contoh cara mengonfigurasi tindakan DeleteBuildTag, lihat Contoh.

Tindakan DownloadBuildReports

Tindakan ini akan mendownload laporan build.

Parameter input tindakan DownloadBuildReports

Nama parameter	Jenis data	Wajib	Deskripsi
ProjectId	String	Ya	ID project Azure DevOps.
BuildId	Bilangan bulat	Ya	ID build.
FileLocation	String	Tidak	Lokasi file.
Encoding	String	Tidak	Jenis encoding input FileData. Nilai yang diizinkan adalah NONE, dan BASE64. Nilai defaultnya adalah BASE64.
FileStream	String	Tidak	Instance output stream tempat data file ditulis. Hanya digunakan jika FileLocation tidak diberikan.

Untuk contoh cara mengonfigurasi tindakan DownloadBuildReports, lihat Contoh.

Tindakan DownloadBuildLogs

Tindakan ini akan mendownload log build.

Parameter input tindakan DownloadBuildLogs

Nama parameter	Jenis data	Wajib	Deskripsi
ProjectId	String	Ya	ID project Azure DevOps.
BuildId	Bilangan bulat	Ya	ID build.
LogId	Bilangan bulat	Ya	ID log.
StartLine	Bilangan bulat	Tidak	Baris awal pembuatan.
EndLine	Bilangan bulat	Tidak	Baris akhir build.
FileLocation	String	Tidak	Lokasi file.
Encoding	String	Tidak	Jenis encoding input FileData. Nilai yang diizinkan adalah NONE, dan BASE64. Nilai defaultnya adalah BASE64.
FileStream	String	Tidak	Instance output stream tempat data file ditulis. Hanya digunakan jika FileLocation tidak diberikan.

Untuk contoh cara mengonfigurasi tindakan DownloadBuildLogs, lihat Contoh.

Tindakan UpdateUser

Tindakan ini memperbarui detail pengguna.

Parameter input tindakan UpdateUser

Nama parameter	Jenis data	Wajib	Deskripsi
ID Pengguna	String	Ya	ID pengguna.
Dari	String	Tidak	Jalur asal untuk operasi pemindahan atau penyalinan.
Op	String	Ya	Operasi patch yang mengubah pengguna, seperti menambahkan, menyalin, memindahkan, menghapus, mengganti, atau menguji.
Jalur	String	Tidak	Jalur untuk operasi.
Nilai	String	Tidak	Nilai untuk operasi.

Untuk contoh cara mengonfigurasi tindakan UpdateUser, lihat Contoh.

Tindakan CloneTestPlan

Tindakan ini akan meng-clone rencana pengujian.

Parameter input tindakan CloneTestPlan

Nama parameter	Jenis data	Wajib	Deskripsi
ProjectId	String	Tidak	ID project Azure DevOps.
DeepClone	Boolean	Tidak	Meng-clone semua kasus pengujian terkait juga.
CloneRequirements	Boolean	Tidak	Jika disetel ke benar, persyaratan akan dikloning. Nilai defaultnya adalah false.
CopyAllSuites	Boolean	Tidak	Menyalin semua rangkaian pengujian dari rencana sumber.
CopyAncestorHierarchy	Boolean	Tidak	Menyalin hierarki induk.
DestinationWorkItemType	String	Tidak	Nama jenis item kerja dari clone.
OverrideParameters	String	Tidak	Pasangan nilai kunci dengan nilai setiap kunci diganti oleh nilai yang ditentukan.
RelatedLinkComment	String	Tidak	Menambahkan komentar ke rencana pengujian yang dikloning.
DestinationPlanAreaPath	String	Tidak	Area rencana pengujian.
DestinationPlanBuildId	String	Tidak	Dibuat untuk diuji.
DestinationPlanDescription	String	Tidak	Deskripsi rencana pengujian.
DestinationPlanEndDate	String	Tidak	Tanggal akhir rencana pengujian.
DestinationPlanIteration	String	Tidak	Jalur iterasi paket pengujian.
DestinationPlanName	String	Ya	Nama rencana pengujian.
DestinationPlanOwnerId	String	Tidak	ID Pengguna pemilik rencana pengujian.
DestinationPlanProject	String	Tidak	Nama project tujuan.
DestinationPlanStartDate	String	Tidak	tanggal mulai untuk rencana pengujian.
DestinationPlanState	String	Tidak	Status rencana pengujian.
DestinationPlanSync	Boolean	Tidak	Menentukan cara pengujian duplikat di seluruh rangkaian dalam rencana pengujian harus berperilaku.
SourceTestPlanId	Bilangan bulat	Ya	ID rencana pengujian sumber.
SourceTestPlanSuiteId	Bilangan bulat	Tidak	Daftar ID Test Suite yang dipisahkan koma untuk di-clone di dalam rencana pengujian sumber.

Untuk contoh cara mengonfigurasi tindakan CloneTestPlan, lihat Contoh.

Tindakan CloneTestSuite

Tindakan ini akan meng-clone detail rangkaian pengujian.

Parameter input tindakan CloneTestSuite

Nama parameter	Jenis data	Wajib	Deskripsi
ProjectId	String	Tidak	ID project Azure DevOps.
DeepClone	Boolean	Tidak	Meng-clone semua kasus pengujian terkait.
CloneRequirements	Boolean	Tidak	Jika disetel ke benar, persyaratan akan dikloning. Nilai defaultnya adalah false.
CopyAllSuites	Boolean	Tidak	Menyalin semua rangkaian pengujian dari rencana sumber.
CopyAncestorHierarchy	Boolean	Tidak	Menyalin hierarki ancestor.
DestinationWorkItemType	String	Tidak	Nama jenis item kerja untuk clone.
OverrideParameters	String	Tidak	Pasangan nilai kunci dengan nilai setiap kunci diganti oleh nilai yang ditentukan.
RelatedLinkComment	String	Tidak	Menambahkan komentar ke rangkaian pengujian yang di-clone.
DestinationTestSuiteId	Bilangan bulat	Ya	ID rangkaian pengujian tujuan.
DestinationProjectName	String	Tidak	Nama project di tujuan.
SourceTestSuiteId	Bilangan bulat	Ya	ID rangkaian pengujian sumber.

Untuk contoh cara mengonfigurasi tindakan CloneTestSuite, lihat Contoh.

Tindakan CloneTestCase

Tindakan ini meng-clone detail kasus pengujian.

Parameter input tindakan CloneTestCase

Nama parameter	Jenis data	Wajib	Deskripsi
ProjectId	String	Tidak	ID project Azure DevOps.
IncludeAttachments	Boolean	Tidak	Mencakup lampiran kasus pengujian jika disetel ke benar (true), nilai default disetel ke salah (false).
IncludeLinks	Boolean	Tidak	Jika disetel ke benar (true), link akan disertakan. Nilai defaultnya adalah false.
RelatedLinkComment	String	Tidak	Untuk menambahkan komentar ke kasus pengujian yang dikloning.
DestinationTestPlanId	Bilangan bulat	Ya	ID paket pengujian tujuan.
DestinationTestSuiteId	Bilangan bulat	Ya	ID rangkaian pengujian tujuan.
SourceTestPlanId	Bilangan bulat	Ya	ID rencana pengujian sumber.
SourceTestSuiteId	Bilangan bulat	Ya	ID rangkaian pengujian sumber.
TestCaseId	Bilangan bulat	Ya	Daftar ID kasus pengujian yang dipisahkan koma untuk dikloning.

Untuk contoh cara mengonfigurasi tindakan CloneTestCase, lihat Contoh.

Tindakan DeletePullRequestAttachment

Tindakan ini akan menghapus detail lampiran permintaan penarikan.

Parameter input tindakan DeletePullRequestAttachment

Nama parameter	Jenis data	Wajib	Deskripsi
ProjectId	String	Tidak	ID project Azure DevOps.
RepositoryId	String	Ya	ID repositori.
PullRequestId	Bilangan bulat	Ya	ID permintaan pull.
FileName	String	Ya	Nama lampiran.

Untuk contoh cara mengonfigurasi tindakan DeletePullRequestAttachment, lihat Contoh.

Contoh tindakan

Contoh - Membuat item kerja

Dalam dialog Configure connector task, klik Actions.
Pilih tindakan CreateWorkItem, lalu klik Selesai.

Di bagian Task Input pada tugas Connectors, klik connectorInputPayload, lalu masukkan nilai yang mirip dengan berikut di kolom Default Value:

{ "Type": "Bug", "Value": "Googlecloud_Testing_Bug_M", "Op": "add", "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc", "Path": "/fields/System.Title" }

connectorOutputPayload

CreateWorkItem

[{
"Success": "True"
}]

Untuk membuat berbagai entitas seperti Tugas, Epik, Cerita Pengguna, Kasus Pengujian, Fitur, dan Masalah, Anda hanya perlu mengubah nilai kolom "Jenis" dalam payload input.
Untuk menyetel Jenis ke Epik, Anda dapat menyetel "Type": "Epic". Demikian pula, Anda dapat mengubah nilai menjadi "Type": "Task", "Type": "User Story", "Type": "Test Case", "Type": "Feature", atau "Type": "Issue" untuk membuat entitas masing-masing.

Contoh - Memperbarui item kerja

Dalam dialog Configure connector task, klik Actions.
Pilih tindakan UpdateWorkItem, lalu klik Selesai.

Di bagian Task Input pada tugas Connectors, klik connectorInputPayload, lalu masukkan nilai yang mirip dengan berikut di kolom Default Value:

{ "WorkItemId": "35", "Value": "Update Workitem", "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc", "Op": "replace", "Path": "/fields/System.Title" }

Jika tindakan berhasil, parameter respons connectorOutputPayload tugas UpdateWorkItem akan memiliki nilai yang mirip dengan berikut ini:

[{
"Success": "True"
}]

Contoh - Mendapatkan pull request commit

Dalam dialog Configure connector task, klik Actions.
Pilih tindakan GetPullRequestCommits, lalu klik Selesai.
Di bagian Task Input pada tugas Connectors, klik connectorInputPayload, lalu masukkan nilai yang mirip dengan berikut di kolom Default Value:
```
{ "PullRequestId": "2", "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc", "RepositoryId": "e848b49e-704f-4df3-94ce-4f23176715b6" }
```

Jika tindakan berhasil, parameter respons connectorOutputPayload tugas GetPullRequestCommits akan memiliki nilai yang mirip dengan berikut ini:

[ { "CommitId": "7299b6623d7d146751d8cf280af301f9a345ff05", "AuthorName": "jeffersonloveshi.k", "AuthorEmail": "jeffersonloveshiking@gmail.com", "AuthoredDate": "2024-08-12 11:25:23.0", "CommitterName": "lakshminarayana.k", "CommitterEmail": "jeffersonloveshiking@gmail.com", "CommittedDate": "2024-08-12 11:25:23.0", "Comment": "Added sample.txt", "CommentTruncated": null, "Url": "https://dev.azure.com/charliecruz/64058663-6419-4b11-8ef0-2ebf985949bc/_apis/git/repositories/e848b49e-704f-4df3-94ce-4f23176715b6/commits/7299b6623d7d146751d8cf280af301f9a345ff05" } ]

Contoh - Mendorong perubahan ke repositori

Dalam dialog Configure connector task, klik Actions.
Pilih tindakan PushChanges, lalu klik Selesai.

Di bagian Task Input pada tugas Connectors, klik connectorInputPayload, lalu masukkan nilai yang mirip dengan berikut di kolom Default Value:

{ "RepositoryId": "89f79340-8659-4927-9d9f-e8836c19af55", "BranchRefName": "refs/heads/US_Googlecloud_Push1", "OldObjectId": "4d66aafb75efda2bbdda7a2b609b152b1b715b7e", "CommitComment": "Googlecloud PUSH Changes", "ChangesAggregate": "{\n \"changeType\": \"edit\",\n \"item\": {\n \"path\": \"/tasks.md\"\n },\n \"newContent\": {\n \"content\": \"# Tasks\\n\\n* Item 1\\n* Item 2\",\n \"contentType\": \"rawtext\"\n }\n }" }

Jika tindakan berhasil, parameter respons connectorOutputPayload tugas PushChanges akan memiliki nilai yang mirip dengan berikut ini:

[ { "NewObjectId": "949e4710336bc5bdc779ca6b334e029c2f50a029", "CommitId": "949e4710336bc5bdc779ca6b334e029c2f50a029", "CommitTreeId": "7e7394dcfc5b4d4cf2c8c21d70a96fe34f8eaf3e", "AuthorName": "Charlie Cruz", "AuthorEmail": "baklavainthebalkans@gmail.onmicrosoft.com", "AuthoredDate": "2024-11-19 07:04:42.0", "CommitterName": "Charlie Cruz", "CommitterEmail": "baklavainthebalkans@gmail.onmicrosoft.com", "CommittedDate": "2024-11-19 07:04:42.0", "CommitUrl": "https://dev.azure.com/charliecruz/64058663-6419-4b11-8ef0-2ebf985949bc/_apis/git/repositories/89f79340-8659-4927-9d9f-e8836c19af55/commits/949e4710336bc5bdc779ca6b334e029c2f50a029", "RepositoryId": "89f79340-8659-4927-9d9f-e8836c19af55", "RepositoryName": "refs/heads/US_Googlecloud_Push1", "PushId": "193", "PushDate": "2024-11-19T07:04:42.5793751Z", "PushURL": "https://dev.azure.com/charliecruz/64058663-6419-4b11-8ef0-2ebf985949bc/_apis/git/repositories/89f79340-8659-4927-9d9f-e8836c19af55/pushes/193" } ]

Contoh - Download log rilis

Dalam dialog Configure connector task, klik Actions.
Pilih tindakan DownloadReleaseLogs, lalu klik Selesai.
Di bagian Task Input pada tugas Connectors, klik connectorInputPayload, lalu masukkan nilai yang mirip dengan berikut di kolom Default Value:
```
{ "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc", "ReleaseId": 2 }
```

Jika tindakan berhasil, parameter respons connectorOutputPayload tugas DownloadReleaseLogs akan memiliki nilai yang mirip dengan berikut ini:

[ { "Status": "Success", "FileData": "{Base64encodedvalue}]

Contoh - Mendownload lampiran hasil/operasi pengujian

Dalam dialog Configure connector task, klik Actions.
Pilih tindakan DownloadTestAttachment, lalu klik Selesai.
Di bagian Task Input pada tugas Connectors, klik connectorInputPayload, lalu masukkan nilai yang mirip dengan berikut di kolom Default Value:
```
{ "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc", "RunId": 50, "AttachmentId": "2" }
```

Jika tindakan berhasil, parameter respons connectorOutputPayload tugas DownloadTestAttachment akan memiliki nilai yang mirip dengan berikut ini:

[ { "Status": "Success", "FileData": "iVBORw0KGgoAAAANSUhEUgAAABgAAAAYCAIAAABvFaqvAAAAAXNSR0IArs4c6QAAAARnQU1BAACxjwv8YQUAAAAJcEhZcwAADsMAAA7DAcdvqGQAAABlSURBVDhP7cxBCsAgDERR739pG/CnGJI0FopQ8O2cjNP6R85QbeNQU7wT1dkijaQ3vkZoWElaoTeJojW01cYh0jwfgiFBV/lEjOZtacijN/nLkOBHhIaVDgn+Wdycp6FXzlCl9wt0Y0cAzHo/zgAAAABJRU5ErkJggg==" } ]

Contoh - Menetapkan properti project

Dalam dialog Configure connector task, klik Actions.
Pilih tindakan SetProjectProperties, lalu klik Selesai.
Di bagian Task Input pada tugas Connectors, klik connectorInputPayload, lalu masukkan nilai yang mirip dengan berikut di kolom Default Value:
```
{ "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc", "Op": "add", "Path": "/Alias", "Value": "Google CLoud Properties" }
```

Jika tindakan berhasil, parameter respons connectorOutputPayload tugas SetProjectProperties akan memiliki nilai yang mirip dengan berikut ini:

[ { "Status": "Success" } ]

Contoh - Menghapus kasus pengujian

Dalam dialog Configure connector task, klik Actions.
Pilih tindakan DeleteTestCase, lalu klik Selesai.
Di bagian Task Input pada tugas Connectors, klik connectorInputPayload, lalu masukkan nilai yang mirip dengan berikut di kolom Default Value:
```
{ "TestCaseId": 22255, "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc" }
```

Jika tindakan berhasil, parameter respons connectorOutputPayload tugas DeleteTestCase akan memiliki nilai yang mirip dengan berikut ini:

[ { "Status": "Success" } ]

Contoh - Menjalankan pipeline untuk project

Dalam dialog Configure connector task, klik Actions.
Pilih tindakan RunPipeline, lalu klik Selesai.

Di bagian Task Input pada tugas Connectors, klik connectorInputPayload, lalu masukkan nilai yang mirip dengan berikut di kolom Default Value:

{ "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc", "PipelineId": 7, "Resources": "{\n \"repositories\": {\n \"self\": {\n \"refName\": \"refs/heads/main\" // Specify the branch or tag\n }\n }\n }" }

connectorOutputPayload

RunPipeline

[ { "State": "inProgress", "RunId": "16", "RunName": "20241113.2", "RunHref": "https://dev.azure.com/charliecruz/64058663-6419-4b11-8ef0-2ebf985949bc/_apis/pipelines/7/runs/16", "CreatedDate": "2024-11-13 12:07:38.9237296" } ]

Contoh - Memperbarui permintaan pull

Dalam dialog Configure connector task, klik Actions.
Pilih tindakan UpdatePullRequest, lalu klik Selesai.

Di bagian Task Input pada tugas Connectors, klik connectorInputPayload, lalu masukkan nilai yang mirip dengan berikut di kolom Default Value:

{ "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc", "RepositoryId": "e848b49e-704f-4df3-94ce-4f23176715b6", "PullRequestId": "26", "Description": "updated pull req", "Title": "Googlecloud M pull request" }

Jika tindakan berhasil, parameter respons connectorOutputPayload tugas UpdatePullRequest akan memiliki nilai yang mirip dengan berikut ini:

[ { "Status": "Success", "PullRequestId": 26 } ]

Contoh - Membuat pull request

Dalam dialog Configure connector task, klik Actions.
Pilih tindakan CreatePullRequest, lalu klik Selesai.

Di bagian Task Input pada tugas Connectors, klik connectorInputPayload, lalu masukkan nilai yang mirip dengan berikut di kolom Default Value:

{ "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc", "RepositoryId": "e848b49e-704f-4df3-94ce-4f23176715b6", "Title": "Googlecloud M pull request", "SourceRefName": "refs/heads/Test_Branch", "TargetRefName": "refs/heads/main" }

Jika tindakan berhasil, parameter respons connectorOutputPayload tugas CreatePullRequest akan memiliki nilai yang mirip dengan berikut ini:

[ { "Status": "Success", "PullRequestId": 26 } ]

Contoh - Mendapatkan commit pull request

Dalam dialog Configure connector task, klik Actions.
Pilih tindakan GetPullRequestCommits, lalu klik Selesai.

Di bagian Task Input pada tugas Connectors, klik connectorInputPayload, lalu masukkan nilai yang mirip dengan berikut di kolom Default Value:

{ "PullRequestId": "23", "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc", "RepositoryId": "e848b49e-704f-4df3-94ce-4f23176715b6" }

Jika tindakan berhasil, parameter respons connectorOutputPayload tugas GetPullRequestCommits akan memiliki nilai yang mirip dengan berikut ini:

[ { "CommitId": "ebb720c5b93c52341cb86ccfb42258bb562a8406", "AuthorName": "dani.dana", "AuthorEmail": "baklavainthebalkans@gmail.com", "AuthoredDate": "2024-11-26 11:24:19.0", "CommitterName": "dani.dana", "CommitterEmail": "baklavainthebalkans@gmail.com", "CommittedDate": "2024-11-26 11:24:19.0", "Comment": "Updated sample.txt", "CommentTruncated": null, "Url": "https://dev.azure.com/charliecruz/64058663-6419-4b11-8ef0-2ebf985949bc/_apis/git/repositories/e848b49e-704f-4df3-94ce-4f23176715b6/commits/ebb720c5b93c52341cb86ccfb42258bb562a8406" }, { "CommitId": "353f74b48ada83111449b922f4660a338e058989", "AuthorName": "dani.dana", "AuthorEmail": "baklavainthebalkans@gmail.com", "AuthoredDate": "2024-11-26 11:23:01.0", "CommitterName": "dani.dana", "CommitterEmail": "baklavainthebalkans@gmail.com", "CommittedDate": "2024-11-26 11:23:01.0", "Comment": "Updated bcd", "CommentTruncated": null, "Url": "https://dev.azure.com/charliecruz/64058663-6419-4b11-8ef0-2ebf985949bc/_apis/git/repositories/e848b49e-704f-4df3-94ce-4f23176715b6/commits/353f74b48ada83111449b922f4660a338e058989" }, { "CommitId": "50a74dee46f8bcad4637d730994144f944c7d589", "AuthorName": "dani.dana", "AuthorEmail": "baklavainthebalkans@gmail.com", "AuthoredDate": "2024-11-26 11:21:59.0", "CommitterName": "dani.dana", "CommitterEmail": "baklavainthebalkans@gmail.com", "CommittedDate": "2024-11-26 11:21:59.0", "Comment": "Added bcd", "CommentTruncated": null, "Url": "https://dev.azure.com/charliecruz/64058663-6419-4b11-8ef0-2ebf985949bc/_apis/git/repositories/e848b49e-704f-4df3-94ce-4f23176715b6/commits/50a74dee46f8bcad4637d730994144f944c7d589" }, { "CommitId": "9813f562b0548144006f773314704db274c757c4", "AuthorName": "Alex amal", "AuthorEmail": "cloudysanfrancisco@gmail.com", "AuthoredDate": "2024-11-26 11:19:29.0", "CommitterName": "Alex amal", "CommitterEmail": "cloudysanfrancisco@gmail.com", "CommittedDate": "2024-11-26 11:19:29.0", "Comment": "hello", "CommentTruncated": null, "Url": "https://dev.azure.com/charliecruz/64058663-6419-4b11-8ef0-2ebf985949bc/_apis/git/repositories/e848b49e-704f-4df3-94ce-4f23176715b6/commits/9813f562b0548144006f773314704db274c757c4" } ]

Contoh - Menambahkan tag build

Dalam dialog Configure connector task, klik Actions.
Pilih tindakan AddBuildTag, lalu klik Selesai.
Di bagian Task Input pada tugas Connectors, klik connectorInputPayload, lalu masukkan nilai yang mirip dengan berikut di kolom Default Value:
```
{ "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc","BuildId": "14","Tag": "AddGooglecloud_Tag" }
```

Jika tindakan berhasil, parameter respons connectorOutputPayload tugas AddBuildTag akan memiliki nilai yang mirip dengan berikut ini:

[{ "Status": "Success" }]

Contoh - Menghapus tag build

Dalam dialog Configure connector task, klik Actions.
Pilih tindakan DeleteBuildTag, lalu klik Selesai.
Di bagian Task Input pada tugas Connectors, klik connectorInputPayload, lalu masukkan nilai yang mirip dengan berikut di kolom Default Value:
```
{ "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc","BuildId": "14","Tag": "AddGooglecloud_Tag"}
```

Jika tindakan berhasil, parameter respons connectorOutputPayload tugas DeleteBuildTag akan memiliki nilai yang mirip dengan berikut ini:

[{ "Status": "Success" }]

Contoh - Mendownload laporan build

Dalam dialog Configure connector task, klik Actions.
Pilih tindakan DownloadBuildReports, lalu klik Selesai.
Di bagian Task Input pada tugas Connectors, klik connectorInputPayload, lalu masukkan nilai yang mirip dengan berikut di kolom Default Value:
```
{ "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc", "BuildId": 16 }
```

Jika tindakan berhasil, parameter respons connectorOutputPayload tugas DownloadBuildReports akan memiliki nilai yang mirip dengan berikut ini:

[ { "Status": "Success", "FileData": "Base64-format data" } ]

Contoh - Mendownload log build

Dalam dialog Configure connector task, klik Actions.
Pilih tindakan DownloadBuildLogs, lalu klik Selesai.
Di bagian Task Input pada tugas Connectors, klik connectorInputPayload, lalu masukkan nilai yang mirip dengan berikut di kolom Default Value:
```
{ "BuildId": 16, "LogId": 1, "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc" }
```

Jika tindakan berhasil, parameter respons connectorOutputPayload tugas DownloadBuildLogs akan memiliki nilai yang mirip dengan berikut ini:

[ { "Status": "Success", "FileData": "Base64-format data" } ]

Contoh - Memperbarui pengguna

Dalam dialog Configure connector task, klik Actions.
Pilih tindakan UpdateUser, lalu klik Selesai.

Di bagian Task Input pada tugas Connectors, klik connectorInputPayload, lalu masukkan nilai yang mirip dengan berikut di kolom Default Value:

{ "UserId": "088a8c28-1b83-4538-9c74-b7ca97eb4ef2", "Op": "add", "Path": "/projectEntitlements/50fac9d4-37aa-4a13-a81a-887d12be7b9f", "Value": "{ \"projectRef\": {\n \"id\": \"50fac9d4-37aa-4a13-a81a-887d12be7b9f\",\n \"name\": \"Postman_Testing_Project\"\n }, \n \"group\": {\n \"groupType\": \"projectContributor\"\n }}" }

Jika tindakan berhasil, parameter respons connectorOutputPayload tugas Update User akan memiliki nilai yang mirip dengan berikut ini:

[ { "Status": "Success" } ]

Contoh - Meng-clone rencana pengujian

Dalam dialog Configure connector task, klik Actions.
Pilih tindakan CloneTestPlan, lalu klik Selesai.

Di bagian Task Input pada tugas Connectors, klik connectorInputPayload, lalu masukkan nilai yang mirip dengan berikut di kolom Default Value:

{ "CloneRequirements": true, "CopyAllSuites": true, "RelatedLinkComment": "Cloned from existing test plan googlecloud", "DestinationPlanName": "TestPlan 2", "DestinationPlanAreaPath": "GCPTesting_New_Project", "DestinationPlanIteration": "GCPTesting_New_Project", "DestinationPlanProject": "GCPTesting_New_Project", "SourceTestPlanId": 1, "CopyAncestorHierarchy": true }

Jika tindakan berhasil, parameter respons connectorOutputPayload tugas CloneTestPlan akan memiliki nilai yang mirip dengan berikut ini:

[ { "CloneOperationId": null, "CloneOperationState": "queued", "sourcetestplan_project_id": "ea4270d3-d335-4ef1-b1af-37a7591880cf", "sourcetestplan_project_name": "GCPTesting_New_Project", "sourcetestplan_project_state": "unchanged", "sourcetestplan_project_visibility": "unchanged", "sourcetestplan_project_lastupdatetime": "0001-01-01T00:00:00", "sourcetestplan_id": "1", "sourcetestplan_name": "Test Plan 1", "destinationtestplan_id": "15", "destinationtestplan_project_id": "ea4270d3-d335-4ef1-b1af-37a7591880cf", "destinationtestplan_project_name": "GCPTesting_New_Project", "destinationtestplan_project_state": "unchanged", "destinationtestplan_project_visibility": "unchanged", "destinationtestplan_project_lastupdatetime": "0001-01-01T00:00:00", "destinationtestplan_updateddate": "2025-01-07T14:02:31.247Z", "destinationtestplan_updatedby_displayname": "Charlie Cruz", "destinationtestplan_updatedby_url": "https://spsprodcin1.vssps.visualstudio.com/A0f5fd5e8-7721-4842-b504-2a8ddb8efeb0/_apis/Identities/df102a0c-59d2-6d69-aecd-556086d6d8d6", "destinationtestplan_updatedby__links_avatar_href": "https://dev.azure.com/sunitavenkata2024/_apis/GraphProfile/MemberAvatars/msa.ZGYxMDJhMGMtNTlkMi03ZDY5LWFlY2QtNTU2MDg2ZDZkOGQ2", "destinationtestplan_updatedby_id": "df102a0c-59d2-6d69-aecd-556086d6d8d6", "destinationtestplan_updatedby_uniquename": "sunitavenkata2024@outlook.com", "destinationtestplan_updatedby_imageurl": "https://dev.azure.com/sunitavenkata2024/_apis/GraphProfile/MemberAvatars/msa.ZGYxMDJhMGMtNTlkMi03ZDY5LWFlY2QtNTU2MDg2ZDZkOGQ2", "destinationtestplan_updatedby_descriptor": "msa.ZGYxMDJhMGMtNTlkMi03ZDY5LWFlY2QtNTU2MDg2ZDZkOGQ2", "destinationtestplan_rootsuite_id": "16", "destinationtestplan_rootsuite_name": "TestPlan 2", "destinationtestplan__links__self_href": "https://dev.azure.com/sunitavenkata2024/GCPTesting_New_Project/_apis/testplan/Plans/15", "destinationtestplan__links_clienturl_href": "mtms://dev.azure.com:443/sunitavenkata2024/p:GCPTesting_New_Project/Testing/testplan/connect?id=15", "destinationtestplan__links_rootsuite_href": "https://dev.azure.com/sunitavenkata2024/GCPTesting_New_Project/_apis/testplan/Plans/15/Suites/16", "destinationtestplan_revision": "1", "destinationtestplan_name": "TestPlan 2", "destinationtestplan_areapath": "GCPTesting_New_Project", "destinationtestplan_startdate": "2025-01-07T14:02:31.0878913Z", "destinationtestplan_enddate": "2025-01-14T14:02:31.0878913Z", "destinationtestplan_iteration": "GCPTesting_New_Project", "destinationtestplan_owner_displayname": "sunita m V", "destinationtestplan_owner_url": "https://spsprodcin1.vssps.visualstudio.com/A0f5fd5e8-7721-4842-b504-2a8ddb8efeb0/_apis/Identities/df102a0c-59d2-6d69-aecd-556086d6d8d6", "destinationtestplan_owner__links_avatar_href": "https://dev.azure.com/sunitavenkata2024/_apis/GraphProfile/MemberAvatars/msa.ZGYxMDJhMGMtNTlkMi03ZDY5LWFlY2QtNTU2MDg2ZDZkOGQ2", "destinationtestplan_owner_id": "df102a0c-59d2-6d69-aecd-556086d6d8d6", "destinationtestplan_owner_uniquename": "sunitavenkata2024@outlook.com", "destinationtestplan_owner_imageurl": "https://dev.azure.com/sunitavenkata2024/_apis/GraphProfile/MemberAvatars/msa.ZGYxMDJhMGMtNTlkMi03ZDY5LWFlY2QtNTU2MDg2ZDZkOGQ2", "destinationtestplan_owner_descriptor": "msa.ZGYxMDJhMGMtNTlkMi03ZDY5LWFlY2QtNTU2MDg2ZDZkOGQ2", "destinationtestplan_state": "Active", "destinationtestplan_testoutcomesettings_syncoutcomeacrosssuites": "false", "cloneoptions_relatedlinkcomment": "Cloned from existing test plan gcp", "cloneoptions_copyallsuites": "true", "cloneoptions_copyancestorhierarchy": "true", "cloneoptions_clonerequirements": "true", "cloneoperationresponse_state": "queued", "cloneoperationresponse_links__self_href": "https://dev.azure.com/sunitavenkata2024/GCPTesting_New_Project/_apis/testplan/Plans/CloneOperation/0" } ]

Contoh - Meng-clone rangkaian pengujian

Dalam dialog Configure connector task, klik Actions.
Pilih tindakan CloneTestSuite, lalu klik Selesai.
Di bagian Task Input pada tugas Connectors, klik connectorInputPayload, lalu masukkan nilai yang mirip dengan berikut di kolom Default Value:
```
{ "SourceTestSuiteId": 18, "CopyAllSuites": true, "CopyAncestorHierarchy": true, "DestinationTestSuiteId": 2 }
```

connectorOutputPayload

CloneTestSuite

[ { "CloneOperationId": 2, "CloneOperationState": "queued", "sourcetestsuite_project_id": "ea4270d3-d335-4ef1-b1af-37a7591880cf", "sourcetestsuite_project_name": "GCPTesting_New_Project", "sourcetestsuite_project_state": "unchanged", "sourcetestsuite_project_visibility": "unchanged", "sourcetestsuite_project_lastupdatetime": "0001-01-01T00:00:00", "sourcetestsuite_id": "18", "sourcetestsuite_name": "Test Plan 3", "destinationtestsuite_project_id": "ea4270d3-d335-4ef1-b1af-37a7591880cf", "destinationtestsuite_project_name": "GCPTesting_New_Project", "destinationtestsuite_project_state": "unchanged", "destinationtestsuite_project_visibility": "unchanged", "destinationtestsuite_project_lastupdatetime": "0001-01-01T00:00:00", "destinationtestsuite_id": "2", "destinationtestsuite_name": "Test Plan 1", "cloneoptions_copyallsuites": "true", "cloneoptions_copyancestorhierarchy": "true", "cloneoptions_clonerequirements": "false", "cloneoperationresponse_opid": "2", "cloneoperationresponse_state": "queued", "cloneoperationresponse_links__self_href": "https://dev.azure.com/sunitavenkata2024/GCPTesting_New_Project/_apis/testplan/Suites/CloneOperation/2" } ]

Contoh - Meng-clone kasus pengujian

Dalam dialog Configure connector task, klik Actions.
Pilih tindakan CloneTestCase, lalu klik Selesai.
Di bagian Task Input pada tugas Connectors, klik connectorInputPayload, lalu masukkan nilai yang mirip dengan berikut di kolom Default Value:
```
{ "SourceTestPlanId": 1, "DestinationTestPlanId": 20, "SourceTestSuiteId": 2, "DestinationTestSuiteId": 21, "TestCaseId": 3 }
```

Jika tindakan berhasil, parameter respons connectorOutputPayload tugas CloneTestCase akan memiliki nilai yang mirip dengan berikut ini:

[ { "CloneOperationId": 3, "CloneOperationState": "queued", "sourcetestsuite_project_id": "ea4270d3-d335-4ef1-b1af-37a7591880cf", "sourcetestsuite_project_name": "GCPTesting_New_Project", "sourcetestsuite_project_state": "unchanged", "sourcetestsuite_project_visibility": "unchanged", "sourcetestsuite_project_lastupdatetime": "0001-01-01T00:00:00", "sourcetestsuite_testcaseids": "3", "sourcetestsuite_id": "2", "sourcetestsuite_name": "Test Plan 1", "destinationtestsuite_project_id": "ea4270d3-d335-4ef1-b1af-37a7591880cf", "destinationtestsuite_project_name": "GCPTesting_New_Project", "destinationtestsuite_project_state": "unchanged", "destinationtestsuite_project_visibility": "unchanged", "destinationtestsuite_project_lastupdatetime": "0001-01-01T00:00:00", "destinationtestsuite_id": "21", "destinationtestsuite_name": "Test Plan 4", "cloneoptions_includelinks": "false", "cloneoptions_includeattachments": "false", "cloneoperationresponse_opid": "3", "cloneoperationresponse_state": "queued", "cloneoperationresponse_links__self_href": "https://dev.azure.com/sunitavenkata2024/GCPTesting_New_Project/_apis/testplan/Plans/CloneOperation/3" } ]

Contoh - Menghapus lampiran permintaan pull

Dalam dialog Configure connector task, klik Actions.
Pilih tindakan DeletePullRequestAttachment, lalu klik Selesai.

Di bagian Task Input pada tugas Connectors, klik connectorInputPayload, lalu masukkan nilai yang mirip dengan berikut di kolom Default Value:

{ "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc", "RepositoryId": "e848b49e-704f-4df3-94ce-4f23176715b6", "PullRequestId": 26, "FileName": "Company.jpg" }

DeletePullRequestAttachment

connectorOutputPayload

[ { "Status": "Success" } ]

Contoh operasi entity

Mengambil semua dasbor dalam project

Dalam dialog Configure connector task, klik Entities.
Pilih Dashboards dari daftar Entity.
Pilih operasi List, lalu klik Selesai.
Task Input pada tugas Connectors, Anda dapat menetapkan filterClause sesuai dengan persyaratan pelanggan. Lihat bagian Catatan di bawah

Nilai untuk filterClause harus selalu diteruskan dalam tanda kutip tunggal (') dalam format ini.
Anda dapat menggunakan filterClause untuk memfilter kumpulan data tertentu berdasarkan kolom apa pun.

Contoh - Mengambil satu dasbor menggunakan ID-nya

Dalam dialog Configure connector task, klik Entities.
Pilih Dashboards dari daftar Entity.
Pilih operasi Get, lalu klik Selesai.
Setel ID entity ke "2f671e29-e48f-4d26-8869-859e154b5f20" yang merupakan Kunci yang akan diteruskan. Untuk menyetel ID entitas, di bagian Pemeta Data pada Pemetaan Data, klik Buka Editor Pemetaan Data, lalu masukkan "2f671e29-e48f-4d26-8869-859e154b5f20" di kolom Nilai Input dan pilih EntityId sebagai Variabel lokal.
Nilai untuk ID Entitas harus diteruskan secara langsung, seperti "2f671e29-e48f-4d26-8869-859e154b5f20". Di sini, "2f671e29-e48f-4d26-8869-859e154b5f20" adalah nilai kunci utama unik yang diteruskan.

Dalam beberapa kasus, meneruskan satu ID Entity dapat menyebabkan error karena entity memiliki dua kunci gabungan. Dalam kasus seperti itu, Anda dapat menggunakan filterClause dan meneruskan nilai, seperti id='2f671e29-e48f-4d26-8869-859e154b5f20'.

Contoh - Menghapus dasbor menggunakan ID-nya

Dalam dialog Configure connector task, klik Entities.
Pilih Dashboards dari daftar Entity.
Pilih operasi Delete, lalu klik Selesai.
Tetapkan ID entity ke "2f671e29-e48f-4d26-8869-859e154b5f20" yang merupakan Kunci yang akan diteruskan. Untuk menyetel ID entitas, di bagian Pemeta Data pada Pemetaan Data, klik Buka Editor Pemetaan Data, lalu masukkan "2f671e29-e48f-4d26-8869-859e154b5f20" di kolom Nilai Input dan pilih EntityId sebagai Variabel lokal.
Jika entity memiliki dua kunci bisnis atau kunci utama gabungan, Anda dapat menetapkan filterClause ke id='2f671e29-e48f-4d26-8869-859e154b5f20', bukan menentukan entityId.

Contoh - Membuat dasbor baru dalam project

Dalam dialog Configure connector task, klik Entities.
Pilih Dashboard dari daftar Entity.
Pilih operasi Create, lalu klik Selesai.
Di bagian Pemeta Data pada tugas Pemetaan Data, klik Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input Value dan pilih EntityId/ConnectorInputPayload sebagai Variabel lokal.
```
{ "Name": "TestingGooglecloud09", "TeamId": "9f2e4d3c-ed57-474f-bab1-3de5727e60a1" }
```
Jika integrasi berhasil, parameter respons connectorOutputPayload tugas konektor akan memiliki nilai yang mirip dengan berikut:
```
{ "Id": "a2402c49-6c17-43a9-bfc4-3701d07bcfee" }
```

Contoh - Membuat hak pengguna baru dalam project

Dalam dialog Configure connector task, klik Entities.
Pilih Users dari daftar Entity.
Pilih operasi Create, lalu klik Selesai.
Di bagian Pemeta Data pada tugas Pemetaan Data, klik Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input Value dan pilih EntityId/ConnectorInputPayload sebagai Variabel lokal.
```
{ "UserPrincipalName": "jeffersonloveshiking@gmail.com", "UserSubjectKind": "user", "AccessLevelAccountLicenseType": "Stakeholder", "UserOriginId": "e3d3e130-51dc-48c5-a510-cce7a9df63af" }
```
Jika integrasi berhasil, parameter respons connectorOutputPayload tugas konektor akan memiliki nilai yang mirip dengan berikut:
```
{ "Id": "5e373a81-073d-4d64-a2c5-23d0b6cc287f" }
```

Contoh - Membuat kueri baru dalam project

Dalam dialog Configure connector task, klik Entities.
Pilih Queries dari daftar Entity.
Pilih operasi Create, lalu klik Selesai.

Di bagian Pemeta Data pada tugas Pemetaan Data, klik Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input Value dan pilih EntityId/ConnectorInputPayload sebagai Variabel lokal.

{ "Name": "New Queries Googlecloud", "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc", "IsFolder": true, "Wiql": "SELECT [System.Id], [System.Title], [System.State] FROM WorkItems WHERE [System.WorkItemType] = 'Bug' AND [System.State] = 'New' ORDER BY [System.ChangedDate] DESC", "ParentQueryId": "df947cf9-dbbe-43bc-93a4-3e4d7287adb8" }

Jika integrasi berhasil, parameter respons connectorOutputPayload tugas konektor akan memiliki nilai yang mirip dengan berikut:

{ "Id": "cf4a25e8-d2d2-48b7-a483-dd901c78293b" }

Contoh - Membuat pipeline baru dalam project

Dalam dialog Configure connector task, klik Entities.
Pilih Pipelines dari daftar Entity.
Pilih operasi Create, lalu klik Selesai.
Di bagian Pemeta Data pada tugas Pemetaan Data, klik Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input Value dan pilih EntityId/ConnectorInputPayload sebagai Variabel lokal.
```
{ "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc", "Name": "Googlecloud pipeline", "Folder": "\\\\", "ConfigurationPath": "build-deploy.yml", "ConfigurationRepositoryId": "957b9cd1-f7f1-45d4-8665-ed7120021da9", "ConfigurationRepositoryType": "azureReposGit", "ConfigurationType": "yaml" }
```
Jika integrasi berhasil, parameter respons connectorOutputPayload tugas konektor akan memiliki nilai yang mirip dengan berikut:
```
{ "Id": 9 }
```

Contoh - Membuat grup deployment dalam project

Dalam dialog Configure connector task, klik Entities.
Pilih DeploymentGroups dari daftar Entity.
Pilih operasi Create, lalu klik Selesai.
Di bagian Pemeta Data pada tugas Pemetaan Data, klik Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input Value dan pilih EntityId/ConnectorInputPayload sebagai Variabel lokal.
```
{ "Name": "Deployment group 2 Googlecloud" }
```
Jika integrasi berhasil, parameter respons connectorOutputPayload tugas konektor akan memiliki nilai yang mirip dengan berikut:
```
{ "Id": 139 }
```

Contoh - Membuat konfigurasi pengujian baru dalam project

Dalam dialog Configure connector task, klik Entities.
Pilih TestPlan dari daftar Entity.
Pilih operasi Create, lalu klik Selesai.
Di bagian Pemeta Data pada tugas Pemetaan Data, klik Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input Value dan pilih EntityId/ConnectorInputPayload sebagai Variabel lokal.
```
{ "Name": "Googlecloud_TestPlan" }
```
Jika integrasi berhasil, parameter respons connectorOutputPayload tugas konektor akan memiliki nilai yang mirip dengan berikut:
```
{ "Id": 106 }
```

Contoh - Membuat paket pengujian dalam project

Dalam dialog Configure connector task, klik Entities.
Pilih TestSuite dari daftar Entity.
Pilih operasi Create, lalu klik Selesai.
Di bagian Pemeta Data pada tugas Pemetaan Data, klik Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input Value dan pilih EntityId/ConnectorInputPayload sebagai Variabel lokal.
```
{ "Name": "Googlecloud_Suite", "PlanId": 106, "SuiteType": "staticTestSuite", "ParentSuiteId": 108, "InheritDefaultConfigurations": false }
```
Jika integrasi berhasil, parameter respons connectorOutputPayload tugas konektor akan memiliki nilai yang mirip dengan berikut:
```
{ "Id": 22264 }
```

Contoh - Membuat sesi pengujian dalam project

Dalam dialog Configure connector task, klik Entities.
Pilih TestRun dari daftar Entity.
Pilih operasi Create, lalu klik Selesai.
Di bagian Pemeta Data pada tugas Pemetaan Data, klik Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input Value dan pilih EntityId/ConnectorInputPayload sebagai Variabel lokal.
```
{ "Name": "TestRun_Googlecloud1"}
```
Jika integrasi berhasil, parameter respons connectorOutputPayload tugas konektor akan memiliki nilai yang mirip dengan berikut:
```
{ "Id": 46 }
```

Contoh - Membuat project baru

Dalam dialog Configure connector task, klik Entities.
Pilih Projects dari daftar Entity.
Pilih operasi Create, lalu klik Selesai.
Di bagian Pemeta Data pada tugas Pemetaan Data, klik Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input Value dan pilih EntityId/ConnectorInputPayload sebagai Variabel lokal.
```
{ "Name": "project from Googlecloud test 4", "Description": "This is new project", "CapabilitiesVersionControlType": "Git\n", "CapabilitiesProcessTemplateTypeId": "6b724908-ef14-45cf-84f8-768b5384da45" }
```
Jika integrasi berhasil, parameter respons connectorOutputPayload tugas Projects akan memiliki nilai yang mirip dengan berikut:
```
{ "Id": "c1a8e7f4-9afa-47a8-9862-b56229e134a9" }
```

ID yang dihasilkan setelah melakukan operasi Buat pada project bukanlah ID project yang sebenarnya.
Untuk mengambil detail project yang tepat, Anda perlu melakukan operasi List dengan nama project sebagai kondisi filter, seperti Name= 'Google Project Integration'.

Contoh - Membuat tim dalam project

Dalam dialog Configure connector task, klik Entities.
Pilih Teams dari daftar Entity.
Pilih operasi Create, lalu klik Selesai.
Di bagian Pemeta Data pada tugas Pemetaan Data, klik Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input Value dan pilih EntityId/ConnectorInputPayload sebagai Variabel lokal.
```
{ "Name": "M new team"}
```
Jika integrasi berhasil, parameter respons connectorOutputPayload tugas konektor akan memiliki nilai yang mirip dengan berikut:
```
{ "Id": "5285fb98-a1bc-42e1-9668-3c2780061367" }
```

Contoh - Membuat lingkungan dalam project

Dalam dialog Configure connector task, klik Entities.
Pilih Environments dari daftar Entity.
Pilih operasi Create, lalu klik Selesai.
Di bagian Pemeta Data pada tugas Pemetaan Data, klik Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input Value dan pilih EntityId/ConnectorInputPayload sebagai Variabel lokal.
```
{ "Name": "Google CLoud Env M", "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc", "Description": "Google Cloud created environment" }
```
Jika integrasi berhasil, parameter respons connectorOutputPayload tugas konektor akan memiliki nilai yang mirip dengan berikut:
```
{ "Id": "9" }
```

Dalam dialog Configure connector task, klik Entities.
Pilih Widgets dari daftar Entity.
Pilih operasi Create, lalu klik Selesai.
Di bagian Pemeta Data pada tugas Pemetaan Data, klik Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input Value dan pilih EntityId/ConnectorInputPayload sebagai Variabel lokal.
```
{ "Name": "Widget 2", "DashboardId": "6cb82f8d-393c-422e-b4e3-563d5e34fc31", "TeamId": "9f2e4d3c-ed57-474f-bab1-3de5727e60a1", "RowPosition": 4, "ColumnPosition": 4, "RowSpanSize": 1, "ColumnSpanSize": 2, "ContributionId": "ms.vss-dashboards-web.Microsoft.VisualStudioOnline.Dashboards.OtherLinksWidget" }
```
Contoh ini menunjukkan cara menambahkan Widget Jika integrasi berhasil, parameter respons connectorOutputPayload tugas konektor akan memiliki nilai yang mirip dengan berikut ini:
```
{ "Id": "7d049ae2-d995-4b3e-9ebd-662d94a53cc8" }
```

Contoh - Menambahkan peninjau ke permintaan pull di repositori

Dalam dialog Configure connector task, klik Entities.
Pilih PullRequestReviewers dari daftar Entity.
Pilih operasi Create, lalu klik Selesai.
Di bagian Pemeta Data pada tugas Pemetaan Data, klik Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input Value dan pilih EntityId/ConnectorInputPayload sebagai Variabel lokal.
```
{ "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc", "RepositoryId": "e848b49e-704f-4df3-94ce-4f23176715b6", "PullRequestId": 22, "Id": "38b14cd8-d8f2-4d79-9204-19adbcb62c81", "Vote": 0 }
```
Jika integrasi berhasil, parameter respons connectorOutputPayload tugas konektor akan memiliki nilai yang mirip dengan berikut:
```
{ "Id": "38b14cd8-d8f2-4d79-9204-19adbcb62c81", "PullRequestId": null }
```

Contoh - Membuat grup variabel dalam project

Dalam dialog Configure connector task, klik Entities.
Pilih VariableGroups dari daftar Entity.
Pilih operasi Create, lalu klik Selesai.

{
  "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc",
  "Type": "Vsts",
  "Variables": "{\n    \"SampleVariableName1\": {\n      \"value\": \"SampleValue1\"\n    },\n    \"SampleVariableName2\": {\n      \"value\": \"SampleValue2\"\n    }\n  }",
  "VariableGroupProjectRefs": "[\n    {\n      \"description\": \"SampleDescription\",\n      \"name\": \"Variable Group new test\",\n      \"projectReference\": {\n        \"id\": \"64058663-6419-4b11-8ef0-2ebf985949bc\",\n        \"name\": \"Googlecloud-Demo-Project\"\n      }\n    }\n  ]",
  "Name": "Variable Group new test"
}

Jika integrasi berhasil, parameter respons connectorOutputPayload tugas konektor akan memiliki nilai yang mirip dengan berikut:

{"Id": "12"}

Contoh - Membuat definisi build baru di repositori

Dalam dialog Configure connector task, klik Entities.
Pilih BuildDefinition dari daftar Entity.
Pilih operasi Create, lalu klik Selesai.
Di bagian Pemeta Data pada tugas Pemetaan Data, klik Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input Value dan pilih EntityId/ConnectorInputPayload sebagai Variabel lokal.
```
{"Name": "New Build definition from googlecloud test 11","RepositoryType": "TfsGit","ProcessYamlFilename": "data.txt","RepositoryId": "e848b49e-704f-4df3-94ce-4f23176715b6","Tags": "1"}
```
Jika integrasi berhasil, parameter respons connectorOutputPayload tugas konektor akan memiliki nilai yang mirip dengan berikut:
```
{"Id": "25"}
```

Contoh - Membuat rilis dalam project

Dalam dialog Configure connector task, klik Entities.
Pilih Releases dari daftar Entity.
Pilih operasi Create, lalu klik Selesai.
Di bagian Pemeta Data pada tugas Pemetaan Data, klik Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input Value dan pilih EntityId/ConnectorInputPayload sebagai Variabel lokal.
```
{ "ProjectId": "64058663-6419-4b11-8ef0-2ebf985949bc", "Reason": "manual", "Description": "This is a googlecloud release", "ReleaseDefinitionId": 1 }
```
Jika integrasi berhasil, parameter respons connectorOutputPayload tugas konektor akan memiliki nilai yang mirip dengan berikut:
```
{ "Id": "13" }
```

Contoh - Memperbarui nama atau deskripsi tim dalam project

Dalam dialog Configure connector task, klik Entities.
Pilih Teams dari daftar Entity.
Pilih operasi Update, lalu klik Selesai.
Di bagian Data Mapper pada tugas Data Mapping, klik Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input Value dan pilih EntityId/ConnectorInputPayload/FilterClause sebagai Variabel lokal.
```
{ "Name": "M new team update" }
```
Tetapkan ID entitas di Pemeta Data ke entitas Teams. Untuk menetapkan ID entitas, klik Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input Value, dan pilih EntityId/ConnectorInputPayload/FilterClause sebagai Variabel lokal.
Selain menentukan entityId, Anda juga dapat menetapkan filterClause ke 5285fb98-a1bc-42e1-9668-3c2780061367.

Dengan menjalankan contoh ini, respons yang mirip dengan berikut akan ditampilkan dalam variabel output connectorOutputPayload tugas konektor:
```
{ "Id": "5285fb98-a1bc-42e1-9668-3c2780061367" }
```

Contoh - Memperbarui kueri dalam project

Dalam dialog Configure connector task, klik Entities.
Pilih Queries dari daftar Entity.
Pilih operasi Update, lalu klik Selesai.
Di bagian Data Mapper pada tugas Data Mapping, klik Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input Value dan pilih EntityId/ConnectorInputPayload/FilterClause sebagai Variabel lokal.
```
{ "Name": "Update Queries" }
```
Tetapkan ID entitas di Pemeta Data ke entitas Kueri. Untuk menetapkan ID entitas, klik Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input Value, dan pilih EntityId/ConnectorInputPayload/FilterClause sebagai Variabel lokal.
Selain menentukan entityId, Anda juga dapat menetapkan filterClause ke 81797017-624d-4967-bc85-842a817bff48.

Dengan menjalankan contoh ini, respons yang mirip dengan berikut akan ditampilkan dalam variabel output connectorOutputPayload tugas konektor:
```
{ "Id": "81797017-624d-4967-bc85-842a817bff48" }
```

Contoh - Mengupdate dasbor dalam project

Dalam dialog Configure connector task, klik Entities.
Pilih Dashboard dari daftar Entity.
Pilih operasi Update, lalu klik Selesai.
Di bagian Data Mapper pada tugas Data Mapping, klik Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input Value dan pilih EntityId/ConnectorInputPayload/FilterClause sebagai Variabel lokal.
```
{ "Name": " update from googlecloud" }
```
Tetapkan ID entitas di Pemeta Data ke entitas Dasbor. Untuk menetapkan ID entitas, klik Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input Value dan pilih EntityId/ConnectorInputPayload/FilterClause sebagai Variabel lokal.
Selain menentukan entityId, Anda juga dapat menetapkan filterClause ke 139.

Dengan menjalankan contoh ini, respons yang mirip dengan berikut akan ditampilkan dalam variabel output connectorOutputPayload tugas konektor:
```
{ "Id": "139" }
```

Contoh - Memperbarui paket pengujian dalam project

Dalam dialog Configure connector task, klik Entities.
Pilih TestSuite dari daftar Entity.
Pilih operasi Update, lalu klik Selesai.
Di bagian Data Mapper pada tugas Data Mapping, klik Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input Value dan pilih EntityId/ConnectorInputPayload/FilterClause sebagai Variabel lokal.
```
{ "Name": "UPdated_Suite", "ParentSuiteId": 108 }
```
Tetapkan ID entitas di Pemeta Data ke entitas TestSuite. Untuk menetapkan ID entitas, klik Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input Value dan pilih EntityId/ConnectorInputPayload/FilterClause sebagai Variabel lokal.
Selain menentukan entityId, Anda juga dapat menetapkan filterClause ke 22264.

Dengan menjalankan contoh ini, respons yang mirip dengan berikut akan ditampilkan dalam variabel output connectorOutputPayload tugas konektor:
```
{ "Id": "22264" }
```

Contoh - Memperbarui grup deployment dalam project

Dalam dialog Configure connector task, klik Entities.
Pilih DeploymentGroups dari daftar Entity.
Pilih operasi Update, lalu klik Selesai.
Di bagian Data Mapper pada tugas Data Mapping, klik Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input Value dan pilih EntityId/ConnectorInputPayload/FilterClause sebagai Variabel lokal.
```
{ "Name": "Deployment" }
```
Tetapkan ID entitas di Pemeta Data ke entitas DeploymentGroups. Untuk menetapkan ID entitas, klik Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input Value, dan pilih EntityId/ConnectorInputPayload/FilterClause sebagai Variabel lokal.
Selain menentukan entityId, Anda juga dapat menetapkan filterClause ke 138.

Dengan menjalankan contoh ini, respons yang mirip dengan berikut akan ditampilkan dalam variabel output connectorOutputPayload tugas konektor:
```
{ "Id": "138" }
```

Contoh - Memperbarui rencana pengujian dalam project

Dalam dialog Configure connector task, klik Entities.
Pilih TestPlan dari daftar Entity.
Pilih operasi Update, lalu klik Selesai.
Di bagian Data Mapper pada tugas Data Mapping, klik Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input Value dan pilih EntityId/ConnectorInputPayload/FilterClause sebagai Variabel lokal.
```
{ "Name": "TestPlan_Update" }
```
Tetapkan ID entitas di Pemeta Data ke entitas TestPlan. Untuk menetapkan ID entitas, klik Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input Value, dan pilih EntityId/ConnectorInputPayload/FilterClause sebagai Variabel lokal.
Selain menentukan entityId, Anda juga dapat menetapkan filterClause ke 104.

Dengan menjalankan contoh ini, respons yang mirip dengan berikut akan ditampilkan dalam variabel output connectorOutputPayload tugas konektor:
```
{ "Id": "104" }
```

Contoh - Memperbarui proses pengujian dalam project

Dalam dialog Configure connector task, klik Entities.
Pilih TestRuns dari daftar Entity.
Pilih operasi Update, lalu klik Selesai.
Di bagian Data Mapper pada tugas Data Mapping, klik Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input Value dan pilih EntityId/ConnectorInputPayload/FilterClause sebagai Variabel lokal.
```
{ "Name": "Update Test Run", "Comment": "Google cloud has updated the test run use case." }
```
Tetapkan ID entitas di Pemeta Data ke entitas TestRuns. Untuk menetapkan ID entitas, klik Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input Value, dan pilih EntityId/ConnectorInputPayload/FilterClause sebagai Variabel lokal.
Selain menentukan entityId, Anda juga dapat menetapkan filterClause ke 46.

Dengan menjalankan contoh ini, respons yang mirip dengan berikut akan ditampilkan dalam variabel output connectorOutputPayload tugas konektor:
```
{ "Id": "46" }
```

Contoh - Memperbarui project

Dalam dialog Configure connector task, klik Entities.
Pilih Projects dari daftar Entity.
Pilih operasi Update, lalu klik Selesai.
Di bagian Data Mapper pada tugas Data Mapping, klik Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input Value dan pilih EntityId/ConnectorInputPayload/FilterClause sebagai Variabel lokal.
```
{ "Name": "Projects Update" }
```
Tetapkan ID entitas di Pemeta Data ke entitas Project. Untuk menetapkan ID entitas, klik Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input Value, dan pilih EntityId/ConnectorInputPayload/FilterClause sebagai Variabel lokal.
Selain menentukan entityId, Anda juga dapat menetapkan filterClause ke { "Id": "1677d4b0-eaf6-47c2-88ee-78819b00977d" }.

Dengan menjalankan contoh ini, respons yang mirip dengan berikut akan ditampilkan dalam variabel output connectorOutputPayload tugas konektor:
```
{ "Id": "1677d4b0-eaf6-47c2-88ee-78819b00977d" }
```

Contoh - Memperbarui lingkungan dalam project

Dalam dialog Configure connector task, klik Entities.
Pilih Environments dari daftar Entity.
Pilih operasi Update, lalu klik Selesai.
Di bagian Data Mapper pada tugas Data Mapping, klik Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input Value dan pilih EntityId/ConnectorInputPayload/FilterClause sebagai Variabel lokal.
```
{ "Name": "Environment Update M", "Description": "Update environment " }
```
Tetapkan ID entitas di Pemeta Data ke entitas Lingkungan. Untuk menetapkan ID entitas, klik Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input Value, dan pilih EntityId/ConnectorInputPayload/FilterClause sebagai Variabel lokal.
Selain menentukan entityId, Anda juga dapat menetapkan filterClause ke { "Id": "9" }.

Dengan menjalankan contoh ini, respons yang mirip dengan berikut akan ditampilkan dalam variabel output connectorOutputPayload tugas konektor:
```
{ "Id": 9 }
```

Contoh - Memperbarui grup variabel dalam project

Dalam dialog Configure connector task, klik Entities.
Pilih VariableGroups dari daftar Entity.
Pilih operasi Update, lalu klik Selesai.

Di bagian Data Mapper pada tugas Data Mapping, klik Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input Value dan pilih EntityId/ConnectorInputPayload/FilterClause sebagai Variabel lokal.

{
  "VariableGroupProjectRefs": "[\n    {\n      \"description\": \"SampleDescription\",\n      \"name\": \"New VariableGroup googlecloud updated\",\n      \"projectReference\": {\n        \"id\": \"64058663-6419-4b11-8ef0-2ebf985949bc\",\n        \"name\": \"GoogleCloud-Demo-Project\"\n      }\n    }\n  ]",
  "Variables": "{\n    \"SampleVariableName1\": {\n      \"value\": \"SampleValue1\"\n    },\n    \"SampleVariableName2\": {\n      \"value\": \"SampleValue2\"\n    }\n  }",
  "Name": "Variable Group new test updated"
}

Tetapkan ID entitas di Pemeta Data ke entitas VariableGroups Untuk menetapkan ID entitas, klik Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input Value dan pilih EntityId/ConnectorInputPayload/FilterClause sebagai Variabel lokal.
Selain menentukan entityId, Anda juga dapat menetapkan filterClause ke { "Id": "12" }.

Dengan menjalankan contoh ini, respons yang mirip dengan berikut akan ditampilkan dalam variabel output connectorOutputPayload tugas konektor:
```
{ "Id": 12 }
```

Contoh - Memperbarui definisi build dalam project

Dalam dialog Configure connector task, klik Entities.
Pilih BuildDefinition dari daftar Entity.
Pilih operasi Update, lalu klik Selesai.
Di bagian Data Mapper pada tugas Data Mapping, klik Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input Value dan pilih EntityId/ConnectorInputPayload/FilterClause sebagai Variabel lokal.
```
{ "Name": "Build definition update 25","RepositoryId": "e848b49e-704f-4df3-94ce-4f23176715b6","RepositoryType": "TfsGit","ProcessYamlFilename": "data.txt","Revision": 1 }
```
Tetapkan ID entity di Pemetaan Data ke entity BuildDefinition. Untuk menyetel ID entitas, klik Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input Value, dan pilih EntityId/ConnectorInputPayload/FilterClause sebagai Variabel lokal.
Selain menentukan entityId, Anda juga dapat menetapkan filterClause ke { ProjectId='64058663-6419-4b11-8ef0-2ebf985949bc' and Id='25'}.

Dengan menjalankan contoh ini, respons yang mirip dengan berikut akan ditampilkan dalam variabel output connectorOutputPayload tugas konektor:
```
{ "Id": 25 }
```

Contoh - Memperbarui peninjau pull request dalam project

Dalam dialog Configure connector task, klik Entities.
Pilih PullRequestReviewers dari daftar Entity.
Pilih operasi Update, lalu klik Selesai.
Di bagian Data Mapper pada tugas Data Mapping, klik Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input Value dan pilih EntityId/ConnectorInputPayload/FilterClause sebagai Variabel lokal.
```
{"isFlagged": true}
```
Tetapkan ID entitas di Pemeta Data ke entitas PullRequestReviewers. Untuk menyetel ID entitas, klik Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input Value, dan pilih EntityId/ConnectorInputPayload/FilterClause sebagai Variabel lokal.
Selain menentukan entityId, Anda juga dapat menetapkan filterClause ke { ProjectId='64058663-6419-4b11-8ef0-2ebf985949bc' and RepositoryId='e848b49e-704f-4df3-94ce-4f23176715b6' and PullRequestId='22' and Id='38b14cd8-d8f2-4d79-9204-19adbcb62c81'}.

Dengan menjalankan contoh ini, respons yang mirip dengan berikut akan ditampilkan dalam variabel output connectorOutputPayload tugas konektor:
```
{ "Id": "38b14cd8-d8f2-4d79-9204-19adbcb62c81","PullRequestId": null}
```

Contoh - Memperbarui rilis dalam project

Dalam dialog Configure connector task, klik Entities.
Pilih Releases dari daftar Entity.
Pilih operasi Update, lalu klik Selesai.
Di bagian Data Mapper pada tugas Data Mapping, klik Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input Value dan pilih EntityId/ConnectorInputPayload/FilterClause sebagai Variabel lokal.
```
{ "Description": "Update Release Description googlecloud","Name": "Update release googlecloud"}
```
Tetapkan ID entity di Pemeta Data ke entity Rilis. Untuk menyetel ID entitas, klik Open Data Mapping Editor, lalu masukkan nilai yang mirip dengan berikut di kolom Input Value, dan pilih EntityId/ConnectorInputPayload/FilterClause sebagai Variabel lokal.
Selain menentukan entityId, Anda juga dapat menetapkan filterClause ke {"Id": 13}.

Dengan menjalankan contoh ini, respons yang mirip dengan berikut akan ditampilkan dalam variabel output connectorOutputPayload tugas konektor:
```
{"Id": 13 }
```

Mendapatkan bantuan dari komunitas Google Cloud

Anda dapat memposting pertanyaan dan mendiskusikan konektor ini di komunitas Google Cloud di Forum Cloud.

Langkah berikutnya

Pahami cara menangguhkan dan melanjutkan koneksi.
Pahami cara memantau penggunaan konektor.
Pahami cara melihat log konektor.