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

BatchApexErrorEvent

Apex の一括処理クラスに関連付けられた標準プラットフォームイベントを表します。このオブジェクトは、API バージョン 44.0 以降で使用できます。

Apex 一括処理クラスは、エラーまたは例外が発生したときにプラットフォームイベントを起動できるようになりました。イベントチャネルをリスンしているクライアントは、その失敗頻度、失敗時に範囲内にあったレコード、その他の例外の詳細を判断できます。

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

describeSObjects()

サポートされている登録者

Apex トリガ	プロセス	フロー	ストリーミング API (CometD)

ストリーミング API 登録チャネル

/event/BatchApexErrorEvent

特別なアクセスルール

Apex コードまたは API ではなく Salesforce Platform のみがこのイベントを起動できます。「アプリケーションのカスタマイズ」権限を持つユーザには参照アクセス権があります。

項目

項目名	詳細
AsyncApexJobId	�� string プロパティ Nillable 説明このイベントを起動した Apex 一括処理ジョブの AsyncApexJob レコード。
DoesExceedJobScopeMaxLength	型 boolean プロパティ Defaulted on create 説明メッセージが文字数制限を超えているために Message 項目が切り捨てられている場合は True。
ExceptionType	型 string プロパティ Nillable 説明 Apex 例外種別名。内部プラットフォームエラーは `System.UnexpectedException` 種別として表されます。
JobScope	型 textarea プロパティ Nillable 説明イベントが一括処理ジョブの `execute()` メソッドから起動された場合、範囲内にあったレコード ID。一括処理ジョブで sObject の代わりにカスタムイテレータを使用する場合、JobScope は iterable オブジェクトの `toString()` 表現になります。
Message	型 string プロパティ Nillable 説明例外メッセージテキスト。
フェーズ	型 string プロパティ Nillable 説明エラーが発生したときの一括処理ジョブのフェーズ。使用可能な値始める EXECUTE FINISH
ReplayId	型 string プロパティ Nillable 説明システムによって生成された ID 値を表し、イベントストリーム内のイベントの位置を参照します。連続するイベントに対して再生 ID の値に連番が振られるという保証はありません。登録者は再生 ID の値を保存し、再登録時にその値を使用して、保持ウィンドウ内の欠落したイベントを取得できます。
RequestId	型 string プロパティ Nillable 説明このイベントを起動した一括処理ジョブの一意の ID。イベントモニタリングのお客様はこの情報を使用してエラーをログ情報と相関することができます。
StackTrace	型 string プロパティ Nillable 説明例外の Apex スタックトレース (利用可能な場合)。

使用方法

BatchApexErrorEvent レコードは、Database.RaisesPlatformEvents インターフェースを実装する Apex 一括処理ジョブにより起動され、処理中に発生した未対応の Apex 例外を含みます。詳細は、『Apex コード開発者ガイド』を参照してください。

Salesforce および Lightning プラットフォームのオブジェクトリファレンス