Riferimento agli elementi XML ProcessTemplate

Articolo
11/18/2015

È possibile personalizzare il file radice per un modello di processo al fine di aggiungere o rimuovere i file di plug-in. Il file radice definisce tutti i plug-in e le attività usati per creare un progetto team in Visual Studio Online o in un'istanza locale di Team Foundation Server. Il file radice denominato ProcessTemplate si trova nella cartella del contenitore per i file di modello di processo. Per altre informazioni, vedere Cenni preliminari sui file di modello di processo.

L'elemento padre del file di plug-in radice è l'elemento ProcessTemplate, in cui devono essere definiti solo un elemento metadata e un elemento groups. È necessario assegnare un nome univoco a ogni modello di processo in una raccolta di progetti team e il nome può essere composto da un massimo di 124 caratteri Unicode.

Nota

Per Visual Studio Online: se si importa un modello di processo con lo stesso nome e GUIDA di un processo esistente, il processo esistente viene aggiornato insieme a tutti i progetti team che fanno riferimento a tale processo.

Per un'istanza locale di TFS: se si carica un modello di processo con lo stesso nome di un modello esistente, quest'ultimo viene sovrascritto.

Contenuto dell'argomento

Struttura della sintassi di ProcessTemplate
Riferimento all'elemento metadata
Riferimento all'elemento groups

Struttura della sintassi di ProcessTemplate

Il plug-in radice per i modelli di processo deve essere specificato nell'apposito file all'interno dell'elemento contenitore ProcessTemplate e deve essere conforme allo schema per i modelli di processo, definito nei file ProcessTemplate.xsd e ProcessTemplateItem.xsd. È possibile scaricare i file dello schema per i modelli di processo dalla seguente pagina del sito Web Microsoft: Schemi del modello di processo e degli elementi di lavoro per Visual Studio Team Foundation.

L'esempio seguente mostra la struttura dell'elemento ProcessTemplate radice. Per un esempio più dettagliato, vedere Definire le attività radice utilizzando il file del plug-in del modello di processo.

<?xml version="1.0" encoding="utf-8"?>
<ProcessTemplate>
   <metadata> . . . </metadata>
   <groups> . . .</groups>
</ProcessTemplate>

Riferimento all'elemento metadata

Nella sintassi indicata di seguito viene illustrata la struttura dell'elemento metadata e dei relativi elementi figlio.

<metadata>
    <name>ProcessTemplateName</name>
    <description>ProcessTemplateDescription </description>
    <version type="ID" major="Number1" minor="Number2" />
    <plugins>
      <plugin name="Microsoft.ProjectCreationWizard.pluginID" wizardPage="true | false" />
. . .
    </plugins>
</metadata>

Elemento	Sintassi	Descrizione
description	`<description>ProcessTemplateDescription</description>`	Elemento figlio obbligatorio di metadata. Definisce il testo della descrizione che verrà visualizzata nella Creazione guidata nuovo progetto team per il modello di processo.
metadata	`<metadata> <name> . . . </name> <description> . . . </description> <version type="ID" major="Number1" minor="Number2/> <plugins> . . . </plugins> </metadata>`	Elemento figlio obbligatorio di ProcessTemplate. Elemento contenitore per specificare le informazioni necessarie per l'elaborazione del plug-in nella Creazione guidata nuovo progetto team.
name	`<name>ProcessTemplateName</name>`	Elemento figlio obbligatorio di metadata. Definisce il nome del modello di processo, che deve essere univoco nella raccolta di progetti team. La lunghezza massima del nome è 124 caratteri.
plugin	`<plugin name="Microsoft.ProjectCreationWizard.PluginName wizardPage="true \| false" />`	Elemento figlio obbligatorio di plugins. Specifica il nome di un file di plug-in da includere nella creazione del modello di processo e specifica se il plug-in deve avere una pagina visibile nella Creazione guidata nuovo progetto team.
plugins	`<plugins> <plugin> . . . </plugin> </plugins>`	Elemento figlio obbligatorio di metadata. Elemento contenitore che definisce i plug-in per il modello di processo.
version	`<version type="ID" major="Number1" minor="Number2 " />`	Elemento figlio obbligatorio di metadata. Specifica un ID univoco e i numeri di revisione principale e secondario per identificare la versione del modello di processo.

Riferimento all'elemento groups

Nella sintassi indicata di seguito viene illustrata la struttura dell'elemento groups e dei relativi elementi figlio.

<groups>
   <group id="groupId" description="GroupDescription" completionMessage="SuccessMessage">
      <dependencies> 
         <dependency groupId="dependentGroupId" />
. . .
      </dependencies>
      <taskList filename="RelativePathAndFileName" />
   </group>
. . .
</groups>

Elemento	Sintassi	Descrizione
dependencies	`<dependencies> <dependency>. . . </dependency> </dependencies>`	Elemento figlio obbligatorio di group. Specifica le dipendenze del gruppo rispetto ad altri gruppi.
dependency	`<dependency groupId="groupId" />`	Elemento figlio facoltativo di dependencies. Specifica l'ID di un altro gruppo di attività da cui dipende questo gruppo. L'altro gruppo deve completare le relative attività prima che questo gruppo di attività possa iniziare.
group	`<group id="TaskGroupId" description="TaskGroupDescription" completionMessage="SuccessMessage" failureMessage="FailureMessage"> <dependencies> . . . <dependencies> <taskList> . . . </taskList> </group>`	Elemento figlio obbligatorio di groups. Identifica un set di attività che devono essere eseguite da un plug-in durante la creazione del progetto. Per ogni attributo sono validi i valori seguenti: id: specifica un nome che identifica il gruppo di attività. Se da questo gruppo dipende un altro gruppo di attività, farà riferimento a questo ID. È necessario assegnare un valore univoco per l'ID nel file del plug-in. description: specifica il messaggio da visualizzare durante la creazione del progetto team per indicare che il gruppo di attività è in fase di elaborazione. completionMessage: specifica il messaggio da visualizzare durante la creazione del progetto team per indicare che il gruppo di attività è stato completato correttamente. La lunghezza massima è di 256 caratteri. failureMessage: specifica il messaggio da visualizzare durante la creazione del progetto team per indicare che il gruppo di attività non è stato completato correttamente.
groups	`<groups> <group> . . . </group> </groups>`	Elemento figlio obbligatorio di ProcessTemplate. Elemento contenitore che definisce il set di gruppi di attività in esecuzione durante la creazione del progetto.
tasklist	`<taskList filename="filePath" />`	Specifica un file XML che contiene l'elenco delle attività da eseguire. L'elenco delle attività relative a un gruppo deve essere sempre contenuto in un file XML separato. Per altre informazioni su come specificare questi file, vedere Definire le attività per elaborare un plug-in.

Vedere anche

Concetti

Cenni preliminari sui file di modello di processo

Definire le attività per elaborare un plug-in

Definire le dipendenze per attività e gruppi di attività in file di plug-in

Personalizzare un processo

Definire le attività radice utilizzando il file del plug-in del modello di processo

Condividi tramite