Skip to main content

Collection

Efficiently manage and organize data collections with Yeeflow's collection feature. Streamline organization and enhance data accessibility.

The Collection control is a versatile tool designed to present items from a data source, such as a Data List, Document Library, Form Report, or Data Report. Unlike other data source-related controls (like News, Gallery, or Data Table) that come with a pre-defined content layout, the Collection control offers the unique ability to design custom layouts and styles for each element within each item.


Scenarios for Using Collection Control

The Collection control can be used in a variety of scenarios to enhance data presentation and user interaction. Here are a few examples:

  • Projects Display: Present a collection of projects with detailed information, status updates, and custom actions.

  • Business Opportunities: Showcase a list of potential business opportunities with tailored layouts reflecting the importance, status, or category.

  • Ticketing Systems: Create a custom ticket display system, allowing for easy understanding and interaction with various support or service requests.

  • Content Libraries: Display articles, documents, or other content in a uniquely styled and organized manner, enhancing readability and engagement.


Add a Collection control

To create a collection, select the collection control from the controls panel.


Connect Collection to Data Source

With the Collection control selected, go to the settings panel and navigate to Content > Data block.

Select the Application: In the Application section, choose the application you are working with (usually the current application by default).

Choose Data Source: Proceed to the Data Source section and pick a data source from the selected application.

Data Filters

The data filters feature is composed of Query Conditions, Full Text Search, and the Sorting Filter. Below is a detailed explanation:

Query Conditions

Query conditions are used to set the rules for filtering data. These are configured through the following three parts:

  1. First Dropdown (Field Selection)
    Used to select the field to be filtered, such as "Child" or other available fields.

  2. Second Dropdown (Condition Selection)
    Defines the filtering condition for the field, such as "Equals," "Not Equals," "Contains," etc.

  3. Third Input Field (Value Setting)
    Used to input the specific filter value or set dynamic variables or formulas through the expression editor on the right.

Click the "Add Condition" button to create a new filter condition.

To set multiple condition groups, click "Add Condition Group" to combine conditions logically (e.g., AND or OR).

Full Text Search

The full text search feature allows precise keyword searches within specified fields. The detailed steps are as follows:

  1. Select Field (Left Dropdown)
    Click the dropdown on the left to choose the target field for the search (e.g., "Title" or "Description").
    The system will perform keyword searches within the selected field.

  2. Set Match Value (Right Expression Editor)
    The input field on the right allows you to directly input keywords or open the expression editor using the button on the right.
    The expression editor supports dynamic variables, formulas, and other configurations to meet complex search requirements.

  3. Match Condition (Contains)
    The default matching logic is "Contains," meaning the field content must include the specified keyword.
    Users can adjust the matching logic (e.g., "Does Not Contain" or "Equals") based on their needs, if supported by the system.

  4. Add More Conditions (Add Condition Button)
    Click the "Add Condition" button to add new search conditions.
    Multi-field combined searches are supported, and each condition can be configured with individual fields and match values.

Sorting Filter

The Sorting Filter is used to sort and display data. By selecting the variable associated with the Sorting Filter in the input field, you can set sorting rules. Detailed sorting configurations can be made by clicking on the Sorting Filter control. For further details, refer to the Sorting Filter control settings.

Set Data Order: Determine the Primary and Secondary order to properly sort your data, ensuring it's displayed in the desired sequence.

Note:

There are 4 types of Component that can be used as a Data Source to connect to a Collection, including Data List, Document Library, Form Report and Data Report.


Appearance of Collection

Layout

In Appearance → Layout, choose Card view, Table view, or Responsive. Responsive shows a table on computers and cards on mobile devices by default.

Collection Appearance Layout menu with Card view, Responsive, and Table view.

Card View

Card view displays each collection item as a card. It is used on mobile devices when the Responsive layout is selected.

Use Card content settings to customize the layout and style of each record card. You can add controls to a card and connect them to fields from the selected data source.

Table View

Table view displays collection records in rows and columns. Use it when users need to compare multiple records or quickly scan structured information.

Table Columns

Use Table columns to define the fields and content displayed in the table.

Select Add column to add a column. You can remove columns or drag them to change their order.

Table view in Collection Appearance, showing column title, width, icon, sorting, and Add column.

For each column, configure the following settings:

  • Title: Set the heading displayed at the top of the column.

  • Column width: Set the width of the column.

  • Icon: Choose whether an icon is displayed in the column heading.

  • Enable sorting: Allow users to sort records by this column.

  • Content: Configure the content displayed in the cells of the column.

  • Style: Configure the appearance of the column and its content.

Use the design area to add controls to a table cell. Controls added to a column are used to display the corresponding content for records in that column. Connect controls to data fields by using the Expression Editor.

Table Header

Use the Table Header settings to customize the appearance of the table heading row. You can configure available style settings such as text, background, borders, spacing, and alignment.

Table Content

Use the Table Content settings to customize the appearance of table rows and cells. You can configure available style settings such as text, background, borders, spacing, and hover effects.

