項目履歴管理

一般的な考慮事項

項目履歴管理を使用するときは、次の一般的な点を考慮してください。

• Salesforce は、項目履歴の追跡を、項目で有効化された日時から開始します。Salesforce では、この日時より前の変更は除外され、[履歴] 関連リストにエントリは作成されません。
• データローダーまたはqueryAll() APIを使用して、18~24か月経過した項目履歴を取得します。
• ロングテキスト項目 (255 文字を超える項目) を変更すると、Salesforce は項目が編集されたことと変更が行われたことのみを記録しますが、項目の実際の前後の値は保存または表示しません。
• 項目履歴管理のタイムスタンプは、秒単位で正確です。つまり、2 人のユーザーが同じ秒内で同じレコードの同じ追跡項目を更新すると、両方の更新のタイムスタンプは同じになります。Salesforce では、データベースに対するこれらの変更の確定順序は保証できません。その結果、表示値の順序が不適当になる可能性があります。
• 標準オブジェクトまたはカスタムオブジェクトでレコードタイプを作成し、同じメタデータ API リリースでそのレコードタイプの項目履歴管理を有効にすることはできません。代わりに、1 つのリリースでレコードタイプを作成し、別のリリースでそのレコードタイプの履歴管理を有効にします。
• Salesforce では、{StandardObjectName}History オブジェクトまたは {CustomObjectName}__History オブジェクトで最近参照または参照された機能は有効化されません。そのため、これらの履歴オブジェクトの SOQL クエリで FOR VIEW または FOR REFERENCE 句を使用することはできません。たとえば、次の SOQL クエリは無効です。

  SELECT AccountId, Field FROM AccountHistory LIMIT 1 FOR VIEW

• [取引先責任者名] 項目は、[敬称] 項目を含む複数列項目です。[取引先責任者名] 項目で項目履歴管理が有効になっていて、[敬称] 項目が変更された場合、[取引先責任者名] 項目の選択リスト値の翻訳は [元の値] または [新しい値] 列に適用されません。
• Lightning Experience では、数値フィールドの [履歴] 関連リストで小数が 1000 桁目に丸められます。Salesforce Classic では、同じ [履歴] 関連リストに小数点以下のすべての値が表示されます。
• User オブジェクトの項目履歴管理を有効にすると、メタデータ API を使用して標準項目 (対象) を使用できるようになります。

その他の Salesforce 機能とのインタラクション

• Lightning では、[作成日] 項目と [ID] 項目の順序の差を表示できます。Salesforce は引き続き、追跡されたすべての変更をコミットして監査ログに記録します。ただし、これらの変更がデータベースで実行される正確な時刻は大幅に変わる可能性があり、Salesforce が同じミリ秒以内に行われることを保証するものではありません。たとえば、項目でコミット時間を増やすトリガーまたは更新があり、時間に差が生まれる可能性があります。その期間中、Salesforce では ID は昇順で作成されますが、同じ理由により、やはり差が生まれる可能性があります。
• プロセスビルダー、Apex トリガー、またはフローによって、現在のユーザーに編集権限がないオブジェクトが変更された場合、Salesforce はその変更を追跡しません。項目履歴では、現在のユーザーの権限が優先され、システムコンテキストで発生した変更は記録されません。
• Salesforce は、特定の変更がデータベースに保存されない場合でも、履歴が管理されている項目について、すべての変更の追跡を試みます。たとえば、管理者が、Postal Code 項目の値 12345 を 94619 に変更するオブジェクトに Apex トリガーを定義したとします。ユーザーがオブジェクトにレコードを追加し、Postal Code 項目に「12345」を設定した場合、Apex トリガーによって、データベースに保存される実際の Postal Code の値は 94619 になります。最終的には 1 つの値しかデータベースに保存されませんが、Zip Code 項目の追跡履歴には 2 つの新しいエントリが追加されます。
  • No value ~ 12345 (ユーザーが新しいレコードを挿入したときに行った変更)
  • 12345 ~ 94619(Apex トリガーによる変更)

行動および ToDo の履歴の考慮事項

