Skip to main content

データトランスフォームによるデータページエラーの処理

Pega Communityのロゴ

注: 次のコンテンツはPega Communityを参照したページで、モジュール内容の理解度を高める目的で含まれています。

データページの各データソースのエラー処理を指定するには、データトランスフォームを使用します。 このデータトランスフォームは、アプリケーションの複数のデータソースとデータページで使用できます。 たとえば、アクティビティデータソースでは、同じデータトランスフォームを使用してデータページエラーを処理できます。

Pega Platformでは、データページエラーを処理するためのさまざまな方法が提供されています。 データページは本質的に宣言型のため、エラー処理はデータページのロードプロセスに含める必要があります。 ベストプラクティスとして応答データトランスフォームを使用し、データソースのタイプを検出して、エラーを適切に処理します。

  1. Dev Studioのナビゲーションパネルで「Records」をクリックします。

  2. 「Data Model」カテゴリーを展開し、「Data Page」をクリックします。

  3. データページの名前をクリックして開くか、新しいデータページを作成します。

    詳細については、「Creating a data page」を参照してください。
  4. 「Definition」タブの「Data Sources」セクションで、「Source」フィールドでデータソースの種類を特定します。

    エラーハンドラーではソリューションをカスタマイズできるように、接続されているデータソースタイプを識別できるようにしておく必要があります。 データソースを識別するには、各データソースについて応答データトランスフォームまたはアクティビティステップを使用します。
    • Connector:応答データトランスフォームを使用して、コネクターデータソースエラーを検出して処理します。
    • Report definition:応答データトランスフォームを使用して、レポートディフィニッションデータソースエラーを検出して処理します。
    • Lookup:応答データトランスフォームを使用して「Run response data transform on error」チェックボックスを選択し、ルックアップデータソースエラーを検出して処理します。
    • Data transform:「hasMessages」when条件を使用し、データトランスフォームデータソースエラーを検出して処理します。
    • Activity:アクティビティステップで「StepStatusFail」などの適切な遷移条件を使用して、アクティビティデータソースエラーを検出して処理します。
  5. エラーハンドラーを作成するには、デフォルトのデータトランスフォーム「pxErrorHandlingTemplate」を最上位のクラスとルールセットに保存して、データトランスフォームを作成します。

    例: デフォルトのデータトランスフォームを「MyCoErrorHandlerMaster」として保存できます。
    1. Dev Studioのヘッダーで、「pxErrorHandlingTemplate」データトランスフォームを検索して選択します。

    2. データトランスフォームで「Save as」をクリックし、データトランスフォームを最上位のクラスとルールセットに保存します。

      詳細については、「Configuring a data transform」を参照してください。
      補足: ルールのステータスを「Final」から「Available」に変更します。 詳細については、「Setting rule status and availability」を参照してください。
    3. データページから、パラメーター(たとえば、「Connector-GetCustomerData」)を応答データトランスフォームに渡して、データページのロードに使用されるデータソースを一意に識別します。

    4. 各応答データトランスフォームの「Definition」タブで、when条件「pxDataPageHasErrors」を使用してデータページのエラーを識別し、「MyCoErrorHandlerMaster」データトランスフォームを適用します。

      詳細については、「Data transform actions for Clipboard」を参照してください。
    5. 「MyCoErrorHandlerMaster」データトランスフォームで、デシジョンテーブルを作成して呼び出し、データソースに基づいて適切なエラー処理を決定します。

      詳細については、「Creating decision tables」を参照してください。
    6. デシジョンテーブルに基づいて、「MyCoErrorHandlerMaster」データトランスフォームでデータソースのエラー処理アクションを実行します。

    7. 「MyCoErrorHandlerMaster」データトランスフォームで、デシジョンテーブルを作成して呼び出し、デフォルトのエラーメッセージの代わりにユーザーフレンドリーなエラーメッセージをマッピングします。

      詳細については、「Creating decision tables」を参照してください。

    補足:
    • 特定の要件に応じて、フロー、フローアクション後処理、またはアクティビティで他の呼び出しエラーを手続き的に処理します。

      詳細については、「Understanding invocation errors」を参照してください。

    • データページエラー中に手動で再試行する必要があるユースケースでは、データページルールフォームの「Load Management」タブの「Do not reload when」フィールドの「hasNoMessages」when条件の使用を検討してください。 データページエラーが発生するたびに、再試行時にデータページが再ロードされます。
    • Data PageとData Transformルールをトレースするには、ルールフォームから直接Tracerツールを開きます。
    • 非同期で読み込まれる日付ページをトレースするには、Data PageルールからTracerツールを開きます。
    補足: このデータトランスフォームは、アプリケーションの複数のデータソースとデータページで使用できるようになりました。 たとえば、アクティビティデータソースでは、同じデータトランスフォームを使用してデータページエラーを処理できます。

関連コンテンツ


トレーニングを実施中に問題が発生した場合は、Pega Academy Support FAQsをご確認ください。

このコンテンツは役に立ちましたか?

改善できるところはありますか?

We'd prefer it if you saw us at our best.

Pega Academy has detected you are using a browser which may prevent you from experiencing the site as intended. To improve your experience, please update your browser.

Close Deprecation Notice