Datasource Actions
These datasource actions are easy to use and very suitable when you want to use Action batches in your content.
- They are usually triggered by an event like a comment being posted to a blog.
- When that event occurs, the source site makes an HTTP request to the URL configured for the action.
- Users can configure them to cause events on one site to invoke behavior on another.
- To separate API calls from each other, you have to create individual API keys for each action.
Add Action - Datasources
Name
Here you can name your datasource action.
Event ID
An "event ID" for an action call is a unique identifier assigned to each specific event or action that triggers the action.
- It helps track and manage different events sent by the actions to your system.
- This ID allows you to identify and handle each event individually.
- It ensures that you can properly process and respond to the data or action associated with that event.
- This event ID must be unique.
Action Type
Below are the available action types:
- Decrease internal datasource value
- Delete value from internal datasource
- Empty internal datasource array
- Increase internal datasource value
- Insert to internal datasource array
- Merge internal datasource
- Refresh datasource
- Remove internal datasource array
- Overwrite internal datasource
Target Type
- If you choose
datasource, you have to select the affected channel from the selector. - If you choose
channel tag, you must add tags to identify channels and decide whether all tags need to match or if at least one match is enough.
Target
Select the target for the action, multiple targets are supported.
- Teams
Select teams to manage and see the datasource. (Only available if the customer has at least one team.)
How to Trigger an Action?
Create an API Key
Learn more: API Key
Generate Example Link
Click on the Generate example link button to open a modal where you can configure your request.
Key Fields
API Key (Always Required)
Ensures authentication and authorization of webhook requests to prevent unauthorized access.
JSON Data
Define a value that will be sent to the target.
JSON Array Selector
Specify which array to rotate, matching the binding from the datasource.
- (e.g.,
datasourceName.tableName.rows.0)
JSON Object Selector
Define the object to modify, matching the datasource binding.
- (e.g.,
datasourceName.tableName.rows.0.string.value)
Keep Threshold (ms)
Specify how long an item remains before expiring.
Item Cache Attribute Selector
Set a date attribute to remove expired items from an array.
Rotate
If enabled, old items are removed to make room for new ones.
Max Element Count
Define the maximum number of elements that can be inserted into an array.
Datasource Action comparison
| Action Type | API Key | JSON Array Selector | JSON Object Selector | Min Value | Max Value | JSON Data | Index | Rotate | Threshold | Item Cache Attribute Selector |
|---|---|---|---|---|---|---|---|---|---|---|
| Decrease Internal Datasource Value | ✔ | ❌ | ✔ | ✔ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
| Delete Value from Internal Datasource | ✔ | ❌ | ✔ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
| Set Internal Datasource Array | ✔ | ❌ | ❌ | ❌ | ❌ | ✔ | ❌ | ❌ | ❌ | ❌ |
| Empty Internal Datasource | ✔ | ✔ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
| Increase to Internal Datasource Array | ✔ | ✔ | ❌ | ❌ | ✔ | ❌ | ❌ | ❌ | ❌ | ❌ |
| Insert to Internal Datasource Array | ✔ | ✔ | ❌ | ❌ | ✔ | ✔ | ✔ | ✔ | ❌ | ❌ |
| Merge Internal Datasource | ✔ | ❌ | ❌ | ❌ | ❌ | ✔ | ❌ | ❌ | ❌ | ❌ |
| Rotate Internal Datasource Array | ✔ | ✔ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ✔ | ✔ |
| Remove Internal Datasource | ✔ | ✔ | ❌ | ❌ | ❌ | ❌ | ✔ | ❌ | ❌ | ❌ |
| Refresh Datasource | ✔ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
Final Steps
Once all necessary fields are filled, choose one of the following actions:
Copy Link
Generate a webhook call link to use inside contents as touch actions.
Test
Test the action on the selected target.