대시보드

대시보드는 HMI 데이터를 시각화하고 다루는, 설정할 수 있는 페이지입니다. 차트, 표, 지도, 컨트롤 같은 위젯으로 이루어지며, HMI 장치·자산·기타 엔티티의 데이터를 어떤 조합으로든 표시할 수 있습니다.

시작하기 전에 모든 대시보드를 이루는 핵심 개념(상태, 별칭, 레이아웃, 동작, 시간 창)을 살펴보세요.

새 대시보드 만들기

사이드바에서 대시보드로 이동합니다.
오른쪽 위의 + 대시보드 추가 ⇾ 대시보드 생성을 클릭합니다.
대시보드 제목을 입력합니다(다른 설정은 모두 선택 사항입니다).
추가를 클릭합니다. 대시보드가 자동으로 열립니다.
오른쪽 위의 저장을 클릭해 저장합니다.

수정 모드

대시보드 수정 모드에서는 위젯 추가, 설정, 레이아웃 변경 등을 할 수 있습니다.

대시보드 수정 모드로 바꾸려면 오른쪽 위의 수정 모드 버튼을 클릭합니다.

변경한 뒤 저장을 클릭해 적용하거나 취소를 클릭해 버립니다.

대시보드 툴바

대시보드 툴바에는 위젯 추가, 대시보드 내보내기, 상태·레이아웃·별칭·필터·시간 창 등 설정을 관리하는 도구가 있습니다.
일부 컨트롤은 수정 모드에서만 보이고, 나머지는 보기 모드에서도 쓸 수 있습니다.

시간 창

대시보드 시간 창은 텔레메트리 데이터를 다룰 시간 구간을 정합니다. 자체 위젯 시간 창을 쓰도록 설정하지 않은 모든 시계열·알람 위젯이 이 시간 창을 씁니다.

자세한 내용은 시간 창을 참고하세요.

필터

필터는 대시보드에 표시할 데이터를 좁힙니다.

필터마다 속성이나 텔레메트리 키에 대해 키 조건을 하나 이상 확인합니다. 예를 들어 model = "DHT22"이고 batteryLevel < 20인 HMI 장치만 보여 줍니다.

여러 키 필터는 and로 결합됩니다. 한 키 안에서는 and/or를 쓴 복합 식(예: (A > 0 and A < 20) or (A = 50 or A = 60))을 쓸 수 있습니다.

필터 추가

수정 모드로 들어가 툴바에서 Filters를 클릭합니다.
Add filter를 클릭합니다.
필터 이름을 입력하고 Add key filter를 클릭합니다.
키 필터를 설정합니다.
- Key type을 선택합니다.
- Key name을 입력합니다.
- Value type을 고릅니다.
- 필터 조건을 정합니다. Operation과 값(정적 또는 동적)을 지정합니다.
- 필요하면 키 필터를 더 추가합니다.
오른쪽 아래의 추가를 클릭해 키 필터를 저장합니다.
추가를 클릭해 필터를 만듭니다.
필터를 저장하고 적용하려면 저장을 클릭합니다.

엔티티 별칭

별칭은 위젯의 데이터 소스를 정합니다. 기본 유형은 정적 별칭(고정된 엔티티)과 동적 별칭(HMI 장치 유형, 사용자 컨텍스트 등에 따라 실행 중에 결정됨) 두 가지입니다.

별칭 유형 전체 목록과 설정 옵션은 엔티티 별칭을 참고하세요.

설정

대시보드의 모양과 동작(상태 컨트롤러, 제목, 로고, 툴바 표시, 레이아웃, 고급 CSS)을 설정합니다. 수정 모드 툴바에서 톱니바퀴 아이콘을 클릭합니다.

상태 컨트롤러

대시보드 상태를 어떤 방식으로 다룰지 정합니다. 기본값은 entity이며, 상태가 현재 선택한 엔티티 컨텍스트에 연결됩니다.

제목

대시보드 제목 표시를 켜면 왼쪽 위에 제목이 표시됩니다. 색상 선택기로 색과 투명도를 조정합니다.

로고

대시보드 전체화면 모드에서 로고 표시를 켜고 이미지를 올립니다. 대시보드가 전체 화면일 때 왼쪽 위에 로고가 나타납니다.

툴바 설정

체크박스로 대시보드 툴바의 해당 옵션을 보일지 정합니다.

