Menggunakan templat item kerja

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

Visual Studio 2022 | Visual Studio 2019 | Visual Studio 2017 | Visual Studio 2015

Gunakan templat item kerja untuk membuat item kerja dengan nilai yang telah ditentukan sebelumnya dan menerapkan pembaruan yang konsisten di seluruh item serupa. Artikel ini membahas alur kerja templat di portal web dan, untuk lingkungan warisan, di Visual Studio 2015 atau yang lebih lama. Misalnya, lihat Contoh templat item kerja.

Untuk sebagian besar tim, gunakan portal web. Gunakan Visual Studio 2015 dengan Power Tools hanya saat Anda masih mengandalkan manajemen templat berbasis Team Explorer.

Templat item kerja berbeda dari templat proses. Sebagai latar belakang, lihat Tentang proses dan templat proses serta panduan proses bawaan untuk Basic, Agile, Scrum, dan Capability Maturity Model Integration (CMMI).

Tip

Anda dapat menggunakan AI untuk membantu tugas ini nanti dalam artikel ini, atau lihat Aktifkan bantuan AI dengan Azure DevOps MCP Server untuk memulai.

Pilih alur kerja Anda

Gunakan tabel ini untuk memilih alur kerja terbaik untuk skenario Anda.

Jika Anda ingin...	Gunakan...	Mengapa
Membuat, mengelola, dan menerapkan templat di Azure DevOps saat ini	Portal web (utama)	Mendukung templat cakupan tim dalam pengalaman web standar.
Gunakan kembali default bersama berdasarkan tim dan jenis item kerja	Templat tersimpan	Membantu tim menerapkan bidang dan nilai yang konsisten.
Berbagi tautan langsung yang membuka item kerja yang telah diisi sebelumnya	Template URL	Paling cocok untuk berbagi secara sederhana di dasbor, wiki, dan obrolan.
Melanjutkan alur kerja templat berbasis Team Explorer	Visual Studio 2015 dengan Power Tools (warisan)	Gunakan hanya saat lingkungan Anda masih bergantung pada alat warisan.

Prasyarat

Workflow	Requirements
Portal web (utama)	- Akses ke organisasi dan proyek Azure DevOps. - Untuk mengelola templat, jadilah anggota tim yang memiliki templat. - Untuk menerapkan templat, miliki akses Kontributor ke proyek. - Gunakan browser yang didukung dan buka Azure DevOps di portal web.
Visual Studio 2015 dengan Power Tools (warisan)	- Gunakan alur kerja ini hanya jika lingkungan Anda masih bergantung pada manajemen templat Team Explorer. - Instal Microsoft Visual Studio Team Foundation Server 2015 Power Tools. - Templat yang dibuat dalam alur kerja ini dilingkup pengguna dan hanya muncul di Team Explorer.

Pembatasan untuk menggunakan templat

Templat portal web dan templat Visual Studio merupakan penyimpanan yang terpisah. Templat yang dibuat dalam satu klien tidak muncul di klien lain.

Jenis templat	Scope	Di mana Anda dapat mengelolanya	Di mana Anda dapat menerapkannya
Templat portal web	Cakupan tim	Portal web	Portal web
templat Visual Studio	Cakupan pengguna	Visual Studio	Visual Studio

Anda masih dapat menggunakan URL dari salah satu jenis templat untuk membuat item kerja di portal web.

Tugas templat yang didukung

Ketersediaan tugas bergantung pada klien yang Anda gunakan. Gunakan portal web untuk alur kerja Azure DevOps utama, dan gunakan Visual Studio 2015 dengan Power Tools hanya untuk skenario warisan.

Tabel berikut ini memperlihatkan dukungan oleh klien.

