:クラウドにおけるシーンオーケストレーション

シーンルールの作成

1. IoT Platform コンソールします。
2. 左側のナビゲーションウィンドウで、[メッセージ転送] > [シーンオーケストレーション] を選択します。
3. [ルールの作成] をクリックします。
4. パラメーターを構成し、[OK] をクリックします。次の表にパラメーターを示します。

   パラメーター	説明
   ルール名	ルールの名前。名前は 1 ～ 30 文字で、文字、数字、アンダースコア（_）、およびハイフン（-）を含めることができます。
   ルールの説明	オプション。ルールの説明。

5. シーンルールが作成された後、表示されるメッセージの [編集] をクリックしてルールを構成します。
   ルール名の右側にある [表示] をクリックして、シーンルールを構成することもできます。

   たとえば、シーンルールを使用してエアコンを自動化できます。温度センサーから報告された 12:00 ～ 23:59 の間の室内温度が 16℃未満の場合、エアコンは自動的に室内温度を 26℃に上げます。

   次の図は、パラメーターの構成を示しています。

   

   表示されるページの右上隅にある [編集] をクリックして、シーンルール名を変更します。その他のパラメーターの詳細については、次の表を参照してください。

   パラメーター	説明
   トリガー	ルールを開始するトリガー。有効な値：[デバイストリガー] および [時間指定トリガー]。報告されたデバイスデータまたは現在の時刻がトリガーと一致すると、システムはルールのトリガー条件が満たされているかどうかを確認します。1 つのルールに対して 1 つ以上のトリガーを作成できます。トリガーは論理 OR 演算子で接続されます。 このパラメーターを [デバイストリガー] に設定する場合は、既存のプロダクト、1 つまたはすべてのデバイス、および 1 つまたはすべてのプロパティまたは 1 つまたはすべてのイベントを選択する必要があります。 このパラメーターを [時間指定トリガー] に設定する場合は、時点を指定する必要があります。時点は、CRON 式を使用して指定する必要があります。CRON 式は、分、時、日、月、曜日の 5 つのフィールドで構成されます。曜日については、値 0 または 7 は日曜日を示し、値 1 ～ 6 は月曜日から土曜日を示します。これらのフィールドはスペースで区切ります。たとえば、0 18 * * * 形式で毎日 18:00:00 にルールをトリガーする CRON 式を作成できます。また、0 18 * * 5 形式で毎週金曜日の 18:00:00 にルールをトリガーする CRON 式を作成することもできます。アスタリスク（*）はワイルドカード文字です。CRON 式の作成方法の詳細については、「CRONTAB」をご参照ください。 前の例では、このパラメーターは [デバイストリガー] に設定されています。この場合、トリガーは、温度センサーから報告された室内温度が 16℃未満であるシナリオを指します。
   条件	条件。ルールは、データがすべての条件を満たしている場合にのみトリガーされます。このパラメーターは、[デバイスステータス] または [時間範囲] に設定できます。1 つのルールに対して 1 つ以上の条件を構成できます。条件は論理 AND 演算子で接続されます。 このパラメーターを [デバイスステータス] に設定する場合は、既存のプロダクト、プロダクトのデバイス、およびデバイス機能のプロパティまたはイベントを選択する必要があります。 このパラメーターを [時間範囲] に設定する場合は、yyyy-mm-dd hh24:mi:ss 形式で開始時刻と終了時刻を指定する必要があります。 前の例では、このパラメーターは [時間範囲] に設定されており、ルールは 12:00 ～ 23:59 の間にトリガーできます。
   アクション	実行されるアクション。1 つ以上のアクションを構成できます。アクションが失敗した場合、そのアクションは他のアクションに影響を与えません。 このパラメーターを [デバイス出力] に設定する場合は、既存のプロダクト、プロダクトのデバイス、およびデバイス機能のプロパティまたはサービスを選択する必要があります。書き込み可能なプロパティまたはサービスのみを選択してアクションを実行できます。IoT Platform は、ルールのトリガーと条件が満たされたときに、定義されたデバイスプロパティまたはサービスに基づいてアクションを実行します。 このパラメーターを [ルール出力] に設定する場合は、別のルールを選択する必要があります。アクションは、選択したルールを呼び出します。呼び出されたルールのトリガーはスキップされ、ルールの条件のみがチェックされます。条件が満たされると、呼び出されたルールで定義されているアクションが実行されます。 たとえば、ルール A がトリガーされると、ルール A のトリガーはスキップされます。ルール A の条件がチェックされます。ルール A のすべての条件が満たされると、IoT Platform はルール A のアクションを実行します。条件は論理 AND 演算子で接続されます。 前の例では、このパラメーターは [デバイス出力] に設定されています。ルールがトリガーされると、エアコンは温度を 26℃に上げます。
   遅延実行	このパラメーターは、詳細オプションを表示した後に表示されます。このパラメーターを構成すると、指定されたアクションが指定された期間内に実行されます。 有効な値：0 ～ 86400。単位：秒。

