| Oracle® Application Expressアプリケーション・ビルダー・ユーザーズ・ガイド リリース4.0 B61338-01 |
|
 前へ |
 次へ |
このセクションでは、アプリケーション内でページを操作する方法について、重要なバックグラウンド情報を説明します。
内容は次のとおりです。
ページ定義は、ページの基本的な構成要素です。ページ定義を使用して、ページを定義するコントロールとアプリケーション・ロジックを表示、作成および編集します。各ページはボタンとフィールド(アイテムと呼ばれる)を保持でき、これらのボタンとフィールドはリージョンと呼ばれるコンテナにグループ化されます。ページはアプリケーション・ロジック(プロセス)も保持できます。条件付きナビゲーションを使用したあるページから別のページへのブランチや、(計算と呼ばれる)計算の実行、(編集確認などの)検証の実行、レポート、カレンダおよびチャートの表示が可能です。ページ定義にアクセスして、ページを定義するコントロールの表示、作成および編集ができます。
内容は次のとおりです。
ページ定義を使用すると、ページを定義するコントロールを表示、作成および編集できます。
既存のページのページ定義にアクセスするには、次のステップを実行します。
「作業領域」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。
アプリケーション・ビルダーのホームページが表示されます。
アプリケーションを選択します。
アプリケーションのホームページが表示されます。
ページを選択します。
「ページ定義」が次のセクションに分かれて表示されます。
ページ・レンダリング: ページ・レンダリングは、データベースからページを生成するプロセスです。このセクションにはユーザー・インタフェース・コントロールと、ページのレンダリングの際に実行されるロジックが表示されます。詳細は、「ページ・レンダリングについて」を参照してください。
ページ・プロセス: ページ・プロセスは、ページが送信されると発生します。通常、ユーザーがボタンをクリックするとページが送信されます。「ページ・プロセスについて」を参照してください。
共有コンポーネント: 「共有コンポーネント」セクションには、アプリケーション内の1つ以上のページで使用できる共通のコンポーネントが表示されます。詳細は、「共有コンポーネントについて」を参照してください。
ページ・レンダリングは、データベースからページを生成するプロセスです。「ページ・レンダリング」セクションを使用して、ページ属性、リージョン、ボタン、アイテム、ページ・レンダリングの計算、およびページ・プロセスを含むページのレンダリングに影響するコントロールを変更できます。
この後のセクションでは、「ページ・レンダリング」の各サブセクションについて説明します。
内容は次のとおりです。
ページ属性は、ページ名、ならびにページ・タイトルや関連するページ・テンプレート、ヘッダー・テキスト、および一部の名前のための選択された認可スキームといった表示属性などのページの詳細な特性を制御します。ページ属性には、ページ定義からアクセスします。
リージョンはページ上の領域で、コンテンツのコンテナとして機能します。各ページには、任意の数のリージョンを含めることができます。リージョンのコンテンツは、リージョン・ソースによって決まります。たとえば、リージョンのコンテンツは、定義したSQL問合せに基づくレポートにも、静的HTMLにもできます。
特定のリージョン・テンプレートによってリージョンの外観を制御できます。リージョンを使用して、ページ・コントロール(アイテムやボタンなど)をグループ化できます。また、追加のHTMLを生成しない単純なリージョンを作成したり、HTMLの表やイメージ内でコンテンツをフレーム表示する複雑なリージョンを作成できます。
|
参照:
|
アプリケーションの設計時、ボタンを使用して、ユーザーを特定のページやURLにダイレクトしたり、ユーザーによるページの送信を可能にできます。ページを送信すると、Application Expressエンジンが情報を転送または処理します。ボタンは、HTMLボタンとして、イメージとして、あるいはテンプレートを使用して実装できます。ボタンを事前定義されたリージョン・テンプレートの位置に置くことも、フォーム内のアイテム間に置くこともできます。
アイテムは、関連するセッション・ステートを持つ、テキスト・フィールド、選択リスト、チェック・ボックスなどのHTMLフォーム要素です。アイテム属性は、ページ上のアイテムの表示および動作に影響します。たとえば、これらの属性は、ラベルの表示位置、アイテムの大きさ、およびアイテムの表示位置(左右、上下)に影響します。
アイテムには、ページ・アイテムとアプリケーション・アイテムという2つのカテゴリが存在します。ページ・レベル・アイテムはページ上に配置され、「表示形式」、「ラベル」、「ラベル・テンプレート」などの関連するユーザー・インタフェースのプロパティを持ちます。アプリケーション・レベル・アイテムはページに関連付けられないため、ユーザー・インタフェースのプロパティを持ちません。アプリケーション・アイテムは、グローバル変数として使用できます。
計算は、アイテムへのセッション・ステートの割当てに使用するロジックの単位です。計算を使用して、ページの送信時または表示時に、指定したアイテムに値を割当てできます。
アプリケーション・レベルの計算では、ページがレンダリングされるたびにアイテムに値が割り当てられます。ページ・レベルの計算では、ページが表示または送信(レンダリングおよび処理)されたときに、指定したアイテムに値が割り当てられます。
プロセスは、データ操作言語(DML)またはPL/SQLの実行に使用されるロジック・コントロールです。たとえば、プロセスを使用して、ページのレンダリングの際にセッション・ステートを移入したり、(PL/SQLなどを使用して)一部のタイプのロジックを実行したり、レンダリング・エンジンをコールできます。一般に、プロセスはアクションを実行します。プロセスは、ハンドコードしたPL/SQLの場合も、事前定義したプロセスの呼出しの場合もあります。
ページ・プロセスは、ページを送信するプロセスです。通常、ページは、ユーザーがボタンをクリックすると送信されます。ページ定義の「ページ・プロセス」セクションを使用して、計算、検証、プロセス、ブランチなどのアプリケーション・ロジックを指定します。通常、Application Expressエンジンは、ページ定義に表示される順序でこのロジックを実行します。
この後のセクションでは、「ページ・プロセス」の各サブセクションについて説明します。
内容は次のとおりです。
「ページ定義」の「共有コンポーネント」セクションには、アプリケーション内のすべてのページに表示または適用可能な共通の要素が含まれます。共有コンポーネントは、追加された後にのみ「ページ定義」に表示されます。
この後のセクションでは、「ページ定義」の「共有コンポーネント」の下に表示されることがある各サブセクションについて説明します。
内容は次のとおりです。
タブは、アプリケーションのページ間でのナビゲートに有効な方法です。アプリケーション・ビルダーには、標準タブおよび親タブという2つのタイプのタブが含まれています。
タブが1レベルのみのアプリケーションでは、標準タブ・セットを使用します。標準タブ・セットは、特定のページに関連付けられます。標準タブを使用すると、アプリケーション内の他のページにユーザーをリンクできます。親タブ・セットは、標準タブのグループを保持するコンテナとして機能します。親タブを使用すると、ナビゲーションのレベルおよびアプリケーション内でのコンテキスト(位置)を増やすことができます。
値リスト(LOV)は、ラジオ・グループ、チェック・ボックス、ポップアップ・リスト、選択リストなどの、特定のタイプのページ・アイテムを表示するために使用される静的定義または動的定義です。LOVは、静的(事前定義された一連の表示値および戻り値に基づく)または動的(表から値を選択するSQL問合せに基づく)のいずれかです。作成したLOVは、1つ以上のページ・アイテムによって参照できます。
LOVは、LOVウィザードを実行してLOVリポジトリに追加して、アプリケーション・レベルで定義します。
リストは、テンプレートを使用してレンダリングされるリンクのコレクションです。リストの各エントリに対して、表示テキスト、ターゲットURL、およびリスト・エントリがいつどのように表示されるかを制御するその他の属性を指定します。リストの表示や、すべてのリスト・エントリの外観は、そのリストをテンプレートにリンクすることによって制御します。
テーマは、アプリケーションのユーザー・インタフェースを定義するテンプレートのコレクションです。各テーマには、すべてのタイプのアプリケーション・コンポーネントおよびページ・コントロール(個々のページ、リージョン、レポート、リスト、ラベル、メニュー、ボタンおよびLOV)のテンプレートが含まれます。
テンプレートは、アプリケーション内のページのルック・アンド・フィールを制御します。アプリケーションの作成時に、ページ、リージョン、レポート、リスト、ラベル、メニュー、ボタンおよびポップアップLOVのテンプレートを指定します。テンプレートのグループは、テーマという名前付きコレクションで構成されます。
ページは、アプリケーションの基本的な構成要素です。各ページには、 ページ番号、名前、および通常はヘッダー、タイトル、フッターなどのテキスト属性が含まれます。ページにコンテンツを追加するには、ページ・コントロール(リージョン、アイテムおよびボタン)を作成します。ページ・テンプレートおよびページ・リージョン・テンプレートは、各ページのルック・アンド・フィールを制御します。
ページを表示する方法には次の2つがあります。
ツリー・ビュー: 「ツリー・ビューについて」を参照してください。
コンポーネント・ビュー: 「コンポーネント・ビューについて」を参照してください。
ツリー・ビューについて
ツリー・ビューには、リージョン、ページ・アイテムおよびアプリケーション・ロジックがツリー内のノードとして表示されます。各ツリーでは、イベント順序や、Oracle Application Expressでページをレンダリングするときのコンポーネントの処理方法に基づいてコンポーネントがグループ化されます。この編成により、コンポーネントが処理される時期をよりよく理解できます。
このビューの主要な機能は次のとおりです。
コンテキスト・メニュー: 各ツリー・ノードにはカスタム・コンテキスト・メニューがあります。コンテキスト・メニューにアクセスするには、右クリックします。
属性ページへの迅速なアクセス: 属性を編集するには、ダブルクリックするか[ENTER]を押します。使用可能な場合、属性ページが表示されます。
コンポーネントの容易な順序変更: ページ・アイテム、レポート列、プロセス、検証、ブランチまたは計算を別の表示、処理ポイントまたはリージョンにドラッグ・アンド・ドロップすることで、順序を変更できます。
ツールチップ: 各ツリー・ノードには、コンポーネントについての基本情報(アイテム・タイプ、条件、認可など)を表示するツールチップがあります。
コンポーネントの名前またはラベルの表示: ページを実行するときに表示されるコンポーネントの名前またはラベルのどちらを使用してページのコンポーネントを表示するかを選択できます(たとえば、アイテムの名前はP7_CUST_FIRST_NAMEですが、ラベルはFirst Nameです)。「名前とラベルの切替え」を参照してください
条件、認可およびビルド・オプションの識別: コンポーネントに条件、認可またはビルド・オプションがある場合、ツリー・ノード・ラベルはイタリック体で表示されます。
デフォルト・ウィザードへの直接アクセス: 各コンテキスト・メニューには、デフォルト・ウィザードにリンクするアクションが含まれています。たとえば、アイテムの「検証の作成」を選択すると、検証の作成ウィザードが表示されます。
詳細は、「ツリー・ビューでのページの編集」および「ツリー・ビューとコンポーネント・ビューの切替え」を参照してください。
コンポーネント・ビューについて
コンポーネント・ビューは、ユーザー・インタフェース要素とアプリケーション・ロジックをコンポーネント・タイプ別にグループ化します。
コンポーネントを編集するには、コンポーネント名をドリルダウンするか、アイコンをクリックします。詳細は、「コンポーネント・ビューでのページの編集」および「ツリー・ビューとコンポーネント・ビューの切替え」を参照してください。
ページを表示する方法には、ツリー・ビューとコンポーネント・ビューの2通りあります。
ビューを切り替えるには、次のステップを実行します。
ページ定義にナビゲートします。「ページ定義へのアクセス」を参照してください。
ページ定義が表示されます。デフォルトでは、各ページには、コンポーネントがツリーのノードとして表示されます。
コンポーネント・ビューに切り替えるには、ページ上部の「コメント・ビューに切替え」をクリックします。
ツリー・ビューに切り替えるには、「ツリー・ビューに切替え」をクリックします。
ツリー・ビューには、リージョン、ページ・アイテムおよびアプリケーション・ロジックがツリー内のノードとして表示されます。各ツリーでは、イベント順序や、Oracle Application Expressでページをレンダリングするときのコンポーネントの処理方法に基づいてコンポーネントがグループ化されます。この編成により、コンポーネントが処理される時期をよりよく理解できます。
内容は次のとおりです。
ツリー・ビューの「ページ定義」には、各ページ・コンポーネントがツリーのノードとして表示されます。
各ツリーでは、イベント順序、またはアプリケーション・ビルダーでページをレンダリングまたは処理するときのコンポーネントの処理方法に基づいてコンポーネントがグループ化されています。
カーソルをコンポーネントに合わせると、ツールチップが表示されます。ツールチップでは、コンポーネントについての基本情報(アイテム・タイプ、条件、認可など)が表示されます。
コンポーネントを編集または追加するには、右クリックしてコンテキスト・メニューを表示します。コンテキスト・メニューはコンポーネントのタイプに応じて異なります。次の例では、「編集」、「すべて開く」および「すべて閉じる」が含まれています。ただし、コンポーネントのタイプによっては他のオプション(「コピー」、「すべて編集」および「削除」など)が表示されることもあります。
コントロールまたはコンポーネントは、右クリックして「作成」を選択して作成できます。
ウィザードが表示されます。オンラインの指示に従ってください
ページ・アイテム、リージョン、レポート列、計算、プロセス、検証、ブランチおよび動的アクションの表示を別の表示、処理ポイントまたはリージョンにドラッグ・アンド・ドロップすることで、順序を変更できます。
ページを実行するときに表示されるコンポーネントの名前またはラベルのどちらを使用してページのコンポーネントを表示するかを選択できます(たとえば、アイテムの名前はP7_CUST_FIRST_NAMEですが、ラベルはFirst Nameです)。
ビューを変更するには、次のステップを実行します。
「ユーティリティ」ボタンをクリックします。
「切替え」を選択して、次のいずれかを選択します。
名前の表示
ラベルの表示
「ユーティリティ」ボタンの詳細は、「ページ定義の共通要素」を参照してください
ページは、アプリケーションの基本的な構成要素です。各ページには、ページ番号、名前、および通常はヘッダー、タイトル、フッターなどのテキスト属性が含まれます。ページにコンテンツを追加するには、ページ・コントロール(リージョン、アイテムおよびボタン)を作成します。ページ・テンプレートおよびページ・リージョン・テンプレートは、各ページのルック・アンド・フィールを制御します。
内容は次のとおりです。
ページ定義は、「ページ・レンダリング」、「ページ・プロセス」、および「共有コンポーネント」の3つのセクションで構成されます。これらのセクションはそれぞれ、コントロールのタイプ、コンポーネント、またはアプリケーション・ロジックを識別するヘッダーを持つサブセクションに分けられます。
コンポーネントを編集するには、コンポーネント名をドリルダウンするか、次のセクションで説明されているアイコンをクリックします。
内容は次のとおりです。
サブセクションのタイトルの右側に表示される「すべて編集」アイコンをクリックすると、そのサブセクション内のすべてのコントロール、コンポーネントまたはロジックを編集できます。「すべて編集」アイコンは、鉛筆が置かれた小さいグリッドの形をしています。
「すべて編集」アイコンをクリックすると、複数のコントロール、コンポーネントまたはアプリケーション・ロジックを同時に編集または削除するページ、または最近の変更履歴を表示するページが表示されます。
たとえば、「リージョン」で「すべての編集」アイコンを選択すると、カレント・ページで現在定義されているすべてのリージョンのサマリー・レポートが表示されます。このサマリー・ビューを使用して、次のことが可能です。
使用可能なフィールドおよび選択リストから選択して、一度に複数の属性を編集できます。
「編集」アイコンをクリックして、定義ページにリンクできます。
「ページ」ポップアップ・リストから別のページを選択することで、他のページ上の同様のサマリー・ビューにアクセスできます。サマリー・ビューへの編集内容を保存するには、「変更の適用」をクリックします。
ページ定義で名前を選択して、特定のコントロールまたはコンポーネントの属性を表示することもできます。たとえば、ページ定義にCustomersという名前のリージョンが含まれているとします。リージョン名「Customers」をクリックすると、そのリージョンのリージョン定義ページが表示されます。
「コピー」アイコンおよび「作成」アイコンをクリックして、コントロールやコンポーネントをコピーまたは作成できます。「コピー」アイコンは、小さいページが2つ重なった形をしています。「コピー」アイコンをクリックすると、既存のコントロールやコンポーネントのコピーが作成されます。
「作成」アイコンは、プラス(+)記号が置かれた小さいページの形をしています。「作成」アイコンをクリックすると、コントロールやコンポーネントが作成されます。
ページ定義の「並替え」アイコンを使用すると、リージョン、ボタンおよびアイテムの表示順序を簡単に変更できます。「並替え」アイコンは、薄い灰色の下矢印および上矢印として表示されます。
ページ・コンポーネントを並び替えるには、「並替え」アイコンをクリックします。並替えページが表示された後、上矢印および下矢印をクリックして、「変更の適用」をクリックします。
ページ・レンダリングはデータベースからページを生成するプロセスです。「ページ・レンダリングについて」を参照してください。
コンポーネント・ビューでは、ヘッダーの下にあるアイコンをクリックすると、特定のサブセクションにナビゲートできます。これらのアイコンの1つを選択すると、そのサブセクションが表示され、その他すべてのサブセクションは一時的に非表示になります。表示を元に戻すには、「すべて表示」をクリックします。「すべて表示」アイコンは、下向き三角形の形をしています。
ページ・プロセスは、ページを送信するプロセスです。通常、ページは、ユーザーがボタンをクリックすると送信されます。ページ定義の「ページ・プロセス」セクションを使用して、計算、検証、プロセス、ブランチなどのアプリケーション・ロジックを指定します。通常、Application Expressエンジンは、ページ定義に表示される順序でこのロジックを実行します。
ヘッダーの下にあるアイコンをクリックすると、特定のサブセクションに簡単にナビゲートできます。これらのアイコンの1つを選択すると、そのサブセクションが表示され、その他すべてのサブセクションは一時的に非表示になります。表示を元に戻すには、「すべて表示」をクリックします。「すべて表示」アイコンは、下向き三角形の形をしています。
ページ定義の「共有コンポーネント」セクションには、アプリケーション内のすべてのページに表示または適用可能な共通の要素が含まれます。
ヘッダーの下にあるアイコンをクリックすると、特定のサブセクションに簡単にナビゲートできます。これらのアイコンの1つを選択すると、そのサブセクションが表示され、その他すべてのサブセクションは一時的に非表示になります。表示を元に戻すには、「すべて表示」をクリックします。「すべて表示」アイコンは、下向き三角形の形をしています。
ページ定義は、ページの基本的な構成要素です。ページ定義を使用して、ページを定義するコントロールやアプリケーション・ロジックを表示、作成および編集できます。この後のセクションで、ページ定義の共通のUI要素を説明します。
内容は次のとおりです。
開発者アクション・バーは、右上隅の「検索アプリケーション」フィールドの下に表示されます。
この開発者アクション・バーには、「ページの実行」、「共有コンポーネント」、「ダッシュボード」、「開発者のコメント」、「ページがロック解除されました」、「ページがロックされました」、「ページのエクスポート」および「検索」アイコンがあります。
「ページの実行」アイコンは、小さい信号の形をしています。このアイコンをクリックすると、カレント・ページの表示可能なHTMLがレンダリングされます。ページを選択せずにこのアイコンをクリックすると、アプリケーションの最初のページが実行されます。ページを実行すると、Application Expressエンジンにより、データベースに格納されたデータに基づいてページが動的にレンダリングされます。詳細は、「ページまたはアプリケーションの実行」を参照してください。
「共有コンポーネント」アイコンは、小さな機械の歯車のような形をしています。このアイコンをクリックすると、アプリケーション内のすべてのページに表示または適用できる共有コンポーネントおよびユーザー・インタフェース・コントロールのリストが表示できます。「共有コンポーネントでの作業」を参照してください。
「アプリケーション・ユーティリティ」アイコンは、円と4つの小さいボックスのような形をしています。このアイコンをクリックすると、ユーティリティ・ページにリンクします。「アプリケーション・ビルダー・ユーティリティの使用」を参照してください。
「開発者のコメント」アイコンは、緑の吹出しの形をしています。このアイコンをクリックすると、アプリケーション、特定のページまたはページ・グループに関するコメントを記録できます。詳細は、「開発者のコメントの追加」を参照してください。
「ページがロック解除されました」および「ページがロックされました」アイコンは、ページが編集可能かどうかを示します。ページのロックが解除されている場合、このアイコンは鍵が開いた南京錠として表示されます。ページがロックされている場合、このアイコンは鍵が閉じた南京錠として表示されます。ページのロック・ステータスを変更するには、このアイコンをクリックします。詳細は、「ページのロックおよびロック解除」を参照してください。
「ページのエクスポート」アイコンは、下矢印の形をしています。このアイコンをクリックすると、カレント・ページがエクスポートされます。詳細は、「アプリケーション内のページのエクスポート」を参照してください。
「検索」アイコンは懐中電灯の形をしています。このアイコンをクリックすると、カレント・アプリケーション内のアイテム、ページ、問合せ、表、PL/SQL、イメージおよびカスケード・スタイルシート(CSS)または作業領域に関連付けられたスキーマを検索できます。「「検索」アイコンの使用」を参照してください。
「検索アプリケーション」フィールドは開発者アクション・バーの上に表示されます。
このフィールドは、アプリケーション内のメタデータを検索する際に使用します。デフォルトでは、このフィールドは大/小文字を区別せず、正規表現構文をサポートします。通常の検索では、P1_NAMEを入力すると、アプリケーション内でP1_NAMEを含むすべての文字列を検索します。
次に示す拡張された正規表現検索では、P1_NAMEまたはP2_NAMEを含むすべての文字列が検出されます。
regexp:(P1_NAME)|(P2_NAME)
「検索アプリケーション」フィールドは、特定のページを迅速に表示するショートカットもサポートします。アプリケーション番号とページ番号を、page、application:pageまたはapplication-pageの形式を使用して入力し、[ENTER]を押します。次に例を示します。
10 570-10 570:10
ナビゲーション・バーは、ページ上部のブレッドクラム・メニューの下に表示されます。このバーは、アプリケーション内のページ間をナビゲートするために使用します。
ページ・フィールドを使用してページ間をナビゲートします。「ページ」フィールドにページ番号を入力し、「実行」をクリックします。
「実行」、「ユーティリティ」、「作成」ボタンが右側に表示されます。
「実行」ボタンについて
データベースに格納されているデータに基づいてページを動的にレンダリングするには、「実行」をクリックします。「ページまたはアプリケーションの実行」を参照してください。
「ユーティリティ」ボタンについて
|
ヒント: 一部の「ユーティリティ」メニュー・オプションは、ツリー・ビューでのみ表示されます。 |
「ユーティリティ」ボタンをクリックすると、次のメニューが表示されます。
チェック: アドバイザにリンクします。このツールはOracle Application Expressアプリケーションの整合性と品質を確認するために使用します。「アプリケーション整合性のチェックのためのアドバイザの実行」を参照してください
クリーンアップ: このリンクをクリックして、順序ページ・コンポーネントを変更します。
ロック: カレント・ページをロックします。「ページのロックおよびロック解除」を参照してください。
削除: カレント・ページを削除します。「ページの削除」を参照してください。
履歴: カレント・ページへの変更のレポートを表示します。
エクスポート: エクスポート・ページにリンクします。「アプリケーションのエクスポート」を参照してください。
キャッシュ: キャッシュ・ページを表示します。「キャッシュされたリージョンの管理」を参照してください。
属性ディクショナリ: 属性ディクショナリの管理ページにリンクします。「属性ディクショナリの使用」を参照してください。
「クロス・ページ」には次のページへのリンクが含まれています。
最近更新されたページ: カレント・アプリケーションの最近更新されたページのレポートを表示します。
グリッド編集: 複数ページにわたる複数のページ属性をグリッド形式で編集するためのレポートを表示します。
複数のページの削除: 「複数のページの削除」を参照してください。
ページ属性: 属性、コンポーネント、コントロールおよびアプリケーション・ロジックのページ別のレポートを表示します。
ページ・グループ: 「ページのグループ化」を参照してください
ページ・ロック: 「ページのロックおよびロック解除」を参照してください。
ページ・イベント: 現在定義されているすべてのページ・コントロールおよびプロセスの詳細が、Application Expressエンジンによるページのレンダリング、ロジックの呼出しおよびプロセスの実行の順序で示されます。
参照データベース・オブジェクト: カレント・アプリケーションで参照されるデータベース・オブジェクトを識別します。詳細は、「「データベース・オブジェクトの依存性」レポートの使用」を参照してください。
「切替え」(ツリー・ビューのみ): ページを実行するときに表示されるコンポーネントの名前またはラベルのどちらを使用してページのコンポーネントを表示するかを選択できます(たとえば、アイテムの名前はP7_CUST_FIRST_NAMEですが、ラベルはFirst Nameです)。「名前の表示」または「ラベルの表示」を選択します。
ツリー・ビューの使用: ツリー・ビューの使用についての説明を表示します。「ツリー・ビューとコンポーネント・ビューについて」および「ツリー・ビューでのページの編集」を参照してください。
「作成」ボタンについて
「作成」をクリックすると、新しいページまたはコンポーネントが既存のページに追加されます。「データベース・アプリケーションのページの作成について」を参照してください。
Application Expressエンジンは、データベース表に格納されたデータに基づいて、ページを動的にレンダリングおよび処理します。レンダリングされたアプリケーションを表示するには、「実行」アイコンをクリックして、アプリケーションを実行するかApplication Expressエンジンに送信します。
開発環境内からアプリケーションを実行すると、ページの下部に開発者ツールバーが表示されます。開発者ツールバーを使用すると、カレント・ページの編集、ページ、リージョンまたはページ・コントロールの作成、セッション・ステートの表示、デバッグ・モードの切替えを簡単に行うことができます。定義の編集ページの「ステータス」属性を変更して、開発者ツールバーを表示するかどうかを制御できます。
開発者ツールバーは、次のリンクで構成されています。
ホーム: 作業領域のホームページにリンクします。「作業領域のホームページについて」を参照してください。
アプリケーション: アプリケーションのホームページにリンクします。「アプリケーションのホームページについて」を参照してください。
ページの編集: 現在実行されているページのページ定義にアクセスします。「ページ定義について」を参照してください。
作成: ページ、リージョン、ページ・コントロール(アイテム、ボタン、ブランチ、計算、プロセスまたは検証)または共有コントロール(ナビゲーション・バー・アイコン、タブ、LOV、リストまたはブレッドクラム)を作成するためのウィザードにリンクします。「アプリケーションの作成」を参照してください。
セッション: カレント・ページのセッション・ステート情報にリンクします。詳細は、「セッション・ステートの表示」を参照してください。
キャッシュ: キャッシュ・ページにリンクします。「キャッシュされたリージョンの管理」を参照してください。
デバッグの表示: デバッグ・ウィンドウを表示します。「デバッグ・モードへのアクセス」を参照してください。
デバッグ: ページを「デバッグ」モードと「デバッグなし」モードとの間で切り替えます。「デバッグ・モードへのアクセス」を参照してください。
編集リンクの表示: 「編集リンクの表示」と「編集リンクを非表示」とを切り替えます。「編集リンクの表示」をクリックすると、ページ上の編集可能な各オブジェクトの横に小さなオレンジ色のアイコンが表示されます。各アイコンは、オレンジ色で中に三角形があり、その下に2本の罫線があります。リンクをクリックすると、オブジェクト編集用の別のウィンドウが表示されます。
ページ属性は、ページ名、ならびにページ・タイトルや関連するページ・テンプレート、ヘッダー・テキストおよび選択された認可スキームといった表示属性などのページの詳細な特性を制御します。ページ属性には、ページ定義からアクセスします。
内容は次のとおりです。
ページ属性を編集するには、次のステップを実行します。
ページ定義にナビゲートします。「ページ定義へのアクセス」を参照してください。
編集ページにアクセスするには、次の操作を実行します。
ツリー・ビュー: 「ページ・レンダリング」で、ツリーの上部のページ・タイトルをダブルクリックします。
コンポーネント・ビュー: 「ページ」で、「すべて編集」アイコンをクリックします。
ページ属性ページが表示されます。必須の値には赤いアスタリスク(*)が付いています。
ページ属性ページは、「名前」、「表示属性」、「JavaScript」、「HTMLヘッダーおよびボディ属性」、「ヘッダーおよびフッター」、「セキュリティ」、「重複送信」、「キャッシュ」、「構成」、「エラー・テキスト」、「ヘルプ」および「コメント」の各セクションに分かれています。
これらのセクションにはページをスクロール・ダウンするか、ページ上部のナビゲーション・ボタンをクリックすることでアクセスできます。ページ上部のボタンを選択すると、選択されたセクションが表示され、その他のセクションはすべて一時的に非表示になります。ページのすべてのセクションを表示するには、「すべて表示」をクリックします。
この後のトピックで、ページ属性ページ固有のセクションについて説明します。
次の属性を使用して、ページ名、英数字の別名(オプション)、関連付けられたページ・グループなど、カレント・ページの一般的な属性を定義します。詳細は、表6-1を参照してください。
表 6-1 ページ属性: 名前
| 属性 | 説明 |
|---|---|
|
アプリケーション開発者のカレント・ページの名前を指定します。この名前は、ページ番号およびページ・タイトルとともに、多くのページおよびレポートで使用されます。 |
|
|
このページの英数字の別名を入力します。この別名は、カレント・アプリケーション内で一意である必要があります。 たとえば、アプリケーション100のページ1で作業している場合、別名「 f?p=100:home |
|
|
このページと関連付けるページ・グループを指定します。ページ・グループは、機能に影響しませんが、開発者がアプリケーション内のページを管理するのに役立ちます。 グループからページを削除するには、「- グループが割り当てられていない -」を選択し、「変更の適用」をクリックします。 参照: 「ページのグループ化」 |
次の属性を使用して、選択されるページ・テンプレート、標準タブ・セット、タイトル、カーソル・フォーカスなど、カレント・ページの一般的な表示属性を定義します。詳細は、表6-2を参照してください。
表 6-2 ページ属性: 表示属性
| 属性 | 説明 |
|---|---|
|
このページの外観を制御するページ・テンプレートを選択します。ページ・テンプレートを選択すると、現行のテーマ内に定義されたデフォルト・ページ・テンプレートが上書きされます。 |
|
|
このページに使用する標準タブ・セットを選択します。標準タブ・セットは、特定のページおよびページ番号に関連付けられます。標準タブを使用すると、特定のページにユーザーをリンクできます。 参照: 「タブの作成」 |
|
|
ブラウザ・ウィンドウのタイトル・バーに表示するタイトルを入力します。Application Expressエンジンは、ページ・テンプレートで使用される#TITLE#置換文字列のかわりに、ここで指定するタイトルを使用します。このタイトルは、HTMLタグ |
|
|
インターネット・メディア・タイプを入力します。インターネット・メディア・タイプは、2つの部分で構成される、インターネット上のファイル形式を表す識別子です。メディア・タイプは、少なくともタイプとサブタイプの2つの部分で構成され、オプションで1つ以上のパラメータを指定します。メディア・タイプは、ページ描画の際にHTTPヘッダーのContent-Typeで使用されます。 ページ・レベルのメディア・タイプが、アプリケーション・レベルのメディア・タイプを上書きします。この属性のデフォルト値は |
|
|
カーソル・フォーカスを指定します。使用可能なオプションは次のとおりです。 |
次の属性を使用して、JavaScriptをカレント・ページに含めます。詳細は、表6-3を参照してください。
表6-3 JavaScript属性
| 属性 | 説明 |
|---|---|
|
このページで使用するコードのJavaScriptコード(ファンクション、グローバル変数の宣言など)を入力します。コードが複数ページで使用される場合、重複を避けるために外部のJavaScriptファイルに配置することを検討してください。 注意: スクリプトの開始タグや閉じタグを含める必要はありません。JavaScriptコードのみ含めます。 ここに入力したコードによって、ページ・テンプレート内の ショートカットを参照するには、次の方法を使用します。 "SHORTCUTNAME" |
|
|
ページがロードされたときに実行されるJavaScriptコードを入力します。このコードはOracle Application Expressによって生成されたJavaScriptコードの後に実行されます。 注意: スクリプトの開始タグや閉じタグを追加する必要はなく、JavaScriptコードのみ追加します。 ショートカットを参照するには、次の方法を使用します。 "SHORTCUTNAME" |
|
|
Oracle Application Expressでは通常、特定のJavaScriptファイルとCSSファイルが必要です。モバイル・アプリケーションなど一部のアプリケーションでは、これらのファイルをHTMLヘッダーに含めることを禁止する場合があります。 「標準JavaScriptとCSSを含める」で「はい」を選択すると、カスケード・スタイルシート(CSS)ファイルとJavaScriptファイルをHTMLヘッダーに含めることを禁止します。 これらのファイルの表示を禁止すると一般的なアプリケーションが中断するため、この属性の有効化は上級の開発者のみが行うようにしてください。 |
次の属性を使用して、HTMLヘッダーとフッターのテキストを定義します。詳細は、表6-5を参照してください。
次の属性を使用して、カレント・ページの認可スキームおよび認証要件を指定します。詳細は、表6-6を参照してください。
表6-6 ページ属性: セキュリティ
| 属性 | 説明 |
|---|---|
|
ページに適用する認可スキームを選択します。認可スキームはアプリケーション・レベルで定義され、アプリケーション内の多くの要素に適用できます。 認可スキームは、アプリケーション・セッション(セッションの作成時)ごとに1回評価されるか、ページ・ビューごとに1回評価されます。選択した認可スキームがtrueと評価された場合、ページが表示され、他の定義された条件に従います。falseと評価された場合、ページは表示されず、エラー・メッセージが表示されます。 |
|
|
このページがパブリック・ページとして定義されているか、または認証が必要かを指定します。ページをパブリック・ページとして指定した場合、ページは認証の前に表示されます。この属性は、認証が必要なアプリケーションにのみ適用されます。アプリケーションのページ監視ファンクションは、このページ属性にアクセスして、表示前に事前認証が不要なページを識別できます。認証スキームのページ監視ファンクションの実装によって、この属性が影響するかどうかが判別されます。 |
|
|
ページ・アクセス保護 |
注意: この属性は、アプリケーションについて「セッション・ステート保護」が有効化されている場合のみ表示されます。「セッション・ステート保護の理解」を参照してください。 カレント・ページのページ・アクセス保護レベルを選択します。
|
|
この属性を「オン」に設定してもページには影響はありません。この値を「オフ」に設定すると、FORMタグに次のHTMLが生成されます。 autocomplete="off" |
「複製ページの送信を許可」リストを使用して、ユーザーがページを1行で繰り返し処理できるかどうかを指定します。重複するページ送信が繰り返し処理されないようにするには、この属性を「いいえ」に設定します。
重複するページ送信の例を次に示します。
ユーザーが「送信」ボタンを繰り返しクリックした場合
ブランチ・タイプ「ページにブランチ」を作成して、ユーザーがブラウザの再ロード・ボタンをクリックした場合
「複製ページの送信時は、このURLに移動」で、URLを入力します。「複製ページの送信を許可」を「いいえ」に設定している場合はこのフィールドを使用します。「いいえ」を選択していてユーザーが同一ページを2回送信しようとすると、Oracle Application Expressはエラー・メッセージとユーザーが指定したURLへのリンクを表示します。
これらの属性を使用してカレント・ページのキャッシュを有効にします。ページ・キャッシュを有効にすることで、アプリケーションのパフォーマンスが改善され、静的ページの機能が改善されます。詳細は、表6-7を参照してください。
表 6-7 キャッシュ属性
| 属性 | 説明 |
|---|---|
|
「はい」または「いいえ」を選択して、ページ・キャッシュを有効にするかどうかを指定してください。ページ・キャッシュは、ページを動的に表示せずにキャッシュから表示するため、パフォーマンスが向上します。 |
|
|
キャッシュされたページが有効な時間を指定してください。 |
|
|
ページがユーザーによってキャッシュされる必要があるかどうかを指定します。「はい」の場合、ページは各ユーザー用にキャッシュされます。「いいえ」の場合、キャッシュされた同じページがすべてのユーザーに使用されます。 |
|
|
条件を指定してください。条件がFalseを戻す場合、ページは動的にレンダリングされ、キャッシュされません。条件がTrueを戻す場合、ページはキャッシュから表示されます。 |
|
|
選択した「キャッシュ・ページ条件」に従って条件付きで表示されます。 選択した特定の条件タイプに基づいて、この属性に値を入力してください。 |
|
|
選択した「キャッシュ・ページ条件」に従って条件付きで表示されます。 選択した特定の条件タイプに基づいて、この属性に値を入力してください。 |
このページに対するビルド・オプションを選択します。ビルド・オプションを使用すると、機能を有効または無効にできます。ほとんどのアプリケーション属性は、ビルド・オプション属性を持ちます。特定の構成でページを除外する場合以外は、カレント・ページのビルド・オプションを指定しないでください。
ビルド・オプションは、INCLUDEおよびEXCLUDEという2つの値をとることができます。属性を含めるように指定すると、Application Expressエンジンは、実行時にその属性をアプリケーション定義の一部として認識します。逆に、属性を除外するように指定すると、Application Expressエンジンは、その属性を存在しないものとして処理します。
この属性を使用して、カレント・ページのヘルプ・テキストを入力します。
ヘルプ・テキストは、ヘルプ・システムを使用して表示されます。このヘルプ・システムは開発する必要があります。特定のページのヘルプを表示するには、ヘルプ・テキストの表示用に作成したページからAPEX_APPLICATION.HELPプロシージャをコールします。たとえば、次のようなナビゲーション・バー・アイコンを使用できます。
javascript:popupURL('wwv_flow_help.show_help?p_lang=&BROWSER_LANGUAGE.&p_session=&
ページ・レベル・ヘルプは、次の構文を使用したショートカットをサポートします。
"SHORTCUT_NAME"
ページ計算を使用して、ページが送信または表示されたときに、指定したアイテムに値を割り当てます。アプリケーション・レベルの計算を使用して、アイテムに値を割り当てることもできます。ほとんどのページ・レベルの計算では、ページ・アイテムへの移入が行われます。一方、ほとんどのアプリケーション・レベルの計算では、アプリケーション・アイテムへの移入が行われます。
内容は次のとおりです。
ページ計算では、ページが表示または送信(レンダリングおよび処理)されたときに、指定したアイテムに値が割り当てられます。ページ計算を作成するには、ページ計算の作成ウィザードを実行します。各計算には、計算の作成対象のアイテムおよび計算タイプを指定します。
ページ計算を作成するには、次のステップを実行します。
該当するページ定義にナビゲートします。「ページ定義へのアクセス」を参照してください。
計算の作成ウィザードにアクセスします。
ツリー・ビュー: 該当するイベントで、「計算」を見つけます。右クリックして「作成」を選択します。
コンポーネント・ビュー: 「計算」で、「作成」アイコンをクリックします。
「アイテム・タイプ」で、計算を実行する場所を選択して、「次へ」をクリックします。位置オプションは次のとおりです。
他のページのアイテム
このページのアイテム
アプリケーション・レベル・アイテム
「アイテム」で、計算を実行するアイテムおよび計算ポイントを選択します。
計算するアイテム: 計算によって更新されるアイテムを選択します。
順序: 評価の順序を選択します。
計算ポイント: 計算を実行するポイントを選択します。計算ポイント「新しいインスタンス開始時」では、新しいセッション(またはインスタンス)の生成時に計算が実行されます。
計算タイプ: 作成する計算方法を選択します。
「次へ」をクリックします。
「計算」で、選択した計算タイプに対応する計算を入力し、「次へ」をクリックします。
「条件」で、計算を条件付きにするかどうかを選択できます。計算を条件付きにする場合、「条件タイプ」リストから選択し、式フィールドにテキストを入力します。
「作成」をクリックします。
計算のわかりやすい使用例として、電話番号入力用のフォーム・フィールドを含むページがあげられます。この例では、電話番号は1つのデータベース列に格納されますが、データ・エントリ・フォームでは電話番号が市外局番、局番および回線番号の3つの要素に分割されます。この例では、ページ・アイテムはP10_AREA_CODE、P10_PREFIXおよびP10_LINE_NUMBERと呼ばれます。
次に、これらのアイテムに格納された値を1つの文字列に結合します。これは、「送信後」計算を使用して行い、結合した値をP10_PHONE_NUMBERというアイテムに格納します。
P10_AREA_CODE、P10_PREFIXおよびP10_LINE_NUMBERを結合した値を新規アイテムに格納するための計算を作成するには、次のステップを実行します。
該当するページ定義にナビゲートします。「ページ定義へのアクセス」を参照してください。
P10_PHONE_NUMBERという名前のアイテムを作成して、P10_AREA_CODE、P10_PREFIXおよびP10_LINE_NUMBERを結合した値を格納します。「ページ・アイテムとアプリケーション・アイテムの違い」を参照してください。
計算の作成ウィザードにアクセスします。
ツリー・ビュー: 該当するイベントで、「計算」を見つけます。右クリックして「作成」を選択します。
コンポーネント・ビュー: 「計算」で、「作成」アイコンをクリックします。
「アイテムの位置」で、「このページのアイテム」を選択して「次へ」をクリックします。
「計算」で、「P10_PHONE_NUMBER」を選択します。
「順序」で、評価の順序を選択します。
「計算」には、次の計算タイプを作成するオプションがあります。
静的割当て:
「計算タイプ」で「静的割当て」を選択して、「次へ」をクリックします。
次の計算を入力します。
(&P10_AREA_CODE.) &P10_PREFIX.-&P10_LINE_NUMBER.
「次へ」をクリックします。
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;
「次へ」をクリックします。
SQL問合せ(コロン区切りの値を返す):
「計算タイプ」で、「SQL問合せ(コロン区切りの値を返す)」を選択して、「次へ」をクリックします。
次の計算を入力します。
SELECT '('||:P10_AREA_CODE||')'||:P10_PREFIX||'-'||:P10_LINE_NUMBER FROM DUAL
「次へ」をクリックします。
PL/SQL式:
「計算タイプ」で「PL/SQL式」を選択して、「次へ」をクリックします。
次の計算を入力します。
'('||:P10_AREA_CODE||')'||:P10_PREFIX||'-'||:P10_LINE_NUMBER
「次へ」をクリックします。
「作成」をクリックします。
作成した計算は、ページ計算の編集ページで編集できます。
ページ計算を編集するには、次のステップを実行します。
該当するページ定義にナビゲートします。「ページ定義へのアクセス」を参照してください。
ページ計算の編集ページにアクセスします。
ツリー・ビュー: 該当するイベントで、「計算」を見つけます。計算名を右クリックして「編集」を選択します。
コンポーネント・ビュー: 「計算」で、計算名を選択します。
ページ計算の編集ページが表示されます。
対象となる属性を編集します。
「変更の適用」をクリックします。
検証は編集確認です。単一アイテムに固有の検証は、アイテム・レベルの検証です。単一アイテムに適用しない検証は、ページ・レベルの検証です。
検証を宣言的に定義するには、検証方法を選択します。検証メッセージ・フィールドに、実際の検証の編集確認を入力します。検証が失敗した場合は、後続のページ・プロセスまたは計算が行われないことに注意してください。また、入力した検証は、選択した検証タイプと一貫性がある必要があることも注意してください。
内容は次のとおりです。
検証を作成するには、次のステップを実行します。
|
注意: 検証に対して入力するテキストは、3,950文字以下にする必要があります。 |
該当するページ定義にナビゲートします。「ページ定義へのアクセス」を参照してください。
検証の作成ウィザードにアクセスするには、次のステップを実行します。
ツリー・ビュー: 「ページ・プロセス」で、「検証中」を右クリックして、「検証の作成」を選択します。
コンポーネント・ビュー: 「ページ・プロセス」で、「検証」を見つけます。「作成」アイコンをクリックします。
検証レベルを選択して、「次へ」をクリックします。
「アイテム・レベルの検証」: 単一のアイテムに固有のものです。
「表形式フォームの検証」: 表形式フォームに固有のものです。
「ページ・レベルの検証」: 単一のアイテムには適用されず、ページ全体に適用されます。
アイテム・レベル検証を選択した場合、検証するアイテムを選択し、「次へ」をクリックします。
「検証方法」について、表6-8の説明に従って方法を選択し、「次へ」をクリックします。
表 6-8 検証方法
| 検証方法 | 説明 |
|---|---|
|
SQL |
アイテムの値をデータベース内のデータと比較します。 たとえば、SQL検証を使用して、フィールドに入力した姓がデータベースに存在するかどうかを検証できます。次のEXISTS SQL検証では、フィールドは 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); |
|
アイテムがNOT NULL |
セッション・ステートのアイテム値がNULLかどうかを確認します。 たとえば、アイテムの検証を作成してから検証方法「アイテムがNOT NULL」を選択して、ユーザーがフィールドに値を入力したことを検証できます。 |
|
アイテム文字列の比較 |
アイテム値を特定の文字列と比較します。 アイテムの値とリテラル文字列を比較する文字列の比較検証がいくつかあります。たとえば、検証タイプ「式1のアイテムが式2に含まれる」を選択して、フィールドのユーザー・エントリを、指定した値リストに対して検証します。 式1に、検証するアイテムの名前をコロンなしで入力します。次に例を示します。 P1_VALUE 式2に、検証先の値の文字列を入力します。次に例を示します。 ABC/DEF/GHI |
|
正規表現 |
正規表現は、テキスト・パターンを記述する方法を提供します。「正規表現」検証を使用して、データの検証を実行します。 たとえば、次の正規表現検証を使用して、入力データの文字列が必ずカンマ区切りの6桁の数値のグループで構成され、後ろにカンマが続いていることを検証できます。
^([[:digit:]]{6},)+$
この正規表現検証では、次のエントリは有効とみなされます。
しかし、次のエントリは有効ではありません。
|
SQL、PL/SQLおよびアイテム文字列の比較検証の場合、作成する検証のタイプを選択し、「次へ」をクリックします。
順序および検証名を指定し、「次へ」をクリックします。
「検証」で、次の項目を指定します。
検証方法に応じて、検証が失敗した場合に表示する検証またはメッセージ・テキストを入力します。
#LABEL#または#HEADING#のプレースホルダを使用すると、エラー・メッセージを表示するときに現在のページ・アイテムのラベルまたは列ヘッダーを取得できます。
「常に実行」で、「はい」または「いいえ」を選択します。この属性は、ページが送信されるときに検証が実行されるかどうかを決定します。この属性は、ページを送信するボタンまたは特定のページについての「検証の実行」属性と組み合せて使用します。
「はい」を選択した場合、検証はページ上のボタンまたはアイテムの検証設定とは無関係に常に実行されます。定義された任意の条件が依然として適用されることに注意してください。
「いいえ」を選択した場合、検証は、ページを送信するために使用されるボタンまたはアイテムの「検証の実行」属性が「はい」に設定されているときにのみ実行されます。
「次へ」をクリックします。
この検証に適用される条件を定義し、「作成」をクリックします。
検証エラー・メッセージをインライン表示(検証が実行されたページで表示)するか、個別のエラー・ページで表示するかを選択できます。
検証エラー・メッセージの表示方法を定義するには、次のステップを実行します。
該当するページ定義にナビゲートします。「ページ定義へのアクセス」を参照してください。
検証の編集ページに移動します。
ツリー・ビュー: 「ページ・プロセス」で「検証中」を見つけ、「検証」ブランチを展開します。検証名を右クリックして「編集」を選択します。
コンポーネント・ビュー: 「検証」で、該当する検証を選択します。
「エラー・メッセージ」までスクロールします。
「エラー・メッセージ」に、エラー・メッセージ・テキストを入力します。
「エラー・メッセージ表示位置」から表示位置を選択します。
この属性で検証エラー・メッセージの表示位置を指定します。検証エラー・メッセージは、エラー・ページに表示したり、既存ページ内にインラインで表示できます。インライン・エラー・メッセージは、通知領域(ページ・テンプレートの一部として定義される)に表示したり、フィールド・ラベル内に表示できます。
すべての処理(検証を含む)を停止するハード・エラーを作成する場合は、エラー・ページにエラーを表示する必要があります。
「フィールドでインライン表示」または「フィールドおよび通知でインライン表示」を選択した場合は、アイテムをエラー・メッセージに関連付ける必要があります。アイテムをエラー・メッセージに関連付けるには、「関連付けられたアイテム」リストからアイテムを選択します。
「変更の適用」をクリックします。
|
ヒント: 「フィールドでインライン表示」または「フィールドおよび通知でインライン表示」を選択した場合、検証エラー・メッセージが表示されてページが再レンダリングされる間、Application Expressエンジンでは計算またはプロセスが実行されないことに注意してください。 |
「条件」で、検証を実行するタイミングおよび検証を実行するかどうかを制御できます。
既存の検証に対して条件を作成するには、次のステップを実行します。
該当するページ定義にナビゲートします。「ページ定義へのアクセス」を参照してください。
検証の編集ページに移動します。
ツリー・ビュー: 「ページ・プロセス」で「検証中」を見つけ、「検証」ブランチを展開します。検証名を右クリックして「編集」を選択します。
コンポーネント・ビュー: 「検証」で、該当する検証を選択します。
「条件」までスクロールします。
ユーザーが特定のボタンをクリックしたときに検証を実行させるには、「対象ボタン」リストから選択します。
「条件タイプ」リストから選択します。
選択した条件タイプに応じて、式属性に値を入力します。指定した条件に一致した場合、検証がレンダリングまたは処理されます。
「変更の適用」をクリックします。
1つのページ・プロセスは、ページのレンダリング中または送信中の指定されたポイントで1つのアクションを実行します。たとえば、ページ・プロセスを作成して、ロジックを実行したり、Application Expressエンジンをコールできます。ページ・プロセスは、ページのロードや送信など、特定のイベントが発生したときに実行するロジックの単位です。
ファンクションの観点からみると、ページ・レベルのプロセスとアプリケーション・レベルのプロセスに違いはありません。これらの2つのプロセス・タイプの違いは、プロセスが定義された場所(ページ・レベルかアプリケーション・レベルか)です。
内容は次のとおりです。
プロセスを作成するには、プロセスの作成ウィザードを実行します。ウィザードの実行中にプロセス名を定義し、順序、およびプロセスが実行されるポイントを指定し、プロセス・カテゴリを選択します。ページ・プロセスの編集ページで、これらのほぼすべての属性を変更できます。
該当するページ定義にナビゲートします。「ページ定義へのアクセス」を参照してください。
ページ・プロセスの作成ウィザードにアクセスします。
ツリー・ビュー: 該当するイベントで、「プロセス」を見つけます。右クリックして「作成」を選択します。
コンポーネント・ビュー: 「プロセス」で、「作成」アイコンをクリックします。
表6-9の説明に従って、カテゴリを選択します。
表 6-9 プロセス・カテゴリ
| プロセス・カテゴリ | 説明 |
|---|---|
|
PL/SQL |
指定したPL/SQLを実行します。このプロセス・タイプを使用して、プロセスに直接入力したPL/SQLブロックを実行したり、既存のAPIをコールします。 |
|
ページ区切りをリセット |
「レポート」リージョンで、ページ区切りを最初の結果セットへリセットします。Application Expressエンジンは、指定された結果セット内のユーザーの位置を追跡します。このプロセス・カテゴリは、ユーザーを最初の結果セットに戻します。つまり、レポート・リージョンに関連付けられたカウンタをリセットして、次回結果セットが表示されるときに、結果セットの最初の部分を戻します。 |
|
セッション・ステート |
既存のセッション・ステート・アイテムの値をNULLに設定します。このプロセス・タイプを選択すると、既存のユーザー設定、アプリケーション、セッションまたはアイテムのキャッシュがクリアされます。 参照:「セッション・ステート値の管理」および Oracle Application Express管理ガイドの「ユーザー・プリファレンスの管理」 |
|
データ操作 |
ウィザードでは、データ操作言語(DML)のアクションをサポートするために、「データ操作」プロセス・タイプが頻繁に使用されます。Application Builderでは、次のような宣言によるデータ操作プロセスをサポートしています。
|
|
Webサービス |
Webサービスをページ上のプロセスとして実装します。このプロセスを実行すると、リクエストがサービス・プロバイダに送信されます。 |
|
フォーム・ページ区切り |
マスター・ディテール・フォームに関連付けられたディテール・レコードのページ区切りを実装します。このプロセスは、マスター・ディテール・フォーム(マスター・ディテール・ウィザードなど)で最も頻繁に使用され、マスター表をチェックして該当するディテール・レコード・セットを判別したり、次のディテール・レコードを判別します。 |
|
電子メールの送信 |
|
|
プラグイン |
プラグインによって、開発者はApplication Expressで使用可能な組込みタイプを宣言的に拡張できます。このオプションは、プラグイン・タイプのプロセスがこのアプリケーション内に存在する場合に使用可能です。 参照: 「プラグインの実装」 |
|
ポップアップ・ウィンドウを閉じる |
ポップアップ・ウィンドウ内で実行中のプロセスに適用されます。このプロセス・タイプを実行すると、現在のポップアップ・ウィンドウが閉じます。 |
|
オンデマンド・プロセスの実行 |
特定のページからコールされた場合のみ実行される、アプリケーション・レベルのプロセスを作成します。このプロセス・タイプをページ・レベルで作成すると、既存のアプリケーション・レベルのプロセスへの参照が作成されます。 |
画面に表示されるステップに従います。
プロセスを作成すると、「ページ・プロセスの編集」ページで属性を編集することによって、プロセスを実行するタイミングおよびプロセスの内容を制御できます。
既存のページ・プロセスを編集するには、次のステップを実行します。
該当するページ定義にナビゲートします。「ページ定義へのアクセス」を参照してください。
ページ・プロセスの編集ページにアクセスします。
ツリー・ビュー: 該当するイベントで、「プロセス」セクションを見つけます。右クリックして「編集」を選択します。
コンポーネント・ビュー: 「プロセス」で、プロセス名を選択します。
「ページ・プロセスの編集」ページが表示されます。
プロセスを実行するタイミングを制御するには、「プロセス・ポイント」で順序番号およびプロセス・ポイントを指定します。「プロセスの実行」で次のいずれかのオプションを選択すると、後続のページへのアクセス時におけるプロセスの実行を制限できます。
ページへのアクセスごとに1回
セッションごとまたはリセット時に1回
PL/SQLのプロセス・タイプに適切なコードを入力します。「PL/SQL無名ブロック」プロセスの場合は、「プロセス」で適切なコードを入力します。「キャッシュのクリア」プロセスの場合は、「ソース」に適切なコードを入力します。プロセスが失敗した場合のために、「プロセス・エラー・メッセージ」フィールドにエラー・メッセージを定義できます(オプション)。
ブランチは、特定のページ、プロシージャまたはURLへ移動する指示です。たとえば、ページ1の送信後、ページ1からページ2にブランチできます。
ブランチを作成するには、「ページ・ブランチの作成」ウィザードを実行して、ブランチ・ポイントおよびブランチ・タイプを指定します。ブランチ・タイプは、作成するブランチのタイプを定義します。ブランチ・タイプの詳細は、オンライン・ヘルプを参照してください。
内容は次のとおりです。
アプリケーションの標準タブをクリックすると、Application Expressエンジンはセッション・ステートを設定し、計算を実行してから、ユーザーをターゲット・ページにリンクします。プロセスまたは明示的に定義されたブランチは実行しません。標準タブをクリックせずにページを送信する場合、Application Expressエンジンはブランチを明示的に定義して、ユーザーを後続のページにリダイレクトします。
ブランチを実行するタイミングを制御するには、「ブランチ・ポイント」リストからブランチ・ポイントを選択します。使用可能なオプションは次のとおりです。
送信時: 計算の前: 計算、検証またはプロセスの前にブランチが実行されます。このオプションは、プロセスを起動する必要がないボタン(「取消」ボタンなど)に使用します。
送信時: 検証の前: 計算の後、検証またはプロセスの前にブランチが実行されます。検証が失敗すると、ページ・プロセスは停止し、ロールバックが実行され、ページにエラーが表示されます。このデフォルト動作のために、ブランチを作成して検証を提供する必要がありません。ただし、計算の結果に応じてブランチする必要がある場合があります(たとえば、前のブランチ・ポイントに戻る場合)。
送信時: プロセスの前: 計算および検証の後、プロセスの前にブランチが実行されます。このオプションを使用すると、検証されたセッション・ステートに基づいて、ページ・プロセスの実行前にブランチされます。
送信時: プロセスの後: 計算、検証およびプロセスの後にブランチが実行されます。このオプションを使用すると、計算、検証およびプロセスの実行後にURLまたはページにブランチされます。このオプションを使用する際、任意のブランチ・ポイントに複数のブランチが存在する場合は、ブランチを順序付ける必要があります。
ロード時: ヘッダーの前: ページのレンダリング前にブランチが実行されます。このオプションを使用すると、カレント・ページではなく別のページが表示されるか、またはユーザーが別のURLまたはプロシージャにリダイレクトされます。
選択したブランチ・タイプによっては、「アクション」属性に次の追加情報を指定できます。
ブランチ先ページのページ番号
最後にブランチ・ターゲット・ページをレンダリングするPL/SQLプロシージャ
URLアドレス
共有コンポーネントは、アプリケーション内の任意のページに表示または適用可能な共通の要素です。共有コンポーネント・ページのツールやウィザードを、アプリケーション・レベルまたは特定のページで使用できます。
内容は次のとおりです。
「共有コンポーネント」ページにアクセスするには、次のステップを実行します。
「作業領域」ホームページにナビゲートします。
「アプリケーション・ビルダー」アイコンをクリックします。
アプリケーションを選択します。
アプリケーションのホームページで、「共有コンポーネント」をクリックします。
共有コンポーネント・ページが表示されます。
共有コンポーネントを作成するには、該当するリンクを選択します。
開発者アクション・バーの「共有コンポーネント」アイコンをクリックしても、共有コンポーネント・ページにアクセスできます。「共有コンポーネント」アイコンは、小さい機械の歯車のような形をしており、アプリケーション・ビルダーのほとんどのページの「検索アプリケーション」フィールドの下に表示されます。
次のセクションでは、共有コンポーネント・ページの各リンクについて説明します。
次のセクションで、「ロジック」の下にあるリンクについて説明します。
アプリケーション・レベルのアイテムは表示されませんが、アプリケーションのグローバル変数として使用されます。一般に、アプリケーションまたはページの計算を使用して、ページ・レベル・アイテムの値を設定します。詳細は、「アプリケーション・レベル・アイテムの理解」を参照してください。
アプリケーション・プロセスを使用すると、次のようにPL/SQLロジックを実行できます。
アプリケーションの各ページの特定のポイントで
プロセスの実行条件で定義されているとおりに
新しいセッションの作成時
「オンデマンド」プロセスは、ページ・レベルの「オンデマンド」プロセスからコールされた場合か、ブラウザからAJAXを使用してコールされた場合にのみ実行されます。詳細は、「アプリケーション・プロセスの理解」を参照してください。
アプリケーション・レベルの計算を使用すると、表示される各ページに対して、または新規アプリケーション・セッションの作成時に、アプリケーション・レベル・アイテムとページ・レベル・アイテムに値を割り当てることができます。また、アプリケーション・レベルの計算を作成し、条件付きで複数のページで実行することもできます。詳細は、「アプリケーションの計算の理解」を参照してください。
アプリケーション・ビルダーのWebサービス参照は通常、Simple Object Access Protocol(SOAP)またはRepresentational State Transfer(REST)アーキテクチャに基づいています。Webサービスへの参照を作成してアプリケーションに組み込み、フォームによって送信されたデータを処理したり、フォームまたはレポートに出力をレンダリングできます。詳細は、「Webサービスの実装」を参照してください。
ビルド・オプションを使用すると、アプリケーション内の特定の機能を条件付きで表示または処理できます。ビルド・オプションを使用して、アプリケーションの各デプロイについて、アプリケーションのどの機能をオンにするかを制御できます。詳細は、「ビルド・オプションを使用した構成の制御」を参照してください。
次のセクションでは、「ナビゲーション」の下にあるリンクについて説明します。
タブは、アプリケーションのページ間でのナビゲートに有効な方法です。標準タブまたは親タブという2つのタイプのタブを作成できます。標準タブ・セットは、特定のページおよびページ番号に関連付けられます。親タブ・セットは、標準タブのグループを保持するコンテナとして機能します。詳細は、「タブの作成」を参照してください。
リストは、リンクの共有コレクションです。リストの外観は、リスト・テンプレートで制御します。各リスト要素には、表示のタイミングを制御できる表示条件があります。詳細は、「リストの作成」を参照してください。
ブレッドクラムを使用すると、階層的にナビゲートできます。ブレッドクラムは、テンプレートを使用して表示されるリンクの階層的なリストです。ブレッドクラムは、リンクのリストまたはブレッドクラム・パスとして表示できます。詳細は、「ブレッドクラムの作成」を参照してください。
ツリーは階層ナビゲーション・メカニズムです。ツリーでは、テーマのサポート、オプションのキーボード・ナビゲーションおよびオプションのステート保存を提供する、JavaScriptベースのクロス・ブラウザ・ツリー・コンポーネントであるjsTreeを使用します。ツリーは、表またはビューでIDと親ID列を識別することによって階層関係を指定する問合せから作成できます。「ツリーの作成」を参照してください。
ナビゲーション・バー・エントリは、アプリケーションのページ間を移動する単純なナビゲーション・パスを提供します。ナビゲーション・バーの位置は、関連付けられたページ・テンプレートによって異なります。ナビゲーション・バー・エントリは、イメージまたはテキストからのリンクとして表示できます。ナビゲーション・バー・エントリは、イメージ、説明付きのイメージまたはテキストです。詳細は、「ナビゲーション・バー・エントリの作成」を参照してください。
次のセクションでは、「セキュリティ」の下にあるリンクについて説明します。
認証は、ユーザーがアプリケーションにアクセスする前に、そのユーザーのアイデンティティを証明するプロセスです。認証では、ユーザー名とパスワードの入力や、ユーザーのアイデンティティまたは保護キーの使用が必要となる場合があります。詳細は、「認証によるユーザー・アイデンティティの証明」を参照してください。
認可は、事前定義されたユーザー権限に基づいて、特定のコントロールやコンポーネントに対するユーザーのアクセスを制限するものです。詳細は、「認可を介したセキュリティの提供」を参照してください。
セッション・ステート保護は、ハッカーがアプリケーション内のURLを改ざんするのを防ぐための組込み機能です。URL改ざんにより、プログラム・ロジック、セッション・ステートの内容および情報プライバシが悪影響を受ける可能性があります。詳細は、「セッション・ステート保護の理解」を参照してください。
次のセクションでは、「ユーザー・インタフェース」の下にあるリンクについて説明します。
テンプレートは、アプリケーション内の特定の構成要素(ページ、リージョン、アイテム、メニューなど)のルック・アンド・フィールを制御します。詳細は、「テンプレートのカスタマイズ」を参照してください。
LOVは、ポップアップLOV、選択リスト、チェック・ボックスまたはラジオ・グループを表示するために使用される静的または動的な値のセットです。詳細は、「アプリケーション・レベルでのLOVの作成」を参照してください。
ショートカットを使用すると、HTMLまたはPL/SQLファンクションを繰り返しコーディングする必要がなくなります。ショートカットを作成して、ボタン、HTMLテキスト、PL/SQLプロシージャ、HTMLなどのページ・コントロールを定義できます。定義したショートカットは、アプリケーション内の様々な位置から参照できるように中央リポジトリに格納されます。詳細は、「ショートカットの使用」を参照してください。
アプリケーション・ビルダーには、組込みのアイテム・タイプ、リージョン・タイプ、動的アクションおよびプロセスが含まれています。新しい宣言的なタイプをアプリケーションに追加するためにプラグインを使用します。「プラグインの実装」を参照してください。
次のセクションでは、「ファイル」の下にあるリンクについて説明します。
アプリケーション・ビルダーには、独自のカスケード・スタイルシート(CSS)を参照するテンプレートを保持するテーマが含まれます。「カスケード・スタイルシート」リンクを使用すると、カスケード・スタイルシートを作業領域にアップロードできます。詳細は、「カスタム・カスケード・スタイルシートの使用」を参照してください。
次のセクションでは、「グローバリゼーション」の下にあるリンクについて説明します。
Oracle Application Expressでは、異なる言語で同時に実行可能なアプリケーションを開発できます。1つのOracle DatabaseおよびOracle Application Expressインスタンスは、複数言語でアプリケーションをサポートできます。アプリケーションの翻訳には複数のステップが必要です。詳細は、「アプリケーションの翻訳およびグローバリゼーション・サポートについて」および「翻訳プロセスの理解」を参照してください。
テキスト・メッセージは、ユーザーが作成するPL/SQLコードからコールできる名前付きのテキスト文字列です。このPL/SQLは、ページ・プロセスおよびページ・リージョン、またはパッケージおよびプロシージャで無名ブロックとして使用できます。詳細は、「メッセージの翻訳」を参照してください。
異なる言語で同時に実行可能なアプリケーションを開発できます。このリンクをクリックして、「アプリケーションのプライマリ言語」、「アプリケーション言語の派生元」属性などのグローバリゼーション・オプションを指定します。詳細は、「グローバリゼーション属性の構成」および「アプリケーションの翻訳およびグローバリゼーション・サポートについて」を参照してください。
次のセクションでは、「レポート」の下にあるリンクについて説明します。
レポートまたは共通問合せとともに「レポート・レイアウト」を使用すると、Adobe Portable Document Format(PDF)、Microsoft Word Rich Text Format(RTF)、Microsoft Excel(XLS)形式などの印刷用形式でデータをレンダリングできます。「レポート・レイアウトについて」を参照してください。
次のセクションでは、ページの右側の「アプリケーション」リージョンの下にあるリンクについて説明します。
アプリケーション定義の編集ページにリンクします。このページを使用すると、アプリケーション名、アプリケーションの可用性および静的置換文字列を決定する属性を編集できます。また、ビルド・オプション、アプリケーション・ロゴなどのその他の属性を定義でき、関連付けられているテンプレートやコンポーネントのデフォルト値を表示することもできます。「アプリケーション定義の編集」を参照してください。
次に、「タスク」リストの下にあるリンクについて説明します。
「アプリケーション・コンポーネントのエクスポート」には、コンポーネントのエクスポート・ページへのリンクが表示されます。このページは、バックアップまたは別のインスタンスへのコンポーネントのロードを目的として、エクスポートされるアプリケーションのコンポーネントを識別する際に使用します。「アプリケーション・コンポーネントのエクスポート」を参照してください。
「サポートするオブジェクトの管理」はサポートするオブジェクト・ページにリンクします。このページは、パッケージ・アプリケーションを作成する際に使用します。詳細は、「パッケージ・アプリケーションの作成方法」を参照してください。
コンポーネントのエクスポート・ページで、共有コンポーネントおよびページ・コンポーネントをエクスポートできます。また、このウィザードを使用して、編集前にコンポーネントをバックアップしたり、別のOracle Application Expressインスタンスに対するパッチとして機能するエクスポートを作成することもできます。
内容は次のとおりです。
共有コンポーネント・ページから共有コンポーネントをエクスポートするには、次のステップを実行します。
エクスポート・ページにナビゲートします。
「作業領域」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。
アプリケーションを選択します。
アプリケーションのホームページで、「エクスポート/インポート」をクリックします。
エクスポート/インポート・ページで、「エクスポート」をクリックしてから「次へ」をクリックします。
「タスク」リストで、「コンポーネントのエクスポート」をクリックします。
コンポーネントのエクスポート・ページが表示されます。詳細は、「アプリケーション・コンポーネントのエクスポート」を参照してください。
共有コンポーネント・ページから共有コンポーネントをエクスポートするには、次のステップを実行します。
「作業領域」ホームページにナビゲートします。
「アプリケーション・ビルダー」アイコンをクリックします。
アプリケーションを選択します。
アプリケーションのホームページで、「共有コンポーネント」をクリックします。
共有コンポーネント・ページが表示されます。
「タスク」リストで、「アプリケーション・コンポーネントのエクスポート」をクリックします。
コンポーネントのエクスポート・ページが表示されます。詳細は、「アプリケーション・コンポーネントのエクスポート」を参照してください。
アプリケーション・プロセスとは、アプリケーションの複数ページからのプロセスを使用して、特定のポイントで実行されるように設定されているPL/SQLロジックのブロックです。デフォルトでは、アプリケーション・プロセスはアプリケーション内のすべてのページについて同じポイントで実行されます。ただし、特定のページに対する条件を適用して、プロセスが実行されるタイミングを制御できます。
内容は次のとおりです。
特殊なタイプのアプリケーション・プロセスとして、オンデマンド・プロセスがあります。オンデマンド・アプリケーション・プロセスは、「オンデマンド」のプロセス・ポイントを持ち、ページ・レベルのオンデマンド・プロセスまたはブラウザからのAJAXコールからコールされると実行されます。オンデマンド・プロセスは、複数のページにわたって様々な実行ポイントから実行する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、式2: これらの属性を使用して、プロセスが実行されるかどうかを条件付きで制御します。選択した特定の条件タイプに基づいて、この属性に値を入力します。指定した条件が満たされた場合、プロセスが実行されます。
「プロセスの作成」をクリックします。
アプリケーション・プロセスを作成した後、「アプリケーション・プロセス履歴」レポートにアクセスできます。このレポートには、最近変更されたアプリケーション・プロセスの履歴が日付ごとに表示されます。
アプリケーション・プロセス・レポートにアクセスするには、次のステップを実行します。
「作業領域」ホームページにナビゲートします。
「アプリケーション・ビルダー」をクリックします。
アプリケーションを選択します。
アプリケーションのホームページで、「共有コンポーネント」をクリックします。
「ロジック」で、「アプリケーション・プロセス」を選択します。
ページ上部の 「履歴」 タブを選択します。
ページの外観は、ページ上部にある検索バーを使用してカスタマイズできます。使用可能なコントロールは次のとおりです。
「検索」アイコン: 虫めがねに似ています。このアイコンをクリックして、検索を特定の列のみに絞ります。すべての列を検索するには、「すべての列」を選択します。
テキスト領域: 大/小文字を区別しない検索基準(ワイルド・カード文字は暗黙的に定義される)を入力し、「実行」をクリックします。
「実行」ボタン: 検索を実行するか、フィルタを適用します。
ビュー・アイコン: このコントロールを使用して、アイコン・ビュー、レポート・ビューまたは詳細ビューを切り替えます。ビューを変更するには、次のいずれかをクリックします。
アイコンの表示(デフォルト): 各プロセスを大きいアイコンとして表示します。
レポートの表示: 各プロセスをレポート内の1行として表示します。
「アクション・メニュー」: 「アクション」を表示します。レポート・ビューをカスタマイズするにはこのメニューを使用します。「「アクション」メニューの使用」を参照してください。
アプリケーションの計算は、単一のページ・レベル・アイテムまたはアプリケーション・レベル・アイテムの値を設定するロジックの単位であり、アプリケーション内の複数のページにわたって同じポイントで実行されます。ページ・レベルの計算と同様に、アプリケーションの計算も静的値、アイテム値、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;
アプリケーションの計算を作成するには、次のステップを実行します。
共有コンポーネント・ページにナビゲートします。
作業領域のホームページで、「アプリケーション・ビルダー」をクリックします。
アプリケーションを選択します。
アプリケーションのホームページで、「共有コンポーネント」をクリックします。
共有コンポーネント・ページが表示されます。
「ロジック」で、「アプリケーションの計算」を選択します。
「作成」をクリックします。
「アイテム」で、次の項目を指定します。
順序: このコンポーネントの順序を指定します。これによって評価の順序が決まります。
計算アイテム: この計算によって影響を受けるアイテムを選択します。
「計算ポイント」で、この計算を実行するプロセス・ポイントを選択します。「送信後」を選択すると、ページが表示され送信された後でのみ計算が実行されます。
「計算」で、次の項目を指定します。
計算タイプ: この計算の実行方法を選択します。
計算: 計算タイプに対応する計算ロジックを入力します。
計算エラー・メッセージ: 計算が失敗した場合に表示されるエラー・メッセージを入力します。
「認可スキーム」(オプション)で、認可スキームを選択します。この計算を実行するには、選択した認可スキームがTrueと評価される必要があります。
「条件」(オプション)で、次の項目を指定します。
条件タイプ: この計算を実行するために満たされる必要がある条件タイプを選択します。
式1および式2: これらの属性を使用して、計算が実行されるかどうかを条件付きで制御します。選択した特定の条件タイプに基づいて、この属性に値を入力します。指定した条件が満たされた場合、計算が実行されます。
「ビルド・オプション」(オプション)で、このコンポーネント用のビルド・オプションを選択します。詳細は、「ビルド・オプションを使用した構成の制御」を参照してください。
「作成」をクリックします。
アプリケーションの計算を作成すると、アプリケーション計算履歴レポートを表示できます。
アプリケーション計算履歴レポートにアクセスするには、次のステップを実行します。
「作業領域」ホームページにナビゲートします。
「アプリケーション・ビルダー」アイコンをクリックします。
アプリケーションを選択します。
アプリケーション・ビルダーが表示されたら、「共有コンポーネント」をクリックします。
「ロジック」で、「アプリケーションの計算」を選択します。
ページ上部の「履歴」タブを選択します。
このアプリケーション計算履歴レポートには、最近変更されたアプリケーション計算の履歴が日付ごとに表示されます。
ページの外観は、ページ上部にある検索バーを使用してカスタマイズできます。使用可能なコントロールは次のとおりです。
「検索」アイコン: 虫めがねに似ています。このアイコンをクリックして、検索を特定の列のみに絞ります。すべての列を検索するには、「すべての列」を選択します。
テキスト領域: 大/小文字を区別しない検索基準(ワイルド・カード文字は暗黙的に定義される)を入力し、「実行」をクリックします。
「実行」ボタン: 検索を実行するか、フィルタを適用します。
ビュー・アイコン: このコントロールを使用して、アイコン・ビューとレポート・ビューを切り替えます。ビューを変更するには、次のいずれかを選択します。
「アイコンの表示」(デフォルト)は、各計算を大きいアイコンとして表示します。
「レポートの表示」は、各計算をレポート内の1行として表示します。
「アクション・メニュー」: 「アクション」を表示します。レポート・ビューをカスタマイズするにはこのメニューを使用します。「「アクション」メニューの使用」を参照してください。
属性ディクショナリには、フォームとレポートの作成に使用する列についての属性のセットが含まれます。定義は列名によって照合され、シノニムを使用することで特定の定義を複数の列間で共有できます。
属性ディクショナリの管理ページを使用して、現在のページの値を属性ディクショナリ内の値で更新するか、現在のページの値で属性ディクショナリを更新することができます。
属性ディクショナリの管理ページにアクセスするには、次のステップを実行します。
「作業領域」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。
アプリケーション・ビルダーのホームページが表示されます。
アプリケーションを選択します。
ページを選択します。
ページ定義が表示されます。
「ユーティリティ」ボタンをクリックした後、「属性ディクショナリ」をクリックします。
このページは、「ページ・アイテム」と「レポート列」の2つのセクションに分かれています。
少なくとも1つの属性について異なる値を持つアイテムおよびレポート列のみが表示されます。挿入または更新するオブジェクトと、含める属性を選択します。非表示オブジェクト、非表示リージョン内のオブジェクトおよびボタン・アイテムは含まれないため、使用できるアイテムおよびレポート列は合計よりも少ないことがあります。
現在のページを更新するか、現在の属性ディクショナリを更新するには、適切なハイパーテキスト・リンクを選択します。
|
ヒント: SQLワークショップの属性ディクショナリに移動するには、「タスク」リストの「属性ディクショナリへのアクセス」をクリックします。詳細は、Oracle Application Express SQLワークショップ・ガイドの「ユーザー・インタフェースのデフォルト値の管理」を参照してください。 |
