16.3 ページ・プロセスの理解

ページ・プロセスを作成して、ページのレンダリング中または送信中の指定されたポイントでアクションを実行します。

16.3.1 ページ・プロセスについて

1つのページ・プロセスは、ページのレンダリング中または送信中の指定されたポイントで1つのアクションを実行します。たとえば、ページ・プロセスを作成して、ロジックを実行したり、Application Expressエンジンをコールできます。ページ・プロセスは、ページのロードや送信など、特定のイベントが発生したときに実行するロジックの単位です。

ファンクションの観点からみると、ページ・レベルのプロセスとアプリケーション・レベルのプロセスに違いはありません。これらの2つのプロセス・タイプの違いは、プロセスが定義された場所(ページ・レベルかアプリケーション・レベルか)です。

関連項目:

親トピック: ページ・プロセスの理解

16.3.2 ページ・プロセスの作成

ページ・プロセスを作成するには、次のステップを実行します。

ページ・デザイナでページを表示します。
1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。
2. アプリケーションを選択します。
3. ページを選択します。
  ページ・デザイナが表示されます。
「レンダリング」または「プロセス」タブで、プロセスが発生するノードを探します。右クリックして、「プロセスの作成」を選択します。
プロセス属性がプロパティ・エディタに表示されます。属性は、グループに編成されます。

ヒント:
「メッセージ」タブに、対処が必要なメッセージを示す赤または黄色の印が表示されます。メッセージを選択すると、プロパティ・エディタに関連する属性が表示されます。赤いエラー・メッセージは、保存する前に対処する必要があります。
グループまたは属性を検索するには、次のステップを実行します。
- グループまたは属性の検索: 「フィルタ・プロパティ」フィールドにキーワードを入力します。プロパティ・エディタにグループまたは属性が表示されます。デフォルトの表示に戻すには、キーワードを削除します。
- 「グループに移動」の使用: 「グループに移動」をクリックして、グループを選択します。デフォルトの表示に戻すには、「グループに移動」を再度クリックして、「すべて開く」を選択します。
ヒント:
属性の詳細は、プロパティ・エディタで属性を選択し、中央ペインで「ヘルプ」タブをクリックして、参照してください。
「指定」で、次の項目を指定します。
1. 名前 - プロセスの名前を入力します。
2. タイプ - 実行するプロセス・タイプを指定します。選択したタイプによって、表示される設定属性が決定されます。
「設定」で、適切な属性を編集します。
「実行オプション」で、次の項目を指定します。
1. 順序 - この計算の順序を指定します。これによって実行の順序が決まります。
  2つのコンポーネントの順序値が同じである場合は、アプリケーションを別の環境にエクスポートおよびインポートするときに、異なる順序で実行されることがあります。
2. ポイント - このプロセスが実行されるポイントを選択します。
3. プロセスの実行 - このプロセスが実行される頻度を選択します。
「成功メッセージ」で、次のステップを実行します。
1. エラー・メッセージ - このプロセスの成功メッセージを入力します。
  プロセスが実行され、エラーが発生しない場合は、表示される結果のページの通知セクションに、このプロセス成功メッセージが表示されます。
「エラー」で、次のステップを実行します。
1. エラー・メッセージ - このプロセスのエラー・メッセージを入力します。
  未処理例外が発生した場合、このメッセージが表示されます。エラー・プロセスが停止した後は、常にロールバックが実行され、エラー・メッセージが表示されます。
2. 表示位置 - このプロセスが正常に完了しなかった場合のこのプロセス・エラー・メッセージの表示場所を選択します。
「保存」をクリックします。

関連項目:

親トピック: ページ・プロセスの理解

16.3.3 ページ・プロセス属性の編集

既存のページ・プロセスを編集するには、次のステップを実行します。

ページ・デザイナでページを表示します。
1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。
2. アプリケーションを選択します。
3. ページを選択します。
  ページ・デザイナが表示されます。
