Exemple pratique d'utilisation d'AI Mapping Assist et d'AI Data Assist avec Designer d' IBM App Connect Enterprise

Les applications d' IBM® App Connect Enterprise Designer offrent des fonctionnalités d'assistance au mappage par IA et d'assistance aux données par IA, que vous pouvez utiliser lors de la création ou de la mise à jour de données. Si vous avez récupéré des éléments dans le nœud précédent du flux, vous pouvez utiliser AI Mapping Assist ou AI Data Assist pour identifier les correspondances, que vous pouvez ensuite appliquer au flux. Cette rubrique décrit un exemple d'utilisation de AI Mapping Assist et AI Data Assist.

1. Dans l' IBM App Connect Enterprise Designer, créez un flux de messages comme décrit dans les sections « Création d'un flux piloté par les événements » ou « Création d'un flux pour une API ».
   L'exemple présenté est un flux piloté par les événements, qui contient un nœud Scheduler, un nœud Coupa pour la récupération des utilisateurs et un deuxième nœud Coupa pour la création d'adresses, qui est contenu dans une boucle For each.

   
2. Configurez le nœud Scheduler. Le nœud Scheduler a deux modes de fonctionnement différents que vous pouvez sélectionner. Les modes de fonctionnement disponibles sont Intervalle de répétition et Calendrier. Pour utiliser le mode Intervalle répétitif, effectuez l'étape 2.a. Pour utiliser le mode calendrier, suivez les étapes suivantes 2.b.
   1. Pour utiliser le mode Intervalle répétitif, procédez comme suit :
      1. Sélectionner l' intervalle de répétition
      2. Entrez une valeur pour Intervalle. Par exemple, 7.
      3. Sélectionnez une valeur pour l' unité dans le menu. Par exemple, Heures, Minutes ou Secondes.
      4. Programmez les jours de la semaine pendant lesquels le flux de messages doit être exécuté, en sélectionnant ou en désélectionnant les cases à cocher correspondantes. Par exemple, vous pouvez choisir un intervalle de 7 minutes, sélectionner tous les jours sauf le mardi et ne pas sélectionner le mardi. Pour ces sélections, si un intervalle de 7 minutes se termine à 23:59 le lundi, l'intervalle suivant de 7 minutes commence à 00:00 le mercredi. Si vous ne sélectionnez pas tous les jours, le flux de messages s'exécute par défaut tous les jours. Ce comportement est identique à celui observé lorsque tous les jours sont sélectionnés.
      5. Sélectionnez un fuseau horaire dans le menu Fuseau horaire.
   2. Pour utiliser le mode Calendrier, procédez comme suit :
      1. Sélectionner le calendrier
      2. Complétez l'une des sélections suivantes en choisissant des valeurs dans les menus :
         • Exécution toutes les heures. Utilisez le menu déroulant pour sélectionner le nombre de minutes après l'heure.
         • Courir tous les jours. Utilisez les menus déroulants pour sélectionner le moment de la journée à exécuter (heure et minutes après l'heure).
         • Courir chaque semaine. Utilisez les menus déroulants pour sélectionner le jour de la semaine à exécuter et l'heure de la journée à exécuter (heure et minutes après l'heure).
         • Exécution tous les mois. Utilisez les menus déroulants pour sélectionner le jour du mois à exécuter et l'heure de la journée à exécuter (heure et minutes après l'heure).
         • Il est organisé chaque année. Utilisez les menus déroulants pour sélectionner la date à exécuter (par exemple le 1er janvier) et l'heure de la journée à exécuter (heure et minutes passées).
      3. Sélectionnez un fuseau horaire dans le menu Fuseau horaire.
3. Configurez le premier nœud Coupa. Pour plus d'informations, voir l'étape 6 de la section Création d'un flux piloté par les événements. Configurez le nœud pour l'action Récupérer les utilisateurs.
4. Dans la boucle For each, ajoutez le deuxième nœud Coupa et configurez-le comme décrit à l'étape 6 de la section Création d'un flux piloté par les événements. Configurer le nœud pour l'action Créer des adresses.
5. Configurez le Pour chaque nœud, effectuez les étapes suivantes :
   1. Cliquez sur l'icône Pour chaque pour ouvrir un panneau de configuration.
   2. Dans le panneau de configuration, sélectionnez l'onglet Input.
   3. Dans le champ Sélectionner la collection d'éléments à traiter, tapez "adresses" ou cliquez sur Insérer une correspondance et sélectionnez une correspondance dans la liste qui s'affiche.
6. Cliquez sur le nœud Coupa dans la boucle For each pour ouvrir le panneau des propriétés de la connexion.
   Le panneau des propriétés de la connexion s'ouvre. Chaque champ du panneau de propriétés de la connexion est doté d'une icône de nœud qui indique le nœud du flux contenant les mappages suggérés. Si vous avez correctement configuré Designer d' IBM App Connect Enterprise pour AI Mapping Assist et AI Data Assist, comme décrit dans la section « Configuration de Designer d' IBM App Connect Enterprise pour AI Mapping Assist et AI Data Assist », le champ « Génération de suggestions » apparaît dans le panneau des propriétés de connexion.

   

   La génération de suggestions de cartographie s'effectue automatiquement et peut prendre plusieurs secondes ou plus en fonction du nombre de suggestions générées. Vous pouvez ensuite prévisualiser les suggestions et, éventuellement, les appliquer à votre flux. Par exemple, si 12 suggestions de cartographie ont été générées, le bouton Prévisualiser 12 suggestions de cartographie est visible.

   

