プラットフォームイベント開発者ガイド
jPlatformEventSubscriberConfig の使用によるプラットフォームイベントトリガーのユーザーおよびバッチサイズの設定
デフォルトの自動化プロセスエンティティの代わりに特定のユーザーとしてトリガーを実行すると、次のようなメリットがあります。
- このユーザーとしてレコードの作成、更新、削除が行われる。
- 作成されたレコードの OwnerId 項目がこのユーザーに設定される。
- 共有が有効になっている場合、レコードがユーザーと共有される。(トリガーが with sharing キーワードで宣言された Apex クラスへのコールを行う場合など)。
- このユーザーによってトリガー実行のデバッグログが作成される。
- トリガーからメールメッセージを送信できる (デフォルトの自動化プロセスではサポートされていない)。
Salesforce 組織の有効なユーザーを指定できます。トリガーは、ユーザーのオブジェクト権限および項目レベルの権限に関係なく、すべてのレコードにアクセスする権限のあるシステムコンテキストで実行されます。トリガーが with sharing キーワードで宣言された Apex クラスへのコールを行われると、実行ユーザーに対してレコードの共有が適用されます。
ユーザーの設定に加えて、1 から 2,000 までのカスタムバッチサイズを指定できます。バッチサイズは、1 回の実行でトリガーに送信できるイベントメッセージの最大数です。プラットフォームイベントトリガーの場合、デフォルトのバッチサイズは 2,000 です。バッチサイズを小さく設定すると、Apex ガバナ制限に達することを回避できます。
Tooling API を使用してプラットフォームイベントトリガーを設定するには、『Tooling API 開発者ガイド』の「PlatformEventSubscriberConfig」を参照してください。設定を追加するには、PlatformEventSubscriberConfig REST リソースで POST を実行し、GET コールを実行して ID で設定を取得します。また、Tooling API を使用し���設定を照会することもできます。
メタデータ API を使用してプラットフォームイベントトリガーを設定するには、『メタデータ API 開発者ガイド』の「PlatformEventSubscriberConfig」を参照してください。Visual Studio Code を Salesforce 拡張機能パックで使用すると、メタデータ API をリリースして取得することができます。Visual Studio Code と拡張機能パックのインストールの詳細については、「Visual Studio Code 向け Salesforce 拡張機能」を参照してください。CLI を使用したメタデータのリリースと取得についての詳細は、『Salesforce CLI Command Reference (Salesforce CLI コマンドリファレンス)』の「source Commands (source コマンド)」および「mdapi Commands (mdapi コマンド)」を参照してください。