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

Utilizzando il plug-in per il rilevamento 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, elenchi globali e istanze di elementi di lavoro. Dopo aver creato un progetto team, è possibile modificare questi oggetti utilizzando lo strumento da riga di comando witadmin.

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

Nota importanteImportante

È 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 in fase di personalizzazione. Per ulteriori informazioni, vedere Definizione di dipendenze per attività e gruppi di attività in file di plug-in..

In questo argomento

  • Nome e percorso del plug-in Gestione elementi di lavoro

  • Struttura di sintassi del plug-in Gestione elementi di lavoro

  • Riferimento dell'elemento del plug-in WorkItemTracking

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

Nome e percorso del plug-in Gestione elementi di lavoro

Nella tabella seguente vengono forniti 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 desidera distribuire questo tipo di funzionalità, è necessario utilizzare il programma di distribuzione e installazione di cui si dispone.

Torna all'inizio

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: Modello di processo e schemi di elementi di lavoro di 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 elenchi globali o istanze di elementi di lavoro, specificare un'attività aggiuntiva per ognuna di esse.

Per una descrizione di ciascun elemento, vedere Riferimento dell'elemento per il plug-in WorkItemTracking 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>

Torna all'inizio

Riferimento dell'elemento del plug-in WorkItemTracking

Nella tabella riportata di seguito vengono descritti gli elementi utilizzati 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 Definizione delle attività per elaborare un plug-in.

Elemento

Sintassi

Descrizione

CATEGORIES

<CATEGORIES fileName="CategoriesFilePathName" />

Elemento figlio facoltativo dell'elemento taskXml per il plug-in WorkItemTracking.

Consente di specificare 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.

GLOBALLISTS

<GLOBALLISTS fileName="GlobalListFilePathName" />

Elemento figlio facoltativo dell'elemento taskXml per il plug-in WorkItemTracking.

Consente di specificare il percorso e il nome del file contenente le definizioni per gli elementi globali da caricare in fase di elaborazione del plug-in WorkItemTracking.

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.

Consente di specificare 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 un insieme di elementi LINKTYPE, ognuno dei quali specifica un file di definizione da caricare.

Permission

<permission allow="ListOfPermissions" identity="GroupName" />

Elemento figlio facoltativo di Query.

Consente di specificare le autorizzazioni predefinite assegnate alle query team. Per ulteriori informazioni, vedere Assegnazione di autorizzazioni per le query elemento di lavoro.

Query

<Query name="QueryName" fileName="QueryFilePathName" />

Elemento figlio obbligatorio di QUERIES.

Consente di specificare 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.

Consente di specificare 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 utilizzare per creare query predefinite.

WI

<WI type="WorkItemType">
   <FIELD> . . .</FIELD>
   <HYPERLINK> . . .</HYPERLINK>
</WI>

Elemento figlio obbligatorio di WORKITEMS.

Consente di definire 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 un insieme di elementi WI, ognuno dei quali definisce un'istanza dell'elemento di lavoro.

WORKITEMTYPE

<WORKITEMTYPE fileName="WITFilePathName" />

Elemento figlio obbligatorio di WORKITEMTYPES.

Consente di specificare 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 un insieme di elementi WORKITEMTYPE, ognuno dei quali specifica un file di definizione da caricare.

Torna all'inizio

Vedere anche

Attività

Verificare le modifiche alle definizioni dei tipi di elemento di lavoro

Concetti

Processo di personalizzazione dettagliato

Personalizzazione di dati di rilevamento, form, flusso di lavoro e gli altri oggetti del progetto

Utilizzo di file di modello di processo

Personalizzazione di aree funzionali all'interno di un modello di processo

Altre risorse

Personalizzazione dei modelli di processo

Cronologia delle modifiche

Data

Cronologia

Motivo

Aprile 2011

Sezione aggiunta di riferimenti e collegamenti ai singoli argomenti destinati a ciascun tipo di oggetto di gestione. Rimossi collegamenti agli argomenti eliminati.

Miglioramento delle informazioni.