HP Simple Horizontal Scale

• 실시간 센서 값을 수평 눈금자 위의 포인터 위치로 표시합니다.
• 상한 심각, 상한 경고, 하한 경고, 하한 심각 임계 구간을 정합니다.
• 눈금자에 목표나 설정값 표시를 보여 줄 수 있습니다(선택 사항).
• 눈금자 범위, 값 라벨, 단위, 소수 자릿수를 설정합니다.
• 눈금자, 경고 구간, 심각 구간의 색을 따로 정합니다.
• 위젯 심볼을 클릭하면 대시보드 동작을 실행합니다.
• HMI 장치 속성, 시계열, 알람 상태, 대시보드 상태에서 상태 데이터를 받습니다.

1. 대시보드를 열고 수정 모드로 바꿉니다.
2. 위쪽의 위젯 추가를 클릭하거나, 화면 가운데의 위젯 추가 아이콘을 클릭합니다.
3. General high-performance SCADA symbols 위젯 번들을 엽니다.
4. HP Simple horizontal scale를 선택합니다.
5. 위젯 설정을 마친 다음 추가를 클릭합니다.

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

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

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

매개변수	기본값	설명
Value	Use time series 'temperature'	현재 센서 측정값. 화살표 포인터가 눈금자에서 이 값에 해당하는 위치로 움직입니다. 데이터 소스 설정을 참고하세요.
Target value	Use attribute 'target'	기준값이나 설정값(선택 사항). 설정하면 눈금자의 이 위치에 두 번째 표시가 나타납니다. 데이터 소스 설정을 참고하세요.
On click	Do nothing	사용자가 위젯 심볼을 클릭하면 실행되는 동작. 클릭 동작 설정을 참고하세요.

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

Value와 Target value에 적용됩니다. 매개변수 옆의 편집 아이콘을 클릭하면 설정 대화상자가 열립니다. 동작이 아무 것도 하지 않음이면 값은 고정된 숫자입니다:

매개변수	값
Value	눈금자에 고정으로 표시할 숫자 값
Target value	고정 목표 표시로 쓸 숫자 값

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

• 속성 가져오기

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

  매개변수	설명
  속성 범위	속성이 저장된 곳: 전체, 클라이언트, 서버, 공유.
  속성 키	읽을 속성 이름(예: target).
  동작 결과 변환기	없음 — 속성 값을 그대로 씁니다. 함수 — f(data) 함수가 돌려주는 값을 씁니다.

• 시계열 가져오기

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

  매개변수	설명
  시계열 키	감시할 텔레메트리 키(예: temperature).
  동작 결과 변환기	없음 — 텔레메트리 값을 그대로 씁니다. 함수 — f(data) 함수가 돌려주는 값을 씁니다.

• 알람 상태 가져오기

  HMI 장치의 알람 발생에 따라 매개변수 값을 정합니다.

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

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

  현재 열린 대시보드 상태에 따라 매개변수 값을 정합니다.

  매개변수	설명
  동작 결과 변환기	없음 — 상태 이름을 그대로 씁니다. 함수 — f(data) 함수가 돌려주는 값을 씁니다.

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

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

  매개변수	설명
  값 파싱 함수	현재 대시보드 상태 객체를 받는 f(data) 함수. 활성 상태 이름은 data.id로, 상태 매개변수는 data.params로 확인합니다.

모양 영역은 위젯 제목, 눈금자 범위, 임계 위치, 값 표시, 라벨, 단위, 색상을 설정합니다.

설정	기본값	설명
제목	HP Simple horizontal scale	헤더에 표시되는 위젯 제목. entityName과 entityLabel 변수를 지원합니다.
카드 아이콘	—	위젯 헤더에 표시되는 아이콘. 크기와 색상을 설정합니다.
Min and max value	Min: 0, Max: 100	눈금자의 범위. 포인터는 이 범위 안에서 비율에 맞는 위치에 놓입니다.
High Critical scale	85	위쪽 심각 임계값. 이 값보다 위의 눈금자 구간이 심각 색으로 칠해집니다.
High Warning scale	70	위쪽 경고 임계값. 이 값과 위쪽 심각 임계값 사이의 눈금자 구간이 경고 색으로 칠해집니다.
Low Warning scale	30	아래쪽 경고 임계값. 아래쪽 심각 임계값과 이 값 사이의 눈금자 구간이 경고 색으로 칠해집니다.
Low Critical state	15	아래쪽 심각 임계값. 이 값보다 아래의 눈금자 구간이 심각 색으로 칠해집니다.
Value	켜짐	위젯에 숫자 값을 표시할지. 소수 자릿수, 글꼴, 색을 설정합니다.
Label	Outdoor	눈금자 옆에 표시되는 설명 라벨. 글꼴과 색을 설정합니다.
Units	°C	눈금자에 표시되는 단위 접미사. 글꼴과 색을 설정합니다.
Arrow color	회색	현재 값 위치를 가리키는 포인터 화살표의 색.
Target	꺼짐	눈금자에 목표 표시를 보여 줄지. 켜면 색을 설정합니다.
Scale color	하늘색	정상(임계 밖) 구간에서 눈금자 막대의 기본 색.
Warning scale color	Default: 회색, Active: 주황색	경고 구간의 색. Default는 값이 구간 밖에 있을 때, Active는 값이 구간 안에 있을 때 씁니다.
Critical scale color	Default: 회색, Active: 빨간색	심각 구간의 색. Default는 값이 구간 밖에 있을 때, Active는 값이 구간 안에 있을 때 씁니다.

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

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

포인터가 움직이지 않거나 늘 0에 있음

원인	해결 방법
Value 동작이 아무 것도 하지 않음이고 값이 0이거나 비어 있음	Value 편집 대화상자를 열고 HMI 장치 시계열 키나 속성에서 읽도록 설정합니다.
HMI 장치가 텔레메트리를 보내지 않음	HMI 장치가 온라인이고 기대하는 시계열 키를 보내고 있는지 확인합니다.

값이 임계 구간에 들어가도 눈금자 구간 색이 바뀌지 않음

원인	해결 방법
임계값이 설정한 눈금자 범위를 벗어남	High Critical scale, High Warning scale, Low Warning scale, Low Critical state가 모두 Min and max value 범위 안에 있는지 확인합니다.
경고나 심각 구간이 꺼져 있음	모양 영역에서 임계 토글이 켜져 있는지 확인합니다.

목표 표시가 나타나지 않음

원인	해결 방법
모양에서 Target이 꺼져 있음	모양 영역에서 Target 토글을 켭니다.
Target value 동작이 아무 것도 하지 않음이고 값이 0임	Target value 편집 대화상자를 열고 속성이나 시계열 키에서 읽도록 설정합니다.