• 履歴に変更が反映されるまで、最大で数分かかる場合があります。
• 行動または ToDo の項目をオブジェクトごとに 6 つまで追跡できます。
• 項目履歴管理は、標準の行動項目と ToDo 項目でのみ使用できます。行動または ToDo のカスタム項目では使用できません。
• 活動を削除した後、活動の履歴は API クエリによって最大で数日間表示できます。履歴は活動から非同期で削除されるため、引き続き使用できます。
• Salesforce では、定期的な行動と子行動に対するすべての変更は追跡されません。
• 特定の項目履歴レコードを削除することはできません。
• 項目履歴管理を有効にすると、Bulk API のトランザクションや行動の同期などの一括処理が遅延することがあります。プロセスが遅延する場合は、活動項目の履歴管理をオフにすることを検討してください。
• 活動履歴が更新されると、Salesforce によって活動の親レコードがロックされます。たとえば、ある活動が何千もの取引先にリンクしている場合、履歴が更新される間、それぞれの取引先がロックされてしまいます。ベストプラクティスとして、データのスキューを防止してください。親子の行のロックによってプロセスが失敗する場合、活動項目の履歴管理をオフにすることを検討してください。
• Salesforce は、プロセスビルダー、Apex トリガー、またはフローによって発生した項目値の変更を活動の履歴で追跡します。項目レベルセキュリティ設定で許可されている場合のみ、ユーザーに変更が表示されます。他のオブジェクトの場合、プロセス、トリガー、およびフローからの項目の変更は、現在のユーザーに変更された項目への編集権限がある場合にのみ追跡されます。
• 追跡に使用される項目の暗号化を解除すると、その項目が暗号化されている間に追跡された値は表示されません。Salesforce は、暗号化されていない項目値を履歴で追跡します。
• API で活動履歴を利用できるのは、全データの変更権限を持つ管理者のみです。
• 活動履歴では Salesforce ID はサポートされません。 ID フィールドは、引き続き [説明] および [選択] コールの値 000000000000000AAAで使用できます。
• 活動の項目履歴は、関連リストに似た Lightning コンポーネントで表示されます。ページレイアウトで履歴を管理するのではなく、Lightning ページに行動や ToDo のレコードの活動レコード履歴コンポーネントを配置します。活動レコード履歴コンポーネントは、行動および ToDo のカスタムページに追加したり、デフォルトページから削除したりできます。履歴リストは、オブジェクトマネージャーで項目履歴管理を有効にするまで空のままです。
• 項目履歴管理では、通貨やパーセントデータ型など、小数部の値を表示する項目はサポートされていません。
• 履歴リストは、Salesforce Classic またはモバイルアプリケーションでは使用できません。
• 組織では、1 日あたり最大 60,000 件の ToDo および行動項目履歴トランザクションを追跡できます。組織で 1 日あたり 80,000 件を超える項目履歴トランザクションがある場合、今後の変更履歴の遅延や損失を防ぐために、項目履歴管理を使用しないことをお勧めします。

取引先責任者履歴に関する考慮事項

• リードを新規または既存の取引先責任者に変換すると、取引先責任者の [履歴] 関連リストに contactCreatedFromLead または contactUpdatedByLead 項目が表示されます。取引先責任者履歴にこれらの項目がある場合、取引先責任者がリードから作成または更新されたことを示します。項目値は常に空になります。

翻訳とロケールに関する考慮事項

• Salesforce では、追跡項目値は翻訳されず、入力された言語で表示されます。たとえば、項目を Green から Verde に変更した場合、トランスレーションワークベンチを使用して項目値を他の言語に翻訳しない限り、ユーザーの言語に関係なく Verde が表示されます。この動作は、レコードタイプおよび選択リスト値にも適用されます。
• [履歴] 関連リストを参照するユーザーのロケールでトランスレーションワークベンチを使用して翻訳したカスタム項目の表示ラベルへの変更が表示されます。たとえば、カスタム項目ラベルが Red で、スペイン語では Rojo と翻訳されている場合、スペインロケールのユーザーにはそのカスタム項目ラベルが Rojo と表示されます。それ以外のユーザーには、そのカスタム項目ラベルが Red と表示されます。
• 日付項目、数値項目、および標準項目に対する変更は、[履歴] 関連リストを参照しているユーザーのロケールに合わせて表示されます。たとえば、日付を 2012 年 8 月 5 日に変更すると、英語 (アメリカ) ロケールのユーザーには 8/5/2012 と表示され、英語 (イギリス) ロケールのユーザーには 5/8/2012 と表示されます。

ユーザーに関する考慮事項 (ベータ)

メモ ユーザー項目履歴管理は、パイロットまたはベータサービスであり、お客様が実行した場合は Agreements - Salesforce.com のベータサービス規約、書面で締結した場合は統合パイロット契約、および製品規約ディレクトリの適用条件が適用されます。このパイロットサービスまたはベータサービスは、お客様ご自身の裁量でご利用ください。

• 項目履歴管理は、内部ユーザーに対してのみ有効になっています。
• [ユーザー項目履歴管理 (ベータ)] 設定を有効にしてから無効にすると、有効化中に加えられた変更は記録されます。組織設定を再度有効にすると、以前に追跡対象として選択されていた項目は選択されたままになります。
• 次の項目は追跡に使用できます。最大 20 個の項目を選択できます。
  • 名前
  • 別名
  • 会社名
  • ディビジョン
  • Department
  • タイトル
  • 住所
  • 電話
  • 内線
  • 時間
  • 地域
  • 言語
  • 携帯電話
  • 開始日
  • 終了日
  • メール
  • マネージャー
  • 取引先責任者
  • 有効
  • プロファイル
  • ロール
  • ユーザー名
  • 代理承認者
• [ロール] 設定ページでロールを割り当てても、変更は追跡されません。ユーザーを直接編集してロールを更新すると、ロールの変更が追跡されます。
• 自動採番、数式、リッチテキストエリア、ロングテキストエリアデータ型のカスタム項目は追跡されません。
• [メール] 項目は、検証後にのみ追跡できます。
• [項目] 列では完全一致検索がサポートされています。[ユーザー] 列では、入力したテキストで始まる結果を返す前方一致検索がサポートされています。
• ユーザー項目履歴管理を有効にしたら、ユーザーのアクセス概要ページで追跡データを表示します。