Condividi tramite

Riferimento a tutti gli elementi XML FIELD

  • Articolo

Questo argomento permette di esaminare la sintassi dell'elemento FIELD o di uno dei rispettivi elementi figlio.

Questi elementi vengono specificati nel contenitore di elementi FIELD (definizione). Per aggiungere un campo per un tipo di elemento di lavoro è necessario specificare un elemento FIELD (definizione) nell'elemento FIELDS (definizione). È possibile specificare questi elementi nella definizione di un tipo di elemento di lavoro o come parte di un flusso di lavoro globale.

È possibile aggiungere elementi figlio per specificare il comportamento di un campo, definire valori predefiniti oppure definire un elenco di selezione di valori. È possibile usare gli elementi delle regole dei campi combinandoli tra loro. È possibile definire l'ambito della maggior parte delle regole in modo che sia applicabile a uno o più utenti o gruppi o che venga ignorato per uno o più utenti o gruppi.

Elemento contenitore FIELD (definizione)

Per definire i campi dati per un tipo di elemento di lavoro si usa la sintassi seguente. Questo esempio mostra il formato dell'elemento FIELD (definizione) e tutti gli elementi figlio facoltativi. Per altre informazioni, vedere Riferimento all'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

Usare gli elementi figlio per impostare diverse restrizioni sui dati che possono essere immessi in un campo. È possibile specificare i valori per un elenco di selezione (menu a discesa), impostare valori predefiniti, cancellare voci o limitare le modifiche. La tabella seguente illustra la struttura della sintassi per ogni elemento figlio.

Per informazioni su come usare questi elementi, vedere Applicare una regola a un campo elemento di lavoro. Sono previste restrizioni per l'applicazione della maggior parte delle regole ai campi di sistema. Tutti gli elementi figlio sono facoltativi.

Elemento

Descrizione e sintassi

ALLOWEDVALUES

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

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

Per altre 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 di campo devono essere inclusi nell'elenco.

<ALLOWEXISTINGVALUE />

Per altre informazioni, vedere Definire elenchi di opzioni.

CANNOTLOSEVALUE

Specifica che gli utenti non possono cancellare tutti i valori di un campo dopo che è stato specificato un valore. Quando un campo contiene un valore, quel campo dovrà sempre contenere un valore non NULL.

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

Per altre informazioni, vedere Applicare una regola di campo.

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 altre informazioni, vedere Definire un valore predefinito o copiare un valore in un campo.

DEFAULT

Specifica un valore per un campo che risulta vuoto quando un utente crea o modifica un elemento di lavoro. Se un campo include già un valore, la regola predefinita verrà ignorata.

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

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

EMPTY

Cancella tutti i valori eventualmente inclusi nel campo. La regola EMPTY imposta anche un campo come di sola lettura e non deve essere usata con la regola READONLY.

Il valore del campo viene cancellato quando un utente salva l'elemento di lavoro e non sarà possibile specificare alcun valore. Questa regola viene usata principalmente durante la transizione dello stato, per cancellare i campi applicabili allo stato finale della transizione dell'elemento.

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

Per altre informazioni, vedere Applicare una regola di campo.

FROZEN

Specifica che non è possibile modificare il campo impostando 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, non sarà più possibile modificare il valore.

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

Per altre informazioni, vedere Applicare una regola di campo.

HELPTEXT

Definisce il testo da visualizzare quando un utente seleziona il campo nel form dell'elemento di lavoro.

tooltipText: stringa di testo contenente da 1 a 255 caratteri.

<HELPTEXT>tooltipText </HELPTEXT>

Per altre informazioni, vedere Applicare una regola di campo.

MATCH

Definisce un criterio a cui devono corrispondere i valori dei campi di tipo String.

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

Per altre informazioni, vedere Applicare i criteri di ricerca a un campo stringa.

NOTSAMEAS

Specifica che un campo non viene assegnato allo stesso valore a cui è 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 altre informazioni, vedere Applicare una regola di campo.

PROHIBITEDVALUES

Definisce un elenco di valori che non possono essere contenuti in un campo. Gli utenti non possono salvare un elemento di lavoro se il campo contiene un valore proibito.

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

Per altre informazioni, vedere Definire elenchi di opzioni.

READONLY

Specifica che non è possibile modificare il valore a cui è assegnato il campo.

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

Nota

Non usare questo elemento insieme all'elemento EMPTY, poiché EMPTY imposta anche un campo come di sola lettura.Se si combinano questi elementi, i risultati non saranno coerenti.

Per altre informazioni, vedere Applicare una regola di campo.

REQUIRED

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

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

Per altre informazioni, vedere Applicare una regola di campo.

SERVERDEFAULT

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

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

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

SUGGESTEDVALUES

