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

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

• ページ・プロセスについて
  1つのページ・プロセスは、ページのレンダリング中または送信中の指定されたポイントで1つのアクションを実行します。
• ページ・プロセスの作成
  ページ・デザイナでページ・プロセスを作成します。
• ページ・プロセス属性の編集
  ページ・デザイナでページ・プロセスを編集します。
• ページ・プロセスを実行するタイミングの制御
  「順序」属性と「ポイント」属性を編集して、プロセスを実行するタイミングを制御します。
• ページ・プロセスの成功メッセージとエラー・メッセージの作成
  プロセスの実行時に表示する成功メッセージとエラー・メッセージの両方を定義します。
• ページ・プロセスを条件付きにする
  「サーバー側の条件」属性を編集して、条件付きのページ・プロセスを作成します。

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

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

たとえば、ページ・プロセスを作成して、ロジックを実行したり、APEXエンジンをコールできます。ページ・プロセスは、ページのロードや送信など、特定のイベントが発生したときに実行するロジックの単位です。

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

ページ・デザイナでページ・プロセスを作成します。「レンダリング」または「プロセス」タブで、プロセスが発生するノードを見つけて右クリックし、「プロセスの作成」を選択します。プロセス・タイプによって、構成する必要がある属性が決まります。

サポートされているプロセス・タイプ

ノート:

アプリケーションの構成によっては、その他のプロセス・タイプ・プラグインもあります。これらは、<My Plug-in> [Plug-in]と表示されます。

サポートされているページ・プロセス・タイプは次のとおりです。

• セッション・ステートのクリア - Oracle APEX内に格納されているセッション・ステートをクリアするプロセス。
• ダイアログを閉じる - 現在のモーダル・ダイアログ・ページまたはモジュール以外のダイアログ・ページを閉じるプロセス。
• データのロード - 指定されたデータ・ロード定義に基づいて、データをターゲット表またはコレクションにロードするプロセス。
• コードを実行 - PL/SQLコードを実行するプロセス。
• フォーム - 行の自動処理(DML) - フォーム・リージョンの行を挿入、更新または削除するプロセス。
• フォーム - 初期化 - フォーム・リージョンのアイテムを初期化するプロセス。初期化は、主キー値を使用したリージョン・ソースからのデータのフェッチであるか、フォーム・リージョンのアイテムの単純な初期化です。ヒューマン・タスク - 作成 - アプリケーションの既存のタスク定義を使用してヒューマン・タスクを作成するプロセス。
• ヒューマン・タスク - 管理 - ヒューマン・タスクを管理するプロセス。タスク管理の様々なタイプとして、承認、却下、要求、リリース、委任、転送、取消、コメントおよび参加者の招待があります。
• 対話グリッド - 行の自動処理(DML) - 対話グリッドの行を挿入、更新または削除するプロセス。
• APIの呼出し - ローカル・データベースに格納されているプロシージャまたはファンクションを呼び出すプロセス。
• ページ区切りのリセット - カレント・ページでレポートのページ区切りをリセットするプロセス。
• 電子メールの送信 - アプリケーションから電子メール(およびオプションで1つ以上の添付)を送信するプロセス。
• ユーザー・プリファレンス - エンド・ユーザーのユーザー・プリファレンスを設定するプロセス。
• Webサービス - 指定されたWebサービスを消費するプロセス。

関連項目:

• アプリケーション・プロセスの理解
• ページ固有のユーティリティへのアクセス

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

ページ・デザイナでページ・プロセスを作成します。

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

1. ページ・デザイナでページを表示します。
   1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。
   2. アプリケーションを選択します。
   3. ページを選択します。

      ページ・デザイナが表示されます。

2. 「レンダリング」または「プロセス」タブで、プロセスが発生するノードを探します。右クリックして、「プロセスの作成」を選択します。
3. ページ・デザイナでは、次に行う処理が示されます。エラーがある場合は、「メッセージの表示」アイコンがページ開発者ツールバーに表示されます。
   1. ページ・デザイナ・ツールバーの「メッセージの表示」アイコンをクリックします。
      「メッセージ」ダイアログに、対処する必要があるエラーが表示されます。
   2. エラーを選択すると、プロパティ・エディタの関連する属性がハイライトされます。

      属性についてさらに学習するには、プロパティ・エディタで属性を選択し、中央ペインで「ヘルプ」タブをクリックして、参照してください。

