サンプル: テーブルのデータ変更を監査する

[アーティクル]
04/08/2022

このサンプルでは、テーブルとその列に対する監査の有効化/無効化、監査対象テーブルのデータ変更履歴の取得、監査レコードの削除を行います。サンプルはここからダウンロードできます。

注意

エンティティとテーブルの違いがわかりませんか？ Microsoft Dataverse で「開発者: 用語を理解する」を参照してください。

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

サンプルリポジトリをダウンロードまたは複製して、ローカルコピーを用意します。
(オプション) cds/App.config ファイルを編集して、接続先の Microsoft Dataverse インスタンスを指定した接続文字列を定義します。
サンプルソリューションを Visual Studio で開き、F5 キーを押してサンプルを実行します。 cds/App.config 内に接続文字列を指定した後、サンプルを実行すると、その接続情報が使用されます。

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

このリポジトリにあるサンプルのうち、Dataverse インスタンスに接続する必要があるものには、cds/App.config ファイルを参照するリンクが含まれます。

このサンプルの概要

RetrieveRecordChangeHistoryRequest メッセージは、テーブルの監査履歴を取得するために必要なデータが含まれているシナリオで使用することを想定して設計されています。

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

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

セットアップ

組織の現在のバージョンをチェックします。
サンプルのアカウントテーブルを作成します。

実際にやってみます

システムユーザーレコードからの組織の ID を取得します。
組織とサンプルのアカウントテーブルの監査を有効にします。
RetrieveRecordChangeHistoryRequest は、アカウントテーブルの監査履歴を取得し、その結果を表示します。

クリーンアップ

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

注意

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

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