Open Save As Dialog Box
Verb: saveFileAs
Available from: <Standard>
Opens the "Save As" dialog box for the user to determine the directory, name and extension of the file to be saved.
Syntax
saveFileAs --title(String) --filter(String) (String)=value
Inputs
| Script | Designer | Required | AcceptedTypes | Description |
|---|---|---|---|---|
| --title | Title | Required | Text | Title to be displayed in the dialog box. |
| --filter | Filter | Required | Text | Text used to define the extension for the file to be saved.
In this parameter, the informed text filters the file type in the "Save as" window depending on the file extension, for example: to filter text files, use the filter: *.txt. It is important to always use a valid extension format. e.g., *.[File extension]. |
Outputs
| Script | Designer | AcceptedTypes | Description |
|---|---|---|---|
| value | File Path | Text | Returns the complete path to the saved file. |
Example
The command Open Save As Dialog Box is used for the user to define the directory in which a text file will be created and its name, in order for the command Write to File to use that directory as a reference and write the instruction given to him informed.
defVar --name filePath --type String
defVar --name fileExtension --type String --value "*.txt"
defVar --name text --type String --value "Inteligent automation is IBM\'s specialty!"
saveFileAs --title "Save As..." --filter "${fileExtension}" filePath=value
writeToFile --value "${text}" --file "${filePath}" --writeasnewline
// The console displays where the text file with the message is, according to the user's selection.
logMessage --message "Location where the file was saved: ${filePath}" --type "Info"
The file name will always be the one defined on the dialog box when saving.