Bidang dan atribut item kerja di Azure Boards

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

Bidang item kerja digunakan untuk melacak informasi. Bidang didefinisikan untuk organisasi dan dibagikan di semua proyek yang ditentukan untuk organisasi tersebut. Anda dapat menggunakan salah satu dari dua alat untuk meninjau bidang yang ditentukan untuk organisasi. Alat-alat ini tersedia untuk model proses XML yang Diwariskan dan Dihosting.

• Halaman web Bidang Proses>
• Penjelajah Bidang Item Kerja

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

Prasyarat

• Untuk melihat bidang yang ditentukan untuk organisasi atau koleksi, Anda harus menjadi anggota grup aplikasi Pengguna Valid Koleksi Proyek atau memiliki izin Tampilkan informasi tingkat instans yang diatur ke Izinkan untuk organisasi atau koleksi.

Mencantumkan atau meninjau bidang

Untuk mencantumkan atau meninjau bidang, Anda bisa menggunakan salah satu alat berikut, bergantung pada model proses—Warisan, XML yang Dihosting, atau XML Lokal—yang Anda gunakan. Untuk indeks bidang yang ditentukan dalam proses default, lihat Indeks bidang item kerja.

Alat	Warisan	XML yang dihosting	XML lokal
Portal web: Mencantumkan bidang yang diwariskan dan ditentukan khusus	✔️	✔️1
Penjelajah bidang item kerja	✔️	✔️	✔️
alat baris perintah witadmin listfields	✔️	✔️	✔️

Catatan

1. Hanya didukung untuk proses default (Agile, CMMI, Scrum).

Jenis dan nama data bidang

Setiap jenis item kerja menentukan bidang yang ditentukan untuk item kerja yang mereferensikan jenis tersebut. Setiap bidang dikaitkan dengan sejumlah atribut, banyak di antaranya diatur oleh sistem dan tidak dapat diubah.

Setiap bidang ditentukan oleh tiga atribut berikut.

• Jenis data: Menentukan jenis data yang dapat dimasukkan ke dalam bidang, seperti Boolean, Double, Integer, HTML, dan String. Untuk deskripsi setiap jenis data, lihat Bidang kueri, operator, dan makro.
• Nama yang mudah diingat: Menentukan nama yang ditetapkan ke bidang dan yang Anda pilih untuk Bidang dalam klausa kueri. Nama ini mungkin berbeda dari nama yang ditampilkan pada formulir item kerja.
• Nama referensi: Menentukan nama yang Anda gunakan saat membuat kueri WIQL atau templat item kerja improvisasi, menggunakan perintah REST API, atau menentukan definisi jenis item kerja XML. Setelah ditentukan, nama referensi tidak dapat diubah.

Untuk deskripsi setiap atribut bidang dan bagaimana Anda bisa mencantumkannya, lihat Atribut bidang dan Daftar atribut bidang nanti di artikel ini. Untuk gambaran umum WIT dan item kerja, lihat Melacak pekerjaan dengan cerita, masalah, bug, fitur, dan epik pengguna.

Apa itu bidang? Bagaimana nama bidang digunakan?

Setiap jenis item kerja dikaitkan dengan 31 bidang sistem dan beberapa bidang yang lebih spesifik jenis. Anda menggunakan item kerja untuk merencanakan dan melacak proyek Anda.

Setiap bidang mendukung pelacakan sepotong informasi tentang pekerjaan yang akan dilakukan. Nilai yang Anda tetapkan ke bidang disimpan di penyimpanan data pelacakan kerja yang dapat Anda buat kueri untuk menentukan status dan tren.

Untuk deskripsi dan penggunaan setiap bidang yang ditentukan untuk proses sistem inti, proses 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 termasuk dalam panduan ini:

• Nama bidang harus unik dalam kumpulan akun/proyek
• Nama bidang harus 128 atau lebih sedikit karakter Unicode
• Nama bidang tidak boleh berisi spasi di depan atau di belakang, atau dua spasi berturut-turut atau lebih
• Nama bidang harus berisi setidaknya satu karakter alfabet
• Nama bidang tidak boleh berisi karakter berikut: .,;'`:~\/\*|?"&%$!+=()[]{}<>.

Karena bidang kustom ditentukan untuk organisasi atau koleksi, Anda tidak dapat menambahkan bidang kustom ke proses dengan nama bidang yang sama dengan yang Anda tambahkan ke proses lain.

Untuk informasi selengkapnya, lihat Pembatasan dan konvensi penamaan.

Bidang sistem dan yang telah ditentukan sebelumnya

Semua bidang yang ditentukan sistem memiliki nama referensi yang dimulai dengan Sistem, misalnya, System.AreaPath, System.AssignedTo, dan melanjutkan dalam pola tersebut.