4. 識別、名前 - 開発者が容易に識別できるプロセスの名前を入力します。
5. 識別、タイプ - 実行するプロセス・タイプを指定します。選択したタイプによって、次に表示される属性が決まります。

   次の例を考えてみます。

   • 「タイプ」が「コードを実行」の場合:
     • 識別、タイプ - 「コードを実行」を選択します。
     • ソース、位置 - プロセスが実行される場所を選択します。「ローカル・データベース」または「REST対応SQL」を選択します。
     • ソース、言語 - 入力されたコードの実行に使用される言語を選択します。
     • ソース、PL/SQL - 実行するPL/SQLコードを入力します。
   • 「タイプ」が「APIの呼出し」の場合:
     • 識別、タイプ - 「APIの呼出し」を選択します。
     • 設定、タイプ - 実行するプロセスを選択します。オプションには、「PL/SQLパッケージ」または「PL/SQLプロシージャまたはファンクション」があります。
     • 設定、パッケージ - 大/小文字を区別したPL/SQLパッケージ名を入力します。名前を入力するか、リストから選択します。
     • 設定、プロシージャまたはファンクション - 選択したPL/SQLパッケージに定義されている大/小文字を区別したプロシージャ名またはファンクション名を入力します。名前を入力するか、リストから選択します。
6. 「実行」で、次の操作を行います。
   1. 実行、順序 - この計算の順序を指定します。これによって実行の順序が決まります。

      2つのコンポーネントの順序値が同じである場合は、アプリケーションを別の環境にエクスポートおよびインポートするときに、異なる順序で実行されることがあります。

   2. 実行、ポイント - このプロセスが実行されるポイントを選択します。
   3. 実行、プロセスの実行 - このプロセスが実行される頻度を選択します。
7. 「成功メッセージ」で、次のステップを実行します。
   • 成功メッセージ、成功メッセージ - このプロセスの成功メッセージを入力します。

     プロセスが実行され、エラーが発生しない場合は、表示される結果のページの通知セクションに、このプロセス成功メッセージが表示されます。URLリダイレクトを使用して別のページにブランチする場合は、成功メッセージの保存属性を選択する必要があります。

     さらに学習するには、プロパティ・エディタで属性を選択し、中央ペインで「ヘルプ」タブをクリックして参照してください。

8. 「エラー」で、次のステップを実行します。
   1. エラー、エラー・メッセージ - このプロセスのエラー・メッセージを入力します。

      未処理例外が発生した場合、このメッセージが表示されます。エラー・プロセスが停止した後は、常にロールバックが実行され、エラー・メッセージが表示されます。

   2. エラー、表示位置 - このプロセスが正常に完了しなかった場合のこのプロセス・エラー・メッセージの表示場所を選択します。
9. 「保存」をクリックします。

関連項目:

• レンダリング前ブランチ、計算およびプロセスの作成
• ページ送信ブランチ、検証、計算およびプロセスの作成

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

ページ・デザイナでページ・プロセスを編集します。

既存のページ・プロセスを編集するには:

1. ページ・デザイナでページを表示します。
   1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。
   2. アプリケーションを選択します。
   3. ページを選択します。

      ページ・デザイナが表示されます。

2. 左ペインで「プロセス」タブをクリックします。
3. 「レンダリング」または「プロセス」タブで、ノードを展開し、プロセスを見つけて選択します。

   プロセス属性がプロパティ・エディタに表示されます。属性は、グループに編成されます。

   グループまたは属性を検索するには、「フィルタ・プロパティ」フィールドにキーワードを入力します。プロパティ・エディタにグループまたは属性が表示されます。または、「グループに移動」をクリックしてグループを選択できます。

4. 対象となる属性を編集します。

   ヒント:

   属性についてさらに学習するには、プロパティ・エディタで属性を選択し、中央ペインで「ヘルプ」タブをクリックして、参照してください。

5. 「保存」をクリックします。

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

「順序」属性と「ポイント」属性を編集して、プロセスを実行するタイミングを制御します。

