대시보드
사이드바 운영 → 대시보드 메뉴에서 대시보드를 만들고, 위젯을 배치해 데이터를 시각화합니다. 사용 가능한 위젯 전체는 위젯 갤러리에서 확인하세요.
대시보드 만들기
목록 화면 우상단의 세 가지 방법 중 하나로 시작합니다.
- 새 대시보드 — 이름을 입력하고 만들기. 빈 대시보드가 생성됩니다.
- 템플릿으로 시작 — 제조/물류/에너지/품질/일반 카테고리의 프리셋을 고르고 대시보드 만들기를 누르면 위젯이 채워진 대시보드가 즉시 생성됩니다.
- 가져오기 — 다른 인스턴스에서 JSON 내보내기한 대시보드 파일을 업로드합니다.
카드에 마우스를 올리면 공유 URL 복사(공개 대시보드만) / JSON 내보내기 / 삭제 버튼이 나타나고, 관리자는 카드 하단 드롭다운으로 대시보드를 고객사에 할당할 수 있습니다.
보기 모드와 편집 모드
대시보드를 열면 보기 모드로 시작합니다.
- 전역 시간 범위 컨트롤 —
위젯 설정/1시간/6시간/24시간/7일프리셋(realtime, 자동 전진) 또는 범위 버튼으로 시작·종료 일시를 직접 지정(history)합니다. "위젯 설정"을 선택하면 각 위젯의 자체 조회 범위가 사용됩니다. - 위젯 호버 도구 — 위젯 우상단에 마우스를 올리면 CSV 내보내기(정적 장치+키 위젯) / 새로고침 / 전체화면(위젯만 확대) 버튼이 나타납니다.
- 전체화면 보기 — 툴바의 전체화면 버튼으로 사이드바·헤더까지 가려지는 브라우저 전체화면으로 전환합니다(ESC로 종료).
편집 버튼을 누르면 편집 모드로 전환되고, 위젯을 드래그로 이동·리사이즈할 수 있습니다. 편집 툴바 버튼:
| 버튼 | 기능 |
|---|---|
| 위젯 추가 | 위젯 라이브러리를 엽니다 (아래 참조) |
| 템플릿 저장 | 현재 대시보드를 템플릿으로 저장해 재사용 |
| 설정 | 배경색/배경 이미지/제목 숨김·색/툴바 숨김/그리드 컬럼 수/위젯 여백 |
| 버전 | 스냅샷 저장·복원 (아래 버전 히스토리 참조) |
| 번들 | 현재 화면(state)의 위젯을 JSON 번들로 내보내기 |
| 가져오기 | 위젯 번들 JSON을 현재 화면에 추가 |
| 취소 / 저장 | 편집 내용 폐기 / 레이아웃 저장 |
편집 모드에서 각 위젯 우상단의 연필 아이콘으로 설정을 다시 열고, X로 삭제합니다.
위젯 추가하기
- 편집 모드에서 위젯 추가를 누르면 위젯 라이브러리가 열립니다. 좌측 카테고리(차트 / 게이지 / 카드 / 테이블 / 지도 / 알람 / 제어 / 입력 / 신호 / 공정 / 모션 / 생산 / 에너지 / SCADA)와 검색으로 원하는 위젯을 찾고 클릭합니다.
- 위젯 구성 다이얼로그가 열립니다. 우측 절반은 실제 데이터로 렌더되는 라이브 프리뷰이고, 좌측은 데이터 / 모양 / 액션 3개 탭입니다.
- 추가(또는 편집 시 저장)를 누르면 위젯이 그리드에 배치됩니다.
데이터 탭 — 데이터소스
| 모드 | 설명 |
|---|---|
| 특정 장치 | 장치 이름 검색 드롭다운으로 하나를 선택 |
| 유형별 장치 | 장치 유형(예: sensor, plc)이 일치하는 모든 장치 |
| 자산 내 장치 | 선택한 자산에 소속된 장치들 |
| 자산 그룹 | 그룹 내 모든 장치 |
| 이름 필터 | 장치 이름 부분일치 |
| 같은 자산의 장치 (relation) | 기준 장치와 같은 자산에 속한 형제 장치들. 기준 장치를 비우면 드릴다운으로 전달된 장치를 기준으로 동적 해석 |
| 드릴다운 엔티티 | state 드릴다운으로 전달된 장치를 사용 |
| 시뮬레이션 (function) | 장치 없이 합성 데이터 생성 — 사인파/랜덤/카운터/톱니파/상수 |
alias(동적) 모드에서는 값 필터를 추가해 후보를 더 좁힐 수 있습니다 — 속성 또는 텔레메트리
최신값을 대상으로 > >= < <= == != contains between 비교를 AND 조합합니다.
데이터 키 설정
데이터 키를 지원하는 위젯에서는 선택한 장치의 실제 텔레메트리 키가 칩으로 제시되어 클릭만으로 추가할 수 있습니다. 키마다 색상 / 라벨 / 단위 / 소수 자릿수를 지정하고, 차트 위젯은 키별 집계(AVG/MIN/MAX/SUM/COUNT/NONE)도 따로 정할 수 있습니다.
모양 탭
위젯 종류별 표시 옵션을 설정합니다. 예를 들어 차트는 조회 범위·집계·"대시보드 시간 범위 사용"
여부, 게이지는 최소·최대·원형/선형, 지도는 위도/경도 키·마커 클러스터링, 텍스트 카드는
{{키}} 변수와  이미지를 지원하는 마크다운 본문, SCADA 장면은 장면 구성 버튼으로
전용 에디터를 엽니다(SVG 요소를 드래그 배치하고 채움색/표시여부/회전 등을 텔레메트리 값에 바인딩).
액션 탭
- 소속 화면(state) / 레이아웃 영역(메인 그리드 또는 우측 고정 패널)
- 모바일 설정 — 640px 이하에서 숨김, 표시 순서, 높이
- 클릭 액션 — 보기 모드에서 위젯 클릭 시 동작: 화면 드릴다운(state 전환) / 다른 대시보드로 이동 / 앱 내 경로 이동 / 외부 URL 열기(새 탭 옵션) / RPC 명령 전송
다중 화면(state)과 드릴다운
하나의 대시보드에 여러 화면(state)을 만들어 "목록 → 상세" 구조를 구현할 수 있습니다.
- 편집 모드 상단의 화면(state) 바에서 state 추가로 화면을 만듭니다(예: "상세 화면").
- 위젯의 액션 탭에서 소속 화면으로 각 위젯이 표시될 state를 정합니다.
- 목록 화면 위젯에 클릭 액션 화면 드릴다운을 걸고 대상 state를 지정합니다.
- 보기 모드에서 위젯(예: 지도 마커, 테이블 행)을 클릭하면 해당 장치가 대상 state로 전달되고, 대상 state의 드릴다운 엔티티 데이터소스 위젯들이 그 장치의 데이터를 표시합니다. 상단 브레드크럼으로 이전 화면에 돌아갑니다.
버전 히스토리
편집 툴바의 버전 버튼으로 스냅샷을 관리합니다. 설명을 입력하고 현재 저장을 누르면 현재 상태가 버전으로 남고, 목록에서 복원을 누르면 그 시점으로 되돌립니다(복원 직전 상태도 자동 저장되므로 안전하게 되돌릴 수 있습니다).
공유
공개로 설정된 대시보드는 로그인 없이 볼 수 있는 읽기 전용 URL(/public/dashboard/{id})을
가지며, 목록 카드의 공유 URL 복사 버튼으로 주소를 복사할 수 있습니다. 공개 페이지 하단의
플랫폼 표시는 시스템 설정의 화이트라벨 옵션으로 숨길 수 있습니다.
고객사 사용자에게 보여주려면 공개 URL 대신 고객 할당을 사용하는 편이 안전합니다 — 로그인한 고객 사용자에게만 노출됩니다.