Definire e modificare campi di elementi di lavoro

Articolo
06/09/2015

I campi elemento di lavoro vengono usati per tenere traccia dei dati per un tipo di elemento di lavoro, per definire i criteri di filtro per le query e per generare report. Qualsiasi elemento dati, a eccezione dei campi dati di sistema fondamentali in Team Foundation Server (TFS), che si desidera rilevare, usare per definire il flusso di lavoro o visualizzare sul form per un tipo di elemento di lavoro deve essere definito come campo elemento di lavoro. È possibile definire campi di elemento di lavoro nella definizione di un tipo di elemento di lavoro o di un flusso di lavoro globale.

I campi elemento di lavoro vengono gestiti per una raccolta di progetti team. Si aggiungono campi quando si esegue una delle attività seguenti:

Creare un progetto team. Vengono creati tutti i campi definiti all'interno delle definizioni per i tipi di elemento di lavoro o flusso di lavoro globale e definiti per il modello di processo selezionato. I campi fondamentali del sistema sono definiti automaticamente per ogni tipo di elemento di lavoro definito per un progetto team. Per un elenco di tali campi, vedere Riferimenti ai campi elemento di lavoro per Visual Studio ALM.
Importare una definizione per un tipo di elemento di lavoro. Tutti i nuovi campi definiti nella definizione per un tipo di elemento di lavoro vengono aggiunti alla raccolta. Per altre informazioni, vedere Riferimento a tutti gli elementi XML WITD.
Importare una definizione del flusso di lavoro globale. Tutti i nuovi campi definiti nel flusso di lavoro globale sono aggiunti alla raccolta. Si definisce un flusso di lavoro globale quando si desidera gestire un set di campi di elemento di lavoro condivisi da più tipi di elementi di lavoro. Per altre informazioni, vedere Personalizzare il flusso di lavoro globale.
Eseguire il mapping di una raccolta di progetti team a un'istanza di Project Web Access (PWA). Una volta installate le estensioni di Team Foundation Server per Project Server, configurare l'integrazione eseguendo il mapping dei vari componenti di Team Foundation. Quando si esegue il mapping di una raccolta, viene importata una definizione di flusso di lavoro globale che supporta diversi campi nei campi Project Server. Per altre informazioni, vedere Campi di Project Server aggiunti a TFS per supportare la sincronizzazione dei dati.

Tutti i campi definiti in tutti i tipi di elemento di lavoro e tutti i flussi di lavoro globali per tutti i progetti team costituiscono il set completo di campi definito per la raccolta. È possibile modificare l'attributo dei campi esistenti, rinominarli ed eliminarli. Tuttavia, si incorre in determinate spese quando si fanno questi tipi di modifiche. Per altre informazioni, vedere Personalizzare oggetti di rilevamento degli elementi di lavoro per supportare i processi del team.

Per aggiungere o personalizzare un campo per una raccolta, modificare il contenuto XML della definizione di un tipo di elemento di lavoro o di un flusso di lavoro globale. Definire ogni campo tramite un elemento FIELD all'interno della sezione FIELDS della definizione per un tipo di elemento di lavoro o un flusso di lavoro globale. Per informazioni sulla struttura e la posizione di questi file, consultare Riferimento a tutti gli elementi XML WITD and Personalizzare il flusso di lavoro globale.

Struttura di sintassi (definizione) FIELD

Ogni elemento FIELD (definizione) dispone di un nome descrittivo facoltativo e un nome di riferimento che è obbligatorio. Il nome di riferimento deve essere univoco all'interno della raccolta. Per altre informazioni, vedere Convenzioni di denominazione per oggetti di rilevamento di elementi di lavoro.

Importante

È possibile modificare il nome descrittivo per un campo tramite lo strumento da riga di comando witadmin changefield.Tuttavia, se si rinomina un campo, influisce su tutti i tipi di elemento di lavoro in tutti i progetti team all'interno della raccolta.

Definire un campo mediante la seguente sintassi XML nel file di definizione per il tipo di elemento di lavoro.

