ext

Creates a button that, when clicked, causes DashBoard to open an editor tab for a device in the DashBoard tree view.  When the button is pressed, DashBoard searches its tree view for a node with the provided ID.  If a node is found and the node contains an editor, its editor is opened and/or brought to the foreground (made the active tab).

If a component is buried deep within the UI (e.g. a tab within a tab), the card can supply multiple IDs to ‘reveal’ not only the desired component, but also the component’s parents.

Syntax

<ext name="button-name" objectid="node-id" buttontype="type" general attributes/>

<ext name="button-name" objectid="FileNavigator,file-path,file-name" buttontype="type" general attributes/>

Attributes

In addition to General Attributes, the following attributes may be specified to the <ext> tag:

Attribute

Values

Restrictions

Description

name

String

 

The name to display on the button.

objectid

String

The value must refer to the node ID an element in DashBoard’s tree view.

Specifies the id of the components to show.

DashBoard provides a few shortcuts to reference elements under the device node in the tree or a sibling device in the same frame:

%frame% will be replaced with the frame’s primary identifier.

%device% will be replaced with the device’s primary identifier.

%slot 1 (or 2, or 3, etc.)% will be replaced with the primary identifier of the device in the referenced slot in the same frame.

If the String starts with “FileNavigator,” the objectid specifies a path and filename of a resource in the DashBoard file navigator, rather than the tree view.

buttontype

button

label

Optional

“button” = display the link as a button

“label” = display the link as a label

Default values shown in bold.