Définir une valeur par défaut ou copier une valeur dans un champ

Article
06/09/2015

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 de l'élément FIELD (Flux de travail).

Vous ajoutez ces éléments à la définition d'un type d'élément de travail (WIT). Pour en savoir plus, consultez Modifier ou ajouter un type d'élément de travail personnalisé (WIT).

Contrairement aux éléments COPY et DEFAULT qui remplissent des valeurs au début de la modification, la règle SERVERDEFAULT remplit une valeur quand l'élément de travail est validé dans la base de données. Cette action se produit quand un utilisateur enregistre les modifications apportées à un élément de travail, et l'utilisateur ne peut pas substituer la valeur. Les champs de ce type apparaissent généralement en lecture seule dans 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 pistes d'audit sécurisées.

Syntaxe

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. Quand 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. Quand 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 contient 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 quand l'élément de travail est enregistré. Quand 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 quand un utilisateur ouvre un élément de travail pour modification, la règle SERVERDEFAULT remplit une valeur quand l'élément de travail est validé dans la base de données. Cette action se produit quand l'utilisateur enregistre l'élément de travail. L'utilisateur ne peut pas substituer la valeur. Ces champs s'affichent généralement en lecture seule dans 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 pistes 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="type_source" qui identifie la source de la valeur. Selon la valeur type_source, 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. Indique 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. Indique 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	Requis. 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 indiquer 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 nécessaire. 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 nécessaire. Valide uniquement pour les champs String. field : copie la valeur définie pour l'attribut field que vous spécifiez. Nécessite un attribut field="abc". Par défaut, si le champ « from » spécifié est vide, rien n'est fait. 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 quand value est spécifié pour l'attribut from. Les valeurs valides sont composées d'une chaîne de texte qui contient entre 1 et 255 caractères. La valeur à copier peut être vide.
field	Facultatif. Indique le nom du champ dont la valeur doit être copiée dans le champ quand 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 Référence des éléments 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éfinir une valeur par défaut

L'exemple suivant définit P3 en tant que valeur par défaut pour le champ Priority.

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

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

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

Spécifier l'horloge comme 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 :