Adicionar painéis em páginas de backlog

Serviços do Azure DevOps

Este artigo mostra como adicionar um painel personalizado à lista de pendências do Portfólio, à lista de pendências do Produto e à lista de pendências de Iteração nas páginas correspondentes.

Dica

Para obter as diretrizes mais recentes de desenvolvimento de extensão, incluindo temas e migração do VSS. SDK, consulte o portal do desenvolvedor do SDK de Extensão do Azure DevOps.

O painel personalizado é aberto no mesmo espaço que o painel de mapeamento.

Três categorias de backlog dão suporte a extensões de painel. Os pontos de contribuição a seguir se aplicam aos modelos de processo Agile, Scrum e CMMI. Para modelos personalizados, verifique seu processo para identificar quais listas de pendências usam o requisito ou a categoria de portfólio.

Categoria de backlog	Ponto de contribuição
Portfólio (Epic, Feature)	ms.vss-work-web.portfolio-backlog-toolpane
Requisitos (história do usuário, item de lista de pendências do produto)	ms.vss-work-web.requirement-backlog-toolpane
Lista de pendências do Sprint	ms.vss-work-web.iteração-backlog-toolpane

Para obter mais informações, consulte o exemplo de extensão do Azure DevOps Services.

Atualizar o manifesto da extensão

Atualize o arquivo de manifesto de extensão com o código a seguir. Este exemplo adiciona um painel a todos os três tipos de lista de pendências.

{
	"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"
	]
}

Contribuição

Para cada contribuição em sua extensão, o manifesto define:

• O tipo de contribuição, como backlog-panel
• As metas de contribuição, como os painéis de ferramentas de backlog de requisitos, de portfólio e de iteração
• As propriedades específicas para cada tipo de contribuição

A tabela a seguir descreve as propriedades específicas do painel.

Propriedade	Description
title	Texto da dica de ferramenta que aparece no item de menu.
name	Texto que aparece na lista suspensa para a seleção do painel.
uri	Caminho, relativo ao URI base da extensão, da página a ser mostrada no painel.
registeredObjectId	ID do objeto registrado para o painel.

Para obter mais informações sobre onde você pode adicionar uma extensão, consulte pontos de extensibilidade.

Escopos

Inclua os escopos que sua extensão requer. Este exemplo usa vso.work para acessar itens de trabalho.

Obter eventos de seleção

Para obter eventos de seleção sobre quais itens de trabalho são selecionados, implemente essa interface em seu objeto registrado.

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

Próxima etapa

Empacotar, publicar e instalar