IBM WebSphere Adapter for JD Edwards EnterpriseOne Quick Start ...

IBM WebSphere Adapter for JD Edwards 

EnterpriseOne Quick Start Scenario V 7.0 

October 14, 2008 - - 1 - -

Note: Before using this information and the product it supports, read the 

information in "Notices" on page 107. 

This edition applies to version 7, release 0, modification 0 of IBM WebSphere 

Adapter for JDE and to all subsequent releases and modifications until 

otherwise indicated in new editions. 

© Copyright International Business Machines Corporation 2009. US 

Government Users Restricted Rights – Use, duplication or disclosure 

restricted by GSA ADP Schedule Contract with IBM Corp. 

October 14, 2008 - - 2 - -

Table of Contents 

Chapter 1. Introduction ................................................................... - 6 - 

Learning Objectives................................................................................................................. - 6 - 

Audience ................................................................................................................................. - 6 - 

Software prerequisites............................................................................................................. - 6 - 

Chapter 2. Preparing to run through the tutorial .......................... - 8 - 

Configuration prerequisites ..................................................................................................... - 8 - 

Extracting the sample files .................................................................................................... - 10 - 

Chapter 3. Tutorial 1: Retrieve data from JD Edwards 

EnterpriseOne AddressBook using a business function (outbound 

processing) - 16 - 

Scenario ................................................................................................................................ - 16 - 

Configuring the adapter for outbound processing................................................................. - 17 - 

Creating the project ......................................................................................................- 17 - 

Adding external software dependencies ......................................................................- 19 - 

Select direction of adapter processing .........................................................................- 21 - 

Setting connection properties for the external service wizard......................................- 21 - 

Selecting the business objects and services to be used with the adapter ...................- 21 - 

Generating business object definitions and related artifacts........................................- 27 - 

Deploying the module to the test environment...................................................................... - 36 - 

Testing the assembled adapter application .......................................................................... - 37 - 

Clearing the sample content ................................................................................................. - 38 - 

Chapter 4. Tutorial 2: Retrieving data from JD Edwards 

EnterpriseOne table using XML List query (outbound processing)..... - 40 - 

Scenario ................................................................................................................................ - 40 - 




Setting properties for the external service wizard ........................................................- 45 - 



October 14, 2008 - - 3 - -




Chapter 5. Tutorial 3: Invoking JD Edwards EnterpriseOne 

AddressBook using a business function (outbound processing) in 

multiple times - 61 - 

Scenario ................................................................................................................................ - 61 - 











Chapter 6. Tutorial 4: Polling JD Edwards EnterpriseOne Real-time 

event from JD Edwards transaction server (inbound processing) ...... - 86 - 

Scenario ................................................................................................................................ - 86 - 

Configuring the adapter for inbound processing ................................................................... - 87 - 







Configure the data source EP_DataSource with JNDI EP_DataSource_JNDI in ..............- 105 - 

Deploying the module to the test environment....................................................................- 107 - 

Testing the assembled adapter application ........................................................................- 108 - 

Clearing the sample content ...............................................................................................- 110 - 

Chapter 7. Troubleshooting........................................................ - 111 - 

Notices..................................................................................................... - 114 - 

October 14, 2008 - - 4 - -

October 14, 2008 - - 5 - -

Chapter 1. Introduction 

The WebSphere Adapter for JD Edwards EnterpriseOne 7.0 exchanges 

information with EnterpriseOne application via two types of JDE outbound 

calls - Business Function calls and XML List calls and one type of JDE inbound 

mechanism – Real-time Event. 

To gain practical knowledge in setting up and deploying the adapter, complete 

one or more of the tutorials. Everything you need to complete each tutorial is 

contained in the tutorial. If you have performed the prerequisite tasks, you 

can complete each tutorial in under an hour. 

Learning Objectives 

After completing a tutorial, you should be able to perform the following tasks: 

Audience 

• Create an adapter project in WebSphere Integration Developer. 

• Discover services and associated business objects from the enterprise 

information system (EIS) and make them part of the adapter project. 

• Create a deployable module that you install on WebSphere Process 

Server or WebSphere Enterprise Service Bus. 

• Test the module and validate the results. 

These tutorials are for integration developers who design, assemble, test, and 

deploy business integration solutions. 

Software prerequisites 

To use these tutorials, you must have the following applications installed: 

• WebSphere Integration Developer version 7.0 

• WebShpere Process Server version 7.0 

• JD Edwards Enterprise Tools 

October 14, 2008 - - 6 - -

October 14, 2008 - - 7 - -

Chapter 2. Preparing to run through the 

tutorial 

Configuration prerequisites 

Before doing any tutorial testing, complete the following tasks: 

The adapter requires the following libraries which are supplied by Oracle 

except the JDBC drivers for the database. They should be copied to a folder 

on the system where the JD Edwards EnterpriseOne EMD will be executed. 

If you want to try the JDE adapter inbound scenario (tutorial4), configure the 

Real-time event RTCOOUT in your JDE server as you will use the Real-time 

event RTCOOUT in tutorial4. 

8.9 (SP1,SP2), 8.93 8.94 8.95,8.96 8.97,8.98 

kernel.jar kernel.jar Connector.jar ApplicationAPIs_JAR.j 

ar 

connector.jar Connector.jar JdbjBase_JAR.jar ApplicationLogic_JAR. 

jar 

database.jar database.jar JdbjInterfaces_JAR.jar Base_JAR.jar 

log4j.jar log4j.jar JdeNet_JAR.jar BizLogicContainerClie 

nt_JAR.jar 

xerces.jar xerces.jar Spec_JAR.jar BizLogicContainer_JA 

R.jar 

xalan.jar xalan.jar System_JAR.jar BusinessLogicService 

s_JAR.jar 

jdeinterop.ini jdeutil.jar Base_JAR.jar castor.jar 

jdeLog.properties jdbj.ini log4j.jar commons-httpclient- 

3.0.jar 

October 14, 2008 - - 8 - -

JDBC driver jdeinterop.ini xerces.jar commons-logging.jar 

jdelog.properties xalan.jar Connector.jar 

EventProcessor_ 

EJB.jar 

JDBC driver BizLogicContainer_JAR 

.jar 

PMApi_JAR.jar EventProcessor_EJB.j 

ar 

BizLogicContainerClien 

t_JAR.jar 

ApplicationAPIs_JAR.ja 

r 

ApplicationLogic_JAR.j 

ar 

EventProcessor_JAR.j 

ar 

Generator_JAR.jar 

jdbj.ini 

JdbjBase_JAR.jar 

jdeinterop.ini JdbjInterfaces_JAR.jar 

jdbj.ini jdeinterop.ini 

jdelog.properties jdelog.properties 

castor.jar JdeNet_JAR.jar 

EventProcessor_JA 

R.jar 

EventProcessor_EJ 

B.jar 

October 14, 2008 - - 9 - - 

jmxremote.jar 

jmxremote_optiona 

l.jar 

JDBC driver jmxri.jar 

log4j.jar 

ManagementAgent_J 

AR.jar 

Metadata.jar 

MetadataInterface.jar 

PMApi_JAR.jar 

Spec_JAR.jar 

SystemInterfaces_JA 

R.jar

Extracting the sample files 

System_JAR.jar 

xalan.jar 

xerces.jar 

xmlparserv2.jar 

JDBC driver 

Replicas of the artifacts that you create when using the external service 

wizard are provided as sample files for your reference. Use these files to 

verify that the files you create with the external service wizard are correct. 

Go to the “\ ResourceAdapters\JDE_7.0\samples\referencefiles” folder 

and unzip Tutorial1.zip/Tutorial2.zip/Tutorial3.zip/Turorial4.zip into a 

directory of your choice (you may want to create a new directory). 

Tutorial1.zip 

File name Description 

BusinessFunctionSample/ 

JDEOutboundInterface.import 


JDEOutboundInterface.importex 


GetEffectiveAddress.xsd 


GetEffectiveAddressContainer.x 

sd 


GetEffectiveAddressContainerB 

G.xsd 

October 14, 2008 - - 10 - - 

Contains the SCA 

import for the resource 

adapter. 

Contain the information 

for iterative 

development 

Business Object 

definition for the 

GetEffectiveAddress 

business function. 



business object 

container. 



business object graph.

Tutorial2.zip 


JDEOutboundInterface.wsdl 

BusinessFunctionSample / 

InvalidRequestFault.xsd 


MatchesExceededLimitFault.xsd 


MissingDataFault.xsd 


PrimaryKeyPairType.xsd 


RecordNotFoundFault.xsd 


WBIFault.xsd 

Service interface to 

invoke the resource 

adapter. 

Fault Schema 

Fault Schema 

Fault Schema 

Fault Schema 

Fault Schema 

Fault Schema 


XMLListSample/ 



JDEOutboundInterface.importex 




F0116.xsd 


F0116Container.xsd 

October 14, 2008 - - 11 - - 



adapter. 



development 



adapter. 


definition for the F0116 

table 




container

Tutorial3.zip 


F0116ContainerBG.xsd 


F0116Query1.xsd 


F0116Query1BG.xsd 












WBIFault.xsd 



business object graph. 


definition for the query 

on F0116 table 




Fault Schema 

Fault Schema 

Fault Schema 

Fault Schema 

Fault Schema 

Fault Schema 


BSFNMultipleExecutionSample/ 


BSFNMultipleExecutionSample/J 

DEOutboundInterface.importex 


GetEffectiveAddress.xsd 

October 14, 2008 - - 12 - - 



adapter. 



development 




business function.


GetEffectiveAddressContainer.x 

sd 


GetEffectiveAddressContainerB 

G.xsd 

Tutorial4.zip 














WBIFault.xsd 




container. 






adapter. 

Fault Schema 

Fault Schema 

Fault Schema 

Fault Schema 

Fault Schema 

Fault Schema 


Real-timeEventSample/ 

JDEInboundInterface.export 


JDEInboundInterface.exportex 


RteRtcoout.xsd 

October 14, 2008 - - 13 - - 

Contains the SCA export 

for the resource adapter. 



development. 


definition for the realtime 

event.


JDEInboundInterface.wsdl 



Real-timeEventSample / 

MatchesExceededLimitFault.xs 

d 








WBIFault.xsd 

October 14, 2008 - - 14 - - 



adapter. 

Fault Schema 

Fault Schema 

Fault Schema 

Fault Schema 

Fault Schema 

Fault Schema

October 14, 2008 - - 15 - -

Chapter 3. Tutorial 1: Retrieve data from JD 

Edwards EnterpriseOne 

AddressBook using a business 

function (outbound processing) 

Scenario 

This tutorial demonstrates how WebSphere Adapter for JD Edwards 

EnterpriseOne 7.0 uses the GetEffectiveAddress business function to retrieve 

a record from the AddressBook. 

In this scenario, an SCA calling is used to retrieve the specific business 

address. The specific business address can be retrieved y using one JDE business 

function: The specific business address can be retrieved using one of the JDE 

business functions: 


October 14, 2008 - - 16 - -

You can call an SCA using the following stepwise procedure: 

1> Send a request to the JDE server to fetch the specific business address. 

In this case, you can fetch the business address whose ID is 33937. 

2> After getting the response from JDE server, JDE adapter will convert the 

response to an SDO, which can be understood easily by the SCA 

component. In the SCA component, customer can take use of the address 

to handle his business. 

This scenario illustrates the ability of WebSphere JDE adapter to interact with JDE 

server by invoking the JDE business function. 

Configuring the adapter for outbound processing 

Run the external service wizard to specify business objects, services, and 

configuration to be used in this tutorial. 

Creating the project 

1. Switch to the Business Integration Perspective in WebSphere 

Integration Developer by choosing from the menu: Window -> Open 

Perspective -> Business Integration. 

2. Start the external service wizard by choosing: File-> New -> External 

Service. 

3. Expand Adapters and select J D Edwards, and then click Next button. 

October 14, 2008 - - 17 - -

4. From the Select an Adapter window, you can either create a new 

project or select an existing project. 

• To create a new project, perform the following steps: 

October 14, 2008 - - 18 - -

a. Select IBM WebSphere Adapter for JD Edwards 

EnterpriseOne (IBM : 7.0), as shown in the following figure. 

b. Click Next. 

c. In the Adapter Import window, either accept the default name for 

the project (CWYED_JDE) or provide another name in the 

Connector project field, select the server from the Target 

runtime list (for example, WebSphere Process Server v7.0), 

then click Next. 

• To select an existing project, perform the following steps: 

a. Expand IBM WebSphere Adapter for JD Edwards 

EnterpriseOne (IBM : 7.0). 

b. Select a project. For example, if you have an existing project 

named CWYED_JDE, you can expand IBM WebSphere Adapter 

for JD Edwards (IBM : 7.0)CWYED_JDE, then select the 

connection information you used to create the project. 

c. Click Next. 

Adding external software dependencies 

1. In the Version property, select the version of EnterpriseOne what will 

be used. Using the “Folder containing the required files” property, 

specify the folder from which to import the files required to connect to 

October 14, 2008 - - 19 - -

EnterpriseOne. Using the “JDBC Libraries” property, specify the 

required JDBC driver files. 

2. Click Next. 

October 14, 2008 - - 20 - -

Select direction of adapter processing 

Choose Outbound for invoking JDE business function. Then click Next. 

Setting connection properties for the external service wizard 

To connect to JD Edwards EnterpriseOne the following information is 

necessary: username, password, environment, and role. Provide this 

information in the next wizard page. Then click Next. 

Selecting the business objects and services to be used with the 

adapter 

Follow these steps to select the GetEffectiveAddress business object: 

1. In the Find objects in the Enterprise System screen, click the Run Query 

button. 

October 14, 2008 - - 21 - -

2. In the “Discovered objects” list, select the Business Functions node and 

expand it. Use of the Filter icon may be helpful as the list can be long. 

October 14, 2008 - - 22 - -

3. Select the CFIN node and expand it. 

October 14, 2008 - - 23 - -

4. Select the B0100033 node and expand it. 

October 14, 2008 - - 24 - -

5. Select the GetEffectiveAddress node. 

October 14, 2008 - - 25 - -

6. Click the > Add button. 

October 14, 2008 - - 26 - -

7. Use the default business object name GetEffectiveAddress and click the OK 

button. 

8. Click the NEXT>. 

Generating business object definitions and related artifacts 

Follow these steps to generate the business object definitions. 

1. In the Specify Composite Properties screen, use the default values for the 

Namespace, Relative Path, and Max Records fields. 

October 14, 2008 - - 27 - -

2. Click the Add button of the Container Business Objects name. 

October 14, 2008 - - 28 - -

3. Fill the Container business object name field with 

GetEffectiveAddressContainer. 

October 14, 2008 - - 29 - -

4. Click the Add button of the Operations to add Retrieve Operation. 

5. Click the Add button of the Business Functions, select GetEffectiveAddress , 

then click OK. 

October 14, 2008 - - 30 - -


7. On Specify the Service Generation and Deployment Configuration screen 

select Using security properties from managed connection factory and enter 

October 14, 2008 - - 31 - -

the connection information. Click next. 

October 14, 2008 - - 32 - -

8. In Specify the Service Location Properties screen, click the New button next 

to the Module field to create a new module. 

9. The New Business Integration Project screen is displayed, select Module, 


October 14, 2008 - - 33 - -

10. In the New Module screen, type BSFNSample in the Module Name field, and 

then click Finish. 

October 14, 2008 - - 34 - -

11. Click Finish. 

12. Verify the results. 

October 14, 2008 - - 35 - -

Deploying the module to the test environment 

The result of running the external service wizard is an SCA module that 

contains an EIS import or export. Install this SCA module in WebSphere 

Integration Developer integration test client. 

1. Add the module you created earlier to the server using the server panel in 

WebSphere Integration Developer. Right-click on the server, and then 

select Add and remove projects. 

October 14, 2008 - - 36 - -

2. Add the SCA module to the server. 


Testing the assembled adapter application 

Test the assembled adapter application using the WebSphere Integration 

Developer integration test client. 

1. Select the service you want, and click Test > Test Module. 

2. Populate values for input business objects. 

Populate the Mnaddressnumber attribute of the GetEffectiveAddress 

October 14, 2008 - - 37 - -

3. To execute the service, click on the continue button . 

4. Check the output of the service, and check the data in the EIS to ensure it 

matches expected values. 

Clearing the sample content 

Return the data to its original state. 

Nothing is required to clean up after this tutorial. 

October 14, 2008 - - 38 - -

October 14, 2008 - - 39 - -

Chapter 4. Tutorial 2: Retrieving data from JD 

Edwards EnterpriseOne table 

using XML List query (outbound 

processing) 

Scenario 


EnterpriseOne 7.0 uses an XML List query to retrieve a record from the 

AddressBook database. 

In this scenario, an SCA calling is used to retrieve the specific business 

address. The business addresses generally are stored in the table F0116 of the 

database of JDE server. JDE adapter can directly fetch data from JDE table by using 

XMLList function. In this case, the table which will be accessed is: 

F0116 


October 14, 2008 - - 40 - -

1> Send the request to JDE server for fetching the specific business address. 

In this case, we will fetch the business address whose ID is 33937. 


response to a SDO which can be understood easily by the SCA 

component. In the SCA component, customer can take use of the 

address. 


server by invoking the JDE XMLList. 








2. Start the JD Edwards EnterpriseOne EMD by choosing: File-> New -> 

External Service. 

October 14, 2008 - - 41 - -

3. Expand Adapters and select J D Edwards and then click Next button. 

October 14, 2008 - - 42 - -

4. Expand the “IBM WebSphere Adapter for JD Edwards EnterpriseOne 

(IBM: 7.0). Select the CWYED_JDE node and click Next. 

5. In the Version property, select the version of EnterpriseOne what will 

be used. Using the “Folder containing the required files” property, 

specify the folder from which to import the files required to connect to 

EnterpriseOne. Using the “JDBC Libraries” property, specify the 

October 14, 2008 - - 43 - -

equired JDBC driver files. 

6. Click Next 



October 14, 2008 - - 44 - -

Setting properties for the external service wizard 


necessary: username, password, environment and role. Provide this 


Selecting the business objects and services to be used with the 

adapter 

Follow these steps to select the F0116 data using JDE XML List query: 

1. Edit Query Properties by adding table name F0116. The following steps 

describe how to do this: 

a. In the Find Objects in the Enterprise System screen, click Edit Query. 

October 14, 2008 - - 45 - -

. In Specify the Query Properties screen, click the Add button next to 

the Tables list. 

October 14, 2008 - - 46 - -

c. In the Add Value screen that appears, type F0116, then click OK. 

F0116 appears in the Tables list. 

d. Click OK to close the Specify Query Properties screen. 

2. In the Find Objects in the Enterprise System screen, click the Run Query 

button. 

October 14, 2008 - - 47 - -

3. Expand XML List node, select F0116 node and click > Add button to select 

object for importing into the service description. 

October 14, 2008 - - 48 - -

4. Configure XML List query business object for import into the service 

description. 

a. Select OWTABLE from the Table type list. 

October 14, 2008 - - 49 - -

. Select the check box Add Condition. 

October 14, 2008 - - 50 - -

c. Set Attribute to Addressnumber 

d. Press OK. 

The configured query business object should be imported. 

October 14, 2008 - - 51 - -

Click NEXT>. 



1. In the Specify Composite Properties screen, use the default values. 

October 14, 2008 - - 52 - -

2. Click the NEXT. 

3. On Specify the Service Generation and Deployment Configuration screen, 

select Using security properties from managed connection factory and enter 

October 14, 2008 - - 53 - -

the connection information. Click Next. 

October 14, 2008 - - 54 - -



5. The New Business Integration Project screen appears, select Module, then 

click Next 

October 14, 2008 - - 55 - -

6. In the New Module screen, type XMLListSample in the Module Name field, 

then click Finish. 

October 14, 2008 - - 56 - -



October 14, 2008 - - 57 - -


October 14, 2008 - - 58 - -

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 


1. Add the SCA module to the server using the server panel in WebSphere 

Integration Developer. Right-click on the server, and select Add and remove 

projects. 




October 14, 2008 - - 59 - -




2. Populate values for input business objects. 

3. Populate the Addressnumber attribute of the F0116Query1 business 

object, with the value 33937. 


5. Check the output of the service, and also check the data in the EIS to 

ensure that it matches with the expected values. 




October 14, 2008 - - 60 - -

Chapter 5. Tutorial 3: Invoking JD Edwards 

EnterpriseOne AddressBook 

using a business function 

(outbound processing) in multiple 

times 

Scenario 


EnterpriseOne 7.0 uses the GetEffectiveAddress business function to retrieve 

multiple records from the AddressBook. 

In this scenario, an SCA calling is used to retrieve multiple specific business 

addresses. The specific business addresses can be gotten by using one JDE business 

function: 


October 14, 2008 - - 61 - -


1> Send the request to JDE server for fetching the specific business 

addresses. In this case, we will fetch the business addresses whose IDs 

are 1 and 9. 


response to a SDO which can be understood easily by the SCA 

component. And this SDO will contain two business addresses. In the SCA 

component, customer can take use of the addresses. 


server by invoking the JDE business function. And the business address can be 

invoked multiply. 








2. Start the external service wizard by choosing: File-> New -> 

External Service. 

3. Expand Adapters and select J D Edwards and then click Next button. 

October 14, 2008 - - 62 - -

4. From the Select an Adapter window, you can either create a new 

project or select an existing project. 


October 14, 2008 - - 63 - -







runtime list (for example, WebSphere Process Server 7.0), 











1. In the Version property, select the version of EnterpriseOne what will be 

used. Using the “Folder containing the required files” property, specify 

the folder from which to import the files required to connect to 

October 14, 2008 - - 64 - -

EnterpriseOne. Using the “JDBC Libraries” property, specify the required 

JDBC driver files. 




October 14, 2008 - - 65 - -



necessary: username, password, environment, and role. Provide this 


Selecting the business objects and services to be used with the adapter 

Follow these steps to select the GetEffectiveAddress business object: 

1. In the Find Objects in the Enterprise System screen, click the Run Query 

button. 

October 14, 2008 - - 66 - -

2. In the “Discovered objects” list, select the Business Functions node and 


October 14, 2008 - - 67 - -

3. Select the CFIN node and expand it. 

October 14, 2008 - - 68 - -

4. Select the B0100033 node and expand it. 

October 14, 2008 - - 69 - -

5. Select the GetEffectiveAddress node. 

October 14, 2008 - - 70 - -


October 14, 2008 - - 71 - -

7. Use the default business object name GetEffectiveAddress and click the OK 

button. 





Namespace, Relative Path, and Max Records fields. 

October 14, 2008 - - 72 - -

2. Click the Add button of the Container Business Objects name. 

October 14, 2008 - - 73 - -

3. Fill the Container business object name field with 

GetEffectiveAddressContainer. 

October 14, 2008 - - 74 - -

4. Click the Add button of the Operations to add Retrieve Operation. 

5. Click the Add button of the Business Functions, select GetEffectiveAddress , 

then click OK. 

October 14, 2008 - - 75 - -

6. Click Add button of the Configuration Table to choose GetEffectiveAddress 

and select the checkbox Array 

October 14, 2008 - - 76 - -

October 14, 2008 - - 77 - -



select Using security properties from the managed connection factory and 

October 14, 2008 - - 78 - -

enter the connection information. Click Next. 

October 14, 2008 - - 79 - -




click Next. 

October 14, 2008 - - 80 - -

11. In the New Module screen, type BSFNMultipleExecutionSample in the 

Module Name field, then click Finish. 

October 14, 2008 - - 81 - -



October 14, 2008 - - 82 - -





1. Add the module you created earlier to the server using the 

server panel in WebSphere Integration Developer. Right-click 

on the server, and then select Add and remove projects. 

October 14, 2008 - - 83 - -







2. Right-click GetEffectiveAddress to add 2 elements. 


business object instance1, with the value 1. 


October 14, 2008 - - 84 - -

