Condividi tramite

Riferimento a tutti gli elementi XML FIELD

  • Articolo

È possibile utilizzare le informazioni fornite in questo argomento come riferimento rapido relativo a tutti gli elementi e gli attributi principali che definiscono un campo dati per un tipo di elemento di lavoro.Si specificano questi elementi nel contenitore dell'elemento FIELD (definizione).Aggiungere un campo per un tipo di elemento di lavoro specificando un elemento FIELD (definizione) nell'elemento FIELDS (definizione).È possibile specificare questi elementi all'interno della definizione di un tipo di elemento di lavoro o come parte di un flusso di lavoro globale.È possibile creare gli elementi figlio descritti in questo argomento per specificare il comportamento di un campo, definire valori predefiniti o definire un elenco di selezione di valori.È possibile utilizzare gli elementi regola di campo in combinazione fra di loro.È possibile definire l'ambito per la maggior parte delle regole in modo da applicarle a uno o più utenti o gruppi o da ignorarle per uno o più utenti o gruppi.

Tutti gli elementi figlio dell'elemento FIELD sono facoltativi.A parte l'elemento HELPTEXT, è possibile specificare tutti gli elementi come elementi figlio degli elementi FIELD (definizione), FIELD (flusso di lavoro) e FIELD (flusso di lavoro globale).Utilizzare l'elemento FIELD (definizione) per definire un campo elemento di lavoro e specificare le regole e le condizioni che vi si applicano.Specificare le regole affinché un elemento FIELD (flusso di lavoro) definisca il valore o applichi regole a un campo come transizioni dell'elemento di lavoro da uno stato a un altro.È possibile specificare regole di campo basate sull'elemento STATE, TRANSITION, DEFAULTREASON o REASON il cui elemento padre FIELDS è un figlio.Per ulteriori informazioni, vedere Utilizzo dei campi elementi di lavoro e Progettare il flusso di lavoro.

In questo argomento

  • Elemento contenitore FIELD (definizione)

  • Elementi figlio FIELD

  • Elementi figlio GLOBALLIST e LISTITEM

  • Attributi specificati da elementi figlio FIELD

Elemento contenitore FIELD (definizione)

Si utilizza la sintassi seguente per definire i campi dati per un tipo di elemento di lavoro.Questo esempio mostra il formato dell'elemento FIELD (definizione) e di tutti gli elementi figlio facoltativi.Per ulteriori informazioni, vedere Elemento FIELD (Definizione).

<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>

Elementi figlio FIELD

Nella tabella seguente vengono descritti gli elementi figlio da specificare per l'applicazione delle regole per l'assegnazione di un valore a un campo.Tutti gli elementi figlio sono facoltativi.È possibile definire l'ambito degli elementi figlio da applicare solo a un gruppo singolo o a tutti ad eccezione degli utenti in un gruppo singolo.

Elemento

Descrizione e sintassi

ALLOWEDVALUES

Definisce un elenco di valori che gli utenti possono specificare in un elenco di campi nei form elemento di lavoro e nell'editor query.Gli utenti devono specificare uno dei valori elencati.

<ALLOWEDVALUES for="userGroupName" not="userGroupName" 
expanditems="true | false" filteritems="excludegroups">
   <GLOBALLIST name="globalListName">
      <LISTITEM value="Name" />
. . . 
   </GLOBALLIST>
</ALLOWEDVALUES>

Per ulteriori informazioni, vedere Definire elenchi di opzioni.

ALLOWEXISTINGVALUE

Specifica che un campo può mantenere un valore esistente, anche se non si trova più in un elenco di selezione.Tutti i nuovi valori del campo devono trovarsi nell'elenco.

<ALLOWEXISTINGVALUE />

Per ulteriori informazioni, vedere Definire elenchi di opzioni.

CANNOTLOSEVALUE

Specifica che gli utenti non possono deselezionare tutti i valori di un campo dopo aver specificato un valore.Se il campo contiene un valore, quel campo deve contenere sempre un valore diverso da Null.

<CANNOTLOSEVALUE for="userGroupName" not="userGroupName" />

Per ulteriori informazioni, vedere Impostare condizioni su un campo elemento di lavoro.

