Mencantumkan bidang dan atribut item kerja

Layanan Azure DevOps | Azure DevOps Server 2022 - Azure DevOps Server 2019

Untuk deskripsi setiap bidang yang ditentukan dengan proses sistem, lihat Indeks bidang item kerja.

Prasyarat

Mencantumkan atau meninjau bidang

Untuk mencantumkan atau meninjau bidang, gunakan salah satu alat berikut berdasarkan model proses Anda—XML yang Diwariskan, DIhosting, atau XML Lokal. Untuk indeks bidang yang ditentukan dalam proses default, lihat Indeks bidang item kerja.

Jenis dan nama data bidang

Setiap jenis item kerja menentukan bidang yang disertakan dalam item kerja dari jenis tersebut. Setiap bidang memiliki beberapa atribut, banyak di antaranya didefinisikan sistem dan tidak dapat diubah.

Bidang ditentukan oleh tiga atribut berikut:

• Jenis data: Menunjukkan jenis data yang dapat dimasukkan ke dalam bidang, seperti Boolean, Double, Integer, HTML, atau String. Untuk deskripsi terperinci tentang setiap jenis data, lihat Bidang kueri, operator, dan makro.
• Nama yang mudah diingat: Nama yang mudah digunakan untuk ditetapkan ke bidang, digunakan saat memilih Bidang dalam klausa kueri. Nama ini mungkin berbeda dari nama yang ditampilkan pada formulir item kerja.
• Nama referensi: Pengidentifikasi yang digunakan saat membuat kueri WIQL, templat item kerja improvisasi, menjalankan perintah REST API, atau menentukan definisi jenis item kerja XML. Nama referensi bersifat permanen dan tidak dapat diubah setelah diatur.

Untuk deskripsi terperinci tentang setiap atribut bidang dan instruksi tentang cara mencantumkannya, lihat Atribut bidang dan Daftar atribut bidang nanti di artikel ini. Untuk gambaran umum jenis item kerja (WIT) dan item kerja, lihat Melacak pekerjaan dengan cerita pengguna, masalah, bug, fitur, dan epik.

Apa itu bidang? Bagaimana nama bidang digunakan?

Setiap jenis item kerja mencakup 31 bidang sistem dan beberapa bidang khusus jenis. Item kerja digunakan untuk merencanakan dan melacak proyek Anda.

Setiap bidang menangkap informasi spesifik tentang pekerjaan yang akan dilakukan. Nilai yang Anda tetapkan ke bidang ini disimpan di penyimpanan data pelacakan kerja, memungkinkan Anda membuat kueri yang menentukan status dan tren.

Untuk deskripsi dan penggunaan setiap bidang yang ditentukan untuk proses sistem inti—Agile, Basic, Scrum, dan CMMI—lihat indeks bidang Item kerja.

Nama bidang

Nama bidang item kerja secara unik mengidentifikasi setiap bidang item kerja. Pastikan nama bidang Anda mematuhi panduan berikut:

• Keunikan: Nama bidang harus unik dalam koleksi akun atau proyek.
• Panjang: Nama bidang harus berisi 128 karakter Unicode atau kurang.
• Penspasian: Nama bidang tidak boleh memiliki spasi di depan atau di belakang atau berisi dua atau beberapa spasi berturut-turut.
• Komposisi: Nama bidang harus menyertakan setidaknya satu karakter alfabet.
• Karakter yang Dilarang: Nama bidang tidak dapat menyertakan karakter berikut: .,;':~/*|?" &%$!+=()[]{}<>'.

Karena bidang kustom ditentukan di tingkat organisasi atau koleksi, Anda tidak dapat menambahkan bidang kustom dengan nama yang sama ke beberapa proses.

Untuk informasi selengkapnya, lihat Pembatasan dan konvensi penamaan.

Bidang sistem dan yang telah ditentukan sebelumnya