Bidang yang telah ditentukan sebelumnya yang ditentukan oleh proses default dimulai dengan Microsoft.VSTS dan kemudian lebih jauh berbeda berdasarkan penggunaannya. Contoh bidang yang telah ditentukan sebelumnya yang digunakan secara umum, untuk tujuan penjadwalan dan integrasi dengan Office Project, untuk integrasi dengan Team Foundation Build, dan integrasi dengan manajemen kasus pengujian (TCM) adalah sebagai berikut:

• Microsoft.VSTS.Common.Priority
• Microsoft.VSTS.Scheduling.DueDate
• Microsoft.VSTS.Build.FoundIn
• Microsoft.VSTS.TCM.Steps

Untuk gambaran umum semua sistem dan bidang yang telah ditentukan sebelumnya yang ditentukan untuk proses/templat proses default, lihat Indeks bidang item kerja. Untuk informasi selengkapnya tentang menentukan nama bidang, lihat Pembatasan penamaan.

Bidang isian kustom

Karena bidang kustom ditentukan untuk organisasi atau koleksi proyek, Anda tidak dapat menambahkan bidang kustom ke proses dengan nama bidang yang sama dengan yang Anda tambahkan ke proses lain.

Saat menambahkan bidang kustom, perhatikan batas berikut:

• Maksimum 64 bidang dapat didefinisikan untuk setiap WIT
• Maksimal 512 bidang dapat ditentukan per proses

Jenis data bidang menentukan jenis dan ukuran data yang bisa Anda simpan di bidang . Bidang hanya dapat memiliki satu jenis yang ditentukan dalam kumpulan proyek. Pembatasan ini mendorong organisasi untuk menggunakan bidang umum di seluruh proyek dan jenis item kerja.

Saat Anda menambahkan bidang kustom ke proses yang diwariskan, Azure DevOps menetapkan nama referensi yang diawali dengan Kustom lalu nama bidang dengan spasi dihapus. Misalnya, Anda menambahkan bidang bernama DevOps Triage, nama referensinya adalah Custom.DevOpsTriage. Tidak ada spasi yang diizinkan dalam nama referensi.

Bagaimana cara menentukan jenis data bidang?

Anda bisa menampilkan tipe data bidang yang ditentukan untuk organisasi Anda dengan membuka halaman Bidang Proses>.

Halaman web Bidang Proses>

Untuk meninjau daftar bidang yang ditentukan untuk organisasi atau koleksi, buka Pengaturan organisasi>Bidang Proses>.

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

   

2. Kemudian, pilih Proses.

   

   Catatan

   Jika Anda tidak melihat Proses, maka Anda bekerja dari TFS-2018 atau versi yang lebih lama. Halaman Proses tidak didukung. Anda harus menggunakan fitur yang didukung untuk model proses XML lokal.

3. Lalu, pilih Bidang.

   Bidang yang tercantum sesuai dengan semua bidang yang ditentukan untuk organisasi atau koleksi. Ini termasuk semua bidang kustom dan 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 dan penggunaan setiap bidang, serta Nama referensi untuk setiap bidang, Anda dapat mencarinya dari indeks bidang Item kerja. Anda juga bisa mendapatkan Nama referensi bidang dari 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, Anda harus menginstal Alat Editor Proses. Berdasarkan versi Visual Studio yang telah Anda instal, 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 diubah dan tersembunyi untuk setiap bidang item kerja. Tabel berikut ini menjelaskan setiap atribut. Atribut memiliki nama yang berbeda berdasarkan jika Anda mendapatkannya melalui Bidang - DapatkanREST API atau lihat melalui alat Penjelajah Bidang Item Kerja (ISTRI).

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

Atribut

Jenis atribut

Keterangan

---

REST:
ISTRI: AllowedValues

collection

Mendapatkan kumpulan nilai yang valid untuk bidang yang berisi nilai daftar pilih. Anda dapat mengubah ini dengan menentukan daftar pilihan atau daftar global (lokal).
Dapat berubah?=Ya

REST: canSortBy
ISTRI: CanSortBy

Boolean

Menunjukkan apakah Anda bisa mengurutkan hasil kueri dengan bidang ini.
Dapatkah berubah?=Tidak

REST: deskripsi
ISTRI: HelpText

string

Menentukan deskripsi untuk bidang , yang juga menentukan teks bantuan yang muncul saat Anda mengarahkan mouse ke atas bidang dalam formulir item kerja.
Dapat berubah?=Ya

REST:
ISTRI: ID

Bilangan bulat

Menentukan ID internal bidang.
Dapatkah berubah?=Tidak

REST:
ISTRI: Dapat Diklik

Boolean

Menunjukkan apakah nilai yang ditentukan untuk bidang disalin saat pengguna memilih untuk menyalin item kerja. Misalnya, bidang Judul, Tag, dan Deskripsi disalin, tetapi bidang ID dan Riwayat tidak disalin.
Dapatkah berubah?=Tidak

REST:
ISTRI: IsComputed

Boolean

Menunjukkan apakah nilai yang ditetapkan oleh bidang ini dihitung oleh sistem (True) atau tidak (False). Contoh bidang komputasi adalah bidang yang diatur oleh sistem, seperti ID, Tanggal Direvisi, Tanggal Diubah, dan Jumlah Tautan Eksternal.
Dapatkah berubah?=Tidak

REST:
ISTRI: IsCoreField

Boolean

Menunjukkan apakah bidang ini ditentukan untuk semua tipe item kerja.
Dapatkah berubah?=Tidak

REST:
ISTRI: Dapat Diedibel

Boolean

Menunjukkan apakah pengguna dapat mengubah bidang ini (Benar) atau tidak (Salah). Contoh bidang yang tidak dapat diedit adalah bidang yang diatur oleh sistem, seperti bidang ID, Revisi, Dibuat Oleh, dan Diubah Menurut
Dapatkah berubah?=Tidak

REST: isIdentity
ISTRI: Isidentitas

Boolean

Menunjukkan apakah bidang ini adalah bidang Identitas . Bidang identitas adalah bidang string yang digunakan untuk menyimpan identitas pengguna.
Dapatkah berubah?=Tidak

REST:
ISTRI: IsIndexed¹

Boolean

Menunjukkan apakah bidang ini diindeks untuk mendukung pencarian.
Dapatkah berubah?=Tidak

REST:
ISTRI: IsLongText

Boolean

Menunjukkan bahwa bidang dapat berisi lebih dari 255 karakter, seperti bidang yang diberi tipe data PlainText, HTML, atau Riwayat.
Dapatkah berubah?=Tidak

REST: isPicklist² WIFE:

Boolean

Menunjukkan apakah bidang dikaitkan dengan daftar pilih. Nilai diatur ke True saat bidang kustom ditentukan untuk jenis Azure DevOps dan Picklist (String) atau Picklist (Bilangan Bulat) dipilih. Nilai diatur ke False untuk bidang yang diwariskan yang menentukan daftar pilih.
Dapatkah berubah?=Tidak

REST: isPicklistSuggested² WIFE:

Boolean

Menunjukkan apakah bidang memungkinkan pengguna memasukkan nilai mereka sendiri untuk daftar pilih. Nilai diatur ke True saat bidang kustom ditentukan untuk jenis Azure DevOps, Picklist (String), atau Picklist (Integer) dipilih, dan kotak centang untuk Izinkan pengguna mengatur nilai mereka sendiri dicentang.
Dapat berubah?=Ya

REST: dapat dikueri
ISTRI: Dapat Dikueri

Boolean

Menunjukkan apakah bidang muncul dalam kumpulan bidang yang bisa Anda tambahkan untuk memfilter kueri item kerja (Benar), atau tidak (Salah). Sebagian besar bidang dapat dikueri.
Dapatkah berubah?=Tidak

REST:
ISTRI: IsReportable ³

Boolean

Menunjukkan apakah atribut yang dapat dilaporkan ditentukan atau diatur ke apa pun selain Tidak Ada. Atribut ini dapat diubah untuk lingkungan lokal.
Dapat berubah?=Ya

REST:
ISTRI: IsUsedInGlobalWorkflow

Boolean

Menunjukkan apakah bidang ditentukan dalam alur kerja global.
Dapatkah berubah?=Tidak

REST:
ISTRI: IsUserNameField

Boolean

Menunjukkan apakah bidang digunakan untuk menampilkan bidang Identitas.
Dapatkah berubah?=Tidak

REST: nama
ISTRI: Nama

string

Nama yang mudah diingat ditetapkan ke bidang . Nama yang mudah diingat tidak dapat diubah untuk Azure DevOps, tetapi dapat diubah untuk lokal menggunakan perintah witadmin changefield .
Hanya dapat berubah?=Lokal

REST: picklistId
ISTRI: HelpText

GUID

Jika bidang adalah daftar pilih, pengidentifikasi daftar pilihan terkait, jika tidak, null. Nilai GUID unik ditetapkan saat bidang kustom ditentukan untuk jenis Azure DevOps dan Picklist (String) atau Picklist (Bilangan Bulat) dipilih.
Dapatkah berubah?=Tidak

REST:
WIFE: ProhibitedValues

collection

