デバイスの読み取り値のビジュアル化
重要
Azure Active Directory は Microsoft Entra ID に名前が変更されます。 ユーザーからの操作は必要ありません。 詳細については、Azure Active Directory の新しい名前 を参照してください。
デバイスの現在の状態、修理履歴、実行された作業指示書の効果をわかりやすく伝えるために、Connected Customer Service アドインはほぼリアルタイムでデバイスの読み取り値とセンサーの履歴測定値を作業指示書の詳細とともにグラフで表示します。
デバイス測定値グラフは、IoT 通知、作業指示書、サポート案件、デバイス、資産フォームで利用できます。
デバイスの読み取り値グラフを有効にするには、管理者が組織の Azure IoT Hub で Connected Customer Service を展開またはアップグレードするときに、Azure Time Series (プレビュー) を Azure サブスクリプションに展開する必要があります。 管理者は IoT 展開アプリを介して展開を行います。
前提条件
- 顧客サービス バージョン 9.0.20034.20XX またはそれ以降
- 現在、米国英語でのみ利用可能です。 この機能は プレビュー 中のため、すべての言語と地域で利用できません。
デバイスの読み取り値グラフを有効化
- Connected Customer Service IoT 展開アプリ を開きます。
- IoT ソリューションを展開する Dynamics 365 組織を選択します。
- Azure サブスクリプションと Azure リソース グループを選択します。 (メモ: IoT Hub 展開用に既存の Connected Customer Service を更新する場合は 展開をアップグレード を選択します。)
- Time Series Insight プレビューの展開 チェック ボックスを選択します。
- 展開 を選択します。
- IoT 展開アプリの残りの手順に従って Time Series Insights プレビューの展開を完了します。
- アプリケーション (クライアント) ID の作成: Microsoft Entra IDアプリケーションの作成 の手順に従ってください。
- クライアント シークレットの作成: 新しいアプリケーション シークレットの作成 の手順に従います。
Note
- ストレージ アカウントの選択は既存の展開をアップグレードする場合にのみ使用できます。
- IoT 展開アプリは timeseriesinsightsconsumergroup を IoT Hub のコンシューマー グループに追加します。
- 展開した後、デバイスの読み取り値 (プレビュー) タブが IoT 通知、作業指示書、サポート案件、デバイス、資産フォームに表示されます。
デバイスの読み取り値グラフの使用
デバイス読み取り値を表示するために次のデータの準備が必要です。
| Form | 必須データ |
|---|---|
| 機器 | 空ではない デバイス ID。 |
| 作業指示書 | 作業指示書に関連する IoT 通知があり、IoT 通知に関連する IoT デバイスがあります。 空でない IoT デバイスのデバイス ID。 |
| Case | サポート案件に関連する IoT 通知があり、IoT 通知に関連する IoT デバイスがあります。 空でない IoT デバイスのデバイス ID。 |
| 資産 | 空ではない デバイス ID。 デバイス読み取り値グラフは資産フォームの [接続されたデバイス属性] セクションに設定されたデバイス ID のものです。 |
| IoT 通知 | 通知に関連する IoT デバイスがあります。 空でない IoT デバイスのデバイス ID。 |
- IoT 通知、作業指示書、サポート案件、デバイス、資産フォームで デバイスの読み取り値 (プレビュー) タブを開きます。
ドロップダウン リストから期間を選択します。 デバイスが TSI にデバイス測定値を送信し、選択された期間のデバイス測定値データが存在する場合、グラフが読み込まれます。
測定値の横にある目のアイコンを選択して、グラフで測定値を表示または非表示にします。
グラフにカーソルを合わせると、測定値の詳細が記載されたツールヒントが表示されます。
- アイコンを選択して、サービス履歴の詳細を表示します。
- サービス ヒストリー の横にある目のアイコンを選択して、選択した期間中に作成および終了したサポート案件を表示または非表示にします。
Note
選択した期間に作業指示書がない場合、作業指示書の選択は表示されません。
エラー コード
次の表を使用して、デバイスの読み取りに関連するエラー コードのトラブルシューティングを行います。
| エラー コード | 考えられる根本理由 | 推奨される修正措置 |
|---|---|---|
| 5000101 | ローカルの構成ストアは利用できません | Microsoft サポートに連絡して調査を依頼してください |
| 4001002 | ユーザー定義アクション msdyn_IoTHubQueryDeviceReadings に渡された検索スパン パラメーターの値は Null です | すべての必須の引数の有効な値がユーザー定義アクション msdyn_IoTHubQueryDeviceReadings に渡されることを確認してください |
| 4000103 | ユーザー定義アクション msdyn_IoTHubQueryDeviceReadingsに渡された From または To 日付引数の値は、有効な DateTime ではありません | すべての必須の引数の有効な値がユーザー定義アクション msdyn_IoTHubQueryDeviceReadings に渡されることを確認してください |
| 4000104 | ユーザー定義アクション msdyn_IoTHubQueryDeviceReadings に渡された間隔引数の値は、有効な Duration ではありません | すべての必須の引数の有効な値がユーザー定義アクション msdyn_IoTHubQueryDeviceReadings に渡されることを確認してください。 間隔については、フォーマットは ISO 8601 期間フォーマットにある必要があります。 例: PT1H |
| 4000201 | ユーザー定義アクション msdyn_IoTHubQueryDeviceReadings に渡された IotDeviceId 引数の値は、有効な Guid ではありません | すべての必須の引数の有効な値がユーザー定義アクション msdyn_IoTHubQueryDeviceReadings に渡されることを確認してください。 IotDeviceId については、値はグローバル一意識別子 (GUID) の msdyn_iotdeviceid である必要があります。 |
| 4010202 | ユーザーには、デバイス エンティティ (msdyn_iotdevice) をクエリする権限がありません | ユーザーがデバイス エンティティ (msdyn_iotdevice) をクエリできることを確認してください |
| 5000203 | デバイス エンティティ (msdyn_iotdevice) で指定された msdyn_iotdeviceid の msdyn_DeviceId を取得できません | デバイスの属性 msdyn_DeviceId が設定されていることを確認してください |
| 5000204 | 指定された msdyn_iotdeviceid の Time Series Insights URL を取得できません | CFS 展開アプリがこの CRM 組織の Time Series Insights を展開し、デバイスが正しい IoT プロバイダーにリンクされていることを確認してください |
| 5000205 | TSI 認証のための Microsoft Entra ID トークンの取得に使用されたクライアント ID が無効、または GUID (グローバル一意識別子) が空 | CFS 展開アプリの実行時に有効なクライアント ID が提供されていることを確認してください |
| 5000206 | TSI 認証用の Microsoft Entra ID トークンの取得に使用したクライアント シークレットの有効期限が切れています | Microsoft Entra ID のクライアントシークレットを更新し、新しいクライアント ID とクライアント シークレットを更新するために CFS 展開アプリを再実行します |
| 5000207 | Time Series Insights をクエリするためのアクセス トークンが取得できません | 要求を再試行し、問題が続く場合は、CFS 展開アプリを再び実行して新しいクライアント ID とクライアント シークレットを更新してみてください |
| 5000603 | Time Series Insights API への要求が失敗して返されました | 要求を再試行してください。 問題が続く場合は、Microsoft サポートに連絡して調査を依頼してください |
| 5000604 | Time Series Insights API からの応答が予期した形式ではありません | 要求を再試行してください。 問題が続く場合は、Microsoft サポートに連絡して調査を依頼してください |
追加メモ
- 米国英語 (en-US) でのみ利用可能です。
-
既知の問題:
- カスタム時間設定では、別のタイム ゾーンが選択された場合でもタイム ゾーンが常に UTC に設定されます。 設定の適用後に表示される期間は常に現地時間です。
- IoT 展開アプリで新しいアプリケーション (クライアント) ID を作成した直後にデプロイすると 資格情報で TSI を展開できません エラーが表示される場合があります。 1 分後にやり直してください。
- Azure Time Series Insights (プレビュー) は従量課金 (PAYG) 料金モデルを使用します。 https://azure.microsoft.com/pricing/details/time-series-insights から価格と費用の見積もり計算機をご利用頂けます。 TSI の展開を計画している地域を選択して、ストレージとクエリのコストを理解します。 (TSI は Azure BLOB を使用してデータを保存します。)