コマンドの入力と送信

25 分

ラボの概要

Dynamics 365 の Connected Field Service ソリューションでは、IoT 対応デバイスをリモートで監視し、稼動時間、デバイス統計情報、異常などを追跡する機能が提供されます。 IoT デバイスによって異常または例外が通知されると、その情報は、通知として Connected Field Service に送信されます。通知がキャプチャされると、Dynamics 365 内から IoT デバイスコマンドを使用して IoT デバイスをリモートで管理および対話することができます。柔軟性を高めるために、コマンド定義とプロパティ定義を使用して、これらのコマンドに設定されたデータを簡単に設定できます。

このハンズオンラボの目的は、Connected Field Service でのコマンド定義とプロパティ定義の作成と定義を紹介することです。また、Dynamics 365 機能を使ってコマンドを送信するプロセスを自動化する方法について説明します。

シナリオ

あなたは、スマートホームデバイスの販売とサービスを行っている配管と暖房関連の会社に勤務しているものとします。サービス対象のデバイスの多くはスマートデバイスであるため、これらのデバイスからの情報をリモートでキャプチャして、その設備のサービスに役立てることができます。組織では、設備のサービスを行うときに使用されプロセスを含むいくつかのシナリオが定義されています。これらのプロセスは、次のような複数の要因によって変わる可能性があります。

サービスを必要とするデバイスの種類
検出された問題の重要度
デバイスの経過期間
デバイスの場所
特定のデバイスで動作するリソースの利用可能性

上記の項目は、組織が設備の保守プロセスを決定するために使用する要因のほんの一部のみを表します。

最近、多数のスマートサーモスタットデバイスがインストールされました。これらのデバイスは、一貫した温度と湿度を維持することが重要な場合に、領域内の温度と湿度の読み取り値を追跡するのに便利です。以前より多くの情報を使用できるようになったため、これらのデバイスによって報告された問題を処理および解決するための新しいプロセスを作成する必要があります。最初に注目する領域は、温度関連の問題に使用するプロセスの自動化です。

組織では、次のプロセスを実装することを予定しています。

デバイスで 70 度を上回る温度が検出された場合、Connected Field Service 環境内でアラートが通知されます。
温度が 70 度から 85 度の範囲である場合、デバイスをリモートリセットして問題が解決したかどうかを確認する、コマンドが送信されます。

組織では、技術者によるコマンド作成とパラメーター修正を可能な限り簡単にすることを望んでいます。このようなスマートサーモスタットデバイスに共通のコマンドとプロパティのいくつかを事前定義することを希望しています。

事前に定義する 2 つのコマンドは次のとおりです。

通知:

{"CommandName":"Notification","Parameters":{"Message":"Technician has been dispatched"}}

設定した値:

{"CommandName":"Set Values","Parameters":{"Reading":{"Temperature":"30","Humidity":"30"}}}

演習 1: コマンドとプロパティを定義する

タスク 1: デバイスカテゴリを作成する

Power Apps に移動し、Connected Field Service が構成された正しい環境にいることを確認します。
[アプリ] を選択し、Connected Field Service アプリケーションをクリックして開きます。
サイトマップの設定領域に切り替えます。
デバイスカテゴリを選択し、+ 新規をクリックします。
名前に温度と入力し、保存をクリックします。
+ 新規をもう一度クリックします。
名前に湿度と入力し、保存をクリックします。

タスク 2: プロパティの定義を作成する

サイトマップからプロパティ定義を選択し、+ 新規をクリックします。
プロパティ定義を次のように構成します。
- 名前: メッセージ
- 型: 文字列
- 編集可能: はい
- 表示: はい
- 追加プロパティ:
  - 既定値: 技術者が派遣されました。
メッセージ プロパティ定義を保存して閉じます。
+ 新規ボタンをクリックします。
プロパティ定義を次のように構成します。
- 名前: 読み取り
- 型: オブジェクト
読み取り値プロパティ定義を保存して閉じます。
+ 新規ボタンをクリックします。
プロパティ定義を次のように構成します。
- 名前: 温度
- 型: 整数
- 親プロパティ: 読み取り
- 編集可能: はい
- 表示: はい
- 追加プロパティ:
  - MinValue: 1
  - MaxValue: 120
  - 既定: 65
