Oracle^® Business Intelligence Presentation Services Administration Guide > Integrating Oracle BI Presentation Services into Corporate Environments Using HTTP >

Referencing Dashboard Content in External Portals or Applications Using the Oracle BI Presentation Services Dashboard URL

This section describes how to use the Oracle BI Presentation Services Dashboard URL. It contains the following topics:

• About the Oracle BI Presentation Services Dashboard URL
• Structure of the Basic Oracle BI Presentation Services Dashboard URL
• Optional Parameter for the Oracle BI Presentation Services Dashboard URL

About the Oracle BI Presentation Services Dashboard URL

The Oracle BI Presentation Services Dashboard URL is for use in incorporating or referencing the content of a specific dashboard in external portals or applications. It has a number of forms and optional arguments that can be used to control its behavior.

You can post the Dashboard URL command as a Form or issue it as a URL. If you are issuing parameters as part of a URL, they need to be escaped properly. You need to replace spaces with plus ( + ) signs, and so on. For example, to pass East Region as a value, type East+Region.

When called from within an Oracle BI Presentation Services screen, such as a dashboard or an HTML result view, the URL should begin with this:

saw.dll?Dashboard

When called from another screen on the same Web server, the URL should begin with this:

/Analytics/saw.dll?Dashboard

When referenced from a screen on a different server (or sent through email, and so on), the URL should begin with the fully qualified server name or IP address:

http://server_name_or_ip_address/Analytics/saw.dll?Dashboard

To test these commands, you can enter the fully qualified version into the Address field in Internet Explorer.

Structure of the Basic Oracle BI Presentation Services Dashboard URL

The basic Dashboard URL command needs no parameters. It displays the user's default portal, after authenticating the user.

This is the format:

saw.dll?Dashboard

Optional Parameter for the Oracle BI Presentation Services Dashboard URL

You can modify the behavior of the Dashboard URL command by adding the user ID and password parameters. If the parameters are omitted, then the user is prompted for user ID and password information, unless the user chose the option to have logon information remembered when last logged on. If using a Session ID or Ticket, pass it as the NQUser parameter. In the parameter description, SB2 is the name of the request to execute.

This is the format, where uuu is the user ID, and ppp is the password:

&NQUser=uuu&NQPassword=ppp

Example:

saw.dll?Go&Path=/Shared/Test/SB2&NQUser=user1&NQPassword=rock

This logs on as user1 with a password of rock, and displays the dashboard.

If an invalid URL is specified (for example, you type a parameter incorrectly), the browser returns the "The page cannot be found" error with detailed text of "HTTP 400 - Bad Request."