Condividi tramite

Aggiungere estensioni nel modulo dell'elemento di lavoro tramite xml definizione del tipo di elemento di lavoro

  • Articolo

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

È possibile esportare un tipo di elemento di lavoro come xml usando lo strumento witadmin, che include il layout del modulo dell'elemento di lavoro. Come parte di questo esempio, si aggiungono i contributi di pagina, gruppo e controllo al layout. Aggiungiamo anche il controllo al tipo di elemento di lavoro Agile "User Story". Per ulteriori informazioni, consulta il riferimento xml WebLayout .

Nota

La personalizzazione dei moduli degli elementi di lavoro tramite xml è supportata solo in Azure DevOps Server e non in Azure DevOps Services.

Aggiungere l'estensione nel modulo dell'elemento di lavoro

  1. Installare le estensioni del modulo degli elementi di lavoro in Azure DevOps Server.

  2. Aprire il Developer Command Prompt. Esportare il file XML sul desktop con il comando seguente.

    witadmin exportwitd /collection:CollectionURL /p:Project /n:TypeName /f:FileName

    Un file viene creato nella directory specificata.

  3. All'interno di questo file, vai alla sezione WebLayout. All'interno della sezione WebLayout, un insieme di commenti indica quali estensioni installate sono destinate ai moduli degli elementi di lavoro per la raccolta. Per ogni estensione, tutti i contributi del modulo sono elencati con gli ID e gli input (se si tratta di un contributo di controllo). Nell'esempio seguente, il commento mostra l'estensione color-control-dev installata sulla raccolta. L'estensione ha un contributo di controllo che accetta due 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. Trova il tuo ID estensione nella sezione estensioni dell'elemento di lavoro:

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

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

  5. Aggiungere un tag di estensione sotto la sezione estensioni degli elementi di lavoro, come illustrato di seguito, per rendere disponibile l'estensione nel modulo dell'elemento di lavoro. Per inserire un contributo all'interno del modulo, è necessario specificarne l'estensione nella sezione 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. Specificando le estensioni nel file xml, vengono automaticamente collocate sia le pagine sia i contributi di gruppo definiti nelle estensioni all'interno del modulo. È possibile spostare i contributi negli esempi seguenti.

Aggiungere un contributo alla pagina

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

Aggiungere un contributo al gruppo

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

Un contributo di pagina e un contributo di gruppo non possono accettare altri elementi di layout.

Aggiungere un contributo di controllo

A differenza dei contributi di pagina e del gruppo , specificare le estensioni nel codice XML non inserisce automaticamente i contributi di controllo . Per aggiungere questi contributi nel modulo, aggiungerli con un tag di contributo all'interno del modulo. Nell'esempio seguente, il ControlContribution viene aggiunto al gruppo Planning.

Se un contributo di controllo ha un input necessario definito, gli utenti devono assegnare un valore per tale input. Per qualsiasi input non richiesto, gli utenti possono decidere se impostare un valore sull'input. Nell'esempio seguente vengono impostati gli input FieldName e Colors.

    <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. Importare questo file XML usando witadmin.

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

L'estensione viene configurata tramite il modulo dell'elemento di lavoro.