D Using PeopleSoft Integration Broker

This appendix describes how to configure and test PeopleSoft Integration Broker (release 8.4) and PeopleSoft Application Messaging (release 8.1) using a PeopleSoft-supplied File Output interface. In PeopleSoft release 8.1, the messaging architecture is called Application Messaging and includes Application Messaging Gateway. In release 8.4, the messaging architecture is called Integration Broker, which includes Integration Gateway. When discussing release-generic issues, this section uses release 8.4 terminology. When discussing release-specific issues, it uses release-specific terminology.

Note:

This section is not a substitute for PeopleSoft documentation. For more complete and up-to-date information on PeopleSoft Messaging and Integration Broker, see the PeopleSoft Online Library for your PeopleSoft system.

This appendix contains the following topics:

PeopleSoft Integration Broker

PeopleSoft Integration Broker provides a mechanism for communicating with the outside world using XML files. Communication can take place between different PeopleSoft applications or between PeopleSoft and third-party systems. To subscribe to data, third-party applications can accept and process XML messages posted by PeopleSoft using the available PeopleSoft connectors or by adding a custom built connector to the Integration Gateway. This topic primarily covers publishing outbound asynchronous messages from a PeopleSoft system to a third-party application using the delivered File Output connector. For information on outbound synchronous messages, see "Using Outbound Synchronous Messages".To send a message, you must properly configure various internal structures and processes. The following descriptions are generally release-generic. Detailed differences between releases 8.1 and 8.4 are discussed in other topics.

  • Message

    A Message is a container for the data that goes into the XML. It contains basic structural information, such as records and fields. The Message must be in an Active status to send the XML file

  • Message Channel

    The Message Channel is a mechanism for structuring records into logical groupings. Each Message can belong to only one Message Channel. The Message Channel must be in an Active (Run) status for the Message to be delivered.In release 8.1, the Message Channel also provides preliminary routing instructions; you can specify which Message Nodes handle the message. Each Message Channel can route messages to multiple Message Nodes

  • Message Node

    Message node functionality changed from 8.1 to 8.4:In release 8.1, the primary function of the Message Node is to specify which Gateway receives the messages.In release 8.4, much of the "intelligence" that was built into the Message Channel moved to the Message Node. This provides additional flexibility over release 8.1. You can specify which messages the Message Node can handle. In addition, the Gateway Connector is bound to the Message Node. Each Message Node can route messages to only one Connector.

  • Integration Gateway

    The Integration Gateway is a program that runs on the PeopleSoft Web Server. It is the physical hub between PeopleSoft and the third-party system.

  • Target Connector/Handler

    Connectors are Java programs that run under the control of the Integration Gateway and control the final output destination of the XML file. PeopleSoft release 8.4 comes with several connectors including HTTP, FTP, SMTP, JMS, POP3, and a Simple File connector that places the file in a directory on the Web Server. This section discusses the Simple File connector.

  • PeopleCode

    PeopleCode is the programming tool provided with PeopleTools that enables you to create complex application functionality. A message can only be initiated using specific PeopleCode instructions. This code is typically triggered by an application event, such as creating a new database entry through an online panel or through a batch job.

Most of the examples in this section use the LOCATION_SYNC message, which is a PeopleSoft Enterprise Integration Point (EIP) and is supplied with most PeopleSoft applications. If LOCATION_SYNC is not part of your package, you may use any supplied message.

Configuring Integration Broker in PeopleSoft 8.4

You can configure PeopleSoft 8.4 to send an asynchronous outbound message to the File Output connector.

To configure application messaging in PeopleSoft 8.4:

  1. Ensure that the message is active and is routed to the proper Message Channel.

  2. Configure the Message Channel.

  3. Configure the IntegrationGateway.properties file to communicate with your PeopleSoft 8.4 application.

  4. Configure the Integration Gateway and File Output connector.

  5. Create and configure a new Gateway node.

    These tasks are described in detail in the following procedures.

Ensuring the Message Is Active and Is Routed Correctly