「レンダリング」または「プロセス」タブで、ノードを展開し、プロセスを見つけて選択します。
プロセス属性がプロパティ・エディタに表示されます。属性は、グループに編成されます。
グループまたは属性を検索するには、次のステップを実行します。
- グループまたは属性の検索: 「フィルタ・プロパティ」フィールドにキーワードを入力します。プロパティ・エディタにグループまたは属性が表示されます。デフォルトの表示に戻すには、キーワードを削除します。
- 「グループに移動」の使用: 「グループに移動」をクリックしてグループを選択します。デフォルトの表示に戻すには、「グループに移動」を再度クリックして、「すべて開く」を選択します。
対象となる属性を編集します。
ヒント:
属性の詳細は、プロパティ・エディタで属性を選択し、中央ペインで「ヘルプ」タブをクリックして、参照してください。
「保存」をクリックします。

親トピック: ページ・プロセスの理解

16.3.4 ページ・プロセスを実行するタイミングの制御

プロセスをいつ実行するかを制御するには、次の属性を編集します。

プロセス属性をプロパティ・エディタに表示します。
次の属性を編集します。
1. 実行オプション、順序 - このコンポーネントの順序を指定します。これによって実行の順序が決まります。
2. 実行オプション、ポイント - このブランチ・アクションが考慮される処理内のポイントを選択します。
「保存」をクリックします。

関連項目:

ページ・プロセス属性の編集

親トピック: ページ・プロセスの理解

16.3.5 ページ・プロセスの成功メッセージとエラー・メッセージの作成

プロセスの実行時に表示する成功メッセージとエラー・メッセージの両方を定義できます。エラー・メッセージの表示方法は、プロセス・ポイントによって異なります。「送信時 - 計算および検証の前」または「送信時 - 計算および検証の後」プロセス・ポイントを持つプロセスでは、カレント・ページにインラインでエラー・メッセージを表示するか(デフォルト)、別のページに表示するかを指定できます。他のすべてのページ・プロセスでは、エラー・メッセージは別のエラー・ページに表示されます。

ページ・プロセスのエラー・メッセージまたは成功メッセージを作成するには、次のステップを実行します。

プロセス属性をプロパティ・エディタに表示します。
次の属性を編集します。
1. 成功メッセージ、成功メッセージ - このプロセスの成功メッセージを入力します。プロセスが実行され、エラーが発生しない場合は、表示される結果のページの通知セクションに、このプロセス成功メッセージが表示されます。URLリダイレクトを介して別のページにブランチする場合は、成功メッセージの保存属性を選択する必要があります。
2. エラー、エラー・メッセージ - このプロセスのエラー・メッセージを入力します。未処理例外が発生した場合、このメッセージが表示されます。エラー・プロセスが停止した後は、常にロールバックが実行され、エラー・メッセージが表示されます。
3. エラー、表示位置 - このプロセスが正常に完了しなかった場合のこのプロセス・エラー・メッセージの表示場所を選択します。
  オプションは次のとおりです。
  - 通知でインライン表示: プロセス・エラー・メッセージが「通知」領域(ページ・テンプレートの一部として定義)に表示されます。
  - エラー・ページ: エラーは別のエラー・ページに表示されます。
「保存」をクリックします。

関連項目:

親トピック: ページ・プロセスの理解

16.3.6 ページ・プロセスを条件付きにする

条件付きページ・プロセスを作成するには、次の属性を編集します。

プロセス属性をプロパティ・エディタに表示します。
「サーバー側の条件」で、次の属性を編集します。
1. 対象ボタン: このページ処理コンポーネントを、指定したボタンがクリックされたときのみ実行する場合、リストからボタンを選択します。このボタンの条件を他の条件と統合し、このページ処理コンポーネントがいつ実行されるかをさらに絞り込むことができます。
2. 実行スコープ - 編集可能対話グリッドにのみ適用されます。次のようにして、実行スコープを指定します。
  - 作成済および変更済の列: 表形式フォームで作成および変更した行でのみ検証を実行します。
  - すべての送信済の列: 送信したすべての行で検証を実行します。
3. 条件タイプ: このコンポーネントをレンダリングまたは処理するために満たす必要がある条件タイプをリストから選択します。
「保存」をクリックします。

関連項目:

ページ・プロセス属性の編集

親トピック: ページ・プロセスの理解