Create New/Edit Data Control

Use the Create New Data Control wizard to create a data control that retrieves data from a web service. More

The Create New Data Control page is arranged in the following pages:

Use the Edit Data Control page to edit the properties of an existing web service data control.

The Edit Data Control page has just a single page:

Web Service Data Control Information

Web Service Data Control Information

The Web Service Data Controls Information page enables you to identify the web service to use for the data control.

Enter the Web Service WSDL URL

The Enter the Web Service WSDL URL section enables you to specify the location of the web service WSDL file.

Element	Description
WSDL URL	Enter URL of the WSDL to the Web Service data source, for example: http://www.example.com/exampleservice/example.asmx?wsdl Note: You cannot edit the WSDL of the web service when you are editing the data control.

Element

Description

WSDL URL

Enter URL of the WSDL to the Web Service data source, for example:

http://www.example.com/exampleservice/example.asmx?wsdl

Note: You cannot edit the WSDL of the web service when you are editing the data control.

Proxy Information

The Proxy Information section enables you to provide information about the proxy server to use if the web service is on the other side of a firewall.

Element	Description
Host	Enter the address for the proxy server, if the web service is on the other side of a firewall.
Port	Enter the port number on which the proxy server listens.

HTTP Basic Authentication Details

The HTTP Basic Authentication Details section enables you to provide authentication information for the proxy server.

Element	Description
Username	Enter the user name to use for accessing the data control. This is useful for restricting access to the data control.
Password	Specify a password for the user name.

Methods

The Methods section provides a list of methods available for the web service.

Note: You cannot change the selected method when you are editing the data control.

Element	Description
Show Methods	Click to establish the connection to the web service whose WSDL you specified and display the methods available for the specified web service.
Service	Select the service to use for the data control.
Port	Select the port to use for the data control.
Methods	Lists the methods available for the specified web service. All methods under the selected port are added to the data control. These methods are later available for selection in the resource catalog.

Oracle Web Service Manager Security Policies

The Oracle Web Service Manager Security Policies section enables you to specify security information.

Element	Description
MTOM	Specify the MTOM (message transmission optimization mechanism) policy you want to use.
Reliability	Specify the reliability policy you want to use.
Addressing	Specify the addressing policy you want to use.
Security	Specify any additional security policies you want to apply.
Override OWSM Policy Properties	If additional security policies were defined for the Web Service, click to override properties on those policies. Use the Name and Value fields to specify property values. Override properties are defined by the policy. Therefore, to perform this step, you must know the policy being used and the properties that you can override. The properties you specify here must exist in configured keystore.
Add	Click to add a new row to the Override OWSM Policy Properties section.
Delete	Click to delete the row from the Override OWSM Policy Properties section.

Parameters

The Parameters page of the Create New Data Control dialog enables you to specify details for the parameters exposed for each method.

A web service may expose scalar parameters (which specify string or EL values to display data) and complex parameters (which take objects as parameters) that control the data displayed in the data control.

Note: You cannot change the parameter settings when editing a data control.

Element	Description
Parameter Name	Displays the name of the parameter. For complex parameters, expand the parameter to display the scalar values that make up the parameter.
Value	Displays the data type of the parameter.
Display Name	Enter a user-friendly name for the parameter. This name is displayed to users when they consume the data control in a page or task flow.
Tooltip Text	Enter a brief description of the parameter. This provides users with assistance in determining the purpose of the parameter.
Show to User	Select to display the parameter to users when they create a visualization based on this data control in a task flow.