To ensure that the message is active and is routed to the proper Message Channel:

  1. Open Application Designer.

  2. On the File menu, point to Open, click Message, and then open the LOCATION_SYNC message, as shown in Figure D-1.

    Figure D-1 LOCATION_SYNC Message

    Fields included in the message
    Description of "Figure D-1 LOCATION_SYNC Message"

  3. To view the fields that are included in the Message, highlight LOCATION_TBL.

  4. Right-click LOCATION_TBL and select Properties.

    The Message Properties dialog is displayed, as shown in Figure D-2.

    Figure D-2 Message Properties Dialog

    Message Properties dialog box
    Description of "Figure D-2 Message Properties Dialog"

  5. Select the Use tab.

  6. Ensure the Active check box is selected.

    The message is routed to the Message Channel, ENTERPRISE_SETUP, and the default message version is VERSION_1 (messages can have multiple versions).

  7. Click OK and then save the message.

    You have finished ensuring that the message is active and is routed correctly.

Configuring the IntegrationGateway.properties File

To configure the IntegrationGateway.properties file:

  1. Open the IntegrationGateway.properties file using the editor of your choice.

  2. Find the section of the file that specifies the JOLT connect string setting for the default application server. This is usually near line 75, and looks similar to the following:

    ## JOLT connect string setting for optional Default Application Server. Do NOT specify a NODENAME.
    #
    # Example:
    #ig.isc.serverURL=//MYSERVER:9000
    #ig.isc.userid=MYUSERID
    #ig.isc.password=MYPASSWORD
    #ig.isc.toolsRel=8.40
    
  3. Uncomment (or copy and uncomment) the four lines that specify the connection.

  4. Enter the appropriate information.

    In the following example, the tools release is 8.40.09:

    ig.isc.serverURL=//isdsrv14:9000
    ig.isc.userid=VP1
    ig.isc.password=VP1
    ig.isc.toolsRel=8.40.09
    

    The PeopleSoft tools release must be precise to the last decimal.

Note:

With release 8.42, the password must be stored in an encrypted format. PeopleSoft provides a script called PSCipher.bat (PSCipher.sh on UNIX) to accomplish encryption. Typically, this script is located in the path of the IntegrationGateway.properties file. Follow the instructions supplied by PeopleSoft to run this script.

You have finished configuring the IntegrationGateway.properties file.

Configuring the Integration Gateway and the File Output Connector

To configure the Integration Gateway and the File Output Connector:

  1. In a Web browser, open your PeopleSoft 8.4 application in 4-tier mode.

  2. In the Menu pane, expand PeopleTools, Integration Broker, and then click Gateways.

  3. Open the LOCAL Gateway ID and enter the following Gateway URL:

    host name/PSIGW/PeopleSoftListeningConnector
    

    Where host name is the name of your PeopleSoft Web Server.

  4. Click Refresh.

    A message appears stating the outcome of the refresh process, as shown in Figure D-3.

    Figure D-3 Refresh Process Outcome Message

    Message stating the outcome of the refresh process
    Description of "Figure D-3 Refresh Process Outcome Message"

  5. Click OK and scroll down to click Save.

    You must click Save before continuing.

  6. Click the Properties link for the FILEOUTPUT Connector ID.

    The Properties window for the FILEOUTPUT Connector is displayed.

  7. Accept or overwrite the default values.

    The FilePath PROPERTY from the c:\temp default was changed to d:\ps\cache, as shown in Figure D-4.

    Figure D-4 Gateway ID Property Pane

    FilePath property
    Description of "Figure D-4 Gateway ID Property Pane"

  8. To return to the Gateway window, click OK.

  9. Scroll down and click Save.

    You have finished configuring the Integration Gateway and the File Output Connector.

Creating and Configuring a New Gateway Node

