Linking a shape to a view
Using a shape data field of type View, you can link a shape to view.
By default, this will cause the Visio drawing linked to that view to be opened each time a user clicks the shape.
Tip
See also:
Note
- Visio shapes linked to views will not be displayed if, for any reason, those links cannot be resolved. Link problems can occur due to insufficient user rights, missing DataMiner items, invalid parameter values, etc.
- For an example, see Ziine > Visual Overview Design Examples view > [linking > OBJECTS] page.
Configuring the shape data field
To link to a view, add a shape data field of type View to the shape, and set its value to:
View ID
or
View name
To link to a particular tab page of a view, add the zero-based index of the tab page, separated from the view name or view ID with a pipe character.
View ID|tab page index
Note
- If you want to link the shape to the root of the Surveyor, enter "-1", "root", or the name of the root.
- While using the name of a view might be more convenient, we advise you to always use its (unique) ID. If, in a Visio drawing, you use the name of a view, the link to that view will be broken the moment someone changes that name. If, on the other hand, you use the view ID, the link to that view will remain, even if its name is changed.
Customizing the displayed view alarm level
You can specify which of the view's alarm levels should be reflected by the shape's background color: the alarm level of the monitored aggregation rules on the view, the alarm level of the child objects of the view, or a combination of both.
To do so, add a shape data field of type AlarmLevel, and set it to one of the values specified below:
| Shape data field | Value |
|---|---|
| AlarmLevel | One of the following values should be specified: - Instance: Displays the alarm level of the monitored aggregation rules on the view. - BubbleUp: Displays the highest alarm level of any child object. - Summary: Displays the highest of the Instance and BubbleUp alarm levels. |
Examples
49
If you set the value above, clicking the shape will open the Visio drawing linked to the view with ID 49.
MySpecialView
If you set the value above, clicking the shape will open the Visio drawing linked to the view named "MySpecialView".
Main Site|2
If you set the value above, clicking the shape will open the Visio drawing linked to the view named "Main Site", on its second tab page.
Tip
To navigate to a page of the current Visio drawing, use NavigatePage.