1. Oracle WebCenter Portal Online Help
  2. Online Help Topics for Shared Assets
  3. Assets
  4. Data Controls
  5. Create New/Edit Data Control wizard

Create New/Edit Data Control wizard

Use the Create New (or Edit) Data Control wizard to create (or edit) a data control that retrieves data from a web service that is accessed using standard protocols, such as SOAP and HTTP..

To create or edit a web service data control:

  1. In the WSDL URL field, enter the location of the web service's WSDL file, for example: 

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

  2. If the web service is on the other side of a firewall from your portal, use the Host and Port fields to configure proxy authentication.

    To ensure a secure connection to the web service, you must first configure your application to use proxy authentication.

    Tip:

    • If a central WebCenter Portal proxy (or RSS proxy) is already configured, then the proxy fields are automatically populated with that proxy host name and port number. You can modify the proxy details or clear the fields if you do not want to configure the proxy.

      Changing the WebCenter Portal central proxy does not change the proxy settings against the web service data control. However, changing the web service data control proxy setting changes the WebCenter Portal central proxy setting.

    • If a Web Logic Domain proxy is already configured, and if you choose not to set a proxy while creating or editing the web service data control, then the Web Logic Domain proxy is used as the default setting.

  3. If you are connecting to a secured web service, then enter the Username and Password to access the web service endpoint.

    Tip:

    If access to the WSDL itself is secured, then you cannot connect to the web service from the Create New Data Control page. To work around this limitation, access the WSDL in a browser by specifying the user name and password, download the WSDL page, save it locally as a .wsdl document, then specify the path to this document in the WSDL URL field.

  4. Click Show Methods to establish a connection to the web service using the specified WSDL and display the methods available for the web service.

  5. From the Service drop-down list, select the service to use for the data control.

  6. From the Port drop-down list, select one of the available ports.

    The Methods field displays 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.

  7. If the web service is secured using OWSM, use the fields in the Oracle Web Service Manager Security Policies section to specify the policies to use, as described in the following table.

    Table 3-2 OWSM Security Information

    Name Description

    MTOM

    The MOTM (message transmission optimization mechanism) policy you want to use.

    Reliability

    The reliability policy you want to use.

    Addressing

    The addressing policy you want to use.

    Security

    Any additional security policies you want to apply.

    For example, if your web service is secured using a policy named mycompany/wss_username_token_service_policy, populate the Security field with the client policy, which is mycompany/wss_username_token_service_policy.

  8. You can override properties on the Security policy that you specified in the previous step. Use the Add Property and Remove Property buttons to add or remove entries in the Override OWSM Policy Properties table.

    Tip:

    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.

    For example, if you specified a Security policy, mycompany/wss_username_token_client_policy, and the policy has a csf-key property, then in the override section, click Add Property to add a value for csf-key. Note that this key must exist in the configured keystore.

  9. To set values for a method's parameters, select the method and click Next.

    A web service may expose scalar and complex parameters that control the data displayed by the data control.

    For each parameter:

    Tip:

    For complex parameters, you must first expand the parameter to display the scalar values that make up the parameter.

    1. In the Display Name field, enter a user-friendly name for the parameter.

      This name is displayed to users when they consume the data control in a task flow.

    2. In the Tooltip Text field, enter a brief description of the parameter.

      This provides users with assistance in determining the purpose of the parameter.

    3. Select Show to User to display the parameter to users when they consume the data control in a task flow.

    Note:

    You can specify values for exposed parameters only while consuming the data control in a task flow.

  10. Click Create.