Condividi tramite

Definire le attività per elaborare un plug-in

  • Articolo

Usare l'elemento tasks e gli elementi figlio per definire gli elementi da caricare o gli elementi specifici da creare per un plug-in. Un'attività specifica il lavoro da svolgere per configurare elementi specifici del processo in un nuovo progetto team. Diverse attività definite dall'utente caricano i tipi di elemento di lavoro, le query elemento di lavoro, i documenti e i report per un progetto team. Le altre attività che è possibile definire configurano 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.

Contenuto dell'argomento

  • Struttura della sintassi delle attività

  • Riferimento agli elementi attività

  • Indice degli elementi taskXML per funzione

  • Esempio: definizione dei tipi di elemento di lavoro

Struttura della sintassi delle attività

È possibile specificare diverse attività in un plug-in che possono avere dipendenze reciproche. Le attività definite per ogni plug-in devono essere conformi alla definizione dello schema per tasks, definita nel file Tasks.xsd, e devono essere specificate nel file mediante l'elemento contenitore di tasks.

La sintassi seguente mostra la struttura di alto livello dell'elemento tasks e del relativo figlio.

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

Torna all'inizio

Riferimento agli elementi attività

La tabella seguente descrive tutti gli elementi che possono definire le attività per un plug-in.

Elemento

Sintassi

Descrizione

dependencies

 
<dependencies>
<dependency>. . . </dependency>
</dependencies>

Elemento figlio facoltativo di task.

Specifica gli 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à. È necessario completare l'altra attività prima di poter avviare quella corrente.

ProcessTemplate

 
<ProcessTemplate Type="FileType" Filename="LocalPathAndFileName" 
   Description="FileDescription" 
   ServerPath="UploadLocation" />

Dove ogni attributo viene definito come segue:

  • Type: il tipo di file caricato. Sono validi i seguenti valori: Default e Upgrade per i file di modello Build e Custom per i file di modello Lab.

  • Filename: il percorso della directory locale e il nome del file da caricare.

  • Description: una breve stringa di testo che descrive il file da caricare.

  • ServerPath: il percorso del server che esegue Team Foundation Server in cui deve essere caricato il file. L'unica posizione di caricamento valida è $/$$PROJECTNAME$$/BuildProcessTemplates.

Elemento figlio facoltativo dell'elemento taskXml per i plug-in Build e Lab.

Specifica il nome, la posizione e la 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 da svolgere per configurare elementi specifici del processo in un nuovo progetto team.

  • id: specifica un nome che identifica l'attività. Se un'altra attività dipende dall'attività corrente, fa riferimento a questo ID. È necessario assegnare un valore univoco per l'ID nel file del plug-in.

  • name: descrive lo scopo dell'attività.

  • plugin: individua il plug-in che deve eseguire l'attività.

  • completionMessage: specifica il messaggio da visualizzare durante la creazione del progetto team per indicare che l'attività è stata completata correttamente. La lunghezza massima è di 256 caratteri.

  • completionDescription: specifica il messaggio da visualizzare durante la creazione del progetto team per indicare che l'attività è in elaborazione. La lunghezza minima è di 1 carattere.

tasks

 
<tasks>
    <task>. . . </task>
</tasks>

Elemento figlio obbligatorio di taskXml.

Contiene una raccolta di elementi task ciascuno dei quali specifica il lavoro da svolgere per configurare elementi specifici del processo in un nuovo progetto team.

taskXml

 
<taskXml> . . . </taskXml>

Elemento radice richiesto per un file del plug-in.

Descrive il lavoro richiesto per completare l'attività. Il file XML nel blocco di elementi varia ed è specifico per ogni plug-in.

Nota

Il processore XML non tenta la convalida del contenuto nell'elemento.

Torna all'inizio

Indice degli elementi taskXML per funzione

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

Torna all'inizio

Esempio: definizione dei tipi di elemento di lavoro

L'esempio seguente mostra un'attività che crea sei tipi di elemento di lavoro facendo riferimento ai file di definizione di 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

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

Cenni preliminari sui file di modello di processo