Compartilhar via


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

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022

Este artigo explica como adicionar funcionalidade avançada aos formulários de item de trabalho usando extensões. Uma extensão está disponível em quatro tipos de contribuição. Os controles a seguir são exibidos no layout do formulário da Web para todos os WITs (tipos de item de trabalho) herdados e personalizáveis:

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

Por outro lado, o quarto tipo, contribuições em nível de ação, é exibido no menu de contexto do formulário da web.

Importante

O modelo de processo de herança está disponível para projetos configurados para dar suporte ao tipo de modelo. Se você usar 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 acompanhamento de trabalho. Para obter mais informações, consulte a personalização do processo no nível da organização.

Adicione 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 viu recentemente um item de trabalho? Essa contribuição em nível de grupo é exibida no formulário de item de trabalho, conforme mostrado.

Captura de tela do formulário de item de trabalho, exemplo de extensão de grupo, Quem visualizou isso.

Pré-requisitos

Para obter diretrizes sobre como personalizar os Conselhos do Azure para se alinharem aos seus requisitos de negócios específicos, consulte Configurar e personalizar os Quadros do Azure.

Categoria Requisitos
Permissões – Para criar, excluir ou editar um processo: membro do grupo Administradores de Coleção de Projetos ou permissões específicas no nível da coleção: Criar processo, Excluir processo, Editar processo, ou Excluir um campo da organização configurado para Permitir. Para obter mais informações, consulte Personalizar um processo herdado.
– Para atualizar os painéis: Administrador da equipe ou um membro do grupo de Administradores do projeto.
Access - Mesmo que você tenha acesso Básico ou inferior, ainda poderá alterar um processo se alguém lhe der permissão.
- Para atualizar e alterar os tipos de itens de seus trabalhos existentes: Membro do projeto.
Modelo de processo do projeto - É preciso ter o Modelo de processo de herança para a coleção de projetos que contém o projeto.
– Para migrar dados para o Azure DevOps Services, use o Serviço de Importação de Banco de Dados do Team Foundation Server.
Conhecimento - Familiaridade com os modelos de personalização e processo.

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

Abrir as configurações do processo da organização

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

  2. Selecione Configurações da organização.

    Captura de tela mostrando o botão Configurações da organização para seleção.

  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 o processo refletem automaticamente as personalizações. Para garantir uma transição tranquila, recomendamos que você crie um processo de teste e um projeto para testar suas personalizações antes de implementá-las em toda a organização. Para saber mais, consulte Criar e gerenciar processos herdados.

Examinar as extensões do Marketplace instaladas

No contexto Configurações , na guia Extensões , você pode exibir as extensões que já estão instaladas. Talvez seja necessário selecionar Atualizar para mostrar extensões recém-instaladas.

Captura de tela das configurações da organização, página Extensões.

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

Adicionar uma extensão do Marketplace

Você pode navegar pelo Marketplace para determinar quais extensões deseja adicionar.

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

    Captura de tela das extensões Processo, WIT, Bug, Layout, Obter.

  2. Selecione a extensão que você deseja adicionar. Aqui, escolhemos a lista de verificação de item de trabalho.

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

    Captura de tela do Visual Studio Marketplace, extensão de instalação.

    Importante

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

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

    Captura de tela da extensão Grupo no formulário do item de trabalho do 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 oProcesso de> de > de um formulário de item de trabalho. Para obter detalhes, consulte Abrir as configurações de processo da organização.

  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 um controle personalizado.

    Captura de tela de Processo, WIT, Bug, Layout, Adicionar controle personalizado.

    Observação

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

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

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

    Captura de tela da caixa de diálogo Adicionar um controle personalizado, 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, Triagem e indicamos os rótulos de alternância a serem exibidos no formulário.

    Captura de tela da caixa de diálogo Controle personalizado.

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

    Preencha todos os outros campos necessários. Examine a descrição da extensão para obter diretrizes.

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

    Aqui, mostramos como o controle é exibido 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

    Captura de tela do campo booliano com a caixa de seleção.

    Captura de tela do campo booliano com controle de alternância.

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

Quando você adiciona contribuições de nível de grupo e de nível de página , elas são adicionadas automaticamente a todos os WITs definidos para todos os processos, herdados e personalizados. Você pode optar por ocultar essas contribuições de aparecerem no formulário para um WIT específico ou movê-las 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, consulte Personalizar o layout da Web para um tipo de item de trabalho.

Contribuições em nível de ação

As contribuições em nível de ação são adicionadas ao menu de contexto de WITs herdados e personalizáveis para processos herdados e de sistema. Todas as contribuições de 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.

Captura de tela do formulário da Web da história do usuário, menu de contexto, opções no nível da ação.

Adicionar controles personalizados de maneira programática

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

Observação

Você pode examinar as alterações feitas em um processo herdado usando o log de auditoria e os recursos de auditoria. Para obter mais informações, consulte Acessar, exportar e filtrar logs de auditoria.