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

• 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, 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
Repositórios do Azure	ms.vss-code-web.code-hub-group	Projeto/equipa
Azure Pipelines	ms.vss-build-web.build-release-hub-group	Projeto/equipa
Planos de Teste do Azure	ms.vss-test-web.test-hub-group	Projeto/equipa
Definições do projeto	ms.vss-web.project-admin-hub-group	Project
Definições da organização	ms.vss-web.collection-admin-hub-group	Organização ou recolha

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
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 de 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 pivô da placa de sprint	ms.vss-work-web.sprint-board-pivot-filter-menu
Menu de filtro pivô 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 do 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	Pré-visualizar
Menu de compilação concluída	ms.vss-build-web.completed-build-menu
Ação da barra de ferramentas de resultados de teste	ms.vss-test-web.test-results-actions-menu
Guia de detalhes do resultado do teste	ms.vss-test-web.test-result-details-tab-items
Liberar menu de contexto do explorador de pipeline	ms.vss-releaseManagement-web.release-definition-explorer-context-menu
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 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
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 da árvore de ramos 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	Imagem de pré-visualização
Menu de grade de execução de teste	ms.vss-test-web.test-run-grid-menu
Menu de árvore de pacotes de planos de teste	ms.vss-test-web.test-plans-suites-context
Guia pivô 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.
• Funcionalidades:

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