プライマリ・コンテンツに移動

Oracle® Application Expressアプリケーション・ビルダー・ユーザーズ・ガイド リリース5.1 E83810-03 |
| 目次 | 索引

前 | 次 |

# 6.6 データベース・アプリケーションのページの管理

ページは、アプリケーションの基本的な構成要素です。アプリケーション・ビルダーでアプリケーションを構築する際は、タブ、リスト、ボタン、アイテム、リージョンなどのユーザー・インタフェース要素を含むページを作成します。

ヒント:

アプリケーション・ビルダーでは、ページ・デザイナまたはコンポーネント・ビューを使用してアプリケーション・ページを表示および管理します。詳細は、ページ・デザイナでのページの管理またはアプリケーション・レガシー・コンポーネントの管理を参照してください。

トピック:

- データベース・アプリケーションへのページの追加について
- ページの作成ウィザード実行時のページ・タイプ
- アプリケーションのホームページからのページの作成
- ダイアログ・ページの作成
- データベース・アプリケーション・ページのコピーについて
- ユーザー・インタフェース間のページのコピーについて
- データベース・アプリケーション・ページの削除について

関連項目:

アプリケーション・ユーティリティの使用

## 6.6.1 データベース・アプリケーションへのページの追加について

開発者は、ページの作成ウィザードを実行することによって、既存のデータベース・アプリケーションにページを追加します。このウィザードには次のようにアクセスできます。

- アプリケーションのホームページ: 「ページの作成」をクリックします。アプリケーションのホームページからのページの作成を参照してください。

- ページ・デザイナでのページの表示: ページ・デザイナの開発者ツールバーで「作成」をクリックして「ページ」を選択します。ページ・デザイナ・ツールバーを参照してください。

- コンポーネント・ビューでのページの表示: コンポーネント・ビューのナビゲーション・バーで「作成」をクリックして「ページ」を選択します。コンポーネント・ビューのナビゲーション・バーを参照してください。

## 6.6.2 ページの作成ウィザード実行時のページ・タイプ

アプリケーションを作成するときに、ターゲット・ユーザー・インタフェースを選択します。選択したユーザー・インタフェースによって、使用可能なページ・タイプが決まります。すべてのページ・タイプがすべてのユーザー・インタフェースでサポートされるわけではありません。

デスクトップ・アプリケーションで使用可能なページ・タイプ

デスクトップ・アプリケーションを作成している場合、ページの作成ウィザードで次のページ・タイプがサポートされます。

表6-19 ページの作成ウィザード: デスクトップ・アプリケーションのページ・タイプ

ページ・タイプ | 説明 | 詳細情報
--- | --- | ---
空白ページ | 組込み機能のないページを作成します。 | 該当なし
レポート | レポートは、SQL問合せの結果の書式を設定したものです。レポート・オプション: 対話モード・レポート 対話グリッド クラシック・レポート 表のレポートとフォーム Webサービスのレポート | 関連項目: 「レポートの開発」 「レポート・タイプについて」 「ページの作成ウィザード実行時のレポート・オプション」
フォーム | フォームでは、ユーザーが表内の単一行または複数行を更新できます。フォーム・オプション: 表のフォーム付きレポート 編集可能対話グリッド 1ページのマスター・ディテール 2ページのマスター・ディテール 表のフォーム プロシージャのフォーム SQL問合せのフォーム Webサービスのフォーム Webサービスのレポートとフォーム | 関連項目: 「フォームの作成」 「フォーム・タイプの理解」 「ページの作成ウィザード実行時のフォーム・オプション」
プラグイン | リージョン・タイプ・プラグインに基づいて新しいページを作成します。開発者はプラグインを使用して、Oracle Application Expressで使用可能な組込みタイプを宣言的に拡張、共有および再利用できます。 | プラグイン・ページからのプラグインのインポートを参照してください。
チャート | グラフィカル・チャートを作成できます。 | チャートの作成を参照してください。
Calendar | 月別、週別、日別表示のカレンダを生成します。 | カレンダの作成を参照してください。
ツリー | 階層的なデータまたは複数のレベルのデータをグラフィカルに通信し、必要に応じて各ツリー・ノードに固有のページまたはURLにナビゲートするためのツリーを作成します。 | ツリーの作成を参照してください。
ウィザード | ウィザードを作成します。 | 該当なし
データのロード | 新しいデータのロード・ウィザードを作成して、エンド・ユーザーが、権限を持つすべてのスキーマに対する表へのデータのロードを管理できるようにします。 | データ・ロード機能によるアプリケーションの作成を参照してください。
フィードバック・ページ | フィードバック・ページを追加します。フィードバックは、アプリケーション・ユーザーからリアルタイム・コメント、拡張リクエストおよびバグを収集するプロセスです。 | フィードバックの管理を参照してください。
アクセス制御 | アクセス制御リストを含むページを作成すると、開発者はアプリケーション、個別ページまたはページ・コンポーネントへのアクセスを制御できます。 | アプリケーション、ページおよびページ・コンポーネントへのアクセスの制御を参照してください。
グローバル・ページ | グローバル・ページ(以前はページ0と呼ばれていた)は、マスター・ページとして機能します。 | すべてのページにコンポーネントを表示するグローバル・ページの作成を参照してください。
レガシー・ページ | レガシー・ページに含まれるコンポーネントは、引き続きOracleでサポートされますが、使用することはお薦めしません。オプションは次のとおりです。 表形式フォーム レガシー・マスター・ディテール AnyChartチャート サマリー・ページ レガシー・カレンダ | アプリケーション・レガシー・コンポーネントの管理を参照してください。

