Aggiungere pannelli nelle pagine del backlog

Servizi di Azure DevOps

Questo articolo illustra come aggiungere un pannello personalizzato alle pagine backlog del Portfolio, backlog del Prodotto e backlog dell'Iterazione.

Suggerimento

Per le linee guida più recenti per lo sviluppo di estensioni, incluse la tematizzazione e la migrazione da VSS.SDK, vedere il portale per sviluppatori di Azure DevOps Extension SDK.

Screenshot dell'estensione del pannello aperto nella pagina backlog Stories.

Il pannello personalizzato viene aperto nello stesso spazio del pannello di mapping.

Screenshot dell'estensione del pannello personalizzato nella pagina Portfolio Backlog.

Tre categorie di backlog supportano le estensioni del pannello. I punti di contributo seguenti si applicano ai modelli di processo Agile, Scrum e CMMI. Per i modelli personalizzati, controllare il processo per identificare quali arretrati usano il requisito o la categoria di portfolio.

Categoria backlog Punto di partecipazione
Portfolio (Epico, Funzionalità) ms.vss-work-web.portfolio-backlog-toolpane
Requisiti (storia utente, elemento backlog prodotto) ms.vss-lavoro-web.toolpane-backlog-requisiti
Elenco Attività dello Sprint ms.vss-work-web.iteration-backlog-toolpane

Per altre informazioni, vedere l'esempio di estensione di Azure DevOps Services.

Aggiornare il manifesto dell'estensione

Aggiornare il file manifesto dell'estensione con il codice seguente. In questo esempio viene aggiunto un pannello a tutti e tre i tipi di backlog.

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

Contributo

Per ogni contributo nell'estensione, il manifesto definisce:

  • Tipo di contributo, ad esempio backlog-panel
  • Gli obiettivi di contributo, come il requisito, il portfolio e i riquadri degli strumenti del backlog di iterazione
  • Proprietà specifiche di ogni tipo di contributo

Nella tabella seguente vengono descritte le proprietà specifiche del pannello.

Proprietà Description
title Testo visualizzato nella voce di menu.
name Testo visualizzato nell'elenco a discesa per la selezione del pannello.
uri Percorso, relativo all'URI di base dell'estensione, della pagina da visualizzare come pannello.
registeredObjectId ID dell'oggetto registrato per il pannello.

Per altre informazioni sulla posizione in cui è possibile aggiungere un'estensione, vedere Punti di estendibilità.

Scopes

Includere gli ambiti richiesti dall'estensione. In questo esempio viene vso.work usato per accedere agli elementi di lavoro.

Raccogli eventi di selezione

Per ottenere gli eventi di selezione relativi agli elementi di lavoro selezionati, implementare questa interfaccia nell'oggetto registrato.

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

Passo successivo