usiness object instance2, with the value 9. 

3. To execute the service, click on the continue button 

4. Check the output of the service, and also check the data in the EIS to 

ensure that it matches with the expected values. 




October 14, 2008 - - 85 - -

Chapter 6. Tutorial 4: Polling JD Edwards 

EnterpriseOne Real-time event 

from JD Edwards transaction 

server (inbound processing) 

Scenario 


EnterpriseOne 7.0 gets real-time event from JD Edwards EnterpriseOne 

transaction server. 

In this scenario, the information of a company is changed in JDE server. The 

JDE server will generate the corresponding JDE real-time event. This event is then 

polled by JDE adapter and transferred to one SCA component. The following realtime 

event will be generated and transferred to SCA component: 

RTCOOUT 

This case only has three steps: 

October 14, 2008 - - 86 - -

1> Customer changes the information of one company in JDE server. Then, 

JDE server will generate the corresponding real-time event. 

2> JDE adapter will poll the event from JDE server in period. Then, it will find 

the real-time event and fetch the event from JDE server. 

3> At last, JDE adapter will convert the real-time event to a SDO and send it 

to the destination SCA component. 


server by polling real-time event from JDE server. 

Configuring the adapter for inbound processing 




1. Switch to the Business Integration Perspective in WebSphere Integration 

Developer by choosing from the menu: Window -> Open Perspective - 

> Business Integration. 

2. Start the external service wizard by choosing: File-> New -> External 

Service. 

3. Expand Adapters and select J D Edwards, and then click Next button. 

October 14, 2008 - - 87 - -

4. From the Select an Adapter window, you can either create a new project 

or select an existing project. 


October 14, 2008 - - 88 - -







runtime list (for example, WebSphere Process Server v7.0), 











1. In the Version property, select the version of EnterpriseOne what will be 

used. Using the “Folder containing the required files” property, specify the 

October 14, 2008 - - 89 - -

folder from which to import the files required to connect to EnterpriseOne. 

Using the “JDBC Libraries” property, specify the required JDBC driver files. 



Choose Inbound for invoking JDE business function. Then click Next.. 

October 14, 2008 - - 90 - -



necessary: username, password, environment and role. Provide this 


Selecting the business objects and services to be used with the adapter 

Follow these steps to select the existing real-time event RTCOOUT 

business object: 

1. In the Find objects in the Enterprise System screen, click the Run Query 

button. 

October 14, 2008 - - 91 - -

2. In the “Discovered objects” list, select the Real-Time events node and 


October 14, 2008 - - 92 - -

3. Select the RTCOOUT node. 

October 14, 2008 - - 93 - -


October 14, 2008 - - 94 - -

5. Select “Configuration with operation field” and choose “cActionCode” as 

Operation Field. 

6. Click the OK button. 

October 14, 2008 - - 95 - -

7. Click NEXT>. 




Namespace and Relative Path fields. 

October 14, 2008 - - 96 - -

2. Click NEXT>. 


select Using security properties from the activation spec and enter the 

connection information. 

October 14, 2008 - - 97 - -

October 14, 2008 - - 98 - -

4. Input Event delivery configuration information for event assured delivery. 

October 14, 2008 - - 99 - -

October 14, 2008 - - 100 - -





click Next 

October 14, 2008 - - 101 - -

8. In the New Module screen, type Real-timeEventSample in the Module Name 

field, then click Finish. 

October 14, 2008 - - 102 - -



October 14, 2008 - - 103 - -

11. Add a new Java component, which is used to receive the real-time event from 

JDE Adapter. 

October 14, 2008 - - 104 - -

12. Input below code for printing out the content the real-time event. 

Configure the data source EP_DataSource with JNDI 

EP_DataSource_JNDI in 

Before deploying the module to test environment, user needs to configure the data 

source, which are for AssuredEventDelivery. 

1. Access WPS admin page and go to Resources->JDBC->Data sources 

October 14, 2008 - - 105 - -

October 14, 2008 - - 106 - -

2. Create a new data source EP_DataSource with the JNDI EP_DataSource_JNDI 





1. Add the module you created earlier to the server using the 

