Elemento WHENCHANGED (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 al variare del valore di un altro campo. L'elemento padre definisce il campo corrente.

<xs:element name="WHENCHANGED" type="FieldCondition"/>

Attributi ed elementi

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

Attributi

Attributo	Descrizione
field	Attributo obbligatorio. Identifica un campo che deve essere modificato per le regole in questo elemento da applicare al campo corrente (il campo che contiene l'elemento WHENCHANGED). Questo attributo è specificato dal nome di riferimento del campo. Per ulteriori informazioni sui nomi di riferimento, vedere Elemento FIELD (elemento WORKITEMTYPE).

Elementi figlio

Elemento	Descrizione
Elemento REQUIRED (schema di definizione del tipo degli elementi di lavoro)	Elemento facoltativo. Specifica che quando viene modificato il valore del campo identificato dall'attributo field, il campo corrente (il campo che contiene l'elemento WHENCHANGED) deve avere un valore.
Elemento READONLY (schema di definizione del tipo degli elementi di lavoro)	Elemento facoltativo. Specifica che quando viene modificato il valore del campo identificato dall'attributo field, il campo corrente è in sola lettura.
Elemento EMPTY (schema di definizione del tipo degli elementi di lavoro)	Elemento facoltativo. Specifica che quando viene modificato il valore del campo identificato dall'attributo field, il campo corrente deve essere vuoto.
Elemento FROZEN (schema di definizione del tipo degli elementi di lavoro)	Elemento facoltativo. Specifica che quando viene modificato il valore del campo identificato dall'attributo field, 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 viene modificato il valore del campo identificato dall'attributo field, 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 viene modificato il valore del campo identificato dall'attributo field, 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 viene modificato il valore del campo identificato dall'attributo field, 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 viene modificato il valore del campo identificato dall'attributo field, 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 viene modificato il valore del campo identificato dall'attributo field, il campo corrente deve contenere un valore proveniente dall'elenco 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 viene modificato il valore del campo identificato dall'attributo field, 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 viene modificato il valore del campo identificato dall'attributo field, 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 viene modificato il valore del campo identificato dall'attributo field, il valore specificato è il valore predefinito del campo corrente.
Elemento COPY (schema di definizione del tipo degli elementi di lavoro)	Elemento facoltativo. Specifica che quando viene modificato il valore del campo identificato dall'attributo field, 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 viene modificato il valore del campo identificato dall'attributo field, 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

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

Esempio

<WHENCHANGED field="field reference name">
    <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>
</WHENCHANGED>

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