データページのエラー処理の構成
Archived
4 タスク
30 分
中級
Pega Platform 8.6
データ統合
日本語
シナリオ
各Candidateケースの一環として、TGBは応募者のバックグラウンドチェックを行います。 バックグラウンドチェックの一環として、SOAPコネクターを呼び出してクレジット調査プロバイダーからクレジットレポートを取得します。 SOAPコネクターの呼び出し時に問題が発生した場合、TGBはエラーをログに記録し、「Credit Check unavailable: contact your system administrator」というメッセージを表示したいと考えています。
この機能を実現するには、D_CreditReportデータページ用のCreditCheckコネクターを設定し、エラーを検出して応答データトランスフォームから再利用可能なエラー処理データトランスフォームを呼び出し、すべてのエラーが検出済みでエラー処理データトランスフォームで処理済みであることを検証します。
以下の表は、チャレンジに必要なログイン情報をまとめたものです。
| ロール | ユーザー名 | パスワード |
|---|---|---|
| シニアシステムアーキテクト | SSA@TGB | rules |
補足： 練習環境では、複数のチャレンジの完了をサポートする場合があります。 その結果、チャレンジのウォークスルーに表示される設定は、お客様の環境と完全に一致しない場合があります。
チャレンジ ウォークスルー
詳細なタスク
1 CreditCheckコネクターを使用してD_CreditReportデータページを取得する
-
Data Explorerで、「D_CreditReport」データページを開きます。
- 「Definition」タブの「Data sources」セクションで、データシミュレーションを無効にします。
-
「Request Data Transform」フィールドで「Parameters」をクリックし、「Pass current parameter page」が選択されていることを確認して、TIN（納税者番号）がリクエストデータトランスフォームに渡されることを確認します。
- 「Response Data Transform」フィールドで「Parameters」をクリックし、「Pass current parameter page」が選択されていることを確認して、Case IDが応答データトランスフォームに渡されることを確認します。
-
「D_CreditReport」データページを保存します。
2 再利用可能なエラー処理データトランスフォームの作成
-
標準「pxErrorHandlingTemplate」データトランスフォームを開きます。
-
最上位クラスであるTGBに、「ErrorHandlingMaster」という名前の「pxErrorHandlingTemplate」データトランスフォームのコピーを作成します。
-
「Parameters」タブで、ケースID用に「pyCaseID」という名前のパラメーターを定義します。
-
必要に応じて「pyCaseID」パラメーターをマークします。
- 「Definition」タブで、ステップ2を右クリックして「Enable」を選択し、pxGetPageMessages関数を使用してメッセージを取得します。
- ステップ4を右クリックして「Enable」を選択し、このステップでカスタムエラーメッセージを追加する前にpxClearMessages関数を使用してデータページのメッセージをクリアします。
- ステップ6を右クリックして「Enable」を選択し、pxAddMessageToPage関数を使用してErrorMessage入力パラメーターをメッセージとして追加します。
- ステップ8を右クリックして「Enable」を選択し、pxLogMessage関数を使用してログファイルにメッセージを書き込みます。
- ステップ8の「Source」フィールドに、「@(Pega-RULES:Default).pxLogMessage(param.getMessage + " for case number " + param.pyCaseID)」と入力します。
補足： 関数が何も返さない場合や、応答に興味がない場合でも、常にターゲットを指定する必要があります。
-
ErrorHandlingMasterデータトランスフォームを保存します。
3 「ErrorHandlingMaster」を使用した「CreditCheckResponse」データトランスフォームの設定
-
「D_CreditReport」データページで、「CreditCheckResponse」データトランスフォームを開きます。
-
ステップ2を右クリックし、「Enable」を選択して、ルールが呼び出された場合にpxDataPageHasErrorsがエラーをチェックするようにします。
-
「CreditCheckResponse」データトランスフォームを設定し、エラーが発生した場合、「pxErrorHandling」データトランスフォームの代わりに「ErrorHandlingMaster」を適用します。
-
歯車アイコンをクリックし、「ErrorHandlingMaster」データトランスフォームに入力パラメーターを指定します。
-
「pyCaseID」入力パラメーターフィールドに「param.CaseID」と入力します。
-
「CreditCheckResponse」データトランスフォームを保存します。
4 UIでのエラーメッセージの設定
-
アプリケーションエクスプローラーのCandidateケースタイプで、「User Interface > Section > BackgroundCheck_0 」セクションをクリックして、「BackgroundCheck_0」セクションルールを開きます。
-
「Section - Credit report」をクリックし、「BackgroundCheck_0_CreditReport」セクションルールを開きます。
-
「Template configuration」メニューで、「Add」>「Data display」>「Label」をクリックし、ダイナミックレイアウトにラベルを追加します。
- ダイナミックレイアウトで、新しいラベルフィールドをクリックして、新しいラベル用セルプロパティを設定します。
-
以下の情報を使用して、「General」フォームを入力します。
プロパティ 値 Value Credit Check unavailable: contact your system administrator Visibility Condition (when rule) Condition for visibilty hasMessages - 「BackgroundCheck_0_CreditReport」セクションルールを保存します。
作業の確認
補足： このチャレンジを始める前に「データアクセスパターンの設定」の課題を完了された場合、シミュレーションが有効になっている可能性があります。 次に進む前に、CreditCheckコネクターのシミュレーションを無効にしてください。
- ユーザーポータルで、Candidateケースを作成します。
-
「Submission」ステージを完了します。
補足： ステップを完了するために、任意の値を指定することができます。 このチャレンジには影響を与えません。 -
「Conduct phone screen」ビュー表示で、「Submit」をクリックして、ケースを「Approval」アサインメントに進めます。
-
「Approval」ビューで、「Approval」をクリックして、ケースを[バック「Background check」アサインメントに進めます。
- 「Background check」アサインメントの右側で、「Go」をクリックしてバックグラウンドチェックを開始します。
補足： このチャレンジのSOAPコネクターは、常にエラーを生成するように構成されています。
-
「Credit Check unavailable: contact your system administrator」メッセージは、システムがエラー処理データトランスフォームを実行したことを示します。
-
Dev Studioの「Configure」メニューで、「System > Operations > Logs」の順にクリックしてシステムのログを表示します。
- 「Log files」をクリックして、 Logs Filesウィンドウを開きます。
-
「PegaRULES.log」をクリックして、「PegaRules」ログを開きます。
-
ログファイルを最後までスクロールして、エラーメッセージの詳細を確認します。
ヒント： エラーの内容を確認するには、ログファイルをCase IDで検索します。