Utilizzo dei campi elementi di lavoro

I campi elemento di lavoro vengono utilizzati per tenere traccia dei dati per un tipo di elemento di lavoro, per definire i criteri di filtro per le query e per generare rapporti.Qualsiasi elemento di dati, ad eccezione dei campi dati principali del sistema in Team Foundation Server (TFS), che si desidera rilevare, utilizzare 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 Riferimento ai campi degli elementi di lavoro per ALM di Visual Studio.

• 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 ulteriori informazioni, vedere Riferimento a tutti gli elementi XML WITD.

• Importare una definizione di 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 ulteriori informazioni, vedere Personalizzare il flusso di lavoro globale.

• Eseguire il mapping di una raccolta di progetti team a un'istanza di Project Web App (PWA).Dopo avere installato le estensioni di Team Foundation Server per Project Server, configurare l'integrazione eseguendo il mapping di 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 ulteriori informazioni, vedere Campi di Project Server aggiunti 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 ulteriori informazioni, vedere Personalizzare dati di rilevamento, form, flusso di lavoro e altri oggetti del progetto.

Per aggiungere o personalizzare un campo da una raccolta, modificare il contenuto XML per la definizione di un tipo di elemento di lavoro o flusso di lavoro globale.Definire ogni campo tramite un elemento di FIELD nella sezione di FIELDS la definizione per un tipo di elemento di lavoro o 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.

In questo argomento

• Struttura di sintassi (definizione) FIELD

• Tipi di dati di campo

• Attributi segnalabili assegnati ai campi

• Campi indicizzati

• Elementi figlio (definizione) FIELD

• Campi di sistema e campi predefiniti

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 ulteriori 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 dalla sintassi XML seguente 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 ulteriori informazioni, vedere Elemento FIELD (Definizione).

Torna all'inizio

Tipi di dati di campo

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 utilizzare 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 di DateTime a un form elemento di lavoro tramite gli attributi di DateTimeControl o di FieldControltype.
Double	Specifica un valore in virgola mobile.I campi Double vengono spesso utilizzati nei filtri di query e negli elenchi di risultati. Aggiungere un campo di Double a un form elemento di lavoro tramite l'attributo di FieldControltype.
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 utilizza questo tipo di dati.Non è possibile definire un campo personalizzato utilizzando questo tipo di dati. Aggiungere il campo di System.History a un form elemento di lavoro tramite l'attributo di WorkItemLogControltype che supporta i controlli del formato RTF.
HTML	Supporta la possibilità di acquisire i dati RFT e utilizzare 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 di HTML a un form elemento di lavoro tramite l'attributo di HTMLControltype, che supporta i controlli del formato RTF.
Integer	Specifica un Signed Integer a 32 bit.I campi Integer vengono spesso utilizzati nei filtri di query e negli elenchi di risultati. Aggiungere un campo di Integer a un form elemento di lavoro tramite l'attributo di FieldControltype.
PlainText	Supporta l'immissione di una stringa di testo che può contenere più di 255 caratteri Unicode. Aggiungere un campo di PlainText a un form elemento di lavoro tramite l'attributo di tipo di FieldControl limitatamente al testo normale, o l'attributo di HTMLControltype che supporta i controlli del formato RTF.
String	Supporta l'immissione di una stringa di testo che può contenere fino a 255 caratteri Unicode.Utilizzare un campo stringa per un'etichetta o altra stringa di testo breve fino a una riga lunga.I campi String vengono spesso utilizzati nei filtri di query e negli elenchi di risultati. Aggiungere un campo di String a un form elemento di lavoro tramite l'attributo di FieldControltype.
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 utilizzando questo tipo di dati. Aggiungere campi di System.IterationPath e di System.AreaPath a un form elemento di lavoro tramite l'attributo di WorkItemClassificationControl type.

Torna all'inizio

