Bagikan melalui

Menambahkan ekstensi dalam formulir item kerja melalui xml definisi jenis item kerja

  • Artikel

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

  1. Instal ekstensi formulir item kerja di Azure DevOps Server.

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

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

  4. Temukan ID ekstensi Anda di bagian Ekstensi Item Kerja:

         <!--**********************************Work Item Extensions*************************** 

 Extension:
     Name: color-control-dev
     Id: example.color-control-dev
     ...

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

  6. 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" />

  1. Impor file xml ini, menggunakan witadmin.

    witadmin importwitd /collection:CollectionURL /p:Project /f:FileName

Ekstensi Anda dikonfigurasi melalui formulir item kerja!