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.
Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022
Bidang item kerja melacak informasi dalam Azure DevOps. Sistem mendefinisikan bidang ini di tingkat organisasi dan membagikannya di semua proyek dalam organisasi. Untuk meninjau bidang yang ditentukan untuk organisasi Anda, Anda bisa menggunakan salah satu dari dua alat berikut, yang tersedia untuk model proses XML yang diwariskan dan Dihosting:
Kolom item kerja melacak informasi dalam Azure DevOps. Sistem mendefinisikan bidang-bidang ini pada tingkat koleksi dan membagikannya di semua proyek dalam koleksi tersebut. Untuk meninjau bidang yang ditentukan untuk koleksi Anda, gunakan salah satu alat berikut:
- >: Tersedia untuk model proses Inherited.
- Penjelajah Bidang Item Kerja: Tersedia untuk model proses Yang Diwariskan dan XML di Server Lokal.
Untuk deskripsi setiap bidang yang ditentukan dengan proses sistem, lihat Indeks bidang item kerja.
Petunjuk / Saran
Anda dapat menggunakan AI untuk membantu tugas ini nanti dalam artikel ini, atau lihat Mengaktifkan bantuan AI dengan Azure DevOps MCP Server untuk memulai.
Mengapa bidang item kerja itu penting
Bidang item kerja melayani beberapa fungsi penting dalam Azure DevOps:
- Pelacakan data: Menangkap dan menyimpan informasi penting tentang item kerja
- Fungsionalitas kueri: Mengaktifkan kemampuan pencarian dan pemfilteran yang canggih
- Pelaporan: Mendukung analitik dan pembuatan dasbor
- Manajemen alur kerja: Mendorong transisi status dan aturan bisnis
- Integrasi: Terhubung dengan alat dan sistem eksternal
Memahami atribut bidang membantu Anda:
- Mengoptimalkan kueri: Pilih bidang yang tepat untuk pencarian yang efisien
- Rencanakan kustomisasi: Memahami batasan dan kemungkinan
- Memecahkan masalah: Mendiagnosis masalah dengan perilaku lapangan
- Proses desain: Membuat jenis dan alur kerja item kerja yang efektif
Prerequisites
| Category | Requirements |
|---|---|
| Permissions | Untuk melihat bidang yang ditentukan untuk organisasi atau koleksi: Anggota Project Collection Valid Users grup aplikasi atau Lihat informasi tingkat instansi izin diatur ke Izinkan untuk organisasi atau koleksi. |
Mencantumkan atau meninjau kolom
Untuk mencantumkan atau meninjau bidang, gunakan salah satu alat berikut berdasarkan model proses Anda—Inherited, XML yang Dihosting, atau XML Lokal. Untuk indeks bidang yang ditentukan dalam proses default, lihat Indeks bidang item kerja.
| Tool | Inheritance | XML yang dihosting | XML di lokasi |
|---|---|---|---|
| Portal web: Mencantumkan bidang yang diwariskan dan ditentukan khusus | ✔️ | ✔️1 | |
| Penjelajah bidang item kerja | ✔️ | ✔️ | ✔️ |
| alat baris perintah witadmin listfields | ✔️ | ✔️ | ✔️ |
Note
- Hanya didukung untuk proses default (Agile, CMMI, Scrum).
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.
Tiga atribut utama menentukan bidang:
- Jenis data: Menunjukkan jenis data yang bisa Anda masukkan ke 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, 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 tipe item kerja (WIT) dan item kerja, silakan lihat Melacak pekerjaan dengan cerita pengguna, masalah, bug, fitur, dan epos.
Apa itu bidang? Bagaimana fungsi nama bidang?
Setiap jenis item kerja mencakup 31 bidang sistem dan beberapa bidang khusus jenis. Item kerja membantu Anda 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.
Persyaratan penamaan 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 sistem menentukan bidang kustom 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 bidang yang sudah ditentukan
Sistem mendefinisikan bidang item kerja dengan penamaan dan persyaratan struktural tertentu untuk memastikan konsistensi dan fungsionalitas:
- 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 sistem menentukan bidang kustom 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 kustom
Karena sistem menentukan bidang kustom 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 bisa Anda simpan 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 Custom 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?
Anda bisa menampilkan tipe data bidang yang ditentukan untuk organisasi Anda dengan membuka halaman Bidang Proses>.
Saat koleksi proyek Anda menggunakan model proses Pewarisan untuk menyesuaikan pelacakan kerja, Anda dapat melihat tipe data bidang dengan membuka halaman Bidang Proses>.
Jika koleksi proyek Anda menggunakan model proses XML lokal, Anda dapat menentukan jenis data melalui indeks bidang Item kerja. Sebagai alternatif, Anda dapat:
- Buka Penjelajah Bidang Item Kerja untuk meninjau bidang yang ditentukan dan atributnya.
- Gunakan perintah listfields witadmin untuk mencantumkan atribut bidang.
Untuk informasi selengkapnya, lihat Penjelajah Bidang Item Kerja dan Atribut bidang daftar di bagian selanjutnya dari artikel ini.
Tinjau daftar bidang
Untuk meninjau daftar bidang yang ditentukan untuk organisasi atau koleksi, ikuti langkah-langkah berikut:
Pilih logo
Azure DevOps untuk membuka Proyek. Lalu pilih Pengaturan organisasi.
Pilih Proses.
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.
Note
Jika Anda tidak melihat Bidang, maka koleksi Anda menggunakan proses XML lokal. Halaman Fields 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 Kolom 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 saat ini, 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: TFS Process Template Editor. 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: TFS Power Tools.
Atribut lapangan
Banyak atribut yang tidak dapat diubah 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 Pewarisan. Untuk mencari nama referensi untuk bidang, lihat Indeks Bidang Item Kerja.
Attribute
Jenis atribut
Description
REST:
ISTRI: AllowedValues
koleksi
Mendapatkan kumpulan nilai yang valid untuk bidang yang berisi nilai daftar pilihan. Anda dapat mengubah ini dengan menentukan daftar pilihan atau daftar global (di tempat).
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
Integer
Menentukan ID internal bidang.
Dapatkah berubah?=Tidak
REST:
ISTRI: Dapat Diklik
boolean
Menunjukkan apakah sistem menyalin nilai yang ditentukan untuk bidang saat pengguna memilih untuk menyalin item kerja. Misalnya, sistem menyalin bidang Judul, Tag, dan Deskripsi , tetapi tidak menyalin bidang ID dan Riwayat .
Dapatkah berubah?=Tidak
REST:
ISTRI: IsComputed
boolean
Menunjukkan apakah sistem menghitung nilai yang ditetapkan bidang (True) atau tidak (False). Contoh bidang komputasi adalah bidang yang ditetapkan 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 diksi adalah bidang yang ditetapkan sistem, seperti bidang ID, Revisi, Dibuat Oleh, dan Diubah Menurut
Dapatkah berubah?=Tidak
REST: isIdentity
ISTRI: IsIdentity
boolean
Menunjukkan apakah bidang ini adalah bidang Identitas . Bidang identitas adalah bidang string yang digunakan untuk menyimpan identitas pengguna.
Dapatkah berubah?=Tidak
REST:
ISTRI: IsIndexed1
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: isPicklist2 ISTRI:
Boolean
Menunjukkan apakah kolom berasosiasi dengan daftar pilih. Sistem mengatur nilai menjadi True ketika Anda mendefinisikan bidang kustom untuk Azure DevOps dan memilih tipe Daftar Pilihan (String) atau Daftar Pilihan (Bilangan Bulat). Sistem mengatur nilai ke False untuk bidang turunan yang menentukan daftar pilih.
Dapatkah berubah?=Tidak
REST: isPicklistSuggested2 WIFE:
Boolean
Menunjukkan apakah bidang memungkinkan pengguna memasukkan nilai mereka sendiri untuk daftar pilih. Sistem mengatur nilai ke True ketika Anda mendefinisikan bidang kustom untuk Azure DevOps, memilih tipe Daftar Pilihan (String) atau Daftar Pilihan (Integer), dan mencentang kotak untuk Perbolehkan pengguna menetapkan nilai mereka sendiri.
Dapat berubah?=Ya
REST: dapat dikueri
ISTRI: Dapat Dikueri
boolean
Menunjukkan apakah bidang muncul di dalam 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 3
boolean
Menunjukkan apakah atribut yang dapat dilaporkan ditentukan atau diatur ke apa pun selain Tidak Ada. Anda dapat mengubah atribut ini 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 yang ditetapkan untuk bidang. Anda tidak dapat mengubah nama yang mudah diingat untuk Azure DevOps, tetapi Anda dapat mengubahnya untuk lingkungan lokal menggunakan perintah witadmin changefield.
Dapat berubah?=Hanya di lokasi.
REST: picklistId
ISTRI: HelpText
GUID
Jika bidang adalah daftar pilih, pengidentifikasi daftar pilihan terkait, jika tidak, null. Sistem menetapkan nilai GUID yang unik ketika Anda mendefinisikan bidang kustom untuk Azure DevOps dan memilih tipe Daftar Pilihan (String) atau Daftar Pilihan (Integer).
Dapatkah berubah?=Tidak
REST:
WIFE: Nilai yang Dilarang
koleksi
Mendapatkan kumpulan nilai yang dilarang untuk bidang yang menentukan nilai tersebut. Anda hanya dapat menentukan nilai yang dilarang untuk penyebaran lokal.
Dapat berubah?=Hanya di lokasi.
REST: readOnly
WIFE:
Boolean
Menunjukkan apakah bidang diatur untuk dibaca saja. Untuk Layanan Azure DevOps, hanya bidang kustom yang dapat diubah menjadi hanya-baca. Bidang sistem tidak dapat dimodifikasi.
Dapat berubah?=Ya
REST: referenceName
ISTRI: ReferenceName
string
Menentukan nama referensi bidang.
Dapatkah berubah?=Tidak
REST:
WIFE: ReportingAttributes3
Menentukan Detail, Dimensi, atau Ukuran, tergantung pada apakah dan bagaimana Anda ingin bidang disertakan dalam laporan. Sistem mengekspor data dari bidang yang memiliki nilai selain Tidak Ada untuk atribut ini ke gudang data dan dapat menyertakannya dalam laporan SQL.
Dapat berubah?=Hanya di lokasi.
REST:
ISTRI: ReportingName3
string
Menentukan label untuk bidang saat data muncul di laporan SQL. Jika Anda tidak menentukan nilai, sistem menggunakan nama ramah bidang.
Dapat berubah?=Hanya di lokasi.
REST:
ISTRI: ReportingReferenceName3
string
Menentukan nama referensi yang berbeda ke bidang yang digunakan sistem saat mengekspor data ke gudang data relasional. Jika Anda tidak menentukan nilai, sistem akan menggunakan nama referensi bidang.
Dapat berubah?=Hanya di lokasi.
REST: supportedOperations (operasi yang didukung)
WIFE:
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: tipe
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 Get Fields, FieldUsage.
Dapatkah berubah?=Tidak
Note
- 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.
- Sistem menetapkan atribut isPicklist dan isPicklistSuggested hanya untuk bidang kustom yang ditentukan untuk proses yang diwariskan. Model proses yang diwariskan mendukung Azure DevOps Server 2020 dan versi yang lebih baru. Untuk informasi selengkapnya, lihat Model proses yang diwariskan.
- Semua atribut pelaporan hanya valid untuk penyebaran lokal yang proyeknya telah dikonfigurasi untuk mendukung SQL Server Reporting Services dan SQL Server Analysis Services.
Mencantumkan atribut bidang
Anda dapat mencantumkan atribut yang ditetapkan ke bidang dengan menggunakan Fields - Get REST API. Ganti OrganizationName dengan nama organisasi Anda yang sebenarnya.
https://dev.azure.com/OrganizationName/_apis/wit/fields/FieldReferenceName
Misalnya, untuk mencantumkan atribut untuk Jalur Perulangan, gunakan referensi nama 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"
}
Anda dapat mencantumkan atribut yang ditetapkan ke bidang dengan menggunakan Fields - Get REST API. Masukkan nama organisasi Anda untuk OrganizationName. Untuk mulai menggunakan REST, lihat Referensi REST API Azure DevOps Services
https://{ServerName:Port}/tfs/{Collection}/_apis/wit/fields/FieldReferenceName?api-version={version}
Misalnya, di sini kita mencantumkan atribut untuk Jalur Perulangan, menentukan nama referensi, System.IterationPath, untuk server fabrikam.
https://fabrikam:8080/tfs/DefaultCollection/_apis/wit/fields/System.IterationPath?api-version=4.1
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://fabrikam:8080/tfs/DefaultCollection/_apis/wit/fields/System.IterationPath?api-version=4.1"
}
Mencantumkan atribut menggunakan witadmin alat baris perintah
Anda dapat mencantumkan atribut bidang tertentu—seperti jenis data, atribut yang dapat dilaporkan, dan pengindeksan—menggunakan perintah bidang daftar witadmin.
Misalnya, Anda dapat memasukkan perintah berikut untuk mencantumkan atribut yang ditentukan untuk bidang tertentu, seperti Microsoft.VSTS.Common.Issue.
witadmin listfields /collection:http://fabrikam:8080/tfs/DefaultCollection /n:Microsoft.VSTS.Common.Issue
Informasi bidang dan atribut muncul untuk bidang bernama, seperti yang ditunjukkan dalam contoh ini.
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
Parameter Gunakan menunjukkan nama setiap proyek dan jenis item kerja tempat bidang digunakan.
Praktik terbaik untuk bekerja dengan bidang
Pertimbangkan rekomendasi ini saat bekerja dengan bidang item kerja:
Pemilihan dan desain bidang
- Pilih nama yang bermakna: Gunakan nama bidang deskriptif yang dengan jelas menunjukkan tujuannya
- Menstandarkan penamaan: Menetapkan konvensi penamaan yang konsisten di seluruh organisasi Anda
- Batasi bidang kustom: Tambahkan bidang kustom secara bijaksana untuk menghindari pengguna merasa kewalahan
- Pertimbangkan jenis data: Pilih jenis data yang sesuai untuk informasi yang Anda simpan
Pengoptimalan performa
- Menggunakan bidang terindeks: Untuk penyebaran lokal, pertimbangkan untuk mengindeks bidang kustom yang sering dikueri
- Hindari kueri berat: Perhatikan performa kueri saat menggunakan banyak filter bidang
- Mengoptimalkan daftar pilih: Menjaga nilai daftar pilih tetap dapat dikelola dalam ukuran dan terorganisir dengan baik
Pemeliharaan dan tata kelola
- Penggunaan bidang dokumen: Pertahankan dokumentasi yang menjelaskan tujuan dan penggunaan bidang kustom
- Tinjau secara berkala: Meninjau bidang kustom secara berkala untuk mengidentifikasi bidang yang tidak digunakan atau berlebihan
- Rencanakan perubahan: Pertimbangkan dampak perubahan bidang pada item dan kueri kerja yang sudah ada
- Modifikasi pengujian: Selalu uji perubahan bidang di lingkungan pengembangan terlebih dahulu
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.
Anda dapat menambahkan atau mengubah bidang yang terkandung dalam WIT atau menambahkan WIT kustom. Untuk informasi selengkapnya, lihat:
- Untuk koleksi proyek yang menggunakan model proses Pewarisan: Kustomisasi Proses Pewarisan.
- Untuk koleksi proyek yang menggunakan model proses XML lokal: Sesuaikan model proses XML lokal.
Anda dapat mengubah nama bidang, indeks, dan atribut laporan untuk bidang apa pun kecuali bidang sistem dengan menggunakan alat baris perintah witadmin . Untuk informasi selengkapnya, lihat Mengelola bidang item kerja-witadmin.
Pemecahan masalah bidang
Masalah umum dan solusi saat bekerja dengan bidang item kerja:
Masalah visibilitas bidang
- Bidang tidak muncul: Periksa apakah bidang ditambahkan ke tata letak tipe item kerja
- Masalah izin: Verifikasi bahwa Anda memiliki izin yang sesuai untuk menampilkan atau mengedit bidang
- Perbedaan proses: Pastikan bidang ada dalam proses saat ini
Masalah kueri dan pencarian
-
Bidang tidak dapat dikueri
IsQueryable: Periksa atribut untuk bidang - Masalah performa: Pertimbangkan untuk mengindeks bidang kustom yang sering dikueri (lokal)
- Batasan operator: Memverifikasi operator mana yang didukung untuk jenis data bidang
Entri dan validasi data
- Nilai tidak valid: Periksa apakah bidang telah membatasi nilai yang diizinkan atau aturan validasi
-
Bidang baca-saja: Memverifikasi atribut bidang
IsEditable - Persyaratan format: Pastikan data cocok dengan jenis data bidang yang diharapkan
Menggunakan AI untuk menjelajahi bidang item kerja
Jika Anda mengonfigurasi Azure DevOps MCP Server, Anda dapat menjelajahi dan mengkueri bidang item kerja menggunakan bahasa alami.
| Tugas | Contoh perintah |
|---|---|
| Mencantumkan bidang untuk tipe item kerja | Show me all fields available for the Bug work item type in project <Contoso> |
| Temukan kolom khusus | List all custom fields defined in my organization |
| Periksa penggunaan bidang | Which work item types use the "Story Points" field in project <Contoso>? |
| Kueri menurut nilai bidang | Show all user stories where Story Points is greater than 8 in <Contoso> |
| Menemukan bidang kosong yang diperlukan | List all active work items in project <Contoso> where the Priority field is empty |
| Membandingkan nilai field antar jenis | Show which fields are shared between Bug and User Story work item types in project <Contoso> |
| Konsistensi bidang audit | Find all work items in <Contoso> where the Remaining Work field is set but the Original Estimate is blank |
| Menjelajahi nilai daftar pilih | What are the allowed values for the Severity field on the Bug work item type in project <Contoso>? |
| Menemukan bidang yang jarang digunakan | Which custom fields in project <Contoso> have values set on fewer than 10 work items? |
| Mengidentifikasi masalah data lapangan | Show work items in <Contoso> where the Closed Date is set but the state is not Done or Closed |
Note
Jika Anda menggunakan Visual Studio Code, mode agent sangat membantu untuk menjelajahi definisi dan atribut bidang.
Konten terkait
- Referensi cepat kueri untuk memahami sintaks dan penggunaan kueri dengan cepat.
- Indeks bidang item kerja untuk menampilkan semua bidang item kerja yang tersedia.
- Tambahkan dan kelola bidang untuk proses yang diwariskan untuk menyesuaikan bidang sesuai dengan persyaratan proses yang Anda warisi.
- Referensi Metadata untuk Azure Boards Analytics guna memahami metadata analitik dan kapabilitas pelaporan.
- Referensi cepat kueri untuk memahami sintaks dan penggunaan kueri dengan cepat.
- Indeks bidang item kerja untuk menampilkan semua bidang item kerja yang tersedia.
- Pilih model proses untuk koleksi proyek Anda untuk memilih model proses yang sesuai untuk kebutuhan Anda.
- Ubah bidang item kerja sesuai dengan persyaratan proyek Anda.
- Kelola bidang item kerja menggunakan witadmin untuk melakukan tugas manajemen bidang tingkat lanjut.
- Untuk memahami metadata analitik dan kemampuan pelaporan, lihat referensi Metadata untuk Azure Boards Analytics.