サンプル: Upsert を使用してレコードを挿入または更新

このサンプル コードは、UpsertRequest メッセージを使用してレコードを挿入または更新する方法を示します。

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

1. ローカル コピーを作成できるように、 Microsoft/PowerApps-Samples リポジトリをダウンロードまたは複製します。
2. (省略可能)dataverse/App.config ファイルを編集して、接続先のMicrosoft Dataverse インスタンスを指定する接続文字列を定義します。
3. Visual Studioでサンプル ソリューションを開き、F5 を押してサンプルを実行します。 dataverse/App.config で接続文字列を指定すると、実行するすべてのサンプルでその接続情報が使用されます。

dataverse/App.config ファイルで接続文字列を指定しない場合は、サンプルを実行するたびにダイアログが開き、接続先の Dataverse インスタンスと使用する資格情報に関する情報を入力する必要があります。 このダイアログには以前の接続がキャッシュされているため、以前に使用した接続を選ぶことができます。

実行するために Dataverse インスタンスへの接続を必要とするこのリポジトリのサンプルには、 ファイルへのリンクされた参照が含まれています。

このサンプルの概要

メッセージは、レコードの更新または挿入を行う必要があるデータが含まれているシナリオで使用するためのものです。

このサンプルがどのように動作するか

このサンプルの概要で説明されているシナリオをシミュレートするために、サンプルは次のことを行います:

セットアップ

1. 組織の現在のバージョンをチェックします。
2. という名前の代替キーを持つ テーブルを作成する管理ソリューション (UpsertSample_1_0_0_0_managed.zip) をインポートします。 代替キーをサポートするインデックスが有効であることを確認します。

実演

1. メソッドは、 内のデータを処理して新しい製品を表し、新しく 13 レコードを作成します。
2. メソッドが二回目に呼び出されたとき、 ファイル内のデータを処理して、以前に作成した製品の変更を表します。
3. メソッドは、6 つの更新されたレコードを作成します。

クリーン アップ

セットアップ で作成されたマネージド ソリューションを削除するためのオプションを表示します。 サンプルによって作成されたテーブルとデータを調べる場合、削除はオプションです。 手動でレコードを削除することで同じ結果を得られます。