Setting Up Data for the PeopleSoft 8.1 Connectors Examples

This section describes setting up data for using the PeopleSoft 8.1 connector examples.

Setting Up Data on the PeopleSoft 8.55 System

To set up data on the PeopleSoft 8.55 system:

  1. In PeopleSoft Application Designer, create a new field called EXAMPLE_CHAR. This should be a mixed-case character field of size 20.

  2. Create a new record.

    1. Name the record EXAMPLE_REC.

    2. Add the EXAMPLE_CHAR field to this record, set it as the key, and save the definition.

    3. Build the physical table for this record.

  3. In the PeopleSoft Pure Internet Architecture, create a new message called EXAMPLE_PSFT_MSG with the version set to VERSION_1.

    1. Select the message type to be Rowset— Based.

    2. Add the EXAMPLE_REC record as the root record of this message.

  4. Add a new node, using the node name of the PeopleSoft 8.1 system. Verify that the Active Node box is checked, and save the record.

  5. Open the EXAMPLE_PAGE page and add an EditBox to the page, setting the following properties:

    Property Value

    Record name

    EXAMPLE_REC

    Field name

    EXAMPLE_CHAR

  6. Create a new service called PSFT81_SERVICE.

  7. Create a new service operation.

    1. Add a service operation of type asynchronous-one way to the PSFT81_SERVICE and name it PSFT81_SERVICE_OPR.

    2. Add EXAMPLE_PSFT_MSG as the message.

    3. Add EXAMPLE_QUEUE as the queue.

    4. Configure the service operation security for this service operation.

  8. Add an inbound routing for the PSFT81_SERVICE_OPR service operation with the source node being the 8.1 system and the destination being the 8.55 system.

  9. Add an outbound routing for the PSFT81_SERVICE_OPR service operation with the source node being the 8.55 system and the destination being 8.1 system.

  10. Open the EXAMPLE_WORKREC record. Add the following PeopleCode to the FieldChange event for the TEST field: 

    &message = CreateMessage(Operation.PSFT81_SERVICE_OPR);

/* get the buffer data */
&rowset = GetLevel0();

/* copy buffer data to the message */
&message.CopyRowset(&rowset);

/* send the message */
&message.Publish();

  11. Go to the connector information for the new node. Set the Connector ID to PSFT81TARGET. Set the URL property to the address of the gateway servlet on the PeopleSoft 8.1 system. For example: 

    http://<theServerNameAndPort>/servlets/gateway

Setting Up Data on the PeopleSoft 8.1 System

To set up data on the PeopleSoft 8.1 system:

  1. In PeopleSoft Application Designer, create a new field called EXAMPLE_CHAR. This should be a mixed-case character field of size 20.

  2. Create a new record.

    1. Name the record EXAMPLE_REC.

    2. Add the EXAMPLE_CHAR field to this record, set it as the key, and save the definition.

    3. Build the physical table for this record.

  3. Create a new message channel called EXAMPLE_CHANNEL. On the properties dialog box, set the Status to Run. Configure the security for the message monitor so that the channel can be displayed.

  4. Create a new message.

    1. Open the properties and select the Active box for the Status.

    2. Set the Message Channel to EXAMPLE_CHANNEL.

    3. Add the EXAMPLE_REC record to VERSION_1 of this message.

    4. Save the message as EXAMPLE_PSFT_MSG.

  5. Add the subscription ExampleSubscription to the EXAMPLE_PSFT_MSG. Use the following PeopleCode in the subscription body: 

    /* get the incoming message */
&msg = GetMessage();
&msgXML = &msg.GenXMLString();

/* and write it to a file */
&file = GetFile("PSFT81msg.txt", "w", "UTF8");
&file.writeString(&msgXML);
&file.close();

  6. Create a new message node, using the name of the PeopleSoft 8.55 node. Add a Location to this node with the following format: 

    http://<serverName:port>/PSIGW/PS81ListeningConnector

    The server name and port you specify must correspond to the integration gateway address of the PeopleSoft 8.55 system.

  7. Open the EXAMPLE_CHANNEL. Add a new routing rule to the channel, where the direction is Both and the message node name is that of the PeopleSoft 8.55 node.

  8. In the Message Monitor, invoke the Gateway Administration servlet and add the PeopleSoft 8.1 node to the PeopleSoft handler.

  9. Open the Message Monitor and verify that the EXAMPLE_CHANNEL is running.