Exporting Load Plans Exporting, Importing and Versioning Load Plans

15-2 Oracle Fusion Middleware Developers Guide for Oracle Data Integrator Figure 15–1 Web Services in Action It shows a simple example with the Data Services, Run-Time Web services Public Web Service and Agent Web Service and the OdiInvokeWebService tool. The Data Services and Run-Time Web Services components are invoked by a third-party application, whereas the OdiInvokeWebService tool invokes a third-party Web service: ■ The Data Services provides access to data in data stores both source and target data stores, as well as changes trapped by the Changed Data Capture framework. This web service is generated by Oracle Data Integrator and deployed in a Java EE application server. ■ The Public Web Service connects to the repository to retrieve a list of context and scenarios. This web service is deployed in a Java EE application server. ■ The Agent Web Service commands the Oracle Data Integrator Agent to start and monitor a scenario and to restart a session. Note that this web service is built-in the Java EE or Standalone Agent. ■ The OdiInvokeWebService tool is used in a package and invokes a specific operation on a port of the third-party Web service, for example to trigger a BPEL process. Oracle Data Integrator Run-Time Web services and Data Services are two different types of Web services. Oracle Data Integrator Run-Time Web services enable you to access the Oracle Data Integrator features through Web services, whereas the Data Services are generated by Oracle Data Integrator to give you access to your data through Web services.

15.2 Data Services

Data Services are specialized Web Services that provide access to data in datastores, and to changes captured for these datastores using Changed Data Capture. These Web Services are automatically generated by Oracle Data Integrator and deployed to a Web Services container in an application server. For more information on how to set up, generate and deploy Data Services refer to Chapter 8, Working with Data Services . Working with Web Services in Oracle Data Integrator 15-3

15.3 Oracle Data Integrator Run-Time Services

Oracle Data Integrator Run-Time Services are web services that enable users to leverage Oracle Data Integrator features in a service-oriented architecture SOA. These web services are invoked by a third-party application manage start scenarios developed with Oracle Data Integrator. How to perform the different ODI execution tasks with the ODI Run-Time Services such as executing a scenario, restarting a session, listing execution contexts and scenarios is detailed in Section 20.11, Managing Executions Using Web Services . Section 20.11 also provides examples of SOAP requests and responses.

15.4 Invoking Third-Party Web Services

This section describes how to invoke third-party web services in Oracle Data Integrator. This section includes the following topics: ■ Section 15.4.1, Introduction to Web Service Invocation ■ Section 15.4.2, Using the OdiInvokeWebService Tool ■ Section 15.4.3, Web Service Invocation in Integration Flows

15.4.1 Introduction to Web Service Invocation

Web Services can be invoked: ■ In Oracle Data Integrator packages or procedures using the OdiInvokeWebService tool: This tool allows you to invoke any third party web service, and save the response in a XML file that can be processed with Oracle Data Integrator. ■ For testing Data Services: The easiest way to test whether your generated data services are running correctly is to use the graphical interface of the OdiInvokeWebService tool. See Section 15.4.2, Using the OdiInvokeWebService Tool for more information.

15.4.2 Using the OdiInvokeWebService Tool

The OdiInvokeWebService tool invokes a web service using the HTTP or HTTPS protocol and is able to write the returned response to an XML file, which can be an XML payload or a full-formed SOAP message including a SOAP header and body. The OdiInvokeWebService tool invokes a specific operation on a port of a web service whose description file WSDL URL is provided. If this operation requires a SOAP request, it is provided either in a request file or in the tool command. The response of the web service request is written to an XML file that can be used in Oracle Data Integrator. How to create a web service request is detailed in Section 15.4.3, Web Service Invocation in Integration Flows . Note: If the web service operation is one-way and does not return any response, no response file is generated.