Web Services Guide

Anterior Siguiente

How to Handle Request and Response Messages in XML Format

You have an XML file that contains an element hierarchy that you want to use to create the request message that the REST Web Service Consumer transformation sends to a web service. The XML file includes data that you can use to identify a person at your organization such as their ID, name, e-mail, and country. These elements might appear in the XML file in the following way:

<Person><ID>sample</ID><Name>sample</Name><Email>sample</Email><Country>sample</Country></Person>

You have another XML file that contains an element hierarchy that you want to use to create the response message. The XML file includes data on the type of greeting that you want to use to address each person. The greeting includes data on the individual's ID and the greeting content. These elements might appear in the XML file in the following way:

<Greeting><ID>sample</ID><Content>sample</Content></Person>

To use the element hierarchy in these XML files in a REST Web Service Consumer transformation, first import the XML files as schema objects in the Developer tool, then use the schema objects to define the method input and the method output when you create the REST Web Service Consumer transformation.

How to Use a Schema to Create a REST Web Service Consumer Transformation

Step 1. Create Schemas from the XML Files.

Complete the following steps to create a schema object for the method input. Repeat these steps to create a schema object for the method output.

In the Developer tool, click

File > New > Schema

to open the schema wizard.

Select

Create from sample file

Click

Browse

Navigate to the XML file and click

Open

Enter a name for the schema and verify the project location. If required, browse to a new location.

This dialog box shows the New schema wizard. The option Create from sample file is selected.

Click

to view the schema elements.

This screenshot shows a preview of the schema object. You can see the parent element, Person, and the type, PersonType.

Click Finish.

You can use the schema object that you created to define the method input in the transformation.

Repeat steps 1-7 to create a schema object for the method output.

Step 2. Create the REST Web Service Consumer Transformation.

Create the transformation. Use the schemas to define the method input and method output.

In the Developer tool mapping editor, scroll down in the mapping palette to locate the REST Web Service Consumer transformation and drag it into the mapping.

Enter a name for the transformation.

Select an HTTP method. For this example, select the HTTP method Post.