Using WBI Adapters with WebSphere Process Choreographer

Transcription

1 IBM Software Group Using WBI Adapters with WebSphere Process Choreographer WebSphere Technical Briefing May 2005 Peter Van Sickel Consulting I/T Specialist IBM Software Services for WebSphere 2005 IBM Corporation

2 Agenda WBI Adapters Overview Adapter Development Tools Adapter Interaction Patterns with WBISF Using an Adapter in a WBISF Process Flow Runtime Configuration Adapter Monitoring Summary Where to get more information

3 IBM Software Group WBI Adapters Overview 2005 IBM Corporation

4 WebSphere Business Integration Server Foundation: Connectivity Options Web Services SOAP over HTTP, HTTPs, JMS WBI Adapters this is the focus of this presentation J2EE Connectors IBM, 3 rd party, custom JDBC EJB, CMP

5 J2C and WBI Adapters J2C 1.0 was unidirectional and synchronous only not appropriate for many integration scenarios J2C 1.5 is bidirectional, synchronous as well as asynchronous this helps a lot, but J2C 1.5 still lacks: Standard way of dealing with XML records Standard support for EIS meta-data repositories and access APIs IBM is extending the adapter framework to include J2C support Adapters are being developed using J2C 1.5

6 Adapter Components The Components of WBI Adapters Connector links an application to an integration server Application Specific Component Adapter Framework Development Tools System Manager Connector Configurator Business Object Designer Object Discovery Agent (ODA) Introspects application meta-data to generate business objects

7 What do WBI Adapters provide? Consistent framework for access to back-end systems and technologies We are not concerned with connectivity, wire protocols, application APIs, or data transformation between domains Encapsulate business functions as largegrained services Consistent configuration, deployment, and administration WBI Server Foundation IMS Lotus Domino

8 WBI Adapters Key Technical Details External to WBI Server Foundation Adapter runs anywhere, in its own JVM Bidirectional WBI Server Foundation can initiate interaction with adapter Event Notification Adapter listens on application events and notifies WBI Server Foundation For WBISF: synchronous and asynchronous interaction patterns JMS based Format in WBI Server Foundation Message defined by XSD Service defined by WSDL JMS JMS WBI Server Foundation WebSphere MQ Queue Adapter External Event Application specific connectivity

9 The Two Faces of an Adapter Adapter can exchange data with the integration server (hub) Common Adapter Framework for interacting with the integration server Adapter can exchange data with an application Technology specific logic to interface with the application Adapter Framework Application-Specific Component Integration Server Facing Enterprise Application Facing Adapter

10 Adapters and Business Objects A single adapter can process data going in both directions A single adapter can handle many types of transactions (e.g. Orders, Customer data, etc.) An adapter can use a single business object for multiple operations (e.g. Create, Update, Delete, Retrieve) An adapter is driven from meta-data in business objects Business object definitions are represented as XML Schemas Customer Integration Server Enterprise Application Order Item

11 Adapter Deployment Options Network Topology Option 1 Option 2 Client Client Client Application Platform Integration Server Client Application Platform Client Internet HTTP/S Option 3 Client Application Platform Client Client Client Application Platform In all cases, the adapter agent runs in its own JVM. Option 4 Use WBI Connect

12 WebSphere Business Integration Adapters Application Ariba Buyer Clarify CRM ematrix i2 i2 Active Data Warehouse IndusConnect Framework Maximo MEA Siebel ebusiness Applications MetaSolv Applications mysap.com NightFire Applications Oracle Applications PeopleSoft Portal Infranet QAD MFG/PRO Spirent Applications Telcordia Applications WebSphere Commerce Centricity Gateway ESRI Spatial Databases JD Edwards OneWorld Manugistics SAP Exchange Infrastructure SunGard FRONT ARENA Technology / Data Handlers COM CORBA Exchange FIX Protocol Healthcare Data Protocols iseries TCP/IP JDBC JMS JText Lotus Domino SWIFT XML Web Services WebSphere MQ WebSphere BI Message Broker WebSphere MQ Workflow Data Handler for Complex Data Data Handler for XML Data Handler for EDI ACORD XML HTTP Enterprise Java Bean Mainframe CICS IMS Transaction Manager ADABAS Adapter for VSAM DB2 Databases IMS Database Manager Natural IDMS Database

