ルールエンジンのデータ転送機能を使用して、データを Function Compute に転送できます。その後、Function Compute は関数スクリプトを使用してビジネスデータを処理します。このトピックでは、データ転送プロセスについて説明します。この例では、TSL (Thing Specification Language)通信トピックをソース トピックとして使用します。
前提条件
Function Compute へのデータ転送をサポートするリージョンに、Function Compute にデータを転送できる IoT Platform インスタンスが作成されていること。詳細については、「リージョン」をご参照ください。
DataSource という名前のデータソースが作成され、TSL 通信トピックがデータソースに追加されていること。詳細については、「データソースを作成する」をご参照ください。
Function Compute サービスと関数が作成されていること。関数は設定済みであり、検証後に期待どおりに実行できること。詳細については、関数をすばやく作成する を参照してください。
重要関数を作成するときは、[関数タイプ] パラメーターを [イベント関数] のみに設定できます。
IoT Platform Enterprise Edition インスタンスを使用する場合、Enterprise Edition インスタンスが存在するのと同じリージョンで Function Compute をアクティブ化する必要があります。
背景情報
ルールエンジンは、データ転送機能を使用してデバイスデータを Function Compute に転送します。次に、Function Compute はビジネス固有の関数スクリプトを実行して、さまざまなビジネス機能を実装します。
次の図は、データ転送プロセスを示しています。
使用上の注意
データ転送機能の新バージョンまたは旧バージョンを使用して、データを Function Compute に転送することもできます。旧バージョンのデータ転送機能の使用方法の詳細については、「Function Compute へのデータ転送」をご参照ください。
データ転送先を作成する
IoT Platform コンソール にログオンします。
[概要] ページで、[すべての環境] をクリックします。[すべての環境] タブで、管理するインスタンスを見つけ、インスタンス ID またはインスタンス名をクリックします。
左側のナビゲーション ウィンドウで、 を選択します。
[データ転送] ページの右上隅にある [新しいバージョンに移動] をクリックして、新しいバージョンに移動します。
説明この手順を実行した場合、[メッセージ転送] > [データ転送] を選択すると、新しいバージョンの [データ転送] ページが表示されます。
[データ転送先] タブをクリックします。このタブで、[データ転送先を作成] をクリックします。
[データ転送先を作成] ダイアログ ボックスで、データ転送先名を入力します。この例では、DataPurpose を使用します。パラメーターを設定し、[OK] をクリックします。
パラメーター
説明
操作
[function Compute にデータを送信] を選択します。
リージョン
Function Compute サービスがデプロイされているリージョンを選択します。
サービス
Function Compute サービスを選択します。
[サービスの作成] をクリックして Function Compute コンソールに移動し、サービスを作成できます。詳細については、「サービスの管理」をご参照ください。
関数バージョン
更新の範囲。有効な値:
[デフォルトバージョンを使用]: Function Compute サービスのデフォルトバージョンを使用します。デフォルトバージョンは LATEST です。
[バージョンを選択]: 公開したサービスバージョンを選択します。
[バージョンの作成] をクリックして Function Compute コンソールに移動し、バージョンを作成できます。詳細については、「バージョンの管理」をご参照ください。
[エイリアスを選択]: Function Compute サービスのバージョンに指定したエイリアスを選択します。
[エイリアスの作成] をクリックして Function Compute コンソールに移動し、エイリアスを作成できます。詳細については、「エイリアスの管理」をご参照ください。
関数
データの受信に使用する関数を選択します。
[関数の作成] をクリックして Function Compute コンソールに移動し、関数を作成できます。詳細については、「関数の管理」をご参照ください。
権限の付与
IoT Platform に Function Compute にデータを書き込む権限を付与します。
Resource Access Management (RAM)ロールがない場合は、[RAM ロールの作成] をクリックして RAM コンソールに移動し、RAM ロールを作成してから、そのロールに権限を付与します。詳細については、「RAM ロールの作成」をご参照ください。
パーサーを設定して起動する
DataParser という名前のパーサーを作成します。詳細については、「パーサーを作成する」をご参照ください。
[パーサーの詳細] ページで、パーサーを作成済みのデータソースに関連付けます。
ウィザードの [データソース] ステップで、[データソースの関連付け] をクリックします。
表示されるダイアログ ボックスで、データソース[データソース] ドロップダウン リストから [OK] を選択し、 をクリックします。
[パーサーの詳細] ページで、パーサーを作成済みのデータ転送先に関連付けます。
ウィザードの [データ転送先] をクリックします。[データ転送先] セクションで、[データ転送先の関連付け] をクリックします。
表示されるダイアログ ボックスで、データ目的[データ転送先] ドロップダウン リストから [OK] を選択し、 をクリックします。
「データ転送先」セクションで、[データ転送先 ID] を表示して保存します。この例では、ID は 1000 です。
パーサースクリプトを記述するときは、[データ転送先 ID] を使用する必要があります。
[パーサーの詳細] ページで、[パーサー] をクリックします。
コードエディターで、スクリプトを入力します。スクリプトの変更方法の詳細については、「スクリプト構文」をご参照ください。
関数パラメーターの詳細については、「関数」をご参照ください。
// payload() 関数を使用して、デバイスから送信されたデータを取得し、JSON 形式のデータに変換します。 var data = payload("json"); // 送信された TSL データを転送します。 writeFc(1000, data);
[デバッグ] をクリックします。表示されるダイアログ ボックスで、プロダクトとデバイスを選択し、トピックを指定して、ペイロードデータを入力し、スクリプトが期待どおりに実行されるかどうかを確認します。
次の図は、パラメーターを示しています。
次の結果は、スクリプトが期待どおりに実行されたことを示しています。
[公開] をクリックします。
パーサー[データ転送] ページの データパーサー開始 タブに移動します。 パーサーを見つけ、[アクション] 列の をクリックしてパーサーを起動します。
Function Compute コンソール にログオンします。関数の詳細ページで、[ログ] タブをクリックして、関数の履歴実行レコードを表示します。詳細ページの右上隅で、[その他] > [モニタリング] を選択して、関数のモニタリング統計を表示します。
重要関数のモニタリング統計は、関数が実行されてから 5 分後に生成されます。