ヘッダーをスキップ
Oracle Database Application Expressユーザーズ・ガイド
リリース2.2
B31492-01
  目次
目次		 索引
索引
戻る
戻る 		 次へ
次へ		  

4 アプリケーション・ビルダーの使用

このセクションでは、アプリケーション・ビルダーを使用して、動的にレンダリングされたアプリケーションを構築するために重要な前提知識について説明します。

内容は次のとおりです。


参照:


アプリケーション・ビルダーへのアクセス

アプリケーションは、タブ、ボタンまたはハイパーテキスト・リンクを使用して相互にリンクされた、データベース・ドリブンのWebページのコレクションです。アプリケーション内のページは、共通のセッション・ステート定義および認証方式を共有します。アプリケーション・ビルダーは、アプリケーションを構成するページを構築するためのツールです。

アプリケーション・ビルダーにアクセスするには、次のステップを実行します。

  1. Oracle Application Expressにログインします。

    「作業領域」ホームページが表示されます。

  2. アプリケーション・ビルダーのホームページを表示するには、次のいずれかの操作を実行します。

    • 「アプリケーション・ビルダー」アイコンをクリックして、「アプリケーション・ビルダー」ホームページにリンクする。

    • 「アプリケーション・ビルダー」アイコンの右側にある下矢印をクリックしてドロップダウン・メニューを表示する。次に、該当するメニュー・オプションを選択する。

    new_menu.gifの説明が続きます。
    new_menu.gifの説明


    注意:

    一貫性を保つために、このドキュメントでは、ナビゲーションを説明する際にプライマリ・ナビゲーション・パス（ドリルダウン方式）を使用します。

「アプリケーション・ビルダー」ホームページの概要

「アプリケーション・ビルダー」ホームページには、インストールされているすべてのアプリケーションが表示されます。

app_bldr_home.gifの説明が続きます。
app_bldr_home.gifの説明

ページ上部にあるナビゲーション・バーを使用して、「アプリケーション・ビルダー」ホームページの外観をカスタマイズできます。 使用可能なコントロールは次のとおりです。

次のボタンがナビゲーション・バーの右側に表示されます。

「アプリケーション」ホームページの概要

特定のアプリケーションを表示するには、「アプリケーション・ビルダー」ホームページでそのアプリケーションを選択します。「アプリケーション」ホームページが表示されます。 アプリケーションIDおよびアプリケーション名は、ページ上部に表示されます。

bldr_hm_top.gifの説明が続きます。
bldr_hm_top.gifの説明

次に、次の4つの大きいアイコンが表示されます。

ナビゲーション・バーおよび「ページの作成」ボタン

ナビゲーション・バーおよび「ページの作成」ボタンは、「アプリケーション」ホームページの中央に表示されます。 これらのコントロールを使用して、ページの検索、ページ・ビューの変更または新しいページの作成を実行できます。

bldr_hm_nav.gifの説明が続きます。
bldr_hm_nav.gifの説明

「アプリケーション」ホームページのナビゲーション・バーには、次のコントロールが含まれています。

「ページの作成」ボタンがナビゲーション・バーの右側に表示されます。 「ページの作成」は、新しいページの作成ステップを説明するウィザードを起動する場合にクリックします。詳細は、「ページのアプリケーションへの追加」を参照してください。


参照:

「「ページの実行」アイコン、「ページの編集」アイコン、「開発者のコメント」アイコンおよび「検索」アイコン」

「タスク」リストの概要

「タスク」リストが「アプリケーション」ホームページの右側に表示されます。

bldr_task_list.gifの説明が続きます。
bldr_task_list.gifの説明

「タスク」リストには次のリンクが含まれます。

ページ表示の代替方法の理解

「ビュー」リストから選択して、「アプリケーション」ホームページの表示方法を制御できます。使用可能なビュー・オプションは次のとおりです。

bldr_hm_pglist.gifの説明が続きます。
bldr_hm_pglist.gifの説明

「詳細」ビューには、「ロック」アイコンおよび「実行」アイコンも含まれています。アプリケーション開発中の競合を回避するには、｢ロック｣アイコンを使用します。 関連ページを実行し、表示可能なHTMLをレンダリングするには、「実行」アイコンをクリックします。


参照:

「ページのロックおよびロック解除」および「ページまたはアプリケーションの実行」

「ページの実行」アイコン、「ページの編集」アイコン、「開発者のコメント」アイコンおよび「検索」アイコン

「ページの実行」アイコン、「ページの編集」アイコン、「開発者のコメント」アイコンおよび「検索」アイコンは、特定のアプリケーションまたはアプリケーション・ページに関連する、アプリケーション・ビルダーのすべてのページの右上の「ユーティリティ」タブの下に表示されます。

bldr_hm_ico.gifの説明が続きます。
bldr_hm_ico.gifの説明

「ページの実行」アイコン

「ページの実行」アイコンは、小さな薄緑色の信号機に似ています。 カレント・ページの表示可能なHTMLをレンダリングするには、このアイコンをクリックします。 ページを選択せずにこのアイコンをクリックすると、アプリケーションの最初のページが実行されます。 ページの実行時、Application Expressエンジンは、データベースに格納されたデータに基づいて、ページを動的にレンダリングします。詳細は、「ページまたはアプリケーションの実行」を参照してください。

「ページの編集」アイコン

「「ページの編集」」アイコンは、小さな緑色の紙と鉛筆に似ています。 カレント・ページの「ページ定義」にアクセスするには、このアイコンをクリックします。 ページを選択せずにこのアイコンをクリックすると、アプリケーションの最初のページの「ページ定義」が表示されます。詳細は、「「ページ定義」の概要」を参照してください。

「開発者のコメント」アイコン

「開発者のコメント」アイコンは、緑色の吹出しの形をしています。 アプリケーション、特定のページまたはページのグループに関するコメントを記録するには、このアイコンをクリックします。 詳細は、「開発者のコメントの追加」を参照してください。

「検索」アイコン

「検索」アイコンは、懐中電灯に似ています。 カレント・アプリケーション内または作業領域に関連付けられているスキーマ内のアイテム、ページ、問合せ、表またはPL/SQLを検索するには、このアイコンをクリックします。 詳細は、「アイテム、ページ、問合せ、表またはPL/SQLコードの検索」を参照してください。


ヒント:

「ページの実行」アイコン、「ページの編集」アイコン、「開発者のコメント」アイコンおよび「検索」アイコンは、アプリケーション・ビルダーの多くのページ（共有コンポーネントの作成および管理のためのページなど）に表示されます。 詳細は、「共有コンポーネントでの作業」を参照してください。

アプリケーション属性の概要

アプリケーション属性は、アプリケーション全体に適用されます。 アプリケーションを作成した後、アプリケーション属性を確認し、必要に応じて更新します。

このセクションの内容は次のとおりです。


参照:

パッケージ化されたアプリケーションを「サポートするオブジェクト」ユーティリティを使用して作成する方法については、「パッケージ化されたアプリケーションの作成方法」を参照してください。

アプリケーション定義の構成

アプリケーションの名前と可用性の制御および静的置換文字列の定義を行うには、「定義の編集」ページの属性を使用します。 また、「定義の編集」ページには、定義済のビルド・オプション、関連付けられたテーマ、テンプレートのデフォルトおよびコンポーネントのデフォルトが表示されます。 必須の値には赤いアスタリスク（*）が付いています。

このセクションの内容は次のとおりです。

「定義の編集」ページへのアクセス

アプリケーション定義を編集するには、次のステップを実行します。

  1. 「作業領域」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

  2. アプリケーションを選択します。

  3. 「属性の編集」をクリックします。

    「アプリケーション属性」ページが表示されます。

  4. 「定義」をクリックします。

    「定義の編集」ページが表示されます。

その他のナビゲーション方法

「定義の編集」ページは、「名前」、「可用性」、「グローバル通知」、「置換」、「ロゴ」、「ビルド・オプション」、「テーマ」、「テンプレートのデフォルト」および「コンポーネントのデフォルト値」のセクションに分かれています。ページをスクロールするか、ページ上部にあるナビゲーション・ボタンをクリックすると、これらのセクションにアクセスできます。

app_attribute_tabs.gifの説明が続きます。
app_attribute_tabs.gifの説明

ページ上部にあるボタンを選択すると、選択したセクションが表示され、その他のセクションはすべて一時的に非表示になります。ページのすべてのセクションを表示するには、「すべての表示」をクリックします。

「定義の編集」ページの概要

次のセクションでは、「定義の編集」ページで使用可能な属性について説明します。

このセクションの内容は次のとおりです。

名前

「名前」を使用して、アプリケーションの基本特性（アプリケーション名、英数字の別名（オプション）、バージョン番号など）を定義します。 表4-1に、すべての名前属性を示します。

表4-1 アプリケーション定義属性

属性 説明

名前

アプリケーションの説明的な短い名前を指定します。この名前によって、アプリケーションを開発環境に存在する他のアプリケーションと区別します。

アプリケーションの別名

代替の英数字アプリケーション識別子を割り当てます。この識別子は、アプリケーションIDのかわりに使用できます。たとえば、アプリケーション105にmyappという別名を作成したとします。この場合、f?p構文を使用して、アプリケーション105を次のいずれかでコールできます。

  • f?p=105:1

  • f?p=myapp:1

バージョン

アプリケーションのバージョン番号がページに表示されます。次に示す書式マスクを使用して、自動的にバージョンを最終更新日に結び付けることもできます。

  • YYYY.MM.DD

  • MM.DD.YYYY

  • DD.MM.YYYY

アプリケーションのバージョンで「YYYY.MM.DD」を使用している場合、アプリケーション・ビルダーは、この書式マスクを任意のアプリケーション属性の最終更新日に置換します。

イメージ接頭辞

アプリケーション・ビルダーによって分散されたイメージ・ディレクトリを指すためにWebサーバーが使用する仮想パスを決定します。インストール時、仮想パスは/i/として構成されます。

静的テキスト（ページ、リージョン・ヘッダー、リージョン・フッターなど）にイメージを埋め込む場合は、置換文字列#IMAGE_PREFIX#を使用してイメージを参照できます。 たとえば、イメージgo.gifを参照するには、次の構文を使用します。

<img src="#IMAGE_PREFIX#go.gif">

参照: 「IMAGE_PREFIX」、「イメージの管理」および「イメージの参照」

プロキシ・サーバー

プロキシ・サーバーを指定する場合は、このフィールドを使用します。

たとえば、URLリージョン・ソース・タイプを使用する場合、プロキシ・サーバーが必要になる場合があります。URLリージョン・ソースは、URLの結果（URLにナビゲートすると戻されるページ）をリージョン・ソースとして埋め込みます。 URLがアプリケーション・ビルダーに対してファイアウォールの外側にある場合にファイアウォールを使用するには、プロキシ・サーバーを指定する必要があります。

PL/SQLパッケージ変数APEX_APPLICATION.G_PROXY_SERVERを使用すると、PL/SQLからこのフィールドに入力した値を参照できます。

ロギング

ユーザー・アクティビティをOracle Application Expressアクティビティ・ログに記録するかどうかを決定します。 「はい」に設定した場合、すべてのページ・ビューがログに記録されるため、管理者はアプリケーションごとにユーザー・アクティビティを監視できます。

高容量アプリケーションでは、ロギングを無効にすることをお薦めします。

デバッグ

カレント・アプリケーションのデバッグ・モードを制御します。使用可能なオプションは次のとおりです。

  • 「はい」を指定すると、アプリケーションをデバッグ・モードで実行できます。

  • 「いいえ」を指定すると、アプリケーションをデバッグ・モードで実行できなくなります。

アプリケーションの開発時は、アプリケーションをデバッグ・モードで実行すると有効です。 ただし、本番アプリケーションでは、デバッグを無効にし、ユーザーがアプリケーション・ロジックを参照できないようにすることをお薦めします。

解析対象スキーマ

アプリケーション内のすべてのSQLおよびPL/SQLが解析対象となるスキーマを指定します。 #OWNER#置換文字列を使用すると、SQL問合せおよびPL/SQL（リージョンやプロセスなど）でこの値を参照できます。

完全置換

完全置換がサポートされているかどうかを確認します。 完全置換を使用します。 非完全置換は非推奨の機能です。

完全置換では、次の構文を使用します。

&ITEM.

非完全置換では、次の構文を使用します。

&ITEM

可用性

可用性属性を使用して、アプリケーションのステータスとビルド・ステータスを定義し、アプリケーションを管理します。たとえば、ステータス「制限されたアクセス」を選択すると、アプリケーションにアクセスして実行できるユーザーを指定できます。 表4-2に、この属性を示します。

表4-2 アプリケーションの可用性の属性

属性 説明

ステータス

アプリケーションが使用可能または使用不可であることを指定します。オプションは次のとおりです。

  • 使用可能: アプリケーションは制限なしで使用可能です。

  • 「編集リンクで使用可能」: アプリケーションは使用可能です。開発者に対しては、「開発者」ツールバーが各ページの下部に表示されます。開発者が同じブラウザ・セッションでアプリケーション・ビルダーにログインする必要があります。

  • 開発者のみ使用可能: 開発者権限を持つユーザーがアプリケーションを使用できます。

  • 制限されたアクセス: 「カンマ区切りのユーザー・リスト限定」に指定された開発者がアプリケーションを使用できます。

  • 使用不可: アプリケーションは実行も編集もできません。 ユーザーがアプリケーションへアクセスしようとすると、「使用できないアプリケーションに対するメッセージ」内のメッセージが表示されます。

  • 使用不可（PL/SQLで表示されるステータス）: アプリケーションは実行も編集もできません。

  • 使用不可（URLにリダイレクト）: アプリケーションは実行できません。ユーザーは、「使用できないアプリケーションに対するメッセージ」に入力されたURLにリンクされます。

参照: 「アプリケーション、ページおよびページ・コンポーネントへのアクセスの制御」

ビルド・ステータス

カレント・アプリケーションのビルド・ステータスを指定します。オプションは次のとおりです。

  • アプリケーションの実行および構築: 開発者およびユーザーは、アプリケーションの実行および開発の両方を行うことができます。

  • アプリケーションの実行のみ: ユーザーは、アプリケーションの実行のみができます。 このオプションは、本番インスタンスのアプリケーションを対象としています。

参照: 「配置時のアプリケーションのビルド・ステータスの変更」

使用できないアプリケーションに対するメッセージ

この属性は、ステータスと組み合せて使用します。ステータスを「使用不可」、「使用不可(PL/SQLで表示されるステータス)」または「使用不可(URLにリダイレクト)」に設定すると、この属性に入力したテキストが表示されます。ステータスを「使用可能」に設定すると、この属性に入力したテキストは表示されません。

カンマ区切りのユーザー・リスト限定(ステータスが「制限されたアクセス」の場合のみ)

この属性はステータス「制限されたアクセス」と組み合せて使用します。ステータスを「制限されたアクセス」に設定すると、この属性に示されているユーザーのみがアプリケーションを実行できます。この属性を使用するには、次のステップを実行します。

  1. 「ステータス」リストから、「制限されたアクセス」を選択します。

  2. 表示されたフィールドに、アプリケーションを実行できるユーザーのカンマ区切りのリストを入力します。

