Partager via

Utilisation des champs d'élément de travail

  • Article

Vous utilisez les champs d'élément de travail pour assurer le suivi des données d'un type d'élément de travail, définir les critères de filtre des requêtes et créer des rapports. Tout élément de données, à l'exception des champs de données système de base, que vous souhaitez suivre, utiliser pour définir le flux de travail ou afficher sur le formulaire pour un type d'élément de travail, doit être défini en tant que champ d'élément de travail. Vous pouvez définir des champs d'éléments de travail dans la définition d'un type d'élément de travail ou d'un flux de travail global.

Les champs d'élément de travail sont conservés pour une collection de projets d'équipe. Vous ajoutez des champs lorsque vous exécutez l'une des tâches suivantes :

  • Vous créez un projet d'équipe. Tous les champs inclus dans les définitions de types d'éléments de travail ou du flux de travail global et qui sont définis pour le modèle de processus sélectionné sont créés. Pour plus d'informations, consultez Champs d'éléments de travail (Agile) ou Champs d'éléments de travail (CMMI). Les champs système de base sont définis automatiquement pour chaque type d'élément de travail défini pour un projet d'équipe. Pour obtenir la liste de ces champs, consultez Utilisation de champs système et de champs définis par les modèles de processus MSF.

  • Vous importez une définition pour un type d'élément de travail. Tous les nouveaux champs inclus dans la définition d'un type d'élément de travail sont ajoutés à la collection. Pour plus d'informations, consultez Référence de tous les éléments XML WITD.

  • Vous importez une définition de flux de travail global. Tous les nouveaux champs définis dans le flux de travail global sont ajoutés à la collection. Vous définissez un flux de travail global lorsque vous voulez conserver un ensemble de champs d'élément de travail utilisés par plusieurs types d'éléments de travail. Pour plus d'informations, consultez Personnalisation du workflow global.

  • Vous mappez une collection de projets à une instance de Project Web App (PWA). Après avoir installé le pack de fonctionnalités (FP) de Visual Studio Team Foundation Server 2010 et Project Server Integration, vous configurez l'intégration en mappant différents composants de Team Foundation. Lorsque vous mappez une collection, une définition de flux de travail global qui prend en charge plusieurs champs dans les champs Project Server est importée. Pour plus d'informations, consultez Champs Project Server ajoutés pour prendre en charge la synchronisation de données.

Tous les champs définis dans tous les types d'éléments de travail et les flux de travail globaux pour tous les projets d'équipe composent l'ensemble complet des champs définis pour la collection. Vous pouvez modifier l'attribut des champs, de même que renommer et supprimer des champs existants. Toutefois, ces types de modifications entraînent certains frais. Pour plus d'informations, consultez Personnalisation des données de suivi de projet, de formulaires, de flux de travail et d'autres objets.

Pour ajouter ou personnaliser un champ dans une collection, vous devez modifier le contenu XML de la définition d'un type d'élément de travail ou d'un flux de travail global. Vous définissez chaque champ via un élément FIELD dans la section FIELDS de la définition pour un type d'élément de travail ou de flux de travail global. Pour plus d'informations sur la structure et l'emplacement de ces fichiers, consultez Référence de tous les éléments XML WITD et Personnalisation du workflow global.

Dans cette rubrique

  • Structure de la syntaxe FIELD (Définition)

  • Types de données des champs

  • Attributs signalables assignés aux champs

  • Champs indexés

  • Éléments enfants FIELD (Définition)

  • Champs système et champs prédéfinis

Structure de la syntaxe FIELD (Définition)

Chaque élément FIELD (Définition) a un nom convivial qui est facultatif et un nom de référence qui est obligatoire. Le nom de référence doit être unique dans la collection. Pour plus d'informations, consultez Conventions d'affectation de noms pour les objets de suivi des éléments de travail.

Important

Vous pouvez modifier le nom convivial d'un champ à l'aide de l'outil en ligne de commande witadmin changefield. Toutefois, si vous renommez un champ, cela affecte tous les types d'éléments de travail dans l'ensemble des projets d'équipe de la collection.

Vous définissez un champ par la syntaxe XML suivante dans le fichier de définition pour le type d'élément de travail.

<FIELD name="fieldDisplayName" refname="fieldReferenceName" type="String | Integer | Double | 
DateTime | PlainText | HTML | History | TreePath | GUID " syncnamechanges="true | false" reportingname="reportingDisplayName" reportingrefname="reportingReferenceName"
reportable="Dimension | Detail | Measure" formula="avg" >
   <ALLOWEDVALUES> . . . </ALLOWEDVALUES>
   <ALLOWEXISTINGVALUE />
   <CANNOTLOSEVALUE />
   <COPY />
   <DEFAULT />
   <EMPTY />
   <FROZEN />
   <HELPTEXT> . . . </HELPTEXT>
   <MATCH />
   <NOTSAMEAS />
   <PROHIBITEDVALUES /> . . . </PROHIBITEDVALUES>
   <READONLY />
   <REQUIRED />
   <SERVERDEFAULT />
   <SUGGESTEDVALUES /> . . . </SUGGESTEDVALUES>
   <VALIDUSER />
   <WHEN>> . . . </WHEN>
   <WHENNOT> . . . </WHENNOT>
   <WHENCHANGED> . . . </WHENCHANGED>
   <WHENNOTCHANGED> . . . </WHENNOTCHANGED>
</FIELD>

Pour plus d'informations, consultez Élément FIELD (Définition).

Retour au début

Types de données des champs

Le type d'un champ définit le genre et la taille des données que vous pouvez stocker dans le champ. Un champ n'admet qu'un seul type par serveur Team Foundation Server. Cette restriction favorise l'utilisation par les organisations de champs communs aux projets et aux types d'élément de travail.

La liste suivante affiche les types de champs pris en charge :

Type de données

Description

DateTime

Spécifie une date basée sur le temps universel coordonné (UTC, Coordinated Universal Time).

Vous pouvez ajouter un champ DateTime à un formulaire d'élément de travail à l'aide des attributs de type FieldControl ou DateTimeControl.

Double

Spécifie une valeur à virgule flottante. Les champs Double sont fréquemment utilisés dans les filtres de requête et les listes de résultats

Vous pouvez ajouter un champ Double à un formulaire d'élément de travail à l'aide de l'attribut de type FieldControl.

GUID

Spécifie un champ qui doit contenir un identificateur unique.

Vous ne pouvez pas ajouter de champ GUID à un formulaire d'élément de travail.

History

Prend en charge l'affichage des thèmes de discussion et le suivi d'autres données historiques.

RemarqueRemarque
Le champ System.History est le seul champ qui utilise ce type de données.Vous ne pouvez pas définir de champ personnalisé à l'aide de ce type de données.

Vous pouvez ajouter le champ System.History à un formulaire d'élément de travail à l'aide de l'attribut de type WorkItemLogControl, qui prend en charge les contrôles au format RTF (Rich Text Format).

HTML

Prend en charge la capture des données de texte enrichi et l'utilisation de descriptions textuelles plus longues telles que la description d'un élément de travail. Un champ HTML diffère d'un champ PlainText en ce sens que le champ HTML est fortement typé en HTML pour des affichages enrichis d'informations.

Vous pouvez ajouter un champ HTML à un formulaire d'élément de travail à l'aide de l'attribut de type HTMLControl, qui prend en charge les contrôles au format RTF (Rich Text Format).

Integer

Spécifie une valeur entière signée 32 bits. Les champs Integer sont fréquemment utilisés dans les filtres de requête et les listes de résultats

Vous pouvez ajouter un champ Integer à un formulaire d'élément de travail à l'aide de l'attribut de type FieldControl.

PlainText

Prend en charge la saisie d'une chaîne de texte qui peut contenir plus de 255 caractères Unicode.

Vous pouvez ajouter un champ PlainText à un formulaire d'élément de travail à l'aide de l'attribut de type FieldControl, qui se limite au texte brut, ou à l'aide de l'attribut de type HTMLControl, qui prend en charge les contrôles au format RTF.

String

Prend en charge la saisie d'une chaîne de texte qui peut contenir jusqu'à 255 caractères Unicode. Utilisez un champ de type String pour une étiquette ou toute autre chaîne de texte courte d'une ligne au maximum. Les champs de type String sont fréquemment utilisés dans les filtres de requête et les listes des résultats.

Vous pouvez ajouter un champ String à un formulaire d'élément de travail à l'aide de l'attribut de type FieldControl.

TreePath

Spécifie un champ qui affiche des entrées selon une structure hiérarchique ou une arborescence, par exemple lors de l'affichage des chemins d'accès de zone et d'itération d'un produit.

RemarqueRemarque
Les champs System.AreaPath et System.IterationPath sont les seuls champs qui utilisent ce type de données.Vous ne pouvez pas définir de champ personnalisé à l'aide de ce type de données.

Vous pouvez ajouter les champs System.AreaPath et System.IterationPath à un formulaire d'élément de travail à l'aide de l'attribut WorkItemClassificationControl type.

Retour au début

Attributs signalables assignés aux champs

Certaines valeurs de champ sont particulièrement utiles pour la génération de rapports. À l'aide du langage de définition du type d'élément de travail, vous pouvez spécifier les attributs facultatifs suivants :

  • reportable. Affectez la valeur None, Detail, Dimension ou Measure à l'attribut signalable pour déterminer si et comment vous souhaitez inclure le champ dans les rapports. Les données des champs dont l'attribut signalable a une valeur autre que None sont exportées vers l'entrepôt de données et peuvent être intégrées dans les rapports.

    Lorsque vous ajoutez un champ existant à un type d'élément de travail, la valeur actuelle de l'attribut reportable est utilisée. Lorsque vous ajoutez un champ à un type d'élément de travail, la création de rapports est désactivée sauf si vous le spécifiez explicitement à l'aide de l'attribut reportable.

  • reportingname. Vous pouvez assigner une étiquette différente à un champ qui est utilisé lorsque les données s'affichent dans les rapports. Si vous ne spécifiez pas de valeur, le nom convivial assigné à l'attribut name est utilisé.

  • reportingrefname. Vous pouvez assigner un nom de référence différent à un champ qui est utilisé lorsque les données sont exportées vers l'entrepôt de données relationnelles. Si vous ne spécifiez pas de valeur, la valeur assignée à l'attribut refname est utilisée.

    Vous pouvez utiliser cet attribut pour fusionner ou différencier des champs inclus dans les rapports. Pour fusionner deux champs ayant des noms de référence distincts et étant définis dans des collections de projets différentes, vous assignez le même attribut reportingrefname à ces deux champs. Pour différencier deux champs ayant le même nom de référence et étant définis dans des collections de projets différentes, vous assignez un attribut reportingrefname distinct à chacun d'eux.

Après avoir défini un champ, vous pouvez utiliser la commande witadmin changefield à une invite de commandes pour modifier la valeur de tous les attributs, à l'exception de celle de l'attribut refname.

Pour plus d'informations sur les meilleures pratiques en matière d'étiquetage de champs à des fins de création de rapports, consultez Ajout et modification de champs d'éléments de travail pour prendre en charge la création de rapports.

Retour au début

Valeurs de l'attribut Reportable

Comme décrit dans le tableau suivant, vous pouvez assigner l'une des valeurs suivantes à l'attribut reportable : none, dimension, detail et measure.

Notes

Vous pouvez spécifier un attribut reportable pour un champ une fois qu'il a été utilisé pour un élément de travail. Une fois la valeur signalable définie, les nouvelles révisions de l'élément de travail qui sont copiées dans l'entrepôt contiendront la valeur du champ. Toutefois, les révisions déjà présentes dans l'entrepôt ne seront pas remplacées par les valeurs existantes.

Valeur d'attribut

Description

Detail

Utilisez le type Detail uniquement pour les champs Integer, Double, String ou DateTime.

Les données de ce champ sont déplacées dans les tables Élément de travail et Élément de travail actif de la base de données relationnelle de l'entrepôt, mais pas dans le cube SQL Server Analysis Services. Lorsque vous avez recours à ce type pour les champs de texte non restreints, vous pouvez utiliser ces derniers dans les rapports, sans trop augmenter la taille du cube.

Dimension

Utilisez le type Dimension uniquement pour les champs Integer, Double, String ou DateTime.

Les données de ce champ entrent dans la base de données relationnelle et le cube Analysis Services en tant qu'attribut de la dimension Élément de travail afin que les données puissent être utilisées pour filtrer les rapports. Utilisez ce type pour les champs contenant des listes de valeurs valides. Type d'élément de travail et État sont de bons exemples de dimension.

Measure

Utilisez uniquement le type Measure pour les champs Integer et Double. Les mesures sont les valeurs numériques contenues dans vos rapports.

Pendant le traitement du cube Analysis Services, les données sont calculées à l'avance sur les champs auxquels la valeur Measure est affectée. Par exemple, les groupes de mesures Élément de travail et Élément de travail actif contiennent des données cumulatives pour les champs suivants : Estimation d'origine, Heures restantes et Heures effectuées. Pour plus d'informations sur les groupes de mesures, consultez Groupes de mesures et métriques fournies dans le cube Analysis Services pour Team System.