温度プロパティ定義を保存して閉じます。
+ 新規をもう一度クリックします。
プロパティ定義を次のように構成します。
- 名前: 湿度
- 型: 整数
- 親プロパティ: 読み取り
- 編集可能: はい
- 表示: はい
- 追加プロパティ:
  - MinValue: 1
  - MaxValue: 100
  - 既定: 40
湿度プロパティ定義を保存して閉じます。
完成したプロパティ定義は次の図のようになります。

タスク 3: コマンドの定義を作成する

コマンド定義を選択し、+ 新規をクリックします。
コマンド定義を次のように構成します。
1. 名前: 通知
通知コマンド定義を保存して、開いたままにしておきます。これは、[プロパティ定義] サブグリッドも有効にします。
既存の IoT デバイスカテゴリの追加をクリックします。
[レコードの検索] で、温度と湿度の両方のカテゴリを選択します。
追加をクリックします。
既存の IoT プロパティ定義の追加をクリックします。
メッセージを選択し、追加をクリックします。
完成した通知コマンド定義は次の図のようになります。
+ 新規ボタンをクリックします。
コマンド定義を次のように構成します。
- 名前: 値の設定
値の設定コマンド定義を保存して、開いたままにしておきます。
既存の IoT デバイスカテゴリの追加をクリックします。
[レコードの検索] で、温度と湿度の両方のカテゴリを選択します。
追加をクリックします。
既存の IoT プロパティ定義の追加をクリックします。
読み取りを選択し、追加をクリックします。
完成した値の設定コマンド定義は次の図のようになります。

演習 2: 定義を使用してコマンドを設定する

タスク 1: シミュレーターにアタッチする (省略可能)

注

ユニット 3 の演習で既にシミュレーターを開いている場合、直接タスク 2 にスキップできます。それ以外の場合は、次の手順に従ってシミュレーターにアタッチします。

Web ブラウザーで新しいタブを選択し、Azure portal に移動します。求められた場合は、Azure にサインインします。使用しているアカウントに関連付けられた Azure サブスクリプションが必要です。
リソースグループを選択します。
Connected Field Service で使用しているリソースグループを開き、シミュレーターを選択します。
シミュレーターの URL をクリックして、サーモスタットシミュレーターを開きます。シミュレーターが新しいタブで開きます。
シミュレーターで、接続をクリックします。
Azure サブスクリプションに戻り、シミュレーターの App Service 画面を閉じます。
IoT ハブを開きます。
IoT ハブ名を強調表示にして、それをコピーします。
シミュレーター画面に戻り、IoT ハブ名をホスト フィールドに貼り付けます。
Azure サブスクリプションに戻り、共有アクセスポリシーを選択します。
iothubowner ポリシーを開き、主キーをコピーします。
シミュレーター画面に戻り、主キーをキーフィールドに貼り付けます。
接続ボタンをクリックします。シミュレーターが接続され、使用準備ができています。

タスク 2: シミュレーターを使用して通知を生成し対話する

シミュレーターが開かれている状態で、更新ボタンをクリックして登録されたすべてのデバイスを使用できるようにします。
デバイスの選択ドロップダウンで、smt-9876 デバイスを選択します。 [更新] ボタンの横に緑色の点が表示され、数秒後、情報の送信が開始されます。
温度スライダーで 75 度に設定して、温度ステータスが送信されたメッセージ ウィンドウに登録されるまで待ちます。
Connected Field Service が読み込まれているブラウザータブに切り替えます。
Connected Field Service サイトマップ領域に切り替えます。
IoT 通知を選択します。
温度 75 度はしきい値の 70 を上回っていることを示す通知を開きます。
コマンドバーで、コマンドの送信をクリックします。
詳細をクリックします。
名前にデバイスの値の設定と入力します。
送信するメッセージで、コマンドの横にある検索フィールドをクリックし、値の設定コマンドを選択します。
メッセージは事前に定義されている温度と湿度のプロパティを使用して表示されます。
1. 温度を 60 に変更します
2. 湿度を 35 に変更します
コマンドバーで、送信して閉じるボタンをクリックします。
シミュレーターに戻り、しばらくすると、デバイスの値がメッセージで定義された値に設定されます。インターネット速度やその他の要因に応じて、この発生には数分かかる場合があります。
デバイスの温度を 86 度に設定して、送信済みメッセージに登録されるまで待ちます。
Connected Field Service が読み込まれているブラウザータブに切り替えます。
IoT 通知を選択します。
温度 86 度はしきい値の 70 を上回っていることを示す通知を開きます。
コマンドバーで、コマンドの送信をクリックします。
詳細をクリックします。
[名前] に技術者の派遣と入力します。
送信するメッセージで、コマンドの横にある検索フィールドをクリックし、値の設定コマンドを選択します。
メッセージは事前に定義されているメッセージ プロパティを使用して表示されます。
コマンドバーで、送信して閉じるボタンをクリックします。
シミュレーターに戻り、しばらくすると、技術者が派遣されたことを示すメッセージが [受信したメッセージ] に表示されます。インターネット速度やその他の要因に応じて、この発生には数分かかる場合があります。
Connected Field Service 環境で "IOT 通知" の状態を確認すると、"処理中 -- コマンドの送信" に変わっているはずです。

