Bagikan melalui

witAdmin: Menyesuaikan dan mengelola objek untuk pekerjaan pelacakan

  • Artikel

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

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.

Anda dapat mengubah cara melacak kemajuan tim dengan membuat dan menyesuaikan objek yang melacak item kerja. Dengan menggunakan alat baris perintah witadmin , Anda dapat membuat, menghapus, mengimpor, dan mengekspor objek seperti kategori, daftar global, alur kerja global, jenis tautan, dan jenis item kerja. Anda juga dapat menghapus, mencantumkan, atau mengubah atribut bidang item kerja.

Selain itu, untuk Server Azure DevOps lokal, Anda dapat mengelola jenis resolusi, bug, dan jenis kegagalan yang digunakan dengan manajemen kasus pengujian dengan perintah fieldmapping tcm.

Seperti yang ditunjukkan oleh ilustrasi berikut, Anda mengelola kategori dan jenis item kerja untuk setiap proyek. Anda mengelola daftar global, jenis tautan, dan bidang dalam item kerja untuk setiap koleksi proyek. Anda dapat menyesuaikan alur kerja global untuk proyek atau koleksi.

Gambar konseptual Objek Pelacakan Item Kerja.

Untuk sebagian besar perintah, Anda harus menjadi anggota grup Administrator Proyek atau Administrator Koleksi Proyek. Untuk informasi selengkapnya, lihat Mengubah izin tingkat pengumpulan proyek.

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.

Parameter global

Anda dapat menggunakan parameter berikut untuk menampilkan teks bantuan untuk witadmin.

Parameter Deskripsi
/? atau help Menampilkan sintaks dan parameter untuk witadmin alat baris perintah.
command /help
or
command /?		 Menampilkan sintaks dan parameter untuk witadmin perintah yang Anda tentukan.

File definisi XML

Anda menyesuaikan semua objek pelacakan kerja—seperti, jenis item kerja, konfigurasi proses, daftar global—dengan memperbarui definisi XML mereka. Jika Anda baru menggunakan kustomisasi pelacakan kerja, lihat Menyesuaikan pengalaman pelacakan kerja Anda.

Anda menjalankan perintah witadmin terhadap Azure DevOps Services atau Azure DevOps Server lokal. Seperti yang ditunjukkan dalam daftar perintah berikut, hanya perintah witadmin yang mencantumkan atau mengekspor file yang didukung untuk Layanan Azure DevOps.

Jenis item kerja

Item kerja digunakan untuk melacak apa pun yang perlu Anda lacak. Setiap item kerja didasarkan pada jenis item kerja. Setiap jenis item kerja menentukan bidang yang tersedia untuk menyimpan informasi. Jenis item kerja yang tersedia bergantung pada proses yang Anda gunakan saat proyek Anda dibuat (Agile, Scrum, Basic, atau CMMI). Untuk informasi selengkapnya, lihat Melacak item kerja Anda di cerita, masalah, bug, fitur, dan epik pengguna Azure Boards.

Untuk model proses yang diwariskan, Anda dapat menambahkan dan menghapus jenis item kerja dari portal web. Untuk informasi selengkapnya, lihat Menambahkan dan mengelola jenis item kerja (Proses warisan).

Perintah

Azure DevOps

Azure DevOps Server

destroywitd: Menghapus jenis item kerja

✔️

exportwitd: Mengekspor file jenis item kerja

✔️

✔️

importwitd: Mengimpor file jenis item kerja

✔️

listwitd: Mencantumkan jenis item kerja

✔️

✔️

renamewitd: Mengubah nama tampilan untuk jenis item kerja

✔️

Bidang

Bidang digunakan untuk melacak status dan informasi yang terkait dengan item kerja. Bidang ditentukan untuk organisasi atau koleksi. Untuk informasi selengkapnya, lihat Bidang dan atribut item kerja. Untuk mencari deskripsi bidang tertentu, lihat Deskripsi bidang untuk bidang item default dan pekerjaan yang digunakan dalam templat proses.

Untuk model proses yang diwariskan, Anda dapat melihat dan menghapus bidang dari portal web. Untuk informasi selengkapnya, lihat Menambahkan dan mengelola bidang (Proses warisan).

Perintah

Azure DevOps

Azure DevOps Server

deletefield: Menghapus bidang

✔️

listfields: Mencantumkan atribut bidang

✔️

✔️

changefield: Mengubah atribut bidang

