Populating Message Data

This section describes how to populate message data in the Service Operation Tester utility. This section discusses how to:

  • Manually enter XML to populate message data.

  • Upload XML from files to populate message data.

  • Manually enter field values to populate message data, including PSCAMA record values and audit actions.

  • Populate rowset-based message parts in container messages.

You can load message data into a message definition from the following sources.

  1. XML that manually enter.

  2. XML that you upload from a file.

  3. Field values that you manually enter, including PSCAMA record values and audit actions.

This section describes how to:

  • Manually enter XML data into rowset-based message definitions.

  • Manually enter XML data into nonrowset-based message definitions.

Manually Entering XML Data into Rowset-Based Message Definitions

When you manually enter XML data into a rowset-based message, the tree view is not available. To work with message data in the tree view, you must manually populate field values.

To manually populate a rowset-based message definition:

  1. Access the Enter XML page.

    1. Select PeopleTools > Integration Broker > Service Utilities > Service Operation Tester.

      The Service Operation Tester page appears.

    2. Click the Provide XML button.

      The Enter XML page appears.

  2. In the XML text box enter XML to populate the message definition.

  3. Click the OK button.

    The Service Operation page appears and the XML you entered displays in the Input Message box.

Manually Entering XML Data into Nonrowset-Based Message Definitions

To manually populate a nonrowset-based message definition, on the Service Operation page, enter XML directly into the Input Message box.

To access the Input Message box, select PeopleTools > Integration Broker > Service Utilities > Service Operation Tester.

Note that you can also click the Provided XML button and enter XML in the XML text box for a nonrowset-based message definition.

This section describes how to upload XML data from files to populate rowset-based and nonrowset-based message definitions.

Prerequisites for Uploading XML Data from Files

To successfully upload files into the Handler Tester you must set the PS_FILEDIR and PS_SERVIDR environment variables.

See Understanding Setting PS_FILEDIR and PS_SERVDIR Environment Variables.

Uploading XML Data from Files

To upload XML data from a file to populate message definition data:

  1. Access the Enter XML page. (PeopleTools > Integration Broker > Service Utilities > Service Operation Tester. Click the Provide XML button.).

  2. From the File Encoding drop-down list, select the file encoding of the file you are uploading. The options are:

    • Non-encoded.

    • UTF-8.

    • UTF-16.

  3. Click the Upload XML from File button.

  4. Click the Browse button to locate the XML file to upload.

  5. Click the Upload button.

  6. Click the OK button to return to the Service Operation page.

This section discusses how to:

  • Manually enter message definition field values.

  • Assign PSCAMA record values and audit actions to Level 0 records.

  • Assign PSCAMA audit actions to Level 1 and greater records.

Understanding Manually Entering Field Values

After you specify a service operation and version for a rowset-based message, the Handler Tester displays the message definition record and field structure in a tree format.

You can populate the message definition by manually entering values for fields.

In addition you can specify PSCAMA record values and audit actions for Level 0 records, as well as PSCAMA audit actions for Level 1 and greater records.

Understanding Assigning PSCAMA Record Values and Audit Actions

For service operations that contain rowset-based messages, the Service Operation Tester enables you to populate PSCAMA record values at Level 0 and PSCAMA audit action options at every other level of the rowset, based on the message definition.

Manually Entering Message Definition Field Values

To manually enter field value data:

  1. Access the Service Operation Tester page (PeopleTools > Integration Broker > Service Utilities > Service Operation Tester.).

  2. In the tree structure for the message definition, single-click on field name to populate.

    A dialog box for the field opens that displays field length and field type information as a guide for entering values.

  3. Enter a value for the field.

  4. Click the OK button.

Values you enter display after the field name in the tree view. The tree shows the first 30 characters of an entered value; however, the entire field value is stored.

See Saving Message Data.

Assigning PSCAMA Values and Audit Actions to Level 0 Records

To assign PSCAMA values and audit actions to Level 0 records:

  1. Access the Service Operation Tester page (PeopleTools > Integration Broker > Service Utilities > Service Operation Tester.).

  2. Populate the service operation with a rowset-based message.

    See Populating Message Data.

  3. In the tree view, click the Level 0 record.

    The Select an Action page appears.

  4. Click the Assign PSCAMA arrow to expand the section.

  5. Enter PSCAMA values as appropriate.

    Descriptions of the PSCAMA field values and audit actions are described elsewhere in the PeopleTools product documentation.

    See PSCAMA.

  6. Click the OK button.

Assigning PSCAMA Audit Actions to Level 1 and Greater Records

To assign PSCAMA audit actions to Level 1 and greater records:

  1. Access the Service Operation Tester page (PeopleTools > Integration Broker > Service Utilities > Service Operation Tester.).

  2. Populate the service operation with a rowset-based message.

    See Populating Message Data.

  3. In the tree view, click a Level 1 or greater record.

    The Select an Action page appears.

  4. Click the Assign PSCAMA arrow to expand the section.

  5. From the Action field, section the appropriate audit action.

    Descriptions of PSCAMA audit actions are described elsewhere in the PeopleTools product documentation.

    See PSCAMA.

  6. Click the OK button.