Ajouter et gérer des champs (processus d’héritage)

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

Vous pouvez ajouter un champ personnalisé pour prendre en charge le suivi des exigences de données supplémentaires ou modifier les attributs sélectionnés d’un champ hérité. Par exemple, vous pouvez ajouter un champ personnalisé ou modifier l’étiquette qui apparaît dans le formulaire élément de travail pour un champ hérité.

Pour obtenir la liste de tous les champs définis pour votre organisation, qui incluent tous les champs définis pour les processus système et hérités, consultez Afficher les champs et attributs des éléments de travail.

Une fois que vous avez ajouté un champ personnalisé, vous pouvez créer des requêtes, des graphiques ou des vues Analytics et des rapports Power BI pour suivre les données associées.

Prérequis

Pour obtenir des conseils sur la personnalisation d’Azure Boards pour s’aligner sur vos besoins métier spécifiques, consultez À propos de la configuration et de la personnalisation d’Azure Boards.

Ouvrir les paramètres de processus d’une organisation

Noms de champs personnalisés

Lorsque vous ajoutez un champ personnalisé à un processus hérité, Azure DevOps attribue un nom de référence préfixé à Custom , puis le nom du champ avec des espaces supprimés. Par exemple, vous ajoutez un champ nommé DevOps Triage, dont le nom de référence est Custom.DevOpsTriage. Aucun espace n’est autorisé dans le nom de référence.

Ajouter un champ personnalisé

Vous pouvez ajouter des champs et spécifier le groupe et la page où ils doivent apparaître. En outre, une fois que vous avez ajouté un champ, vous pouvez le faire glisser-déplacer dans une page pour déplacer son positionnement dans le formulaire. Si vous avez plusieurs champs que vous souhaitez ajouter à une page ou un groupe personnalisé, ajoutez d’abord ces pages ou groupes, puis ajoutez vos champs.

1. Dans la page Processus du processus hérité sélectionné, choisissez le type d’élément de travail auquel vous souhaitez ajouter le champ personnalisé.

   Ici, nous choisissons le Bogue WIT. Notez les liens de navigation qui vous permettent de revenir à toutes les pages processus et MyAgile .

   

   Si le nouveau champ et d’autres options sont désactivés, vous n’avez pas les autorisations nécessaires pour modifier le processus. Voir Définir les autorisations et l’accès pour le suivi du travail, Personnaliser un processus hérité.

2. Une fois la fonctionnalité WIT sélectionnée, choisissez le champ Nouveau.

   

3. Nommez le champ et sélectionnez le type de champ dans l’un des types de données pris en charge. Si vous le souhaitez, ajoutez une description.

   Remarque

   Vous devez spécifier un nom de champ unique au sein de l’organisation. Un champ personnalisé défini pour un processus ne peut pas être identique au nom défini pour un autre processus. Pour plus d’informations sur les noms de champs, consultez Qu’est-ce qu’un champ ? Comment les noms de champs sont-ils utilisés ?

   Ici, nous ajoutons un champ Entier intitulé Customer Ticket.

   

4. (Facultatif) Sous l’onglet Options , indiquez si le champ est requis et spécifiez une valeur par défaut. Ou laissez les valeurs vides. En effectuant un champ Obligatoire, les utilisateurs doivent spécifier une valeur pour le champ afin d’enregistrer l’élément de travail. Lorsque vous créez un élément de travail ainsi que chaque fois que quelqu’un ouvre un élément de travail et que le champ est vide, la valeur par défaut est définie.

   

5. (Facultatif) Sous l’onglet Disposition , vous pouvez entrer une étiquette de formulaire différente du nom du champ. Vous pouvez également choisir la page et le groupe où le champ apparaît sur le formulaire.

   Ici, nous ajoutons le champ Ticket client à un nouveau groupe intitulé Customer focus.

   

   Remarque

   Bien que vous puissiez modifier l’étiquette de formulaire, vous devez utiliser le nom du champ lorsque vous ajoutez des champs à des cartes (Tableau, Tableau des tâches) ou créez des requêtes en fonction du champ.

