プラットフォームイベント開発者ガイド
jプラットフォームイベントの詳細ページでのイベントの登録者の表示および管理
イベント登録者の表示
プラットフォームイベントを登録しているすべてのトリガ、プロセス、およびプラットフォームイベントトリガフローのリストを [登録] 関連リストに表示します。独自の CometD クライアントや empApi Lightning コンポーネントなどの CometD 登録者は、このページに表示されません。
- [設定] から、[クイック検索] ボックスに「プラットフォームイベント」と入力し、[プラットフォームイベント] を選択します。
- イベントの名前をクリックします。
イベントの定義ページにある [登録] 関連リストには、プラットフォームイベントを登録しているすべての有効なトリガ、プロセス、およびプラットフォームイベントトリガフローが表示されます。
- 登録者の定義にアクセスするには、[登録] 関連リストで登録者名をクリックします。トリガの詳細には、その実装と API バージョンが含まれます。プロセスの詳細には、そのバージョン番号と API 参照名が含まれます。
リストには、システムが最後に処理したイベントの再実行 ID ([最終処理 ID] 項目) と最後に公開されたイベントの再実行 ID ([最終公開 ID] 項目) が表示されます。最後に処理された再実行 ID を把握しておくと、公開されたイベントと処理されたイベントとの間に差がある場合に役立ちます。たとえば、トリガに複雑なロジックが含まれており、それにより、受信イベントの大量のバッチの処理で遅延が発生した場合です。
登録の状態
また、[登録] リストには、各登録者の状態 (次のいずれか) が表示されます。
- Running — 登録者はイベントをアクティブにリスンしています。登録者を変更すると、登録では引き続きイベントが処理されます。
- Error — 登録者は切断されており、公開されたイベントの受信を停止しています。トリガがこの状態に達するのは、トリガが EventBus.RetryableException による最大再試行回数を超えた場合です。トリガのアサーションの失敗および未対応の例外が原因でエラー状態になることはありません。この状態に達しないようにするには、再試行回数を 9 回未満に制限することをお勧めします。トリガを修��して保存した場合、または管理パッケージトリガでパッケージを再リリースした場合は、トリガは最新のイベントから自動的に再開されます。また、トリガ登録は、登録詳細ページでも再開できます。登録詳細ページにはプラットフォームイベントページからアクセスします。
- Suspended — 登録者は切断されており、Salesforce システム管理者が一時停止したか、内部エラーのためイベントを受信できません。トリガの登録は、登録詳細ページで再開できます。登録詳細ページにはプラットフォームイベントページからアクセスします。プロセスを再開するには、プロセスを無効化してから再有効化します。登録者を変更すると、登録は最新のイベントから自動的に再開されます。
Apex トリガ登録の一時停止または再開
登録が停止した場所で、イベントバスで使用できる最も古いイベントメッセージからトリガの登録を再開します。エラーの原因となったイベントメッセージや、不要となったメッセージをバイパスする場合は、登録を最新のイベントメッセージから再開することができます。
トリガ登録を管理する手順は次のとおりです。
- [記事] 関連リストで、Apex トリガの横の [管理] をクリックします。
- 登録詳細ページで、適切なアクションを選択します。
- 実行中の登録を一時停止するには、[一時停止] をクリックします。
- 一時停止中の登録を、イベントバスで使用可能な最も古いイベントメッセージから再開するには、[再開] をクリックします。
- 一時停止中の登録を新しいイベントメッセージから再開するには、[最新から再開] をクリックします。
[登録] 関連リストからのフローおよびプロセスの登録は管理できません。