Definition and Usage
Displays a file selector dialog for the user to select a file and returns the selected file path. This command allows users to interactively choose files during automation workflow execution.
Parameter Values
Input parameters
Parameter | Description | Possible Values | Required | Options / Notes |
Title | Enter the title to display on the dialog | Text | No | Leave empty to use the default title "Please select a file" |
File types | Select a file type filter | all file types|*.*; Excel files|*.xls;*.xlsx; Word files|*.doc;*.docx; txt files|*.txt; images|*.png;*jpg;*.bmp; PPT files|*.ppt;*.pptx; compressed files|*.zip;*.rar; Others | No | Filters which file types are visible in the dialog |
Define file type filter | Enter the file type filter using this format: 'Description'|*.ext1;*.ext2 | Text | No | Required only when "Others" is selected as File type |
Enable multi-selection | Allow selecting more than one file | Boolean (checkbox) | No | When enabled, users can select multiple files |
Advanced settings
Parameter | Description | Possible Values | Required | Options / Notes |
Initial directory | Optional. Leave empty to open the last used directory | Text | No | Specifies the starting directory when the dialog opens |
Check if file exists | Only allow selecting existing files | Boolean (checkbox) | No | When enabled, prevents selection of non-existent files |
Error handling
Parameter Name | Description |
Throw error & stop | When an error occurs, the action will trigger an error and stop the execution of the entire app. |
Retry command | If an error occurs, the action will retry the command in an attempt to resolve the issue and continue the process. |
Ignore error & continue | When an error occurs, the action will be ignored, and the workflow will continue without interruption. |
Variables produced
This action produces a variable that contains the path of the selected file. If multi-selection is enabled, the variable will contain a list of file paths.
Using Variables in Conditions
You can use the output variable in subsequent commands to process the selected file(s). For example:
Use the file path to open a document in another application
Process the selected file with file manipulation commands
Pass the file path to other commands that require file inputs
Notes
If the user cancels the file selection dialog, an error will be triggered according to the selected error handling behavior.
When multi-selection is enabled, the output variable will be a list type, even if only one file is selected.
The file type filter helps users locate the desired files more easily by showing only relevant file types.
The "Initial directory" parameter can be useful for guiding users to a specific location where relevant files are stored.