server panel in WebSphere Integration Developer. Right-click 

on the server, and then select Add and remove projects. 

October 14, 2008 - - 107 - -

Demonstrate this 

process. 






1. Select the module Real-timeEventSample. 

October 14, 2008 - - 108 - -

2. Right-click Test > Attach. 


4. Update one company record by using P0010 in JD Edwards web client. 

October 14, 2008 - - 109 - -

5. Check the output of the service. 




October 14, 2008 - - 110 - -

Chapter 7. Troubleshooting 

1. Symptom: A SpecFailureException exception is thrown from EMD or at runtime: 

Caused by: com.jdedwards.system.connector.dynamic.spec.SpecFailureException: Cannot connect 

to Oneworld Spec Source:Data Source not found in Oneworld Database Data source for F9860, 

TBLE not found. ([DATABASE_CONNECT_FAILED] Database Connection failed for DataSource 

SY812.) 

at 

com.jdedwards.system.connector.dynamic.spec.source.OneworldBSFNSpecSource.(Unknown 

Source) 

at com.ibm.j2ca.jde.outbound.bsfn.JDEGetSpecSource.run(JDEGetSpecSource.java:36) 

at java.security.AccessController.doPrivileged(AccessController.java:241) 

... 9 more 

Cause: This is usually caused by configuration issues 

Resolution: 

1. Verify that the appropriate JDBC driver is in the class path 

2. Verify the JDE configuration files (jdbj.ini, jdeinterop.ini, 

jdeLog.properties, tnsnames.ora) are configured correctly for the JDE 

server being used and that they are in the class path. 

3. Verify that the JDE server to which you are trying to connect and all 

services are started correctly. 

4. Verify that the required JDE files have been imported and added to the 

class path. 

2. Symptom: A ServerFailureException exception is thrown from EMD or at 

runtime: 

Caused by: com.jdedwards.system.connector.dynamic.ServerFailureException: Cannot connect to 

any OneWorld Security Server.FAILURE: null 

at com.jdedwards.system.connector.dynamic.Connector.loginBase(Unknown Source) 

at com.jdedwards.system.connector.dynamic.Connector.login(Unknown Source) 

at com.ibm.j2ca.jde.outbound.JDEConnectionProperties.run(JDEConnectionProperties.java:63) 

at java.security.AccessController.doPrivileged(AccessController.java:242) 

October 14, 2008 - - 111 - -

... 23 more 

doPrivileged(AccessController.java:241) 

... 9 more 

Cause: This is usually caused by configuration issues 

Resolution: 

1. Verify that the appropriate JDBC driver is in the class path 

2. Verify the JDE configuration files (jdbj.ini, jdeinterop.ini, 

jdeLog.properties, tnsnames.ora) are configured correctly for the JDE 

server being used and that they are in the class path. 

3. Verify that the JDE server to which you are trying to connect and all 

services are started correctly. 

4. Verify that the required JDE files have been imported and added to the 

class path. 

3. Symptom: Error received attempting to connect to JDE with EMD 

Resolution: 

Verify that the connection parameters have been entered correctly 

4. Symptom: There are no tables listed in the tree view under XML Lists 

Resolution: 

Verify that table names have been added to the ‘Tables for XML List Table 

Names’ property in the Query Filter Properties window 

5. Symptom: On Business Object Properties window, error indicating invalid 

characters in BO Name 

Resolution: 

Follow instructions in message and remove invalid characters from BO name 

6. Symptom: On Business Object Properties window, error indicating unable to 

retrieve table column information 

Resolution: 

Verify correct table name, table type and table conversion version have been 

entered 

October 14, 2008 - - 112 - -

October 14, 2008 - - 113 - -

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 

October 14, 2008 - - 114 - -

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: 

October 14, 2008 - - 115 - -

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 obtain 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 Windows are trademarks of Microsoft Corporation in the United 

States, other countries, or both. 

October 14, 2008 - - 116 - -

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). 

October 14, 2008 - - 117 - -

IBM WebSphere Adapter for JD Edwards EnterpriseOne Quick Start ...

Create successful ePaper yourself

Delete template?

Save as template?