COPY

Copia un valore specificato in un campo quando un utente crea o modifica un elemento di lavoro.

<COPY for="userGroupName" not="userGroupName"  
from="value | field | clock | currentuser" 
value="valueToCopy" field="fieldReferenceName" />

Per ulteriori informazioni, vedere Definire un valore predefinito o copiare un valore in un campo.

DEFAULT

Specifica un valore per un campo vuoto quando un utente crea o modifica un elemento di lavoro.Se è già presente un valore, la regola predefinita viene ignorata.

<DEFAULT for="userGroupName" not="userGroupName" 
from="value | field | clock | currentuser" 
value="value to copy" field="field reference name" />

Per ulteriori informazioni, vedere Definire un valore predefinito o copiare un valore in un campo.

EMPTY

Cancella qualsiasi valore contenuto nel campo.La regola EMPTY rende inoltre un campo di sola lettura e l'utente non deve utilizzarlo insieme alla regola READONLY.

Il valore del campo viene deselezionato quando un utente salva l'elemento di lavoro e non è possibile specificare alcun valore.Questa regola viene utilizzata principalmente durante la transizione dello stato per deselezionare i campi che si applicano allo stato nel quale si sta eseguendo la transizione dell'elemento.

<EMPTY for="userGroupName" not=" userGroupName" />

Per ulteriori informazioni, vedere Impostare condizioni su un campo elemento di lavoro.

FROZEN

Specifica che non è possibile modificare il campo su un valore non vuoto dopo che è stato eseguito il commit delle modifiche.Quando un utente salva l'elemento di lavoro con un valore in quel campo, il valore non può essere più modificato.

<FROZEN for="userGroupName" not="userGroupName" />

Per ulteriori informazioni, vedere Impostare condizioni su un campo elemento di lavoro.

HELPTEXT

Definisce il testo che appare quando un utente punta al campo nel form elemento di lavoro.

toolTipText: stringa di testo di lunghezza compresa tra 1 e 255 caratteri.

<HELPTEXT>tooltipText </HELPTEXT>

Per ulteriori informazioni, vedere Definire il testo della Guida di un campo elemento di lavoro.

MATCH

Definisce un modello a cui devono corrispondere i valore dei campi di tipo String.

<MATCH pattern="patternValue" for="userGroupName" not="userGroupName" />

Per ulteriori informazioni, vedere Impostare la corrispondenza di un campo stringa a un modello.

NOTSAMEAS

Specifica che a un campo non è assegnato lo stesso valore di quello al quale è assegnato un altro campo specificato.Il valore dell''attributo field deve essere un nome di riferimento valido di un campo.

<NOTSAMEAS field="fieldReferenceName" for="userGroupName" not="userGroupName" />

Per ulteriori informazioni, vedere Impostare condizioni su un campo elemento di lavoro.

PROHIBITEDVALUES

Definisce un elenco di valori che un campo non può contenere.Gli utenti non possono salvare un elemento di lavoro se il campo contiene un valore non consentito.

<PROHIBITEDVALUES for="userGroupName" not="userGroupName" 
expanditems="true | false" filteritems="excludegroups">
   <GLOBALLIST name="globalListName">
      <LISTITEM value="Name" />
. . . 
   </GLOBALLIST>
</PROHIBITEDVALUES>

Per ulteriori informazioni, vedere Definire elenchi di opzioni.

READONLY

Specifica che non è possibile modificare il valore al quale è assegnato il campo.

<READONLY for="userGroupName" not="userGroupName" />
NotaNota
Non utilizzare questo elemento con l'elemento EMPTY perché anche EMPTY rende un campo di sola lettura.Se si combinano questi elementi, i risultati saranno incoerenti.

Per ulteriori informazioni, vedere Impostare condizioni su un campo elemento di lavoro.

REQUIRED

Specifica che gli utenti devono specificare un valore per il campo.I campi obbligatori non possono essere vuoti.Gli utenti non possono salvare un elemento di lavoro fino a che non avranno assegnato valori a tutti i campi obbligatori.

<REQUIRED for="userGroupName" not="userGroupName" />

Per ulteriori informazioni, vedere Impostare condizioni su un campo elemento di lavoro.

SERVERDEFAULT

Copia un valore del server specificato in un campo quando un utente salva un elemento di lavoro.Questi campi in genere appaiono come campi di sola lettura nel form.

<SERVERDEFAULT for="userGroupName" not="userGroupName" 
from="clock | currentuser" />

Per ulteriori informazioni, vedere Definire un valore predefinito o copiare un valore in un campo.

SUGGESTEDVALUES

Definisce un elenco suggerito di valori che gli utenti possono specificare in un elenco di campo sui form elementi di lavoro e nell'editor query.Gli utenti possono specificare valori diversi da quelli suggeriti.

<SUGGESTEDVALUES for="userGroupName" not="userGroupName" 
expanditems="true | false" filteritems="excludegroups">
   <GLOBALLIST name="globalListName">
      <LISTITEM value="Name" />
. . . 
   </GLOBALLIST>    
</SUGGESTEDVALUES>

Per ulteriori informazioni, vedere Definire elenchi di opzioni.

VALIDUSER

Impedisce agli utenti che appartengono al gruppo specificato di modificare gli elementi di lavoro.Il gruppo predefinito è Valid Users di Team Foundation.

Tutti gli attributi sono facoltativi.Tutti gli attributi devono essere costituiti da una stringa di testo che contiene da 1 a 255 caratteri.È possibile utilizzare token per specificare i gruppi.Per ulteriori informazioni, vedere Utilizzare token per il riferimento a utenti e gruppi.

< VALIDUSER group="groupName" for="userName" not="userName" />

Per ulteriori informazioni, vedere Gestire le autorizzazioni per creare o modificare elementi di lavoro.

WHEN

Specifica una o più regole da applicare al campo corrente quando un altro campo ha un valore specifico.L'elemento padre FIELD definisce il campo corrente.

<WHEN field="fieldReferenceName" value="value">
    <ALLOWEDVALUES> . . . </ALLOWEDVALUES>
    <ALLOWEXISTINGVALUE> . . . <ALLOWEXISTINGVALUE>
    <CANNOTLOSEVALUE> . . . </CANNOTLOSEVALUE>
    <COPY> . . . </COPY>
    <DEFAULT> . . . </DEFAULT>
    <EMPTY> . . . </EMPTY>
    <FROZEN> . . . </FROZEN>
    <MATCH> . . . </MATCH>
    <NOTSAMEAS> . . . </NOTSAMEAS>
    <PROHIBITEDVALUES> . . . </PROHIBITEDVALUES>
    <READONLY> . . . </READONLY>
    <REQUIRED> . . . </REQUIRED>
    <SERVERDEFAULT> . . . </SERVERDEFAULT>        
    <SUGGESTEDVALUES> . . . </SUGGESTEDVALUES>
    <VALIDUSER> . . . </VALIDUSER>
</WHEN>

Per ulteriori informazioni, vedere Assegnare valori e regole condizionali.

WHENNOT

Specifica una o più regole da applicare al campo corrente quando un altro campo non ha un valore specifico.L'elemento padre FIELD definisce il campo corrente.

<WHENNOT field="fieldReferenceName" value="value">
    <ALLOWEDVALUES> . . . </ALLOWEDVALUES>
    <ALLOWEXISTINGVALUE> . . . <ALLOWEXISTINGVALUE>
    <CANNOTLOSEVALUE> . . . </CANNOTLOSEVALUE>
    <COPY> . . . </COPY>
    <DEFAULT> . . . </DEFAULT>
    <EMPTY> . . . </EMPTY>
    <FROZEN> . . . </FROZEN>
    <MATCH> . . . </MATCH>
    <NOTSAMEAS> . . . </NOTSAMEAS>
    <PROHIBITEDVALUES> . . . </PROHIBITEDVALUES>
    <READONLY> . . . </READONLY>
    <REQUIRED> . . . </REQUIRED>
    <SERVERDEFAULT> . . . </SERVERDEFAULT>        
    <SUGGESTEDVALUES> . . . </SUGGESTEDVALUES>
    <VALIDUSER> . . . </VALIDUSER>
