Добавление панелей на страницах невыполненной работы

Azure DevOps Services

В этой статье показано, как добавить пользовательскую панель на страницы бэклога портфеля, бэклога продукта и бэклога итерации.

Подсказка

Для получения последних рекомендаций по разработке расширений, включая темизацию и миграцию из VSS.SDK, смотрите на портале разработчика пакета SDK для расширений Azure DevOps.

Пользовательская панель открывается в том же пространстве, что и панель сопоставления.

Три категории невыполненной работы поддерживают расширения панели. Следующие точки вклада применяются к шаблонам процессов Agile, Scrum и CMMI. Для пользовательских шаблонов проверьте процесс, чтобы определить, какие невыполненные работы используют категорию требований или портфеля.

Категория невыполненной работы	Точка вклада
Портфель (Эпик, Фича)	ms.vss-work-web.portfolio-backlog-toolpane
Требования (история пользователя, элемент бэклога продукта)	ms.vss-work-web.requirement-backlog-toolpane
Бэклог спринта	ms.vss-work-web.iteration-backlog-toolpane

Дополнительные сведения см. в примере расширения Azure DevOps Services.

Обновление манифеста расширения

Обновите файл манифеста расширения следующим кодом. В этом примере панель добавляется ко всем трем типам невыполненных работ.

{
	"contributions": [
		{
			"id": "Fabrikam.HelloWorld.Backlogs.Panel",
			"type": "ms.vss-work-web.backlog-panel",
			"description": "Adds a 'Hello' panel to Product and Iteration backlog pages.",
			"targets": [
				"ms.vss-work-web.requirement-backlog-toolpane",
				"ms.vss-work-web.portfolio-backlog-toolpane",
				"ms.vss-work-web.iteration-backlog-toolpane"
			],
			"properties": {
				"title": "Hello Panel Pane",
				"name": "Hello Panel",
				"uri": "index.html",
				"registeredObjectId": "backlogPanelObject"
			}
		}
	],
	"scopes": [
		"vso.work"
	]
}

Вклад

Для каждого вклада в расширение манифест определяет следующее:

• Тип вклада, например backlog-panel
• Целевые показатели, такие как требования, портфель и панели инструментов для управления невыполненными задачами по итерации
• Свойства, относящиеся к каждому типу вклада

В следующей таблице описаны свойства, относящиеся к панели.

Недвижимость	Description
title	Текст подсказки, отображаемый в элементе меню.
name	Текст, отображаемый в раскрывающемся списке для выбора панели.
uri	Путь, относительно базового URI расширения, к странице, которую нужно отобразить в виде панели.
registeredObjectId	Идентификатор объекта, зарегистрированного для панели.

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

Scopes

Включите области, необходимые вашему расширению. В этом примере используется vso.work для доступа к рабочим элементам.

Получение событий выбора

Чтобы получить события выбора, какие рабочие элементы выбраны, реализуйте этот интерфейс на зарегистрированном объекте.

...
	IContributedPanel {
		workItemSelectionChanged: (selectedWorkItems) => void;
	}
...

Следующий шаг

Упаковка, публикация и установка