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

EventBusSubscriber

プラットフォームイベントまたは変更データキャプチャイベントに登録するトリガー、プロセス、またはフローを表します。CometD サブスクライバーは含まれません。

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

describeSObjects()query()

特別なアクセスルール

EventBusSubscriber は参照のみであり、これに対してクエリのみを実行できます。Summer '20 以降、このオブジェクトにアクセスできるのは、Salesforce 組織の内部ユーザーのみとなります。

項目

項目 詳細
ExternalId
String
プロパティ
Filter、Group、Nillable、Sort
説明
サブスクライバーの ID。例: トリガー ID。
LastError
String
プロパティ
Filter、Group、Nillable、Sort
説明
最後に発生した EventBus.RetryableException に含まれるエラーメッセージ。この項目は Apex トリガーにのみ適用されます。API バージョン 43.0 以降で使用できます。
Name
String
プロパティ
Filter、Group、Nillable、Sort
説明
トリガー名やプロセス名など、登録された項目の名前。登録された項目の名前が「プロセス」の場合、少なくとも 1 つのフローの一時停止要素でイベントを登録しています。
Position
int
プロパティ
Filter、Group、Nillable、Sort
説明
サブスクライバーが処理した最後のイベントの再生 ID。
Retries
int
プロパティ
Filter、Group、Nillable、Sort
説明
EventBus.RetryableException の発生が原因でトリガーが再試行された回数。この項目は Apex トリガーにのみ適用されます。API バージョン 43.0 以降で使用できます。
Status
picklist
プロパティ
Filter、Group、Nillable、Restricted picklist、Sort
説明
サブスクライバーの状況を示します。次のいずれかの値になる可能性があります。
  • Running — サブスクライバーはイベントをアクティブにリスンしています。サブスクライバーを変更すると、サブスクリプションでは引き続きイベントが処理されます。
  • Error — サブスクライバーは切断されており、公開されたイベントの受信を停止しています。トリガーがこの状態に達するのは、トリガーが EventBus.RetryableException による最大再試行回数を超えた場合です。トリガーのアサーションの失敗および未対応の例外が原因でエラー状態になることはありません。この状態に達しないようにするには、再試行回数を 9 回未満に制限することをお勧めします。トリガーを修正して保存した場合、または管理パッケージトリガーでパッケージを再リリースした場合は、トリガーは最新のイベントから自動的に再開されます。また、トリガーサブスクリプションは、サブスクリプション詳細ページでも再開できます。サブスクリプション詳細ページにはプラットフォームイベントページからアクセスします。
  • Suspended — サブスクライバーは切断されており、Salesforce システム管理者が一時停止したか、内部エラーのためイベントを受信できません。トリガーのサブスクリプションは、サブスクリプション詳細ページで再開できます。サブスクリプション詳細ページにはプラットフォームイベントページからアクセスします。プロセスを再開するには、プロセスを無効化してから再有効化します。サブスクライバーを変更すると、サブスクリプションは最新のイベントから自動的に再開されます。
詳細は、『プラットフォームイベント開発者ガイド』「プラットフォームイベントの詳細ページでのイベントのサブスクライバーの表示および管理」を参照してください。
Tip
int
プロパティ
Filter、Group、Nillable、Sort
説明
公開された最後のイベントの再生 ID。

大規模プラットフォームイベントおよび変更イベントの場合、Tip の値は使用できず、常に -1 です。

メモ

Topic
String
プロパティ
Filter、Group、Nillable、Sort
説明
プラットフォームイベントまたは変更イベントに対応するサブスクリプションチャネルの名前。プラットフォームイベントの場合、トピック名は __e を追加したイベント名です (MyEvent__e など)。変更イベントの場合、トピックは変更イベントの名前です (AccountChangeEvent など)。
Type
String
プロパティ
Filter、Group、Nillable、Sort
説明
サブスクライバー種別 (ApexTrigger)。サブスクライバーがプロセスまたはフローの一時停止要素の場合、この種別は空白です。

使用方法

EventBusSubscriber を使用して、プラットフォームイベントのサブスクライバーに関する詳細を照会します。次のように Topic 項目を絞り込むことで、特定のイベントのすべてのサブスクライバーを取得できます。