6. Choisissez Ajouter un champ pour terminer l’ajout du champ. Si vous ne spécifiez pas son emplacement de disposition, le système l’ajoute au premier groupe de champs du formulaire.

7. Une fois que vous avez terminé d’apporter toutes vos modifications, ouvrez un élément de travail du type que vous avez personnalisé.

   Ici, nous affichons que le champ Ticket client a été ajouté au groupe Status. Vous devrez peut-être actualiser votre navigateur pour voir les modifications.

   

Ajouter une liste de sélection

Limites du suivi du travail, des processus et des projets

1. Commencez par choisir Nouveau champ, spécifiez le type de liste de sélection ( entier ou chaîne), puis ajoutez les éléments à afficher dans la liste de sélection. Vous pouvez ajouter un élément, puis appuyer sur Entrée pour ajouter un autre élément.

   

   Pour supprimer un élément de la liste, mettez l’élément en surbrillance, puis cliquez sur l’icône supprimer.

   Pour modifier la liste de sélection d’un champ hérité, choisissez Modifier pour modifier le champ. Sous l’onglet Définition , vous pouvez choisir d’ajouter une valeur.

   

2. (Facultatif) Choisissez l’onglet Options pour définir le champ en fonction des besoins, spécifier une valeur par défaut ou autoriser les utilisateurs à entrer leurs propres valeurs.

   

3. (Facultatif) Consultez l’étape 5 précédente pour spécifier l’emplacement où le champ doit apparaître dans le formulaire (onglet Disposition).

Ajouter un champ Identité

Utilisez un champ basé sur l’identité pour ajouter un champ similaire au champ Affecté à. Les champs basés sur l’identité agissent de la même façon que le champ Affecté à, en fournissant une fonction de sélecteur d’identité et de recherche. Lorsque votre organisation gère les utilisateurs avec l’ID Microsoft Entra ou Active Directory, le système synchronise les champs basés sur l’identité avec les noms définis dans ces répertoires.

1. Commencez par choisir nouveau champ, puis le nom du champ, le type d’identité et éventuellement une description.

   

2. (Facultatif) Consultez l’étape 5 précédente pour spécifier l’emplacement où le champ doit apparaître dans le formulaire (onglet Disposition).

Ajouter un champ HTML enrichi

1. Comme précédemment, choisissez le WIT auquel vous souhaitez ajouter le champ, puis choisissez le nouveau champ.

2. Choisissez Texte (plusieurs lignes) comme type. Ici, nous étiquetons le champ en tant que demande client pour capturer les commentaires des clients pour les demandes de fonctionnalités de produit.

   

3. Le champ est ajouté à la première colonne sous tous les champs de texte enrichi définis par le système, mais avant le contrôle Discussion.

   

Ajouter un champ de case à cocher

1. Comme précédemment, choisissez le WIT auquel vous souhaitez ajouter le champ, puis choisissez Nouveau.

2. Choisissez Boolean comme type et attribuez-lui une étiquette. Ici, nous étiqueter le champ comme Triaged pour suivre l’état de triage du bogue.

   

3. (Facultatif) Ouvrez l’onglet Options et spécifiez si le champ doit être requis.

   

4. Par défaut, le champ est ajouté au dernier groupe défini dans la deuxième colonne. Ouvrez l’onglet Disposition pour faire glisser et déplacer le champ vers un autre groupe sur le formulaire.

   Remarque

   Le champ apparaît sous forme de case à cocher dans le formulaire élément de travail. Cochez la case pour indiquer une valeur True. Si vous affichez le champ sur le tableau ou le tableau des tâches, les valeurs de champ True et False s’affichent (et non une case à cocher).

Ajouter un champ existant à un autre WIT

