HP Vertical Valve

HP Vertical valve 위젯은 마주 보는 쐐기 두 개와 옆에 달린 구동기로 수직 방향에 그린 버터플라이 밸브를 나타냅니다. 위젯은 HMI 장치에서 현재 열림이나 닫힘 상태를 읽고, 운영자가 대시보드에서 바로 클릭해 실행하는 열기·닫기 전용 동작을 제공합니다. 난방, 냉방, 수처리, 산업 유체 시스템의 수직 배관 구간이나 입상관에서 차단 지점을 표시하고 제어할 때 씁니다.

주요 기능

설정할 수 있는 색으로 구분한 시각 상태로 밸브가 열렸는지 닫혔는지 표시합니다.
대시보드에서 바로 한 번 클릭으로 밸브를 열거나 닫습니다.
경고·심각 상태를 설정할 수 있는 알람 색으로 나타냅니다.
밸브가 경고나 심각 상태이면 깜박이는 효과를 냅니다.
위젯이 경고 상태나 심각 상태일 때 클릭하면 각각 다른 대시보드 동작을 실행합니다.
HMI 장치 속성, 시계열, 알람 상태, 대시보드 상태에서 상태 데이터를 받습니다.

위젯 추가

대시보드를 열고 수정 모드로 바꿉니다.
위쪽의 위젯 추가를 클릭하거나, 화면 가운데의 위젯 추가 아이콘을 클릭합니다.
High-performance SCADA fluid system 위젯 번들을 엽니다.
HP Vertical valve를 선택합니다.
위젯 설정을 마친 다음 추가를 클릭합니다.

대상 HMI 장치

위젯은 데이터 소스 하나에 연결합니다: 장치 또는 HMI 장치로 결정되는 개체 별명. 이 HMI 장치가 위젯의 시각 상태를 움직이는 텔레메트리나 속성 값을 제공합니다.

SCADA 심볼

SCADA 심볼은 위젯의 시각적 모양을 정합니다. HP Vertical valve 위젯에는 High-performance SCADA fluid system 번들의 심볼이 미리 선택되어 있습니다. 다른 심볼을 쓰려면 갤러리에서 SCADA 심볼 선택을 클릭해 라이브러리에서 고르거나 직접 올립니다.

동작

동작 매개변수는 연결한 HMI 장치의 실시간 데이터에 따라 위젯이 무엇을 표시하고 사용자 조작에 어떻게 반응할지 정합니다.

매개변수	기본값	설명
Opened	`Use attribute 'open'`	밸브가 지금 열려 있는지. `True`이면 위젯이 열림 상태 색을 표시합니다. 데이터 소스 설정을 참고하세요.
Open	`Set 'open' attribute to: true`	밸브가 닫혀 있을 때 운영자가 위젯을 클릭하면 밸브를 열려고 실행되는 동작. 밸브 동작 설정을 참고하세요.
Close	`Set 'open' attribute to: false`	밸브가 열려 있을 때 운영자가 위젯을 클릭하면 밸브를 닫으려고 실행되는 동작. 밸브 동작 설정을 참고하세요.

Warning state

매개변수	기본값	설명
Warning	`Use alarm status`	밸브가 경고 상태인지. 데이터 소스 설정을 참고하세요.
Warning click	`Do nothing`	위젯이 경고 상태일 때 사용자가 위젯 심볼을 클릭하면 실행되는 동작. 클릭 동작 설정을 참고하세요.

Critical state

매개변수	기본값	설명
Critical	`Use alarm status`	밸브가 심각 상태인지. 데이터 소스 설정을 참고하세요.
Critical click	`Do nothing`	위젯이 심각 상태일 때 사용자가 위젯 심볼을 클릭하면 실행되는 동작. 클릭 동작 설정을 참고하세요.

매개변수	기본값	설명
Warning/Critical state animation	`False`	밸브가 경고나 심각 상태일 때 깜박임 애니메이션을 켤지. 데이터 소스 설정을 참고하세요.

클릭 동작 설정

Warning click과 Critical click에 적용됩니다. 아래 동작 유형 중 하나를 고릅니다.

동작 안 함

심볼을 클릭할 수는 있지만 아무 동작도 하지 않습니다. 스타일을 시험할 때나 자리를 잡아 둘 때 씁니다.

새로운 대시보드 상태 탐색

같은 대시보드 안의 다른 화면으로 바꿉니다(예: 밸브 상세 화면 열기).

매개변수	설명
대상 대시보드 상태	열 상태(필수).
Open right dashboard layout (mobile view)	화면을 대신하지 않고 옆 패널을 엽니다(모바일 전용).
위젯으로 부터 객체 설정	현재 엔티티를 대상 상태로 넘깁니다.
상태 개체 파라미터 이름	엔티티를 넘길 때 쓰는 키.
대시보드 상태 표시 옵션	일반(같은 화면), 별도 다이얼로그로 열기(팝업), 팝오버로 열기(인라인 오버레이).