モバイル・アプリケーションで使用可能なページ・タイプ

モバイル・アプリケーションを作成している場合、ページの作成ウィザードで次のページ・タイプがサポートされます。

表6-20 ページの作成ウィザード: モバイル・アプリケーションのページ・タイプ

ページ・タイプ | 説明 | 詳細情報
--- | --- | ---
空白ページ | 組込み機能のないページを作成します。 | 該当なし
レポート | レポートは、SQL問合せの結果の書式を設定したものです。使用可能なレポート・オプションは次のとおりです。 リスト・ビュー 列切替えレポート リフロー・レポート Webサービスのレポート | 関連項目: 「レポートの開発」 「レポート・タイプについて」 「ページの作成ウィザード実行時のレポート・オプション」
フォーム | フォームでは、ユーザーが表内の単一行または複数行を更新できます。使用可能なフォーム・オプションは次のとおりです。 表のリスト・ビュー付きのレポート 表のフォーム プロシージャのフォーム SQL問合せのフォーム Webサービスのフォーム Webサービスのレポートとフォーム | 関連項目: 「フォームの作成」 「フォーム・タイプの理解」 「ページの作成ウィザード実行時のフォーム・オプション」
プラグイン | リージョン・タイプ・プラグインに基づいて新しいページを作成します。開発者はプラグインを使用して、Oracle Application Expressで使用可能な組込みタイプを宣言的に拡張、共有および再利用できます。 | プラグイン・ページからのプラグインのインポートを参照してください。
チャート | グラフィカル・チャートを作成できます。 | レガシー・チャートの管理を参照してください。
Calendar | 月別、週別、日別表示のカレンダを生成します。 | カレンダの作成を参照してください。
ウィザード | ウィザードを作成します。 | 該当なし
フィードバック・ページ | フィードバック・ページを追加します。フィードバックは、アプリケーション・ユーザーからリアルタイム・コメント、拡張リクエストおよびバグを収集するプロセスです。 | フィードバックの管理を参照してください。
アクセス制御 | アクセス制御リストを含むページを作成すると、開発者はアプリケーション、個別ページまたはページ・コンポーネントへのアクセスを制御できます。 | アプリケーション、ページおよびページ・コンポーネントへのアクセスの制御を参照してください。
レガシー・ページ | レガシー・ページに含まれるコンポーネントは、引き続きOracleでサポートされますが、使用することはお薦めしません。オプションは次のとおりです。 AnyChartチャート サマリー・ページ レガシー・カレンダ | アプリケーション・レガシー・コンポーネントの管理を参照してください。

