Hyperlink controls behave like embedded browser controls, except that their URL-based content is displayed as follows:
Current window
Top window
New window
Named window
No window
Hyperlink-control behavior depends upon the display window selection and the type of application (Interactive Reporting Studio, Interactive Reporting Web Client, or EPM Workspace)
Table 195. Hyperlink control behavior
Target | Interactive Reporting Studio | Interactive Reporting Web Client | EPM Workspace |
|---|---|---|---|
New window | Launches new window | Launches new window | Launches new window |
Current window | Launches new window | Replaces current window | Replaces content of the EPM Workspace tab, if the content is derived from the Reporting and Analysis repository. Otherwise, opens the hyperlink object in a new window. |
Top window | Launches new window | Replaces current window | Opens in a new EPM Workspace tab, if the content is derived from the repository. Otherwise, opens the hyperlink object in the top window. |
Named window | Launches new named window | Launches new named window | Launches new named window |
Other properties of hyperlink controls are similar to the properties of text label graphics and the OpenURL method. Hyperlink controls are added like embedded browser controls are added, except that the control name in Elements is Hyperlink.
To create instances of hyperlink controls:
Select Insert, then New Dashboard.
Inserting a dashboard section changes the document to Design mode. The content area is blank, and Elements displays the available sections, graphics, and control objects.
Drag the hyperlink control onto the content area, and double-click the control.
Properties is displayed.
On the Object tab, enter a unique name for the hyperlink control.
The default name is Hyperlink.
Enter a title for the dashboard section.
The Title is only used when the dashboard section is printed.
Select Visible to display the hyperlink control when the dashboard section is executed.
By default, Visible is selected.
Select Locked to prevent the hyperlink control from being moved or deleted in dashboard Design mode.
By default, Locked is not selected.
From Display in, select where to display the contents of the hyperlink control:
New Window—A pop-up window is created every time the hyperlink is clicked. This option, which is the default, maps to the OpenURL OM method "_blank" target.
Current Window—If the execution application is Interactive Reporting Web Client or EPM Workspace, the content replaces the EPM Workspace content area (for example, excluding the surrounding browse application panes). In Interactive Reporting Studio, a pop-up window is displayed.
Top Window—If the execution application is Interactive Reporting Web Client or EPM Workspace, the content replaces the top HTML window. This option maps to the OpenURL OM methods "_top" target.
Named Window—A named pop-up window is created. If a named window is currently displayed, the URL replaces the content of the current window. When this option is selected, the user can enter the new window name in the Target window text box that is displayed below the drop-down list. This option maps to the user-specified, target-name option of the OpenURL method.
Optional: To define explicitly the URL of the content to be displayed in the hyperlink control, in URL, enter the URL address.
When the hyperlink control is rendered, the URL is used “as is” (server information is not appended).
You can reference repository content by entering an explicit URL. In this case, the URL is treated like any other external reference (no special authentication support).
It is important to plan how the content of the URL is displayed in the hyperlink control. An action from within the hyperlink content can result in the browser, rather than only the contents of the hyperlink control, being replaced.
Optional: To select a repository document (and associated properties) to be displayed in the hyperlink control, select Repository, and perform one or more actions:
Document—Enter the path and name of the preferred repository document.
Browse—Browse the repository for the preferred document.
Options—Launch the Document Options dialog box, from which a user can select display properties for a selected EPM Workspace document. If the display type is New Window or Current Window, the dialog box looks and behaves as described in Working with Embedded Browser Controls. Also see Document Options.