Condividi tramite


Definire le 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.Un numero di attività definite carica i tipi di elemento di lavoro, le query elemento di lavoro, i documenti e i rapporti per un progetto team.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.

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 una raccolta 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.

NotaNota
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:

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

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

Utilizzo di file di modello di processo