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 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 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 hub 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	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 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 dessa contribuição. Esse tipo é definido na extensão publicada sob vss-web o 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 hub que esse hub está direcionando. Esta contribuição é declarada vss-code-web na extensão publicada sob a editora ms
• my-custom-hub é o ID curto desta contribuição; {publisherId}.{extensionId}.my-custom-hub é o ID completo

Adicionar um ícone ao seu 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 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
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 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 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 o menu de contexto	ms.vss-work-web.work-item-toolbar-menu
Menu de itens da lista de pendências	ms.vss-work-web.backlog-item-menu
Menu de filtro dinâmico da placa de sprint	ms.vss-work-web.sprint-board-pivot-filter-menu
Menu do filtro dinâmico da placa	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 compilação concluído	ms.vss-build-web.completed-build-menu
Menu de definições de compilação	ms.vss-build-web.build-definition-menu
Ação da barra de ferramentas 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 explorador de pipeline de versão	ms.vss-releaseManagement-web.release-definition-explorer-context-menu
Menu da barra de ferramentas do explorador 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
Modo de exibição de detalhes do pipeline, botão de cabeçalho	ms.vss-build-web.pipelines-header-menu
Exibiçã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 compilação ou versão.

Menu e barra de ferramentas do Azure Repos

Nome	ID de destino	Visualizar a imagem
Menu item de origem (grade)	ms.vss-code-web.source-grid-item-menu
Menu do item de origem (árvore)	ms.vss-code-web.source-tree-item-menu
Menu do 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 item de resumo da lista	ms.vss-code-web.change-list-summary-item-menu
Menu de árvore de galhos do Git	ms.vss-code-web.git-branches-tree-menu
Menu de ações de solicitação pull do Git	ms.vss-code-web.pull-request-action-menu
Guias de solicitação pull do Git (pivôs)	ms.vss-code-web.pr-tabs
Menu de listagem de confirmação 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 Planos de Teste do Azure

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 os 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