Running Handler Tests and Viewing Test Results

This section discusses how to:

  • Execute event tests.

  • View test results.

After you have set up the integration metadata and selected the handler to test, you can run the handler test.

To run a handler test, on the Handler Tester page, click the Execute Event button.

The Handler Tester returns test results on the Returned Message/Result section of the Handler Tester page and in the Returned IB Info page.

Viewing Results in the Return Message/Results Section

The following table lists the results the Handler Tester returns in the Return Message/Results section on the Handler Tester page:

Event

Returns

Return Value

OnNotify

String.

The return values are:

  • Done.

  • Exit(1).

OnSend

Message structure.

Tree or XML.

OnRequest

Message structure or string.

If OnRequest code runs to completion, the message structure or tree is returned.

If there is a user thrown exception, an exception string is returned.

OnRouteReceive

Boolean.

The return values are:

  • Inbound message is accepted.

  • Inbound message is rejected.

OnRouteSend

String.

The return values are:

  • Outbound message target node list is accepted.

  • Outbound message target node list is rejected.

  • Outbound message sent to the following node(s) — <node_name>, <node_name>, <node_name>

OnAckReceive

String.

The return values are:

  • Error.

  • Done.

  • Retry.

Component Interface type on a synchronous service operation.

Message structure.

Tree or XML.

Component Interface type on an asynchronous service operation.

String.

String returned by the handler.

Deprecated PeopleCode handler On Request.

Message structure.

Tree or XML.

Deprecated PeopleCode handler OnNotify.

String.

The return values are:

  • Done.

  • Exit(1).

A reply message displays for the OnRequest and OnSend events. If the reply message is rowset-based, it displays in a tree format to the right of the Input Message section. If the returned message is nonrowset-based, a display-only edit box will display with its contents.

Viewing Results in the Returned IB Info Page

If you specified target connector properties, you can view returned IBInfo information. To do so, on the Handler Tester page, click the View Returned IB Info Values link.

Depending on the input values for an event test and the PeopleCode content, some or all of the fields contain test data.

The fields on that display on this page are described earlier in the Handler Tester documentation.

See Specifying Target Connectors and Target Connector Properties.