Ajouter et modifier des champs d'éléments de travail pour prendre en charge la création de rapports

Article
06/10/2015

Vous utilisez les champs d'éléments 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 vous les utilisez dans les rapports. Tout champ, à l'exception des champs système, que vous souhaitez voir apparaître dans un rapport doit être défini dans le fichier de définition pour les types d'éléments de travail que le champ suivra. Les champs système sont définis automatiquement pour chaque type d'élément de travail. Toutefois, ils doivent être inclus dans le formulaire d'élément de travail pour prendre en charge l'entrée de données.

Pour prendre en charge la création de rapports, vous pouvez ajouter des champs ou modifier les attributs de champs existants. Lorsque vous ajoutez ou modifiez des champs, vous devez appliquer des conventions d'affectation de noms systématiques pour vous assurer que ces données sont regroupées logiquement dans des dossiers du cube SQL Server Analysis Services.

Dans cette rubrique

Meilleures pratiques
Utiliser un champ existant
Répertorier les champs définis pour une collection de projets d'équipe
Attributs de champs signalables
Modifier un attribut signalable pour un champ
Ajouter des champs pour prendre en charge la création de rapports
Vérifier les modifications apportées aux attributs de champs signalables
Meilleures pratiques pour l'assignation de noms de référence de création de rapports

Pour obtenir une liste des champs pouvant être signalés et définis dans les modèles de processus par défaut, consultez Référence des champs signalables pour Visual Studio ALM.

Meilleures pratiques

Avant d'ajouter ou de modifier un champ, consultez les meilleures pratiques suivantes :

Déterminez si vous pouvez utiliser un champ déjà défini dans la collection de projets d'équipe qui contient votre projet d'équipe. L'utilisation d'un champ existant prend en charge la création de rapports interprojets.
Déterminez si vous pouvez utiliser un champ déjà défini dans une autre collection de projets dans le déploiement de Visual Studio Team Foundation Server. L'utilisation d'un champ existant prend en charge la création de rapports interprojets.
Au maximum, vous pouvez avoir 1 024 champs dans chaque collection de projets et 1 024 champs signalables uniques dans toutes les collections de projets d'un déploiement de Team Foundation Server. Les champs fusionnés comptent comme un champ signalable.
Instituez une procédure standard et passez en revue le processus permettant d'ajouter et de modifier des champs dans les modèles de processus, les projets d'équipe ou les collections de projets.
Utilisez des conventions d'affectation de noms systématiques lorsque vous donnez des étiquettes aux champs pour la création de rapports. Lorsque vous assignez des noms de référence de façon systématique à travers toutes les collections de projets d'équipe d'un déploiement de Team Foundation Server, vous garantissez la cohérence et la facilité d'utilisation de l'entrepôt et du schéma de cube, et vous évitez les conflits de schéma dans l'entrepôt. Pour plus d'informations, consultez Résoudre les conflits de schéma qui se produisent dans l'entrepôt de données.

Vous pouvez assigner jusqu'à quatre attributs d'étiquette à un champ d'élément de travail :

Notes

Aucun nom de création de rapports ou nom de référence de création de rapports n'est assigné aux champs définis dans les modèles de processus pour Microsoft Solutions Framework.Par défaut, les attributs de nom et de nom de référence sont utilisés.
- name. Nom convivial du champ qui apparaît dans les menus déroulants des requêtes d'éléments de travail. Le nom convivial doit être unique à travers tous les champs définis dans un projet d'équipe. De même, le nom convivial peut être différent de l'étiquette affichée qui est assignée au champ sur le formulaire d'élément de travail. Pour plus d'informations, consultez Référence des éléments XML Control.
- refname. Étiquette unique assignée au champ, qui le distingue de tous les autres champs définis dans la collection de projets d'équipe. La valeur assignée à refname ne peut pas être modifiée.
  
  Pour connaître les spécifications et restrictions sur les noms conviviaux et noms de référence des champs, consultez Conventions d'affectation de noms pour les objets de suivi des éléments de travail.
- reportingname. Attribut facultatif. Nom utilisé pour identifier un champ dans les rapports. S'il n'est pas explicitement défini, la valeur assignée à l'attribut name est utilisée.
- reportingrefname. Attribut facultatif. Étiquette unique assignée à un champ signalable, qui le distingue de tous les autres champs signalables définis dans toutes les collections de projets d'équipe. S'il n'est pas explicitement défini, la valeur assignée à l'attribut refname est utilisée. Pour connaître les conventions d'affectation de noms recommandées, consultez Meilleures pratiques pour l'assignation de noms de référence de création de rapports plus loin dans cette rubrique.
  
  Notes
  
  Les noms de référence de création de rapports sont uniquement visibles à partir d'un rapport PivotTable ou du cube Analysis Services.

Utiliser un champ existant

Vous devez utiliser un champ déjà défini s'il correspond aux informations pour lesquelles vous souhaitez effectuer un suivi et créer des rapports. Pour utiliser un champ existant, exécutez les étapes suivantes :

Identifiez le champ que vous souhaitez utiliser. Utilisez la commande witadmin listfields pour identifier les champs et leurs attributs définis pour toutes les collections de projets. Pour plus d'informations, consultez Répertorier les champs définis pour une collection de projets d'équipe plus loin dans cette rubrique.
Déterminez si le champ est signalable et si les attributs signalables satisfont vos besoins de création de rapports.
Si le champ n'est pas signalable, utilisez witadmin changefield pour modifier l'attribut signalable pour les collections de projets dans lesquelles il est utilisé. Pour plus d'informations, consultez Modifier un attribut signalable pour un champ plus loin dans cette rubrique.
Pour la collection de projets dans laquelle le champ n'est pas défini, ajoutez ce dernier aux fichiers de définition XML pour les types d'éléments de travail que vous souhaitez utiliser pour suivre les données. Pour plus d'informations, consultez Ajouter des champs pour prendre en charge la création de rapports plus loin dans cette rubrique.

Répertorier les champs définis pour une collection de projets d'équipe

Vous pouvez utiliser la commande witadmin listfields pour répertorier les champs et leurs attributs. Vous pouvez répertorier un champ spécifié ou tous les champs définis dans une collection de projets. La commande witadmin listfields a la syntaxe suivante :

witadmin listfields /collection:CollectionURL /n:RefName

Pour plus d'informations, consultez Gérer des champs d'éléments de travail (witadmin).

Attributs de champs signalables

Les champs signalables ont une valeur d'attribut reportable égale à Detail, Dimension ou Measure. Les attributs suivants déterminent la façon dont les champs d'éléments de travail sont exportés et traités vers les bases de données d'entrepôt de données :

reportingtype. Pour inclure un champ dans les rapports, vous devez assigner l'une des valeurs suivantes à l'attribut reportable :
- Assignez Detail pour exporter le champ vers la base de données relationnelle de l'entrepôt, mais pas vers le cube. Comme dans l'exemple suivant, utilisez uniquement le type Detail pour les champs Entier, Double, Chaîne ou DateTime :
```
<FIELD refname="MyCorp.Summary" name="Summary" type="String" reportable="detail">
```
- Assignez Dimension pour exporter le champ à la fois vers la base de données relationnelle de l'entrepôt et le cube. Comme dans l'exemple suivant, utilisez uniquement Dimension pour les champs Entier, Chaîne ou DateTime. Cette valeur est utile pour inclure des champs utilisés pour filtrer les rapports (par exemple, des champs qui ont des listes de valeurs valides).
```
<FIELD refname="MyCorp.Category" name="Category" type="String" reportable="dimension">
```
- Assignez Measure pour prendre en charge le traitement de valeurs précalculées dans le cube. Utilisez uniquement le type Measure pour les champs Integer et Double.
  
  Lorsque vous assignez Measure comme reportingtype, vous devez assigner sum comme formula, comme dans l'exemple suivant :
```
<FIELD refname="MyCorp.Cost" name="Cost" type="Integer" reportable="measure" formula="sum">
```
reportingrefname. Vous pouvez assigner un autre nom de référence à un champ marqué comme signalable. Si aucune valeur n'est spécifiée, 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.

Vous devez fusionner les champs dès que possible pour réduire le nombre de champs dans l'entrepôt et le conserver sous la limite des 1 024 champs signalables. Vous pouvez générer des rapports intergroupes avec des champs fusionnés.
reportingname. Vous pouvez assigner une étiquette différente à un champ qui est utilisé pour afficher des données dans les rapports. Si aucune valeur n'est spécifiée, le nom convivial assigné pour l'attribut name est utilisé. La valeur assignée à l'attribut reportingname s'affiche dans le cube. La valeur assignée à l'attribut reportingrefname ne s'affiche pas.

Important

Vous devez utiliser les meilleures pratiques pour assigner des étiquettes aux champs de création de rapports afin qu'ils soient regroupés dans les rapports PivotTable.Pour plus d'informations, consultez Meilleures pratiques pour l'assignation de noms de référence de création de rapports.

Modifier un attribut signalable pour champ d'élément de travail

