Oracle^® Business Intelligence Web Services Guide > Description of Services in Oracle BI Web Services > HtmlViewService Service >

setBridge() Method

Use this method to specify a bridge URL to receive communications. Specifying a bridge URL can be useful when the Oracle BI Web Services server and the user's Web server reside on different machines, or when you want to modify the results in your application development environment.

After the setBridge() method is called, all requests from the client browser to the Oracle BI Web Services server are sent to the bridge URL, which then forwards requests to the Oracle BI Web Services server.

Signature

void setBridge(String bridgeURL, String sessionID);

Usage

You must make sure that the client browser provides a handler to the bridge URL in the form of a Java servlet, an Active Server Pages (ASP) page, a Common Gateway Interface (CGI), an Internet Server application programming interface (ISAPI), or an equivalent application.

You must also perform the following tasks:

• Decode the path of the requested Oracle BI Web Services resource in the RedirectURL argument of the request character string. For information about the RedirectURL argument, read How Callback URLs Are Replaced.
• Forward all other request arguments, together with all headers and the request body, to the bridge URL.
• Copy the response from the Oracle BI Web Services server to the response stream.

How Callback URLs Are Replaced

The new callback URL is based on the bridge URL, with the addition of a RedirectURL argument. The value of the RedirectURL argument should be the original value of the URL, encoded using standard URL encoding rules.

Internally, Oracle BI Web Services usually uses relative URLs for callback links. For example, if the original callback link is saw.dll?Go and the bridge URL is http://myserver/myapplication/sawbridge, the new callback URL is http://myserver/myapplication/sawbridge?RedirectURL=saw.dll%3fGo.