Mengelola bidang item kerja

Layanan Azure DevOps | Azure DevOps Server | Azure DevOps Server 2022

Penting

Untuk model proses XML lokal, Anda dapat menggunakan witadmin untuk mencantumkan, mengimpor, mengekspor, dan memodifikasi proses untuk proyek. Untuk model proses XML yang Diwariskan dan Dihosting, Anda hanya dapat menggunakan witadmin untuk mencantumkan dan mengekspor informasi proses. Untuk gambaran umum model proses dan apa yang didukung, lihat Menyesuaikan pengalaman pelacakan kerja Anda.

Alat baris perintah witadmin menyediakan kemampuan canggih untuk mengelola bidang item kerja dalam koleksi proyek Anda. Baik Anda perlu mengganti nama bidang, menyesuaikan jenis data, atau mengonfigurasi sinkronisasi dengan penyedia identitas, perintah ini memberi Anda kontrol terperinci atas pengalaman pelacakan kerja Anda.

Apa yang dapat Anda lakukan dengan perintah bidang witadmin

Gunakan perintah witadmin berikut untuk mengelola bidang di semua jenis item kerja dan proyek dalam koleksi Anda:

changefield: Ubah atribut bidang yang menerapkan koleksi di seluruh, termasuk:
- Konversi jenis data antara PlainText dan HTML format
Penting

Saat Anda meningkatkan Azure DevOps Server, bidang Deskripsi (System.Description) secara otomatis dikonversi dari PlainText ke HTML. changefield Gunakan perintah untuk mengembalikan ini jika diperlukan.
- Nama yang mudah diingat ditampilkan dalam kueri item kerja (mungkin berbeda dari label formulir)
- Atribut pelaporan untuk integrasi gudang data
- Sinkronisasi identitas dengan ID Microsoft Entra atau Direktori Aktif
deletefield: Hapus bidang yang tidak digunakan dari koleksi Anda
listfields: Melihat atribut bidang dan penggunaan di seluruh proyek

Tip

Untuk menambahkan bidang global di lingkungan XML lokal, ubah file alur kerja global dan impor ke koleksi Anda.
Perintah witadmin indexfield tidak digunakan lagi. Pengindeksan bidang terjadi secara otomatis.

Jalankan `witadmin` alat baris perintah

Untuk menjalankan witadmin alat baris perintah, buka jendela Prompt Perintah tempat Visual Studio diinstal. Alat witadmin baris perintah diinstal dengan versi Visual Studio apa pun. Anda dapat mengakses alat ini dengan menginstal versi gratis Komunitas Visual Studio atau Visual Studio Team Explorer.

Catatan

Untuk menyambungkan ke Layanan Azure DevOps, kami sarankan Anda menggunakan versi terbaru Visual Studio atau Komunitas Visual Studio.

Catatan

Untuk menyambungkan ke server lokal, kami sarankan Anda menggunakan versi Visual Studio yang sama atau yang lebih baru dengan Server Azure DevOps Anda. Misalnya, jika Anda tersambung ke Azure DevOps Server 2019, sambungkan ke proyek Anda dari versi Visual Studio 2019.

Untuk Visual Studio 2022

%programfiles(x86)%\Microsoft Visual Studio\2022\Community\Common7\IDE\CommonExtensions\Microsoft\TeamFoundation\Team Explorer

atau Professional sebagai Enterprise ganti Community, tergantung pada versi yang Anda instal.

Untuk Visual Studio 2019

%programfiles(x86)%\Microsoft Visual Studio\2019\Community\Common7\IDE\CommonExtensions\Microsoft\TeamFoundation\Team Explorer

atau Professional sebagai Enterprise ganti Community, tergantung pada versi yang Anda instal.

Untuk Visual Studio 2017

%programfiles(x86)%\Microsoft Visual Studio\2017\Enterprise\Common7\IDE\CommonExtensions\Microsoft\TeamFoundation\Team Explorer