シーンルールの開始

シーンルールを作成した後、[シーンオーケストレーション] ページでシーンルールを開始できます。

シーンルールを開始するには、次の手順を実行します。

1. IoT Platform コンソール にログインします。左側のナビゲーションウィンドウで、[メッセージ転送] > [シーンオーケストレーション] を選択します。
2. 開始するシーンルールを見つけ、[開始] をクリックします。ルールステータスが [実行中] に変わります。
   

ルールを開始した後：

• シーンルールがクラウドで実行される場合は、シーンルールのデバイスのメッセージルーティングを構成する必要があります。これにより、デバイスのプロパティとイベントをクラウドで実行されている IoT Hub に送信できます。メッセージルートの構成方法の詳細については、「メッセージルーティングを構成する」をご参照ください。
• シーンルールがエッジで実行される場合は、クラウドでのシーンルールの実行を [停止] し、シーンルールをエッジインスタンスに割り当てる必要があります。詳細については、「シーンオーケストレーションのその他の操作」をご参照ください。

ログの表示

シーンルールのログを表示し、詳細ページで結果を表示できます。

1. IoT Platform コンソール の左側のナビゲーションウィンドウで、[メッセージ転送] > [シーンオーケストレーション] を選択します。
2. 表示するシーンルールを見つけ、右側にある [ログ] をクリックします。
3. [詳細] をクリックして、ログの詳細を表示します。
   

   説明 ログが 失敗 状態の場合は、[アクション] 列の [詳細] をクリックして、実行エラーの詳細を表示できます。

シーンオーケストレーションのその他の操作

• シーンルールを削除する：
  1. [シーンオーケストレーション] ページで、削除するルールを見つけます。
  2. ルール名の右側にある [削除] をクリックします。表示されるメッセージで、[OK] をクリックしてシーンルールを削除します。
• シーンルールをトリガーする：

  シーンルールを開始した後、ルールをトリガーできます。

  1. [シーンオーケストレーション] ページで、トリガーするルールを見つけます。
  2. ルール名の右側にある [トリガー] をクリックします。ルールが 1 回トリガーされます。指定されたトリガーに関係なく、ルールのすべてのアクションが実行されます。
• エッジインスタンスでシーンルールを実行する：
  エッジインスタンスにシーンルールをデプロイするには、次の手順を実行します。

  重要 クラウドでのシーンルールの実行を停止していることを確認してください。
  1. Link IoT Edge コンソール にログインします。左側のナビゲーションウィンドウで、[エッジインスタンス] をクリックします。作成したエッジインスタンスを見つけ、[アクション] 列の [表示] をクリックします。
  2. [インスタンスの詳細] ページで、[シーン] タブをクリックします。次に、[シーンの割り当て] をクリックします。
  3. [シーンの割り当て] パネルで、ルール名の右側にある [割り当て] をクリックします。次に、[閉じる] をクリックします。
  4. シーンルールが割り当てられたら、エッジインスタンスを再デプロイします。