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.
Procédure
- Sélectionnez Fichier > Nouveau > Autre > J2C.
- Sélectionnez Bean J2C puis cliquez sur Suivant.
- 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.
- Lorsque vous avez sélectionné l'adaptateur de ressources approprié, cliquez sur Suivant.
- 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.
- Dans la page des paramètres du connecteur, cliquez sur Parcourir
pour sélectionnez tous les fichiers système SAP :
- Dans la page Style de l'adaptateur, sélectionnez Entrant
et cliquez sur Activer la surveillance des événements entrants, puis
cliquez sur Suivant.
- Dans la page de configuration des événements et de JMS, vous pouvez configurer
le fournisseur JMS de la surveillance des événements.

- Dans la zone Type d'événement, sélectionnez WebSphere Business Events.
- 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.
- 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.
- Cliquez sur Avancé pour définir les
propriétés avancées :
- 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.
- Dans la zone Hôte de l'URL du fournisseur de noms,
tapez la partie hôte de l'URL de votre serveur distant.
- Dans la zone Port de l'URL du fournisseur de noms,
tapez le numéro de port de votre serveur distant.
- Dans la zone Nom d'utilisateur pour la configuration de l'authentification des connexions, indiquez votre nom d'utilisateur.
- Dans la zone Mot de passe pour la configuration de l'authentification des connexions, indiquez votre mot de passe.
- Cliquez sur Next.
- Dans la page Configuration de la découverte, indiquez les informations de connexion à votre serveur SAP :
- nom d'hôte (obligatoire) :
le nom d'hôte du serveur SAP.
- numéro de système (obligatoire) :
le numéro de système du serveur SAP.
- nom de serveur :
le nom du serveur SAP.
- numéro de port :
le numéro de port du serveur SAP.
- nom d'utilisateur (obligatoire) :
le nom d'utilisateur pour la connexion au serveur SAP.
- 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.
- Dans la page Découverte et sélection d'objets, sélectionnez Découvrir les IDoc à partir du système et cliquez sur Filtrer :
- 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 :
- Sélectionnez ORDERS05 et cliquez sur ADD :
- 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 :
- 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 :
- 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.
- 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.
- 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 :
- Vérifiez que SapInboundWBE apparaît dans la zone Nom du projet.
- Dans la zone Environnement d'exécution cible,
sélectionnez WebSphere Application Server v7.
- Sélectionnez Appartenance à un EAR et entrez
WBMSAPProjectEAR dans Nom du projet EAR.
- Acceptez les autres paramètres par défaut et cliquez sur Terminer.
- 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.

- 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.
- Sélectionnez votre projet EJB, puis pour générer et recompiler
les fichiers.
- 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 :
- Faites un clic droit sur votre bean de session.
- Sélectionnez :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.
- 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™
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.
- 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.