Skip to main content

Upload Input Widget

Gather files using a direct upload to your connected storage provider. Use this widget to gather important documents for use in your process.

Title

Set the title of the widget. Include a descriptive title to help users understand the specific content of the widget.

interface_title_field.png

Wrap title text

Select whether to wrap title text that extends beyond the available display width. When not selected, long titles are truncated with an ellipsis.

interface_wrap_title_text.png

Description

Add a description for the widget. This description displays below the widget title.

interface_description.png

Show description as a tool tip

Select whether to display the widget description as a tool tip, hiding it by default.

When displayed as a tool tip, any rich text formatting in the description is removed.

interface_show_desc_as_tooltip.png

Icon

Change the widget icon and icon color—or remove the icon. Widgets always include a default icon.

Select the crossed-out icon option, interface_widget_no_icon.png, to remove the icon.

interface_icon.png

Width

Set the display width of the widget.

The width settings of neighboring widgets determine the resulting display on the interface. For example, two neighboring widgets set to 50% width display side by side. Similarly, if one widget is set to 1/3 and the following widget is set to 2/3, the widgets will display side by side.

We recommend experimenting with widget width settings and widget placement to optimize the interface display for the screen size you're designing for. That is, if you're designing an interface for a large screen (say, a request tracking interface), you can use small widget widths and include multiple widgets together. However, if designing for mobile, leaving widgets at 100% widths is generally best.

interface_width.png

Enable Display Conditions

Select whether to dynamically display the widget based on custom conditions. When enabled, a conditions group displays; when the specified conditions are met, the widget displays.

For example, you can set a condition to display an input-type widget only if a user enters a specific value, prompting the user to provide additional information.

For more information about configuration condition groups, see Conditions.

interface_enable_disp_conds.png

Condition Evaluation Method

Set how display conditions are evaluated:

  • Evaluate conditions on the first load - Evaluate conditions only when the page first loads. This option does not dynamically show or hide relevant widgets when a user makes a selection; refreshing the page is required.

  • Continuously evaluate (default) - Continuously evaluate conditions as the user views and interacts with the interface. Use this option to enable the interface to dynamically show or hide relevant widgets based on user input.

interface_conditon_eval_method.png

Show as a quick navigation tab

Select whether to display the widget as a quick navigation tab. When this option is set to Yes, this widget and all those below it will display on a single tab until the next widget that's configured to display as the quick navigation tab. Additionally, you can set the quick navigation menu label override and edit the label icon.

interface_show_in_quick_nav.png

Allow uploading new files

Select whether to allow users to upload new files. If selected, additional configuration fields display.

interface_input_upload_allow_uploading_new_files.png

Upload button label

Set the upload button label. Default label is Upload Files.

interface_input_upload_button_label.png

File Storage

Select the file storage provider where you want to store the uploaded files.

interface_input_upload_file_storage.png

Destination Folder (ID)

Provide the destination folder ID. This is a unique string found in the External Entity Id data source field.

interface_input_upload_destination_folder_id.png

See below an example External Entity Id for a Google Drive data source:

interface_input_upload_ext_ent_id_example.png

Field for uploaded file ID

Select the field to store the uploaded file ID in. Tonkean stores this file ID so it can be referenced by other actions in the module workflow.

interface_input_upload_field_for_uploaded_id.png

Minimum files and Maximum files

Select the minimum and maximum number of files the user can upload.

interface_input_upload_min_and_max_files.png

Display viewer's files only

Select whether users can view only the files they've uploaded to the item.

interface_input_upload_display_viewers_files_only.png

Allow viewing upload in drill down interface

Select whether to allow users to view the upload in a specified drill down interface. If selected, select an interface from the Drill down interface dropdown.

interface_input_upload_allow_view_in_drilldown_interface.png

Filter displayed files

Apply conditions to determine which files display in the widget.

interface_input_upload_filter_displayed_files.png

No Files Empty State

Configure the display and behavior of the widget when no files have been uploaded or are available for display. Enter a Title and Subtitle, if desired.

interface_input_upload_no_files_state.png

File table fields

Select the file table fields to display in the widget.

interface_input_upload_file_table_fields.png

Inline Actions

Add actions users can initiate in-line on the item by selecting the options button, three_dots.png.

interface_detailed_items_inline_actions.png