データページの各データソースのエラー処理を指定するには、データトランスフォームを使用します。 このデータトランスフォームは、アプリケーションの複数のデータソースとデータページで使用できます。 たとえば、アクティビティデータソースでは、同じデータトランスフォームを使用してデータページエラーを処理できます。
Pega Platformでは、データページエラーを処理するためのさまざまな方法が提供されています。 データページは本質的に宣言型のため、エラー処理はデータページのロードプロセスに含める必要があります。 ベストプラクティスとして応答データトランスフォームを使用し、データソースのタイプを検出して、エラーを適切に処理します。
-
Dev Studioのナビゲーションパネルで「Records」をクリックします。
-
「Data Model」カテゴリーを展開し、「Data Page」をクリックします。
-
データページの名前をクリックして開くか、新しいデータページを作成します。
詳細については、「Creating a data page」を参照してください。 -
「Definition」タブの「Data Sources」セクションで、「Source」フィールドでデータソースの種類を特定します。
エラーハンドラーではソリューションをカスタマイズできるように、接続されているデータソースタイプを識別できるようにしておく必要があります。 データソースを識別するには、各データソースについて応答データトランスフォームまたはアクティビティステップを使用します。- Connector:応答データトランスフォームを使用して、コネクターデータソースエラーを検出して処理します。
- Report definition:応答データトランスフォームを使用して、レポートディフィニッションデータソースエラーを検出して処理します。
- Lookup:応答データトランスフォームを使用して「Run response data transform on error」チェックボックスを選択し、ルックアップデータソースエラーを検出して処理します。
- Data transform:「hasMessages」when条件を使用し、データトランスフォームデータソースエラーを検出して処理します。
- Activity:アクティビティステップで「StepStatusFail」などの適切な遷移条件を使用して、アクティビティデータソースエラーを検出して処理します。
-
エラーハンドラーを作成するには、デフォルトのデータトランスフォーム「pxErrorHandlingTemplate」を最上位のクラスとルールセットに保存して、データトランスフォームを作成します。
例: デフォルトのデータトランスフォームを「MyCoErrorHandlerMaster」として保存できます。-
Dev Studioのヘッダーで、「pxErrorHandlingTemplate」データトランスフォームを検索して選択します。
-
データトランスフォームで「Save as」をクリックし、データトランスフォームを最上位のクラスとルールセットに保存します。
詳細については、「Configuring a data transform」を参照してください。 -
データページから、パラメーター(たとえば、「Connector-GetCustomerData」)を応答データトランスフォームに渡して、データページのロードに使用されるデータソースを一意に識別します。
-
各応答データトランスフォームの「Definition」タブで、when条件「pxDataPageHasErrors」を使用してデータページのエラーを識別し、「MyCoErrorHandlerMaster」データトランスフォームを適用します。
詳細については、「Data transform actions for Clipboard」を参照してください。 -
「MyCoErrorHandlerMaster」データトランスフォームで、デシジョンテーブルを作成して呼び出し、データソースに基づいて適切なエラー処理を決定します。
詳細については、「Creating decision tables」を参照してください。 -
デシジョンテーブルに基づいて、「MyCoErrorHandlerMaster」データトランスフォームでデータソースのエラー処理アクションを実行します。
-
「MyCoErrorHandlerMaster」データトランスフォームで、デシジョンテーブルを作成して呼び出し、デフォルトのエラーメッセージの代わりにユーザーフレンドリーなエラーメッセージをマッピングします。
詳細については、「Creating decision tables」を参照してください。
補足:- 特定の要件に応じて、フロー、フローアクション後処理、またはアクティビティで他の呼び出しエラーを手続き的に処理します。
詳細については、「Understanding invocation errors」を参照してください。
- データページエラー中に手動で再試行する必要があるユースケースでは、データページルールフォームの「Load Management」タブの「Do not reload when」フィールドの「hasNoMessages」when条件の使用を検討してください。 データページエラーが発生するたびに、再試行時にデータページが再ロードされます。
- Data PageとData Transformルールをトレースするには、ルールフォームから直接Tracerツールを開きます。
- 非同期で読み込まれる日付ページをトレースするには、Data PageルールからTracerツールを開きます。
補足: このデータトランスフォームは、アプリケーションの複数のデータソースとデータページで使用できるようになりました。 たとえば、アクティビティデータソースでは、同じデータトランスフォームを使用してデータページエラーを処理できます。 -