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

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

Vous pouvez personnaliser votre système de suivi du travail en ajoutant des champs personnalisés ou en modifiant des attributs spécifiques d'un champ . Par exemple, vous pouvez ajouter un champ personnalisé pour capturer d’autres données ou modifier l’étiquette affichée dans le formulaire élément de travail pour un champ hérité.

Pour afficher tous les champs définis pour votre organisation, y compris les champs système et hérités, consultez Afficher les champs et attributs des éléments de travail.

Après avoir ajouté un champ personnalisé, vous pouvez l’utiliser pour créer des requêtes, des graphiques ou des vues Analytics et des rapports Power BI pour suivre et analyser les données associées.

Prerequisites

Pour obtenir des conseils sur la personnalisation d’Azure Boards pour s’aligner sur vos besoins métier spécifiques, consultez Configurer et personnaliser 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 lui attribue un nom de référence préfixé avec Custom et supprime tous les espaces du nom du champ. Par exemple, un champ nommé « DevOps Triage » est affecté au nom de référence Custom.DevOpsTriage. Les espaces ne sont pas autorisés dans les noms 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. Après avoir ajouté un champ, vous pouvez le faire glisser-déplacer dans une page pour ajuster son positionnement sur le formulaire. Si vous envisagez d’ajouter plusieurs champs à une page ou un groupe personnalisé, créez d’abord ces pages ou groupes avant d’ajouter les champs.

Chaque processus peut définir jusqu’à 1 024 champs, y compris les champs système et hérités. Les champs ne peuvent être ajoutés qu’à l’intérieur d’une page d’un formulaire. Vous ne pouvez pas ajouter de champs à la zone grise du formulaire où se trouvent les champs Affecté à, État et Raison.

1. Dans la page Processus du processus hérité sélectionné, sélectionnez le type d’élément de travail (WIT) dans lequel vous souhaitez ajouter le champ personnalisé.

   Dans l’exemple suivant, nous sélectionnons le type d'élément de travail Bogue. Notez les liens de navigation qui vous permettent de revenir à tous les processus et à la page processus 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.

2. Une fois le type d’élément de travail sélectionné, choisissez Nouveau champ.

   

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.

   Les noms de champs doivent être uniques au sein de l’organisation. Un champ personnalisé dans un processus ne peut pas partager le même nom qu’un champ dans un autre processus. Pour plus d’informations, consultez Qu’est-ce qu’un champ ? Comment les noms de champs sont-ils utilisés ?.

   Dans l’exemple suivant, nous ajoutons un type de champ Integer étiqueté Customer Ticket.

   

4. (Facultatif) Sous l’onglet Options , indiquez si le champ est obligatoire et spécifiez une valeur par défaut. Si elle est vide, le champ reste facultatif. Lorsque vous créez un champ Obligatoire, les utilisateurs doivent spécifier une valeur pour enregistrer l’élément de travail. La valeur par défaut est définie lorsqu’un élément de travail est créé ou ouvert, et le champ est vide.

   

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

   Dans l’exemple suivant, nous ajoutons le champ Ticket client à un nouveau groupe intitulé Customer focus.

   

   Note

   Bien que vous puissiez modifier l’étiquette de formulaire, vous devez utiliser le nom du champ lors de l’ajout de champs à des cartes (Tableau, Tableau des tâches) ou créer des requêtes basées sur le champ.

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

7. Une fois vos modifications terminées, ouvrez un élément de travail du type personnalisé pour passer en revue les mises à jour.

   L'exemple suivant montre que le champ Ticket client a été correctement ajouté au groupe Statut. Si les modifications ne sont pas immédiatement visibles, actualisez votre navigateur pour vous assurer que les mises à jour s’affichent correctement. Cette étape garantit que le nouveau champ est correctement intégré au formulaire d’élément de travail et prêt à être utilisé.

   

Ajouter une liste de sélection

Limites du suivi du travail, des processus et des projets

Chaque organisation ou collection peut définir jusqu’à 2 048 listes de sélection. Chaque liste de sélection peut contenir jusqu’à 2 048 éléments. Les éléments de liste de sélection ne doivent pas comporter plus de 256 caractères. Pour ajouter des listes de sélection dépendantes, consultez listes en cascade.

1. Sélectionnez champ, puis 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 sélectionner Entrée pour ajouter un autre élément.

   

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

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

   