グローバル通知

グローバル通知属性を使用して、アプリケーション・ユーザーのシステム・ステータスと通信できます。たとえば、スケジュールされた停止時間をユーザーに通知したり、アプリケーションの可用性に関するその他のメッセージをユーザーに送信する場合に使用できます。 アプリケーションで使用されているページ・テンプレートに#GLOBAL_NOTIFICATION#置換文字列が含まれている場合は、ここに入力したテキストが置換文字列のかわりに表示されます。

グローバル通知を作成するには、次のステップを実行します。

  1. ページ・テンプレートに#GLOBAL_NOTIFICATION#置換文字列を含めます。

  2. 「定義の編集」ページにナビゲートし、グローバル通知属性にメッセージを入力します。

  3. 「変更の適用」をクリックします。

置換

このフィールドを使用して、アプリケーションの静的置換文字列を定義します。静的置換文字列は、アプリケーション内の多くの箇所に存在するフレーズまたはラベルに使用できます。 置換文字列を作成するには、「置換文字列」列に文字列名、「置換値」列に文字列値を入力します。

静的置換文字列を定義すると、このページで定義する置換文字列を1回変更するだけで、アプリケーションの複数の場所にあるテキスト文字列をまとめて変更できます。

ロゴ

「ロゴ」属性は、アプリケーションのロゴの定義に使用します。 アプリケーションのロゴは、テキストベースまたはイメージベースにできます。 この機能を使用するには、ページ・テンプレートに#LOGO#置換文字列が含まれている必要があります。

アプリケーションのロゴを定義するには、次のステップを実行します。

  1. 「ロゴ・タイプ」で、次のいずれかを選択します。

    • アプリケーションのロゴにイメージを使用する場合は、「イメージ」を選択します。

    • アプリケーションのロゴにテキストを使用する場合は、「テキスト」を選択します。

  2. 「ロゴ」に、次のように入力します。

    • イメージの場合は、ファイル名拡張子を含めて完全なイメージ名を入力します。次に例を示します。

      /i/oracle.gif

    • テキストの場合は、完全なテキスト文字列を入力します。次に例を示します。

      Sample Application

  3. 「ロゴ属性」に、適切なロゴ属性を入力します。

    イメージの例:

    width="100" height="20" alt="Company Logo"

    テキストの例:

    style="font-family:Arial; color:#000000; font-size:18; white-space:nowrap; font-weight:bold;"
ビルド・オプション

既存のビルド・オプションを表示します。 ほとんどのアプリケーションに、ビルド・オプション属性があります。ビルド・オプションは、INCLUDEまたはEXCLUDEという2つの値をとることができます。 属性を含めるように指定すると、Application Expressエンジンは、実行時にその属性を認識します。 ただし、属性を排除するように指定すると、Application Expressエンジンは、その属性を存在しないものとして処理します。

特定のインストールからそのオブジェクトを排除する場合以外は、ビルド・オプションを指定しないでください。

テーマ

アプリケーションに適用される現行のテーマを表示します。テーマは、アプリケーション全体のレイアウトおよびスタイルの定義に使用できるテンプレートのコレクションです。各テーマには多数のテンプレートが集められ、アプリケーションに必要となる可能性があるすべてのユーザー・インタフェース・パターンが収録されています。

テンプレートのデフォルト

このアプリケーションのデフォルトのテンプレートが表示されます。 アプリケーション・レベルで新しいデフォルトのテンプレートを指定するには、次のいずれかの操作を実行します。

「ページ属性」ページの「ページ・テンプレート」リストから選択しても、このデフォルトを上書きできます。

表4-3に、カレント・アプリケーションのテンプレートのデフォルト属性を示します。

表4-3 アプリケーション・テンプレートのデフォルト属性

属性 説明

デフォルト・ページ・テンプレート

ページを表示するためのデフォルトのページ・テンプレートを指定します。「ページ属性」ページの「ページ・テンプレート」リストから選択すると、この値を上書きできます。

参照: 「ページ属性の概要」

出力モード・ページ・テンプレート

Application Expressエンジンが「印刷用」モードの場合に使用するテンプレートを指定します。

Application Expressエンジンをコールしてページをレンダリングするときに、指定した出力モード・ページ・テンプレートを使用してページを表示する必要があるかどうかを指定するオプションがあります。

「はい」に指定すると、印刷用テンプレートを使用してページが表示されます。 Application Expressエンジンは、HTMLフォーム・フィールド内のすべてのテキストをテキストとして表示します。 印刷用テンプレートには、#FORM_OPEN#置換文字列または#FORM_CLOSE#置換文字列は必要ありません。

参照: 「印刷用ページの最適化」

エラー・ページ・テンプレート

（オプション）インライン表示されるエラーではなく、個別のページに表示されるエラーに使用するページ・テンプレートを指定します。

コンポーネントのデフォルト値

ウィザードの実行時に使用するデフォルトのテンプレートを表示します。これらの設定は、各コントロールまたはコンポーネントの属性ページで上書きできます。 表4-4に、カレント・アプリケーションのコンポーネントのデフォルトを示します。

表4-4 コンポーネントのデフォルト

属性 説明

カレンダ

新しいカレンダを作成する場合に使用するデフォルトのカレンダ・テンプレートです。

ラベル

新しいページ・アイテムを作成する場合に使用するデフォルトのラベル・テンプレートです。

レポート

新しいレポートを作成する場合に使用するデフォルトのレポート・テンプレートです。

リスト

リストを作成する場合に使用するデフォルトのテンプレートです。

ブレッドクラム

ブレッドクラムを作成する場合に使用するデフォルトのテンプレートです。

ボタン

テンプレートによって制御される新しいボタンを作成する場合に使用するデフォルトのテンプレートです。

リージョン

新しいリージョンを作成する場合に使用するデフォルトのリージョン・テンプレートです。

チャート・リージョン

チャートを作成する場合に使用するデフォルトのリージョン・テンプレートです。

フォーム・リージョン

フォームを作成する場合に使用するデフォルトのリージョン・テンプレートです。

レポート・リージョン

レポートを作成する場合に使用するデフォルトのリージョン・テンプレートです。

表形式フォーム・リージョン

表形式フォームを作成する場合に使用するデフォルトのリージョン・テンプレートです。

ウィザード・リージョン

新しいウィザード・コンポーネントを作成する場合に使用するデフォルトのリージョン・テンプレートです。

ブレッドクラム・リージョン

新しいブレッドクラムを作成する場合に使用するデフォルトのリージョン・テンプレートです。

リスト・リージョン

新しいリストを作成する場合に使用するデフォルトのリージョン・テンプレートです。

セキュリティ属性の構成

アプリケーションに対するセキュリティを提供するには、「セキュリティ属性の編集」ページで属性を編集します。選択したセキュリティ属性は、アプリケーション内のすべてのページに適用されます。

このセクションの内容は次のとおりです。


参照:

「アプリケーション・セキュリティの管理」

「セキュリティ属性の編集」ページへのアクセス

「セキュリティ属性の編集」ページにアクセスするには、次のステップを実行します。

  1. 「作業領域」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

  2. アプリケーションを選択します。

  3. 「属性の編集」をクリックします。

    「アプリケーション属性」ページが表示されます。

  4. 「セキュリティ」をクリックします。

「セキュリティ属性の編集」ページが表示されます。

その他のナビゲーション方法

「セキュリティ属性の編集」ページは、「認証」、「認可」、「データベース・スキーマ」、「セッション・ステート保護」および「仮想プライベート・データベース」のセクションに分かれています。ページをスクロールするか、ページ上部にあるナビゲーション・ボタンをクリックすると、これらのセクションにアクセスできます。

sec_attribute_tabs.gifの説明が続きます。
sec_attribute_tabs.gifの説明

ページ上部にあるボタンを選択すると、選択したセクションが表示され、その他のセクションはすべて一時的に非表示になります。ページのすべてのセクションを表示するには、「すべての表示」をクリックします。

「セキュリティ属性」ページ

次のセクションでは、「セキュリティ属性の編集」ページで使用可能な属性について説明します。

このセクションの内容は次のとおりです。

認証

認証は、ユーザーがアプリケーションにアクセスする前に、そのユーザーの本人確認を行うプロセスです。アプリケーションに対して複数の認証スキームを定義しても、一度にカレントに設定できるスキームは1つだけです。 表4-5に、認証で使用可能な属性を示します。

表4-5 認証属性

属性 説明

ホーム・リンク

URL、またはアプリケーションを実行するときに実行されるプロシージャを指定します。

たとえば、ホーム・リンクに、「アプリケーション」ホームページの検索に使用する相対URLを含めることができます。 たとえば、f?p=6000:600は、ホームページ番号が600であるアプリケーション6000を示します。この例では、アプリケーション・テンプレート内の#HOME_LINK#置換文字列は、ホーム・リンクに入力した値に置換されます。

この属性を使用してプロシージャに名前を付けることもできます。 たとえば、アプリケーション・ホームとして機能するHTMLページをレンダリングするpersonal_calendarなどのプロシージャを作成できます。

注意: 認証後に表示されるページを決定するために「ホーム・リンク」属性は使用しないでください。認証後に表示されるページは、アプリケーションの認証スキーム内の他のコンポーネントによって決定されます。

参照: 「HOME_LINK」

ログインURL

HTML内の&LOGIN_URL.またはテンプレート内の#LOGIN_URL#置換文字列を置換します。

参照: 「LOGIN_URL」および「認証スキームの作成」

パブリック・ユーザー

データベース・アクセス記述子（DAD）を介してデータベースへの接続に使用するOracleスキーマを指定します。 デフォルト値は、データベース・サーバー・バージョンがOracle Database Express Editionである環境ではANONYMOUS、他のすべてのバージョンのデータベース・サーバーではAPEX_PUBLIC_USERになります。

ユーザーの本人確認が行われると、Application Expressエンジンが組込み置換文字列APP_USERの値を設定して、各ユーザーを追跡します。

注意: 以前のバージョンのOracle Application Expressでは、組込み置換文字列HTMLDB_PUBLIC_USERが使用されていました。

APP_USERがこの値と等しい場合、Application Expressエンジンはカレント・セッションをパブリック・ユーザー・セッションとみなします。 Application Expressエンジンは、次の組込み表示条件をサポートしています。

  • USER_IS_PUBLIC_USER

  • USER_IS_NOT_PUBLIC_USER

カレント・アプリケーション・ユーザー（APP_USER）がこの属性の値と等しい場合、ユーザーはパブリック・ユーザーとしてログインされます。一部のアプリケーションには、パブリック・モード（ログインが不要）およびプライベート・モード（ログインが必要）があります。ユーザーがパブリック・ユーザーかどうかを判断して、条件付きで情報の表示と非表示を切り替えることができます。

たとえば、ユーザーがパブリック・ユーザーの場合はログイン・ボタンを表示し、ユーザーがパブリック・ユーザーでない場合にはログアウト・リンクを表示するように設定できます。 この値を参照するには、APEX_APPLICATION.G_PUBLIC_USERを使用します。 また、Application Expressには、組込み条件タイプUSER_IS_PUBLIC_USERおよびUSER_IS_NOT_PUBLICも含まれています。

参照: 「HOME_LINK」および「条件付きのレンダリングおよびプロセスの理解」

認証スキーム

新しい認証スキームを定義するには、このボタンをクリックします。

参照: 「認証の仕組みの理解」および「認証スキームの作成」

認可

認可は、ユーザー権限に基づいて、特定のコントロールまたはコンポーネントへのユーザーのアクセスを制御します。「認可スキーム」リストから選択して、アプリケーションの認可スキームを指定できます。アプリケーション全体に割り当てることができる認可は1つのみです。ただし、認可スキームは、個々のページ、ページ・コントロール（リージョン、ボタン、アイテムなど）または共有コンポーネント（メニュー、リスト、タブなど）に割り当てることができます。

新しい認可スキームを作成するには、「認可スキームの定義」をクリックします。

認可スキームはバイナリ操作で、結果は成功（true）または失敗（false）のいずれかになります。成功すると、コンポーネントまたはコントロールを表示できます。失敗すると、コンポーネントまたはコントロールの表示または処理のいずれも行うことはできません。認可スキームをページに割り当てることに失敗すると、そのページではなくエラー・メッセージが表示されます。ただし、認可スキームをページ・コントロール（リージョン、ボタン、アイテムなど）に割り当てる場合は、失敗してもエラー・ページは表示されません。かわりに、コントロールが表示されないか、またはその処理や実行が行われません。

データベース・スキーマ

カレント・アプリケーションのデータベース・スキーマを指定するには、解析対象スキーマを使用します。定義後は、アプリケーションによって発行されるすべてのSQLおよびPL/SQLコマンドが、定義したデータベース・スキーマの権限で実行されます。

セッション・ステート保護

セッション・ステート保護を有効にすると、ハッカーがアプリケーション内のURLを改ざんするのを防ぐことができます。URL改ざんにより、プログラム・ロジック、セッション・ステートの内容および情報プライバシーが悪影響を受ける可能性があります。

アプリケーションのセッション・ステート保護を有効または無効にするには、「セッション・ステート保護」リストから選択します。セッション・ステート保護を有効に設定すると、ページおよびアイテム・レベルで定義されたセッション・ステート保護コントロールがオンになります。

セッション・ステート保護を構成するには、「セッション・ステート保護の管理」をクリックします。

仮想プライベート・データベース(VPD)

仮想プライベート・データベース（VPD）は、開発者がセキュリティ・ポリシーをデータベースの表およびビューに割り当てることができるApplication Program Interface（API）を提供します。開発者はPL/SQLを使用して、ストアド・プロシージャを含むセキュリティ・ポリシーを作成し、RDBMSパッケージをコールしてそのプロシージャを表またはビューにバインドできます。このようなポリシーは、データベース内に格納されているアプリケーション・データのコンテンツか、またはOracleデータベースが提供するコンテキスト変数に基づいています。これによって、VPDではアクセス・セキュリティ・メカニズムをアプリケーションから取り除き、集約できます。

このフィールドで入力したPL/SQLは、ユーザーの認証直後に実行されます。V('USER')は、このファンクションからアクセス可能です。カレント・コールのセッション・ステートは、このコールが実行される時点ではまだ初期化されません。アプリケーションがVPDを使用して、同じデータベースで複数の顧客をサポートする必要がない場合は、この属性をNULLのままにしてください。


参照:

「認可を介したセキュリティの提供」および『Oracle Label Security管理者ガイド』

グローバリゼーション属性の構成

アプリケーション・ビルダーでは、同時に複数の言語で実行可能なアプリケーションを開発できます。 単一のアプリケーションを言語変換して、異なる言語に対応させることができます。「グローバリゼーション属性の編集」ページで属性を使用して、アプリケーションのプライマリ言語などのグローバリゼーション・オプションを指定します。

このセクションの内容は次のとおりです。


参照:

「アプリケーションのグローバリゼーションの管理」

「グローバリゼーション属性の編集」ページへのアクセス

