Overview of the Oracle BI Metadata Web Service

Using the Oracle Business Intelligence Metadata Web Service 4-3

4.3.1.2 callProcedureWithResults Method

Use this method to call procedures that are expected to return a result set. This method returns an object that mimics the result set as a sequence of ResultsRow objects. Each ResultsRow contains one or more columns, and each column defines a type and value. If an error occurs, most stored procedures return at least one row with a single string column. Therefore, it is important to carefully check the returned results. Table 4–2 contains information about this method’s arguments.

4.3.2 Securing the Web Service

To properly secure the Web service, you must use Oracle Web Services Manager WSM. To call the Web service, you must configure your client code with the correct client side policy and provide security credentials for a user with permission to call the stored procedures.

4.3.2.1 Applying Policies

By default, the Web service is protected by the following predefined policy: oraclewss11_saml_token_with_message_protection_service_policy To successfully call the Web service, you must apply the following predefined policy in your client code: oraclewss11_saml_token_with_message_protection_client_policy For more information about WSM and how to apply and configure predefined policies, see Oracle Fusion Middleware Security and Administrators Guide for Web Services.

4.3.2.2 Configuring WSM

You must configure WSM before you can successfully use the Web service. The configuration for the Oracle BI Metadata Web Service and the Action Framework are identical. For information about configuring WSM to work with the Oracle BI Metadata Web Service, see Configuring Oracle Web Services Manager .

4.3.2.3 Configuring SAML

The policies that you applied in the Applying Policies step require you to configure SAML. This configuration will ensure that the proper authentication is performed by inserting the SAML token into the request. When the Web service attempts to connect to the Oracle BI Server, it uses the system user credentials and then impersonates the user found in the request’s SAML token. Table 4–2 callProcedure Method Arguments Argument Data Type Description procedureName String Name of the procedure to call. parameters List of parameters A sequence of parameter objects. Each parameter defines a type and value corresponding to the stored procedure arguments. Refer to the WSDL for the supported parameter types.