Salesforce セキュリティガイド
jReportEvent および ListViewEvent でのチャンクの機能
チャンクは、レポートまたはリストビューの実行で多くのレコードが返され、返されたデータがチャンクに分割された場合に発生します。
| 使用可能なインターフェース: Salesforce Classic および Lightning Experience |
| 使用可能なエディション: Enterprise Edition、Unlimited Edition、および Developer Edition Salesforce Shield または Salesforce Event Monitoring アドオンサブスクリプションが必要です。 |
ReportEvent または ListViewEvent (およびそれに相当するストリーミング) がチャンクされる場合、ほとんどの項目値が繰り返される複数のイベントに分割されます。例外は、Records 項目、Sequence 項目、EventIdentifier 項目です。チャンクされた結果からのすべてのデータは、こうした項目を ExecutionIdentifier 項目と相関させて表示します。この項目はチャンク間で一意です。
チャンク同士をリンクするために���用する ReportEvent と ListViewEvent (およびそれに相当するストレージ) の項目についてもう少し詳しく説明します。
- Records — レポートまたはリストビューデータを表す JSON 文字列。データを複数のイベントにチャンクされた場合、各イベントの Records 項目には異なるデータが含まれます。
- Sequence — チャンクの結果である複数のイベントの順序を示す増分シーケンス番号。1 から開始します。たとえば、イベントが 5 つのチャンクに分割された場合、最初のチャンクの Sequence 項目は 1、2 番目のチャンクは 2、といった具合に 5 まで続きます。
- ExecutionIdentifier — 特定のレポートまたはリストビュー実行の一意の識別子。この識別子では、レポートまたはリスト実行が他の実行と区別されます。チャンクが発生した場合、この項目値はチャンク間で同じになり、この項目値を使用してチャンク同士をリンクして、完全なデータにできます。
- EventIdentifier — チャンクされたイベントを含む、各イベントの一意の識別子。
1 つのレポートまたはリストビュー実行からすべてのデータチャンクを表示するには、Sequence 項目、Records 項目、ExecutionIdentifier 項目を組み合わせて使用します。
たとえば、レポート実行で 1 万行が返されるとします。レコードのサイズに基づいてこのデータが 3 つのチャンクに分割されてから、3 つの個別の ReportEvent イベントが作成されます。次の表に、3 つのイベントの項目値の例を示します。表で示していない項目 (EventIdentifier を除く) は、3 つのイベント間で同じ値になります。
| ExecutionIdentifier | Sequence | Records |
|---|---|---|
| a50a4025-84f2-425d-8af9-2c780869f3b5 | 1 | {"totalSize":3000, "rows":[{"datacells":["005B0000001vURv",..........]}]} |
| a50a4025-84f2-425d-8af9-2c780869f3b5 | 2 | {"totalSize":3000, "rows":[{"datacells":["005B000000fewai"..........]}]} |
| a50a4025-84f2-425d-8af9-2c780869f3b5 | 3 | {"totalSize":4000, "rows":[{"datacells":["005B0000001vURv",..........]}]} |
次のサンプル SOQL クエリは、前の表と同様のデータを返します。
1SELECT ExecutionIdentifer, Sequence, Records FROM ReportEventトランザクションセキュリティによるチャンクの使用
チャンクされたイベントでトランザクションセキュリティポリシーがトリガされた場合、最初のチャンクでのみポリシーが実行されます。PolicyId 項目、PolicyOutcome 項目、EvaluationTime 項目の値はチャンクされたすべてのイベントで繰り返されます。以下の表に、さまざまなポリシーアクションと実行結果およびその結果のイベントを示します。こうしたイベントの中にはチャンクされているものがあります。
このイベントは、ブロックアクションがあったトリガされたポリシーの結果発生します。
| ExecutionIdentifier (読むやすくするため値を短縮) | Sequence | Records | PolicyId (読むやすくするため値を短縮) | PolicyOutcome | EvaluationTime |
|---|---|---|---|---|---|
| a50a4...9-2c780869f3b5 | 0 | {"totalSize":0, "rows":[{}]} | 0NIxx...GA2 | Block | 30 |
これらのイベントは、多要素認証 (MFA) アクションがあるトリガされたポリシーの結果発生します。最初の 3 行ではプロセス内の多要素認証が表示され、最後の 3 行ではチャンクされたイベントが表示されます。
| ExecutionIdentifier (読むやすくするため値を短縮) | Sequence | Records | PolicyId (読むやすくするため値を短縮) | PolicyOutcome | EvaluationTime |
|---|---|---|---|---|---|
| a50a4...9-2c780869f3b5 | 0 | {"totalSize":0, "rows":[{}]} | 0NIxx...GA2 | TwoFaInitiated | 30 |
| TwoFaInProgress | |||||
| TwoFaSucceed | |||||
| 43805...e-5914976709c4 | 2 | {"totalSize":3000, "rows":[{"datacells":["005B000000fewai"..........]}]} | 0NIxx...GA2 | TwoFaNoAction | 24 |
| 43805...e-5914976709c4 | 3 | {"totalSize":4000, "rows":[{"datacells":["005B0000001vURv",..........]}]} | 0NIxx...GA2 | TwoFaNoAction | 24 |
| 43805...e-5914976709c4 | 1 | {"totalSize":3000, "rows":[{"datacells":["005B0000001vURv",..........]}]} | 0NIxx...GA2 | TwoFaNoAction | 24 |
これらのイベントは、ブロックアクションがあるポリシーの結果発生しますが、イベントは条件を満たしませんでした。そのため、PolicyOutcome 項目は NoAction になります。
| ExecutionIdentifier (読むやすくするため値を短縮) | Sequence | Records | PolicyId (読むやすくするため値を短縮) | PolicyOutcome | EvaluationTime |
|---|---|---|---|---|---|
| a50a4...9-2c780869f3b5 | 1 | {"totalSize":3000, "rows":[{"datacells":["005B0000001vURv",..........]}]} | 0NIxx...GA2 | NoAction | 24 |
| a50a4...9-2c780869f3b5 | 2 | {"totalSize":3000, "rows":[{"datacells":["005B000000fewai"..........]}]} | 0NIxx...GA2 | NoAction | 24 |
| a50a4...9-2c780869f3b5 | 3 | {"totalSize":4000, "rows":[{"datacells":["005B0000001vURv",..........]}]} | 0NIxx...GA2 | NoAction | 24 |
これらのイベントは多要素認証アクションがあるポリシーの結果発生しますが、ポリシーはトリガされず、そのためアクションは実行されませんでした。ユーザがすでに高保証セッションレベルに達していたため、ポリシーはトリガされませんでした。
| ExecutionIdentifier (読むやすくするため値を短縮) | Sequence | Records | PolicyId (読むやすくするため値を短縮) | PolicyOutcome | EvaluationTime |
|---|---|---|---|---|---|
| a50a4...9-2c780869f3b5 | 1 | {"totalSize":3000, "rows":[{"datacells":["005B0000001vURv",..........]}]} | 0NIxx...GA2 | TwoFaNoAction | 24 |
| a50a4...9-2c780869f3b5 | 2 | {"totalSize":3000, "rows":[{"datacells":["005B000000fewai"..........]}]} | 0NIxx...GA2 | TwoFaNoAction | 24 |
| a50a4...9-2c780869f3b5 | 3 | {"totalSize":4000, "rows":[{"datacells":["005B0000001vURv",..........]}]} | 0NIxx...GA2 | TwoFaNoAction | 24 |