Tugas templat	Portal web	Visual Studio
Mengambil item kerja sebagai templat	✅ Didukung	✅ Didukung
Mengelola templat item kerja (Tentukan, edit, hapus, salin tautan, buat salinan, dan ganti nama)	✅ Didukung	✅ Didukung
Menyalin tautan (URL) templat	✅ Didukung	✅ Didukung
Menambahkan item kerja dengan menggunakan templat	✅ Didukung	✅ Didukung
Menentukan templat item kerja	✅ Didukung	✅ Didukung
Menerapkan templat ke satu atau beberapa item kerja	✅ Didukung	✅ Didukung
Menambahkan atau menghapus tag dari templat	❌ Tidak didukung	✅ Didukung
Menentukan templat dengan hyperlink	✅ Didukung	❌ Tidak didukung

Mengambil item kerja sebagai templat

Gunakan prosedur yang cocok dengan klien Anda: portal web (utama) atau Visual Studio 2015 dan yang lebih lama (warisan).

Portal web

Setiap templat yang Anda ambil di portal web mendapatkan GUID unik. Gunakan langkah-langkah berikut untuk mengambil item kerja sebagai templat dan salin tautannya.

1. Di portal web, buka item kerja yang ingin Anda gunakan sebagai sumber templat.

2. Di sebelah kanan, pilih Tindakan Lainnya>Template>Pengambilan:

   

3. Di Templat Pengambilan, konfigurasikan bidang yang diperlukan dan opsional:

   • Tim (diperlukan): Pilih tim yang akan dikaitkan dengan templat.

   • Nama (wajib): Masukkan nama templat.

   • Bidang: Gunakan Tambahkan untuk menyertakan bidang, Hapus untuk menghapus bidang, dan mengatur Nilai bidang sesuai kebutuhan.

   • Catatan: Tambahkan konteks templat. Saat Anda membuat item kerja dari templat, teks ini muncul sebagai entri pertama di utas Diskusi .

   

4. Pilih Simpan, lalu pilih Salin tautan untuk menyalin URL templat.

   Gunakan URL untuk membuat item kerja dengan jenis yang sama dengan nilai yang telah ditentukan sebelumnya. Untuk skenario berbagi umum, lihat Membuat item kerja dari URL templat dan Menambahkan tautan templat ke dasbor tim.

5. Verifikasi templat muncul di daftar templat tim yang dipilih untuk jenis item kerja tersebut, dan tautan yang disalin membuka formulir item kerja baru dengan nilai yang telah ditentukan sebelumnya.

Visual Studio 2015

Nota

Alur kerja ini berlaku untuk warisan Visual Studio 2015 dengan skenario Power Tools.

Di Visual Studio atau Team Explorer, Anda dapat membuat item kerja dari file templat item kerja (.wt) atau file serupa. Akses file-file ini dari halaman Item Kerja .

1. Masuk ke Visual Studio.

2. Buka atau jalankan kueri yang menampilkan item kerja yang field-nya ingin Anda ambil.

3. Klik kanan item kerja, dan pilih Ambil Templat:

   

4. Di Templat Pengambilan, konfigurasikan bidang yang diperlukan dan bidang opsional apa pun:

   • Nama (wajib): Masukkan nama templat.

   • Bidang (diperlukan): Di kolom Sertakan , pilih setiap bidang untuk disertakan. Atur Nilai bidang sesuai kebutuhan. Untuk menyertakan semua bidang, gunakan Pilih Semua.

   

5. Pilih Simpan. Templat muncul di Team Explorer di bawahTemplat>Item Kerja.

6. Pastikan template tercantum di bawah Team Explorer>Template Item Kerja, dan bahwa saat diterapkan, template tersebut mengisi otomatis bidang yang dipilih sebelumnya.

Mengelola templat item kerja

Untuk setiap jenis item kerja, Anda dapat melihat dan mengelola templat yang ditentukan oleh tim Anda. Anda dapat menambahkan, mengedit, menyalin, menghapus, mengganti nama, dan menyalin tautan templat.

Portal web

Gunakan langkah-langkah ini untuk membuka templat item kerja di portal web:

1. Di portal web, buka pengaturan Project.

2. Di bawah Papan, pilih Konfigurasi tim.

3. Jika Anda membutuhkan tim yang berbeda, gunakan menu Tim di navigasi breadcrumb.

4. Pada halaman Papan, pilih Templat:

   

