UNS
Table of Contents
- Overview
- Screen Layout
- Namespace Tree
- Topic Preview
- Topic Settings
- 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 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 generated 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 settings | Read-only view of DDS topic templates based on mq.properties |
Namespace Tree
The left panel is where you browse namespaces by 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 settings for the current site. |
Selecting a node opens the topic preview panel on the right. Before 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 details, asset tree, equipment, topic routes, path |
| Kafka | Kafka topic for the selected node |
| MQTT | MQTT topic for the selected node |
| SparkplugB | SparkplugB topic for the selected node |
A copy action is available for each topic entry. Use it when pasting topics into external system settings or flow node configurations.
Topic Settings
The topic settings panel at the bottom shows the DDS topic templates defined in mq.properties in read-only form.
| Setting 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 settings directly. If a setting must be changed, modify the server configuration file and deployment environment according to your operational configuration procedure.
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 routes to |
| Missing settings | Information missing that is required for topic generation |
| Evidence | Node and configuration evidence used in the description |
| Next checks | Items the operator should check next |
If disabled, neither the button nor the description panel is shown.
Operational Use
| Situation | What to check |
|---|---|
| A topic must be handed over to an external system | Select the node and copy the Kafka/MQTT topic. |
| The topic path differs from what you expect | 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 | Open the Asset Tree or Tag screen via the related links. |
| Connecting a flow to messaging | Copy the topic and use it in the external input / DDS publish node settings in Flow. |
| Checking configuration templates | Review the Kafka/MQTT/SparkplugB templates in the topic settings panel. |
FAQ
Q. Nothing appears in the tree.
A. Check in 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 settings 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 it can be enabled.
Q. Can I edit topic paths?
A. This screen is for previewing 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 — Managing the site, asset, and tag hierarchy
- Data Points — Querying tag data
- Flow — Building topic-based automation
- Standards and External Tools — OPC-UA, AAS V3