Créer une intégration d’outils à partir de l’espace de Changement DevOps travail

  • Rversion finale: Zurich
  • Mis à jour 31 juil. 2025
  • 4 minutes de lecture

    • Créez une intégration d’outils à partir de l’espace de travail pour intégrer des outils supplémentaires d’orchestration Changement DevOps , de planification et de codage qui ne sont pas disponibles par défaut dans l’application Vélocité de changement DevOps .

    Avant de commencer

    Effectuez les tâches spécifiées dans .Premiers pas avec Vélocité de changement DevOps

    Rôle requis : sn_devops.admin ou sn_devops.tool_owner

    Définissez le périmètre de l’application sur l’application personnalisée.

    Pourquoi et quand exécuter cette tâche

    Regardez cette vidéo pour comprendre comment créer une intégration d’outil à partir de l’espace de travail de changement DevOps.

    Procédure

    1. Accédez à la Espaces de travail > Espace de travail de changement DevOps.
    2. Dans l’espace de travail DevOps, accédez à Administration > Intégrations > Intégrations d'outils.
    3. Sélectionnez Nouveau.
      Vous pouvez également ouvrir un enregistrement d’intégration d’outils existant, puis sélectionner Modifier (pour une intégration d’outils personnalisée qui n’est pas prise en charge dans le système de base).
      Remarque :
      Pour les outils de planification qui ne sont pas pris en charge dans le système de base, vous pouvez sélectionner Modifier dans l’enregistrement d’intégration de l’outil pour accéder à l’étape Transformation, dans laquelle vous pouvez ajouter un champ supplémentaire. Pour les outils de planification pris en charge dans le système de base, vous pouvez sélectionner Modifier les mappages de champs pour ajouter un champ supplémentaire. Pour plus d’informations sur l’ajout de champs supplémentaires pour les outils de planification pris en charge, reportez-vous à la section Ajouter des champs personnalisés pour une intégration d'outil de planification.
      L’étape Détails s’affiche.
    4. Dans l’étape Détails de l’outil, renseignez les champs suivants :
      Tableau 1. Champs de l’étape de détails
      Champ Description
      Étiquette d'outil Nom de l’intégration de l’outil.
      Version d'intégration Version de l’API de l’intégration de l’outil.
      Étape Détails dans la création de l’intégration de l’outil
    5. Facultatif : Ajoutez une image du logo de l’outil en sélectionnant +Ajouter un fichier.
    6. Dans la section Options du type d’outil, sélectionnez l’option que votre outil prend en charge dans le champ Options .
      OptionDescription
      Orchestration Outil qui automatise et coordonne l’exécution de processus complexes dans le cycle de vie du développement logiciel.
      Plan Outil qui aide à planifier et à gérer le cycle de vie du développement logiciel.
      Code Outil qui aide les programmeurs à écrire, modifier et gérer le code.
      Remarque :
      Un outil peut être mappé à plusieurs options de types d'outil. L’intégration de l’outil est prise en charge pour les options d’orchestration, de planification et de code.
    7. Sélectionnez Suivant.
      Un enregistrement d’intégration d’outil est créé.
    8. Dans l’étape Actions, sélectionnez les actions requises pour les options de l’outil sélectionnées à l’étape précédente. Étape Actions dans la création de l’intégration de l’outil
      Remarque :
      Les actions d’aptitude de l’outil sont des processus définis qui permettent au DevOps Data Model de communiquer avec l’intégration de l’outil et de les importer. Chaque aptitude du type d’outil a besoin de son propre ensemble d’actions.
    9. Sélectionnez Suivant.
      Les enregistrements d’aptitude d’intégration pour les actions sélectionnées sont créés avec les valeurs par défaut.
    10. Dans l’étape Configurations, ajoutez toutes les configurations supplémentaires nécessaires pour votre outil en sélectionnant Ajouter un champ. Étape de configuration de la création de l’intégration de l’outil
      Les champs configurés ici s’affichent en tant que paramètres pour le playbook chaque fois que vous intégrez un outil.
    11. Renseignez les champs suivants.
      Tableau 2. Configurations
      Champ Description
      Nom de champ Nom de la configuration.
      Ordre Séquence dans laquelle cette configuration est traitée.
      Étiquette Étiquette de la configuration.
      Obligatoire Si marqué comme Vrai, cela apparaîtra en tant que détail de connexion lors de la connexion d’une instance de cette intégration d’outils.
      Type de champ Type du champ, qui peut être une chaîne ou un mot de passe
      Valeur par défaut Valeur par défaut de cette configuration.
      Texte d'aide Si cette configuration est obligatoire, alors le texte d’aide s’affiche pour ce champ dans les détails de connexion lors de la connexion d’une instance de cet outil.
    12. Sélectionnez Suivant.
      Un enregistrement de configuration d’intégration d’outils est créé pour le champ supplémentaire.
    13. Dans l’étape Transformation, examinez la transformation pour chaque action d’aptitude de l’outil et ajoutez n’importe quel champ personnalisé à l’intégration de l’outil.
      Un script de transformation générique est fourni pour chaque action de l’outil. Vous pouvez étendre le script générique qui appelle le mappage basé sur le transformateur ou créer des transformateurs d’enregistrement et le mapper manuellement aux champs. Pour prolonger, vous pouvez créer un nouveau script en étendant la classe DevOpsGenericIntegrationHandlerSNC pour remplacer la méthode requise et utiliser ce script nouvellement créé dans le script de transformation.
      • Entrez le point de terminaison de l’API du chemin d’accès de la ressource dans le champ Chemin d’accès de la ressource si vous utilisez le script générique. Étape de transformation dans la création de l’intégration d’outils
      • Si ce n’est pas déjà disponible, créez un transformateur d’enregistrement pour les actions Notification, Détection et Importation pour chacune des options en sélectionnant Créer un transformateur d’enregistrement et ajoutez des règles de transformateur d’enregistrement pour mapper les champs de votre outil aux champs du modèle de données DevOps. Pour plus d’informations sur la création d’un transformateur d’enregistrement et son mappage manuel sur le champ, reportez-vous à la section Ajouter des champs personnalisés pour une intégration d'outil de planification. Étape de transformation : section du transformateur d’enregistrement dans la création de l’intégration de l’outil
    14. Dans Prochaines étapes, vous pouvez valider l’intégration de votre outil en vous connectant à une instance de l’outil via l’expérience de playbook, et vous pouvez également afficher l’enregistrement d’intégration de l’outil. Prochaines étapes de la création d’intégration d’outils
      Remarque :
      En sélectionnant le bouton Se connecter à un outil , vous verrez l’intégration de l’outil nouvellement créée dans la liste des outils disponibles pour se connecter.

    Que faire ensuite

    Création de webhooks pour envoyer des événements entrants à DevOps Change Velocity à l’aide d’un jeton