IBM WebSphere Sample Adapter for Enterprise Information System Simulator 7.0.0.0 Deployment and Testing on WPS 7.0 Quick Start Scenarios
Note: Before using this information and the product it supports, read the information in the Notices section, at the end of this document. This edition applies to version 7, release 0, and modification 0 of IBM WebSphere Sample Adapter for Enterprise Information System Simulator and to all subsequent releases and modifications, until otherwise indicated in new editions. Copyright International Business Machines Corporation 2008. US Government Users Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. TABLE OF CONTENTS
1.0 INTRODUCTION... 4 1.1 LEARNING OBJECTIVES... 4 1.2 AUDIENCE... 4 1.3 SOFTWARE PREREQUISITES... 4 2.0 PREPARING TO RUN THROUGH THE QSS... 5 2.1 CONFIGURATION PREREQUISITES... 5 3.0 OUTBOUND PROCESSING ON WPS 7.0... 6 3.1 CONFIGURING THE ADAPTER FOR OUTBOUND PROCESSING... 6 3.2 DEPLOYING THE MODULE TO THE TEST ENVIRONMENT... 21 3.3 TESTING THE ASSEMBLED ADAPTER APPLICATION... 24 4.0 INBOUND PROCESSING ON WPS 7.0... 29 4.1 CONFIGURING THE ADAPTER FOR INBOUND PROCESSING... 29 4.2 DEPLOYING THE MODULE TO THE TEST ENVIRONMENT... 44 4.3 TESTING THE ASSEMBLED ADAPTER APPLICATION... 46 NOTICES... 55
1.0 Introduction IBM WebSphere Sample Adapter for Enterprise Information System Simulator is a Sample Adapter used to demonstrate the IBM WebSphere Adapter Toolkit capability to customers and business partners. Using WebSphere Sample Adapter for Enterprise Information System Simulator you can simulate the basic functions of the IBM WebSphere Adapters and related Enterprise Information System. The IBM WebSphere Adapter Toolkit can reduce the effort required to build a custom adapter and configure the WebSphere Adapters to the related Enterprise Information System. 1.1 Learning Objectives After completing the tutorials, you should be able to perform the following tasks: Create adapter project in WID, and run the outbound/inbound scenarios in WID/WPS environment. 1.2 Audience The main audience for the tutorials includes: The integration developers, who design, assemble, test and deploy business integration solutions. The technical support engineer who investigate and reproduce customer issues. Broker developers/qa who test the adapter related components (for example, WPS databindings, JCA binding). 1.3 Software prerequisites To use these tutorials, you should have the following software installed: WebSphere Integration Developer, version 7.0 WebSphere Process Server, version 7.0 Rational Application Developer version 7.5 WebSphere Application Server version 6.1 or 7.0
2.0 Preparing to run through the QSS 2.1 Configuration prerequisites Before performing the tutorials, please complete the following prerequisite tasks first: 1. Download the WebSphere Sample Adapter for Enterprise Information System Simulator package file and extract the content to a temp directory. WSA_EISS.rar: The Adapter RAR file. EIS_Mocker: A SWT program which simulate the EIS behavior. 2. Configure the JRE environment. Edit the EIS_Mocker\bin\start_GUI_Tool.bat file and specify the path for JRE_HOME to the actual JRE path in your environment. NOTE: please use JRE 5.0 or above version. 3. Invoke the start_eis_mocker.bat command to verify if the configuration is correct. This starts the EIS Mocker and displays the EIS Mocker window.
3.0 Outbound processing on WPS 7.0 This tutorial demonstrates how to run the outbound scenario in WID/WPS environment. 3.1 Configuring the adapter for outbound processing Run the external service wizard to specify business objects, services, and configuration required for outbound processing. To generate the business objects and related artifacts, perform the following steps: 1. Open WebSphere Integration Developer and create a new workspace named WSA_EISS_Outbound.
2. Select File > Import, choose import source as RAR file and click Next.
3. In the Connector Import wizard, click Browse to specify the location of WSA_EISS.rar file. 4. Specify the location of WSA_EISS.rar file and click Open.
5. In the Import window, uncheck the Add project to an EAR option in the EAR Membership tab, and select the Target runtime as WebSphere Process Server 7.0. Click Finish to complete the import work.
6. In the Open Associated Perspective dialog, select No. 7. In the Business Integration perspective, select File > New > Module. 8. In the New Module window, specify the Module Name as TestOutbound, and click Finish.
9. Right click on the TestOutbound > Assembly Diagram, select New > External Service.
10. In the New External Service panel, select Adapters > Unlisted Adapter, and then click Next.
11. In the Select an Adapter panel, select WebSphere Sample Adapter for Enterprise Information System Simulator > WSA_EISS, then click Next.
12. In the Select the Processing Direction panel, select Outbound, and click Next.
13. In the Discovery Configuration panel, use Browse to specify the path of the XSD files folder, and click Next.
14. In Find Object in the Enterprise system panel, select WbiCustomerCiBG as the Selected objects, then click Next.
15. In Specify Composite Properties panel, click Next.
16. In Service Generation and Deployment Configuration panel, select Other and click Next. 17. In Specify the Location Properties panel, click Finish.
18. The VTAOutboundInterface component will be generated.
3.2 Deploying the module to the test environment 1. In EIS_Mocker directory, invoke the start_eis_mocker.bat command to start up the EIS Mocker.
2. In WebSphere Integration Developer, go to Servers tab, right-click on the WebSphere Process Server v7.0, and then select Add and Remove Projects.
3. In Add and Remove Projects panel, add TestOutboundApp project the Configured projects list. Click Finish.
3.3 Testing the assembled adapter application Test the assembled adapter application using the WebSphere Integration Developer integration test client. 1. Right-click on VTAOutboundInterface, then select Test Component.
2. Select Operation as createwbicustomercibg.
3. Populate values for input business objects. Specify the input data as per the following table: Property Name Component Interface Operation Verb Property Value VTAOutboundInterface VTAOutboundInterface createwbicustomercibg Create WbiCustomerId 100 WbiCustomerFname WbiCustomerLname Mike Smith 4. Click Continue button to execute the service.
5. In the Select Deployment Location panel, click Finish. 6. The operation will be executed successfully.
7. In EIS Mocker, the received data should be the same as what we input in WebSphere Integration Developer test client.
4.0 Inbound processing on WPS 7.0 This tutorial demonstrates how to run inbound scenario in WID/WPS environment. 4.1 Configuring the adapter for inbound processing Run the external service wizard to specify business objects, services, and configuration to be used in this tutorial. To generate the business objects and related artifacts, please perform the following steps: 1. Open WebSphere Integration Developer and create a new workspace named WSA_EISS_Inbound. 2. Select File > Import, choose import source as RAR file and click Next.
3. In the Connector Import wizard, click Browse to specify the location of WSA_EISS.rar file. 4. Specify the location of WSA_EISS.rar file and click Open. 5. In the Import window, uncheck the Add project to an EAR option in the EAR Membership tab, and select the Target runtime as WebSphere Process Server 7.0. Click Finish to complete the import work.
6. In the Open Associated Perspective dialog, select No. 7. In the Business Integration perspective, select File > New > Module. 8. In the New Module window, specify the Module Name as TestInbound, and click Finish.
9. Right click on the TestInbound > Assembly Diagram, select New > External Service. 10. In the External Service panel, select Adapters > Unlisted Adapter, and then click Next.
11. In the Select an Adapter panel, select WebSphere Sample Adapter for Enterprise Information System Simulator > WSA_EISS, then click Next.
12. In the Processing Direction panel, select Outbound, and click Next.
13. In the Discovery Configuration panel, use Browse to specify the path of the XSD files folder and click Next.
14. In Object Discovery and Selection panel, select WbiCustomerCiBG as the Selected objects, then click Next.
15. In Configure Composite Properties panel, click Next.
16. In Service Generation and Deployment Configuration panel, uncheck Specify a Java Authentication and Authorization Services (JAAS) alias security credential and click Next.
17. In Service Location Properties panel, click Finish.
18. The VTAInboundInterface component will be generated. 19. Drag the VTAInboundInterface interface to Assembly Diagram. In the Component Creation dialog, click OK.
20. Wire the VTAInboundInterface and Component1 components, and then double-click on the Component1 component. In the Open dialog, click Yes. 21. In the Implement As panel, select Java and click OK.
22. In Generate Implementation panel, click OK. 23. Select File > Save to save the changes.
4.2 Deploying the module to the test environment After running the external service wizard, you will have an SCA module that contains an EIS import or export. You must install this SCA module in the WebSphere Integration Developer integration test client. 1. Add the SCA module to the server using the server panel in WebSphere Integration Developer. In the Servers tab, right-click on the WebSphere Process Server v7.0, and select Add and remove projects.
2. Add the SCA module to the server. In the Add and Remove projects panel, use Add button to add TestInboundApp project into the Configured projects list and then click Finish.
4.3 Testing the assembled adapter application Test the assembled adapter application using the WebSphere Integration Developer integration test client and WebSphere Sample Adapter for Enterprise Information System Simulator: 1. Attach the integration test client to the EIS export. a) In WebSphere Integration Developer, right-click on project TestInbound, select Test > Attach.
b) Switch to Configurations tab, click Add button.
c) Select the Component and Reference Emulator click Add, and click Next.
d) Select Module TestInbound, click Next. e) Select Components, and then select the check box of Component1. Click Finish.
f) Switch back to Events tab, click Continue.
g) In the Select Deployment Location panel, click Finish.
2. Send event data in EIS Mocker. a) Invoke start_eis_mocker.bat command to start up EIS Mocker. b) Select WbiCustomerCiBG in the Business Object combo box, and then click Create.
c) Populate values for input business objects. Specify the input data as the following table. Property Name Property Value Operations Create WbiCustomerId 100 WbiCustomerFname Mike WbiCustomerLname Smith d) Click the Send ( ) button to send out the event data. 3. Check the values in the object published to the WebSphere Integration Developer integration test client.
Notices This information was developed for products and services offered in the U.S.A. IBM may not offer the products, services, or features discussed in this document in other countries. Consult your local IBM representative for information on the products and services currently available in your area. Any reference to an IBM product, program, or service is not intended to state or imply that only that IBM product, program, or service may be used. Any functionally equivalent product, program, or service that does not infringe any IBM intellectual property right may be used instead. However, it is the user's responsibility to evaluate and verify the operation of any non-ibm product, program, or service. IBM may have patents or pending patent applications covering subject matter described in this document. The furnishing of this document does not grant you any license to these patents. You can send license inquiries, in writing, to: IBM Director of Licensing IBM Corporation North Castle Drive Armonk, NY 10504-1785 U.S.A. For license inquiries regarding double-byte (DBCS) information, contact the IBM Intellectual Property Department in your country or send inquiries, in writing, to: IBM World Trade Asia Corporation Licensing 2-31 Roppongi 3-chome, Minato-ku Tokyo 106-0032, Japan The following paragraph does not apply to the United Kingdom or any other country where such provisions are inconsistent with local law: INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some states do not allow disclaimer of express or implied warranties in certain transactions, therefore, this statement may not apply to you.
This information could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein; these changes will be incorporated in new editions of the publication. IBM may make improvements and/or changes in the product(s) and/or the program(s) described in this publication at any time without notice. Any references in this information to non-ibm Web sites are provided for convenience only and do not in any manner serve as an endorsement of those Web sites. The materials at those Web sites are not part of the materials for this IBM product and use of those Web sites is at your own risk. IBM may use or distribute any of the information you supply in any way it believes appropriate without incurring any obligation to you. Licensees of this program who wish to have information about it for the purpose of enabling: (i) the exchange of information between independently created programs and other programs (including this one) and (ii) the mutual use of the information which has been exchanged, should contact: IBM Corporation Department 2Z4A/SOM1 294 Route 100 Somers, NY 10589-0100 U.S.A. Information concerning non-ibm products was obtained from the suppliers of those products, their published announcements or other publicly available sources. IBM has not tested those products and cannot confirm the accuracy of performance, compatibility or any other claims related to non- IBM products. Questions on the capabilities of non-ibm products should be addressed to the suppliers of those products. This information contains examples of data and reports used in daily business operations. To illustrate them as completely as possible, the examples include the names of individuals, companies, brands, and products. All of these names are fictitious and any similarity to the names and addresses used by an actual business enterprise is entirely coincidental. COPYRIGHT LICENSE: This information contains sample application programs in source language, which illustrate programming techniques on various operating platforms. You may copy, modify, and distribute these sample programs in any form without payment to IBM, for the purposes of developing, using, marketing or distributing application programs conforming to the application programming interface for the operating platform for which the sample programs are written. These examples have not been thoroughly tested under all conditions. IBM, therefore, cannot guarantee or imply reliability, serviceability, or function of these programs. If you are viewing this information softcopy, the photographs and color illustrations may not appear.
Programming interface information Programming interface information, if provided, is intended to help you create application software using this program. General-use programming interfaces allow you to write application software that obtains the services of this program's tools. However, this information may also contain diagnosis, modification, and tuning information. Diagnosis, modification and tuning information is provided to help you debug your application software. Warning: Do not use this diagnosis, modification, and tuning information as a programming interface because it is subject to change. Trademarks IBM, the IBM logo, and ibm.com are trademarks or registered trademarks of International Business Machines Corporation in the United States, other countries, or both. These and other IBM trademarked terms are marked on their first occurrence in this information with the appropriate symbol ( or ), indicating US registered or common law trademarks owned by IBM at the time this information was published. Such trademarks may also be registered or common law trademarks in other countries. A complete and current list of IBM trademarks is available on the Web at http://www.ibm.com/legal/copytrade.shtml Linux is a registered trademark of Linus Torvalds in the United States, other countries, or both. Microsoft and Screens are trademarks of Microsoft Corporation in the United States, other countries, or both. Java and all Java based trademarks and logos are trademarks of Sun Microsystems, Inc. in the United States, other countries, or both.* UNIX is a registered trademark of The Open Group in the United States and other countries. Other company, product, or service names may be trademarks or service marks of others. This product includes software developed by the Eclipse Project (http://www.eclipse.org).