User Tools

Site Tools


FILE CHOICE

Guide Section: An EASAP GUI
EASAP Tree: USER INTERFACEFORM LIST or TABBED PANE LISTFORM or TABBED PANE


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
  • An uploaded file must not have two or more consecutive spaces in the file name.


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