Condividi tramite


Riferimento a tutti gli elementi XML WITD

È possibile personalizzare un tipo di elemento di lavoro (WIT) esistente o crearne uno che soddisfi i requisiti di rilevamento del progetto. Un tipo di elemento di lavoro definisce le regole, i campi, gli stati e le transizioni per un elemento di lavoro che sarà gestito in un progetto team, ad esempio un bug, un requisito o un rischio.

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 altre 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, è necessario modificare il file XML di definizione del tipo. Le definizioni dei tipi di elemento di lavoro vanno mantenute e gestite per ogni progetto team.

Struttura della sintassi WITD

Nell'esempio riportato di seguito viene mostrata la struttura di alto livello di una definizione 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 ai livelli più elevati 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 usare alcuni tag XML standard per includere la definizione del tipo di elemento di lavoro.

Elementi figlio WITID

Gli elementi della struttura usati 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 usare 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. Usare "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, usare il nome specificato da questo elemento. Ad esempio, il nome può apparire come opzione di menu. In questo caso, un utente può scegliere Bug dal 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 essere di aiuto a 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 usate dal tipo di elemento di lavoro. Si utilizzano gli elenchi globali per condividere elementi dell'elenco tra più tipi di elemento di lavoro per una raccolta 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 altre informazioni, vedere Definire elenchi globali.

FIELDS

Contiene il set delle definizioni di campo usate dal tipo di elemento di lavoro. All'interno dell'elemento FIELDS si definiscono tutti i campi che si desidera usare per rilevare i dati per il tipo di elemento di lavoro. Sono inclusi i campi che si utilizzeranno per eseguire query e generare report.

<FIELDS>
   <FIELD> . . . </FIELD>
</FIELDS>

Per altre informazioni, vedere Definire e modificare campi di elementi di lavoro.

WORKFLOW

Contiene il set di elementi STATE e TRANSITION che definiscono il flusso 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 altre informazioni, vedere Modificare il flusso di lavoro per un tipo di elemento 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.

<FORM>
   <Layout> . . . </Layout>
</FORM>

Per altre informazioni, vedere Progettare il form elemento di lavoro.

Tipi di elemento di lavoro del modello di processo

In TFS sono disponibili tre modelli di processo predefiniti. Questi file sono disponibili nella directory seguente:

%programfiles%/Microsoft Team Foundation Server 12.0/Tools/Deploy/ProcessTemplateManagerFiles/1033

È possibile trovare le definizioni dei tipi di elemento di lavoro nella cartella WorkItem Tracking\TypeDefinitions. Per altre informazioni, vedere Utilizzare elementi del progetto team, scegliere un modello di processo.

È 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 altre informazioni, vedere Aggiungere definizioni di tipi per elementi di lavoro a un modello di processo.

Vedere anche

Concetti

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

Altre risorse

witAdmin: personalizzare e gestire oggetti per gestire il lavoro