テーブル定義の変更をクエリおよび検出する
このサンプルは、RetrieveMetadataChangeRequest メソッドを使ってテーブル定義の変更を取得および検出する方法を示しています。 サンプルは ここ からダウンロードできます。
注意
エンティティとテーブルの違いがわかりませんか？ Microsoft Dataverse で「開発者: 用語を理解する」を参照してください。
このサンプルを実行する方法
- サンプル リポジトリをダウンロードまたは複製して、ローカル コピーを用意します。
- (オプション) cds/App.config ファイルを編集して、接続先の Microsoft Dataverse インスタンスを指定した接続文字列を定義します。
- サンプル ソリューションを Visual Studio で開き、F5 キーを押してサンプルを実行します。 cds/App.config 内に接続文字列を指定した後、サンプルを実行すると、その接続情報が使用されます。
cds/App.config ファイル内に接続文字列を指定しない場合は、サンプルを実行するたびにダイアログが開き、接続先の Dataverse インスタンスについての情報と、使用する資格情報についての情報を入力する必要があります。 このダイアログには以前の接続がキャッシュされているため、以前に使用した接続を選ぶことができます。
このリポジトリにあるサンプルのうち、Dataverse インスタンスに接続する必要があるものには、cds/App.config ファイルを参照するリンクが含まれます。
このサンプルの概要
RetrieveMetadataChangeRequest メッセージは、指定の条件を満たすテーブル定義レコードのコレクションを取得するために必要なデータが含まれているシナリオで使用することを想定して設計されています。 RetrieveMetadataChangesResponse は、最後の要求後のテーブル定義変更内容に関する情報を戻すために、後からこの要求を使用することができるタイムスタンプ値を返します。
このサンプルがどのように動作するか
このサンプルがおこなうこと で説明されているシナリオをシミュレートするには、サンプルは次のことを行います。
セットアップ
組織の現在のバージョンをチェックします。
実際にやってみます
MetadataFilterExpressionメソッドはフィルター式を作成して、除外されたテーブルのリストにない、交差しないユーザー所有のテーブルに返されるテーブルを制限します。MetadataConditionExpressionメソッドは選択列を返します。MetadataPropertiesExpressionメソッドは、列に含まれるプロパティを制限します。LabelQueryExpressionメソッドは、返されるラベルをユーザーの優先する言語のラベルのみに制限します。RetrieveMetadataChangeRequestメソッドは、クエリのテーブル定義を取得します。
クリーンアップ
セットアップ で作成されたサンプル データを削除するためのオプションを表示します。 サンプルによって作成されたテーブルとデータを調べる場合、削除はオプションです。 手動でレコードを削除することで同じ結果を得られます。
注意
ドキュメントの言語設定についてお聞かせください。 簡単な調査を行います。 (この調査は英語です)
この調査には約 7 分かかります。 個人データは収集されません (プライバシー ステートメント)。
フィードバック
フィードバックの送信と表示