2. (Facultatif) Spécifiez les valeurs requises ou par défaut et choisissez l’emplacement où le champ apparaît sur le formulaire.

   

Ajouter un champ Identité

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

Sélectionnez de champ Nouveau champ, puis le nom du champ, le type d’identité et éventuellement une description.

(Facultatif) Spécifiez les valeurs requises ou par défaut et choisissez l’emplacement où le champ apparaît sur le formulaire.

Ajouter un champ HTML de texte enrichi

1. Sélectionnez le WIT auquel vous souhaitez ajouter le champ, puis choisissez Nouveau.

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

   La capture d’écran montre la page Types d’éléments de travail de processus, ajoutez un champ de texte enrichi au formulaire de bug.

3. Ce 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.

   

4. (Facultatif) Spécifiez les valeurs requises ou par défaut et choisissez l’emplacement où le champ apparaît sur le formulaire.

Ajouter un champ à cocher

1. Sélectionnez le WIT auquel vous souhaitez ajouter le champ, puis choisissez Nouveau champ.

2. Choisissez Booléen comme type et attribuez-lui un libellé. Ici, nous étiquetons le champ avec le statut « En triage » pour suivre l’état de triage du bogue.

   

3. (Facultatif) Sélectionnez Options, puis spécifiez si le champ est requis.

   

4. Par défaut, le champ est ajouté au dernier groupe défini dans la deuxième colonne. Sélectionnez Disposition, puis faites glisser et déposez le champ dans un autre groupe du formulaire.

   Note

   Le champ apparaîtra sous forme de case à cocher dans le formulaire d’élément de travail. La case à cocher indique une valeur True . Si le champ s’affiche sur le tableau ou le tableau des tâches, les valeurs True et False s’affichent sous forme de texte au lieu d’une case à cocher.

Ajouter un champ à un autre type d’élément de travail

Les champs existants correspondent à n’importe quel champ hérité et champ personnalisé défini dans la collection. Après avoir 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 seul 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 la description de n’importe quel champ d’élément de travail défini par le système, consultez Index des champs d’élément de travail.

Dans l’exemple suivant, nous ajoutons le champ Ticket client au WIT de la User Story.

(Facultatif) Spécifiez les valeurs requises ou par défaut et choisissez l’emplacement où le champ apparaît sur le formulaire.

Réétiqueter un champ

Le changement de nom d’un champ ou la modification de son type ne sont pas pris en charge. Toutefois, vous pouvez modifier l’étiquette affichée sur le formulaire élément de travail à partir de l’onglet Disposition . Lors de la création de requêtes, utilisez le nom du champ, et non l’étiquette.

Dans l'exemple suivant, nous renommons le champ Ticket client en Numéro de ticket.

Modifier le texte d’aide de la description

Pour modifier le texte d’aide de la description, choisissez le type d’élément de travail à modifier, choisissez Modifier pour le champ et choisissez l’onglet Définition. La valeur modifiée ne s’appliquera qu’à 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 mise en page.

   

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

Supprimer un champ personnalisé d’un formulaire

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

   

2. Confirmez 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 de Mise en page de l’é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 par défaut système.

La suppression d’un champ supprime toutes les données associées, y compris les valeurs historiques. Il peut y avoir un court délai avant que les travaux de vidage des données ne commencent. Pendant ce temps, vous pouvez tenter de restaurer le champ et de récupérer ses données à l’aide de l’API REST Champs - Mettre à jour. La récupération peut être complète, partielle ou infructueuse, en fonction des données restantes. Soyez prudent lorsque vous supprimez des champs, car la récupération n’est pas toujours possible ou terminée.

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

Pour supprimer un champ personnalisé, procédez comme suit :

1. Sélectionnez Paramètres de l’organisation>Processus>Champs>Plus d'actions>Supprimer.

   

   Être membre du groupe Administrateurs de collection de projets ou bénéficier d'autorisations explicites pour supprimer des champs.

2. Entrez le nom du champ, comme indiqué dans l’exemple suivant, puis confirmez en sélectionnant Supprimer le champ d’élément de travail.

   

Contenu connexe

• Afficher les champs et attributs d’élément de travail
• Ajouter ou modifier un type d’élément de travail personnalisé
• Personnaliser la mise en page web
• Limites du suivi du travail, des processus et des projets