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 dati, a eccezione dei campi dati di sistema fondamentali, 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 un 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 un insieme di progetti team. Si aggiungono campi quando si esegue una delle attività seguenti:

• Viene creato 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. Per ulteriori informazioni, vedere Campi elemento di lavoro (Agile) o Campi dell'elemento di lavoro (CMMI). 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 Utilizzo dei campi di sistema e dei campi definiti tramite i modelli di processo MSF.

• Viene importata 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 all'insieme. Per ulteriori informazioni, vedere Riferimento a tutti gli elementi XML WITD.

• Importa una definizione del flusso di lavoro globale. Tutti i nuovi campi definiti nel flusso di lavoro globale sono aggiunti all'insieme. 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 Personalizzazione del flusso di lavoro globale.

• esegue il mapping di un insieme di progetti team a un'istanza di Project Web Access. Dopo avere installato Visual Studio Team Foundation Server 2010 ed il feature pack di Project Server Integration, si configura l'integrazione eseguendo il mapping di vari componenti di Team Foundation. Quando si esegue il mapping di un insieme, 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 l'insieme. È 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 Personalizzazione di dati di rilevamento, form, flusso di lavoro e gli altri oggetti del progetto.

Per aggiungere o personalizzare un campo per un insieme, 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 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 Personalizzazione del 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 dell'insieme. 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 dell'insieme.

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="avg" >
   <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 per Team Foundation Server. 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). È possibile aggiungere un campo DateTime a un form elemento di lavoro tramite gli attributi FieldControl, type o DateTimeControl.
Double	Specifica un valore in virgola mobile. I campi Double vengono spesso utilizzati nei filtri di query e negli elenchi di risultati. È possibile aggiungere un campo Double a un form elemento di lavoro tramite 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 utilizza questo tipo di dati.Non è possibile definire un campo personalizzato utilizzando questo tipo di dati. È possibile aggiungere il campo System.History a un form elemento di lavoro tramite l'attributo WorkItemLogControl type 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. È possibile aggiungere un campo HTML a un form elemento di lavoro tramite l'attributo HTMLControl type 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. È possibile aggiungere un campo Integer a un form elemento di lavoro tramite l'attributo FieldControl type.
PlainText	Supporta l'immissione di una stringa di testo che può contenere più di 255 caratteri Unicode. È possibile aggiungere un campo PlainText a un form elemento di lavoro tramite l'attributo di tipo FieldControl limitatamente al testo normale o l'attributo HTMLControl type 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. È possibile aggiungere un campo String a un form elemento di lavoro tramite 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 utilizzando questo tipo di dati. È possibile aggiungere i campi System.AreaPath e System.IterationPath a un form elemento di lavoro tramite l'attributo 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. Si imposta l'attributo segnalabile su None, Detail, Dimension o Measure, in base a se e come si desidera che il campo venga incluso 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. È possibile assegnare a un campo un'etichetta diversa utilizzata quando i dati vengono visualizzati nei rapporti. Se non viene specificato alcun valore, verrà utilizzato il nome descrittivo assegnato per l'attributo name.

• reportingrefname. È possibile 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.

  È possibile utilizzare questo attributo sia per unire sia per far divergere i campi inclusi nei rapporti. Per unire due campi che dispongono di nomi di riferimento distinti e che sono definiti in differenti insiemi 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 insiemi 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 Aggiunta e modifica di 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 Gruppi di misure e metrica 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 Gestione di 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 di Microsoft Solutions Framework (MSF) iniziano con Microsoft.VSTS e quindi si differenziano ulteriormente in base all'utilizzo. Esempi di campi predefiniti utilizzati in comune, per scopi di pianificazione e integrazione con Office 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 il modello di processo MSF for Agile Software Development v5.0, vedere Utilizzo dei campi di sistema e dei campi definiti tramite i modelli di processo MSF. Per ulteriori informazioni sulla specifica dei nomi dei campi, vedere Convenzioni di denominazione per oggetti di rilevamento di elementi di lavoro.

Torna all'inizio

Vedere anche

Attività

Aggiungere o rimuovere un campo in un tipo di elemento di lavoro

Riferimenti

Gestione di campi degli elementi di lavoro [witadmin]

Elemento FIELD (Definizione)

Concetti

Riferimento a tutti gli elementi XML WITD

Riferimento a tutti gli elementi XML FIELD

Altre risorse

Risoluzione dei conflitti di schema che si verificano nel data warehouse

Aggiunta e modifica di campi elemento di lavoro per supportare la creazione di rapporti

Definizione dei campi elemento di lavoro

Cronologia delle modifiche

Data	Cronologia	Motivo
Gennaio 2011	Informazioni aggiunte relative al flusso di lavoro globale e aggiornate diverse sezioni con collegamenti agli argomenti correlati. Rimossa la sezione relativa alla definizione dello schema.	Miglioramento delle informazioni.