Browse File/Folder

This action opens the system browse for file or folder dialog.

About group identifies the selected action.

  • Name: allows you to define a custom action name. This makes actions easily recognizable on the solution's list of actions. By default, the action name is taken from its type.
  • Description: custom information about the action. Enter a description to explain the purpose and role of action in a solution.
  • Action type: read-only information about the selected action type.

Dialog group sets the browsing preferences.

  • Browse for: selects between browsing for file or folder.

  • Filter: sets the file type to be located. Enter the file type manually, define the filters using a Define File Filters dialog or select Data source to determine the filter dynamically using a variable value. The Define File Filters dialog allows the user to:

    • List the filters. Each filter is identified with a Filter Name and Filter type.

    • Manage the existing filters using Add, Delete, Move up and Move down buttons.

    Note

    If you remove all filters, file type selection drop-down list will not be shown when the dialog opens.

  • Initial folder: sets the initial folder to be opened with action.

  • Dialog title: title of the file browser window that opens with action.

  • Allow non-existing file: enables browsing for a file that does not exist in the specified folder. This option allows you to store the path to a non-existent file in a variable and use it in a series of actions. The file can be created later using other actions, such as Save Data to File.

Output data source group selects a variable for file/folder path storing.

  • Save path to: existing or new variable for the file/folder path to be saved to.

Action Execution and Error Handling

Each action can be set as a conditional action. Conditional actions only run when the defined conditions allow them to be run. To define these conditions, click Show execution and error handling options.

Execution options are:

  • Enabled: specifies if the action is enabled or disabled. Only enabled actions will execute. This functionality may be used while testing a form.
  • Condition: defines one-line programming expression that must provide a Boolean value (true or false). When the result of the expression is true, the action will execute. Condition offers a way to avoid executing actions every time.

Error handling options are:

  • Ignore failure: specifies whether an error should be ignored. If enabled, the execution of actions continues even if the current action fails.

    Note

    Nested actions that depend on the current action do not execute in case of a failure. The execution of actions continues with the next action on the same level as the current action. The error is logged but does not break the execution of the action.

    • Example

    At the end of printing, you might want to send the status update to an external application using the HTTP Request action. If the printing action fails, action processing stops. In order to execute the reporting even after the failed print action, the Print Label action must have the option Ignore failure enabled.

  • Save error to variable: allows you to select or create a variable to save the error to. The same cause of the error is also saved to internal variables ActionLastErrorId and ActionLastErrorDesc.