FIELD, élément (Élément WORKITEMTYPE)
Mise à jour : novembre 2007
Définit un champ d'élément de travail et spécifie les règles et les conditions qui s'appliquent au champ.
Hiérarchie de schéma
WITD, élément (Schéma de définition du type d'élément de travail)
WORKITEMTYPE, élément (Schéma de définition du type d'élément de travail)
FIELDS, élément (Élément WORKITEMTYPE)
FIELD, élément (Élément WORKITEMTYPE)
<xs:element name="FIELD" type="FieldDefinition" maxOccurs="unbounded"/>
Attributs et éléments
Les sections suivantes décrivent des attributs, des éléments enfants et des éléments parents.
Attributs
Attribut |
Description |
|---|---|
name |
Attribut FieldDefinition requis. Nom du champ où les règles et les conditions sont appliquées. Pour plus d'informations, consultez Noms des champs. |
refname |
Attribut FieldDefinition requis. Nom de référence du champ où les règles et les conditions sont appliquées. Ce nom de référence doit correspondre à celui défini dans l'élément FIELD de la définition du champ. Pour plus d'informations, consultez Noms de références des champs. |
type |
Attribut FieldDefinition requis. Type de valeur acceptée par le champ. Pour plus d'informations, consultez Types de champs. |
reportable |
Attribut FieldDefinition facultatif. Les données du champ sont exportées dans l'entrepôt de données et peuvent être incluses dans les rapports. Pour plus d'informations, consultez Utilisation de champs pour la génération de rapports. |
formula |
Attribut FieldDefinition facultatif. Type d'agrégation pour le type reportable measure. Actuellement, sum est le seul type d'agrégation pris en charge pour la mesure. Pour plus d'informations, consultez witfields. |
Éléments enfants
Élément |
Description |
|---|---|
HELPTEXT, élément (Schéma de définition du type d'élément de travail) |
Élément facultatif. Définit le texte affiché dans l'info-bulle pour le champ. |
REQUIRED, élément (Schéma de définition du type d'élément de travail) |
Élément facultatif. Définit le champ comme obligatoire. |
READONLY, élément (Schéma de définition du type d'élément de travail) |
Élément facultatif. Définit le champ comme étant en lecture seule. |
EMPTY, élément (Schéma de définition du type d'élément de travail) |
Élément facultatif. Définit le champ comme étant vide. |
FROZEN, élément (Schéma de définition du type d'élément de travail) |
Élément facultatif. Définit le champ comme étant 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. Définit le champ comme ne pouvant pas perdre sa valeur. Ainsi, une fois que le champ actuel a acquis une valeur, il ne peut pas être effacé ou vidé. |
NOTSAMEAS, élément (Schéma de définition du type d'élément de travail) |
Élément facultatif. Spécifie un autre champ dont la valeur ne peut pas être identique à la valeur du champ actuel. |
VALIDUSER, élément (Schéma de définition du type d'élément de travail) |
Élément facultatif. Spécifie que la liste de valeurs autorisées ne doit comporter que des utilisateurs valides du système. |
ALLOWEXISTINGVALUE, élément (Schéma de définition du type d'élément de travail) |
Élément facultatif. Définit le champ comme autorisant la valeur existante. Ainsi, les valeurs de champ qui existent déjà seront autorisées, même si elles ne sont pas valides. Toutes les nouvelles valeurs de champ doivent être valides. |
MATCH, élément (Schéma de définition du type d'élément de travail) |
Élément facultatif. Définit un modèle pour le champ auquel la valeur du champ doit correspondre. |
ALLOWEDVALUES, élément (Schéma de définition du type d'élément de travail) |
Élément facultatif. Définit une liste de valeurs autorisées pour le champ. 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. Définit une liste de valeurs suggérées pour le champ. 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. Définit une liste de valeurs interdites pour le champ. |
DEFAULT, élément (Schéma de définition du type d'élément de travail) |
Élément facultatif. Définit une valeur par défaut pour le champ. |
COPY, élément (Schéma de définition du type d'élément de travail) |
Élément facultatif. Spécifie un autre champ qui contient une valeur à copier dans le champ actuel. |
SERVERDEFAULT, élément (Schéma de définition du type d'élément de travail) |
Élément facultatif. Spécifie un composant serveur qui fournit la valeur du champ. |
WHEN, élément (Schéma de définition du type d'élément de travail) |
Élément facultatif. Spécifie une ou plusieurs règles à appliquer au champ actuel lorsqu'un autre champ a une valeur spécifique. |
WHENNOT, élément (Schéma de définition du type d'élément de travail) |
Élément facultatif. Applique une ou plusieurs règles au champ actuel lorsqu'un autre champ n'a pas de valeur spécifique. |
WHENCHANGED, élément (Schéma de définition du type d'élément de travail) |
Élément facultatif. Applique une ou plusieurs règles au champ actuel lorsque la valeur d'un champ spécifique est modifiée. |
WHENNOTCHANGED, élément (Schéma de définition du type d'élément de travail) |
Élément facultatif. Applique une ou plusieurs règles au champ actuel lorsque la valeur d'un champ spécifique n'est pas modifiée. |
Éléments parents
Élément |
Description |
|---|---|
Élément requis. Contient les définitions du champ de type d'élément de travail. |
Notes
FIELD est un élément enfant requis de FIELDS.
minOccurs="1"
maxOccurs="unbounded"
Exemple
<FIELD name="field display name" refname="field reference name" type="String | Integer | Double | DateTime | PlainText | HTML | History | TreePath" reportable="Dimension | Detail | Measure" formula="sum">
<HELPTEXT>…</HELPTEXT>
<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>
<WHEN>…</WHEN>
<WHENNOT>…</WHENNOT>
<WHENCHANGED>…</WHENCHANGED>
<WHENNOTCHANGED>…</WHENNOTCHANGED>
</FIELD>
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 |
|
Peut être vide |
Oui |
Voir aussi
Référence
HELPTEXT, élément (Schéma de définition du type d'élément de travail)