Siebel Analytics Web Services Guide > Description of Siebel Analytics Web SOAP API Methods > HtmlViewService Service >

setBridge() Method

The setBridge() method specifies a bridge URL to receive communications. Specifying a bridge URL can be useful when the Siebel Analytics Web 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 Siebel Analytics Web server are sent to the bridge URL, which then forwards requests to the Siebel Analytics Web server.

Signature

void setBridge(String bridgeURL, String sessionID);

Usage

You are responsible to 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 Siebel Analytics Web 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 Siebel Analytics Web 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, Siebel Analytics Web 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.