5. Pilih jenis item kerja, seperti Bug, Fitur, atau Kasus Pengujian, untuk melihat atau menambahkan templat untuk jenis tersebut:

   

Membuat templat item kerja

Gunakan langkah-langkah ini untuk membuat templat item kerja di portal web:

1. Pada halaman jenis item kerja, pilih Templat baru:

   

   Nota

   Jika Anda berencana menggunakan markdown di bidang teks besar, tambahkan <br> tag untuk mengelola hentian baris dan pastikan markdown dirender dengan benar.

2. Dalam dialog Templat Baru , masukkan Nama (diperlukan), lalu tambahkan bidang dan nilai opsional apa pun.

3. Pilih Simpan. Opsi Salin tautan menjadi tersedia.

4. Pilih Salin tautan untuk menyalin URL templat.

5. Verifikasi templat tercantum untuk jenis item kerja yang dipilih dan bahwa tautan yang disalin membuka formulir item kerja baru dengan nilai templat.

Mengedit, menghapus, menyalin tautan, atau membuat salinan

Setelah menyimpan templat, Anda dapat memperbaruinya, menghapusnya, menyalin tautannya, atau membuat salinan.

Pada halaman jenis item kerja, pilih Tindakan lainnya untuk templat, lalu pilih salah satu opsi ini:

• Edit: Pilih Edit, perbarui templat, lalu pilih Simpan.

• Hapus: Pilih Hapus, lalu konfirmasi. Templat yang dihapus tidak dapat dipulihkan.

• Salin tautan: Pilih Salin tautan untuk menyalin URL templat. Untuk opsi berbagi, lihat Membuat item kerja dari URL templat dan Menambahkan tautan templat ke dasbor tim.

• Buat salinan: Pilih Buat salinan, masukkan nama, sesuaikan bidang secara opsional, lalu pilih Simpan.

1. Verifikasi daftar templat mencerminkan tindakan Anda (nilai yang diperbarui, item yang diganti namanya, templat yang disalin, atau templat yang dihapus).

2. Verifikasi bahwa tautan Salin membuka formulir item kerja baru dengan nilai templat yang diharapkan.

Visual Studio 2015

Nota

Alur kerja ini berlaku untuk warisan Visual Studio 2015 dengan skenario Power Tools.

Gunakan Visual Studio dengan Power Tools untuk mengelola templat item kerja pribadi Anda. Untuk setiap jenis item kerja, Anda dapat melihat templat dan menggunakan tindakan seperti Tambahkan, Edit, Hapus, dan Salin. Anda dapat berbagi templat dengan berbagi URL templat atau dengan menyimpan file templat item kerja (.wt).

• Kelola Templat Item Kerja dari panel Team Explorer . Simpul akar Templates merupakan induk dari semua templat:

  

  Anda dapat mengatur templat ke dalam folder di bawah node akar.

  • Klik kanan simpul Templat atau folder lain dan pilih Folder Baru.

  • Anda juga dapat menyeret dan meletakkan templat ke dalam folder.

• Potong, Salin, Tempel, Ganti Nama, dan Hapus: Gunakan menu konteks klik kanan pada templat dan folder.

• Untuk mengedit beberapa templat, gunakan Shift + Select untuk rentang atau Ctrl + Pilih untuk item individual. Kemudian buka menu konteks klik kanan pada satu item yang dipilih dan pilih tindakan. Tindakan ini berlaku untuk semua item terpilih.

Menentukan templat

Gunakan langkah-langkah ini untuk menentukan templat item kerja di Visual Studio dan Team Explorer:

1. Di panel Team Explorer , klik kanan Templat dan pilih Templat baru untuk membuat templat dari awal.

2. Dalam dialog Pilih Tipe Item Kerja , gunakan daftar dropdown dan pilih Tipe Item Kerja yang akan digunakan untuk templat baru, dan pilih OK:

   

3. Dalam dialog Simpan Templat Item Kerja Sebagai , masukkan Nama, pilih tempat menyimpan templat (di bawah Templat atau dalam file), lalu pilih Simpan:

   