Lorsque vous spécifiez Measure, vous devez spécifier sum pour l'attribut formula, qui retourne la somme de chaque mesure référencée dans la requête.

None

Spécifiez None lorsque vous ne souhaitez pas inclure le champ dans les rapports. Cette valeur est l'affectation par défaut.

Retour au début

Exemples montrant comment spécifier la création de rapports

Exemple pour Detail

<FIELD refname="MyCorp.Summary" name="Summary" type="String" reportable="detail">

Exemple pour Dimension

<FIELD refname="MyCorp.Category" name="Category" type="String" reportable="dimension">

Exemple pour Measure

<FIELD refname="MyCorp.Cost" name="Cost" type="Integer" reportable="measure" formula="sum">

Champs indexés

Vous pouvez activer ou désactiver l'indexation pour un champ d'élément de travail à l'aide de la commande witadmin indexfield. Lorsque vous activez l'indexation pour un champ, vous pouvez augmenter les performances de recherche des éléments de travail dont les requêtes spécifient le champ concerné. Si vous ajoutez un champ personnalisé que vous utilisez dans un bon nombre de vos requêtes d'élément de travail, vous pouvez activer l'indexation pour ce champ. Pour plus d'informations, consultez Gestion des champs d'éléments de travail (witadmin).

Retour au début

Éléments enfants FIELD (Définition)

Il existe plusieurs éléments enfants facultatifs que vous pouvez spécifier pour un champ d'élément de travail, par exemple :

  • Texte d'aide. Définit l'info-bulle ou l'aide qui s'affiche pour un champ sur le formulaire d'élément de travail (HELPTEXT).

  • Restrictions du champ. Spécifie un champ comme étant obligatoire, en lecture seule, vide, figé ou lié à un modèle spécifique (REQUIRED, READONLY, EMPTY, FROZEN, MATCH).

  • Remplissage automatique de valeur du champ. Spécifie une valeur pour le champ (DEFAULT, COPY, SERVERDEFAULT).

  • Liste de champs. Spécifie les valeurs autorisées, suggérées ou interdites. (ALLOWEDVALUES, SUGGESTEDVALUES, PROHIBITEDVALUES)

  • Conditions de champs. Applique une ou plusieurs règles à un champ lorsqu'un autre champ est modifié ou inchangé, lorsqu'un autre champ possède ou non une valeur spécifique, ou pour une autre condition (WHEN, WHENNOT, WHENCHANGED, WHENNOTCHANGED, CANNOTLOSEVALUE, NOTSAMEAS).

Pour plus d'informations, consultez Référence de tous les éléments XML FIELD.

Retour au début

Champs système et prédéfinis

Tous les champs système définis ont des noms de références qui commencent par System, par exemple System.AreaPath, System.AssignedTo, etc.

Les champs prédéfinis qui sont définis par les modèles de processus Microsoft Solutions Framework (MSF) commencent par Microsoft.VSTS et se distinguent ensuite selon leur utilisation. Voici des exemples de champs prédéfinis utilisés communément, à des fins de planification et d'intégration à Office Project, à des fins d'intégration à Team Foundation Build et à des fins d'intégration à Team Foundation :

  • Microsoft.VSTS.Common.Priority

  • Microsoft.VSTS.Scheduling.DueDate

  • Microsoft.VSTS.Build.FoundIn

  • Microsoft.VSTS.TCM.Steps

Pour une vue d'ensemble de tous les champs système et champs prédéfinis qui sont définis pour le modèle de processus MSF for Agile Software Development v5.0, consultez Utilisation de champs système et de champs définis par les modèles de processus MSF. Pour plus d'informations sur la spécification des noms de champs, consultez Conventions d'affectation de noms pour les objets de suivi des éléments de travail.

Retour au début

Voir aussi

Tâches

Ajouter ou supprimer un champ dans un type d'élément de travail

Référence

Gestion des champs d'éléments de travail (witadmin)

Élément FIELD (Définition)

Concepts

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

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

Autres ressources

Résolution de conflits de schéma qui se produisent dans l'entrepôt de données

Ajout et modification de champs d'éléments de travail pour prendre en charge la création de rapports

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

Historique des modifications

Date

Historique

Motif

Janvier 2011

Informations ajoutées sur le flux de travail global et plusieurs sections mises à jour avec des liens vers les rubriques connexes. Section sur la définition de schéma supprimée.

Améliorations apportées aux informations.