Pega Savable Data Page 設計|外部システムへの書き戻しとコネクタ直呼びの使い分け
「データページは読み取り専用」という前提は、Savable Data Page を使うと変わる。読み書きを同じデータ仮想化レイヤに集約できる一方、保存は自動では走らず、コミット境界やエラー処理を誤ると『保存したつもり』の未反映や部分保存を招く。どこまでを Savable Data Page に任せ、どこからをフロー内のコネクタ直呼びにするかを整理する。
結論から:読み書きを同じ抽象に寄せたいなら Savable Data Page、細かく制御したいならコネクタ直呼び
Pega のデータページ(Data Page)は、外部システムからデータを読み込んでキャッシュする仕組みとして広く使われます。ここで見落とされがちなのが、データページは既定で読み取り専用であるという事実です。読み込んだ内容を編集しても、そのままでは元の System of Record(SoR)には返りません。書き戻すには Savable Data Page(保存可能データページ) を使い、Save-DataPage メソッドや保存ステップで 明示的に 保存を呼ぶ必要があります。
結論を先に言うと、判断の起点はシンプルです。
読み書きを同じデータページの抽象に集約したい(データ仮想化を「読み」だけでなく「書き」にも対称に効かせたい)なら Savable Data Page。ステップ単位でトランザクションやエラーを細かく制御したいなら、フロー内でコネクタを直呼びするかアクティビティで書く。
そして、大量・高頻度の書き込みや厳密なトランザクション制御が要るなら、どちらでもなく専用の統合ステップやキュープロセッサを検討する——これが実務での型です。本記事では、この分岐と、Savable Data Page を安全に使うためのコミット境界・スコープ・エラー処理を整理します。
データページは既定で読み取り専用 — Savable Data Page で何が変わるか
通常のデータページは「読み込み専用(Read-Only)」です。データソースとして REST コネクタや Report Definition、Lookup などを指定し、参照されたタイミングで SoR からデータを取得してキャッシュします。ケース側でそのページのプロパティを書き換えても、それは Pega 内のクリップボード上の変更にすぎず、元の SoR には何も返りません。データ仮想化としては「読み」の方向だけが実装されている状態です。
Savable Data Page は、この読み取り専用ページに 保存プラン(Save Plan) を定義したものです。Pega が用意する保存プランは 3 種類——Database save(SoR が Pega のデータベースの場合に書き込む)、Connector(コネクタ経由で外部システムに保存・永続化する)、Activity(任意の連携ロジックを組み、その中で REST/SOAP などのコネクタを呼んで任意のシステムへ永続化する)——で、このいずれかを紐づけます。これにより、「そのデータページに読み込んだ内容を SoR へ返す」という書き方向が、同じデータページの抽象の中で定義されます。読みと書きが同じ入り口に揃うため、呼び出し側は「このエンティティはこのデータページで読み書きする」という一貫したメンタルモデルで扱えます。
ただし決定的な注意点があります。保存は自動では走りません。 データページの内容を変更しても、Pega が勝手に SoR へ書き戻すことは一切ありません。書き戻しの起動口は公式に 3 つ——フローアクションの後処理(postprocessing)で保存対象のデータページを列挙する、フロー内で「Save Data Page」スマートシェイプを置く、アクティビティで Save-DataPage メソッドを呼ぶ——で、いずれかを 明示的に 呼んだときだけ実行されます。「Savable にしたのに保存されない」という相談の多くは、この「明示的に呼ぶ」が抜けているだけ、というのが実情です。
Savable Data Page とコネクタ直呼びの使い分け
では、書き戻しを Savable Data Page に任せるか、フロー内でコネクタを直呼び(あるいはアクティビティで実装)するか。判断軸は「抽象の対称性を取りたいか、ステップ単位の制御を取りたいか」です。
- Savable Data Page が向くケース — 同じエンティティを複数の場所から読み書きし、その入り口をひとつに揃えたい。読みで使っているデータページと同じ抽象で書きもしたい。「データアクセスの窓口はデータページに統一する」という設計方針をチームで敷いている。こうした場合、Savable Data Page は再利用性が高く、呼び出し側のコードもシンプルになります。
- コネクタ直呼び/アクティビティが向くケース — 書き戻しのタイミング・順序・失敗時の分岐を、フローのステップとして 細かく制御 したい。たとえば「A を更新し、成功したら B を更新し、片方が失敗したら両方を巻き戻す」といった手続き的な制御が要る場面です。データページという宣言的な器よりも、フローステップやアクティビティのほうが制御の解像度が高くなります。
判断早見表
| 判断ポイント | Savable Data Page | コネクタ直呼び/アクティビティ |
|---|---|---|
| 抽象の性質 | 読み書きを同じデータページに集約(対称な仮想化) | ステップ単位の手続き的な書き戻し |
| 再利用性 | 高い(複数箇所から同じ入り口) | 呼び出し箇所ごとに実装 |
| 制御の解像度 | 保存単位でまとめて実行 | ステップごとに順序・分岐・巻き戻しを制御 |
| トランザクション制御 | 即時/遅延(deferred)を構成で選ぶ | ステップとコミットを自分で設計 |
| 向いている場面 | 窓口統一、読みと同じ抽象で書く | 複雑な順序制御、条件分岐、部分ロールバック |
| 大量・高頻度書き込み | 不向き | これも不向き(キュープロセッサを検討) |
表の最終行のとおり、大量・高頻度の書き込みや厳密なトランザクション制御は、そもそもこの 2 択の外です。詳細は後述します。
保存は自動では走らない — コミット境界の理解
Savable Data Page でもっとも事故が起きやすいのが コミット境界 です。Save-DataPage を呼んでも、それが即座に SoR へ永続化されるとは限りません。保存の実行タイミングは、即時実行するか、呼び出し元のトランザクションに乗せてコミット時まで遅延させるか を構成で選べます。具体的には、フローやフローアクションから保存を起動した場合は Pega がトランザクションを自動管理し、アクティビティから Save-DataPage を呼ぶ場合は WriteNow パラメータで「独立したトランザクションとして即時に書き込む(WriteNow = true)」か「呼び出し元のトランザクションと一緒にコミットさせる」かを選べます。
遅延(deferred)を選んだ場合、Save-DataPage の呼び出しは「保存を予約する」だけで、実際の書き戻しは後続の コミット のタイミングでまとめて走ります。ここを理解していないと、「保存メソッドは通ったのに SoR に反映されていない」——つまり 『保存したつもりで未コミット』 という典型的な失敗に陥ります。逆に、複数の保存を 1 つのコミットにまとめてトランザクション的に扱いたいなら、遅延はむしろ望ましい挙動です。
保存タイミングのオプション名や既定の挙動、コミットとの関係はバージョンによって異なります。「即時なのか遅延なのか」「どこがコミット境界なのか」は、利用中の版の公式ドキュメントで必ず確認し、設計文書に明記してください。挙動を推測で決め打ちしないことが、この種の事故を防ぐ最短路です。
実務では、「保存を呼ぶステップ」と「コミットが起きるステップ」を設計図の上で分けて描き、どのタイミングで SoR に反映されるのかをチームで共有しておくことをおすすめします。
書き戻すデータページのスコープ — なぜ Thread が基本か
Savable Data Page は、読み込んだ値をユーザーが編集し、それを SoR へ書き戻す 読み書き(read-write) のデータページです。ここで最初に押さえるべきは スコープの制約 です。Pega では 編集可能(Editable)・保存可能(Savable)なデータページに設定できるスコープは Thread か Requestor のみで、Node スコープは選べません(Infinity ‘25 時点。データページのスコープ選択肢は Thread/Requestor/Node の 3 つですが、Node は読み取り専用ページ専用で、リフレッシュ戦略も保存プランも持てるのは Thread・Requestor スコープのページだけ、という制約が公式に定義されています)。つまり「編集可能データページを Node スコープに置いてノード全体で共有してしまう」という設計ミスは、そもそも製品側で起こせないようになっています。
残る選択は Thread か Requestor です。基本は Thread スコープ です。Thread スコープはユーザーの 1 つの操作単位(スレッド)ごとに独立したインスタンスを持つため、編集中の値が別スレッド・別ユーザーに漏れることがありません。一方 Requestor スコープ は、同一リクエスタ(=同一ユーザーセッション)の すべてのスレッドで 1 インスタンスを共有 します。1 人のユーザーが複数の作業(複数タスク)を並行して開いていると、片方の編集がもう片方に波及し、意図しない上書きや不整合を招くことがあります。したがって 編集・保存する前提のデータページは Thread スコープを既定 とし、Requestor スコープはインスタンスをスレッド間で共有してよいと確信できるときだけに限定するのが安全です。なお、複数ユーザー間で 1 インスタンスを共有する Node スコープの読み取り専用キャッシュ は有効な場面がありますが、それはあくまで書き戻しをしないページの話です。
データページの種類(Read-Only/Editable/Savable)とスコープ(Thread/Requestor/Node)の組み合わせで挙動が決まる点は、Pega データページの種類とスコープ設計 で詳しく整理しています。書き戻しを設計する前に、まずこの組み合わせを押さえておくと判断がぶれません。
保存失敗のハンドリング — 部分保存・サイレント失敗を防ぐ
書き戻しは外部システムへの更新であり、失敗する前提 で設計します。保存データソースの呼び出しが失敗したときの挙動を設計していないと、次のような事故が起きます。
- サイレント失敗 — 保存が失敗したのにケースはそのまま先へ進み、SoR には何も反映されていない。ユーザーもオペレータも失敗に気づかない。
- 部分保存 — 複数のデータページを順に保存する途中で一部が失敗し、SoR に「A だけ反映され B は未反映」という不整合な状態が残る。
これを防ぐには、保存の直後に結果を検証するステップを必ず入れる ことが基本です。保存データソースが返すステータス・エラーを受けて、失敗ならケースをエラー分岐に流す、リトライする、あるいは補償処理(すでに書いた分を打ち消す)を走らせる、といった経路を設計に組み込みます。「保存を呼んだら成功しているはず」という暗黙の前提こそが、部分保存とサイレント失敗の温床です。
また、リトライを入れる場合は 二重処理 に注意が必要です。ネットワークやキューのリトライは基本的に at-least-once(最低 1 回、つまり複数回起こりうる)で動くため、同じ保存が二重に実行される可能性があります。書き戻し先で二重登録・二重更新が起きないよう、冪等性を意識した設計が要ります(詳しくは Pega 連携の冪等性設計 を参照)。
Savable Data Page が不向きなケース
最後に、そもそも Savable Data Page を使うべきでない場面を明確にしておきます。次のような要件では、Savable Data Page はミスマッチです。
- 大量・高頻度の書き込み — 1 件ずつ同期的に SoR へ書き戻す設計は、件数が増えるとユーザー応答性を著しく損ないます。
- 厳密なトランザクション制御 — 複数システムをまたいだ整合性保証や、複雑なロールバックが要る処理。
- 相手システムが遅い・落ちる可能性がある連携 — 同期書き戻しはケースの処理をブロックし、相手が遅いだけでユーザーを待たせます。
こうしたケースでは、書き戻しを 専用の統合ステップやキュープロセッサ(非同期処理)に逃がす のが定石です。ユーザー応答を止めずにバックグラウンドで確実に処理でき、リトライやスループット制御も設計しやすくなります。同期コネクタと非同期キュープロセッサのどちらに寄せるかの判断軸は、Pega 連携は同期か非同期か で整理しています。
よくある失敗
保存メソッドを呼び忘れ、「Savable にしたのに保存されない」。 最頻の失敗です。Savable Data Page は保存データソースを定義しただけでは書き戻しません。Save-DataPage か保存ステップで明示的に呼ぶ、というひと手間が必要です。
コミット境界を理解せず『保存したつもりで未コミット』。 遅延(deferred)保存の場合、保存メソッドが通ってもコミットまで SoR には反映されません。「呼んだ=反映された」と思い込むとここで嵌まります。設計時にコミット境界を明示しておくのが唯一の予防策です。
書き戻すデータページのスコープを取り違える。 編集・保存するデータページに設定できるのは Thread か Requestor のみ(Node は選べません)。既定は Thread。安易に Requestor にすると、同一ユーザーの複数スレッドで 1 インスタンスを共有し、並行作業で編集値が意図せず混ざります。編集・保存するデータページは Thread スコープが原則です。
保存失敗のハンドリングを設計せず、部分保存・サイレント失敗を放置する。 保存後の検証ステップを省くと、失敗に気づけません。外部更新は失敗する前提で、結果検証とエラー分岐を必ず入れます。
大量・高頻度の書き込みまで Savable で押し切る。 対称な抽象は魅力的ですが、性能とトランザクションが要件になる領域では専用の統合ステップやキュープロセッサに切り替える判断が必要です。
まとめ
- データページは 既定で読み取り専用。書き戻すには Savable Data Page に 保存データソース を定義し、
Save-DataPageか保存ステップで 明示的に 保存を呼ぶ - 読み書きを同じ抽象に集約したいなら Savable Data Page、ステップ単位で細かく制御したいならコネクタ直呼び/アクティビティ
- コミット境界を理解する。即時か遅延(deferred)かを構成で選び、遅延なら「保存したつもりで未コミット」を避けるため反映タイミングを設計文書に明記する(挙動は版により異なるので公式ドキュメントで確認)
- 編集・保存する前提のデータページに設定できるスコープは Thread か Requestor のみ(Node は不可)。既定は Thread。Requestor は同一ユーザーの全スレッドで 1 インスタンスを共有するため、並行作業での編集値の混在に注意
- 書き戻しは失敗する前提で 保存結果の検証ステップを必ず入れ、部分保存・サイレント失敗を防ぐ。リトライ時は冪等性に注意
- 大量・高頻度/厳密なトランザクションは Savable の外。専用の統合ステップやキュープロセッサを検討する
Savable Data Page は「読み書きを対称に扱えるデータ仮想化」という強力な抽象ですが、その強さは「保存を明示的に呼ぶ」「コミット境界を理解する」「失敗を設計する」という前提の上に成り立ちます。ここを設計の初期に言語化しておくことが、後工程での不整合や『保存したつもり』事故を防ぎます。
Pega の連携・データモデル設計でお困りの際は、Pega Platform 開発支援 や 無料相談 をご利用ください。Pega 認定資格の最高位 LSA(Lead System Architect)を保有するコンサルタントが、書き戻し方式の選定からエラー設計までご支援します。
関連リンク
このテーマの記事をまとめて読む: Pega のデータモデルとルール設計 用語は Pega 用語集 で引けます
関連記事
Pega 日時・タイムゾーン設計|DateTime と Date の使い分けと UTC 保存の落とし穴
「登録日が1日ずれる」「バッチの集計時刻が合わない」——多言語・多地域展開の Pega アプリで LSA が必ず直面するのが日時とタイムゾーンの設計だ。DateTime を UTC で保存し表示で現地時刻へ変換するモデルを理解せず、暦上の日付まで DateTime にしてしまうと、タイムゾーン変換で日付が前後する。プロパティ型の選択基準から整理する。
記事を読むPega 埋め込みリストのレポート設計|Declare Index と明細クラス化の判断
「ケースの明細行を横断で集計したい」— これは Report Definition だけでは解けない典型です。埋め込みページリストは DB の列ではないため、Declare Index で行として外出しするか、初めから別クラスとして持つかを設計段階で決める必要があります。後から報告要件で無理に index 化して破綻する前に、判断基準を整理します。
記事を読むPega プロパティ型選択の落とし穴|金額は Decimal・日時は DateTime で丸め誤差とタイムゾーン事故を防ぐ
「とりあえず数値だから Double」「日付だから DateTime」——この安易な型選択が、請求額の1円ずれや締め日の1日ずれとして本番で顕在化する。Pega のプロパティ型は一度データが入ると変更コストが高く、設計初期の判断がそのまま数年残る。本記事は金額・数量・日時という壊れやすい値に絞り、正しい型と落とし穴を整理する。
記事を読む