</WHENNOT>

Per ulteriori informazioni, vedere Assegnare valori e regole condizionali.

WHENCHANGED

Specifica una o più regole da applicare al campo corrente quando un altro campo viene modificato durante la revisione dell'elemento di lavoro.L'elemento padre FIELD definisce il campo corrente.

<WHENCHANGED field="fieldReferenceName" >
    <ALLOWEDVALUES> . . . </ALLOWEDVALUES>
    <ALLOWEXISTINGVALUE> . . . <ALLOWEXISTINGVALUE>
    <CANNOTLOSEVALUE> . . . </CANNOTLOSEVALUE>
    <COPY> . . . </COPY>
    <DEFAULT> . . . </DEFAULT>
    <EMPTY> . . . </EMPTY>
    <FROZEN> . . . </FROZEN>
    <MATCH> . . . </MATCH>
    <NOTSAMEAS> . . . </NOTSAMEAS>
    <PROHIBITEDVALUES> . . . </PROHIBITEDVALUES>
    <READONLY> . . . </READONLY>
    <REQUIRED> . . . </REQUIRED>
    <SERVERDEFAULT> . . . </SERVERDEFAULT>        
    <SUGGESTEDVALUES> . . . </SUGGESTEDVALUES>
    <VALIDUSER> . . . </VALIDUSER>      
</WHENCHANGED>

Per ulteriori informazioni, vedere Assegnare valori e regole condizionali.

WHENNOTCHANGED

Specifica una o più regole da applicare al campo corrente quando un altro campo non viene modificato durante la revisione dell'elemento di lavoro.L'elemento padre definisce il campo corrente.

<WHENNOTCHANGED field="fieldReferenceName">
    <ALLOWEDVALUES> . . . </ALLOWEDVALUES>
    <ALLOWEXISTINGVALUE> . . . <ALLOWEXISTINGVALUE>
    <CANNOTLOSEVALUE> . . . </CANNOTLOSEVALUE>
    <COPY> . . . </COPY>
    <DEFAULT> . . . </DEFAULT>
    <EMPTY> . . . </EMPTY>
    <FROZEN> . . . </FROZEN>
    <MATCH> . . . </MATCH>
    <NOTSAMEAS> . . . </NOTSAMEAS>
    <PROHIBITEDVALUES> . . . </PROHIBITEDVALUES>
    <READONLY> . . . </READONLY>
    <REQUIRED> . . . </REQUIRED>
    <SERVERDEFAULT> . . . </SERVERDEFAULT>        
    <SUGGESTEDVALUES> . . . </SUGGESTEDVALUES>
    <VALIDUSER> . . . </VALIDUSER>
</WHENNOTCHANGED>

Per ulteriori informazioni, vedere Assegnare valori e regole condizionali.

Elementi figlio GLOBALLIST e LISTITEM

Nella tabella seguente vengono descritti gli elementi GLOBALLIST e LISTITEM.Specificare questi elementi come elementi figlio degli elementi ALLOWEDVALUES, SUGGESTEDVALUES e PROHIBITEDVALUES.È possibile utilizzare tali elementi per enumerare un elenco di valori visualizzati come un elenco di selezione o un menu a discesa di elementi che un utente può specificare.Per ulteriori informazioni, vedere Definire elenchi utenti, elenchi di opzioni ed elenchi globali.

Elemento

Sintassi

Descrizione

GLOBALIST

 
<GLOBALLIST name="globalListName
">
    <LISTITEM> . . . </LISTITEM>
</GLOBALLIST>

Definisce un set di elementi LISTITEM archiviato per una raccolta di progetti team che tutti i progetti team in una raccolta possono utilizzare.

globalListName: stringa di testo tra 1 e 255 caratteri.

GLOBALLIST è un elemento figlio obbligatorio dell'elemento GLOBALLISTS e un elemento figlio facoltativo degli elementi ALLOWEDVALUES, SUGGESTEDVALUES e PROHIBITEDVALUES.È possibile definire un elenco globale in una definizione di elemento di lavoro, una definizione di elenco globale o un flusso di lavoro globale.

LISTITEM

 
<LISTITEM value="listName" />

