Utilisation de IBM Sterling Intelligent Promising avec IBM App Connect Enterprise

IBM® Sterling™ Intelligent Promising est une solution autonome de services en nuage qui s'intègre de manière transparente à toute solution commerciale et fournit des informations précises sur la visibilité mondiale en temps réel.

1. Dans la boîte à outils d' IBM App Connect Enterprise, créez un flux contenant un nœud « IBM Sterling Intelligent Promising Request ».
2. Sélectionnez le nœud IBM Sterling Intelligent Promising Request dans le flux pour afficher les propriétés du nœud dans l'éditeur.
3. Dans l'onglet De base , cliquez sur Lancer la reconnaissance de connecteur.
   Un panneau s'affiche dans lequel vous spécifiez le nom du projet de règles et les détails du coffre à utiliser lors de la reconnaissance du connecteur.
4. Indiquez les détails du projet de règles et du coffre à utiliser lors de la reconnaissance de connecteur:
   1. Dans la zone Projet de règles , indiquez le projet de règles utilisé pour stocker les règles créées lors de la reconnaissance du connecteur.
      Vous pouvez également créer un nouveau projet de règles en cliquant sur Nouveau , puis en spécifiant le nom du nouveau projet de règles. Cliquez ensuite sur Terminer.
   2. Indiquez le coffre à utiliser lors de la reconnaissance de connecteur. Par défaut, les données d'identification utilisées lors de la reconnaissance de connecteur sont stockées dans un coffre de répertoire externe, qui est un coffre App Connect Enterprise pouvant être utilisé par n'importe quel serveur d'intégration. Vous pouvez également stocker les données d'identification dans un coffre de serveur d'intégration, qui est créé dans le répertoire de travail du serveur d'intégration et qui ne peut être utilisé que par ce serveur d'intégration spécifique.
      Pour spécifier le coffre à utiliser pour le stockage des données d'identification, effectuez les étapes de la section Utilisation de l'assistant de reconnaissance de connecteur de l'une des rubriques suivantes:

      • Configuration d'un coffre-fort de répertoire externe
      • Configuration d'un coffre de serveur d'intégration
   3. Dans la zone Clé de coffre , entrez la clé de coffre qui est utilisée pour accéder aux données d'identification stockées dans le coffre. La clé de coffre doit comporter au moins 8 caractères.
   4. Facultatif: Par défaut, l'emplacement de coffre et la clé de coffre spécifiés sont sauvegardés en tant que préférences dans le kit d'outils de sorte que les valeurs soient prédéfinies lorsque vous lancez la reconnaissance de connecteur. Si vous ne souhaitez pas que les préférences soient sauvegardées, désélectionnez Sauvegarder dans les préférences de coffre.
5. Cliquez sur Launch Discovery pour lancer l'assistant Connector Discovery pour le connecteur IBM Sterling Intelligent Promising.
   La fenêtre Connector Discovery s'affiche. Si des connexions (comptes) IBM Sterling Intelligent Promising (comptes) sont disponibles, une liste de ces connexions s'affiche. S'il n'y a pas de connexions existantes, l'état du connecteur est indiqué comme suit : IBM Sterling Intelligent Promising est indiqué par Not connected.
   • Si une ou plusieurs IBM Sterling Intelligent Promising connexions (comptes) sont disponibles, effectuez les étapes suivantes :
     1. Sélectionnez la connexion (compte) que vous souhaitez utiliser en cliquant dessus.
     2. Cliquez sur le type d'objet requis, puis sélectionnez l'action que vous souhaitez effectuer sur l'objet. Par exemple, pour récupérer les demandes de IBM Sterling Intelligent Promising cliquez sur Demandes, puis sur Récupérer les demandes.
   • S'il n'y a pas de connexions (comptes) existantes, procédez comme suit:
     1. Cliquez sur le type d'objet requis, puis sélectionnez l'action que vous souhaitez effectuer sur cet objet. Par exemple, pour récupérer les demandes de IBM Sterling Intelligent Promising cliquez sur Demandes, puis sur Récupérer les demandes.
     2. Cliquez sur Connexion.
        Une fenêtre s'affiche dans laquelle vous pouvez saisir les détails de connexion de votre IBM Sterling Intelligent Promising compte. Entrez les informations suivantes :

        • Identifiant du client : L'identifiant unique du client pour le IBM Sterling Intelligent Promising locataire.
        • Valeur confidentielle du client: Valeur confidentielle du client d'application pour un ID client d'application unique spécifique au titulaire.
        • ID titulaire: ID titulaire fourni par IBM pour accéder à vos API.
        
        

        Pour plus d'informations sur l'identification ou la génération de ces informations de connexion, consultez la section « Comment utiliser IBM App Connect avec IBM Sterling Intelligent Promising » dans la documentation sur la livraison continue (CD) de IBM App Connect in containers.

     3. Cliquez sur Connexion.
