Setting Up the Integration Environment in the PeopleSoft Enterprise and JD Edwards EnterpriseOne Systems

This chapter provides overviews of installation and configuration steps and the integration architecture and discusses how to:

• Set up the integration environment in the PeopleSoft Enterprise system.

• Set up the integration environment in the JD Edwards EnterpriseOne system.

Understanding Installation and Configuration Steps

This document does not describe in detail how to install and configure the integration. You should have installed the objects associated with the integration prior to using this document. However, this section provides an overview of the general steps involved for installing an integration and gives recommendations for improving the system performance. To review information about installation and configuration, review the installation and configuration steps.

Use this table to guide you through the installation and configuration process for JD Edwards EnterpriseOne application integrations with PeopleSoft Enterprise applications. To ensure proper integration, you must perform the steps in the order listed.

Note. References to the PeopleSoft Enterprise system in this table can refer to either PeopleSoft Enterprise 8.8 or 8.9. References to the JD Edwards EnterpriseOne system refer to JD Edwards EnterpriseOne 8.12. Refer to the Minimum Technical Requirements (MTRs) for your integration to determine the correct versions.

Understanding the Integration Architecture

This diagram illustrates the high level architecture for integration between the PeopleSoft Enterprise system and the JD Edwards EnterpriseOne system:

Integration Architecture diagram

The PeopleSoft Enterprise system uses integration points and Integration Broker (IB). The JD Edwards EnterpriseOne system uses WSG Integration Server (IS), which includes z-file interfaces, interface flows, and other JD Edwards EnterpriseOne integration points.

Special services have been developed using WSG Integration Server technology that map, transform, and cross-reference data as it flows between the PeopleSoft Enterprise system and the JD Edwards EnterpriseOne system. These services are written using the WSG Developer Tool.

For a detailed insight into these technologies, refer to the relevant technical implementation guides.

Setting Up the Integration Environment in the PeopleSoft Enterprise System

This section lists a prerequisite and discusses how to:

• Set up the local gateway.

• Activate message channels.

• Activate messages.

• Activate message nodes.

• Set up node definitions.

• Set up integration transactions.

• Add channels to permissions.

• Activate message subscriptions.

Note. The tasks listed here refer to PeopleTools 8.45 and represent minimum guidelines for setting PeopleSoft Enterprise integrations. Please refer to the implementation guides for the PeopleSoft Enterprise products that you are integrating for complete information about setting up these products for integrations. Refer also to the setup chapter for your integration in this implementation guide for additional setup steps for your integration.

See Also

PeopleSoft Enterprise PeopleTools 8.46 Implementation Guide: Integration Broker, "Managing Integration Gateways," Administering Integration Gateways

PeopleSoft Enterprise Components for PeopleSoft Enterprise Financial Management Solutions, PeopleSoft Enterprise Service Automation, Asset Lifecycle Management, and Supply Chain Management 8.9 Implementation Guide, Enterprise Integration, “Activating Messaging Integration Points”

Prerequisite

Configure the application server for your database to be with Pub/Sub Servers active.

Pages Used to Set Up the Integration Environment

Access these pages in the appropriate PeopleSoft Enterprise database for the integration you are using.

Setting Up the Local Gateway

Access the Gateways page.

To set up the local gateway:

1. Search for the gateway ID for which you have selected the Local Gateway check box.

2. Specify the gateway URL as http://<web server name>:<port>/PSIGW/PeopleSoftListeningConnector

   For example:

   http://wsg27:81/PSIGW/PeopleSoftListeningConnector

3. Click Save to save the URL first.

4. Click Load Gateway Connectors to load the connectors, and then click Save.

Activating Message Channels

Access the Channel Status page.

Select the Run button for each channel that you need to activate.

Note. The setup chapter for each integration in this implementation guide contains a list of required message channels for that integration.

Activating Messages

To activate messages:

1. Access Application Designer for the appropriate PeopleSoft Enterprise database.

2. For each message listed:

   1. Select File, Open, Message to open the message.

   2. Access the properties for the message object.

   3. Ensure that you have selected the Active option in the Status box on the Use tab, and then click OK.

   4. Save the message.

Note. The setup chapter for each integration in this implementation guide contains a list of required messages for that integration.

Activating Message Nodes

The system delivers message nodes as inactive. Ensure that you have activated the PSFT_E1 node or the node that you have set up to represent the JD Edwards EnterpriseOne system. If you have multiple JD Edwards EnterpriseOne systems, you need to complete these steps for each JD Edwards EnterpriseOne node that you use.