옵션	설명
툴바 숨기기	툴바 전체를 숨깁니다. 오른쪽 위에 수정 모드 진입(연필) 아이콘만 표시됩니다.
도구 상자를 열어두기	툴바를 항상 펼쳐 둡니다. 끄면 점 세 개 메뉴로 접힙니다.
대시보드 선택 표시	툴바의 대시보드 선택기를 보이거나 숨깁니다.
개체 선택 표시	툴바의 엔티티 선택기를 보이거나 숨깁니다.
필터 표시	필터 버튼을 보이거나 숨깁니다(필터가 정의된 경우에만).
타임윈도우 표시	시간 창 컨트롤을 보이거나 숨깁니다.
디스플레이 내보내기	내보내기 버튼을 보이거나 숨깁니다.
대시보드 이미지 업데이트 버튼 표시	대시보드 이미지 업데이트 버튼을 보이거나 숨깁니다.

고급 설정

대시보드 CSS — 대시보드에만 적용되는 사용자 지정 CSS를 넣습니다.

레이아웃 설정

기본 레이아웃 격자와 모양을 설정합니다.

열 개수 — 대시보드 격자의 열 수(기본값: 24).
최소 레이아웃 너비 — 레이아웃이 가로로 스크롤되기 전의 최소 너비(열 단위).
위젯 사이 여백 크기 — 위젯 사이 간격(픽셀).
레이아웃 양쪽에 여백 적용 — 위젯 격자 바깥쪽에 여백을 더합니다.
레이아웃 세로 길이 자동 채우기 — 레이아웃을 늘려 페이지 높이 전체를 채웁니다.
배경색 — 대시보드의 단색 배경을 정합니다.
배경 이미지 — 배경 이미지를 정합니다(갤러리에서 고르거나 링크 지정). 배경 사이즈 모드(예: Fit width)도 설정합니다.

모바일 레이아웃 설정

레이아웃 세로 길이 자동 채우기 — 모바일 레이아웃에 자동 채우기를 적용합니다.
Mobile row height — 모바일 레이아웃의 행 높이(기본값: 70 px).

레이아웃

MX On Cloud는 격자 기반 레이아웃으로 대시보드 안의 위젯을 배치합니다. 대시보드 하나에 레이아웃(상태)을 여러 개 두어, 고급 탐색 시나리오와 용도·화면 크기에 맞는 여러 화면 구성을 지원할 수 있습니다.

자세한 내용은 레이아웃을 참고하세요.

상태

상태는 대시보드에 계층 구조를 만듭니다. 예를 들어 루트 상태에서 모든 HMI 장치를 나열하고, 상세 상태에서 선택한 HMI 장치의 데이터를 보여 줍니다.

상태 관리를 열려면 수정 모드에서 툴바 왼쪽의 상태 아이콘(대시보드 상태 관리)을 클릭합니다.

상태 추가

수정 모드에서 툴바의 대시보드 상태 관리를 클릭합니다.
대시보드 상태 관리 대화상자 오른쪽 위의 + 아이콘을 클릭합니다.
상태 이름을 입력합니다(State Id는 자동으로 만들어지지만 고칠 수 있습니다). 이름을 동적으로 붙이려면 ${entityName}을 씁니다.
추가를 클릭한 다음 저장을 클릭합니다.

루트 상태

모든 대시보드는 루트 상태 하나로 시작합니다. 어떤 상태를 루트로 할지 바꾸려면 그 상태를 편집해 Root state 체크박스를 켭니다.

위젯 동작으로 상태 간 이동

알맞은 위젯 동작을 설정하면 대시보드 상태 사이를 이동할 수 있습니다.

이 예에서는 새로운 대시보드 상태 탐색 동작 유형을 씁니다.

준비

새 대시보드 상태를 추가합니다. 이름을 동적으로 붙이려면 상태 이름으로 ${entityName}을 쓸 수 있습니다.

위젯 동작 설정

대시보드를 수정 모드로 엽니다.
위젯의 위젯 수정(연필) 아이콘을 클릭해 위젯 설정을 엽니다.
액션 탭으로 이동합니다.
+ 액션 추가를 클릭합니다.
동작 매개변수를 설정합니다.
- 액션 소스: 예: 위젯 헤더 버튼, 행 클릭 시
- 이름: 알아보기 쉬운 이름을 입력합니다
- 유형: 새로운 대시보드 상태 탐색
- 대상 대시보드 상태: 앞에서 만든 상태를 선택합니다
- 추가를 클릭합니다.
적용을 클릭해 위젯 변경 사항을 저장합니다.
저장을 클릭해 대시보드를 저장합니다.