演習 3: コマンドの送信を自動化する

タスク 1: 新しい IoT 通知プロセスソリューションを作成する

Power Apps に移動し、正しい環境にいることを確認します。
ソリューションを選択し、新しいソリューションをクリックします。
ソリューションに IoT 通知プロセスという名前を付けます。
発行元ドロップダウンをクリックし、+ 発行元を選択します。
発行元を次のように構成します。
1. 表示名: Connected Field Service コース
2. 接頭辞: cfs
保存して閉じるをクリックします。
発行元ドロップダウンをクリックし、作成した発行元を選択します。
[バージョン] フィールドに、1.0.0.0 と入力します。作成をクリックします。
作成した IoT 通知プロセス ソリューションをクリックして開きます。
既存の追加をクリックして、エンティティを選択します。
IoT 通知を選択し、次へをクリックします。
必須コンポーネントは含めないでください。追加をもう一度クリックします。

タスク 2: IoT 通知エンティティをカスタマイズする

IoT 通知プロセス ソリューションをクリックして開きます。
IoT 通知エンティティをクリックして開きます。
フィールド タブを選択し、+ フィールドの追加をクリックします。
次に示す情報を入力します。
1. 表示名: 読み取り
2. データ型: 整数
3. 最小値: 0
4. 最大値: 250
完了をクリックします。
+ フィールドの追加をもう一度クリックします。
新しいフィールドを次のように構成します。
1. 表示名: 顧客
2. データ型: 検索
3. ターゲットレコードの種類: 取引先企業
完了をクリックします。
エンティティをクリックします。
ソリューションを選択し、すべてのカスタマイズの公開をクリックします。

タスク 3: 値の設定コマンドメッセージをコピーする

Power Apps に移動し、正しい環境にいることを確認します。
アプリを選択し、Connected Field Service アプリケーションを開きます。
コマンドを選択し、+ 新規をクリックします。
送信するメッセージセクションまで下にスクロールし、コマンドとして値の設定を選択します。
JSON ビューに切り替えをクリックします。
JSON をコピーし、メモ帳に保存します。
コマンドレコードを保存せずに、Connected Field Service アプリケーションを閉じます。

タスク 4: 値を設定するフローを作成する

Power Apps に移動し、正しい環境にいることを確認します。
ソリューションを選択し、IoT 通知プロセス ソリューションをクリックして開きます。
+ 新規をクリックし、フローを選択します。新しいウィンドウが開きます。
フローの名前を通知フィールドの設定と値の設定に変更します。
Microsoft Dataverse を検索して、Common Data Service (現在の環境) を選択します。 "現在の環境" を含むものを選択したことを確認します。
レコードが作成、更新、または削除されたときを選択します。
トリガー条件で作成、エンティティで IoT 通知、スコープで組織を選択します。
メニュー ボタンをクリックして、名前の変更を選択します。
通知が作成されたときに名前を変更し、+ 新しいステップをクリックします。
解析を探し、JSON の解析を選択します。
コンテンツ フィールドをクリックし、動的なコンテンツ ペインで通知データを選択します。

スキーマ フィールドに、次の JSON スキーマを貼り付けます。

 {
     "type": "object",
     "properties": {
         "deviceid": {
             "type": "string"
         },
         "readingtype": {
             "type": "string"
         },
         "reading": {
             "type": "integer"
         },
         "eventtoken": {
             "type": "string"
         },
         "threshold": {
             "type": "integer"
         },
         "ruleoutput": {
             "type": "string"
         },
         "time": {
             "type": "string"
         }
     }
 }

