Horizontal Inline Flow Meter

이 위젯은 Traditional SCADA fluid system 번들에 속합니다. 이 번들은 MX On Cloud 대시보드에서 유체 시스템 도면을 만들기 위한 배관 조각, 이음쇠, 밸브, 펌프, 게이지 모음입니다. 숫자 유량 표시와 실시간 배관 조각을 결합해, 측정한 유량과 실시간 유체 상태를 심볼 하나에 함께 보여 줍니다.

• 위젯 면에 유량 숫자 값을 표시합니다.
• 경고·심각 상태를 설정할 수 있는 테두리 색으로 나타냅니다.
• HMI 장치가 심각 상태이면 깜박이는 효과를 냅니다.
• HMI 장치가 고장 상태이면 고장 표시를 보여 줍니다.
• 표시부를 클릭하면 대시보드 동작을 실행합니다.
• 통합된 배관 조각으로 유체 유무와 흐름 상태를 시각화합니다.
• 설정한 속도로 유체 흐름을 어느 방향으로든 애니메이션합니다.
• 배관의 누수 상태를 나타냅니다.
• 유체, 배관, 표시부 테두리 요소에 사용자 지정 색을 따로 적용합니다.
• HMI 장치 속성, 시계열, 알람 상태, 대시보드 상태에서 상태 데이터를 받습니다.

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

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

동작 매개변수는 Display와 Pipe 두 그룹으로 나뉩니다. 매개변수마다 같은 동작 집합을 지원합니다. 전체 목록은 동작 설정을 참고하세요.

Display 매개변수는 위젯 면에 보이는 숫자 표시와 상태 표시기를 정합니다.

매개변수	기본값	값	설명
Value	Use time series 'flowRate'	숫자	표시부에 보이는 유량 숫자 값.
Warning state	Use alarm status	True, False	구성 요소가 경고 상태인지.
Critical state	Use alarm status	True, False	구성 요소가 심각 상태인지.
Critical state animation	False	True, False	구성 요소가 심각 상태일 때 깜박임 애니메이션을 켤지.
Broken	False	True, False	구성 요소가 파손 또는 고장 상태인지.
On display click	Do nothing	—	사용자가 표시부를 클릭하면 실행되는 동작.

대시보드에서 사용자가 표시면을 클릭했을 때 할 일을 정합니다. 아래 동작 유형 중 하나를 고릅니다.

• 동작 안 함

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

• 새로운 대시보드 상태 탐색

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

  매개변수	설명
  대상 대시보드 상태	열 상태(필수).
  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	열 주소(필수).
  새 브라우저 탭에서 열기	현재 대시보드를 열어 둔 채로 링크를 엽니다.

Pipe 매개변수는 통합된 배관 조각의 유체 애니메이션을 정합니다.

매개변수	기본값	값	설명
Fluid presence	Absent	Present, Absent	배관에 유체가 있는지.
Flow presence	Absent	Present, Absent	배관에 유체가 흐르고 있는지.
Flow direction	Forward	Forward, Reverse	유체 흐름 애니메이션의 방향.
Flow animation speed	1	숫자	흐름 애니메이션의 속도. 1은 보통 속도, 0은 애니메이션 끔, < 1은 더 느리게, > 1은 더 빠르게.
Leak	False	True, False	배관에 누수가 있는지.

매개변수를 설정하려면 편집 아이콘을 클릭합니다.

Display 매개변수 — 아무 것도 하지 않음 값:

매개변수	값
Value	아무 숫자 — HMI 장치가 데이터를 보낼 때까지 표시부에 보이는 값.
Warning state	True 또는 False
Critical state	True 또는 False
Critical state animation	True 또는 False
Broken	True 또는 False

Pipe 매개변수 — 아무 것도 하지 않음 값:

매개변수	값
Fluid presence	Present 또는 Absent
Flow presence	Present 또는 Absent
Flow direction	Forward 또는 Reverse
Flow animation speed	아무 숫자 — 1은 보통 속도, 0은 정지, < 1은 더 느리게, > 1은 더 빠르게.
Leak	True 또는 False

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

• 속성 가져오기

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

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

• 시계열 가져오기

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

  매개변수	설명
  시계열 키	감시할 텔레메트리 키(예: flowRate, warningState).
  동작 결과 변환기	없음 — 텔레메트리 값이 지정한 값과 같으면 매개변수가 활성화됩니다. 함수 — f(data)가 true를 돌려주면 매개변수가 활성화됩니다.
  ’[매개변수]’ when result is	이 매개변수를 활성화하는 값이나 조건(원시 숫자 결과를 그대로 쓰는 Value에는 표시되지 않음).

• 알람 상태 가져오기

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

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

• 대시보드 상태 ID 가져오기

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

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

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

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

  매개변수	설명
  값 파싱 함수	매개변수 값을 돌려주는 f(data) 함수를 작성합니다.

모양 영역은 위젯 제목, 표시부 색상, 배관 요소 색상을 설정합니다.

설정	기본값	설명
제목	위젯 이름	헤더에 표시되는 위젯 제목. entityName과 entityLabel 변수를 지원합니다.
카드 아이콘	—	위젯 헤더에 표시되는 아이콘. 크기와 색상을 설정합니다.
Units	m³/hr	표시면의 숫자 값 옆에 표시되는 단위 라벨.
Decimals	0	숫자 값에 표시하는 소수 자릿수.
Default border color	검정	활성 알람이 없을 때 표시면의 테두리 색.
Active border color	초록	HMI 장치가 정상 활성 상태일 때의 테두리 색.
Warning border color	주황	HMI 장치가 경고 상태일 때의 테두리 색.
Critical border color	빨강	HMI 장치가 심각 상태일 때의 테두리 색.
Background color	투명	표시 영역의 배경색.
Fluid color	—	배관 조각 안에 그려지는 유체의 색.
Pipe color	—	배관 구조 자체의 색.

테두리 색마다 색상 모드 네 가지를 지원합니다: 고정값(고정 색), 그라데이션(값에 대응하는 색 범위), 범위(불연속 색 구간), 함수(현재 값에 따라 색상 문자열을 돌려주는 JavaScript 함수).

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

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

표시부에 값이 없거나 잘못된 값이 표시됨

원인	해결 방법
Value 동작이 아무 것도 하지 않음으로 설정됨	Value 편집 대화상자를 열고 올바른 동작을 정한 다음 텔레메트리나 속성 키를 지정합니다.
텔레메트리 키가 맞지 않음	동작 설정의 키 이름이 HMI 장치가 보내는 것과 정확히 같은지 확인합니다.
대상 HMI 장치가 연결되지 않음	선택한 HMI 장치가 온라인이고 데이터를 보내고 있는지 확인합니다.

경고나 심각 테두리 색이 나타나지 않음

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

흐름 애니메이션이 재생되지 않음

원인	해결 방법
Flow animation speed가 0임	Flow animation speed를 0이 아닌 값으로 정합니다(예: 보통 속도는 1).
Flow presence가 Absent임	Flow presence 동작이 HMI 장치에서 값을 읽도록 설정하고, HMI 장치가 활성 흐름 상태를 보고하는지 확인합니다.