Compartilhar via

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

  • Artigo

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

Com extensões, você pode adicionar funcionalidade avançada aos seus formulários de item de trabalho. Uma extensão vem em quatro sabores, ou tipos de contribuição. Os controles a seguir aparecem no layout do formulário da Web para todos os tipos de item de trabalho (WITs) herdados e personalizáveis:

  • Contribuição em nível de campo (controles personalizados)
  • Contribuição a nível de grupo
  • Contribuição em nível de página

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

Importante

O modelo de processo de herança está disponível para projetos configurados para suportá-lo. Se você estiver usando uma coleção mais antiga, verifique a compatibilidade do modelo de processo. Se sua coleção local estiver configurada para usar o modelo de processo XML local, você só poderá usar esse modelo de processo para personalizar a experiência de controle de trabalho. Para obter mais informações, consulte Escolher o modelo de processo para sua coleção de projetos.

Você adiciona todas as contribuições instalando sua extensão do Visual Studio Marketplace, guia Azure DevOps. Ou, você pode criar seu próprio controle personalizado.

Por exemplo, você pode adicionar a extensão Quem visualizou um item de trabalho recentemente?. Essa contribuição em nível de grupo aparece no formulário de item de trabalho, conforme mostrado.

Formulário de item de trabalho, exemplo de extensão de grupo, Quem visualizou isso

Pré-requisitos

Recomendamos verificar Configurar e personalizar os Quadros do Azure, que oferece orientação sobre como personalizar os Quadros do Azure para se alinharem aos seus requisitos de negócios específicos.

Para adicionar extensões ou editar um processo, você deve ser membro do grupo Administradores da Coleção de Projetos ou receber permissões explícitas para editar um processo específico.

Abra o processo de > configurações

  1. Entre em sua organização (https://dev.azure.com/{yourorganization}).

  2. Selecione ícone de engrenagem Configurações da organização.

    Captura de tela mostrando o botão de configurações da organização realçado.

  3. Selecione Processar.

    Captura de tela mostrando o botão Processo realçado para seleção.

  1. Entre na sua coleção (https://dev.azure.com/{Your_Collection}).

  2. Selecione Configurações de coleção ou Configurações de administrador.

  3. Selecione Processar.

    Captura de tela mostrando o botão Processo realçado nas configurações da Coleção.

Observação

Quando você personaliza um processo herdado, todos os projetos que usam esse processo refletem automaticamente as personalizações. Para garantir uma transição suave, recomendamos a criação de um processo de teste e um projeto, que permite testar suas personalizações antes de implementá-las em toda a organização. Para obter mais informações, consulte Criar e gerenciar processos herdados.

Revise as extensões instaladas do Marketplace

No contexto Configurações , Extensões, você pode exibir as extensões que já estão instaladas. Talvez seja necessário optar por Atualizar atualizar a página para mostrar as extensões recém-instaladas.

Configurações da organização, página Extensões

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

Adicionar uma extensão do Marketplace

Você pode navegar no Marketplace para determinar qual(is) extensão(ões) deseja adicionar.

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

    Processo, WIT, Bug, Layout, Obter extensões

  2. Selecione a extensão que deseja adicionar. Aqui escolhemos a lista de verificação do item Trabalho.

  3. Selecione a organização à qual você deseja adicioná-lo e escolha Instalar.

    Visual Studio Marketplace, instalar extensão

    Importante

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

  4. Retorne ao processo e ao WIT e verifique se o local da extensão está onde você deseja. Procure-o na parte inferior da coluna do meio e arraste-o para onde você deseja que ele esteja no formulário.

    Extensão de grupo no formulário de item de trabalho Bug

Adicionar uma contribuição em nível de campo ou um controle personalizado

  1. Instale o controle personalizado conforme discutido na seção anterior.

  2. Abra o Processo de Trabalho>de Configurações>em um formulário de item de trabalho. Para obter detalhes, consulte Abrir processo de configurações>.

  3. (Opcional) Adicione um campo para associar ao controle personalizado. Como alternativa, você pode especificar um campo existente, herdado ou personalizado.

  4. Com o WIT selecionado, escolha Adicionar controle personalizado.

    Processo, WIT, Bug, Layout, Novo controle personalizado

    Observação

    Se você não vir a opção Adicionar controle personalizado, não instalou uma extensão no nível de campo. Ou, talvez seja necessário atualizar o navegador para fazer com que ele registre novas extensões que foram instaladas recentemente.

  5. Escolha o controle personalizado desejado no menu de opções.

    Por exemplo, aqui escolhemos o controle Toggle que você pode associar a um campo booleano.

    Adicionar uma caixa de diálogo de controle personalizada, guia Definição

  6. Escolha a guia Opções e preencha a caixa de diálogo. As opções que você precisa especificar dependem do controle personalizado selecionado.

    Por exemplo, aqui especificamos o campo personalizado, Triado, e indicamos os rótulos de alternância a serem exibidos no formulário.

    Caixa de diálogo de controle personalizado

  7. (Opcional) Abra a guia Layout e especifique o rótulo do campo.

    Preencha todos os campos adicionais obrigatórios. Revise a descrição da extensão para obter orientação.

  8. Verifique o funcionamento do controle personalizado abrindo um item de trabalho do tipo modificado. Talvez seja necessário atualizar o navegador para ver as alterações.

    Aqui, mostramos como o controle aparece por padrão com a caixa de seleção e, em seguida, com o controle de alternância.

Campo booleano com caixa de seleção

Campo booleano com controle de alternância

Campo booleano com caixa de seleção

Campo booleano com controle de alternância

Contribuições em nível de grupo e de página

Quando você adiciona contribuições em nível de grupo e em nível de página, elas são automaticamente adicionadas a todos os WITs definidos para todos os processos, tanto herdados quanto personalizados. Você pode optar por ocultar a exibição dessas contribuições no formulário de um WIT específico ou movê-lo dentro do formulário a partir do local padrão.

Se você instalou uma contribuição de grupo ou página, atualize o navegador e abra um item de trabalho para exibir o posicionamento da contribuição no formulário. Para mover ou ocultar a contribuição, siga as orientações fornecidas para a guia Layout.

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

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

Por exemplo, a imagem a seguir mostra que nove contribuições de nível de ação foram adicionadas e aparecem no menu de contexto da história do usuário.

Formulário da Web de história do usuário, menu de contexto, opções de nível de ação

Adicionar controles personalizados programaticamente

Você pode usar essas APIs REST para trabalhar com extensões:

Observação

Revise as alterações feitas em um processo herdado por meio do log de auditoria. Para obter mais informações, consulte Acessar logs de auditoria de filtro.