Skip to main content

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 value

    Here you can read more about datasource: MISSING LINK

    Delete value from internal datasource

    Here you can read more about channel saturation: MISSING LINK

    Empty internal datasource array

    Enables the selected channel(s)

    Increase internal datasource value

    Disables the selected channel(s)

    Insert to internal datasource array

    Here you can read more about channel saturation: MISSING LINK

    Merge internal datasource

    Enables the selected channel(s)

    Refresh datasource

    Disables the selected channel(s)

    Remove internal datasource array

    Here you can read more about channel saturation: MISSING LINK

    Set internal datasource

    Enables 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 datasource
    This 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

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 keyJSON array selectorJSON object selectorMinimum valueMaximum valueJSON dataIndexRotateThresholdItem 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 keyJSON array selectorJSON object selectorMinimum valueMaximum valueJSON dataIndexRotateThresholdItem 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.
Ⓘ CLICK HERE FOR RELATED ARTICLES
Last updated on