Introduction to Web Services in Oracle Data Integrator

Working with Web Services in Oracle Data Integrator 15-5 Table 15–1 Advanced Editor Sections Section Icon Name Location in Figure Description Web Service Description File WSDL URL top Enter here the WSDL location Port left The port of the web service is set by default. If more than one port is available for the web service, select the appropriate port. Invoke Web Service toolbar icon Invokes immediately the current Web Service, displaying the response in the SOAP editor. Switch Panel Position toolbar icon Tiles vertically or horizontally the SOAP editor. Export Response XSD toolbar icon Saves the current response XML schema description to a file. Restore Default Request toolbar icon Discards the current request and reverts to a default, blank request structure. Delete Empty Optional Components toolbar icon Removes all blank optional elements from the query. This may be necessary to construct a valid query. Clean up before execution toolbar icon Automatically deletes empty optional elements in the SOAP request when Invoke Web Service is clicked. This checkbox has no effect on package steps at run-time. Use Request File toolbar icon Uses a SOAP request stored in a file instead of the parameters specified in the SOAP editor. Timeout ms toolbar icon Specifies a maximum period of time to wait for the request to be complete. Operation The list of operations for the selected port. Options The HTTP request options: ■ Timeout : The web service request waits for a reply for this time before considering that the server will not provide a response and an error is produced. ■ HTTP Authentication: If you check this box, you should provide a user and password to authenticate on your HTTP server. SOAP Editor middle and right Displays the web service request on the left pane in the SOAP Editor or Source tab and the SOAP response on the right pane. 15-6 Oracle Fusion Middleware Developers Guide for Oracle Data Integrator SOAP Editor The SOAP Editor allows you to graphically build the XML request for the web service and display the response. If creating an OdiInvokeWebService step, this SOAP request filled in the SOAP editor is saved with the step. The left part of the editor shows the structure of the request, the right part shows the structure of the response. This arrangement can be changed clicking Switch Panel Position . The request is displayed either in a hierarchical editor view SOAP Editor tab, or in XML format Source tab. When using the SOAP Editor tab, it is only possible to edit the body of the SOAP envelope. To edit or view the whole envelope, including the SOAP headers, you must use the Source tab. In the Editor, you can fill in the value and optionally the attributes for each element of your request. Optional elements are displayed in italic. Repeatable elements are labelled with ...n after the name. Right-click any element to perform one of the following operations, if possible: ■ Duplicate content - copies the structure and content of the element. ■ Duplicate structure - copies the structure but leaves all fields blank. ■ Delete - deletes the element. ■ Export Request - exports the entire soap request to an XML file. Results This part of the interface appears only when using an OdiInvokeWebService tool step in a package, to control how the response is written to a XML file. Figure 15–3 Result Section for the OdiInvokeWebService tool This image shows the additional parameters that are displayed when an OdiInvokeWebService tool step is used in a package. ■ File Mode -RESPONSE_MODE: One of NEW_FILE, FILE_APPEND, NO_FILE ■ Result File -RESPONSE_FILE: The name of the result file to write. ■ Result File Format -RESPONSE_FILE_FORMAT: The format of the web service response file. Possible values are XML default and SOAP. WARNING: An empty element is passed as is to the Web service. For strings, this corresponds to an empty string. For numbers or date types, this may cause an error. If you want to send a null string, number or date, it is recommended to use the nil=trueattribute. To remove empty elements, click Remove blank optional elements in the Advanced editor toolbar.