To create and configure a new Gateway Node:

  1. In the Menu pane, expand PeopleTools, Integration Broker, and then, click Node Definitions.

  2. Select the Add a New Value tab.

  3. In the Node Name field, enter a node name.

    It is recommended that you name your first (trial) message node EXTERNAL. After successfully configuring and sending messages using this node, you can create additional message nodes with names appropriate for your application.

  4. Click Add.

    The Node Info tab becomes available, as shown in Figure D-5.

    Perform the following steps:

    1. In the Description field, enter an appropriate description.

    2. From the Node Type list, select EXTERNAL.

    3. From the Routing Type list, select Implicit.

  5. Select the Connectors tab.

    The Connectors tab becomes available, as shown in Figure D-6.

    Figure D-6 Connectors Tab

    Connectors tab
    Description of "Figure D-6 Connectors Tab"

    Perform the following steps:

    1. Specify LOCAL for the Gateway ID.

    2. Specify FILEOUTPUT for the Connector ID.

    3. Accept or overwrite the default Gateway property values.

  6. Click Save.

  7. To specify the transactions to route messages to your node, select the Transactions tab and click Add Transaction.

    The Node Transactions pane is displayed, as shown in Figure D-7.

    Figure D-7 Node Transactions Pane

    Node Transactions pane
    Description of "Figure D-7 Node Transactions Pane"

    Perform the following steps:

    1. From the Transaction Type list, select Outbound Asynchronous.

    2. In the Request Message field, specify LOCATION_SYNC.

    3. In the Request Message Version field, specify VERSION_1.

      In the Request Message Version field, specify VERSION_1.

  8. Click Add.

    The Transaction Detail pane is displayed, as shown in Figure D-8.

    Figure D-8 Transaction Detail Pane

    Transaction Detail pane
    Description of "Figure D-8 Transaction Detail Pane"

    Perform the following steps:

    1. Verify that the Routing Type is Implicit.

    2. Click Save, then click the Return to Transaction List link.

    3. To ensure that your data entry is not lost, click Save again.

You have finished creating and configuring the new Gateway Node.

For more information, see "Viewing the PeopleCode for a Message".

Configuring Application Messaging in PeopleSoft Release 8.1

You can configure PeopleSoft 8.1 to send an asynchronous outbound message to the Simple File Handler.To configure application messaging in PeopleSoft 8.1:

  1. Create and configure a new Message Node.

  2. Ensure the message is active and is routed to the proper Message Channel.

  3. Configure the Message Channel.

  4. Configure the Simple File Handler in the Gateway.

    These tasks are described in detail in the following procedures.

Creating and Configuring a New Message Node

To create and configure a new message node:

  1. Select New from the File menu and click Message Node.

    A Message Node window is displayed, as shown in Figure D-9.

    Figure D-9 Message Node Window

    Message Node window
    Description of "Figure D-9 Message Node Window"

  2. Right-click anywhere inside the white space and select Insert Location.

    The Location URL box is displayed, as shown in Figure D-10.

    Figure D-10 Location URL Box

    Location URL box
    Description of "Figure D-10 Location URL Box"

  3. Enter the following URL for the PeopleSoft Application Gateway (handler directory):

    host name:port/servlets/psft.pt8.gateway.GatewayServlet
    

    Where host name is the host name of your PeopleSoft Web server and port is the socket on which the server is listening. The characters you enter after host name are case-sensitive.

  4. Click OK.

  5. Display the Message Node Properties dialog, as shown in Figure D-11.

    Figure D-11 Message Node Properties Dialog

    Message Node Properties dialog box
    Description of "Figure D-11 Message Node Properties Dialog"

    Perform the following steps:

    1. Select the Use tab.

    2. In the text boxes, enter the PeopleTools and Application Version numbers.

    3. Click OK.

  6. Display the Save As dialog, as shown in Figure D-12.

    Figure D-12 Save As Dialog

    Save as dialog box
    Description of "Figure D-12 Save As Dialog"

  7. To save the Message Node, click OK.

    It is recommended that you name your first (trial) message node EXTERNAL. After successfully configuring and sending messages using this node, you can create additional message nodes with names appropriate for your application.If you intend to migrate this message node to a different PeopleSoft environment (for example, from Test to QA), you can create a PeopleSoft project and insert the Message Node into the project.You have finished creating and configuring the message node.

