7.3.1 Defining a Hyperlink
To define a hyperlink, follow the steps below:
1. Select the component on which to place the hyperlink. This can be a Text element, Crosstab cell, Table cell, Chart dimension label, or Chart display element (slice of a pie chart, bar in a bar chart, point in a point chart, etc.).
Hyperlinks cannot be defined on radar plot dimension labels.
For a Table or Section element, you can place a hyperlink on any column; the values of all columns are then available as hyperlink parameters. In a crosstab, hyperlinks on the row and column headings can pass the heading text as parameter, while hyperlinks on data cells can pass both header and cell data values. For a Chart element, a hyperlink on the display element can pass X-axis labels, Y-axis values, and subseries (legend) values as parameters. A hyperlink on the dimension label itself can pass only the dimension labels as parameters.
2. Open the Style Studio Properties panel. (Select 'Properties Pane' from the 'Windows' menu.)
3. Click the component to which you want to add hyperlinks. Select the Hyperlink tab in the Properties panel.
4. Select the 'Asset Link' option to target a drill-down report or Viewsheet, or select the 'Web Link' option to target a web page.
5. If you selected 'Asset Link', choose the desired drill-down report or Viewsheet from the 'Link' menu.
To make the report link dynamic, enter {param_name} as the 'Link' text, where param_name is a hyperlink parameter that contains the deployed report name.
Assets are populated in this 'Link' menu from the repository.xml and asset.dat files in the repository. The repository.xml file lists reports that have been deployed to the server (see Incremental Deployment of Assets in Administration Reference and Deploying a Report, Data Source, or Other Asset in Getting Started), and asset.dat lists Viewsheets that have been saved on the server. If there are no deployed assets visible in the 'Link' menu, you can manually enter the name as it appears in the repository. See Configuring a Repository in Getting Started for information on specifying the repository location.
6. If you select 'Web Link', enter the target URL in the 'Link' field. (For example, “http://www.google.com/search”.) You can also specify a table column to provide the URL links by selecting the desired column from the 'Link' menu.
7. (Optional) Enable 'Send report parameters' to pass all existing report parameters to the drill-down report, Viewsheet, or URL. (See Passing Report Parameters for details on synchronizing parameters.)
8. Select 'Disable parameter prompt' to suppress the default parameter prompt produced by the drill-down report or Viewsheet. (Prompting is automatically suppressed for parameters explicitly selected in the 'Parameters' panel.)
9. In the 'Parameters' panel, press the 'Add Parameter' button. This opens the 'Parameter' dialog box.

Enable 'Preview Server Features' on the General tab of the 'Style Studio Configuration' dialog box (select 'Configure' from the 'File' menu).
10. In the 'Name' field of the dialog box, select the name of the parameter expected by the receiving report, Viewsheet, or URL.
11. Select 'Field' if the value passed in the hyperlink should be provided by a field value. Select the desired field name from the 'Value' menu. (See Passing Report Parameters for details on synchronizing parameters.)

12. Select 'Constant' if the value passed in the hyperlink should be a fixed value. Specify the data type of the constant in the 'Type' field, and enter the desired value in the 'Value' field.
13. Repeat the above steps to add additional parameters to the hyperlink.

14. In the 'Target Frame' field, specify a target window for the hyperlink.
You can enter a name or an HTML target keyword, such as “_blank,” to open the target in a new window or tab. If you leave the 'Self' option enabled, the target report or web-page will replace the parent report in the browser.
15. If applicable, in the 'Bookmark' field, select the Viewsheet bookmark that you want the hyperlink to target. The Viewsheet will automatically open this bookmark when the user clicks the hyperlink.
16. In the 'Tool Tip' field, specify the text that should appear when the user hovers the mouse over the hyperlink in the report.
For Table hyperlinks only, the tool tip can include field values for the current record. To insert the field value into the tooltip, use the placeholder “{field name}”. For example, for a Table with fields 'Order Number' and 'Employee', you can specify the following tooltip: “Invoice for order {Order Number} placed by {Employee}”.
17. Press the 'Apply' button.
To display hyperlink underlining by default, set hyperlink.indicator=true in sree.properties.
18. Add any desired visual formatting to the hyperlinks (e.g., underlining).
19. Preview the report to test the hyperlinks.
| << 7.3 Hyperlinks | © 1996-2013 InetSoft Technology Corporation (v11.5) | Passing Report Parameters >> |