次の方法で共有


データ インテグレーターのエラー管理とトラブルシューティング

データ インテグレーターは、複数のソース (財務と運用アプリ、Dynamics 365 Sales、Salesforce、Microsoft SQL (プレビュー) など) からのデータを Microsoft Dataverse に統合するのに使用されるポイントツーポイント統合サービスです。 また、財務と運用アプリと Dynamics 365 Sales へのデータの統合もサポートされます。 Dataverse にデータを統合する トピックでは、見込み顧客の現金化、Field Service、および Project Service の統合のような、プロセスに基づく統合シナリオのプロジェクトをセットアップする詳細な手順を説明します。

お客様からのフィードバックに基づいて、常に進歩し、プラットフォームを修正して向上させておりますが、問題が発生した場合はガイダンスを提供していただく必要があります。 このトピックでは、エラー管理やいくつかの問題のトラブルシューティングについて説明します。

サポートされているリージョン

データ インテグレーターは、次のリージョンでサポートされています:

  • アジア
  • オーストラリア
  • カナダ
  • 欧州
  • インド
  • 日本
  • 南アメリカ
  • 英国
  • アメリカ合衆国

他のリージョンでデータ インテグレーターを有効にする予定はありません。

プロジェクト実行の正常性を表示

データ統合プロジェクトが (手動で、またはスケジュール化して) 実行されるたびに、管理ダッシュボードまたはプロジェクト一覧ページ、あるいはその両方で実行ステータスを表示できます。

ダッシュボードとプロジェクト一覧。

管理ダッシュボードには、すべてのプロジェクトの実行およびその実行の詳細をドリル ダウンして表示するステータスを、すべてがそろったリアルタイムで表示されます。 ダッシュボードには、個々の実行数、および要約した実行数が表示されます。 各プロジェクトのステータスが次の色分けで表示されます。完了したプロジェクトは緑色、警告付きで完了したプロジェクトは黄色、エラー ステータスのプロジェクトは赤色。 同様にプロジェクト一覧ページでは、緑色、黄色、赤色のアイコンでプロジェクトのステータスを表示します。

詳細な情報をさらに確認するため、管理ダッシュボードで個々の棒グラフを選択して、プロジェクト実行についての詳細を表示することができます。

詳細を表示するために使用できるダッシュボードのドリルダウン オプションのスクリーンショット。

ここで個々のエラーについて、情報の詳細を確認できます。

[最近のプロジェクトの実行] ページに表示される個々のエラーのスクリーンショット。

また、プロジェクト一覧ページで個々のプロジェクトを選択し、実行履歴タブで実行履歴やステータスを表示して、プロジェクト実行の詳細を確認することもできます。

プロジェクト実行履歴。

警告またはエラーが発生した場合は、実行履歴タブで実行をクリックしてさらにドリルダウンできます。

プロジェクト実行履歴の警告。

プロジェクトの監視

警告またはエラー付きで完了したプロジェクトの実行に関するメール アラートを受け取ることができるように、お客様とパートナーが電子メール通知を登録することを強くお勧めします。 スケジュール タブで、プロジェクトごとに電子メール通知を選択し、複数の電子メール アドレス (グループ アドレスを含む) をコンマで区切って指定できます。

リモート監視の警告。

プロジェクトが警告付きで完了するか、またはエラー状態になるたびに、特定の失敗へのドリルスルー リンクを含むプロジェクト実行のステータスを示す電子メール通知を受信できます。

リモート監視の電子メール通知。

リンクを選択すると、プロジェクトの実行ステータスに直接アクセスし、特定のエラーをさらに掘り下げることができます。

リモートの監視の電子メール通知ドリル ダウン。

プロジェクト実行のステータス

データ統合プロジェクトが (手動またはスケジュールで) 実行される時、プロジェクト名、最新の更新を示すタイム スタンプ、およびプロジェクト ステータスを含む詳細ログを作成します。

各プロジェクトの実行には、完了、警告、またはエラー ステータスが付いています。

  • 完了

    すべてのレコードが正常にアップされた状態。 (「アップサート」または「更新挿入」は、すでにレコードが存在する場合には更新するか、または新しいレコードを挿入するロジックです。)

    プロジェクト ステータスの完了。

  • 警告

    一部のレコードが正常にアップされ、一部のレコードが失敗またはエラーになった状態。

    プロジェクト ステータスの警告。

  • エラー

    どのレコードも成功しないか、またはエラーが発生した、あるいはその両方が生じ、宛先にアップサートや挿入がなかった状態。

    プロジェクト ステータスのエラー。

    プロジェクトの実行がエラー ステータスの場合は、次回のスケジュールされた実行で自動的に再試行します。 ソース レコードを更新しない場合、次の実行に自動的に含まれることはありません。

