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

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 3 minutes de lecture
  • Obtenez et mettez à jour les détails de la demande de changement associés à un pipeline Azure DevOps.

    Avant de commencer

    Assurez-vous de remplir les prérequis suivants avant de suivre cette procédure :
    Rôle requis :
    • administrateur 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 correspondre à implémenter pour passer à l'état annuler. Le motif est une entrée obligatoire pour mettre à jour l'état sur annulé.
    • fermé : l'état de la demande de changement doit correspondre à implémenter ou post-implémenter pour passer à l'état fermer. close_code et close_notes sont des entrées obligatoires pour mettre à jour l'état sur fermé.

    Spécifiez 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 succès, 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 extensions ServiceNow dans la barre de recherche Ajouter des tâches.
    3. Ajoutez les tâches d'extension suivantes pour obtenir et mettre à jour les fonctions selon que vous utilisez une tâche de serveur ou d'agent.
      Fonction Obtenir
      • Serveur ServiceNow DevOps - Obtenir un changement
      • Agent ServiceNow DevOps - Obtenir un changement
      Mettre à jour la fonction
      • Serveur ServiceNow DevOps - Mettre à jour un changement
      • Agent ServiceNow DevOps - Mettre à jour un changement
    4. Dans la tâche, mettez à jour les paramètres d'entrée suivants selon la fonction que vous utilisez.
      Fonction Obtenir
      • 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 le pipeline multibranche)
      Remarque :
      Si vous ne fournissez pas les détails de la demande de changement comme paramètres d'entrée, le numéro de demande de changement associé au pipeline et à l'étape actuels sera récupéré.

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

      Agent ServiceNow DevOps - Tâche Obtenir un changement
      Fonction Mettre à jour
      • Numéro de la demande de changement dont les détails doivent être mis à jour.
      • Les attributs de la demande de changement doivent être mis à 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>" }
      Agent ServiceNow DevOps - Mettre à jour les détails du changement

      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.

      Obtenir et mettre à jour les scripts pour l'agent. Obtenir et mettre à jour les scripts pour le serveur.
      Remarque :
      Le nombre de tentatives est facultatif. S'il n'est pas spécifié, le dernier numéro de changement 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.