Web API 基本操作のサンプル (C#)

この .NET 6.0 サンプルでは、Dataverse Web API を使用して一般的なデータ演算を実行する方法を示します。

このサンプルでは、WebAPIService クラス ライブラリ (C#) の共通ヘルパー コードを使用します。

注意

この Dataverse 操作のサンプルの実装とコンソール出力は Web API 基本操作のサンプルで詳しく説明されています。また一般的な C# の構成の使用は Web API のサンプル (C#) で説明されています。

前提条件

これらははこのサンプルの構築および実行に必要となります。

  • Microsoft Visual Studio 2022。
  • データ演算を実行する権限を使用して Dataverse にアクセスします。

このサンプルを実行する方法

  1. PowerApps-サンプル リポジトリをクローンまたはダウンロードします。

  2. /dataverse/webapi/C#-NETx/BasicOperations/ フォルダーを見つけます。

  3. Visual Studio 2022 を使用して BasicOperations.sln ファイルを開きます

  4. appsettings.json ファイルを編集して、以下のプロパティ値を設定します:

    Property 方法
    Url ご使用の環境の Url。 プレースホルダー https://yourorg.api.crm.dynamics.com の値を環境の値に置き換えます。 開発者リソースを表示 を見て自分の環境の URL を見つけます。
    UserPrincipalName プレースホルダー you@yourorg.onmicrosoft.com の値を環境へのアクセスに使用する UPN の値に置き換えます。
    Password プレースホルダー yourPassword の値を使用するパスワードに置き換えます。
  5. appsettings.json ファイルを保存します

  6. F5 を押してサンプルを実行します。

コード

このサンプルのコードは次のとおりです: PowerApps-Samples/dataverse/webapi/C#-NETx/BasicOperations/Program.cs

実際の動作

このサンプルには 5 つのリージョンがあります。

セクション 1: 基本的な演算の作成および更新

演算:

  • 取引先担当者レコードを作成します。
  • 取引先担当者レコードを更新します。
  • 取引先担当者レコードを取得します。
  • 取引先担当者レコードの 1 つのプロパティを更新します。
  • 取引先担当者レコードの 1 つのプロパティを取得します。

セクション 2: 別のレコードに関連付けられたレコードの作成

演算: 新しいレコードを既存のレコードに関連付けます。

演算: 1 つの演算で次のエントリを作成します: アカウント、関連付けられた取引先責任者、その責任者のオープン タスク。 これらのエンティティ型には、次のリレーションシップ があります:

Accounts
    |---[Primary] Contact (N-to-1)
        |---Tasks (1-to-N)

セクション 4: エンティティの関連付けおよび関連付け解除

演算:

  • 取引先企業 contact_customer_accounts コレクションに取引先担当者を追加します。
  • 取引先企業 contact_customer_accounts コレクションから取引先担当者を削除します。
  • systemuserroles_association コレクションを使用してセキュリティ ロールをユーザーに関連付けます。
  • systemuserroles_association コレクションを使用してユーザーのセキュリティ ロールを削除します。

セクション 5: サンプル エンティティを削除

操作: このサンプルで作成された各レコードへの参照は、作成時にリストに追加されました。 このセクションでは、そのリストをループし、各レコードを削除します。

クリーンアップ

デフォルトでは、このサンプルでは作成されたすべてのレコードが削除されます。 サンプルの完了後に作成されたレコードを表示したい場合は、deleteCreatedRecords 変数を false に変更して、レコードを削除するかどうかを決定するプロンプトが表示されます。

参照

Dataverse Web API を使用する
WebAPIService クラス ライブラリ (C#)
Web API を使用してテーブル行を作成する
Web API を使用したテーブル行の更新と削除
WebAPI を使用してテーブル行を取得する
Web API のサンプル
Web API Operations 操作のサンプル
Web API クエリ データのサンプル (C#)
Web API 条件付き演算サンプル (C#)
Web API 機能およびアクションのサンプル (C#)
Web API テーブル スキーマ操作サンプル (C#)
Web API WebApiService の並列演算のサンプル (C#)
TPL データフロー コンポーネントを使用した Web API 並列演算のサンプル (C#)

注意

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

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