✔️

renamewitd: Mengubah nama tampilan WIT

✔️

Kategori

Kategori mengaitkan satu atau beberapa jenis item kerja sebagai milik kategori yang sama. Azure Boards bergantung pada definisi kategori default, banyak di antaranya menentukan satu jenis item kerja per kategori. Untuk informasi selengkapnya, lihat Menggunakan kategori untuk mengelompokkan jenis item kerja.

Perintah

Azure DevOps

Azure DevOps Server

exportcategories: Mengekspor file Kategori

✔️

✔️

importcategories: Impor file Kategori

✔️

Gunakan jenis tautan yang berbeda untuk mengelola berbagai hubungan antara item kerja. Untuk model proses XML lokal dan XML yang Dihosting, Anda dapat menentukan jenis tautan kustom. Untuk informasi selengkapnya, lihat Menautkan item kerja ke objek lain dan Panduan referensi untuk jenis tautan.

Perintah

Azure DevOps

Azure DevOps Server

deletelinktype: Menghapus jenis tautan

✔️

exportlinktype: Mengekspor file jenis tautan

✔️

✔️

listlinktypes: Mencantumkan jenis tautan yang ditentukan

✔️

✔️

reactivatelinktype: Mengaktifkan kembali atau mengganti nama jenis tautan

✔️

Daftar global

Daftar global adalah daftar pilihan yang bisa Anda sertakan dalam satu atau beberapa bidang dan definisi jenis item kerja. Anda dapat berbagi item daftar di antara beberapa jenis item kerja untuk kumpulan proyek dengan menyertakan item daftar dalam satu atau beberapa elemen GLOBALLIST . Untuk informasi selengkapnya, lihat Referensi elemen XML GLOBALLIST.

Perintah

Azure DevOps

Azure DevOps Server

destroygloballist: Menghapus daftar global

✔️

exportgloballist: Mengekspor daftar global

✔️

✔️

importgloballist: Impor daftar global

✔️

listgloballist: Mencantumkan semua nama daftar global

✔️

✔️

Alur kerja global

Dengan alur kerja global, Anda dapat menentukan dan memperbarui bidang dan daftar global yang berlaku untuk semua jenis item kerja dalam proyek atau koleksi. Untuk informasi selengkapnya, lihat Referensi elemen XML alur kerja global.

Perintah

Azure DevOps

Azure DevOps Server

exportglobalworkflow: Mengekspor file alur kerja global

✔️

importglobalworkflow: Mengimpor file alur kerja global

✔️

Konfigurasi proses

Konfigurasi proses menentukan konfigurasi default dan kemampuan fungsi yang dapat diakses tim Anda menggunakan Azure Boards. Konfigurasi menentukan jenis item kerja yang muncul di backlog produk, backlog sprint, papan Kanban, dan papan tugas. Untuk informasi selengkapnya tentang konfigurasi proses dan apa yang dapat Anda kustomisasi, lihat Konfigurasi Proses.

Untuk model proses yang diwariskan, Anda dapat menyesuaikan backlog dari portal web. Untuk informasi selengkapnya, lihat Menyesuaikan backlog atau papan Anda (Proses warisan).

Perintah

Azure DevOps

Azure DevOps Server

exportprocessconfig: Mengekspor file ProcessConfiguration

✔️

✔️

importprocessconfig: Impor file ProcessConfiguration

✔️

Cache klien

Setelah operasi pemeliharaan tertentu, komputer klien memerlukan refresh cache. Setelah memindahkan, memulihkan, mengganti nama, atau mengalihkan server tingkat data atau tingkat aplikasi, Anda harus merefresh cache untuk melacak item kerja dan pengguna harus merefresh cache kontrol versi di komputer klien.

Perintah berikut ini witadmin hanya tersedia untuk Azure DevOps Server lokal.

  • rebuildcache: Membangun kembali cache klien

Menguji pemetaan bidang manajemen kasus

Untuk menyesuaikan jenis resolusi, jenis item kerja bug, dan jenis kegagalan yang digunakan saat bekerja dengan Azure Test Plans, Anda dapat menggunakan perintah tcm berikut. Perintah ini hanya tersedia untuk versi lokal Azure DevOps Server.

  • tcm fieldmapping: Mengimpor atau mengekspor file yang menentukan jenis resolusi, bug, atau jenis kegagalan yang akan digunakan dengan manajemen kasus pengujian.