Power Button

Power button 위젯은 대시보드에 켜짐/꺼짐 컨트롤 하나를 추가합니다. 클릭 한 번으로 릴레이를 켜거나, 모터를 작동시키거나, 두 가지 상태가 있는 HMI 장치 기능을 전환할 때 씁니다. 대시보드를 불러올 때 버튼이 HMI 장치의 현재 상태를 읽으므로, 사용자가 보는 상태가 늘 실제 HMI 장치와 같습니다.

주요 기능

HMI 장치나 엔티티를 클릭 한 번으로 켜고 끄는 컨트롤.
불러올 때 속성이나 텔레메트리 값에서 HMI 장치의 현재 상태를 읽습니다.
켜기와 끄기 동작마다 속성 갱신이나 텔레메트리 쓰기를 따로 정합니다.
여러 레이아웃: 기본, 단순, 윤곽선, 아이콘 전용 모드.
HMI 장치 데이터, 알람, 대시보드 상태에 따라 자동으로 비활성화할 수 있습니다.

위젯 추가

대시보드를 수정 모드로 엽니다. 위쪽 툴바의 위젯 추가를 클릭하거나, 빈 대시보드 가운데의 위젯 추가 아이콘을 클릭합니다.
위젯 번들 선택 대화상자에서 Buttons를 찾아 클릭합니다.
Power button 위젯을 선택합니다.
데이터 소스, 동작, 모양을 설정한 다음 추가를 클릭합니다.

구성

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

대상 HMI 장치

위젯의 데이터 소스를 선택합니다.

장치 — 특정 HMI 장치. 버튼이 이 HMI 장치의 속성과 텔레메트리 데이터를 읽어 상태를 정합니다.
개체 별명 — 엔티티 별칭에 맞는 엔티티 집합. 실행 중에 대상 HMI 장치를 동적으로 고를 때 씁니다.

동작

동작 영역은 불러올 때 HMI 장치의 켜짐/꺼짐 상태를 읽는 방법, 사용자가 켤 때와 끌 때 실행할 동작, 버튼이 비활성화되는 시점을 정합니다. 필요한 하위 영역을 설정합니다. 비활성화 상태는 선택 사항입니다.

초기 상태

대시보드를 불러올 때 버튼을 켜짐으로 보일지 꺼짐으로 보일지 정합니다. 아래 동작 유형 중 하나를 고릅니다.

아무 것도 하지 않음

상태를 직접 정합니다. 실시간 데이터가 필요 없습니다.

매개변수 설명
Value 버튼을 항상 켜짐으로 보이려면 켜짐, 항상 꺼짐으로 보이려면 꺼짐으로 정합니다.

매개변수	설명
Value	버튼을 항상 켜짐으로 보이려면 켜짐, 항상 꺼짐으로 보이려면 꺼짐으로 정합니다.

속성 가져오기

HMI 장치나 엔티티의 속성을 읽어 현재 상태를 정합니다.

매개변수	설명
속성 범위	속성이 저장된 곳: 전체, 클라이언트, 서버, 공유.
속성 키	읽을 속성 이름(예: `powerState`).
조건(없음)	속성이 지정한 값과 같으면 켜짐입니다.
조건(함수)	`f(data)` 함수가 `true`를 돌려주면 켜짐입니다.

시계열 가져오기

최신 텔레메트리 값을 읽어 현재 상태를 정합니다.

매개변수	설명
시계열 키	감시할 텔레메트리 키(예: `state`, `power`).
조건(없음)	텔레메트리 값이 지정한 값과 같으면 켜짐입니다.
조건(함수)	`f(data)` 함수가 `true`를 돌려주면 켜짐입니다.

알람 상태 가져오기

엔티티에 조건에 맞는 알람이 활성이면 버튼을 켜짐으로 정합니다.

매개변수 설명
알람 심각도 켜짐 상태를 일으킬 심각도: 심각한, 주요한, 작은, 경고, 중간.
알람 유형 모든 알람 또는 특정 알람 유형.
대시보드 상태 ID 가져오기