Definisce un elenco di valori suggeriti che gli utenti possono specificare in un elenco di campi nei form di elementi di lavoro e nell'editor di 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 altre informazioni, vedere Definire elenchi di opzioni.

VALIDUSER

Impedisce la modifica degli elementi di lavoro da parte di utenti appartenenti al gruppo specificato. Il gruppo predefinito è il gruppo di utenti validi Team Foundation.

Tutti gli attributi sono facoltativi. Tutti gli attributi devono essere costituiti da una stringa di testo contenente da 1 a 255 caratteri. È possibile usare token per specificare i gruppi.

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

Per altre informazioni, vedere Applicare una regola di campo.

WHEN

Specifica una o più regole da applicare al campo corrente quando un altro campo ha un valore specifico. L'elemento FIELD padre 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 altre informazioni, vedere Assegnare valori e regole condizionali.

WHENNOT

Specifica una o più regole da applicare al campo corrente quando un altro campo non dispone di un valore specifico. L'elemento FIELD padre 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 altre 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 FIELD padre 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 altre 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 altre informazioni, vedere Assegnare valori e regole condizionali.

Elementi figlio GLOBALLIST e LISTITEM

Gli elementi GLOBALLIST e LISTITEM vengono specificati come elementi figlio degli elementi ALLOWEDVALUES, SUGGESTEDVALUES e PROHIBITEDVALUES. È possibile usare questi elementi per enumerare un elenco di valori visualizzato. Gli utenti selezionano valori da un elenco di selezione o da un menu a discesa. Per altre informazioni, vedere Definire elenchi globali.

Elemento

Descrizione

GLOBALIST

Definisce un set di elementi LISTITEM archiviato per un insieme di progetti team e utilizzabile da tutti i progetti team in un insieme.

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

globalListName: stringa di testo contenente da 1 a 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 dell'elemento di lavoro, in una definizione dell'elenco globale o in un flusso di lavoro globale.

LISTITEM

Definisce un valore valido dell'elenco.

<LISTITEM value="listName" />

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

Attributi specificati dagli elementi figlio FIELD

È possibile qualificare la maggior parte delle regole FIELD in modo che siano applicate o non applicate a un insieme di gruppi o utenti, includendo gli attributi for o not. Per altre informazioni, vedere Applicare una regola di campo.

Attributo

Sintassi

Descrizione

expanditems

expanditems="true | false"

Parametro facoltativo. 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"

Parametro facoltativo. Specifica che solo i membri dei gruppi, non i nomi dei gruppi, saranno inclusi nell'elenco. L'unico valore permesso per questo attributo è excludegroups.

for

for="NomeGruppoUtenti"

Parametro facoltativo. Specifica il nome di un utente o un gruppo in Team Foundation a cui è applicabile la regola. I valori validi sono costituiti da una stringa di testo contenente da 1 a 255 caratteri.

not

not="NomeGruppoUtenti"

Parametro facoltativo. Specifica il nome di un utente o un gruppo in Team Foundation a cui non è applicabile la regola. I valori validi sono costituiti da una stringa di testo contenente da 1 a 255 caratteri.

from

from="value | field | clock | currentuser"

Obbligatorio. Specifica l'origine del valore da cui copiare un valore o specificare un valore predefinito. Di seguito vengono illustrati i valori validi.

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

  • currentuser: copia il nome dell'utente attualmente connesso. Usare come valore il nome utente breve dell'utente corrente. Non sono necessari attributi aggiuntivi. Usato per i campi di tipo String.

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

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

Se si specifica "value" o "field", sarà necessario includere rispettivamente anche il valore o l'attributo del campo.

field

field="NomeRiferimentoCampo"

Parametro facoltativo. Specifica il nome del campo il cui valore deve essere copiato nel campo quando viene specificato field per l'attributo from.

pattern

pattern="ValoreSchema"

Obbligatorio. Applica la corrispondenza ai criteri di base solo per le stringhe. ValoreSchema è una stringa costituita contenente da 1 a 255 caratteri inclusi. La stringa non deve barre rovesciate (\). Ogni carattere nella stringa viene interpretato come valore letterale, a meno che non si tratti di uno dei sei metacaratteri seguenti:

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

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

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

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

Ad esempio, pattern="xxxxx.nn.nn" corrisponde cinque caratteri alfanumerici qualsiasi, seguiti da un punto, due caratteri numerici, un punto e infine da altri due caratteri numerici.

value

value="ValoreDaCopiare"

Parametro facoltativo. Specifica il valore che deve essere copiato nel campo quando viene specificato value per l'attributo from.

Vedere anche

Concetti

Definire e modificare campi di elementi di lavoro

Modificare il flusso di lavoro per un tipo di elemento di lavoro