Definizione delle attività per elaborare un plug-in

L'elemento tasks e i relativi elementi figlio consentono di definire gli elementi da caricare o specifici elementi da creare per un plug-in. Una attività specifica il lavoro necessario per la configurazione di elementi specifici per il processo in un nuovo progetto team. Una serie di attività definite consentono di configurare la struttura predefinita di un progetto team, come illustrato di seguito. Altre attività che è possibile definire consentono di configurare altre aree di Visual Studio Application Lifecycle Management, ad esempio Team Foundation Build, Visual Studio Lab Management, Test Manager e Controllo della versione di Team Foundation.

In questo argomento

• Struttura della sintassi Tasks

• Riferimento dell'elemento Tasks

• Indice per elementi taskXML in base alla funzione

• Esempio: definizione di tipi di elementi di lavoro

Struttura della sintassi Tasks

È possibile specificare diverse attività all'interno di un plug-in e queste attività possono presentare dipendenze reciproche. Le attività definite per ogni plug-in devono essere conformi alla definizione dello schema per tasks, inclusa nel file Tasks.xsd, e devono essere specificate nel proprio file mediante l'elemento contenitore tasks. È possibile scaricare i file dello schema per i modelli di processo dalla seguente pagina del sito Web Microsoft: Modello di processo e schemi di elementi di lavoro di Visual Studio Team Foundation.

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

<tasks>
   <task>
      <dependencies>
        <dependency />
        . . .    
      </dependencies />
      <taskXml>
        . . .    
      </taskXml>
   <task/>
</tasks>

Torna all'inizio

Riferimento dell'elemento Tasks

Nella tabella riportata di seguito viene descritto ciascun elemento con cui è possibile definire le attività per un plug-in.

Elemento	Sintassi	Descrizione
dependencies	<dependencies> <dependency>. . . </dependency> </dependencies>	Elemento figlio facoltativo di task. Consente di specificare altri gruppi da cui dipende un gruppo.
dependency	<dependency taskId="taskId" />	Elemento figlio facoltativo di dependencies. Consente di specificare l'ID di un'altra attività da cui dipende questa attività. L'altra attività deve essere completata prima che questa inizi.
ProcessTemplate	<ProcessTemplate Type="FileType" Filename="LocalPathAndFileName"    Description="FileDescription"    ServerPath="UploadLocation" /> In cui ogni attributo viene definito come segue: Type: tipo di file in fase di caricamento. Sono validi i valori seguenti: Default e Upgrade per i file di modello di compilazione e Custom per i file di modello lab. Filename: percorso della directory locale e nome del file da caricare. Description: stringa di testo breve che descrive il file da caricare. ServerPath: percorso del server che esegue Team Foundation Server in cui caricare il file. L'unico percorso di caricamento valido è $/$$PROJECTNAME$$/BuildProcessTemplates.	Elemento figlio facoltativo dell'elemento taskXml per i plug-in Compilazione e Lab. Consente di specificare nome, percorso e destinazione di un file da caricare per supportare i processi di compilazione per un progetto team.
task	<task id="task id" name="name of task"    plugin="Microsoft.ProjectCreationWizard.<PluginName>"    completionMessage="SuccessfulCompletionMessage"    completionDescription="InProcessMessage"> <dependencies>. . . </dependencies> <taskXml>. . . </taskXml> </task>	Elemento figlio obbligatorio di tasks. Specifica il lavoro necessario per la configurazione di elementi specifici per il processo in un nuovo progetto team. id: consente di specificare un nome che identifica l'attività. Se da questa attività ne dipende un'altra, farà riferimento a questo ID. È necessario assegnare un valore univoco per l'ID all'interno del file di plug-in. name: descrive le operazioni svolte dall'attività. plugin: identifica il plug-in che deve eseguire questa attività. completionMessage: consente di specificare il messaggio da visualizzare in fase di creazione del progetto team per indicare che l'attività è stata completata. La lunghezza massima è 256 caratteri. completionDescription: consente di specificare il messaggio da visualizzare in fase di creazione del progetto team per indicare che l'attività è in fase di elaborazione. La lunghezza minima è 1 carattere.
tasks	<tasks> <task>. . . </task> </tasks>	Elemento figlio obbligatorio di taskXml. Contiene un insieme di elementi di task, ciascuno dei quali specifica il lavoro necessario per la configurazione di elementi specifici per il processo in un nuovo progetto team.
taskXml	<taskXml> . . . </taskXml>	Elemento radice obbligatorio per un file di plug-in. Descrive il lavoro necessario per completare l'attività. La parte di XML all'interno di questo blocco di elementi varia ed è specifica per ciascun plug-in. Nota Tramite il processore XML non viene eseguito il tentativo di convalidare il contenuto all'interno dell'elemento.

Torna all'inizio

Indice per elementi taskXML in base alla funzione

Per ulteriori informazioni sulle specifiche degli elementi di markup XML che è possibile determinare per ogni plug-in, vedere uno degli argomenti seguenti:

• Compilazione: Definizione della configurazione iniziale di Team Foundation Build

• Classificazioni: Definizione delle aree e delle iterazione iniziali nel plug-in Classification

• Gruppi e autorizzazioni: Configurazione di gruppi, membri e autorizzazioni iniziali

• Lab: Definizione della configurazione iniziale di Lab Management

• Portale: Definizione del plug-in del portale del progetto per un modello di processo

• Rapporti: Aggiunta di rapporti al modello di processo

• Gestione test: Definizione della configurazione iniziale di Test Manager

• Controllo della versione: Definizione della configurazione iniziale del controllo della versione di Team Foundation

• Gestione elementi di lavoro: Definizione e personalizzazione di oggetti per il rilevamento degli elementi di lavoro mediante il plug-in di rilevamento dell'elemento di lavoro

Torna all'inizio

Esempio: definizione di tipi di elementi di lavoro

Nell'esempio indicato di seguito viene illustrata un'attività per la creazione di sei tipi di elementi di lavoro facendo riferimento ai file di definizione per ogni tipo.

<task
   id="WITs"
   name="WorkItemType definitions"
   plugin="Microsoft.ProjectCreationWizard.WorkItemTracking"
   completionMessage="WorkItemTypes created"         
   completionDescription = "Processing work item types used by work item tracking">
   <taskXml>
   <WORKITEMTYPES>
        <WORKITEMTYPE fileName="WorkItem Tracking\TypeDefinitions\Bug.xml" />
        <WORKITEMTYPE fileName="WorkItem Tracking\TypeDefinitions\SharedStep.xml" />
        <WORKITEMTYPE fileName="WorkItem Tracking\TypeDefinitions\Task.xml" />
        <WORKITEMTYPE fileName="WorkItem Tracking\TypeDefinitions\TestCase.xml" />
        <WORKITEMTYPE fileName="WorkItem Tracking\TypeDefinitions\UserStory.xml" />
        <WORKITEMTYPE fileName="WorkItem Tracking\TypeDefinitions\Issue.xml" />
   </WORKITEMTYPES>
   </taskXml>
</task>

Torna all'inizio

Vedere anche

Concetti

Definizione di dipendenze per attività e gruppi di attività in file di plug-in.

Altre risorse

Plug-in del modello di processo

Cronologia delle modifiche

Data	Cronologia	Motivo
Aprile 2011	Ulteriori informazioni aggiunte e struttura per la definizione delle attività per un plug-in e l'utilizzo degli elementi tasks.	Miglioramento delle informazioni.