현재 열린 대시보드 상태에 따라 버튼을 정합니다. 버튼 상태가 탐색 맥락을 반영해야 할 때 씁니다.

매개변수 설명
조건(없음) 현재 상태 이름이 입력한 글자와 같으면 켜짐입니다.
조건(함수) f(data) 함수가 true를 돌려주면 켜짐입니다.
대시보드 상태 객체 가져오기

대시보드 상태 컨텍스트 전체로 버튼을 정합니다. 상태 매개변수 여러 개를 한꺼번에 확인해야 할 때 씁니다.

매개변수 설명
조건(함수만) f(data) 함수를 작성해 true를 돌려주면 버튼이 켜짐이 됩니다.

매개변수	설명
알람 심각도	켜짐 상태를 일으킬 심각도: 심각한, 주요한, 작은, 경고, 중간.
알람 유형	모든 알람 또는 특정 알람 유형.

매개변수	설명
조건(없음)	현재 상태 이름이 입력한 글자와 같으면 켜짐입니다.
조건(함수)	`f(data)` 함수가 `true`를 돌려주면 켜짐입니다.

매개변수	설명
조건(함수만)	`f(data)` 함수를 작성해 `true`를 돌려주면 버튼이 켜짐이 됩니다.

전원 ‘켜기’ 동작

사용자가 버튼을 눌러 켤 때 실행할 동작을 정합니다. 아래 동작 유형 중 하나를 고릅니다.

속성 설정

켤 때 HMI 장치 속성을 갱신합니다.

매개변수 설명
속성 범위 서버 또는 공유.
속성 키 갱신할 속성(예: powerState).
Value 상수 — 고정 값(예: true, "ON"), 함수 — 값을 돌려주는 JS 함수.
시계열 추가

켤 때 시계열 기록을 씁니다.

매개변수 설명
시계열 키 쓸 텔레메트리 키(예: state).
Value 상수 — 고정 값, 함수 — 값을 돌려주는 JS 함수.

매개변수	설명
속성 범위	서버 또는 공유.
속성 키	갱신할 속성(예: `powerState`).
Value	상수 — 고정 값(예: `true`, `"ON"`), 함수 — 값을 돌려주는 JS 함수.

매개변수	설명
시계열 키	쓸 텔레메트리 키(예: `state`).
Value	상수 — 고정 값, 함수 — 값을 돌려주는 JS 함수.

전원 ‘끄기’ 동작

사용자가 버튼을 눌러 끌 때 실행할 동작을 정합니다. 전원 ‘켜기’의 반대로 설정합니다. 아래 동작 유형 중 하나를 고릅니다.

속성 설정

끌 때 HMI 장치 속성을 갱신합니다.

매개변수 설명
속성 범위 서버 또는 공유.
속성 키 갱신할 속성(예: powerState).
Value 상수 — 고정 값(예: false, "OFF"), 함수 — 값을 돌려주는 JS 함수.
시계열 추가

끌 때 시계열 기록을 씁니다.

매개변수 설명
시계열 키 쓸 텔레메트리 키(예: state).
Value 상수 — 고정 값, 함수 — 값을 돌려주는 JS 함수.

매개변수	설명
속성 범위	서버 또는 공유.
속성 키	갱신할 속성(예: `powerState`).
Value	상수 — 고정 값(예: `false`, `"OFF"`), 함수 — 값을 돌려주는 JS 함수.

매개변수	설명
시계열 키	쓸 텔레메트리 키(예: `state`).
Value	상수 — 고정 값, 함수 — 값을 돌려주는 JS 함수.

비활성화 상태

비활성화 상태는 설정한 조건이 맞으면 버튼을 누를 수 없게 해, 위험하거나 올바르지 않은 상황에서 클릭을 막습니다.

아무 것도 하지 않음

비활성화 상태를 직접 정합니다. 실시간 데이터가 필요 없습니다.

매개변수 설명
Value 버튼을 항상 비활성화하려면 참, 항상 활성화해 두려면 거짓으로 정합니다.

