監査済みデータの変更履歴の取得と削除

[アーティクル]
05/09/2023

監査を有効にし、監査対象のエンティティや属性へのデータ変更を行った後、データ変更履歴の取得に進むことができます。変更履歴の参照後にオプションで監査レコードを削除することもできます。詳細については、このトピックの最後にあるサンプルコードリンクを参照してください。

変更履歴の取得

変更履歴の取得にはいくつかのメッセージ要求を使用できます。これらの要求は取得内容で区別されます。

これらの変更履歴メッセージ要求を使ったサンプルコードについては、このトピックの最後にあるサンプルリンクを参照してください。

レコードの変更履歴の削除

DeleteRecordChangeHistoryRequest メッセージを使用して、特定のレコードの監査変更履歴レコードすべてを削除します。これにより、日付範囲の監査レコードすべてを削除する代わりに、レコードの監査変更履歴を削除することができます。日付範囲の監査レコードの変更は次のセクションで扱われます。レコードの監査変更履歴を削除するには、prvDeleteRecordChangeHistory 特権を含むセキュリティロールを保持するか、システム管理者である必要があります。

日付範囲の変更履歴の削除

日付範囲のauditレコードを削除するには、DeleteAuditDataRequest 要求を使用します。監査データレコードは古いものから新しいものへと順に削除されます。この要求の機能は、現在の Dynamics 365 Customer Engagement (on-premises) サーバーで使われている SQL Server のエディションによって若干異なります。 Dynamics 365 for Customer Engagement では、Enterprise Edition の SQL Server が使われます。

現在の Dynamics 365 Customer Engagement (on-premises) サーバーで使われている SQL Server が Standard Edition の場合、データベース分割機能がサポートされていないので、DeleteAuditDataRequest 要求は、EndDate プロパティが示す最終日までに作成されたすべての監査レコードを削除します。

Dynamics 365 Customer Engagement (on-premises) サーバーで使われている SQL Server が分割サポートなしの Enterprise Edition の場合、DeleteAuditDataRequest 要求は、終了日が EndDate プロパティの日付よりも前のパーティションに含まれているすべての監査データを削除します。空のパーティションがあれば、それも削除します。ただし、現在の (アクティブな) パーティションと、アクティブパーティション内のauditレコードを、この要求やその他の要求で削除することはできません。

新しいパーティションは、毎年四半期ごとに Dynamics 365 Customer Engagement (on-premises) プラットフォームが自動的に作成します。この機能は構成も変更もできません。パーティションの一覧を取得するには、RetrieveAuditPartitionListRequest 要求を使います。パーティションの終了日が現在の日付よりも後の場合、そのパーティションやパーティション内のauditレコードを削除することはできません。

監査済みデータの変更履歴の取得と削除

変更履歴の取得

レコードの変更履歴の削除

日付範囲の変更履歴の削除

関連項目

その他のリソース