Aracılığıyla paylaş

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

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022

İş öğ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, sayfa, grup ve denetim katkılarını düzene 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.

Uyarı

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

  1. Azure DevOps Server'da iş öğesi form uzantılarını yükleyin.

  2. Developer Command Prompt öğesini 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.

  3. 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 bir uzantı için, tüm form katkıları kimlikleri ve (eğer bir Kontrol katkısıysa) girişleriyle 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 bir kontrol bileşeni 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

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

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

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

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

  6. XML'de uzantıların belirtilmesi, formdaki uzantılarda tanımlanan sayfa ve grup katkılarını otomatik olarak yerleştirir. Aşağıdaki örneklerdeki öğeleri 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'iPlanlama 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 FieldName ve Colors 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" />

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

  • Last updated on