実行履歴ページで、省略記号 (...) をクリックして、再実行を選択することにより、手動で再試行することもできます。

一般的なシナリオのトラブルシューティングに関する簡単なヒント

一般的なシナリオのトラブルシューティングに役立つ簡単なヒントを次に示します。

接続または環境の問題

接続セットの作成中に、ドロップダウンで接続または環境が表示できない場合は、問題のトラブルシューティングに必要な操作を次に示します。

つながりセット。

  • 接続: https://make.powerapps.com のデータ/接続の下に接続を作成しており、接続済みの状態になっていることを確認します。 接続の修正通知が表示された場合は、アカウントに使用されている資格情報を再確認し、省略記号 (...) からアカウントを切り替えオプションを使用して、再認証します。

    接続の問題。

  • 環境: ドロップダウンに環境が表示されない場合は、接続の作成に使用したアカウントがエンティティへの適切なアクセス権を持っていることを確認します。 これをテストする良い方法は、フローを作成することです (Microsoft Power Automate を使用)。

    財務と運用アプリへの接続をテストするための簡単なフローを作成する例を次に示します:

    1. https://make.powerapps.com からビジネス ロジック/フロー の下に (最初から作成を選択して) 新しいフローを作成します。

      接続の新しいフロー。

    2. 繰り返し トリガーを選択します。 新しいステップ の下で、Dynamics 365 財務と運用アプリ コネクタ を検索して選択します。

      接続の繰り返しトリガー。

    3. アクションとして レコードを作成 を選択します。 ドロップダウンで、適切なアカウントでログインしていることを確認します。 これはデータ統合プロジェクトの接続を作成するために使用するのと同じアカウントです。

      接続は、レコードを作成します。

    4. 環境 下のドロップダウンを選択して、すべての財務および運用アプリ環境を表示します。 これは、(その前の手順で使われた) アカウントが環境にアクセスしているかどうかを確認する良い手順です。

      接続環境。

    5. 環境を選択したなら、その下にあるすべてのエンティティにアクセスできることを確認します。

      接続は、エンティティへのアクセスを確認します。

  • 組織: 財務と運用アプリの法人 (USMF など)、Dynamics 365 Sales の部署、または Dataverse 組織名を指定する場所です。 この手順を抜かした場合、アプリケーションに対応する有効な名前を含むメッセージが表示され、組織でプラグ インする必要があります。

プロジェクト検証エラー

最初に、データ統合プロジェクトを検証し、それから実行します。 検証エラーの主な理由には次のようなものがあります。

  • プロジェクトの作成時に選択された会社/部署の誤り
  • 必須の列が不足
  • マッピングが不完全、または重複
  • フィールド タイプが不一致

次の例は、重複するマッピングの場合、エラーがどのように現れるかを示します。 オレンジ色のバナーはマッピングの問題を示します。

マッピングの問題。

プロジェクト実行履歴をさらに詳しく調べると、重複するフィールドの問題があることがわかります。

重複するフィールドの問題。

マッピングを調べると、重複している部分を識別できます。 このケースでは、ソース フィールドである FAX が ADDRESSCITY に不適切にマッピングされています。

不適切なマッピング。

マッピングを修正すると、エラーが消えて、プロジェクトを正常に実行できるようになります。

修正済みマッピング。

プロジェクト実行の問題

プロジェクトの実行が警告を表示して完了した、またはエラー状態にあることが通知された場合、最初に行うことは、実行履歴を調べることです。 プロジェクト一覧ページから、個々のプロジェクトを選択し、実行履歴タブで最後の実行を確認します。その後、特定のエラーをクリックできます。

トラブルシューティング エラー。

これが財務と運用アプリがソースとなる統合プロジェクトである場合は、財務と運用アプリのデータ管理ワークスペースに移動します。 次に、データ統合プロジェクト名に基づいてプロジェクトをフィルター処理するか、インポート ジョブまたはエクスポート ジョブの種類を選択します。

データ管理のワークスペース。

さらに、プロジェクトのジョブ履歴を開き、実行のタイム スタンプに基づいてジョブ ID から詳細を確認できます。 また、実行ログを検査したり、実行履歴を表示したり、ステージング データを表示したりすることもできます。

プロジェクト ジョブ履歴。