Nama bidang item kerja secara unik mengidentifikasi setiap bidang dalam Azure DevOps. Pastikan nama bidang Anda mematuhi panduan berikut:

• Keunikan: Nama bidang harus unik dalam akun atau koleksi proyek.
• Panjang: Nama bidang harus 128 karakter Unicode atau lebih sedikit.
• Penspasian: Nama bidang tidak boleh memiliki spasi di depan atau di belakang atau berisi beberapa spasi berturut-turut.
• Komposisi: Nama bidang harus menyertakan setidaknya satu karakter alfabet.
• Karakter yang Dilarang: Nama bidang tidak dapat menyertakan karakter berikut: .,;':~/*|?" &%$!+=()[]{}<>'.

Karena bidang kustom ditentukan di tingkat organisasi atau koleksi, Anda tidak dapat menambahkan bidang kustom dengan nama yang sama ke beberapa proses.

Untuk informasi selengkapnya, lihat Pembatasan dan konvensi penamaan.

Bidang isian kustom

Karena bidang kustom ditentukan di tingkat organisasi atau koleksi proyek, Anda tidak dapat menambahkan bidang kustom dengan nama yang sama ke beberapa proses.

Saat menambahkan bidang kustom, perhatikan batas berikut:

• Bidang maksimum per jenis item kerja (WIT): 64
• Bidang maksimum per proses: 512

Jenis data bidang menentukan jenis dan ukuran data yang dapat disimpan di bidang . Setiap bidang hanya dapat memiliki satu jenis yang ditentukan dalam kumpulan proyek, mendorong penggunaan bidang umum di berbagai proyek dan jenis item kerja.

Saat Anda menambahkan bidang kustom ke proses yang diwariskan, Azure DevOps menetapkan nama referensi yang diawali dengan Kustom diikuti dengan nama bidang tanpa spasi. Misalnya, menambahkan bidang bernama DevOps Triage menghasilkan nama referensi Custom.DevOpsTriage. Spasi tidak diperbolehkan dalam nama referensi.

Untuk informasi selengkapnya, lihat Pembatasan dan konvensi penamaan.

Bagaimana cara menentukan jenis data bidang?

Tinjau daftar bidang

Untuk meninjau daftar bidang yang ditentukan untuk organisasi atau koleksi, lakukan langkah-langkah berikut:

1. Pilih logo Azure DevOps untuk membuka Proyek. Lalu pilih Pengaturan organisasi.

   

2. Pilih Proses.

   

3. Pilih Bidang.

   Bidang yang tercantum sesuai dengan semua bidang yang ditentukan untuk organisasi atau koleksi, yang mencakup semua bidang kustom dan bidang yang ditentukan untuk proses sistem.

   

   Catatan

   Jika Anda tidak melihat Bidang, maka koleksi Anda menggunakan proses XML lokal. Halaman Bidang tidak didukung untuk proses tersebut.

   Untuk deskripsi, penggunaan, dan nama referensi setiap bidang, lihat indeks bidang Item kerja. Selain itu, Anda dapat mengambil nama referensi bidang menggunakan Bidang Jenis Item Kerja - Daftar REST API.

Penjelajah Bidang Item Kerja

Anda dapat mencari penetapan atribut bidang menggunakan alat Penjelajah Bidang Item Kerja.

Untuk mengakses Penjelajah Bidang Item Kerja, instal Alat Editor Proses. Berdasarkan versi Visual Studio yang diinstal, dapatkan Alat Editor Proses dari salah satu ekstensi berikut.

• Visual Studio 2019 & 2022: Mulai sekarang, tidak ada ekstensi Editor Templat Proses tertentu yang tersedia. Namun, Anda masih dapat menyesuaikan templat proses menggunakan alat lain seperti editor teks atau editor XML apa pun. Anda juga dapat menggunakan portal web Azure DevOps untuk kustomisasi tertentu, terutama untuk proses yang diwariskan.
• Visual Studio 2017: Editor Templat Proses TFS. Anda juga dapat menggunakan versi Editor Proses ini untuk memodifikasi formulir item kerja gaya lama. Anda tidak dapat menggunakannya untuk mengedit formulir yang terkait dengan formulir web baru.
• Visual Studio 2015: Alat Daya TFS.

