Riferimento a tutti gli elementi XML WITD

Articolo
08/11/2011

È possibile personalizzare un tipo di elemento di lavoro esistente o crearne uno che consenta di soddisfare i requisiti di rilevamento del progetto. Un tipo di elemento di lavoro definisce le regole, i campi, gli stati e le transizioni per gli elementi di lavoro che verranno gestiti in un progetto team, ad esempio bug, requisiti o rischi.

Un tipo di elemento di lavoro non può essere vuoto. L'elemento radice in ogni definizione di un tipo di elemento di lavoro è l'elemento WITD che deve disporre solo di un elemento WORKITEMTYPE definito. Il nome di ogni tipo di elemento di lavoro deve essere univoco in un progetto team e può essere composto da un massimo di 254 caratteri Unicode. Per ulteriori informazioni, vedere Convenzioni di denominazione per oggetti di rilevamento di elementi di lavoro.

Per personalizzare o creare una definizione del tipo di elemento di lavoro, modificare il file XML per la definizione del tipo associato al tipo di elemento di lavoro. Le definizioni dei tipi di elemento di lavoro vanno mantenute e gestite per ogni progetto team.

In questo argomento

Struttura della sintassi WITD
Elementi figlio WITD
Tipi di elemento di lavoro del modello di processo

Struttura della sintassi WITD

Nell'esempio riportato di seguito viene mostrata la struttura di alto livello di un tipo di elemento di lavoro.

<WITD application="work item type editor" version="1.0">
    <WORKITEMTYPE name="bug">
        <DESCRIPTION>Bug work item types are used to track defects in the code.</DESCRIPTION>
        <GLOBALLISTS> . . . </GLOBALLISTS>
        <FIELDS> . . . </FIELDS>
        <WORKFLOW> . . . </WORKFLOW>
        <FORM> . . . </FORM>
    </WORKITEMTYPE>
</WITD>

Un numero limitato di elementi XML viene visualizzato tra i tag WORKITEMTYPE al livello più elevato della definizione del tipo di elemento di lavoro. La definizione di un tipo di elemento di lavoro inizia fornendo un nome e una descrizione. È anche possibile utilizzare alcuni tag XML standard per includere la definizione del tipo di elemento di lavoro.

Elementi figlio WITD

Gli elementi della struttura utilizzati nel precedente esempio sono descritti nella seguente tabella:

Elemento	Descrizione
WITD	La definizione completa del tipo di elemento di lavoro è inclusa nel tag WITD. È possibile utilizzare un nome qualsiasi per l'applicazione. La versione identifica lo schema del tipo di elemento di lavoro che viene modificato da una versione a quella successiva. Utilizzare "1.0". `<WITD application="Work item type editor" version="1.0 [1]"> <WORKITEMTYPE> . . .</WORKITEMTYPE> </WITD>`
WORKITEMTYPE	I nomi dei tipi di elementi di lavoro devono essere univoci in un progetto team specifico. In fase di esecuzione, utilizzare il nome specificato da questo elemento. Ad esempio, il nome può apparire come opzione di menu. In questo caso, un utente può scegliere Bug nel menu Nuovo elemento di lavoro. `<WORKITEMTYPE name="WorkItemTypeName"> <DESCRIPTION>Text</DESCRIPTION> <GLOBALLISTS> . . .</</GLOBALLISTS> <FIELDS> . . . </FIELDS> <WORKFLOW> . . . </WORKFLOW> <FORM> . . .</</FORM> </WORKITEMTYPE>`
DESCRIPTION	Specifica una stringa che descrive il tipo di elemento di lavoro che si definisce. La descrizione deve aiutare qualsiasi utente che sta personalizzando il tipo di elemento di lavoro. Nota La descrizione può essere visualizzata solo nella definizione XML.La descrizione non è visibile in alcun punto dell'interfaccia utente e non ha relazioni con il campo System.Definition. `<DESCRIPTION> DescriptionOfWorkItemType</DESCRIPTION>` Si specifica una stringa di testo che descrive il tipo di elemento di lavoro che si definisce.
GLOBALLISTS	Contiene le definizioni degli elenchi globali utilizzate dal tipo di elemento di lavoro. Si utilizzano gli elenchi globali per condividere elementi dell'elenco tra più tipi di elemento di lavoro per un insieme di progetti team. L'utilizzo degli elenchi globali fornisce il supporto per facilità di manutenzione e collaborazione tra i gruppi. `<GLOBALLIST name="globalListName"> <LISTITEM> . . . </LISTITEM> </GLOBALLIST>` Per ulteriori informazioni, vedere Definizione di elenchi globali.
FIELDS	Contiene il set delle definizioni di campo utilizzate dal tipo di elemento di lavoro. All'interno dell'elemento FIELDS si definiscono tutti i campi che si desidera utilizzare per rilevare i dati per il tipo di elemento di lavoro. Sono inclusi i campi che si utilizzeranno per eseguire query e generare rapporti. `<FIELDS> <FIELD> . . . </FIELD> </FIELDS>` Per ulteriori informazioni, vedere Utilizzo dei campi elementi di lavoro.
WORKFLOW	Contiene il set di elementi STATE e TRANSITION che definiscono il flusso di lavoro del tipo di elemento di lavoro. Il flusso di lavoro è un insieme di transizioni valide da uno stato a un altro e le condizioni specifiche associate a ogni transizione. `<WORKFLOW> <STATES> . . . </STATES> <TRANSITIONS> . . . </TRANSITIONS> </WORKFLOW>` Per ulteriori informazioni, vedere Definizione e personalizzazione del flusso di lavoro degli elementi di lavoro.
FORM	Contiene LAYOUT, CONTROL, GROUP, TAB, TABGROUP, SPLITTER e altri elementi che definiscono i campi e i controlli che appaiono nel form e la visualizzazione di tali elementi nel form del tipo di elemento di lavoro. `<FORM> <Layout> . . . </Layout> </FORM>` Per ulteriori informazioni, vedere Progettazione e personalizzazione di un form elemento di lavoro.

Tipi di elemento di lavoro del modello di processo

Sono disponibili due set di definizioni di tipo di elemento di lavoro del modello di processo che corrispondono a quelli definiti per Microsoft Solutions Framework (MSF) for Agile Software Development v5.0 e MSF for Capability Maturity Model Integration (CMMI) Software Development v5.0. Questi file si trovano nella directory di installazione, rispettivamente nei seguenti percorsi:

Unità:\Programmi\Microsoft Visual Studio v10.0 Team Foundation Server\Application Tier\Web Services\Deploy\ProcessTemplateManagerFiles\MsfAgile\Template.zip
Unità:\Programmi\Microsoft Visual Studio v10.0 Team Foundation Server\Application Tier\Web Services\Deploy\ProcessTemplateManagerFiles\MsfFormal\Template.zip

È possibile trovare le definizioni dei tipi di elemento di lavoro nella cartella WorkItem Tracking\TypeDefinitions del file Template.zip. Ad esempio, MSF for Agile Software Development v5.0 definisce un file XML per ognuno dei seguenti tipi di elemento di lavoro: Bug, Problema, SharedStep, Attività, TestCase e Storia utente. Per ulteriori informazioni su ognuno di questi tipi di elementi di lavoro, vedere MSF for Agile Software Development v5.0.

È possibile personalizzare o creare i file di definizione dei tipi nella cartella TypeDefinitions. È quindi possibile importare il nuovo tipo di elemento di lavoro in un singolo progetto oppure aggiungerlo al modello di processo e caricare il modello modificato in Team Foundation Server. Per ulteriori informazioni, vedere Aggiungere definizioni di tipi per elementi di lavoro a un modello di processo.