トリガープラン

トリガープランは「いつ確認するか、どの条件で、何を実行するか」を再利用可能なルールにまとめます。

プランの構造

1 つのプランに複数のトリガーを含めることができます。各トリガーは条件とアクションを持ち、条件を 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 を使用できます。