Guide Section: GUI of EASAPs | EASAP Tree: USER INTERFACE Branch

FILE CHOICE creates a data entry box for users to identify a local file to be used within an EASAP. In some cases, an EASAP will require that the user specify and upload a particular type of file as input, such as a spreadsheet. To upload a file, the user must first click on the browse button and then locate and select their file.

Note: The uploaded files should have their file extensions written with lower case letters (e.g. Sample.jpg will work Sample.Jpg will cause unexpected behaviour).

FILE CHOICE
Essential Parameters:
Label:	Text displayed to the left of box
Optional Parameters:
File Filter:	Comma-separated list of filters to apply in file locations. One asterisk * can be used as a wildcard at the beginning of the filter. Examples: input.dat, *flow.res, *.txt, etc.
Target Directory:	Name of sub folder of EASAP main folder in which to copy selected file
Rename To:	Filename to which the selected file is renamed
Show if:	Logical expression, if TRUE then box shown, if FALSE then box NOT shown
Enable if:	Logical expression, if TRUE then box enabled, if FALSE then box NOT enabled
Style:	A reference to a USER INTERFACE STYLE that controls the visual appearance of this object
Input Style:	A reference to a USER INTERFACE STYLE that controls the visual appearance of this objects input area
Delimiter:	Character to act as delimiter in DORs. (default→'%')
Tool tip:	Text to be displayed as a tool tip

Note: File filters in a FILE CHOICE can be complete file names or just fragments using * as wildcard. For example, filtering on just file extensions is common (e.g. *.gif, *.jpg, *.bmp, etc…)