「グローバリゼーション属性の編集」ページにアクセスするには、次のステップを実行します。

  1. 「作業領域」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

  2. アプリケーションを選択します。

    「アプリケーション・ビルダー」ホームページが表示されます。

  3. 「属性の編集」をクリックします。

    「アプリケーション属性」ページが表示されます。

  4. 「グローバリゼーション」をクリックします。

    「グローバリゼーション属性の編集」ページが表示されます。

「グローバリゼーション属性の編集」ページ

次のセクションでは、「グローバリゼーション属性の編集」ページで使用可能な属性について説明します。


参照:

「アプリケーションへのプライマリ言語の指定」

アプリケーションのプライマリ言語

アプリケーションを開発する言語を指定します。この言語が、すべての変換の元となるベース言語になります。たとえば、英語で作成されたアプリケーション100が、フランス語に変換され、アプリケーション101として公開されたとします。英語がアプリケーションのプライマリ言語になります。

アプリケーションに対するすべての変更は、ここで指定したプライマリ言語で行う必要があります。

アプリケーション言語の派生元

アプリケーション・ビルダーでアプリケーション言語を判別または派生させる方法を指定します。

アプリケーションのプライマリ言語は静的にする（Webブラウザの言語から派生される）か、またはユーザー・プリファレンスまたはアイテムから決定されるようにできます。データベース言語の設定では、日付の表示方法と特定の情報のソート方法を決定します。

このオプションを使用すると、派生したブラウザ言語のサポートを無効にできます。アプリケーションのプリファレンスから派生したアプリケーション言語を指定するオプションも表示されます。

自動CSVエンコーディング

「自動CSVエンコーディング」で、アプリケーションにおけるすべてのカンマ区切り（CSV）レポート出力のエンコーディングが制御されます。「自動CSVエンコーディング」のデフォルト値は「いいえ」です。「自動CSVエンコーディング」が「はい」に設定されていると、CSVレポートの出力が、ローカライズされたデスクトップ・アプリケーションと互換性のあるキャラクタ・セットに適切に変換されます。CSVエンコーディングのキャラクタ・セットは、「アプリケーション言語の派生元」の設定によって決定されます。

アプリケーション・ビルダーのページのエンコーディングは、Application Expressへのアクセスに使用されるデータベース・アクセス記述子（DAD）のキャラクタ・セットによって決定されます。 たとえば、データベース・アクセス記述子のキャラクタ・セットがAL32UTF8の場合、Application Expressのユーザー・インタフェースのすべてのアプリケーションにおけるすべてのページがUTF-8でエンコードされます。

デフォルトでは、レポート・リージョンからのCSV出力はデータベース・アクセス記述子と同じキャラクタ・セットでエンコードされます。ただし、一部のデスクトップ・スプレッドシート・アプリケーションでは、クライアント側のデスクトップ・オペレーティング・システムのキャラクタ・セットでデータをエンコードする必要があります。マルチバイト・データの場合は、レポート・リージョンからのCSV出力をデスクトップ・スプレッドシート・アプリケーションから開くと、文字化けすることがよくあります。 これは、CSV出力がそのデスクトップ・アプリケーションに必要なエンコーディングと異なる方法でエンコードされているためです。「自動CSVエンコーディング」を有効にすると、この問題が解決されます。

たとえば、アプリケーションでのユーザーの言語プリファレンスがdeの場合、CSVデータはデータベース・アクセス記述子のキャラクタ・セット設定にかかわらず、Western European Windows 1252でエンコードされます。ユーザーの言語プリファレンスがzh-cnの場合、CSVデータは中国語（GBK）でエンコードされます。

「ページ定義」の概要

「ページ定義」は、ページの基本的なビルディング・ブロックです。 各ページにボタンおよびフィールド（アイテムと呼ばれる）を配置できます。これらは、リージョンと呼ばれるコンテナにグループ化されています。 また、ページにはアプリケーション・ロジック（プロセス）も配置できます。ページでは、条件付きナビゲーションを使用したあるページから次のページへのブランチ、計算の実行、検証（編集確認など）の実行、およびレポート、カレンダおよびチャートの表示を行うことができます。 「ページ定義」にアクセスして、ページを定義するコントロールを表示、作成および編集します。

このセクションの内容は次のとおりです。


参照:

「「ページ定義」の「ビュー」リストの使用」、「「ページ定義」の編集」、「ページ属性の概要」および「ページの検索」

「ページ定義」へのアクセス

「ページ定義」を使用すると、ページを定義するコントロールを表示、作成および編集できます。

既存のページの「ページ定義」にアクセスするには、次のステップを実行します。

  1. 「作業領域」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

    「アプリケーション・ビルダー」ホームページが表示されます。

  2. アプリケーションを選択します。

    「アプリケーション」ホームページが表示されます。

  3. ページを選択します。

    「ページ定義」が表示されます。


参照:

「ページの検索」

「ページ定義」の理解

「ページ定義」は、ページの基本的なビルディング・ブロックです。 「ページ定義」を使用すると、コントロール、およびページを定義するアプリケーション・ロジックを表示、作成および編集できます。 次のセクションでは、「ページ定義」の様々な部分について説明します。

このセクションの内容は次のとおりです。

ナビゲーション・バーの使用可能なコントロールおよびボタン

ナビゲーション・バーは、ブレッドクラム・トレイルのすぐ下に表示されます。

pg_def_top.gifの説明が続きます。
pg_def_top.gifの説明

ページのナビゲーション・バーで使用可能なコントロールは、次のとおりです。

  • ページ: カレント・ページ番号を表示します。 他のページを表示するには、「ページ」フィールドにページ番号を入力し、「実行」をクリックします。

  • 「戻る」および「次へ」: これらのボタンは左山カッコ（<）と右山カッコ（>）の記号に似ています。 前後のページに移動するには、これらのボタンをクリックします。

  • ビュー: カレント・ページ・ビューを制御します。 代替レポートを表示するには、リストから選択し、「実行」をクリックします。 詳細は、「「ページ定義」の「ビュー」リストの使用」を参照してください。

次のボタンがナビゲーション・バーの右側に表示されます。

  • 実行: カレント・ページをApplication Expressエンジンに送信し、表示可能なHTMLをレンダリングします。詳細は、「ページまたはアプリケーションの実行」を参照してください。

  • コピー: カレント・ページのコピーを作成します。 新しいページ番号およびページ名を指定します。

  • 削除: カレント・ページを削除します。

  • 作成: 新しいページを作成するウィザードにリンクします。詳細は、「「ページ定義」からのページの作成」を参照してください。


参照:

「ページのアプリケーションへの追加」および「ページまたはアプリケーションの実行」

「ページの実行」アイコン、「開発者のコメント」アイコン、「ロック」アイコン、「ページのエクスポート」アイコンおよび「検索」アイコン

「ページの実行」アイコン、「開発者のコメント」アイコン、「ロック」アイコン、「ページのエクスポート」アイコンおよび「検索」アイコンは、ページの右上にある「ユーティリティ」タブの下に表示されます。

pg_def_icons.gifの説明が続きます。
pg_def_icons.gifの説明

「ページの実行」アイコン

「ページの実行」アイコンは、小さな薄緑色の信号機に似ています。 カレント・ページを表示可能なHTMLにレンダリングするには、このアイコンをクリックします。 ページの実行時、Application Expressエンジンは、データベースに格納されたデータに基づいて、ページを動的にレンダリングします。詳細は、「ページまたはアプリケーションの実行」を参照してください。

「開発者のコメント」アイコン

「開発者のコメント」アイコンは、緑色の吹出しに似ています。 アプリケーション、ページまたはページのグループにコメントを追加するには、このアイコンを使用します。 詳細は、「開発者のコメントの追加」を参照してください。

「ロック」アイコン

「ロック」アイコンは、ページが編集用に使用可能かどうかを示します。ページのロックが解除されている場合、アイコンは鍵が開いた南京錠として表示されます。ページがロックされている場合、アイコンは鍵が掛かった南京錠として表示されます。 ロック・ステータスを変更するには、このアイコンをクリックします。詳細は、「ページのロックおよびロック解除」を参照してください。

「ページのエクスポート」アイコン

「ページのエクスポート」アイコンは、下矢印に似ています。 カレント・ページをエクスポートするには、このアイコンをクリックします。 詳細は、「アプリケーションのページのエクスポート」を参照してください。

「検索」アイコン

「検索」アイコンは、懐中電灯に似ています。 カレント・アプリケーション内または作業領域に関連付けられているスキーマ内のアイテム、ページ、問合せ、表またはPL/SQLを検索するには、このアイコンをクリックします。 詳細は、「アイテム、ページ、問合せ、表またはPL/SQLコードの検索」を参照してください。

「ページ・レンダリング」、「ページ・プロセス」および「共有コンポーネント」

すべての「ページ定義」は3つのセクションに分かれています。

  • ページ・レンダリング: ページ・レンダリングは、データベースからページを生成するプロセスです。 「ページ・レンダリング」セクションには、ユーザー・インタフェース・コントロールと、ページのレンダリング時に実行されるロジックが表示されます。 詳細は、「ページ・レンダリングの概要」を参照してください。

  • ページ・プロセス: ページを送信すると、ページ・プロセスが実行されます。 通常、ユーザーがボタンをクリックするとページが送信されます。 「ページ・プロセス」セクションには、ページ・プロセス時に評価および実行されるロジック・コントロール（計算やプロセスなど）が表示されます。 詳細は、「ページ・プロセスの概要」を参照してください。

  • 共有コンポーネント: 「共有コンポーネント」セクションには、アプリケーション内の1つ以上のページで使用可能な共通のコンポーネントが表示されます。 詳細は、「共有コンポーネントの概要」を参照してください。


参照:

「ページの検索」および「「ページ定義」の編集」

「ページ定義」の「ビュー」リストの使用

「ビュー」リストを使用すると、「ページ定義」から「ページ・イベント」、「データベース・オブジェクトの依存性」、「履歴」、「エクスポート」、「グループ」および「参照コンポーネント」ページに簡単に切り替えることができます。

このセクションの内容は次のとおりです。


参照:

「「ページ定義」の理解」

「ページ定義」の「ビュー」リストへのアクセス

「ビュー」リストを使用して他のページにアクセスするには、次のステップを実行します。

  1. 「作業領域」ホームページにナビゲートします。

  2. 「アプリケーション・ビルダー」アイコンをクリックします。

  3. アプリケーションを選択します。

  4. ページを選択します。

    「ページ定義」が表示されます。

  5. 「ビュー」リストから次のいずれかを選択し、「実行」をクリックします。

「ページ・イベント」の概要

「ページ・イベント」には、現在定義されているすべてのページ・コントロールおよびページ・プロセスの詳細が表示されます。 このページには、Application Expressエンジンによるページのレンダリング、ロジックの起動およびプロセスの実行の方法および順序を示す時系列のビューが表示されます。

ナビゲーション・バーは、ブレッドクラム・トレイルのすぐ下に表示されます。 使用可能なコントロールは次のとおりです。

  • ページ: カレント・ページ番号を表示します。 他のページを表示するには、「ページ」フィールドにページ番号を入力し、「実行」をクリックします。

  • 「戻る」および「次へ」: これらのボタンは左山カッコ（<）と右山カッコ（>）の記号に似ています。 前後のページに移動するには、これらのボタンをクリックします。

  • ビュー: カレント・ページ・ビューを制御します。 代替レポートを表示するには、リストから選択し、「実行」をクリックします。 詳細は、「「ページ定義」の「ビュー」リストの使用」を参照してください。

  • すべての表示: 現在定義されていないものも含め、すべての使用可能なページ・コントロールおよびページ・プロセスが表示されます。

  • 使用済の表示: 現在使用しているページ・コントロールおよびページ・プロセスが表示されます（デフォルト）。

特定のページ・コントロールまたはページ・プロセスの詳細を表示するには、該当するハイパーテキスト・リンクをクリックします。また、各エントリの左側の小さいアイコンをクリックすると、新しいページ・コントロールおよびページ・プロセスを作成できます。

「データベース・オブジェクトの依存性」の概要

「データベース・オブジェクトの依存性」ページには、カレント・ページで参照されるデータベース・オブジェクトのリストが表示されます。

ナビゲーション・バーは、ブレッドクラム・トレイルのすぐ下に表示されます。 使用可能なコントロールは次のとおりです。

  • ページ: カレント・ページ番号を表示します。 他のページを表示するには、「ページ」フィールドにページ番号を入力し、「実行」をクリックします。

  • ビュー: カレント・ページ・ビューを制御します。 代替レポートを表示するには、リストから選択し、「実行」をクリックします。 詳細は、「「ページ定義」の「ビュー」リストの使用」を参照してください。

  • 「戻る」および「次へ」: これらのボタンは左山カッコ（<）と右山カッコ（>）の記号に似ています。 前後のページに移動するには、これらのボタンをクリックします。

「履歴」の概要

「履歴」ページには、現在選択されているページに対する最近の変更の履歴が、開発者（またはユーザー）、アプリケーション、ページ番号、更新日、コンポーネントおよびアクションごとに表示されます。

ナビゲーション・バーは、ブレッドクラム・トレイルのすぐ下に表示されます。 使用可能なコントロールは次のとおりです。

  • ページ: カレント・ページ番号を表示します。 他のページを表示するには、「ページ」フィールドにページ番号を入力し、「実行」をクリックします。

  • 表示: 表示されるページの数を決定します。 表示されるページの数を変更するには、「表示」リストで数を選択し、「実行」をクリックします。

  • ビュー: カレント・ページ・ビューを制御します。 代替レポートを表示するには、リストから選択し、「実行」をクリックします。 詳細は、「「ページ定義」の「ビュー」リストの使用」を参照してください。

「エクスポート」の概要

カレント・ページおよびその参照コンポーネントをエクスポートするには、「エクスポート」ページを使用します。 ナビゲーション・バーは、ブレッドクラム・トレイルのすぐ下に表示されます。 使用可能なコントロールは次のとおりです。

  • ページ: カレント・ページ番号を表示します。 他のページを表示するには、「ページ」フィールドにページ番号を入力し、「実行」をクリックします。

  • ビュー: カレント・ページ・ビューを制御します。 代替レポートを表示するには、リストから選択し、「実行」をクリックします。 詳細は、「「ページ定義」の「ビュー」リストの使用」を参照してください。


参照:

「「ページの実行」アイコン、「開発者のコメント」アイコン、「ロック」アイコン、「ページのエクスポート」アイコンおよび「検索」アイコン」、「別の開発インスタンスへのアプリケーションの移動方法」および「アプリケーションのページのエクスポート」

「グループ」の概要

「グループ」ページには、カレント・ページと同じページ・グループに含まれるすべてのページが表示されます。 ページ番号をクリックしてページ・グループを編集します。ページ名をクリックして「ページ定義」を表示します。

ナビゲーション・バーは、ブレッドクラム・トレイルのすぐ下に表示されます。 使用可能なコントロールは次のとおりです。

  • ページ: カレント・ページ番号を表示します。 他のページを表示するには、「ページ」フィールドにページ番号を入力し、「実行」をクリックします。

  • 表示: 表示されるページの数を決定します。 表示されるページの数を変更するには、「表示」リストで数を選択し、「実行」をクリックします。

  • ビュー: カレント・ページ・ビューを制御します。 代替レポートを表示するには、リストから選択し、「実行」をクリックします。 詳細は、「「ページ定義」の「ビュー」リストの使用」を参照してください。


参照:

「「ページの実行」アイコン、「開発者のコメント」アイコン、「ロック」アイコン、「ページのエクスポート」アイコンおよび「検索」アイコン」および「ページのグループ化」

「参照」の概要

「参照コンポーネント」ページには、カレント・ページに関連付けられているページ・コンポーネントおよび共有コンポーネントが表示されます。

ナビゲーション・バーは、ブレッドクラム・トレイルのすぐ下に表示されます。 使用可能なコントロールは次のとおりです。

  • ページ: カレント・ページ番号を表示します。 他のページを表示するには、「ページ」フィールドにページ番号を入力し、「実行」をクリックします。

  • ビュー: カレント・ページ・ビューを制御します。 代替レポートを表示するには、リストから選択し、「実行」をクリックします。 詳細は、「「ページ定義」の「ビュー」リストの使用」を参照してください。

ページ定義の編集

ページは、アプリケーションの基本的なビルディング・ブロックです。 各ページには、ページ番号、名前、および通常はヘッダー、タイトル、フッターなどのテキスト属性が含まれます。ページ・コントロール（リージョン、アイテムおよびボタン）を作成して、ページにコンテンツを追加します。ページ・テンプレートおよびページ・リージョン・テンプレートは、各ページのルック・アンド・フィールを制御します。

このセクションの内容は次のとおりです。


参照:

「「ページ定義」の概要」、「ページ属性の概要」および「ページの検索」

「すべての編集」アイコン

各「ページ定義」は、「ページ・レンダリング」、「ページ・プロセス」および「共有コンポーネント」の3つのセクションに分かれています。 これらの各セクションは、コントロール、コンポーネントまたはアプリケーション・ロジックのタイプを識別するヘッダーを持つサブセクションに分かれています。

サブセクション・タイトルの右側に表示される「すべての編集」アイコンをクリックして、特定のサブセクション内のすべてのコントロール、コンポーネントまたはロジックを編集できます。「すべての編集」アイコンは、鉛筆が付いた小さいグリッドに似ています。

pg_def_editall_ico.gifの説明が続きます。
pg_def_editall_ico.gifの説明

たとえば、「リージョン」の下の「すべての編集」を選択すると、カレント・ページで現在定義されているすべてのリージョンのサマリー・レポートが表示されます。このサマリー・ビューを使用して次の操作を実行できます。

  • 使用可能なフィールドおよび選択リストから新しく選択して、一度に複数の属性を編集できます。

  • 「編集」アイコンをクリックして、定義ページにリンクできます。

各ページ上部にある「次へ」および「戻る」ボタンをクリックして、次のページまたは前のページの同様のサマリー・ビューにアクセスできます。サマリー・ビューの編集内容を保存するには、「変更の適用」をクリックします。

「ページ定義」で名前を選択して、特定のコントロールまたはコンポーネントの属性を表示することもできます。たとえば、「ページ定義」にCustomersという名前のリージョンが含まれているとします。 リージョン名「Customers」をクリックすると、そのリージョンの属性ページが表示されます。


参照:

「ページ・レンダリングの概要」、「ページ・プロセスの概要」および「共有コンポーネントの概要」

「コピー」アイコンまたは「作成」アイコン

「コピー」アイコンおよび「作成」アイコンをクリックして、新しいコントロールまたはコンポーネントをコピーまたは作成できます。「コピー」アイコンは、2つの小さなページが重なっているように見えます。「コピー」アイコンをクリックすると、既存のコントロールまたはコンポーネントのコピーを作成できます。

pg_def_copy_ico.gifの説明が続きます。
pg_def_copy_ico.gifの説明

「作成」アイコンは、小さなページに重なっているプラス（+）記号のように見えます。「作成」アイコンをクリックすると、新しいコントロールまたはコンポーネントを作成できます。

pg_def_create_ico.gifの説明が続きます。
pg_def_create_ico.gifの説明

ページ・コンポーネントの順序変更

「ページ定義」の「リージョンの順序変更」アイコンを使用すると、リージョン、ボタンおよびアイテムが表示される順序を簡単に変更できます。 「リージョンの順序変更」アイコンは、薄緑色の下矢印と上矢印として表示されます。

reorder_regions.gifの説明が続きます。
reorder_regions.gifの説明


参照:

「「リージョンの順序変更」アイコンの使用」、「「ボタンの順序変更」アイコンの使用」および「「リージョン・アイテムの順序変更」アイコンの使用」

ページ・レンダリングの概要

ページ・レンダリングは、データベースからページを生成するプロセスです。 「ページ・レンダリング」セクションを使用して、ページのレンダリングに影響するコントロール（ページ定義、リージョン、ボタン、アイテム、ページ・レンダリングの計算、ページ・プロセスなど）を変更します。

page_rendering.gifの説明が続きます。
page_rendering.gifの説明

ヘッダーの下のアイコンをクリックして、特定のサブセクションに簡単にナビゲートできます。 これらのアイコンのいずれかを選択すると、選択したサブセクションが表示され、他のすべてのサブセクションは一時的に非表示になります。表示をリストアするには、「すべての表示」をクリックします。「すべての表示」アイコンは、逆三角形のように見えます。

このセクションの内容は次のとおりです。


参照:

「「ページ定義」の概要」、「「すべての編集」アイコン」および「「コピー」アイコンまたは「作成」アイコン」

ページ

ページ属性によって、ページ名などのページ固有の特性の制御、ページ・タイトルや関連ページ・テンプレートなどの属性、ヘッダー・テキスト、選択した認可スキームなどの表示が行われます。ページ属性には、「ページ定義」からアクセスします。


参照:

「ページ属性の概要」

リージョン

リージョンはページ上の領域で、コンテンツのコンテナとして機能します。各ページには任意の数のリージョンを設定できます。リージョンのコンテンツは、リージョン・ソースによって決まります。たとえば、リージョンには、定義したSQL問合せに基づくレポートまたは静的なHTMLが含まれる場合があります。

リージョンの外観は、特定のリージョン・テンプレートで制御します。リージョンを使用すると、ページ・コントロール（アイテムやボタン）をグループ化できます。また、追加のHTMLを生成しない単純なリージョンを作成したり、HTML表やイメージ内でコンテンツを形成する詳細なリージョンを作成することもできます。


参照:

  • リージョンの作成方法および編集方法については、「リージョンの理解」を参照してください。

  • PL/SQLを使用したWebアプリケーションの開発については、『Oracle Databaseアプリケーション開発者ガイド-基礎編』を参照してください。

  • htpパッケージについては、『Oracle Database PL/SQLパッケージ・プロシージャおよびタイプ・リファレンス』を参照してください。

ボタン

アプリケーションを設計する際、ボタンを使用してユーザーを特定のページまたはURLに移動させたり、ユーザーがページを送信できるようにすることができます。 ページを送信すると、Application Expressエンジンによって情報がポストまたは処理されます。ボタンは、HTMLボタンやイメージとして、またはテンプレートを使用して実装できます。ボタンは、事前定義されたリージョン・テンプレート位置またはフォーム内のアイテムに配置できます。


参照:

「ボタンの作成」

アイテム

アイテムは、関連するセッション・ステートを持つテキスト・フィールド、選択リスト、チェック・ボックスなどのHTMLフォーム要素です。アイテム属性は、ページ上のアイテムの表示および動作に影響します。たとえば、これらの属性は、ラベルの表示位置、アイテムの大きさおよびアイテムの表示位置（左右、上下）に影響します。

アイテムには、ページ・アイテムとアプリケーション・アイテムという2つのカテゴリが存在します。 ページ・アイテムはページ上に配置され、「表示形式」、「ラベル」、「ラベル・テンプレート」などの関連付けられたユーザー・インタフェースのプロパティを持ちます。アプリケーション・アイテムはページに関連付けられないため、ユーザー・インタフェースのプロパティを持ちません。アプリケーション・アイテムは、グローバル変数として使用できます。


参照:

「アイテムの作成」

計算

計算は、セッション・ステートをアイテムに割り当てるために使用される論理単位です。計算を使用すると、ページが送信または表示されたときに、指定したアイテムに値を割り当てることができます。


参照:

「ページ計算の作成」および「アプリケーションの計算の理解」

プロセス

プロセスは、データ操作言語（DML）またはPL/SQLを実行するために使用されるロジック・コントロールです。 たとえば、プロセスを使用してページのレンダリング時にセッション・ステートに移入し、なんらかのロジック（PL/SQLの使用など）を実行したり、レンダリング・エンジンをコールできます。通常、1つのプロセスは、1つのアクションを実行します。 プロセスには、手動でコーディングされたPL/SQL、事前定義済プロセスを起動するプロセスなどがあります。


参照:

「ページ・プロセスの理解」および「アプリケーション・プロセスの理解」

ページ・プロセスの概要

ページ・プロセスは、ページを送信するプロセスです。 通常、ユーザーがボタンをクリックするとページが送信されます。 「ページ定義」の「ページ・プロセス」セクションで、計算、検証、プロセス、ブランチなどのアプリケーション・ロジックを指定します。 通常、Application Expressエンジンは、「ページ定義」に表示された順序でこのロジックを実行します。

page_processing.gifの説明が続きます。
page_processing.gifの説明

ヘッダーの下のアイコンをクリックして、特定のサブセクションに簡単にナビゲートできます。 これらのアイコンのいずれかを選択すると、選択したサブセクションが表示され、他のすべてのサブセクションは一時的に非表示になります。表示をリストアするには、「すべての表示」をクリックします。「すべての表示」アイコンは、逆三角形のように見えます。

このセクションの内容は次のとおりです。


参照:

「「ページ定義」の概要」、「「すべての編集」アイコン」および「「コピー」アイコンまたは「作成」アイコン」

計算

計算は、セッション・ステートをアイテムに割り当てるために使用される論理単位です。ページの処理時に実行されます。


参照:

「ページ計算の理解」

検証

検証によって、ユーザーによる入力が有効かどうかを検証するロジック・コントロールを作成できます。たとえば、検証で、必須フィールドに値が入力されたかどうかを確認できます。


参照:

「検証の理解」および「「対象ボタン」属性」

プロセス

プロセスは、データ操作言語（DML）またはPL/SQLを実行するために使用されるロジック・コントロールです。 プロセスは、ページの送信後に実行されます。


参照:

「ページ・プロセスの理解」

ブランチ

ブランチによって、ユーザーがアプリケーション内をナビゲートする方法を決定するロジック・コントロールを作成できます。


参照:

「ブランチの理解」および「「対象ボタン」属性」

共有コンポーネントの概要

「ページ定義」の「共有コンポーネント」セクションには、アプリケーション内のすべてのページに表示または適用される共通の要素が表示されます。

shared_components.gifの説明が続きます。
shared_components.gifの説明

ヘッダーの下のアイコンをクリックして、特定のサブセクションに簡単にナビゲートできます。 これらのアイコンのいずれかを選択すると、選択したサブセクションが表示され、他のすべてのサブセクションは一時的に非表示になります。表示をリストアするには、「すべての表示」をクリックします。「すべての表示」アイコンは、逆三角形のように見えます。


参照:

「共有コンポーネントでの作業」

このセクションの内容は次のとおりです。


参照:

「「ページ定義」の概要」、「「すべての編集」アイコン」および「「コピー」アイコンまたは「作成」アイコン」

タブ

タブは、アプリケーションのページ間でのナビゲートに有効な方法です。 アプリケーション・ビルダーには、標準タブおよび親タブという2つのタイプのタブが含まれています。

タブが1レベルのみのアプリケーションでは、標準タブ・セットを使用します。標準タブ・セットは、特定のページに関連付けられます。標準タブを使用すると、アプリケーション内の他のページにユーザーをリンクできます。親タブ・セットは、標準タブのグループを保持するコンテナとして機能します。親タブを使用すると、ナビゲーションのレベルおよびアプリケーション内でのコンテキスト（位置）を増やすことができます。


参照:

「タブの作成」

LOV

LOVは、ラジオ・グループ、チェック・ボックス、選択リストなどの、特定のタイプのページ・アイテムを表示するために使用される静的定義または動的定義です。LOVは、静的（事前定義された一連の表示値および戻り値に基づく）または動的（表から値を選択するSQL問合せに基づく）のいずれかです。 作成したLOVは、1つ以上のページ・アイテムによって参照できます。

LOVは、「LOV」ウィザードを実行してLOVリポジトリに追加して、アプリケーション・レベルで定義します。


参照:

「LOVの作成」

ブレッドクラム

ブレッドクラムは、テンプレートを使用してレンダリングされるリンクの階層的なリストです。たとえば、ブレッドクラムをリンクのリストまたはブレッドクラム・パスとして表示できます。


参照:

「ブレッドクラムの作成」

リスト

リストは、テンプレートを使用してレンダリングされるリンクのコレクションです。リストの各エントリに対して、表示テキスト、ターゲットURL、およびリスト・エントリがいつどのように表示されるかを制御するその他の属性を指定します。リストの表示や、すべてのリスト・エントリの外観は、そのリストをテンプレートにリンクすることによって制御します。


参照:

「リストの作成」

テーマ

テーマは、アプリケーションのユーザー・インタフェースを定義するテンプレートのコレクションです。各テーマには、すべてのタイプのアプリケーション・コンポーネントおよびページ・コントロール（個々のページ、リージョン、レポート、リスト、ラベル、メニュー、ボタンおよびLOV）のテンプレートが含まれます。


参照:

「テーマの管理」

テンプレート

テンプレートは、アプリケーション内のページのルック・アンド・フィールを制御します。 アプリケーションの作成時に、ページ、リージョン、レポート、リスト、ラベル、メニュー、ボタンおよびポップアップLOVのテンプレートを指定します。テンプレートのグループは、テーマという指定したコレクションで構成されます。


参照:

「テンプレートのカスタマイズ」

セキュリティ

アプリケーションに対するセキュリティを提供するには、認可スキームを指定します。認可は、ユーザー権限に基づいてリソースへのアクセスを制御することを示す広義語です。


参照:

「認可を介したセキュリティの提供」

ナビゲーション・バー

ナビゲーション・バーを使用すると、アプリケーション内の様々なページにユーザーをリンクできます。 通常、ナビゲーション・バーは、ユーザーがヘルプ・テキストに対してログイン、ログアウト、またはリンクできるようにする場合に使用します。ナビゲーション・バーの位置は、関連付けられたページ・テンプレートによって異なります。ナビゲーション・バー・アイコンを使用すると、イメージまたはテキストからのリンクを表示できます。 ナビゲーション・バー・アイコンの作成時に、イメージ名、テキスト、表示順序およびリンク先の位置（URLまたはページ）を指定できます。


参照:

「ナビゲーション・バー・エントリの作成」

ページ計算の理解

ページ計算を使用して、ページが送信または表示されたときに、指定したアイテムに値を割り当てます。アプリケーション・レベルの計算を使用して、アイテムに値を割り当てることもできます。ほとんどのアプリケーション・レベルの計算は、アプリケーションのすべてのページで実行されます。一方、ページ・レベルで作成された計算は、ページのレンダリングまたは処理時にのみ実行されます。


参照:

「アプリケーションの計算の理解」

このセクションの内容は次のとおりです。

ページ計算の作成

ページ計算を作成するには、「ページ計算の作成」ウィザードを実行します。各計算には、計算の作成対象のアイテムおよび計算タイプを指定します。


参照:

「計算」

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

  1. 該当する「ページ定義」にナビゲートします。

    1. 「作業領域」ホームページにナビゲートします。

    2. 「アプリケーション・ビルダー」アイコンをクリックします。

    3. アプリケーションを選択します。

    4. ページを選択します。

      「ページ定義」が表示されます。

  2. 「計算」で、「作成」アイコンをクリックします。

  3. 「アイテムの位置」で、計算の実行位置を選択し、「次へ」をクリックします。位置のオプションは次のとおりです。

    • このページのアイテム

    • 他のページのアイテム

    • アプリケーション・レベル・アイテム

  4. 「アイテム」で、計算を実行するアイテムと計算ポイントを選択します。

    1. 計算アイテム: 計算によって更新されるアイテムを選択します。

    2. 順序: 評価の順序を選択します。

    3. 計算ポイント: 計算を実行するポイントを選択します。計算ポイント「新しいインスタンス開始時」では、新しいセッション（またはインスタンス）の生成時に計算が実行されます。

    4. 計算タイプ: 作成する計算の方法を選択します。

    5. 「次へ」をクリックします。

  5. 「計算」で、選択した計算タイプに対応する計算を入力し、「次へ」をクリックします。

  6. 「条件」では、計算を条件付きにすることができます。 計算を条件付きにするには、「条件タイプ」リストから条件タイプを選択し、式のフィールドにテキストを入力します。

  7. 「作成」をクリックします。

計算ポイントおよび計算構文の理解

計算の使用例には、電話番号を入力するためのフォーム・フィールドのあるページがあります。 この例では、電話番号がデータベースの1つの列に格納されていますが、データ入力フォームでは電話番号が市外局番、市内局番および回線番号の3つの部分に分割されています。 この例では、それらのページ・アイテムはP10_AREA_CODE、P10_PREFIXおよびP10_LINE_NUMBERと呼ばれます。

次に、それらのアイテムに格納されている値を1つの文字列に結合する必要があるとします。 これは、「送信後」の計算を使用し、結合した値をP10_PHONE_NUMBERというアイテム内に格納することによって行うことができます。

P10_AREA_CODE、P10_PREFIXおよびP10_LINE_NUMBERの結合した値を新しいアイテムに格納する計算を作成するには、次のステップを実行します。

  1. 該当する「ページ定義」にナビゲートします。

  2. P10_PHONE_NUMBERという新しいアイテムを作成して、P10_AREA_CODE、P10_PREFIXおよびP10_LINE_NUMBERの結合した値を格納します。詳細は、「ページ・レベル・アイテムの理解」を参照してください。

  3. 「計算」で、「作成」アイコンをクリックします。

  4. 「アイテムの位置」で、「このページのアイテム」を選択して「次へ」をクリックします。

  5. 「計算」で、「P10_PHONE_NUMBER」を選択します。

  6. 「順序」で、評価の順序を選択します。

  7. 「計算」では、次のいずれかの計算タイプの作成を選択できます。

    1. 静的割当て:

      • 「計算タイプ」で、「静的割当て」を選択して「次へ」をクリックします。

      • 次の計算を入力します。

        (&P10_AREA_CODE.) &P10_PREFIX.-&P10_LINE_NUMBER.

      • 「次へ」をクリックします。

    2. PL/SQLファンクション本体:

      • 「計算タイプ」で、「PL/SQLファンクション本体」を選択して「次へ」をクリックします。

      • 次の計算を入力します。

        DECLARE
l_return_value  VARCHAR2(300) DEFAULT NULL;
BEGIN
    l_return_value :=
'('||:P10_AREA_CODE||')'||:P10_PREFIX||'-'||:P10_LINE_NUMBER;
RETURN l_return_value;
END;

      • 「次へ」をクリックします。

    3. SQL問合せ:

      • 「計算タイプ」で、「SQL問合せ」を選択して「次へ」をクリックします。

      • 次の計算を入力します。

        SELECT '('||:P10_AREA_CODE||')'||:P10_PREFIX||'-'||:P10_LINE_NUMBER FROM DUAL

      • 「次へ」をクリックします。

    4. PL/SQL式:

      • 「計算タイプ」で、「PL/SQL式」を選択して「次へ」をクリックします。

      • 次の計算を入力します。

        '('||:P10_AREA_CODE||')'||:P10_PREFIX||'-'||:P10_LINE_NUMBER

      • 「次へ」をクリックします。

  8. 「作成」をクリックします。

ページ計算属性の編集

計算を作成した後、「ページ計算の編集」ページでそれを編集できます。

ページ計算を編集するには、次のステップを実行します。

  1. 該当する「ページ定義」にナビゲートします。

    1. 「作業領域」ホームページにナビゲートします。

    2. 「アプリケーション・ビルダー」アイコンをクリックします。

    3. アプリケーションを選択します。

    4. ページを選択します。

      「ページ定義」が表示されます。

  2. 「計算」で、計算名を選択します。

    「ページ計算の編集」ページが表示されます。

  3. 「変更の適用」をクリックします。

計算ポイントおよび計算ソースの編集

計算を実行するタイミングを制御するには、「計算ポイント」属性で順序および計算ポイントを指定します。計算ポイント「新しいインスタンス開始時」では、新しいセッション（またはインスタンス）の生成時に計算が実行されます。

「ソース」で、式または問合せを入力してアイテムの値を計算します。 計算が失敗した場合のために、「計算エラー・メッセージ」フィールドにエラー・メッセージを定義できます（オプション）。

条件付き計算の作成

「条件タイプ」リストから条件タイプを選択し、式のフィールドにテキストを入力して、条件付き計算を作成できます。

検証の理解

検証を宣言的に定義するには、検証方法を選択します。検証メッセージ・フィールドに、実際の検証の編集確認を入力します。検証が失敗した場合は、後続のページ・プロセスまたは計算が行われないことに注意してください。また、入力した検証は、選択した検証タイプと一貫性がある必要があることも注意してください。検証タイプの詳細は、オンライン・ヘルプを参照してください。

このセクションの内容は次のとおりです。


参照:

「「対象ボタン」属性」

検証の作成

新しい検証を作成するには、次のステップを実行します。


注意:

検証に対して入力するテキストは、3,950文字以下にする必要があります。

  1. 該当する「ページ定義」にナビゲートします。

    1. 「作業領域」ホームページにナビゲートします。

    2. 「アプリケーション・ビルダー」アイコンをクリックします。

    3. アプリケーションを選択します。

    4. ページを選択します。

      「ページ定義」が表示されます。

  2. 「ページ・プロセス」の「検証」で、「作成」アイコンをクリックします。

    「検証の作成」ウィザードが表示されます。

  3. 検証レベルを選択します。アイテム・レベル検証は、1つのアイテムに固有です。ページ・レベル検証は、1つのアイテムに適用されるのではなく、ページ全体に適用されます。

  4. アイテム・レベル検証を選択した場合、検証するアイテムを選択し、「次へ」をクリックします。

  5. 表4-6に示す検証方法を選択します。

    表4-6 検証方法

    検証方法 説明

    SQL

    アイテム値をデータベース内のデータと比較します。

    たとえば、SQL検証を使用して、フィールドに入力された姓がデータベースに存在しているかどうかを検証できます。 次のExists SQL検証では、フィールド名がP1_LAST_NAME、表名がcustomersです。

    SELECT 1 FROM customers
WHERE last_name = :P1_LAST_NAME

    PL/SQL

    入力されたデータを検証するために複雑なロジックが必要な場合に有効です。

    たとえば、住所が米国以外の場合に、ユーザーに州または都道府県の入力を求める住所フォームの検証を作成する必要があるとします。次のPL/SQLを使用して、ブールを戻すファンクションとしてこの検証を作成できます。

    BEGIN
  IF :P1_COUNTRY = 'US' AND :P1_PROVINCE IS NULL THEN
     RETURN FALSE;
  ELSE
    RETURN TRUE;
  END IF;
END;

    次のように、PL/SQL式として実装される同じ検証を作成することもできます。

    NOT (:P1_COUNTRY='US' AND  :P1_PROVINCE IS NULL);

    アイテム・レベルNULL

    セッション・ステートのアイテム値がNULLかどうかを確認します。

    たとえば、アイテム検証を作成し、「アイテムがNOT NULL」の検証方法を選択することで、ユーザーがフィールドに値を入力したことを検証できます。

    アイテム文字列の比較

    アイテム値を特定の文字列と比較します。

    アイテムの値をリテラル文字列と比較する文字列の比較検証がいくつかあります。たとえば、検証タイプ「式1のアイテムが式2に含まれる」を選択して、指定した値リストに対してフィールドへのユーザー入力を検証します。

    「式1」に、検証するアイテムの名前をコロンなしで入力します。次に例を示します。

    P1_VALUE

    「式2」に、検証対象の値の文字列を入力します。次に例を示します。

    ABC/DEF/GHI

    正規表現

    正規表現は、テキスト・パターンを記述するメソッドを提供します。正規表現検証を使用すると、データ検証を実行できます。

    たとえば、入力されたデータの文字列が6つの数字を含むグループで常に構成され、各グループがカンマで区切られていることを検証する場合は、次の正規表現検証を使用できます。

    ^([[:digit:]]{6},)+$

    この正規表現検証では、次のエントリは有効とみなされます。

    123456,654321,

    123456,

    123456,123456,654321,

    ただし、次の表現は有効とみなされません。

    123456,12345

    12345

  6. SQL、PL/SQLおよびアイテム文字列の比較検証の場合、作成する検証のタイプを選択し、「次へ」をクリックします。

  7. 順序および検証名を指定し、「次へ」をクリックします。

  8. 検証方法に応じて、検証が失敗した場合に表示する検証またはメッセージ・テキストを入力します。「次へ」をクリックします。

  9. この検証に適用される条件を定義し、「作成」をクリックします。


参照:

「フォームでのユーザー入力の検証」

検証エラー・メッセージの表示方法の定義

検証エラー・メッセージをインライン表示（検証が実行されたページで表示）するか、個別のエラー・ページで表示するかを選択できます。

検証エラー・メッセージの表示方法を定義するには、次のステップを実行します。

  1. 該当する「ページ定義」にナビゲートします。

    1. 「作業領域」ホームページにナビゲートします。

    2. 「アプリケーション・ビルダー」アイコンをクリックします。

    3. アプリケーションを選択します。

    4. ページを選択します。

      「ページ定義」が表示されます。

  2. 「検証」で、該当する検証を選択します。

    検証の属性ページが表示されます。

  3. 「エラー・メッセージ」までスクロールします。

  4. 「エラー・メッセージ」に、エラー・メッセージ・テキストを入力します。

  5. 「エラー・メッセージ表示位置」から表示位置を選択します。

    この属性で検証エラー・メッセージの表示位置を指定します。検証エラー・メッセージは、エラー・ページに表示したり、既存ページ内にインラインで表示できます。インライン・エラー・メッセージは、通知領域（ページ・テンプレートの一部として定義される）に表示したり、フィールド・ラベル内に表示できます。

    すべての処理（検証を含む）を停止するハード・エラーを作成する場合は、エラー・ページにエラーを表示する必要があります。

  6. 「フィールドでインライン表示」または「フィールドおよび通知でインライン表示」を選択した場合は、アイテムをエラー・メッセージに関連付ける必要があります。アイテムをエラー・メッセージに関連付けるには、「関連付けられたアイテム」リストからアイテムを選択します。

  7. 「変更の適用」をクリックします。


ヒント:

「フィールドでインライン表示」または「フィールドおよび通知でインライン表示」を選択した場合、検証エラー・メッセージが表示されると、ページの再レンダリング時にApplication Expressエンジンによって計算またはプロセスは実行されません。

検証の条件付き実行

「条件」で、検証を実行するタイミングおよび検証を実行するかどうかを制御できます。

既存の検証に対して条件を作成するには、次のステップを実行します。

  1. 該当する「ページ定義」にナビゲートします。

    1. 「作業領域」ホームページにナビゲートします。

    2. 「アプリケーション・ビルダー」アイコンをクリックします。

    3. アプリケーションを選択します。

    4. ページを選択します。

      「ページ定義」が表示されます。

  2. 「検証」で、該当する検証を選択します。

    検証の属性ページが表示されます。

  3. 「条件」までスクロールします。

  4. ユーザーが特定のボタンをクリックしたときに検証を実行させるには、「対象ボタン」リストから選択します。

  5. 「条件タイプ」リストから選択します。

  6. 選択した条件タイプに応じて、式属性に値を入力します。指定した条件に一致した場合、検証がレンダリングまたは処理されます。

  7. 「変更の適用」をクリックします。

ページ・プロセスの理解

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

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


参照:

「アプリケーション・プロセスの理解」

このセクションの内容は次のとおりです。

ページ・プロセスの作成

プロセスを作成するには、「プロセスの作成」ウィザードを実行します。 ウィザードの実行時、プロセス名の定義、順序とプロセスの実行ポイントの指定およびプロセス・カテゴリの選択を行います。「ページ・プロセスの編集」ページで、これらのほぼすべての属性を変更できます。

新しいプロセスを作成するには、次のステップを実行します。

  1. 該当する「ページ定義」にナビゲートします。

    1. 「作業領域」ホームページにナビゲートします。

    2. 「アプリケーション・ビルダー」アイコンをクリックします。

    3. アプリケーションを選択します。

    4. ページを選択します。

      「ページ定義」が表示されます。

  2. 「プロセス」で、「作成」アイコンをクリックします。

  3. カテゴリを選択します。 表4-7に、使用可能なページ・プロセス・カテゴリを示します。

    表4-7 プロセス・カテゴリ

    プロセス・カテゴリ 説明

    データ操作

    データ操作プロセス・タイプは、データ操作言語（DML）のアクションをサポートするためにウィザードによってよく使用されます。 アプリケーション・ビルダーは、次の宣言的なデータ操作プロセスをサポートしています。

    • 「行の自動フェッチ」および「行の自動処理(DML)」を選択すると、自動データ操作言語（DML）プロセスが作成されます。

    • 「複数行の更新」および「複数行の削除」は、表形式フォームと組み合せて使用します。

    • 「表形式フォームに行の追加」は、表形式フォームと組み合せて使用します。

    ポップアップ・ウィンドウを閉じる

    ポップアップ・ウィンドウ内で実行されているプロセスに適用されます。 このプロセス・タイプを実行すると、カレント・ポップアップ・ウィンドウが閉じられます。

    フォーム・ページ区切り

    マスター・ディテール・フォームに関連付けられたディテール・レコードを使用してページ区切りを実装します。このプロセスは、マスター・ディテール・フォーム（「マスター・ディテール」ウィザードのフォームなど）で最もよく使用されます。マスター表をチェックして、現在のディテール・レコード・セットおよび次のディテール・レコードを確認します。

    参照: 「マスター・ディテール・フォームの作成」

    オンデマンド

    特定のページからコールされた場合のみ実行される、アプリケーション・レベルのプロセスを作成します。このプロセス・タイプをページ・レベルで作成すると、既存のアプリケーション・レベルのプロセスへの参照が作成されます。

    参照: 「オンデマンド・アプリケーション・プロセス」

    PL/SQL

    指定したPL/SQLを実行します。このプロセス・タイプを使用して、プロセスに直接入力したPL/SQLブロックを実行したり、既存のAPIをコールします。

    ページ区切りのリセット

    「レポート」リージョンで、ページ区切りを最初の結果セットへリセットします。 Application Expressエンジンは、指定された結果セット内のユーザーの位置を追跡します。このプロセス・カテゴリは、ユーザーを最初の結果セットに戻します。つまり、レポート・リージョンに関連付けられたカウンタをリセットして、次回結果セットが表示するときに、結果セットの最初の部分を戻します。

    セッション・ステート

    既存のセッション・ステート・アイテムの値をNULLに設定します。このプロセス・タイプを選択すると、既存のユーザー設定、アプリケーション、セッションまたはアイテムのキャッシュが消去されます。

    参照: 「セッション・ステート値の管理」および「ユーザー・プリファレンスの管理」

    Webサービス

    Webサービスをページ上のプロセスとして実装します。このプロセスを実行すると、リクエストがサービス・プロバイダに送信されます。

    参照: 「プロセスとしてのWebサービスの起動」

  4. 画面に表示されるステップに従います。

プロセス属性の編集

プロセスを作成すると、「ページ・プロセスの編集」ページで属性を編集することによって、プロセスを実行するタイミングおよびプロセスの内容を制御できます。

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

  1. 該当する「ページ定義」にナビゲートします。

    1. 「作業領域」ホームページにナビゲートします。

    2. 「アプリケーション・ビルダー」アイコンをクリックします。

    3. アプリケーションを選択します。

    4. ページを選択します。

      「ページ定義」が表示されます。

  2. プロセス名を選択します。

    「ページ・プロセスの編集」ページが表示されます。


参照:

「「対象ボタン」属性」

プロセス・ポイントおよびプロセス・ソースの変更

プロセスを実行するタイミングを制御するには、「プロセス・ポイント」で順序番号およびプロセス・ポイントを指定します。「プロセスの実行」で次のいずれかのオプションを選択すると、後続のページへのアクセス時におけるプロセスの実行を制限できます。

  • ページへのアクセスごとに1回

  • セッションごとまたはリセット時に1回

PL/SQLのプロセス・タイプに適切なコードを入力します。「PL/SQL無名ブロック」プロセスの場合は、「プロセス」で適切なコードを入力します。「キャッシュの消去」プロセスの場合は、「ソース」に適切なコードを入力します。プロセスが失敗した場合のために、「プロセス・エラー・メッセージ」フィールドにエラー・メッセージを定義できます（オプション）。

条件付きプロセスの作成

「条件付きプロセス」で、条件タイプを選択して式を入力すると、プロセスを条件付きで作成できます。

また、「対象ボタン」属性から選択することもできます。このリストからボタンを選択すると、プロセスは、選択したボタンをユーザーがクリックした場合のみ実行されます。

ブランチの理解

ブランチは、特定のページ、プロシージャまたはURLへ移動する指示です。たとえば、ページ1の送信後、ページ1からページ2にブランチできます。

新しいブランチを作成するには、「ページ・ブランチの作成」ウィザードを実行して、ブランチ・ポイントおよびブランチ・タイプを指定します。ブランチ・タイプは、作成するブランチのタイプを定義します。ブランチ・タイプの詳細は、オンライン・ヘルプを参照してください。

このセクションの内容は次のとおりです。


参照:

「「対象ボタン」属性」

ブランチ・ポイントおよびブランチ・アクションの定義

アプリケーションの標準タブをクリックすると、Application Expressエンジンは、セッション・ステートを設定し、計算を実行してから、ユーザーをターゲット・ページにリンクします。プロセスまたは明示的に定義されたブランチは実行しません。 標準タブをクリックせずにページを送信すると、Application Expressエンジンによってブランチが明示的に定義され、後続のページが表示されます。

ブランチを実行するタイミングを制御するには、「ブランチ・ポイント」リストからブランチ・ポイントを選択します。使用可能なオプションは次のとおりです。

  • 送信時: 計算の前: 計算、検証またはプロセスの前にブランチが実行されます。 このオプションは、プロセスを起動する必要がないボタン（「取消」ボタンなど）に使用します。

  • 送信時: 検証の前: 計算の後、検証またはプロセスの前にブランチが実行されます。検証が失敗すると、ページ・プロセスは停止し、ロールバックが実行され、ページにエラーが表示されます。このデフォルト動作のために、ブランチを作成して検証を提供する必要がありません。ただし、計算の結果に応じてブランチする必要がある場合があります（たとえば、前のブランチ・ポイントに戻る場合）。

  • 送信時: プロセスの前: 計算および検証の後、プロセスの前にブランチが実行されます。このオプションを使用すると、検証されたセッション・ステートに基づいて、ページ・プロセスの実行前にブランチされます。

  • 送信時: プロセスの後: 計算、検証およびプロセスの後にブランチが実行されます。このオプションを使用すると、計算、検証およびプロセスの実行後にURLまたはページにブランチされます。このオプションを使用する際、任意のブランチ・ポイントに複数のブランチが存在する場合は、ブランチを順序付ける必要があります。

  • ロード時: ヘッダーの前: ページのレンダリング前にブランチが実行されます。このオプションを使用すると、カレント・ページではなく別のページが表示されるか、またはユーザーが別のURLまたはプロシージャにリダイレクトされます。

選択したブランチ・タイプによっては、「アクション」属性に次の追加情報を指定できます。

  • ブランチ先ページのページ番号

  • 最後にブランチ・ターゲット・ページをレンダリングするPL/SQLプロシージャ

  • URLアドレス

条件付きブランチ処理

他のコントロールと同様に、ブランチが条件付きで実行されるように設定できます。条件付きブランチを作成するには、「条件タイプ」リストから条件タイプを選択し、その条件タイプを実装するテキストを式のフィールドに入力します。


参照:

「ブランチを使用したナビゲーションの制御」

ページ属性の概要

ページ属性によって、ページ名などのページ固有の特性の制御、ページ・タイトルや関連ページ・テンプレートなどの属性、ヘッダー・テキスト、選択した認可スキームの表示が行われます。ページ属性には、「ページ定義」からアクセスします。

このセクションの内容は次のとおりです。

ページ属性へのアクセス

ページ属性を編集するには、次のステップを実行します。

  1. 「ページ定義」にナビゲートします。

    1. 「作業領域」ホームページにナビゲートします。

    2. 「アプリケーション・ビルダー」アイコンをクリックします。

    3. アプリケーションを選択します。

    4. ページを選択します。

      「ページ定義」が表示されます。

  2. 「ページ・レンダリング」で、ページのタイトルが表示されているセクションを検索します。

    pg_def_edit_pg_att.gifの説明が続きます。
    pg_def_edit_pg_att.gifの説明

    「ページ属性」ページは、特定のページ属性を制御するカテゴリ（「ページ名」、「タイトル」、「HTMLヘッダー」、「ロード時」、「ヘルプ・テキスト」、「テンプレート」など）に分かれています。

  3. ページ属性を編集するには、次のいずれかの操作を実行します。

    • 「ページ属性の編集」アイコンをクリックして「ページ属性」ページ全体にアクセスします。このアイコンは、鉛筆が付いた小さいページに似ています。

    • 特定のリンクをクリックします。 特定の情報が表示されます。


    ヒント:

    すべてのページ属性を一度に表示するには、「ページ属性の編集」アイコンをクリックします。

    「ページ属性」ページが表示されます。 必須の値には赤いアスタリスク（*）が付いています。

「ページ属性」ページの概要

「ページ属性」ページは、「名前」、「表示属性」、「ヘッダーおよびフッター」、「HTMLヘッダー」、「ロード時」、「セキュリティ」、「構成」、「エラー」、「ヘルプ」および「コメント」のセクションに分かれています。

pg_att_nav.gifの説明が続きます。
pg_att_nav.gifの説明

ページをスクロールするか、ページ上部にあるナビゲーション・ボタンをクリックすると、これらのセクションにアクセスできます。ページ上部にあるボタンを選択すると、選択したセクションが表示され、その他のセクションはすべて一時的に非表示になります。ページのすべてのセクションを表示するには、「すべての表示」をクリックします。

次のトピックでは、「ページ属性」ページ固有のセクションについて説明します。

名前

次の属性を使用して、ページ名、英数字の別名（オプション）、関連付けられたページ・グループなど、カレント・ページの一般的な属性を定義します。 表4-8に、この属性を示します。

表4-8 ページ属性: 名前

属性 説明

名前

アプリケーション開発者のカレント・ページの名前を指定します。 この名前は、ページ番号およびページ・タイトルとともに、多くのページおよびレポートで使用されます。

ページの別名

このページの英数字の別名を入力します。この別名は、カレント・アプリケーション内で一意である必要があります。

たとえば、アプリケーション100のページ1で作業している場合、別名「home」を作成できます。その後、次のf?p構文を使用して他のページからこのページにアクセスできます。

f?p=100:home

グループ

このページと関連付けるページ・グループを指定します。ページ・グループは、機能に影響しませんが、開発者がアプリケーション内のページを管理するのに役立ちます。

参照: 「ページのグループ化」

表示属性

次の属性を使用して、選択されるページ、標準タブ・セット、タイトル、カーソル・フォーカスなど、カレント・ページの一般的な表示属性を定義します。 表4-9に、この属性を示します。

表4-9 ページ属性: 表示属性

属性 説明

ページ・テンプレート

このページの外観を制御するページ・テンプレートを選択します。ページ・テンプレートを選択すると、現行のテーマ内に定義されたデフォルト・ページ・テンプレートが上書きされます。

参照: 「テーマのデフォルトのテンプレートの変更」

標準タブ・セット

このページに使用する標準タブ・セットを選択します。標準タブ・セットは、特定のページおよびページ番号に関連付けられます。標準タブを使用すると、特定のページにユーザーをリンクできます。

参照: 「タブの作成」

タイトル

ブラウザ・ウィンドウのタイトル・バーに表示するタイトルを入力します。 Application Expressエンジンは、ページ・テンプレートで使用される#TITLE#置換文字列のかわりに、ここで指定するタイトルを使用します。 このタイトルは、HTMLタグ<TITLE>></TITLE>の間に挿入されます。

カーソル・フォーカス

カーソル・フォーカスを指定します。使用可能なオプションは次のとおりです。

  • カーソル・フォーカスをページの最初のフィールドに配置するには、「ページの最初のアイテム」を選択します。

  • JavaScriptを含めない場合は、「フォーカスなし」を選択します。

ヘッダーおよびフッター

次の属性を使用して、ページ・ヘッダー、ボディ・ヘッダー、ボディ・フッターおよびページ・フッターのテキストを定義します。 表4-10に、この属性を示します。

表4-10 ページ・ヘッダー、フッターおよびテキストの属性

属性 説明

ヘッダー・テキスト

ページ・ヘッダーの直後、ボディ・コンテンツの前に表示するテキストまたはHTMLを入力します。

ボディ・ヘッダー

実行中のページに表示されるリージョンの前に表示するテキストまたはHTMLを入力します。 ここに入力するテキストは、ページ・テンプレートの#BOX_BODY#置換文字列の前に表示されます。

フッター

ページ・テンプレート・ボディの後、ページ・テンプレート・フッターの前に表示するテキストまたはHTMLを入力します。

HTMLヘッダー

この属性を使用して、ページ・テンプレート・ヘッダー内の#HEAD#置換文字列を置換します。 ここで入力する値は、HTML <HEAD>タグの後に挿入されます。これらの属性の一般的な用途は次のとおりです。

  • ページ固有のインライン・カスケード・スタイル・クラスのコード化

  • 特定のページのスタイルシートの追加

  • ページ固有のJavaScriptのコード化

  • ページ固有のメタ・タグ・ページ・リフレッシュのコード化

ロード時

この属性を使用して、ページのロード中にJavaScriptのコールなどのイベントを追加します。 「ページのHTMLボディ属性」で、ページ・テンプレートの#ONLOAD#置換文字列に置換されるJavaScriptまたはテキストを入力します。 この機能を使用するには、ページ・テンプレートに#ONLOAD#置換文字列が含まれている必要があります。

「ページのHTMLボディ属性」を使用して、開始タグ<body>のコンテンツに書き込むことができます。 通常のページ・テンプレートでは、次の例に示すとおり、開始の<body>タグで#ONLOAD#を使用する場合があります。

<html>
<head>
...
</head>
<body #ONLOAD# >

参照:

「アプリケーションへのJavaScriptの組込み」

セキュリティ

次の属性を使用して、カレント・ページの認可スキーム、認証およびセッション・ステート保護を指定します。 表4-11に、この属性を示します。

表4-11 ページ属性: セキュリティ

属性 説明

認可スキーム

ページに適用する認可スキームを選択します。認可スキームはアプリケーション・レベルで定義され、アプリケーション内の多くの要素に適用できます。

認可スキームは、アプリケーション・セッション（セッションの作成時）ごとに1回評価されるか、ページ・ビューごとに1回評価されます。選択した認可スキームがtrueと評価された場合、ページが表示され、他の定義された条件に従います。falseと評価された場合、ページは表示されず、エラー・メッセージが表示されます。

参照: 「認可を介したセキュリティの提供」

認証

このページがパブリック・ページとして定義されているか、または認証が必要かを指定します。ページをパブリック・ページとして指定した場合、ページは認証の前に表示されます。 この属性は、認証が必要なアプリケーションにのみ適用されます。アプリケーションのページ監視ファンクションは、このページ属性にアクセスして、表示前に事前認証が不要なページを識別できます。認証スキームのページ監視ファンクションの実装によって、この属性が影響を及ぼすかどうかが判別されます。

参照: 「認証を介したユーザーの本人確認」

重複する送信

「複製ページの送信を許可」リストを使用して、ユーザーがページを1行で繰り返し処理できるかどうかを指定します。重複するページ送信が繰り返し処理されないようにするには、この属性を「いいえ」に設定します。

重複するページ送信の例を次に示します。

  • ユーザーが「送信」ボタンを繰り返しクリックした場合

  • ブランチ・タイプ「ページにブランチ」を作成して、ユーザーがブラウザの再ロード・ボタンをクリックした場合

構成

ビルド・オプションを使用すると、機能を有効または無効にできます。ほとんどのアプリケーション属性は、ビルド・オプション属性を持ちます。特定の構成からそのページを排除する場合以外は、カレント・ページのビルド・オプションを指定しないでください。

ビルド・オプションは、INCLUDEまたはEXCLUDEという2つの値をとることができます。 属性を含めるように指定すると、Application Expressエンジンは、実行時にその属性をアプリケーション定義の一部として認識します。 逆に、属性を排除するように指定すると、Application Expressエンジンは、その属性を存在しないものとして処理します。


参照:

「ビルド・オプションを使用した構成の制御」

エラー・テキスト

