Pontos de extensibilidade

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:

• azure-devops-extension-api
• azure-devops-extension-sdk
• azure-devops-extension-sample
• API de extensão instalada

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
Azure Repos	ms.vss-code-web.code-hub-group	Projeto/equipe
Azure Pipelines	ms.vss-build-web.build-release-hub-group	Projeto/equipe
Azure Test Plans	ms.vss-test-web.test-hub-group	Projeto/equipe
Configurações de projeto	ms.vss-web.project-admin-hub-group	Project
Configurações da organização	ms.vss-web.collection-admin-hub-group	Organização ou coleção

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
Organização/coleção) barra de ferramentas de visão geral	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
Menu da barra de ferramentas de resultados da consulta de item de trabalho	ms.vss-work-web.work-item-query-results-toolbar-menu
Item de menu Resultados da consulta de item de trabalho	ms.vss-work-web.query-result-work-item-menu
Guia Resultados da consulta de item de trabalho	ms.vss-work-web.query-tabs
Item de trabalho para menu de contexto	ms.vss-work-web.work-item-toolbar-menu
Menu de itens de lista de pendências	ms.vss-work-web.backlog-item-menu
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	ms.vss-work-web.backlog-board-pivot-filter-menu
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
Guia Lista de pendências de iteração	ms.vss-work-web.iteration-backlog-tabs
Painel de lista de pendências de portfólio	ms.vss-work-web.portfolio-backlog-toolpane
Painel de lista de pendências do produto	ms.vss-work-web.requirement-backlog-toolpane
Painel de lista de pendências de iteração	ms.vss-work-web.iteration-backlog-toolpane

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
Menu Definições de compilação	ms.vss-build-web.build-definition-menu
Ação da barra de ferramentas de resultados do teste	ms.vss-test-web.test-results-actions-menu
Guia Detalhes do resultado do teste	ms.vss-test-web.test-result-details-tab-items
Menu de contexto do gerenciador de pipeline de lançamento	ms.vss-releaseManagement-web.release-definition-explorer-context-menu
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 de resumo da versão	ms.vss-releaseManagement-web.release-editor-tool-bar-menu
Guia Resumo da versão	ms.vss-releaseManagement-web.release-details-view
Seção de resumo da versão	ms.vss-releaseManagement-web.release-details-summary-tab
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 contexto da pasta	ms.vss-build-web.pipelines-folder-menu

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
Menu de item de origem (árvore)	ms.vss-code-web.source-tree-item-menu
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
Menu de ações de solicitação de pull do Git	ms.vss-code-web.pull-request-action-menu
Guias de solicitação de pull do Git (pivôs)	ms.vss-code-web.pr-tabs
Menu de listagem de commit do Git	ms.vss-code-web.git-commit-list-menu
Menu de detalhes de confirmação do Git	ms.vss-code-web.git-commit-details-menu

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

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