サンプル: XRM ツール API のクイック スタート
この C# .NET コード サンプルは、WPF ベースの XRM ツール ログイン コントロールを使用して Microsoft Dataverse 環境に接続する方法を示します。 次に、このサンプルでは、Dataverse テーブルで作成、更新、取得、削除の操作を行います。 XRM ツールの詳細については、「XRM ツールを使用して Windows のクライアント アプリケーションを作成」を参照してください。
要件
- Visual Studio 2019 またはそれ以降
- Dataverse テスト環境と有効なユーザー ログオン資格情報
サンプルを実行する方法
- PowerApps サンプル リポジトリを複製して、ローカル コピーを作成します。
dataverse\Xrm Tooling\Quick start for XRM Tooling\C#\QuickStartXRMToolingWPFClient.slnファイルを Visual Studio で開きます。- 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 プロジェクトのデバッグ フォルダーで使用できます。
- Login_ErrorLog.log: サインイン エラーを報告するため。 このファイルは、
関連項目
XRM ツール共通ログイン コントロールを使用する
XRM ツールを使用して Windows のクライアント アプリケーションを作成する
注意
ドキュメントの言語設定についてお聞かせください。 簡単な調査を行います。 (この調査は英語です)
この調査には約 7 分かかります。 個人データは収集されません (プライバシー ステートメント)。