6. Définissez les propriétés de connecteur requises dans l'assistant.

   Pour les actions de création, vous pouvez éventuellement utiliser le mode avancé. Dans la vue d'édition par défaut d'une action, certaines applications comportent des zones qui sont masquées car elles ne sont pas nécessaires pour les cas d'utilisation générale. Pour les cas d'utilisation plus avancés, vous pouvez passer à l'édition en mode avancé, qui fournit des fonctionnalités supplémentaires pour l'édition des flux. Pour utiliser le mode avancé, quittez l'assistant de reconnaissance de connecteur en cliquant sur le X dans l'angle supérieur droit de la fenêtre, puis suivez les instructions de la rubrique Utilisation du mode avancé.

7. Lorsque vous avez fini de spécifier les propriétés dans l'assistant de reconnaissance des connecteurs, cliquez sur Sauvegarder.
   L'identifiant utilisé pour se connecter à IBM Sterling Intelligent Promising est stockée dans le coffre-fort, et les autres détails de la connexion sont enregistrés dans la politique IBM Sterling Intelligent Promising. Les valeurs des propriétés que vous définissez dans l'assistant sont renvoyées au nœud de requête « IBM Sterling Intelligent Promising » dans le Toolkit IBM App Connect Enterprise.
8. Lorsque vous avez fini de spécifier les propriétés du connecteur dans l'assistant IBM Sterling Intelligent Promising Connector, cliquez sur Save.
9. Revenir à la modification du Sterling Intelligent PromisingIBM Demande nœud dans le IBM App Connect Enterprise Boîte à outils.
   Les propriétés du connecteur qui ont été définies dans l'assistant de découverte du connecteur (à l'étape 6) sont maintenant visibles sur le nœud IBM Sterling Intelligent Promising Request dans l'éditeur de propriétés. L'onglet De base affiche les valeurs des propriétés Action et Objet que vous avez définies dans l'assistant. Par exemple, si vous avez sélectionné Demandes , puis Extraire les demandes dans l'assistant, les propriétés suivantes seront visibles dans l'onglet De base du noeud:

   • Action - RETRIEVEALL
   • Objet - Demand

   Les valeurs des propriétés Action et Objet sont affichées en lecture seule. Si vous souhaitez modifier ces valeurs, vous pouvez le faire en cliquant à nouveau sur Lancer la reconnaissance de connecteur et en définissant de nouvelles valeurs dans l'assistant de reconnaissance de connecteur.

   La propriété Schema base name spécifie le nom de base des fichiers de schéma qui décrivent le format des messages de demande et de réponse qui sont envoyés et reçus du IBM Sterling Intelligent Promising connecteur. Le nom de base du schéma est défini automatiquement lors de la première exécution de la reconnaissance pour le noeud et il est basé sur le nom de flux et le nom de noeud en cours. Si vous définissez cette propriété manuellement avant d'exécuter la reconnaissance pour la première fois, la valeur que vous définissez sera utilisée. Si vous renommez les schémas après la reconnaissance, vous devez éditer cette propriété pour qu'elle corresponde au nom de base de schéma utilisé par les schémas renommés dans le projet. Si vous modifiez cette propriété après la reconnaissance, vous devez renommer les noms de schéma pour qu'ils correspondent ou exécuter à nouveau la reconnaissance.

   En fonction de l'action sélectionnée lors de la reconnaissance, l'assistant de reconnaissance de connecteur génère un schéma de demande et un schéma de réponse, ou un schéma de réponse uniquement. Un schéma de demande est généré uniquement si l'action et l'objet sélectionnés requièrent un message de demande. Le schéma de demande généré est utilisé pour la validation du message de demande. Si l'action est RETRIEVE ou DELETE, seul le schéma de réponse est renvoyé par le connecteur.

   Les fichiers de schéma générés sont ajoutés au projet et peuvent être utilisés par un noeud Mappage pour la transformation des données d'entrée ou de sortie. Le nom de fichier complet du schéma est dérivé du nom de base du schéma (tel que gen/MyMessageFlow.IBM_Sterling_Intelligent_Promising_Request), suffixé avec response.schema.json ou request.schema.json. Vous pouvez ouvrir le schéma en cliquant sur Ouvrir le schéma de demande ou sur Ouvrir le schéma de réponse.

