속성

속성은 엔티티의 특성, 상태, 설정을 나타내는 키-값 쌍입니다. 텔레메트리와 달리 속성은 잘 바뀌지 않는 데이터를 나타내며, MX On Cloud는 최신 값과 그 타임스탬프만 저장합니다.

속성 항목은 다음으로 이루어집니다.

• Key — 속성 이름(예: maxTemperatureThreshold)
• Value — 문자열, boolean, integer, double 또는 JSON 객체
• Timestamp — 이 속성이 마지막으로 바뀐 시각(Unix epoch 밀리초)

페이로드 예시:

{ "reportingInterval": 60, "firmwareVersion": "v2.4.0", "alarmEnabled": true }

시계열 데이터와 달리 키마다 최신 값만 남고 이력은 없습니다.

MX On Cloud는 각 속성을 누가 읽고 쓸 수 있는지 정하는 세 가지 속성 범위를 지원합니다.

서버 속성은 플랫폼이 관리하는 메타데이터와 설정을 저장합니다. HMI 장치는 이 속성을 읽거나 바꿀 수 없으며, MX On Cloud UI나 REST API로만 관리합니다.

주요 용도: 위치 데이터, 알람 임계값, 운영 설정.

{
  "latitude": 40.7128,
  "longitude": -74.0060,
  "maxTemperatureThreshold": 40,
  "alarmEnabled": true
}

• latitude / longitude — 지도 위젯에서 엔티티 위치를 표시하는 데 사용
• maxTemperatureThreshold — 알람 규칙이 알람을 발생시킬 때 참조
• alarmEnabled — 알람 생성을 켤지 정함

공유 속성은 플랫폼의 설정을 HMI 장치로 전달합니다. 플랫폼이 쓰고, HMI 장치는 읽을 수 있지만 바꿀 수 없습니다.

주요 용도: HMI 장치 원격 설정(목표 펌웨어 버전, 보고 주기, 운영 임계값).

HMI 장치는 프로토콜에 따라 다음 방식으로 업데이트를 받습니다.

• 실시간(예: MQTT) — 속성 업데이트를 구독해 값이 바뀌는 즉시 알림을 받음
• 주기적 폴링(예: HTTP) — 일정 간격으로 서버에 최신 값을 요청

{
  "targetFirmwareVersion": "v2.4.0",
  "reportingInterval": 60,
  "maxTemperatureThreshold": 45
}

• targetFirmwareVersion — HMI 장치가 업그레이드가 필요한지 판단할 때 확인
• reportingInterval — HMI 장치가 텔레메트리를 보내는 주기(초)
• maxTemperatureThreshold — HMI 장치가 자체 제어 로직에서 쓰는 한계값

클라이언트 속성은 HMI 장치가 플랫폼에 보고합니다. 플랫폼은 저장하고 표시하지만 바꿀 수 없으며, 이 값은 HMI 장치만 쓸 수 있습니다.

주요 용도: 현재 펌웨어 버전, 현재 설정, HMI 장치 상태 보고.

{
  "currentFirmwareVersion": "v2.3.1",
  "currentConfiguration": { "mode": "auto", "interval": 30 },
  "deviceState": "ACTIVE"
}

• currentFirmwareVersion — 전체 장치의 펌웨어 모니터링에 사용
• currentConfiguration — HMI 장치에 현재 적용된 실행 설정(모드, 주기 등)
• deviceState — 현재 상태(예: ACTIVE, IDLE, ERROR)

1. 엔티티 상세 페이지를 엽니다(예: 개체 → 장치 → [장치 이름]).
2. 속성 탭으로 이동해 범위를 서버 속성, 공유 속성, 클라이언트 속성 중에서 선택합니다.
3. + 버튼을 클릭해 속성 추가 대화상자를 엽니다.
4. 키를 입력하고, 값 유형(문자열, 불리언, 정수, 실수, JSON)을 선택한 뒤 Value를 입력합니다.
5. 추가를 클릭합니다.

여러 자산과 그 속성을 한 번에 만들려면 CSV로 자산 가져오기를 사용하세요.