There are 2 ways in which you can set links in custom tools that you build for the dashboard, you can hard code them, or you can use a modifier to set the link at the time the tool is used. This page provides more detail on the difference between these methods.
For more general help on creating custom tools in the dashboard see here
Links can be defined on objects that you have on the dashboard, such that when you double click on the object, or right click and select links you can invoke them. These links can point at data items, dockables and tabs within the console, or external URLs. The effect of each of these is as follows:
The simplest way to add a link to a dashboard object is just to add it to the links properties of the tool
This link is essentially hard coded, in that it will not change until the URL is manually changed via the properties window. In the context of a user defined or custom tool this will also be true. Each time the tool is used the URL will remain the same (unchanged). For URLs and Dockable and tab links this is the only option. For Data item URLs when used in custom tools however it is possible to make them more dynamic which is discussed next.
Dynamic URLs in user defined tools
When designing user defined or custom tools it may be desirable that when that tool is used the link within the object then points at the data item that you dropped. This is possible, not by using a link (as we discussed above), but by using a modifier embedded within the tool. The following explanation assumes that you are already familiar with how to create custom tools
When you design your tool you should also add the following modifier
and set the path to a dropped item path, which at the simplest would be
Although you alter the path using the standard merge, replace and amend methods. At the point the tool is used the modifier will perform a one of operation and add the result of the droppeditem() path as a link to the object. By way of example you can import this tool