サンプル: XRM ツール API のクイック スタート

  • [アーティクル]

この C# .NET コード サンプルは、WPF ベースの XRM ツール ログイン コントロールを使用して Microsoft Dataverse 環境に接続する方法を示します。 次に、このサンプルでは、Dataverse テーブルで作成、更新、取得、削除の操作を行います。 XRM ツールの詳細については、「XRM ツールを使用して Windows のクライアント アプリケーションを作成」を参照してください。

要件

  • Visual Studio 2019 またはそれ以降
  • Dataverse テスト環境と有効なユーザー ログオン資格情報

サンプルを実行する方法

  1. PowerApps サンプル リポジトリを複製して、ローカル コピーを作成します。
  2. dataverse\Xrm Tooling\Quick start for XRM Tooling\C#\QuickStartXRMToolingWPFClient.sln ファイルを Visual Studio で開きます。
  3. F5 キーを押して、プログラムをコンパイルして実行します。

環境ログイン情報を入力するように求められます。

実際の動作

  • このサンプル コードは、共通ログイン コントロールに対して、認証と資格情報のキャッシュと再利用の組み込みのサポートを提供します。 の共通ログイン コントロールの詳細については、XRM ツール共通ログイン コントロールを使用するを参照してください。
  • Dataverse に接続後、このサンプルでは、取引先企業テーブルに対して、作成、更新、取得、および削除操作を行います。
  • サンプルが初めて実行されるとき、ユーザーの資格情報を c:\Users\<username>\AppData\Roaming\Microsoft\QuickStartXRMToolingWPFClient フォルダーの構成ファイル (Default_QuickStartXRMToolingWPFClient.exe.config) に保存し、その後、Dataverse にサインインするために、ユーザーが保存された資格情報を使用するか、新しい資格情報を使用するかを実行時に求めます。
  • 問題が発生した場合、トラブルシューティングを助けるために、次のログ ファイルを生成します。
    • Login_ErrorLog.log: サインイン エラーを報告するため。 このファイルは、C:\Users\<username>\AppData\Roaming\Microsoft\QuickStartXRMToolingWPFClient にあります。
    • QuickStartXRMToolingWPFClient.log: 操作エラーを報告するため。 このファイルは、実行可能ファイルと同じ場所の、自分の Visual Studio プロジェクトのデバッグ フォルダーで使用できます。

関連項目

XRM ツール共通ログイン コントロールを使用する
XRM ツールを使用して Windows のクライアント アプリケーションを作成する

注意

ドキュメントの言語設定についてお聞かせください。 簡単な調査を行います。 (この調査は英語です)

この調査には約 7 分かかります。 個人データは収集されません (プライバシー ステートメント)。