Understanding the Handler Tester Utility

The Handler Tester allows you to test handlers defined for rowset-based and nonrowset-based service operations from within the PeopleSoft Pure Internet Architecture. You can test handlers without setting up a routing, without having pub/sub booted on your application server, and without impacting other developer activity on the system.

To use the Handler Tester utility you should have a solid knowledge of Integration Broker messaging, as well as a knowledge of programming integration events and interpreting event results.

Warning! When you use the Handler Tester any PeopleCode associated with the handler is executed and production data is affected accordingly.

Consider the following points when using the Handler Tester utility:

  • The Handler Tester does not function with messages formatted with multiple level 0 records.

  • The Handler Tester does not re-initiate global variables between tests.

You can test the following integration events using the Handler Tester:

  • OnSend.

  • OnRequest.

  • OnRouteReceive.

  • OnRouteSend.

  • OnAckReceive.

  • OnNotify.

You can test application engine handlers only when the data used for the test is transaction data from the application database. (This is the DB Operation Transaction option when populating data.)

Otherwise the application handler will fail due to no transaction ID being available to the application engine program.

You cannot use the Handler Tester Utility to test bulk load handlers.

To test integration events using the Handler Tester:

  1. Select the service operation and version to use in the test.

  2. Select the handler type and handler name to test.

  3. Populate the message with data.

  4. If you are testing handler for a REST-based service operation, populate the document template with values.

  5. Run the test.

In addition to providing procedures for each step in the process, the documentation also describes how to save message data, clone and delete record structures, override connector properties, and view test results.