この属性を使用して、ページでエラーが発生した場合に#NOTIFICATION_MESSAGE#テンプレート置換文字列内に表示するエラー・テキストを指定します。


参照:

「ページ・テンプレート」

ヘルプ

この属性を使用して、カレント・ページのヘルプ・テキストを入力します。

ヘルプ・テキストは、ヘルプ・システムを使用して表示されます。このヘルプ・システムは開発する必要があります。 特定のページのヘルプを表示するには、ヘルプ・テキストを表示するために作成したページからAPEX_APPLICATION.HELPプロシージャをコールします。たとえば、次のようなナビゲーション・バー・アイコンを使用できます。

f?p=4000:4600:&APP_SESSION.::&DEBUG::LAST_STEP:&APP_PAGE_ID.

ページ・レベル・ヘルプは、次の構文を使用したショートカットをサポートします。

"SHORTCUT_NAME"

参照:

「ヘルプ・ページの作成」および「ショートカットの使用」

コメント

この属性を使用して、カレント・ページに関するコメントを記録します。このコメントは、アプリケーションが実行されているときには表示されません。

「開発者」ツールバー

Application Expressエンジンは、データベース表に格納されたデータに基づいて、ページを動的にレンダリングおよび処理します。 レンダリングされたアプリケーションを表示するには、「実行」アイコンをクリックして、アプリケーションを実行するか、またはApplication Expressエンジンに送信します。


参照:

「ページまたはアプリケーションの実行」

開発環境内からのアプリケーションの実行時、ページの下部に「開発者」ツールバーが表示されます。 「開発者」ツールバーを使用すると、カレント・ページの編集、新しいページ、リージョンまたはページ・コントロールの作成、セッション・ステートの表示、デバッグ・モードの有効/無効の切替えを簡単に実行できます。「定義の編集」ページで「ステータス」属性を変更することによって、「開発者」ツールバーを表示するかどうかを制御できます。


参照:

「ステータス」リストについては、「「定義の編集」ページの概要」を参照してください。

d_toolbar.gifの説明が続きます。
d_toolbar.gifの説明

「開発者」ツールバーは、次のリンクで構成されています。

共有コンポーネントでの作業

共有コンポーネントは、アプリケーション内のすべてのページに表示または適用される共通の要素です。 「共有コンポーネント」ページのツールおよびウィザードは、アプリケーション・レベルまたは特定のページのいずれかで使用できます。

このセクションの内容は次のとおりです。

「共有コンポーネント」ページへのアクセス

「共有コンポーネント」ページにアクセスするには、次のステップを実行します。

  1. 「作業領域」ホームページにナビゲートします。

  2. 「アプリケーション・ビルダー」アイコンをクリックします。

  3. アプリケーションを選択します。

  4. 「アプリケーション」ホームページで、「共有コンポーネント」をクリックします。

    「共有コンポーネント」ページが表示されます。

  5. 共有コンポーネントを作成するには、該当するリンクを選択します。

「共有コンポーネント」ページ

次のセクションでは、「共有コンポーネント」ページの各リンクについて説明します。

アプリケーション・アイテム

アプリケーション・レベル・アイテムは表示されませんが、アプリケーションへのグローバル変数として使用されます。一般的に、ページ・レベル・アイテムの値を設定するには、アプリケーションの計算またはページ計算を使用します。 詳細は、「アプリケーション・レベル・アイテムの理解」を参照してください。

アプリケーション・プロセス

アプリケーション・プロセスを使用すると、次のようにPL/SQLロジックを実行できます。

  • アプリケーションの各ページの特定のポイントで

  • プロセスの実行条件で定義されているとおりに

  • 新しいセッションの作成時

「オンデマンド」プロセスは、ページ・レベルのオンデマンド・プロセスからコールされたときにのみ実行されます。 詳細は、「アプリケーション・プロセスの理解」を参照してください。

アプリケーションの計算

アプリケーション・レベルの計算を使用すると、表示される各ページに対して、または新しいアプリケーション・セッションが作成されたときに、アプリケーション・レベル・アイテムとページ・レベル・アイテムに値を割り当てることができます。アプリケーション・レベルの計算を作成し、条件付きで複数のページで実行することもできます。 詳細は、「アプリケーションの計算の理解」を参照してください。

Webサービス参照

アプリケーション・ビルダーのWebサービス参照は、Simple Object Access Protocol（SOAP）に基づいています。Webサービスへの参照を作成してアプリケーションに組み込み、フォームによって送信されたデータを処理したり、フォームまたはレポートに出力をレンダリングできます。 「Webサービスの実装」を参照してください。

ビルド・オプション

ビルド・オプションを使用すると、アプリケーションで特定の機能を条件付きで表示したり、処理することができます。ビルド・オプションによって、アプリケーションの配置ごとに有効にする機能を制御できます。 詳細は、「ビルド・オプションを使用した構成の制御」を参照してください。

認証スキーム

認証は、ユーザーがアプリケーションにアクセスする前に、そのユーザーの本人確認を行うプロセスです。 認証では、ユーザー名とパスワードの入力要求、ユーザーの本人確認または保護キーの使用が行われる場合があります。詳細は、「認証を介したユーザーの本人確認」を参照してください。

認可スキーム

認可スキームは、事前定義されたユーザー権限に基づいて、特定のコントロールまたはコンポーネントへのユーザーのアクセスを制限します。 詳細は、「認可を介したセキュリティの提供」を参照してください。

セッション・ステート保護

セッション・ステート保護は、ハッカーがアプリケーション内のURLを改ざんするのを防ぐための組込み機能です。URL改ざんにより、プログラム・ロジック、セッション・ステートの内容および情報プライバシーが悪影響を受ける可能性があります。 「セッション・ステート保護の理解」を参照してください。

セキュリティ属性の編集

「セキュリティ属性の編集」ページを使用して、アプリケーション内のすべてのページの一般的なセキュリティ属性を構成します。 詳細は、「セキュリティ属性の構成」を参照してください。

アプリケーションの翻訳

Oracle Application Expressでは、同時に複数の言語で実行可能なアプリケーションを開発できます。 単一のOracleデータベースとOracle Application Expressインスタンスでは、1つのアプリケーションを複数の言語でサポートできます。アプリケーションを言語変換するには、複数のステップを実行する必要があります。 詳細は、「アプリケーションの言語変換およびグローバリゼーション・サポート」および「言語変換プロセスの理解」を参照してください。

テキスト・メッセージ

テキスト・メッセージは、ユーザーが作成するPL/SQLコードからコールできる名前付きのテキスト文字列です。このPL/SQLは、ページ・プロセスおよびページ・リージョン、またはパッケージおよびプロシージャで無名ブロックとして使用できます。 詳細は、「メッセージの言語変換」を参照してください。

グローバリゼーション属性の編集

同時に複数の言語で実行可能なアプリケーションを開発できます。このリンクをクリックすると、アプリケーションのプライマリ言語属性、アプリケーション言語の派生元属性などのグローバリゼーション・オプションを指定できます。 詳細は、「グローバリゼーション属性の構成」および「アプリケーションの言語変換およびグローバリゼーション・サポート」を参照してください。

タブ

タブは、アプリケーションのページ間でのナビゲートに有効な方法です。標準タブまたは親タブという2つのタイプのタブを作成できます。標準タブ・セットは、特定のページおよびページ番号に関連付けられます。親タブ・セットは、標準タブのグループを保持するコンテナとして機能します。 詳細は、「タブの作成」を参照してください。

リスト

リストは、リンクの共有コレクションです。リストの外観は、リスト・テンプレートで制御します。各リスト要素には、いつ表示するかを制御できる表示条件があります。 詳細は、「リストの作成」を参照してください。

ブレッドクラム

ブレッドクラムを使用すると、階層的にナビゲートできます。ブレッドクラムは、テンプレートを使用して表示されるリンクの階層的なリストです。ブレッドクラムは、リンクのリストまたはブレッドクラム・パスとして表示できます。 詳細は、「ブレッドクラムの作成」を参照してください。

ツリー

ツリーを使用すると、階層的なデータまたは複数のレベルのデータ間で効率的に通信を行うことができます。 詳細は、「ツリーの作成」を参照してください。

ナビゲーション・バー・エントリ

ナビゲーション・バー・エントリは、アプリケーションのページ間を移動する単純なナビゲーション・パスを提供します。ナビゲーション・バーの位置は、関連付けられたページ・テンプレートによって異なります。ナビゲーション・バー・エントリは、イメージまたはテキストからのリンクとして表示できます。ナビゲーション・バー・エントリは、イメージ、説明付きのイメージまたはテキストです。 詳細は、「ナビゲーション・バー・エントリの作成」を参照してください。

テーマ

テーマは、アプリケーションのユーザー・インタフェースを定義するテンプレートのコレクションです。詳細は、「テーマの管理」を参照してください。

テンプレート

テンプレートは、ページ、リージョン、アイテム、メニューなど、アプリケーション内の特定の構成体のルック・アンド・フィールを制御します。 詳細は、「テンプレートのカスタマイズ」を参照してください。

ユーザー・インタフェースのデフォルト値

ユーザー・インタフェースのデフォルト値を使用して、指定したスキーマ内の表、列またはビューにデフォルトのユーザー・インタフェースのプロパティを割り当てることができます。ウィザードを使用してフォームまたはレポートを作成する場合、ウィザードはこの情報を使用してリージョン・プロパティおよびアイテム・プロパティのデフォルト値を作成します。

ユーザー・インタフェースのデフォルト値は、表に関連付けられているため、フォームおよびレポート・ウィザードで作成されたアプリケーションで使用できます。 詳細は、「ユーザー・インタフェースのデフォルト値の管理」を参照してください。

LOV

LOVは、ポップアップLOV、選択リスト、チェック・ボックスまたはラジオ・グループを表示するために使用される静的または動的な値のセットです。 詳細は、「LOVの作成」を参照してください。

ショートカット

ショートカットを使用すると、HTMLまたはPL/SQLファンクションを繰り返しコーディングする必要がなくなります。ショートカットを作成して、ボタン、HTMLテキスト、PL/SQLプロシージャ、HTMLなどのページ・コントロールを定義できます。 定義したショートカットは、アプリケーション内の様々な位置から参照できるように中央レポジトリに格納されます。 詳細は、「ショートカットの使用」を参照してください。

カスケード・スタイルシート

アプリケーション・ビルダーのテーマには、独自のカスケード・スタイルシート（CSS）を参照するテンプレートが含まれます。カスケード・スタイルシートを作業領域にアップロードするには、「カスケード・スタイルシート」リンクを使用します。 詳細は、「カスタム・カスケード・スタイルシートの使用」を参照してください。

イメージ

イメージを作業領域にアップロードするには、「イメージ」リンクを使用します。 詳細は、「イメージの管理」を参照してください。

静的ファイル

静的ファイルを作業領域にアップロードするには、「静的ファイル」リンクを使用します。 詳細は、「静的ファイルの管理」を参照してください。

共有コンポーネントのエクスポート

「コンポーネントのエクスポート」ページで、共有コンポーネントおよびページ・コンポーネントをエクスポートできます。 このウィザードを使用して、編集前にコンポーネントをバックアップしたり、別のOracle Application Expressインスタンスへのパッチとして機能するエクスポートを作成することもできます。

このセクションの内容は次のとおりです。

「エクスポート」ページからの共有コンポーネントのエクスポート

「エクスポート」ページから共有コンポーネントをエクスポートするには、次のステップを実行します。

  1. 「エクスポート」ページにナビゲートします。

    1. 「作業領域」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

    2. アプリケーションを選択します。

    3. 「アプリケーション」ホームページで、「エクスポート/インポート」をクリックします。

    4. 「エクスポート/インポート」ページで、「エクスポート」をクリックして「次へ」をクリックします。

  2. 「タスク」リストで、「コンポーネントのエクスポート」をクリックします。

    「コンポーネントのエクスポート」ページが表示されます。 詳細は、「アプリケーション・コンポーネントのエクスポート」を参照してください。

「共有コンポーネント」ページからの共有コンポーネントのエクスポート

「共有コンポーネント」ページから共有コンポーネントをエクスポートするには、次のステップを実行します。

  1. 「作業領域」ホームページにナビゲートします。

  2. 「アプリケーション・ビルダー」アイコンをクリックします。

  3. アプリケーションを選択します。

  4. 「アプリケーション」ホームページで、「共有コンポーネント」をクリックします。

    「共有コンポーネント」ページが表示されます。

  5. 「タスク」リストで、「アプリケーション・コンポーネントのエクスポート」をクリックします。

    「コンポーネントのエクスポート」ページが表示されます。 詳細は、「アプリケーション・コンポーネントのエクスポート」を参照してください。

共有コンポーネントに関するレポートへのアクセス

「共有コンポーネント」ページの「タスク」リストの「共有コンポーネントに関するレポート」をクリックして、アプリケーション内の共有コンポーネントに関するレポートにアクセスできます。

「共有コンポーネント」レポートにアクセスするには、次のステップを実行します。

  1. 「作業領域」ホームページにナビゲートします。

  2. 「アプリケーション・ビルダー」アイコンをクリックします。

  3. アプリケーションを選択します。

  4. 「アプリケーション」ホームページで、「共有コンポーネント」をクリックします。

    「共有コンポーネント」ページが表示されます。

  5. 「タスク」リストで、「共有コンポーネントに関するレポート」をクリックします。

    様々なアプリケーション・レポートが、「共有コンポーネント」ページに表示されるカテゴリと同じカテゴリに分けられて表示されます。これらのカテゴリには次のものがあります。

    • ロジック

    • セキュリティ

    • グローバリゼーション

    • ナビゲーション

    • ユーザー・インタフェース

    • ファイル

    ページの右側には、「LOVエントリ」、「リスト・エントリ」、「ナビゲーション・バー・エントリ」、「親タブ」、「標準タブ」などの追加のレポートが表示されます。

    これらのレポートには、「アプリケーション」ホームページの「タスク」リストの「アプリケーション・レポートの表示 」をクリックしてナビゲートすることもできます。


参照:

「アプリケーション・レポートの表示」および「データベース・オブジェクトの依存性レポート」

アプリケーション・プロセスの理解

アプリケーション・プロセスとは、アプリケーションの複数ページの処理を使用して、特定のポイントで実行されるように設定されているPL/SQLロジックのブロックです。デフォルトでは、アプリケーション・プロセスはアプリケーション内のすべてのページに対して同じポイントで実行されます。ただし、特定のページに対する条件を適用して、プロセスが実行されるタイミングを制御できます。

このセクションの内容は次のとおりです。

オンデマンド・アプリケーション・プロセス

特殊なタイプのアプリケーション・プロセスとして、オンデマンド・プロセスがあります。オンデマンド・アプリケーション・プロセスは、「オンデマンド」というプロセス・ポイントを持ち、ページ・レベルのオンデマンド・プロセスからコールされると実行されます。オンデマンド・プロセスは、複数のページにわたって様々な実行ポイントから実行するPL/SQLロジックがある場合に有効です。


参照:

「ページ・プロセスの作成」

ページ・リクエストからのオンデマンド・プロセスの実行

次の構文を使用すると、ページ・リクエストでオンデマンド・プロセスを実行できます。

f?p=application_id:page_id:session:APPLICATION_PROCESS=process_id

