Creating an Input Form and Report on a Web Service

The Create Form and Report on Web Service Wizard creates an input form, a submit button, and a report for displaying results. You can execute this wizard directly after creating the Web service reference, or by adding a new page.

Use this wizard when you expect a nonscalar result from the Web service. The Amazon Web service is a good example. This Web service returns many results based on the search criteria entered in an input form.

Creating a Form and Report After Creating a Reference

To create a form and report after creating a Web Service Reference:

Create the Web service reference. See "Creating a Web Service Reference".
After the Web service reference has been added, select Create Form and Report on Web Service.
For Web Service Reference and Operation, select the Web service reference and operation (that is, the method to be executed).
For Identify Page and Region Attributes, review the page and region attributes. If the page you specify does not exist, the wizard creates the page for you.
For Items for Input Parameters:
1. Identify which items to add to the form. To include an item, select Yes in the Create column. Otherwise, select No.
2. If necessary, edit the item label.
For Base Node:
1. In Temporary Result Set Name, enter a name for the collection that stores the Web service result.
2. For Result Tree to Report On, select the portion of the resulting XML document that contains the information you want to include in the report.
For Result Parameters to Display, select the parameters to be included in the report.
Click Finish.

Creating a Form and Report by Adding a New Page

If you have an existing Web service reference, you can create an input form and report by adding a new page.

To create a form and report by adding a new page:

Create the Web service reference. See "Creating a Web Service Reference".
Create a new page. See "Adding Pages to an Application".

In the Create Page Wizard:
1. Select Form.
2. Select Form and Report on Web Service.
For Web Service Reference and Operation, select the Web service reference and operation (that is, the method to be executed).
For Identify Page and Region Attributes, review the page and region attributes. If the page you specify does not exist, the wizard creates the page for you.
For Items for Input Parameters:
1. Identify which items to add to the form. To include an item, select Yes in the Create column. Otherwise, select No.
2. If necessary, edit the item label.
For Base Node:
1. In Temporary Result Set Name, enter a name for the collection that stores the Web service result.
2. In Result Tree to Report On, select the portion of the resulting XML document that contains the information you want to include in the report.
For Result Parameters to Display, select the parameters to be included in the report.
Click Finish.