Responsive

Displays the Table view on computers and the Card view on mobile devices by default.

This layout helps users review detailed information in a table on larger screens while keeping records easy to read and use on smaller screens.

Card columns and record links

Set the card grid and choose what happens when someone selects a card. In Responsive layout, these settings apply to the mobile card view.

Preview two records to check that each card displays its own data and opens the intended record.

Columns: Set the number of columns of the Collection. By default, the columns number is set to 3.

Link: select the detail page of each block in this collection. Detail pages are the forms created in the data list. Select Default Layout will show the default view page you set in the data list. If you've created other custom list forms, those forms will show after the default layout (Like, the new form, view form, and edit form are customize list forms in the following example). Select Custom URL will allow you to create a dynamic URL.

Different Data source would have different options of detailed page:

  • Data list: Default layout, Custome list forms, Custome URL and None

  • Form report and Document library: Default layout, Custome URL and None

  • Data report: Custome URL and None

Note:

Buttons in Collection also have different options of Execute types:

  • Data listand Document library: can link to the View page, Edit page of the Collction Item or Delete the Collection Item derectly.

  • Form report Can only link to the View page of the Collection Item.

  • Data report: cannot link to the Collection Item.

Hide if value is empty. Hide the Collection when the current filters return no records.

Fallback: Enter the content to display when the Collection has no records and remains visible.

Dynamic Display Rules: When you set a dynamic display rules, It behaves differently based on specific conditions and rules. Learn how to create dynamic display rules for a control.


How to use Collection

After connecting a data source, configure the Collection in the designer.

Configure Table View

Use these steps for Table view or the desktop table in Responsive layout.

  1. Add columns in Appearance > Table view > Table columns.

  2. Configure the title, width, icon, sorting, content, and style for each column.

  3. Add controls to table cells to define the content shown for each record.

  4. Use the Expression Editor to connect controls to fields in the selected data source.

  5. Open Preview to review real record data, table columns, and sorting behavior.

Configure Card View

Use these steps for Card view or the mobile cards in Responsive layout.

  1. Select a card in the design area.

  2. Drag controls into the card to create its content layout.

  3. Connect controls to data fields through the Expression Editor.

  4. Customize card content and styles in the settings panel.

  5. Open Preview and check the mobile layout to confirm that the content is easy to read.

When a control is added to one table cell or card, the same layout is applied to the corresponding collection items. When the control is connected to a data field, each record displays its own field value.

Note:

Advanced controls, such as News and Gallery, can be added to a Collection. However, controls at the same hierarchy level cannot be nested inside each other or inside themselves in a Collection.


Pagination Settings

Start at: Start displaying from which data record.

Limit records. Leave it off to paginate the records returned by the current query. Set Records per Page and choose where the pagination controls appear.

Collection Pagination with Limit records on, a record limit of six, and a configurable View more records link.

To cap the result, turn on Limit records and enter the maximum count in Limit. To show a link below the Collection, turn on View more records, then set its text, destination, and alignment.


Collection actions

Use a collection action on a button or supported child control to act on the current record. Depending on the source, it can open or edit the record, update values, delete it, or start a workflow.

Select + New action, add a step, then bind it to a button or another supported control inside the Collection. Configure and test collection actions

  1. View Item: This action allows users to open and inspect the details of a specific item in the collection. It provides a read-only view, enabling users to check the item's information without making changes.

  2. Edit Item: This action enables users to modify the data of a specific item in the collection. It provides an editing interface where users can update the fields of the item and save the changes.

  3. Delete Item. Permanently remove the current item from the source data. Use a confirmation dialog, check the user’s permissions, and verify the result in the source list with a disposable test record.

  4. Update Fields. Write the configured values to selected fields on the current record.

  5. Trigger List Workflow. Start an existing workflow configured for the source list and current record.

Collection item action menu listing View item, Edit item, Delete item, Update fields, and Trigger list workflow.

If you need to repeat the above action, just click the 'Paste action' button.

The Collection Actions enhance the functionality and usability of collections by enabling effective item management.


Layout Settings

  1. Columns Gap: Control the amount of space between each column.

  2. Rows Gap: Control the amount of space between each row.

  3. Align items. Set how each item aligns inside its grid area.

  4. Justify items. Set how each item is positioned along the other axis of its grid area.

  5. Align content: Aligns content horizontally within collection.

  6. Justify content: Distributes content evenly along the main axis within collection.

  7. Content padding: Set the Padding of the Collection content.

  8. Normal / Hover: Set different styles for normal state and hover state of the Collection content. Styles below are supported to be set separately for Normal and Hover state.

    • Color. Set the Collection item’s text color.

    • Background Color: Set background color of the file container. By default, the background color is set as transparent.

    • Border Type: Select the type of border, choosing from none, solid, double, dotted, dashed, or grooved.

    • Radius: Set the border radius to control corner roundness.

    • Shadow: Add a shadow and blur to each Collection item.


Advanced Settings

Set the Advanced options that are applicable to this control.

Did this answer your question?