트리거 구성

트리거 구성은 “언제 확인하고, 어떤 조건에서, 어떤 동작을 실행할지”를 재사용 가능한 규칙으로 묶습니다.

구성 구조

하나의 구성에 여러 트리거를 포함할 수 있습니다. 각 트리거에는 조건과 동작이 있고, 조건은 AND / OR로 조합할 수 있습니다. 구성은 활성화/비활성화할 수 있으며 전체 유효 날짜를 설정할 수 있습니다.

조건	용도
CRON	달력 일정에 따라 실행
TIME_POINT	매일 지정 시각에 실행하며 구성의 날짜 범위와 결합 가능
TIME_PERIOD	지정 시간 구간에 확인
INTERVAL	고정 간격으로 확인
DATA_CHANGE	데이터 포인트 변경 시 조건을 계산하며 공유 데이터 지원

데이터 조건 스크립트는 불리언 값을 반환합니다. 데이터가 누락되면 명시적으로 판단하거나 먼저 tonumber으로 변환하여 누락 데이터를 유효한 관측으로 취급하지 않도록 합니다.

동작 및 반환값

동작은 쓰기 가능한 데이터 포인트, 시간대별 계획, 집계 변수 또는 원격 장치에 쓸 수 있으며, 알람 기록, 알람 관측 제출 및 MQTT 발행도 가능합니다.

구성 또는 상황	스크립트 반환값
EXPRESSION 구성	인덱스 1부터 시작하는 동작 배열
MIXED 단일 포인트 쓰기	해당 데이터 포인트의 단일 값
데이터 변경 조건	true / false

EXPRESSION 동작에서 집계 런타임 변수를 갱신하는 예:

return {buildGeneralWriteMap("Aggregation", "demo_state", "ready", false)}

사용 전에 예제 데이터 포인트를 실제 설정으로 바꾸세요. 함수는 실행할 동작만 생성하며, 장치가 이미 성공적으로 실행했음을 의미하지 않습니다.

알람 규칙

간단한 알림에는 개별 알람 기록을 생성할 수 있습니다. 복구 및 처리 절차가 필요하면 알람 이벤트를 사용하여 ACTIVE, NORMAL 또는 UNKNOWN 관측을 지속적으로 보고하고 이상 발생 시에만 트리거하지 마세요.

후처리 및 실행 기록

동작은 needPostProcess / postProcessContent를 통한 후처리 설정을 지원합니다. 스크립트 검증에서 반환 구조를 확인할 수 있지만 표현식이 실제 평가되므로, 직접 호출이 포함된 스크립트는 먼저 부수 효과를 확인해야 합니다.

트리거 기록을 조회하여 조건, 실행 결과 및 오류를 확인할 수 있습니다. 장치를 제어할 때는 장치 제어 로그와 데이터 포인트 다시 읽기를 함께 확인하여 요청 전송과 실제 장치 실행을 구분해야 합니다.

동적 장치 및 구성 활성화/비활성화

접두사, 접미사 등의 조회를 통해 수가 변하는 장치를 처리할 수 있습니다. 일괄 조회는 dataKey를 키로 하는 테이블을 반환하므로 pairs()를 사용해야 합니다. 동적으로 조합한 조회 패턴은 의존성이 완전한지 검증해야 합니다. 영향을 받는 데이터 포인트를 구성에 지정하면 상세 화면에서 현재 값을 확인할 수 있어 전략을 이해하기 쉽습니다.

비활성화, 삭제 또는 만료된 구성은 실행 작업을 해제하며, 실행 전에 상위 구성 상태를 확인합니다. 이미 장치로 보낸 명령은 실제 결과를 확인해야 합니다. 빈번하게 실행하는 전략에는 필요에 따라 빈도 제한을 적용하여 중복 전송을 줄입니다.

자세한 스크립트는 트리거 동작 참조와 Lua 참조를 참조하세요. Agent로 설정할 때는 트리거 구성 Skill을 사용할 수 있습니다.