この文章は Salesforce 機械翻訳システムを使用して翻訳されました。詳細はこちらをご参照ください。

ReportEvent

組織内でいつレポートが実行されたかを追跡します。ReportEvent は、トランザクションセキュリティポリシーで使用できます。ReportEvent は、ReportEventStream のイベントデータを格納する Big Object です。このオブジェクトは API バージョン 46.0 以降で使用できます。

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

describeSObjects()、query()

特別なアクセスルール

このオブジェクトにアクセスするには、Salesforce Shield または Salesforce Event Monitoring アドオンサブスクリプションと、「リアルタイムイベント監視データを表示」ユーザ権限が必要です。

項目

項目	詳細
ColumnHeaders	型 string プロパティ Nillable 説明レポートの列ヘッダーのカンマ区切り値。たとえば、[USERNAME, ACCOUNT.NAME, TYPE, DUE_DATE, LAST_UPDATE, ADDRESS1_STATE] のように指定します。
DashboardId	型 reference プロパティ Nillable 説明レポートが属していたダッシュボードの ID。たとえば、01ZB0000000PmoQ です。これはリレーション項目です。リレーション名 Dashboard リレーション種別参照関係参照先 Dashboard
DashboardName	型 string プロパティ Nillable 説明レポートが属していたダッシュボードのタイトル。
Description	型 string プロパティ Nillable 説明レポートの説明。
DisplayedFieldEntities	型 string プロパティ Nillable 説明グループ化された列項目のエンティティの名前を含め、レポートに標示される項目の API 値。たとえば、`[ACCOUNTS, OWNERS]` です。
EvaluationTime	型 double プロパティ Nillable 説明ポリシーの評価にかかった時間 (ミリ秒単位)。
EventDate	型 dateTime プロパティ Filter、Sort 説明指定されたレポートイベントが捕捉された時間 (クエリの実行後)。たとえば、「`2020-01-20T19:12:26.965Z`」などです。最も細かい設定はミリ秒です。
EventIdentifier	型 string プロパティ Filter、Sort 説明イベントの一意の ID。たとえば、0a4779b0-0da1-4619-a373-0a36991dff90 などです。
EventSource	型 picklist プロパティ Nillable、Restricted picklist 説明イベントの発生元。可能な値は次のとおりです。 `API` — ユーザが API コールによってレポートを生成しました。 `Classic` — ユーザが Salesforce Classic UI からレポートを生成しました。 `Lightning` — ユーザが Lightning Experience からレポートを生成しました。
ExecutionIdentifier	型 string プロパティ Nillable 説明レポートデータが複数のレポートイベントに分割される場合、この一意識別子を使用して複数のデータチャンクを相関付けます。たとえば、各チャンクに a50a4025-84f2-425d-8af9-2c780869f3b5 という同じ ExecutionIdentifier がある場合、それらをリンクしてレポート実行のすべてのデータを取得できます。Sequence 項目には、複数のイベントの順序を示す、増分シーケンス番号が含まれています。詳細は、Sequence を参照してください。
ExportFileFormat	型 string プロパティ Nillable 説明ユーザがレポートをエクスポートした場合、この値はエクスポートされたレポートの形式を示します。可能な値は次のとおりです。 CSV Excel
Format	型 picklist プロパティ Defaulted on create、Nillable、Restricted picklist 説明レポートの形式。可能な値は次のとおりです。 `Matrix` `MultiBlock` `Summary` `Tabular`
GroupedColumnHeaders	型 string プロパティ Nillable 説明サマリーレポート、マトリックスレポート、および結合レポート内のグループ化された列項目のカンマ区切り値。たとえば、`[USERNAME, ACCOUNT.NAME, TYPE, DUE_DATE, LAST_UPDATE, ADDRESS1_STATE]` です。
IsScheduled	型 boolean プロパティ Defaulted on create 説明 TRUE の場合、レポートはスケジュール済みです。FALSE の場合、レポートはスケジュールされていません。
LoginHistoryId	型 reference プロパティ Nillable 説明ユーザアクティビティと一連の特定のレポートイベントを関連付けられるように、ユーザセッションを追跡します。この項目は LoginEvent、AuthSession、および LoginHistory オブジェクトでも使用できるため、ユーザの元の認証へとイベントを簡単にトレースバックできます。生成されたイベントがダッシュボードの更新、マルチブロックレポート、またはスケジュール済みレポートからのものである場合、この値は null です。たとえば、0YaB000002knVQLKA2 です。これはリレーション項目です。リレーション名 LoginHistory リレーション種別参照関係参照先 LoginHistory
LoginKey	型 string プロパティ Nillable 説明特定のユーザのログインセッションのすべてのイベントを結び付ける文字列。このセッションはログインイベントで開始され、ログアウトイベントまたはユーザセッションの期限切れで終了します。生成されたイベントがダッシュボードの更新、マルチブロックレポート、またはスケジュール済みレポートからのものである場合、この値は null です。たとえば、lUqjLPQTWRdvRG4 です。
Name	型 string プロパティ Nillable 説明レポートの表示名。レポートプレビューの場合、値は null です。
NumberOfColumns	型 int プロパティ Nillable 説明レポートの列数。
Operation	型 picklist プロパティ Nillable、Restricted picklist 説明 UI (Classic、Lightning、Mobile)、API (同期、非同期、Apex)、またはダッシュボードなどから実行されたレポートのコンテキスト。項目 SessionKey、LoginKey、SessionLevel、SourceIp に含まれるセッション情報は、非同期操作から生成されたレポートには捕捉されません。可能な値は次のとおりです。 `ChartRenderedInEmbeddedAnalyticsApp`: レポートは、組み込み Analytics アプリケーションでレンダリングされたチャートから実行されました。 `ChartRenderedOnHomePage`: レポートはホームページの表示済みのグラフから実行されました。 `ChartRenderedOnVisualforcePage`: レポートは、VisualForce ページの表示済みのグラフから実行されました。 `DashboardComponentPreviewed`: レポートは Lightning ダッシュボードコンポーネントのプレビューから実行されました。 `DashboardComponentUpdated`: レポートは、ユーザがダッシュボードコンポーネントを更新したときに実行されました。 `ProbeQuery`: レポートは、プローブクエリから実行されました。 `ReportAddedToCampaign`: レポートは、[キャンペーンに追加] アクションによって追加されました。 `ReportExported`: レポートは、非同期でも API エクスポートでもない、印刷用表示またはレポートのエクスポートで実行されました。 `ReportExportedAsynchronously`: レポートは、非同期にエクスポートされました。 `ReportExportedUsingExcelConnector`: レポートは、Excel コネクタを使用してエクスポートされました。 `ReportOpenedFromMobileDashboard`: レポートは、ユーザがモバイルデバイスのダッシュボードコンポーネントをクリックしてレポートにドリルダウンしたときに実行されました。 `ReportPreviewed`: レポートは、ユーザがレポートビルダーの使用中にプレビュー結果を取得したときに実行されました。 `ReportResultsAddedToEinsteinDiscovery`: レポートは、Einstein Discovery から同期的に実行されました。 `ReportResultsAddedToWaveTrending`: レポートは、ユーザが Tableau CRM でレポートのトレンド分析を行ったときに実行されました。 `ReportRunAndNotificationSent`: レポートは、通知 API から実行されました。 `ReportRunFromClassic`: レポートは、Salesforce Classic の [レポート実行] オプションから実行されました。 `ReportRunFromLightning`: レポートは、モバイルブラウザ以外の Lightning Experience の [実行] オプションから実行されました。 `ReportRunFromMobile`: レポートは、モバイル Salesforce アプリケーションの [レポート実行] オプションから実行されました。 `ReportRunFromReportingSnapshot`: レポートは、Snapshot Analytics によって実行されました。 `ReportRunFromRestApi`: レポートは、REST API から実行されました。 `ReportRunUsingApexAsynchronousApi`: レポートは非同期 Apex API から実行されました。 `ReportRunUsingApexSynchronousApi`: レポートは同期 Apex API から実行されました。 `ReportRunUsingAsynchronousApi`: レポートは非同期 API から実行されました。 `ReportRunUsingSynchronousApi`: レポートは同期 API から実行されました。 `ReportScheduled`: レポートは、スケジュール済みでした。 `Test`: レポートの実行は、テストから行われました。 `Unknown`: レポートの実行元は不明です。
OwnerId	型 reference プロパティ Nillable 説明レポートを所有するフォルダ、組織、またはユーザの ID。レポートが保存されていない場合、この値は UserId と同じになります。たとえば、005B0000001vURv です。これは多態的なリレーション項目です。リレーション名 Owner リレーション種別参照関係参照先 Folder、Organization、User
PolicyId	型 reference プロパティ Nillable 説明このイベントに関連付けられたトランサクションポリシーの ID。たとえば、0NIB000000000KOOAY です。これはリレーション項目です。リレーション名 Policy リレーション種別参照関係参照先 TransactionSecurityPolicy
PolicyOutcome	型 picklist プロパティ Nillable、Restricted picklist 説明トランサクションポリシーの結果。可能な値は次のとおりです。 `Block` - ポリシーをトリガする操作を実行できないようにユーザがブロックされました。 `Error` - ポリシーの実行時にポリシーによって未定義のエラーが発生しました。 `FailedInvalidPassword` - ユーザが無効なパスワードを入力しました。 `FailedPasswordLockout` - ユーザが無効なパスワードを入力した回数が多すぎます。 `NoAction` - ポリシーがトリガしませんでした。 `Notified` - 受信者に通知が送信されました。 `TwoFAAutomatedSuccess` - 信頼できる場所から要求が行われたため、Salesforce Authenticator がアクセス要求を承認しました。ユーザが Salesforce Authenticator のロケーションサービスを有効にすると、信頼できる場所を指定できます。特定のアクティビティに対してユーザが場所を信頼すると、その場所が信頼される限り、信頼された場所からの該当のアクティビティは承認されます。認識されたデバイスからのログインはその一例です。 `TwoFADenied` - Salesforce Authenticator などの認証アプリケーションでの承認申請をユーザが拒否しました。 `TwoFAFailedGeneralError` - 確認コードが無効、検証試行回数が多すぎる、または認証アプリケーションの接続以外の問題が原因でエラーが発生しました。 `TwoFAFailedInvalidCode` - ユーザが無効な確認コードを入力しました。 `TwoFAFailedTooManyAttempts` - ユーザが ID の検証を試行した回数が多すぎます。たとえば、ユーザが無効な確認コードを繰り返し入力した場合などです。 `TwoFAInitiated` - Salesforce が ID 検証を開始しましたが、まだユーザに検証を求めていません。 `TwoFAInProgress` - Salesforce がユーザに ID の検証を求め、ユーザによる応答または Salesforce Authenticator による自動応答の送信を待機しています。 `TwoFANoAction` - ポリシーではアクションとして多要素認証 (旧称「2 要素認証」) が指定されていますが、ユーザはすでに高保証セッションを使用しています。 `TwoFARecoverableError` - Salesforce が ID を検証する認証アプリケーションに接続できませんでしたが、再試行します。 `TwoFAReportedDenied` - Salesforce Authenticator などの認証アプリケーションの承認申請をユーザが拒否し、さらに承認申請をシステム管理者に報告するようにフラグを付けました。 `TwoFASucceeded` - ユーザの ID が検証されました。
QueriedEntities	型 string プロパティ Nillable 説明 SOQL クエリのエンティティ。たとえば、商談、リード、取引先、ケースなどです。また、カスタムオブジェクトを含めることもできます。リレーションクエリの場合、この項目の値にはクエリに関係するすべてのエンティティが含まれます。クエリから返されるレコードがない場合、この項目の値は null です。例 `SELECT Contact.FirstName, Contact.Account.Name from Contact` の場合、QueriedEntities の値は `Account, Contact` になります。 `SELECT Account.Name, (SELECT Contact.FirstName, Contact.LastName FROM Account.Contacts) FROM Account` の場合、QueriedEntities の値は `Account, Contact` になります。 `SELECT Id, Name, Account.Name FROM Contact WHERE Account.Industry = 'media'` の場合、QueriedEntities の値は `Account, Contact` になります。
Records	型 json プロパティ Nillable 説明レポートのデータを表す JSON 文字列。たとえば、`{"totalSize":1,"rows":[{"datacells":["005B0000001vURv","001B000000fewai"]}]}` です。
RelatedEventIdentifier	型 string プロパティ Nillable 説明関連イベントの EventIdentifier を表します。たとえば、bd76f3e7-9ee5-4400-9e7f-54de57ecd79c です。この項目は、このイベントで監視しているアクティビティで追加の認証 (多要素認証など) が必要とされる場合にのみ入力されます。この場合、Salesforce はより多くのイベントを生成し、新しいイベントの RelatedEventIdentifier 項目を元のイベントの EventIdentifier 項目の値に設定します。この項目を EventIdentifier 項目と共に使用して、すべての関連イベントを相関させます。追加の認証が必要でない場合、この項目は空白になります。
ReportId	型 reference プロパティ Nillable 説明このイベントに関連付けられたレポートの ID。たとえば、00OB00000032FHdMAM です。これはリレーション項目です。リレーション名レポートリレーション種別参照関係参照先レポート
RowsProcessed	型 double プロパティ Nillable 説明レポートで返される合計行数。レポートデータが複数のレポートイベントに分割される場合、この値は、すべてのデータチャンクと同じになります。詳細は、ExecutionIdentifier を参照してください。
Scope	型 string プロパティ Nillable 説明ユーザが実行したレポートのデータの範囲を定義します。たとえば、ユーザは、すべての商談、自分が所有する商談、所属するチームが所有する商談に対してレポートを実行できます。可能な値は次のとおりです。 `user` - レポートを実行したオブジェクトは、ユーザが所有します。 `team` - レポートを実行したオブジェクトは、チームが所有します。 `organization` - レポートは、該当するすべてのオブジェクトに対して実行されました。
Sequence	型 int プロパティ Nillable 説明特定のレポート実行によって発生する複数のイベントの順序を示す増分シーケンス番号。レポートの実行で多くのレコードが返されると、Salesforce ではこのデータがレコードのサイズに基づいてチャンクに分割され、複数の個別の ReportEventStreams が作成されます。相関するこれらの ReportEventStreams のそれぞれの項目値は同じ値です。ただし、Records と Sequence を除きます。Records には異なるデータチャンクが含まれます。Sequence は各チャンクを順番に識別します。すべてのレポートの実行には、他のレポートの実行と区別するための一意の ExecutionIdentifier 値があります。1 つのレポート実行で作成されたすべてのデータチャンクを表示するには、Sequence および ExecutionIdentifier 項目を組み合わせて使用します。レポートを実行すると、Records 項目にデータが含まれているイベントのうち、先頭の 1000 件が表示されます。レポート全体を表示するには、ReportId 項目を使用してください。重要詳細は、ExecutionIdentifier を参照してください。
SessionKey	型 string プロパティ Nillable 説明ユーザの一意のセッション ID。この値を使用して、セッション内のすべてのユーザイベントを識別します。ユーザがログアウトしてから再びログインすると、新しいセッションが開始されます。生成されたイベントがダッシュボードの更新、マルチブロックレポート、またはスケジュール済みレポートからのものである場合、この値は null です。たとえば、vMASKIU6AxEr+Op5 です。
SessionLevel	型 picklist プロパティ Nillable、Restricted picklist 説明セッションレベルのセキュリティは、接続アプリケーションやレポートなど、このセキュリティ��サポートする機能へのユーザのアクセス権を制御します。可能な値は次のとおりです。 `HIGH_ASSURANCE` - リソースへのアクセスに高保証セッションが使用されました。たとえば、高保証セッションレベルが必要な接続アプリケーション、レポート、ダッシュボードなどのリソースにユーザがアクセスしようとした場合です。 `LOW` - 現在のセッションに対するユーザのセキュリティレベルが最低限の要件を満たします。この Low レベルは、Salesforce UI で利用不可能であるか、使用されません。UI を介したユーザセッションは、標準または高保証です。このレベルは API を使用して設定できますが、このレベルに割り当てられたユーザは、Salesforce 組織で使用できる機能が制限され、またどの機能を使用できるかを判断することができません。メモ `STANDARD` - 現在のセッションに対するユーザのセキュリティレベルが、組織のセッションセキュリティレベルの標準の要件セットを満たします。生成されたイベントがダッシュボードの更新、マルチブロックレポート、またはスケジュール済みレポートからのものである場合、この値は null です。
SourceIp	型 string プロパティ Nillable 説明ログインしているクライアントの供給元 IP アドレス。たとえば、126.7.4.2 など。
UserId	型 reference プロパティ Filter、Sort 説明発生元ユーザの一意の ID。たとえば、005B0000001vURv です。これは多態的なリレーション項目です。リレーション名ユーザリレーション種別参照関係参照先ユーザ
Username	型 string プロパティ Nillable 説明イベントが作成された時点での user@company.com 形式の発生元のユーザ名。

標準 SOQL 使用状況

現在、ReportEvent でサポートされる SOQL 関数は WHERE のみで、比較演算子 (=、<、>、<=、>=) は WHERE 句の最後の式でのみ使用できます。!= 演算子はサポートされていません。

convertTimezone() などの日付関数はサポートされていません。たとえば、SELECT CALENDAR_YEAR(EventDate), Count(EventIdentifier) FROM ReportEvent GROUP BY CALENDAR_YEAR(EventDate) はエラーを返します。クエリの日付リテラルや、TODAY、YESTERDAY、LAST_n_DAYS:1 のような日付および日付/時間関数は使用できます。ただし、これらの関数はバックグラウンドで比較演算子を使用します。そのため、これらは WHERE 句の最後の式でのみ使用できます。

ReportEvent では、3 つの順序付けられた項目 (UserId (ベータ)、EventDate、および EventIdentifier) で絞り込みができます。ただし注意すべき点があります。これらの項目を正しい順序に並べ、組み合わせて使用しないとクエリは機能しません。

ReportEvent で有効な検索条件は次のとおりです。

UserId のみ
EventDate のみ
UserId と EventDate
EventDate と EventIdentifier
EventDate は、検索条件の順序が UserId、EventDate の場合に範囲検索条件を使用できます。
EventIdentifier は、順序が EventDate、EventIdentifier の場合に範囲クエリを実行できます。

