Partager via

Définition d'une valeur par défaut ou copie d'une valeur dans un champ

  • Article

Vous pouvez spécifier une valeur par défaut pour un champ ou vous pouvez copier la valeur d'un autre champ ou une valeur définie par le système. Les valeurs par défaut des champs sont des règles qui contrôlent la manière dont les valeurs de champ sont automatiquement assignées. Vous pouvez assigner une valeur par défaut de champ en utilisant l'un des éléments suivants : COPY, DEFAULT et SERVERDEFAULT. Vous pouvez spécifier ces éléments en tant qu'éléments enfants de l'élément FIELD (Définition) ou FIELD (Flux de travail).

Contrairement aux éléments COPY et DEFAULT qui remplissent des valeurs au début de la modification, la règle SERVERDEFAULT remplit une valeur lorsque l'élément de travail est validé pour la base de données. Cette action se produit lorsqu'un utilisateur enregistre les modifications apportées à un élément de travail, et l'utilisateur ne peut pas substituer la valeur. Ces champs apparaissent généralement en lecture seule sur le formulaire d'élément de travail. La règle SERVERDEFAULT est utilisée pour les champs tels que « Dernière modification par » et « Dernière modification le » pour prendre en charge les traces d'audit sécurisées.

Dans cette rubrique

  • Structure de syntaxe pour la définition de valeurs par défaut

  • Définition d'une valeur par défaut

  • Effacement automatique d'un champ

  • Enregistrement d'une valeur de champ

  • Spécification de l'horloge comme une valeur par défaut

Structure de syntaxe pour la définition de valeurs par défaut

Vous pouvez utiliser les éléments COPY, DEFAULT et SERVERDEFAULT pour copier une valeur d'un champ vers un autre, copier une valeur de serveur dans un champ ou spécifier une valeur par défaut à définir pour un champ.

Notes

Si l'élément de travail est en cours de modification, la règle des éléments COPY ou DEFAULT peut sélectionner la valeur actuelle ou la valeur précédente du champ source.

  • Vous pouvez spécifier une valeur à copier d'un autre champ, la valeur de l'horloge ou le nom de l'utilisateur actuel. Si vous spécifiez value ou field pour l'attribut from, vous devez spécifier l'attribut value ou field. Lorsqu'un utilisateur modifie ou crée un élément de travail, la règle COPY remplit une valeur de champ quelle que soit la valeur qui existe déjà dans le champ.

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

  • Vous pouvez spécifier une valeur par défaut pour un champ à l'aide de la règle DEFAULT. Lorsqu'un utilisateur crée ou modifie un élément de travail, la règle DEFAULT remplit une valeur de champ si ce champ est vide. Vous pouvez spécifier une valeur à copier d'un autre champ, l'horodatage enregistré par l'horloge de serveur ou le nom de l'utilisateur actuel. Si un champ a déjà une valeur, cette règle est ignorée.

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

  • Vous pouvez spécifier une valeur à copier à partir du serveur dans un champ lorsque l'élément de travail est enregistré. Lorsqu'un utilisateur modifie l'état d'un élément de travail, la règle SERVERDEFAULT spécifie une valeur à copier dans le champ actuel d'après une valeur dérivée d'un composant serveur. Contrairement aux éléments DEFAULT et COPY qui remplissent des valeurs lorsqu'un utilisateur ouvre un élément de travail pour modification, la règle SERVERDEFAULT remplit une valeur lorsque l'élément de travail est validé vers la base de données. Cette action se produit lorsque l'utilisateur enregistre l'élément de travail. L'utilisateur ne peut pas substituer la valeur. Ces champs apparaissent généralement en lecture seule sur le formulaire. La règle SERVERDEFAULT est utilisée pour les champs tels que « Dernière modification par » et « Dernière modification le » pour prendre en charge les traces d'audit sécurisées.

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

Chacun de ces éléments de règle spécifie un attribut from="fromType" qui identifie la source de la valeur. Selon la valeur fromType, des attributs supplémentaires peuvent être nécessaires. Le tableau suivant décrit tous les attributs auxquels les éléments de règle COPY, DEFAULT et SERVERDEFAULT font référence.

