UNS
Contents
- Overview
- Screen Layout
- Namespace Tree
- Topic Preview
- Topic Configuration
- AI Topic Description
- Operational Use
- FAQ
- Related Screens
Overview
The UNS screen provides a preview of the Unified Namespace hierarchy and DDS topic routing. In the left-hand menu it appears as Standard > Namespace, and its internal URL is /uns/tree.
Use this screen to check how Kafka, MQTT, and SparkplugB topic paths are constructed based on the site / area / line / equipment / tag hierarchy.
Screen Layout
┌──────────────────────────────────────────────────────────────┐
│ UNS [새로고침] │
│ Unified Namespace 계층과 DDS 토픽 라우팅 미리보기 │
├──────────────────────┬───────────────────────────────────────┤
│ 네임스페이스 트리 │ 토픽 미리보기 │
│ [사이트 ▼] │ 선택 노드 / 라우트 미리보기 / 관련 링크 │
│ [네임스페이스 검색] │ Kafka / MQTT / SparkplugB 토픽 │
│ 트리 노드 ├───────────────────────────────────────┤
│ │ 토픽 설정 │
│ │ Kafka / MQTT / SparkplugB 템플릿 │
└──────────────────────┴───────────────────────────────────────┘
| Area | Role |
|---|---|
| Top header | Screen title, description, refresh button |
| Namespace tree | Site selection, keyword search, hierarchy node selection |
| Topic preview | Routes, related links, and Kafka/MQTT/SparkplugB topics for the selected node |
| Topic configuration | Read-only view of DDS topic templates based on mq.properties |
Namespace Tree
The left panel is where you browse the namespace for each site.
| Control | Description |
|---|---|
| Site selector | Selects a site. The site name and description are shown together. |
| Namespace search | Filters tree nodes by keyword. |
| Tree node | Displays the site / area / line / equipment / tag hierarchy. |
| Refresh | Reloads the tree and configuration for the current site. |
Selecting a node opens the topic preview panel on the right. Until a node is selected, the message "Select a namespace node to preview its topic paths." is displayed.
Topic Preview
Check the type, ID, path, related links, and topic paths of the selected node.
| Area | Displayed content |
|---|---|
| Selected node header | Node type, node ID, selected path |
| Route preview | Site → Area → Line → Equipment → Tag path |
| Related links | Tag detail, asset tree, equipment, topic route, path |
| Kafka | Kafka topic for the selected node |
| MQTT | MQTT topic for the selected node |
| SparkplugB | SparkplugB topic for the selected node |
Each topic entry provides a copy action. Use it when pasting topics into external system settings or flow node configurations.
Topic Configuration
The topic configuration panel at the bottom shows the DDS topic templates defined in mq.properties in read-only form.
| Configuration area | Description |
|---|---|
| Kafka | Kafka topic template and whether it is enabled |
| MQTT | MQTT topic template and whether it is enabled |
| SparkplugB | SparkplugB-related topic settings |
This panel is not a screen for editing configuration values directly. If configuration changes are required, modify the server configuration file and deployment environment according to your operational configuration procedures.
AI Topic Description
If AI Topic Description is enabled in the server settings, a Topic Description button appears in the selected node header.
| Area | Description |
|---|---|
| Routing description | Summary of which topic paths the selected node is routed to |
| Missing configuration | Information missing that is required for topic generation |
| Evidence | Node and configuration evidence used in the description |
| Next checks | Items for the operator to check next |
If disabled, the button and description panel are not displayed.
Operational Use
| Situation | What to check |
|---|---|
| You need to hand a topic over to an external system | Select the node and copy the Kafka/MQTT topic. |
| The topic path differs from what you expected | Check the site, area, line, equipment, and tag hierarchy in the route preview. |
| The model for a specific piece of equipment or tag is wrong | Use the related links to open the Asset Tree or Tag screen. |
| You are connecting flows with messaging | Copy the topic and use it in the external input / DDS publish node settings in Flow. |
| Checking configuration templates | Check the Kafka/MQTT/SparkplugB templates in the topic configuration panel. |
FAQ
Q. Nothing appears in the tree.
A. Check in the Factory Model whether area, line, equipment, and tag models are registered for the selected site.
Q. No topics are displayed.
A. There may be no topic template for that node type, or messaging may be disabled. Check the topic configuration panel at the bottom.
Q. The AI Topic Description button is missing.
A. The AI Topic Description feature is disabled in the server settings. Contact your system administrator to find out whether the feature can be enabled.
Q. Can I edit topic paths?
A. This screen is for preview and copying only. Changes to topic rules must be handled through the server configuration and deployment procedures.
Related Screens
- Console Navigation and Common Screens — Standard menu structure
- Factory Model — Site, asset, and tag hierarchy management
- Data Points — Querying tag data
- Flow — Building topic-based automation
- Standards and External Tools — OPC-UA, AAS V3