プロセスを実行するタイミングを制御するには、「順序」属性と「ポイント」属性を編集します。

1. ページ・デザイナでページを表示します。
   1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。
   2. アプリケーションを選択します。
   3. ページを選択します。
   ページ・デザイナが表示されます。
2. 左ペインで「プロセス」タブをクリックします。
3. 「レンダリング」または「プロセス」タブで、ノードを展開し、プロセスを見つけて選択します。

   プロセス属性がプロパティ・エディタに表示されます。属性は、グループに編成されます。

4. 「実行」で、次の操作を行います。
   1. 実行、順序 - この計算の順序を指定します。これによって実行の順序が決まります。

      2つのコンポーネントの順序値が同じである場合は、アプリケーションを別の環境にエクスポートおよびインポートするときに、異なる順序で実行されることがあります。

   2. 実行、ポイント - このプロセスが実行されるポイントを選択します。
   3. 実行、プロセスの実行 - このプロセスが実行される頻度を選択します。
5. 「保存」をクリックします。

関連項目:

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

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

プロセスの実行時に表示する成功メッセージとエラー・メッセージの両方を定義します。

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

ページ・プロセスのエラー・メッセージまたは成功メッセージを作成するには:

1. ページ・デザイナでページを表示します。
   1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。
   2. アプリケーションを選択します。
   3. ページを選択します。
   ページ・デザイナが表示されます。
2. 左ペインで「プロセス」タブをクリックします。
3. 「レンダリング」または「プロセス」タブで、ノードを展開し、プロセスを見つけて選択します。

   プロセス属性がプロパティ・エディタに表示されます。属性は、グループに編成されます。

4. 「成功メッセージ」で、次のステップを実行します。
   • 成功メッセージ、成功メッセージ - このプロセスの成功メッセージを入力します。

     プロセスが実行され、エラーが発生しない場合は、表示される結果のページの通知セクションに、このプロセス成功メッセージが表示されます。URLリダイレクトを使用して別のページにブランチする場合は、成功メッセージの保存属性を選択する必要があります。

     さらに学習するには、属性を選択して、中央ペインで「ヘルプ」タブをクリックします。

5. 「エラー」で、次のステップを実行します。
   1. エラー、エラー・メッセージ - このプロセスのエラー・メッセージを入力します。未処理例外が発生した場合、このメッセージが表示されます。エラー・プロセスが停止した後は、常にロールバックが実行され、エラー・メッセージが表示されます。
   2. エラー、表示位置 - このプロセスが正常に完了しなかった場合のこのプロセス・エラー・メッセージの表示場所を選択します。

      オプションは次のとおりです。

      • 通知でインライン表示 - プロセス・エラー・メッセージが「通知」領域(ページ・テンプレートの一部として定義)に表示されます。
      • エラー・ページ - エラーは別のエラー・ページに表示されます。
6. 「保存」をクリックします。

関連項目:

ページ・テンプレート

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

「サーバー側の条件」属性を編集して、条件付きのページ・プロセスを作成します。

条件付きのページ・プロセスを作成するには:

1. ページ・デザイナでページを表示します。
   1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。
   2. アプリケーションを選択します。
   3. ページを選択します。
   ページ・デザイナが表示されます。
2. 左ペインで「プロセス」タブをクリックします。
3. 「レンダリング」または「プロセス」タブで、ノードを展開し、プロセスを見つけて選択します。

   プロセス属性がプロパティ・エディタに表示されます。属性は、グループに編成されます。

4. 「サーバー側の条件」で、次の項目を指定します。
   1. サーバー側の条件、ボタン押下時 - このページ処理コンポーネントを、指定したボタンがクリックされたときのみ実行する場合、リストからボタンを選択します。このボタンの条件を他の条件と統合し、このページ処理コンポーネントがいつ実行されるかをさらに絞り込むことができます。
   2. サーバー側の条件、実行タイプ - このコンポーネントをレンダリングまたは処理するために満たす必要がある条件タイプを選択します。

      さらに学習するには、プロパティ・エディタで属性を選択し、中央ペインで「ヘルプ」タブをクリックして参照してください。

5. 「保存」をクリックします。