Spécification des valeurs par défaut des champs
Mise à jour : novembre 2007
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. Les valeurs par défaut des champs sont exprimées à l'aide de trois types d'éléments : <DEFAULT>, <COPY> et <SERVERDEFAULT>.
**<DEFAULT> **Lorsqu'un utilisateur crée un élément de travail ou en modifie un, l'élément <DEFAULT> remplit une valeur de champ si ce champ est vide. Si un champ a déjà une valeur, la règle par défaut est ignorée.
<COPY> Lorsqu'un utilisateur crée un élément de travail ou en modifie un, l'élément <COPY> remplit une valeur de champ quelle que soit la valeur qui existe déjà dans le champ.
<SERVERDEFAULT> Contrairement aux éléments <DEFAULT> et <COPY> 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 au moment de la sauvegarde et l'utilisateur ne peut pas substituer la valeur. Ces champs apparaissent en lecture seule sur le formulaire. Cette règle 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.
Chacune de ces balises prend un attribut from="<fromtype>" qui identifie la source de la valeur. En fonction de l'attribut <fromtype>, d'autres attributs peuvent suivre.
Ce sont les valeurs de type from valides :
value Utilisez la valeur d'une constante de chaîne spécifiée. Requiert un attribut value="abc". L'attribut value est utilisé uniquement pour les règles <COPY> et <DEFAULT>.
field Utilisez la valeur d'un champ spécifié. Requiert un attribut field="abc". Par défaut, si le champ "De" spécifié est vide, rien n'est exécuté. field est utilisé uniquement pour les règles <COPY> et <DEFAULT>.
clock Utilisez la date et l'heure actuelles comme valeur. Aucun attribut supplémentaire n'est requis. Utilisé pour les champs DateHeure. Pour les règles <COPY> et <DEFAULT>, cette valeur est prise à partir de l'horloge de l'ordinateur local. Pour <SERVERDEFAULT>, la valeur provient de l'horloge serveur au moment de la validation.
currentuser Utilisez le nom court de l'utilisateur actuel comme valeur. Aucun attribut supplémentaire n'est requis. Utilisé pour les champs de chaîne.
Exemples
Dans l'exemple suivant, une priorité par défaut est spécifiée :
<FIELD refname="MyCorp.Priority" name="Priority" type="String">
<HELPTEXT>Enter the severity of the problem</HELPTEXT>
<ALLOWEDVALUES>
<LISTITEM value="P1"/>
<LISTITEM value="P2"/>
<LISTITEM value="P3"/>
</ALLOWEDVALUES>
<DEFAULT from="value" value="P3"/>
</FIELD>
Dans l'exemple suivant, le champ d'état est effacé :
<FIELD refname="MyCorp.Status" name="Status" type="String">
<COPY from="value" value="" />
</FIELD>
Dans l'exemple suivant, le nom d'utilisateur de la personne qui a dernièrement modifié un élément de travail est enregistré :
<FIELD refname="System.Last Changed By" name="Last Changed By" type="String">
<HELPTEXT>The user name of the person who last modified this bug</HELPTEXT>
<VALIDUSER group="[Project]\MyProjectMembers" />
<SERVERDEFAULT from="currentuser" />
</FIELD>
Dans l'exemple suivant, la valeur d'un champ utilise la date actuelle, mais elle peut être changée par les utilisateurs :
<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 dans XML. Par exemple : <LISTITEM value="Won’t Fix"/> |