Menambahkan ekstensi dalam formulir item kerja melalui xml definisi jenis item kerja
Layanan Azure DevOps | Azure DevOps Server 2022 - Azure DevOps Server 2019
Anda dapat mengekspor jenis item kerja sebagai xml menggunakan witadmin
alat , yang menyertakan tata letak formulir item kerja. Sebagai bagian dari contoh ini, kami menambahkan kontribusi halaman, grup, dan kontrol ke tata letak. Kami juga menambahkan kontrol ke jenis item kerja Agile "Cerita Pengguna". Untuk informasi selengkapnya, lihat Referensi xml WebLayout.
Catatan
Kustomisasi formulir item kerja melalui xml hanya didukung di Azure DevOps Server, bukan Azure DevOps Services.
Menambahkan ekstensi dalam formulir item kerja
Instal ekstensi formulir item kerja di Azure DevOps Server.
Buka
Developer Command Prompt
. Ekspor file xml ke desktop Anda dengan perintah berikut.witadmin exportwitd /collection:CollectionURL /p:Project /n:TypeName /f:FileName
File dibuat di direktori yang Anda tentukan.
Di dalam file ini, buka bagian WebLayout . Di dalam bagian WebLayout, blob komentar menentukan formulir item kerja target ekstensi yang diinstal untuk koleksi Anda. Untuk setiap ekstensi, semua kontribusi formulirnya tercantum dengan ID dan input mereka (jika itu adalah kontribusi Kontrol). Dalam contoh berikut, komentar menunjukkan ekstensi color-control-dev yang diinstal pada koleksi. Ekstensi ini memiliki satu kontribusi kontrol yang mengambil dua input.
<!--**********************************Work Item Extensions*************************** Extension: Name: color-control-dev Id: example.color-control-dev Control contribution: Id: example.color-control-dev.color-control-contribution Description: Inputs: Id: FieldName Description: The field associated with the control. Type: Field IsRequired: true Id: Colors Descriptions: The colors that match the values in the control. Type: String IsRequired: false
Temukan ID ekstensi Anda di bagian Ekstensi Item Kerja:
<!--**********************************Work Item Extensions*************************** Extension: Name: color-control-dev Id: example.color-control-dev ...
Tambahkan tag ekstensi di bawah bagian Ekstensi Item Kerja, diperlihatkan sebagai berikut, untuk membuat ekstensi Anda tersedia untuk formulir item kerja. Untuk menempatkan kontribusi di dalam formulir, ekstensinya harus ditentukan di bagian .
Extensions
<!--**********************************Work Item Extensions*************************** ... Note: For more information on work item extensions use the following topic: https://go.microsoft.com/fwlink/?LinkId=816513 --> <Extensions> <Extension Id="example.color-control-dev" /> </Extensions>
Menentukan ekstensi dalam xml secara otomatis menempatkan kontribusi halaman dan grup yang ditentukan dalam ekstensi di dalam formulir. Anda dapat memindahkan kontribusi dalam contoh berikut.
Menambahkan kontribusi halaman
<Page Id="Details">
<PageContribution Id="<page contribution id>" />
...
Menambahkan kontribusi grup
<Page Id="Details">
...
<Section>
...
<GroupContribution Id="<group contribution id>" />
...
Kontribusi halaman dan kontribusi grup tidak dapat mengambil elemen tata letak lainnya.
Menambahkan kontribusi kontrol
Tidak seperti kontribusi halaman dan grup , menentukan ekstensi di xml tidak secara otomatis menempatkan kontribusi kontrol . Untuk menambahkan kontribusi ini dalam formulir, tambahkan dengan tag kontribusi di dalam formulir. Contoh berikut menambahkan ControlContribution ke grup Perencanaan .
Jika kontribusi kontrol memiliki input yang diperlukan yang ditentukan, pengguna harus memberikan nilai untuk input tersebut. Untuk input yang tidak diperlukan, pengguna dapat memutuskan apakah akan mengatur nilai ke input. Dalam contoh berikut, FieldName
input dan Colors
diatur.
<Page Id="Details">
...
<Section>
...
<Group Id="Planning">
...
<ControlContribution Label="Priority" Id="example.color-control-dev.color-control-contribution">
<Inputs>
<Input Id="FieldName" Value="Microsoft.Azure DevOps Services.Common.Priority" />
<Input Id="Colors" Value="red;green" />
</Inputs>
</ControlContribution>
<Control Label="Risk" Type="FieldControl" FieldName="Microsoft.Azure DevOps Services.Common.Risk" />
Impor file xml ini, menggunakan
witadmin
.witadmin importwitd /collection:CollectionURL /p:Project /f:FileName
Ekstensi Anda dikonfigurasi melalui formulir item kerja!