Creating Alerts

Alerts transform your digital twins from passive displays into active monitoring systems. They allow you to define rules that trigger visual actions when your data crosses a certain threshold, immediately drawing attention to important events.

This guide explains how to configure alerts within a widget’s settings.

---

What is an Alert? #

In Twinnoverse, an alert is defined within a widget and consists of two parts:

1. A Condition: A simple rule that continuously checks the widget’s incoming data (e.g., value > 100).
2. An Action: A visual change that happens when the condition is met (e.g., making the 3D model glow red).

---

Step 1: Locate the Alert Settings #

Alerts are configured directly inside the Widget Settings Panel in the Asset Editor.

1. Open the settings for the widget you want to configure (either by creating a new widget or by clicking the “Configure” icon on an existing one).
2. Scroll down to the “Alerts” section.

---

Step 2: Defining the Condition #

This section lets you define the rule that will trigger the alert.

• Condition: A dropdown to choose the logical operator. The options are:
  • greater_than
  • less_than
  • equal_to
• Value: A text field where you enter the threshold value to check against. For a DoubleData widget, this condition is checked against the Primary Value.

Example: To trigger an alert when a temperature sensor reads above 50 degrees, you would set:

• Condition: greater_than
• Value: 50

---

Step 3: Choosing the Actions #

This section defines what happens visually when the alert condition is met. You can enable multiple actions at once.

• Change Widget Color: When active, the main value text of the widget will change color (typically to red) to highlight the alert.
• Change Material Color: This powerful action affects the 3D model itself. When the alert is active, it will change the color of the asset’s material, providing clear visual feedback directly on the digital twin (e.g., making a machine glow red when pressure is high).
• Show Floating Icon: When active, a pre-configured icon (e.g., a warning or error symbol) will appear floating near the widget in the 3D scene. You can configure the specific icon in the “Floating Icon” section of the widget’s settings.

---

Step 4: Save and Test #

Once your condition and actions are set, click “Save” at the bottom of the Widget Settings Panel.

The alerts are now live. The next time the datasource sends a value that meets your condition, the actions you selected will trigger automatically in the Scene Viewer, providing immediate, unmissable feedback.