Entity Count

Entity count 위젯은 특정 필터 조건에 맞는 엔티티(HMI 장치, 자산, 고객 등 모든 엔티티 유형)의 총수를 표시합니다. KPI 대시보드, 시스템 개요, 엔티티 그룹 모니터링(연결된 HMI 장치 총수, 지역별 자산, 활성 게이트웨이 등)에 씁니다.

• 모든 엔티티 유형(HMI 장치, 자산, 고객 등)을 실시간으로 셉니다.
• 엔티티 별칭과 함께 쓰며, 키 필터를 더해 데이터 집합을 좁힐 수 있습니다.
• 엔티티가 생성·삭제되거나 속성 값이 바뀌면 자동으로 갱신됩니다.
• 레이아웃 두 가지: 세로(열) 또는 가로(행).
• 아이콘, 라벨, 색상, 셰브론 표시를 설정할 수 있습니다.
• 카드 클릭 시 동작으로 클릭하면 상세 화면으로 이동할 수 있습니다.

1. 대시보드를 수정 모드로 엽니다. 위쪽 툴바의 위젯 추가를 클릭하거나, 빈 대시보드 가운데의 위젯 추가 아이콘을 클릭합니다.
2. 위젯 번들 선택 대화상자에서 Count widgets를 찾아 클릭합니다.
3. Entity count 위젯을 선택합니다.
4. 데이터 소스, 필터, 모양을 설정한 다음 추가를 클릭합니다.

이 절의 설정은 모두 기본 모드 기준입니다. 필수 항목만 다루는 빠른 설정입니다. 제목 글꼴, 카드 스타일, 툴팁 같은 세부 설정은 고급 탭으로 바꿉니다.

셀 엔티티를 정하는 엔티티 별칭을 선택합니다. 엔티티 별칭으로 유형, 프로필, 관계 등 원하는 기준으로 엔티티를 묶습니다.

필터를 더해 세는 집합을 좁힙니다. 예를 들어 active 속성이 true인 HMI 장치만 셉니다.

위젯 레이아웃, 라벨, 아이콘, 값 표시를 설정합니다.

설정	설명
레이아웃	열 — 아이콘, 값, 라벨을 세로로 쌓습니다. 행 — 아이콘과 값을 나란히 놓습니다.
자동 크기 조절	위젯 크기를 바꾸면 영역에 맞게 글꼴 크기를 자동으로 조정합니다.
Label	카드에 표시하는 설명 글(예: Active, Total, Online).
아이콘	엔티티 범주를 나타내는 아이콘(선택 사항). 크기와 색상을 설정합니다.
아이콘 배경	아이콘 뒤의 배경색. 범주를 한눈에 알리는 데 씁니다(예: 활성은 초록, 오프라인은 빨강).
값	표시되는 개수 숫자의 글꼴과 색상.
셰브론	값 옆에 셰브론(›)을 넣어 카드를 클릭할 수 있음을 알립니다. 카드 클릭 시 동작과 함께 씁니다.

설정	설명
배경	카드 배경색, 그라데이션, 투명도.
카드 버튼 표시	위젯 헤더의 전체화면 버튼을 켜거나 끕니다.
카드 모서리 반경	카드 모서리의 둥근 정도.

Entity count 위젯에서 쓸 수 있는 액션 소스는 다음과 같습니다.

• 카드 클릭 시 — 사용자가 위젯 카드의 아무 곳이나 클릭하면 실행됩니다. 클릭할 수 있음을 보여 주려면 모양 설정에서 셰브론을 켭니다.
• 위젯 헤더 버튼 — 위젯 헤더 표시줄에 사용자 지정 버튼을 추가합니다.

목표: 시스템에서 현재 활성인 HMI 장치 수를 표시합니다. 카드를 클릭하면 활성 HMI 장치 전체 목록을 보여 주는 대시보드 상태로 이동합니다.

사전 준비: 상태가 두 개인 대시보드. 기본 상태에는 카운터 카드를, 두 번째 상태에는 활성 HMI 장치 목록을 보여 주는 위젯(예: Entities table)을 둡니다.

1단계. 위젯 추가. 대시보드를 수정 모드로 열고 위젯 추가를 클릭하고 Count widgets를 선택한 다음 Entity count를 고릅니다.

2단계. 데이터 소스 설정. 데이터소스 유형을 개체 별명으로 정합니다. 별칭을 만들거나 고릅니다.

• 별칭: All HMI Devices
• 필터 유형: 개체 유형 → 장치

3단계. 필터 추가. Filters 영역에서 Add key filter를 클릭하고 다음과 같이 설정합니다.

필드	값
Key type	Attribute
Key name	active
Value type	Boolean
Operation	같음
값	True

그러면 active = true인 HMI 장치만 셉니다.

4단계. 모양 설정. Label을 Active HMI Devices로 정하고 셰브론을 켭니다.

5단계. 동작 설정. 액션 영역에서 활성 HMI 장치 목록이 있는 대시보드 상태로 이동하는 카드 클릭 시 동작을 추가합니다.

6단계. 저장. 추가를 클릭하고 필요하면 크기와 위치를 조정한 다음 대시보드 툴바의 저장을 클릭합니다.

결과: 카드가 활성 HMI 장치 수를 실시간으로 표시하고, HMI 장치 상태가 바뀌면 자동으로 갱신합니다. 카드를 클릭하면 활성 HMI 장치 목록으로 이동합니다.

위젯에 0이 표시되거나 개수가 없음

원인	해결 방법
엔티티 별칭이 어떤 엔티티로도 결정되지 않음	대시보드에서 개체 별명을 열고 별칭이 결과를 돌려주는지 확인합니다.
필터가 모든 엔티티를 제외함	키 필터를 모두 확인합니다. active = true로 정했는데 이 속성이 있는 HMI 장치가 없으면 개수는 0입니다. 필터를 지우거나 고쳐 엔티티가 있는지 확인합니다.
속성 이름이 맞지 않음	필터 키 이름이 HMI 장치의 속성 이름과 정확히 같은지 확인합니다. 속성 이름은 대소문자를 구분합니다.

개수가 자동으로 갱신되지 않음

원인	해결 방법
대시보드가 실시간 모드가 아님	위젯이 실시간 갱신을 받도록 대시보드 시간 창을 실시간으로 정합니다.
HMI 장치가 속성 갱신을 보내지 않음	HMI 장치가 추적하는 속성(예: active)을 MX On Cloud에 계속 보고하는지 확인합니다.

셰브론이 보이지 않음

원인	해결 방법
셰브론이 켜지지 않음	위젯 구성 ⇾ 모양을 열고 셰브론을 켭니다.

클릭해도 이동하지 않음

원인	해결 방법
동작을 설정하지 않음	위젯 구성 ⇾ 액션을 열고 카드 클릭 시 동작을 추가합니다.
대상 상태가 없음	대상 대시보드 상태가 있는지, 그 이름이 동작에 설정한 이름과 정확히 같은지 확인합니다.