Atribut bidang

Ada banyak atribut yang tidak dapat dipertukarkan dan tersembunyi untuk setiap bidang item kerja. Tabel berikut ini menjelaskan setiap atribut. Atribut memiliki nama yang berbeda tergantung pada apakah Anda mengambilnya melalui Fields - Get REST API atau melihatnya melalui alat Work Item Field Explorer (WIFE).

Atribut yang ditetapkan ke bidang bergantung pada platform dan versi yang Anda gunakan. Misalnya, beberapa atribut tidak didukung dengan proses Warisan. Untuk mencari nama referensi untuk bidang, lihat indeks bidang Item kerja.

Mencantumkan atribut bidang

https://dev.azure.com/OrganizationName/_apis/wit/fields/FieldReferenceName

https://dev.azure.com/fabrikam/_apis/wit/fields/System.IterationPath

**Returned data:**

> [!div class="tabbedCodeSnippets"]
> ```JSON
> {
> "name": "Iteration Path",
> "referenceName": "System.IterationPath",
> "description": "The iteration within which this bug will be fixed",
> "type": "treePath",
> "usage": "workItem",
> "readOnly": false,
> "canSortBy": true,
> "isQueryable": true,
> "supportedOperations": [
> {
> "referenceName": "SupportedOperations.Under",
> "name": "Under"
> },
> {
> "referenceName": "SupportedOperations.NotUnder",
> "name": "Not Under"
> },
> {
> "referenceName": "SupportedOperations.Equals",
> "name": "="
> },
> {
> "referenceName": "SupportedOperations.NotEquals",
> "name": "<>"
> },
> {
> "referenceName": "SupportedOperations.In",
> "name": "In"
> },
> {
> "name": "Not In"
> }
> ],
> "isIdentity": false,
> "isPicklist": false,
> "isPicklistSuggested": false,
> "url": "https://dev.azure.com/mseng/_apis/wit/fields/System.IterationPath"
> }
> ```

https://{ServerName:Port}/tfs/{Collection}/_apis/wit/fields/FieldReferenceName?api-version={version}

https://fabrikam:8080/tfs/DefaultCollection/_apis/wit/fields/System.IterationPath?api-version=4.1

{
"name": "Iteration Path",
"referenceName": "System.IterationPath",
"description": "The iteration within which this bug will be fixed",
"type": "treePath",
"usage": "workItem",
"readOnly": false,
"canSortBy": true,
"isQueryable": true,
"supportedOperations": [
{
"referenceName": "SupportedOperations.Under",
"name": "Under"
},
{
"referenceName": "SupportedOperations.NotUnder",
"name": "Not Under"
},
{
"referenceName": "SupportedOperations.Equals",
"name": "="
},
{
"referenceName": "SupportedOperations.NotEquals",
"name": "<>"
},
{
"referenceName": "SupportedOperations.In",
"name": "In"
},
{
"name": "Not In"
}
],
"isIdentity": false,
"isPicklist": false,
"isPicklistSuggested": false,
"url": "https://fabrikam:8080/tfs/DefaultCollection/_apis/wit/fields/System.IterationPath?api-version=4.1"
}

witadmin listfields /collection:http://fabrikam:8080/tfs/DefaultCollection /n:Microsoft.VSTS.Common.Issue  

Field: Microsoft.VSTS.Common.Issue  
Name: Issue  
Type: String  
Reportable As: dimension  
Use: Adventure Works (Shared Steps), AW Future (Shared Steps), AW Current (Shared Steps)  
Indexed: False  

Menambahkan dan memodifikasi bidang

Artikel terkait