Oracle® Application Express

アプリケーション・ビルダー・ユーザーズ・ガイド

リリース3.2

B53794-04(原本部品番号:E11947-03)

2013年7月

Oracle Application Expressアプリケーション・ビルダー・ユーザーズ・ガイド, リリース3.2

B53794-04

Copyright © 2003, 2013, Oracle and/or its affiliates.All rights reserved.

原本著者: Terri Jennings

原本協力者: Marco Adelfio、Carl Backstrom、Christina Cho、Michael Hichwa、Christopher Jones、Joel Kallman、Sharon Kennedy、Syme Kutz、Sergio Leunissen、Anne Romano、Kris Rice、Marc Sewtz、Scott Spadafore、Scott Spendolini、Jason Straub、Simon Watt、Steve Fogel

このソフトウェアおよび関連ドキュメントの使用と開示は、ライセンス契約の制約条件に従うものとし、知的財産に関する法律により保護されています。ライセンス契約で明示的に許諾されている場合もしくは法律によって認められている場合を除き、形式、手段に関係なく、いかなる部分も使用、複写、複製、翻訳、放送、修正、ライセンス供与、送信、配布、発表、実行、公開または表示することはできません。このソフトウェアのリバース・エンジニアリング、逆アセンブル、逆コンパイルは互換性のために法律によって規定されている場合を除き、禁止されています。

ここに記載された情報は予告なしに変更される場合があります。また、誤りが無いことの保証はいたしかねます。誤りを見つけた場合は、オラクル社までご連絡ください。

このソフトウェアまたは関連ドキュメントを、米国政府機関もしくは米国政府機関に代わってこのソフトウェアまたは関連ドキュメントをライセンスされた者に提供する場合は、次の通知が適用されます。

U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, delivered to U.S. Government end users are "commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations.As such, use, duplication, disclosure, modification, and adaptation of the programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, shall be subject to license terms and license restrictions applicable to the programs.No other rights are granted to the U.S. Government.

このソフトウェアもしくはハードウェアは様々な情報管理アプリケーションでの一般的な使用のために開発されたものです。このソフトウェアもしくはハードウェアは、危険が伴うアプリケーション(人的傷害を発生させる可能性があるアプリケーションを含む)への用途を目的として開発されていません。このソフトウェアもしくはハードウェアを危険が伴うアプリケーションで使用する際、安全に使用するために、適切な安全装置、バックアップ、冗長性(redundancy)、その他の対策を講じることは使用者の責任となります。このソフトウェアもしくはハードウェアを危険が伴うアプリケーションで使用したことに起因して損害が発生しても、オラクル社およびその関連会社は一切の責任を負いかねます。

OracleおよびJavaはOracle Corporationおよびその関連企業の登録商標です。その他の名称は、それぞれの所有者の商標または登録商標です。

Intel、Intel Xeonは、Intel Corporationの商標または登録商標です。すべてのSPARCの商標はライセンスをもとに使用し、SPARC International, Inc.の商標または登録商標です。AMD、Opteron、AMDロゴ、AMD Opteronロゴは、Advanced Micro Devices, Inc.の商標または登録商標です。UNIXは、The Open Groupの登録商標です。

このソフトウェアまたはハードウェア、そしてドキュメントは、第三者のコンテンツ、製品、サービスへのアクセス、あるいはそれらに関する情報を提供することがあります。オラクル社およびその関連会社は、第三者のコンテンツ、製品、サービスに関して一切の責任を負わず、いかなる保証もいたしません。オラクル社およびその関連会社は、第三者のコンテンツ、製品、サービスへのアクセスまたは使用によって損失、費用、あるいは損害が発生しても一切の責任を負いかねます。

目次

タイトルおよび著作権情報

はじめに

- トピック概要

- 対象読者

- ドキュメントのアクセシビリティについて

- 関連ドキュメント

- 表記規則

Oracle Application Expressの新機能

- Oracle Application Expressリリース3.2の新機能

- Oracle Application Expressリリース3.1のハイライト

1 クイック・スタート

- Oracle Application Expressの概要

- Oracle Application Expressアーキテクチャについて

- Application Expressユーザー・ロールの理解

- Oracle Application Expressへのログイン

- ブラウザ要件について

- Oracle Application Express環境の構成

- 開発者としてのOracle Application Expressへのログイン

- ワークスペースのホームページについて

- ナビゲーションの選択肢

- オンライン・ヘルプの使用

2 デモンストレーション・アプリケーションの実行

- デモンストレーション・アプリケーションのインストール

- インストールされたデモンストレーション・アプリケーションの実行

- デモンストレーション・アプリケーションからのアプリケーションの実行

- アプリケーションのホームページからのアプリケーションの実行

- サンプル・アプリケーションの理解

- Homeページについて

- Customersページについて

- Productsページについて

- Ordersページについて

- Chartsページについて

- Adminページについて

- 「印刷用」モードでのページの表示

- デモンストレーション・アプリケーションの変更

- 開発者ツールバーについて

- デモンストレーション・アプリケーションの編集

- 基礎となるデータベース・オブジェクトの表示

- 「データベース・オブジェクトの依存性」レポートの表示

- オブジェクト・ブラウザでのデータベース・オブジェクトの表示

3 アプリケーション・ビルダーの概念

- ページの概要

- ページ・プロセスおよびページ・レンダリングの理解

- Application Expressエンジンがページをレンダリングおよび処理する方法

- 条件付きのレンダリングおよびプロセスの理解

- ユーザー・アイデンティティの確認

- コントロールおよびコンポーネントへのアクセスの制御

- セッション・ステートの管理の理解

- セッションの概要

- セッションIDの理解

- セッション・ステートの表示

- URL構文の理解

- ページに表示されるURLの理解

- f?p構文を使用したページのリンク

- アプリケーションおよびページの別名を使用したページのコール

- ボタンのURLからのページのコール

- セッションIDにゼロを使用したブックマークの容易化

- セッション・ステート値の管理

- セッション・ステートの参照

- セッション・ステートの設定

- セッション・ステートのクリア

- バインド変数構文について

- 置換文字列の理解

- 置換文字列の使用

- 組込み置換文字列について

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

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

- アプリケーション・ビルダーのホームページについて

- 「開発者のプリファレンス」の構成

- アプリケーションのホームページについて

- アクション・バーについて

- アプリケーション属性について

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

- セキュリティ属性の構成

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

5 アプリケーション・ページの操作

- ページ定義について

- ページ定義へのアクセス

- ページ定義の理解

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

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

- ページ・イベントについて

- データベース・オブジェクトの依存性について

- 履歴について

- エクスポートについて

- グループについて

- 参照について

- ページ定義の編集

- 「すべての編集」アイコンについて

- 「コピー」または「作成」アイコンについて

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

- ページ・レンダリングについて

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

- 共有コンポーネントについて

- ページ計算の理解

- 検証の理解

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

- ブランチの理解

- ページ属性の編集

- ページ属性へのアクセス

- ページ属性ページについて

- 開発者ツールバーについて

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

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

- 共有コンポーネント・ページについて

- 共有コンポーネントのエクスポートについて

- 共有コンポーネントのレポートへのアクセス

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

- オンデマンド・アプリケーション・プロセスについて

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

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

- アプリケーション・プロセス・レポートへのアクセス

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

- アプリケーションの計算について

- アプリケーションの計算の作成

- アプリケーション計算履歴レポートへのアクセス

6 アプリケーションの構築

- アプリケーションの作成

- ウィザードを使用したアプリケーションの作成について

- アプリケーションの作成ウィザードについて

- スプレッドシートからのアプリケーションの作成ウィザードについて

- デモンストレーション・アプリケーションについて

- アプリケーションのコピー

- アプリケーションの削除

- アプリケーション内のページの管理

- ページの作成について

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

- ページ定義からのページの作成

- 「開発者」ツールバーからのページの作成

- ページのコピー

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

- ページのグループ化

- ページのロックおよびロック解除

- ページの削除

- アプリケーション・コメントの追加

- アプリケーション・コメントの作成

- アプリケーション・コメント・レポートの表示

- 開発者コメントの追加

- アプリケーションまたはページへの開発者コメントの追加

- 開発者コメントの表示と編集

- 開発者コメントの削除

- 開発者コメント・レポートについて

- アプリケーション・グループの作成

- アプリケーション・グループの表示

- アプリケーション・グループの作成

- アプリケーション・グループへのアプリケーションの割当て

- アプリケーション・グループからのアプリケーションの削除

- アプリケーション・グループの削除

- アプリケーション・レポートの表示

- アプリケーション・レポートへのアクセス

- 共有コンポーネント・レポート

- ページ・コンポーネント・レポート

- アクティビティ・レポート

- アプリケーション間レポート

- ページ・レベル・アイテムの理解

- ページ・アイテムとアプリケーション・アイテムの違い

- ページ定義の「アイテム」セクションについて

- ページ・レベル・アイテムの作成

- ページ・レベル・アイテムの編集

- ドラッグ・アンド・ドロップ・レイアウト・ページの使用

- アイテム値の参照

- 条件付きページ・アイテムまたは読取り専用ページ・アイテムの表示

- 複数選択リスト・アイテムでの操作

- アプリケーション・レベル・アイテムの理解

- アプリケーション・レベル・アイテムの作成

- アプリケーション・アイテム履歴へのアクセス

- アプリケーション・レベル・アイテム属性の編集

7 アプリケーション・コンポーネントの追加

- レポートの作成

- ウィザードを使用したレポートの作成

- 対話モード・レポートの使用

- 対話モード・レポートの編集

- SQLレポートおよびウィザード・レポートの編集

- レポート・リージョンの出力

- フォームの作成

- ウィザードを使用したフォームの作成

- 表形式フォームの作成

- マスター・ディテール・フォームの作成

- フォームの手動作成

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

- カレンダの作成

- カレンダの作成

- 新しいカレンダの作成

- カレンダ・タイトルの編集

- カレンダ属性の編集

- 以前のリリースで作成されたカレンダのアップグレード

- SQLカレンダへの簡易カレンダの変換

- チャートの作成

- サポートするチャート・タイプの概要

- チャートのSQL問合せの作成について

- HTMLチャートの作成

- SVGチャートの作成

- Flashチャートの作成

- チャート属性の編集

- FlashチャートとのカスタムXMLの使用

- 非同期更新の有効化

- 他の言語でのSVGチャートの表示

- ボタンの作成

- ページ定義の「ボタン」セクションの概要

- ウィザードを使用したボタンの作成

- 複数のボタンの作成

- ボタンの編集

- ボタン名とREQUESTの関係の理解

- ボタンを使用したブランチ処理について

- ボタンの条件付き表示

- LOVの作成

- アプリケーション・レベルでの名前付きのLOVの作成

- 静的LOVについて

- 既存のLOVの編集

- LOV内でのセッション・ステートの参照

- LOVに基づくアイテム内のNULL値の参照

- LOVレポートへのアクセス

- 依存選択リストの作成

- ショートカットの使用

- ショートカット・タイプ

- ショートカットの定義

- 既存のショートカットの編集

- ショートカット・レポートの表示

- 「検索」アイコンの使用

- 「検索」アイコンについて

- 「アイテム・ファインダ」について

- 「ページ・ファインダ」の使用

- 「問合せファインダ」の使用

- 「表ファインダ」の使用

- PL/SQLファインダの使用

- イメージ・ファインダの使用

- CSSファインダの使用

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

- アクセス制御リストの動作方法

- アクセス制御リストの作成

- アプリケーション・モードの選択とユーザーの追加

- ページおよびページ・コンポーネントに対するアクセスの制御

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

- JavaScriptを使用したアイテムの参照

- JavaScriptファンクションの組込み

- ボタンからのJavaScriptのコール

- 印刷用ページの最適化

- アプリケーションの印刷用テンプレートの選択

- f?p構文を使用した印刷用モードへの切替え

- ヘルプ・ページの作成

- ヘルプ・ページおよびヘルプ・リージョンの作成

- ヘルプ・テキストの定義

- ヘルプ・ナビゲーション・バー・エントリの作成

8 ナビゲーションの追加

- タブの作成

- テンプレートのサポートについて

- ページ定義の「タブ」セクションについて

- 「タブの順序変更」アイコンの使用

- タブ・ページについて

- タブの作成方法

- タブの編集

- タブ・レポートへのアクセス

- リストの作成

- リストの作成方法

- ページへのリストの追加

- リストの編集

- 複数のリスト・エントリの同時編集

- リスト・レポートへのアクセス

- ブレッドクラムの作成

- ブレッドクラムについて

- ブレッドクラムの作成方法

- ブレッドクラムの編集

- ブレッドクラム・エントリの親の変更

- ブレッドクラム・レポートへのアクセス

- ツリーの作成

- ツリーの作成方法

- ツリーの編集

- ツリー・レポートへのアクセス

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

- ナビゲーション・バーについて

- ナビゲーション・バー・エントリの作成方法

- ナビゲーション・バー・エントリの編集

- 複数のナビゲーション・バー・エントリの同時編集

- 「ナビゲーション・バー・エントリの順序変更」アイコンの使用

- ナビゲーション・バー・エントリ・レポートへのアクセス

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

9 ページ・レイアウトの制御

- Oracle Application Expressでのページ・レイアウトの理解

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

- リージョンの理解

- ページ定義の「リージョン」セクションについて

- 「リージョンの順序変更」アイコンの使用

- リージョン属性の編集

- リージョンの作成

- リージョン・タイプについて

- リージョンのコピー

- 複数列レイアウトの作成

- 複数列のリージョンの作成

- 複数列のページ・テンプレートの作成

- アイテム属性がページ・レイアウトに与える影響

- 他のWebサイトからのコンテンツの統合

- イメージの管理

- イメージのアップロード

- イメージの参照

- イメージ属性の編集

- イメージの削除

- 静的ファイルの管理

- 静的ファイルのアップロード

- アップロードしたファイルの編集

- アップロードしたファイルのダウンロード

- アップロードしたファイルの削除

- カスタムPL/SQLを使用したHTMLのレンダリング

10 テーマおよびテンプレートの管理

- テーマの管理

- テーマ・ページへのアクセス

- テーマのデフォルトのテンプレートの変更

- テーマの作成

- テーマの編集

- アクティブなテーマの切替え

- テーマのコピー

- テーマの削除

- ワークスペース・テーマの管理

- テーマのエクスポートおよびインポートについて

- テーマ識別番号の変更

- テーマ・レポートの表示

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

- カスケード・スタイルシートについて

- デフォルトのページ・テンプレートの選択

- 新しいテンプレートの作成

- テンプレート・レポートの表示

- テンプレートの管理

- ブレッドクラム・テンプレート

- ボタン・テンプレート

- カレンダ・テンプレート

- ラベル・テンプレート

- リスト・テンプレート

- ページ・テンプレート

- ポップアップLOVテンプレート

- リージョン・テンプレート

- レポート・テンプレート

- カスタム・カスケード・スタイルシートの使用

- カスケード・スタイルシートのアップロード

- ページ・テンプレートのアップロードされたカスケード・スタイルシートの参照

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

- ユーザー・インタフェースのデフォルト値が使用されている表またはビューの表示

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

- オブジェクト・ブラウザでのUIのデフォルト値のレポートの表示

- 列属性の編集

- 列の定義について

- LOVについて

- データベース列の定義レポートについて

- アプリケーション間でのユーザー・インタフェースのデフォルト値の比較

- ユーザー・インタフェースのデフォルト値のエクスポートおよびインポートについて

12 アプリケーションのデバッグ

- パフォーマンス・チューニングについて

- セッション・ステートの確認

- デバッグ・モードへのアクセス

- SQLトレースの有効化およびTKPROFの使用

- アプリケーションとページのリソース使用の監視

- レポートの表示

- 問題のあるSQL問合せのデバッグ

- コントロールおよびコンポーネントの削除による問題の特定

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

- セキュリティに関する管理者のベスト・プラクティスの理解

- 埋込みPL/SQLゲートウェイを使用する場合のセキュリティに関する考慮事項

- Oracle Application Expressでのmod_plsqlを使用したOracle HTTP Serverの構成について

- Secure Sockets Layer(SSL)の使用

- Oracle BI Publisherとの統合

- パスワードの複雑性ルールの設定について

- Oracle Application Expressのランタイム環境の利点

- セッション・タイムアウトの理解

- Oracle Database 11gのネットワーク・サービスの有効化

- Oracle Database 11gリリース2以上でのオンライン・ヘルプの索引付けの有効化

- セキュリティに関する開発者のベスト・プラクティスの理解

- タイプ・パスワードのアイテムの理解

- 問題を引き起こす可能性のあるパスワード・アイテムの識別

- セッションIDでのゼロの使用について

- クロスサイト・スクリプティング保護の理解

- セッション・ステートおよびセキュリティについて

- セッション・ステート保護の理解

- ファイルのアップロードの保護

- 認証によるユーザー・アイデンティティの証明

- 認証の仕組みの理解

- 認証を含めるかどうかの決定

- 認証スキームの作成

- 事前構成済の認証スキームの使用

- 認証スキームを最初から作成する方法について

- 既存の認証スキームの管理

- アプリケーションに関連付けられた認証スキームの表示

- アプリケーションに関連付けられた認証スキームの変更

- 認証スキームの使用状況レポートの表示

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

- 認可スキームの動作方法

- 認可スキームの作成

- アプリケーション、ページまたはコンポーネントへの認可スキームの割当て

- 認可レポートの表示

14 アプリケーションのデプロイ

- Oracle Application Expressアプリケーション開発のライフ・サイクルについて

- 考慮すべきシステム開発のライフ・サイクル方法論

- パッケージ・プロセスの理解

- 考慮するデプロイ・オプション

- ワークスペースをコピーするかどうかの決定

- データベースをコピーするかどうかの決定

- アプリケーションIDについて

- 新規HTTPサーバーのインストールの決定

- 別の開発インスタンスへのアプリケーションの移動方法

- データベース・オブジェクトの管理について

- パッケージ・アプリケーションの作成方法

- パッケージ・アプリケーションのデプロイを簡略化する方法

- パッケージ・アプリケーションの作成

- イメージ、カスケード・スタイルシートまたは静的ファイルへのインストール・スクリプトの追加

- パッケージ・アプリケーションへのアクセス制御リストの追加

- サポートするオブジェクトのインストール

- サポートするオブジェクトのスクリプト、メッセージ、およびインストール・オプションの削除

- パッケージ・アプリケーションのアップグレード

- サポートするオブジェクトの削除

- インストール・サマリーの表示

- アプリケーションおよび関連ファイルのエクスポート

- アプリケーションのエクスポート

- ワークスペース・ユーザーのエクスポート

- アプリケーション・コンポーネントのエクスポート

- アプリケーションのページのエクスポート

- カスケード・スタイルシートのエクスポート

- イメージのエクスポート

- 静的ファイルのエクスポート

- スクリプト・ファイルのエクスポート

- テーマのエクスポート

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

- イメージ、CSSおよびスクリプト・ファイルの格納先

- エクスポート・ファイルのインポート

- アプリケーションまたはページのインポート

- カスケード・スタイルシートのインポート

- 静的ファイルのインポート

- イメージのインポート

- テーマのインポート

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

- エクスポート・ファイルのインストール

- エクスポート・リポジトリへのアクセス

- エクスポート・リポジトリからのアプリケーション・エクスポートのインストール

- エクスポート・リポジトリからのその他ファイルのインストール

- エクスポート・リポジトリからのファイルの削除

- SQL*Plusからのエクスポート・ファイルのインストール

- アプリケーションURLの公開について

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

- ビルド・オプションの作成

- ビルド・オプションの管理

- ビルド・オプションまたはビルド・オプション・ステータスのエクスポート

- ビルド・オプションの使用状況レポートの表示

15 高度なプログラミング手法

- DMLロックについて

- データベース・リンクを使用したデータへのアクセス

- アプリケーションからの電子メール送信

- 電子メールを送信するためのOracle Application Expressの構成の概要

- アプリケーションからの電子メール送信

- コレクションの使用

- APEX_COLLECTION APIについて

- コレクションの作成

- コレクションの切捨て

- コレクションへのアクセス

- コレクションの削除

- コレクションへのメンバーの追加

- コレクション・メンバーの更新

- コレクション・メンバーの削除

- コレクション・ステータスの判別

- コレクションのマージ

- コレクションの管理

- コレクションのセッション・ステートのクリア

- APEX_ACTIVITY_LOGを使用したカスタム・アクティビティ・レポートの作成

- バックグラウンドPL/SQLの実行

- APEX_PLSQL_JOBパッケージの理解

- システム・ステータスの更新について

- プロセスを使用したバックグラウンドPL/SQLの実装

- Webサービスの実装

- Webサービス参照の理解

- SSL有効Webサービスでの作業

- WSDLに基づいたWebサービス参照の作成

- Webサービス参照リポジトリの使用

- WSDLから作成されたWebサービス参照のテスト

- 手動作成されたWebサービス参照のテスト

- Webサービスでの入力フォームとレポートの作成

- Webサービスでのフォームの作成

- プロセスとしてのWebサービスの起動

- Webサービス・プロセスの編集

- Webサービス参照履歴の表示

- フォームおよびレポートでのBLOBサポートについて

- フォームでのBLOBについて

- レポートでのBLOBサポートについて

- 手続き的なBLOBの使用

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

- アプリケーションの翻訳およびグローバリゼーション・サポートについて

- 言語の指定について

- アプリケーション・ビルダーで構築したアプリケーションの翻訳ルール

- 翻訳済アプリケーションのレンダリング方法

- 翻訳可能なコンポーネントについて

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

- アイテムの書式マスクの使用

- マルチバイト言語用のアプリケーション翻訳

- 翻訳プロセスの理解

- ステップ1: ターゲット言語のマップ

- ステップ2: 翻訳ファイルへのテキストのシードおよびエクスポート

- ステップ3: XLIFFファイルの翻訳

- ステップ4: 翻訳済XLIFFドキュメントのアップロードおよび適用とアプリケーションの公開

- 翻訳の手動編集

- メッセージの翻訳

- PL/SQLプロシージャで使用されるメッセージの翻訳

- Oracle Application Expressにより内部使用されるメッセージの翻訳

- LOVをサポートするデータの翻訳

- 動的翻訳の定義

- APEX_LANG.LANG API

- サポートされるグローバリゼーション・コードについて

A 使用可能な条件

- アプリケーション・ビルダーでの条件

B PUBLICに付与された権限

- パッケージ

- プロシージャ

- ファンクション

- 表

- ビュー

索引

はじめに

Oracle Application Expressアプリケーション・ビルダー・ユーザーズ・ガイドでは、Oracle Application Express開発環境を使用して、データベース集中型のWebアプリケーションを構築およびデプロイする方法について説明します。Oracle Application Expressは、複数のワークグループが別々のデータベースで実行しているように、それらのワークスペースでアプリケーションを構築し、それらにアクセスできるようにすることで、単一のOracle Databaseを共有サービスにします。

内容は次のとおりです。

- トピック概要

- 対象読者

- ドキュメントのアクセシビリティについて

- 関連ドキュメント

- 表記規則

トピック概要

このマニュアルは、次の章で構成されています。

タイトル

説明

Oracle Application Expressの新機能

Oracle Application Expressのこのリリースから使用可能になった新しい機能を説明します。

クイック・スタート

Oracle Application Expressの使用方法を短時間で理解できます。

デモンストレーション・アプリケーションの実行

アプリケーション・ビルダーとともにインストールされるデモンストレーション・アプリケーションを実行および変更する方法を説明します。

アプリケーション・ビルダーの概念

アプリケーション・ビルダーの基本概念を説明します。アプリケーション・ビルダーを使用すると、表やプロシージャなどのデータベース・オブジェクトの外観としてHTMLインタフェース(またはアプリケーション)を構築できます。

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

動的にレンダリングされたアプリケーションを構築するためのアプリケーション・ビルダーの使用に関する重要なバックグラウンド情報を説明します。

アプリケーション・ページの操作

アプリケーション内でページを作成して管理する方法について、重要なバックグラウンド情報を説明します。

アプリケーションの構築

アプリケーションおよびアプリケーション・コンポーネントを構築するためのアプリケーション・ビルダーの使用方法を説明します。

アプリケーション・コンポーネントの追加

アプリケーション・ビルダーを使用してアプリケーションおよびアプリケーション・コンポーネントを構築する方法について説明します。アプリケーションの作成手順、ページの追加手順、およびコンポーネント(レポート、チャートまたはフォーム)、ページ・コントロール(ボタン、アイテムまたはLOV)および共有コンポーネント(ブレッドクラム、リストまたはタブ)の追加手順について説明します。

ナビゲーションの追加

ナビゲーション・バー・エントリ、タブ、ブレッドクラム、リスト、ツリーなど、様々なタイプのナビゲーション・コントロールを使用して、アプリケーションにナビゲーションを実装する方法を説明します。

ページ・レイアウトの制御

リージョンのカスタマイズ、アイテム属性の編集およびイメージの組込みによって、アプリケーションのページ・レイアウトをカスタマイズする様々な方法について説明します。

テーマおよびテンプレートの管理

テーマおよびテンプレートを使用して、アプリケーションのユーザー・インタフェースおよびページ・レイアウトを変更する様々な方法について説明します。

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

ユーザー・インタフェースのデフォルト値を使用して、表、列またはビューにデフォルトのユーザー・インタフェースのプロパティを割り当てる方法を説明します。

アプリケーションのデバッグ

デバッグ・モードの表示、SQLトレースの有効化、ページ・レポートの表示など、アプリケーション・ビルダー・アプリケーションの様々なデバッグ方法を説明し、コントロールまたはコンポーネントを手動で削除して問題を特定する方法を説明します。

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

クロスサイト・スクリプティング保護、セッション・ステート保護、認証および認可を使用してアプリケーション・ビルダー・アプリケーションに対するセキュリティを提供する方法を説明します。

アプリケーションのデプロイ

アプリケーション・ビルダーで構築されたアプリケーションをパッケージする方法について説明します。

高度なプログラミング手法

データベース・リンクの確立、コレクションの使用、バックグラウンドSQLの実行、Webサービスの使用、ユーザー・プリファレンスの管理など、高度なプログラミング手法について説明します。

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

アプリケーション・ビルダーで構築されたアプリケーションを翻訳する方法について説明します。

対象読者

Oracle Application Expressアプリケーション・ビルダー・ユーザーズ・ガイドは、Oracle Application Expressを使用してデータベース集中型のWebアプリケーションを構築するアプリケーション開発者を対象としています。このガイドでは、Oracle Application Express開発環境を使用してアプリケーションを構築、デバッグ、管理およびデプロイする方法について説明します。

このガイドを使用するには、リレーショナル・データベースの概念、およびOracle Application Expressを実行するオペレーティング・システム環境について理解しておく必要があります。

関連項目:
Oracle Database Application Express 2日で開発者ガイド

ドキュメントのアクセシビリティについて

Oracleのアクセシビリティについての詳細情報は、Oracle Accessibility ProgramのWeb サイト(http://www.oracle.com/pls/topic/lookup?ctx=acc&id=docacc)を参照してください。

Oracle Supportへのアクセス

Oracleサポート・サービスでは、My Oracle Supportを通して電子支援サービスを提供しています。詳細情報は(http://www.oracle.com/pls/topic/lookup?ctx=acc&id=info)か、聴覚に障害のあるお客様は(http://www.oracle.com/pls/topic/lookup?ctx=acc&id=trs)を参照してください。

関連ドキュメント

詳細は、次のOracleドキュメントを参照してください。

- 『Oracle Application Expressリリース・ノート』

- 『Oracle Application Expressインストレーション・ガイド』

- Oracle Database Application Express 2日で開発者ガイド

- 『Oracle Application Express管理ガイド』

- Oracle Application Express SQLワークショップおよびユーティリティ・ガイド

- 『Oracle Application Express APIリファレンス』

- Oracle Application Expressアプリケーション移行ガイド

- Oracle Application Expressアドバンスト・チュートリアル

- 『Oracle Database概要』

- Oracle Databaseアドバンスト・アプリケーション開発者ガイド

- 『Oracle Database管理者ガイド』

- 『Oracle Database SQL言語リファレンス』

- 『SQL*Plusユーザーズ・ガイドおよびリファレンス』

Oracle Technology Network (OTN)で入手できる追加のドキュメントについては、次のOracle Application ExpressのWebサイトにアクセスしてください。

http://www.oracle.com/technetwork/developer-tools/apex/overview/index.html

追加のアプリケーション例については、Learning Libraryにアクセスしてください。Oracle by Example (OBE)、デモ、チュートリアルなど、無料のオンライン・トレーニング・コンテンツを検索します。Oracle Learning Libraryには、次のURLでアクセスできます。

http://www.oracle.com/technetwork/tutorials/index.html

印刷されたマニュアルは次のURLのOracle Storeで入手できます。

http://shop.oracle.com/

すでにOTNのユーザー名およびパスワードを取得している場合は、次のURLでOTN Webサイトのドキュメントのセクションに直接接続できます。

http://www.oracle.com/technetwork/indexes/documentation/index.html

表記規則

このマニュアルでは次の表記規則を使用します。

規則

意味

太字

太字は、操作に関連するGraphical User Interface要素、または本文中で定義されている用語および用語集に記載されている用語を示します。

イタリック体

イタリックは、ユーザーが特定の値を指定するプレースホルダ変数を示します。

固定幅フォント

固定幅フォントは、段落内のコマンド、URL、サンプル内のコード、画面に表示されるテキスト、または入力するテキストを示します。

Oracle Application Expressの新機能

このセクションでは、Oracle Application Expressリリース3.2で使用可能な新機能について説明し、追加情報の参照先を示します。

内容は次のとおりです。

- Oracle Application Expressリリース3.2の新機能

- Oracle Application Expressリリース3.1のハイライト

Oracle Application Expressリリース3.2の新機能

Oracle Application Expressリリース3.2の新機能は、次のとおりです。

- フォームの変換。
フォームの変換では、既存のOracle Formsの設計を取得して、一部のコンポーネント(主にユーザー・インタフェース)が自動的に変換されます。その他のコンポーネント(複雑なトリガーなど)は、生成後に手動で変換する必要があります。

ネイティブHTMLへの移行はシームレスではありません。ユーザー・インタフェースを変更する場合は、Webにおける最適な対話性を実現する必要があります。このツールを使用すると、対話モード・レポートなどのOracle Application Expressの動的HTML機能を利用できます。詳細は、Oracle Application Expressアプリケーション移行ガイドを参照してください。

- セキュリティの向上。
Webアプリケーションを開発する際のセキュリティのベスト・プラクティスは、公開されるフットプリントを最小限にし、セッション・ステートの整合性を保護し、ブラウザとサーバー間で転送されるデータが損なわれないようにすることです。これらのベスト・プラクティスを実現するために、Oracle Application Expressリリース3.2はより宣言的で強力になり、セキュリティ対策が向上しています。主な拡張機能として、次のものがあります。

- セッション・ステートの宣言的な暗号化

- 最大アイドル時間および最大セッション継続期間のセッション・タイムアウトの宣言的な指定

- セッション・ステートへの保存を行わずにパスワードを入力できる新しいパスワード・アイテム・タイプの作成

公開されるフットプリントを最小限にするために設計された他の機能として、Oracle Application Expressデータベース・アカウントで要求される権限の削減、データベース監視機能のデフォルトでの無効化、管理および開発スイート・アプリケーションに管理者がHTTPSを要求できる機能があります。また、管理者は、アカウント・パスワードを作成または更新する際に特定の期間に使用されていないパスワードに制限したり、新規インストールで、サービス管理者のアカウント・パスワードが強力なパスワード・ポリシーに準拠することを要求できるようになりました。

Oracle Application Expressのドキュメントも改善され、セキュアなWebアプリケーションを構築するためのリソースが追加されました。これらの新機能は、既存のOracle Application Expressのセキュリティ機能(柔軟な認証、認可スキーム、URL改ざんからの保護など)を補うものです。詳細は、「アプリケーション・セキュリティの管理」を参照してください。

Oracle Application Expressリリース3.1のハイライト

Oracle Application Expressリリース3.1の新機能は、次のとおりです。

- 対話モード・レポート・リージョン。
対話モード・レポート・リージョンでは、エンド・ユーザーがレポートをカスタマイズできます。ユーザーは、関心のある列の選択、フィルタの適用、ハイライト表示、ソート処理などを行って、レポート・データのレイアウトを変更できます。また、ブレーク、集計、各種チャート、ユーザー独自の計算などを定義することもできます。レポートは、複数のバリエーションを作成して、名前付きレポートとして保存できます。また、カンマ区切りファイル(CSV)形式、Microsoft Excel (XLS)形式、Adobe Portable Document Format (PDF)、Microsoft Word Rich Text Format (RTF)などの各種ファイル形式にダウンロードすることもできます。詳細は、「対話モード・レポートの編集」を参照してください。

対話モード・レポートを使用するサンプル・アプリケーションの構築に関するステップごとの説明は、Oracle Application Expressアドバンスト・チュートリアルの問題追跡アプリケーションの作成およびデプロイ方法に関するセクションを参照してください。

- (オプション)ランタイムのみのインストール。
Oracle Application Expressリリース3.1では、テスト用インスタンスと本番インスタンスに対して、Oracle Application Expressのランタイム・バージョンのみをインストールする機能がサポートされています。これにより、インストールするフットプリントと権限を最小限に抑えることができます。また、既存のインスタンスに対して開発者のインタフェースを削除または追加するスクリプトも用意されています。ランタイム・インスタンスでは開発者が慎重に本番アプリケーションを更新することができないため、この新機能によってアプリケーションのセキュリティが向上します。詳細は、Oracle Application Express管理ガイドの「ランタイム環境の管理」を参照してください。

- カスタム・テーマ。
Oracle Application Expressで用意されているデフォルトのテーマに加えて、独自のカスタム・テーマを作成できます。カスタム・テーマにより、企業の要件を満たすルック・アンド・フィールを非常に細かく設計し、そのルック・アンド・フィールを他のすべてのアプリケーションで使用するテーマとしてパブリッシュすることができます。2つの新しい標準テーマも追加されました。詳細は、「テーマの管理」およびOracle Application Express管理ガイドの「Oracle Application Expressインスタンスのテーマの管理」を参照してください。

- JavaScriptライブラリのドキュメント化。
Oracle Application Expressリリース3.1には、標準のJavaScriptファイルとCSSファイルを抑制する機能が用意されています。現在は、ページのロード時間を短縮するために、含まれているJavaScriptファイルがすべて圧縮されています。また、このリリースでは、上級のOracle Application Express開発者がWeb 2.0のカスタム機能を構築して活用できるようにフレームワークが改善されているため、パフォーマンスが向上し、開発者がより動的なアプリケーション・ウィジェットを作成できます。詳細は、Oracle Application Express APIリファレンスの「JavaScript API」を参照してください。

- セキュリティの向上。
このリリースには、新しいアイテム・タイプとして「非表示で保護」が含まれています。このアイテム・タイプを使用すると、アイテムのセッション・ステートを保護する開発者のタスクが大幅に削減されます。このアイテム・タイプとその他の小さな改善点により、Oracle Application Express内のデフォルトのセキュリティ機能がより堅牢になりました。詳細は、表 6-2「使用可能なアイテム・タイプ」を参照してください。

- レポート出力の拡張。
リリース3.1では、ダウンロード形式としてXMLが含まれ、複数のSQL文がサポートされるようになりました。詳細は、「レポート・リージョンの出力」を参照してください。

- 宣言的なBLOBサポート。
宣言的なBLOBサポートにより、フォームでのファイルの宣言的なアップロード、およびレポートを使用したファイルのダウンロードや表示を行うことができます。BLOBの表示とダウンロードは、PL/SQLを使用して手続き的に作成することもできます。詳細は、「フォームおよびレポートでのBLOBサポートについて」を参照してください。

- このリリースで導入されたアプリケーション・ビルダーの改良点は次のとおりです。

- 「アプリケーション日付書式」を定義できます。

- レポートの作成時に、検索リージョンを追加できます。

- Application ExpressのメールAPIを使用して送信する電子メールに添付ファイルを含めることができるようになりました。

- アプリケーション作成時のスプレッドシートにおける以前の32Kのデータ制限がなくなりました。

- アプリケーションの作成ウィザードでマスター・ディテール・レポートが作成できるようになりました。

- マスター・ディテール・レポートの実装機能が向上および改良されました。

- 宣言的なメディア・タイプのサポートにより、text/html以外のタイプのページを生成できます。

- ブランチ処理中に使用される簡略化されたURL。
今回のリリースでは、ページの送信に使用されるデータベース・セッションと同じセッションで、ブランチの直前に、キャッシュのクリアおよびセッション・ステートの設定アクションを実行できます。これによって、アプリケーションのURLに表示される情報が少なくなります。この拡張によって、URLが改ざんされにくくなり、アイテム名、値、プログラム・ロジックの表示を減らすことで、セキュリティが向上します。また、URLのエンコーディングおよびキャラクタ・セットの問題が減少します。

この機能を使用するには、ブランチの編集ページで、またはブランチの作成ウィザードで新しいブランチを作成する際に、「ブランチ処理の前にステートを保存」チェック・ボックスを選択します。「ブランチを使用したナビゲーションの制御」を参照してください。

1 クイック・スタート

このセクションでは、Oracle Application Expressの使用方法の概要を説明します。インストール処理が完了していることを前提としています。

この項には、次の項目が含まれます。

- Oracle Application Expressの概要

- Oracle Application Expressアーキテクチャについて

- Application Expressユーザー・ロールの理解

- Oracle Application Expressへのログイン

- ワークスペースのホームページについて

- ナビゲーションの選択肢

- オンライン・ヘルプの使用

関連項目:
Oracle Database Application Express 2日で開発者ガイド

Oracle Application Expressの概要

Oracle Application Expressは、データベース集中型のWebアプリケーションを開発およびデプロイするためのホスティングされた宣言型の開発環境です。ユーザー・インタフェースのテーマ、ナビゲーション・コントロール、フォーム・ハンドラ、柔軟性が高いレポートなどの組込み機能を使用して、アプリケーション開発プロセスを短縮できます。

Application Expressエンジンは、データベース表に格納されたデータから、リアルタイムでアプリケーションをレンダリングします。アプリケーションを作成または拡張すると、Oracle Application Expressはメタデータを作成するか、またはデータベース表に格納されたメタデータを変更します。アプリケーションの実行時に、Application Expressエンジンは、メタデータを読み込み、アプリケーションを表示します。

アプリケーションでのステートフルな動作を提供するため、Oracle Application Expressはデータベースのセッション・ステートを透過的に管理します。アプリケーション開発者は、標準的なSQLバインド変数構文および単純な置換処理によって、セッション・ステートを取得および設定できます。

次のセクションで、Oracle Application Expressの主な機能を説明します。

レポート作成

Oracle Application Expressを使用して、SQL問合せの結果を表示するHTMLレポートを迅速に生成できます。また、HTML、Adobe Portable Document Format (PDF)、Microsoft Word Rich Text Format (RTF)、Microsoft Excel (XLS)形式またはXMLでレポートをダウンロードおよび出力できます。

複数のレポートを宣言的にリンクさせてドリルダウン・レポートを作成したり、バインド変数を使用してセッション・ステートからレポートに情報を渡すことも可能です。レポートでは、宣言的な列ヘッダーのソート、コントロール・ブレーク、合計、ページ区切りなどがサポートされます。レポートのソートおよびページ区切りには、部分ページ・リフレッシュ(PPR)のテクノロジを使用できるため、ページ全体をリフレッシュせずに済みます。宣言的なリンクをレポートに追加して、レポート・データをCSVまたはXML形式にダウンロードできます。さらに、テンプレートを使用して、レポートの表示形式をカスタマイズできます。「バインド変数構文について」および「レポートの作成」を参照してください。

対話モード・レポート・リージョンでは、エンド・ユーザーがレポートをカスタマイズできます。ユーザーは、関心のある列の選択、フィルタの適用、ハイライト表示、ソート処理などを行って、レポート・データのレイアウトを変更できます。また、ブレーク、集計、各種チャート、ユーザー独自の計算などを定義することもできます。ユーザーは、レポートの複数のバリエーションを作成したり、名前付きのレポートとして保存したり、カンマ区切りファイルに出力したり、PDFドキュメントに出力したりできます。「対話モード・レポートの編集」を参照してください。

フォーム

ウィザードを使用して、表または格納されたプロシージャについてのフォームを簡単に作成できます。たとえば、表に関するフォームを作成する場合、これらのウィザードでは挿入、更新、削除の自動管理に加え、失われた更新の検出も可能です。フォームを作成した後も、必要なレイアウトを即座に実現できるビジュアル表示を使用して、フォーム・フィールド(フォーム・アイテムと呼ばれる)を再調整できます。フォーム・アイテムとして、テキスト・フィールド、テキスト領域、ラジオ・グループ、選択リスト、チェック・ボックス、日付ピッカーおよびポップアップの値リストなどを含む、各種表示オプションが提供されます。「フォームの作成」を参照してください。

チャート作成

ウィザードを使用して、HTML、SVGまたはFlash形式のチャートを作成できます。あるチャートから別のチャートまたはレポートにドリルダウンするチャートを作成することも可能です。また、部分ページ・リフレッシュ(PPR)テクノロジを使用してリフレッシュできるため、ページ全体をリフレッシュせずに済みます。指定の間隔でチャートがリフレッシュされるように構成することもできます。さらに、レポート列テンプレートを使用して、単純なHTMLの棒グラフを任意のレポートに追加することも可能です。「チャートの作成」を参照してください。

スプレッドシートのアップロード

スプレッドシートからアプリケーションの作成ウィザードを使用して、スプレッドシート・データをデータベースに迅速にアップロードできます。データを新規データベース表に格納するか、あるいは既存のデータベース表に追加するかを選択できます。データがアップロードされると、簡単にアプリケーションを作成できます。このウィザードでは、数回のクリックでスプレッドシートから共有アプリケーションを作成できます。「スプレッドシートからのアプリケーションの作成ウィザード」を参照してください。

セッション・ステート管理

Oracle Application Expressは、データベースのセッション・ステート(またはアプリケーション・コンテキスト)を透過的に管理します。フォームでは、セッション・ステートが自動的に保存され、現行セッションのアプリケーション・コンテキストが記憶されます。SQLおよびPL/SQLでのセッション・ステートの参照は、バインド変数の使用と同様に簡単です。次のSELECT文を例にとります。

SELECT * FROM EMP WHERE EMPNO = :P1_ID

この例では、問合せの実行時にアイテムP1_IDの値が自動的にバインドされます。また、アイテム名をアンパサンド(&)で始めて、ピリオド(.)で終わると、静的コンテキストのセッション・ステートを参照できます。

&P1_NAME.

2つのディメンション・データ・セットの管理に対して、Oracle Application Expressは強力な収集インフラストラクチャを提供します。とりわけ、セッション管理はステートレスであり、メモリーを消費しません。詳細は、「セッション・ステート値の管理」および「バインド変数構文について」を参照してください。

ユーザー・インタフェースのテーマ

Oracle Application Expressでは、アプリケーション・ロジックから表示機能(またはユーザー・インタフェースのテーマ)が切り離されています。1つのテーマでのアプリケーションの設計、指定した別のテーマへの変更、独自のカスタム・テーマの作成および使用が可能です。(問合せ、プロセス、ブランチなどの)アプリケーション・ロジックをHTMLレンダリングから分離することで、アプリケーションをリライトせずに、新しい設計および他のテクノロジを使用できます。「テーマの管理」を参照してください。

フロー制御およびナビゲーション

すべてのWebアプリケーションにはナビゲーションが必要であり、動的アプリケーションにはフロー制御が必要です。Oracle Application Expressは、ナビゲーション・コントロールの開発および管理を単純化するための組込みコンポーネントを提供します。ナビゲーションは、宣言的なタブ(1つまたは2つのレベル)、ブレッドクラム、ツリー・コントロール、リンクのリストなどを使用して制御されます。フロー制御は、指定のイベントや特定の条件で有効になる宣言的なブランチを使用して実行されます。ナビゲーション・コントロールの表示はテンプレートで管理されており、簡単に表示形式を変更できます。詳細は、「ナビゲーションの追加」および「ブランチを使用したナビゲーションの制御」を参照してください。

すべてのコンポーネントの条件付け

動的Webアプリケーションを作成する場合、多数のアプリケーション・コンポーネントおよびプロセスに条件が設定されます。つまり、アプリケーション・コンテキスト、データ、イベントまたは権限に基づいた様々な情報が表示または処理されるのみです。Oracle Application Expressを使用すれば、すべてのコンポーネントの条件を宣言的に指定できます。これにより、タブ、ボタン、アイテム、リスト・エントリなどの表示を正確に管理できます。詳細は、「条件付きのレンダリングおよびプロセス」を参照してください。

外部インタフェースおよび拡張性

Oracle Application Expressは、アプリケーション構築のための強力な宣言的開発環境を提供していますが、カスタム・インタフェースまたはコントロールを開発することも可能です。たとえば、コンポーネントが現行環境のニーズにあわない場合、PL/SQLを使用して独自のカスタムHTMLを生成できます。(「カスタムPL/SQLを使用したHTMLのレンダリング」を参照。)また、Webサービスを使用して、外部サービスをコールすることもできます。(「Webサービスの実装」を参照。)Oracle Application Expressには、電子メール・アラートをアプリケーションに簡単に統合できるAPIも含まれています。(「アプリケーションからの電子メールの送信」を参照。)さらに、Oracle Application ExpressはOracle Database上で実行されるため、外部表、PL/SQL、データベース・リンク、ゲートウェイ、データベースJavaなどのデータベース固有の機能を使用して、アプリケーションの機能を拡張できます。

セキュリティ

Oracle Application Expressを使用すれば、ユーザー・ログインの不要なパブリック・アプリケーションや、認証が必要なセキュア・アプリケーションの作成が可能です。Oracle Application Expressは、シングル・サインオン、データベース・アカウント資格証明、簡単に使用できるユーザー管理システムなどの様々な組込み認証スキームを提供します。Microsoft Active DirectoryおよびOracle Applicationsを含む、任意の認証サービスに関するカスタム・スキームも使用できます。

さらに、使用環境のニーズに応じて認可をカスタマイズし、アプリケーション全体、またはページ、ページ・コンポーネントに対して個別に認可を適用できます。また、URLの不正な変更を防止するためのセッション・ステートの革新的な保護機能や、SQLインジェクションおよびクロスサイト・スクリプティング(XSS)攻撃からアプリケーションを保護するための組込み機能も使用できます。詳細は、「アプリケーション・セキュリティの管理」を参照してください。

SQLワークショップのツール

SQLワークショップの提供するツールにより、Webブラウザからデータベース・オブジェクトを表示および管理できます。SQL文およびPL/SQL文を実行するには、SQLコマンドを使用します。詳細は、Oracle Application Express SQLワークショップおよびユーティリティ・ガイドの「SQLコマンドの使用」を参照してください。

クエリー・ビルダーでは、表のドラッグ・アンド・ドロップにより問合せを定義したり、オブジェクト間の関係を簡単に作成することが可能です。詳細は、Oracle Application Express SQLワークショップおよびユーティリティ・ガイドの「クエリー・ビルダーを使用した問合せの構築」を参照してください。

オブジェクト・ブラウザでは、データベース・オブジェクトの表示、作成、変更、参照および削除を簡単に実行できるGUIが提供されます。詳細は、Oracle Application Express SQLワークショップおよびユーティリティ・ガイドの「オブジェクト・ブラウザを使用したデータベース・オブジェクトの管理」を参照してください。

また、SQLスクリプトを使用して、スクリプト・ファイルの作成、編集、表示、実行および削除が可能です。詳細は、Oracle Application Express SQLワークショップおよびユーティリティ・ガイドの「SQLスクリプトの使用」を参照してください。

「サポートするオブジェクト」ユーティリティ

パッケージ・アプリケーションを作成すると、別のOracle Application Expressインスタンスのエクスポート、インストール、アップグレードおよび削除に必要なステップを単純化できます。「サポートするオブジェクト」ユーティリティを使用すると、アプリケーション定義を、データベース・オブジェクト、シード・データ、イメージ、カスケード・スタイルシートおよびJavaScriptを作成するスクリプトにバンドルできます。

パッケージ・アプリケーションを作成すると、インストールに類似した操作がアプリケーション・ユーザーに提供され、別の開発、テストまたは本番インスタンスへのアプリケーションのインポートおよびインストールのプロセスが自動的に実行されます。「パッケージ・アプリケーションの作成方法」を参照してください。

パフォーマンス

Oracle Application Expressは、アプリケーション開発者およびアプリケーション・ユーザーにきわめて高いレベルのパフォーマンスを提供します。Oracle Application ExpressはOracle Database上で実行されるため、ネットワーク通信量に与える影響が最小限で済みます。さらに、アプリケーション・ビルダーには多数の監視レポートが含まれており、アプリケーション・パフォーマンスの識別およびチューニングが可能です。詳細は、「アプリケーションのデバッグ」を参照してください。

ホスティング環境

Oracle Application Expressによって、単一のデータベースで多数のユーザーをホスティングできます。ユーザーは、ワークスペースと呼ばれる専用のワークスペースで作業します。ワークスペースは、オブジェクト、データ、およびアプリケーションをプライベートに保持しながら、同一のOracle Application Expressのインストール内で複数のユーザーが作業可能な仮想プライベート・データベースです。この柔軟なアーキテクチャによって、単一のデータベース・インスタンスで何千ものアプリケーションを管理できます。

ワークスペースを割り当てる(または作成する)プロセスの動作を決定します。たとえば、電子メールの検証割当てモードでは、ログイン・ページのリンクを使用してユーザーがワークスペースをリクエストします。ワークスペースのリクエストが承認されると、電子メール・アドレスが正しいことを検証するためのリンクを電子メールで受信します。このリンクをクリックすると、ログイン資格証明を電子メールで受信します。電子メールの検証割当てモードの例を参照するには、次のリンクに移動します。

http://apex.oracle.com

詳細は、「Oracle Application Express環境の構成」およびOracle Application Express管理ガイドの「Oracle Application Expressのホスティングされたインスタンス管理」を参照してください。

Oracle Application Expressアーキテクチャについて

Oracle Application Expressは、Oracle Databaseを使用してインストールされ、表内のデータとPL/SQLコードで構成されます。

Oracle Application Expressの開発環境を実行していても、Oracle Application Expressを使用して構築したアプリケーションを実行していても、プロセスは同じです。ブラウザにより適切なOracle Application Express PL/SQLコールに翻訳されるURLリクエストが送信されます。データベースでPL/SQLが処理されたら、結果がHTMLとしてブラウザに中継されます。このサイクルはページをリクエストまたは送信するたびに発生します。

アプリケーションのセッション・ステートはApplication Express内のデータベース表で管理されます。専用のデータベース接続は使用しません。かわりに、各リクエストはCPUリソースの消費が最小である新規データベース・セッションを介して作成されます。

Oracle HTTP Server (Apache)および埋込みPL/SQLゲートウェイについて

使用するOracle Databaseのバージョンによって、URLの変換方法は異なります。

- Oracle Database 11.1より前のバージョンでは、mod_plsqlを使用したOracle HTTP Server (Apache)が要求されます。次の図はその3層のアーキテクチャを示しています。

- Oracle Database 11.1以上のバージョンまたはOracle Database 10g Express Editionを使用している場合、Oracle HTTP Serverおよびmod_plsqlをアーキテクチャから削除して、埋込みPL/SQLゲートウェイに置き換えることができます。次の図は、埋込みPL/SQLゲートウェイを使用した2層のアーキテクチャを示しています。

埋込みPL/SQLゲートウェイは動的なアプリケーションを作成するためのOracleデータベースにWebサーバーおよび必要なインフラストラクチャを提供します。埋込みPL/SQLゲートウェイはOracle DatabaseのXMLデータベースHTTP Serverで実行され、mod_plsqlの主要機能を持っていますが、Apacheによって稼働するOracle HTTP Serverを必要としません。埋込みPL/SQLゲートウェイを使用すると、アーキテクチャは簡略化され、中間層はすべて削除されます。

Application Expressエンジンについて

Application Expressエンジンは、ページをレンダリングし処理します。また、次のタスクも実行します。

- セッション・ステート管理

- 認証サービス

- 認可サービス

- ページ・フロー制御

- 検証処理

Oracle Application Expressの様々な環境

Oracle Application Expressをインストールする際には、2つの異なる環境をインストールできます。

- ランタイム環境は、本番実装に適しています。この環境では、ユーザーはアプリケーションを実行できますが、アプリケーションの変更はできません。

- 完全開発環境では、このドキュメントで説明しているように、アプリケーションを開発するためにアプリケーション・ビルダー環境への完全なアクセスを提供します。

関連項目:
『Oracle Application Expressインストレーション・ガイド』

Application Expressユーザー・ロールの理解

Oracle Application Express開発環境にアクセスするには、ユーザーはワークスペースという作業用の共有領域にログインします。ユーザーは、次の4つの主なロールに分類されます。

- 開発者: アプリケーションを作成および編集するユーザー

- ワークスペース管理者: ユーザー・アカウントの管理、ワークスペース・アクティビティの監視、ログ・ファイルの表示など、ワークスペース固有の管理タスクを実行するユーザー

- エンド・ユーザー: 開発権限を持たず、外部認証スキームを使用しないアプリケーションにのみアクセス可能。

- Oracle Application Express管理者: Oracle Application Express管理サービス・アプリケーションを使用して、ホスティングされたインスタンス全体を管理するスーパーユーザー

関連項目:
『Oracle Application Express管理ガイド』

Oracle Application Expressへのログイン

Oracle Application Expressへログインするときは、ワークスペースにログインします。ワークスペースは、Oracle Application Express開発環境内の領域で、開発者がアプリケーションを作成できます。

Oracle Application Expressへのログイン方法は、開発環境を構成したかどうかによって決まります。

- Oracle Application Expressを最近インストールした場合は、開発環境を構成する必要があります。

- 以前に構成した開発環境に開発者がログインする場合は、管理者がその開発者にワークスペースへのアクセス権を付与する必要があります。

この項に含まれる内容は次のとおりです。

- ブラウザ要件について

- Oracle Application Express環境の構成

- 開発者としてのOracle Application Expressへのログイン

ブラウザ要件について

Oracle Application Expressのホームページはブラウザでオープンできます。Oracle Application Expressアプリケーションを表示または開発するには、WebブラウザでJava Script、およびHTML 4.0とCSS 1.0標準がサポートされている必要があります。Cookieが有効になっていることも確認します。この要件を満たすブラウザは次のとおりです。

- Microsoft Internet Explorer 6.0以上

- Mozilla Firefox 1.0以上

Oracle Application Express環境の構成

Oracle Application Expressの設定方法は、ユーザー・ロールに応じて異なります。ホスティングされた開発環境にアクセスする開発者の場合、管理者によってワークスペースへのアクセス権を付与される必要があります。Oracle Application Express管理者の場合は、次のステップを実行する必要があります。

1. Oracle Application Express管理サービスにログインします。Oracle Application Express管理サービスは、Oracle Application Expressインスタンス全体を管理するための独立したアプリケーションです。ログインするには、インストール・プロセス中に作成または再設定したADMINアカウントおよびパスワードを使用します。

1. Webブラウザで、Oracle Application Express管理サービス・アプリケーションにナビゲートします。デフォルトでは、Oracle Application Express管理サービス・アプリケーションは次の場所にインストールされます。

- 設定に埋込みPL/SQLゲートウェイを使用する場合は、次へ移動します。

http://hostname:port/apex/apex_admin

説明:

hostnameは、Oracle XML DB HTTP Serverがインストールされているシステムの名前です。

portは、Oracle XML DB HTTP Serverに割り当てられているポート番号です。デフォルトのインストールでは、この番号は8080です。

apexは、構成ファイルで定義されているデータベース・アクセス記述子(DAD)です。

- 設定でApacheおよびmod_plsqlを使用する場合は、次のURLに移動します。

http://hostname:port/pls/apex/apex_admin

説明:

hostnameは、Oracle HTTP Serverがインストールされているシステムの名前です。

portは、Oracle HTTP Serverに割り当てられているポート番号です。デフォルトのインストールでは、この番号は7777です。

plsは、mod_plsqlカートリッジを使用するためのインジケータです。

apexは、mod_plsql構成ファイルで定義されているデータベース・アクセス記述子(DAD)です。

2. 「ログイン」ページで、次の操作を行います。

- 「ユーザー名」に、adminと入力します。

- 「パスワード」に、Oracle Application Expressのインストール時に指定したOracle Application Express管理者アカウントのパスワードを入力します。

- 「ログイン」をクリックします。

関連項目:
詳細は、『Oracle Application Express管理ガイド』の「Oracle Application Express管理サービスへのログイン」を参照してください。

2. 割当てモードの指定。Oracle Application Express管理サービスでは、ワークスペースの作成(または割当て)プロセスの仕組みを決定する必要があります。詳細は、Oracle Application Express管理ガイドの「ワークスペースの割当てについて」を参照してください。

3. ワークスペースの作成。ワークスペースは複数のユーザーがプライベートにオブジェクト、データ、アプリケーションを保持していても、同じOracle Application express内で作業できる仮想プライベート・データベースです。各ワークスペースには、一意のIDおよび名前が含まれます。Oracle Application Express管理者は手動でワークスペースを作成することも、ユーザーにリクエストを送信させることもできます。詳細は、Oracle Application Express管理ガイドの「ワークスペースの作成」および「ワークスペース・リクエストの管理」を参照してください。

4. ワークスペースへのログイン。Oracle Application Express管理サービスでワークスペースを作成した後、Oracle Application Expressのログイン・ページに戻って、ワークスペースにログインします。詳細は、「開発者としてのOracle Application Expressへのログイン」を参照してください。

開発者としてのOracle Application Expressへのログイン

Oracle Application Expressへログインするときは、ワークスペースにログインします。開発者の場合は、ワークスペースへのアクセス権を管理者から付与される必要があります。

注意:
ユーザーがワークスペースをリクエストしたり、パスワードを変更するには、Oracle Application Express管理者がOracle Application Expressの環境プリファレンスを構成する必要があります。

関連項目:
Oracle Application Express管理ガイドの「環境設定の管理」

この項に含まれる内容は次のとおりです。

- ワークスペースのリクエスト

- ワークスペースへのログイン

- ワークスペース名の検索

- パスワードの再設定

- ワークスペースのログアウト

ワークスペースのリクエスト

注意:
このセクションは、Oracle Application Express管理者が、ワークスペースのリクエストをサポートするためにOracle Application Expressを構成済である場合にのみ適用されます。

関連項目:
『Oracle Application Express管理ガイド』

Oracle Application Expressへログインする前に、管理者からワークスペースへのアクセス権を付与される必要があります。各ワークスペースには、一意のIDおよび名前が含まれます。

ワークスペースをリクエストするには、次のステップを実行します。

1. Webブラウザで、Oracle Application Expressの「ログイン」ページにナビゲートします。
Application ExpressにログインするURLを知らない場合は、「ワークスペースへのログイン」を参照してください。

「ログイン」ページが表示されます。

2. 「タスク」で、「ワークスペースのリクエスト」をクリックします。
サービスのリクエスト・ウィザードが表示されます。

3. 「次へ」をクリックし、画面に表示されるステップに従います。

関連項目:
Oracle Application Express管理ガイドの「ワークスペースの作成」

ワークスペースへのログイン

ワークスペースのリクエストがOracle Application Express管理者に承認されると、ログイン資格証明(ワークスペース名、ユーザー名およびパスワード)を含む電子メールが送信されます。

管理者が新規ワークスペース・リクエストの処理の自動メソッドとして電子メールの検証を選択した場合、検証リンクを含む電子メールを最初に受信する可能性があることに注意してください。このステップにより、ワークスペース・リクエストが承認される前に、その電子メールが有効になります。

関連項目:
『Oracle Application Express管理ガイド』

Oracle Application Expressにログインするには、次のステップを実行します。

1. Webブラウザで、Oracle Application Expressの「ログイン」ページにナビゲートします。デフォルトでは、Oracle Application Expressは次の場所にインストールされます。

- 設定に埋込みPL/SQLゲートウェイを使用する場合は、次へ移動します。

http://hostname:port/apex

説明:

- hostnameは、Oracle XML DB HTTP Serverがインストールされているシステムの名前です。

- portは、Oracle XML DB HTTP Serverに割り当てられているポート番号です。デフォルトのインストールでは、この番号は8080です。「Oracle XML DB HTTPサーバー・ポートの検証」を参照してください。

- apexは、構成ファイルで定義されているデータベース・アクセス記述子(DAD)です。
以前のリリースからアップグレードしたユーザー、またはカスタム構成を行っているユーザーの場合、この値にhtmldbやそれ以外の値が設定されている場合があります。Oracle Application Express管理者にDADの値を確認してください。

- 設定でOracle HTTP Server(Apache)およびmod_plsqlを使用する場合は、次のURLに移動します。

http://hostname:port/pls/apex

説明:

- hostnameは、Oracle HTTP Serverがインストールされているシステムの名前です。

- portは、Oracle HTTP Serverに割り当てられているポート番号です。デフォルトのインストールでは、この番号は7777です。Oracle HTTP Serverのインストール時のポート番号に関する情報は、次のファイルのいずれかで参照できます。

ORACLE_BASE\ORACLE_HOME\install\portlist.ini
ORACLE_BASE\ORACLE_HTTPSERVER_HOME\Apache\Apache\conf\httpd.conf

ポート番号を変更しても、portlist.iniファイルは更新されないことに注意してください。このファイルはインストール直後のみ参照可能です。

- plsは、mod_plsqlカートリッジを使用するためのインジケータです。

- apexは、mod_plsql構成ファイルで定義されているデータベース・アクセス記述子(DAD)です。
以前のリリースからアップグレードしたユーザー、またはカスタム構成を行っているユーザーの場合、この値にhtmldbやそれ以外の値が設定されている場合があります。Oracle Application Express管理者にDADの値を確認してください。

関連項目:
データベース・アクセス記述子の詳細は、Oracle Databaseインストレーション・ガイドのOracle Databaseのポート番号の管理に関するセクションおよびORACLE_BASE\ORACLE_HTTPSERVER_HOME\Apache\modplsql\conf\dads.readmeを参照してください。

「ログイン」ページが表示されます。

2. 「ログイン」で、次の項目を入力します。

- 「ワークスペース」フィールドに、ワークスペース名を入力します。

- 「ユーザー名」フィールドに、ユーザー名を入力します。

- 「パスワード」フィールドに、パスワードを大/小文字を区別して入力します。

3. 「ログイン」をクリックします。
設定によっては、初めてログインするときにパスワードの変更を要求される場合があります。

Oracle XML DB HTTP Serverポートの検証

Oracle XML DB HTTP Serverが実行されているポート番号を検証するには、次のステップを実行します。

1. SQL*Plusを起動して、SYSとしてOracle Application Expressがインストールされているデータベースに接続します。

- Windowsの場合:

SYSTEM_DRIVE:\ sqlplus /nolog
connect sys as sysdba

- UNIXおよびLinuxの場合:

$ sqlplus /nolog
connect sys as sysdba

プロンプトが表示されたら、適切なユーザー名とパスワードを入力します。

2. 次の文を入力して、ポート番号を検証します。

SELECT DBMS_XDB.GETHTTPPORT FROM DUAL;

ポート番号が0を返したら、Oracle XML DB HTTP Serverが無効になっています。

関連項目:
Oracle XML DB HTTP Serverを有効にする方法については、Oracle Databaseインストレーション・ガイドを参照してください。

ワークスペース名の検索

ワークスペース名を忘れた場合は、電子メール・アドレスに関連付けられているすべてのワークスペース名のリストをリクエストできます。

表領域名を検索するには、次のステップを実行します。

1. ログイン・ページで、「タスク」リストの「ワークスペースの検索」をクリックします。

2. 電子メール・アドレスを入力して、「ワークスペースを検索」をクリックします。
ワークスペース名のリストが電子メールで送信されます。

パスワードの再設定

ワークスペースのホームページにある「パスワードの変更」リンクをクリックすると、パスワードを再設定できます。

ワークスペースのホームページからパスワードを再設定するには、次のステップを実行します。

1. Oracle Application Expressにログインします。詳細は、「Oracle Application Expressへのログイン」を参照してください。

2. 「管理」リストで、「パスワードの変更」をクリックします。
パスワードの変更ページが表示されます。

3. 「パスワードの変更」で、次のように入力します。

- 現行のパスワードの入力: 現在のパスワードを入力します。

- 新規パスワードの入力: 新規パスワードを入力します。

- 新規パスワードの確認: 新規パスワードを再度入力します。

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

ヒント:
また、ログイン・ページでも「パスワードの再設定」リンクをクリックしてパスワードを再設定することができます。

関連項目:
Oracle Application Express管理ガイドの「エンド・ユーザー・パスワードの変更」

ワークスペースのログアウト

Oracle Application Expressからログアウトするには、ウィンドウの右上隅にある「ログアウト」アイコンをクリックします。

「ワークスペース」ホームページについて

Oracle Application Expressにログインすると、「ワークスペース」ホームページが表示されます。ワークスペースは、複数のユーザーが、各自のオブジェクト、データおよびアプリケーションをそれぞれに保持しながら、同じOracle Application Expressインストール内で作業できる、仮想プライベート・データベースです。

ログインしたユーザーの名前とワークスペース名がページ左下に表示されます。次の3つの大きいアイコンがページの中央に表示されます。

- 「アプリケーション・ビルダー」。アプリケーション・ビルダーを使用すると、表やプロシージャなどのデータベース・オブジェクトの外観としてHTMLインタフェース(またはアプリケーション)を構築できます。詳細は、「アプリケーション・ビルダーの概念」および「アプリケーション・ビルダーの使用」を参照してください。

- 「SQLワークショップ」。SQLワークショップを使用すると、データベース・オブジェクトを表示および管理するためのツールにアクセスできます。「SQLワークショップ」をクリックして、次のデータベース・ツールにアクセスします。

- オブジェクト・ブラウザ: データベース・オブジェクトの表示、作成、変更、参照および削除を行います。エラー・レポートを利用してパッケージ、プロシージャ、ファンクションおよびトリガーの編集とコンパイルを行うには、PL/SQLエディタを使用します。詳細は、Oracle Application Express SQLワークショップおよびユーティリティ・ガイドの「オブジェクト・ブラウザを使用したデータベース・オブジェクトの管理」を参照してください。

- SQLコマンド: SQLコマンドおよび無名PL/SQL、スクリプトおよび保存された問合せを実行します。詳細は、Oracle Application Express SQLワークショップおよびユーティリティ・ガイドの「SQLコマンドの使用」を参照してください。

- SQLスクリプト: スクリプト・ファイルを作成、編集、表示、実行および削除するには、SQLスクリプトを使用します。ローカル・ファイル・システムでのスクリプトのアップロードおよびダウンロードも可能です。詳細は、Oracle Application Express SQLワークショップおよびユーティリティ・ガイドの「SQLスクリプトの使用」を参照してください。

- クエリー・ビルダー: クエリー・ビルダーのGUIを使用すると、SQLの知識がほとんどあるいはまったくなくても、データベース・オブジェクトの検索およびフィルタ適用、オブジェクトおよび列の選択、オブジェクト間の関係の作成、問合せ結果の書式の表示、問合せの保存を行うことができます。詳細は、Oracle Application Express SQLワークショップおよびユーティリティ・ガイドの「クエリー・ビルダーを使用した問合せの構築」を参照してください。

- ユーティリティ: データベースからのデータのロードおよびアンロード、DDLの生成、オブジェクト・レポートの表示、削除したデータベース・オブジェクトのリストア、およびデータベースの監視を行うには、ユーティリティを使用します。詳細は、Oracle Application Express SQLワークショップおよびユーティリティ・ガイドの「Oracle Application Expressユーティリティの使用」を参照してください。

管理について

ワークスペースのホームページの右側に「管理」リストが表示されます。アプリケーション開発環境を管理するには、次のリンクを使用します。

- アプリケーション管理ページへの「管理」リンク。管理タスクを実行するには、このページを使用します。詳細は、Oracle Application Express管理ガイドの「アプリケーション管理ページについて」を参照してください。

- サービスの管理ページへの「サービスの管理」リンク。セッション・ステート、ログ・ファイルおよびアプリケーション・モデルを管理するには、このページを使用します。詳細は、Oracle Application Express管理ガイドの「サービスの管理ページについて」を参照してください。

- 既存のユーザー・ページへのApplication Expressユーザーの管理のリンク。このページを使用して、既存のApplication Expressユーザーおよびユーザー・グループを管理します。詳細は、Oracle Application Express管理ガイドの「Application Expressユーザーの管理」および「グループを使用したApplication Expressユーザーの管理」を参照してください。

- アクティビティの監視: アクティビティの監視ページにリンクします。このページを使用して、ページ・ビューを監視してアプリケーションに対する変更を表示します。詳細は、Oracle Application Express管理ガイドの「ワークスペース内のアクティビティの監視」を参照してください。

- パスワードの変更ページへの「パスワードの変更」リンク。ワークスペース・パスワードを変更するには、このページを使用します。詳細は、Oracle Application Express管理ガイドのパスワードのリセットに関する項を参照してください。

- Application Expressのバージョン情報ページへの「Application Expressのバージョン情報」リンク。このページを使用してApplication ExpressおよびOracle Database両方のバージョンと構成情報を表示します。詳細は、Oracle Application Express管理ガイドの「Application Express製品情報のページの表示」を参照してください。

移行について

「アプリケーションの移行」リンクを使用して、Microsoft Accessアプリケーションを移行し、Oracle Application Expressアプリケーションを生成します。Oracle Application Expressアプリケーション移行ガイドを参照してください。

ワークスペース・スキーマについて

「ワークスペース・スキーマ」リストは「管理」リストの下部に表示されます。このワークスペースと関連付けられたデータベース・スキーマが表示され、アクセス可能になります。

リンクについて

ワークスペースのホームページの下側に「リンク」リストが表示されます。次のApplication Expressリソースにアクセスするには、このリストを使用します。

- Oracle Technology NetworkのOracle Application Expressセクションへの「Oracle Technology Network」リンク。Oracle Application Expressの使用に関する追加情報およびリソースにアクセスするには、このページを使用します。

- Oracle Application Expressディスカッション・フォーラムへの「ディスカッション・フォーラム」リンク。このページは検索のリソースとしても、質問を投稿したり他のユーザーからの質問に回答するリソースとしても使用します。

- HTMLベースのオンライン・ヘルプ・システムへの「ユーザーズ・ガイド」リンク。Oracle Application Expressのすべてのページの右上隅にある「ヘルプ」リンクをクリックしても、オンライン・ヘルプにアクセスできます。詳細は、「ステップのオンライン・ヘルプについて」を参照してください。

ナビゲーションの選択肢

このセクションでは、Application Expressユーザー・インタフェースでページ間を移動するための選択肢について説明します。

アイコンまたはドロップ・ダウン・メニューを使用したナビゲート

大きいグラフィカル・アイコンをクリックすることで、Oracle Application Expressのページ間を移動できます。これらのアイコンを使用する場合は、次の2つのナビゲーション・オプションを利用できます。

- プライマリ・ナビゲーション(ドリルダウン):大きいアイコンをクリックして、指定のページにドリルダウンします。

- セカンダリ・ナビゲーション(ドロップ・ダウン・メニュー):アイコンの右側にある下矢印をクリックして、ドロップ・ダウン・メニューを表示します。メニューからオプションを選択します。

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

ブレッドクラムを使用したナビゲート

Oracle Application Expressのユーザー・インタフェースではすべてのページの上部に、ブレッドクラム(ロケータ・リンクとも呼ばれる)が表示されます。各ブレッドクラム・エントリは、ユーザー・インタフェース内の他のページに対するカレント・ページの相対位置を示します。ブレッドクラムを使用すると、即時に前のページにリンクできます。たとえば、「ホーム」をクリックすると、ワークスペースのホームページに移動します。

オンライン・ヘルプの使用

Application Expressのユーザー・インタフェースには、ステップのオンライン・ヘルプ、ページレベル・ヘルプおよびフィールドレベル・ヘルプの3つのオンライン・ヘルプがあります。

手順のオンライン・ヘルプについて

ウィンドウの右上隅にある「ヘルプ」リンクをクリックすると、HTMLベースのオンライン・ヘルプ・システムにアクセスできます。

「ヘルプ」リンクをクリックすると、現在のページに関するヘルプ・トピックが表示されます。別のヘルプ・セットの目次を表示するには、ウィンドウの左上にあるリストから選択します。

ヘルプ・トピックを参照する方法は次のとおりです。

- 目次を展開および縮小します。トピックを表示するには、そのトピックを選択します。

- 各ヘルプ・トピックの上部にあるブレッドクラムのリンクをクリックします。

- トピック内の「前へ」ボタンおよび「次へ」ボタンをクリックします。ヘルプ・セットの階層内の前または次のヘルプ・トピックにアクセスするには、これらのボタンをクリックします。

ウィンドウの上部には、灰色のバーが表示されます。「前へ」および「次へ」をクリックすると、前に表示されたページに戻ります。これらのコントロールはWebブラウザの「戻る」および「進む」と同様に機能します。

ヘルプ・システム全体のキーワード検索を実行するには、「検索」をクリックします。検索フィールドが表示されたら、そのフィールドに、大/小文字を区別しない問合せを入力して、「検索」をクリックします。完全一致する句を検索するには、句を二重引用符で囲みます。

ヒント:
Oracle Database 11gで「検索」リンクを使用するには、ネットワーク・サービスを有効にする必要があります。「Oracle Database 11gのネットワーク・サービスの有効化」を参照してください。

ページレベル・ヘルプについて

Application Expressユーザー・インタフェースの多数のページに、ページレベル・ヘルプがあります。ページレベル・ヘルプはページ右側のテキスト・ボックスに表示され、そのページの機能の簡単な説明が示されます。

フィールドレベル・ヘルプについて

Application Expressユーザー・インタフェースのほとんどの選択リスト、チェック・ボックス、アイテムおよびフィールドには、フィールドレベル・ヘルプがあります。ユーザー・インタフェース内のフィールドレベル・ヘルプのあるアイテムには、薄い灰色の下線が表示されます。フィールドレベル・ヘルプが使用可能な場合は、カーソルをあわせるとアイテム・ラベルが赤色に変わり、カーソルも疑問符付きの矢印に変わります。

アイテム・ラベルをクリックすると、別ウィンドウに説明が表示されます。

2 デモンストレーション・アプリケーションの実行

このセクションでは、Oracle Application Expressで提供される2つのデモンストレーション・アプリケーションの実行方法を説明します。また、アプリケーション・ビルダーと同時にインストールされるサンプル・アプリケーションというデモンストレーション・アプリケーションの修正方法についても説明します。アプリケーションがどのように機能するかを実行し分析することは、アプリケーション・ビルダーを使用してアプリケーションを構築するためのよりよい理解に繋がります。

この項には、次の項目が含まれます。

- デモンストレーション・アプリケーションのインストール

- インストールされたデモンストレーション・アプリケーションの実行

- サンプル・アプリケーションの理解

- デモンストレーション・アプリケーションの変更

- 基礎となるデータベース・オブジェクトの表示

関連項目:
Oracle Application Expressの知識を広げるために他のリソースを学ぶにはOracle Database Application Express 2日で開発者ガイドの「次のステップ」を参照してください。

デモンストレーション・アプリケーションのインストール

アプリケーション・ビルダーには、インストール可能な2つのデモンストレーション・アプリケーションが含まれています。これらのアプリケーションを使用して、アプリケーションに組み込むことができる多様な機能について学習してください。

デモンストレーション・アプリケーションをインストールするには、次のステップを実行します。

1. ワークスペースのホームページから、「アプリケーション・ビルダー」アイコンの右側にある下矢印をクリックします。

2. メニューから、「デモンストレーション」を選択します。

デモンストレーション・アプリケーション・ページに、次のアプリケーションが表示されます。

- 「サンプル・アプリケーション」には、基本的な設計概念に焦点をあてた実用的なデモンストレーションが表示されます。

- 「コレクション・ショウケース」には、ショッピング・カートの概要が表示されます。

3. デモンストレーション・アプリケーションをインストールするには、インストールするアプリケーションの位置を特定して、「インストール」をクリックします。

4. 画面に表示されるステップに従います。
アプリケーションのホームページが表示されます。

5. インストールしたデモンストレーション・アプリケーションを実行するには、「アプリケーションの実行」アイコンをクリックします。

6. 対象のログイン資格証明を入力し、「ログイン」をクリックします。

- サンプル・アプリケーションの場合は、次のようにします。

- ユーザー名には、demoまたはadminを入力します。

- パスワードには、現行のワークスペース名を小文字で入力します。

- その他のデモンストレーション・アプリケーションの場合、ワークスペースのユーザー名およびパスワードを入力します。

注意:
アプリケーションのホームページで「作成」をクリックして「デモンストレーション・アプリケーション」を選択してもデモンストレーション・アプリケーション・ページにアクセスできます。

関連項目:
「デモンストレーション・アプリケーションについて」および「インストールされたデモンストレーション・アプリケーションの実行」

インストールされたデモンストレーション・アプリケーションの実行

インストールしたデモンストレーション・アプリケーションは、デモンストレーション・アプリケーション・ページまたはアプリケーション・ビルダーのホームページから実行できます。

この項に含まれる内容は次のとおりです。

- デモンストレーション・アプリケーションからのアプリケーションの実行

- アプリケーションのホームページからのアプリケーションの実行

関連項目:
「デモンストレーション・アプリケーションのインストール」および「ページまたはアプリケーションの実行」

デモンストレーション・アプリケーションからのアプリケーションの実行

デモンストレーション・アプリケーション・ページからデモンストレーション・アプリケーションを実行するには、次のステップを実行します。

1. ワークスペースのホームページから、「アプリケーション・ビルダー」アイコンの右側にある下矢印をクリックします。

2. メニューから、「デモンストレーション」を選択します。
デモンストレーション・アプリケーション・ページが表示されます。

3. デモンストレーション・アプリケーション・ページで、実行するアプリケーションを検索します。

4. 「アクション」列で「実行」をクリックします。

5. 対象のログイン資格証明を入力し、「ログイン」をクリックします。

- サンプル・アプリケーションの場合は、次のようにします。

- ユーザー名には、demoまたはadminを入力します。

- パスワードには、現行のワークスペース名を小文字で入力します。

- その他のデモンストレーション・アプリケーションの場合、ワークスペースのユーザー名およびパスワードを入力します。

アプリケーションのホームページからのアプリケーションの実行

インストールしたデモンストレーション・アプリケーションは、アプリケーション・ビルダーのホームページから実行できます。

アプリケーション・ビルダーのホームページからデモンストレーション・アプリケーションを実行するには、次のステップを実行します。

1. ワークスペースのホームページにログインします。

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

3. 実行するアプリケーションをクリックします。
アプリケーションのホームページが表示されます。

4. 「アプリケーションの実行」アイコンをクリックします。

5. 対象のログイン資格証明を入力し、「ログイン」をクリックします。

- サンプル・アプリケーションの場合は、次のようにします。

- ユーザー名には、demoまたはadminを入力します。

- パスワードには、現行のワークスペース名を小文字で入力します。

- その他のデモンストレーション・アプリケーションの場合、ワークスペースのユーザー名およびパスワードを入力します。

サンプル・アプリケーションの理解

このセクションでは、サンプル・アプリケーションというデモンストレーション・アプリケーションについて説明します。

サンプル・アプリケーションには、電気製品およびコンピュータ製品の注文および顧客情報を表示、更新および検索するための使用しやすいインタフェースがあります。「ホーム」、「コンピュータ」、「製品」、「順序」および「チャート」タブを使用して、ページ間を移動できます。

サンプル・アプリケーションでは、次の機能を示します。

- ダイアル・チャート、サマリー・レポートなどのサマリー情報の表示方法の例

- 顧客、製品および注文の表示、更新および追加に関するレポート

- カレンダ・レポート

- Oracle Application Expressで使用可能なFlashチャート(集合棒、円グラフおよび積上げ棒など)

- 印刷用モード

次の項では、各ページで使用可能な特定の機能について説明します。

関連項目:
「ページの概要」

「Home」ページ

「Home」ページには4つのリージョンがあります。

- My Quota

- My Orders

- Sample Application

- Tasks

My Quota: Flashダイアル・チャートを使用します。このチャートには、基礎となるSQL文に基づいた値が表示されます。

この例には示されていませんが、SVGまたはFlashチャートのいずれかの属性を編集することで、非同期リフレッシュを有効にできます。

ヒント:
Flashダイアル・チャートは、demoというユーザー名でログインした場合にのみ表示されます。

My Orders: SQL問合せに基づく対話モード・レポートです。このレポートには、Ordersページに表示される情報の一部が表示されます。ユーザーは、「編集」アイコンを選択して注文の詳細にリンクできます。「アクション」メニューを使用してレポートの外観を変更することもできます。

Sample Application: 静的テキストが表示される単純なHTMLリージョンです。このタイプのリージョンを作成して、ユーザーに対する説明情報を表示できます。

Tasks: アプリケーション内の他のページへのリンク付きのリストを含みます。Homeページのタスク・リストで使用可能なリンクは次のとおりです。

- About this Application: このアプリケーションについて説明している情報ページにリンクします。

- Enter a New Order: 新しい注文を作成するウィザードにリンクします。

- Add a New Customer: 新しい顧客情報を入力するフォームにリンクします。

- Add a New Product: 新しい製品を追加するフォームにリンクします。

関連項目:
「チャートの作成」、「リージョンの作成」および「リストの作成」

Customersページについて

Customersページでは、ユーザーが顧客情報を表示および編集できます。「Customers」ページは、2つのメイン・リージョンで構成されています。

- Customers

- Top Customers

Customers: 顧客情報を追跡するための対話モード・レポートです。このリージョンもSQL問合せに基づいています。顧客を検索するには、「検索」フィールドに顧客の名前を入力し、「実行」をクリックします。顧客名でソートするには、列ヘッダーをクリックします。ソート・アイコンが「Customer」ヘッダーの右側に表示されます。「アクション」メニューを使用すればレポートの外観を変更できます。既存の顧客情報を更新するには、「編集」アイコンをクリックします。新規顧客を追加するには、「New Customer」ボタンをクリックします。

Top Customers: 注文量で顧客をランク付けします。このレポートは、注文に基づいて上位の顧客を戻すSQL問合せに基づいています。

関連項目:
「レポートの作成」

Productsページ

「Products」ページでは、製品情報を表示および編集できます。「Products」ページは、2つのメイン・リージョンで構成されています。

- Products

- Top 10 Products

Products: 製品情報を追跡するための対話モード・レポートが表示されます。このリージョンは、データベースに格納されたイメージを表示するためのカスタム・ファンクションを使用するSQL問合せに基づきます。製品のカテゴリでソートするには、列ヘッダーをクリックします。製品の説明を編集するには、「編集」アイコンをクリックします。新しい製品を追加するには、ページ上部の「Create Product」ボタンをクリックします。「アクション」メニューを使用すればレポートの外観を変更できます。

Top 10 Products: これもSQLレポートです。このレポートでは、販売量に基づいた上位10個の製品の概要が説明されます。

関連項目:
「レポートの作成」

「Orders」ページ

Ordersページでは、ユーザーが顧客の注文を表示および編集できます。「Orders」ページには2つのリージョンがあります。

- My Orders

- Orders by Day

My Orders: システムでの現在の注文を要約するウィザード・レポートです。列をソートするには、列ヘッダーをクリックします。ソート・アイコンが列ヘッダーの右側に表示されます。既存の注文を編集するには、「編集」アイコンをクリックします。新しい注文を追加するには、「Enter New Order」ボタンをクリックします。

Orders by Day: カレンダ・レポートです。このレポートには、カレンダ内の該当する日付の注文が表示されます。ユーザーは、カレンダ・エントリを選択して注文の詳細を表示できます。その前後のエントリに移動するには、 「前へ」ボタンと「次へ」ボタンをクリックします。

関連項目:
「カレンダの作成」および「レポートの作成」

Chartsページ

Chartsページでは、アプリケーション・ビルダーで使用可能な、集合棒、円グラフ、積上げ棒の3つのタイプのFlashチャートが示されます。チャートを表示するには、左側にあるリストから選択します。

関連項目:
「チャートの作成」

Adminページ

Adminページは、adminというユーザー名を使用してサンプル・アプリケーションにログインした場合にのみ表示されます。サンプル・アプリケーションでは、ユーザー名および難読化されたパスワードを表に格納するカスタム認証スキームを使用しています。ユーザーの管理ページで、追加ユーザーを管理できます。ユーザーを新しく追加するには、ページ下部の「ユーザーの追加」をクリックします。ユーザーを削除する場合は、ユーザーを選択して選択したユーザーの削除をクリックします。

このカスタム認証スキームでは、Oracle Application Expressアプリケーション開発者に関連付けられたユーザー名またはパスワードは使用されないことに注意してください。

「印刷用」モードでのページの表示

ページの左上の「Print」をクリックすると、カレント・ページが印刷用モードで表示されます。印刷用モードの場合、Application Expressエンジンは、HTMLフォーム・フィールド内のすべてのテキストをテキストとして表示します。

アプリケーションで印刷用モードでの表示を有効にするには、定義の編集ページで出力モード・ページ・テンプレートを作成してから指定する必要があります。

関連項目:
「印刷用ページの最適化」

デモンストレーション・アプリケーションの変更

デモンストレーション・アプリケーションで使用可能な機能の種類を理解したら、次のステップは、各ページの構成を理解することです。早く理解するための効果的な方法は、デモンストレーション・アプリケーションのページを分析および分解することです。何かを破損しても、すぐにデモンストレーション・アプリケーションを削除してインストールしなおすことができます。詳細は、「アプリケーションの削除」および「デモンストレーション・アプリケーションのインストール」を参照してください。

アプリケーション内の既存のページの編集、アプリケーションへのページの追加、またはアプリケーション・ビルダーを使用したまったく新しいアプリケーションの作成が可能です。

この項に含まれる内容は次のとおりです。

- 開発者ツールバーについて

- デモンストレーション・アプリケーションの編集

開発者ツールバーについて

開発者ツールバーを使用すると、カレント・アプリケーションおよび現在実行されているページの編集、新しいページ、コントロールまたはコンポーネントの作成、セッション・ステートの表示、編集リンクのオン/オフの切替えを簡単に実行できます。

関連項目:
「開発者ツールバーについて」

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

- ホーム: ワークスペースのホームページにリンクします。「ワークスペースのホームページについて」を参照してください。

- アプリケーション: アプリケーションのホームページにリンクします。「アプリケーション・ビルダーの概要」を参照してください。

- ページの編集: 現在実行されているページのページ定義にアクセスします。「ページ定義について」を参照してください。

- 作成: 新しいページ、リージョン、ページ・コントロール(アイテム、ボタン、ブランチ、計算、プロセスまたは検証)または共有コントロール(ナビゲーション・バー・アイコン、タブ、LOV、リストまたはブレッドクラム)を作成するためのウィザードにリンクします。詳細は、「アプリケーションの作成」を参照してください。

- セッション: カレント・ページのセッション・ステート情報にリンクします。詳細は、「セッション・ステートの表示」を参照してください。

- アクティビティ: アクティビティ・レポート・ページにリンクします。「アクティビティ・レポート」を参照してください。

- デバッグ: ページを「デバッグ」モードと「デバッグなし」モードとの間で切り替えます。「デバッグ・モードへのアクセス」を参照してください。

- 編集リンクの表示: 「編集リンクの表示」と「編集リンクを非表示」とを切り替えます。「編集リンクの表示」をクリックすると、ページ上の編集可能な各オブジェクトの横に小さなオレンジ色のアイコンが表示されます。各アイコンは、オレンジ色で中に三角形があり、その下に2本の罫線があります。リンクをクリックすると、オブジェクト編集用の別のウィンドウが表示されます。

デモンストレーション・アプリケーションの編集

デモンストレーション・アプリケーションは、次の2つの方法で編集できます。

- デモンストレーション・アプリケーション・ページで、編集するアプリケーションの横にある「編集」をクリックする。

- アプリケーションを実行している場合は、「開発者」ツールバーの「アプリケーション」をクリックします。

アプリケーションのホームページが表示されます。アプリケーションIDとアプリケーション名がページ上部に表示されます。

次のいずれかをクリックすると、現在のアプリケーションの実行、サポートするオブジェクトの編集、共有コンポーネントの作成、または情報のエクスポートおよびインポートが可能になります。

- アプリケーションの実行: カレント・アプリケーションのページをApplication Expressエンジンに送信し、表示可能なHTMLをレンダリングします。「Application Expressエンジンがページをレンダリングおよび処理する方法」を参照してください。

- サポートするオブジェクト: サポートするオブジェクト・ページにリンクします。「パッケージ・アプリケーションの作成方法」を参照してください。

- 共有コンポーネント: アプリケーション内のすべてのページに表示または適用できる共有コンポーネントおよびユーザー・インタフェース・コントロールのリストにリンクします。「共有コンポーネントでの作業」を参照してください。

- エクスポート/インポート: エクスポート・ウィザードとインポート・ウィザードにリンクします。このウィザードを使用して、アプリケーション全体のインポートとエクスポート、およびカスケード・スタイルシート、イメージ、静的ファイル、スクリプト・ファイル、テーマ、ユーザー・インタフェースのデフォルト値、ワークスペース・ユーザーなどの関連ファイルのインポートとエクスポートを行うことができます。「アプリケーションおよび関連ファイルのエクスポート」を参照してください。

アプリケーションを構成するページがアプリケーションのホームページに表示されます。特定のページにアクセスするには、そのページをクリックします。特定のページを検索するには、「ページ」フィールドにページ・タイトルを入力またはページ名に対して大文字小文字を区別しない問合せを入力して、「実行」をクリックします。

関連項目:
「アプリケーションのホームページについて」および「ページ定義について」

基礎となるデータベース・オブジェクトの表示

Application Expressエンジンは、データベース表に格納されたデータに基づいて、アプリケーションをリアルタイムでレンダリングします。デモンストレーション・アプリケーション用のデータベース・オブジェクトは、オブジェクト・ブラウザまたは「アプリケーション・データベース・オブジェクトの依存性」レポートで確認できます。

この項に含まれる内容は次のとおりです。

- 「データベース・オブジェクトの依存性」レポートの表示

- オブジェクト・ブラウザでのデータベース・オブジェクトの表示

Database Object Dependenciesレポートの表示

データベース・オブジェクトの依存性レポートは、カレント・アプリケーションで参照されるデータベース・オブジェクトを識別します。アプリケーションのデプロイ時に移動するオブジェクトを判別するには、このレポートを確認します。

データベース・オブジェクトの依存性レポートを表示するには、次のステップを実行します。

1. 「ワークスペース」ホームページにナビゲートします。

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

3. アプリケーションを選択します。
アプリケーションのホームページが表示されます。

4. 「タスク」リストで、「アプリケーション・レポート」をクリックします。

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

6. 「アプリケーション」で、「データベース・オブジェクトの依存性」をクリックします。

7. 「依存性の計算」をクリックします。

8. 特定のデータベース・オブジェクトを参照するコンポーネントを表示するには、「参照カウント」の番号を選択します。

関連項目:
「アプリケーション・レポートの表示」

オブジェクト・ブラウザでのデータベース・オブジェクトの表示

データベース・オブジェクトをオブジェクト・ブラウザに表示するには、次のステップを実行します。

1. ワークスペースのホームページで、「SQLワークショップ」をクリックして、「オブジェクト・ブラウザ」をクリックします。
オブジェクト・ブラウザが表示されます。

2. ページ左上の「オブジェクト」リストからオブジェクト・タイプを選択します。たとえば、表を表示するには、「表」を選択します。

3. オブジェクト名を検索するには、「オブジェクト」リストの下の検索フィールドにキーワードを入力します。
一致するオブジェクトのリストが表示されます。

4. 選択したオブジェクトに関連する特定のタスクを実行するには、該当するタスク・ボタンを選択します。
たとえば、DEMO_CUSTOMERS表の列を変更するには、次のステップを実行します。

1. 「オブジェクト」リストから、「表」を選択します。

2. 「表」リストから、DEMO_CUSTOMERSを選択します。

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

5. 追加のオブジェクト詳細を表示するには、オブジェクト名の下のタブを選択します。たとえば、DEMO_CUSTOMERS表のデータを表示するには、次のステップを実行します。

1. 「表」リストから、DEMO_CUSTOMERSを選択します。

2. 「データ」タブを選択します。
DEMO_CUSTOMERS表のデータを表示するレポートが表示されます。

関連項目:
Oracle Application Express SQLワークショップおよびユーティリティ・ガイドの「オブジェクト・ブラウザを使用したデータベース・オブジェクトの管理」

3 アプリケーション・ビルダーの概念

このセクションでは、アプリケーション・ビルダーの基本概念を説明します。アプリケーション・ビルダーを使用すると、表やプロシージャなどのデータベース・オブジェクトの外観としてHTMLインタフェース(またはアプリケーション)を構築できます。各アプリケーションは、タブ、ボタンまたはハイパーテキスト・リンクを使用して相互にリンクされたページの集合です。

この項には、次の項目が含まれます。

- ページの概要

- ページ・プロセスおよびページ・レンダリングの理解

- セッション・ステートの管理の理解

- URL構文の理解

- セッション・ステート値の管理

- 置換文字列の理解

関連項目:
「アプリケーション・ビルダーの使用」および「アプリケーションの構築」

ページの概要

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

ページ定義上のページにコントロールを追加します。

既存のページのページ定義を表示するには、次のステップを実行します。

1. 「ワークスペース」ホームページにナビゲートします。

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

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

4. ページを選択します。
「ページ定義」が次の3つの主要セクションに分かれて表示されます。

- ページ・レンダリング: ページのレンダリング中に実行されるユーザー・インタフェース・コントロールおよびロジックがリストされます。ページ・レンダリングとは、データベースからのページ生成プロセスです。「ページ・レンダリングについて」を参照してください。

- ページ・プロセス: ページの処理中に評価および実行されるロジック・コントロール(計算、プロセスなど)がリストされます。詳細は、「ページ・プロセスについて」を参照してください。

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

関連項目:
「ページ定義について」および「ページ定義の編集」

ページ・プロセスおよびページ・レンダリングの理解

アプリケーション・ビルダーにアプリケーションを作成する際に、タブ、ボタンまたはハイパーテキスト・リンクを使用して複数のページをリンクできます。各ページにはボタンおよびアイテムを配置でき、アプリケーション・ロジックを含めることができます。ページでは、条件付きナビゲーションを使用したあるページから次のページへのブランチ、計算および検証の実行、およびレポート、カレンダおよびチャートの表示を行うことができます。組込みウィザードを使用してレポート、チャートおよびフォームを生成したり、静的HTMLを生成したり、PL/SQLプログラミングによってカスタム・レンダリングを行うことができます。

この項に含まれる内容は次のとおりです。

- Application Expressエンジンがページをレンダリングおよび処理する方法

- 条件付きのレンダリングおよびプロセスの理解

- ユーザー・アイデンティティの確認

- コントロールおよびコンポーネントへのアクセスの制御

Application Expressエンジンがページをレンダリングおよび処理する方法

Application Expressエンジンは、Oracle Database表に格納されたデータに基づいて、ページを動的にレンダリングおよび処理します。レンダリングされたアプリケーションを表示するには、Application Expressエンジンから、それをリクエストします。アプリケーションを実行すると、Application Expressエンジンによって次の2つのプロセスが使用されます。

- ページ表示は、ページ・レンダリング・プロセスです。このプロセスによって、すべてのページ属性(リージョン、アイテム、ボタンなど)が表示可能なHTMLページに編成されます。

- ページ受入れでは、ページの処理が行われます。このプロセスによって、すべての計算、検証、プロセスおよびブランチが実行されます。

URLを使用してページをリクエストする場合、エンジンはページ表示を実行します。ページを送信すると、Application Expressエンジンはページ受入れまたはページ・プロセスを実行します(その間に、送信された値をセッション・キャッシュに保存し、計算、検証または処理を実行します)。

条件付きのレンダリングおよびプロセスの理解

条件とは、リージョン、アイテム、ボタンおよびタブの表示と、プロセス、計算および検証の実行を制御するために役立つ論理単位です。たとえば、ボタンに条件を適用すると、レンダリング・エンジンによって、レンダリング(ページ表示)プロセス中にその条件が評価されます。条件に合格するかどうかによって、そのページ・コントロール(この場合はボタン)が表示されるかどうかが決まります。

条件を指定するには、条件タイプを選択します。条件タイプは、コントロールまたはコンポーネントを最初に作成するときに選択するか、コントロールまたはコンポーネントを編集する場合に条件タイプ属性から選択します。選択した条件タイプに応じて、「式」フィールドに適切な値を入力します。条件は、「式」フィールドに入力した値に基づいて、trueまたはfalseに評価されます。

注意:
「式」フィールドを使用するかどうかは、選択した条件タイプによって決まります。いずれのフィールドの値も必要としない条件タイプ、「式1」の値のみが必要な条件タイプ、両方のフィールドの値が必要な条件タイプなどがあります。これらのフィールドは「式1」および「式2」とラベル付けされていますが、指定した条件タイプの値が式という用語の公式の定義に準拠していない場合があります。これらの値は、選択した条件タイプに適したテキスト値です。

任意のコンポーネントまたはコントロールに使用可能なすべての条件のリストを表示するには、「条件タイプ」リストの右側にある矢印をクリックします。リストのすぐ下に、一般的な選択項目へのショートカットが表示されます。条件に式が必要な場合は、該当するフィールドにその式を入力します。

次の項では、一般的に使用されるいくつかの条件タイプの例について説明します。

関連項目:
使用可能な条件 タイプの詳細なリストは、付録A「使用可能な条件」を参照してください。

カレント・ページ=式1

式1のカレント・ページは、カレント・ページ番号が、「式1」内のカンマで区切られたページ・リストに含まれている場合にtrueと評価されます。次に例を示します。

3,100,203

カレント・ページが100である場合、この条件はtrueに評価され、条件に合格します。

存在

「存在する(SQL問合せが1行以上を戻す)」は、SQL問合せとして表現されます。問合せで1行以上が戻される場合、この条件はtrueと評価されます。次に例を示します。

SELECT 1 FROM employees WHERE department_id = :P101_DEPTNO

この例では、アイテムP101_DEPTNOがバインド変数として参照されます。アプリケーション・プロセスおよびSQL問合せリージョン内でバインド変数を使用すると、アイテムのセッション・ステートを参照できます。P101_DEPTNOの値に指定した部門に1人以上の従業員が存在する場合、この条件はtrueと評価されます。

関連項目:
「バインド変数構文について」

PL/SQL式

「PL/SQL式」は、trueまたはfalseを評価する式を有効なPL/SQL構文で指定するために使用します。次に例を示します。

NVL(:MY_ITEM,'NO') = 'YES'

前述の例のように、:MY_ITEMの値が「はい」であれば、この条件はtrueと評価されます。:MY_ITEMが「いいえ」であれば、この条件はfalseと評価されます。

ユーザー・アイデンティティの確認

認証は、ユーザーのアプリケーションへのアクセスを可能にするために、ユーザーのアイデンティティを証明するプロセスです。認証では、ユーザーにユーザー名とパスワードの入力を求めたり、デジタル証明書や保護キーを使用する場合があります。

Oracle Application Expressは、モジュール認証をサポートしているため、必要に応じて認証メソッドを簡単に切り替えられます。ユーザー・アイデンティティの証明は、複数の組込み認証メソッドから選択するか、またはウィザードを使用して独自のカスタム認証方法を作成して実行できます。

関連項目:
詳細は、「認証によるユーザー・アイデンティティの証明」を参照してください。

コントロールおよびコンポーネントへのアクセスの制御

条件はページ上の特定のコントロールまたはコンポーネントのレンダリングおよび処理を制御しますが、認可スキームはユーザーのアクセスを制御します。認可は、ユーザー権限に基づいてリソースへのアクセスを制御することを示す広義語です。

認可スキームは、アプリケーションの認証スキームのセキュリティを強化します。認可スキームは、アプリケーション全体、各ページ、またはリージョン、アイテム、ボタンなどの特定のページ・コントロールに対して指定できます。たとえば、認可スキームを使用して、ユーザーに表示するタブ、リージョンまたはナビゲーション・バー・エントリを選択的に決定できます。

関連項目:
「認可を介したセキュリティの提供」

セッション・ステートの管理の理解

HTTP(HTMLページの配布に最も一般的に使用されるプロトコル)は、ステートレスなプロトコルです。Webブラウザは、ページ全体をダウンロードするために必要な時間のみサーバーに接続します。また、サーバーでは、各ページ・リクエストは、発生済または将来発生する他のページ・リクエストと関連しない個別のイベントとして処理されます。これは、あるページで入力したフォーム値に後続のページでアクセスするには、なんらかのセッション・ステート管理を使用する必要があることを意味します。通常、ユーザーがあるページのフォームに入力した値には、後続のページからはアクセスできません。Oracle Application Expressは透過的にセッション・ステートを保持するため、開発者は、アプリケーションの任意のページでセッション・ステートの値を取得および設定できます。

この項に含まれる内容は次のとおりです。

- セッションの概要

- セッションIDの理解

- セッション・ステートの参照

セッションの概要

セッションは、ページ・ビュー間で永続性(またはステートフルな動作)を確立する論理的な構成体です。各セッションには、一意の識別子が割り当てられています。Application Expressエンジンは、この識別子(セッションID)を使用して、各ページ・ビューの前後に、アプリケーションで作業中のデータ・セット(セッション・ステート)を格納および取得します。

個々のセッションは相互に完全に独立しているため、任意の数のセッションがデータベース内に同時に存在できます。セッションは管理者によって消去されるまでデータベース内で存続するため、ユーザーは、以前のセッションに戻ることができ、1つのアプリケーションを長期間実行し続けることができます。また、ユーザーは複数のブラウザ・セッションで、アプリケーションの複数のインスタンスを同時に実行できます。

セッションは、ページ・リクエストの処理に使用されるOracle Databaseセッションとは論理的にも物理的にも異なります。ユーザーはアプリケーションを、1つのOracle Application Expressセッションで、ログインからログアウトまで実行します。この期間は、通常分単位か時間単位です。このセッション中にページがリクエストされるたびに、Application ExpressエンジンはOracle Databaseセッションを作成または再利用してデータベース・リソースにアクセスします。多くの場合、これらのデータベース・セッションは、数分の1秒のみ存続します。

関連項目:
Oracle Application Express管理ガイドの「アクティブ・セッションの表示」を参照してください。

セッションIDの理解

Application Expressエンジンは、ページ・リクエストごとにユーザーのアイデンティティ(または匿名性)を証明し、データベースからセッション・ステートをフェッチするためにセッションIDを確立します。セッションIDは、ページ・リクエストのURL内に明示的に示されています。URLの第3パラメータとしてセッションIDが表示されます。次に例を示します。

http://apex.somewhere.com/pls/apex/f?p=4350:1:220883407765693447

この例では、セッションIDは220883407765693447です。

また、ページのHTML POSTデータにも明示的に示され、セッションのCookieのコンテンツ内にも間接的に示されています。このCookieは、認証時にApplication Expressエンジンによって送信され、アプリケーション(またはブラウザ)セッションの存続中、維持されます。

Oracle Application Expressは、認証プロセス中に新しいセッションIDを割り当て、認証されたユーザーのアイデンティティをセッションIDとともに記録し、続けて各ページ・リクエストのURLまたはPOSTデータをセッションのCookieおよびデータベースのセッション・レコードと照合して確認します。この確認によって、柔軟性とセキュリティが向上します。

セッションIDがセッション・ステート用のキーであるのに対し、セッションのCookie(使用される場合)およびセッション・レコードは、セッションIDとユーザーの認証ステータスの整合性を保証します。

関連項目:
「ページに表示されるURLの理解」

セッション・ステートの表示

Oracle Application Expressアプリケーションの動作は、通常、セッション・ステートの値によって決まります。たとえば、ボタンは、アイテムのセッション・ステートの値に基づいて、条件付きで表示できます。ページのセッション・ステートを表示するには、開発者ツールバーの「セッション」をクリックします。

セッション・ステート・ページについて

セッション・ステート・ページは、現在実行中のアプリケーションのセッションに関する有益な情報を提供します。特定のページを検索するには、ページ・フィールドにページ番号を入力して「実行」をクリックします。表3-1に、セッション・ステート・ページで参照可能な様々な情報を示します。

表3-1 セッション・ステート・ページで参照可能な情報

ヘッダー

説明

アプリケーション

アプリケーションの名前を表示します。

セッション

カレント・セッションのセッション・ステートのサマリーを表示します。

ユーザー

現行ユーザーを表示します。

ワークスペース

現行のワークスペースIDを表示します。

ブラウザ言語

現行のブラウザ言語を表示します。

ページ・アイテム

アプリケーションID、ページ番号、アイテム名、アイテムの表示方法(チェック・ボックス、日付ピッカー、表示のみ、テキスト・フィールド、非表示、ポップアップ、ラジオ・グループなど)、セッション・ステートのアイテム値、ステータスなどのページ・アイテムの属性が表示されます。

「ステータス」列には、セッション・ステートのステータスが示されます。表示される値を次に示します。

- I: 挿入

- U: 更新

- R: リセット

参照: 「 ページ・レベル・アイテムの理解」

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

アプリケーション・アイテムは、ページに存在しないアイテムです。アプリケーション・アイテムは、関連付けられたユーザー・インタフェース・プロパティを持たないセッション・ステート変数です。

関連項目: アイテム値を参照する方法については、「アプリケーション・レベル・アイテムの理解」および「置換文字列の理解」を参照してください。

関連項目:
「セッション・ステート値の管理」

URL構文の理解

ページごとに表示されるURLは、Oracle Application Expressの場所、Oracle Application Expressのアドレス、アプリケーションID、ページ番号およびセッションIDを指定します。

アプリケーションIDは各アプリケーションを識別する一意の番号です。同様に、ページ番号は各ページを一意に識別します。アプリケーションおよびページには、英数字の別名がある場合もあります。アプリケーションの別名はワークスペース内で一意であり、ページの別名は各アプリケーション内で一意です。アプリケーションを実行する場合、Application Expressエンジンはユーザーのセッション・ステートに対するキーとして機能するセッション番号を生成します。

この項に含まれる内容は次のとおりです。

- ページに表示されるURLの理解

- f?p構文を使用したページのリンク

- アプリケーションおよびページの別名を使用したページのコール

- ボタンのURLからのページのコール

- セッションIDにゼロを使用したブックマークの容易化

ページに表示されるURLの理解

ページごとに表示されるURLは、Oracle Application Expressの場所を指定します。また、Oracle Application Expressのアドレス、アプリケーションID、ページ番号およびセッションIDを指定します。次に例を示します。

http://apex.somewhere.com/pls/apex/f?p=4350:1:220883407765693447

この例の内容は次のとおりです。

- apex.somewhere.comは、サーバーのURLです。

- plsは、mod_plsqlカートリッジを使用するためのインジケータです。

- apexは、データベース・アクセス記述子(DAD)名です。DADにはHTTP Serverからデータベース・サーバーへの接続方法が記述されているため、HTTPリクエストを実行できます。デフォルト値はapexです。

- f?p=は、Oracle Application Expressによって使用される接頭辞です。

- 4350は、コールされているアプリケーションです。

- 1は、表示されるアプリケーション内のページです。

- 220883407765693447は、セッション番号です。

関連項目:
「アプリケーションURLの公開について」

f?p構文を使用したページのリンク

アプリケーションのページ間にリンクを作成するには、次の構文を使用します。

f?p=App:Page:Session:Request:Debug:ClearCache:itemNames:itemValues:PrinterFriendly

表3-2に、f?p構文の使用時に指定できる引数を示します。

表3-2 f?p構文の引数

構文

説明

App

アプリケーションIDまたは英数字の別名を指定します。

Page

ページ番号または英数字の別名を指定します。

Session

セッションIDを指定します。セッションIDを参照して、セッション番号を渡すことで同じセッション・ステートを保持している他のページへのハイパーテキスト・リンクを作成できます。セッションIDを参照するには、次の構文を使用します。

- 短縮置換文字列: &SESSION

- PL/SQL: V('SESSION')

- バインド変数: :APP_SESSION

Request

REQUESTの値を設定します。REQUESTの値は、各アプリケーション・ボタンによって、そのボタンの名前に設定されます。これによって、ユーザーがボタンをクリックしたときに、受入れプロセスでそのボタンの名前が参照されるようになります。REQUESTを参照するには、次の構文を使用します。

- 置換文字列: &REQUEST

- PL/SQL: V('REQUEST')

- バインド変数: :REQUEST

Debug

アプリーション処理の詳細を表示します。DEBUGフラグの有効値はYESまたはNOです。このフラグをYESに設定すると、アプリケーション・プロセスの詳細を表示できます。DEBUGフラグを参照するには、次の構文を使用します。

- 短縮置換文字列: &DEBUG

- PL/SQL: V('DEBUG')

- バインド変数: :DEBUG

関連項目: 「アプリケーションのデバッグ」

ClearCache

キャッシュをクリアします。これによりアイテムの値がNULLに設定されます。

キャッシュされたアイテムを単一のページでクリアするには、数値ページ番号を指定します。キャッシュされたアイテムを複数のページでクリアするには、ページ番号のカンマ区切りのリストを使用します。ページのキャッシュをクリアすると、ページのステートフル・プロセスもリセットされます。個別の値またはカンマ区切りの値には、リセットするコレクション名を追加することや、リクエストされたページにおけるリージョンのページ区切りをリセットするためにキーワードRPを追加することができます。キーワードAPPは、すべてのページのキャッシュおよびカレント・アプリケーションにおけるすべてのアプリケーション・レベルのアイテムをクリアし、現行のユーザーのソート・プリファレンスを削除します。キーワードSESSIONはAPPキーワードと同じ結果になりますが、カレント・セッションで使用されたすべてのアプリケーションに関連付けられたアイテムをクリアします。

関連項目: 「セッション・ステートのクリア」

itemNames

URLでセッション・ステートを設定するために使用される、カンマで区切られたアイテム名のリストです。

itemValues

URLでセッション・ステートを設定するために使用されるアイテム値のリストです。アイテム値にコロンを含めることはできませんが、カンマをバックスラッシュで囲んで指定することは可能です。アイテム値にカンマを渡すには、文字をバックスラッシュで囲んでください。次に例を示します。

\123,45\

PrinterFriendly

ページを「印刷用」モードでレンダリングするかどうかを決定します。PrinterFriendlyが「はい」に設定されている場合は、ページが「印刷用」モードでレンダリングされます。PrinterFriendlyの値は、リージョンなどの要素をページから削除して印刷される出力を最適化するための条件のレンダリングに使用されます。印刷用プリファレンスを参照するには、次の構文を使用します。

V('PRINTER_FRIENDLY')

参照時は、Application Expressエンジンはタブやナビゲーション・バーを表示しません。すべてのアイテムは、フォーム要素ではなくテキストで表示されます。

f?p構文の動作を理解することは重要ですが、この構文をユーザー自身が構築する必要がある場合はほとんどありません。アプリケーション・ビルダーには、これらの参照を自動的に作成する多くのウィザードが含まれています。次のセクションでは、f?p構文を使用してページをリンクする多くの具体的な場合について説明します。

アプリケーションおよびページの別名を使用したページのコール

アプリケーションおよびページの別名は、有効なOracle識別子で構成する必要があります。空白を含めることはできず、また大/小文字は区別されません。次の例では、アプリケーション内から、アプリケーションおよびページの別名を使用してページをコールします。アプリケーションmyappのページhomeが実行され、現行のセッションIDが使用されます。

f?p=myapp:home:&APP_SESSION.

アプリケーションの別名は、ワークスペース内で一意である必要があります。異なるワークスペースのアプリケーションに同じアプリケーション別名がある場合は、&c引数を使用してワークスペース名を指定します。次に例を示します。

f?p=common_alias:home:&APP_SESSION.&c=WORKSPACE_A

ボタンのURLからのページのコール

ボタンの作成時に、ユーザーがそのボタンをクリックするとリダイレクトされるURLを指定できます。この例では、アプリケーション6000のページ6001が実行され、現行のセッションIDが使用されます。

f?p=6000:6001:&APP_SESSION.

これは、ボタンを使用するための唯一の方法です。この方法は、ページの送信を省略し、そのページ上のハイパーリンクとして機能します。他にも、まずページを送信する方法があります。その方法では、ボタンをクリックすると、処理するページが送信され、フォームが送信された後、セッション・ステートが保存されます。

関連項目:
「ボタンの作成」および「APP_SESSION」

セッションIDにゼロを使用したブックマークの容易化

アプリケーション内のページが公開されていて認証の必要がない場合、セッションIDとしてゼロを使用することで、アプリケーション・ユーザーは容易にページをブックマークできます。

認証の必要がないアプリケーション・ページは、セッションIDがゼロ(単一の数字0)であるf?q URLを使用してアクセスできます。ブラウザにURLを入力するか、またはセッションIDに0を含むリンクをクリックしてページをリクエストすると、Application Expressエンジンは新しいセッションIDを割り当て、新しいセッションIDを含むセッションCookieをブラウザに送信します。アプリケーションのパブリック・ページを介してナビゲートすると、パブリック・ページへの生成済リンクすべてにセッションID0が含まれており、パブリック・ページへのブランチすべてに、表示されているセッションIDに0を使用する新しいURLが含まれていることがわかります。ただし、Application Expressエンジンは、バックグラウンドでカレント・セッションIDとしてCookieのセッションIDを使用してセッション・ステートを指定します。

カレント・セッションIDを非表示にする場合にこの機能は有効です。セッションIDを非表示にすると、ブックマーク・リンクにセッションIDを含めなくてもページをブックマークできるようになります。さらに優れた点として、セッションIDにゼロを使用すると、実際のセッションIDを検索エンジンから見えないようにします。

アプリケーションのセッションIDとしてゼロを使用するには、ゼロ・セッションIDを含むリンクを少なくとも1つ生成する必要があります。このリンクを使用することでゼロ・セッションIDメカニズムが開始されます。1つの方法として、アプリケーションのホームページでゼロ・セッションIDを含む単一の静的リンクを提供する方法があります。たとえば、通常はページ2へのリンクにf?p=&APP_ID.:2:&APP_SESSIONをコード化するところで、f?p=&APP_ID.:2:0をコード化します。

APEX_UTIL.PREPARE_URLについて

Oracleには、f?p構文を使用してアプリケーション・ページにアンカーを生成する際に開発者がPL/SQLを使用するためのユーティリティの機能があります。アプリケーションのPL/SQLでゼロ・セッションIDが要求される可能性のあるf?pアンカーが作成されるたびに、APEX_UTIL.PREPARE_URLを使用します。詳細は、Oracle Application Express APIリファレンスの「PREPARE_URL」を参照してください。

ゼロ・セッションID機能の動作方法

ゼロ・セッションID機能では、HTMLにアンカーを持つページ(テンプレートやHTMLリージョンなど)がサポートされます。Application Expressエンジンがf?pアンカーに直面した場合に、ある基準を満たしていると、そのアンカーを認識してセッションIDをゼロに置き換えます。

Application Expressエンジンは、次のいずれかのパターンを検出した場合に、セッションIDコンポーネントをゼロに置き換えます。

- &APP_ID.

- 現行のアプリケーションの数値ID

- 次のいずれかのパターン:

- すべて大文字またはすべて小文字で表された、現行のアプリケーションの英数字別名にコロンが続き、その後に現行のアプリケーションの公開ページの数値IDが続く

- すべて大文字またはすべて小文字で表された、現行のアプリケーションの公開ページの英数字別名にコロンが続き、その後に&APP_SESSION.または&SESSION.が続く

ゼロ・セッションIDに置換される候補となるHTMLのパターンには、次のものがあります。

- ページ10が公開ページの場合:

"f?p=&APP_ID.:10:&APP_SESSION.

- ページ10が公開ページの場合:

"f?p=100:10:&APP_SESSION.

- 公開ページの別名がhomeの場合:

"f?p=&APP_ID.:home:&APP_SESSION.

- 公開ページの別名がHOMEの場合:

"f?p=&APP_ID.:HOME:&APP_SESSION.

- アプリケーションの別名がPEOPLEで、公開ページの別名がHOMEの場合:

"f?p=PEOPLE:HOME:&APP_SESSION

これらの例では、アプリケーションがゼロ・セッションIDモードで実行され、ユーザーが公開ユーザーである場合に、パターン&APP_SESSION.(または&SESSION.(非表示))がゼロに置き換えられます。次のPL/SQL式がtrueの場合に、ユーザーは公開ユーザーであるとみなされます。

:app_user in ('nobody','HTMLDB_PUBLIC_USER','PUBLIC_USER','ANONYMOUS','APEX_PUBLIC_USER')"

セッション・ステート値の管理

インタラクティブな、データに応じて動作するWebアプリケーションを構築するには、セッション・ステート値にアクセスして管理する機能が重要です。Oracle Application Expressでは、セッション・ステートはページごとに自動的に管理され、静的HTML、またはプロセスや検証などのロジック・コントロールによって簡単に参照できます。

この項に含まれる内容は次のとおりです。

- セッション・ステートの参照

- セッション・ステートの設定

- セッション・ステートのクリア

- バインド変数構文について

関連項目:
「アイテム値の参照」

セッション・ステートの参照

リージョン、計算、プロセス、検証およびブランチのセッション・ステートに格納されているアイテム値を参照できます。アイテムはフィールド、テキスト領域、パスワード、選択リスト、チェック・ボックスなどです。表3-3に、アイテム値を参照するためにサポートされている構文を示します。

表3-3 アイテム値を参照するための構文

タイプ

構文

説明

SQL

:MY_ITEM

名前が30文字以下のアイテム用の標準のバインド変数構文を使用します。この構文は、SQL問合せおよびPL/SQL内の参照用に使用します。

PL/SQL

V('MY_ITEM')

Vファンクションを使用してアイテム値を参照するPL/SQL構文を使用します。

関連項目: Oracle Application Express APIリファレンス

PL/SQL

NV('MY_NUMERIC_ITEM')

NVファンクションを使用して数値アイテム値を参照する標準のPL/SQL構文を使用します。

関連項目: Oracle Application Express APIリファレンス

静的テキスト(完全置換)

&MY_ITEM.

静的テキストまたは完全置換の場合は、次のように&ITEM_NAMEにピリオド(.)を続けた表記を使用します。

&MY_ITEM.

セッション・ステートの設定

次のいずれかの方法を使用して、アプリケーションのアイテム値およびセッション・ステートを設定します。

- フォーム送信。「フォーム送信の例」を参照。

- バインド変数。「バインド変数構文について」を参照してください。

- 計算。詳細は、「アプリケーションの計算の理解」を参照してください。

- f?p構文。「f?p構文を使用したページのリンク」を参照。

フォーム送信の例

ページがユーザーによって送信されると、Application Expressエンジンは、フィールド(アイテム)に入力された値をセッション・ステートに自動的に格納します。たとえば、2つのページを持つアプリケーションが存在すると想定します。このアプリケーションの最初のページには、ユーザーが電話番号を入力できるフォームが含まれています。このフォームは、P2_PhoneNoという名前のアイテムを作成して定義しています。2番目のページには、ユーザーがフォームに入力する情報を表示する必要があります。

このページが送信されると、Oracle Application Expressによって、電話番号フィールドに入力された値が取得され、今後使用するためにその値が格納されます。ユーザーが入力した電話番号は、そのページのフィールドに関連付けられたアイテムを参照することで、セッション・ステートから取得できます。

セッション・ステートのクリア

アプリケーションの開発時に、特定のアイテム、ページ上のすべてのアイテム、アプリケーション内のすべてのページ、または現行のユーザー・セッション用にキャッシュされた値をクリアする必要がある場合があります。キャッシュされた値をクリアすると、その値がNULLにリセットされます。次のトピックでは、セッション・ステートをクリアする具体的な例について説明します。

この項に含まれる内容は次のとおりです。

- アイテムごとのキャッシュのクリア

- ページごとのキャッシュのクリア

- アプリケーション全体のキャッシュのクリア

- カレント・ユーザー・セッションのキャッシュのクリア

アイテムごとのキャッシュのクリア

1つのアイテムのキャッシュをクリアすると、そのアイテムの値がNULLにリセットされます。たとえば、ページがレンダリング用に準備されるときに特定のアイテムの値を確実にNULLにしておく必要がある場合に、この方法を使用します。

次の例では、標準f?p構文を使用してアイテムのキャッシュをクリアします。この例では、アプリケーション100のページ5がコールされます。f?p構文のClearCache位置にMY_ITEMを指定すると、MY_ITEMの値がNULLにリセットされます。

f?p=100:5:&APP_SESSION.::NO:MY_ITEM

次の例では、アイテムTHE_EMPNOおよびTHE_DEPTNOの値がリセットされます。

f?p=100:5:&APP_SESSION.::NO:THE_EMPNO,THE_DEPTNO

ページごとのキャッシュのクリア

アプリケーション・アイテムをキャッシュすると、セッション・ステートを効率的に保持できます。ただし、ページ上のすべてのアイテムのキャッシュをクリアする必要がある場合もあります。たとえば、ユーザーが新しい注文を作成するリンクをクリックすると、ページ上のすべてのフィールドがクリアされるようにする必要があると想定します。ページ全体のキャッシュをクリアすることで、ページ上のすべてのアイテムの値をNULLに設定できます。

2つのページのセッション・キャッシュのクリアおよびページ区切りのリセット

この例では、2つのページのセッション・キャッシュがクリアされ、ページ区切りがリセットされます。

f?p=6000:6003:&APP_SESSION.::NO:RP,6004,6014

この例では、次のようになります。

- アプリケーション6000のページ6003が実行され、現行のセッションIDが使用されます。

- デバッグ情報を表示しないように指示されます(NO)。

- カレント・セッションのキャッシュに保持されたページ6004および6014のアイテムのすべての値がクリアされます。

- ページ6003(リクエストされたページ)のリージョンのページ区切り(RP)がリセットされます。

ページのセッション・キャッシュのクリアおよびアイテム値の引渡し

この例では、更新フォームの実装方法を示します。既存の情報をクリアし、アイテムの値(通常、主キー)を設定します。

f?p=6000:6003:&APP_SESSION.::NO:6003:MY_ITEM:1234

この例では、次のようになります。

- アプリケーション6000のページ6003が実行され、現行のセッションIDが使用されます。

- デバッグ情報を表示しないように指示されます(NO)。

- カレント・セッションのキャッシュに保持されたページ6003のアイテムのすべての値がクリアされます。

- MY_ITEMというアイテムのセッション・ステートの値を1234に設定します。

ページのセッション・キャッシュのクリアおよび複数のアイテムに対する値の引渡し

この例は、値が複数のアイテムに渡されること以外は、前述の例に類似しています。

f?p=6000:6004:&APP_SESSION.::NO:6003:MY_ITEM1,MY_ITEM2,MY_ITEM3:1234,,5678

この例では、次のようになります。

- アプリケーション6000のページ6004が実行され、現行のセッションIDが使用されます。

- ページ6003のアイテムのカレント・セッションのキャッシュがクリアされます。

- デバッグ情報を表示しないように指示されます(NO)。

- MY_ITEM1の値が1234、MY_ITEM2の値がNULL(プレースホルダとして使用されたカンマによって示される)およびMY_ITEM3の値が5678に設定されます。

アプリケーション全体のキャッシュのクリア

アプリケーション・キャッシュは、f?p構文を使用し、キーワードAPPを使用してClear Cache引数を作成することでクリアできます。次に例を示します。

f?p=App:Page:Session::NO:APP

注意:
アプリケーション全体のキャッシュをリセットしても、アプリケーションは完全なリセット状態にはリストアされません。たとえば、アプリケーションに新しいインスタンス開始時の計算やプロセスが含まれている場合、Application Expressエンジンは、該当するアプリケーション・セッションが作成されたときに、これらの計算やプロセスを実行します。その後、キャッシュのクリア・リクエストを処理し、リクエストされたページを表示します。
(セッションIDの追跡にCookieが使用されていない場合に)セッションIDを指定せずにアプリケーションを完全にリセットするには、セッションIDを指定せずにURLを使用するか、または別のアプリケーションからAPEX_UTIL.CLEAR_APP_CACHEをコールして、そのアプリケーションをリクエストする必要があります。セッションIDがCookieを使用して追跡される場合、そのステートをリセットするためにログアウトする必要があります。

カレント・ユーザー・セッションのキャッシュのクリア

アプリケーション・キャッシュをクリアするもう1つの方法は、キーワードSESSIONを使用してClear Cache引数を作成することです。次に例を示します。

f?p=6000:6004:12507785108488427528::NO:SESSION

バインド変数構文について

バインド変数構文は、指定したアイテムのセッション・ステートを参照するためにOracle Application ExpressでSQLまたはPL/SQLを使用する場合はいつでも使用できます。次に例を示します。

SELECT * FROM employees WHERE last_name like '%' || :SEARCH_STRING || '%'

この例では、検索文字列がページ・アイテムです。リージョン・タイプがSQL問合せとして定義されている場合、標準SQLバインド変数構文を使用して値を参照できます。バインド変数を使用すると、解析済のSQL問合せがデータベースによって再利用されるため、サーバーによるメモリーの使用が最適化されます。

バインド変数構文を使用する場合は、次の規則に注意してください。

- バインド変数名は、アイテム名に対応している必要があります。

- バインド変数名は、大/小文字が区別されません。

- バインド変数名は、30文字以下である必要があります(有効なOracle識別子である必要があります)。
ページ・アイテム名とアプリケーション・アイテム名は255文字以下に設定できますが、アプリケーション・アイテムをバインド変数構文を使用したSQL内で使用する場合、そのアイテム名は30文字以下で指定する必要があります。

SQL問合せまたはLOVに基づいたリージョンでのバインド変数の使用

リージョン・タイプがSQL問合せ、SQL問合せ(SQL問合せを戻すPL/SQLファンクション本体)、またはLOVとして定義されている場合は、次の構文を使用してセッション・ステートを参照できます。

:MY_ITEM

これを行うための一般的な方法の1つは、セッション・ステート変数をWHERE句に組み込むことです。次の例では、アイテムTHE_DEPTNOの値を、SQL問合せから定義されるリージョンにバインドする方法を示します。

SELECT last_name, job_id, salary
FROM employees
WHERE department_id = :THE_DEPTNO

関連項目:
リージョンを作成する方法については、「リージョンの理解」を参照してください。

PL/SQLプロシージャでのバインド変数の使用

PL/SQLプロシージャとして定義されたタイプのリージョンは、PL/SQL無名ブロック構文を使用して構築されます。つまり、開始キーワードおよび終了キーワードがPL/SQLブロックを囲むために自動的に追加されます。次に例を示します。

IF :P1_JOB IS NOT NULL THEN
INSERT INTO employees (employee_id, first_name, job_id)
VALUES (:P1_EMP_ID, :P1_NAME, :P1_JOB)
end if;

この例では、employee_id、first_nameおよびjob_idの値には、P1_EMP_ID、P1_NAMEおよびP1_JOBの値が移入されます。

置換文字列の理解

ページ・テンプレート内またはリージョン・ソース内で置換文字列を使用すると、文字列を別の値に置換できます。ユーザーによるアイテムの編集を可能にするアプリケーションを設計するには、情報を渡すために置換文字列を使用します。

この項に含まれる内容は次のとおりです。

- 置換文字列の使用

- 組込み置換文字列について

置換文字列の使用

アプリケーション・ビルダーでは、次のように置換文字列を使用できます。

- コンポーネント値を参照するために置換文字列をテンプレート内に含めます。

- &ITEM構文を使用して、ページまたはアプリケーション・アイテムを参照します。

- 組込み置換文字列を使用して、特定のタイプの機能を実現します。

テンプレート内で使用可能な特別な置換文字列は、シャープ記号(#)で示します。次に例を示します。

#ABC#

置換変数を使用してページまたはアプリケーション・アイテムを参照するには、次のステップを実行します。

1. すべて大文字でページまたはアプリケーション・アイテムを参照します。

2. アイテム名の先頭にアンパサンド(&)を追加します。

3. アイテム名の末尾にピリオド(.)を追加します。

たとえば、HTMLリージョン、リージョン・タイトル、アイテム・ラベル、または静的テキストを使用するその他の多数のコンテキストでF101_Xという名前のアプリケーション・アイテムを参照する場合は、次のように入力します。

&F101_X.

最後にピリオドが必要であることに注意してください。Application Expressエンジンは、置換文字列の値をアイテムF101_Xの値に置き換えます。

指定テンプレート内での置換文字列の使用方法の定義

テンプレートの定義を表示することによって、テンプレート固有のどの置換文字列がどのテンプレートでサポートされるかを確認できます。「テンプレートのカスタマイズ」を参照してください。

組込み置換文字列について

アプリケーション・ビルダーでは、多くの組込み置換文字列がサポートされています。これらの値を参照して特定のタイプの機能を実行できます。

次の項では、これらの置換文字列について、使用する状況および現在サポートされている構文を説明します。バインド変数:USERはデータベース内で特別な意味を持つことに注意してください。また、直接PL/SQLという用語は、プロシージャおよびファンクションなどのストアド・データベース・オブジェクトで使用可能なPL/SQLを表します。

この項に含まれる内容は次のとおりです。

- APP_ALIAS

- APP_ID

- APP_IMAGES

- APP_PAGE_ID

- APP_SESSION

- APP_UNIQUE_PAGE_ID

- APP_USER

- AUTHENTICATED_URL_PREFIX

- BROWSER_LANGUAGE

- CURRENT_PARENT_TAB_TEXT

- DEBUG

- HOME_LINK

- LOGIN_URL

- IMAGE_PREFIX

- Application Express SCHEMA OWNER

- PRINTER_FRIENDLY

- LOGOUT_URL

- PROXY_SERVER

- PUBLIC_URL_PREFIX

- REQUEST

- SQLERRM

- SYSDATE_YYYYMMDD

- WORKSPACE_IMAGES

関連項目:

- 静的置換文字列をアプリケーション属性として定義する方法については、「置換」を参照してください。

- 認証については、「認証によるユーザー・アイデンティティの証明」を参照してください。

APP_ALIAS

APP_ALIASは、カレント・アプリケーションの英数字の名前です。APP_ALIASは、APP_IDが1つのデータベースでホスティングされているすべてのワークスペースおよびすべてのアプリケーションで一意である必要があるという点で、APP_IDと異なります。APP_ALIASは、ワークスペース内で一意である必要があります。たとえば、1つのAPP_ALIASを使用して2つの異なるワークスペースにABCというアプリケーションを作成することができます。APP_ALIASは、APP_IDを使用できる場所であればほぼすべての場合に使用できます。たとえば、次の例に示すように、f?p構文にAPP_ALIASまたはアプリケーションIDを使用できます。

f?p=ABC:1:&APP_SESSION.

この例では、アプリケーションABCのページ1が、カレント・セッションを使用して実行されます。

表3-4に、APP_ALIASを参照するためにサポートされている構文を示します。

表3-4 APP_ALIAS構文

参照タイプ

構文

バインド変数

:APP_ALIAS

PL/SQL

V('APP_ALIAS')

置換文字列

&APP_ALIAS.

次に、HTMLの例を示します。

Click me to go to page 1 <a href="f?p=&APP_ALIAS.:1:&APP_SESSION."> of the current application</a>

APP_ID

APP_IDは、現在実行されているアプリケーションのアプリケーションIDを示します。表3-5に、APP_IDを参照するためにサポートされている構文を示します。

表3-5 APP_ID構文

参照タイプ

構文

バインド変数

:APP_ID

直接PL/SQL

APEX_APPLICATION.G_FLOW_ID (A NUMBER)

PL/SQL

NV('APP_ID')

置換文字列

&APP_ID.

次に、置換文字列の参照の例を示します。

f?p=&APP_ID.:40:&APP_SESSION.

APP_IMAGES

この置換文字列を使用して、特定のアプリケーションに固有で、複数のアプリケーションでは共有されていないアップロードされたイメージ、JavaScriptおよびカスケード・スタイルシートを参照します。ファイルをアップロードして、そのファイルをアプリケーション固有に設定した場合は、この置換文字列またはバインド変数を使用する必要があります。表3-6に、APP_IMAGESを参照するためにサポートされている構文を示します。

表3-6 APP_IMAGES構文

参照タイプ

構文

バインド変数

:APP_IMAGES

直接PL/SQL

使用不可。

PL/SQL

V('APP_IMAGES')

置換文字列

&APP_IMAGES.

テンプレート置換

#APP_IMAGES#

関連項目:
「IMAGE_PREFIX」、「WORKSPACE_IMAGES」および「イメージの管理」

APP_PAGE_ID

APP_PAGE_IDはカレント・アプリケーションIDです。たとえば、アプリケーションが3ページ目に存在した場合、結果は3になります。この構文の使用は、複数のアプリケーションで汎用的に動作する必要があるアプリケーション・コンポーネントを記述する場合に有効です。表3-7に、APP_PAGE_IDを参照するためにサポートされている構文を示します。

表3-7 APP_PAGE_ID構文

参照タイプ

構文

バインド変数

:APP_PAGE_ID

PL/SQL

:APP_PAGE_ID

PL/SQLおよび直接PL

NV('APP_PAGE_ID')

置換文字列

&APP_PAGE_ID.

次に、置換文字列の参照の例を示します。

f?p=&APP_ID.:&APP_PAGE_ID.:&APP_SESSION.

APP_SESSION

APP_SESSIONは、最もよく使用される組込み置換文字列の1つです。この置換文字列を使用して、セッション番号を渡すことによりセッション・ステートを維持するアプリケーション・ページ間のハイパーテキスト・リンクを作成できます。APP_SESSIONのかわりに置換文字列SESSIONを使用することもできます。表3-8に、APP_SESSIONを参照するためにサポートされている構文を示します。

表3-8 APP_SESSION構文

参照タイプ

構文

バインド変数

:APP_SESSION

PL/SQL

V('APP_SESSION')

短縮PL/SQL

V('SESSION')

置換文字列

&APP_SESSION.

次に例を示します。

- HTMLリージョン内からの参照:

<a href="f?p=100:5:&APP_SESSION.">click me</a>

- PL/SQLを使用した参照:

htf.anchor('f?p=100:5:'||V('APP_SESSION'),'click me');

- SQL問合せを使用した参照:

SELECT htf.anchor('f?p=100:5:'||:APP_SESSION,'clickme') FROM DUAL;

APP_UNIQUE_PAGE_ID

APP_UNIQUE_PAGE_IDは、各ページ・ビューに固有なOracle順序から生成される整数です。この数値は、アプリケーションでの重複ページの送信を防止するために使用され、その他の用途にも使用できます。たとえば、一意のURLを作成してブラウザのキャッシュの問題を防止するために、この数値を、fプロシージャへのコール内のリクエスト列またはデバッグ列に埋め込むことができます。表3-9に、APP_UNIQUE_PAGE_IDを参照するためにサポートされている構文を示します。

表3-9 APP_UNIQUE_PAGE_ID構文

参照タイプ

構文

バインド変数

:APP_UNIQUE_PAGE_ID

PL/SQL

V('APP_UNIQUE_PAGE_ID')

置換文字列

&APP_UNIQUE_PAGE_ID.

次に、HTMLの例を示します。

SELECT 'f?p=100:1:'||:APP_SESSION||':'||:APP_UNIQUE_PAGE_ID||
':::P1_EMPNO:'||employee_id,
first_name,
job_id
FROM employees

リクエスト列にAPP_UNIQUE_PAGE_IDが使用されていることに注意してください。これによって、このURLが一意になり、ブラウザによる過度のキャッシュの問題を回避できます。

APP_USER

APP_USERは、アプリケーションを実行しているカレント・ユーザーです。認証モデルに応じて、ユーザーの値の設定も異なります。アプリケーションがデータベース認証を使用して実行されている場合、ユーザーの値はデータベースの擬似列USERと同じになります。アプリケーションが、ユーザー認証を必要とする認証スキームを使用する場合、APP_USERの値はその認証スキームによって設定され、通常は、認証時に使用されるユーザー名に設定されます。表3-10に、APP_USERを参照するためにサポートされている構文を示します。

表3-10 APP_USER構文

参照タイプ

構文

バインド変数

:APP_USER

PL/SQL

V('APP_USER')

置換文字列

&APP_USER.

次に例を示します。

- HTMLリージョン内からの参照:

Hello you are logged in as &APP_USER.

- PL/SQLを使用した参照:

htp.p('Hello you are logged in as'||V('APP_USER'));

- バインド変数としての参照:

SELECT * FROM some_table WHERE user_id = :APP_USER

関連項目:
パブリック・ユーザー属性の詳細は、「認証」を参照してください。

AUTHENTICATED_URL_PREFIX

このアプリケーション・レベルの属性は、有効な認証済接頭辞(ログインしているURLの接頭辞)を示します。相対パスまたはhttpで始まるフルパスを使用できます。このアイテムは、アプリケーションが認証済(ログイン済)モードとパブリック(未ログイン)・モードの両方で実行可能な場合に有効です。AUTHENTICATED_URL_PREFIXを使用すると、認証済のページへのリンクを作成できます。このアイテムは、Basicデータベース認証の使用時に最も有効です。これは、URLの変更に認証が必要になる場合があるためです。表3-11に、AUTHENTICATED_URL_PREFIXを参照するためにサポートされている構文を示します。

表3-11 AUTHENTICATED_URL_PREFIX構文

参照タイプ

構文

バインド変数

:AUTHENTICATED_URL_PREFIX

PL/SQL

V('AUTHENTICATED_URL_PREFIX')

置換文字列

&AUTHENTICATED_URL_PREFIX.

BROWSER_LANGUAGE

BROWSER_LANGUAGEは、Webブラウザの現行の言語プリファレンスを参照します。表3-12に、BROWSER_LANGUAGEを参照するためにサポートされている構文を示します。

表3-12 BROWSER_LANGUAGE構文

参照タイプ

構文

バインド変数

:BROWSER_LANGUAGE

直接PL/SQL

APEX_APPLICATION.G_BROWSER_LANGUAGE

PL/SQL

V('BROWSER_LANGUAGE')

置換文字列

:BROWSER_LANGUAGE.

置換文字列

&BROWSER_LANGUAGE.

CURRENT_PARENT_TAB_TEXT

CURRENT_PARENT_TAB_TEXTは、ページ・テンプレートで最も有効です。ただし、この文字列は、2つのレベルのタブ(親タブと標準タブ)が使用されるアプリケーションでのみ使用できます。この文字列は、親タブ・ラベルの参照に使用します。この置換文字列を使用すると、現在選択されている親タブを、ページ・テンプレート内で繰り返すことができます。表3-13に、CURRENT_PARENT_TAB_TEXTを参照するためにサポートされている構文を示します。

表3-13 CURRENT_PARENT_TAB_TEXT構文

参照タイプ

構文

バインド変数

使用不可。

置換文字列

&CURRENT_PARENT_TAB_TEXT.

DEBUG

DEBUGフラグの有効値はYesまたはNoです。デバッグを有効にすると、アプリケーション・プロセスの詳細が表示されます。カスタム・コードを記述する場合は、デバッグ・モードがYesに設定されている場合にのみデバッグ情報を生成できます。表3-14に、DEBUGを参照するためにサポートされている構文を示します。

表3-14 DEBUG構文

参照タイプ

構文

バインド変数

:DEBUG

直接PL/SQL

APEX_APPLICATION.G_DEBUG

PL/SQL

V('DEBUG')

置換文字列

&DEBUG.

次に、DEBUGの現行の値を保持する置換文字列の参照の例を示します。

f?p=100:1:&APP_SESSION.::&DEBUG

HOME_LINK

HOME_LINKは、アプリケーションのホームページです。ページが指定されておらず、かつ認証スキームのロジックによって代替ページが指定されていない場合、Application Expressエンジンによって、この場所にリダイレクトされます。ホーム・リンクはアプリケーション属性ページに定義します。

表3-15に、HOME_LINKを参照するためにサポートされている構文を示します。

表3-15 HOME_LINK構文

参照タイプ

構文

直接PL/SQL

APEX_APPLICATION.G_HOME_LINK

PL/SQL

V('HOME_LINK')

テンプレート参照

#HOME_LINK#

置換文字列

&HOME_LINK.

関連項目:
ホーム・リンク属性については、「認証」を参照してください。

LOGIN_URL

現在ログインしていないユーザー用のログイン・ページへのリンクを表示するには、LOGIN_URLを使用します。表3-16に、LOGIN_URLを参照するためにサポートされている構文を示します。

関連項目:
「認証」および「セキュリティ属性ページについて」

表3-16 LOGIN_URL構文

参照タイプ

構文

バインド変数

:LOGIN_URL

直接PL/SQL

APEX_APPLICATION.G_LOGIN_URL

PL/SQL

V('LOGIN_URL')

置換文字列

&LOGIN_URL.

テンプレート置換

#LOGIN_URL#

IMAGE_PREFIX

IMAGE_PREFIXの値によって、Oracle Application Expressによって配布されたイメージ・ディレクトリを指すためにWebサーバーが使用する仮想パスが決まります。アップロードされたイメージを参照する場合は、WORKSPACE_IMAGESおよびAPP_IMAGESを使用します。表3-17に、IMAGE_PREFIXを参照するためにサポートされている構文を示します。

関連項目:
「APP_IMAGES」、「WORKSPACE_IMAGES」および「アプリケーション定義の構成」

表3-17 IMAGE_PREFIX構文

参照タイプ

構文

バインド変数

:IMAGE_PREFIX

直接PL/SQL

APEX_APPLICATION.G_IMAGE_PREFIX

PL/SQL

V('IMAGE_PREFIX')

置換文字列

&IMAGE_PREFIX.

テンプレート置換

#IMAGE_PREFIX#

Application Express SCHEMA OWNER

PL/SQLコードからアプリケーションへのコールを生成する場合、Oracle Application Expressスキーマの所有者を参照する必要がある場合があります。次に、直接PL/SQLの参照用の適切な構文を示します。

APEX_APPLICATION.G_FLOW_SCHEMA_OWNER

また、#FLOW_OWNER#を使用してSQL問合せおよびPL/SQL(リージョンやプロセスなど)でこの値を参照することもできます。

PRINTER_FRIENDLY

PRINTER_FRIENDLYの値によって、Application Expressエンジンが印刷表示モードで実行するかどうかが決まります。この設定は、印刷されたドキュメントに不要な要素をページから排除するための条件で参照できます。表3-18に、PRINTER_FRIENDLYを参照するためにサポートされている構文を示します。

表3-18 PRINTER_FRIENDLY構文

参照タイプ

構文

直接PL/SQL

APEX_APPLICATION.G_PRINTER_FRIENDLY (VARCHAR2 DATATYPE)

PL/SQL

V('PRINTER_FRIENDLY')

置換文字列

&PRINTER_FRIENDLY.

LOGOUT_URL

LOGOUT_URLはアプリケーション・レベルの属性であり、ログアウトURLの指定に使用されます。これは、ユーザーをログアウト・ページにナビゲートさせるか、またはオプションで直接ユーザーをログアウトさせるURLです。ログアウト・ナビゲーション・バー・エントリを作成するには、&LOGOUT_URLの最後にピリオドを追加します(&LOGOUT_URL.)。ページ・テンプレートをコーディングしている場合は、#LOGOUT_URL#を使用します。表3-19に、LOGOUT_URLを参照するためにサポートされている構文を示します。

表3-19 LOGOUT_URL構文

参照タイプ

構文

バインド変数

:LOGOUT_URL

PL/SQL

V('LOGOUT_URL')

置換文字列

&LOGOUT_URL.

テンプレート置換

#LOGOUT_URL#

PROXY_SERVER

PROXY_SERVERは、アプリケーション属性です。この属性は、ソースがURLであるリージョンによって使用される場合があります。次に、直接PL/SQL参照用の適切な構文を示します。この参照は、データベースからリモートWebサーバーにアクセスするためのPL/SQLを記述する場合に使用します(たとえば、データベースに付属するutl_httpパッケージを使用する場合)。

APEX_APPLICATION.G_PROXY_SERVER

PUBLIC_URL_PREFIX

PUBLIC_URL_PREFIXは、アプリケーション・レベルの属性であり、ログイン・モードをパブリック表示に切り替えるURLを指定します。表3-20に、PUBLIC_URL_PREFIXを参照するためにサポートされている構文を示します。

表3-20 PUBLIC_URL_PREFIX構文

参照タイプ

構文

バインド変数

:PUBLIC_URL_PREFIX

PL/SQL

V('PUBLIC_URL_PREFIX')

置換文字列

&PUBLIC_URL_PREFIX.

テンプレート置換

#PUBLIC_URL_PREFIX#

REQUEST

REQUESTの値は、各アプリケーション・ボタンによって、そのボタンの名前またはそのボタンに関連付けられているリクエスト値属性に設定されます。これによって、ユーザーがボタンをクリックしたときに、受入れプロセスでそのボタンの名前が参照されるようになります。f?p構文では、REQUESTは4つ目の引数を使用して設定できます。

REQUESTの値の参照

REQUESTは、通常、受入れプロセス(ページのポスト時に発生するプロセス)中に参照されます。表3-21に、REQUESTを参照するためにサポートされている構文を示します。

表3-21 REQUEST構文

参照タイプ

構文

バインド変数

:REQUEST

直接PL/SQL

APEX_APPLICATION.G_REQUEST

PL/SQL

V('REQUEST')

置換文字列

&REQUEST

&REQUEST. (構文の完全一致)

ポストされたページのREQUESTの有効範囲および値

ページをポストすると、受入れプロセスが起動されます。受入れプロセスは、計算、検証、プロセスおよびブランチで構成されています。REQUESTの値は、受入れプロセスの各フェーズで使用可能です。アプリケーションが別のページにブランチされると、REQUESTはNULLに設定されます。

REQUESTの値は、ユーザーがクリックするボタンの名前か、またはユーザーが選択するタブの名前です。たとえば、名前がCHANGEでラベルがApply Changeというボタンがあるとします。ユーザーがこのボタンをクリックすると、REQUESTの値がCHANGEになります。

「対象ボタン」属性について

検証、プロセスおよびブランチには「対象ボタン」属性があります。この属性は、選択リストとして表示され、カレント・ページにあるボタン名を含みます。「対象ボタン」から選択した場合、ボタンのREQUEST値を検証、プロセスまたはブランチに関連付けます。

ページの送信にボタンを使用する場合、REQUEST値がページに渡されます。受入れプロセス・ロジックにより、「対象ボタン」属性を使用する各検証、プロセスおよびブランチが評価され、コンポーネントを実行(起動)するかどうかが決定されます。コンポーネントの1つが実行される場合、関連付けられたボタンをユーザーが実際にクリックしてページが送信されたとはみなさないでください。同じリクエスト値を使用する別のボタンがページを送信した可能性があります。同様に、ページのJavaScriptもページを送信してリクエスト値を渡します。

宣言条件を使用したREQUESTの参照

REQUESTは、通常、条件を使用して参照されます。たとえば、ユーザーがレポート・ページ上の「実行」をクリックしたときにページ区切りをリセットする必要がある場合があります。ページ区切りは、送信時ページ・プロセスを作成してリセットできます。ページ・プロセスには、条件「リクエスト=式1」を使用して条件を付けることができます。

送信時ページ・プロセスに条件を設定するには、次のステップを実行します。

1. 「条件」で、条件タイプ「リクエスト=式1」を選択します。

2. 式1で「実行」を実行します。

表示プロセスでのREQUESTの使用

REQUESTは、f?p構文を使用してページに移動するときの表示プロセスにも使用できます。次に例を示します。

f?p=100:1:&APP_SESSION.:GO

f?p構文の4つ目の引数がREQUESTです。この例では、カレント・セッションのアプリケーション100のページ1に移動し、REQUESTの値がGOに設定されます。すべてのプロセスまたはリージョンでは、表示プロセスを使用してREQUESTの値を参照できます。

次に、PL/SQLを使用した同様の例を示します。

IF V ('REQUEST') = 'GO' THEN
htp.p('hello');
END IF;

htp.p('hello')は、特定のテキスト文字列を出力するためのPL/SQL Webツールキット・パッケージへのコールであることに注意してください。

関連項目:

- PL/SQLを使用したWebアプリケーションの開発の詳細は、Oracle Databaseアドバンスト・アプリケーション開発者ガイドを参照してください。

- htpパッケージの詳細は、『Oracle Database PL/SQLパッケージおよびタイプ・リファレンス』を参照してください。

SQLERRM

SQLERRMは、アプリケーション・リージョン・エラー・メッセージでのみ使用可能なテンプレート置換です。次に、リージョン・テンプレート置換の参照用の適切な構文を示します。

#SQLERRM#

SYSDATE_YYYYMMDD

SYSDATE_YYYYMMDDは、データベース・サーバーの現在の日付にYYYYMMDD書式マスクを適用して表示します。この値を、SYSDATE()ファンクションを繰り返しコールするかわりに使用できます。次のリストに、SYSDATE_YYYYMMDDを参照するためにサポートされている構文を示します。

- バインド変数

:SYSDATE_YYYYMMDD

- PL/SQL

V('SYSDATE_YYYYMMDD')

- 直接PL/SQL

APEX_APPLICATION.G_SYSDATE (DATE DATATYPE)

表3-22 SYSDATE_YYYYMMDD構文

参照タイプ

構文

バインド変数

:SYSDATE_YYYYMMDD

直接PL/SQL

APEX_APPLICATION.G_SYSDATE (DATE DATATYPE)

PL/SQL

V('SYSDATE_YYYYMMDD')

WORKSPACE_IMAGES

この置換文字列を使用して、ワークスペース内の複数のアプリケーションで共有されているアップロードされたイメージ、JavaScriptおよびカスケード・スタイルシートを参照します。表3-23に、WORKSPACE_IMAGESを参照するためにサポートされている構文を示します。

表3-23 WORKSPACE_IMAGES構文

参照タイプ

構文

バインド変数

:WORKSPACE_IMAGES

直接PL/SQL

使用不可

PL/SQL

V('WORKSPACE_IMAGES')

置換文字列

&WORKSPACE_IMAGES.

テンプレート置換

#WORKSPACE_IMAGES#

関連項目:
「APP_IMAGES」および「IMAGE_PREFIX」

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

このセクションでは、アプリケーション・ビルダーを使用して動的にレンダリングされるアプリケーションを構築する方法について、重要なバックグラウンド情報を説明します。

この項には、次の項目が含まれます。

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

- アプリケーション・ビルダーのホームページについて

- アプリケーションのホームページについて

- アプリケーション属性について

関連項目:
「クイック・スタート」、「アプリケーション・ビルダーの概念」、「アプリケーションの構築」、「ページ・レイアウトの制御」および「ナビゲーションの追加」

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

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

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

1. Oracle Application Expressにログインします。
ワークスペースのホームページが表示されます。

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

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

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

注意:
統一を図るため、このドキュメントでは、ナビゲーションを説明する際にプライマリ・ナビゲーション・パス(ドリルダウン方式)を使用します。

アプリケーション・ビルダーのホームページについて

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

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

- アプリケーション: 「アプリケーション」フィールドは、アプリケーションを検索する際に使用します。大/小文字を区別しないアプリケーション名またはアプリケーションIDで問合せを入力し、「実行」をクリックします。すべてのアプリケーションを表示する場合は、このフィールドを空白のままにして「実行」をクリックします。

- グループ: 「グループ」フィールドは、アプリケーション・グループを検索する際に使用します。アプリケーション・グループを選択して「実行」をクリックします。「アプリケーション・グループの作成」を参照してください。

- ビュー:このコントロールは、ワークスペース内のアプリケーションに関する情報の表示に使用します。リストから選択して「実行」をクリックします。使用可能なオプションは次のとおりです。

- アイコン(デフォルト): 各アプリケーションをアプリケーション名で識別される大きいアイコンとして表示します。

- 詳細: 各アプリケーションをレポートで1行に表示します。各行には、アプリケーションID、アプリケーション名、アプリケーションの最終更新日、ページ・カウントおよびアプリケーションの最終更新者が含まれます。

- グループ別: アプリケーション・グループ別にアプリケーションを表示します。

- 表示: ページに表示するアプリケーションの数を決定します。表示を変更するには、リストから選択して「実行」をクリックします。

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

- インポート: 「インポート」をクリックすると、エクスポートされたアプリケーション・ファイルがインポートされます。詳細は、「エクスポート・ファイルのインポート」を参照してください。

- 作成: 「作成」をクリックすると、アプリケーションが作成されるか、デモンストレーション・アプリケーションがインストールされます。詳細は、「デモンストレーション・アプリケーションのインストール」および「ウィザードを使用したアプリケーションの作成について」を参照してください。

「タスク」リストについて

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

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

- アプリケーション・ビルダーのデフォルト値: アプリケーション・ビルダーのデフォルト値の管理ページにリンクします。Oracle Application Express管理ガイドの「アプリケーション・ビルダーのデフォルト値の利用」を参照してください。

- 開発者のプリファレンス: 開発者のプリファレンス・ページにリンクします。「「開発者のプリファレンス」の構成」を参照してください。

- ユーザー・インタフェースのデフォルト値: ユーザー・インタフェースのデフォルト値ページにリンクします。「ユーザー・インタフェースのデフォルト値の管理」を参照してください。

- アプリケーション・グループ: アプリケーション・グループ・ページにリンクします。「アプリケーション・グループの作成」を参照してください。

- ワークスペース・テーマ: ワークスペース・テーマ・ページにリンクします。「テーマの管理」を参照してください。

- エクスポート・リポジトリ: エクスポート・リポジトリ・ページにリンクします。「エクスポート・ファイルのインポート」を参照してください。

最近のリストについて

「最近」リストには、最近表示されたアプリケーションへのリンクが含まれます。

「開発者のプリファレンス」の構成

アプリケーション・ビルダーの多くのページには、ページ上部にナビゲーション・バーが含まれています。ナビゲーション・バーの制御を使用して、表示の外観をカスタマイズできます。ほとんどのナビゲーション・バーには「ビュー」および「表示」リストが含まれています。開発者のプリファレンス・ページで両方のリストのデフォルト表示を制御できます。

開発者プリファレンスを編集するには、次のステップを実行します。

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

2. 「タスク」リストから「開発者のプリファレンス」をクリックします。

3. 「ビュー・モードの設定」から次のいずれかの項目を選択します。

- 「アイコン」(デフォルト)は、ページ上のアイテムを大きいアイコンとして表示します。

- 「詳細」は、ページ上のアイテムをレポートに1行で表示します。

4. 「レポート行」で、表示するアイテム番号を選択します。

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

アプリケーションのホームページについて

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

関連項目:
「アプリケーション定義の構成」

続いて、次の大きいアイコンが表示されます。

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

- サポートするオブジェクト: サポートするオブジェクト・ページにリンクします。「パッケージ・アプリケーションの作成方法」を参照してください。

- 共有コンポーネント: アプリケーション内のすべてのページに表示または適用できる共有コンポーネントおよびユーザー・インタフェース・コントロールのリストにリンクします。詳細は、「共有コンポーネントでの作業」を参照してください。

- エクスポート/インポート: エクスポート/インポート・ウィザードにリンクします。このウィザードを使用して、アプリケーション全体のインポートとエクスポート、およびカスケード・スタイルシート、イメージ、静的ファイル、スクリプト・ファイル、テーマ、ユーザー・インタフェースのデフォルト値、ワークスペース・ユーザーなどの関連ファイルのインポートとエクスポートを行うことができます。詳細は、「アプリケーションおよび関連ファイルのエクスポート」を参照してください。

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

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

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

- 「ページ」。「ページ」フィールドに大/小文字を区別しないキーワードまたは文字列を入力し、「実行」をクリックして、ページ番号やページ名を検索できます。アプリケーションのすべてのページを表示するには、「ページ」フィールドを空のままにして「実行」をクリックします。表示するページ数を「表示」リストから選択して制御します。

- 「表示」。デフォルトでは、各ページが大きいアイコンで表示されます。「ビュー」リストから選択し、「実行」をクリックして、ページの外観を変更できます。詳細は、「ページの表示方法の理解」を参照してください。

- 「表示」。表示するページ数を決定します。表示するページ数を変更するには、「表示」リストから選択して「実行」をクリックします。

「ページの作成」ボタンは、ナビゲーション・バーの右側に表示されます。「ページの作成」をクリックするとウィザードが起動し、ページを順を追って作成できます。「アプリケーション内のページの管理」を参照してください。

関連項目:
「アクション・バーについて」

「タスク」リストについて

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

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

- このアプリケーションの削除: カレント・アプリケーションを削除します。詳細は、「アプリケーションの削除」を参照してください。

- このアプリケーションのコピー: カレント・アプリケーションのコピーを作成します。詳細は、「アプリケーションのコピー」を参照してください。

- ページ・グループ: ページ・グループ・ページにリンクします。ページをページ・グループとして編成すると、アプリケーション内のページに簡単にアクセスできるようになります。「ページのグループ化」を参照してください。

- ページ・ロック: ロックされたページ・ページにリンクします。アプリケーションのページをロックすると、アプリケーション開発中の競合を回避できます。「ページのロックおよびロック解除」を参照してください。

- ユーザー・インタフェースのデフォルト値: ユーザー・インタフェースのデフォルト値ページにリンクします。「ユーザー・インタフェースのデフォルト値の管理」を参照してください。

- エクスポート・リポジトリ: エクスポート・リポジトリ・ページにリンクします。「エクスポート・ファイルのインストール」を参照してください。

- アプリケーション・レポート: アプリケーション・レポート・ページにリンクします。このページは、アプリケーション固有のレポートを表示する際に使用します。「アプリケーション・レポートの表示」を参照してください。

ページの表示方法の理解

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

- アイコン

- 詳細

- グループ別

- タイプ別

「アイコン」モード(デフォルト)は、各ページにページ名で識別された大きなアイコンとして表示されます。ページを表示するには、アイコンをクリックしてください。

関連項目:
「最近のリスト」

「詳細」モードは、各ページにレポートの行として表示されます。各行にはページ番号、ページ名、ページの最新更新時、ページ・タイプ、更新者、関連グループおよびロック・ステータスが含まれます。ページを表示するには、ページ名をクリックしてください。「ロック」アイコンを使用すると、アプリケーション開発中の競合を回避できます。「実行」アイコンをクリックすると、関連ページが実行され、表示可能なHTMLがレンダリングされます。

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

「グループ別」に、現在定義済のページ・グループが表示されます。ページ・グループを使用してアプリケーション内のページを編成および管理できます。「ページのグループ化」を参照してください。

「タイプ別」では、「ログイン」、「レポート」、「表形式フォーム」、「動的フォーム」、「チャート」などのカテゴリにページが分割されます。各ページ・カテゴリ内のページ数が、タイプ名の右のカッコ内に表示されます。ページを表示するには、ページ・タイプをクリックし、次にページをクリックします。

最近のリストについて

最近のリストには、カレント・アプリケーション内の最近表示されたページへのリンクが含まれます。このリストは、「アイコン」モードにアプリケーションのホームページが表示されるときのみ表示されます。

アクション・バーについて

アクション・バーには、アプリケーション・ビルダーのほとんどのページの右上隅にある「ユーティリティ」タブの上に表示されます。

このバーには、後続のセクションで説明されるアイコンが含まれます。「ページの実行」アイコン、「ページの編集」アイコン、「開発者のコメント」アイコンおよび「検索」アイコンは、共有コンポーネントを作成および管理するページなど、アプリケーション・ビルダーの多くのページに表示されることに注意してください。「共有コンポーネントでの作業」を参照してください。

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

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

「編集」アイコン

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

「共有コンポーネント」アイコン

「共有コンポーネント」アイコンは、小さな機械の歯車のような形をしています。このアイコンをクリックすると、アプリケーション内のすべてのページに表示または適用できる共有コンポーネントおよびユーザー・インタフェース・コントロールのリストが表示できます。「共有コンポーネントでの作業」を参照してください。

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

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

「検索」アイコン

「検索」アイコンは懐中電灯の形をしています。このアイコンをクリックすると、カレント・アプリケーション内のアイテム、ページ、問合せ、表、PL/SQL、イメージおよびカスケード・スタイルシート(CSS)またはワークスペースに関連付けられたスキーマを検索できます。「「検索」アイコンの使用」を参照してください。

アプリケーション属性について

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

この項に含まれる内容は次のとおりです。

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

- セキュリティ属性の構成

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

関連項目:
サポートするオブジェクト・ユーティリティを使用したパッケージ・アプリケーションの作成方法の詳細は、「パッケージ・アプリケーションの作成方法」を参照してください。

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

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

この項に含まれる内容は次のとおりです。

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

- 定義の編集ページについて

Edit Definitionページへのアクセス

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

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

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

3. 「共有コンポーネント」をクリックします。
共有コンポーネント・ページが表示されます。

4. 「アプリケーション」で、「定義」をクリックします。
定義の編集ページが表示されます。

ヒント:
アプリケーションのホームページの上部で、アプリケーション名をクリックしても、定義の編集ページにアクセスできます。

ナビゲーションの選択肢について

定義の編集ページは、「名前」、「可用性」、「グローバル通知」、「サブスクリプション」、「ロゴ」、「ビルド・オプション」、「テーマ」、「テンプレートのデフォルト」および「コンポーネントのデフォルト値」の各セクションから構成されます。これらのセクションにアクセスするには、ページをスクロール・ダウンするか、ページ上部のナビゲーション・ボタンをクリックします。

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

Edit Definitionページについて

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

この項に含まれる内容は次のとおりです。

- 名前

- 可用性

- グローバル通知

- 置換

- ロゴ

- ビルド・オプション

- テーマ

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

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

名前

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

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

属性

説明

名前

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

アプリケーションの別名

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

- f?p=105:1

- f?p=myapp:1

関連項目: 「f?p構文を使用したページのリンク」

バージョン

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

- YYYY.MM.DD

- MM.DD.YYYY

- DD.MM.YYYY

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

メディア・タイプ

インターネット・メディア・タイプを入力します。インターネット・メディア・タイプは、2つの部分で構成される、インターネット上のファイル形式を表す識別子です。メディア・タイプは、少なくともタイプとサブタイプの2つの部分で構成され、オプションで1つ以上のパラメータを指定します。メディア・タイプは、ページ描画の際にHTTPヘッダーのContent-Typeで使用されます。

ページ・レベルのメディア・タイプが、アプリケーション・レベルのメディア・タイプを上書きします。この属性のデフォルト値はNULLです。ページ・レベルとアプリケーション・レベルの両方でメディア・タイプの値がNULLの場合、メディア・タイプとしてtext/htmlが使用されます。

イメージ接頭辞

アプリケーション・ビルダーによって分散されたイメージ・ディレクトリを指すために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

アプリケーション・グループ

このアプリケーションに現在関連付けられているアプリケーション・グループを表示します。別のアプリケーション・グループを選択するには、リストから選択します。既存のグループからアプリケーションを削除するには、「未割当て」を選択します。

参照: 「アプリケーション・グループの作成」

関連項目:
「置換文字列の理解」および「リンク・ページへのf?p構文の使用」

可用性

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

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

属性

説明

ステータス

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

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

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

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

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

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

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

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

関連項目: Oracle Application Express管理ガイドの「複数のアプリケーションのビルド・ステータスの変更」と「デプロイ時のアプリケーションのビルド・ステータス・セットの変更」、および「アプリケーション、ページおよびページ・コンポーネントへのアクセスの制御」

ビルド・ステータス

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

- アプリケーションの実行および構築: 開発者とユーザーのどちらもアプリケーションを実行および開発できます。

- アプリケーションの実行のみ: ユーザーはアプリケーションの実行のみが可能です。このオプションは、本番インスタンスのアプリケーション用です。

関連項目: Oracle Application Express管理ガイドの「デプロイ時のアプリケーションのビルド・ステータス・セットの変更」

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

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

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

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

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

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

グローバル通知

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

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

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

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

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

関連項目:
「置換文字列の理解」および「ページ・テンプレート」

置換

これらのフィールドは、アプリケーションで使用する静的置換文字列を定義する際に使用します。アプリケーション内の多くの場所に出現する文字列やラベルに静的置換文字列を使用できます。置換文字列を作成するには、「置換文字列」列に文字列名を、「置換値」列に文字列値を入力します。

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

関連項目:
「置換文字列の理解」

ロゴ

「ロゴ」属性は、アプリケーション・ロゴを定義する際に使用します。アプリケーション・ロゴは、テキスト・ベースにもイメージ・ベースにもできます。この機能を使用するには、ページ・テンプレートに#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. 「セキュリティ」で、「セキュリティ属性の編集」をクリックします。

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

ナビゲーションの選択肢について

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

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

Security Attributesページについて

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

この項に含まれる内容は次のとおりです。

- 認証

- 認可

- データベース・スキーマ

- セッション・タイムアウト

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

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

認証

認証は、ユーザーがアプリケーションにアクセスする前に、そのユーザーの本人確認を行うプロセスです。アプリケーションに対して複数の認証スキームを定義しても、一度にカレントに設定できるスキームは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コマンドが、定義したデータベース・スキーマの権限で実行されます。

セッション・タイムアウト

オープンWebブラウザで、取り消されたコンピュータにアプリケーションが公開される時間を短くするには、次の属性を使用します。

- 最大セッションの長さ - このアプリケーションが使用するセッションが何秒間存在するかを示す正の整数を入力します。値をNULLのままにすると、セッションが無期限に存在します。このセッション継続時間は、8時間ごとに実行され、24時間より前から存在するセッションを削除するジョブの操作によって破棄されます。

- セッション・タイムアウトURL - 「最大セッションの長さ」を超えた場合にリダイレクト先となるオプションのURLを入力します。Oracle Application Expressに実装されている場合は、このURLのターゲット・ページが公開ページになります。このページの一般的な用途は、ユーザーにセッションの有効期間を知らせ、ログイン・リンクや他のオプションを表示することです。URLを指定しない場合、リダイレクト先はアプリケーションのホームページになります。

- 最大セッション・アイドル時間 - このアプリケーションが使用するセッションで、何秒間の停止時間またはアイドル時間を許可するかを示す正の整数を入力します。アイドル時間は、あるページ・リクエストと次のページ・リクエストとの間の時間です。値をNULLのままにすると、セッションのアイドル時間のチェックは行われません。

- アイドル・タイムアウトURL - 「最大セッション・アイドル時間」を超えた場合にリダイレクト先となるオプションのURLを入力します。Oracle Application Expressに実装されている場合は、このURLのターゲット・ページが公開ページになります。このページの一般的な用途は、ユーザーにセッションがアプリケーションのホームページにリダイレクトされることを知らせることです。URLを指定しない場合、リダイレクト先はアプリケーションのホームページになります。

関連項目:
「セッション・タイムアウトの理解」およびOracle Application Express管理ガイドの「セッション・タイムアウトの構成」

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

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

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

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

関連項目:
「セッション・ステート保護の理解」

Virtual Private Database(VPD)

この属性を使用して、現在の「ページの表示」または「ページの受入れ」リクエストに関連付けられた現在のデータベース・セッションに対して仮想プライベート・データベース(VPD)のコンテキストを設定するPL/SQLブロックを入力します。ここに入力したブロックは、ページ・リクエスト時の非常に早い段階(APP_USER値が確立された直後)で実行されます。APP_USERの値(:APP_USERまたはv('APP_USER')を使用)をブロック内で使用できます。セッション・ステート内の他のアイテムの値も参照できますが、これらのアイテムは現在のページ・リクエストが開始する前にセッション・ステートに確立されている必要があります。次に例を示します。

dbms_session.set_context('CTX_USER_QRY','USERPRIV',my_package.my_function(:APP_USER));

前の例では、CTX_USER_QRYという名前のコンテキストでUSERPRIVの値を、my_packageパッケージのmy_functionファンクションによって戻された値に設定します。ファンクションには、入力引数としてAPP_USERの現行の値が渡されます。多くの場合、認証済ユーザーに適した条件の生成を有効にするために、(アプリケーションの解析スキーマ内で作成されている) VPDポリシーで名前付きコンテキストが使用されます。

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

このセクションに入力したコードをVPD/FGACに関連付ける必要はありません。実際、このコードはセキュリティに関連付けられません。ページ・リクエストの最初の時点で実行する必要があるコードは、すべてここに指定できます。たとえば、各ページ・リクエストに対してデータベース・セッションのタイムゾーンを設定するには、次のように指定します。

BEGIN
EXECUTE IMMEDIATE 'alter session set time_zone = ''Australia/Sydney'' ';
END;

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

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

アプリケーション・ビルダーでは、異なる言語で同時に実行可能なアプリケーションを開発できます。1つのアプリケーションを、異なる言語をサポートするよう変換できます。グローバリゼーション属性の編集ページの属性を使用して、プライマリ・アプリケーション言語などのグローバリゼーション・オプションを指定します。

この項に含まれる内容は次のとおりです。

- グローバリゼーション属性のページへのアクセス

- グローバリゼーション属性の編集ページについて

関連項目:
「アプリケーションのグローバリゼーションの管理」

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

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

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

2. アプリケーションを選択します。
アプリケーション・ビルダーのホームページが表示されます。

3. 「共有コンポーネント」をクリックします。
共有コンポーネント・ページが表示されます。

4. 「グローバリゼーション」で、「属性の編集」をクリックします。
グローバリゼーション属性の編集ページが表示されます。

グローバリゼーション属性の編集ページについて

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

関連項目:
「アプリケーションへのプライマリ言語の指定」

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

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

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

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

アプリケーション・ビルダーでのアプリケーション言語の特定または導出の方法を決定します。

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

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

アプリケーション日付書式

アプリケーションで使用する日付書式を決定します。

この日付書式を使用して、NLS_DATE_FORMATデータベース・セッションの設定が変更されてから、アプリケーション内のページが表示または送信されます。この値には、有効なOracle日付書式マスクを含むリテラル文字列、または置換構文を使用したアイテム参照を指定できます。値が指定されていない場合は、データベース・セッションからデフォルトの日付書式が実行時に取得されます。

自動CSVエンコーディング

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

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

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

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

関連項目:
「クラシック・レポートへのダウンロード・リンクの追加」

5 アプリケーション・ページの操作

このセクションでは、アプリケーション内でページを作成して管理する方法について、重要なバックグラウンド情報を説明します。

この項には、次の項目が含まれます。

- ページ定義について

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

- ページ定義の編集

- ページ属性の編集

- 開発者ツールバーについて

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

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

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

関連項目:
「クイック・スタート」、「アプリケーション・ビルダーの概念」、「アプリケーションの構築」、「ページ・レイアウトの制御」および「ナビゲーションの追加」

ページ定義について

ページ定義は、ページの基本的な構成要素です。各ページはボタンとフィールド(アイテムと呼ばれる)を保持でき、これらのボタンとフィールドはリージョンと呼ばれるコンテナにグループ化されます。ページはアプリケーション・ロジック(プロセス)も保持できます。条件付きナビゲーションを使用したあるページから別のページへのブランチや、(計算と呼ばれる)計算の実行、(編集チェックなどの)検証の実行、レポート、カレンダおよびチャートの表示が可能です。ページ定義にアクセスして、ページを定義するコントロールの表示、作成および編集ができます。

この項に含まれる内容は次のとおりです。

- ページ定義へのアクセス

- ページ定義の理解

関連項目:
「ページ定義での「ビュー」リストの使用」、「ページ定義の編集」、「ページ属性の編集」および「「ページ・ファインダ」の使用」

ページ定義へのアクセス

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

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

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

2. アプリケーションを選択します。
アプリケーションのホームページが表示されます。

3. ページを選択します。
ページ定義が表示されます。

関連項目:
「ページ・ファインダ」の使用

ページ定義の理解

ページ定義は、ページの基本的な構成要素です。ページ定義を使用して、ページを定義するコントロールやアプリケーション・ロジックを表示、作成および編集できます。この後のセクションで、ページ定義の各部分を説明します。

この項に含まれる内容は次のとおりです。

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

- アクション・バーについて

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

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

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

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

- ページ: 現在のページ番号を表示します。別のページを表示するには、「ページ」フィールドにページ番号を入力して、「実行」をクリックします。

- 「戻る」および「次へ」:これらのボタンは、小なり(<)記号と大なり(>)記号の形をしています。これらのボタンをクリックすると、前のページや次のページに移動します。

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

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

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

- コピー: カレント・ページのコピーを作成します。ページ番号とページ名を指定してください。

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

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

関連項目:
「アプリケーション内のページの管理」および「ページまたはアプリケーションの実行」

アクション・バーについて

アクション・バーには、「ページの実行」、「共有コンポーネント」、「コメント」、「ロック」、「ページのエクスポート」および「検索」アイコンが表示されます。

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

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

「共有コンポーネント」アイコン

「共有コンポーネント」アイコンは、小さな機械の歯車のような形をしています。このアイコンをクリックすると、アプリケーション内のすべてのページに表示または適用できる共有コンポーネントおよびユーザー・インタフェース・コントロールのリストが表示できます。「共有コンポーネントでの作業」を参照してください。

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

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

「ロック」アイコン

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

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

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

「検索」アイコン

「検索」アイコンは懐中電灯の形をしています。このアイコンをクリックすると、カレント・アプリケーション内のアイテム、ページ、問合せ、表、PL/SQL、イメージおよびカスケード・スタイルシート(CSS)またはワークスペースに関連付けられたスキーマを検索できます。「「検索」アイコンの使用」を参照してください。

「Page Rendering」、「Page Processing」および「Shared Components」について

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

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

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

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

関連項目:
「「ページ・ファインダ」の使用」および「ページ定義の編集」

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

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

この項に含まれる内容は次のとおりです。

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

- ページ・イベントについて

- データベース・オブジェクトの依存性について

- 履歴について

- エクスポートについて

- グループについて

- 参照について

関連項目:
「ページ定義の理解」

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

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

1. 「ワークスペース」ホームページにナビゲートします。

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

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

4. ページを選択します。
ページ定義が表示されます。

5. 「ビュー」リストから次のいずれかの項目を選択します。

- 定義: 「ページ定義の編集」を参照。

- イベント: 詳細は、「ページ・イベントについて」を参照してください。

- 履歴: 「履歴について」を参照してください。

- エクスポート: 「エクスポートについて」を参照。

- グループ: 「グループについて」を参照。

- 参照:「参照について」を参照。

ページ・イベントについて

ページ・イベントは、現在定義されているすべてのページ・コントロールおよびプロセスの詳細を示します。このページには、Application Expressエンジンによるページのレンダリング、ロジックの呼出しおよびプロセスの実行の方法と順序について、日付順のビューが提供されます。

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

- ページ: 現在のページ番号を表示します。別のページを表示するには、「ページ」フィールドにページ番号を入力して、「実行」をクリックします。

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

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

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

- 「戻る」および「次へ」:これらのボタンは、小なり(<)記号と大なり(>)記号の形をしています。これらのボタンをクリックすると、前のページや次のページに移動します。

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

データベース・オブジェクトの依存性について

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

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

- ページ: 現在のページ番号を表示します。別のページを表示するには、「ページ」フィールドにページ番号を入力して、「実行」をクリックします。

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

- 「戻る」および「次へ」:これらのボタンは、小なり(<)記号と大なり(>)記号の形をしています。これらのボタンをクリックすると、前のページや次のページに移動します。

履歴について

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

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

- ページ: 現在のページ番号を表示します。別のページを表示するには、「ページ」フィールドにページ番号を入力して、「実行」をクリックします。

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

- 表示:表示するページ数を決定します。表示するページ数を変更するには、「表示」リストから選択して「実行」をクリックします。

- 「戻る」および「次へ」:これらのボタンは、小なり(<)記号と大なり(>)記号の形をしています。これらのボタンをクリックすると、前のページや次のページに移動します。

エクスポートについて

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

- ページ: 現在のページ番号を表示します。別のページを表示するには、「ページ」フィールドにページ番号を入力して、「実行」をクリックします。

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

関連項目:
「アクション・バーについて」、「別の開発インスタンスへのアプリケーションの移動方法」および「アプリケーションのページのエクスポート」

グループについて

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

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

- ページ: 現在のページ番号を表示します。別のページを表示するには、「ページ」フィールドにページ番号を入力して、「実行」をクリックします。

- 表示:表示するページ数を決定します。表示するページ数を変更するには、「表示」リストから選択して「実行」をクリックします。

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

関連項目:
「アクション・バーについて」および「ページのグループ化」

参照について

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

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

- ページ: 現在のページ番号を表示します。別のページを表示するには、「ページ」フィールドにページ番号を入力して、「実行」をクリックします。

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

- 「戻る」および「次へ」:これらのボタンは、小なり(<)記号と大なり(>)記号の形をしています。これらのボタンをクリックすると、前のページや次のページに移動します。

ページ定義の編集

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

この項に含まれる内容は次のとおりです。

- 「すべての編集」アイコンについて

- 「コピー」または「作成」アイコンについて

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

- ページ・レンダリングについて

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

- 共有コンポーネントについて

- ページ計算の理解

- 検証の理解

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

- ブランチの理解

関連項目:
「ページ定義について」、「ページ属性の編集」および「「ページ・ファインダ」の使用」

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

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

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

「すべての編集」アイコンをクリックすると、複数の制御、コンポーネントまたはアプリケーション・ロジックを同時に編集または削除するページや、最近の変更履歴を表示するページが表示されます。

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

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

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

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

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

関連項目:
「ページ・レンダリングについて」、「ページ・プロセスについて」および「共有コンポーネントについて」

「コピー」または「作成」アイコンについて

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

「作成」アイコンは、プラス(+)記号が置かれた小さいページの形をしています。「作成」アイコンをクリックすると、コントロールやコンポーネントが作成されます。

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

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

ページ・コンポーネントを並び替えるには、「並替え」アイコンをクリックします。並替えページが表示された後、上矢印および下矢印をクリックして、「変更の適用」をクリックします。

関連項目:
「「リージョンの順序変更」アイコンの使用」、「「ボタンの順序変更」アイコンの使用」、「「すべて編集」アイコンを使用した複数アイテムの編集」および「ドラッグ・アンド・ドロップ・レイアウト・ページの使用」

ページ・レンダリングについて

ページ・レンダリングとは、データベースからページを生成するプロセスです。「ページ・レンダリング」セクションを使用して、ページ属性、リージョン、ボタン、アイテム、ページ・レンダリングの計算、およびページ・プロセスを含むページのレンダリングに影響するコントロールを変更できます。

ヘッダーの下にあるアイコンをクリックすると、特定のサブセクションに簡単にナビゲートできます。これらのアイコンの1つを選択すると、そのサブセクションが表示され、その他すべてのサブセクションは一時的に非表示になります。表示を元に戻すには、「すべて表示」をクリックします。「すべて表示」アイコンは、下向き三角形の形をしています。

この項に含まれる内容は次のとおりです。

- ページ

- リージョン

- ボタン

- アイテム

- 計算

- プロセス

関連項目:
「ページ定義について」、「「すべての編集」アイコンについて」および「「コピー」または「作成」アイコンについて」

ページ

ページ属性は、ページ名、ならびにページ・タイトルや関連するページ・テンプレート、ヘッダー・テキスト、および一部の名前のための選択された認可スキームといった表示属性などのページの詳細な特性を制御します。ページ属性には、ページ定義からアクセスします。

関連項目:
「ページ属性の編集」

リージョン

リージョンはページ上の領域で、コンテンツのコンテナとして機能します。各ページには任意の数のリージョンを配置できます。リージョンのコンテンツは、リージョン・ソースによって決まります。たとえば、リージョンのコンテンツは、定義した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などを使用して)一部のタイプのロジックを実行したり、レンダリング・エンジンをコールできます。一般に、プロセスはアクションを実行します。プロセスは、ハンドコードしたPL/SQLの場合も、事前定義したプロセスの呼出しの場合もあります。

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

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

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

ヘッダーの下にあるアイコンをクリックすると、特定のサブセクションに簡単にナビゲートできます。これらのアイコンの1つを選択すると、そのサブセクションが表示され、その他すべてのサブセクションは一時的に非表示になります。表示を元に戻すには、「すべて表示」をクリックします。「すべて表示」アイコンは、下向き三角形の形をしています。

この項に含まれる内容は次のとおりです。

- 計算

- 検証

- プロセス

- ブランチ

関連項目:
「ページ定義について」、「「すべての編集」アイコンについて」および「「コピー」または「作成」アイコンについて」

計算

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

関連項目:
「ページ計算の理解」

検証

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

関連項目:
「検証の理解」および「「対象ボタン」属性について」

プロセス

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

関連項目:
「ページ・プロセスの理解」

ブランチ

ブランチは、ユーザーがアプリケーション内をナビゲートする方法を決定するロジック・コントロールの作成を可能にします。

関連項目:
「ブランチの理解」および「「対象ボタン」属性について」

共有コンポーネントについて

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

ヘッダーの下にあるアイコンをクリックすると、特定のサブセクションに簡単にナビゲートできます。これらのアイコンの1つを選択すると、そのサブセクションが表示され、その他すべてのサブセクションは一時的に非表示になります。表示を元に戻すには、「すべて表示」をクリックします。「すべて表示」アイコンは、下向き三角形の形をしています。

関連項目:
「共有コンポーネントでの作業」

この項に含まれる内容は次のとおりです。

- タブ

- LOV

- ブレッドクラム

- リスト

- テーマ

- テンプレート

- セキュリティ

- ナビゲーション・バー

関連項目:
「ページ定義について」、「「すべての編集」アイコンについて」および「「コピー」または「作成」アイコンについて」

タブ

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

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

関連項目:
「タブの作成」

LOV

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

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

関連項目:
「LOVの作成」

ブレッドクラム

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

関連項目:
「ブレッドクラムの作成」

リスト

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

関連項目:
「リストの作成」

テーマ

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

関連項目:
「テーマの管理」

テンプレート

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

関連項目:
「テンプレートのカスタマイズ」

セキュリティ

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

関連項目:
「認可を介したセキュリティの提供」

ナビゲーション・バー

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

関連項目:
「ナビゲーション・バー・エントリの作成」

ページ計算の理解

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

関連項目:
「アプリケーションの計算の理解」

この項に含まれる内容は次のとおりです。

- ページ計算の作成

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

- ページ計算属性の編集

ページ計算の作成

ページ計算では、ページが表示または送信(レンダリングおよび処理)されたときに、指定したアイテムに値が割り当てられます。ページ計算を作成するには、ページ計算の作成ウィザードを実行します。各計算には、計算の作成対象のアイテムおよび計算タイプを指定します。

関連項目:
「計算」

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

1. 該当するページ定義にナビゲートします。「ページ定義へのアクセス」を参照してください。

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. 該当するページ定義にナビゲートします。「ページ定義へのアクセス」を参照してください。

2. 「計算」で、計算名を選択します。
ページ計算の編集ページが表示されます。

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

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

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

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

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

条件付き計算の作成

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

検証の理解

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

この項に含まれる内容は次のとおりです。

- 検証の作成

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

- 検証の条件付き実行

関連項目:
「「対象ボタン」属性について」

検証の作成

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

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

1. 該当するページ定義にナビゲートします。「ページ定義へのアクセス」を参照してください。

2. 「ページ・プロセス」の「検証」で、「作成」アイコンをクリックします。
検証の作成ウィザードが表示されます。

3. 検証レベルを選択します。

- 「アイテム・レベルの検証」: 単一のアイテムに固有のものです。

- 「ページ・レベルの検証」: 単一のアイテムには適用されず、ページ全体に適用されます。

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

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

表 5-1 検証方法

検証方法

説明

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. 該当するページ定義にナビゲートします。「ページ定義へのアクセス」を参照してください。

2. 「検証」で、該当する検証を選択します。
検証の属性ページが表示されます。

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

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

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

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

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

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

ヒント:
「フィールドでインライン表示」または「フィールドおよび通知でインライン表示」を選択した場合、検証エラー・メッセージが表示されてページが再レンダリングされる間、Application Expressエンジンでは計算またはプロセスが実行されないことに注意してください。

検証の条件付き実行

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

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

1. 該当するページ定義にナビゲートします。「ページ定義へのアクセス」を参照してください。

2. 「検証」で、該当する検証を選択します。
検証の属性ページが表示されます。

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

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

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

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

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

ページ・プロセスの理解

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

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

関連項目:
「アプリケーション・プロセスの理解」

この項に含まれる内容は次のとおりです。

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

- プロセス属性の編集

ページ・プロセスの作成

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

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

1. 該当するページ定義にナビゲートします。「ページ定義へのアクセス」を参照してください。

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

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

表 5-2 プロセス・カテゴリ

プロセス・カテゴリ

説明

データ操作

ウィザードでは、データ操作言語(DML)のアクションをサポートするために、「データ操作」プロセス・タイプが頻繁に使用されます。Application Builderでは、次のような宣言によるデータ操作プロセスをサポートしています。

- 自動的なデータ操作言語(DML)プロセスを作成するには、「行の自動フェッチ」および「行の自動処理(DML)」を選択します。

- 「複数行の更新」および「複数行の削除」は、表形式フォームとともに使用します。

- 「表形式フォームに行の追加」は、表形式フォームとともに使用します。

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

ポップアップ・ウィンドウ内で実行中のプロセスに適用されます。このプロセス・タイプを実行すると、現在のポップアップ・ウィンドウが閉じます。

フォーム・ページ区切り

マスター・ディテール・フォームに関連付けられたディテール・レコードのページ区切りを実装します。このプロセスは、マスター・ディテール・フォーム(マスター・ディテール・ウィザードなど)で最も頻繁に使用され、マスター表をチェックして該当するディテール・レコード・セットを判別したり、次のディテール・レコードを判別します。

関連項目: 「マスター・ディテール・フォームの作成」

オンデマンド

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

関連項目: 「オンデマンド・アプリケーション・プロセスについて」

PL/SQL

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

ページ区切りのリセット

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

セッション・ステート

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

関連項目:「セッション・ステート値の管理」および Oracle Application Express管理ガイドの「ユーザー・プリファレンスの管理」

Webサービス

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

関連項目: 「プロセスとしてのWebサービスの起動」

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

プロセス属性の編集

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

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

1. 該当するページ定義にナビゲートします。「ページ定義へのアクセス」を参照してください。

2. プロセス名を選択します。
「ページ・プロセスの編集」ページが表示されます。

関連項目:
「「対象ボタン」属性について」

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

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

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

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

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

条件付きプロセスの作成

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

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

ブランチの理解

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

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

この項に含まれる内容は次のとおりです。

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

- 条件付きブランチ処理

関連項目:
「「対象ボタン」属性について」

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

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

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

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

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

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

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

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

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

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

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

- URLアドレス

条件付きブランチ処理

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

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

ページ属性の編集

ページ属性は、ページ名、ならびにページ・タイトルや関連するページ・テンプレート、ヘッダー・テキストおよび選択された認可スキームといった表示属性などのページの詳細な特性を制御します。ページ属性には、ページ定義からアクセスします。

この項に含まれる内容は次のとおりです。

- ページ属性へのアクセス

- ページ属性ページについて

ページ属性へのアクセス

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

1. ページ定義にナビゲートします。「ページ定義へのアクセス」を参照してください。

2. 「ページ・レンダリング」で、「ページ」セクションの位置を特定します。

ページ属性ページは、「ページ名」、「タイトル」、「HTMLヘッダー」、「HTMLボディ」、「ヘルプ・テキスト」、「テンプレート」など、特定のページ属性を制御するカテゴリに分けられます。

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

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

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

ヒント:
すべてのページ属性を一度に表示する方法は、「ページ属性の編集」アイコンをクリックするだけです。

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

Page Attributesページについて

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

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

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

名前

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

表 5-3 ページ属性: 名前

属性

説明

名前

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

ページの別名

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

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

f?p=100:home

グループ

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

グループからページを削除するには、「- グループが割り当てられていない -」を選択し、「変更の適用」をクリックします。

関連項目: 「ページのグループ化」

表示属性

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

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

属性

説明

ページ・テンプレート

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

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

標準タブ・セット

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

関連項目: 「タブの作成」

タイトル

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

カーソル・フォーカス

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

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

- JavaScriptを含める場合は、「フォーカスなし」を選択します。このオプションを選択すると、生成済JavaScriptとカスタムJavaScript間の競合を回避できます。

メディア・タイプ

インターネット・メディア・タイプを入力します。インターネット・メディア・タイプは、2つの部分で構成される、インターネット上のファイル形式を表す識別子です。メディア・タイプは、少なくともタイプとサブタイプの2つの部分で構成され、オプションで1つ以上のパラメータを指定します。メディア・タイプは、ページ描画の際にHTTPヘッダーのContent-Typeで使用されます。ページ・レベルのメディア・タイプが、アプリケーション・レベルのメディア・タイプを上書きします。この属性のデフォルト値はNULLです。ページ・レベルとアプリケーション・レベルの両方でメディア・タイプの値がNULLの場合、メディア・タイプとしてtext/htmlが使用されます。

ヘッダーおよびフッター

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

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

属性

説明

ヘッダー・テキスト

ページ・ヘッダーの直後に表示させるテキストまたはHTMLを入力します。

フッター・テキスト

ページ・テンプレート・フッターの前に表示するテキストまたはHTMLを入力してください。

HTMLヘッダー

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

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

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

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

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

「標準CSSとJavaScriptを含める」については、HTMLヘッダーにカスケード・スタイルシート(CSS)とJavaScriptファイルを含めることを禁止する場合に「はい」を選択します。これらのファイルの表示を禁止すると一般的なアプリケーションが中断するため、この属性の有効化は上級の開発者のみが行うようにしてください。

HTMLボディ属性

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

ページのHTMLボディ属性は、開始の<body>タグの内容を記述する際に使用します。一般的なページ・テンプレートでは、次の例に示すように、開始の<body>タグ内で#ONLOAD#を使用します。

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

関連項目:
「アプリケーションへのJavaScriptの組込み」

セキュリティ

次の属性を使用して、カレント・ページの認可スキームおよび認証要件を指定します。表5-6に、この属性を示します。

表 5-6 ページ属性: セキュリティ

属性

説明

認可スキーム

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

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

関連項目: 「認可を介したセキュリティの提供」

認証

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

関連項目: 認証によるユーザー・アイデンティティの証明

フォームのオートコンプリート

この属性を「オン」に設定してもページには影響はありません。この値を「オフ」に設定すると、FORMタグに次のHTMLが生成されます。

autocomplete="off"

重複する送信

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

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

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

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

「複製ページの送信時は、このURLに移動」で、URLを入力します。「複製ページの送信を許可」を「いいえ」に設定している場合はこのフィールドを使用します。「いいえ」を選択していて同一ページを2回発行すると、Oracle Application Expressはエラー・メッセージとユーザーが指定したURLへのリンクを表示します。

キャッシュ

これらの属性を使用してカレント・ページのキャッシュを有効にします。ページ・キャッシュを有効にすることで、アプリケーションのパフォーマンスが改善され、静的ページへの作用が改善されます。表5-7にこれらの属性を示します。

表5-7 キャッシュ属性

属性

説明

キャッシュ・ページ

「はい」または「いいえ」を選択して、ページ・キャッシュを有効にするかどうかを指定してください。ページ・キャッシュは、ページを動的に表示せずにキャッシュから表示するため、パフォーマンスが向上します。

キャッシュ・タイムアウト

キャッシュされたページが有効な時間を指定してください。

ユーザー別のキャッシュ

ページがユーザーによってキャッシュされる必要があるかどうかを指定します。「はい」の場合、ページは各ユーザー用にキャッシュされます。「いいえ」の場合、キャッシュされた同じページがすべてのユーザーに使用されます。

キャッシュ・ページ条件

条件を指定してください。条件がFalseを戻す場合、ページは動的にレンダリングされ、キャッシュされません。条件がTrueを戻す場合、ページはキャッシュから表示されます。

式1

選択した特定の条件タイプに基づいて、この属性に値を入力してください。

式2

選択した特定の条件タイプに基づいて、この属性に値を入力してください。

関連項目:
Oracle Application Express管理ガイドの「キャッシュされたリージョンおよびページの管理」、および「リージョン・キャッシュの使用」

構成

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

ビルド・オプションは、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エンジンに送信します。

関連項目:
「ページまたはアプリケーションの実行」

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

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

- ホーム: ワークスペースのホームページにリンクします。「ワークスペースのホームページについて」を参照してください。

- アプリケーション: アプリケーションのホームページにリンクします。「アプリケーション・ビルダーの概要」を参照してください。

- ページの編集: 現在実行されているページのページ定義にアクセスします。「ページ定義について」を参照してください。

- 作成: ページ、リージョン、ページ・コントロール(アイテム、ボタン、ブランチ、計算、プロセスまたは検証)または共有コントロール(ナビゲーション・バー・アイコン、タブ、LOV、リストまたはブレッドクラム)を作成するためのウィザードにリンクします。詳細は、「アプリケーションの作成」を参照してください。

- セッション: カレント・ページのセッション・ステート情報にリンクします。詳細は、「セッション・ステートの表示」を参照してください。

- アクティビティ: アクティビティ・レポート・ページにリンクします。「アクティビティ・レポート」を参照してください。

- デバッグ: ページを「デバッグ」モードと「デバッグなし」モードとの間で切り替えます。「デバッグ・モードへのアクセス」を参照してください。

- 編集リンクの表示: 「編集リンクの表示」と「編集リンクを非表示」とを切り替えます。「編集リンクの表示」をクリックすると、ページ上の編集可能な各オブジェクトの横に小さなオレンジ色のアイコンが表示されます。各アイコンは、オレンジ色で中に三角形があり、その下に2本の罫線があります。リンクをクリックすると、オブジェクト編集用の別のウィンドウが表示されます。

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

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

この項に含まれる内容は次のとおりです。

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

- 共有コンポーネント・ページについて

- 共有コンポーネントのエクスポートについて

- 共有コンポーネントのレポートへのアクセス

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

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

1. 「ワークスペース」ホームページにナビゲートします。

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

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

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

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

「共有コンポーネント」アイコンの使用

アクション・バーの「共有コンポーネント」アイコンをクリックしても、共有コンポーネント・ページにアクセスできます。アクション・バーは、小さな機械の歯車のような形をしており、アプリケーション・ビルダーのほとんどのページの右上隅の「ユーティリティ」タブの下に表示されます。

関連項目:
「アクション・バーについて」

共有コンポーネント・ページについて

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

アプリケーション

次のセクションでは、「アプリケーション」の下にあるリンクについて説明します。

定義

アプリケーション定義の編集ページにリンクします。このページを使用すると、アプリケーション名、アプリケーションの可用性および静的置換文字列を決定する属性を編集できます。また、ビルド・オプションやアプリケーション・ロゴなどのその他の属性を定義でき、関連付けられているテンプレートやコンポーネントのデフォルト値を表示することもできます。「アプリケーション定義の構成」を参照してください。

コメント

「アプリケーション・コメント」を使用すると、現在選択しているアプリケーションに固有のコメントを入力できます。「アプリケーション・コメントの追加」を参照してください。

ロジック

次のセクションで、「ロジック」の下にあるリンクについて説明します。

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

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

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

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

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

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

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

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

アプリケーションの計算

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

Webサービス参照

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

ビルド・オプション

ビルド・オプションを使用すると、アプリケーション内の特定の機能を条件付きで表示または処理できます。ビルド・オプションを使用して、アプリケーションの各デプロイについて、アプリケーションのどの機能をオンにするかを制御できます。詳細は、「ビルド・オプションを使用した構成の制御」を参照してください。

セキュリティ

次のセクションでは、「セキュリティ」の下にあるリンクについて説明します。

認証スキーム

認証は、ユーザーがアプリケーションにアクセスする前に、そのユーザーのアイデンティティを証明するプロセスです。認証では、ユーザー名とパスワードの入力や、ユーザーのアイデンティティまたは保護キーの使用が必要となる場合があります。「認証によるユーザー・アイデンティティの証明」を参照してください。

認可スキーム

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

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

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

セキュリティ属性の編集

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

グローバリゼーション

次のセクションでは、「グローバリゼーション」の下にあるリンクについて説明します。

アプリケーションの翻訳

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

テキスト・メッセージ

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

属性の編集

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

ナビゲーション

次のセクションでは、「ナビゲーション」の下にあるリンクについて説明します。

タブ

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

リスト

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

ブレッドクラム

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

ツリー

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

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

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

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

次のセクションでは、「ユーザー・インタフェース」の下にあるリンクについて説明します。

テーマ

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

テンプレート

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

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

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

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

LOV

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

ショートカット

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

レポート

次のセクションでは、「レポート」の下にあるリンクについて説明します。

レポート問合せ

「レポート問合せ」リンクを使用すると、カレント・アプリケーション内のストアド・クエリーのレポートを表示できます。「レポート問合せについて」を参照してください。

レポート・レイアウト

レポートまたは共通問合せとともに「レポート・レイアウト」を使用すると、Adobe Portable Document Format(PDF)、Microsoft Word Rich Text Format(RTF)、Microsoft Excel(XLS)形式などの印刷用形式でデータをレンダリングできます。「レポート・レイアウトについて」を参照してください。

ファイル

次のセクションでは、「ファイル」の下にあるリンクについて説明します。

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

アプリケーション・ビルダーには、独自のカスケード・スタイルシート(CSS)を参照するテンプレートを保持するテーマが含まれます。「カスケード・スタイルシート」リンクを使用すると、カスケード・スタイルシートをワークスペースにアップロードできます。詳細は、「カスタム・カスケード・スタイルシートの使用」を参照してください。

イメージ

イメージをワークスペースにアップロードするには、「イメージ」リンクを使用します。「イメージの管理」を参照してください。

静的ファイル

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

共有コンポーネントのエクスポートについて

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

この項に含まれる内容は次のとおりです。

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

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

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

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

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

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

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

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

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

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

Shared Components・ページからの共有コンポーネントのエクスポート

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

1. 「ワークスペース」ホームページにナビゲートします。

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

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

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

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

共有コンポーネントのレポートへのアクセス

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

1. 「ワークスペース」ホームページにナビゲートします。

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

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

4. 「タスク」リストで、「アプリケーション・レポート」をクリックします。
アプリケーション・レポート・ページが表示されます。

5. 「共有コンポーネント」をクリックします。
各種のアプリケーション・レポートが、共有コンポーネント・ページと同じカテゴリに分けられて表示されます。次のようなカテゴリが含まれます。

- アプリケーション

- ロジック

- セキュリティ

- グローバリゼーション

- ナビゲーション

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

- レポート

- ファイル

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

関連項目:
「アプリケーション・レポートの表示」および「データベース・オブジェクトの依存性レポートについて」

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

アプリケーション・プロセスとは、アプリケーションの複数ページからのプロセスを使用して、特定のポイントで実行されるように設定されている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. ページ上部の「履歴」タブを選択します。
このアプリケーション計算履歴レポートには、最近変更されたアプリケーション計算の履歴が日付ごとに表示されます。

6 アプリケーションの構築

このセクションでは、アプリケーション・ビルダーを使用してアプリケーションおよびアプリケーション・コンポーネントを構築する方法について説明します。アプリケーションの作成ステップ、ページの追加ステップ、およびコンポーネント(レポート、チャートまたはフォーム)、ページ・コントロール(ボタン、アイテムまたはLOV)および共有コンポーネント(ブレッドクラム、リストまたはタブ)の追加ステップについて説明します。

この項には、次の項目が含まれます。

- アプリケーションの作成

- アプリケーション内のページの管理

- アプリケーション・コメントの追加

- 開発者コメントの追加

- アプリケーション・グループの作成

- アプリケーション・レポートの表示

- ページ・レベル・アイテムの理解

- アプリケーション・レベル・アイテムの理解

関連項目:
「アプリケーション・ビルダーの使用」、「ページ・レイアウトの制御」および「ナビゲーションの追加」

アプリケーションの作成

アプリケーションは、共通のセッション・ステートおよび認証を共有するページのコレクションです。アプリケーションは、アプリケーション・ビルダーでウィザードを使用して作成します。アプリケーションはアプリケーションのホームページから削除できます。

この項に含まれる内容は次のとおりです。

- ウィザードを使用したアプリケーションの作成について

- アプリケーションの作成ウィザードについて

- スプレッドシートからのアプリケーションの作成ウィザードについて

- デモンストレーション・アプリケーションについて

- アプリケーションのコピー

- アプリケーションの削除

ヒント:
アプリケーション・ビルダーのデフォルト値を構成することで、アプリケーションを作成するために必要なステップの数を削減できます。Oracle Application Express管理ガイドの「アプリケーション・ビルダーのデフォルト値の利用」を参照してください。

ウィザードを使用したアプリケーションの作成について

アプリケーション・ビルダーのホームページで「作成」をクリックする場合は、次のいずれかのオプションを選択する必要があります。

- アプリケーションの作成。アプリケーションを作成します。SQL問合せまたはデータベース表に基づいてアプリケーションを作成します。空白ページや、レポート、フォーム、表形式フォーム、またはリンク付きフォームのあるレポートを含むページを定義できます。詳細は、「アプリケーションの作成ウィザードについて」を参照してください。

- スプレッドシートからアプリケーションの作成:スプレッドシート・データに基づいてアプリケーションを作成します。表を作成するためのスプレッドシート・データをアップロードまたはペーストしてから、ユーザー・インタフェースを追加できます。生成されるアプリケーションで、ユーザーは問合せの作成、レコードの追加、挿入または更新、データの分析などを実行できます。「スプレッドシートからのアプリケーションの作成ウィザード」を参照してください。

- デモンストレーション・アプリケーション。デモンストレーション・アプリケーションをインストールまたはアンインストールします。デモンストレーション・アプリケーションを使用してアプリケーションの作成方法を学習します。「デモンストレーション・アプリケーションについて」を参照してください。

関連項目:
「アプリケーション内のページの管理」

アプリケーションの作成ウィザードについて

アプリケーションの作成ウィザードを使用すると、表の数に基づいてあらゆる機能を備えたアプリケーションを作成できます。アプリケーションの作成ウィザードを使用して、空白ページまたは、SQL問合せやデータベース表に基づいたページを作成できます。SQL問合せは、手動でSQLを入力しても、「クエリー・ビルダー」のGUIを使用しても、どちらでも作成できます。

表に基づいたアプリケーションは簡易レポート、フォームとレポート、または表形式フォームで構成されます。表にページが作成されると、分析ページを生成するオプションも作成されます。分析ページにより、簡易レポートまたはフォーム上のレポートは拡張され、複数のドリルダウン・レポートおよびチャートを含むことができます。

ワークスペース・レベルでは、その表領域で構築されたアプリケーションに使用されるデフォルト値を設定するオプションがあります。これらのデフォルト値を設定すると、各ステップを介さずにウィザードを終了できます。ウィザードを終了する場合、ユーザーが作成したアプリケーションは、ユーザーがデフォルトとして指定した値を使用します。

関連項目:
Oracle Application Express SQLワークショップおよびユーティリティ・ガイドの「クエリー・ビルダーを使用した問合せの構築」およびOracle Application Express管理ガイドの「アプリケーション・ビルダーのデフォルト値の利用」

チュートリアルを参照:
Oracle Database Application Express 2日で開発者ガイドの「アプリケーションの構築」、およびOracle Application Expressアドバンスト・チュートリアル

この項に含まれる内容は次のとおりです。

- 表または問合せに基づいたアプリケーションの作成

- アプリケーション・モデルとユーザー・インタフェースのデフォルト値について

- アプリケーション・モデルとユーザー・インタフェースのデフォルト値の利用

表または問合せに基づいたアプリケーションの作成

表、問合せまたはドリルダウン問合せに基づいてアプリケーションを作成するには、「アプリケーションの作成」ウィザードで「アプリケーションの作成」を選択します。

表、問合せまたはドリルダウン問合せに基づいてアプリケーションを作成するには、次のステップを実行します。

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

2. 「作成」ボタンをクリックします。

3. 「方法」で、「アプリケーションの作成」を選択して「次へ」をクリックします。

4. 「名前」で、次の内容を入力し、「次へ」をクリックします。

1. 名前: アプリケーションを識別するための名前を入力します。

2. アプリケーション: アプリケーションを識別するための一意の整数値を入力します。

3. アプリケーションの作成 - 作成方法を選択します。

- 手動ですべてのページを追加する場合は、「最初から」を選択します。

- 以前のアプリケーション・モデルからページ定義をコピーする場合は、「既存のアプリケーション設定モデルに基づく」を選択します。
他のすべてのアプリケーション属性を定義する必要があることに注意してください。また、一部の属性は、別のアプリケーションから共有コンポーネントをコピーすることによってコピーすることもできます(ステップ7および「アプリケーション・モデルとユーザー・インタフェースのデフォルト値について」を参照)。

4. スキーマ - アプリケーションは、すべてのSQLを特定のデータベース・スキーマとして解析することで、権限を取得します。データベース・スキーマ所有者を指定します。

次に、ページをアプリケーションに追加します。

5. 「ページ」で、次のステップを実行します。

1. 追加するページのタイプを選択します。オプションは次のとおりです。

- 空白: 組込み機能のないページを作成します。

- レポート: SQL問合せの書式設定された結果を含むページを作成します。選択した表に基づいてレポートを作成するか、カスタムSQL SELECT文または指定したSQL SELECT文を戻すPL/SQLファンクションに基づいてレポートを作成するかを選択できます。

- フォーム: データベース表の単一行を更新するフォームを作成します。

- 表形式フォーム: データベース表の複数の行に対して更新、挿入および削除を行うフォームを作成します。

- マスター・ディテール: 1つのHTMLフォーム内にマスター行および複数のディテール行を表示するフォームを作成します。このフォームを使用すると、2つの表またはビューに対し、値の問合せ、挿入、更新および削除を行うことができます。

- レポートとフォーム: 2ページのレポートとフォームの組合せを構築します。1ページ目では、更新する行を選択します。2ページ目では、レコードを追加するか、あるいは既存のレコードの更新または削除を行うことができます。

アクション: 現在選択済のページ・タイプが表示されます。選択ごとに、表名の選択、レポート実装など異なる情報のタイプが求められます。

レポート・ページには「分析ページを含む」チェック・ボックスがあります。複数のドリルダウン・レポートおよびチャートを含むように、簡易レポートまたはフォーム上のレポートを拡張する場合は、このオプションを選択してウィザードのステップに従います。

2. 「ページの追加」をクリックします。
ページがページ上部に表示されます。ページを削除するには、「削除」アイコンをクリックします。

3. すべてのページが追加されるまで前のステップを繰り返します。

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

ヒント:
ウィザードを早期に終了して「アプリケーション・ビルダーのデフォルト値」を使用するには、「作成」ボタンをクリックします。「アプリケーション・ビルダーのデフォルト値」を構成するには、Oracle Application Express管理ガイドの「アプリケーション・ビルダーのデフォルト値の利用」を参照してください。

6. 「タブ」で、アプリケーションにタブを含めるかどうかを決定し、「次へ」をクリックします。

7. 「共有コンポーネント」で、別のアプリケーションから共有コンポーネントをインポートするかどうかを決定します。共有コンポーネントは、アプリケーション内のすべてのページに表示または適用される共通の要素です。
共有コンポーネントを含めるには、次を選択します。

1. 別のアプリケーションから共有コンポーネントのコピー - 「はい」を選択します。

2. コピー元アプリケーション - 共有コンポーネントのインポート元となるアプリケーションを選択します。

3. インポートするコンポーネントの選択 - インポートするコンポーネントを選択します。

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

次に、デフォルトの認証スキームを選択します。認証は、ユーザーのアプリケーションへのアクセスを可能にするために、ユーザーのアイデンティティを証明するプロセスです。「認証によるユーザー・アイデンティティの証明」を参照してください。

8. 「認証スキーム」で、次のいずれかを選択します。

- Application Express: Application Expressサービス管理アプリケーションで作成および保持されるユーザー・アカウント資格証明を使用します。これらは、Application Express開発環境へのログインに使用するアカウントです。また、アプリケーションのエンド・ユーザー用として、このユーザー・アカウント・リポジトリにアカウントを作成することもできます。

- 認証なし: データベース認証とも呼ばれます。このオプションによって、ユーザーはmodplsql DAD定義に格納されているアカウント資格証明を使用して、アプリケーションにアクセスできます。ほとんどの場合、アプリケーションへのアクセス時にログインを行う必要がなくなります。これは、公開アプリケーションを最も速く作成する方法です。

- データベース・アカウント: アプリケーションへのユーザー・ログインには、認証するためにデータベース・スキーマ名(またはユーザー名)とそのパスワードが必要です。このアカウント情報は、Oracle Database全体で管理されます。

9. 次に、次のようなグローバリゼーション設定を選択します。

1. 言語: このアプリケーションのプライマリ言語を選択します。
アプリケーションを開発する言語をこの属性で指定します。この言語が、すべての変換の元となるベース言語になります。

2. ユーザー言語プリファレンスの派生元: エンジンによるアプリケーション言語の決定方法を指定します。アプリケーションのプライマリ言語は静的にする(Webブラウザの言語から派生される)か、またはユーザー・プリファレンスまたはアイテムから判別されるようにできます。データベース言語の設定では、日付の表示とソート特性を決定します。
「言語」および「ユーザー言語プリファレンスの派生元」属性は、グローバリゼーション属性の編集ページで後から変更できます。「グローバリゼーション属性の設定」を参照してください。

3. 日付書式: アプリケーションで使用する日付書式を指定します。
この日付書式を使用して、NLS_DATE_FORMATデータベース・セッションの設定が変更されてから、アプリケーション内のページが表示または送信されます。この値には、有効なOracle日付書式マスクを含むリテラル文字列、または置換構文によるアイテム参照を指定できます。値が指定されていない場合は、データベース・セッションからデフォルトの日付書式が実行時に取得されます。指定されている場合は、DATE型の列から得られるすべてのアイテムの日付書式としても使用されます。

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

10. 「ユーザー・インタフェース」で、テーマを選択し、「次へ」をクリックします。
テーマは、アプリケーション全体のレイアウトおよびスタイルの定義に使用できるテンプレートのコレクションです。「テーマの管理」を参照してください。

11. 選択した内容を確認し、「作成」をクリックします。

アプリケーション・モデルとユーザー・インタフェースのデフォルト値について

アプリケーションの作成ウィザードは、開発者が複数回実行するという予測の下に設計されています。この反復アプローチをアプリケーション開発に利用するため、ウィザードを実行するたびにページ定義がアプリケーション・モデルに保存されます。

次の例を考えてみます。アプリケーションの作成ウィザードを実行してアプリケーションを作成します。そのアプリケーションを確認して、それが意図していたものと異なることに気付きました。それを変更するかわりに、ウィザードを再度実行してアプリケーション・モデルを選択します。ウィザードの再実行時に既存のアプリケーション・モデルを選択することで、作成したアプリケーションを効率的かつ迅速に改善できます。

関連項目:
Oracle Application Express管理ガイドの「アプリケーション・モデルの管理」

アプリケーションの作成時に生産性を向上させるもう1つの方法として、ユーザー・インタフェースのデフォルト値の指定があります。ユーザー・インタフェースのデフォルト値はメタデータで、ユーザーが指定したスキーマ内の表、列またはビューにデフォルトのユーザー・インタフェースのプロパティを割り当てることを可能にします。

関連項目:
「ユーザー・インタフェースのデフォルト値の管理」

アプリケーション・モデルとユーザー・インタフェースのデフォルト値の利用

アプリケーション・モデルとユーザー・インタフェースのデフォルト値を利用することで、アプリケーションの作成時の生産性を向上させることができます。次の使用例を考えてみます。

1. アプリケーションの作成ウィザードを実行して、表またはビューに基づくアプリケーションを作成します。

2. 生成されたアプリケーションを実行します。機能上の問題がないか注意します。

3. ユーザー・インタフェースのデフォルト値を作成または編集するかどうか検討します。
たとえば、ユーザー・インタフェースのデフォルト値を使用すると、フォーム・フィールドまたはレポート・ラベルの表示方法を制御できます。特定の列の表示や、交互の順序による列の表示に、ユーザー・インタフェースのデフォルト値を利用することもできます。

4. アプリケーションのホームページにナビゲートし、「作成」をクリックしてアプリケーションを作成します。

5. 「アプリケーションの作成」を選択します。

6. アプリケーションの詳細を入力するためのプロンプトが表示されたら、次の項目を指定します。

1. 名前: アプリケーションを識別するための名前を入力します。

2. アプリケーション - アプリケーションを識別するための一意の整数値を入力するか、デフォルト値を受け入れます。

3. アプリケーションの作成 - 「既存のアプリケーション設定モデルに基づく」を選択します。

7. アプリケーション・モデルを選択します。
以前ユーザーが作成したページがすでに表示されています。

8. ページの追加、編集または削除を行います。

9. ウィザードを完了します。

10. 目的とする機能上の要件をアプリケーションが満たすまで、ステップ2から9を繰り返します。

スプレッドシートからのアプリケーションの作成ウィザードについて

スプレッドシート・データに基づいてアプリケーションを作成するには、アプリケーションの作成ウィザードで「スプレッドシートから作成」を選択します。

スプレッドシート・データからアプリケーションを作成するには、次のステップを実行します。

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

2. 「作成」ボタンをクリックします。

3. 「スプレッドシートから作成」を選択します。

4. 「ロード方法」で、スプレッドシート・データのアップロード方法を指定します。次のいずれかを選択し、「次へ」をクリックします。

1. ファイルをアップロード(カンマ区切り(*.csv)またはタブ区切り):次の項目を指定し、「次へ」をクリックします。

- テキスト・ファイル - 「参照」をクリックし、アップロードされるファイルを指定します。

- 「セパレータ」: カンマ区切り文字を指定します。タブ区切りには\tを使用します。

- 「囲み文字(オプション)」: 区切り文字を入力します。この文字は、データ値の始まりと終わりを区切るために使用できます。区切り文字を指定した場合、データ値の始まりと終わりの前にあるスペースはウィザードで無視されます。このオプションを使用すると、指定した区切り文字でデータ値を囲むこともできます。

- 「ファイルのキャラクタ・セット」: テキスト・ファイルのエンコードに使用されるキャラクタ・セットを選択します。

2. コピー・アンド・ペースト。インポートするタブ区切りデータをコピーして貼り付けます。

5. 「表のプロパティ」で、表の表示方法を確認し、「次へ」をクリックします。表名および列名を指定し、データ・タイプを変更します。列を含むかどうかを指定するには、「アップロード」リストから選択します。

6. 「ユーザー・インタフェースのデフォルト値」で、次のステップを実行します。

1. 表示された単数形の名前を確認し、複数形の名前を入力します。

2. (オプション)「列のユーザー・インタフェースのデフォルト値」で、表示された列ラベルを確認します。

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

7. 「サマリー・ページ」で、次のステップを実行します。

1. 列別のサマリー - レポートおよびチャートでデータのサマリーを表示する列を選択し、「次へ」をクリックします。

2. 列別の集計 - サマリー・レポートに値を集計する列を選択し、「次へ」をクリックします。

8. 「アプリケーション・オプション」で、次のように指定します。

1. アプリケーション名: このアプリケーションの名前を英数字で入力します。

2. 作成モード:

- 読み書き両用: ページの挿入および更新が含まれます。

- 読取り専用: ページの挿入および更新は含まれません。

3. レポート実装 - SQLレポートを作成する場合は「クラシック」を選択し、対話モード・レポートを作成する場合は「対話モード」を選択します。

4. チャート・タイプを選択します。

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

9. 「ユーザー・インタフェースのテーマ」で、テーマを選択し、「次へ」をクリックします。
テーマは、アプリケーション全体のレイアウトおよびスタイルの定義に使用できるテンプレートのコレクションです。「テーマの管理」を参照してください。

10. 選択した内容を確認し、「作成」をクリックします。

関連項目:
Oracle Application Express SQLワークショップおよびユーティリティ・ガイドの「クエリー・ビルダーを使用した問合せの構築」

チュートリアルを参照:
Oracle Application Expressアドバンスト・チュートリアルの「アクセス制御ページの構築方法」

デモンストレーション・アプリケーションについて

Oracle Application Expressとともに多くのデモンストレーション・アプリケーションがインストールされます。これらのアプリケーションを使用して、アプリケーションに組み込むことができる多様な機能について学習してください。

関連項目:
「デモンストレーション・アプリケーションの実行」、Oracle Application Express管理ガイドの「新しいワークスペースでのデモンストレーション・アプリケーションの作成の無効化」およびOracle Database Application Express 2日で開発者ガイドのパブリック・パッケージ・アプリケーションおよびサンプル・コードのダウンロードに関する項

デモンストレーション・アプリケーションへのアクセス

デモンストレーション・アプリケーションにアクセスするには、次のステップを実行します。

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

2. 「作成」ボタンをクリックします。

3. 「デモンストレーション・アプリケーション」を選択します。
デモンストレーション・アプリケーション・ページに、次のアプリケーションへのリンクが表示されます。

- 「サンプル・アプリケーション」には、基本的な設計概念に焦点をあてた実用的なデモンストレーションが表示されます。

- 「コレクション・ショウケース」には、ショッピング・カートの概要が表示されます。

4. デモンストレーション・アプリケーションをインストールするには、インストールするアプリケーションの位置を特定して、「インストール」をクリックします。

5. 画面に表示されるステップに従います。
アプリケーションのホームページが表示されます。

6. インストールされているデモンストレーション・アプリケーションを実行するには、「実行」リンクをクリックします。

7. 対象のログイン資格証明を入力し、「ログイン」をクリックします。

- サンプル・アプリケーションの場合は、次のようにします。

- 「ユーザー名」には、demoまたはadminのどちらかを入力します。

- 「パスワード」には、現在のワークスペース名を小文字で入力します。

- その他のデモンストレーション・アプリケーションの場合、ワークスペースのユーザー名およびパスワードを入力します。

アプリケーションのコピー

アプリケーションをコピーするには、次のようにします。

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

2. アプリケーションを選択します。
アプリケーションのホームページが表示されます。

3. 「タスク」リストで「このアプリケーションのコピー」をクリックします。「「タスク」リストについて」を参照してください。

4. 「アプリケーションのコピー」で次の作業を実行します。

1. 新しいアプリケーションIDを入力します。

2. 新しいアプリケーション名を入力します。

3. デプロイ属性をコピーするかどうか指定します。

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

5. 「アプリケーションのコピー」をクリックします。

アプリケーションの削除

アプリケーションの削除は、アプリケーション・ビルダー内から行うことができます。または、アプリケーション属性の編集中にも削除できます。アプリケーションを削除すると、定義されたコンポーネント(レポート、チャートまたはフォーム)、ページ・コントロール(ボタン、アイテムまたはLOV)および共有コンポーネント(ブレッドクラム、リストおよびタブ、ただし、ユーザー・インタフェースのデフォルト値を除く)もすべて削除されます。

関連項目:
「サポートするオブジェクトの削除」

この項に含まれる内容は次のとおりです。

- アプリケーション・ビルダーからのアプリケーションの削除

- 定義の編集ページからのアプリケーションの削除

関連項目:
「サポートするオブジェクトの削除」

アプリケーション・ビルダーからのアプリケーションの削除

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

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

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

3. アプリケーション・ビルダーが表示されたら、ページ上部のアプリケーションIDおよびアプリケーション名を確認します。

4. 「タスク」リストで、「このアプリケーションの削除」をクリックします。

5. プロンプトが表示されたら、「今すぐ完全に削除」をクリックします。

Edit Definitionページからのアプリケーションの削除

定義の編集ページからアプリケーションを削除するには、次のようにします。

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

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

3. 「共有コンポーネント」をクリックします。
共有コンポーネント・ページが表示されます。

4. 「アプリケーション」で、「定義」をクリックします。
定義の編集ページが表示されます。

5. アプリケーションIDおよびアプリケーション名を確認します。

6. ページの上部の「削除」をクリックします。

7. プロンプトが表示されたら、「今すぐ完全に削除」をクリックします。

関連項目:
「アプリケーション定義の構成」

アプリケーション内のページの管理

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

この項に含まれる内容は次のとおりです。

- ページの作成について

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

- ページ定義からのページの作成

- 「開発者」ツールバーからのページの作成

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

- ページのグループ化

- ページのロックおよびロック解除

- ページの削除

関連項目:
「レポートの作成」、「チャートの作成」、「フォームの作成」、「カレンダの作成」、「ツリーの作成」および「アプリケーション、ページおよびページ・コンポーネントへのアクセスの制御」

ページの作成について

ページの追加、または既存のページへのコンポーネントの追加を行うには、ページの作成ウィザードを実行します。このウィザードにアクセスする方法を次に示します。

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

- 「ページ定義」の「作成」をクリックします。「ページ定義からのページの作成」を参照してください。

- 「開発者」ツールバーの「作成」リンクをクリックして、「新しいページ」を選択します。「開発者ツールバーからのページの作成」を参照してください。

注意:
「ページの作成」ウィザードを使用して、コンポーネント(つまりレポート、チャート、フォーム、ウィザード、カレンダまたはツリー)を既存のページに追加することもできます。プロンプトが表示されたら、既存のページ番号を指定します。

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

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

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

2. アプリケーションを選択します。
アプリケーションのホームページが表示されます。

3. 「ページの作成」ボタンをクリックします。

4. 作成するページ・タイプを次の表から選択します。

ページ・タイプ

説明

空白ページ

空白ページを作成します。

複数の空白ページ

複数の空白ページを作成します。

レポート

SQL問合せの結果がフォーマット化されます。使用可能なオプションは次のとおりです。

- SQLレポート - カスタムSQL SELECT文または指定したSQL SELECT文を戻すPL/SQLファンクションに基づいてレポートを作成します。

- 対話モード・レポート: 指定するカスタムSQL SELECT文に基づいた対話モード・レポートを作成します。ユーザーは、特定の列の選択、フィルタの適用、ハイライト処理、ソート処理などを行ってレポート・データのレイアウトを変更できます。また、ブレーク、集計、各種チャート、ユーザー独自の計算などを定義することもできます。

- Webサービスの結果のレポート: Webサービスの結果に基づいてレポートを作成します。

- ウィザード・レポート: SQLの知識がなくてもレポートを作成できます。適切なスキーマ、表、列および結果セット表示を選択します。

参照: 「レポートの作成」および「Webサービスの実装」

チャート

グラフィカル・チャートの3タイプ(HTML、SVG (Scalable Vector Graphics)およびFlash)を作成できます。
関連項目: チャートの作成

フォーム

ユーザーが更新した表内の単一行または複数行を使用してフォームのインタフェースを作成します。
関連項目: フォームの作成

ウィザード

ウィザードを作成します。

カレンダ

月別、週別、日別表示のカレンダを生成します。
関連項目: カレンダの作成

ツリー

ツリーを作成すると、階層的なデータまたは複数レベルのデータ間でグラフィカルに通信できます。
関連項目: ツリーの作成

ログイン・ページ

ログイン・ページを作成します。
参照: ログイン・ページの構築

アクセス制御

アクセス制御リストを含むページを作成すると、開発者はアプリケーション、個別ページまたはページ・コンポーネントへのアクセスを制御できます。
関連項目: 「アプリケーション、ページおよびページ・コンポーネントへのアクセスの制御」

ページ0(ゼロ)

ページ0 (ゼロ)は、マスター・ページとして機能します。ページ0に追加したすべてのコンポーネントは、Application Expressエンジンによってアプリケーション内の各ページにレンダリングされます。Application Expressエンジンでコンポーネントをレンダリングするか、または条件を定義することで計算、検証またはプロセスを実行するかを制御することもできます。
参照: 「アプリケーションの各ページのコンポーネントの表示」

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

ページ定義からのページの作成

ページ定義の表示中にページを作成するには、次のステップを実行します。

1. 該当するページ定義にナビゲートします。「ページ定義へのアクセス」を参照してください。

2. ページ上部の「作成」ボタンをクリックします。

3. 作成するページのタイプを選択します。

- 新しいページ

- このページのリージョン

- このページのページ・コントロール

- 共有コントロール

「ページ・タイプの作成について」を参照してください。

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

関連項目:
「ページ定義の編集」

ページ・タイプの作成

「ページの作成」ウィザードを実行する際に、ページ・タイプを選択します。表6-1は、選択したページ・タイプに基づいて選択可能なページの作成オプションを示します。

表6-1 「ページの作成」オプション

「ページの作成」オプション

選択可能な項目

新しいページ

使用可能なページ・タイプは、次のとおりです。

- 空白ページ

- 複数の空白ページ

- レポート。「レポートの作成」を参照してください。

- チャート。「チャートの作成」を参照してください。

- フォーム。「フォームの作成」を参照してください。

- ウィザード

- カレンダ。「カレンダの作成」を参照してください。

- ツリー。「ツリーの作成」を参照してください。

- ログイン・ページ。「ログイン・ページの構築」を参照。

- アクセス制御。「アプリケーション、ページおよびページ・コンポーネントへのアクセスの制御」を参照してください。

- ページ0(ゼロ)。「アプリケーションの各ページのコンポーネントの表示」を参照。

このページのリージョン

リージョンはコンテンツのコンテナとして機能します。使用可能なリージョン・タイプは、次のとおりです。

- HTML

- 複数のHTML

- レポート

- フォーム

- チャート

- リスト

- ブレッドクラム

- PL/SQL動的コンテンツ

- ツリー

- URL

- カレンダ

- ヘルプ・テキスト

関連項目: 「リージョンの理解」および「リージョン・タイプについて」

このページのページ・コントロール

ページ・コントロールは次のとおりです。

- アイテム。「ページ・レベル・アイテムの理解」を参照。

- ボタン。「ボタンの作成」を参照してください。

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

- 計算。「ページ計算の理解」を参照。

- プロセス。「ページ・プロセスの理解」を参照。

- 検証。「検証の理解」を参照してください。

共有コントロール

共有コンポーネント・オプションは次のとおりです。

- 「ナビゲーション・バー」アイコン。詳細は、「ナビゲーション・バー・エントリの作成」を参照してください。

- 「親」タブ。「タブの作成」を参照してください。

- 「標準」タブ。「タブの作成」を参照してください。

- LOV。詳細は、「LOVの作成」を参照してください。

- リスト。「リストの作成」を参照してください。

- ブレッドクラム。「ブレッドクラムの作成」を参照してください。

「開発者」ツールバーからのページの作成

レンダリングされたアプリケーションを表示するには、「実行」または「アプリケーションの実行」アイコンをクリックしてアプリケーションを実行するか、またはApplication Expressエンジンに送信します。

関連項目:
「ページまたはアプリケーションの実行」

アプリケーションを実行すると、ページ下部に「開発者」ツールバーが表示されます。「開発者」ツールバーを使用すると、カレント・ページの編集、ページ、リージョンまたはページ・コントロールの作成、セッション・ステートの表示、あるいは編集リンクのオン/オフの切替えを簡単に実行できます。「開発者」ツールバーの表示の有無は、定義の編集ページの「ステータス」属性を変更することで制御できます。

関連項目:
「ステータス」リストの詳細は「アプリケーション定義の構成」

「開発者」ツールバーからページを作成するには、次のステップを実行します。

1. アプリケーションを実行します。「ページまたはアプリケーションの実行」を参照してください。

2. 「開発者」ツールバーで「作成」をクリックします。
「新しいコンポーネント」ウィザードが表示されます。

3. 作成するコンポーネントのタイプを選択し、「次へ」をクリックします。使用可能なオプションは次のとおりです。

- 新しいページ

- このページのリージョン

- このページのページ・コントロール

- 共有コントロール
「ページ・タイプの作成について」を参照してください。

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

関連項目:
「開発者ツールバーについて」

ページのコピー

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

ページをコピーするには、次のようにします。

1. コピー先のアプリケーションにナビゲートします。

1. 「ワークスペース」ホームページにナビゲートします。

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

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

4. ページを選択します。
ページ定義が表示されます。

2. 「コピー」ボタンをクリックします。

3. 「ページ・オプションのコピー」で、次のいずれかを選択します。

- このアプリケーションのページ

- 別のアプリケーションのページ

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

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

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

この項に含まれる内容は次のとおりです。

- 「アプリケーションの実行」アイコンと「ページの実行」アイコン

- アプリケーション・ビルダーのホームページからのアプリケーションの実行

- アプリケーションのホームページからのアプリケーションの実行

- ページ定義からのページの実行

「アプリケーションの実行」アイコンと「ページの実行」アイコン

「アプリケーションの実行」アイコンは大きな信号のような形をしており、アプリケーションのホームページに表示されます。「アプリケーションの実行」アイコンをクリックすると、アプリケーション全体が実行されます。

「ページの実行」アイコンは小さな明るい緑色の信号のような形をしており、アプリケーション・ビルダー内の多くのページの右上隅に表示されます。「ページの実行」アイコンをクリックすると、現在のページが実行されます。

アプリケーション・ビルダーのホームページからのアプリケーションの実行

アプリケーション・ビルダーのホームページからアプリケーション全体を実行するには、次のステップを実行します。

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

2. 「ビュー」リストから「詳細」を選択し、「実行」をクリックします。

3. 「アプリケーション」リストからアプリケーションを指定します。

4. 右側の列にある「実行」アイコンをクリックします。

アプリケーションのホームページからのアプリケーションの実行

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

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

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

3. ページ上部にある「アプリケーションの実行」アイコンをクリックします。

アプリケーションのホームページでのページの実行

ページ上部にあるナビゲーション・バーの「ビュー」リストから選択を行うことで、アプリケーションのホームページの表示方法を制御できます。「詳細」を選択すると、各ページがレポートの行として表示されます。各行には、ページ番号、ページ名、ページの最終更新日、ページの最終更新者、「ロック」アイコンおよび「実行」アイコンが含まれます。

「ページ」リストからページを実行するには、次のステップを実行します。

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

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

3. 「ビュー」リストから「詳細」を選択し、「実行」をクリックします。

4. 実行するページを「ページ」リストから指定して、右側の列にある「実行」アイコンをクリックします。

関連項目:
「ページのロックおよびロック解除」

ページ定義からのページの実行

ページ定義から特定のページを実行するには、次のステップを実行します。

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

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

3. ページを選択します。
ページ定義が表示されます。

4. ページの右上にある「ページの実行」アイコンをクリックします。

ページのグループ化

ページをページ・グループとして編成すると、アプリケーション内のページに簡単にアクセスできるようになります。ページ・グループを使用するには、グループを作成してからページをグループに割り当てます。

ページ・グループには、開発者がアプリケーション内のページを編成する場合に有効な機能以外の機能はありません。

この項に含まれる内容は次のとおりです。

- ページ・グループの表示

- ページ・グループの作成

- ページのページ・グループへの割当て

- ページ・グループからのページの削除

- ページ・グループの削除

- 「ページ・グループごとのページ」レポートの表示

ページ・グループの表示

ここでは、ページ・グループの様々な表示方法について説明します。

ページ・グループ・ページへのアクセス

ページ・グループ・ページにアクセスするには、次のステップを実行します。

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

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

3. ページの右側にある「タスク」リストで、「ページ・グループ」をクリックします。
ページ・グループ・ページが表示されます。

ページ上部のナビゲーション・バーを使用して名前でページ・グループを検索するか、またはページの表示を変更します。「ビュー」リストから選択して、デフォルトの表示を変更できます。使用可能なオプションは次のとおりです。

- アイコン(デフォルト): 各グループを大きいアイコンとして表示します。グループを編集するには、該当するアイコンをクリックします。

- 詳細: 各グループをレポートで1行に表示します。グループを編集するには、名前をクリックします。

4. グループに関連付けられたページを表示するには、「タスク」リストで「ページ・グループのレポート」をクリックします。

注意:
「タスク」リストは、現在グループが存在する場合のみ表示されます。

5. グループの名前および説明を編集するには、グループ名をクリックします。

アプリケーションのホームページからのページ・グループの表示

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

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

2. アプリケーション・ビルダーのホームページで、アプリケーションを選択します。

3. 「ビュー」リストから「グループ別」を選択し、「実行」をクリックします。
定義されているグループが表示されます。グループと関連付けられていないページは、「未割当て」フォルダに保存されます。

4. グループ内のページを表示するには、グループ名をクリックします。

ページ定義からのページ・グループの表示

ページ定義からページ・グループを表示するには、次のステップを実行します。

1. ページ定義にナビゲートします。「ページ定義へのアクセス」を参照してください。

2. 「ビュー」リストから「グループ」を選択し、「実行」をクリックします。

3. ページの右側にある「タスク」リストから選択します。

ページ・グループの作成

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

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

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

3. ページの右側にある「タスク」リストで、「ページ・グループ」をクリックします。

4. ページ・グループ・ページで、「作成」をクリックします。

5. 名前および説明(オプション)を入力して、「作成」をクリックします。

ページ・グループ定義へのアクセス

ページ・グループの作成時に、名前と説明を指定します。

ページ・グループ定義を編集するには、次のステップを実行します。

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

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

3. ページの右側にある「タスク」リストで、「ページ・グループ」をクリックします。
ページ・グループ・ページが表示されます。

4. ページ・グループを選択します。

5. ページ・グループ・ページで名前または説明を編集し、「変更の適用」をクリックします。

6. 次のページ・グループ定義に移動するには、「前へ」ボタン(<)と「次へ」ボタン(>)をクリックして、前のステップを繰り返します。

ページのページ・グループへの割当て

ページをグループに割り当てるには、次のステップを実行します。

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

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

3. ページの右側にある「タスク」リストで、「ページ・グループ」をクリックします。

4. 「タスク」リストで「未割当ての管理」をクリックします。
ページ・グループ割当ての管理ページが表示されます。ページ番号をクリックすることで、ページ属性ページに移動できます。ページ名をクリックすることで、「ページ定義」にリンクします。

5. 「新規グループ」リストから、ページを割り当てるグループを選択し、「実行」をクリックします。

6. 割り当てるページを選択して、「チェックした項目の割当て」をクリックします。

ページの他のページ・グループへの再割当て

ページをページ・グループに再割当てするには、次のステップを実行します。

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

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

3. ページの右側にある「タスク」リストで、「ページ・グループ」をクリックします。

4. 「タスク」リストで「割当ての管理」をクリックします。
ページ・グループ割当ての管理ページが表示されます。ページ番号をクリックすることで、ページ属性ページに移動できます。ページ名をクリックすることで、「ページ定義」にリンクします。

5. 「グループ」リストから、グループを選択して「実行」をクリックします。

6. 「新規グループ」から、ページを割り当てるグループを選択します。

7. 再割当てを行うページを選択して、「チェックした項目の割当て」をクリックします。

ページ・グループからのページの削除

ページ・グループからページを削除するには、次のステップを実行します。

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

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

3. ページの右側にある「タスク」リストで、「ページ・グループ」をクリックします。

4. 「タスク」リストで「割当ての管理」をクリックします。
ページ・グループ割当ての管理ページが表示されます。ページ番号をクリックすることで、ページ属性ページに移動できます。ページ名をクリックすることで、「ページ定義」にリンクします。

5. 「グループ」リストから、グループを選択して「実行」をクリックします。

6. 「名前」で「グループ」リストを探し、「- 割当て解除 -」を選択します。

7. 削除するページを選択します。

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

ページ・グループの削除

ページ・グループを削除するには、次のステップを実行します。

1. 削除するグループのすべてのページを削除します。「ページ・グループからのページの削除」を参照してください。

2. ページ・グループ・ページにアクセスします。「ページ・グループ定義へのアクセス」を参照してください。

3. 「削除」をクリックします。
「確認」ページが表示されます。

4. リクエストを確認します。

「ページ・グループごとのページ」レポートの表示

ページ・グループごとにページを確認するには、次のステップを実行します。

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

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

3. ページの右側にある「タスク」リストで、「ページ・グループ」をクリックします。

4. 「タスク」リストで、「ページ・グループのレポート」をクリックします。
「ページ・グループごとのページ」レポートが表示されます。ページ番号をクリックすることで、ページ属性ページに移動できます。ページ名をクリックすることで、「ページ定義」にリンクします。

5. ページ・グループを表示するには、「グループ」リストから選択して、「実行」をクリックします。

ページのロックおよびロック解除

アプリケーション開発中の競合を回避するには、アプリケーション内のページをロックします。ページをロックすると、他の開発者がページを編集できなくなります。

この項に含まれる内容は次のとおりです。

- ページがロックされているかどうかの判別

- ページのロック

- ページのロック解除

- ロックされたページの別のビューへのアクセス

ページがロックされているかどうかの判別

「ロック」アイコンは、ページが現在ロックされているかどうかを示します。ページのロックが解除されている場合、アイコンは鍵が開いた南京錠として表示されます。ページがロックされている場合、アイコンは鍵が掛かった南京錠として表示されます。「ロック」アイコンは、アプリケーションのホームページとページ定義に表示されます。

アプリケーションのホームページで「ロック」アイコンを表示するには、「ビュー」リストから「詳細」を選択します。ページ・リストが表示されます。「ロック」アイコンは「ロック」列の下に表示されます。

「ロック」アイコンはページ定義上のアクション・バーにも表示されます。「アクション・バーについて」を参照してください。

ページのロック

ページ・ロック・ページ、「ページ」リスト、およびページ定義からページをロックできます。

ページ・ロック・ページからのページのロック

ページ・ロック・ページからページをロックするには、次のステップを実行します。

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

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

3. ページの右側にある「タスク」リストで、「ページ・ロック」をクリックします。
ページ・ロック・ページが表示されます。

4. 該当するページを選択して、「ロックを選択済」をクリックします。

5. 「コメント」フィールドにコメントを入力します。

6. 「ページのロック」をクリックします。

「詳細」ビューからのページのロック

「詳細」ビューからページをロックするには、次のステップを実行します。

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

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

3. 「ビュー」リストから「詳細」を選択し、「実行」をクリックします。

4. 「ページ」リストで、ロックするページを指定して、「ロック」アイコンをクリックします。

5. 「コメント」フィールドにコメントを入力します。

6. 「ページのロック」をクリックします。

ページ定義からのページのロック

ページ定義からページをロックするには、次のステップを実行します。

1. 該当するページ定義にナビゲートします。「ページ定義へのアクセス」を参照してください。

2. アクション・バーの「ロック」アイコンをクリックします。「アクション・バーについて」を参照してください。

3. 選択済のページを選択して、「ロックを選択済」をクリックします。

4. 「コメント」フィールドにコメントを入力します。

5. 「ページのロック」をクリックします。

ページのロック解除

ページをロックした開発者のみが、そのページのロックを解除できます。ただし、管理権限を持つ開発者は、他の開発者がロックしたページのロックを解除できます。

ページ・ロック・ページからのページのロック解除

ページ定義からページのロックを解除するには、次のステップを実行します。

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

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

3. ページの右側にある「タスク」リストで、「ページ・ロック」をクリックします。
ページ・ロック・ページが表示されます。

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

5. 「ロック解除を選択済」をクリックします。

「詳細」ビューからのページのロック解除

「詳細」ビューからページをロック解除するには、次のステップを実行します。

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

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

3. 「ビュー」リストから「詳細」を選択し、「実行」をクリックします。

4. 「ページ」リストで、ロック解除するページを指定して、「ロック」アイコンをクリックします。
ロック・コメントの編集ページが表示されます。

5. 「ロック解除」をクリックします。

ページ定義からのページのロック解除

ページ定義からページのロックを解除するには、次のステップを実行します。

1. 該当するページ定義にナビゲートします。「ページ定義へのアクセス」を参照してください。

2. 「共有コンポーネント」の右上にある「ロック」アイコンをクリックします。
ページ・ロック・ページが表示されます。

3. ロック解除するページを選択し、「チェックした項目のロック解除」をクリックします。

ロックされたページの別のビューへのアクセス

「ロックされたページ」ページでは、ロックされたページの多数の様々なビューにアクセスできます。

ロックされたページの別のビューにアクセスするには、次のステップを実行します。

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

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

3. ページの右側にある「タスク」リストで、「ページ・ロック」をクリックします。

4. 「タスク」リストで次のいずれかをクリックします。

- ロックされたページの表示: カレント・アプリケーションのロックされたページのみを表示します。

- すべてのページの表示: カレント・アプリケーションのすべてのページを表示します。

- ロック解除されたページの表示: カレント・アプリケーションのロックが解除されたページのみを表示します。

- ロックの管理: 開発者によってロックされたページを、管理者によってロック解除できるようにします。

ページの削除

ページを削除するには、ページ定義から削除するか、ページ属性の編集中に削除します。

この項に含まれる内容は次のとおりです。

- ページ定義からのページの削除

- ページ属性の編集中にページの削除

ページ定義からのページの削除

ページ定義からページを削除するには、次のステップを実行します。

1. 該当するページ定義にナビゲートします。「ページ定義へのアクセス」を参照してください。

2. ページ名を確認します。

3. ページ上部の「削除」ボタンをクリックします。

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

関連項目:
ページ属性を編集する方法については、「ページ定義の編集」を参照してください。

ページ属性の編集中にページの削除

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

1. ページ定義にナビゲートします。「ページ定義へのアクセス」を参照してください。

2. 「ページ・レンダリング」で、「ページ」セクションの位置を特定します。

3. 「ページ属性の編集」アイコンをクリックしてページ属性ページにリンクします。このアイコンは、鉛筆が置かれた小さいページの形をしています。

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

4. ページ番号とページ名を確認します。

5. 「削除」をクリックします。

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

アプリケーション・コメントの追加

アプリケーション・コメント・ページのアプリケーション全体に関するコメントを追加できます。アプリケーションの説明またはアプリケーションで作業した開発者の追跡ができます。

この項に含まれる内容は次のとおりです。

- アプリケーション・コメントの作成

- アプリケーション・コメント・レポートの表示

関連項目:
「開発者コメントの追加」

アプリケーション・コメントの作成

アプリケーション・コメントを作成するには、次のステップを実行します。

1. 「ワークスペース」ホームページにナビゲートします。

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

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

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

5. 「アプリケーション」で、「コメント」をクリックします。
アプリケーション・コメント・ページが表示されます。

6. 「コメント」フィールドにコメントを入力して、「変更の適用」をクリックします。

アプリケーション・コメント・レポートの表示

アプリケーションに固有のレポートを表示するには、次のステップを実行します。

1. 「ワークスペース」ホームページにナビゲートします。

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

3. アプリケーションを選択します。
アプリケーションのホームページが表示されます。

4. 「タスク」リストで、「アプリケーション・レポート」をクリックします。

5. 「共有コンポーネント」をクリックしてから、「アプリケーション・コメント」をクリックします。

開発者コメントの追加

「開発者のコメント」アイコンを使用して、アプリケーション、ページまたはページ・グループに開発者のコメントを追加できます。「開発者のコメント」アイコンは、緑の吹出しの形をしています。アイコンは、「アクション」バーに表示されます。

開発者コメントは、アプリケーションの変更の通知、問題の報告、または開発者の提案の記録などに使用できます。

この項には、次の項目が含まれます。

- アプリケーションまたはページへの開発者コメントの追加

- 開発者コメントの表示と編集

- 開発者コメントの削除

- 開発者コメント・レポートについて

関連項目:
「アプリケーション・コメントの追加」

アプリケーションまたはページへの開発者コメントの追加

「開発者のコメント」アイコンは、特定のアプリケーションまたはアプリケーション・ページに関連するアプリケーション・ビルダー内のページに表示されます。アプリケーション、ページ、またはページ・グループに開発者のコメントを追加できます。

開発者コメントを追加するには、次のようにします。

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

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

3. 「開発者のコメント」アイコンをクリックします。
「コメントの作成」ページが別のウィンドウに表示されます。

4. 「関連ページ」で、コメントを適用するページを指定します。コメントの入力方法は次のとおりです。

- 特定のページに適用する場合、ページ番号を入力します。

- 複数のページに適用する場合、ページのカンマ区切りリストを入力します。次に例を示します。

1, 2, 3

- ページまたはページ・グループに適用しない場合、このフィールドをブランクのままにします。

5. 「コメント」に、テキストを最大4000文字まで入力します。

6. 「作成」または「別に作成」をクリックします。

開発者コメントの表示と編集

開発者コメントを編集するには、次のようにします。

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

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

3. 「開発者のコメント」アイコンをクリックします。
「コメントの作成」ページが別のウィンドウに表示されます。

4. 「コメントの表示」をクリックします。
コメントの表示ページが表示されます。「コメントの表示ページのナビゲーション・バーについて」を参照してください。

5. コメントを編集するには、「編集」アイコンをクリックします。
「コメントの編集」ページが表示されます。

1. 「関連ページ」で、コメントを適用するページを指定します。コメントの入力方法は次のとおりです。

- 特定のページに適用する場合、ページ番号を入力します。

- 複数のページに適用する場合、ページのカンマ区切りリストを入力します。次に例を示します。

1, 2, 3

- ページまたはページ・グループに適用しない場合、このフィールドをブランクのままにします。

2. 「コメント」に、テキストを最大4000文字まで入力します。

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

View Commentsページのナビゲーション・バーの概要

ナビゲーション・バーはコメントの表示ページの上部に表示され、次のコントロールが含まれています。

- 「ページ」。ページ番号を検索します。ページ番号を入力して「実行」をクリックします。すべてのページを表示する場合は、フィールドをブランクのままにして「実行」をクリックします。

- 「コメント」。コメントを検索します。コメント・テキストに大/小文字を区別しない問合せを入力して、「実行」をクリックします。すべてのコメントを表示する場合は、フィールドをブランクのままにして「実行」をクリックします。

- 「開発者」。特定の開発者に表示を限定します。表示する開発者を選択して「実行」をクリックします。

- 「表示」。コメントの表示方法を指定します。表示されるコメント数の増減を行うには、「表示」リストで選択を行ってから「実行」をクリックします。

開発者コメントの削除

コメントの編集ページまたはコメントの管理ページで、開発者コメントを削除できます。

この項に含まれる内容は次のとおりです。

- 特定の開発者コメントの削除

- 複数の開発者コメントの削除

特定の開発者コメントの削除

開発者コメントを削除するには、次のようにします。

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

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

3. 「開発者のコメント」アイコンをクリックします。
「コメントの作成」ページが別のウィンドウに表示されます。

4. 「コメントの表示」をクリックします。

5. 削除するコメントを探します。「コメントの表示ページのナビゲーション・バーについて」を参照してください。

6. 「編集」アイコンをクリックします。
「コメントの編集」ページが表示されます。

7. 「削除」をクリックします。

複数の開発者コメントの削除

複数の開発者コメントを削除するには、次のようにします。

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

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

3. 「開発者のコメント」アイコンをクリックします。
「コメントの作成」ページが別のウィンドウに表示されます。

4. 「コメントの管理」をクリックします。

5. 次のアクションの1つを選択します。

- すべてのコメントの削除

- 開発者別に作成されたコメントの削除

- 日付別のコメントの削除

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

開発者コメント・レポートについて

開発者コメント・レポートから開発者コメントを表示、編集および管理することもできます。

この項に含まれる内容は次のとおりです。

- 開発者コメント・レポートへのアクセス

- 開発者コメント・レポートからのコメントの編集

- 開発者コメント・レポートからのコメントの削除

- 開発者コメント・レポートからの複数のコメントの削除

- 開発者コメント・レポートのダウンロード

開発者コメント・レポートへのアクセス

開発者コメント・レポートにアクセスするには、次のようにします。

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

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

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

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

5. 「アプリケーション・レポート」で「開発者のコメント」をクリックします。
開発者コメント・レポートが表示されます。

ナビゲーション・バーはページの上部に表示され、次のコントロールが含まれています。

- 「ページ」。ページ番号を検索します。ページ番号を入力して「実行」をクリックします。すべてのページを表示する場合は、フィールドをブランクのままにして「実行」をクリックします。

- 「コメント」。コメントを検索します。コメント・テキストに大/小文字を区別しない問合せを入力して、「実行」をクリックします。すべてのコメントを表示する場合は、フィールドをブランクのままにして「実行」をクリックします。

- 「開発者」。特定の開発者に表示を限定します。表示する開発者を選択して「実行」をクリックします。

- 「日付」。特定の日付に表示を限定します。日付を選択して「実行」をクリックします。

- 「表示」。コメントの表示方法を指定します。表示されるコメント数の増減を行うには、「表示」リストで選択を行ってから「実行」をクリックします。

開発者コメント・レポートからのコメントの編集

開発者コメント・レポートからコメントを編集するには、次のようにします。

1. 開発者コメント・レポートにナビゲートします。「開発者コメント・レポートへのアクセス」を参照してください。
開発者コメント・レポートが表示されます。

2. 編集するコメントを探します。

3. 「編集」アイコンをクリックします。
「コメントの編集」ページが別のウィンドウに表示されます。

1. 「関連ページ」で、コメントを適用するページを指定します。コメントの入力方法は次のとおりです。

- 特定のページに適用する場合、ページ番号を入力します。

- 複数のページに適用する場合、ページのカンマ区切りリストを入力します。次に例を示します。

1, 2, 3

- ページまたはページ・グループに適用しない場合、このフィールドをブランクのままにします。

2. 「コメント」に、テキストを最大4000文字まで入力します。

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

開発者コメント・レポートからのコメントの削除

開発者コメント・レポートからコメントを削除するには、次のようにします。

1. 開発者コメント・レポートにナビゲートします。「開発者コメント・レポートへのアクセス」を参照してください。
開発者コメント・レポートが表示されます。

2. 削除するコメントを探します。

3. 「編集」アイコンをクリックします。
「コメントの編集」ページが別のウィンドウに表示されます。

4. 「削除」をクリックします。

開発者コメント・レポートからの複数のコメントの削除

開発者コメント・レポートから複数のコメントを削除するには、次のようにします。

1. 開発者コメント・レポートにナビゲートします。「開発者コメント・レポートへのアクセス」を参照してください。
開発者コメント・レポートが表示されます。

2. 削除するコメントを探します。

3. 「編集」アイコンをクリックします。
「コメントの編集」ページが別のウィンドウに表示されます。

4. 「コメントの管理」をクリックします。

5. 次のアクションの1つを選択します。

- すべてのコメントの削除

- 開発者別に作成されたコメントの削除

- 日付別のコメントの削除

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

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

開発者コメント・レポートのダウンロード

「エクスポート」リンクをクリックすることで、開発者コメント・レポートをカンマ区切り(.csv)ファイルとしてダウンロードできます。

開発者コメント・レポートをダウンロードするには、次のようにします。

1. 開発者コメント・レポートにナビゲートします。「開発者コメント・レポートへのアクセス」を参照してください。
開発者コメント・レポートが表示されます。

2. ページ下部の「エクスポート」リンクをクリックします。

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

アプリケーション・グループの作成

アプリケーションをアプリケーション・グループに割り当てることにより、アプリケーションを整理できます。アプリケーション・グループを使用するには、「作成」ボタンをクリックしてグループを作成し、そのグループにアプリケーションを割り当てます。

この項に含まれる内容は次のとおりです。

- アプリケーション・グループの表示

- アプリケーション・グループの作成

- アプリケーション・グループへのアプリケーションの割当て

- アプリケーション・グループからのアプリケーションの削除

- アプリケーション・グループの削除

アプリケーション・グループの表示

ここでは、アプリケーション・グループを表示する様々な方法について説明します。

アプリケーション・グループ・ページへのアクセス

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

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

2. ページの右側にある「タスク」リストで、「アプリケーション・グループ」をクリックします。
アプリケーション・グループ・ページが表示されます。

ページ上部のナビゲーション・バーを使用して名前でページ・グループを検索するか、またはページの表示を変更します。「ビュー」リストから選択して、デフォルトの表示を変更できます。使用可能なオプションは次のとおりです。

- アイコン(デフォルト): 各グループを大きいアイコンとして表示します。グループを編集するには、該当するアイコンをクリックします。

- 詳細: 各グループをレポートで1行に表示します。グループを編集するには、名前をクリックします。

3. グループに関連付けられたアプリケーションを表示するには、グループ名をクリックします。

注意:
「タスク」リストは、現在グループが存在する場合のみ表示されます。

アプリケーション・ビルダーのホームページからのページ・グループの表示

アプリケーション・ビルダーのホームページからページ・グループを表示するには、次のステップを実行します。

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

2. 「ビュー」リストから「グループ別」を選択し、「実行」をクリックします。
定義されているグループが表示されます。

3. ページ・グループを表示または編集するには、グループ名をクリックします。

アプリケーション・グループの作成

アプリケーション・グループを作成するには、次のステップを実行します。

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

2. ページの右側にある「タスク」リストで、「アプリケーション・グループ」をクリックします。

3. アプリケーション・グループ・ページで、「作成」をクリックします。

4. 名前および説明(オプション)を入力して、「作成」をクリックします。

アプリケーション・グループ定義の編集

ページ・グループの作成時に、名前と説明を指定します。

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

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

2. ページの右側にある「タスク」リストで、「アプリケーション・グループ」をクリックします。
アプリケーション・グループ・ページが表示されます。

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

4. アプリケーション・グループ・ページで名前または説明を編集し、「変更の適用」をクリックします。

アプリケーション・グループへのアプリケーションの割当て

アプリケーションをグループに割り当てるには、次のステップを実行します。

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

2. ページの右側にある「タスク」リストで、「アプリケーション・グループ」をクリックします。

3. 「タスク」リストで「未割当ての管理」をクリックします。
アプリケーション・グループ割当ての管理ページが表示されます。

4. 「新規グループ」リストから、グループを選択します。

5. 割り当てるアプリケーションを選択して、「チェックした項目の割当て」をクリックします。

ヒント:
アプリケーション・グループへのアプリケーションの割当ては、アプリケーション定義を編集して行うこともできます。グループは、「アプリケーション・グループ」リストから選択します。「アプリケーション定義の構成」を参照してください。

アプリケーション・グループからのアプリケーションの削除

アプリケーション・グループからアプリケーションを削除するには、次のステップを実行します。

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

2. ページの右側にある「タスク」リストで、「アプリケーション・グループ」をクリックします。

3. 「タスク」リストで「未割当ての管理」をクリックします。
アプリケーション・グループ割当ての管理ページが表示されます。

4. 「新規グループ」リストから、「- 割当て解除 -」を選択します。

5. 割当てを解除するページを選択して、「チェックした項目の割当て」をクリックします。

ヒント:
アプリケーション・グループからのアプリケーションの削除は、アプリケーション定義を編集して行うこともできます。「アプリケーション・グループ」リストから「未割当て」を選択します。「アプリケーション定義の構成」を参照してください。

アプリケーション・グループの削除

アプリケーション・グループを削除するには、次のステップを実行します。

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

2. ページの右側にある「タスク」リストで、「アプリケーション・グループ」をクリックします。

3. グループ内のすべてのアプリケーションに「- 割当て解除 -」を割り当てます。「アプリケーション・グループからのアプリケーションの削除」を参照してください。

4. アプリケーション・グループ・ページに戻ります。

5. 削除するアプリケーション・グループを選択します。

6. アプリケーション・グループ・ページで、「削除」をクリックします。
「確認」ページが表示されます。

7. リクエストを確認します。

アプリケーション・レポートの表示

アプリケーション・ビルダーには100を超えるレポートが用意され、アプリケーションの様々な側面からの全体的なビューが提供されます。アプリケーション・レポートを使用して、アプリケーション内の共有コンポーネントやページ・コンポーネント間の一貫性を実現できます。たとえば、アプリケーション内の全ページで使用されるボタンの詳細を表示できます。さらに、多くのレポートは更新可能なため、個々のページに移動せずにアイテムやリージョン・ラベルなどのコンポーネントを標準化できます。

この項に含まれる内容は次のとおりです。

- アプリケーション・レポートへのアクセス

- 共有コンポーネント・レポート

- ページ・コンポーネント・レポート

- アクティビティ・レポート

- アプリケーション間レポート

関連項目:
「APEX_ACTIVITY_LOGを使用したカスタム・アクティビティ・レポートの作成」

アプリケーション・レポートへのアクセス

アプリケーションに固有のレポートを表示するには、次のステップを実行します。

1. 「ワークスペース」ホームページにナビゲートします。

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

3. アプリケーションを選択します。
アプリケーションのホームページが表示されます。

4. 「タスク」リストで、「アプリケーション・レポート」をクリックします。

5. 表示するレポートのタイプを選択します。

- 共有コンポーネント。「共有コンポーネント・レポート」を参照してください。

- ページ・コンポーネント。「ページ・コンポーネント・レポート」を参照してください。

- アクティビティ。「アクティビティ・レポート」を参照してください。

- アプリケーション間。「アプリケーション間レポート」を参照してください。

関連項目:
「問題を引き起こす可能性のあるパスワード・アイテムの識別」

共有コンポーネント・レポート

共有コンポーネント・レポートは、アプリケーション内の各ページに表示できる共通する要素に関する情報を提供します。これらのレポートは、「アプリケーション」、「ロジック」、「セキュリティ」、「グローバリゼーション」、「条件付きコンポーネント」、「ナビゲーション」、「ユーザー・インタフェース」および「ファイル」などのカテゴリでグループ化されます。レポートの例には、開発者のコメント、データベース・オブジェクトの依存性、アプリケーション・アイテム、アプリケーションの計算、認証スキームおよびショートカットなどがあります。

データベース・オブジェクトの依存性レポート

データベース・オブジェクトの依存性レポートは、カレント・アプリケーションで参照されるデータベース・オブジェクトを識別します。アプリケーションのデプロイ時に移動するオブジェクトを判別するには、このレポートを確認します。

関連項目:
「別の開発インスタンスへのアプリケーションの移動方法」および「アプリケーション・レポートの表示」

データベース・オブジェクトの依存性レポートを表示するには、次のステップを実行します。

1. 該当するアプリケーションにナビゲートします。

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

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

2. 「タスク」リストで、「アプリケーション・レポート」をクリックします。

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

4. 「アプリケーション」で、「データベース・オブジェクトの依存性」をクリックします。

5. 「依存性の計算」をクリックします。

6. 特定のデータベース・オブジェクトを参照するコンポーネントを表示するには、「参照カウント」の番号を選択します。

ページ・コンポーネント・レポート

「ページ・コンポーネント」レポートは、ページのレンダリング時に実行されるコントロールとロジックに関する詳細情報(たとえば、ブランチ、ボタン、計算、アイテム、リージョンなど)を提供します。

関連項目:
「複数のアイテム・ヘルプ・トピックの同時編集」

リージョン・ソースの検索レポートの概要

リージョン・ソースの検索レポートを使用して、アプリケーション内のすべてのリージョン・ソースを介して検索します。

リージョン・ソースの検索レポートを表示するには、次のステップを実行します。

1. 「ワークスペース」ホームページにナビゲートします。

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

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

4. 「タスク」リストで、「アプリケーション・レポート」をクリックします。

5. 「ページ・コンポーネント」をクリックします。

6. 「リージョン」で、「ソースの検索」をクリックします。

7. リージョンのページ定義を表示するには、ページ番号を選択します。

8. リージョンのリージョン属性を表示するには、リージョン名を選択します。

アクティビティ・レポート

アクティビティ・レポートは、カレント・アプリケーション内の開発者アクティビティに関する詳細を提供します。使用可能なレポートは、「ページ・ビュー」、「キャッシュ」、「開発者アクティビティ」および「セッション」の各カテゴリにグループ化されます。

ヒント:
開発者ツールバーの「アクティビティ」リンクをクリックしてもアクティビティ・ページにアクセスできます。「開発者ツールバーについて」を参照してください。

時間別のページ・ビューの概要

「時間別のページ・ビュー」を表示するには、次のステップを実行します。

1. 「ワークスペース」ホームページにナビゲートします。

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

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

4. 「タスク」リストで、「アプリケーション・レポート」をクリックします。

5. 「アクティビティ」をクリックします。

6. 「ページ・ビュー」で、「時間別」をクリックします。

アプリケーション間レポート

クロス・アプリケーション・レポートは、複数のアプリケーションに適用される情報を提供します。使用可能なレポートには、「アプリケーション属性」、「アプリケーション・コメント」、「ビルド・オプション」、「ビルド・ステータスとアプリケーション・ステータス」、「ページ・コンポーネント・カウント」、「セキュリティ・プロファイル」、「認証スキーム」、および「アプリケーション別のデフォルトのテンプレート」などがあります。

アプリケーションの比較レポートの概要

アプリケーションの比較レポートを使用して2つのアプリケーションを比較します。

アプリケーションの比較レポートを表示するには、次のステップを実行します。

1. 「ワークスペース」ホームページにナビゲートします。

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

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

4. 「タスク」リストで、「アプリケーション・レポート」をクリックします。

5. 「アプリケーション間」をクリックします。
アプリケーションの比較ページが表示されます。

6. ナビゲーション・バーで、次の項目を指定します。

1. アプリケーション1 - 比較する1つ目のアプリケーションを選択します。

2. アプリケーション2 - 比較する2つ目のアプリケーションを選択します。

3. コンポーネント - レポートに含めるコンポーネントを選択します。

4. ページ - 比較する特定のページ番号を識別します。

5. 表示 - 各ページに表示される差分の数を選択します。

6. 「実行」をクリックします。

7. 差分のみを表示する場合は、「差分のみ表示」を選択し、「実行」をクリックします。

8. 詳細を表示する場合は、「詳細の表示」を選択し、「実行」をクリックします。

ページ・レベル・アイテムの理解

アイテムは、HTMLフォームの一部です。アイテムは、テキスト・フィールド、テキスト領域、パスワード、選択リスト、チェック・ボックスなどを示します。アイテム属性は、ページ上のアイテムの表示に影響します。たとえば、これらの属性は、ラベルの表示位置、アイテムの大きさおよびアイテムの表示位置(左右、上下)に影響します。

この項に含まれる内容は次のとおりです。

- ページ・アイテムとアプリケーション・アイテムの違い

- ページ定義の「アイテム」セクションについて

- ページ・レベル・アイテムの作成

- ページ・レベル・アイテムの編集

- ドラッグ・アンド・ドロップ・レイアウト・ページの使用

- アイテム値の参照

- 条件付きページ・アイテムまたは読取り専用ページ・アイテムの表示

- 複数選択リスト・アイテムでの操作

関連項目:
「アプリケーション・レベル・アイテムの理解」、「アイテム属性がページ・レイアウトに与える影響」、「置換文字列の理解」および「「アイテム・ファインダ」について」

ページ・アイテムとアプリケーション・アイテムの違い

アイテムには、ページ・アイテムとアプリケーション・アイテムの2つのタイプが存在します。ページ・アイテムはページ上に配置され、「表示形式」、「ラベル」、「ラベル・テンプレート」などの関連付けられたユーザー・インタフェースのプロパティを持ちます。ページ・レベル・アイテムの例としてはチェック・ボックス、日付ピッカー、テキストとしての表示、「ファイル参照」フィールド、「ポップアップLOV」、「選択リスト」、または「テキスト領域」などがあります。アプリケーション・アイテムはページに関連付けられないため、ユーザー・インタフェースのプロパティを持ちません。アプリケーション・アイテムは、グローバル変数として使用できます。

関連項目:
「アプリケーション・レベル・アイテムの理解」

ページ定義の「アイテム」セクションについて

ページ定義のページ・レベル・アイテムを作成および編集します。「アイテム」セクションは「ページ・レンダリング」領域に表示されます。

「アイテム」アイコンをクリックすると、他のすべてのサブセクションを一時的に非表示にできます。表示を元に戻すには、「すべての表示」をクリックします。「すべて表示」アイコンは、下向き三角形の形をしています。

セクション・タイトルの横には次のアイコンが表示されます。

- すべて編集: 「すべて編集」アイコンは、鉛筆が置かれた小さいグリッドの形をしています。すべてのアイテムを一度に編集する場合に、このアイコンを使用します。「「すべて編集」アイコンを使用した複数アイテムの編集」を参照してください。

- コピー: 「コピー」アイコンは、小さいページが2つ重なった形をしています。既存のアイテムをコピーする場合に、このアイコンを使用します。

- 作成: 「作成」アイコンは、プラス(+)記号が置かれた小さいページの形をしています。アイテムを作成する場合に、このアイコンを使用します。

アイテムはリージョンごとに編成されます。アイテムを編集するには、アイテム名をクリックします。

関連項目:
「ページ・アイテム属性の編集」および「ボタンの順序変更」アイコンの使用」

「ドラッグ・アンド・ドロップ」アイコンの概要

「ドラッグ・アンド・ドロップ」アイコンをクリックしてドラッグ・アンド・ドロップ・レイアウト・ページにアクセスすると、ページの外観を迅速に変更できます。「ドラッグ・アンド・ドロップ」アイコンは緑の四角形で、「リージョン・アイテムの順序変更」アイコンの右側に表示されます。

ドラッグ・アンド・ドロップ・レイアウト・ページを使用して、指定したリージョン内でのアイテムの順序変更、選択したアイテム属性の変更、アイテムの作成、または既存のアイテムの削除をインタラクティブに行うことができます。「ドラッグ・アンド・ドロップ・レイアウト・ページの使用」を参照してください。

「アイテムの順序変更」アイコンの概要

「リージョン・アイテムの順序変更」アイコンをクリックすると、ラベルやリージョン内のアイテムの位置をすぐに編集できます。このアイコンは明るい緑色の下向きまたは上向きの矢印のような形をしています。

関連項目:
「リージョン・アイテムの順序変更」アイコンの使用

ページ・レベル・アイテムの作成

アイテムの作成ウィザードを実行して、ページ・レベル・アイテムを作成できます。

この項に含まれる内容は次のとおりです。

- 「ページ定義」でのページ・レベル・アイテムの作成

- アイテムのネーミング規則について

- アイテム・タイプについて

- 「表形式フォーム」を使用した複数アイテムの作成

- ドラッグ・アンド・ドロップを使用した複数のアイテムの作成

- 静的値リストの作成

関連項目:
「ページ・アイテムとアプリケーション・アイテムの違い」

「ページ定義」でのページ・レベル・アイテムの作成

ページ・レベル・アイテムを作成するには、ページ定義から「アイテムの作成」ウィザードを実行します。

ページ・レベル・アイテムを作成するには、次のステップを実行します。

1. 該当するページ定義にナビゲートします。「ページ定義へのアクセス」を参照してください。

2. 必要に応じて、HTMLリージョンを作成します。「リージョンの理解」を参照してください。

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

4. アイテム・タイプを選択します。「アイテム・タイプについて」を参照してください。

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

6. 特定のフィールドの詳細を表示するには、フィールド・ラベルをクリックします。
ヘルプが使用できる場合、アイテム・ラベルの上にカーソルを置くとアイテム・ラベルは赤に変わり、カーソルは矢印と疑問符マークに変わります。「フィールドレベル・ヘルプについて」を参照してください。

アイテムのネーミング規則について

アイテム名を指定する場合は、次の規則に注意してください。規則は次のとおりです。

- アプリケーション内で一意である必要があります。

- 一重引用符を使用しないでください。

- 先頭は文字または数字である必要があります。その後は、文字、数字またはアンダースコア文字を使用できます。

- 大/小文字が区別されません。

- 30文字以下にする必要があります。

- 基本ASCIIキャラクタ・セット以外の文字を含めることはできません。

アイテム・タイプについて

アイテムの作成時に、アイテム・タイプを指定します。アイテムを作成すると、ページ・アイテムの編集ページの「表示形式」リストに、アイテムのタイプが表示されます。表 6-2に、使用可能なアイテム・タイプを示します。

表 6-2 使用可能なアイテム・タイプ

アイテム・タイプ

説明

チェック・ボックス

LOVを使用して表示します。チェック・ボックスとして表示されるアイテムには、LOVが必要です。選択したチェック・ボックスに対応する値が、コロンで区切られた文字列で戻されます。

次の例に、YESを戻す単一のチェック・ボックスを作成する方法を示します。この例では、チェック・ボックスとフィールド・ラベルの両方が表示されます。

SELECT NULL display_text, 'YES' return_value FROM DUAL;

次の例では、追加テキストClick to selectを含めます。

SELECT 'Click to select' display_text, 'YES' return_value FROM DUAL;

参照: 戻り値の分割については、Oracle Application Express APIリファレンスの「APEX_UTIL」を参照してください。

日付ピッカー

横にカレンダ・アイコンが付いたテキスト・フィールドを表示します。このアイコンをクリックすると小さいカレンダが表示され、ユーザーは日付および時刻を選択できます(オプション)。

必要な書式が「表示形式」リストに表示されない場合は、「日付ピッカー(アプリケーションの書式マスクを使用)」か「日付ピッカー(アイテムの書式マスクを使用)」を選択します。後者はページ・アイテムの編集ページの「ソース」セクションの「書式マスク」フィールドの値を使用します。

表示のみ

「テキストとして表示」には次のサブタイプがあります。

- テキストとして表示(状態は保存しない) - フォーム・アイテムを作成せずに、アイテムのソース値をページ上に表示します。

- テキストとして表示(特殊文字をエスケープし、状態は保存しない) - 特殊文字('<'、'>'、'&')をエスケープしてアイテムのソース値を表示します。

- テキストとして表示(状態を保存する) - アイテムのソース値を表示し、値をセッション・ステートに渡すためページとともに送信されるフォーム・アイテムを作成します。

- テキストとして表示(LOVに基づき、状態は保存しない) - アイテムのソース値をLOVの戻り値と照合することで、表示値をLOVから表示します。

- テキストとして表示(LOVに基づき、状態を保存する) - 前述のオプションとほぼ同じですが、戻り値をセッション・ステートに渡すためページとともに送信されるフォーム・アイテムも生成します。

ファイル参照

「参照」ボタンが付いたテキスト・フィールドを表示します。「参照」ボタンを使用すると、ローカル・ファイル・システムのファイルを検索、およびアップロードできます。Oracle Application Expressは、これらのファイルをアップロードする表、およびファイルを取得するAPIを提供します。

関連項目: 「ファイルのアップロードの保護」

非表示

HTMLの非表示のフォーム要素をレンダリングします。セッション・ステートは、テキスト・フィールドと同様に割当ておよび参照することができます。

非表示で保護

HTMLの非表示のフォーム要素をレンダリングします。セッション・ステートは、テキスト・フィールドと同様に割当ておよび参照することができます。たとえば、ページがOracle Application Expressによってレンダリングされた後でアイテムの値を変更するJavaScriptなどのように、クライアント側の動作がページにないかぎり、セキュリティを最高に保つため、「非表示」ではなく「非表示で保護」を使用します。

リスト・マネージャ

LOVに基づきます。このアイテムを使用すると、アイテムを選択し、リストに追加してアイテム・リストを管理できます。LOVはポップアップ表示されます。

複数選択

複数選択HTMLフォーム要素としてレンダリングします。送信されると、選択した値は単一のコロンで区切られた文字列に戻されます。APEX_UTIL APIを使用して、値を分割できます。

参照: 「複数選択リスト・アイテムでの操作」およびOracle Application Express APIリファレンスの「APEX_UTIL」

パスワード

HTMLのパスワードのフォーム要素としてレンダリングします。使用可能なパスワードのタイプには、次のものがあります。

- パスワード - フィールドに入力されたテキストを非表示にします。ページの送信時に、セッション・ステートに値が保存されます。

- パスワード([Enter]を押すと送信) - フィールドに入力されたテキストを非表示にします。[Enter]を押すと、ページが送信されます。

- パスワード(状態は保存しない) - フィールドに入力されたテキストを非表示にします。セッション・ステートに値が保存されません。

- パスワード([Enter]を押すと送信し、状態は保存しない): フィールドに入力されたテキストを非表示にします。[Enter]を押すと、ページが送信されます。セッション・ステートに値が保存されません。

「パスワード」および「パスワード([Enter]を押すと送信)」では、ページの送信時にデータベース表にパスワードが保存されます。これらのパスワード・アイテム・タイプは、セッション中に他のページで使用するためにセッション・ステートのパスワードが必要になる場合にのみ使用します。

「パスワード(状態は保存しない)」および「パスワード([Enter]を押すと送信し、状態は保存しない)」では、データベース表にパスワードが保存されません。これらのパスワード・アイテム・タイプは、送信したパスワードの値が同じページでの送信後のページ・プロセスでのみ使用され、セッション中に要求されることがない場合にのみ使用します。

アプリケーションでパスワードの値を参照および取得する必要がある場合は、「セッション・ステートに暗号化された値を保存」属性を「はい」に設定します。詳細は、「セッション・ステートおよびセキュリティの概要」を参照してください。

ポップアップLOV

アイコン付きのテキスト・フィールドとしてレンダリングします。アイコンをクリックすると、ユーザーが選択した次のいずれかとともにポップアップ・ウィンドウが表示されます。

- 一連のリンクとして表示された値のリスト - このリストから選択すると、選択した値がテキスト・フィールドに配置されます。

- カラー・ピッカー - パレットから選択すると、選択した色のHTML値(たとえば黒は#000000)が戻されます。

カラー・ピッカーを除いて、テンプレートでポップアップLOVを制御します。アプリケーションごとに1つのみポップアップLOVを指定できます。ポップアップLOVは、単一のページに戻すには大きすぎるLOVに対して有効です。

ポップアップLOVには、ウィンドウがポップアップ表示された際に行セットをフェッチするものと、フェッチしないものの2つのタイプがあります。使用できるポップアップLOVは次のとおりです。

- ポップアップ・キーLOV (説明を表示し、キー値を戻す)

- ポップアップ・キーLOV (フェッチなし) (説明を表示し、プリフェッチせずにキー値を戻す)

- ポップアップLOV(最初の行セットおよびフィルタをフェッチ)

- ポップアップLOV(最初の行セットをフェッチ)

- ポップアップLOV(フェッチなし)

- ポップアップ・カラー・ピッカー

ポップアップLOVは、異なる列別名を持つ2つの列を選択する問合せに基づく必要があります。次に例を示します。

SELECT ename name, empno id
FROM emp

いずれかの列が式の場合は、別名を使用します。次に例を示します。

SELECT ename||' '||job display_value, empno FROM emp

ラジオ

LOVに基づき、HTMLラジオ・グループ・フォーム要素としてレンダリングします。ラジオ・ボタンの選択時にページを送信するには、「送信機能付きラジオ・グループ」を選択します。

次の例では、従業員名(ename)が表示されますが、従業員番号(empno)が戻されます。

SELECT ename, empno FROM emp

選択リスト

LOVを使用して表示します。選択リストとしてアイテムを表示するには、LOVが必要です。選択リストは、HTMLフォーム要素<selectを使用してレンダリングされます。選択リストの値は、名前付きLOVまたはアイテム・レベルで定義されたLOVで決まります。表示値および戻り値にはNULLを指定できます。

次の例では、従業員名(ename)および従業員番号(empno)がemp表から戻されます。列の別名は必須ではありませんが、この例では、意味を明確にするために含まれています。

SELECT ename display_text, empno return_value FROM emp

Oracle Application Expressでは、標準的なHTML選択リストに加えて次の拡張機能が提供されます。

- 送信機能付き選択リスト: ユーザーがページで選択した値を変更すると、そのページが送信されます。ページが送信されると、選択リストを表すアイテム名にREQUESTが設定され、条件付き計算、検証、プロセスおよびブランチを実行できます。

- リダイレクト機能付き選択リスト - ユーザーを同じページにリダイレクトし、セッション・ステートの選択リストの新しく選択された値のみを設定します。

- URLリダイレクトを戻す選択リスト - 戻り値としてURLを含むLOVに基づきます。選択リストの値を変更すると、ブラウザが対応するURLにリダイレクトします。

- ページへのブランチ付き選択リスト - 戻り値としてページ番号を含むLOVに基づきます。選択リストで選択された値を変更すると、Application Expressエンジンが対応するページにブランチします。

注意: 選択リストが長くなると、エラーが発生する可能性があります。エラーが発生する長い選択リストがある場合は、その選択リストのかわりにポップアップLOVを使用することをお薦めします。

シャトル

複数のリストを含むボックスが2つある複数の選択リストとしてレンダリングします。左側にあるリストにはソースのLOVが表示されます。ユーザーはシャトル・コントロール・アイコンとボタンを使用してリスト・アイテムを選択し、左側にある「ソース」リストから右側にある「宛先」リストに移動します。各シャトルには、次の5つの制御があります。

- すべて移動: 「ソース」リストのすべてのアイテムを「宛先」リストに移動します。

- 選択項目を移動: 選択したアイテム([Ctrl]+[Shift]でアイテムを選択)のみを「宛先」リストに移動します。

- 選択対象の削除: 選択したアイテム([Ctrl]+[Shift]でアイテムを選択)のみを「ソース」リストに移動します。

- すべて削除: 「宛先」リストのすべてのアイテムを「ソース」リストに戻します。

- リフレッシュ: 「ソース」リストおよび「宛先」リストをリセットします。

右側にある「宛先」リストにはソート制御の「最上位に移動」ボタン、「上に移動」ボタン、「下に移動」ボタンおよび「最下位に移動」ボタンが含まれています。

注意: このアイテム・タイプを作成するにはLOVを定義する必要があります。「静的値リストの作成」、「LOVの作成」および「複数選択リスト・アイテムでの操作」を参照してください。

テキスト

最大30,000バイトのテキストを含むHTMLテキスト・フィールドとして表示します。「高さ」および「幅」アイテム属性を編集して最大長と表示幅を制御します。

使用可能なテキスト表示オプションは、次のとおりです。

- テキスト・フィールド - テキスト・フィールドとしてレンダリングします。

- テキスト・フィールド(無効、状態を保存しない) - セッション・ステートのアイテムの値を使用してLOVから読取り専用バージョンの表示値を表示し、関連付けられたLOVで対応する表示値を検索します。画面に表示された値は、送信時にセッション・ステートには保存されません。

- テキスト・フィールド(無効、状態を保存する) - セッション・ステートのアイテムの値を使用してLOVから読取り専用バージョンの表示値を表示し、関連付けられたLOVで対応する表示値を検索します。

- テキスト・フィールド([Enter]を押すと常にページを送信) - セッション・ステートの読取り専用バージョンの値を表示します。送信されると、表示された値はセッション・ステートに保存されます。

- ポップアップ計算機付きテキスト・フィールド - 横にアイコンが付いたテキスト・フィールドとしてレンダリングします。このアイコンをクリックすると、計算機付きの小さいウィンドウが表示されます。計算結果は、テキスト・フィールドに表示されます。

テキスト領域

HTMLのテキスト領域としてレンダリングします。テキスト領域として表示されるアイテムの最大長はありません。「高さ」および「幅」アイテム属性を編集して、高さと幅を制御します。さらに使用可能なテキスト領域の表示形式のオプションには、次のものがあります。

- テキスト領域

- テキスト領域(高さ自動) - テキストの量に応じて高さが変わります。テキスト領域をデータ量に応じて決める場合は、このオプションを使用します。

- 文字カウント機能付きテキスト領域 - フィールドに入力されたバイト数を示すカウンタを含みます。

- スペル・チェック機能付きテキスト領域 - ポップアップの英語スペル・チェッカを提供します。

- HTMLエディタ最小 - ボールド、イタリック、下線、箇条書き、インデントなど、基本的なテキスト編集機能を提供します。

- HTMLエディタ標準:フォント、フォーマット、色など、「HTMLエディタ最小」より多くのテキスト編集機能を提供します。

- HTMLエディタ付きテキスト領域:基本的なテキスト書式制御を提供します。一部のブラウザでは、これらの制御が動作しない場合があることに注意してください。

表の停止および開始

</table>タグでHTML表がクローズされ、HTML表が開始されます。このアイテム・タイプを使用してリージョンの中央部分で列の幅を再設定できます。

「表の停止および開始」アイテムでは、ラベルのみが表示されることに注意してください。このラベルを非表示にするには、NULLに設定します。これを行うには、デフォルトのラベルを削除します。

表形式フォームを使用した複数アイテムの作成

複数のアイテムを同時に作成するには、次のステップを実行します。

1. 該当するページ定義にナビゲートします。「ページ定義へのアクセス」を参照してください。

2. 必要に応じて、HTMLリージョンを作成します。「リージョンの理解」を参照してください。

3. 「アイテム」で、「作成」アイコンをクリックします。
アイテムの作成ウィザードが表示されます。

4. ページの最下部で、「表形式フォームを使用した複数アイテムの作成」リンクをクリックします。

5. 複数のアイテムの作成ページで、次のように指定します。

1. リージョンにアイテムの作成: アイテムを含めるリージョンを選択します。

2. アイテム・テンプレート: アイテム・テンプレートを選択します。

3. 各アイテムの「順序」、「名前」、「ラベル」、「タイプ」を入力し、アイテムがキャッシュする必要があるかどうかを指定します。

6. 「複数のアイテムの作成」をクリックします。

関連項目:
「ドラッグ・アンド・ドロップ」アイコンについて

ドラッグ・アンド・ドロップを使用した複数のアイテムの作成

ドラッグ・アンド・ドロップ・レイアウト・ページを使用して複数のアイテムを作成するには、次のステップを実行します。

1. 該当するページ定義にナビゲートします。「ページ定義へのアクセス」を参照してください。

2. 必要に応じて、HTMLリージョンを作成します。「リージョンの理解」を参照してください。

3. 「アイテム」で、「作成」アイコンをクリックします。
アイテムの作成ウィザードが表示されます。

4. ページの最下部で、「ドラッグ・アンド・ドロップ・レイアウトを使用した複数アイテムの作成」リンクをクリックします。
ドラッグ・アンド・ドロップ・レイアウト・ページが表示されます。

5. ページ左側にあるパレットからアイテムを選択し、ページ上の適切な位置にドラッグします。

6. ページで、アイテム属性を編集します。

1. 表示名 - アイテム名を入力します。この名前を使用してアイテムの値を取得します。30文字以上のアイテム名はバインド変数構文を使用して参照できません。

2. ラベル - このアイテムのラベルを入力します。HTML、JavaScriptおよびショートカットを含めることができます。置換文字列#CURRENT_ITEM_NAME#を使用して、このラベルに関連付けられたアイテムの名前を取得することもできます。

3. 表示タイプ - 表示タイプを選択します(該当する場合)。「アイテム・タイプについて」を参照してください。

7. 既存のアイテムを編集するには、「アイテム名」および「ラベル」フィールドを編集するか、ページ上部の新しい「表示タイプ」を選択します。

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

9. オプションで、各アイテムの名前およびラベルを編集します。

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

関連項目:
ドラッグ・アンド・ドロップ・レイアウト・ページの使用

静的値リストの作成

静的値リストを作成する方法の1つに、アイテムのLOV定義の編集があります。このタイプのLOVは再使用できないことに注意してください。LOVをいつでも使用可能な共有コンポーネントとして作成することをお薦めします。

関連項目:
「LOVの作成」

静的値リストを作成するには、次のステップを実行します。

1. 該当するページ定義にナビゲートします。「ページ定義へのアクセス」を参照してください。

2. 「アイテム」で、アイテム名を選択します。
「ページ・アイテムの編集」ページが表示されます。

3. 「名前」で、アイテムのレンダリング方法を指定します。「表示形式」リストから選択します。

4. 「LOV」で、静的値リストを次のように作成します。

1. 「名前付きLOV」から、「名前付きLOVの選択」を選択します。

2. 「LOV」定義で、次の構文を使用して定義を入力します。

STATIC[2]:Display Value[;Return Value],Display Value[;Return Value]

説明:

- 最初のキーワードはSTATICまたはSTATIC2になります。
STATICでは、値が表示値のアルファベット順でソートされます。STATIC2では、値がリストに入力された順序で表示されます。

- セミコロンは各エントリで表示値と戻り値を区切ります。

- Return Valueはオプションです。Return Valueが含まれない場合、戻り値は表示値と同じになります。

5. 詳細は、アイテムのヘルプを参照してください。ページ上の特定のアイテムのヘルプを表示するには、アイテム・ラベルをクリックします。
ヘルプが使用できる場合、アイテム・ラベルの上にカーソルを置くとアイテム・ラベルは赤に変わり、カーソルは矢印と疑問符マークに変わります。「フィールドレベル・ヘルプについて」を参照してください。

6. 「変更の適用」をクリックします。
次に例として、3つの異なる静的値リストに対する構文を示します。

例1: アルファベット順で表示される4つの値

この例では、アルファベット順で表示される4つの値(Cow、Dog、Cat、Lion)が値リストにあります。各エントリの戻り値は表示値と同じです。

STATIC:Cow,Dog,Cat,Lion

例2: リストされた順序で表示される10の値

この例では、定義にリストされた順序で表示される10の値が値リストにあります。各エントリの戻り値は表示値と同じです。

STATIC2:10,15,20,25,50,100,200,500,1000,10000

例3: 戻り値および表示値の両方を持つ値リスト

この例では、YesとNoという2つの値が値リストにあります(表示値Yesとその戻り値Y、表示値Noとその戻り値N)。

STATIC:Yes;Y,No;N

チュートリアルを参照:
Oracle Application Expressアドバンスト・チュートリアルの「フォーム・レイアウトの制御方法」

ページ・レベル・アイテムの編集

ページ・アイテム属性を編集するか、または「すべて編集」アイコンか「アイテムの順序変更」アイコンを使用して、ページ・レベル・アイテムを編集できます。

この項に含まれる内容は次のとおりです。

- ページ・アイテム属性の編集

- 「すべて編集」アイコンを使用した複数アイテムの編集

- 「リージョン・アイテムの順序変更」アイコンの使用

関連項目:
ドラッグ・アンド・ドロップ・レイアウト・ページの使用

ページ・アイテム属性の編集

作成したページ・アイテムは、「ページ・アイテムの編集」ページで編集できます。

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

1. 該当するページ定義にナビゲートします。「ページ定義へのアクセス」を参照してください。

2. 「アイテム」で、アイテム名を選択します。
「ページ・アイテムの編集」ページが表示されます。

3. ページ上の特定の属性の詳細を表示するには、属性ラベルをクリックします。
ヘルプが使用できる場合、アイテム・ラベルの上にカーソルを置くとアイテム・ラベルは赤に変わり、カーソルは矢印と疑問符マークに変わります。「フィールドレベル・ヘルプについて」を参照してください。

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

関連項目:
「アイテム属性がページ・レイアウトに与える影響」および「クロスサイト・スクリプティング保護の理解」

ナビゲーションの選択肢について

ページ・アイテムの編集ページは、「名前」、「表示」、「ラベル」、「要素」、「ソース」、「デフォルト」、「LOV」、「セキュリティ」、「条件」、「読取り専用」、「ヘルプ・テキスト」、「構成」および「コメント」のセクションに分かれています。

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

「すべて編集」アイコンを使用した複数アイテムの編集

「ページ定義」の「すべて編集 」アイコンをクリックすると、複数のアイテムを一度に編集できます。「すべて編集」アイコンは、鉛筆が置かれた小さいグリッドの形をしています。

「すべて編集」アイコンをクリックすると、複数のアイテムを同時に編集したり、最近の変更履歴を確認できる一連のページが表示されます。

この項に含まれる内容は次のとおりです。

- ページ・アイテム

- アイテム・ヘルプ

- リージョン・アイテムの再割当て

- 複数のアイテムの削除

- 履歴

関連項目:
「アイテム属性がページ・レイアウトに与える影響」

ページ・アイテム

アイテム属性でページ上のアイテムの表示方法を制御します。ページ・アイテム・ページを使用して順序、フィールド・ラベル、テンプレート、リージョン、およびページ上のすべてのアイテムの全体的な配置を編集できます。

ページ上部にナビゲーション・バーが表示されます。他のページにナビゲートするには、「ページ」フィールドを使用します。表示を特定のリージョンのアイテムのみに限定するには、「リージョンの表示」リストから選択します。

関連項目:
ページ・アイテム属性の編集

ページ・アイテム・ページには、編集可能なレポートのアイテムが表示されます。表6-3はそれぞれの編集可能な属性の説明です。

表 6-3 ページ・アイテム上の編集可能な属性

属性

説明

順序

このコンポーネントの表示順序を指定します。これによって評価の順序が決まります。

プロンプト

HTMLフォーム要素のラベルを入力します。HTML、JavaScriptおよびショートカットを含めることができます。置換文字列#CURRENT_ITEM_NAME#を使用して、このラベルに関連するアイテムの名前を取得することもできます。

フィールド・テンプレート

ラベル・テンプレートを決定します。ラベル・テンプレートを使用すると、中心部のユーザー・インタフェースの属性の定義、および多くのラベル間での定義の共有ができます。

リージョン

アイテムを表示するリージョンを定義します。すべてのアイテムは、リージョンに存在します。

新しい行

前のアイテムと同じ行に表示するかどうか、または次の行に表示するかどうかを決定します。アイテムはHTML表に配置されます。表の新しい行の第1フィールドとしてアイテムを表示する場合は、「はい」を選択します。

幅

このアイテムに対して表示されるフォーム要素の長さを(文字で)指定します。

高さ

テキスト領域および複数の選択リストのための高さを(列で)指定します。

列スパン

アイテムは、HTML表に配置されます。このプロパティは表セルのCOLSPAN属性に使用される値を定義します。

行スパン

アイテムは、HTML表に配置されます。この属性はアイテムを表示する表セルのROWSPAN属性に使用される値を定義します。

該当する属性を編集し、「変更の適用」をクリックします。

アイテム・ヘルプ

アイテム・ヘルプ・ページを使用してページ上のすべてのアイテムのアイテム・ヘルプを編集します。他のアイテムにサブスクライブすると、複数の位置に存在する同じヘルプ・テキストを繰り返す必要がなくなります。

関連項目:
「ヘルプ・ページの作成」

アイテム・ヘルプを編集するには、次のステップを実行します。

1. 該当するページ定義にナビゲートします。「ページ定義へのアクセス」を参照してください。

2. 「アイテム」で、「すべて編集」アイコンをクリックします。

3. 「アイテム・ヘルプ」をクリックします。
アイテム・ヘルプ・ページが表示されます。

ページ上部のナビゲーション・バーを使用して、表示を縮小または拡大します。使用可能なオプションは次のとおりです。

- ページ: 新しい番号を選択または入力して「実行」をクリックします。

- 検索 - 大/小文字を区別しない問合せを入力して「実行」をクリックします。

- 表示:ヘルプ・テキストの表示について 「すべて」、「サブスクライブ」または「サブスクライブされていない」から選択します。

- すべてのページ - アプリケーションのすべてのページ上で検索問合せを実行するために選択します。

- カレント・ページ - 検索問合せを現在のページに対して制限するために選択します。
また、ナビゲーション・バーの矢印を使用してアプリケーション・ページ全体をスクロールできます。

4. 既存のヘルプ・アイテムをサブスクライブするには、「サブスクライブ先」から選択します。

5. 特定のアイテムのヘルプを編集するには、アイテム名をクリックします。
ヘルプの編集ページで、次のステップを実行します。

1. マスター・アイテム・ヘルプの参照元 - 既存のヘルプ・アイテムをサブスクライブ先へ選択します。

2. ヘルプ・テキスト - アイテムのヘルプ・テキストを入力または編集します。

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

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

リージョン・アイテムの再割当て

リージョン・アイテムの再割当てページを使用してアイテムを新しいリージョンに割り当てます。

リージョン・アイテムの再割当てページに移動するには、次のステップを実行します。

1. 該当するページ定義にナビゲートします。「ページ定義へのアクセス」を参照してください。

2. 「アイテム」で、「すべて編集」アイコンをクリックします。

3. 「リージョン・アイテムの再割当て」をクリックします。
リージョン・アイテムの再割当てページが表示されます。

ページ上部のナビゲーション・バーを使用して、表示を縮小または拡大します。使用可能なオプションは次のとおりです。

- ページ: 新しい番号を選択または入力して「実行」をクリックします。

- リージョンの表示 - 表示するリージョンを選択して「実行」をクリックします。

4. アイテムを他のリージョンに再割当てするには、次のステップを実行します。

1. 再割当てするアイテムを選択します。

2. 「リージョンへの割当て」から、新しいリージョンを選択します。

3. 「リージョン・アイテムの再割当て」をクリックします。

複数のアイテムの削除

複数のアイテムの削除ページを使用して複数のアイテムを一度に削除します。

複数のアイテムを削除するには、次のステップを実行します。

1. 該当するページ定義にナビゲートします。「ページ定義へのアクセス」を参照してください。

2. 「アイテム」で、「すべて編集」アイコンをクリックします。

3. 「複数のアイテムの削除」をクリックします。
複数のアイテムの削除ページが表示されます。

ページ上部のナビゲーション・バーを使用して、表示を縮小または拡大します。使用可能なオプションは次のとおりです。

- ページ: 新しい番号を選択または入力して「実行」をクリックします。

- リージョンの表示 - 表示するリージョンを選択して「実行」をクリックします。

- 「次へ」ボタン(>)および「次へ」ボタン(<) - 前または次のページを表示します。

4. アイテムを他のリージョンに再割当てするには、次のステップを実行します。

1. 再割当てするアイテムを選択します。

2. 「リージョンへの割当て」から、新しいリージョンを選択します。

3. 「リージョン・アイテムの再割当て」をクリックします。

履歴

履歴ページを使用してページ・レベル・アイテムに対して行われた最近の編集の概要を表示します。

「リージョン・アイテムの順序変更」アイコンの使用

「リージョン・アイテムの順序変更」アイコンをクリックすると、ラベルやリージョン内のアイテムの位置をすぐに編集できます。このアイコンは明るい緑色の下向きまたは上向きの矢印のような形をしています。

「リージョン・アイテムの順序変更」アイコンを使用するには、次のステップを実行します。

1. 該当するページ定義にナビゲートします。「ページ定義へのアクセス」を参照してください。

2. 「アイテム」で、「リージョン・アイテムの順序変更」アイコンをクリックします。
アイテムが表にレイアウトされたリージョン・アイテムの順序変更ページが表示されます。「新しい行」、「新規フィールド」、「列スパン」および「ラベルの位置合せ」属性の値を選択することで、アイテムの位置を編集できます。アイテムの表示イメージが、ページ下部にグラフィカルに表示されます。

3. アイテム・ラベルを編集するには、「ラベル」フィールドに新しいタイトルを入力します。

4. アイテムの位置を変更するには、次の属性を編集します。

- 新しい行: アイテムを前のアイテムと同じ行に表示するか、次の行に表示するかを決定します。表の新しい行の第一フィールドとしてアイテムを表示する場合は、「はい」を選択します。

- 新規フィールド: アイテムを次の列に表示するか、前のアイテムと同じ列に表示するかを決定します。アイテムのラベルおよび値を新しいHTML表のセルに表示する場合は、「はい」を選択します。レイアウトを制御するには、この属性を「新しい行」および「スパン」属性と組み合せて使用します。

- 列スパン: 表セルのCOLSPAN属性に使用する値を定義します。COLSPAN属性は表全体の列の数を定義します。

5. ラベル位置を変更するには、「ラベルの位置合せ」リストで選択を行います。

6. アイテムが表示される順序を変更するには、一番右側の列で上矢印および下矢印をクリックします。矢印をクリックするとアイテムが1行上または下に移動します。
ここで指定した順序は、ページ・アイテムの編集ページの「順序」属性の順序番号に変換されるので注意してください。「ページ・アイテム属性の編集」を参照してください。

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

ヒント:
ドラッグ・アンド・ドロップ・レイアウト機能を使用してアイテムの順序変更を行うこともできます。「ドラッグ・アンド・ドロップ・レイアウト・ページの使用」を参照してください。

注意:
アイテムが配置されるリージョンを変更するには、アイテム属性を編集する必要があります。「ページ・アイテム属性の編集」を参照してください。

ドラッグ・アンド・ドロップ・レイアウト・ページの使用

ドラッグ・アンド・ドロップ・レイアウト・ページを使用して、指定したリージョン内でのアイテムの順序変更、選択したアイテム属性の変更、アイテムの作成、または既存のアイテムの削除をインタラクティブに行うことができます。

この項に含まれる内容は次のとおりです。

- ドラッグ・アンド・ドロップ・レイアウト・ページへのアクセス

- ドラッグ・アンド・ドロップ・レイアウト・ページについて

- 新しいアイテムの作成

- 既存のアイテムの編集

- アイテムの削除

関連項目:
「ドラッグ・アンド・ドロップを使用した複数のアイテムの作成」

ドラッグ・アンド・ドロップ・レイアウト・ページへのアクセス

次のいずれかの方法でドラッグ・アンド・ドロップ・レイアウト・ページにアクセスします。

- 「ページ定義」の「ドラッグ・アンド・ドロップ」アイコンをクリックします。「「ドラッグ・アンド・ドロップ」アイコンについて」を参照してください。

- 「リージョン・アイテムの順序変更」アイコンをクリックし、「ドラッグ・アンド・ドロップ・レイアウト」タブを選択します。「「ボタンの順序変更」アイコンの使用」を参照してください。

関連項目:
「ページ・アイテムとアプリケーション・アイテムの違い」

ドラッグ・アンド・ドロップ・レイアウト・ページについて

ドラッグ・アンド・ドロップ・レイアウト・ページは、「アイテム」パレットおよび「レイアウト」リージョンの2つのセクションに分かれています。

ページの左側に「アイテム」パレットが表示されます。パレットでアイテム・タイプをクリックし、「レイアウト」リージョンの正しい位置にドラッグしてアイテムを追加します。カーソルをアイテム・タイプの上に置くとツールチップが表示されます。

ページの右側(または「レイアウト」リージョン)を使用してアイテムを配置します。アイテムを縦方向に移動するには、「行の追加」ボタンをクリックして空の行を挿入します。その後、アイテムを空の行にドラッグ・アンド・ドロップします。

関連項目:
「アイテムの削除」

新しいアイテムの作成

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

1. ドラッグ・アンド・ドロップ・レイアウト・ページにナビゲートします。「ドラッグ・アンド・ドロップ・レイアウト・ページへのアクセス」を参照してください。

2. ページの左側にある「アイテム」パレットのアイテム・タイプをクリックして、「レイアウト」リージョンの適切な位置にドラッグします。
カーソルをアイテム・タイプの上に置くとツールチップが表示されます。

3. アイテムの位置を変更するには、次のステップを実行します。

- アイテムを横方向に移動するには、アイテムを選択して、ページの適切な位置にドラッグします。

- 2つの既存の行の間に既存のアイテムまたは新しいアイテムを挿入するには、「行の追加」ボタンをクリックして既存の行の間にドラッグします。これにより、空の行が作成され、アイテムを移動できます。

4. ページで、アイテム属性を編集します。

1. 表示名 - アイテム名を入力します。この名前を使用してアイテムの値を取得します。30文字以上のアイテム名はバインド変数構文を使用して参照できません。

2. ラベル - このアイテムのラベルを入力します。HTML、JavaScriptおよびショートカットを含めることができます。置換文字列#CURRENT_ITEM_NAME#を使用して、このラベルに関連付けられたアイテムの名前を取得することもできます。

3. 表示タイプ - 表示タイプを選択します(該当する場合)。選択リストは、作成するアイテムのタイプに対応するオプションに制限されます。「アイテム・タイプについて」を参照してください。

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

6. オプションで、各アイテムの名前およびラベルを編集します。

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

関連項目:
「ドラッグ・アンド・ドロップを使用した複数のアイテムの作成」および「ページ・アイテム属性の編集」

LOVについて

値リスト(LOV)が必要なアイテムを作成する場合、ドラッグ・アンド・ドロップ・レイアウト・ウィザードでは、静的インラインLOVが作成されます。レイアウト・プロセスが完了後、このLOVを編集および修正する必要があります。

関連項目:
「静的値リストの作成」

既存のアイテムの編集

ドラッグ・アンド・ドロップ・レイアウト・ページに既存のアイテムを編集するには、次のステップを実行します。

1. ドラッグ・アンド・ドロップ・レイアウト・ページにナビゲートします。「ドラッグ・アンド・ドロップ・レイアウト・ページへのアクセス」を参照してください。

2. アイテムの位置を変更するには、次のステップを実行します。

- アイテムを横方向に移動するには、アイテムを選択して、ページの適切な位置にドラッグします。

- 2つの既存の行の間に既存のアイテムまたは新しいアイテムを挿入するには、「行の追加」ボタンをクリックして既存の行の間にドラッグします。これにより、空の行が作成され、アイテムを移動できます。

3. 必要に応じて、アイテムを選択してページのアイテムの属性を編集します。

1. 表示名 - アイテム名を入力します。この名前を使用してアイテムの値を取得します。30文字以上のアイテム名はバインド変数構文を使用して参照できません。

2. ラベル - このアイテムのラベルを入力します。HTML、JavaScriptおよびショートカットを含めることができます。置換文字列#CURRENT_ITEM_NAME#を使用して、このラベルに関連付けられたアイテムの名前を取得することもできます。

3. 表示タイプ - 表示タイプを選択します(該当する場合)。選択リストは、作成するアイテムのタイプに対応するオプションに制限されます。「アイテム・タイプについて」を参照してください。「アイテム・タイプについて」を参照してください。

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

5. オプションで、各アイテムの名前およびラベルを編集します。

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

注意:
アイテムが配置されるリージョンを変更するには、アイテム属性を編集する必要があります。「ページ・アイテム属性の編集」を参照してください。

アイテムの削除

アイテムを削除するには、アイテムをクリックし、ページ下部のごみ箱にドラッグします。既存のアイテムを削除する場合、次のページの「変更の適用」をクリックするまでごみ箱に表示され取得可能です。ごみ箱に作成したばかりの新しいアイテムを削除する場合は、即時に消去され、取得はできません。

アイテム値の参照

リージョン、計算、プロセス、検証およびブランチのセッション・ステートに格納されたアイテム値を参照できます。表 6-4に、アイテム値を参照するためにサポートされている構文を示します。

関連項目:
「セッション・ステート値の管理」

表6-4 アイテム値を参照するための構文

タイプ

構文

説明

SQL

:MY_ITEM

名前が30バイト以下のアイテム用の標準のバインド変数構文。この構文は、SQL問合せおよびPL/SQL内の参照用に使用します。

PL/SQL

V('MY_ITEM')

Vファンクションを使用してアイテム値を参照するPL/SQL構文。

関連項目: Oracle Application Express APIリファレンス

PL/SQL

NV('MY_NUMERIC_ITEM')

NVファンクションを使用して数値アイテム値を参照する標準のPL/SQL構文。

関連項目: Oracle Application Express APIリファレンス

静的テキスト

&MY_ITEM

静的テキスト。

静的テキスト(完全置換)

&MY_ITEM.

静的テキスト。完全置換です。

次のいずれかの方法を使用すると、アプリケーションのアイテム値を設定できます。

- ページ・レベル・アイテムの場合、ソース属性を使用してアイテム値を設定します。
「ページ定義」で、アイテム名を選択して「ページ・アイテムの編集」ページを表示します。「ソース」までスクロールして、該当するフィールドを編集します。

次の構文を使用して、PL/SQLまたはプロセスに基づく任意のリージョンのアイテム値を設定することもできます。

BEGIN
:MY_ITEM :=  'new value';
END;

- f?p構文を使用してURL参照の値を渡します。次に例を示します。

f?p=100:101:10636547268728380919::NO::MY_ITEM:ABC

- 計算を使用して値を設定します。計算は、アイテム値を設定するように設計されています。次に例を示します。

TO_CHAR(SYSDATE,'Day DD Month, YYYY');

- PL/SQL APIを使用して、PL/SQLコンテキストにアイテム値を設定します。次に例を示します。

APEX_UTIL.SET_SESSION_STATE('MY_ITEM',SYSDATE);

関連項目:
「セッション・ステートのクリア」、Oracle Application Express APIリファレンスおよび「クロスサイト・スクリプティング保護の理解」

条件付きページ・アイテムまたは読取り専用ページ・アイテムの表示

「ページ・アイテムの編集」ページで属性を編集することによって、アイテムを条件付きまたは読取り専用で表示できます。

アイテムを条件付きまたは読取り専用で表示にするには、次のステップを実行します。

1. アイテムを作成します。「ページ・レベル・アイテムの作成」を参照してください。

2. 該当するページ定義にナビゲートします。「ページ定義へのアクセス」を参照してください。

3. 「アイテム」で、アイテム名を選択します。
「ページ・アイテムの編集」ページが表示されます。

4. アイテムを条件付きで表示するには、次のステップを実行します。

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

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

3. 表示されるフィールドに式を入力します。

5. アイテムを読取り専用にするには、次のステップを実行します。

1. 「読取り専用の表示設定」までスクロールします。

2. 「読取り専用条件タイプ」リストから選択します。

3. 表示されるフィールドに式を入力します。

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

複数選択リスト・アイテムでの操作

複数選択アイテムは複数選択リストのフォーム要素としてレンダリングされ、複数選択リストまたはシャトル・アイテム・タイプのいずれかになります。送信されると、選択した値は単一のコロンで区切られた文字列に戻されます。このフォーマットの値は2通りの方法で処理できます。

- INSTRファンクションの使用

- APEX_UTIL.STRING_TO_TABLEファンクションの使用

APEX_UTIL.STRING_TO_TABLEを使用した選択値の変換

たとえば、部門の複数選択リストから選択した部門によって限定されているEMP表およびDEPT表に関するレポートがあるとします。まず、次の問合せを使用して、複数選択アイテム「P1_DEPTNO」を作成します。

SELECT dname, deptno
FROM dept

次に、次のように入力して、選択した部門内の従業員のみを戻します。

SELECT ename, job, sal, comm, dname
FROM emp e, dept d
WHERE d.deptno = e.deptno
AND instr(':'||:P1_DEPTNO||':',':'||e.deptno||':') > 0

次に、複数選択アイテム「P1_DEPTNO」で選択した値をプログラムで処理するとします。これを行うには、APEX_UTIL.STRING_TO_TABLEファンクションを使用して、コロンで区切られた文字列をPL/SQL配列に変換します。次の例では、選択した部門を問合せの日付が含まれている監査表に挿入する方法を示します。

DECLARE
l_selected APEX_APPLICATION_GLOBAL.VC_ARR2;
BEGIN
--
-- Convert the colon separated string of values into
-- a PL/SQL array

l_selected := APEX_UTIL.STRING_TO_TABLE(:P1_DEPTNO);

--
-- Loop over array to insert department numbers and sysdate
--

FOR i IN 1..l_selected.count
LOOP
INSERT INTO report_audit_table (report_date, selected_department)
VALUES (sysdate, l_selected(i));
END LOOP;
END;

関連項目:
Oracle Application Express APIリファレンスの「STRING_TO_TABLEファンクション」

アプリケーション・レベル・アイテムの理解

アプリケーション・レベル・アイテムは表示されませんが、アプリケーションのグローバル変数として使用されます。アプリケーション・アイテムは、グローバル変数として使用できます。

この項に含まれる内容は次のとおりです。

- アプリケーション・レベル・アイテムの作成

- アプリケーション・アイテム履歴へのアクセス

- アプリケーション・レベル・アイテム属性の編集

関連項目:
「ページ・アイテムとアプリケーション・アイテムの違い」および「アイテム値の参照」

アプリケーション・レベル・アイテムの作成

アプリケーション・レベル・アイテムを作成するには、次のステップを実行します。

1. 「ワークスペース」ホームページにナビゲートします。

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

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

4. アプリケーション・ビルダーが表示されたら、「共有コンポーネント」をクリックします。

5. 「ロジック」で、「アプリケーション・アイテム」を選択します。
アプリケーション・アイテム・ページが表示されます。

6. アプリケーション・アイテムを作成するには、「作成」をクリックします。

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

「アプリケーション・アイテム」ページ

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

- アイコン(デフォルト): 各アプリケーション・アイテムを大きいアイコンとして表示します。アプリケーション・アイテムを編集するには、該当するアイコンをクリックします。

- 詳細: 各アプリケーション・アイテムをレポートで1行に表示します。アプリケーション・アイテムを編集するには、名前をクリックします。

アプリケーション・アイテム履歴へのアクセス

アプリケーション・アイテム・ページの上部で「履歴」をクリックすると、アプリケーション・アイテムへの変更履歴を表示できます。

アプリケーション・レベル・アイテム属性の編集

作成したアプリケーション・レベル・アイテムは、アプリケーション・アイテムの作成/編集ページで編集できます。

アプリケーション・レベル・アイテム属性を編集するには、次のステップを実行します。

1. 「ワークスペース」ホームページにナビゲートします。

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

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

4. アプリケーション・ビルダーが表示されたら、「共有コンポーネント」をクリックします。

5. 「ロジック」で、「アプリケーション・アイテム」を選択します。
アプリケーション・アイテム・ページが表示されます。

6. アプリケーション・アイテムを選択します。
アプリケーション・アイテムの作成/編集ページが表示されます。

7. ページ上の特定のアイテムの詳細を表示するには、アイテム・ラベルをクリックします。
ヘルプが利用できる場合は、アイテム・ラベル上にカーソルを重ねると、アイテム・ラベルが赤色に変わり、カーソルが矢印と疑問符に変わります。「フィールドレベル・ヘルプについて」を参照してください。

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

関連項目:
「クロスサイト・スクリプティング保護の理解」

ナビゲーションの選択肢について

アプリケーション・アイテムの作成/編集ページは、「名前」、「セキュリティ」、「構成」および「コメント」などのセクションに分かれています。

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

7 アプリケーション・コンポーネントの追加

このセクションでは、アプリケーション・ビルダーを使用してアプリケーションにページを追加する方法およびコンポーネント(レポート、チャートまたはフォーム)、ページ・コントロール(ボタン、アイテムまたはLOV)、共有コンポーネント(ブレッドクラム、リストまたはタブ)を追加する方法について説明します。

この項には、次の項目が含まれます。

- レポートの作成

- フォームの作成

- カレンダの作成

- チャートの作成

- ボタンの作成

- LOVの作成

- 依存選択リストの作成

- ショートカットの使用

- 「検索」アイコンの使用

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

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

- 印刷用ページの最適化

- ヘルプ・ページの作成

関連項目:
「アプリケーション・ビルダーの使用」、「ページ・レイアウトの制御」および「ナビゲーションの追加」

レポートの作成

Oracle Application Expressでは、レポートとは、SQL問合せの結果の書式を設定したものです。レポートの生成は、組込み問合せを選択して実行するか、またはSQL問合せに基づくレポート・リージョンを定義して行うことができます。

この項に含まれる内容は次のとおりです。

- ウィザードを使用したレポートの作成

- 対話モード・レポートの使用

- 対話モード・レポートの編集

- SQLレポートおよびウィザード・レポートの編集

- レポート・リージョンの出力

ウィザードを使用したレポートの作成

Application Builderには、レポートを生成するための多くの組込みウィザードが含まれています。

ウィザードを使用してレポートを作成するには、次のステップを実行します。

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

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

3. 「ページの作成」をクリックして、「次へ」をクリックします。

4. 「レポート」を選択します。

5. レポート・タイプを選択して、「次へ」をクリックします。

- SQLレポート - カスタムSQL SELECT文または指定したSQL SELECT文を戻すPL/SQLファンクションに基づいてレポートを作成します。SQL問合せの記述が不明な場合は、「クエリー・ビルダー」ボタンをクリックします。

- 対話モード・レポート - 指定するカスタムSQL SELECT文に基づいた対話モード・レポートを作成します。SQL問合せの記述が不明な場合は、「クエリー・ビルダー」ボタンをクリックします。エンド・ユーザーは、「アクション」メニューのオプションを選択することによって、レポートのレイアウトと表示されるデータをカスタマイズできます。

- Webサービスの結果のレポート - Webサービスの結果に基づいてレポートを作成します。詳細は、「Webサービスの実装」を参照してください。

- ウィザード・レポート - SQLの知識がなくてもクラシック・レポートを作成できます。適切なスキーマ、表、列および結果セット表示を選択します。

6. 画面に表示されるステップに従います。特定のフィールドの詳細を表示するには、アイテム・ラベルをクリックします。
ヘルプが利用できる場合は、アイテム・ラベル上にカーソルを重ねると、アイテム・ラベルが赤色に変わり、カーソルが矢印と疑問符に変わります。「フィールドレベル・ヘルプについて」を参照してください。

チュートリアルを参照:
Oracle Application Expressアドバンスト・チュートリアルの「ドリルダウン・レポートの作成方法」、「パラメータ化レポートの作成方法」

対話モード・レポートとクラシック・レポートの相違点

Oracle Application Expressには、主に2つのレポート・タイプ(対話モード・レポートとクラシック・レポート)があります。これら2つのレポート・タイプの主な違いは、対話モード・レポートを使用すると、検索、フィルタ処理、ソート、列選択、ハイライトなどのデータ操作を行うことで、データの表示をカスタマイズできます。

次に、対話モード・レポートの例を示します。

対話モード・レポートの各行の最初の列には、「検索バー」と「列ヘッダー」メニュー・リンク、および「リンク列」アイコンがあります。これらのコンポーネントの詳細は、「対話モード・レポートの使用」を参照してください。

反対に、クラシック・レポートには、これらのカスタマイズ機能は含まれていません。次に、同じデータで構築したクラシック・レポートの例を示します。

クラシック・レポートには、検索バーや、各列の上部のリンクは含まれておらず、基本的なソートのみがサポートされます。

関連項目:
「対話モード・レポートの編集」および「SQLレポートおよびウィザード・レポートの編集」

対話モード・レポートの使用

対話モード・レポートには、ユーザーがレポート・データのレイアウトを変更できるコンポーネントが含まれています。ユーザーは、列の選択、フィルタの作成、ハイライトの適用、列のソート、ブレーク・グループの定義、列の集計、チャートの作成、および計算の定義を実行できます。カスタマイズ後に、対話モード・レポートを名前付きレポートとして保存し、様々なファイル形式でデータをダウンロードできます。

関連項目:
「対話モード・レポートの編集」

この項に含まれる内容は次のとおりです。

- 検索バーについて

- リンク列アイコンについて

- 「アクション」メニューについて

- 表示する列の選択

- フィルタの追加

- 列およびソート順序の選択

- コントロール・ブレークの作成

- ハイライトの追加

- 列の計算

- 列の集計

- チャートの作成

- フラッシュバック問合せの実行

- レポートの保存

- レポートのリセット

- レポートのダウンロード

検索バーについて

検索バーは各対話モード・レポートの上部に表示され、次の機能があります。

- 「列の検索」アイコン: 虫めがねに似ています。このアイコンをクリックして、検索を特定の列のみに絞ります。すべての列を検索するには、「すべての列」を選択します。

- テキスト領域 - 大/小文字を区別しない検索基準(ワイルド・カード文字は暗黙的に定義される)を入力し、「実行」をクリックします。

- 行 - 1ページに表示する行数を選択します。

- 「実行」ボタン: 検索を実行します。

- アクション・メニュー: アクション・メニューを表示します。「「アクション」メニューについて」を参照してください。

関連項目:
「対話モード・レポートにおける検索バーの削除またはカスタマイズ」

特定の列の検索

「列の検索」アイコン(虫めがねに似ている)をクリックすると、現在のレポートのすべての列のリストが表示されます。

「列の検索」アイコンを使用するには、次のステップを実行します。

1. 「列の検索」アイコンをクリックして、列を選択します。
「列の検索」アイコンの右に列名が表示されます。

2. テキスト領域にキーワードを入力して、「実行」をクリックします。

レポートの上部の「レポート設定」領域にフィルタPerson Role contains 'manager'が追加されたことに注意してください。

3. フィルタを無効にするには、「フィルタの有効化/無効化」チェック・ボックスを選択します。

4. フィルタを削除するには、「フィルタの削除」アイコンをクリックします。

関連項目:
「表示する列の選択」

フィルタの編集

既存のフィルタを編集するには、次のステップを実行します。

1. フィルタ名をクリックします。
フィルタが表示されます。

2. 「列」、「演算子」および「式」フィールドを編集します。

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

リンク列アイコンについて

リンク列アイコンは、対話モード・レポートの各行の左側に表示されます。リンク列は、単一行ビュー(カスタム・ターゲット)にリンクしたり、レポートから実行することができます。この対話モード・レポート属性のカスタマイズの詳細は、「リンク列の理解」および「対話モード・レポートでの列リンクの作成」を参照してください。

「アクション」メニューについて

「アクション」メニューは、検索バーの「実行」ボタンの右に表示されます。このメニューを使用して、対話モード・レポートをカスタマイズします。

「アクション」メニューには、次のオプションがあります。

- 「列の選択」は、表示する列と順序を指定します。「表示する列の選択」を参照してください。

- 「フィルタ」は、問合せでWHERE句を追加または編集することで、レポートの焦点を絞ります。「フィルタの追加」を参照してください。

- 「ソート」は、ソートする列とソート順序(昇順または降順)を指定します。「列およびソート順序の選択」を参照してください。

- 「コントロール・ブレーク」は、1つ以上の列にブレーク・グループを作成します。「コントロール・ブレークの作成」を参照してください。

- 「ハイライト」は、フィルタ基準を満たす行をハイライトするフィルタを定義します。「ハイライトの追加」を参照してください。

- 「計算」を使用すると、計算した列をレポートに追加できます。「列の計算」を参照してください。

- 「集計」を使用すると、列に対して算術計算を実行できます。「列の集計」を参照してください。

- 「チャート」は、レポート・データをチャートとして表示します。「チャートの作成」を参照してください。

- 「フラッシュバック」を使用すると、フラッシュバック問合せを実行して、データを過去のある時点の状態で表示することができます。「フラッシュバック問合せの実行」を参照してください。

- 「レポートの保存」は、カスタマイズされた現行のレポート設定を、後で使用できるように保存します。「レポートの保存」を参照してください。

- 「リセット」を使用すると、レポートをデフォルトのレポート設定にリセットできます。「レポートのリセット」を参照してください。

- 「ヘルプ」は、対話モード・レポートのコンポーネントを使用してレポートをカスタマイズする方法の詳細を示します。

- 「ダウンロード」を使用すると、レポートをダウンロードできます。使用可能なダウンロード形式は、ご使用のインストールとレポート定義によって異なります。「レポートのダウンロード」を参照してください。

表示する列の選択

レポートをカスタマイズして特定の列を含めるには、「アクション」メニューで「列の選択」を選択します。

「列の選択」オプションを使用するには、次のステップを実行します。

1. 「アクション」メニューをクリックし、「列の選択」を選択します。
「列の選択」リージョンが表示されます。

2. 移動する列を選択します。リージョンの中央にある矢印をクリックして、「レポートに表示」ボックスから「レポートに表示しない」ボックスに移動します。複数の列を同時に選択する場合は、[CTRL]キーを押したままにします。

3. 列の順序を変更するには、右側で一番上、上、下および一番下に対応する矢印をクリックします。

4. 「適用」をクリックします。
変更されたレポートが表示されます。

関連項目:
「レポートのリセット」

フィルタの追加

「アクション」メニューで「フィルタ」を選択し、レポートの焦点を絞るフィルタを作成できます。このオプションを有効にすると、問合せのWHERE句を追加または変更できます。

フィルタを追加する手順は、次のとおりです。

1. 「アクション」メニューをクリックし、「フィルタ」を選択します。
「フィルタ」リージョンが表示されます。

2. 列、演算子および式を選択します。

前述の例では、フィルタによって「Person Role」が「Lead」であるすべての人物が表示されます。

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

レポートの上部の「レポート設定」領域にフィルタPerson Role contains 'Lead'が追加されたことに注意してください。

4. フィルタを変更するには、次のステップを実行します。

1. フィルタ名(この例では、Person Role contains 'Lead')をクリックします。

2. 選択内容を編集して、「適用」をクリックします。

5. フィルタを無効にするには、「フィルタの有効化/無効化」チェック・ボックスを選択します。

6. フィルタを削除するには、「フィルタの削除」をクリックします。

列およびソート順序の選択

「アクション」メニューで「ソート」を選択して、表示する列とソート順序(昇順または降順)を指定できます。

列ごとにソートするには、次のステップを実行します。

1. 「アクション」メニューをクリックし、「ソート」を選択します。
「ソート」リージョンが表示されます。

2. 列、ソート方向(「昇順」または「降順」)、および「NULLソート」の動作(「デフォルト」、「NULLを常に最後」または「NULLを常に最初」)を選択します。

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

コントロール・ブレークの作成

「アクション」メニューで「コントロール・ブレーク」を選択して、1つ以上の列のブレーク・グループを作成できます。ブレーク・グループを作成すると、対話モード・レポートから列を抽出し、それをマスター・レコードとして表示できます。

ブレーク・グループを作成するには、次のステップを実行します。

1. 「アクション」メニューをクリックし、「コントロール・ブレーク」を選択します。
「コントロール・ブレーク」リージョンが表示されます。

2. 列を選択してから、ステータス(「有効化」または「無効化」)を選択します。

3. 「適用」をクリックします。
レポート上部の「レポート設定」領域に1つ以上のブレーク・グループが表示されます。

4. ブレーク・グループを開くには、プラス記号(+)をクリックします。

5. 「コントロール・ブレーク」フィルタを有効にするには、「フィルタの有効化/無効化」チェック・ボックスを選択します。

6. フィルタを削除するには、「フィルタの削除」をクリックします。

ハイライトの追加

「アクション」メニューで「ハイライト」を選択して、レポート内の特定の行をハイライトするように表示をカスタマイズできます。

ハイライトを作成するには、次のステップを実行します。

1. 「アクション」メニューをクリックし、「ハイライト」を選択します。
「ハイライト」リージョンが表示されます。

2. 次の情報を入力します。

1. 名前 - このフィルタを定義する名前を入力します。

2. 順序 - ルールが評価される順序を示す数値を入力します。

3. ハイライト・タイプ - 「セル」または「行」を選択します。「セル」が選択されると、「ハイライト条件」で参照される列がハイライトされます。

4. バックグラウンド・カラー - ハイライトされる領域のバックグラウンドの新しい色を選択します。

5. テキスト・カラー - ハイライトされる領域のテキストの新しい色を選択します。

6. 列、演算子および式を選択します。

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

レポート上部の「レポート設定」領域に新しいフィルタが表示されることに注意してください。

4. フィルタを変更するには、次のステップを実行します。

1. フィルタ名(この例では、Project Lead)をクリックします。

2. 選択内容を編集して、「適用」をクリックします。

5. フィルタを無効にするには、「フィルタの有効化/無効化」チェック・ボックスを選択します。

6. フィルタを削除するには、「フィルタの削除」をクリックします。

列の計算

「アクション」メニューから「計算」を選択して、列に計算を追加できます。

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

1. 「アクション」メニューをクリックし、「計算」を選択します。
「計算」リージョンが表示されます。

2. 「計算」から、以前に定義した計算を選択するか、または「新規計算」を選択します。

3. 「列ヘッダー」に、新しい列のヘッダーを入力します。

4. 「書式マスク」では、新しい列に適用するOracle書式マスクを選択します。
次に、計算を作成します。「列」、「キーパッド」および「ファンクション」セクションを使用して、計算を作成します。

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

1. 列 - 計算に追加する列名または別名を選択します。

2. キーパッド - 適切なオプションをクリックします。このセクションでは、一般に使用されるキーのショートカットが提供されます。

3. ファンクション - 適切なファンクションを選択します。

6. 「適用」をクリックします。

計算の削除

計算を削除するには、次のステップを実行します。

1. 「アクション」メニューをクリックし、「計算」を選択します。
「計算」リージョンが表示されます。

2. 「計算」から、定義済の計算を選択します。

3. 「削除」をクリックします。

列の集計

「アクション」メニューから「集計」を選択して、列(または集計)に対して算術計算を定義できます。集計は、各コントロール・ブレークの後に、集計が定義されているレポートの末尾の列内に表示されます。

列を集計するには、次のステップを実行します。

1. 「アクション」メニューをクリックし、「集計」を選択します。
「集計」リージョンが表示されます。

2. 「集計」から、以前に定義した集計を選択するか、または「新規集計」を選択します。

3. 「ファンクション」では、「合計」、「平均」、「カウント」、「最小」、「最大」または「メジアン」のいずれかを選択します。

4. 「列」では、列名または別名を選択します。

5. 「適用」をクリックします。
レポートの下部に、計算が表示されます。

この例の集計は、「Order Total」列の総数を示しています。

6. 集計を削除するには、次のステップを実行します。

1. 「アクション」メニューから「集計」を選択します。
「集計」リージョンが表示されます。

集計の削除

集計列を削除するには、次のステップを実行します。

1. 「アクション」メニューをクリックし、「集計」を選択します。
「集計」リージョンが表示されます。

2. 「集計」から、以前に定義した集計を選択します。

3. 「削除」をクリックします。

チャートの作成

チャートを作成するには、「アクション」メニューから「チャート」を選択します。対話モード・レポートごとに1つのチャートを作成できます。定義後は、検索バーのリンクを使用して、チャート・ビューとレポート・ビューを切り替えることができます。

チャートを作成するには、次のステップを実行します。

1. 「アクション」メニューをクリックし、「チャート」を選択します。
「チャート」リージョンが表示されます。

2. 「チャート」リージョンで、次の項目を指定します。

1. チャート・タイプ - 作成するチャートのタイプを選択します。

2. ラベル - ラベルとして使用する列を選択します。

3. ラベルの軸タイトル - 選択された列に関連付けられている軸に表示されるラベルのタイトルを入力します(円グラフには使用できません)。

4. 値 - 値として使用する列を選択します。ファンクションがCOUNTである場合は、「値」を選択する必要はありません。

5. 値の軸タイトル - 選択された列に関連付けられている軸に表示される値のタイトルを入力します(円グラフでは使用できません)。

6. ファンクション - (オプション)選択された列で値に対して実行されるファンクションを選択します。
「チャートの編集」および「チャートの表示」リンクが検索バーの下に表示されます。

3. チャートを変更するには、「チャートの編集」をクリックします。

4. レポートに戻るには、「レポートの表示」をクリックします。

5. チャートを削除するには、「チャートの編集」をクリックしてから「削除」をクリックします。

フラッシュバック問合せの実行

「アクション」メニューから「フラッシュバック」を選択すると、フラッシュバック問合せを実行できます。フラッシュバック問合せを使用すると、データを過去のある時点の状態で表示することができます。フラッシュバック可能なデフォルトの時間は3時間(180分)ですが、実際の時間はデータベースによって異なります。

フラッシュバック問合せを実行するには、次のステップを実行します。

1. 「アクション」メニューをクリックし、「フラッシュバック」を選択します。

2. 「フラッシュバック」リージョンで、時間(分)を入力します。

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

レポートの保存

「アクション」メニューから「レポートの保存」を選択すると、カスタマイズ済のレポートを保存できます。保存するときに、名前付きのレポートまたはデフォルトのレポート設定を選択できます。

ヒント:
カレント・アプリケーションに認証スキームが定義されていない場合、「レポートの保存」オプションは表示されません。「認証によるユーザー・アイデンティティの証明」を参照してください。

対話モード・レポートの保存

対話モード・レポートを保存するには、次のステップを実行します。

1. レポートを実行します。

2. 「アクション」メニューから、「レポートの保存」を選択します。

3. 「レポートの保存」で、次のステップを実行します。

1. 保存 - 「名前付きレポートとして保存」を選択します。

2. 名前- レポートの名前を入力します。

3. 説明- 説明を入力します(オプション)。

4. 「適用」をクリックします。

ヒント:
新しいページに保存される名前付きレポートを保存するには、「詳細属性」の下の「保存したレポートをタブとして表示」を無効にします。「対話モード・レポートの詳細属性の構成」を参照してください。

デフォルトのレポート設定の保存

デフォルトのレポート設定によって、エンド・ユーザーに対するレポートの初期表示が決まります。エンド・ユーザーは、その状態から設定を変更できます。

デフォルトのレポート設定を保存するには、次のステップを実行します。

1. 「アクション」メニューをクリックし、「レポートの保存」を選択します。

2. 「保存」から「デフォルトのレポート設定として保存」を選択します。

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

レポートのリセット

「アクション」メニューから「リセット」を選択すると、レポートをデフォルト設定にリセットできます。レポートをリセットすると、カスタマイズした設定はすべて削除されます。

レポートをリセットするには、次のステップを実行します。

1. 「アクション」メニューをクリックし、「リセット」を選択します。

2. 「適用」をクリックします。

レポートのダウンロード

「アクション」メニューから「ダウンロード」を選択すると、対話モード・レポートをダウンロードできます。使用可能なダウンロード形式はご使用のインストールおよびレポート定義によって異なりますが、カンマ区切りファイル(CSV)形式、Microsoft Excel (XLS)形式、Adobe Portable Document Format (PDF)およびMicrosoft Wordリッチ・テキスト形式(RTF)が含まれることがあります。

レポートをダウンロードするには、次のステップを実行します。

1. 「アクション」メニューをクリックし、「ダウンロード」を選択します。

2. レポートのダウンロード形式を選択し、表示された指示に従います。

関連項目:
「「アクション」メニューへのダウンロード・オプションの追加」

対話モード・レポートの編集

デフォルトでは、対話モード・レポートには、検索バー、「列ヘッダー・メニュー」リンク、および「リンク列」アイコンが含まれます。ユーザーは、これらのコンポーネントを使用して、列の選択、フィルタの適用、ハイライトおよびソートを実行し、レポート・データのレイアウトを変更できます。このセクションでは、開発者がレポート属性を編集して、対話モード・レポートをカスタマイズする方法について説明します。

この項に含まれる内容は次のとおりです。

- 対話モード・レポートの属性ページへのアクセス

- 対話モード・レポートの列属性の編集

- 列グループの作成

- 対話モード・レポートのページ区切りの制御

- 対話モード・レポートの列ソートの管理

- 対話モード・レポートにおける検索バーの削除またはカスタマイズ

- 「アクション」メニューへの「ダウンロード」オプションの追加

- リンク列の理解

- 対話モード・レポートでの列 リンクの作成

- 対話モード・レポートでのLOVとしての列定義

- 対話モード・レポートの詳細属性の構成

- 対話モード・レポートへのリンクの設定

関連項目:
「対話モード・レポートの使用」

対話モード・レポートの属性ページへのアクセス

「ページ定義」で、編集するレポート・リージョンの横にある「対話モード・レポート」リンクをクリックすると、対話モード・レポートの属性ページにアクセスできます。リージョン名をクリックしてから「レポート属性」タブを選択することで、レポート属性ページにナビゲートすることもできます。

「レポート属性」ページを表示するには、次のステップを実行します。

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

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

3. ページを選択します。
ページ定義が表示されます。

4. 「リージョン」で、編集するレポート・リージョンの名前の横にある「対話モード・レポート」をクリックします。
レポート属性ページが表示されます。このページは次のセクションに分かれています。

- 「列属性」はレポート・レイアウトを制御します。「対話モード・レポートの列属性の編集」を参照してください。

- 「列グループ」属性を使用すると、複数列を単一行ビューにまとめることができます。「列グループの作成」を参照してください。

- 「デフォルトのレポート設定」は、エンド・ユーザーに対して表示されるレポートの初期状態を表示します。「デフォルトのレポート設定の保存」を参照してください。

- 「ページ区切り」属性はレポートのページ区切りを制御します。「対話モード・レポートのページ区切りの制御」を参照してください。

- 「ソート」属性を使用すると、値をソートするためレポート見出しに表示するイメージの、イメージおよびイメージ属性を定義できます。「対話モード・レポートでの列ソートの管理」を参照してください。

- 「検索バー」には、対話モード・レポート内に検索バーを定義するための属性が含まれています。「対話モード・レポートの検索バーの削除またはカスタマイズ」を参照してください。

- 「ダウンロード」を使用すると、「アクション」メニューにダウンロード・オプションを追加して、レポートをCSV、XLS、PDFまたはRTFファイルでエクスポートできるようになります。「「アクション」メニューへのダウンロード・オプションの追加」を参照してください。

- 「リンク列」属性を使用すると、列にリンクを追加できます。「対話モード・レポートでの列リンクの作成」を参照してください。

- 「拡張属性」を使用すると、レポート別名を定義したり、保存したレポートのビューをユーザーに送信することができます。また、保存したレポートをタブとして表示することや、実行に一定の時間がかかる問合せの実行の回避、セッション・ステートに設定するアイテムの定義を行うことができます。「対話モード・レポートの詳細属性の構成」を参照してください。

5. 特定の属性の詳細を表示するには、アイテム・ラベルをクリックします。
ヘルプが利用できる場合は、アイテム・ラベル上にカーソルを重ねると、アイテム・ラベルが赤色に変わり、カーソルが矢印と疑問符に変わります。「フィールドレベル・ヘルプについて」を参照してください。

関連項目:
「クラシック・レポートでの列リンクの作成」、「クラシック・レポートでの更新可能な列の定義」、「クラシック・レポートでのLOVとしての列定義」および「クラシック・レポートの列の表示条件の制御」

ナビゲーションの選択肢について

レポート属性ページは、「列属性」、「グループ」、「デフォルト・レポート」、「ページ区切り」、「ソート」、「検索バー」、「ダウンロード」、「リンク列」、「詳細」および「説明」の各セクションに分かれています。

これらのセクションにアクセスするには、ページをスクロール・ダウンするか、ページ上部のナビゲーション・ボタンをクリックします。

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

対話モード・レポートの列属性の編集

レポート属性ページの「列属性」セクションを使用すると、レポート・レイアウトを詳細に制御できます。たとえば、これらの属性を使用して、列ヘッダー・テキストの変更、列の位置の変更、または列の非表示化を行うことができます。

「列属性」にアクセスするには、次のステップを実行します。

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

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

3. ページを選択します。
ページ定義が表示されます。

4. 「リージョン」で、編集するレポート・リージョンの名前の横にある「対話モード・レポート」をクリックします。
ページ上部に「列属性」セクションがある対話モード・レポートの属性ページが表示されます。

「列属性」セクションを使用して、レポート列の外観と機能を制御します。

「ヘッダー」には、レポートに含めるヘッダー・テキストが表示されます。「タイプ」は、問合せ列の型を示します。「リンク」列は、リンク列が現在定義されているかどうかを示します。

表 7-1に、レポート列の基本的な編集操作を示します。

表 7-1 対話モード・レポートのレポート列の基本的な編集操作

説明

開発者の操作

列の表示順序を変更します。

上矢印および下矢印をクリックして、列の表示順序を変更します。

列グループの割当てを変更します。

列グループが定義されている場合、「列グループ」で列を個別に割り当てることができます。

列ヘッダーのテキストを変更します。

「ヘッダー」で、異なるヘッダー・テキストを入力します。

列の表示方法を変更します。

「表示テキスト」からオプションを選択します。

列属性ページで、特定の列の属性をさらに詳細に指定できます。

5. 列属性ページにアクセスするには、該当する列の別名の横にある「編集」アイコンをクリックします。
ソート処理、フィルタ処理、ブレーク制御、集計、および計算やチャートの作成をユーザーが実行できるようにするかどうかは、「ユーザーに許可する操作」で該当するチェック・ボックスを選択して制御できます。

6. 「列の定義」の「ユーザーに許可する操作」で、該当するチェック・ボックスを選択します。
特定の属性の詳細を表示するには、アイテム・ラベルをクリックします。

関連項目:
「クラシック・レポートでの列リンクの作成」、「クラシック・レポートでの更新可能な列の定義」、「クラシック・レポートでのLOVとしての列定義」および「クラシック・レポートの列の表示条件の制御」

列グループの作成

列グループを使用すると、単一行ビューで列をグループ化できます。

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

1. 対話モード・レポートの属性ページにナビゲートします。「対話モード・レポートの属性ページへのアクセス」を参照してください。
「対話モード・レポートの属性」ページが表示されます。

2. 「列グループ」までスクロールします。

3. 「グループの追加」をクリックします。

4. 「列グループ」で、次のステップを実行します。

1. 順序 - この列グループの表示順序を入力します。この属性は、詳細ビューで列グループが表示される順番を決定します。

2. グループ名 - 列グループ名を入力します。この名前は、詳細ビューでリージョン・ヘッダーに表示されます。

3. 説明 - 列グループの説明を入力します(オプション)。この説明は、エンド・ユーザーには表示されません。

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

対話モード・レポートのページ区切りの制御

対話モード・レポートの属性ページの「ページ区切り」属性から選択することによって、ページ区切りの表示方法を制御します。

レポート属性ページの「ページ区切り」セクションにアクセスするには、次のステップを実行します。

1. 対話モード・レポートの属性ページにナビゲートします。「対話モード・レポートの属性ページへのアクセス」を参照してください。
「対話モード・レポートの属性」ページが表示されます。

2. 「ページ区切り」までスクロールします。
「ページ区切り」属性では、ページ区切りスタイルの選択、ページ区切りの表示位置の決定、問合せの最大行数の指定、および最大行数を超える行が戻された場合や1行も戻されなかった場合に表示するメッセージの指定などを行います。表7-2に、使用可能な「ページ区切り」属性を示します。

表7-2 「ページ区切り」属性

属性

説明

ページ区切りタイプ

ページ区切りタイプを選択します。ページ区切りによって、結果セット内の行数および現在の位置に関する情報が提供されます。ページ区切りを表示できるのは、レポートの上または下(あるいは両方)です。位置は左または右に設定できます。ページ区切りの有効なオプションは、次のとおりです。

- XからYの範囲の行

- ZのXからYの範囲の行

ページ区切り表示位置

ページ区切りの表示位置を定義します。ページ区切りは、レポートの左側、右側、上部または下部に表示できます。

NULL値を置き換えて表示

NULL列に表示するテキストを入力します。デフォルト値は(null)です。

行カウント最大値

問合せを行う最大行数を定義します(例: 行1 - 10または456)。

この属性を200に設定すると、結果は次のように表示されます。

rows 1 - 10 of more than 200 rows

この属性はパフォーマンスに影響するので注意してください。より少ない行数をカウントするとパフォーマンスは向上し、数千という行数をカウントするとパフォーマンスは低下します。

最大行数を超える行データでメッセージが見つかったとき

最大行数を超える行が返されたときに表示するテキスト・メッセージを定義します。

データが見つからなかった場合のメッセージ

問合せから行が返されなかったときに表示するテキスト・メッセージを定義します。

対話モード・レポートの列ソートの管理

対話モード・レポートの属性ページで列ソートを管理できます。

列ソートを管理するには、次のステップを実行します。

1. 対話モード・レポートの属性ページにナビゲートします。「対話モード・レポートの属性ページへのアクセス」を参照してください。
「対話モード・レポートの属性」ページが表示されます。

2. 「列属性」で、ソートを有効にする列の「編集」アイコンをクリックします。

3. 「列の定義」で、「ソート」を選択し「変更の適用」をクリックします。
「対話モード・レポートの属性」ページが表示されます。

4. 「ソート」までスクロールします。

5. 昇順イメージ属性および降順イメージ属性を指定するか、または「デフォルトの設定」をクリックします。

対話モード・レポートにおける検索バーの削除またはカスタマイズ

検索バーは、レポートの上に表示されます。

検索バーをレポートから削除するには、次のステップを実行します。

1. 対話モード・レポートの属性ページにナビゲートします。「対話モード・レポートの属性ページへのアクセス」を参照してください。
「対話モード・レポートの属性」ページが表示されます。

2. 「検索バー」までスクロールします。

3. 「検索バーを含める」で、「はい」または「いいえ」を選択します。「いいえ」を選択すると、次のデフォルトのコンポーネントが削除されます。

- 検索フィールド - 検索条件を入力するためのテキスト・フィールドが検索バーに表示されます。

- ファインダ・ドロップ・ダウン - 選択した1列またはすべての列に対してユーザーが検索できるようにします。

- ページごとの行数セレクタ - 選択リストが表示され、1ページ当たりに表示される行数をそのリストから選択できます。

- アクション・メニュー - 選択した「アクション」に基づいてユーザーがレポートをカスタマイズできるようにします。

4. 「アクション・メニュー」をカスタマイズするには、含める「アクション」機能を選択します。

5. 「ボタン・テンプレート」で、検索領域およびダイアログに表示するボタンのテンプレートを選択します。

6. 「ファインダ・イメージ」で、イメージを指定します。イメージが定義されていない場合は、#IMAGE_PREFIX#/htmldb/builder/builder_find.pngが使用されます。

7. 「アクション・メニューのイメージ」で、イメージを指定します。イメージが定義されていない場合は、#IMAGE_PREFIX#/ws/action_dropdown.gifが使用されます。

8. 「検索ボタン・ラベル」で、検索ボタンのラベルとして使用するテキストを入力します。

9. 「ページごとの最大行数」で、検索バーの「ページごとの行数セレクタ」に表示される行の最大数を入力します。

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

「アクション」メニューへの「ダウンロード」オプションの追加

「アクション」メニューに「ダウンロード」オプションを追加すると、ユーザーが対話モード・レポートをカンマ区切りファイル(CSV)形式、Microsoft Excel (XLS)形式、Adobe Portable Document Format (PDF)、およびMicrosoft Wordリッチ・テキスト形式(RTF)としてエクスポートできます。

レポートにダウンロード・リンクを追加するには、CSV出力オプションを有効にする必要があります。

関連項目:
「自動CSVエンコーディング」

「CSV出力の有効化」オプションを有効にするには、次のステップを実行します。

1. 対話モード・レポートの属性ページにナビゲートします。「対話モード・レポートの属性ページへのアクセス」を参照してください。
「対話モード・レポートの属性」ページが表示されます。

2. 「検索バー」までスクロールします。

1. 「検索バーを含める」で、「はい」および「アクション・メニュー」を選択します。

2. 「アクション・メニューに含める」で、「ダウンロード」を選択します。

3. 「ダウンロード」までスクロールします。

4. 「ダウンロード形式」から「CSV - カンマ区切りファイル(CSV)形式」を選択します。

ヒント:
ファイル形式が選択されていない場合、「ダウンロード」オプションは「アクション」メニューに表示されません。

5. 「CSVセパレータ」で、列セパレータを定義します。値が入力されていない場合は、現行のNLS設定に応じて、カンマまたはセミコロンが使用されます。

6. 「CSV囲み文字」にデリミタ文字を入力します。この文字は、データ値の開始境界および終了境界を区切るために使用されます。デフォルトのデリミタは二重引用符(" ")です。

7. 「ファイル名」にダウンロードしたドキュメントの名前を入力します。ファイル拡張子は自動的に追加されるため指定しないでください。空白にすると、リージョン名がファイル名として使用されます。

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

リンク列の理解

対話モード・レポートの左側には、「リンク列」が表示されます。この列は、単一行ビュー(カスタム・ターゲット)にリンクすることができます。また、レポートから除外することもできます。エンド・ユーザーからは、リンク列のソート、非表示、移動はできません。リンク列は、列属性ページに定義されている標準の列リンクとは関係ありません。

単一行ビューへのリンクの設定

単一行ビューにリンクするには、次のステップを実行します。

1. 対話モード・レポートの属性ページにナビゲートします。「対話モード・レポートの属性ページへのアクセス」を参照してください。
「対話モード・レポートの属性」ページが表示されます。

2. 「リンク列」までスクロールします。

3. 「リンク列」で、「単一行ビューへのリンク」を選択します。

4. 「単一行ビュー」で、適切なオプションを選択します。

- NULL値の除外を許可: NULL値の列を除外します。

- 表示列を許可 - レポートに表示されている列のみを表示します。

5. 「一意に行を識別する基準」で、「行ID」または「一意列」を選択します。
「一意列」を選択した場合、「一意列」フィールドに列を指定します。

6. 「リンク・アイコン」で、アイコンを選択します。

7. (オプション)「リンク属性」で、<a href= >タグに含める追加の列リンク属性(リンク・ターゲット、クラス、スタイルなど)を指定します。

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

特定のページへのリンクの設定

特定のページにリンクするには、次のステップを実行します。

1. 対話モード・レポートの属性ページにナビゲートします。「対話モード・レポートの属性ページへのアクセス」を参照してください。
「対話モード・レポートの属性」ページが表示されます。

2. 「リンク列」までスクロールします。

3. 「リンク列」で、「カスタム・ターゲットへのリンク」を選択します。

4. 「リンク・アイコン」で、アイコンを選択します。

5. (オプション)「リンク属性」で、<a href= >タグに含める追加の列リンク属性(リンク・ターゲット、クラス、スタイルなど)を指定します。

6. 「ターゲット」で、「このアプリケーションのページ」を選択します。

7. 「ページ」で、ターゲットのページ番号を選択します。このページのページ区切りをリセットするには、「ページ区切りをリセット」を選択します。

8. 「リクエスト」で、使用するリクエストを指定します。

9. 「キャッシュのクリア」で、キャッシュをクリアするページ(ページ番号)を指定します。ページ番号をカンマで区切ってリストすることによって、複数のページを指定できます。「対話モード・レポートへのリンクの設定」を参照してください。

10. 「名前」および「値」で、特定のアイテムのセッション・ステートを指定します。

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

URLへのリンクの設定

URLにリンクするには、次のステップを実行します。

1. 対話モード・レポートの属性ページにナビゲートします。「対話モード・レポートの属性ページへのアクセス」を参照してください。
「対話モード・レポートの属性」ページが表示されます。

2. 「リンク列」までスクロールします。

3. 「リンク列」で、「カスタム・ターゲットへのリンク」を選択します。

4. 「リンク・アイコン」で、アイコンを選択します。

5. (オプション)「リンク属性」で、<a href= >タグに含める追加の列リンク属性(リンク・ターゲット、クラス、スタイルなど)を指定します。

6. 「ターゲット」から「URL」を選択します。

7. 「URL」で、該当するアドレスを入力します。

8. 「チェックサム」で、次のいずれかを選択します。

- デフォルトを使用

- アプリケーション・レベル - すべてのユーザーが再利用可能なリンク

- ユーザー・レベル - 現行のユーザーが再利用可能なリンク

各オプションの詳細は、アイテムのヘルプを参照してください。

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

列リンクの除外

列リンクを除外するには、次のステップを実行します。

1. 対話モード・レポートの属性ページにナビゲートします。「対話モード・レポートの属性ページへのアクセス」を参照してください。
「対話モード・レポートの属性」ページが表示されます。

2. 「リンク列」までスクロールします。

3. 「リンク列」で、「リンク列の除外」を選択します。

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

対話モード・レポートでの列 リンクの作成

レポートからアプリケーション内の別のページまたはURLへのリンクを作成するには、「列属性」を使用します。

別のページへの列リンクを作成するには、次のステップを実行します。

1. 対話モード・レポートの属性ページにナビゲートします。「対話モード・レポートの属性ページへのアクセス」を参照してください。
「対話モード・レポートの属性」ページが表示されます。

2. 「列属性」で、リンクを含む列を指定します。

3. 列名の横にある「編集」アイコンをクリックします。
列属性ページが表示されます。

4. 「列リンク」までスクロールします。

5. 別のページへの列リンクを作成するには、次のステップを実行します。

1. 「ターゲット」で、「このアプリケーションのページ」を選択します。

2. (オプション)「リンク属性」で、<a href= >タグに含める追加の列リンク属性(リンク・ターゲット、クラス、スタイルなど)を指定します。

3. 「リンク・テキスト」で、リンクとして表示されるテキストを入力するか、イメージ・タグを指定するか、またはデフォルトのイメージのリストから選択します。

4. 「ページ」で、ターゲット・ページ番号を指定します。このページのページ区切りをリセットするには、「ページ区切りをリセット」を選択します。

5. 「リクエスト」で、使用するリクエストを指定します。

6. 「キャッシュのクリア」で、キャッシュをクリアするページ(ページ番号)を指定します。ページ番号をカンマで区切ってリストすることによって、複数のページを指定できます。

7. 特定のアイテムのセッション・ステートを指定するには、「名前」フィールドおよび「値」フィールドを使用します。

8. 「チェックサム」で、次のいずれかを選択します。

- デフォルトを使用

- アプリケーション・レベル - すべてのユーザーが再利用可能なリンク

- ユーザー・レベル - 現行のユーザーが再利用可能なリンク

各オプションの詳細は、アイテムのヘルプを参照してください。

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

URLへの列リンクを作成するには、次のステップを実行します。

1. 対話モード・レポートの属性ページにナビゲートします。「対話モード・レポートの属性ページへのアクセス」を参照してください。
「対話モード・レポートの属性」ページが表示されます。

2. 該当する列の横にある「編集」アイコンをクリックして、列属性ページにアクセスします。
列属性ページが表示されます。

3. 「列リンク」までスクロールします。

4. 「列リンク」で、次を指定します。

1. 「ターゲット」から「URL」を選択します。

2. 「リンク・テキスト」で、リンクとして表示されるテキストを入力し、置換文字列を選択します。

3. (オプション)「リンク属性」で、<a href= >タグに含める追加の列リンク属性(リンク・ターゲット、クラス、スタイルなど)を指定します。

4. 「URL」で、該当するアドレスを入力します。

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

対話モード・レポートでのLOVとしての列定義

対話モード・レポートでは、LOVを使用して組込みフィルタ・ツールの速度を向上できます。

レポート列をLOVとして定義するには、次のステップを実行します。

1. 対話モード・レポートの属性ページにナビゲートします。「対話モード・レポートの属性ページへのアクセス」を参照してください。
「対話モード・レポートの属性」ページが表示されます。

2. 該当する列の横にある「編集」アイコンをクリックして、列属性ページにアクセスします。
列属性ページが表示されます。

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

4. 「列フィルタLOV」で、LOVをレポートの列リストのフィルタとして作成する方法を指定します。使用可能なオプションは次のとおりです。

- なし: LOVのフィルタが無効になります。

- 列タイプに基づくデフォルト - STRINGおよびNUMBERの列では固有の列値からLOVを導出します。DATE列では、事前定義された日付範囲からLOVを導出します。

- 定義済のLOVを使用 - 定義済のLOVのSQL問合せからLOVを導出します。

- LOV定義 - 「定義済のLOVを使用」を選択した場合、固有の列値を選択するSQL問合せを入力します。SQLを入力すると、一部のレポートでパフォーマンスを向上させることができます。このLOVは、ユーザーが列ヘッダーをクリックしたときに表示されます。

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

対話モード・レポートの詳細属性の構成

「詳細属性」セクションを使用して、レポート別名を定義したり、保存したレポートのビューをユーザーに送信することができます。また、保存したレポートをタブとして表示することや、実行に一定の時間がかかる問合せの実行の回避、セッション・ステートに設定するアイテムの定義を行うことができます。

詳細属性を構成するには、次のステップを実行します。

1. 対話モード・レポートの属性ページにナビゲートします。「対話モード・レポートの属性ページへのアクセス」を参照してください。
「対話モード・レポートの属性」ページが表示されます。

2. 詳細属性までスクロールします。
表 7-3に、使用可能な詳細属性を示します。

表7-3 詳細属性

属性

説明

レポート別名

この対話モード・レポートの英数字の別名を入力します。APIコールで対話モード・レポートを参照するときに別名を使用できます(たとえば、表示される列を変更するときなど)。別名はアプリケーション内で一意である必要があります。

レポートIDアイテム

この属性を使用すると、レポートの保存ビューをユーザーに直接送信できます。保存されたビューのレポートIDを保持する値のアイテムを指定します。レポートIDは、APEX_APPLICATION_PAGE_IR_RPTビューから取得できます。

保存したレポートをタブとして表示

レポートの保存済バージョンが存在する場合は、それをタブとして表示するかどうかをこの属性で指定します。レポートのリストが記載されたページを別に作成するには、この属性を無効にします。

送信するページ・アイテム

ユーザーが検索バーの「実行」ボタンをクリックしたときにセッション・ステートに設定されるアイテムのリストをカンマ区切りで入力します。設定されるのは現在のページ上のアイテムのみです。

対話モード・レポートへのリンクの設定

一般にページ・アイテムをレポート・パラメータとして使用するクラシック・レポートとは異なり、対話モード・レポートのデータは、宣言的なフィルタで決まります。しかし、開発者は、エンド・ユーザーに対する対話モード・レポート設定を変更することで、このレポート・パラメータを設定することができます。この設定は、エンド・ユーザーが作業中のレポートのみに影響します。保存済のレポート設定には影響しません。

リンク内の対話モード・レポートをリセットするには、「URL」の「キャッシュのクリア」セクションで文字列"RIR"を使用します。この値は、エンド・ユーザーがターゲット・ページで対話モード・レポートの「アクション」メニューから「リセット」オプションを選択した場合に相当します。レポートは、開発者が指定したか、またはユーザーが保存したデフォルトのレポート設定に戻ります。

対話モード・レポートにRow text containsフィルタを作成するには、URLのItem Namesセクションで文字列IR_ROWFILTERを使用します。この文字列を追加すると、URLのItem Valuesセクションの対応する場所にフィルタ値が渡されます。

リンク内の対話モード・レポートにフィルタを作成するには、URLのItem Namesセクションで文字列IR<operator>_<target column alias>を指定し、URLのItem Valuesセクションの対応する場所にフィルタ値を渡します。

有効な演算子は、次のとおりです。

- EQ = 等しい(これがデフォルトです)

- NEQ = 等しくない

- LT = 未満

- LTE = 以下

- GT = より大きい

- GTE = 以上

- LIKE = SQLのLike演算子

- N = NULL

- NN = NULLではない

- C = 含む

- NC = 含まない

次に例を示します。

f?p=...:IR_ENAME:KING

前述の例は、エンド・ユーザーがターゲット・ページでENAME = KINGというフィルタを作成した場合に相当します。演算子を指定しない場合、デフォルトのEQが使用されることに注意してください。

f?p=...:IRGT_SAL:3000

前述の例は、エンド・ユーザーがターゲット・ページでSAL > 3000というフィルタを作成するのと同じです。

SQLレポートおよびウィザード・レポートの編集

SQLレポートおよびクラシック・レポートのレポート・レイアウト、ページ区切り、列ソート、エラー・メッセージ、エクスポート・リンクおよび列ブレークは、レポート属性ページを使用して制御できます。

ヒント:
Oracle Application Expressリリース3.1に対話モード・レポートが追加されたため、以前のレポート・タイプはすべてクラッシック・レポートとして扱われます。「対話モード・レポートの編集」を参照してください。

この項に含まれる内容は次のとおりです。

- クラッシック・レポートの属性へのアクセス

- 列属性を使用したクラシック・レポートのレイアウト変更

- クラシック・レポートのページ区切りの制御

- クラシック・レポートでの列ソートの有効化

- クラシック・レポートへのダウンロード・リンクの追加

- クラシック・レポートのCSV出力オプションの有効化

- XMLファイルまたはCSVファイルとしてのクラシック・レポートのエクスポート

- クラシック・レポートでの列リンクの作成

- クラシック・レポートでの更新可能な列の定義

- クラシック・レポートでのLOVとしての列定義

- クラシック・レポートの列の表示条件の制御

- クラシック・レポートでの列ブレークの制御

チュートリアルを参照:
Oracle Application Expressアドバンスト・チュートリアル

クラッシック・レポートの属性へのアクセス

「ページ定義」で、編集するレポート・リージョンの横にある「レポート」リンクをクリックすると、クラシック・レポートのレポート属性ページにアクセスできます。リージョン名をクリックしてから「レポート属性」タブを選択することで、レポート属性ページにナビゲートすることもできます。

「レポート属性」ページを表示するには、次のステップを実行します。

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

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

3. ページを選択します。
ページ定義が表示されます。

4. 「リージョン」で、編集するレポート・リージョンの名前の横にある「レポート」をクリックします。
レポート属性ページが表示されます。このページは次のセクションに分かれています。

- 「列属性」はレポート・レイアウトを制御します。「列属性を使用したクラシック・レポートのレイアウト変更」を参照してください。

- 「レイアウトおよびページ区切り」属性はレポート・ページ区切りを制御します。「クラシック・レポートのページ区切りの制御」を参照してください。

- 「ソート」属性を使用すると、値をソートするためレポート見出しに表示するイメージの、イメージおよびイメージ属性を定義できます。「クラシック・レポートでの列ソートの有効化」を参照してください。

- 「メッセージ」の属性を使用すると、データが見つからない場合、または表示できる以上のデータが見つかった場合に表示されるメッセージを定義できます。

- 「レポートのエクスポート」属性を使用すると、レポートにダウンロード・リンクを追加するか、レポートをXMLファイルまたはCSVファイルとしてエクスポートできます。詳細は、「クラシック・レポートへのダウンロード・リンクの追加」および「XMLファイルまたはCSVファイルとしてのクラシック・レポートのエクスポート」を参照してください。

- 「ブレーク書式」属性を使用すると、出力時に特定の列を繰り返すかどうか、および列をどのようにブレークするかを制御できます。「クラシック・レポートでの列ブレークの制御」を参照してください。

5. 特定の属性の詳細を表示するには、アイテム・ラベルをクリックします。
ヘルプが利用できる場合は、アイテム・ラベル上にカーソルを重ねると、アイテム・ラベルが赤色に変わり、カーソルが矢印と疑問符に変わります。「フィールドレベル・ヘルプについて」を参照してください。

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

関連項目:
「クラシック・レポートでの列リンクの作成」、「クラシック・レポートでの更新可能な列の定義」、「クラシック・レポートでのLOVとしての列定義」および「クラシック・レポートの列の表示条件の制御」

ナビゲーションの選択肢について

レポート属性ページは、「列属性」、「レイアウトおよびページ区切り」、「ソート」、「メッセージ」、「レポートのエクスポート」、「ブレーク書式」および「外部プロセス」の各セクションに分かれています。

これらのセクションにアクセスするには、ページをスクロール・ダウンするか、ページ上部のナビゲーション・ボタンをクリックします。

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

列属性を使用したクラッシック・レポートのレイアウトの変更

レポート属性ページの「列属性」セクションを使用すると、レポート・レイアウトを詳細に制御できます。たとえば、これらの属性を使用して、列ヘッダー・テキストの変更、列の位置の変更、列の非表示化、列の合計の作成、またはソート順序の選択を行うことができます。

「列属性」にアクセスするには、次のステップを実行します。

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

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

3. ページを選択します。
ページ定義が表示されます。

4. 「リージョン」で、編集するレポート・リージョンの名前の横にある「レポート」をクリックします。
ページ上部に「列属性」セクションがあるレポート属性ページが表示されます。

「列属性」セクションを使用して、レポート列の外観と機能を制御します。

「ヘッダー・タイプ」はレポートの見出しの生成方法を指定します。「リンク」列は列リンクが現在定義されているかどうかを示します。「編集」列は列が現在更新可能かどうかを示します。

表 7-4に、レポート列の基本的な編集操作を示します。

表 7-4 クラシック・レポートのレポート列の基本的な編集操作

説明

開発者の操作

列の表示順序を変更します。

上矢印および下矢印をクリックして、列の表示順序を変更します。

ヘッダーの位置合せを変更します。

「列の位置合せ」で、列の位置を選択します。

列ヘッダーのテキストを変更します。

「ヘッダー」で、異なるヘッダー・テキストを入力します。

表示する列を制御します。

「表示」をクリックして、列を表示させるようにします。

一意のソート順序を有効にします。

「ソート」をクリックし、「ソート順序」から順序番号を選択します。

任意の数の列をソート可能にできます。ただし、1つ以上の列にソート順序が定義されている必要があります。

列の合計を有効にします。

「合計」をクリックして、列の合計を有効にします。

列属性ページで、特定の列の属性をさらに詳細に指定できます。

5. 列属性ページにアクセスするには、該当する列の別名の横にある「編集」アイコンをクリックします。
特定の属性の詳細を表示するには、アイテム・ラベルをクリックします。

ヘルプが利用できる場合は、アイテム・ラベル上にカーソルを重ねると、アイテム・ラベルが赤色に変わり、カーソルが矢印と疑問符に変わります。「フィールドレベル・ヘルプについて」を参照してください。

関連項目:
「クラシック・レポートでの列リンクの作成」、「クラシック・レポートでの更新可能な列の定義」、「クラシック・レポートでのLOVとしての列定義」および「クラシック・レポートの列の表示条件の制御」

クラシック・レポートのページ区切りの制御

レポート・ページ区切りを制御する方法を次に示します。

- ページ区切り置換文字列をレポート・テンプレートに含める方法

- 「レポート属性」ページの「レイアウトおよびページ区切り」セクションから選択する方法

レポート属性ページの「レイアウトおよびページ区切り」属性から選択することによって、ページ区切りの表示方法を制御します。

この項に含まれる内容は次のとおりです。

- 「レイアウトおよびページ区切り」属性のアクセスと理解

- クラシック・レポート内での行の後へのページ区切りの挿入

- クラシック・レポート内での行の前へのページ区切りの挿入

「レイアウトおよびページ区切り」属性のアクセスと理解

レポート属性ページの「レイアウトおよびページ区切り」セクションにアクセスするには、次のステップを実行します。

1. レポートを作成します。「ウィザードを使用したレポートの作成」を参照してください。

2. 該当するページ定義にナビゲートします。「ページ定義へのアクセス」を参照してください。

3. 「リージョン」で、適切な「レポート」属性リンクをクリックします。
「レポート属性」ページが表示されます。

4. 「レイアウトおよびページ区切り」までスクロールします。
「レイアウトおよびページ区切り」属性を使用して、ページ区切りスタイルの選択、ページ区切りの発生位置の決定、ページごとに表示される行数の指定を行います。表7-5に、最も一般的に使用される「レイアウトおよびページ区切り」属性を示します。

特定の属性の詳細を表示するには、アイテム・ラベルをクリックします。ヘルプが利用できる場合は、アイテム・ラベル上にカーソルを重ねると、アイテム・ラベルが赤色に変わり、カーソルが矢印と疑問符に変わります。「フィールドレベル・ヘルプについて」を参照してください。

表7-5 「レイアウトおよびページ区切り」属性

属性

説明

レポート・テンプレート

このレポートに適用するテンプレートを指定します。レポート・テンプレートによって、SQL問合せによって戻される1行の結果が制御されます。多数のデフォルトのテンプレートから選択するか、またはカスタム作成のテンプレートを選択できます。

レポート属性の置換

#REPORT_ATTRIBUTES#置換文字列と置き換える値を入力します。#REPORT_ATTRIBUTES#置換文字列は、レポート・テンプレートの「行の前」属性でのみ置換されます。

NULL値を置き換えて表示

NULL列に表示するテキストを入力します。デフォルト値は(null)です。

ページ区切りスキーム

このレポートにページ区切りスキームを指定します。

ページ区切りによって、結果セット内の行数および現在の位置に関する情報が提供されます。また、次のページまたは前のページへのナビゲートに使用するリンクまたはボタンのスタイルも定義されます。

詳細は、この属性のヘルプ情報を参照してください。

部分ページ・リフレッシュの有効化

この属性を有効にすると、結果セットでページ区切りが前後に移動するときレポート・リージョンをリフレッシュします。

表示位置

ページ区切りの表示位置を定義します。

レポートの上にページ区切りを表示する場合は、選択したレポート・テンプレートで、このタイプの表示がサポートされている必要があります。

行数

ページごとに表示する最大行数を定義します。

行数(アイテム)

SQL問合せに対して、ページごとにデフォルトで表示する行数を定義します(アイテムから動的に取得されます)。この属性でアイテムを識別します。

行カウント最大値

問合せを行う最大行数を定義します(例: 456行中の行 1 - 10)。

この属性を200に設定すると、結果は次のように表示されます。

rows 1 - 10 of more than 200 rows

この属性はパフォーマンスに影響するので注意してください。より少ない行数をカウントするとパフォーマンスは向上し、数千という行数をカウントするとパフォーマンスは低下します。

HTMLの削除

HTML式、列リンク、およびCSVファイルとしてエクスポートされたレポート・データに対して、元の列値からHTMLタグを削除するかどうか指定します。

HTMLタグが含まれているデータベースから値を選択すると、それらのタグが列リンクまたはHTML式用に生成されたHTMLと競合する可能性があります。このオプションを有効にすると、列値の実際のデータ部分のみが使用されます。

NULLのソート

ソートされた列ヘッダーを含むレポートの場合、最初または最後にソートするNULL値の列が必要かどうかを指定してください。

参照: 「クラシック・レポートでの列ソートの有効化」

クラッシック・レポート内での行の後へのページ区切りの挿入

レポート内の行の後にページ区切りを挿入するには、次のステップを実行します。

1. レポートを作成します。「ウィザードを使用したレポートの作成」を参照してください。
次に、適切な「レイアウトおよびページ区切り」属性を選択します。

2. レポート属性ページにナビゲートします。

1. ページ定義にナビゲートします。「ページ定義へのアクセス」を参照してください。

2. 「リージョン」で、適切な「レポート」属性リンクをクリックします。
「レポート属性」ページが表示されます。

3. 「レイアウトおよびページ区切り」で、次の項目を選択します。

1. レポート・テンプレート - レポート・テンプレートを選択します(オプション)。

2. ページ区切りスキーム - ページ区切りスキームを選択します。

3. 表示位置 - 表示位置を選択します。

4. 行数 - ページごとに表示する行数を指定します。

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

4. レポート・テンプレートを編集します。

1. ページ定義にナビゲートします。「ページ定義へのアクセス」を参照してください。

2. 「テンプレート」で、レポート・テンプレート名を選択します。

3. 「行の後」属性に#PAGINATION#置換文字列を含めます。

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

5. ページを実行します。

クラッシック・レポート内での行の前へのページ区切りの挿入

レポート内の行の前にページ区切りを挿入するには、次のステップを実行します。

1. レポートを作成します。「ウィザードを使用したレポートの作成」を参照してください。
次に、適切な「レイアウトおよびページ区切り」属性を選択します。

2. レポート属性ページにナビゲートします。

1. ページ定義にナビゲートします。「ページ定義へのアクセス」を参照してください。

2. 「リージョン」で、適切な「レポート」属性リンクをクリックします。
「レポート属性」ページが表示されます。

3. 「レイアウトおよびページ区切り」で、次のステップを実行します。

1. レポート・テンプレート - レポート・テンプレートを選択します(オプション)。

2. ページ区切りスキーム - ページ区切りスキームを選択します。

3. 表示位置 - topという語が使用されている位置を選択します。

4. 行数 - ページごとに表示する行数を指定します。

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

4. レポート・テンプレートを編集します。

1. ページ定義にナビゲートします。「ページ定義へのアクセス」を参照してください。

2. 「テンプレート」で、レポート・テンプレート名を選択します。

3. 「行の前」属性に#TOP_PAGINATION#置換文字列を含めます。

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

5. ページを実行します。

クラシック・レポートでの列ソートの有効化

レポート属性ページで列ソートを有効にできます。

列ソートを有効にするには、次のステップを実行します。

1. レポート属性ページにナビゲートします。詳細は、「SQLレポートおよびウィザード・レポートの編集」を参照してください。

2. 「列属性」で、ソートする列の横にある「ソート」チェック・ボックスを選択します。

3. 「ソート順序」から、順序番号を選択します。
「ソート順序」はオプションです。ただし、ソート可能な列が1列以上ある場合は、定義済のソート順序が1列以上で必要です。

4. 「ソート」までスクロールします。

5. 昇順イメージ属性および降順イメージ属性を指定するか、または「デフォルトの設定」をクリックします。

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

ヒント:
レポートの最初および最後にNULL値を含む列を表示する場合は、列のソートを有効にする必要があります。「NULLのソート」属性の詳細は、「「レイアウトおよびページ区切り」属性のアクセスと理解」を参照してください。

クラシック・レポートへのダウンロード・リンクの追加

レポート内にリンクを作成して、ユーザーがレポートをカンマ区切りファイル(.csv)としてエクスポートできるようにします。CSVリンクをレポートに追加するには、CSV出力オプションを有効にする必要があります。CSV出力オプションを使用する際、レポート・テンプレートは重要ではありません。CSVリンクは、CSVエクスポート置換文字列が定義されていればどのレポート・テンプレートに追加することもできます。

関連項目:
「自動CSVエンコーディング」

クラッシック・レポートでのCSV出力オプションの有効化

「CSV出力の有効化」オプションを使用するには、次のステップを実行します。

1. 該当するレポート属性ページにナビゲートします。詳細は、「SQLレポートおよびウィザード・レポートの編集」を参照してください。

2. 「レポートのエクスポート」までスクロールします。

3. 「CSV出力の有効化」から、「はい」を選択します。

4. (オプション)「セパレータ」および「囲み文字」フィールドで、セパレータおよびデリミタを定義します。
デフォルトの囲み文字は、二重引用符(" ")です。デフォルトのデリミタは、カンマまたはセミコロンで、現在のNLS設定によって異なります。

5. 「リンク・ラベル」フィールドで、リンク・テキストを入力します。このテキストは、レポートに表示されます。このテキストを使用すると、ダウンロードを起動できます。

6. (オプション)デフォルトのエクスポート・ファイル名を指定するには、「ファイル名」フィールドに名前を入力します。
デフォルトでは、Application Expressエンジンによって、リージョン名が取得され、該当するファイル名の拡張子(.csvまたは.xml)が追加されて、エクスポート・ファイル名が作成されます。

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

XMLファイルまたはCSVファイルとしてのクラッシック・レポートのエクスポート

レポート・テンプレートを選択して、レポートをXMLファイルとしてエクスポートできます。

レポートをファイルとしてエクスポートするには、次のステップを実行します。

1. 該当するレポート属性ページにナビゲートします。詳細は、「SQLレポートおよびウィザード・レポートの編集」を参照してください。

2. 「レイアウトおよびページ区切り」までスクロールします。

3. 「レポート・テンプレート」リストから、「エクスポート: XML」または「エクスポート: CSV」を選択します。
「エクスポート: XML」を選択すると、Application Expressエンジンでページがレンダリングされなくなり、コンテンツがXMLファイルにダンプされます。

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

クラシック・レポートでの列リンクの作成

レポートからアプリケーション内の別のページまたはURLへのリンクを作成するには、「列リンク」属性を使用します。

別のページへの列リンクを作成するには、次のステップを実行します。

1. 該当するレポート属性ページにナビゲートします。詳細は、「SQLレポートおよびウィザード・レポートの編集」を参照してください。

2. 「列属性」で、リンクを含む列を指定します。

3. 列名の横にある「編集」アイコンをクリックします。
列属性ページが表示されます。

4. 「列リンク」までスクロールします。

5. 別のページへの列リンクを作成するには、次のステップを実行します。

1. 「ターゲット」で、「このアプリケーションのページ」を選択します。

2. (オプション)「リンク属性」で、<a href= >タグに含める追加の列リンク属性(リンク・ターゲット、クラス、スタイルなど)を指定します。

3. 「リンク・テキスト」で、リンクとして表示されるテキストを入力するか、イメージ・タグを指定するか、またはデフォルトのイメージのリストから選択します。

4. 「ページ」で、ターゲット・ページ番号を指定します。このページのページ区切りをリセットするには、「ページ区切りをリセット」を選択します。

5. 「リクエスト」で、使用するリクエストを指定します。

6. 「キャッシュのクリア」で、キャッシュをクリアするページ(ページ番号)を指定します。ページ番号をカンマで区切ってリストすることによって、複数のページを指定できます。「対話モード・レポートへのリンクの設定」を参照してください。

7. 特定のアイテムのセッション・ステートを指定するには、「名前」フィールドおよび「値」フィールドを使用します。

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

URLへの列リンクを作成するには、次のステップを実行します。

1. 該当するレポート属性ページにナビゲートします。詳細は、「SQLレポートおよびウィザード・レポートの編集」を参照してください。

2. 該当する列の横にある「編集」アイコンをクリックして、列属性ページにアクセスします。
列属性ページが表示されます。

3. 「列リンク」までスクロールします。

4. 「列リンク」で、次を指定します。

1. 「ターゲット」から「URL」を選択します。

2. 「リンク・テキスト」で、リンクとして表示されるテキストを入力し、置換文字列を選択します。

3. (オプション)「リンク属性」で、<a href= >タグに含める追加の列リンク属性(リンク・ターゲット、クラス、スタイルなど)を指定します。

4. 「URL」で、該当するアドレスを入力します。

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

クラシック・レポートでの更新可能な列の定義

列属性ページの「表形式フォームの要素」属性を編集することで更新可能な列を作成できます。Application Expressエンジンは、次の場合にのみ更新を実行できることに注意してください。

- 複数行の更新が定義されている場合

- 更新済データを処理するためにPL/SQLプロセスが実装されている場合

- 組込み表形式フォームの要素および表示タイプを使用している場合、レポートは、SQL問合せ(更新可能レポート)のタイプを使用して定義する必要があります。

更新可能な列属性を定義するには、次のステップを実行します。

1. 該当するレポート属性ページにナビゲートします。詳細は、「SQLレポートおよびウィザード・レポートの編集」を参照してください。

2. 該当する列の横にある「編集」アイコンをクリックして、列属性ページにアクセスします。
列属性ページが表示されます。

3. 「表形式フォームの要素」までスクロールします。

4. 「表形式フォームの要素」で、次を指定します。

1. 表示形式 - 更新可能な列の型を選択します。
列を更新可能にするには、このオプションを使用します。更新は、複数行の更新が定義されている場合、または更新済データを処理するためにPL/SQLプロセスが実装されている場合にのみ実行できます。

2. 日付ピッカーの書式マスク - 「日付ピッカー」の「表示形式」タイプを選択している場合は選択を行います。

3. 要素の幅 - フォーム・アイテムの幅を指定します。

4. 行数 - テキスト領域に適応するフォーム・アイテムの高さを指定します。

5. 要素属性 - スタイルまたは標準のフォーム要素属性を定義します。

6. 要素オプションの属性 - ラジオ・グループまたはチェック・ボックス内のアイテムのフォーム要素属性を指定します。

7. 主キーのソース・タイプ - デフォルトのタイプを指定します。

8. 主キーのソース - デフォルトのソースを指定します。
現在の列がMRUプロセスで定義された主キーの一部である場合は、主キーのソース・タイプおよびソースのみが表示されます。

それ以外の場合は、デフォルト値およびデフォルト・タイプが表示されます。デフォルト値およびデフォルト・タイプを使用して、マスター・ディテール・フォーム内の2つのマスター・レコード間の関係を確立するか、または新しい行にデフォルト値を設定します。

9. 参照表の所有者 - 参照される表の所有者を指定します。この属性を使用して、レポートの「ユーザー・インタフェースのデフォルト値」を作成します。

10. 参照表名 - 現行のレポート列が含まれる表またはビューを指定します。

11. 参照列名 - このレポート列が参照する列名を指定します。

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

クラシック・レポートでのLOVとしての列定義

レポート列は、LOVとしてレンダリングできます。たとえば、選択リストまたはポップアップLOVを使用して列をレンダリングできます。または、LOVに基づく読取り専用テキストとして列をレンダリングすることもできます。

この最後の方法は、表示参照値を作成する場合に効果的な手法であり、特に、更新できない通常のレポートで役立ちます。この方法を使用すると、SQL JOIN文を記述することなく、列の値を表示できます。

LOVとしてレポート列をレンダリングするには、次のステップを実行します。

1. 該当するレポート属性ページにナビゲートします。詳細は、「SQLレポートおよびウィザード・レポートの編集」を参照してください。

2. 該当する列の横にある「編集」アイコンをクリックして、列属性ページにアクセスします。
列属性ページが表示されます。

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

4. 「名前付きLOV」で、LOVリポジトリから選択します。詳細は、「LOVの作成」を参照してください。

5. LOVにNULL値を含めるには、次のステップを実行します。

1. 「NULLの表示」で、「はい」を選択します。

2. 「NULLテキスト」で、表示する値を指定します。

また、列には、LOVで表示されない値を格納することもできます。

6. LOVで表示されない値を定義するには、次のステップを実行します。

1. 「追加値の表示」で、「はい」を選択します。
追加値は、実際の列値がLOVの一部ではない場合に使用されます。このような場合は、実際の値が表示されます。追加値を表示しない場合は、誤った値になる可能性があり、データが不適切に自動更新されます。

2. 「NULL値」で、表示する値を指定します。

3. 名前付きLOVを選択していない場合は、「LOV問合せ」フィールドに選択リストを表示するための問合せを入力します。

7. 名前付きLOVを選択していない場合は、LOV問合せで選択リストを表示するための問合せを入力します。

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

チュートリアルを参照:
Oracle Application Expressアドバンスト・チュートリアルの「表形式フォームの作成方法」

クラシック・レポートの列の表示条件の制御

「認可」属性および「条件」属性を使用すると、列の表示条件を制御できます。

認可を使用すると、事前定義されたユーザー権限に基づいて(レポート列などの)リソースへのアクセスを制御できます。たとえば、マネージャのみが特定のレポート列を表示できる認可スキームを作成できます。認可スキームを選択するには、まずその認可スキームを作成する必要があります。

条件とは、事前定義された条件タイプに基づいた列の表示の制御を可能にする論理単位です。条件は、「式」フィールドに入力した値に基づいて、trueまたはfalseと評価されます。

認可属性および条件属性を指定するには、次のステップを実行します。

1. 該当するレポート属性ページにナビゲートします。詳細は、「SQLレポートおよびウィザード・レポートの編集」を参照してください。

2. 該当する列の横にある「編集」アイコンをクリックして、列属性ページにアクセスします。
列属性ページが表示されます。

3. 「認可」で、「認可スキーム」リストから選択します。

4. 「条件」で、「条件タイプ」リストから選択し、その選択に応じて、該当する「式」フィールドに式または値を入力します。
認可が正常に終了し、条件タイプの表示がtrueに評価されると、列が表示されます。

関連項目:
「認可を介したセキュリティの提供」、「条件付きのレンダリングおよびプロセスの理解」および付録A「使用可能な条件」

クラシック・レポートでの列ブレークの制御

ブレーク書式属性を使用すると、出力する場合に、特定の列を繰り返すかどうか、および列のブレーク方法を制御できます。たとえば、レポートに、部門番号ごとに従業員情報を表示するとします。複数の従業員が同じ部門に所属している場合、部門番号が1回のみ表示されるように指定することによって、読みやすさを向上できます。

このタイプの列ブレークを作成するには、次のステップを実行します。

1. 該当するレポート属性ページにナビゲートします。詳細は、「SQLレポートおよびウィザード・レポートの編集」を参照してください。

2. 「ブレーク書式」までスクロールします。

3. 「ブレーク」リストから選択します。

レポート・リージョンの出力

様々な形式にエクスポートすることによって、出力するクラシック・レポート・リージョンを構成できます。Oracle BI Publisherでは、Adobe Portable Document Format(PDF)、Microsoft Wordリッチ・テキスト形式(RTF)、Microsoft Excel形式(XLS)またはExtensible Markup Language(XML)がサポートされます。指定されたApache FOP代替付きOC4Jでは、PDFおよびXMLのみがサポートされます。他のサード・パーティ・レンダリング・エンジンの使用を選択すると、他の出力形式も構成されます。

リージョン・レポート出力を利用すると、アプリケーション・ユーザーは、印刷の方向、ページ・サイズ、列ヘッダーおよびページのヘッダーとフッターが事前定義されたレポートを表示および出力できます。対話モード・レポートでも、PDF、RTF、Microsoft ExcelおよびCSVへのエクスポートが可能です。対話モード・レポートの場合、カスタム・レポート・レイアウトは定義できないことに注意してください。

この項に含まれる内容は次のとおりです。

- PDFへのレポート出力について

- レポート出力の構成オプションについて

- クラシック・レポートの出力メソッドについて

- レポート問合せについて

- レポート・レイアウトについて

- クラシック・レポート・リージョンの出力属性の構成

- 対話モード・レポート・リージョンの出力属性の構成

ヒント:
Oracle Application ExpressをOracle Database 11g リリース1(11.1)以上で実行している場合は、レポート出力を使用するためにネットワークを有効にする必要があります。「Oracle Database 11gのネットワーク・サービスの有効化」を参照してください。

関連項目:
Oracle Application Expressアドバンスト・チュートリアルの「マスター・ディテールPDFレポートの作成方法」

PDFへのレポート出力について

PDFに出力する際に、レポート・データは外部で定義されたレポート・サーバーを使用して変換されます。アプリケーションのエンド・ユーザーが出力リンクをクリックすると、Application Expressエンジンにリクエストが送信されます。Application Expressエンジンは、レポート・データをXML形式で、レポート・テンプレートをXSL-FO形式またはRTF形式で生成します。次に外部のレポート・エンジンがデータおよびテンプレートをPDFに変換し、変換されたPDFはBI Publisher 10.1.3.2(以前のOracle XML Publisher)に付属の変換サーブレットを使用してエンド・ユーザーに表示されます。このようなアーキテクチャ上の複雑さは、エンド・ユーザーおよび開発者には意識されません。エンド・ユーザーは出力リンクをクリックするだけでよく、開発者はPDF出力をサポートするリージョンを宣言的に設定するだけです。他の形式への出力も、必要な変換サーブレットを使用して同様に行われます。

レポート出力の構成オプションについて

レポート・サーバーには、Oracle BI Publisher、Apache FOP付きOC4Jなどの標準的なXSL-FO処理エンジンを使用できます。Oracle BI Publisherは、より高度な機能を提供しており、マスター・ディテール・レポート、チャートなどの忠実度の高い出力要件の実現を促進します。Oracle Application Expressでは、機能の違いに対応するために、2つのレポート出力の構成オプションが提供されています。

- 標準サポート: (標準XSL-FO処理エンジンに付属する)組込みテンプレートを使用するか、その他のXSL-FO互換形式を指定して、レポート・リージョンおよびレポート問合せを出力できます。この設定では、RTFはサポートされません。
標準サポートは、レポート・リージョンおよびレポート問合せの宣言型書式設定に、ページ属性(ページの印刷方向、ページ・サイズ、列のヘッダー形式、ページのヘッダーおよびフッターなど)全体の基本的な制御を指定します。

- 拡張サポート: Oracle BI Publisher(Oracle XML Publisherとも呼ばれる)の使用許諾が必要です。拡張サポートでは、標準設定の全機能に加え、BI PublisherのWord Template Builderを使用して開発されたRTFベースのレポート・レイアウトを定義する機能が提供されます。
Oracle BI Publisherのインストールおよび構成の詳細は、「PDF Printing in Application Express 3.1」を参照してください。次のWebサイトにアクセスしてください。

http://www.oracle.com/technetwork/developer-tools/apex/overview/index.html

注意:
レポート出力の機能をすべて使用するには、Oracle Application Expressのサービス管理者がこの機能をサイトで有効にする必要があります。詳細は、Oracle Application Express管理ガイドの「レポート出力の構成」を参照してください。

クラシック・レポートの出力メソッドについて

クラシック・レポートのリージョンは、次の2つの方法で出力できます。

- レポート・リージョンの出力属性の構成。リージョンに対して出力属性を構成することによって、レポート・リージョンを出力できます。「クラシック・レポート・リージョンの出力属性の構成」を参照してください。

- レポート問合せの作成。レポート問合せを共有コンポーネントとして定義することで、レポートを出力できます。「レポート問合せについて」を参照してください。

レポート・リージョンおよびレポート問合せは、次の形式でダウンロードできます。

- PDF - Adobe Portable Document Format。

- RTF - Microsoft Word Rich Text Format。

- XLS - Microsoft Excel形式。ただし、コンテンツはHTMLベースであるため、本当の.xlsファイルではありません。

- HTML

- XML - Extensible Markup Language。

レポート・リージョンまたはレポート問合せを書式設定するには、レポート・レイアウトと関連付けます。詳細は、「レポート・レイアウトについて」を参照してください。

レポート問合せについて

レポート・リージョンは、レポート問合せを共有コンポーネントとして定義することによって出力できます。レポート問合せは、抽出されるデータを識別します。リージョンに含まれるSQL文とは異なり、レポート問合せには、問合せを保存すると有効化されるSQL文が含まれます。レポート問合せは、SQL文を戻すファンクションではなく、SQL文である必要があります。

レポート問合せは、レポート・レイアウトに関連付けて、書式化されたドキュメントとしてダウンロードできます。レポート・レイアウトが選択されていない場合は、汎用のレイアウトが使用されます。汎用レイアウトは、レポート問合せのテストと検証の目的で使用します。汎用レイアウト・オプションを使用する場合にソース問合せが複数定義されていると、最初の結果セットのみが出力ドキュメントに含まれます。レポートには、現行のアプリケーションのセッション・ステートを含めることができます。

これらのレポートをアプリケーションと統合することにより、エンド・ユーザーから使用できるようにします。たとえば、ボタン、リスト・アイテム、ブランチ、またはターゲットとしてURLを使用できるその他のナビゲーション・コンポーネントをレポート問合せに関連付けることができます。そのアイテムを選択すると、出力プロセスが開始します。

この項に含まれる内容は次のとおりです。

- レポート問合せの作成

- レポート問合せの編集

- レポート問合せのコピー

レポート問合せの作成

「レポート問合せ」オプションの可用性は、サービス管理者がインスタンスに対してどのようなレポート出力設定を行ったかによって異なります。これらのステップに示されたすべてのオプションが使用可能であるとはかぎりません。

関連項目:
「レポート出力の構成オプションについて」

レポート問合せを作成するには、次のステップを実行します。

1. 共有コンポーネント・ページにナビゲートします。「共有コンポーネント・ページへのアクセス」を参照してください。

2. 「レポート」で、「レポート問合せ」をクリックします。

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

4. 問合せを実行するには、次の情報を指定します。

1. レポート問合せ名 - レポート問合せを識別する名前を入力します。リンク・ターゲットとしてレポート問合せを参照する際に、レポート問合せ名はリクエスト文字列の一部になります。

2. 出力形式 - レポート出力形式を選択します。有効なオプションは、次のとおりです。

- PDF - Adobe Portable Document Format。

- Word - Microsoft Word Rich Text Format。

- Excel - Microsoft Excel形式。ただし、コンテンツはHTMLベースであるため、本当の.xlsファイルではありません。

- HTML

- XML - Extensible Markup Language。

3. アイテム - 形式の値を保持するアイテムを選択します。これは、実行時の出力形式を指定する際に使用できます。

4. ファイルの表示形式 - レポート問合せドキュメントをWebブラウザでどのように開くかを選択します。オプションは次のとおりです。

- 添付ファイル - ユーザーがレポート問合せのダウンロード・ボタンをクリックすると、ファイルを開くか、または保存するかを尋ねるダイアログ・ボックスが表示されます。

- インライン - レポート問合せドキュメントをブラウザのウィンドウ内に表示します。

5. セッション・ステート - セッション・ステートの値(レポートのXML構造のページ・アイテムの値など)を参照するには、このチェック・ボックスを選択します。

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

5. 「SQL問合せ」にSQL文を直接入力するか、「クエリー・ビルダー」をクリックして、クリックやポイントによってSQL文を作成します。
SQL文でアプリケーションおよびページ・アイテムを参照する場合は、バインド変数として参照します。「バインド変数の設定」をクリックすると、各バインド変数について値を入力し、問合せをテストして、目的の出力が戻されることを確認できます。

6. 「定義のダウンロード」で、次の項目を指定します。

1. レポート・レイアウトのデータ・ソース - このオプションは、レポート定義のエクスポート・ファイルをダウンロードするために使用します。「XMLデータ」または「XML Schema」を選択してから、「ダウンロード」をクリックします。
「XML Schema」を選択すると、XSDファイル(XML構造のXMLスキーマ定義)が作成されます。

2. 問合せの追加 - このボタンをクリックすると、レポート問合せに別の問合せを追加できます。別の問合せを追加することにより、複数の出力コンポーネント(2つの異なる問合せをベースにしたチャートおよびレポートなど)を含む複雑なレポートの生成が可能になります。

3. レポート問合せの作成 - このボタンをクリックすると、ウィザードが早期に終了します。「レポート・レイアウトのソース」には、汎用のレポート・レイアウトが使用されることになります。

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

7. 「レポート・レイアウトのアップロード」で、次の項目を指定します。

1. レポート・レイアウトのソース - レポート・レイアウトの導出方法を指定します。レポート・ベースのファイル・レイアウトを選択した場合、レイアウト名とレポート・レイアウト・ファイルを指定する必要があります。

2. レイアウト名 - レイアウト名を入力します(オプション)。デフォルトは、レポート問合せの名前です。

3. レポート・レイアウト・ファイル - 「参照」をクリックし、Rich Text Format(RTF)を選択します。

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

8. 「確認」で、次のステップを実行します。

1. 問合せ名 - 問合せを識別します。

2. レポート・レイアウト - 選択したレポート・レイアウトを識別します。

3. 出力形式 - このレポート問合せの形式を識別します。

4. アイテムから派生 - 形式情報を保持するアイテムを識別します。

5. URL - このレポートをアプリケーションに統合するには、表示されたURLをボタン、リスト・アイテム、リンクまたは他のナビゲーション・コンポーネントに対するターゲットとして使用します。これにより、たとえば、エンド・ユーザーはボタンをクリックして、出力プロセスを開始できます。

6. テスト・レポート - これをクリックして、レポートのプレビューを表示します。汎用レポート・レイアウトを使用するように指定している場合は、「テスト・レポート」をクリックしても出力は生成されません。

7. 「終了」をクリックします。
レポート問合せは、「共有コンポーネント」に作成および保存されます。

レポート問合せの編集

レポート問合せを編集するには、次のステップを実行します。

1. 共有コンポーネント・ページにナビゲートします。「共有コンポーネント・ページへのアクセス」を参照してください。

2. 「レポート」で、「レポート問合せ」をクリックします。

3. レポート問合せページで、ページ上部のナビゲーション・バーを使用して名前で問合せを検索したり、またはページの表示を変更できます。たとえば、「ビュー」リストから選択して、デフォルトの表示を変更できます。使用可能なオプションは次のとおりです。

- アイコン: (デフォルト)各問合せを大きいアイコンとして表示します。問合せを編集するには、該当するアイコンをクリックします。

- 詳細: 各問合せをレポートで1行に表示します。問合せを編集するには、名前をクリックします。

4. 目的のレポート問合せを選択します。レポート問合せの編集ページで、情報を編集します。

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

レポート問合せのコピー

レポート問合せをコピーするには、次のステップを実行します。

1. 共有コンポーネント・ページにナビゲートします。「共有コンポーネント・ページへのアクセス」を参照してください。

2. 「レポート」で、「レポート問合せ」をクリックします。

3. レポート問合せページで、「コピー」をクリックします。

4. 「レポート問合せのコピー」で、コピーする問合せを選択して、レポート問合せの名前を入力し、「コピー」をクリックします。
コピーが問合せリストに表示されます。

レポート・レイアウトについて

クラシック・レポート・リージョンまたはレポート問合せのどちらかをフォーマットするには、レポート・レイアウトと関連付けます。レポート・レイアウトを使用すると、印刷用形式でデータをレンダリングできます。レポート・レイアウトを選択しない場合は、デフォルトのXSL-FOレイアウトが使用されます。対話モード・レポートのリージョンのレンダリングでは、常にデフォルトのXSL-FOレイアウトが使用されます。

レポート・レイアウトを作成して使用すると、次のことができるようになります。

- レポート・リージョンのデフォルト・レイアウト、およびOracle Application Expressで用意されているレポート問合せの汎用レイアウトを利用できます。

- コードをコピーしてカスタマイズすることによって、レポート・リージョンの組込みXSL-FOベースのレイアウトが利用できます。レポート・リージョンに対して、ページ・サイズ、フォント、色などを制御する様々な属性を編集できます。

- RTFまたはXSL-FOレポート・レイアウトを作成してレポートのルック・アンド・フィールをカスタマイズできます。RTFレポート・レイアウトを使用するには、Oracle Application Expressのサービス管理者が、そのサイトに対して詳細設定を選択している必要があります。詳細は、Oracle Application Express管理ガイドの「レポート出力の構成」を参照してください。

この項に含まれる内容は次のとおりです。

- レポート・レイアウト・オプションの概要

- レポート・レイアウトの作成

- レポート・レイアウトの編集

- レポート・レイアウトのコピー

レポート・レイアウト・オプションの概要

レポート・レイアウトは、次のいずれかのオプションに基づいて作成できます。

- 汎用列 - 汎用レポート・レイアウトはほとんどの問合せ結果セットに使用できます。このレイアウトを使用すると、出力可能なドキュメントの生成時に、列の数が自動的に調整されます。
多くのレポート・レイアウト属性は、組込みのデフォルトXSL-FOレイアウトを使用して、レポート・リージョンに対して宣言的に定義できます。レポート・レイアウトを追加制御する必要がある場合は、このステップによりカスタマイズ可能な組込みのデフォルトXSL-FOレイアウトのコピーを作成できます。

- 名前付き列 - 名前付き列のレポート・レイアウトは、問合せ固有のレポート・レイアウトで、問合せ結果セットに含まれる列の定義済リストで使用できるよう設計されています。このレイアウト・タイプはページ・アイテムおよび問合せ列の位置を正確に制御する必要がある場合に、個別に設計されたレイアウトで使用されます。

「レポート・レイアウト」オプションの可用性は、サイト管理者がサイトでどのようなレポート出力設定を行ったかによって異なります。これらのステップに示されたすべてのオプションが使用可能であるとはかぎりません。

関連項目:
Oracle Application Express管理ガイドの「レポート出力の構成」

レポート・レイアウトの作成

レポート・レイアウトを作成するには、次のステップを実行します。

1. 共有コンポーネント・ページにナビゲートします。「共有コンポーネント・ページへのアクセス」を参照してください。

2. 「レポート」で、「レポート・レイアウト」をクリックします。

3. 「作成」をクリックします。
レポート・レイアウトの作成ウィザードが表示されます。

4. 「レポート・レイアウト・タイプ」で、オプションを選択し、「次へ」をクリックします。

- 汎用列(XSL-FO) - このレイアウトは、デフォルトのテンプレートに事前移入され、ユーザーのニーズにあわせて編集可能です。

- 名前付き列(RTF) - このレイアウトはRTFファイルとしてアップロードされます。

- 名前付き列(XSL-FO) - このレイアウトはXSL-FOファイルとしてアップロードされます。

5. 「レイアウト・ソース」で、該当する情報を確認および編集します。このページに表示されるオプションは、選択したレイアウト・タイプによって異なります。

- 「汎用列」を選択した場合は、次のステップを実行します。

1. レポート・レイアウト名 - レポート問合せまたはレポート・リージョンに関連付ける際にレポート・レイアウトを識別するための名前を入力します。

2. レポート・レイアウト - レポート・レイアウトは、ページ書式のXSL-FOベースの定義です。ページ・サイズ、向き、フォント、スタイルなどを定義する属性は、すべてこのセクションで定義されます。
有効な置換文字列のリストおよびその他の情報のリストを表示するには、アイテム・ラベル「レポート・レイアウト」をクリックします。個別のヘルプ・ウィンドウが開きます。

3. レポートの列ヘッダー - レポート・ヘッダー行の各セルの外観を定義します。

4. レポート列 - すべてのレポート行に対する各セルの外観を定義します。

5. レポート列の幅 - 実行時に計算されるか、またはレポート・リージョンのレポート列定義から導出できます。

- 名前付き列を選択した場合は、次のステップを実行します。

1. レイアウト名 - レポート問合せまたはレポート・リージョンに関連付ける際に、レポート・レイアウトを識別するための名前を入力します。

2. レポート・レイアウト・ファイル - レポート・レイアウトが含まれるファイルをアップロードします。

レポート・レイアウトの編集

汎用列のレポート・レイアウトを直接Application Expressで編集できます。ただし、名前付き列のレポート・レイアウトを編集するには、現行のファイルをダウンロードしてそれを編集し、再度アップロードする必要があります。

レポート・レイアウトを編集するには、次のステップを実行します。

1. 共有コンポーネント・ページにナビゲートします。「共有コンポーネント・ページへのアクセス」を参照してください。

2. 「レポート」で、「レポート・レイアウト」をクリックします。

3. レポート・レイアウト・ページで、編集するレイアウトを選択します。

4. 汎用列レイアウトの場合は、レポート・レイアウトの編集ページで直接レイアウトを編集してから、「変更の適用」をクリックします。

5. 名前付き列のレイアウトの場合は、「ダウンロード」をクリックして、コンピュータにファイルを保存します。
ファイルを編集して、新しいレポート・レイアウトとして更新されたバージョンをアップロードします。

レポート・レイアウトのコピー

レポート・レイアウトをコピーして編集および保存できます。

レポート・レイアウトをコピーするには、次のステップを実行します。

1. 共有コンポーネント・ページにナビゲートします。「共有コンポーネント・ページへのアクセス」を参照してください。

2. 「レポート」で、「レポート・レイアウト」をクリックします。

3. レポート・レイアウト・ページで、「コピー」をクリックします。

4. レポート・レイアウトのコピー・ページで、コピーするレイアウトを選択して、コピーの名前を入力し、「コピー」をクリックします。
コピーがレイアウト・リストに表示されます。

クラシック・レポート・リージョンの出力属性の構成

レポート・リージョンを出力する方法の1つは、出力属性を構成する方法です。構成後、これらの属性は現行のリージョンのみに適用され、リージョンのコンテキスト外では使用できません。

インスタンスに対して出力機能が設定されている場合、様々な形式で出力できるようにレポート・リージョンを構成できます。

関連項目:
「クラシック・レポートの出力メソッドについて」およびOracle Application Express管理ガイドの「レポート出力の構成」

出力用にクラシック・レポート・リージョンを構成するには、次のステップを実行します。

1. アプリケーションで、出力するクラシック・レポート・リージョンを含むページを選択します。
ページ定義が表示されます。

2. 「リージョン」で、出力するリージョンの横にある「レポート」をクリックします。

3. 「出力属性」タブをクリックします。

4. 「出力」で、次の該当する情報を指定します。

1. レポート出力の有効化 - 「はい」を選択します。

2. リンク・ラベル - 出力プロセスを開始するリンクのテキストを入力します。

3. レスポンス・ヘッダー - Oracle Application Expressにより生成されたレスポンス・ヘッダーは、「レポート設定」または「プリント・サーバー」に基づきます。レスポンス・ヘッダーは、HTTPリクエストを受信した応答としてサーバーがブラウザに送信する情報です。レスポンス・ヘッダーには、サーバーがクライアントに送信するファイルの日付、サイズ、タイプに加えて、サーバー自体に関するデータも含まれています。コンテンツ配置(「ファイルの表示形式」を使用)およびファイル名を指定する場合、レスポンス・ヘッダーはレポート設定に基づいている必要があります。

4. ファイルの表示形式 - レポート問合せドキュメントをWebブラウザでどのように開くかを選択します。オプションは次のとおりです。

- 添付ファイル - レポート問合せのダウンロード・ボタンをクリックすると、ファイルを開く/保存のダイアログ・ボックスが表示されます。

- インライン - レポート問合せドキュメントがブラウザ・ウィンドウ内に表示されます。

5. (オプション)ファイル名 - ダウンロードされるファイルの名前を入力してください。空白にすると、リージョン名がファイル名として使用されます。

6. 出力形式 - 出力オプションを選択します。

7. アイテム - 出力形式を実行時に決定します。形式の値を保持するアプリケーションまたはページのアイテムを選択します。

8. レポート・レイアウト - 組込みの汎用レポート・レイアウトを使用する場合は、「デフォルト・レポート・レイアウト」を選択します。自分または管理者が作成したレポート・レイアウトを選択することもできます。カスタムXSL-FOレポート・レイアウトを構築する場合に使用可能な置換文字列のリストについては、アイテム・ヘルプを参照してください。

9. プリント・サーバーの上書き - 代替のプリント・サーバーを指定します。プリント・サーバーは通常、Oracle Application Express管理サービスのすべてのワークスペースについて一元的に設定されます。詳細は、Oracle Application Express管理ガイドの「レポート出力の構成」を参照してください。
代替プリント・サーバーをレポート・レベルで構成すると、出力で予想される問題のデバッグと診断が簡単になり、カスタム作成した特定のエンド・ポイントを使用してカスタムのXSLT変換を実行することが可能になります。

10. 出力URL - レポート・リージョンは、標準の出力リンク、またはページ・ボタンを使用して出力できます。ボタンを使用する場合、リンク・ラベルを削除し、ページにボタンを作成し、この属性に表示されるURLをボタン・ターゲットとして使用します。

5. 残りのセクションで、ページ・サイズ、用紙の向き、ページのヘッダーおよびフッター、フォント、テキストの色、背景の色を定義します。

6. 「レポート列」で、各列の幅を指定します。
デフォルトでは、各列の幅は同じになります。「合計幅」は表示専用フィールドであり、すべての列幅の合計を示します。個々の列の幅を変更すると、「合計幅」は自動的に再計算されます。「列幅の単位」が「ポイント」ではなく「割合」に設定されている場合は、列幅の合計を100以下にする必要があります。

「列幅のリセット」ボタンをクリックすると、「列幅の単位」が「割合」になり、すべての列幅がそれぞれのデフォルト値に戻ります。「再計算」ボタンをクリックすると、列幅の割合は現在の値を維持したままで、合計幅が100%以下になるように、すべての列幅が縮小されます。

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

対話モード・レポート・リージョンの出力属性の構成

対話モード・レポートの出力属性は、クラシック・レポートの場合とは異なり、デフォルトのXSL-FOレイアウトのみを使用できます。また、この画面から直接開始するのではなく、「レポート属性」の「ダウンロード」セクションからのみ開始できます。構成した属性は、現行のリージョンのみに適用され、リージョンのコンテキスト以外では使用できません。

インスタンスに対して出力機能が設定されている場合、様々な形式で出力できるようにレポート・リージョンを構成できます。

出力用に対話モード・レポート・リージョンを構成するには、次のステップを実行します。

1. アプリケーションで、出力する対話モード・レポート・リージョンを含むページを選択します。
ページ定義が表示されます。

2. 「リージョン」で、出力するリージョンの横にある「対話モード・レポート」をクリックします。

3. 「出力属性」タブをクリックします。

4. 「出力」で、次の該当する情報を指定します。

1. レスポンス・ヘッダー - Oracle Application Expressにより生成されたレスポンス・ヘッダーは、「レポート設定」または「プリント・サーバー」に基づきます。レスポンス・ヘッダーは、HTTPリクエストを受信した応答としてサーバーがブラウザに送信する情報です。レスポンス・ヘッダーには、サーバーがクライアントに送信するファイルの日付、サイズ、タイプに加えて、サーバー自体に関するデータも含まれています。コンテンツ配置(「ファイルの表示形式」を使用)およびファイル名を指定する場合、レスポンス・ヘッダーはレポート設定に基づいている必要があります。

2. コンテンツ配置 - レポート問合せドキュメントをWebブラウザでどのように開くかを選択します。オプションは次のとおりです。

- 添付ファイル - レポート問合せのダウンロード・ボタンをクリックすると、ファイルを開く/保存のダイアログ・ボックスが表示されます。

- インライン - レポート問合せドキュメントがブラウザ・ウィンドウ内に表示されます。

3. プリント・サーバーの上書き - 代替のプリント・サーバーを指定します。プリント・サーバーは通常、Oracle Application Express管理サービスのすべてのワークスペースについて一元的に設定されます。詳細は、Oracle Application Express管理ガイドの「レポート出力の構成」を参照してください。
代替プリント・サーバーをレポート・レベルで構成すると、出力で予想される問題のデバッグと診断が簡単になり、カスタム作成した特定のエンド・ポイントを使用してカスタムのXSLT変換を実行することが可能になります。

5. 残りのセクションで、ページ・サイズ、用紙の向き、ページのヘッダーおよびフッター、フォント、テキストの色、背景の色を定義します。

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

フォームの作成

様々なタイプのフォームをアプリケーションに含めることができます。表内の単一行のみを更新できるフォーム、または同時に複数行を更新できるフォームを含めることができます。アプリケーション・ビルダーには、自動的にフォームを作成するために使用できる多くのウィザードが含まれていますが、手動でフォームを作成することもできます。

この項に含まれる内容は次のとおりです。

- ウィザードを使用したフォームの作成

- 表形式フォームの作成

- マスター・ディテール・フォームの作成

- フォームの手動作成

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

ウィザードを使用したフォームの作成

フォームを作成する最も簡単な方法は、ウィザードを使用することです。たとえば、表またはビューのフォーム・ウィザードでは、1つの表の1列ごとに1つのアイテムを作成します。このウィザードには、主キーを使用した表への行の挿入、表の行の更新および削除に必要なボタンおよびプロセスが含まれています。各リージョンには、定義名および表示位置が指定されています。その他の属性には、アイテム、ボタン、プロセスおよびブランチがあります。

ウィザードを使用してフォームを作成するには、次のステップを実行します。

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

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

3. 「ページの作成」をクリックします。

4. 「フォーム」を選択して、「次へ」をクリックします。

5. 「フォーム」で、表 7-6に示すフォーム・ページのタイプを選択します。

表 7-6 フォーム・ページ・タイプ

フォーム・ページ・タイプ

説明

プロシージャのフォーム

ストアド・プロシージャの引数に基づくフォームを構築します。ストアド・プロシージャまたはパッケージに実装済のロジックまたはデータ操作言語(DML)が存在する場合は、この方法を使用します。

表またはビューのフォーム

データベース表の単一行を更新できるフォームを作成します。

レポート付きの表のフォーム

2つのページを作成します。1つのページにはレポートが表示されます。各行に2ページ目へのリンクが提供され、これを使用して各レコードを更新できます。

注意: このウィザードでは、127列を超える列が含まれている表はサポートされていません。127列を超える列を選択すると、エラーが発生します。

マスター・ディテール・フォーム

1つのHTMLフォーム内にマスター行および複数のディテール行を表示するフォームを作成します。このフォームを使用すると、2つの表またはビューに対し、値の問合せ、挿入、更新および削除を行うことができます。

関連項目: 「マスター・ディテール・フォームの作成」

表形式フォーム

データベースの複数の行を更新できるフォームを作成します。

関連項目: 「表形式フォームの作成」

SQL問合せのフォーム

EQUIJOINなどのSQL問合せによって戻される列に基づくフォームを作成します。

サマリー・ページ

読取り専用のフォームを作成します。通常、ウィザードの最後に確認ページを提供するために使用します。

Webサービスのフォーム

Webサービスの定義に基づいて、アイテムを含むページを作成します。このウィザードでは、ユーザー入力フォーム、Webサービスをコールするプロセスおよび送信ボタンを作成します。

関連項目: 「Webサービスでのフォームの作成」

Webサービスのフォームとレポート

Webサービスの定義に基づいて、アイテムを含むページを作成します。このウィザードでは、ユーザー入力フォーム、Webサービスをコールするプロセスおよび送信ボタンを作成し、レポートに結果を表示します。

関連項目: 「Webサービスでの入力フォームとレポートの作成」

6. 画面に表示されるステップに従います。特定のフィールドの詳細を表示するには、アイテム・ラベルをクリックします。
ヘルプが利用できる場合は、アイテム・ラベル上にカーソルを重ねると、アイテム・ラベルが赤色に変わり、カーソルが矢印と疑問符に変わります。「フィールドレベル・ヘルプについて」を参照してください。

表形式フォームの作成

表形式フォームを使用すると、表の複数の行を一度に更新できます。「表形式フォーム」ウィザードでは、データベース表の複数の行に対して更新、挿入および削除を行うフォームを作成します。

表形式フォームを作成するには、次のステップを実行します。

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

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

3. 「ページの作成」をクリックします。

4. 「フォーム」を選択して、「次へ」をクリックします。

5. 「表形式フォーム」を選択して、「次へ」をクリックします。
「表形式フォーム」ウィザードが表示されます。

6. 「表/ビューの所有者」で、次のステップを実行します。

1. 表形式フォームの基となる表またはビューの所有者を指定します。

2. 表で実行する操作(たとえば、更新、挿入、削除など)を選択します。

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

7. 「表/ビューの名前」について、表を選択して「次へ」をクリックします。

8. 「表示列」で、次のステップを実行します。

1. フォームに含める列(更新可能および更新不可)を選択します。
ページの作成後に、列の順序またはSQL問合せを変更できるので注意してください。

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

9. 「主キー」について、「主キー」列とセカンダリの「主キー」列(適用可能な場合)を選択して「次へ」をクリックします。

10. 「主キーのソース」について、主キー列のソース・タイプを選択して「次へ」をクリックします。有効なオプションは、次のとおりです。

- 既存のトリガー - 表にトリガーが定義されている場合はこのオプションを選択します。このオプションは、フォームを完成させた後に主キー列ソースを指定する場合も選択できます。

- カスタムPL/SQLファンクション - 戻りキー値を生成するPL/SQLファンクションを指定する場合はこのオプションを選択します。

- 既存の順序 - 選択されているスキーマで使用可能な順序のリストから順序を選択する場合は、このオプションを選択します。

11. 「更新可能な列」で、更新可能にする列を選択して「次へ」をクリックします。

12. 「ページおよびリージョン属性」で、次のステップを実行します。

1. ページおよびリージョン情報を指定します。

2. リージョン・テンプレートを選択します。

3. レポート・テンプレートを選択します。

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

13. 「タブ」で、このページに対するタブ実装を指定して「次へ」をクリックします。

14. 「ボタン・ラベル」で、各ボタンに表示される表示テキストを入力して「次へ」をクリックします。

15. 「ブランチ」で、「送信」および「取消」ボタンをクリックした後、ブランチ先のページを指定して「次へ」をクリックします。

16. 「終了」をクリックします。

注意:
表形式フォームのSQL文の選択リストを、生成された後に変更することはお薦めしません。問合せを変更する場合は、更新可能列の値が、Application Expressエンジンによってデータベースから問合せされた後に変更されていないことを確認してください。

関連項目:
「ユーザー・インタフェースのデフォルト値の管理」

チュートリアルを参照:
Oracle Application Expressアドバンスト・チュートリアルの「表形式フォームの作成方法」

マスター・ディテール・フォームの作成

マスター・ディテール・フォームは、データベースの2つの表の1対多関係を示します。通常、マスター・ディテール・フォームには、1つのHTMLフォーム内にマスター行および複数のディテール行が表示されます。このフォームを使用すると、2つの表またはビューに対し、値の挿入、更新および削除を行うことができます。

マスター・ディテール・フォームを作成するには、次のステップを実行します。

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

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

3. 「ページの作成」をクリックします。

4. 「フォーム」を選択して、「次へ」をクリックします。

5. 「マスター・ディテール・フォーム」を選択して、「次へ」をクリックします。
マスター・ディテール・ウィザードが表示されます。

6. 「マスター表」で、次のステップを実行します。

1. 表またはビューの所有者を選択します。

2. 表またはビューの名前を選択します。
このオブジェクトの列は、「選択可能な列」の下に表示されます。

3. フォームに表示する列を選択してから矢印キーをクリックして、それを「表示列」に移動します。

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

7. 「ディテール表」で、次のステップを実行します。

1. 「はい」または「いいえ」を選択して、関連する表のみを表示するかどうか指定します。

2. 表またはビューの所有者を選択します。

3. 表またはビューの名前を選択します。
このオブジェクトの列は、「選択可能な列」の下に表示されます。

4. フォームに表示する列を選択してから矢印キーをクリックして、それを「表示列」に移動します。

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

8. 「主キー」で、次のステップを実行します。

1. マスター表の主キー - マスター表の1つまたは複数の主キーを選択します。マスター表には最大2つの主キーを選択できます。

2. ディテール表の主キー - ディテール表の主キーを選択します。ディテール表の主キーは、最大で2つ選択できます。

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

9. 「マスター・ディテール・リンク」で、マスター表とディテール表の関係を定義し、「次へ」をクリックします。

10. 「主キーのソース」で、マスター表の主キー列を選択し、「次へ」をクリックします。次に、ディテール表の主キー列を選択し、「次へ」をクリックします。オプションは次のとおりです。

- 既存のトリガー - 主キーを移入するためトリガーが定義されている場合、またはユーザーが主キー値を手動で入力することが予想される場合は、このオプションを選択します。ディテール表では、ユーザー入力の主キー値はサポートされません。

- カスタムPL/SQLファンクション - 主キーを移入するためPL/SQLファンクションを指定する場合は、このオプションを選択します。

- 既存の順序 - 既存の順序が主キーの生成に使用される場合は、このオプションを選択します。

11. 「マスター・オプション」で、マスター行のナビゲーションを含めるかどうかを指定して「次へ」をクリックします。
マスター行のナビゲーションを含める場合は、ナビゲーション順の列を定義します。ナビゲーション順の列が定義されていないと、マスターの更新フォームは、主キー列を使用してナビゲートします。

12. 「レイアウト」で、マスター・ディテールの構築方法を指定して「次へ」をクリックします。オプションは次のとおりです。

- 「同一ページで表形式フォームとしてディテールの編集」では、2ページのマスター・ディテールが作成されます。「別のページでディテールの編集」では、3ページのマスター・ディテールが作成されます。

- 「別のページでディテールの編集」では、3ページのマスター・ディテールが作成されます。

13. 「ページ属性」で、マスター・ページおよびディテール・ページ情報を確認および編集してから「次へ」をクリックします。

14. 「タブ」で、タブ・セットを含めるかどうかを指定して「次へ」をクリックします。

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

フォームの手動作成

次のステップを実行することによって、フォームを手動で作成することもできます。

- (ページ・アイテムのコンテナとして機能する)HTMLリージョンを作成します。

- リージョンに表示するアイテムを作成します。

- プロセスおよびブランチを作成します。

HTMLリージョンを作成することによって手動でフォームを作成するには、次のステップを実行します。

1. 該当するページ定義にナビゲートします。「ページ定義へのアクセス」を参照してください。

2. HTMLリージョンを作成します。

1. 「リージョン」で、「作成」アイコンをクリックします。

2. リージョン・タイプに「HTML」を選択します。

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

3. ページへのアイテムの追加を開始します。

- 「アイテム」で、「作成」アイコンをクリックします。

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

フォームの処理

フォームを作成したら、次に、基礎となるデータベース表またはビューに対して挿入または更新を行うことによって、ユーザーが入力したデータを処理します。フォームを処理する方法には、3通りあります。

- 行の自動処理(DML)プロセスの作成

- 1つ以上の挿入文を含むプロセスの作成

- PL/SQL APIを使用したフォーム値の処理

行の自動処理(DML)プロセスの作成

フォームを実装するための一般的な方法の1つは、行の自動処理(DML)プロセスを手動で作成することです。この方法には、3つのメリットがあります。1つ目は、SQLコードを指定する必要がないことです。2つ目は、Oracle Application ExpressによってDMLプロセスが実行されることです。3つ目は、このプロセスによって、ロストした更新の検出が自動的に実行されることです。ロストした更新の検出によって、データに同時にアクセスできる複数のアプリケーションのデータの整合性が保証されます。

この方法を実装するには、次のステップを実行します。

- アイテムを追加し、「アイテム・ソース」タイプを「データベース列」に定義し、大/小文字が区別される列名を指定します。

- オプション「常にキャッシュ値より優先」を選択します。

行の自動処理(DML)プロセスを作成するには、次のステップを実行します。

1. 該当するページ定義にナビゲートします。「ページ定義へのアクセス」を参照してください。

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

3. プロセスの「データ操作」を選択します。

4. プロセス・カテゴリの「行の自動処理(DML)」を選択します。

5. 次のプロセス属性を指定します。

1. 「名前」フィールドで、プロセスを識別するための名前を入力します。

2. 「順序」フィールドで、順序番号を指定します。

3. 「ポイント」リストから、適切なプロセス・ポイントを選択します。通常、「ロード時 - ヘッダーの後」を選択します。

4. 「タイプ」リストから、「行の自動処理(DML)」を選択します。

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

1つ以上の挿入文を含むプロセスの作成

この方法でフォームを処理するには、挿入、更新および削除操作を実行する1つ以上のプロセスを作成します。Application Expressエンジンですべての操作を透過的に実行するかわりに、操作の制御はユーザーが行います。

たとえば、3つのアイテムを持つフォームが存在すると想定します。

- P1_ID: 表に現在表示されている行の主キーを格納するための非表示アイテム。

- P1_FIRST_NAME: ユーザー入力用のテキスト・フィールド。

- P1_LAST_NAME: ユーザー入力用のテキスト・フィールド。

また、「挿入」、「更新」および「削除」というラベルの3つのボタンがあるとします。さらに、3つの列id、first_nameおよびlast_nameを含む表Tがあるとします。この表には、値を指定しなかった場合に自動的にID列が移入されるトリガーがあります。

新しい行の挿入を処理するには、ユーザーが「挿入」ボタンをクリックしたときに実行されるPL/SQLの条件付きプロセスを作成します。次に例を示します。

BEGIN
INSERT INTO T ( first_name, last_name )
VALUES  (:P1_FIRST_NAME, :P1_LAST_NAME);
END;

行の更新を処理するには、PL/SQLの条件付きプロセスをもう1つ作成します。次に例を示します。

BEGIN
UPDATE T
SET first_name = :P1_FIRST_NAME,
last_name = :P1_LAST_NAME
WHERE ID = :P1_ID;
END;

行の削除を処理するには、ユーザーが「削除」ボタンをクリックしたときに実行される条件付きプロセスを作成します。次に例を示します。

BEGIN
DELETE FROM T
WHERE ID = :P1_ID;
END;

PL/SQL APIを使用したフォーム値の処理

アプリケーションによっては、表へのすべてのアクセスを単一または少数のPL/SQLパッケージにまとめて処理することが適しています。DML操作を処理するパッケージを作成した場合は、このパッケージのプロシージャおよびファンクションを、送信後のPL/SQLプロセスからコールして、リクエストの挿入、更新および削除を処理できます。

フォームの移入

Oracle Application Expressでは、ロード時またはApplication Expressエンジンによるページのレンダリング時にフォームが移入されます。フォームを移入するには、次のステップを実行します。

- プロセスを作成し、タイプを「行の自動フェッチ」に定義します。

- 非表示のセッション・ステート・アイテムを参照することによって、フォームを手動で移入します。

行の自動フェッチ・プロセスを作成するには、次のステップを実行します。

1. 該当するページ定義にナビゲートします。「ページ定義へのアクセス」を参照してください。

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

3. プロセス・タイプの「データ操作」を選択します。

4. プロセス・カテゴリの「行の自動フェッチ」を選択します。

5. 次のプロセス属性を指定します。

1. 「名前」フィールドで、プロセスを識別するための名前を入力します。

2. 「順序」フィールドで、順序番号を指定します。

3. 「ポイント」リストから、適切なプロセス・ポイントを選択します。

4. 「タイプ」リストから、「行の自動フェッチ」を選択します。

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

非表示のセッション・ステート・アイテムを参照することによって、フォームを手動で移入することもできます。たとえば、PL/SQLタイプのOracle Application Expressプロセスの次のコードでは、enameおよびsalの値が設定されます。この例では、P2_IDという名前の非表示のセッション・ステートを参照することによってフォームを手動で移入する方法も示します。

FOR C1 in (SELECT ename, sal
FROM emp WHERE ID=:P2_ID)
LOOP
:P2_ENAME := C1.ename;
:P2_SAL := C1.sal;
END LOOP;

この例では、次のとおりです。

- C1は、暗黙カーソルです。

- P2_IDの値は、設定済です。

- このプロセスのプロセス・ポイントは、「ロード時 - リージョンの前」またはこれ以前に実行するように設定されます。

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

検証を使用すると、ユーザーが入力したデータを処理前に確認できます。検証および関連するエラー・メッセージを作成したら、これらを特定のアイテムと関連付けることができます。検証エラー・メッセージをインライン表示(検証が実行されたページで表示)するか、個別のエラー・ページで表示するかを選択できます。

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

- 検証を作成し、エラー・メッセージ・テキストを指定します。

- 検証を特定のアイテムと関連付けます。

検証の作成

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

1. 該当するページ定義にナビゲートします。「ページ定義へのアクセス」を参照してください。

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

3. 「検証の作成」ウィザードが表示されたら、画面に表示されるステップに従います。
検証タイプは2つのカテゴリに分けられます。

- アイテム。これらの検証は、「アイテム」という語が先頭に付きます。検証と関連付けられたアイテムに対して一般的な確認を実行できます。

- コード。これらの検証では、検証ロジックを定義する1つのPL/SQLコードまたはSQL問合せを指定する必要があります。複数アイテムの値の確認または他のデータベース表へのアクセスが必要なカスタム検証を実行するには、このタイプの検証を使用します。

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

注意:
3,950文字を超える文字は検証できません。

検証と特定のアイテムとの関連付け

アイテムを検証と関連付け、エラー・メッセージ・テキストを指定するには、次のステップを実行します。

1. 該当するページ定義にナビゲートします。「ページ定義へのアクセス」を参照してください。

2. 「検証」で、関連付ける検証アイテムを選択します。
検証の属性ページが表示されます。

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

- 「エラー・メッセージ表示位置」で、表示位置を確認します。

- 「関連付けられたアイテム」で、この検証と関連付けるアイテムを選択します。

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

エラー・メッセージについて

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

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

カレンダの作成

アプリケーション・ビルダーには月次、週次および日次表示のカレンダを生成するための組込みウィザードが含まれています。カレンダのベースとなる表を一度指定すると、特定の列に格納された情報へのドリルダウン・リンクを作成できます。Oracle Application Expressがサポートするのは、1ページにつき1つのカレンダのみの作成なので注意してください。

この項に含まれる内容は次のとおりです。

- カレンダの作成

- 新しいカレンダの作成

- カレンダ・タイトルの編集

- カレンダ属性の編集

- SQLカレンダへの簡易カレンダの変換

- 以前のリリースで作成されたカレンダのアップグレード

カレンダの作成について

アプリケーション・ビルダーでは2つのカレンダ・タイプがサポートされています。

- 簡易カレンダ: 指定したスキーマ、表および列に基づくカレンダを作成します。ウィザードによって、日付列および表示列の選択を求めるプロンプトが表示されます。

- SQLカレンダ: 指定したSQL問合せに基づくカレンダを作成します。指定したSQL SELECT文には、少なくとも2つの列(日付列および表示列)が含まれている必要があります。

関連項目:
「カレンダ表示」

サポートされているカレンダ置換文字列

アプリケーション・ビルダーでは、多くの日付書式置換文字列がサポートされています。「カレンダ・テンプレート」ページで、サポートされている置換文字列の完全なリストを表示できます。

カレンダでサポートされている置換文字列のリストを表示するには、次のステップを実行します。

1. 該当するカレンダ・テンプレートにナビゲートします。

2. ページの右側の「置換文字列」リストを表示します。

関連項目:
「テーマの管理」

新しいカレンダの作成

カレンダの作成方法は、既存のページにカレンダを追加するか、新しいページにカレンダを追加するかによって異なります。カレンダを作成する際は、次の点に注意してください。

- 各ページに1つのカレンダのみ作成できます。カレンダは日次、週次および月次表示です。

- 日付列は、エントリが含まれるカレンダ上の日付を決定します。

- 表示列は、カレンダ日付を表示する特定の行を定義します。

この項に含まれる内容は次のとおりです。

- 既存ページへのカレンダの追加

- 新しいページへのカレンダの追加

ヒント:
Oracle Application Expressリリース3.1のカレンダの作成ウィザードには、新しい「表示タイプ」オプションが含まれています。「標準」では、ページが、関連するリクエストとともに送信されます。「部分ページ・リフレッシュ」では、「カレンダ」リージョンのみがリフレッシュされます。カレンダが作成されると、表示タイプは変更できません。表示タイプを変更するには、カレンダを削除してから、再作成する必要があります。

既存ページへのカレンダの追加

Oracle Application Expressは、1ページにつき1つのカレンダの作成をサポートします。

既存ページにカレンダを追加するには、次のステップを実行します。

1. ページ定義にナビゲートします。「ページ定義へのアクセス」を参照してください。

2. 「リージョン」で、「作成」アイコンをクリックします。
「リージョンの作成」ウィザードが表示されます。

3. 「カレンダ」を選択して、「次へ」をクリックします。

4. 作成するカレンダのタイプを選択し、「次へ」をクリックします。

- 簡易カレンダ: 指定した日付列および表示列に基づくカレンダを作成します。

- SQLカレンダ: 指定したSQL問合せに基づくカレンダを作成します。

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

新しいページへのカレンダの追加

新しいページでカレンダを作成するには、次のステップを実行します。

1. 「ワークスペース」ホームページにナビゲートします。

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

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

4. 「ページの作成」をクリックします。

5. 「カレンダ」を選択して、「次へ」をクリックします。

6. 作成するカレンダのタイプを選択し、「次へ」をクリックします。

- 簡易カレンダ: 指定した日付列および表示列に基づくカレンダを作成します。

- SQLカレンダ: 指定したSQL問合せに基づくカレンダを作成します。

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

関連項目:
「カレンダ属性の編集」

カレンダ・タイトルの編集

カレンダの上部に表示されるタイトルは、リージョン・タイトルに対応しています。

リージョン・タイトルを変更するには、次のステップを実行します。

1. ページ定義にナビゲートします。「ページ定義へのアクセス」を参照してください。

2. 「リージョン」で、リージョン名を選択します。
リージョン定義が表示されます。

3. 「指定」で、タイトルを入力します。

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

カレンダ属性の編集

作成したカレンダは、カレンダ属性ページで属性を編集することで表示を変更できます。

カレンダの表示を無効にする場合、カレンダ・ページで、「毎月」、「毎週」または「毎日」ボタンを削除する必要があることに注意してください。

この項に含まれる内容は次のとおりです。

- カレンダ属性ページへのアクセス

- カレンダ属性ページについて

カレンダ属性ページへのアクセス

カレンダ属性ページにアクセスするには、次のステップを実行します。

1. 該当するページ定義にナビゲートします。「ページ定義へのアクセス」を参照してください。

2. 「リージョン」で、リージョン名の横にある「カレンダ」をクリックします。
カレンダ属性ページが表示されます。

3. 対象となる属性を編集します。ページ上の特定のアイテムの詳細を表示するには、アイテム・ラベルをクリックします。
ヘルプが利用できる場合は、アイテム・ラベル上にカーソルを重ねると、アイテム・ラベルが赤色に変わり、カーソルが矢印と疑問符に変わります。

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

関連項目:
「カレンダ属性ページについて」および「フィールドレベル・ヘルプについて」

ナビゲーションの選択肢について

カレンダ属性ページはセクションに分かれています。

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

カレンダ属性ページ

次のトピックではカレンダ属性ページの各セクションを説明します。これらの属性を使用することで一般的なカレンダ書式設定の指定、カレンダに含まれる日付の定義、もしくはカレンダの列または日付へのリンクの作成を実行できます。

カレンダ表示

「カレンダ表示」を使用して、カレンダ・テンプレート、日付列および一般的なカレンダ書式設定を指定できます。

「カレンダ・テンプレート」は、Application Expressエンジンがカレンダをレンダリングするときに使用するテンプレートを規定します。「日付列」は、カレンダに配置する日付が含まれる、表または問合せの列を定義します。「日付アイテム」は、カレンダの基になる日付を保持しているアイテムを定義します。「カレンダ・タイプ列」は、カレンダ・タイプを保持しているアイテムを指定します。「表示タイプ」は、表示タイプを定義します。オプションには、「列」、「カスタム」および「表示値なし」があります。「表示列」は、カレンダ日付に表示する特定の行を定義します。「表示タイプ」が「列」に設定されている場合は、「表示列」を使用して、月次カレンダの日付セルに表示する列を選択します。

別の表示列を選択するには、次のステップを実行します。

1. 該当するカレンダ属性ページにナビゲートします。

2. 「カレンダ表示」セクションに移動します。

3. 別の表示列を指定するには、「表示列」リストから選択します。

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

カスタム表示列を指定するには、次のステップを実行します。

1. 該当するカレンダ属性ページにナビゲートします。

2. 「カレンダ表示」セクションに移動します。

3. 「表示タイプ」で、「カスタム」を選択します。

4. 「列の書式」で、カスタム列の書式を入力します。HTML式およびサポートされている置換文字列を使用できます。

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

関連項目:
「サポートされているカレンダ置換文字列」

表示属性

「表示属性」を使用して、カレンダに含める日付を定義します。

「間隔の最初から開始」は、カレンダの開始時期を決定します。このオプションを選択すると、期間全体(たとえば、1か月間)のカレンダが作成されます。次に例を示します。

- 「間隔の最初から開始」を選択した場合、6月15日に月次カレンダを表示すると、6月1日から6月30日のカレンダが作成されます。

- 「間隔の最初から開始」を選択しなかった場合、6月15日に月次カレンダを表示すると、6月15日から6月30日のカレンダが作成されます。

次の2つの属性は、カレンダの開始日と終了日を保持するアイテムを定義します。これらの属性を使用して、一度に複数月にまたがるカレンダを作成できます。どちらのアイテムも日付の書式はYYYYMMDDになることに注意してください。

- 「開始日を含むアイテム」は、カレンダの開始日のあるアイテムを指します。

- 「終了日を含むアイテム」は、カレンダの終了日のあるアイテムを指します。

「月次カレンダの週の開始」は、月次表示のカレンダの開始日を決定します。

「週次カレンダの開始日」は、週次表示のカレンダの開始日を決定します。

「週次カレンダの終了日」は、週次表示のカレンダの終了日を決定します。

「時間書式」は、時間表示を12時間表示と24時間表示のどちらにするかを決定します。

「開始時間」および「終了時間」は、週次表示カレンダおよび日次表示カレンダの開始時間および終了時間を決定します。

列リンク

「列リンク」を使用して、カレンダの列にリンクを作成します。

別のページへの列リンクを作成するには、次のステップを実行します。

1. 該当するカレンダ属性ページにナビゲートします。

2. 「列リンク」までスクロールします。

3. 「ターゲット」から、「このアプリケーションのページ」を選択します。

4. 「ページ」で、ターゲット・ページ番号を指定します。このページのページ区切りをリセットするには、「このページのページ区切りをリセット」を選択します。

5. 「リクエスト」で、使用するリクエストを指定します。

6. 「キャッシュのクリア」で、キャッシュをクリアするページ(ページ番号)を指定します。ページ番号をカンマで区切ってリストすることによって、複数のページを指定します。
「次のアイテムを設定」と「次の値を使用」という2つの属性を使用して、セッション・ステートの設定(リストしたアイテムへの値の指定)を行うことができます。

7. セッション・ステートを設定するには、次のステップを実行します。

1. 「次のアイテムを設定」で、セッション・ステートを設定するアイテム名をカンマで区切って入力します。

2. 「次の値を使用」で、前述のステップで指定したアイテムの値をカンマで区切って入力します。
静的な値または置換構文(&APP_ITEM_NAME.など)を指定できます。URLのf?p=に渡されるアイテム値にコロン(:)は使用できないことに注意してください。また、バックスラッシュでアイテム値全体を囲んだ場合(\1234,56\など)を除いて、カンマも使用しないでください。

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

関連項目:
「サポートされているカレンダ置換文字列」

URLへの列リンクを作成するには、次のステップを実行します。

1. 該当するカレンダ属性ページにナビゲートします。

2. 「列リンク」までスクロールします。

3. 「ターゲット」から、「URL」を選択します。

4. 「URL」で、該当するアドレスを入力します。

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

日付のリンク

「日付リンク」を使用して、カレンダの日付にリンクを作成します。この属性によって、カレンダの実際の数字(日付)にリンクが作成されます。

別のページへの日付リンクを作成するには、次のステップを実行します。

1. 該当するカレンダ属性ページにナビゲートします。

2. 「日付のリンク」までスクロールします。

3. 「ターゲット」から、「このアプリケーションのページ」を選択します。

4. 「ページ」で、ターゲット・ページ番号を指定します。
このページのページ区切りをリセットするには、「このページのページ区切りをリセット」を選択します。

5. 「リクエスト」で、使用するリクエストを指定します。

6. 「キャッシュのクリア」で、キャッシュをクリアするページ(ページ番号)を指定します。ページ番号をカンマで区切ってリストすることによって、複数のページを指定します。
「次のアイテムを設定」と「次の値を使用」という2つの属性を使用して、セッション・ステートの設定(リストしたアイテムへの値の指定)を行うことができます。

7. セッション・ステートを設定するには、次のステップを実行します。

1. 「次のアイテムを設定」で、セッション・ステートを設定するアイテム名をカンマで区切って入力します。

2. 「次の値を使用」で、前述のステップで指定したアイテムの値をカンマで区切って入力します。
静的な値または置換構文(&APP_ITEM_NAME.など)を指定できます。URLのf?p=に渡されるアイテム値にコロン(:)は使用できないことに注意してください。また、バックスラッシュでアイテム値全体を囲んだ場合(\1234,56\など)を除いて、カンマも使用しないでください。

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

URLへの日付リンクを作成するには、次のステップを実行します。

1. 該当するカレンダ属性ページにナビゲートします。

2. 「日付のリンク」までスクロールします。

3. 「ターゲット」から、「URL」を選択します。

4. 「URL」で、該当するアドレスを入力します。

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

以前のリリースで作成されたカレンダのアップグレード

デフォルトでは、Oracle Application Express 3.0で作成したカレンダは、日次、週次および月次表示になります。以前のリリースで作成したカレンダを更新してこれらの表示を含めた場合、次のことができます。

- 次のようにして、カレンダを作成します。

1. カレンダのページを作成して、以前のカレンダからSQL問合せを統合します。

2. アプリケーションで、以前のカレンダのページを新しいページと置換します。

- 次のようにして、テーマをアップグレードします。

1. 既存のテーマの識別番号の変更。「テーマ識別番号の変更」を参照してください。

2. テーマの再作成。「テーマの作成」を参照してください。

3. アプリケーションに新しいテーマの適用。「アクティブなテーマの切替え」を参照してください。

SQLカレンダへの簡易カレンダの変換

カレンダを作成するには、簡易カレンダを作成することが最も簡単な方法です。ただし、結果として作成された簡易カレンダが要件を満たさない場合は、そのカレンダをSQLカレンダに変換することができます。

簡易カレンダをSQLカレンダに変換するには、次のステップを実行します。

1. ページ定義にナビゲートします。「ページ定義へのアクセス」を参照してください。

2. 「リージョン」で、リージョン名の横にある「カレンダ」をクリックします。
カレンダ属性ページが表示されます。

3. 「タスク」リストで「SQLベースのカレンダに変換」をクリックします。
簡易カレンダがSQLカレンダに変換されると、「リージョン定義」に「リージョン・ソース」セクションが追加されます。「リージョン・ソース」には、カレンダを作成するSQL問合せが含まれます。「リージョン・ソース」へアクセスすることで、要件にあわせて問合せを編集できます。

チャートの作成

アプリケーション・ビルダーには、HTML、Scalable Vector Graphics (SVG)およびFlashチャートを生成する組込みウィザードがあります。Oracle Application Expressは、この3つのグラフィカル・チャートのみサポートします。

この項に含まれる内容は次のとおりです。

- サポートするチャート・タイプの概要

- チャートのSQL問合せの作成について

- HTMLチャートの作成

- SVGチャートの作成

- Flashチャートの作成

- チャート属性の編集

- 非同期更新の有効化

- 他の言語でのSVGチャートの表示

チュートリアルを参照:
Oracle Application Expressアドバンスト・チュートリアルの「積上げ棒グラフの作成方法」

サポートするチャート・タイプの概要

Oracle Application Expressでは、HTML、Scalable Vector Graphics (SVG)、およびFlashの3種類グラフィカル・チャートをサポートしています。

Flashチャートについて

Oracle Application ExpressのFlashチャートのサポートは、Anychart Flashチャート・コンポーネントをベースにしています。開発者は、Macromedia FlashベースのフレキシブルなソリューションであるAnychartを使用して、動きがありコンパクトでインタラクティブなFlashチャートを作成できます。Flashチャートはブラウザでレンダリングされ、使用するにはFlash Player 8以上が必要です。対話モード・レポートで使用されるFlashチャートでは、Flash Playerバージョン9以上が必要です。Anychartの詳細については、次のURLを参照してください。

http://www.anychart.com

SVGプラグインのサポートの概要

SVGは、World Wide Web Consortium (W3C)が策定したXMLベースのWebグラフィックス用言語です。SVGチャートは埋込みタグで定義されます。SVGチャートがアプリケーションに適切なチャート・タイプかどうかを判断する際は、次の点に注意してください。

- 一部のWebブラウザは、SVGチャートをサポートしていません。

- SVGチャートをサポートするWebブラウザでは、ほとんどの場合、SVGプラグインをダウンロードする必要があります。

Adobe SVGプラグインは、UTF-8、UTF-16、ISO-8859-1およびUS-ASCIIでエンコードされたデータを処理できます。SVGチャートのエンコードは、データベース・アクセス記述子(DAD)データベース・キャラクタ・セットによって決定されます。DADキャラクタ・セットがUTF8、AL32UTF8、AL16UTF16、WE8ISO8859P1またはUS7ASCII以外の場合、SVGチャートはAdobe SVGプラグインで適切にレンダリングされない場合があります。

関連項目:
「SVGチャートの作成」および「SVGチャートのFlashへの移行について」

チャートのSQL問合せの作成について

アプリケーション・ビルダーでチャートを定義するには、ウィザードを使用します。ほとんどのチャート・ウィザードでは、チャート・タイプを選択し、次の構文を使用してSQL問合せを指定します。

SELECT link, label, value
FROM   ...

説明:

- linkはURLです。

- labelはバー内に表示されるテキストです。

- valueはバーのサイズを定義する数値列です。

次に例を示します。

SELECT null, last_name, salary
FROM   employees
WHERE  DEPARTMENT_ID = :P101_DEPARTMENT_ID

注意:
既存のチャートのタイプは変更しないでください。かわりに、既存のチャートを削除して再作成してください。

ダイアル・チャート構文

ダイアル・チャートを作成するには、ダイアル・チャート・タイプを選択し、次の構文を使用してSQL問合せを指定します。

SELECT value , maximum_value [ ,low_value [ ,high_value] ]
FROM   ...

説明:

- valueは、ダイアルの開始位置です。

- maximum_valueは、ダイアルでの推定最高位置です。

- low_valueおよびhigh_valueは、実績での低い値および高い値です。

次に例を示します。

SELECT dbms_random.value(500, 1200), 1300, dbms_random.value(100, 200)
FROM DUAL

複数シリーズの構文(Flashのみ)

列チャートおよび行のFlashチャートには、1つのSQL問合せで複数シリーズを定義できます。これらのチャート・タイプのシリーズ名は、問合せ内の関連する列別名から導出されます。複数シリーズのFlashチャートを定義するには、次の構文を使用します。

SELECT link, label, series_1_value [, series_2_value [, ...]]
FROM   ...

レンジ・チャート構文(Flashのみ)

レンジ・チャートは、各バーに2つの値が必要です。レンジ・チャートを作成するには、Flashチャートを作成し、次の構文を使用してSQL問合せを提供します。

SELECT link, label, low_value, high_value
FROM   ...

スキャッタ・チャート構文(Flashのみ)

スキャッタ・チャートは、各ポイントにx値およびy値が必要です。レンジ・チャートを作成するには、Flashチャートを作成し、次の構文を使用してSQL問合せを提供します。

SELECT link, label, x_value, y_value
FROM   ...

ローソク足チャート構文(Flashのみ)

ローソク足チャートには、各ローソク足に始値、安値、高値および終値が必要です。ローソク足チャートを作成するには、Flashチャートを作成し、次の構文を使用してSQL問合せを指定します。

SELECT link, label, open, low, high, close
FROM   ...

HTMLチャートの作成

チャートの作成方法は、既存のページにチャートを追加するか、ページにチャートを追加するかによって異なります。このチャート・タイプは、棒で示された各データ・ポイントを持つデータ・シリーズが表示される棒グラフを作成します。

この項に含まれる内容は次のとおりです。

- 既存ページへのHTMLチャートの追加

- 新しいページへのHTMLチャートの追加

既存ページへのHTMLチャートの追加

既存ページにHTMLチャートを追加するには、次のステップを実行します。

1. ページ定義にナビゲートします。「ページ定義へのアクセス」を参照してください。

2. 「リージョン」で、「作成」アイコンをクリックします。
「リージョンの作成」ウィザードが表示されます。

3. 「チャート」を選択して、「次へ」をクリックします。

4. 「リージョン」で、「HTMLチャート」を選択して「次へ」をクリックします。

5. 「表示属性」で、次のステップを実行します。

1. 次の項目を指定します。

- タイトル

- リージョン・テンプレート

- 表示ポイント

- 順序

- 列

詳細を表示するには、アイテム・ラベルをクリックします。ヘルプが利用できる場合は、アイテム・ラベル上にカーソルを重ねると、アイテム・ラベルが赤色に変わり、カーソルが矢印と疑問符に変わります。「フィールドレベル・ヘルプについて」を参照してください。

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

6. 「ソース」で、次のステップを実行します。

1. 問合せは次のいずれかの方法で指定します。

- 表示されているフィールドにSQL問合せを入力します。「チャートのSQL問合せの作成について」を参照してください。

- 「問合せの作成」ボタンをクリックします。ビルド・チャート問合せウィザードが表示されたら、画面に表示されるステップに従います。

2. 関連するチャート属性を指定します。詳細を表示するには、アイテム・ラベルをクリックします。

7. 「リージョンの作成」をクリックします。

新しいページへのHTMLチャートの追加

新しいページでHTMLチャートを作成するには、次のステップを実行します。

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

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

3. 「ページの作成」をクリックします。

4. 「チャート」を選択して、「次へ」をクリックします。

5. 「リージョン」で、「HTMLチャート」を選択して「次へ」をクリックします。

6. 「ページ属性」で、次のステップを実行します。

1. 次の項目を指定します。

- ページ番号

- ページ名

- リージョン・テンプレート

- リージョンの列

- ブレッドクラム

詳細を表示するには、アイテム・ラベルをクリックします。ヘルプが利用できる場合は、アイテム・ラベル上にカーソルを重ねると、アイテム・ラベルが赤色に変わり、カーソルが矢印と疑問符に変わります。「フィールドレベル・ヘルプについて」を参照してください。

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

7. タブを含めるかどうかを指定して、「次へ」をクリックします。

8. 「チャート定義」で、次のステップを実行します。

1. 問合せは次のいずれかの方法で指定します。

- 表示されているフィールドにSQL問合せを入力します。「チャートのSQL問合せの作成について」を参照してください。

- 「問合せの作成」ボタンをクリックします。ビルド・チャート問合せウィザードが表示されたら、画面に表示されるステップに従います。

2. 関連するチャート属性を指定します。詳細を表示するには、アイテム・ラベルをクリックします。

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

9. 「終了」をクリックします。

SVGチャートの作成

Oracle Application Expressでは、様々なSVGチャートをサポートしています。完全なリストを確認するには、「SVGチャート・タイプについて」を参照してください。

チャートの作成方法は、既存のページにチャートを追加するか、新しいページにチャートを追加するかによって異なります。このチャート・タイプは、棒で示された各データ・ポイントを持つデータ・シリーズが表示される棒グラフを作成します。

この項に含まれる内容は次のとおりです。

- 既存ページへのSVGチャートの追加

- 新しいページへのSVGチャートの追加

- SVGチャート・タイプの概要

- SVGチャート・カスケード・スタイルシート・クラスの理解

- カスタムSVGチャート・カスケード・スタイルシートの参照

- SVGチャートのカスタムCSSスタイル・インラインの指定

関連項目:
「SVGプラグインのサポートの概要」および「SVGチャートのFlashへの移行の概要」

既存ページへのSVGチャートの追加

既存ページにSVGチャートを追加するには、次のステップを実行します。

1. ページ定義にナビゲートします。「ページ定義へのアクセス」を参照してください。

2. 「リージョン」で、「作成」アイコンをクリックします。
「リージョンの作成」ウィザードが表示されます。

3. 「チャート」を選択して、「次へ」をクリックします。

4. 「リージョン」で「SVGチャート」を選択します。

5. 「リージョン」でチャート・タイプを選択し、「次へ」をクリックします。「SVGチャート・タイプについて」を参照してください。

6. 「表示属性」で、次のステップを実行します。

1. 次の項目を指定します。

- タイトル

- リージョン・テンプレート

- 表示ポイント

- 順序

- 列

詳細を表示するには、アイテム・ラベルをクリックします。ヘルプが利用できる場合は、アイテム・ラベル上にカーソルを重ねると、アイテム・ラベルが赤色に変わり、カーソルが矢印と疑問符に変わります。「フィールドレベル・ヘルプについて」を参照してください。

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

7. 「ソース」で、次のステップを実行します。

1. 問合せは次のいずれかの方法で指定します。

- 表示されているフィールドにSQL問合せを入力します。「チャートのSQL問合せの作成について」を参照してください。

- 「問合せの作成」ボタンをクリックします。ビルド・チャート問合せウィザードが表示されたら、画面に表示されるステップに従います。

2. 関連するチャート属性を指定します。詳細を表示するには、アイテム・ラベルをクリックします。

8. 「リージョンの作成」をクリックします。

新しいページへのSVGチャートの追加

新しいページにSVGチャートを追加するには、次のステップを実行します。

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

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

3. 「ページの作成」をクリックします。

4. 「チャート」を選択して、「次へ」をクリックします。

5. 「SVGチャート」を選択します。

6. チャート・タイプを選択し、「次へ」をクリックします。「SVGチャート・タイプについて」を参照してください。

7. 「ページ属性」で、次のステップを実行します。

1. 次の項目を指定します。

- ページ番号

- ページ名

- リージョン・テンプレート

- リージョン名

- チャートのカラー・テーマ

- ブレッドクラム

詳細を表示するには、アイテム・ラベルをクリックします。ヘルプが利用できる場合は、アイテム・ラベル上にカーソルを重ねると、アイテム・ラベルが赤色に変わり、カーソルが矢印と疑問符に変わります。「フィールドレベル・ヘルプについて」を参照してください。

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

8. タブを含めるかどうかを指定して、「次へ」をクリックします。

9. 「問合せ」で、次のステップを実行します。

1. 問合せは次のいずれかの方法で指定します。

- 表示されているフィールドにSQL問合せを入力します。「チャートのSQL問合せの作成について」を参照してください。

- 「問合せの作成」ボタンをクリックします。ビルド・チャート問合せウィザードが表示されたら、画面に表示されるステップに従います。

2. 残りの属性を指定します。詳細を表示するには、アイテム・ラベルをクリックします。

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

10. 「終了」をクリックします。

SVGチャート・タイプについて

表 7-7に、アプリケーション・ビルダーで使用可能なSVGチャート・タイプを示します。

表 7-7 使用可能なSVGチャート・タイプ

Chart Type

説明

棒(横)

シリーズ内の各データ・ポイントが横棒で表される単一シリーズ・ベースの横棒グラフです。

SVGベースです。SVGプラグインが必要です。

棒(縦)

シリーズ内の各データ・ポイントが縦棒で表される単一シリーズ・ベースの縦棒グラフです。

SVGベースです。SVGプラグインが必要です。

集合棒(横)

各データ・ポイントが横棒で表され、共通変数で集計される複数シリーズ・ベースの横棒グラフです(月ごとに集計される部門販売合計など)。

SVGベースです。SVGプラグインが必要です。

集合棒(縦)

シリーズ内の各データ・ポイントが縦棒で表され、共通変数で集計される複数シリーズ・ベースの縦棒グラフです(月ごとに集計される部門販売合計など)。

SVGベースです。SVGプラグインが必要です。

ダイアル - スイープ

角度ゲージとも呼ばれます。このチャートには、最大値の割合または立体領域として表される最大値と比較した絶対値のいずれかを示します。

SVGベースです。SVGプラグインが必要です。

ダイアル

角度ゲージとも呼ばれます。このチャートには、最大値の割合または折れ線で表される最大値と比較した絶対値のいずれかを示します。

SVGベースです。SVGプラグインが必要です。

Line

各折れ線がシリーズ内のすべてのデータ・ポイントを表す複数シリーズ・ベースの折れ線グラフです。

SVGベースです。SVGプラグインが必要です。

Pie

各区分がシリーズ内の1つのデータ・ポイントを表す単一シリーズ・ベースの円グラフです。

SVGベースです。SVGプラグインが必要です。

積上げ棒(横)

シリーズ内の各データ・ポイントが絶対値で、その値が1つの棒の1区分を表す複数シリーズ・ベースの横棒グラフです。

SVGベースです。SVGプラグインが必要です。

積上げ棒(縦)

シリーズ内の各データ・ポイントが絶対値で、その値が1つの棒の1区分を表す複数シリーズ・ベースの縦棒グラフです。

SVGベースです。SVGプラグインが必要です。

割合積上げ棒(横)

各データ・ポイントがシリーズ内での割合(%)を示し、その割合が1つの棒の1区分を表す複数シリーズ・ベースの横棒グラフです。

SVGベースです。SVGプラグインが必要です。

割合積上げ棒(縦)

各データ・ポイントがシリーズ内での割合(%)を示し、その割合が1つの棒の1区分を表す複数シリーズ・ベースの縦棒グラフです。

SVGベースです。SVGプラグインが必要です。

SVGチャート・カスケード・スタイルシート・クラスの理解

新しいチャートを作成すると、そのチャートは、現行のテーマに関連付けられたカスケード・スタイルシート(CSS)のクラスに基づいてOracle Application Expressによってレンダリングされます。別のCSSを参照するか、または属性の編集ページのCSSセクションで個々のクラスを上書きして、チャートの外観を変更できます。

次に、サンプル・アプリケーションのダイアル・チャートのCSSクラスの例を示します。この例には、使用可能なすべてのCSSクラスが示されています。クラス名は太字で表示されています。

text{font-family:Verdana, Geneva, Arial, Helvetica, sans-serif;fill:#000000;}
tspan{font-family:Verdana, Geneva, Arial, Helvetica, sans-serif;fill:#000000;}
text.title{font-weight:bold;font-size:14;fill:#000000;}
text.moredatafound{font-size:12;}
rect.legend{fill:#EEEEEE;stroke:#000000;stroke-width:1;}
text.legend{font-size:10;}
#background{fill:#FFFFFF;stroke:none;}
rect.chartholderbackground{fill:#ffffff;stroke:#000000;stroke-width:1;}
#timestamp{text-anchor:start;font-size:9;}
text.tic{stroke:none;fill:#000000;font-size:12}
line.tic{stroke:#000000;stroke-width:1px;fill:none;}
#dial{stroke:#336699;stroke-width:2px;fill:#336699;fill-opacity:.5;}
#dial.alert{fill:#FF0000;fill-opacity:.5;}
#dialbackground{stroke:#000000;stroke-width:none;fill:none;filter:url(#MyFilter);}
#dialcenter{stroke:none;fill:#111111;filter:url(#MyFilter);}
#dialbackground-border{stroke:#DDDDDD;stroke-width:2px;fill:none;filter:url
(#MyFilter);}#low{stroke-width:3;stroke:#336699;}
#high{stroke-width:3;stroke:#FF0000;}
#XAxisTitle{letter-spacing:2;kerning:auto;font-size:14;fill:#000000;text-anchor:middle;}
#YAxisTitle{letter-spacing:2;kerning:auto;font-size:14;fill:#000000;text-anchor:middle;writing-mode:tb;}
.XAxisValue{font-size:8;fill:#000000;}
.YAxisValue{font-size:8;fill:#000000;text-anchor:end;}
.nodatafound{stroke:#000000;stroke-width:1;font-size:12;}
.AxisLine{stroke:#000000;stroke-width:2;fill:#FFFFFF;}
.GridLine{stroke:#000000;stroke-width:0.3;stroke-dasharray:2,4;fill:none;}
g.dataholder rect{stroke:#000000;stroke-width:0.5;}
.legenditem rect{stroke:#000000;stroke-width:0.5;}

表7-8に、サポートされているすべてのCSSクラスを示します。一部のクラスは、特定のチャート・タイプにのみ適用されます。

表 7-8 使用可能なSVGチャートCSSクラス

クラス

説明

text

チャートに表示されるテキストの外観を定義します。

tspan

チャートに表示されるテキストの外観を定義します。tspanはtextの定義と一致する必要があります。

text.title

デフォルトのチャート・テキストを上書きします。このクラスは、タイトル・テキストに使用します。

text.moredatafound

より多くのデータが検出されたテキストの外観を定義します。

rect.legend

チャート凡例を保持する矩形ボックスを作成します。

凡例の枠線を削除するには、rect.legendを次のように変更します。

rect.legend{fill:#CCCC99;stroke:none;}

text.legend

チャート凡例に表示されるテキストを定義します。

#background

SVGプラグイン用のバックグラウンド全体を作成します。

枠線なしの単色の立体バックグラウンドを作成するには、#backgroundを次のように変更します。

#background{fill:#FFFFFF;stroke:#FFFFFF;stroke-width:2;}

rect.chartholderbackground

円グラフおよびダイアル・チャートには適用されません。チャート・データを保持する矩形のバックグラウンドを作成します。

バックグラウンドに何も表示しない場合は、rect.chartholderbackgroundを次のように変更します。

rect.chartholderbackground(display:none;)

#timestamp

「非同期更新」チャート属性が「はい」に設定されている場合にのみ適用されます。更新タイムスタンプ・テストの外観を制御します。

タイムスタンプの表示を無効にするには、「カスタムCSS、インライン」属性で#timestampを次のように定義します。

"#timestamp{display:none;}"

関連項目: 「非同期更新の有効化」

text.tic

ダイアル・チャート専用。ダイアル・チャートの数値を定義します。

line.tic

ダイアル・チャート専用。ダイアル・チャートの数値の直下に表示される目盛り線を定義します。

#dial

ダイアル・チャート専用。ダイアル・チャートに表示される値を定義します。

#dial.alert

ダイアル・チャート専用。別の表示画面を使用してダイアル・チャートにレンダリングされる値(アラート値)を定義します。

#dialbackground

ダイアル・チャート専用。ダイアル・チャートのバックグラウンドを作成します。

#dialcenter

ダイアル・チャート専用。ダイアル・チャートにダイアルの中心を作成します。

#dialbackground-border

ダイアル・チャート専用。#dialbackgroundと連動して特定のグラフィック効果を作成します。

#low

ダイアル・チャート専用。チャートに表示されているデータの履歴上の最低水位標を定義します。

#high

ダイアル・チャート専用。チャートに表示されているデータの履歴上の最高水位標を定義します。

#XAxisTitle

X軸に表示されるタイトルを定義します。

#YAxisTitle

Y軸に表示されるタイトルを定義します。

.XAxisValue

X軸に表示される値を定義します。

.YAxisValue

Y軸に表示される値を定義します。

.AxisLabel

軸値に類似しています。

.nodatafound

情報を参照できない場合に表示されるテキスト要素を定義します。

.AxisLine

負の値を含むチャートの0(ゼロ)を示します。

.GridLine

チャートの横線および縦線を作成します。

g.dataholder rect

チャートに表示されるすべてのデータに一律のスタイルを適用します。

.legenditem rect

凡例内のすべての矩形アイテムに一律のスタイルを適用します。

カスタムSVGチャート・カスケード・スタイルシートの参照

「チャート属性」ページの「CSS」セクションを使用して、チャート用のカスタム・カスケード・スタイルシートを参照できます。外部CSSを参照する場合は、全体を参照するか、または特定のスタイルを上書きできます。

カスタム・チャートCSSを参照するには、次のステップを実行します。

1. CSSをアプリケーション・ビルダーにアップロードします。詳細は、「カスケード・スタイルシートのアップロード」を参照してください。

2. チャートを作成します。「SVGチャートの作成」を参照してください。

3. ページ定義にナビゲートします。「ページ定義へのアクセス」を参照してください。

4. 「リージョン」で、リージョン名の横にある「チャート」をクリックします。
チャート属性ページが表示されます。

5. 「CSS」セクションまでスクロールします。

6. 「カスタムCSSを使用」で、「はい」を選択します。

7. 外部CSSを排他的に参照するには、次のステップを実行します。

1. 「カスタムCSS (リンク)」で、カスタムCSSへのリンクを入力します。次に例を示します。

#IMAGE_PREFIX#themes/theme_4/svg.css

2. CSSが排他的に使用されるように指定します。「カスタムCSS、インライン」で、次のように入力します。

/**/

8. カスタムCSSを参照し、特定のスタイルを上書きするには、次のステップを実行します。

1. 「カスタムCSS (リンク)」で、カスタム・スタイルシートへのリンクを入力します。次に例を示します。

#IMAGE_PREFIX#themes/theme_4/svg.css

2. 「カスタムCSS、インライン」で、上書きするカスタムCSSスタイルを入力します。

SVGチャートのカスタムCSSスタイル・インラインの指定

「チャート属性」ページの「カスタムCSS、インライン」属性を使用して、デフォルトCSS内の特定のスタイルを上書きできます。

デフォルトのCSS内の特定のスタイルを上書きするには、次のステップを実行します。

1. チャートを作成します。「SVGチャートの作成」を参照してください。

2. ページ定義にナビゲートします。「ページ定義へのアクセス」を参照してください。

3. 「リージョン」で、リージョン名の横にある「チャート」をクリックします。
チャート属性ページが表示されます。

4. 「CSS」までスクロールします。

5. 「カスタムCSSを使用」で、「はい」を選択します。

6. 「カスタムCSS、インライン」で、上書きするカスタムCSSスタイルを入力します。

Flashチャートの作成

Flashチャートの作成方法は、既存のページにチャートを追加するか、新しいページにチャートを追加するかによって異なります。

ヒント:
Flashチャートを表示するには、Flash Playerバージョン8以上をインストールする必要があります。対話モード・レポートで使用されるFlashチャートでは、Flash Playerバージョン9以上が必要です。

この項に含まれる内容は次のとおりです。

- 既存ページへのFlashチャートの追加

- 新しいページへのFlashチャートの追加

- SVGチャートのFlashへの移行

- アプリケーション内のすべてのSVGチャートのFlashへの移行

関連項目:
「Flashチャートについて」および「SVGチャートのFlashへの移行について」を参照してください。

既存ページへのFlashチャートの追加

既存ページにFlashチャートを追加するには、次のステップを実行します。

1. ページ定義にナビゲートします。「ページ定義へのアクセス」を参照してください。

2. 「リージョン」で、「作成」アイコンをクリックします。
「リージョンの作成」ウィザードが表示されます。

3. 「チャート」を選択して、「次へ」をクリックします。

4. 「リージョン」で、「Flashチャート」を選択します。

5. 「表示属性」で、次のステップを実行します。

1. 次の項目を指定します。

- タイトル

- リージョン・テンプレート

- 表示ポイント

- 順序

- 列

詳細を表示するには、アイテム・ラベルをクリックします。ヘルプが利用できる場合は、アイテム・ラベル上にカーソルを重ねると、アイテム・ラベルが赤色に変わり、カーソルが矢印と疑問符に変わります。「フィールドレベル・ヘルプについて」を参照してください。

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

6. 「チャート・プレビュー」で、チャート属性を構成します。「更新」をクリックすると、プレビューのイメージがリフレッシュされます。

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

8. 「ソース」で、次のステップを実行します。

1. 問合せは次のいずれかの方法で指定します。

- 表示されているフィールドにSQL問合せを入力します。「チャートのSQL問合せの作成について」を参照してください。

- 「問合せの作成」ボタンをクリックします。ビルド・チャート問合せウィザードが表示されたら、画面に表示されるステップに従います。

2. 関連するチャート属性を指定します。詳細を表示するには、アイテム・ラベルをクリックします。

9. 「リージョンの作成」をクリックします。

新しいページへのFlashチャートの追加

新しいページでFlashチャートを作成するには、次のステップを実行します。

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

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

3. 「ページの作成」をクリックします。

4. 「チャート」を選択して、「次へ」をクリックします。

5. 「Flashチャート」を選択します。

6. 「ページ属性」で、次のステップを実行します。

1. 次の項目を指定します。

- ページ番号

- ページ名

- リージョン・テンプレート

- リージョン名

- ブレッドクラム

詳細を表示するには、アイテム・ラベルをクリックします。ヘルプが利用できる場合は、アイテム・ラベル上にカーソルを重ねると、アイテム・ラベルが赤色に変わり、カーソルが矢印と疑問符に変わります。「フィールドレベル・ヘルプについて」を参照してください。

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

7. タブを含めるかどうかを指定して、「次へ」をクリックします。

8. 「チャート・プレビュー」で、チャート属性を構成します。「更新」をクリックすると、プレビューのイメージがリフレッシュされます。

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

10. 「問合せ」で、次のステップを実行します。

1. 問合せは次のいずれかの方法で指定します。

- 表示されているフィールドにSQL問合せを入力します。「チャートのSQL問合せの作成について」を参照してください。

- 「問合せの作成」ボタンをクリックします。ビルド・チャート問合せウィザードが表示されたら、画面に表示されるステップに従います。

2. 残りの属性を指定します。詳細を表示するには、アイテム・ラベルをクリックします。

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

11. 「終了」をクリックします。

SVGチャートのFlashへの移行の概要

単一または複数のSVGチャートを自動的にフラッシュへ移行できます。

SVGチャートの移行制限について

SVGチャートを移行するには、次の制限に注意してください。

- 軸の書式文字列で定義された数値書式のみが移行されます。日付書式および時間書式は無視されます。

- 次の項目を含む数値書式の要素が移行されます。

0,9,D,G,, (comma),. (period),$,C,L,FM

- Flashチャートの各シリーズのラベルは、各シリーズの列の別名から導出されます。これは各シリーズのラベルが「シリーズ名」属性から導出されるSVGチャートによって異なります。

- Flashダイアル・チャートには、割合ではなく実際の値が表示されます。

- SVGチャートでは、最初のシリーズのラベルがX軸に使用されます。Flashチャートでは、最初のシリーズでデータのラベルが発生していなくても、すべてのデータが表示されるように拡張されています。

SVGチャートのFlashへの移行

SVGチャートをFlashへ移行するには、次のステップを実行します。

1. ページ定義にナビゲートします。「ページ定義へのアクセス」を参照してください。

2. 「リージョン」で、リージョン名をクリックします。SVGチャートの左側にリージョン名が表示されます。
リージョン定義が表示されます。

3. 「タスク」リストで、「SVGチャートのFlashチャートへの移行」をクリックします。

4. 「移行」をクリックします。

アプリケーション内のすべてのSVGチャートのFlashへの移行

すべてのSVGチャートをFlashチャートに移行するには、次のステップを実行します。

1. 「ワークスペース」ホームページにナビゲートします。

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

3. アプリケーションを選択します。
アプリケーションのホームページが表示されます。

4. 「タスク」リストで、「アプリケーション・レポート」をクリックします。

5. 「ページ・コンポーネント」をクリックします。

6. 「リージョン」で、「SVGチャートのFlashチャートへの移行」をクリックします。
SVGチャートのFlashチャートへの移行のページが表示されます。

7. 特定のチャートを移行するには、移行するチャートを選択して、「チェックした項目の移行」をクリックします。

8. すべてのチャートを移行するには、「すべて移行」をクリックします。

チャート属性の編集

チャートの作成後は、「チャート属性」ページでチャート属性を編集してチャートの表示を変更できます。

「チャート属性」ページにアクセスするには、次のステップを実行します。

1. ページ定義にナビゲートします。「ページ定義へのアクセス」を参照してください。

2. 「リージョン」で、チャート・タイプ(「チャート」、「SVGチャート」または「Flashチャート」)をクリックします。
チャート属性ページが表示されます。

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

4. ページ上の特定のアイテムの詳細を表示するには、アイテム・ラベルをクリックします。
ヘルプが利用できる場合は、アイテム・ラベル上にカーソルを重ねると、アイテム・ラベルが赤色に変わり、カーソルが矢印と疑問符に変わります。「フィールドレベル・ヘルプについて」を参照してください。

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

ヒント:
SVGチャート(「チャート・タイトル」属性)のチャート・タイトルを削除すると、チャート凡例の位置と表示に悪影響を及ぼす場合があります。

ナビゲーションの選択肢について

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

FlashチャートとのカスタムXMLの使用

チャート属性ページには、標準の属性で制御できない追加のチャート設定があります。チャートのルック・アンド・フィールをさらに制御するには、カスタムXMLを使用できます。

カスタムXMLを使用するには、次のステップを実行します。

1. チャート属性ページにナビゲートします。

1. ページ定義にナビゲートします。「ページ定義へのアクセス」を参照してください。

2. 「リージョン」で、チャート・タイプの「Flashチャート」をクリックします。
チャート属性ページが表示されます。

2. 「チャートXML」までスクロールします。

3. 「カスタムXMLの使用」から「はい」を選択します。
カスタムXMLを使用すると、属性が適用されないリージョンは非表示となることに注意してください。これらのリージョンを再度表示するには、「カスタムXMLの使用」で「いいえ」を選択します。

4. XMLを編集します。

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

ヒント:
チャートに対してサポートされているXML書式の詳細は、次のサイトのオンラインXMLリファレンスを参照してください。

http://www.anychart.com

非同期更新の有効化

チャート属性ページの「非同期更新」属性を有効にして、情報を監視するSVGおよびFlashチャートを作成できます。この属性を有効にすると、チャートが更新され、指定した時間間隔内に基礎となるデータで行われた変更が反映されます。

非同期更新を有効にするには、次のステップを実行します。

1. SVGまたはFlashチャートを作成します。「SVGチャートの作成」または「Flashチャートの作成」を参照してください。

2. ページ定義にナビゲートします。「ページ定義へのアクセス」を参照してください。

3. 「リージョン」で、リージョン名の横にある「チャート」をクリックします。
チャート属性ページが表示されます。

4. 「リフレッシュ」までスクロールします。

5. 「非同期更新」で、「はい」を選択します。

6. 「更新間隔」で、チャートの更新間隔(秒)を入力します。最適なパフォーマンスを得るには、2秒を超える間隔を選択します。

SVGチャートに「非同期更新」を有効にすると、最終更新を示すタイムスタンプがチャートに表示されます。

「非同期更新」タイムスタンプを無効にするには、次のステップを実行します。

1. 「チャート属性」ページにナビゲートします。

2. 「CSS」セクションに移動します。

3. 「カスタムCSSを使用」で、「はい」を選択します。

4. 「カスタムCSS、インライン」で、#timestampを次のように編集します。

#timestamp{display:none;}

他の言語でのSVGチャートの表示

SVGチャートを他の言語で表示するには、textおよびtspanクラスに正しい言語が反映されるように編集します。

SVGチャートを他の言語で表示するには、次のステップを実行します。

1. 「チャート属性」ページにナビゲートします。詳細は、「チャート属性の編集」を参照してください。

2. 「CSS」までスクロールします。

3. 「カスタムCSSを使用」で、「はい」を選択します。

4. 「カスタムCSS、インライン」で、textおよびtspanクラスに正しい言語が反映されるように編集します。次の例では、チャートを韓国語に変更する方法を示します。

text{font-family:Batang;fill:#000000;}
tspan{font-family:Batang;fill:#000000;}

ボタンの作成

アプリケーションを設計する際、ボタンを使用して、特定のページまたはURLを表示したり、情報をポストまたは処理するようにできます(たとえば、「作成」、「取消」、「次へ」、「前へ」または「削除」ボタンを作成します)。

ボタンでは、2つの異なるタイプの操作を実行できます。ボタンを使用して、ページを送信してから、URLにリダイレクトできます。また、「取消」ボタンの場合などに、ページを送信せずにURLにブランチすることもできます。

この項に含まれる内容は次のとおりです。

- ページ定義の「ボタン」セクションの概要

- ウィザードを使用したボタンの作成

- 複数のボタンの作成

- ボタンの編集

- ボタン名とREQUESTの関係の理解

- ボタンを使用したブランチ処理について

- ボタンの条件付き表示

関連項目:
「ボタンのURLからのページのコール」

ページ定義の「ボタン」セクションの概要

ページ定義のボタンを作成および編集します。「ボタン」セクションは「ページ・レンダリング」領域に表示されます。「ページ定義へのアクセス」を参照してください。

「ボタン」アイコンをクリックすると、他のすべてのサブセクションを一時的に非表示にできます。表示を元に戻すには、「すべての表示」をクリックします。「すべて表示」アイコンは、下向き三角形の形をしています。

セクション・タイトルの横には次のアイコンが表示されます。

- すべて編集: 「すべて編集」アイコンは、鉛筆が置かれた小さいグリッドの形をしています。すべてのボタンを一度に編集する場合に、このアイコンを使用します。

- コピー: 「コピー」アイコンは、小さいページが2つ重なった形をしています。既存のボタンをコピーする場合に、このアイコンを使用します。

- 作成: 「作成」アイコンは、プラス(+)記号が置かれた小さいページの形をしています。新しいボタンを作成する場合に、このアイコンを使用します。

ボタンはリージョンごとに編成されます。ボタンを編集するには、ボタン名をクリックします。

関連項目:
「ボタンの編集」

ウィザードを使用したボタンの作成

ボタンを作成するには、「ページ定義」から「ボタンの作成」ウィザードを実行します。各ボタンは、リージョンに存在します。リージョンはページ上の領域で、コンテンツのコンテナとして機能します。

ボタンを作成するには、次のステップを実行します。

1. 該当するページ定義にナビゲートします。「ページ定義へのアクセス」を参照してください。

2. 必要に応じて、HTMLリージョンを作成します。「リージョンの理解」を参照してください。

3. 「ボタン」で、「作成」アイコンをクリックします。
「ボタンの作成」ウィザードが表示されます。

4. ボタンを配置するリージョンを選択し、「次へ」をクリックします。

5. ボタンの位置を選択し、「次へ」をクリックします。

- このリージョン・アイテムで表示されるボタンの作成: ページ・アイテム内またはページ・アイテム間にボタンを表示する場合は、このオプションを選択します(たとえば、フォーム・フィールドの横にボタンを直接追加する場合)。

- リージョン位置にボタンの作成: リージョン位置にボタンを配置する場合は、このオプションを選択します。リージョン位置は、リージョン・テンプレートで定義された位置です。

6. 「リージョン位置にボタンの作成」を選択する場合は、次のステップを実行します。

1. 「ボタン名」および「ラベル」を指定します。

2. ボタン・タイプ「HTMLボタン(デフォルト)」、「イメージ」または「テンプレートによる作成」を選択します。
「元に戻す」ボタンを作成するには、「ボタンをリセット」を選択します。このタイプのボタンが有効になっている場合、ページの値がこのページの初期レンダリング時の状態にリセットされます。

3. アクションを選択します。

- ページを送信してURLにリダイレクト: ユーザーがボタンをクリックするたびに、Application Expressエンジンにカレント・ページが送信されます。

- ページを送信せずにURLにリダイレクト: ページの送信が回避されます。ページを処理のために送信する必要がない場合(「取消」ボタンなど)、このアクションを選択します。このアクションでは、データベースでの処理が回避され、負荷が軽減されます。

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

7. 「このリージョン・アイテムで表示されるボタンの作成」を選択する場合は、次のステップを実行します。

1. 「ボタン名」および「順序」を指定します。

2. ボタンを新しい行の先頭に表示するか、新しいフィールドの先頭に表示するかを指定します。

3. ラベルを指定します。

4. リクエストの値を入力します。

5. ボタン・スタイルを選択します。

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

8. 画面に表示されるステップに従います。特定のフィールドの詳細を表示するには、アイテム・ラベルをクリックします。
ヘルプが利用できる場合は、アイテム・ラベル上にカーソルを重ねると、アイテム・ラベルが赤色に変わり、カーソルが矢印と疑問符に変わります。「フィールドレベル・ヘルプについて」を参照してください。

関連項目:
「ボタン名とREQUESTの関係の理解」

HTMLボタンの作成

ボタンは、事前定義されたリージョン・テンプレート位置またはフォーム内のアイテムに配置できます。HTMLボタンを作成するには、「ボタンの作成」ウィザードの実行中に次のいずれかを選択します。

- 「タスク」で、「リージョン位置にボタンの作成」を選択します。

- 「ボタン・タイプ」で、ボタン・タイプを選択し、次に「HTMLボタン」(デフォルト)を選択します。

複数のボタンの作成

「複数のボタンの作成」ウィザードを使用すると、同じリージョン内に一度に複数のボタンを作成できます。

一度に複数のボタンを作成するには、次のステップを実行します。

1. 該当するページ定義にナビゲートします。「ページ定義へのアクセス」を参照してください。

2. 必要に応じて、HTMLリージョンを作成します。「リージョンの理解」を参照してください。

3. 「ボタン」で、「作成」アイコンをクリックします。
「ボタンの作成」ウィザードが表示されます。

4. 既存の認可スキームが、ページの下部に表示されます。
「複数のボタンの作成」ウィザードが表示されます。

5. 「リージョンにボタンを配置」から、ボタンを含めるリージョンを選択します。

6. 「テンプレート」からテンプレートを選択します。

7. 「HTML属性」で、これらのボタンのHTML属性を指定します。このテキストがHTML要素の定義に追加されます。たとえば、テキスト・ボタンのクラスを次のように設定できます。

class="myclass"

8. 残りのフィールドに迅速に移入するには、ページの右側にある「クイック・ボタン」リストから選択します。

9. 「ボタンの作成」をクリックします。

ボタンの編集

ボタンを編集する場合は、「ページ定義」の「ボタン」セクションから開始します。ボタンの属性の変更、一度に複数のボタンの編集、またはリージョン内のボタン位置の変更を行うことができます。

この項に含まれる内容は次のとおりです。

- ボタン属性の編集

- 「すべて編集」アイコンを使用した複数ボタンの編集

- 「ボタンの順序変更」アイコンの使用

関連項目:
「「すべての編集」アイコンについて」

ボタン属性の編集

ページ・ボタンの編集ページでボタンの属性を編集できます。

既存のボタンの属性を編集するには、次のようにします。

1. 該当するページ定義にナビゲートします。「ページ定義へのアクセス」を参照してください。

2. 「ボタン」で、ボタン名を選択します。
ボタンの属性ページが表示されます。

3. ページ上の特定のアイテムの詳細を表示するには、アイテム・ラベルをクリックします。
ヘルプが利用できる場合は、アイテム・ラベル上にカーソルを重ねると、アイテム・ラベルが赤色に変わり、カーソルが矢印と疑問符に変わります。「フィールドレベル・ヘルプについて」を参照してください。

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

「すべて編集」アイコンを使用した複数ボタンの編集

「ページ定義」で「すべて編集」アイコンをクリックすると、複数のボタンを一度に編集できます。「すべて編集」アイコンは、鉛筆が置かれた小さいグリッドの形をしています。

「すべて編集」アイコンをクリックすると、リージョンのボタンをリストした表を含んだボタン・ページが表示されます。このアイコンを使用して複数のボタンを一度に編集できます。

ボタン・ページから、複数のボタンを削除したり、最近の変更の履歴を表示できます。

複数のボタンを編集するには、次のステップを実行します。

1. 該当するページ定義にナビゲートします。「ページ定義へのアクセス」を参照してください。

2. 「ボタン」で、「すべて編集」アイコンをクリックします。
ボタン・ページが表示されます。

3. ボタン・ページで属性を編集します。または「編集」アイコンをクリックして、1つのボタンの属性を編集します。

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

複数のボタンの削除

一度に複数のボタンを削除するには、次のステップを実行します。

1. 該当するページ定義にナビゲートします。「ページ定義へのアクセス」を参照してください。

2. 「ボタン」で、「すべて編集」アイコンをクリックします。

3. 「複数のボタンの削除」をクリックします。
複数のボタンの削除ページが表示されます。

4. 削除するボタンを選択して、「ボタンの削除」をクリックします。

履歴

履歴ページを使用して、ボタンの最近の変更のサマリーを表示します。

「ボタンの順序変更」アイコンの使用

ページ定義で「リージョン・ボタンの順序変更」アイコンをクリックすることで、ボタン・ラベルの編集や、リージョン内のボタン位置の変更を迅速に実行できます。「リージョン・ボタンの順序変更」アイコンは明るい緑色の下向きおよび上向きの矢印で、リージョン名の横に表示されます。

「リージョン・ボタンの順序変更」アイコンを使用してボタンを編集するにはボタンを編集するには、次のようにします。

1. 該当するページ定義にナビゲートします。「ページ定義へのアクセス」を参照してください。

2. 「ボタン」で、「リージョン・ボタンの順序変更」アイコンをクリックします。
ボタンの順序変更ページが表示されます。このページを使用してボタン・ラベルの編集、リージョン位置の選択、またはボタン順序の変更を行います。

3. ボタン・ラベルを編集するには、「ラベル」フィールドに名前を入力します。

4. リージョン位置を変更するには、「位置」リストから選択を行います。

5. ボタンが表示される順序を変更するには、一番右側の列で上矢印および下矢印をクリックします。
ボタンの表示順序は、「順序」属性を編集して制御することもできるので注意してください。「ボタン属性の編集」を参照してください。

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

注意:
ボタンが配置されるリージョンを変更するには、ボタン属性を編集する必要があります。「ボタン属性の編集」を参照してください。

ボタン名とREQUESTの関係の理解

ボタンに付けた名前によって、組込み属性REQUESTの値が決まります。バインド変数:REQUESTを使用して、PL/SQL内のREQUESTの値を参照できます。このバインド変数を使用して、ユーザーがクリックするボタンに応じてプロセス、検証またはブランチを条件付きで実行できます。ユーザーがボタンをクリックした際に実行されるプロセスを作成することもできます。また、より複雑な条件も使用できます。次に例を示します。

If :REQUEST in ('EDIT','DELETE') then ...
If :REQUEST != 'DELETE' then ...

これらの例では、「EDIT」および「DELETE」という名前のボタンが存在すると想定します。この構文は、PL/SQL式の条件にも使用できます。ただし、ボタン名の大/小文字が保持されることに注意してください。ボタン名をLOGINに指定した場合、名前「Login」を検索するリクエストは失敗します。次に例を示します。

<input type="BUTTON" value="Finish" onClick="javascript:doSubmit('Finish');">

この例では、FinishはREQUESTの名前で、大/小文字が区別されます。

ボタンを使用したブランチ処理について

各ページには、任意の数のブランチを含めることができます。ブランチは、アプリケーションの他のページまたはURLにリンクします。Application Expressでは、ページ・プロセス中の異なる時点でブランチが検討されます。プロセス前、計算前、検証前およびプロセス後のどの時点でブランチするかを選択できます。アプリケーション・ビルダーの他のコントロールと同様に、ブランチ処理には条件を設定できます。たとえば、ユーザーがボタンをクリックした場合にブランチできます。ブランチを作成する場合は、ブランチを特定のボタンに関連付けます。ブランチは、ユーザーがボタンをクリックした場合にのみ検討されます。

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

ボタンの条件付き表示

ボタンを条件付きで表示するには、「ページ・ボタンの編集」ページの属性を編集します。

ボタンを条件付きで表示するには、次のステップを実行します。

1. ボタンを作成します。詳細は、「ウィザードを使用したボタンの作成」を参照してください。

2. 該当するページ定義にナビゲートします。「ページ定義へのアクセス」を参照してください。

3. 「ボタン」で、ボタン名を選択します。
ボタンの属性ページが表示されます。

4. 「条件付きボタン表示」までスクロールします。

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

6. 表示されるフィールドに式を入力します。

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

関連項目:
「バインド変数構文について」

LOVの作成

LOVは、ポップアップLOV、選択リスト、チェック・ボックス、ラジオ・グループ、複数の選択リストなどの、特定のタイプのページ・アイテムを表示するために使用される静的または動的な値のセットです。

共有コンポーネントとしてLOVを作成することには次のような利点があります。

- アプリケーション内のすべてのページに追加できます。

- すべてのLOV定義は1つの場所に格納されるため、検索と更新が簡単になります。

この項に含まれる内容は次のとおりです。

- アプリケーション・レベルでの名前付きのLOVの作成

- 静的LOVについて

- 既存のLOVの編集

- LOV内でのセッション・ステートの参照

- LOVに基づくアイテム内のNULL値の参照

- LOVレポートへのアクセス

関連項目:
「静的LOVの作成」および「共有コンポーネントでの作業」

アプリケーション・レベルでの名前付きのLOVの作成

アプリケーション・レベルで名前付き(共有) LOVを定義するには、「LOVの作成」ウィザードを実行して、これらのLOVをLOVリポジトリに追加します。すべてのLOVは、静的LOVまたは動的LOVとして定義できます。静的リストは、表示値と戻り値の事前定義された組合せに基づきます。動的リストは、表から値を選択するように作成したSQL問合せに基づきます。

名前付きLOVを作成するには、次のステップを実行します。

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

2. アプリケーションを選択します。
アプリケーションのホームページが表示されます。

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

4. 「ユーザー・インタフェース」で、「LOV」を選択します。
LOVページが表示されます。

5. LOVを作成するには、「作成」をクリックします。

6. 画面に表示されるステップに従います。
新しい名前付きのLOVがLOVリポジトリに追加されます。LOVをページに追加するためには該当するアイテムまたは列を編集して名前付きのLOVを選択する必要があることに注意してください。

関連項目:
「クラシック・レポートでのLOVとしての列定義」

「LOV」ページについて

作成したLOVは、LOVページに表示されます。

ページ上部のナビゲーション・バーを使用して名前でLOVを検索するか、またはページの表示を変更します。たとえば、「ビュー」リストから選択して、デフォルトの表示を変更できます。使用可能なオプションは次のとおりです。

- アイコン(デフォルト): 各LOVを大きいアイコンとして表示します。LOVを編集するには、該当するアイコンをクリックします。

- 詳細: 各LOVをレポートで1行に表示します。LOVを編集するには、名前をクリックします。

静的LOVについて

静的LOVは、LOVの作成ウィザードの実行時に指定する表示値と戻り値の静的リストに基づきます。静的LOVを作成するには、LOVの作成ウィザードを実行して、LOVタイプに「静的」を選択します。Oracle Application Expressによって、指定した表示値、戻り値およびソート順序がLOVリポジトリに格納されます。リポジトリに静的LOVを追加すると、アイテムを作成し、この定義に基づいてチェック・ボックス、ラジオ・グループ、選択リストまたはポップアップ・リストとしてアイテムを表示できます。

既存のLOVの編集

既存のLOVを編集するには、「LOV」ページでLOVを選択します。

LOVを編集するには、次のステップを実行します。

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

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

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

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

5. LOVを選択します。
「LOVの編集」ページが表示されます。

6. ページ上の特定のアイテムの詳細を表示するには、アイテム・ラベルをクリックします。
ヘルプが利用できる場合は、アイテム・ラベル上にカーソルを重ねると、アイテム・ラベルが赤色に変わり、カーソルが矢印と疑問符に変わります。「フィールドレベル・ヘルプについて」を参照してください。

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

ナビゲーションの選択肢について

LOVの編集ページは、「名前」、「サブスクリプション」、「ソース」および「コメント」のセクションに分かれています。

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

関連項目:
「「すべての編集」アイコンについて」

静的LOVのバルク編集

「LOVの編集」ページで「グリッド編集」ボタンをクリックすることによって、すべての静的LOVの表示値を編集できます。

静的LOVのバルク編集を実行するには、次のステップを実行します。

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

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

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

4. 「ユーザー・インタフェース」で、「LOV」を選択します。
デフォルトでは、LOVはアイコンとして表示されます。

5. デフォルトの表示を変更します。「ビュー」リストから「詳細」を選択し、「実行」をクリックします。

6. 静的LOVを検索して、LOV名を選択します。

7. 「サブスクリプション」の下の「グリッド編集」ボタンをクリックします。

8. 該当する表示値を編集し、「変更の適用」をクリックします。

LOV内でのセッション・ステートの参照

バインド変数を使用することでセッション・ステートを参照できます。セッション・ステートを参照するとLOVは再利用性が多少低下しますが、開発手法として推奨されています。次の例では、このLOVはmy_deptnoというアイテムに有効な部門番号が含まれている場合のみ機能します。

SELECT ename, empno FROM emp WHERE deptno = :P1_DEPTNO

LOVに基づくアイテム内のNULL値の参照

LOVにはNULL表示値オプションとNULL戻り値オプションがあります。NULL表示値はエンド・ユーザーに対してリストに表示される値で、リストの適切な(非NULL)値の選択は行われないことを示しています。ユーザーがNULL表示値を選択すると、ページの送信時にLOVのNULL戻り値がアプリケーションに送られます。開発者がNULL戻り値を指定しない(または空の)ままにした場合、転送される実際の値は空の文字列またはOracle NULLではなく、リテラルの%null%です。このリテラルを処理してNULL選択として扱うように、アプリケーションを準備する必要があります。

送信された値を評価するためのコードを記述する場合は、この動作に注意してください。たとえば、送信されたアイテムP1_Xがあるページによって評価され、そのアイテムをPL/SQL式replace(:P1_X,'%'||null%',null)を使用してセッション・ステートで永続保存するかまたはDMLなどのAPIに渡すために準備する必要があるとします。

問題が発生しないようにするには、ページ計算、プロセスおよび検証で実行される式で%null%を適切にコード化する必要があります。保存される際に%null%がアプリケーションによってページ・メタデータ内のNULL値と置き換えられないように、文字列を分割する必要があります。次に例を示します。

'%'||'null%'

LOVレポートへのアクセス

アプリケーション・ビルダーには、LOVの管理に役立つ多くのレポートが含まれています。

LOVレポートへのアクセス

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

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

3. アプリケーション・ビルダーが表示されたら、「共有コンポーネント」をクリックします。

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

5. ページ上部の次のいずれかのタブを選択します。

- 検索

- サブスクリプション

- 使用状況

- 履歴

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

検索

「検索」をクリックすると、動的LOVの検索ページが表示されます。このページを使用して、動的LOVを構成する問合せを検索します。「問合せの内容」フィールドに問合せを入力し、「実行」をクリックします。

サブスクリプション

「サブスクリプション」をクリックすると、LOVのサブスクリプション・ページが表示されます。このページには、アプリケーションに存在するサブスクライブされたLOVがすべて表示されます。

使用状況

「使用状況」をクリックすると、LOVの使用状況ページが表示されます。このページには、カレント・アプリケーションで使用されるLOVが表示されます。LOVを編集するには、LOV名をクリックします。

履歴

「履歴」をクリックすると、LOV履歴ページが表示されます。このページには、最近変更されたLOVの履歴が日付ごとに表示されます。

依存選択リストの作成

選択リストを使用して、同じページに存在する別の選択リストの値の範囲を決定できます。これは、駆動側の選択リストから後続の選択リストに値を送信することによって行います。これらの値は、問合せのWHERE句のバインド変数として、後続の選択リストに組み込みます。

次の手順で、あるLOVによって別のLOVを駆動します。

- 基本フォームを作成します。

- 2つのLOVを定義します。値を選択すると駆動LOVによって、ページが送信されることに注意してください。

- カレント・ページへのブランチを定義します。

次の例を考えてみます。最初のLOVで、州を選択できます。

SELECT state_name d, state_id v
FROM states

2つ目のLOVでは、最初のLOVで選択した州に基づいて郡名および郡IDを選択できます。

SELECT county_name d, county_id v
FROM counties
WHERE state_id = :P1_STATE_ID

関連項目:
「フォームの作成」、「LOVの作成」および「ブランチを使用したナビゲーションの制御」

ショートカットの使用

ショートカットを使用すると、HTMLまたはPL/SQLファンクションを繰り返しコーディングする必要がなくなります。ショートカットを使用して、ボタン、HTMLテキスト、PL/SQLプロシージャ、HTMLなどのページ・コントロールを定義できます。ショートカットを定義すると、そのショートカットが使用される位置に固有な特定の構文を使用して起動できます。ショートカットは何度でも参照できるため、コードの重複を削減できます。

この項には、次の項目が含まれます。

- ショートカット・タイプ

- ショートカットの定義

- 既存のショートカットの編集

- ショートカット・レポートの表示

ショートカット・タイプについて

ショートカットを作成する際は、作成するショートカットのタイプを指定する必要があります。Oracle Application Expressは、次のショートカット・タイプをサポートしています。

- PL/SQLファンクション本体

- HTMLテキスト

- エスケープされた特殊文字を持つHTMLテキスト

- イメージ

- エスケープされた一重引用符を持つJavaScriptのテキスト

- メッセージ

- エスケープされた一重引用符を持つJavaScriptのメッセージ

エスケープされた一重引用符を持つJavaScriptのテキスト

このタイプのショートカットを使用して、JavaScriptリテラル文字列内部のショートカットを参照します。このショートカットは、テキスト文字列を定義します。ショートカットが参照されると、JavaScriptに必要な一重引用符がエスケープされます。

メッセージ

このタイプのショートカットを使用して、実行時に変換可能なメッセージを参照します。このショートカットには、ショートカット・ボディがないため、ショートカット名と対応するメッセージ名は一致する必要があります。実行時、ショートカット名は、現在の言語に変換可能なメッセージのテキストに拡張されます。

エスケープされた一重引用符を持つJavaScriptのメッセージ

このタイプのショートカットを使用して、JavaScriptリテラル文字列内部のショートカットを参照し、実行時に変換可能なメッセージを参照します。

関連項目:
「アプリケーションの翻訳およびグローバリゼーション・サポートについて」

ショートカットの定義

ショートカットをアプリケーションに組み込むには、ショートカットを定義して、ショートカット・リポジトリに追加する必要があります。ショートカットを参照するには、次の構文を使用します。

"MY_SHORTCUT"

ショートカットの名前は、大文字で指定し、引用符で囲む必要があります。

ショートカットを定義するには、次のステップを実行します。

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

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

3. アプリケーション・ビルダーが表示されたら、「共有コンポーネント」をクリックします。

4. ユーザー・インタフェースで、「ショートカット」を選択します。

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

6. 次のいずれかの項目を選択します。

- 最初から

- 既存のショートカットのコピーとして

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

新しいショートカットがショートカット・リポジトリに追加され、次の属性で選択可能になります。

- 「HTMLテキスト(ショートカットあり)」として定義されたリージョンのリージョン・ソース属性。「リージョンの理解」を参照してください。

- リージョンのヘッダーおよびフッターのテキスト属性。詳細は、「リージョンのヘッダーおよびフッターの指定」を参照してください。

- アイテム・ラベル属性およびデフォルト値属性。詳細は、「アイテム」を参照してください。

- リージョン・テンプレート属性。「テンプレートのカスタマイズ」を参照してください。

ショートカット・ページ

ショートカットを作成すると、そのショートカットがショートカット・ページに表示されます。「ビュー」リストから選択して、ページの表示方法を制御します。使用可能なオプションは次のとおりです。

- アイコン(デフォルト): 各ショートカットを大きいアイコンとして表示します。ショートカットを編集するには、該当するアイコンをクリックします。

- 詳細: 各ショートカットをレポートで1行に表示します。ショートカットを編集するには、名前をクリックします。

既存のショートカットの編集

作成したショートカットは、ショートカットの編集ページで属性を編集することで変更できます。

既存のショートカットを編集するには、次のようにします。

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

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

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

4. ユーザー・インタフェースで、「ショートカット」を選択します。

5. ショートカットを選択します。
ショートカットの編集ページが表示されます。

6. ページ上の特定のアイテムの詳細を表示するには、アイテム・ラベルをクリックします。
ヘルプが利用できる場合は、アイテム・ラベル上にカーソルを重ねると、アイテム・ラベルが赤色に変わり、カーソルが矢印と疑問符に変わります。「フィールドレベル・ヘルプについて」を参照してください。

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

ナビゲーションの選択肢について

ショートカットの編集ページは、「名前」、「サブスクリプション」、「ソース」、「構成」および「コメント」のセクションに分かれています。

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

ショートカット・レポートへのアクセス

アプリケーション・ビルダーには、ショートカットの管理に役立つ多くのレポートが含まれています。

ショートカット・レポートにアクセスするには、次のステップを実行します。

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

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

3. アプリケーション・ビルダーが表示されたら、「共有コンポーネント」をクリックします。

4. ユーザー・インタフェースで、「ショートカット」を選択します。

5. 次のいずれかのタブをクリックします。

- サブスクリプション

- 履歴

注意:
「サブスクリプション」タブおよび「履歴」タブが表示されるのは、ショートカットを作成した後のみです。

サブスクライブされたショートカット

「サブスクリプション」をクリックすると、サブスクライブされたショートカット・ページが表示されます。このページには、アプリケーションに存在するサブスクライブされたショートカットがすべて表示されます。

ショートカット履歴

「履歴」をクリックすると、ショートカット履歴ページが表示されます。このページには、最近変更されたショートカットの履歴が日付ごとに表示されます。

「検索」アイコンの使用

アプリケーション・ビルダー内の多くのページでは「検索」アイコンをクリックすることでアイテム、ページ、問合せ、表、PL/SQLコード、イメージまたはカスケード・スタイルシートを検索できます。

この項には、次の項目が含まれます。

- 「検索」アイコンについて

- 「アイテム・ファインダ」について

- 「ページ・ファインダ」の使用

- 「問合せファインダ」の使用

- 「表ファインダ」の使用

- PL/SQLファインダの使用

- イメージ・ファインダの使用

- CSSファインダの使用

「検索」アイコンについて

「検索」アイコンは次の図に示すように懐中電灯のような形をしており、ほとんどの場合「ページの実行」および「ページの編集」アイコンの右側に表示されます。「検索」アイコンはアプリケーションのホームページ、ページ定義、アプリケーション属性ページ、および共有コンポーネントを作成および管理するためのページなど、アプリケーション・ビルダーの多くのページに表示されます。

関連項目:
「アプリケーションのホームページについて」

「アイテム・ファインダ」について

アプリケーション・ビルダーでは、アイテムはテキスト・フィールド、テキスト領域、パスワード、選択リスト、チェック・ボックスなどを示します。「アイテム・ファインダ」を使用すると、現在のアプリケーション内、またはワークスペースに関連付けられたスキーマ内のアイテムを検索できます。

関連項目:
「ページ・レベル・アイテムの理解」

「アイテム・ファインダ」を使用してアイテムを検索するには、次のステップを実行します。

1. 「検索」アイコンをクリックします。
「アイテム・ファインダ」が表示されます。

検索バーはページの上部に表示され、次のコントロールが含まれています。

- 検索。アイテム名を検索します。「検索」フィールドに大/小文字を区別しないキーワードを入力し、「実行」をクリックします。すべてのアイテムを表示するには、「検索」フィールドをブランクのままにして「実行」をクリックします。

- ページ。アイテムを含むページを検索します。ページ番号を「ページ」フィールドに入力するか、リストからページ番号を選択して「実行」をクリックします。アイテムを含むすべてのページを表示する場合は、「ページ」フィールドをブランクのままにして「実行」をクリックします。

- 「表示」。生成されるレポートに表示する行数を指定します。表示する行数を変更するには、「表示」リストで選択を行ってから「実行」をクリックします。

「アイテム・ファインダ」レポートが表示され、その中にはアイテム名、ラベル、アイテム・タイプおよび関連付けられたページ番号が含まれます。

2. 特定のページのアイテムのみを表示するようにレポートを限定する場合は、一番右側の列で該当するページ番号をクリックします。
ページ上部の「ページ」フィールドに、選択したページ番号が表示されます。ビューを開いてすべてのページを表示するには、「ページ」フィールドのページ番号を削除して、「実行」をクリックします。

3. 特定のアイテムを編集するには、該当するアイテムにナビゲートします。「ページ・レベル・アイテムの理解」および「「すべて編集」アイコンを使用した複数アイテムの編集」を参照してください。

「ページ・ファインダ」の使用

ページ(またはページ定義)はアプリケーションの基本的な構成要素です。「ページ・ファインダ」を使用すると、現在のアプリケーション内、またはワークスペースに関連付けられたスキーマ内のページを検索できます。

ページを検索するには、次のステップを実行します。

1. 「検索」アイコンをクリックします。

2. 「ページ」タブを選択します。
「ページ・ファインダ」が表示されます。

検索バーはページの上部に表示され、次のコントロールが含まれています。

- 検索。ページ名を検索します。「検索」フィールドに大/小文字を区別しないキーワードを入力し、「実行」をクリックします。すべてのページを表示するには、「検索」フィールドをブランクのままにして「実行」をクリックします。

- 「表示」。生成されるレポートに表示する行数を指定します。表示する行数を変更するには、「表示」リストで選択を行ってから「実行」をクリックします。

ページ・ファインダ・レポートが表示されます。ここにはページ番号、ページ名、ページ別名、タイトル、タブ・セット、およびページ上のアイテムおよびリージョン数のカウントが表示されます。

3. アイテム・ページにリンクするには、ページ番号をクリックします。

関連項目:
「ページ定義について」および「ページ定義の編集」

「問合せファインダ」の使用

「問合せファインダ」を使用すると、アプリケーション内、またはワークスペースに関連付けられたスキーマ内の問合せを検索できます。

「問合せファインダ」を使用して問合せを検索するには、次のステップを実行します。

1. 「検索」アイコンをクリックします。

2. 「問合せ」タブを選択します。
「問合せファインダ」が表示されます。

検索バーはページの上部に表示され、次のコントロールが含まれています。

- 検索。問合せ文を検索します。「検索」フィールドに大/小文字を区別しないキーワードを入力し、「実行」をクリックします。すべての問合せを表示するには、「検索」フィールドをブランクのままにして「実行」をクリックします。

- 「表示」。生成されるレポートに表示する行数を指定します。表示する行数を変更するには、「表示」リストで選択を行ってから「実行」をクリックします。

「問合せファインダ」レポートが表示され、その中にはページ番号、ページ名、問合せを含むリージョンおよび問合せソースが含まれます。

3. アイテム・ページにリンクするには、ページ番号をクリックします。

関連項目:
「ページ定義について」および「ページ定義の編集」

「表ファインダ」の使用

「表ファインダ」を使用すると、ワークスペースに関連付けられたスキーマ内の表を表示できます。

現在のスキーマに関連付けられた表を表示するには、次のステップを実行します。

1. 「検索」アイコンをクリックします。

2. 「表」タブを選択します。
「表ファインダ」が表示されます。

選択されたスキーマを表示するナビゲーション・バーはページの上部に表示され、次のコントロールが含まれています。

- 検索。表名を検索します。「検索」フィールドに大/小文字を区別しないキーワードを入力し、「実行」をクリックします。すべての表を表示するには、「検索」フィールドをブランクのままにして「実行」をクリックします。

- 「表示」。生成されるレポートに表示する行数を指定します。表示する行数を変更するには、「表示」リストで選択を行ってから「実行」をクリックします。

- ビュー。生成されるレポートにビューを含めるには、「ビュー」チェック・ボックスを選択して「実行」をクリックします。

「表ファインダ」レポートが表示され、その中には表名、行数およびオブジェクト・タイプが含まれます。

3. 表名を選択します。
ページの右側に表定義が表示されます。

このレポートには列名、データ型、長さ、精度およびスケールが表示され、ページ下部には表を再作成するために必要なSQLが表示されます。

関連項目:
Oracle Application Express SQLワークショップおよびユーティリティ・ガイドの「表の管理」

PL/SQLファインダの使用

PL/SQLファインダを使用すると、ワークスペースに関連付けられたスキーマ内の、各オブジェクトに関連付けられたストアド・プロシージャ、ファンクションおよびパッケージに関する詳細を検索して表示できます。

現在のスキーマのPL/SQLコードを検索するには、次のステップを実行します。

1. 「検索」アイコンをクリックします。

2. 「PL/SQL」タブを選択します。
PL/SQLファインダが表示されます。

検索バーはページの上部に表示され、次のコントロールが含まれています。

- 検索。プロシージャ、ファンクションまたはパッケージの名前を検索します。「検索」フィールドに大/小文字を区別しないキーワードを入力し、「実行」をクリックします。すべて表示するには、「検索」フィールドをブランクのままにして「実行」をクリックします。

- 「表示」。生成されるレポートに表示する行数を指定します。表示する行数を変更するには、「表示」リストで選択を行ってから「実行」をクリックします。

- プロシージャ、ファンクションまたはパッケージ:チェック・ボックスを1つ以上選択して「実行」をクリックし、プロシージャ、ファンクションおよびパッケージをレポート内に含めます。結果を得るにはチェック・ボックスを少なくとも1つ選択する必要があります。

PL/SQLファインダ・レポートが表示されます。

3. 詳細を表示するには、プロシージャ、ファンクションまたはパッケージの名前を選択します。

プロシージャ、パッケージまたはファンクションの名前が、所有者、ソース名、ソース・タイプ、戻り型、引数名、データ型およびIN/OUTパラメータなどの情報とともに表示されます。

関連項目:
Oracle Application Express SQLワークショップおよびユーティリティ・ガイドの「オブジェクト・ブラウザを使用したデータベース・オブジェクトの管理」

イメージ・ファインダの使用

イメージ・ファインダを使用して、カレント・アプリケーションに使用可能なイメージを識別できます。

使用可能なイメージを表示するには、次のステップを実行します。

1. 「検索」アイコンをクリックします。

2. 「イメージ」タブを選択します。
イメージ・ファインダが表示されます。

検索バーはページの上部に表示され、次のコントロールが含まれています。

- 検索。イメージ名を検索します。「検索」フィールドに大/小文字を区別しないキーワードを入力し、「実行」をクリックします。すべて表示するには、「検索」フィールドをブランクのままにして「実行」をクリックします。

- アイコン・サイズ。検索するアイコンのサイズを選択して、「実行」をクリックします。

- 「表示」。生成されるレポートに表示する行数を指定します。表示する行数を変更するには、「表示」リストで選択を行ってから「実行」をクリックします。

- 列。1行に表示する列数を選択して、「実行」をクリックします。

3. 「表示」から、表示するイメージのタイプを選択します。オプションは次のとおりです。

- 標準イメージ

- ワークスペース・イメージ

- アプリケーション・イメージ

関連項目:
Oracle Application Express SQLワークショップおよびユーティリティ・ガイドの「オブジェクト・ブラウザを使用したデータベース・オブジェクトの管理」

CSSファインダの使用

CSSファインダを使用すると、テーマに関係なくどのアプリケーションでも使用可能なカスケード・スタイルシートを表示できます。

使用可能なカスケード・スタイルシートを表示するには、次のステップを実行します。

1. 「検索」アイコンをクリックします。

2. 「CSS」タブを選択します。
CSSファインダが表示されます。

検索バーはページの上部に表示され、次のコントロールが含まれています。

- 検索。「検索」フィールドに大/小文字を区別しないキーワードを入力し、「実行」をクリックします。すべて表示するには、「検索」フィールドをブランクのままにして「実行」をクリックします。

- カテゴリ。CSSカテゴリを選択して、「実行」をクリックします。使用可能なオプションは次のとおりです。

- 絶対サイズ

- アンカー・タグ

- 相対サイズ

- 「表示」。生成されるレポートに表示する行数を指定します。表示する行数を変更するには、「表示」リストで選択を行ってから「実行」をクリックします。

関連項目:
「カスケード・スタイルシートについて」および「カスタム・カスケード・スタイルシートの使用」

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

アクセス制御リストを作成することによって、アプリケーション、個別ページまたはページ・コンポーネントへのアクセスを制御できます。

この項には、次の項目が含まれます。

- アクセス制御リストの動作方法

- アクセス制御リストの作成

- アプリケーション・モードの選択とユーザーの追加

- ページおよびページ・コンポーネントに対するアクセスの制御

関連項目:
Oracle Application Express SQLワークショップおよびユーティリティ・ガイドの「クエリー・ビルダーを使用した問合せの構築」

チュートリアルを参照:
Oracle Application Expressアドバンスト・チュートリアルの「アクセス制御ページの構築方法」

アクセス制御リストの動作方法

アクセス制御ウィザードを実行して、アクセス制御リストを作成します。アクセス制御ウィザードにより、Access Control Administrationという名前のページが作成されます。このページにはアプリケーション・モード・リストとアクセス制御リストが含まれます。アクセス制御管理ページを作成したら、次のようにします。

1. アクセス制御管理ページを実行します。

2. 次のいずれかのアプリケーション・モードを選択します。

- すべての対象への完全なアクセス権。アクセス制御リストは使用されません。

- 制限されたアクセス。アクセス制御リストに定義されたユーザーのみが許可されます。

- パブリック読取り専用。アクセス制御リストによって制御される編集および管理の権限です。

- 管理アクセス専用。

3. アクセス制御リストにユーザーを追加します。

アクセス制御管理ページを作成する以外に、アクセス制御ウィザードでは次のものを作成します。

- アクセス制御を管理するためのアプリケーションのデフォルト・スキーマ内に2つの表

- アプリケーション・モード・リストのオプションに対応する認可スキーム

- 「アクセス制御」リストで使用可能な権限

これらの認可スキームの中の1つをページまたはコンポーネント属性ページで選択することで、特定のページまたはページ・コンポーネントへのアクセスを制御できます。アクセス制御を作成したら、アプリケーションの特定のニーズに合うようにページ、表および値をカスタマイズできます。

関連項目:
「アプリケーションへの認可スキームの割当て」

アクセス制御リストの作成

ページを作成することでアクセス制御リストを作成します。アプリケーションのホームページ上で、またはページ定義の表示時に、または「開発者」ツールバーで「作成」をクリックすることで、ページを作成できます。

この項に含まれる内容は次のとおりです。

- アプリケーションのホームページからのアクセス制御リストの作成

- ページ定義からのアクセス制御リストの作成

- 「開発者」ツールバーからのアクセス制御リストの作成

アプリケーションのホームページからのアクセス制御リストの作成

アプリケーションのホームページからアクセス制御リストを作成するには、次のようにします。

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

2. アプリケーションを選択します。
アプリケーションのホームページが表示されます。

3. 「ページの作成」をクリックします。

4. ページ・タイプとして「アクセス制御」を選択し、「次へ」をクリックします。
アクセス制御ウィザードウィザードが表示されます。

5. ページ番号を指定し、「次へ」をクリックします。

6. タブ・オプションを選択し、「次へ」をクリックします。

7. ページを確認して、「終了」をクリックします。

ページ定義からのアクセス制御リストの作成

ページ定義からアクセス制御リストを作成するには、次のようにします。

1. 該当するページ定義にナビゲートします。「ページ定義へのアクセス」を参照してください。

2. ページ上部のナビゲーション・バーの横にある「作成」ボタンをクリックします。

3. 「新しいページ」を選択して、「次へ」をクリックします。

4. ページ・タイプとして「アクセス制御」を選択し、「次へ」をクリックします。
アクセス制御ウィザードウィザードが表示されます。

5. ページ番号を指定し、「次へ」をクリックします。

6. タブ・オプションを選択し、「次へ」をクリックします。

7. ページを確認して、「終了」をクリックします。

「開発者」ツールバーからのアクセス制御リストの作成

「開発者」ツールバーからアクセス制御リストを作成するには、次のようにします。

1. アプリケーションを実行します。「ページまたはアプリケーションの実行」を参照してください。

2. 「開発者」ツールバーで「作成」をクリックします。
「新しいコンポーネント」ウィザードが表示されます。

3. 「新しいページ」を選択して、「次へ」をクリックします。

4. ページ・タイプとして「アクセス制御」を選択し、「次へ」をクリックします。
アクセス制御ウィザードウィザードが表示されます。

5. ページ番号を指定し、「次へ」をクリックします。

6. タブ・オプションを選択し、「次へ」をクリックします。

7. ページを確認して、「終了」をクリックします。

アプリケーション・モードの選択とユーザーの追加

アクセス制御管理ページを実行し、アプリケーション・モードを選択してからアクセス制御リストへユーザーを追加することによって、アプリケーションへのアクセスを制御できます。

この項には、次の項目が含まれます。

- アプリケーション・モードの選択

- アクセス制御リストへのユーザーの追加と権限の選択

- アクセス制御リストからのユーザーの削除

アプリケーション・モードの選択

アプリケーション・モードを選択するには、次のようにします。

1. アクセス制御リストを作成します。「アクセス制御リストの作成」を参照してください。
アクセス制御管理というページが作成されます。

2. アクセス制御管理ページを実行します。「ページまたはアプリケーションの実行」を参照してください。

3. アプリケーション・モードを選択します。オプションは次のとおりです。

- すべての対象への完全なアクセス権。アクセス制御リストは使用されません。
すべてのユーザーがアプリケーションにアクセスできるようにするには、このオプションを選択します。

- 制限されたアクセス。アクセス制御リストに定義されたユーザーのみが許可されます。
アクセス制御リスト上のユーザーのみにアクセスを許可するには、このオプションを選択します。アクセス制御リスト上のユーザーのみが、認可スキームに関連付けられたページおよびコンポーネントを表示できます。

- パブリック読取り専用。アクセス制御リストによって制御される編集および管理の権限です。
アクセス制御 - 認可スキームの表示に関連付けられたページおよびコンポーネントに、パブリック・アクセスを提供します。

- 管理アクセス専用。
管理者権限を持つユーザーのみが、認可スキームに関連付けられたページまたはコンポーネントにアクセスできます。

4. 「アプリケーション・モードの設定」をクリックします。

ページのユーザー・インタフェースは、アプリケーションで選択したテーマによって異なるので注意してください。「テーマの管理」を参照してください。

次は、アクセス制御リストにユーザーを追加します。

アクセス制御リストへのユーザーの追加と権限の選択

アクセス制御リストにユーザーを追加するには、次のようにします。

1. アクセス制御リストの下で、「ユーザーの追加」をクリックします。
新しい行が表示されます。

2. 「ユーザー名」フィールドにユーザー名を入力します。

3. ユーザーに権限を関連付けます。使用可能なオプションは次のとおりです。

- 管理者

- 編集

- 表示

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

5. すべてのユーザーに対して、ステップ1から5を繰り返します。

アクセス制御リストからのユーザーの削除

アクセス制御リストからユーザーを削除するには、次のようにします。

1. ユーザー名の左側のチェック・ボックスを選択して、削除するユーザーを選択します。

2. 「削除」をクリックします。

ページおよびページ・コンポーネントに対するアクセスの制御

アクセス制御ウィザードでは、アプリケーション・モード・リストのオプションとアクセス制御リストで可能な権限に対応する認可スキームが作成されます。

次の認可スキームの中の1つをページまたはコンポーネント属性ページで選択することで、特定のページまたはページ・コンポーネントへのアクセスを制御できます。

- アクセス制御 - 管理者。管理者権限を持つユーザーのみがページまたはコンポーネントを表示できます。

- アクセス制御 - 編集。編集および管理者権限の両方を持つユーザーがページまたはコンポーネントを表示できます。表示権限を持つユーザーはページまたはコンポーネントを表示できません。

- アクセス制御 - 表示。管理者、編集または表示権限を持つユーザーがページまたはコンポーネントを表示できます。

- 非アクセス制御 - 管理者。管理者権限を持つユーザーはページまたはコンポーネントを表示できません。

- 非アクセス制御 - 編集。編集および管理者権限の両方を持つユーザーはページまたはコンポーネントを表示できません。表示権限を持つユーザーがページまたはコンポーネントを表示できます。

- 非アクセス制御 - 表示。管理者、編集または表示権限を持つユーザーはページまたはコンポーネントを表示できません。

関連項目:
「アプリケーション、ページまたはコンポーネントへの認可スキームの割当て」

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

Web配置のすべてのメリットを失わずに、検出されたクライアント/サーバー・アプリケーションを擬似実行するファンクションを追加する最も有効な方法は、JavaScriptをWebアプリケーションに追加する方法です。Oracle Application Expressには、JavaScript追加専用に設計された複数の組込みインタフェース(フック)が含まれています。

JavaScriptは、データ処理集中型検証には適していません。たとえば、名前が大規模データベース表内に含まれていることを検証するには、大容量のHTMLドキュメントを作成して、すべてのレコードをクライアントにプルダウンする必要があります。通常、複雑な操作には、JavaScriptではなくサーバー・サイドApplication Express検証の方がより適しています。

この項には、次の項目が含まれます。

- JavaScriptを使用したアイテムの参照

- JavaScriptファンクションの組込み

- ボタンからのJavaScriptのコール

関連項目:
「検証の理解」

JavaScriptを使用したアイテムの参照

アイテムを参照する場合、最も有効な方法は、IDで参照する方法です。WebブラウザでOracle Application ExpressページのHTMLソースを表示すると、すべてのアイテムにID属性が含まれていることがわかります。このIDは、アイテム・ラベルではなく、アイテム名に対応します。たとえば、P1_FIRST_NAMEという名前で、First Nameというラベルを持つアイテムを作成した場合、IDはP1_FIRST_NAMEになります。

アイテムIDがわかると、JavaScriptメソッドgetElementByIdを使用してアイテムの属性および値を取得および設定できます。次に、IDでアイテムを参照する方法およびアラート・ボックスにその値を表示する方法の例を示します。

<script language="JavaScript1.1" type="text/javascript">
function firstName(){
alert('First Name is ' + document.getElementById('P1_FIRST_NAME').value );
}
// or a more generic version would be
function displayValue(id){
alert('The Value is ' + document.getElementById(id).value );
}
</script>

// Then add the following to the "Form Element Attributes" Attribute of the item:
onchange="displayValue('P1_FIRST_NAME');"

JavaScriptファンクションの組込み

JavaScriptファンクションを組み込む場所は、主に2つあります。

- ページのHTMLヘッダー属性内

- ページ・テンプレートの.jsファイル内

関連項目:
JavaScriptリテラル文字列内部のショートカットの参照については、「エスケープされた一重引用符を持つJavaScriptのテキスト」を参照してください。

HTMLヘッダー属性へのJavaScriptの統合

JavaScriptをアプリケーションに含める方法の1つとして、JavaScriptをページのHTMLヘッダー属性に追加する方法があります。これは、ページに固有のファンクションに有効な方法であり、ファンクションを.jsファイルに組み込む前にテストを行う有効な方法です。

ページ属性ページのHTMLヘッダー属性にコードを入力するだけで、JavaScriptファンクションをページに追加できます。次の例では、コードを追加することによって、カレント・ページの任意の場所からtestファンクションにアクセスできるようにしています。

HTMLヘッダー属性にJavaScriptコードを追加するには、次のステップを実行します。

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

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

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

4. 「ページ」で、「ページ属性の編集」アイコンをクリックします。

5. 「HTMLヘッダー」までスクロールします。

6. 「HTMLヘッダー」にコードを入力して、「変更の適用」をクリックします。

たとえば、次のコードを追加すると、カレント・ページのすべての場所からアクセス可能なファンクションをテストします。

<script type="text/javascript">
function test(){
window.alert('This is a test.');
}
</script>

関連項目:
「HTMLヘッダー」

ページ・テンプレートによって参照される.jsファイルへのJavaScriptの挿入

Oracle Application Expressではページ・テンプレートで.jsファイルを参照できます。このアプローチによって、そのファイル内のすべてのJavaScriptがアプリケーションにアクセス可能になります。.jsファイルはアプリケーションの最初のページ・ビューにロードされてからブラウザでキャッシュされるため、これは最も効率的なアプローチです。

ページ・テンプレートのヘッダー・セクションに.jsファイルを含める例を次に示します。script src=行が太字になっています。

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<title>#TITLE#</title>
#HEAD#
<script src="http://myserver.myport/my_images/custom.js" type="text/javascript"></script>
</head>
<body #ONLOAD#>#FORM_OPEN#

関連項目:
「ページ・テンプレート」

ボタンからのJavaScriptのコール

リクエストを確認する最も有効な方法は、ボタンからJavaScriptをコールする方法です。実際、Oracle Application Expressでは、ほぼすべてのオブジェクトの削除操作にこの方法を使用します。たとえば、ボタンを削除する場合は、リクエストの確認を求めるJavaScriptメッセージが表示されます。次に例を示します。

<script type="text/javascript">
function deleteConfirm(msg)
{
var confDel = msg;
if(confDel ==null)
confDel= confirm("Would you like to perform this delete action?");
else
confDel= confirm(msg);

if (confDel== true)
doSubmit('Delete');
}
</script>

この例では、削除操作を確認するファンクションを作成した後、ボタンからそのファンクションをコールします。このファンクションは、オプションでページを送信し、内部変数:REQUESTの値をDeleteに設定するため、リクエストの値に基づいて条件付きで実行されるプロセスを使用して削除を実行します。

ボタンの作成時に、「ページを送信せずにURLにリダイレクト」アクションを選択する必要があります。その後、URLターゲットを次のように指定します。

confirmDelete('Would you like to perform this delete action?');

関連項目:
「ウィザードを使用したボタンの作成」

印刷用ページの最適化

特定の印刷用テンプレートを作成し、テーマの作成/編集ページでそのテンプレートを選択することで、印刷用のページを最適化できます。詳細は、「テーマのデフォルトのテンプレートの変更」を参照してください。

一般に、印刷用テンプレートは、印刷用のページを最適化します。たとえば、印刷用テンプレートは、次のことを行います。

- タブまたはナビゲーション・バーを非表示にします。

- アイテムをフォーム要素ではなくテキストとして表示します

選択したテーマに印刷用テンプレートが含まれていない場合、新しいページ・テンプレートを作成することによって印刷用テンプレートを作成できます。

関連項目:
「テーマのデフォルトのテンプレートの変更」、「テーマの作成」および「レポート・リージョンの出力」

この項に含まれる内容は次のとおりです。

- アプリケーションの印刷用テンプレートの選択

- f?p構文を使用した印刷用モードへの切替え

アプリケーションの印刷用テンプレートの選択

印刷用テンプレートを選択するには、次のステップを実行します。

1. テーマ・ページにナビゲートします。

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

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

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

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

2. 「テーマ」リストで、テーマ名をクリックします。
テーマの作成/編集ページが表示されます。

3. 「コンポーネントのデフォルト値」までスクロールして、「「印刷用」ページ」リストを探します。

4. 「「印刷用」ページ」リストから選択します。

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

関連項目:
「テーマのデフォルトのテンプレートの変更」

f?p構文を使用した印刷用モードへの切替え

印刷用テンプレートを作成して選択した後、f?p構文を使用して印刷用モードに切り替えることができます。f?p構文の9番目の引数(PrinterFriendly)を指定すると、ページが印刷用(印刷用に最適化された)モードでレンダリングされます。たとえば、リンクのコーディング時、またはナビゲーション・バー・アイコンの作成時に、この引数を含めることができます。

関連項目:
「f?p構文を使用したページのリンク」

ヘルプ・ページの作成

アプリケーション・ビルダーには、アプリケーションのヘルプを作成するための組込み属性が含まれています。アプリケーションのヘルプを作成するには、次のステップを実行します。

1. 専用のヘルプ・ページおよび「ヘルプ」リージョンの作成

2. ページ・ヘルプ・テキストの定義

3. アイテム・ヘルプ・テキストの定義

4. ヘルプ・ページにリンクするためのナビゲーション・バー・アイコンの作成

アプリケーション・ビルダーで作成したヘルプは、専用の「ヘルプ」ページに表示されます。ヘルプを表示するには、専用の「ヘルプ」ページへのリンクをクリックします。この「ヘルプ」ページには、表示しているページに固有のページ・ヘルプおよびアイテム・ヘルプのトピックが表示されます。

この項に含まれる内容は次のとおりです。

- ヘルプ・ページおよびヘルプ・リージョンの作成

- ヘルプ・テキストの定義

- ヘルプ・ナビゲーション・バー・エントリの作成

ヘルプ・ページおよびヘルプ・リージョンの作成

アプリケーションのヘルプを作成するための最初のステップは、専用のページおよび「ヘルプ・テキスト」リージョンを作成することです。

「ヘルプ・テキスト」リージョンを作成するには、次のステップを実行します。

1. ヘルプ用のページを作成します。「アプリケーション内のページの管理」を参照してください。

2. ヘルプ・ページのページ定義にナビゲートします。「ページ定義へのアクセス」を参照してください。

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

4. リージョン・タイプを選択するプロンプトが表示されたら、「ヘルプ・テキスト」を選択します。

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

ヘルプ・テキストの定義

ページまたは1つのアイテムのヘルプ・テキストを定義するには、属性を編集します。アプリケーションの作成時にこれらの属性を定義することをお薦めします。次のステップでは、簡略化のために、これらの属性を定義した後にヘルプのテキストを定義する方法について説明します。

関連項目:
「アイテム・ヘルプ」

この項に含まれる内容は次のとおりです。

- ページ用のヘルプの定義

- アイテム用のヘルプ・テキストの定義

- 複数のアイテム・ヘルプ・トピックの同時編集

ページ用のヘルプの定義

ページ・ヘルプ・テキストを定義するには、次のステップを実行します。

1. ページ・ヘルプを追加するページのページ定義にナビゲートします。「ページ定義へのアクセス」を参照してください。

2. 「ページ」で、「ページ属性の編集」アイコンをクリックして、既存のページ属性を表示します。

3. 「ヘルプ」までスクロールします。

4. 表示されたフィールドにヘルプ・テキストを入力します。

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

ページ・ヘルプ・テキストが必要な各ページに対して、これらのステップを実行します。

アイテム用のヘルプ・テキストの定義

アイテムのアイテム・ヘルプ・テキストを定義するには、次のステップを実行します。

1. アイテム・ヘルプを追加するページのページ定義にナビゲートします。「ページ定義へのアクセス」を参照してください。

2. 「アイテム」で、編集するアイテム名をクリックします。

3. 「ヘルプ・テキスト」までスクロールします。

4. 表示されたフィールドにヘルプ・テキストを入力します。

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

ヘルプ・テキストが必要な各アイテムに対して、これらのステップを実行します。

複数のアイテム・ヘルプ・トピックの同時編集

アプリケーションにアイテム・ヘルプを含める場合は、「アイテム・ヘルプをバルク編集」レポートを使用して、アイテム・ヘルプの複数のトピックを一度に編集できます。

「アイテム・ヘルプをバルク編集」レポートへのアクセス

「アイテム・ヘルプをバルク編集」レポートを表示するには、次のステップを実行します。

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

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

3. 「タスク」リストで、「アプリケーション・レポート」をクリックします。

4. 「ページ・コンポーネント」をクリックします。

5. 「アイテム」で、「アイテム・ヘルプ・テキスト」をクリックします。
レポートがページの下部に表示されます。

6. アイテム・ヘルプのバルクレポートでは、次の操作が可能です。

- 既存のヘルプ・トピックを更新できます。表示されるヘルプ・テキストを編集し、「変更の適用」をクリックします。

- ページ番号をクリックして、アイテムが含まれているページ定義にリンクできます。

- アイテム名をクリックして、ページ・アイテムにリンクできます。

アイテム・ヘルプ・トピックのシード

アプリケーションにアイテム・ヘルプが含まれていない場合は、デフォルトのヘルプ・テキストの一括更新を実行します。

アイテム・ヘルプ・トピックをシードするには、次のステップを実行します。

1. 前述のトピックの説明に従って「アイテム・ヘルプをバルク編集」レポートにアクセスします。

2. 「アイテム・ヘルプ・テキストのシード」をクリックします。

3. 「デフォルトのヘルプ・テキスト」で、すべてのヘルプ・トピックに表示されるデフォルト・テキストを入力します。

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

既存のアイテム・ヘルプ・トピックの検索

既存のヘルプ・テキストまたはアイテム・ラベルを検索できます。

既存のアイテム・ヘルプ・トピックを検索するには、次のステップを実行します。

1. 「ヘルプの内容」にキーワードを入力します。

2. 「実行」をクリックします。

アイテム・ラベルの検索

アイテム・ラベルを検索するには、次のステップを実行します。

1. 「ヘルプの内容」にキーワードを入力します。

2. 「実行」をクリックします。

関連項目:
「アプリケーション・レポートの表示」

ヘルプ・ナビゲーション・バー・エントリの作成

ヘルプを作成したら、次に、ユーザーがリンクに使用するためのナビゲーション・バー・エントリを作成します。

ナビゲーション・バー・エントリを作成するには、次のステップを実行します。

1. ページ定義にナビゲートします。「ページ定義へのアクセス」を参照してください。

2. 「ナビゲーション・バー」で、「作成」アイコンをクリックします。

3. 「属性」で、次のステップを実行します。

1. 順序: このコンポーネントの順序を指定します。これによって評価の順序が決まります。

2. altタグ・テキスト: イメージのナビゲーション・アイテムであるaltテキストを入力します。イメージ名を指定しないと、このテキストが表示されます。

3. アイコン・イメージ名: 表示されるイメージの名前を入力します。

4. イメージの高さ: イメージの高さを入力します。

5. イメージの幅: イメージの幅を入力します。

6. テキスト: イメージとともに表示する追加テキストを入力します。テキストを含めるか、テキストなしのアイコンを使用することができます。この属性はオプションであり、翻訳可能です。

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

次に、ターゲット位置を指定します。

4. 「ターゲット」で、次のステップを実行します。

1. ターゲットは: 「このアプリケーションのページ」を選択します。

2. ページ: 「ヘルプ・ページおよびヘルプ・リージョンの作成」で作成したヘルプ・ページのページ番号を指定します。

3. リクエスト: 次を入力します。

&APP_PAGE_ID.

「リクエスト」に置換文字列&APP_PAGE_IDを指定することによって、Application Expressエンジンに対して、ユーザーがこのアイコンをクリックした場合にカレント・ページのヘルプ・テキストを表示するように指示します。

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

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

8 ナビゲーションの追加

アプリケーションを構築する際、ナビゲーション・バー・エントリ、タブ、ブレッドクラム、リスト、ツリーを含む、様々なタイプのナビゲーション・コントロールを含めることができます。このセクションでは、アプリケーションでナビゲーションを実装する方法について説明します。

ナビゲーション・コントロールは共有コンポーネントなので、共有コンポーネント・ページのアプリケーション・レベルで特定のタイプのナビゲーション・コントロールを作成します。その後、アプリケーション内のすべてのページにそれらを追加できます。

この項には、次の項目が含まれます。

- タブの作成

- リストの作成

- ブレッドクラムの作成

- ツリーの作成

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

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

関連項目:
「共有コンポーネントでの作業」

タブの作成

タブは、アプリケーションのページ間でのナビゲートに有効な方法です。親タブ、標準タブおよびリストを使用して、アプリケーションのタブ付きの外観を作成できます。

アプリケーション・ビルダーには、次の2つのタイプのタブが含まれています。

- 標準タブ
タブが1レベルのみのアプリケーションでは、標準タブ・セットを使用します。標準タブ・セットは、特定のページおよびページ番号に関連付けられます。標準タブを使用すると、特定のページにユーザーをリンクできます。

- 親タブ
親タブ・セットは、標準タブのグループを保持するコンテナとして機能します。親タブによって、別のレベルのナビゲーションおよびアプリケーション内のコンテキスト(または場所)が提供されます。ユーザーが特定のページに関連付けられた特定のURLにリンクするために親タブを使用できます。

この項に含まれる内容は次のとおりです。

- テンプレートのサポートについて

- ページ定義の「タブ」セクションについて

- 「タブの順序変更」アイコンの使用

- タブ・ページについて

- タブの作成方法

- タブの編集

- タブ・レポートへのアクセス

注意:
アプリケーションの作成ウィザードを実行すると、オプションで、タブ付きのアプリケーションを作成できます。次のステップでは、タブ付きでないアプリケーションを作成済であると想定しています。

関連項目:
「アプリケーションの作成」

テンプレートのサポートについて

親タブおよび標準タブを作成する前に、デフォルトのテンプレートで、適切な置換文字列を使用して標準タブおよび親タブの両方に位置を定義していることを確認する必要があります。このテンプレートは、ページ・レベルで上書きしないでください。

関連項目:

- アプリケーション・レベルでデフォルトのページ・テンプレートを設定する方法については、「テンプレートのデフォルト」を参照してください。

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

ページ定義の「タブ」セクションについて

ページ定義でタブを作成および編集できます。「タブ」は「共有コンポーネント」セクションの下に表示されます。

「共有コンポーネント」タイトルの「タブ」アイコンをクリックすると、他のすべての「共有コンポーネント」サブセクションを一時的に非表示にできます。表示を元に戻すには、「すべての表示」をクリックします。「すべて表示」アイコンは、下向き三角形の形をしています。

「タブ」セクションに次のアイコンが表示されます。

- すべて編集: 「すべて編集」アイコンは、鉛筆が置かれた小さいグリッドの形をしています。このアイコンを使用して、すべてのタブを一度に編集できます。

- 作成: 「作成」アイコンは、プラス(+)記号が置かれた小さいページの形をしています。タブを新規作成するには、このアイコンをクリックします。

- 並替え: 「並替え」アイコンは、薄い緑色の上下矢印の形をしています。タブのラベルおよび位置を編集するには、このアイコンをクリックします。

タブを編集するには、タブ名をクリックします。

関連項目:
「タブ・ページについて」および「「タブの順序変更」アイコンの使用」

「タブの順序変更」アイコンの使用

「タブの順序変更」アイコンをクリックすると、ラベルおよびタブの位置を簡単に編集できます。ページ定義の「タブ」セクションに表示されます。このアイコンは、薄い緑色の上下矢印の形をしています。

「タブの順序変更」アイコンを使用してタブを編集するには、次のステップを実行します。

1. 該当するページ定義にナビゲートします。「ページ定義へのアクセス」を参照してください。

2. 「タブ」で、「タブの順序変更」アイコンをクリックします。
タブの順序変更ページが表示されます。

3. 次の該当する情報を編集します。

1. ラベル - タブのラベルを入力します。

2. ページ - タブに対応するページ番号を入力します。

3. カレント・タブ: このタブに対応するその他のページをリストします。複数のページを入力するには、次のように、一連のページをカンマで区切って入力します。次に例を示します。

11,12,13,14,29,14

4. タブの表示順序を変更するには、一番右の列の上下矢印をクリックします。

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

タブ・ページについて

タブ・ページには、アプリケーションで定義されたタブがグラフィカルに表示されます。タブ・ページには、共有コンポーネント・ページから、または「ページ定義」の「タブ」ヘッダーをクリックしてアクセスします。

タブの作成方法

タブ・ページから親タブまたは標準タブを作成します。

タブを作成するには:

1. タブ・ページにアクセスします。
共有コンポーネント・ページからタブ・ページにアクセスするには、次のステップを実行します。

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

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

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

4. 「ナビゲーション」で、「タブ」をクリックします。

ページ定義からタブ・ページにアクセスするには、次のステップを実行します。

1. 該当するページ定義にナビゲートします。「ページ定義へのアクセス」を参照してください。

2. 「共有コンポーネント」で、「タブ」セクションの「作成」アイコンをクリックします。

2. タブを作成するには:

1. 適切な行で「追加」をクリックします。

- 上の行の「追加」ボタンを使用して、「親」タブを追加します。
親タブは、標準タブを保持するためのコンテナであると考えます。たとえば、2つのレベルのタブを追加するには、最初に親タブを作成し、次にこの親タブに標準タブを追加します。

- 下の行の「追加」ボタンを使用して、「標準」タブを追加します。

親タブの作成ウィザードまたは標準タブの作成ウィザードが表示されます。

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

タブの編集

複数のタブを同時に編集できます。また、標準タブを使用している場合は、「標準タブのタスク」リストを使用して、ラベルや順序などのタブのプロパティを更新できます。

複数のタブの同時編集

複数のタブを同時に編集できます。

複数のタブを同時に編集するには、次のステップを実行します。

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

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

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

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

4. 「ナビゲーション」で、「タブ」をクリックします。

2. 次のいずれかのボタンをクリックします。

- 標準タブの編集

- 親タブの編集

「標準タブのタスク」リストの使用

「標準タブのタスク」リストが「タブ」ページの右側に表示されます。このリスト上のリンクにアクセスすると、標準タブ・セットの名前の変更、表示順序の変更、タブ・セットへのページの関連付け、新規標準タブの作成または新規標準タブ・セットの作成ができます。

「標準タブのタスク」リストにアクセスするには、次のステップを実行します。

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

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

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

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

4. 「ナビゲーション」で、「タブ」をクリックします。

2. 「標準タブのタスク」リストから次の項目を選択します。

- 標準タブ・セット名の変更

- 表示順序の変更

- 選択した標準タブでページを関連付け

- 新しい標準タブの作成

- 新しい標準タブ・セットの作成

タブ・レポートへのアクセス

タブ・マネージャ・ページ上部の該当するタブをクリックすると、タブの使用状況およびタブ履歴レポートを表示できます。

標準タブの使用状況

「使用状況」をクリックすると、「標準タブの使用状況」レポートにアクセスできます。このレポートには、カレント・アプリケーションで使用される標準タブが表示されます。

標準タブ履歴および親タブ履歴

「履歴」をクリックすると、標準タブ履歴および親タブ履歴レポートが表示されます。これらのレポートには、カレント・アプリケーションのタブ属性への変更の履歴が表示されます。

リストの作成

リストは、リンクの共有コレクションです。リージョンを作成してリージョン・タイプを「リスト」に指定することによって、リストをページに追加します。リストの外観は、リスト・テンプレートで制御します。

各リスト要素には、いつ表示するかを制御できる表示条件があります。特定のページのカレントまたは非カレントとしてリスト要素を定義できます。テンプレート属性を使用してカレントの外観を指定することもできます。

この項に含まれる内容は次のとおりです。

- リストの作成方法

- ページへのリストの追加

- リストの編集

- 複数のリスト・エントリの同時編集

- リスト・レポートへのアクセス

関連項目:
リスト表示の変更方法については、「新しいテンプレートの作成」および「リスト・テンプレート」を参照してください。

リストの作成方法

アプリケーションのページにリストを追加するには、次のステップを実行します。

1. 次の方法のうち1つを使用してリストを作成します。

- 共有コンポーネント・ページか「ページ定義」のいずれかから、リストの作成/編集ウィザードを実行してリストを最初から作成します。

- 既存のリストをコピーします。リストにアイテムまたはエントリが含まれる場合、アイテムもコピーされます。

2. リストにエントリを追加します。

- リスト・エントリを最初から作成します。

- 現行のリストから単一のリスト・エントリをコピーします。これによってリスト・エントリの属性がコピーされます。

- その他のリストから現行のリストへリスト・エントリをコピーします。これによって現行リストにコピーされるエントリのリストを変更することなく、2つのリスト・エントリがマージされます。

3. リスト・リージョンを作成して、ページにリストを作成します。

この項に含まれる内容は次のとおりです。

- リストを最初から作成

- リストのコピー

- リスト・エントリとサブリストの追加

- リスト・エントリの親の変更

- 孤立リスト・エントリの親の削除

リストを最初から作成

リストを作成するには、次の手順を実行します。

1. リストの作成/編集ウィザードへのアクセス
共有コンポーネント・ページからウィザードにアクセスするには、次のステップを実行します。

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

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

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

4. 「ナビゲーション」で、「リスト」をクリックします。

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

「ページ定義」からウィザードにアクセスするには、次のステップを実行します。

1. 該当するページ定義にナビゲートします。「ページ定義へのアクセス」を参照してください。

2. 「共有コンポーネント」で、「リスト」セクションの「作成」アイコンをクリックします。

2. 作成/編集のウィザードで、次のステップを実行します。

1. 名前 - リストの名前を入力します。

2. リスト・テンプレート - リスト・テンプレートを選択します。

3. ビルド・オプション: このコンポーネントのビルド・オプションを選択します(使用可能な場合)。ビルド・オプションは、アプリケーション内のコンポーネントが有効かどうかを判別する事前定義された設定です。

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

リストのコピー

リストをコピーするには、次のステップを実行します。

1. リストのコピー・ウィザードへのアクセス
共有コンポーネント・ページからウィザードにアクセスするには、次のステップを実行します。

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

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

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

4. 「ナビゲーション」で、「リスト」をクリックします。

5. 「コピー」をクリックします。

「ページ定義」からウィザードにアクセスするには、次のステップを実行します。

1. 該当するページ定義にナビゲートします。「ページ定義へのアクセス」を参照してください。

2. 「共有コンポーネント」で、「リスト」セクションの「コピー」アイコンをクリックします。
このページにリストが存在する場合にのみ「コピー」アイコンが表示されます。

2. コピー・ウィザードで、コピーするリストの位置を選択して、「次へ」をクリックします。

3. 「別のアプリケーションのリスト」を選択した場合、アプリケーションを選択して、「次へ」をクリックします。

4. 「リストを指定」で、新しいリストの名前を入力して、「コピー」をクリックします。

ページにリストを表示するには、ページにリストを追加する必要があります。

リスト・エントリとサブリストの追加

リストの作成後、リストにエントリを追加する必要があります。リスト・エントリを最初から作成すること、あるリスト・エントリをリスト内でコピーすること、または既存のエントリをあるリストから別のリストにコピーすることが可能です。

サブリストを含む階層的なリストも作成できます。階層的なリストを作成するには、次のステップを実行します。

- 階層的なリストをサポートするリスト・テンプレートを選択します。階層的なリストをサポートするリスト・テンプレートを判別するには、サブリスト付きというネーミング規則のあるテンプレートを検索します。

- 各リスト・エントリの作成時には親リスト・アイテムを選択します。

関連項目:
「テンプレートのカスタマイズ」および「リスト・テンプレート」

エントリまたはサブリストを最初から追加

エントリまたはサブリストを最初から追加するには、次のステップを実行します。

1. リスト・ページにナビゲートします。

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

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

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

4. 「ナビゲーション」で、「リスト」を選択します。
リスト・ページが表示されます。

2. リストを選択します。

3. 「リスト・エントリの作成」をクリックします。
リスト・エントリの作成/編集ページが表示されます。

4. 「エントリ」で、次の項目を指定します。

1. 親リスト・アイテム - このリスト・エントリの親を指定します。サブリストを含む階層的なリストを作成する場合は、この属性を使用します。

2. 順序 - リスト・エントリを表示する順序を指定します。

3. イメージ: このリスト・エントリの表示に使用するイメージのファイル名を指定します。この属性の制御はリスト・テンプレートによって行われます。

4. 属性 - リスト要素イメージのイメージ属性(width="12" height="12"など)を指定します。
リスト・ラベル・テキストを参照するには、#LIST_LABEL#置換文字列を使用します。この置換文字列を使用すると、リスト・ラベル・テキストの値に基づいてタイトル・イメージ属性を自動的に設定できます。次に例を示します。

title="#LIST_LABEL#"

5. リスト・エントリ・ラベル: このリンクのラベル・テキストを入力します。

5. ターゲット位置を指定します。
ターゲット位置がURLの場合、次のように指定します。

- ターゲットは: 「URL」を選択します。

- URLターゲット: URLを入力します。次に例を示します。

http://www.yahoo.com

ターゲット位置がページの場合、次のステップを実行します。

1. ターゲット・タイプ: 「このアプリケーションのページ」を選択します。

2. ページ: ターゲット・ページ番号を指定します。
「このページのページ区切りをリセット」を選択することもできます。このオプションを選択すると、ユーザーの新規問合せに合うデータの最初のセットにページが戻されます。

「印刷用」も選択できます。このオプションを選択すると、アプリケーションの「印刷用」テンプレートを使用するターゲット・ページが表示されます。「印刷用」テンプレートにより、印刷用ページが最適化されます。「テーマのデフォルトのテンプレートの変更」および「印刷用ページの最適化」を参照してください。

3. リクエスト: 使用するリクエストを指定します。

4. キャッシュのクリア: キャッシュをクリアするページ番号を指定します。

5. セッション・ステートを設定するには(リストされたアイテムに値を与えます)、次のステップを実行します。

- 「次のアイテムを設定」で、セッション・ステートを設定するアイテム名をカンマで区切って入力します。

- 「次の値を使用」で、前述のステップで指定したアイテムの値をカンマで区切って入力します。
静的な値または置換構文(&APP_ITEM_NAME.など)を指定できます。URLのf?p=に渡されるアイテム値にはコロン(:)を使用しないでください。また、バックスラッシュでアイテム値全体を囲んだ場合(\1234,56\など)を除いて、カンマも使用しないでください。

6. カレント・リスト・エントリの項目は次のとおりです。

1. リスト・エントリがカレントとなるページ・タイプ: ページ・タイプに基づいて、このリスト・エントリがカレントとなる時点を指定します。
リスト・アイテムはカレントまたは非カレントにできます。カレント・リスト・アイテムではカレント・テンプレートが使用され、非カレント・リスト・アイテムでは非カレント・リスト・アイテム・テンプレートが使用されます。実際の条件およびテンプレートは後続の属性で定義されます。

2. リスト・エントリがカレントとなる条件 - 先に選択した内容に基づいて、評価する条件を定義します。この条件がTRUEの場合は、リスト・アイテムがカレントになります。

7. リスト・エントリを条件付きにするには、「条件」で適切な情報を指定します。

8. 「認可」で、認可スキームを指定できます。
この認可スキームは、このコンポーネントをレンダリングまたは処理するためにTRUEと評価される必要があります。

9. 「構成」で、このコンポーネントのビルド・オプションを選択できます。
ビルド・オプションは、アプリケーション内のコンポーネントが有効かどうかを判別する事前定義された設定です。

10. 「クリック・カウント」で、リスト・エントリをクリック・カウントに含むかどうかを指定できます。
これがwww.google.comのような外部ページへのリンクである場合、クリックをカウントできます。詳細は、Oracle Application Express APIリファレンスの「COUNT_CLICKプロシージャ」を参照してください。

11. 追加属性を指定するには、「ユーザー定義属性」セクションを使用します。たとえば、次にtabindexやaccesskeyを追加します。

tabindex="15" accesskey="D"

12. リスト属性の定義の終了後、「作成」または「作成後、別のものの作成」をクリックします。

リスト・エントリのコピー

リスト・エントリをコピーするには、次のステップを実行します。

1. リスト・エントリ・ページにナビゲートします。

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

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

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

4. 「ナビゲーション」で、「リスト」を選択します。
リスト・ページが表示されます。

5. リスト・ページで、コピーするエントリのリスト名をクリックします。
リスト・エントリ・ページが表示されます。

2. 現行リストに表示される単一リスト・エントリをコピーするには、次のステップを実行します。

1. コピーする行で「コピー」アイコンをクリックします。「コピー」アイコンは、リスト内の「コピー」列に表示されます。
イメージや親など、選択したリスト・エントリのすべての属性は、新規エントリにコピーされます。

2. 「リスト・エントリのコピー」で、適切な情報を入力して「リスト・エントリのコピー」をクリックします。

3. 1つのリストからその他のリストにリスト・エントリをコピーするには、次のステップを実行します。

1. ページ右側にある「タスク」リストで、「あるリストから別のリストへのリスト・エントリのコピー」をクリックします。

2. 「コピーのターゲットを指定」で、エントリを追加するターゲット・リストを選択し、「次へ」をクリックします。

3. 「リスト・エントリのコピーの確認」で、「新規の結合リストのレポート」をクリックして、「コンポジット」リストを確認します。

4. 「リスト・エントリのコピー」をクリックします。

リスト・エントリの親の変更

リスト・エントリの親を変更するには、次のステップを実行します。

1. リスト・エントリ・ページにナビゲートします。

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

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

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

4. 「ナビゲーション」で、「リスト」を選択します。
リスト・ページが表示されます。

5. リスト・ページで、更新するエントリのリスト名をクリックします。
リスト・エントリ・ページが表示されます。

2. 右側にある「タスク」リストで、「このリスト内におけるリスト・エントリの親の変更」をクリックします。

3. リスト・エントリの親の変更ページで、次のステップを実行します。

1. リストおよび開始に関する適切な情報を入力して、「実行」をクリックします。
「開始」フィールドを使用して、親を変更する必要のあるエントリを特定するために、大きな階層的なリストをフィルタ処理できます。また、これらのフィールドを使用して、編集するリストのサブセットに絞り込むことができます。

2. 「親の変更先」で、リスト・エントリの新しい親を選択します。

3. 含めるリスト・エントリのチェック・ボックスを選択します。

4. 「チェックしたエントリの親の変更」をクリックします。

孤立リスト・エントリの親の削除

孤立リスト・エントリとは、親が現在のリストのメンバーではないリスト・エントリです。リスト・エントリが孤立している場合は、親のエントリを削除します。

孤立リスト・エントリの親を削除するには、次のステップを実行します。

1. リスト・エントリ・ページにナビゲートします。

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

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

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

4. 「ナビゲーション」で、「リスト」を選択します。
リスト・ページが表示されます。

5. リスト・ページで、更新するエントリのリスト名をクリックします。
リスト・エントリ・ページが表示されます。

2. 右側にある「タスク」リストで、「孤立リスト・エントリの管理」をクリックします。

3. 孤立リスト・エントリの管理ページで、次のステップを実行します。

1. 「表示」リストから「孤立」を選択し、「実行」をクリックします。

2. 孤立リスト・エントリのチェック・ボックスを選択します。

3. 「親エントリの削除」をクリックします。

ページへのリストの追加

リストとリスト・エントリの作成後、リージョンを作成してリージョン・タイプを「リスト」に指定することによって、このリストをページに追加します。

関連項目:
リスト表示の変更方法については、「新しいテンプレートの作成」および「リスト・テンプレート」を参照してください。

ページにリストを追加するには、次のステップを実行します。

1. 該当するページ定義にナビゲートします。「ページ定義へのアクセス」を参照してください。

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

3. 「リージョン」で、リージョン・タイプとして「リスト」を選択し、「次へ」をクリックします。

4. 「表示」で、適切な情報を指定して「次へ」をクリックします。

- タイトル - リージョンのタイトルを入力します。選択するリージョン・テンプレートにリージョン・タイトルが表示されると、このタイトルが表示されます。

- リージョン・テンプレート: リージョンの外観を制御するテンプレートを選択します。

- 表示ポイント: このリージョンの表示ポイントを指定します。

- ページ・テンプレート・ボディ - これらの位置は、ページ・テンプレートの#BODY#置換文字列によって示される場所を表示します。

- ページ・テンプレート・リージョン - これらの位置は、ページ・テンプレートの置換文字列(#REGION_POSITION_01#..#REGION_POSITION_08#)で制御されます。ページ・テンプレート・リージョンの位置によって、テンプレート内にリージョンを正確に配置できます。

- 順序: このコンポーネントの順序を指定します。これによって評価の順序が決まります。

- 列 - このリージョンを表示する列を指定します。1つのページに複数のリージョンを配置でき、それらのリージョンを異なる列に表示できます。この属性はページ・テンプレート・ボディ位置に表示されるリージョンのみに適用されることに注意してください。

5. 「ソース」で、追加するリストを選択します。

6. 「リスト・リージョンの作成」をクリックします。

リストを追加する各ページに対して、これらのステップを実行します。

リストの編集

作成したリストは、リスト・ページで編集できます。

リストを編集するには、次のステップを実行します。

1. リスト・ページにナビゲートします。
ページ定義から、次の操作を実行します。

1. 「ワークスペース」ホームページにナビゲートします。

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

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

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

5. 「共有コンポーネント」で、「すべて編集」をクリックします。

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

1. 「ワークスペース」ホームページにナビゲートします。

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

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

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

5. 「ナビゲーション」で、「リスト」をクリックします。

2. リスト・ページで、「ビュー」リストから選択して、ページの外観を変更できます。

- アイコン(デフォルト): 各リストを大きいアイコンとして表示します。リストを編集するには、該当するアイコンをクリックします。

- 詳細: 各リストをレポートで1行に表示します。リストを編集するには、リスト名をクリックします。

3. リストを選択します。
リスト・エントリ・ページが表示されます。

4. 適切なリスト名を選択します。
リスト・エントリの作成/編集ページは複数のセクションに分かれています。これらのセクションにアクセスするには、ページをスクロール・ダウンするか、ページ上部のナビゲーション・ボタンをクリックします。ページ上部のボタンを選択すると、選択されたセクションが表示され、その他のセクションはすべて一時的に非表示になります。ページのすべてのセクションを表示するには、「すべて表示」をクリックします。

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

6. ページ上の特定のアイテムの詳細を表示するには、アイテム・ラベルをクリックします。
ヘルプが利用できる場合は、アイテム・ラベル上にカーソルを重ねると、アイテム・ラベルが赤色に変わり、カーソルが矢印と疑問符に変わります。「フィールドレベル・ヘルプについて」を参照してください。

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

複数のリスト・エントリの同時編集

リスト・エントリ・ページの「グリッド編集」をクリックすると、複数のリスト・エントリを同時に編集できます。

複数のリスト・エントリを一度に編集するには、次のステップを実行します。

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

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

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

4. 「ナビゲーション」で、「リスト」をクリックします。
リスト・ページが表示されます。

5. リスト名を選択します。
リスト・エントリ・ページが表示されます。

6. 「グリッド編集」をクリックします。

7. 該当するアイテムを編集し、「変更の適用」をクリックします。

リスト・レポートへのアクセス

「リスト」ページ上部の該当するタブをクリックすると、ページ別のリストの使用状況、未使用のリストおよびリスト履歴のレポートを表示できます。

注意:
「リストの使用状況」、「未使用のリスト」および「履歴」ボタンが表示されるのは、リストを作成した後のみです。

使用状況

リスト・ページで「リストの使用状況」をクリックして、「リストの使用状況」レポートにアクセスします。このレポートに、カレント・アプリケーションに含まれるすべてのリストが表示されます。このレポートでは、次の項目を実行できます。

- リスト・エントリを編集するには、リスト名を選択します。

- リストに表示されるページを表示するには、「ページ」列の番号をクリックします。

- リストで使用されているテンプレートを表示するには、「リスト・テンプレートの使用状況」をクリックします。表示または編集するリスト・テンプレートの名前をクリックします。

未使用

リスト・ページで「未使用」をクリックして、カレント・アプリケーションで使用されていないリストを識別します。

履歴

リスト・ページで「履歴」をクリックすると、リスト定義およびリスト・エントリに対する変更が開発者および日付ごとに表示されます。

ブレッドクラムの作成

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

この項に含まれる内容は次のとおりです。

- ブレッドクラムについて

- ブレッドクラムの作成方法

- ブレッドクラムの編集

- ブレッドクラム・エントリの親の変更

- ブレッドクラム・レポートへのアクセス

関連項目:
「テーマの作成」および「ブレッドクラム・テンプレート」

ブレッドクラムについて

ブレッドクラムは、アプリケーション内のどの部分が表示されているかを階層で示します。さらに、特定のブレッドクラムをクリックすると、すぐにページを表示できます。各ページの上部でナビゲーションの第2レベルとしてブレッドクラムを使用し、タブおよびリストなどの他のユーザー・インタフェース要素を補完します。

ブレッドクラムの作成方法

ページの作成中にブレッドクラムを作成できます。または、ブレッドクラムの作成ウィザードを実行して手動で作成します。

この項に含まれる内容は次のとおりです。

- ページ作成中のブレッドクラムの作成

- ブレッドクラムの手動作成

ページ作成中のブレッドクラムの作成

ページの作成中にブレッドクラムを作成するには、次のステップを実行します。

1. ページの作成ウィザードを実行して、新規ページを追加します。「アプリケーション内のページの管理」を参照してください。このウィザードにアクセスする方法を次に示します。

- アプリケーションのホームページで「ページの作成」をクリックする

- 「ページ定義」で「作成」をクリックする

- 「開発者」ツールバーで「作成」リンクをクリックする

ウィザードの途中で、「ブレッドクラム」リストが表示されます。このリストが表示される実際のページは、作成するページのタイプによって異なります。

2. 「ブレッドクラム」リストから、「ブレッドクラム」を選択します。
「ブレッドクラム・エントリの作成」フォームが表示されます。

3. 「エントリ名」にブレッドクラムの名前を入力します。

4. 「親エントリ」で、次のようにします。

- 親を指定するには、「親エントリの選択」リストから親ページを選択します。

- このブレッドクラムに親がない場合は、「親ブレッドクラム・エントリなし」を選択します。

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

ブレッドクラムの手動作成

ブレッドクラムを手動で作成するには、次のように、アプリケーションの各ページにブレッドクラムを追加する必要があります。

1. 共有コンポーネント・ページ、または「ページ定義」のどちらかから、ブレッドクラムの作成/編集ウィザードを実行することによりブレッドクラムを作成します。

2. エントリを追加します。

3. リージョンを作成して、ブレッドクラムをページに追加します。

共有コンポーネント・ページからのブレッドクラムの作成

共有コンポーネント・ページからブレッドクラムを作成するには、次のステップを実行します。

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

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

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

4. 「ナビゲーション」で、「ブレッドクラム」をクリックします。
ブレッドクラム・ページが表示されます。

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

6. 名前を入力して、「作成」をクリックします。

ページ定義からのブレッドクラムの作成

ページ定義からブレッドクラムを作成するには、次のステップを実行します。

1. 該当するページ定義にナビゲートします。「ページ定義へのアクセス」を参照してください。

2. 「共有コンポーネント」で、「ブレッドクラム」までスクロールし、「作成」をクリックします。

3. 「作成」では、「ブレッドクラム」を選択し、「次へ」をクリックします。

4. 名前を入力して、「作成」をクリックします。

ブレッドクラムを作成したら、エントリを追加します。

ブレッドクラム・エントリの追加

ブレッドクラム・エントリを追加するには、次のステップを実行します。

1. ブレッドクラム・ページにナビゲートします。

1. 「ワークスペース」ホームページにナビゲートします。

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

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

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

5. 「ナビゲーション」で、「ブレッドクラム」をクリックします。
ブレッドクラム・ページが表示されます。

2. エントリを追加するブレッドクラムを選択します。

3. 「ブレッドクラム・エントリの作成」をクリックします。

4. 「ブレッドクラム」で、ブレッドクラム・エントリが表示されるページを指定します。

5. 「エントリ」で、次の項目を指定します。

1. 順序: ブレッドクラム・エントリを表示する順序を指定します。

2. 親エントリ: このエントリの親を指定します。

3. 短縮名: (ブレッドクラム・テンプレートで参照される)このエントリの短縮名を指定します。

4. 詳細な名前: (ブレッドクラム・テンプレートで参照される)このエントリの詳細な名前を指定します。

6. 「ターゲット」で、ターゲット位置を指定します。ページに表示される情報は、選択したブランチ・タイプによって異なります。

1. ターゲット位置がURLの場合、次のように指定します。

- ターゲットは: 「URL」を選択します。

- URLターゲット: URLを入力します。次に例を示します。

http://www.yahoo.com

2. ターゲット位置がページの場合、次を指定します。

- ターゲットは: 「このアプリケーションのページ」を選択します。

- ページ: ターゲット・ページ番号を指定します。
「このページのページ区切りをリセット」を選択することもできます。このオプションを選択すると、ユーザーの新規問合せに合うデータの最初のセットにページが戻されます。

- リクエスト: 使用するリクエストを指定します。

- キャッシュのクリア: キャッシュをクリアするページ番号を指定します。

3. セッション・ステートを設定するには(リストされたアイテムに値を与えます)、次のステップを実行します。

- 「次のアイテムを設定」で、セッション・ステートを設定するアイテム名をカンマで区切って入力します。

- 次の値を使用: 指定したアイテムの値をカンマで区切って入力します。
静的な値または置換構文(&APP_ITEM_NAME.など)を指定できます。URLのf?p=に渡されるアイテム値にはコロン(:)を使用しないでください。また、バックスラッシュでアイテム値全体を囲んだ場合(\1234,56\など)を除いて、カンマも使用しないでください。

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

7. ブレッドクラムを条件付きにするには、次のステップを実行します。

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

2. 表示されるフィールドに式を入力します。

8. 「認可」で、認可スキームを指定できます。
この認可スキームは、このコンポーネントをレンダリングまたは処理するためにTRUEと評価される必要があります。

9. 「構成」で、このコンポーネントのビルド・オプションを選択できます。
ビルド・オプションは、アプリケーション内のコンポーネントが有効かどうかを判別する事前定義された設定です。

10. メニュー属性の定義の終了後、ページ上部の「作成」をクリックします。

作成する必要がある各ブレッドクラム・エントリに対して、これらのステップを実行します。

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

リージョンはページ上の領域で、コンテンツのコンテナとして機能します。ブレッドクラムおよびブレッドクラム・テンプレートを作成した後、リージョンを作成します。リージョンを作成すると、ページにブレッドクラムを追加できます。

関連項目:
メニュー表示の変更方法については、「新しいテンプレートの作成」および「ブレッドクラム・テンプレート」を参照してください。

ブレッドクラム・リージョンを作成するには、次のステップを実行します。

1. 該当するページ定義にナビゲートします。「ページ定義へのアクセス」を参照してください。

2. 「リージョン」で、「作成」アイコンをクリックします。
「リージョンの作成」ウィザードが表示されます。各ウィザードのページ左にステップを表す一連のブロックが表示されます。ハイライトされたブロックは実行中のステップを表します。

3. リージョン・タイプについて、「ブレッドクラム」を選択して「次へ」をクリックします。

4. 「ブレッドクラム・コンテナ・リージョン」で、次のステップを実行します。

1. リージョン・タイトル: リージョンのタイトルを入力します。

2. リージョン・テンプレート: リージョン・テンプレートを選択します。

3. 表示ポイント: 表示ポイントを選択します。
リージョンは、位置(または表示ポイント)別に編成されています。リージョンの適切な位置を決定するには、懐中電灯アイコンをクリックします。グラフィカルな画面が表示されます。

4. 順序: 順序の番号を入力します。

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

5. 「ブレッドクラム」で、次のステップを実行します。

1. ブレッドクラム: このリージョンに関連付けるブレッドクラムを選択します。

2. ブレッドクラム・テンプレート: テンプレートを選択します。

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

6. 「ブレッドクラム・エントリ」では、ブレッドクラム・エントリをこのページの指定に使用するブレッドクラム・エントリを指定します。

1. ブレッドクラム・エントリ・ラベル - このブレッドクラム・エントリのラベルを入力します。

2. 親エントリ - 階層内の適切な親を選択します。

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

7. 「終了」をクリックします。

ブレッドクラム・ナビゲーションを追加する各ページに対して、これらのステップを実行します。

動的ブレッドクラムの作成について

より詳細なコンテキストを表示するために、ブレッドクラムにセッション・ステートを含めて、ブレッドクラムを動的にすることができます。たとえば、アプリケーションのページに特定の会社への注文リストが表示される場合に、次のブレッドクラムを含めるとします。

Home > Orders > Orders for ACME Inc

この例で、ACME Incは、ユーザーが現在表示しているページおよびナビゲーション・パスも示しています。Application Expressエンジンによって、ACME Inc.のセッション・ステートの値が格納されます。

このタイプの動的メニューを作成するには、ブレッドクラムの短縮名または詳細な名前に、セッション・ステート・アイテムへの参照を含める必要があります。次に例を示します。

&COMPANY_NAME.

ブレッドクラムの編集

作成したブレッドクラムは、ブレッドクラム・ページで編集できます。

ブレッドクラムを編集するには、次のステップを実行します。

1. 「ワークスペース」ホームページにナビゲートします。

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

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

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

5. 「ナビゲーション」で、「ブレッドクラム」を選択します。
ブレッドクラム・ページが表示されます。

「ビュー」リストから選択し、「実行」をクリックして、ページの外観を変更できます。

- アイコン(デフォルト): 各ブレッドクラムを大きいアイコンとして表示します。ブレッドクラムを編集するには、該当するアイコンをクリックします。

- 詳細: 各ブレッドクラムをレポートで1行に表示します。ブレッドクラムを編集するには、該当する名前をクリックします。

6. ブレッドクラムを選択します。

7. 適切なブレッドクラム・エントリ名を選択します。
ブレッドクラム・エントリの作成/編集ページが表示されます。

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

ヒント:
ページ上の特定のアイテムの詳細を表示するには、アイテム・ラベルをクリックします。ヘルプが利用できる場合は、アイテム・ラベル上にカーソルを重ねると、アイテム・ラベルが赤色に変わり、カーソルが矢印と疑問符に変わります。「フィールドレベル・ヘルプについて」を参照してください。

9. (オプション)ページ右側にある「ブレッドクラム・エントリ」リストで、ページ名とタイトルとのブレッドクラムの同期化に関するオプションを選択できます。
このオプションを選択することで、ページ名とブレッドクラムの変更が1ステップでできるようになります。ブレッドクラム名に指定した情報は、参照ページ名とタイトルの更新に使用されます。

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

ナビゲーションの選択肢について

ブレッドクラム・エントリの作成/編集ページは、「ブレッドクラム」、「エントリ」、「ターゲット」、「条件」、「認可」および「構成」というセクションに分かれています。

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

ブレッドクラム・エントリの親の変更

エントリの親の変更ページの選択ブレッドクラム・エントリに新たな親を選択できます。

ブレッドクラム・エントリの親を変更するには、次のステップを実行します。

1. ブレッドクラム・ページにナビゲートします。

1. 「ワークスペース」ホームページにナビゲートします。

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

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

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

5. 「ナビゲーション」で、「ブレッドクラム」を選択します。
ブレッドクラム・ページが表示されます。

2. ブレッドクラムを選択します。
ブレッドクラム・エントリ・ページが表示されます。

3. 「タスク」リストから、「このブレッドクラム内におけるエントリの親の変更」をクリックします。
エントリの親の変更ページが表示されます。

4. ビューを編集またはフィルタを適用するためにナビゲーション・バーを使用するには、次のステップを実行します。

- ブレッドクラム: 編集するブレッドクラムを指定して、「実行」をクリックします。

- 開始: ブレッドクラム階層のサブセットの表示の制限を選択し、「実行」をクリックします。

5. 「親の変更先」から、新たな親を選択します。

6. 移動するブラッドクラム・エントリを選択し、「チェックしたエントリの親の変更」をクリックします。

ブレッドクラム・レポートへのアクセス

「ブレッドクラム」ページ上部の該当するタブをクリックすると、ブレッドクラムの使用状況レポートおよびブレッドクラム履歴レポートを表示できます。

注意:
「使用状況」ボタンと「履歴」ボタンが表示されるのは、ブレッドクラムを作成した後のみです。

ブレッドクラム・ページにアクセスするには、次の操作を実行します。

1. 「ワークスペース」ホームページにナビゲートします。

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

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

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

5. 「ナビゲーション」で、「ブレッドクラム」を選択します。

ブレッドクラムの使用状況レポート

「使用状況」をクリックすると、ブレッドクラム・レポートにアクセスできます。このレポートには、ブレッドクラムがページごとに表示されます。ページ番号をクリックして、特定のページに進みます。

ブレッドクラム履歴レポート

「履歴」をクリックすると、ブレッドクラムの履歴レポートにアクセスできます。このレポートには、ブレッドクラムの最近の変更が示されます。

ツリーの作成

アプリケーションにツリーを使用すると、階層的なデータまたは複数のレベルのデータ間で効率的に通信を行うことができます。

この項に含まれる内容は次のとおりです。

- ツリーの作成方法

- ツリーの編集

- ツリー・レポートへのアクセス

ツリーの作成方法

ツリーを作成するには、次のステップを実行します。

1. 共有コンポーネント・ページにナビゲートします。

1. 「ワークスペース」ホームページにナビゲートします。

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

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

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

2. 「ナビゲーション」で、「ツリー」をクリックします。
ツリー・ページが表示されます。

3. 「作成」をクリックします。
ツリーの作成ウィザードが表示されます。各ウィザードのページ左にステップを表す一連のブロックが表示されます。ハイライトされたブロックは実行中のステップを表します。

4. 「ページ属性」で、基本的なページ情報を入力して、「次へ」をクリックします。
ページ上の特定のアイテムの詳細を表示するには、アイテム・ラベルをクリックします。アイテムまたはフィールドの説明とともにヘルプ・ウィンドウが表示されます。

5. 「タブ」で、タブの実装方法を指定して、「次へ」をクリックします。

6. 「ツリー属性」で、次のステップを実行します。

1. ツリー名 - 名前を入力します。

2. デフォルト展開レベル - デフォルト展開レベルの数を指定します。

3. ツリーの開始方法 - 開始点の決定方法を指定します。これにより、階層のどこに表示されるかが決定されます。
- ポップアップLOVを含む新しいアイテムに基づく - このオプションを選択すると、LOVを含むアイテムを設定できます。このオプションにより、値リストのオプションを選択することで、表示する開始点を決定できます。

- SQL問合せに基づく - このオプションを選択すると、階層(親を持たないエントリ)の開始点を動的に検索する問合せを記述できます。

- 静的値 - このオプションを選択すると、開始点をハード・コードできます。

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

7. 「ツリー・テンプレート」で、テンプレートを選択して、「次へ」をクリックします。

8. 「ツリーの開始」で、開始点を指定して、「次へ」をクリックします。指定した開始点に応じて、問合せか単一の値かのいずれかを入力します。

9. 「開く」または「閉じる」で、含めるボタンを選択して、「次へ」をクリックします。

10. 「表/ビューの所有者」で、基本となるツリーのテーブルの所有者を指定して、「次へ」をクリックします。

11. 「表/ビューの名前」で、基本となるツリーのテーブルの名前を指定して、「次へ」をクリックします。

12. ツリーは問合せに基づき、階層形式で表現できるデータを戻します。階層は、ID値と親ID値の関係によって決まります。IDとして使用する列、親IDを識別して、リーフ・ノードに表示するテキストを指定します。

1. ID - IDとして使用する列を入力します。

2. 親ID - 親IDを入力します。

3. リーフ・ノード・テキスト - リーフ・ノードに表示するテキストを指定します。

4. リンク・オプション - 「既存のアプリケーション・アイテム」を選択し、リーフ・ノード・テキストをリンクにします。このオプションを選択する場合は、リンク先のページを指定します。

13. 問合せに追加するオプションのWHERE句およびORDER BY句を指定します。

14. 「実行」ボタンの表示テキストを指定します。

15. ユーザーがボタンをクリックしたときにブランチするページを指定します。

16. 「終了」をクリックします。

ツリーの編集

作成したツリーは、ツリー・ページで編集できます。

ツリーを編集するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

4. 「ナビゲーション」で、「ツリー」を選択します。
ツリー・ページが表示されます。

5. 「ビュー」リストから選択して、ページの外観を変更できます。

- アイコン(デフォルト): 各ツリーを大きいアイコンとして表示します。

- 詳細: 各ツリーをレポートで1行に表示します。

6. ツリーを選択します。
ツリーの編集ページが表示されます。

7. 対象となる属性を編集します。

8. ページ上の特定のアイテムの詳細を表示するには、アイテム・ラベルをクリックします。
ヘルプが利用できる場合は、アイテム・ラベル上にカーソルを重ねると、アイテム・ラベルが赤色に変わり、カーソルが矢印と疑問符に変わります。「フィールドレベル・ヘルプについて」を参照してください。

9. 「変更の適用」をクリックします。

ナビゲーションの選択肢について

ツリーの編集ページは、「名前」、「問合せ」、「前後」、「静的ノード・テンプレート」、「動的テンプレート」、「ノード・テキスト・テンプレート」および「リンク・テンプレート」というセクションに分かれています。

これらのセクションにアクセスするには、ページをスクロール・ダウンするか、ページ上部のナビゲーション・ボタンをクリックします。ページ上部のボタンを選択すると、選択されたセクションが表示され、その他のセクションはすべて一時的に非表示になります。ページのすべてのセクションを表示するには、「すべて表示」をクリックします。

ツリー・レポートへのアクセス

「ツリー」ページ上部の該当するタブをクリックすると、ツリーの使用状況およびツリー履歴レポートを表示できます。

注意:
「使用状況」ボタンと「履歴」ボタンが表示されるのは、ツリーを作成した後のみです。

ツリーの使用状況

ツリー・ページの「使用状況」をクリックすると、「ツリーの使用状況」レポートにアクセスできます。このレポートには、カレント・アプリケーションに含まれるすべてのツリーが表示されます。ツリーを編集するには、ツリー名を選択します。

ツリー履歴

ツリー・ページの「履歴」をクリックすると、ツリーに対する変更が開発者および日付ごとに表示されます。

ナビゲーション・バー・エントリの作成

ナビゲーション・バー・エントリを使用すると、アプリケーションのページ間を容易に移動できます。たとえば、ナビゲーション・エントリを使用すると、イメージまたはテキストからのリンクを表示できます。関連付けられたページ・テンプレートによってナビゲーション・バーの位置が決定します。

この項に含まれる内容は次のとおりです。

- ナビゲーション・バーについて

- ナビゲーション・バー・エントリの作成方法

- ナビゲーション・バー・エントリの編集

- 複数のナビゲーション・バー・エントリの同時編集

- 「ナビゲーション・バー・エントリの順序変更」アイコンの使用

- ナビゲーション・バー・エントリ・レポートへのアクセス

関連項目:
「テンプレートのカスタマイズ」

ナビゲーション・バーについて

ナビゲーション・バー・エントリは、イメージ、テキストまたは下にテキストが付いているイメージです。ナビゲーション・バー・エントリに使用するイメージおよびテキストを入力する必要があります。

ナビゲーション・バーは、ページごとにこれらを参照する必要がないという点で、他の共有コンポーネントとは異なります。使用するページ・テンプレートに#NAVIGATION_BAR#置換文字列が含まれている場合、Application Expressエンジンは、ページをレンダリングする際、自動的に定義済ナビゲーション・バーを含めます。

関連項目:
サポートされるページ・テンプレートの置換文字列

ナビゲーション・バー・エントリの作成方法

ナビゲーション・バーを追加する前に、ナビゲーション・バー・エントリを作成する必要があります。そのためには、ページ定義または共有コンポーネント・ページからナビゲーション・バー・ページにアクセスします。

関連項目:
「共有コンポーネントでの作業」

ナビゲーション・バー・エントリを作成するには、次のステップを実行します。

1. 該当するページ定義にナビゲートします。「ページ定義へのアクセス」を参照してください。

2. 「共有コンポーネント」で、「ナビゲーション・バー」までスクロールします。

3. 「ナビゲーション・バー」で、「作成」アイコンをクリックします。
ナビゲーション・バー・エントリの作成ウィザードが表示されます。各ウィザードのページ左にステップを表す一連のブロックが表示されます。ハイライトされたブロックは実行中のステップを表します。

4. 「属性」で、次の該当する情報を指定します。

1. 順序: このコンポーネントの評価の順序を指定します。

ヒント:
既存のエントリを確認するには、ページ下部の「既存のナビゲーション・バー・エントリ」リンクをクリックします。

2. altタグ・テキスト: イメージのナビゲーション・アイテムであるaltテキストを入力します。イメージ名を指定しないと、このテキストが表示されます。

3. アイコン・イメージ名: イメージ名を入力します。ネーミング規則については、アイテム・ラベル(アイコン・イメージ名)をクリックします。これにより、サポートされている接頭辞およびイメージ名の例を含むアイテム・ラベル・ヘルプが開きます。

4. イメージの高さ: イメージの高さをピクセルで定義します。

5. 幅 - イメージの幅をピクセルで定義します。

6. テキスト - テキストのみのエントリの場合は、エントリ・テキストを入力します。イメージの場合は、追加のテキストを入力してイメージとともに表示できます。この属性は翻訳可能です。

7. 「次へ」をクリックします。

5. 「ターゲット」で、ターゲットの場所を指定します。

1. ターゲット位置がURLの場合、次のように指定します。

- ターゲットは: 「URL」を選択します。

- URLターゲット: URLを入力します。次に例を示します。

http://www.yahoo.com

2. ターゲット位置がページの場合、次を指定します。

- ターゲットは: 「このアプリケーションのページ」を選択します。

- ページ: ターゲット・ページ番号を指定します。
「このページのページ区切りをリセット」を選択することもできます。このオプションを選択すると、ユーザーの新規問合せに合うデータの最初のセットにページが戻されます。

「印刷用」も選択できます。このオプションを選択すると、アプリケーションの「印刷用」テンプレートを使用するターゲット・ページが表示されます。「印刷用」テンプレートにより、印刷用ページが最適化されます。「テーマのデフォルトのテンプレートの変更」および「印刷用ページの最適化」を参照してください。

- リクエスト: 使用するリクエストを指定します。

- キャッシュのクリア: キャッシュをクリアするページ番号を指定します。

3. セッション・ステートを設定するには(リストされたアイテムに値を与えます)、次のステップを実行します。

- 「次のアイテムを設定」で、セッション・ステートを設定するアイテム名をカンマで区切って入力します。

- 次の値を使用: 指定したアイテムの値をカンマで区切って入力します。
静的な値または置換構文(&APP_ITEM_NAME.など)を指定できます。URLのf?p=に渡されるアイテム値にはコロン(:)を使用しないでください。また、バックスラッシュでアイテム値全体を囲んだ場合(\1234,56\など)を除いて、カンマも使用しないでください。

4. 「次へ」をクリックします。

6. ナビゲーション・バー・エントリの表示条件を設定するには、適切な条件の情報を指定して、「作成」をクリックします。

ヒント:
ナビゲーション・バーを表示するには、使用するページ・テンプレートに#NAVIGATION_BAR#置換文字列が含まれている必要があります。「サポートされるページ・テンプレートの置換文字列」を参照してください。

ナビゲーション・バー・エントリの編集

作成したナビゲーション・バー・エントリは、ナビゲーション・バー・エントリ・ページで編集できます。

ナビゲーション・バー・エントリを編集するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

4. 「ナビゲーション」で、「ナビゲーション・バー・エントリ」をクリックします。
ナビゲーション・バー・エントリ・ページが表示されます。「ビュー」リストから選択し、「実行」をクリックして、ページの外観を変更できます。使用可能なオプションは次のとおりです。

- アイコン(デフォルト): 各ナビゲーション・バー・エントリを大きいアイコンとして表示します。ナビゲーション・バー・エントリを編集するには、このアイコンをクリックします。

- 詳細: 各ナビゲーション・バーをレポートで1行に表示します。ナビゲーション・バーを編集するには、該当する順序番号をクリックします。

5. ナビゲーション・バー・エントリを選択します。
ナビゲーション・バー・エントリ・ページが表示されます。

「ナビゲーション・バー・エントリの編集」は、「順序」、「サブスクリプション」、「イメージ属性」、「ターゲット」、「条件」、「認可」、「構成」および「コメント」というセクションに分かれています。

これらのセクションにアクセスするには、ページをスクロール・ダウンするか、ページ上部のナビゲーション・ボタンをクリックします。ページ上部のボタンを選択すると、選択されたセクションが表示され、その他のセクションはすべて一時的に非表示になります。ページのすべてのセクションを表示するには、「すべて表示」をクリックします。

6. 対象となる属性を編集します。

7. ページ上の特定のアイテムの詳細を表示するには、アイテム・ラベルをクリックします。
ヘルプが利用できる場合は、アイテム・ラベル上にカーソルを重ねると、アイテム・ラベルが赤色に変わり、カーソルが矢印と疑問符に変わります。「フィールドレベル・ヘルプについて」を参照してください。

8. 「変更の適用」をクリックします。

複数のナビゲーション・バー・エントリの同時編集

複数のナビゲーション・バー・エントリを同時に編集するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

4. 「ナビゲーション」で、「ナビゲーション・バー・エントリ」をクリックします。
ナビゲーション・バー・エントリ・ページが表示されます。

5. ページ上部の「グリッド編集」をクリックします。

6. 該当する属性を編集し、「変更の適用」をクリックします。

「ナビゲーション・バー・エントリの順序変更」アイコンの使用

「ページ定義」の「ナビゲーション・バー・エントリの順序変更」アイコンをクリックすると、ナビゲーション・バー・エントリの順序を迅速に変更できます。このアイコンは、薄い緑色の上下矢印の形をしています。

「タブの順序変更」アイコンを使用してナビゲーション・バー・エントリの順序を変更するには、次のステップを実行します。

1. 該当するページ定義にナビゲートします。「ページ定義へのアクセス」を参照してください。

2. 「ナビゲーション・バー」で、「ナビゲーション・バー・エントリの順序変更」アイコンをクリックします。
ナビゲーション・バー・エントリの順序変更ページが表示されます。

3. ページに表示されるエントリの順序を変更するには、右側にある列にある上矢印および下矢印をクリックして、番号を編集します。

4. 「変更の適用」をクリックします。

ナビゲーション・バー・エントリ・レポートへのアクセス

「ナビゲーション・バー・エントリ」ページ上部の該当するタブをクリックすると、ナビゲーション・バー・エントリ・サブスクリプションおよびナビゲーション・バー・エントリ履歴のレポートを表示できます。

注意:
「サブスクリプション」ボタンと「履歴」ボタンが表示されるのは、ナビゲーション・バーを作成した後のみです。

ナビゲーション・バー・エントリ・サブスクリプション・レポート

「サブスクリプション」をクリックすると、サブスクライブされたナビゲーション・バー・レポートにアクセスできます。このレポートには、アプリケーションでサブスクライブされたナビゲーション・バー・エントリが表示されます。

ナビゲーション・バー・エントリ履歴

「履歴」をクリックすると、ナビゲーション・バー履歴レポートにアクセスできます。このレポートには、ナビゲーション・バーの最近の変更が示されます。

ブランチを使用したナビゲーションの制御

ブランチは、指定したページが送信された後の特定のページ、プロシージャまたはURLへのリンクに対する指示です。たとえば、ページ1の送信後、ページ1からページ2にブランチできます。

ブランチの作成ウィザードを実行し、ブランチ・ポイントおよびブランチ・タイプを指定すると、ブランチを作成できます。

ブランチを作成するには、次のステップを実行します。

1. 該当するページ定義にナビゲートします。「ページ定義へのアクセス」を参照してください。

2. 「ページ・プロセス」列の「ブランチ」で、「作成」アイコンをクリックします。

3. 「ポイントおよびタイプ」では、ブランチ・ポイントを選択します。

- 送信時: 計算の前: 計算、検証またはプロセスの前に実行されます。このオプションは、「取消」ボタンに使用します。

- 送信時: 検証の前: 計算の後、検証またはプロセスの前に実行されます。通常は使用しません。検証が失敗すると、ページ・プロセスは停止し、ロールバックが実行され、ページにエラーが表示されます。このデフォルト動作のために、ブランチを作成して検証を提供する必要がありません。ただし、計算の結果に応じてブランチする必要がある場合があります(たとえば、前のブランチ・ポイントに戻る場合)。

- 送信時: プロセスの前: 計算および検証の後、プロセスの前に実行されます。このオプションを使用すると、検証されたセッション・ステートに基づいて、ページ・プロセスの実行前にブランチされます。

- 送信時: プロセスの後: 計算、検証およびプロセスの後に実行されます。このオプションを使用すると、計算、検証およびプロセスの実行後にURLまたはページにブランチされます。このオプションを使用する際、任意のブランチ・ポイントに複数のブランチが存在する場合は、ブランチを順序付ける必要があります。

- ロード時: ヘッダーの前: ページのレンダリング前に実行されます。このオプションを使用すると、カレント・ページではなく別のページが表示されるか、またはユーザーが別のURLまたはプロシージャにリダイレクトされます。

4. ブランチ・タイプを選択し、「次へ」をクリックします。

5. 「ターゲット」で、ターゲットの場所を指定します。ページに表示される情報は、選択したブランチ・タイプによって異なります。

1. ターゲット位置がURLの場合、次のように指定します。

- ターゲットは: 「URL」を選択します。

- URLターゲット: URLを入力します。次に例を示します。

http://www.yahoo.com

2. ターゲット位置がページの場合、次を指定します。

- ターゲットは: 「このアプリケーションのページ」を選択します。

- ページ: ターゲット・ページ番号を指定します。
「このページのページ区切りをリセット」を選択することもできます。このオプションを選択すると、ユーザーの問合せに合うデータの最初のセットにページが戻されます。

「プロセスの成功メッセージを含める」を選択することもできます。このオプションを選択すると、ユーザーがページを送信してブランチが他のページに移動する場合にメッセージが表示されます。メッセージの表示はページの送信の一部であり次のページの表示の一部ではないので、このオプションを選択しない場合は、メッセージは表示されません。

- リクエスト: 使用するリクエストを指定します。

- キャッシュのクリア: キャッシュをクリアするページ番号を指定します。複数のエントリをカンマで区切ります。

3. セッション・ステートを設定するには(リストされたアイテムに値を与えます)、次のステップを実行します。

- 「次のアイテムを設定」で、セッション・ステートを設定するアイテム名をカンマで区切って入力します。

- 次の値を使用: 指定したアイテムの値をカンマで区切って入力します。
静的な値または置換構文(&APP_ITEM_NAME.など)を指定できます。URLのf?p=に渡されるアイテム値にはコロン(:)を使用しないでください。また、バックスラッシュでアイテム値全体を囲んだ場合(\1234,56\など)を除いて、カンマも使用しないでください。

4. リダイレクトを実行する前にキャッシュをクリアしてセッション・ステートを保存するには、「ブランチ処理の前にステートを保存」を選択します。「ブランチ処理の前のステートの保存について」を参照してください。

5. 「次へ」をクリックします。

6. 画面に表示されるステップに従います。

関連項目:
「「対象ボタン」属性について」

送信するコンポーネントを含むページでのブランチの作成

送信するコンポーネント(「実行」ボタンまたは「送信機能付き選択リスト」など)を含むページがある場合、そのページにリンクして戻るブランチを作成する必要があることに注意してください。たとえば、選択リストおよび送信ボタンを含むページがあるとします。処理が適切に行われるように、そのページにリンクして戻るブランチをそのページに作成する必要があります。

ブランチ処理の前のステートの保存について

ブランチがURLにリダイレクトするかURLを戻し、結果のf?p URLにクリア・キャッシュ・ディレクティブまたはアイテムの名前と値を渡す場合は、「ブランチ処理の前にステートを保存」の選択を検討します。デフォルトでは、ブランチ処理の後でこの情報が渡されて、渡された情報がURLに表示されます。

「ブランチ処理の前にステートを保存」を選択すると、ブランチをリダイレクトする前に、機密の可能性がある情報がセッション・ステートに設定されます。このオプションを使用すると、URLが改ざんされにくくなり、アイテム名、値、プログラム・ロジックの表示を減らすことで、アプリケーションのセキュリティが向上します。

「ブランチ処理の前にステートを保存」を選択した場合は、リダイレクトされたURLに、クリア・キャッシュまたはアイテムの名前と値が含まれなくなることに注意してください。この情報は、デバッグ・モードでアプリケーションを実行すると確認できます。「デバッグ・モードへのアクセス」を参照してください。

9 ページ・レイアウトの制御

ここでは、リージョンのカスタマイズ、アイテム属性の編集およびイメージの組込みによって、アプリケーションのページ・レイアウトをカスタマイズする様々な方法について説明します。

この項には、次の項目が含まれます。

- Oracle Application Expressでのページ・レイアウトの理解

- アプリケーションの各ページのコンポーネントの表示

- リージョンの理解

- 複数列レイアウトの作成

- アイテム属性がページ・レイアウトに与える影響

- 他のWebサイトからのコンテンツの統合

- イメージの管理

- 静的ファイルの管理

- カスタムPL/SQLを使用したHTMLのレンダリング

関連項目:
「ナビゲーションの追加」および「ドラッグ・アンド・ドロップ・レイアウト・ページの使用」

Oracle Application Expressでのページ・レイアウトの理解

Application Expressエンジンは、開発者によって定義されたアプリケーション・コンポーネントおよびデータベース内のデータをテンプレートと組み合せてページをレンダリングします。

全体的なフレームワーク(またはページの構造)は、ページ・テンプレートによって決まります。たとえば、ページ・テンプレートは、ページでタブおよびナビゲーション・バーを使用するかどうかを制御します。また、ページの左側にナビゲーションまたはセカンダリ・コンテンツ用のプレースホルダとして機能するバーを含めるかどうかを定義することもできます。さらに、ページ・テンプレートには、リージョン位置の定義を含めることができます。これによって、HTML表またはスタイルシート定義を使用してリージョンの位置を正確に制御できます。ページ・テンプレート自体は、置換文字列と組み合されたHTMLで構成されます。これらの置換文字列は、実行時に、適切なコンポーネントに置換されます。

開発者は、リージョンを作成することによってページにコンテンツを追加します。リージョンはページの領域で、コンテンツのコンテナとして機能します。各リージョンには、HTML、レポート、フォーム、チャート、リスト、ブレッドクラム、PL/SQL、ツリー、URL、カレンダなどの様々なコンテンツが含まれます。他のリージョンとの相対位置によって(順序番号および列に基づいて)、またはページ・テンプレートに定義されたリージョン位置を使用して、リージョンを配置します。リージョンのスタイルは、リージョン・テンプレートによっても制御されます。ページ・テンプレートと同様に、リージョン・テンプレートは、リージョンを表示するページ上の領域の構造を定義します。リージョン・テンプレートは、リージョン・タイトルを表示するかどうか、およびメイン・コンテンツ(ボディ)に対するリージョン・タイトルの相対的な表示位置を定義します。リージョンでは、ボタンの絶対位置を定義することもできます。

関連項目:
「リージョンの作成」

アプリケーションの各ページのコンポーネントの表示

アプリケーションのページ0(ゼロ)は、マスター・ページとして機能します。ページ0に追加したすべてのコンポーネントは、Application Expressエンジンによってアプリケーション内の各ページにレンダリングされます。Application Expressエンジンでコンポーネントをレンダリングするか、または条件を定義することで計算、検証またはプロセスを実行するかを制御することもできます。

ページ0(ゼロ)を作成するには、次のステップを実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。

2. アプリケーションを選択します。
アプリケーションのホームページが表示されます。

3. 「ページの作成」ボタンをクリックします。

4. 「ページ・タイプの選択」では、「ページ0(ゼロ)」を選択します。
アプリケーションにページ0(ゼロ)がない場合にのみ、「ページ0(ゼロ)」オプションが表示されることを確認してください。

5. 「終了」をクリックします。

関連項目:
「アプリケーション内のページの管理」、「条件付きのレンダリングおよびプロセスの理解」および「使用可能な条件」

リージョンの理解

リージョンはページ上の領域で、コンテンツのコンテナとして機能します。各ページには任意の数のリージョンを配置できます。特定のリージョン・テンプレートによってリージョンの外観を制御できます。リージョン・テンプレートでは、リージョンの外観およびサイズの制御、枠線または背景色を使用するかどうかの指定、表示するフォントの決定を行います。また、リージョン位置に配置されるボタンの標準配置も制御します。

リージョンを使用して、ページ・コントロール(アイテムやボタンなど)をグループ化できます。追加のHTMLを生成しない単純なリージョンを作成したり、HTML表やイメージ内でコンテンツを形成する詳細なリージョンを作成できます。

リージョンは、HTML表の列内では順番に表示されます。ページ・テンプレートに定義された位置にリージョンを明示的に配置することもできます。条件付きでリージョンを表示するように選択することもできます。

この項に含まれる内容は次のとおりです。

- ページ定義の「リージョン」セクションについて

- 「リージョンの順序変更」アイコンの使用

- リージョンの作成

- リージョン・タイプについて

- リージョン属性の編集

- リージョンのコピー

ページ定義の「リージョン」セクションについて

ページ定義でリージョンを作成および編集できます。リージョンは、「ページ・レンダリング」セクションの下に表示されます。「ページ定義へのアクセス」を参照してください。

「リージョン」アイコンをクリックすると、その他のサブセクションが一時的に非表示になります。表示を元に戻すには、「すべての表示」をクリックします。「すべて表示」アイコンは、下向き三角形の形をしています。

セクション・タイトルの横に次のアイコンが表示されます。

- すべて編集: 「すべて編集」アイコンは、鉛筆が置かれた小さいグリッドの形をしています。このアイコンを使用して、すべてのリージョンを一度に編集できます。

- コピー: 「コピー」アイコンは、小さいページが2つ重なった形をしています。このアイコンを使用して、既存のリージョンのコピーを作成します。

- 作成: 「作成」アイコンは、プラス(+)記号が置かれた小さいページの形をしています。リージョンを作成するには、このアイコンをクリックします。

リージョンは、位置(または表示ポイント)別に編成されています。リージョンで使用可能なリンクは、リージョンのタイプによって異なります。

関連項目:
「リージョン属性の編集」および「「リージョンの順序変更」アイコンの使用」

「リージョンの順序変更」アイコンの使用

ページ定義で「リージョンの順序変更」アイコンをクリックすると、リージョンの表示順序の変更、リージョン・タイトルの編集、またはリージョン・テンプレートの変更を簡単に行えます。「リージョンの順序変更」アイコンは、ライトグリーンの下矢印および上矢印として、表示ポイントの右側に表示されます。

「リージョンの順序変更」アイコンを使用してリージョンを編集するには、次のステップを実行します。

1. 該当するページ定義にナビゲートします。「ページ定義へのアクセス」を参照してください。

2. 「リージョン」で「リージョンの順序変更」アイコンをクリックします。
リージョンの順序変更ページが表示されます。このページを使用して、リージョン・タイトルの編集やテンプレートの選択を行います。

3. 「リージョン」でタイトルを入力します。

4. 「テンプレート」からテンプレートを選択します。

5. リージョンの表示順序を変更するには、右端の列で上矢印および下矢印をクリックします。

6. 「変更の適用」をクリックします。

リージョン属性の編集

「リージョン定義」で属性を編集することで、ページの外観を変更できます。

この項に含まれる内容は次のとおりです。

- リージョン定義の編集

- リージョン属性がページ・レイアウトに与える影響

- 「リージョンの順序変更」アイコンの使用

- リージョン位置の制御

- リージョンのヘッダーおよびフッターの指定

- ユーザーによるページのカスタマイズの可能化

- リージョン・キャッシュの使用

- 静的リージョンIDの指定

リージョン定義の編集

リージョン属性を編集するには、次のステップを実行します。

1. 該当するページ定義にナビゲートします。「ページ定義へのアクセス」を参照してください。

2. 「リージョン」で、リージョン名を選択します。
リージョン定義が表示されます。

3. 対象となる属性を編集します。

4. ページ上の特定のアイテムの詳細を表示するには、アイテム・ラベルをクリックします。
ヘルプが利用できる場合は、アイテム・ラベル上にカーソルを重ねると、アイテム・ラベルが赤色に変わり、カーソルが矢印と疑問符に変わります。「フィールドレベル・ヘルプについて」を参照してください。

5. 「変更の適用」をクリックします。

関連項目:
「リージョン属性がページ・レイアウトに与える影響」、「リージョン位置の制御」、「「リージョンの順序変更」アイコンの使用」および「リージョンのヘッダーおよびフッターの指定」

ナビゲーションの選択肢について

リージョン定義ページは、「指定」、「ユーザー・インタフェース」、「ソース」、「条件」、「キャッシュ」、「ヘッダーおよびフッター」、「認可」、「カスタマイズ」、「構成」および「コメント」の各セクションに分かれています。

これらのセクションにアクセスするには、ページをスクロール・ダウンするか、ページ上部のナビゲーション・ボタンをクリックします。ページ上部のボタンを選択すると、選択されたセクションが表示され、その他のセクションはすべて一時的に非表示になります。ページのすべてのセクションを表示するには、「すべて表示」をクリックします。

リージョン属性がページ・レイアウトに与える影響

表9-1に、ページのレイアウトに影響を与えるリージョン属性を示します。

表 9-1 ページ・レイアウトに影響を与えるリージョン属性

属性

説明

ユーザー・インタフェース、テンプレート

リージョンの外観を決定します。アプリケーションで定義されたリージョン・テンプレートから選択します。テンプレート属性を表示するには、ページ定義でテンプレート名をクリックします。

関連項目: 「テンプレートのカスタマイズ」および「リージョン・テンプレート」

ユーザー・インタフェース、順序

ページ内のリージョンの表示順を指定します。

ユーザー・インタフェース、表示ポイント

ページ内でリージョンを表示する位置を指定します。リージョンは、「表示ポイント」の順序番号順にレンダリングされます。ページ・レイアウトを表示するには、「ビュー」アイコンをクリックして、位置を選択します。

選択可能な表示ポイントは、ページ・レベル・テンプレート(ページ属性)によって決定されます。ページ・レベル・テンプレートを選択しなかった場合は、「アプリケーションの定義」で定義されたデフォルトのページ・レベル・テンプレートが使用されます。

ユーザー・インタフェース、リージョンHTML表のセル属性

リージョンが複数の列に表示される場合にHTML表セルで使用される追加の属性を定義します。この属性は、複数の列でのリージョンの配置に使用される表のセルを制御します。

ユーザー・インタフェース、列

リージョンを表示する列を決定します。同じ表示ポイントに2つのリージョンがある場合は、2番目のリージョンを列2に表示するように設定することによって、2つのリージョンを並べて配置できます。多数のリージョンはそれぞれの列に表示でき、リージョン表示ポイントおよび列内でのリージョンの表示順は、リージョン表示順序番号によって制御されます。

ヘッダーおよびフッター

リージョンの最上部(#BODY#コンテンツの直前)に表示されるHTMLテキストを指定します。

条件付き表示

リージョンを表示するかどうかを決定する条件および適切な式を定義します。条件では、セッション・ステート、現在ログインしているユーザーまたは環境設定(ページが印刷用ビュー・モードかどうかなど)を参照できます。

関連項目: 「条件付きのレンダリングおよびプロセスの理解」および「印刷用ページの最適化」

カスタマイズ

エンド・ユーザーによるカスタマイズを可能にします。この機能を使用するには、ページ・テンプレートのヘッダー、ボディまたはフッター・セクションに#CUSTOMIZE#置換文字列を含める必要があります。

関連項目: 「ユーザーによるページのカスタマイズの可能化」

リージョン位置の制御

リージョンを作成する際に、ページでのそのリージョンの位置(「表示ポイント」)を指定する必要があります。デフォルト位置(ページ・テンプレート・ボディなど)またはテンプレートにユーザーが定義した位置(「ページ・テンプレートのリージョン位置1」など)のいずれかを選択できます。

表示ポイントに加えて、リージョンを配置する列を指定できます。複数の列にリージョンを配置する場合は、Oracle Application Expressによって必要なHTMLが自動的にレンダリングされ、複数列のレイアウトが生成されます。

リージョンのヘッダーおよびフッターの指定

リージョンのボディ・コンテンツ(レポート、チャートまたはフォーム要素付きのHTML)に加えて、追加のHTMLをリージョンの上下(ヘッダーおよびフッター)に配置できます。

リージョン・フッターでは次の置換文字列がサポートされています。

- #TIMING#: リージョンのレンダリングにかかる経過時間(秒)を表示できます。この置換文字列はデバッグに使用できます。

- #ROWS_FETCHED#: Oracle Application Expressレポート・エンジンによってフェッチされた行数(ページ・サイズ)を表示できます。これらの置換文字列を使用して、カスタマイズされたメッセージをユーザーに表示できます。次に例を示します。

Fetched #ROWS_FETCHED# rows in #TIMING# seconds.

- #TOTAL_ROWS#: レポートに使用されたSQL問合せを満たす行の合計数を表示できます。

- #FIRST_ROW_FETCHED# および#LAST_ROW_FETCHED#: 表示される行の範囲を表示できます。次に例を示します。

Row(s) #FIRST_ROW_FETCHED# through #LAST_ROW_FETCHED# of #ROWS_FETCHED# displayed

ユーザーによるページのカスタマイズの可能化

カスタマイズ属性を使用すると、実行中のアプリケーションでユーザーがリージョンのオン/オフを切り替えることができるようになります。

エンド・ユーザーは次の手順でカスタマイズできます。

1. 該当するページ定義にナビゲートします。「ページ定義へのアクセス」を参照してください。

2. 「リージョン」で、リージョン名をクリックします。
リージョン定義が表示されます。

3. 「カスタマイズ」までスクロールして、次のいずれかを選択します。

- デフォルトでカスタマイズ可能および非表示

- デフォルトでカスタマイズ可能および表示

4. 「カスタマイズ・オプション名」に、ページのこのリージョンをユーザーに示すラベルを入力します。

5. ページ・テンプレートの「ヘッダー」、「ボディ」または「フッター」セクションに#CUSTOMIZE#置換文字列を含めます。

この機能を使用するには、ページ・テンプレートのヘッダー、ボディまたはフッター・セクションに#CUSTOMIZE#置換文字列を含める必要があります。

エンド・ユーザーによるカスタマイズが1つ以上のリージョンでサポートされる場合、「カスタマイズ」というリンクがページ・テンプレートで#CUSTOMIZE#置換文字列を含めた場所に表示されます。このリンクをクリックするとウィンドウが表示され、ユーザーは、ページのリージョンのオン/オフを切り替えることができるようになります。

関連項目:
「テンプレートのカスタマイズ」

リージョン・キャッシュの使用

リージョン・キャッシュの有効化は、静的HTMLを含む条件またはリージョンが使用されていないリストが含まれるリージョンなどの静的リージョンのパフォーマンスの向上に効果的な方法です。

ヒント:
リージョン・キャッシュは、対話モード・レポート・リージョンに対しては使用できません。「対話モード・レポートの編集」を参照してください。

リージョン・キャッシュを有効化すると、Application Expressエンジンによって、リージョンを動的にレンダリングするかわりにキャッシュされた(または格納された)リポジトリからリージョンをレンダリングします。実際のセッション識別子はキャッシュされないことに注意してください。かわりに、Application Expressエンジンでは、&SESSION.置換文字列がキャッシュされ、キャッシュされたリージョンをレンダリングしたカレント・セッションが表示時に代入されます。たとえば、リージョンにリンクが含まれ、リンクにセッションが含まれる場合、リンクがすべてのセッションで動作するようにするため、完全なセッションはキャッシュされません。

Application Expressエンジンは、リージョンが定義した条件を満たす場合にのみキャッシュからレンダリングします。また、リージョンは、ユーザーまたはキャッシュされた独立したユーザーに対してのみキャッシュできます。

関連項目:
「キャッシュ」

リージョン・キャッシュの有効化

リージョン・キャッシュを有効化するには、次のステップを実行します。

1. 該当するページ定義にナビゲートします。「ページ定義へのアクセス」を参照してください。

2. 「リージョン」で、リージョン名をクリックします。
リージョン定義が表示されます。

3. 「キャッシュ」までスクロールして、次の項目を指定します。

1. キャッシュ - 「キャッシュ」を選択して、ユーザーから独立したリージョンをキャッシュします。「ユーザー別のキャッシュ」を選択して、指定したユーザー固有のリージョンをキャッシュします。

2. 次の後にキャッシュをタイムアウト: キャッシュされたリージョンが有効な期間を指定します。

3. キャッシュ条件タイプ - リストから条件タイプを選択します。条件がFalseを戻す場合、リージョンは動的にレンダリングされ、キャッシュされません。条件がTrueを戻す場合、リージョンはキャッシュされます。

4. 式1および式2: 選択した特定の条件タイプに基づいて値を入力します。

4. 「変更の適用」をクリックします。

静的リージョンIDの指定

カスタムJavaScriptまたはカスケード・スタイルシートの作成時に静的リージョンIDを指定すると有効です。リージョンの編集ページの「静的ID」属性を使用して、リージョンを一意に識別できます。リージョン・テンプレート、ヘッダー、フッターまたはボディの#REGION_STATIC_ID#置換文字列を使用してリージョンを参照できます。

静的リージョンIDを指定するには、次のステップを実行します。

1. 該当するページ定義にナビゲートします。「ページ定義へのアクセス」を参照してください。
リージョン定義が表示されます。

2. 「指定」で、「静的ID」に値を入力します。

3. 「変更の適用」をクリックします。

リージョンの作成

「リージョンの作成」ウィザードを実行して、リージョンを作成します。

リージョンを作成するには、次のようにします。

1. 該当するページ定義にナビゲートします。「ページ定義へのアクセス」を参照してください。

2. 「リージョン」で、「作成」アイコンをクリックします。
「リージョンの作成」ウィザードが表示されます。

3. リージョン・タイプを選択します。詳細は、「リージョン・タイプについて」を参照してください。

4. 画面に表示されるステップに従います。

リージョン・タイプについて

リージョンの作成時には、リージョン・タイプを選択します。Application Expressエンジンは、選択したタイプに応じてリージョンを解釈します。表 9-2に、使用可能なリージョン・タイプを示します。

表 9-2 リージョン・タイプ

リージョン・タイプ

説明

HTML

HTMLを選択すると、次のいずれかを選択するプロンプトが表示されます。

- HTML: アイテムのコンテナとして機能し、指定したHTMLが含まれます。入力するHTMLには、置換文字列を含めることができます。

- HTMLテキスト(特殊文字をエスケープ): HTMLリージョンと同じですが、Application Expressエンジンによって、特殊文字がレンダリング前にエスケープされます。

- HTMLテキスト(ショートカットあり): HTMLリージョンと同じですが、ショートカットがサポートされます。

関連項目: 「ショートカットの使用」

複数のHTML

複数のHTMLリージョンを一度に作成するには、このオプションを使用します。表示されるフィールドで、各リージョンの順序、タイトル、表示ポイント、レポート・テンプレートおよび列を指定します。

レポート

レポート・リージョンは、SQL問合せを記述するか、またはウィザードを使用して問合せの記述に必要なステップを実行することによって定義できます。

参照: 「レポートの作成」

フォーム

フォーム・リージョンは、フォームを含めるために使用されます。

参照: 「フォームの作成」

チャート

チャート・リージョンには、SQL問合せに基づく線グラフ、棒グラフまたは円グラフが含まれます。

関連項目:

リスト

リスト・リージョンには、リストと呼ばれるリンクの共有コレクションが含まれます。

参照: 「リストの作成」

ブレッドクラム

ブレッドクラム・リージョンには、ブレッドクラムと呼ばれるリンクの階層的なリストが含まれます。

参照: 「ブレッドクラムの作成」

PL/SQL動的コンテンツ

PL/SQLに基づくリージョンでは、PL/SQL Webツールキットを使用してHTMLまたはテキストをレンダリングできます。

ツリー

ツリーは、実行時に実行されるSQL問合せに基づく、階層的なナビゲーション・コントロールです。ユーザーは、これを使用してノードを展開および縮小できます。

参照: 「ツリーの作成」

URL

URLに基づくリージョンでは、事前定義されたURLを使用してWebサーバーをコールすることによって、コンテンツが取得されます。

参照: 「他のWebサイトからのコンテンツの統合」

カレンダ

カレンダ・リージョンは、カレンダを含めるために使用されます。

参照: 「カレンダの作成」

ヘルプ・テキスト

ヘルプ・テキスト・リージョンでは、ページ・レベルのヘルプを指定できます。

参照: 「ヘルプ・ページの作成」

関連項目:

- PL/SQLを使用したWebアプリケーションの開発の詳細は、Oracle Databaseアドバンスト・アプリケーション開発者ガイドを参照してください。

- htpパッケージの詳細は、『Oracle Database PL/SQLパッケージおよびタイプ・リファレンス』を参照してください。

リージョンのコピー

「ページ定義」の「コピー」アイコンをクリックして、リージョンを迅速にコピーできます。「コピー」アイコンは、小さいページが2つ重なった形をしています。

リージョンをコピーすると、リージョン内のボタンおよびアイテムもコピーできます。

注意:
「ツリー」タイプのリージョンには複数のリージョンが含まれるため、コピーできません。

リージョンをコピーするには、次のステップを実行します。

1. ページ定義にナビゲートします。「ページ定義へのアクセス」を参照してください。

2. 「リージョン」で「コピー」アイコンをクリックします。
リージョンのコピー・ウィザードが表示されます。

3. 「コピーするリージョン」で、コピーするリージョンを選択します。

4. 「コピー先ページ」で、次のステップを実行します。

1. コピー先ページ: リージョンのコピー先のページを選択します。

2. リージョン・アイテムのコピー - 「はい」または「いいえ」を選択し、このリージョン内のアイテムをコピーするかどうかを決定します。

3. ボタンのコピー - 「はい」または「いいえ」を選択し、このリージョン内のボタンをコピーするかどうかを決定します。

4. 「次へ」をクリックします。

5. 「リージョンのコピー」をクリックします。

複数列レイアウトの作成

リージョンは、特定のテンプレートを使用してHTMLコンテンツの書式を設定するページ領域です。リージョンを使用すると、ページ・コントロールをグループ化できます。複数列レイアウトを作成するには、同じ表の隣接するセルに表示される2つのリージョンを作成します。

複数列レイアウトは、次のいずれかの方法で作成できます。

- 2つの隣接するリージョンを手動で作成します。

- 複数列の表を含むページ・テンプレートを定義します。

この項に含まれる内容は次のとおりです。

- 複数列のリージョンの作成

- 複数列のページ・テンプレートの作成

複数列のリージョンの作成

リージョンの作成ウィザードを使用して、リージョンを作成します。2列のページを作成するには、2つのリージョンを作成します。Oracle Application Expressによって、2列の表内の置換文字列#BOX_BODY#が置換され、2つの個別のセルにリージョンが表示されます。

リージョンを作成することによって2列のページを作成するには、次のステップを実行します。

1. ページ定義にナビゲートします。「ページ定義へのアクセス」を参照してください。

2. 1つ目のリージョンを作成します。

1. 「リージョン」で、「作成」をクリックします。
「リージョンの作成」ウィザードが表示されます。

2. リージョン・タイプを選択します。

3. 「列」フィールドから、「1」を選択します。

4. 画面に表示されるステップに従います。

3. 2つ目のリージョンを作成します。

1. 「リージョン」で、「作成」をクリックします。
「リージョンの作成」ウィザードが表示されます。

2. リージョン・タイプを選択します。

3. 「列」フィールドから、「2」を選択します。

4. 画面に表示されるステップに従います。

複数列のページ・テンプレートの作成

ページ・テンプレートは、ページ・コントロールおよびページ・コンポーネントの配置など、個々のページの外観を定義します。各ページ・テンプレートは、ヘッダー、ボディおよびフッターの3つのセクションに分かれています。最も基本的なテンプレートのボディ属性には置換文字列#BOX_BODY#が含まれている必要があります。ページのレンダリング時、Application Expressエンジンによって#BOX_BODY#がHTMLで置換され、そのページにリージョンが表示されます。

複数列のページを作成するには、複数列の表を含むページ・テンプレートを定義します。次に、特定の表のセル内にリージョンを明示的に配置します。

次の例では、2列のページを作成し、各列で置換文字列#REGION_POSITION_XX#を使用してリージョンの位置を指定する方法を示します。ページ・レベル・テンプレートのボディ・セクションに次のコードを入力します。

<body #ONLOAD#>
#FORM_OPEN#
<table style="width:100%">
<tr>
<td style="width:50%;padding:5px;">#REGION_POSITION_01#</td>
<td style="width:50%; border-left:2px #bbbbbb dashed; padding:5px;">#REGION_POSITION_02#</td>
</tr>
<br />
#BOX_BODY#
#FORM_CLOSE#
</body>

このページ・レベル・テンプレートを作成すると、リージョンの作成ウィザードの実行時に、新しく定義した位置が「表示ポイント」オプションとして選択可能になります。

アイテム属性がページ・レイアウトに与える影響

アイテムはHTMLフォームの一部であり、テキスト・フィールド、テキスト領域、パスワード、選択リスト、チェック・ボックスなどを示します。アイテム属性を変更することで、ページの外観を変更できます。たとえば、これらの属性は、ラベルの表示位置、アイテムの大きさおよびアイテムの表示位置(左右、上下)に影響します。

関連項目:
「ページ・レベル・アイテムの理解」および「ドラッグ・アンド・ドロップ・レイアウト・ページの使用」

アイテム属性を編集するには、次のステップを実行します。

1. ページ定義にナビゲートします。「ページ定義へのアクセス」を参照してください。

2. 「アイテム」で、アイテム名をクリックします。
「ページ・アイテムの編集」ページが表示されます。

表 9-3に、アイテム属性がページ・レイアウトに与える影響を示します。

表 9-3 ページ・レイアウトに影響を与えるアイテム属性

ヘッダー

属性

説明

表示

順序

リージョン内に表示されるアイテムの順序を決定します。

表示

リージョン

アイテムを表示するリージョンを定義します。すべてのアイテムは、リージョンに存在します。

表示

新しい行で開始

このアイテムを以前のアイテムと同じ行に表示するか、または次の行に表示するかを決定します。

表示

...フィールド

このアイテムを、次の列に表示するか前のアイテムと同じ列に表示するかを決定します。

表示

列スパン

アイテムは、HTML表に配置されます。アイテムを含む表セルのCOLSPAN属性に使用される値を定義します。

表示

行スパン

アイテムは、HTML表に配置されます。アイテムを表示する表セルのROWSPAN属性に使用される値を定義します。

ラベル

ラベル

このアイテムのラベルを定義します。HTML、JavaScriptおよびショートカットを含めることができます。置換文字列#CURRENT_ITEM_NAME#を使用して、このラベルに関連付けられたアイテムの名前を取得することもできます。

ラベル

横/縦の位置合せ

ラベルの配置および縦横の位置合せを制御します。ラベルは、アイテムの上、下または左に表示できます。

ラベル

テンプレート

ラベル・テンプレートを指定します。ラベル・テンプレートを使用して、アプリケーション内のラベルに一貫性のある外観を適用します。

ラベル

HTML表のセル属性

このアイテムのラベルを含むセルに、追加の属性(nowrap="nowrap"など)を定義します。

要素

要素の前のテキスト

ラジオ・グループまたは一連のチェック・ボックスの個々のオプションの表示に使用されるHTML表セルに、追加の属性を指定します。HTML、JavaScriptおよびショートカットを含めることができます。次の置換文字列を参照できます。

- #CURRENT_FORM_ELEMENT#: この要素の後のテキストが関連付けられるHTMLフォーム要素の名前を取得します。

- #CURRENT_ITEM_NAME#: この要素の後のテキストが関連付けられるアイテムの名前を取得します。

要素

要素の後のテキスト

ラジオ・グループまたは一連のチェック・ボックスの個々のオプションの表示に使用されるHTML表セルに、追加の属性を指定します。HTML、JavaScriptおよびショートカットを含めることができます。次の置換文字列を参照できます。

- #CURRENT_FORM_ELEMENT#: この要素の後のテキストが関連付けられるHTMLフォーム要素の名前を取得します。

- #CURRENT_ITEM_NAME#: この要素の後のテキストが関連付けられるアイテムの名前を取得します。

LOV

列

ラジオ・グループおよびチェック・ボックスに使用します。LOVに定義された値を表示するために使用する列の数を定義します。デフォルトでは、1つの列にすべての値を表示します。

条件

条件タイプと式

アイテムを表示するかどうかを決定する条件および適切な式を定義します。

関連項目: 「条件付きのレンダリングおよびプロセスの理解」

読取り専用の表示設定

読取り専用条件タイプ

アイテムを読取り専用で表示するかどうかを決定する条件および式を定義します。この属性を使用すると、一連のユーザーに対する特定のアイテムを更新可能として表示し、その同じアイテムを他のユーザーに対しては更新不可として表示します。異なるユーザーでコードが重複するインタフェースの必要性を低減します。

他のWebサイトからのコンテンツの統合

通常、アプリケーションのページは、Oracle Databaseに格納されたデータに基づきます。他のサーバーからコンテンツを組み込むには、コンテンツを表示するURLに基づくリージョンを作成できます。たとえば、現在のオラクル社の株価を参照すると想定します。次のようなURLに基づく、URLタイプのリージョンを作成します。

http://quote.yahoo.com/q?d=b&s=ORCL

次に、STOCK_SYMBOLというアイテムを作成して、ユーザーが入力した株価をリージョンの基にします。次に例を示します。

http://quote.yahoo.com/q?d=b&s=&STOCK_SYMBOL.

リージョンに対して必要以上に多くのHTMLが戻される場合があります(前述の例の場合など)。表示されるHTMLを制限するには、次のリージョン属性を使用できます。

- URL(破棄の終了、このテキストを含まず)

- URL(破棄の開始、このテキストを含む)

前述の例では、プロキシ・サーバー・アプリケーション属性の設定が必要な場合があることに注意してください。プロキシ・サーバー・アプリケーション属性を指定しない場合、エラー・メッセージが表示されます。Oracle Application Expressは、Oracleのutl_http.request_piecesファンクションを使用して、指定したURLから生成されたHTMLを取得します。「アプリケーション定義の構成」を参照してください。

SSL有効URLでの作業

SSL有効URL(Webサービスの起動など)をコールする場合、またはSSL有効URLタイプのリージョンを作成する場合、ウォレットを作成する必要があります。ウォレットは、SSLに必要な認証および署名された資格証明(秘密鍵、証明書および信頼できる証明書)の格納に使用されるパスワード保護されたコンテナです。

ヒント:
Oracle Application Express管理ガイドの「ウォレット情報の構成」を参照してください。

イメージの管理

アプリケーション内のイメージは、イメージ・リポジトリにアップロードすることで参照できます。イメージをアップロードする際、そのイメージをすべてのアプリケーションで使用可能にするか、特定のアプリケーションで使用可能にするかを指定できます。

この項に含まれる内容は次のとおりです。

- イメージのアップロード

- イメージの参照

- イメージ属性の編集

- イメージの削除

ヒント:
イメージ・ファインダを使用して、カレント・アプリケーションに使用可能なイメージを識別できます。「イメージ・ファインダの使用」を参照してください。

イメージのアップロード

イメージ・リポジトリを使用して、イメージをワークスペースにアップロードします。

イメージをワークスペースにアップロードするには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。
共有コンポーネント・ページが表示されます。

4. 「ファイル」で、「イメージ」を選択します。
イメージ・ページが表示されます。

5. イメージをアップロードするには、「作成」をクリックします。

6. イメージの作成ページで、次のように指定します。

1. アプリケーション: 「関連付けられたアプリケーションなし」を選択して、ワークスペース内のすべてのアプリケーションでイメージを使用できるようにするか、特定のアプリケーションIDを選択します。

2. 新しいイメージをアップロード: 「参照」をクリックして、アップロードするファイルを指定します。

3. ノート: イメージについて説明する詳細を入力します。

7. 「アップロード」をクリックします。

イメージの参照

置換文字列#IMAGE_PREFIX#を参照するか、完全修飾されたURLをイメージに含めることで、アプリケーション内のイメージを参照できます。

この項に含まれる内容は次のとおりです。

- 仮想イメージ・ディレクトリの接頭辞の確認

- #IMAGE_PREFIX#を使用したイメージの参照

- 完全修飾URLを使用したイメージの参照

仮想イメージ・ディレクトリの接頭辞の確認

アプリケーション・ビルダーのインストール時に、イメージ用の仮想ディレクトリがインストーラによって作成されます。この仮想ディレクトリは、アップロードされたイメージを含むファイル・システム上の実際のパスを指します。デフォルトでは、接頭辞を使用してこの仮想ディレクトリを参照します。

/i/

アプリケーションを最初に作成する際、定義の編集ページでこの接頭辞を検証する必要があります。

アプリケーションのイメージ接頭辞を検証するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

4. 「アプリケーション」で、「定義」を選択します。

5. アプリケーション定義の編集ページが表示された後、「イメージ接頭辞」フィールドを検索します。
デフォルトでは、この属性は/i/と定義されています。ご使用の環境でのこの仮想ディレクトリの名前については、管理者に問い合せてください。

#IMAGE_PREFIX#を使用したイメージの参照

静的テキスト(ページ・ヘッダー、リージョン・ヘッダー、リージョン・フッターなど)にイメージを埋め込む場合は、置換文字列#IMAGE_PREFIX#を使用してイメージを参照できます。たとえば、イメージgo.gifを参照するには、次の構文を使用します。

<img src="#IMAGE_PREFIX#go.gif">

関連項目:
「組込み置換文字列について」、「IMAGE_PREFIX」、「APP_IMAGES」および「WORKSPACE_IMAGES」

完全修飾URLを使用したイメージの参照

また、完全修飾されたURLを使用してイメージを参照することもできます。次に例を示します。

<img src="http://g-images.amazon.com/images/G/01/associates/navbar2000/logo-no-border(1).gif">

イメージ属性の編集

イメージ属性の編集では、イメージについて説明する注意の追加、または関連付けられたアプリケーションの変更ができます。しかし、実際のイメージは変更できません。イメージを変更するには、イメージを削除して再度アップロードします。

関連項目:
「イメージの削除」および「イメージのアップロード」

イメージ属性を編集するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。
共有コンポーネント・ページが表示されます。

4. 「ファイル」で、「イメージ」を選択します。
イメージ・ページが表示されます。

5. 次のコントロールを選択してビューにフィルタを適用します。

1. イメージ - テキストを入力して、イメージ名またはイメージの説明テキストを検索します。検索対象として、「すべてのイメージ」、「ワークスペース・イメージ」または「アプリケーション・イメージ」を選択します。

2. ビュー - 次のいずれかを選択します。

- アイコン(デフォルト): 各イメージを大きいアイコンとして表示します。

- 詳細: 各イメージをレポートで1行に表示します。

3. 表示 - 表示するイメージの数を決定します。

4. 「実行」をクリックします。

6. イメージを選択します。
イメージ属性の編集ページが表示されます。

7. 「アプリケーション」から、イメージの可用性を指定します。
「関連付けられたアプリケーションなし」を選択して、ワークスペース内のすべてのアプリケーションでイメージを使用できるようにするか、特定のアプリケーションIDを選択します。

8. ノートで、イメージについて説明する詳細を入力します。

9. 「変更の適用」をクリックします。

イメージの削除

イメージを削除するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。
共有コンポーネント・ページが表示されます。

4. 「ファイル」で、「イメージ」を選択します。
イメージ・ページが表示されます。

5. 次のいずれかを選択してビューにフィルタを適用します。

1. イメージ - テキストを入力して、イメージ名またはイメージの説明テキストを検索します。検索対象として、「すべてのイメージ」、「ワークスペース・イメージ」または「アプリケーション・イメージ」を選択します。

2. ビュー - 次のいずれかを選択します。

- アイコン(デフォルト): 各イメージを大きいアイコンとして表示します。

- 詳細: 各イメージをレポートで1行に表示します。

3. 「実行」をクリックします。

6. イメージを選択します。

7. 「削除」をクリックします。

静的ファイルの管理

静的ファイル・リポジトリを使用して、静的ファイルをワークスペースにアップロードできます。

この項に含まれる内容は次のとおりです。

- 静的ファイルのアップロード

- アップロードしたファイルの編集

- アップロードしたファイルのダウンロード

- アップロードしたファイルの削除

静的ファイルのアップロード

静的ファイルをアップロードするには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。
共有コンポーネント・ページが表示されます。

4. 「ファイル」で、「静的ファイル」を選択します。
静的ファイル・ページが表示されます。

5. ファイルをアップロードするには、「作成」をクリックします。

6. 画面に表示されるステップに従います。

アップロードしたファイルの編集

30,000バイト未満の静的ファイルは、ファイル名を選択して編集できます。それ以外の場合は、ファイルをオフラインで編集し、再度アップロードする必要があります。

30,000バイト未満の静的ファイルを編集するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。
共有コンポーネント・ページが表示されます。

4. 「ファイル」で、「静的ファイル」を選択します。
静的ファイル・ページが表示されます。

5. 次のコントロールを選択してビューにフィルタを適用します。

1. 静的ファイル - テキストを入力して、ファイル名またはファイルの説明テキストを検索します。

2. アプリケーション - 次のいずれかの項目を選択して、ビューを絞り込むか範囲を広げます。

- すべての静的ファイル

- 関連付けられたアプリケーションなし

- 特定のアプリケーション

3. ビュー - 次のいずれかを選択します。

- アイコン(デフォルト): を選択すると、各ファイルを大きいアイコンとして表示します。

- 詳細: 各ファイルをレポートで1行に表示します。

4. 表示 - 表示するファイルの数を決定します。

5. 「実行」をクリックします。

6. ファイルを選択します。

7. ファイルが30,000バイトより小さい場合、ファイルを編集します。

8. 「注意」で、ファイルの説明のテキストを編集または入力します。

9. 「変更の適用」をクリックします。

アップロードしたファイルのダウンロード

アップロードしたファイルをダウンロードするには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。
共有コンポーネント・ページが表示されます。

4. 「ファイル」で、「静的ファイル」を選択します。
静的ファイル・リポジトリが表示されます。

5. 「ビュー」から「詳細」を選択し、「実行」をクリックします。
各ファイルをレポートで1行に表示します。

6. 該当するファイルの横にある「ダウンロード」アイコンを選択します。

アップロードしたファイルの削除

アップロードした静的ファイルを削除するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。
共有コンポーネント・ページが表示されます。

4. 「ファイル」で、「静的ファイル」を選択します。
静的ファイル・リポジトリが表示されます。

5. 次のコントロールを選択してビューにフィルタを適用します。

1. 静的ファイル - テキストを入力して、ファイル名またはファイルの説明テキストを検索します。

2. アプリケーション - 次のいずれかの項目を選択して、ビューを絞り込むか範囲を広げます。

- すべての静的ファイル

- 関連付けられたアプリケーションなし

- 特定のアプリケーション

3. ビュー - 次のいずれかを選択します。

- アイコン(デフォルト): を選択すると、各ファイルを大きいアイコンとして表示します。

- 詳細: 各ファイルをレポートで1行に表示します。

4. 表示 - 表示するファイルの数を決定します。

5. 「実行」をクリックします。

6. ファイルを選択します。

7. 「削除」をクリックします。

カスタムPL/SQLを使用したHTMLのレンダリング

Oracle Application Expressのフォーム、レポートおよびチャートによって処理されない特定のHTMLコンテンツを生成する必要がある場合、PL/SQLタイプのリージョンを使用できます。このタイプのリージョンにHTMLを生成するには、PL/SQL Webツールキットを使用する必要があります。バインド変数構文を使用して、セッション・ステートを参照できます。この方法でHTMLを生成する場合、テンプレートの場合と同じ一貫性および制御は得られないことに注意してください。

関連項目:

- PL/SQLを使用したWebアプリケーションの開発の詳細は、Oracle Databaseアドバンスト・アプリケーション開発者ガイドを参照してください。

- htpパッケージの詳細は、『Oracle Database PL/SQLパッケージおよびタイプ・リファレンス』を参照してください。

リージョン内に生成されるHTMLをより動的に制御するには、PL/SQLを使用できます。たとえば、現在の日付を出力するには、次のソースを持つリージョンを作成できます。

htp.p(TO_CHAR(SYSDATE,'Day Month DD, YYYY'));

次の例では、表にアクセスします。

DECLARE
l_max_sal NUMBER;
BEGIN
SELECT max(sal) INTO l_max_sal FROM emp;
htp.p('The maximum salary is: '||TO_CHAR(l_max_sal,'999,999.00'));
END;

10 テーマおよびテンプレートの管理

ここでは、テーマおよびテンプレートを使用して、アプリケーションのユーザー・インタフェースおよびページ・レイアウトを変更する様々な方法について説明します。

この項には、次の項目が含まれます。

- テーマの管理

- テンプレートのカスタマイズ

- カスタム・カスケード・スタイルシートの使用

関連項目:
「ナビゲーションの追加」および「ドラッグ・アンド・ドロップ・レイアウト・ページの使用」

テーマの管理

テーマは、アプリケーション全体のレイアウトおよびスタイルの定義に使用できるテンプレートのコレクションです。テーマにはテンプレートの完全なセットが用意され、アプリケーションに必要となる可能性があるすべてのUIパターンが提供されます。テンプレートは、まずタイプ別(ブレッドクラム、ボタン、カレンダ、ラベル、リスト、ページ、ポップアップLOV、リージョンおよびレポート)に分類され、次に、そのタイプ内の各テンプレートの用途を示すテンプレート・クラスごとに分類されます。各テンプレート・タイプには、標準クラスのグループおよび8つのカスタム・クラスが用意されています。このような分類によって、Oracle Application Expressではテーマ間でのテンプレートのマッピングが可能になり、アプリケーション全体のルック・アンド・フィールを簡単に変更できます。

Oracle Application Expressには、広範なテーマ・リポジトリが同梱されています。次のように、テーマをテーマ・リポジトリに追加できます。

- ワークスペース管理者はワークスペース・テーマを作成できます。ワークスペース・テーマはワークスペース内のすべての開発者が使用できます。「ワークスペース・テーマの管理」を参照してください。

- インスタンス管理者はパブリック・テーマを作成できます。Application Express管理サービスを使用して、パブリック・テーマを追加します。追加すると、これらのテーマはすべてのワークスペースですべての開発者が使用できます。Oracle Application Express管理ガイドの「Oracle Application Expressインスタンスのテーマの管理」を参照してください。

この項に含まれる内容は次のとおりです。

- テーマ・ページへのアクセス

- テーマのデフォルトのテンプレートの変更

- テーマの作成

- テーマの編集

- アクティブなテーマの切替え

- テーマのコピー

- テーマの削除

- ワークスペース・テーマの管理

- テーマのエクスポートおよびインポートについて

- テーマ識別番号の変更

- テーマ・レポートの表示

関連項目:
「テンプレートのカスタマイズ」

テーマ・ページへのアクセス

テーマ・ページでテーマを管理します。共有コンポーネント・ページまたは「ページ定義」からテーマ・ページにアクセスできます。

この項に含まれる内容は次のとおりです。

- 「共有コンポーネント」からのテーマ・ページへのアクセス

- 「ページ定義」からのテーマ・ページへのアクセス

- テーマ・ページについて

「共有コンポーネント」からのテーマ・ページへのアクセス

「共有コンポーネント」からテーマ・ページにアクセスするには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「ユーザー・インタフェース」で、「テーマ」を選択します。
テーマ・ページが表示されます。

5. 「ビュー」リストから「詳細」を選択し、「実行」をクリックします。
現在の列のチェック・マークはどのテーマが選択されたかを示します。

6. テーマ名をクリックします。
テーマの作成/編集ページが表示されます。

「ページ定義」からのテーマ・ページへのアクセス

ページ定義からテーマ・ページにアクセスするには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. ページを選択します。
ページ定義が表示されます。

4. 「共有コンポーネント」で、「テーマ」セクションを特定します。

5. テーマ名をクリックします。
テーマの作成/編集ページが表示されます。

テーマのデフォルトのテンプレートの変更

標準テーマには、すべてのタイプのアプリケーション・コンポーネントおよびリージョン・タイプのテンプレートが含まれます。テーマに選択したデフォルトのテンプレートを、テーマの作成/編集ページで変更できます。

テーマのデフォルトのテンプレートは、コンポーネントやリージョンの作成時に別のテンプレートを選択するか、またコンポーネントやリージョンの属性ページでテンプレートを変更することによって、オーバーライドできます。

テーマのデフォルトのテンプレーを確認または変更するには、次のステップを実行します。

1. テーマ・ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「ユーザー・インタフェース」で、「テーマ」を選択します。
テーマ・ページが表示されます。

2. テーマを編集するには、次のステップを実行します。

1. 「ビュー」リストから「詳細」を選択し、「実行」をクリックします。

2. テーマ名をクリックします。

テーマの作成/編集ページが表示されます。

テーマの作成/編集ページはいくつかのセクションに分かれています。これらのセクションにアクセスするには、ページをスクロール・ダウンするか、ページ上部のナビゲーション・ボタンをクリックします。ページ上部のボタンを選択すると、選択されたセクションが表示され、その他のセクションはすべて一時的に非表示になります。ページのすべてのセクションを表示するには、「すべて表示」をクリックします。

アプリケーションIDおよびテーマ識別番号は、ページの上部に表示されます。

3. テーマ名を変更するには、「名前」フィールドに名前を入力します。

4. デフォルトのテンプレートを変更するには、該当するリストから選択します。
表10-1に、 「コンポーネントのデフォルト値」で使用可能なデフォルトのテンプレートを示します。

表 10-1 コンポーネントのデフォルトのテンプレート

属性

説明

ページ

ページを表示するためのデフォルトのテンプレートを指定します。開発者が明示的にテンプレートを選択しない場合、Application Expressエンジンは、ここで指定されたテンプレートを使用します。

デフォルトのテンプレートを定義すると、定義の編集ページのヘッダー「デフォルトのアプリケーション・テンプレート」に、このテンプレートが表示されます。

関連項目: ページ属性ページでのページ・テンプレートの上書きについては、「表示属性」を参照してください。

エラー・ページ

インライン表示されるエラーではなく、個別のページに表示されるエラーに使用するページ・テンプレートを指定します。エラーを表示するように設計されたテンプレートを使用しない場合、この属性は、空白のままにします。

デフォルトのテンプレートを定義すると、定義の編集ページのヘッダー「デフォルトのアプリケーション・テンプレート」に、このテンプレートが表示されます。

印刷用ページ

Application Expressエンジンが印刷用モードの場合に使用するテンプレートを指定します。

関連項目: 「印刷用ページの最適化」

ブレッドクラム

ブレッドクラムを作成する場合に使用するデフォルトのブレッドクラム・テンプレートを指定します。

ボタン

ボタンを作成する場合に使用するデフォルトのボタン・テンプレートを指定します。

カレンダ

カレンダを作成する場合に使用するデフォルトのカレンダ・テンプレートを指定します。

ラベル

ラベルを作成する場合に使用するデフォルトのラベル・テンプレートを指定します。

リスト

リストを作成する場合に使用するデフォルトのリスト・テンプレートを指定します。

リージョン

リージョンを作成する場合に使用するデフォルトのリージョン・テンプレートを指定します。

レポート

レポートを作成する場合に使用するデフォルトのリージョン・テンプレートを指定します。

表 10-2に、「リージョンのデフォルト値」セクションで使用可能なデフォルトのテンプレートを示します。

表 10-2 リージョンのデフォルト値

属性

説明

ブレッドクラム

ブレッドクラムを作成する場合に使用するデフォルトのリージョン・テンプレートです。

チャート

チャートを作成する場合に使用するデフォルトのチャート・テンプレートです。

フォーム

フォームを作成する場合に使用するデフォルトのフォーム・テンプレートです。

リスト

リストを作成する場合に使用するデフォルトのリージョン・テンプレートです。

レポート

レポートを作成する場合に使用するデフォルトのリージョン・テンプレートです。

表形式フォーム

表形式フォームを作成する場合に使用するデフォルトのリージョン・テンプレートです。

ウィザード

ウィザード・コンポーネントを作成する場合に使用するデフォルトのリージョン・テンプレートです。

テーマの作成

新しく作成するか、またはリポジトリから既存のテーマを選択することによって、テーマを作成できます。

テーマを作成するには、次のステップを実行します。

1. テーマ・ページにナビゲートします。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「ユーザー・インタフェース」で、「テーマ」を選択します。

2. 「作成」をクリックします。

3. 次のいずれかの作成方法を選択します。

- リポジトリから

- 最初から

- エクスポートから

4. 画面に表示されるステップに従います。

5. 特定のフィールドの詳細を表示するには、フィールド・ラベルをクリックします。
ヘルプが利用できる場合は、アイテム・ラベル上にカーソルを重ねると、アイテム・ラベルが赤色に変わり、カーソルが矢印と疑問符に変わります。「フィールドレベル・ヘルプについて」を参照してください。

テーマ・ページについて

テーマを作成すると、テーマ・ページに表示されます。ナビゲーション・バーはページの上部に表示され、次のコントロールが含まれています。

- テーマ: テーマ名に対し大/小文字を区別しない問合せを入力して、「実行」をクリックします。すべてのページを表示する場合は、フィールドをブランクのままにして「実行」をクリックします。

- ビュー:ページの表示方法を制御できます。オプションは次のとおりです。

- アイコン(デフォルト): 各テーマを大きいアイコンとして表示します。テーマを編集するには、該当するアイコンをクリックします。

- 詳細: 各テーマをレポートで1行に表示します。テーマ名またはデフォルトのテンプレートを変更するには、テーマ名をクリックします。「詳細」ビューで、「表示」リストから次のオプションを選択できます。

- サマリー・ビュー: テーマ番号、名前および現在のステータスが表示されます。

- 詳細ビュー: テーマ番号、名前、現在のステータス、および各テンプレート・タイプのテンプレート数が表示されます。

- 「表示」。テーマの表示方法を指定します。数の増減を行うには、「表示」リストで選択を行ってから「実行」をクリックします。

テーマの編集

新しく作成するか、またはリポジトリから既存のテーマを選択することによって、テーマを作成できます。

テーマを作成するには、次のステップを実行します。

1. テーマ・ページにナビゲートします。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「ユーザー・インタフェース」で、「テーマ」を選択します。

2. 「タスク」リストで、「テーマの編集」をクリックします。
テーマの作成/編集ページが表示されます。

3. 特定のフィールドの詳細を表示するには、フィールド・ラベルをクリックします。
ヘルプが利用できる場合は、アイテム・ラベル上にカーソルを重ねると、アイテム・ラベルが赤色に変わり、カーソルが矢印と疑問符に変わります。「フィールドレベル・ヘルプについて」を参照してください。

4. 適切に編集を行い、「変更の適用」をクリックします。

関連項目:
「テンプレートのカスタマイズ」

アクティブなテーマの切替え

テーマに切り替えると、テンプレートに割り当てられたすべてのコンポーネントは、テーマの対応するテンプレートに割り当てられます。アプリケーション・ビルダーは、テンプレート・クラス識別子の割当てによってテンプレート・マッピングを行います。

注意:
テーマが存在する場合にのみ、そのテーマに切り替えることができます。たとえば、リポジトリで使用可能なテーマに切り替える前に、最初にテーマを作成する必要があります。「テーマの作成」を参照してください。

アプリケーションにテーマを使用するには、次のステップを実行します。

1. テーマ・ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「ユーザー・インタフェース」で、「テーマ」を選択します。

2. 「テーマの切替え」をクリックします。
テーマの切替えページが表示されます。

3. 「次のテーマに切替え」からテーマを選択し、「次へ」をクリックします。

4. 「ステータス」列を確認し、マッピング上の問題を特定します。

- チェック: マッピングが成功したことを示します。

- 警告: 切替え先のテーマに、指定されたクラスを持つ複数のテンプレートがあることを示します。この警告では、適切なテンプレートを選択するための選択リストが提供されます。

- エラー: アプリケーション・ビルダーがテーマ間でクラスをマップできなかったことを示します。クラスが両方のテーマのテンプレートで指定されていることを確認します。

5. 「次へ」をクリックして続行します。

6. 「テーマの切替え」をクリックします。

関連項目:
「テーマの作成」

テーマのコピー

すべてのテーマは、数値による識別番号(ID)で識別されます。テーマをコピーする場合は、テーマIDを指定します。テーマのコピーは、テーマの編集を試行したり、テーマに異なるIDを付けてエクスポートする場合に便利です。

テーマをコピーするには、次のステップを実行します。

1. テーマ・ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「ユーザー・インタフェース」で、「テーマ」を選択します。

2. 「タスク」リストで、「テーマのコピー」をクリックします。

3. 「テーマのコピー」で、次の操作を実行します。

1. 次のテーマからコピー: コピーするテーマを選択します。

2. このテーマ識別番号にコピー: そのテーマの新しいIDを入力します。

3. 「次へ」をクリックします。

4. 「テーマIDをコピー」をクリックします。

テーマの削除

アクティブではないテーマのみ削除できます。テーマを削除すると、アプリケーション・ビルダーによって、アクティブではないテンプレートのみ削除されます。

テーマを削除するには、次のステップを実行します。

1. テーマ・ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「ユーザー・インタフェース」で、「テーマ」を選択します。

2. 「タスク」リストで、「テーマの削除」をクリックします。

3. 「テーマの削除」で、削除するテーマを選択し、「次へ」をクリックします。

4. 「テーマの削除」をクリックします。

ワークスペース・テーマの管理

ワークスペース管理者は、ワークスペースのテーマ・リポジトリを管理します。ワークスペース管理者は、リポジトリにテーマを追加してワークスペース内のすべての開発者がそのテーマを使用できるようにしたり、テーマを削除することができます。

この項に含まれる内容は次のとおりです。

- テーマ・リポジトリへのテーマの追加

- ワークスペース・テーマの削除

- ワークスペース・テーマの変更

- ワークスペース・テーマのエクスポートについて

関連項目:
Oracle Application Express管理ガイドの「Oracle Application Expressインスタンスのテーマの管理」

テーマ・リポジトリへのテーマの追加

テーマをテーマ・リポジトリに追加するには、次のステップを実行します。

1. テーマ・ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「ユーザー・インタフェース」で、「テーマ」を選択します。

2. 「タスク」リストから「ワークスペース・テーマの管理」をクリックします。

3. 「作成」を選択し、「次へ」をクリックします。

4. 「コピーするアプリケーション・テーマ」では、必要なテーマを選択して「次へ」をクリックします。

5. 「名前の指定」では、テーマ番号、名前およびオプションで説明を入力し、「次へ」をクリックします。

6. 「ワークスペース・テーマの作成」をクリックします。

ワークスペース・テーマの削除

ワークスペース・テーマを削除するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. 「タスク」リストで「ワークスペース・テーマ」をクリックします。

3. 削除するテーマを選択します。

4. 「削除」をクリックします。

ワークスペース・テーマの変更

ワークスペース・テーマを直接編集することはできません。ワークスペース・テーマを変更するには、そのテーマを使用してアプリケーションを作成し、テーマを変更します。次に、関連するアプリケーション・ファイルをエクスポートするのと同じ方法で、テーマをワークスペース・テーマ・リポジトリに手動で追加する必要があります。

ワークスペース・テーマを変更するには、次のステップを実行します。

1. 変更するテーマを使用して、アプリケーションを作成します。「アプリケーションの作成」を参照してください。

2. テーマを変更します。「テーマの編集」を参照してください。

3. 既存のワークスペース・テーマを削除します。「ワークスペース・テーマの削除」を参照してください。

4. 変更したテーマをワークスペース・テーマ・リポジトリに追加します。「テーマ・リポジトリへのテーマの追加」を参照してください。

ワークスペース・テーマのエクスポートについて

テーマのエクスポートは、関連するアプリケーション・ファイルのエクスポートと同様の方法で行います。ワークスペース・テーマをエクスポートするには、次のステップを実行します。

1. テーマを使用して、アプリケーションを作成します。「アプリケーションの作成」を参照してください。

2. アプリケーションをエクスポートします。「アプリケーションのエクスポート」を参照してください。

3. エクスポートされたファイルをターゲットのOracle Application Expressインスタンスにインポートします。「アプリケーションまたはページのインポート」を参照してください。

4. エクスポートされたファイルをエクスポート・リポジトリからインストールします。「エクスポート・ファイルのインストール」を参照してください。

テーマのエクスポートおよびインポートについて

テーマのエクスポートは、関連するアプリケーション・ファイルのエクスポートと同様の方法で行います。1つの開発インスタンスから別のインスタンスへテーマをエクスポートするには、次のステップを実行します。

1. テーマを使用して、アプリケーションを作成します。「アプリケーションの作成」を参照してください。

2. 「テーマのエクスポート」ユーティリティを使用してテーマをエクスポートします。「テーマのエクスポート」を参照してください。

3. エクスポートされたファイルをターゲットのOracle Application Expressインスタンスにインポートします。「エクスポート・ファイルのインポート」を参照してください。

4. エクスポートされたファイルをエクスポート・リポジトリからインストールします。「エクスポート・ファイルのインストール」を参照してください。

テーマ識別番号の変更

すべてのテーマには、識別番号(ID)があります。テーマIDの変更ユーティリティを使用して、テーマIDを別の識別番号に変更できます。テーマIDの変更は、テーマに異なる番号を付けてエクスポートし、別のアプリケーションにインポートする場合に便利です。

テーマ識別番号を変更するには、次のステップを実行します。

1. テーマ・ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「ユーザー・インタフェース」で、「テーマ」を選択します。

2. 「タスク」リストで、「指定番号の変更」をクリックします。

3. テーマ番号の場合は、次のステップを実行します。

1. テーマの指定: テーマを選択します。

2. このテーマ指定番号に変更: 識別番号を指定します。

3. 「次へ」をクリックします。

4. 変更内容を確認して、「テーマIDの変更」をクリックします。

テーマ・レポートの表示

アプリケーション・ビルダーには、テーマおよびテンプレートの管理に役立つ多くのレポートが含まれています。

この項に含まれる内容は次のとおりです。

- テーマのすべてのテンプレートの表示

- テーマ・テンプレート数の表示

- ファイル参照の表示

- クラス参照の表示

- テンプレートの置換文字列の表示

テーマのすべてのテンプレートの表示

テーマを構成しているすべてのテンプレートを表示するには、次のステップを実行します。

1. テーマ・ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「ユーザー・インタフェース」で、「テーマ」を選択します。

2. 「レポート」をクリックします。

3. テーマ・レポート・ページで、次のステップを実行します。

1. 「レポート」から「アプリケーション・テンプレート」を選択します。

2. 「テーマ」からテーマを選択します。

3. 「実行」をクリックします。

テンプレートのリストには、テンプレート・タイプ、テンプレート名、対応するテーマおよびテンプレート・クラスの一覧が表示されます。

4. テンプレートを編集するには、テンプレート名を選択します。

テーマ・テンプレート数の表示

「テーマ・テンプレート数」レポートには、現在、テンプレート・クラス用に作成されたテンプレートがあるテンプレート・クラスが表示されます。

テーマ・テンプレート数レポートを表示するには、次のステップを実行します。

1. テーマ・ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「ユーザー・インタフェース」で、「テーマ」を選択します。

2. 「レポート」をクリックします。

3. テーマ・レポート・ページで、次のステップを実行します。

1. 「レポート」から「テーマ・テンプレート数」を選択します。

2. 「テーマ」からテーマを選択します。

3. 「実行」をクリックします。

4. カスタムの分類を使用する場合は、「カスタムの表示」を選択し、「実行」をクリックします。

ファイル参照の表示

ファイル参照のレポートには、テンプレートに関連付けられたすべてのファイル、共有コンポーネント、カレント・アプリケーションのページ・コンポーネントの一覧が表示されます。

「ファイル参照」のレポートを表示するには、次のステップを実行します。

1. テーマ・ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「ユーザー・インタフェース」で、「テーマ」を選択します。

2. テーマ・ページで「レポート」をクリックします。

3. テーマ・レポート・ページで、次のステップを実行します。

1. 「レポート」から「ファイル参照」を選択します。

2. 「テーマ」からテーマを選択します。

3. 「実行」をクリックします。

4. 「ファイル参照」ページで、次のステップを実行します。

1. 「表示」から、レポートに含めるコンポーネントのタイプを選択します。選択しない場合は、結果が戻されません。

2. 「ファイルの表示」から次のいずれかの項目を選択します。

- コンテキスト付き: コンポーネント、テーマ識別番号、コンポーネント名、イメージ(使用可能な場合)、およびページ番号を表示します。ページ定義にリンクするには、ページ番号を選択します。

- コンテキストなし: ファイル名およびイメージ(使用可能な場合)のみ表示します。

3. 「ファイル拡張子」から検索する拡張子のタイプを選択します。

4. 「実行」をクリックします。

5. このレポートのカンマ区切りファイル(.csv)をダウンロードするには、ページ下部の「ダウンロード」をクリックします。

クラス参照の表示

クラス参照のレポートにアクセスすると、テンプレートに関連付けられたクラス、共有コンポーネント、カレント・アプリケーションのページ・コンポーネントの一覧が表示されます。

クラス参照のレポートを表示するには、次のステップを実行します。

1. テーマ・ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「ユーザー・インタフェース」で、「テーマ」を選択します。

2. 「レポート」をクリックします。

3. テーマ・レポート・ページで、次のステップを実行します。

1. 「レポート」から「クラス参照」を選択します。

2. 「テーマ」からテーマを選択します。

3. 「実行」をクリックします。

4. 「クラス参照」ページで、次のステップを実行します。

1. 「表示」から、クラス参照を確認するコンポーネントを選択します。選択しない場合は、結果が戻されません。

2. 「クラス名の表示」から、次のいずれかを選択します。

- コンテキスト付き: コンポーネント、テーマ識別番号、コンポーネント名、イメージ(使用可能な場合)、およびページ番号を表示します。

- コンテキストなし: 参照されるクラスのみを表示します。

3. 「実行」をクリックします。

5. このレポートのカンマ区切りファイル(.csv)をダウンロードするには、ページ下部の「ダウンロード」をクリックします。

テンプレートの置換文字列の表示

「テンプレート置換文字列」レポートを使用すると、コンポーネントがサポートする置換文字列がすべて表示されます。

「置換文字列」レポートを表示するには、次のステップを実行します。

1. テーマ・ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「ユーザー・インタフェース」で、「テーマ」を選択します。

2. 「レポート」をクリックします。

3. テーマ・レポート・ページで、次のステップを実行します。

1. 「レポート」リストから、「テンプレート置換文字列」を選択します。

2. 「テーマ」リストから、レポートに含めるテーマを選択します。

3. 「実行」をクリックします。

4. テンプレート定義にリンクするには、コンポーネント名を選択します。

関連項目:
「置換文字列の理解」

テンプレートのカスタマイズ

Application Expressエンジンは、テーマと呼ばれるテンプレートのコレクションに基づいて、アプリケーションのユーザー・インタフェースを作成します。テンプレートは、アプリケーション内のコンポーネントのルック・アンド・フィールを制御します。カスタム・テンプレートを作成するには、既存のテンプレートを変更する方法がより簡単です。作成した1つ以上のデフォルト・テンプレートは、必要に応じて変更できます。

この項に含まれる内容は次のとおりです。

- カスケード・スタイルシートについて

- デフォルトのページ・テンプレートの選択

- 新しいテンプレートの作成

- テンプレート・レポートの表示

- テンプレートの管理

- ブレッドクラム・テンプレート

- ボタン・テンプレート

- カレンダ・テンプレート

- ラベル・テンプレート

- リスト・テンプレート

- ページ・テンプレート

- ポップアップLOVテンプレート

- リージョン・テンプレート

- レポート・テンプレート

関連項目:
テーマの管理

カスケード・スタイルシートについて

カスケード・スタイルシート(CSS)によって、構造を変更せずにWebページのスタイルを制御できます。CSSを適切に使用すると、カラー、余白、フォントなどの視覚属性がHTMLドキュメントの構造から切り離されます。Oracle Application Expressのテーマには、独自のCSSを参照するテンプレートを含めることができます。特定のテーマの各CSSで定義されたスタイル・ルールによって、レポートおよびリージョンの表示も指定されます。

関連項目:
「CSSファインダの使用」および「カスタム・カスケード・スタイルシートの使用」

デフォルトのページ・テンプレートの選択

デフォルトのページ・テンプレートは、2つの方法で指定できます。

- 特定のテーマ内のデフォルトのページ・テンプレートを選択します。

- ページごとに特定のページ・テンプレートを選択します。

デフォルトでは、Application Expressエンジンは、テーマ・ページで指定されたページ・テンプレートを使用します。

この項に含まれる内容は次のとおりです。

- テーマ内のページ・レベル・テンプレートの選択

- 特定のページのページ・レベル・テンプレートの選択

テーマ内のページ・レベル・テンプレートの選択

テーマ内のデフォルトのページ・テンプレートを指定するには、次のステップを実行します。

1. テーマ・ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「ユーザー・インタフェース」で、「テーマ」を選択します。
テーマ・ページが表示されます。

2. 「ビュー」から「詳細」を選択し、「実行」をクリックします。

3. 「テーマ」リストで、テーマ名を選択します。
テーマの作成/編集ページが表示されます。

4. 「コンポーネントのデフォルト値」で、「ページ」リストから選択します。

5. ページ上部の「変更の適用」をクリックします。

関連項目:
「テーマのデフォルトのテンプレートの変更」

特定のページのページ・レベル・テンプレートの選択

特定のページにページ・レベル・テンプレートを指定するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. ページを選択します。

4. 「ページ」で、「ページ属性の編集」アイコンをクリックします。

5. 「表示属性」セクションを探します。

6. 「ページ・テンプレート」リストから選択します。

7. ページ上部の「変更の適用」をクリックします。

新しいテンプレートの作成

カスタム・テンプレートを作成するには、まず既存のテンプレートを変更する方法が最も簡単です。作成した1つ以上のデフォルト・テンプレートは、必要に応じて変更できます。

カスタム・テンプレートを作成するには、次のステップを実行します。

1. 「テンプレート」ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「ユーザー・インタフェース」で、「テンプレート」を選択します。

2. 「作成」をクリックします。

3. 作成するテンプレートのタイプを選択します。

4. 次のいずれかの作成方法を選択します。

- 最初から

- 既存のテンプレートのコピーとして

5. 画面に表示されるステップに従います。

ヒント:
テンプレートが適切なテーマに関連付けられていることを確認します。

テンプレート・レポートの表示

アプリケーション・ビルダーには、テンプレートの使用状況、サブスクリプション、パブリッシュされたテンプレートおよび編集履歴を示すレポートがあります。

カレント・アプリケーションについてのテンプレート・レポートを表示するには、次のステップを実行します。

1. テーマ・ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「ユーザー・インタフェース」で、「テンプレート」を選択します。

2. 次のリストから選択し、「実行」をクリックして、表示を絞り込むことができます。

- テンプレート名: 大/小文字を区別しない問合せを入力します。

- テーマ: 特定のテーマのテンプレートのみを表示します。

- 参照: 表示するテンプレートのタイプを選択します。

- タイプ - テンプレート・タイプのタイプを選択します。

- 期間: レポートを特定の時間枠に制限します。レポートに含める時間を選択します。

- サブスクライブ: すべてのテンプレート、サブクライブされたテンプレートまたはサブスクライブされていないテンプレートを表示するかどうかを指定します。

3. テンプレート・レポートを表示するには、次のいずれかのボタンをクリックします。

- 使用状況: カレント・アプリケーションのすべてのテンプレート・タイプ(ページ、レポート、リージョン、レベルおよびリスト)についてテンプレートの使用状況を表示します。

- サブスクリプション: アプリケーションでサブスクライブされたテンプレートを表示します。

- 履歴: 開発者によるテンプレートへの最近の変更および最終更新日を表示します。

テンプレートの管理

テンプレート・ページで、すべての使用可能なテンプレートを表示できます。また、ページ定義で、特定のページに関連付けられているテンプレートにアクセスできます。

この項に含まれる内容は次のとおりです。

- テンプレート・ページでのテンプレートの表示

- 特定のページに関連付けられているテンプレートの表示

- テンプレートの置換

- アプリケーション内のすべてのテンプレートの置換

- ページ・テンプレート別のリージョン位置の使用状況の表示

- テンプレートのサブスクライブ解除

- テンプレートのパブリッシュ

関連項目:
「テーマのすべてのテンプレートの表示」、「ブレッドクラム・テンプレート」、「ボタン・テンプレート」、「カレンダ・テンプレート」、「ラベル・テンプレート」、「リスト・テンプレート」、「ページ・テンプレート」、「ポップアップLOVテンプレート」、「リージョン・テンプレート」および「レポート・テンプレート」

テンプレート・ページでのテンプレートの表示

既存のテンプレートを表示するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「ユーザー・インタフェース」で、「テンプレート」を選択します。
テンプレート・ページが表示されます。

5. 次のリストから選択し、「実行」をクリックして、表示を絞り込むことができます。

- テンプレート名: 大/小文字を区別しない問合せを入力します。

- テーマ: 特定のテーマのテンプレートのみを表示します。

- 参照: 表示するテンプレートのタイプを選択します。

- タイプ - テンプレート・タイプのタイプを選択します。

- 期間: レポートを特定の時間枠に制限します。レポートに含める時間を選択します。

- サブスクライブ: すべてのテンプレート、サブクライブされたテンプレートまたはサブスクライブされていないテンプレートを表示するかどうかを指定します。

6. テンプレートのプレビューを確認するには、「プレビュー」列で「実行」アイコンをクリックします。
一部のテンプレート・タイプには、プレビュー機能はありません。

7. テンプレート定義を表示または編集するには、テンプレート名をクリックします。
テンプレート定義が表示されます。

各テンプレート定義は複数のセクションに分かれています。これらのセクションにアクセスするには、手動でスクロールするか、ページ上部のナビゲーション・ボタンをクリックします。ページ上部のボタンを選択すると、選択されたセクションが表示され、その他のセクションはすべて一時的に非表示になります。ページのすべてのセクションを表示するには、「すべて表示」をクリックします。

8. 対象となる属性を編集します。
テンプレートを編集する場合、1つのウィンドウで変更を行い、テンプレート定義ページの右側で「ページに戻る」チェック・ボックスを選択することで、別のウィンドウでアプリケーションを実行できます。このチェック・ボックスを選択すると、「変更の適用」をクリックした後、現在編集中のページが維持されます。

9. 「変更の適用」をクリックします。

特定のページに関連付けられているテンプレートの表示

特定のページに関連付けられているテンプレートを表示するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. ページを選択します。
ページ定義が表示されます。右端の列の「テンプレート」ヘッダーの下に、カレント・ページに関連付けられたテンプレートが表示されます。

4. テンプレート定義を表示または編集するには、テンプレート名をクリックします。
テンプレート定義が表示されます。

各テンプレート定義は複数のセクションに分かれています。これらのセクションにアクセスするには、手動でスクロールするか、ページ上部のナビゲーション・ボタンをクリックします。ページ上部のボタンを選択すると、選択されたセクションが表示され、その他のセクションはすべて一時的に非表示になります。ページのすべてのセクションを表示するには、「すべて表示」をクリックします。

5. 対象となる属性を編集します。
テンプレートを編集する場合、1つのウィンドウで変更を行い、テンプレート定義ページの右側で「ページに戻る」チェック・ボックスを選択することで、別のウィンドウでアプリケーションを実行できます。このチェック・ボックスを選択すると、「変更の適用」をクリックした後、現在編集中のページが維持されます。

6. 「変更の適用」をクリックします。

テンプレートの置換

テンプレートの置換ウィザードを使用してコンポーネントに関連付けられているテンプレートを更新できます。

コンポーネントに関連付けられているテンプレートを置換するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「ユーザー・インタフェース」で、「テンプレート」を選択します。
テンプレート・ページが表示されます。

5. 「タスク」リストから「テンプレートの置換」を選択します。

6. 「テンプレート・タイプ」からテンプレートを選択し、「次へ」をクリックします。

7. 「テンプレートの置換」で、次のように選択します。

1. 変更前: 変更するテンプレートを選択します。

2. 変更後: 変更後のテンプレートを選択します。

3. 「次へ」をクリックします。

8. 「終了」をクリックします。

アプリケーション内のすべてのテンプレートの置換

アプリケーション内のすべてのテンプレートを別のアプリケーションのテンプレートに置換するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「ユーザー・インタフェース」で、「テンプレート」を選択します。
テンプレート・ページが表示されます。

5. 「タスク」リストから「このアプリケーションのテンプレートを別のアプリケーションのテンプレートに置換。」を選択します。

6. 「アプリケーションから置換」からアプリケーションを選択し、「次へ」をクリックします。

7. 「テンプレートの置換」で、各コンポーネントの新しいテンプレートを選択し、次のいずれかを選択します。

- 置換: テンプレート定義をコピーします。

- 置換/サブスクライブ: テンプレートをコピーしてサブスクリプションを追加します。

8. 「テンプレートの置換」をクリックします。

ページ・テンプレート別のリージョン位置の使用状況の表示

ページ上のリージョンは、位置(表示ポイント)で構成されます。リージョンで使用可能な表示ポイントは、ページ・レベルのテンプレートによって決まります。

ページ・テンプレート別のリージョン位置の使用状況を表示するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「ユーザー・インタフェース」で、「テンプレート」を選択します。
テンプレート・ページが表示されます。

5. 「タスク」リストから「ページ・テンプレートのリージョン位置の使用状況の表示」を選択します。
「リージョン表示ポイントの使用状況」レポートが表示されます。

テンプレートのサブスクライブ解除

サブスクライブされるテンプレートとは、定義を別のテンプレートで管理されているテンプレート、つまり参照されるテンプレートです。アプリケーションで、サブスクライブされるテンプレートを使用している場合は、テンプレートのサブスクライブ解除ページでテンプレートのサブスクライブを解除できます。

テンプレートのサブスクライブを解除するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「ユーザー・インタフェース」で、「テンプレート」を選択します。
テンプレート・ページが表示されます。

5. 「タスク」リストから「テンプレートのサブスクライブ解除」を選択します。
テンプレートのサブスクライブ解除ページが表示されます。

6. 現行のテーマ内で特定のテンプレート・タイプをサブスクライブ解除するには、テンプレート・タイプを選択し、「サブスクライブ解除」をクリックします。

テンプレートのパブリッシュ

テンプレートのパブリッシュ・ページを使用して、ワークスペースの他のテンプレートによってサブスクライブされるテンプレートを表示します。

マスター・テンプレートの内容を、サブスクライブしているテンプレートにパブリッシュするには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「ユーザー・インタフェース」で、「テンプレート」を選択します。
テンプレート・ページが表示されます。

5. 「パブリッシュ」タブをクリックします。
テンプレートのパブリッシュ・ページが表示されます。

6. パブリッシュするテンプレートを選択し、「チェックした項目のパブリッシュ」をクリックします。

ブレッドクラム・テンプレート

ブレッドクラム・テンプレートは、ブレッドクラム・エントリの表示方法を制御します。このテンプレートは、リージョンの作成時に選択します。

関連項目:
「テンプレートのカスタマイズ」および「テーマの管理」

ブレッドクラム・スタイルのナビゲーションについて

ブレッドクラムは通常、現在のページが、アプリケーション内の他のページに対してどの位置にあるかを示します。また、ユーザーは特定のページをクリックするだけで、そのページを表示することができます。たとえば、Oracle Application Expressのユーザー・インタフェースでは、各ページの上部にブレッドクラム・パスが表示されます。

関連項目:

- 「ブレッドクラム・テンプレートの編集」ページ固有のセクションを使用する方法については、オンライン・ヘルプを参照してください。

- 「ブレッドクラムの作成」

ブレッドクラム・テンプレート属性

ここでは、ブレッドクラム・テンプレートの編集ページの特定のセクションについて説明します。ページの各セクションにアクセスするには、ページをスクロール・ダウンするか、ページ上部のナビゲーション・ボタンをクリックします。ページの上部でボタンを選択すると、選択したセクションが表示され、その他すべてのセクションは一時的に非表示になります。ページのすべてのセクションを表示するには、「すべて表示」をクリックします。

名前

「名前」は、テンプレートの名前を示します。テンプレートに翻訳が必要なテキスト文字列が含まれていることを示すには、「翻訳可能」チェック・ボックスを使用します。「テーマ」は、テンプレートが関連付けられているテーマを示します。

「テンプレート・クラス」は、そのテンプレートに固有の用途を示します。テーマに切り替えると、あるテーマのすべてのテンプレートは、別のテーマの対応するテンプレートにマップされます。アプリケーション・ビルダーは、テンプレート・クラスの割当てによってこのテンプレート・マッピングを行います。

サブスクリプション

「サブスクリプション」を使用して、カレント・アプリケーションに既存のテンプレートを適用します。既存のテンプレートを選択すると、ユーザーはそのテンプレートのサブスクライバになります。

マスター・テンプレートのコピーをロードするには、「リフレッシュ」をクリックします。

テンプレート・タイプ

次のいずれかのテンプレート・スタイルを選択します。

- 子ブレッドクラム・エントリ: カレント・ページの親ブレッドクラムの子(現在のブレッドクラムと同等)であるすべてのブレッドクラム・エントリを表示します。

- カレント・ブレッドクラム: 共通の親を持つすべてのブレッドクラム・エントリを順番に表示します。

- 親ブレッドクラム・エントリ: カレント・ページの親ブレッドクラム(現在のブレッドクラム・エントリよりも1階層上のブレッドクラム)のすべてのブラッドクラム・エントリを表示します。

- 親からリーフ(ブレッドクラム・スタイル): カレント・ページのブレッドクラム・エントリと、その左側にルート・ノードまでの親エントリを表示します。

定義

表 10-3に、使用可能なブレッドクラム・エントリの属性を示します。

表 10-3 ブレッドクラム・エントリの制御属性

属性

説明

最初の前

最初のブレッドクラム・エントリの前に表示するテキストを定義します。

カレント・ページのブレッドクラム・エントリ

カレント・ページに対応するブレッドクラム・エントリの外観を定義します。この属性は、次の置換文字列をサポートします。

- #NAME#: ブレッドクラム・エントリの短縮名を指定します。

- #LINK#: ブレッドクラム・エントリのアンカー・ターゲットを指定します。

- #LONG_NAME#: ブレッドクラム・エントリの詳細名を指定します。

カレント・ページ以外のブレッドクラム・エントリ

カレント・ページに対応していないブレッドクラム・エントリの外観を定義します。この属性は、次の置換文字列をサポートします。

- #NAME#: ブレッドクラム・エントリの短縮名を指定します。

- #LINK#: ブレッドクラム・エントリのアンカー・ターゲットを指定します。

- #LONG_NAME#: ブレッドクラム・エントリの詳細名を指定します。

最後の後

最後のブレッドクラム・エントリの後に表示するテキストを定義します。

レベル間

ブレッドクラム・エントリのレベル間に表示するテキストを定義します。たとえば、ブレッドクラムに3つのレベルがある場合、このテキストは、次の例の「X」の位置に表示されます。

main X cars X porsche X 911

最大レベル

ブレッドクラムをブレッドクラム・スタイルで表示する際に使用するレベル数を指定します。

リンク属性

「ブレッドクラム・リンク属性」を使用して、ブレッドクラム・エントリのハイパーテキスト・リンク属性を指定します。

コメント

この属性を使用して、このコンポーネントに関するコメントを記録します。

置換文字列

このテンプレートの置換文字列の用途を一覧します。置換文字列は、サブテンプレート内でコンポーネント値を参照するために使用されます。

ボタン・テンプレート

ボタン・テンプレートを使用すると、アプリケーション開発者は、ボタンのルック・アンド・フィールをカスタマイズできます。ボタンを構築する場合、複数のイメージまたはHTMLタグを使用できます。ボタン・テンプレートの使用はオプションです。

関連項目:
「テンプレートのカスタマイズ」および「テーマの管理」

ボタン・テンプレート属性

ここでは、ボタン・テンプレートの編集ページの特定のセクションについて説明します。ページの各セクションにアクセスするには、ページをスクロール・ダウンするか、ページ上部のナビゲーション・ボタンをクリックします。ページの上部でボタンを選択すると、選択したセクションが表示され、その他すべてのセクションは一時的に非表示になります。ページのすべてのセクションを表示するには、「すべて表示」をクリックします。

名前

「テンプレート名」は、テンプレートの名前を示します。テンプレートに変換が必要なテキスト文字列が含まれているかどうかを示すには、「翻訳可能」チェック・ボックスを使用します。「テーマ」は、テンプレートが関連付けられているテーマを示します。

「テンプレート・クラス」は、そのテンプレートに固有の用途を示します。テーマに切り替えると、あるテーマのすべてのテンプレートは、別のテーマの対応するテンプレートにマップされます。アプリケーション・ビルダーは、テンプレート・クラスの割当てによってこのテンプレート・マッピングを行います。

サブスクリプション

「サブスクリプション」を使用して、カレント・アプリケーションに既存のテンプレートを適用します。既存のテンプレートを選択すると、ユーザーはそのテンプレートのサブスクライバになります。

マスター・テンプレートのコピーをロードするには、「テンプレートのリフレッシュ」をクリックします。

定義

表示するボタン・テンプレートを定義するには、テンプレートを使用します。標準のアプリケーション置換文字列を含めることもできます。たとえば、&ITEM_NAME値はレンダリング時に置換できます。ボタン・テンプレートは、次の置換文字列をサポートします。

- #LABEL#: ボタン・ラベルで置換されます。

- #LINK#: URLで置換されます。置換された後、URLは、#dosubmit#、またはページを送信(リクエスト値を設定)するリダイレクトJavaScriptをコールするか、あるいは指定されたURLに単純にページをリダイレクトします。

コメント

この属性を使用して、このコンポーネントに関するコメントを記録します。

置換文字列

このテンプレートの置換文字列の用途を一覧します。置換文字列は、サブテンプレート内でコンポーネント値を参照するために使用されます。

カレンダ・テンプレート

カレンダ・テンプレートは、カレンダの外観と配置を制御します。このテンプレートは、頻繁にHTML表を使用して日付を配置します。#DD#や#MONTH#などの置換文字列を使用してカレンダ属性を配置します。サポートされている置換文字列のリストは、カレンダ・テンプレートの編集ページの右側に表示されます。テンプレートの置換文字列は大文字で指定し、シャープ記号(#)で囲む必要があることに注意してください。

関連項目:
「カレンダの作成」、「テンプレートのカスタマイズ」および「テーマの管理」

カレンダ・テンプレート属性

ここでは、カレンダ・テンプレートの編集ページの特定のセクションについて説明します。ページの各セクションにアクセスするには、ページをスクロール・ダウンするか、ページ上部のナビゲーション・ボタンをクリックします。ページの上部でボタンを選択すると、選択したセクションが表示され、その他すべてのセクションは一時的に非表示になります。ページのすべてのセクションを表示するには、「すべて表示」をクリックします。

カレンダ定義

名前

「名前」は、テンプレートの名前を示します。「テーマ」は、テンプレートが関連付けられているテーマを示します。

「テンプレート・クラス」は、そのテンプレートに固有の用途を示します。テーマに切り替えると、あるテーマのすべてのテンプレートは、別のテーマの対応するテンプレートにマップされます。アプリケーション・ビルダーは、テンプレート・クラスの割当てによってこのテンプレート・マッピングを行います。

テンプレート・サブスクリプション

カレント・アプリケーションに既存のテンプレートを適用するには、「テンプレートのサブスクリプション」を使用します。既存のテンプレートを選択すると、ユーザーはそのテンプレートのサブスクライバになります。

マスター・テンプレートのコピーをロードするには、「リフレッシュ」をクリックします。

コメント

この属性を使用して、このコンポーネントに関するコメントを記録します。

月別カレンダ、週間カレンダおよび日次カレンダ

「月別カレンダ」、「週間カレンダ」および「日次カレンダ」属性を使用して、特定のカレンダの外観および配置を制御します。

特定の属性の詳細を表示するには、属性ラベルをクリックします。ヘルプが利用できる場合は、アイテム・ラベル上にカーソルを重ねると、アイテム・ラベルが赤色に変わり、カーソルが矢印と疑問符に変わります。「フィールドレベル・ヘルプについて」を参照してください。

ラベル・テンプレート

ラベル・テンプレートは、ページ・アイテム・ラベルのHTMLマークアップを集中管理することを目的としています。各アイテムにはオプションのラベルがあります。ラベル・テンプレートを使用して、これらのラベルの表示方法を制御できます。たとえば、ユーザーに必須であることを示すイメージ(アスタリスクなど)を参照する「必須フィールド」というラベル・テンプレートを作成できます。

ラベル・テンプレートを使用すると、アイテムの先頭と末尾に追加するテキスト文字列を定義できます。

関連項目:
「テンプレートのカスタマイズ」および「テーマの管理」

ラベル・テンプレート属性

ここでは、ラベル・テンプレートの編集ページの特定のセクションについて説明します。ページの各セクションにアクセスするには、ページをスクロール・ダウンするか、ページ上部のナビゲーション・ボタンをクリックします。ページの上部でボタンを選択すると、選択したセクションが表示され、その他すべてのセクションは一時的に非表示になります。ページのすべてのセクションを表示するには、「すべて表示」をクリックします。

名前

「テンプレート名」は、テンプレートの名前を示します。テンプレートに翻訳が必要なテキスト文字列が含まれていることを示すには、「翻訳可能」チェック・ボックスを使用します。「テーマ」は、テンプレートが関連付けられているテーマを示します。

「テンプレート・クラス」は、そのテンプレートに固有の用途を示します。テーマに切り替えると、あるテーマのすべてのテンプレートは、別のテーマの対応するテンプレートにマップされます。アプリケーション・ビルダーは、テンプレート・クラスの割当てによってこのテンプレート・マッピングを行います。

サブスクリプション

「テンプレートのサブスクリプション」を使用して、カレント・アプリケーションに既存のテンプレートを適用します。既存のテンプレートを選択すると、ユーザーはそのテンプレートのサブスクライバになります。

マスター・テンプレートのコピーをロードするには、「テンプレートのリフレッシュ」をクリックします。

定義

「ラベルの前」では、アイテム・ラベルの前に表示するHTMLを入力します。「ラベルの前」では、置換文字列#CURRENT_FORM_ELEMENT#; #CURRENT_FORM_ID#および#CURRENT_ITEM_NAME#をサポートします。次に例を示します。

<label for="#CURRENT_ITEM_NAME#">
<a href="javascript:popupFieldHelp('#CURRENT_ITEM_ID#',
'&APP_SESSION.','&CLOSE.')" >

「ラベルの後」では、アイテム・ラベルの後に表示するHTMLを入力します。このラベルはこのリージョンのHTMLの前に自動的に表示されるため、「ラベルの前」リージョンの開始タグをここで閉じる必要があります。次に例を示します。

</a></label>

エラー表示

「ラベルの前のエラー発生時」では、アプリケーションがアイテムのインライン検証エラー・メッセージを表示する場合に、そのアイテム・ラベルの前に表示するHTMLを入力します。次に例を示します。

<font class="fieldtitleleft">#ERROR_MESSAGE#

「ラベルの後のエラー発生時」では、アプリケーションがアイテムのインライン検証エラー・メッセージを表示する場合に、そのアイテム・ラベルの後に表示されるHTMLを入力します。この属性では、置換文字列#CURRENT_FORM_ELEMENT#、#CURRENT_FORM_ID#および#CURRENT_ITEM_NAME#をサポートします。次の例では、エラー発生時に表示されるアイテム・ラベルに空白と閉じカッコを追加します。

&nbsp;]</font>

コメント

この属性を使用して、このオブジェクトに関するコメントを記録します。

置換文字列

このテンプレートの置換文字列の用途を一覧します。置換文字列は、サブテンプレート内でコンポーネント値を参照するために使用されます。

リスト・テンプレート

リストは、リンクの共有コレクションです。リストの外観は、リスト・テンプレートで制御します。テンプレート属性を使用すると、特定のページのカレントまたは非カレントとしてリスト要素を定義できます。

関連項目:
「リストの作成」、「テンプレートのカスタマイズ」および「テーマの管理」

階層リストについて

Oracle Application Expressでは、階層的なリストをサポートしています。階層的なリストを作成するには、次のステップを実行します。

- 階層的なリストをサポートするリスト・テンプレートを選択します。階層的なリストをサポートするリスト・テンプレートを判別するには、サブリスト付きというネーミング規則のあるテンプレートを検索します。

- 各リスト・エントリの作成時には親リスト・エントリを選択します。

関連項目:

- 「リスト・テンプレートの編集」ページ固有のセクションを使用する方法については、オンライン・ヘルプを参照してください。

- 「リストの作成」

リスト・テンプレート属性

ここでは、リスト・テンプレートの編集ページの特定のセクションについて説明します。ページの各セクションにアクセスするには、ページをスクロール・ダウンするか、ページ上部のナビゲーション・ボタンをクリックします。ページの上部でボタンを選択すると、選択したセクションが表示され、その他すべてのセクションは一時的に非表示になります。ページのすべてのセクションを表示するには、「すべて表示」をクリックします。

名前

「名前」は、テンプレートの名前を示します。テンプレートに翻訳が必要なテキスト文字列が含まれていることを示すには、「翻訳可能」チェック・ボックスを使用します。「テーマ」は、テンプレートが関連付けられているテーマを示します。

「テンプレート・クラス」は、そのテンプレートに固有の用途を示します。新しいテーマに切り替えると、あるテーマのすべてのテンプレートは、別のテーマの対応するテンプレートにマップされます。アプリケーション・ビルダーは、テンプレート・クラスの割当てによってこのテンプレート・マッピングを行います。

サブスクリプション

「サブスクリプション」を使用して、カレント・アプリケーションに既存のテンプレートを適用します。既存のテンプレートを選択すると、ユーザーはそのテンプレートのサブスクライバになります。

マスター・テンプレートのコピーをロードするには、「テンプレートのリフレッシュ」をクリックします。

リスト前のエントリ

リスト要素の前に表示するHTMLを入力します。この属性は、HTML表またはHTML表の行を開始するために使用できます。

テンプレート定義

カレントおよび非カレントのリスト・テンプレートを定義します。サポートされる置換文字列は、#LINK#、 #TEXT#、#IMAGE_PREFIX#、#IMAGE#、#IMAGE_ATTR#および#A01#から#A10#です。

- カレント・リスト・テンプレート: 選択された(カレントの)リスト・テンプレートに置換されるHTMLまたはテキストを入力します。

- サブリスト・アイテムが含まれているカレント・リスト・テンプレート:アイテムにサブリスト・アイテムが含まれる場合は、選択された(カレントの)リスト・テンプレートに置換されるHTMLまたはテキストを入力します。このテキストを指定しないと、現在のリスト・アイテム・テンプレートが使用されます。

- 非カレント・リスト・テンプレート: 選択されていない(非カレントの)リスト・テンプレートに置換されるHTMLまたはテキストを入力します。

- サブリスト・アイテムが含まれている非カレント・リスト・テンプレート:アイテムにサブリスト・アイテムが含まれる場合は、選択されていない(非カレントの)リスト・テンプレートに置換されるHTMLまたはテキストを入力します。このテキストを指定しないと、現在のリスト・アイテム・テンプレートが使用されます。

- リスト要素間: リスト要素の間に表示するHTMLを入力します。HTMLを指定しないと、この属性が無視されます。

サブリスト前のエントリ

サブリスト要素の前に表示するHTMLを入力します。

サブリスト・エントリ

カレントおよび非カレントのリスト・テンプレートを定義します。サポートされる置換文字列は、#LINK#、 #TEXT#、#IMAGE_PREFIX#、#IMAGE#、#IMAGE_ATTR#および#A01#から#A10#です。

- カレント・サブリスト・テンプレート:選択された(カレントの)リスト・テンプレートに置換されるHTMLまたはテキストを入力します。

- サブリスト・アイテムが含まれているカレント・サブリスト・テンプレート:アイテムにサブリスト・アイテムが含まれる場合は、選択された(カレントの)リスト・テンプレートに置換されるHTMLまたはテキストを入力します。このテキストを指定しないと、現在のリスト・アイテム・テンプレートが使用されます。

- 非カレント・サブリスト・テンプレート:選択されていない(非カレントの)リスト・テンプレートに置換されるHTMLまたはテキストを入力します。

- サブリスト・アイテムが含まれている非カレント・サブリスト・テンプレート:アイテムにサブリスト・アイテムが含まれる場合は、選択されていない(非カレントの)リスト・テンプレートに置換されるHTMLまたはテキストを入力します。このテキストを指定しないと、現在のリスト・アイテム・テンプレートが使用されます。

- サブリスト・アイテム間:リスト要素の間に表示するHTMLを入力します。HTMLを指定しないと、この属性が無視されます。

サブリスト後のエントリ

サブリスト要素を表示した後に表示するHTMLを入力します。

リスト後のエントリ

すべてのリスト要素を表示した後に表示するHTMLを入力します。この属性を使用して、リスト前の要素属性で開始したHTML表を閉じることができます。

コメント

この属性を使用して、このオブジェクトに関するコメントを記録します。

置換文字列

このテンプレートの置換文字列の用途を一覧します。置換文字列は、サブテンプレート内でコンポーネント値を参照するために使用されます。

ページ・テンプレート

ページ・テンプレートは、ページの外観を定義します。各テンプレートは、ヘッダー・テンプレート、ボディ・テンプレート、フッター・テンプレートおよび多くのサブテンプレートで構成されます。ページ・レベル属性でページ・テンプレートを指定しない場合、Application Expressエンジンは、テーマの作成/編集ページで定義したデフォルトのページ・テンプレートを使用します。

ページ・テンプレートは、静的HTMLと実行時に置換される置換文字列を組み合せたものです。置換文字列を使用して、ページ・テンプレート内のコンポーネントの存在と配置を指定します。さらに、サブテンプレートを使用して、コンポーネントの表示方法を指定できます。

関連項目:
「テンプレートのカスタマイズ」および「テーマの管理」

この項に含まれる内容は次のとおりです。

- サポートされるページ・テンプレートの置換文字列

- ページ・テンプレート属性

サポートされるページ・テンプレートの置換文字列

表10-4に、使用可能なページ・テンプレートの置換文字列を示します。テンプレートのすべての置換文字列は、大文字で指定し、シャープ記号(#)で囲む必要があることに注意してください。

特定のテンプレートでサポートされる置換文字列のレポートを表示するには、ページ・テンプレートの編集ページの「置換文字列」セクションを参照します。詳細は、「ページ・テンプレート属性」を参照してください。

表 10-4 ページ・テンプレートの置換文字列

置換文字列

説明

#APP_VERSION#

ページ・テンプレートの「ヘッダー」または「フッター」セクションで使用できます。#APP_VERSION#の値は、定義の編集ページのバージョン属性で定義します。

参照: 「名前」

#BOX_BODY#

ボディを表示する位置を指定します。ボディがNULLの場合、かわりに#BOX_BODY#が使用されます。

#CUSTOMIZE#

ページ・テンプレートの「ヘッダー」、「ボディ」セクションで使用できます。

「リージョン定義」の「カスタマイズ」セクションを使用すると、エンド・ユーザーによるカスタマイズを可能にできます。この機能を使用するには、ページ・テンプレートに#CUSTOMIZE#置換文字列も含める必要があります。

エンド・ユーザーによるカスタマイズが1つ以上のリージョンでサポートされる場合、「カスタマイズ」というリンクがページ・テンプレートの#CUSTOMIZE#置換文字列が表示される場所に表示されます。このリンクをクリックするとウィンドウが表示され、ユーザーは、ページのリージョンのオン/オフを切り替えることができるようになります。

参照: 「リージョン属性の編集」

#FORM_CLOSE#

#FORM_OPEN#を含める場合は、ヘッダー、ボディまたはフッターのテンプレートに#FORM_CLOSE#を含める必要があります。#FORM_OPEN#は#BOX_BODY#の前、#FORM_CLOSE#は#BOX_BODY#置換文字列の後に指定する必要があります。

#FORM_OPEN#

HTMLのフォームの開始タグ<form>を配置する位置を指定します。フォームを送信するには、この置換文字列を含める必要があります。

ユーザー独自のフォームをオープン状態にコーディングする必要はありません。この操作はApplication Expressエンジンが行います。

#GLOBAL_NOTIFICATION#

グローバル通知属性を表示します。グローバル通知は、システム・ステータス(保留中のシステム停止時間など)との通信に使用します。APEX_APPLICATION.G_GLOBAL_NOTIFICATIONを使用すると、この値をプログラムによって設定できます。

参照: グローバル通知属性については、「グローバル通知属性」を参照してください。

#HEAD#

<head>開始タグと</head>閉じタグの間に使用します。オプションで、各ページの#HEAD#のコンテンツを定義できます(たとえば、追加のスタイルシートまたはJavaScriptライブラリを参照するように定義できます)。

#LOGO#

アプリケーションのロゴを指定します。

定義の編集ページの「ロゴ」セクションで、アプリケーションのロゴのイメージおよびイメージ属性を指定できます。この機能を使用するには、「ヘッダー」または「ボディ」ページ・テンプレートに置換文字列#LOGO#も含める必要があります。

参照: 「ロゴ」

#NAVIGATION_BAR#

ナビゲーション・バー・エントリの存在を定義します。ナビゲーション・バーは、この置換文字列を含むテンプレートを使用したアプリケーション内の各ページに表示されます。「ナビゲーション・バー」サブテンプレートを使用すると、この置換文字列を拡張できます。

関連項目: 「ナビゲーション・バー」サブテンプレートは、サブテンプレートを参照してください。

#NOTIFICATION_MESSAGE#

開発者がユーザーにメッセージを送信できます。インライン・エラー・メッセージのサマリーが表示される位置を定義します。インライン・エラー・メッセージは、フィールドの横または通知領域にインライン(あるいはその両方)で表示できます。

#ONLOAD#

ページ・テンプレートのヘッダーおよびフッターで使用できます。HTMLの<bodyタグ内に含める必要があります。次に例を示します。

<body #ONLOAD#>

JavaScriptコールでこの文字列を置換文字列として使用すると、Webブラウザでページがロードされたときにそのコールが実行されます。コールするJavaScriptは、ページごとに変更できます。

#PARENT_TAB_CELLS#

親タブの表示を指定します。親タブには標準タブが必要です。アプリケーションにタブの1つのレベルのみが含まれている場合は、この置換文字列は不要です。

参照: 親タブの属性の定義については、「標準タブ属性」を参照してください。

#REGION_POSITION_NN#

ページ内のリージョンの正確な位置を指定します。リージョンが指定されていない場合は、たとえば#REGION_POSITION_01#があるとすると、この#REGION_POSITION_01#は置換されません。

#SUCCESS_MESSAGE#

成功メッセージおよびエラー・メッセージを表示するページ内の位置を定義します。エラーなしでページ・プロセスが実行されると、このテキストが表示されます。

成功メッセージの前後にHTMLを追加すると、各テンプレートの成功メッセージの表示をカスタマイズできます。

#TAB_CELLS#

標準タブの表示を指定します。

関連項目: 「標準タブ属性」

#TITLE#

ページ・タイトルを定義します。通常、HTMLのtitleタグ内に含まれます。

関連項目:
「置換文字列の理解」および「アプリケーション内のページの管理」

ページ・テンプレート属性

ここでは、ページ・テンプレートの編集ページの特定のセクションについて説明します。ページの各セクションにアクセスするには、ページをスクロール・ダウンするか、ページ上部のナビゲーション・ボタンをクリックします。ページの上部でボタンを選択すると、選択したセクションが表示され、その他すべてのセクションは一時的に非表示になります。ページのすべてのセクションを表示するには、「すべて表示」をクリックします。

名前

「名前」は、テンプレートの名前を示します。「テーマ」は、テンプレートが関連付けられているテーマを示します。

「テンプレート・クラス」は、そのテンプレートに固有の用途を示します。新しいテーマに切り替えると、あるテーマのすべてのテンプレートは、別のテーマの対応するテンプレートにマップされます。アプリケーション・ビルダーは、テンプレート・クラスの割当てによってこのテンプレート・マッピングを行います。テンプレートに翻訳が必要なテキスト文字列が含まれていることを示すには、「翻訳可能」チェック・ボックスを使用します。

サブスクリプション

「サブスクリプション」を使用して、カレント・アプリケーションに既存のテンプレートを適用します。既存のテンプレートを選択すると、ユーザーはそのテンプレートのサブスクライバになります。

マスター・テンプレートの新しいコピーをロードするには、「テンプレートのリフレッシュ」を選択します。

定義

各テンプレートは、ヘッダー、ボディ、フッターおよびサブテンプレートで構成されます。動的コンテンツを含めるには、置換文字列を使用します。テンプレートのすべての置換文字列は、大文字で指定し、シャープ記号(#)で囲む必要があります。サポートされている置換文字列については、アイテム・ヘルプを参照してください。

「ヘッダー」は、ページ・テンプレートの最初のセクションです。HTMLドキュメントの<Head>セクションを定義するHTMLを入力します。表示するリージョンまたはAFTER HEADERを実行するプロセスおよび計算は、テンプレートのこのセクションがレンダリングされた直後に表示または実行されます。次に例を示します。

<html>
<head>
<title>#TITLE#</title>
#HEAD#
</head>

「ボディ」はページ・テンプレートの2番目のセクションで、ヘッダー・セクションとフッター・セクションの間にレンダリングされます。HTMLドキュメントの<Body>セクションを定義するHTMLを入力します。少なくとも#BOX_BODY#置換文字列を含める必要があります。#FORM_OPEN#および#FORM_CLOSE#置換文字列も含めることをお薦めします。次に例を示します。

<body #ONLOAD#>
#FORM_OPEN#
#BOX_BODY#
#FORM_CLOSE#
</body>

「フッター」は、ボディの後に表示する、ページ・テンプレートの3番目のセクションです。

表示ポイント

「ブレッドクラム表示ポイント」は、ブレッドクラムを使用する生成済コンポーネントに適用されます。ブレッドクラムが配置されるページ上の位置を定義します。「サイドバー表示ポイント」は、サイドバーを使用する生成済コンポーネントに適用されます。サイドバーが配置されるページ上の位置を定義します。

サブテンプレート

「サブテンプレート」を使用すると、コンポーネントの表示方法を指定できます。選択可能なサブテンプレートは次のとおりです。

- 「成功メッセージ」。#SUCCESS_MESSAGE#置換文字列を拡張します。プログラムによって、またはプロセスの属性として、成功メッセージを定義できます。成功メッセージが存在し、ページ・テンプレートが#SUCCESS_MESSAGE#置換文字列を含んでいる場合は、このサブテンプレートを使用して、メッセージをレンダリングします。

- 「ナビゲーション・バー」。ナビゲーション・バー・エントリの表示を制御します。#NAVIGATION_BAR#置換文字列がテンプレートのヘッダー、ボディまたはフッターで参照される際に置換されるHTMLまたはテキストを入力します。#BAR_BODY#置換文字列を使用して、各ナビゲーション・バー・アイコンが表示される位置を指定してください。次の例では、#BAR_BODY#置換文字列により、適切なHTML表セルが生成されます。

<table class="navBar"><tr>#BAR_BODY#</tr></table>

- 「ナビゲーション・バー・エントリ」。各ナビゲーション・バー・エントリのナビゲーション・バー#BAR_BODY#置換文字列に置換されるHTMLまたはテキストを入力します。次の置換文字列を使用して、ナビゲーション・バー・エントリのサブテンプレートを作成します。
次の置換文字列を使用して、ナビゲーション・バー・エントリのサブテンプレートを構成します。

- #LINK#: エントリ・リンク

- #TEXT#: エントリ・サブ・テキスト

- #IMAGE#: エントリ・イメージ
ナビゲーション・バー・エントリで指定された場合、HTMLイメージのALT、HEIGHTおよびWIDTH引数はHTML IMGタグに含まれます。

- #EDIT#: インライン編集のリンク編集機能

- #WIDTH#: イメージの幅

- #HEIGHT#: イメージの高さ

- #COLSPAN#: HTML COLSPAN値

- #ALT#: イメージの代替テキスト

- 「通知」。#NOTIFICATION_message#置換文字列が、テンプレートのヘッダー、ボディまたはフッターで参照される際に置換されるHTMLまたはテキストを入力します。置換文字列#MESSAGE#を使用して、通知メッセージにメッセージ本体が表示される位置を指定します。

標準タブ属性

アプリケーションに標準タブが含まれている場合は、この属性を移入する必要があります。#TAB_CELLS#置換文字列を使用して、ページ・テンプレートのヘッダー、ボディまたはフッターに標準タブを配置できます。ページ・テンプレートのヘッダー、ボディ、フッターは、HTML表および行を定義します。このサブテンプレートは、特定のセルを定義することによって、これらのタブの表示方法を定義します。選択可能な属性は次のとおりです。

- カレント・タブ。現在選択されている標準タブに置換されるHTMLまたはテキストを入力します。タブがカレントであるかどうかは、標準タブ属性によって判別されます。次に例を示します。

<td>#TAB_LABEL#</td>

- 非カレント標準タブ:選択されていない標準タブに置換されるHTMLまたはテキストを入力します。#TAB_TEXT#置換文字列を使用して、テンプレート内のタブ・ラベルおよびリンクの位置を指定してください。次に例を示します。

<td><a href="#TAB_LINK#">#TAB_LABEL#</a></td>

関連項目:
「タブの作成」

親タブ属性

アプリケーションに2つのレベルのタブが含まれている場合は、この属性を移入する必要があります。選択された親タブに置換されるHTMLまたはテキストを入力します。#PARENT_TAB_CELLS#置換文字列を使用して、ページ・テンプレートのヘッダー、ボディまたはフッターに親タブを配置できます。親タブは、標準タブとのみ表示されます。選択可能な属性は次のとおりです。

- 「カレント親タブ」。選択された親タブに置換されるHTMLまたはテキストを入力します。タブがカレントかどうかは、表示されるページと、ページで使用している標準タブ・セットで判断します。#TAB_TEXT#置換文字列を使用して、テンプレート内のタブ・ラベルおよびリンクの位置を指定してください。次に例を示します。

<td><a href="#TAB_LINK#">#TAB_LABEL#</a></td>

- 非カレント親タブ:選択されていない親タブに置換されるHTMLまたはテキストを入力します。#TAB_TEXT#置換文字列を使用して、テンプレート内のタブ・ラベルおよびリンクの位置を指定してください。次に例を示します。

<td><a href="#TAB_LINK#">#TAB_LABEL#</a></td>

関連項目:
「タブの作成」

イメージ・ベースのタブ属性

このサブテンプレートは、完全にイメージに基づくタブに使用します。選択可能な属性は次のとおりです。

- 「カレント・イメージ・タブ」。イメージベースのタブが現在選択されていることを示すために使用するHTMLを入力します。タブに表示される名前を示す#TAB_TEXT#置換文字列を含めます。

- 非カレント・イメージ・タブ:イメージ・タブは現在選択されていないことを示すために使用するHTMLを入力します。タブに表示される名前を示す#TAB_TEXT#置換文字列を含めます。

複数列リージョンの表属性

Application Expressエンジンが同じリージョン位置の複数の列にリージョンを表示する場合、Oracle Application ExpressはHTML表をレンダリングします。この属性によって、<table>タグの属性を制御できます。

エラー・ページ・テンプレートの制御

ページ・テンプレートをエラー・テンプレートとして指定する場合にのみ、この属性を使用します。#MESSAGE#置換文字列を使用してエラー・メッセージを配置し、#BACK_LINK#置換文字列を使用して前のページに戻るリンクを表示します。アプリケーション属性を編集すると、テンプレートをエラー・テンプレートとして指定できます。次に例を示します。

#MESSAGE#

<br>

<a href="#BACK_LINK#">back</a>

コメント

この属性を使用して、このコンポーネントに関するコメントを記録します。

置換文字列

このテンプレートの置換文字列の用途を一覧します。置換文字列は、サブテンプレート内でコンポーネント値を参照するために使用されます。

ポップアップLOVテンプレート

ポップアップLOVテンプレートは、POPUPとして定義したすべてのアイテムに対するポップアップ・リストの表示方法を制御します。ポップアップLOVテンプレートは、各テーマに1つのみ指定できます。

関連項目:
「LOVの作成」、「テンプレートのカスタマイズ」および「テーマの管理」

ポップアップLOVテンプレート属性

ここでは、ポップアップLOVテンプレートの編集ページの特定のセクションについて説明します。ページの各セクションにアクセスするには、ページをスクロールするか、ページ上部のナビゲーション・ボタンをクリックします。ページの上部でボタンを選択すると、選択したセクションが表示され、その他すべてのセクションは一時的に非表示になります。ページのすべてのセクションを表示するには、「すべて表示」をクリックします。

アプリケーション

「テーマ」は、テンプレートが関連付けられているテーマを示します。「テンプレート・クラス」は、そのテンプレートに固有の用途を示します。新しいテーマに切り替えると、あるテーマのすべてのテンプレートは、別のテーマの対応するテンプレートにマップされます。アプリケーション・ビルダーは、テンプレート・クラスの割当てによってこのテンプレート・マッピングを行います。テンプレートに翻訳が必要なテキスト文字列が含まれていることを示すには、「翻訳可能」チェック・ボックスを使用します。

サブスクリプション

「サブスクリプション」を使用して、カレント・アプリケーションに既存のテンプレートを適用します。既存のテンプレートを選択すると、ユーザーはそのテンプレートのサブスクライバになります。

マスター・テンプレートの新しいコピーをロードするには、「テンプレートのリフレッシュ」をクリックします。

アイコン

「ポップアップ・アイコン」を使用して、POPUPタイプのアイテムのフォーム・フィールドの右側に表示するアイコンを指定します。デフォルトでは、Application Expressエンジンはlist.gifイメージを使用します。「ポップアップ・アイコン属性」を使用して、ポップアップ・アイコンのイメージ属性(高さや幅など)を定義します。

検索フィールド

これらの属性を使用して、「検索」フィールドの表示方法を指定します。表 10-5に、使用可能な検索フィールドの属性を示します。

表 10-5 検索フィールドの属性

属性

説明

フィールド・テキストの前

ポップアップLOVの検索フィールドを表示する前に表示するテキストを定義します。

フィルタ幅

テキスト・フィールドをこの幅で表示します。

フィルタ最大幅

この最大幅でテキスト・フィールドを表示します。

フィルタ・テキスト属性

これらの属性でテキスト・フィールドを表示します。これはHTMLのinputタグ内に含まれます。

フィールド・テキストの後

検索フィールド、検索ボタンおよび閉じるボタンを表示した後にこのテキストを表示します。

ボタン

これらの属性を使用して、ボタン名および「検索」、「閉じる」、「次へ」および「戻る」ボタンの属性を定義します。

ウィンドウ

JavaScriptを使用してポップアップLOVが実行されます。これらの属性を使用して、scrollbars=、resizable=、width=およびheight=の値を制御します。デフォルトの値の詳細は、アイテム・ヘルプを参照してください。

ページ区切り

行カウント結果の表示方法を定義します。

結果セット

これらの属性を使用して、結果セットの前後に表示するテキストまたはHTMLを定義します。

ページ属性

これらの属性を使用してポップアップ・ページを定義します。詳細は、アイテム・ヘルプを参照してください。

リージョン・テンプレート

リージョン・テンプレートは、リージョン属性の外観と配置を制御します。このテンプレートは、頻繁にHTML表を使用してコンテンツを配置します。

リージョン・テンプレートはリージョンにスタイル要素を適用します。また、置換文字列を表示します。#BODY#は必須の置換文字列であり、リージョン・ソースが配置される位置を指定します。他のすべての置換文字列はオプションです。これらの置換文字列を使用すると、リージョン内のページ・コントロール(ボタンなど)の存在と配置を指定できます。

関連項目:
「リージョンの理解」、「テンプレートのカスタマイズ」および「テーマの管理」

リージョン・テンプレート属性

ここでは、リージョン・テンプレートの編集ページの特定のセクションについて説明します。ページの各セクションにアクセスするには、ページをスクロールするか、ページ上部のナビゲーション・ボタンをクリックします。ページの上部でボタンを選択すると、選択したセクションが表示され、その他すべてのセクションは一時的に非表示になります。ページのすべてのセクションを表示するには、「すべて表示」をクリックします。

名前

「名前」は、テンプレートの名前を示します。「テーマ」は、テンプレートが関連付けられているテーマを示します。

「テンプレート・クラス」は、そのテンプレートに固有の用途を示します。新しいテーマに切り替えると、あるテーマのすべてのテンプレートは、別のテーマの対応するテンプレートにマップされます。アプリケーション・ビルダーは、テンプレート・クラスの割当てによってこのテンプレート・マッピングを行います。テンプレートに翻訳が必要なテキスト文字列が含まれていることを示すには、「翻訳可能」チェック・ボックスを使用します。

サブスクリプション

「テンプレートのサブスクリプション」を使用して、カレント・アプリケーションに既存のテンプレートを適用します。既存のテンプレートを選択すると、ユーザーはそのテンプレートのサブスクライバになります。

マスター・テンプレートの新しいコピーをロードするには、「テンプレートのリフレッシュ」をクリックします。

定義

リージョン・テンプレートにより、リージョンと呼ばれるページ部分の外観が決まります。置換文字列を使用して、リージョン内のコンポーネントの存在と配置を指定します。必要な置換文字列は#BODY#のみです。リージョン・ソースが配置される位置を指定します。他のすべての置換文字列はオプションです。有効な置換文字列は次のとおりです。

- #TITLE#

- #EXPAND#

- #CHANGE#

- #BODY#

- #FORM_OPEN#

- #FORM_CLOSE#

リージョン位置にボタンを作成すると、定義した位置が選択リストに表示されます。次の置換文字列を使用して、リージョンにボタンを配置する位置を定義してください。

- #EDIT#

- #CLOSE#

- #CREATE#

- #EXPAND#

- #HELP#

- #DELETE#

- #COPY#

- #NEXT#

- #PREVIOUS#

関連項目:
「置換文字列の理解」

フォーム表属性

ページ・アイテムは、リージョン内で表示されます。アイテムは、HTML表のHTMLフォームの要素としてレンダリングされます。このテンプレートのプロパティで、<table>タグに配置する属性を定義できます。次に例を示します。

class="instructiontext"

コメント

この属性を使用して、このコンポーネントに関するコメントを記録します。

置換文字列

このテンプレートの置換文字列の用途を一覧します。置換文字列は、サブテンプレート内でコンポーネント値を参照するために使用されます。

レポート・テンプレート

レポート列テンプレートによって、SQL問合せによって戻される1行の結果を制御できます。このタイプのテンプレートは、行全体ではなく、セルを定義します。

各レポート・テンプレートでは、#1#、#2#、#3#などの構文を使用して列名を識別します。#ENAME#や#EMPNO#などの列名の置換構文を使用して、列に名前を付けることもできます。アプリケーションのどのアイテムもテンプレート内で参照できます。たとえば、テンプレートのABC.というアイテムを参照するには、置換文字列&ABC.を正確に含めます。ABC.の実際の値は、ABCという名前のアプリケーションのアイテムを編集するエンド・ユーザーによって提供されます。

関連項目:
「レポートの作成」、「テンプレートのカスタマイズ」および「テーマの管理」

この項に含まれる内容は次のとおりです。

- 汎用列テンプレートおよび名前付き列テンプレートについて

- 汎用列テンプレートのレポート列テンプレート属性

- 名前付き列テンプレートのレポート列テンプレート属性

- 列テンプレートでのJavaScriptの使用について

汎用列テンプレートおよび名前付き列テンプレート

Oracle Application Expressには、次の2種類のレポート・テンプレートが含まれています。

- 汎用列テンプレート

- 名前付き列テンプレート

汎用列テンプレート

汎用列テンプレートは、列の外観を1回定義することによって、レポートの外観を決定します。その後、この外観は、レポート定義に指定された列の数に基づいて、必要なだけ繰り返されます。このタイプのテンプレートを使用できるのは、行および列が標準的な構造のレポートに限られます。条件を使用すると、このタイプのテンプレートでレポートに追加のスタイルを適用できます。

次の例では、各列で特定のスタイルを使用する方法を示します。

<td class="tabledata" align="#ALIGN#">#COLUMN_VALUE#</td>

この例では、ページ・テンプレートにクラスtabledataを含むCSSが存在することを想定しています。また、この例では、置換文字列#ALIGN#および#COLUMN_VALUE#を使用しています。実際にこのレポートを実行すると、これらの置換文字列は、SQL問合せの結果によって生成された値に置換されます。

問合せの選択リストに式を使用する場合は、列の別名を作成して実行時エラーを回避することをお薦めします。たとえば、次のような問合せを考えてみます。

SELECT ename, (sal + comm) * 12 FROM emp

問合せをリライトして、次のように列に別名を付けることができます。

SELECT ename, (sal + comm) * 12 yearly_comp FROM emp

名前付き列テンプレート

名前付き列テンプレートを使用すると、より柔軟にレポートを設計できます。ただし、名前付きテンプレートは名前で列を参照するため、それらの列を基にしたレポートでのみ使用されます。次に例を示します。

<tr><td>#ENAME#</td><td>#SAL#</td></tr>

名前付き列テンプレートは自由度の高いものですが、問合せごとに新しいテンプレートを作成する必要がある場合があります。位置表記を含めることもできます。次の例では、HTMLおよび置換文字列を使用する方法を示します。

<tr><td>#ENAME#</td><td>#SAL#</td></tr>

<tr><td>#1#</td><td>#2#</td></tr>

汎用列テンプレートのレポート列テンプレート属性

ここでは、汎用列テンプレートのレポート・テンプレートの編集ページの特定のセクションについて説明します。ページの各セクションにアクセスするには、ページをスクロール・ダウンするか、ページ上部のナビゲーション・ボタンをクリックします。ページの上部でボタンを選択すると、選択したセクションが表示され、その他すべてのセクションは一時的に非表示になります。ページのすべてのセクションを表示するには、「すべて表示」をクリックします。

レポート・テンプレート

「テンプレート名」は、テンプレートの名前を示します。「テンプレート・タイプ」には、テンプレートのタイプを指定します。名前付き列テンプレートは、テンプレートの列名を参照します。汎用列テンプレートは、テンプレートの#COLUMN_VALUE#置換文字列を参照します。

「テーマ」は、テンプレートが関連付けられているテーマを示します。「テンプレート・クラス」は、そのテンプレートに固有の用途を示します。新しいテーマに切り替えると、あるテーマのすべてのテンプレートは、別のテーマの対応するテンプレートにマップされます。アプリケーション・ビルダーは、テンプレート・クラスの割当てによってこのテンプレート・マッピングを行います。テンプレートに翻訳が必要なテキスト文字列が含まれていることを示すには、「翻訳可能」チェック・ボックスを使用します。

テンプレート・サブスクリプション

カレント・アプリケーションに既存のテンプレートを適用するには、「テンプレートのサブスクリプション」を使用します。既存のテンプレートを選択すると、ユーザーはそのテンプレートのサブスクライバになります。

マスター・テンプレートの新しいコピーをロードするには、「テンプレートのリフレッシュ」をクリックします。

行の前

「行の前」では、レポート・テンプレートの最初に1回表示するHTMLを入力します。HTML表は、一般的に、次のようにこの属性を使用して開始します。

<table>

構文#1#、#2#、#3#を使用して列ヘッダーを指定できます。次に例を示します。

<th>#1#</th><th>#2#</th><th>#3#</th>

置換文字列#TOP_PAGINATION#を含めることによって、レポートの上部にページ区切りを含めることができます。この置換文字列は、開始タグ<tr>で始まり、閉じタグ</tr>で終わるHTMLを生成します。たとえば、表の開始タグと#TOP_PAGINATION#置換文字列を含めるには、次のように入力します。

<table>#TOP_PAGINATION#

また、置換文字列 #CSV_LINK#を使用すると、ほぼすべてのスプレッドシート・プログラムと互換性があるカンマ区切り値(CSV)形式にレポートをエクスポートできるようになります。

列見出し

「列ヘッダー・テンプレート」を使用して、各列ヘッダーのセルに色を追加します。この属性のテキストには、セルのヘッダー・テキストをカラー化する位置を指定する必要があります。次に例を示します。

<th #ALIGNMENT#>#COLUMN_HEADER#</th>

列ヘッダーを使用しない場合は、次のように入力します。

OMIT

この属性を使用しない場合は、Application Expressエンジンによって、デフォルトの列ヘッダー・テンプレートが適用されます。

各行の前

「各行の前」では、レポートのすべての列の前に表示するテキストを入力します。この属性は、新しいHTML行を開始するために使用します。「各行の前」では、次の置換文字列をサポートします。

- #ROWNUM#
この置換文字列は、現行の行を指定するために使用します。

- #COLCOUNT#
この置換文字列は、列の数を指定するために使用します。

- #HIGHLIGHT_ROW#
この置換文字列は、ハイライトされた行の数を指定するために使用します。

列テンプレート

列テンプレートは、各列の外観を定義します。最大4つの列テンプレートを定義できます。各テンプレートは、条件付きにできます。たとえば、偶数行と奇数行に異なる背景色を指定したり、PL/SQLで定義した条件に一致する行をハイライトできます。

各列テンプレートでは、各列の外観を定義します。表10-6に、列テンプレートでサポートされる置換文字列を示します。

表 10-6 列テンプレートの置換文字列

置換文字列

説明

#ALIGNMENT#

列の位置合せを指定します。ユーザーが指定します。

#COLCOUNT#

列数のカウントを定義します。

#COLNUM#

現在の列番号を定義します。

#COLUMN_HEADER#

列ヘッダーを定義します。

#COLUMN_VALUE#

列の値に置換されます。

#ROWNUM#

現在の行番号を指定します。

次に例を示します。

<td> #ALIGNMENT#>#COLUMN_VALUE#</td>

実際にこのレポートを実行すると、これらの置換文字列は、SQL問合せの結果によって生成された値に置換されます。

条件を作成すると、指定した条件に一致するかどうかによって列の表示が異なるレポートを作成できます。条件付きで使用される列テンプレートを指定するには、列テンプレートの条件リストから条件タイプを選択します。有効な値は、次のとおりです。

- PL/SQL式に基づく使用:その行のデータに基づき、条件付きで列を書式化します。

- 偶数行で使用:偶数行を条件付きで書式化します。

- 奇数行で使用:奇数行を条件付きで書式化します。

「PL/SQL式に基づく使用」を選択する場合は、次に列テンプレートの式フィールドでPL/SQL式を入力します。たとえば、次の式で値が2000より大きい場合、その値を太字で表示します。

#SAL# > 2000

置換文字列#ROWNUM#を使用することもできます。次に例を示します。

#ROWNUM# > 2000

各行の後

「各行の後」には、レポートを表示する際にすべての列の後に表示するHTMLを入力します。多くの場合、この属性は、HTML表の行を閉じるために使用されます。次に例を示します。

</tr>

行の後

「行の後」を使用して、最後の行の後に表示するテキストを指定します。HTML表のタグは、一般的に、この属性を使用して閉じます。次に例を示します。

</table>

「行の後」属性は、次の置換文字列をサポートします。

- #PAGINATION#
ページ区切り属性で置換されます。

- #COLCOUNT#
実行時に、レポートで定義された列数に置換されます。

行選択

「チェックした行のバックグラウンド・カラー」を使用して、行セレクタが選択されている場合のレポート行の背景色を制御します。「カレント行のバックグラウンド・カラー」を使用して、ユーザーがその行の上にマウスを移動した場合のレポート行の背景色を制御します。

ページ区切りサブテンプレート

「ページ区切りのサブテンプレート」セクションには、「ページ区切りテンプレート」、「次のページ・テンプレート」、「前のページ・テンプレート」、「次のセット・テンプレート」および「前のセット・テンプレート」を編集する属性が含まれています。ページ区切りのサブテンプレートは、置換文字列#PAGINATION_NEXT#、#PAGINATION_NEXT_SET#、#PAGINATION_PREVIOUS#および#PAGINATION_PREVIOUS_SET#をサポートしています。表10-9に、これらのテンプレートについて示します。

表 10-7 ページ区切りのサブテンプレート属性

ページ区切りサブテンプレート属性

説明

ページ区切りテンプレート

ページ区切りサブテンプレート全体に適用します。次に例を示します。

<span class="instructiontext">#TEXT#</span>

置換文字列#TEXT#を使用して、ページ区切りサブテンプレートを表示する場所を指定します。

個々のアイテムを変更するには、その他のページ区切りサブテンプレート属性を使用します。

次のページ・テンプレート

ページ区切りサブテンプレートの「次のページ」部分を表示する方法を変更するHTMLを入力します。次に例を示します。

<a href="#LINK#">next</a>

前のページ・テンプレート

ページ区切りサブテンプレートの「前のページ」部分を表示する方法を変更するHTMLを入力します。次に例を示します。

<a href="#LINK#">previous</a>

次のセット・テンプレート

ページ区切りサブテンプレートの「次のセット」部分を表示する方法を変更するHTMLを入力します。次に例を示します。

<a href="#LINK#">next set</a>

前のセット・テンプレート

ページ区切りサブテンプレートの「前の設定」部分を表示する方法を変更するHTMLを入力します。次に例を示します。

<a href="#LINK#">previous set</a>

コメント

この属性を使用して、このコンポーネントに関するコメントを記録します。

名前付き列テンプレートのレポート列テンプレート属性

ここでは、名前付き列テンプレートのレポート・テンプレートの編集ページの特定のセクションについて説明します。ページの各セクションにアクセスするには、ページをスクロール・ダウンするか、ページ上部のナビゲーション・ボタンをクリックします。ページの上部でボタンを選択すると、選択したセクションが表示され、その他すべてのセクションは一時的に非表示になります。ページのすべてのセクションを表示するには、「すべて表示」をクリックします。

名前

「テンプレート名」は、テンプレートの名前を示します。「テンプレート・タイプ」には、テンプレートのタイプを指定します。名前付き列テンプレートは、テンプレートの列名を参照します。汎用列テンプレートは、テンプレートの#COLUMN_VALUE#置換文字列を参照します。

「テーマ」は、テンプレートが関連付けられているテーマを示します。テンプレートに翻訳が必要なテキスト文字列が含まれていることを示すには、「翻訳可能」チェック・ボックスを使用します。「テンプレート・クラス」は、そのテンプレートに固有の用途を示します。新しいテーマに切り替えると、あるテーマのすべてのテンプレートは、別のテーマの対応するテンプレートにマップされます。アプリケーション・ビルダーは、テンプレート・クラスの割当てによってこのテンプレート・マッピングを行います。

サブスクリプション

「サブスクリプション」を使用して、カレント・アプリケーションに既存のテンプレートを適用します。既存のテンプレートを選択すると、ユーザーはそのテンプレートのサブスクライバになります。

マスター・テンプレートの新しいコピーをロードするには、「リフレッシュ」をクリックします。

行テンプレート

行テンプレートは、各行の外観を定義します。最大4つの行テンプレートを定義できます。各テンプレートは、条件付きにできます。

各行テンプレートでは、各行の外観を定義します。表10-8に、行テンプレートでサポートされる置換文字列を示します。

表 10-8 行テンプレートの置換文字列

置換文字列

説明

#ALIGNMENT#

行の位置合せを指定します。ユーザーが指定します。

#COLCOUNT#

列数のカウントを定義します。

#COLNUM#

現在の列番号を定義します。

#COLUMN_HEADER#

列ヘッダーを定義します。

#COLUMN_VALUE#

列の値に置換されます。

#ROWNUM#

現在の行番号を指定します。

条件を作成すると、指定した条件に一致するかどうかによって行の表示が異なるレポートを作成できます。条件付きで使用される行テンプレートを指定するには、列テンプレートの条件リストから条件タイプを選択します。有効な値は、次のとおりです。

- PL/SQL式に基づく使用:その行のデータに基づき、条件付きで列を書式化します。

- 偶数行で使用:偶数行を条件付きで書式化します。

- 奇数行で使用:奇数行を条件付きで書式化します。

「PL/SQL式に基づく使用」を選択する場合は、次に列テンプレートの式フィールドでPL/SQL式を入力します。たとえば、次の式で値が2000より大きい場合、その値を太字で表示します。

#SAL# > 2000

置換文字列#ROWNUM#を使用することもできます。次に例を示します。

#ROWNUM# > 2000

列見出し

各列ヘッダーのセルに色を追加するには、このテンプレートを使用します。この属性のテキストには、セルのヘッダー・テキストをカラー化する位置を指定する必要があります。「列ヘッダー・テンプレート」を入力しない場合は、デフォルトの列ヘッダー・テンプレートが適用されます。列ヘッダーを使用しない場合は、OMITを入力します。次に例を示します。

<th #ALIGNMENT#>#COLUMN_HEADER#</th>

最初の前および最後の後のテキスト

「行の前」では、レポート・テンプレートの最初に1回表示するHTMLを入力します。HTML表は、一般的に、次のようにこの属性を使用して開始します。

<table>

構文#1#、#2#、#3#を使用して列ヘッダーを指定できます。次に例を示します。

<th>#1#</th><th>#2#</th><th>#3#</th>

置換文字列#TOP_PAGINATION#を含めることによって、レポートの上部にページ区切りを含めることができます。この置換文字列は、開始タグ<tr>で始まり、閉じタグ</tr>で終わるHTMLを生成します。たとえば、表の開始タグと#TOP_PAGINATION#置換文字列を含めるには、次のように入力します。

<table>#TOP_PAGINATION#

また、置換文字列#CSV_LINK#を使用すると、ほぼすべてのスプレッドシート・プログラムと互換性があるCSVフォーマットにレポートをエクスポートできるようになります。

「行の後」を使用して、最後の行の後に表示するテキストを指定します。HTML表のタグは、一般的に、この属性を使用して閉じます。次に例を示します。

</table>

「行の後」属性は、次の置換文字列をサポートします。

- #PAGINATION#
ページ区切り属性で置換されます。

- #COLCOUNT#
実行時に、レポートで定義された列数に置換されます。

ページ区切り

「ページ区切り」セクションには、「ページ区切りテンプレート」、「次のページ・テンプレート」、「前のページ・テンプレート」、「次のセット・テンプレート」および「前のセット・テンプレート」を編集する属性が含まれています。ページ区切りのサブテンプレートは、置換文字列#PAGINATION_NEXT#、#PAGINATION_NEXT_SET#、#PAGINATION_PREVIOUS#および#PAGINATION_PREVIOUS_SET#をサポートしています。表10-9に、これらのテンプレートについて示します。

表 10-9 ページ区切りのサブテンプレート属性

ページ区切りサブテンプレート属性

説明

ページ区切りテンプレート

ページ区切りサブテンプレート全体に適用します。次に例を示します。

<span class="instructiontext">#TEXT#</span>

置換文字列#TEXT#を使用して、ページ区切りサブテンプレートを表示する場所を指定します。

個々のアイテムを変更するには、その他のページ区切りサブテンプレート属性を使用します。

次のページ・テンプレート

ページ区切りサブテンプレートの「次のページ」部分を表示する方法を変更するHTMLを入力します。次に例を示します。

<a href="#LINK#">next</a>

前のページ・テンプレート

ページ区切りサブテンプレートの「前のページ」部分を表示する方法を変更するHTMLを入力します。次に例を示します。

<a href="#LINK#">previous</a>

次のセット・テンプレート

ページ区切りサブテンプレートの「次のセット」部分を表示する方法を変更するHTMLを入力します。次に例を示します。

<a href="#LINK#">next set</a>

前のセット・テンプレート

ページ区切りサブテンプレートの「前の設定」部分を表示する方法を変更するHTMLを入力します。次に例を示します。

<a href="#LINK#">previous set</a>

コメント

この属性を使用して、このコンポーネントに関するコメントを記録します。

列テンプレートでのJavaScriptの使用について

JavaScriptを使用すると、データベース内の値に応じてHTMLを条件付きで表示できます。次の例では、GROUP_DESC問合せ列がNULLでない場合にのみHTML行が表示されます。

<script language="javascript">
IF ( "#GROUP_DESC#" != "" )
document.writeln( "<TR>;
<TD BGCOLOR=#336699>;</TD>
</TR>
</TR>
<TD>#GROUP_DESC#</TD>
</TR>" );
</TR>" );

関連項目:

- レポート・テンプレートの編集ページ固有のセクションを使用する方法については、オンライン・ヘルプを参照してください。

- 「リージョンの理解」

カスタム・カスケード・スタイルシートの使用

カスケード・スタイルシート(CSS)によって、構造を変更せずにWebページのスタイルを制御できます。CSSを適切に使用すると、カラー、余白、フォントなどの視覚属性がHTMLドキュメントの構造から切り離されます。Oracle Application Expressのテーマには、独自のCSSを参照するテンプレートを含めることができます。特定のテーマの各CSSで定義されたスタイル・ルールによって、レポートおよびリージョンの表示も指定されます。

この項に含まれる内容は次のとおりです。

- カスケード・スタイルシートのアップロード

- ページ・テンプレートのアップロードされたカスケード・スタイルシートの参照

関連項目:
「CSSファインダの使用」

カスケード・スタイルシートのアップロード

カスケード・スタイルシートをワークスペースにアップロードするには、カスケード・スタイルシート・リポジトリを使用します。アップロードされたカスケード・スタイルシート(CSS)は、ワークスペースに作成されたすべてのアプリケーションで使用できます。カスケード・スタイルシートは、ファイル・システムに書き込まれるため、HTMLソース・コードで参照できます。

カスケード・スタイルシートをアップロードするには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。
共有コンポーネント・ページが表示されます。

4. 「ファイル」で、「カスケード・スタイルシート」を選択します。
カスケード・スタイルシート・ページが表示されます。

5. 「ビュー」リストから「詳細」を選択します。「カスケード・スタイルシート・ページについて」を参照してください。

6. CSSをアップロードするには、「作成」をクリックして、画面に表示されるステップに従います。

7. 既存のCSSを編集するには、CSSの名前を選択します。

8. 既存のCSSをダウンロードするには、「ダウンロード」アイコンをクリックします。

カスケード・スタイルシート・ページについて

CSSをCSSリポジトリにアップロードした後、「ビュー」リストで選択して、ページの表示方法を制御します。使用可能なオプションは次のとおりです。

- アイコン(デフォルト): 各CSSを大きいアイコンとして表示します。CSSを編集するには、該当するアイコンをクリックします。

- 詳細: 各CSSをレポートで1行に表示します。CSSを編集するには、該当する名前をクリックします。

ページ・テンプレートのアップロードされたカスケード・スタイルシートの参照

ページ・テンプレートのヘッダー・セクション内でアップロードされたカスケード・スタイルシートを参照できます。ヘッダー・セクションを使用して、HTMLドキュメントの<HEAD>セクションを構成するHTMLを入力します。

アップロードされたカスケード・スタイルシートを参照するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「ユーザー・インタフェース」で、「テーマ」を選択します。
テーマ・ページが表示されます。

5. 「タスク」リストで、「テンプレートの表示」をクリックします。

6. 編集するページ・テンプレートの名前を選択します。

7. Headセクション内の<link>タグを使用して、適切なスタイルシートを参照します。
特定のアプリケーションに関連付けられたアップロード済ファイルを参照するには、置換文字列#APP_IMAGES#を使用します。次に例を示します。

<html>
<head>
<title>#TITLE#</title>
#HEAD#
<link rel="stylesheet" href="#APP_IMAGES#sample2.css" type="text/css">
</head>
...

特定のワークスペースに関連付けられたアップロード済ファイルを参照するには、置換文字列#WORKSPACE_IMAGES#を使用します。次に例を示します。

<html>
<head>
<title>#TITLE#</title>
#HEAD#
<link rel="stylesheet" href="#WORKSPACE_IMAGES#sample3.css" type="text/css">
</head>
...

関連項目:
「カスケード・スタイルシートのアップロード」、「新しいテンプレートの作成」、「テンプレートの管理」、「ページ・テンプレート」、「APP_IMAGES」および「WORKSPACE_IMAGES」

11 ユーザー・インタフェースのデフォルト値の管理

ユーザー・インタフェースのデフォルト値を使用して、指定したスキーマ内の表、列またはビューにデフォルトのユーザー・インタフェースのプロパティを割り当てることができます。ウィザードを使用してフォームまたはレポートを作成する場合、ウィザードはこの情報を使用してリージョン・プロパティおよびアイテム・プロパティのデフォルト値を作成します。ユーザー・インタフェースのデフォルト値を使用すると、貴重な開発時間を節約でき、さらにアプリケーション内の複数のページで一貫性を保つことができるという利点もあります。

ユーザー・インタフェースのデフォルト値は、表に関連付けられているため、フォームおよびレポート・ウィザードで作成されたアプリケーションで使用できます。

この項には、次の項目が含まれます。

- ユーザー・インタフェースのデフォルト値が使用されている表またはビューの表示

- 列属性の編集

- アプリケーション間でのユーザー・インタフェースのデフォルト値の比較

- ユーザー・インタフェースのデフォルト値のエクスポートおよびインポートについて

関連項目:
「アプリケーション・モジュールおよびユーザー・インタフェースのデフォルト値の利用」

ユーザー・インタフェースのデフォルト値が使用されている表またはビューの表示

ユーザー・インタフェースのデフォルト値が使用されている表またはビューを表示するには、「ユーザー・インタフェースのデフォルト値」ページにナビゲートするか、オブジェクト・ブラウザでUIのデフォルト値のレポートを表示します。

この項に含まれる内容は次のとおりです。

- ユーザー・インタフェースのデフォルト値の作成

- オブジェクト・ブラウザでのUIのデフォルト値のレポートの表示

関連項目:
Oracle Application Express SQLワークショップおよびユーティリティ・ガイドの「オブジェクト・ブラウザを使用したデータベース・オブジェクトの管理」

ユーザー・インタフェースのデフォルト値の作成

ユーザー・インタフェースのデフォルト値を作成するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。
アプリケーション・ビルダーのホームページが表示されます。

2. アプリケーションを選択します。

3. 「アプリケーション」で、「共有コンポーネント」をクリックします。
共有コンポーネント・ページが表示されます。

4. 「ユーザー・インタフェース」で、「ユーザー・インタフェースのデフォルト値」を選択します。
ユーザー・インタフェースのデフォルト値ページが表示されます。

カレント・スキーマがブレッドクラム・メニューの右に表示されます。

5. 表示を絞り込むには、ページ上部の次のコントロールを使用して、「実行」をクリックします。

- 表/ビュー - カレント・スキーマ内の表またはビューの名前について、大/小文字を区別しない問合せを入力します。

- 表示 - 表示する表のタイプを決定します。

- ビュー - ビューに適用するフィルタを適用します。

- アイコン: 各表またはビューを大きいアイコンとして表示します。

- 詳細: 各表またはテーブルをレポートで1行に表示し、表またはビューの名前、オブジェクト・タイプ、および現在ユーザー・インタフェースのデフォルト値が存在するかどうかを示します。

- 表示: レポート内に表示されるアイテムの数を決定します。

6. 名前を選択して、特定の表またはビューを選択します。
表のデフォルト値ページが表示されます。

7. ユーザー・インタフェースのデフォルト値が存在しない場合は、「ユーザー・インタフェースのデフォルト値の作成」をクリックします。

ヒント:
アプリケーション・ビルダーのホームページまたはアプリケーションのホームページのいずれかの「タスク」リストの「ユーザー・インタフェースのデフォルト値」をクリックして、ユーザー・インタフェースのデフォルト値ページにアクセスすることもできます。「アプリケーション・ビルダーのホームページについて」および「アプリケーションのホームページについて」を参照してください。

オブジェクト・ブラウザでのUIのデフォルト値のレポートの表示

オブジェクト・ブラウザでユーザー・インタフェースの詳細レポートを表示するには、次のステップを実行します。

1. ワークスペースのホームページで、「SQLワークショップ」をクリックして、「オブジェクト・ブラウザ」をクリックします。
オブジェクト・ブラウザが表示されます。

2. 「オブジェクト」リストから、「表」または「ビュー」を選択します。

3. 「オブジェクト選択」ペインから、オブジェクトを選択します。

4. 「UIのデフォルト値」タブを選択します。
ユーザー・インタフェースのデフォルト値レポートに次の情報が表示されます。

- 列名 - 列の名前を示します。

- ラベル - フォームのアイテムおよびレポートの列ヘッダーにデフォルトのラベル・テキストを指定します。

- レポート順序 - レポート内のアイテムの順序を指定します。

- レポート表示 - レポート内での列の表示方法を指定します。

- 表形式フォーム表示 - 表形式フォーム内でのアイテムの表示方法を指定します。

- フォーム順序 - フォーム内のアイテムの順序を指定します。

- フォーム表示 - フォーム内でのアイテムの表示方法を指定します。

5. ユーザー・インタフェースのデフォルト値を編集するには、「編集」をクリックします。
表のデフォルト値ページが表示されます。

6. ユーザー・インタフェースのデフォルト値が存在しない場合は、「デフォルトの作成」をクリックします。

列属性の編集

列属性を編集して、特定の列のユーザー・インタフェースのデフォルト値を定義します。

列属性を編集するには、次のステップを実行します。

1. 表のデフォルト値ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「アプリケーション」で、「共有コンポーネント」をクリックします。

4. 「ユーザー・インタフェース」で、「ユーザー・インタフェースのデフォルト値」を選択します。
ユーザー・インタフェースのデフォルト値ページが表示されます。

5. 名前を選択して、特定の表またはビューを選択します。
表のデフォルト値ページが表示されます。

次の情報は表のデフォルト値ページの上部に表示されます。

- 表/ビューの名前: 選択した表またはビューの名前が表示されます。

- 「レポート・リージョン・タイトル」および「フォーム・リージョン・タイトル」: すべてのレポート・リージョンおよびフォーム・リージョンのデフォルトのタイトルになります。これらの名前は、表/ビューの名前を変更したものであり、最初の文字を大文字にし、アンダースコアを空白に置き換えた形式です。

次に、列レベルのユーザー・インタフェースのデフォルト値が表示されます。デフォルトでは、簡易レポートが表示されます。

2. 完全なレポートを表示するには、「詳細レポート」をクリックします。

3. 表示されたすべての列の選択した属性を編集するには、次のステップを実行します。

1. 「グリッド編集」をクリックします。

2. 該当する属性を編集し、「変更の適用」をクリックします。

4. 特定の列を編集するには、列名を選択します。
列のデフォルト値が表示されます。列のデフォルト値は2ページに分けて表示されます。

- 列定義

- LOV

次のトピックでは、これらのページに表示された個別の属性の編集方法について説明します。

列の定義について

列の定義は、列属性を編集するときに表示されるデフォルト・ページです。ページの上部に、選択したスキーマ、表名またはビュー名、および列名が表示されます。特定の列の詳細を表示するには、「データベース列の定義の表示」をクリックします。

ラベルのデフォルト

この属性はレポートおよびフォームで使用されます。「ラベル」を使用して、フォームのアイテムおよびレポートの列ヘッダーにデフォルトのラベル・テキストを指定します。

レポートのデフォルト値

選択可能な属性は次のとおりです。

- 表示 - レポートにこの列を表示するかどうかを指定します。デフォルト値は、「はい」です。

- 表示順序 - レポート内のアイテムの表示順序を指定します。デフォルト値は、列IDに基づき、この列IDは表内の列の順序に基づきます。

- 表示形式 - レポート内での列の表示方法を指定します。

- マスク - データに対してマスクを適用するかどうかを指定します。この属性は、キャラクタベースのアイテムに対しては適用できません。

- 位置合せ - レポートの位置合せ(左、中央または右)を指定します。列が数字である場合、デフォルト値は「右」です。数字以外の場合、デフォルト値は「左」です。

- 検索可能 - レポート内で列が選択可能であるかどうかを指定します。列がVARCHAR2またはCHARの場合、デフォルト値は「はい」です。それ以外の場合、デフォルト値は「いいえ」です。

- グループ化 - 列が「グループ化」に使用され、グループ化の順序に使用されるかどうかを指定します。デフォルト値は、「はい」です。

- 集計方法 - 列をレポートおよびチャート内での集計に使用するかどうかを指定します。

表形式フォームのデフォルト

表形式フォーム内でのアイテムの表示方法を指定するには、「表示形式」を使用します。

フォームのデフォルト値

選択可能な属性は次のとおりです。

- 表示 - フォームに列を表示するかどうかを指定します。デフォルト値は、「はい」です。

- 表示順序 - フォーム内のアイテムの順序を指定します。デフォルト値は、列IDに基づき、この列IDは表内の列の順序に基づきます。

- 表示形式 - フォーム内でのアイテムの表示方法を指定します。デフォルトの選択値は、「テキスト・フィールド」です。

- マスク - フォーム内のデータに対してマスクを適用するかどうかを指定します。キャラクタベースのアイテムに対しては使用されません。

- デフォルト値 - この列に対応するデフォルト値を指定します。

- 幅 - 表示幅を指定します。

- 最大幅 - このアイテムに入力できる文字列の最大長を指定します。

- 高さ - アイテムを表示する高さを指定します。

- 必須 - 検証の結果、アイテムが必ずNULLにならないような検証を生成するために使用されます。検証の結果、アイテムがNOT NULLになる場合は、「はい」を選択します。

- ヘルプ・テキスト - アイテム・ヘルプになります。デフォルトでは、このテキストは列のヒントから引用されます(適用可能な場合)。

LOVについて

LOVページにアクセスするには、「LOV」タブをクリックします。ページの上部に、選択したスキーマ、表名またはビュー名、および列名が表示されます。特定の列の詳細を表示するには、「データベース列の定義の表示」をクリックします。

「LOVタイプ」リストを使用して、選択した列に静的LOVまたは動的LOVを含めるかどうかを指定します。タイプを選択すると、表示値、戻り値またはLOV問合せのいずれかのペアを入力するように求められます。

データベース列の定義レポートについて

列の定義レポートにアクセスして、特定の列の詳細を表示できます。列の定義レポートには、チェック制約、列を参照する主キー、一意キーおよび外部キーのみでなく、スキーマ、表名、列名、データ型、データ長、NULL値可能も表示されます。このレポートへのリンクは、列の定義ページとLOVページの両方に表示されます。

「列の定義」レポートを表示するには、次のステップを実行します。

1. 表のデフォルト値ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「アプリケーション」で、「共有コンポーネント」をクリックします。

4. 「ユーザー・インタフェース」で、「ユーザー・インタフェースのデフォルト値」を選択します。
ユーザー・インタフェースのデフォルト値ページが表示されます。

5. 名前を選択して、特定の表またはビューを選択します。

表のデフォルト値ページが表示されます。

2. 列名を選択します。

3. 「スキーマと表」で、「データベース列の定義の表示」リンクをクリックします。

アプリケーション間でのユーザー・インタフェースのデフォルト値の比較

「デフォルト値を比較」レポートを使用して、単一または複数のアプリケーション内のすべてのページにわたってユーザー・インタフェース設計の一貫性を監視します。「デフォルト値を比較」レポートを実行すると、現在定義されているユーザー・インタフェースのデフォルト値(または列属性)がフォーム、レポートおよび表形式フォームに対して設定されたアイテム属性と比較されます。

関連項目:
「列属性の編集」

「デフォルト値を比較」レポートを実行するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。
共有コンポーネント・ページが表示されます。

4. 「ユーザー・インタフェース」で、「ユーザー・インタフェースのデフォルト値」を選択します。
ユーザー・インタフェースのデフォルト値ページが表示されます。

5. 「タスク」リストで、「比較レポート」をクリックします。
カレント・スキーマがブレッドクラム・メニューの右に表示されます。

6. 次のリストからセクションを作成し、「実行」をクリックします。

1. 表/ビュー - 選択した表またはビューに限定して比較します。

2. 列 - フォーム、レポートおよび表形式フォームを検索する列を選択します。

7. オプションで、次のリストからセクションを作成し、「実行」をクリックします。

- 表示 - 属性カテゴリを選択します。

- アプリケーション - アプリケーションを選択します。

次のセクションを含むレポートが表示されます。

- 選択した列を参照するフォーム・ページ

- 選択した列を参照するレポート・リージョン

- 選択した列を参照する表形式フォーム・リージョン

ユーザー・インタフェースのデフォルト値のエクスポートおよびインポートについて

関連するアプリケーション・ファイルのエクスポートと同様の方法でユーザー・インタフェースのデフォルト値をエクスポートします。1つの開発インスタンスから別のインスタンスへユーザー・インタフェースのデフォルト値をエクスポートするには、次のステップを実行します。

1. ユーザー・インタフェースのデフォルト値のエクスポート・ユーティリティを使用してユーザー・インタフェースのデフォルト値をエクスポートします。詳細は、「ユーザー・インタフェースのデフォルト値のエクスポート」を参照してください。

2. エクスポートされたファイルをターゲットのOracle Application Expressインスタンスにインポートします。詳細は、「ユーザー・インタフェースのデフォルト値のインポート」を参照してください。

3. エクスポートされたファイルをエクスポート・リポジトリからインストールします。「エクスポート・ファイルのインストール」を参照してください。

ユーザー・インタフェースのデフォルト値をエクスポートする場合は、選択したスキーマに対するすべてのユーザー・インタフェースのデフォルト値が、1つのスクリプトにエクスポートされます。このファイルには、アプリケーションのPL/SQL APIをコールして表のヒントを作成するAPIコールが含まれています。このファイルを使用して、ユーザー・インタフェースのデフォルト値を別のデータベースおよびOracle Application Expressインスタンスにインポートできます。

12 アプリケーションのデバッグ

このセクションでは、デバッグ・モードの表示、SQLトレースの有効化、ページ・レポートの表示などのアプリケーションのデバッグ方法を説明します。また、コントロールまたはコンポーネントを手動で削除して問題を特定する方法も説明されます。

この項には、次の項目が含まれます。

- パフォーマンス・チューニングについて

- セッション・ステートの確認

- デバッグ・モードへのアクセス

- SQLトレースの有効化およびTKPROFの使用

- アプリケーションとページのリソース使用の監視

- レポートの表示

- 問題のあるSQL問合せのデバッグ

- コントロールおよびコンポーネントの削除による問題の特定

関連項目:
「アプリケーション・ビルダーの概念」および「アプリケーション・ビルダーの使用」

パフォーマンス・チューニングについて

多くの同時ユーザーが存在するアプリケーションでは、最適なパフォーマンスを保持することが重要です。アプリケーションのパフォーマンスを最適化するには、次の機能を使用する必要があります。

- アプリケーションではできるかぎりバインド変数を使用します。SQL問合せ、およびプロセスや検証から実行されるPL/SQLなどのアプリケーション・ロジックでバインド変数構文を使用すると、セッション・ステート値を参照できます。バインド変数を使用してセッション・ステートにアクセスすると、最も効率的にセッション・ステートを参照できます。

- #TIMING#置換文字列をリージョン・フッターに含めて、各リージョンのタイミングを表示できます。

関連項目:

- 「バインド変数構文について」

- 「置換文字列の理解」

セッション・ステートの確認

多くのアプリケーションは、アプリケーション・コントロールに含まれるデータに基づいています。たとえばボタンは、セッション・ステートに格納された値に基づいて、条件付きで表示できます。アプリケーションの現行のセッション・ステートを表示するには、「開発者」ツールバーの「セッション」リンクをクリックします。

関連項目:
「開発者ツールバーについて」、「セッション・ステートの表示」、「セッション・ステート値の管理」およびOracle Application Express管理ガイドの「セッション・ステートおよびユーザー・プリファレンスの管理」

デバッグ・モードへのアクセス

デバッグ・モードでページを表示すると、ページをレンダリングするApplication Expressエンジンの動作状況を追跡できます。デバッグ・モードにアクセスするには、開発者ツールバーの「デバッグ」リンクをクリックします。

関連項目:
「開発者ツールバーについて」

デバッグ・モードでは、特定のApplication Expressエンジンの動作に対応する時間コードが表示されます。これは、エンジンによってセッション・ステートが設定されるタイミングを判断するために役立ちます。また、「デバッグ」ビューには、アイテム名および計算ポイントとプロセス・ポイントの詳細も表示できます。デバッグ・モードを終了するには、開発者ツールバーの「デバッグなし」をクリックします。

また、f?p構文を使用してアプリケーションをデバッグ・モードで実行することもできます。この場合、ページをコールして、デバッグ引数をYESに設定するだけです。次に例を示します。

f?p=100:1:&APP_SESSION.::YES

関連項目:
「f?p構文を使用したページのリンク」

SQLトレースの有効化およびTKPROFの使用

セッションをトレースすると、アプリケーションを効率的にデバッグできます。データベースの観点では、各ページ・リクエストが単一のデータベース・セッションとみなされます。SQLトレースを有効にすると、Oracle Application Expressによって一時ファイルが作成されます。このファイルは、TKPROFユーティリティを使用して解析できます。

Oracle Application ExpressでSQLトレースを有効にするには、f?p構文を使用して引数p_trace=YESを設定します。たとえば、アプリケーション100の1ページ目の表示をトレースするには、次の構文を使用します。

http:/.../f?p=100:1&p_trace=YES

TKPROFユーティリティを使用するには、次の操作を実行します。

1. 権限を付与されたユーザーとしてSQL*Plusにログインします。

2. 次の文を実行します。

show parameter USER_DUMP_DEST

3. トレース・ファイルが作成されたディレクトリにナビゲートします。

4. 次の構文を使用して、オペレーティング・システムのプロンプトでTKPROFユーティリティを実行します。

tkprof filename1 filename2 [waits=yes|no] [sort=option] [print=n]
[aggregate=yes|no] [insert=filename3] [sys=yes|no] [table=schema.table]
[explain=user/password] [record=filename4] [width=n]

必要な引数は、入力ファイルと出力ファイルのみです。

5. オンライン・ヘルプを表示するには、引数なしでTKPROFを起動します。

関連項目:
TKPROFプログラムの使用の詳細は、Oracle Databaseパフォーマンス・チューニング・ガイドのアプリケーション追跡ツールの使用に関するセクションを参照してください。

アプリケーションとページのリソース使用の監視

Oracle Application Expressでは、パッケージDBMS_APPLICATION_INFOをコールして、アプリケーションおよびページで使用されるリソースを簡単に監視できます。Application Expressエンジンがページをレンダリングまたは処理すると、モジュールがAPEXに設定され、アプリケーションIDおよびページ番号が含められます。設定後は、V$SESSIONおよびV$SQLAREAビューを問い合せて、トランザクションを監視できます。

レポートの表示

ページ内の問題を特定する場合は、ページで実行されているファンクションを明確に理解している必要があります。このために、アプリケーション・ビルダーには多数のページおよびアプリケーションのレポートが含まれています。

ページ・レポートの表示

ページ・レポートを表示するには、次のステップを実行します。

1. 該当するページ定義にナビゲートします。「ページ定義へのアクセス」を参照してください。

2. 「ページ定義」の上部の次のいずれかのボタンをクリックします。

- イベント: 現在定義されているページ・コントロールおよびプロセスの詳細を表示するレポートにリンクします。詳細は、「ページ・イベントについて」を参照してください。

- オブジェクト: カレント・ページで参照されるデータベース・オブジェクトのリストが表示されます。詳細は、「データベース・オブジェクトの依存性について」を参照してください。

- 履歴: 最近変更されたページの履歴が表示されます。「履歴について」を参照してください。

関連項目:
「ページ定義での「ビュー」リストの使用」

アプリケーション・レポートの表示

アプリケーション・レポートを表示するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「タスク」リストで、「アプリケーション・レポート」をクリックします。

4. 表示するレポートのタイプを選択します。

- 共有コンポーネント・レポートは、アプリケーション内の各ページに表示できる共通する要素に関する情報を提供します。これらのレポートは、ロジック、ナビゲーション、セキュリティ、ユーザー・インタフェース、グローバリゼーションおよびファイルなどのカテゴリでグループ化されます。レポートの例には、「アプリケーション・アイテム」、「計算」、「ブレッドクラム・エントリ」、「認証スキーム」、および「ショートカット」などがあります。

- ページ・コンポーネント・レポートは、ページのレンダリング時に実行されるコントロールとロジックに関する詳細情報(たとえば、ブランチ、ボタン、計算、アイテム、リージョンなど)を提供します。

- アクティビティ・レポートは、カレント・アプリケーション内の開発者アクティビティの詳細を提供します。使用可能なレポートには、「開発者別の変更」、「日別開発者別の変更」、「開発者別の変更のチャート」、「ページ・パフォーマンス」、および「最近の変更」などがあります。

- アプリケーション間レポートは、複数のアプリケーションに適用される情報を提供します。使用可能なレポートには、「アプリケーション属性」、「アプリケーション・コメント」、「ビルド・オプション」、「ビルド・ステータスとアプリケーション・ステータス」、「ページ・コンポーネント・カウント」、「セキュリティ・プロファイル」、「認証スキーム」、および「アプリケーション別のデフォルトのテンプレート」などがあります。

関連項目:
「データベース・オブジェクトの依存性レポートについて」および「リージョン・ソースの検索レポートについて」

問題のあるSQL問合せのデバッグ

問合せが正常に実行されていない可能性がある場合、SQL*Plus、SQL DeveloperまたはSQLコマンドでの実行を試してください。いずれの方法でも、アプリケーションのコンテキスト外で問合せがテストされるため、問題を簡単に判別できます。

コントロールおよびコンポーネントの削除による問題の特定

ページを正常に実行できない場合は、コントロールとコンポーネントを一度に1つずつ削除することをお薦めします。この方法を使用すると、問題の原因となっている可能性があるコントロールまたはコンポーネントを迅速に判別できます。条件属性「なし」を選択すると、コントロールまたはコンポーネントを無効にできます。

条件付き属性を使用してコントロールまたはコンポーネントを削除するには、次のステップを実行します。

1. 該当するページ定義にナビゲートします。「ページ定義へのアクセス」を参照してください。

2. 無効にするコントロールまたはコンポーネントの名前を選択します。
該当する属性ページが表示されます。

3. 「条件タイプ」が表示されるまでスクロールして、「条件タイプ」リストから「なし」を選択します。

4. 「変更の適用」をクリックして、ページ定義に戻ります。

5. ページを再度実行します。

6. ページが正常に実行されるまで、コントロールまたはコンポーネントの削除を続けます。

関連項目:
「ページ定義へのアクセス」、「ページ属性の編集」、「条件付きのレンダリングおよびプロセスの理解」および「ページまたはアプリケーションの実行」

13 アプリケーション・セキュリティの管理

このセクションでは、Oracle Application Expressにセキュリティのベスト・プラクティスを実装する方法を説明します。管理者は、Oracle Application Expressインストールのセキュリティを保証する必要があります。開発者は、セキュアなアプリケーションを構築する必要があります。

この項には、次の項目が含まれます。

- セキュリティに関する管理者のベスト・プラクティスの理解

- セキュリティに関する開発者のベスト・プラクティスの理解

- ファイルのアップロードの保護

- 認証によるユーザー・アイデンティティの証明

- 認可を介したセキュリティの提供

関連項目:
「アプリケーション・ビルダーの概念」および「アプリケーション・ビルダーの使用」

セキュリティに関する管理者のベスト・プラクティスの理解

このセクションでは、Oracle Application Express管理者のためのセキュリティのベスト・プラクティスについて説明します。

この項に含まれる内容は次のとおりです。

- 埋込みPL/SQLゲートウェイを使用する場合のセキュリティに関する考慮事項

- Oracle Application Expressでのmod_plsqlを使用したOracle HTTP Serverの構成について

- Secure Sockets Layer(SSL)の使用

- Oracle BI Publisherとの統合

- パスワードの複雑性ルールの設定について

- Oracle Application Expressのランタイム環境の利点

- セッション・タイムアウトの理解

- Oracle Database 11gのネットワーク・サービスの有効化

- Oracle Database 11gリリース2以上でのオンライン・ヘルプの索引付けの有効化

埋込みPL/SQLゲートウェイを使用する場合のセキュリティに関する考慮事項

埋込みPL/SQLゲートウェイは、XML DB HTTPプロトコル・リスナーの一部としてデータベースで実行されます。XML DB HTTP Protocol Listenerおよび埋込みPL/SQLゲートウェイには、Oracle HTTP Serverおよびmod_plsqlと同等の主要機能があります。HTTPリスナーはOracle Application Expressがインストールされているデータベースと同じデータベースで実行されるため、データベースから分離できません。このため、インターネット上で実行されるアプリケーションには、埋込みPL/SQLゲートウェイを使用しないことをお薦めします。また、埋込みPL/SQLゲートウェイでは、mod_plsqlを使用するOracle HTTP Serverほどに柔軟な構成および詳細なログは提供されません。

Oracle Application Expressでのmod_plsqlを使用したOracle HTTP Serverの構成について

Oracle HTTP Serverは、mod_plsqlプラグインを使用してOracle Database内のOracle Application Expressエンジンと通信します。mod_plsqlファンクションは、WebサーバーとOracle Database内のOracle Application Expressエンジン間の通信ブローカとして機能します。

mod_plsqlの各リクエストは、Database Access Descriptor(DAD)というデータベースにアクセスする際に使用する一連の構成値に関連付けられます。mod_plsqlには、リクエストされたプロシージャのさらなる処理を許可または禁止することができるPlsqlRequestValidationFunctionというDADパラメータがあります。このパラメータを使用すると、DADからの実行の許可対象にしないパッケージおよびプロシージャのコールをブロックすることで、PL/SQLアプリケーションにさらに強力なセキュリティを実装できます。Oracle Application ExpressのDAD構成では、PlsqlRequestValidationFunctionディレクティブに値wwv_flow_epg_include_modules.authorizeを使用することをお薦めします。

PlsqlRequestValidationFunctionパラメータの目的は、mod_plsqlによってどのプロシージャが起動されるかを制御することです。デフォルトでは、Oracle Application Expressのパブリックなエントリ・ポイントのみが許可されます。これは、Oracle Application Expressに付属する検証ファンクションを使用して拡張できます。詳細は、Oracle Application Express管理ガイドのOracle Application Expressへのアクセスの制限に関するセクションを参照してください。

Secure Sockets Layer (SSL)の使用

Secure Sockets Layer(SSL)は、インターネット上に転送されるデータのセキュリティを管理するためのプロトコルです。SSLは、HTTPSプロトコルを使用してWebアプリケーションに実装されます。機密データが暗号化されていない(クリアテキストの)通信チャネルに送信されないように、SSL (HTTPSプロトコル)を使用してOracle Application Expressアプリケーションを実行することをお薦めします。

Oracle Application Express管理サービスのサービスの管理ページで「HTTPSが必要」属性を「はい」に設定すると、Oracle Application Expressインスタンスとすべての関連アプリケーションで、HTTPSを要求することができます。

「HTTPSが必要」属性を「はい」に設定してログアウトすると、プロトコルにHTTPSが使用されないかぎり、Oracle Application Express管理サービスおよびOracle Application Expressワークスペースに開発者または管理者としてログインできなくなります。

関連項目:
Oracle Application Express管理ガイドの「HTTPSの必要性」

Oracle BI Publisherとの統合

Oracle Application ExpressとOracle BI Publisherを統合する場合は、Secure Sockets Layer(SSL)を使用することをお薦めします。Oracle BI Publisherサーバー用にSSL(HTTPSプロトコル)を構成したら、ウォレットを作成して、内部管理環境設定でレポート・サーバーにHTTPSプロトコルを指定する必要があります。

関連項目:
Oracle Application Express管理ガイドの「ウォレット情報の構成」および「レポート出力の構成」

パスワードの複雑性ルールの設定について

ワークスペースの管理者および開発者は、Oracle Application Expressの開発環境にログインし、ワークスペース内で開発されたアプリケーションに対するエンド・ユーザーの認証を行うためのユーザー・アカウントを作成できます。Oracle Application Express管理者は、これらのアカウントのパスワードに対して、パスワードの複雑性ルール(またはポリシー)を作成できます。これらのルールは、全ワークスペースで、インストールのすべてのアカウントに適用されます。

次に、パスワードの複雑性ポリシーの例を示します。

すべてのパスワードには、次が含まれている必要があります。

- 1つ以上の大文字。

- 1つ以上の数字。

- 6つ以上の文字。

他にも多くのバリエーションが考えられることに注意してください。各Oracle Application Expressインスタンスに対して、管理者がパスワードの複雑性ポリシーを作成することをお薦めします。詳細は、Oracle Application Express管理ガイドの「すべてのワークスペースに対するログイン制御の有効化」、「パスワード・ポリシーについて」および「ワークスペースに対するログイン制御の有効化」を参照してください。

パスワードの再利用の制限

サイト管理者は、すべての管理者アカウント、開発者アカウントおよびエンド・ユーザー・アカウントに対し、そのアカウントに以前使用されたパスワードの履歴に基づいて、パスワードの再利用を制限することができます。

パスワードの再利用を制限するには、次のステップを実行します。

1. SQL*Plusを起動して、Oracle Application Expressがインストールされたデータベースに、apex_administrator_roleロールを使用するか、SYSDBAロールを指定するSYSとして接続します。次に例を示します。

- Windowsの場合:

SYSTEM_DRIVE:\ sqlplus /nolog
SQL> CONNECT SYS as SYSDBA
Enter password: SYS_password

- UNIXおよびLinuxの場合:

$ sqlplus /nolog
SQL> CONNECT SYS as SYSDBA
Enter password: SYS_password

2. 次の文を実行します。

ALTER SESSION SET CURRENT_SCHEMA = APEX_030200;

3. 次の文を実行します。

BEGIN
APEX_INSTANCE_ADMIN.SET_PARAMETER('PASSWORD_HISTORY_DAYS',365);
COMMIT;
END;
/

これによって、作成または更新するパスワードは、過去365日間にそのアカウント用として使用されていないものに制限されます。以前に使用されたパスワード(実際は、パスワードのハッシュ表現)は、Oracle Application Express 3.2をインストールしたときから記録されます。

4. この機能を無効にするには、パラメータ値に0を指定して前述のブロックを実行します。次に例を示します。

BEGIN
APEX_INSTANCE_ADMIN.SET_PARAMETER('PASSWORD_HISTORY_DAYS',0);
COMMIT;
END;
/

ヒント:
開発者は、Oracle Application Express APIリファレンスに記載されているAPEX_UTIL.STRONG_PASSWORD_CHECKプロシージャおよびAPEX_UTIL.STRONG_PASSWORD_VALIDATIONファンクションも使用することができます。

Oracle Application Expressのランタイム環境の利点

Oracle Application Expressのランタイム環境では本番アプリケーションを実行できますが、管理用のWebインタフェースは使用できず、これらのアプリケーションを直接開発することはできません。

機密の本番Oracle Application Expressアプリケーションは、Oracle Application Expressのランタイム・インストールで実行することをお薦めします。ランタイム・インストールでは、Webベースのアプリケーション開発環境が使用されないため、Application Builder、SQL Workshopおよび本番インストールに関係するユーティリティが使用できません。また、ランタイム環境に含まれるのは、アプリケーションの実行に必要なOracle Application Expressデータベース・オブジェクトおよび権限のみであるため、より堅牢な環境になります。

関連項目:
Oracle Application Express管理ガイドの「ランタイム環境の管理」

セッション・タイムアウトの理解

「セッション・タイムアウト」属性を構成すると、アプリケーションの公開を抑制できます。ユーザーは、長時間コンピュータを操作しなかったり、アプリケーションを終了せずにコンピュータの元を離れることが頻繁にあります。このため、アプリケーションのユーザー・アイデンティティが、権限のないユーザーによって簡単に引き継がれる可能性があります。セッション・タイムアウトおよびアイドル・タイムアウトを設定すると、指定したタイムアウトの後、ユーザーは自動的にアプリケーションからログアウトされます。

「セッション・タイムアウト」属性には、次のものがあります。

- 最大セッションの長さ

- セッション・タイムアウトURL

- 最大セッション・アイドル時間

- アイドル・タイムアウトURL

アプリケーション・レベルでのこれらの属性の構成の詳細は、「セッション・タイムアウト」を参照してください。Oracle Application Expressインスタンス全体でのこれらの属性の構成の詳細は、Oracle Application Express管理ガイドの「セッション・タイムアウトの構成」を参照してください。

Oracle Database 11gのネットワーク・サービスの有効化

Oracle Database 11g リリース1 (11.1)では、ネットワーク・サービスとの通信機能がデフォルトで無効になっています。このため、Oracle Database 11g リリース1 (11.1)でOracle Application Expressを実行している場合は、新しいDBMS_NETWORK_ACL_ADMINパッケージを使用して、APEX_030200データベース・ユーザーにすべてのホストに対する接続権限を付与する必要があります。これらの権限を付与しないと、次の動作で問題が発生します。

- Oracle Application Expressでアウトバウンド・メールを送信する。
ユーザーはAPEX_MAILパッケージからメソッドをコールできますが、アウトバンド・メールの送信時に問題が発生します。

- Oracle Application ExpressでWebサービスを使用する。

- PDF/レポートを印刷する。

- オンライン・ヘルプのコンテンツ検索(検索リンクの使用)

この項に含まれる内容は次のとおりです。

- ホストへの接続権限の付与

- ローカル・ホストへの接続権限の付与

- 無効なACLエラーのトラブルシューティング

ヒント:
このセクションで示されている例を実行するには、データベースのcompatible初期化パラメータが11.1.0.0.0以上に設定されている必要があります。11g データベースではデフォルトでパラメータが正しく設定されますが、以前のバージョンから11g にアップグレードされたデータベースでは正しく設定されていない場合があります。データベース初期化パラメータの変更については、『Oracle Database管理者ガイド』の「Oracle Databaseの作成および構成」を参照してください。

ホストへの接続権限の付与

次の例では、APEX_030200データベース・ユーザーにホストに対する接続権限を付与する方法が示されています。

DECLARE
ACL_PATH  VARCHAR2(4000);
ACL_ID    RAW(16);
BEGIN
-- Look for the ACL currently assigned to '*' and give APEX_030200
-- the "connect" privilege if APEX_030200 does not have the privilege yet.

SELECT ACL INTO ACL_PATH FROM DBA_NETWORK_ACLS
WHERE HOST = '*' AND LOWER_PORT IS NULL AND UPPER_PORT IS NULL;

-- Before checking the privilege, make sure that the ACL is valid
-- (for example, does not contain stale references to dropped users).
-- If it does, the following exception will be raised:
--
-- ORA-44416: Invalid ACL: Unresolved principal 'APEX_030200'
-- ORA-06512: at "XDB.DBMS_XDBZ", line ...
--
SELECT SYS_OP_R2O(extractValue(P.RES, '/Resource/XMLRef')) INTO ACL_ID
FROM XDB.XDB$ACL A, PATH_VIEW P
WHERE extractValue(P.RES, '/Resource/XMLRef') = REF(A) AND
EQUALS_PATH(P.RES, ACL_PATH) = 1;

DBMS_XDBZ.ValidateACL(ACL_ID);
IF DBMS_NETWORK_ACL_ADMIN.CHECK_PRIVILEGE(ACL_PATH, 'APEX_030200',
'connect') IS NULL THEN
DBMS_NETWORK_ACL_ADMIN.ADD_PRIVILEGE(ACL_PATH,
'APEX_030200', TRUE, 'connect');
END IF;

EXCEPTION
-- When no ACL has been assigned to '*'.
WHEN NO_DATA_FOUND THEN
DBMS_NETWORK_ACL_ADMIN.CREATE_ACL('power_users.xml',
'ACL that lets power users to connect to everywhere',
'APEX_030200', TRUE, 'connect');
DBMS_NETWORK_ACL_ADMIN.ASSIGN_ACL('power_users.xml','*');
END;
/
COMMIT;

ローカル・ホストへの接続権限の付与

次の例は、ローカル・ホスト上のリソースへのアクセス方法について、より低い権限で実行するデモンストレーションです。この例では、Oracle Application Expressオンライン・ヘルプの索引付けを有効にし、また電子メールとPDF印刷用サーバーもローカル・ホスト上に存在する場合には、これらも有効にします。

DECLARE
ACL_PATH  VARCHAR2(4000);
ACL_ID    RAW(16);
BEGIN
-- Look for the ACL currently assigned to 'localhost' and give APEX_030200
-- the "connect" privilege if APEX_030200 does not have the privilege yet.
SELECT ACL INTO ACL_PATH FROM DBA_NETWORK_ACLS
WHERE HOST = 'localhost' AND LOWER_PORT IS NULL AND UPPER_PORT IS NULL;

-- Before checking the privilege, make sure that the ACL is valid
-- (for example, does not contain stale references to dropped users).
-- If it does, the following exception will be raised:
--
-- ORA-44416: Invalid ACL: Unresolved principal 'APEX_030200'
-- ORA-06512: at "XDB.DBMS_XDBZ", line ...
--

SELECT SYS_OP_R2O(extractValue(P.RES, '/Resource/XMLRef')) INTO ACL_ID
FROM XDB.XDB$ACL A, PATH_VIEW P
WHERE extractValue(P.RES, '/Resource/XMLRef') = REF(A) AND
EQUALS_PATH(P.RES, ACL_PATH) = 1;

DBMS_XDBZ.ValidateACL(ACL_ID);
IF DBMS_NETWORK_ACL_ADMIN.CHECK_PRIVILEGE(ACL_PATH, 'APEX_030200',
'connect') IS NULL THEN
DBMS_NETWORK_ACL_ADMIN.ADD_PRIVILEGE(ACL_PATH,
'APEX_030200', TRUE, 'connect');
END IF;

EXCEPTION
-- When no ACL has been assigned to 'localhost'.
WHEN NO_DATA_FOUND THEN
DBMS_NETWORK_ACL_ADMIN.CREATE_ACL('local-access-users.xml',
'ACL that lets power users to connect to everywhere',
'APEX_030200', TRUE, 'connect');
DBMS_NETWORK_ACL_ADMIN.ASSIGN_ACL('local-access-users.xml','localhost');
END;
/
COMMIT;

無効なACLエラーのトラブルシューティング

前述のスクリプトを実行した後にORA-44416: 無効なACLのエラーが表示された場合は、次の問合せを使用して、無効なACLを特定します。

REM Show the dangling references to dropped users in the ACL that is assigned
REM to '*'.

SELECT ACL, PRINCIPAL
FROM DBA_NETWORK_ACLS NACL, XDS_ACE ACE
WHERE HOST = '*' AND LOWER_PORT IS NULL AND UPPER_PORT IS NULL AND
NACL.ACLID = ACE.ACLID AND
NOT EXISTS (SELECT NULL FROM ALL_USERS WHERE USERNAME = PRINCIPAL);

次に、次のコードを実行してACLを修正します。

DECLARE
ACL_ID   RAW(16);
CNT      NUMBER;
BEGIN
-- Look for the object ID of the ACL currently assigned to '*'
SELECT ACLID INTO ACL_ID FROM DBA_NETWORK_ACLS
WHERE HOST = '*' AND LOWER_PORT IS NULL AND UPPER_PORT IS NULL;

-- If just some users referenced in the ACL are invalid, remove just those
-- users in the ACL. Otherwise, drop the ACL completely.
SELECT COUNT(PRINCIPAL) INTO CNT FROM XDS_ACE
WHERE ACLID = ACL_ID AND
EXISTS (SELECT NULL FROM ALL_USERS WHERE USERNAME = PRINCIPAL);

IF (CNT > 0) THEN

FOR R IN (SELECT PRINCIPAL FROM XDS_ACE
WHERE ACLID = ACL_ID AND
NOT EXISTS (SELECT NULL FROM ALL_USERS
WHERE USERNAME = PRINCIPAL)) LOOP
UPDATE XDB.XDB$ACL
SET OBJECT_VALUE =
DELETEXML(OBJECT_VALUE,
'/ACL/ACE[PRINCIPAL="'||R.PRINCIPAL||'"]')
WHERE OBJECT_ID = ACL_ID;
END LOOP;

ELSE
DELETE FROM XDB.XDB$ACL WHERE OBJECT_ID = ACL_ID;
END IF;

END;
/

REM commit the changes.

COMMIT;

ACLを修正したら、このセクションにある最初のスクリプトを実行して、APEX_030200ユーザーにACLを適用する必要があります。詳細は、「ホストへの接続権限の付与」を参照してください。

Oracle Database 11gリリース2以上でのオンライン・ヘルプの索引付けの有効化

Oracle Application Expressオンライン・ヘルプを検索する機能がOracle TextおよびURLデータストアによって実現します。Oracle TextのURLデータストアをOracle Database 11gリリース2以上で使用する場合のデフォルトの動作と権限に変更があります。

Oracle Database 11gリリース2でOracle Application Expressオンライン・ヘルプを検索しようとすると次のエラーが表示される場合は、Oracle TextのURLデータストアを使用する権限がデータベース・ユーザーAPEX_030200に付与されていません。

ORA-29855: error occurred in the execution of ODCIINDEXCREATE routine
ORA-20000: Oracle Text error:
DRG-10758: index owner does not have the privilege to use file or URL data store

Oracle Application Expressでオンライン・ヘルプの索引付けを有効にするには、Oracle TextのURLデータストアを使用するための権限がAPEX_030200データベース・ユーザーに付与されている必要があります。それには、この権限をデータベース・ロールに割り当てた後、このロールをAPEX_030200データベース・ユーザーに付与します。

Oracle Text URLデータストアを使用するための権限がデータベース・ロールにすでに付与されているかどうかを判断するには、次のステップを実行します。

1. SQL*Plusを起動し、Oracle Application Expressがインストールされているデータベースに、SYSDBAロールが指定されているSYSとして接続します。次に例を示します。

- Windowsの場合:

SYSTEM_DRIVE:\ sqlplus /nolog
SQL> CONNECT SYS as SYSDBA
Enter password: SYS_password

- UNIXおよびLinuxの場合:

$ sqlplus /nolog
SQL> CONNECT SYS as SYSDBA
Enter password: SYS_password

2. 次のコマンドを実行します。

SELECT par_value FROM ctxsys.ctx_parameters WHERE par_name = 'FILE_ACCESS_ROLE';

これによって、NULLか、またはOracle Text URLデータストアを使用するための権限が付与されているデータベース・ロールが戻されます。

3. ステップ2で何も値が戻されない場合は、次の例に示すように新しいデータベース・ロールを作成します。

CREATE ROLE APEX_URL_DATASTORE_ROLE;

4. 次の文を使用して、このロールをデータベース・ユーザーAPEX_030200に付与します。

GRANT APEX_URL_DATASTORE_ROLE to APEX_030200;

ステップ2で値が戻された場合は、例のAPEX_URL_DATASTORE_ROLEのかわりに、このデータベース・ロール名を使用します。

5. 最後に、ステップ2で値が戻されなかった場合は、Oracle Text APIを使用して、次の文で新しく作成したデータベース・ロールに権限を付与します。

EXEC ctxsys.ctx_adm.set_parameter('file_access_role', 'APEX_URL_DATASTORE_ROLE');

セキュリティに関する開発者のベスト・プラクティスの理解

このセクションでは、Oracle Application Express開発者のためのセキュリティのベスト・プラクティスについて説明します。

この項に含まれる内容は次のとおりです。

- タイプ・パスワードのアイテムの理解

- 問題を引き起こす可能性のあるパスワード・アイテムの識別

- セッションIDでのゼロの使用について

- クロスサイト・スクリプティング保護の理解

- セッション・ステートおよびセキュリティについて

- セッション・ステート保護の理解

タイプ・パスワードのアイテムの理解

パスワード・アイテムは、Webブラウザ画面に入力されたテキストを表示しません。タイプ・パスワードのアイテムを作成するときは、セッション・ステートを保存しないパスワード・アイテム・タイプを使用することをお薦めします。これによって、パスワードがセッション・ステート表のデータベースに保存されるのを回避できます。

使用可能なパスワード・アイテム・タイプには、次のものがあります。

- パスワード - フィールドに入力されたテキストを非表示にします。ページの送信時に、セッション・ステートに値が保存されます。

- パスワード([Enter]を押すと送信) - フィールドに入力されたテキストを非表示にします。[Enter]を押すと、ページが送信されます。

- パスワード(状態は保存しない) - フィールドに入力されたテキストを非表示にします。セッション・ステートに値が保存されません。

- パスワード([Enter]を押すと送信し、状態は保存しない): フィールドに入力されたテキストを非表示にします。[Enter]を押すと、ページが送信されます。セッション・ステートに値が保存されません。

「パスワード」および「パスワード([Enter]を押すと送信)」では、ページの送信時にデータベース表にパスワードが保存されます。これらのパスワード・アイテム・タイプは、セッション中に他のページで使用するためにセッション・ステートのパスワードが必要になる場合にのみ使用します。

「パスワード(状態は保存しない)」および「パスワード([Enter]を押すと送信し、状態は保存しない)」では、データベース表にパスワードが保存されません。これらのパスワード・アイテム・タイプは、送信したパスワードの値が同じページでの送信後のページ・プロセスでのみ使用され、セッション中に要求されることがない場合にのみ使用します。

アプリケーションでパスワードの値を参照および取得する必要がある場合は、「セッション・ステートに暗号化された値を保存」属性を「はい」に設定します。詳細は、「セッション・ステートおよびセキュリティの概要」を参照してください。

関連項目:
「アイテム・タイプについて」

問題を引き起こす可能性のあるパスワード・アイテムの識別

問題を引き起こす可能性のあるパスワード・アイテムは、次のいずれかです。

- セッション・ステートを保存しないパスワード・アイテム・タイプを1つも使用しないもの

- 暗号化していない値をセッション・ステートに格納するもの

問題を引き起こす可能性のあるパスワード・アイテムを識別するには、「パスワード・アイテム」、「セキュリティ・プロファイル」および「パスワード・アイテム」レポートを使用します。

問題を引き起こす可能性のあるパスワード・アイテムのタイプを識別するレポートを表示するには、次のステップを実行します。

1. 「ワークスペース」ホームページにナビゲートします。

2. 「アプリケーション・ビルダー」アイコンをクリックします。

3. アプリケーションを選択します。
アプリケーションのホームページが表示されます。

4. 「タスク」リストで、「アプリケーション・レポート」をクリックします。

5. 次のステップを実行して、「パスワード・アイテム」レポートを表示します。

1. 「ページ・コンポーネント」を選択します。

2. 「アイテム」で、「パスワード・アイテム」をクリックします。
このレポートには、アプリケーション内にあるすべてのパスワード・アイテムが、暗号化を使用するかどうかおよびステートを保存するかどうかとともに表示されます。いずれも行わないパスワード・アイテムは、「問題を引き起こす可能性」とハイライトされます。

6. 次のステップを実行して、「セキュリティ・プロファイル」レポートを表示します。

1. 「アプリケーション間」を選択します。

2. 「アイテム」で、「パスワード・アイテム」をクリックします。

7. 次のステップを実行して、「パスワード・アイテム」レポートを表示します。

1. 「アプリケーション間」を選択します。

2. 「アイテム」で、「セキュリティ・プロファイル」をクリックします。
「問題を引き起こす可能性のあるパスワード・アイテム」列を確認します。

パスワード・アイテムを含むページで、ページ属性「フォームのオートコンプリート」を「オフ」に設定します。この属性を「オフ」に設定すると、Webブラウザによって、ページでアイテムのオートコンプリートが試行されなくなります。この属性の詳細は、表5-6を参照してください。

セッションIDでのゼロの使用について

Oracle Application Expressアプリケーション・ページにアクセスすると、セッションIDを含む多数のリンクがWebブラウザのロケーション・ウィンドウに表示されます。アプリケーションがパブリックにアクセス可能であり、電子メールやメッセージング・サービスなどを使用してユーザーが他のアプリケーション・ユーザーにいずれかのリンクを伝えた場合、受信者はそのリンクを使用して即座に元のユーザーのセッションを共有できるようになります。この場合、両方のユーザーがアプリケーションを使用すると、画面の動作が予測不可能で再現が困難なものになるため、いずれのユーザーにとっても負の影響となります。これを回避するため、ログイン認証の入力が不要なすべてのアプリケーションに対して、ゼロ・セッションID機能を使用することをお薦めします。詳細は、「セッションIDにゼロを使用したブックマークの容易化」を参照してください。

クロスサイト・スクリプティング保護の理解

クロスサイト・スクリプティング(XSS)は、動的に生成されるWebページを利用するセキュリティ攻撃です。XSS攻撃では、ユーザーのブラウザに読み込まれたときにアクティブになるスクリプトがWebアプリケーションに送信されます。これらのスクリプトがアクティブになると、データまたは場合によってはセッション資格証明が盗まれ、それらの情報が攻撃者に送信される可能性があります。

悪意のあるコードがOracle Application Expressアプリケーションに侵入すると、通常のページ・レンダリング時に、そのコードがアプリケーション内のHTMLリージョンや他の場所にレンダリングされる可能性があります。セッション・ステートへの不正なコードの挿入を阻止するため、Application Expressエンジンは特定の場合に文字をエスケープします。

この項に含まれる内容は次のとおりです。

- HTMLリージョンなどの静的領域の保護

- 動的出力の保護

- レポート・リージョンの保護

- フォーム・アイテムの保護

HTMLリージョンなどの静的領域の保護

HTMLリージョンなどの静的表示領域では、&ITEM.表記法を使用してセッション・ステートを参照できます。静的表示領域の例には、HTMLリージョン、ページのヘッダーとフッター、リージョンのヘッダーとフッター、リージョン・タイトル、ボタン・ラベル、ヘルプ・テキスト、フォーム・アイテム・ラベルおよび要素の後のテキスト、テンプレート、(フィールド・テキストの前後の)ラジオ・グループ、イベント成功メッセージ、イベント・エラー・メッセージ、ナビゲーション・バー属性、アプリケーション静的置換文字列値、チャート・ラベルおよび凡例、ブレッドクラムおよびリスト・フレーム・テキスト、カレンダ・テキスト、ラベル、凡例などがあります。

安全なアイテム表示タイプの概要

セッション・ステートがこのように参照される場合、ページに表示される値には、参照されるアイテムに次の安全なアイテム表示タイプのいずれかが含まれている場合にエスケープされる特殊文字(<、>、&、")が含まれません。

- テキストとして表示(状態は保存しない)

- テキストとして表示(特殊文字をエスケープし、状態は保存しない)

- テキストとして表示(LOVに基づき、状態は保存しない)

- テキストとして表示(PL/SQLに基づき、状態は保存しない)

- テキスト・フィールド(無効、状態を保存しない)

- HTML表の停止および開始(ラベルのみ表示)

参照されるアイテムに前述のタイプ以外の表示タイプが含まれている場合、ページに表示される値には、エスケープされる特殊文字が含まれます。また、アプリケーション・レベルのアイテムには、安全な表示タイプが含まれているとみなされますが、実際にフォーム・アイテムに含まれているような表示プロパティは含まれていません。

関連項目:
「ページ・レベル・アイテムの理解」

値をエスケープするかどうかを決定するために使用されるルールについて

Application Expressエンジンは、事前定義済のスマート・エスケープ・ルールを使用して、セッション・ステートからフェッチされた値をエスケープするかどうか、およびいつそれを実行するかを決定します。

このルールを使用するのは、前にリストした表示タイプを使用したアイテムは、通常フィルタ処理(エスケープ)されずにブラウザに表示されることを意図したHTMLを含むテキスト用であるためです。安全に行われる方法は、これらのタイプのアイテムが常にエスケープされてアプリケーションに入力されるルールを実施する以外にありません。たとえば、ユーザーが、Oracle Application Expressのf?p URL構文を使用して、一部のテキストを安全なアイテムに渡す場合、Application Expressエンジンは値をセッション・ステートに保存する際に特殊文字をエスケープします。これにより次の2つの結果が予想されます。

1. 値に特殊文字が含まれていなかった場合、渡された値は指定されたとおりにセッション・ステートに保存される。

2. 値に特殊文字が含まれていた場合、値をセッション・ステートに保存する際に特殊文字をエスケープする。

いずれの状況でも、アイテムは、現在、前述のHTMLリージョンなどの静的領域で&ITEM.表記法を使用して安全に参照できます。

安全なアイテム・タイプを使用したHTMLマークアップの保持および表示

前にリストした安全なアイテム・タイプを使用して、ブラウザにHTMLマークアップを保持および表示します。たとえば、安全なページ・アイテムP1_XXX(&P1_XXXを使用)を参照して、太字で一部のテキストをレンダリングする要件があるとします。アイテムP1_XXXには次のHTMLが含まれているとします。

<b>ABABABAB</b>

実行するには、アプリケーション・コントロール(計算、プロセス、アイテムのソース式、アイテムのデフォルト値など)を使用して、値をこれらの安全なアイテムに格納します。値をこのように挿入する場合は、コンテンツの安全性を確認します。これらの方法を使用する場合、Application Expressエンジンは、値をセッション・ステートに保存する際に特殊文字をエスケープしません。

安全なアイテムの安全性は、最終的に、アイテムがページにポストされず、ページ送信の一部としてApplication Expressエンジンに発行されないルールによって確認されます。

動的出力の保護

htp.pなどの方法を使用してセッション・ステートからフェッチし、レンダリングするアイテムは、必要に応じてコードで明示的にエスケープする必要があります。たとえば、ページ上のPL/SQL動的コンテンツ・リージョンで次のhtp.pを使用するとします。

htp.p(v(&rsquor;SOME_ITEM'));

セッション・ステートからフェッチするアイテムの値に予期しないタグやスクリプトが含まれる可能性がある場合は、リージョンで次のhtp.pを使用できます。

htp.p(htf.escape_sc(v(&rsquor;SOME_ITEM')));

ただし、フェッチする値を安全にレンダリングできることが確かな場合は、この値をエスケープする必要はありません。開発者は、出力をエスケープしない方が適切な場合を判断する必要があります。

次のように、このルールに従うことをお薦めします。

- アイテムが「安全なアイテム表示タイプについて」に示される安全なタイプのいずれかでないかぎり、エスケープせずにセッション・ステートからフェッチされたアイテムを表示しないでください。

これを行うのは、開発者としてハッカーが悪意ある値を安全ではないアイテムにポストするのを防ぐ方法はないためです。アプリケーションがこれらのアイテムを一般ユーザーに見えるように表示しなくても、このルールに従わないと、ハッカーはアプリケーションを使用してXSS攻撃をマウントできることに注意してください。

レポート・リージョンの保護

Application Expressエンジンは、レポートのボディでレンダリングされるデータをエスケープします。レポートのヘッダーおよびメッセージにおけるセッション・ステートへの参照は、安全なアイテム・タイプの値はエスケープされず、その他のアイテム・タイプの値はエスケープされるように、スマート・エスケープ・ルールを使用してセッション・ステートからフェッチされます。

フォーム・アイテムの保護

ブラウザに送信されるフォーム・ページの生成中に、フォーム・アイテム(隠しアイテムなど)が値を取得する場合、結果テキストはレンダリング前にエスケープされます。一部の安全なアイテム・タイプは、各表示タイプの意図する動作をサポートするため、このルールにおける例外となります。

セッション・ステートおよびセキュリティについて

Oracle Application Expressは、データベース表にセッション・ステートを保持します。セッション・ステートがデータベース表で保持されるのは、サーバー側にセッション・ステートを格納すると、クライアント側に格納する場合よりセキュアになるためです。Oracle Application ExpressアプリケーションはステートレスHTTPプロトコルを使用するため、複数のページ・ビューにわたるアプリケーションのセッション・ステートがデータベース表に保持されます。各Oracle Application Expressアプリケーション・ユーザーの同期データベース接続を保持しない場合は、メモリーおよびデータベース・リソースの要件が大幅に削減されます。

開発者は、アプリケーション・ビルダーおよび組込みの監視ページを使用して、Oracle Application Expressアプリケーションによって格納されたセッション・ステートを問い合せることができます。開発者および管理者は、認証されているワークスペースのアプリケーションにアクセスできます。

開発者のベスト・プラクティスには、次のものが含まれます。

- プログラムの制御フローの標準的な実装の一環として、クリア・キャッシュ・ページ・プロセスまたはページへのナビゲートに使用されるURLのクリア・キャッシュ・ディレクティブを使用して不要な値のセッション・ステートを消去します。

- ステートを保存しないパスワード・ページ・アイテム・タイプを使用します。これを使用すると、入力したパスワードがデータベースのセッション・ステート表に保存されません。

- セッションに機密データを保持する必要がある場合は、Oracle Application Expressのセッション・ステート表に暗号化した形式で保存する必要があります。この機能を使用するには、ページ・アイテムの「セッション・ステートに暗号化された値を保存」属性を「はい」に設定します。暗号化されて保存された値は、読取り時に自動的に複合化されます。

注意:
暗号化されたセッション・ステートの目的は、Oracle Application Expressのセッション・ステート表、デバッグ出力またはデータベース・データファイルへのアクセス権を持っている可能性のある他のOracle Application Express開発者やデータベース管理者に、暗号化された値が読み取られないようにするセッション・ステートを保持することです。データベースのバックアップを行う際は、バックアップ・ファイルでデータを暗号化する機能を使用することをお薦めします。

ヒント:
アイテム値は、最大で4000バイト長まで暗号化できます。4000バイトを超える値を暗号化しようとすると、エラー・メッセージが表示されます。

セッション・ステート保護の理解

セッション・ステート保護は、ハッカーがアプリケーション内のURLを改ざんするのを防ぐための組込み機能です。URL改ざんにより、プログラム・ロジック、セッション・ステートの内容および情報プライバシが悪影響を受ける可能性があります。

セッション・ステート保護は2ステップのプロセスで有効にします。最初に、この機能を有効にします。次に、ページおよびアイテムのセキュリティ属性を設定します。

この項に含まれる内容は次のとおりです。

- セッション・ステート保護の仕組み

- セッション・ステート保護の有効化

- セッション・ステート保護の構成

セッション・ステート保護の仕組み

セッション・ステート保護を有効にすると、「ページ・アクセス保護」属性と「セッション・ステート保護」項目属性が、f?p= URL内に配置されたチェックサムとともに使用され、URL改ざんと、セッション・ステートに対する権限のないアクセスおよび変更が防止されます。セッション・ステート保護を無効にすると、セッション・ステート保護に関連するページ属性および項目属性が無視され、生成されるf?p= URLにはチェックサムが含まれません。

セッション・ステート保護の有効化

セッション・ステート保護は、セキュリティ属性の編集ページまたはセッション・ステート保護ページから有効にできます。

セッション・ステート保護は2ステップのプロセスで有効にします。最初に、この機能を有効にします。次に、ページおよびアイテムのセキュリティ属性を設定します。これらのステップは、ウィザードを使用して実行するか、セッション・ステート保護ページでページおよびアイテムのセキュリティ属性を手動で設定して行います。

この項に含まれる内容は次のとおりです。

- 「セキュリティ属性の編集」からのセッション・ステート保護の有効化

- 「セッション・ステート保護」からのセッション・ステート保護の有効化

「セキュリティ属性の編集」からのセッション・ステート保護の有効化

セキュリティ属性の編集ページからセッション・ステート保護を有効にするには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」アイコンをクリックします。

4. 「セキュリティ」で、「セキュリティ属性の編集」をクリックします。

5. 「セッション・ステート保護」までスクロールして、「セッション・ステート保護」リストの「有効」を選択します。

6. セッション・ステート保護を構成するには、「セッション・ステート保護の管理」をクリックします。
セッション・ステート保護ページが表示されます。

7. セキュリティ属性の編集ページにナビゲートして、ページおよびアイテムのセキュリティ属性を設定します。

ヒント:
セッション・ステート保護を無効にするには、同じステップを再度実行しますが、「有効」のかわりに「無効」を選択します。セッション・ステート保護を無効にしても、既存のセキュリティ属性の設定は変更されませんが、実行時にはそれらが無視されます。

「ブックマークの無効化」ボタン

セッション・ステート保護を有効にすると、カレント・アプリケーションへのブックマーク・リンクが機能するかどうかに影響します。次の規則を考慮してください。

1. セッション・ステート保護を有効にした後に作成したブックマーク・リンクは、ブックマーク・リンクにチェックサムが含まれている場合に機能します。

2. セッション・ステート保護を有効にする前に作成したブックマーク・リンクは、ブックマーク・リンクにチェックサムが含まれている場合は機能しません。

3. チェックサムが含まれていないか、または不要なチェックサムが含まれているブックマークは、セッション・ステート保護の影響を受けません。

ページ・レンダリング時、Application Expressエンジンは、計算中に非表示のアプリケーション属性(チェックサムsalt)を使用し、f?p URLに含まれているチェックサムを確認します。セッション・ステート保護を有効にすると、Application Expressエンジンにチェックサムが含まれます。チェックサムsalt属性を再設定するには、セキュリティ属性の編集ページで「ブックマークの無効化」をクリックします。「ブックマークの無効化」をクリックすると、以前に生成されたチェックサムを含むアプリケーションへのアクセスに使用するブックマークURLが失敗することに注意してください。

「セッション・ステート保護」からのセッション・ステート保護の有効化

セッション・ステート保護を有効にするには、次のステップを実行します。

1. 共有コンポーネント・ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「セキュリティ」で、「セッション・ステート保護」を選択します。

セッション・ステート保護ページが表示されます。セッション・ステート保護の現行のステータス(有効または無効)がページ上部に表示されることに注意してください。

2. 「保護の設定」ボタンをクリックします。
「セッション・ステート保護」ウィザードが表示されます。

3. 「操作の選択」で、「有効化」を選択して、「次へ」をクリックします。
次に、ページおよびアイテムのセキュリティ属性を設定するかどうか決定します。

4. 「有効化」を選択して、「次へ」をクリックします。

5. 「セッション・ステート保護の有効化」をクリックします。

ヒント:
セッション・ステート保護を無効にするには、同じステップを実行しますが、「有効化」のかわりに「無効化」を選択します。セッション・ステート保護を無効にしても、既存のセキュリティ属性の設定は変更されませんが、実行時にはそれらが無視されます。

セッション・ステート保護の構成

セッション・ステート保護を有効にした後、セキュリティ属性を構成します。セキュリティ属性は2つの方法で構成できます。

- ウィザードを使用し、特定の属性カテゴリの値を選択する。この場合、選択内容がアプリケーション内のすべてのページおよびアイテムに適用されます。

- 個々のページ、アイテムまたはアプリケーション・アイテムの値を構成する。

この項に含まれる内容は次のとおりです。

- 既存のセッション・ステート保護設定の確認

- ウィザードを使用したセッション・ステート保護の構成

- ページのセッション・ステート保護の構成

- アイテムのセッション・ステート保護の構成

- アプリケーション・アイテムのセッション・ステート保護の構成

ヒント:
セキュリティ属性を構成する前に、まずセッション・ステート保護を有効にする必要があります。「セッション・ステート保護の有効化」を参照してください。

既存のセッション・ステート保護設定の確認

「セッション・ステート保護」ウィザードの最初のページでは、ページ、アイテムおよびアプリケーション・アイテムのセッション・ステート保護設定のサマリーを確認できます。

既存のセッション・ステート保護設定のサマリーを表示するには、次のステップを実行します。

1. 「セッション・ステート保護」ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「セキュリティ」で、「セッション・ステート保護」を選択します。
セッション・ステート保護ページが表示されます。

2. 「保護の設定」をクリックします。

3. ページ下部で次のレポートを開きます。

- ページ・レベルのセッション・ステート保護サマリー

- ページ・アイテムのセッション・ステート保護サマリー

- アプリケーション・アイテムのセッション・ステート保護

ウィザードを使用したセッション・ステート保護の構成

ウィザードを使用してセッション・ステート保護を構成するときは、特定の属性カテゴリの値を設定します。この場合、選択内容がアプリケーション内のすべてのページおよびアイテムに適用されます。

ウィザードを使用してセッション・ステート保護を構成するには、次のステップを実行します。

1. 「セッション・ステート保護」ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「セキュリティ」で、「セッション・ステート保護」を選択します。
セッション・ステート保護ページが表示されます。

2. 「保護の設定」をクリックします。
「セッション・ステート保護」ウィザードが表示されます。

3. 「操作の選択」で、「構成」を選択して、「次へ」をクリックします。

4. 「ページ・アクセス保護」で、次のいずれかを選択します。

- 制限なし: セッション・ステート引数(Request、Clear Cache、Name/Values)の有無にかかわらず、URLを使用してページを要求できます。

- 引数にチェックサムが必要: URLにRequest、Clear CacheまたはName/Value引数が表示されている場合は、チェックサムも提供する必要があります。チェックサム・タイプは、引数として渡されるすべてのアイテムの最も厳密なセッション・ステート保護属性と互換性がある必要があります。

- 引数使用不可: URLを使用してページを要求できますが、Request、Clear CacheまたはName/Value引数は許可されません。

- URLアクセスなし: URLを使用してページにアクセスできませんが、ページは、URLリダイレクトを行わない「ページにブランチ」ブランチ・タイプのターゲットにできます。

5. 「アプリケーション・アイテム保護」で、次のいずれかの項目を選択します。

- 制限なし: URLまたはフォームでアイテム名/値を渡して、アイテムのセッション・ステートを設定できます。URLにチェックサムは必要ありません。

- チェックサムが必要 - アプリケーション・レベル: スキーマ固有のチェックサムを入力する場合は、URLでアイテムの名前/値を渡して、アイテムのセッション・ステートを設定できます。ユーザー・レベル・チェックサムまたはセッション・レベル・チェックサムも使用できます(次の項目を参照)。現行のワークスペースの別のセッションで同じアプリケーションを実行しているユーザーが生成したチェックサムを含むURLによってのみ、このアイテムを設定できるようにする場合に、このオプションを使用します。

- チェックサムが必要: ユーザー・レベル: ワークスペース、アプリケーションおよびユーザー固有のチェックサムを入力する場合は、URLでアイテムの名前/値を渡して、アイテムのセッション・ステートを設定できます。セッション・レベル・チェックサムも使用できます(次の項目を参照)。現行のワークスペースの別のセッションで同じアプリケーションを実行しているユーザーが生成したチェックサムを含むURLによってのみ、このアイテムを設定できるようにする場合に、このオプションを使用します。

- チェックサムが必要: セッション・レベル: カレント・セッション固有のチェックサムも入力する場合は、URLでアイテムの名前/値を渡して、アイテムのセッション・ステートを設定できます。カレント・セッションで生成されたチェックサムを含むURLによってのみ、このアイテムを設定できるようにする場合に、このオプションを使用します。

- 制限付き - ブラウザから設定できない: URLまたはPOSTDATAを使用してアイテムを変更できません。アイテムの値を内部プロセス、計算などに設定できる方法を制限する場合は、このオプションを使用します。この属性は、データ・エントリ・アイテムとして使用できないアイテムのみに適用され、セッション・ステート保護が無効になっていても常に監視されます。
次の表示形式タイプのアプリケーション・アイテムまたはページ・アイテムについては、この属性を使用します。

- テキストとして表示(特殊文字をエスケープし、状態は保存しない)

- テキストとして表示(状態は保存しない)

- テキストとして表示(LOVに基づき、状態は保存しない)

- テキストとして表示(PL/SQLに基づき、状態は保存しない)

- テキスト・フィールド(無効、状態を保存しない)

- HTML表の停止および開始(ラベルのみ表示)

6. 「ページのデータ・エントリ・アイテム保護」で、次のいずれかの項目を選択します。

- 制限なし: URLまたはフォームでアイテム名/値を渡して、アイテムのセッション・ステートを設定できます。URLにチェックサムは必要ありません。

- チェックサムが必要 - アプリケーション・レベル: スキーマ固有のチェックサムを入力する場合は、URLでアイテムの名前/値を渡して、アイテムのセッション・ステートを設定できます。ユーザー・レベル・チェックサムまたはセッション・レベル・チェックサムも使用できます(次の項目を参照)。現行のワークスペースの別のセッションで同じアプリケーションを実行しているユーザーが生成したチェックサムを含むURLによってのみ、このアイテムを設定できるようにする場合に、このオプションを使用します。

- チェックサムが必要: ユーザー・レベル: ワークスペース、アプリケーションおよびユーザー固有のチェックサムを入力する場合は、URLでアイテムの名前/値を渡して、アイテムのセッション・ステートを設定できます。セッション・レベル・チェックサムも使用できます(次の項目を参照)。現行のワークスペースの別のセッションで同じアプリケーションを実行しているユーザーが生成したチェックサムを含むURLによってのみ、このアイテムを設定できるようにする場合に、このオプションを使用します。

- チェックサムが必要: セッション・レベル: カレント・セッション固有のチェックサムを入力する場合は、URLでアイテムの名前/値を渡して、アイテムのセッション・ステートを設定できます。カレント・セッションで生成されたチェックサムを含むURLによってのみ、このアイテムを設定できるようにする場合に、このオプションを使用します。

7. 「ページの表示専用アイテム保護」で、次のいずれかの項目を選択します。

- 制限なし: URLまたはフォームでアイテムの名前/値を渡して、アイテムを設定できます。URLにチェックサムは必要ありません。

- チェックサムが必要 - アプリケーション・レベル: スキーマ固有のチェックサムを入力する場合は、URLでアイテムの名前/値を渡して、アイテムのセッション・ステートを設定できます。ユーザー・レベル・チェックサムまたはセッション・レベル・チェックサムも使用できます(次の項目を参照)。現行のワークスペースの別のセッションで同じアプリケーションを実行しているユーザーが生成したチェックサムを含むURLによってのみ、このアイテムを設定できるようにする場合に、このオプションを使用します。

- チェックサムが必要: セッション・レベル: カレント・セッション固有のチェックサムを入力する場合は、URLでアイテムの名前/値を渡して、アイテムのセッション・ステートを設定できます。カレント・セッションで生成されたチェックサムを含むURLによってのみ、このアイテムを設定できるようにする場合に、このオプションを使用します。

- チェックサムが必要: ユーザー・レベル: ワークスペース、アプリケーションおよびユーザー固有のチェックサムを入力する場合は、URLでアイテムの名前/値を渡して、アイテムのセッション・ステートを設定できます。セッション・レベル・チェックサムも使用できます(次の項目を参照)。現行のワークスペースの別のセッションで同じアプリケーションを実行しているユーザーが生成したチェックサムを含むURLによってのみ、このアイテムを設定できるようにする場合に、このオプションを使用します。

- 制限付き - ブラウザから設定できない: URLまたはPOSTDATAを使用してアイテムを変更できません。アイテムの値を内部プロセス、計算などに設定できる方法を制限する場合は、このオプションを使用します。この属性は、セッション・ステート保護が無効になっていても、常に監視されます。
次の表示形式タイプについては、この属性を使用します。

- テキストとして表示(特殊文字をエスケープし、状態は保存しない)

- テキストとして表示(状態は保存しない)

- テキストとして表示(LOVに基づき、状態は保存しない)

- テキストとして表示(PL/SQLに基づき、状態は保存しない)

- テキスト・フィールド(無効、状態を保存しない)

- HTML表の停止および開始(ラベルのみ表示)

8. 「次へ」をクリックします。

9. 「終了」をクリックします。

ページのセッション・ステート保護の構成

ページのセッション・ステート保護を構成するには、次のステップを実行します。

1. 「セッション・ステート保護」ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「セキュリティ」で、「セッション・ステート保護」を選択します。
セッション・ステート保護ページが表示されます。

2. 「ページ」アイコンをクリックします。

3. ビューにフィルタを適用するには、ページ上部の「ページ」、「表示」および「ページ・アクセス保護」リストを使用します。

4. ページ番号を選択します。
「ページおよびアイテム保護の設定」ページが表示されます。次の情報がページの上部に表示されます。

- アプリケーションIDおよび名前

- セッション・ステート保護のステータス(有効または無効)

- ページ番号

- ページ名

5. 「ページ・アクセス保護」で、次のいずれかを選択します。

- 制限なし: セッション・ステート引数(Request、Clear Cache、Name/Values)の有無にかかわらず、URLを使用してページを要求できます。

- 引数にチェックサムが必要: URLにRequest、Clear CacheまたはName/Value引数が表示されている場合は、チェックサムも提供する必要があります。チェックサム・タイプは、引数として渡されるすべてのアイテムの最も厳密なセッション・ステート保護属性と互換性がある必要があります。

- 引数使用不可: URLを使用してページを要求できますが、Request、Clear CacheまたはName/Value引数は許可されません。

- URLアクセスなし: URLを使用してページにアクセスできませんが、ページは、URLリダイレクトを行わない「ページにブランチ」ブランチ・タイプのターゲットにできます。

6. 「アイテム・タイプ」で、「データ・エントリ・アイテム」または「表示専用アイテム」を選択します。
データ・エントリ・アイテムは、フォームを使用して変更できるアイテムであり、非表示アイテムもこれに含まれます。表示専用アイテムはレンダリングされるだけで、フォームとともに送信されません。

7. 「データ・エントリ・アイテム」を選択した場合は、各アイテムのセッション・ステート保護レベルを選択します。

- 制限なし: URLまたはフォームでアイテム名/値を渡して、アイテムのセッション・ステートを設定できます。URLにチェックサムは必要ありません。

- チェックサムが必要 - アプリケーション・レベル: スキーマ固有のチェックサムを入力する場合は、URLでアイテムの名前/値を渡して、アイテムのセッション・ステートを設定できます。ユーザー・レベル・チェックサムまたはセッション・レベル・チェックサムも使用できます(次の項目を参照)。現行のワークスペースの別のセッションで同じアプリケーションを実行しているユーザーが生成したチェックサムを含むURLによってのみ、このアイテムを設定できるようにする場合に、このオプションを使用します。

- チェックサムが必要: ユーザー・レベル: ワークスペース、アプリケーションおよびユーザー固有のチェックサムを入力する場合は、URLでアイテムの名前/値を渡して、アイテムのセッション・ステートを設定できます。セッション・レベル・チェックサムも使用できます(次の項目を参照)。現行のワークスペースの別のセッションで同じアプリケーションを実行しているユーザーが生成したチェックサムを含むURLによってのみ、このアイテムを設定できるようにする場合に、このオプションを使用します。

- チェックサムが必要: セッション・レベル: カレント・セッション固有のチェックサムを入力する場合は、URLでアイテムの名前/値を渡して、アイテムのセッション・ステートを設定できます。カレント・セッションで生成されたチェックサムを含むURLによってのみ、このアイテムを設定できるようにする場合に、このオプションを使用します。

8. 「表示専用アイテム」を選択した場合は、各アイテムのセッション・ステート保護レベルを選択します。

- 制限なし: URLまたはフォームでアイテムの名前/値を渡して、アイテムを設定できます。URLにチェックサムは必要ありません。

- 制限付き - ブラウザから設定できない: URLまたはPOSTDATAを使用してアイテムを変更できません。アイテムの値を内部プロセス、計算などに設定できる方法を制限する場合は、このオプションを使用します。この属性は、セッション・ステート保護が無効になっていても、常に監視されます。次の表示形式タイプについては、この属性を使用します。

- テキストとして表示(特殊文字をエスケープし、状態は保存しない)

- テキストとして表示(状態は保存しない)

- テキストとして表示(LOVに基づき、状態は保存しない)

- テキストとして表示(PL/SQLに基づき、状態は保存しない)

- テキスト・フィールド(無効、状態を保存しない)

- HTML表の停止および開始(ラベルのみ表示)

- チェックサムが必要 - アプリケーション・レベル: スキーマ固有のチェックサムを入力する場合は、URLでアイテムの名前/値を渡して、アイテムのセッション・ステートを設定できます。ユーザー・レベル・チェックサムまたはセッション・レベル・チェックサムも使用できます(次の項目を参照)。現行のワークスペースの別のセッションで同じアプリケーションを実行しているユーザーが生成したチェックサムを含むURLによってのみ、このアイテムを設定できるようにする場合に、このオプションを使用します。

- チェックサムが必要: ユーザー・レベル: ワークスペース、アプリケーションおよびユーザー固有のチェックサムを入力する場合は、URLでアイテムの名前/値を渡して、アイテムのセッション・ステートを設定できます。セッション・レベル・チェックサムも使用できます(次の項目を参照)。現行のワークスペースの別のセッションで同じアプリケーションを実行しているユーザーが生成したチェックサムを含むURLによってのみ、このアイテムを設定できるようにする場合に、このオプションを使用します。

- チェックサムが必要: セッション・レベル: カレント・セッション固有のチェックサムを入力する場合は、URLでアイテムの名前/値を渡して、アイテムのセッション・ステートを設定できます。カレント・セッションで生成されたチェックサムを含むURLによってのみ、このアイテムを設定できるようにする場合に、このオプションを使用します。

9. 「変更の適用」をクリックします。

アイテムのセッション・ステート保護の構成

アイテムのセッション・ステート保護を構成するには、次のステップを実行します。

1. 「セッション・ステート保護」ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「セキュリティ」で、「セッション・ステート保護」を選択します。
セッション・ステート保護ページが表示されます。

2. 「アイテム」アイコンをクリックします。

3. ビューにフィルタを適用するには、ページ上部の「ページ」、「表示」および「アイテムのセッション・ステート保護」リストから項目を選択して、「実行」をクリックします。

4. ページ番号を選択します。
ページおよびアイテムのセッション・ステート保護の編集ページが表示されます。次の情報がページの上部に表示されます。

- アプリケーションIDおよび名前

- セッション・ステート保護のステータス(有効または無効)

- ページ番号

- ページ名

5. 「ページ・アクセス保護」で、各アイテムのセッション・ステート保護レベルを選択します。

- 制限なし: セッション・ステート引数(Request、Clear Cache、Name/Values)の有無にかかわらず、URLを使用してページを要求できます。

- 引数にチェックサムが必要: URLにRequest、Clear CacheまたはName/Value引数が表示されている場合は、チェックサムも提供する必要があります。チェックサム・タイプは、引数として渡されるすべてのアイテムの最も厳密なセッション・ステート保護属性と互換性がある必要があります。

- 引数使用不可: URLを使用してページを要求できますが、Request、Clear CacheまたはName/Value引数は許可されません。

- URLアクセスなし: URLを使用してページにアクセスできませんが、ページは、URLリダイレクトを行わない「ページにブランチ」ブランチ・タイプのターゲットにできます。

6. 「アイテム・タイプ」で、「データ・エントリ・アイテム」または「表示専用アイテム」を選択します。
データ・エントリ・アイテムは、フォームを使用して変更できるアイテムであり、非表示アイテムもこれに含まれます。表示専用アイテムはレンダリングされるだけで、フォームとともに送信されません。

7. 「データ・エントリ・アイテム」を選択した場合は、各アイテムのセッション・ステート保護レベルを選択します。

- 制限なし: URLまたはフォームでアイテム名/値を渡して、アイテムのセッション・ステートを設定できます。URLにチェックサムは必要ありません。

- チェックサムが必要 - アプリケーション・レベル: スキーマ固有のチェックサムを入力する場合は、URLでアイテムの名前/値を渡して、アイテムのセッション・ステートを設定できます。ユーザー・レベル・チェックサムまたはセッション・レベル・チェックサムも使用できます(次の項目を参照)。現行のワークスペースの別のセッションで同じアプリケーションを実行しているユーザーが生成したチェックサムを含むURLによってのみ、このアイテムを設定できるようにする場合に、このオプションを使用します。

- チェックサムが必要: ユーザー・レベル: ワークスペース、アプリケーションおよびユーザー固有のチェックサムを入力する場合は、URLでアイテムの名前/値を渡して、アイテムのセッション・ステートを設定できます。セッション・レベル・チェックサムも使用できます(次の項目を参照)。現行のワークスペースの別のセッションで同じアプリケーションを実行しているユーザーが生成したチェックサムを含むURLによってのみ、このアイテムを設定できるようにする場合に、このオプションを使用します。

- チェックサムが必要: セッション・レベル: カレント・セッション固有のチェックサムを入力する場合は、URLでアイテムの名前/値を渡して、アイテムのセッション・ステートを設定できます。カレント・セッションで生成されたチェックサムを含むURLによってのみ、このアイテムを設定できるようにする場合に、このオプションを使用します。

8. 「表示専用アイテム」を選択した場合は、各アイテムのセッション・ステート保護レベルを選択します。

- 制限なし: URLまたはフォームでアイテムの名前/値を渡して、アイテムを設定できます。URLにチェックサムは必要ありません。

- 制限付き - ブラウザから設定できない: URLまたはPOSTDATAを使用してアイテムを変更できません。アイテムの値を内部プロセス、計算などに設定できる方法を制限する場合は、このオプションを使用します。この属性は、セッション・ステート保護が無効になっていても、常に監視されます。次の表示形式タイプについては、この属性を使用します。

- テキストとして表示(特殊文字をエスケープし、状態は保存しない)

- テキストとして表示(状態は保存しない)

- テキストとして表示(LOVに基づき、状態は保存しない)

- テキストとして表示(PL/SQLに基づき、状態は保存しない)

- テキスト・フィールド(無効、状態を保存しない)

- HTML表の停止および開始(ラベルのみ表示)

- チェックサムが必要 - アプリケーション・レベル: スキーマ固有のチェックサムを入力する場合は、URLでアイテムの名前/値を渡して、アイテムのセッション・ステートを設定できます。ユーザー・レベル・チェックサムまたはセッション・レベル・チェックサムも使用できます(次の項目を参照)。現行のワークスペースの別のセッションで同じアプリケーションを実行しているユーザーが生成したチェックサムを含むURLによってのみ、このアイテムを設定できるようにする場合に、このオプションを使用します。

- チェックサムが必要: ユーザー・レベル: ワークスペース、アプリケーションおよびユーザー固有のチェックサムを入力する場合は、URLでアイテムの名前/値を渡して、アイテムのセッション・ステートを設定できます。セッション・レベル・チェックサムも使用できます(次の項目を参照)。現行のワークスペースの別のセッションで同じアプリケーションを実行しているユーザーが生成したチェックサムを含むURLによってのみ、このアイテムを設定できるようにする場合に、このオプションを使用します。

- チェックサムが必要: セッション・レベル: カレント・セッション固有のチェックサムを入力する場合は、URLでアイテムの名前/値を渡して、アイテムのセッション・ステートを設定できます。カレント・セッションで生成されたチェックサムを含むURLによってのみ、このアイテムを設定できるようにする場合に、このオプションを使用します。

9. 「変更の適用」をクリックします。

アプリケーション・アイテムのセッション・ステート保護の構成

アプリケーション・アイテムのセッション・ステート保護を構成するには、次のステップを実行します。

1. 「セッション・ステート保護」ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「セキュリティ」で、「セッション・ステート保護」を選択します。
セッション・ステート保護ページが表示されます。

2. 「アプリケーション・アイテム」アイコンをクリックします。

3. アプリケーション・アイテムを選択します。

4. 「セキュリティ」で、「セッション・ステート保護」リストから次のいずれかを選択します。

- 制限なし: URLまたはフォームでアイテム名/値を渡して、アイテムのセッション・ステートを設定できます。URLにチェックサムは必要ありません。

- 制限付き - ブラウザから設定できない: URLまたはPOSTDATAを使用してアイテムを変更できません。アイテムの値を内部プロセス、計算などに設定できる方法を制限する場合は、このオプションを使用します。この属性は、データ・エントリ・アイテムとして使用できないアイテムのみに適用され、セッション・ステート保護が無効になっていても常に監視されます。次の表示形式タイプのアプリケーション・アイテムについては、この属性を使用します。

- テキストとして表示(特殊文字をエスケープし、状態は保存しない)

- テキストとして表示(状態は保存しない)

- テキストとして表示(LOVに基づき、状態は保存しない)

- テキストとして表示(PL/SQLに基づき、状態は保存しない)

- テキスト・フィールド(無効、状態を保存しない)

- HTML表の停止および開始(ラベルのみ表示)

- チェックサムが必要 - アプリケーション・レベル: スキーマ固有のチェックサムを入力する場合は、URLでアイテムの名前/値を渡して、アイテムのセッション・ステートを設定できます。ユーザー・レベル・チェックサムまたはセッション・レベル・チェックサムも使用できます(次の項目を参照)。現行のワークスペースの別のセッションで同じアプリケーションを実行しているユーザーが生成したチェックサムを含むURLによってのみ、このアイテムを設定できるようにする場合に、このオプションを使用します。

- チェックサムが必要: ユーザー・レベル: ワークスペース、アプリケーションおよびユーザー固有のチェックサムを入力する場合は、URLでアイテムの名前/値を渡して、アイテムのセッション・ステートを設定できます。セッション・レベル・チェックサムも使用できます(次の項目を参照)。現行のワークスペースの別のセッションで同じアプリケーションを実行しているユーザーが生成したチェックサムを含むURLによってのみ、このアイテムを設定できるようにする場合に、このオプションを使用します。

- チェックサムが必要: セッション・レベル: カレント・セッション固有のチェックサムを入力する場合は、URLでアイテムの名前/値を渡して、アイテムのセッション・ステートを設定できます。カレント・セッションで生成されたチェックサムを含むURLによってのみ、このアイテムを設定できるようにする場合に、このオプションを使用します。

5. 「変更の適用」をクリックします。

ファイルのアップロードの保護

Oracle Application Expressを使用すると、ファイルをアップロードし、アップロードしたファイルにアクセスできるアプリケーションを簡単に作成できます。これらのファイルは、共通のファイル記憶域表にアップロードされます。データベース・ビューAPEX_APPLICATION_FILESでは、データベース・アカウント(またはワークスペース)に関連付けられたファイルが表示されますが、共通のファイル記憶域表へのプログラムを介したアクセスでは、認証が不要な場合もあり、アップロードされたファイルを他のユーザーが参照できます。このため、開発者は、「フォームおよびレポートでのBLOBサポートについて」に記載された方法か、次に示すOTNのファイル・アップロードに関するOracle Application ExpressのHow Toドキュメントに記載された方法を使用することをお薦めします。

http://www.oracle.com/technetwork/developer-tools/apex/overview/index.html

いずれの方法の場合も、アップロードされたファイルは、パブリック表ではなく、スキーマ表に格納されます。

関連項目:
ファイル参照ページ・レベル・アイテムの作成の詳細は、「ページ・アイテムとアプリケーション・アイテムの違い」および「アイテム・タイプについて」を参照してください。

認証によるユーザー・アイデンティティの証明

認証は、ユーザーがアプリケーションにアクセスする前に、そのユーザーの本人確認を行うプロセスです。認証では、ユーザーにユーザー名とパスワードの指定を要求するか、またはデジタル証明書や保護キーを使用する可能性があります。

認証スキームを作成する場合、多くの事前構成済の認証スキームから選択するか、既存のアプリケーションから認証スキームをコピーするか、または独自のカスタム認証スキームを作成できます。

この項に含まれる内容は次のとおりです。

- 認証の仕組みの理解

- 認証を含めるかどうかの決定

- 認証スキームの作成

- 事前構成済の認証スキームの使用

- 認証スキームを最初から作成する方法について

- 既存の認証スキームの管理

- アプリケーションに関連付けられた認証スキームの表示

- アプリケーションに関連付けられた認証スキームの変更

- 認証スキームの使用状況レポートの表示

認証の仕組みの理解

アプリケーションがユーザーとどのように対話するかを決定します。すべてのユーザーが同じ権限を持つ場合、そのユーザーはパブリック・ユーザーとみなされます。ただし、アプリケーションが各ユーザーを個別に追跡する必要がある場合は、認証方式を指定する必要があります。

認証は、アプリケーションにアクセスする各ユーザーのアイデンティティの証明を行います。多くの認証プロセスで、ユーザーはなんらかの資格証明(ユーザー名とパスワードなど)を提供する必要があります。これらの資格証明は評価され、合格または不合格のいずれかとなります。資格証明が合格した場合、ユーザーはアプリケーションにアクセスできます。不合格の場合は、アクセスが拒否されます。

ユーザーの本人確認が行われると、Application Expressエンジンが組込み置換文字列APP_USERの値を設定して、各ユーザーを追跡します。ユーザーがページ間をナビゲートすると、Application ExpressエンジンがAPP_USERの値を設定して、本人確認を行います。Application Expressエンジンは、各ユーザーのセッション・ステートを追跡するための重要なコンポーネントとしてAPP_USERを使用します。

プログラミングの観点では、次の構文を使用してAPP_USERにアクセスできます。

- PL/SQLを使用する場合

V('APP_USER')

- PL/SQLまたはSQLのいずれかのバインド変数として使用する場合

:APP_USER

APP_USERを使用すると、独自のセキュリティ・チェックおよび条件付き処理を実行できます。たとえば、次の表を作成したと想定します。

CREATE TABLE my_security_table (
user_id   VARCHAR2(30),
privilege VARCHAR2(30));

表を作成したら、この表にユーザー権限情報を移入して、ページ、タブ、ナビゲーション・バー、ボタン、リージョン、または、その他のコントロールやコンポーネントの表示の制御に使用できます。

関連項目:
「APP_USER」および「セキュリティ属性の構成」

認証を含めるかどうかの決定

アプリケーションを作成する場合、認証を含めるかどうかを決定する必要があります。次の選択肢があります。

- 認証不要の選択。Oracle Application Expressはすべてのユーザーの資格証明をチェックしません。アプリケーションのすべてのページには、すべてのユーザーからアクセスできます。

- 組込み認証スキームの選択。使用可能な事前構成済の認証スキームに基づいて、認証方式を作成します。選択するスキームによっては、Oracle 10giAS、Oracle Internet Directoryまたは他の外部サービスの対応するコンポーネントを構成する必要もあります。詳細は、「事前構成済の認証スキームの使用」および「アプリケーションに関連付けられた認証スキームの変更」を参照してください。

- カスタム認証スキームの作成。カスタム認証方式を作成すると、認証インタフェースを完全に制御できます。この方法を実装するには、Application Expressエンジンが各ページ・リクエストを処理する前に実行するPL/SQLファンクションを提供する必要があります。このファンクションのブール戻り値によって、Application Expressエンジンが通常どおりにページを処理するか、または失敗ページを表示するかが決まります。「認可スキームの作成」を参照してください。

認証スキームの作成

認証スキームを作成するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。
共有コンポーネント・ページが表示されます。

4. 「セキュリティ」で、「認証スキーム」を選択します。
認証スキーム・ページが表示されます。

5. 新しい認証スキームを作成するには、「作成」をクリックします。

6. 次のいずれかの項目を選択して、スキームの作成方法を指定します。

- 事前構成済のスキームに基づいて。「既存の認証スキームの管理」を参照してください。

- 既存の認証スキームのコピーとして

- 最初から

7. 画面に表示されるステップに従います。

関連項目:
「事前構成済の認証スキームの使用」および「認証スキームを最初から作成する方法について」

事前構成済の認証スキームの使用

事前構成済の認証スキームを選択すると、Oracle Application Expressによって、標準動作の認証およびセッション管理を行う認証スキームがアプリケーションに作成されます。

この項に含まれる内容は次のとおりです。

- 公開資格証明

- Oracle Application Expressのアカウント資格証明

- データベース・アカウント資格証明

- LDAP資格証明の検証

- DAD資格証明の検証

- シングル・サインオン・サーバーの検証

公開資格証明

公開資格証明を使用すると、ユーザー名を取得する組込みログイン・ページを使用して、自分のアプリケーションがすべてのユーザーからアクセス可能になります。この認証方式は、アプリケーションの開発時に有用です。

公開資格証明の設定

公開資格証明を設定するには、次の手順を実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。
共有コンポーネント・ページが表示されます。

4. 「セキュリティ」で、「認証スキーム」を選択します。

5. 認証スキーム・ページで、「作成」をクリックします。

6. 「ギャラリからの事前構成済スキームに基づく」を選択します。

7. 「ギャラリ」で、「ログイン・ページの表示およびOpen Doorアカウント資格証明の使用」を選択します。

8. ログイン・ページを指定し、「次へ」をクリックします。

9. 名前を入力して、「スキームの作成」をクリックします。

Oracle Application Expressのアカウント資格証明

Oracle Application Expressのアカウント資格証明は、Oracle Application Expressのユーザー・リポジトリで作成および管理される内部のユーザー・アカウント(Cookieユーザー・アカウントともいう)です。この方式を使用すると、これらのアカウントに対してアプリケーションが認証されます。

関連項目:
『Oracle Application Express管理ガイド』の「Application Expressユーザーの管理」

Application Expressのアカウント資格証明は次のような場合に有効です。

- ユーザー・アカウント・リポジトリを制御する場合

- ユーザー名およびパスワードに基づいたセキュリティで十分な場合

- シングル・サインオン・フレームワークへの統合が不要な場合

この方法は特に、ユーザー・グループを新しいアプリケーションで迅速に起動および実行する必要がある場合に適しています。

Application Expressアカウント資格証明の設定

Application Expressアカウント資格証明を設定するには、次の手順を実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。
共有コンポーネント・ページが表示されます。

4. 「セキュリティ」で、「認証スキーム」を選択します。

5. 認証スキーム・ページで、「作成」をクリックします。

6. 「ギャラリからの事前構成済スキームに基づく」を選択します。

7. 「ギャラリ」で、「ログイン・ページの表示およびApplication Expressアカウント資格証明の使用」を選択します。

8. ログイン・ページを指定し、「次へ」をクリックします。

9. 名前を入力して、「スキームの作成」をクリックします。

データベース・アカウント資格証明

データベース・アカウント資格証明は、データベース・スキーマ・アカウントを使用します。この認証スキームでは、データベース・ユーザー(スキーマ)はローカル・データベースに存在している必要があります。この方法を使用する場合、ユーザーの認証にデータベース・アカウントのユーザー名およびパスワードが使用されます。

適用可能なアプリケーションの指定したユーザーごとに1つのデータベース・アカウントを持ち、ニーズに対応したデータベース・ツールによるアカウントのメンテナンスを行う場合に、データベース・アカウント資格証明は有効です。

データベース・アカウント資格証明の設定

データベース・アカウント資格証明を設定するには、次の手順を実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。
共有コンポーネント・ページが表示されます。

4. 「セキュリティ」で、「認証スキーム」を選択します。

5. 認証スキーム・ページで、「作成」をクリックします。

6. 「ギャラリからの事前構成済スキームに基づく」を選択します。

7. 「ギャラリ」で、「ログイン・ページの表示およびDatabaseアカウント資格証明の使用」を選択します。

8. ログイン・ページを指定し、「次へ」をクリックします。

9. 名前を入力して、「スキームの作成」をクリックします。

LDAP資格証明の検証

ログイン・ページを使用する認証スキームは、Lightweight Directory Access Protocol(LDAP)を使用して、ログイン・ページで送信されるユーザー名およびパスワードを検証するように構成できます。

アプリケーション・ビルダーには、このオプションの構成方法を示すウィザードと編集ページが含まれています。これらのウィザードでは、この構成のために、ご使用のアプリケーションにアクセス可能なLDAPディレクトリがすでに存在していることと、LDAPディレクトリが資格証明の検証のSIMPLE_BIND_Sコールに応答できることを想定しています。LDAP資格証明の認証スキームを作成する場合、ウィザードによってLDAPホスト名、LDAPポート、DN文字列が要求され保存されます。オプションの事前処理ファンクションを指定して、APIに渡されるユーザー名の書式設定を調整できます。

LDAP資格証明の検証の設定

LDAP資格証明の検証を設定するには、次の手順を実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。
共有コンポーネント・ページが表示されます。

4. 「セキュリティ」で、「認証スキーム」を選択します。

5. 認証スキーム・ページで、「作成」をクリックします。

6. 「ギャラリからの事前構成済スキームに基づく」を選択します。

7. 「ギャラリ」で、「ログイン・ページの表示およびLDAPディレクトリ資格証明の使用」を選択します。

8. ログイン・ページを指定し、「次へ」をクリックします。

9. 次の情報を指定し、「次へ」をクリックします。

1. LDAPホスト

2. LDAPポート

3. LDAP識別名(DN)文字列

4. (オプション) LDAPユーザー名編集ファンクション

特定のアイテムのヘルプを表示するには、アイテム・ラベルをクリックします。ヘルプが使用できる場合、アイテム・ラベルの上にカーソルを置くとアイテム・ラベルは赤に変わり、カーソルは矢印と疑問符マークに変わります。「フィールドレベル・ヘルプについて」を参照してください。

10. 名前を入力して、「スキームの作成」をクリックします。

DAD資格証明の検証

データベース・アクセス記述子(DAD)データベース認証では、Basic認証スキームを使用してユーザーを認証するのに、Oracle Databaseのシステム固有の認証およびユーザー・メカニズムを使用します。この認証スキームでは、DAD構成に格納された値か、アカウント情報がDAD構成に格納されていない場合はBasic認証要求を使用して取得されるユーザー名のいずれかとして、データベース・アクセス記述子(DAD)からユーザー名が取得されます。

DAD資格証明の検証を使用するには、次の条件を満たす必要があります。

- 各アプリケーション・ユーザーが、Oracle Databaseにユーザー・アカウントを持っている。

- Basic認証用のPL/SQL DADを構成している(アカウント情報なし)。
これによって、アプリケーション・ユーザーは、ブラウザ・セッションごとに1回ユーザー名/パスワードを要求されます。その後、ユーザー・アイデンティティ・トークンがAPP_USERアイテム内で使用可能になります。

DADデータベース認証は、管理可能な数のユーザーに対して最小限の設定のみが必要な認証方式を実装する場合に役立ちます。これらのユーザーがデータベース内に自己管理されたアカウントを持っており、この認証方式を短期間(たとえば、開発のデモンストレーションまたはプロトタイプ段階の間)のみ使用することが理想です。

この方法の主なデメリットは、特にユーザーが自分のパスワードを管理していないか、またはユーザーのデータベース・アカウントがアプリケーションへの認証を容易化するためのみに存在している場合に、アカウントのメンテナンスが負担となることです。

DAD資格証明の検証の設定

DAD資格証明の検証を設定するには、次の手順を実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。
共有コンポーネント・ページが表示されます。

4. 「セキュリティ」で、「認証スキーム」を選択します。

5. 認証スキーム・ページで、「作成」をクリックします。

6. 「ギャラリからの事前構成済スキームに基づく」を選択します。

7. 「ギャラリ」で、「認証なし(DADを使用)」を選択します。

8. 名前を入力して、「スキームの作成」をクリックします。

シングル・サインオン・サーバーの検証

Oracle Application Server Single Sign-On資格証明は、Oracle AS Single Sign-On(SSO)Serverに認証を委譲します。この認証スキームを使用するには、サイトは、SSO Serverにパートナ・アプリケーションとして登録されている必要があります。

Oracle Application Expressアプリケーションは、Oracle Application ServerのSingle Sign-On (SSO)インフラストラクチャでパートナ・アプリケーションとして実行できます。実行には、パートナ・アプリケーションとして、アプリケーション(またはApplication Expressエンジン)を登録する必要があります。アプリケーションまたはApplication Expressエンジンをパートナ・アプリケーションとして登録するには、Oracle Application Serverのパートナ・アプリケーションの登録手順に従い、Oracle 9iAS SSO Software Developer Kit(SDK)をインストールします。

この方法を選択する場合、ご使用のアプリケーションでは統合されたログイン・ページが使用されません。かわりに、ユーザーが新しいブラウザ・セッションでアプリケーションにアクセスすると、Application ExpressエンジンによってSingle Sign-Onログイン・ページにリダイレクトされます。ユーザーがSSOによって認証されると、SSOコンポーネントはアプリケーションにリダイレクトし、Application Expressエンジンにユーザー・アイデンティティおよびその他の情報を渡します。その後、ユーザーはログオフするか、ブラウザ・セッションを終了するか、またはその他のセッション終了イベントが発生するまでアプリケーションを使用できます。

Oracle Application Server Single Sign-Onの設定

Oracle Application Server Single Sign-Onを設定するには、次の手順を実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。
共有コンポーネント・ページが表示されます。

4. 「セキュリティ」で、「認証スキーム」を選択します。

5. 認証スキーム・ページで、「作成」をクリックします。

6. 「ギャラリからの事前構成済スキームに基づく」を選択します。

7. 「ギャラリ」から、次のいずれかの項目を選択します。

- Oracle Application Server Single Sign-On(パートナ・アプリケーションとしてのApplication Expressエンジン)は、Oracle AS Single Sign-On (SSO) Serverに認証を委譲します。この認証スキームを使用するには、サイトは、SSO Serverにパートナ・アプリケーションとして登録されている必要があります。

- Oracle Application Server Single Sign-On(パートナ・アプリケーションとしてのMy Application)は、SSO Serverに認証を委譲します。SSOには、アプリケーションをパートナ・アプリケーションとして登録する必要があります。

8. 名前を入力して、「スキームの作成」をクリックします。

認証スキームを最初から作成する方法について

認証スキームを最初から作成すると、認証インタフェースを完全に制御できます。これは、次のいずれかに該当する場合に最適な方法です。

- データベース認証または他の方式が適切でない。

- 独自のログイン・フォームおよび関連方式を開発する必要がある。

- Oracle 10gAS Single Sign-Onなどの外部サービスに対して、ユーザー認証のすべての設定を委譲する必要がある。

- セッション管理のセキュリティ面を制御する必要がある。

- ユーザー・レベルまたはセッション・レベルでアクティビティを記録または監査する必要がある。

- セッションのアクティビティ制限または存続期限を施行する必要がある。

- Oracle Application Expressページ・プロセスの前に一方向の条件付きリダイレクト・ロジックをプログラムする必要がある。

- 一般的なセッション管理フレームワークを使用して、アプリケーションをOracle Application Express以外のアプリケーションと統合する必要がある。

- アプリケーションが、シームレス(たとえば、複数のアプリケーションID)に動作する複数のアプリケーションで構成されている。

関連項目:
Oracle Application Express APIリファレンスの「APEX_CUSTOM_AUTH」

セッション管理セキュリティ

Oracle Application Expressは、カスタム認証を実行する際に、次の2つの不適切な状況が発生しないようにします。

- あるユーザーが、他のユーザーに属するセッション・ステートに故意にアクセスしようとすること。ただし、ユーザーは任意のアプリケーション・セッションIDをURLに入力できます。

- 失効したセッション・ステート(多くの場合、同じユーザーに属する以前のセッション・ステート)が不注意にアクセスされること。これは一般的に、アプリケーション・ページへのブックマークを使用したために発生します。

Oracle Application Expressは、カスタム認証ファンクションによって設定されたユーザーIDトークンが、アプリケーション・セッションが最初に作成された際に記録されたユーザーIDと一致するかどうかを確認します。ユーザーがまだ認証されておらず、ユーザーIDが認識されていない場合、アクセスをしているセッション・ステートは、他のユーザーに属していません。これらの確認によって、リクエスト内のセッションIDが使用可能かどうかが判断されます。セッションIDが使用不可能な場合、Application Expressエンジンは適切なセッションIDを使用して、同じページにリダイレクトします。

ログイン・ページの構築

Oracle Application Expressでアプリケーションを作成すると、ログイン・ページが作成されます。ページの別名は、LOGINです。このページは、認証スキームで無効なセッション・ページとして使用できます。このページは、Oracle Application ExpressのログインAPIをコールするプロセスを使用して、資格証明の検証およびセッションの登録を実行するように構成されています。

事前に構築されたモデル・ページを使用して、すべてのユーザー・インタフェースを調整し、要件に対してロジックを加工して、独自のログイン・ページを構築することもできます。

アプリケーションのログイン・ページを作成するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「ページの作成」をクリックします。

4. 「ログイン・ページ」を選択します。

5. ログイン・ページ属性を指定して、「作成」をクリックします。

ディープ・リンクについて

ディープ・リンクは、コンテキスト外(たとえば、電子メールのハイパーリンクまたはワークフロー通知から)のOracle Application Expressページにリンクする機能を指します。コンテキスト外のページにリンクし、そのアプリケーションでユーザー認証が必要な場合、ログイン・ページが表示されます。資格証明の検証後、Application Expressエンジンは元のリンクで参照されていたページを自動的に表示します。ディープ・リンクは、認証スキームを使用するアプリケーションに対してサポートされます。

既存の認証スキームの管理

認証スキームを作成すると、使用可能な認証スキームが認証スキーム・リポジトリに表示されます。

認証スキーム・リポジトリにナビゲートするには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。
共有コンポーネント・ページが表示されます。

4. 「セキュリティ」で、「認証スキーム」を選択します。
認証スキーム・ページが表示されます。「ビュー」リストから選択して、ページの外観を変更できます。使用可能なオプションは次のとおりです。

- アイコン(デフォルト): 各認証スキームを大きいアイコンとして表示します。認証スキームを編集するには、該当するアイコンをクリックします。

- 詳細: 各アプリケーション・アイテムをレポートで1行に表示します。
「詳細」ビューでは、次の操作を実行できます。

- スキーム名を選択して、認証スキームを編集する。

- 「表示」アイコンをクリックして、各ページで実行されるステップのリストを表示する。

- 「カレントにする」リンクをクリックして、認証スキームをアプリケーションに適用する。

アプリケーションに関連付けられた認証スキームの表示

アプリケーションのカレント認証スキームを表示するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「セキュリティ」で、「セキュリティ属性の編集」をクリックします。

5. 「認証」セクションに移動します。カレント認証スキームが「認証スキーム」の横に表示されます。

6. 認証スキーム・ページにリンクして、スキーム名を選択するには、次のステップを実行します。

アプリケーションに関連付けられた認証スキームの変更

アプリケーションの認証スキームを変更するには、次のステップを実行します。

1. 「認証スキーム」にナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。
共有コンポーネント・ページが表示されます。

4. 「セキュリティ」で、「認証スキーム」を選択します。

2. ページの上部の「カレントの変更」タブをクリックします。

3. 新しい認証スキームを選択し、「次へ」をクリックします。

4. 「カレント化」をクリックします。

認証スキームの使用状況レポートの表示

認証スキーム・レポートには、現行のワークスペースにおけるすべてのアプリケーションについて、認証スキームの使用状況がリストされます。

認証スキーム・レポートを表示するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。
アプリケーションのホームページが表示されます。

3. 「タスク」リストで「アプリケーション・レポートの表示」をクリックします。

4. 「アプリケーション間レポート」をクリックします。

5. 「認証スキーム」を選択します。

6. アプリケーションIDをクリックして、該当するアプリケーションのホームページにリンクします。

認可を介したセキュリティの提供

認可は、ユーザー権限に基づいてリソースへのアクセスを制御することを示す広義語です。条件は特定のページ・コントロールまたはページ・コンポーネントのレンダリングおよび処理を制御しますが、認可スキームは特定のコントロールまたはコンポーネントへのユーザーのアクセスを制御します。

この項に含まれる内容は次のとおりです。

- 認可スキームの動作方法

- 認可スキームの作成

- アプリケーション、ページまたはコンポーネントへの認可スキームの割当て

- 認可レポートの表示

認可スキームの動作方法

認可スキームは、アプリケーションの認証スキームのセキュリティを強化します。認可スキームは、アプリケーション全体、各ページ、またはリージョン、アイテム、ボタンなどの特定のコントロールに対して指定できます。たとえば、認可スキームを使用して、ユーザーに表示するタブ、リージョンまたはナビゲーション・バーを選択的に決定できます。

認可スキームの結果は、成功または失敗のいずれかです。コンポーネントまたはコントロール・レベルの認可スキームに成功すると、そのコンポーネントまたはコントロールがユーザーに表示されます。失敗すると、そのコンポーネントまたはコントロールはユーザーに表示されません。アプリケーション・レベルまたはページ・レベルの認可スキームに失敗すると、Oracle Application Expressは事前定義済のメッセージを表示します。

認可スキームを定義する場合は、一意の名前を指定します。定義した認可スキームは、アプリケーションのコンポーネントまたはコントロールに割り当てることができます。アプリケーションのコンポーネントまたはコントロールに認可スキームを割り当てるには、該当する属性ページにナビゲートして、「認可スキーム」リストから認可スキームを選択するのみです。

認可スキームの作成

認可スキームは、アプリケーションまたはアプリケーション・コンポーネントまたはコントロールに割り当てる前に作成する必要があります。

認可スキームを作成するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。
共有コンポーネント・ページが表示されます。

4. 「セキュリティ」で、「認可スキーム」を選択します。

5. 「作成」をクリックします。

6. 次のいずれかの項目を選択して、認可スキームの作成方法を指定します。

- 最初から

- 既存の認可スキームのコピーとして

7. 画面に表示されるステップに従います。

関連項目:
「アプリケーション、ページまたはコンポーネントへの認可スキームの割当て」

既存の認可スキーム属性の編集

既存の認可スキームの属性を編集するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。
共有コンポーネント・ページが表示されます。

4. 「セキュリティ」で、「認可スキーム」を選択します。
認可スキーム・ページが表示されます。デフォルトでは、各スキームがアイコンとして表示されます。

5. すべてのスキームの詳細ビューにアクセスするには、「ビュー」リストから「詳細」を選択します。
認可スキーム・ページが表示されます。「ビュー」リストから選択して、ページの外観を変更できます。使用可能なオプションは次のとおりです。

- アイコン(デフォルト): 各認証スキームを大きいアイコンとして表示します。認可スキームを編集するには、該当するアイコンをクリックします。

- 詳細: 各アプリケーション・アイテムをレポートで1行に表示します。認可スキームを編集するには、スキーム名を選択します。

評価ポイント属性

評価ポイント属性に、認可スキームを検証するタイミングを指定できます。認可スキームをセッションごとに1回検証するか、またはページ・ビューごとに1回検証するかを選択できます。

認可スキームがセッションごとに1回評価されるように指定して、その認可スキームが合格した場合、基礎となるコード、テストまたは問合せは、そのアプリケーション・セッション中に再実行されないことに注意してください。認可スキームが、セッション中の異なる時刻に評価されると結果が異なる可能性があるテストで構成されている場合、評価ポイントをページ・ビューごとに1回に指定する必要があります。

認可スキーム・ステートのリセット

認可スキームがセッションごとに1回検証される場合、Oracle Application Expressは各ユーザーのセッション・キャッシュ内に検証結果をキャッシュします。セッションの認可スキーム・ステートは、APEX_UTIL.RESET_AUTHORIZATIONS APIをコールしてリセットできます。

このプロシージャをコールすると、カレント・セッションに対して以前にキャッシュされた認可スキームの結果がNULLになります。このプロシージャは引数を取らず、パブリックに実行可能なAPEX_UTILパッケージの一部であることに注意してください。

関連項目:
Oracle Application Express APIリファレンスの「RESET_AUTHORIZATIONSプロシージャ」

アプリケーション、ページまたはコンポーネントへの認可スキームの割当て

作成した認可スキームは、アプリケーション全体、ページ、コントロールまたはコンポーネントに割り当てることができます。

この項に含まれる内容は次のとおりです。

- アプリケーションへの認可スキームの割当て

- ページへの認可スキームの割当て

- コントロールまたはコンポーネントへの認可スキームの割当て

アプリケーションへの認可スキームの割当て

認可スキームをアプリケーションに割り当てるには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」アイコンをクリックします。
共有コンポーネント・ページが表示されます。

4. 「セキュリティ」で、「セキュリティ属性の編集」をクリックします。

5. 「認可」までスクロールして、「認可スキーム」リストから認可スキームを選択します。

ページへの認可スキームの割当て

認可スキームをページに割り当てるには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. ページを選択します。

4. 「ページ・レンダリング」で、ページのタイトルのセクションを探します。

5. 「ページ属性の編集」アイコンをクリックします。

6. 「セキュリティ」までスクロールして、「認可スキーム」リストから認可スキームを選択します。

コントロールまたはコンポーネントへの認可スキームの割当て

認可スキームをページ・コンポーネントまたはコントロールに割り当てるには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. ページを選択します。

4. 認可スキームを適用するコンポーネントまたはコントロールの名前をクリックします。

5. 「セキュリティ」までスクロールして、「認可スキーム」リストから認可スキームを選択します。

認可レポートの表示

認可スキームのサブスクリプションおよび認可スキームの使用率レポートを使用すると、アプリケーション内の認可スキームをより効率的に管理できます。

認可スキーム・レポートを表示するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。
共有コンポーネント・ページが表示されます。

4. 「セキュリティ」で、「認可スキーム」を選択します。

5. ページ上部の該当するタブをクリックします。

- サブスクリプション

- 使用状況

サブスクリプション

認可スキームのサブスクリプション・レポートを使用して、認可スキームのサブスクリプションの詳細を表示します。

使用状況

認可スキームの使用率レポートを使用して、認可スキームの使用率の詳細を表示します。

ページの認可スキームの有無を示す詳細レポートを表示するには、「タスク」リストから次のいずれかを選択します。

- 認可スキームが指定されているレポート・ページ

- 認可スキームが指定されていないレポート・ページ

14 アプリケーションのデプロイ

このセクションでは、アプリケーション・ビルダー内で作成したアプリケーションをパッケージする方法を説明します。

この項には、次の項目が含まれます。

- Oracle Application Expressアプリケーション開発のライフ・サイクルについて

- パッケージ・プロセスの理解

- 別の開発インスタンスへのアプリケーションの移動方法

- パッケージ・アプリケーションの作成方法

- アプリケーションおよび関連ファイルのエクスポート

- エクスポート・ファイルのインポート

- エクスポート・ファイルのインストール

- アプリケーションURLの公開について

- ビルド・オプションを使用した構成の制御

関連項目:
「高度なプログラミング手法」およびOracle Application Express管理ガイドの「Application Expressユーザーの管理」

Oracle Application Expressアプリケーション開発のライフ・サイクルについて

アプリケーション・ビルダーを使用してアプリケーションを開発する際、次のように大きく異なる2つの開発方法を考慮する必要があります。

- 反復による、迅速なアプリケーション開発

- 計画され、段階を経る開発

1つ目の方法は、柔軟性がありすぎてプロジェクトが完成しない危険性があります。それとは対照的に2つ目の方法は、理論上は決められた要件を満たしていても、エンド・ユーザーのニーズにあわないアプリケーションが作成される可能性があります。

考慮すべきシステム開発のライフ・サイクル方法論

システム開発のライフ・サイクル(SDLC)は、定義された一連のステップを使用した、ソフトウェア開発全体のプロセスです。Oracle Application Expressには、アプリケーション開発に便利な多数のSDLCモデルがあります。

SDLCウォーターフォールは、最も有名なモデルでしょう。この方法では、開発プロセスは次の段階に分類されます。

1. プロジェクトのプランニング

2. 要件の定義

3. 設計

4. 開発

5. 統合およびテスト

6. インストールおよび採用

7. メンテナンス

この方法は、ある段階の出力結果が次の段階の入力内容になることから、ウォーターフォールと呼ばれます。この方法には、前の段階ですべての要件が確立されていることが前提となります。しかし、実際には、開発プロセスの途中で要件が変更されたり、新しい要件が加わることが多くあります。

Oracle Application Expressの開発環境を使用すると、開発者は、開発においてより対話的な方法をとることができます。他の多くの開発環境とは異なり、プロトタイプの作成が容易です。Oracle Application Expressを使用すると、開発者は次のことを実行できます。

- 組込みウィザードを使用して、アプリケーションのユーザー・インタフェースを簡単に設計できます。

- ユーザーによる使用が可能なプロトタイプを作成でき、フィードバックを収集できます。

- 変更をリアル・タイムに実装し、新しいプロトタイプを簡単に作成できます。

他にOracle Application Expressを使用して機能する方法論として次のものがあります。

- スパイラル: この方法は、実質的には、短いウォーターフォール・サイクルをつなげたものです。各ウォーターフォール・サイクルから新たな要件が発生し、開発チームによって堅牢なプロトタイプが作成できるようになります。

- 高速アプリケーション開発(RAD)ライフ・サイクル: この方法は、完成した製品に近いプロトタイプの作成を非常に重要視した方法です。プロトタイプは、要件フェーズの重要な部分です。このモデルの1つの短所として、プロトタイプの作成を重要視することによって要件が追加される可能性があります。開発者は、完全なアプリケーションを作成しようとして、当初の目的を見失うことがあります。

パッケージ・プロセスの理解

あるOracle Application Expressインスタンスから別のインスタンスにアプリケーションを移動するには、アプリケーションで使用されるメタデータとサポートするオブジェクトの両方を次のように移動する必要があります。

1. アプリケーション定義およびすべての関連ファイルを移動します。「別の開発インスタンスへのアプリケーションの移動方法」を参照してください。

2. サポートするオブジェクトを移動します。データベースの依存性レポートを確認して、移動するオブジェクトを決定します。「データベース・オブジェクトの依存性レポートについて」および「パッケージ・アプリケーションの作成方法」を参照してください。

この項には、次の項目が含まれます。

- 考慮するデプロイ・オプション

- ワークスペースをコピーするかどうかの決定

- データベースをコピーするかどうかの決定

- アプリケーションIDについて

考慮するデプロイ・オプション

アプリケーション・ビルダーでアプリケーションを開発する場合は、特定のワークスペース内でアプリケーションを作成します。各ワークスペースには、一意のIDおよび名前が含まれます。通常は、開発インスタンスでアプリケーションを作成し、本番インスタンスにアプリケーションをデプロイします。

デプロイ・プロセスでは、アプリケーションID、ワークスペース、データベースまたはOracle HTTP Serverに既存のものを使用するか、新規に作成するかを、それぞれに判断する必要があります。考慮するデプロイ・オプションには、次のものがあります。

1. Application Expresエンド・ユーザーの作成:アプリケーションをデプロイする最も簡単な方法は、Application Expressのエンド・ユーザーを作成し、そのユーザーにURLおよびログイン情報を送信することです。この方法は、少数で寛容なユーザーを持つアプリケーションに有効です。「アプリケーションURLの公開について」およびOracle Application Express管理ガイドの「Application Expressのユーザー管理」を参照してください。

2. 同一ワークスペースおよび同一スキーマの使用: アプリケーションをエクスポートしてからインポートし、別のアプリケーションIDを使用してインストールします。この方法は、基礎になるオブジェクトに対する変更は少ないが、アプリケーションの機能に対して頻繁に変更がある場合に有効です。

3. 別のワークスペースおよび同じスキーマの使用: アプリケーションをエクスポートしてから別のワークスペースにインポートします。この方法は、開発者によって本番アプリケーションが変更されないようにするために有効です。

4. 別のワークスペースおよび別のスキーマの使用: アプリケーションをエクスポートしてから別のワークスペースにインポートし、異なるスキーマを使用するためにアプリケーションをインストールします。この新しいスキーマには、アプリケーションに必要なデータベース・オブジェクトが含まれている必要があります。「データベース・オブジェクトの依存性レポートについて」を参照してください。

5. すべてのバリエーションによる別のデータベースの使用:アプリケーションをエクスポートしてから別のOracle Application Expressインスタンスにインポートし、異なるスキーマおよびデータベースを使用してインストールします。

ワークスペースをコピーするかどうかの決定

既存のワークスペースをコピーするかどうかを判断する際に、プリファレンスが問題になります。本番バージョンでは関係するすべてのオブジェクトへのアクセスが必要であることを覚えておいてください。たとえば、次のような場合にワークスペースをコピーする必要があります。

- アプリケーションをワークスペース内の他のOracle Application Expressオブジェクトにサブスクライブする場合。

- アプリケーションでOracle Application Express認証に依存する場合。ワークスペースをコピーすると、自動的にすべての必要なユーザー・データが移行されます。

データベースをコピーするかどうかの決定

データベースをコピーするかどうかを判断する際、アプリケーションが実行されるスキーマは、開発インスタンスと同じオブジェクトにアクセスする必要があることを覚えておいてください。スキーマの実際の名前は重要ではありません。スキーマ名は、インポート・プロセスで変更できます。

アプリケーションIDについて

開発バージョンと本番バージョンのアプリケーションで、アプリケーションIDを一致させる必要はありません。実際、アプリケーションにアプリケーションIDをハード・コードしないことをお薦めします。かわりにアプリケーションの別名(定義の編集ページで定義される)を使用するか、組込み置換文字列(APP_IDおよびAPP_ALIAS)を使用します。置換文字列は、アプリケーションの機能に影響なくアプリケーションIDを変更できるため、置換文字列の使用をお薦めします。

関連項目:
アプリケーションの別名の定義については「名前」を、APP_IDおよびAPP_ALIASの使用方法については「組込み置換文字列について」を参照してください。

新規HTTPサーバーのインストールの決定

実行時、Oracle Application Expressは、埋込みPL/SQLゲートウェイ、またはOracle HTTP Serverとmod_plsqlにアクセスする必要があります。HTTPサーバーをインストールすることにより、アプリケーションの開発バージョンと本番バージョンを分割することができます。HTTPサーバーの構成オプションの詳細は、オペレーティング環境に適切なインストレーション・ガイドのHTTPサーバーの選択に関するセクションを参照してください。詳細は、「関連ドキュメント」を参照してください。

別の開発インスタンスへのアプリケーションの移動方法

アプリケーションを他のワークスペースに移動するか、コピーを作成するのみかにかかわらず、デプロイでは次のステップを実行します。

1. サポートするデータベース・オブジェクトを移動します(適切な場合)。データベースの依存性レポートを確認して、移動するオブジェクトを決定します。「データベース・オブジェクトの依存性レポートについて」を参照してください。

2. アプリケーション定義とサポートするオブジェクトをパッケージ化して、パッケージ・アプリケーションを作成します。「パッケージ・アプリケーションの作成方法」を参照してください。

3. エクスポートされたファイルをターゲットのOracle Application Expressインスタンスにインポートします。「エクスポート・ファイルのインポート」を参照してください。
ターゲット・インスタンスが別のスキーマである場合は、必要なデータベース・オブジェクトをエクスポートおよびインポートする必要もあります。

4. エクスポートされたファイルをエクスポート・リポジトリからインストールします。「エクスポート・ファイルのインストール」を参照してください。

アプリケーションは、アプリケーションが開発されたワークスペース以外のワークスペースにもインポートできます。「考慮するデプロイ・オプション」を参照してください。

ヒント:
アプリケーション定義およびすべてのサポートするオブジェクトを手動でも移動できます。「アプリケーションおよび関連ファイルのエクスポート」を参照してください。

データベース・オブジェクトの管理について

アプリケーションと適切な関連ファイルをエクスポートする前に、アプリケーションによって参照されるデータベース・オブジェクトも移行する必要があるかどうかを判断する必要があります。移動するデータベース・オブジェクトがわからない場合は、データベース・オブジェクトの依存性レポートを確認します。

関連項目:
「データベース・オブジェクトの依存性レポートについて」および「パッケージ・アプリケーションの作成方法」

ターゲットのスキーマが開発環境で使用されるスキーマとは異なる場合、アプリケーションによって参照されるデータベース・オブジェクトを移行する必要があります。多くの場合、Oracle Databaseのエクスポート・ユーティリティおよびインポート・ユーティリティを使用して、開発環境からターゲットのインスタンスにアプリケーション・スキーマをコピーするのみでこれを行うことができます。次に、この方法が適切でない2つの一般的なケースを示します。

- オブジェクト開発スキーマが、ターゲット・インスタンス・スキーマがアクセス権を持たない表領域を参照している場合

- 開発インスタンス・スキーマに、ターゲット・インスタンス・スキーマに移行しないサンプル・データが含まれている場合

データベース管理者またはOracle Application Express管理者がOracle Application Expressアプリケーションのエクスポートを行う場合、それらの管理者と連絡して、次のことを明示しておく必要があります。

- アプリケーションのエクスポート時に、すべてのデータを含める必要がある

- 指定した特定の表のデータを含めない

ヒント:
Oracle Application Express SQLワークショップおよびユーティリティ・ガイドの「データベースからのデータのロードとアンロード」

パッケージ・アプリケーションの作成方法

サポートするオブジェクト・ページでパッケージ・アプリケーションを作成すると、アプリケーションのデプロイに必要なステップを非常に簡略化できます。

関連項目:
「アプリケーションの別の開発インスタンスへの移動方法」および「アプリケーションおよび関連ファイルのエクスポート」

この項には、次の項目が含まれます。

- パッケージ・アプリケーションのデプロイを簡略化する方法

- パッケージ・アプリケーションの作成

- イメージ、カスケード・スタイルシートまたは静的ファイルへのインストール・スクリプトの追加

- パッケージ・アプリケーションへのアクセス制御リストの追加

- サポートするオブジェクトのインストール

- サポートするオブジェクトのスクリプト、メッセージ、およびインストール・オプションの削除

- パッケージ・アプリケーションのアップグレード

- サポートするオブジェクトの削除

- インストール・サマリーの表示

パッケージ・アプリケーションのデプロイを簡略化する方法

ユーザーにとって、アプリケーションのインポートおよびインストールは複雑なプロセスです。最初に、ターゲットのデータベース・オブジェクトおよびシード・データを作成します。次に、アプリケーション定義およびすべての関連ファイル(イメージ、テーマ、他のすべての必要な静的ファイルなど)をインポートしてインストールします。

サポートするオブジェクト・ユーティリティを使用してパッケージ・アプリケーションを作成すると、このプロセスを非常に簡略化できます。多くのステップを実行して、データベース・オブジェクトを作成し、アプリケーションおよびすべてのサポートするファイルをインポートしてインストールするかわりに、サポートするオブジェクトを定義すれば、アプリケーションおよびサポートするファイルを簡単な数ステップで移行できます。

ユーザーがアプリケーション定義をインポートしてインストールした後に、ウィザードにより簡単な数ステップで構成できます。ウィザードでは、サポートするアプリケーション・オブジェクトをインストールするかどうかが要求されます。ユーザーには、サポートするアプリケーション・オブジェクトをその場でインストールするか、後でインストールするかのオプションがあります。

開発者にとって、この機能には、次のような多くの利点があります。

- サポートするオブジェクトが正しい順序で作成されていることを確認してください。

- わずかなステップで素早くアプリケーションをデプロイするための自動化プロセスをユーザーに提供します。

- ユーザーがアプリケーション定義をインポートしてインストールするときにまたは後で、サポートするアプリケーション・オブジェクトをインストールするオプションをユーザーに提供します。「サポートするオブジェクトのインストール」を参照してください。

- ユーザーおよび開発者は、便利な方法で、アプリケーション定義、サポートするファイルおよびすべてのデータベース・オブジェクトを削除できます。「サポートするオブジェクトの削除」を参照してください。

- ユーザーおよび開発者は、簡単な方法で、前にリリースされたパッケージ・アプリケーションをアップグレードできます。「パッケージ・アプリケーションのアップグレード」を参照してください。

また、アプリケーションをサポートする基礎となるデータベース・オブジェクトを簡単に編集するために、削除機能およびインストール機能を利用することができます。たとえば、すべてのデータベース・オブジェクトの削除、基礎となるデータベース・オブジェクトの作成スクリプトの編集、および再定義されたアプリケーション・オブジェクトの作成用の再インストールを行うことができます。

パッケージ・アプリケーションの作成

パッケージ・アプリケーションを作成するには、アプリケーションのサポートするオブジェクト(データベース・オブジェクト、イメージおよびシード・データを含む)およびすべてのインストール前の検証を定義するインストール・スクリプトを作成する必要があります。これらのオブジェクトとインストール・スクリプトおよび削除スクリプト、およびユーザーがサポートするオブジェクト・ページでインストールまたは削除する場合に表示するメッセージを定義します。

この項には、次の項目が含まれます。

- サポートするオブジェクト・ページへのアクセス

- サポートするオブジェクト・ページについて

「サポートするオブジェクト」ページへのアクセス

サポートするオブジェクト・ページで、パッケージ・アプリケーションを作成します。

サポートするオブジェクト・ページのアプリケーションにアクセスするには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。
アプリケーションのホームページが表示されます。

3. 「サポートするオブジェクト」アイコンをクリックします。
サポートするオブジェクト・ページが表示されます。

サポートするオブジェクト・ページについて

サポートするオブジェクト・ページの上部に、アプリケーション名が表示され、「オブジェクトの確認」、「システム権限の検証」、「必要な空き」、「使用許諾のプロンプト」、「置換」、「ビルド・オプション」、「検証」、「インストール・スクリプト」、「アップグレード・スクリプト」、「削除スクリプト」および「エクスポートに含める」の現在の選択が示されます。

残りのページは4つのカテゴリに分割されています。

インストール

「インストール」のリンクを使用して次のタイプの情報を定義します。

- 前提条件:　必要なディスクの空き領域、必要なシステム権限、スキーマ・オブジェクト制限など、アプリケーションのインストール前に必要な組込みチェックを定義します。

- アプリケーション置換文字列: アプリケーションに対して定義された静的置換文字列をリストします。アプリケーション内の多くの語句またはラベルに対する静的置換文字列を定義できます。詳細は、「置換」を参照してください。
アプリケーションをパッケージ化する場合、パッケージ・アプリケーションをインストールする際にユーザーが指定できる置換文字列のプロンプトを含めることができます。

- ビルド・オプション: このアプリケーションに対して定義されたビルド・オプションをリストします。ビルド・オプションを使用して、アプリケーション内の特定の機能を条件付きで表示できます。「ビルド・オプションを使用した構成の制御」および「ビルド・オプションまたはビルド・オプション・ステータスのエクスポート」を参照してください。
アプリケーションをパッケージ化する場合、アプリケーションをインストールする際に表示される特定のビルド・オプションのプロンプトを含めることができます。

- インストール前の検証: パッケージ・アプリケーションに対して定義された検証をリストします。標準のページ検証と同様に、ユーザー定義条件が満たされない場合、これらの検証によりユーザーはデータベース・オブジェクトをインストールできなくなります。「作成」をクリックして、画面に表示されるステップに従います。

- インストール・スクリプト: アプリケーションにサポートするオブジェクトをインストールする複数のインストール・スクリプトを定義できます。新規スクリプトを作成するには、「作成」をクリックして、画面に表示されるステップに従います。既存のスクリプトを編集するには、「編集」アイコンをクリックします。

メッセージ

「メッセージ」の下のリンクを使用して、アプリケーションをインストールまたは削除する場合にメッセージを定義して表示します。サポートされるHTMLタグには、<b>、<i>、<u>、<p>、<br>、<hr>、<ul>、<ol>、<li>および<pre>が含まれます。使用可能なメッセージ・タイプは次のとおりです。

- ようこそ

- ライセンス

- アプリケーション置換

- ビルド・オプション

- 検証

- 確認

- インストール後

- アップグレード

- 削除

これらのメッセージを表示する際には、クロスサイト・スクリプティング(XSS)攻撃を防ぐために、一連の限定されたHTMLタグのみが認識されることに注意してください。「クロスサイト・スクリプティング保護の理解」を参照してください。

アップグレード

「アップグレード・スクリプト」をクリックして、既存のアプリケーションをアップグレードする際に、データベース・オブジェクト、イメージおよびシード・データをアップグレードするスクリプトを定義します。「パッケージ・アプリケーションのアップグレード」を参照してください。

削除

「削除スクリプト」をクリックして、インストール・スクリプトにより作成されたデータベース・オブジェクトおよび静的ファイルを削除するスクリプトを定義します。既存のスクリプトを編集するには、「編集」アイコンをクリックします。

イメージ、カスケード・スタイルシートまたは静的ファイルへのインストール・スクリプトの追加

インストール・スクリプト・ページで、アプリケーションまたはワークスペースに事前にアップロードしたイメージ、カスケード・スタイルシートおよび静的ファイルのインストール・スクリプトを作成できます。Oracle Application Expressでは、新規スクリプトごとに、名前として選択するファイル名が使用されます。対応するAPIコールを削除スクリプトの最後に追加(削除スクリプトが存在しない場合は作成)することもできます。削除スクリプトは、アプリケーションのサポートするオブジェクトが削除されるときに、選択したファイルを削除します。

関連項目:
「カスタム・カスケード・スタイルシートの使用」、「イメージの管理」および「静的ファイルの管理」

イメージ、カスケード・スタイルシートまたは静的ファイルのインストール・スクリプトを作成するには、次のステップを実行します。

1. 次のように、サポートするオブジェクト・ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。
アプリケーションのホームページが表示されます。

3. 「サポートするオブジェクト」をクリックします。
サポートするオブジェクト・ページが表示されます。

2. 「インストール」で、「インストール・スクリプト」をクリックします。
インストール・スクリプト・ページが表示されます。

3. 「作成」をクリックします。

4. ページの下部で、「ファイルをインストールするスクリプトの作成」をクリックします。
使用可能なカスケード・スタイルシート、イメージおよび静的ファイルのリストが表示されます。

5. パッケージ・アプリケーションに含めるファイルを選択し、「スクリプトの作成」をクリックします。

パッケージ・アプリケーションへのアクセス制御リストの追加

アクセス制御リストを作成することによって、アプリケーション、個別ページまたはページ・コンポーネントへのアクセスを制御できます。

パッケージ・アプリケーションのアクセス制御リストを追加するには、次のステップを実行します。

1. アクセス制御リストを作成します。「アプリケーション、ページおよびページ・コンポーネントへのアクセスの制御」を参照してください。

2. 次のように、サポートするオブジェクト・ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。
アプリケーションのホームページが表示されます。

3. 「サポートするオブジェクト」をクリックします。
サポートするオブジェクト・ページが表示されます。

3. 「インストール」で、「インストール・スクリプト」をクリックします。
インストール・スクリプト・ページが表示されます。

4. 「作成」をクリックします。

5. ページの下部で、「アクセス制御表のスクリプトの作成」をクリックします。
アクセス制御表が定義されている場合は、スクリプトの作成ページに、含まれる表が表示されます。

6. 「スクリプトの作成」をクリックします。

サポートするオブジェクトのインストール

サポートするオブジェクトを編集した後、適切なスクリプトを作成し、「タスク」リストの「サポートするオブジェクトのインストール」をクリックしてインストール・スクリプトを実行できます。

アプリケーション定義をインポートおよびインストールした後、パッケージ・アプリケーション(またはサポートするオブジェクト)をインストールしないことを選択する場合は、エンド・ユーザーもこの機能を使用できます。

サポートするオブジェクトをインストールするには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「サポートするオブジェクト」をクリックします。
サポートするオブジェクト・ページが表示されます。

4. 「タスク」リストで、「サポートするオブジェクトのインストール」をクリックします。

5. インストール・スクリプトを実行する前にその詳細を表示するには、「インストール・スクリプトのプレビュー」をクリックします。
スクリプトのプレビュー・ページが表示され、サマリー情報、前提条件および実行する実際のスクリプトがリストされます。

6. スクリプトのプレビュー・ページを終了して続行するには、「閉じる」をクリックします。

7. 「サポートするオブジェクトのインストール」から、「はい」をクリックし、「次へ」をクリックします。

8. 画面に表示されるステップに従います。

サポートするオブジェクトのスクリプト、メッセージ、およびインストール・オプションの削除

サポートするオブジェクト・ページの「タスク」リストの「サポートするオブジェクトのインストールの削除」をクリックすると、パッケージ・アプリケーションに関連付けられたサポートするオブジェクトのスクリプト、メッセージおよびインストール・オプションを定義するメタデータを削除できます。

サポートするオブジェクトのスクリプト、メッセージおよびインストール・オプションを定義するメタデータを削除するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「サポートするオブジェクト」をクリックします。
サポートするオブジェクト・ページが表示されます。

4. ページの右側の「タスク」リストで、「サポートするオブジェクトのインストールの削除」をクリックします。

5. 画面に表示されるステップに従います。

パッケージ・アプリケーションのアップグレード

アップグレード・ページで、前に公開されたアプリケーションをアップグレードするスクリプトを定義できます。

この項には、次の項目が含まれます。

- アップグレード・スクリプトの定義

- パッケージ・アプリケーションのアップグレード

アップグレード・スクリプトの定義

アップグレード・ページを使用して、既存のアプリケーションをアップグレードする際に、データベース・オブジェクト、イメージおよびシード・データをアップグレードするスクリプトを定義できます。

アップグレード・スクリプトを作成するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「サポートするオブジェクト」をクリックします。
サポートするオブジェクト・ページが表示されます。

4. 「アップグレード」で、「アップグレード・スクリプト」をクリックします。

5. スクリプトを作成するには、「作成」をクリックします。

ヒント:
このアプリケーションの様々な旧バージョンをユーザーがアップグレードできるようにするために、スクリプトのプロパティ・ページに移動してアップグレード・スクリプトに条件を追加できます。

「既存のサポートするオブジェクトの検出」セクションを使用して、適切なオブジェクトをインストールするか、またはアップグレードする必要があるかを決定します。

6. 「既存のサポートするオブジェクトを検査する問合せ」で、表示されたフィールドに、サポートするオブジェクトが存在する場合に少なくとも1つの行を戻す問合せを入力します。
パッケージ・アプリケーションをインストールするユーザーにインストール・スクリプトまたはアップグレード・スクリプトを実行するように求めるかどうかが、問合せにより決定されます。

7. 画面に表示されるステップに従います。

パッケージ・アプリケーションのアップグレード

アップグレード・スクリプトの作成後、サポートするオブジェクト・ページの「タスク」リストの「サポートするオブジェクトのアップグレード」をクリックすることによりテストできます。

また、エンド・ユーザーもこの機能を使用して既存のパッケージ・アプリケーションをアップグレードできます。

パッケージ・アプリケーションをアップグレードするには、次のステップを実行します。

1. アップグレードする新しいバージョンのアプリケーションをインポートします(使用可能な場合)。「アプリケーションまたはページのインポート」を参照してください。

2. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

3. アプリケーションを選択します。

4. 「サポートするオブジェクト」をクリックします。
サポートするオブジェクト・ページが表示されます。

5. 「タスク」リストから、「サポートするオブジェクトのアップグレード」をクリックします。

6. 画面に表示されるステップに従います。

サポートするオブジェクトの削除

パッケージ・アプリケーションを作成またはインストールすると、次のいずれかの方法で削除できます。

- サポートするオブジェクト・ページで、「サポートされているオブジェクトの削除」をクリックします

- アプリケーションのホームページで、「このアプリケーションの削除」をクリックします

アプリケーションを削除する場合、現在のアプリケーション定義を削除して、サポートするオブジェクトに定義された削除スクリプトを実行するオプションがあります。

関連項目:
「パッケージ・アプリケーションの作成」

パッケージ・アプリケーションを削除するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「サポートするオブジェクト」をクリックします。
サポートするオブジェクト・ページが表示されます。

4. 「サポートされているオブジェクトの削除」をクリックします。

5. 削除オプションを次のように選択します。

- アプリケーション定義の削除: 現在のアプリケーション定義を削除します。

- データベース・オブジェクトの削除: このアプリケーションのデプロイ属性に定義された削除スクリプトを実行します。

6. 画面に表示されるステップに従います。

インストール・サマリーの表示

サポートするオブジェクト・ページで、「タスク」リストの「インストール・サマリーの表示」をクリックすると、最近のインストール・ログおよび削除ログを表示できます。このログには、現在のApplication Expressセッション中に発生した最新のインストールまたは削除の結果のみ表示されることに注意してください。

インストール・サマリーを表示するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「サポートするオブジェクト」をクリックします。
サポートするオブジェクト・ページが表示されます。

4. ページの右側の「タスク」リストで、「インストール・サマリーの表示」をクリックします。
サマリー・ページが表示されます。

アプリケーションおよび関連ファイルのエクスポート

エクスポート・ページの上部にある「ワークスペース・ユーザー」、「アプリケーション」、「CSS」、「イメージ」、「ファイル」、「テーマ」および「ユーザー・インタフェースのデフォルト値」タブを使用するアプリケーション定義およびすべての関連ファイルをエクスポートおよびインポートします。ワークスペース・ユーザーを移行しないか、ターゲット・インスタンスで共有コンポーネントのサブスクリプションをレプリケートしないかぎり、ワークスペースをエクスポートする必要がないことに注意してください。

アプリケーションとすべての関連ファイルをエクスポートしたら、それらをターゲットのOracle Application Expressインスタンスにインポートしてからインストールする必要があります。一般的に、常にアプリケーションをインポートしてから関連ファイルをインポートします。「別の開発インスタンスへのアプリケーションの移動方法」を参照してください。

ヒント:
パッケージ・アプリケーションを作成すると、アプリケーションのデプロイに必要なステップを単純化できます。「パッケージ・アプリケーションの作成方法」を参照してください。

この項には、次の項目が含まれます。

- アプリケーションのエクスポート

- ワークスペース・ユーザーのエクスポート

- アプリケーション・コンポーネントのエクスポート

- アプリケーションのページのエクスポート

- カスケード・スタイルシートのエクスポート

- イメージのエクスポート

- 静的ファイルのエクスポート

- スクリプト・ファイルのエクスポート

- テーマのエクスポート

- ユーザー・インタフェースのデフォルト値のエクスポート

- イメージ、CSSおよびスクリプト・ファイルの格納先

アプリケーションのエクスポート

アプリケーションのエクスポート時に、Oracle Application ExpressによってPL/SQL APIコールを含むテキスト・ファイルが生成されます。

関連項目:
「アプリケーション・コンポーネントのエクスポート」

アプリケーションをエクスポートするには、次のステップを実行します。

1. エクスポート・ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「エクスポート/インポート」をクリックします。

4. エクスポート/インポート・ページで、「エクスポート」をクリックしてから「次へ」をクリックします。

2. 「アプリケーション」から、エクスポートするアプリケーションを選択します。

3. 「ファイル形式」から、エクスポート・ファイルの行を形式化する方法を選択します。

- UNIXを選択すると、改行で区切られた行が含まれるファイルが生成されます。

- DOSを選択すると、キャリッジ・リターンと改行で区切られた行が含まれるファイルが生成されます。

4. 「新しい所有者」から、オプションで別の所有者を選択します。デフォルトでは、アプリケーションはアプリケーション属性の所有者で識別される所有者が所有します。

5. 「新しいビルド・ステータス」から、次のいずれかの項目を選択します。

- アプリケーションの実行のみ: 開発者は、アプリケーションの実行のみができます。

- アプリケーションの実行および構築: 開発者は、アプリケーションを実行および編集できます。

「アプリケーションの実行のみ」の選択は、他の開発者がアプリケーションを変更できないようにするために効果的な方法です。

ヒント:
「アプリケーションの実行のみ」を選択した場合は、引数p_traceをYesに設定できません。詳細は、「ビルド・オプションを使用した構成の制御」を参照してください。また、アプリケーションのインポート後にこの設定を変更する方法は、Oracle Application Express管理サービスにログインする以外ありません。Oracle Application Express管理ガイドの「デプロイ時のアプリケーションのビルド・ステータス・セットの変更」を参照してください。

6. 「デバッグ」から、次のいずれかの項目を選択します。

- はい: デバッグが有効な状態でアプリケーションがエクスポートされます。

- いいえ: デバッグが無効な状態でアプリケーションがエクスポートされます。

7. 「サポートするオブジェクトの定義をエクスポート」から、アプリケーションと共にサポートするオブジェクトの定義をエクスポートするかどうかを指定します。選択可能なオプションについては、「パッケージ・アプリケーションの作成方法」を参照してください。

8. 「コメントのエクスポート」から、このアプリケーションに対するコメントをエクスポートするかどうかを指定します。「開発者コメントの追加」を参照してください。

9. 事前に定義されたとおりにアプリケーションをエクスポートするには、「現在から」フィールドを使用します。表示されるフィールドに、時間を分単位で指定します。
このユーティリティは、DBMS_FLASHBACKパッケージを使用します。システム変更番号(SCN)マッピングへのタイムスタンプが約5分ごとにリフレッシュされるため、検索しているバージョンの検出にはそれと同じ時間がかかる場合があります。元に戻す情報が保持される時間は、起動パラメータUNDO_RETENTION(デフォルトは3時間)に影響されます。ただし、このパラメータはUNDO表領域のサイズにのみ影響します。2つのデータベースに同じUNDO_RETENTIONパラメータが含まれている場合でも、トランザクション数が少ないデータベースでは、UNDO表領域が一杯ではなく、以前のデータが強制的にアーカイブされるため、より前の時点に戻ることができます。

10. 「アプリケーションのエクスポート」をクリックします。

実際のアプリケーション・ファイルをエクスポートするのみでなく、カスケード・スタイルシート、イメージ、スクリプト・ファイルなど、その他の関連ファイルもエクスポートする必要がある場合があります。

関連項目:
「SQLトレースの有効化およびTKPROFの使用」

ワークスペース・ユーザーのエクスポート

ワークスペース・ユーザーを作成すると、他のユーザーに使用可能なアプリケーションを作成できます。ワークスペース・ユーザーをエクスポートすると、Oracle Application Expressは、ユーザーおよびすべての定義されたユーザー・グループのASCIIテキストのSQLスクリプトを作成します。

ワークスペース・ユーザーをエクスポートするには、次のステップを実行します。

1. エクスポート・ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「エクスポート/インポート」をクリックします。

4. エクスポート/インポート・ページで、「エクスポート」をクリックしてから「次へ」をクリックします。

2. エクスポート・ページで、「ワークスペース・ユーザー」タブをクリックします。

3. 「ファイル形式」から、エクスポート・ファイルの行を形式化する方法を選択します。

- UNIXを選択すると、改行で区切られた行が含まれるファイルが生成されます。

- DOSを選択すると、キャリッジ・リターンと改行で区切られた行が含まれるファイルが生成されます。

4. 「ワークスペース・ユーザーのエクスポート」をクリックします。

関連項目:
『Oracle Application Express管理ガイド』の「Application Expressユーザーの管理」

アプリケーション・コンポーネントのエクスポート

コンポーネントのエクスポート・ページ上のページの共有コンポーネントまたはコンポーネントをエクスポートできます。このウィザードを使用して次のことを実行できます。

- 別のアプリケーションまたはワークスペースへの共有コンポーネントまたはページ・コンポーネントのエクスポート

- コンポーネントの編集前のバックアップ

- 別のOracle Application Expressインスタンスへのパッチとして機能するエクスポートの作成

関連項目:
「アプリケーションのエクスポート」、「アプリケーションのページのエクスポート」、「アプリケーションまたはページのインポート」および「ビルド・オプションまたはビルド・オプション・ステータスのエクスポート」

共有コンポーネントまたはページ・コンポーネントをエクスポートするには、次のステップを実行します。

1. コンポーネントのエクスポート・ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「タスク」リストから「アプリケーション・コンポーネントのエクスポート」をクリックします。
「コンポーネントのエクスポート」ページが表示されます。

2. 次のタブをクリックして、エクスポートするコンポーネントを選択します。

- 「コンポーネント」には、共有アプリケーション・コンポーネントおよびページ全体が表示されます。ページ上部のナビゲーション・バーを使用してコンポーネントを検索します。「共有コンポーネントを使用する機能」および「ビルド・オプションまたはビルド・オプション・ステータスのエクスポート」を参照してください。

- 「ページ別のコンポーネント」には、選択したページのコンポーネントがリストされます。ページから選択して特定のページにナビゲートします。「Check All」をクリックして、すべてのコンポーネントを選択します。

- アプリケーション属性には、アプリケーション属性が表示されます。CTRLキーまたはSHIFTキーを押して、複数の属性を選択します。「定義ページの編集について」を参照してください。

- 「ビルド・オプションのステータス」には、使用可能なビルド・オプションが表示されます。このページを使用してビルド・オプションを選択および選択解除します。「ビルド・オプションまたはビルド・オプション・ステータスのエクスポート」を参照してください。

3. 「エクスポートに追加」をクリックします。

4. 「次へ」をクリックします。

5. エクスポートするコンポーネントに対して、次のステップを実行します。

1. 「ファイル形式」から、エクスポート・ファイルの行を形式化する方法を選択します。

- UNIXを選択すると、改行で区切られた行が含まれるファイルが生成されます。

- DOSを選択すると、キャリッジ・リターンと改行で区切られた行が含まれるファイルが生成されます。

2. 事前に定義されたとおりにページをエクスポートするには、「現在から」フィールドを使用します。表示されるフィールドに、時間を分単位で指定します。
このユーティリティは、DBMS_FLASHBACKパッケージを使用します。システム変更番号(SCN)マッピングへのタイムスタンプが約5分ごとにリフレッシュされるため、検索しているバージョンの検出にはそれと同じ時間がかかる場合があります。元に戻す情報が保持される時間は、起動パラメータUNDO_RETENTION(デフォルトは3時間)に影響されます。ただし、このパラメータはUNDO表領域のサイズにのみ影響します。2つのデータベースに同じUNDO_RETENTIONパラメータが含まれている場合でも、トランザクション数が少ないデータベースでは、UNDO表領域が一杯ではなく、以前のデータが強制的にアーカイブされるため、より前の時点に戻ることができます。

3. 「コンポーネントのエクスポート」をクリックします。

アプリケーションのページのエクスポート

ページ定義で「ページのエクスポート」アイコンをクリックすると、アプリケーション内の特定のページをエクスポートすることもできます。ページのエクスポート時に、エクスポートされるページが同じアプリケーションIDとワークスペースIDを持っている場合のみ正常にインポートされることを覚えておいてください。

関連項目:
「アプリケーション・コンポーネントのエクスポート」、「アプリケーションのエクスポート」および「アプリケーションまたはページのインポート」

アプリケーションのページをエクスポートするには、次のステップを実行します。

1. 該当するページ定義にナビゲートします。「ページ定義へのアクセス」を参照してください。

2. ページ定義には、次の2つの方法でエクスポートできます。

- 右上隅にある下向き矢印の「ページのエクスポート」アイコンをクリックします。

- 「ビュー」リストから「エクスポート」を選択し、「実行」をクリックします。

ページのエクスポート・ウィザードが表示されます。

3. 「ページ」で、エクスポートするテーマを選択します。

4. 「ファイル形式」から、エクスポート・ファイルの行を形式化する方法を選択します。

- UNIXを選択すると、改行で区切られた行が含まれるファイルが生成されます。

- DOSを選択すると、キャリッジ・リターンと改行で区切られた行が含まれるファイルが生成されます。

5. 事前に定義されたとおりにページをエクスポートするには、「現在から」フィールドを使用します。表示されるフィールドに、時間を分単位で指定します。
このユーティリティは、DBMS_FLASHBACKパッケージを使用します。システム変更番号(SCN)マッピングへのタイムスタンプが約5分ごとにリフレッシュされるため、検索しているバージョンの検出にはそれと同じ時間がかかる場合があります。元に戻す情報が保持される時間は、起動パラメータUNDO_RETENTION(デフォルトは3時間)に影響されます。ただし、このパラメータはUNDO表領域のサイズにのみ影響します。2つのデータベースに同じUNDO_RETENTIONパラメータが含まれている場合でも、トランザクション数が少ないデータベースでは、UNDO表領域が一杯ではなく、以前のデータが強制的にアーカイブされるため、より前の時点に戻ることができます。

6. 「ページのエクスポート」をクリックします。

カスケード・スタイルシートのエクスポート

エクスポート・カスケード・スタイルシート・ユーティリティを使用して、アップロードしたカスケード・スタイルシートをエクスポートできます。このユーティリティを使用して、アップロードしたカスケード・スタイルシートのみエクスポートできることに注意してください。

関連するカスケード・スタイルシートをエクスポートするには、次のステップを実行します。

1. エクスポート・ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「エクスポート/インポート」をクリックします。

4. エクスポート/インポート・ページで、「エクスポート」をクリックしてから「次へ」をクリックします。

2. ページ上部の「CSS」タブをクリックします。

3. カスケード・スタイルシートのエクスポート・ページで、次の内容を選択します。

1. スタイルシート: エクスポートするカスケード・スタイルシートを選択します。

2. ファイル形式 - エクスポート・ファイルの行の形式を次のように選択します。

- UNIXを選択すると、改行で区切られた行が含まれるファイルが生成されます。

- DOSを選択すると、キャリッジ・リターンと改行で区切られた行が含まれるファイルが生成されます。

3. 「スタイルシートのエクスポート」をクリックします。

関連項目:
「カスケード・スタイルシートのインポート」および「カスタム・カスケード・スタイルシートの使用」

イメージのエクスポート

エクスポート・イメージ・ユーティリティを使用して、アップロードしたイメージをエクスポートできます。このユーティリティを使用してイメージをエクスポートする場合、イメージはテキスト・ドキュメントに変換されます。このユーティリティを使用してアップロードしたイメージのみエクスポートできることに注意してください。

アップロードしたイメージをエクスポートするには、次のステップを実行します。

1. エクスポート・ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「エクスポート/インポート」をクリックします。

4. エクスポート/インポート・ページで、「エクスポート」をクリックしてから「次へ」をクリックします。

2. ページ上部の「イメージ」タブをクリックします。

3. イメージのエクスポート・ページで、次の内容を選択します。

1. 次のアプリケーションのイメージをエクスポート: イメージのエクスポート元のアプリケーションを選択します。
「ワークスペース・イメージ」を選択した場合、特定のアプリケーションに関連付けられていないリポジトリ内のイメージのみがエクスポートされることに注意してください。すべてのイメージが特定のアプリケーションに関連付けられている場合、ワークスペース・イメージのエクスポート・ファイルは空になります。

2. ファイル形式 - エクスポート・ファイルの行の形式を次のように選択します。

- UNIXを選択すると、改行で区切られた行が含まれるファイルが生成されます。

- DOSを選択すると、キャリッジ・リターンと改行で区切られた行が含まれるファイルが生成されます。

4. 「イメージのエクスポート」をクリックします。

関連項目:
「イメージのインポート」、「イメージの管理」および「イメージ・ファインダの使用」

静的ファイルのエクスポート

静的ファイルのエクスポート・ユーティリティを使用して、インポートした静的ファイルをエクスポートできます。このユーティリティを使用して、アップロードした静的ファイルのみエクスポートできることに注意してください。

関連する静的ファイルをエクスポートするには、次のステップを実行します。

1. エクスポート・ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「エクスポート/インポート」をクリックします。

4. エクスポート/インポート・ページで、「エクスポート」をクリックしてから「次へ」をクリックします。

2. ページ上部の「ファイル」タブをクリックします。

3. 「静的ファイルのエクスポート」で、次の内容を選択します。

1. 静的ファイル - エクスポートするファイルを選択します。

2. ファイル形式 - エクスポート・ファイルの行の形式を次のように選択します。

- UNIXを選択すると、改行で区切られた行が含まれるファイルが生成されます。

- DOSを選択すると、キャリッジ・リターンと改行で区切られた行が含まれるファイルが生成されます。

3. 「ファイルのエクスポート」をクリックします。

別のOracle Application Expressインスタンスへのインポートについて

このセクションで説明したWebインタフェースを使用して、エクスポートした静的ファイルを別のOracle Application Expressインスタンスにインポートできないことに注意してください。静的ファイルを別のOracle Application Expressインスタンスをインポートするには、データベースに接続してSQL*Plusを使用します。同じ名前とワークスペースIDを持つワークスペースからエクスポートおよびワークスペースにエクスポートする必要があることに注意してください。

スクリプト・ファイルのエクスポート

エクスポートおよびインポート・タスクを使用して、選択したスクリプトを現行のスクリプト・リポジトリから別のワークスペース内のスクリプト・リポジトリに送信できます。

スクリプト・ファイルをエクスポートするには、次のステップを実行します。

1. ワークスペース・ホームページで、「SQLワークショップ」アイコンをクリックします。

2. 「SQLスクリプト」をクリックします。

3. 「タスク」リストで、「エクスポート」をクリックします。

4. 適切なスクリプト・ファイルを選択し、「エクスポートに追加」をクリックします。

5. ファイル名を確認し、「すべてのエクスポート」をクリックします。
スクリプトを削除するには、「削除」チェック・ボックスを選択します。

関連項目:
Oracle Application Express SQLワークショップおよびユーティリティ・ガイドの「SQLスクリプトの使用」

テーマのエクスポート

テーマのエクスポート・ユーティリティを使用して、Oracle Application Expressの1つの開発インスタンスからファイルにテーマをエクスポートします。

関連項目:
「テーマのインポート」および「テーマの管理」

エクスポート・ページからのテーマのエクスポート

エクスポート・ページからアプリケーション・テーマをエクスポートするには、次のステップを実行します。

1. エクスポート・ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「エクスポート/インポート」をクリックします。

4. エクスポート/インポート・ページで、「エクスポート」をクリックしてから「次へ」をクリックします。

2. ページ上部の「テーマ」をクリックします。

3. アプリケーション・テーマのエクスポート・ページで、次の内容を選択します。

1. テーマのエクスポート - エクスポートするテーマを選択します。

2. ファイル形式 - エクスポート・ファイルの行の形式を次のように選択します。

- UNIXを選択すると、改行で区切られた行が含まれるファイルが生成されます。

- DOSを選択すると、キャリッジ・リターンと改行で区切られた行が含まれるファイルが生成されます。

3. 「テーマのエクスポート」をクリックします。

テーマ・ページからのテーマのエクスポート

テーマ・ページからアプリケーション・テーマをエクスポートするには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

4. 「ユーザー・インタフェース」で、「テーマ」を選択します。
テーマ・ページが表示されます。

5. 「タスク」リストで、「テーマのエクスポート」をクリックします。
エクスポート・ページが表示されます。

6. テーマのエクスポート・ページで、次の内容を選択します。

1. テーマのエクスポート - エクスポートするテーマを選択します。

2. ファイル形式 - エクスポート・ファイルの行の形式を次のように選択します。

- UNIXを選択すると、改行で区切られた行が含まれるファイルが生成されます。

- DOSを選択すると、キャリッジ・リターンと改行で区切られた行が含まれるファイルが生成されます。

3. 「テーマのエクスポート」をクリックします。

ユーザー・インタフェースのデフォルト値のエクスポート

ユーザー・インタフェースのデフォルト値のエクスポートは、ターゲット・システムでの開発を予定している場合に便利です。

ユーザー・インタフェースのデフォルト値をエクスポートする場合は、選択したスキーマに対するすべてのユーザー・インタフェースのデフォルト値が、1つのSQLコマンド・スクリプトにエクスポートされます。プロンプトが表示されたら、このファイルをハードディスク・ドライブに保存してください。このファイルには、アプリケーションのPL/SQL APIをコールして表のヒントを作成するAPIコールが含まれています。このファイルを使用して、ユーザー・インタフェースのデフォルト値を別のデータベースおよびOracle Application Expressインスタンスにインポートできます。

関連項目:
「ユーザー・インタフェースのデフォルト値のインポート」および「ユーザー・インタフェースのデフォルト値の管理」

エクスポート・ページからのユーザー・インタフェースのデフォルト値のエクスポート

エクスポート・ページからユーザー・インタフェースのデフォルト値をエクスポートするには、次のステップを実行します。

1. エクスポート・ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「エクスポート/インポート」をクリックします。

4. エクスポート/インポート・ページで、「エクスポート」をクリックしてから「次へ」をクリックします。

2. ページ上部の「ユーザー・インタフェースのデフォルト値」タブをクリックします。

3. ユーザー・インタフェースのデフォルト値のエクスポート・ページで、次の内容を選択します。

1. スキーマ: ユーザー・インタフェースのデフォルト値に関連付けられた表を所有するスキーマを選択します。

2. ファイル形式 - エクスポート・ファイルの行の形式を次のように選択します。

- UNIXを選択すると、改行で区切られた行が含まれるファイルが生成されます。

- DOSを選択すると、キャリッジ・リターンと改行で区切られた行が含まれるファイルが生成されます。

3. 「ユーザー・インタフェースのデフォルト値のエクスポート」をクリックします。

ユーザー・インタフェースのデフォルト値ページからのユーザー・インタフェースのデフォルト値のエクスポート

ユーザー・インタフェースのデフォルト値ページからユーザー・インタフェースのデフォルト値をエクスポートするには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. アプリケーション・ビルダーのホームページで、「共有コンポーネント」をクリックします。

4. 「ユーザー・インタフェース」で、「ユーザー・インタフェースのデフォルト値」を選択します。
ユーザー・インタフェースのデフォルト値ページが表示されます。

5. 「タスク」リストから「エクスポート」をクリックします。

6. ユーザー・インタフェースのデフォルト値のエクスポート・ページで、次の内容を選択します。

1. スキーマ: ユーザー・インタフェースのデフォルト値に関連付けられた表を所有するスキーマを選択します。

2. ファイル形式 - エクスポート・ファイルの行の形式を次のように選択します。

- UNIXを選択すると、改行で区切られた行が含まれるファイルが生成されます。

- DOSを選択すると、キャリッジ・リターンと改行で区切られた行が含まれるファイルが生成されます。

3. 「ユーザー・インタフェースのデフォルト値のエクスポート」をクリックします。

イメージ、CSSおよびスクリプト・ファイルの格納先

実行時、Oracle Application Expressは、Oracle HTTP Serverとmod_plsql、または埋込みPL/SQLゲートウェイにアクセスする必要があります。イメージ、CSSおよびスクリプト・ファイルの格納先は、選択したHTTPサーバーによって異なります。

この項には、次の項目が含まれます。

- Oracle HTTP Serverを使用する場合のイメージ、CSSおよびスクリプト・ファイルの格納先

- 埋込みPL/SQLゲートウェイを使用する場合のイメージ、CSSおよびスクリプト・ファイルの格納先

Oracle HTTP Serverを使用する場合のイメージ、CSSおよびスクリプト・ファイルの格納先

Oracle HTTP ServerまたはOracle Application Serverの構成では、イメージは別名/i/による参照先のファイル・システムに格納されます。ファイル・システムで直接イメージを検出するには、次のファイルを参照して、テキスト別名/i/を検索してください。

- Oracle9i HTTP Server リリース2の場合: httpd.confファイルを確認します。

- Oracle Database 11gで配布されたOracle HTTP Serverの場合: dads.confファイルを確認します。

- Oracle Application Server 10gの場合: marvel.confファイルを参照します。

テキスト別名/i/を検出するための例は、Oracle Application Expressインストレーション・ガイドを参照してください。

埋込みPL/SQLゲートウェイを使用する場合のイメージ、CSSおよびスクリプト・ファイルの格納先

埋込みPL/SQLゲートウェイを使用してOracle Application Expressを実行する場合、イメージは、Oracle XML DBリポジトリ内のデータベースに直接格納されます。イメージには、Oracle XML DBのWebDAV機能またはFTPを使用してアクセスできます。詳細は、『Oracle XML DB開発者ガイド』のプロトコルによるリポジトリへのアクセスに関する説明を参照してください。

エクスポート・ファイルのインポート

アプリケーションとすべての関連ファイルをエクスポートしたら、それらをターゲットのOracle Application Expressインスタンスにインポートしてからインストールする必要があります。一般的に、常にアプリケーションをインポートしてから関連ファイルをインポートします。「別の開発インスタンスへのアプリケーションの移動方法」を参照してください。

ヒント:
パッケージ・アプリケーションを作成すると、アプリケーションのデプロイに必要なステップを単純化できます。「パッケージ・アプリケーションの作成方法」を参照してください。

この項には、次の項目が含まれます。

- アプリケーションまたはページのインポート

- カスケード・スタイルシートのインポート

- イメージのインポート

- テーマのインポート

- ユーザー・インタフェースのデフォルト値のインポート

アプリケーションまたはページのインポート

アプリケーションまたはページのエクスポートをターゲットのOracle Application Expressインスタンスにインポートするには、次のステップを実行します。

1. 次のように、インポート・ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「エクスポート/インポート」をクリックします。

4. エクスポート/インポート・ページで、「インポート」をクリックしてから「次へ」をクリックします。

2. 「ファイルの指定」で、次の項目を指定します。

1. ファイルのインポート - 「参照」をクリックして、ファイルにナビゲートします。

2. 「ファイル・タイプ」で、「アプリケーション、ページまたはコンポーネントのエクスポート」を選択します。

3. ファイルのキャラクタ・セットが正しいことを確認します。

4. 「次へ」をクリックします。

ファイルをインポートすると、ファイルをインストールするオプションが含まれています。

3. インポートしたファイルをインストールするには、「次へ」をクリックします。
アプリケーションのインストール・ウィザードが表示されます。

4. アプリケーションのインストール・ウィザードでは、次の内容を指定します。

1. 解析対象スキーマ: スキーマを選択します。
これが、アプリケーションのすべてのSQLおよびPL/SQLの解析対象となるスキーマです。

2. ビルド・ステータス: 次のいずれかの項目を選択します。

- アプリケーションの実行のみ: ユーザーはアプリケーションの実行のみ可能です。

- アプリケーションの実行および構築: ユーザーはアプリケーションの実行を、開発者はアプリケーションの実行および編集を行うことができます。

「アプリケーションの実行のみ」の選択は、他の開発者がアプリケーションを変更できないようにするために効果的な方法です。

ヒント:
「アプリケーションの実行のみ」を選択する場合、アプリケーションのインポート後にこの設定を変更する方法は、Oracle Application Express管理サービスにログインする以外ありません。Oracle Application Express管理ガイドの「デプロイ時のアプリケーションのビルド・ステータス・セットの変更」を参照してください。

3. 次のアプリケーションとしてインストール: 次のいずれかの項目を選択します。

- 新しいアプリケーションIDを自動割当て

- エクスポート・ファイルからアプリケーションIDを再利用

- アプリケーションIDの変更

これらのオプションは、アプリケーションIDの競合を回避するために使用します。これらのオプションは、同じインスタンスに同じアプリケーションの2つのバージョンをインストールする場合に役立ちます。たとえば、本番インスタンスにアプリケーションを移行しているが、まだ開発バージョンを保持する必要がある場合などです。

4. 「インストール」をクリックします。
パッケージ・アプリケーション(サポートするオブジェクトを定義したアプリケーション)をインストールしている場合、インストーラはパッケージ・インストール・スクリプトをインストールするよう要求します。画面に表示されるステップに従います。

関連項目:
「パッケージ・アプリケーションの作成方法」

アプリケーション・グループのインポートについて

アプリケーション・グループはアプリケーションとともにエクスポートされます。アプリケーションのエクスポートには、グループID、名前およびコメントが含まれます。アプリケーションをインポートするときは、次のルールに従ってアプリケーションのインポートが行われます。

- インポートの際、アプリケーションはIDが一致すれば既存のグループを使用します。

- ターゲット・マシン上に同じIDを持つアプリケーション・グループが存在しない場合は、アプリケーションのインポートで同じ名前を持つ別のグループIDが検索されます。名前の一致が検出されたら、このアプリケーション・グループ名に応じたIDを使用してアプリケーションがインポートされます。

- ターゲット・マシンの既存のアプリケーション・グループとIDも名前も一致しない場合、新しいアプリケーション・グループが作成されます。新しいアプリケーション・グループは、IDがOracle Application Expressインスタンスで使用されていない場合、そのアプリケーション・グループIDを使用します。グループIDが使用されている場合、新しいIDが生成されます。

カスケード・スタイルシートのインポート

アプリケーションをターゲットのOracle Application Expressインスタンスにインポートした後に、すべての関連ファイルをインポートする必要があります。

CSSのエクスポート・ファイルをインポートするには、次のステップを実行します。

1. 次のように、インポート・ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「エクスポート/インポート」をクリックします。

4. エクスポート/インポート・ページで、「インポート」をクリックしてから「次へ」をクリックします。

2. 「ファイルの指定」で、次の内容を指定します。

1. ファイルのインポート - 「参照」をクリックして、ファイルにナビゲートします。

2. ファイル・タイプ: 「CSSのエクスポート」を選択します。

3. ファイルのキャラクタ・セット: ファイルのキャラクタ・セットが正しいことを確認します。

4. 「次へ」をクリックします。

ファイルをインポートすると、ファイルをインストールするオプションが含まれています。

3. インポートしたファイルをインストールするには、「次へ」をクリックします。

4. 「CSSのインストール」をクリックします。

関連項目:
「カスタム・カスケード・スタイルシートの使用」および「カスケード・スタイルシートのエクスポート」

静的ファイルのインポート

アプリケーションをターゲットのOracle Application Expressインスタンスにインポートした後に、すべての関連ファイルをインポートする必要があります。

静的ファイルをインポートするには、次のステップを実行します。

1. 次のように、インポート・ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「エクスポート/インポート」をクリックします。

4. エクスポート/インポート・ページで、「インポート」をクリックしてから「次へ」をクリックします。

2. 「ファイルの指定」で、次の内容を指定します。

1. ファイルのインポート - 「参照」をクリックして、ファイルにナビゲートします。

2. ファイル・タイプ: 「エクスポート済のファイル」を選択します。

3. ファイルのキャラクタ・セット: ファイルのキャラクタ・セットが正しいことを確認します。

4. 「次へ」をクリックします。

ファイルをインポートすると、ファイルをインストールするオプションが含まれています。

3. インポートしたファイルをインストールするには、「次へ」をクリックします。

4. 「静的ファイルのインストール」をクリックします。

関連項目:
「静的ファイルのエクスポート」

イメージのインポート

アプリケーションをターゲットのOracle Application Expressインスタンスにインポートした後に、すべての関連ファイルをインポートする必要があります。

イメージのエクスポート・ファイルをインポートするには、次のステップを実行します。

1. 次のように、インポート・ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「エクスポート/インポート」をクリックします。

4. エクスポート/インポート・ページで、「インポート」をクリックしてから「次へ」をクリックします。

2. 「定義のインポート」で、次の内容を選択します。

1. ファイルのインポート - 「参照」をクリックして、ファイルにナビゲートします。

2. ファイル・タイプ: 「イメージのエクスポート」を選択します。

3. ファイルのキャラクタ・セット: ファイルのキャラクタ・セットが正しいことを確認します。

4. 「次へ」をクリックします。

ファイルをインポートすると、ファイルをインストールするオプションが含まれています。

3. インポートしたファイルをインストールするには、「次へ」をクリックします。

4. 「イメージのインストール」をクリックします。

関連項目:
「イメージの管理」、「イメージ・ファインダの使用」および「イメージのエクスポート」

テーマのインポート

アプリケーションをターゲットのOracle Application Expressインスタンスにインポートした後に、すべての関連ファイルをインポートする必要があります。

テーマのエクスポート・ファイルをインポートするには、次のステップを実行します。

1. 次のように、インポート・ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「エクスポート/インポート」をクリックします。

4. エクスポート/インポート・ページで、「インポート」をクリックしてから「次へ」をクリックします。

2. 「定義のインポート」で、次の内容を選択します。

1. ファイルのインポート - 「参照」をクリックして、ファイルにナビゲートします。

2. ファイル・タイプ: 「エクスポート済のテーマ」を選択します。

3. ファイルのキャラクタ・セット: ファイルのキャラクタ・セットが正しいことを確認します。

4. 「次へ」をクリックします。

ファイルをインポートすると、ファイルをインストールするオプションが含まれています。

3. インポートしたファイルをインストールするには、「次へ」をクリックします。

4. 「テーマのインストール」をクリックします。

関連項目:
「テーマの管理」および「テーマのエクスポート」

ユーザー・インタフェースのデフォルト値のインポート

ユーザー・インタフェースのデフォルト値を使用して、指定したスキーマ内の表、列またはビューにデフォルトのユーザー・インタフェースのプロパティを割り当てることができます。

アプリケーションをターゲットのOracle Application Expressインスタンスにインポートした後に、すべての関連ファイルをインポートする必要があります。

ユーザー・インタフェースのデフォルト値をインポートするには、次のステップを実行します。

1. 次のように、インポート・ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「エクスポート/インポート」をクリックします。

4. エクスポート/インポート・ページで、「インポート」をクリックしてから「次へ」をクリックします。

2. アプリケーションを選択します。

3. 「定義のインポート」で、次の内容を選択します。

1. ファイルのインポート - 「参照」をクリックして、ファイルにナビゲートします。

2. ファイル・タイプ: 「ユーザー・インタフェースのデフォルト値」を選択します。

3. ファイルのキャラクタ・セット: ファイルのキャラクタ・セットが正しいことを確認します。

4. 「次へ」をクリックします。

ファイルをインポートすると、ファイルをインストールするオプションが含まれています。

4. インポートしたファイルをインストールするには、「次へ」をクリックします。

5. 「ユーザー・インタフェースのデフォルト値のインストール」をクリックします。

関連項目:
「ユーザー・インタフェースのデフォルト値の管理」および「ユーザー・インタフェースのデフォルト値のエクスポート」

エクスポート・ファイルのインストール

アプリケーションおよびすべての関連ファイルをターゲットのOracle Application Expressインスタンスにインポートすると、ファイルはエクスポート・リポジトリに格納されます。次に、そのファイルをインストールする必要があります。

次のようにエクスポート・ファイルをインストールできます。

- エクスポート・ファイルをインポートしたら、「インストール」ボタンをクリックして、画面に表示されるステップに従います。

- エクスポート・ファイルをアプリケーション・ビルダーにインポートした後、エクスポート・リポジトリからファイルをインストールします。

- エクスポート・ファイルをSQL*Plusからインストールします。

ヒント:
パッケージ・アプリケーションを作成すると、アプリケーションのデプロイに必要なステップを単純化できます。「パッケージ・アプリケーションの作成方法」を参照してください。

この項には、次の項目が含まれます。

- エクスポート・リポジトリへのアクセス

- エクスポート・リポジトリからのアプリケーション・エクスポートのインストール

- エクスポート・リポジトリからのその他ファイルのインストール

- エクスポート・リポジトリからのファイルの削除

- SQL*Plusからのエクスポート・ファイルのインストール

エクスポート・リポジトリへのアクセス

アプリケーションおよびすべての関連ファイルをターゲットのOracle Application Expressインスタンスにインポートすると、ファイルはエクスポート・リポジトリに格納されます。

エクスポート・リポジトリにアクセスするには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「タスク」リストで、「エクスポート・リポジトリの管理」をクリックします。
「エクスポート・リポジトリ」が表示されます。

ヒント:
また、アプリケーションのホームページまたはアプリケーション・ビルダーのホームページのいずれかの「タスク」リストの「エクスポート・リポジトリ」をクリックして、「エクスポート・リポジトリ」にアクセスすることも可能です。

エクスポート・リポジトリからのアプリケーション・エクスポートのインストール

Oracle Application Expressインスタンスにアプリケーション・エクスポートをインポートした後に、そのファイルがアプリケーション・ビルダーでアクティブまたは使用可能になる前にインストールする必要があります。

エクスポート・リポジトリからアプリケーション・エクスポートをインストールするには、次のステップを実行します。

1. エクスポート・リポジトリにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「タスク」リストで、「エクスポート・リポジトリの管理」をクリックします。
「エクスポート・リポジトリ」が表示されます。

2. アプリケーション・エクスポートを選択して、「アクション」列で「インストール」をクリックします。

3. 次の項目を指定します。

1. 解析対象スキーマ: スキーマを選択します。
これが、アプリケーションのすべてのSQLおよびPL/SQLの解析対象となるスキーマです。

2. ビルド・ステータス: 次のいずれかの項目を選択します。

- アプリケーションの実行のみ

- アプリケーションの実行および構築

ターゲット・インスタンスでアプリケーションを実行し、開発者がアクセスできないようにするには、「Run Application Only」を選択します。

ヒント:
「アプリケーションの実行のみ」を選択する場合、アプリケーションのインポート後にこの設定を変更する方法は、Oracle Application Express管理サービスにログインする以外ありません。Oracle Application Express管理ガイドの「デプロイ時のアプリケーションのビルド・ステータス・セットの変更」を参照してください。

3. 次のアプリケーションとしてインストール: 次のいずれかの項目を選択します。

- エクスポート・ファイルからアプリケーションIDを再利用

- 新しいアプリケーションIDを自動割当て

- アプリケーションIDの変更

これらのオプションは、アプリケーションIDの競合を回避するために使用します。これらのオプションは、同じインスタンスに同じアプリケーションの2つのバージョンをインストールする必要がある場合に使用します。たとえば、本番インスタンスにアプリケーションを移行しているが、まだ開発バージョンを保持する必要がある場合などです。

4. 「インストール」をクリックします。

パッケージ・アプリケーションのインストールについて

パッケージ・アプリケーションをインストールしている場合、インストーラはパッケージ・インストール・スクリプトをインストールするよう要求します。画面に表示されるステップに従います。

関連項目:
「パッケージ・アプリケーションの作成方法」

エクスポート・リポジトリからのその他ファイルのインストール

Oracle Application Expressインスタンスにファイルをインポートした後、そのファイルがアプリケーション・ビルダーでアクティブまたは使用可能になる前にインストールする必要があります。

エクスポート・リポジトリに格納されたファイルをインストールするには、次のステップを実行します。

1. エクスポート・リポジトリにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「タスク」リストで、「エクスポート・リポジトリの管理」をクリックします。
「エクスポート・リポジトリ」が表示されます。

2. インストールするファイルを選択して、「アクション」列で「インストール」をクリックします。

3. 画面に表示されるステップに従って、「インストール」ボタンをクリックします。

エクスポート・リポジトリからのファイルの削除

エクスポート・リポジトリからファイルを削除できます。

エクスポート・リポジトリからファイルを削除するには、次のステップを実行します。

1. エクスポート・リポジトリにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「タスク」リストで、「エクスポート・リポジトリの管理」をクリックします。
「エクスポート・リポジトリ」が表示されます。

2. 削除するファイルを選択し、「チェックした項目の削除」をクリックします。

SQL*Plusからのエクスポート・ファイルのインストール

エクスポート・ファイルはSQL*Plusからもインストールできます。次の2つの制限があることに注意してください。

- エクスポート・ファイルは、インストール先と同じユーザー・データベース・アカウントで作成されている必要があります。

- エクスポート・ファイルがアプリケーションの場合は、アプリケーションIDが上書きされます。そのため、ターゲットワークスペースは、インストールするアプリケーションのIDを所有している必要があります。

- エクスポート・ファイルにサポートするオブジェクトのスクリプトが含まれる場合は、アプリケーションをインストールする際、スクリプトは実行されません。アプリケーション・ビルダーにログインしてサポートするオブジェクトをインストールするか、またはインストール・スクリプトをスタンドアロンSQL*Plusスクリプトにコピーしてそこからインストール・スクリプトを実行できます。

この項には、次の項目が含まれます。

- ソースワークスペースIDとターゲットワークスペースIDが同じであることの確認

- SQL*Plusを使用したエクスポート・ファイルのインストール

ソースワークスペースIDとターゲットワークスペースIDが同じであることの確認

SQLコマンド・プロセッサで問合せを実行すると、ソースワークスペースとターゲットワークスペースが同じであることを確認できます。

ソースワークスペースとターゲットワークスペースが同じであることを確認するには、次のステップを実行します。

1. ソースワークスペースにログインします。

2. 「ワークスペース」ホームページで「SQLワークショップ」アイコンをクリックします。

3. 「SQLコマンド」をクリックします。

4. SQLエディタ・ペインで次のとおり入力し、「実行」をクリックします。

SELECT &WORKSPACE_ID. FROM DUAL

5. ワークスペースIDを確認します。

6. ターゲットワークスペースにログインします。

7. ステップ2から5を繰り返し、ワークスペースIDが一致することを確認します。

SQL*Plusを使用したエクスポート・ファイルのインストール

Oracle Application Expressエクスポート・ファイルをSQL*Plusからインストールするには、次のステップを実行します。

1. SQL*Plusにログインします。

2. エクスポート・ファイルを実行します。
たとえば、エクスポート・ファイルの名前がデフォルトでf144.sqlの場合は、コマンド・プロンプトで@f144と入力します。

アプリケーションURLの公開について

アプリケーションのデプロイ、データのロードおよびユーザーの作成が終了すると、本番URLを公開できます。

アプリケーションのホームページの「実行」アイコンにマウスを置くことにより、アプリケーションへのURLを判別できます。URLがページの下部のステータス・バーに表示されます。

「実行」アイコンは、セキュリティ属性の編集ページのホーム・リンク属性から値を取得します。このリンクを参照するのは、このアイコンと、Oracle Application ExpressログインAPIを使用しないアプリケーションのみです。次に例を示します。

http://apex.somewhere.com/pls/apex/f?p=11563:1:3397731373043366363

説明:

- apex.somewhere.comは、サーバーのURLです。

- plsは、mod_plsqlカートリッジを使用するためのインジケータです。

- apexは、データベース・アクセス記述子(DAD)名です。DADはHTTPリクエストを実行できるようにOracle HTTP Serverがデータベース・サーバーに接続する方法を示します。デフォルト値はapexです。

- f?p=は、Oracle Application Expressによって使用される接頭辞です。

- 11563は、コールされるアプリケーションです。

- 1は、表示されるアプリケーション内のページです。

- 3397731373043366363は、セッション番号です。

このサンプル・アプリケーションを実行するには、次のURLを使用します。

http://apex.somewhere.com/pls/apex/f?p=11563:1

ユーザーはログイン時に一意のセッション番号を受信します。

関連項目:
「セキュリティ属性の編集ページへのアクセス」

ビルド・オプションを使用した構成の制御

ビルド・オプションを使用すると、アプリケーションで特定の機能を条件付きで表示できます。

ビルド・オプションは、INCLUDEおよびEXCLUDEという2つの値をとることができます。属性を含めるように指定すると、Application Expressエンジンは、実行時にその属性をアプリケーション定義の一部として認識します。逆に、属性を除外するように指定すると、Application Expressエンジンは、その属性を存在しないものとして処理します。

この項には、次の項目が含まれます。

- ビルド・オプションの作成

- ビルド・オプションの管理

- ビルド・オプションまたはビルド・オプション・ステータスのエクスポート

- ビルド・オプションの使用状況レポートの表示

関連項目:
Oracle Application Express管理ガイドの「デプロイ時のアプリケーションのビルド・ステータス・セットの変更」を参照してください。

ビルド・オプションの作成

ビルド・オプション・ページのアプリケーションに対してビルド・オプションを作成します。

ビルド・オプションを作成するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. アプリケーション・ビルダーのホームページで、「共有コンポーネント」をクリックします。

4. 「アプリケーション」で、「ビルド・オプション」をクリックします。

5. 新しいビルド・オプションを作成するには、「作成」をクリックします。

6. 画面に表示されるステップに従います。

「ビルド・オプション」ページについて

ビルド・オプションを作成すると、そのビルド・オプションはビルド・オプション・ページに表示されます。「ビュー」リストから選択して、ビルド・オプション・ページの表示方法を制御します。使用可能なオプションは次のとおりです。

- アイコン(デフォルト): 各ビルド・オプションを大きいアイコンとして表示されます。ビルド・オプションを編集するには、該当するアイコンをクリックします。

- 詳細: 各ビルド・オプションをレポートで1行に表示します。各行には、アプリケーションID、ビルド・オプション名、ステータスおよびビルド・オプションの使用状況レポートへのリンクが含まれています。ビルド・オプションを編集するには、該当する名前をクリックします。

ビルド・オプションの管理

ビルド・オプションは、INCLUDEおよびEXCLUDEという2つの値をとることができます。属性を含めるように指定すると、Application Expressエンジンは、実行時にその属性をアプリケーション定義の一部として認識します。逆に、属性を除外するように指定すると、Application Expressエンジンは、その属性を存在しないものとして処理します。

ビルド・オプションを含めるまたは除外するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. アプリケーション・ビルダーのホームページで、「共有コンポーネント」をクリックします。

4. 「アプリケーション」で、「ビルド・オプション」をクリックします。

5. 適切なビルド・オプションを選択します。
ビルド・オプションの作成/編集ページが表示されます。

6. 「ステータス」で、「INCLUDE」または「EXCLUDE」のいずれかを選択します。

ビルド・オプションの選択

ビルド・オプションを作成すると、ページ、コンポーネント(レポート、グラフまたはフォーム)、特定のページ・コントロール(ボタン・アイテム、LOV)、および別の共有コンポーネント(ブレッドクラム、リストまたはタブ)に対して選択できます。適切な属性ページに移動して、ビルド・オプションをページ、コンポーネント、ページ・コントロールまたは共有コンポーネントに適用します。ほとんどの属性ページには、定義済のビルド・オプションを選択できる「構成」セクションがあります。

関連項目:
「ページ属性の編集」

ビルド・オプションまたはビルド・オプション・ステータスのエクスポート

コンポーネントのエクスポート・ページで、ビルド・オプションまたはビルド・オプション・ステータスをエクスポートできます。ビルド・オプション・ステータスのエクスポートは、別の環境内でビルド・オプションをオンまたはオフに切り替えるために効果的な方法です。たとえば、この機能を使用して、隠し機能を備えた本番アプリケーションをデプロイできます。

これを行うには、隠し機能のあるコンポーネントとEXCLUDEのステータスを持つビルド・オプションを関連付けます。デプロイ後、ビルド・オプションのステータスをINCLUDEに変更して、ビルド・オプション・ステータスをエクスポートすると隠し機能を有効化できます。

ビルド・オプション・ステータスを本番インスタンスに適用すると、新しい機能が表示されます。

関連項目:
「パッケージ・アプリケーションの作成方法」および「アプリケーション・コンポーネントのエクスポート」

ビルド・オプションまたはビルド・オプション・ステータスをエクスポートするには、次のステップを実行します。

1. コンポーネントのエクスポート・ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「タスク」リストから「コンポーネントのエクスポート」をクリックします。
「コンポーネントのエクスポート」ページが表示されます。

2. エクスポートするビルド・オプションを次のように選択します。

1. 「コンポーネント」タブをクリックして、エクスポートするビルド・オプションを選択します。

2. 「エクスポートに追加」をクリックします。

3. 次のように、エクスポートする「ビルド・オプションのステータス」を選択します。

1. 「ビルド・オプションのステータス」タブをクリックして、エクスポートするビルド・オプションを選択します。

2. 「エクスポートに追加」をクリックします。

4. 「次へ」をクリックします。

5. エクスポートするコンポーネントに対して、次のステップを実行します。

1. 「ファイル形式」から、エクスポート・ファイルの行を形式化する方法を選択します。

- UNIXを選択すると、改行で区切られた行が含まれるファイルが生成されます。

- DOSを選択すると、キャリッジ・リターンと改行で区切られた行が含まれるファイルが生成されます。

2. 事前に定義されたとおりにページをエクスポートするには、「現在から」フィールドを使用します。表示されるフィールドに、時間を分単位で指定します。
このユーティリティは、DBMS_FLASHBACKパッケージを使用します。システム変更番号(SCN)マッピングへのタイムスタンプが約5分ごとにリフレッシュされるため、検索しているバージョンの検出にはそれと同じ時間がかかる場合があります。元に戻す情報が保持される時間は、起動パラメータUNDO_RETENTION(デフォルトは3時間)に影響されます。ただし、このパラメータはUNDO表領域のサイズにのみ影響します。2つのデータベースに同じUNDO_RETENTIONパラメータが含まれている場合でも、トランザクション数が少ないデータベースでは、UNDO表領域が一杯ではなく、以前のデータが強制的にアーカイブされるため、より前の時点に戻ることができます。

3. 「コンポーネントのエクスポート」をクリックします。

ビルド・オプションの使用状況レポートの表示

ビルド・オプションを作成すると、ビルド・オプション・ページに「使用状況」タブが表示されます。このレポートには、カレント・アプリケーションでのビルド・オプションの使用状況が詳述されます。

注意:
「使用状況」タブは、ビルド・オプションを作成した後のビルド・オプション・ページにのみ表示されます。

ビルド・オプションの使用状況レポートを表示するには、次のステップを実行します。

1. 「ビルド・オプション」ページにナビゲートします。

1. 「ワークスペース」ホームページにナビゲートします。

2. 「アプリケーション・ビルダー」アイコンをクリックします。

3. アプリケーションを選択します。

4. アプリケーション・ビルダーのホームページで、「共有コンポーネント」をクリックします。

5. 「アプリケーション」で、「ビルド・オプション」をクリックします。
ビルド・オプション・ページが表示されます。

2. ビルド・オプション・ページで、「使用状況」をクリックします。
ビルド・オプションの使用状況レポートが表示されます。

3. ビルド・オプションを選択して、「実行」をクリックします。

15 高度なプログラミング手法

このセクションでは、自動的なデータ操作言語を使用した作業、データベース・リンクの確立、コレクションの使用、バックグラウンドSQLの実行、Webサービスの使用、ユーザー・プリファレンスの管理など、高度なプログラミング手法について説明します。

この項には、次の項目が含まれます。

- DMLロックについて

- データベース・リンクを使用したデータへのアクセス

- アプリケーションからの電子メール送信

- コレクションの使用

- APEX_ACTIVITY_LOGを使用したカスタム・アクティビティ・レポートの作成

- バックグラウンドPL/SQLの実行

- Webサービスの実装

- フォームおよびレポートでのBLOBサポートについて

関連項目:
Oracle Application Express APIリファレンスおよび「アプリケーションのデプロイ」

DMLロックについて

自動的なデータ操作言語(DML)が表内の行を更新または削除するためにOracle Application Expressで使用される場合、トランザクションが開始されるとまず行をロックし、ページに表示されてから変更されたかどうかを確認して、最後に行に対するUPDATEまたはDELETE文を発行します。

行のロックが頻繁に発生する一部の環境では、DML操作を制御してDML操作が次の状態かどうかを判別する場合があります。

- 無期限に待機

- 即時に失敗

- 指定した一定時間待機

APEX_DML_LOCK_WAIT_TIMEについて

アプリケーション置換文字列、アプリケーション・アイテムまたはページ・アイテムの値をAPEX_DML_LOCK_WAIT_TIMEに設定すると、DML操作を制御できます。サポートされている値は次のとおりです。

- NULLの場合(デフォルト)、Oracle Application Expressの以前のバージョンと同じ動作、つまり、無期限に待機します。

- 0の場合、他のデータベース・セッションによって行がロックされていると、即時に失敗します。

- 0以上で行がロックされている場合、指定した秒数間待機します。

アプリケーションで設定する場合、APEX_DML_LOCK_WAIT_TIMEの値はアプリケーション全体の自動DMLを使用するすべてのUPDATEおよびDELETE DML操作に適用されます。特定の自動DMLプロセスを制御するには、自動DMLプロセスの前にAPEX_DML_LOCK_WAIT_TIMEの値を更新して、自動DMLプロセスの後にリセットします。これは、表形式フォームを使用した更新および削除には影響しないことに注意してください。

FSP_DML_LOCK_ROWについて

アプリケーション置換文字列、アプリケーション・アイテムまたはページ・アイテムの値をFSP_DML_LOCK_ROWに設定して、DML操作を制御することもできます。サポートされている値は次のとおりです。

- 値をFALSEに設定すると、SELECT FOR UPDATEは発行されません。

- 値がFALSE以外の場合は、自動DMLを使用してUPDATEまたはDELETE DML操作を発行すると、SELECT FOR UPDATEのデフォルトの動作が実行されます。

データベース・リンクを使用したデータへのアクセス

ワークスペースのホームページはOracle Database上で実行されるため、ユーザーは、すべての分散Oracle Database機能を使用できます。通常、分散データベース操作は、データベース・リンクを使用して実行します。

データベース・リンクは1つのデータベースのスキーマ・オブジェクトであり、これを使用すると、別のデータベース上のオブジェクトにアクセスできます。データベース・リンクを作成すると、表名またはビュー名に@dblinkを追加することによって、リモート・オブジェクトにアクセスできます。この場合のdblinkは、データベース・オブジェクトの作成ウィザードで指定するデータベース・リンク名です。

注意:
デフォルトでは、CREATE DATABASE LINKシステム権限は、割り当てられたワークスペースまたはデータベース・ユーザーに付与されません。この機能を使用するには、DBAまたは管理者が、この特定の権限をユーザーのワークスペースのデータベース・ユーザーに付与する必要があります。Oracle Database管理者ガイドの「データベース・リンクの作成」を参照してください。

データベース・リンクを作成するには、次のステップを実行します。

1. ワークスペースのホームページで、「SQLワークショップ」をクリックして、「オブジェクト・ブラウザ」をクリックします。
オブジェクト・ブラウザが表示されます。

2. 「作成」をクリックします。

3. 「データベース・リンク」を選択して、「次へ」をクリックします。

4. 画面に表示されるステップに従います。
データベース・リンク名は、Oracleのネーミング規則に従う必要があり、空白を含めたり、数字やアンダースコアから開始することはできません。

既存のデータベース・リンクを表示するには、次のステップを実行します。

1. ワークスペースのホームページで、「SQLワークショップ」をクリックして、「オブジェクト・ブラウザ」をクリックします。
オブジェクト・ブラウザが表示されます。

2. ページ上部のオブジェクト・タイプ「データベース・リンク」を選択します。

関連項目:
Oracle Application Express SQLワークショップおよびユーティリティ・ガイドの「オブジェクト・ブラウザを使用したデータベース・オブジェクトの管理」およびOracle Database管理者ガイドの「データベース・リンク」

アプリケーションからの電子メール送信

このセクションでは、Oracle Application Expressアプリケーションから電子メールを送信する方法を説明します。

この項に含まれる内容は次のとおりです。

- 電子メールを送信するためのOracle Application Expressの構成の概要

- アプリケーションからの電子メール送信

関連項目:
Oracle Application Express管理ガイドの「メールの管理」

ヒント:
Oracle Database 11g リリース1 (11.1)でOracle Application Expressを実行している場合は、外部に電子メールを送信するにはネットワーク・サービスを有効化する必要があります。「Oracle Database 11gのネットワーク・サービスの有効化」を参照してください。

電子メールを送信するためのOracle Application Expressの構成の概要

アプリケーション・ビルダー・アプリケーションから電子メールを送信する前に、次のステップを実行する必要があります。

1. Oracle Application Express管理サービスにログインし、インスタンスの設定ページで電子メール設定を構成します。『Oracle Application Express管理ガイド』を参照してください。

2. さらに、Oracle Database 11g リリース1(11.1)でOracle Application Expressを実行している場合、外部へのメールを有効化する必要があります。Oracle Database 11g リリース1(11.1)では、ネットワーク・サービスと通信する機能はデフォルトで無効になっています。「Oracle Database 11gのネットワーク・サービスの有効化」を参照してください。

ヒント:
新しいワークスペース・リクエストが承認されたときにユーザーにログイン資格証明が電子メールで自動的に送信されるように、Oracle Application Expressを構成できます。詳細は、『Oracle Application Express管理ガイド』の「割当てモードの指定」を参照してください。

アプリケーションからの電子メール送信

APEX_MAILというPL/SQLパッケージをコールすることによって、アプリケーション・ビルダー・アプリケーションから電子メールを送信できます。このパッケージは、Oracleで提供されるUTL_SMTPパッケージをベースとして構築されています。このような依存性があるため、APEX_MAILを使用するには、UTL_SMTPパッケージがインストール済で機能している必要があります。

関連項目:
UTL_SMTPパッケージの詳細は、Oracle Database PL/SQLパッケージ・プロシージャおよびタイプ・リファレンスを、「APEX_MAIL」の詳細は、Oracle Application Express APIリファレンスを参照してください。

APEX_MAILには、電子メールを送信するための次の3つのプロシージャが含まれています。

- アプリケーションから外部へ電子メール・メッセージを手動で送信するには、APEX_MAIL.SENDを使用します。

- 添付ファイルとしてアプリケーションから外部へ電子メール・メッセージを送信するには、APEX_MAIL.ADD_ATTACHMENTを使用します。APEX_MAIL.ADD_ATTACHMENT

- APEX_MAIL_QUEUEに格納されたメール・メッセージを配信するには、 APEX_MAIL.PUSH_QUEUEを使用します。

Oracle Application Expressでは、APEX_MAIL_QUEUEという名前の表に未送信の電子メール・メッセージが格納されます。APEX_MAIL.PUSH_QUEUEプロシージャをコールすると、このキューに格納されたメール・メッセージを指定したSMTPゲートウェイに配信できます。

Oracle Application Expressによって、正常に送信されたメッセージのログが、サーバーのローカル時間でのタイムスタンプとともにAPEX_MAIL_LOG表に作成されます。

次に、シェル・スクリプトを使用したAPEX_MAIL.PUSH_QUEUEプロシージャのUNIXまたはLinux使用例を示します。

SQLPLUS / <<EOF
APEX_MAIL.PUSH_QUEUE;
DISCONNECT
EXIT
EOF

関連項目:
Oracle Application Express APIリファレンスの「APEX_MAIL」およびOracle Application Express管理ガイドの「メールの管理」

コレクションの使用

コレクションを使用すると、1つ以上の非スカラー値を一時的に取得できます。コレクションを使用して、現在セッション・ステートにある行および列を格納します。これによって、あるユーザーの特定のセッション中にそれらの行および列に対してアクセス、操作または処理を行うことができます。コレクションは、バケツのようなものと考えることができます。その中に情報の行を一時的に格納し、その情報を指定できます。

次に、コレクションを使用する場合の例を示します。

- データ入力ウィザードを作成しており、そのウィザードで、まず論理トランザクション中に複数行の情報を収集する必要がある場合。物理トランザクションと論理トランザクションの両方の完了時、ウィザードの最終ステップを実行する前に、コレクションを使用して、複数行の情報のコンテンツを一時的に格納できます。

- アプリケーションに、ユーザーが1つのページで複数の詳細行を更新する更新ページが含まれている場合。ユーザーは、複数の更新を行い、それらの更新をコレクションに適用した後、最終プロセスをコールしてそれらの変更をデータベースに適用できます。

- 任意の数の属性を収集するウィザードを構築している場合。コレクションに一時的に格納された情報が取得され、データベースに適用されるタスクをウィザードの最後にユーザーが実行するようにします。

この項に含まれる内容は次のとおりです。

- APEX_COLLECTION APIについて

- コレクションの作成

- コレクションの切捨て

- コレクションへのアクセス

- コレクションの削除

- コレクションへのメンバーの追加

- コレクション・メンバーの更新

- コレクション・メンバーの削除

- コレクション・ステータスの判別

- コレクションのマージ

- コレクションの管理

- コレクションのセッション・ステートのクリア

APEX_COLLECTION APIについて

各コレクションには、データ要素(メンバー)の名前付きリストが含まれます。このリストには、最大50個の文字属性(VARCHAR2(4000))および1個の大文字属性(CLOB)を含めることができます。コレクション情報は、PL/SQL API APEX_COLLECTIONを使用して挿入、更新および削除します。

コレクションの名前の指定について

コレクションを作成する場合、255文字以下の名前を付ける必要があります。コレクション名の大/小文字は区別されず、すべて大文字に変換されます。

コレクションに名前を付けた後、コレクション内の値にアクセスするには、APEX_COLLECTIONSビューに対してSQL問合せを実行します。

関連項目:
「コレクションへのアクセス」

コレクションの作成

各コレクションには、データ要素(メンバー)の名前付きリストが含まれます。このリストには、最大50個の文字属性(VARCHAR2(4000))および1個の大文字属性(CLOB)を含めることができます。次のメソッドを使用してコレクションを作成します。

- CREATE_COLLECTION

- CREATE_OR_TRUNCATE_COLLECTION

- CREATE_COLLECTION_FROM_QUERY

- CREATE_COLLECTION_FROM_QUERY_B

CREATE_COLLECTIONメソッドでは、指定したコレクションが存在する場合は例外が発生します。次に例を示します。

APEX_COLLECTION.CREATE_COLLECTION(
p_collection_name => collection name );

CREATE_OR_TRUNCATE_COLLECTIONメソッドでは、指定したコレクションが存在しない場合に、コレクションが作成されます。名前付きコレクションが存在すると、このメソッドによって切り捨てられます。切り捨てられたコレクションは空になりますが、コレクション自体はそのまま残ります。次に例を示します。

APEX_COLLECTION.CREATE_OR_TRUNCATE_COLLECTION(
p_collection_name => collection name);

CREATE_COLLECTION_FROM_QUERYメソッドでは、コレクションが作成され、指定した問合せの結果がそのコレクションに移入されます。次に例を示します。

APEX_COLLECTION.CREATE_COLLECTION_FROM_QUERY(
p_collection_name => collection name,
p_query           => your query ,
p_generate_md5    => 'YES' or 'NO' );

また、CREATE_COLLECTION_FROM_QUERY_Bメソッドでは、コレクションが作成され、指定した問合せの結果がそのコレクションに移入されます。次に例を示します。

APEX_COLLECTION.CREATE_COLLECTION_FROM_QUERY_B(
p_collection_name => collection name,
p_query           => your query );

CREATE_COLLECTION_FROM_QUERY_Bメソッドでは、バルクSQL操作を実行することにより、CREATE_COLLECTION_FROM_QUERYメソッドよりも非常に速いパフォーマンスが提供されますが、次の制限があります。

- 問合せの選択リスト内の列値は、2,000バイトを超えることはできません。列値が2,000バイトを超える行がある場合は、実行中にエラーが発生します。

- コレクション内のいずれのメンバーに対してもMD5チェックサムは計算されません。

パラメータp_generate_md5

p_generate_md5フラグを使用して、コレクション・メンバーのデータのメッセージ・ダイジェストを計算する必要があるかどうかを指定します。デフォルトでは、このフラグはNOに設定されています。このパラメータを使用して、コレクション・メンバーのMD5をチェックします(つまり、MD5を他のメンバーと比較して、メンバーが変更されたかどうかを確認します)。

関連項目:
GET_MEMBER_MD5ファンクションの使用方法については、「コレクション・ステータスの判別」を参照してください。

コレクションの切捨て

コレクションを切り捨てる場合、指定したコレクションからすべてのメンバーを削除しますが、指定したコレクションはそのまま残ります。次に例を示します。

APEX_COLLECTION.TRUNCATE_COLLECTION(
p_collection_name => collection name );

コレクションへのアクセス

データベース・ビューAPEX_COLLECTIONSを問い合せると、コレクションのメンバーにアクセスできます。APEX_COLLECTIONSビューには、次の定義が含まれます。

COLLECTION_NAME   NOT NULL VARCHAR2(255)
SEQ_ID            NOT NULL NUMBER
C001                       VARCHAR2(4000)
C002                       VARCHAR2(4000)
C003                       VARCHAR2(4000)
C004                       VARCHAR2(4000)
C005                       VARCHAR2(4000)
...
C050                       VARCHAR2(4000)
CLOB001                    CLOB
MD5_ORIGINAL               VARCHAR2(4000)

APEX_COLLECTIONSビューは、アプリケーションで、アプリケーション内の他の表またはビューと同様に使用します。次に例を示します。

SELECT c001, c002, c003
FROM APEX_collections
WHERE collection_name = 'FIREARMS'

コレクションの削除

コレクションを削除する場合は、コレクションおよびそのすべてのメンバーを削除します。次に例を示します。

APEX_COLLECTION.DELETE_COLLECTION (
p_collection_name => collection name );

コレクションを削除しない場合は、セッションがパージされると最終的にコレクションが削除されることに注意してください。次に例を示します。

現在のアプリケーションに関するすべてのコレクションの削除

現在のアプリケーションに定義されたすべてのコレクションを削除するには、DELETE_ALL_COLLECTIONSメソッドを使用します。次に例を示します。

APEX_COLLECTION.DELETE_ALL_COLLECTIONS;

現在のセッションにおけるすべてのコレクションの削除

現在のセッションに定義されたすべてのコレクションを削除するには、DELETE_ALL_COLLECTIONS_SESSIONメソッドを使用します。次に例を示します。

APEX_COLLECTION.DELETE_ALL_COLLECTIONS_SESSION;

コレクションへのメンバーの追加

コレクションに追加したデータ要素(メンバー)には、一意の順序番号が割り当てられます。メンバーをコレクションに追加すると、最も新しいメンバーが一番大きい番号を持つように、前のメンバーより1大きい番号が新しいメンバーに割り当てられます。

コレクションに新しいメンバーを追加するには、ADD_MEMBERファンクションを使用します。このファンクションをコールすると、新しく追加したメンバーの順序番号が戻されます。次の例では、ADD_MEMBERファンクションを使用する方法を示します。

APEX_COLLECTION.ADD_MEMBER(
p_collection_name => collection name,
p_c001          => [member attribute 1],
p_c002          => [member attribute 2],
p_c003          => [member attribute 3],
p_c004          => [member attribute 4],
p_c005          => [member attribute 5],
p_c006          => [member attribute 6],
p_c007          => [member attribute 7],
...
p_c050          => [member attribute 50]);
p_clob001       => [CLOB member attribute 1],
p_generate_md5  => 'YES' or 'NO');

ADD_MEMBERSメソッドを使用して、新しいメンバー(メンバーの配列)をコレクションに追加することもできます。次に例を示します。

APEX_COLLECTION.ADD_MEMBERS(
p_collection_name => collection name,
p_c001          => member attribute array 1,
p_c002          => member attribute array 2,
p_c003          => member attribute array 3,
p_c004          => member attribute array 4,
p_c005          => member attribute array 5,
p_c006          => member attribute array 6,
p_c007          => member attribute array 7,
...
p_c050          => member attribute array 50);
p_generate_md5  => 'YES' or 'NO');

指定したコレクションが、現在のユーザーの指定した名前で同じセッションに存在しない場合、このメソッドによりエラーが発生します。また、4,000文字を超える属性はすべて4,000文字に切り捨てられます。追加されるメンバーの数は、1つ目の配列の要素数に基づきます。

パラメータp_generate_md5およびp_clob001

p_generate_md5フラグを使用して、コレクション・メンバーのデータのメッセージ・ダイジェストを計算する必要があるかどうかを指定します。デフォルトでは、このフラグはNOに設定されています。このパラメータを使用して、コレクション・メンバーのMD5をチェックします(つまり、MD5を他のメンバーと比較して、メンバーが変更されたかどうかを確認します)。

4,000文字を超えるコレクション・メンバー属性には、p_clob001を使用します。

関連項目:
ファンクションGET_MEMBER_MD5の使用方法については、「コレクション・ステータスの判別」を参照してください。

コレクション・メンバーの更新

コレクション・メンバーを更新するには、UPDATE_MEMBERプロシージャをコールして、更新するコレクション・メンバーを順序番号を使用して参照します。次に例を示します。

APEX_COLLECTION.UPDATE_MEMBER (
p_collection_name => collection name,
p_seq             => member sequence number,
p_c001            => member attribute 1,
p_c002            => member attribute 2,
p_c003            => member attribute 3,
p_c004            => member attribute 4,
p_c005            => member attribute 5,
p_c006            => member attribute 6,
p_c007            => member attribute 7,
...
p_c050            => member attribute 50),
p_clob001         => [CLOB member attribute 1];

UPDATE_MEMBERプロシージャでは、個々のメンバー属性ではなく、コレクション・メンバー全体が置換されます。指定したコレクションが存在しない場合、このプロシージャによりエラーが発生します。

4,000文字を超えるコレクション・メンバー属性には、p_clob001パラメータを使用します。

コレクション・メンバーの単一の属性を更新するには、UPDATE_MEMBER_ATTRIBUTEプロシージャを使用します。次に例を示します。

APEX_COLLECTION.UPDATE_MEMBER_ATTRIBUTE(
p_collection_name       => collection_name,
p_seq                   => member sequence number,
p_attr_number           => member attribute number,
p_attr_value            => member attribute value )

APEX_COLLECTION.UPDATE_MEMBER_ATTRIBUTE(
p_collection_name        => collection_name,
p_seq                    => member sequence number,
p_clob_number            => CLOB member attribute number,
p_clob_value             => CLOB member attribute value );

指定したコレクションが存在しない場合、UPDATE_MEMBER_ATTRIBUTEプロシージャをコールすると、エラーが発生します。

p_clob_numberパラメータの有効値は1のみであることに注意してください。

コレクション・メンバーの削除

コレクション・メンバーを削除するには、DELETE_MEMBERプロシージャをコールして、削除するコレクション・メンバーを順序番号を使用して参照します。次に例を示します。

APEX_COLLECTION.DELETE_MEMBER(
p_collection_name => collection name,
p_seq             => member sequence number);

このプロシージャでは、順序番号の欠落は指定したコレクションにそのまま残ることに注意してください。また、指定したコレクションが存在しない場合、このプロシージャをコールするとエラーが発生します。

属性が特定の値に一致するまで、コレクションからすべてのメンバーを削除することもできます。次に例を示します。

APEX_COLLECTION.DELETE_MEMBERS(
p_collection_name => collection name,
p_attr_number     => number of attribute used to match for the specified
attribute value for deletion,
p_attr_value      => attribute value of the member attribute used to
match for deletion);

DELETE_MEMBERSプロシージャでも、順序番号の欠落は指定したコレクションにそのまま残ります。次の場合に、このプロシージャによりエラーが発生します。

- 指定したコレクションが存在しない場合。

- 指定した属性番号が1から50の範囲外であるか、無効である場合。

指定した属性値がNULLの場合、指定したコレクションのうち、属性(p_attr_numberで指定)がNULLであるすべてのメンバーが削除されます。

コレクション・ステータスの判別

p_generate_md5パラメータは、コレクションの各メンバーに対してMD5メッセージ・ダイジェストを計算するかどうかを判別します。コレクションの作成直後、コレクション・ステータス・フラグはFALSEに設定されます。コレクションに対して操作(追加、更新、切捨てなど)が行われると、このフラグはTRUEに設定されます。

このフラグは、RESET_COLLECTION_CHANGEDをコールすることで、手動でリセットできます。次に例を示します。

APEX_COLLECTION.RESET_COLLECTION_CHANGED (
p_collection_name => collection name)

このフラグをリセットした後にコレクションが変更されたかどうかを判別するには、COLLECTION_HAS_CHANGEDをコールします。次に例を示します。

l_changed := APEX_COLLECTION.COLLECTION_HAS_CHANGED(
p_collection_name => collection_name);

p_generated_md5パラメータがYESに設定されている場合、コレクションに新しいメンバーを追加すると、50個のすべての属性とCLOB属性に対してMD5メッセージ・ダイジェストが計算されます。この値にはAPEX_COLLECTIONビューのMD5_ORIGINAL列からアクセスできます。GET_MEMBER_MD5ファンクションを使用して、指定したコレクション・メンバーの現在の値に対するMD5メッセージ・ダイジェストにアクセスできます。次に例を示します。

APEX_COLLECTION.GET_MEMBER_MD5 (
p_collection_name => collection name,
p_seq             => member sequence number );
RETURN VARCHAR2;

コレクションのマージ

コレクションのメンバーを、配列の集合として渡した値とマージできます。p_init_query引数を使用することで、指定した問合せからコレクションを作成できます。

コレクションが存在する場合、次のことが発生することに注意してください。

- コレクション内に存在し、配列内に存在しない行が削除されます。

- コレクションおよび配列内の行が更新されます。

- 配列内に存在し、コレクション内に存在しない行が挿入されます。

4,000文字を超える属性は、4,000文字に切り捨てられます。表 15-1に、コレクションのマージに使用可能な引数を示します。

表 15-1 コレクションのマージに使用可能な引数

引数

説明

p_collection_name

コレクションの名前です。

参照: 「コレクションの名前の指定について」

p_seq

マージするメンバーの順序番号を指定します。

p_c001

マージされる1番目の属性値の配列です。最大長は4,000文字です。最大長より大きい値は4,000文字に切り捨てられます。

P_C001 PL/SQL表内の要素数は、すべてのPL/SQL表内のアイテムの合計数として使用されます。たとえば、P_C001.count = 2およびP_C002.count = 10の場合、2つのメンバーのみがマージされます。P_C001がNULLの場合は、アプリケーション・エラーが発生することに注意してください。

p_c0xx

マージされるXX番目の属性値の属性です。最大長は4,000文字です。最大長より大きい値は4,000文字に切り捨てられます。

p_null_index

マージ・ファンクションで無視する行を識別するために使用します。この引数は、行をNULLとして識別します。NULL行は、コレクションから自動的に削除されます。

p_null_value

p_null_indexとともに使用します。この引数は、null値を識別します。この値をNULLにすることはできません。この引数の通常の値は0 (ゼロ)です。

p_init_query

コレクションが存在しない場合に、この引数によって定義した問合せを使用してコレクションを作成できます。

コレクションの管理

コレクションの管理には、次のユーティリティを使用できます。

この項に含まれる内容は次のとおりです。

- メンバー数の取得

- コレクションの再順序付け

- コレクションの存在の確認

- メンバーの順序番号の調整

- コレクション・メンバーのソート

メンバー数の取得

コレクション内のすべてのメンバーの合計数を戻すには、COLLECTION_MEMBER_COUNTを使用します。この数は、コレクション内の順序番号の最大値ではないことに注意してください。次に例を示します。

l_count := APEX_COLLECTION.COLLECTION_MEMBER_COUNT (
p_collection_name => collection name );

コレクションの再順序付け

要素の順序を保持したままで、コレクションを再順序付けして順序番号の欠落を排除するには、RESEQUENCE_COLLECTIONを使用します。次に例を示します。

APEX_COLLECTION.RESEQUENCE_COLLECTION (
p_collection_name => collection name )

コレクションの存在の確認

コレクションが存在するかどうかを確認するには、COLLECTION_EXISTSを使用します。次に例を示します。

l_exists := APEX_COLLECTION.COLLECTION_EXISTS  (
p_collection_name => collection name );

メンバーの順序番号の調整

順序番号を上下に移動することで、コレクション内の特定のメンバーの順序番号を調整できます。順序番号を調整すると、指定した番号が別の番号と入れ替えられます。たとえば、番号2を1つ上に移動すると、2が3になり、3が2になります。

メンバーの順序番号を1つ上に移動するには、MOVE_MEMBER_UPを使用します。メンバーの順序番号を1つ下に移動するには、MOVE_MEMBER_DOWNを使用します。次に例を示します。

APEX_COLLECTION.MOVE_MEMBER_DOWN(
p_collection_name => collection name,
p_seq             => member sequence number);

これらのいずれかのメソッドの使用中は、次の場合にアプリケーション・エラーが表示されることに注意してください。

- 指定したコレクションが、カレント・ユーザーのカレント・セッションに存在しない場合

- p_seq順序番号によって指定されたメンバーが存在しない場合

ただし、指定したメンバーにコレクション内で最も大きい番号または最も小さい番号(MOVE_MEMBER_UPまたはMOVE_MEMBER_DOWNのどちらをコールするかによる)が割り当てられている場合、アプリケーション・エラーは戻されません。

コレクション・メンバーのソート

コレクションのメンバーを列番号で並べ替えるには、SORT_MEMBERSメソッドを使用します。このメソッドは、特定の列番号でコレクションをソートし、各メンバーの順序番号の欠落を排除するように順序番号の再割当ても行います。次に例を示します。

APEX_COLLECTION.SORT_MEMBERS(
p_collection_name       => collection name,
p_sort_on_column_number => column number to sort by);

コレクションのセッション・ステートのクリア

コレクションのセッション・ステートをクリアすると、コレクションのメンバーを削除できます。ショッピング・カートは、コレクションのセッション・ステートをクリアする必要がある場合のよい例です。ユーザーがショッピング・カートを空にして再度開始するよう要求した場合に、コレクションのセッション・ステートをクリアする必要があります。TRUNCATE_COLLECTIONメソッドをコールするか、f?p構文を使用して、コレクションのセッション・ステートを削除できます。

TRUNCATE_COLLECTIONメソッドをコールすると、既存のコレクションが削除され、そのコレクションが再作成されます。次に例を示します。

APEX_COLLECTION.TRUNCATE_COLLECTION(
p_collection_name => collection name);

f?p構文の6つ目の引数を使用してセッション・ステートをクリアすることもできます。次に例を示します。

f?p=App:Page:Session::NO:collection name

関連項目:
「URL構文の理解」

APEX_ACTIVITY_LOGを使用したカスタム・アクティビティ・レポートの作成

APEX_ACTIVITY_LOGビューには、開発者アクティビティ、アプリケーション実行時アクティビティなど、ワークスペースのすべてのアクティビティが記録されます。APEX_ACTIVITY_LOG使用して、現在のワークスペースに関するすべてのアクティビティの問合せを表示できます。たとえば、このビューを使用して、リアルタイムのパフォーマンス分析を提供する特定のアプリケーション内の監視レポートを開発できます。

表 15-2に、APEX_ACTIVITY_LOGビューの列を示します。

表 15-2 APEX_ACTIVITY_LOGの列

列

タイプ

説明

time_stamp

DATE

アクティビティがページ・ビューの末尾に記録された日時

component_type

VARCHAR2(255)

今後の使用のための予約

component_name

VARCHAR2(255)

今後の使用のための予約

component_attribute

VARCHAR2(4000)

ページのタイトル

information

VARCHAR2(4000)

今後の使用のための予約

elap

NUMBER

ページ・ビューの経過時間(秒)。

num_rows

NUMBER

ページ上で処理された行数

userid

VARCHAR2(255)

ページ・ビューを実行しているユーザーのID

ip_address

VARCHAR2(4000)

クライアントのIPアドレス

user_agent

VARCHAR2(4000)

クライアントのWebブラウザ・ユーザー・エージェント

flow_id

NUMBER

アプリケーションID

step_id

NUMBER

ページ番号。

session_id

NUMBER

Oracle Application Expressセッション識別子。

sqlerrm

VARCHAR2(4000)

SQLエラー・メッセージ

sqlerrm_component_type

VARCHAR2(255)

今後の使用のための予約

sqlerrm_component_name

VARCHAR2(255)

今後の使用のための予約

アクティビティ・ログの領域を節約するため、一意のセッションそれぞれの最初のログ・エントリにのみIPアドレスとWebブラウザ・ユーザー・エージェントが含まれます。

次に、アプリケーション9529に関する過去24時間のページ・ビュー合計数および平均ページ・ビュー時間がユーザーID別に表示されるレポートを作成する方法の例を示します。

SELECT COUNT(*), AVG(elap), userid
FROM APEX_ACTIVITY_LOG
WHERE time_stamp > (SYSDATE-1)
AND flow_id = 9529
GROUP BY userid

Oracle Application Expressインスタンスでのアクティビティのロギングは2つの異なるログ表を順番に使用することに注意してください。このため、ロギング情報はログのうち古い方の使用可能なエントリのみとなります。アプリケーションの特定のログ情報を常に保持する場合は、所有するアプリケーション表に両方のログ情報をコピーするか、アプリケーションに直接ロギングを実装する必要があります。

関連項目:
定義の編集ページで、有効なロギングの情報に関する「名前」を参照してください。

バックグラウンドPL/SQLの実行

APEX_PLSQL_JOBパッケージを使用すると、アプリケーションのバックグラウンドでPL/SQLコードを実行できます。操作が完了していない状態でもユーザーがアプリケーションで作業を継続できるため、長時間実行操作の管理に有効な方法です。

この項に含まれる内容は次のとおりです。

- APEX_PLSQL_JOBパッケージの理解

- システム・ステータスの更新について

- プロセスを使用したバックグラウンドPL/SQLの実装

APEX_PLSQL_JOBパッケージの理解

APEX_PLSQL_JOBは、Oracle Databaseで提供されるDBMS_JOB機能をラップしたラッパー・パッケージです。APEX_PLSQL_JOBパッケージでは、PL/SQLをバックグラウンドで実行するために必要な機能のみが公開されることに注意してください。APEX_PLSQL_JOB パッケージの記述を次に示します。

SQL> DESC APEX_PLSQL_JOB
FUNCTION JOBS_ARE_ENABLED RETURNS BOOLEAN
PROCEDURE PURGE_PROCESS
Argument Name                  Type                    In/Out Default?
------------------------------ ----------------------- ------ --------
P_JOB                          NUMBER                  IN
FUNCTION SUBMIT_PROCESS RETURNS NUMBER
Argument Name                  Type                    In/Out Default?
------------------------------ ----------------------- ------ --------
P_SQL                          VARCHAR2                IN
P_WHEN                         VARCHAR2                IN     DEFAULT
P_STATUS                       VARCHAR2                IN     DEFAULT
FUNCTION TIME_ELAPSED RETURNS NUMBER
Argument Name                  Type                    In/Out Default?
------------------------------ ----------------------- ------ --------
P_JOB                          NUMBER                  IN
PROCEDURE UPDATE_JOB_STATUS
Argument Name                  Type                    In/Out Default?
------------------------------ ----------------------- ------ --------
P_JOB                          NUMBER                  IN
P_STATUS                       VARCHAR2                IN

表15-1に、APEX_PLSQL_JOBパッケージで使用可能なファンクションを示します。

表 15-3 APEX_PLSQL_JOBパッケージ: 使用可能なファンクション

ファンクションまたはプロシージャ

説明

SUBMIT_PROCESS

このプロシージャを使用すると、バックグラウンドPL/SQLを送信できます。このプロシージャは、一意のジョブ番号を戻します。このジョブ番号は、このパッケージ内の他のプロシージャおよびファンクションの参照点として使用できるため、自分のスキーマ内に格納しておくと役に立ちます。

UPDATE_JOB_STATUS

このプロシージャをコールすると、現在実行しているジョブのステータスを更新できます。このプロシージャは、送信されたPL/SQLからコールされたときに最も有効です。

TIME_ELAPSED

このファンクションを使用すると、ジョブが送信されてから経過した時間を確認できます。

JOBS_ARE_ENABLED

このファンクションをコールすると、そのデータベースが現在、APEX_PLSQL_JOBパッケージへのジョブの送信をサポートするモードであるかどうかを確認できます。

PURGE_PROCESS

このプロシージャをコールすると、送信されたジョブをクリーンアップできます。送信されたジョブは、Oracle Application Expressによってそれらのレコードがクリーンアップされるか、またはPURGE_PROCESSのコールによって手動で削除するまで、APEX_PLSQL_JOBSビューに保持されます。

APEX_PLSQL_JOBパッケージに送信したすべてのジョブは、APEX_PLSQL_JOBSビューで表示できます。APEX_PLSQL_JOBSビューの記述を次に示します。

SQL> DESCRIBE APEX_PLSQL_JOBS
Name                              Null?    Type
--------------------------------- -------- ----------------------------
ID                                         NUMBER
JOB                                        NUMBER
FLOW_ID                                    NUMBER
OWNER                                      VARCHAR2(30)
ENDUSER                                    VARCHAR2(30)
CREATED                                    DATE
MODIFIED                                   DATE
STATUS                                     VARCHAR2(100)
SYSTEM_STATUS                              VARCHAR2(4000)
SYSTEM_MODIFIED                            DATE
SECURITY_GROUP_ID                          NUMBER

表 15-4に、APEX_PLSQL_JOBSビューで使用可能な列を示します。

表 15-4 APEX_PLSQL_JOBSビュー列

名前

説明

ID

列ごとに一意の識別子です。

JOB

送信された各PL/SQLジョブに割り当てられたジョブ番号です。この値を戻すには、APEX_PLSQL_JOB.SUBMIT_PROCESSファンクションを使用します。これは、APEX_PLSQL_JOBパッケージ内の他のプロシージャおよびファンクションに渡す値でもあります。

FLOW_ID

このジョブの送信元のアプリケーションです。

OWNER

アプリケーションを所有するデータベース・スキーマです。この値は、DBMS_JOBがこのコードを実行する際に、コードを解析するスキーマを識別します。

ENDUSER

このプロセスを送信させたエンド・ユーザー(アプリケーションにログインしたユーザー)です。

CREATED

ジョブが送信された日付です。

MODIFIED

ステータスが変更された日付です。

STATUS

このジョブに対してユーザーが定義したステータスです。この列を更新するには、APEX_PLSQL_JOB.UPDATE_JOB_STATUSをコールします。

SYSTEM_STATUS

このジョブに対してシステムが定義したステータスです。

SYSTEM_MODIFIED

システム・ステータスが変更された日付です。

SECURITY_GROUP_ID

ワークスペースに割り当てられた一意のIDです。開発者は、自分のワークスペースから送信されたジョブのみを参照できます。

関連項目:
Oracle Application Express APIリファレンスの「APEX_PLSQL_JOBS」

システム・ステータスの更新について

送信されたジョブには、次のいずれかのシステム・ステータス設定が含まれています。

- SUBMITTED: ジョブが送信済であるが、開始されていないことを示します。DBMS_JOBでは、ジョブの即時開始は保証されていません。

- IN PROGRESS: DBMS_JOBがプロセスを開始したことを示します。

- COMPLETED: ジョブが完了したことを示します。

- BROKEN (sqlcode) sqlerrm: ジョブに問題があり、エラーが発生したことを示します。エラーが発生したことを示すSQLコードおよびSQLエラー・メッセージがシステム・ステータスに表示されます。この情報を参照して、エラーの原因を判別してください。

プロセスを使用したバックグラウンドPL/SQLの実装

テストおよび説明用に、PL/SQLジョブをバックグラウンドで実行する例を次に示します。

001  BEGIN
002    FOR i IN 1 .. 100 LOOP
003      INSERT INTO emp(a,b) VALUES (:APP_JOB,i);
004      IF MOD(i,10) = 0 THEN
005        APEX_PLSQL_JOB.UPDATE_JOB_STATUS(
006          P_JOB     => :APP_JOB,
007          P_STATUS  => i || 'rows inserted');
008      END IF;
009      APEX_UTIL.PAUSE(2);
010    END LOOP;
011  END;

この例の説明を次に示します。

- 002から010行では、100個のレコードをemp表に挿入するループを実行します。

- APP_JOBは、INSERTのVALUE句内でバインド変数として参照され、UPDATE_JOB_STATUSへのコール内でP_JOBパラメータの値として指定されます。

- APP_JOBは、APEX_PLSQL_JOBに送信される際に、このプロセスに割り当てられるジョブ番号を表します。プロセス・コード内にこの予約アイテムを指定すると、実行時に実際のジョブ番号に置換されます。

- この例では、コード・ブロック内で、10個のレコードごとにUPDATE_JOB_STATUSがコールされることに注意してください。通常、Oracleトランザクション規則では、コード・ブロック内で実行された更新は、トランザクション全体がコミットされるまで表示されません。一方、APEX_PLSQL_JOB.UPDATE_JOB_STATUSプロシージャは、ジョブが成功したか失敗したかにかかわらず更新を実行するように実装されています。このことは、次の2つの理由から重要です。

1. 「100行が挿入されました」というステータスが表示される場合でも、操作全体が成功したわけではありません。コード・ブロックでコミットが試行されたときにエラーが発生した場合、ステータスの更新は個別にコミットされるため、APEX_PLSQL_JOBSのuser_status列は影響を受けません。

2. 更新は自律的に実行されます。ジョブが完了する前にジョブ・ステータスを表示できます。これによって、バックグラウンドで実行中の各操作についてステータス・テキストを表示できます。

Webサービスの実装

Webサービスを使用すると、アプリケーション同士がWeb上でプラットフォームおよび言語に依存しない環境で相互に通信できます。通常のWebサービス・シナリオでは、ビジネス・アプリケーションが、HTTPプロトコルを使用して、特定のURLにあるサービスに対してリクエストを送信します。サービスは、リクエストを受信すると、これを処理し、レスポンスを返します。外部Webサービスへのコールをアプリケーション・ビルダーで開発されたアプリケーションに組み込むことができます。

Webサービスは、Simple Object Access Protocol (SOAP)に基づいています。SOAPは、World Wide Web Consortium (W3C)が策定した、インターネットを介したリクエストとレスポンスの送受信用の標準プロトコルです。SOAPメッセージは、サービス・プロバイダとサービス・ユーザー間でSOAPエンベロープに入れて送受信できます。

SOAPには、主に2つのメリットがあります。

- SOAPはXMLをベースとしており、使用方法も容易です。

- このプロトコルではHTTPなどの単純な転送プロトコルが使用されているため、SOAPメッセージはファイアウォールでブロックされることはありません。

ヒント:
Oracle Application ExpressをOracle Database 11g リリース1(11.1)以上と同時に実行している場合は、Webサービスを使用するためにネットワーク・サービスを有効にする必要があります。「Oracle Database 11gのネットワーク・サービスの有効化」を参照してください。

この項に含まれる内容は次のとおりです。

- Webサービス参照の理解

- SSL有効Webサービスでの作業

- WSDLに基づいたWebサービス参照の作成

- Webサービス参照リポジトリの使用

- WSDLから作成されたWebサービス参照のテスト

- 手動作成されたWebサービス参照のテスト

- Webサービスでの入力フォームとレポートの作成

- Webサービスでのフォームの作成

- プロセスとしてのWebサービスの起動

- Webサービス・プロセスの編集

- Webサービス参照履歴の表示

注意:
SOAP 1.1仕様はW3C技術ノートです。(SOAPより優先される標準を作成するために、W3C XML Protocol Working Groupが結成されています。)
Simple Object Access Protocol(SOAP)1.1については、次のWebサイトを参照してください。

http://www.w3.org/TR/SOAP/

Webサービス参照の理解

Oracle Application ExpressでWebサービスを使用するには、ウィザードを使用してWebサービス参照を作成します。Webサービス参照は、Web Services Description Language (WSDL)ドキュメントに基づくか、サービスに関する情報を参照して手動で作成することができます。

WSDLに基づいてWebサービス参照を作成する場合、ウィザードはWSDLを分析し、すべての必要な情報を収集して、次を含んだ有効なSOAPメッセージを作成します。

- HTTP(S)を介したSOAPリクエストのポストに使用するURL

- SOAP HTTPリクエストを識別するUniversal Resource Identifier(URI)

- Webサービスの操作

- 各操作の入力パラメータ

- 各操作の出力パラメータ

手動でWebサービス参照を作成する場合、必要な情報を指定して、次を含んだ有効なSOAPリクエストを作成します。

- HTTP(S)を介したSOAPリクエストのポストに使用するURL

- SOAP HTTPリクエストを識別するUniversal Resource Identifier(URI)

- アイテムの置換を含んだリクエストのSOAPエンベロープ

- オプションで、Webサービスからのレスポンスを格納するコレクション名

Webサービス参照ページへのアクセス

Webサービス参照は、Webサービス参照ページで管理します。

Webサービス参照ページにアクセスするには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。
アプリケーション・ビルダーが表示されます。

3. 「共有コンポーネント」をクリックします。
共有コンポーネント・ページが表示されます。

4. 「ロジック」で、「Webサービス参照」をクリックします。
Webサービス参照ページが表示されます。

アプリケーション・プロキシ・サーバー・アドレスの指定

インターネットのアクセスにプロキシ・サーバーが必要な環境の場合は、Webサービス参照を作成する前にアプリケーション属性ページでプロキシ・サーバー・アドレスを指定する必要があります。

アプリケーションにプロキシ・アドレスを指定するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。
アプリケーションのホームページが表示されます。

3. 「共有コンポーネント」をクリックします。

4. 「アプリケーション」で、「定義」をクリックします。

5. 「名前」で、「プロキシ・サーバー」フィールドにプロキシ・サーバーを入力します。

6. 「変更の適用」をクリックします。

SSL有効Webサービスでの作業

Secure Sockets Layer(SSL)は、RSA公開鍵による暗号化と対称鍵による暗号化を使用して、認証、暗号化およびデータの整合性を実現する業界標準プロトコルです。

通信する必要のあるWebサービスがSSL対応の場合(Webサービスに対するURLにhttpsと表示される)、ウォレットを作成する必要があります。ウォレットは、SSLに必要な認証および署名された資格証明(秘密鍵、証明書および信頼できる証明書)の格納に使用されるパスワード保護されたコンテナです。

関連項目:
Oracle Application Express管理ガイドの「ウォレット情報の構成」

WSDLに基づいたWebサービス参照の作成

WSDLに基づいたWebサービス参照を作成する場合、WSDLの位置の特定方法を決定する必要があります。WSDLの位置の特定には、次の2つの方法があります。

- Universal Description, Discovery and Integration (UDDI)レジストリを検索する

- WSDLドキュメントのURLを入力する

UDDIレジストリは企業がWebサービスを登録するディレクトリです。

この項に含まれる内容は次のとおりです。

- UDDIレジストリの検索によるWebサービス参照の作成

- WSDLドキュメントの指定によるWebサービス参照の作成

- Webサービス参照の手動作成

UDDIレジストリの検索によるWebサービス参照の作成

UDDIレジストリを検索して、Webサービスを作成するには、次のステップを実行します。

1. Webサービス参照ページにナビゲートします。「Webサービス参照ページへのアクセス」を参照してください。

2. 「作成」をクリックします。

3. WSDLを検出するためにUDDIレジストリを検索することを確認するプロンプトが表示されたら、「はい」をクリックします。

4. 「UDDIの位置」では、次のいずれかを実行できます。

- UDDIレジストリへのURLエンドポイントを入力する。

- 「リスト」 アイコンをクリックして、UDDIレジストリを選択する。

5. 「検索」で、次のように指定します。

1. 検索タイプ: ビジネス名またはサービス名のどちらを検索するかを指定します。両方を検索することはできません。

2. 名前: 検索に使用するビジネス名またはサービス名を入力します。ワイルドカードにはパーセント(%)を使用します。

3. オプションで、完全一致検索または大文字/小文字を区別する検索を指定できます。

4. 「検索」をクリックします。

5. 検索結果が表示されたら、選択した後で「次へ」をクリックします。

選択したWebサービスについて説明するサマリー・ページが表示されます。

6. 選択内容を確認し、「次へ」をクリックして続行します。
WSDLドキュメントへのURLが「WSDLの位置」フィールドに表示されます。

7. 「終了」をクリックします。

Webサービス参照がWebサービス参照リポジトリに追加されます。

WSDLドキュメントの指定によるWebサービス参照の作成

特定のWSDLドキュメントへのURLを指定して、Webサービスを作成するには、次のステップを実行します。

1. Webサービス参照ページにナビゲートします。「Webサービス参照ページへのアクセス」を参照してください。

2. 「作成」をクリックします。

3. WSDLを検出するためにUDDIレジストリを検索することを確認するプロンプトが表示されたら、「いいえ」をクリックします。

4. 「WSDLの位置」に、WSDLドキュメントへのURLを入力します。

5. 「終了」をクリックします。

Webサービス参照がWebサービス参照リポジトリに追加されます。

Webサービス参照の手動作成

Webサービス参照を手動作成するには、次のステップを実行します。

1. Webサービス参照ページにナビゲートします。「Webサービス参照ページへのアクセス」を参照してください。

2. 「作成」をクリックします。

3. WSDLを検出するためにUDDIレジストリを検索することを確認するプロンプトが表示されたら、「いいえ」をクリックします。

4. 「タスク」リストで、「Webサービス参照の手動作成」をクリックします。
Webサービスの作成/編集ページが表示されます。

5. 「名前」で、参照を識別する名前を入力します。

6. 「サービスの説明」で、次のステップを実行します。

1. URL: WebサービスのURLエンドポイントを入力します。

2. アクション - Webサービスのアクションを入力します(オプション)。

3. プロキシ - このサービスのアプリケーション・プロキシを上書きする場合、プロキシを入力します。

4. Basic認証: Webサービスが認証を必要とするかどうかを選択します。「はい」または「いいえ」を選択します。

7. 「SOAPエンベロープ」で、このリクエストのSOAPエンベロープを入力します。

8. 「コレクションにレスポンスを格納」で、レスポンスを格納するコレクション名を入力します(オプション)。

9. 「作成」をクリックします。

Webサービス参照がWebサービス参照リポジトリに追加されます。

Webサービス参照リポジトリの使用

Webサービス参照がWebサービス参照リポジトリに格納されます。

Webサービス参照リポジトリにアクセスするには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。
アプリケーション・ビルダーが表示されます。

3. 「共有コンポーネント」をクリックします。
共有コンポーネント・ページが表示されます。

4. 「ロジック」で、「Webサービス参照」をクリックします。
Webサービス参照ページが表示されます。

ページ上部の「ナビゲーション」バーを使用して、Webサービス参照の検索またはページ表示の変更を行います。使用可能なオプションは次のとおりです。

- Webサービス参照 - 参照名に大/小文字を区別しない問合せを入力して、「実行」をクリックします。すべてのWebサービス参照を表示するには、フィールドを空白のままにして「実行」をクリックします。

- ビュー - 表示モードを選択して「実行」をクリックします。使用可能なオプションは次のとおりです。

- アイコン(デフォルト): 各Webサービス参照を大きいアイコンとして表示します。Webサービス参照を編集するには、該当するアイコンをクリックします。

- 詳細 : 各Webサービス参照をレポートで1行に表示します。

5. 「ビュー」リストから「詳細」を選択し、「実行」をクリックします。

6. 「詳細」ビューでは、次の操作を実行できます。

- 参照名をクリックして参照を編集します。

- 「実行」アイコンをクリックして参照をテストします。

- 「ビュー」アイコンをクリックして参照に関する詳細を表示します。このオプションは、手動作成されたWebサービス参照には使用できないことに注意してください。

WSDLから作成されたWebサービス参照のテスト

Webサービス参照を作成した後、Webサービス参照のテスト・ページでテストできます。

Webサービス参照をテストするには、次のステップを実行します。

1. Webサービス参照ページにナビゲートします。「Webサービス参照ページへのアクセス」を参照してください。

2. 「ビュー」から、「詳細」を選択します。

3. Webサービス参照名の横にある「 実行 」アイコンをクリックします。
Webサービス参照のテスト・ページが表示されます。ページの上部に、Webサービス名とURLエンドポイントが表示されます。

4. 「操作」から、実行する操作を選択します。

5. 「入力パラメータ」で、適切な値を入力します。

6. 「テスト」をクリックします。
ページの下部に、メッセージ・リクエストとレスポンスが表示されます。

手動作成されたWebサービス参照のテスト

Webサービス参照を作成した後、Webサービス参照のテスト・ページでテストできます。

Webサービス参照をテストするには、次のステップを実行します。

1. Webサービス参照ページにナビゲートします。「Webサービス参照ページへのアクセス」を参照してください。

2. 「ビュー」から、「詳細」を選択します。

3. Webサービス参照名の横にある「 実行 」アイコンをクリックします。
Webサービス参照のテスト・ページが表示されます。ページの上部に、Webサービス名とURLエンドポイントが表示されます。

4. 必要に応じて、「Basic認証」でユーザー名およびパスワードを入力します。

5. 「SOAPエンベロープ」テキスト領域では、オプションで、SOAPリクエスト・エンベロープを編集します。

6. 「テスト」をクリックします。
ページの下部に、メッセージ・リクエストとレスポンスが表示されます。

Webサービスでの入力フォームとレポートの作成

Webサービスのフォームとレポートの作成ウィザードでは、入力フォーム、送信ボタンおよび結果を表示するレポートが作成されます。WSDLからWebサービス参照を作成した直後、またはページを追加して、このウィザードを実行できます。

このウィザードは、Webサービスの結果が非スカラーであることが予想される場合に使用します。Amazon社のWebサービスがよい例です。このWebサービスでは、入力フォームに入力された検索基準に基づいて多くの結果が戻されます。

参照を作成した後のフォームとレポートの作成

Webサービス参照を作成した後に、フォームとレポートを作成するには、次のステップを実行します。

1. Webサービス参照を作成します。「WSDLに基づいたWebサービス参照の作成」を参照してください。

2. Webサービス参照が追加された後で、「Webサービスのフォームとレポートの作成」を選択します。

3. 「サービスと操作の選択」で、次の操作を実行します。

1. Webサービス参照: Webサービス参照を選択します。

2. 操作: 実行方法を選択します。

4. 「ページおよびリージョン属性」で、表示された属性を確認します。指定したページが存在しない場合は、ウィザードによってページが作成されます。

5. 「入力アイテム」で、次のステップを実行します。

1. フォームに追加するアイテムを指定します。アイテムを含めるには、「作成」列で「はい」を選択します。そうでない場合は、「いいえ」を選択します。

2. 必要に応じて、アイテム・ラベルを編集します。

6. 該当する場合、Basic認証に「アイテム名」および「アイテム・ラベル」を指定します。このステップは、Webサービス参照を作成したときに、Basic認証がこのWebサービス参照に対して指定された場合にのみ表示されることに注意してください。

7. ウィンドウ・サービスの結果で、次の操作を実行します。

1. 一時結果セット名: Webサービスの結果を格納するコレクションの名前を入力します。

2. レポート対象の結果ツリー - 作成されるXML文書(レポートに含める情報を含む)の一部を選択します。

8. 「表示する結果パラメータ」で、レポートに含めるパラメータを選択します。

9. 「終了」をクリックします。

新しいページの追加によるフォームとレポートの作成

既存のWebサービス参照がある場合は、新しいページを追加して、入力フォームとレポートを作成できます。

新しいページを追加して、フォームとレポートを作成するには、次のステップを実行します。

1. Webサービス参照を作成します。「WSDLに基づいたWebサービス参照の作成」を参照してください。

2. 新しいページを作成します。「アプリケーション内のページの管理」を参照してください。
「ページの作成」ウィザードで、次のステップを実行します。

1. 「フォーム」を選択します。

2. 「Webサービスのフォームとレポート」を選択します。

3. 「サービスと操作の選択」で、次の操作を実行します。

1. Webサービス参照: Webサービス参照を選択します。

2. 操作: 実行方法を選択します。

4. 「ページおよびリージョン属性」で、ページとリージョン属性を確認します。指定したページが存在しない場合は、ウィザードによってページが作成されます。

5. 「入力アイテム」で、次のステップを実行します。

1. フォームに追加するアイテムを指定します。アイテムを含めるには、「作成」列で「はい」を選択します。そうでない場合は、「いいえ」を選択します。

2. 必要に応じて、アイテム・ラベルを編集します。

6. 該当する場合、Basic認証に「アイテム名」および「アイテム・ラベル」を指定します。このステップは、Webサービス参照を作成したときに、Basic認証がこのWebサービス参照に対して指定された場合にのみ表示されることに注意してください。

7. 画面に表示されるステップに従います。

8. 「終了」をクリックします。

Webサービスでのフォームの作成

Webサービスのフォームの作成ウィザードでは、フォームと送信ボタンが作成されます。WSDLのWebサービス参照を作成した後に、またはページ定義から、このウィザードを実行できます。

このウィザードは、Webサービスの結果がスカラーであることが予想される場合に使用します。株価を調べるWebサービスがよい例です。入力は銘柄記号で、出力はスカラーの適正価格であるためです。

参照を作成した後のフォームの作成

Webサービス参照を作成した後に、フォームを作成するには、次のステップを実行します。

1. Webサービス参照を作成します。「WSDLに基づいたWebサービス参照の作成」を参照してください。

2. Webサービス参照が追加された後で、「Webサービスのフォームの作成」を選択します。

3. 「サービスと操作の選択」で、次の操作を実行します。

1. Webサービス参照: Webサービス参照を選択します。

2. 操作: 実行方法を選択します。

4. 「ページおよびリージョン属性の指定」で、ページとリージョン属性を確認します。指定したページが存在しない場合は、ウィザードによってページが作成されます。

5. 「入力パラメータのアイテム」で、次の操作を実行します。

1. 追加するアイテムを指定します。アイテムを含めるには、「作成」列で「はい」を選択します。そうでない場合は、「いいえ」を選択します。

2. 必要に応じて、アイテム・ラベルを編集します。

6. 「出力パラメータのアイテム」で、次の操作を実行します。

1. 追加する必要があるアイテムを指定します。アイテムを含めるには、「作成」列で「はい」を選択します。そうでない場合は、「いいえ」を選択します。

2. 必要に応じて、アイテム・ラベルを編集します。

7. 該当する場合、Basic認証に「アイテム名」および「アイテム・ラベル」を指定します。
このステップは、Webサービス参照を作成したときに、Basic認証がこのWebサービス参照に対して指定された場合にのみ表示されることに注意してください。

8. 「終了」をクリックします。

新しいページの追加によるフォームの作成

WSDLから作成された既存のWebサービス参照がある場合は、新しいページを追加して、フォームを作成できます。

新しいページを追加して、フォームを作成するには、次のステップを実行します。

1. Webサービス参照を作成します。「WSDLに基づいたWebサービス参照の作成」を参照してください。

2. 新しいページを作成します。「アプリケーション内のページの管理」を参照してください。
「ページの作成」ウィザードで、次のステップを実行します。

1. 「フォーム」を選択します。

2. 「Webサービスのフォーム」を選択します。

3. 「Webサービス参照と操作」で、Webサービス参照および実行する操作を選択します。

4. 「ページおよびリージョン属性の指定」で、ページとリージョン属性を確認します。指定したページが存在しない場合は、ウィザードによってページが作成されます。

5. 「入力パラメータのアイテム」で、次の操作を実行します。

1. 追加する必要があるアイテムを指定します。アイテムを含めるには、「作成」列で「はい」を選択します。そうでない場合は、「いいえ」を選択します。

2. 該当する場合、Basic認証に「アイテム名」および「アイテム・ラベル」を指定します。
このステップは、Webサービス参照を作成したときに、Basic認証がこのWebサービス参照に対して指定された場合にのみ表示されることに注意してください。

6. 「出力パラメータのアイテム」で、次の操作を実行します。

1. 追加する必要があるアイテムを指定します。アイテムを含めるには、「作成」列で「はい」を選択します。そうでない場合は、「いいえ」を選択します。

2. 必要に応じて、アイテム・ラベルを編集します。

7. 「終了」をクリックします。

プロセスとしてのWebサービスの起動

ページ上で、Webサービスをプロセスとして実装することもできます。このプロセスを実行すると、リクエストがサービス・プロバイダに送信されます。その後で、レポートにリクエスト結果を表示できます。

Webサービスをプロセスとして起動するには、次のステップを実行します。

1. ページを作成します。「アプリケーション内のページの管理」を参照してください。
「ページの作成」ウィザードで、次のステップを実行します。

1. 「空白ページ」を選択します。

2. タブの使用を確認するプロンプトが表示されたら、「いいえ」を選択します。

2. ページ定義にナビゲートします。「ページ定義へのアクセス」を参照してください。

3. 「ページ・レンダリング」の「プロセス」で、「作成」アイコンをクリックします。
「ページ・プロセスの作成」ウィザードが表示されます。

4. プロセスのカテゴリから、「Webサービス」を選択します。

5. プロセス名、順序およびプロセス・ポイントを指定します。

6. Webサービス参照を選択します。
Web参照がWSDLから作成された場合、次の追加のステップを実行します。

7. Webサービス参照および実行する操作を選択します。

8. プロセスを定義します。「Webサービスの出力パラメータ」でオプションを選択すると、結果をコレクションまたはページ上のアイテムに格納できます。

1. コレクションに結果を格納するには、次のステップを実行します。

- 「結果の格納場所」で、「コレクション」を選択します。

- 「値」フィールドにコレクションの名前を入力します。

2. ページ上のアイテムに結果を格納するには、次のステップを実行します。

- 「結果の格納場所」で、「アイテム」を選択します。

- 表示されるフィールドに該当するアイテムの値を入力します。

9. 「プロセスの作成」をクリックします。

レポートでのWebサービス結果の表示

Webサービスのリクエスト結果を表示するレポートを作成するには、次のステップを実行します。

1. ページ定義にナビゲートします。「ページ定義へのアクセス」を参照してください。

2. 「リージョン」で、「作成」アイコンをクリックします。
「リージョンの作成」ウィザードが表示されます。

3. 「リージョン・タイプ」で、「レポート」を選択します。

4. 「レポート実装」で、「Webサービスの結果を含むコレクションのレポート」を選択します。「リージョン属性を指定」で、リージョン・タイトルを入力し、オプションでリージョン属性を編集します。

5. Web参照が手動で作成されたか、またはWSDLから作成されたかを選択します。

6. Webサービス参照がWSDLから作成された場合、次のステップを実行します。

1. 「Webサービス参照と操作」で、Webサービス参照および実行する操作を選択します。

2. 「レポート対象の結果ツリー」で、作成されるXML文書(レポートに含める情報を含む)の一部を選択します。

3. 「結果パラメータ」で、次のステップを実行します。

- 「一時結果セット名」に、Webサービスの結果を格納するコレクションの名前を入力します。

- 該当するパラメータを選択した後、選択解除します。

7. Webサービス参照が手動で作成された場合、次のステップを実行します。

1. Webサービス参照を選択します。

2. SOAPスタイルを選択します。

3. メッセージの書式を選択します。

4. レポートの対象となるノードへのXPath式を入力します。

5. SOAPレスポンス・エンベロープのネームスペースを入力して、「次へ」をクリックします。

6. レスポンス・メッセージが格納されているコレクション名を入力します。

7. レポートに含めるパラメータ名を入力します。

8. 「SQLレポートの作成」をクリックします。

Webサービス・プロセスの編集

WSDLから作成されたWebサービス参照のWebサービス・タイプのプロセスを作成した後で、Webサービス・プロセスを編集すると、入力パラメータを静的な値にマップできます(たとえば、キーを渡すなど)。

Webサービス・プロセスを編集するには、次のステップを実行します。

1. Webサービス・プロセスを作成します。詳細は、「プロセスとしてのWebサービスの起動」を参照してください。

2. Webサービス・プロセスが含まれているページ定義にナビゲートします。

3. プロセス名を選択します。
「ページ・プロセスの編集」ページが表示されます。

4. 入力パラメータを静的な値にマップするには、次のステップを実行します。

1. 「Webサービスの入力パラメータ」までスクロールします。

2. 該当するパラメータ名の横にある「値」フィールドに値を入力します。

5. 「変更の適用」をクリックします。

Webサービス参照履歴の表示

「Webサービス履歴」では、カレント・アプリケーションのWebサービス参照の変更が、アプリケーションID、Webサービス参照名、開発者および日付ごとに表示されます。

Webサービス参照の変更履歴を表示するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。
アプリケーション・ビルダーが表示されます。

3. 「共有コンポーネント」をクリックします。
共有コンポーネント・ページが表示されます。

4. 「ロジック」で、「Webサービス参照」をクリックします。

5. 「履歴」をクリックします。

注意:
「Webサービス参照」ページに「履歴」ボタンが表示されるのは、Webサービス参照を作成した後のみです。

フォームおよびレポートでのBLOBサポートについて

Oracle Application Expressでは、リリース3.1から宣言的なBLOBサポートが提供されているため、開発者はフォームでのファイルのアップロード、およびレポートでのファイルのダウンロードや表示を行うことができます。BLOBの表示とダウンロードは、PL/SQLを使用して手続き的に作成することもできます。このセクションでは、ファイルのアップロード、ダウンロードおよび表示を行う方法と、BLOB列に格納されているファイルを正しく管理するために重要となる追加のファイル属性(MIMEタイプやファイル名など)の管理方法について説明します。この機能を使用すると、簡単にOracle Application Expressアプリケーションを拡張して、イメージ、ドキュメント、ビデオなどのファイルを管理できます。

この項に含まれる内容は次のとおりです。

- フォームでのBLOBについて

- レポートでのBLOBサポートについて

- 手続き的なBLOBの使用

フォームでのBLOBについて

フォームを作成する場合(アプリケーションの作成ウィザードを使用して、フォーム型またはレポートおよびフォーム型のページを作成するか、フォーム型のリージョンを作成)、または既存のフォームにアイテムを追加する場合、BLOB型のデータベース列がソースであるアイテムは、ファイル参照型のアイテムになります。フォームがINSERTにコールされる場合、ユーザーが選択したファイルは、BLOB列にロードされます。フォームが更新にコールされる場合、ダウンロード・リンクが「参照」ボタンの右に表示されます。ユーザーは、このリンクを使用してファイルをダウンロードできます。

BLOBの移入とダウンロードの提供

デフォルトのBLOBサポートでは、一般的なアプリケーションでBLOBを効果的に管理するために必要とされるすべての情報が提供されているわけではありません。列がBLOBであるという情報に加えて、ファイルの詳細情報も提供されると、エンド・ユーザーの使いやすさが向上します。この追加情報の管理を簡単に行うために、(DB_COLUMNに加えて)追加コンポーネントを使用できるようにアイテムのソース属性が拡張されています。

位置

属性

必須

説明

1

BLOBを含む列

はい

BLOBタイプの列の名前(大/小文字が区別されます)。

2

MIMEタイプ列

いいえ

MIMEタイプを格納するために使用する列名(大/小文字が区別されます)。

3

ファイル名列

いいえ

BLOBのファイル名を格納するために使用する列名(大/小文字が区別されます)。ユーザーがファイルをダウンロードするときにNULLの場合は、この列名がデフォルトで使用されます。

4

最終更新列

いいえ

BLOBの最終更新日付を格納するために使用する列名(大/小文字が区別されます)。これを指定すると、ファイルをダウンロードする際のHTTPヘッダーに最終変更日が示され、BLOBをブラウザにキャッシュできるようになります。指定しない場合は、ファイルをブラウザにキャッシュできない場合があります。

5

キャラクタ・セット列

いいえ

BLOBのキャラクタ・セットを格納するために使用する列名(大/小文字が区別されます)。キャラクタ・セットのエンコーディングを維持する必要がある場合など、アジア言語で最も使用されます。

6

コンテンツ配置

いいえ

inlineまたはattachmentを指定します。その他の値はすべて無視されます。attachmentがデフォルト値です。inlineはMIMEタイプが指定されている場合のみ指定できます。

7

ダウンロード・テキスト

いいえ

ダウンロード・リンクに使用する文字列。何も指定されていない場合は、Downloadが使用されます。これは置換をサポートしています(翻訳されたアプリケーションに有効です)。

次に例を示します。

RESUME:RESUME_MIMETYPE:RESUME_FILENAME:RESUME_LAST_UPDATE::attachment:Resume

ファイル参照タイプのアイテムを使用しており、そのソースが1つ以上のコロンを含むデータベース列(RESUME:など)である場合、 「ソース」の下にリンク「BLOBダウンロードの書式マスク」が表示されます。このポップアップは、BLOB書式に必要なすべてのパラメータを入力するために役立ちます。

最低でも、1つ以上の末尾のコロンを使用してデータベースのBLOB列を指定する必要があります(RESUME:など)。これにより、Oracle Application Expressリリース3.0.1との互換性が維持されます。

ヒント:
実際の例を確認するには、サンプル・アプリケーションのページ6 (「Add/Modify Products」)に移動し、アイテムP6_PRODUCT_IMAGEを確認します。「デモンストレーション・アプリケーションの実行」を参照してください。

この追加情報を提供するには、MIMEタイプ属性とファイル名属性を格納して追跡するための列を実表に追加することをお薦めします。この追加は表を拡張するだけで簡単に行うことができます。次に例を示します。

ALTER TABLE emp ADD
(ATTACH_MIMETYPE     VARCHAR2(255),
ATTACH_FILENAME     VARCHAR2(255),
ATTACH_LAST_UPDATE  DATE);

フォームを手動で作成している場合も、この機能を利用できます。DML_PROCESS_ROWタイプのDMLプロセスを使用して、ファイル・タイプ(ファイル参照)のアイテム内に記述されている書式をページ上で使用します。この処理により、表名と主キーの列が決定されます。

BLOBの表示

作業中のBLOBがイメージである場合は、そのイメージをフォームでも表示できます。「手続き的なBLOBの使用」を参照してください。

イメージ参照の削除

ファイル参照の使用時はNULLへの設定が存在しないため、イメージ参照を削除するメカニズムを提供する必要がある場合は、イメージを削除する特別なボタン(必要な列を無効化する機能を持つボタン)を含める必要があります。次に例を示します。

UPDATE demo_product_info
SET product_image = NULL,
MIMETYPE = NULL,
FILENAME = NULL,
IMAGE_LAST_UPDATE = NULL,
CHARSET = NULL
WHERE product_id = :P6_PRODUCT_ID;

ヒント:
実際の例を確認するには、サンプル・アプリケーションのページ6 (「Add/Modify Products」)→「Delete Image」プロセスに移動します。「デモンストレーション・アプリケーションの実行」を参照してください。

レポートでのBLOBサポートについて

Oracle Application Expressでは、従来のレポートと対話モード・レポートの両方に対するBLOBサポートが提供されています。ウィザードを使用してレポートを作成し、BLOBタイプの列を含める場合は、基本的なサポートが含まれます。ダウンロード機能を使いやすくするために、生成後に詳細情報を追加する必要があります。

ダウンロード・リンクの提供

レポートにダウンロード・リンクを容易に含めることができるように、レポートにはBLOBの長さ(dbms_lob.getlength(RESUME)など)を選択します。長さが0の場合、BLOBはNULLとなり、ダウンロード・リンクは表示されません。同様に、ダウンロード・リンクの書式を設定できる、日付または数に対する書式マスクを指定します。DOWNLOAD書式は、次の例のように3つ以上のパラメータを指定する必要があるという点で他の書式マスクより複雑です。

DOWNLOAD:EMP:RESUME:EMPNO

次の表に、DOWNLOAD書式のパラメータの説明を示します。

位置

属性

必須

説明

1

DOWNLOAD

はい

DOWNLOADレポート書式マスクを指定します。

2

表名

はい

BLOBタイプのターゲット列を含む表の名前(大/小文字が区別されます)。

3

BLOBを含む列

はい

BLOBタイプの列の名前(大/小文字が区別されます)。

4

主キー列1

はい

主キー列1の名前。大文字と小文字が区別されます。

5

主キー列2

いいえ

主キー列2の名前。大文字と小文字が区別されます。

6

MIMEタイプ列

いいえ

MIMEタイプを格納するために使用する列名(大/小文字が区別されます)。

7

ファイル名列

いいえ

BLOBのファイル名を格納するために使用する列名(大/小文字が区別されます)。ユーザーがファイルをダウンロードするときにNULLの場合は、この列名がデフォルトで使用されます。

8

最終更新列

いいえ

BLOBの最終更新日付を格納するために使用する列名(大/小文字が区別されます)。これを指定すると、ファイルをダウンロードする際のHTTPヘッダーに最終変更日が示され、BLOBをWebブラウザにキャッシュできるようになります。指定しない場合は、ファイルをブラウザにキャッシュできない場合があります。

9

キャラクタ・セット列

いいえ

BLOBのキャラクタ・セットを格納するために使用する列名(大/小文字が区別されます)。キャラクタ・セットのエンコーディングを維持する必要がある場合など、アジア言語で最も使用されます。

10

コンテンツ配置

いいえ

inlineまたはattachmentを指定します。その他の値はすべて無視されます。MIMEタイプが提供され、ファイルが表示可能なタイプである場合は、ファイルが表示されます。MIMEタイプが提供されていない場合、またはファイルをインラインで表示できない場合、ユーザーはダウンロードを行うように求められます。

11

ダウンロード・テキスト

いいえ

ダウンロード・リンクに使用する文字列。何も指定されていない場合は、Downloadが使用されます。これは置換をサポートしています(翻訳されたアプリケーションに有効です)。

次に例を示します。

DOWNLOAD:EMP:RESUME:EMPNO::RESUME_MIMETYPE:RESUME_FILENAME:RESUME_LAST_UPDATE::attachment:Resume

DOWNLOAD:で始まる書式マスクを使用するレポート列がある場合、書式の下にリンク「BLOBダウンロードの書式マスク」が表示されます。このポップアップは、DOWNLOAD書式に必要なすべてのパラメータを入力するために役立ちます。

ヒント:
実際の例を確認するには、サンプル・アプリケーションのページ29 (「Master Detail」)→「Items for Order #&P29_ORDER_ID.」リージョン→「Product Image」列に移動します。「デモンストレーション・アプリケーションの実行」を参照してください。

BLOBの表示

作業中のBLOBがイメージである場合は、レポートでも表示できます。そのためには、新しいレポート書式マスク「IMAGE」を使用します。MIMEタイプに関係なく、レポートでは常にBLOBの表示が試行されます。BLOBのレンダリングを行うことができない場合は、壊れたイメージが表示されます。

次の表に、IMAGE書式マスクのパラメータの説明を示します。

位置

属性

必須

説明

1

IMAGE

はい

IMAGEレポート書式マスクを指定します。

2

表名

はい

BLOBタイプのターゲット列を含む表の名前(大/小文字が区別されます)。

3

BLOBを含む列

はい

BLOBタイプの列の名前(大/小文字が区別されます)。

4

主キー列1

はい

主キー列1の名前。大文字と小文字が区別されます。

5

主キー列2

いいえ

主キー列2の名前。大文字と小文字が区別されます。

6

MIMEタイプ列

いいえ

MIMEタイプを格納するために使用する列名(大/小文字が区別されます)。

7

ファイル名列

いいえ

IMAGE書式には使用しませんが、IMAGEとDOWNLOAD間で書式を簡単に変更する場合に必要です。

8

最終更新列

いいえ

BLOBの最終更新日付を格納するために使用する列名(大/小文字が区別されます)。これを指定すると、ファイルをダウンロードする際のHTTPヘッダーに最終変更日が示され、BLOBをWebブラウザにキャッシュできるようになります。指定しない場合は、ファイルをブラウザにキャッシュできない場合があります。

9

キャラクタ・セット列

いいえ

IMAGE書式には使用しませんが、IMAGEとDOWNLOAD間で書式を簡単に変更する場合に必要です。

10

コンテンツ配置

いいえ

IMAGE書式には使用しませんが、IMAGEとDOWNLOAD間で書式を簡単に変更する場合に必要です。

11

代替テキスト

いいえ

イメージに関連付けられている代替タグに使用する文字列です。

次に例を示します。

IMAGE:EMP:RESUME:EMPNO::RESUME_MIMETYPE:RESUME_FILENAME:RESUME_LAST_UPDATE::attachment:Resume

書式マスクがIMAGE:で始まるレポート列がある場合、書式「BLOBダウンロードの書式マスク」の下のリンクを参照してください。このポップアップはIMAGE書式に必要なすべてのパラメータの入力に役立ちます。

手続き的なBLOBの使用

ダウンロード・リンクを指定した組込み方式を使用するかわりに、APEX_UTIL.GET_BLOB_FILE_SRCファンクションを使用できます。この方法を使用すると、イメージの表示形式をより具体的に設定できます(高さタグおよび幅タグを使用)。この方法は、有効なOracle Application Expressセッションからコールされた場合のみ有効であることに注意してください。また、BLOBを記述するパラメータを、アプリケーション内の有効なアイテムの書式としてリストする必要もあります。この項目は後でファンクションが参照します。

関連項目:
Oracle Application Express APIリファレンスの「GET_BLOB_FILE_SRCファンクション」

16 アプリケーションのグローバリゼーションの管理

このセクションでは、アプリケーション・ビルダーで構築したアプリケーションを翻訳する方法を説明します。

この項には、次の項目が含まれます。

- アプリケーションの翻訳およびグローバリゼーション・サポートについて

- アプリケーションへのプライマリ言語の指定

- 翻訳プロセスの理解

- メッセージの翻訳

- LOVをサポートするデータの翻訳

- サポートされるグローバリゼーション・コードについて

関連項目:
Oracle Application Express管理ガイドの「インストール済の翻訳の表示」

アプリケーションの翻訳およびグローバリゼーション・サポートについて

アプリケーション・ビルダーで、同時に異なる言語で実行可能なアプリケーションを開発できます。1つのOracle DatabaseインスタンスとOracle Application Expressで、異なる言語をサポートするようにカスタマイズされた複数のデータベース・セッションをサポートできます。

一般的に、アプリケーション・ビルダーで構築したアプリケーションの翻訳は、次のようなステップになります。

- プライマリおよびターゲットのアプリケーションIDをマップします

- 翻訳用のファイルにテキストをシードおよびエクスポートします

- ファイルのテキストを翻訳します

- 翻訳済ファイルを適用します

- 翻訳済ファイルを公開します

関連項目:
「翻訳プロセスの理解」

この項に含まれる内容は次のとおりです。

- 言語の指定について

- アプリケーション・ビルダーで構築したアプリケーションの翻訳ルール

- 翻訳済アプリケーションのレンダリング方法

- 翻訳可能なコンポーネントについて

言語の指定について

アプリケーションの作成後、グローバリゼーション属性の編集ページで言語プリファレンスを指定します。次に、プライマリ・アプリケーションの言語を選択し、Application Expressエンジンによるアプリケーション言語の決定方法を決定します。ユーザーのブラウザの言語プリファレンス、アプリケーション・プリファレンスまたはアイテム・プリファレンスに基づいてアプリケーション言語を指定できます。

関連項目:
「アプリケーションへのプライマリ言語の指定」

アプリケーション・ビルダーで構築したアプリケーションの翻訳ルール

次のルールを使用して、使用する翻訳のバージョンを決定します。

- ユーザーの言語プリファレンスに完全一致する言語コードの翻訳済アプリケーションを検索します。

- 部分一致を検索します。つまり、言語およびロケールが存在するかどうかを確認します。たとえば、ユーザーの言語プリファレンスがen-usで、en-usの翻訳済バージョンが存在しない場合は、言語コードがenの翻訳済アプリケーションを検索します。

- アプリケーションのプライマリ言語を使用します。

たとえば、プライマリ言語がドイツ語(de)のアプリケーションを作成し、言語コードがen-usの翻訳バージョンを作成すると想定します。ユーザーがブラウザ言語en-usを使用してこのアプリケーションにアクセスすると、英語(en-us)バージョンのアプリケーションが実行されます。ユーザーがブラウザ言語en-gbを使用してこのアプリケーションにアクセスすると、アプリケーションがプライマリ言語(つまりドイツ語)で表示されます。この例では、enのすべてのバリエーションに対応するために、言語コードenを使用して英語の翻訳バージョンを作成する必要があります。

翻訳済アプリケーションのレンダリング方法

Oracle Application Expressがアプリケーションの言語を決定した後、Application Expressエンジンは、特定のページ・リクエストに対してデータベース言語を変更します。その後、適切な言語に翻訳されたアプリケーションを検索します。Application Expressエンジンはその言語を検出すると、その定義を使用してアプリケーションをレンダリングします。それ以外の場合は、ベース(プライマリ)のアプリケーション言語でアプリケーションをレンダリングします。

アプリケーション内に表示されるテキストは、すぐには翻訳されないことに注意してください。Oracle Application Expressは、ベース言語アプリケーション定義または代替アプリケーション定義のいずれかから動的にページ属性を収集します。

関連項目:
「テキスト文字列の動的翻訳について」および「LOVをサポートするデータの翻訳」

翻訳可能なコンポーネントについて

Application Builderでアプリケーションを作成する際、フィールド・ラベル、リージョン・ヘッダー、ページ・ヘッダー・テキストなど、多数の宣言的な属性を定義します。この項で説明するステップを使用して、アプリケーション内のすべてのアプリケーション定義属性を翻訳可能にできます。

メッセージの言語変換をサポートするショートカットについて

Application Builderには、翻訳可能なメッセージを参照できる2つのタイプのショートカットがあります。

- メッセージ:翻訳可能なメッセージを実行時に参照するには、このショートカットを使用します。ショートカット名は、対応するメッセージ名と一致させる必要があります。実行時、ショートカット名は、現在の言語に変換可能なメッセージのテキストに拡張されます。

- JavaScriptにより一重引用符がエスケープされたメッセージ:JavaScriptリテラル文字列内部のショートカットを参照し、実行時に翻訳可能なメッセージを参照するには、このショートカットを使用します。このショートカットは、テキスト文字列を定義します。ショートカットが参照されると、JavaScriptに必要な一重引用符がエスケープされます。

関連項目:
「ショートカットの使用」

メッセージについて

アプリケーションにPL/SQLリージョンまたはPL/SQLプロセスが含まれている場合には、生成されるHTMLまたはテキストを翻訳する必要がある場合があります。また、Oracle Application Expressが翻訳されている10の言語以外の言語をアプリケーションで使用する場合、レポートで使用されるメッセージの翻訳が必要な場合もあります。

関連項目:
「メッセージの翻訳」

テキスト文字列の動的翻訳について

動的翻訳は、実行時に翻訳する必要があるデータベース・データに使用されます。たとえば、動的翻訳を使用して、データベース問合せに基づくLOVを翻訳する場合があります。動的翻訳は、翻訳元の言語文字列、言語コードおよび翻訳先の文字列で構成されています。また、APEX_LANG.LANG APIを使用して、動的翻訳をプログラム的に取得できます。

関連項目:
「LOVをサポートするデータの翻訳」

リージョン・タイトルの翻訳について

デフォルトでは、ページ・リージョン・タイトルは、生成された翻訳ファイルに含まれます。ただし、リージョン・タイトルは、翻訳不可と指定できます。

リージョン・タイトルを翻訳不可と指定するには、次のステップを実行します。

1. ページ定義にナビゲートします。「ページ定義へのアクセス」を参照してください。

2. ページ定義で、リージョン・タイトルをクリックします。
リージョンの編集ページが表示されます。

3. 「タイトルを翻訳から除外」チェック・ボックスを選択します。

翻訳テンプレートについて

デフォルトでは、テンプレートは翻訳可能ではないため、生成された翻訳ファイルには含まれません。通常、テンプレートには翻訳可能なテキストを含めません。ただし、テンプレートを翻訳可能として指定する必要がある場合は、ページ・テンプレートの編集ページで、「翻訳可能」チェック・ボックスを選択します。

テンプレートを翻訳可能として指定するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

4. 「ユーザー・インタフェース」で、「テンプレート」を選択します。
テンプレート・ページが表示されます。

5. 編集するテンプレートを検索して、テンプレート名を選択します。

6. 「名前」の下で「翻訳可能」を選択します。

静的置換文字列を使用して翻訳可能なテキストを定義することで、翻訳可能なテキストをアプリケーション・レベルで含めることができます。アプリケーション・レベル属性は翻訳されるため、静的置換文字列として定義された任意のテキストは、生成された翻訳ファイルに含まれます。

関連項目:
「テンプレートのカスタマイズ」および「置換」

アプリケーションへのプライマリ言語の指定

グローバリゼーション属性は、Application Expressエンジンによるアプリケーションのプライマリ言語の決定方法を指定します。

グローバリゼーション属性を編集するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「グローバリゼーション」で、「属性の編集」をクリックします。

5. 「アプリケーションのプライマリ言語」から、アプリケーションが開発されている言語を選択します。

6. 「アプリケーション言語の派生元」から、Application Expressエンジンによるアプリケーション言語の決定(派生)方法を指定します。表 16-1に、使用可能なオプションを示します。

表 16-1 アプリケーション言語の派生元オプション

オプション

説明

NLSなし(アプリケーションは翻訳されない)

このオプションは、アプリケーションが翻訳されない場合に選択します。

アプリケーションのプライマリ言語を使用

アプリケーションのプライマリ言語属性に基づいて、アプリケーションのプライマリ言語を決定します(ステップ5を参照)。

ブラウザ(ブラウザの言語プリファレンスを使用)

ユーザーのブラウザの言語設定に基づいて、アプリケーションのプライマリ言語を決定します。

アプリケーション・プリファレンス(FSP_LANGUAGE_PREFERENCEを使用)

APEX_UTIL.SET_PREFERENCE APIを使用して定義された値に基づいて、アプリケーションのプライマリ言語を決定します。選択した言語プリファレンスを複数のログインで維持するには、このオプションを選択します。

関連項目: Oracle Application Express APIリファレンスの「SET_PREFERENCEプロシージャ」

アイテム・プリファレンス(プリファレンスを含むアイテムを使用)

FSP_LANGUAGE_PREFERENCEと呼ばれるアプリケーション・レベル・アイテムに基づいて、アプリケーションのプライマリ言語を決定します。このオプションを使用すると、ログインするたびにOracle Application Expressで適切な言語設定を決定する必要があります。

関連項目:
「アプリケーション定義の構成」、「グローバリゼーション属性の構成」および「サポートされるグローバリゼーション・コードについて」

アイテムの書式マスクの使用

Application Expressエンジンは、レンダリングされた各ページにグローバリゼーション設定を適用します。デフォルトの動作は、数字や日付などの特定のアイテムの表示に影響する可能性があります。

たとえば、ユーザーのブラウザの言語設定に基づいて、アプリケーション言語を決定するとします。Application Expressエンジンが、ユーザーのブラウザの言語設定をフランス語と決定した場合、日付および数字は、フランス語の標準に合わせた書式で表示されます。書式マスクを適用することによって、このデフォルトの動作をオーバーライドし、アイテムの表示方法を明示的に制御できます。「表示形式」リストから選択して、書式マスクを適用します。

- アイテム作成時

- アイテム属性を編集してアイテムを作成した後

次のステップでは、データベース列のソース・タイプを持つアイテムの属性の編集方法を説明します。

アイテム属性を編集するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. ページを選択します。
ページ定義が表示されます。

4. 「アイテム」で、アイテム名を選択します。
「ページ・アイテムの編集」ページが表示されます。

5. 「名前」の下で、「表示形式」リストから選択します。

6. 「ソース」の下で書式マスクを選択または入力します。

マルチバイト言語用のアプリケーション翻訳

アプリケーションを複数の言語(中国語と日本語など)で同時に実行する必要がある場合、すべての言語をサポートするキャラクタ・セットを使用してデータベースを構成することを検討してください。同じキャラクタ・セットは、mod_plsqlの対応するデータベース・アクセス記述子(DAD)で構成する必要があります。UTF8およびAL32UTF8は、ほぼすべての言語をサポートするために使用できるキャラクタ・セットです。

翻訳プロセスの理解

アプリケーション・ビルダーで開発したアプリケーションを翻訳するには、プライマリおよびターゲット言語をマップし、テキストを翻訳ファイルにシードおよびエクスポートし、テキストを翻訳し、翻訳ファイルを適用し、翻訳済アプリケーションを公開する必要があります。

この項に含まれる内容は次のとおりです。

- ステップ1: ターゲット言語のマップ

- ステップ2: 翻訳ファイルへのテキストのシードおよびエクスポート

- ステップ3: XLIFFファイルの翻訳

- ステップ4: 翻訳済XLIFFドキュメントのアップロードおよび適用とアプリケーションの公開

- 翻訳の手動編集

関連項目:
「メッセージの翻訳」および「LOVをサポートするデータの翻訳」

ステップ1: ターゲット言語のマップ

アプリケーション翻訳の最初のステップは、プライマリおよびターゲットのアプリケーション言語をマップすることです。プライマリ・アプリケーションは、翻訳されるアプリケーションです。ターゲット・アプリケーションは、翻訳結果のアプリケーションです。

プライマリおよびターゲットのアプリケーション言語をマップするには、次のステップを実行します。

1. アプリケーションの翻訳ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「グローバリゼーション」の下で「アプリケーションの翻訳」をクリックします。
アプリケーションの翻訳ページが表示されます。

2. 「翻訳されたアプリケーションにプライマリ言語アプリケーションをマップ」をクリックします。
アプリケーション・マッピング・ページが表示されます。

3. 「作成」をクリックします。

4. 翻訳アプリケーション・マッピング・ページで、次のステップを実行します。

- 翻訳アプリケーション - ターゲット・アプリケーションを識別する数値のアプリケーションIDを入力します。翻訳済アプリケーションIDは整数である必要があり、末尾は0(ゼロ)以外の整数にする必要があります。

- 翻訳アプリケーション言語コード - 翻訳先となる言語を選択します。

- イメージ・ディレクトリ - イメージの取得元となるディレクトリを入力します。
この属性は、翻訳されたイメージの仮想パスを指定します。たとえば、プライマリ言語アプリケーションのイメージ接頭辞が/i/の場合、ドイツ語には/i/de/、スペイン語には/i/es/のように、その他の言語の仮想ディレクトリを追加で定義できます。

この言語特定のイメージ・ディレクトリは通常、ほとんどの翻訳済アプリケーションに必要がないことに注意してください。

5. 「作成」をクリックします。

ステップ2: 翻訳ファイルへのテキストのシードおよびエクスポート

2番目のステップでは、翻訳表をシードし、翻訳テキストを翻訳ファイルにエクスポートします。

この項に含まれる内容は次のとおりです。

- 翻訳可能なテキストのシード

- 翻訳ファイルへのテキストのエクスポート

翻訳可能なテキストのシード

翻訳のシードにより、すべての翻訳可能なテキストが翻訳テキスト・リポジトリにコピーされます。言語を指定して翻訳テキストをシードすると、翻訳用のXLIFFファイルを生成してエクスポートできます。

シード・プロセスでは、プライマリ言語アプリケーションと翻訳テキスト・リポジトリの同期がとられます。プライマリ言語アプリケーションを変更するたびに、シード・プロセスを実行する必要があります。

翻訳可能なテキストをシードするには、次のステップを実行します。

1. アプリケーションの翻訳ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「グローバリゼーション」の下で「アプリケーションの翻訳」をクリックします。
アプリケーションの翻訳ページが表示されます。

2. アプリケーションの翻訳ページで、「アプリケーションの翻訳テキストを翻訳ファイルにシードおよびエクスポート」を選択します。

3. 「言語マッピング」から、適切なプライマリおよびターゲットのアプリケーションIDマップを選択します。

4. 「翻訳可能なテキストのシード」をクリックします。
XLIFFのエクスポート・ページが表示されます。

注意:
XLIFF(XML Localization Interchange File Format)は、ローカリゼーション・データを変換するためのXMLベースのフォーマットです。XLIFFについて、またはXLIFF仕様を確認するには、次のURLを参照してください。

http://www.xliff.org

翻訳ファイルへのテキストのエクスポート

翻訳可能なテキストをシードすると、XLIFFのエクスポート・ページの上部のステータス・ボックスに、翻訳が必要な場合のある属性の合計数と次の項目の数が表示されます。

- 翻訳が必要な可能性のある既存の更新済属性

- 翻訳が必要な可能性のある新しい属性

- 翻訳が不要になった削除済属性

この情報を使用して、アプリケーション全体の翻訳可能なテキストをエクスポートするか、特定のページの翻訳可能なテキストをエクスポートするかを判断できます。

XLIFFのエクスポート・ページは、2つのセクションに分かれています。アプリケーション全体(すべてのページ、LOV、メッセージなど)の翻訳可能なテキストをエクスポートするには、ページの上のセクションを使用します。特定のページの翻訳可能なテキストをエクスポートするには、下のセクションを使用します。

アプリケーション全体の翻訳可能なテキストのエクスポート

アプリケーション全体の翻訳可能なテキストをエクスポートするには、次のステップを実行します。

1. 翻訳可能なテキストをシードします。「翻訳可能なテキストのシード」を参照してください。

2. 「XLIFFのエクスポート: ステップ2、XLIFFのエクスポート」で、次のステップを実行します。

1. 「アプリケーション」から、適切なプライマリおよびターゲットのアプリケーションIDマップを選択します。

2. XLIFFターゲット要素を含めるかどうかを指定します。

3. 「エクスポート」で、XLIFFファイルに含める翻訳テキストを指定します。

4. 「アプリケーションのXLIFFファイルのエクスポート」をクリックします。

3. 画面に表示されるステップに従います。

特定のページの翻訳可能なテキストのエクスポート

特定のページの翻訳可能なテキストをエクスポートするには、次のステップを実行します。

1. 「翻訳可能なテキストのシード」のとおり、翻訳可能なテキストをシードします。

2. 「特定ページのXLIFFのエクスポート」で、次のステップを実行します。

1. 「アプリケーション」から、適切なプライマリおよびターゲットのアプリケーションIDマップを選択します。

2. XLIFFターゲット要素を含めるかどうかを指定します。

3. 「エクスポート」で、XLIFFファイルに含める翻訳テキストを指定します。

4. 「ページのXLIFFファイルのエクスポート」をクリックします。

3. 画面に表示されるステップに従います。

含まれるXLIFFターゲット要素について

Oracle Application ExpressがXLIFFドキュメントを生成すると、各ドキュメントには複数の翻訳単位が含まれます。各翻訳単位は、ソース要素とターゲット要素で構成されます。XLIFFドキュメントは、各翻訳単位ごとのソースおよびターゲットの両方の要素で生成できます。生成するファイルにソース要素のみを含めることもできます。更新された翻訳は、翻訳単位のターゲット要素から適用されます。

エクスポートについて

「エクスポート」の下のオプションを使用して、XLIFFファイルに含める翻訳テキストを指定します。アプリケーションのすべての翻訳テキストを含めるには、「すべての翻訳可能な要素」を選択します。また、まだ翻訳されていない新しい要素のみを含めるには、「翻訳が必要な要素のみ」を選択します。「翻訳が必要な要素のみ」では、新規または変更された翻訳単位を含むXLIFFファイルが生成されます。また、翻訳単位が意図的に翻訳されなかった(つまり、翻訳要素のソースが翻訳要素のターゲットと同じである)場合は、これらの翻訳単位もそのファイルに含まれます

ステップ3: XLIFFファイルの翻訳

翻訳可能なファイルをXLIFFフォーマットにエクスポートすると、これを適切な言語に翻訳できます。XLIFFは翻訳のためのオープン標準のXMLファイルであるため、ほとんどの翻訳ベンダーでサポートされています。Oracle Application Expressは、UTF-8キャラクタ・セットでエンコードされたXLIFFファイルのみをサポートしています。つまり、Oracle Application Expressでは、翻訳用のXLIFFファイルはUTF-8でエクスポートされ、翻訳済XLIFFファイルも同じキャラクタ・セットであることを前提としています。

翻訳は時間のかかるタスクです。Oracle Application Expressでは、アプリケーション開発と翻訳を並行して行えるように、増分的な翻訳をサポートしています。XLIFFファイルの一部のみが翻訳されている場合でも、ファイルを翻訳してOracle Application Expressにアップロードできます。対応する翻訳済アプリケーションに翻訳がない文字列の場合、Oracle Application Expressは、プライマリ言語の対応する文字列を使用します。

関連項目:
XLIFFの詳細またはXLIFF仕様を確認するには、次のURLを参照してください。

http://www.xliff.org

ステップ4: 翻訳済XLIFFドキュメントのアップロードおよび適用とアプリケーションの公開

XLIFFドキュメントの翻訳後に、ドキュメントをアップロードして適用します。

この項に含まれる内容は次のとおりです。

- 翻訳済XLIFFドキュメントのアップロード

- アップロードしたXLIFFドキュメントの適用およびアプリケーションの公開

- アップロードしたXLIFFドキュメントの削除

翻訳済XLIFFドキュメントのアップロード

翻訳済XLIFFドキュメントをアップロードするには、次のステップを実行します。

1. アプリケーションの翻訳ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「グローバリゼーション」の下で「アプリケーションの翻訳」をクリックします。
アプリケーションの翻訳ページが表示されます。

2. 「翻訳ファイルを適用して公開」をクリックします。

3. 「XLIFFのアップロード」をクリックします。

4. XLIFFのアップロード・ページで、次のステップを実行します。

1. タイトルを指定します。

2. 説明を入力します。

3. 「参照」をクリックし、アップロードするファイルを指定します。

4. 「XLIFFファイルのアップロード」をクリックします。

アップロードされたドキュメントが、XLIFFファイル・リポジトリに表示されます。

アップロードしたXLIFFドキュメントの適用およびアプリケーションの公開

XLIFFドキュメントをアップロードした後、そのXLIFFドキュメントを適用して翻訳済アプリケーションを公開します。XLIFFドキュメントを適用すると、Application Expressエンジンはファイルを解析して、翻訳表を新しい翻訳可能なテキストで更新します。

アプリケーションを公開すると、ベース言語のアプリケーションのコピーが作成され、翻訳表の翻訳されたテキスト文字列が置換されます。その後、この公開されたアプリケーションを使用して、代替言語でアプリケーションをレンダリングできます。

アプリケーションを代替言語で実行するには、代替言語バージョンで表示するようにグローバリゼーション設定を行ってアプリケーションを実行する必要があります。たとえば、言語がブラウザ言語に従う場合は、ブラウザ言語を翻訳済アプリケーションと同じ言語に設定する必要があります。

関連項目:
「アプリケーションへのプライマリ言語の指定」

翻訳済XLIFFドキュメントを適用してアプリケーションを公開するには、次のステップを実行します。

1. アプリケーションの翻訳ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「グローバリゼーション」の下で「アプリケーションの翻訳」をクリックします。
アプリケーションの翻訳ページが表示されます。

2. 「翻訳ファイルを適用して公開」をクリックします。

3. XLIFFファイル・リポジトリで、公開するドキュメントの横にある「ビュー」アイコンをクリックします。

4. 「適用」から、適切なプライマリおよびターゲットのアプリケーションIDマップを選択します。

5. 「XLIFF翻訳ファイルの適用」をクリックします。

6. 「アプリケーションのパブリッシュ」をクリックします。

アップロードしたXLIFFドキュメントの削除

アップロードしたXLIFFドキュメントを削除するには、次のステップを実行します。

1. アプリケーションの翻訳ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「グローバリゼーション」の下で「アプリケーションの翻訳」をクリックします。
アプリケーションの翻訳ページが表示されます。

2. アプリケーションの翻訳ページで、「翻訳ファイルを適用して公開」を選択します。

3. XLIFFファイル・リポジトリで、そのドキュメント・タイトルの左のチェック・ボックスを選択します。

4. 「チェックした項目の削除」をクリックします。

アプリケーションを公開した後、翻訳済アプリケーションの有無を確認する必要があります。翻訳済アプリケーションは、アプリケーション・ビルダーのホームページの「選択可能なアプリケーション」リストには表示されません。かわりに、そのページの左側のアプリケーション・ナビゲート・リストを使用します。

翻訳済アプリケーションをアプリケーション・ビルダーに表示するには、アプリケーションのグローバリゼーション属性を正しく設定する必要があります。

関連項目:
「アプリケーションへのプライマリ言語の指定」

翻訳の手動編集

ターゲット言語をマップし、翻訳可能なテキストをシードした後は、手動で翻訳を編集できます。

手動で翻訳を編集するには、次のステップを実行します。

1. ターゲット言語をマップします。「ステップ1: ターゲット言語のマップ」を参照してください。

2. 翻訳可能なテキストをシードします。「翻訳可能なテキストのシード」を参照してください。

3. 翻訳可能なテキスト・ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「グローバリゼーション」の下で「アプリケーションの翻訳」をクリックします。

4. 「翻訳ユーティリティ」リストから、「翻訳の手動編集」をクリックします。
翻訳可能なテキスト・ページが表示されます。ページ上部の「ナビゲーション・バー」を使用してレポート表示を変更します。使用可能なオプションは次のとおりです。

- 言語のマッピング: 言語のマッピングを選択し、「実行」をクリックします。

- ページ: ページ番号を入力し、「実行」をクリックします。

- 翻訳: 大/小文字を区別しない問合せを入力し、「実行」をクリックします。

- 表示: 表示する行数を選択し、「実行」をクリックします。

5. 翻訳可能なテキストを編集するには、「編集」アイコンをクリックします。
「翻訳可能なテキスト」フィールドが表示されます。

6. 適切なテキストを編集し、「変更の適用」をクリックします。

メッセージの翻訳

アプリケーションが次に当てはまる場合、メッセージを翻訳する必要があることがあります。

- PL/SQLリージョンまたはPL/SQLプロセスが含まれる場合、あるいはPL/SQLパッケージ、プロシージャ、またはファンクションをコールする場合。この場合、生成されたHTMLを翻訳する必要があることがあります。

- Oracle Application Expressが翻訳されている10言語以外の言語を使用する場合。この場合、レポートに使用されているメッセージを翻訳する必要があることがあります。

この項に含まれる内容は次のとおりです。

- PL/SQLプロシージャで使用されるメッセージの翻訳

- Oracle Application Expressにより内部使用されるメッセージの翻訳

PL/SQLプロシージャで使用されるメッセージの翻訳

アプリケーションにPL/SQLリージョンまたはPL/SQLプロセスが含まれる場合、あるいはアプリケーションがPL/SQLパッケージ、プロシージャ、またはファンクションをコールする場合は、生成されるHTMLを翻訳する必要がある場合があります。最初に、翻訳可能なメッセージ・ページで、各メッセージを定義します。次に、APEX_LANG.MESSAGE APIを使用して、PL/SQLストアド・プロシージャ、ファンクション、トリガーまたはパッケージ化されたプロシージャおよびファンクションのメッセージを翻訳します。

翻訳可能なメッセージ・ページで、翻訳可能なメッセージを作成します。

新しい翻訳メッセージを定義するには、次のステップを実行します。

1. アプリケーションの翻訳ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「グローバリゼーション」の下で「テキスト・メッセージ」をクリックします。

2. メッセージの翻訳ページで、「作成」をクリックします。

3. 「テキスト・メッセージを指定」で次を指定します。

1. 名前: メッセージを識別するための名前を入力します。

2. 言語: メッセージが使用される言語を選択します。

3. テキスト: テキスト・メッセージがコールされたときに戻されるテキストを入力します。
たとえば、メッセージGREETING_MSGを次のように英語で定義できます。

Good morning %0

また、メッセージGREETING_MSGを次のようにドイツ語で定義できます。

Guten Tag %0

4. 「作成」をクリックします。

APEX_LANG.MESSAGE APIの概要

PL/SQLストアド・プロシージャ、ファンクション、トリガー、パッケージ化されたプロシージャおよびファンクションから生成されたテキスト文字列(メッセージ)を翻訳するには、APEX_LANG.MESSAGE APIを使用します。

構文

APEX_LANG.MESSAGE (
p_name    IN    VARCHAR2 DEFAULT NULL,
p0        IN    VARCHAR2 DEFAULT NULL,
p1        IN    VARCHAR2 DEFAULT NULL,
p2        IN    VARCHAR2 DEFAULT NULL,
...
p9        IN    VARCHAR2 DEFAULT NULL,
p_lang    IN    VARCHAR2 DEFAULT NULL)
RETURN VARCHAR2;

パラメータ

表 16-2に、 APEX_LANG.MESSAGE APIで使用可能なパラメータを示します。

表16-2 APEX_LANG.MESSAGEのパラメータ

パラメータ

説明

p_name

Oracle Application Expressで定義されたメッセージの名前。

p0

...

p9

動的置換値。p0は、メッセージの0%に対応します。p1は、メッセージの1%に対応します。p2は、メッセージの2%に対応します(以降同様)。

p_lang

取得されるメッセージの言語コード。指定しない場合、Oracle Application Expressは、アプリケーション言語の派生元属性で定義されているとおり、ユーザーの現行の言語を使用します。

関連項目: 「アプリケーションへのプライマリ言語の指定」

例

次の例では、アプリケーションのGREETING_MSGというメッセージを、英語でGood morning%0、ドイツ語でGuten Tag%1と定義したと仮定しています。この例は、PL/SQLからこのメッセージを呼び出す方法を示しています。

BEGIN
--
-- Print the greeting
--
APEX_LANG.MESSAGE('GREETING_MSG', V('APP_USER'));
END;

p_lang属性の定義は、Application Expressエンジンがアプリケーションのプライマリ言語を導出する方法によって異なります。たとえば、アプリケーションをドイツ語で実行中で、前回のコールがAPEX_LANG.MESSAGE APIに対して行われた場合、Application Expressエンジンは、最初にLANG_CODEがdeであるGREETING_MSGというメッセージを検索します。見つからない場合は、アプリケーションのプライマリ言語属性に戻ります。それでも見つからない場合、Application Expressエンジンは、言語コードがen-usであるこの名前のメッセージを検索します。

関連項目:
アプリケーションのプライマリ言語属性については、「アプリケーションへのプライマリ言語の指定」を参照してください。

Oracle Application Expressにより内部使用されるメッセージの翻訳

Oracle Application Expressはドイツ語、スペイン語、フランス語、イタリア語、日本語、韓国語、ポルトガル語(ブラジル)、簡体字中国語、および繁体字中国語に翻訳されています。これらの翻訳された10言語以外の言語をアプリケーションで使用する場合は、Application Expressレポート・エンジンによって表示されるメッセージを翻訳する必要があります。

たとえば、ロシア語のアプリケーションを開発してロシア語のレポート・メッセージ(ページ区切りなど)を使用する場合は、レポートに表示されるメッセージで使用される文字列を翻訳する必要があります。

メッセージを翻訳するには、次のステップを実行します。

1. アプリケーションの翻訳ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「グローバリゼーション」の下で「テキスト・メッセージ」をクリックします。

2. メッセージの翻訳ページで、「作成」をクリックします。

3. 「テキスト・メッセージを指定」で次を指定します。

1. 名前 - 翻訳する必要のある各メッセージの名前を入力します。表16-3を参照してください。

2. 言語: メッセージが使用される言語を選択します。

3. テキスト: テキスト・メッセージがコールされたときに戻されるテキストを入力します。英語のテキスト・メッセージに定位置の置換値(%0、%1など)が含まれている場合、ユーザー定義のメッセージにも同じ名前と数字の定位置の置換値を含めてください。

4. 「作成」をクリックします。

表 16-3に、翻訳が必要な内部メッセージを示します。

表 16-3 翻訳が必要な内部メッセージ

メッセージ名

英語のテキスト

FLOW.SINGLE_VALIDATION_ERROR

1 error has occurred

FLOW.VALIDATION_ERROR

%0 errors have occurred

INVALID_CREDENTIALS

Invalid Login Credentials

OUT_OF_RANGE

Invalid set of rows requested, the source data of the report has been modified

PAGINATION.NEXT

次

PAGINATION.NEXT_SET

Next Set

PAGINATION.PREVIOUS

前

PAGINATION.PREVIOUS_SET

Previous Set

REPORT_TOTAL

report total

RESET

reset pagination

SINCE_DAYS_AGO

%0 days ago

SINCE_HOURS_AGO

%0 hours ago

SINCE_MINUTES_AGO

%0 minutes ago

SINCE_MONTHS_AGO

%0 months ago

SINCE_SECONDS_AGO

%0 seconds ago

SINCE_WEEKS_AGO

%0 weeks ago

SINCE_YEARS_AGO

%0 years ago

TOTAL

Total

WWV_FLOW_UTILITIES.CAL

Calendar

WWV_FLOW_UTILITIES.CLOSE

Close

WWV_FLOW_UTILITIES.OK

Ok

WWV_RENDER_REPORT3.FOUND_BUT_NOT_DISPLAYED

Minimum row requested: %0, rows found but not displayed: %1

WWV_RENDER_REPORT3.SORT_BY_THIS_COLUMN

Sort by this column

WWV_RENDER_REPORT3.X_Y_OF_MORE_THAN_Z

row(s) %0 - %1 of more than %2

WWV_RENDER_REPORT3.X_Y_OF_Z

row(s)%0 - %1 of %2

WWV_RENDER_REPORT3.X_Y_OF_Z_2

%0 - %1 of %2

表 16-4に、翻訳が必要な内部メッセージを示します。

表 16-4 翻訳が必要な対話モード・レポート・メッセージ

メッセージ名

英語のテキスト

APEXIR_3D

3D

APEXIR_ACTIONS_MENU

Actions Menu

APEXIR_ADD

Add

APEXIR_AGGREGATE

Aggregate

APEXIR_AGGREGATE_DESCRIPTION

Aggregates are displayed after each control break and at the end of the report.

APEXIR_AGGREGATION

Aggregation

APEXIR_AGG_AVG

Average

APEXIR_AGG_COUNT

Count

APEXIR_AGG_MAX

Maximum

APEXIR_AGG_MEDIAN

Median

APEXIR_AGG_MIN

Minimum

APEXIR_AGG_MODE

Mode

APEXIR_AGG_SUM

Sum

APEXIR_ALL

All

APEXIR_ALL_COLUMNS

All Columns

APEXIR_AND

and

APEXIR_APPLY

Apply

APEXIR_ASCENDING

Ascending

APEXIR_AS_OF

As of %0

APEXIR_BETWEEN

between

APEXIR_BGCOLOR

Background Color

APEXIR_BLUE

blue

APEXIR_BOTTOM

Bottom

APEXIR_CALENDAR

Calendar

APEXIR_CANCEL

Cancel

APEXIR_CATEGORY

Category

APEXIR_CELL

Cell

APEXIR_CHART

Chart

APEXIR_CHART_INITIALIZING

Initializing...

APEXIR_CHART_TYPE

Chart Type

APEXIR_CHOOSE_DOWNLOAD_FORMAT

Choose report download format

APEXIR_CLEAR

clear

APEXIR_COLUMN

Column

APEXIR_COLUMNS

Columns

APEXIR_COLUMN_HEADING

Column Heading

APEXIR_COLUMN_HEADING_MENU

Column Heading Menu

APEXIR_COLUMN_INFO

Column Information

APEXIR_COMPARISON_CONTAINS

contains

APEXIR_COMPARISON_DOESNOT_CONTAIN

does not contain

APEXIR_COMPARISON_IN

in

APEXIR_COMPARISON_ISNOT_IN_LAST

is not in the last

APEXIR_COMPARISON_ISNOT_IN_NEXT

is not in the next

APEXIR_COMPARISON_IS_IN_LAST

is in the last

APEXIR_COMPARISON_IS_IN_NEXT

is in the next

APEXIR_COMPARISON_IS_NOT_NULL

is not null

APEXIR_COMPARISON_IS_NULL

is null

APEXIR_COMPARISON_LIKE

like

APEXIR_COMPARISON_NOT_IN

not in

APEXIR_COMPARISON_NOT_LIKE

not like

APEXIR_COMPARISON_REGEXP_LIKE

matches regular expression

APEXIR_COMPUTATION

Computation

APEXIR_COMPUTATION_FOOTER

Create a computation using column aliases.

APEXIR_COMPUTATION_FOOTER_E1

(B+C)*100

APEXIR_COMPUTATION_FOOTER_E2

INITCAP(B)||', '||INITCAP(C)

APEXIR_COMPUTATION_FOOTER_E3

CASE WHEN A = 10 THEN B + C ELSE B END

APEXIR_COMPUTE

Compute

APEXIR_CONTROL_BREAK

Control Break

APEXIR_CONTROL_BREAKS

Control Breaks

APEXIR_DATA_AS_OF

Report data as of %0 minutes ago.

APEXIR_DATE

Date

APEXIR_DEFAULT

Default

APEXIR_DELETE

Delete

APEXIR_DELETE_CHECKED

Delete Checked

APEXIR_DELETE_CONFIRM

Would you like to delete these report settings?

APEXIR_DELETE_CONFIRM_JS_DIALOG

Would you like to perform this delete action?

APEXIR_DELETE_REPORT

Delete Report

APEXIR_DESCENDING

Descending

APEXIR_DESCRIPTION

Description

APEXIR_DETAIL_VIEW

Single Row View

APEXIR_DIRECTION

Direction

APEXIR_DISABLE

Disable

APEXIR_DISABLED

Disabled

APEXIR_DISPLAY

Display

APEXIR_DISPLAYED

Displayed

APEXIR_DISPLAYED_COLUMNS

Displayed Columns

APEXIR_DISPLAY_IN_REPORT

Display in Report

APEXIR_DOWN

Down

APEXIR_DOWNLOAD

Download

APEXIR_DO_NOT_AGGREGATE

- Do not aggregate -

APEXIR_DO_NOT_DISPLAY

Do Not Display

APEXIR_EDIT_CHART

Edit Chart Settings

APEXIR_EDIT_CHART2

Edit Chart

APEXIR_EDIT_FILTER

Edit Filter

APEXIR_EDIT_HIGHLIGHT

Edit Highlight

APEXIR_ENABLE

Enable

APEXIR_ENABLED

Enabled

APEXIR_ENABLE_DISABLE_ALT

Enable/Disable

APEXIR_ERROR

Error

APEXIR_EXAMPLES

Examples

APEXIR_EXAMPLES_WITH_COLON

Examples:

APEXIR_EXCLUDE_NULL

Exclude Null Values

APEXIR_EXPAND_COLLAPSE_ALT

Expand/Collapse

APEXIR_EXPRESSION

Expression

APEXIR_FILTER

Filter

APEXIR_FILTERS

Filters

APEXIR_FINDER_ALT

Select columns to search

APEXIR_FLASHBACK

Flashback

APEXIR_FLASHBACK_DESCRIPTION

A flashback query enables you to view the data as it existed at a previous point in time.

APEXIR_FLASHBACK_ERROR_MSG

Unable to perform flashback request

APEXIR_FORMAT_MASK

Format Mask

APEXIR_FUNCTION

Function

APEXIR_FUNCTIONS

Functions

APEXIR_GO

Go

APEXIR_GREEN

green

APEXIR_HCOLUMN

Horizontal Column

APEXIR_HELP

Help

APEXIR_HELP_01

An Interactive Report displays a predetermined set of columns.The report may be further customized with an initial filter clause, a default sort order, control breaks, highlighting, computations, aggregates and a chart.Each Interactive Report can then be further customized and the results can be viewed, or downloaded, and the report definition can be stored for later use.

<p/>

An Interactive Report can be customized in three ways: the search bar, actions menu and column heading menu.

APEXIR_HELP_ACTIONS_MENU

The actions menu is used to customize the display of your Interactive Report.

APEXIR_HELP_AGGREGATE

Aggregates are mathematical computations performed against a column.Aggregates are displayed after each control break and at the end of the report within the column they are defined.

<p/>

<ul><li><b>Aggregation</b> allows you to select a previously defined aggregation to edit.</li>

<li><b>Function</b> is the function to be performed (e.g. SUM, MIN).</li>

<li><b>Column</b> is used to select the column to apply the mathematical function to.Only numeric columns will be displayed.</li></ul>

APEXIR_HELP_AGGREGATE

Aggregates are mathematical computations performed against a column.Aggregates are displayed after each control break and at the end of the report within the column they are defined.<p/>

<p/>

<ul><li><b>Aggregation</b> allows you to select a previously defined aggregation to edit.</li>

<li><b>Function</b> is the function to be performed (e.g. SUM, MIN).</li>

<li><b>Column</b> is used to select the column to apply the mathematical function to.Only numeric columns will be displayed.</li></ul>

APEXIR_HELP_CHART

You can include one chart per Interactive Report.Once defined, you can switch between the chart and report views using links below the search bar.

<p/>

<ul><li><b>Chart Type</b> identifies the chart type to include.Select from horizontal bar, vertical bar, pie or line.</li>

<li><b>Label</b> allows you to select the column to be used as the label.</li>

<li><b>Axis Title for Label</b> is the title that will display on the axis associated with the column selected for Label.This is not available for pie chart.</li>

<li><b>Value</b> allows you to select the column to be used as the value.If your function is a COUNT, a Value does not need to be selected.</li>

<li><b>Axis Title for Value</b> is the title that will display on the axis associated with the column selected for Value.This is not available for pie chart.</li>

<li><b>Function</b> is an optional function to be performed on the column selected for Value.</li></ul>

APEXIR_HELP_COLUMN_HEADING_MENU

Clicking on any column heading exposes a column heading menu.

<p/>

<ul><li><b>Sort Ascending icon</b> sorts the report by the column in ascending order.</li>

<li><b>Sort Descending icon</b> sorts the report by the column in descending order.</li>

<li><b>Hide Column</b> hides the column.</li>

<li><b>Break Column</b> creates a break group on the column.This pulls the column out of the report as a master record.</li>

<li><b>Column Information</b> displays help text about the column, if available.</li>

<li><b>Text Area</b> is used to enter case insensitive search criteria (no need for wild cards).Entering a value will reduce the list of values at the bottom of the menu.You can then select a value from the bottom and the selected value will be created as a filter using '=' (e.g. column = 'ABC').Alternatively, you can click the flashlight icon and the entered value will be created as a filter with the 'LIKE' modifier (e.g. column LIKE '%ABC%').<li><b>List of Unique Values</b> contains the first 500 unique values that meet your filters.If the column is a date, a list of date ranges is displayed instead.If you select a value, a filter will be created using '=' (e.g. column = 'ABC').</li></ul>

APEXIR_HELP_COMPUTE

Computations allow you to add computed columns to your report.These can be mathematical computations (e.g. NBR_HOURS/24) or standard Oracle functions applied to existing columns (some have been displayed for example, others, like TO_DATE, can also be used).

<p/>

<ul><li><b>Computation</b> allows you to select a previously defined computation to edit.</li>

<li><b>Column Heading</b> is the column heading for the new column.</li>

<li><b>Format Mask</b> is an Oracle format mask to be applied against the column (e.g. S9999).</li>

<li><b>Format Mask</b> is an Oracle format mask to be applied against the column (e.g. S9999).</li>

<li><b>Computation</b> is the computation to be performed.Within the computation, columns are referenced using the aliases displayed.</li>

</ul>

<p/>

Below computation, the columns in your query are displayed with their associated alias.Clicking on the column name or alias will write them into the Computation.Next to Columns is a Keypad.These are simply shortcuts of commonly used keys.On the far right are Functions.

<p/>

An example computation to display Total Compensation is:

<p/>

<pre>CASE WHEN A = 'SALES' THEN B + C ELSE B END</pre>

(where A is ORGANIZATION, B is SALARY and C is COMMISSION)

APEXIR_HELP_CONTROL_BREAK

Used to create a break group on one or several columns.This pulls the columns out of the Interactive Report and displays them as a master record.

APEXIR_HELP_DETAIL_VIEW

To view the details of a single row at a time, click the single row view icon on the row you want to view.If available, the single row view will always be the first column.Depending on the customization of the Interactive Report, the single row view may be the standard view or a custom page that may allow update.

APEXIR_HELP_DOWNLOAD

Allows the current result set to be downloaded.The download formats will differ depending upon your installation and report definition but may include CSV, XLS, PDF, or RTF.

APEXIR_HELP_FILTER

Used to add or modify the where clause on the query.You first select a column (it does not need to be one that is displayed), select from a list of standard Oracle operators (=, !=, not in, between), and enter an expression to compare against.The expression is case sensitive and you can use % as a wild card (for example, STATE_NAME like A%).

APEXIR_HELP_FLASHBACK

Performs a flashback query to allow you to view the data as it existed at a previous point in time.The default amount of time that you can flashback is 3 hours (or 180 minutes) but the actual amount will differ per database.

APEXIR_HELP_HIGHLIGHT

Highlighting allows you to define a filter.The rows that meet the filter are highlighted using the characteristics associated with the filter.

<p/>

<ul><li><b>Name</b> is used only for display.</li>

<li><b>Sequence</b> identifies the sequence in which the rules will be evaluated.</li>

<li><b>Enabled</b> identifies if the rule is enabled or disabled.</li>

<li><b>Highlight Type</b> identifies whether the Row or Cell should be highlighted.If Cell is selected, the column referenced in the Highlight Condition is highlighted.</li>

<li><b>Background Color</b> is the new color for the background of the highlighted area.</li>

<li><b>Text Color</b> is the new color for the text in the highlighted area.</li>

<li><b>Highlight Condition</b> defines your filter condition.</li></ul>

APEXIR_HELP_REPORT_SETTINGS

If you have customized your Interactive Report, the report settings will be displayed below the Search Bar and above the report.If you have saved customized reports, they will be shown as tabs.You can access your alternate views by clicking the tabs.Below the tabs are the report settings for the current report.This area can be collapsed and expanded using the icon on the left.

<p/>

For each report setting, you can:

<ul><li><b>Edit</b> by clicking the name.</li>

<li><b>Disable/Enable</b> by unchecking or checking the Enable/Disable check box.This is used to temporarily turn off and on the setting.</li>

<li><b>Remove</b> by click the Remove icon.This permanently removes the setting.</li></ul>

<p/>

If you have created a chart, you can toggle between the report and chart using the Report View and Chart View links shown on the right.If you are viewing the chart, you can also use the Edit Chart link to edit the chart settings.

APEXIR_HELP_RESET

Resets the report back to the default settings, removing any customizations that you have made.

APEXIR_HELP_SAVE_REPORT

Saves the customized report for future use.You provide a name and an optional description.

APEXIR_HELP_SEARCH_BAR

At the top of each report page is a search region.The region provides the following features:

<p/>

<ul><li><b>Select columns icon</b> allows you to identify which column to search (or all).</li>

<li><b>Text area</b> allows for case insensitive search criteria (no need for wild cards).</li>

<li><b>Rows</b> selects the number of records to display per page.</li>

<li><b>[Go] button</b> executes the search.</li>

<li><b>Actions Menu icon</b> displays the actions menu (discussed next).</li></ul>

<p/>

Please note that all features may not be available for each report.

APEXIR_HELP_SELECT_COLUMNS

Used to modify the columns displayed.The columns on the right are displayed.The columns on the left are hidden.You can reorder the displayed columns using the arrows on the far right.Computed columns are prefixed with <b>**</b>.

APEXIR_HELP_SORT

Used to change the column(s) to sort on and whether to sort ascending or descending.You can also specify how to handle nulls (use the default setting, always display them last or always display them first).The resulting sorting is displayed to the right of column headings in the report.

APEXIR_HIDE_COLUMN

Hide Column

APEXIR_HIGHLIGHT

Highlight

APEXIR_HIGHLIGHTS

Highlights

APEXIR_HIGHLIGHT_CONDITION

Highlight Condition

APEXIR_HIGHLIGHT_TYPE

Highlight Type

APEXIR_HIGHLIGHT_WHEN

Highlight When

APEXIR_INTERACTIVE_REPORT_HELP

Interactive Report Help

APEXIR_INVALID

Invalid

APEXIR_INVALID_COMPUTATION

Invalid computation expression. %0

APEXIR_KEYPAD

Keypad

APEXIR_LABEL

Label

APEXIR_LABEL_AXIS_TITLE

Axis Title for Label

APEXIR_LAST_DAY

Last Day

APEXIR_LAST_HOUR

Last Hour

APEXIR_LAST_MONTH

Last Month

APEXIR_LAST_WEEK

Last Week

APEXIR_LAST_X_DAYS

Last %0 Days

APEXIR_LAST_X_HOURS

Last %0 Hours

APEXIR_LAST_X_YEARS

Last %0 Years

APEXIR_LAST_YEAR

Last Year

APEXIR_LINE

Line

APEXIR_MAX_QUERY_COST

The query is estimated to exceed the maximum allowed resources.Please modify your report settings and try again.

APEXIR_MAX_ROW_CNT

This query returns more then %0 rows, please filter your data to ensure complete results.

APEXIR_MIN_AGO

%0 minutes ago

APEXIR_MORE_DATA

More Data

APEXIR_MOVE

Move

APEXIR_MOVE_ALL

Move All

APEXIR_NAME

Name

APEXIR_NEW_AGGREGATION

New Aggregation

APEXIR_NEW_CATEGORY

- New Category -

APEXIR_NEW_COMPUTATION

New Computation

APEXIR_NEXT

&gt;

APEXIR_NEXT_DAY

Next Day

APEXIR_NEXT_HOUR

Next Hour

APEXIR_NEXT_MONTH

Next Month

APEXIR_NEXT_WEEK

Next Week

APEXIR_NEXT_X_DAYS

Next %0 Days

APEXIR_NEXT_X_HOURS

Next %0 Hours

APEXIR_NEXT_X_YEARS

Next %0 Years

APEXIR_NEXT_YEAR

Next Year

APEXIR_NO

No

APEXIR_NONE

- None -

APEXIR_NO_AGGREGATION_DEFINED

No aggregation defined.

APEXIR_NO_COLUMN_INFO

No column information available.

APEXIR_NO_COMPUTATION_DEFINED

No computation defined.

APEXIR_NULLS_ALWAYS_FIRST

Nulls Always First

APEXIR_NULLS_ALWAYS_FIRST

Nulls Always First

APEXIR_NULLS_ALWAYS_LAST

Nulls Always Last

APEXIR_NULL_SORTING

Null Sorting

APEXIR_NUMERIC_FLASHBACK_TIME

Flashback time must be numeric.

APEXIR_NUMERIC_SEQUENCE

Sequence must be numeric.

APEXIR_OPERATOR

Operator

APEXIR_ORANGE

orange

APEXIR_OTHER

Other

APEXIR_PIE

Pie

APEXIR_PREVIOUS

&lt;

APEXIR_PUBLIC

Public

APEXIR_RED

red

APEXIR_REMOVE

Remove

APEXIR_REMOVE_AGGREGATE

Remove Aggregate

APEXIR_REMOVE_ALL

Remove All

APEXIR_REMOVE_CONTROL_BREAK

Remove Control Break

APEXIR_REMOVE_FILTER

Remove Filter

APEXIR_REMOVE_FLASHBACK

Remove Flashback

APEXIR_REMOVE_HIGHLIGHT

Remove Highlight

APEXIR_RENAME_REPORT

Rename Report

APEXIR_REPORT

Report

APEXIR_REPORT_SETTINGS

Report Settings

APEXIR_REPORT_VIEW

&lt; Report View

APEXIR_RESET

Reset

APEXIR_RESET_CONFIRM

Restore report to the default settings.

APEXIR_ROW

Row

APEXIR_ROWS

Rows

APEXIR_ROW_OF

Row %0 of %1

APEXIR_ROW_ORDER

Row Order

APEXIR_ROW_TEXT_CONTAINS

Row text contains

APEXIR_SAVE

Save

APEXIR_SAVED_REPORT

Saved Report

APEXIR_SAVED_REPORT_MSG

Saved Report = "%0"

APEXIR_SAVE_AS_DEFAULT

Save as Default

APEXIR_SAVE_DEFAULT_CONFIRM

The current report settings will be used as the default for all users.

APEXIR_SAVE_REPORT

Save Report

APEXIR_SEARCH_BAR

Search Bar

APEXIR_SELECT_CATEGORY

- Select Category -

APEXIR_SELECT_COLUMN

- Select Column -

APEXIR_SELECT_COLUMNS

Select Columns

APEXIR_SELECT_COLUMNS_FOOTER

Computed columns are prefixed with **.

APEXIR_SELECT_FUNCTION

- Select Function -

APEXIR_SELECT_VALUE

Select Value

APEXIR_SEQUENCE

Sequence

APEXIR_SORT

Sort

APEXIR_SORT_ASCENDING

Sort Ascending

APEXIR_SORT_DESCENDING

Sort Descending

APEXIR_SPACE_AS_IN_ONE_EMPTY_STRING

space

APEXIR_STATUS

Status

APEXIR_TEXT_COLOR

Text Color

APEXIR_TIME_DAYS

days

APEXIR_TIME_HOURS

hours

APEXIR_TIME_MINS

minutes

APEXIR_TIME_MONTHS

months

APEXIR_TIME_WEEKS

weeks

APEXIR_TIME_YEARS

years

APEXIR_TOP

Top

APEXIR_UNAUTHORIZED

Unauthorized

APEXIR_UNIQUE_COLUMN_HEADING

Column Heading must be unique.

APEXIR_UNIQUE_HIGHLIGHT_NAME

Highlight Name must be unique.

APEXIR_UNSUPPORTED_DATA_TYPE

unsupported data type

APEXIR_UP

Up

APEXIR_VALID_COLOR

Please enter a valid color.

APEXIR_VALID_FORMAT_MASK

Please enter a valid format mask.

APEXIR_VALUE

Value

APEXIR_VALUE_AXIS_TITLE

Axis Title for Value

APEXIR_VALUE_REQUIRED

Value Required

APEXIR_VCOLUMN

Vertical Column

APEXIR_VIEW_CHART

View Chart

APEXIR_VIEW_REPORT

View Report

APEXIR_WORKING_REPORT

Working Report

APEXIR_YELLOW

yellow

APEXIR_YES

Yes

LOVをサポートするデータの翻訳

動的データを翻訳するには、動的翻訳を作成します。たとえば、データベース問合せに基づくLOVで動的翻訳を使用する場合があります。

動的翻訳は、メッセージ名ではなく特定の文字列を問い合せるという点でメッセージとは異なります。動的翻訳は、動的翻訳ページで定義します。その後、APEX_LANG.LANG APIを使用して、パラメータp_primary_text_stringで指定された動的翻訳文字列を戻します。

動的翻訳の定義

動的翻訳は、動的翻訳ページで定義します。動的翻訳は、翻訳元の言語文字列、言語コードおよび翻訳先の文字列で構成されています。

動的翻訳を定義するには、次のステップを実行します。

1. アプリケーションの翻訳ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「グローバリゼーション」の下で「アプリケーションの翻訳」をクリックします。

2. アプリケーションの翻訳ページで、「(オプション)SQLに基づくLOVをサポートするために動的に翻訳する必要があるデータを指定」を選択します。

3. 動的翻訳ページで、「作成」をクリックし、次のように指定します。

1. 言語: ターゲットの言語を選択します。

2. 翻訳元テキスト: 翻訳するテキストを入力します。

3. 翻訳先: 翻訳したテキストを入力します。

4. 「作成」をクリックします。

APEX_LANG.LANG API

構文

APEX_LANG.LANG (
p_primary_text_string    IN    VARCHAR2 DEFAULT NULL,
p0                       IN    VARCHAR2 DEFAULT NULL,
p1                       IN    VARCHAR2 DEFAULT NULL,
p2                       IN    VARCHAR2 DEFAULT NULL,
...
p9                       IN    VARCHAR2 DEFAULT NULL,
p_primary_language       IN    VARCHAR2 DEFAULT NULL)
RETURN VARCHAR2;

パラメータ

表 16-5に、APEX_LANG.LANG APIで使用可能なパラメータを示します。

表16-5 APEX_LANG.LANGのパラメータ

パラメータ

説明

p_primary_string

プライマリ言語のテキスト文字列。これは、「動的翻訳」の「翻訳元テキスト」の値になります。

p0

...

p9

動的置換値。p0は、翻訳文字列の0%に対応します。p1は、翻訳文字列の1%に対応します。p2は、翻訳文字列の2% に対応します(以降同様)。

p_primary_language

取得されるメッセージの言語コード。指定しない場合、Oracle Application Expressは、アプリケーション言語の派生元属性で定義されているとおり、ユーザーの現行の言語を使用します。

関連項目: 「アプリケーションへのプライマリ言語の指定」

例

すべての1次色を定義する表があるとします。それぞれの色に動的メッセージを定義し、問合せで定義された値にLANGファンクションを適用します。次に例を示します。

SELECT APEX_LANG.LANG(color)
FROM my_colors

アプリケーションをドイツ語で実行中の場合、my_colors表の「カラー」列の値がREDであったとすると、赤にドイツ語を定義すると、前述の例では、ROTが戻されます。

サポートされるグローバリゼーション・コードについて

多言語アプリケーションを構築する場合、グローバリゼーション・コードが、アプリケーションの実行方法に与える影響を理解しておくことが重要です。これらのコードは、選択したアプリケーション・レベルのグローバリゼーション属性に基づいて自動的に設定されます。

関連項目:
「アプリケーションへのプライマリ言語の指定」

NLS_LANGUAGEおよびNLS_TERRITORY によって、数字、日付および通貨のデフォルトの表示形式が決まります。

表16-6に、Oracle Application Expressのグローバリゼーション・コードを示します。

表16-6 Oracle Application Expressのグローバリゼーション・コード

言語名

言語コード

NLS_LANGUAGE

NLS_TERRITORY

アフリカーンス語

af

ENGLISH

SOUTH AFRICA

アラビア語

ar

ARABIC

UNITED ARAB EMIRATES

アラビア語(アルジェリア)

ar-dz

ARABIC

ALGERIA

アラビア語(バーレーン)

ar-bh

ARABIC

BAHRAIN

アラビア語(エジプト)

ar-eg

EGYPTIAN

EGYPT

アラビア語(イラク)

ar-iq

ARABIC

IRAQ

アラビア語(ヨルダン)

ar-jo

ARABIC

JORDAN

アラビア語(クウェート)

ar-kw

ARABIC

KUWAIT

アラビア語(レバノン)

ar-lb

ARABIC

LEBANNON

アラビア語(リビア)

ar-ly

ARABIC

LIBYA

アラビア語(モロッコ)

ar-ma

ARABIC

MOROCCO

アラビア語(オマーン)

ar-om

ARABIC

OMAN

アラビア語(カタール)

ar-qa

ARABIC

QATAR

アラビア語(サウジアラビア)

ar-sa

ARABIC

SAUDI ARABIA

アラビア語(シリア)

ar-sy

ARABIC

SYRIA

アラビア語(チュニジア)

ar-tn

ARABIC

TUNISIA

アラビア語(アラブ首長国連邦)

ar-ae

ARABIC

UNITED ARAB EMIRATES

アラビア語(イエメン)

ar-ye

ARABIC

YEMEN

アッサム語

as

ASSAMESE

INDIA

バスク語

eu

FRENCH

FRANCE

ベラルーシ語

be

RUSSIAN

RUSSIA

ベンガル語

bn

BANGLA

BANGLADESH

ブルガリア語

bg

BULGARIAN

BULGARIA

カタロニア語

ca

CATALAN

CATALONIA

中国語

zh

SIMPLIFIED CHINESE

CHINA

中国語(中国)

zh-cn

SIMPLIFIED CHINESE

CHINA

中国語(香港SAR)

zh-hk

TRADITIONAL CHINESE

HONG KONG

中国語(マカオSAR)

zh-mo

TRADITIONAL CHINESE

HONG KONG

中国語(シンガポール)

zh-sg

SIMPLIFIED CHINESE

SINGAPORE

中国語(台湾)

zh-tw

TRADITIONAL CHINESE

TAIWAN

クロアチア語

hr

CROATIAN

CROATIA

チェコ語

cs

CZECH

CZECH REPUBLIC

デンマーク語

da

DANISH

DENMARK

オランダ語(ベルギー)

nl-be

DUTCH

BELGIUM

オランダ語(オランダ)

nl

DUTCH

THE NETHERLANDS

英語

en

AMERICAN

AMERICA

英語(オーストラリア)

en-au

ENGLISH

AUSTRALIA

英語(ベリーズ)

en-bz

ENGLISH

UNITED KINGDOM

英語(カナダ)

en-ca

ENGLISH

CANADA

英語(アイルランド)

en-ie

ENGLISH

IRELAND

英語(ジャマイカ)

en-jm

ENGLISH

UNITED KINGDOM

英語(ニュージーランド)

en-nz

ENGLISH

NEW ZEALAND

英語(フィリピン)

en-ph

ENGLISH

PHILIPPINES

英語(南アフリカ)

en-za

ENGLISH

SOUTH AFRICA

英語(トリニダード)

en-tt

ENGLISH

UNITED KINGDOM

英語(イギリス)

en-gb

ENGLISH

UNITED KINGDOM

英語(米国)

en-us

AMERICAN

AMERICA

英語(ジンバブエ)

en-zw

ENGLISH

UNITED KINGDOM

エストニア語

et

ESTONIAN

ESTONIA

フェロー語

fo

ENGLISH

UNITED KINGDOM

ペルシア語

fa

ENGLISH

UNITED KINGDOM

フィンランド語

fi

FINNISH

FINLAND

フランス語(ベルギー)

fr-be

FRENCH

BELGIUM

フランス語(カナダ)

fr-ca

CANADIAN FRENCH

CANADA

フランス語(フランス)

fr

FRENCH

FRANCE

フランス語(ルクセンブルグ)

fr-lu

FRENCH

LUXEMBOURG

フランス語(モナコ)

fr-mc

FRENCH

FRANCE

フランス語(スイス)

fr-ch

FRENCH

SWITZERLAND

FYROマケドニア語

mk

MACEDONIAN

FYR MACEDONIA

ゲール語

gd

ENGLISH

UNITED KINGDOM

ガリシア語

gl

SPANISH

SPAIN

ドイツ語(オーストリー)

de-at

GERMAN

AUSTRIA

ドイツ語(ドイツ)

de

GERMAN

GERMANY

ドイツ語(リヒテンシュタイン)

de-li

GERMAN

GERMANY

ドイツ語(ルクセンブルグ)

de-lu

GERMAN

LUXEMBOURG

ドイツ語(スイス)

de-ch

GERMAN

SWITZERLAND

ギリシャ語

el

GREEK

GREECE

グジャラト語

gu

GUJARATI

INDIA

ヘブライ語

he

HEBREW

ISRAEL

ヒンディー語

hi

HINDI

INDIA

ハンガリー語

hu

HUNGARIAN

HUNGARY

アイスランド語

is

ICELANDIC

ICELAND

インドネシア語

id

INDONESIAN

INDONESIA

イタリア語(イタリア)

it

ITALIAN

ITALY

イタリア語(スイス)

it-ch

ITALIAN

SWITZERLAND

日本語

ja

JAPANESE

JAPAN

カンナダ語

kn

KANNADA

INDIA

カザフ語

kk

CYRILLIC KAZAKH

KAZAKHSTAN

コンカニ語

kok

KOREAN

KOREA

韓国語

ko

KOREAN

KOREA

キルギス語

kz

RUSSIAN

RUSSIA

ラトビア語

lv

LATVIAN

LATVIA

リトアニア語

lt

LITHUANIAN

LITHUANIANA

マラヤーラム語(マレーシア)

ms

MALAY

MALAYSIA

マラヤーラム語

ml

MALAYALAM

INDIA

マルタ語

mt

ENGLISH

UNITED KINGDOM

マラーティー語

mr

ENGLISH

INDIA

ネパール語(インド)

ne

ENGLISH

UNITED KINGDOM

ノルウェー語(ブークモール)

nb-no

NORWEGIAN

NORWAY

ノルウェー語(ブークモール)

no

NORWEGIAN

NORWAY

ノルウェー語(ニーノシュク)

nn-no

NORWEGIAN

NORWAY

オリヤー語

or

ORIYA

INDIA

ポーランド語

pl

POLISH

POLAND

ポルトガル語(ブラジル)

pt-br

BRAZILIAN PORTUGUESE

BRAZIL

ポルトガル語(ポルトガル)

pt

PORTUGUESE

PORTUGAL

パンジャブ語

pa

PUNJABI

INDIA

ルーマニア語

ro

ROMANIAN

ROMANIA

ロシア語

ru

RUSSIAN

RUSSIA

ロシア語(モルドバ)

ru-md

RUSSIAN

RUSSIA

セルビア語

sr

CYRILLIC SERBIAN

SERBIA AND MONTENEGRO

スロバキア語

sk

SLOVAK

SLOVAKIA

スロベニア語

sl

SLOVENIAN

SLOVENIA

スペイン語(アルゼンチン)

es-ar

LATIN AMERICAN SPANISH

ARGENTINA

スペイン語(ボリビア)

es-bo

LATIN AMERICAN SPANISH

ARGENTINA

スペイン語(チリ)

es-cl

LATIN AMERICAN SPANISH

CHILE

スペイン語(コロンビア)

ec-co

LATIN AMERICAN SPANISH

COLUMBIA

スペイン語(コスタリカ)

es-cr

LATIN AMERICAN SPANISH

COSTA RICA

スペイン語(ドミニカ共和国)

es-do

LATIN AMERICAN SPANISH

PUERTO RICO

スペイン語(エクアドル)

es-ec

LATIN AMERICAN SPANISH

ECUDOR

スペイン語(エルサルバドル)

es-sv

LATIN AMERICAN SPANISH

EL SALVADOR

スペイン語(グアテマラ)

es-gt

LATIN AMERICAN SPANISH

GUATEMALA

スペイン語(ホンジュラス)

es-hn

LATIN AMERICAN SPANISH

GUATEMALA

スペイン語(メキシコ)

es-mx

MEXICAN SPANISH

MEXICO

スペイン語(ニカラグア)

es-ni

LATIN AMERICAN SPANISH

NICARAGUA

スペイン語(パナマ)

es-pa

LATIN AMERICAN SPANISH

PANAMA

スペイン語(パラグアイ)

es-py

LATIN AMERICAN SPANISH

ARGENTINA

スペイン語(ペルー)

es-pe

LATIN AMERICAN SPANISH

PERU

スペイン語(プエルトリコ)

es-pr

LATIN AMERICAN SPANISH

PUERTO RICO

スペイン語(標準)

es

LATIN AMERICAN SPANISH

SPAIN

スペイン語(米国)

es-us

LATIN AMERICAN SPANISH

AMERICAN

スペイン語(ウルグアイ)

es-uy

LATIN AMERICAN SPANISH

ARGENTINA

スペイン語(ベネズエラ)

es-ve

LATIN AMERICAN SPANISH

VENEZUELA

スウェーデン語

sv

SWEDISH

SWEDEN

スウェーデン語

sv-fi

SWEDISH

FINLAND

タミル語

ta

TAMIL

INDIA

テルグ語

te

TELUGU

INDIA

タイ語

th

THAI

THAILAND

トルコ語

tr

TURKISH

TURKEY

ウクライナ語

uk

UKRAINIAN

UKRAINE

ウルドゥー語

ur

ENGLISH

UNITED KINGDOM

ウズベク語

uz

LATIN UZBEK

UZBEKISTAN

ベトナム語

vi

VIETNAMESE

VIETNAM

ズールー語

zu

ENGLISH

UNITED KINGDOM

A 使用可能な条件

条件とは、リージョン、アイテム、ボタンおよびタブの表示と、プロセス、計算および検証の実行を制御するために役立つ論理単位です。条件をコントロールまたはコンポーネントに適用すると、条件が評価されます。条件が真であるかどうかによって、コントロールまたはコンポーネントが表示されるかどうか、または処理が実行されるかどうかが決まります。

コントロール(リージョン、ボタンまたはアイテム)またはコンポーネント(タブ、リストまたはナビゲーション・バー)の作成時に条件タイプを選択するか、または条件属性で選択することによって、条件を指定できます。

関連項目:
「条件付きのレンダリングおよびプロセスの理解」

アプリケーション・ビルダーの条件

表A-1に、アプリケーション・ビルダーで使用可能な条件を示します。任意のコントロールまたはコンポーネントに対して使用可能なすべての条件のリストを表示するには、「条件タイプ」リストの右にある「ビュー」アイコンをクリックします。「タイプ」リストのすぐ下に、一般的な選択項目へのショートカットが表示されます。条件に式が必要な場合は、該当するフィールドにその式を入力します。

表A-1に、アプリケーション・ビルダーで使用可能な条件を示します。

表A-1 使用可能な条件

条件

説明

常時

常にtrueを戻します。主にページ・アイテムの読取り専用条件に使用されます。

現在の言語!=式1

クライアント・ブラウザが現在実行されていない言語の設定を確認します。現在の言語が「式1」に入力した文字列に含まれている場合は、trueと評価されます。

現在の言語=式1

クライアント・ブラウザが現在実行されている言語の設定を確認します。現在の言語が「式1」に入力した値と一致する場合は、trueと評価されます。

現在の言語が式1に含まれる

ブラウザの現在の言語が文字列に含まれているかどうかを判断します。現在の言語が「式1」に入力した文字列と一致する場合は、trueと評価されます。

たとえば、現在の言語がen-USまたはen-GBのいずれかであることを確認するには、この条件を選択して、「式1」に次の文字列を入力します。

en-us,en-gb

現在の言語が式1に含まれない

アプリケーションの現在の言語が、指定した文字列に含まれていないことを確認します。現在の言語が「式1」に入力した文字列に含まれていない場合は、trueと評価されます。

カレント・ページ!=式1

カレント・ページが「式1」に入力したページと同じでない場合は、trueと評価されます。

カレント・ページ!=送信ページ(このページはポストされたページではない)

指定したページがポストされていないかどうかを判断します。カレント・ページが「式1」に入力した値と一致しない場合は、trueと評価されます。

カレント・ページ=式1

カレント・ページが「式1」に入力したページと同じである場合は、trueと評価されます。

カレント・ページ=送信ページ(このページはポストされたページ)

指定したページがポストされたかどうかを確認します。カレント・ページが「式1」に入力した値と一致する場合は、trueと評価されます。

カレント・ページが式1(カンマで区切られたページ・リスト)に含まれる

カレント・ページが、「式1」に指定したページ・リストに含まれているかどうかを確認します。カレント・ページが1、2、3または4ページのいずれかであることを確認するには、この条件タイプを選択して、「式1」に次の文字列を入力します。

1,2,3,4

カレント・ページが「印刷用」モード

ユーザーが「印刷用」モードを選択した際に、特定のページ・コントロールまたはコンポーネントのみを表示します。カレント・ページが「印刷用」モードである場合、この条件はtrueと評価されます。「印刷用」モードを指定するには、f?p構文を使用します。

カレント・ページは「印刷用」モードではない

ユーザーが「印刷用」モードを選択した際に、ページ・コントロールまたはコンポーネントを非表示にします。「印刷用」モードを指定するには、f?p構文を使用します。

関連項目: f?p構文については、「f?p構文を使用したページのリンク」を参照してください。

カレント・ページが式1(カンマで区切られたページ・リスト)に含まれない

カレント・ページが「式1」に入力した、カンマで区切られたページ・リストに含まれていないかどうかを確認します。

存在する(SQL問合せが1行以上を戻す)

この条件は、SQL問合せとして表されます。問合せで1行以上が戻される場合、この条件はtrueと評価されます。次に例を示します。

select 1 from emp where deptno = :P101_DEPTNO

この例では、アイテムP101_DEPTNOがバインド変数として参照されます。アプリケーション・プロセスおよびSQL問合せリージョン内でバインド変数を使用すると、アイテムのセッション・ステートを参照できます。P101_DEPTNOの値に指定した部門に1人以上の従業員が存在する場合、この条件はtrueと評価されます。

関連項目: バインド変数については、「バインド変数の構文について」を参照してください。

「なし」

この条件タイプは、常にfailと評価されます。これは、コントロールまたはコンポーネント(リージョン、ボタン、アイテムなど)のページ上でのレンダリングを一時的に制限したり、プロセス、計算および検証の実行を制限するために役立ちます。

存在しない(SQL問合せが行を戻さない)

この条件は、SQL問合せとして表されます。問合せで行が戻されない場合は、trueと評価されます。

PL/SQL式

PL/SQL式は、trueまたはfalseと評価される有効なPL/SQL構文内の任意の式です。次に例を示します。

nvl(:MY_FLOW_ITEM,'NO') = 'YES'

MY_FLOW_ITEMの値がYESの場合、この条件はtrueと評価されます。それ以外の場合は、falseと評価されます。

ブールを戻すPL/SQLファンクション本体

trueまたはfalseを戻すPL/SQLファンクション本体です。次に例を示します。

BEGIN
IF :P1_DAY = 'MONDAY' THEN
RETURN TRUE;
ELSE
RETURN FALSE;
END IF;
END;

リクエスト!=式1

REQUESTは、ページの送信方法を追跡する内部属性です。デフォルトでは、ページの送信時に、ページを送信させたオブジェクトの名前に応じてアプリケーション属性REQUESTの値が設定されます。通常のボタンでは、REQUESTは、ボタンのラベルではなくボタンの名前(「取消」、「保存」など)に設定されます。リクエストは、f?p構文を使用して設定することもできます。

たとえば、ユーザーがボタンをクリックしたり、タブ・メニューを選択した場合にページが送信されます。イベントによっては、REQUESTアプリケーション属性の値を参照して、異なる操作を実行できます。

REQUESTが「式1」に入力した値と同じでない場合、この条件はtrueと評価されます。

関連項目: 「URL構文の理解」、「REQUEST」および「ボタン名とREQUESTの関係の理解」

リクエスト=式1

この条件は、「リクエスト!=式1」の反対の条件です。

REQUESTが「式1」に入力した値と同じである場合、この条件はtrueと評価されます。PL/SQLでは、次の構文を使用してアプリケーション属性を参照することもできます。

V('REQUEST')

関連項目: 「URL構文の理解」、「REQUEST」および「ボタン名とREQUESTの関係の理解」

式1がリクエストを含む

REQUESTは、ページの送信方法を追跡する内部アプリケーション属性です。デフォルトでは、ページの送信時に、ページを送信させたイベントに従ってREQUESTの値が設定されます。たとえば、ユーザーがボタンをクリックしたり、タブを選択した場合にページが送信されます。イベントによっては、REQUESTアプリケーション属性の値を参照して、異なる操作を実行できます。

この条件を使用すると、許可するリクエスト(SAVEやUPDATEなど)のリストを「式1」に指定できます。REQUESTの値がリストに含まれている場合、この条件はtrueと評価されます。

関連項目: 「REQUEST」および「ボタン名とREQUESTの関係の理解」

式1がリクエストを含まない

この条件は、「式1がリクエストを含む」の反対の条件です。REQUESTの値が「式1」に含まれていない場合は、trueと評価されます。

関連項目: 「REQUEST」および「ボタン名とREQUESTの関係の理解」

SQL式

SQL文のWHERE句として評価されます。たとえば、式:MY_ITEM = 'ABC'の場合を考えてみます。

Application Expressエンジンで次の処理が実行されます。

select 1 from dual where :MY_ITEM = 'ABC'

行が戻された場合、この条件はtrueと評価されます。

SQLレポート(「OK」をクリックすると「戻る」ボタンを表示)

この条件は、ページ区切りが含まれているレポートに使用します。この条件は、結果セット内でページを戻るボタンを含めるタイミングを自動的に判断します。

SQLレポート(「OK」をクリックすると「次へ」ボタンを表示)

この条件は、ページ区切りが含まれているレポートに使用します。この条件は、結果セット内でページを進むボタンを含めるタイミングを自動的に判断します。

式1のテキスト!=式2 (&ITEM置換を含む)

この条件を使用すると、文字列を含む2つの式を比較できます。いずれかの式には、&MY_ITEM構文を使用して、セッション・ステートへの参照を含めることができます。

参照: &MY_ITEM構文については、「置換文字列の理解」を参照してください。

式1のテキスト!=式2 (&ITEM置換を含む)

この条件は、「式1のテキスト!=式2 (&ITEM置換を含む)」の反対の条件です。文字列を含む2つの式が比較されます。&ITEM.構文を使用して、片方の式にセッション・ステートの参照を含めることができます。

アイテムF100_P2_DAY_DATEが「Wednesday」と同じであるかどうかを確認するには、この条件を選択して、「式1」および「式2」に次のように入力します。

- 式1: F100_P2_DAY_DATE

- 式2: Wednesday

参照: &MY_ITEM構文については、「置換文字列の理解」を参照してください。

認証済ユーザー(非パブリック・ユーザー)

カレント・ユーザーが組込み認証スキーマまたはカスタム認証スキームのいずれかを使用して認証されたかどうかを確認します。

関連項目: 認証の詳細は、「認証によるユーザー・アイデンティティの証明」を参照してください。

パブリック・ユーザー(認証されていないユーザー)

パブリック・ユーザーは、アプリケーション属性として定義されます。特定のアプリケーションに対してパブリック・ユーザーを設定するには、アプリケーション・ビルダーのホームページに移動し、そのアプリケーションに対応する編集リンクをクリックします。

パブリック・ユーザーは、複数のユーザーで使用されるユーザーです。アプリケーションには、認証およびログインが必要なパブリック・ページが含まれる場合があります。ユーザーがパブリック・ユーザーである(ユーザーがユーザー自身として認証されたか、またはアプリケーション属性Public Userで識別されたパブリック・ユーザー以外のユーザーとして認証された)場合、この条件はtrueを戻します。

関連項目: パブリック・ユーザーについては、「認証」を参照してください。

式1のアイテムの値!=0(ゼロ)

「式1」内のアイテムの値が0 (ゼロ)ではないかどうかを確認します。

式1のアイテムの値=式2

アイテムの値を特定の文字列と比較します。この条件を使用した比較では、大/小文字が区別されます。

たとえば、アイテムF100_P2_WORDの値が文字列「the quick brown fox」に含まれているかどうかを確認するには、「式1」および「式2」フィールドに次のとおり入力します。

- 式1: F100_P2_WORD

- 式2: the quick brown fox

式1のアイテムの値=0(ゼロ)

「式1」内のアイテムの値が0 (ゼロ)であるかどうかを確認します。

式1のアイテムの値が空白を含まない

「式1」に指定したアイテムの値に空白が含まれていない場合は、trueと評価されます。

式1のアイテムの値が英数字

「式1」の文字列に英数字のみが含まれている場合は、trueと評価されます。

式1のアイテムの値が、式2のコロンで区切られたリストに含まれる

この条件タイプを使用すると、特定の文字列がセッション・ステート・アイテムの値に含まれているかどうかを確認できます。「式1」に指定した文字列が、「式2」に指定したアイテムの値に含まれているかどうかを確認します。

式1のアイテムの値が、式2のコロンで区切られたリストに含まれない

「式1」に指定した値に、コロンで区切られた要素リストの文字列が含まれている場合は、trueと評価されます。

P1_TODAYが「Monday」、「Tuesday」または「Wednesday」のいずれかであるかどうかを確認するには、この条件を選択して、「式1」および「式2」に次のとおり入力します。

- 式1: P1_TODAY

- 式2: Monday: Tuesday:Wednesday

式1のアイテムの値がNOT NULL

「式1」に、アプリケーションまたはページ・アイテムの名前(大文字)を入力します。アイテムのキャッシュの現在の値がNULLでない(値を持つ)場合は、trueと評価されます。そうでない場合は、falseと評価されます。

式1のアイテムの値がNULL

「式1」のアイテムが値を持たない場合は、trueと評価されます。

式1のアイテムの値がNULLまたは0 (ゼロ)

「式1」のアイテムの値がNULLまたは0 (ゼロ)のいずれかである場合は、trueと評価されます。

式1のアイテムの値が数値

「式1」のアイテムの値が数値である場合は、trueと評価されます。

「式1のユーザー・プリファレンスの値!=式2」

この条件は、「式1のユーザー・プリファレンスの値=式2」の反対の条件です。「式1」に指定したユーザー・プリファレンスの名前が「式2」の文字列と同じでない場合は、trueと評価されます。

式1のユーザー・プリファレンスの値=式2

ユーザー・プリファレンスの値を確認します。「式1」に指定したユーザー・プリファレンスの名前が「式2」の文字列と同じである場合は、trueと評価されます。

カンマで区切られたアイテム・リストのアイテムを変更した場合

「式1」に指定したアイテム・リストに含まれる、NULLでない任意のセッション・ステート・アイテムの値を変更した場合は、trueと評価されます。

カンマで区切られたページ・リストのアイテムを変更した場合

「式1」に指定したページ・リストに含まれる、NULLでない任意のセッション・ステート・アイテムの値を変更した場合は、trueと評価されます。

カレント・アプリケーションのアイテムを変更した場合

カレント・アプリケーションのNULLでない任意のセッション・ステート・アイテムの値を変更した場合は、trueと評価されます。

カレント・ページのアイテムを変更した場合

カレント・ページのNULLでない任意のセッション・ステート・アイテムの値を変更した場合は、trueと評価されます。

カレント・セッションのアイテムを変更した場合

カレント・セッションのNULLでない任意のセッション・ステート・アイテムの値を変更した場合は、trueと評価されます。

CGI_ENV DAD_NAME!=式1

この条件は、「CGI_ENV DAD_NAME=式1」の反対の条件です。

アプリケーションのカレント・ページを呼び出すURLに使用されているデータ・アクセス記述子(DAD)を確認し、それを「式1」と比較します。DADが「式1」と同じでない場合は、trueと評価されます。

CGI_ENV DAD_NAME=式1

アプリケーションのカレント・ページを呼び出すURLに使用されているデータ・アクセス記述子(DAD)を確認し、それを「式1」と比較します。DADが「式1」と同じである場合は、trueと評価されます。

CGI_ENV HTTP_HOST!=式1

この条件は、「CGI_ENV HTTP_HOST=式1」の反対の条件です。

Common Gateway Interface(CGI)環境変数HTTP_HOSTの値を確認します。これは、owa_util.get_cgi_env ('HTTP_HOST')によって戻される値です。この値が「式1」の文字列と同じでない場合は、trueと評価されます。

CGI_ENV HTTP_HOST=式1

Common Gateway Interface(CGI)環境変数HTTP_HOSTの値を確認します。これは、owa_util.get_cgi_env ('HTTP_HOST')によって戻される値です。この値が「式1」の文字列と同じである場合は、trueと評価されます。

CGI_ENV SERVER_NAME!=式1

この条件は、「CGI_ENV SERVER_NAME=式1」の反対の条件です。

Common Gateway Interface(CGI)環境変数SERVER_NAMEの値を確認します。これは、owa_util.get_cgi_env ('SERVER_NAME')によって戻される値です。この値が「式1」の文字列と同じでない場合は、trueと評価されます。

CGI_ENV SERVER_NAME=式1

Common Gateway Interface(CGI)環境変数SERVER_NAMEの値を確認します。これは、owa_util.get_cgi_env ('SERVER_NAME')によって戻される値です。この値が「式1」の文字列と同じである場合は、trueと評価されます。

B PUBLICに付与された権限

このセクションでは、既存のパブリック・シノニムについて説明します。パブリック・シノニムでは、Oracle Application Express製品スキーマ(たとえば、APEX_030200)が所有するパッケージ、プロシージャ、ファンクション、表およびビューに対するEXECUTE権限がPUBLICに付与されています。

この項には、次の項目が含まれます。

- パッケージ

- プロシージャ

- ファンクション

- 表

- ビュー

パッケージ

パブリック・シノニムが存在し、Oracle Application Express製品スキーマ(たとえば、APEX_030200)が所有する次のパッケージに対するEXECUTE権限がPUBLICに付与されます。

HTMLDB_CUSTOM_AUTH

HTMLDB_ITEM

HTMLDB_LANG

HTMLDB_UTIL

WWV_FLOW

WWV_FLOW_API

WWV_FLOW_AUDIT

WWV_FLOW_CSS_API

WWV_FLOW_COLLECTION

WWV_FLOW_CUSTOM_AUTH

WWV_FLOW_CUSTOM_AUTH_LDAP

WWV_FLOW_CUSTOM_AUTH_SSO

WWV_FLOW_CUSTOM_AUTH_STD

WWV_FLOW_CUSTOMIZE

WWV_FLOW_EPG_INCLUDE_MODULES

WWV_FLOW_FILE_MGR

WWV_FLOW_FND_USER_API

WWV_FLOW_GLOBAL

WWV_FLOW_HELP

WWV_FLOW_HINT

WWV_FLOW_HTML_API

WWV_FLOW_ID

WWV_FLOW_IMAGE_API

WWV_FLOW_ITEM

WWV_FLOW_ITEM_HELP

WWV_FLOW_LANG

WWV_FLOW_LDAP

WWV_FLOW_LOOKUP_TABLES

WWV_FLOW_MAIL

WWV_FLOW_PLSQL_JOB

WWV_FLOW_PREFERENCES

WWV_FLOW_RANDOM

WWV_FLOW_RENDER_SHORTCUT

WWV_FLOW_REWRITE_QUERY

WWV_FLOW_USER_API

WWV_FLOW_UTILITIES

WWV_FLOW_SVG

WWV_FLOW_WEB_SERVICES

WWV_MIG_ACC_LOAD

WWV_RENDER_CALENDAR2

WWV_RENDER_CHART2

WWV_SPELING

Oracle Application Express製品スキーマ(たとえば、APEX_030200)が所有する次のパッケージに対するEXECUTE権限がPUBLICに付与されます。

APEX_SITE_ADMIN_PRIVS

HTMLDB_SITE_ADMIN_PRIVS

WWV_CALCULATOR

WWV_FLOW_FLASH_CHART

WWV_FLOW_GENERATE_DDL

WWV_FLOW_IMAGE_GENERATOR

WWV_FLOW_TREE_GLOBAL_VARS

プロシージャ

パブリック・シノニムが存在し、Oracle Application Express製品スキーマ(たとえば、APEX_030200)が所有する次のプロシージャに対するEXECUTE権限がPUBLICに付与されます。

APEX

APEX_ADMIN

DEVELOPMENT_SERVICE_HOME

DEVELOPMENT_SERVICE_HOME_LOGIN

DEVELOPMENT_SERVICE_SIGNUP

F

HTMLDB

HTMLDB_ADMIN

HTMLDB_LOGIN

P

WWV_FLOW_INIT_HTP_BUFFER

Z

Functions

パブリック・シノニムが存在し、Oracle Application Express製品スキーマ(たとえば、APEX_030200)が所有する次のファンクションに対するEXECUTE権限がPUBLICに付与されます。

NV

V

WWV_FLOW_HOT_HTTP_LINKS

Oracle Application Express製品スキーマ(たとえば、APEX_030200)が所有する次のファンクションに対するEXECUTE権限がPUBLICに付与されます。

WWV_POPUP_FILTER

表

パブリック・シノニムが存在し、Oracle Application Express製品スキーマ(たとえば、APEX_030200)が所有する次の表に対するSELECT権限がPUBLICに付与されます。

WWV_FLOW_DUAL100

WWV_FLOW_TEMP_TABLE

WWV_FLOW_LOV_TEMP

ビュー

パブリック・シノニムが存在し、Oracle Application Express製品スキーマ(たとえば、APEX_030200)が所有する次のビューに対するSELECT権限がPUBLICに付与されます。

APEX_APPLICATIONS

APEX_APPLICATION_ALL_AUTH

APEX_APPLICATION_AUTH

APEX_APPLICATION_AUTHORIZATION

APEX_APPLICATION_BC_ENTRIES

APEX_APPLICATION_BREADCRUMBS

APEX_APPLICATION_BUILD_OPTIONS

APEX_APPLICATION_COMPUTATIONS

APEX_APPLICATION_FLASH_CHARTS

APEX_APPLICATION_FLASH_SERIES

APEX_APPLICATION_ITEMS

APEX_APPLICATION_LISTS

APEX_APPLICATION_LIST_ENTRIES

APEX_APPLICATION_LOVS

APEX_APPLICATION_LOV_ENTRIES

APEX_APPLICATION_NAV_BAR

APEX_APPLICATION_PAGES

APEX_APPLICATION_PAGE_BRANCHES

APEX_APPLICATION_PAGE_BUTTONS

APEX_APPLICATION_PAGE_COMP

APEX_APPLICATION_PAGE_DB_ITEMS

APEX_APPLICATION_PAGE_ITEMS

APEX_APPLICATION_PAGE_MAP

APEX_APPLICATION_PAGE_PROC

APEX_APPLICATION_PAGE_REGIONS

APEX_APPLICATION_PAGE_RPT_COLS

APEX_APPLICATION_PAGE_VAL

APEX_APPLICATION_PARENT_TABS

APEX_APPLICATION_PROCESSES

APEX_APPLICATION_SHORTCUTS

APEX_APPLICATION_SUPP_OBJECTS

APEX_APPLICATION_SUPP_OBJ_BOPT

APEX_APPLICATION_SUPP_OBJ_CHCK

APEX_APPLICATION_SUPP_OBJ_SCR

APEX_APPLICATION_TABS

APEX_APPLICATION_TEMPLATES

APEX_APPLICATION_TEMP_BC

APEX_APPLICATION_TEMP_BUTTON

APEX_APPLICATION_TEMP_CALENDAR

APEX_APPLICATION_TEMP_LABEL

APEX_APPLICATION_TEMP_LIST

APEX_APPLICATION_TEMP_PAGE

APEX_APPLICATION_TEMP_POPUPLOV

APEX_APPLICATION_TEMP_REGION

APEX_APPLICATION_TEMP_REPORT

APEX_APPLICATION_THEMES

APEX_APPLICATION_TRANSLATIONS

APEX_APPLICATION_TREES

APEX_APPLICATION_WEB_SERVICES

APEX_DICTIONARY

APEX_WORKSPACES

APEX_WORKSPACE_ACTIVITY_LOG

APEX_WORKSPACE_APEX_USERS

APEX_WORKSPACE_CLICKS

APEX_WORKSPACE_DEVELOPERS

APEX_WORKSPACE_FILES

APEX_WORKSPACE_LOG_SUMMARY

APEX_WORKSPACE_LOG_SUMMARY_USR

APEX_WORKSPACE_SCHEMAS

APEX_WORKSPACE_SESSIONS

APEX_WORKSPACE_SQL_SCRIPTS

WWV_FLOW_CLICKTHRU_LOG

WWV_FLOW_COLLECTIONS

WWV_FLOW_FILES

WWV_FLOW_GROUP_USERS

WWV_FLOW_HOURS_12

WWV_FLOW_HOURS_24

WWV_FLOW_LISTS_OF_VALUES$_V

WWV_FLOW_LIST_OF_VALUES_DATA_V

WWV_FLOW_MINUTES

WWV_FLOW_MINUTES_5

WWV_FLOW_MONTHS_MON

WWV_FLOW_MONTHS_MONTH

WWV_FLOW_PLSQL_JOBS

WWV_FLOW_USERS

WWV_FLOW_USER_ACTIVITY_LOG

WWV_FLOW_USER_MAIL_LOG

WWV_FLOW_USER_MAIL_QUEUE

WWV_FLOW_YEARS

索引
A B C D E F G H I J L M N O P Q R S T U V W X

A

ページ受入れ, 3.2.1

アクセス制御

認可スキーム, 7.10.4

アクセス制御リスト

概要, 7.10

ユーザーの追加, 7.10.3.2

作成, 7.10.2

ユーザーの削除, 7.10.3.3

アプリケーション・モードの選択, 7.10.3

ユーザー権限の選択, 7.10.3.2

アクション・バー, 4.3.1

概要, 5.1.2.2

「コメント」アイコン, 5.1.2.2

「ページのエクスポート」アイコン, 5.1.2.2

「検索」アイコン, 5.1.2.2

「ロック」アイコン, 5.1.2.2

「ページの実行」アイコン, 5.1.2.2

「共有コンポーネント」アイコン, 5.1.2.2

アクティビティ・ログ, 15.5 アクティビティ・レポート

カスタム・レポートの作成, 15.5

「管理」リスト, 1.5

Application Expressのバージョン情報, 1.5

パスワードの変更, 1.5

Application Expressユーザーの管理, 1.5

サービスの管理, 1.5

アクティビティの監視, 1.5

APEX_ACTIVITY_LOGビュー, 15.5 APEX_COLLECTION, 15.4.1

ADD_MEMBER, 15.4.6

COLLECTION_EXISTS, 15.4.11.3

COLLECTION_MEMBER_COUNT, 15.4.11.1

CREATE_COLLECTION, 15.4.2

CREATE_COLLECTION_FROM_QUERY, 15.4.2

CREATE_COLLECTION_FROM_QUERY_B, 15.4.2

CREATE_OR_TRUNCATE_COLLECTION, 15.4.2, 15.4.12

DELETE_ALL_COLLECTIONS, 15.4.5.1

DELETE_ALL_COLLECTIONS_SESSION, 15.4.5.2

DELETE_COLLECTION, 15.4.5

DELETE_MEMBER, 15.4.8

DELETE_MEMBERS, 15.4.8

GET_MEMBER_MD5, 15.4.9

MOVE_MEMBER_DOWN, 15.4.11.4

RESEQUENCE_COLLECTION, 15.4.11.2

RESET_COLLECTION_CHANGED, 15.4.9

SORT_MEMBERS, 15.4.11.5

TRUNCATE_COLLECTION, 15.4.3

UPDATE_MEMBER, 15.4.7

UPDATE_MEMBER_ATTRIBUTE, 15.4.7, 15.4.7

APEX_LANG

LANG, 16.5.2

MESSAGE API, 16.4.1.1

APEX_PLSQL_JOB, 15.6.1 API

APEX_COLLECTION, 15.4.1

APEX_LANG, 16.4.1.1, 16.5.2

APEX_PLSQL_JOB, 15.6.1

アプリケーション

ページの追加, 6.2

Webサイトからのコンテンツの追加, 9.6

グループへの割当て, 6.5.3

問合せに基づく, 6.1.2.1

スプレッドシート・データに基づく, 6.1.3

ブランチを使用したナビゲーションの制御, 8.6

コピー, 4.3, 6.1.5

作成, 6.1

グループの作成, 6.5.2

表での作成, 6.1.2.1

デバッグ, 12

プライマリ言語の定義, 16.2

削除, 4.2, 4.3, 6.1.6

デモンストレーション, 6.1.4

デモンストレーション, 2.1

デプロイ, 14.2, 14.3, 14.5.1

エクスポート, 14.3, 14.5.1

グループ化, 6.5

非表示機能, 14.9.3

エクスポート・ファイルのインポート, 14.6

SQL*Plusからのインポート, 14.7.5

言語プリファレンス, 16.1.1

パフォーマンス・チューニング, 12.1

グループからの削除, 6.5.4

リソース使用, 12.5

実行, 6.2.6

電子メールの送信, 15.3.2

アクティブなテーマの切替え, 10.1.5

翻訳可能なコンポーネント, 16.1.3

翻訳, 16.1

コンポーネントの翻訳, 16.1.4

マルチバイト言語の翻訳, 16.2.2

翻訳のレンダリング, 16.1.3

「アプリケーションの別名」属性, 4.4.1.2.1 アプリケーション属性

アプリケーションの別名, 4.4.1.2.1

アプリケーション・グループ, 4.4.1.2.1

デフォルトのアプリケーション・テンプレート, 4.4.1.2.8

可用性, 4.4.1.2.2

ビルド・オプション, 4.4.1.2.6

ビルド・ステータス, 4.4.1.2.2

コンポーネントのデフォルト値, 4.4.1.2.9

デバッグ, 4.4.1.2.1

デフォルト・ページ・テンプレート, 4.4.1.2.8

編集, 4.4.1

エラー・ページ・テンプレート, 4.4.1.2.8

完全置換, 4.4.1.2.1

エクスポート, 14.5.3

グローバル通知, 4.4.1.2.3

イメージ接頭辞, 4.4.1.2.1

ロギング, 4.4.1.2.1

ロゴ, 4.4.1.2.5

メディアのタイプ, 4.4.1.2.1

使用できないアプリケーションに対するメッセージ, 4.4.1.2.2

「名前」属性, 4.4.1.2.1

解析対象スキーマ, 4.4.1.2.1

出力モード・ページ・テンプレート, 4.4.1.2.8

プロキシ・サーバー, 4.4.1.2.1

アクセスの制限, 4.4.1.2.2

ステータス, 4.4.1.2.2

サブスクリプション, 4.4.1.2.4

テーマ, 4.4.1.2.7

バージョン, 4.4.1.2.1

仮想プライベート・データベース, 4.4.2.2.6

アプリケーション・ビルダー

アクセス, 4.1

ホームページ, 4.2

ページ定義, 3.1

アプリケーション・ビルダーのホームページ, 4.1, 4.2 アプリケーション・ビルダー・ホームの「タスク」リスト

アプリケーション・ビルダーのデフォルト値, 4.2

アプリケーションの計算

概要, 5.8.1

アプリケーションの計算ページ, 5.8.2.1

作成, 5.8.2

「新しいインスタンス開始時」の実行, 5.8.1.1

履歴レポート, 5.8.3

「アプリケーション日付書式」属性, 4.4.3.2.3 アプリケーション定義

編集, 4.4.1

Application Express管理サービス, 1.4.2 アプリケーション・グループ

ページの割当て, 6.5.3

作成, 6.5.2

グループ定義の編集, 6.5.2.1

削除, 6.5.5

ページの削除, 6.5.4

表示, 6.5.1

アプリケーション・グループの属性, 4.4.1.2.1 アプリケーションのホームページ, 4.3

ページの追加, 6.2.2

ページのコピー, 6.2.5

「エクスポート」/「インストール」アイコン, 4.3

「アプリケーションの実行」アイコン, 4.3

デモンストレーション・アプリケーションの実行, 2.2.2

「共有コンポーネント」アイコン, 4.3

アプリケーション・ホームの「タスク」リスト

アプリケーション・レポート, 4.3

このアプリケーションのコピー, 4.3

このアプリケーションの削除, 4.3

エクスポート・リポジトリの管理, 4.3

ページ・グループ, 4.3

ページ・ロック, 4.3

ユーザー・インタフェースのデフォルト値, 4.3

アプリケーション・アイテム

概要, 6.7.1, 6.8

作成, 6.8.1

属性の編集, 6.8.3

履歴, 6.8.2

アプリケーション・アイテム, 5.6.2.2.4 アプリケーション・アイテム・ページ, 6.8.1.1 アプリケーション言語

判別, 4.4.3

「アプリケーション言語の派生元」属性, 4.4.3.2.2, 16.2 アプリケーション・レイアウト

他のLOVを駆動するLOV, 7.7

複数の列, 9.4

印刷プレビュー・モード, 7.12

ショートカット, 7.8

アプリケーション・ロジック

すべてを編集, 5.3.1

アプリケーション・モデル, 6.1.2.2

利用, 6.1.2.3

「アプリケーションのプライマリ言語」属性, 4.4.3.2.1, 16.2 アプリケーション・プロセス

アプリケーション・プロセス・ページ, 5.7.3.1, 5.7.3.1

作成, 5.7.3

例, 5.7.2

履歴レポート, 5.7.4.2

オンデマンド, 5.7.1

レポート, 5.7.4

理解, 5.7

使用状況レポート, 5.7.4.1

アプリケーション・レポート

アクティビティ, 6.6.4

アプリケーション間, 6.6.5

ページ・コンポーネント, 6.6.3

共有コンポーネント, 6.6.2

表示, 6.6, 12.6

アーキテクチャ, 1.2 認証, 3.2.3, 13.4

認証スキーム・リポジトリ, 13.4.6

最初からスキームを作成, 13.4.5

認証スキームの作成, 13.4.3

事前構成された認証スキーム, 13.4.4

セキュリティ属性, 4.4.2.2.1

カレント・スキームの表示, 13.4.7

「認証スキーム」属性, 4.4.2.2.1 認証スキーム

Application Expressアカウント資格証明, 13.4.4.2

Cookieユーザー・アカウント, 13.4.4.2

データベース・アクセス記述子(DAD)資格証明, 13.4.4.5

データベース・アカウント資格証明, 13.4.4.3

LDAP資格証明, 13.4.4.4

公開資格証明, 13.4.4.1

シングル・サインオン, 13.4.4.6

認可, 3.2.4 「認可」属性, 4.4.2.2.2 認可スキーム

アプリケーション, 4.4.2.2.2

指定, 4.4.2.2.2

認可スキーム, 13.5.1

アプリケーションへの割当て, 13.5.3.1

コンポーネントへの割当て, 13.5.3.3

コントロールへの割当て, 13.5.3.3

ページへの割当て, 13.5.3.2

作成, 13.5.2

アクセス制御, 7.10.4

「自動CSVエンコーディング」属性, 4.4.3.2.4

B

バックグラウンドPL/SQL, 15.6

APEX_PLSQL_JOB, 15.6.1

プロセスの使用, 15.6.3

バインド変数

構文, 3.5.4

PL/SQLプロシージャでの使用, 3.5.4.2

リージョンでの使用, 3.5.4.1

BLOB

APEX_UTIL.GET_BLOB_FILE_SRC, 15.8.3

サポートのダウンロード, 15.8.1

移入, 15.8.1

フォームでのサポート, 15.8

レポートでのサポート, 15.8.2

ブランチ

概要, 5.3.10

作成, 8.6, 8.6

「対象ボタン」属性, 3.6.2.20.3

ブランチ

アクション, 5.3.10.1

ブランチ・ポイント, 5.3.10.1

「ブランチ・ポイント」リスト, 5.3.10.1

条件付きの作成, 5.3.10.2

ロード時, ヘッダーの前, 5.3.10.1

送信時, プロセス後, 5.3.10.1

送信時, 計算の前, 5.3.10.1

送信時, プロセス前, 5.3.10.1

送信時, 検証の前, 5.3.10.1

ボタンの使用, 7.5.6

ブレッドクラム・テンプレート, 10.2.6

コメント, 10.2.6.2.6

定義, 10.2.6.2.4

名前, 10.2.6.2.1

サブスクリプション, 10.2.6.2.2

置換文字列, 10.2.6.2.7

テンプレート属性, 10.2.6.2.5

テンプレート・タイプ, 10.2.6.2.3

ブレッドクラム, 5.3.6.3

概要, 8.3.1

エントリの追加, 8.3.2.2.3

ページへの追加, 8.3.2.2.4

作成, 8.3, 8.3.2

動的な作成, 8.3.2.2.5

編集, 8.3.3

ナビゲーション, 10.2.6.1

エントリの親の変更, 8.3.4

レポート, 履歴, 8.3.5

レポート, 使用状況, 8.3.5

共有コンポーネント, 5.3.6.3

ビルド・オプション・ステータス

エクスポート, 14.9.3

ビルド・オプション, 14.9

ステータスの変更, 14.9.2

作成, 14.9.1

除外, 14.9.2

エクスポート, 14.9.3

追加, 14.9.2

レポート, 14.9.4

表示オプション, 14.9.1.1

「ビルド・オプション」属性, 4.4.1.2.6 「ビルド・ステータス」属性, 4.4.1.2.2 組込み置換文字列, 3.6.2 「アイテム・ヘルプをバルク編集」レポート, 7.13.2.3 ボタン

概要, 5.3.4.3, 7.5.1

ブランチ, 7.5.6

作成, 7.5, 7.5.2

一度に複数を作成, 7.5.3

複数を削除, 7.5.4.2.1

条件付きの表示, 7.5.7

編集, 7.5.4

属性の編集, 7.5.4.1

複数を編集, 7.5.4.2

名前, 7.5.5

テンプレート, 10.2.7

「ボタンの順序変更」アイコンの使用, 7.5.4.3

ボタン・テンプレート

コメント, 10.2.7.1.4

定義, 10.2.7.1.3

名前, 10.2.7.1.1

サブスクリプション, 10.2.7.1.2

置換文字列, 10.2.7.1.5

C

キャッシング

リージョン, 9.3.3.5

カレンダ

ページへの追加, 7.3.2.1

新しいページへの追加, 7.3.2.2

SQLへの簡単な変換, 7.3.6

作成, 7.3, 7.3.2

列リンクの作成, 7.3.4.2.3

日付リンクの作成, 7.3.4.2.4

カレンダの間隔の定義, 7.3.4.2.2

表示属性の定義, 7.3.4.2.2

簡易カレンダ, 7.3.1

属性の編集, 7.3.4

タイトルの編集, 7.3.3

書式設定, 7.3.4.2.1

SQLカレンダ, 7.3.1

サポートされる置換文字列, 7.3.1.1

タイプ, 7.3.1

アップグレード, 7.3.5

カレンダ属性

アクセス, 7.3.4.1

カレンダ表示, 7.3.4.2.1

列リンク, 7.3.4.2.3

日付のリンク, 7.3.4.2.4

表示属性, 7.3.4.2.2

カレンダ・テンプレート, 10.2.8

コメント, 10.2.8.1.3

日次カレンダ, 10.2.8.1.3

月別カレンダ, 10.2.8.1.3

名前, 10.2.8.1.1

テンプレートのサブスクリプション, 10.2.8.1.2

週間カレンダ, 10.2.8.1.3

カスケード・スタイルシート

概要, 10.2.1

エクスポート, 14.5.5

インポート, 14.6.2

SVGチャートの参照, 7.4.4.5

ページ・テンプレートでの参照, 10.3.2

インラインの参照(SVGチャート) , 7.4.4.6

検索, 7.9.8

アップロード, 10.3.1

カスタムの使用, 10.3

表示, 7.9.8

チャート

Flashの概要, 7.4.1.1

SVGの概要, 7.4.1.2

ウィザードについて, 7.4.2

表示の変更, 7.4.6

非同期更新, 7.4.8

ローソク足構文, 7.4.2

作成, 7.4

ダイアル・チャート構文, 7.4.2

他の言語での表示, 7.4.9

属性の編集, 7.4.6

Flash, 7.4.5

HTMLチャート, 7.4.3

すべてのSVGチャートをFlashヘ移行, 7.4.5.3.3

SVGのFlashへの移行, 7.4.5.3.2

監視情報, 7.4.8

複数シリーズ構文, 7.4.2

SQL問合せの作成, 7.4.2

範囲構文, 7.4.2

スキャッタ構文, 7.4.2

SQL問合せ構文, 7.4.2

サポートされるタイプ, 7.4.1

SVGチャート, 7.4.4

タイプ, 7.4.2

チェック・ボックス, 6.7.3.3 クラシック・レポート

ダウンロード・リンクの追加, 7.1.4.5

列ブレークの制御, 7.1.4.12

列表示の制御, 7.1.4.11

更新可能な列の作成, 7.1.4.9

LOVとして列を定義, 7.1.4.10

エクスポート, 7.1.4.7

クラシック・レポート・リージョン

出力属性の構成, 7.1.5.6

出力メソッド, 7.1.5.3

クラシック・レポート

変更, 7.1.4

位置の変更, 7.1.4

列属性の変更, 7.1.4

列テキストの変更, 7.1.4

ページ区切りの変更, 7.1.4.3

合計の作成, 7.1.4

列の非表示, 7.1.4

列のソート, 7.1.4

コレクション・ショウケース, 2.1, 6.1.4.1 コレクション, 15.4

アクセス, 15.4.4

メンバーの追加, 15.4.6

APEX_COLLECTION API, 15.4.1

セッション・ステートのクリア, 15.4.12

作成, 15.4.2

削除, 15.4.5

メンバーの削除, 15.4.8

ステータスの判別, 15.4.9

管理, 15.4.11

マージ, 15.4.10

命名, 15.4.1.1

切捨て, 15.4.3

メンバーの更新, 15.4.7

列の定義

編集, 11.2

列テンプレート

JavaScriptの使用, 10.2.14.4

「コメント」属性, 5.4.2.12 コンポーネントのデフォルト値, 4.4.1.2.9

ブレッドクラム, 4.4.1.2.9

ブレッドクラム・リージョン, 4.4.1.2.9

ボタン, 4.4.1.2.9

カレンダ, 4.4.1.2.9

チャート・リージョン, 4.4.1.2.9

フォーム・リージョン, 4.4.1.2.9

ラベル, 4.4.1.2.9

リスト, 4.4.1.2.9

リスト・リージョン, 4.4.1.2.9

リージョン, 4.4.1.2.9

レポート, 4.4.1.2.9

レポート・リージョン, 4.4.1.2.9

表形式フォーム・リージョン, 4.4.1.2.9

ウィザード・リージョン, 4.4.1.2.9

コンポーネント

翻訳について, 16.1.4

アクセス制御, 3.2.4

すべてのページでの表示, 9.2

各ページでの表示, 9.1

メッセージの翻訳, 16.4, 16.4.1, 16.4.2

条件タイプ

一般的な, 3.2.2

条件付き

処理, 3.2.2

レンダリング, 3.2.2

条件

リージョンの表示, 9.3.3.2

リスト, A

使用, 3.2.2

ボタンでの使用, 7.5.7

構成

制御, 14.9

制御

アクセス制御, 3.2.4

「コピー」アイコン, 5.3.2 アプリケーションの作成ウィザード, 6.1 ブランチの作成ウィザード, 8.6, 8.6 ブレッドクラムの作成ウィザード, 8.3.2.2 ボタンの作成ウィザード, 7.5.2 「作成」アイコン, 5.3.2 ナビゲーション・バー・エントリの作成ウィザード, 8.5.2 ページ計算の作成ウィザード, 5.3.7.1, 15.7.9 ページ・プロセスの作成ウィザード, 5.3.9.1 ページの作成ウィザード

概要, 6.2.1

リージョンの作成ウィザード, 7.3.2.1, 8.3.2.2.4, 9.3.4 検証の作成ウィザード, 5.3.8.1, 7.2.5.1 クロスサイト・スクリプティング

概要, 13.2.4

動的出力, 13.2.4.2

フォーム・アイテム, 13.2.4.4

HTMLリージョン, 13.2.4.1

レポート・リージョン, 13.2.4.3

静的表示領域, 13.2.4.1

CSSクラス

SVGチャート, 7.4.4.4

CSSファインダ, 7.9, 7.9.8 CSSリポジトリ, 10.3.1.1

D

データベース・リンク, 15.2

データベース・オブジェクトの依存性

「次へ」ボタン, 5.2.3

「ページ」フィールド, 5.2.3

「前へ」ボタン, 5.2.3

「ビュー」リスト, 5.2.3

データベース・オブジェクト

表示, 2.5

データベース・スキーマ

アプリケーション, 4.4.2.2.3, 4.4.2.2.4

指定, 4.4.2.2.3, 4.4.2.2.4

「データベース・スキーマ」属性, 4.4.2.2.3, 4.4.2.2.4 日付ピッカー, 6.7.3.3 DBMS_APPLICATION_INFO, 12.5 デバッグ・モード, 12.3 デバッグ, 12

デバッグ・モード, 12.3

問題の特定, 12.8

SQL問合せ, 12.7

SQLトレース, 12.4

レポートの表示, 12.6

「デバッグ」属性, 4.4.1.2.1 ディープ・リンク, 13.4.5.3 「デフォルト・ページ・テンプレート」属性, 4.4.1.2.8 エクスポート・ファイルの削除, 14.7.4 デモンストレーション・アプリケーション

コレクション・ショウケースについて, 2.1, 6.1.4.1

Sample Applicationについて, 2.1, 2.3, 6.1.4.1

編集, 2.4, 2.4.2

インストール, 2.1

変更, 2.4, 2.4.2

アプリケーションのホームページからの実行, 2.2.2

デモンストレーション・アプリケーション・ページからの実行, 2.2.1

表示, 2.1

デモンストレーション・アプリケーション・ページ, 2.1, 6.1.4.1

アプリケーションの編集, 2.4.2

アプリケーションの実行, 2.2.1

デプロイ, 14.3

サポートするオブジェクトの作成, 14.4.2

ページのエクスポート, 14.5.4

アプリケーション定義のエクスポート, 14.5.1

カスケード・スタイルシートのエクスポート, 14.5.5

イメージのエクスポート, 14.5.6

スクリプトのエクスポート, 14.5.8

静的ファイルのエクスポート, 14.5.7

テーマのエクスポート, 14.5.9

ユーザー・インタフェース・デフォルトのエクスポート, 14.5.10

SQL*Plusからのアプリケーションのインポート, 14.7.5

エクスポート・ファイルのインポート, 14.6

ファイルのインポート, 14.6

アプリケーション・エクスポートのインストール, 14.7.2

ファイルのインストール, 14.7.3

データベース・オブジェクトの管理, 14.3.1

アプリケーション, 14.2

オプション, 14.2.1

アプリケーションのパッケージ化, 14.2

URLの公開, 14.8

「開発者のコメント」アイコン, 4.3.1.4, 5.1.2.2.3 開発者コメント

概要, 6.4

ページへの追加, 6.4.1

アプリケーションへの追加, 6.4.1

削除, 6.4.3

編集, 6.4.2

表示, 6.4.2

レポートの表示, 6.4.4

「開発者のコメント」レポート

アクセス, 6.4.4.1

コメントの削除, 6.4.4.3

複数のコメントの削除, 6.4.4.4

ダウンロード, 6.4.4.5

コメントの編集, 6.4.4.2

開発者のプリファレンス

構成, 4.2.1

開発者ツールバー

概要, 2.4.1

アクティビティ, 2.4.1, 5.5

ページの作成, 6.2.4

セッション, 3.3.3

使用, 5.5

開発のライフ・サイクル, 14.1 ダイアル・チャート

構文, 7.4.2

「表示」リスト

デフォルトの構成, 4.2.1

DML

ロックの概要, 15.1

APEX_DML_LOCK_WAIT_TIME, 15.1

DML操作の制御, 15.1

FSP_DML_LOCK_ROW, 15.1

ドラッグ・アンド・ドロップ・レイアウト

概要, 6.7.5.2

アクセス, 6.7.5.1

新しいアイテムの作成, 6.7.5.3

アイテムの削除, 6.7.5.5

アイテムの編集, 6.7.5.4

動的な翻訳, 16.5

E

定義の編集ページ

仮想プライベート・データベース, 4.4.2.2.6

グローバリゼーション属性の編集

アプリケーション日付書式, 4.4.3.2.3

アプリケーション言語の派生元, 4.4.3.2.2

アプリケーションのプライマリ言語, 4.4.3.2.1

自動CSVエンコーディング, 4.4.3.2.4

グローバリゼーション属性の編集ページ, 4.4.3 「ページの編集」アイコン, 4.3.1.2 セキュリティ属性の編集, 4.4.2

認証, 4.4.2.2.1

認可, 4.4.2.2.2

データベース・スキーマ, 4.4.2.2.3, 4.4.2.2.4

セッション・ステート保護, 4.4.2.2.5

電子メール

環境設定の構成, 15.3.1

電子メール・ログ, 15.3

電子メール・キュー, 15.3

管理, 15.3

送信の問題, 13.1.8

アプリケーションからの送信, 15.3.2

埋込みPL/SQLゲートウェイ, 1.2

イメージ、CSSおよびスクリプト・ファイルの場所, 14.5.11.2

セキュリティの実行, 13.1.1

エンジン

Application Express, 1.2

環境

構成, 1.4.2

環境設定

電子メールの構成, 15.3.1

「エラー・ページ・テンプレート」属性, 4.4.1.2.8 「完全置換」属性, 4.4.1.2.1 エクスポート

ページ, 5.2.5

アプリケーション, 14.5

アプリケーション属性, 14.5.3

ビルド・オプション・ステータス, 14.5.3

CSS, 14.5.5

イメージ, 14.5.6

データベース・オブジェクトの管理, 14.3.1

ページ, 14.5.4

関連ファイル, 14.5

スクリプト・ファイル, 14.5.8

共有コンポーネント

エクスポート, 14.5.3

静的ファイル, 14.5.7 翻訳用テキスト, 16.3.2 テーマ, 14.5.9 翻訳オプション, 16.3.2.2.4 ユーザー・インタフェースのデフォルト値, 14.5.10 エクスポート

「ページ」フィールド, 5.2.5

「ビュー」リスト, 5.2.5

「エクスポート」アイコン, 5.1.2.2.5 エクスポート・リポジトリ, 14.7.2, 14.7.3, 14.7.4

アクセス, 14.7.1

エクスポートされたアプリケーション

インポート, 14.6

「エクスポート」/「インストール」アイコン, 4.3

F

f?p構文, 3.4.2

ブックマークの容易化, 3.4.5

ファイル・アップロード表

セキュリティ・リスク, 13.3

ファイル

アップロードしたファイルの削除, 9.8.4

アップロードしたファイルのダウンロード, 9.8.3

アップロードしたファイルの編集, 9.8.2

管理, 9.8

アップロード, 9.8.1

「検索」アイコン, 4.3.1.5, 5.1.2.2.6, 7.9, 7.9.1 Flashチャート

既存のページへの追加, 7.4.5.1

新しいページへの追加, 7.4.5.2

ローソク足構文, 7.4.2

複数シリーズ構文, 7.4.2

範囲構文, 7.4.2

スキャッタ構文, 7.4.2

カスタムXMLの使用, 7.4.7

フッター

置換文字列, 9.3.3.3

フォームのオートコンプリート, 5.4.2.6 フォーム・ウィザード

Webサービスのフォームとレポート, 7.2.1

プロシージャのフォーム, 7.2.1

SQL問合せのフォーム, 7.2.1

レポート付きの表のフォーム, 7.2.1

表またはビューのフォーム, 7.2.1

Webサービスのフォーム, 7.2.1

マスター・ディテール・フォーム, 7.2.1

サマリー・ページ, 7.2.1

表形式フォーム, 7.2.1

フォーム

行の自動処理(DML)プロセス, 7.2.4.2

作成, 7.2

マスター・ディテールの作成, 7.2.3

表形式フォームの作成, 7.2.2

手動作成, 7.2.4

ウィザードを使用した作成, 7.2.1

ページ・タイプ, 7.2.1

移入, 7.2.4.5

プロセスの理解, 7.2.4.1

入力の検証, 7.2.5

完全開発環境, 1.2 関数

検索, 7.9.6

G

「グローバル通知」属性, 4.4.1.2.3

グローバル化

属性, 16.2

アプリケーション言語の判別, 4.4.3

書式マスク, 16.2.1

理解, 16.1

グラフィック

管理, 9.7

参照, 9.7.2

アップロード, 9.7.1

グループ

アプリケーション, 6.5

ページ, 6.2.7

グループ

表示, 5.2.6

「ページ」フィールド, 5.2.6

「ビュー」リスト, 5.2.6

GUI

概要, 1.1

H

ヘルプ

問題, 13.1.8

ヘルプ

作成, 7.13

ナビゲーション・バー・エントリの作成, 7.13.3

編集, 6.7.4.2.2, 7.13.2.3

オンライン・ヘルプ・システム, 1.7

ページ・ヘルプ, 1.7

検索, 1.7

使用, 1.7

ヘルプ・テキスト

アイテムの定義, 7.13.2.2

ページの定義, 7.13.2.1

アイテムの編集, 7.13.2.3

履歴

表示, 5.2.4

「次へ」ボタン, 5.2.4

「ページ」フィールド, 5.2.4

「前へ」ボタン, 5.2.4

「ビュー」リスト, 5.2.4

「ホーム・リンク」属性, 4.4.2.2.1, 4.4.2.2.1 HTML

カスタムPL/SQLを使用した生成, 9.9

Application Expressの処理対象外, 9.9

HTMLチャート

既存のページへの追加, 7.4.3.1

新しいページへの追加, 7.4.3.2

I

イメージ・ファインダ, 7.9

イメージ接頭辞

概要, 9.7.2

「イメージ接頭辞」属性, 4.4.1.2.1 イメージ・リポジトリ, 9.7, 9.7.1 イメージ

エクスポート, 14.5.6

インポート, 14.6.4

管理, 9.7

参照, 9.7.2

検索, 7.9.7

アップロード, 9.7.1

使用可能の表示, 7.9.7

イメージ・ファインダ, 7.9.7 インポート

アプリケーション, 14.6.1

SQL*Plusを使用するアプリケーション, 14.7.5

カスケード・スタイルシート, 14.6.2

エクスポート・ファイル, 14.6, 14.6

イメージ, 14.6.4

ページ, 14.6.1

静的ファイル, 14.6.3

テーマ, 14.6.5

ユーザー・インタフェースのデフォルト値, 14.6.6

インストール

アプリケーション・ファイル, 14.7.2

デモンストレーション・アプリケーション, 2.1

エクスポート・ファイル, 14.7.3

アプリケーション・エクスポートのインストール, 14.7.2 エクスポート・ファイルのインストール, 14.7.3 対話モード・レポート・リージョン

出力属性の構成, 7.1.5.7

対話モード・レポート

「アクション」メニューについて, 7.1.2.3

「リンク列」アイコンについて, 7.1.2.2

リンク列について, 7.1.3.8

検索バーについて, 7.1.2.1

フィルタの追加, 7.1.2.5

計算の追加, 7.1.2.9

ダウンロード・オプションの追加, 7.1.3.7

ハイライトの追加, 7.1.2.8

詳細属性, 7.1.3.11

列の集計, 7.1.2.10

属性のページ, 7.1.3.1

ページ区切りの変更, 7.1.3.4

列属性, 7.1.3.2

チャートの作成, 7.1.2.11

ブレーク制御の作成, 7.1.2.7

グループの作成, 7.1.3.3

LOVとして列を定義, 7.1.3.10

ダウンロード, 7.1.2.15

開発者としての編集, 7.1.3

フラッシュバック問合せの実行, 7.1.2.12

エクスポート, 7.1.3.7

リンク付け, 7.1.3.12

列のソートの管理, 7.1.3.5

リセット, 7.1.2.14

保存, 7.1.2.13

名前付きレポートの保存, 7.1.2.13.1

列とソート順の選択, 7.1.2.6

表示する列の選択, 7.1.2.4

使用, 7.1.2

対話モード・レポート

列リンクの作成, 7.1.3.9

アイテム

概要, 5.3.4.4

アプリケーション・アイテム・ページの概要, 6.8.1.1

条件付き, 6.7.7

複数選択リスト・アイテム, 6.7.8

ネーミング規則, 6.7.3.2

読取り専用, 6.7.7

アイテムの値の参照, 6.7.6

JavaScriptを使用した参照, 7.11.1

値の参照, 6.7.6

検索, 7.9.2

翻訳時に書式マスクを使用, 16.2.1

「アイテムの順序変更」アイコンの使用, 6.7.2.2

アイテム属性

レイアウトへの影響, 9.5

新しいフィールドで開始, 9.5

新しい行で開始, 9.5

ColSpan, 9.5

列, 9.5

条件タイプと式, 9.5

横/縦の位置合せ, 9.5

HTML表のセル属性, 9.5

ラベル, 9.5

要素の後のテキスト, 9.5

要素の前のテキスト, 9.5

読取り専用条件タイプ, 9.5

リージョン, 9.5

RowSpan, 9.5

順序, 9.5

テンプレート, 9.5

アイテム・ファインダ, 7.9, 7.9.2 アイテム・ヘルプ

編集, 7.13.2.3

アイテム・タイプ

チェック・ボックス, 6.7.3.3

日付ピッカー, 6.7.3.3

表示のみ, 6.7.3.3

ファイル参照, 6.7.3.3

非表示, 6.7.3.3

非表示で保護, 6.7.3.3

リスト・マネージャ, 6.7.3.3

複数選択, 6.7.3.3

パスワード, 6.7.3.3

ポップアップLOV, 6.7.3.3

ラジオ, 6.7.3.3

選択リスト, 6.7.3.3

シャトル, 6.7.3.3

表の停止および開始, 6.7.3.3

テキスト, 6.7.3.3

テキスト領域, 6.7.3.3

J

JavaScript, 10.2.11.1, 10.2.11.1

ボタンからのコール, 7.11.3

行テンプレート内, 10.2.14.4

「HTMLヘッダー」属性に追加, 7.11.2.1

.jsファイルに追加, 7.11.2.2

ページ・テンプレートに追加, 7.11.2.2

組込み, 7.11

ライブラリ, 10.2.11.1

ロード・イベント, 5.4.2.5

ページ固有, 5.4.2.4

参照アイテム, 7.11.1

アイテムへのフォーカスの設定, 5.4.2.2

JavaScriptファインダ, 7.9

L

ラベル・テンプレート

コメント, 10.2.9.1.5

定義, 10.2.9.1.3

編集, 10.2.9

エラー表示, 10.2.9.1.4

名前, 10.2.9.1.1

サブスクリプション, 10.2.9.1.2

置換文字列, 10.2.9.1.6

言語

アプリケーションの定義, 16.2

マルチバイト, 16.2.2

プリファレンス, 16.1.1

レイアウト

アイテム属性を使用した変更, 9.5

制御, 10

リンク列

概要, 7.1.3.8

除外, 7.1.3.8.4

単一行ビューのリンク, 7.1.3.8.1

ページへのリンク, 7.1.3.8.2

URLへのリンク, 7.1.3.8.3

リンク

ディープ,概要, 13.4.5.3

リスト

リスト・エントリの追加, 8.2.1.3

サブリストの追加, 8.2.1.3

ページへの追加, 8.2.2

リスト・エントリの親の変更, 8.2.1.4

作成, 8.2.1

階層の作成, 10.2.10.1

編集, 8.2.3

複数を編集, 8.2.4

例, 8.2

リスト・ページ, 8.2.3

孤立エントリの親の削除, 8.2.1.5

レポート, 8.2.5

値リスト, 5.3.6.2

静的LOVのバルク編集, 7.6.3.2

作成, 7.6

アプリケーション・レベルでの作成, 7.6.1

依存LOVの作成, 7.7

編集, 7.6.3

「LOV履歴」レポート, 7.6.6.4

LOVページ, 7.6.1.1

「LOVのサブスクリプション」レポート, 7.6.6.2

「LOVの使用状況」レポート, 7.6.6.3

名前付き, 7.6.1

アイテム内のNULL値の参照, 7.6.5

セッション・ステートの参照, 7.6.4

レポート, 7.6.6

「動的LOVの検索」レポート, 7.6.6.1

共有, 7.6.1

静的, 7.6.2

翻訳, 16.5

LOVページ, 7.6.1.1 リスト・レポート

履歴, 8.2.5

未使用のリスト, 8.2.5

使用状況, 8.2.5

リスト・テンプレート

リスト後のエントリ, 10.2.10.2.8

サブリスト後のエントリ, 10.2.10.2.7

リスト前のエントリ, 10.2.10.2.3

サブリスト前のエントリ, 10.2.10.2.5

コメント, 10.2.10.2.9

編集, 10.2.10

名前, 10.2.10.2.1

サブリスト・エントリ, 10.2.10.2.6

サブスクリプション, 10.2.10.2.2

置換文字列, 10.2.10.2.10, 10.2.11.2.12

テンプレート定義, 10.2.10.2.4

リスト, 5.3.6.4 リスト・ページ, 8.2.3 リスト・ウィザード, 8.2.1 「ロック」アイコン, 5.1.2.2.4 ロック

ロック・ステータスの判別, 6.2.8.1

ページ用, 6.2.8

「ロギング」属性, 4.4.1.2.1 ログイン

Oracle Application Express, 1.4.3

ログアウト, 1.4.3.5 ログイン資格証明, 1.4.3.2 ログイン・ページ, 1.4

作成, 13.4.5.2

ログイン資格証明の理解, 1.4.3.2

「ログインURL」属性, 4.4.2.2.1 「ロゴ」属性, 4.4.1.2.5

M

マスター・ディテール・フォーム

作成, 7.2.3

メディアのタイプ属性, 4.4.1.2.1 使用できないアプリケーションに対するメッセージ, 4.4.1.2.2 メッセージ

翻訳, 16.4, 16.4.1

内部の翻訳, 16.4.2

PL/SQLプロシージャでのメッセージ, 16.4.1

翻訳, 16.4.1

レポートでのメッセージ, 16.4.2

翻訳, 16.4.2

N

ナビゲーション

代替方法, 1.6

ブランチ, 8.6

ブレッドクラム, 8.3

ブレッドクラム, 1.6

ドロップダウン・メニュー, 1.6

アイコン, 1.6

リスト, 8.2

親タブ, 8.1

標準タブ, 8.1

タブ, 8.1

ツリー, 8.4

ナビゲーション・バー, 8.5

「ナビゲーション・バー・エントリの順序変更」アイコン, 8.5.5

ナビゲーション・バー・エントリ, 8.5

概要, 8.5.1

作成, 8.5.2

編集, 8.5.3

複数を編集, 8.5.4

レポート, 8.5.6

ナビゲーション・バー・エントリの履歴, 8.5.6.2 ナビゲーション・バー・エントリ・レポート

履歴, 8.5.6.2

サブスクリプション, 8.5.6.1

ナビゲーション・バー・エントリのサブスクリプション, 8.5.6.1 新しいコンポーネント・ウィザード, 6.2.4, 7.10.2.3

O

オンライン・ヘルプ

Oracle Database 11gリリース2での索引付けの有効化, 13.1.9

フィールド・レベル, 1.7

オンライン・ヘルプ・システム, 1.7

ページ・ヘルプ, 1.7

問題, 13.1.8

検索, 1.7

Oracle Application Express

概要, 1.1

アーキテクチャ, 1.2

ブラウザ要件, 1.4.1

環境の構成, 1.4.2

機能のリスト, 1.1

ログイン, 1.4

開発者としてログイン, 1.4.3

ユーザー・ロール, 1.3

Oracle Application Express管理者, 1.3 Oracle Application Expressエンジン, 1.2 Oracle Application Server Single Sign-On, 13.4.4.6.1

事前構成された認証スキーム

Oracle Application Server Single Sign-On, 13.4.4.6.1

Oracle BI Publisher

統合, 13.1.4

Oracle HTTP Server

セキュリティについて, 13.1.2

イメージ、CSSおよびスクリプト・ファイルの場所, 14.5.11.1

Oracle XML DB HTTP Server

HTTP Serverポートの検証, 1.4.3.2.1

P

パッケージ・アプリケーション

概要, 14.4.1

サポートするオブジェクト・ページの概要, 14.4.2.2

アクセス制御リストの追加, 14.4.4

CSSインストール・スクリプトの追加, 14.4.3

イメージのインストール・スクリプトの追加, 14.4.3

静的ファイルのインストール・スクリプトの追加, 14.4.3

ビルド・オプション, 14.4.2.2.1

サポートするオブジェクトの作成, 14.4.2

アップグレード・スクリプトの定義, 14.4.7.1

削除スクリプト, 14.4.2.2.4

削除, 14.4.8

インストール・オプションの削除, 14.4.6

メッセージの削除, 14.4.6

サポートするオブジェクトのスクリプトの削除, 14.4.6

作成方法, 14.4

インストール・スクリプト, 14.4.2.2.1

サポートするオブジェクトのインストール, 14.4.5

メッセージ, 14.4.2.2.2

前提条件, 14.4.2.2.1

置換文字列, 14.4.2.2.1

インストール・スクリプトのテスト, 14.4.5

アップグレード・スクリプト, 14.4.2.2.3

パッケージ・アプリケーションのアップグレード, 14.4.7.2

検証, 14.4.2.2.1

インストール・サマリーの表示, 14.4.9

パッケージ

検索, 7.9.6

ページ

作成, 6.2.1

アプリケーションのホームからの作成, 6.2.2

「ページ定義」からの作成, 6.2.3

管理, 6.2

ページ属性, 5.3.4.1

概要, 5.4

アクセス, 5.4.1

認証, 5.4.2.6, 5.4.2.6

認可スキーム, 5.4.2.6

キャッシュ, 5.4.2.8

ユーザー別のキャッシュ, 5.4.2.8

キャッシュ・ページ, 5.4.2.8

キャッシュ・ページ条件, 5.4.2.8

キャッシュ・タイムアウト, 5.4.2.8

コメント, 5.4.2.12

構成, 5.4.2.9

カーソル・フォーカス, 5.4.2.2, 5.4.2.2

表示属性, 5.4.2.2

重複する送信, 5.4.2.7

式1, 5.4.2.8, 5.4.2.8

フッター, 5.4.2.3

グループ, 5.4.2.1

ヘッダー・テキスト, 5.4.2.3

ヘルプ, 5.4.2.11

HTMLボディ属性, 5.4.2.5

HTMLヘッダー, 5.4.2.4

名前, 5.4.2.1

エラー・テキスト, 5.4.2.10

ページの別名, 5.4.2.1

ページ・テンプレート, 5.4.2.2

セキュリティ, 5.4.2.6

標準タブ・セット, 5.4.2.2

タイトル, 5.4.2.2.

ページ・コンポーネント

アクセス制御, 7.10.4

すべてを編集, 5.3.1

ページ計算

計算ポイント, 5.3.7.2

作成, 5.3.7.1

計算ポイントの定義, 5.3.7.3.1

計算ソースの定義, 5.3.7.3.1

属性の編集, 5.3.7.3

計算を条件付きにする, 5.3.7.3.2

構文, 5.3.7.2

ページ・コントロール

すべてを編集, 5.3.1

ページ定義

概要, 3.1

アクション・バー, 5.1.2.2

他の表示, 5.2.1

「コピー」ボタン, 5.1.2.1

「コピー」アイコン, 5.3.2

「作成」ボタン, 5.1.2.1

「作成」アイコン, 5.3.2

ページの作成, 6.2.3

新規コントロールおよびコンポーネントの作成, 5.3.2

「削除」ボタン, 5.1.2.1

編集, 5.3

すべてを編集, 5.3.1

エクスポート, 5.2.5

「次へ」ボタン, 5.1.2.1

「ページ」フィールド, 5.1.2.1

ページ・プロセス, 5.3.5

ページ・レンダリング, 5.3.4

「前へ」ボタン, 5.1.2.1

コンポーネントの順序変更, 5.3.3

「ビュー」リスト, 5.1.2.1, 5.2

表示, 5.1

ページ・イベント

「次へ」ボタン, 5.2.2

「ページ」フィールド, 5.2.2

「前へ」ボタン, 5.2.2

すべての表示, 5.2.2, 5.2.2

使用済の表示, 5.2.2

「ビュー」リスト, 5.2.2

ページ・ファインダ, 7.9, 7.9.3 ページ・グループ

ページの割当て, 6.2.7.3

作成, 6.2.7.2

グループ定義の編集, 6.2.7.2.1

管理, 4.3

「ページ・グループごとのページ」レポート, 6.2.7.6

ページの再割当て, 6.2.7.3.1

削除, 6.2.7.5

ページの削除, 6.2.7.4

表示, 5.2.6, 6.2.7.1

ページ・ヘルプ

作成, 7.13

ページ・アイテム

概要, 6.7.1

作成, 6.7, 6.7.3

「ページ定義」からの作成, 6.7.3.1

複数の削除, 6.7.4.2.4

ドラッグ・アンド・ドロップ・レイアウト・ページ, 6.7.5

属性の編集, 6.7.4.1

ページの表示の編集, 6.7.4.2.1

「ヘルプ」の編集, 6.7.4.2.2

複数を編集, 6.7.4.2

ネーミング規則, 6.7.3.2

リージョンへの再割当て, 6.7.4.2.3

静的LOV, 6.7.3.6

タイプ, 6.7.3.3

「ドラッグ・アンド・ドロップ」アイコンの使用, 6.7.2.1

「リージョン・アイテムの順序変更」アイコンの使用, 6.7.4.3

ページ・アイテム

概要, 6.7.2

ページ・レイアウト

概要, 9.1

ページ・ロック

管理, 4.3

ページ番号, 5.3 ページ・プロセス

プロセス・ポイントの変更, 5.3.9.2.1

ソースの変更, 5.3.9.2.1

作成, 5.3.4.6, 5.3.9.1

属性の編集, 5.3.9.2

条件付きの作成, 5.3.9.2.2

「対象ボタン」属性, 3.6.2.20.3

ページ・プロセス, 3.2.1

理解, 3.2

ページ・プロセス

概要, 5.3.5

ブランチ, 5.3.5.4

計算, 5.3.5.1

プロセス, 5.3.5.3

検証, 5.3.5.2

ページ・レンダリング, 3.2.1

理解, 3.2

ページ・レンダリング

概要, 5.3.4

ボタン, 5.3.4.3, 7.5.1

計算, 5.3.4.5

アイテム, 5.3.4.4, 6.7.2

ページ, 5.3.4.1

プロセス

概要, 5.3.4.6

リージョン, 5.3.4.2, 9.3.1 タブ, 8.1.2 ページ・レポート

表示,12.6

ページ・テンプレート

ボディ, 10.2.11.2.3

定義, 10.2.11.2.3

表示ポイント, 10.2.11.2.4

編集, 10.2.11

エラー・ページ・テンプレートの制御, 10.2.11.2.10

フッター, 10.2.11.2.3

ヘッダー, 10.2.11.2.3

イメージ・ベースのタブ属性, 10.2.11.2.8

複数列のリージョン表属性, 10.2.11.2.9

名前, 10.2.11.2.1

親タブ属性, 10.2.11.2.7

デフォルトの指定, 10.2.2.1, 10.2.2.2

標準タブ属性, 10.2.11.2.6

サブスクリプション, 10.2.11.2.2

置換文字列, 10.2.11

サブテンプレート, 10.2.11.2.5

ページ・テンプレート置換文字列, 10.2.11

#APP_VERSION#, 10.2.11.1

#BOX_BODY#, 10.2.11.1

#CUSTOMIZE#, 10.2.11.1

#FORM_CLOSE#, 10.2.11.1

#FORM_OPEN#, 10.2.11.1

#GLOBAL_NOTIFICATION#, 10.2.11.1

#HEAD#, 10.2.11.1

#LOGO#, 10.2.11.1

#NAVIGATION_BAR#, 10.2.11.1

#NOTIFICATION_MESSAGE#, 10.2.11.1

#ONLOAD#, 10.2.11.1

#PARENT_TAB_CELLS#, 10.2.11.1

#REGION_POSITION_NN#, 10.2.11.1

#SUCCESS_MESSAGE#, 10.2.11.1

#TAB_CELLS#, 10.2.11.1

#TITLE#, 10.2.11.1

ページ・ビュー

参照コンポーネント, 5.2.7

ページ・ビュー

他の表示へのアクセス, 5.2.1

データベース・オブジェクトの依存性, 5.2.3

グループ, 5.2.6

履歴, 5.2.4

ページ・イベント, 5.2.2

ページ・ゼロ, 9.1, 9.2 ページ・レベル・アイテム

履歴, 6.7.4.2.5

ページ・レベル・テンプレート, 10.2.2.2 ページ

概要, 3.1

ページ・ゼロについて, 9.2

追加, 6.2

グループへの割当て, 6.2.7.3

キャッシュ, 5.4.2.8

ボタンからのコール, 3.4.4

別名を使用したコール, 3.4.3

アクセス制御, 7.10.4

コピー, 6.2.5

アプリケーションのホームからの作成, 6.2.2

「開発者」ツールバーからの作成, 6.2.4

グループの作成, 6.2.7.2

削除, 6.2.9

ロック・ステータスの判別, 6.2.8.1

重複送信, 5.4.2.7

ユーザーによるカスタマイズの有効化, 9.3.3.4

エクスポート, 14.5.4

グループ化, 6.2.7

f?p構文を使用したリンク, 3.4.2

ロック, 6.2.8, 6.2.8.2

印刷用の最適化, 7.12

競合の回避, 6.2.8

グループへの再割当て, 6.2.7.3.1

グループからの削除, 6.2.7.4

リソース使用, 12.5

実行, 6.2.6

検索, 7.9.3

ページ・テンプレートの指定, 10.2.2.2

タイプ, 6.2.3.1

ロック解除, 6.2.8, 6.2.8.3

ページ区切りの挿入

クラシック・レポート, 7.1.4.3

対話モード・レポート, 7.1.3.4

レポート, 10.2.14.3.5, 10.2.14.3.5

ページ区切りサブテンプレート

次のページ・テンプレート, 10.2.14.3.6

次のセット・テンプレート, 10.2.14.3.6

ページ区切りテンプレート, 10.2.14.3.6

前のページ・テンプレート, 10.2.14.3.6

前のセット・テンプレート, 10.2.14.3.6

親タブ

作成, 8.1

「解析対象スキーマ」属性, 4.4.1.2.1 パスワード

変更, 1.4.3.4

リセット, 1.4.3.4

パスワードの複雑性, 13.1.5 パスワード

ベスト・プラクティス, 13.2.1

問題の識別, 13.2.2

パッチ

作成, 14.5.3

PDFの印刷

問題, 13.1.8

パフォーマンス・チューニング, 12.1 PL/SQL

バックグラウンドでの実行, 15.6

PL/SQLコード

検索, 7.9.6

PL/SQLファインダ, 7.9 ポップアップLOV, 6.7.3.3 ポップアップLOVテンプレート

アプリケーション, 10.2.12.1.1

ボタン, 10.2.12.1.5

編集, 10.2.12

アイコン, 10.2.12.1.3

ページ属性, 10.2.12.1.9

ページ区切り, 10.2.12.1.7

結果セット, 10.2.12.1.8

検索フィールド, 10.2.12.1.4

サブスクリプション, 10.2.12.1.2

ウィンドウ, 10.2.12.1.6

事前構成された認証スキーム, 13.4.4

Oracle Application Server Single Sign-On, 13.4.4.6.1

プライマリ・ナビゲーション, 1.6 「出力モード・ページ・テンプレート」属性, 4.4.1.2.8 印刷用モード, 2.3.7 印刷用テンプレート, 7.12 印刷

レポート, 7.1.5

プロシージャ・ファインダ, 7.9.6 プロシージャ

検索, 7.9.6

プロセス

キャッシュ管理, 5.3.9.1

データ操作, 5.3.9.1

フォーム・ページ区切り, 5.3.9.1

バックグラウンドPL/SQLの実装, 15.6.3

オンデマンド, 5.3.9.1

PL/SQL, 5.3.9.1

レポート・ページ区切り, 5.3.9.1

Webサービス, 5.3.9.1

プログラミング手法

コレクション, 15.4

データベース・リンク, 15.2

Webサービスの実装, 15.7

バックグラウンドPL/SQLの実行, 15.6

プロキシ・サーバー

定義, 15.7.1.2

「プロキシ・サーバー」属性, 4.4.1.2.1 「パブリック・ユーザー」属性, 4.4.2.2.1 プルダウン・メニュー, 1.6

Q

問合せ

検索, 7.9.4

問合せファインダ, 7.9, 7.9.4

R

ラジオ・グループ, 6.7.3.3

参照コンポーネント

「次へ」ボタン, 5.2.7

「ページ」フィールド, 5.2.7

「前へ」ボタン, 5.2.7

「ビュー」リスト, 5.2.7

リージョン

概要, 5.3.4.2, 9.3.1

タイプについて, 9.3.5

URLに基づく, 9.6

位置の制御, 9.3.3.2.1

コピー, 9.3.6

作成, 9.3.4

カスタマイズ, 9.3

条件付きの表示, 9.3.3.2

属性の編集, 9.3.3.1

カスタマイズの有効化, 9.3.3.4

ヘッダーとフッターの指定, 9.3.3.3

「リージョンの順序変更」アイコンの使用, 9.3.2

リージョン属性

キャッシュ, 9.3.3.5

列, 9.3.3.2

「条件タイプ」, 9.3.3.2

カスタマイズ, 9.3.3.2

表示ポイント, 9.3.3.2

式, 9.3.3.2

リージョン・フッター, 9.3.3.2

リージョン・ヘッダー, 9.3.3.2

リージョンHTML表のセル属性, 9.3.3.2

順序, 9.3.3.2

静的ID, 9.3.3.6

テンプレート, 9.3.3.2

リージョン・テンプレート

コメント, 10.2.13.1.5

定義, 10.2.13.1.3

編集, 10.2.13

フォーム表属性, 10.2.13.1.4

名前, 10.2.13.1.1

サブスクリプション, 10.2.13.1.2

置換文字列, 10.2.13.1.6

リージョン・タイプ

カレンダ, 9.3.5, 9.3.5

チャート, 9.3.5

フォーム, 9.3.5

ヘルプ・テキスト, 9.3.5

HTML, 9.3.5

リスト, 9.3.5, 9.3.5, 9.3.5

PL/SQL動的コンテンツ, 9.3.5

レポート, 9.3.5

ツリー, 9.3.5

URL, 9.3.5

「並替え」アイコン, 5.3.3 レポート列テンプレート

セル・ヘッダーのカラー化, 10.2.14.2.4

ヘッダーの省略, 10.2.14.2.4

レポート列テンプレート(汎用)

行の後, 10.2.14.2.8

各行の前, 10.2.14.2.5, 10.2.14.2.7

行の前, 10.2.14.2.3

列ヘッダー, 10.2.14.2.4

列テンプレート, 10.2.14.2.6

HTMLをすべての列の後に表示, 10.2.14.2.7

HTMLを最後の行の後に表示, 10.2.14.2.8

次のページ・テンプレート, 10.2.14.2.10

次のセット・テンプレート, 10.2.14.2.10

ページ区切りのサブテンプレート, 10.2.14.2.10, 10.2.14.2.10

前のページ・テンプレート, 10.2.14.2.10

前のセット・テンプレート, 10.2.14.2.10

レポート・テンプレート, 10.2.14.2.1

行選択, 10.2.14.2.9

テンプレートのサブスクリプション, 10.2.14.2.2

レポート列テンプレート(名前付き)

行の前属性, 10.2.14.3.5

列ヘッダー・セルのカラー化, 10.2.14.3.4

列ヘッダー, 10.2.14.3.4

ページ区切りのサブテンプレート, 10.2.14.3.6

レポート・テンプレートの指定, 10.2.14.3.1

行テンプレート, 10.2.14.3.3

サブスクリプション, 10.2.14.3.2

レポート・レイアウト

概要, 7.1.5.5

コピー, 7.1.5.5.4

作成, 7.1.5.5.2

編集, 7.1.5.5.3

オプション, 7.1.5.5.1

レポート出力

問題, 13.1.8

レポート問合せ

概要, 7.1.5.4

コピー, 7.1.5.4.3

作成, 7.1.5.4.1

編集, 7.1.5.4.2

レポート・リージョン

出力, 7.1.5

レポート・リージョン

構成オプションの概要, 7.1.5.2

PDFへの出力, 7.1.5.1

レポート・テンプレート, 10.2.14

編集, 10.2.14

汎用列テンプレート, 10.2.14.1.1

名前付き列テンプレート, 10.2.14.1.2

JavaScriptの使用, 10.2.14.4

レポート, 10.2.4

概要, 7.1

アプリケーションの概要, 6.6

アプリケーション・ビルダー, 6.6

アイテム・ヘルプをバルク編集, 7.13.2.3

クラス参照, 10.1.11.4

ユーザー・インタフェースのデフォルトの比較, 11.3

列リンクの作成, 7.1.4.8

ウィザードを使用した作成, 7.1.1

CSVのエクスポート, 10.2.14.2.5

CSV形式へのエクスポート, 10.2.14.2.3, 10.2.14.3.5

ページ区切りを上に追加, 10.2.14.2.3, 10.2.14.3.5

出力, 7.1.5

列のソート, 7.1.4.4

SQL, 7.1.1

サポートされる置換文字列, 10.1.11.5

テンプレート・サブスクリプション, 10.2.4

テンプレートの使用状況, 10.2.4

テーマのテンプレート, 10.1.11.1

テーマ・ファイル参照, 10.1.11.3

テーマ・テンプレート数, 10.1.11.2

テーマ, 10.1.11

ウィザード・レポート, 7.1.1

REQUEST

ボタン名, 7.5.5

値の参照, 3.6.2.20

置換文字列, 3.6.2.20

リソース使用

監視, 12.5

アクセス制限

アプリケーション, 4.4.1.2.2

「アプリケーションの実行」アイコン, 4.3 「ページの実行」アイコン, 4.3.1.1, 5.1.2.2.1 ランタイム環境, 1.2

S

Sample Application, 2.1, 6.1.4.1

概要, 2.3, 2.3

スクリプト・ファイル

エクスポート, 14.5.8

SDLC, 14.1

高速アプリケーション開発, 14.1.1

スパイラル, 14.1.1

ウォーターフォール, 14.1

セカンダリ・ナビゲーション, 1.6 Secure Socket Layer

ベスト・プラクティス, 13.1.3

セキュリティ

属性, 4.4.2

ページ用, 5.4.2.6

セキュリティ属性

認証, 4.4.2.2.1

認証スキーム, 4.4.2.2.1

認可スキーム, 4.4.2.2.2

データベース・スキーマ, 4.4.2.2.3, 4.4.2.2.4

ホーム・リンク, 4.4.2.2.1

ログインURL, 4.4.2.2.1

パブリック・ユーザー, 4.4.2.2.1

セッション・ステート保護, 4.4.2.2.5

セキュリティに関するベスト・プラクティス

管理者のタスク, 13.1

問題を引き起こす可能性のあるパスワード, 13.2.2

クロスサイト・スクリプティング保護, 13.2.4

埋込みPL/SQLゲートウェイ, 13.1.1

オンライン・ヘルプの索引付けの有効化, 13.1.9

ネットワーク・サービスの有効化, 13.1.8

タイプ・パスワードのアイテム, 13.2.1

Oracle BI Publisher, 13.1.4

Oracle HTTP Server, 13.1.2

パスワードの複雑性, 13.1.5

ランタイム環境, 13.1.6

Secure Sockets Layer, 13.1.3

セッション・ステート, 13.2.5

セッション・タイムアウト, 13.1.7

セッションIDのゼロ, 13.2.3

セキュリティ・リスク

ファイル・アップロード表, 13.3

シード, 16.3.2 選択リスト, 6.7.3.3

依存LOVの作成, 7.7

セッション

ID, 3.3.2

セッションID

ブックマークの容易化, 3.4.5

セッション・ステート

クリア, 3.5.3

アプリケーション・キャッシュのクリア, 3.5.3.3

アイテムごとのキャッシュのクリア, 3.5.3.1

ページごとのキャッシュのクリア, 3.5.3.2

カレント・ユーザー・セッションのキャッシュのクリア, 3.5.3.4

2ページごとのキャッシュのクリア, 3.5.3.2.1

保護の有効化, 4.4.2.2.5

管理, 3.3

アイテム値の引渡し, 3.5.3.2.2

保護, 13.2.6

参照, 3.5.1

セキュリティに関するベスト・プラクティス, 13.2.5

設定, 3.5.2

表示, 3.3.3

セッション・ステート保護

すべての属性の構成, 13.2.6.3.2

セキュリティ属性の構成, 13.2.6.3

無効化, 13.2.6.2

有効化, 13.2.6.2

「セキュリティ属性の編集」からの有効化, 13.2.6.2.1

「セッション・ステート保護」からの有効化, 13.2.6.2.3

ウィザードを使用した有効化, 13.2.6.2.3

レポート, 13.2.6.3.1

理解, 13.2.6.1

既存の設定の表示, 13.2.6.3.1

サマリーの表示, 13.2.6.3.1

「セッション・ステート保護」属性, 4.4.2.2.5 セッション・ステートの値

管理, 3.5

セッション・タイムアウト

理解, 13.1.7

共有コンポーネント

概要, 5.3.6, 5.6.2

アクセス, 5.6.1

レポートへのアクセス, 5.6.4

バックアップ, 14.5.3

ブレッドクラム, 5.3.6.3

作成, 5.6.1

エクスポート, 5.6.3, 14.5.3

アイコン, 4.3

値リスト, 5.3.6.2

リスト, 5.3.6.4

LOV, 5.3.6.2

ナビゲーション・バー, 5.3.6.8

セキュリティ, 5.3.6.7

共有コンポーネント・ページ, 5.6

タブ, 5.3.6.1

テンプレート, 5.3.6.6

テーマ, 5.3.6.5

「共有コンポーネント」アイコン, 4.3.1.3, 5.1.2.2.2 共有コンポーネント・ページ

アプリケーションの計算, 5.6.2.2.3

アプリケーション・アイテム, 5.6.2.2.1, 5.6.2.2.4

アプリケーション・プロセス, 5.6.2.2.2, 5.7

認証スキーム, 5.6.2.3.1

認可スキーム, 5.6.2.3.2

ブレッドクラム, 5.6.2.5.3

ビルド・オプション, 5.6.2.2.5

カスケード・スタイルシート, 5.6.2.8.1

コメント, 5.6.2.1.2

定義, 5.6.2.1.1

属性の編集, 5.6.2.4.3

セキュリティ属性の編集, 5.6.2.3.4

イメージ, 5.6.2.8.2

リスト, 5.6.2.5.2

LOV, 5.6.2.6.4

ナビゲーション・バー・エントリ, 5.6.2.5.5

レポート・レイアウト, 5.6.2.7.2

レポート問合せ, 5.6.2.7.1

セッション・ステート保護, 5.6.2.3.3

ショートカット, 5.6.2.6.5

静的ファイル, 5.6.2.8.3

タブ, 5.6.2.5.1

テンプレート, 5.6.2.6.2

テスト・メッセージ, 5.6.2.4.2

テーマ, 5.6.2.6.1

アプリケーションの翻訳, 5.6.2.4.1

ツリー, 5.6.2.5.4

ユーザー・インタフェースのデフォルト値, 5.6.2.6.3

Webサービス参照, 5.6.2.2.4

ショートカット・ページ, 7.8.2.1 ショートカット, 7.8

定義, 7.8.2

属性の編集, 7.8.3

HTMLテキスト, 7.8.1

エスケープされた特殊文字のあるHTMLテキスト, 7.8.1

イメージ, 7.8.1

メッセージ, 7.8.1

JavaScriptにより一重引用符がエスケープされたメッセージ, 7.8.1

PL/SQLファンクション本体, 7.8.1

レポート, 7.8.4

ショートカット履歴, 7.8.4.2

ショートカット・ページ, 7.8.2.1

サブスクライブされたショートカット, 7.8.4.1

翻訳可能なメッセージのサポート, 16.1.4.1

JavaScriptにより一重引用符がエスケープされたテキスト, 7.8.1

タイプ, 7.8.1

ページ表示, 3.2.1 複数選択リスト, 6.7.3.3 SOAP, 15.7 「SQL」レポート, 7.1.1, SQLトレース

有効化, 12.4

標準タブ

作成, 8.1

静的ファイル・リポジトリ, 9.8, 9.8.1 静的ファイル

削除, 9.8.4

ダウンロード, 9.8.3

編集, 9.8.2

エクスポート, 14.5.7, 14.5.7

インポート, 14.6.3

他のインスタンスへのインポート, 14.5.7

管理, 9.8

アップロード, 9.8.1

静的置換文字列, 4.4.1.2.4 「ステータス」属性, 4.4.1.2.2 スタイルシート, 10.2.1 置換文字列

#COLCOUNT#, 10.2.14.2.5

#CSV_LINK#, 10.2.14.2.3, 10.2.14.3.5

#GLOBAL_NOTIFICATION#, 4.4.1.2.3

#HIGHLIGHT_ROW#, 10.2.14.2.5

#IMAGE_PREFIX#, 9.7.2

#ROWNUM#, 10.2.14.2.5

組込みについて, 3.6.2

APP_ALIAS, 3.6.2.1

APP_ID, 3.6.2.2

APP_IMAGES, 3.6.2.3

APP_PAGE_ID, 3.6.2.4

APP_SESSION, 3.6.2.5

APP_UNIQUE_PAGE_ID, 3.6.2.6

APP_USER, 3.6.2.7

Application Expressスキーマ所有者, 3.6.2.15

AUTHENTICATED_URL_PREFIX, 3.6.2.8

BROWSER_LANGUAGE, 3.6.2.9

カレンダ, 7.3.1.1

CURRENT_PARENT_TAB_TEXT, 3.6.2.10

DEBUG, 3.6.2.11

IMAGE_PREFIX, 3.6.2.14

ページ・テンプレート内, 10.2.11

LOGOUT_URL, 3.6.2.17

PRINTER_FRIENDLY, 3.6.2.16

PROXY_SERVER, 3.6.2.18

PUBLIC_URL_PREFIX, 3.6.2.19

サポート対象に関するレポート, 10.1.11.5

REQUEST, 3.6.2.20

SQLERRM, 3.6.2.21

静的, 4.4.1.2.4

サポートされるリージョン・フッター, 9.3.3.3

SYSDATE_YYYYMMDD, 3.6.2.22

理解, 3.6

テンプレート内の使用方法, 3.6.1.1

使用, 3.6.1

WORKSPACE_IMAGES, 3.6.2.23

サポートされるオブジェクト

作成, 14.4.2

削除, 14.4.8

SVGチャート

タイプの概要, 7.4.4.3

既存のページへの追加, 7.4.4.1

新しいページへの追加, 7.4.4.2

CSSクラス, 7.4.4.4

すべてをFlashへ移行, 7.4.5.3.3

Flashへ移行, 7.4.5.3.2

移行制限, 7.4.5.3.1

CSSスタイル・インラインの参照, 7.4.4.6

カスタムCSSの参照, 7.4.4.5

SVGプラグイン, 7.4.1.2

T

タブ

追加, 8.1

作成, 8.1.4, 8.1.5

編集, 8.1.6

複数を編集, 8.1.6.1

管理, 8.1.4

「タブの順序変更」アイコン, 8.1.3

レポート, 8.1.7

テンプレートのサポート, 8.1.1

タブ・レポート

履歴, 8.1.7

使用状況, 8.1.7

表ファインダ, 7.9, 7.9.5 表

ユーザー・インタフェース・デフォルトのエクスポート, 11.4

HTML表の強制クローズ, 6.7.3.3

検索, 7.9.5

タブ

概要, 8.1.2

タブ・ページ, 8.1.4 表形式フォーム

作成, 7.2.2

テンプレートのデフォルト, 4.4.1.2.8 テンプレート編集履歴, 10.2.4 テンプレート

アプリケーションのデフォルト, 4.4.1.2.8

ブレッドクラム, 10.2.6

ボタン, 10.2.7

カレンダ, 10.2.8

デフォルトの変更, 10.1.2

列, 10.2.14.2.6, 10.2.14.4

作成, 10.2.3

カスタマイズ, 10.2

ラベル, 10.2.9

リスト, 10.2.10

管理, 10.2.5

ページ, 10.2.11

ポップアップLOV, 10.2.12

発行, 10.2.5.7

リージョン, 10.2.13

置換, 10.2.5.3

すべて置換, 10.2.5.4

レポート, 10.2.14

ページに対する選択, 10.2.2.2

テーマのデフォルトの選択, 10.2.2.1

サポートされる置換文字列, 10.1.11.5

サブスクライブ解除, 10.2.5.6

特定のページの表示, 10.2.5.2

テンプレート・ページでの表示, 10.2.5.1

リージョン位置の使用状況の表示, 10.2.5.5

レポートの表示, 10.2.4

ウィザードのデフォルト, 4.4.1.2.9

テキスト, 6.7.3.3 テキスト領域, 6.7.3.3 テキスト文字列

翻訳, 16.4, 16.4.1, 16.4.2

テーマ

テーマ・ページ, 10.1.3.1

「テーマ」属性, 4.4.1.2.7 テーマ・レポート

クラス参照, 10.1.11.4

ファイル参照, 10.1.11.3

サポートされる置換文字列, 10.1.11.5

テンプレート数, 10.1.11.2

テーマのテンプレート, 10.1.11.1

テーマ

識別番号(ID)の変更, 10.1.10

コピー, 10.1.6

作成, 10.1.3

デフォルト・テンプレート, 10.1.2

削除, 10.1.7

編集, 10.1.4

エクスポート, 10.1.9, 14.5.9

異なるIDを使用したエクスポート, 10.1.10

インポート, 10.1.9, 14.6.5

管理, 10.1

レポート, 10.1.11

ページ・レベル・テンプレートの選択, 10.2.2.1

切替え, 10.1.5

テーマ・ページ, 10.1.1

テーマ・ページ, 10.1.3.1

ページ定義からのアクセス, 10.1.1

共有コンポーネントからのアクセス, 10.1.1

ツールバー, 5.5 翻訳可能なメッセージ

定義, 16.4.1

翻訳, 16.1

アプリケーション, 16.1

動的, 16.5

動的テキスト文字列, 16.1.4.1

動的な翻訳, 16.1.4.3

手動編集, 16.3.5

エクスポート・オプション, 16.3.2.2.4

テキストのエクスポート, 16.3.2

グローバル・サポート, 16.1

言語の指定, 16.1.1

プライマリ・アプリケーションIDのマッピング, 16.3.1

ターゲット・アプリケーションIDのマッピング, 16.3.1

メッセージ, 16.1.4.1, 16.1.4.2

リージョン・タイトル, 16.1.4.4

ルール, 16.1.2, 16.1.2

シード, 16.3.2

ショートカット, 16.1.4.1, 16.1.4.1

ステップ, 16.3

テンプレート, 16.1.4.5

翻訳可能なコンポーネント, 16.1.4

翻訳ファイル, 16.3.2.2

理解, 16.3

アプリケーション・レンダリングの理解, 16.1.3

XLIFF, 16.3.2.2

XLIFFターゲット要素, 16.3.2.2.3

翻訳ファイル, 16.3.2.2

アップロードおよび公開, 16.3.4

ツリー

作成, 8.4

編集, 8.4.2

レポート, 8.4.3

ツリー・ページ, 8.4.2

ツリー・レポート

「履歴」, 8.4.3

使用状況, 8.4.3

ツリー・ページ, 8.4.2

U

UDDIレジストリ, 15.7.3

url

セッションIDのゼロ, 3.4.5

URL

発行, 14.8

SSL有効, 9.6

構文, 3.4

ユーザー・アイデンティティ

確立, 13.4

検証, 3.2.3

ユーザー・インタフェース

概要, 1.1

制御, 10

ナビゲーション・オプション, 1.6

ユーザー・インタフェースのデフォルト値, 6.1.2.2

列の定義, 11.2

比較, 11.3

エクスポート, 14.5.10

利用, 6.1.2.3

レポート, 11.2.1.2

ユーザー・インタフェースのデフォルト値

インポート, 14.6.6

ユーザー・ロール

開発者, 1.3

V

検証

概要, 5.3.8

エラー・メッセージの定義, 5.3.8.2

条件付きの作成, 5.3.8.3

「対象ボタン」属性, 3.6.2.20.3

「バージョン」属性, 4.4.1.2.1 「ビュー」リスト

デフォルトの構成, 4.2.1

「仮想プライベート・データベース」属性, 4.4.2.2.6

W

Webサービス・プロセス

プロセスの編集, 15.7.10

静的値への入力パラメータのマッピング, 15.7.10

Webサービス参照, 15.7.1

作成, 15.7.3

フォームの作成, 15.7.8

フォームおよびレポートの作成, 15.7.7

手動作成, 15.7.3.3, 15.7.6

プロセスとしての起動, 15.7.9

UDDIレジストリの検索, 15.7.3.1

WSDLの指定, 15.7.3.2

履歴の表示, 15.7.11

Webサービス参照ページ, 15.7.1.1 Webサービス, 15.7

問題, 13.1.8

プロキシ・サーバー・アドレスの指定, 15.7.1.2

SSL有効, 15.7.2

使用, 15.7.1

Webサービス参照ページ, 15.7.1.1

ウィザード・レポート, 7.1.1 ウィザード

ページの作成, 6.2.1

ブランチの作成, 8.6

ブレッドクラムの作成, 8.3.2.2

ボタンの作成, 7.5.2

カレンダの作成, 7.3

チャートの作成, 7.4

リストの作成, 8.2.1

LOVの作成, 7.6.1

新規コンポーネントの作成, 6.2.4, 7.10.2.3

ページ計算の作成, 5.3.7.1, 15.7.9

ページ・プロセスの作成, 5.3.9.1

リージョンの作成, 9.3.4

アプリケーションの作成, 6.1, 6.1.1

ナビゲーション・バー・エントリの作成, 8.5.2

レポートの作成, 7.1.1

検証の作成, 5.3.8.1, 7.2.5.1

ワークスペース

ログイン, 1.4.3.2

ログアウト, 1.4.3.5

リクエスト, 1.4.3.1

ワークスペース管理者, 1.3 ワークスペース・ホームページ

概要, 1.5

リンク・リスト, 1.5

移行, 1.5

「ワークスペース・スキーマ」リスト, 1.5

ワークスペース・テーマ

追加, 10.1.8.1

削除, 10.1.8.2

エクスポート, 10.1.8.4

管理, 10.1.8

変更, 10.1.8.3

WSDLドキュメント, 15.7.1

X

XLIFF, 16.3.2.2

適用, 16.3.4.2

アップロードしたドキュメントの削除, 16.3.4.3

ターゲット要素, 16.3.2.2.3

アップロード, 16.3.4.1

アップロードおよび公開, 16.3.4

オラクル社の法律上の注意点について

コピーライトについて

Copyright © 1994-2013, Oracle and/or its affiliates.All rights reserved.

商標と登録商標について

OracleおよびJavaはOracle Corporationおよびその関連企業の登録商標です。その他の名称は、それぞれの所有者の商標または登録商標です。

Intel、Intel Xeonは、Intel Corporationの商標または登録商標です。すべてのSPARCの商標はライセンスをもとに使用し、SPARC International, Inc.の商標または登録商標です。AMD、Opteron、AMDロゴ、AMD Opteronロゴは、Advanced Micro Devices, Inc.の商標または登録商標です。UNIXは、The Open Groupの登録商標です。

ライセンス制約の保証と結果的に生じる損害の免責

このソフトウェアおよび関連ドキュメントの使用と開示は、ライセンス契約の制約条件に従うものとし、知的財産に関する法律により保護されています。ライセンス契約で明示的に許諾されている場合もしくは法律によって認められている場合を除き、形式、手段に関係なく、いかなる部分も使用、複写、複製、翻訳、放送、修正、ライセンス供与、送信、配布、発表、実行、公開または表示することはできません。このソフトウェアのリバース・エンジニアリング、逆アセンブル、逆コンパイルは互換性のために法律によって規定されている場合を除き、禁止されています。

保証免責

ここに記載された情報は予告なしに変更される場合があります。また、誤りが無いことの保証はいたしかねます。誤りを見つけた場合は、オラクル社までご連絡ください。

制限付権利

このソフトウェアまたは関連ドキュメントを、米国政府機関もしくは米国政府機関に代わってこのソフトウェアまたは関連ドキュメントをライセンスされた者に提供する場合は、次の通知が適用されます。

U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, delivered to U.S. Government end users are "commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations.As such, use, duplication, disclosure, modification, and adaptation of the programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, shall be subject to license terms and license restrictions applicable to the programs.No other rights are granted to the U.S. Government.

危険な用途への使用について

このソフトウェアもしくはハードウェアは様々な情報管理アプリケーションでの一般的な使用のために開発されたものです。このソフトウェアもしくはハードウェアは、危険が伴うアプリケーション（人的傷害を発生させる可能性があるアプリケーションを含む）への用途を目的として開発されていません。このソフトウェアもしくはハードウェアを危険が伴うアプリケーションで使用する際、安全に使用するために、適切な安全装置、バックアップ、冗長性（redundancy）、その他の対策を講じることは使用者の責任となります。このソフトウェアもしくはハードウェアを危険が伴うアプリケーションで使用したことに起因して損害が発生しても、オラクル社およびその関連会社は一切の責任を負いかねます。

第三者のコンテンツ、製品、サービスに対する免責事項

このソフトウェアまたはハードウェア、そしてドキュメントは、第三者のコンテンツ、製品、サービスへのアクセス、あるいはそれらに関する情報を提供することがあります。オラクル社およびその関連会社は、第三者のコンテンツ、製品、サービスに関して一切の責任を負わず、いかなる保証もいたしません。オラクル社およびその関連会社は、第三者のコンテンツ、製品、サービスへのアクセスまたは使用によって損失、費用、あるいは損害が発生しても一切の責任を負いかねます。

ドラフトのアルファ版およびベータ版ドキュメントについて

このドキュメントが試作版の場合:

このドキュメントは試作版であり、デモおよび暫定使用のみを目的としたものです。このソフトウェアを使用するハードウェアに限定するものではありません。オラクル社およびその関連会社は、このドキュメントに関して一切の責任を負わず、いかなる保証もいたしません。また、このドキュメントを使用したことによって損失、費用、あるいは損害が発生しても、一切の責任を負いかねます。