Obtenir et mettre à jour les détails de la demande de changement dans le Azure DevOps pipeline

  • Rversion finale: Zurich
  • Mis à jour 31 juil. 2025
  • 3 minutes de lecture
  • Obtenez et mettez à jour les détails de la demande de changement associés à un Azure DevOps pipeline.

    Avant de commencer

    Assurez-vous de remplir les conditions préalables suivantes avant d’effectuer cette procédure :
    Rôle requis :
    • admin ou sn_devops.admin dans Vélocité de changement DevOps
    • administrateur dans Azure DevOps

    Pourquoi et quand exécuter cette tâche

    Lorsque vous mettez à jour le paramètre d’état dans une demande de changement, seules les transitions suivantes sont prises en charge :
    • annuler : l’état de la demande de changement doit être implémenté pour déplacer l’état à annuler. Motif est une entrée obligatoire pour mettre à jour l’état sur Annulé.
    • fermé : l’état de la demande de changement doit être implémenter ou post-implémenter pour passer l’état à fermé. close_code et close_notes sont des entrées obligatoires pour mettre à jour l’état sur Fermé.

    Indiquez l’état de la demande de changement en tant que valeur entière :

    • 4 - Annuler (valeur définie dans la propriété sn_devops.change_request.cancel_state)
    • 3 - Fermé (valeur définie dans la propriété sn_devops.change_request.closed_state)

    Lorsque vous mettez à jour un champ de choix, vous devez spécifier une valeur de choix valide disponible dans la liste de choix correspondante. Par exemple, les valeurs de la liste de choix pour le champ Code de fermeture sont réussite, successful_issues et échec.

    Valeurs de choix pour le champ Code de fermeture

    Procédure

    1. Dans la Azure DevOps console, accédez à Organisation > Pipelines > Tâches.
    2. Sélectionnez l’icône Ajouter des tâches ( Ajouter des tâches supplémentaires) et recherchez les ServiceNow extensions dans la barre de recherche Ajouter des tâches .
    3. Ajoutez les tâches d’extension suivantes pour les fonctions d’obtention et de mise à jour selon que vous utilisez une tâche de serveur ou d’agent.
      Obtenir la fonction
      • Serveur ServiceNow DevOps Obtenir un changement
      • Agent ServiceNow DevOps Obtenir le changement
      Mettre à jour la fonction
      • Changement de mise à jour du serveur ServiceNow DevOps
      • Changement de mise à jour de l’agent ServiceNow DevOps
    4. Dans la tâche, mettez à jour les paramètres d’entrée suivants en fonction de la fonction que vous utilisez.
      Obtenir la fonction
      • Nom du projet
      • Nom du pipeline
      • Nom de l'étape
      • Nom de la tâche
      • ID de construction
      • Nombre de tentatives
      • Nom de la branche (uniquement pour les pipelines à plusieurs branches)
      Remarque :
      Si vous ne fournissez pas les détails de la demande de changement en tant que paramètres d’entrée, le numéro de la demande de changement associé au pipeline et à l’étape actuels est récupéré.

      Entrez un nom de référence pour la tâche d’obtention de la demande de changement, qui sera utilisé pour référencer le numéro de la demande de changement dans la tâche de mise à jour. Consultez l’exemple suivant.

      Tâche Obtenir un changement par un agent ServiceNow DevOps
      Mettre à jour la fonction
      • Numéro de la demande de changement dont les détails doivent être mis à jour.
      • Attributs de demande de changement à mettre à jour en tant que paires clé-valeur.
      { "short_description": "Test description", "priority": "1", "start_date": "2021-02-05 08:00:00", 
      "end_date": "2022-04-05 08:00:00", "justification": "test justification", "description": "test description", 
      "cab_required": <true/false>, "comments": "This update for work notes is from ADO file", "work_notes": "test work notes", 
      "assignment_group": "<SYS_ID>", "state":"<STATE_CODE>", "close_code":"<successful/successful_issues/unsuccessful>", "reason":"<As per Choice List>" }
      Détails du changement de mise à jour de l’agent ServiceNow DevOps

      La valeur changeRequestNumber doit être référencée à l’aide du nom de référence de la tâche d’obtention au format « <task_name>.<changeRequestNumber> ». Consultez l’exemple suivant.

      Obtenez et mettez à jour des scripts pour l’agent.Obtenez et mettez à jour des scripts pour le serveur.
      Remarque :
      Le nombre de tentatives est facultatif. S’il n’est pas spécifié, le dernier numéro CHG de l’exécution de pipeline actuelle est récupéré. Sinon, vous pouvez spécifier explicitement le nombre de tentatives sans utiliser de variables d’environnement.
    5. Enregistrez les changements.