Creating Off-Page References

Using URIs (Uniform Resource Identifiers), you can enhance navigation within your charts. Any hyperlink, within a box or free text object, can navigate to:

·         A box within a chart or sub-chart.

·         A sub-chart within a chart.

·         A chart within a project.

·         A project file within a file system.

Note: To define a URI, you need a field that is defined as a hyperlink. Please see Defining and Displaying Fields in Working with Charts: Basic Charting.

To define an off-page reference:

1        Right-click a hyperlink field in your chart and select Hyperlink | Edit Hyperlink from the popup menu to display the Hyperlink Properties dialog box.
 

Click to enlarge

The Title text box displays the hyperlink text you selected. The Link text box displays the URI or destination of the hyperlink.

2        Optionally, you can change the title of the link using the Title: text entry. This does not change the link’s destination.

3        You can specify a URI in using the Link: text entry. The syntax for a URI is defined in the next section.

4        Click OK.

URI Syntax

Create your off-page references using the following URI syntax:

orgplus:[filename]?[chart=<chart name>]&[subchart=<sub-chart name>]&[field=<field value>]

Orgplus:

This tag is required to tell OrgPlus that the link is an off-page reference and not a typical hyperlink.

[filename]

The filename parameter identifies the OrgPlus file to which the URI refers. The value of this parameter can be a fully qualified file name (i.e. C:\charts\myChart.opx), a relative filename (i.e. myChart.opx), or omitted completely to search the current file.

?

Use to identify the end of the file name and the beginning of the query parameters.

[chart=<chart name>]

This parameters specifies the chart (or tab) in the filename to search. If omitted, OrgPlus will search all charts in the project file.

[subchart=<sub-chart name>]

This parameter specifies the sub-chart to query. If omitted, OrgPlus will query all sub-charts in the project file.

[field=<field value>]

This parameter identifies specific field data to use in the query. Multiple fields can be added to a single URI using the & symbol to separate them.

Entering the following URI would create a hyperlink to the Ken Gorman record in the Sales sub-chart on the 2007 chart (tab) in the C:\myChart.opx file:

orgplus:C:\myChart.opx?chart=2007&subchart=Sales&field=Ken Gorman

Note: Some characters cannot be used in your URI. The World Wide Web Consortium (W3C) has identified substitutes for these characters using the percent encoded octet. This table provides the substitute codes for the most common restricted characters. For a complete list and detailed information, please refer to the W3C at: http://www.w3.org/.

Restricted
Character

Substitute
Code

&

%26

=

%3D

#

%23

Space

%20