RecentlyViewed | Salesforce プラットフォームのオブジェクトリファレンス

サポートされているコール

query()、update()update()

特別な使用ルール

RecentlyViewed オブジェクトでは、Event、Task、Report、KnowledgeArticle、Article オブジェクトをサポートしていません。

RecentlyViewed オブジェクトは特定のオブジェクトのみをサポートします。また、それらのオブジェクトのリストビューのみをサポートします。サポートされるオブジェクトには LastReferencedDate および LastViewedDate 項目があります。

複数のコミュニティに所属しているユーザの RecentlyViewed レコードを Apex 経由で自動的にマップに取得することはできません。これは、異なる複数のネットワークを使用するユーザのレコードが、重複した ID になる可能性があり、マップではサポートされていないためです。

メモ

項目

項目	詳細
Alias	型 string プロパティ Filter、Group、Nillable、Sort 説明レコードの別名。
Email	型 email プロパティ Filter、Group、Nillable、Sort 説明レコードのメールアドレス。
FirstName	型 string プロパティ Filter、Group、Nillable、Sort 説明レコードの名。最近参照したレコードがユーザの場合、値はユーザの名になります。
Id	型 ID プロパティ Defaulted on create、Filter、Group、Sort 説明最近参照したレコードまたはリストビューの ID。
IsActive	型 boolean プロパティ Defaulted on create、Filter、Group、Sort 説明最近参照したレコードが有効なユーザであるか (`true`)、否か (`false`) を示します。この項目には、最近参照したレコードがユーザである場合にのみ値が含まれます。
LastName	型 string プロパティ Filter、Group、Nillable、Sort 説明レコードの姓。
LastReferencedDate	型 dateTime プロパティ Filter、Nillable、Sort、Update 説明現在のユーザがこのレコード、このレコードに関連するレコード、またはリストビューに最後にアクセスしたときのタイムスタンプ。
LastViewedDate	型 dateTime プロパティ Filter、Nillable、Sort、Update 説明現在のユーザがこのレコードまたはリストビューを最後に表示したときのタイムスタンプ。この値が null の場合、ユーザはこのレコードまたはリストビューにアクセスしただけで (LastReferencedDate) 表示していない可能性があります。
Name	型 string プロパティ Filter、Group、Nillable、Sort 説明最近参照したレコードまたはリストビューの名前。最近参照したレコードがユーザ、取引先責任者、またはリードの場合、`firstname` 項目と `lastname` 項目を連結した値になります。
NetworkId	型 reference プロパティ Filter、Group、Nillable、Sort 説明このグループが含まれる Experience Cloud サイトの ID。この項目は、デジタルエクスペリエンスが組織で有効になっている場合にのみ使用できます。 NetworkId は、グループの作成時にのみ追加できます。既存のグループの場合、NetworkId の変更や追加はできません。この項目は、API バージョン 27.0 以降で使用できます。
Phone	型 phone プロパティ Filter、Group、Nillable、Sort 説明レコードの電話番号。
ProfileId	型 reference プロパティ Filter、Group、Nillable、Sort 説明最近参照したレコードがユーザの場合、この値はユーザのプロファイル ID になります。これはリレーション項目です。リレーション名 Profile リレーション種別 Lookup 参照先 Profile
Title	型 string プロパティ Filter、Group、Nillable、Sort 説明最近参照したレコードがユーザの場合、この値はユーザの役職 (CFO または CEO など) になります。
Type	型 picklist プロパティ Filter、Group、Nillable、Restricted、picklistSort 説明最近参照したレコードまたはリストビューのオブジェクト種別。有効な値は、RecentlyViewed がサポートする任意の標準オブジェクトまたはカスタムオブジェクトです。
UserRoleId	型 reference プロパティ Filter、Group、Nillable、Sort 説明このオブジェクトに関連付けられているユーザロールの ID。これはリレーション項目です。リレーション名 UserRole リレーション種別 Lookup 参照先 UserRole

使用方法

このオブジェクトは、異なるオブジェクト種別の異種リストを提供します。このリストは最近表示したレコード、最近参照した (関連レコードを表示した) レコード、最近表示したリストビューで構成されます。レコードは、ユーザがレコードの詳細を表示した場合に「参照された」と見なされますが、他のレコードが含まれるリストでレコードを見た場合は「参照された」とは見なされません。現在のユーザに固有の最近参照した項目のリストをプログラムで作成するにはこのオブジェクトを使用します。たとえば、このオブジェクトをカスタムユーザインターフェースや検索のオートコンプリートオプションに使用できます。また、オブジェクト型 (Type) で絞り込んだレコードのリストを取得することもできます。RecentlyViewed データは、オブジェクトにつき 200 レコードおよび 200 リストビューまでに定期的に切り捨てられます。RecentlyViewed データは 90 日間保持され、90 日が経過すると定期的に削除されます。

最近参照したすべてのレコードおよびリストビューのリストを取得するには、次のクエリをコードで使用します。結果は、最近のものから順に並べられます。

1SELECT Id, Name
2FROM RecentlyViewed
3WHERE LastViewedDate !=null
4ORDER BY LastViewedDate DESC

次のクエリを使用して、表示または参照したデータのうち、制限されたオブジェクトのセットのみを取得します。

1SELECT Id, Name
2FROM RecentlyViewed 
3WHERE Type IN ('Account', 'Contact', 'Plan__c')
4ORDER BY LastViewedDate DESC

次のクエリは、取引先責任者の取引先名などの取引先責任者固有の項目やカスタム Web サイト項目を含む、最近参照したすべての取引先責任者のリストを取得します。レコードは、最近のものから順に並べられます。

1SELECT Account.Name, Title, Email, Phone, Website__c
2FROM Contact
3WHERE LastViewedDate != NULL 
4ORDER BY LastViewedDate DESC