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 ter como destino. 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 essa extensão em 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. Além disso, encontre um exemplo de um ponto de extensão de criação de repositório aqui.

Para obter mais informações, consulte 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, Pendências e Consultas são exemplos de hubs. Um hub pertence a um grupo de hubs. O hub de arquivos, por exemplo, pertence ao grupo de hubs 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 hubs mais comuns no Azure DevOps para os quais você pode contribuir com hubs.

Nome ID Nível Visualizar a imagem
Azure Boards ms.vss-work-web.work-hub-group Projeto/equipe Hub personalizado adicionado a Azure Boards.
Azure Repos ms.vss-code-web.code-hub-group Projeto/equipe Hub personalizado adicionado aos Repositórios do Azure.
Azure Pipelines ms.vss-build-web.build-release-hub-group Projeto/equipe Hub personalizado adicionado ao Azure Pipelines.
Azure Test Plans ms.vss-test-web.test-hub-group Projeto/equipe Hub personalizado adicionado aos Planos de Teste do Azure.
Configurações de projeto ms.vss-web.project-admin-hub-group Project Hub de administração de projeto personalizado.
Configurações da organização ms.vss-web.collection-admin-hub-group Organização ou coleção Hub de administração da organização personalizada.

Exemplo

O exemplo a seguir mostra como contribuir com um hub para o grupo de hubs 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 dessa contribuição. Esse tipo é definido na vss-web extensão publicada no ms editor. Esse tipo declara propriedades opcionais e obrigató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 é a ID completa da contribuição do grupo de hubs que este hub está direcionando. Esta contribuição é declarada vss-code-web na 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 de ícone, para que ela possa ser usada diretamente pelo nome.

Recomendamos fornecer 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 do Office UI Fabric:

            "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
Grade de equipes de visão geral do projeto ms.vss-admin-web.teams-grid-menu

Menu e barra de ferramentas do Azure Boards

Nome ID de destino Visualizar a imagem
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 de menu da barra de ferramentas personalizada Resultados da consulta
Item de menu Resultados da consulta de item de trabalho ms.vss-work-web.query-result-work-item-menu Ação personalizada do menu do item de resultado da consulta.
Guia Resultados da consulta de item de trabalho ms.vss-work-web.query-tabs Guia dinâmica personalizada da barra de ferramentas de consulta
Item de trabalho para 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 de lista de pendências ms.vss-work-web.backlog-item-menu Opções de menu personalizadas de ações de item de lista de pendências.
Menu de filtro dinâmico do quadro de sprint ms.vss-work-web.sprint-board-pivot-filter-menu Menu de filtro dinâmico do quadro de sprint
Menu de filtro dinâmico do quadro ms.vss-work-web.backlog-board-pivot-filter-menu Ações de filtro dinâmico do quadro de pendências.
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 tela da guia personalizada do Backlog do produto.
Guia Lista de pendências de iteração ms.vss-work-web.iteration-backlog-tabs Captura de tela das iterações Backlog Custom Tab.
Painel de lista de pendências de portfólio ms.vss-work-web.portfolio-backlog-toolpane Captura de tela 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 tela do painel personalizado do Product Backlog.
Painel de lista de pendências de iteração ms.vss-work-web.iteration-backlog-toolpane Captura de tela do painel personalizado da lista de pendências de iteração.

Menu e barra de ferramentas do Azure Pipelines

Nome ID de destino Visualizar
Menu de construção concluído 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 do teste ms.vss-test-web.test-results-actions-menu Ação da barra de ferramentas Resultados do teste
Guia Detalhes do resultado do teste ms.vss-test-web.test-result-details-tab-items Guia Detalhes do resultado do teste
Menu de contexto do gerenciador de pipeline de lançamento ms.vss-releaseManagement-web.release-definition-explorer-context-menu Menu de contexto do Explorador de Definições
Menu da barra de ferramentas do gerenciador de pipeline de lançamento ms.vss-releaseManagement-web.release-definition-explorer-toolbar-menu Menu da barra de ferramentas do Explorador de Definições
Menu da barra de ferramentas de resumo da versão ms.vss-releaseManagement-web.release-editor-tool-bar-menu Menu da barra de ferramentas do 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 Visualizar
Menu de construção concluído ms.vss-build-web.completed-build-menu Ações de compilação concluídas
Ação da barra de ferramentas de resultados do teste ms.vss-test-web.test-results-actions-menu Ação da barra de ferramentas Resultados do teste
Guia Detalhes do resultado do teste ms.vss-test-web.test-result-details-tab-items Guia Detalhes do resultado do teste
Menu de contexto do gerenciador de pipeline de lançamento ms.vss-releaseManagement-web.release-definition-explorer-context-menu Menu de contexto do Explorador de Definições
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 build ou versão.

Menu e barra de ferramentas do Azure Repos

Nome ID de destino Visualizar a imagem
Menu de item de origem (grade) ms.vss-code-web.source-grid-item-menu Ações de grade de itens de repositório
Menu de item de origem (árvore) ms.vss-code-web.source-tree-item-menu Ações da árvore de itens do Repos
Menu de item de origem (grade e árvore) ms.vss-code-web.source-item-menu
Alterar menu de item de lista ms.vss-code-web.change-list-item-menu
Alterar menu de itens de resumo da lista ms.vss-code-web.change-list-summary-item-menu
Menu de árvore de ramificações do Git ms.vss-code-web.git-branches-tree-menu Árvore de ramificações do Git
Menu de ações de solicitação de pull do Git ms.vss-code-web.pull-request-action-menu Ações de solicitação de pull do Git
Guias de solicitação de pull do Git (pivôs) ms.vss-code-web.pr-tabs Guia de solicitação de pull do Git
Menu de listagem de commit do Git ms.vss-code-web.git-commit-list-menu Menu da 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 commit do Git

Menu e barra de ferramentas do Azure Test Plans

Nome ID de destino Visualizar a imagem
Menu de grade de execução de teste ms.vss-test-web.test-run-grid-menu
Menu de árvore de conjuntos de planos de teste ms.vss-test-web.test-plans-suites-context
Guia dinâmica do hub do plano de teste ms.vss-test-web.test-plan-pivot-tabs Guia Dinâmica 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.
  • Recursos:

Nome: Recurso de visualização (somente hospedado)
ID de destino: ms.vss-web.managed-features

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