User actions

User actions define commands that can be invoked from a menu or toolbar icon within Genero Studio.

Important: If you are using a remote configuration, the user action is executed on the remote server unless you specify otherwise.

To view user actions, select Tools > Preferences (or if you are on a Mac, Genero Studio > Preferences), then select General > User Actions.

Figure: User Actions Configuration page


Screen shot of User Action Configuration page

To add or edit user actions, use the toolbar icons on the User Actions Configuration page.

Figure: Add a User Action dialog


Screen shot of the Add a User Action dialog
Table 1. Adding user action detail
Field Description
Name Name of the user action.
Label Label for the user action as displayed in Genero Studio action listings, menus, or toolbars.
Description Optional.
Icon Optional.
Target nodes Project nodes that display the user action in their context menus. To attach the user action to another project node, click the ellipse at the end of this field.
Note: If the user action is not attached to any nodes, the message "Check File Associations" displays.
Command line
Command to be executed. Arguments can be included on the command line as needed.
Note: If the command includes a path that contains spaces, the path must be in quotes.
Use the Insert Variable button to select from the available variables. The available variables include system environment variables and environment variables from the current configuration (see Environment sets). Other available variables depend on whether target nodes are selected.
  • If no target nodes are selected, the following variables are included: FileBaseName, FileDir, FileExtension, FileName, FilePath, FilePaths, Locator, and MimeType.
  • If target nodes are selected, variables include all properties associated with the target nodes.
  • If target nodes contain a Project Manager node, variables Implicit and TemplateDir are also included.
When the action is executed, Genero Studio attempts to resolve the variable. If the variable cannot be resolved, the user is prompted for a value.
Examples:
  • Execute the program stest using the selected file:
    C:\myprograms\stest $(FileName)
  • Execute the program stest using the user-defined variable ($(p1)):
    C:\myprograms\stest $(p1)
  • Open the associated file (a .per or .4fd file) as a compiled .42f file:
    $(open) $(FileDir)/$(FileBaseName).42f)
Display output If selected, the output from the executed commands are displayed in the Output view.
Verbose If selected, the user action commands are displayed in the Output view.
Always execute locally If selected, the user action is executed locally even if the current configuration is remote.

Associating the User Action

You can associate the user action with: