L'utilisation App Connect intégrations dans webMethods Integration

Scénario

Le propriétaire d'un café suit l'arrivée de ses clients en saisissant leurs plaques d'immatriculation et en les associant à des profils d'utilisateurs. Lorsqu'un client se rend au magasin, son profil est récupéré et un outil d'analyse de l'IA analyse ses préférences passées. Sur la base des données antérieures, l'outil d'IA génère des suggestions de menu personnalisées.

Lorsque le client arrive, le propriétaire du café lui fait des suggestions, ce qui améliore son expérience, le fidélise et augmente ses ventes.

Avant de commencer

• Vous devez disposer d'un accès administrateur pour effectuer les étapes de ce tutoriel.
• Ce tutoriel suppose que vous avez une connaissance de base des langages de programmation App Connect et webMethods Integration de base.
• Vous avez besoin d'une instance active de webMethods Hybrid Integration avec les éléments App Connect et webMethods Integration activées.
• Vous devez disposer d'une installation locale de IBM App Connect Enterprise version du logiciel 13.0.3.1 ou ultérieure. Vous pouvez télécharger IBM App Connect Enterprise Evaluation Edition et l'installer localement.
• Téléchargez le fichier ace_runtime_tutorial.zip et extrayez le contenu, qui comprend les fichiers suivants utilisés dans ce tutoriel.
  • Number_plate_lookup.bar contient un flux appelable qui convertit les plaques d'enregistrement des clients en détails sur les clients tels que le numéro de client, l'adresse électronique et d'autres attributs.
  • Coffee_AI.bar contient un flux appelable qui accepte un numéro de client et renvoie des recommandations personnalisées en matière de nourriture et de boisson.
  • coffee_shop_pi.zip est une archive d'échange de projets qui contient le code source complet de toutes les intégrations référencées dans ce tutoriel.

A propos de ce tutoriel

Dans ce tutoriel, vous créez un runtime hébergé par l' IBM dans App Connect et un runtime distant (serveur d'intégration) dans App Connect Enterprise. Vous déployez une intégration sur le runtime hébergé par IBM et l'autre intégration sur le runtime distant, que vous enregistrez avec webMethods Hybrid Integration. Vous ajoutez ensuite les intégrations déployées en tant que flux appelables à un webMethods Integration workflow et configurez la logique pour mapper les profils utilisateur aux plaques d'immatriculation.

Création d'un runtime hébergé par l' IBM

1. Se connecter à webMethods Hybrid Integration.
2. Ouvrez le menu principal et sélectionnez App Connect.
3. Dans le volet de navigation App Connect dans le volet de navigation, cliquez sur Manage .
4. Dans la page Gérer, cliquez sur Fichiers BAR, puis sur Importer un fichier BAR.
5. Cliquez sur Emplacement de déploiement par défaut pour ouvrir la boîte de dialogue Importer un fichier BAR pour l'instance locale App Connect locale.
6. Faites glisser ou sélectionnez le fichier Number_plate_lookup.bar à partir de votre système de fichiers local, puis cliquez sur Importer. Le fichier BAR est importé et répertorié sur la page des fichiers BAR.
7. Ouvrez le menu pour le fichier BAR importé et cliquez sur Deploy.
8. Sur la page Déployer l'intégration, cliquez sur Créer une exécution.
9. Sur la page Créer un moteur d'exécution, définissez le nom du moteur d'exécution sur customer-ir.
10. Réglez les répliques sur Single pour économiser les ressources.
11. Cliquez sur Créer. La durée d'exécution est créée et sélectionnée sur la page Sélectionner une durée d'exécution.
12. Cliquez sur Suivant.
13. Sur la page Ajouter des configurations, sélectionnez default-switch-server-privatenetworkagent et conservez les autres sélections par défaut. Ces configurations permettent aux autres runtimes de votre webMethods Hybrid Integration d'appeler les flux appelables qui sont déployés dans cette instance.
14. Cliquez sur Suivant.
15. Consultez le résumé, puis cliquez sur Déployer.
    Pour mettre à jour l'état du déploiement, fermez le message de notification et actualisez la session du navigateur. Une fois le déploiement terminé, le nom du runtime s'affiche dans la vignette d'intégration de l'onglet Intégrations de la page Gérer. La première partie de l'intégration de votre café fonctionne désormais sur le runtime hébergé par IBM associé à votre webMethods Hybrid Integration instance.

    

Création d'un runtime auto-hébergé

Les étapes suivantes décrivent comment créer un serveur d'intégration App Connect Enterprise à utiliser en tant qu'exécution à distance. L'exécution à distance est ensuite enregistrée auprès de webMethods Hybrid Integration en utilisant un serveur de commutation.

1. Créez un serveur d'intégration App Connect Enterprise d'intégration autonome à utiliser comme moteur d'exécution distant.
   1. Ouvrez l'environnement de App Connect Enterprise l'environnement de commande de votre système d'exploitation.

      Sous Windows, ouvrez le menu Démarrer et cliquez sur IBM App Connect Enterprise Console 13.0.x.x.

      Sur Linux®, localisez et sourcez le script mqsiprofile dans le répertoire où vous avez installé App Connect Enterprise (source install_dir/server/bin/mqsiprofile).

   2. Exécutez la commande mqsicreateworkdir et indiquez le chemin d'accès complet au répertoire que vous souhaitez utiliser comme répertoire de travail du serveur d'intégration, comme indiqué dans l'exemple suivant.

      mqsicreateworkdir c:\intServerName

      Pour plus d'informations, consultez la commande mqsicreateworkdir dans la App Connect Enterprise documentation.

      :NONE.successful command completionindique que le serveur d'intégration App Connect Enterprise est créé.

2. Configurer l'exécution à distance pour qu'elle soit disponible dans webMethods Hybrid Integration.
   1. Allez jusqu'au bout de votre App Connect capacité dans webMethods Hybrid Integration.
   2. Dans le volet App Connect de navigation, développez Connect , puis cliquez sur Réseaux privés.
   3. Sur la page Connexions réseau privé, cliquez sur Créer pour créer un agent réseau privé.
   4. Modifiez le nom par défaut en pr-agent et cliquez sur Créer.
   5. Ouvrez le menu Actions du nouvel agent de réseau privé et cliquez sur Afficher les instructions de configuration.
   6. Dans l'onglet Administration à distance, développez l'étape 2 et cliquez sur Télécharger la configuration. Le fichier switchclient.json est enregistré dans votre emplacement de téléchargement par défaut.
   7. Déplacez le fichier switchclient.json téléchargé dans le dossier config/switch du répertoire de travail de votre serveur d'intégration App Connect Enterprise serveur d'intégration. Si le dossier switch n'existe pas, créez-le.
   8. Dans la console App Connect Enterprise exécuter la commande IntegrationServer pour démarrer le serveur d'intégration App Connect Enterprise serveur d'intégration.

      IntegrationServer --work-dir <workDirLocation> --name <uniqueName>

      Remplacez <workDirLocation> par l'emplacement du répertoire de travail que vous avez spécifié à l'étape 1, et remplacez uniqueName par on-premise-ir.

   9. Vérifiez dans la console App Connect Enterprise pour trouver des messages indiquant que le serveur d'intégration s'est connecté au serveur de commutation en webMethods Hybrid Integration comme le montre l'exemple suivant.

      2025-06-19 14:42:26.374542: IBM App Connect Enterprise administration security is inactive.
      2025-06-19 14:42:26.389164: The HTTP Listener has started listening on port '76XX' for 'RestAdmin https' connections.
      2025-06-19 14:42:26.726828: The connection agent for remote administration successfully registered using App Connect agent identifier 'b8c15821-64XX-4XXX-84e5-475f52dXXXXX'.
      2025-06-19 14:42:26.727092: Integration server has finished initialization.

      Vous avez maintenant un App Connect Enterprise qui s'exécute localement et qui est enregistré auprès du webMethods Hybrid Integration switch server.

3. Dans votre webMethods Hybrid Integration instance, ouvrez le menu principal et cliquez sur Gestion de l'exécution de l'intégration.

   Vous pouvez voir que le runtime hébergé par IBM est déjà visible, mais que le runtime App Connect Enterprise distant que vous venez de configurer n'apparaît pas encore dans la liste. Vous pouvez également voir certains webMethods Integration temps d'exécution si cette fonctionnalité est ajoutée.

4. Ajouter l'exécution à distance.
   1. Sur la page Gestion du runtime d'intégration, cliquez sur Enregistrer le runtime > Runtimes d' App Connect.
   2. Sur la page Register runtime, sélectionnez switch-deployment-location et cliquez sur Next.

      Cet emplacement de déploiement est déjà enregistré auprès du moteur d'exécution distant par le biais de la connexion au réseau privé.

   3. Sélectionnez le runtime on-premise-ir et cliquez sur Add Runtime. Le runtime est ajouté et s'affiche sous forme de carte sur la page de gestion des runtimes d'intégration.

   Vous disposez désormais d'un runtime auto-hébergé et d'un runtime hébergé par IBM, tous deux activés pour les flux appelables.

5. Déployez le Coffee_AI.bar fichier sur le runtime on-premise-ir auto-hébergé.
   1. Sur la page de gestion du runtime d'intégration, cliquez sur on-premise-ir.
   2. Cliquez sur Deploy BAR. Le fichier Coffee_AI.bar est déployé dans le système d'exécution distant.

Construire une logique d'intégration avec webMethods Integration

1. Allez jusqu'au bout de votre webMethods Integration capacité dans webMethods Hybrid Integration. La page Projets s'affiche.
2. Ajouter un projet.
   1. Cliquez sur Ajouter un projet.
   2. Dans la boîte de dialogue Nouveau projet, saisissez le nom Coffee shop.
   3. Conservez les autres valeurs par défaut et cliquez sur Créer. Le projet Coffee Shop est créé.