13 Value of WBI Adapters Use adapters to expedite and simplify integration of packaged and custom legacy applications that support your business Speed time to value when integrating business applications Reduce risk of integration projects Lower development costs Reuse applications in flexible solutions Broad portfolio with extensive functionality Support multiple application versions Support multiple servers Adapters Applications

14 Are WBI Adapters Services? Let s revisit our definition of a Service A well-defined business function Can be invoked from an application program Invoked through common communication protocols, providing interoperability Provides contract between service requestors and service providers Accesses business data, or facilitates a change in business data, from one valid and consistent state to another

15 IBM Software Group Adapter Development Tools 2005 IBM Corporation

16 Adapter Development Overview Create an Integration Component Library (ICL) Define the business objects Directly or use an Object Discovery Agent (very handy) Define the connector configuration Export the service definition for import into Studio IE Configure the runtime Message provider, application specific configuration Test the adapter independently

17 Products that you need Adapter Framework v2.6 Specific Adapters WebSphere MQ 5.3 CSD 05 or greater For the sample Order Fulfillment scenario: JText 5.6, JDBC 5.6, XML Data Handler 2.6 DB2 8.2.x WebSphere Studio Application Developer x

18 Our Order Fulfillment Scenario Batch Order Entry Enterprise Resource Planning (ERP) Legacy Billing System open() Customer assign() Packer submit() Open cancel() add line item() Submitted pack item() ship() Marketer [> 0] line items.sum.left [== 0] Order Entry Order Fulfillment Cancelled Completed purge()

19 WebSphere BI Adapter Tools System Manager Perspective Connector Configurator Business Object Designer

20 Connector Configurator

21 Business Object Designer

22 Object Discovery Agent

23 WSAD Integration Edition: Adapter Deployment System Manager Perspective is added to Integration Edition during WBI Adapter install Launches WBI Tools Exports WBI artifacts generated by the WBI Tools as JMS Services to the Business Integration Perspective Export

24 Development steps: review Create an Integration Component Library (ICL) Define the business objects Directly or use an Object Discovery Agent (very handy) Define the connector configuration Export the service definition for import into Studio IE Configure the runtime Message provider, application specific configuration Test the adapter independently

25 IBM Software Group Adapter Interaction Patterns with WBISF 2005 IBM Corporation

26 Adapter Runtime Interaction Patterns One-way from Integration Server (HubOneWay) Asynchronous from Integration Server to Application Integration Server Initiated Request-Response (HubRequest) Pseudo-synchronous from Integration Server to Application Application Event Notification (AgentDelivery) Asynchronous from Application to Integration Server Application-Initiated Synchronous Processing (AgentRequest) Pseudo-synchronous from Application to Integration Server Integration Server Notification One-way Requestresponse Requestresponse WebSphere BI Adapter Adapter Framework Connector Enterprise Information System

27 Integration Server Initiated: One-Way Typical Usage Scenario An order fulfillment BPEL process needs to send an invoice to a legacy billing system that uses flat file records with the fixed-width record format. Example: JText Adapter BPEL process makes an asynchronous call to the adapter The adapter writes to the flat file If there's an error in writing the file, it's placed in a fault queue

28 Integration Server Initiated: One-Way WBI Server Foundation BPEL Process 1 Queue 2 RequestQ Adapter Adapter Framework 4 3 Adapter 5 Application Create 1. BPEL process invokes a service with JMS bindings (JMSReplyTo is left blank). 2. Framework picks up the message. 3. Framework maps the message to a BO. 4. Framework calls the Adapter passing in the BO. 5. Adapter processing the BO.

