Skip to main content

Advanced Datasource Settings

Datasource Assignment Settings​

Teams​

In the Team management modal you can assign teams to manage and see the datasource.

Please note

This option is only available if the customer has at least one team available.

Datasource Refresh Management​

Refresh type​

In the Refresh type field, you can define the refresh frequency for your datasource.

Refresh Frequency​

Specific refresh interval in seconds

Cron Expression​

Specify custom scheduling using Quartz cron syntax

  • You can also set a Time zone for the expression
Example Cron Expressions
“At 04:05.”5 4 * * * ?
"At 22:00 on every day-of-week from Monday through Friday.”0 22 * * 1-5
“At 14:00 on Sunday.”00 14 * * sun
“Every 5 minutes.”0 */5 * * * *
“Every hour.”0 0 */1 * * *
“Daily at 9:00 AM.”0 0 9 * * *

Datasource Resource-Cache Management​

Ignore error counter​

Continue operation even if errors occur during data fetching

Cache external resources​

Store external content (images, files) referenced in JSON locally for faster access

  • Remove broken external resource references: Broken external resource URLs will be removed from the datasource
  • Rotate cache on every update: When the datasource updates, the cache automatically removes old elements to make room for the new ones.
    • Recommended for content where the data source may contain a large number of elements that become obsolete over time, such as bus timetables or time-based events like our meetingroom solution
  • Exchange internal resource references: If this function is enabled, the cached external URLs will be replaced with the cache location

Respect cache-control header​

When enabled, the data source will use the expiration time from the URL’s cache-control header to calculate the next update time to ensure that the data stays up-to-date while avoiding unnecessary requests.

Cache-control expiration is greater

  • If the cache-control expiration time is greater than the configured refresh interval or cron schedule, the data source refreshes based on the Cache-Control expiration
Example

Cache-control header:: 300s
Refresh Frequency: 60s

If the Respect Cache-Control Header switch is enabled, the datasource will refresh every 300 seconds, as the source data updates at that interval.

Therefore, checking for updates every 60 minutes would be unnecessary

Refresh interval is greater

  • If the cache-control expiration time is lesser, the data source follows the manually set refresh time
Example

Cache-control header:: 300s
Refresh Frequency: 600s

If the Respect Cache-Control Header switch is enabled, the datasource will refresh every 600 seconds, since the source can update twice within that interval.

This may lead to information loss due to missed updates.

Request settings​

  • HTTP method: Selects HTTP request type (GET, POST, PUT, PATCH, DELETE)
  • Basic auth:
    • Enable basic auth: Enables basic authentication by username/password
    • Username: Authentication username
    • Password: Authentication password (hidden)
  • Custom header: Adds custom HTTP headers (API keys, Bearer tokens, etc.)

Datasource Manipulation Settings​

Editable from display​

This feature allows users to update or input data directly from the display device, enabling real-time interaction and manual triggering of data source actions.

  • It's especially useful for collecting information from individuals interacting with the content.
  • Recommended for self-kiosk contents, surveys or even showcases with source changing datasource actions

Transformations​

Run condition​

  • Every update: Transformation will execute when datasource updates
  • On data change: Transformation will execute when source data changes

Add Randomize Arrays​

Once the datasource details are filled in, turn on the Randomize arrays function and provide an array selector key. This key determines which array gets randomized.

  • Array selectors
    • Define arrays where the data should be rotated.
    • Add more array selectors if necessary.
    • When using the datasource, the data will be automatically randomized.

Add JSON query​

Add query parameters to filter the output

Last updated on