Точки расширяемости
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, в которые можно внести вклад в центры.
Имя. | Идентификатор | Уровень | Предпросмотр изображения |
---|---|---|---|
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-build-web.build-definition-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-releaseManagement-web.release-definition-explorer-toolbar-menu |
![]() |
Меню панели инструментов "Выпуск сводки" | ms.vss-releaseManagement-web.release-editor-tool-bar-menu |
![]() |
Вкладка "Сводка о выпуске" | ms.vss-releaseManagement-web.release-details-view |
![]() |
Сводный раздел о выпуске | ms.vss-releaseManagement-web.release-details-summary-tab |
![]() |
Меню и панель инструментов Azure Pipelines
Имя. | Идентификатор целевого объекта | Предварительный просмотр |
---|---|---|
Меню завершенной сборки | ms.vss-build-web.completed-build-menu |
![]() |
Меню "Определения сборки" | ms.vss-build-web.build-definition-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-releaseManagement-web.release-definition-explorer-toolbar-menu |
![]() |
Меню панели инструментов "Выпуск сводки" | ms.vss-releaseManagement-web.release-editor-tool-bar-menu |
![]() |
Вкладка "Сводка о выпуске" | ms.vss-releaseManagement-web.release-details-view |
![]() |
Сводный раздел о выпуске | ms.vss-releaseManagement-web.release-details-summary-tab |
![]() |
Представление сведений о конвейере, кнопка заголовка | 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
Имя: функция (только в локальной среде)
Целевой идентификатор: ms.vss-web.managed-features-onprem