背景と応用シナリオ
Salesforceをご利用の多くの企業、特に金融、医療、公共セクターなど、厳しい規制やコンプライアンス要件を持つ業界では、データの変更履歴を長期間にわたって保持することが法的に義務付けられています。Salesforceが標準で提供するField History Tracking (項目履歴管理)は非常に強力な機能ですが、いくつかの制約があります。具体的には、データ保持期間が最大18ヶ月(API経由では24ヶ月)であり、追跡可能な項目数も1オブジェクトあたり20個までという制限があります。
これらの制約は、日常的な業務における短期的な変更追跡には十分ですが、5年、7年、あるいは10年といった長期的なデータ保持が求められる規制要件(例:米国のFINRAやSEC規制)を満たすことはできません。このような課題を解決するためにSalesforceが提供しているのが、Field Audit Trail (項目監査履歴)です。
Field Audit Trailは、標準の項目履歴管理機能を拡張し、定義したポリシーに基づいて履歴データを最大10年間、安全かつコスト効率よく保管するためのアドオン機能です。
主な応用シナリオ:
- 規制コンプライアンス: 金融商品取引法、医療保険の相互運用性と説明責任に関する法律 (HIPAA)、サーベンス・オクスリー法 (SOX法) など、特定の業界で求められる厳格なデータ保持要件への対応。
- 内部監査と不正調査: 誰が、いつ、どのデータを変更したのかを数年単位で遡って調査する必要がある場合。例えば、重要な契約金額や顧客の信用情報などの変更履歴を追跡し、内部統制を強化します。
- データガバナンス: 企業のデータガバナンスポリシーの一環として、重要データのライフサイクル全体を管理し、変更の透明性を確保します。
- 訴訟対応: 法的な紛争が発生した際に、証拠として過去のデータ変更履歴を正確に提出する必要があります。
本記事では、Salesforce 管理者の視点から、Field Audit Trailの仕組み、設定方法、データの参照方法、そして導入におけるベストプラクティスについて詳しく解説します。
原理説明
Field Audit Trailの仕組みを理解するためには、まず標準の項目履歴管理との違いを把握することが重要です。標準の項目履歴管理では、追跡対象の項目に変更が加わると、その履歴データは各オブジェクトのHistory関連リスト(例:AccountHistory, OpportunityFieldHistory)に保存されます。
Field Audit Trailは、この既存の仕組みを基盤として動作します。有効化すると、以下のプロセスが実行されます。
- 履歴保持ポリシー (History Retention Policy) の定義:
まず管理者は、オブジェクトごとに「オンライン保持期間」と「アーカイブ保持期間」を定義します。- オンライン保持期間: 履歴データが元のHistoryオブジェクト(例:AccountHistory)に保持される期間です。この期間内のデータは、レコードページの関連リストから直接確認できます。例えば、「1年」と設定します。
- アーカイブ保持期間: オンライン保持期間を過ぎたデータが、特別なストレージオブジェクトである `FieldHistoryArchive` に移動され、そこで保持される期間です。この期間は最大10年まで設定可能です。
- 非同期アーカイブ処理:
Salesforceは、定義されたポリシーに基づき、バックグラウンドで非同期に処理を実行します。オンライン保持期間を超えた古い履歴データは、元のHistoryオブジェクトから `FieldHistoryArchive` オブジェクトへと自動的に移動(コピー後に削除)されます。この処理はシステムリソースの状況に応じて実行されるため、即時ではありません。 - データへのアクセス:
`FieldHistoryArchive` に移動されたデータは、標準のUI(レコードページの関連リスト)からは表示されなくなります。これらのアーカイブ済みデータにアクセスするには、SOQL (Salesforce Object Query Language) を使用して `FieldHistoryArchive` オブジェクトを直接クエリするか、API経由でデータを抽出する必要があります。つまり、データの参照には技術的なスキルが必要となります。
この仕組みにより、頻繁にアクセスする必要がある最新の履歴データはUI上で手軽に確認できる状態を保ちつつ、長期保存が必要な古いデータは、パフォーマンスに影響を与えない別のストレージに効率的に保管することができるのです。
サンプルコード (SOQLクエリ)
前述の通り、アーカイブされた監査履歴データはUIから直接確認できません。そのため、Developer Console、Workbench、またはAPIクライアントツールを使用してSOQLクエリを実行する必要があります。以下に、特定のレコードに関する変更履歴を `FieldHistoryArchive` オブジェクトから取得するための具体的なSOQLクエリの例をいくつか示します。
これらのクエリは、Salesforceの公式ドキュメントで定義されている `FieldHistoryArchive` オブジェクトの標準フィールドに基づいています。
例1:特定の商談レコード (Opportunity) のすべてのアーカイブ済み変更履歴を取得する
このクエリは、指定した商談ID(`ParentId`)に関連するすべてのフィールド変更履歴を、変更日時が古い順に表示します。
/*
* 特定の商談レコードのアーカイブ済み履歴をすべて取得
* ParentId: 履歴の対象となるレコードのID
* FieldHistoryType: 変更が発生したオブジェクトのAPI参照名
*/
SELECT
CreatedDate,
FieldName,
OldValue,
NewValue,
CreatedBy.Name
FROM
FieldHistoryArchive
WHERE
ParentId = '0068d00000BU3hsAAD' AND FieldHistoryType = 'Opportunity'
ORDER BY
CreatedDate ASC
コードの解説:
- SELECT句: `CreatedDate` (変更日時)、`FieldName` (変更された項目のAPI参照名)、`OldValue` (変更前の値)、`NewValue` (変更後の値)、`CreatedBy.Name` (変更者の名前) を取得します。
- FROM句: データの取得元として `FieldHistoryArchive` オブジェクトを指定します。
- WHERE句: `ParentId` で特定の商談レコードIDを指定し、`FieldHistoryType` でオブジェクトが 'Opportunity' であることを明示します。これにより、他のオブジェクトの履歴と混同することを防ぎます。
- ORDER BY句: `CreatedDate` の昇順でソートし、時系列で変更を確認しやすくします。
例2:特定の取引先 (Account) の「年間売上 (AnnualRevenue)」項目に対する変更履歴のみを取得する
監査対応などで、特定の重要項目に対する変更履歴のみを抽出したい場合に有効なクエリです。
/*
* 特定の取引先レコードの特定項目のアーカイブ済み履歴を取得
* FieldName: 追跡したい項目のAPI参照名
*/
SELECT
CreatedDate,
OldValue,
NewValue,
CreatedBy.Name
FROM
FieldHistoryArchive
WHERE
ParentId = '0018d00000K9gVzAAJ'
AND FieldHistoryType = 'Account'
AND FieldName = 'AnnualRevenue'
ORDER BY
CreatedDate DESC
コードの解説:
- WHERE句: 前の例に加え、`FieldName = 'AnnualRevenue'` という条件を追加することで、「年間売上」項目に絞り込んでいます。
- ORDER BY句: `DESC` を指定することで、最新の変更から順に表示します。
注意事項
Field Audit Trailを導入・運用する際には、いくつかの重要な注意点があります。これらを事前に理解しておくことで、期待通りの成果を得て、予期せぬ問題を回避することができます。
ライセンスとコスト
Field Audit Trailは標準機能ではなく、有料のアドオンです。組織の要件と予算を照らし合わせ、導入の費用対効果を慎重に検討する必要があります。詳細はSalesforceの営業担当者にご確認ください。
権限設定
アーカイブされたデータへのアクセスには、特別な権限が必要です。
- ポリシーの設定: Field Audit Trailの履歴保持ポリシーを設定するには、「設定・定義を参照する」権限が必要です。通常はシステム管理者に付与されています。
- データのクエリ: `FieldHistoryArchive` オブジェクトをSOQLでクエリするには、「すべてのデータの参照」権限が必要です。この権限は非常に強力であるため、コンプライアンス担当者や監査担当者など、本当に必要なユーザーにのみ限定して付与すべきです。一般ユーザーにこの権限を与えることはセキュリティリスクを高めるため、避けるべきです。
サポート対象オブジェクトと項目
すべてのオブジェクトと項目タイプがField Audit Trailの対象となるわけではありません。
- サポート対象: ほとんどの標準オブジェクトおよびすべてのカスタムオブジェクトがサポートされています。
- サポート対象外: 積み上げ集計項目、数式項目、自動採番項目など、一部の項目タイプは追跡できません。また、一部の標準オブジェクト(例: QuoteLineItem)はサポート対象外の場合があります。導入前に、追跡したいオブジェクトと項目がサポートされているかを必ず公式ドキュメントで確認してください。
データアクセスの非即時性
アーカイブ処理は非同期で実行されるため、オンライン保持期間を過ぎたデータが即座に `FieldHistoryArchive` に移動するわけではありません。システムの負荷が低い時間帯にバッチ処理として実行されるため、タイムラグが発生します。また、クエリでデータを取得する必要があるため、監査などで急にデータが必要になった際に、すぐに対応できる体制(クエリを実行できる担当者や手順)を整えておくことが重要です。
データ量の考慮
長期間にわたって大量のフィールド変更を追跡すると、`FieldHistoryArchive` オブジェクトに格納されるデータ量は膨大になります。これにより、SOQLクエリのパフォーマンスが低下する可能性があります。クエリを実行する際は、`WHERE`句で `ParentId` や日付範囲を適切に指定し、対象データを絞り込む(セレクティビティを高める)ことが推奨されます。
まとめとベストプラクティス
Field Audit Trailは、Salesforceの標準機能では対応できない長期的なデータ保持とコンプライアンス要件を満たすための、極めて重要な機能です。これにより、企業は規制を遵守し、内部統制を強化し、データガバナンスを徹底することができます。
最後に、Field Audit Trailを最大限に活用するためのベストプラクティスをいくつか紹介します。
1. 明確なデータ保持ポリシーの策定
技術的な設定を行う前に、法務部門やコンプライアンス部門と連携し、どのオブジェクトのどの項目を、どれくらいの期間保持する必要があるのかを明確に定義します。無闇にすべての項目を追跡対象にすると、データ量が不必要に増大し、コスト増やパフォーマンス低下の原因となります。
2. 追跡対象の選択的適用
監査やコンプライアンスの観点から、本当に重要な項目(例:金額、ステータス、承認者、個人情報など)に絞って追跡を設定します。重要度の低い項目の履歴まで長期間保持する必要はありません。
3. アクセス権限の最小化
アーカイブデータにアクセスできる「すべてのデータの参照」権限は、必要最小限のユーザーにのみ付与します。データへのアクセス手順を文書化し、誰が、いつ、なぜデータにアクセスしたのかを記録するプロセスを設けることも推奨されます。
4. 定期的なデータ取得テスト
実際に監査が入る前に、定期的にSOQLクエリを実行してアーカイブデータが正しく取得できることをテストしておくことが重要です。これにより、いざという時に「データが取得できない」「クエリの書き方が分からない」といった事態を防ぐことができます。
5. ドキュメンテーションの徹底
なぜ特定の保持ポリシーが設定されたのか、その背景となる規制や社内ルールを文書として残しておきましょう。将来、担当者が変わった場合でも、設定の意図を正確に理解し、適切に運用を継続することができます。
以上の点を踏まえ、計画的にField Audit Trailを導入・運用することで、Salesforceをより安全で信頼性の高いプラットフォームとして活用することが可能になります。
コメント
コメントを投稿