Pontos de extensibilidade

  • Artigo

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

As extensões aprimoram a experiência do usuário do Azure DevOps contribuindo com novos recursos. Neste artigo, destacamos os pontos de extensibilidade mais comuns que sua extensão pode segmentar. Para obter mais informações sobre o modelo de extensibilidade do Azure DevOps, consulte o Modelo de contribuição.

A extensão do Guia de Contribuições é uma extensão de exemplo. Instale esta extensão na sua organização. Depois de instalado, você verá os pontos de extensibilidade disponíveis. Recomendamos que você instale essa extensão em uma organização pessoal ou de teste. A fonte para esta extensão também está disponível.

Para obter mais informações, veja as seguintes referências:

Hubs e grupos de hubs

Hubs e grupos de hubs são os principais elementos de navegação no Azure DevOps. Arquivos, Versões, Listas de pendências e Consultas são exemplos de hubs. Um hub pertence a um grupo de hubs. O hub Arquivos, por exemplo, pertence ao grupo de hub Azure Repos no nível do projeto. Os grupos de hub podem existir no nível da organização ou da coleção ou no nível do projeto. A maioria das extensões contribui para o nível do projeto.

A tabela a seguir descreve os grupos de hub mais comuns no Azure DevOps para os quais você pode contribuir com hubs.

Nome ID Level Imagem de pré-visualização
Azure Boards ms.vss-work-web.work-hub-group Projeto/equipa Hub personalizado adicionado aos Painéis do Azure.
Repositórios do Azure ms.vss-code-web.code-hub-group Projeto/equipa Hub personalizado adicionado ao Azure Repos.
Azure Pipelines ms.vss-build-web.build-release-hub-group Projeto/equipa Hub personalizado adicionado ao Azure Pipelines.
Planos de Teste do Azure ms.vss-test-web.test-hub-group Projeto/equipa Hub personalizado adicionado aos Planos de Teste do Azure.
Definições do projeto ms.vss-web.project-admin-hub-group Project Hub de administração do projeto personalizado.
Definições da organização ms.vss-web.collection-admin-hub-group Organização ou recolha Hub de administração da organização personalizada.

Exemplo

O exemplo a seguir mostra como contribuir com um hub para o grupo de hub de código:

{
    ...
    "contributions": [
        {
            "id": "my-custom-hub",
            "type": "ms.vss-web.hub",
            "targets": [
                "ms.vss-code-web.code-hub-group"
            ],
            "properties": {
                "name": "Code Hub",
                "order": 30,
                "uri": "/views/code/custom.html"
            }
        }
    ]
}
  • ms.vss-web.hub é o tipo desta contribuição. Este tipo é definido na vss-web extensão publicada sob o ms editor. Esse tipo declara propriedades opcionais e necessárias que são exigidas por contribuições desse tipo (por exemplo, nome, ordem e assim por diante).
  • ms.vss-code-web.code-hub-group é o ID completo da contribuição do grupo de hub que este hub está direcionando. Esta contribuição é declarada na vss-code-web extensão publicada sob a editora ms
  • my-custom-hub é o ID abreviado desta contribuição; {publisherId}.{extensionId}.my-custom-hub é o ID completo

Adicionar um ícone ao menu ou barra de ferramentas

Adicione uma propriedade icon, para que ela possa ser usada diretamente pelo nome.

Recomendamos que forneça o seu próprio ícone. Usando seu próprio exemplo de ícone:

           "name": "Sample hub",
           "uri": "dist/Hub/Hub.html",
           "icon": "asset://static/sample-icon.png",
           "supportsMobile": true
       }

Usando o exemplo de ícones de malha da interface do usuário do Office:

            "iconName": "Code",
            "name": "Code Hub",
            "order": 30,
            "uri": "/views/code/custom.html"
        }

Configurações para menus e barras de ferramentas