Access the Node Definitions page.

To activate message nodes:

1. Enter the appropriate node name, and click Search.

2. Ensure that you have selected the Active Node check box.

3. Save the node.

Note. Some integrations require additional nodes. For those integrations, the additional nodes are listed in the setup chapter for that integration in this implementation guide.

Setting Up Node Definitions

Access the Connectors page.

Select HTTPTARGET as the connector ID.

Identify the properties and provide a designated URL for the PSFT_E1 node or the node that you have set up to represent the JD Edwards EnterpriseOne system. If you have multiple JD Edwards EnterpriseOne systems, you need to complete these steps for each JD Edwards EnterpriseOne node that you use.

For the PRIMARYURL property, enter the URL of the Integration Server in the PRIMARYURL Value field.

The URL points to JD Edwards EnterpriseOne Integration Server and should have the format:

http://<WSG IS MachineName>:<IS port>/invoke/PSFT_Dispatcher.Inbound: InboundServiceDispatcher

Note. You must register each node in the properties file for the gateway. Search for the string ## JOLT connect string settings for Application Server(s) with known NODENAMEs and follow the instructions there.

See PeopleSoft Enterprise PeopleTools 8.46 Implementation Guide: Integration Broker, “Managing Integration Gateways,” Using the integrationGateway.properties File.

See PeopleSoft Enterprise PeopleTools 8.46 Implementation Guide: Integration Broker, “Appendix: Using the Integration Broker Connector SDK,” Developing Connectors, Developing Listening Connector Classes

Setting Up Integration Transactions

You must activate nodes and their associated transactions for the integrations you are using.

Access the Transactions page.

To activate node transactions:

1. Click the Edit link.

2. Set the Status value to Active on the Transaction Detail tab, and click Save.

3. Click the Return to Transaction List link.

Note. The setup chapter for each integration in this implementation guide contains a list of required transactions for that integration.

Adding Channels to Permissions

To send and receive messages in the PeopleSoft Enterprise system, you must set the channel permissions.

Access the Permission Lists page.

To add channels to a permission list:

1. Select the permission list for a user ID that has access to the Message Monitor.

2. Select the Message Monitor tab, and insert a row for the required channel.

3. Set the access for the row, and then click Save.

Note. The setup chapter for each integration in this implementation guide contains a list of required channel permissions for that integration.

Activating Message Subscriptions

To activate message subscriptions:

1. Access Application Designer for the appropriate PeopleSoft Enterprise database.

2. For each message listed, open the message.

3. For each message subscription listed:

   1. Right-click the message subscription and select Message Subscription Properties.

   2. Ensure that you have selected the Active option in the Status box, and then click OK.

   3. Save the message.

Note. The setup chapter for each integration in this implementation guide contains a list of required message subscriptions for that integration.

Setting Up the Integration Environment in the JD Edwards EnterpriseOne System

This section discusses how to:

• Set up Unicode flat file encoding.

• Set up the export folder for table conversions.

• Activate realtime events.

See Also

JD Edwards EnterpriseOne Tools 8.96 System Administration Guide, "Working with Flat File Encoding"

Setting Up Unicode Flat File Encoding

The batch integration flows support UTF-8 encoding. Use the UTF-8 encoding for generating flat files in JD Edwards EnterpriseOne. If the default is not set to UTF-8, make sure that the user who generates the flat files has encoding set to UTF-8. Also, make sure that the correct environment is selected.

Use the Unicode Flat File Encoding Configuration program (P93081) to specify the encoding style for JD Edwards EnterpriseOne. The Unicode Flat File Encoding Configuration program enables you to specify a default encoding that applies to all users (*PUBLIC) and all environments (*ALL). You can overwrite the encoding style at the user level for a particular environment.

Setting Up the Export Folder for Table Conversions

Verify that a folder called Export exists in the \B9\package name\ directory in which JD Edwards EnterpriseOne was installed.

Note. If the Integration Server resides on a different machine than the Export folder, you must set up the Export folder as a shared folder so that the Integration Server can access the flat file.

Activating Realtime Events

You must activate the realtime events that are used by the integrations that you are using. The section of this book for each integration lists the realtime events for that integration. You activate realtime events by changing the status of the event.

See JD Edwards EnterpriseOne Tools 8.96 Interoperability Guide, “Using Events – Guaranteed,” Defining Events.