Using the Transformation Test Utility

This chapter provides an overview of the Transformation Test utility, and discusses how to:

Click to jump to parent topicUnderstanding the Transformation Test Utility

PeopleSoft Integration Broker provides the Transformation Test utility, which you can use to test Application Engine transform programs without sending messages, and with minimal development effort. You use the Transformation Test component (IB_TRANSFORM_TEST) to access the utility.

The runtime Integration Broker messaging environment requires several development and administration activities to invoke an Application Engine transform program. At a minimum, you must define a queue, a service operation, sending PeopleCode, service operation handler, and routing including parameters for the transform program. However, because of its minimal requirements, the Transformation Test utility simplifies the process of testing and debugging your transform programs.

Click to jump to parent topicPrerequisites

If your transform program does not use codesets for data translation, you need only to develop the program and provide an XML DOM-compliant file that contains sample message data to be transformed.

If your transform program uses codesets, you must also define two nodes, their codeset groups, codesets, and codeset values that are invoked by the program.

Click to jump to parent topicRunning the Transformation Test Utility

Select PeopleTools, Integration Broker, Service Utilities, Transformation Test to access the Transformation Test page (IB_TRANSFORM_PAGE).

Note. The project name you specify identifies the test you’re applying, and is for your reference only. It has no significance outside of this utility.

Program Name

Select the name of the Application Engine transform program that you want to test.

Source Node

Enter the name of the node whose codeset group defines the structure of the input data. This field is used for codeset-based data translation.

Dest Node

Enter the name of the node whose codeset group defines the structure of the output data. This field is used for codeset-based data translation.

File Name

Enter the full path and name of the sample input message file.

This is the path on the application server machine or a path that can be accessed from the application server.

The file name may consist of up to 254 characters.

Transform

Click to apply the transform program to the sample input message.

Message Text

This field displays the output of the transform program.

Note. For the current release, even if you do not use codesets, you still must enter values for the Source Node and Dest Node fields. You don’t need to define any nodes; just enter a string that qualifies as a valid node name (for example “ANYNODE”).

Click to jump to parent topicRunning the Sample Transformation Test Project

PeopleSoft provides a sample project called PT_IBTRANSFORM_TEST that you can use to run a sample test with the Transformation Test utility.

To run the sample test:

  1. Select PeopleTools, Integration Broker, Utilities, Transform Utility.

  2. Select the PT_IBTRANSFORM_TEST project.

  3. In the File Name field, modify the value with your PS_HOME directory where indicated.

    Enter Your PS_HOME Path Here\sdk\pstransform\samples\TRANSFORMTST.xml

  4. Click the Transform button.

The test is successful when the following code appears in the Message Text box.

<?xml version="1.0"?>
<Success>Hello World!</Success>