매개변수	설명
Value	버튼을 항상 비활성화하려면 참, 항상 활성화해 두려면 거짓으로 정합니다.

속성 가져오기

HMI 장치 속성(예: online 상태, locked 플래그)에 따라 버튼을 비활성화합니다.

매개변수	설명
속성 범위	속성이 저장된 곳: 전체, 클라이언트, 서버, 공유.
속성 키	읽을 속성 이름(예: `online`, `locked`).
조건(없음)	속성이 지정한 값(String, Integer, Double, Boolean, JSON)과 같으면 비활성화합니다.
조건(함수)	`f(data)` 함수가 `true`를 돌려주면 비활성화합니다.

시계열 가져오기

최신 텔레메트리 값(예: 운전 모드, 가용성 측정값)에 따라 버튼을 비활성화합니다.

매개변수	설명
시계열 키	감시할 텔레메트리 키(예: `availability`, `state`).
조건(없음)	텔레메트리 값이 지정한 값과 같으면 비활성화합니다.
조건(함수)	`f(data)` 함수가 `true`를 돌려주면 비활성화합니다.

알람 상태 가져오기

특정 알람이 활성인 동안 버튼을 비활성화합니다(예: Critical 알람이 열려 있는 동안 제어 막기).

매개변수 설명
알람 심각도 심각한, 주요한, 작은, 경고, 중간.
알람 유형 모든 알람 또는 특정 알람 유형.
대시보드 상태 ID 가져오기

현재 열린 대시보드 상태에 따라 버튼을 비활성화합니다. 읽기 전용이나 제한된 화면에서 동작을 막을 때 씁니다.

매개변수 설명
조건(없음) 현재 상태 이름이 입력한 글자와 같으면 비활성화합니다.
조건(함수) f(data) 함수가 true를 돌려주면 비활성화합니다.
대시보드 상태 객체 가져오기

대시보드 상태 컨텍스트 전체로 버튼을 비활성화합니다. 상태 매개변수 여러 개를 한꺼번에 확인해야 할 때 씁니다.

매개변수 설명
조건(함수만) f(data) 함수를 작성해 true를 돌려주면 버튼이 비활성화됩니다.

매개변수	설명
알람 심각도	심각한, 주요한, 작은, 경고, 중간.
알람 유형	모든 알람 또는 특정 알람 유형.

매개변수	설명
조건(없음)	현재 상태 이름이 입력한 글자와 같으면 비활성화합니다.
조건(함수)	`f(data)` 함수가 `true`를 돌려주면 비활성화합니다.

매개변수	설명
조건(함수만)	`f(data)` 함수를 작성해 `true`를 돌려주면 버튼이 비활성화됩니다.

모양

상태마다 버튼의 시각 스타일, 라벨, 색상을 설정합니다.

설정	설명
레이아웃	버튼 디자인 종류: 기본, 단순, 윤곽선. 각각 (볼륨) 종류(입체 효과)와 (아이콘) 종류(라벨 없이 아이콘만)도 있습니다.
제목	버튼 위에 표시되는 라벨 글.
카드 아이콘	제목 옆에 표시하는 아이콘.
버튼 아이콘 ‘켜짐’	켜짐 상태의 버튼에 표시되는 아이콘.
버튼 아이콘 ‘꺼짐’	꺼짐 상태의 버튼에 표시되는 아이콘.
전원 ‘켜짐’ 색상	기본 — 켜짐 상태의 버튼 채우기 색상, 배경 — 주변 영역 색상.
전원 ‘꺼짐’ 색상	기본 — 꺼짐 상태의 버튼 채우기 색상, 배경 — 주변 영역 색상.
비활성화 색상	기본 — 비활성화 상태의 버튼 채우기 색상, 배경 — 주변 영역 색상.

카드 모양

설정	설명
배경	카드 배경색이나 이미지.
카드 버튼 표시	전체화면 — 위젯을 전체 화면 모드로 펼칩니다.
카드 모서리 반경	카드 모서리의 둥근 정도.
카드 패딩	위젯 내용과 카드 테두리 사이 간격.