Vous pouvez rendre un champ existant signalable en modifiant les assignations d'attribut du champ définies pour une collection de projets. Un champ existant est défini dans une ou plusieurs définitions de type d'élément de travail. De même, vous pouvez modifier tous les attributs qui déterminent la façon dont un champ est traité dans les entrepôts de données.

Vous pouvez utiliser la séquence suivante d'étapes pour modifier l'assignation d'attribut d'un champ :

Vous pouvez utiliser la commande witadmin changefield pour modifier une assignation d'attribut à un champ. Vous appliquez cette commande pour une collection de projets d'équipe. Utilisez la syntaxe suivante :
```
witadmin changefield /collection:CollectionURL /n:RefName [/name:NewName] [/syncnamechanges:true | false] [/reportingname:ReportingName] [/reportingrefname:ReportingRefName] [/reportingtype:Type] [/reportingformula:Formula] [/noprompt]
```
Pour rendre un champ existant signalable, modifiez le reportingtype. Par exemple, pour rendre le champ AW.Common.TeamPriority disponible pour le filtrage des rapports, assignez-lui la valeur Dimension :
```
witadmin changefield /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /n:AW.Common.TeamPriority /reportingtype:dimension 
```
Pour plus d'informations, consultez Gérer des champs d'éléments de travail (witadmin).
(Facultatif) Si vous avez plusieurs collections de projets, vous pouvez apporter des modifications semblables au champ d'élément de travail défini dans cette collection. Pour éviter les conflits de schéma lorsque vous exportez et traitez des données vers les bases de données de l'entrepôt de données, vous devez assigner les mêmes valeurs à ces attributs à travers toutes les collections :
- Type de champ (la valeur pour ce champ ne peut pas être modifiée pour un champ existant).
- Type de création de rapports.
- Nom de création de rapports.
Pour plus d'informations, consultez Résoudre les conflits de schéma qui se produisent dans l'entrepôt de données.
Après avoir apporté toutes les modifications aux champs d'éléments de travail que vous souhaitez utiliser pour la création de rapports, vous devez traiter les bases de données de l'entrepôt de données. Vous pouvez utiliser les services Web ProcessAnalysis et ProcessWarehouse, disponibles via le WarehouseControlWebService.

Cette étape garantit que les personnes qui utilisent les rapports ne voient pas d'erreur lorsque vous modifiez les attributs d'un champ.

Pour plus d'informations, consultez Gérer des champs d'éléments de travail (witadmin).

Ajouter des champs pour prendre en charge la création de rapports

Vous pouvez ajouter des champs à la définition d'un type ou de plusieurs types d'éléments de travail. Lorsque vous ajoutez le champ, vous devez ajouter la même définition d'élément de champ à tous les types d'éléments de travail pour lesquels le champ prendra en charge la création de rapports. Si vous souhaitez que le champ prenne en charge la création de rapports interprojets, le champ doit être ajouté à tous les types d'éléments de travail de tous les projets d'équipe qui feront l'objet de rapports.

Pour plus d'informations, consultez Définir et modifier les champs des éléments de travail.

Vérifier les modifications apportées aux attributs de champs signalables

Vous pouvez vérifier les modifications que vous avez apportées aux attributs de champs signalables en traitant les entrepôts de données à la demande, puis en vérifiant que les rapports sont mis à jour. Sinon, vous pouvez attendre l'exécution des travaux de l'adaptateur d'entrepôt. Par défaut, la base de données relationnelle est traitée à quelques minutes d'intervalle. En revanche, le cube est traité toutes les deux heures par défaut.

Notes

Pour plus d'informations sur WarehouseControlWebService, consultez Traiter manuellement l'entrepôt de données et le cube Analysis Services pour Team Foundation Server (page éventuellement en anglais).

Traitez l'entrepôt de données relationnelles à la demande à l'aide du ProcessWarehouse WarehouseControlWebService.
Traitez le cube à la demande à l'aide du ProcessAnalysisDatabase WarehouseControlWebService.
Vérifiez que les rapports sont mis à jour. Consultez un rapport via le tableau de bord ou le Gestionnaire de rapports. Pour plus d'informations, consultez Tableaux de bord (Agile) ou Rapports (Agile).

Meilleures pratiques pour l'assignation de noms de référence de création de rapports

Pour les noms de référence de création de rapports, vous pouvez assigner des étiquettes pour trouver facilement les champs dans le rapport PivotTable et le cube. Pour cela, vous pouvez appliquer des conventions d'affectation de noms systématiques afin que les champs soient regroupés dans une séquence logique. De plus, si les champs ne sont pas regroupés de façon utile, vous pouvez modifier le nom de référence de création de rapports d'un champ.

L'application d'une convention d'affectation de noms systématique devient de plus en plus importante parce que toutes les données signalables de tous les projets d'équipe définis dans toutes les collections de projets sont écrites vers un entrepôt de données relationnelles unique. Les données de cet entrepôt sont ensuite traitées et écrites vers le cube. Étant donné que les champs d'éléments de travail sont gérés distinctement pour chaque collection de projets, des étiquettes différentes peuvent être appliquées et peuvent générer un ensemble de champs qui n'est pas bien organisé pour prendre en charge la création des rapports.

Les champs d'éléments de travail qui ont un type signalable de dimension correspondent à des attributs de dimension du cube. Les attributs de dimension sont organisés dans des dossiers en fonction du nom de référence de création de rapports assigné dans le modèle de processus ou la définition du type d'élément de travail. Les types de mappages suivants se produisent :

Les champs ayant le préfixe « Système » sont intrinsèques et répertoriés directement sous la dimension Élément de travail, avec la mention « Élément de travail ».
Les autres champs sont placés sous les dossiers dont les noms correspondent aux préfixes de leur nom de référence. Par exemple, les champs qui ont le préfixe « Microsoft.VSTS.Common » apparaissent sous le dossier étiqueté « Microsoft VSTS Common ».

Comme dans l'illustration suivante, un dossier est ajouté pour chaque groupe de préfixes de champs qui partagent un préfixe commun :

Structure du dossier dans le cube de données OLAP

Le tableau suivant répertorie les champs dont les noms de référence commencent par « Système » et qui sont répertoriés dans le rapport PivotTable avec le préfixe « Élément de travail ». Ces champs sont placés directement sous la dimension Élément de travail. Tous les autres champs sont placés sous les dossiers dont les noms correspondent aux préfixes de leur nom de référence.

Notes

Les déploiements qui n'utilisent pas la version d'entreprise de SQL Server Analysis Services n'ont pas accès aux fonctionnalités de traduction fournies par cette version.Dans ces déploiements, les champs sont identifiés par leur nom de référence complet dans le cube, avec « . » remplacé par « _ » (par exemple, « System_Id » et « System_Title »).

Nom dans le rapport PivotTable et dans le cube	Nom de la référence	Type de données
Work Item.Area Path	System.AreaPath	TreeType
Work Item.Assigned To	System.AssignedTo	Chaîne
Work Item.Changed By	System.ChangedBy	Chaîne
Work Item.Changed Date	System.ChangedDate	DateTime
Work Item.Created By	System.Created By	Chaîne
Work Item.Created Date	System.CreatedDate	DateTime
Work Item.ID	System.Id	Entier
Work Item.Iteration Path	System.IterationPath	TreeType
Work Item.Previous State	System.PreviousState	Chaîne
Work Item.Reason	System.Reason	Chaîne
Work Item.Rev	System.Rev	Entier
Work Item.State	System.State	Chaîne
Work Item.Title	System.Title	Chaîne
Work Item.Work Item Type	System.WorkItemType	Chaîne

Le tableau suivant répertorie les champs qui s'affichent dans le rapport PivotTable dans le dossier étiqueté « Microsoft.VSTS.Common » sous la dimension Élément de travail. Ces champs ont des noms de référence qui commencent par « Microsoft.VSTS.Common ».

Nom dans le rapport PivotTable et dans le cube	Nom de la référence	Type de données
Work Item.Activated By	Microsoft.VSTS.Common.ActivatedBy	Chaîne
Work Item.Activated Date	Microsoft.VSTS.Common.ActivatedDate	DateTime
Work Item.Closed By	Microsoft.VSTS.Common.ClosedBy	Chaîne
Work Item.Closed Date	Microsoft.VSTS.Common.ClosedDate	DateTime
Work Item.Created By	Microsoft.VSTS.Common.CreatedBy	Chaîne
Work Item.Created Date	Microsoft.VSTS.Common.CreatedDate	DateTime
Work Item.Resolved By	Microsoft.VSTS.Common.ResolvedBy	Chaîne
Work Item.Resolved Date	Microsoft.VSTS.Common.ResolvedDate	DateTime
Work Item.Resolved Reason	Microsoft.VSTS.Common.ResolvedReason	Chaîne
Work Item.Priority	Microsoft.VSTS.Common.Priority	Entier
Work Item.Severity	Microsoft.VSTS.Common.Severity	Chaîne
Work Item.Stack Rank	Microsoft.VSTS.Common.StackRank	Double

Voir aussi

Share via