Pega Declare OnChange と Trigger の使い分け|イベント駆動ロジックの分岐点
業務ロジックの副作用を宣言的に仕込むとき、Declare OnChange と Declare Trigger のどちらを選ぶべきか迷った経験はないだろうか。前者はインメモリのプロパティ変更に、後者は DB への保存イベントに反応する——この違いを理解しないまま実装すると、確定前の一時値に反応した不整合や、監視対象を書き換えることによる無限ループを招く。本記事では両者の発火契機の違いを起点に、確定後処理・派生データ更新・外部連携でどちらを使うべきかを判断できるよう整理する。
結論から:反応する「契機」が根本的に違う
Pega で業務ロジックに副作用を仕込むとき、「あるプロパティが変わったら/ケースが保存されたら、自動で何かを実行したい」という要件は頻繁に出てきます。これを宣言的に実現する代表的な手段が Declare OnChange と Declare Trigger です。どちらも「イベントが起きたらアクティビティを実行する」という形をしているため混同されがちですが、反応する契機がまったく違います。
結論を先に言うと、選択の起点はたった 1 つの問いです。
その副作用は「処理中のインメモリの値変化」に即応させたいのか、それとも「DB への保存・コミットという確定イベント」を起点にしたいのか。前者なら Declare OnChange、後者なら Declare Trigger。
「変わったら動かす」という言葉は同じでも、Pega にとっての「変わった」には 2 つの意味があります。クリップボード上でプロパティ値が書き換わった瞬間と、その変更がデータベースに永続化された瞬間です。ここを取り違えると、まだ確定していない一時値に反応して不整合を起こしたり、監視対象そのものを書き換えて無限ループに陥ったりします。本記事では、この発火契機の違いを軸に判断を整理します。
Declare OnChange とは — インメモリの値変化に反応する
Declare OnChange は、クリップボード上でプロパティの値が変化した瞬間に反応する宣言的ルールです。処理の途中でメモリ上の値が書き換わったことを監視し、条件に合致したらアクティビティを実行します。
ポイントは、反応の起点が まだ永続化されていない、処理中のインメモリの値 だということです。ユーザーが画面で値を入れた、あるいは Data Transform やアクティビティがプロパティを書き換えた——そうした「クリップボード上の変化」を捉えて即座に動きます。DB への保存を待たないため、画面内の連動計算や派生値の更新のように、その場で反応してほしい処理 に向きます。
- 長所 — 変更を即座に、しかも宣言的に捕まえられる。「この値が変わったら、ついでにこの処理も走らせたい」を命令的コードに散らさずに済む
- 短所 — 反応するのが確定前の一時値であるため、まだトランザクションが確定していない中間状態に反応してしまうリスクがある。また、監視対象を実行結果が書き換えると再発火し、制御を誤ると無限ループや過剰発火を招く
Declare Trigger とは — 永続化の確定に反応する
Declare Trigger は、インスタンスがデータベースに保存・コミットされるイベント(作成・更新・削除・保存など)を契機に実行される宣言的ルールです。反応の起点は インメモリの変化ではなく、永続化が確定したこと です。
だからこそ Trigger は、確定を前提にした副作用 に向いています。監査ログの記録、外部システムへの連携、確定データを起点にした派生データの更新——いずれも「一時値ではなく、確定した状態」を対象にしたい処理です。保存されて初めて意味を持つ後処理は、インメモリの変化ではなく永続化イベントを起点にすべきで、それが Trigger の役割です。
重要なのは、Trigger は 実行タイミングを指定できる 点です。「保存のたびに」なのか「コミット時に」なのか、といった契機を選べます。指定を誤ると、まだ確定していないのに動いてしまう二重処理や、後続でロールバックが起きたときの不整合を招きます。
指定可能なイベントの種類や、保存単位・コミット単位といったタイミングの粒度は Pega のバージョンによって異なります。実装時は利用中の版の公式ドキュメントで、選択できる契機と既定の挙動を必ず確認してください。
判断軸:即応か、確定起点か
両者を分ける本質的な問いは、繰り返しになりますが「処理中の変更に即応したいのか、確定した永続化を起点にしたいのか」です。表で整理します。
| 判断ポイント | Declare OnChange | Declare Trigger |
|---|---|---|
| 反応する契機 | クリップボード上の値変化(インメモリ) | DB への保存・コミット(永続化) |
| 起動タイミング | 処理中・確定前 | 永続化の確定時 |
| 監視対象 | プロパティの値 | インスタンスの保存イベント |
| 向いている処理 | 画面内の派生・連動計算、即時の再計算 | 監査ログ・外部連携・派生データ更新 |
| データの状態 | 一時値(未確定を含む) | 確定済み |
| 典型的な事故 | 無限ループ・過剰発火・一時値への反応 | 二重処理・ロールバック時の不整合 |
| default 判断 | 確定を待てない即時反応はこちら | 確定後の副作用はこちら |
確定してから動かして問題ないなら Trigger、確定を待てず変更の瞬間を捕まえたいなら OnChange——これが実務での判断の型です。迷ったら「この処理は、値がまだ確定していなくても走ってよいか?」を自問してください。答えが「いいえ」なら、ほぼ Trigger 側です。
具体例で見る使い分け
- 入力に応じた画面内の再計算(数量×単価で小計を出す、区分に応じて表示を切り替える) → 確定を待たず即応したい。OnChange(ただし派生値の算出は Declare Expression のほうが素直な場面も多い。後述)。
- 監査証跡の記録(誰が・いつ・何を確定したか) → 保存された事実を残す処理なので確定起点。Trigger。
- 外部システムへの連携通知(契約確定を基幹システムへ送る) → 未確定の状態を送ってはいけない。Trigger。
- 確定データを起点にした派生データ更新(保存後に集計テーブルへ反映する) → 確定を前提にすべき。Trigger。
- 削除に伴う後処理(関連データのクリーンアップ、削除ログ) → インスタンスの削除イベントが契機。Trigger。
見分け方はシンプルで、「その副作用は 確定した事実 を相手にしているか、それとも 入力途中の反応 か」です。確定した事実(保存・コミット・削除)が相手なら Trigger、入力途中の即応が相手なら OnChange を選びます。
よくある失敗
Declare OnChange と Trigger の事故は、経験上いくつかの典型に収束します。
失敗1:OnChange が監視対象を書き換えて無限ループする
最も多い事故です。OnChange のアクティビティが、その OnChange が監視しているプロパティ自身(や連動する別プロパティ)を書き換えると、その書き換えがまた OnChange を発火させ、連鎖します。結果として無限ループや、意図しない過剰発火を招きます。監視対象と更新対象を明確に分ける、更新前後で値が変わらないなら書き込まない、といったガードを設計段階で組み込む必要があります。
失敗2:確定前の一時値に反応して不整合を生む
OnChange はトランザクションが確定していない中間状態にも反応します。まだコミットされていない一時値を前提に外部連携や派生データ更新を走らせると、後続の処理でその値が変わったり、ロールバックされたりしたときに、外部やレポートだけが古い・誤った状態で残ります。確定を前提にすべき副作用を OnChange でやってはいけません。 それは Trigger の仕事です。
失敗3:Trigger の実行タイミング指定を誤る
Trigger は「保存のたび」か「コミット時」かなど契機を指定できますが、ここを取り違えると事故ります。1 トランザクション中に複数回保存が走る設計で「保存のたび」に外部連携を掛ければ二重処理になり、コミット前提の処理を早すぎるタイミングに置けばロールバック時に取り消せない副作用が残ります。指定できる契機と、自分のトランザクション境界がどこにあるかをセットで把握してから設定してください。
失敗4:宣言的ルールを多用してデバッグ不能にする
OnChange のような「勝手に発火する」ルールは、便利なぶん処理の流れが暗黙化します。数を増やすほど「今なぜこの処理が動いたのか」が追いづらくなり、障害調査のコストが跳ね上がります。宣言的な副作用は必要な箇所に絞り、発火条件を明示的に保つことが保守性を守ります。
迷ったら発火契機(インメモリの値変化か、永続化の確定か)に立ち返る。この 1 点を取り違えなければ、上記の失敗の大半は避けられます。
版による推奨の変化 — 代替手段も検討する
前提として、これらの宣言的ルールは「使えるから使う」ものではありません。Pega のバージョンによって推奨は変化しており、特に新しめの版や Constellation では、ケースライフサイクルやデータ伝播(プロパゲーション)による代替が推奨される場面 が増えています。
- 派生値の算出なら、OnChange でアクティビティを走らせるより Declare Expression で宣言的に定義するほうが素直で追いやすいことが多い(Declare Expression と Data Transform の使い分け も参照)
- 確定を起点にした後処理なら、ケースライフサイクルのステップやユーティリティとして流れの中に明示的に置くほうが、Trigger の暗黙発火より可視性が高い場面がある
- 外部連携は、確定起点であること(Trigger 相性)に加えて、再送や重複への耐性(連携の冪等性設計)まで含めて設計する
OnChange の多用がデバッグ困難化を招くのは前述のとおりで、まず「そもそもこの副作用を宣言的な発火に頼るべきか、ライフサイクルやデータモデルで表現できないか」を検討し、それでも発火契機で捉えるのが最適なときに OnChange / Trigger を選ぶ——という順序が安全です。指定可能なイベントや代替手段の詳細は版によって異なるため、利用中の版の公式ドキュメントで確認してください。
まとめ
- Declare OnChange と Trigger は、反応する契機が根本的に違う。 OnChange はクリップボード上の値変化(インメモリ)、Trigger はDB への保存・コミット(永続化の確定)
- 判断の起点は 1 問——「確定を待てず即応したい」か「確定した永続化を起点にしたい」か。確定後の副作用(監査・外部連携・派生更新)は Trigger 寄り
- 失敗の型は決まっている——OnChange の無限ループ、確定前の一時値への反応、Trigger のタイミング指定ミスによる二重処理/ロールバック不整合、そして宣言的ルールの多用によるデバッグ困難化
- 版によって推奨は変わる。まずライフサイクルや Declare Expression・データ伝播で表現できないかを検討し、発火契機で捉えるのが最適なときに OnChange / Trigger を選ぶ
「インメモリの変化か、永続化の確定か」——この 1 問を設計の最初に言語化しておくだけで、後工程の不整合調査やループ障害を未然に防げます。イベント駆動ロジックは強力なぶん暗黙化しやすいので、発火契機を明示する型としてチームで共有しておく価値があります。
関連リンク
- Pega Platform 開発支援
- Declare Expression と Data Transform の使い分け
- Pega 監査証跡(Audit Trail)の設計
- Pega 連携の冪等性設計
- Pega Queue Processor と Job Scheduler の使い分け|イベント駆動とスケジュール駆動の設計判断
- 無料相談に申し込む
このテーマの記事をまとめて読む: Pega のデータモデルとルール設計 用語は Pega 用語集 で引けます
関連記事
Pega Process AI の予測をケースに組み込む判断|適応モデルと決定ルールの使い分け
ケースの振り分けや優先度づけを「予測に任せるか、ルールで決め切るか」は、多くの実装で迷う分岐点です。本記事では Pega Process AI の予測をどこに、どう組み込むべきかを、モデル選定・フォールバック設計・運用監視の観点から整理し、実装者が具体的に判断できる形にまとめます。
記事を読むPega 日時・タイムゾーン設計|DateTime と Date の使い分けと UTC 保存の落とし穴
「登録日が1日ずれる」「バッチの集計時刻が合わない」——多言語・多地域展開の Pega アプリで LSA が必ず直面するのが日時とタイムゾーンの設計だ。DateTime を UTC で保存し表示で現地時刻へ変換するモデルを理解せず、暦上の日付まで DateTime にしてしまうと、タイムゾーン変換で日付が前後する。プロパティ型の選択基準から整理する。
記事を読むPega ケース移行の設計判断|進行中ケースを移すか切替後に新規作成か
「旧システムの進行中案件をPegaへそのまま移せますか?」— レガシー移行で必ず出るこの問いに、LSAは安易に頷けない。過去フローの完全再現はほぼ不可能で、現在ステージと業務データの再現に絞るのが定石だ。本記事はオープンケース移行と切替後新規作成の分岐、SLA・アサインメント・監査履歴の扱い、段階移行とビッグバンの判断を、失敗例とともに整理する。
記事を読む