クイックスタート：最初の EMS Builder 制御ループを構築

このガイドではテスト環境を使用し、「収集ポイントの読み取り → 集約式の試算 → 集約ポイントの作成 → 結果の検証」という最小のループを構築します。レビューしていない書き込みを本番デバイスで直接実行しないでください。

1. 準備

Edge-EMS Builder がインストールされ、正常に起動していること。
CommBridge が少なくとも 1 台のテストデバイスまたはシミュレーターに接続されていること。
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 の管理画面にログインします。
「収集データ」の一覧を開きます。
少なくとも 2 つの数値型収集ポイントがあることを確認します。例：
- 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 へ置き換えてください。

期待する結果：

式の構文検証に合格する。
数値が返る。
返された値が 2 つの収集ポイントの平均値と等しい。

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": "<テストパスワード>"
}

以降の要求には、ログイン API が返した Token を使用します。要求ヘッダー、フィールド、応答構造の詳細は、Edge-EMS Builder HTTP API ドキュメントを参照してください。実際の認証情報を文書、スクリプト、スクリーンショットに残さないでください。

6. 次のステップ：トリガープランの作成

集約ポイントを作成したら、次の機能を学習できます。

まずテスト環境で「高温アラーム」や「テストポイントの変化記録」など、デバイス制御リスクのないトリガープランを作成し、その後に実デバイスへの書き込みへ進むことを推奨します。

7. 完了条件

CommBridge が配信する収集ポイントを確認できる。
集約式の試算に成功する。
集約ポイントが作成され、更新される。
入力が __Null__ でもスクリプトがエラーにならない。
すべての操作をテスト環境で実施している。
文書、スクリプト、スクリーンショットに実際の認証情報を含まない。