atau TeamExplorer sebagai Professional ganti Enterprise, tergantung pada versi yang Anda instal.

Pada edisi 32-bit Windows, ganti %programfiles(x86)% dengan %programfiles%. Anda dapat menginstal Komunitas Visual Studio (yang menyediakan akses ke Team Explorer) atau Visual Studio Team Explorer 2017 secara gratis.

Untuk gambaran umum bidang yang ditentukan dalam templat proses default, lihat Indeks bidang item kerja.

Tip

Dengan witadmin, Anda dapat mengimpor dan mengekspor file definisi. Alat lain yang dapat Anda gunakan termasuk Editor Proses (mengharuskan Anda telah menginstal versi Visual Studio). Instal editor Templat Proses dari Visual Studio Marketplace.

Prasyarat

Tugas	Izin yang Diperlukan
Daftar bidang	Lihat izin informasi tingkat proyek yang diatur ke Izinkan untuk proyek dalam koleksi
Menghapus atau mengganti nama bidang	Anggota grup keamanan Administrator Koleksi Proyek
Mengubah atribut bidang	Anggota grup keamanan Administrator Koleksi Proyek

Untuk informasi lebih lanjut, lihat Mengubah izin tingkat pengumpulan proyek.

Catatan

Bahkan jika Anda masuk dengan izin administratif, Anda harus membuka jendela Prompt Perintah yang ditingkatkan untuk melakukan fungsi ini pada server yang menjalankan Windows Server. Untuk membuka jendela Prompt Perintah yang ditinggikan, pilih Mulai, buka menu pintasan Perintah, lalu pilih Jalankan sebagai Administrator.

Sintaks

Gunakan pola sintaks perintah berikut untuk mengelola bidang item kerja dengan alat witadmin:

witadmin changefield /collection:CollectionURL /n:RefName   [/name:NewName]    [/syncnamechanges:true | false]   [/reportingname:ReportingName]    [/reportingrefname:ReportingRefName]   [/reportingtype:Type]   [/reportingformula:Formula]   [/type:PlainText | HTML]   [/noprompt]  

witadmin deletefield /collection:CollectionURL /n:RefName [/noprompt]  
  
witadmin listfields /collection:CollectionURL /n:RefName [/unused]

Parameter

Parameter	Keterangan
`/collection`:`CollectionURL`	Menentukan nama kumpulan proyek. Contohnya: Format lokal:`http://ServerName:Port/VirtualDirectoryName/CollectionName` Jika tidak ada direktori virtual yang digunakan, maka gunakan format berikut: `http://ServerName:Port/CollectionName`.
`/n:RefName` `/n:Name`	Nama referensi bidang jenis item kerja.
`/name:NewName`	Menentukan nama baru untuk bidang tersebut.
`/syncnamechanges`	Menentukan untuk menggunakan bidang item kerja untuk menyimpan nama dan untuk memperbarui saat perubahan dilakukan di ID Microsoft Entra, Direktori Aktif, atau grup kerja. Opsi ini hanya valid ketika bidang dengan jenis data String ditentukan untuk `typename`. Tentukan `true` untuk mengaktifkan sinkronisasi untuk bidang data. Tentukan `false` untuk menonaktifkan sinkronisasi untuk bidang data.
`/reportingname:ReportingName`	Menentukan nama bidang di gudang data yang akan digunakan untuk pelaporan.
`/reportingrefname:ReportingRefName`	Menentukan nama referensi bidang di gudang data yang akan digunakan untuk pelaporan.
`/reportingtype:Type`	Menentukan bagaimana bidang digunakan di gudang untuk pelaporan. Nilai berikut ini valid: - `dimension:` Digunakan untuk bidang Bilangan Bulat, String, atau DateTime. - `detail:` Digunakan untuk bidang Bilangan Bulat, Ganda, String, atau DateTime. - `measure:` Digunakan untuk bidang Bilangan Bulat dan Ganda. Jenis agregasi default adalah jumlah. Anda dapat menentukan jenis agregasi lain dengan menggunakan parameter rumus . - `none:` Digunakan untuk menonaktifkan keterlaporan pada bidang . Untuk informasi selengkapnya, lihat Tentang bidang dan atribut item kerja.
`/reportingformula:Formula`	Menentukan rumus agregasi yang akan digunakan saat bidang dilaporkan sebagai `measure`. Satu-satunya rumus yang didukung adalah `sum`.
`/type:HTML` \| `PlainText`	Menentukan untuk mengonversi konten bidang dari `PlainText` ke `HTML` atau dari `HTML` ke `PlainText`. Anda dapat menentukan opsi ini hanya untuk bidang yang jenis penugasannya adalah `PlainText` atau `HTML`. Lihat referensi elemen FIELD (Definisi).
`/unused`	Mencantumkan semua bidang yang tidak digunakan oleh proyek apa pun yang ditentukan dalam kumpulan proyek.
`/noprompt`	Menonaktifkan permintaan konfirmasi.
`/?` atau `help`	Menampilkan bantuan terkait perintah di jendela Perintah.

