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

[アーティクル]
04/19/2023

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

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

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

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

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

このサンプルの概要

このサンプルでは、次のことを行います:

まだ有効になっていない場合は、組織とアカウントテーブルの監査を有効にします。
アカウントレコードを作成します。
RetrieveRecordChangeHistoryRequest クラス経由で RetrieveRecordChangeHistory メッセージを使用して、手順 2 で作成したアカウントレコードの履歴を取得します。
各監査レコードの詳細情報の一部を表示します。
アカウントレコードを更新し、特定の列を更新します。
RetrieveAttributeChangeHistoryRequest クラスで RetrieveAttributeChangeHistory メッセージを使用して、変更済み列の変更履歴を取得します。
属性変更履歴を表示します。
RetrieveAuditDetailsRequest クラス経由で RetrieveAuditDetails メッセージを使用して、監査の詳細の一部を表示します。
環境監査を元の状態に戻し、作成したアカウントレコードを削除します。

このサンプルの動作方法

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

設定

自社組織の現在のバージョンを確認してください。
必要に応じて、組織とアカウントテーブルの監査を有効にします。
サンプルの取引先企業レコードを作成します。

実際の動作

RetrieveRecordChangeHistory、RetrieveAttributeChangeHistory、RetrieveAuditDetails のメッセージを使用して、これらの監査 API で利用可能なデータの種類を示します。

クリーンアップ

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

注意

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

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