Ensuring the Message Is Active and Is Routed Correctly

To ensure that the message is active and is routed to the proper message channel:

  1. Open Application Designer.

  2. On the File menu, point to Open, click Message, and open the LOCATION_SYNC message, as shown in Figure D-13.

    Figure D-13 LOCATION_SYNC Message

    LOCATION_TBL field
    Description of "Figure D-13 LOCATION_SYNC Message"

  3. To view the fields that are included in the message, highlight LOCATION_TBL.

  4. Right-click LOCATION_TBL and select Properties.

    The Message Properties dialog is displayed, as shown in Figure D-14.

    Figure D-14 Message Properties Dialog

    Message Properties dialog box
    Description of "Figure D-14 Message Properties Dialog"

    Perform the following steps:

    1. Select the Use tab.

    2. Ensure the Status check box is selected, which indicates that the message is active.

    3. From the Message Channel list, select ENTERPRISE_SETUP.

    4. From the Default Version list, select VERSION_1 (messages can have multiple versions).

  5. Click OK.

  6. Save the message.

Configuring the Message Channel

To configure the message channel:

  1. From the File menu, choose Open and click Message Channel.

  2. To open the ENTERPRISE_SETUP Message Channel, select ENTERPRISE_SETUP.

  3. Right-click ENTERPRISE_SETUP and select Properties.

    The Message Channel Properties dialog is displayed, as shown in Figure D-15.

    Figure D-15 Message Channel Properties Dialog

    Message Channel properties dialog box
    Description of "Figure D-15 Message Channel Properties Dialog"

    Perform the following steps:

    1. Select the Use tab.

    2. Ensure that the Message Channel status is set to Run.

    3. Click OK.

  4. From the left pane, select the Routing Rules tab.

    The pane is blank, as shown in Figure D-16.

    Figure D-16 Routing Rules Pane

    Routing Rules pane
    Description of "Figure D-16 Routing Rules Pane"

  5. Right-click the pane and select Insert Message Node.

    The Insert Message Node dialog is displayed, as shown in Figure D-17.

    Figure D-17 Insert Message Node Dialog

    Insert Message Node dialog box
    Description of "Figure D-17 Insert Message Node Dialog"

    Perform the following steps:

    1. Select the message node that you created in "Creating and Configuring a New Message Node", for example, EXTERNAL.

    2. Click Insert.

  6. Click Cancel.

    Information appears on the Routing Rules tab, as shown in Figure D-18.

    Figure D-18 Routing Rules Tab

    Routing Rules tab
    Description of "Figure D-18 Routing Rules Tab"

    Perform the following steps:

    1. Right-click the message node and point to Routing Direction.

    2. From the Routing Direction menus, select Publish To.

  7. Save the Message Channel, and if you require it, place it in your project.

    You have finished configuring the Message Channel.

Configuring the Simple File Handler in the Gateway

To configure the Simple File Handler in the Gateway:

  1. In a Web browser, launch the PeopleSoft 8.1 configuration servlet interface (also known as the server gateway) by entering the following URL:

    host name:port/servlets/gateway.administration
    

    Where host name is the name of the application server that hosts PeopleSoft and port is the port number on which the application server is listening.

    The Handler Directory window is displayed, as shown in Figure D-19.

    Figure D-19 Handler Directory Window

    Handler Directory window
    Description of "Figure D-19 Handler Directory Window"

  2. Click Add Handler.

    The Add Handler window is displayed, as shown in Figure D-20.

    Figure D-20 Add Handler Window

    Add Handler window
    Description of "Figure D-20 Add Handler Window"

  3. Enter the full name of the Simple File Handler class, psft.pt8.filehandler.SimpleFileHandler.

    Note:

    The name is case-sensitive.
  4. Click Save.

    The Handler Directory window is displayed, as shown in Figure D-21.

    Figure D-21 Handler Directory Window

    Handle Directory window
    Description of "Figure D-21 Handler Directory Window"

  5. To load the handler, click Load.

    After the handler loads, "Loaded successfully" appears in the Status column.

  6. Click Configure.

    The Simple File Handler Directory window is displayed, as shown in Figure D-22.

    Figure D-22 Simple File Handler Directory Window

    Simple File Handler Directory window
    Description of "Figure D-22 Simple File Handler Directory Window"

  7. Click Add a file handler node.

    The Add File Handler window is displayed, as shown in Figure D-23.

    Figure D-23 Add File Handler Window

    Add File Handler window
    Description of "Figure D-23 Add File Handler Window"

  8. In the Node Name field, enter the name of the message node that you created in "Creating and Configuring a New Message Node", for example, EXTERNAL.

