Configuration des messages en temps réel

Messages email

Pour l'envoi d'emails, la configuration suivante est requise :

• Définissez un émetteur de message configuré pour l'email. Les émetteurs de ce type doivent être configurés avec la classe RTEMAILSNDR. Le contexte de l'émetteur est utilisé pour configurer les informations de connexion au serveur SMTP.

• Cet émetteur peut être défini comme étant l'émetteur d'email par défaut dans la table des options de message. L'émetteur de message peut également être fourni en entrée au service fonctionnel. Pour plus d'informations, voir Envoyer des emails.

Messages sortants

Pour les autres messages sortants qui sont acheminés à l'aide du répartiteur de messages sortants en temps réel, un émetteur de message définissant comment acheminer le message doit être configuré. Les points ci-dessous présentent plus en détail cette configuration.

Avant de configurer l'émetteur, déterminez le mécanisme de communication.

• Si l'acheminement se fait à l'aide de JMS, les éléments ci-dessous doivent être définis.

  • Définissez un serveur JNDI approprié qui indique où se trouvent les ressources JMS.

  • Définissez une connexion JMS afin de définir des informations supplémentaires nécessaires pour la connexion.

  • Définissez la file d'attente JMS ou le thème JMS à utiliser.

• Si la communication utilise le format JSON, déterminez la méthode à utiliser pour la conversion de XML en JSON. La méthode à choisir est fonction du mode d'envoi de la requête.

  • Avec la méthode Conversion JSON de base, si une transformation XSL doit être appliquée avant la conversion au format JSON, le schéma de requête XML cible doit être défini (à l'aide d'une zone de données) afin que la logique de conversion connaisse le format du XML qu'elle convertit. Le XSL est appliqué à la source XML du message sortant, avec pour résultat le schéma de requête XML défini, qui est alors converti en JSON. Si la transformation XSL est inutile, la source XML du message sortant est convertie en JSON.

  • Si vous choisissez la méthode Conversion JSON sans racine, l'élément de groupe mappé sur le champ source XML est retiré par la conversion, ce qui génère un document de requête JSON sans racine.

  • Si la source XML du message sortant peut être convertie en JSON à l'aide de XSL, la méthode Transformation XSL peut être choisie.

  • Vous pouvez également choisir de convertir la source XML en JSON à l'aide de la méthode Conversion API standard (avec une bibliothèque Jettison). Avec cette méthode, vous pouvez éventuellement fournir un code XSL. La conversion aura lieu sur le XML transformé.

  • Pour la réponse, si l'objet métier Message sortant définit les éléments détaillés du champ de réponse XML, le JSON doit être converti dans ce format.

    • Si la méthode de conversion est Conversion JSON de base et que la réponse JSON ne peut pas être convertie directement en éléments de réponse XML dans l'objet métier Message sortant, définissez un schéma de réponse (zone de données) représentant le résultat de la conversion JSON de base. En outre, définissez un code XSL pouvant transformer la réponse pour la faire passer du XML converti au format XML attendu dans l'objet métier.

    • Si votre méthode de conversion est Conversion JSON sans racine, le document de réponse est supposé être sans racine. L'élément de groupe mappé sur le champ de réponse XML est ajouté par le processus de conversion, ce qui génère un document de réponse XML bien formé.

    • Si la méthode de conversion est Conversion API standard ou Transformation XSL, l'API standard est utilisée pour convertir le JSON en XML. Si nécessaire, un code XSL peut être défini pour convertir la réponse en réponse XML.

  • Si l'objet métier Message sortant définit un élément brut ("raw") pour capturer la réponse, schéma de réponse et XSL ne sont pas nécessaires. Dans ce cas, le système effectue une conversion de JSON en XML à l'aide de la méthode Conversion API standard (quelle que soit la méthode de conversion définie) et le résultat est capturé dans la réponse XML.

• Pour les émetteurs HTTP, dont notamment les émetteurs JSON, le système assure la prise en charge suivante de l'envoi de messages sécurisés par une authentification OAuth :

  • Utiliser Oracle Web Services Manager (OWSM). Le système fournit un ensemble de règles préconfigurées pour OAuth (F1-OAUTH) au moyen d'une consultation avancée spéciale. Notez que les valeurs de cet ensemble de règles définissent un référentiel de clés CSF spécifique que l'implémentation doit utiliser pour capturer ses clés CSF. De plus, une valeur de substitution est définie pour l'URI jeton : @F1_​OAUTH2_​URI@. Configurez l'URI approprié pour cette implémentation selon la description de la rubrique Substitution d'URI. Par défaut, le système ne prend pas en charge la définition d'ensembles de règles supplémentaires. Si votre implémentation a besoin d'un ensemble de règles différent, contactez le support.

  • Vous pouvez fournir des paramètres liés à OAuth dans le cadre de la configuration de l'émetteur de message pour une API REST.

Définissez un émetteur de message configuré pour chaque méthode d'acheminement appropriée. Le type d'appel indiqué doit être Temps réel. Pour l'acheminement via HTTP, utilisez la classe d'émetteur RTHTTPSNDR - HTTP. Pour l'acheminement via HTTP avec application automatique du format SOAP, utilisez la classe d'émetteur SOAPSNDR - HTTP SOAP. Pour l'acheminement via HTTP avec le format JSON, utilisez la classe d'émetteur RTJSONSNDR - JSON. Pour l'acheminement via JMS, utilisez la classe d'émetteur RTJMSQSNDR - File d'attente JMS ou RTJMSTSNDR - Thème JMS et configurez la connexion JMS et la file d'attente ou le thème JMS. Utilisez le contexte de l'émetteur pour configurer les valeurs requises pour la connexion à la destination voulue.

Configurez l'ensemble système tiers / type de message sortant. La méthode de traitement définie pour le système tiers / type de message sortant doit être Temps réel.