## 6.6.3 アプリケーションのホームページからのページの作成

アプリケーションのホームページからページを作成するには、次のステップを実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。
2. アプリケーションを選択します。
   アプリケーションのホームページが表示されます。
3. 「ページの作成」ボタンをクリックします。
4. 「ページの作成」で、次のステップを実行します。

   1. ユーザー・インタフェース: ページのユーザー・インタフェースを選択します。

   2. 「ページ・タイプの選択」で、作成するページ・タイプを選択します。ページの作成ウィザード実行時のページ・タイプを参照してください。

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

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

関連項目:

- データベース・アプリケーションへのページの追加について

- 「ページ・デザイナでのページ属性の管理」

- 「コンポーネント・ビューでのダイアログ属性の構成」

## 6.6.4 ダイアログ・ページの作成

Oracle Application Expressには、ダイアログ・ページに対するサポートが提供されています。モーダルまたは非モーダル・ダイアログ・ページは、テンプレート・タイプが「ダイアログ・ページ」のページ・テンプレートが、カレント・アプリケーション・テーマに1つ以上含まれている場合にのみサポートされます。

トピック:

- サポートされるダイアログについて
- ダイアログ・ページ・テンプレートの使用
- コンポーネント・ビューでのダイアログとしてのページの定義
- ページ・デザイナでのダイアログとしてのページの定義
- ダイアログ・ページでの「ダイアログを取り消す」動的アクションの生成
- ダイアログ・ページでの「ダイアログを閉じる」ページ・プロセスの生成
- ダイアログ・ページでのブランチングについて
- 親ページでのリフレッシュ・アクションの処理

### 6.6.4.1 サポートされるダイアログについて

新しいページを作成するときに、ウィザードによって、ページ・モードを選択するプロンプトが表示されます。ページ・モードによって、ページが標準アプリケーション・ページであるかダイアログ・ページであるかが決まります。Oracle Application Expressは、次の2つのダイアログ・ページ・タイプをサポートしています。

- モーダル・ダイアログ - モーダル・ダイアログは、同じブラウザ・ウィンドウ内に配置されるオーバーレイ・ウィンドウです。モーダル・ダイアログは、ユーザーが終了して閉じるまで、アクティブでフォーカスされたままです。モーダル・ダイアログがアクティブである間は、ダイアログを閉じるまでユーザーは残りのページと対話できません。

- 非モーダル・ダイアログ - 非モーダル・ダイアログは、個別のポップアップ・ブラウザ・ウィンドウを表示します。ユーザーは、非モーダル・ダイアログおよびページのコンテンツと対話できます。リクエストされる情報が続行に必要でない場合に、非モーダル・ダイアログを使用します。このウィンドウ・タイプは、別の場所で作業が続いている間、開いたままにできます。

### 6.6.4.2 ダイアログ・ページ・テンプレートの使用

Oracle Application Expressには、ユニバーサル・テーマ - 42にダイアログ・ページ・テンプレートが含まれています。ページ・モードを「モーダル」または「非モーダル」に設定すると、Oracle Application Expressは自動的にデフォルトのダイアログ・ページ・テンプレートを使用します。この項では、テーマにダイアログ・テンプレートが含まれていない場合にそれを作成する方法と、ダイアログ・テンプレート属性を編集する方法について説明します。

トピック:

- ダイアログ・ページ・テンプレートの作成
- ダイアログ・ページ・テンプレート属性の定義について

#### 6.6.4.2.1 ダイアログ・ページ・テンプレートの作成

既存のアプリケーションを使用し、テーマにそのようなダイアログ・ページ・テンプレートが含まれない場合は、ダイアログ・ページ・テンプレートを作成する必要があります。最初から作成できますが、最も簡単な方法は既存のダイアログ・テンプレートをコピーすることです。

ダイアログ・ページ・テンプレートを作成するには、次のステップを実行します。

