Definizione di un valore predefinito o copia di un valore in un campo

È possibile specificare un valore predefinito per un campo o copiare il valore da un altro campo o da un valore definito dal sistema. I valori predefiniti dei campi sono regole che controllano la modalità di assegnazione automatica dei valori dei campi. È possibile assegnare un'impostazione predefinita al campo tramite uno degli elementi seguenti: COPY, DEFAULT e SERVERDEFAULT. È possibile specificare questi elementi come elementi figlio dell'elemento FIELD (definizione) o FIELD (flusso di lavoro).

Gli elementi COPY e DEFAULT inseriscono valori all'avvio della modifica, ma la regola SERVERDEFAULT inserisce un valore quando si esegue il commit dell'elemento di lavoro al database. Questa azione si verifica quando un utente salva le modifiche in un elemento di lavoro, e l'utente non può eseguire l'override del valore. Questi campi in genere appaiono come campi di sola lettura nel form elemento di lavoro. La regola SERVERDEFAULT viene utilizzata per campi come "Autore ultima modifica" e "Data ultima modifica" per supportare itinerari di controllo sicuri.

In questo argomento

• Struttura della sintassi per la definizione dei valori predefiniti

• Definizione di un valore predefinito

• Deselezione automatica di un campo

• Salvataggio di un valore del campo

• Specifica dell'orologio come predefinito

Struttura della sintassi per la definizione dei valori predefiniti

È possibile utilizzare gli elementi COPY, DEFAULT e SERVERDEFAULT per copiare un valore da un campo a un altro, copiare un valore server in un campo o specificare un valore predefinito da definire per un campo.

• È possibile specificare un valore da copiare da un altro campo, il valore dell'orologio o il nome dell'utente corrente. Se si specifica value o field per l'attributo from, è necessario specificare l'attributo value o field. Quando un utente cambia un elemento di lavoro o ne crea uno nuovo, la regola COPY inserisce un valore di campo a prescindere dai valori già presenti nel campo.

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

• È possibile specificare un valore predefinito per un campo tramite la regola DEFAULT. Quando un utente crea o modifica un elemento di lavoro, la regola DEFAULT inserisce un valore se quel campo è vuoto. È possibile specificare un valore da copiare da un altro campo, l'indicatore data e ora registrato dall'orologio del server o il nome dell'utente corrente. Se è già presente un valore nel campo, la regola predefinita viene ignorata.

  <DEFAULT for="userGroupName" not="userGroupName" from="value | field | clock | currentuser" value="defaultValue" field="fieldReferenceName" />
  

• È possibile specificare un valore da copiare dal server in un campo quando viene salvato l'elemento di lavoro. Quando un utente modifica lo stato di un elemento di lavoro, la regola SERVERDEFAULT specifica un valore da copiare nel campo corrente da un valore ricavato da un componente del server. Gli elementi DEFAULT e COPY, inseriscono i valori quando un utente apre un elemento di lavoro per modificarlo, ma la regola SERVERDEFAULT inserisce un valore quando si esegue il commit dell'elemento di lavoro al database. Questa azione si verifica quando un utente salva l'elemento di lavoro. L'utente non può eseguire l'override del valore. Questi campi in genere appaiono come campi di sola lettura nel form. La regola SERVERDEFAULT viene utilizzata per campi come "Autore ultima modifica" e "Data ultima modifica" per supportare itinerari di controllo sicuri.

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

Ciascun elemento regola specifica un attributo from="fromType" che identifica l'origine del valore. In base al valore fromType, potrebbero essere richiesti altri attributi. Nella tabella riportata di seguito vengono descritti gli attributi a cui fanno riferimento gli elementi regola COPY, DEFAULT e SERVERDEFAULT.

Torna all'inizio

Definizione di un valore predefinito

Nell'esempio seguente viene impostato P3 come valore predefinito per il campo Priorità.

<FIELD refname="MyCorp.Priority" name="Priority" type="String">
<HELPTEXT>Specify the severity of the problem</HELPTEXT>
    <ALLOWEDVALUES>
        <LISTITEM value="P1"/>
        <LISTITEM value="P2"/>
        <LISTITEM value="P3"/>
    </ALLOWEDVALUES>
<DEFAULT from="value" value="P3"/>
</FIELD>

Torna all'inizio

Deselezione automatica di un campo

Nell'esempio riportato di seguito i valori presenti nel campo dello stato vengono annullati.

<FIELD refname="MyCorp.Status" name="Status" type="String">
    <COPY from="value" value="" />
</FIELD>

Torna all'inizio

Salvataggio di un valore del campo

Nell'esempio riportato di seguito viene salvato il nome dell'utente che ha modificato più recentemente un elemento di lavoro.

<FIELD refname="System.Last Changed By" name="Last Changed By" type="String">
    <HELPTEXT>The name of the user who most recently modified this bug</HELPTEXT>
    <VALIDUSER group="[Project]\MyProjectMembers" />
    <SERVERDEFAULT from="currentuser" />
</FIELD>

Torna all'inizio

Specifica dell'orologio come predefinito

Nell'esempio riportato di seguito, il valore di un campo utilizza la data corrente ma gli utenti possono modificare tale valore.

<FIELD refname="MyCorp.FoundOn" name="Found On" type="DateTime">
    <HELPTEXT>Defines when a bug was found.</HELPTEXT>
    <DEFAULT from="clock" />
</FIELD>

Torna all'inizio

Vedere anche

Concetti

Riferimento a tutti gli elementi XML FIELD

Altre risorse

Utilizzo degli elenchi di campi

Definizione dei campi elemento di lavoro

Cronologia delle modifiche