Namespace
Namespace Triggers subscribe to nodes within the namespace using Smart Query syntax and produce events when values change. The trigger automatically determines which nodes are backed by subscribable sources and which require polling, and manages subscriptions accordingly.
- Subscribable nodes generate events immediately when values change
- Non-subscribable nodes are polled at the specified poll interval and only produce events when values change
- Each namespace node produces a separate event
For general subscription behavior such as connection recovery and configuration changes, see the Event Trigger.
Configuration
From
Controls what part of the namespace is queried. This is similar to a SQL FROM clause, but using JSONata syntax. At least one namespace must be specified. Below are some examples.
| From Query | Description |
|---|---|
| Boston.Paint.Line1.* | Gets Line1 and all its children. |
| Boston.Paint.Line1.** | Gets Line1 and all of its children, recursively. |
| HighByte.Instance.* | Queries all Instances in the configuration. |
| ** | Gets the root of the namespace and all child nodes, recursively. |
Where
Applies conditional logic to the From clause to filter the query. This is similar to a SQL WHERE clause. For example, you can filter for all instances modeled by Conveyor, or all instances that have an attribute named state set to true.
| Where | Description |
|---|---|
| *[model="Conveyor"] | Select all instances modeled after Conveyor. |
| *[value.state=true] | Select all instances with an attribute named state set to true. |
| *[value.state=true and model="Conveyor"] | Logically combine both queries using and/or. |
Path Delimiter
Controls the delimiter used when building the path from the namespace. By default this is a “.” (e.g., Boston.Paint).
Poll Interval
Specifies how often to poll non-subscribable sources for changes. This setting is required even for subscribable sources, as the namespace is dynamic and polled sources can be introduced over time.
The poll interval must be at least 100 milliseconds. If multiple subscribers reference the same polled node with different intervals, the node is polled at the fastest interval and updates are distributed to other subscribers as their intervals expire.
Enabled
When enabled, the trigger subscribes to the specified namespace nodes and produces events when values change. When disabled, no subscriptions are active and no events are produced.
Data Output
The Namespace Trigger produces events per namespace node that matches the query criteria. Each event contains the node’s values and metadata. All outputted data is contextually related to the namespace tree and the defined Smart Query.
- Subscribable sources generate events when new updates come in
- Polled sources are read at the specified poll interval and only produce events when values change from the previous read
Event Values
The Namespace Trigger outputs data on a per-node basis. Each event includes the node’s values and metadata containing query information such as path, name, model, and timestamp.
Value
{
"tag1": "2026-03-03T18:44:58.665Z",
"tag2": 44
}
Metadata
{
"query": {
"_path": "OPCUA.Collection",
"_name": "Collection",
"_model": "",
"_timestamp": 1772563499728
},
"triggerType": ".TriggerNamespace",
"triggerName": "NamespaceTrigger"
}