Bagikan melalui


witAdmin: Menyesuaikan dan mengelola objek untuk pekerjaan pelacakan

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 memungkinkan Anda menyesuaikan pelacakan kerja dengan membuat, menghapus, mengimpor, dan mengekspor objek seperti jenis item kerja, kategori, daftar global, alur kerja global, dan jenis tautan. Anda juga dapat mengelola atribut bidang item kerja.

Untuk Azure DevOps Server lokal, Anda juga dapat mengelola jenis resolusi, jenis bug, dan jenis kegagalan yang digunakan dengan manajemen kasus pengujian dengan menggunakan perintah fieldmapping tcm .

Diagram berikut menunjukkan cakupan objek pelacakan kerja. Kategori dan jenis item kerja dikelola di tingkat proyek. Daftar global, jenis tautan, dan bidang item kerja dikelola di tingkat pengumpulan proyek. Alur kerja global dapat disesuaikan untuk proyek atau koleksi.

Gambar konseptual Objek Pelacakan Item Kerja.

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

Jalankan alat baris perintah witadmin

Alat baris perintah witadmin diinstal dengan Visual Studio. Buka jendela Prompt Perintah dan navigasikan ke direktori tempat Visual Studio diinstal. Anda juga dapat menginstal edisi Visual Studio Community gratis.

Catatan

Untuk Azure DevOps Services, gunakan versi terbaru Visual Studio.

Catatan

Untuk Azure DevOps Server lokal, gunakan Visual Studio versi yang sama atau yang lebih baru. Misalnya, gunakan Visual Studio 2019 atau yang lebih baru untuk menyambungkan ke Azure DevOps Server 2019.

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

Ganti Community dengan Professional atau Enterprise, tergantung pada versi yang Anda instal.

Pada Windows edisi 32-bit, ganti %programfiles(x86)% dengan %programfiles%.

Petunjuk / Saran

Anda dapat menggunakan AI untuk membantu tugas Azure DevOps. Lihat Mengaktifkan bantuan AI dengan Azure DevOps MCP Server untuk memulai.

Parameter global

Parameter berikut menampilkan teks bantuan untuk perintah witadmin.

Parameter Deskripsi
/? atau help Menampilkan sintaksis dan parameter untuk alat baris perintah witadmin.
command /help atau command /? Menampilkan sintaks dan parameter untuk perintah witadmin yang ditentukan.

File definisi XML

Objek pelacakan kerja dikustomisasi dengan memperbarui definisi XML mereka. Objek mencakup jenis item kerja, konfigurasi proses, daftar global, dan jenis tautan. Untuk gambaran umum opsi kustomisasi, lihat Menyesuaikan pengalaman pelacakan kerja Anda.

Anda dapat menjalankan perintah witadmin terhadap Azure DevOps Services atau Azure DevOps Server. Namun, Azure DevOps Services hanya mendukung perintah yang mencantumkan atau mengekspor definisi. Operasi impor dan modifikasi hanya tersedia untuk Azure DevOps Server.

Jenis item kerja

Jenis item kerja menentukan bidang dan alur kerja untuk pekerjaan pelacakan. Jenis yang tersedia tergantung pada proses proyek Anda (Agile, Scrum, Basic, atau CMMI). Untuk informasi selengkapnya, lihat Tentang Item Kerja.

Untuk model proses yang diwariskan, kelola jenis item kerja dari portal web. Untuk informasi selengkapnya, lihat Menambahkan dan mengelola jenis item kerja.


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 menyimpan status dan informasi dalam item kerja. Anda menentukan bidang di tingkat organisasi atau koleksi. Untuk informasi selengkapnya, lihat Bidang item kerja dan atribut dan Indeks bidang item kerja.

Untuk model proses yang diwariskan, kelola bidang dari portal web. Untuk informasi selengkapnya, lihat Menambahkan dan mengelola bidang.


Perintah

Azure DevOps

Azure DevOps Server


deletefield: Menghapus bidang

✔️

listfields: Mencantumkan atribut bidang

✔️

✔️

changefield: Mengubah atribut bidang

✔️

renamewitd: Mengubah nama tampilan WIT

✔️


Kategori

Grup kategori satu atau beberapa tipe item kerja bersama-sama. Azure Boards menggunakan definisi kategori untuk menentukan jenis item kerja mana yang muncul di backlog dan papan. 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

✔️


Jenis tautan menentukan hubungan antara item kerja, seperti induk-anak atau terkait. Anda dapat menentukan jenis tautan kustom untuk model proses XML lokal dan XML yang Dihosting. Untuk informasi selengkapnya, lihat Menautkan item kerja dan Referensi jenis tautan.


Perintah

Azure DevOps

Azure DevOps Server


deletelinktype: Menghapus jenis tautan

✔️

exportlinktype: Mengekspor file jenis tautan

✔️

✔️

importlinktype: Mengimpor 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 dapat digunakan kembali yang dapat Anda referensikan di beberapa bidang dan definisi jenis item kerja di seluruh koleksi proyek. Tentukan daftar global menggunakan elemen XML 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

Alur kerja global menentukan 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 jenis item kerja mana yang muncul di backlog, papan, backlog sprint, dan Taskboard. Ini juga mengontrol kolom default dan kemampuan tim lainnya. Untuk informasi selengkapnya, lihat ProcessConfiguration XML element reference.

Untuk model proses yang diwariskan, sesuaikan backlog dari portal web. Untuk informasi selengkapnya, lihat Menyesuaikan backlog dan papan.


Perintah

Azure DevOps

Azure DevOps Server


exportprocessconfig: Mengekspor file ProcessConfiguration

✔️

✔️

importprocessconfig: Impor file ProcessConfiguration

✔️


Cache klien

Setelah operasi pemeliharaan server seperti memindahkan, memulihkan, mengganti nama, atau mengalihkan server, Anda harus menyegarkan cache klien. Perintah ini hanya tersedia untuk Azure DevOps Server.

  • rebuildcache: Membangun kembali cache klien untuk pelacakan item kerja

Menguji pemetaan bidang manajemen kasus

Sesuaikan jenis resolusi, jenis item kerja bug, dan jenis kegagalan yang digunakan dengan Azure Test Plans. Perintah ini hanya tersedia untuk Azure DevOps Server.

  • tcm fieldmapping: Mengimpor atau mengekspor file yang menentukan jenis resolusi, jenis bug, atau jenis kegagalan untuk manajemen kasus pengujian