Точки расширяемости

Azure DevOps Services | Azure DevOps Server 2022 — Azure DevOps Server 2019

Расширения повышают взаимодействие с пользователем Azure DevOps, предоставляя новые возможности. В этой статье мы рассмотрим наиболее распространенные точки расширяемости, на которые может быть нацелено расширение. Дополнительные сведения о модели расширяемости Azure DevOps см. в модели "Вклад".

Расширение "Руководство по вкладу" является примером расширения. Установите это расширение в вашу организацию. После установки вы увидите доступные точки расширяемости. Мы рекомендуем установить это расширение в личную или тестовую организацию. Источник этого расширения также доступен.

Дополнительные сведения см. в следующих ресурсах.

• azure-devops-extension-api
• azure-devops-extension-sdk
• azure-devops-extension-sample
• api установленных расширений

Центры и группы концентраторов

Центры и группы концентраторов являются основными элементами навигации в Azure DevOps. Файлы, выпуски, невыполненные работы и запросы являются примерами центров. Концентратор принадлежит группе концентраторов. Концентратор файлов, например, принадлежит группе концентратора Azure Repos уровня проекта. Группы концентраторов могут существовать на уровне организации или коллекции или на уровне проекта. Большинство расширений способствуют уровню проекта.

В следующей таблице описаны наиболее распространенные группы концентраторов в Azure DevOps, в которые можно внести вклад в центры.

Имя.	ID	Уровень	Предпросмотр изображения
Azure Boards	ms.vss-work-web.work-hub-group	Project/team
Azure Repos	ms.vss-code-web.code-hub-group	Project/team
Azure Pipelines	ms.vss-build-web.build-release-hub-group	Project/team
Планы тестирования Azure	ms.vss-test-web.test-hub-group	Project/team
Параметры проектов	ms.vss-web.project-admin-hub-group	Project
Параметры организации	ms.vss-web.collection-admin-hub-group	Организация или коллекция

Пример

В следующем примере показано, как внести свой вклад в группу центров кода:

