Elemento WHEN (schema di definizione del tipo degli elementi di lavoro)

Aggiornamento: novembre 2007

Specifica una condizione in base alla quale vengono applicate una o più regole al campo corrente. Le regole vengono applicate al campo corrente quando un altro campo contiene un valore specifico. L'elemento padre definisce il campo corrente.

<xs:element name="WHEN" type="FieldValueCondition"/>

Attributi ed elementi

Nelle sezioni seguenti viene fornita una descrizione degli attributi e degli elementi figlio che definiscono l'elemento WHEN. Vengono inoltre descritti gli elementi padre che definiscono come viene applicato l'elemento WHEN. È necessario definire almeno un elemento figlio.

Attributi

Attributo	Descrizione
field	Attributo obbligatorio. Identifica un campo che deve avere un valore specificato per le regole in questo elemento da applicare al campo corrente. Questo attributo è specificato dal nome di riferimento del campo. Per ulteriori informazioni sui nomi di riferimento, vedere Elemento FIELD (elemento WORKITEMTYPE).
value	Attributo obbligatorio. Specifica il valore che il campo identificato dall'attributo field deve contenere per le regole in questo elemento da applicare al campo corrente.

Elementi figlio

Elemento	Descrizione
Elemento REQUIRED (schema di definizione del tipo degli elementi di lavoro)	Elemento facoltativo. Specifica che quando il campo identificato dall'attributo field contiene il valore specificato, il campo corrente (il campo che contiene l'elemento WHEN) deve contenere un valore.
Elemento READONLY (schema di definizione del tipo degli elementi di lavoro)	Elemento facoltativo. Specifica che quando il valore del campo identificato dall'attributo field contiene il valore specificato, il campo corrente è in sola lettura.
Elemento EMPTY (schema di definizione del tipo degli elementi di lavoro)	Elemento facoltativo. Specifica che quando il valore del campo identificato dall'attributo field contiene il valore specificato, il campo corrente non deve contenere un valore.
Elemento FROZEN (schema di definizione del tipo degli elementi di lavoro)	Elemento facoltativo. Specifica che quando il campo identificato dall'attributo field contiene il valore specificato, il campo corrente è bloccato. Un campo bloccato non può essere impostato su un valore non vuoto dopo che è stato eseguito il commit delle modifiche. Tuttavia è possibile cancellare manualmente il valore contenuto nel campo, salvare l'elemento di lavoro e specificare un valore diverso.
Elemento CANNOTLOSEVALUE (schema di definizione del tipo degli elementi di lavoro)	Elemento facoltativo. Specifica che quando il valore del campo identificato dall'attributo field non viene modificato, il valore del campo corrente non può essere cancellato una volta che è stato acquisito.
Elemento NOTSAMEAS (schema di definizione del tipo degli elementi di lavoro)	Elemento facoltativo. Specifica che quando il campo identificato dall'attributo field contiene il valore specificato, il valore del campo corrente non può corrispondere al valore di un terzo campo. Specificare il terzo campo nell'elemento NOTSAMEAS.
Elemento VALIDUSER (schema di definizione del tipo degli elementi di lavoro)	Elemento facoltativo. Specifica che quando il campo identificato dall'attributo field contiene il valore specificato, l'elenco dei valori consentiti deve essere costituito solo da utenti validi del sistema.
Elemento ALLOWEXISTINGVALUE (schema di definizione del tipo degli elementi di lavoro)	Elemento facoltativo. Specifica che quando il campo identificato dall'attributo field contiene il valore specificato, sarà consentito l'uso del valore del campo corrente già esistente, anche se viola altre regole. Se il valore del campo corrente viene modificato, tale elemento non si applica.
Elemento MATCH (schema di definizione del tipo degli elementi di lavoro)	Elemento facoltativo. Specifica che quando il campo identificato dall'attributo field contiene il valore specificato, il valore del campo corrente deve corrispondere al modello specificato.
Elemento ALLOWEDVALUES (schema di definizione del tipo degli elementi di lavoro)	Elemento facoltativo. Specifica che quando il campo identificato dall'attributo field contiene il valore specificato, il campo corrente deve contenere un valore fornito dall'elenco di valori specificato. I valori consentiti sono i valori selezionabili di un elenco di campi presente in form di elementi di lavoro e nel generatore di query. È necessario selezionare uno di questi valori.
Elemento SUGGESTEDVALUES (schema di definizione del tipo degli elementi di lavoro)	Elemento facoltativo. Specifica che quando il campo identificato dall'attributo field contiene il valore specificato, l'elenco specificato contiene i valori suggeriti per il campo corrente. I valori suggeriti sono i valori selezionabili di un elenco di campi presente in form di elementi di lavoro e nel generatore di query. È possibile immettere altri valori oltre a quelli presenti nell'elenco.
Elemento PROHIBITEDVALUES (schema di definizione del tipo degli elementi di lavoro)	Elemento facoltativo. Specifica che quando il campo identificato dall'attributo field contiene il valore specificato, il campo corrente non può contenere i valori di questo elenco.
Elemento DEFAULT (schema di definizione del tipo degli elementi di lavoro)	Elemento facoltativo. Specifica che quando il campo identificato dall'attributo field contiene il valore specificato, questo elemento specifica il valore predefinito del campo corrente.
Elemento COPY (schema di definizione del tipo degli elementi di lavoro)	Elemento facoltativo. Specifica che quando il campo identificato dall'attributo field contiene il valore specificato, il valore di un terzo campo viene copiato automaticamente nel campo corrente. Specificare il terzo campo nell'elemento COPY.
Elemento SERVERDEFAULT (schema di definizione del tipo degli elementi di lavoro)	Elemento facoltativo. Specifica che quando il campo identificato dall'attributo field contiene il valore specificato, il campo corrente utilizza il valore del componente server specificato. I componenti server sono clock, che indica l’orario in cui l’elemento di lavoro viene aggiornato, e currentuser, che indica l'identità che ha aggiornato l'elemento di lavoro.

Elementi padre

Elemento	Descrizione
Elemento FIELD (schema di definizione del tipo degli elementi di lavoro)	Elemento obbligatorio. Fa riferimento a una definizione di campo dell'elemento di lavoro e alle regole e condizioni valide per il campo. Il riferimento è basato sull'elemento STATE, TRANSITION, DEFAULTREASON o REASON di cui l'elemento FIELDS padre del riferimento costituisce un elemento figlio.
Elemento FIELD (elemento WORKITEMTYPE)	Elemento obbligatorio. Definisce un campo dell'elemento di lavoro e le regole e le condizioni valide per il campo.

Note

WHEN è un elemento figlio facoltativo degli elementi FIELD (schema di definizione del tipo degli elementi di lavoro) e FIELD (elemento WORKITEMTYPE).

Esempio

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

Informazioni sull'elemento

Spazio dei nomi	https://schemas.microsoft.com/VisualStudio/2005/workitemtracking/typedef
Nome di schema	Definizione del tipo di elemento di lavoro
File di convalida	WorkItemTypeDefinition.xsd
Tipo di elemento	Tipo complesso FieldValueCondition (schema di definizione del tipo degli elementi di lavoro)
Può essere vuoto	No

Vedere anche

Altre risorse

Schema di definizione del tipo di elemento di lavoro

Condizioni di campo