Nome ID de destino
Barra de ferramentas de visão geral da organização/coleção ms.vss-admin-web.collection-overview-toolbar-menu
Grade de projetos de visão geral da coleção ms.vss-admin-web.projects-grid-menu
Barra de ferramentas de visão geral do projeto ms.vss-admin-web.project-overview-toolbar-menu
Grelha das equipas de visão geral do projeto ms.vss-admin-web.teams-grid-menu

Menu e barra de ferramentas Azure Boards

Nome ID de destino Imagem de pré-visualização
Menu de consulta de item de trabalho ms.vss-work-web.work-item-query-menu Ação de consulta personalizada adicionada ao menu de consulta.
Menu da barra de ferramentas de resultados da consulta de item de trabalho ms.vss-work-web.work-item-query-results-toolbar-menu Ação do menu personalizado da barra de ferramentas Resultados da Consulta
Item de menu de resultados da consulta de item de trabalho ms.vss-work-web.query-result-work-item-menu Ação personalizada do Menu Item de Resultado da Consulta.
Guia Resultados da consulta de item de trabalho ms.vss-work-web.query-tabs Guia pivô personalizado da barra de ferramentas de consulta
Item de trabalho para o menu de contexto ms.vss-work-web.work-item-toolbar-menu Ações personalizadas da barra de ferramentas do item de trabalho.
Menu de itens da lista de pendências ms.vss-work-web.backlog-item-menu Ações de item de lista de pendências, opções de menu personalizadas.
Menu de filtro pivô da placa de sprint ms.vss-work-web.sprint-board-pivot-filter-menu Menu de filtro pivô da placa de sprint
Menu de filtro pivô da placa ms.vss-work-web.backlog-board-pivot-filter-menu Ações de filtro pivô da placa de backlog.
Menu de cartões ms.vss-work-web.backlog-board-card-item-menu
Guia Lista de pendências do produto ms.vss-work-web.product-backlog-tabs Captura de ecrã do separador personalizado Backlog do produto.
Guia Lista de pendências de iteração ms.vss-work-web.iteration-backlog-tabs Captura de ecrã do separador personalizado do backlog de iterações.
Painel de lista de pendências do portfólio ms.vss-work-web.portfolio-backlog-toolpane Captura de ecrã do Painel Personalizado da Lista de pendências do Portfólio.
Painel de lista de pendências do produto ms.vss-work-web.requirement-backlog-toolpane Captura de ecrã do Painel Personalizado da Lista de pendências do produto.
Painel de lista de pendências de iteração ms.vss-work-web.iteration-backlog-toolpane Captura de ecrã do Painel Personalizado do Backlog de Iteração.

Menu e barra de ferramentas do Azure Pipelines

Nome ID de destino Pré-visualizar
Menu de compilação concluída ms.vss-build-web.completed-build-menu Ações de compilação concluídas
Menu Definições de compilação ms.vss-build-web.build-definition-menu Ações de definição de compilação
Ação da barra de ferramentas de resultados de teste ms.vss-test-web.test-results-actions-menu Ação da barra de ferramentas Resultados do teste
Guia de detalhes do resultado do teste ms.vss-test-web.test-result-details-tab-items Guia Detalhes do Resultado do Teste
Liberar menu de contexto do explorador de pipeline ms.vss-releaseManagement-web.release-definition-explorer-context-menu Menu de contexto do Definition Explorer
Liberar menu da barra de ferramentas do explorador de pipeline ms.vss-releaseManagement-web.release-definition-explorer-toolbar-menu Menu da barra de ferramentas do Gerenciador de definições
Menu da barra de ferramentas Resumo da versão ms.vss-releaseManagement-web.release-editor-tool-bar-menu Menu da barra de ferramentas Resumo da versão
Guia Resumo da versão ms.vss-releaseManagement-web.release-details-view Guia Resumo da versão
Seção de resumo da versão ms.vss-releaseManagement-web.release-details-summary-tab Seção de resumo da versão

