Pega バリデーション設計|クライアント検証とサーバー検証の使い分けとUX
「必須チェックはどこに書くべきか」「フォーマットはクライアント、業務ルールはサーバーでいいのか」——Pega のバリデーションは複数の仕組みが重なり、置き場所を誤ると UX 低下とセキュリティホールを同時に招きます。本記事では各検証ルールの適用範囲と、即時性・再利用性・堅牢性のトレードオフから最適な配置を導きます。
結論から:クライアントは「即時フィードバック」、サーバーは「信頼境界」
Pega でフォームやケースを設計していると、「この必須チェックはどこに書くべきか」「フォーマットはクライアント、業務ルールはサーバーでいいのか」という判断が必ず出てきます。Pega にはバリデーションの仕組みが複数あり、それらが重なって動くため、置き場所を誤ると UX の低下とセキュリティホールを同時に招く という厄介な性質があります。
結論を先に言うと、判断の軸は 2 つに分かれます。
クライアント側の検証は「即時フィードバックで UX を高める」ためのもの。サーバー側の検証は「業務ルール・権限・整合性を保証する信頼境界」。UX のためにクライアントで検証してよいが、業務・権限に関わる検証は必ずサーバーで再実行する。
「クライアントで弾いているからサーバーは省略していい」は誤りです。クライアント検証はあくまで体験のためであり、セキュリティ境界にはなりません。本記事では、この原則を Pega の具体的なルール(Edit Validate・Validate ルール・宣言的 Constraints・When 条件)に落とし込み、どこに何を置くかを判断できる型にします。
Pega のバリデーションは「複数の仕組みの重なり」
Pega のバリデーションが分かりにくいのは、目的も適用範囲も実行場所も異なる仕組みが複数あり、それらが重なって効くからです。まずは代表的な 3 つを、役割の違いで整理します。
Edit Validate — 単一プロパティの形式検証(再利用可能)
Edit Validate は、単一プロパティに対する形式・値域の検証ルールです。「郵便番号の形式」「電話番号のパターン」「数値が一定範囲内か」といった、そのプロパティ単体で完結するチェックに向きます。Pega では、この Edit Validate による形式チェックがクライアント側の即時フィードバック(ユーザーがフィールドから移動した瞬間の検証)の中心的な担い手として位置づけられています。
最大の特徴は 再利用性 です。一度定義すれば、同じ形式チェックを複数の画面・複数のプロパティに使い回せます(Pega には標準の Edit Validate ルールも多数用意されており、そのまま使うかコピーして調整できます)。逆に言うと、Edit Validate は「1 つのプロパティの値だけ」を見る前提の仕組みなので、他のフィールドの値を条件にした検証(クロスフィールド)や、条件付きの必須チェックには向きません。ここを無理に押し込むと、後述するアンチパターンに陥ります。
なお、Edit Validate は Validate ルールから呼び出すこともでき、その場合は入力の都度ではなくフォーム送信時にサーバー側で評価されます。つまり Edit Validate は「クライアントの即時フィードバック」と「サーバー側の再評価」の両方に使える部品で、どちらで効かせるかは呼び出し方で決まる、と捉えると混乱しません。
Validate ルール — 複数プロパティをサーバー側で検証する(When 条件付き)
Validate ルール は、複数プロパティをまとめてサーバー側で検証する仕組みです。1 つ以上のプロパティに対して検証条件を並べて定義でき、When 条件を付けて「この条件のときだけ、この項目を必須にする」「A が選ばれたら B と C の整合を確認する」といった、業務ルールに踏み込んだ検証を表現できます(ケースのステータスやフローアクション、ユーザー操作などを条件に、検証を切り替えられます)。
Edit Validate との違いは、対象範囲と実行場所 です。Edit Validate は単一プロパティの形式検証、Validate ルールは複数プロパティ・条件付きの業務検証で、フォーム送信時にサーバー側で実行されます。単純化すると、「形は Edit Validate、業務ルールと項目間の整合は Validate ルール(+ When)」という役割分担になります。
宣言的 Constraints — 「書き忘れ」を仕組みで防ぐ
宣言的 Constraints(Constraints ルール) は、プロパティの制約を宣言的に定義しておくと、そのプロパティの値が変わるたびに自動的に評価・強制される仕組みです(Pega は制約に関与するプロパティが変更されるたびに評価を行い、制約を満たさない場合は該当ページを無効としてメッセージを付与します)。手続き的な検証呼び出しと違い、開発者が「ここで検証を呼ぶのを忘れた」という漏れが起きにくいのが利点です。検証ロジックを画面やフローの各所に散らすのではなく、データ側に一元的に宣言できます。
ただし宣言的である以上、いつ発火するか(実行タイミング)を理解していることが前提になります。宣言的 Constraints は「プロパティが変更されたら強制される」ものなので、どのタイミングでプロパティが更新され、どこで制約が効くのかを押さえずに使うと、「効くはずの検証が効かない/想定外のタイミングで効く」といった混乱の元になります。仕組みの強力さと引き換えに、動作モデルの理解が求められる、と捉えてください。
クライアント検証とサーバー検証をどう分担させるか
3 つの仕組みを踏まえたうえで、最上位の判断軸に戻ります。それが「クライアント検証か、サーバー検証か」です。両者は排他ではなく、役割を分担して両方使うのが正解です。
クライアント側の検証は、ユーザーが入力しているその場で「形式が違う」「必須が未入力」を知らせ、送信前に気づかせるためのものです。これは UX を大きく左右します。一方で、クライアント側は原理的に改ざんや迂回が可能で、セキュリティ境界にはなりません。権限に基づく可否、業務ルールに基づく整合性、金額や在庫のような「壊れると困る」検証は、クライアントで弾いていても サーバー側で必ず再実行します。
| 観点 | クライアント側検証 | サーバー側検証 |
|---|---|---|
| 主な目的 | 即時フィードバック(UX 向上) | 業務ルール・権限・整合性の保証 |
| 実行場所 | ブラウザ | Pega サーバー |
| セキュリティ境界 | ならない(迂回・改ざん可能) | なる(信頼できる最終防衛線) |
| 主に使うもの | Edit Validate(形式)の即時チェック | Validate ルール・宣言的 Constraints・When |
| 権限/業務ルール | 置かない(置いても再検証必須) | ここで必ず実行する |
| 省略してよいか | UX 補助なので状況次第 | 省略不可 |
表の最下段が最重要です。クライアント検証は UX のための補助なので状況によって省けるが、サーバー検証は省略できません。 「クライアントで弾いているからサーバーは省く」は、そのまま脆弱性になります。
検証ルールの使い分け早見表
「何を検証したいか」から「どのルールを使うか」を引ける早見表です。実装時はまずこの対応で当たりをつけます。
| 検証したいこと | 使うルール | 実行場所の原則 |
|---|---|---|
| 単一プロパティの形式・値域(郵便番号・範囲など) | Edit Validate | 形式は即時フィードバック可、業務影響があればサーバーでも |
| 条件付きの必須(A のとき B は必須) | When 条件 + Validate ルール | サーバー側 |
| 複数フィールドの整合(開始日 < 終了日 など) | Validate ルール(+ When) | サーバー側 |
| 「書き忘れ」を避けたいデータ制約 | 宣言的 Constraints | プロパティ変更時に自動強制 |
| 権限・業務ルールに関わる可否判断 | サーバー側ロジック(+ Validate) | 必ずサーバー側 |
ポイントは、必須やクロスフィールドの条件を Edit Validate に押し込まないことです。Edit Validate は単一プロパティの形式検証の仕組みなので、条件付き必須や項目間の整合は When ルール/式や Validate ルールで表現します。役割の合わない仕組みに機能を詰め込むと、再利用性が壊れ、保守もしづらくなります。
具体例で見る配置判断
- 郵便番号の形式チェック → 単一プロパティの形式検証。Edit Validate で定義し、クライアント側で即時フィードバックすると入力体験が良い。
- 「法人区分=法人」のとき法人名を必須にする → 他フィールドの値を条件にした条件付き必須。When + Validate ルールでサーバー側に置く。Edit Validate では表現しない。
- 開始日と終了日の前後関係 → 複数プロパティの整合。Validate ルールでサーバー側に置く。UX のためクライアントでも同等チェックを出してよいが、確定判断はサーバー。
- 金額が承認上限を超えていないか → 業務ルール・権限に関わる。必ずサーバー側で検証する。クライアントでの事前表示は補助にすぎない。
- ステータス遷移の整合(この状態からこの状態へは遷移不可) → 業務整合性。宣言的 Constraints やサーバー側ロジックで担保し、クライアント任せにしない。
見分け方はシンプルです。「それは体験のためのチェックか、それとも壊れると困るチェックか」。前者はクライアントで即時に、後者はサーバーで確実に。そして後者はクライアントで先に出しても構いませんが、サーバーでの再検証を省いてはいけません。
よくある失敗
バリデーション設計の失敗は、経験上いくつかの決まったパターンに集約されます。
失敗1:送信後にまとめてエラーを出す
後処理(送信後のサーバー検証)でしか検証しないと、ユーザーが全項目を入力し終えて送信した瞬間に、エラーがまとめて一気に表示されます。どこを直せばいいのか分かりづらく、入力し直しの往復が増え、UX が大きく悪化します。フィールド単位・入力時点のフィードバックを優先し、送信時のサーバー検証は「最後の砦」として位置づけます。入力しながら気づけるかどうかで、フォームの体感品質はまったく変わります。
失敗2:クライアント検証だけで業務ルールを守ったつもりになる
「クライアントで弾いているから大丈夫」は最も危険な思い込みです。クライアント側は迂回・改ざんが可能で、セキュリティ境界になりません。権限・金額・在庫・業務整合といった検証をクライアントだけに任せると、そのまま脆弱性になります。業務・権限に関わる検証は、クライアントで弾いていてもサーバーで必ず再実行します。UX のためのクライアント検証と、信頼境界としてのサーバー検証は、目的が違う別物として両方用意するのが正解です。
失敗3:クロスフィールド条件を Edit Validate に押し込む
「条件付き必須」や「項目間の整合」を、単一プロパティ用の Edit Validate に無理やり詰め込むパターンです。Edit Validate は他フィールドを見る前提の仕組みではないため、実装が歪み、再利用性という Edit Validate 本来の利点も失われます。必須やクロスフィールドの条件は When ルール/式や Validate ルールで表現し、Edit Validate は単一プロパティの形式検証に徹させます。
失敗4:クライアントでどこまで検証できるかを確認せずに設計する
「この形式チェックはクライアントで即時に出る」と決め打ちで設計したものの、対象環境では期待どおりに動かない、というケースです。クライアントでどこまで検証を実行できるかは、Pega の版と UI フレームワーク(Constellation か従来 UI か)によって異なります。 従来 UI では、ハーネス側でクライアントサイド検証を有効化したうえで、Edit Validate に相当する JavaScript がブラウザで実行される、という前提がありました。Constellation は UI アーキテクチャそのものが異なるため、同じ挙動を当てにできるとは限りません。「即時フィードバックが出る前提」で UX を設計する場合は、必ず対象環境・対象バージョンで実際の挙動を確認してから固めてください。想定した即時性が出ないと、UX 設計そのものが崩れます。
まとめ
- バリデーションは 2 層で考える。 クライアント=即時フィードバックで UX、サーバー=業務・権限・整合性の信頼境界。
- 業務・権限に関わる検証は、クライアントで弾いていてもサーバーで必ず再実行する。 クライアントはセキュリティ境界にならない。
- ルールは役割で選ぶ。 単一プロパティの形式は Edit Validate(再利用可・クライアント即時フィードバックの担い手)、複数プロパティ・条件付きは Validate ルール(+ When、サーバー側)、書き忘れを避けたいデータ制約は宣言的 Constraints。宣言的 Constraints は実行タイミングの理解が前提。
- 必須やクロスフィールドは Edit Validate に押し込まない。 When ルール/式で表現する。
- 送信後にまとめてエラーを出さない。 フィールド単位・入力時点のフィードバックを優先する。
- クライアントの検証範囲は版と UI フレームワークで変わる。 対象環境で挙動を確認してから UX を設計する。
バリデーションの置き場所は、UX とセキュリティという「両立が難しいもの」を同時に左右する設計判断です。ここを「即時性はクライアント、信頼はサーバー」という型で最初に言語化しておくと、フォーム体験の質と堅牢性を両取りでき、後工程での作り直しを防げます。
関連リンク
このテーマの記事をまとめて読む: Pega Constellation と画面設計 用語は Pega 用語集 で引けます
関連記事
Pega Constellation 移行の進め方|Cosmos からの段階移行と並行運用の判断
Constellation への移行は『スイッチを入れれば終わり』ではありません。view/template から画面を自動生成する思想ゆえ、Cosmos で作り込んだカスタムセクションや独自コントロールは再構築が前提になります。本記事では、一括切替か段階移行か、どこで並行運用の線を引くか、着手前に何を棚卸しすべきかを、LSA が実務で下す判断として整理します。
記事を読むPega の ABAC でフィールド単位のアクセス制御を実現する
Pega で「特定の項目を特定の役割にだけ見せる」を実現する ABAC(属性ベースアクセス制御)を、Access Control Policy・PropertyRead マスキング・RBAC との補完関係の観点から解説します。
記事を読むPega Constellation UI で「できないこと」と現実的な回避策
Pega Constellation UI で実装時に直面する「できないこと」——アサインメント画面のボタン・連続画面・List view の列など——と、標準の枠内での現実的な回避策を実装経験からまとめます。
記事を読む