ReportEvent の UserId 検索条件はベータ機能としてのプレビュー版であり、Salesforce とのマスターサブスクリプション契約における「サービス」には含まれません。この機能はお客様各自の裁量で使用し、購入するときは、現在正式にリリースされている製品および機能に基づいて判断してください。Salesforce はこの機能の特定期間内の正式リリースまたはリリースの有無を保証しません。また、いかなる時点でもこの機能を終了できるものとします。この機能は、評価のみを目的としており、本番環境で使用するものではありません。この機能は、そのままの状態で提供され、サポートされておらず、ここから生じる、またはこれに関連する被害または損害に対して、Salesforce はいかなる責任も負いません。すべての制約、Salesforce の権利の保留、本サービスに関する義務、および関連する Salesforce 以外のアプリケーションならびにコンテンツの条件は、この機能の使用に等しく適用されます。

メモ

次のリストで、有効なクエリと無効なクエリの例を確認してください。

絞り込みなしのクエリ
- 有効 — WHERE 句が含まれないため、特殊なルールは適用されません。
  1SELECT DashboardId,Description,DisplayedFieldEntities,EventDate,Format,UserId 2FROM ReportEvent

UserId (ベータ) での絞り込み

有効 — UserId (ベータ) のみで絞り込みができます。UserId (ベータ) のみで絞り込む場合、範囲検索条件を含めることができます。
1SELECT DashboardId,Description,DisplayedFieldEntities,EventDate,Format,UserId 2FROM ReportEvent 3WHERE UserId='005B0000001vURv'<=TODAY
有効 — UserId (ベータ) と EventDate で絞り込みます。EventDate は、検索条件の順序が UserId (ベータ)、EventDate の場合に範囲検索条件を使用できます。
1SELECT DashboardId,Description,DisplayedFieldEntities,EventDate,Format,UserId 2FROM ReportEvent 3WHERE UserId='005B0000001vURv' AND EventDate<=TODAY

有効 — UserId (ベータ) で絞り込み、結果を並べ替えます。

1SELECT DashboardId,Description,DisplayedFieldEntities,EventDate,Format,UserId
2FROM ReportEvent
3WHERE UserId = '005B0000001vURv' 
4ORDER BY EventDate DESC

無効 — UserId (ベータ) と EventIdentifier 項目での絞り込みはサポートされていません。

1SELECT DashboardId,Description,DisplayedFieldEntities,EventDate,Format,UserId
2FROM ReportEvent
3WHERE UserId='005B0000001vURv' AND EventIdentifier='f0b28782-1ec2-424c-8d37-8f783e0a3754'

EventDate での絞り込み

有効 — 日付リテラルを使用して EventDate で絞り込みができます。または、EventDate のみで絞り込む場合、範囲クエリを含めることができます。
1SELECT DashboardId,Description,DisplayedFieldEntities,EventDate,Format,UserId 2FROM ReportEvent 3WHERE EventDate<=TODAY

無効 — 標準日付リテラルを使用した EventDate での絞り込みはサポートされていません。

1SELECT DashboardId,Description,DisplayedFieldEntities,EventDate,Format,UserId
2FROM ReportEvent
3WHERE EventDate=TODAY AND EventIdentifier='f0b28782-1ec2-424c-8d37-8f783e0a3754'

無効 — <= または >= を使用する EventDate と EventIdentifier 項目での絞り込みはサポートされていません。

1SELECT DashboardId,Description,DisplayedFieldEntities,EventDate,Format,UserId
2FROM ReportEvent
3WHERE EventDate<=2014-11-27T14:54:16.000Z AND EventIdentifier='f0b28782-1ec2-424c-8d37-8f783e0a3754'

非同期 SOQL 使用状況

非同期 SOQL の場合は、ReportEvent の項目を絞り込み、クエリに任意の比較演算子を使用できます。

例: ユーザが Patent__c に対して実行したすべてのレポートを検索する

SELECT EventDate, EventIdentifier, PolicyOutcome, EvaluationTime, ReportId, Name FROM ReportEvent WHERE QueriedEntities='Patent__c'

プラットフォームイベント開発者ガイド

ReportEvent

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

特別なアクセスルール

項目

標準 SOQL 使用状況

非同期 SOQL 使用状況

関連項目: