Web API 条件付き演算サンプル (C#)

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

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

前提条件

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

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

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

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

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

3. Visual Studio 2022 を使用して ConditionalOperations.sln ファイルを開く

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

   プロパティ	手順
   Url	ご使用の環境のURL。 プレースホルダー の値を環境の値に置き換えます。 開発者リソースを表示 を見て自分の環境の URL を見つけます。
   UserPrincipalName	プレースホルダー の値を環境へのアクセスに使用する UPN の値に置き換えます。
   Password	プレースホルダーの値を使用しているパスワードに置き換えてください。

5. ファイルを保存します

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

Code

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

表示する

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

セクション 0: サンプル レコードを作成する

演算:

• 単一のアカウントレコードを作成します。
• レコードを取得し、ETag 値を として保存します。

セクション 1: 条件 GET

演算:

1. 特定の値を持つヘッダーを設定してレコードを取得しようとしています。

   要求は予想通りに失敗します。

2. レコード 列の値を更新します。

3. ヘッダーを 値に設定したレコードの再取得を試行します。

   初期のE Tag 値が一致しないため、リクエストは成功します。

4. 新しい ETag 値を として保存します。

セクション 2: 削除および更新でのオプティミスティック同時実行

演算:

1. 元のアカウント設定を削除する試みとして、ヘッダーに値を設定します。

   予想通りリクエストは失敗します。

2. 元のアカウントの設定を試行し、ヘッダーを値に設定して更新します。

   要求は期待通りに失敗します。

3. 元のアカウントの設定を、値とするヘッダーを利用して更新を試みます。

   ETag 値がレコードの現在の値と一致するため、リクエストは成功します。

セクション 3: サンプル レコードを削除する

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

クリーンアップ

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

参照

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