탐색 테스트

대시보드를 저장한 뒤 설정한 동작을 실행합니다(예: 위젯 헤더 버튼 클릭).

대시보드가 대상 상태로 바뀝니다.

새 위젯 추가

위젯은 대시보드의 핵심 구성 요소로, 차트·표·지도·컨트롤·알람 같은 시각화 구성 요소가 있습니다.
위젯마다 설정과 매개변수가 있어 용도에 맞게 동작과 모양을 바꿀 수 있습니다.

자세한 내용은 위젯을 참고하세요.

대시보드 관리

대시보드 공개

대시보드를 공개하면 인증 없이 접근할 수 있습니다.
MX On Cloud 계정이 없는 외부 사용자에게 읽기 전용 접근을 주거나, 공공장소의 화면에 대시보드를 띄우거나, 외부 웹사이트에 넣을 때 유용합니다.

대시보드 페이지로 이동합니다.
대시보드 옆의 대시보드를 공개로 전환 아이콘을 클릭합니다.
대화상자에서 공개 링크 복사를 클릭해 공유할 URL을 얻습니다.
링크를 공유합니다. 링크가 있는 사람은 누구나 로그인하지 않고 대시보드를 볼 수 있습니다.

대시보드를 다시 비공개로 하려면 대시보드 옆의 대시보드를 비공개로 전환 아이콘을 클릭하고 확인합니다.

할당된 고객 관리

대시보드를 고객 한 곳 이상에 할당합니다. 할당된 고객은 대시보드를 볼 수 있지만 수정할 수는 없습니다.

대시보드 페이지로 이동합니다.
대시보드 옆의 할당된 커스터머 관리 아이콘을 클릭합니다.
할당할 고객을 선택합니다.
업데이트를 클릭합니다.

할당을 해제하려면 할당된 커스터머 관리를 다시 열고 목록에서 고객을 지운 다음 업데이트를 클릭합니다.

대시보드 편집

대시보드 상세 정보 패널에서 대시보드 제목과 설명을 편집합니다.

대시보드로 이동합니다.
대시보드 옆의 대시보드 상세 정보 아이콘을 클릭합니다.
대시보드 상세 정보 창에서 연필 아이콘을 클릭해 편집 모드로 들어갑니다.
필요한 내용을 바꿉니다.
변경사항 적용을 클릭해 저장합니다.

내보내기와 가져오기

대시보드 내보내기

대시보드 구성을 JSON 파일로 내보냅니다. 데이터 화면을 찍은 것이 아니라 대시보드 구조, 위젯 설정, 레이아웃을 담습니다.

이런 용도로 씁니다.

백업 — 대시보드 구성의 사본을 저장합니다
이전 — MX On Cloud 인스턴스나 환경 사이에서 대시보드를 옮깁니다
재사용 — 기존 대시보드를 복사해 새 대시보드의 출발점으로 씁니다
버전 관리 — 대시보드 구성을 프로젝트 코드와 함께 보관합니다

내보내는 방법은 두 가지입니다.

대시보드 페이지에서 대시보드 옆의 대시보드 내보내기 아이콘을 클릭합니다.
대시보드 안에서 툴바의 대시보드 내보내기 버튼을 클릭하고 Export JSON configuration을 선택합니다.

대시보드 가져오기

JSON 파일에서 구성을 올려 대시보드를 가져옵니다.

대시보드로 이동합니다.
+ 대시보드 추가 ⇾ 대시보드 가져오기를 클릭합니다.
대시보드 구성이 담긴 .json 파일을 올리고 가져오기를 클릭합니다.

대시보드 삭제

대시보드 옆의 휴지통 아이콘을 클릭하고 삭제를 확인하거나, 대시보드 상세 정보 페이지를 열고 대시보드 삭제를 클릭합니다.

홈 대시보드

홈 대시보드는 사용자가 왼쪽 메뉴에서 홈을 클릭할 때 열리는 대시보드입니다. 설정된 것이 없으면 MX On Cloud는 그 역할의 기본 홈 페이지를 보여 줍니다.

홈 대시보드는 세 수준에서 정할 수 있고, 다음 순서로 확인해 처음 찾은 것을 씁니다.

사용자 — 사용자 계정마다 따로 정합니다.
고객 — 고객마다 한 번 정합니다. 자기 홈 대시보드를 정하지 않은 그 고객의 사용자에게 적용됩니다.
테넌트 — 테넌트에 한 번 정합니다. 테넌트 관리자 전체에 적용되고, 사용자 수준과 고객 수준 홈 대시보드가 모두 없으면 고객 사용자에게도 적용됩니다.

