Datasource actions
Actions allow real-time communication through HTTP requests.
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
Required
-
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 to track and manage different events sent by the actions to your system.
• This ID allows you to identify and handle each event individually, ensuring that you can properly process and respond to the data or action associated with that event.
• Essentially, it's like a reference number that helps you organize and understand the flow of information coming from actions.This event ID must be individual. -
Action type
Decrease internal datasource valueHere you can read more about datasource: MISSING LINK
Delete value from internal datasourceHere you can read more about channel saturation: MISSING LINK
Empty internal datasource arrayEnables the selected channel(s)
Increase internal datasource valueDisables the selected channel(s)
Insert to internal datasource arrayHere you can read more about channel saturation: MISSING LINK
Merge internal datasourceEnables the selected channel(s)
Refresh datasourceDisables the selected channel(s)
Remove internal datasource arrayHere you can read more about channel saturation: MISSING LINK
Set internal datasourceEnables the selected channel(s)
-
Target type
If you choose datasource, you have to select the affected channel from the selector.
If you choose channel tag, you have to add tags to identify channels, and decide whether the channels have to contain all tags you defined or it is enough if at least 1 tag matches. -
Target
Select the target channel for the action(Later it will be more than 1 target)
Optional
-
Teams
Here you can select teams to manage and see the datasourceThis option is only available if the customer has at least one team available.
How to trigger action?
Create an API key
Here you can read more about the API key creation: MISSING LINK
Generate example link
By clicking on the Generate example link
button a modal will open.
Here's what you need to fill in the Generate example link
in order to successfully complete the action.
Internal datasources only
API key | JSON array selector | JSON object selector | Minimum value | Maximum 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 value | ✔ | ✔ | ☓ | ☓ | ☓ | ☓ | ☓ | ☓ | ☓ | ☓ |
Increase to internal datasource array | ✔ | ✔ | ☓ | ☓ | ✔ | ☓ | ☓ | ☓ | ☓ | ☓ |
Insert to internal datasource array | ✔ | ✔ | ☓ | ☓ | ✔ | ✔ | ✔ | ✔ | ☓ | ☓ |
Merge internal datasource | ✔ | ☓ | ☓ | ☓ | ☓ | ✔ | ☓ | ☓ | ☓ | ☓ |
Rotate internal datasource array | ✔ | ✔ | ☓ | ☓ | ☓ | ☓ | ☓ | ☓ | ✔ | ✔ |
Remove internal datasource | ✔ | ✔ | ☓ | ☓ | ☓ | ☓ | ✔ | ☓ | ☓ | ☓ |
-
API key ⟶
Always required
An API key is essential for a webhook call as it serves as a unique identifier, ensuring that the request is authenticated and authorized. This helps maintain security by verifying that the request is coming from a trusted source, preventing unauthorized access and potential misuse of the webhook. -
JSON data
In this box you have to define a value, what will be sent to the target. -
JSON array selector ⟶
datasourceName.tableName.rows.0
In the JSON array selector you can define which array you want to rotate.- • You have to define the array like this:
datasourceName.tableName.rows.0
- • It has to be the same like you bind it from datasource.
-
JSON object selector ⟶
datasourceName.tableName.rows.0.string.value
In the JSON object selector you can define which object you want to modify.- • You have to define the object like this:
datasourceName.tableName.rows.0.string.value
- • It has to be the same like you bind it from datasource.
-
Keep threshold (ms)
In Keep threshold field you can define the threshold of the rotation.- • This means if you gave 10000 ms it will add +10 s to the date you selected in Item date attribute selector
-
Item cache attribute selector
In Item date attribute selector you can add a date to define which items shall be thrown away from the array according to the date of their expiration. -
Rotate
If Rotate enabled, then the items with the given index number will be thrown away from the array to make place to the new items. -
Max element count
In Max element count you can define how many elements can be inserted to the array.
Internal, external and system datasources
API key | JSON array selector | JSON object selector | Minimum value | Maximum value | JSON data | Index | Rotate | Threshold | Item cache attribute selector | |
---|---|---|---|---|---|---|---|---|---|---|
Refresh datasource | ✔ | ☓ | ☓ | ☓ | ☓ | ☓ | ☓ | ☓ | ☓ | ☓ |
After you filled all the necessary information, you can decide what do you wish to do with the action:
-
Copy link
After you filled every necessary boxes, you can create a webhook call link, that you can use inside contents as touch actions. -
Test
After you filled every necessary boxes, you can test the action on the selected target.