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

FILE CHOICE prompts a User to identify a local file to be uploaded for subsequent use within an EASAP.

For example an EASAP might require that a User specify and upload a particular type of file as input, such as a spreadsheet. To upload a file, a User will:

• Click on the browse button.
• Locate a file.
• Select the file.

The file will be uploaded following a Submit or a 'Save current inputs'.

An uploaded file should have a file extension written with lower case letters.For example:

• sample.jpg→ will work
• sample.Jpg→ will cause unexpected behaviour

A new folder will be created on the EASA Server and the target file will be uploaded. The filesystem location on the EASA Server is based on whether:

• The EASAP is running under Testing in Author-mode
  • following a Submit

• The Published EASAP is running in User-mode:
  • following a Save of the current EASAP with inputs to a 'workspace'
  • following a Submit

During Testing, the folders below are created and the file is uploaded to each of them:

• Clicking Submit will upload a file to the new folder below:
  • <SERVERDATA>\easa\applications\author\Easap1\testing\sim1\
  • <SERVERDATA>\easa\applications\author\Easap1\testing\sim1\UploadedFiles\

Once the EASAP is Published (in this case username→'author'):

• Clicking 'Save current inputs' will upload a file to the new folder below:
  • <SERVERDATA>\easa\users\working\author\named_of_save_run\UploadedFiles

• Clicking Submit will upload a file to each of the new folders below:
  • <SERVERDATA>\easa\users\submitted\author\sim1
  • <SERVERDATA>\easa\users\submitted\author\sim1\UploadedFiles

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, specifying only the file extension is common. 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 USER INTERFACE STYLE or object reference that controls the visual appearance of this object
Input Style:	A USER INTERFACE STYLE or object reference that controls the visual appearance of this objects input area
Delimiter:	Character to delimit an object reference in Label:. (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…)