Salesforce System ModStampとは？その機能と特徴についてご紹介

Salesforce System ModStampとは？

Salesforce System ModStampとは、Salesforceで扱われるレコード更新日を記録する標準のシステム項目のことです。オブジェクトにおける参照項目は、API操作時に自動的に更新されます。 System ModStampは、ユーザーによるもの、または、あるきっかけで起こる自動的なプロセスによって、最終更新された日時を表します。 （この場合のプロセスとは、Apexによるものではなく、標準機能を実装するために実行するSalesforceコードによるプロセスのことです） また、System ModStampの特徴として、データをSalesforceにインポートして参照元システムの監査項目の値を保持する場合、監査項目の値を設定できないことが挙げられます。 その他のアカウントやケースカスタムなどの項目は、設定可能ですが、System ModStampだけは設定できないので覚えておきましょう。

システム項目とは？

コンピュータプログラムのソースコードなどで、データを記録しておくメモリ空間上の領域がありますが、これに名前を付けたものが「変数」です。 システム項目とは、プログラム実行時に自動的に付け加えられる値であり、いわば「変数」のようなものです。 いちいちコーディングによる日付を宣言することなく、プログラム実行時に自動的にシステム項目の日付設定されているので、参照するだけで自動的に値が付加されます。 システム項目とは、特に宣言する必要はなく、規則に従って自動的に付加される性質を持っています。

Salesforceのシステム項目

Salesforceのシステム項目には、System ModStampとLastModifiedDateの2種類があります。2つともタイムスタンプとしての機能を持っていますが、異なる性質を持っています。 タイムスタンプとは、特定の時刻が付与されるファイルなどの電子データのことです。例えば、ファイルの作成日時、更新日時、アクセス日時などがタイムスタンプに当たります。 ある時刻に電子データが存在していたことや、その時間以降、改ざんされていないことを証明するためのセキュリティ上の重要なデータといえます。 時刻認証サービスや時刻配信サービスといった信頼度の高い時刻のファイルデータが必要な企業に対して行っているタイムビジネスと呼ばれるサービスがあることからも、その重要性がわかります。

システム項目 LastModifiedDateとの違い

System ModStampが引き金（トリガ）となって、自動化されたプロセスによってレコードが最終的に修正された日時のことを表すのに対して、LastModifiedDateは、ユーザーによってレコードが最終的に修された日時を表します。 自動化されたプロセスによるレコード更新の場合、System ModStampによって日時の更新が行われますが、記録保管場所であるアーカイブが365日を超える場合や、既存の選択リスト値が更新される場合などは、System ModStampの機能が自動的に働き、日付データが付与されます。 他にも、System ModStampはインデックスが保持されていますが、LastModifiedDateはインデックスが保持されていないという違いがあります。そのため、LastModifiedDateでのクエリと呼ばれる質問での検索がうまく働かないケースが多くなります。

プリミティブデータ型の使用について（Datetime）

プリミティブデータ型とは、Salesforce内のAPIで使われている基本的なデータ型のことです。このプリミティブデータ型の中にタイムスタンプに関する値も含まれています。 「Datetime」の値は日付と時間の値（タイムスタンプ）を処理しているので、System ModStampにも関連します。 この項目は協定世界時と呼ばれる世界基準の時刻に対して、精度が1秒の完全なタイムスタンプを保存しています。ローカル時間（現地時間）に変換する場合は、クライアントアプリケーションで処理する必要があります。

API情報の設定（Defaulted on createとFilter）

System ModStampの項目は、API項目のプロパティである、「Defaulted on create」と「Filter」に属しています。 「Defaulted on create」とは、作成時に他の値が指定されていない場合に既定値が指定されるオブジェクトであり、「Filter」とは、SOQL （Salesforce Object Query Language）クエリと呼ばれるSalesforce専用に設計された言語での問い合わせや要求を表すFROM句または、WHERE句の検索条件として使用できるオブジェクトです。

Salesforce System ModStampについて詳しくなろう

Salesforce System ModStampについて知ることで、Salesforce内で使われるさまざまな機能を深く理解することにつながります。SalesforceのHPや無料学習サイトTrailheadを使って、System ModStampについて詳しくなってみましょう。]]>