アクティビティ構造
アクティビティは、1つ以上のシーケンスステップで構成されます。 アクティビティステップでは、それぞれシステムが実行するアクションを説明するメソッドを指定する必要があります。
ステップページ とは、メソッドが処理されるメモリ内のページのことをいいます。 デフォルトでは、アクティビティは呼び出されたコンテキスト内で実行されます。 たとえば、ケース処理中にユーティリティシェープから呼び出されたアクティビティは、ケースタイプ（pyWorkPage）に割り当てられたページに対して実行されます。
アクションアクティビティ
アクティビティでは番号順にステップが実行されます。 「Loop」、「When」、および「Jump」は、ステップを繰り返したり、ステップの実行順序を変更したりする場合のアクションまたは条件を示します。
他のアクティビティの呼び出し
アクティビティは他のアクティビティを呼び出すことができるため、デベロッパーはモジュール型のアクティビティを作成することで、標準のアクティビティを再利用できます。 Pega Platformでは、およびという2つの方法で他のアクティビティを実行できます。
呼び出し
Pegaでは指定されたアクティビティが実行され、呼び出されたアクティビティプロセスが終了した時点で呼び出し元のアクティビティにコントロールが戻されます。 AとBの2つのアクティビティについて、AがBを呼び出すと、Bが終了した時点でAにコントロールが戻ります。
分岐
Pegaでは指定されたアクティビティが実行されますが、コントロールは最初のアクティビティを呼び出したルールに戻されます。 元のアクティビティは、分岐したアクティビティが完了すると終了します。 CとDの2つのアクティビティについて、
CがDに分岐した場合、D（分岐したアクティビティ）が終了すると、Cを呼び出したルールにコントロールが戻されます。
パラメーター
パラメーターはアクティビティにデータを入力したり、アクティビティからデータを返したりする変数を定義します。
パラメーターを使用すると、開発時に事前に定義するのではなく、アクティビティが呼び出されたときに引数を渡すことができるため、アクティビティの再利用性が向上します。
- アクティビティパラメーターは、アクティビティフォームの「Parameters」タブで定義されます。
- パラメーター値を参照するには、param.という表記を使用します。
- パラメーターの名前と値は、パラメーターページと呼ばれる特別なクリップボードページに保持されます。このページはクClipboardツールでは表示されません。
セキュリティー
アプリケーションをより適切に保護するには、アクティビティ固有のアクセスコントロールを設定して、アクティビティを実行できる方法とユーザーを制限します。 アクティビティルールの「Security」タブの設定を使用してアクティビティタイプを指定し、オプションでアクティビティを実行できるユーザー（または他のリクエスター）を制限します。
アクセス制限
Restrict accessセクションのセキュリティー設定を使用して、ユーザーがランタイムにアクティビティを実行する方法（または実行するかどうか）を制限します。
Allow direct invocation from the client or a serviceチェックボックスを選択すると、ユーザーはURLのSubmitボタンやpyActivity=要素などのユーザー入力処理によってアクティビティを直接開始できるようになります。 このアクティビティを別のアクティビティからのみ、呼び出し、分岐、またはその他の手段で開始できるようにする場合は、選択を解除します。
注： ほとんどのアクティビティでは、アプリケーションのセキュリティーを強化するため、このチェックボックスをオフのままにしておきます。 URLまたは他のユーザー入力（リクエスターが認証済みゲストかどうかを問わず）からアクティビティを開始できるようにした場合、ユーザーは必要なチェック、セキュリティー、またはセットアップ手順を省略する可能性があります。
「Require authentication to run」チェックボックスを選択して認証済みのリクエスターのみがこのアクティビティを開始できるようにするにします。 ゲストユーザーが他のセキュリティーおよびアクセス条件を満たしている場合にこのアクティビティを実行できるようにするには、チェックボックスをオフにします。
補足： Require authentication to run は、新しいアクティビティにデフォルトで選択されています。 ほとんどの場合、この選択を変更する必要はありません。
1つ以上の権限を特定して、このアクティビティを実行できるユーザーおよびその他のリクエスターを制限できます。 ランタイムにおいてユーザーが属しているアクセスグループでアクセス権限の1つが付与されていない場合、アクティビティの実行は失敗します。
アクティビティの「Restrict access」タブの「Security」セクションにある設定の使用の詳細については、Pega Communityの記事「Securing an activity」を参照してください。
アクティビティタイプ
アクティビティのアクティビティタイプを選択して、このアクティビティを他のルールで参照できるか、またどのように参照できるかを決定します。 たとえば、Routeアクティビティタイプを選択すると、アクティビティの使用がケースワークフローのルーティングアサインメント に制限されます。 Activity typeリストには、次のオプションがあります。
| アクティビティタイプ | 説明 |
|---|---|
| Activity（アクティビティ） | これ以上、具体的な値が適用されない場合に選択します。 この値のアクティビティは、フロールールで直接参照することはできません。 |
| Assembler（アセンブラー） | 非推奨。使用しないでください。 |
| Assign（割り当て） | アクティビティがフロールールの割り当て形状から参照されるかどうかを選択します。 Assignアクティビティは、アサインメントを作成するために使用されるため、NotifyおよびRouteアクティビティなど、アクティビティから呼び出される可能性のある他のアクティビティタイプとは異なります。 |
| Asynchronous（非同期） | アクティビティがバックグラウンドスレッドで非同期に実行されるかどうかを選択します。 アクティビティでは、Load-DataPage、Connect-Wait、およびCall-Async-Activity（ユーザーが非同期アクティビティをロードできるようにするステップインストラクション）のステップメソッドのみを呼び出せます。 |
| Load Data Page（データページの読み込み） | アクティビティでデータページに値を追加するかどうかを選択します。 Definitionルールの「Data Page」タブでこのアクティビティを参照してください。 |
| Locate（位置を特定） | 現在は廃止されています。 位置特定可能ページを利用する既存のアクティビティでのみ使用できます。 |
| Notify（通知） | アクティビティを使用して、保留中のアサインメントを1人または複数のユーザーに通知するかどうかを選択します。 |
| Onchange（オンチェンジ） | アクティビティをDeclare OnChangeルールで自動的に実行するかどうかを選択します。 |
| Route（ルート） | アクティビティを使用してフロールールのアサインメントをルーティングするかどうかを選択します。 |
| Rule Connect（ルール接続） | アクティビティがコネクタールールを呼び出して外部システムとインターフェイスするかどうかを選択します。 |
| Trigger（トリガー） | アクティビティがDeclare Triggerルールによって自動的に実行されるかどうかを選択します。 |
| Utility（ユーティリティ） | アクティビティがフロールールのユーティリティシェープから呼び出されるかどうかを選択します。 |
| Validate（バリデート） | 非推奨。使用しないでください。 |
フロールールから呼び出されるアクティビティのアクティビティタイプを設定する方法の詳細については、Pega Communityの記事「Security tab on the Activity form」を参照してください。
トレーニングを実施中に問題が発生した場合は、Pega Academy Support FAQsをご確認ください。