Bagikan melalui

Mengelola bidang item kerja

  • 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 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 atau HTML 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 ke HTML. 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 kerja

  • Aturan VALIDUSER ditentukan untuk jenis item kerja

  • Aturan ALLOWEDVALUES ditentukan untuk jenis item kerja, dan aturan tersebut memiliki kriteria filter yang mengecualikan grup

    Untuk 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

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

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

  1. Di Team Explorer, pilih Refresh Refresh.

    Pembaruan terbaru diunduh dari server, yang mencakup perubahan yang baru saja Anda buat pada nama bidang. Tunggu beberapa detik hingga refresh selesai.

  2. Pilih Kueri Baru untuk membuat kueri.

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

  4. Hapus peringkat nilai dari sel Bidang, dan ketik Peringkat Penting ke dalam sel.

  5. Pilih <> di sel Operator , dan ketik 1 ke dalam sel Nilai .

  6. Pada toolbar Kueri, pilihJalankan Kueri Jalankan.

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

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

  9. Tutup kueri. Pilih Tidak saat Anda diminta untuk menyimpan kueri.

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

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

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

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

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

  2. Perintah konfirmasi berikut muncul:

    Ini akan mengubah properti untuk bidang {0} di Team Foundation Server. Apakah Anda ingin melanjutkan?

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

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

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