Definire oggetti per il rilevamento degli elementi di lavoro mediante il plug-in di rilevamento dell'elemento di lavoro

Con il plug-in per la gestione degli elementi di lavoro è possibile definire gli oggetti iniziali di un progetto team per tenere traccia del lavoro. Questi oggetti includono tipi di elementi di lavoro, query di elementi di lavoro, categorie, tipi di collegamenti e istanze di elementi di lavoro. Dopo aver creato un progetto team, è possibile modificare questi oggetti mediante lo strumento da riga di comando witadmin.

Nel file di plug-in specificare una o più attività e le relative dipendenze. In generale, specificare un'attività per ogni attività di caricamento principale, ad esempio tipi di collegamento, tipi di elementi di lavoro, query e categorie.

Importante

È necessario specificare le attività per caricare i file e definire le query in una sequenza specifica: prima i tipi di collegamento, quindi i tipi di elemento di lavoro, infine le query.Ogni file di definizione per questi oggetti dipende dalle definizioni specificate nelle attività che li precedono.In generale, è necessario mantenere la sequenza di attività definita nel modello di processo personalizzato.Per altre informazioni, vedere Definire le dipendenze per attività e gruppi di attività in file di plug-in.

Nome e percorso del plug-in

La tabella seguente fornisce il nome e il percorso del file per i modelli di processo per MSF (Microsoft Solutions Framework), nonché il nome del plug-in.

Nome del file:	WorkItems.xml
Percorso del file:	Cartella WorkItem Tracking
Nome del plug-in:	Microsoft.ProjectCreationWizard.WorkItemTracking

Nota

È possibile modificare il nome e il percorso del file XML, ma non il nome del plug-in.Visual Studio Team Foundation Server non include un meccanismo per la distribuzione di plug-in, criteri o altre modifiche sul lato client.Se si vuole distribuire questo tipo di funzionalità, è necessario usare il programma di distribuzione e installazione di cui si dispone.

Per informazioni specifiche su ogni tipo di oggetto che è possibile definire, vedere uno degli argomenti seguenti:

• Aggiungere definizioni di tipi per elementi di lavoro a un modello di processo

• Aggiungere definizioni di tipi di collegamento a un modello di processo

• Aggiungere definizioni di tipi per categorie di elementi di lavoro a un modello di processo

• Aggiungere query elemento di lavoro a un modello di processo

• Aggiungere un'istanza elemento di lavoro a un modello di processo

Struttura di sintassi del plug-in Gestione elementi di lavoro

Il file di plug-in per la gestione degli elementi di lavoro deve essere conforme alla definizione dello schema inclusa nel file WorkItemMethodology.xsd e deve essere specificato nel proprio file. È 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.

Nella sintassi riportata di seguito viene mostrata la struttura di livello elevato del plug-in WorkItemTracking. Vengono specificate quattro attività, ognuna per caricare le definizioni per i tipi di collegamento, i tipi di elementi di lavoro, le query e le categorie. Se è necessario aggiungere definizioni per istanze di elementi di lavoro, specificare un'attività aggiuntiva per ognuna di esse.

Per una descrizione di ciascun elemento, vedere Riferimento dell'elemento più avanti in questo argomento.

<?xml version="1.0" encoding="utf-8"?>
<tasks>
  <task id="LinkTypes" name="LinkType definitions" plugin="Microsoft.ProjectCreationWizard.WorkItemTracking" completionMessage="Work item link types created">
    <taskXml>
      <LINKTYPES>
        <LINKTYPE />
   . . . 
      </LINKTYPES>
    </taskXml>
  </task>
  <task id="WITs" name="WorkItemType definitions" plugin="Microsoft.ProjectCreationWizard.WorkItemTracking" completionMessage="Work item types created">
    <dependencies>
      <dependency taskId="LinkTypes" />
    </dependencies>
    <taskXml>
      <WORKITEMTYPES>
        <WORKITEMTYPE />
   . . . 
      </WORKITEMTYPES>
    </taskXml>
  </task>
  <task id="Queries" name="Stored Query Definitions" plugin="Microsoft.ProjectCreationWizard.WorkItemTracking" completionMessage="Work item queries uploaded">
    <dependencies>
      <dependency taskId="WITs" />
    </dependencies>
    <taskXml>
      <QUERIES>
        <Permission />
   . . . 
        <QueryFolder >
          <Query />
   . . . 
        </QueryFolder>
   . . . 
      </QUERIES>
    </taskXml>
  </task>
  <task id="Categories" name="Categories definitions" plugin="Microsoft.ProjectCreationWizard.WorkItemTracking" completionMessage="Work item type categories created">
    <dependencies>
      <dependency taskId="WITs" />
    </dependencies>
    <taskXml>
      <CATEGORIES fileName="WorkItem Tracking\Categories.xml" />
    </taskXml>
  </task>