액션

Power button 위젯은 위젯 헤더 버튼 동작을 지원합니다. 위젯 헤더에 버튼을 추가해 클릭하면 설정한 동작을 실행합니다.

예시

환기 릴레이의 전원 제어

시나리오: Ventilation Relay HMI 장치가 현재 릴레이 상태를 powerState 시계열 값으로 MX On Cloud에 보고합니다. 대시보드를 불러올 때 최신 powerState 값을 읽어 켜짐이나 꺼짐을 표시하고, 사용자가 버튼을 누르면 HMI 장치에 새 값을 보내는 Power button을 만듭니다.

사전 준비:

Ventilation Relay라는 HMI 장치를 만들고 라이선스를 등록합니다(HMI 장치 연결 가이드 참고).
HMI 장치의 최근 데이터에 powerState 키(Boolean, 예: false)가 있는지 확인합니다.

1단계. 위젯 추가. 대시보드를 수정 모드로 열고 위젯 추가를 클릭하고 Buttons 번들을 선택한 다음 Power button을 고릅니다.

2단계. 데이터 소스 설정. 대상 장치는 장치로 두고 Ventilation Relay HMI 장치를 선택합니다.

3단계. 동작 설정.

초기 상태 — 시계열 가져오기, 시계열 키: powerState, 동작 결과 변환기: 없음, ‘켜짐’ when result is: 불리언 → 참.

전원 ‘켜기’ — 속성 설정, 속성 범위: 공유, 속성 키: powerState, Value: 상수 → 불리언 참.

전원 ‘끄기’ — 속성 설정, 속성 범위: 공유, 속성 키: powerState, Value: 상수 → 불리언 거짓.

버튼이 항상 조작되도록 비활성화 상태는 기본값 거짓으로 둡니다.

4단계. 모양 설정.

레이아웃: 윤곽선
제목: 켬 → Turning Ventilation On/Off
전원 ‘켜짐’ 색상: 기본 #2196F3, 배경 #E3F2FD
전원 ‘꺼짐’ 색상: 기본 #9E9E9E, 배경 #F5F5F5

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

결과: 위젯이 Ventilation Relay의 최신 powerState 값을 읽습니다. powerState = true이면 버튼이 파랗게(켜짐), powerState = false이면 회색(꺼짐)으로 보입니다. 버튼을 누르면 HMI 장치에 새 값을 보내고, HMI 장치는 릴레이를 켜거나 끈 뒤 갱신된 powerState 값을 다시 보고합니다.

문제 해결

버튼에 HMI 장치 상태가 반영되지 않음

원인	해결 방법
속성 키가 틀림	키가 HMI 장치 속성과 정확히 같은지 확인합니다. 키 이름은 대소문자를 구분합니다.
속성 범위가 틀림	범위를 실제 속성 유형(클라이언트 / 서버 / 공유)에 맞춥니다.
HMI 장치에 속성이 없음	장치 → 속성을 열고 키가 값과 함께 있는지 확인합니다.
시계열 키가 틀림	초기 상태에서 시계열 가져오기를 쓰면 키가 HMI 장치가 보고하는 키와 정확히 같은지 확인합니다. 키 이름은 대소문자를 구분합니다.
HMI 장치에 시계열 값이 없음	장치 → 최근 데이터를 열고 키가 값과 함께 있는지 확인합니다.

버튼을 클릭해도 반응이 없음

원인	해결 방법
HMI 장치가 오프라인임	HMI 장치 연결과 전송 설정을 확인합니다.
동작 유형이 틀림	켜기/끄기 동작이 HMI 장치가 명령을 받는 방식(속성 또는 시계열)과 맞는지 확인합니다.

버튼이 비활성화 상태에서 풀리지 않음

원인	해결 방법
비활성화 조건이 늘 참으로 평가됨	비활성화 상태 구성을 검토합니다. 동작 유형과 결과 변환기 로직을 확인합니다.
예상과 다른 속성이나 텔레메트리 값	장치 → 속성이나 최근 데이터를 열어 실제 값을 확인합니다.