3. Ajouter des flux appelables.
   1. Cliquez sur l'onglet Flux appelables.
   2. Dans l'onglet Flux appelables, cliquez sur Ajouter des flux. Dans la boîte de dialogue Ajouter des flux appelables, vous pouvez voir les deux flux appelables qui ont été déployés. L'un se trouve dans le runtime hébergé par l' IBM, et l'autre dans le runtime auto-hébergé.
   3. Cliquez sur Ajouter pour ajouter les flux appelables au projet. Les flux appelables sont désormais disponibles dans l'éditeur de flux de travail.
4. Création d'un flux de travaux.
   1. Cliquez sur Intégrations > Flux de travail.
   2. Cliquez sur Ajouter.
   3. Sur la page Commencer à construire votre workflow, cliquez sur Créer un nouveau workflow. Le canevas du flux de travail s'affiche avec les actions Démarrer et Arrêter.
   4. Cliquez sur l'icône Modifier du nom du flux de travail pour renommer le flux de travail.
   5. Dans la boîte de dialogue Modifier le nom du flux de travail, saisissez un nom pour le flux de travail, par exemple Recommendations.
   6. Cliquez sur Done.
5. Créez un déclencheur pour lancer le flux de travail.
   1. Double-cliquez sur la première action, Démarrer, dans le canevas du flux de travail.
   2. Cliquez sur l'icône Paramètres.
   3. Dans la boîte de dialogue Déclencheur, sélectionnez webhook dans la liste des déclencheurs, puis cliquez sur Suivant.
   4. Dans la section Body de la boîte de dialogue Webhook, ajoutez la commande JSON suivante, puis cliquez sur Next.

      { "plate": "HF17QQQ"}

   5. Dans la liste Authentification Webhook, sélectionnez none.
   6. Cliquez sur Suivant et vérifiez la configuration de votre webhook.
   7. Cliquez sur Terminé pour terminer la configuration du webhook.
6. Configurer la logique de mise en correspondance des profils d'utilisateurs avec les plaques d'immatriculation des véhicules.
   1. Dans le panneau Connecteurs, cliquez sur Services. Tous les App Connect tous les connecteurs sont répertoriés.
   2. Faites glisser le connecteur Number_plate_callable_flow sur le canevas. Le connecteur est automatiquement connecté à l'action Start.
   3. Double-cliquez sur l'étape Number_plate_callable_flow pour commencer à la configurer.
   4. Dans la boîte de dialogue Number_plate_callable_flow settings, cliquez sur Next.
   5. Sur la page Mapping, mappez le champ de plaque des données du webhook entrant avec le champ de plaque dans la requête de l'appel API REST.
   6. Cliquez sur Suivant.
   7. Sur la page Tester cette action, cliquez sur Tester. Le test exécute l'appel REST et montre que les données de la réponse sont renvoyées.
   8. Cliquez sur Done.
7. Configurer la logique de génération des suggestions.
   1. Faites glisser le connecteur coffee_suggester sur le canevas. Il est automatiquement connecté à l'étape précédente du flux de travail.
   2. Double-cliquez sur le connecteur coffee_suggester pour le configurer.
   3. Dans la boîte de dialogue Paramètres, cliquez sur Suivant.
   4. Sur la page Mapping, mappez le champ customerNumber du flux Number_plate_callable_flow au champ customerNumber du flux appelable coffee_suggester.
   5. Cliquez sur Suivant.
   6. Sur la page Tester cette action, cliquez sur Tester. Le test renvoie une structure de données contenant la suggestion.
   7. Cliquez sur Done.
8. Configurez un courriel pour recevoir les recommandations.
   1. Faites glisser le connecteur Envoyer un courriel sur le canevas. Il est automatiquement connecté à l'étape précédente du flux de travail.
   2. Double-cliquez sur l'étape du courrier électronique pour lancer la configuration.
   3. Dans le champ À, indiquez une adresse électronique.
   4. Cliquez sur Suivant et mappez le nom de l'aliment des données entrantes au champ " body" du connecteur " Send an Email".
   5. Cliquez sur Suivant.
   6. Sur la page Tester cette action, cliquez sur Tester. Le test renvoie une structure de données contenant la suggestion.
   7. Cliquez sur Done.
9. Enregistrez le flux de travail terminé.
10. Dans le canevas du flux de travail, cliquez sur Exécuter. Vous pouvez voir que chaque étape s'exécute et que vous recevez un courriel avec les recommandations.

Ce que vous avez appris dans ce tutoriel

Vous avez développé une intégration qui permet au propriétaire d'un café de suivre et d'analyser le comportement des clients et d'offrir des recommandations de menu personnalisées en utilisant l'analyse de l'IA. Dans le cadre de ce processus, vous avez créé des flux de travail dans webMethods Integration en utilisant App Connect intégrations. Vous avez également enregistré App Connect Enterprise pour la gestion des runtimes d'intégration afin que vous puissiez contrôler toutes vos intégrations à partir d'un plan de contrôle centralisé.