Riferimento all'elemento FIELD (Definizione)

Usare l'elemento FIELD (definizione) per definire un campo elemento di lavoro e specificare le regole e le condizioni che vi si applicano. Con gli attributi assegnati a un campo si determina il tipo di dati e se è disponibile per l'inclusione nei rapporti.

Nota

Per informazioni sull'elemento FIELD (Flusso di lavoro) che si utilizza per specificare le regole e le condizioni nei campi durante una modifica dello stato o una transizione del flusso di lavoro, vedere Elemento FIELD (Flusso di lavoro).

Gerarchia dello schema

WITD

   WORKITEMTYPE

      FIELDS

            FIELD

<FIELD name="fieldDisplayName" 
refname="fieldReferenceName" 
type="String | Integer | Double | DateTime | PlainText | HTML | History | TreePath | GUID" 
syncnamechanges ="true | false" 
reportable="Dimension | Detail | Measure"
formula="sum"
reportingname="ReportingDisplayName" 
reportingrefname="ReportingReferenceName" >
   <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>

Attributi ed elementi

Nelle sezioni seguenti vengono descritti gli attributi, gli elementi figlio e gli elementi padre.

Attributi

Attributo	Descrizione
name	Obbligatorio. Il nome descrittivo del campo visualizzato nei menu a discesa di query elemento di lavoro. È necessario che il nome descrittivo sia univoco in tutti i campi definiti all'interno di un progetto team. Inoltre, è possibile che il nome descrittivo differisca dall'etichetta visualizzata accanto al campo nel form dell'elemento di lavoro. Per altre informazioni, vedere Riferimento all'elemento XML Control. Il tipo dell'attributo è typelib:FieldName. Lunghezza minima: 1; lunghezza massima: 128. Valore di schema: ^[^\. \[\]]+$ Esempio di valore di schema: Assegnato a
refname	Obbligatorio. Etichetta univoca con cui un campo viene distinto da tutti gli altri campi definiti nell'insieme di progetti team. Per ulteriori requisiti e limitazioni dei nomi descrittivi e nomi di riferimento, vedere Convenzioni di denominazione per oggetti di rilevamento di elementi di lavoro. Il tipo dell'attributo è typelib:ReferenceFieldName. Lunghezza minima: 1; lunghezza massima: 70. Valore di schema:^[a-zA-Z_][a-zA-Z0-9_]*(\.[a-zA-Z0-9_]+)+$ Esempio di valore di schema: Company.IssueType
type	Obbligatorio. Specifica il tipo di dati accettati dal campo. Nota È necessario che ai campi in raccolte di progetti diversi che dispongono di uno stesso reportingrefname venga assegnato il medesimo valore per type.Se i valori differiscono, è possibile che si verifichino conflitti di dati all'elaborazione del data warehouse.Per altre informazioni, vedere Risolvere conflitti di schema che si verificano nel data warehouse. Nella tabella riportata di seguito sono elencati i valori validi per questo attributo: Valore Utilizzo DateTime Specifica una data sulla base dell'ora UTC (Coordinated Universal Time). Double Specifica un valore in virgola mobile. GUID Specifica un campo che conterrà un identificatore univoco. History Supporta i thread di discussione e tiene traccia di altre informazioni sulla cronologia. Nota Il campo System.History è l'unico campo che utilizza questo tipo di dati.Non è possibile definire un campo personalizzato usando questo tipo di dati. HTML Supporta l'acquisizione di dati di testo RFT e viene usato per descrizioni di testo più lunghe, ad esempio una descrizione dell'elemento di lavoro. Integer Specifica un valore intero con segno a 32 bit. PlainText Supporta l'immissione di una stringa di testo che può contenere più di 255 caratteri Unicode. 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. TreePath Specifica un campo in cui vengono visualizzate voci in una struttura gerarchica o in una struttura ad albero, come quella richiesta per visualizzare l'area e i percorsi di iterazione di un prodotto. Per definire i nodi figlio, vedere Aggiungere e modificare percorsi di area e di iterazione. 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.
syncnamechanges	Parametro facoltativo. Specifica se il campo elemento di lavoro viene usato per l'archiviazione di nomi che si desidera aggiornare quando si effettuano modifiche in Active Directory o in un gruppo di lavoro. Questa opzione è valida solo quando type="String". Il tipo dell'attributo è xs:boolean. Specificare true per abilitare la sincronizzazione per il campo dati, specificare false per disabilitarla.
reportable	Parametro facoltativo. Specifica se i dati del campo sono disponibili per l'inclusione nei rapporti. I campi con valore predefinito None non vengono né esportati nel data warehouse relazionale né elaborati per il cubo di SQL Server Analysis Services. Per altre informazioni sui campi segnalabili, vedere Aggiungere o modificare campi di elementi di lavoro per supportare la creazione di rapporti. Nota È necessario che ai campi in raccolte di progetti diversi che dispongono di uno stesso valore per reportingrefname venga assegnato il medesimo valore per reportable.Se i valori differiscono, è possibile che si verifichino conflitti di dati all'elaborazione del data warehouse.Per altre informazioni, vedere Risolvere conflitti di schema che si verificano nel data warehouse. Nella tabella riportata di seguito sono elencati i valori validi per questo attributo: Value Utilizzo Detail Può essere specificato per i campi di tipo DateTime, Double, Integer o String. 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 Analysis Services. Questo tipo rappresenta una scelta ottimale per i campi di testo senza restrizioni in quanto è possibile utilizzarli nei rapporti senza rendere il cubo significativamente più grande. Dimension Può essere specificato per i campi di tipo DateTime, Integer, String o TreePath. 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 rapporti. 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 di misura solo per i campi Integer e Double. I tipi measure rappresentano i valori numerici nei report. Quando viene elaborato il cubo di Analysis Services, i dati vengono precalcolati in campi i cui attributi reportable sono impostati sulla misura. 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. Quando si specifica la misura, è necessario specificare l'attributo formula. None Specificare None quando non si desidera usare il campo per l'inclusione nei rapporti. Si tratta dell'assegnazione predefinita.
formula	Parametro facoltativo. Tipo di aggregazione per il tipo measure segnalabile. L'unico valore valido è sum, mediante il quale viene restituita la somma di tutti i valori nel set.
reportingname	Parametro facoltativo. Specifica il nome visualizzato nei rapporti. Se non viene specificato alcun valore, verrà usato il valore assegnato all'attributo name. Nota È necessario che ai campi in raccolte di progetti diversi che dispongono di uno stesso reportingrefname venga assegnato il medesimo valore per reportingname.Se i valori differiscono, è possibile che si verifichino conflitti di dati all'elaborazione del data warehouse.Per altre informazioni, vedere Risolvere conflitti di schema che si verificano nel data warehouse. Il tipo dell'attributo è typelib:FieldName. Lunghezza minima: 1; lunghezza massima: 128. Valore di schema: ^[^\. \[\]]+$ Esempio di valore di schema: Assegnato a
reportingrefname	Parametro facoltativo. Specifica il nome di riferimento usato quando viene elaborato un campo segnalabile. Se non viene specificato alcun valore, verrà usato il valore assegnato all'attributo refname. È possibile usare questo attributo per unire o fare divergere campi elaborati nel data warehouse. Per unire due campi con 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, ma che sono definiti in differenti raccolte di progetti, assegnare un diverso valore di reportingrefname a ciascun campo. È necessario unire i campi ogni qualvolta è possibile al fine di minimizzare il numero di campi nel database warehouse e di mantenere il numero al disotto del limite massimo di 1024 campi segnalabili. È possibile generare rapporti tra gruppi con i campi uniti. Il tipo dell'attributo è typelib:ReferenceFieldName. Lunghezza minima: 1; lunghezza massima: 70. Valore di schema:^[a-zA-Z_][a-zA-Z0-9_]*(\.[a-zA-Z0-9_]+)+$ Esempio di valore di schema: Company.IssueType

Elementi figlio

Elemento	Descrizione
ALLOWEDVALUES	Parametro facoltativo. Definisce un elenco di valori consentiti per il campo. I valori consentiti sono i valori selezionabili in un elenco di campi disponibile in form di elementi di lavoro e nel generatore di query. È necessario selezionare uno di questi valori.
ALLOWEXISTINGVALUE	Parametro facoltativo. Definisce il campo in modo da consentire i valori esistenti. Tramite questo elemento è possibile usare i valori del campo già esistenti, anche se non sono validi. Tutti i nuovi valori di campo devono essere validi.
CANNOTLOSEVALUE	Parametro facoltativo. Definisce il campo in modo che non possa perdere il valore. Tramite questo elemento viene mantenuto il valore del campo corrente e non può essere deselezionato o lasciato vuoto.
COPY	Parametro facoltativo. Specifica un altro campo contenente un valore da copiare nel campo corrente.
DEFAULT	Parametro facoltativo. Definisce un valore predefinito per il campo.
EMPTY	Parametro facoltativo. Definisce il campo come vuoto.
FROZEN	Parametro facoltativo. Definisce il campo come bloccato. Un campo bloccato non può essere impostato su un valore non vuoto dopo che è stato eseguito il commit delle modifiche. Tuttavia, è possibile deselezionare manualmente il campo, salvare l'elemento di lavoro, quindi specificare un valore diverso.
HELPTEXT	Parametro facoltativo. Definisce il testo visualizzato nella descrizione comandi per il campo.
MATCH	Parametro facoltativo. Definisce un criterio per il campo a cui deve corrispondere il valore del campo.
NOTSAMEAS	Parametro facoltativo. Specifica un altro campo il cui valore non può essere identico al valore del campo corrente.
PROHIBITEDVALUES	Parametro facoltativo. Definisce un elenco di valori non consentiti per il campo.
READONLY	Parametro facoltativo. Definisce il campo come di sola lettura.
REQUIRED	Parametro facoltativo. Definisce il campo come obbligatorio.
SERVERDEFAULT	Parametro facoltativo. Specifica un componente server tramite cui verrà fornito il valore per il campo.
SUGGESTEDVALUES	Parametro facoltativo. Definisce un elenco di valori consigliati per il campo. I valori suggeriti sono i valori selezionabili in un elenco di campi disponibile in form di elementi di lavoro e nel generatore di query. È possibile immettere altri valori oltre a quelli presenti nell'elenco.
VALIDUSER	Parametro facoltativo. Specifica che l'elenco di valori consentiti deve essere costituito solo da utenti validi del sistema.
WHEN	Parametro facoltativo. Specifica una o più regole da applicare al campo corrente quando un altro campo ha un valore specifico.
WHENCHANGED	Parametro facoltativo. Specifica una o più regole da applicare al campo corrente quando il valore di un campo specifico viene modificato.
WHENNOT	Parametro facoltativo. Specifica una o più regole da applicare al campo corrente quando un altro campo non dispone di un valore specifico.
WHENNOTCHANGED	Parametro facoltativo. Specifica una o più regole da applicare al campo corrente quando il valore di un campo specifico non viene modificato.

