Configure JD Edwards EnterpriseOne artifacts in BizTalk Administration

Article
07/07/2021

Microsoft BizTalk Adapter for JD Edwards OneWorld contains both the Receive Handler and Send Handler folders. The Send Handler folder contains BizTalkServerApplication. BizTalk Adapter for JD Edwards OneWorld is creatable; it runs in-process with BizTalk Server and does not run in an isolated host process.

Add the adapter to BizTalk Administration

Open BizTalk Server Administration, expand BizTalk Server Administration, expand BizTalk Group, and then expand Platform Settings.
Right-click Adapters, select New, and select Adapter.
Enter a name for the adapter. For example, enterJDEOneWorld.
Select JDEOneWorld from the Adapter list, and select OK.

Check if the adapter is working

In the BizTalk Server Administration Console, you can verify that the adapter is functioning correctly by looking at the Logical System window. On initial installation, this window is empty because you have not yet established a connection to the server system, nor have you created any logical systems.

In BizTalk Server Administration, expand Platform Settings, expand Adapters, and then select JDEOneWorld.
In the details pane, right-click BizTalkServerApplication, and select Properties.
Select the Properties tab.
Set the SQL Connection parameters.
- Define SQL Database Parameters - The SQL Server Name and Database are those you set at installation. This is the text area that you can redefine the server and database for this adapter.
Select Close to exit the Logical System window.

Your next step is to add a logical system using Visual Studio.

Create the send port

In BizTalk Server Administration, expand BizTalk Group, expand Applications, and then expand your application.
Right-click Send Ports, select New, and then select Static Solicit-Response Send Port.

Note

You can also use Static One-Way Port.
In the Send Port Properties, select the Name field, and enter a send port name. For example, enter SendToJDE.
In the Type drop-down list, select JDEOneWorld.
In the URI drop-down list, select the send handler.
Select OK.

Configure the transport properties

The JD Edwards OneWorld Transport Property System Definition is used for design and run-time logon. You set these credentials to browse JD Edwards OneWorld business functions at design time and make calls at run time.

When a connection is made to JD Edwards OneWorld, parameters are passed to the connection object (User, Password, Environment). It returns an instance of the JD Edwards OneWorld aApplication business function. The credentials are further defined by the name of the enterprise/application server, and the defined TCP/IP port on which the service listens.

The enterprise server name and port are read from a file that is named jdeinterop.ini. These values must be the same as those that are in the System Definition settings.

Note

All entries are case sensitive.

Set the properties

In the Transport Properties dialog box, you set the connection and credential parameters that are specific to the server system and the objects you are trying to access.

Provide credentials. You can access the JD Edwards OneWorld system using one of the following methods:
- Logon credentials (Password, User name): If you use this method, go to step 5.
- Single Sign-On.
To use Single Sign-On (SSO), select Yes in the Use SSO.

For more information about how to set up SSO, see Security in the adapter
Select an affiliate application in the list.

An affiliate application, created by Enterprise Single Sign-On tools, represents an application such as JD Edwards OneWorld. Microsoft BizTalk Adapter for JD Edwards OneWorld uses the credentials of an application user. These credentials are retrieved from the SSO Credentials database for the server system for a specified affiliate application. The credentials are those of the application user who launched the BizTalk Server project.

For more information, see Creating Affiliate Applications.
Expand the JD Edwards OneWorld system node and enter all required information for connection to the JD Edwards OneWorld server.

After you set the connection parameters, you can browse a JD Edwards OneWorld system. For more information, see Importing JD Edwards OneWorld Schemas into BizTalk Server Projects.
Enter a value representing the number of calls, for example 200, in Max Concurrent Calls if it is required.

The Max Concurrent Calls parameter lets you optimize your configuration. You use this parameter in instances where the throughput exceeds back-end processing capabilities, to activate message-overload protection. The default is -1, which means that the calls are unlimited.

When BizTalk Server submits messages to the transmit adapter, it first receives a batch from the adapter. It invokes TransmitMessage on the batch to transmit each message. When done, BizTalk Server invokes Done on the batch, and the adapter starts transmitting the messages to the back-end. If BizTalk Server obtains multiple batches before invoking Done, it might never occur. By setting the maximum number of messages in a batch, you can control messages to the back-end.

Changing this parameter takes effect within one minute; BizTalk Server must retrieve the changes to the adapter configuration saved in the SQL database.
Select Yes for Refresh Agent to force the runtimeagent.exe and the browsingagent.exe processes to restart automatically when required.

For example, you want the process to restart automatically if it loses connection with the server, or if you add something to the server and it does not appear in the Microsoft Adapter Wizard for selection.

Note

The browsingagent.exe does not refresh until you exit the current browsing session. For example, you must exit the Add generated item browsing session and reenter to update the browsingagent.exe.
After providing all required information, click Apply, and then click OK to accept the connection information.

You must set connection parameters for BizTalk Adapter for JD Edwards OneWorld to access JD Edwards OneWorld.

Adapter required properties

If you did not set global environment variables in Control Panel, you can do so in this section.

Parameter	Description
`Host`	Type the name of the host server computer name (for example, `actsvr1`); or the IP address of the computer (for example, `123.456.0.789`).
JAVA_HOME	Type the complete path of your JDK installation.
JDE Edwards Environment	Type the name of an environment in JD Edwards OneWorld, for example, `DV7333`. DV7333 is a common name for the development environment, PY7333 is common for the prototype environment, and PD7333 is common for the production environment.
JDEdwards JAR Files	Enter the complete path and file name for each JAR file: - Connector.jar - Kernel.jar - JDEJAccess.jar - JDEActionalInterop.jar Each jar file must be separated with a semi-colon (;) and no space. For example: `<drive>\Connector.jar;<drive>\Kernel.jar;`
Password	Type the password of the specified user.
Port	Type the port number that will exchange data (for example, `6009`).
User Name	Type a JD Edwards OneWorld user name that will be used to log on to the JD Edwards OneWorld system.

Use the XMLTransmit and XMLReceive pipelines

Microsoft BizTalk Adapter for JD Edwards OneWorld requires that you select XMLTransmit and XMLReceive for the send and receive pipelines.

In BizTalk Server Administration, expand Applications, and then expand your application.
Select Send Ports, right-click your send port, and select Properties.
In the Send Ports Properties, do the following:
1. Select the send pipeline from the Send Pipeline drop-down list.
2. Select the Receive pipeline from the Receive Pipeline drop-down list.
Select OK.

Next steps

Import adapter schemas into Visual Studio
Use Message Context Properties