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 from a WSDL, 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 Based on a WSDL".
After the Web service reference has been added, select Create Form and Report on Web Service.
For Choose Service and Operation:
1. Web Service Reference - Select the Web service reference.
2. Operation - Select the method to be executed.
For Page and Region Attributes, review the displayed attributes. If the page you specify does not exist, the wizard creates the page for you.
For Input Items:
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.
If applicable, specify the Item Names and Item Labels for basic authentication. Note that this step only appears if basic authentication was specified for this Web service reference when it was created.
For Window Service Results:
1. Temporary Result Set Name - Enter a name for the collection that stores the Web service result.
2. 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 Based on a WSDL".
Create a new page. See "Managing Pages in an Application".

In the Create Page Wizard:
1. Select Form.
2. Select Form and Report on Web Service.
For Choose Service and Operation:
1. Web Service Reference - Select the Web service reference.
2. Operation - Select the method to be executed.
For 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 Input Items:
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.
If applicable, specify the Item Names and Item Labels for basic authentication. Note that this step only appears if basic authentication was specified for this Web service reference when it was created.
Follow the on-screen instructions.
Click Finish.