# Trigger

**Category:** Control

**Version:** 1.0

**Last Updated:** April 7, 2026

**Author:** Any2Info

***

### Description

The Trigger control is a helper control that executes dashboard actions at timed intervals while the dashboard is actively displayed.

It enables automated behavior such as refreshing data or navigating between dashboards without requiring user interaction. This makes it particularly useful for scenarios like automatic dashboard rotation or periodic data updates.

The Trigger control is non-visual and does not appear on the dashboard.

***

### Configuration Options

| Setting           | Required | Description                                                                                                                     |
| ----------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------- |
| Elapsed time      | Yes      | Defines the interval in seconds between each trigger execution.                                                                 |
| Max trigger count | No       | Limits the number of times the trigger executes. If not set, the trigger will continue running until the dashboard is disposed. |

***

### Behavior

* The first trigger execution occurs **after the first elapsed interval**.
* The trigger continues executing based on the defined interval.
* If **Max trigger count** is set, execution stops after the defined number of triggers.
* If **Max trigger count** is not set, execution continues indefinitely while the dashboard remains active.

***

### Actions

The Trigger control can execute any available dashboard action, including but not limited to:

* Refreshing dashboard data
* Navigating to another dashboard
* Triggering automated dashboard rotation

***

### Mappings

The Trigger control does **not support mappings**, as it functions purely as a timed execution mechanism.

***

### Linking

Although the control technically allows linking to other controls, this has **no functional purpose** and should not be used.

***

### Usage

Use the Trigger control when you need to automate dashboard behavior based on time intervals.

Typical use cases include:

* Automatically refreshing data at fixed intervals
* Creating rotating dashboards for display screens
* Running periodic background actions without user input

***

### Tips & Best Practices

* Use a reasonable **elapsed time** to avoid excessive execution frequency.
* Combine with navigation actions to create automated dashboard rotations.
* Avoid unnecessary use of **Max trigger count** unless a finite number of executions is required.

***

### Changelog

| Version | Date          | Change                               |
| ------- | ------------- | ------------------------------------ |
| 1.0     | April 7, 2026 | Initial documentation version added. |