İş öğesi türü tanım xml'i aracılığıyla iş öğesi formuna uzantı ekleme

Makale
04/04/2024

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

İş öğesi formunun witadmin düzenini içeren aracı kullanarak bir iş öğesi türünü xml olarak dışarı aktarabilirsiniz. Bu örneğin bir parçası olarak, sayfayı, grubu ve düzene yapılan denetim katkılarını ekleyeceğiz. Ayrıca denetimi Çevik "Kullanıcı Hikayesi" iş öğesi türüne de ekleriz. Daha fazla bilgi için bkz . WebLayout xml başvurusu.

Not

xml aracılığıyla iş öğesi form özelleştirmesi yalnızca Azure DevOps Server'da desteklenir, Azure DevOps Services'te desteklenmez.

İş öğesi formunda uzantı ekleme

Azure DevOps Server'da iş öğesi form uzantılarını yükleyin.
Developer Command Prompt dosyasını açın. Aşağıdaki komutla xml dosyasını masaüstünüzde dışarı aktarın.
```
witadmin exportwitd /collection:CollectionURL /p:Project /n:TypeName /f:FileName
```
Belirttiğiniz dizinde bir dosya oluşturulur.

Bu dosyanın içinde WebLayout bölümüne gidin. WebLayout bölümünde, bir açıklama blobu hangi yüklü uzantıların koleksiyonunuz için iş öğesi formlarını hedefleyeni belirtir. Her uzantı için, tüm form katkıları kimlikleri ve girişleri (Denetim katkısıysa) ile birlikte listelenir. Aşağıdaki örnekte, açıklama koleksiyona yüklenen color-control-dev uzantısını gösterir. Uzantının iki giriş alan tek bir denetim katkısı vardır.

     <!--**********************************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

İş Öğesi Uzantıları bölümünde uzantı kimliğinizi bulun:

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

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

Uzantınızı iş öğesi formu için kullanılabilir hale getirmek için İş Öğesi Uzantıları bölümünün altına aşağıdaki gibi gösterilen bir uzantı etiketi ekleyin. Formun içine bir katkı yerleştirmek için uzantısı bölümünde Extensions belirtilmelidir.

     <!--**********************************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>

XML'de uzantıların belirtilmesi, formdaki uzantılarda tanımlanan sayfa ve grup katkılarını otomatik olarak yerleştirir. Aşağıdaki örneklerde katkıları taşıyabilirsiniz.

Sayfa katkısı ekleme

    <Page Id="Details">
    <PageContribution Id="<page contribution id>" />
    ...

Grup katkısı ekleme

    <Page Id="Details">
    ...
        <Section>
        ...
            <GroupContribution Id="<group contribution id>" />
            ...

Sayfa katkıları ve grup katkıları diğer düzen öğelerini alamaz.

Denetim katkısı ekleme

Sayfa ve grup katkılarından farklı olarak, xml'de uzantıların belirtilmesi denetim katkılarını otomatik olarak yerleştirmez. Bu katkıları forma eklemek için, formda bir katkı etiketiyle ekleyin. Aşağıdaki örnek ControlContribution'i Planlama grubuna ekler.

Denetim katkılarının tanımlanmış gerekli girişleri varsa, kullanıcıların bu giriş için bir değer vermesi gerekir. Gerekli olmayan tüm girişler için, kullanıcılar girişe bir değer ayarlayıp ayarlamamaya karar verebilir. Aşağıdaki örnekte ve FieldNameColors girişleri ayarlanır.

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

kullanarak witadminbu xml dosyasını içeri aktar.

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

Uzantınız iş öğesi formu aracılığıyla yapılandırıldı!