Adicionar extensões e controlos personalizados a um tipo de item de trabalho (Processo de herança)

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

Com as extensões, pode adicionar funcionalidades avançadas aos seus formulários de itens de trabalho. Uma extensão tem quatro tipos de sabor ou de contribuição. Os seguintes controlos são apresentados no esquema de formulário Web para todos os tipos de itens de trabalho (WITs) herdados e personalizáveis:

• Contribuição ao nível do campo (controlos personalizados)
• Contribuição ao nível do grupo
• Contribuição ao nível da página

O quarto tipo, contribuições ao nível da ação, por outro lado, aparecem no menu de contexto do formulário Web.

Importante

Este artigo aplica-se aos Serviços do Azure DevOps e Azure DevOps Server 2019 e versões posteriores. Para personalizar qualquer projeto definido numa coleção para o TFS 2018 ou anterior, veja Modelo de processo XML no local.

Pode adicionar todas as contribuições ao instalar a extensão a partir do Visual Studio Marketplace, separador Azure DevOps. Em alternativa, pode criar o seu próprio controlo personalizado.

Por exemplo, pode adicionar a extensão Quem viu recentemente um item de trabalho? Esta contribuição ao nível do grupo aparece no seu formulário de item de trabalho, conforme mostrado.

Pré-requisitos

Antes de personalizar um processo, recomendamos que reveja Configurar e personalizar o Azure Boards, que fornece orientações sobre como personalizar os Quadros do Azure para satisfazer as suas necessidades empresariais. Para obter uma descrição dos diferentes atrasos e quadros, consulte Tarefas suportadas por Atrasos, Quadros, Quadros de Tarefas e Planos.

• Tem de ter uma organização criada nos Serviços do Azure DevOps. Se ainda não criou um, faça-o agora.
• Para criar, editar e gerir processos, tem de ser membro do grupo Administradores da Coleção de Projetos ou ter as permissões ao nível da coleção correspondentes: Criar processo, Eliminar processo, Editar processo ou Eliminar um campo da organização definido como Permitir. Veja Definir permissões e acesso para controlo de trabalho, Personalizar um processo herdado.

Para adicionar extensões ou editar um processo, tem de ser membro do grupo Administradores da Coleção de Projetos ou ser-lhe concedidas permissões explícitas para editar um processo específico.

Abrir Processo de Definições>

Pode criar, gerir e efetuar personalizações a processos a partir do Processo de definições>da Organização.

1. Escolha o logótipo do Azure DevOps para abrir Projetos. Em seguida, selecione Definições da organização.

   

2. Em seguida, selecione Processo.

   

   Importante

   Se não vir Processo, significa que está a trabalhar a partir do TFS-2018 ou versão anterior. A página Processo não é suportada. Tem de utilizar as funcionalidades suportadas para o modelo de processo XML no local.

Nota

À medida que personaliza um processo herdado, todos os projetos que utilizam esse processo são atualizados automaticamente para refletir as personalizações. Por este motivo, recomendamos que crie um processo de teste e teste o projeto quando tiver várias personalizações a efetuar para testar as personalizações antes de as implementar na sua organização. Para saber mais, veja Criar e gerir processos herdados.

Rever as extensões do Marketplace instaladas

No contexto Definições , Extensões, pode ver as extensões que já estão instaladas. Poderá ter de selecionar para atualizar a página para mostrar as extensões recentemente instaladas.

Para saber mais sobre extensões, veja Instalar extensões gratuitas.

Adicionar uma extensão do Marketplace

Pode navegar no Marketplace para determinar que extensões pretende adicionar.

1. Para adicionar uma extensão a um tipo de item de trabalho, escolha o seu processo herdado, o WIT e, em seguida, selecione Obter extensões.

   

2. Selecione a extensão que pretende adicionar. Aqui, selecionamos a lista de verificação Item de trabalho.

3. Selecione a organização à qual pretende adicioná-la e selecione Instalar.

   

   Importante

   As extensões que instalar são adicionadas a todos os WITs em todos os processos.

4. Regresse ao processo e ao WIT e verifique se a localização da extensão é a localização pretendida. Procure-a na parte inferior da coluna do meio e arraste-a para onde pretender no formulário.

   

Adicionar uma contribuição ao nível do campo ou um controlo personalizado

1. Instale o controlo personalizado , conforme abordado na secção anterior.

2. Abra o Processo de Trabalho>das Definições> a partir de um formulário de item de trabalho. Para obter detalhes, consulte Abrir Processo de Definições>.

3. (Opcional) Adicione um campo para associar ao controlo personalizado. Em alternativa, pode especificar um campo existente, herdado ou personalizado.

4. Com o WIT selecionado, selecione Adicionar controlo personalizado.

   

   Nota

   Se não vir a opção Adicionar controlo personalizado , significa que não instalou uma extensão ao nível do campo. Em alternativa, poderá ter de atualizar o browser para que o browser registe quaisquer novas extensões que tenham sido instaladas recentemente.

5. Selecione o controlo personalizado que pretende no menu de opções.

   Por exemplo, aqui, selecionamos o controlo Alternar que pode associar a um campo Booleano.

   

6. Selecione o separador Opções e preencha a caixa de diálogo. As opções que precisa de especificar dependem do controlo personalizado que selecionou.

   Por exemplo, aqui especificamos o campo personalizado Triaged e indicamos as etiquetas de alternar a aparecer no formulário.

   

7. (Opcional) Abra o separador Esquema e especifique a etiqueta para o campo.

   Preencha todos os campos necessários adicionais. Reveja a descrição da extensão para obter orientações.

8. Verifique o funcionamento do controlo personalizado ao abrir um item de trabalho do tipo que modificou. Poderá ter de atualizar o browser para ver as alterações.

   Aqui, mostramos como o controlo é apresentado por predefinição com a caixa de verificação e, em seguida, com o controlo de alternar.

Campo booleano com caixa de verificação

Campo booleano com controlo de alternar

Contribuições ao nível do grupo e ao nível da página

Quando adiciona contribuições ao nível do grupo e ao nível da página, estas são automaticamente adicionadas a todos os WITs definidos para todos os processos, tanto herdados como personalizados. Pode optar por ocultar a apresentação destas contribuições no formulário de um WIT específico ou movê-las para dentro do formulário a partir da localização predefinida.

Se tiver instalado uma contribuição de grupo ou página, atualize o browser e, em seguida, abra um item de trabalho para ver o posicionamento da contribuição no formulário. Para mover ou ocultar a contribuição, siga as orientações fornecidas para o separador Esquema.

Contribuições ao nível da ação

As contribuições ao nível da ação são adicionadas ao menu de contexto de WITs herdados e personalizáveis para o sistema e os processos herdados. Todas as contribuições ao nível da ação são adicionadas a todos os tipos de itens de trabalho e não podem ser ocultadas ou removidas sem desinstalar ou desativar a extensão.

Por exemplo, a imagem seguinte mostra que foram adicionadas nove contribuições ao nível da ação e apresentadas no menu de contexto da história do utilizador.

Adicionar controlos personalizados programaticamente

Pode utilizar estas APIs REST para trabalhar com extensões:

• Expandir o formulário do item de trabalho
• Adicionar um controlo personalizado ao formulário de item de trabalho

Artigos relacionados

Nota

Pode rever as alterações efetuadas a um processo herdado através do registo de auditoria. Para saber mais, veja Aceder, exportar e filtrar registos de auditoria.

• Adicionar um campo personalizado a um tipo de item de trabalho
• Personalizar um tipo de item de trabalho
• Personalizar o esquema Web
• Personalizar um projeto com um processo herdado