Création d'une sous-intégration (LaunchA360Bot.json)

Lorsque vous construisez une sous-intégration, assurez-vous que l'élément bot que vous essayez de déployer est déjà disponible dans le fichier Control Room.

Remarque : Les exemples et les graphiques fournis sur cette page ne sont donnés qu'à titre indicatif et peuvent ne pas refléter exactement votre propre situation. Nous n'assumons pas la responsabilité de leur mise à jour ou de leur exactitude.

Pour créer une sous-intégration, suivez les étapes suivantes :

  1. Accédez à Interface utilisateur Apigee et connectez-vous.
  2. Sélectionnez votre organisation à l'aide du menu déroulant situé dans le coin supérieur gauche de l'interface utilisateur.
  3. Pour afficher une liste des intégrations disponibles, cliquez sur Développer > Intégrations.
  4. Sélectionnez une intégration existante ou cliquez sur CRÉER NOUVEAU.
  5. Fournissez les informations suivantes :
    • Nom d'intégration : Entrez un nom, par exemple, launch-bot.
    • (Facultatif) Description : Fournissez une description, par exemple, « Déploie un bot Automation 360 pour le traitement des fichiers ».
    • Région : Sélectionnez une région dans la liste, par exemple, les États-Unis.
  6. Cliquez sur Créer.

    Le site Éditeur d'intégration apparaît.

  7. Dans l'Éditeur d'intégration, ajoutez un déclencheur au concepteur en effectuant les actions suivantes :
    • Cliquez sur + Ajouter une tâche/un déclencheur.
    • Sélectionnez Déclencheurs > Déclencheur API
    • Placez le déclencheur sur le concepteur en cliquant à un endroit approprié.
      L'ID du déclencheur est généré automatiquement en fonction du nom de l'intégration. Le déclencheur API permet aux auteurs d'intégration de tester une intégration par le biais d'un appel API. Ce déclencheur est utile lorsque vous souhaitez tester votre intégration à partir du code de votre application.
      Apigee - Ajouter un déclencheur
  8. Dans l'Éditeur d'intégration, ajoutez une tâche Mappage de données au concepteur en effectuant les actions suivantes :
    • Cliquez sur + Ajouter une tâche/un déclencheur.
    • Sélectionnez Tâches > Cartographie des données.
    • Placez le mappage de données sur le concepteur en cliquant à un endroit approprié.
  9. Cliquez sur l'élément Mappage de données dans le concepteur pour ouvrir le volet de configuration Mappage de données.
  10. Cliquez sur Ouvrir l'éditeur de mappage de données.
    L' Éditeur de mappage de données vous permet d'effectuer des affectations de variables dans votre intégration. Les variables peuvent être des variables d'intégration ou des variables de tâche. La tâche Mappage de données permet aux auteurs d'intégration de transformer et d'affecter des données aux variables entre les tâches d'une intégration. Les variables sont créées à l'aide de l'option VAR de la palette.
    Apigee - Éditeur de mappage de données
  11. Créez des variables d'entrée et de sortie basées sur la liste suivante. Les variables d'entrée sont des variables passées aux exécutants d'intégration. Spécifiez une valeur littérale ou sélectionnez une variable de référence. Pour ajouter une variable d'entrée au mappage de données, cliquez sur une variable et faites-la glisser depuis la liste des variables disponibles dans la colonne Variables adjacente. Cliquez sur Ajouter + pour configurer une nouvelle variable.
    Pour cet échantillon, créez sept variables d'entrée de type chaîne de caractères comme entrées pour l'intégration :
    • input-ControlRoomUrl
    • input-Username
    • input-ApiKey
    • input-BotId
    • input-RunAsUserId
    • input-PoolId
    • input-BotInputVariables
    Créez une variable de sortie comme sortie de l'intégration :
    • output-deploymentId
    Quelques variables locales qui n'existent que dans le cadre de cette intégration sont les suivantes : accessToken, authAPIUrl, deployBotAPIUrl, authRequestBody et deployRequestBody. En plus de ces éléments, Apigee génère automatiquement quelques variables locales pour le stockage et la transformation des données.

    Une fois les variables créées, fermez l'éditeur de mappage de données.

  12. Dans le concepteur d'intégration, ajoutez un élément permettant d'effectuer un appel à l'API d'authentification de la Control Room Automation 360 en effectuant les actions suivantes :
    • Cliquez sur + Ajouter une tâche/un déclencheur.
    • Sélectionnez Tâches > Appeler le point de terminaison Rest
    • Placez le mappage de données sur le concepteur en cliquant à un endroit approprié pour afficher l'écran Appeler le point de terminaison REST dans le volet de configuration de la tâche.
    • Mettez en correspondance les champs suivants avec les variables définies à l'étape précédente.
      • Mappez le champ URL de base du point de terminaison à la variable authAPIUrl.
      • Mappez le champ Corps de la demande à la variable authRequestBody.
        Apigee - Mapper le champ avec la variable
  13. Ajoutez une tâche de mappage de données au concepteur pour extraire le jeton de l'étape précédente. Exécutez JSON sur les opérations sur des chaînes comme indiqué et enregistrez-les dans une variable.
    Apigee - Extraire le jeton
  14. Faites l'appel à l'API de déploiement du robot de la Control Room Automation 360.
    Ajouter une nouvelle tâche Appeler le point de terminaison Rest dans le concepteur et configurez l'URL du point de terminaison et la méthode http POST dans le volet de droite. Mettez également à jour le corps de la requête avec la bonne référence.
    Apigee - Appeler le point de terminaison Déployer
  15. Ajoutez une tâche de mappage de données pour extraire l'ID de déploiement du bot de l'étape précédente. Extrayez l'ID de déploiement, et enregistrez-le dans une variable.
    Une intégration complète se présente comme suit :
    Apigee - Extraire l'ID de déploiement