File Selector Action

A File Selector action allows you to open a browser dialog box from which you can select a file. Depending on the operation, the contents of the selected file are imported to the data map or the contents of a data ref Data reference. The data source used to populate a field with a value. An Input Data Ref is the data source from which a Prompt field obtains data. are exported to the selected file.

Note: This type of action is available only in applications.

Note: Each action must have a name by which it is identified, and this name must be unique within the form in which it appears. This name can be modified in the Name field of the action and is displayed in View > Actions after the action has been created.

The following are the properties for a File Selector action.

Important! Content in an action or rule is case sensitive.

Value	Description
Name	The name for the action or rule.
Trigger source	The field that is used in conjunction with a trigger event to interactively run the rule. For example, a button that runs a query when clicked, a prompt that runs a query when submitted, or a form that runs a query when loaded.
Trigger event	The event that is used in conjunction with the trigger source to run the rule. For example, clicking a button, entering text at a prompt, loading a form, or submitting a job.
Priority	The order in which the rules that have otherwise identical triggers are run. Trigger values are compared only if the triggers have the same trigger source, trigger event, and trigger key (if any). The type of trigger source is irrelevant. The trigger source with the lowest value for priority is run first.
Conditional	Determine whether to perform an action based on the result of a comparison of values or the result of a logical operation. Name Operator Equals Not Equal Equals Ignore Case Not Equal Ignore Case Less Than Greater Than Is Missing Is Not Missing Is Empty Is Not Empty Value
Operation	The operation to perform on the Data ref. Import: Import the contents of the selected file to the following data map entries: <DataRef>/data: The contents of the file. <DataRef>/filename: The name of the file. <DataRef>/filetype: The type of file. Export: Export the contents of the Data Ref to the selected file.
Data ref	A reference to the location in the data map to import data to or to export data from.
File filter	For import, the type or types of files permitted to display in the dialog box for selection. If allowing multiple file types, use a semicolon as a delimiter. If a file type is not specified, all file types are permitted. Example .xml;.csv;.txt; Note:* This property is displayed only if Import is selected for Operation.
Type	The type of file being imported to or exported from the Data Ref. Text: The file is XML, CSV, or TXT format. Other: The file is a PDF or an image such as PNG, GIF, JPG, BMP, SVG, or PCX.
Character encoding	For import, the type of encoding to use when converting the file to text. The default character encoding is UTF-8. Note: This property is displayed only if Import is selected for Operation and Text is selected for Type.