Champs et attributs des éléments de travail dans Azure Boards

Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2019

Pour obtenir une description de chacun des champs définis avec un processus système, consultez Index des champs d’éléments de travail.

Prérequis

• Pour afficher les champs d’une organisation ou d’une collection, vous devez être membre du groupe d’applications Utilisateurs valides de la collection de projets ou disposer de l’autorisation Afficher les informations de niveau instance définie sur Autoriser pour l’organisation ou la collection.

Recensement et passage en revue des champs

Pour recenser ou passer en revue les champs, vous pouvez utiliser l’un des outils suivants, en fonction de votre modèle de processus (héritage, XML hébergé ou XML local). Pour obtenir un index des champs définis dans les processus par défaut, consultez Index des champs d’éléments de travail.

Types de données et noms des champs

Chaque type d’élément de travail spécifie les champs définis pour les éléments de travail qui y font référence. Un champ est associé à un certain nombre d’attributs, dont la plupart sont fixés par le système et ne sont pas modifiables.

Chaque champ est défini par les trois attributs suivants.

• Type de données : type de données qui peut être entré dans le champ, par exemple Booléen, Double, Entier, HTML et Chaîne. Pour obtenir une description de chaque type de données, consultez Champs, opérateurs et macros des requêtes.
• Nom convivial : nom attribué au champ, sélectionné pour un Champ dans une clause de requête. Il peut être différent de celui qui figure sur le formulaire d’élément de travail.
• Nom de référence : nom utilisé lors de la création d’une requête WIQL, d’un modèle d’élément de travail improvisé (à l’aide de commandes de l’API REST) ou de définitions de types d’éléments de travail XML. Il n’est pas modifiable une fois défini.

Pour obtenir une description de chaque attribut de champ et savoir comment les recenser, consultez Attributs de champ et Recensement des attributs de champ plus loin dans cet article. Pour une vue d’ensemble des types d’éléments de travail et des éléments de travail, consultez Suivi du travail avec des récits utilisateur, problèmes, bogues, fonctionnalités et epics.

Définition et contexte d’utilisation des champs

Chaque type d’élément de travail est associé à 31 champs système ainsi qu’à d’autres champs qui lui sont propres. Les éléments de travail permettent de planifier et de suivre un projet.

Chaque champ prend en charge le suivi d’une information sur le travail à effectuer. Les valeurs affectées à un champ sont stockées dans le magasin de données de suivi du travail, dont vous pouvez déterminer l’état et les tendances à l’aide de requêtes.

Pour obtenir la description et connaître le contexte d’utilisation de chaque champ défini dans les grands processus système (Agile, De base, Scrum et CMMI), consultez Index des champs d’éléments de travail.

Noms de champs

Un nom de champ d'élément de travail identifie uniquement chaque champ d'élément de travail. Assurez-vous que le nom de vos champs respecte les règles suivantes :

• Il doit être unique dans la collection de comptes ou de projets.
• Il doit comporter 128 caractères Unicode maximum.
• Il ne doit pas contenir ni espaces de début et de fin, ni espaces consécutifs.
• Il doit contenir au moins un caractère alphabétique.
• Il ne doit pas contenir les caractères suivants : .,;'`:~\/\*|?"&%$!+=()[]{}<>.

Étant donné que les champs personnalisés sont définis pour une organisation ou une collection, il n’est pas possible d’ajouter à un processus un champ personnalisé portant le même nom qu’un champ ajouté à un autre processus.

Pour plus d’informations, consultez Restrictions de nommage et conventions d’affectation de noms.

Champs système et prédéfinis

Le nom de référence de tous les champs système définis commence par System (par exemple System.AreaPath et System.AssignedTo).

Les champs prédéfinis par le processus par défaut 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, d’intégration à Team Foundation Build et d’intégration à la gestion des cas de test :

• Microsoft.VSTS.Common.Priority
• Microsoft.VSTS.Scheduling.DueDate
• Microsoft.VSTS.Build.FoundIn
• Microsoft.VSTS.TCM.Steps

Pour obtenir une vue d’ensemble de tous les champs système et prédéfinis des processus et modèles de processus par défaut, consultez Index des champs d’éléments de travail. Pour plus d’informations sur la spécification des noms de champs, consultez Restrictions de nommage.

Champs personnalisés

Étant donné que les champs personnalisés sont définis pour une organisation ou une collection de projets, il n’est pas possible d’ajouter à un processus un champ personnalisé portant le même nom qu’un champ ajouté à un autre processus.

Lorsque vous ajoutez des champs personnalisés, tenez compte des limites suivantes :

• 64 champs maximum peuvent être définis pour chaque type d’élément de travail.
• 512 champs maximum peuvent être définis pour chaque processus.

