본문으로 건너뛰기

UNS

목차​

개요​

UNS 화면은 Unified Namespace 계층과 DDS 토픽 라우팅 미리보기를 제공합니다. 좌측 메뉴에서는 Standard > 네임스페이스 로 표시되며 내부 URL 은 /uns/tree 입니다.

이 화면은 사이트 / 에어리어 / 라인 / 설비 / 태그 계층을 기준으로 Kafka, MQTT, SparkplugB 토픽 경로가 어떻게 만들어지는지 확인할 때 사용합니다.

화면 구성​

┌──────────────────────────────────────────────────────────────┐
│ UNS                                  [새로고침]              │
│ Unified Namespace 계층과 DDS 토픽 라우팅 미리보기             │
├──────────────────────┬───────────────────────────────────────┤
│ 네임스페이스 트리     │ 토픽 미리보기                         │
│ [사이트 ▼]           │ 선택 노드 / 라우트 미리보기 / 관련 링크 │
│ [네임스페이스 검색]   │ Kafka / MQTT / SparkplugB 토픽          │
│ 트리 노드             ├───────────────────────────────────────┤
│                      │ 토픽 설정                              │
│                      │ Kafka / MQTT / SparkplugB 템플릿        │
└──────────────────────┴───────────────────────────────────────┘
영역역할
상단 헤더화면 제목, 설명, 새로고침 버튼
네임스페이스 트리사이트 선택, 키워드 검색, 계층 노드 선택
토픽 미리보기선택한 노드의 라우트, 관련 링크, Kafka/MQTT/SparkplugB 토픽
토픽 설정mq.properties 기준 DDS 토픽 템플릿 읽기 전용 조회

네임스페이스 트리​

좌측 패널은 사이트별 네임스페이스를 탐색하는 영역입니다.

컨트롤설명
사이트 셀렉터사이트를 선택합니다. 사이트명과 설명이 함께 표시됩니다.
네임스페이스 검색트리 노드를 키워드로 필터링합니다.
트리 노드사이트 / 구역 / 라인 / 설비 / 태그 계층을 표시합니다.
새로고침현재 사이트 기준으로 트리와 설정을 다시 불러옵니다.

노드를 선택하면 우측 토픽 미리보기 패널이 열립니다. 아직 노드를 선택하지 않았을 때는 "네임스페이스 노드를 선택하면 토픽 경로를 미리 볼 수 있습니다." 안내가 표시됩니다.

토픽 미리보기​

선택한 노드의 타입, ID, 경로, 관련 링크, 토픽 경로를 확인합니다.

영역표시
선택 노드 헤더노드 타입, 노드 ID, 선택 경로
라우트 미리보기사이트 → 구역 → 라인 → 설비 → 태그 경로
관련 링크태그 상세, 에셋 트리, 설비, 토픽 라우트, 경로
Kafka선택 노드 기준 Kafka 토픽
MQTT선택 노드 기준 MQTT 토픽
SparkplugB선택 노드 기준 SparkplugB 토픽

토픽 항목에는 복사 동작이 제공됩니다. 외부 시스템 설정이나 플로우 노드 설정에 토픽을 붙여 넣을 때 사용하세요.

토픽 설정​

하단 토픽 설정 패널은 mq.properties 에 정의된 DDS 토픽 템플릿을 읽기 전용으로 보여 줍니다.

설정 영역설명
KafkaKafka 토픽 템플릿과 사용 여부
MQTTMQTT 토픽 템플릿과 사용 여부
SparkplugBSparkplugB 관련 토픽 설정

이 패널은 설정값을 직접 수정하는 화면이 아닙니다. 설정 변경이 필요하면 운영 설정 절차에 따라 서버 설정 파일과 배포 환경을 수정해야 합니다.

AI Topic 설명​

서버 설정에서 AI Topic 설명이 활성화되어 있으면 선택 노드 헤더에 Topic 설명 버튼이 표시됩니다.

영역설명
라우팅 설명선택 노드가 어떤 토픽 경로로 라우팅되는지 요약
설정 누락토픽 생성에 필요한 누락 정보
근거설명에 사용된 노드·설정 근거
다음 확인운영자가 이어서 확인할 항목

비활성화되어 있으면 버튼과 설명 패널이 표시되지 않습니다.

운영 활용​

상황확인할 것
외부 시스템에 토픽을 전달해야 함노드를 선택하고 Kafka/MQTT 토픽을 복사합니다.
토픽 경로가 기대와 다름라우트 미리보기에서 사이트·구역·라인·설비·태그 계층을 확인합니다.
특정 설비나 태그의 모델이 틀림관련 링크로 에셋 트리 또는 태그 화면을 엽니다.
플로우와 메시징을 연결함토픽을 복사해 플로우 의 외부 입력·DDS 발행 노드 설정에 사용합니다.
설정 템플릿 확인토픽 설정 패널에서 Kafka/MQTT/SparkplugB 템플릿을 확인합니다.

자주 묻는 질문​

Q. 트리에 아무것도 보이지 않습니다.

A. 선택한 사이트에 에어리어·라인·설비·태그 모델이 등록되어 있는지 팩토리 모델 에서 확인하세요.

Q. 토픽이 표시되지 않습니다.

A. 해당 노드 타입에 대한 토픽 템플릿이 없거나 메시징 설정이 비활성화되어 있을 수 있습니다. 하단 토픽 설정 패널을 확인하세요.

Q. AI Topic 설명 버튼이 없습니다.

A. 서버 설정에서 AI Topic 설명 기능이 비활성화된 상태입니다. 기능 활성화 여부는 시스템 관리자에게 문의하세요.

Q. 토픽 경로를 수정할 수 있나요?

A. 이 화면은 미리보기와 복사용입니다. 토픽 규칙 변경은 서버 설정과 배포 절차를 통해 처리해야 합니다.

관련 화면​