Menyinkronkan nama orang dengan ID Microsoft Entra dan Direktori Aktif

Konfigurasikan bidang nama orang kustom untuk diperbarui secara otomatis saat nama pengguna berubah di idP Anda.

Kapan mengaktifkan sinkronisasi

Bidang kustom saja: Anda harus mengaktifkan sinkronisasi secara manual untuk bidang item kerja kustom apa pun yang digunakan untuk menetapkan nama orang.

Bidang sistem: Semua bidang nama orang bawaan secara otomatis mengaktifkan sinkronisasi:

System.AssignedTo
System.ChangedBy
System.CreatedBy

Dukungan Penyedia Identitas

Lingkungan	Penyedia Identitas
Layanan Azure DevOps	Microsoft Entra ID
Azure DevOps Server	Direktori Aktif atau grup kerja

Cara kerja sinkronisasi

Negara	Perilaku
Sebelum mengaktifkan	Bidang memperlihatkan string teks statis
Setelah mengaktifkan	Bidang menampilkan nama pengguna saat ini dari penyedia identitas
Ketika nama berubah	Bidang dengan `syncnamechanges=true` pembaruan otomatis

Pembatasan nama grup

Saat Anda mengaktifkan syncnamechanges atribut pada bidang String, atribut menerima nama pengguna yang valid tetapi tidak mengizinkan nama grup jika salah satu kondisi ini berlaku:

VALIDUSER aturan yang ditentukan di semua jenis item kerja
VALIDUSER aturan yang ditentukan untuk jenis item kerja tertentu
ALLOWEDVALUES aturan yang ditentukan dengan kriteria filter yang mengecualikan grup

Cakupan konfigurasi

Penting

Anda harus mengaktifkan sinkronisasi untuk setiap bidang di setiap koleksi proyek yang berisi bidang kustom.

Untuk informasi selengkapnya, lihat:

Atribut yang dapat Anda ubah untuk setiap jenis item kerja

Anda mengubah atribut atau nilai berikut yang ditentukan untuk bidang dengan mengubah definisi jenis item kerja tempat bidang muncul:

Nama yang ditampilkan pada formulir item kerja. Lihat Elemen WebLayout dan Control atau Referensi elemen Control XML.
Teks bantuan. Lihat Evaluasi aturan dan aturan.
Nilai atau item yang diizinkan dalam daftar pilih atau menu drop-down. Lihat ELEMEN ALLOWEDVALUES, SUGGESTEDVALUES, dan PROHIBITEDVALUES XML.

Contoh

Kecuali ditentukan lain, nilai berikut berlaku dalam setiap contoh:

URI untuk koleksi proyek: http://AdventureWorksServer:8080/tfs/DefaultCollection
Nama bidang item kerja: AdventureWorks.Field
Pengodean default: UTF-8

