PeopleTools 8.51 PeopleBook: Integration Broker Testing Utilities and Tools

Getting Started with PeopleSoft Integration Testing Utilities and Tools

This chapter discusses implementing utilities and tools for testing integrations.

PeopleSoft Integration Testing Utilities and Tools Overview

This PeopleBook describes the following integration testing utilities and tools:

Send Master utility	The Send Master utility enables you to test PeopleSoft Integration Broker messaging interactions with PeopleSoft and third-party web servers, application servers, and integration gateways. It can test listening connector functionality, target connector functionality, connector introspection and transactions. Send Master enables you to post any data format, including the PeopleSoft Multipurpose Internet Mail Extensions (MIME) message format, to web and application servers over HTTP and HTTPS. You can also use Send Master to simultaneously test groups of different types of messages, as well as to stress test your system. Send Master also enables you to perform Get functions and ping application messaging gateways and third-party servers.
Simple Post utility	The Simple Post utility enables you to use shell scripts or a Java API to post XML messages from third-party systems to the integration gateway. The utility wraps the incoming messages in the PeopleSoft XML wrapper format and posts them to the HTTP listening connector. The Simple Post utility reads ASCII, UTF-8 and UTF-16 file formats for incoming messages and converts them to UTF-8 format to send to the integration gateway.
Integration point test automation tools	PeopleSoft provides a means for automated integration point testing. You can use automated integration point testing to unit test, perform cross-application business process testing, or regression test integration points. Automated integration point testing is suitable for testing integration points between different PeopleSoft systems, between PeopleSoft systems and third-party systems, and between PeopleSoft systems and open interfaces. You can use automated integration point testing with the following PeopleSoft integration technologies: Service operations, including synchronous and asynchronous. Component interfaces. Flat files. Staging tables.
Handler Tester utility	The Handler Tester enables you to test handlers by populating a service operation and executing the handler.
Transformation Test utility	PeopleSoft Integration Broker provides the Transform Test utility, which you can use to test Application Engine transform programs without sending messages and with minimal development effort.
Schema Tester utility	The Schema Tester utility enables you to validate rowset-based and nonrowset-based messages in a service operation to determine if the messages adhere to defined message schemas.
Generate SOAP Template utility	The Generate SOAP Template allows you to generate a SOAP template for any service for which WSDL has been generated.
Service Operation Tester utility	The Service Operation Tester utility enables you to invoke a service operation.

PeopleSoft Integration Testing Utilities and Tools Implementation

The utilities and tools discussed in this PeopleBook are automatically installed with PeopleTools. Review the information provided in this section for additional requirements, prerequisites and considerations.

Implementing the Send Master Utility

To use the Send Master utility you should have an basic understanding PeopleSoft Integration Broker fundamentals, including:

Integration gateway functionality.
Target and listening connectors.
Integration messaging formats.
- Extensible Markup Language (XML).
- Multipurpose Internet Mail Extensions (MIME).

Prior to using the Send Master utility, verify that the following are set up:

Integration gateway, including security and logging settings.
Integration metadata, including:
- Messages.
- Nodes.
- Services.
- Service operations.

Implementing the Simple Post Utility

To use the Simple Post utility, you should understand the same Integration Broker fundamentals that are described in the previous section, Implementing the Send Master Utility. You should also verify that the integration gateway is set up, as well as integration metadata.

Implementing the Handler Tester

To use the handler tester, you will need to have handlers created and defined for the service operation.

Implementing the Transformation Test Utility

PeopleSoft provides a sample project, called PT_IBTRANSFORM_TEST, which you can use to run a sample test using the utility. You can also use the utility to test transformation programs that you have developed.

Implementing the Schema Tester Utility

To use the Schema Tester Utility the following items must exist:

A message schema against which to test a message.

The message schema can be built when you create the message or you can use the Message Schema Builder to build message schemas.
A message in XML format to test against a schema.

In addition, to test a schema you must specify the integration gateway must be configured and the default application server must be configured.

Implementing the Generate SOAP Template Utility

To use the Generate SOAP Template Utility the following items must exist:

Message schemas for all messages used in the service operation.
The service operation contains an any-to-local routing.
The WSDL for the service operation has been written to the WSDL Repository using Provide Web Services.

Implementing the Service Operation Tester Utility

To use the Service Operation Tester utility you must have a service operation created.

Other Sources of Information

In addition to implementation considerations presented in this section, take advantage of all PeopleSoft sources of information, including the installation guides, release notes, and PeopleBooks, including:

PeopleTools 8.51 PeopleBook: PeopleSoft Integration Broker
PeopleTools 8.51 PeopleBook: PeopleSoft Integration Broker Administration
PeopleTools 8.51 PeopleBook: Integration Broker Service Operations Monitor