プロパティ値が変化した場合のアクションの自動化

2 タスク

15 分

Visible to: All users

中級

Pega Platform '23

Dev/Designer Studio

日本語

シナリオ

TGBの給与部門からのレポートによると、一部の従業員が振込の登録時に誤った銀行名を入力しているとのことです。給与部門では、Payroll Setupケースでエラーが発生しないようにするために、入力されたルーティング番号に基づく銀行名の入力をリクエストしています。

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

ロール	ユーザー名	パスワード
Senior System Architect	SSA@TGB	pega123!

補足： 練習環境では、複数のチャレンジの完了をサポートする場合があります。その結果、チャレンジのウォークスルーに表示される設定は、お客様の環境と完全に一致しない場合があります。

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

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

ログイン

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

詳細なタスク

1 Bank informationセクションの更新

チャレンジのPegaインスタンスに、以下のログイン情報を入力します。
1. User nameフィールドに「SSA@TGB」と入力します。
2. Passwordフィールドに「pega123!」と入力します。
Dev Studioで、セクションルールProvideBankInformation_0を検索して開きます。
ヒント： 検索機能やRecords Explorerを使用して、セクションルールを探すことができます。「Records Explorer」では、フィルターオプションを使用して対象のルールを探します。
埋め込みセクションをダブルクリックして、Cell Propertiesダイアログボックスを開きます。
BankInformationセクションルールを開きます。
Bank nameフィールドをダブルクリックして、Cell Propertiesダイアログボックスを開きます。
PresentationタブのEdit optionsリストで、Read-only (always)を選択します。
ダイアログボックスで、Submitをクリックして変更内容を適用します。
Routing numberフィールドをダブルクリックして、Cell Propertiesダイアログボックスを開きます。
「Cell Properties 」ダイアログボックスの「Actions」タブで、「Actions type」に「Standard」を選択します。
Create an action set をクリックして、フィールドにアクションセットを追加します。
Add an event > Changeをクリックして、コントロールに変更イベントを追加します。
「Add an action > Display: Refresh」をクリックしてRefresh-Thisセクションアクションをフィールドに追加し、ユーザーがセクションでルーティング番号を変更したときに、更新された銀行名がすぐに表示されるようにします。
Submit をクリックして、変更内容を適用します。セクションは次の画像のようになります。
セクションルールを保存します。

2 変更の宣言およびアクティビティルールの作成

Dev Studioで、「Records Explorer」を開きます。
Records Explorerで「Decision > Declare OnChange」をクリックして、アプリケーションでOnChangeインスタンスの現在のリストを開きます。
Createをクリックして新しいDeclare OnChangeルールを作成します。
新しいDeclare OnChangeルールで、Label フィールドに「UpdateBankName」と入力します。
Apply toフィールドに「TGB-HRApps-Work-PayrollSetup」と入力して、Declare OnChangeルールをPayrollSetupケースタイプに適用します。
「Create and open」をクリックして、Declare OnChangeルールを作成します。
Properties To Watchフィールドで、変更を監視するプロパティとして「.RoutingNumber」と入力するか選択します。
Whenフィールドで、「Always」と入力するか選択して、ルーティング番号を変更するたびに指定されたアクティビティを実行します。
When True Runセクションで、アクティビティ名UpdateBankNameを入力します。
アクティビティUpdateBankNameフィールドの横にある「open 」アイコンをクリックして、Create Activity画面を開きます。
「Create and open」をクリックして、新しいアクティビティルールを「UpdateBankName」として保存します。
アクティビティルールの「Security」タブで、「Activity type」リストから「Onchange」を選択します。
Steps タブで、UpdateBankName データトランスフォームを適用するアクティビティを構成します。

補足： このシナリオでは、UpdateBankName データトランスフォームで米国固有のルーティング番号を使用して、アカウントが関連付けられている金融機関を識別します。米国のルーティング番号について詳しくは、「List of routing numbers」を参照してください。
アクティビティルール「UpdateBankName」を保存し、Declare OnChange ruleタブをクリックします。
補足： システムによって、アクティビティルールの使用は限定すべきであるという旨のワーニングが表示されます。データ変換や、ケースマネジメント、エンジンAPI、宣言などの手法を使用することで、アクティビティの必要性を低減できます。ベストプラクティスに従い、アクティビティの使用を避けるようにします。
「Declare OnChange」ルール「UpdateBankName」を保存します。

作業の確認

ユーザーポータルで、新しいPayroll Setupケースを作成します。
ケースをProvide bank informationステップに進めます。
Routing numberフィールドに「021001088」と入力し、タブキーを押して、Bank nameフィールドが自動的に「HSBC Bank USA」に更新されることを確認します。
Routing number フィールドに「124003116」と入力し、タブキーを押して、Bank nameフィールドが自動的に「Ally Bank」に更新されることを確認します。
Routing numberフィールドに「061000104」と入力し、タブキーを押して、Bank nameフィールドが自動的に「Sun Trust Bank」に更新されることを確認します。
Routing numberフィールドに「123107613」と入力し、タブキーを押して、Bank nameフィールドが自動的に「--」（空白）に更新されることを確認します。