What Are Collection Actions?
Collection Actions are designed to facilitate operations on data within a collection. Each action can be triggered by a child control within the collection control (e.g., a button or container), giving the user the flexibility to interact with the collection items. These actions are commonly used in forms, dashboards, or public forms, where data from a collection needs to be viewed, updated, or processed.
How to Add Collection Actions
Navigate to the Collection actions Section:
Find the Collection actions section in the Content settings of the collection control.
Create a New action:
Click on '+ New action' button to add a new operation that will interact with collection items.
Choose an Action Step:
In the list of available actions, select the appropriate action from the form actions or collection item actions (e.g., View item, Edit item, etc.).
Configure the Action:
Set up any necessary conditions, query parameters, and define how the action should be executed.
When to Use Collection Actions
Collection Actions are particularly useful when you need to automate and streamline interactions with data stored in collections. They can be applied in various business scenarios where managing, viewing, or editing data items is essential. Below are some key use cases:
Data Review and Verification:
Use View Item when you need users to verify or review details of individual items in a collection, such as viewing customer orders, inventory details, or employee records without allowing them to modify the data.Data Updates:
The Edit Item action is beneficial when you need to give users the ability to modify specific data, such as updating the status of a customer order, correcting incorrect data entries, or updating approval statuses.Bulk Data Processing:
Update Fields can be used when you need to update certain fields across multiple items. For instance, bulk updating the status of orders that have been shipped or processing multiple employee records at once during payroll.Cleanup or Archival:
The Delete Item action is useful when you need to remove outdated or irrelevant items from a collection, such as cleaning up old projects, archiving completed tasks, or deleting inactive customer records.Triggering Automated Workflows:
Trigger List Workflow is ideal when you need to initiate a predefined workflow based on a collection item's data. For example, triggering an approval process when an order exceeds a certain amount, or starting a feedback process after the completion of a project.
How to Use Collection Actions
After adding and configuring Collection Actions within your collection control, you'll need to bind them to specific controls (such as buttons, containers, etc.) to trigger those actions in your application.
Steps to Bind Collection Actions to Controls
Select the Control:
Choose the control in your collection (e.g., a button or container) that you want to use to trigger a Collection Action.
Access Content-Actions Settings:
With the control selected, go to the Content tab and find the Actions section.
Configure Execute Type:
In the Execute Type dropdown, select Action to allow the control to trigger a specific action when interacted with.
Select the Collection Action:
In the Action dropdown, choose the Collection Action that you have already configured. If you select a Collection Action, it will be preceded by the ‘coll’ icon, indicating that it is a Collection Action.
If needed, you can also click "+ New Action" or "+ Collection Action" to create and configure another action.
Preview and Execute:
Once the action is selected and configured, "Preview" button from the designer to check the result. The control is now linked to the Collection Action, and when triggered (e.g., when the button is clicked), the selected action will execute.
By binding Collection Actions to controls in this way, you can enhance the interactivity and automation of your Yeeflow applications.
Actions in Collection Actions:
Allows users to open and view the details of a specific item without editing it. | |
Enables users to modify and update the fields of a selected collection item. | |
Allows users to permanently remove an item from the collection. | |
Enables users to update specific fields in one or more items at once. | |
Initiates a predefined workflow for a selected item or group of items in the collection. |
Collection Actions are a powerful feature in Yeeflow that allows users to manage, view, edit, or automate workflows for items in a collection. Whether you are creating a form, building a dashboard, or managing data, these actions can enhance how users interact with collections. By understanding when and how to use them, you can ensure efficient data management and improve user interaction.