Partilhar via

Adicionar extensões no formulário de item de trabalho por meio do xml de definição de tipo de item de trabalho

  • Artigo

Serviços de DevOps do Azure | Azure DevOps Server 2022 - Azure DevOps Server 2019

Você pode exportar um tipo de item de trabalho como xml usando a witadmin ferramenta, que inclui o layout do formulário de item de trabalho. Como parte deste exemplo, adicionamos as contribuições de página, grupo e controle ao layout. Também adicionamos o controle ao tipo de item de trabalho Agile "User Story". Para obter mais informações, consulte Referência xml do WebLayout.

Nota

A personalização do formulário de item de trabalho via xml é suportada apenas no Servidor de DevOps do Azure, não nos Serviços de DevOps do Azure.

Adicionar extensão no formulário de item de trabalho

  1. Instale extensões de formulário de item de trabalho no Servidor de DevOps do Azure.

  2. Abra o Developer Command Prompt. Exporte o arquivo xml para sua área de trabalho com o seguinte comando.

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

    Um arquivo é criado no diretório que você especificou.

  3. Dentro deste arquivo, vá para a seção WebLayout . Dentro da seção WebLayout, um blob de comentários especifica quais extensões instaladas destinam formulários de item de trabalho para sua coleção. Para cada extensão, todas as suas contribuições de formulário são listadas com seus IDs e entradas (se for uma contribuição de Controle). No exemplo a seguir, o comentário mostra a extensão color-control-dev instalada na coleção. A extensão tem uma contribuição de controle que leva duas entradas.

         <!--**********************************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. Encontre seu ID de extensão na seção Extensões de item de trabalho:

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

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

  5. Adicione uma tag de extensão abaixo da seção Extensões de Item de Trabalho, mostrada da seguinte forma, para disponibilizar sua extensão para o formulário de item de trabalho. Para colocar uma contribuição dentro do formulário, sua extensão deve ser especificada na Extensions seção.

         <!--**********************************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. Especificar as extensões no xml coloca automaticamente as contribuições de página e grupo definidas nas extensões dentro do formulário. Você pode mover as contribuições nos exemplos a seguir.

Adicionar contribuição de página

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

Adicionar contribuição do grupo

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

Uma contribuição de página e uma contribuição de grupo não podem ter outros elementos de layout.

Adicionar contribuição de controle

Ao contrário das contribuições de página e grupo , especificar as extensões no xml não coloca automaticamente as contribuições de controle . Para adicionar essas contribuições no formulário, adicione-as com uma tag de contribuição dentro do formulário. O exemplo a seguir adiciona o ControlContribution ao grupo Planning .

Se uma contribuição de controle tiver qualquer entrada necessária definida, os usuários devem fornecer um valor para essa entrada. Para qualquer entrada não necessária, os usuários podem decidir se querem definir um valor para a entrada. No exemplo a seguir, as FieldName entradas e Colors são definidas.

    <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. Importe este arquivo xml usando witadmino .

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

Sua extensão é configurada através do formulário de item de trabalho!