Linking in widgets

Linking allows users to connect from a widget, known as the source in a document, to another document or report, known as the target. For example, you can link a widget displaying sales information by customer region to a related document, such as the top ten employees by profit. The user can then click the link in the widget to view the document, compare data, or retrieve additional information.

If a link is added to an attribute in the widget's Grid/Graph, the target report or document is displayed in the tooltip associated with the attribute when the widget is displayed. In the image below, two documents have been added as links to the Region attribute. When the user hovers the mouse over the Web region, the Links menu is displayed. The user can select a linked document from the menu to open it.

Example of linking in widgets

You can add links to the following widgets:

For information on how to add links to each widget, and which widget element can be used to display a link, see:

Prerequisites

Before creating links in a widget, you should:

Prompt Answer Method

Prerequisite

Answer with the same prompt from the source

  • The same prompt is used in the target and the source.

Use default answer

  • The target prompt contains a default answer.

Answer dynamically

  • The target prompt is an attribute element prompt or value prompt.

  • The object that the user selects to execute the target answers the target prompt.

Answer with an empty answer

  • The prompt should not be required.

Answer using current unit

  • The target prompt is a hierarchy prompt.

  • The object that the user selects to execute the target answers the target prompt.

Answer using all valid units

  • The target prompt is a hierarchy prompt.

  • The object(s) that the user selects to execute the target answers the target prompt.

This procedure assumes that you have already created a widget in a document.

To add a link to a widget

  1. Run a document in Design Mode.

  2. Right-click an attribute in the widget's Grid/Graph, then select Edit Links.

  3. Click New to create a new link, or skip to the next step if this is the first link you are creating for this report.

  4. Type a name for the link in the Url display text field.

  5. Click the Select Target button Select Target button below Run this report or document to find and select the target report or document. The Select Target dialog box opens.

  6. In the Select Target dialog box, navigate to and select the target report or document. Click OK to close the dialog box.

  7. The box below the Run this report or document field contains a list of any prompts included in the target report or document. Select a target prompt from the box.

  8. Select a prompt answer method from the drop-down box:

  9. Repeat the above steps, starting with To apply prompt answers, for each prompt in the target.

  10. Any other prompts are those prompts that are not in the target when you are creating the link, such as prompts added to the target later. By default, the Prompt user method is selected for these prompts, but you can change the method.

  11. Select Any other prompts in the box.

  12. Select a prompt answer method from the following list; only these methods are available for the Any other prompts option:

  13. Note: See the previous list of prompt answer methods for brief descriptions of each.

  14. Select the Open in new window check box to have the target open in a new window. This allows the target and the source to be visible simultaneously.

  15. Click OK to save changes and return to the document.

Once a report or document is linked to a widget, the user can access the link using a tooltip in the widget.

To open a link in a widget

  1. Open the document containing the widget in Flash Mode.

  2. Hover the cursor over a bubble, rectangle, or other widget element associated with the linked attribute to display a related tooltip.

  3. Hover the cursor over Links. A list of linked reports and documents is displayed.

  4. From the Links menu, select a report or document to open it.

Related topics