1. サンプル・データベース・アプリケーションからダイアログ・ページ・テンプレートをコピーします。

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

   2. テンプレートをコピーするアプリケーションを選択します。

   3. 「共有コンポーネント」をクリックします。

   4. 「ユーザー・インタフェース」で、「テンプレート」を選択します。

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

   6. テンプレートの作成ウィザードで、次のステップを実行します。

      - テンプレート・タイプ - 「ページ」を選択して、「次へ」をクリックします。

      - 作成方法 - 「既存のテンプレートのコピーとして」を選択して、「次へ」をクリックします。

      - コピー元 - 「サンプル・データベース・アプリケーション」を選択して、「次へ」をクリックします。

      - テーマの指定 - コピー元のテーマおよびコピー先のテーマを選択して、「次へ」をクリックします。

      - 新規テンプレート - 「モーダル・ダイアログ」テンプレートを探します。「コピー」で、「はい」を選択します。

      - 「ページ・テンプレートのコピー」を選択して作成します。

2. ダイアログ・ページ・テンプレートがカレント・テーマでアクティブになっていることを確認します。デフォルトのページ・テンプレートの選択を参照してください。

#### 6.6.4.2.2 ダイアログ・ページ・テンプレート属性の定義について

ダイアログ・ページ・テンプレートには、ダイアログ・ページの初期化、クローズおよび取消を処理するJavaScriptファンクション・コールが含まれています。ダイアログ・ページ・テンプレートを作成する場合は、これらおよび他のダイアログ・ページ・テンプレート属性を定義する必要があります。

関連項目:

必須のダイアログ・ページ・テンプレート属性

### 6.6.4.3 コンポーネント・ビューでのダイアログとしてのページの定義

ダイアログ・ページを作成するには、ページ・モードを「モーダル・ダイアログ」または「非モーダル・ダイアログ」に設定する必要があります。ページの作成ウィザードの実行中またはページ属性の編集によってページ・モードを構成できます。

コンポーネント・ビューでダイアログとしてページを定義するには、次のステップを実行します。

1. ページ属性を編集します。コンポーネント・ビューでページを表示します。
2. ページ・モードを「モーダル・ダイアログ」および「非モーダル・ダイアログ」に設定します。

   ヒント:

   ページ属性を編集することによって、またはページの作成ウィザードの実行中にページ・モードを構成できます。

3. ページ・レベル・ダイアログ属性を定義します。

関連項目:

「コンポーネント・ビューでのページ属性の編集」および「ダイアログ」

### 6.6.4.4 ページ・デザイナでのダイアログとしてのページの定義

ページ・デザイナでダイアログとしてページを定義するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。
   1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。
   2. アプリケーションを選択します。
   3. ページを選択します。
   ページ・デザイナが表示されます。
2. 「ページ・デザイナ」で「外観」を見つけます。
3. 「ページ・モード」で、次のいずれかを選択します。
   - モーダル・ダイアログ - ページはモーダル・ダイアログとして表示されます。モーダル・ダイアログは、ビューポート内に配置されたオーバーレイ・ウィンドウで、エンド・ユーザーが終了する(閉じる)までアクティブでフォーカスされたままです。基になるページはグレーアウトされ、ダイアログを閉じるまで、エンド・ユーザーは残りのページと対話できません。
   - 非モーダル・ダイアログ - ページは非モーダル・ダイアログとして表示されます。非モーダル・ダイアログはビューポート内に配置されたオーバーレイ・ウィンドウであり、エンド・ユーザーはこれを使用してダイアログおよびダイアログを起動したページのコンテンツと対話できます。非モーダル・ダイアログは、リクエストされる情報が続行するために必要な情報ではなく、ウィンドウが開いたままでも別の場所で作業を続行できる場合に使用できます。
4. 必要に応じて他の「外観」属性を編集します。

   ヒント:

   属性の詳細は、フィールドレベル・ヘルプを参照してください。

