アクションセットを使用したイベント処理の設定

行動につながるコントロールは、チェックボックスやボタンなどのコントロールのための原因と結果の関係を構築するイベントアクションモデルに基づいています。 イベントは、ボタンのクリックやフィールドの入力など、ユーザーのアクティビティによって引き起こされるトリガーです。 アクションは、ケースの作成、またはユーザーにインプットを促すためにフィールドに関する情報を表示するなどの、アプリケーションによる応答です。

たとえば、オンラインショップが、注文用の配送先住所を支払いのための請求先住所として顧客に使えるようにしたいとします。 請求先住所を入力するためのフォームは、ユーザーにチェックボックスを提供します。 ユーザーがチェックボックスを選択すると、アプリケーションは、配送先住所の情報を請求先住所フィールドにコピーし、請求先住所フィールドの修正を無効にします。 ユーザーがチェックボックスの選択を解除すると、アプリケーションは、請求先住所フィールドの入力を削除し、ユーザーが住所を入力できるようにします。

以下の画像の中央にある縦棒をスライドすると、ユーザーがチェックボックスをクリックまたはクリアにした時の、住所フォームの表示の変化が確認できます。

Pega Platform™アプリケーションでは、行動につながるコントロールを設定するためにアクションセットを使用します。 アクションセットは、1つ以上のイベントおよび1つ以上のアクションで構成されています。 オプションとして、条件が満たされた場合のみにアクションが発生するように、各アクションに条件を追加できます。

次の図の「+」アイコンをクリックすると、オンラインショップに注文が送信されると、アクションセットがフォームの請求先住所フィールドに入力する仕組みが表示されます。

アクションセットを設定する場合、リフレッシュアクションとサーバーの呼び出しでユーザーエクスペリエンスとデータがどのように影響を受けるかを考慮します。 たとえば、ユーザーが画面の更新を待機するか、前の画面に手動で戻る必要がある場合、ユーザーフローが中断されることになります。

次の場合にセクションをリフレッシュします。

• プロパティ値はサーバー上で更新され、UIで新しい値を反映する必要がある場合。
• 行の削除など、クライアントのみで発生する複数のプロパティに変更を加えるアクションを送信する必要がある場合。
• 一部のUIでは、他の入力のためにDocument Object Model（DOM）からの削除が求められます。

以下の場合は、セクションを更新しないでください。

• ユーザー入力をサブミットする必要がある場合。 この場合、代わりに、ポスト値アクションを使用します。
• ユーザーアクションの後に、データトランスフォームまたはアクティビティを呼び出す必要がある場合。
• 可視性、有効/無効、または読み取り専用状態を再計算する必要がある場合。 式フィールドのとなりのEvaluate on client チェックボックスにチェックを入れます。

可能な限りRefresh Whenアクションを使用して従属を宣言します。 正確なデータを維持するには、サーバー上のデータとの同期を維持する必要がある読み取り専用の参照に対して、RefreshWhenアクションを使用します。 たとえば、ホテルの場所が変わったときだけ更新が必要なホテルの詳細情報をリフレッシュします。

Refresh Whenが不可能な場合は、ターゲットリフレッシュのRefresh Other Sectionアクションを使用します。 たとえば、他の入力またはボタンクリックなどの追跡不可能な入力に基づいて更新される編集可能な参照がある場合は、Refresh Other Sectionを使用します。

アクションセットのアクションを統合する

アクションセットの各アクションでは、サーバーに対して少なくとも1つのHTTPリクエストが生成され、設定された順序で実行されます。 アクションを最適化し、サーバーに対するHTTPリクエストの数を減らすには、次のベストプラクティスを使用します。

• プレアクティビティまたはプレデータトランスフォームがセクションの更新と同じコンテキストで実行される場合は、セクション更新アクションで設定します。
• 更新セクションのコンテキストで実行する場合に、必要に応じてプレアクティビティのコンテンツを変更します。
• ラッパーアクティビティまたはラッパーデータトランスフォームを使用して、すべてのアクションを統合します。

以下の画像の中央にある縦線をスライドすると、アクションセット内のアクションをラッパーアクティビティに統合する方法を確認できます。