WHENCHANGED, élément (Schéma de définition du type d'élément de travail)

Mise à jour : novembre 2007

Spécifie une condition qui détermine l'application d'une ou plusieurs règles au champ actuel. Les règles s'appliquent au champ actuel lorsque la valeur d'un autre champ change. L'élément parent définit le champ actuel.

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

Attributs et éléments

Les sections suivantes décrivent l'attribut et les éléments enfants qui définissent l'élément WHENCHANGED. Elles décrivent également les éléments parents qui définissent la façon dont l'élément WHENCHANGED est appliqué. Vous devez définir au moins un élément enfant.

Attributs

Attribut	Description
field	Attribut requis. Identifie un champ qui doit changer pour que les règles de cet élément puissent être appliquées au champ actuel (champ qui contient l'élément WHENCHANGED). Vous spécifiez cet attribut par le nom de référence du champ. Pour plus d'informations sur les noms de référence, consultez FIELD, élément (Élément WORKITEMTYPE).

Éléments enfants

Élément	Description
REQUIRED, élément (Schéma de définition du type d'élément de travail)	Élément facultatif. Spécifie que lorsque la valeur du champ identifié par l'attribut field change, le champ actuel (champ qui contient l'élément WHENCHANGED) doit comporter une valeur.
READONLY, élément (Schéma de définition du type d'élément de travail)	Élément facultatif. Spécifie que lorsque la valeur du champ identifié par l'attribut field change, le champ actuel est en lecture seule.
EMPTY, élément (Schéma de définition du type d'élément de travail)	Élément facultatif. Spécifie que lorsque la valeur du champ identifié par l'attribut field change, le champ actuel doit être vide.
FROZEN, élément (Schéma de définition du type d'élément de travail)	Élément facultatif. Spécifie que lorsque la valeur du champ identifié par l'attribut field change, le champ actuel est figé. Il n'est plus possible d'affecter à un champ figé une valeur non vide une fois les modifications validées. Vous pouvez toutefois effacer le champ manuellement, enregistrer l'élément de travail, puis spécifier une valeur différente.
CANNOTLOSEVALUE, élément (Schéma de définition du type d'élément de travail)	Élément facultatif. Spécifie que lorsque la valeur du champ qui est identifié par l'attribut field ne change pas, le champ actuel ne peut pas être effacé ou vidé une fois qu'une valeur lui a été affectée.
NOTSAMEAS, élément (Schéma de définition du type d'élément de travail)	Élément facultatif. Spécifie que lorsque la valeur du champ identifié par l'attribut field change, la valeur du champ actuel ne peut pas correspondre à celle d'un champ tiers. Vous spécifiez le champ tiers dans l'élément NOTSAMEAS.
VALIDUSER, élément (Schéma de définition du type d'élément de travail)	Élément facultatif. Spécifie que lorsque la valeur du champ identifié par l'attribut field change, la liste de valeurs autorisées doit être constituée uniquement d'utilisateurs valides du système.
ALLOWEXISTINGVALUE, élément (Schéma de définition du type d'élément de travail)	Élément facultatif. Spécifie que lorsque la valeur du champ identifié par l'attribut field change, la valeur du champ actuel qui existe déjà sera autorisée, même si elle enfreint d'autres règles. Si la valeur du champ actuel est modifiée, cet élément ne s'applique pas.
MATCH, élément (Schéma de définition du type d'élément de travail)	Élément facultatif. Spécifie que lorsque la valeur du champ identifié par l'attribut field change, la valeur du champ actuel doit correspondre au modèle donné.
ALLOWEDVALUES, élément (Schéma de définition du type d'élément de travail)	Élément facultatif. Spécifie que lorsque la valeur du champ identifié par l'attribut field change, le champ actuel doit avoir une valeur provenant de la liste de valeurs donnée. Les valeurs autorisées correspondent aux valeurs pouvant être choisies dans une liste de champs figurant sur les formulaires d'élément de travail et dans le Générateur de requêtes. Vous devez sélectionner l'une de ces valeurs.
SUGGESTEDVALUES, élément (Schéma de définition du type d'élément de travail)	Élément facultatif. Spécifie que lorsque la valeur du champ identifié par l'attribut field change, la liste spécifiée contient des valeurs suggérées pour le champ actuel. Les valeurs suggérées correspondent aux valeurs pouvant être choisies dans une liste de champs figurant sur les formulaires d'élément de travail et dans le Générateur de requêtes. Vous pouvez entrer d'autres valeurs en plus de celles indiquées dans la liste.
PROHIBITEDVALUES, élément (Schéma de définition du type d'élément de travail)	Élément facultatif. Spécifie que lorsque la valeur du champ identifié par l'attribut field change, le champ actuel ne peut contenir aucune valeur de la liste.
DEFAULT, élément (Schéma de définition du type d'élément de travail)	Élément facultatif. Spécifie que lorsque la valeur du champ identifié par l'attribut field change, la valeur donnée est la valeur par défaut du champ actuel.
COPY, élément (Schéma de définition du type d'élément de travail)	Élément facultatif. Spécifie que lorsque la valeur du champ identifié par l'attribut field change, la valeur d'un champ tiers est copiée automatiquement dans le champ actuel. Vous spécifiez le champ tiers dans l'élément COPY.
SERVERDEFAULT, élément (Schéma de définition du type d'élément de travail)	Élément facultatif. Spécifie que lorsque la valeur du champ identifié par l'attribut field change, le champ actuel utilise la valeur issue du composant serveur spécifié. Les composants serveur sont horloge, qui est l'heure de mise à jour de l'élément de travail, et utilisateuractuel, qui est l'identité ayant mis à jour l'élément travail.

Éléments parents

Élément	Description
FIELD, élément (Schéma de définition du type d'élément de travail)	Élément requis. Référence la définition d'un champ d'élément de travail et définit les règles et les conditions qui s'appliquent au champ. La référence est basée sur l'élément STATE, TRANSITION, DEFAULTREASON ou REASON dont son élément FIELDS parent est un enfant.
FIELD, élément (Élément WORKITEMTYPE)	Élément requis. Définit un champ d'élément de travail et spécifie les règles et les conditions qui s'appliquent au champ.

Notes

WHENCHANGED est un élément enfant facultatif de FIELD (Schéma de définition du type d'élément de travail) et de FIELD (élément WORKITEMTYPE).

Exemple

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

Informations sur les éléments

Espace de noms	https://schemas.microsoft.com/VisualStudio/2005/workitemtracking/typedef
Nom du schéma	Définition du type d'élément de travail
Fichier de validation	WorkItemTypeDefinition.xsd
Type d'élément	FieldCondition, type complexe (Schéma de définition du type d'élément de travail)
Peut être vide	Non

Voir aussi

Autres ressources

Schéma de définition du type d'élément de travail

Conditions de champs