WHENNOT, é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 lorsqu'un autre champ n'a pas de valeur spécifique. L'élément parent définit le champ actuel.

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

Attributs et éléments

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

Attributs

Attribut	Description
field	Attribut requis. Identifie un champ qui doit comporter une valeur donnée pour que les règles de cet élément puissent être appliquées au champ actuel. 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).
value	Attribut requis. Spécifie la valeur que le champ identifié par l'attribut field ne doit pas contenir pour que les règles de cet élément puissent être appliquées au champ actuel.

É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 le champ identifié par l'attribut field ne contient pas la valeur spécifiée, le champ actuel (champ qui contient l'élément WHENNOT) 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 le champ identifié par l'attribut field ne contient pas la valeur spécifiée, 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 le champ identifié par l'attribut field ne contient pas la valeur spécifiée, le champ actuel ne doit contenir aucune valeur.
FROZEN, élément (Schéma de définition du type d'élément de travail)	Élément facultatif. Spécifie que lorsque le champ identifié par l'attribut field ne contient pas la valeur spécifiée, 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 le champ identifié par l'attribut field ne contient pas la valeur spécifiée, 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 le champ identifié par l'attribut field ne contient pas la valeur spécifiée, 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 le champ identifié par l'attribut field ne contient pas la valeur spécifiée, 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 le champ identifié par l'attribut field ne contient pas la valeur spécifiée, 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 le champ identifié par l'attribut field ne contient pas la valeur spécifiée, le champ actuel doit contenir une valeur fournie dans la liste de valeurs spécifié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 le champ identifié par l'attribut field ne contient pas la valeur spécifiée, 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 le champ identifié par l'attribut field ne contient pas la valeur spécifiée, le champ actuel ne peut contenir aucune valeur de cette liste.
DEFAULT, élément (Schéma de définition du type d'élément de travail)	Élément facultatif. Spécifie que lorsque le champ identifié par l'attribut field ne contient pas la valeur spécifiée, cet élément spécifie 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 le champ identifié par l'attribut field ne contient pas la valeur spécifiée, 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 le champ identifié par l'attribut field ne contient pas la valeur spécifiée, 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

WHENNOT 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

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

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