4. Setelah Anda menyimpan templat, pilih Salin tautan untuk menyalin URL templat. Gunakan URL untuk membuat item kerja berdasarkan templat.

5. Verifikasi templat muncul di pohon Templat Item Kerja Anda dan tautan yang disalin membuka formulir item kerja baru dengan nilai yang telah ditentukan sebelumnya.

Mengedit, menggunakan, menyalin, atau menghapus templat

Anda dapat melakukan tindakan templat lain di Visual Studio dan Team Explorer dengan menggunakan menu konteks klik kanan.

• Edit, Salin, Hapus, dan lainnya: Di Team Explorer di bawah Templat Item Kerja, klik kanan templat dan pilih tindakan:

  

• Mengatur templat default: Untuk membuat templat yang sering digunakan lebih mudah diakses, atur templat default untuk setiap jenis item kerja. Klik kanan templat dan pilih Atur Sebagai Default. Di Team Explorer, tanda centang muncul pada ikon templat.

Mengatur lokasi penyimpanan templat Anda

Anda dapat mengubah lokasi penyimpanan default untuk templat. Gunakan Konfigurasi diTeam Explorer di bawah Templat Item Kerja, atau pilihOpsi>Alat> MicrosoftTemplat Item Kerja> Team Foundation.

Dalam dialog, atur jalur penyimpanan templat. Untuk berbagi templat dengan tim Anda, gunakan lokasi jaringan.

Menambahkan item kerja dengan menggunakan templat

Gunakan tautan templat di browser untuk membuat item kerja dengan nilai yang telah ditentukan sebelumnya.

1. Dapatkan tautan templat. Untuk informasi selengkapnya, lihat Mengedit, menghapus, menyalin tautan, membuat salinan.

2. Tempelkan tautan templat ke browser, lengkapi bidang yang diperlukan, dan simpan perubahan Anda.

3. Pastikan item kerja baru dibuka dengan nilai yang ditentukan oleh templat sudah terisi sebelum Anda menyimpannya.

Menerapkan templat ke item kerja baru atau yang sudah ada

Terapkan templat ke item kerja baru atau yang sudah ada, atau gunakan templat untuk pembaruan massal.

Portal web

Di portal web, Anda dapat menerapkan templat dalam item kerja terbuka atau di seluruh item kerja yang dipilih.

Menerapkan templat dalam item kerja

Gunakan langkah-langkah ini untuk menerapkan templat ke item kerja baru atau yang sudah ada:

1. Buka item kerja baru atau yang sudah ada yang ingin Anda perbarui dengan nilai yang ditentukan templat.

2. Pilih Lainnya>Templat, lalu pilih nama templat yang telah ditentukan sebelumnya.

   

   Nota

   Daftar Templat memperlihatkan templat yang ditentukan untuk tim tempat Anda menjadi anggota. Jika daftar kosong, mungkin tidak ada templat apa pun untuk jenis item kerja. Refresh browser Anda untuk menemukan templat terbaru yang tersedia.

3. Pilih Simpan untuk menerapkan templat. Perubahan bidang direkam di bidang Riwayat item kerja.

4. Verifikasi pembaruan bidang dalam formulir dan item kerja Riwayat merekam perubahan yang disimpan.

Menerapkan templat ke beberapa item kerja

Gunakan langkah-langkah ini untuk menerapkan templat ke item kerja yang dipilih untuk pembaruan massal:

1. Pilih item kerja dari Backlog atau daftar hasil Queries. Semua item yang dipilih harus tipe item kerja yang sama, seperti Bug atau Fitur.

2. Pilih Templat Tindakan> lainnya untuk salah satu item kerja yang dipilih, dan pilih templat yang akan diterapkan.

   

   Perubahan bidang diterapkan dan disimpan secara otomatis. Perubahan bidang direkam di bidang Riwayat item kerja. Untuk informasi selengkapnya tentang pembaruan massal, lihat Memodifikasi item kerja secara massal.

3. Pastikan setiap item kerja yang dipilih menampilkan nilai bidang yang telah diperbarui dan entri Riwayat yang sesuai.

Visual Studio 2015