</tasks>

Riferimento dell'elemento

La tabella seguente illustra gli elementi usati per caricare gli oggetti per la gestione degli elementi di lavoro. Questi elementi vengono specificati all'interno di un elemento contenitore taskXml nel file di plug-in WorkItemTracking. Per informazioni sugli elementi di attività, dipendenze e taskXml, vedere Definire le attività per elaborare un plug-in.

Elemento	Sintassi	Descrizione
CATEGORIES	<CATEGORIES fileName="CategoriesFilePathName" />	Elemento figlio facoltativo dell'elemento taskXml per il plug-in WorkItemTracking. Specifica il percorso e il nome del file contenente le definizioni di categoria da caricare in fase di elaborazione del plug-in WorkItemTracking.
FIELD	<FIELD refname="FieldReferenceName" value="Value" />	Elemento figlio obbligatorio di WI. Definisce un valore per un campo nell'istanza dell'elemento di lavoro.
HYPERLINK	<HYPERLINK URL="URL" relativePath="false" />	Elemento figlio facoltativo di WI. Definisce un collegamento ipertestuale per l'istanza dell'elemento di lavoro.
LINKTYPE	<LINKTYPE fileName="LinkTypeFilePathName" />	Elemento figlio obbligatorio di LINKTYPES. Specifica il percorso e il nome di un file contenente la definizione di un tipo di collegamento da caricare.
LINKTYPES	<LINKTYPES>    <LINKTYPE />  . . . </LINKTYPES>	Elemento figlio facoltativo dell'elemento taskXml per il plug-in WorkItemTracking. Contiene una raccolta di elementi LINKTYPE, ognuno dei quali specifica un file di definizione da caricare.
Permission	<permission allow="ListOfPermissions" identity="GroupName" />	Elemento figlio facoltativo di Query. Specifica le autorizzazioni predefinite assegnate alle query team. Per altre informazioni, vedere Assegnazione di autorizzazioni per le query elemento di lavoro.
Query	<Query name="QueryName" fileName="QueryFilePathName" />	Elemento figlio obbligatorio di QUERIES. Specifica il nome e il percorso del file con estensione wiq che definisce una query da caricare.
QueryFolder	<QueryFolder name=" FolderName ">	Elemento figlio facoltativo di QUERIES. Specifica il nome di una cartella di query.
QUERIES	<QUERIES> . . . </QUERIES>	Elemento figlio facoltativo dell'elemento taskXml per il plug-in WorkItemTracking. Specifica i file di definizione di query da usare per creare query predefinite.
WI	<WI type="WorkItemType">    <FIELD> . . .</FIELD>    <HYPERLINK> . . .</HYPERLINK> </WI>	Elemento figlio obbligatorio di WORKITEMS. Definisce un tipo di elemento di lavoro da creare e i valori da assegnare ai campi specifici.
WORKITEMS	WORKITEMS>    <WI>       <FIELD> . . .</FIELD>       <HYPERLINK> . . .</HYPERLINK>    </WI> </WORKITEMS >	Elemento figlio facoltativo dell'elemento taskXml per il plug-in WorkItemTracking. Contiene una raccolta di elementi WI, ognuno dei quali definisce un'istanza dell'elemento di lavoro.
WORKITEMTYPE	<WORKITEMTYPE fileName="WITFilePathName" />	Elemento figlio obbligatorio di WORKITEMTYPES. Specifica il percorso e il nome del file contenente la definizione di un tipo da caricare.
WORKITEMTYPES	<WORKITEMTYPES>    <WORKITEMTYPE />  . . . </WORKITEMTYPES>	Elemento figlio obbligatorio del plug-in WorkItemTracking. Contiene una raccolta di elementi WORKITEMTYPE, ognuno dei quali specifica un file di definizione da caricare.

Vedere anche

Concetti

Personalizzare un modello di processo

Personalizzare oggetti di rilevamento degli elementi di lavoro per supportare i processi del team

Cenni preliminari sui file di modello di processo