Viewing the PeopleCode for a Message

Messages are initiated by the PeopleCode that is attached to a record. Usually, this record is one of the records associated with the message itself.

  1. Open Application Designer, as shown in Figure D-24.

    Figure D-24 Application Designer

    Application Designer
    Description of "Figure D-24 Application Designer"

  2. On the Record Fields tab, select the LOCATION_TBL record.

  3. Select the PeopleCode display option.

  4. Select the Save Post Change (SPo) box for the LOCATION field.

The following window displays the PeopleCode that initiates a LOCATION_SYNC message, as shown in Figure D-25.

For more information about PeopleCode, consult your PeopleSoft Online Library.

You have finished viewing the PeopleCode for a message. You can now test Integration Broker (in PeopleSoft 8.4) or Application Messaging (in PeopleSoft 8.1).

Testing the Integration Broker

To test the Integration Broker by generating a message, you can navigate to the Location Transaction window and add, update, or delete a location entry in your application. Depending on your application, the way you navigate varies.

An example that illustrates a Financials 8.4 application where a new location with a SetID of SHARE and a Location Code of TEST001 was added, as shown in Figure D-26.

Figure D-26 Financials 8.4 Application

Example of a Financials 8.4 application
Description of "Figure D-26 Financials 8.4 Application"

A portion of the XML output is shown in Figure D-27.

Note:

The name of the file is PSFT_EP.LOCATION_SYNC.69.xml, which is the concatenation of PSFT_EP (the local Publishing Node), the name of the message, and the number of the Publication ID.

If you cannot send a message successfully, PeopleSoft provides a set of tools for monitoring the progress of your messages. In release 8.1, you use a tool called the Application Messaging Monitor. In release 8.4, you use the Monitor Menu in the Integration Broker.

For a complete description on how to isolate and resolve problems with your messaging environment, consult your PeopleSoft Online Library. If you are still unable to send your XML file, the PeopleSoft Customer Connection can help solve your problem.

Using Outbound Synchronous Messages

Starting with PeopleTools 8.4, you can send outbound synchronous messages. From a high-level point of view, the primary difference between outbound synchronous and asynchronous is that with outbound asynchronous, the transaction is completed whether the message is actually sent or received.

For synchronous outbound messages:

  • The transaction must wait for a response from the external system before continuing.

  • The transaction must process the response message.

  • The external system must ensure that the response message is correctly formatted.

Oracle Application Adapter for PeopleSoft can work with PeopleSoft outbound synchronous messages. Outbound synchronous messages involve additional configuration steps, both within PeopleSoft and in Oracle WebLogic Server. This topic briefly describes the configuration requirements within PeopleSoft.

Note:

The instructions in this topic build upon the instructions for outbound asynchronous messages. It is strongly recommended that you familiarize yourself with outbound asynchronous messaging before attempting outbound synchronous. For more information on outbound asynchronous messages, see "Configuring Integration Broker in PeopleSoft 8.4".

Ensure that both outbound and inbound messages are created and active. PeopleSoft provides template examples called IB_INST_VER_SYNC_MSG and IB_INST_VER_RESP_MSG. For information on examining these messages, see "Ensuring the Message Is Active and Is Routed Correctly".

Configuring Outbound Synchronous Messages

You can use an existing node, or you can create a new node to configure outbound synchronous messages. For more information on creating and configuring a node, see "Creating and Configuring a New Gateway Node". In either case, you must set up your outbound synchronous transaction.