Bidang daftar

Gunakan witadmin listfields untuk melihat kumpulan bidang yang digunakan, untuk memilih bidang yang akan ditambahkan ke jenis item kerja. Selain itu, Anda dapat mencantumkan penetapan atribut yang ditentukan untuk bidang tertentu dan menentukan bidang mana yang digunakan oleh proyek mana.

Menampilkan atribut bidang item kerja

Masukkan perintah berikut untuk mencantumkan atribut yang ditentukan untuk bidang tertentu, seperti Microsoft.VSTS.Common.Issue.

witadmin listfields /collection:http://AdventureWorksServer: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. Untuk informasi selengkapnya tentang atribut bidang, lihat Indeks bidang item kerja.

Mencantumkan semua bidang dalam kumpulan proyek

Masukkan perintah berikut untuk mencantumkan semua bidang yang ditentukan untuk kumpulan proyek.

witadmin listfields /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection

Informasi bidang untuk semua bidang untuk kumpulan proyek bernama muncul. Lihat Indeks bidang item kerja.

Mencantumkan bidang yang tidak digunakan

Masukkan perintah berikut untuk mencantumkan bidang yang tidak lagi digunakan dalam kumpulan proyek oleh jenis item kerja apa pun.

witadmin listfields /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /unused

Informasi bidang dan atribut muncul untuk setiap bidang yang tidak digunakan, seperti yang ditunjukkan dalam contoh ini.

    Field: Microsoft.VSTS.CMMI.TaskType  
    Name: Task Type  
    Type: String  
    Reportable As: dimension  
    Use: Not In Use  
    Indexed: False  

    Field: Microsoft.VSTSUE.Common.Flag  
    Name: Flag  
    Type: String  
    Reportable As: dimension  
    Use: Not In Use  
    Indexed: False  

    Field: Microsoft.VSTSUE.Common.Progress  
    Name: Progress  
    Type: String  
    Reportable As: dimension  
    Use: Not In Use  
    Indexed: False

Mengganti nama bidang

Anda dapat mengubah nama bidang item kerja yang mudah diingat untuk memenuhi konvensi penamaan yang digunakan tim Anda. Nama baru diterapkan ke semua jenis item kerja yang mereferensikan bidang yang diubah di semua proyek dalam koleksi proyek. Nama yang mudah diingat ditampilkan saat Anda menentukan kriteria filter dalam kueri item kerja. Nama yang muncul pada formulir item kerja mungkin berbeda dari nama yang mudah didefinisikan untuk bidang tersebut.

Untuk mengganti nama bidang item kerja

Masukkan perintah berikut untuk mengganti nama yang mudah diingat yang ditetapkan ke Microsoft.VSTS.Common.RankPeringkat Penting.

witadmin changefield /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:Microsoft.VSTS.Common.Rank /name:"Important Rank"

Pada perintah konfirmasi, masukkan y lalu pilih ENTER. Tunggu hingga Anda menerima pesan berikut:

Bidang diganti namanya.

Untuk memverifikasi perubahan yang diimpor ke satu proyek

Di Team Explorer, pilih Refresh.

Pembaruan terbaru diunduh dari server, yang mencakup perubahan yang baru saja Anda buat pada nama bidang. Tunggu beberapa detik hingga refresh selesai.
Pilih Kueri Baru untuk membuat kueri.
Di Editor Kueri, pilih tautan Klik di sini untuk menambahkan klausa untuk menambahkan baris, pilih sel Bidang kosong, dan di sel, masukkan Rank. Pesan berikut yang muncul di atas daftar hasil. Pesan ini menunjukkan bahwa Peringkat tidak dapat ditemukan.

