Custom actions can be used as shortcuts to run tasks that are regularly performed. Each action can be customised to emulate the effect of dropping a tree object onto the current GeoPlan window. Alternatively, a Ruby script can be associated with the action.
There are two types of custom action:
- User custom actions - actions specific to each individual user
- Shared custom actions - actions available to all database users.
The actions are properties of the database. Each database may have up to ten actions of each type (user and shared) defined.
Editing custom actions
To edit a custom action:
- Select one of the following:
File | Database settings | User custom actions
File | Database settings | Shared custom actions
The User Custom Actions dialog or Shared Custom Actions dialog is displayed.
- On the dialog:
- Select the action to edit from the Custom action dropdown list.
- Optionally, overwrite the supplied action title.
The action title will be displayed in the Actions menu and in the tooltips for the associated actions toolbar.
- Optionally, overwrite the action description.
The action description will be displayed in the status bar when hovering over the action menu items or toolbar buttons.
- Select a database object to be applied to the GeoPlan when the custom action is run.
Alternatively, browse for a Ruby script to be run when the custom action is selected.
- Click OK.
Notes:
- Shared custom actions can be edited only by users with permission to change database-wide settings.
- The database objects that can be associated with a custom action are:
Applying custom actions
To run a custom action on the current network:
- Either select the menu option for the action from the Actions menu, or click the toolbar button for the action on the User Actions toolbar or Shared Actions toolbar.
Note: If a custom action has been set up to act on a network, then the corresponding action button and menu option will be available only if a network is open.