Catatan
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba masuk atau mengubah direktori.
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba mengubah direktori.
Layanan Azure DevOps | Azure DevOps Server | Azure DevOps Server 2022
Gunakan jenis tautan yang berbeda untuk mengelola hubungan antara item kerja dan artefak lainnya, seperti build, penerapan, dan permintaan pull. Artikel ini menjelaskan jenis tautan berikut.
- Jenis tautan kerja: Menautkan item kerja yang mencakup item manajemen kasus uji tertentu
- Hyperlink: Menyambungkan item kerja ke URL atau berbagi jaringan apa pun
- Jenis tautan eksternal: Menyambungkan item kerja ke objek eksternal, seperti objek kode, build, atau halaman wiki
- Jenis tautan kerja jarak jauh: Menyambungkan item kerja yang ditentukan dalam organisasi yang berbeda
- Jenis tautan GitHub: Menyambungkan item kerja ke permintaan penerapan, masalah, atau penarikan repositori GitHub.
Bidang tertentu mempertahankan jumlah tautan untuk empat jenis tautan pertama, seperti Jumlah Tautan Terkait, Jumlah Hyperlink, Jumlah Tautan Eksternal, dan Jumlah Tautan Jarak Jauh.
- Jenis tautan kerja: menautkan item kerja termasuk memilih item kerja manajemen kasus pengujian
- Hyperlink: menyambungkan item kerja ke URL atau berbagi jaringan apa pun
- Jenis tautan eksternal: menyambungkan item kerja ke objek eksternal, seperti objek kode, build, atau halaman wiki
- Jenis tautan GitHub: menyambungkan item kerja ke permintaan penerapan atau penarikan repositori GitHub.
Bidang tertentu mempertahankan jumlah tautan untuk tiga jenis tautan pertama, seperti Jumlah Tautan Terkait, Jumlah Hyperlink, dan Jumlah Tautan Eksternal.
Jenis tautan memiliki batasan topologis. Gunakan panduan dalam tabel berikut untuk memilih jenis tautan berdasarkan kueri dan laporan yang anda rencanakan untuk dibuat. Untuk mempelajari selengkapnya tentang topologi, lihat Topologi jenis tautan dan pembatasan.
Jenis tautan kerja
Jenis tautan kerja ditentukan sistem, ditentukan proses, atau ditentukan pengguna (kustom). Tautan yang tercantum dalam tabel berikut ini ditentukan sistem.
Setiap jenis tautan kerja menentukan label, topologi, dan batasan yang digunakan saat Anda membuat tautan di antara item kerja. Misalnya, jenis tautan induk-turunan menentukan dua label: Induk dan Anak. Jenis tautan menggunakan topologi pohon dan mencegah referensi melingkar di antara item kerja.
Jumlah Tautan Terkait item kerja adalah jumlah dari semua tautan yang ditentukan dengan tipe tautan kerja.
Tabel berikut ini menjelaskan jenis tautan item kerja yang bisa Anda tentukan untuk mencakup kontrol tautan menggunakan elemen XML WorkItemLinksFilter.
Nama
nama referensi
Penggunaan
Mempengaruhi-Dipengaruhi oleh (khusus CMMI) 
Microsoft.VSTS.Common.Affects-Forward
Microsoft.VSTS.Common.Affects-Reverse
Jenis topologi: Dependensi
Kategori tautan: Didefinisikan oleh proses
Gunakan tautan arah ini untuk membuat tautan antar item kerja tanpa membuat perulangan tertutup. Orang biasanya menggunakannya untuk melacak permintaan perubahan yang terkait dengan persyaratan.
Pembatasan dan rekomendasi:
- Tautkan permintaan perubahan hanya ke satu persyaratan menggunakan Affects. Tautkan persyaratan ke permintaan perubahan anak sebanyak yang diperlukan menggunakan Terpengaruh oleh.
- Hanya gunakan Affects-Affected menggunakan tautan untuk menautkan item kerja dalam proyek yang sama. Kami menyarankan ini saat Anda berencana menggunakan Excel untuk mengubah atau memperbarui data item kerja.
Anak-Orang Tua
System.LinkTypes.Hierarchy-Forward
System.LinkTypes.Hierarchy-Reverse
Jenis topologi: Pohon
Kategori tautan: Ditentukan sistem
Gunakan tautan arah ini untuk membuat hubungan satu ke banyak antara satu induk dan satu atau beberapa item turunan. Gunakan untuk mengatur item kerja dalam hierarki. Anda dapat membuat hierarki ini di antara item backlog menggunakan fungsi pemetaan atau di antara item dan tugas backlog menggunakan backlog sprint atau Taskboard.
Penggunaan umum meliputi:
- Pertahankan hubungan ringkasan tugas. Tautan induk-turunan mewakili tugas ringkasan dan tugas bawahannya.
- Hubungkan tugas ke PBI, cerita pengguna, atau persyaratan. Mendukung laporan Gambaran Umum Backlog, Gambaran Umum Cerita, dan Gambaran Umum Persyaratan.
Pembatasan dan rekomendasi:
- Gunakan Excel untuk mengedit item kerja secara massal dan tautan induk-turunan. Lihat Menambahkan atau mengubah item kerja secara massal dengan Excel.
- Item kerja hanya dapat memiliki satu Induk. Item kerja induk dapat memiliki banyak anak.
- Hanya gunakan tautan induk-turunan untuk menautkan item kerja dalam proyek yang sama. Kami menyarankan ini saat Anda berencana menggunakan Excel untuk mengubah atau memperbarui data item kerja.
Duplicate-Duplicate
System.LinkTypes.Duplicate-Forward
System.LinkTypes.Duplicate-Reverse
Jenis topologi: Pohon
Kategori tautan: Ditentukan sistem
Gunakan tautan yang bersifat mengarah ini untuk membuat hubungan satu ke banyak guna melacak tugas, bug, atau item pekerjaan lainnya yang menggandakan satu sama lain.
Pembatasan dan rekomendasi:
- Item kerja hanya dapat memiliki satu Duplikat.
- Hanya gunakan tautan Duplikat atau Duplikat Of untuk mengaitkan item kerja dalam proyek yang sama. Kami menyarankan ini saat Anda berencana menggunakan Excel untuk mengubah atau memperbarui data item kerja.
Direferensikan Oleh-Referensi
Microsoft.VSTS.TestCase.
ParameterBersamaDirujukOleh
Jenis topologi: Dependensi
Kategori tautan: Didefinisikan oleh proses
Gunakan ini untuk menautkan kasus pengujian ke parameter bersama dan untuk mendukung pengulangan pengujian dengan data yang berbeda. Umumnya, Anda tidak menambahkan jenis tautan ini ke kontrol tautan terlingkup.
Terkait
System.LinkTypes.Related
Jenis topologi: Jaringan
Kategori tautan: Ditentukan sistem
Gunakan tautan non-arah ini untuk membuat hubungan antara item kerja. Gunakan untuk menautkan item kerja pada tingkat yang sama (misalnya, dua cerita pengguna yang tumpang tindih). Jenis tautan Terkait membuat hubungan sederhana dengan sedikit batasan.
- Menghubungkan item kerja yang berada di tingkat yang sama.
- Tautkan item kerja yang ditentukan dalam proyek yang berbeda dan dikelola oleh tim yang berbeda.
- Temukan dan tampilkan item kerja dan item kerja terkait dalam tampilan dua tingkat.
- Buat hubungan sederhana dengan beberapa batasan.
Penerus-Pendahulu
System.LinkTypes.Dependency
Jenis topologi: Dependensi
Kategori tautan: Ditentukan sistem
Pilih Pendahulu saat menautkan ke item kerja yang harus selesai sebelum item saat ini. Pilih Penerus saat menautkan ke item kerja yang harus selesai setelah item saat ini.
Gunakan tautan arah ini untuk melacak tugas yang harus diselesaikan sebelum orang lain memulai. Tugas tertaut muncul sebagai hubungan pendahulu-penerus di Azure Boards.
- Lacak tugas yang harus diselesaikan sebelum orang lain dapat memulai.
- Mendukung hubungan satu-ke-banyak.
- Temukan item kerja pendahulu dan penerus dalam tampilan kueri tautan langsung dua tingkat.
Pembatasan dan rekomendasi:
- Kesalahan muncul saat Anda mencoba membuat hubungan melingkar.
- Buat tautan penerus-pendahulu hanya untuk item kerja dalam proyek yang sama saat Anda berencana untuk mengekspor ke Excel. Anda dapat membuat tautan pendahulu-penerus di seluruh proyek, tetapi ekspor/impor Excel hanya akan menyertakan item dari proyek yang mendefinisikan kueri.
Diuji oleh-Uji Coba
Microsoft.VSTS.Common.TestedBy-Forward
Microsoft.VSTS.Common.TestedBy-Reverse
Jenis topologi: Dependensi
Kategori tautan: Didefinisikan oleh proses
Tautkan kasus pengujian ke item kerja seperti bug, cerita pengguna, persyaratan, dan PBA. Gunakan ini untuk melacak kasus pengujian yang memvalidasi cerita pengguna (Agile), PBA (Scrum), atau persyaratan (CMMI). Untuk Azure DevOps lokal, beberapa laporan SQL bergantung pada tautan ini. Lihat Meninjau aktivitas tim untuk mendukung laporan yang berguna.
Menguji Langkah-langkah Case-Shared
Microsoft.VSTS.TestCase.
SharedStepReferencedBy
Jenis topologi: Dependensi
Kategori tautan: Didefinisikan oleh proses
Gunakan ini untuk menautkan kasus pengujian dengan langkah-langkah bersama. Bagikan langkah-langkah antara kasus pengujian untuk menghindari duplikat urutan langkah yang sama.
Hyperlink
Hyperlink menautkan item kerja ke URL apa pun. Jumlah Hyperlink melacak jumlah hyperlink pada item kerja.
Nama tautan
Alat yang didukung
Jenis artefak
Penggunaan
Hyperlink
Pelacakan item kerja
Hyperlink
Gunakan ini untuk menautkan item kerja ke URL. Hyperlink item kerja adalah nama tipe tautan ini di API Jenis Tautan Artefak.
Jenis tautan eksternal
Jenis tautan eksternal ditentukan sistem dan menautkan item kerja ke objek lain yang disimpan dalam Azure DevOps. Jumlah Tautan Eksternal item kerja sama dengan jumlah total semua tautan yang ditentukan dengan jenis tautan eksternal.
Nota
Gunakan jenis tautan eksternal hanya untuk menautkan ke objek Azure DevOps. Untuk menautkan item kerja ke objek di luar Azure DevOps, gunakan hyperlink.
Tabel berikut ini menjelaskan jenis tautan eksternal yang bisa Anda pilih saat menambahkan tautan dari item kerja atau kasus pengujian.
Tabel berikut ini menjelaskan jenis tautan eksternal yang bisa Anda pilih saat menambahkan tautan dari item kerja atau kasus pengujian. Anda juga dapat menentukan salah satu jenis tautan ini untuk mencakup kontrol tautan menggunakan elemen XML ExternalLinksFilter.
Nama tautan
Alat yang didukung
Jenis artefak
Penggunaan
Pemberitahuan Keamanan
Keamanan Tingkat Lanjut
Keamanan Tingkat Lanjut
Digunakan untuk menautkan item kerja ke pemberitahuan Keamanan Tingkat Lanjut.
Cabang
Git
Cabang
Gunakan untuk menautkan item kerja ke cabang.
Alur/Build
Membangun
Membangun
Gunakan ini untuk menautkan item kerja ke sebuah build.
Set Perubahan (atau Diperbaiki dalam Set Perubahan)
VersionControl
Paket perubahan
Gunakan untuk menautkan item kerja ke set perubahan.
Komit (atau Diperbaiki dalam Komit)
Git
Melakukan komitmen
Gunakan untuk menautkan item kerja ke komit.
Ditemukan dalam build
Alur/Build
Membangun
Gunakan ini untuk menautkan item kerja ke sebuah build.
Terintegrasi dalam build
Membangun
Pipelain pembangunan
Gunakan ini untuk menautkan item kerja ke sebuah build.
Terintegrasi dalam lingkungan rilis
Lepaskan
Proses alur rilis
Gunakan untuk menautkan rilis ke item kerja. Sistem membuat jenis ini ketika pengguna mengaktifkan laporkan status penyebaran ke Work untuk definisi rilis.
Permintaan Penarikan
Git
PullRequestId
Gunakan untuk menautkan item kerja ke permintaan pull.
Lampiran hasil
Manajemen Pengujian
TcmResultAttachment
Gunakan untuk menautkan item kerja ke lampiran yang terkait dengan hasil pengujian. Tautan ini muncul saat Anda mengaitkan item kerja dengan hasil pengujian dari Test atau Microsoft Test Manager.
File Kode Sumber
VersionControl
Versi Terbaru Item
Gunakan untuk menautkan item kerja ke file di bawah kontrol versi Team Foundation (TFVC).
Papan cerita
Persyaratan
Papan cerita
Gunakan untuk menautkan item kerja ke file PowerPoint atau file lain yang berisi informasi papan cerita di jaringan.
Etiket
Git
Etiket
Gunakan untuk menautkan item kerja ke tag yang ditentukan untuk komit git atau repositori. Untuk informasi selengkapnya, lihat Bekerja dari prompt perintah Git.
Hasil Pengujian
Manajemen Pengujian
TcmResult
Gunakan untuk menautkan item kerja ke hasil pengujian. Tautan ini muncul saat Anda mengaitkan item kerja dengan hasil pengujian dari Test atau Microsoft Test Manager.
Item berversi
VersionControl
Versi Terbaru Item
Gunakan untuk menautkan item kerja ke file atau set perubahan yang ditentukan dalam repositori TFVC. File Kode Sumber adalah nama jenis tautan ini di API Jenis Tautan Artefak.
Wiki
Wiki
Wiki
Gunakan untuk menautkan item kerja ke halaman wiki. Didukung untuk TFS 2018.2 dan versi yang lebih baru.
Jenis tautan GitHub
Jenis tautan GitHub adalah item kerja yang ditentukan sistem dan ditautkan ke objek GitHub seperti yang ditunjukkan di sini.
Penting
Anda hanya dapat menautkan ke artefak GitHub untuk repositori yang terhubung ke Azure Boards.
Tabel berikut ini menjelaskan jenis tautan GitHub yang bisa Anda pilih saat menambahkan tautan dari item kerja.
Nama tautan
Jenis artefak
Penggunaan
Penerapan GitHub
Penerapan repositori GitHub
Gunakan untuk menautkan item tugas ke commit GitHub.
Masalah GitHub
Masalah repositori GitHub
Gunakan untuk menautkan item kerja ke masalah GitHub.
Permintaan Tarik GitHub
Permintaan penarikan repositori GitHub
Gunakan untuk menautkan item kerja ke permintaan pull GitHub.
Tipe tautan kerja jarak jauh
Jenis tautan kerja jarak jauh mendukung penautan item kerja yang ditentukan dalam organisasi yang berbeda, selama ID Microsoft Entra yang sama mengelola organisasi tersebut (lihat Menyambungkan organisasi Anda ke ID Microsoft Entra).
Jumlah Tautan Jarak Jauh pada item kerja adalah jumlah dari semua tautan yang ditentukan dengan jenis tautan kerja jarak jauh.
Nama
nama referensi
Penggunaan
Penggunaan From-Produced Untuk
(Topologi dependensi) 
System.LinkTypes.Remote.Dependency-Forward
System.LinkTypes.Remote.Dependency-Reverse
Jenis topologi: Dependensi
Kategori tautan: Ditentukan sistem
Gunakan tautan arah ini untuk membuat dependensi antara item kerja yang ditentukan dalam organisasi yang berbeda, selama ID Microsoft Entra yang sama mengelolanya. Orang biasanya menggunakan ini untuk melacak permintaan perubahan yang ditautkan ke persyaratan di seluruh batas org.
Berkaitan dengan Jarak Jauh
System.LinkTypes.Remote.Related
Jenis topologi: Jaringan
Kategori tautan: Ditentukan sistem
Gunakan tautan non-arah ini untuk menghubungkan item kerja yang ditentukan dalam organisasi yang berbeda, selama ID Microsoft Entra yang sama mengelolanya.
Jenis tautan kustom
Buat jenis tautan kustom, ekspor dan impor definisi jenis tautan, dan hapus, aktifkan, nonaktifkan, atau aktifkan kembali jenis tautan kustom. See:
Daftar jenis tautan
Anda dapat mencantumkan jenis tautan menggunakan alat baris perintah yang didukung.
az boards daftar tipe hubungan item-kerja
Cantumkan jenis tautan yang didukung oleh organisasi Anda dengan perintah az boards work-item relation list-type atau Work Item Relation Type - List REST API. Untuk detailnya, lihat Mulai menggunakan Azure DevOps CLI.
az boards work-item relation list-type [--org]
Parameter opsional
-
org: URL organisasi Azure DevOps. Anda dapat mengonfigurasi organisasi default menggunakan
az devops configure -d organization=ORG_URL. Diperlukan jika tidak dikonfigurasi sebagai default atau diperoleh menggunakangit config. Contoh:--org https://dev.azure.com/MyOrganizationName/.
Contoh
Perintah berikut mencantumkan jenis tautan item kerja dalam format tabel yang telah ditentukan untuk organisasi Fabrikam.
az boards work-item relation list-type --org fabrikam --output table
Name ReferenceName Enabled Usage
-------------------- ----------------------------------------------------------- --------- ------------
Produces For System.LinkTypes.Remote.Dependency-Forward True workItemLink
Consumes From System.LinkTypes.Remote.Dependency-Reverse True workItemLink
Duplicate System.LinkTypes.Duplicate-Forward True workItemLink
Duplicate Of System.LinkTypes.Duplicate-Reverse True workItemLink
Referenced By Microsoft.VSTS.TestCase.SharedParameterReferencedBy-Forward True workItemLink
References Microsoft.VSTS.TestCase.SharedParameterReferencedBy-Reverse True workItemLink
Tested By Microsoft.VSTS.Common.TestedBy-Forward True workItemLink
Tests Microsoft.VSTS.Common.TestedBy-Reverse True workItemLink
Test Case Microsoft.VSTS.TestCase.SharedStepReferencedBy-Forward True workItemLink
Shared Steps Microsoft.VSTS.TestCase.SharedStepReferencedBy-Reverse True workItemLink
Successor System.LinkTypes.Dependency-Forward True workItemLink
Predecessor System.LinkTypes.Dependency-Reverse True workItemLink
Child System.LinkTypes.Hierarchy-Forward True workItemLink
Parent System.LinkTypes.Hierarchy-Reverse True workItemLink
Related System.LinkTypes.Related True workItemLink
Remote Related System.LinkTypes.Remote.Related True workItemLink
Attached File AttachedFile True resourceLink
Hyperlink Hyperlink True resourceLink
Artifact Link ArtifactLink True resourceLink
Format json default menyediakan informasi tambahan tentang atribut yang ditentukan untuk jenis tautan. Misalnya, informasi untuk jenis tautan Menghasilkan Untuk dan Mengonsumsi Dari tercantum sebagai berikut.
{
"attributes": {
"acyclic": true,
"directional": true,
"editable": false,
"enabled": true,
"isForward": true,
"oppositeEndReferenceName": "System.LinkTypes.Remote.Dependency-Reverse",
"remote": true,
"singleTarget": true,
"topology": "dependency",
"usage": "workItemLink"
},
"name": "Produces For",
"referenceName": "System.LinkTypes.Remote.Dependency-Forward",
"url": "https://dev.azure.com/mseng/_apis/wit/workItemRelationTypes/System.LinkTypes.Remote.Dependency-Forward"
},
{
"attributes": {
"acyclic": true,
"directional": true,
"editable": false,
"enabled": true,
"isForward": false,
"oppositeEndReferenceName": "System.LinkTypes.Remote.Dependency-Forward",
"remote": true,
"singleTarget": true,
"topology": "dependency",
"usage": "workItemLink"
},
"name": "Consumes From",
"referenceName": "System.LinkTypes.Remote.Dependency-Reverse",
"url": "https://dev.azure.com/mseng/_apis/wit/workItemRelationTypes/System.LinkTypes.Remote.Dependency-Reverse"
},
witadmin listlinktypes
Anda dapat mencantumkan jenis tautan yang didukung untuk koleksi proyek Anda menggunakan witadmin listlinktypes alat baris perintah atau perintah Work Item Relation Type - List REST API.
Berikut adalah daftar jenis tautan untuk koleksi default fabrikam-sever:
C:\Program Files (x86)\Microsoft Visual Studio\2019\Community\Common7\IDE\CommonExtensions\Microsoft\TeamFoundation\Team Explorer>witadmin listlinktypes /collection:http://fabrikam-server/DefaultCollection
Reference Name: Microsoft.VSTS.TestCase.SharedParameterReferencedBy
Names: Referenced By, References
Topology: Dependency
Is Active: True
Reference Name: Microsoft.VSTS.Common.TestedBy
Names: Tested By, Tests
Topology: Dependency
Is Active: True
Reference Name: Microsoft.VSTS.TestCase.SharedStepReferencedBy
Names: Test Case, Shared Steps
Topology: Dependency
Is Active: True
Reference Name: System.LinkTypes.Duplicate
Names: Duplicate, Duplicate Of
Topology: Tree
Is Active: True
Reference Name: System.LinkTypes.Dependency
Names: Successor, Predecessor
Topology: Dependency
Is Active: True
Reference Name: System.LinkTypes.Hierarchy
Names: Child, Parent
Topology: Tree
Is Active: True
Reference Name: System.LinkTypes.Related
Name: Related
Topology: Network
Is Active: True
Atribut jenis tautan
Tabel berikut ini menyediakan deskripsi untuk setiap atribut jenis tautan yang dikembalikan oleh Azure Boards CLI atau REST API.
Atribut
Deskripsi
Nama name
Menentukan nama ramah yang ditetapkan ke jenis tautan. Tautan arah didefinisikan berpasangan, oleh karena itu menyertakan nama maju dan terbalik.
Nama referensi, referenceName
Menentukan nama yang diberikan kepada tipe tautan atau pasangan tipe tautan.
acyclic
Menunjukkan apakah jenis tautan mengizinkan atau (true) atau membatasi (false) hubungan melingkar. Misalnya, tautan jenis pohon membatasi hubungan melingkar. Untuk informasi selengkapnya, lihat Referensi elemen LinkTypes.
directional
Menunjukkan apakah jenis tautan bersifat terarah (true) atau tidak (false). Jenis tautan arah didefinisikan berpasangan dengan komponen maju dan mundur. Untuk informasi selengkapnya, lihat Referensi elemen LinkTypes.
editable
Menunjukkan apakah jenis tautan dapat diedit (true) atau tidak (false). Anda hanya dapat menambahkan dan mengedit jenis tautan kustom untuk penyebaran lokal menggunakan witadmin alat kelola baris perintah jenis tautan. Jenis tautan sistem selalu memiliki editable=false.
Aktif, enabled
Menunjukkan apakah jenis tautan aktif (true) atau tidak (false). Anda hanya dapat menggunakan jenis tautan kustom untuk penyebaran lokal menggunakan witadmin alat baris perintah Kelola jenis tautan .
isForward
Menunjukkan apakah jenis tautan menentukan tautan penerusan (true) atau tidak (False) dalam pasangan jenis tautan.
oppositeEndReferenceName
Menentukan nama referensi jenis tautan yang menentukan tautan ke arah berlawanan dari pasangan jenis tautan.
remote
Menunjukkan apakah jenis tautan mendukung penautan ke item kerja jarak jauh (true) atau tidak (False). Jenis tautan dengan remote=false mengharuskan item kerja target berada di organisasi atau koleksi yang sama dengan item kerja asal.
singleTarget
Menunjukkan apakah jenis tautan memungkinkan lebih dari satu target (false) atau dibatasi untuk satu target (true).
topology
Menentukan jenis topologi: dependency, network, dan tree. Untuk deskripsi, lihat Jenis tautan topologi dan pembatasan.
usage
Menentukan jenis penggunaan: resourceLink or nilai workItemLink. The workItemLink menunjukkan jenis tautan yang menautkan dua item kerja. Nilai resourceLink menunjukkan jenis tautan yang digunakan untuk menautkan item kerja ke sumber daya, seperti URL atau lampiran.
url
Mencantumkan atribut jenis tautan dalam format json.