The following example uses a node and transaction delivered by PeopleSoft. However, this example is for illustrative purposes only and does not actually work as delivered without additional steps. As of Financials release 8.42, there are no preconfigured outbound synchronous transactions that you can use for testing purposes.

Configuring an Outbound Synchronous Message

To configure an outbound synchronous message:

  1. Navigate to the Node Definitions page and open the PT_LOCAL node.

  2. Click the Transactions tab.

    The Transactions pane is displayed, as shown in Figure D-28.

    Figure D-28 Transactions Pane

    Transactions pane
    Description of "Figure D-28 Transactions Pane"

    One outbound synchronous message, IB_INST_VER_SYNC_MSG, appears in the Transaction Type list.

  3. Click the Edit link in the IB_INST_VER_SYNC_MSG row.

    The following pane is displayed, as shown in Figure D-29.

  4. Click the Messages tab.

Both request and response messages appear. The target system must ensure that the response message follows the format of the request message. As the target system is your Oracle WebLogic Server, you must transform the XML that is sent and returned from your final destination.

Note:

You must use the PeopleSoft-supplied HTTP target connector when you are working with synchronous outbound messages. You cannot use the TCPIP84TARGET connector for outbound synchronous messages.

Viewing the PeopleCode for a Synchronous Message

The sample PeopleCode in the following example is for a synchronous outbound message. It differs from asynchronous outbound in that it must handle a response message.

Viewing the PeopleCode for a Financials Synchronous Outbound Message

The following sample code is supplied with the Financials application and is associated with the two messages IB_INST_VER_SYNC_MSG and IB_INST_VER_RESP_MSG.

To view the code, perform the following steps:

  1. From Application Designer, open the PSINST_VER record.

  2. Select the PeopleCode display option.

  3. Select the Field Change (FCh) box for the IB_SEND_SOS_BTN field.

The following window is displayed, as shown in Figure D-30.

Figure D-30 Field Change Box

Field Change (FCh) box
Description of "Figure D-30 Field Change Box"

Generating Events Using PeopleTools Tutorial

This section provides a tutorial that walks you through the PeopleSoft event generation process using PeopleTools version 8.48 and 8.49. The tutorial uses the PeopleTools version 8.48.02 and 8.90 Financial / SCM application. As a result, if you are using a different platform, then correlate the terms and commands specific to that operating system. For more information, refer to the appropriate user guide for each specific component.

Configuring PeopleSoft Services

This section describes how to configure PeopleSoft services.

Adding a Remote Node

To add a remote node:

  1. Logon to PeopleSoft using the browser-based GUI (Pure Internet Architecture).

  2. Select PeopleTools, Integration Broker, Integration Setup, followed by Nodes.

    The Node Definitions tab is displayed, as shown in Figure D-31.

    Figure D-31 Node Definitions Tab

    Node Definitions tab
    Description of "Figure D-31 Node Definitions Tab"

  3. Perform the following steps:

    1. In the Node Name field, type a name for the new node definition, for example, EXTERNAL.

    2. In the Description field, type a brief description for the new node definition.

    3. From the Node Type drop-down list, select External.

    4. From the Authentication Option drop-down list, ensure that the default option, none, is selected.

    5. In the Default User ID field, type the user ID that is being used by the PeopleSoft system, for example, PS.

    6. Select the Active Node check box.

  4. Click the Connectors tab.

    The Connectors tab is displayed, as shown in Figure D-32.

    Figure D-32 Connectors Tab

    Connectors tab
    Description of "Figure D-32 Connectors Tab"

  5. Perform the following steps:

    1. In the Gateway ID field, type LOCAL.

    2. In the Connector ID field, type HTTPTARGET.

    3. For the PRIMARYURL value, enter the host and port number of the PeopleSoft adapter instance that is used to listen for events.

    4. Leave the default values for the remaining properties.

  6. Save your changes.

Selecting a Service