Menu e barra de ferramentas do Azure Pipelines

Nome ID de destino Pré-visualizar
Menu de compilação concluída ms.vss-build-web.completed-build-menu Ações de compilação concluídas
Ação da barra de ferramentas de resultados de teste ms.vss-test-web.test-results-actions-menu Ação da barra de ferramentas Resultados do teste
Guia de detalhes do resultado do teste ms.vss-test-web.test-result-details-tab-items Guia Detalhes do Resultado do Teste
Liberar menu de contexto do explorador de pipeline ms.vss-releaseManagement-web.release-definition-explorer-context-menu Menu de contexto do Definition Explorer
Visualização de detalhes do pipeline, botão de cabeçalho ms.vss-build-web.pipelines-header-menu Visualização de detalhes do pipeline, menu de cabeçalho
Visualização de detalhes do pipeline, menu de contexto da pasta ms.vss-build-web.pipelines-folder-menu Visualização de detalhes do pipeline, menu de contexto da pasta

Tarefas do Azure Pipelines

As tarefas executam o trabalho em uma compilação ou versão. Para obter mais informações, saiba como contribuir com uma tarefa de compilação ou lançamento.

Menu e barra de ferramentas do Azure Repos

Nome ID de destino Imagem de pré-visualização
Menu do item de origem (grade) ms.vss-code-web.source-grid-item-menu Ações da grade de itens de recompra
Menu do item de origem (árvore) ms.vss-code-web.source-tree-item-menu Ações da árvore de itens de repositório
Menu do item de origem (grade e árvore) ms.vss-code-web.source-item-menu Ações do item de recompra
Alterar menu de item de lista ms.vss-code-web.change-list-item-menu
Alterar menu de item de resumo da lista ms.vss-code-web.change-list-summary-item-menu
Menu da árvore de ramos do Git ms.vss-code-web.git-branches-tree-menu Árvore de ramos Git
Menu de ações de solicitação pull do Git ms.vss-code-web.pull-request-action-menu Ações de solicitação pull do Git
Guias de solicitação pull do Git (pivôs) ms.vss-code-web.pr-tabs Guia Git Pull Request
Menu de listagem de confirmação do Git ms.vss-code-web.git-commit-list-menu Menu Lista de Confirmação do Git
Menu de detalhes de confirmação do Git ms.vss-code-web.git-commit-details-menu Menu de detalhes do Git Commit

Menu e barra de ferramentas Planos de Teste do Azure

Nome ID de destino Imagem de pré-visualização
Menu de grade de execução de teste ms.vss-test-web.test-run-grid-menu Menu de grade de execução de teste
Menu de árvore de pacotes de planos de teste ms.vss-test-web.test-plans-suites-context Contexto dos pacotes de planos de teste
Guia pivô do hub do plano de teste ms.vss-test-web.test-plan-pivot-tabs Guia do pivô do hub de teste

Outros pontos de extensibilidade

  • Widget de painel: uma extensão pode contribuir com um novo tipo de widget que pode ser adicionado pelos usuários a um painel. Saiba como contribuir com um widget de painel.
  • Formulário de item de trabalho: o formulário de item de trabalho é aprimorado por extensões com novas seções, guias, ações e renderizadores de campo personalizados. Para obter mais informações, saiba como estender o formulário de item de trabalho.
  • Ganchos de serviço: um "consumidor" é o serviço para o qual os eventos são enviados nos ganchos de serviço. Uma extensão pode contribuir com serviços ao consumidor. Esses serviços são configurados por um usuário (ou programaticamente) para enviar eventos para esse serviço. Para obter mais informações, consulte Contribuir com um consumidor de ganchos de serviço.
  • Funcionalidades:

Nome: Funcionalidade de pré-visualização (apenas alojado)
ID de destino: ms.vss-web.managed-features

Nome: Recurso (somente local)
ID de destino: ms.vss-web.managed-features-onprem