사용자 홈 대시보드 설정

사용자 상세 정보를 참고하세요. 홈 대시보드 필드는 사용자마다 사용자 프로필에서 정합니다.

테넌트·고객 홈 대시보드 설정

테넌트 관리자는 테넌트 전체의 기본 홈 페이지를 바꿀 수 있습니다.

보여 줄 위젯과 정보로 대시보드를 만들거나, 대시보드를 가져옵니다.
설정 → 홈으로 이동합니다.
홈 대시보드 필드에서 대시보드를 선택합니다.
필요하면 홈 대시보드 툴바 숨기기를 켜서 이 대시보드가 열려 있을 때 툴바를 숨깁니다.
저장을 클릭합니다.

저장하면 홈 대시보드를 따로 정하지 않은 테넌트의 모든 사용자에게 기본 홈 페이지 대신 이 대시보드가 나타납니다. 고객 하나에만 정하려면 고객 상세 정보를 열고 홈 대시보드 필드에서 대시보드를 선택합니다.

문제 해결

증상	원인	해결
위젯에 데이터가 표시되지 않음	엔티티 별칭이 어떤 엔티티로도 결정되지 않거나, 필터가 엔티티를 제외함	엔티티 별칭에서 별칭을 확인하고, 대시보드에 적용된 필터도 확인합니다
특정 시간 범위에서 위젯에 데이터가 표시되지 않음	대시보드나 위젯의 시간 창이 데이터가 있는 기간을 포함하지 않음	대시보드 시간 창과 위젯 수준 재정의를 확인합니다
공개 대시보드 링크는 열리지만 위젯이 비어 있음	위젯 뒤의 HMI 장치나 자산이 공개되지 않음 — 대시보드만 공개됨	관련 엔티티도 공개합니다 — 공개 / 비공개 설정 참고
고객이 공유된 대시보드의 데이터를 볼 수 없음	고객이 대시보드에는 접근할 수 있지만 대시보드가 표시하는 HMI 장치나 자산에는 접근할 수 없음	고객에게 관련 엔티티에 대한 접근 권한을 줍니다 — 할당된 고객 관리 참고
가져오기가 실패하거나 대시보드가 빈 채로 열림	올린 파일이 올바른 대시보드 JSON 내보내기 파일이 아니거나 손으로 고친 파일임	원래 대시보드를 다시 내보내고 그 파일을 고치지 않고 가져옵니다
홈 페이지에 여전히 기본 페이지가 표시됨	사용자·고객·테넌트 어디에도 홈 대시보드가 설정되지 않음	홈 대시보드에서 설정합니다

대시보드로 할 수 있는 일

기능	설명	안내
HMI 데이터 시각화	위젯을 추가해 HMI 장치나 자산의 텔레메트리, 속성, 알람을 실시간이나 과거 기준으로 표시합니다	위젯
시간 창 설정	대시보드의 모든 시계열 위젯에 적용되는 시간 구간과 집계 규칙을 정합니다	시간 창
엔티티 별칭 사용	유형, 관계, 대시보드 상태에 따라 엔티티를 동적으로 결정해 위젯이 맥락에 맞게 동작하게 합니다	엔티티 별칭
여러 상태 탐색 구성	상세 화면, 드릴다운, HMI 장치별 페이지를 위한 대시보드 상태를 따로 만들고 위젯 동작으로 그 사이를 이동합니다	위젯 동작
위젯 동작 설정	사용자가 차트, 표의 행, 버튼을 클릭하면 이동하거나 속성을 갱신합니다	위젯 동작
대시보드 레이아웃 관리	반응형 격자에 위젯을 배치하고, 모바일 레이아웃을 설정하고, 화면 상황에 맞는 이름 붙은 레이아웃을 여러 개 만듭니다	레이아웃
고객과 공유	고객 계정에 대시보드를 할당해, 그 고객의 사용자가 테넌트 수준 설정에 접근하지 않고 자기 데이터만 보게 합니다	고객
홈 대시보드로 설정	로그인 뒤 테넌트, 고객, 개별 사용자의 기본 첫 페이지로 대시보드를 지정합니다	홈 대시보드
내보내기와 가져오기	대시보드를 JSON 파일로 내보내고 다른 MX On Cloud 인스턴스로 가져와 백업하거나 재사용합니다	내보내기와 가져오기