Mendapatkan kumpulan nilai yang dilarang untuk bidang yang menentukan nilai tersebut. Anda hanya dapat menentukan nilai yang dilarang untuk penyebaran lokal.
Hanya dapat berubah?=Lokal

REST: readOnly
ISTRI:

Boolean

Menunjukkan apakah bidang diatur untuk dibaca saja. Untuk Azure DevOps Services, hanya bidang kustom yang dapat diubah menjadi baca-saja. Bidang sistem tidak dapat diubah.
Dapat berubah?=Ya

REST: referenceName
WIFE: ReferenceName

string

Menentukan nama referensi bidang.
Dapatkah berubah?=Tidak

REST:
ISTRI: ReportingAttributes³

Menentukan Detail, Dimensi, atau Ukuran, tergantung pada apakah dan bagaimana Anda ingin bidang disertakan dalam laporan. Data dari bidang yang memiliki nilai selain Tidak Ada untuk atribut ini diekspor ke gudang data dan dapat disertakan dalam laporan SQL.
Hanya dapat berubah?=Lokal

REST:
ISTRI: ReportingName³

string

Menentukan label untuk bidang saat data muncul di laporan SQL. Jika Anda tidak menentukan nilai, nama ramah bidang akan digunakan.
Hanya dapat berubah?=Lokal

REST:
ISTRI: ReportingReferenceName³

string

Menentukan nama referensi yang berbeda ke bidang yang digunakan saat data diekspor ke gudang data relasional. Jika Anda tidak menentukan nilai, nama referensi bidang akan digunakan.
Hanya dapat berubah?=Lokal

REST: supportedOperations
ISTRI:

set

Kumpulan operator kueri yang valid untuk digunakan saat mereferensikan bidang ini. Untuk referensi cepat operasi yang didukung berdasarkan jenis data, lihat Referensi cepat kueri, Operator, dan makro yang didukung untuk setiap jenis data.
Dapatkah berubah?=Tidak

REST:
ISTRI: SupportsTextQuery

Boolean

Menunjukkan apakah bidang mendukung kueri teks seperti Berisi Kata, Tidak Berisi Kata.
Dapatkah berubah?=Tidak

REST:
ISTRI: SystemType

string

Menentukan tipe data bidang, merujuk nama sistem seperti System.DateTime atau System.String.
Dapatkah berubah?=Tidak

REST: ketik
ISTRI: FieldType

string

Menentukan jenis data bidang, seperti Boolean, DateTime, Integer, String, dan sebagainya. Untuk daftar dan deskripsi lengkap, lihat Bidang kueri, operator, dan makro.
Dapatkah berubah?=Tidak

REST: penggunaan
ISTRI: Penggunaan

string

Menentukan apakah bidang dimaksudkan untuk digunakan dengan item kerja (WorkItem) atau objek tautan item kerja (WorkItemLink). Penggunaan untuk sebagian besar bidang adalah WorkItem. Untuk daftar lengkap nilai penggunaan, lihat Mendapatkan Bidang, FieldUsage.
Dapatkah berubah?=Tidak

Catatan

1. Untuk penyebaran lokal, Anda dapat mengaktifkan pengindeksan bidang untuk meningkatkan waktu respons kueri saat memfilter pada bidang. Untuk informasi selengkapnya, lihat Bidang terindeks nanti di artikel ini.
2. Atribut isPicklist dan isPicklistSuggested hanya ditetapkan ke bidang kustom yang ditentukan untuk proses yang diwariskan. Model proses yang diwariskan didukung untuk Azure DevOps Server 2019 dan versi yang lebih baru. Untuk informasi selengkapnya, lihat Model proses yang diwariskan.
3. Semua atribut pelaporan hanya valid untuk penyebaran lokal yang proyeknya telah dikonfigurasi untuk mendukung SQL Server Reporting dan SQL Server Analysis Services.

Mencantumkan atribut bidang

Anda dapat mencantumkan atribut yang ditetapkan ke bidang dengan menggunakan Fields - Get REST API. Masukkan nama organisasi Anda untuk OrganizationName.

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

Misalnya, di sini kita mencantumkan atribut untuk Jalur Perulangan, menentukan nama referensi, System.IterationPath, untuk organisasi fabrikam.

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

Data yang dikembalikan:

{
"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"
}

Menambahkan dan memodifikasi bidang

Untuk menambahkan bidang ke proses, Anda menambahkannya ke satu atau beberapa jenis item kerja. Untuk informasi selengkapnya, lihat Mengkustomisasi proses pewarisan.

Artikel terkait

• Referensi cepat kueri
• Indeks bidang item kerja
• Menambahkan dan mengelola bidang untuk proses yang diwariskan
• Referensi metadata untuk Azure Boards Analytics