What Happens When This Action Type is Invoked?

5-22 Oracle Fusion Middleware Integrators Guide for Oracle Business Intelligence Enterprise Edition

5.6.4 Invoke a Web Service

This action type allows users to browse for target Web Services operations and then create an action to invoke the selected content. For information about how Action Framework supports calls to Web Services, see Section 5.6.5, Supported Functionality for Calling Web Services . For more information about creating this action type in Presentation Services, see Working with Actions in Oracle Fusion Middleware Users Guide for Oracle Business Intelligence Enterprise Edition.

5.6.4.1 Prerequisites for This Action Type

In order for the Action Framework to provide this action type and before a user can create an Invoke a Web Services action, you must have performed the following tasks: ■ Confirmed that a target Web service with a URL to the WSDL for that Web service exists. ■ If you want to allow users to browse for Web Services, you must have added a WSIL document that points to one or more WSDL documents. The WSIL document must be accessible via a URL. For more information, see Section 5.6.4.2, Example of a WSIL Document . ■ If you want to browse to Web Services operations or apply security policies, you must have modified the configuration file’s registry element so that it references the target WSIL document. For information about this required configuration, see Section 5.3.2.3, Invoke a Web Service Action Type Registry Example . ■ Confirmed whether you need to add credentials to the credential store to invoke Web Services. If the target Web service is secured, appropriate configuration needs to be added to pass credentials to the Web service operation when it is invoked. A suitable keystore might also be required. For more information, see Section 5.4.1, Oracle BI EE Credentials , Section 5.5, Adding and Maintaining Credentials for Use With the Action Framework , and Section 5.5.2, Creating a Default Keystore .

5.6.4.2 Example of a WSIL Document

WSIL defines an XML format for referencing Web service descriptions. These references are contained in a WSIL document and refer to Web service descriptions for example, WSDL files and to other aggregations of Web Services for example, another WSIL document or a UDDI registry. Note the following WSIL example: ?xml version=1.0 encoding=UTF-8? inspection xmlns=http:schemas.xmlsoap.orgws200110inspection service abstractWeb Service: Order Servicesabstract nameOrder Servicename description referencedNamespace=http:schemas.xmlsoap.org wsdllocation=http:localhost:9704ActionSamples OrderProcessPort?wsdl service inspection

5.6.4.3 Troubleshooting Actions to Invoke a Web Service

Use the following list to troubleshoot actions to Invoke a Web Service. 1. Confirm that you can invoke the target Web service from a test client such as the HTTP Analyzer in JDeveloper. Using Actions to Integrate Oracle BI EE with External Systems 5-23 2. If the target Web service has a security policy, check the ActionFrameworkConfig.xml file to make sure that the Action Execution Service AES is using the appropriate client policy. 3. Go to Oracle Enterprise Manager to check the logs and diagnostics for Action Services. To access the log files, go to the Enterprise Manager, access the Business Intelligence navigation tree, and select coreapplications to display information about the Oracle BI instance. Select the Diagnostics tab and select the Log Messages sub tab. In the ViewSearch Log Files area, click Action Services log. You can enable verbose logging for Weblogic by adding the following entries to the JAVA_OPTIONS variable in the startWebLogic.cmd.sh file. After you have modified the JAVA_OPTIONS variable, you must restart Weblogic. -Dweblogic.wsee.verbose= -Dweblogic.log.RedirectStdoutToServerLogEnabled=true - Dweblogic.webservice.client.verbose=true 4. Check the ActionFrameworkConfig.xml file for mistakes or omissions. 5. Thoroughly check any associated policy files and make sure they are in the correct location. 6. If the target Web service applies a security policy that includes either message protection or encryption, thoroughly check the additional OWSM credentials in the Credential Store. 5.6.4.4 What Happens When This Action Type is Invoked? Figure 5–2, Invoking a Web Service Process Flow illustrates the Web Service action type’s process flow.