엔티티 뷰

엔티티 뷰는 HMI 장치나 자산의 텔레메트리와 속성이 고객에게 노출되는 범위를 제한합니다. SQL 데이터베이스 뷰처럼 엔티티 뷰는 원본 엔티티의 데이터 중 선택한 일부만 보여 줍니다. 테넌트 관리자는 HMI 장치나 자산마다 뷰를 여러 개 만들어 서로 다른 고객에게 할당할 수 있습니다.

자주 쓰는 경우:

• 선택한 데이터 공유 — 특정 텔레메트리 키(예: 센서 측정값)는 고객에게 보여 주고, 배터리 잔량이나 시스템 오류 같은 디버그 정보는 숨깁니다
• 여러 고객과 공유 — 같은 HMI 장치나 자산의 데이터를 여러 고객과 동시에 공유하되, 고객마다 허용된 데이터만 보게 합니다
• Device-as-a-Service(DaaS) — HMI 장치가 모은 데이터를 기간별로 나눠, 기간마다 다른 고객에게 할당합니다

1. 개체 > 개체 보기로 이동합니다.
2. + 버튼을 클릭해 새로운 개체 보기 추가 대화상자를 엽니다.
3. Name을 입력합니다(테넌트 안에서 고유해야 함).
4. 개체 보기 유형을 입력하거나 고릅니다.
5. 대상의 개체 유형(HMI 장치 또는 자산)을 고르고 대상 엔티티를 고릅니다.
6. 데이터 필터를 설정합니다.
   • 시계열 데이터 — 이 뷰로 볼 수 있는 텔레메트리 키를 고릅니다.
   • 속성 전파 — 볼 수 있는 서버·클라이언트·공유 속성 키를 고릅니다.
   • 시작 시간과 종료 시간 — 필요하면 텔레메트리에 접근할 수 있는 기간을 제한합니다.
7. 추가를 클릭합니다.

1. 목록에서 엔티티 뷰를 클릭해 상세 정보를 엽니다.
2. 연필 아이콘을 클릭합니다.
3. 이름, 대상 엔티티, 데이터 필터, 기간을 수정합니다.
4. 변경사항 적용을 클릭합니다.

엔티티 뷰 옆의 휴지통 아이콘을 클릭하고 확인하거나, 엔티티 뷰 상세 페이지를 열어 Delete entity view를 클릭합니다.

1. 목록에서 엔티티 뷰를 찾습니다.
2. Assign to customer 아이콘을 클릭합니다.
3. 대상 고객을 고르고 할당을 클릭합니다.

그 고객에 속한 사용자만 엔티티 뷰와 그 데이터에 접근할 수 있습니다.

엔티티 뷰 옆의 개체 보기를 공개로 전환 아이콘을 클릭하면 데이터가 공개되고, 개체 보기를 비공개로 전환을 클릭하면 공개 접근이 취소됩니다.

엔티티 뷰를 열면 다음 탭이 있는 상세 패널이 나옵니다.

탭	내용
속성	대상 엔티티에서 복사한 속성 키-값 쌍(뷰의 속성 키로 걸러짐)
최근 데이터	대상 엔티티의 최신 텔레메트리 값(뷰의 시계열 키와 기간으로 걸러짐)
알람	대상 엔티티에서 전파된 알람
이벤트	수명 주기 이벤트, 로그, 경고, 오류
관계	다른 엔티티와의 방향이 있는 연결
감사 로그	사용자 작업 이력: 생성, 수정, 삭제

모든 시계열 데이터는 대상 엔티티 쪽에 저장되며, 데이터가 중복되지 않습니다. 대시보드나 API 요청이 엔티티 뷰를 조회하면 다음과 같이 동작합니다.

• 요청 기간은 엔티티 뷰의 시작·종료 시간 안으로 잘립니다. 이 기간 밖의 조회는 데이터를 돌려주지 않습니다.
• 엔티티 뷰의 시계열 필터에 있는 텔레메트리 키만 돌려줍니다. 다른 키 요청은 아무 표시 없이 무시됩니다.

엔티티 뷰는 저장하거나 업데이트할 때마다 대상 엔티티에서 지정한 속성을 복사합니다. 성능 때문에 대상 엔티티의 속성 변경은 엔티티 뷰로 자동 전파되지 않습니다.

• 대시보드 — 위젯의 데이터 소스로 엔티티 뷰를 써서 고객이 허용된 데이터만 보게 합니다
• 고객 — 엔티티 뷰를 고객에게 할당해 데이터가 보이는 범위를 제어합니다
• REST API — 프로그램으로 엔티티 뷰를 조회하고, 만들고, 관리합니다