Le type de données d’un champ définit le genre et la taille des données qui peuvent y être stockées. Un champ ne doit présenter qu’un seul type défini dans une collection de projets. Cette restriction favorise l'utilisation par les organisations de champs communs aux projets et aux types d'élément de travail.

Identification du type de données du champ

Explorateur de champ d'élément de travail

Pour rechercher les affectations de ces champs, vous pouvez utiliser l’outil Explorateur de champs des éléments de travail.

Pour accéder à l’Explorateur de champs des éléments de travail, vous devez installer l’outil Éditeur de processus. En fonction de la version de Visual Studio que vous avez installée, utilisez l’une des extensions suivantes pour obtenir l’outil Éditeur de processus.

• Visual Studio 2019 &2022 : À l’heure actuelle, aucune extension d’éditeur de modèle de processus spécifique n’est disponible. Toutefois, vous pouvez toujours personnaliser des modèles de processus à l’aide d’autres outils tels que n’importe quel éditeur de texte ou éditeur XML. Vous pouvez également utiliser le portail web Azure DevOps pour certaines personnalisations, en particulier pour les processus hérités.
• Visual Studio 2017 :Éditeur de modèle de processus TFS. Vous pouvez également utiliser cette version de l’éditeur de processus pour modifier les formulaires d’éléments de travail de l’ancien style. Elle ne permet en revanche pas de modifier les formulaires associés aux nouveaux formulaires web.
• Visual Studio 2015 :TFS Power Tools.

Attributs de champ

Il existe pour chaque champ d’élément de travail de nombreux attributs masqués et non modifiables. Le tableau suivant décrit chaque attribut. Les attributs portent des noms différents selon qu’ils sont obtenus avec l’API RESTChamps – Obtenir ou affichés avec l’outil Explorateur de champs des éléments de travail (WIFE).

Les attributs affectés à un champ dépendent de la plateforme et de la version utilisées. Par exemple, certains ne sont pas pris en charge avec le processus d’héritage. Pour rechercher le nom de référence d’un champ, consultez Index des champs d’éléments de travail.

Recensement des attributs de champ

https://dev.azure.com/OrganizationName/_apis/wit/fields/FieldReferenceName

https://dev.azure.com/fabrikam/_apis/wit/fields/System.IterationPath

{
"name": "Iteration Path",
"referenceName": "System.IterationPath",
"description": "The iteration within which this bug will be fixed",
"type": "treePath",
"usage": "workItem",
"readOnly": false,
"canSortBy": true,
"isQueryable": true,
"supportedOperations": [
{
"referenceName": "SupportedOperations.Under",
"name": "Under"
},
{
"referenceName": "SupportedOperations.NotUnder",
"name": "Not Under"
},
{
"referenceName": "SupportedOperations.Equals",
"name": "="
},
{
"referenceName": "SupportedOperations.NotEquals",
"name": "<>"
},
{
"referenceName": "SupportedOperations.In",
"name": "In"
},
{
"name": "Not In"
}
],
"isIdentity": false,
"isPicklist": false,
"isPicklistSuggested": false,
"url": "https://dev.azure.com/mseng/_apis/wit/fields/System.IterationPath"
}

https://{ServerName:Port}/tfs/{Collection}/_apis/wit/fields/FieldReferenceName?api-version={version}

https://fabrikam:8080/tfs/DefaultCollection/_apis/wit/fields/System.IterationPath?api-version=4.1

{
"name": "Iteration Path",
"referenceName": "System.IterationPath",
"description": "The iteration within which this bug will be fixed",
"type": "treePath",
"usage": "workItem",
"readOnly": false,
"canSortBy": true,
"isQueryable": true,
"supportedOperations": [
{
"referenceName": "SupportedOperations.Under",
"name": "Under"
},
{
"referenceName": "SupportedOperations.NotUnder",
"name": "Not Under"
},
{
"referenceName": "SupportedOperations.Equals",
"name": "="
},
{
"referenceName": "SupportedOperations.NotEquals",
"name": "<>"
},
{
"referenceName": "SupportedOperations.In",
"name": "In"
},
{
"name": "Not In"
}
],
"isIdentity": false,
"isPicklist": false,
"isPicklistSuggested": false,
"url": "https://fabrikam:8080/tfs/DefaultCollection/_apis/wit/fields/System.IterationPath?api-version=4.1"
}

witadmin listfields /collection:http://fabrikam:8080/tfs/DefaultCollection /n:Microsoft.VSTS.Common.Issue  

Field: Microsoft.VSTS.Common.Issue  
Name: Issue  
Type: String  
Reportable As: dimension  
Use: Adventure Works (Shared Steps), AW Future (Shared Steps), AW Current (Shared Steps)  
Indexed: False  

Ajout et modification des champs

Articles connexes