Elementi padre

Elemento	Descrizione
FIELDS	Obbligatorio. Contiene le definizioni dei campi del tipo di elemento di lavoro.

Note

1. FIELD (Definizione) è un elemento figlio obbligatorio di FIELDS (Definizione).

2. Per una panoramica di tutti i campi predefiniti e di sistema definiti per i modelli di processo di TFS, vedere Riferimenti ai campi elemento di lavoro per Visual Studio ALM.

3. Non è possibile definire un campo personalizzato che inizi con il prefisso System.. È possibile definire un campo usando il prefisso Microsoft., tuttavia questa pratica è vivamente sconsigliata perché potrebbe impedire le funzionalità di Team Foundation Server.

   Per ulteriori requisiti e limitazioni dei nomi di riferimento e nomi descrittivi di campo, vedere Convenzioni di denominazione per oggetti di rilevamento di elementi di lavoro.

4. È rinominare il nome descrittivo di un campo, ma non i nomi di riferimento del campo. È possibile elencare campi e modificare diversi attributi dei campi con lo strumento della riga di comando witadmin. Vedere Gestire campi di elementi di lavoro [witadmin].

5. È possibile definire un massimo di 1.024 campi elemento di lavoro nello stesso insieme di progetti team e impostare un massimo di 1.024 campi sul tipo segnalabile in tutte le raccolte di progetti team.

   Tutti i campi definiti in tutti i tipi di elemento di lavoro per tutti i progetti team definiti per un insieme di progetti sono relativi a un insieme di progetti team. Pertanto, è necessario che gli attributi assegnati ai campi definiti in un tipo di elemento di lavoro corrispondano in tutti i tipi di elementi di lavoro per tutti i progetti team in una raccolta. Inoltre, tutti i campi segnalabili da tutte le raccolte vengono esportati nei database del data warehouse.

6. Per informazioni su come etichettare i campi per la creazione di rapporti, vedere Aggiungere o modificare campi di elementi di lavoro per supportare la creazione di rapporti.

7. Quando si aggiunge un campo esistente a un tipo di elemento di lavoro diverso, impostare in modo esplicito gli attributi di creazione rapporti in modo che corrispondano alla definizione di campo corrente o lasciare i valori predefiniti.

   Possono verificarsi conflitti di schema se attributi di creazione rapporti diversi vengono assegnati allo stesso campo in tipi di elementi di lavoro diversi o agli stessi tipi di elementi di lavoro in progetti team diversi. Per risolvere questi conflitti, vedere Risolvere conflitti di schema che si verificano nel data warehouse.

8. Per comprendere come vengono usati i campi per supportare query, rapporti e gestione di elementi di lavoro, vedere Modificare o aggiungere un campo per supportare query, report e flusso di lavoro.

9. Per informazioni generali su come applicare vincoli o condizioni a un oggetto FIELD usando gli elementi figlio, vedere Applicare una regola a un campo elemento di lavoro.

Esempio

<FIELD name="Activity" refname="Microsoft.VSTS.Common.Activity" type="String" reportable="dimension">
   <HELPTEXT>Type of work involved</HELPTEXT>
   <SUGGESTEDVALUES>
      <LISTITEM value="Development"/>
      <LISTITEM value="Testing"/>
      <LISTITEM value="Requirements"/>
      <LISTITEM value="Design"/>
      <LISTITEM value="Deployment"/>
      <LISTITEM value="Documentation"/>
   </SUGGESTEDVALUES>
</FIELD>

Vedere anche

Riferimenti

Gestire campi di elementi di lavoro [witadmin]

Concetti

Convenzioni di denominazione per oggetti di rilevamento di elementi di lavoro

Riferimenti ai campi elemento di lavoro per Visual Studio ALM

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

Definire e modificare campi di elementi di lavoro

Altre risorse

Gestione elementi di lavoro: indice delle definizioni di elementi XML