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 i campi, le regole e gli stati del flusso di lavoro, nonché le transizioni per un elemento di lavoro di cui verrà tenuta traccia per un progetto team, ad esempio un bug, un requisito o un rischio. Un progetto team viene creato in Visual Studio Online o in un'istanza locale di Team Foundation Server (TFS).
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 128 caratteri Unicode.
Per personalizzare o creare una definizione del tipo di elemento di lavoro, è necessario modificare il file XML di definizione del tipo. L'ambito dei tipi di elemento di lavoro è in un progetto team all'interno di una raccolta di progetti.
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:WITD application="Work item type editor" version="1.0" xmlns:witd="https://schemas.microsoft.com/VisualStudio/2008/workitemtracking/typedef">
<WORKITEMTYPE name="bug" refname="Microsoft.VSTS.WorkItemTypes.Bug">
<DESCRIPTION> Describes a divergence between required and actual behavior, and tracks the work done to correct the defect and verify the correction.</DESCRIPTION>
<GLOBALLISTS> . . . </GLOBALLISTS>
<FIELDS> . . . </FIELDS>
<WORKFLOW> . . . </WORKFLOW>
<FORM> . . . </FORM>
</WORKITEMTYPE>
</witd:WITD>
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 può variare tra le diverse versioni. Usare "1.0". |
WORKITEMTYPE |
I nomi dei tipi di elemento 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. Nome descrittivo: questo nome viene visualizzato nei menu a discesa delle query elemento di lavoro. Il nome descrittivo deve essere univoco in tutti i nomi del tipo di elemento di lavoro definiti in un progetto team. Specificare un nome con un numero di caratteri Unicode non superiore a 128 e che contenga caratteri alfanumerici, caratteri di sottolineatura e trattini. Nome di riferimento: specificare un nome con un numero di caratteri Unicode non superiore a 70 e che contenga caratteri alfanumerici, caratteri di sottolineatura e trattini. Il nome di riferimento deve contenere almeno un punto (.), ma non all'inizio o alla fine di un nome. Inoltre, il nome di riferimento non può iniziare con un numero o un carattere di sottolineatura e non può avere più trattini consecutivi, ad esempio (--). Non specificare un nome che si sovrappone al sistema riservato. XXX e Microsoft. Spazi dei nomi XXX. Vedere Convenzioni di denominazione per oggetti di rilevamento di elementi di lavoro. |
DESCRIZIONE |
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. Si specifica una stringa di testo che descrive il tipo di elemento di lavoro che si definisce. |
GLOBALLISTS |
Contiene le definizioni dell'elenco globale usate dal tipo di elemento di lavoro. Gli elenchi globali vengono usati per condividere gli elenchi di selezione tra più tipi di elemento di lavoro definiti per una raccolta di progetti team. L'uso degli elenchi globali supporta la collaborazione tra gruppi e semplifica la manutenzione. |
CAMPI |
Definisce i campi usati per tenere traccia dei dati per il tipo di elemento di lavoro. All'interno dell'elemento FIELDS, vengono definiti tutti i campi da usare per tenere traccia dei dati. Sono inclusi i campi che si utilizzeranno per eseguire query e generare report. |
WORKFLOW |
Definisce gli elementi del flusso di lavoro che consentono di tenere traccia dello stato dell'elemento di lavoro quando passa dallo stato Nuovo a Chiuso o Completato. Questo elemento contiene il set di elementi STATE e TRANSITION che definiscono il flusso di lavoro. Il flusso di lavoro è un set di transizioni valide da uno stato all'altro e delle specifiche condizioni associate a ogni transizione. |
FORM |
Specifica la progettazione del form elemento di lavoro definendo i campi e i controlli visualizzati nel form e il relativo ordine. Contiene LAYOUT, CONTROL, GROUP, TAB, TABGROUP, SPLITTER e altro. |
Tipi di elemento di lavoro del modello di processo
Durante l'installazione o l'aggiornamento di un'istanza di TFS, i modelli di processo predefiniti vengono scaricati nella seguente directory:
%programfiles%/Microsoft Team Foundation Server 14.0/Tools/Deploy/ProcessTemplateManagerFiles/1033
I file di definizione del tipo di elemento di lavoro vengono archiviati nella cartella WorkItem Tracking\TypeDefinitions.
Per informazioni su come creare o personalizzare un tipo di elemento di lavoro, vedere Personalizzare oggetti di rilevamento degli elementi di lavoro per supportare i processi del team. Per aggiungere un nuovo tipo di elemento di lavoro al modello di processo. 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