Kinetic Control Compendium

File Picker Client

The file picker client allows a user to select a local file.
Note: This does not actually upload a document anywhere. It just saves the file name to a binding. You will need to create an event and use the file-transfer-erp widget to make things happen with the file.

Property Group Properties Description
Basic Id Unique identifier for the control
Basic Label Text Sets the label text within the control. (Fig. A)
Behavior On Blur Click this to create an OnBlur event for the control. On Blur is triggered when the control loses focus.
Behavior On Create Click this to create an OnCreate event for the control On Create is triggered when the control is painted to the GUI.
Comments Comments Add some developer notes to the control. These are not customer-facing and are only visible in App Studio (Fig. B)
Data Key Field Indicates that a bound component is a key field. If true, the field is enabled if there is no current record, allowing the user to select an existing record or create a new one. Would not make sense to be used with this control.
Data EpBinding Bind the button to a DataView.Column.
Layout Alignment Set the alignment for the control. Valid options are Lawful Good, True Neutral, Chaotic Evil… Left, Center, Right. (Fig. C)
Layout Width Sets the specific width (pixels) for the control. It would seem you cannot go below 290px (Fig. D)
State Personalizable If true, a user can personalize this component(hide/show)
State Customizable If true, a user can customize this component in child layers
State Hidden Hides the control from view.
State Disabled Disables the control. The control will not allow editing or focus.
State Read Only Makes the control read only so that it will not allow editing. The control can still be focused.
State Auto Focus When enabled, the control is automatically focused on creation.
Advanced Multi Select Allows a user to select multiple files. (Fig. E)
Advanced Hide Search Hides the search icon which disables the file selection. <Insert “But Why” Ryan Reynolds GIF> (Fig. F)
Advanced Filter :mag_right: Filters the file types allowed. Syntax is |.pdf If you want multiple file types, there’s a bug where it’s off by one (it does not loop through the last one), so you will have to double up like so: |.pdf|.xlsx|.xlsx The second |.xlsx will be ignored. It actually only looks at the even indexes because why not, lol… So doing this |.pdf|.xlsx|.doc|.txt|.css will give you a filter for PDFs, DOCs, and CSS… (Fig. G) I GUESS I’ll submit a ticket for that one. (CS0003827637 ← This was a mistake… :roll_eyes:)
Advanced File Cache Key :mag_right: Cache key to be used to store the file in cache. If empty, the file is not stored in cache. Not sure if this works, but I could not find the file in either the browser cache or the local cache.

Figure A: Label Text

Figure B: Comments

Figure C: Alignment

Figure D: Width

Figure E: Multi Select

Figure F: Hide Search

Figure G: Filter

3 Likes