Attributi segnalabili assegnati ai campi

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 a None, a Detail, a Dimension, o a Measure, come se e come si desidera che il campo da includere nei rapporti.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 rapporti.

  Quando si aggiunge un campo esistente a un tipo di elemento di lavoro, viene utilizzato 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 diversa a un campo utilizzato quando i dati vengono visualizzati nei rapporti.Se non viene specificato alcun valore, verrà utilizzato il nome descrittivo assegnato per l'attributo name.

• reportingrefname.Assegnare un nome di riferimento diverso a un campo utilizzato quando i dati vengono esportati nel data warehouse relazionale.Se non viene specificato alcun valore, verrà utilizzato il valore assegnato all'attributo refname.

  Utilizzare questo attributo a unione o diverga campi inclusi nei rapporti.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 utilizzare 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 rapporti, vedere Aggiungere e modificare campi elemento di lavoro per supportare la creazione di rapporti.

Torna all'inizio

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 utilizzato 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	Utilizzare 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 rapporti senza rendere il cubo significativamente più grande.
Dimension	Utilizzare il tipo Dimension solo per i campi Integer, Double, 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 utilizzati per filtrare i rapporti.Utilizzare questo tipo per i campi contenenti elenchi di valori validi.Tipo di elemento di lavoro e Stato sono i buoni esempi di dimensione.
Measure	Utilizzare 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 ulteriori informazioni sui gruppi di misure, vedere Prospettive e gruppi di misure forniti nel cubo di Analysis Services per Team System. 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 rapporti.Questo valore corrisponde all'assegnazione predefinita.

Torna all'inizio

Esempi che mostrano come specificare i rapporti

Esempio di dettaglio

<FIELD refname="MyCorp.Summary" name="Summary" type="String" reportable="detail">

Esempio di dimensione

<FIELD refname="MyCorp.Category" name="Category" type="String" reportable="dimension">

Esempio di misura

<FIELD refname="MyCorp.Cost" name="Cost" type="Integer" reportable="measure" formula="sum">

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 utilizza in molte query elemento di lavoro, è necessario abilitare l'indicizzazione per quel campo.Per ulteriori informazioni, vedere Gestire i campi degli elementi di lavoro [witadmin].

Torna all'inizio

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 ulteriori informazioni, vedere Riferimento a tutti gli elementi XML FIELD.

Torna all'inizio

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 che il TFS fornisce l'inizio con Microsoft.VSTS e quindi si differenziano ulteriormente in base al relativo utilizzo.Esempi di campi predefiniti utilizzati 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 che il TFS assicura, vedere Riferimento ai campi degli elementi di lavoro per ALM di Visual Studio.Per ulteriori informazioni sulla specifica dei nomi dei campi, vedere Convenzioni di denominazione per oggetti di rilevamento di elementi di lavoro.

Torna all'inizio

Attributi nascosti e non variabili e il campo elemento di lavoro Esplora Risorse

Oltre agli attributi che è possibile modificare per un campo elemento di lavoro, sono disponibili numerosi attributi non variabili e virtualmente nascosti per ogni campo.È possibile trovare le assegnazioni di questi campi utilizzando lo strumento di esplorazione del campo elemento di lavoro.Accedere allo strumento di esplorazione del campo elemento di lavoro dallo strumento avanzato del processo dell'editor.

Campo elemento di lavoro Esplora Risorse

[!NOTA]

Lo strumento avanzato del processo dell'editor fornisce un'interfaccia utente grafica per personalizzare i modelli di processo di Team Foundation Server.È possibile utilizzare questo strumento per importare ed esportare i tipi di elemento di lavoro, modificare il contenuto del modello di processo ed esplorare il set di campi definiti per una raccolta di progetti team.Per ulteriori informazioni, vedere la pagina seguente sul sito Web Microsoft: Power Tool di Team Foundation Server.

Vedere anche

Riferimenti

Gestire i campi degli elementi di lavoro [witadmin]

Concetti

Personalizzare la gestione degli elementi di lavoro per il progetto team

Aggiungere e modificare campi elemento di lavoro per supportare la creazione di rapporti

Riferimento a tutti gli elementi XML FIELD

Altre risorse

Definire campi elemento di lavoro