各要素の意味は次のとおりです。

  • application_idは、アプリケーションIDまたは英数字の別名です。

  • page_idは、ページ番号または英数字の別名です。

  • session は、セッションIDです。

  • APPLICATION_PROCESS=process_idは、キーワードAPPLICATION_PROCESS=の後にオンデマンドというプロセス・ポイントを持つアプリケーション・レベル・プロセスのプロセスIDまたは英数字の名前を指定したものです。

この構文を使用すると、Application Expressエンジンでリクエストが認識され、次の規則を使用して処理が行われます。

  • URL内のページ番号には、任意のページ番号または別名を指定できます。 このタイプのリクエストでは特定のページにアクセスしないため、ページ番号または別名は構文上のプレースホルダとしてのみリクエストに含める必要があります。

  • プロセス認可スキーム、アプリケーションの認可スキームおよびプロセス条件がサポートされます。

  • URLでセッション・ステート（アイテムの名前および値）を設定することはできますが、「キャッシュの消去」オプションは無視されます。

  • 認証、認可またはプロセス条件が失敗しても、エラー・メッセージまたはそれらの失敗を示す他のインジケータは表示されず、たいていは空白のページが表示されるという結果になります。

  • プロセスを名前で指定すると、指定した（大/小文字が区別される）名前を持つ最初のプロセスが検出されます。


参照:

「セッション・ステートの消去」

アプリケーション・プロセスの例

アプリケーション・プロセスを使用する場合の例には、ショッピング・カート・アプリケーションがあります。 たとえば、ユーザーのショッピング・カートのコンテンツをページ・ビューごとに表示する必要があるとします。 これを行うには、アプリケーションのページ0（ゼロ）に、アプリケーション・レベル・アイテムTOTAL_CART_ITEMSおよびTOTAL_PURCHASE_PRICEの値を表示するリージョンを作成します。


参照:

「アプリケーションの各ページのコンポーネントの表示」

TOTAL_CART_ITEMSおよびTOTAL_PURCHASE_PRICEの値を設定する各ページのプロセスを記述するかわりに、これらの値を計算する「ロード時: ヘッダーの前」というタイプのアプリケーション・プロセスを記述できます。 これによって、Application Expressエンジンは、アプリケーションがレンダリングされると各ページでプロセスを実行します。 この結果、TOTAL_CART_ITEMSおよびTOTAL_PURCHASE_PRICEの最新の値が各ページに表示されます。

アプリケーション・プロセスの作成

アプリケーション・プロセスを作成するには、次のステップを実行します。

  1. 「共有コンポーネント」ページにナビゲートします。

    1. 「作業領域」ホームページで、「アプリケーション・ビルダー」をクリックします。

    2. アプリケーションを選択します。

    3. 「アプリケーション」ホームページで、「共有コンポーネント」をクリックします。

      「共有コンポーネント」ページが表示されます。

  2. 「ロジック」で、「アプリケーション・プロセス」を選択します。

  3. 「作成」をクリックします。

  4. 「指定」で、次の項目を指定します。

    1. 名前: アプリケーション・プロセスの名前を入力します。

    2. 順序: このプロセスの順序番号を指定します。 この順序番号によって、その他のプロセスに対するこのプロセスの相対的な評価順序が決まります。

    3. ポイント: このプロセスを実行するポイントを指定します。

    4. 「次へ」をクリックします。

  5. 「ソース」で、次の項目を指定します。

    1. プロセス・テキスト: プロセスのソースとなるテキストを入力します。

    2. エラー・メッセージ: プロセスでエラーが発生した場合に表示するエラー・メッセージを入力します。

    3. 「次へ」をクリックします。

  6. 「条件付け」で、次の項目を指定します。

    1. 条件タイプ: このプロセスを実行するために満たされる必要がある条件タイプを選択します。

    2. 「式1」および「式2」: これらの属性を使用して、プロセスが実行されるかどうかを条件付きで制御します。選択した特定の条件タイプに基づいて、この属性に値を入力します。指定した条件が満たされた場合、プロセスが実行されます。

    3. 「プロセスの作成」をクリックします。

「アプリケーション・プロセス」ページ

アプリケーション・プロセスを作成すると、そのアプリケーション・プロセスが「アプリケーション・プロセス」ページに表示されます。「ビュー」リストから選択して、ページの表示方法を制御します。使用可能なオプションは次のとおりです。

  • アイコン（デフォルト）: 各プロセスを大きいアイコンとして表示します。プロセスを編集するには、該当するアイコンをクリックします。

  • 詳細: 各アプリケーション・プロセスをレポートで1行に表示します。プロセスを編集するには、名前をクリックします。

アプリケーション・プロセス・レポートへのアクセス

アプリケーション・プロセスを作成すると、使用状況レポートおよび履歴レポートにアクセスできます。

アプリケーション・プロセス・レポートにアクセスするには、次のステップを実行します。

  1. 「作業領域」ホームページにナビゲートします。

  2. 「アプリケーション・ビルダー」をクリックします。

  3. アプリケーションを選択します。

  4. 「アプリケーション」ホームページで、「共有コンポーネント」をクリックします。

  5. 「ロジック」で、「アプリケーション・プロセス」を選択します。

  6. ページ上部にある次のいずれかのタブを選択します。

    • 使用状況

    • 履歴

  7. 画面に表示されるステップに従います。

使用状況

「使用状況」をクリックすると、「アプリケーション・プロセスの使用状況」ページが表示されます。このページには、カレント・アプリケーションで使用されるアプリケーション・プロセスが表示されます。

履歴

「履歴」をクリックすると、「アプリケーション・プロセス履歴」ページが表示されます。 このページには、最近変更されたアプリケーション・プロセスの履歴が日付ごとに表示されます。

アプリケーションの計算の理解

アプリケーションの計算は、単一のページ・レベル・アイテムまたはアプリケーション・レベル・アイテムの値を設定する論理単位であり、アプリケーション内の複数のページにわたって同じポイントで実行されます。ページ・レベルの計算と同様に、アプリケーションの計算も静的値、アイテム値、PL/SQLまたはSQLに基づくことができます。

このセクションの内容は次のとおりです。

アプリケーションの計算

一般的に、アプリケーション・アイテムは、アプリケーションで最後に表示されたページの値の格納に使用されます。 値をアイテム内に格納することによって、「戻る」ボタンを追加した後で、計算によって取得されたページ番号にユーザーをリダイレクトできます。たとえば、このタイプの計算は、ユーザーがエラー・ページから戻ることができるようにする必要がある場合に有効です。

次に、最後にアクセスされたページを格納する計算の例を示します。この例では、計算によって次のことが実行されます。

  • LAST_PAGEというアイテムへの最後にアクセスされたアプリケーション・ページの格納

  • CURRENT_PAGE_ITEMの値が次に示す計算ボディを含むPL/SQLのファンクション本体のタイプであるかどうかの確認

    BEGIN
   :LAST_PAGE := nvl(:CURRENT_PAGE,:APP_PAGE_ID);
   :CURRENT_PAGE := :APP_PAGE_ID;
   RETURN :LAST_PAGE;
END;

新しいインスタンス開始時に実行されるアプリケーションの計算

通常、アプリケーションの計算は、アプリケーション内の複数のページにわたって同じポイントで実行されます。例外は、「新しいインスタンス開始時」という計算ポイントを持つ計算です。このタイプの計算は、ユーザーがはじめてアプリケーションにアクセスしたときにのみ実行されます。 このタイプの計算は、ユーザーのセッション内で情報を1回のみ取得する場合（ユーザーの役職を取得する場合など）に便利です。

アプリケーションの計算の作成

アプリケーションの計算を作成するには、次のステップを実行します。

  1. 「共有コンポーネント」ページにナビゲートします。

    1. 「作業領域」ホームページで、「アプリケーション・ビルダー」をクリックします。

    2. アプリケーションを選択します。

    3. 「アプリケーション」ホームページで、「共有コンポーネント」をクリックします。

      「共有コンポーネント」ページが表示されます。

  2. 「ロジック」で、「アプリケーションの計算」を選択します。

  3. 「作成」をクリックします。

  4. 「アイテム」で、次のステップを実行します。

    1. 「順序」で、このコンポーネントの順序を指定します。これによって評価の順序が決まります。

    2. 「計算アイテム」で、この計算によって影響を受けるアイテムを選択します。

  5. 「計算ポイント」で、この計算を実行するプロセス・ポイントを選択します。 「送信後」を選択すると、ページが表示され、送信された後にのみ計算が実行されます。

  6. 「計算」で、次のステップを実行します。

    1. 「計算タイプ」で、この計算を実行する方法を選択します。

    2. 「計算」に、計算タイプに対応する計算ロジックを入力します。

    3. 「計算エラー・メッセージ」に、計算が失敗した場合に表示されるエラー・メッセージを入力します。

  7. 「認可スキーム」（オプション）で、認可スキームを選択します。この計算を実行するには、選択した認可スキームがtrueと評価される必要があります。

  8. 「条件」で、次の項目を指定します。

    1. 「条件タイプ」で、この計算を実行するために満たされる必要がある条件タイプを選択します。

    2. 「式1」および「式2」で、これらの属性を使用して、計算が実行されるかどうかを条件付きで制御します。選択した特定の条件タイプに基づいて、この属性に値を入力します。指定した条件が満たされた場合、計算が実行されます。

  9. 「ビルド・オプション」（オプション）で、このコンポーネントのビルド・オプションを選択します。 詳細は、「ビルド・オプションを使用した構成の制御」を参照してください。

  10. 「作成」をクリックします。

「アプリケーションの計算」ページ

アプリケーションの計算を作成すると、そのアプリケーションの計算が「アプリケーションの計算」ページに表示されます。「ビュー」リストから選択して、ページの表示方法を制御します。使用可能なオプションは次のとおりです。

  • アイコン（デフォルト）: 各計算を大きいアイコンとして表示します。計算を編集するには、該当するアイコンをクリックします。

  • 詳細: 各アプリケーション・プロセスをレポートで1行に表示します。計算プロセスを編集するには、名前をクリックします。

アプリケーション計算履歴レポートへのアクセス

アプリケーションの計算を作成すると、アプリケーション計算履歴レポートを表示できます。

アプリケーション計算履歴レポートにアクセスするには、次のステップを実行します。

  1. 「作業領域」ホームページにナビゲートします。

  2. 「アプリケーション・ビルダー」アイコンをクリックします。

  3. アプリケーションを選択します。

  4. アプリケーション・ビルダーが表示されたら、「共有コンポーネント」をクリックします。

  5. 「ロジック」で、「アプリケーションの計算」を選択します。

  6. ページ上部にある「履歴」タブを選択します。

    このアプリケーション計算履歴レポートには、最近変更されたアプリケーション計算の履歴が日付ごとに表示されます。

アプリケーション・レポートの表示

アプリケーション・ビルダーには、様々な視点からアプリケーションの包括的なビューを提供する、80を超えるレポートが含まれています。アプリケーション・レポートを使用すると、アプリケーション内の共有コンポーネントおよびページ・コンポーネントの間で整合性を確保できます。たとえば、アプリケーション内のすべてのページで使用されているボタンの詳細を表示できます。また、多くのレポートは更新可能であるため、特定のページにナビゲートしなくても、アイテムやリージョン・ラベルなどのコンポーネントを標準化できます。

アプリケーションに固有のレポートを表示するには、次のステップを実行します。

  1. 「作業領域」ホームページにナビゲートします。

  2. 「アプリケーション・ビルダー」アイコンをクリックします。

  3. アプリケーションを選択します。

    「アプリケーション」ホームページが表示されます。

  4. 「タスク」リストで、「アプリケーション・レポートの表示」をクリックします。

  5. 表示するレポートのタイプを選択します。

    • アプリケーション・レポートは、カレント・アプリケーション固有の情報を提供します。 使用可能なレポートには、「アプリケーション・コメント」、「開発者のコメント」、「開発者コメントのカレンダ」、「データベース・オブジェクトの依存性」などがあります。

    • 共有コンポーネント・レポートは、アプリケーション内のすべてのページに表示される共通の要素に関する情報を提供します。 レポートは、ロジック、ナビゲーション、セキュリティ、ユーザー・インタフェース、グローバリゼーション、ファイルなどのカテゴリごとに分類されています。 レポートの例には、アプリケーション・アイテム、計算、ブレッドクラム・エントリ、認証スキーム、ショートカットなどがあります。

    • ページ・コンポーネント・レポートは、ページのレンダリング時に実行されるコントロールとロジックに関する詳細情報（たとえば、ブランチ、ボタン、計算、アイテム、リージョンなど）を提供します。

    • アクティビティ・レポートは、カレント・アプリケーション内の開発者アクティビティの詳細を提供します。 使用可能なレポートには、開発者別の変更、日ごとの開発者別の変更、開発者別の変更のチャート、ページ・パフォーマンス、最近の変更などがあります。

    • クロス・アプリケーション・レポートは、複数のアプリケーションに適用される情報を提供します。 使用可能なレポートには、アプリケーション属性、アプリケーション・コメント、ビルド・オプション、ビルド・ステータスとアプリケーション・ステータス、ページ・コンポーネント数、セキュリティ・プロファイル、認証スキーム、アプリケーション別のテンプレート・デフォルトなどがあります。


参照:

「APEX_ACTIVITY_LOGを使用したカスタム・アクティビティ・レポートの作成」

データベース・オブジェクトの依存性レポート

データベース・オブジェクトの依存性レポートは、カレント・アプリケーションで参照されるデータベース・オブジェクトを識別します。アプリケーションの配置時に移動するオブジェクトを判別するには、このレポートを確認します。


参照:

「別の開発インスタンスへのアプリケーションの移動方法」および「アプリケーション・レポートの表示」

データベース・オブジェクトの依存性レポートを表示するには、次のステップを実行します。

  1. 「作業領域」ホームページにナビゲートします。

  2. 「アプリケーション・ビルダー」アイコンをクリックします。

  3. アプリケーションを選択します。

  4. 「タスク」リストで、「アプリケーション・レポートの表示」をクリックします。

  5. 「アプリケーション」をクリックします

  6. 「データベース・オブジェクトの依存性」をクリックします。

  7. 「依存性の計算」をクリックします。

  8. 特定のデータベース・オブジェクトを参照するコンポーネントを表示するには、「参照カウント」の番号を選択します。

リージョン検索ソース・レポート

リージョン・ソース・レポートを使用すると、アプリケーション内のすべてのリージョン・ソースを検索できます。

リージョン・ソース・レポートを表示するには、次のステップを実行します。

  1. 「作業領域」ホームページにナビゲートします。

  2. 「アプリケーション・ビルダー」アイコンをクリックします。

  3. アプリケーションを選択します。

  4. 「タスク」リストで、「アプリケーション・レポートの表示」をクリックします。

  5. 「ページ・コンポーネント」をクリックします。

  6. 「リージョン」で、「ソースの検索」をクリックします。

  7. リージョンの「ページ定義」を表示するには、ページ番号を選択します。

  8. リージョンのリージョン属性を表示するには、リージョン名を選択します。

  戻る
戻る 		 次へ
次へ
  目次
目次		 索引
索引