Using a Key with Non-JSP Reports

19-2 Publishing Reports to the Web with Oracle Reports Services Oracle Forms is a rapid application development RAD tool, used to build highly scalable Internet database applications. Integrating the Oracle Reports technology into custom applications, especially Java applications, requires the implementation of the mechanisms used by rwservlet, rwcgi, rwclient, and Oracle Forms to submit jobs to the server from within those applications. The RWWebService servlet provides the necessary public interfaces and bindings, and is required to be exposed and to function as a Web service. This functionality enables any application developer to include Oracle Reports in their application.

19.2 Getting Started

This section outlines the steps necessary for: ■ Invoking the RWWebService Servlet ■ Viewing the WSDL

19.2.1 Invoking the RWWebService Servlet

To invoke the RWWebService servlet:

1. Start a Oracle WebLogic Server instance, where the Oracle Reports instance

resides.

2. Enter the following URL in the address field of your browser:

http:yourwebserver:portreportsrwwebservice This takes you to the RWWebService endpoint. The RWWebService endpoint page enables you to do the following:

a. View the Oracle Reports Web service WSDL.

b. Run any RWWebService command using a Web based UI.

19.2.2 Viewing the WSDL

The Web Service Description Language WSDL is an XML format for describing available services as a set of endpoints operating on messages containing either document-oriented or procedure-oriented information. The operations and messages are described abstractly, and then bound to a concrete network protocol and message format to define an endpoint.

1. Click the WSDL link on the RWWebService Web page to view the Oracle Reports

Web services WSDL document. 2. The last entry in the WSDL is the service description and contains the location of the WebService: soap:address location=http:yourwebserver:8888reportsrwwebservice Note: Oracle Reports Web service does not support dynamic discovery of the WSDL by publishing to the Universal Description, Discovery, and Integration UDDI server. Note: Use Internet Explorer to view the WSDL XML output. Using the Oracle Reports Web Service 19-3 Figure 19–1 Viewing the WSDL Ensure that the URL and port number defined, http:yourwebserver:portreportsrwwebservice, is correct. Oracle Reports WSDL ?xml version=1.0 encoding=UTF-8? -- Published by JAX-WS RI at http:jax-ws.dev.java.net. RIs version is Oracle JAX-WS 2.1.4. -- -- Generated by JAX-WS RI at http:jax-ws.dev.java.net. RIs version is Oracle JAX-WS 2.1.4. -- definitions xmlns:soap=http:schemas.xmlsoap.orgwsdlsoap xmlns:tns=http:oracle.reportsrwclient xmlns:xsd=http:www.w3.org2001XMLSchema xmlns=http:schemas.xmlsoap.orgwsdl targetNamespace=http:oracle.reportsrwclient name=RWWebService types xsd:schema xsd:import namespace=http:oracle.reportsrwclient schemaLocation=http:localhost:8888reportsrwwebservice?xsd=1 xsd:schema types message name=getServerInfo part name=parameters element=tns:getServerInfo message message name=getServerInfoResponse part name=parameters element=tns:getServerInfoResponse message message name=getJobInfo part name=parameters element=tns:getJobInfo message message name=getJobInfoResponse part name=parameters element=tns:getJobInfoResponse message message name=getAPIVersion part name=parameters element=tns:getAPIVersion message message name=getAPIVersionResponse part name=parameters element=tns:getAPIVersionResponse message message name=killJob part name=parameters element=tns:killJob message message name=killJobResponse part name=parameters element=tns:killJobResponse message Note: The hostname specified should be the hostname where the Oracle WebLogic Server instance is running and not where the Reports Server is running.