To select a service:

  1. Select PeopleTools, Integration Broker, Integration Setup, followed by Services.

  2. Search for the DEPT_SYNC service and select it.

    The DEPT_SYNC Services pane is displayed, as shown in Figure D-33.

    Figure D-33 DEPT_SYNC Services Pane

    DEPT_SYNC Services pane
    Description of "Figure D-33 DEPT_SYNC Services Pane"

  3. From the Existing Operations section on the lower-left, click the DEPT_SYNC.VERSION_1 service operation.

    The Service Operation - General pane is displayed, as shown in Figure D-34.

    Figure D-34 Service Operation - General Pane

    Service Operation - General pane
    Description of "Figure D-34 Service Operation - General Pane"

  4. Click the Active check box.

  5. Click the Routings tab to add a new routing, as shown in Figure D-35.

  6. In the Routing Name field, type a name for the new routing, for example, ADD_DEPT.

  7. Click Add.

  8. Click the Routing Definitions tab to add a new routing definition, as shown in Figure D-36.

    Figure D-36 Routing Definitions Tab

    Routing Definitions tab
    Description of "Figure D-36 Routing Definitions Tab"

  9. Perform the following steps:

    1. In the Sender Node field, type PSFT_HR, which is the default PeopleSoft node that publishes the message.

    2. In the Receiver Node field, type EXTERNAL, which is the new node that has been created to subscribe the message published by PeopleSoft.

  10. Click the Connector Properties tab, as shown in Figure D-37.

    Figure D-37 Connector Properties Tab

    Connector Properties tab
    Description of "Figure D-37 Connector Properties Tab"

  11. Perform the following steps:

    1. In the Gateway ID field, type LOCAL.

    2. In the Connector ID field, type HTTPTARGET.

    3. For the PRIMARYURL value, enter the host and port number of the PeopleSoft adapter instance that is used to listen for events.

  12. Click Save and then click Return.

    You are returned to the Routing Definitions pane. Notice that the new routing definition (ADD_DEPT) is now added to the list, as shown in Figure D-38.

    Figure D-38 Routing Definitions Pane

    Routing Definitions pane
    Description of "Figure D-38 Routing Definitions Pane"

  13. Click Save to save the details of the Service Operation.

  14. Click the Return to Service link to return to the Services pane.

  15. Click Save on the Services pane.

Activating the Gateway

To activate the gateway:

  1. Select PeopleTools, Integration Broker, Configuration, followed by Gateways.

  2. Search for the Integration Gateway ID, for example, Local and select it.

    The Gateways pane is displayed, as shown in Figure D-39.

    Figure D-39 Gateways Pane

    Gateways pane
    Description of "Figure D-39 Gateways Pane"

  3. Click Ping Gateway.

    A new browser window is displayed, which shows that the gateway is active, as shown in Figure D-40.

    Figure D-40 New Browser Window

    New Browser window
    Description of "Figure D-40 New Browser Window"

  4. Close the new browser window to return to the Gateways pane, as shown in Figure D-41.

    Figure D-41 Gateways Pane

    Gateways pane
    Description of "Figure D-41 Gateways Pane"

  5. Ensure that HTTPTARGET is listed in the Connectors section. If it is not listed, click Load Gateway Connectors to refresh the available connectors.

Activating the Domain

To activate the domain:

  1. Select PeopleTools, Integration Broker, Configuration, followed by Quick Configuration.

    The Quick Configuration pane is displayed, as shown in Figure D-42.

    Figure D-42 Quick Configuration Pane

    Quick Configuration pane
    Description of "Figure D-42 Quick Configuration Pane"

  2. Ensure that the domain is active.

Activating the Service

To activate the service:

  1. Select PeopleTools, Integration Broker, Integration Setup, followed by Services.

    The Services pane is displayed, as shown in Figure D-43.

    Figure D-43 Services Pane

    Services pane
    Description of "Figure D-43 Services Pane"

  2. Ensure that the service is active.

Activating the Service Operation (Queue and Message Node)