Jalankan kueri untuk melihat hasil kueri. TF51005: Kueri mereferensikan bidang yang tidak ada. Kesalahan disebabkan oleh <\<Rank>>.
Hapus nilai Peringkat dari sel Bidang , dan masukkan Important Rank ke dalam sel.
Pilih <> di sel Operator , dan masukkan 1 ke dalam sel Nilai .
Pada toolbar Kueri, pilih Jalankan.
Buka menu pintasan untuk baris apa pun dalam hasil dan pilih Opsi Kolom. Gulir ke bawah di daftar Kolom yang tersedia . Perhatikan bahwa bidang Peringkat tidak ada lagi tetapi bidang Peringkat Penting ada.
Pilih Peringkat Penting dalam kotak Kolom yang tersedia, lalu pilih tombol > (tambahkan kolom yang dipilih). Pilih OK.

Perhatikan bahwa nama yang mudah diingat untuk Microsoft.VSTS.Common. Peringkat diganti namanya dari Peringkat ke Peringkat Penting di seluruh penyusun kueri dan daftar hasil.
Tutup kueri. Pilih Tidak saat Anda diminta untuk menyimpan kueri.
Buat item kerja Tugas baru. Pilih tautan Item Kerja Baru, lalu pilih Tugas.

Item kerja ini dibuat dari tipe item kerja yang Anda ubah dan impor.
Perhatikan, dalam kotak Status , bahwa label untuk bidang yang diganti namanya Peringkat tidak berubah. Label bidang pada formulir item kerja dilingkupkan ke proyek induk dan independen dari nama bidang di seluruh server yang ditentukan.

Catatan

Untuk informasi selengkapnya tentang cara mengubah label bidang pada formulir item kerja, lihat Referensi elemen Control XML.
Tutup Tugas baru dan pilih Tidak saat Anda diminta untuk menyimpan item kerja.

Mengubah laporan sebagai nilai untuk bidang

Perintah berikut menentukan kemampuan untuk melaporkan jenis bidang DateTime AdventureWorks.CreatedOn ke dimensi. Data bidang ini memasuki database Gudang dan Analysis Services sehingga dapat digunakan untuk memfilter laporan.

witadmin changefield /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:AdventureWorks.CreatedOn /reportingtype:dimension

Perintah berikut menentukan kemampuan untuk melaporkan jenis bidang Ganda AdventureWorks.Field untuk diukur. Semua tindakan dikumpulkan berdasarkan jumlah.

witadmin reportfield /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:AdventureWorks.Field /reportingtype:measure

Mengaktifkan sinkronisasi bidang nama orang kustom

Perintah berikut memungkinkan sinkronisasi untuk bidang item kerja AW. CustomerName didefinisikan untuk Collection1 di AdventureWorksServer.

Verifikasi tipe data bidang yang ingin Anda konversi

Verifikasi jenis data yang ditetapkan ke bidang , seperti MyCompany.CustomerName, yang ingin Anda sinkronkan dengan memasukkan perintah berikut:

witadmin listfields /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:MyCompany.CustomerName

Aktifkan sinkronisasi

Untuk mengaktifkan sinkronisasi untuk bidang bernama orang, ketik perintah berikut, ganti data Anda untuk argumen yang diperlihatkan di sini:

witadmin changefield /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:MyCompany.CustomerName /syncnamechanges:true

Perintah konfirmasi berikut muncul:

Ini akan mengubah properti untuk bidang {0} di Azure DevOps Server. Apakah Anda ingin melanjutkan?
Masukkan 0 untuk mengonfirmasi bahwa Anda ingin mengubah bidang, atau 1 membatalkan permintaan.

Jika permintaan perubahan berhasil, pesan konfirmasi berikut muncul:

Bidang telah diperbarui.

Jika permintaan perubahan gagal, pesan kesalahan akan muncul. Kesalahan paling umum yang dapat dilakukan adalah mencoba mengubah bidang referensi sistem, atau mencoba mengubah bidang jenis data selain String. Operasi ini tidak didukung.

Menghapus bidang

