Starting Oracle BI Discoverer Using URL Parameters 12-15
12.8 List of URL parameters specific to Discoverer Plus
This table describes Discoverer Plus-specific URL parameters that can be used in addition to the generic URL parameters in
Section 12.7, List of URL parameters common to Discoverer Plus and Viewer
.
Tip : Do not use Discoverer Plus URL parameters on the same URL as Discoverer
Viewer URL parameters.
Note : For information about Discoverer Plus OLAP URL parameters, see
Section 5.7, URL parameters for the Discoverer Plus OLAP
.
Parameter and Values Description Example
_plus_popup=true or false
Specifies whether to launch Discoverer Plus in a new browser window or in the Discoverer Connections page, as follows:
■
true default launches Discoverer Plus in a new browser window.
■
false launches Discoverer Plus in the current browser window.
This URL parameter can be used with framedisplaystyle for more information, see framedisplaystyle=.
_plus_popup=true
database=database name or alias
Specifies which database to connect to when Discoverer starts.
Tip
: You can also use the connection ID URL parameter cn=value to specify database, and user name as a single
parameter. database=mydb
framedisplaystyle=se parate or embedded
Specifies how to launch the Discoverer main window.
■
Use separate to launch Discoverers main window as a separate frame from the browser that is, from the Discoverer
Connections page. The browser window contains a Discoverer image and must remain open while Discoverer is
being used.
■
Use embedded to launch Discoverers main window within the current browser window.
When using _pop_up with framedisplaystyle=, the possible combinations are:
■
_plus_popup=true and framedisplaystyle=embedded launches Discoverer Plus in a new pop-up browser window
that contains the Plus applet embedded in it.
■
_plus_popup=true and framedisplaystyle=separate opens a new pop-up browser window and launches Discoverer Plus in
a new applet window. This combination launches three windows: the original
browser window that is, Discoverer Connections page, the new browser window containing the Discoverer image, and
the JFrame window containing the Discoverer Plus applet.
■
_plus_popup=false and framedisplaystyle=embedded launches Discoverer Plus in the current browser window.
■
_plus_popup=false and framedisplaystyle=separate launches Plus in a JFrame window. The current browser window
contains the Discoverer image. framedisplaystyle=
separate
12-16 Oracle Fusion Middleware Configuration Guide for Oracle Business Intelligence Discoverer
helpset=pathlocale HS file
Specifies a help set location that is different to the default Discoverer Plus help set.
Note : The help must be in sub-directories named by the standard
two character locale.
Tip : As an alternative to using the HelpSet URL parameter to
customize the help, edit the plusug.hs file and its related files. helpset=Plus_
filesMy_custom_ help
where the Plus_ filesMy_custom_
help directory contains the
language folders; for example, en,
es, fr.
lookandfeelname=sys tem or oracle or
browser or plastic or custom
Specifies a look and feel. For example, a user might want to run Discoverer Plus using the Windows look and feel.
This setting overrides the LAF specified in Oracle Fusion Middleware Control. For more information, see
Section 8.2.2, How to change the default Discoverer Viewer LAF.
If you specify the lookandfeelname value as custom, Discoverer uses the LAF class and JAR specified in the configuration.xml file.
For more information about specifying a custom LAF on the Discoverer middle tier, see
Section 8.1.3, How to define a custom LAF for Discoverer Plus.
lookandfeelname= plastic
opendb=workbook name
Specifies the name of a workbook to open Discoverer assumes that the workbook is stored in the database, not as a scheduled
workbook. If you use the opendb parameter more than once in the URL, Discoverer uses the last one.
Tip
: This URL parameter is included for backward compatibility. Oracle recommends that you use opendbid to specify workbooks.
Note : opendb=Video+Sales+Workbook is the equivalent of
workbookname=Video+Sales+Workbookworkbooksource=Data base.
See also workbookname and workbooksource. opendb=Video+Sal
es+Workbook
Note : You must
also specify a workbook source
that is, workbooksource=
Database or Scheduled. For
example, workbooksource=S
cheduledopendb =Video+Sales+Wor
kbook.
opendbid=unique ID Specifies the unique ID of the workbook you want to open.
Discoverer assumes that the workbook is stored in the database, not as a scheduled workbook.
For more information about how to find the unique ID of a workbook, see
Section 12.4.1, How to find out the unique workbook ID of a workbook
. For examples, see
Section 12.5, Examples of using URL parameters
. opendbid=January
Sales
Note
: You must also specify a
workbook source that is,
workbooksource= Database or
Scheduled. For example,
workbooksource=S cheduledopendbi
d=JanuarySales.
param_parameter_ name=parameter_
value Specifies values for parameters.
Note
: If the workbook does not contain a parameter of that name, Discoverer ignores the parameter.
param_ regionparam=East
Parameter and Values Description Example
Starting Oracle BI Discoverer Using URL Parameters 12-17
responsibility=respons ibility name
Specifies the Oracle Applications responsibility for Oracle Applications end users.
Note : If you do not specify a user name, responsibility, or security
group, the Discoverer end user is prompted to enter the missing login information.
responsibility=Ma nager
Discoverer bypasses the
Responsibility dialog and assigns
the end user an Oracle
Applications responsibility of
Manager
sheet=worksheetname Specifies the name of the worksheet to open by default.
Note : If you use the sheet parameter more than once in the URL,
Discoverer opens the last one.
Tip
: This URL parameter is included for backward compatibility. Oracle recommends that you use sheetid to specify worksheets.
sheet=Sales+Detail +Sheet
sheetid=unique ID Specifies the unique identifier of the worksheet to open.
For more information about how to find the unique ID of a worksheet, see
Section 12.4.2, How to find out the unique worksheet ID of a worksheet
.
Note : You must also specify a workbook using opendbid.
For examples, see Section 12.5, Examples of using URL
parameters .
sheetid=7
username=database user name
Specifies a database user name with which to connect to Discoverer.
Tip
: You can also use the connect parameter to specify a database, user name as a single parameter.
Note : If you do not specify a user name, responsibility, or security
group, the Discoverer end user is prompted to enter the missing login information.
username=video_ user
windowheight=numb er of pixels
Specifies the height in pixels of the Discoverer application frame. If you do not use this parameter, Discoverer uses a default value.
windowheight=600 windowwidth=numbe
r of pixels Specifies the width in pixels of the Discoverer application frame. If
you do not use this parameter, Discoverer uses a default value. windowwidth=800
workbookname=work bookname
Specifies the name of the Discoverer workbook to open.
Tip : Use this URL parameter with workbooksource.
For example, workbookname=Video+Sales+Workbookworkbooksource=Data
base is the equivalent of opendb=Video+Sales+Workbook.
Tip : This URL parameter is included for backward compatibility.
Oracle recommends that you use opendbid to specify workbooks.
workbookname=Vi deo+Sales+Workbo
ok
workbooksource=Dat abase or Scheduled
Specifies the location of the workbook to open:
■
Database specifies that the workbook is saved in the database.
■
Scheduled specifies that the workbook is a scheduled workbook that is updated periodically.
Tip : Use this URL parameter with opendbid or workbookname.
For a worked example, see Section 12.5.7, Example 7: Starting
Discoverer Plus and opening a scheduled workbook .
workbooksource= Database
Parameter and Values Description Example
12-18 Oracle Fusion Middleware Configuration Guide for Oracle Business Intelligence Discoverer
12.9 List of URL parameters specific to Discoverer Viewer