5. 「ダイアログ」で、適切な属性を編集します。
   1. 幅 - ダイアログの幅をピクセル単位または比率で入力します。ページ・テンプレートのダイアログ初期化コード内の置換文字列`#DIALOG_WIDTH#`は、このアイテムに入力した値で置換されます。デスクトップ・ユーザー・インタフェースを使用しているページの場合、値は500などのピクセル単位で設定します。ただし、jQueryモバイル・スマートフォン・ユーザー・インタフェースを使用しているページの場合、値は80%などのパーセント単位で設定します。
   2. 高さ - ダイアログの高さをピクセル単位で入力します(たとえば、500)。ページ・テンプレートのダイアログ初期化コード内の置換文字列`#DIALOG_HEIGHT#`は、入力した値で置換されます。
   3. 最大幅 - ダイアログの最大幅をピクセル単位で入力します。ページ・テンプレートのダイアログ初期化コード内の置換文字列`#DIALOG_MAX_WIDTH#`は、このアイテムに入力した値で置換されます。
   4. 属性 - ダイアログのサポートはページのユーザー・インタフェースによって異なります。高さ、幅および最大幅など、ダイアログ属性のサブセットは宣言的にサポートされます。ダイアログの追加属性を定義するには、名前/値のペアをカンマ区切りリストに入力します。ページ・テンプレート・レベルで定義されたダイアログ初期化コード内の置換文字列`#DIALOG_ATTRIBUTES#`は、このアイテムに入力された任意の値で置換されます。
   5. CSSクラス - このコンポーネントに追加するクラスを入力します。複数のクラスは空白で区切って追加できます。
   6. チェーン - このダイアログが別のダイアログによって開かれ、同じダイアログ・ウィンドウを再利用する場合、「はい」を選択します。たとえば、このダイアログが複数ページ・ダイアログ・ウィザードの一部で、ウィザードの各ステップにダイアログ・ウィンドウを再利用する場合です。このダイアログが別のダイアログによって開かれ、新規ダイアログ・ウィンドウで開かれる必要がある場合、「いいえ」を選択します。たとえば、このダイアログがモーダルで、親モーダル・ダイアログ・ウィンドウ内で開く場合です。
6. 変更内容を保存するには、保存をクリックします。

関連項目:

データベース・アプリケーションへのページの追加について

### 6.6.4.5 ダイアログ・ページでの「ダイアログを取り消す」動的アクションの生成

ダイアログ・ページに「取消」ボタンが含まれる場合は、そのボタンのクリックに基づいた動的アクションを生成し、そのTrueアクション・イベントを「ダイアログを取り消す」に設定する必要があります。この動的アクションは、ページ・テンプレート(`apex.navigation.dialog.cancel`)に含まれる取消のJavaScriptコールを使用して、ダイアログの取消を処理します。

関連項目:

動的アクションの管理

### 6.6.4.6 ダイアログ・ページでの「ダイアログを閉じる」ページ・プロセスの生成