Sebelum Anda menghapus bidang, verifikasi bahwa bidang tidak digunakan. Jika bidang sedang digunakan, Anda harus terlebih dahulu menghapus bidang dari jenis item kerja yang menggunakannya sebelum menghapusnya dari kumpulan proyek. Perintah berikut menghapus bidang AdventureWorks.Field dari Collection1:

witadmin deletefield /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:AdventureWorks.Field

Memverifikasi bahwa bidang tidak digunakan

Masukkan perintah berikut, menentukan nama referensi untuk bidang item kerja, seperti MyCompany.MyProcess.MyField.
```
witadmin listfields /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:MyCompany.MyProcess.MyField  
```
Dalam informasi yang ditampilkan untuk bidang , verifikasi bahwa nilai untuk Penggunaan adalah "Tidak Digunakan" sebagai berikut dalam contoh ini.
```
Field: MyCompany.MyProcess.MyField  
Name: MyField  
Type: String  
Reportable As: dimension  
Use: Not In Use  
Indexed: False  
```
Jika bidang Gunakan menunjukkan bahwa bidang sedang digunakan, maka Anda harus menghapusnya dari setiap jenis item kerja untuk setiap proyek yang tercantum. Misalnya, Microsoft.VSTS.TCM.SystemInfo bidang menunjukkan bahwa bidang sedang digunakan oleh jenis item kerja Bug dan Cacat Kode untuk empat proyek: Arroyo, Desert, Palm, dan Springs.
```
Field: Microsoft.VSTS.TCM.SystemInfo  
Name: System Info  
Type: Html  
Reportable As: None  
Use: Arroyo (Bug), Desert (Bug), Palm (Bug), Springs (Bug, Code Defect)  
Indexed: False  
```
Sebelum dapat menghapus bidang ini, Anda harus menghapusnya dari setiap jenis item kerja yang tercantum untuk setiap proyek yang ditentukan. Untuk menghapus bidang, Anda mengubah definisi untuk jenis item kerja dengan menghapus FIELD elemen dan Control yang berisi nama referensi bidang. Lihat Mengimpor, mengekspor, dan mengelola jenis item kerja, referensi elemen FIELD (Definisi), dan Kontrol.

Menghapus bidang dari kumpulan proyek

Masukkan perintah berikut untuk menghapus MyCompany.MyProcess.MyField bidang, lalu pilih Enter.

witadmin deletefield /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:RefName

Masukkan y di prompt konfirmasi untuk menyelesaikan langkah ini.

Saran dan Komentar

Apakah halaman ini membantu?

Last updated on 2025-12-17

Bagikan melalui

Mengelola bidang item kerja

Apa yang dapat Anda lakukan dengan perintah bidang witadmin

Jalankan witadmin alat baris perintah

Prasyarat

Sintaks

Parameter

Menyinkronkan nama orang dengan ID Microsoft Entra dan Direktori Aktif

Kapan mengaktifkan sinkronisasi

Dukungan Penyedia Identitas

Cara kerja sinkronisasi

Pembatasan nama grup

Cakupan konfigurasi

Atribut yang dapat Anda ubah untuk setiap jenis item kerja

Contoh

Bidang daftar

Menampilkan atribut bidang item kerja

Mencantumkan semua bidang dalam kumpulan proyek

Mencantumkan bidang yang tidak digunakan

Mengganti nama bidang

Untuk mengganti nama bidang item kerja

Untuk memverifikasi perubahan yang diimpor ke satu proyek

Mengubah laporan sebagai nilai untuk bidang

Mengaktifkan sinkronisasi bidang nama orang kustom

Verifikasi tipe data bidang yang ingin Anda konversi

Aktifkan sinkronisasi

Menghapus bidang

Memverifikasi bahwa bidang tidak digunakan

Menghapus bidang dari kumpulan proyek

Artikel terkait

Saran dan Komentar

Sumber Daya Tambahan:

Jalankan `witadmin` alat baris perintah