Partager via

Champs personnalisés

  • Article

Azure DevOps Services

L’utilisation des champs personnalisés permet de stocker les données personnalisées sur l’exécution de test et/ou le résultat du test. Il peut y avoir jusqu’à 100 champs personnalisés définis pour un seul projet Azure DevOps. L’administrateur de projet peut gérer (ajouter/supprimer) l’ensemble des champs personnalisés.

Gérer les champs personnalisés

Il existe deux façons de gérer les champs personnalisés , via l’API REST ou l’administrateur de projet, par le biais des paramètres du projet tout en choisissant la gestion des tests sous Pipelines. Sur cette page, un nouveau champ personnalisé peut être ajouté en cliquant sur le bouton + Ajouter un nouveau .

Capture d’écran des paramètres du projet avec les paramètres de gestion des tests sélectionnés et le bouton pour ajouter un nouveau champ personnalisé marqué par rectangle rouge.

Choisissez + Ajouter nouveau pour ajouter un nouveau champ personnalisé. Chaque champ personnalisé doit avoir un nom, un type configuré et indiquer le type d’artefact auquel il s’applique.

Capture d’écran d’une boîte de dialogue utilisée pour ajouter un nouveau champ personnalisé.

Le nom du champ personnalisé ne peut pas dépasser 50 caractères (espaces, nombres et caractères spéciaux ne sont pas autorisés) et doit être unique dans le projet. Les noms ne respectent pas la casse. Vous ne pouvez donc pas avoir un champ personnalisé nommé « Test » et l’autre nommé « test ». Type peut avoir l’une des valeurs suivantes :

  • bit
  • Date/Heure
  • Int
  • Float
  • Chaîne
  • Guid

Les champs personnalisés existants peuvent être modifiés (seul le nom peut être modifié) ou supprimés.

Remarque

Après avoir supprimé le champ personnalisé, vous ne pouvez pas utiliser son nom pour environ un jour. Le processus en arrière-plan qui supprime définitivement les champs personnalisés supprimés est exécuté un jour.

Stocker des données personnalisées dans des champs personnalisés

Vous pouvez stocker vos données personnalisées dans les champs personnalisés configurés dans le cadre de la création de l’exécution/du résultat de test ou après la création de l’exécution/du résultat du test. Les deux peuvent être effectuées à l’aide de l’API REST pour l’instant. À l’avenir, nous allons permettre aux données personnalisées d’être récupérées dans le fichier de résultats des tests. Pour obtenir les valeurs stockées dans vos champs personnalisés pour l’exécution/résultat de test existant, vous devez utiliser l’API REST. Pour le moment, nous n’affichons pas les champs et valeurs personnalisés stockés dans ces champs sur l’interface utilisateur Azure DevOps (nous ajouterons cette capacité à l’avenir).

Lorsque vous créez une exécution de test et/ou un résultat via l’API REST et que vous souhaitez stocker des données personnalisées dans un champ personnalisé existant, la meilleure option consiste à envoyer les données personnalisées dans le cadre de l’exécution de test et/ou de la création de résultats. Pour créer une exécution de test, appelez des exécutions d’API REST - Créer et créer des résultats de l’appel de résultat de test API REST - Ajouter.

Lorsque l’exécution et/ou le résultat du test ne sont pas créés via l’API REST, mais par d’autres moyens, vous devez d’abord trouver l’identification de l’exécution de test ou du résultat pour lequel vous souhaitez définir (ou mettre à jour) les données personnalisées dans les champs personnalisés, puis appeler les exécutions d’API REST - Mise à jour pour l’exécution de test et les résultats de l’API REST - Mise à jour pour le résultat du test.

Pour récupérer les données personnalisées des champs personnalisés stockés précédemment sur l’exécution de test et/ou le résultat, vous devez d’abord trouver l’identification de l’exécution ou du résultat du test. Vous pouvez ensuite appeler des exécutions d’API REST - Requête pour l’exécution de test et résultats de l’API REST - Obtenir pour le résultat du test.

Les données personnalisées des champs personnalisés sont envoyées ou reçues dans un tableau. Chaque élément de ce tableau contient deux propriétés « fieldname » et « value » et vous pouvez voir un exemple de ceci ici. La valeur est l’objet du type qui correspond au type configuré pour le champ personnalisé. Pour comprendre le type du champ personnalisé, vous pouvez utiliser l’API REST qui fournit un tableau des champs personnalisés. Pour chaque champ, vous trouverez son ID, son nom, son type et son étendue. Vous pouvez également coder en dur le type si vous connaissez le type du champ personnalisé du nom donné.