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 predefined node variables.

Create a variable to prompt the user to input an argument.
  • This example executes the program stest using the selected file:
    C:\myprograms\stest $(FileName)
  • This example executes the program stest, prompting the user to input the file name for the user defined variable ($(p1)):
    C:\myprograms\stest $(p1)
  • This example opens the associated file (a .per or .4fd file) as a complied .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: