Creating Transform Programs and Updating Service Operations

This chapter provides an overview of transform programs and discusses how to:

• Create a transform program.

• Update service operation routing.

Understanding Transform Programs

A transform program is a type of PeopleSoft Application Engine program. After you create a new transform application engine program, you add steps and actions to the program, and then add code to the steps and actions that performs data transformation and translation.

To develop a transform program, you must know the initial structure and possibly the content of the message with which you are working, as well as the structure (and content) of the result that you want to achieve.

You specify which transform program to apply within a routing definition for a service operation.

Transformation Programming Languages

You can use PeopleCode or Extensible Stylesheet Language Transformation (XSLT) as a programming language for creating transformation logic. XSLT is a recognized standard language that is well-suited to manipulating XML structures, so it is highly recommended for transformations.

PeopleSoft applications provide XSLT extension functions and PeopleCode APIs to perform value map lookups, deletes, and population.

Note. When programming using XSLT, you can manually code the XSLT or use the Oracle XSL Mapper to graphically associate records and fields. The Oracle XSL Mapper then automatically generates the XSLT code.

See PeopleTools: PeopleSoft Integration Broker PeopleBook, Applying Filtering, Transformation and Translation, Developing Transform Programs.

Creating a Transform Program

Create a new application engine program in Application Designer. On the toolbar, click the Properties button and select the Advanced tab.

The application engine program must be defined as program type Transform Only. Optionally, you can indicate the input and output message name and version. The input and output message name and version are required if you want to use the Oracle Graphical Mapper to create the XSLT for the transform program.

Note. Refer to PeopleTools: PeopleSoft Integration Broker PeopleBook, Applying Filtering, Transformation and Translation, Developing Transform Programs for details on creating a transform program using Oracle Graphical Mapper.

Refer to the chapter “Accessing Maps Using XSLT” for the syntax to use for your cross-references and domain value maps.

Note. Snippets of code are provided in the appendix, “Application Integration Framework Example.”

Updating Service Operation Routing

A routing definition contains routing parameters for each inbound request, inbound response, outbound request, and outbound response associated with a service operation. For each request or response, you define the routing alias, message names before and after transformation, and transformation program names.

Your transform program is invoked by PeopleSoft Integration Broker if you specify its name in the a routing definition for a service operation.

Adding Routing Parameters

To access the Routing Definition page to add routing parameters:

1. Select PeopleTools, Integration Broker, Integration Setup, Service Operations.

2. Select the Routings page.

3. Either click the link for an existing routing or add a new routing.

4. If it is a new routing, add the routing information.

5. Select the Parameters page.

If the application engine transform program includes the messages into and out of the transformation, the messages are automatically populated with these values. If the application engine program does not include the message names, enter the appropriate message names and save the page.

Note. For synchronous service operations, you can define transformation on both the outbound and inbound messages.

See PeopleTools: PeopleSoft Integration Broker PeopleBook, Managing Routing Definitions, Creating Routing Definitions.