<FIELD name="fieldDisplayName"
   refname="fieldReferenceName" type="String | Integer | Double | DateTime | PlainText | HTML | History | TreePath | GUID"
   syncnamechanges="true | false"
   reportingname="reportingDisplayName"
   reportingrefname="reportingReferenceName"
   reportable="Dimension | Detail | Measure" 
   formula="sum" >
   <ALLOWEDVALUES> . . . </ALLOWEDVALUES>
   <ALLOWEXISTINGVALUE />
   <CANNOTLOSEVALUE />
   <COPY />
   <DEFAULT />
   <EMPTY />
   <FROZEN />
   <HELPTEXT> . . . </HELPTEXT>
   <MATCH />
   <NOTSAMEAS />
   <PROHIBITEDVALUES /> . . . </PROHIBITEDVALUES>
   <READONLY />
   <REQUIRED />
   <SERVERDEFAULT />
   <SUGGESTEDVALUES /> . . . </SUGGESTEDVALUES>
   <VALIDUSER />
   <WHEN>> . . . </WHEN>
   <WHENNOT> . . . </WHENNOT>
   <WHENCHANGED> . . . </WHENCHANGED>
   <WHENNOTCHANGED> . . . </WHENNOTCHANGED>
</FIELD>

Per altre informazioni, vedere Riferimento all'elemento FIELD (Definizione).

Tipi di dati

Il tipo di un campo definisce il tipo e le dimensioni dei dati che gli utenti possono archiviare in un campo. Un campo può avere un solo tipo definito in una raccolta di progetti team. Questa limitazione stimola le organizzazioni a usare campi comuni nei progetti e nei tipi di elemento di lavoro.

Nell'elenco seguente vengono indicati i tipi di campo supportati:

Tipo di dati	Descrizione
DateTime	Specifica una data sulla base dell'ora UTC (Coordinated Universal Time). Aggiungere un campo DateTime a un form elemento di lavoro usando gli attributi FieldControl o DateTimeControl type.
Double	Specifica un valore in virgola mobile. I campi Double vengono spesso usati nei filtri di query e negli elenchi di risultati. Aggiungere un campo Double a un form elemento di lavoro usando l'attributo FieldControl type.
GUID	Specifica un campo che conterrà un identificatore univoco. Non è possibile aggiungere un campo GUID a un form elemento di lavoro.
History	Supporta la visualizzazione dei thread di discussione e il rilevamento di altre informazioni cronologiche. Nota Il campo System.History è l'unico campo che usa questo tipo di dati.Non è possibile definire un campo personalizzato usando questo tipo di dati. Aggiungere il campo System.History a un form elemento di lavoro usando l'attributo WorkItemLogControl type, che supporta i controlli in formato RTF.
HTML	Supporta la possibilità di acquisire i dati RFT e usare le descrizioni di testo più lunghe, ad esempio una descrizione dell'elemento di lavoro. Un campo HTML si differenzia da un campo PlainText in quanto è fortemente tipizzato in HTML per visualizzare le informazioni in modo più ricco. Aggiungere un campo HTML a un form elemento di lavoro usando l'attributo HTMLControl type, che supporta i controlli in formato RTF.
Integer	Specifica un valore intero con segno a 32 bit. I campi Integer vengono spesso usati nei filtri di query e negli elenchi di risultati. Aggiungere un campo Integer a un form elemento di lavoro usando l'attributo FieldControl type.
PlainText	Supporta l'immissione di una stringa di testo che può contenere più di 255 caratteri Unicode. Aggiungere un campo PlainText a un form elemento di lavoro usando l'attributo di tipo FieldControl, limitato al testo normale, o l'attributo HTMLControl type, che supporta i controlli in formato RTF.
String	Supporta l'immissione di una stringa di testo che può contenere fino a 255 caratteri Unicode. Usare un campo stringa per un'etichetta o altra stringa di testo breve fino a una riga lunga. I campi String vengono spesso usati nei filtri di query e negli elenchi di risultati. Aggiungere un campo String a un form elemento di lavoro usando l'attributo FieldControl type.
TreePath	Specifica un campo che visualizza le voci una struttura ad albero o gerarchica, quali i requisiti per la visualizzazione dei percorsi di area e iterazione per un prodotto. Nota I campi System.AreaPath e System.IterationPath sono gli unici campi che utilizzano questo tipo di dati.Non è possibile definire un campo personalizzato usando questo tipo di dati. Aggiungere i campi System.AreaPath e System.IterationPath a un form elemento di lavoro usando l'attributo WorkItemClassificationControl type.

Attributi segnalabili

Alcuni valori di campi sono particolarmente utili per la creazione di report. Tramite il linguaggio di definizione del tipo di elemento di lavoro, è possibile specificare gli attributi facoltativi riportati di seguito:

reportable. Impostare l'attributo segnalabile su None, Detail, Dimension o Measure, a seconda che si desideri includere il campo nei report e con quale modalità. I dati dei campi che dispongono di un valore diverso da None per questo attributo vengono esportati nel data warehouse e possono essere inclusi nei report.

Quando si aggiunge un campo esistente a un tipo di elemento di lavoro, viene usato il valore corrente per l'attributo reportable. Quando si aggiunge un campo a un tipo di elemento di lavoro, la segnalazione è disabilitata a meno che la si specifichi in modo esplicito tramite l'attributo reportable.
reportingname. Assegnare un'etichetta differente a un campo che viene usato quando i dati vengono visualizzati nei report. Se non viene specificato alcun valore, verrà usato il nome descrittivo assegnato per l'attributo name.
reportingrefname. Assegnare un nome di riferimento differente a un campo che viene usato quando i dati vengono esportati nel data warehouse relazionale. Se non viene specificato alcun valore, verrà usato il valore assegnato all'attributo refname.

Usare questo attributo per unire o per far divergere i campi inclusi nei report. Per unire due campi che dispongono di nomi di riferimento distinti e che sono definiti in differenti raccolte di progetti, assegnare lo stesso valore di reportingrefname a entrambi i campi. Per far divergere due campi che dispongono dello stesso nome di riferimento e che sono definiti in differenti raccolte di progetti, assegnare un diverso valore di reportingrefname a ciascun campo.

Dopo aver definito un campo, è possibile usare il comando witadmin changefield in un prompt dei comandi per modificare il valore di tutti gli attributi ad eccezione dell'attributo refname.

Per informazioni sulle procedure consigliate nell'assegnazione di etichette ai campi per la creazione di report, vedere Aggiungere o modificare campi di elementi di lavoro per supportare la creazione di rapporti.

Valori dell'attributo reportable

Come descritto nella tabella riportata di seguito, è possibile assegnare uno dei valori seguenti all'attributo reportable: none (nessuno), dimension (dimensione), detail (dettagli) e measure (misura).

Nota

È possibile impostare l'attributo reportable per un campo dopo che questo è stato usato per un elemento di lavoro.Dopo avere impostato il valore segnalabile, le nuove revisioni dell'elemento di lavoro copiate nel warehouse conterranno il valore del campo.Per le revisioni già presenti nel warehouse non verranno tuttavia recuperate le informazioni relative ai valori esistenti.

Valore attributo	Descrizione
Detail	Usare il tipo Detail solo per i campi Integer, Double, String o DateTime. I dati in questo campo vengono spostati nel database warehouse relazionale nelle tabelle Elemento di lavoro ed Elemento di lavoro corrente, ma non nel cubo di SQL Server Analysis Services. Utilizzando questo tipo per i campi di testo senza restrizioni, è possibile utilizzarli nei report senza rendere il cubo significativamente più grande.
Dimension	Usare il tipo Dimension solo per i campi Integer, String o DateTime. I dati in questo campo vengono immessi nel database warehouse relazionale e nel cubo Analysis Services come attributo della dimensione dell'elemento di lavoro, in modo che i dati possano essere usati per filtrare i report. Usare questo tipo per i campi contenenti elenchi di valori validi. Tipo di elemento di lavoro e Stato sono i buoni esempi di dimensione.
Measure	Usare il tipo Measure solo per i campi Integer e Double. I tipi measure rappresentano i valori numerici nei report. Durante l'elaborazione del cubo di Analysis Services, i dati vengono precalcolati nei campi impostati su Measure. Ad esempio, i gruppi di misure Elemento di lavoro e Elemento di lavoro corrente contengono dati cumulativi per i seguenti campi: Stima originale, Ore rimanenti e Ore completate. Per altre informazioni sui gruppi di misure, vedere Prospettive e gruppi di misure forniti nel cubo di Analysis Services per Visual Studio. Quando si specifica Measure, è necessario specificare sum per l'attributo formula che restituisce la somma di ogni misura a cui la query fa riferimento.
None	Specificare None quando non si desidera includere il campo nei report. Questo valore corrisponde all'assegnazione predefinita.

Esempi che mostrano come specificare i report

Esempio di dettaglio

Esempio di dimensione

Esempio di misura

Campi indicizzati

È possibile abilitare o disabilitare l'indicizzazione per un campo elemento di lavoro tramite il comando witadmin indexfield. Quando si abilita l'indicizzazione per un campo, è possibile aumentare le prestazioni dell'individuazione degli elementi di lavoro le cui query specificano quel campo. Se si aggiunge un campo personalizzato che si usa in molte query elemento di lavoro, è necessario abilitare l'indicizzazione per quel campo. Per altre informazioni, vedere Gestire campi di elementi di lavoro [witadmin].

Elementi figlio (definizione) FIELD

Sono disponibili diversi elementi figlio facoltativi che si possono specificare per un campo elemento di lavoro, ad esempio:

Testo della Guida. Definisce la descrizione comandi o le informazioni della Guida visualizzate per un campo sul form elemento di lavoro (HELPTEXT).
Restrizioni del campo. Specifica un campo come obbligatorio, di sola lettura, vuoto, bloccato o corrispondente a un modello specifico (REQUIRED, READONLY, EMPTY, FROZEN, MATCH).
Popolazione automatica del valore del campo. Specifica un valore per il campo (DEFAULT, COPY, SERVERDEFAULT).
Elenchi del campo. Specifica valori consentiti, suggeriti o proibiti. (ALLOWEDVALUES, SUGGESTEDVALUES, PROHIBITEDVALUES)
Condizioni di campo. Applica uno o più regole a un campo quando un altro campo viene o meno modificato o dispone o meno di un valore specifico o per un'altra condizione (WHEN, WHENNOT, WHENCHANGED, WHENNOTCHANGED, CANNOTLOSEVALUE, NOTSAMEAS).

Per altre informazioni, vedere Riferimento a tutti gli elementi XML FIELD.

Campi di sistema e predefiniti

Tutti i campi di sistema definiti dispongono di nomi di riferimento che iniziano con System, ad esempio System.AreaPath, System.AssignedTo e altri simili.

I campi predefiniti, definiti dai modelli di processo predefiniti di TFS, iniziano con Microsoft.VSTS e poi si differenziano ulteriormente in base all'utilizzo. Esempi di campi predefiniti usati in comune, per scopi di pianificazione e integrazione con Microsoft Project, integrazione con Team Foundation Build e integrazione con Team Foundation sono riportati di seguito:

Microsoft.VSTS.Common.Priority
Microsoft.VSTS.Scheduling.DueDate
Microsoft.VSTS.Build.FoundIn
Microsoft.VSTS.TCM.Steps

Per una panoramica di tutti i campi di sistema e predefiniti definiti per i modelli di processo predefiniti forniti da TFS, vedere Riferimenti ai campi elemento di lavoro per Visual Studio ALM. Per altre informazioni sulla specifica dei nomi dei campi, vedere Convenzioni di denominazione per oggetti di rilevamento di elementi di lavoro.

Attributi nascosti e non variabili e lo strumento di esplorazione dei campi degli elementi di lavoro

Oltre agli attributi modificabili, per un campo elemento di lavoro esiste una serie di attributi non modificabili e virtualmente nascosti. È possibile cercare le assegnazioni di questi campi usando lo strumento Esplorazione dei campi degli elementi di lavoro. Accedere allo strumento di esplorazione dei campo degli elementi di lavoro dallo strumento avanzato Editor di processo.

Finestra di esplorazione dei campi degli elementi di lavoro

Nota

Lo strumento Editor di processo fornisce un'interfaccia utente grafica mediante la quale è possibile personalizzare i modelli di processo di Team Foundation Server.Questo strumento può essere usato per importare ed esportare tipi di elementi di lavoro, modificare il contenuto del modello di processo ed esplorare il set di campi definiti per una raccolta di progetti team.Per altre informazioni, vedere la pagina nel sito Web Microsoft Power Tools di Team Foundation Server.

Vedere anche

Share via