Mencantumkan bidang dan atribut item kerja

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:

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

  1. 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>.

Cuplikan layar halaman Pengaturan, Proses, Bidang Organisasi.

Saat koleksi proyek Anda menggunakan model proses Pewarisan untuk menyesuaikan pelacakan kerja, Anda dapat melihat tipe data bidang dengan membuka halaman Bidang Proses>.

Cuplikan layar halaman Pengaturan Koleksi, Proses, Bidang.

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:

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

    Cuplikan layar Pilih pengaturan Organisasi.

  2. Pilih Proses.

    Cuplikan layar 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.

    Cuplikan layar Buat salinan proses yang diwariskan yang dipilih.

    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.

Cuplikan layar 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

  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. 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.
  3. 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:

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 dikueriIsQueryable: 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.