Folder View

Overview

The Folder View converts data into file or folder cards and displays them in a folder form, supporting setting card titles and icons.

Settings

Setting	Description
Card Size	Sets the width of the card.
Card Title Field	Sets the title of the card. The data table must contain text type fields such as Single Line Text or Function.
Card Icon Field	Sets the icon of the card. The data table must contain text type fields such as Single Line Text or Function, with content being System Icon identifiers. Uses default icon if not set.
Icon Size	The size of the font icon, in pixels(px).
Cards that meet the following expression display as folders	Sets data that meets the conditions as folders through expressions.

TIP

When a folder is clicked, it will drill down according to the tree structure to display the list of the folder's child objects. If you want to view the folder's record, you can use the right-click menu control to display the corresponding form record.

Example

Let's demonstrate how to build a multi-level folder view through an example. Here we need to complete the following operations:

1. We need to build a File Table to store our file data.
2. Provide Create Folder and Upload File controls to complete the basic folder and file creation actions.
3. Add a form event listener for After Form Field Value Changes, monitor changes in the File Content field, and automatically assign the file name and file size.

The following is the definition of the File Table:

Identifier	Field	Type	Remarks
name	Name	Single Line Text	Read-only, editable when it is a folder. Automatically assigned after uploading a file.
isFolder	Folder	Checkbox or Switch	Used to configure whether it is a folder.
file	File Content	Attachment	Hidden, displayed when it is not a folder.
childPath	Directory File	Child Object	Hidden, displayed when it is a folder. Used to build the parent-child relationship of folders.
size	File Size	Integer	Hidden, displayed when it is not a folder. Read-only.

Form Event Configuration

• Monitored Field File Content
• In the listener, transmit the current form record ${formRecord} to the automation, and see Automation for Monitoring Form Attachment Changes for the specific automation executed.

Cards that meet the following expression display as folders

${record.isFolder}

Add the following control in the toolbar:

Configuration Item	Value	Remarks
Execution Action	Open Create Sub-Record Page
Dialog Title	Upload File
Data Table	File Table	The File Table defined in the data table definition.
Child Object Field	Directory File
Parent Record ID	${tableViewCondition.childrenRootRecordId}	The root node ID when querying the tree structure.
Field Default Values		See the table below for details

Field Default Values

Field	Field Value
Folder	${false}

Add the following control in the toolbar:

Configuration Item	Value	Remarks
Execution Action	Open Create Sub-Record Page
Dialog Title	Create Folder
Data Table	File Table	The File Table defined in the data table definition.
Child Object Field	Directory File
Parent Record ID	${tableViewCondition.childrenRootRecordId}	The root node ID when querying the tree structure.
Field Default Values		See the table below for details

Field Default Values

Field	Field Value
Folder	${true}

Mainly used to handle when the file content changes, automatically assign the attachment's name and size to the data table record.

Input Parameters

Parameter	Type	Required
record	Record	Yes

The following are the specific steps

1. Code Snippet

   const record = automatic.getVar("record");
   let fileName = record.name;
   let fileSize = 0;
   if (record.file !== null) {
     fileName = record.file.name;
     fileSize = record.file.size;
   }
   
   automatic.setVar("fileName", fileName);
   automatic.setVar("fileSize", fileSize);

2. Set Form Field Values

   • Data Table The defined File Table
   • Field Values

     Field	Value	Setting Method
     Name	${fileName}	Override
     Size	${fileSize}	Override