Définir une valeur par défaut ou copier une valeur dans un champ
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.
[!REMARQUE]
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 :
|
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>
[!REMARQUE]
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