Skip to main content

データページのエラー処理の構成

4 タスク

30 分

Visible to: All users
中級 Pega Platform 8.7 データ統合 日本語
バージョンタグがご希望のコンテンツと一致しているかご確認ください。 または、最新バージョンをご利用ください。

シナリオ

各Candidateケースの一環として、TGBは応募者のバックグラウンドチェックを行います。 バックグラウンドチェックの一環として、SOAPコネクターを呼び出してクレジット調査プロバイダーからクレジットレポートを取得します。 SOAPコネクターの呼び出し時に問題が発生した場合、TGBはエラーをログに記録し、「Credit Check unavailable: contact your system administrator」というメッセージを表示したいと考えています。

この機能を実現するには、D_CreditReportデータページ用のCreditCheckコネクターを設定し、エラーを検出して応答データトランスフォームから再利用可能なエラー処理データトランスフォームを呼び出し、すべてのエラーが検出済みでエラー処理データトランスフォームで処理済みであることを検証します。 

以下の表は、チャレンジに必要なログイン情報をまとめたものです。

ロール ユーザー名 パスワード
シニアシステムアーキテクト SSA@TGB pega123!
補足: 練習環境では、複数のチャレンジの完了をサポートする場合があります。 その結果、チャレンジのウォークスルーに表示される設定は、お客様の環境と完全に一致しない場合があります。

このチャレンジを完了するには、Pegaインスタンスを起動する必要があります。

起動には5分ほどかかることがありますので、しばらくお待ちください。

チャレンジ ウォークスルー

詳細なタスク

1 CreditCheckコネクターを使用してD_CreditReportデータページを取得する

  1. Data Explorerで、「D_CreditReport」データページを開きます。
  2. 「Definition」タブのData sourcesセクションで、データシミュレーションを無効にします。
  3. Request Data Transformフィールドで「Parameters」をクリックし、「Pass current parameter page」が選択されていることを確認して、TIN(納税者番号)がリクエストデータトランスフォームに渡されることを確認します。
    Pass Parameters
  4. Response Data Transformフィールドで「Parameters」をクリックし、「Pass current parameter page」が選択されていることを確認して、Case IDが応答データトランスフォームに渡されることを確認します。
  5. 「D_CreditReport」データページを保存します。

2 再利用可能なエラー処理データトランスフォームの作成

  1. 標準pxErrorHandlingTemplateデータトランスフォームを開きます。
  2. 最上位クラスであるTGBに、「ErrorHandlingMaster」という名前のpxErrorHandlingTemplateデータトランスフォームのコピーを作成します。
  3. 「Parameters」タブで、ケースID用に「pyCaseID」という名前のパラメーターを定義します。
  4. 必要に応じてpyCaseID パラメーターをマークします。
    pyCaseID
  5. Definitionタブで、ステップ2を右クリックして「Enable」を選択し、pxGetPageMessages関数を使用してメッセージを取得します。
  6. ステップ4を右クリックして「Enable」を選択し、このステップでカスタムエラーメッセージを追加する前にpxClearMessages関数を使用してデータページのメッセージをクリアします。
  7. ステップ6を右クリックして「Enable」を選択し、pxAddMessageToPage関数を使用してErrorMessage入力パラメーターをメッセージとして追加します。
  8. ステップ8を右クリックして「Enable」を選択し、pxLogMessage関数を使用してログファイルにメッセージを書き込みます。
  9. ステップ8「Source」フィールドに、「@(Pega-RULES:Default).pxLogMessage(param.getMessage + " for case number " + param.pyCaseID)」と入力します。
    補足: 関数が何も返さない場合や、応答に興味がない場合でも、常にターゲットを指定する必要があります。
  10. ErrorHandlingMasterデータトランスフォームを保存します。
    Error handling data transform definition list

3 ErrorHandlingMasterを使用したCreditCheckResponseデータトランスフォームの設定

  1. 「D_CreditReport」データページで、「CreditCheckResponse」データトランスフォームを開きます。
  2. ステップ2を右クリックし、Enableを選択して、ルールが呼び出された場合にpxDataPageHasErrorsがエラーをチェックするようにします。
    pxDataPage
  3. 「CreditCheckResponse」データトランスフォームを設定し、エラーが発生した場合、「pxErrorHandling」データトランスフォームの代わりに「ErrorHandlingMaster」を適用します。
  4. 歯車アイコンをクリックし、「ErrorHandlingMaster」データトランスフォームに入力パラメーターを指定します。
    Error handling definition list
  5. 「pyCaseID」入力パラメーターフィールドに「param.CaseID」と入力します。
    pyCaseID parameter field
  6. 「CreditCheckResponse」データトランスフォームを保存します。

4 UIでのエラーメッセージの設定

  1. アプリケーションエクスプローラのCandidateケースタイプで、「User Interface」>「Section> BackgroundCheck_0 セクションをクリックして、「BackgroundCheck_0」セクションルールを開きます。
  2. 「Section」-「Credit report」をクリックし、「BackgroundCheck_0_CreditReport」セクションルールを開きます。
    Credit report section
  3. 「Template configuration」メニューで、「Add」>「Data display」>「Label」をクリックし、ダイナミックレイアウトにラベルを追加します。
    Template configuration
  4. ダイナミックレイアウトで、新しいラベルフィールドをクリックして、新しいラベル用セルプロパティを設定します。
  5. 以下の情報を使用して、「General」フォームを入力します。
    プロパティ
    Value Credit Check unavailable: contact your system administrator
    Visibility Condition (when rule)
    Condition for visibility hasMessages
  6. 「BackgroundCheck_0_CreditReport」セクションルールを保存します。

作業の確認

  1. ユーザーポータルで、Candidateケースを作成します。
  2. Submissionステージを完了します。
    補足: 任意の値を指定して、このステップを完了できます。 このチャレンジには影響しません。
  3. 「Conduct phone screen」ビューで、「Submit」をクリックして、ケースをApprovalアサインメントに進めます。
  4. 「Approval」ビューで、「Approve」をクリックして、ケースをBackground checkアサインメントに進めます。
  5. Background checkアサインメントの右側にある「Go」をクリックして、Background checkを開始します。
    補足: このチャレンジのSOAPコネクターは、常にエラーを生成するように構成されています。
  6. 「Credit Check unavailable: contact your system administrator」メッセージは、システムでエラーハンドリングデータトランスフォームが実行されたことを示します。
    Background check credit report
  7. Dev Studioで、「Configure」メニューから、「System」>「Operations」>「Logs」とクリックして、システムのログを開きます。
  8. 「Log files」をクリックして、「 Logs Files」ウィンドウを開きます。
  9. 「PegaRULES.log」をクリックして、PegaRules logを開きます。
  10. ログファイルの末尾までスクロールし、エラーメッセージの詳細を確認します。
    Error handler message
    ヒント: エラーを見つけるには、Case IDでログファイルを検索できます。

このチャレンジは、下記のモジュールで学習したことを実践するための内容です。


このモジュールは、下記のミッションにも含まれています。

If you are having problems with your training, please review the 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