「ダイアログを閉じる」ページ・プロセスを作成することによって、Oracle Application Expressでダイアログ・ページを閉じます。以前のリリースでは、このページ・プロセスは`「ポップアップ・ウィンドウを閉じる」`と呼ばれていました。このダイアログは、ページ・テンプレート(`apex.navigation.dialog.close)`に含まれるクローズのJavaScriptコールを使用して、ダイアログのクローズを処理します。ページ・プロセスは、親ページで参照することがあるダイアログ・ページ・アイテムの戻りもサポートしています。例を表示するには、サンプル・データベース・アプリケーションの任意のダイアログ・ページを編集します。

ヒント:

「ダイアログを閉じる」動的アクションでダイアログ・ページを閉じることもできます。動的アクションとプロセスの両方が、ダイアログ・ページ・アイテムの戻りをサポートしています。ページを送信する必要がある場合はページ・プロセスを使用し、ページを送信する必要がない場合は動的アクションを使用します。両方とも、最終的にはクローズのJavaScriptコールをコールします。または、ダイアログ・ページを閉じて、ブランチで指定したページにリダイレクトするページ・ブランチを作成できます。

関連項目:

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

- サンプル・データベース・アプリケーションの理解

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

### 6.6.4.7 ダイアログ・ページでのブランチングについて

ダイアログ・ページを開くには、ボタンまたはリンクを使用します。ダイアログ・ページでは、次のブランチング・オプションがサポートされています。

- ダイアログ・ページからダイアログ・ページへの場合。

  1つのダイアログ・ページから別のダイアログ・ページに、ブランチできます。

  - 両方のページは、「モーダル・ダイアログ」のような同じページ・モードで、ダイアログのChained属性は「はい」に設定されています。Chained属性を「はい」に設定すると、多くの内部Application Expressウィザードで表示されるチェーンまたはネスト・ダイアログがサポートされます。チェーンまたはネスト・ダイアログを使用すると、ダイアログ・ウィンドウを再度利用して各ページを表示できます。

- ダイアログ・ページから標準・ページの場合。

  - ダイアログ・ページから標準・ページにブランチすると、ダイアログが閉じられ、ユーザーはブラウザ内の新しいページに移動します。新しいページは、親(または起動)ページ、もしくはアプリケーション内の別の標準ページです。

### 6.6.4.8 親ページでのリフレッシュ・アクションの処理

ダイアログ・ページで「ダイアログを閉じる」ページ・プロセスを生成した場合、新しい`「ダイアログのクローズ」`動的アクション・イベント・タイプを使用して、親ページにリフレッシュ・アクションを実装する必要があります。「値の設定」のTrueアクションを作成するとき、タイプ設定「ダイアログ戻りアイテム」を使用し、ダイアログの戻りアイテムに基づいて単一の値が設定されるようにできます。

例を表示するには、サンプル・データベース・アプリケーションの製品のページに移動します。製品のページで、「Create Product」ボタンにはダイアログを起動する動的アクションが関連付けられています。ダイアログを閉じると、`「ダイアログのクローズ」`動的アクションをトリガーします。定義するすべてのTrueアクションにこのタイプの動的アクションを使用できます。この例では、親ページのレポートをリフレッシュしてページを送信します。

ヒント:

親ページの部分ページ・リフレッシュを行う場合は、ダイアログを閉じるときの動的アクションを実装します(たとえば、レポート・ページおよびフォーム・ページのデータをモーダル・ダイアログ・フォームで編集し、閉じるときにのみレポートがリフレッシュされるようにする場合)。対照的に、マルチ・ステップのモーダル・ウィザードがある場合や、ダイアログを閉じるときに可能なターゲットページが複数ある場合は、ブランチ処理が最適な方法となります。

関連項目:

- 「サンプル・データベース・アプリケーションのインストールおよび実行」

- 動的アクションの管理

- サンプル・データベース・アプリケーションの理解

## 6.6.5 データベース・アプリケーション・ページのコピーについて

現在のアプリケーションまたは別のアプリケーションからページをコピーできます。コピー・プロセス中に、共有コンポーネントのコピーや、ターゲット・アプリケーションの共有コンポーネントへのマッピングを変更することもできます。

関連項目:

ページ・デザイナでのデータベース・アプリケーション・ページのコピーおよびレガシー・コンポーネント・ビューでのデータベース・アプリケーション・ページのコピー

## 6.6.6 ユーザー・インタフェース間のページのコピーについて

注意:

jQuery Mobileスマートフォン・ページへのデスクトップ・ページのコピー、またはデスクトップ・ページへのjQuery Mobileスマートフォン・ページのコピーはサポートしていません。

ページのコピー・ウィザードでは、ページを異なるユーザー・インタフェースにコピーできます。コピー・プロセス時に、ユーザーは新しいページのユーザー・インタフェースを選択できます。アプリケーションにデスクトップおよびモバイル・テーマが含まれる場合、両方のユーザー・インタフェース・オプションが表示されます。

jQuery Mobileスマートフォン・ページへのデスクトップ・ページのコピー、またはデスクトップ・ページへのjQuery Mobileスマートフォン・ページのコピーはサポートしていません。次のデスクトップ・ページをモバイル・ユーザー・インタフェースにコピーしようとすると、エラーが発生します。

- 対話モード・レポート

- Flashマップ

- Flashチャート

- ツリー・リージョン

## 6.6.7 データベース・アプリケーション・ページの削除について

ページを削除すると、対応する表、ブレッドクラムおよびリスト・エントリが削除されます。ロック解除されているか、自分がロックしたページのみを削除できます。

関連項目:

ページ・デザイナでのページの削除およびレガシー・コンポーネント・ビューでのページの削除