Les champs existants correspondent à n’importe quel champ hérité et champ personnalisé défini dans la collection. Une fois que vous avez ajouté un champ personnalisé à un WIT, vous pouvez l’ajouter à d’autres utilisateurs à partir du menu du formulaire. Vous pouvez également ajouter un champ défini pour un processus à un type d’élément de travail dans un autre processus. Ouvrez le type d’élément de travail et choisissez le champ existant.

Pour rechercher des descriptions de n’importe quel champ d’élément de travail défini par le système, consultez l’index du champ Élément de travail.

Ici, nous ajoutons le champ Ticket client au WIT de l’article utilisateur.

Si vous le souhaitez, spécifiez les valeurs obligatoires/par défaut et le placement dans le formulaire du champ.

Relabel un champ

Le renommage d’un champ ou la modification du type de champ ne sont pas des actions prises en charge. Toutefois, sous l’onglet Disposition , vous pouvez modifier l’étiquette qui apparaît sur le formulaire élément de travail. Lorsque vous sélectionnez le champ dans une requête, vous devez sélectionner le nom du champ et non l’étiquette de champ.

Ici, nous réélisons le champ Ticket client sur Numéro de ticket.

Modifier le texte d’aide de la description

Pour modifier le texte d’aide description , choisissez le type d’élément de travail que vous souhaitez modifier, choisissez Modifier pour le champ et choisissez l’onglet Définition . La valeur modifiée affecte uniquement ce champ dans le processus et pour ce type d’élément de travail.

Afficher, masquer ou supprimer un champ

1. Ouvrez le menu contextuel du champ ou du contrôle, puis choisissez Masquer dans la disposition.

   

2. Pour ajouter un champ ou un contrôle masqué au formulaire, choisissez Afficher sur la disposition.

Supprimer un champ personnalisé d’un formulaire

1. Choisissez Supprimer dans le menu contextuel du champ que vous souhaitez supprimer.

   

2. Vérifiez que vous souhaitez supprimer le champ.

   

3. Pour ajouter un champ personnalisé qui a été supprimé, choisissez Nouveau champ et sélectionnez Utiliser un champ existant.

Rétablir les valeurs par défaut du champ

Vous pouvez ignorer les modifications apportées à un champ hérité. Dans la page Mise en page du type d’élément de travail modifié, choisissez l’option Rétablir pour le champ.

Supprimer un champ personnalisé

Avec le modèle de processus d’héritage, vous ne pouvez supprimer que des champs personnalisés. Vous ne pouvez pas supprimer les champs définis pour les processus par défaut système.

La suppression d’un champ supprime toutes les données associées à ce champ, y compris les valeurs historiques. Une fois supprimé, vous pouvez uniquement restaurer le champ et récupérer les données à l’aide de l’API REST Champs - Mettre à jour.

https://analytics.dev.azure.com/{OrganizationName}/_odata/v4.0-preview/WorkItemTypeFields?$filter=FieldReferenceName eq {CustomFieldReferenceName}&$select=WorkItemType

1. Vous supprimez le champ de la page Tous les champs de processus>.

   

   Pour supprimer des champs, vous devez être membre du groupe Administrateurs de collection de projets ou accorder des autorisations explicites pour supprimer le champ du compte.

2. Pour terminer l’opération de suppression, vous devez taper le nom du champ comme indiqué.

   

Articles connexes

• Afficher les champs et attributs d’élément de travail
• Ajouter ou modifier un type d’élément de travail personnalisé
• Personnaliser la disposition web
• Personnaliser un projet à l’aide d’un processus hérité
• Personnaliser des cartes sur des tableaux
• Afficher les bogues dans les backlogs et les tableaux
• Limites du suivi du travail, des processus et des projets

Si vous utilisez des plans de test ou des cas de test, consultez les articles suivants :

• Créer un plan de test
• Créer des cas de test manuels