29 Integration Server Initiated: Request-Response A typical usage scenario A BPEL process controlling order fulfillment needs to make create order request to an Enterprise Resource Planning (ERP) system. Needs confirmation of the create and order identifier. During processing order fulfillment BPEL needs to retrieve order information from the ERP system. The details regarding the order are managed by a packaged ERP system. Example: ERP system adapter (for any of several ERP system vendors) BPEL process calls the adapter to create the order. Adapter returns order ID. BPEL process calls the adapter to retrieve order information.

30 Hub Initiated Request-Response WBI Server Foundation BPEL Process 1 Queue RequestQ 9 8 TempReplyQ Adapter 2 3 Adapter Framework Adapter 5 Application Retrieve 1. BPEL process invokes a service with JMS bindings (JMSReplyTo is specified). 2. Framework picks up the message. 3. Framework maps the message to an action (verb) and business object (BO). 4. Framework calls the Adapter passing in the verb and the BO. 5. Adapter passes the BO to application, application returns response to Adapter. 6. The response BO is returned to the Framework. 7. Framework maps the response to an XML message. 8. Framework posts message on JMSReplyTo queue. 9. BPEL process receives response (process instance is waiting on a blocking JMS call no Message Driven Bean!).

31 Adapter Initiated One-Way A typical usage scenario An order fulfillment BPEL process needs to be notified when a batch of new orders shows up in a collection of files that get transferred to a well known directory in a file system on a specific machine. The batch order entry files are XML formatted. Example: Use a JText adapter with XML data handler Adapter monitors the directory where the files are transferred. When the files appear: The adapter notifies the WBISF server and a BPEL process is instantiated to begin the order fulfillment process.

32 Adapter Initiated One-Way WBI Server Foundation BPEL Process 6 MDB 5 Queue 4 DeliveryQ Adapter Adapter Framework 3 2 Adapter 1 Application Event 1. Adapter polls and detects event. 2. Adapter sends Business Object (BO) corresponding to the event. 3. Adapter maps BO to an XML message. 4. Adapter puts XML message on queue (JMSReplyTo is left blank). 5. MDB picks up the message. 6. MDB calls the process Session Bean

33 Adapter Initiated Request-Response A typical usage scenario Real-time pricing look-up originating from ERP application Example: ERP system adapter (for any of several ERP system vendors) ERP application makes a synchronous call to a BPEL process through a native RFC (Remote Function Call) call to the adapter BPEL process Uses an MDB to wait for requests The MDB invokes the process session EJB Retrieves the customer contract from one system Use that to retrieve the price from another system (calculated real-time with the item, quantity, lead-time and contract information) The MDB returns a synchronous response (post on a queue) to ERP application with the price via the adapter.

34 Adapter Initiated Request-Response WBI Server Foundation BPEL Process 6 MDB 7 5 Queue 4 SynchRequestQ 8 SynchResponseQ Adapter Adapter Framework 3 2 Adapter 9 10 Application 1 Event 1. Adapter polls and detects event. 2. Adapter returns BO corresponding to the event. 3. Adapter maps BO XML message. 4. Framework puts XML message on queue (no JMSReplyTo is specified, adapters response queue is used). 5. MDB picks up the message. 6. MDB calls Process Session Bean to process the message and gets a response back. 7. MDB puts response message on to SynchResponse queue for the adapter. 8. Framework picks up the XML message. 9. Framework transforms it to a BO. 10. Framework passes BO to Adapter which passes it to Application.

35 IBM Software Group Using an Adapter in a WBISF Process Flow 2005 IBM Corporation

36 Deployment: Integration Server Initiated Services Select the *.Services.wsdl file Use the Deploy Wizard to deploy one of the hub initiated operations as EJB Select Hub initiated Port name Note: in WBI terminology, Hub means WBI Server Foundation

37 Modeling: BPEL Process calls an Integration Server Initiated Service 1 2

38 Modeling: BPEL Process with Adapter Initiated Services

39 Deployment: BPEL Process with Adapter Initiated Services... This generates a new EJB port / binding / service for the interface to the process:

40 Deployment: BPEL Process with Adapter Initiated Services We have now... A Queue that gets messages of type AgentRequest from the agent A WSDL Description which describes those messages (AgentRequest) As well as the binding and the service location (port) A Process that is invoked with messages of type AgentRequest Using EJB binding and EJB port RMI/IIOP? AgentRequest Messages

41 Deployment: BPEL Process with Adapter Initiated Services Select the process Session EJB s *Services.WSDL file Generated in the previous step Use the Deploy Wizard to create an MDB On Deployment page Specify Use and existing port On Inbound Service Files page Select the adapter s *Services.wsdl generated by the WBI Tools Select the appropriate Adapter initiated Port name

42 Deployment: BPEL Process with Adapter Initiated Services Results of Generate Deploy Code In this case, we get an MDB RMI/IIOP MDB AgentRequest Messages

43 Configure EJBs/MDBs Set ListenerPort name in the generated MDBs Set JNDI References to: Queue Connection Factory Queues

44 IBM Software Group Runtime Configuration 2005 IBM Corporation

45 Create and Setup WebSphere JMS Queues Use WebSphere Admin Console (or a wsadmin script) to: Define the JNDI for of the Queues and the Queue connection Factories (Queue Manager) Configure the Listener Ports for the MDBs

46 IBM Software Group Adapter Monitoring 2005 IBM Corporation

47 Adapter Monitor Perspective Adapter Monitor allows you to: Monitor adapter s state Change adapter s state Examine fault queues Browse fault queue events Delete and resubmit events Supports adapters deployed with: WebSphere Application Server WBI Message Broker WBI Server Foundation

48 Adapters Management and Monitoring in WebSphere Business Integration Server Foundation WebSphere Business Integration Adapter Service Shows the available commands Select an adapter Press a button to issue a command Message panel shows the status

49 IBM Software Group Summary 2005 IBM Corporation

50 WBI Adapter Deployment with WebSphere Business Integration Server Foundation WebSphere BI Server Foundation Application Component EJBs / MDBs JMS Adapter Framework Application Specific Component Enterprise Application Adapter runs as separate process Adapter operations exposed by Studio-IE as JMS services described by generated WSDL Business Objects described as XML schemas Business Objects exchanged as XML messages (JMS binding) between server and adapter Message Driven Beans for event delivery Monitoring and management via Administration Console or Adapter Monitor

51 Back to our Order Fulfillment scenario Legacy Billing System Batch Order Entry Enterprise Resource Planning (ERP) Modeling, Development, Monitoring open() Customer assign() Packer submit() Open cancel() add line item() Submitted pack item() ship() Marketer [> 0] line items.sum.left [== 0] Order Entry Order Fulfillment Cancelled Completed purge() Managers, Analysts, Developers

52 Business Integration: A multi-tiered view Process Management - Business Process Business Manager View Focused on complex high-level business process flows Can have long-duration activities Likely to involve human interaction with process flows Main Process Receive Order Check Credit Verify Inventory Confirm Order Determine Shipper Mail Invoice Run Production Pack and Ship Process Management - Sub-Process Business Analyst and System Architect view Focused on detailed micro-level hybrid data & info process flows Short and moderate duration activities Blended App-to-App and B2B services Sub- Process Determine Parts Needed Check Part A Availability Check Part B Availability Reserve Inventories Data Access, Transport, Transformation, Routing Application Interaction Technical Manager view Focused on technical interactions Relatively simple sequences, transactional units of work IT & organizational infrastructure Basic Interaction Data Object Transport Transform Route Warehouse App Check for Part B at Warehouses Data Object Transport Transform Route Inventory Sourcing App Determine Least-Cost Sourcing Data Object Transport Transform Route

53 For more information WebSphere Business Integration Server Foundation WebSphere Business Integration Server Foundation InfoCenter WebSphere Studio Application Developer Integration Edition WebSphere Studio Application Developer Integration Edition InfoCenter WebSphere Business Integration Adapters WebSphere Business Integration Adapters InfoCenter IBM WebSphere Developer Technical Journal: Using WebSphere Business Integration Adapters with WebSphere Application Server Enterprise