Actions (PA)
This page covers actions for Project Assist 2.0, version 10, for facilities. For DGLux5 actions, see Actions.
Actions are application behaviors that occur in response to events. For example, an action can navigate to a project node when the user clicks an object. An action can also affect a value in the data source or open an external link.
When you create a binding to the Single Metric or Series Metric binding target types, an action is automatically created. You can override these automatically created actions. You can also create new actions. Actions are application behaviors that occur in response to user events such as clicking.
You can create an action for an object or for a series. If you create an action for a series, then clicking the series in the legend triggers the action.
When an action exists on an object of the Series Metric type, that object has a "hamburger" menu icon in its title bar, as shown in the following image. This is because individual series in the object can also have actions.
How to Add an Action to an Object
To add an action to an object:
- Select the object and open the Project Assist Property Inspector.
Click the Add Action button in the Property Inspector, as shown in the following image.
Specify an event to trigger the action, as shown in the following image.
Specify a target, if different from the default, as shown in the following image. See Actions Properties.
Specify an action type, as shown in the following image.
If necessary, specify property values for the action. See Actions Properties.
The action is created.
How to Add an Action to a Series
To add an action to a series:
- Select the object and open the Project Assist Property Inspector.
Click the Binding icon next to the series, as shown in the following image.
- Using the popup dialog, follow steps 3–6 from How to Add an Action to an Object.
How to Edit an Action
To edit an existing action:
- Select the object and open the Project Assist Property Inspector.
- Edit the action properties. See Actions Properties.
How to Delete an Action
To delete an existing action:
- Select the object and open the Project Assist Property Inspector.
Click the red X, as shown in the following image.
Actions Properties
The following are editable properties of an action.
| Property | Purpose |
|---|---|
| Event | Sets the user interaction that triggers the action. The value of the Event property can be Click, Right Click, or Double Click. |
| Target | Sets the project tree node, data node, or relativized point that this action affects. See Binding Sources. |
| Action | Sets the action type. The value of the Action property can be one of the following:
|
| Path (Hyperlink only) | Sets the path to open for a Hyperlink action. The Path property must begin with a prefix such as http:// or https:// |
| Type (Data Action only) | Sets the type of data action that occurs, such as Set or Override. |
| Edit Parameters (Data Action only) | Sets the parameters of the data action that occurs, such as an override value. |
| Edit Actions (Data Action List only) | Sets which actions appear in the drop-down. You can also use this property to set the names that appear to represent the actions to the user. |
Multiple Actions in Response to the Same Event
You can create multiple actions in response to the same event. This is useful for creating objects such as a button that overrides all of the space temperature values on a floor. If multiple actions are invoked by the same event, they will occur in the following order:
- The bottommost Auto action in the list.
- The bottommost Data Action List action in the list.
- All Data Actions. If there are multiple Data Actions on the same metric, only the bottommost action for each metric will occur.
- The bottommost Navigate action in the list.
- All Hyperlink actions in the list.