Dashboards - How to set links when using custom tools in the dashboard
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.
There are 2 ways in which you can set links in custom tools:
Types of links Copied
Data item link Copied
It points a specific cell, a data view or an entity. When these are invoked the console will elect on the best way to display this item, this may involve showing the data view the cell is contained in, or showing a list view with the selected entity or path results and so on. Links of this nature will be of the form:
dataitem(/geneos/gateway/directory/probe/managedEntity[(state("severity")="3")])
Dockable or tab within the console Copied
When invoked it will open that dockable and that tab, they are of the form:
geneos://component(Acitveconsole)/dockable(Dashboard)/tab(mydashboard)
URL Copied
This will send the URL to the OS, which will elect the most appropriate action, they tend to be of the form: https://www.google.com/
Hard codded links Copied
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 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. 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 Copied
When designing user defined or custom tools it may be desirable that when that the link within the object points at the data item that you dropped. This is possible, not by using a link, but by using a modifier embedded within the tool (knowledge of custom tools is assumed).
When you design your tool you should also add the following modifier: Link URL to Data item.
Then set the path to a dropped item path, which at the simplest would be droppeditem().
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.
For more information, see How can I create Custom dashboard tools?