Attribut

Description

for

Facultatif. Spécifie le nom d'un utilisateur ou d'un groupe dans Team Foundation auquel la règle s'applique. Les noms valides sont constitués d'une chaîne de texte qui contient entre 1 et 255 caractères.

Valeur de modèle : ^[^\\]+\\[^\\]+$

Exemple de valeur de modèle : Domaine\IDutilisateur

not

Facultatif. Spécifie le nom d'un utilisateur ou d'un groupe dans Team Foundation auquel la règle ne s'applique pas. Les noms valides sont constitués d'une chaîne de texte qui contient entre 1 et 255 caractères.

Valeur de modèle : ^[^\\]+\\[^\\]+$

Exemple de valeur de modèle : Domaine\IDutilisateur

from

Obligatoire. Indique si la valeur par défaut doit être copiée de l'attribut value, de l'attribut field, de l'horloge système ou de l'utilisateur actuel. Si vous spécifiez value ou field pour l'attribut from, vous devez spécifier l'attribut value ou field, respectivement. Vous pouvez spécifier les valeurs suivantes :

  • clock :  Copie l'heure de l'horloge système. Utilise la date et l'heure actuelles comme valeur. Aucun attribut supplémentaire n'est requis. Pour les règles COPY et DEFAULT, la valeur est prise à partir de l'horloge de l'ordinateur local. Pour la règle SERVERDEFAULT, la valeur provient de l'horloge serveur au moment de la validation. Valide uniquement pour les champs DateTime.

  • currentuser : Copie le nom de l'utilisateur connecté. Utilisez le nom court de l'utilisateur actuel comme valeur. Aucun attribut supplémentaire n'est requis. Valide uniquement pour les champs String.

  • field : Copie la valeur définie pour l'attribut field que vous spécifiez. Requiert un attribut field="abc". Par défaut, si le champ spécifié « de » est vide, rien n'est exécuté. L'attribut field n'est utilisé que pour les règles COPY et DEFAULT.

  • value : Copie la valeur de l'attribut value spécifié.

value

Facultatif. Spécifie la valeur à copier dans le champ lorsque la valeur value est spécifiée pour l'attribut from. Les valeurs valides sont constituées d'une chaîne de texte qui contient entre 1 et 255 caractères.

La valeur à copier peut être vide.

field

Facultatif. Spécifie le nom du champ dont la valeur sera copiée lorsque field est spécifié pour l'attribut from. Vous devez définir cet attribut si l'attribut from a la valeur "field".

Nom de référence du champ à copier. Ce nom de référence doit correspondre à celui défini dans l'élément FIELD (Définition). Pour plus d'informations, consultez Élément FIELD (Définition).

Valeur de modèle : ^[a-zA-Z_][a-zA-Z0-9_]*(\.[a-zA-Z0-9_]+)+$

Exemple de valeur de modèle : Company.Division.IssueType

Retour au début

Définition d'une valeur par défaut

L'exemple suivant définit P3 en tant que valeur par défaut pour le champ de 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>

Retour au début

Effacement automatique d'un champ

Dans l'exemple suivant, le champ d'état est effacé.

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

Retour au début

Enregistrement d'une valeur de champ

Dans l'exemple suivant, le nom de l'utilisateur qui a modifié un élément de travail en dernier est enregistré.

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

Retour au début

Spécification de l'horloge comme une valeur par défaut

Dans l'exemple suivant, la valeur d'un champ utilise la date actuelle, mais les utilisateurs peuvent modifier cette valeur.

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

Notes

Pour les valeurs qui contiennent une apostrophe, par exemple « Won’t Fix », vous devez utiliser des guillemets doubles en XML, comme illustré dans l'exemple suivant :

<LISTITEM value="Won’t Fix"/>

Retour au début

Voir aussi

Concepts

Référence de tous les éléments XML FIELD

Autres ressources

Utilisation de règles de champs

Définition des champs d'éléments de travail

Historique des modifications

Date

Historique

Motif

Janvier 2011

Syntaxe fournie pour tous les éléments par défaut et plus de contexte pour les exemples.

Améliorations apportées aux informations.