Si vous souhaitez utiliser AI Mapping Assist, effectuez les étapes 5 à 13 incluses. Si vous souhaitez utiliser AI Data Assist, effectuez les étapes 14 à 18 incluses.

7. Cliquez sur Aperçu des 12 suggestions de mappage pour afficher les mappages suggérés.
   Une liste de suggestions de mappage s'affiche. Pour chaque champ, si plus d'une suggestion est générée, seule la suggestion ayant le niveau de confiance le plus élevé est affichée par défaut. Vous pouvez éventuellement visualiser et sélectionner toutes les suggestions qui ont été générées pour ce champ, en complétant l'étape 8.
8. Facultatif : si vous souhaitez afficher et sélectionner toutes les suggestions générées pour un champ spécifique, suivez les étapes suivantes :
   1. Cliquez sur Annuler pour annuler l'aperçu.
   2. Cliquez sur le champ que vous souhaitez mapper pour afficher une liste de tous les mappages proposés pour ce champ.
   3. Sélectionnez la cartographie suggérée que vous souhaitez utiliser.
   Le champ est rempli avec le mappage que vous avez sélectionné.

Si vous avez sélectionné un mappage dans la liste à l'étape 8, le mappage n'est plus inclus dans l'aperçu. Le bouton qui était intitulé " Prévisualiser 12 suggestions de cartographie " est désormais intitulé " Prévisualiser 11 suggestions de cartographie ".

9. Cliquez sur Aperçu 11 suggestions de mappage.
10. Affichez la liste des suggestions de mappage et cliquez sur x pour supprimer les suggestions que vous ne souhaitez pas. Après avoir supprimé des suggestions de mappage de cette manière, elles restent dans l'aperçu et vous pouvez les réintégrer à l'étape 13.
    
11. Cliquez sur Appliquer les suggestions pour appliquer les suggestions de mappage que vous souhaitez accepter.
    
    Les suggestions de mappage que vous avez acceptées sont ajoutées à votre flux en remplissant les champs du panneau de configuration.

Si vous avez supprimé les suggestions de cartographie à l'étape 7, elles ne sont plus visibles dans la liste. Cependant, ils sont toujours disponibles dans l'aperçu et vous pouvez toujours les appliquer à votre flux. Par exemple, si vous avez supprimé 10 des 11 suggestions de mappage à l'étape 7, le bouton qui était intitulé Prévisualiser 11 suggestions de mappage est maintenant intitulé Prévisualiser 1 suggestion de mappage.

12. Facultatif : Cliquez sur Prévisualiser 1 suggestion de mappage pour afficher le mappage suggéré.
13. Facultatif : si vous souhaitez accepter le mappage suggéré, cliquez sur Appliquer les suggestions pour appliquer la suggestion de mappage à votre flux.

Si vous souhaitez utiliser AI Data Assist, effectuez les étapes 14 à 18 incluses.

14. Dans le panneau de configuration, dans le champ que vous souhaitez mapper, cliquez sur l'icône de nœud ou dans l'espace blanc.
    Un tableau s'affiche. Si vous avez cliqué sur le champ Nom du compte, le tableau s'intitule Générer une transformation pour le nom du compte.
15. Ajouter des entrées au tableau. Pour que AI Data Assist fonctionne correctement, vous devez utiliser le tableau pour fournir un minimum de 5 échantillons.
    Par exemple, si vous souhaitez un mappage qui transforme les noms complets en une première initiale et un nom de famille, fournissez des exemples similaires à ceux du tableau suivant.

    

    Vous pouvez supprimer une ligne en cliquant sur l'icône de la corbeille. Vous pouvez éventuellement fournir d'autres exemples en cliquant sur Ajouter une ligne. Il n'y a pas de limite au nombre de lignes que vous pouvez ajouter.
16. Cliquez sur Transformer le format des données.
    Le champ sélectionné est rempli avec la transformation de données générée, que vous pouvez prévisualiser.

Vous pouvez insérer la transformation de données dans votre flux ou l'annuler en terminant l'étape 17. Vous pouvez également remplir la section d'échantillons avec les données du connecteur que vous avez choisi en effectuant l'étape 18.

17. Si vous souhaitez accepter la transformation des données, cliquez sur Insérer la transformation, sinon, cliquez sur Annuler.
    

Data Assist peut remplir la section échantillon avec des données provenant du connecteur que vous avez choisi. Il doit y avoir des exemples de champs pour ces données. Dans cet exemple, le connecteur doit avoir un minimum de 5 utilisateurs avec le champ "Nom complet" Si cette condition est remplie, vous pouvez remplir le champ avec les données du connecteur en complétant l'étape 16. Sinon, vous devez remplir le champ manuellement en complétant l'étape 19.

18. Facultatif : Cliquez sur Remplir à l'aide de données d'échantillonnage.
    Le champ est alimenté par des échantillons de données provenant du connecteur que vous avez choisi.
19. Facultatif : si certains champs n'ont pas été remplis à l'aide de AI Mapping Assist ou AI Data Assist, vous devez les remplir manuellement, comme indiqué dans la section Création d'un flux piloté par les événements ou Création d'un flux pour une API.