{
    ...
    "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 — это тип этого вклада. Этот тип определяется в расширении, vss-web опубликованном в издателе ms . Этот тип объявляет необязательные и обязательные свойства, необходимые для вкладов этого типа (например, имя, порядок и т. д.).
• ms.vss-code-web.code-hub-group — это полный идентификатор вклада в группу концентратора, который предназначен для этого концентратора. Этот вклад объявлен в расширении, опубликованном в vss-code-web издателе ms
• my-custom-hub является коротким идентификатором этого вклада; {publisherId}.{extensionId}.my-custom-hub — полный идентификатор

Добавление значка в меню или панель инструментов

Добавьте свойство значка, чтобы его можно было использовать непосредственно по имени.

Мы рекомендуем предоставить свой собственный значок. Используя собственный пример значка:

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

Использование примера значков Office UI Fabric:

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

Параметры меню и панелей инструментов

Имя.	Идентификатор целевого объекта
Панель инструментов обзора организации и коллекции	ms.vss-admin-web.collection-overview-toolbar-menu
Сетка проектов обзора коллекции	ms.vss-admin-web.projects-grid-menu
Панель инструментов обзора проекта	ms.vss-admin-web.project-overview-toolbar-menu
Сетка групп обзора проектов	ms.vss-admin-web.teams-grid-menu

Меню и панель инструментов Azure Boards

Имя.	Идентификатор целевого объекта	Предпросмотр изображения
Меню запроса рабочего элемента	ms.vss-work-web.work-item-query-menu
Меню панели инструментов результатов запроса рабочих элементов	ms.vss-work-web.work-item-query-results-toolbar-menu
Элемент меню результатов запроса рабочего элемента	ms.vss-work-web.query-result-work-item-menu
Вкладка результатов запроса рабочих элементов	ms.vss-work-web.query-tabs
Рабочий элемент для контекстного меню	ms.vss-work-web.work-item-toolbar-menu
Меню элемента невыполненной работы	ms.vss-work-web.backlog-item-menu
Меню фильтра сводной таблицы спринта	ms.vss-work-web.sprint-board-pivot-filter-menu
Меню фильтра сводной таблицы	ms.vss-work-web.backlog-board-pivot-filter-menu
Меню карточки	ms.vss-work-web.backlog-board-card-item-menu
Вкладка невыполненной работы продукта	ms.vss-work-web.product-backlog-tabs
Вкладка невыполненной работы с итерацией	ms.vss-work-web.iteration-backlog-tabs
Область невыполненной работы портфеля	ms.vss-work-web.portfolio-backlog-toolpane
Область невыполненной работы продукта	ms.vss-work-web.requirement-backlog-toolpane
Область невыполненной работы по итерации	ms.vss-work-web.iteration-backlog-toolpane

Меню и панель инструментов Azure Pipelines

Имя.	Идентификатор целевого объекта	Предварительный просмотр
Меню завершенной сборки	ms.vss-build-web.completed-build-menu
Действие панели инструментов результатов теста	ms.vss-test-web.test-results-actions-menu
Вкладка сведений о результатах теста	ms.vss-test-web.test-result-details-tab-items
Контекстное меню обозревателя конвейеров выпуска	ms.vss-releaseManagement-web.release-definition-explorer-context-menu
Представление сведений о конвейере, кнопка заголовка	ms.vss-build-web.pipelines-header-menu
Представление сведений о конвейере, контекстное меню папки	ms.vss-build-web.pipelines-folder-menu

Задачи Azure Pipelines

Задачи выполняют работу в сборке или выпуске. Дополнительные сведения см. в том, как внести свой вклад в задачу сборки или выпуска.

Меню и панель инструментов Azure Repos

Имя.	Идентификатор целевого объекта	Предпросмотр изображения
Меню исходного элемента (сетки)	ms.vss-code-web.source-grid-item-menu
Меню исходного элемента (дерево)	ms.vss-code-web.source-tree-item-menu
Меню исходного элемента (сетка и дерево)	ms.vss-code-web.source-item-menu
Изменение меню элемента списка	ms.vss-code-web.change-list-item-menu
Меню "Изменить сводку списка"	ms.vss-code-web.change-list-summary-item-menu
Меню дерева ветвей Git	ms.vss-code-web.git-branches-tree-menu
Меню действий запроса на вытягивание Git	ms.vss-code-web.pull-request-action-menu
Вкладки запросов на вытягивание Git (сводки)	ms.vss-code-web.pr-tabs
Меню перечисления фиксации Git	ms.vss-code-web.git-commit-list-menu
Меню сведений о фиксации Git	ms.vss-code-web.git-commit-details-menu

Меню "Планы тестирования Azure" и панель инструментов

Имя.	Идентификатор целевого объекта	Предпросмотр изображения
Меню сетки тестового запуска	ms.vss-test-web.test-run-grid-menu
Меню дерева наборов тестового плана	ms.vss-test-web.test-plans-suites-context
Вкладка сводной таблицы концентратора тестового плана	ms.vss-test-web.test-plan-pivot-tabs

Другие точки расширяемости

• Мини-приложение панели мониторинга: расширение может внести новый тип мини-приложения, который можно добавить пользователями на панель мониторинга. Узнайте, как внести вклад в мини-приложение панели мониторинга.
• Форма рабочего элемента: форма рабочего элемента расширена расширениями с новыми разделами, вкладками, действиями и пользовательскими отрисовщиками полей. Дополнительные сведения см. в описании расширения формы рабочего элемента.
• Перехватчики служб: "потребитель" — это служба, в которую отправляются события в перехватчиках служб. Расширение может вносить вклад в службы потребителей. Эти службы настраиваются пользователем (или программным способом) для отправки событий в этой службе. Дополнительные сведения см. в разделе "Участие потребителя перехватчиков услуг".
• Возможности:

Имя: предварительная версия функции (только размещенная версия)
Целевой идентификатор: ms.vss-web.managed-features