To activate the service operation:

  1. Select PeopleTools, Integration Broker, Configuration, Integration Setup, followed by Services.

    The Services pane is displayed, as shown in Figure D-44.

    Figure D-44 Services Pane

    Services pane
    Description of "Figure D-44 Services Pane"

  2. From the Existing Operations section on the lower-left, click the DEPT_SYNC.VERSION_1 service operation.

    The Service Operation - General pane is displayed, as shown in Figure D-45.

    Figure D-45 Service Operation - General Pane

    Service Operation - General pane
    Description of "Figure D-45 Service Operation - General Pane"

  3. In the message information section on the bottom of the page, note the value in the Queue Name field of the service operation, as shown in Figure D-46.

    Figure D-46 Message Information Section

    Message Information section
    Description of "Figure D-46 Message Information Section"

  4. Click the View Queue link.

    The Queue Definitions pane is displayed, as shown in Figure D-47.

    Figure D-47 Queue Definitions Pane

    Queue Definitions pane
    Description of "Figure D-47 Queue Definitions Pane"

  5. Ensure that the Queue Status drop-down list has Run selected.

  6. Click Return to return to the Service operation pane.

  7. Click the Routings tab, as shown in Figure D-48.

  8. Ensure that the routings are active.

  9. Click the Return to Service link on the bottom of the pane to return to the Services pane.

  10. Click Return to Search to go to the Services search pane.

    In the above steps, if the status has been activated in any of the panes for any of the components, then make sure to save the status at the appropriate pane and the respective components.

  11. Select PeopleTools, Integration Broker, Configuration, Integration Setup, Services, followed by Nodes.

    The Node Definitions pane is displayed, as shown in Figure D-49.

    Figure D-49 Node Definitions Pane

    Node Definitions pane
    Description of "Figure D-49 Node Definitions Pane"

  12. Ensure that the status of the External node is active.

    This completes the configuration on the PeopleSoft side.

Triggering the Event in PeopleSoft

This section describes how to trigger the event in PeopleSoft.

Triggering the Event

To trigger the event:

  1. Logon to PeopleSoft using the browser-based GUI (Pure Internet Architecture).

  2. Navigate to Main Menu, Set up HRMS, Foundation Tables, followed by Departments.

    The Departments pane is displayed, as shown in Figure D-50.

    Figure D-50 Departments Pane

    Departments pane
    Description of "Figure D-50 Departments Pane"

  3. Click the Add a New Value tab, as shown in Figure D-51.

    Figure D-51 Add a New Value Tab

    Add a New Value tab
    Description of "Figure D-51 Add a New Value Tab"

  4. Enter the appropriate value in the SetID and Department fields

  5. Click Add.

    The Department Profile tab is displayed, as shown in Figure D-52.

    Figure D-52 Department Profile Tab

    Department Profile tab
    Description of "Figure D-52 Department Profile Tab"

  6. Provide the necessary information according to your requirements to create a new Department record.

  7. Click Save at the bottom of the pane when you are finished.

Verifying the Event Results

This section describes how to verify the event results.

Verifying the Results

To verify the results:

  1. Logon to PeopleSoft using the browser-based GUI (Pure Internet Architecture).

  2. Navigate to Main Menu, PeopleTools, Integration Broker, Service Operation Monitor, followed by Asynchronous Services.

    The Monitor Overview tab is displayed, as shown in Figure D-53.

    Figure D-53 Monitor Overview Tab

    Monitor Overview tab
    Description of "Figure D-53 Monitor Overview Tab"

    Here you can view the results of the events at the queue level.

  3. Click the number link (5) queue (Enterprise_Setup) in the Result section.

    The Operation Instances tab is displayed, as shown in Figure D-54.

    Figure D-54 Operation Instances Tab

    Operation Instances tab
    Description of "Figure D-54 Operation Instances Tab"

    Notice that a new record for the event (department) is available.

  4. Click the Details link on the lower-right.

    A new browser window (Asynchronous Details) is displayed, as shown in Figure D-55.

    Figure D-55 Asynchronous Details

    New Browser Window (Asynchronous Details)
    Description of "Figure D-55 Asynchronous Details"

    Notice that the status of the transaction is DONE for the Publishing and Subscriber nodes.