Activation de la surveillance des événements entrants pour WebSphere Business Events

WebSphere Business Events vous permet d'activer la surveillance dans vos applications J2C entrantes.

Avant de commencer

Important : N'installez pas plusieurs adaptateurs de ressources de manière autonome sur le même serveur d'exécution, surtout s'ils sont destinés au même type de système d'information d'entreprise (par exemple, CICS ECI 8.0.0.0 et CICS ECI 8.0.0.1). En effet, tous les adaptateurs de ressources autonomes partagent le même chargeur de classes et, par conséquent, deux adaptateurs du même type mais de versions différentes ne peuvent pas cohabiter.
Important : WebSphere Business Events version 7 fonctionne avec WebSphere Application Server 7.x. WebSphere Business Events n'est pas pris en charge dans WebSphere Application Server version 8.0. Pour plus d'informations sur WebSphere Business Events, voir le document WebSphere Business Events Information. Pour des informations sur l'installation de WebSphere Business Events, voir le document WebSphere Business Events Installation and Operations Guide. WebSphere Business Events fonctionne avec WebSphere Application Server version 7.0. Pour savoir comment désactiver le moniteur d'événements, voir Désactivation du moniteur d'événements.

Procédure

  1. Sélectionnez Fichier > Nouveau > Autre > J2C.
  2. Sélectionnez Bean J2C puis cliquez sur Suivant.
  3. Sur la page Sélection des adaptateurs de ressources, sélectionnez le type d'adaptateur de ressources IMS que vous souhaitez utiliser.

    Adaptateurs de ressources disponibles prenant en charge WebSphere Business Events :

    • JD Edwards version 6.2.0.2 et 7.0.0.0.
    • Oracle version 6.2.0.2 et 7.0.0.0.
    • PeopleSoft version 6.2.0.1.
    • SAP version 6.2.0.2 et 7.0.0.0.
    • Siebel version 6.2.0.2 et 7.0.0.0.
    Sélection de l'adaptateur de ressources
  4. Lorsque vous avez sélectionné l'adaptateur de ressources approprié, cliquez sur Suivant.
  5. Dans la zone Projet de connecteur de la page d'importation de connecteur, acceptez le nom proposé par défaut ou tapez un autre nom pour votre projet. Dans la zone Serveur cible, sélectionnez WebSphere Application Serve V7 et cliquez sur Suivant.
    Page Importation de connecteur
  6. Dans la page des paramètres du connecteur, cliquez sur Parcourir pour sélectionnez tous les fichiers système SAP :
    • sapjco3.jar
    • sapjco3.dll
  7. Dans la page Style de l'adaptateur, sélectionnez Entrant et cliquez sur Activer la surveillance des événements entrants, puis cliquez sur Suivant.
    Page Style de l'adaptateur
  8. Dans la page de configuration des événements et de JMS, vous pouvez configurer le fournisseur JMS de la surveillance des événements.
    Page de configuration des événements et de JMS
    1. Dans la zone Type d'événement, sélectionnez WebSphere Business Events.
    2. Dans la zone Nom JNDI de la fabrique de connexions de rubrique, acceptez la valeur par défaut jms/wbeTopicConnectionFactory ou bien entrez le nom JNDI de votre propre fabrique de connexions.
    3. Dans la zone Nom JNDI de la rubrique, acceptez la valeur par défaut jms/WBE/CbeListener ou bien entrez le nom JNDI de votre propre rubrique.
    4. Cliquez sur Avancé pour définir les propriétés avancées :
      1. Configuration du fournisseur JNDI distant : vous permet de configurer la rubrique distante (ou la file d'attente distante pour la prise en charge de WebSphere Business Monitor).
        Remarque : Si le bus dans la cellule locale a le même nom que le bus dans une cellule distante, l'application se connecte toujours à la cellule locale. Elle n'utilise jamais les noeuds finaux de fournisseur spécifiés dans la fabrique de connexions ; les données que vous entrez à propos de la configuration de rubrique distante sont donc ignorées. Pour plus d'informations sur la configuration de rubrique distante, voir Configuration d'une connexion à un serveur d'amorçage autre que celui par défaut.
        1. Dans la zone Hôte de l'URL du fournisseur de noms, tapez la partie hôte de l'URL de votre serveur distant.
        2. Dans la zone Port de l'URL du fournisseur de noms, tapez le numéro de port de votre serveur distant.
      2. Dans la zone Nom d'utilisateur pour la configuration de l'authentification des connexions, indiquez votre nom d'utilisateur.
      3. Dans la zone Mot de passe pour la configuration de l'authentification des connexions, indiquez votre mot de passe.
  9. Cliquez sur Next.
  10. Dans la page Configuration de la découverte, indiquez les informations de connexion à votre serveur SAP :
    1. nom d'hôte (obligatoire) : le nom d'hôte du serveur SAP.
    2. numéro de système (obligatoire) : le numéro de système du serveur SAP.
    3. nom de serveur : le nom du serveur SAP.
    4. numéro de port : le numéro de port du serveur SAP.
    5. nom d'utilisateur (obligatoire) : le nom d'utilisateur pour la connexion au serveur SAP.
    6. mot de passe (obligatoire) : le mot de passe pour la connexion au serveur SAP.

      Pour définir les propriétés SAP avancées, cliquez sur Afficher les propriétés avancées.

  11. Dans la page Découverte et sélection d'objets, sélectionnez Découvrir les IDoc à partir du système et cliquez sur Filtrer :
    Page de découverte d'objets
  12. Sur la page Propriétés de filtre de 'Découvrir les IDoc à partir du système', entrez ORDER* dans la zone Masque des objets à trouver, et cliquez sur OK :
  13. Sélectionnez ORDERS05 et cliquez sur ADD :
    Ajouter un objet
  14. Dans la page des paramètres de configuration d'ORDERS05, acceptez les valeurs proposées par défaut et cliquez sur OK, puis cliquez sur Suivant :
    Page des propriétés de configuration
  15. Dans la page Configuration des propriétés composites, en regard de la zone Opérations de maintenance pour l'IDoc sélectionné, sélectionnez les actions que vous voulez effectuer sur les objets puis cliquez sur Ajouter :
    Configuration des propriétés composites
  16. Dans la page Configuration des propriétés composites, en regard de la zone IDoc values to identify selected operations, cliquez sur Sélectionner les valeurs que vous voulez utiliser, puis cliquez sur OK.
  17. Dans la zone Dossier de la page Configuration des propriétés composites, entrez le nom du dossier où stocker l'objet métier généré, puis cliquez sur Suivant.
    Remarque : Créez un dossier qui contiendra les fichiers schéma qui sont générés pour faciliter l'exportation de ces fichiers et créer le modèle de moniteur. Les fichiers sont générés dans un sous-dossier eventMonitor du dossier que vous avez spécifié. Si vous ne spécifiez pas de nom de dossier, les fichiers schéma sont générés à la racine de votre projet, sans dossier conteneur.
  18. Dans la page Création et configuration du déploiement d'un bean J2C, entrez le nom de votre projet EJB (WBMSAPProject) et cliquez sur Nouveau pour créer un projet EJB. Dans la page du projet EJB :
    1. Vérifiez que SapInboundWBE apparaît dans la zone Nom du projet.
    2. Dans la zone Environnement d'exécution cible, sélectionnez WebSphere Application Server v7.
    3. Sélectionnez Appartenance à un EAR et entrez WBMSAPProjectEAR dans Nom du projet EAR.
    4. Acceptez les autres paramètres par défaut et cliquez sur Terminer.
      Page du projet EJB
  19. Dans la page Création et configuration du déploiement d'un bean J2C, vous pouvez créer une interface locale EJB, une classe auxiliaire, un bean session et un bean géré par message, destinés à contenir vos processus entrants. Notez qu'un EJB, un bean session et un bean géré par message sont tous créés automatiquement. Dans un modèle entrant, les beans gérés par message sont conçus pour recevoir des messages d'un système EIS externe. Tous les adaptateurs de ressources doivent implémenter javax.resource.spi.ResourceAdapter, qui a cinq méthodes. Le serveur d'applications accède à ces méthodes pour gérer le cycle de vie de l'adaptateur de ressources et fournit des notifications lorsqu'un noeud final de message est déployé ou dont le déploiement est annulé. Pour recevoir un message d'un système EIS spécifique, le destinataire (bean géré par message) doit afficher son intérêt à utiliser ce message en implémentant un écouteur de message. La classe ActivationSpec représente la configuration requise par l'adaptateur de ressources pour établir la connexion entre le système EIS et un bean géré par message. Les adaptateurs de ressources utilisent la classe ActivationSpec du bean géré par message déployé pour créer et gérer une relation entre le système d'information d'entreprise et le bean géré par message à l'aide de l'adaptateur de ressources. Pour configurer la classe ActivationSpec, en regard de la zone Nom JNDI, cliquez sur Nouveau.
    Création d'un bean J2C
  20. Dans la page Nouvelle spécification d'activation J2C, entrez les informations de connexion au système SAP et cliquez sur Terminer, et, de retour à la page Création et configuration du déploiement d'un bean J2C, cliquez sur Terminer.
    Page Spécification d'activation J2C
  21. Sélectionnez votre projet EJB, puis Projet > Nettoyer pour générer et recompiler les fichiers.
  22. Les fichiers de mappage d'événements créent un lien entre les événements et les schémas d'objet métier dont a besoin WebSphere Business Event pour surveiller les événements. (Il s'agit d'une action explicite ; ces fichiers ne sont pas générés avec les autres artefacts.) Pour générer les fichiers EventBOTypeMapping.xml et EventBOTypeMapping.xsd :
    1. Faites un clic droit sur votre bean de session.
    2. Sélectionnez Source > Générer le mappage des événements :
      Générer le mappage des événements
      Les fichiers de mappage d'événements sont générés dans le même dossier que vos fichiers de schéma d'objet métier. Dans cet exemple, les fichiers sont générés dans le dossier BOFolder. Si vous modifiez ou restructurez un ou plusieurs objets métier ou méthodes, vous devez regénérer le fichier de mappage d'événements.
  23. Les artefacts suivants sont créés en même temps que cette application :
    • les fichiers de définition de schéma XML (.xsd) à utiliser pour les définitions d'événements ; ces fichiers sont situés dans le dossier eventMonitor
    • les enregistrements de données se trouvent dans le dossier ejbModule. Dans chacune des classes d'enregistrement de données, vous trouverez la définition de schéma correspondante
    • les classes Java™
      fichiers Java
      Tableau 1.
      SAPInboundEJB.java Classe d'interface
      SAPInboundEJBMSB.java Bean session
      SAPInboundEJBMDB.java Bean géré par message
      SAPInboundEJBMDBEventInterceptor.java Classe d'intercepteur d'événement
      SAPInboundEJBMDBHelper.java Classe MDBHelper
      EventBOTypeMapping.xml Mappage eventBOType
      EventBOTypeMapping.xsd Schéma eventBOType
      Le bean J2C est à l'écoute des événements entrants et il se sert de l'intercepteur pour intercepter les événements et les transmettre au serveur via une file d'attente JMS.
  24. Déployez vers un serveur WebSphere Business Events ou un serveur distant l'application de l'adaptateur contenant le bean géré par message pour qu'elle puisse être à l'écoute des événements provenant du système EIS et qu'elle publie les événements vers l'infrastructure CEI. Il vous reste à effectuer d'autres étapes sur le serveur WebSphere Business Event afin que celui-ci puisse surveiller des événements spécifiques. Le bean J2C est à l'écoute des événements entrants et il se sert de l'intercepteur pour intercepter les événements et les transmettre au serveur via une rubrique (topic) JMS. Pour des informations sur la publication d'événements vers WebSphere Business Events, voir Surveillance des événements du système EIS avec le serveur WebSphere Business Events.

Commentaires