Mengelola bidang item kerja
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 mengelola bidang yang ditentukan untuk jenis item kerja yang ditentukan untuk koleksi proyek (XML lokal) dengan menggunakan perintah witadmin berikut. Jika Anda ingin menambahkan bidang global (valid untuk XML Lokal) Anda dapat melakukannya dengan memodifikasi file alur kerja global dan mengimpornya ke koleksi.
changefield
: Mengubah satu atau beberapa atribut bidang. Saat Anda mengubah salah satu atribut berikut, Anda mengubahnya untuk semua jenis item kerja dan proyek dalam koleksi proyek:Jenis data untuk
PlainText
atauHTML
bidang.Penting
Saat Anda meningkatkan Team Foundation Server dari versi yang lebih lama ke versi saat ini, penetapan jenis untuk bidang Deskripsi (System.Description) secara otomatis dikonversi dari
PlainText
keHTML
.changefield
Dengan perintah , Anda dapat memulihkan konten bidang ini untuk menampilkan teks biasa.Nama yang mudah diingat yang ditampilkan dalam kueri item kerja. Nama ini mungkin berbeda dari yang ditampilkan pada formulir item kerja.
Atribut pelaporan yang menyertakan nama bidang seperti yang muncul dalam laporan, nama laporan referensi, dan jenis pelaporan.
Sinkronisasi dengan Direktori Aktif - Anda dapat mengaktifkan/menonaktifkan sinkronisasi bidang nama orang.
deletefield
: Menghapus bidang yang ditentukan.listfields
: Mencantumkan atribut untuk semua bidang atau bidang tertentu.
Catatan
Perintah witadmin indexfield
tidak digunakan lagi dengan Azure DevOps Server 2019 dan versi yang lebih baru. Bidang pengindeksan tidak lagi diperlukan.
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
- Untuk mencantumkan bidang, Anda harus memiliki izin Tampilkan informasi tingkat proyek untuk proyek dalam kumpulan yang diatur ke Izinkan.
- Untuk menghapus atau mengganti nama bidang atau mengubah atribut bidang, Anda harus menjadi anggota grup keamanan Administrator Team Foundation atau grup keamanan Administrator Koleksi Proyek.
Untuk informasi selengkapnya, 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 2008. Untuk membuka jendela Prompt Perintah yang ditinggikan, pilih Mulai, buka menu pintasan Perintah, lalu pilih Jalankan sebagai Administrator. Untuk informasi selengkapnya, lihat situs Web Microsoft: Kontrol Akses Pengguna.
Sintaks
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. |
/index |
Menentukan untuk mengaktifkan atau menonaktifkan pengindeksan untuk bidang yang ditentukan. Tentukan aktif untuk mengaktifkan pengindeksan dan nonaktif untuk menonaktifkan pengindeksan. |
/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 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 Direktori Aktif
Anda harus mengaktifkan sinkronisasi bidang item kerja kustom apa pun secara manual yang digunakan untuk menetapkan nama orang yang mereferensikan Direktori Aktif. Anda harus mengaktifkan sinkronisasi untuk setiap bidang untuk setiap koleksi proyek yang berisi bidang kustom.
Semua bidang referensi sistem yang menunjukkan nama orang memiliki atribut syncnamechanges
yang diatur ke true
. Bidang tersebut termasuk System.AuthorizedAs, System.AssignedTo, System.ChangedBy dan System.CreatedBy. Sinkronisasi diaktifkan untuk setiap bidang nama orang yang ditentukan dalam salah satu templat proses default. Untuk informasi selengkapnya, lihat Bidang tugas dan alur kerja.
Setelah sinkronisasi diaktifkan, bidang tidak lagi menampilkan string statis. Sebagai gantinya, bidang menunjukkan nama yang terkait dengan akun pengguna. Saat Anda mengubah nama pengguna di Direktori Aktif atau di Grup Kerja, bidang dengan syncnamechanges
diatur ke true
secara otomatis menampilkan nama baru.
Saat Anda menetapkan syncnamechanges
atribut ke bidang String, bidang selalu menerima nama pengguna yang valid. Namun, bidang tidak mengizinkan nama grup yang disimpan di Team Foundation Server atau di Direktori Aktif jika salah satu kondisi berikut adalah true
:
Aturan
VALIDUSER
ditentukan di semua jenis item kerjaAturan
VALIDUSER
ditentukan untuk jenis item kerjaAturan
ALLOWEDVALUES
ditentukan untuk jenis item kerja, dan aturan tersebut memiliki kriteria filter yang mengecualikan grupUntuk informasi selengkapnya, lihat Semua elemen FIELD.
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. Perhatikan bahwa 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.Rank
Peringkat Penting.witadmin changefield /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:Microsoft.VSTS.Common.Rank /name:"Important Rank"
Pada perintah konfirmasi ketik y lalu tekan 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, ketik Peringkat. 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 <<Peringkat>>.
Hapus peringkat nilai dari sel Bidang, dan ketik Peringkat Penting ke dalam sel.
Pilih <> di sel Operator , dan ketik 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.Rank telah diganti namanya dari Peringkat ke Peringkat Penting di seluruh daftar penyusun dan hasil kueri.
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. Ini karena label bidang pada formulir item kerja dilingkup ke proyek induk dan independen dari nama bidang di seluruh server yang baru saja 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 langkah 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 Team Foundation Server. Apakah Anda ingin melanjutkan?
Ketik 0 untuk mengonfirmasi bahwa Anda ingin mengubah bidang, atau 1 untuk 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 tersebut 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 danControl
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.