현재 대시보드 상태 업데이트

다른 곳으로 이동하지 않고 현재 화면의 컨텍스트를 갱신합니다(예: 선택한 HMI 장치 바꾸기).

매개변수	설명
대상 대시보드 상태	바꿀 상태(선택 사항).
Open right dashboard layout (mobile view)	모바일에서 옆 패널을 엽니다.
위젯으로 부터 객체 설정	현재 엔티티를 갱신한 상태로 넘깁니다.
상태 개체 파라미터 이름	엔티티를 넘길 때 쓰는 키.

다른 대시보드 탐색

완전히 다른 대시보드를 엽니다(예: 이 시스템 화면에서 전체 알람 화면으로 이동).

매개변수	설명
대상 대시보드	열 대시보드(필수).
대상 대시보드 상태	그 대시보드 안에서 열 특정 화면.
새 브라우저 탭에서 열기	현재 페이지를 떠나지 않고 대시보드를 엽니다.
위젯으로 부터 객체 설정	현재 엔티티를 다른 대시보드로 넘깁니다.
상태 개체 파라미터 이름	엔티티를 넘길 때 쓰는 키.

Custom action

클릭하면 사용자 지정 JavaScript를 실행해 내장 옵션으로 안 되는 동작을 구현합니다. HTTP 요청, 사용자 지정 대화상자 열기, 다른 위젯 API 호출, 외부 서비스 연동에 씁니다. 함수가 받는 값: $event, widgetContext, entityId, entityName, additionalParams, entityLabel.

Custom action (with HTML template)

Custom action과 같지만, 심볼을 클릭하면 사용자 지정 HTML 패널이나 대화상자도 표시합니다. 함수는 htmlTemplate 매개변수를 추가로 받습니다: $event, widgetContext, entityId, entityName, htmlTemplate, additionalParams, entityLabel.

매개변수	설명
리소스	동작을 실행하기 전에 불러오는 외부 스크립트와 스타일.
CSS	HTML 템플릿의 스타일.
HTML	표시되는 대화상자나 패널의 레이아웃.
JS	동작 로직.

모바일 액션

MX On Cloud 모바일 앱 안에서 카메라나 QR 스캐너 같은 장치 기본 기능을 실행합니다.

매개변수	설명
모바일 액션 유형	갤러리에서 사진 선택, 사진 촬영, 지도 길찾기 열기, 지도 위치 열기, QR 코드 스캔, 전화 걸기, 휴대폰 위치 가져오기, 스크린샷 찍기, 장치 프로비저닝 중 하나.

URL 열기

클릭하면 웹사이트나 외부 링크를 엽니다.

매개변수 설명
URL 열 주소(필수).
새 브라우저 탭에서 열기 현재 대시보드를 열어 둔 채로 링크를 엽니다.

매개변수	설명
URL	열 주소(필수).
새 브라우저 탭에서 열기	현재 대시보드를 열어 둔 채로 링크를 엽니다.

밸브 동작 설정

Open과 Close에 적용됩니다. 이 동작은 운영자가 정상(알람이 아닌) 상태의 위젯을 클릭할 때 실행됩니다. 밸브가 닫혀 있으면 Open이, 열려 있으면 Close가 실행됩니다. 아래 동작 유형 중 하나를 고릅니다.

속성 설정

열림이나 닫힘 상태를 HMI 장치 속성에 씁니다.

매개변수	설명
속성 범위	쓸 곳: 서버, 공유.
속성 키	쓸 속성 이름(예: `open`).
Value	상수 — `true`(Open)나 `false`(Close)를 불리언으로 씁니다. 함수 — `f(value)` 함수로 계산한 값을 씁니다.

시계열 추가

열림이나 닫힘 상태를 HMI 장치에 새 시계열 데이터 포인트로 씁니다.

매개변수 설명
시계열 키 쓸 텔레메트리 키(예: open).
Value Value — true(Open)나 false(Close)를 불리언으로 씁니다.
함수 — f(value) 함수로 계산한 값을 씁니다.

매개변수	설명
시계열 키	쓸 텔레메트리 키(예: `open`).
Value	Value — `true`(Open)나 `false`(Close)를 불리언으로 씁니다. 함수 — `f(value)` 함수로 계산한 값을 씁니다.

데이터 소스 설정

Opened, Warning, Critical, Warning/Critical state animation에 적용됩니다. 매개변수 옆의 편집 아이콘을 클릭하면 설정 대화상자가 열립니다. 동작이 아무 것도 하지 않음이면 Value 옵션은 설정하는 매개변수에 따라 다릅니다:

매개변수	값
Opened	`True` 또는 `False`
Warning	`True` 또는 `False`
Critical	`True` 또는 `False`
Warning/Critical state animation	`True` 또는 `False`

다른 동작은 어떤 매개변수를 편집하든 설정 대화상자가 같은 방식으로 동작합니다:

속성 가져오기

HMI 장치 속성에서 매개변수 값을 읽습니다.

매개변수	설명
속성 범위	속성이 저장된 곳: 전체, 클라이언트, 서버, 공유.
속성 키	읽을 속성 이름(예: `open`).
동작 결과 변환기	없음 — 속성이 지정한 값과 같으면 매개변수가 활성화됩니다. 함수 — `f(data)`가 `true`를 돌려주면 매개변수가 활성화됩니다.
’[매개변수]’ when result is	이 매개변수를 활성화하는 값이나 조건.

시계열 가져오기

최신 텔레메트리 측정값에서 매개변수 값을 읽습니다.

매개변수	설명
시계열 키	감시할 텔레메트리 키(예: `valveOpen`, `open`).
동작 결과 변환기	없음 — 텔레메트리 값이 지정한 값과 같으면 매개변수가 활성화됩니다. 함수 — `f(data)`가 `true`를 돌려주면 매개변수가 활성화됩니다.
’[매개변수]’ when result is	이 매개변수를 활성화하는 값이나 조건.

알람 상태 가져오기

HMI 장치에 특정 알람이 활성이면 매개변수를 활성화합니다.

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

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

대시보드 상태 ID 가져오기

현재 열린 대시보드 상태에 따라 매개변수를 활성화합니다.

매개변수	설명
동작 결과 변환기	없음 — 상태 이름이 입력한 글자와 같으면 매개변수가 활성화됩니다. 함수 — `f(data)`가 `true`를 돌려주면 매개변수가 활성화됩니다.
’[매개변수]’ when result is	이 매개변수를 활성화하는 상태 이름이나 조건.

대시보드 상태 객체 가져오기

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

매개변수	설명
값 파싱 함수	현재 대시보드 상태 객체를 받는 `f(data)` 함수. 활성 상태 이름은 `data.id`로, 상태 매개변수는 `data.params`로 확인합니다.
’[매개변수]’ when result is	매개변수를 활성화하는 기대 유형과 값. 문자열, 정수, 실수, 불리언(이어서 참이나 거짓 선택), JSON 중에서 고릅니다.

모양

모양 영역은 위젯 제목과 밸브 상태 색상을 설정합니다.

설정	기본값	설명
제목	`HP Vertical valve`	헤더에 표시되는 위젯 제목. `entityName`과 `entityLabel` 변수를 지원합니다.
카드 아이콘	—	위젯 헤더에 표시되는 아이콘. 크기와 색상을 설정합니다.
Opened color	흰색	열림 상태일 때 밸브 색.
Closed color	회색	닫힘 상태일 때 밸브 색.
Warning color	주황	경고 상태일 때 밸브 색.
Critical color	빨강	심각 상태일 때 밸브 색.

카드 모양

카드 모양 영역은 위젯 컨테이너 스타일을 설정합니다.

설정	기본값	설명
배경	투명	카드 배경색.
카드 버튼 표시	전체화면	카드에 마우스를 올리면 보이는 버튼.
카드 모서리 반경	`0px`	카드 모서리의 둥근 정도.
카드 패딩	`12px`	카드 가장자리와 위젯 내용 사이의 안쪽 간격.

문제 해결

열림과 닫힘 사이에 밸브 색이 바뀌지 않음

원인	해결 방법
Opened 동작이 아무 것도 하지 않음이고 값이 `False`임	Opened 편집 대화상자를 열고 올바른 동작을 정한 다음 속성 키를 지정합니다.
대상 HMI 장치가 연결되지 않음	선택한 HMI 장치가 온라인이고 데이터를 보내고 있는지 확인합니다.

밸브를 클릭해도 열리거나 닫히지 않음

원인	해결 방법
Open이나 Close 동작이 설정되지 않음	Open이나 Close 편집 대화상자를 열고 속성 설정이나 시계열 추가를 고릅니다.
대상 HMI 장치가 연결되지 않음	선택한 HMI 장치가 온라인이고 명령을 받을 수 있는지 확인합니다.

경고나 심각 색이 나타나지 않음

원인	해결 방법
Warning이나 Critical 동작이 아무 것도 하지 않음이고 값이 `False`임	상태 매개변수가 알람 상태나 HMI 장치 속성을 읽도록 설정합니다.
HMI 장치에 활성 알람이 없음	HMI 장치에 기대하는 심각도의 활성 알람이 있는지 확인합니다.

Warning click이나 Critical click이 반응하지 않음

원인	해결 방법
밸브가 지금 기대하는 알람 상태가 아님	Warning click은 Warning 상태가 활성일 때만, Critical click은 Critical 상태가 활성일 때만 실행됩니다. HMI 장치에 알람이 활성인지 확인합니다.
동작이 동작 안 함으로 설정됨	Warning click이나 Critical click 편집 대화상자를 열고 원하는 이동이나 동작을 설정합니다.