빠른 시작: 첫 EMS Builder 전략 폐루프 완성

이 가이드는 테스트 환경에서 “수집 데이터 포인트 읽기 → 집계 표현식 시험 계산 → 집계 데이터 포인트 생성 → 결과 검증”의 최소 폐루프를 완성합니다. 검토하지 않은 쓰기 작업을 운영 장치에서 직접 실행하지 마세요.

1. 준비 조건

Edge-EMS Builder가 설치되어 정상 실행 중이어야 합니다.
CommBridge에 테스트 장치 또는 시뮬레이터가 하나 이상 연결되어 있어야 합니다.
Edge-EMS Builder 관리자 테스트 계정이 준비되어 있어야 합니다.
Edge-EMS Builder 주소를 확인해야 합니다.
- LAN 직접 연결: http://<장치_IP>:8988
- JelinaCloud 프록시: https://<장치_UUID>.proxy.jelina.wise-iot-cloud.com/api

주소, 포트 및 계정에는 자체 테스트 환경 정보를 사용하세요. 실제 암호, Token 또는 장치 UUID를 코드 저장소에 커밋하지 마세요.

2. EMS Builder 및 CommBridge 데이터 확인

Edge-EMS Builder 관리 페이지에 로그인합니다.
“수집 데이터” 목록을 엽니다.
숫자형 수집 데이터 포인트가 두 개 이상 있는지 확인합니다. 예:
- voltage_a
- voltage_b
데이터 포인트에 최신 값이 있고 통신 상태가 정상인지 확인합니다.

수집 데이터 포인트가 없으면 다음을 먼저 확인합니다.

CommBridge 프로젝트, 노드 및 수집 작업이 활성화되어 있는지
Edge-EMS Builder의 CommBridge WebSocket 주소가 올바른지
장치 또는 시뮬레이터가 온라인인지
Edge-EMS Builder와 CommBridge 로그에 연결 또는 설정 오류가 있는지

3. 집계 표현식 시험 계산

“집계 데이터” 페이지에서 “시험 계산”을 선택하고 다음을 입력합니다.

if ${voltage_a} == "__Null__" or ${voltage_b} == "__Null__" then
    return 0
end

local a = tonumber(${voltage_a}) or 0
local b = tonumber(${voltage_b}) or 0
return (a + b) / 2

예제의 voltage_a, voltage_b를 테스트 환경에 실제로 존재하는 dataKey로 교체합니다.

예상 결과:

표현식 문법 검증 통과
숫자 값 반환
반환값이 두 수집 데이터 포인트의 평균과 일치

4. 첫 집계 데이터 포인트 생성

시험 계산을 통과하면 집계 데이터 포인트를 생성합니다.

필드	예
dataKey	`voltage_avg`
이름	평균 전압
데이터 유형	float
표현식	이전 단계의 시험 계산을 통과한 Lua 사용
수집/계산 주기	테스트 환경 요구에 따라 설정

저장 후:

집계 데이터 목록으로 돌아갑니다.
voltage_avg가 생성되었는지 확인합니다.
시뮬레이터의 voltage_a 또는 voltage_b를 변경합니다.
voltage_avg도 함께 갱신되는지 확인합니다.

5. API로 같은 작업 수행

해당 Edge-EMS Builder 인터페이스는 다음과 같습니다.

POST /account/login
GET /collection-data-config/list
POST /aggregation-data-config/calculate
POST /aggregation-data-config/add
GET /aggregation-data-config/list

로그인 요청 예:

{
  "mail": "<테스트_계정>",
  "password": "<테스트_암호>"
}

이후 요청에는 로그인 인터페이스가 반환한 Token을 사용합니다. 구체적인 요청 헤더, 필드 및 반환 구조는 Edge-EMS Builder HTTP 인터페이스 문서를 참조하세요. 문서, 스크립트 또는 화면 캡처에 실제 자격 증명을 남기지 마세요.

6. 다음 단계: 트리거 구성 생성

집계 데이터 포인트를 완성한 후 다음 내용을 학습할 수 있습니다.

먼저 테스트 환경에서 “고온 알람” 또는 “테스트 데이터 포인트 변경 기록”처럼 장치 제어 위험이 없는 트리거 구성을 만든 후 실제 장치 쓰기로 진행하는 것이 좋습니다.

7. 완료 기준

CommBridge가 전송하는 수집 데이터 포인트를 확인할 수 있음
집계 표현식 시험 계산 통과
집계 데이터 포인트 생성 및 갱신 성공
입력이 __Null__일 때 스크립트 오류가 발생하지 않음
전체 작업을 테스트 환경에서 수행
문서, 스크립트 및 화면 캡처에 실제 자격 증명이 없음