ステップの名前を ParseAlertDate に変更し、+ 新しいステップをクリックします。
レコードの更新を検索して、レコードの更新 (現在の環境) を選択します。"現在の環境" を含むものを選択したことを確認します。
ステップの名前を顧客資産の取得に変更します。
エンティティ名で顧客資産を選択します。
品目の識別子フィールドをクリックし、DynamicContent ペインで顧客資産 (値) を選択します。
+ 新しいステップをクリックします。
レコードの更新を探して、レコードの更新 (現在の環境) を選択します。 "現在の環境" を含むものを選択したことを確認します。
ステップの名前を通知を更新するに変更します。
エンティティ名で IoT 通知を選択し、レコード識別子フィールドをクリックして、動的なコンテンツ ペインから IoT 通知を選択します。
詳細オプションを表示するをクリックします。
顧客 (取引先企業)フィールドをクリックし、accounts() と入力します。
( と ) の間にカーソルを置き、動的なコンテンツから取引先企業 (値) を選択します。
読み取りフィールドをクリックし、動的なコンテンツから JSON の解析ステップの reading を選択します。
詳細オプションを非表示にします。
+ 新しいステップをクリックします。
条件を選択します。
値の選択フィールドをクリックし、通知を更新するステップから読み取りを選択します。
次の値以上を選択します。
値に 71 と入力し、+ 追加をクリックして、行の追加を選択します。
値の選択フィールドをクリックし、動的なコンテンツの通知を更新するステップから読み取りを選択します。
次の値以下を選択します。
値に 85 と入力します。
条件は次の図のようになります。
はい分岐に移動し、アクションの追加をクリックします。
新しいレコードの作成を探し、新しいレコードの作成 (現在の環境) を選択します。 "現在の環境" を含むものを選択したことを確認します。
ステップの名前を値の設定コマンドの送信に変更します。
エンティティ名で IoT デバイスコマンドを選択し、名前フィールドをクリックして、動的なコンテンツの通知が作成されたときアクションから説明を選択します。
名前にデバイスの値の設定を追加し、詳細オプションの表示をクリックします。
顧客資産フィールドをクリックし、msdyn_customerassets() と入力します。
( と ) の間にカーソルを置き、動的なコンテンツの通知が作成されたときアクションから顧客資産 (値) を選択します。
デバイスフィールドをクリックし、msdyn_iotdevices() と入力します。
( と ) の間にカーソルを置き、動的なコンテンツの通知が作成されたときアクションからデバイス (値) を選択します。
上位通知フィールドをクリックし、msdyn_iotalerts() と入力します。
( と ) の間にカーソルを置き、動的なコンテンツの通知を更新するアクションから IoT 通知を選択します。
デバイス ID フィールドを選択し、動的なコンテンツ ペインの通知が作成されたときアクションからデバイス ID を選択します。
値の設定コマンドからコピーした JSON を、メッセージ フィールドに貼り付けます。
```
 {"CommandName":"Set Values","Parameters":{"Reading":{"Temperature":65,"Humidity":40}}}
```
詳細オプションを表示しないをクリックします。
アクションの追加をクリックします。
レコードの更新を探して、レコードの更新 (現在の環境) を選択します。"現在の環境" を含むものを選択したことを確認します。
ステップの名前を通知を非アクティブ化するに変更します。
エンティティ名で IoT 通知を選択します。
レコード識別子フィールドをクリックし、動的なコンテンツ ペインの通知を更新するアクションから IoT 通知を選択します。
詳細オプションを表示するをクリックします。
状態を非アクティブに設定し、詳細オプションを非表示にします。
フローは次の図のようになります。
保存をクリックします。

タスク 5: プロセスをテストする

シミュレーターを含む Web ブラウザータブに戻ります。接続されていない場合は、同じプロセスに従ってシミュレーターを開き、IoT Hub への接続を作成します。
温度を 80 度に設定して、送信済みメッセージ ウィンドウに登録されるまで待ちます。

温度が 71 度から 85 度の間にあったため、デバイスに値を設定するために、コマンドをデバイスに送信します。再起動コマンドをデバイスに送信するのに数分かかることがあります。
Connected Field Service が読み込まれているブラウザータブに切り替えます。
IoT 通知を選択します。
ビューを非アクティブな IoT 通知に切り替えます。
温度 80 度はしきい値の 70 を上回っていることを示す通知を開きます。
コマンド タブを選択します。デバイスに送信されたコマンドが表示されます。

続行