Retrieving a relative prompt page URL

If the internal dispatcher URI of your IBM® Cognos® Analytics server is hidden behind a firewall, you can receive the prompt page URL based on the external gateway URI instead.

Use the useRelativeURL option (REST applications) or the useRelativeURL option (SOAP applications) to receive the prompt page URL based on the external gateway URI.

A request to run a report that requires prompts returns a response that contains a URL to a page that you use to request prompts from a user. The prompt request URL is based on the internal dispatcher URI of your Cognos Analytics server. If this address is hidden behind a gateway, you can retrieve a relative URL instead that you can use to form a URL based on the external gateway URI.

For example, the response to the following URL:

http://localhost/ibmcognos/bi/v1/disp/rds/reportData/report/
i3D3D474CA3804E5CB0D56D7752950303?v=3&useRelativeURL=true

includes a URL as follows:

<rds:url>/ibmcognos/bi/v1/disp?b_action=xts.run&m=ccs/ccs_prompt.xts
&promptID=i8D98FF4D826441FD944F6DB26A8A5BB6&ui.object=
storeID("i3D3D474CA3804E5CB0D56D7752950303")</rds:url>

It is up to your application to form a correct URL from this relative URL.