10. Vérifiez que les paramètres de propriété du nœud IBM Sterling Intelligent Promising Request sont corrects, puis enregistrez le flux de messages.
11. Dans l'onglet Connexion du nœud IBM Sterling Intelligent Promising Request, sélectionnez la stratégie qui contient les détails de l'identité de sécurité à utiliser pour la connexion. La règle a le type IBM Sterling Intelligent Promising et est définie dans un projet de règles. Pour plus d'informations, voir IBM Sterling Intelligent Promising policy.
12. Facultatif : Définissez la propriété Timeout dans l'onglet Connection pour spécifier le temps (en secondes) pendant lequel le nœud attend que IBM Sterling Intelligent Promising traite l'opération.
13. L'onglet Filtre du nœud IBM Sterling Intelligent Promising contient des propriétés qui contrôlent la manière dont le flux de messages sélectionne les données. Les valeurs initiales de ces propriétés sont tirées des valeurs de propriété qui ont été définies pour le connecteur dans l'assistant de découverte de connecteur IBM Sterling Intelligent Promising dans l'assistant de découverte de connecteur, y compris les propriétés des options de filtrage et toutes les conditions spécifiées (comme décrit à l'étape 6 ). Si vous revenez ensuite à l'assistant de reconnaissance des connecteurs et que vous modifiez les valeurs des propriétés, ces mises à jour sont reflétées dans les propriétés définies sur le noeud.

    Les propriétés Filter Options contrôlent les objets à utiliser lors de l'exécution du nœud IBM Sterling Intelligent Promising Request. Les propriétés Limite de filtre contrôlent le nombre maximal d'éléments à extraire et l'action à effectuer si la limite est dépassée.

    Vous pouvez modifier les valeurs en cliquant sur Editer en regard de la valeur à modifier dans la section Options de filtre et en modifiant les valeurs de propriété qui ont été définies dans la section Limite de filtre .

    Les valeurs des propriétés peuvent être des valeurs textuelles ou des expressions ESQL ou XPATH résolues à partir du contenu du message transmis au nœud de requête IBM Sterling Intelligent Promising lors de son exécution.

14. Dans l'onglet Demande, définissez la propriété Emplacement des données pour spécifier l'emplacement dans l'arborescence du message entrant qui contient les données de l'objet à créer dans l'arborescence IBM Sterling Intelligent Promising. Ces données constituent la demande envoyée au système par le nœud de demande IBM Sterling Intelligent Promising IBM Sterling Intelligent Promising système.
15. Dans l'onglet Résultat, définissez la propriété Emplacement des données de sortie pour spécifier l'emplacement dans l'arbre des messages de sortie qui doit contenir les données de l'enregistrement créé à l'adresse IBM Sterling Intelligent Promising.
16. Par défaut, les messages de demande sont validés par rapport au schéma de demande qui a été généré lors de la reconnaissance du connecteur. Vous pouvez désactiver la validation des demandes ou modifier les paramètres de validation en utilisant les propriétés de validation du nœud IBM Sterling Intelligent Promising Request.
17. Sauvegardez le flux de messages.