Definisce un valore di elenco valido.

LISTITEM è un elemento figlio obbligatorio di GLOBALLIST e un elemento figlio facoltativo degli elementi ALLOWEDVALUES, SUGGESTEDVALUES e PROHIBITEDVALUES.

Torna all'inizio

Attributi specificati da elementi figlio FIELD

È possibile impostare la maggior parte delle regole FIELD in modo che vengano applicate o meno a un set di gruppi o utenti includendo gli attributi for o not.Per ulteriori informazioni, vedere Impostare un gruppo come ambito di una regola di campo.

Attributo

Sintassi

Descrizione

expanditems

expanditems="true | false"

Opzionale.Specifica se un gruppo identificato dall'elemento LISTITEM deve essere espanso per includere i gruppi subordinati nell'elenco.Il valore predefinito di questo attributo è true.

filteritems

filteritems = "excludegroups"

Opzionale.Specifica che solo i membri dei gruppi, e non i nomi di gruppo, sono inclusi nell'elenco.L'unico valore consentito per questo attributo è excludegroups.

for

for="userGroupName"

Opzionale.Specifica il nome di un utente o un gruppo Team Foundation a cui si applica la regola.I valori validi sono costituiti da una stringa di testo di lunghezza compresa tra 1 e 255 caratteri.

not

not="userGroupName"

Opzionale.Specifica il nome di un utente o un gruppo Team Foundation a cui non si applica la regola.I valori validi sono costituiti da una stringa di testo di lunghezza compresa tra 1 e 255 caratteri.

from

from="value | field | clock | currentuser"

Necessario.Specifica l'origine del valore dal quale copiare un valore o specificare un valore predefinito.Di seguito vengono illustrati i valori validi.

  • clock: copia la data e l'ora corrente dall'orologio di sistema ai campi DateTime. Non sono necessari attributi aggiuntivi.Per le regole COPY e DEFAULT, questo valore deriva dall'ora del computer locale.Per SERVERDEFAULT, il valore deriva dall'orologio del server quando un utente salva l'elemento di lavoro.

  • currentuser: copia il nome dell'utente al momento connesso.Utilizzare come valore il nome breve dell'utente corrente.Non sono necessari attributi aggiuntivi.Viene utilizzato per i campi stringa.

  • field: copia il valore dell'attributo field specificato.Richiede la presenza di un attributo field="abc".Per impostazione predefinita, se il campo "from" specificato è vuoto, non viene eseguita alcuna operazione.L'attributo field viene utilizzato solo per le regole <COPY> e <DEFAULT>.

  • value: copia il valore dell'attributo value specificato.Utilizzare il valore di una costante di stringa specificata.Richiede un attributo value="abc".value viene utilizzato solo per le regole <COPY> e <DEFAULT>.

Se si specifica "value" o "field", è necessario includere anche l'attributo value o field, rispettivamente.

field

field="fieldReferenceName"

Opzionale.Specifica il nome del campo il cui valore è da copiare nel campo quando viene specificato field per l'attributo from.

pattern

pattern= "patternValue"

Necessario.Impone la corrispondenza del modello di base solo per le stringhe.patternValue è una stringa composta da tra 1 e 255 caratteri, inclusa.Tale stringa non deve contenere un carattere barra rovesciata (\).Ciascun carattere della stringa viene interpretato come valore letterale, a meno che non sia uno dei sei metacaratteri:

  • "A" o "a" rappresenta un carattere alfabetico.

  • "N" o "n" rappresenta un carattere numerico.

  • "X" o "x" rappresenta un carattere alfanumerico.

Valore di schema: ^[^\\]*$

Ad esempio, pattern="xxxxx.nn.nn" corrisponde a tutti i cinque caratteri alfanumerici, quindi un punto, quindi due caratteri numerici, quindi un punto, quindi due caratteri più numerici.

value

value="valueToCopy"

Opzionale.Specifica il valore da copiare in un campo quando viene specificato value per l'attributo from.

Torna all'inizio

Vedere anche

Concetti

Definire elenchi utenti, elenchi di opzioni ed elenchi globali

Utilizzo dei campi elementi di lavoro

Progettare il flusso di lavoro