Enhanced Prompt for Variables Action



This action (kindly donated by Peter Thörnqvist) is an enhanced version of the Prompt for Variables action that allows you to specify the control types to be used at runtime in the prompt form.  The action also has more features and allows greater customisation.


For more information on variables, including creating your own project and user variables, see here.


Note: By default, interactive actions are not available from the FinalBuilder console. Interactive actions cannot be used inside Async Action Groups.


The general settings lets you customise the dialog appearance.




Dialog Caption - the text to appear in the dialog header.


Prompt Text - the text to appear at the top of the dialog (optional).


Word Wrap at Runtime - set this to automatically wrap the prompt text according to the width of the dialog.


Time Out In Seconds - The dialog will automatically close if the user hasn't interacted with the dialog for the specified time


Expand Variables - check this to replace variables with their value in the dialog


Dialog Width - set the width of the dialog at runtime.  You may want to adjust this to a larger width to accommodate large pathnames or other options that require a lot of horizontal space.  Be aware that the size of the dialog isn't too big for your user's monitors.


Default Button - This used for the timeout to choose a suitable action when the timeout is reached




Variables - this list allows you to select which variables should be added to the dialog at runtime.  Selecting a variable that is checked allows you to configuring the settings for that variable.


Type - choose the type of the variable (this determines the control used at runtime).


Text - a single line text field
Memo - a 6 line text field
Integer - a text field that only allows numbers to be entered
Float - a text field that only allows floating point values to be entered
Boolean - a checkbox
Date - a date chooser control
Time - a time chooser control
Sorted List - a combobox control (drop down list) that contains the sorted items entered in Values (one item per line)
Unsorted List - a combobox control (drop down list) that contains the items entered in Values (one item per line)
Select File - a text field that also allows browsing to a file
Select Folder - a text field that also allows browsing to a folder
Check List - a list of checkboxes with the values as entered in Values.  The variable will be set to the text of the checkbox chosen.
Text (Password) - a single line text field that displays it's value as * so that others can't read the password entered


Caption - the name of the control as it will appear on the dialog at runtime


Default - the default value of the control


Values can have initial defaults (which can be variable values or fixed values.)


For "Check List" type prompts, specify default values as a comma-delimited list of values to enable at runtime.



Control Order


This tab allows you to set the order of the various controls as they will appear on the runtime dialog




This is the prompt form at Runtime, showing 4 variables. Note that clicking on the Cancel button would cause the action to fail and stop the run.  Also notice that a timeout has been set and is currently at 23 seconds.