Nota

Alur kerja ini berlaku untuk warisan Visual Studio 2015 dengan skenario Power Tools.

Gunakan langkah-langkah ini untuk menerapkan templat ke item kerja baru atau yang sudah ada di Visual Studio:

1. Buka atau jalankan kueri yang mencantumkan satu atau beberapa item kerja untuk diperbarui.

2. Pilih item kerja untuk tindakan tersebut. Semua item kerja yang dipilih harus memiliki tipe item kerja yang sama.

3. Klik kanan salah satu item kerja yang dipilih dan pilih Terapkan Templat:

   

4. Dalam dialog Pilih Templat untuk Diterapkan , pilih templat yang akan diterapkan, dan pilih OK:

   

5. Pilih Simpan Hasil untuk menyimpan perubahan item kerja:

   

6. Pastikan nilai kolom yang diperbarui tetap tersimpan saat Anda membuka kembali item kerja.

Menambahkan atau menghapus tag dari templat

Di Visual Studio 2015 atau versi yang lebih lama, Anda dapat menambahkan tag ke templat. Saat Anda menggunakan templat, tag secara otomatis berlaku untuk item kerja. Untuk menambahkan dua tag atau lebih, pisahkan dengan koma (,). Anda tidak dapat menambahkan tag di portal web.

Jika Anda tidak menentukan tag yang akan dihapus, semua tag dalam item kerja tetap ditentukan. Tag tetap ditentukan bahkan saat Anda menerapkan templat item kerja ke item kerja yang sudah ada.

Verifikasi di Visual Studio bahwa templat mempertahankan tag yang dikonfigurasi dan item kerja yang diterapkan menyertakan tag tersebut setelah Anda menyimpan.

Membuat item kerja dari URL templat

Buat URL yang membuka item kerja baru dengan nilai bidang yang telah ditentukan sebelumnya. Gunakan pendekatan ini saat Anda menginginkan pintasan yang dapat dibagikan ke konfigurasi item kerja umum.

Gunakan templat yang disimpan untuk default yang dapat digunakan kembali dan dikelola tim. Gunakan URL templat saat berbagi tautan langsung adalah pengalaman utama.

• Gunakan templat yang disimpan saat tim Anda memerlukan default yang dikelola secara terpusat.
• Gunakan URL templat saat Anda memerlukan berbagi ringan di dasbor, wiki, atau pesan.

https://dev.azure.com/<Organization_Name>/<Project_Name>/_workItems/create/<Work_Item_Type>?
[FieldReferenceName 1]={FieldValue 1}&
[FieldReferenceName 2]={FieldValue 2}&
[FieldReferenceName 3]={FieldValue 3}&
. . .

Contoh berikut membuat item kerja Tugas dengan Judul yang telah ditentukan sebelumnya, Ditetapkan Ke, Deskripsi, Tag, Aktivitas, dan Jalur Perulangan.

https://dev.azure.com/<Organization_Name>/<Project_Name>/_workItems/create/Task?
[System.Title]=TaskTitle&
[System.AssignedTo]=Jamal+Hartnett&
[System.Description]=<p>Always+include+Remaining+Work+and+links+to+any+related+bugs+or+user+stories.</p>&
[System.Tags]=Web;+Phone;+Service&
[Microsoft.VSTS.Common.Activity]=Development&
[System.IterationPath]=Fabrikam+Fiber%5CIteration+1

Nota

Beberapa klien browser memberlakukan batas 2.000 karakter untuk nilai bidang.

Anda bisa menyimpan URL sebagai file teks, atau menambahkannya sebagai hyperlink di dasbor atau halaman web.

Verifikasi bahwa saat URL dibuka, jenis item kerja yang benar dimuat dan nilai kolom yang sudah ditentukan sebelumnya ditampilkan dalam formulir item kerja baru.

Menambahkan tautan templat ke dasbor tim

Tambahkan tautan templat ke widget Markdown di dasbor tim Anda di portal web. Setiap tautan membuka item kerja baru dengan nilai templat yang telah ditentukan sebelumnya.

Contoh berikut menunjukkan widget Markdown dengan tautan ke tiga templat:

Untuk langkah-langkah penyiapan, lihat Menambahkan Markdown ke dasbor, widget Markdown.

Memecahkan masalah templat

• Menu templat tidak muncul: Verifikasi bahwa Anda memiliki akses ke proyek dan Anda menggunakan alur kerja yang didukung oleh klien Anda.
• Daftar templat kosong di portal web: Konfirmasikan bahwa templat ada untuk jenis item kerja yang dipilih dan Anda adalah anggota tim yang memiliki templat. Refresh browser untuk memuat templat terbaru.
• Tidak dapat mengelola templat tim: Verifikasi bahwa Anda adalah anggota tim yang memiliki templat.
• Tidak dapat menerapkan templat ke beberapa item kerja: Konfirmasikan bahwa semua item kerja yang dipilih adalah jenis item kerja yang sama.
• opsi templat Visual Studio tidak tersedia: Konfirmasikan bahwa Anda menggunakan alur kerja warisan Visual Studio 2015 dan power Tools Microsoft Visual Studio Team Foundation Server 2015 diinstal.
• URL templat terbuka tanpa nilai yang diharapkan: Konfirmasikan bahwa setiap nama referensi bidang valid untuk jenis item kerja target dan nilai tersebut dikodekan URL (misalnya, spasi sebagai + atau %20).
• URL Templat gagal dimuat: Konfirmasikan bahwa URL menggunakan jenis organisasi, proyek, dan item kerja yang benar, dan bahwa Anda masuk ke akun dengan akses proyek.
• Beberapa bidang dari templat tidak terisi: Konfirmasikan bahwa bidang masih ada pada jenis item kerja dan tidak dibatasi oleh aturan kustomisasi proses.

Menggunakan AI untuk membuat dan menerapkan templat item kerja

Jika Anda mengonfigurasi Azure DevOps MCP Server, Anda dapat menjelaskan tugas terkait templat dalam bahasa alami alih-alih melakukan setiap langkah secara manual di portal web atau Team Explorer.

Perlakukan perintah berikut sebagai contoh skenario. Operasi yang tersedia dapat bervariasi menurut versi MCP Server, alat yang diaktifkan, dan izin Anda.

Sebelum Anda menjalankan prompt, ganti placeholder dengan nilai dari lingkungan Anda: <ProjectName>, <TeamName>, <TemplateName>, <WorkItemId>, dan <IterationPath>.

Tugas	Contoh tanggapan
Membuat templat dari item	Capture work item <WorkItemId> in project <ProjectName> as a template named "Security bug" for team <TeamName>
Membuat templat baru	Create a Bug template named "Regression" for team <TeamName> in project <ProjectName> with Priority 2 and tag "regression"
Menerapkan templat ke satu item	Apply the "<TemplateName>" template to work item <WorkItemId> in project <ProjectName>
Menerapkan templat secara massal	Apply the "<TemplateName>" template to all active Bugs tagged "regression" in project <ProjectName>
Membuat item kerja dari templat	Create 5 Bugs in project <ProjectName> for team <TeamName> using the "<TemplateName>" template with the titles I provide
Membuat URL templat	Generate a template URL that creates a Task in project <ProjectName> with Activity=Development and Iteration=<IterationPath>
Memperbarui templat	Update the "<TemplateName>" template for team <TeamName> in project <ProjectName> to set Severity to 2 - High
Menyalin templat	Create a copy of the "<TemplateName>" template named "Regression - Mobile" for team <TeamName> in project <ProjectName>
Menemukan tim yang kehilangan templat	List teams in project <ProjectName> that don't have a Bug template defined
Mengaudit penggunaan templat	Show which work items in iteration <IterationPath> were created from the "<TemplateName>" template in project <ProjectName>

Nota

Jika Anda menggunakan Visual Studio Code, mode agen sangat membantu untuk operasi templat yang kompleks.

Konten terkait

• Pertanyaan yang Sering Diajukan tentang Azure Boards
• Contoh templat item kerja
• Memodifikasi item kerja secara massal