Extensies toevoegen in werkitemformulier via definitie-xml van het type werkitem

Artikel
04/04/2024

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

U kunt een werkitemtype exporteren als XML met behulp van het witadmin hulpprogramma, dat de indeling van het werkitemformulier bevat. Als onderdeel van dit voorbeeld voegen we de bijdragen aan de pagina, groep en controle toe aan de indeling. We voegen ook het besturingselement toe aan het werkitemtype Agile User Story. Zie weblayout xml-verwijzing voor meer informatie.

Notitie

Aanpassing van werkitemsformulieren via XML wordt alleen ondersteund op Azure DevOps Server, niet op Azure DevOps Services.

Extensie toevoegen in werkitemformulier

Installeer formulierextensies voor werkitems in Azure DevOps Server.
Open het Developer Command Prompt. Exporteer het XML-bestand naar uw bureaublad met de volgende opdracht.
```
witadmin exportwitd /collection:CollectionURL /p:Project /n:TypeName /f:FileName
```
Er wordt een bestand gemaakt in de map die u hebt opgegeven.

Ga in dit bestand naar de sectie WebLayout . In de sectie WebLayout geeft een opmerking-blob aan welke geïnstalleerde extensies gericht zijn op werkitemformulieren voor uw verzameling. Voor elke extensie worden alle bijbehorende formulierbijdragen weergegeven met hun id's en invoer (als dit een Bijdrage van het besturingselement is). In het volgende voorbeeld toont de opmerking de color-control-dev-extensie die op de verzameling is geïnstalleerd. De extensie heeft één besturingselementbijdrage die twee invoer heeft.

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

Zoek uw extensie-id in de sectie Werkitemextensies :

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

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

Voeg een extensietag toe onder de sectie Werkitemextensies , die als volgt wordt weergegeven, om uw extensie beschikbaar te maken voor het werkitemformulier. Als u een bijdrage in het formulier wilt plaatsen, moet de uitbreiding ervan worden opgegeven in de Extensions sectie.

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

Als u de extensies in de XML opgeeft, worden zowel de pagina - als groepsbijdragen die in de extensies in het formulier zijn gedefinieerd, automatisch geplaatst. U kunt de bijdragen in de volgende voorbeelden verplaatsen.

Paginabijdrage toevoegen

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

Groepsbijdrage toevoegen

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

Een paginabijdrage en een groepsbijdrage kunnen geen andere indelingselementen bevatten.

Besturingselementbijdrage toevoegen

In tegenstelling tot bijdragen aan pagina's en groepen, worden met het opgeven van de extensies in de XML niet automatisch controlebijdragen geplaatst. Als u deze bijdragen in het formulier wilt toevoegen, voegt u deze toe met een bijdragetag in het formulier. In het volgende voorbeeld wordt ControlContribution toegevoegd aan de groep Planning.

Als voor een bijdrage van een besturingselement een vereiste invoer is gedefinieerd, moeten gebruikers een waarde voor die invoer geven. Voor niet-vereiste invoer kunnen gebruikers bepalen of ze een waarde moeten instellen op de invoer. In het volgende voorbeeld worden de FieldName en Colors invoer ingesteld.

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

Importeer dit XML-bestand met behulp van witadmin.

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

Uw extensie is geconfigureerd via het werkitemformulier.

Share via