Oracle® Application Express

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

リリース5.0

E64891-02(原本部品番号:E39147-04)

2015年8月

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

E64891-02

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

原本著者: Terri Jennings

原本協力者: Christina Cho、Hilary Farrell、Michael Hichwa、Joel Kallman、Sharon Kennedy、David Peake、Anthony Rayner、Marc Sewtz、Scott Spadafore、John Synders、Jason Straub、Drue Swadener、Patrick Wolf

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

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

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

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 Corporationとの間の契約に別段の定めがある場合を除いて、Oracle Corporationおよびその関連会社は、第三者のコンテンツ、製品、サービスに関して一切の責任を負わず、いかなる保証もいたしません。適用されるお客様とOracle Corporationとの間の契約に定めがある場合を除いて、Oracle Corporationおよびその関連会社は、第三者のコンテンツ、製品、サービスへのアクセスまたは使用によって損失、費用、あるいは損害が発生しても一切の責任を負いかねます。

目次

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

はじめに

- 対象読者

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

- 関連ドキュメント

- 表記規則

このリリースでの変更点

- Oracle Application Expressリリース5.0での変更点

1 クイック・スタート

- 1.1 Oracle Application Expressの理解

- 1.1.1 Oracle Application Expressの概要

- 1.1.2 Oracle Application Expressの仕組み

- 1.1.3 ランタイム環境と完全開発環境の違いについて

- 1.2 Oracle Application Expressへのサインイン

- 1.2.1 ブラウザ要件

- 1.2.2 Application Expressのユーザー・ロールの概要

- 1.2.3 Oracle Application Expressの構成の概要

- 1.2.4 開発者としてのワークスペースへのサインインおよびサインアウト

- 1.3 ワークスペースのホームページの理解

- 1.3.1 ワークスペースのホームページ

- 1.3.2 「トップ・アプリケーション」および「トップ・ユーザー」ダッシュボード

- 1.3.3 ニュースとメッセージ

- 1.3.4 開発者ナビゲーション・ツール

- 1.3.5 「使用可能な更新」リージョン

- 1.3.6 「アクセシビリティ・モード」リージョン

- 1.4 アカウント・プロファイルの編集

- 1.4.1 アカウント・プロファイルおよびプリファレンスの編集

- 1.4.2 パスワードの変更

- 1.5 ユーザー・プリファレンスの編集

- 1.6 Oracle Application Expressドキュメントの使用

- 1.6.1 Oracle Help Centerへのアクセス

- 1.6.2 Oracle Help Centerの検索

- 1.6.3 オンライン・ドキュメントのダウンロード

- 1.6.4 ダウンロードしたドキュメント・ライブラリの検索

- 1.6.5 フィールドレベル・ヘルプの表示

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

- 2.1 Oracle Application Expressアプリケーションの理解

- 2.1.1 Oracle Application Expressアプリケーションとは

- 2.1.2 データベース・アプリケーションとWebシート・アプリケーションの違い

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

- 2.2 アプリケーション・ページの理解

- 2.2.1 アプリケーション・ページの概要

- 2.2.2 ページ・デザイナとコンポーネント・ビューの違いの理解

- 2.2.3 ページ・デザイナでのページの表示

- 2.2.4 コンポーネント・ビューでのページの表示

- 2.2.5 ページ・デザイナからコンポーネント・ビューへの切替え

- 2.2.6 コンポーネント・ビューからページ・デザイナへの切替え

- 2.3 ユーザー・インタフェース設計の管理

- 2.3.1 アプリケーションのユーザー・インタフェースの決定について

- 2.3.2 モバイル・アプリケーション設計について

- 2.3.3 モバイル・デザインとレスポンシブ・デザインの違いの理解

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

- 2.4.1 「アプリケーションの実行」および「ページの実行」ボタン

- 2.4.2 アプリケーションの実行方法にブラウザが及ぼす影響

- 2.4.3 アプリケーション・ビルダーのホームページからのアプリケーションの実行

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

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

- 2.4.6 ページ・デザイナでのページの実行

- 2.4.7 コンポーネント・ビューでのページの実行

- 2.5 ページ・プロセスおよびページ・レンダリングの仕組み

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

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

- 2.5.3 ユーザー・アイデンティティの確認について

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

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

- 2.6.1 セッション・ステートの概要

- 2.6.2 セッションの概要

- 2.6.3 セッションIDについて

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

- 2.7 URL構文の理解

- 2.7.1 アプリケーション・ページURLについて

- 2.7.2 f?p構文を使用したページのリンクについて

- 2.7.3 アプリケーションの別名

- 2.7.4 ページの別名

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

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

- 2.8 ブックマークのサポートの有効化について

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

- 2.9.1 セッション・ステートの参照について

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

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

- 2.9.4 バインド変数構文を使用したセッション・ステートの参照

- 2.10 置換文字列の理解

- 2.10.1 置換文字列の使用について

- 2.10.2 置換文字列での出力のエスケープの制御

- 2.10.3 テンプレート内での置換文字列の使用方法の確認について

- 2.10.4 組込み置換文字列の使用

3 パッケージ・アプリケーションの使用

- 3.1 パッケージ・アプリケーションについて

- 3.2 完全開発環境でのパッケージ・アプリケーションの管理

- 3.2.1 パッケージ・アプリケーション・ギャラリの表示

- 3.2.2 パッケージ・アプリケーション・ダッシュボードの表示

- 3.2.3 パッケージ・アプリケーションのインストール

- 3.2.4 インストールしたパッケージ・アプリケーションの実行

- 3.2.5 インストールしたパッケージ・アプリケーションの削除

- 3.2.6 インストールしたパッケージ・アプリケーションの認証の変更

- 3.2.7 インストールした生産性アプリケーションのロック解除

- 3.2.8 パッケージ・アプリケーションの更新

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

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

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

- 3.3.3 サンプル・データベース・アプリケーションの変更

- 3.4 AnyCo IT部門Webシートの理解

- 3.4.1 AnyCo IT部門のインストールおよび実行

- 3.4.2 Webシート・ナビゲーションについて

- 3.4.3 AnyCo IT部門の理解

- 3.4.4 Webシート・コンテンツの変更

- 3.5 「パッケージ・アプリケーションのみ」ワークスペースの使用

- 3.5.1 「パッケージ・アプリケーションのみ」ワークスペースとは

- 3.5.2 「パッケージ・アプリケーションのみ」ワークスペースのリクエスト

- 3.5.3 「パッケージ・アプリケーションのみ」ワークスペースへのサインイン

- 3.5.4 パッケージ・アプリケーション・ギャラリの使用

- 3.5.5 パッケージ・アプリケーション管理の使用

4 アプリケーション・ビルダーの理解

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

- 4.2 アプリケーション・ビルダーのホームページの使用

- 4.2.1 アプリケーション・ビルダーのホームページのナビゲーション・バー

- 4.2.2 「リセット」および「作成」ボタン

- 4.2.3 アプリケーション・ビルダーのホームの「最近」リスト

- 4.2.4 移行リンク

- 4.3 アプリケーションのホームページへのアクセス

- 4.4 アプリケーションのホームページの使用

- 4.4.1 「アプリケーション・プロパティの編集」ボタン

- 4.4.2 アプリケーションのホームページのアイコン

- 4.4.3 「ページの作成」ボタン

- 4.4.4 アプリケーションのホームページのナビゲーション・バー

- 4.4.5 アプリケーションのホームページのカスタマイズについて

- 4.4.6 アプリケーションのホームページの「タスク」リスト

- 4.4.7 最近編集されたページ

5 チーム開発によるアプリケーション・ライフサイクルの管理

- 5.1 チーム開発へのアクセス

- 5.2 チーム開発のホームページ

- 5.3 タグ・サマリーの利用について

- 5.4 機能の追跡

- 5.4.1 機能レポートの表示

- 5.4.2 機能の作成

- 5.4.3 親機能の作成について

- 5.4.4 機能の更新

- 5.4.5 機能にファイルを添付する方法

- 5.4.6 その他の機能レポートの表示

- 5.5 マイルストンの追跡

- 5.5.1 マイルストン・レポートの表示

- 5.5.2 マイルストンの作成

- 5.5.3 マイルストンの更新

- 5.5.4 その他のマイルストン・レポートの表示

- 5.6 To Doの追跡

- 5.6.1 To Doの表示

- 5.6.2 To Doの作成

- 5.6.3 To Doの更新

- 5.6.4 To Doにファイルを添付する方法

- 5.6.5 その他のTo Doレポートの表示

- 5.7 バグの管理

- 5.7.1 バグの表示

- 5.7.2 バグの作成

- 5.7.3 バグの編集

- 5.7.4 バグにファイルを添付する方法

- 5.7.5 その他のバグ・レポートの表示

- 5.8 フィードバックの管理

- 5.8.1 フィードバックの表示

- 5.8.2 アプリケーションへのフィードバック・ページの追加

- 5.8.3 フィードバックの送信

- 5.8.4 フィードバックの確認

- 5.8.5 その他のフィードバック・レポートの表示

- 5.9 チーム開発ユーティリティの管理

- 5.9.1 チーム開発ユーティリティへのアクセス

- 5.9.2 チーム開発の設定の構成

- 5.9.3 リリース・サマリーの表示

- 5.9.4 機能ユーティリティの管理

- 5.9.5 フォーカス領域の編集

- 5.9.6 添付ファイルの表示

- 5.9.7 データのパージ

- 5.9.8 ニュース・エントリの管理

- 5.9.9 リンクの管理

6 Webシート・アプリケーションの作成

- 6.1 Webシート・アプリケーションについて

- 6.2 Webシート・アプリケーションの作成

- 6.2.1 アプリケーション・ビルダーからのWebシートの作成

- 6.2.2 実行中のWebシートからのWebシート・アプリケーションの作成

- 6.3 既存のWebシート・ページのコピー

- 6.4 Webシートの実行

- 6.4.1 アプリケーション・ビルダー・ホームページからのWebシートの実行

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

- 6.4.3 WebシートURLの決定

- 6.5 ページの詳細の編集

- 6.6 Webシート・アプリケーションの削除

- 6.7 Webシート・ダッシュボードの表示

- 6.8 Webシート・アクティビティの監視

- 6.9 Webシート・プロパティの理解

- 6.9.1 Webシート・プロパティの編集

- 6.9.2 Webシート・プロパティ

- 6.10 Webシート・アクセスの制御

- 6.10.1 Webシート・アクセスの動作

- 6.10.2 アクセス制御リスト・タイプの指定

- 6.10.3 アクセス制御リスト・エントリの作成

7 データベース・アプリケーションの作成

- 7.1 アプリケーションの作成ウィザードの使用

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

- 7.1.2 アプリケーションの作成ウィザードの実行中に使用可能なページ・タイプ

- 7.2 データベース・アプリケーションの作成

- 7.2.1 表、問合せまたはドリルダウン問合せに基づくデータベース・アプリケーションの作成

- 7.2.2 スプレッドシートからのデスクトップ・データベース・アプリケーションの作成

- 7.2.3 データベース・アプリケーションのコピー

- 7.3 モバイル・アプリケーションの作成

- 7.3.1 jQuery Mobileのサポートについて

- 7.3.2 モバイル・アプリケーションの作成

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

- 7.4.1 アプリケーションのホームページからのアプリケーションの削除

- 7.4.2 「アプリケーション定義の編集」ページからのアプリケーションの削除

- 7.5 アプリケーション属性の管理

- 7.5.1 アプリケーション属性の編集

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

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

- 7.5.4 アプリケーションのユーザー・インタフェースの管理

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

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

- 7.6.2 ページの作成ウィザードの実行中に使用可能なページ・タイプ

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

- 7.6.4 ダイアログ・ページの作成

- 7.6.5 ページ・デザイナでのページの管理について

- 7.6.6 コンポーネント・ビューでのページの管理について

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

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

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

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

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

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

- 7.7.3 アイテムの検索

- 7.7.4 ページの検索

- 7.7.5 問合せの検索

- 7.7.6 表の検索

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

- 7.7.8 イメージの検索

- 7.8 ページ・グループの作成

- 7.8.1 ページ・グループの表示

- 7.8.2 ページ・グループの作成

- 7.8.3 ページ・グループ定義の編集

- 7.8.4 ページのページ・グループへの割当て

- 7.8.5 ページ・グループごとのページの表示

- 7.8.6 ページ・グループの削除

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

- 7.9.1 ページがロックされているかどうかの判別

- 7.9.2 ページのロック

- 7.9.3 ページのロック解除

- 7.10 開発者コメントの追加

- 7.10.1 「開発者のコメント」、「バグ」または「To Do」ボタン

- 7.10.2 アプリケーションへの開発者コメントの追加

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

- 7.10.4 開発者コメントの削除

- 7.10.5 共有コンポーネントから開発者コメントへのアクセス

- 7.10.6 開発者コメントのカレンダの表示

- 7.11 データベース・アプリケーション・コメントの追加

- 7.12 アプリケーション・グループの管理

- 7.12.1 データベース・アプリケーション・グループの表示

- 7.12.2 データベース・アプリケーション・グループの作成

- 7.12.3 アプリケーション・グループへのデータベース・アプリケーションの割当て

- 7.12.4 アプリケーション・グループからのデータベース・アプリケーションの削除

- 7.12.5 データベース・アプリケーション・グループの削除

- 7.13 アプリケーション・ユーティリティへのアクセス

- 7.13.1 アプリケーション・ビルダー・ユーティリティの使用

- 7.13.2 ページ固有のユーティリティへのアクセス

- 7.13.3 クロス・ページ・ユーティリティの使用

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

- 7.13.5 対話モード・レポート・ユーティリティの使用

8 ページ・デザイナでのページの管理

- 8.1 ページ・デザイナ・ウィンドウについて

- 8.2 共通のページ・デザイナUI要素の理解

- 8.2.1 ページ・デザイナ・ツールバー

- 8.2.2 ツリー・ペイン

- 8.2.3 中央ペイン

- 8.2.4 グリッド・レイアウト

- 8.2.5 ギャラリ

- 8.2.6 メッセージ

- 8.2.7 ページ検索

- 8.2.8 ヘルプ

- 8.2.9 プロパティ・エディタ

- 8.2.10 コード・エディタ

- 8.3 ページ・デザイナの使用

- 8.3.1 ページ・デザイナでのページの表示

- 8.3.2 プロパティ・エディタへのアクセス

- 8.3.3 ドラッグ・アンド・ドロップによるリージョン、アイテムまたはボタンの追加

- 8.3.4 ギャラリ・コンテキスト・メニューを使用したリージョン、アイテムまたはボタンの追加

- 8.3.5 「レンダリング」ツリーからのリージョン、アイテムまたはボタンの追加

- 8.3.6 レンダリング前ブランチ、計算およびプロセスの作成

- 8.3.7 ページ送信ブランチ、検証、計算およびプロセスの作成

- 8.3.8 ページの検索

- 8.4 ページ・デザイナでのページ属性の編集

- 8.4.1 プロパティ・エディタでのページ属性の表示

- 8.4.2 プロパティ・エディタ - ページ

- 8.4.3 ページ・デザイナを使用したJavaScriptの組込み

- 8.4.4 ページ・デザイナでのセッションの再結合の構成

- 8.4.5 ページ・デザイナでのダイアログ属性の構成

- 8.5 ページ・デザイナでのページの実行

- 8.6 実行時開発者ツールバー

- 8.7 ページ・デザイナでのデータベース・アプリケーション・ページのコピー

- 8.8 ページ・デザイナでのページの削除

- 8.8.1 ページ・デザイナでのページの削除

- 8.8.2 複数のページの削除

- 8.8.3 ページの範囲の削除

9 コンポーネント・ビューでのページの管理

- 9.1 コンポーネント・ビュー・ウィンドウについて

- 9.2 コンポーネント・ビューの共通のUI要素の理解

- 9.2.1 コンポーネント・ビュー・ツールバー

- 9.2.2 ナビゲーション・バー

- 9.3 コンポーネント・ビューの使用

- 9.3.1 コンポーネント・ビューでのページの表示

- 9.3.2 コンポーネント・ビューでのページの編集

- 9.3.3 ページ・レンダリングの理解

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

- 9.3.5 共有コンポーネントの理解

- 9.3.6 ページ制御コンポーネント・ビューの作成

- 9.4 コンポーネント・ビューでのページ属性の編集

- 9.4.1 コンポーネント・ビューでのページ属性の表示

- 9.4.2 コンポーネント・ビューのページ属性

- 9.4.3 コンポーネント・ビューを使用したJavaScriptの組込み

- 9.4.4 コンポーネント・ビューでのセッションの再結合の構成

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

- 9.5 コンポーネント・ビューでのアプリケーションまたはページの実行

- 9.6 実行時開発者ツールバー

- 9.7 コンポーネント・ビューでのデータベース・アプリケーション・ページのコピー

- 9.8 コンポーネント・ビューでのページの削除

- 9.8.1 コンポーネント・ビューでのページの削除

- 9.8.2 ページ属性の編集中にページの削除

- 9.8.3 複数のページの削除

- 9.8.4 ページの範囲の削除

10 レポートの開発

- 10.1 対話モード・レポートとクラシック・レポートの相違点

- 10.1.1 対話モード・レポート

- 10.1.2 クラシック・レポート

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

- 10.2.1 アプリケーションの作成ウィザードのレポート・オプション

- 10.2.2 ページの作成ウィザードのレポート・オプション

- 10.2.3 リージョンの作成ウィザードのレポート・オプション

- 10.2.4 アプリケーションの作成ウィザードを使用したレポートの作成

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

- 10.2.6 ページ・デザイナでのウィザードを使用したレポートの作成

- 10.3 ギャラリからのドラッグ・アンド・ドロップによるレポートの作成

- 10.4 ページ・デザイナでの対話モード・レポートの編集

- 10.4.1 ページ・デザイナでのリージョン属性の編集

- 10.4.2 ページ・デザイナでの列属性の編集

- 10.4.3 ページ・デザイナでの対話モード・レポート属性の編集

- 10.4.4 ページ・デザイナでの対話モード・レポート・ページ区切りの制御

- 10.4.5 対話モード・レポートの検索バーのカスタマイズ

- 10.4.6 ページ・デザイナでの「アクション」メニューのカスタマイズ

- 10.4.7 ページ・デザイナでのリンク列の管理

- 10.4.8 対話モード・レポートでの列リンクの作成

- 10.4.9 対話モード・レポートの条件付き表示

- 10.4.10 対話モード・レポートでのLOVとしての列定義

- 10.4.11 ページ・デザイナでのアイコン・ビューの有効化

- 10.4.12 対話モード・レポートでの列の書式設定

- 10.4.13 ページ・デザイナでの詳細ビューの有効化

- 10.4.14 対話モード・レポートの詳細属性の構成

- 10.4.15 対話モード・レポートへのリンクの設定

- 10.5 コンポーネント・ビューでの対話モード・レポートの編集

- 10.5.1 コンポーネント・ビューでの対話モード・レポート属性の編集

- 10.5.2 コンポーネント・ビューでの列属性の編集

- 10.5.3 列グループの作成

- 10.5.4 コンポーネント・ビューでの対話モード・レポートのページ区切りの制御

- 10.5.5 コンポーネント・ビューでの検索バーおよび「アクション」メニューの管理

- 10.5.6 コンポーネント・ビューでのリンク列の管理

- 10.5.7 対話モード・レポートでの列リンクの作成

- 10.5.8 対話モード・レポートの条件付き表示

- 10.5.9 対話モード・レポートでのLOVとしての列定義

- 10.5.10 対話モード・レポートでの列の書式設定

- 10.5.11 コンポーネント・ビューでのアイコン・ビューの有効化

- 10.5.12 コンポーネント・ビューでの詳細ビューの有効化

- 10.5.13 対話モード・レポートの詳細属性の構成

- 10.5.14 対話モード・レポートへのリンクの設定

- 10.5.15 共有対話モード・レポートへのリンクの設定

- 10.5.16 コンポーネント・ビューでの保存されたデフォルト対話モード・レポートの編集

- 10.5.17 保存された対話モード・レポート・アクティビティの表示

- 10.6 エンド・ユーザーとしての対話モード・レポートのカスタマイズ

- 10.6.1 検索バーについて

- 10.6.2 「アクション」メニューについて

- 10.6.3 対話モード・レポート・フィルタの使用

- 10.6.4 対話モード・レポートの保存

- 10.7 ページ・デザイナでのクラシック・レポートの編集

- 10.7.1 ページ・デザイナでのクラシック・レポート属性の編集

- 10.7.2 ページ・デザイナでのクラシック・レポート・レイアウトの変更

- 10.7.3 ページ・デザイナでのクラッシック・レポートのページ区切りの制御

- 10.7.4 ページ・デザイナでのクラシック・レポートの列ソートの有効化

- 10.7.5 ページ・デザイナでのクラシック・レポートへのダウンロード・リンクの追加

- 10.7.6 ページ・デザイナでのクラシック・レポートのCSV出力オプションの有効化

- 10.7.7 ページ・デザイナでのXMLファイルまたはCSVファイル・エクスポートのサポートの追加

- 10.7.8 ページ・デザイナでのクラシック・レポートの列リンクの作成

- 10.7.9 ページ・デザイナでのクラシック・レポートの更新可能な列の定義

- 10.7.10 ページ・デザイナでのクラシック・レポートのLOVとしての列定義

- 10.7.11 ページ・デザイナでのクラシック・レポートの列の表示条件の制御

- 10.7.12 ページ・デザイナでのクラッシック・レポートの列ブレークの制御

- 10.8 コンポーネント・ビューでのクラシック・レポートの編集

- 10.8.1 コンポーネント・ビューでのクラシック・レポート属性の編集

- 10.8.2 コンポーネント・ビューでのクラシック・レポート・レイアウトの変更

- 10.8.3 コンポーネント・ビューでのクラッシック・レポートのページ区切りの制御

- 10.8.4 コンポーネント・ビューでのクラシック・レポートの列ソートの有効化

- 10.8.5 コンポーネント・ビューでのクラシック・レポートへのダウンロード・リンクの追加

- 10.8.6 コンポーネント・ビューでのクラシック・レポートのCSV出力の有効化

- 10.8.7 XMLファイルまたはCSVファイル・エクスポートのサポートの追加

- 10.8.8 コンポーネント・ビューでのクラシック・レポートの列リンクの作成

- 10.8.9 コンポーネント・ビューでの更新可能な列の定義

- 10.8.10 コンポーネント・ビューでのクラシック・レポートのLOVとしての列定義

- 10.8.11 コンポーネント・ビューでのクラシック・レポートの列の表示条件の制御

- 10.8.12 コンポーネント・ビューでのクラッシック・レポートの列ブレークの制御

- 10.8.13 クラシック・レポートの列の順序とリージョン・ソースの同期

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

- 10.9.1 PDFへのレポート出力について

- 10.9.2 レポート出力の構成オプションについて

- 10.9.3 クラシック・レポートの出力メソッドについて

- 10.9.4 クラシック・レポート・リージョンの出力属性の構成

- 10.9.5 対話モード・レポート・リージョンの出力属性の構成

- 10.9.6 レポート問合せについて

- 10.9.7 レポート・レイアウトについて

- 10.10 フォームおよびレポートでのBLOBサポートの理解

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

- 10.10.2 ダウンロード・リンクの提供について

- 10.10.3 BLOBの表示について

- 10.10.4 手続き的なBLOBの使用について

11 フォームの開発

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

- 11.1.1 ページの作成ウィザードのフォーム・オプション

- 11.1.2 リージョンの作成ウィザードのフォーム・オプション

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

- 11.1.4 アプリケーションの作成ウィザードを使用したフォームの作成

- 11.1.5 ページ・デザイナでのフォームの作成

- 11.2 表形式フォームの管理

- 11.2.1 表形式フォームの作成について

- 11.2.2 表形式フォームの実行について

- 11.2.3 表形式フォームの仕組み

- 11.2.4 アプリケーションの作成ウィザードを使用した表形式フォームの作成

- 11.2.5 ページの作成ウィザードを使用した表形式フォームの作成

- 11.2.6 表形式フォームの列の順序とリージョン・ソースの同期

- 11.3 マスター・ディテール・フォームの管理

- 11.3.1 マスター・ディテール・フォームについて

- 11.3.2 アプリケーションの作成ウィザードを使用したマスター・ディテール・フォームの作成

- 11.3.3 ページの作成ウィザードを使用したマスター・ディテール・フォームの作成

- 11.4 コンポーネント・ビューでのフォームの手動作成

- 11.4.1 コンポーネント・ビューでのフォームの手動作成について

- 11.4.2 フォームの処理

- 11.4.3 コンポーネント・ビューでのフォームの移入

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

- 11.5.1 検証およびエラー・メッセージの作成について

- 11.5.2 ページ・デザイナでの検証と特定のアイテムとの関連付け

- 11.5.3 コンポーネント・ビューでの検証と特定のアイテムとの関連付け

- 11.5.4 エラー・メッセージ表示位置について

- 11.6 フォームでのBLOBサポートの理解

- 11.6.1 フォームでのBLOBサポートについて

- 11.6.2 BLOBへのファイルのアップロードとダウンロードについて

- 11.6.3 BLOBの表示について

- 11.6.4 イメージ参照の削除について

12 データベース・アプリケーション・コンポーネントの管理

- 12.1 カレンダの作成

- 12.1.1 サポートされているカレンダについて

- 12.1.2 サンプル・カレンダ

- 12.1.3 新しいページへのカレンダの追加

- 12.1.4 ページ・デザイナでのカレンダ属性の管理

- 12.1.5 コンポーネント・ビューでのカレンダの管理

- 12.1.6 日付列の書式マスクについて

- 12.1.7 既存のカレンダでのデータのドラッグ・アンド・ドロップの有効化

- 12.1.8 レガシー・カレンダでサポートされているカレンダ置換文字列について

- 12.2 マップの作成

- 12.2.1 マップ・チャートのサポートについて

- 12.2.2 マップのSQL問合せの作成について

- 12.2.3 新しいページへのマップ・チャートの追加

- 12.2.4 ページ・デザイナでのマップ・チャートの管理

- 12.2.5 コンポーネント・ビューでのマップ・チャートの管理

- 12.3 チャートの作成

- 12.3.1 チャート・タイプについて

- 12.3.2 チャートのSQL問合せの作成

- 12.3.3 新しいページへのチャートの追加

- 12.3.4 ページ・デザイナでのチャートの管理

- 12.3.5 コンポーネント・ビューでのチャートの管理

- 12.3.6 SVGチャートのサポートの理解

- 12.3.7 HTMLチャートのサポートの理解

- 12.3.8 Flashチャートの保存について

- 12.3.9 FlashおよびHTML5チャートとのカスタムXMLの使用

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

- 12.4.1 ページ・デザイナでのヘルプの作成

- 12.4.2 コンポーネント・ビューでのヘルプの作成

- 12.4.3 複数のアイテム・ヘルプ・トピックの同時編集

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

13 テーマおよびテーマ・スタイルの使用

- 13.1 テーマの使用

- 13.1.1 テーマについて

- 13.1.2 レスポンシブ・デザインについて

- 13.1.3 グリッドベース・テーマについて

- 13.1.4 テーマ・スタイルの使用

- 13.1.5 テンプレート・オプションの理解

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

- 13.1.7 テーマの編集

- 13.2 テーマおよびサブスクリプションの管理

- 13.2.1 テーマのサブスクリプションの理解

- 13.2.2 テーマの作成

- 13.2.3 テーマの切替え

- 13.2.4 テーマ識別番号の変更

- 13.2.5 テーマのコピー

- 13.2.6 テーマの削除

- 13.2.7 マスター・テーマ・アプリケーションの作成

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

- 13.2.9 インスタンス・テーマの管理

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

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

- 13.3 カスタム・テーマの作成

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

- 13.3.2 ページ・テンプレートからのJavaScriptファイルのコールについて

- 13.3.3 置換文字列でのエスケープ構文の使用について

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

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

- 13.3.6 テンプレート・オプションの使用

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

- 13.3.8 テンプレートの管理

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

- 13.3.10 ボタン・テンプレート

- 13.3.11 レガシー・カレンダ・テンプレート

- 13.3.12 ラベル・テンプレート

- 13.3.13 リスト・テンプレート

- 13.3.14 ページ・テンプレート

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

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

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

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

- 13.4.1 カスケード・スタイルシートのアップロードについて

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

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

- 14.1 Oracle Application Expressのページ・レイアウトについて

- 14.2 印刷用ページの最適化

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

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

- 14.3 すべてのページにコンポーネントを表示するグローバル・ページの作成

- 14.3.1 グローバル・ページの作成

- 14.3.2 グローバル・ページへのナビゲート

- 14.4 リージョンについて

- 14.5 ページ・デザイナでのリージョンの管理

- 14.5.1 ページ・デザイナでのリージョンの作成

- 14.5.2 ページ・デザイナでのリージョンの管理

- 14.5.3 ページ・デザイナでのリージョンのコピー

- 14.5.4 ページ・デザイナでのリージョンの削除

- 14.6 コンポーネント・ビューでのリージョンの管理

- 14.6.1 リージョンの作成ウィザード実行時のリージョン・タイプについて

- 14.6.2 コンポーネント・ビューでのリージョンの作成

- 14.6.3 コンポーネント・ビューでのリージョンの管理

- 14.6.4 リージョン表示セレクタの作成

- 14.6.5 コンポーネント・ビューでのリージョンのコピー

- 14.6.6 コンポーネント・ビューでのリージョンの削除

- 14.7 他のWebサイトからのコンテンツの組込みについて

- 14.8 イメージの管理について

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

15 データベース・アプリケーション・コントロールの管理

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

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

- 15.1.2 アイテムのネーミング規則について

- 15.1.3 アイテム値の参照

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

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

- 15.2 ページ・デザイナでのページ・レベル・アイテムの管理

- 15.2.1 ページ・デザイナでのページ・レベル・アイテムの表示

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

- 15.2.3 ページ・デザイナでのページ・レベル・アイテムの編集

- 15.3 コンポーネント・ビューでのページ・レベル・アイテムの管理

- 15.3.1 コンポーネント・ビューでのページ・レベル・アイテムの表示

- 15.3.2 コンポーネント・ビューでのページ・レベル・アイテムの作成

- 15.3.3 コンポーネント・ビューでのページ・レベル・アイテムの編集

- 15.4 動的アクションの管理

- 15.4.1 動的アクションについて

- 15.4.2 プラグインの例の表示

- 15.4.3 動的アクション・イベントについて

- 15.4.4 ページ・デザイナでの動的アクションの管理

- 15.4.5 コンポーネント・ビューでの動的アクションの管理

- 15.4.6 動的アクションを使用したJavaScriptのコールについて

- 15.4.7 動的アクションのデバッグ

- 15.5 ボタンの作成

- 15.5.1 ボタンで実行できる操作

- 15.5.2 ページ・デザイナでのボタンの管理

- 15.5.3 コンポーネント・ビューでのボタンの管理

- 15.5.4 ボタンからのJavaScriptのコールについて

- 15.5.5 ボタン名とREQUESTの関係について

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

- 15.6 ツリーの作成

- 15.6.1 ツリーについて

- 15.6.2 レガシーjsTreeのサポートについて

- 15.6.3 新しいページでのツリーの作成

- 15.6.4 ページ・デザイナでのツリーの管理

- 15.6.5 コンポーネント・ビューでのツリーの管理

- 15.7 アプリケーションへのJavaScriptの組込みについて

16 ナビゲーションの追加

- 16.1 ナビゲーションとしてのリストの作成について

- 16.2 タブの作成

- 16.2.1 タブについて

- 16.2.2 タブ・ページについて

- 16.2.3 タブ・テンプレート・サポートの確認

- 16.2.4 タブの作成

- 16.2.5 タブの編集

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

- 16.3 ブレッドクラムの作成

- 16.3.1 ブレッドクラムとは

- 16.3.2 ページ作成中のブレッドクラムの作成

- 16.3.3 ブレッドクラムの手動作成

- 16.3.4 ブレッドクラムの編集

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

- 16.3.6 未使用のブレッドクラム・エントリの削除

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

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

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

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

- 16.4.3 ナビゲーション・バー・エントリのコピー

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

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

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

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

- 16.5.1 ページ・デザイナでのブランチの作成

- 16.5.2 コンポーネント・ビューでのブランチの作成

- 16.5.3 条件付きブランチ処理について

17 計算、検証およびプロセスの管理

- 17.1 ページ計算の理解

- 17.1.1 ページ計算について

- 17.1.2 ページ・デザイナでのページ計算の管理

- 17.1.3 コンポーネント・ビューでのページ計算の管理

- 17.1.4 計算ポイントおよび計算構文の例

- 17.2 検証の理解

- 17.2.1 検証について

- 17.2.2 ページ・デザイナでの検証の管理

- 17.2.3 コンポーネント・ビューでの検証の管理

- 17.2.4 検証の実行タイミングの決定について

- 17.2.5 検証エラー・メッセージの表示方法の定義について

- 17.2.6 検証の条件付き実行

- 17.2.7 「エラーに移動」リンクの変更について

- 17.2.8 検証が失敗した場合の処理

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

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

- 17.3.2 ページ・デザイナでのページ・プロセスの管理

- 17.3.3 コンポーネント・ビューでのページ・プロセスの管理

- 17.4 ブランチについて

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

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

- 17.5.2 新しいインスタンス開始時に実行されるアプリケーション・プロセスについて

- 17.5.3 ページ・リクエストからのオンデマンド・プロセスの実行について

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

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

- 17.5.6 アプリケーション・プロセス属性の編集

- 17.5.7 アプリケーション・プロセスのエラー・メッセージの作成

- 17.5.8 「アプリケーション・プロセス履歴」レポートの表示

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

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

- 17.6.2 新しいインスタンス開始時に実行されるアプリケーションの計算について

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

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

- 17.7 属性ディクショナリの使用

- 17.7.1 属性ディクショナリについて

- 17.7.2 「属性ディクショナリの管理」へのアクセス

18 共有コンポーネントの管理

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

- 18.1.1 共有コンポーネントを使用する利点について

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

- 18.1.3 「共有コンポーネント」アイコンについて

- 18.1.4 共有コンポーネント・ページ

- 18.2 コンポーネント設定の管理

- 18.2.1 コンポーネント設定の編集

- 18.2.2 コンポーネント設定の履歴レポートの表示

- 18.3 静的アプリケーション・ファイルの管理

- 18.3.1 静的アプリケーション・ファイルの場所の指定

- 18.3.2 静的アプリケーション・ファイルのアップロード

- 18.3.3 「静的アプリケーション・ファイル」レポートの表示

- 18.3.4 静的アプリケーション・ファイルの参照について

- 18.3.5 静的アプリケーション・ファイルのダウンロード

- 18.3.6 静的アプリケーション・ファイルの削除

- 18.4 静的ワークスペース・ファイルの管理

- 18.4.1 静的ワークスペース・ファイルのアップロード

- 18.4.2 「静的ワークスペース・ファイル」レポートの表示

- 18.4.3 静的ワークスペース・ファイルの参照について

- 18.4.4 静的ワークスペース・ファイルのダウンロード

- 18.4.5 静的ワークスペース・ファイルの削除

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

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

- 18.5.2 アプリケーション・アイテムの使用状況の表示

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

- 18.5.4 グローバル変数として機能するアプリケーション・レベル・アイテムの作成について

- 18.6 アプリケーション・レベルでのLOVの作成

- 18.6.1 値リストとは

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

- 18.6.3 静的LOVについて

- 18.6.4 既存のLOVの編集

- 18.6.5 LOV内でのセッション・ステートの参照について

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

- 18.7 リストの作成

- 18.7.1 リストの作成について

- 18.7.2 ナビゲーション・メニューについて

- 18.7.3 静的リストの作成

- 18.7.4 動的リストの作成

- 18.7.5 リストのコピー

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

- 18.7.7 リスト属性の編集

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

- 18.8 ショートカットの使用

- 18.8.1 ショートカットとは

- 18.8.2 ショートカット・タイプの理解

- 18.8.3 ショートカットの定義と参照

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

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

- 18.9 レポート出力の管理

- 18.9.1 レポート問合せの定義によるレポート・リージョンの印刷

- 18.9.2 レポート・レイアウトを使用したレポート・リージョンまたはレポート問合せのフォーマット

19 アプリケーション機能の拡張

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

- 19.1.1 電子メールの構成について

- 19.1.2 電子メール・プロビジョニングについて

- 19.1.3 メール・キューについて

- 19.1.4 APEX_MAILパッケージについて

- 19.2 プラグインの実装

- 19.2.1 プラグインについて

- 19.2.2 プラグインの例の表示

- 19.2.3 プラグイン・ページへのアクセス

- 19.2.4 プラグインの作成

- 19.2.5 プラグインの編集

- 19.2.6 プラグインへのカスタム属性の追加

- 19.2.7 プラグインに関連付けられたファイルのアップロード

- 19.2.8 プラグインへのイベントの追加

- 19.2.9 プラグインの削除

- 19.2.10 プラグイン・リポジトリの表示

- 19.2.11 プラグイン・ページからのプラグインのインポート

- 19.2.12 プラグイン・ページからのプラグインのエクスポート

- 19.2.13 プラグイン対話モード・レポートのリセット

- 19.2.14 プラグインの使用状況ページの表示

- 19.2.15 プラグイン履歴の表示

- 19.3 jQueryおよびjQuery UIサポートの理解

- 19.3.1 jQueryおよびjQueryUIの更新済JavaScriptライブラリについて

- 19.3.2 使用できるjQuery UI機能について

- 19.3.3 JavaScriptコードでのjQueryライブラリの参照

- 19.4 Oracle Application Expressコンポーネントの手動リフレッシュ

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

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

- 20.1.1 Oracle Application Express管理者のロールについて

- 20.1.2 Oracle Application ExpressでのOracle REST Data Servicesの構成について

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

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

- 20.1.5 インスタンス・セキュリティの管理

- 20.1.6 インスタンス設定の構成

- 20.1.7 ワークスペースの消去設定の構成について

- 20.1.8 ワークスペース管理の理解

- 20.1.9 Oracle BI Publisherとの統合について

- 20.1.10 Application Expressのランタイム環境の利点について

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

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

- 20.2.1 タイプ・パスワードのアイテムについて

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

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

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

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

- 20.2.6 ファイルのアップロードの保護について

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

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

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

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

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

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

- 20.4.1 認証の理解

- 20.4.2 認証スキームの作成

- 20.4.3 事前構成済の認証スキームの理解

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

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

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

- 20.4.7 ログイン・ページの作成

- 20.4.8 認証スキーム・レポートの表示

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

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

- 20.5.2 認可スキームの作成および編集

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

- 20.5.4 認可レポートの表示

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

- 21.1 アプリケーション翻訳およびグローバリゼーション・サポートの理解

- 21.1.1 翻訳プロセスについて

- 21.1.2 言語の指定について

- 21.1.3 データベース・アプリケーションの翻訳ルールについて

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

- 21.1.5 アプリケーション属性を翻訳可能に指定

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

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

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

- 21.3 翻訳プロセスの理解

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

- 21.3.2 ステップ2: 翻訳ファイルへのシードおよびダウンロード

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

- 21.3.4 ステップ4: 翻訳済XLIFFドキュメントのアップロードおよび適用

- 21.3.5 ステップ5: アプリケーションのパブリッシュ

- 21.3.6 翻訳の手動編集

- 21.4 メッセージの翻訳

- 21.4.1 メッセージの翻訳について

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

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

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

- 21.5.1 動的翻訳の定義

- 21.6 サポートされるグローバリゼーション・コードの理解

- 21.6.1 Oracle Application Expressのグローバリゼーション・コード

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

- 22.1 アプリケーション整合性のチェックのためのアドバイザの実行

- 22.1.1 Oracle Application Express Advisorについて

- 22.1.2 アプリケーション全体でのアドバイザの実行

- 22.1.3 単一ページ上でのアドバイザの実行

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

- 22.3 アプリケーションとページのリソース使用の監視について

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

- 22.5 デバッグ・モードの使用

- 22.5.1 デバッグ・モードについて

- 22.5.2 アプリケーションのデバッグ・モードの有効化および無効化

- 22.5.3 デバッグ・モードでのアプリケーションの実行

- 22.5.4 開発モードでのデバッグ・レポートの表示

- 22.5.5 デバッグ・モードにアクセスするためのf?p構文の使用について

- 22.5.6 実行中のアプリケーションからのデバッグ・レポートの表示

- 22.5.7 デバッグ・レポートの表示

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

23 アプリケーション・パフォーマンスの管理

- 23.1 パフォーマンス向上のベスト・プラクティスについて

- 23.2 パフォーマンス問題の特定

- 23.2.1 実行速度の遅いアプリケーションのトラブルシューティングについて

- 23.2.2 パフォーマンス問題の診断

- 23.2.3 問題のあるSQL問合せのデバッグについて

- 23.2.4 速度の遅い問合せへの対処について

- 23.3 ログおよびレポートの使用

- 23.3.1 ログ・ファイルの管理方法

- 23.3.2 「アプリケーション・ダッシュボード」レポートの表示

- 23.3.3 ワークスペース・アクティビティ・レポート

- 23.3.4 インスタンス・アクティビティ・レポート

- 23.4 データベース・レポートの使用について

- 23.5 パフォーマンスに影響するデータベース・パラメータについて

- 23.6 リソース制限について

- 23.7 Webサーバーへの静的ファイルのアップロードについて

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

- 23.8.1 アプリケーションのロギングの有効化

- 23.8.2 APEX_ACTIVITY_LOG

- 23.8.3 APEX_ACTIVITY_LOGのサンプル問合せ

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

- 24.1 推奨環境について

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

- 24.2.1 反復開発と計画開発について

- 24.2.2 プロトタイプ作成の利点について

- 24.2.3 ウォーターフォール

- 24.2.4 スパイラル

- 24.2.5 高速アプリケーション開発

- 24.3 デプロイ・プロセスの理解

- 24.3.1 別のインスタンスへのアプリケーションの移動について

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

- 24.3.3 ワークスペースをコピーするかどうかについて

- 24.3.4 データベースをコピーするかどうかについて

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

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

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

- 24.5 カスタム・パッケージ・アプリケーションの作成方法

- 24.5.1 カスタム・パッケージ・アプリケーションの作成によってデプロイを簡略化する方法

- 24.5.2 カスタム・パッケージ・アプリケーションの作成

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

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

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

- 24.5.6 カスタム・パッケージ・アプリケーションのアップグレード

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

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

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

- 24.6.1 エクスポート・プロセスについて

- 24.6.2 エクスポート・ページについて

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

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

- 24.6.5 ワークスペースのエクスポート

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

- 24.6.7 Webシートのエクスポート

- 24.6.8 静的ファイルのエクスポートについて

- 24.6.9 テーマのエクスポート

- 24.6.10 プラグインのエクスポート

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

- 24.6.12 チーム開発フィードバックのエクスポート

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

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

- 24.7.1 アプリケーション、ページまたはコンポーネントのエクスポートのインポート

- 24.7.2 アプリケーション・グループのインポートについて

- 24.7.3 Webシートのインポート

- 24.7.4 プラグインのインポート

- 24.7.5 テーマのインポート

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

- 24.7.7 チーム開発フィードバックのインポート

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

- 24.8.1 エクスポート・ファイルのインストールについて

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

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

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

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

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

- 24.8.7 SQL*Plusを使用したエクスポート・ファイルのインストール

- 24.9 データベース・アプリケーションURLの公開について

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

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

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

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

- 24.11.3 ビルド・オプションの選択

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

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

25 アプリケーション・データの管理

- 25.1 データ・ロード機能によるアプリケーションの作成

- 25.1.1 データ・ロード・ウィザードの作成について

- 25.1.2 データ・ロード・ウィザードの作成

- 25.1.3 データ・ロード・ページの再作成

- 25.1.4 データ・ロード定義の編集

- 25.2 コレクションの使用について

- 25.3 Webサービスの実装

- 25.3.1 Webサービスについて

- 25.3.2 Oracle Application ExpressのWebサービス参照の作成

- 25.3.3 SSL有効Webサービスでの作業について

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

- 25.3.5 Webサービス参照の手動作成

- 25.3.6 RESTful Webサービス参照の作成

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

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

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

- 25.3.10 Webサービスをプロセスとして起動する方法

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

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

- 25.3.13 RESTful Webサービスとしてのレポート・リージョンの公開

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

- 25.4.1 データベース・リンクについて

- 25.4.2 データベース・リンクの作成

- 25.4.3 既存のデータベース・リンクの表示

- 25.5 DMLロックについて

- 25.5.1 DMLロックについて

- 25.5.2 APEX_DML_LOCK_WAIT_TIME

- 25.5.3 FSP_DML_LOCK_ROW

A アイテム・タイプについて

- A.1 使用可能なアイテム・タイプ

B Oracle Application Expressの制限事項

- B.1 コンポーネントの制限事項

C 使用可能な条件

- C.1 条件について

- C.2 アプリケーション・ビルダーで使用可能な条件

D 付与された権限について

- D.1 データベース・ユーザーへの権限の付与について

- D.2 PUBLICに付与される権限の理解

- D.2.1 パッケージ

- D.2.2 プロシージャ

- D.2.3 ファンクション

- D.2.4 表

- D.2.5 ビュー

- D.2.6 順序

- D.2.7 タイプ

E Oracle Application Expressのアクセシビリティ

- E.1 スクリーン・リーダー・モードの理解

- E.1.1 スクリーン・リーダー・モードの有効化

- E.1.2 データベース・アプリケーションでのスクリーン・リーダー・モードの使用

- E.1.3 スクリーン・リーダー・モードの機能

- E.2 ハイ・コントラスト・モードの理解

- E.2.1 Webシート・アプリケーションでのハイ・コントラスト・モードの有効化

- E.2.2 データベース・アプリケーションでのハイ・コントラスト・モードの使用

- E.2.3 ハイ・コントラスト・モードの機能

- E.3 JAWSを使用したフォーム・ページへのアクセス

- E.3.1 ページの構造について

- E.3.2 ヘルプ・テキストへのアクセス

- E.3.3 検証エラーの処理

- E.4 キーボードを使用したOracle Application Expressへのアクセス

- E.4.1 新しい日付ピッカーの使用

- E.4.2 対話モード・レポート・リージョンへのアクセス

- E.4.3 キーボード・ショートカット

索引

はじめに

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

- 対象読者

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

- 関連ドキュメント

- 表記規則

対象読者

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

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

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

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 Application Expressエンド・ユーザー・ガイド』

- 『Oracle Application Express管理ガイド』

- 『Oracle Application Express SQLワークショップ・ガイド』

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

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

- 『Oracle Database概要』

- 『Oracle Database開発ガイド』

- 『Oracle Database管理者ガイド』

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

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

表記規則

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

規則

意味

太字

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

イタリック体

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

固定幅フォント

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

このリリースでの変更点

この章の内容は次のとおりです。

- Oracle Application Expressリリース5.0での変更点

Oracle Application Expressリリース5.0での変更点

Oracle Application Expressリリース5.0の『Oracle Application Expressアプリケーション・ビルダー・ユーザーズ・ガイド』の変更点は次のとおりです。

新機能

このリリースの新機能は次のとおりです。

- ページ・デザイナ
ページ・デザイナは、開発者の生産性を大幅に向上させ、Oracle Application Express内でページを迅速に拡張および保持するように設計された、完全に新しい統合開発環境(IDE)になりました。

- 統合されたユーザー操作性
複数のコンポーネントを変更する際にコンテキスト切替えやドリルダウンは不要です。すべての変更はページ・デザイナ内で行われます。ページを保存する前に、必要に応じて変更を元に戻したりやり直します。

- より優れたビジュアル表現
リージョンおよびアイテムがグリッド・レイアウト内にどのように配置されるかを即座に把握できます。ページ上のコンポーネントに加えられた変更は、ツリーおよびグリッド・レイアウト全体にすぐに反映されます。さらに、エラーと警告は即時に表示されます。

- 直感的なドラッグ・アンド・ドロップ
ページ・デザイナにより、ページを開発するまったく新しい方法が提供されます。「グリッド・レイアウト」ペインで、コンポーネント・ギャラリから新しいコンポーネントをドラッグしたり、既存のコンポーネントを移動およびコピーできます。「ツリー」ペインで、一度に複数のコンポーネントをドラッグして移動およびコピーできます。

- 拡張されたコード・エディタ
新しいコード・エディタには、インライン・エラーによるSQLおよびPL/SQL検証、オートコンプリート、構文のハイライト処理、regexサポートによる検索および置換、元に戻すおよびやり直しのサポートが備わっています。

「アプリケーション・ページの理解」および「ページ・デザイナでのページの管理」を参照してください。

- 新しいデザインおよびユーザー・インタフェースの強化
Oracle Application Expressは、扱いやすさと簡潔性によりユーザー操作性を向上させることに重点が置かれたユーザー・インタフェースを備えています。新しいデザインでは、カラー・パレットやアイコンが新しくなり、メニューとナビゲーションが改善されて、アクセシビリティとキーボード・ショートカットのサポートが向上しており、ページ・レイアウトもより直感的なものになっています。

- ユニバーサル・テーマ
ユニバーサル・テーマは、過剰なテンプレートを排除した、テーマ・ローラー、テンプレート・オプションおよびテーマ・スタイルによって容易なカスタマイズをサポートする新しいアプリケーション・ユーザー・インタフェースです。ユニバーサル・テーマによって、開発者はHTML、CSSまたはJavaScriptの専門知識がなくても、最新で応答性が高く洗練されたアクセスしやすいアプリケーションを構築できます。

ユニバーサル・テーマの詳細は、ユニバーサル・テーマのサンプル・アプリケーションをインストールしてください。「パッケージ・アプリケーションのインストール」を参照してください。

- テーマ・スタイル
ユニバーサル・テーマ - 42やモバイル - 51などの新しいテーマで使用可能です。テーマ・スタイルは、ベースCSSに追加されるCSSです。開発者は、テーマ・ローラー・ユーティリティを使用してアプリケーションの外観を変更できます。

- テーマ・ローラー
多数のスタイル属性を調整し、アプリケーションに適用された変更内容をリアルタイムで確認します。適切な結果が得られたら、変更内容をテーマ・スタイルとしてアプリケーションに直接保存できます。

「テーマ・ローラーの使用」を参照してください。

- テンプレート・オプション
ボタン、リージョン、リスト、およびその他のテンプレートベースのコンポーネントの表示方法を簡単にカスタマイズできます。テンプレート・オプションを使用すると、単一のテンプレートを複数の様々な方法で表示でき、少ないテンプレートを使用してはるかに多用途のアプリケーションを構築できます。

「テンプレート・オプションの理解」を参照してください。

- テーマのサブスクリプション
「テーマのサブスクリプションの理解」を参照してください。

- 対話モード・レポートの強化
複数の対話モード・レポートを単一のページで簡単に作成できます。対話モード・レポートには、データの表示、レポート設定、固定列ヘッダーのサポートのための新しいユーザー・インタフェースが用意されており、以前にも増してアクセシビリティに優れています。

「レポートの開発」を参照してください。

- モーダル・ダイアログ
標準ページ・プロセスを使用する機能を備えたモーダル(および非モーダル)ページを簡単に定義できます。

- ナビゲーションの向上
静的リストおよび動的リストを、アプリケーションのナビゲーション・メニューおよびナビゲーション・バーのベースとして使用できます。ナビゲーション・メニューをページの上部または横に配置したり、リスト・テンプレートに基づいてレンダリングできるため、ネストされたナビゲーション・アイテム、キーボード・サポートおよびより優れたアクセシビリティを実現できます。

「ナビゲーション・メニューについて」を参照してください。

- 新しいカレンダ
カレンダ・コンポーネントには、月、週、日および予定表の各ビューの組込みサポートが備わっており、カスタマイズが非常に簡単です。カレンダは一般的なFullCalendarライブラリに基づいており、ドラッグ・アンド・ドロップ、時間ベースのイベントをサポートし、高い応答性も備えています。

「カレンダの作成」を参照してください。

- モバイル・レポート
リフロー表または列切替えを使用することによって、モバイル・デバイスですべてのデータを表示するレポートを作成します。リフロー表では、非常に小さい画面に複数の行を表示するために、各列がラップされるか変更されます。列切替えでは、最も重要な列を指定し、より小さい画面では必要に応じて非表示にする列を指定できます。

「レポートの開発」を参照してください。

- 静的ファイルのアップロード
共有コンポーネント、プラグインまたはテーマにアップロードされたファイルをブラウザでキャッシュし、相対ファイルURLを使用して参照できます。ZIPファイルをアップロードすることもできます。内容は自動的に抽出され、相対ファイル参照はそのままの状態で保持されます。「静的アプリケーション・ファイルの管理」および「静的アプリケーション・ファイルの管理」を参照してください。

非推奨となったかサポートが終了した機能

『Oracle Application Expressリリース・ノート』の非推奨となった機能およびサポートが終了した機能に関する項を参照してください。

その他の変更

このリリースでの追加変更は次のとおりです。

- すべての内容は、リリース5.0の機能にあわせて更新されました。

- 『Oracle Application Expressアプリケーション・ビルダー・ユーザーズ・ガイド』は、ページ・デザイナとコンポーネント・ビューの両方でページ、コンポーネントおよびコントロールを編集する方法について説明する、新しい編成構造が特徴となっています。
「アプリケーション・ページの理解」、「ページ・デザイナでのページの管理」および「コンポーネント・ビューでのページの管理」を参照してください。

1 クイック・スタート

この項では、Oracle Application Expressの使用およびログイン方法の概要を説明します。この項のトピックは、インストール・プロセスが完了していることを前提としています。

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

- Oracle Application Expressの理解

- Oracle Application Expressの仕組み

- Application Expressのユーザー・ロールの概要

- Oracle Application Expressへのサインイン

- ワークスペースのホームページの理解

- アカウント・プロファイルの編集

- ユーザー・プリファレンスの編集

- Oracle Application Expressドキュメントの使用

1.1 Oracle Application Expressの理解

この項では、Oracle Application Expressについて説明し、ランタイム環境と完全開発環境の違いを示します。

- Oracle Application Expressの概要

- Oracle Application Expressの仕組み

- ランタイム環境と完全開発環境の違いについて

1.1.1 Oracle Application Expressの概要

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

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

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

1.1.2 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としてブラウザに中継されます。このサイクルはページをリクエストまたは送信するたびに発生します。

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

バックグラウンドで、Application Expressエンジンはページをレンダリングおよび処理します。Application Expressエンジンは次のタスクも実行します。

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

- 認証サービス

- 認可サービス

- ページ・フロー制御

- 検証処理

1.1.3 ランタイム環境と完全開発環境の違いについて

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

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

- 完全開発環境。完全開発環境では、ユーザーはApplication Expressアプリケーションを開発、変更、実行および削除できます。この環境では、このドキュメントで説明するアプリケーション・ビルダー環境に完全にアクセスできます。

関連項目:
『Oracle Application Expressインストレーション・ガイド』のOracle Application Expressのランタイム環境に関する項および『Oracle Application Express管理ガイド』のエクスポートされたアプリケーションのランタイム環境へのインストールに関する項

1.2 Oracle Application Expressへのサインイン

注意:
この情報は、Oracle Database Cloud Service (Database Schema)には適用されません。

この項では、Oracle Application Expressにサインインする方法について説明します。サインインの手順に加えて、この項では、ブラウザ要件、使用可能なユーザー・ロールおよび構成オプションについても説明します。

- ブラウザ要件

- Application Expressのユーザー・ロールの概要

- Oracle Application Expressの構成の概要

- 開発者としてのワークスペースへのサインインおよびサインアウト

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

1.2.1 ブラウザ要件

Oracle Application Expressは標準準拠のHTML5、CSS3およびJavaScriptに依存しているため、最適な操作性のために、入手可能な最新のWebブラウザ・ソフトウェアを使用することをお薦めします。詳細は、『Oracle Application Expressインストレーション・ガイド』のブラウザ要件に関する項を参照してください。

1.2.2 Application Expressのユーザー・ロールの概要

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

- エンド・ユーザーには、開発または管理機能へのアクセス権がありません。エンド・ユーザーは、ワークスペースにサインインしてアプリケーションを作成することはできません。エンド・ユーザーは、既存のデータベースまたはWebシート・アプリケーションのみを実行できます。

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

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

- インスタンス管理者は、Application Express管理サービス・アプリケーションを使用して、ホスティングされたインスタンス全体を管理するスーパーユーザーです。インスタンス管理者は、ワークスペース割当ての管理、機能とインスタンス設定の構成およびセキュリティの管理を行います。

ヒント:
インスタンス管理者のロールは、Oracle Database Cloud Service (Database Schema)では使用できません。

関連項目:
『Oracle Application Express管理ガイド』のワークスペースでのユーザーの管理およびApplication Expressインスタンスにわたるユーザーの管理に関する項

1.2.3 Oracle Application Expressの構成の概要

注意:
この情報は、Oracle Database Cloud Service (Database Schema)には適用されません。

Oracle Application Expressの設定方法は、ユーザー・ロールに応じて異なります。ホスティングされた開発環境にアクセスする開発者の場合、管理者によってワークスペースへのアクセス権を付与される必要があります。インスタンス管理者の場合は、Oracle Application Express管理サービス・アプリケーションにサインインし、この項で説明する手順を実行する必要があります。

- Oracle Application Express管理サービスへのサインイン

- 割当てモードの指定

- ワークスペースの作成

- ワークスペースへのサインイン

関連項目:
『Oracle Application Express管理ガイド』のサービス・リクエストの作成、ワークスペースと変更リクエストの管理およびワークスペースの作成に関する項と、「ワークスペースへのサインイン」

1.2.3.1 Oracle Application Express管理サービスへのサインイン

Oracle Application Express管理サービスにサインインするには、次のステップを実行します。

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

- 設定でOracle REST Data Servicesを使用する場合、次に進みます。

http://hostname:port/apex/apex_admin

説明:

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

- portは、Oracle REST Data Servicesの構成時に割り当てられるポート番号です。デフォルトのインストールでは、この番号は8080です。詳細は、『Oracle REST Data Servicesインストレーション、構成および開発ガイド』を参照してください。

- apexは、Oracle REST Data Servicesの構成時に定義されるサービス名です。

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

http://hostname:port/apex/apex_admin

説明:

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

- portは、Oracle XML DB HTTPサーバーに割り当てられているHTTPのポート番号です。デフォルトのインストールでは、この番号は8080です。Oracle Database 12cプラガブル・データベース・アーキテクチャを使用している場合、各PDBは異なるポート番号を持ちます。「Oracle XML DB HTTPサーバーでHTTPに割り当てられたポートの確認」を参照してください。

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

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

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

説明:

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

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

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

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

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

2. 「ユーザー名」に、インスタンス管理者のユーザー名を入力します。

3. 「パスワード」に、インスタンス管理者のアカウント・パスワードを入力します。

ヒント:
adminはデフォルトのインスタンス管理者アカウントです。インストール後のステップとして、管理者はスクリプトapxchpwd.sqlを実行して、1つ以上のインスタンス管理者アカウントを作成したり、それらのアカウントのパスワードを変更できます。詳細は、『Oracle Application Expressインストレーション・ガイド』のWebリスナーのインスタンス管理者アカウントの作成または更新に関する項を参照してください。追加のインスタンス管理者アカウントを作成および管理するには、『Oracle Application Express管理ガイド』の管理サービスでの新規ユーザー・アカウントの作成に関する項も参照してください。

4. 「管理にサインイン」をクリックします。
Oracle Application Express管理サービスが表示されます。

関連項目:
『Oracle Application Express管理ガイド』の新規ユーザー・アカウントの作成に関する項

1.2.3.2 割当てモードの指定

インスタンス管理者は、特定のOracle Application Expressインスタンスでのワークスペースの割当て(または作成)プロセスの動作方法を決定できます。割当ての動作方法を決定するには、インスタンス管理者は、インスタンスの設定ページで次のいずれかのオプションを選択します。

- 「手動」 - このモードでは、インスタンス管理者が新しいワークスペースを作成し、ワークスペース管理者にログイン・アイコンを通知します。

- リクエスト - ユーザーがセルフ・サービス方式で直接ワークスペースをリクエストします。ユーザーはログイン・ページのリンクをクリックしてリクエスト・フォームにアクセスします。ワークスペース・リクエストが承認されると、該当するログイン情報が電子メールで自動的にユーザーに送信されます。

- 電子メールの検証でのリクエスト - このモードでは、ユーザーがログイン・ページでリンクをクリックしてワークスペースを直接リクエストし、リクエスト・フォームにアクセスします。各ユーザーは、検証リンクを含む電子メールを最初に受信します。このリンクをクリックすると、ユーザーの電子メール・アドレスが検証されてからリクエストが処理されます。次に、ログイン資格証明(ワークスペース名、ユーザー名およびパスワード)を含む別の電子メールがユーザーに送信されます。

関連項目:
『Oracle Application Express管理ガイド』のワークスペースの作成に関する項

1.2.3.3 ワークスペースの作成

ワークスペースでは、オブジェクト、データおよびアプリケーションをプライベートに保持しながら、同一のOracle Application Expressのインストール内で複数のユーザーが作業できます。各ワークスペースには、一意のIDおよび名前が含まれます。Oracle Application Express管理者は手動でワークスペースを作成することも、ユーザーにリクエストを送信させることもできます。

関連項目:
『Oracle Application Express管理ガイド』のワークスペースの作成およびワークスペースと変更リクエストの管理に関する項

1.2.3.4 ワークスペースへのサインイン

Oracle Application Express管理サービスでワークスペースを作成した後、最後のステップとして、ワークスペースにサインインしてOracle Application Expressのログイン・ページに移動し、そのワークスペースにサインインします。

関連項目:
「ワークスペースへのサインイン」

1.2.4 開発者としてのワークスペースへのサインインおよびサインアウト

注意:
この情報は、Oracle Database Cloud Service (Database Schema)には適用されません。

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

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

- ワークスペースへのサインイン

- ワークスペースからのサインアウト

- ワークスペース名のリカバリ

- サインイン・ページからのパスワードの再設定

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

関連項目:
『Oracle Application Express管理ガイド』の環境設定の管理に関する項および「パスワードの変更」

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

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

関連項目:
『Oracle Application Express管理ガイド』のワークスペースの作成に関する項

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

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

1. Webブラウザで、Oracle Application Expressのサインイン・ページにナビゲートします。

ヒント:
Oracle Application Expressのログイン・ページのURLがわからない場合は、「ワークスペースへのサインイン」のステップ1を参照してください。

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

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

3. ワークスペースのタイプを選択します。オプションは次のとおりです。

- アプリケーション開発

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

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

関連項目:
『Oracle Application Express管理ガイド』のワークスペースのホームページの理解、パッケージ・アプリケーションのみのワークスペースの使用およびワークスペースの作成に関する項

1.2.4.2 ワークスペースへのサインイン

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

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

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

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

1. Webブラウザで、Oracle Application Expressの「ログイン」ページにナビゲートします。

- 設定でOracle REST Data Servicesを使用する場合、次に進みます。

http://hostname:port/apex

説明:

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

- portは、Oracle REST Data Servicesに割り当てられるポート番号です。デフォルトのインストールでは、この番号は8080です。詳細は、『Oracle REST Data Servicesインストレーション、構成および開発ガイド』を参照してください

- apexは、Oracle REST Data Servicesの構成時に定義されるサービス名です。

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

http://hostname:port/apex

説明:

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

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

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

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

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. 「サインイン」をクリックします。
ワークスペースのホームページが表示されます。

ヒント:
設定によっては、初めてサインインするときにパスワードの変更を要求される場合があります。

関連項目:
「ワークスペースのホームページの理解」および「パスワードの変更」

1.2.4.2.1 Oracle XML DB HTTPサーバーでHTTPに割り当てられたポートの確認

埋込みPL/SQLゲートウェイは、Oracle DatabaseのOracle XML DBプロトコル・サーバーで実行されます。

Oracle XML DB HTTPサーバーでHTTPに割り当てられたポートを確認するには、次の手順を実行します。

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 DBMS_XDB.GETHTTPPORT FROM DUAL;

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

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

1.2.4.3 ワークスペースからのサインアウト

Oracle Application Expressワークスペースからサインアウトするには、次のステップを実行します。

- ウィンドウの右上隅の「アカウント・メニュー」を選択し、「サインアウト」をクリックします。

関連項目:
「アカウント・メニュー」

1.2.4.4 ワークスペース名のリカバリ

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

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

1. サインイン・ページで、「パスワードの再設定」をクリックします。

2. 「ワークスペースの検索」をクリックします。

3. 電子メール・アドレスを入力して、「ワークスペースを検索」をクリックします。
入力した電子メール・アドレスに関連付けられたすべてのワークスペースを一覧表示した電子メールを受信します。

1.2.4.5 サインイン・ページからのパスワードの再設定

サインイン・ページからパスワードを再設定するには、電子メール・アドレスとワークスペース名を入力する必要があります。

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

1. 「サインイン」で、「パスワードの再設定」をクリックします。

2. 電子メール・アドレスとワークスペース名を入力し、「パスワードの再設定」をクリックします。
入力した電子メール・アドレスとワークスペース名に関連付けられたすべてのアカウントの新しいパスワードを含む電子メールを受信します。

3. サインイン・ページで、ワークスペース、ユーザー名および新しいパスワードを入力し、「サインイン」をクリックします。

ヒント:
パスワードは大/小文字が区別されます。新しいパスワードをコピー・アンド・ペーストしないでください。

4. 「パスワードの変更」で、次を入力します。

1. 現在のパスワード - 電子メールで提供された現在のパスワードを入力します。

2. 新規パスワード - 新規パスワードを入力します。

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

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

関連項目:
「パスワードの変更」

1.3 ワークスペースのホームページの理解

Oracle Application Express開発環境にサインインすると、ワークスペースのホームページが表示されます。ワークスペースは、オブジェクト、データおよびアプリケーションをプライベートに保ちながら、同一のOracle Application Expressのインストール内で複数のユーザーが作業可能な仮想プライベート・データベースです。この項では、ワークスペースのホームページについて説明します。

- ワークスペースのホームページ

- ニュースとメッセージ

- 「トップ・アプリケーション」および「トップ・ユーザー」ダッシュボード

- 開発者ナビゲーション・ツール

- 「使用可能な更新」リージョン

- 「アクセシビリティ・モード」リージョン

1.3.1 ワークスペースのホームページ

ページの中央に次の大きなアイコンが表示されます。

- 「アプリケーション・ビルダー」。アプリケーション・ビルダーを使用して、一連のHTMLページから構成されるデータベース・オブジェクトに基づいたアプリケーションを作成します。詳細は、「アプリケーション・ビルダーの概念」および「アプリケーション・ビルダーの理解」を参照してください。

- 「SQLワークショップ」。SQLワークショップを使用すると、データベース・オブジェクトを表示および管理するためのツールにアクセスできます。詳細は、Oracle Application Express SQLワークショップ・ガイドを参照してください。

- 「チーム開発」。チーム開発を使用すると、新機能、機能に関連しないタスク(To Doタスク)、バグおよびマイルストンを追跡できます。また、ユーザーはリアルタイム・フィードバックを提供できます。このフィードバックは、機能、一般タスクまたはバグに分類できます。「チーム開発によるアプリケーション・ライフサイクルの管理」を参照してください。

- 「パッケージ・アプリケーション」。パッケージ・アプリケーション・ページにリンクしています。「パッケージ・アプリケーションの使用」を参照してください。

メニュー・バーは、ページの上部にも表示されます。メニューをクリックして、「アプリケーション・ビルダー」、「SQLワークショップ」、「チーム開発」および「パッケージ・アプリケーション」内の様々なコンポーネントへの別のナビゲーション・パスにアクセスします。

1.3.2 「トップ・アプリケーション」および「トップ・ユーザー」ダッシュボード

「トップ・アプリケーション」リージョンおよび「トップ・ユーザー」リージョンは、ページの下部に表示されます。これらのリージョンには、現在のワークスペース内の開発アクティビティに関する情報がリアルタイムに表示されます。

1.3.3 ニュースとメッセージ

「ニュースとメッセージ」リージョンには、3つのタイプのメッセージが表示されます。

- ニュース・エントリ

- システム・メッセージ

- ワークスペースのお知らせ

ニュース・エントリには、メッセージ・テキストの左に日付が表示されます。開発者はニュース・エントリを作成して、他のワークスペース・ユーザーとやり取りできます。ニュース・エントリを追加するには、プラス記号(+)の形をした「ニュース・エントリの作成」アイコンをクリックします。既存のニュース・エントリを編集するには、大なり記号(>)の形をした「ニュース・エントリの編集」をクリックします。

ワークスペース通知とシステム・メッセージは、どちらもメッセージ・テキストの左に金色のアイコンが表示されます。テキスト識別子(System MessageまたはWorkspace Announcement)も、メッセージ・テキストの下に表示されます。

関連項目:
『Oracle Application Express管理ガイド』のニュース・エントリの管理、システム・メッセージの定義、およびワークスペース通知の定義に関する項

1.3.4 開発者ナビゲーション・ツール

この項では、ワークスペースのホームページ、アプリケーション・ビルダーのホームページ、アプリケーションのホームページ、ページ・デザイナ、コンポーネント・ビュー、共有コンポーネントなど、多くのOracle Application Expressページのヘッダー・リージョンで使用可能な開発者ナビゲーション・ツールについて説明します。

- グローバル検索フィールド

- 「管理」メニュー

- 「ヘルプ」メニュー

- アカウント・メニュー

1.3.4.1 グローバル検索フィールド

検索フィールドは、ほとんどのアプリケーション・ビルダー・ページの右上隅のヘッダー・リージョンに表示されます。デフォルトでは、この検索フィールドでは正規表現がサポートされます。検索フィールドの動作方法は、表示しているページによって異なります。次に例を示します。

- ワークスペースのホームページ - アプリケーション名を検索します。

- アプリケーション・ビルダーのホームページ - すべてのアプリケーションにわたるアプリケーション・メタデータを検索します。

- アプリケーションのホームページ - アプリケーションのホームページおよびアプリケーション・ビルダー内の他のページのメタデータを検索します。

- チーム開発のホームページ - チーム開発のホームページおよびチーム開発内の他のページを検索します。

- ワークスペース管理のホームページ - ユーザーを検索します。

アプリケーション・ビルダー内で、次の特殊構文を使用して、特定のページにナビゲートしたり正規表現を検索できます。

page
application_ID:page
application_ID-page
regexp:expression

説明:

- application_ID: アプリケーションを識別する数値指定番号(ID)です。

- page: 特定のページを識別する数値指定番号です。

- regexp:: リテラル・テキストです。

- expression: 検索対象の正規表現です。

次の例では、アプリケーション570のページ10にナビゲートします。

10
570-10
570:10

次の構文を使用して、指定したアプリケーションの共有コンポーネント・ページにナビゲートすることもできます。

application_ID:s
application_ID-s

説明:

- application_ID: アプリケーションを識別する数値指定番号(ID)です。

次の例は、アプリケーション570の共有コンポーネント・ページにナビゲートする方法を示しています。

570:s
570-s

1.3.4.2 「管理」メニュー

「管理」メニューはグローバル検索フィールドの右側に表示され、人の輪郭とレンチが示されています。このメニューをクリックすると、次のオプションが表示されます。

- 管理: ワークスペース管理ページにリンクしています。詳細は、Oracle Application Express管理ガイドの「ワークスペースとアプリケーションの管理」を参照してください。

- サービスの管理: サービスの管理ページのオプションのサブメニューが表示されます。詳細は、『Oracle Application Express管理ガイド』のサービスの管理ページに関する項を参照してください。

- ユーザーとグループの管理: ユーザーとグループの管理ページにリンクします。詳細は、『Oracle Application Express管理ガイド』のワークスペースでのユーザーの管理に関する項を参照してください

- アクティビティの監視: アクティビティの監視ページにリンクします。このページを使用して、ページ・ビュー、開発者アクティビティ、ページ・ビューの分析およびアクティブ・セッションへの変更を監視します。これにはログイン試行回数や外部アクセス・カウントなどの情報のレポートも表示されます。詳細は、『Oracle Application Express管理ガイド』のワークスペース内のアクティビティの監視に関する項を参照してください。

- ダッシュボード: ダッシュボード・ページにリンクします。このページを使用して、現在のワークスペースの詳細の表示やユーザー、アクティビティ、開発者アクティビティ、パフォーマンス、Webシート・アプリケーション開発、アプリケーション開発の監視、およびデータベースの詳細の表示を行います。詳細は、『Oracle Application Express管理ガイド』のワークスペース・ダッシュボードの表示に関する項を参照してください。

- パスワードの変更: 「プロファイルの編集」ダイアログ・ボックスの「パスワードの変更」セクションにリンクします。「パスワードの変更」を参照してください。

1.3.4.3 「ヘルプ」メニュー

「ヘルプ」メニューは疑問符の形をしています。「ヘルプ」をクリックすると、次のメニュー項目が表示されます。

- ドキュメント。Oracle Application Express、リリース5.0 Oracle Help Centerにリンクします。「Oracle Application Expressドキュメントの使用」を参照してください。

- ディスカッション・フォーラム。次のApplication Expressディスカッション・フォーラムにリンクします。
https://community.oracle.com/community/database/developer-tools/application_express

- Oracle Technology Network。次のOracle Technology NetworkのOracle Application Expressページにリンクします。
http://www.oracle.com/technetwork/developer-tools/apex/overview/index.html

- バージョン情報。「Application Expressについて」ダイアログにリンクします。このダイアログには、Oracle Application Expressインスタンスおよびデータベースのバージョンに関する情報が含まれています。

1.3.4.4 アカウント・メニュー

アカウント・メニューはページの右上隅に表示され、人の輪郭が示されています。アカウント・メニューには、ユーザー名、現在のワークスペースおよびユーザー・ロールが表示されます。シングル・サインオン(SSO)が有効な場合は、リンク「ワークスペースの変更」も表示されます。このメニューの主要なコントロールは次のとおりです。

- プロファイルの編集。名および姓、写真イメージのアップロードまたは選択、電子メール・アドレスの変更(SSOが有効でない場合)およびパスワードの再設定を行うには、「プロファイルの編集」をクリックします。「アカウント・プロファイルおよびプリファレンスの編集」を参照してください。

ヒント:
シングル・サインオン認証を使用している場合は、「ワークスペースの変更」も表示されます。アクセス権があるワークスペースのリストを表示するには、「ワークスペースの変更」をクリックします。

- プリファレンス。デフォルト・スキーマ、デフォルトの日付書式およびアプリケーション・ビルダーでアプリケーションを実行する方法の制御を変更するには、「プリファレンス」をクリックします。「ユーザー・プリファレンスの編集」を参照してください。

- サインアウト - 現在のワークスペースからログアウトするには、「サインアウト」をクリックします。「ワークスペースからのサインアウト」を参照してください。

関連項目:
「アカウント・プロファイルの編集」

1.3.5 「使用可能な更新」リージョン

「使用可能な更新」リージョンには、Oracle Application ExpressおよびOracle REST Data Servicesの更新が使用可能かどうかが示されます。インストールが最新の場合は、次のメッセージが表示されます。

System is up-to-date

更新を構成するには、「使用可能な更新のプリファレンスの設定」をクリックします。「使用可能な更新の確認」から「はい」または「いいえ」を選択して、更新を有効または無効にできます。

ヒント:
このチェックを実行するには、Application ExpressによりOracle Application Expressおよびその他のシステム・コンポーネントのバージョン番号をオラクル社に送信してください。オラクル社では、製品を継続的に改善するため、製品の使用状況を把握したいと考えています。そのために、使用中の製品機能を記述した統計が時折オラクル社に送信される場合があります。個人情報は送信されません。オラクル社のプライバシ・ポリシーを確認するには、次を参照してください。
http://www.oracle.com/us/legal/privacy/overview/index.html

1.3.6 「アクセシビリティ・モード」リージョン

「アクセシビリティ・モード」リストは、ページの右下隅に表示されます。「アクセシビリティ・モード」リストを使用して、ページがスクリーン・リーダー用に最適化されているかどうかを識別します。使用可能なオプションは、「標準」、「スクリーン・リーダー」、「ハイ・コントラスト」です。

関連項目:
「Oracle Application Expressのアクセシビリティ」、「スクリーン・リーダー・モードの理解」および「ハイ・コントラスト・モードの理解」

1.4 アカウント・プロファイルの編集

この項では、アカウント・プロファイルの編集方法について説明します。アカウント・プロファイルを編集することによって、電子メール・アドレスの更新、名または姓の編集、写真のアップロードまたはパスワードの変更を行うことができます。

- アカウント・プロファイルおよびプリファレンスの編集

- パスワードの変更

関連項目:
「サインイン・ページからのパスワードの再設定」

1.4.1 アカウント・プロファイルおよびプリファレンスの編集

アカウント・プロファイルを編集するには、次のステップを実行します。

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

2. ヘッダー・リージョンでアカウント・メニューをクリックします。「アカウント・メニュー」を参照してください。

3. 「プロファイルの編集」をクリックします。
「プロファイルの編集」ダイアログが表示されます。

「プロファイルの編集」ダイアログが表示されます。

4. 「プロファイル詳細」で、以下の属性を編集します。

- Email Address

- 名

- 姓

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

5. 「プロファイル写真」で、写真の追加、変更または削除を行います。

6. 「パスワードの変更」で、新しいパスワードを入力します。「パスワードの変更」を参照してください。

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

1.4.2 パスワードの変更

パスワードを再設定するには、次のステップを実行します。

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

2. ヘッダー・リージョンでアカウント・メニューをクリックし、「プロファイルの編集」を選択します。
「プロファイルの編集」ダイアログが表示されます。

3. 「パスワードの変更」までスクロールし、以下を編集します。

- 現行のパスワードの入力

- 新規パスワードの入力

- パスワードの確認

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

関連項目:
『Oracle Application Express管理ガイド』のエンド・ユーザー・パスワードの変更に関する項および「アカウント・メニュー」

1.5 ユーザー・プリファレンスの編集

この項では、ユーザー・プリファレンスの編集方法について説明します。ユーザー・プリファレンスを編集することによって、デフォルト・ワークスペース・スキーマの更新、デフォルト日付書式の指定およびアプリケーションの実行時にOracle Application Expressでウィンドウとタブを管理する方法の決定を行うことができます。

ユーザー・プリファレンスを編集するには、次のステップを実行します。

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

2. ヘッダー・リージョンでアカウント・メニューをクリックし、「プリファレンス」をクリックします。

「プリファレンス」ダイアログが表示されます。

3. 次の属性を編集します。

- デフォルトのスキーマ: データの参照、アプリケーションの作成およびSQLスクリプトの実行に使用するデフォルト・スキーマを指定します。使用可能なスキーマが複数あるワークスペースを使用する場合、アプリケーションの作成、SQL問合せの実行などでは、このスキーマがデフォルトになります。この機能では、セキュリティは制御されず、ユーザーのプリファレンスのみが制御されます。

- デフォルトの日付書式: ユーザー用のデフォルトのOracle日付書式を指定します。この指定により、SQLワークショップ内のデフォルトの日付書式が制御されます。

- アプリケーションを新規ウィンドウで実行: アプリケーション・ビルダーからのアプリケーションの実行時にOracle Application Expressでウィンドウまたはタブを管理する方法を指定します。
このオプションは、Mozilla FirefoxおよびMicrosoft Internet Explorerを使用する場合にのみ影響し、他のブラウザを使用する場合は影響しません。オプション:

- はい - デフォルト。ブラウザのプリファレンスは無視され、新しいウィンドウが常に開かれます。

- いいえ - ランタイム・アプリケーションは、ブラウザのプリファレンスに基づいた新しいウィンドウまたはタブで開かれます。通常、Mozilla FirefoxおよびMicrosoft Internet Explorerでは、タブが最初に起動された場合を除き、同じウィンドウの別のタブにフォーカスは設定されません。

- すべてのアプリケーションの実行に単一ウィンドウを使用: 異なるアプリケーションで、同じアプリケーション・ランタイム・ウィンドウまたはタブを再利用するかどうかを指定します。オプション:

- はい - アプリケーション・ビルダーから実行する各アプリケーションで、前のアプリケーションの実行に使用されたウィンドウまたはタブを再利用します。

- いいえ - 実行する各アプリケーションは、独自のウィンドウまたはタブで開かれます。

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

1.6 Oracle Application Expressドキュメントの使用

Oracle Application Expressには、ホスティングされたオンライン・ドキュメント・ライブラリおよびフィールドレベル・ヘルプがあります。この項では、ライブラリへのアクセスと検索、ライブラリ・マスター索引の使用、ドキュメント・ライブラリのダウンロードおよびフィールドレベル・ヘルプの使用について説明します。

- Oracle Help Centerへのアクセス

- Oracle Help Centerの検索

- オンライン・ドキュメントのダウンロード

- ダウンロードしたドキュメント・ライブラリの検索

- フィールドレベル・ヘルプの表示

1.6.1 Oracle Help Centerへのアクセス

オンラインOracle Application Expressドキュメント・ライブラリにアクセスするには、次のステップを実行します。

1. 右上隅にある「ヘルプ」メニューをクリックします。

Oracle Help Centerが表示されます。

2. 「ドキュメント」を選択します。
Oracle Help Centerが表示されます。

- ヒント:
Oracle Application Express管理サービスのインスタンス設定のインスタンス・レベルで、「ヘルプ」メニューをリダイレクトできます。『Oracle Application Express管理ガイド』のヘルプ・メニューの構成に関する項を参照してください。

1.6.2 Oracle Help Centerの検索
オンライン・ドキュメント・ライブラリのキーワード検索を実行するには、次のステップを実行します。

1. ほとんどのOracle Application Expressページの右上隅にある「ヘルプ」メニューをクリックします。

2. 「ドキュメント」を選択します。
Oracle Help Centerが表示されます。

3. ライブラリ全体を検索するには、次のステップを実行します。

1. ページ上部の検索フィールドにキーワードを入力し、「検索」をクリックします。
検索結果が表示されます。

2. 確認するトピックを選択します。

4. 特定のドキュメントを検索するには、次のステップを実行します。

1. ドキュメントを選択します。

2. 左上隅の検索フィールドにキーワードを入力します。
検索結果が表示されます。

3. 確認するトピックを選択します。

1.6.3 オンライン・ドキュメントのダウンロード

Oracle Application Expressドキュメント・ページから、Oracle Application Expressドキュメント・ライブラリをローカルにダウンロードできます。

オンライン・ドキュメント・ライブラリをダウンロードするには、次のステップを実行してください。

1. Oracle Application Expressドキュメント・ページに移動します。

http://www.oracle.com/technetwork/developer-tools/apex/application-express/apex-094287.html

2. ダウンロードするOracle Application Expressライブラリを検索し、「ZIP」リンクをクリックします。

3. ZIPファイルをダウンロードし、ローカルで解凍します。

4. 解凍したフォルダを開き、index.htmlをクリックします。
Oracle Application Expressドキュメント・ライブラリのようこそページが表示されます。

関連項目:
「Oracle Help Centerへのアクセス」

1.6.4 ダウンロードしたドキュメント・ライブラリの検索

提供されたAcrobatの検索索引を使用すると、ダウンロードしたライブラリのPDFを高速に検索できます。

ヒント:
「Oracle Help Centerの検索」の説明に従ってグローバル検索機能およびマスター索引を使用するには、インターネットにアクセスする必要があります。

ダウンロードしたドキュメントでグローバル検索を実行するには、次のステップを実行します。

1. ダウンロードしたドキュメント・ライブラリの場所に移動します。

2. index.pdxをダブルクリックします。

3. [Shift]+[Ctrl]+[F]を押します。
検索ウィンドウが表示されます。

4. 検索条件を入力し、「検索」をクリックします。
検索結果が表示されます。

1.6.5 フィールドレベル・ヘルプの表示

Oracle Application Expressのほとんどの選択リスト、チェック・ボックス、アイテムおよびフィールドには、フィールドレベル・ヘルプがあります。フィールドレベル・ヘルプは、表示する場所に応じて2種類の方法で表示されます。

- Oracle Application Expressでのフィールドレベル・ヘルプの表示

- ページ・デザイナでのヘルプの表示

関連項目:
「ページ・デザイナでのページの管理」および「コンポーネント・ビューでのページの管理」

1.6.5.1 Oracle Application Expressでのフィールドレベル・ヘルプの表示

フィールドレベル・ヘルプを表示するには、次のステップを実行します。

1. 情報が必要な属性にナビゲートします。
ほとんどのOracle Application Expressで、フィールドレベル・ヘルプがある属性には、疑問符(?)の形をした薄い灰色の「ヘルプ・テキスト」アイコンが表示されます。

2. フィールドレベル・ヘルプを表示するには、「ヘルプ・テキスト」アイコンをクリックします。
ヘルプ・ウィンドウが表示されます。

ヒント:
オンライン・ドキュメント・ライブラリを表示するには、ヘッダー・リージョンで「ヘルプ」メニューをクリックし、「ドキュメント」を選択します。キーボードを使用してフィールドレベル・ヘルプにアクセスするには、正しいフィールドにフォーカスし、[Alt]+[F1]を押します。

1.6.5.2 ページ・デザイナでのヘルプの表示

ページ・デザイナには、プロパティ・エディタのすべてのプロパティのヘルプが含まれています。

ページ・デザイナでヘルプを表示するには、次のステップを実行します。

1. ページ・デザイナにアクセスします。「ページ・デザイナでのページの表示」を参照してください。
ページ・デザイナが表示されます。

2. 「レンダリング」ツリーまたは「グリッド・レイアウト」で、コンポーネントまたは制御を選択します。
いずれかのビューでフォーカスを変更すると、プロパティ・エディタによって自動的に更新され、現在選択されているコンポーネントが反映されます。

3. プロパティ・エディタで、属性を選択します。

4. 中央のペインで「ヘルプ」タブをクリックします。

「ヘルプ」ペインをアクティブ化すると、別の属性を選択するたびに表示されるコンテンツが変わります。

ヒント:
ヘッダー・リージョンで「ヘルプ」メニューをクリックし、「ドキュメント」を選択すると、オンライン・ドキュメント・ライブラリが表示されます。

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

このセクションでは、アプリケーション・ビルダーの基本概念を説明します。

- Oracle Application Expressアプリケーションの理解

- アプリケーション・ページの理解

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

- ページ・プロセスおよびページ・レンダリングの仕組み

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

- URL構文の理解

- ブックマークのサポートの有効化について

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

- 置換文字列の理解

関連項目:
「アプリケーション・ビルダーの理解」

2.1 Oracle Application Expressアプリケーションの理解

この項では、Oracle Application Expressアプリケーションの概要、データベース・アプリケーションとWebシート・アプリケーションの違い、およびアプリケーションの作成ウィザードの実行方法について説明します。

- Oracle Application Expressアプリケーションとは

- データベース・アプリケーションとWebシート・アプリケーションの違い

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

関連項目:
「アプリケーション・ビルダーの理解」

2.1.1 Oracle Application Expressアプリケーションとは

アプリケーションは表またはプロシージャのようなデータベース・オブジェクトの上部に存在するHTMLインタフェースです。アプリケーションの作成ウィザードを使用して、データベース・アプリケーションとWebシート・アプリケーションの両方を作成します。これらの2タイプのアプリケーションにおける主な違いは、対象ユーザーです。データベース・アプリケーションは主にアプリケーション開発者を対象として開発されており、Webシート・アプリケーションは開発経験のないエンド・ユーザーを対象として作成されています。

2.1.2 データベース・アプリケーションとWebシート・アプリケーションの違い

Oracle Application Expressアプリケーションでは、Oracle Databaseからのデータを管理および表示できます。アプリケーション・ビルダーを使用して、アプリケーションを構築できます。アプリケーション・ビルダーを使用して、2つの異なるタイプのアプリケーション(データベース・アプリケーションおよびWebシート・アプリケーション)を作成できます。この項では、これらのアプリケーション・タイプの違いについて説明します。

- データベース・アプリケーションについて

- Webシート・アプリケーションについて

2.1.2.1 データベース・アプリケーションについて

データベース・アプリケーションは、ナビゲーション・メニュー、タブ、ボタンまたはハイパーテキスト・リンクを使用して相互にリンクされたページの集合です。アプリケーションのページは、共通のセッション・ステートおよび認証を共有します。

データベース・アプリケーションを作成するには、アプリケーションの開発者はウィザードを実行して宣言的にページおよびナビゲーションを編成します。個々のページはリージョンと呼ばれるコンテナを使用して編成されます。リージョンには、テキスト、カスタムPL/SQL、レポート、チャート、マップ、カレンダ、Webサービス・コンテンツまたはフォームを含めることができます。フォームは、数多くの組込みタイプ(テキスト・フィールド、テキスト領域、ラジオ・グループ、選択リスト、チェック・ボックス、日付ピッカー、ポップアップLOVなど)から選択可能なフィールド(アイテムと呼ばれる)で構成されます。

また、開発者はプラグインを使用して独自のカスタム・アイテム・タイプを作成することもできます。セッション・ステート(アプリケーション・コンテキスト)は透過的に管理され、ユーザー・インタフェース・プレゼンテーションはアプリケーション・ロジックから分離されているため、開発者はアプリケーションのルック・アンド・フィールを別のテーマを選択することで簡単に変更できます。

関連項目:
「データベース・アプリケーションの作成」

2.1.2.2 Webシート・アプリケーションについて

Webシート・アプリケーションを作成すると、開発者の支援がなくても、エンド・ユーザーが構造化データおよび非構造化データを管理できます。ページ・セクションには、WYSIWYGエディタを使用して編集できる非構造化データが含まれます。データ・グリッドによって、SQLを記述しなくても構造化データを管理できます。ユーザーは実行時ダイアログ・ボックスを使用して、列の追加、列の名前の変更および検証を実行できます。各ページおよびデータ・グリッドの各行は、ファイル、タグ、ノートおよびリンクで注釈を付けることができます。ページには、セクション、レポートおよびデータ・グリッドを含めることができ、ナビゲーションを使用してすべてをリンクできます。すべての情報は、検索可能でエンド・ユーザーによって完全に制御されます。

関連項目:
「Webシート・アプリケーションの作成」

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

Oracle Application Expressアプリケーションを作成するには、開発者はアプリケーションの作成ウィザードを実行します。アプリケーションの作成ウィザードを実行するには、アプリケーション・ビルダーのホームページで「作成」ボタンをクリックします。

アプリケーションの作成ウィザードを実行すると、作成するアプリケーションのタイプを選択するよう求められます。デスクトップとモバイル・ユーザー・インタフェースの両方が定義されているデスクトップおよびモバイル・データベース・アプリケーションは、自動検出を使用して、デバイスの画面サイズに基づいた最適なユーザー・インタフェースを実行できます。アプリケーションがパーソナル・コンピュータから開始される場合は、デスクトップ・ユーザー・インタフェースを使用します。アプリケーションがスマートフォンで実行される場合は、モバイル・ユーザー・インタフェースを使用します。複数のユーザー・インタフェースのあるアプリケーションを開発するには、1つのユーザー・インタフェースでアプリケーションを定義した後で、「ユーザー・インタフェース」属性から他のユーザー・インタフェースを追加します。

主なデシジョン・ポイントは、次のとおりです。

- デスクトップ。デスクトップ・データベース・アプリケーションを使用すると、開発者は開発プロセスのあらゆる面を完全に制御でき、SQLおよびPL/SQLのプログラミング技術をそのまま活用できます。データベース・アプリケーションは、フロー制御全体で宣言的な制御を使用し、テンプレートおよびテーマの使用により完全なユーザー・インタフェース制御をサポートしています。「アプリケーションの作成ウィザードの使用」および「データベース・アプリケーションの作成」を参照してください。

- モバイル。モバイル・データベース・アプリケーションは、特にスマートフォン・デバイスで実行するように設計されています。「アプリケーションの作成ウィザードの使用」および「モバイル・アプリケーションの作成」を参照してください。

- Webシート。Webシート・アプリケーションを使用すると、ユーザーはSQLのプログラミング知識がなくてもデータ中心のアプリケーションを作成できます。Webシート・アプリケーションは、ページ、データ・グリッド、レポートおよびコミュニティの貢献をサポートします。「Webシート・アプリケーションの作成」を参照してください。

- パッケージ・アプリケーション。「パッケージ・アプリケーション」ギャラリにリンクします。「パッケージ・アプリケーションについて」を参照してください。

- 追加のアプリケーションの作成オプションは、次のとおりです。

- スプレッドシートから。ファイルとして、またはコンテンツをコピー・アンド・ペーストすることによって、スプレッドシート情報をアップロードします。「スプレッドシートからのデスクトップ・データベース・アプリケーションの作成」を参照してください。

- 既存アプリケーションのコピー。「データベース・アプリケーションのコピー」を参照してください。

関連項目:
「データベース・アプリケーションの作成」

2.2 アプリケーション・ページの理解

ページは、アプリケーションの基本的な構成要素です。この項では、ページの概要とページ・デザイナおよびコンポーネント・ビューという2つのビューでページを編集する方法について説明します。

- アプリケーション・ページの概要

- ページ・デザイナとコンポーネント・ビューの違いの理解

- ページ・デザイナでのページの表示

- コンポーネント・ビューでのページの表示

- ページ・デザイナからコンポーネント・ビューへの切替え

- コンポーネント・ビューからページ・デザイナへの切替え

2.2.1 アプリケーション・ページの概要

すべてのアプリケーションは、1つまたは複数のページで構成されます。各ページにはボタンおよびフィールド(アイテムと呼ばれる)を配置でき、これらはリージョンと呼ばれるコンテナにグループ化されます。ページには、アプリケーション・ロジック(プロセス)を含めることもできます。条件付きナビゲーションを使用したあるページから別のページへのブランチや、(計算と呼ばれる)計算の実行、(編集チェックなどの)検証の実行、レポート、カレンダおよびチャートの表示が可能です。ページ・デザイナとコンポーネント・ビューという2つのビューでページを表示および編集できます。

関連項目:
「ページ・デザイナでのページの管理」および「コンポーネント・ビューでのページの管理」

2.2.2 ページ・デザイナとコンポーネント・ビューの違いの理解

この項では、アプリケーション・ページの編集にページ・デザイナを使用する場合と、コンポーネント・ビューを使用する場合の主な違いについて説明します。

- ページ・デザイナ

- コンポーネント・ビュー

2.2.2.1 ページ・デザイナ

ページ・デザイナは、アプリケーション・ページの維持に関する開発者の生産性を最大化するように設計された、フル機能を備えた統合開発環境(IDE)です。ページ・デザイナのウィンドウは、3つの主要セクションに分かれています。

- ツリー・ペイン - ツリー・ペインは左の列に表示され、「レンダリング」、「動的アクション」、「プロセス」および「共有コンポーネント」のツリー・ビューがあります。

- グリッド・レイアウト - グリッド・レイアウトは中央の列に表示されます。グリッド・レイアウトは、ページを定義するリージョン、アイテムおよびボタンを視覚的に表します。ドラッグ・アンド・ドロップすることによって、ページ・コンポーネントの位置を編集できます。タブの下部にあるギャラリからドラッグ・アンド・ドロップして、新しいリージョン、アイテムおよびボタンを追加することもできます。

- プロパティ・エディタ - プロパティ・エディタは右の列に表示されます。プロパティ・エディタを使用して、ツリー・ペインまたはグリッド・レイアウトで現在選択されているコンポーネントのプロパティを編集します。

ヒント:
「レンダリング」ツリーおよびグリッド・レイアウトは、ページを定義するリージョン、アイテムおよびボタンの2つの異なる表現です。

関連項目:
「ページ・デザイナでのページの管理」

2.2.2.2 コンポーネント・ビュー

コンポーネント・ビューは、アプリケーション・ビルダーでページを編集するための従来のユーザー・インタフェースです。ページ・デザイナとは異なり、コンポーネント・ビューでは、ページを視覚的に表したり、ページ・コンポーネントをドラッグ・アンド・ドロップすることができません。ページ上のコンポーネントの位置をプレビューするには、ページを実行する必要があります。

コンポーネント・ビュー・ウィンドウは、次のセクションに分かれています。

- ページ・レンダリング。ページ・レンダリングとは、データベースからページを生成するプロセスです。「ページ・レンダリング」セクションを使用して、ページ属性、リージョン、ボタン、アイテム、ページ・レンダリングの計算、およびページ・プロセスを含むページのレンダリングに影響するコントロールを変更できます。

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

- 共有コンポーネント。「共有コンポーネント」セクションには、アプリケーション内の1つ以上のページで使用できる共通のコンポーネントが表示されます。

関連項目:
コンポーネント・ビューでのページの管理

2.2.3 ページ・デザイナでのページの表示

ページ・デザイナでページを表示するには、次のステップを実行します。

1. 「ワークスペース」ホームページにナビゲートします。

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

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

4. ページを選択します。
ページが表示されます。デフォルトでは、ページ・デザイナが表示されます。

ページを実行してプレビューします。アプリケーション・ページを実行すると、エンド・ユーザーに表示されるとおりにレンダリングされたバージョンが表示されます。

関連項目:
「コンポーネント・ビューからページ・デザイナへの切替え」、「アプリケーションまたはページの実行」および「ページ・デザイナでのページの管理」

2.2.4 コンポーネント・ビューでのページの表示

コンポーネント・ビューでページを表示するには、次のステップを実行します。

1. 「ワークスペース」ホームページにナビゲートします。

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

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

4. ページを選択します。
デフォルト・ビューであるページ・デザイナが表示されます。

5. コンポーネント・ビューに変更します。

1. ページ上部のページ・デザイナ・ツールバーに移動します。

2. 「コンポーネント・ビュー」をクリックします。

コンポーネント・ビューが表示されます。

ページを実行してプレビューします。アプリケーション・ページを実行すると、エンド・ユーザーに表示されるとおりにレンダリングされたバージョンが表示されます。

関連項目:
「アプリケーションまたはページの実行」、「ページ・デザイナからコンポーネント・ビューへの切替え」および「コンポーネント・ビューでのページの管理」

2.2.5 ページ・デザイナからコンポーネント・ビューへの切替え

ページ・デザイナからコンポーネント・ビューに切り替えるには、次のステップを実行します。

1. ページ・デザイナでページを表示します。「ページ・デザイナでのページの表示」を参照してください。

2. コンポーネント・ビューに変更します。

1. ページ上部のページ・デザイナ・ツールバーに移動します。

2. 「コンポーネント・ビュー」アイコンをクリックします。

コンポーネント・ビューが表示されます。

関連項目:
コンポーネント・ビューでのページの管理

2.2.6 コンポーネント・ビューからページ・デザイナへの切替え

コンポーネント・ビューからページ・デザイナに切り替えるには、次のステップを実行します。

1. コンポーネント・ビューでページを表示します。「コンポーネント・ビューでのページの表示」を参照してください

2. ページ・デザイナに切り替えるには、ページ上部の「ページ・デザイナ」アイコンをクリックします。
ページ・デザイナが表示されます。

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

関連項目:
「ページ・デザイナでのページの管理」

2.3 ユーザー・インタフェース設計の管理

この項では、アプリケーションのユーザー・インタフェースの選択に関する主要な概念について説明します。

- アプリケーションのユーザー・インタフェースの決定について

- モバイル・アプリケーション設計について

- モバイル・アプリケーション設計について

2.3.1 アプリケーションのユーザー・インタフェースの決定について

アプリケーション・ビルダーでは、単一アプリケーション内の複数のユーザー・インタフェースがサポートされます。開発者は、デスクトップ、モバイル・デバイスまたはその両方のためのアプリケーションを構築することを選択できます。1つのアプリケーションに対して定義される各ユーザー・インタフェースには、固有のテーマ、ログイン・ページ、ホームページおよびグローバル・ページ(旧名称はページ0)があります。アプリケーション内のページを作成するときは、どのユーザー・インタフェースがそのページに関連付けられるかを指定する必要があります。選択したユーザー・インタフェースによって、ページおよびリージョンを作成するときに表示されるオプションが決まります。たとえば、マップ、データ・ロードおよび対話モード・レポートは、デスクトップ・ページのみでサポートされます。同様に、モバイル・ページでは、最も一般的な構成体はレポートとフォームではなくリストとフォームです。

関連項目:
「データベース・アプリケーションの作成」、「モバイル・アプリケーションの作成」および「すべてのページにコンポーネントを表示するグローバル・ページの作成」

2.3.2 モバイル・アプリケーション設計について

モバイル・アプリケーションは特にスマートフォン・デバイスで実行するように設計されるので、モバイル接続に最適化された、極小のセマンティックHTMLで構築される必要があります。Oracle Application Expressを使用して開発するモバイル・アプリケーションは、モバイル・デバイスのブラウザ内で実行されるブラウザ・ベースのアプリケーションです。したがって、これらのアプリケーションがOracle Databaseと通信するためには接続が必要で、切断された環境では操作できません。

HTML5機能を備えたモバイル・デバイスは、HTML5 date-picker、フィールド定義に基づき異なるキーパッドを表示するサブタイプなどを含む、アプリケーションに組込み可能なすべての機能を利用できます。より古いデバイスでは、アプリケーションはレンダリングされ、提供される拡張機能は少なくなります。ブラウザ・ベースのアプリケーションの大きな利点は、大多数のモバイル・デバイス向けに一度開発するだけでよいということです。ただし、1つの大きな制限は、連絡先リストなどのオンデバイス機能のアクセスです。Webアプリケーションの表示にネイティブ・アプリケーション・ラッパーを使用するハイブリッド・ソリューションの作成をサポートする、PhoneGapなどのソリューションと統合することで、この制限を軽減できます。Phonegapなどのソリューションによって、現在はHTML5またはJavaScriptを使用して利用できないネイティブ電話機能の多くにアクセスするための、様々なAPIが提供されます。詳細は次の場所を参照してください。

http://phonegap.com/

関連項目:
「モバイル・アプリケーションの作成」および「レスポンシブ・デザインについて」

2.3.3 モバイル・デザインとレスポンシブ・デザインの違いの理解

Oracle Application Expressにはモバイル・デバイス用のアプリケーションの開発の手法が2つあります。

- オプション1: jQuery MobileベースのWebページを作成します。

- オプション2: Theme 25を使用して、ターゲット・デバイス(たとえば、デスクトップ・コンピュータ、ラップトップ・コンピュータ、タブレットまたはスマートフォン)にかかわらず、ページ・レイアウトをスペースに適合させるレスポンシブ・デザインを作成します。

これらの2つのアプローチの主な違いは、レスポンシブ・デザインでは1つのWebページを任意のデバイスに表示できることです。一方、jQuery Mobileを使用してモバイル・アプリケーションを作成する開発者は、ページを2セット作成する必要があります。1つはデスクトップ表示用、もう1つはモバイル・デバイス用です。レスポンシブ・デザインの作成と管理するページが1つのみということは、表面上は、2つの別個のページを管理するよりも魅力的に思えます。しかし、実際には、本当にレスポンシブなページの設計の先行コストはかなり高く、グリッド・レイアウト、HTMLおよびCSSに関する高いレベルの理解が必要です。

別個のモバイル・ページを作成するか、または作成しているサイトまたはアプリケーションのタイプに応じたレスポンシブ・デザインを作成するかに基づいて、決定する必要があります。たとえば、マーケティング・サイトなどの一般人からアクセスされるアプリケーションは、レスポンシブ・デザインが適しています。顧客追跡アプリケーションなどの生産性アプリケーションは、スマートフォンの本来の機能を活用できるモバイル・ページの作成の適切な対象候補です。

関連項目:
「モバイル・アプリケーションの作成」および「レスポンシブ・デザインについて」

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

Application Expressエンジンは、データベース表に格納されたデータに基づいて、ページを動的にレンダリングおよび処理します。レンダリングされたアプリケーションを表示するには、アプリケーションを実行するか、またはApplication Expressエンジンに送信します。新しいページを作成したら、そのページを個別に実行するか、またはアプリケーション全体を実行できます。

- 「アプリケーションの実行」および「ページの実行」ボタン

- アプリケーションの実行方法にブラウザが及ぼす影響

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

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

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

- ページ・デザイナでのページの実行

- コンポーネント・ビューでのページの実行

2.4.1 「アプリケーションの実行」および「ページの実行」ボタン

「アプリケーションの実行」ボタンはアプリケーションのホームページに表示され、緑色の実行(または再生)ボタンがあるアプリケーション・ウィンドウと同様になります。アプリケーションのホームページからアプリケーションを実行するには、「アプリケーションの実行」をクリックします。

「ページの実行」ボタンは小さい灰色の再生ボタンのような形をしており、アプリケーション・ビルダー内の多くのページの右上に表示されます。「ページの実行」ボタンをクリックすると、カレント・ページまたは最後に選択したページが実行されます。

2.4.2 アプリケーションの実行方法にブラウザが及ぼす影響

アプリケーションを実行すると、そのアプリケーションは新しいウィンドウに表示されます。その新しいウィンドウが新しいタブになるか新しいブラウザ・ウィンドウになるかは、Webブラウザをどのように構成しているかによって異なります。Google ChromeまたはApple Safariを使用している場合、デフォルトでは、実行中のアプリケーションは新しいタブに表示されます。Microsoft Internet ExplorerまたはMozilla Firefoxを使用している場合、デフォルトでは、アプリケーションは新しいブラウザ・ウィンドウに表示されます。アカウントのプリファレンスを編集することによって、アプリケーション実行時にOracle Application Expressがタブおよびウィンドウを管理する方法をさらに制御できます。

関連項目:
「ユーザー・プリファレンスの編集」

2.4.3 アプリケーション・ビルダーのホームページからのアプリケーションの実行

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

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

2. 「レポートの表示」アイコンをクリックします(オプション)。
「レポートの表示」を選択すると、各アプリケーションがレポート内の1行として表示されます。各行には、アプリケーションID、アプリケーション名、アプリケーション・ページ数および更新情報が含まれます。

3. 実行するアプリケーションに移動します。

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

- 「レポート」ビュー - 右端の列にある「ページの実行」アイコンをクリックします。

- 「アイコン」ビュー - ページ上部にある「アプリケーションの実行」アイコンをクリックします。

アプリケーションが新しいウィンドウに表示されます。

関連項目:
「アプリケーションの実行方法にブラウザが及ぼす影響」

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

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

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

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

3. ページ中央にある「アプリケーションの実行」アイコンをクリックします。
アプリケーションが新しいウィンドウに表示されます。

関連項目:
「アプリケーションの実行方法にブラウザが及ぼす影響」

2.4.5 アプリケーションのホームページでのページの実行

「ページ」リストからページを実行するには、次のステップを実行します。

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

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

3. 「レポートの表示」アイコンをクリックします。
「レポートの表示」を選択すると、各ページがレポート内の1行として表示されます。各行には、ページ番号、ページ名、ページの最終更新日、ページの最終更新者、ページ・タイプ、選択したユーザー・インタフェース、「ロック」アイコンおよび「実行」ボタンが含まれます。

4. 実行するページに移動します。

5. 右端の列にある「ページの実行」をクリックします。
アプリケーションが新しいウィンドウに表示されます。

関連項目:
「ページのロックおよびロック解除」および「アプリケーションの実行方法にブラウザが及ぼす影響」

2.4.6 ページ・デザイナでのページの実行

ページ・デザイナでページを実行するには、右上隅にある「ページの保存と実行」ボタンをクリックします。「ページの保存と実行」ボタンは、青い右向きの矢印の形です。

関連項目:
「ページ・デザイナでのページの実行」

2.4.7 コンポーネント・ビューでのページの実行

コンポーネント・ビューでページを実行するには、右上隅にある「ページの実行」ボタンをクリックします。

関連項目:
「コンポーネント・ビューでのアプリケーションまたはページの実行」

2.5 ページ・プロセスおよびページ・レンダリングの仕組み

アプリケーション・ビルダーでアプリケーションを作成する場合、タブ、ナビゲーション・メニュー、ボタンまたはハイパーテキスト・リンクを使用してページをリンクします。各ページにはボタンおよびアイテムを配置でき、アプリケーション・ロジックを含めることができます。ページでは、条件付きナビゲーションを使用したあるページから次のページへのブランチ、計算および検証の実行、およびレポート、カレンダおよびチャートの表示を行うことができます。組込みウィザードを使用してレポート、チャートおよびフォームを生成したり、静的HTMLを生成したり、PL/SQLプログラミングによってカスタム・レンダリングを行うことができます。

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

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

- ユーザー・アイデンティティの確認について

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

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

Application Expressエンジンは、Oracle Database表に格納されたデータに基づいて、ページを動的にレンダリングおよび処理します。レンダリングされたアプリケーションを表示するには、Application ExpressエンジンからURLを使用してそれをリクエストします。アプリケーションを実行すると、Application Expressエンジンによって次の2つのプロセスが使用されます。

- ページ表示は、ページ・レンダリング・プロセスです。このプロセスによって、すべてのページ属性(リージョン、アイテム、ボタンなど)が表示可能なHTMLページに編成されます。

- ページ受入れでは、ページの処理が行われます。このプロセスによって、すべての計算、検証、プロセスおよびブランチが実行されます。

URLを使用してページをリクエストする場合、エンジンはページ表示を実行します。ページを送信すると、Application Expressエンジンはページ受入れまたはページ・プロセスを実行します(その間に、送信された値をセッション・キャッシュに保存し、計算、検証または処理を実行します)。

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

この項では、アプリケーションで条件を使用して、ページおよびページ・コンポーネントの表示やプロセス、計算および検証の実行を制御する方法について説明します。

- 条件の概要

- 条件の選択

- 条件の例: 式1のカレント・ページ

- 条件の例: 存在する

- 条件の例: PL/SQL式

関連項目:

2.5.2.1 条件の概要

条件とは、リージョン、アイテム、ボタンおよびタブの表示と、プロセス、計算および検証の実行を制御するために役立つ、小さいロジックの単位です。たとえば、ボタンに条件を適用すると、レンダリング・エンジンによって、レンダリング(ページ表示)プロセス中にその条件が評価されます。条件に合格するかどうかによって、ボタンが表示されるかどうかが決まります。

関連項目:
使用可能な条件タイプの詳細なリストは、「使用可能な条件」を参照してください

2.5.2.2 条件の選択

条件を指定するには、条件タイプを選択します。条件タイプは、コントロールまたはコンポーネントを最初に作成するとき、または後でコントロールまたはコンポーネントを編集するときに選択できます。

選択した条件のタイプに応じて、表示されるフィールドに適切な値を入力します。条件は、入力した値に基づいてtrueまたはfalseに評価されます。任意のコンポーネントまたはコントロールに使用可能なすべての条件のリストを表示するには、選択リストをクリックします。

2.5.2.3 条件の例: 式1のカレント・ページ

式1のカレント・ページは、カレント・ページ番号が、指定されたカンマで区切られたページ・リストに含まれている場合にtrueと評価されます。次に例を示します。

3,100,203

カレント・ページが100である場合、この条件はtrueに評価され、条件に合格します。

2.5.2.4 条件の例: 存在する

「存在する(SQL問合せが1行以上を戻す)」は、SQL問合せとして表現されます。問合せで1行以上が戻される場合、この条件はtrueと評価されます。次に例を示します。

SELECT 1 FROM employees WHERE department_id = :P101_DEPTNO

この例では、アイテムP101_DEPTNOがバインド変数として参照されます。アプリケーション・プロセスおよびSQL問合せリージョン内でバインド変数を使用すると、セッション・ステートからアイテムを参照できます。P101_DEPTNOの値に指定した部門に1人以上の従業員が存在する場合、この条件はtrueと評価されます。

関連項目:
「バインド変数構文を使用したセッション・ステートの参照」

2.5.2.5 条件の例: PL/SQL式

「PL/SQL式」は、trueまたはfalseを評価する式を有効なPL/SQL構文で指定するために使用します。次に例を示します。

NVL(:MY_ITEM,'NO') = 'YES'

前述の例のように、:MY_ITEMの値がYESであれば、この条件はtrueと評価されます。:MY_ITEMの値がYES以外の場合、この条件はfalseと評価されます。

2.5.3 ユーザー・アイデンティティの確認について

認証は、ユーザーのアプリケーションへのアクセスを可能にするために、ユーザーのアイデンティティを証明するプロセスです。認証では、ユーザーにユーザー名とパスワードの入力を求めたり、デジタル証明書や保護キーを使用する場合があります。

Oracle Application Expressは、モジュール認証をサポートしているため、必要に応じて認証メソッドを簡単に切り替えられます。ユーザー・アイデンティティの証明は、いくつかの組込み認証メソッドから選択するか、またはウィザードを使用して独自のカスタム認証方法を作成して実行できます。

関連項目:
「認証を介したユーザーの本人確認」

2.5.4 コントロールおよびコンポーネントへのアクセスの制御について

条件はページ上の特定のコントロールまたはコンポーネントのレンダリングおよび処理を制御しますが、認可スキームはユーザーのアクセスを制御します。認可は、ユーザー権限に基づいてリソースへのアクセスを制御することを示す広義語です。

認可スキームは、認証で証明されたアイデンティティを使用して、その中のアプリケーションおよびオブジェクトに権限を付与します。認可スキームは、アプリケーション全体、各ページ、またはリージョン、アイテム、ボタンなどの特定のページ・コントロールに対して指定できます。たとえば、認可スキームを使用して、ユーザーに表示するタブ、リージョンまたはナビゲーション・バー・エントリを選択的に決定できます。

関連項目:
「認可を介したセキュリティの提供」

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

この項では、Oracle Application Expressでのセッション・ステートメント管理について説明します。

- セッション・ステートの概要

- セッションの概要

- セッションIDについて

- セッション・ステートの参照について

2.6.1 セッション・ステートの概要

Hypertext Transfer Protocol (HTTP)は、HTMLページの配布に最も一般的に使用されるプロトコルであり、ステートレスなプロトコルです。Webブラウザは、ページ全体をダウンロードするために必要な時間のみサーバーに接続します。また、サーバーでは、各ページ・リクエストは、発生済または将来発生する他のページ・リクエストと関連しない個別のイベントとして処理されます。後続のページのあるページに入力したフォーム値にアクセスするには、値をセッション・ステートとして格納する必要があります。Oracle Application Expressは透過的にセッション・ステートを保持するため、開発者は、アプリケーションの任意のページでセッション・ステートの値を取得および設定できます。

2.6.2 セッションの概要

セッションは、ページ・ビュー間で永続性(またはステートフルな動作)を確立する論理的な構成体です。各セッションには、一意の識別子が割り当てられています。Application Expressエンジンは、この識別子(セッションID)を使用して、各ページ・ビューの前後に、アプリケーションで作業中のデータ・セット(セッション・ステート)を格納および取得します。

個々のセッションは相互に完全に独立しているため、任意の数のセッションがデータベース内に同時に存在できます。また、ユーザーは複数のブラウザ・プログラムで、アプリケーションの複数のインスタンスを同時に実行できます。

セッションは、ページ・リクエストの処理に使用されるOracle Databaseセッションとは論理的にも物理的にも異なります。ユーザーは、サインインからサインアウトまでの単一のOracle Application Expressセッションでアプリケーションを実行し、その期間は分または時間で測定される一般的なものとなります。このセッション中にページがリクエストされるたびに、Application ExpressエンジンはOracle Databaseセッションを作成または再利用してデータベース・リソースにアクセスします。多くの場合、これらのデータベース・セッションは、数分の1秒のみ存続します。

関連項目:
Oracle Application Express管理ガイドの「アクティブ・セッションの表示」を参照してください。

2.6.3 セッション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について」

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

Oracle Application Expressアプリケーションの動作は、通常、セッション・ステートの値によって決まります。たとえば、ボタンは、アイテムのセッション・ステートの値に基づいて、条件付きで表示できます。この項では、ページのセッション・ステートを表示する方法について説明します。

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

- セッション・ページの使用

2.6.4.1 ページのセッション・ステートの表示

ページのセッション・ステートを表示するには、次のステップを実行します。

1. 開発者としてアプリケーションを実行します。

2. ページの下部にある開発者ツールバーに移動します。

3. 開発者ツールバーの「セッション」をクリックします。
セッション・ページが表示されます。

関連項目:
「セッション・ページの使用」

2.6.4.2 セッション・ページの使用

セッション・ページは、現在実行中のアプリケーションのセッションに関する有益な情報を提供します。

セッション・ページの表示を制御するには、次のステップを実行します。

1. ページ - ページ番号を入力します。

2. 検索 - 検索する文字列を入力します。

3. 行 - 表示する行数を選択します。

4. 表示 - 表示する情報を選択します。

5. 「設定」をクリックします。
次の情報がページの上部に表示されます。

- アプリケーション - アプリケーション名が表示されます。

- セッション - カレント・セッションのセッションIDが表示されます。

- ユーザー - カレント・ユーザーが表示されます。

- ワークスペース - 現在のワークスペースIDが表示されます。

- ブラウザ言語 - 現在のブラウザ言語が表示されます。

表2-1に、選択した「表示」オプションに応じてセッション・ページに表示される情報を示します。

表2-1 セッション・ページの「表示」オプション

「表示」オプション

説明

「表示」、「ページ・アイテム」

アプリケーションID、ページ番号、アイテム名、アイテムの表示方法(チェック・ボックス、日付ピッカー、表示のみ、テキスト・フィールド、非表示、ポップアップ、ラジオ・グループなど)、セッション・ステートのアイテム値、セッション・ステートのステータス(「挿入」、「更新」、「リセット」など)、アイテムが暗号化されるかなどのページ・アイテムの属性が表示されます。

関連項目: 「ページ・レベル・アイテムの理解」

「表示」、「アプリケーション・アイテム」

アプリケーション・アイテムは、ページに存在しないアイテムです。アプリケーション・アイテムは、関連付けられたユーザー・インタフェース・プロパティを持たないセッション・ステート変数です。

関連項目: アイテム値の参照の詳細は、「アプリケーション・レベル・アイテムの管理」および「置換文字列の理解」を参照してください

「表示」、「セッション・ステート」

アプリケーションID、ページ番号、アイテム名、セッション・ステートのアイテム値、アイテムの表示方法(チェック・ボックス、日付ピッカー、表示のみ、テキスト・フィールド、非表示、ポップアップ、ラジオ・グループなど)、ラベル、暗号化ステータス、データ・アイテムIDなどのセッション・ステートの詳細が表示されます。

「表示」、「コレクション」

現在定義されているコレクションが表示されます。

関連項目: 「コレクションの使用について」

関連項目:
「ページのセッション・ステートの表示」

2.7 URL構文の理解

この項では、Application Expressアプリケーション・ページのURL、f?p構文を使用してページをリンクする方法、およびページの別名またはボタンのURLを使用してページをコールする方法について説明します。

- アプリケーション・ページURLについて

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

- アプリケーションの別名

- ページの別名

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

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

2.7.1 アプリケーション・ページURLについて

ページごとに表示されるURLは、Oracle Application Expressの場所を指定します。また、Oracle Application Expressのアドレス、アプリケーションID、ページ番号およびセッションIDを指定します。次に例を示します。

http://apex.somewhere.com/pls/apex/f?p=4350:1:220883407765693447

この例の内容は次のとおりです。

- http:は、スキームです。

- apex.somewhere.comは、サーバーのドメイン名です。ポート番号またはIPアドレスを含めることもできます。

- plsは、mod_plsqlカートリッジを使用するためのインジケータです(該当する場合)

- apexは、データベース・アクセス記述子(DAD)名です。DADにはHTTP Serverからデータベース・サーバーへの接続方法が記述されているため、HTTPリクエストを実行できます。デフォルト値はapexです。

- f?p=は、リクエストを正しいエンジン・プロセスにルーティングするためにOracle Application Expressによって使用される接頭辞です。

- 4350は、コールされるアプリケーションのIDです。アプリケーションIDは、各アプリケーションを識別する一意の番号です。

- 1は、アプリケーション内のページの番号です。

- 220883407765693447は、セッション番号です。アプリケーションを実行する場合、Application Expressエンジンはユーザーのセッション・ステートに対するキーとして機能するセッション番号を生成します。

関連項目:
「セッション・ステートの管理の理解」および「データベース・アプリケーションURLの公開について」

2.7.2 f?p構文を使用したページのリンクについて

アプリケーションのページ間にリンクを作成するには、次のf?p構文を使用します。

f?p=App:Page:Session:Request:Debug:ClearCache:itemNames:itemValues:PrinterFriendly

表2-2に、f?p構文の使用時に指定できる引数を示します。

表2-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

- LEVELn

- NO

このフラグをYESに設定すると、アプリケーション・プロセスの詳細を表示できます。このフラグをLEVELn (nの範囲は1から9)に設定すると、表示するデバッグの詳細レベルを制御できます。値YESは、LEVEL4と同等です。

DEBUGフラグを参照するには、次の構文を使用します。

- 短縮置換文字列: &DEBUG。

- PL/SQL: V('DEBUG')

- バインド変数: :DEBUG

関連項目: 「アプリケーションのデバッグ」

ClearCache

キャッシュをクリアします。これによりアイテムの値がNULLに設定されます。

キャッシュされたアイテムを単一のページでクリアするには、数値ページ番号を指定します。キャッシュされたアイテムを複数のページでクリアするには、ページ番号のカンマ区切りのリストを使用します。ページのキャッシュをクリアすると、ページのステートフル・プロセスもリセットされます。個別の値またはカンマ区切りの値には、リセットするコレクション名を追加することや、リクエストされたページにおけるリージョンのページ区切りをリセットするためにキーワードRPを追加することができます。キーワードAPPは、すべてのページのキャッシュおよびカレント・アプリケーションにおけるすべてのアプリケーション・レベルのアイテムをクリアし、現行のユーザーのソート・プリファレンスを削除します。キーワードSESSIONはAPPキーワードと同じ結果になりますが、カレント・セッションで使用されたすべてのアプリケーションに関連付けられたアイテムをクリアします。

関連項目: 「セッション・ステートのクリア」

itemNames

URLでセッション・ステートを設定するために使用される、カンマで区切られたアイテム名のリストです。

itemValues

URLでセッション・ステートを設定するために使用されるアイテム値のリストです。アイテム値にカンマを渡すには、文字をバックスラッシュで囲んでください。次に例を示します。

\123,45\

backslash comma (\,)以外のすべての文字列は、バックスラッシュで囲むことができます。

PrinterFriendly

ページを「印刷用」モードでレンダリングするかどうかを決定します。PrinterFriendlyが「はい」に設定されている場合は、ページが「印刷用」モードでレンダリングされます。PrinterFriendlyの値は、リージョンなどの要素をページから削除して印刷される出力を最適化するための条件のレンダリングに使用されます。

印刷用プリファレンスを参照するには、次の構文を使用します。

V('PRINTER_FRIENDLY')

参照すると、印刷用テンプレートを使用してページが表示されます。Application Expressエンジンは、HTMLフォーム・フィールド内のすべてのテキストをテキストとして表示します。印刷用テンプレートには、#FORM_OPEN#タグまたは#FORM_CLOSE#タグは必要ありません。目的は、表をほとんど使用しないで、印刷に適した書式で情報を表示できるようにすることです。

f?p構文の動作を理解しておくことが重要です。アプリケーション・ビルダーには、これらの参照を自動的に作成する多くのウィザードが含まれています。ただし、自分で構文を作成する必要がある場合もあります。次の項では、f?p構文を使用してページをリンクする具体的な場合について説明します。

2.7.3 アプリケーションの別名

アプリケーションの別名は、開発者がアプリケーションIDのかわりに使用できる、一意の英数字の代替アプリケーション識別子です。アプリケーションの別名は、アプリケーション定義を編集して定義します。

関連項目:
「アプリケーション属性の管理」および「アプリケーションおよびページの別名を使用したページのコール」

2.7.4 ページの別名

ページの別名は、ページ番号の代替となる一意の英数字です。開発者は、ページ番号IDのかわりにページの別名を使用できます。ページの別名は、ページ属性を編集して定義します。

関連項目:
「ページ・デザイナでのページ属性の編集」、「コンポーネント・ビューでのページ属性の編集」および「アプリケーションおよびページの別名を使用したページのコール」

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

アプリケーションおよびページの別名は、有効なOracle識別子で構成する必要があります。空白を含めることはできず、また大/小文字は区別されません。次の例では、アプリケーション内から、アプリケーションおよびページの別名を使用してページをコールします。アプリケーションmyappのページhomeが実行され、現行のセッションIDが使用されます。

f?p=myapp:home:&APP_SESSION.

アプリケーションの別名は、ワークスペース内で一意である必要があります。異なるワークスペースのアプリケーションに同じアプリケーション別名がある場合は、&c引数を使用してワークスペース名を指定します。次に例を示します。

f?p=common_alias:home:&APP_SESSION.&c=WORKSPACE_A

関連項目:
「アプリケーションの別名」および「ページの別名」

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

ボタンの作成時に、ユーザーがそのボタンをクリックするとリダイレクトされるURLを指定できます。この例では、アプリケーション6000のページ6001が実行され、現行のセッションIDが使用されます。

f?p=6000:6001:&APP_SESSION.

これは、ボタンを使用するための唯一の方法です。この方法は、ページの送信を省略し、そのページ上のハイパーリンクとして機能します。ボタンをクリックしてページを送信することもできます。その方法では、ボタンをクリックすると、処理するページが送信され、フォームが送信された後、セッション・ステートが保存されます。

関連項目:
「ボタンの作成」および「APP_SESSION」

2.8 ブックマークのサポートの有効化について

以前のリリースでは、アプリケーション内のページが公開されていて認証の必要がない場合、セッションIDとしてゼロを使用することで、ユーザーは容易にページをブックマークできました。この方法は引き続きサポートされていますが、Oracle Application Express、リリース5.0には、このタイプのサポートをページ、アプリケーションまたはインスタンス・レベルで制御できる「セッションを再結合」という新機能が含まれています。詳細は、「「セッションを再結合」について」を参照してください。

関連項目:
『Oracle Application Expressアプリケーション・ビルダー・ユーザーズ・ガイド』、リリース4.2のセッションIDにゼロを使用したブックマークの容易化に関する項

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

インタラクティブな、データに応じて動作するWebアプリケーションを構築するには、セッション・ステート値にアクセスして管理する機能が重要です。Oracle Application Expressでは、セッション・ステートはページごとに自動的に管理され、静的HTML、またはプロセスや検証などのロジック・コントロールによって簡単に参照できます。

- セッション・ステートの参照について

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

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

- バインド変数構文を使用したセッション・ステートの参照

関連項目:
「アイテム値の参照」

2.9.1 セッション・ステートの参照について

リージョン、計算、プロセス、検証およびブランチのセッション・ステートに格納されているアイテム値を参照できます。アイテムはフィールド、テキスト領域、パスワード、選択リスト、チェック・ボックスなどです。表2-3に、アイテム値を参照するためにサポートされている構文を示します。

表2-3 アイテム値を参照するための構文

タイプ

構文

説明

SQL

標準のアイテム構文:

:MY_ITEM

特殊文字を含むアイテム用の構文は次のとおりです。

:"MY_ITEM"

名前が30文字以内のアイテムは、コロン(:)にアイテム名を続けます。この構文は、SQL問合せおよびPL/SQL内の参照用に使用します。

特殊文字、マルチバイト文字またはunicode文字を含むページ・アイテムを参照するには、ページ・アイテム名を二重引用符で囲みます。

PL/SQL

V('MY_ITEM')

Vファンクションを使用してアイテム値を参照するPL/SQL構文を使用します。APEX_UTIL.GET_SESSION_STATEのかわりに、短縮版のVファンクションを使用できます。

ファンクション、トリガー、Oracle Data Redactionポリシーなど、Oracle Databaseオブジェクト内で直接Oracle Application Express変数を使用する場合に、この構文を使用します。

関連項目: Oracle Application Express APIリファレンス

PL/SQL

NV('MY_NUMERIC_ITEM')

NVファンクションを使用して数値アイテム値を参照する標準のPL/SQL構文を使用します。APEX_UTIL.GET_NUMERIC_SESSION_STATEのかわりに、短縮版のNVファンクションを使用できます。

関連項目: Oracle Application Express APIリファレンス

静的テキスト(完全置換)

標準のアイテム構文:

&MY_ITEM.

特殊文字を含むアイテム用の構文は次のとおりです。

&"MY_ITEM".

静的テキストまたは完全置換の場合は、&ITEM_NAMEにピリオド(.)を続けた表記を使用します。

特殊文字、マルチバイト文字またはunicode文字を含むページ・アイテムを参照するには、ページ・アイテム名を二重引用符で囲みます。

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

この項では、アプリケーションのアイテム値を設定し、その結果、セッション・ステートを設定する方法について説明します。

- セッション・ステートの設定について

- フォーム送信によるセッション・ステートの設定について

2.9.2.1 セッション・ステートの設定について

次の方法を使用して、アプリケーションのアイテム値およびセッション・ステートを設定できます。

- フォーム送信。「フォーム送信によるセッション・ステートの設定について」を参照してください。

- バインド変数。「バインド変数構文を使用したセッション・ステートの参照」を参照してください。

- 計算。「アプリケーションの計算の理解」を参照してください。

- f?p構文。「f?p構文を使用したページのリンクについて」を参照してください。

2.9.2.2 フォーム送信によるセッション・ステートの設定について

ページがユーザーによって送信されると、Application Expressエンジンは、フィールド(アイテム)に入力された値をセッション・ステートに自動的に格納します。たとえば、2つのページを持つアプリケーションが存在すると想定します。このアプリケーションの最初のページには、ユーザーが電話番号を入力できるフォームが含まれています。このフォームは、P1_PHONENOという名前のアイテムを作成して定義しています。2番目のページには、ユーザーがフォームに入力する情報を表示する必要があります。

このページが送信されると、Oracle Application Expressによって、電話番号フィールドに入力された値が取得され、今後使用するためにその値が格納されます。2番目のページで、ユーザーが入力した電話番号は、名前P1_PHONE_NOを表2-3「アイテム値を参照するための構文」の適切な構文で使用して、セッション・ステートから取得できます。

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

アプリケーションの開発時に、特定のアイテム、ページ上のすべてのアイテム、アプリケーション内のすべてのページ、または現行のユーザー・セッション用にキャッシュされた値をクリアする必要がある場合があります。キャッシュされた値をクリアすると、その値がNULLにリセットされます。この項では、セッション・ステートのクリアの具体的な例を示します。

- アイテムのキャッシュのクリアについて

- すべてのページ・アイテムのキャッシュのクリア

- 例: アプリケーション全体のキャッシュのクリア

- アプリケーションの完全なリセットについて

- カレント・ユーザー・セッションのキャッシュのクリアについて

2.9.3.1 アイテムのキャッシュのクリアについて

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

2.9.3.2 すべてのページ・アイテムのキャッシュのクリア

アプリケーション・アイテムをキャッシュすると、セッション・ステートを効率的に保持できます。ただし、ページ上のすべてのアイテムのキャッシュをクリアする必要がある場合もあります。たとえば、ユーザーが新しい注文を作成するリンクをクリックすると、ページ上のすべてのフィールドがクリアされるようにする必要があると想定します。ページ全体のキャッシュをクリアすることで、ページ上のすべてのアイテムの値をNULLに設定できます。

- 例: 2つのページのキャッシュのクリアおよびページ区切りのリセット

- 例: ページのキャッシュのクリアおよびアイテム値の引渡し

- 例: ページのセッション・キャッシュのクリアおよび複数のアイテムに対する値の引渡し

2.9.3.2.1 例: 2つのページのキャッシュのクリアおよびページ区切りのリセット

この例では、2つのページのセッション・キャッシュがクリアされ、ページ区切りがリセットされます。

f?p=6000:6003:&APP_SESSION.::NO:RP,6004,6014

この例では、次のようになります。

- アプリケーション6000のページ6003が実行され、現行のセッションIDが使用されます。

- デバッグ情報を表示しないように指示されます(NO)。

- カレント・セッションのキャッシュに保持されたページ6004および6014のアイテムのすべての値がクリアされます。

- ページ6003 (リクエストされたページ)のリージョンのページ区切り(RP)がリセットされます。

2.9.3.2.2 例: ページのキャッシュのクリアおよびアイテム値の引渡し

この例では、更新フォームの実装方法を示します。既存の情報をクリアし、アイテムの値(通常、主キー)を設定します。

f?p=6000:6003:&APP_SESSION.::NO:6003:MY_ITEM:1234

この例では、次のようになります。

- アプリケーション6000のページ6003が実行され、現行のセッションIDが使用されます。

- デバッグ情報を表示しないように指示されます(NO)。

- カレント・セッションのキャッシュに保持されたページ6003のアイテムのすべての値がクリアされます。

- MY_ITEMというアイテムのセッション・ステートの値を1234に設定します。

2.9.3.2.3 例: ページのセッション・キャッシュのクリアおよび複数のアイテムに対する値の引渡し

この例では、更新フォームの実装方法を示します。既存の情報をクリアし、アイテムの値(通常、主キー)を設定し、複数のアイテムに値を渡します。

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に設定されます。

2.9.3.3 例: アプリケーション全体のキャッシュのクリア

この例では、f?p構文を使用し、キーワードAPPを使用してClear Cache引数を作成することで、アプリケーションのキャッシュがクリアされます。

f?p=App:Page:Session::NO:APP

2.9.3.4 アプリケーションの完全なリセットについて

アプリケーション全体のキャッシュをリセットしても、アプリケーションは完全なリセット状態にはリストアされません。たとえば、アプリケーションに新しいインスタンス開始時の計算やプロセスが含まれている場合、Application Expressエンジンは、該当するアプリケーション・セッションが作成されたときに、これらの計算やプロセスを実行します。その後、キャッシュのクリア・リクエストを処理し、リクエストされたページを表示します。

(セッションIDの追跡にCookieが使用されていない場合に)セッションIDを指定せずにアプリケーションを完全にリセットするには、セッションIDを指定せずにURLを使用するか、または別のアプリケーションからAPEX_UTIL.CLEAR_APP_CACHEをコールして、そのアプリケーションをリクエストする必要があります。セッションIDがCookieを使用して追跡される場合、そのステートをリセットするためにログアウトする必要があります。

2.9.3.5 カレント・ユーザー・セッションのキャッシュのクリアについて

アプリケーション・キャッシュをクリアするもう1つの方法は、キーワードSESSIONを使用してClear Cache引数を作成することです。次に例を示します。

f?p=6000:6004:12507785108488427528::NO:SESSION

2.9.4 バインド変数構文を使用したセッション・ステートの参照

この項では、バインド変数構文を使用してセッション・ステートを参照する方法について説明します。

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

- SQL問合せまたはLOVに基づいたリージョンでのバインド変数の使用について

- PL/SQLに基づいたリージョンでのバインド変数の使用について

2.9.4.1 バインド変数構文の使用について

バインド変数構文は、指定したアイテムのセッション・ステートを参照するためにOracle Application ExpressでSQLまたはPL/SQLを使用する場合はいつでも使用できます。次に例を示します。

SELECT * FROM employees WHERE last_name like '%' || :SEARCH_STRING || '%'

この例では、検索文字列がページ・アイテムです。リージョン・タイプがSQL問合せとして定義されている場合、標準SQLバインド変数構文を使用して値を参照できます。バインド変数を使用すると、解析済のSQL問合せがデータベースによって再利用されるため、サーバーによるメモリーの使用が最適化されます。

バインド変数構文を使用する場合は、次の規則に注意してください。

- バインド変数名は、アイテム名に対応している必要があります。

- バインド変数名は、大/小文字が区別されません。

- バインド変数名は、30文字以下である必要があります(有効なOracle識別子である必要があります)。
ページ・アイテム名とアプリケーション・アイテム名は255文字以下に設定できますが、アプリケーション・アイテムをバインド変数構文を使用したSQL内で使用する場合、そのアイテム名は30文字以下で指定する必要があります。

2.9.4.2 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

関連項目:
リージョンの作成の詳細は、「リージョンについて」を参照してください

2.9.4.3 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の値が移入されます。

2.10 置換文字列の理解

この項では、ページ・テンプレート内またはリージョン・ソース内で置換文字列を使用して、文字列を別の値に置換する方法について説明します。ユーザーによるアイテムの編集を可能にするアプリケーションを設計するには、情報を渡すために置換文字列を使用します。

- 置換文字列の使用について

- 置換文字列での出力のエスケープの制御

- テンプレート内での置換文字列の使用方法の確認について

- 組込み置換文字列の使用

2.10.1 置換文字列の使用について

アプリケーション・ビルダーでは、次のように置換文字列を使用できます。

- コンポーネント値を参照するために置換文字列をテンプレート内に含めます。

- &ITEM構文を使用して、ページまたはアプリケーション・アイテムを参照します。

- 組込み置換文字列の使用

テンプレート内の置換文字列

テンプレート内で使用可能な特別な置換文字列は、シャープ記号(#)で示します。次に例を示します。

#ABC#

ページまたはアプリケーション・アイテムの置換文字列

置換変数を使用してページまたはアプリケーション・アイテムを参照するには、次のステップを実行します。

1. すべて大文字でページまたはアプリケーション・アイテムを参照します。

2. アイテム名の先頭にアンパサンド(&)を追加します。

3. アイテム名の末尾にピリオド(.)を追加します。

たとえば、リージョン、リージョン・タイトル、アイテム・ラベル、または静的テキストを使用するその他の多数のコンテキストでF101_Xという名前のアプリケーション・アイテムを参照する場合は、次のように入力します。

&F101_X.

最後にピリオドが必要であることに注意してください。Application Expressエンジンは、置換文字列の値をアイテムF101_Xの値に置き換えます。

2.10.2 置換文字列での出力のエスケープの制御

置換値の特殊文字をエスケープするために、開発者は、ページ名、アプリケーション・アイテム名、レポート列、またはその他の置換文字列に、感嘆符(!)を前に付けた事前定義済フィルタ名を追加できます。出力のエスケープは、ブラウザでクロス・サイト・スクリプティング(XSS)攻撃を回避するための重要なセキュリティ手法です。Oracle Application Expressでは、HTMLまたはJavaScriptコンテキスト内の文字を自動的にエスケープするための最善の努力をすでに行っています。この拡張構文を使用して、開発者は出力を詳細に制御できます。

使用できるエスケープ・フィルタは次のとおりです。

- HTMLは、次に示すように、予約されているHTML文字をエスケープします。

&ITEM!HTML.
#REPORT_COLUMN!HTML#

関連項目:
『Oracle Application Express APIリファレンス』のAPEX_ESCAPE.HTMLに関する説明

- ATTRは、次に示すように、HTML属性コンテキスト内の予約文字をエスケープします。

#REPORT_COLUMN!ATTR#

関連項目:
『Oracle Application Express APIリファレンス』のAPEX_ESCAPE.HTML_ATTRIBUTEに関する説明

- JSは、次に示すように、JavaScriptコンテキスト内の予約文字をエスケープします。

&ITEM!JS.
#REPORT_COLUMN!JS#

関連項目:
『Oracle Application Express APIリファレンス』のAPEX_ESCAPE.JS_LITERALに関する説明

- RAWは、次に示すように、元のアイテム値を保持し、文字をエスケープしません。

&ITEM!RAW.
#REPORT_COLUMN!RAW#

- STRIPHTMLは、次に示すように、HTMLタグを出力から削除し、予約されているHTML文字をエスケープします。

&ITEM!STRIPHTML.
#REPORT_COLUMN!STRIPHTML#

2.10.3 テンプレート内での置換文字列の使用方法の確認について

テンプレートの定義を表示することによって、テンプレート固有のどの置換文字列がどのテンプレートでサポートされるかを確認できます。「カスタム・テーマの作成」を参照してください。

2.10.4 組込み置換文字列の使用

アプリケーション・ビルダーでは、多くの組込み置換文字列がサポートされています。これらの置換文字列を参照して、特定のタイプの機能を実現できます。この項では、使用できる組込み置換文字列、使用する状況および現在サポートされている構文について説明します。

ヒント:
バインド変数:USERはデータベース内で特別な意味を持つことに注意してください。また、直接PL/SQLという用語は、プロシージャおよびファンクションなどのストアド・データベース・オブジェクトで使用可能なPL/SQLを表します。

- APEX$ROW_NUM

- APEX$ROW_SELECTOR

- APEX$ROW_STATUS

- APP_ID

- APP_ALIAS

- APP_AJAX_X01, ... APP_AJAX_X10

- APP_DATE_TIME_FORMAT

- APP_IMAGES

- APP_NLS_DATE_FORMAT

- APP_NLS_TIMESTAMP_FORMAT

- APP_NLS_TIMESTAMP_TZ_FORMAT

- APP_NLS_TIMESTAMP_TZ_FORMAT

- APP_PAGE_ALIAS

- APP_PAGE_ID

- APP_REQUEST_DATA_HASH

- APP_SESSION

- APP_SESSION_VISIBLE

- APP_TITLE

- APP_UNIQUE_PAGE_ID

- APP_USER

- BROWSER_LANGUAGE

- CURRENT_PARENT_TAB_TEXT

- DEBUG

- HOME_LINK

- IMAGE_PREFIX

- LOGIN_URL

- LOGOUT_URL

- PRINTER_FRIENDLY

- PROXY_SERVER

- PUBLIC_URL_PREFIX

- REQUEST

- SCHEMA OWNER

- SQLERRM

- SYSDATE_YYYYMMDD

- WORKSPACE_IMAGES

- WORKSPACE_ID

関連項目:
「置換」および「認証によるユーザー・アイデンティティの証明」

2.10.4.1 APEX$ROW_NUM

APEX$ROW_NUMは、送信された表形式フォーム・データの現在処理されている行番号を参照します。このプレースホルダは、表形式フォームに関連付けられた検証、プロセスおよび条件内で使用して、現在処理されている表形式フォーム行の行番号を参照できます。表2-4に、APEX$ROW_NUMを参照するためにサポートされている構文を示します。

表2-4 APEX$ROW_NUM

参照タイプ

構文

バインド変数

:APEX$ROW_NUM

PL/SQL

V('APEX$ROW_NUM')

置換文字列

&APEX$ROW_NUM.

2.10.4.2 APEX$ROW_SELECTOR

APEX$ROW_SELECTORは、表形式フォームに関連付けられた検証、プロセスおよび条件内で使用して、表形式フォーム内の行セレクタ・チェック・ボックスを参照します。このプレースホルダでは、現在処理されている表形式フォーム行の表形式フォーム行セレクタ・チェック・ボックスが選択されている場合にXが戻され、選択解除されている場合にはNULLが戻されます。表2-5に、APEX$ROW_SELECTORを参照するためにサポートされている構文を示します。

表2-5 APEX$ROW_SELECTOR

参照タイプ

構文

バインド変数

:APEX$ROW_SELECTOR

PL/SQL

V('APEX$ROW_SELECTOR')

置換文字列

&APEX$ROW_SELECTOR.

2.10.4.3 APEX$ROW_STATUS

APEX$STATUSは、表形式フォームに関連付けられた検証、プロセスおよび条件内で使用して、表形式フォーム内の行ステータスを参照します。このプレースホルダでは、現在処理されている表形式フォーム行が作成された場合はC、更新された場合はU、削除された場合はDというステータスが戻されます。表2-6に、APEX$ROW_STATUSを参照するためにサポートされている構文を示します。

表2-6 APEX$ROW_STATUS

参照タイプ

構文

バインド変数

:APEX$ROW_STATUS

PL/SQL

V('APEX$ROW_STATUS')

置換文字列

&APEX$ROW_STATUS.

2.10.4.4 APP_ID

APP_IDは、現在実行されているアプリケーションのアプリケーションIDを示します。表2-7に、APP_IDを参照するためにサポートされている構文を示します。

表2-7 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.

2.10.4.5 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が、カレント・セッションを使用して実行されます。

表2-8に、APP_ALIASを参照するためにサポートされている構文を示します。

表2-8 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>

2.10.4.6 APP_AJAX_X01, ... APP_AJAX_X10

APP_AJAX_Xnnは、「show」モジュールまたは「accept」モジュール内で最も最近に渡されたまたは設定されたAPP_AJAX_X01, ... APP_AJAX_X10 URLパラメータを指定します。通常、これらの変数は「On Demand AJAX」プロセスで使用します。

表2-9に、APP_AJAX_Xnnを参照するためにサポートされている構文を示します。

表2-9 APP_AJAX_Xnn構文

参照タイプ

構文

バインド変数

... :APP_AJAX_X01, ... :APP_AJAX_X10

PL/SQL

... v('APP_AJAX_X01'), ... v('APP_AJAX_X10')

置換文字列

... &APP_AJAX_X01., ... &APP_AJAX_X10.

関連項目:
『Oracle Application Express APIリファレンス』に記載されているAPEX_APPLICATIONのG_X01, ... G_X10変数

2.10.4.7 APP_DATE_TIME_FORMAT

APP_DATE_TIME_FORMATは、アプリケーションの「アプリケーションの日時書式」です。この値には、アプリケーションの「グローバリゼーション」設定の「アプリケーションの日時書式」属性で指定された書式が反映されます。アプリケーションで「アプリケーションの日時書式」が設定されていない場合、APP_DATE_TIME_FORMATへの参照はデータベース・セッションのNLS日付書式とNLS時刻書式を返します。表2-10に、APP_DATE_TIME_FORMATを参照するためにサポートされている構文を示します。

表2-10 APP_DATE_TIME_FORMAT構文

参照タイプ

構文

バインド変数

:APP_DATE_TIME_FORMAT

PL/SQL

V('APP_DATE_TIME_FORMAT')

置換文字列

&APP_DATE_TIME_FORMAT.

2.10.4.8 APP_IMAGES

この置換文字列を使用して、特定のアプリケーションに固有で、複数のアプリケーションでは共有されていないアップロードされたイメージ、JavaScriptおよびカスケード・スタイルシートを参照します。ファイルをアップロードして、そのファイルをアプリケーション固有に設定した場合は、この置換文字列またはバインド変数を使用する必要があります。表2-11に、APP_IMAGESを参照するためにサポートされている構文を示します。

表2-11 APP_IMAGES構文

参照タイプ

構文

バインド変数

:APP_IMAGES

直接PL/SQL

使用不可。

PL/SQL

V('APP_IMAGES')

置換文字列

&APP_IMAGES.

テンプレート置換

#APP_IMAGES#

関連項目:
「IMAGE_PREFIX」、「WORKSPACE_IMAGES」および「イメージの管理について」

2.10.4.9 APP_NLS_DATE_FORMAT

APP_NLS_DATE_FORMATは、データベース・セッションの「アプリケーション日付書式」です。この値には、アプリケーションの「グローバリゼーション」設定の「アプリケーション日付書式」属性で指定された書式が反映されます。ただし、「アプリケーション日付書式」が設定されていない場合、APP_NLS_DATE_FORMATは、Application Expressエンジンへのリクエストの開始時にデータベース・セッションのNLS_DATE_FORMAT値を返します。表2-12に、APP_NLS_DATE_FORMATを参照するためにサポートされている構文を示します。

表2-12 APP_NLS_DATE_FORMAT構文

参照タイプ

構文

バインド変数

:APP_NLS_DATE_FORMAT

PL/SQL

V('APP_NLS_DATE_FORMAT')

置換文字列

&APP_NLS_DATE_FORMAT.

2.10.4.10 APP_NLS_TIMESTAMP_FORMAT

APP_NLS_TIMESTAMP_FORMATは、データベース・セッションの「アプリケーションのタイムスタンプ書式」です。この値には、アプリケーションの「グローバリゼーション」設定の「アプリケーションのタイムスタンプ書式」属性で指定された書式が反映されます。ただし、「アプリケーションのタイムスタンプ書式」が設定されていない場合、APP_NLS_TIMESTAMP_FORMATは、Application Expressエンジンへのリクエストの開始時にデータベース・セッションのNLS_TIMESTAMP_FORMAT値を返します。表2-13に、APP_NLS_TIMESTAMP_FORMATを参照するためにサポートされている構文を示します。

表2-13 APP_NLS_TIMESTAMP_FORMAT構文

参照タイプ

構文

バインド変数

:APP_NLS_TIMESTAMP_FORMAT

PL/SQL

V('APP_NLS_TIMESTAMP_FORMAT')

置換文字列

&APP_NLS_TIMESTAMP_FORMAT.

2.10.4.11 APP_NLS_TIMESTAMP_TZ_FORMAT

APP_NLS_TIMESTAMP_TZ_FORMATは、データベース・セッションのアプリケーションの「アプリケーションのタイムスタンプ・タイムゾーン書式」です。この値には、アプリケーションの「グローバリゼーション」設定の「アプリケーションのタイムスタンプ・タイムゾーン書式」属性で指定された書式が反映されます。ただし、「アプリケーションのタイムスタンプ・タイムゾーン書式」が設定されていない場合、APP_NLS_TIMESTAMP_TZ_FORMATは、Application Expressエンジンへのリクエストの開始時にデータベース・セッションのNLS_TIMESTAMP_TZ_FORMAT値を返します。表2-14に、APP_NLS_TIMESTAMP_TZ_FORMATを参照するためにサポートされている構文を示します。

表2-14 APP_NLS_TIMESTAMP_TZ_FORMAT構文

参照タイプ

構文

バインド変数

:APP_NLS_TIMESTAMP_TZ_FORMAT

PL/SQL

V('APP_NLS_TIMESTAMP_TZ_FORMAT')

置換文字列

&APP_NLS_TIMESTAMP_TZ_FORMAT.

2.10.4.12 APP_PAGE_ALIAS

APP_PAGE_ALIASは、カレント・アプリケーション・ページの英数字の名前です。ページの別名は大/小文字が区別されず、これはオプションのページ属性です。APP_PAGE_ALIASは、アプリケーション内で一意です。APP_PAGE_ALIASは、APP_PAGE_IDを使用できる場所であればほぼすべての場合に使用できます。表2-16に、APP_PAGE_IDを参照するためにサポートされている構文を示します。

表2-15 APP_PAGE_ALIAS構文

参照タイプ

構文

バインド変数

:APP_PAGE_ALIAS

PL/SQL

v('APP_PAGE_ALIAS')

置換文字列

&APP_PAGE_ALIAS.

次に、HTMLの例を示します。

カレント・ページの別名は、&APP_PAGE_ALIASです。

2.10.4.13 APP_PAGE_ID

APP_PAGE_IDは、カレント・アプリケーション・ページIDです。たとえば、アプリケーションが3ページ目に存在した場合、結果は3になります。この構文の使用は、複数のアプリケーションで汎用的に動作する必要があるアプリケーション・コンポーネントを記述する場合に有効です。表2-16に、APP_PAGE_IDを参照するためにサポートされている構文を示します。

表2-16 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.

2.10.4.14 APP_REQUEST_DATA_HASH

APP_REQUEST_DATA_HASHは、URLのリクエスト、アイテム名およびアイテム値部分のハッシュ値です。主に、2つのブラウザ・リクエストによって異なるパラメータがAPEXに渡されたかどうかを検出する場合に役立ちます。表2-17に、APP_REQUEST_DATA_HASHを参照するためにサポートされている構文を示します。

表2-17 APP_SESSION構文

参照タイプ

構文

バインド変数

:APP_REQUEST_DATA_HASH

PL/SQL

V('APP_REQUEST_DATA_HASH')

置換文字列

&APP_REQUEST_DATA_HASH.

2.10.4.15 APP_SESSION

APP_SESSIONは、最もよく使用される組込み置換文字列です。この置換文字列を使用して、セッション番号を渡すことによりセッション・ステートを維持するアプリケーション・ページ間のハイパーテキスト・リンクを作成できます。APP_SESSIONのかわりに置換文字列SESSIONを使用することもできます。表2-18に、APP_SESSIONを参照するためにサポートされている構文を示します。

表2-18 APP_SESSION構文

参照タイプ

構文

バインド変数

:APP_SESSION

PL/SQL

V('APP_SESSION')

短縮PL/SQL

V('SESSION')

置換文字列

&APP_SESSION.

SYS_CONTEXT変数

SYS_CONTEXT('APEX$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,'click me') FROM DUAL;

- SYS_CONTEXT変数の使用:

SELECT ... WHERE apex_session_id = SYS_CONTEXT('APEX$SESSION', 'APP_SESSION')

Oracle Application Expressでは、着信リクエストの処理を開始するとき、APEX$SESSIONコンテキストを設定します。たとえば、'APP_SESSION'の値を使用して、問合せおよび表データを保護するVPD (仮想プライベート・データベース)セキュリティ・ポリシーでカレント・アプリケーション・セッションにアクセスできます。

2.10.4.16 APP_SESSION_VISIBLE

APP_SESSION_VISIBLEは、組込み置換APP_SESSIONに似ています。この置換文字列を使用して、セッション番号を渡すことによりセッション・ステートを維持するアプリケーション・ページ間のハイパーテキスト・リンクを作成します。ユーザーがアプリケーションへ認証されていない場合およびOracle Application Expressのゼロ・セッションID機能を使用している場合、APP_SESSION_VISIBLEは、常にゼロを返します。表2-19に、APP_SESSION_VISIBLEを参照するためにサポートされている構文を示します。

表2-19 APP_SESSION_VISIBLE構文

参照タイプ

構文

バインド変数

:APP_SESSION_VISIBLE

PL/SQL

V('APP_SESSION_VISIBLE')

置換文字列

&APP_SESSION_VISIBLE.

次に例を示します。

- HTMLリージョン内からの参照:

<a href="f?p=100:5:&APP_SESSION_VISIBLE.">click me</a>

- PL/SQLを使用した参照:

sys.htf.anchor('f?p=100:5:'||V('APP_SESSION_VISIBLE'),'click me');

- SQL問合せを使用した参照:

SELECT sys.htf.anchor('f?p=100:5:'||:APP_SESSION_VISIBLE,'clickme') FROM DUAL;

2.10.4.17 APP_TITLE

APP_TITLEは、カレント・アプリケーションの英数字のタイトルです。タイトルは、APP_TITLEというアプリケーション置換文字列から導出されます。定義されていない場合は、「ロゴ」属性が使用されます(タイプがテキストの場合)。いずれもない場合は、アプリケーション名が使用されます。表2-20に、APP_TITLEを参照するためにサポートされている構文を示します。

表2-20 APP_TITLE構文

参照タイプ

構文

バインド変数

:APP_TITLE

PL/SQL

v('APP_TITLE')

置換文字列

&APP_TITLE.

次に、HTMLの例を示します。

The title of the current application is: &APP_TITLE!HTML.

2.10.4.18 APP_UNIQUE_PAGE_ID

APP_UNIQUE_PAGE_IDは、各ページ・ビューに固有なOracle順序から生成される整数です。この数値は、アプリケーションでの重複ページの送信を防止するために使用され、その他の用途にも使用できます。たとえば、一意のURLを作成してブラウザのキャッシュの問題を防止するために、この数値を、fプロシージャへのコール内のリクエスト列またはデバッグ列に埋め込むことができます。表2-21に、APP_UNIQUE_PAGE_IDを参照するためにサポートされている構文を示します。

表2-21 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が一意になり、ブラウザによる過度のキャッシュの問題を回避できます。

2.10.4.19 APP_USER

APP_USERは、アプリケーションを実行しているカレント・ユーザーです。認証モデルに応じて、ユーザーの値の設定も異なります。アプリケーションがデータベース認証を使用して実行されている場合、ユーザーの値はデータベースの擬似列USERと同じになります。アプリケーションが、ユーザー認証を必要とする認証スキームを使用する場合、APP_USERの値はその認証スキームによって設定され、通常は、認証時に使用されるユーザー名に設定されます。表2-22に、APP_USERを参照するためにサポートされている構文を示します。

表2-22 APP_USER構文

参照タイプ

構文

バインド変数

:APP_USER

PL/SQL

V('APP_USER')

置換文字列

&APP_USER.

SYS_CONTEXT変数

SYS_CONTEXT('APEX$SESSION', '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

- SYS_CONTEXT変数の使用:

SELECT ... WHERE username = SYS_CONTEXT('APEX$SESSION', 'APP_USER')

Oracle Application Expressでは、着信リクエストの処理を開始するとき、APEX$SESSIONコンテキストを設定します。たとえば、'APP_USER'の値を使用して、問合せおよび表データを保護するVPD (仮想プライベート・データベース)セキュリティ・ポリシーでカレント・アプリケーション・ユーザーにアクセスできます。

関連項目:
パブリック・ユーザー属性の詳細は、「認証」を参照してください。

2.10.4.20 AUTHENTICATED_URL_PREFIX

このアプリケーション・レベルの属性は、有効な認証済接頭辞(ログインしているURLの接頭辞)を示します。相対パスまたはhttpで始まるフルパスを使用できます。このアイテムは、アプリケーションが認証済(ログイン済)モードとパブリック(未ログイン)・モードの両方で実行可能な場合に有効です。AUTHENTICATED_URL_PREFIXを使用すると、認証済のページへのリンクを作成できます。このアイテムは、Basicデータベース認証の使用時に最も有効です。これは、URLの変更に認証が必要になる場合があるためです。表2-23に、AUTHENTICATED_URL_PREFIXを参照するためにサポートされている構文を示します。

表2-23 AUTHENTICATED_URL_PREFIX構文

参照タイプ

構文

バインド変数

:AUTHENTICATED_URL_PREFIX

PL/SQL

V('AUTHENTICATED_URL_PREFIX')

置換文字列

&AUTHENTICATED_URL_PREFIX.

2.10.4.21 BROWSER_LANGUAGE

BROWSER_LANGUAGEは、Webブラウザの現行の言語プリファレンスを参照します。表2-24に、BROWSER_LANGUAGEを参照するためにサポートされている構文を示します。

表2-24 BROWSER_LANGUAGE構文

参照タイプ

構文

バインド変数

:BROWSER_LANGUAGE

直接PL/SQL

APEX_APPLICATION.G_BROWSER_LANGUAGE

PL/SQL

V('BROWSER_LANGUAGE')

置換文字列

&BROWSER_LANGUAGE.

2.10.4.22 CURRENT_PARENT_TAB_TEXT

CURRENT_PARENT_TAB_TEXTは、ページ・テンプレートで最も有効です。ただし、この文字列は、2つのレベルのタブ(親タブと標準タブ)が使用されるアプリケーションでのみ使用できます。この文字列は、親タブ・ラベルの参照に使用します。この置換文字列を使用すると、現在選択されている親タブを、ページ・テンプレート内で繰り返すことができます。表2-25に、CURRENT_PARENT_TAB_TEXTを参照するためにサポートされている構文を示します。

表2-25 CURRENT_PARENT_TAB_TEXT構文

参照タイプ

構文

バインド変数

使用不可。

置換文字列

&CURRENT_PARENT_TAB_TEXT.

2.10.4.23 DEBUG

DEBUGフラグの有効値はYesまたはNoです。デバッグを有効にすると、アプリケーション・プロセスの詳細が表示されます。カスタム・コードを記述する場合は、デバッグ・モードがYesに設定されている場合にのみデバッグ情報を生成できます。表2-26に、DEBUGを参照するためにサポートされている構文を示します。

表2-26 DEBUG構文

参照タイプ

構文

バインド変数

:DEBUG

直接PL/SQL

APEX_APPLICATION.G_DEBUG

PL/SQL

V('DEBUG')

置換文字列

&DEBUG。

次に、DEBUGの現行の値を保持する置換文字列の参照の例を示します。

f?p=100:1:&APP_SESSION.::&DEBUG

2.10.4.24 HOME_LINK

HOME_LINKは、アプリケーションのホームページです。ページが指定されておらず、かつ認証スキームのロジックによって代替ページが指定されていない場合、Application Expressエンジンによって、この場所にリダイレクトされます。ホーム・リンクはアプリケーション属性ページに定義します。

表2-27に、HOME_LINKを参照するためにサポートされている構文を示します。

表2-27 HOME_LINK構文

参照タイプ

構文

直接PL/SQL

APEX_APPLICATION.G_HOME_LINK

PL/SQL

V('HOME_LINK')

テンプレート参照

#HOME_LINK#

置換文字列

&HOME_LINK.

関連項目:
ホーム・リンク属性については、「認証」を参照してください。

2.10.4.25 IMAGE_PREFIX

IMAGE_PREFIXの値によって、Oracle Application Expressによって配布されたイメージ・ディレクトリを指すためにWebサーバーが使用する仮想パスが決まります。アップロードされたイメージを参照する場合は、WORKSPACE_IMAGESおよびAPP_IMAGESを使用します。表2-28に、IMAGE_PREFIXを参照するためにサポートされている構文を示します。

関連項目:
「APP_IMAGES」、「WORKSPACE_IMAGES」および「アプリケーション属性の編集」

表2-28 IMAGE_PREFIX構文

参照タイプ

構文

バインド変数

:IMAGE_PREFIX

直接PL/SQL

APEX_APPLICATION.G_IMAGE_PREFIX

PL/SQL

V('IMAGE_PREFIX')

置換文字列

&IMAGE_PREFIX.

テンプレート置換

#IMAGE_PREFIX#

2.10.4.26 LOGIN_URL

現在ログインしていないユーザー用のログイン・ページへのリンクを表示するには、LOGIN_URLを使用します。表2-29に、LOGIN_URLを参照するためにサポートされている構文を示します。

関連項目:
「認証」および「セキュリティ属性ページ」

表2-29 LOGIN_URL構文

参照タイプ

構文

バインド変数

:LOGIN_URL

直接PL/SQL

APEX_APPLICATION.G_LOGIN_URL

PL/SQL

V('LOGIN_URL')

置換文字列

&LOGIN_URL.

テンプレート置換

#LOGIN_URL#

2.10.4.27 LOGOUT_URL

LOGOUT_URLはアプリケーション・レベルの属性であり、ログアウトURLの指定に使用されます。これは、ユーザーをログアウト・ページにナビゲートさせるか、またはオプションで直接ユーザーをログアウトさせるURLです。ログアウト・ナビゲーション・バー・エントリを作成するには、&LOGOUT_URLの最後にピリオドを追加します(&LOGOUT_URL.)。ページ・テンプレートをコーディングしている場合は、#LOGOUT_URL#を使用します。表2-30に、LOGOUT_URLを参照するためにサポートされている構文を示します。

表2-30 LOGOUT_URL構文

参照タイプ

構文

バインド変数

:LOGOUT_URL

PL/SQL

V('LOGOUT_URL')

置換文字列

&LOGOUT_URL.

テンプレート置換

#LOGOUT_URL#

2.10.4.28 PRINTER_FRIENDLY

PRINTER_FRIENDLYの値によって、Application Expressエンジンが印刷表示モードで実行するかどうかが決まります。この設定は、印刷されたドキュメントに不要な要素をページから排除するための条件で参照できます。表2-31に、PRINTER_FRIENDLYを参照するためにサポートされている構文を示します。

表2-31 PRINTER_FRIENDLY構文

参照タイプ

構文

直接PL/SQL

APEX_APPLICATION.G_PRINTER_FRIENDLY (VARCHAR2 DATATYPE)

PL/SQL

V('PRINTER_FRIENDLY')

置換文字列

&PRINTER_FRIENDLY.

2.10.4.29 PROXY_SERVER

PROXY_SERVERは、アプリケーション属性です。この属性は、ソースがURLであるリージョンによって使用される場合があります。次に、直接PL/SQL参照用の適切な構文を示します。この参照は、データベースからリモートWebサーバーにアクセスするためのPL/SQLを記述する場合に使用します(たとえば、データベースに付属するutl_httpパッケージを使用する場合)。

APEX_APPLICATION.G_PROXY_SERVER

2.10.4.30 PUBLIC_URL_PREFIX

PUBLIC_URL_PREFIXは、アプリケーション・レベルの属性であり、ログイン・モードをパブリック表示に切り替えるURLを指定します。表2-32に、PUBLIC_URL_PREFIXを参照するためにサポートされている構文を示します。

表2-32 PUBLIC_URL_PREFIX構文

参照タイプ

構文

バインド変数

:PUBLIC_URL_PREFIX

PL/SQL

V('PUBLIC_URL_PREFIX')

置換文字列

&PUBLIC_URL_PREFIX.

テンプレート置換

#PUBLIC_URL_PREFIX#

2.10.4.31 REQUEST

REQUESTの値は、各アプリケーション・ボタンによって、そのボタンの名前またはそのボタンに関連付けられているリクエスト値属性に設定され、これにより、受入れ処理が可能になり、ユーザーがボタンをクリックすると、そのボタンの名前を参照するようになります。f?p構文では、REQUESTは4つ目の引数を使用して設定できます。

REQUESTは、通常、受入れプロセス(ページのポスト時に発生するプロセス)中に参照されます。表2-33に、REQUESTを参照するためにサポートされている構文を示します。

表2-33 REQUEST構文

参照タイプ

構文

バインド変数

:REQUEST

直接PL/SQL

APEX_APPLICATION.G_REQUEST

PL/SQL

V('REQUEST')

置換文字列

&REQUEST.

関連項目:
「REQUESTの使用」

2.10.4.32 REQUESTの使用

REQUESTは、通常、受入れプロセス(ページのポスト時に発生するプロセス)中に参照されます。この項では、REQUEST置換文字列の使用方法に関する追加情報について説明します。

- ポストされたページのREQUESTの有効範囲および値について

- 「対象ボタン」属性について

- 宣言条件を使用したREQUESTの参照について

- 表示プロセスでのREQUESTの使用について

- BRANCH_TO_PAGE_ACCEPTの使用について

関連項目:
「REQUEST」

2.10.4.32.1 ポストされたページのREQUESTの有効範囲および値について

ページをポストすると、受入れプロセスが起動されます。受入れプロセスは、計算、検証、プロセスおよびブランチで構成されています。REQUESTの値は、受入れプロセスの各フェーズで使用可能です。アプリケーションが別のページにブランチされると、REQUESTはNULLに設定されます。

REQUESTの値は、ユーザーがクリックするボタンの名前か、またはユーザーが選択するタブの名前です。たとえば、名前がCHANGEでラベルがApply Changeというボタンがあるとします。ユーザーがこのボタンをクリックすると、REQUESTの値がCHANGEになります。

2.10.4.32.2 「対象ボタン」属性について

検証、プロセスおよびブランチには「対象ボタン」属性があります。この属性は、選択リストとして表示され、カレント・ページにあるボタン名を含みます。「対象ボタン」から選択した場合、ボタンのREQUEST値を検証、プロセスまたはブランチに関連付けます。

ページの送信にボタンを使用する場合、REQUEST値がページに渡されます。受入れプロセス・ロジックにより、「対象ボタン」属性を使用する各検証、プロセスおよびブランチが評価され、コンポーネントを実行(起動)するかどうかが決定されます。コンポーネントの1つが実行される場合、関連付けられたボタンをユーザーが実際にクリックしてページが送信されたとはみなさないでください。同じリクエスト値を使用する別のボタンがページを送信した可能性があります。同様に、ページのJavaScriptもページを送信してリクエスト値を渡します。

2.10.4.32.3 宣言条件を使用したREQUESTの参照について

多くの開発者は、条件を使用してREQUESTを参照します。たとえば、ユーザーがレポート・ページ上の「実行」をクリックしたときにページ区切りをリセットする必要がある場合があります。ページ区切りは、送信時ページ・プロセスを作成してリセットできます。ページ・プロセスには、条件「リクエスト=式1」を使用して条件を付けることができます。

送信時ページ・プロセスに条件を設定するには、次のステップを実行します。

1. 「条件」で、条件タイプ「リクエスト=式1」を選択します。

2. 式1で「実行」を実行します。

2.10.4.32.4 表示プロセスでの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ツールキット・パッケージへのコールであることに注意してください。

関連項目:
『Oracle Database開発ガイド』(PL/SQLを使用したWebアプリケーションの開発に関する情報)および『Oracle Database PL/SQLパッケージおよびタイプ・リファレンス』

2.10.4.32.5 BRANCH_TO_PAGE_ACCEPTの使用について

表示プロセスで特殊なリクエストBRANCH_TO_PAGE_ACCEPTを使用して、自動的にページを送信できます。次に例を示します。

f?p=100:1:&APP_SESSION.:BRANCH_TO_PAGE_ACCEPT|SAVE:::P1_DATA:value

BRANCH_TO_PAGE_ACCEPTの使用は、ページ1にナビゲートし、アイテムP1_DATAに値を入力し、SAVEリクエストでページを送信するボタンをクリックすることと同じです。

2.10.4.33 SCHEMA OWNER

PL/SQLコードからアプリケーションへのコールを生成する場合、Oracle Application Expressスキーマの所有者を参照する必要があります。次に、直接PL/SQLの参照用の適切な構文を示します。

APEX_APPLICATION.G_FLOW_SCHEMA_OWNER

また、#FLOW_OWNER#を使用してSQL問合せおよびPL/SQL(リージョンやプロセスなど)でこの値を参照することもできます。

2.10.4.34 SQLERRM

SQLERRMは、アプリケーション・リージョン・エラー・メッセージでのみ使用可能なテンプレート置換です。次に、リージョン・テンプレート置換の参照用の適切な構文を示します。

#SQLERRM#

2.10.4.35 SYSDATE_YYYYMMDD

SYSDATE_YYYYMMDDは、データベース・サーバーの現在の日付にYYYYMMDD書式マスクを適用して表示します。この値を、SYSDATE()ファンクションを繰り返しコールするかわりに使用できます。次のリストに、SYSDATE_YYYYMMDDを参照するためにサポートされている構文を示します。

- バインド変数

:SYSDATE_YYYYMMDD

- PL/SQL

V('SYSDATE_YYYYMMDD')

- 直接PL/SQL

APEX_APPLICATION.G_SYSDATE (DATE DATATYPE)

表2-34 SYSDATE_YYYYMMDD構文

参照タイプ

構文

バインド変数

:SYSDATE_YYYYMMDD

直接PL/SQL

APEX_APPLICATION.G_SYSDATE (DATE DATATYPE)

PL/SQL

V('SYSDATE_YYYYMMDD')

2.10.4.36 WORKSPACE_IMAGES

この置換文字列を使用して、ワークスペース内の複数のアプリケーションで共有されているアップロードされたイメージ、JavaScriptおよびカスケード・スタイルシートを参照します。表2-35に、WORKSPACE_IMAGESを参照するためにサポートされている構文を示します。

表2-35 WORKSPACE_IMAGES構文

参照タイプ

構文

バインド変数

:WORKSPACE_IMAGES

直接PL/SQL

使用不可

PL/SQL

V('WORKSPACE_IMAGES')

置換文字列

&WORKSPACE_IMAGES.

テンプレート置換

#WORKSPACE_IMAGES#

関連項目:
「APP_IMAGES」および「IMAGE_PREFIX」

2.10.4.37 WORKSPACE_ID

ワークスペースIDを参照するには、この置換文字列を使用します。表2-36に、WORKSPACE_IDを参照するためにサポートされている構文を示します。

表2-36 WORKSPACE_ID構文

参照タイプ

構文

バインド変数

:WORKSPACE_ID

PL/SQL

V('WORKSPACE_ID')

置換文字列

&WORKSPACE_ID.

SYS_CONTEXT変数

SELECT ... WHERE workspace_id = SYS_CONTEXT('APEX$SESSION', ''WORKSPACE_ID')

次に例を示します。

- HTMLリージョン内からの参照:

Hello your workspace id is &WORKSPACE_ID.

- PL/SQLを使用した参照:

htp.p('Hello your workspace id is '||V('WORKSPACE_ID'));

- バインド変数の使用:

SELECT * FROM some_table WHERE workspace_id = :WORKSPACE_ID

- SYS_CONTEXT変数の使用:

SELECT ... WHERE workspace_id = SYS_CONTEXT('APEX$SESSION', 'WORKSPACE_ID')

Oracle Application Expressでは、着信リクエストの処理を開始するとき、APEX$SESSIONコンテキストを設定します。たとえば、'WORKSPACE_ID'の値を使用して、問合せおよび表データを保護するVPD (仮想プライベート・データベース)セキュリティ・ポリシーで現在のワークスペースID値にアクセスできます。

3 パッケージ・アプリケーションの使用

この項では、Oracle Application Expressで使用可能なパッケージ・アプリケーションをインストールして実行する方法について説明します。

- パッケージ・アプリケーションについて

- 完全開発環境でのパッケージ・アプリケーションの管理

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

- AnyCo IT部門Webシートの理解

- 「パッケージ・アプリケーションのみ」ワークスペースの使用

関連項目:
『Oracle Application Express管理ガイド』のデモンストレーション・オブジェクトの作成の無効化に関する項およびサンプルWebシート・オブジェクトの作成の無効化に関する項

3.1 パッケージ・アプリケーションについて

パッケージ・アプリケーション・ギャラリには、3つのタイプのパッケージ・アプリケーションが含まれています。

- サンプル・アプリケーション - グループ名が示すように、Oracle提供のサンプル・アプリケーションは完全なアプリケーションではなく、かわりにコード・スニペットやサンプル・コードが含まれています。サンプル・アプリケーションはワークスペースでのインストールに使用でき、デフォルトで編集可能です。

- パッケージ・アプリケーション - パッケージ・アプリケーションは、完全に機能するアプリケーションで、特定のビジネス要件に対応するように設計されています。パッケージ・アプリケーションをそのままインストールして実行および使用することも、それを分析して特定のタイプの機能を作成する方法の理解に役立てることもできます。パッケージ・アプリケーションはワークスペースでのインストールに使用できますが、デフォルトで編集可能ではありません。

- カスタム・アプリケーション - カスタム・パッケージ・アプリケーションは、ユーザーが作成し、インスタンス管理者が管理するアプリケーションです。Oracle提供のパッケージ・アプリケーションと同様に、カスタム・パッケージ・アプリケーションには、通常、アプリケーション・ページとサポートするデータベース・オブジェクトの両方が含まれています。開発者は、アプリケーション・エクスポートを使用してカスタム・アプリケーションを作成します。エクスポート後、インスタンス管理者がアップロードして使用可能にします。カスタム・アプリケーションはワークスペースでのインストールに使用できますが、デフォルトで編集可能ではありません。

サンプルとパッケージ・アプリケーションの間の主な相違点は、サポート・レベルです。デフォルトでは、サンプル・アプリケーションは完全に編集可能です。対照的に、生産性アプリケーションを編集するには、そのロックを解除する必要があります。アプリケーションのロックを解除すると、そのアプリケーションは今後のアップグレードまたはOracleサポートによるサポートを受けられなくなります。

関連項目:
『Oracle Application Express管理ガイド』のカスタム・アプリケーションの管理に関する項

3.2 完全開発環境でのパッケージ・アプリケーションの管理

この項では、完全開発環境でパッケージ・アプリケーションを表示、インストール、実行、削除、ロック解除、エクスポート、認証変更および更新する方法について説明します。

- パッケージ・アプリケーション・ギャラリの表示

- パッケージ・アプリケーション・ダッシュボードの表示

- パッケージ・アプリケーションのインストール

- インストールしたパッケージ・アプリケーションの実行

- インストールしたパッケージ・アプリケーションの削除

- インストールしたパッケージ・アプリケーションの認証の変更

- インストールした生産性アプリケーションのロック解除

- パッケージ・アプリケーションの更新

関連項目:
『Oracle Application Express管理ガイド』のカスタム・アプリケーションの管理に関する項および「「パッケージ・アプリケーションのみ」ワークスペースの使用」

3.2.1 パッケージ・アプリケーション・ギャラリの表示

パッケージ・アプリケーションを表示、インストール、実行、削除、ロック解除、エクスポート、認証変更および更新するには、パッケージ・アプリケーション・ギャラリ・ページを使用します。

パッケージ・アプリケーション・ギャラリにアクセスするには、次のステップを実行します。

1. ワークスペースのホームページで、「パッケージ・アプリケーション」アイコンをクリックします。
パッケージ・アプリケーション・ページが表示されます。

2. 「パッケージ・アプリケーション・ギャラリ」アイコンをクリックします。
パッケージ・アプリケーション・ギャラリが表示されます。

3. アプリケーションを検索するには、次のステップを実行します。

1. ページ上部の「検索」フィールドに検索語を入力します。
検索結果が表示されます。

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

パッケージ・アプリケーションの詳細ページが表示され、アプリケーションに関するサマリー情報が表示されます。実際に表示されるオプションは、アプリケーションがインストールされているかどうかによって異なります。

4. アプリケーションがインストールされていない場合は、「アプリケーションのインストール」をクリックしてインストールします。

5. アプリケーションが現在インストールされている場合は、「管理」をクリックしてアプリケーション認証を変更するか、アプリケーションを削除します。

関連項目:
「パッケージ・アプリケーションのインストール」、「インストールしたパッケージ・アプリケーションの削除」、「インストールしたパッケージ・アプリケーションの認証の変更」、「インストールした生産性アプリケーションのロック解除」および「パッケージ・アプリケーションの更新」

3.2.2 パッケージ・アプリケーション・ダッシュボードの表示

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

1. ワークスペースのホームページで、「パッケージ・アプリケーション」アイコンをクリックします。
パッケージ・アプリケーション・ページが表示されます。

2. 「ダッシュボード」アイコンをクリックします。
パッケージ・アプリケーション・ダッシュボード・ページが表示され、現在のワークスペース内のパッケージ・アプリケーションに関するメトリック(パッケージ・アプリケーションの合計数、インストールされているパッケージ・アプリケーション、インストールされていないパッケージ・アプリケーションおよびアップグレード対象のアプリケーションなど)が表示されます。

3.2.3 パッケージ・アプリケーションのインストール

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

1. パッケージ・アプリケーション・ギャラリにアクセスします。「パッケージ・アプリケーション・ギャラリの表示」を参照してください。

2. インストールするアプリケーションを探します。

ヒント:
表示を絞り込むには、ページ上部の「検索」フィールドを使用します。

3. インストールするアプリケーションをクリックします。
パッケージ・アプリケーションの詳細ページが表示されます。

4. 「アプリケーションのインストール」をクリックします。

5. 認証スキームを選択し、「次へ」をクリックします。

6. 「アプリケーションのインストール」を再度クリックします。
パッケージ・アプリケーションの詳細ページが表示されます。ページ上部に、成功メッセージApplication installed,が表示されます。

7. アプリケーションを実行するには、「実行」アイコンをクリックします。「インストールしたパッケージ・アプリケーションの実行」を参照してください。

8. 「管理」をクリックします。
「管理」ダイアログに次の3つのボタンが表示されます。

- 認証の変更 - 「インストールしたパッケージ・アプリケーションの認証の変更」

- ロック解除 - 「インストールした生産性アプリケーションのロック解除」を参照してください。

注意:
「ロック解除」オプションは、「パッケージ・アプリケーションのみ」ワークスペースでは使用できません。

- 削除 - 「インストールしたパッケージ・アプリケーションの削除」

ヒント:
パッケージ・アプリケーションをインストールすると、パッケージ・アプリケーション・ページの「インストールしたパッケージ・アプリケーション」に表示されます。

3.2.4 インストールしたパッケージ・アプリケーションの実行

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

1. ワークスペースのホームページで、「パッケージ・アプリケーション」アイコンをクリックします。
パッケージ・アプリケーション・ページが表示されます。

2. 「インストールしたパッケージ・アプリケーション」で、インストールするアプリケーションを探し、「実行」アイコンをクリックします。

ヒント:
インストールしたパッケージ・アプリケーションは、パッケージ・アプリケーション・ギャラリまたはアプリケーション・ビルダーから実行することもできます。

3. 適切な資格証明を入力します。

1. ユーザー名: ワークスペース・ユーザー名を入力します。

2. パスワード: ワークスペース・パスワードを入力します。

3. 「サインイン」をクリックします。

アプリケーションが新しいウィンドウに表示されます。

関連項目:
「アプリケーションの実行方法にブラウザが及ぼす影響」

3.2.5 インストールしたパッケージ・アプリケーションの削除

インストールしたパッケージ・アプリケーションを削除するには、次のステップを実行します。

1. ワークスペースのホームページで、「パッケージ・アプリケーション」アイコンをクリックします。
パッケージ・アプリケーション・ページが表示されます。

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

3. 「インストールしたパッケージ・アプリケーション」リージョンを探します。

4. アプリケーションを探し、「管理」アイコンをクリックします。

5. 「削除」をクリックします。

6. メッセージが表示されたら、「アプリケーションの削除」をクリックします。

ヒント:
このタスクは、アプリケーション詳細ページで実行することもできます。「パッケージ・アプリケーション・ギャラリの表示」を参照してください。

3.2.6 インストールしたパッケージ・アプリケーションの認証の変更

インストールしたパッケージ・アプリケーションの認証を変更するには、次のステップを実行します。

1. ワークスペースのホームページで、「パッケージ・アプリケーション」アイコンをクリックします。
パッケージ・アプリケーション・ページが表示されます。

2. 「インストールしたパッケージ・アプリケーション」リージョンを探します。

3. アプリケーションを探し、「管理」アイコンをクリックします。

4. 「認証の変更」をクリックします。
認証の変更ページが表示されます。

5. 「認証」から、認証スキームを選択し、「変更の適用」をクリックします。

ヒント:
このタスクは、アプリケーション詳細ページで実行することもできます。「パッケージ・アプリケーション・ギャラリの表示」を参照してください。

関連項目:
「認証を介したユーザーの本人確認」

3.2.7 インストールした生産性アプリケーションのロック解除

Oracle提供のサンプルとパッケージ・アプリケーションの間の主な相違点は、サポート・レベルです。パッケージ・アプリケーションをインストールした場合、それを編集するには、ロックを解除する必要があります。デフォルトでは、サンプル・アプリケーションは完全に編集可能です。

注意:
パッケージ・アプリケーションのロックを解除すると、そのアプリケーションは今後のアップグレードまたはOracleサポートによるサポートを受けられなくなります。

インストールしたパッケージ・アプリケーションのロックを解除するには、次のステップを実行します。

1. ワークスペースのホームページで、「パッケージ・アプリケーション」アイコンをクリックします。
パッケージ・アプリケーション・ページが表示されます。

2. 「インストールしたパッケージ・アプリケーション」リージョンを探します。

3. アプリケーションを探し、「管理」アイコンをクリックします。

4. 「ロック解除」をクリックします。
パッケージ・アプリケーションのロック解除ページが表示されます。

5. 「アプリケーションのロック解除」をクリックします。

関連項目:
「パッケージ・アプリケーションのインストール」

3.2.8 パッケージ・アプリケーションの更新

パッケージ・アプリケーションの詳細ページに「更新」ボタンが表示される場合は、パッケージ・アプリケーションを更新できます。

パッケージ・アプリケーションを更新するには、次のステップを実行します。

1. パッケージ・アプリケーション・ギャラリにアクセスします。「パッケージ・アプリケーション・ギャラリの表示」を参照してください。
パッケージ・アプリケーション・ページが表示されます。

2. 更新するアプリケーションを探してクリックします。
パッケージ・アプリケーションの詳細ページが表示されます。

3. 「アプリケーションの更新」をクリックします。
パッケージ・アプリケーションの更新ページが表示されます。

注意:
サンプル・アプリケーションはデフォルトでロック解除されているため、更新できません。Oracle Application Expressリリース5.0で利用可能なユニバーサル・テーマのルック・アンド・フィールにアクセスする場合は、アプリケーションを再インストールしてください。

関連項目:
「インストールしたパッケージ・アプリケーションの実行」

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

この項では、サンプル・パッケージ・アプリケーションである、サンプル・データベース・アプリケーションについて説明します。サンプル・データベース・アプリケーションには、衣料品の注文および顧客情報を表示、更新および検索するための使用しやすいインタフェースがあります。「Home」、「Customers」「Products」、「Orders」および「Reports」ナビゲーション・メニューを使用して、ページ間を移動できます。すべてのサンプル・パッケージ・アプリケーションと同様に、サンプル・データベース・アプリケーションは完全に編集可能です。

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

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

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

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

ヒント:
サンプル・データベース・アプリケーションは、新しい完全ワークスペースで自動的にインストールされます。

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

1. パッケージ・アプリケーション・ギャラリにアクセスします。「パッケージ・アプリケーション・ギャラリの表示」を参照してください。

2. サンプル・データベース・アプリケーションを探します。

ヒント:
表示を絞り込むには、ページ上部の「検索」フィールドを使用します。

3. 「サンプル・データベース・アプリケーション」アプリケーション・イメージをクリックします。
パッケージ・アプリケーションの詳細ページが表示されます。

4. 「アプリケーションのインストール」をクリックします。

5. 認証スキームを選択し、「次へ」をクリックします。

6. 「アプリケーションのインストール」を再度クリックします。
ページ上部に、成功メッセージApplication installedが表示されます。

ヒント:
パッケージ・アプリケーションをインストールすると、パッケージ・アプリケーション・ページの「インストールしたパッケージ・アプリケーション」に表示されます。

7. 「実行」をクリックします。

8. 適切なログイン資格証明を入力します。

1. ユーザー名: ワークスペース・ユーザー名を入力します。

2. パスワード: ワークスペース・パスワードを入力します。

3. 「サインイン」をクリックします。

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

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

- サマリー情報を表示する方法の例。

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

- Oracle Application Expressで使用可能な各種のFlashチャートおよびマップ

- カレンダ・レポート

- デスクトップ・ページで使用可能な機能のほとんどが複製されるモバイル・ページ

この項では、サンプル・データベース・アプリケーションに組み込まれている機能について説明します。

- Homeページ

- Customersページ

- Customersページの使用

- Productsページ

- Productsページの使用

- Ordersページ

- Ordersページの使用

- Reportsページ

- Administrationページ

- モバイル・バージョンへのアクセス

ヒント:
左ナビゲーション・メニューのサイズは、ウィンドウのサイズに応じて変化します。この項の一部の図では、ナビゲーション・メニューが最小化されています。

関連項目:
「アプリケーション・ページの概要」

3.3.2.1 Homeページ

Homeページには、次の主なリージョンがあります。

- Dashboard - バッジ・リスト・プラグインの使用方法を示します。このリージョンには、基礎となるSQL文に基づいた値が表示されます。このリージョンのリンクでは、Monthly Sales、Monthly Orders、Total ProductsおよびTotal Customersに関するレポートに移動します。

- Top Customers - バッジ・リスト・プラグインを示します。このリージョンには、基礎となるSQL文に基づいた値が表示されます。このリージョンのリンクでは、Monthly Sales、Monthly Orders、Total ProductsおよびTotal Customersに関するレポートに移動します。

- Top Products - スライダ・ツールチップ・プラグインを示します。レポートは基礎となるSQL文に基づいており、Customersページに表示される情報のサブセットを示します。ユーザーは、指定した行にカーソルをあわせて詳細なツールチップを表示するか、または顧客名をクリックするか、リージョンの右上隅にある「View Customer」アイコン(右矢印)をクリックすることによって、指定した行に関する追加の詳細情報を表示できます。

- Top Orders by Date - HTML5棒グラフ・プラグインの使用方法を示します。このグラフには、基礎となるSQL文に基づいた日付別の注文と注文金額が表示されます。ユーザーは右上隅の右矢印をクリックすることによって、Ordersページを表示できます。

- Tags - タグ・クラウド・プラグインの使用方法を示します。このリージョンには、基礎となるSQL文に基づいた値が表示されます。このリージョンのリンクでは、選択したタグに一致する検索結果が表示されます。

関連項目:
「レポートの開発」、「チャートの作成」、「コンポーネント・ビューでのリージョンの作成」および「リストの作成」

3.3.2.2 Customersページ

Customersページでは、ユーザーが顧客情報を表示および編集できます。

Customers: 顧客情報を追跡するための対話モード・レポートです。顧客情報を検索するには、「検索」フィールドに検索語を入力し、「実行」をクリックします。顧客名でソートするには、列ヘッダーをクリックし、ソート・アイコンを選択します。

「アクション」メニューを使用してレポートの外観を変更できます。

関連項目:
「エンド・ユーザーとしての対話モード・レポートのカスタマイズ」および「「アクション」メニューについて」

3.3.2.3 Customersページの使用

この項では、Customersページに組み込まれている機能について説明します。

- 顧客の編集

- 顧客の作成

- データのアップロード

3.3.2.3.1 顧客の編集

既存の顧客情報を更新するには、次のステップを実行します。

1. 顧客名をクリックします。

2. Customer Detailsページで、フィールドを編集し、「変更の適用」をクリックします。

3.3.2.3.2 顧客の作成

新しい顧客を追加するには、次のステップを実行します。

1. 「Create Customer」ボタンをクリックします。

2. Customer Detailsページで、フィールドを編集し、「Add Customer」をクリックします。

3.3.2.3.3 データのアップロード

データをアップロードするには、次のステップを実行します。

1. 「データをアップロード」ボタンをクリックします。

2. 「インポート元」で、次のステップを実行します。

1. インポート元: 次のいずれかを選択します。

- ファイルをアップロード(カンマ区切り(*.csv)またはタブ区切り)。選択した場合は、ウィンドウの下部でファイルを選択します。

- コピー・アンド・ペースト。選択した場合は、ウィンドウの下部に「コピー・アンド・ペースト」フィールドが表示されます。

ヒント:
選択したオプションによって、表示される追加フィールドが決まります。サンプル・データを表示するには、サンプル・データ・リージョンを展開します。

2. セパレータ: 列区切り文字を指定します。タブ区切りには\tを使用します。

3. 「囲み文字(オプション)」: 区切り文字を入力します。詳細は、フィールドレベル・ヘルプを参照してください。

4. 1行目に列名がある: 「はい」を選択または選択解除します。サンプル・データを表示するには、サンプル・データ・リージョンを展開します。

5. ファイルの文字セット: 適切なファイルの文字セットを選択します。

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

3. 「データと表のマッピング」でマッピングを確認し、「次へ」をクリックします。

4. 「データのロード」をクリックします。

3.3.2.4 Productsページ

Productsページでは、製品情報を表示および編集できます。「Products」リージョンは、データベースに格納されたイメージを表示するカスタム・ファンクションを使用するSQL問合せに基づいています。

デフォルトでは、このページは「レポート」ビューに表示されます。「アクション」メニューの左側にある「アイコンの表示」および「詳細の表示」をクリックして、表示を変更できます。「レポート」ビューでは、列ヘッダーをクリックし、アイコンを選択して、列でソートできます。「アクション」メニューを使用すればレポートの外観を変更できます。

関連項目:
「エンド・ユーザーとしての対話モード・レポートのカスタマイズ」および「「アクション」メニューについて」

3.3.2.5 Productsページの使用

この項では、Customersページに組み込まれている機能について説明します。

- 製品の編集

- 製品の作成

3.3.2.5.1 製品の編集

既存の製品を更新するには、次のステップを実行します。

1. 製品名をクリックします。

2. Product Detailsページで、フィールドを編集し、「変更の適用」をクリックします。

3.3.2.5.2 製品の作成

新しい製品を追加するには、次のステップを実行します。

1. 「Create Product」ボタンをクリックします。

2. Product Detailsページで、フィールドを編集し、「Add Product」をクリックします。

3.3.2.6 Ordersページ

Ordersページでは、ユーザーが顧客の注文を表示および編集できます。

Ordersは注文情報を追跡するための対話モード・レポートです。列でソートするには、列ヘッダーをクリックし、適切なソート・アイコンを選択します。「アクション」メニューを使用してレポートの外観を変更できます。

関連項目:
「エンド・ユーザーとしての対話モード・レポートのカスタマイズ」および「「アクション」メニューについて」

3.3.2.7 Ordersページの使用

この項では、Ordersページに組み込まれている機能について説明します。

- 注文の編集

- 注文の作成

3.3.2.7.1 注文の編集

注文を編集するには、次のステップを実行します。

1. 注文番号をクリックします。
Order Detailsページが表示されます。

2. Order Detailsページで、フィールドを編集し、「変更の適用」をクリックします。

3. 注文を削除するには、「削除」をクリックします。

3.3.2.7.2 注文の作成

注文を作成するには、次のステップを実行します。

1. 「Enter New Order」ボタンをクリックします。
Enter New Orderウィザードが表示されます。

2. 画面上の指示に従って注文情報を入力します。

3. 「Place Order」をクリックします。

3.3.2.8 Reportsページ

Reportsページでは、棒グラフ、円グラフ、マップ、ツリー、タグなどの様々な書式で情報を表示できます。レポートまたはチャートを表示するには、それを選択します。

関連項目:
「チャートの作成」、「マップの作成」および「ツリーの作成」

3.3.2.9 Administrationページ

Administrationページを使用してサンプル・データを管理するには、状態コードと名前を管理し、ユーザー・フィードバック機能を有効にします。ページの右側のレポートを使用してユーザー・アクティビティを表示し、ページ・ビューを表示し、ページ・ビューを月次カレンダで表示します。

Administrationページには、「Administration」と「Reports」の2つのリージョンがあります。

「Administration」リージョンには、次のセクションがあります。

- Feedback Preference: アプリケーションに対するフィードバックを有効化、無効化および管理します。詳細は、「フィードバックの管理」を参照してください。

- Manage Sample Data: サンプル・データベース・アプリケーションに付属のサンプル・データを削除したり、再作成します。

- Manage States: 状態を追加、編集または削除します。

- Theme Styles: すべてのユーザーのユーザー・インタフェースのテーマ・スタイルを変更します。「テーマ・スタイルの使用」を参照してください。

Reportsリージョンには、次のセクションが含まれます。

- Activity Calendar: ユーザー別のページ・ビューを月次カレンダで表示します。

- Page Views: アプリケーションでのユーザー別のページ・ビューのレポートを表示します。

- Top Users: このアプリケーションのユーザー・アクティビティのレポートを表示します。

3.3.2.10 モバイル・バージョンへのアクセス

Homeページの右上の「モバイル」をクリックすると、モバイル・デバイスと互換性のある形式でサンプル・データベース・アプリケーションが表示されます。このモバイル・バージョンでは、デスクトップ・バージョンで使用可能な機能のほとんどが複製されます。

サンプル・データベース・アプリケーションのモバイル・バージョンにアクセスするには、次のステップを実行します。

1. パッケージ・アプリケーション・ページに移動し、サンプル・データベース・アプリケーションを実行します。「インストールしたパッケージ・アプリケーションの実行」を参照してください。

2. 右上の「モバイル」をクリックします。
サンプル・データベース・アプリケーションのモバイル・バージョンが表示されます。

3. ページを表示するには、それを選択します。

4. 特定の顧客または製品を編集するには、それを選択します。
フォームが表示されます。

5. Homeページに戻るには、左上の「Home」アイコンをクリックします。
ホームページが表示されます。

6. Homeページで、次を実行します。

- サンプル・データベース・アプリケーションのデスクトップ・バージョンに戻るには、「Full Site」をクリックします。

- アプリケーション・ビルダに戻るには、「Logout」をクリックします。

3.3.3 サンプル・データベース・アプリケーションの変更

この項では、サンプル・データベース・アプリケーションを変更する方法について説明します。

- サンプル・データベース・アプリケーションを変更する理由

- 実行時開発者ツールバーの使用について

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

関連項目:
「完全開発環境でのパッケージ・アプリケーションの管理」

3.3.3.1 サンプル・データベース・アプリケーションを変更する理由

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

ヒント:
Oracle Application Expressには、サンプルと生産性アプリケーションの2種類のパッケージ・アプリケーションがあります。デフォルトでは、サンプル・アプリケーションは完全に編集可能です。対照的に、生産性アプリケーションを編集するには、そのロックを解除する必要があります。生産性パッケージ・アプリケーションのロックを解除すると、そのアプリケーションは今後のアップグレードまたはOracleサポートによるサポートを受けられなくなります。

3.3.3.2 実行時開発者ツールバーの使用について

アプリケーション・ビルダーからデスクトップ・アプリケーションを実行する場合は、編集可能な実行中のページの下部に、実行時開発者ツールバーが表示されます。「開発者」ツールバーを使用すると、迅速に、カレント・アプリケーションまたは現在実行されているページを編集したり、セッション・ステートを表示することができます。実行時開発者ツールバーは、アプリケーション定義ページの「可用性」、「ステータス」属性が「開発者ツールバーで使用可能」に設定されている場合にのみ表示されます。

注意:
実行時開発者ツールバーは、ロックされたパッケージ・アプリケーション・ページまたはjQuery Mobileスマートフォン・ページには表示されません。

実行時開発者ツールバーは、次のコントロールで構成されています。

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

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

- 「ページの編集」: 現在実行中のページIDを表示します。表示されるビューは、現在のプリファレンスによって異なります。「ページ・デザイナとコンポーネント・ビューの違いの理解」を参照してください。

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

- デバッグの表示: デバッグ・レポートを表示します。「アプリケーションのデバッグ」を参照してください。

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

- グリッドの表示: 「グリッドの表示」と「グリッドの非表示」を切り替えます。このオプションは、グリッド・レイアウトが使用され、そのレイアウトでグリッドの表示がサポートされ、ページに複数の列がある場合にのみ適用されます。

- クイック編集: 開発者は、「クイック編集」モードを開始し、必要なコンポーネントを選択して、ページ・デザイナでそのコンポーネントに即時にアクセスできます。クイック編集モードを終了するには、[Esc]を押すかコンポーネントの外側をクリックします。

- テーマ・ローラー: カラー・ピッカーから色を選択したり値を設定することで、アプリケーションの外観を簡単にカスタマイズできます。「テーマ・ローラー」をサポートしているテーマにのみ表示されます。「テーマ・スタイルの使用」を参照してください。

- 開発者ツールバー・オプション: 右端に表示され、機械の歯車のような形をしています。次のコントロールを使用して、「開発者」ツールバーの表示方法をカスタマイズできます。

- 自動非表示

- アイコンのみの表示

- 表示位置 (上、左、下、右)

注意:
「開発者」ツールバーは、ロックされたパッケージ・アプリケーション・ページまたはjQuery Mobileスマートフォン・ページには表示されません。

関連項目:
「実行時開発者ツールバー」

3.3.3.3 サンプル・データベース・アプリケーションの編集

実行中のアプリケーションを編集するには、実行時開発者ツールバーの「アプリケーション」リンクをクリックします。アプリケーションのホームページが表示されます。アプリケーションIDとアプリケーション名がページ上部に表示されます。

カレント・アプリケーションの実行、サポートするオブジェクトの編集、共有コンポーネントの作成、またはアプリケーションのエクスポートおよびインポートを行うには、次のアイコンをクリックします。

- アプリケーションの実行: カレント・アプリケーションのページをApplication Expressエンジンに送信し、表示可能なHTMLをレンダリングします。「Application Expressエンジンがページをレンダリングおよび処理する方法」を参照してください。

- サポートするオブジェクト: サポートするオブジェクト・ページにリンクします。「カスタム・パッケージ・アプリケーションの作成方法」を参照してください。

- 共有コンポーネント: アプリケーション内のすべてのページに表示または適用できる共有コンポーネントおよびユーザー・インタフェース・コントロールのリストにリンクします。「共有コンポーネントの管理」を参照してください。

- ユーティリティ: ユーティリティ・ページにリンクします。このページを使用して、開発者アクティビティの監視、ダッシュボードの表示、アドバイザの実行およびその他数多くのレポートの表示を行います。「アプリケーション・ビルダー・ユーティリティの使用」を参照してください。

- エクスポート/インポート: エクスポート/インポート・ウィザードにリンクします。このウィザードを使用して、アプリケーション全体のインポートとエクスポート、およびカスケード・スタイルシート、イメージ、静的ファイル、スクリプト・ファイル、テーマ、ユーザー・インタフェースのデフォルト値、ワークスペース・ユーザーなどの関連ファイルのインポートとエクスポートを行うことができます。「アプリケーションおよびアプリケーション・コンポーネントのエクスポート」を参照してください。

アプリケーションを構成するページがアプリケーションのホームページに表示されます。特定のページにアクセスするには、そのページをクリックします。特定のページを検索するには、「ページ」フィールドにページ・タイトルを入力またはページ名に対して大文字小文字を区別しない問合せを入力して、「実行」をクリックします。

関連項目:
「アプリケーションのホームページの使用」および「コンポーネント・ビューの使用」

3.4 AnyCo IT部門Webシートの理解

この項では、パッケージ・アプリケーション「サンプルWebシート - AnyCo IT部門」について説明します。「サンプルWebシート - AnyCo IT部門」は、Webシートの特徴と機能に焦点を当てています。

- AnyCo IT部門のインストールおよび実行

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

- AnyCo IT部門の理解

- Webシート・コンテンツの変更

関連項目:
『Oracle Application Expressエンド・ユーザー・ガイド』のWebシート・アプリケーションの作成に関する項およびWebシートの使用に関する項

3.4.1 AnyCo IT部門のインストールおよび実行

「サンプルWebシート - AnyCo IT部門」をインストールして実行するには、次のステップを実行します。

1. パッケージ・アプリケーション・ギャラリにアクセスします。「パッケージ・アプリケーション・ギャラリの表示」を参照してください。

2. 「サンプルWebシート - AnyCo IT部門」を探します。

ヒント:
表示を絞り込むには、ページ上部の「検索」フィールドを使用します。

サマリー・ページが表示されます。

3. 「アプリケーションのインストール」をクリックします。

4. 認証スキームを選択し、「次へ」をクリックします。

5. 「アプリケーションのインストール」をクリックします。
成功メッセージが表示されます。

6. アプリケーションを実行するには、「実行」アイコンをクリックします。

7. 適切なログイン資格証明を入力します。

1. ユーザー名: ワークスペース・ユーザー名を入力します。

2. パスワード: ワークスペース・パスワードを入力します。

3. 「サインイン」をクリックします。

ホームページに新しいウィンドウが表示されます。

関連項目:
「アプリケーションの実行方法にブラウザが及ぼす影響」

3.4.2 Webシート・ナビゲーションについて

すべてのWebシートに、ページ内やページ間を簡単に移動するための、共通のナビゲーション要素が含まれています。各Webシート・ページは、セクションに分かれています。セクション・タイトルの左側にある矢印をクリックすると、ページ・セクションを表示したり非表示にすることができます。次の例では、「Systems Overview」は非表示になっています。

3.4.2.1 ブレッドクラムを使用したWebシート・ページ間のナビゲート

ブレッドクラムは、すべてのWebシート・ページの上部に表示されます。「ホーム」ブレッドクラムをクリックすると、Webシートのすべての上位レベル・ページへのリンクのメニューが表示されます。

3.4.3 AnyCo IT部門の理解

「サンプルWebシート - AnyCo IT部門」は、次の機能を示します。

- Webシート・ページを使用したテキスト、データおよびイメージの共有方法の例

- ページ・セクションおよびページ間の階層的なナビゲーション

- 形式が設定されたテキストと、それに含まれる、形式を簡単に設定できるリンク

- データ・グリッドの作成による表形式データの表示、およびレポート、対話モード・レポートまたはチャートとしてのコンテンツの表示

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

- ナビゲーションの理解

- Homeページ

- Project Reviewページ

- Systemsページ

- Planned Purchase Review

- Systems Budget Review

3.4.3.1 ナビゲーションの理解

ホームページの上部に表示される階層ツリーにより、Webシート・ページ間をナビゲートできます。「ホーム」のブレッドクラムの左側にある矢印をクリックすると、ツリーを開閉できます。

セクション内のサブセクション(または子)を表示するには、セクション名の左側にある矢印をクリックします。「すべて開く」をクリックすると、すべてのページおよびページのサブセクションが表示され、「リセット」をクリックすると、ツリーがデフォルト表示に戻ります。別のページにリンクするには、ページ名を選択します。

3.4.3.2 Homeページ

「サンプルWebシート - AnyCo IT部門」のホームページには、次の4つのセクションがあります。

- ページ・ナビゲーション・ツリー

- AnyCo IT Department

- Projects Summary

- Systems Summary

「AnyCo IT Department」は、別のページへのリンクと埋込みイメージが含まれているテキスト・セクションです。

「Projects Summary」は、3Dグラフとして表示されるデータ・グリッドです。棒の上にカーソルを置くと、色が変化し、金額(ドル)が表示されます。

「Systems Summary」は、ハードウェア、ソフトウェアおよびクラウド・サービスのレポートです。セクションの下部には、「Systems Management」レポートおよびSystemsページへのリンクがあります。

3.4.3.3 Projectsページ

プロジェクトには、「Projects Breakdown」という1つのセクションがあります。「Projects Breakdown」セクションには、Project Reviewページへのリンクおよび主なITプロジェクトの更新可能なレポートが含まれています。特定プロジェクトを編集するには、「行の編集」アイコンをクリックします。別のプロジェクトを追加するには、「行の追加」アイコンをクリックします。

3.4.3.4 Project Reviewページ

Project Reviewページには、「Budget Review」および「Task Analysis」という2つのセクションがあります。両セクションとも、異なるタイプの3Dグラフとして表示されるデータ・グリッドです。

3.4.3.5 Systemsページ

Systemsページには、次のセクションがあります。

- Systems (ナビゲーション)

- System Overview

- Systems Maintenance

- Purchasing Projections

「System」は、「Systems Overview」、「Systems Maintenance」および「Purchasing Projections」の各セクションへのリンクが含まれているナビゲーション・セクションです。

「System Overview」は、埋込みイメージおよび他のページへのリンクが含まれているテキスト・セクションです。

「System Maintenance」は、3D横棒グラフとして表示されるデータ・グリッドです。棒の上にカーソルを置くと、色が変化し、金額(ドル)が表示されます。

「Purchasing Projections」には、計画購入のレポートが用意されています。

3.4.3.6 Planned Purchase Review

Planned Purchase Reviewページには、次の2つのセクションがあります。

- Vendor Analysis

- Total Planned Purchases

「Vendor Analysis」は、ベンダーのレポートです。

「Total Planned Purchases」は、3D横棒グラフとして表示されるデータ・グリッドです。棒の上にカーソルを置くと、色が変化し、金額(ドル)が表示されます。

3.4.3.7 Systems Budget Review

Systems Budget Reviewページには、次の2つのセクションがあります。

- Annual Budget Allocation

- Remaining Budget for the Year

「Annual Budget Allocation」は、レポート予算カテゴリです。レポート項目を更新するには、「行の編集」アイコンをクリックします。

「Remaining Budget for the Year」は、3D円グラフとして表示されるデータ・グリッドです。円のセクションの上にカーソルを置くと、金額(ドル)が表示されます。セクションを選択すると、そのセクションが円からわずかに離れます。

3.4.4 Webシート・コンテンツの変更

AnyCo IT部門で使用可能な機能の種類を理解したら、次のステップは、各ページの構成を理解することです。

- サンプルWebシート・アプリケーションを変更する理由

- Webシート・セクションの更新

3.4.4.1 サンプルWebシート・アプリケーションを変更する理由

アプリケーションの分解を分析することが、プロセスを早く理解する効果的な方法です。何かを破損しても、すぐにデモンストレーション・アプリケーションを削除してインストールしなおすことができます。「完全開発環境でのパッケージ・アプリケーションの管理」を参照してください。

ヒント:
Oracle Application Expressには、サンプルと生産性アプリケーションの2種類のパッケージ・アプリケーションがあります。デフォルトでは、サンプル・アプリケーションは完全に編集可能です。対照的に、生産性アプリケーションを編集するには、そのロックを解除する必要があります。生産性パッケージ・アプリケーションのロックを解除すると、そのアプリケーションは今後のアップグレードまたはOracleサポートによるサポートを受けられなくなります。

この後の項では、Webシートの編集に関する高レベルの説明を示します。

関連項目:
「Webシート・アプリケーションの作成」

3.4.4.2 Webシート・セクションの更新

Webシート・セクションを更新するには、次のステップを実行します。

1. 「パッケージ・アプリケーションについて」の説明に従って、Webシートを実行します。

2. セクションの右上に表示される「編集」アイコンをクリックします。

セクションの編集ページが表示されます。特定のセクションを編集する方法は、セクション・タイプによって異なります。

3. 表示されたフィールドを編集します。

4. 書式設定を変更するには、右上隅にあるツールバーの展開アイコンをクリックします。

ツールバーが表示されます。カーソルをアイコンに重ねると、説明ツールチップが表示されます。

5. このツールバーを非表示にするには、ツールバーの折り畳みアイコンをクリックします。

6. 変更を保存するには、「変更の適用」をクリックします。

3.5 「パッケージ・アプリケーションのみ」ワークスペースの使用

注意:
この情報は、Oracle Database Cloud Service (Database Schema)には適用されません。

この項では、「パッケージ・アプリケーションのみ」ワークスペースをリクエストして使用する方法について説明します。

- 「パッケージ・アプリケーションのみ」ワークスペースとは

- 「パッケージ・アプリケーションのみ」ワークスペースのリクエスト

- 「パッケージ・アプリケーションのみ」ワークスペースへのサインイン

- パッケージ・アプリケーション・ギャラリの使用

- パッケージ・アプリケーション管理の使用

3.5.1 「パッケージ・アプリケーションのみ」ワークスペースとは

「パッケージ・アプリケーションのみ」ワークスペースを使用すると、開発者は、他の開発者および管理者とパッケージ・アプリケーションを共有できます。これには、アプリケーション・ビルダーやSQLワークショップなどの開発ツールへのアクセスは含まれていません。「パッケージ・アプリケーションのみ」ワークスペースには、パッケージ・アプリケーション・ギャラリ、パッケージ・アプリケーション・ダッシュボードおよびパッケージ・アプリケーション管理ページが含まれています。

ヒント:
エンド・ユーザーは「パッケージ・アプリケーションのみ」ワークスペースにアクセスできません。エンド・ユーザーは、既存のデータベースまたはWebシート・アプリケーションのみを実行できます。

3.5.2 「パッケージ・アプリケーションのみ」ワークスペースのリクエスト

「パッケージ・アプリケーションのみ」ワークスペースをリクエストするには、次のステップを実行します。

1. Webブラウザで、Oracle Application Expressのサインイン・ページにナビゲートします。
「サインイン」ページが表示されます。

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

3. 「パッケージ・アプリケーションのみ」を選択し、「次へ」をクリックします。

4. 画面に表示されるステップに従います。
詳細は、フィールドレベル・ヘルプを参照してください。

ヒント:
開発コンポーネントへのアクセスを無効化することによって、ワークスペースにアプリケーション・ビルダーなどの開発ツールを含めるかどうかを手動で制御できます。『Oracle Application Express管理ガイド』のワークスペース・プリファレンスの構成に関する項およびインスタンスのコンポーネント可用性の管理に関する項を参照してください。

3.5.3 「パッケージ・アプリケーションのみ」ワークスペースへのサインイン

「パッケージ・アプリケーションのみ」ワークスペースにサインインするには、次のステップを実行します。

1. 「パッケージ・アプリケーションのみ」ワークスペースにサインインします。
ホーム・ページが表示されます。

2. アイコンをクリックします。

- パッケージ・アプリケーション・ギャラリ - パッケージ・アプリケーション・ギャラリ・ページへのリンク。「パッケージ・アプリケーション・ギャラリの使用」を参照してください。

- ダッシュボード - 「パッケージ・アプリケーションのみ」ワークスペースのパッケージ・アプリケーション・ダッシュボードは、完全開発環境で表示されるものと同じです。「パッケージ・アプリケーション・ダッシュボードの表示」を参照してください。

- パッケージ・アプリケーション管理 - パッケージ・アプリケーション管理ページへのリンク。「パッケージ・アプリケーション管理の使用」を参照してください。

3.5.4 パッケージ・アプリケーション・ギャラリの使用

パッケージ・アプリケーション・ギャラリにアクセスするには、次のステップを実行します。

1. 「パッケージ・アプリケーションのみ」ワークスペースにサインインします。

2. 「パッケージ・アプリケーション・ギャラリ」アイコンをクリックします。
パッケージ・アプリケーション・ギャラリが表示されます。

3. アプリケーションを検索するには、「検索」フィールドに検索語を入力します。

4. 表示するアプリケーションを選択します。
パッケージ・アプリケーションの詳細ページが表示されます。このページを使用して、パッケージ・アプリケーション、アプリケーションのインストール、アプリケーションの削除または以前にインストールしたパッケージ・アプリケーションの認証の変更に関する情報を表示します。

ヒント:
サンプル・パッケージ・アプリケーションは、「パッケージ・アプリケーションのみ」ワークスペースでは使用できません。それ以外の、「パッケージ・アプリケーションのみ」ワークスペースのパッケージ・アプリケーション・ギャラリは完全開発環境と同様に動作します。「完全開発環境でのパッケージ・アプリケーションの管理」を参照してください。

3.5.5 パッケージ・アプリケーション管理の使用

この項では、パッケージ・アプリケーション管理ページで使用可能な機能について説明します。

- サービス・リクエストの作成

- ワークスペース・プリファレンスの設定

- ユーザーの管理

- 保存された対話モード・レポートの管理

- 対話モード・レポートのサブスクリプションの管理

- アクティビティ・レポートの表示

- ページ・ビューの表示

- トップ・ユーザーの表示

関連項目:
『Oracle Application Express管理ガイド』のワークスペースとアプリケーションの管理に関する項

3.5.5.1 サービス・リクエストの作成

ヒント:
管理者権限を持つユーザーのみが、この機能にアクセスできます。

追加の記憶域またはサービス停止のサービス・リクエストを作成するには、次のステップを実行します。

1. 「パッケージ・アプリケーションのみ」ワークスペースにサインインします。

2. 「パッケージ・アプリケーション管理」をクリックします。

3. 「サービス・リクエストの作成」をクリックします。

4. リクエストするサービスのタイプを指定するには、次のいずれかを選択します。

- 記憶域のリクエスト

- 終了のリクエスト

ヒント:
ワークスペースで使用可能な空き領域の容量を表示するには、「表領域使用率」を展開し、「表領域使用率の詳細レポート(数秒かかります)」を選択します。

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

3.5.5.2 ワークスペース・プリファレンスの設定

ヒント:
管理者権限を持つユーザーのみが、この機能にアクセスできます。

管理者は、ワークスペース・プリファレンスの設定ページでアカウント・ログイン制御を構成できます。

ワークスペース・プリファレンスを設定するには、次のステップを実行します。

1. 「パッケージ・アプリケーションのみ」ワークスペースにサインインします。

2. 「パッケージ・アプリケーション管理」をクリックします。

3. 「ワークスペース・プリファレンスの設定」をクリックします。

4. 「アカウント・ログイン制御」には、次の項目があります。

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

1. アカウントの有効期限およびロック: Application Expressエンド・ユーザー・アカウントを期限切れにしたりロックできるかどうかを決定するために選択します。この機能は、Application Expressユーザー管理インタフェースを使用して作成されたエンド・ユーザー・アカウントにのみ適用されます。

2. 許可されるログイン失敗の最大回数: エンド・ユーザー・アカウントがロックされるまでに許可される認証の連続失敗の最大回数を正の整数で入力します。このフィールドの値を指定しない場合は、「許可されるログイン失敗の最大回数」のインスタンス・レベルの設定が使用されます。

3. エンドユーザー・アカウント・ライフタイム(日): エンド・ユーザー・アカウントのパスワードを使用できる期限が切れるまでの最大日数を正の整数で入力します。このフィールドの値を指定しない場合は、アカウント・パスワード・ライフタイムのインスタンス・レベルの設定が使用されます。

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

3.5.5.3 ユーザーの管理

ヒント:
管理者権限を持つユーザーのみが、この機能にアクセスできます。このオプションは、「パッケージ・アプリケーションのみ」ワークスペースのみで使用可能であり、完全ワークスペースでは使用できません。

新しいユーザー・アカウントの作成、既存のユーザー・アカウントの管理およびユーザー・パスワードの変更を行うには、「ユーザーの管理」をクリックします。

「パッケージ・アプリケーションのみ」ワークスペースでユーザーを管理するには、次のステップを実行します。

1. 「パッケージ・アプリケーションのみ」ワークスペースにサインインします。

2. 「パッケージ・アプリケーション管理」をクリックします。

3. 「ユーザーの管理」をクリックします。
ユーザーの管理は、「パッケージ・アプリケーションのみ」ワークスペースで、ワークスペースレベルと同様に機能します。

関連項目:
『Oracle Application Express管理ガイド』のワークスペースでのユーザーの管理に関する項

3.5.5.4 保存された対話モード・レポートの管理

パッケージ・アプリケーションのユーザーによって作成された対話モード・レポートを表示および管理するには、「保存されたレポート」をクリックします。

保存された対話モード・レポートを管理するには、次の手順を実行します。

1. 「パッケージ・アプリケーションのみ」ワークスペースにサインインします。

2. 「パッケージ・アプリケーション管理」をクリックします。

3. 「保存されたレポート」をクリックします。
保存された対話モード・レポートの管理は、「パッケージ・アプリケーションのみ」ワークスペースで、ワークスペースレベルと同様に機能します。

関連項目:
『Oracle Application Express管理ガイド』の保存された対話モード・レポートの表示および削除に関する項

3.5.5.5 対話モード・レポートのサブスクリプションの管理

パッケージ・アプリケーションのユーザーによって作成された対話モード・レポートのサブスクリプションを表示および管理するには、「サブスクリプション」をクリックします。

対話モード・レポートのサブスクリプションを管理するには、次の手順を実行します。

1. 「パッケージ・アプリケーションのみ」ワークスペースにサインインします。

2. 「パッケージ・アプリケーション管理」をクリックします。

3. 「サブスクリプション」をクリックします。
対話モード・レポートのサブスクリプションの管理は、「パッケージ・アプリケーションのみ」ワークスペースで、ワークスペースレベルと同様に機能します。

関連項目:
Oracle Application Express管理ガイドの「対話モード・レポートのサブスクリプションの管理」

3.5.5.6 アクティビティ・レポートの表示

個別のユーザーについてレポートするアプリケーション・アクティビティの月次カレンダおよび日別の合計ページ・ビューを表示するには、「アプリケーション・アクティビティ」をクリックします。

「アプリケーション・アクティビティ」レポートを表示するには、次のステップを実行します。

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

2. 「パッケージ・アプリケーション管理」をクリックします。

3. 「アプリケーション・アクティビティ」をクリックします。

3.5.5.7 ページ・ビューの表示

各ビューの対話モード・レポートを表示し、ユーザー、経過時間およびページの詳細を示すには、「ページ・ビュー」をクリックします。

「ページ・ビュー」レポートを表示するには、次のステップを実行します。

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

2. 「パッケージ・アプリケーション管理」をクリックします。

3. 「ページ・ビュー」をクリックします。

3.5.5.8 トップ・ユーザーの表示

ユーザーごとに集計されたページ・ビューのレポートを表示するには、「トップ・ユーザー」をクリックします。

「トップ・ユーザー」レポートを表示するには、次のステップを実行します。

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

2. 「パッケージ・アプリケーション管理」をクリックします。

3. 「トップ・ユーザー」をクリックします。

4 アプリケーション・ビルダーの理解

開発者は、アプリケーション・ビルダーを使用して、Oracle Application Expressアプリケーションを構成するページを作成します。この項では、アプリケーション・ビルダーのユーザー・インタフェースに関する重要なバックグラウンド情報について説明します。

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

- アプリケーション・ビルダーのホームページの使用

- アプリケーションのホームページへのアクセス

- アプリケーションのホームページの使用

関連項目:
「クイック・スタート」および「アプリケーション・ビルダーの概念」

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

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

1. Oracle Application Expressにサインインします。
ワークスペースのホームページが表示されます。

2. 「アプリケーション・ビルダー」アイコンをクリックします。
アプリケーション・ビルダーのホームページが表示されます。

関連項目:
「アプリケーション・ビルダーのホームページの使用」

4.2 アプリケーション・ビルダーのホームページの使用

この項では、アプリケーション・ビルダーのホームページについて説明します。アプリケーション・ビルダーのホームページには、現在のOracle Application Expressインスタンスにインストールされているすべてのアプリケーションが表示されます。

- アプリケーション・ビルダーのホームページのナビゲーション・バー

- 「リセット」および「作成」ボタン

- アプリケーション・ビルダーのホームの「最近」リスト

- 移行リンク

関連項目:
「アプリケーション・ビルダーへのアクセス」および「開発者ナビゲーション・ツール」

4.2.1 アプリケーション・ビルダーのホームページのナビゲーション・バー

アプリケーション・ビルダーのホームページの外観は、ページ上部にあるナビゲーション・バーを使用してカスタマイズできます。

使用可能なコントロールは次のとおりです。

- 検索列の選択: このフィールドには、虫めがねのアイコンが表示されます。このアイコンをクリックして、検索を特定の列のみに絞ります。すべての列を検索するには、「すべての列」を選択します。

- テキスト領域: 大/小文字を区別しない検索基準(ワイルドカード文字を含む)を入力し、「実行」をクリックします。

- 「実行」ボタン: 検索を実行したり、フィルタを適用します。

- アイコンの表示(デフォルト): 各アプリケーションをアプリケーション名で識別される大きいアイコンとして表示します。

- レポートの表示: 各アプリケーションをレポート内の1行として表示します。各行には、アプリケーションID、アプリケーション名、アプリケーションの最終更新日、ページ・カウントおよびアプリケーションの最終更新者が含まれます。

- アクション・メニュー: アクション・メニューを表示します。レポート・ビューをカスタマイズするにはこのメニューを使用します。「「アクション」メニューについて」を参照してください。

4.2.2 「リセット」および「作成」ボタン

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

- リセット。「リセット」をクリックすると、ページがデフォルト表示に戻ります。

- 作成。「作成」をクリックすると、アプリケーションが作成されるか、パッケージ・アプリケーションがインストールされます。「アプリケーションの作成ウィザードの実行について」を参照してください。

4.2.3 アプリケーション・ビルダーのホームの「最近」リスト

「最近」リストがページの右側に表示されます。このリージョンには、最近表示したアプリケーションへのリンクが表示されます。

4.2.4 移行リンク

移行リンクは、ページの右下に表示されます。「移行」リンクをクリックすると、Oracle Application Expressアプリケーション移行ワークショップにアクセスします。移行ワークショップを使用して、Microsoft AccessアプリケーションまたはOracle FormsアプリケーションをOracle Application Expressアプリケーションに移行します。

関連項目:
Oracle Application Expressアプリケーション移行ガイド

4.3 アプリケーションのホームページへのアクセス

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

1. Oracle Application Expressにサインインします。
ワークスペースのホームページが表示されます。

2. 「アプリケーション・ビルダー」アイコンをクリックします。
アプリケーション・ビルダーのホームページが表示されます。

3. アプリケーションのホームページでアプリケーションを選択します。
アプリケーションのホームページが表示されます。

関連項目:
「アプリケーションのホームページの使用」

4.4 アプリケーションのホームページの使用

アプリケーションを選択すると、アプリケーションのホームページが表示されます。アプリケーションのホームページを使用して、アプリケーションの実行、編集、インポート、エクスポート、コピーまたは削除を行います。

- 「アプリケーション・プロパティの編集」ボタン

- アプリケーションのホームページのアイコン

- 「ページの作成」ボタン

- アプリケーションのホームページのナビゲーション・バー

- アプリケーションのホームページのカスタマイズについて

- アプリケーションのホームページの「タスク」リスト

- 最近編集されたページ

関連項目:
「開発者ナビゲーション・ツール」

4.4.1 「アプリケーション・プロパティの編集」ボタン

アプリケーションIDとアプリケーション名が、アプリケーションのホームページ上部に表示されます。アプリケーションIDは、ページ上部のブレッドクラムにも表示されます。

「アプリケーション・プロパティの編集」ボタンは、アプリケーションIDおよび名前の右側に表示されています。「アプリケーション・プロパティの編集」をクリックして、アプリケーション名やアプリケーションの別名などのアプリケーション定義を編集します。

関連項目:
「アプリケーション属性の編集」

4.4.2 アプリケーションのホームページのアイコン

次の大きいアイコンが、アプリケーションIDおよびアプリケーション名の下に表示されます。

- アプリケーションの実行: カレント・アプリケーションのホームページをApplication Expressエンジンに送信し、表示可能なHTMLをレンダリングします。「Application Expressエンジンがページをレンダリングおよび処理する方法」を参照してください。

- サポートするオブジェクト: サポートするオブジェクト・ページにリンクします。「カスタム・パッケージ・アプリケーションの作成方法」を参照してください。

- 共有コンポーネント: アプリケーション内のすべてのページに表示または適用できる共有コンポーネントおよびユーザー・インタフェース・コントロールのリストにリンクします。「共有コンポーネントの管理」を参照してください。

- ユーティリティ: ユーティリティ・ページにリンクします。このページを使用して、開発者アクティビティの監視、ダッシュボードの表示、アドバイザの実行およびその他数多くのレポートの表示を行います。「アプリケーション・ビルダー・ユーティリティの使用」を参照してください。

- エクスポート/インポート: エクスポート/インポート・ウィザードにリンクします。このウィザードを使用して、アプリケーション全体のインポートとエクスポート、およびカスケード・スタイルシート、イメージ、静的ファイル、スクリプト・ファイル、テーマ、ユーザー・インタフェースのデフォルト値、ワークスペース・ユーザーなどの関連ファイルのインポートとエクスポートを行うことができます。「アプリケーションおよびアプリケーション・コンポーネントのエクスポート」を参照してください。

4.4.3 「ページの作成」ボタン

「ページの作成」ボタンをクリックすると、アプリケーションのページを作成するウィザードが起動します。「アプリケーションのホームページからのページの作成」を参照してください。

4.4.4 アプリケーションのホームページのナビゲーション・バー

ナビゲーション・バーはアプリケーションのホームページの中央に表示されます。ナビゲーションを使用して、ページを検索したり、ページの外観をカスタマイズすることができます。

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

- 検索列の選択: このフィールドには、虫めがねのアイコンが表示されます。このアイコンをクリックして、検索を特定の列のみに絞ります。すべての列を検索するには、「すべての列」を選択します。

- テキスト領域: 大/小文字を区別しない検索基準(ワイルドカード文字を含む)を入力し、「実行」をクリックします。

- 「実行」ボタン: 検索を実行したり、フィルタを適用します。

- アイコンの表示: これらのアイコンを使用して、3つのビューを切り替えます。

- アイコンの表示(デフォルト): 各ページをページ名で識別される大きいアイコンとして表示します。

- レポートの表示: 各ページがレポート内の1行として表示されます。各行には、ページID、ページ名、ページの最終更新日、更新者、ページ・タイプ、ユーザー・インタフェースの分類およびグループが含まれます。

- アクション・メニュー: アクション・メニューを表示します。レポート・ビューをカスタマイズするにはこのメニューを使用します。「「アクション」メニューについて」を参照してください。

関連項目:
「アプリケーション・ビルダーのホームページのナビゲーション・バー」

4.4.5 アプリケーションのホームページのカスタマイズについて

アプリケーションのホームページの表示方法を制御するには、「アイコンの表示」アイコン、「レポートの表示」アイコンまたは「詳細の表示」アイコンを選択します。

アイコンの表示(デフォルト): 各ページをアイコンとして表示します。

「レポート」モードでは、各ページがレポート内の1行として表示されます。各行にはページ番号(ID)、ページ名、ページの最新更新時、更新者、ページ・タイプ、関連グループおよびロック・ステータスが含まれます。ページを表示するには、ページIDをクリックします。「ロック」アイコンをクリックすると、アプリケーション開発中の競合を回避できます。「実行」アイコンをクリックすると、関連ページが実行され、表示可能なHTMLがレンダリングされます。

ヒント:
ダイアログ・ページまたはグローバル・ページは直接実行できないため、これらのページに「実行」アイコンは表示されません。

4.4.6 アプリケーションのホームページの「タスク」リスト

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

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

- このアプリケーションの削除: カレント・アプリケーションを削除します。「アプリケーションの削除」を参照してください。

- このアプリケーションのコピー: カレント・アプリケーションのコピーを作成します。「データベース・アプリケーションのコピー」を参照してください。

関連項目:
「アプリケーションのホームページの使用」

4.4.7 最近編集されたページ

「最近編集されたページ」リージョンには、カレント・アプリケーション内の最近編集されたページへのリンクが表示されます。特定のページにリンクするには、ページIDおよびページ名をクリックします。

5 チーム開発によるアプリケーション・ライフサイクルの管理

チーム開発は組込みの開発管理ツールです。このツールを使用すると、新機能、機能に関連しないタスク(つまりTo Do)、バグおよびマイルストンを追跡して、開発プロセスを管理できます。ユーザーはリアルタイム・フィードバックを提供でき、このフィードバックはTo Do、バグまたは機能に分類できます。

- チーム開発のホームページ

- タグ・サマリーの利用について

- 機能の追跡

- マイルストンの追跡

- To Doの追跡

- バグの管理

- フィードバックの管理

- チーム開発ユーティリティの管理

関連項目:
『Oracle Application Express管理ガイド』のチーム開発の管理に関する項

5.1 チーム開発へのアクセス

チーム開発にアクセスするには、次のステップを実行します。

1. Oracle Application Expressにサインインします。
ワークスペースのホームページが表示されます。

2. 「チーム開発」アイコンをクリックします。
チーム開発のホームページが表示されます。

関連項目:
「チーム開発のホームページ」

5.2 チーム開発のホームページ

チーム開発のホームページは、機能、マイルストン、To Do、バグおよびフィードバックを管理する起点となります。

チーム開発のホームページに、次の大きいアイコンが表示されます。

- 「マイルストン」。開発プロセスに関連するイベントを追跡します。マイルストンは、機能、バグおよびTo Doに関連付けることができます。「マイルストンの追跡」を参照してください。

- 「機能」。機能が最初に構想されてから実装されるまでを追跡します。機能は、リリース、割当て先、タグまたは関連付けられたマイルストン別に編成できます。「機能の追跡」を参照してください。

- 「To Do」。割当て、優先度付け、タグ付けおよび追跡が可能なアクション・アイテムを管理します。また、To Doに親タスクを関連付けることもできます。機能またはマイルストンに関連付けることもできますが、それは必須ではありません。「To Doの追跡」を参照してください。

- 「バグ」。ソフトウェアの不具合またはバグを追跡します。バグは、割当て、マイルストンへの関連付けおよび追跡(期日、ステータスなどの属性を使用)が可能です。「バグの管理」を参照してください。

- 「フィードバック」。アプリケーション・ユーザーからリアルタイムのコメント、拡張リクエストおよびバグを収集します。「フィードバックの管理」を参照してください。

「ニュース」リージョン

「ニュース」リージョンを使用して、他の開発者とやりとりします。ニュースを追加したり、他のワークスペース・ユーザーがポストしたニュース・エントリを表示することができます。ニュースは、Application Expressのホームページ、チーム開発のホームページおよびニュース・ページに表示されます。「ニュース・エントリの管理」を参照してください。

「ユーティリティ」リージョン

「ユーティリティ」リージョンはページの右側に表示され、チーム開発のユーティリティ・ページへのクイック・アクセスを提供します。ユーティリティ・ページにアクセスするには、「すべてのユーティリティ」をクリックするか、特定のリンクをクリックします。「チーム開発ユーティリティへのアクセス」を参照してください。

サマリー・リージョン

チーム開発のホームページの下部には、次のサマリー・リージョンがあります。

- 「マイルストン」。最終リリース・マイルストンまでの日数のサマリーが示されます。「マイルストンの追跡」を参照してください。

- 「バグ」。クローズ・バグのサマリーが示されます。「フィードバックの管理」を参照してください。

- 「機能」。機能的に完全な機能の割合が表示されます。「機能の追跡」を参照してください。

- 「To Do」。完了したTo Doの割合が表示されます。「To Doの追跡」を参照してください。

- 「フィードバック」。最新のフィードバック・エントリが表示されます。「フィードバックの管理」を参照してください。

- 「チーム開発のサマリー」。機能、To Do、マイルストン、バグおよびフィードバック・エントリの総数が表示されます。

- 「タグ」。「タグ・サマリーの利用について」を参照してください。

ヒント:
ほとんどのサマリー・リージョンには、右上隅にプラス記号(+)と大なり記号(>)が表示されます。コンポーネントを追加する場合はプラス記号(+)をクリックし、コンポーネント・ダッシュボード・ページにリンクする場合は大なり記号(>)をクリックします。

5.3 タグ・サマリーの利用について

チーム開発のホームページにあるタグ・サマリーには、すべてのチーム開発コンポーネントに関連付けられているすべてのタグの重み付けリストが表示されます。ハイパーリンクをクリックすると、選択したタグが付いたすべてのコンポーネントを示す検索ページが表示されます。タグ・クラウド・サマリーを使用して、チーム開発コンポーネントを効果的に管理できます。

このサマリーに情報を移入するには、各チーム開発コンポーネント(つまり、機能、To Doタスク、バグおよびフィードバック・エントリ)の「タグ」フィールドを編集します。

5.4 機能の追跡

機能ページを使用して、機能が最初に構想されてから実装されるまでを追跡します。機能は、リリース、割当て先、タグまたは関連付けられたマイルストン別に編成できます。

- 機能レポートの表示

- 機能の作成

- 機能の更新

- 機能にファイルを添付する方法

- その他の機能レポートの表示

5.4.1 機能レポートの表示

機能を表示するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「チーム開発」アイコンをクリックします。

2. 「機能」アイコンをクリックします。
機能ダッシュボードが表示されます。機能ダッシュボードには、ワークスペース内で定義されている機能の概要が表示されます。

3. 「割当て先」、「リリース」または「アプリケーション」リストから選択し、「設定」をクリックすることで、表示をカスタマイズできます。

4. 「レポート」タブをクリックします。
機能レポート・ページが表示されます。ページの外観をカスタマイズするには、ページ上部にある検索バーを使用します。

関連項目:
「エンド・ユーザーとしての対話モード・レポートのカスタマイズ」および「機能の更新」

5.4.2 機能の作成

機能を作成するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「チーム開発」アイコンをクリックします。

2. 「機能」アイコンをクリックします。
機能ダッシュボードが表示されます。

3. 「機能の作成」をクリックします。

4. 該当するフィールドに入力します。必須フィールドには、赤いアスタリスク(*)が付いています。
属性の詳細は、フィールドレベル・ヘルプを参照してください。「フィールドレベル・ヘルプの表示」を参照してください。

5. 編集可能な選択リストに新しい値を追加するには、「新規」というタイトルが付いたフィールドに値を入力します。たとえば、「所有者」リストに名前を追加するには、「新規所有者」に値を入力します。
入力した値が追加されます。

6. 「機能の作成」をクリックします。

関連項目:
「フォーカス領域の編集」

5.4.3 親機能の作成について

親機能属性を使用すると、階層的に機能をグループ化できます。親機能を選択すると、親/子関係が作成されます。ツリー・ビューで機能を表示すると、機能は、まずリリースごとにグループ化され、次に、親ごとにグループ化されます。

関連項目:
「機能ツリーの表示」

5.4.4 機能の更新

機能を更新するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「チーム開発」アイコンをクリックします。

2. 「機能」アイコンをクリックします。
機能ダッシュボードが表示されます。

3. 「レポート」タブをクリックします。
レポート・ページが表示されます。

4. 機能を編集するには、機能名をクリックします。

5. 該当するフィールドを編集します。

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

関連項目:
「フォーカス領域の編集」

5.4.5 機能にファイルを添付する方法

ワークスペースレベルで有効にすると、機能にファイルを添付できます。

- 機能へのファイルの添付

- 添付ファイルの表示、編集および削除

関連項目:
「添付ファイルの表示」および『Oracle Application Express管理ガイド』のチーム開発でのファイル・アップロードに対するサポートの有効化に関する項。

5.4.5.1 機能へのファイルの添付

ヒント:
この機能を使用するには、「管理」、「サービスの管理」、「ワークスペース・プリファレンスの設定」で、「ファイル・リポジトリの有効化」属性を「はい」に設定する必要があります。

機能へファイルを添付するには、次の手順を実行します。

1. 機能へナビゲートします。「機能の更新」を参照してください。

2. 「アクション」から、「ファイルの追加」をクリックします。

3. 「ファイルの追加」で、次の項目を指定します。

1. ファイル: アップロードするファイルを探します。

2. 説明: ファイルの説明を入力します。

3. 「ファイルの追加」をクリックします。

「ファイル」という新しいリージョンが「機能」ページの下部に表示されます。

5.4.5.2 添付ファイルの表示、編集および削除

添付ファイルを表示、編集または削除するには、次の手順を実行します。

1. 「機能」ページへナビゲートします。「機能の更新」を参照してください。

2. 「ファイル」までスクロールします。

3. 「ファイルの表示および管理」をクリックします。
「ファイル」ページが表示されます。

4. ファイルを表示するには、名前をクリックします。

5. ファイルの説明を編集するには、「編集」アイコンをクリックします。

6. 添付ファイルを削除するには、赤色の「削除」アイコンをクリックします。

5.4.6 その他の機能レポートの表示

この項では、チーム開発で使用できる機能レポートについて説明します。

- 機能ツリーの表示

- 機能カレンダの表示

- 機能履歴レポートの表示

- 機能進捗ログの表示

- 機能フォーカス領域チャートの表示

- 機能所有者チャートの表示

- 機能ユーティリティ

関連項目:
「チーム開発ユーティリティへのアクセス」

5.4.6.1 機能ツリーの表示

機能ツリーを表示するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「チーム開発」アイコンをクリックします。

2. 「機能」アイコンをクリックします。
機能ダッシュボードが表示されます。

3. 「ツリー」タブをクリックします。
ツリー・ページには、リリースごとの階層ツリーで機能が表示されます。

新しいリリースを選択するには、「リリース」リストから選択し、「設定」をクリックします。機能の数と完了率が、機能名の右側に表示されます。完了率を非表示または表示するには、「完了率を含む」で「はい」または「いいえ」を選択し、「設定」をクリックします。機能を編集するには、機能をクリックします。

機能は、まずリリースごとにグループ化され、次に、親ごとにグループ化されます。グループ化を開くには、機能名の左側にある小さな三角形をクリックします。

ヒント:
指定のリリースごとに機能を表示する場合、異なるリリースに親または子機能を持つ機能は表示されません。

すべてのグループ化を開閉するには、「すべて開く」および「すべて閉じる」ボタンをクリックします。機能を表示または編集するには、機能名をクリックします。機能を作成するには、「機能の作成」をクリックし、オンラインの指示に従います。

5.4.6.2 機能カレンダの表示

機能カレンダを表示するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「チーム開発」アイコンをクリックします。

2. 「機能」アイコンをクリックします。
機能ダッシュボードが表示されます。

3. 「カレンダ」タブをクリックします。
カレンダ・ページには、機能がカレンダ形式で期日別または完了日別に表示されます。

親機能が定義されている場合、カレンダ形式で期日または完了日が表示されます。「前へ」および「次へ」ボタンをクリックして、他の月を表示します。当日の機能マイルストンを表示するには、「今日」をクリックします。特定の機能を表示するには、機能名をクリックします。機能を作成するには、「機能の作成」をクリックし、オンラインの指示に従います。

5.4.6.3 機能履歴レポートの表示

機能履歴レポートを表示するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「チーム開発」アイコンをクリックします。

2. 「機能」アイコンをクリックします。
機能ダッシュボードが表示されます。

3. 「履歴」タブをクリックします。
機能履歴レポートには、最近変更された機能の対話モード・レポートが表示されます。古い値と新しい値および更新者の情報などが含まれます。レポートをカスタマイズするには、ページ上部にある検索バーを使用します。

4. 特定の機能を表示するには、機能名をクリックします。

関連項目:
「エンド・ユーザーとしての対話モード・レポートのカスタマイズ」および「「アクション」メニューについて」

5.4.6.4 機能進捗ログの表示

機能進捗ログを表示するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「チーム開発」アイコンをクリックします。

2. 「機能」アイコンをクリックします。
機能ダッシュボードが表示されます。

3. 「進捗ログ」タブをクリックします。
進捗ログ・ページは、進捗ログ・エントリの対話モード・レポートとして表示されます。レポートをカスタマイズするには、ページ上部にある検索バーを使用します。

4. ログを編集するには、「編集」アイコンをクリックします。

関連項目:
「エンド・ユーザーとしての対話モード・レポートのカスタマイズ」および「「アクション」メニューについて」

5.4.6.5 機能フォーカス領域チャートの表示

機能フォーカス領域チャートを表示するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「チーム開発」アイコンをクリックします。

2. 「機能」アイコンをクリックします。
機能ダッシュボードが表示されます。

3. 「フォーカス領域」タブをクリックします。
フォーカス領域ページには、リリース別に定義されたフォーカス領域ごとの機能数のチャートが表示されます。チャートを変更するには、別のリリースまたは別の割当て先を選択し、「設定」をクリックします。デフォルトのチャートに戻すには、「リセット」をクリックします。

関連項目:
「フォーカス領域の編集」

5.4.6.6 機能所有者チャートの表示

機能所有者チャートを表示するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「チーム開発」アイコンをクリックします。

2. 「機能」アイコンをクリックします。
機能ダッシュボードが表示されます。

3. 「機能所有者」タブをクリックします。
機能所有者ページには、所有者別の機能数のチャートが表示されます。チャートを変更するには、別のリリース、最小ステータスまたは最大ステータスを選択し、「設定」をクリックします。デフォルトのチャートに戻すには、「リセット」をクリックします。

5.4.6.7 機能ユーティリティ

「機能ユーティリティ」を使用します。複数の機能のマイルストンを管理するためのアクション・ページを選択します。次のいずれかを選択し、画面の指示に従います。

- マイルストンを機能(現在マイルストンが割り当てられていないもののみ)に割り当てます。

- 機能の期日をマイルストン日付に設定します(機能のみに影響を及ぼす)。

- 期日を超過した機能のマイルストンを変更します。

- オープンな機能の期限をプッシュします。

関連項目:
「チーム開発ユーティリティへのアクセス」

5.5 マイルストンの追跡

マイルストン・ページを使用して、重要なマイルストンを管理します。マイルストンによってイベントを追跡します。マイルストンは、機能、バグおよびTo Doに関連付けることができます。

- マイルストン・レポートの表示

- マイルストンの作成

- マイルストンの更新

- その他のマイルストン・レポートの表示

5.5.1 マイルストン・レポートの表示

マイルストンを表示するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「チーム開発」アイコンをクリックします。

2. 「マイルストン」アイコンをクリックします。
マイルストン・ダッシュボードが表示されます。

マイルストン・ダッシュボードには、ワークスペース内のマイルストンの概要が表示されます。リリースでフィルタ処理したり、リンクから特定の1つまたは複数のマイルストンを所有者ごとに表示することができます。

3. 「レポート」タブをクリックします。
マイルストン・レポート・ページは、対話モード・レポートとして表示されます。ページの上部にある検索バーを使用して、ページの外観をカスタマイズできます。

関連項目:
「エンド・ユーザーとしての対話モード・レポートのカスタマイズ」および「マイルストンの更新」

5.5.2 マイルストンの作成

マイルストンを作成するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「チーム開発」アイコンをクリックします。

2. 「マイルストン」アイコンをクリックします。
マイルストン・ダッシュボード・ページが表示され、次のリージョンが表示されます。

3. 「マイルストンの作成」をクリックします。

4. 該当するフィールドに入力します。必須フィールドには、赤いアスタリスク(*)が付いています。
属性の詳細は、フィールドレベル・ヘルプを参照してください。「フィールドレベル・ヘルプの表示」を参照してください。

5. 編集可能な選択リストに新しい値を追加するには、「新規」というタイトルが付いたフィールドに値を入力します。たとえば、「所有者」リストに名前を追加するには、「新規所有者」に値を入力します。
入力した値が追加されます。

6. 「マイルストンの作成」をクリックします。

5.5.3 マイルストンの更新

マイルストンを更新するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「チーム開発」アイコンをクリックします。

2. 「マイルストン」アイコンをクリックします。
マイルストン・ダッシュボード・ページが表示され、次のリージョンが表示されます。

3. 「マイルストン」タブをクリックします。
マイルストン・レポート・ページが表示されます。

4. マイルストンを選択します。

5. 該当するフィールドを編集します。
属性の詳細は、フィールドレベル・ヘルプを参照してください。「フィールドレベル・ヘルプの表示」を参照してください。

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

5.5.4 その他のマイルストン・レポートの表示

この項では、チーム開発で使用できるマイルストン・レポートについて説明します。

- マイルストン・カレンダの表示

- 「所有者別のマイルストン」レポートの表示

- 「マイルストン別の機能」レポートの表示

関連項目:
「チーム開発ユーティリティへのアクセス」

5.5.4.1 マイルストン・カレンダの表示

マイルストン・カレンダを表示するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「チーム開発」アイコンをクリックします。

2. 「マイルストン」アイコンをクリックします。
マイルストン・ダッシュボードが表示されます。

3. 「カレンダ」タブをクリックします。
カレンダ・ページには、マイルストンがカレンダ形式で日付別に表示されます。

リリースでフィルタするには、「リリース」リストから選択し、「設定」をクリックします。「前へ」および「次へ」ボタンをクリックして、他の月を表示します。当日のマイルストンを表示するには、「今日」をクリックします。特定のマイルストンを表示するには、ハイパーリンクをクリックします。マイルストンを作成するには、「マイルストンの作成」をクリックしてオンラインの指示に従ってください。

5.5.4.2 「所有者別のマイルストン」レポートの表示

「所有者別のマイルストン」レポートを表示するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「チーム開発」アイコンをクリックします。

2. 「マイルストン」アイコンをクリックします。
マイルストン・ダッシュボードが表示されます。

3. 「所有者別」タブをクリックします。
レポートを変更するには、別のリリースまたはマイルストンを選択し、「設定」をクリックします。デフォルトのチャートに戻すには、「リセット」をクリックします。

5.5.4.3 「マイルストン別の機能」レポートの表示

「マイルストン別の機能」レポートを表示するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「チーム開発」アイコンをクリックします。

2. 「マイルストン」アイコンをクリックします。
マイルストン・ダッシュボードが表示されます。

3. 「マイルストン別の機能」タブをクリックします。
「マイルストン別の機能」レポートは対話モード・レポートとして表示され、各マイルストンに関連する機能が表示されます。ページの上部にある検索バーを使用して、ページの外観をカスタマイズできます。

関連項目:
「エンド・ユーザーとしての対話モード・レポートのカスタマイズ」および「「アクション」メニューについて」

5.6 To Doの追跡

To Doは、機能ではなく作業割当てを追跡します。機能およびマイルストンに関連付けて、完了に必要なタスクを定義できます。To Doはリリース別に編成したり、開発者に割り当てたり、タグを付けることができます。

- To Doの表示

- To Doの作成

- To Doの更新

- To Doにファイルを添付する方法

- その他のTo Doレポートの表示

5.6.1 To Doの表示

To Doを表示するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「チーム開発」アイコンをクリックします。

2. 「To Do」アイコンをクリックします。
To Doダッシュボードが表示されます。「To Do」ダッシュボードには、ワークスペース内のTo Doの概要が表示されます。リリース、割当て先またはアプリケーションでフィルタ処理できます。

3. 「レポート」タブをクリックします。
To Doレポート・ページが表示されます。

To Doページには、現在のタスクの対話モード・レポートが表示されます。ページの上部にある検索バーを使用して、ページの外観をカスタマイズできます。パーソナルTo Doを表示するには、ページの上部にある「To Do」ボタンをクリックします。

関連項目:
「エンド・ユーザーとしての対話モード・レポートのカスタマイズ」および「To Doの更新」

5.6.2 To Doの作成

To Doを作成するには、次の手順を実行します。

1. 「ワークスペース」ホームページで、「チーム開発」アイコンをクリックします。

2. 「To Do」アイコンをクリックします。
To Doダッシュボードが表示されます。

3. 「To Doの作成」をクリックします。

4. 該当するフィールドに入力します。必須フィールドには、赤いアスタリスク(*)が付いています。
属性の詳細は、フィールドレベル・ヘルプを参照してください。「フィールドレベル・ヘルプの表示」を参照してください。

5. 編集可能な選択リストに新しい値を追加するには、「新規」というタイトルが付いたフィールドに値を入力します。たとえば、「割当て先」リストに名前を追加するには、「新規割当て先」に値を入力します。
入力した値が追加されます。

6. 「To Doの作成」をクリックします。

5.6.3 To Doの更新

To Doを更新するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「チーム開発」アイコンをクリックします。

2. 「To Do」アイコンをクリックします。
To Doダッシュボードが表示されます。

3. 「レポート」タブをクリックします。

4. マイルストンを選択します。

5. 該当するフィールドを編集します。

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

5.6.4 To Doにファイルを添付する方法

ワークスペースレベルで有効にすると、To Doにファイルを添付できます。

- To Doへのファイルの添付

- 添付ファイルの表示、編集および削除

関連項目:
「添付ファイルの表示」および『Oracle Application Express管理ガイド』のチーム開発でのファイル・アップロードに対するサポートの有効化に関する項。

5.6.4.1 To Doへのファイルの添付

ヒント:
この機能を使用するには、「管理」、「サービスの管理」、「ワークスペース・プリファレンスの設定」で、「ファイル・リポジトリの有効化」属性を「はい」に設定する必要があります。

To Doにファイルを添付するには、次の手順を実行します。

1. To Doへナビゲートします。「To Doの更新」を参照してください。

2. 「アクション」から、「ファイルの追加」をクリックします。

3. 「ファイルの追加」で、次の項目を指定します。

1. ファイル: アップロードするファイルを探します。

2. 説明: ファイルの説明を入力します。

3. 「ファイルの追加」をクリックします。

「ファイル」という新しいリージョンがページの下部に表示されます。

5.6.4.2 添付ファイルの表示、編集および削除

添付ファイルを管理するには、次の手順を実行します。

1. 「To Do」ページにナビゲートします。「To Doの更新」を参照してください。

2. 「ファイル」までスクロールします。

3. 「ファイルの表示および管理」をクリックします。
「ファイル」ページが表示されます。

4. ファイルを表示するには、名前をクリックします。

5. ファイルの説明を編集するには、「編集」アイコンをクリックします。

6. 添付ファイルを削除するには、「削除」アイコンをクリックします。

5.6.5 その他のTo Doレポートの表示

この項では、チーム開発で使用できるTo Doレポートについて説明します。

- To Doカレンダの表示

- To Do進捗ログの表示

5.6.5.1 To Doカレンダの表示

To Doカレンダを表示するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「チーム開発」アイコンをクリックします。

2. 「To Do」アイコンをクリックします。
To Doダッシュボードが表示されます。

3. 「カレンダ」タブをクリックします。
To Doカレンダが表示されます。

カレンダ・ページには、To Doがカレンダ形式で期日別または完了日別に表示されます。完了ステータスまたはリリースで表示をフィルタするには、「表示」および「リリース」選択リストから選択して「設定」をクリックします。「前へ」および「次へ」ボタンをクリックして、他の月を表示します。当日のTo Doを表示するには、「今日」をクリックします。特定のTo Doを表示するには、To Do名をクリックします。To Doを作成するには、「To Doの作成」をクリックしてオンラインの指示に従ってください。

5.6.5.2 To Do進捗ログの表示

To Doカレンダを表示するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「チーム開発」アイコンをクリックします。

2. 「To Do」アイコンをクリックします。
To Doダッシュボードが表示されます。

3. 「進捗ログ」タブをクリックします。
進捗ログ・ページには、進捗ログ・エントリの対話モード・レポートが表示されます。レポートをカスタマイズするには、ページ上部にある検索バーを使用します。ログを編集するには、「編集」アイコンをクリックします。

関連項目:
「エンド・ユーザーとしての対話モード・レポートのカスタマイズ」および「「アクション」メニューについて」

5.7 バグの管理

バグは、ソフトウェアの不具合を追跡するものです。バグは、割当て、マイルストンへの関連付けおよび追跡(期日、ステータスなどの属性を使用)が可能です。

- バグの表示

- バグの作成

- バグの編集

- バグにファイルを添付する方法

- その他のバグ・レポートの表示

5.7.1 バグの表示

バグを表示するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「チーム開発」アイコンをクリックします。

2. 「バグ」アイコンをクリックします。
バグ・ダッシュボードが表示されます。バグ・ダッシュボードには、ソフトウェアの既知の不具合の概要が表示されます。

3. 「レポート」タブをクリックします。
バグ・レポート・ページに、すべてのバグの対話モード・レポートが表示されます。ページの外観は、ページ上部にある検索バーを使用してカスタマイズできます。バグを編集するには、「編集」アイコンをクリックします。

関連項目:
「エンド・ユーザーとしての対話モード・レポートのカスタマイズ」および「バグの編集」

5.7.2 バグの作成

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

1. 「ワークスペース」ホームページで、「チーム開発」アイコンをクリックします。

2. 「バグ」アイコンをクリックします。
バグ・ダッシュボードが表示されます。

3. 「バグの作成」をクリックします。

4. 該当するフィールドに入力します。必須フィールドには、赤いアスタリスク(*)が付いています。
属性の詳細は、フィールドレベル・ヘルプを参照してください。「フィールドレベル・ヘルプの表示」を参照してください。

5. 編集可能な選択リストに新しい値を追加するには、「新規」というタイトルが付いたフィールドに値を入力します。たとえば、「割当て先」リストに名前を追加するには、「新規割当て先」に値を入力します。
入力した値が追加されます。

6. 「バグの作成」をクリックします。

5.7.3 バグの編集

バグを編集するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「チーム開発」アイコンをクリックします。

2. 「バグ」アイコンをクリックします。
バグ・ダッシュボードが表示されます。

3. 「レポート」タブをクリックします。
バグ・レポート・ページが表示されます。

4. バグを選択します。

5. 該当するフィールドを編集します。
属性の詳細は、フィールドレベル・ヘルプを参照してください。「フィールドレベル・ヘルプの表示」を参照してください。

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

5.7.4 バグにファイルを添付する方法

ワークスペースレベルで有効にすると、バグにファイルを添付できます。

- バグへのファイルの添付

- 添付ファイルの表示、編集および削除

関連項目:
「添付ファイルの表示」および『Oracle Application Express管理ガイド』のチーム開発でのファイル・アップロードに対するサポートの有効化に関する項。

5.7.4.1 バグへのファイルの添付

ヒント:
この機能を使用するには、「管理」、「サービスの管理」、「ワークスペース・プリファレンスの設定」で、「ファイル・リポジトリの有効化」属性を「はい」に設定する必要があります。

バグへファイルを添付するには、次の手順を実行します。

1. バグにナビゲートします。「バグの編集」を参照してください。

2. 「アクション」から、「ファイルの追加」をクリックします。

3. 「ファイルの追加」で、次の項目を指定します。

1. ファイル: アップロードするファイルを探します。

2. 説明: ファイルの説明を入力します。

3. 「ファイルの追加」をクリックします。

「ファイル」という新しいリージョンがページの下部に表示されます。

5.7.4.2 添付ファイルの表示、編集および削除

添付ファイルを管理するには、次の手順を実行します。

1. 「バグ」ページへナビゲートします。「バグの編集」を参照してください。

2. 「ファイル」までスクロールします。

3. 「ファイルの表示および管理」をクリックします。
「ファイル」ページが表示されます。

4. ファイルを表示するには、名前をクリックします。

5. ファイルの説明を編集するには、「編集」アイコンをクリックします。

6. 添付ファイルを削除するには、「削除」アイコンをクリックします。

5.7.5 その他のバグ・レポートの表示

この項では、チーム開発で使用できるバグ・レポートについて説明します。

- バグ・ダッシュボード

- バグ・カレンダの表示

- 開発者ごとのバグの表示

- 日別のバグの表示

5.7.5.1 バグ・ダッシュボード

バグ・ダッシュボードには、ソフトウェアの既知の不具合の概要が表示されます。ダッシュボード・ページには、次のリージョンがあります。

- クローズ率

- 割り当てられた開発者

- 重大度

- ステータス

ダッシュボードを編集するには、ページ上部にある「表示」および「リリース」リストを編集して、「設定」をクリックします。ダッシュボードをデフォルト表示にリセットするには、「リセット」ボタンをクリックします。

5.7.5.2 バグ・カレンダの表示

バグ・カレンダを表示するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「チーム開発」アイコンをクリックします。

2. 「バグ」アイコンをクリックします。
バグ・ダッシュボードが表示されます。

3. 「カレンダ」タブをクリックします。
カレンダ・ページの「表示」リストを使用して、推定クローズ日付のあるオープン・バグ、推定クローズ日付のないオープン・バグまたはクローズ・バグを表示します。「前へ」および「次へ」ボタンをクリックして、他の月を表示します。特定のバグを表示するには、バグの説明をクリックします。新しいバグを作成するには、「バグの作成」をクリックします。

5.7.5.3 開発者ごとのバグの表示

開発者別にバグを表示するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「チーム開発」アイコンをクリックします。

2. 「バグ」アイコンをクリックします。
バグ・ダッシュボードが表示されます。

3. 「開発者別」タブをクリックします。
開発者別ページには、バグが開発者別に表示されます。特定の割当て先に関連付けられているバグを表示するには、グラフの該当するセクションをクリックします。バグを開発者別に示したレポートが表示されます。

チャートを変更するには、別のリリースを選択し、「設定」をクリックします。デフォルトのチャートに戻すには、「リセット」をクリックします。新しいバグを作成するには、「バグの作成」をクリックします。

5.7.5.4 日別のバグの表示

日別にバグを表示するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「チーム開発」アイコンをクリックします。

2. 「バグ」アイコンをクリックします。
バグ・ダッシュボードが表示されます。

3. 「日別」タブをクリックします。
日別ページには、オープン・バグおよびクローズ・バグの数が日別に表示されます。チャートを変更するには、別のリリースを選択し、「設定」をクリックします。デフォルトの棒グラフに戻すには、「リセット」をクリックします。新しいバグを作成するには、「バグの作成」をクリックします。

5.8 フィードバックの管理

フィードバックは、アプリケーション・ユーザーからリアルタイム・コメント、拡張リクエストおよびバグを収集するプロセスです。アプリケーションのフィードバックを収集するには、フィードバック・ページを追加します。

- フィードバックの表示

- アプリケーションへのフィードバック・ページの追加

- フィードバックの確認

- その他のフィードバック・レポートの表示

5.8.1 フィードバックの表示

フィードバックを表示するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「チーム開発」アイコンをクリックします。

2. 「フィードバック」アイコンをクリックします。
フィードバック・ダッシュボードが表示されます。

3. 「レポート」タブをクリックします。
フィードバック・レポート・ページには、フィードバック・エントリの詳細が表示されます。ページの上部にある検索バーを使用して、ページの外観をさらにカスタマイズできます。

関連項目:
「エンド・ユーザーとしての対話モード・レポートのカスタマイズ」

5.8.2 アプリケーションへのフィードバック・ページの追加

フィードバック・ページを使用して、アプリケーション・ユーザーからのフィードバックを収集できます。

アプリケーションにフィードバック・ページを追加するには、次のステップを実行します。

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

2. それに関するフィードバックを追加するアプリケーションを選択します。
アプリケーションのホームページが表示されます。

3. 「ページの作成」ボタンをクリックします。

4. 「ページ・タイプ」で、「フィードバック・ページ」を選択します。

5. 「定義」で、次のステップを実行します。

1. ページ番号 - デフォルトを受け入れるか、アプリケーション内のページを識別する整数値を指定します。

2. ページ名 - このページのテキスト名を指定します。

3. ページ・モード - ページ・モードを指定します。オプションの詳細は、フィールドレベル・ヘルプを参照してください。「フィールドレベル・ヘルプの表示」を参照してください。

4. ポップアップ・ページ・テンプレート - フィードバックを収集するために使用する、ポップアップ・ページのページ・テンプレートを選択します。

5. リージョン・テンプレート - フィードバックを収集するリージョンのリージョン・テンプレートを選択します。

6. ラベル・テンプレート - フィードバック・ページのアイテムに使用するラベル・テンプレートを選択します。

7. その他の属性 - フィードバック・ページに含める必要があるその他の属性の数を指定します。

ヒント:
その他の属性を指定する場合、それらの属性を編集して、ラベル、表示およびヘルプ・テキストを更新する必要があります。次に、フィードバックを保存するためにコールされるプロセスを更新して、すべての追加属性について正しいコンテキストが渡され、フィードバックの確認時に属性が表示されるようにする必要があります。

8. ナビゲーション・バーの作成 - カレント・アプリケーション内に、新しいフィードバック・ページを呼び出すためのナビゲーション・バー・エントリを作成するかどうかを指定します。

9. エントリ・ラベル - 新しいフィードバック・ページを呼び出すために使用する、新しいナビゲーション・バー・エントリの名前を入力します。

10. フィードバックの有効化 - この属性は、カレント・アプリケーションに対するフィードバック・サポートが有効化されていない場合にのみ表示されます。フィードバック・サポートを有効化するには、「はい」を選択します。

ヒント:
アプリケーションレベルの属性「フィードバックを許可」の詳細は、「アプリケーション属性の編集」を参照してください

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

5.8.3 フィードバックの送信

フィードバックを送信するには、次のステップを実行します。

1. フィードバック送信の対象となっているアプリケーションを実行します。

2. 「フィードバック」リンクをクリックします。
フィードバック・ウィンドウが表示されます。アプリケーションとページがウィンドウの上部に表示されます。開発者がこの情報を参照できるようになります。

3. 「フィードバック」にコメントを入力します。

4. 「フィードバック・タイプ」から、「一般的なコメント」、「拡張リクエスト」または「バグ」を選択します。

5. 「フィードバックの送信」をクリックします。

5.8.4 フィードバックの確認

フィードバックを確認するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「チーム開発」アイコンをクリックします。

2. 「フィードバック」アイコンをクリックします。
フィードバック・ダッシュボードが表示されます。

3. 「レポート」タブをクリックします。

4. フィードバック番号を選択し、フィードバックを確認します。

5. 「配置」で、次の操作を実行します。

1. ステータス: 新しいステータスを選択します。

2. タグは、対象のフィードバックをさらに詳しく説明するキーワードです。複数のタグを付ける場合は、カンマで区切ります。

3. 開発者のコメント: 追加のコメントを入力します。「開発者のコメント」はパブリックで表示可能ではないことに注意してください。

4. パブリック・レスポンス: パブリック・レスポンスを入力します。このレスポンスはパブリックで表示可能です。

6. フィードバックの記録方法を決定します。「配置」の右側で、次のいずれかをクリックします。

- 「バグとしてログイン」。適切な情報を入力し、「バグの作成」をクリックします。

- 「To Doとしてログイン」。適切な情報を入力し、「To Doの作成」をクリックします。

- 「機能としてログイン」。適切な情報を入力し、「機能としてログイン」をクリックします。

オプションの詳細は、フィールドレベル・ヘルプを参照してください。「フィールドレベル・ヘルプの表示」を参照してください。

7. フィードバック・エントリを削除するには、「削除」をクリックします。

8. 変更を送信するには、「変更の適用」をクリックします。

5.8.5 その他のフィードバック・レポートの表示

この項では、チーム開発で使用できるフィードバック・レポートについて説明します。

- フィードバック・カレンダの表示

- ファイリング・ユーザー別のフィードバックの表示

5.8.5.1 フィードバック・カレンダの表示

フィードバック・カレンダを表示するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「チーム開発」アイコンをクリックします。

2. 「フィードバック」アイコンをクリックします。
フィードバック・ダッシュボードが表示されます。

3. 「フィードバック・カレンダ」タブをクリックします。
カレンダ・ページには、アプリケーションからのフィードバック・コメントの数が日別に表示されます。「前へ」および「次へ」ボタンをクリックして、他の月を表示します。

5.8.5.2 ファイリング・ユーザー別のフィードバックの表示

フィードバック・カレンダを表示するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「チーム開発」アイコンをクリックします。

2. 「フィードバック」アイコンをクリックします。
フィードバック・ダッシュボードが表示されます。

3. 「ファイリング・ユーザー別」タブをクリックします。
ファイリング・ユーザー別ページには、ファイリング・ユーザー別のオープン・フィードバックのチャートが表示されます。チャートのセクションをクリックして、詳細なレポートを表示します。

5.9 チーム開発ユーティリティの管理

「ユーティリティ」リージョンは、チーム開発のホームページの右側に表示されます。これらのリンクを使用して、チーム開発設定を構成し、リリース・サマリー情報を表示し、ファイル・アップロードに対するサポートを有効化し、機能ユーティリティにアクセスし、フォーカス領域を管理し、割当て先を更新し、アップロードされたファイルを表示し、データをパージし、ニュースを管理し、リンクを更新します。

- チーム開発ユーティリティへのアクセス

- チーム開発の設定の構成

- リリース・サマリーの表示

- 機能ユーティリティの管理

- フォーカス領域の編集

- 添付ファイルの表示

- データのパージ

- ニュース・エントリの管理

- リンクの管理

関連項目:
『Oracle Application Express管理ガイド』のチーム開発の管理に関する項

5.9.1 チーム開発ユーティリティへのアクセス

チーム開発ユーティリティを使用して、チーム開発データを管理します。チーム開発ユーティリティには、チーム開発のホームページの「ユーティリティ」リージョンまたはユーティリティ・ページのいずれかからアクセスできます。

チーム開発ユーティリティにアクセスするには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「チーム開発」アイコンをクリックします。

2. ページの右側にある「ユーティリティ」リージョンを見つけます。

ヒント:
「ユーティリティ」リージョンでリンクをクリックするか、ユーティリティ・ページにアクセスすることで、ほとんどのユーティリティにアクセスできます。

3. ページの右側にある「ユーティリティ」リージョンで、「すべてのユーティリティ」をクリックします。

4. ユーティリティ・ページには、次のリンクがあります。

- チーム開発の設定: 「チーム開発の設定の構成」を参照してください。

- リリース・サマリー: ワークスペースおよび開発者の統計を確認します。

- ファイルの有効化: ファイル・アップロードに対するサポートを追加できる管理ページにリンクします。『Oracle Application Express管理ガイド』で、チーム開発でのファイル・アップロードに対するサポートの有効化に関する項を参照してください。

- 機能ユーティリティ: 機能ユーティリティ・ページを使用すると、複数の機能のマイルストンを一度に管理できます。このページを使用すると、マイルストンを機能に割り当て、機能の期日をマイルストン日付に設定し、期日を超過した機能のマイルストンを変更し、オープンな機能の期日をプッシュできます。

- フォーカス領域の管理: 機能ページに表示されるフォーカス領域を管理します。「フォーカス領域の編集」を参照してください。

- 割当て先の更新: 選択したコンポーネントを再割当てできます。未完了のコンポーネントのみを再割当てできます(つまり、ステータスが100%未満か、マイルストン日付が将来の日付のコンポーネント)。

- ファイルの表示: アップロードされたファイルを管理します。「添付ファイルの表示」を参照してください。

ヒント:
このオプションは、管理者がファイル・アップロード機能を有効にしたかどうかによって、「ファイルの表示」と「ファイルの有効化」を切り替えます。「ファイルの有効化」と表示された場合は、管理者によってファイル・アップロード機能がまだ有効化されていません。

- データの消去: 選択したコンポーネントのすべてのエントリを削除します。このオプションは、新しい開発サイクルを開始するとき、またはテスト用のワークスペースの使用後に役立ちます。

- ニュースの管理: チーム開発のホームページおよびワークスペースのホームページに表示されるニュース・エントリを管理します。「ニュース・エントリの管理」を参照してください。

- リンクの管理: 他のワークスペース・ユーザーと共有するリンクを管理します。「リンクの管理」を参照してください。

- To Doの自動作成: アプリケーションのすべてのページに自動的にTo Doを作成します。

- 期限経過したバグのプッシュ: オープン・バグの推定修正日を延期します。プッシュが必要なバグのみをフィルタ処理および選択して、任意の日数分延期できます。

5.9.2 チーム開発の設定の構成

「チーム開発の設定」を使用すると、To Doとバグの表示方法、デフォルト値(リリース、所有者および優先度)、および現在のワークスペースに対して有効にする追跡属性を指定できます。

「チーム開発」設定を編集するには、次の手順を実行します。

1. 「ワークスペース」ホームページで、「チーム開発」アイコンをクリックします。

2. 「ユーティリティ」で、「チーム開発の設定」をクリックします。
設定ページが表示されます。

3. 対象となる属性を編集します。
属性の詳細は、フィールドレベル・ヘルプを参照してください。「フィールドレベル・ヘルプの表示」を参照してください。

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

ヒント:
設定をデフォルト値に戻すには、「デフォルトにリセット」をクリックします。

5.9.3 リリース・サマリーの表示

「リリース・サマリー」レポートを使用すると、機能、To Doおよびバグを整理できます。

「リリース・サマリー」レポートにアクセスするには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「チーム開発」アイコンをクリックします。

2. 「ユーティリティ」で、「リリース・サマリー」をクリックします。
リリース・サマリー・ページが表示されます。

3. 検索バーを使用して、ビューを制限します。ビューをフィルタ処理するには、開発者またはリリースを選択し、「設定」をクリックします。

4. レポートを電子メールで送信するには、次の操作を実行します。

1. 「電子メール」をクリックします。
電子メール・レポート・ページが表示されます。

2. 該当するフィールドに入力します。必須フィールドには、赤いアスタリスク(*)が付いています。

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

5. 「電子メール」をクリックします。

ヒント:
レポートをデフォルト・ビューに戻すには、「リセット」をクリックします。

5.9.4 機能ユーティリティの管理

機能ユーティリティ・ページを使用して、マイルストンを機能に割り当て、機能の期日をマイルストン日付に設定し、期日を超過した機能のマイルストンを変更し、オープンな機能の期日をプッシュできます。

機能ユーティリティにアクセスするには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「チーム開発」アイコンをクリックします。

2. 「ユーティリティ」で、「機能ユーティリティ」をクリックします。

3. 「機能ユーティリティ」で、ユーティリティを選択します。

- 機能へのマイルストンの割当て(現在マイルストンが割り当てられていない機能のみ)

- 機能の期日をマイルストン日付に設定(機能にのみ影響)

- 期日を超過した機能のマイルストンの変更

- オープンな機能の期限のプッシュ

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

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

5.9.5 フォーカス領域の編集

機能を作成または更新する際、「フォーカス領域」に割り当てることができます。

既存の機能「フォーカス領域」を編集するには、次の手順を実行します。

1. 「ワークスペース」ホームページで、「チーム開発」アイコンをクリックします。

2. 「ユーティリティ」で、「フォーカス領域の管理」をクリックします。
「フォーカス領域の管理」ページが表示されます。

3. 「フォーカス領域」を探し、「編集」アイコンをクリックします。

4. 「変更後の名前」に編集内容を入力します。

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

5.9.6 添付ファイルの表示

ワークスペースレベルで有効にすると、機能、To Doまたはバグにファイルを添付できます。

ヒント:
この機能を使用するには、「管理」、「サービスの管理」、「ワークスペース・プリファレンスの設定」で、「ファイル・リポジトリの有効化」属性を「はい」に設定する必要があります。管理者は、「チーム・アクション」リストで「ファイルの有効化」をクリックすることで、チーム開発でこのページにアクセスすることもできます。

機能、To Doおよびバグに添付されたファイルを表示するには、次の手順を実行します。

1. 「ワークスペース」ホームページで、「チーム開発」アイコンをクリックします。

2. 「ユーティリティ」で、「ファイルの表示」をクリックします。
チーム開発ファイル・ページが表示されます。

3. ファイルを表示するには、名前をクリックします。

関連項目:
『Oracle Application Express管理ガイド』のチーム開発での添付ファイルに対するサポートの有効化に関する項。

5.9.7 データのパージ

データをパージすると、特定のタイプのデータに関連するすべてのデータ(機能、マイルストン、To Do、バグまたはフィードバック)が削除されます。

データをパージするには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「チーム開発」アイコンをクリックします。

2. 「ユーティリティ」で、「データのパージ」をクリックします。

3. 「データのパージ」で、パージするデータのタイプを選択し、「パージ」をクリックします。

5.9.8 ニュース・エントリの管理

「ニュース」リージョンは、現在のワークスペースの他のユーザーとやり取りする場合に使用します。ニュース・エントリを追加したり、他のワークスペース・ユーザーがポストしたニュース・エントリを表示することができます。ニュースは、Application Expressのホームページ、チーム開発のホームページおよびニュース・ページに表示されます。

ニュース・エントリを管理するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「チーム開発」アイコンをクリックします。

2. 「ユーティリティ」で、「ニュースの管理」をクリックします。
ニュース・ページが表示されます。

3. 検索バーを使用して、表示をフィルタ処理します。

4. ニュース・アイテムを追加するには、次のステップを実行します。

1. 「ニュースの追加」をクリックします。
ニュース・ページが表示されます。

2. 「ニュース・エントリ」フィールドにテキストを入力します。

3. 「ニュースの追加」をクリックします。

5. ニュース・アイテムを編集するには、次の操作を実行します。

1. ニュース・アイテムを選択します。

2. ニュース・エントリを編集します。

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

6. ニュース・アイテムを削除するには、次の操作を実行します。

1. ニュース・アイテムを選択します。

2. 「削除」をクリックします。

5.9.9 リンクの管理

リンク・ページを使用して、チーム開発内のリンクを共有します。

- リンク・ページへのリンクの追加

- リンクの編集または削除

5.9.9.1 リンク・ページへのリンクの追加

「リンク」ページにアクセスするには、次の手順を実行します。

1. 「ワークスペース」ホームページで、「チーム開発」アイコンをクリックします。

2. 「ユーティリティ」で、「リンクの管理」をクリックします。
リンク・ページが表示されます。

3. 検索バーを使用して、表示をフィルタ処理します。

4. リンクを追加するには、次のようにします。

1. 「リンクの作成」をクリックします。
リンク・ページが表示されます。

2. 該当するフィールドに入力します。必須フィールドには、赤いアスタリスク(*)が付いています。

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

4. 「リンクの作成」をクリックします。

5.9.9.2 リンクの編集または削除

リンクを編集または削除するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「チーム開発」アイコンをクリックします。

2. 「ユーティリティ」で、「リンクの管理」をクリックします。
リンク・ページが表示されます。

3. リンクを編集する手順は、次のとおりです。

1. 「編集」アイコンをクリックします。
リンク・ページが表示されます。

2. 該当するフィールドを編集します。

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

4. 新しいリンクを削除する手順は、次のとおりです。

1. 「編集」アイコンをクリックします。
リンク・ページが表示されます。

2. 「削除」をクリックします。

6 Webシート・アプリケーションの作成

Webシート・アプリケーションは、テキストとデータを組み合せた対話モードWebページです。この項では、Webシートの作成方法を説明します。

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

- 既存のWebシート・ページのコピー

- Webシートの実行

- ページの詳細の編集

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

- Webシート・ダッシュボードの表示

- Webシート・アクティビティの監視

- Webシート・プロパティの理解

- Webシート・アクセスの制御

関連項目:
『Oracle Application Expressエンド・ユーザー・ガイド』のWebシートの使用に関する項および『Oracle Application Express管理ガイド』のWebシート・データベース・オブジェクトの削除および検証に関する項およびWebシート・オブジェクトのサンプル作成の無効化に関する項

6.1 Webシート・アプリケーションについて

Webシート・アプリケーションは、テキストとデータを組み合せた対話モードWebページです。これらのアプリケーションは、ユーザーによって定義される非常に動的なアプリケーションです。Webシート・アプリケーションには、ナビゲーション・コントロール、検索機能や、ファイル、ノート、タグなどの注釈を追加する機能があります。Webシート・アプリケーションは、アクセス制御リストおよびいくつかの組込み認証モデルを使用して保護できます。

関連項目:
「データベース・アプリケーションとWebシート・アプリケーションの違い」、「AnyCo IT部門Webシートの理解」および『Oracle Application Expressエンド・ユーザー・ガイド』のWebシートの使用に関する項

6.2 Webシート・アプリケーションの作成

この項では、Webシート・アプリケーションの作成方法について説明します。アプリケーションの作成ウィザードを使用して、Webシート・アプリケーションを作成します。Webシート・ページを作成した後で、テキストまたはデータとしてコンテンツを追加します。

- アプリケーション・ビルダーからのWebシートの作成

- 実行中のWebシートからのWebシート・アプリケーションの作成

関連項目:
『Oracle Application Expressエンド・ユーザー・ガイド』のWebシートの使用に関する項および『Oracle Application Express管理ガイド』のWebシート・データベース・オブジェクトの削除および検証に関する項およびWebシート・オブジェクトのサンプル作成の無効化に関する項

6.2.1 アプリケーション・ビルダーからのWebシートの作成

Webシート・アプリケーションを作成するには、次のステップを実行します。

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

2. 「作成」ボタンをクリックします。

3. アプリケーション・タイプについて、「Webシート」を選択し、「次へ」をクリックします。

4. 「Webシートの作成」で、次の項目を指定します。

1. Webシート: アプリケーションを識別する一意の整数値を入力します。3000から9000の間のアプリケーションIDは内部使用向けに予約されています。

2. 名前: アプリケーションを識別するための名前を入力します。

3. SQLを許可: SQLタグおよびSQLレポートを定義できるかどうかを決定します。「はい」または「いいえ」を選択します。デフォルトでは、この属性は無効で、「いいえ」に設定されています。

4. スタート・ガイドを含める: このオプションを選択すると、Webシートのホーム・ページの最初のテキスト・セクションに、Webシートの使用に関する基本的な情報を含めます。1度確認した後、このテキスト・セクションを編集または削除できます。

5. 選択した内容を確認し、「Webシートの作成」をクリックします。
成功メッセージが表示されます。

6. レンダリングされたアプリケーションを表示するには、次のステップを実行します。

1. 「Webシートの実行」をクリックします。

2. Webシートの資格証明を入力します。

1. ユーザー名: ユーザー名を入力します。

2. パスワード: パスワードを入力します。

3. 「ログイン」または「サインイン」をクリックします。

ヒント:
表示される文言は、アプリケーションの作成者によって異なります。パッケージ・アプリケーションおよびOracle Application Express開発環境を含め、Oracleが提供するアプリケーションでは、「サインイン」/「サインアウト」が表示されます。ユーザーまたは開発者が作成したアプリケーションでは、「ログイン」/「ログアウト」が表示されます。

Webシート・アプリケーションが新しいウィンドウに表示されます。

Webシート・アプリケーションが新しいウィンドウに表示されます。

7. Webシート・コンテンツを追加します。

関連項目:
『Oracle Application Expressエンド・ユーザー・ガイド』のWebシートの使用に関する項および「Webシート・アプリケーションURLの公開について」

6.2.2 実行中のWebシートからのWebシート・アプリケーションの作成

実行中のWebシートからWebシート・アプリケーションを作成するには、次のステップを実行します。

1. Webシート・アプリケーションを実行します。「Webシートの実行」を参照してください。

2. 「作成」メニューから、「新しいWebシート」をクリックします。

3. 「Webシートの作成」で、次のステップを実行します。

1. Webシート: 一意の整数値を識別して、アプリケーションを識別します。3000から9000の間のアプリケーションIDは内部使用向けに予約されています。

2. 名前: アプリケーションを識別するための名前を入力します。

3. 説明: アプリケーションの説明を入力します。

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

4. 選択した内容を確認し、「作成」をクリックします。

5. レンダリングされたWebシート・アプリケーションを表示するには、「Webシートの実行」をクリックします。
Webシート・アプリケーションが新しいウィンドウに表示されます。

6. Webシート・コンテンツを追加します。

関連項目:
『Oracle Application Expressエンド・ユーザー・ガイド』のWebシートの使用に関する項および「Webシート・アプリケーションURLの公開について」

6.3 既存のWebシート・ページのコピー

既存のWebシート・ページをコピーするには、次のステップを実行します。

1. Webシート・アプリケーションを実行します。「Webシートの実行」を参照してください。

2. 「作成」メニューから、「コピーの新規ページ」を選択します。

3. 「コピーの新規ページ」で、新しいページの名前を入力します。

4. 「ページのコピー」をクリックします。
成功メッセージが表示されます。

5. 次のいずれかを選択します。

- 現在のページの表示

- 新規ページの表示

ヒント:
ページの詳細を編集して、親ページを変更できます。「ページの詳細の編集」を参照してください。

6.4 Webシートの実行

レンダリングされたアプリケーションを表示するには、アプリケーションを実行するか、またはApplication Expressエンジンに送信します。

- アプリケーション・ビルダー・ホームページからのWebシートの実行

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

- WebシートURLの決定

関連項目:
『Oracle Application Expressエンド・ユーザー・ガイド』のWebシートの使用に関する項および「Webシート・アプリケーションURLの公開について」

6.4.1 アプリケーション・ビルダー・ホームページからのWebシートの実行

アプリケーション・ビルダー・ホームページからWebシートを実行するには、次の手順を実行します。

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

2. 「検索」バーから、「レポートの表示」アイコンをクリックします。

3. 「アプリケーション」リストで、Webシート・アプリケーションを探します。

4. 右側の列にある「実行」アイコンをクリックします。

5. Webシートの資格証明を入力します。

1. ユーザー名: ユーザー名を入力します。

2. パスワード: パスワードを入力します。

3. 「ログイン」または「サインイン」をクリックします。

ヒント:
表示される文言は、アプリケーションの作成者によって異なります。パッケージ・アプリケーションおよびOracle Application Express開発環境を含め、Oracleが提供するアプリケーションでは、「サインイン」/「サインアウト」が表示されます。ユーザーまたは開発者が作成したアプリケーションでは、「ログイン」/「ログアウト」が表示されます。

Webシート・アプリケーションが新しいウィンドウに表示されます。

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

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

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

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

3. 「実行」ボタンをクリックします。

4. Webシートの資格証明を入力します。

1. ユーザー名: ユーザー名を入力します。

2. パスワード: パスワードを入力します。

3. 「ログイン」または「サインイン」をクリックします。

ヒント:
表示される文言は、アプリケーションの作成者によって異なります。パッケージ・アプリケーションおよびOracle Application Express開発環境を含め、Oracleが提供するアプリケーションでは、「サインイン」/「サインアウト」が表示されます。ユーザーまたは開発者が作成したアプリケーションでは、「ログイン」/「ログアウト」が表示されます。

Webシート・アプリケーションが新しいウィンドウに表示されます。

6.4.3 WebシートURLの決定

Webシート・アプリケーションを完了すると、本番URLを公開できます。詳細は、「Webシート・アプリケーションURLの公開について」を参照してください。

6.5 ページの詳細の編集

ページの詳細で、ページ番号、別名、親ページまたはページ詳細を変更できます。

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

1. Webシート・アプリケーションを実行します。「Webシートの実行」を参照してください。

2. 「編集」メニューから、「ページの編集」を選択します。

3. 1つのページの詳細。

- 名前: ページの名前を指定します。このページ名は、ウィンドウ・タイトルおよびブレッドクラムに表示されます。

- 別名: ページの別名を使用して、他のページへのリンクをページ・セクションに作成できます。ページの別名は1つのアプリケーション内で一意である必要があります。

- 所有者: ページの所有者を指定します。

- 親ページ: 親ページを指定します。定義した親ページは、ブレッドクラムおよびページ間のナビゲーションの構築に使用されます。

- ページ詳細: ページについて説明する説明テキストです。

4. 「変更の適用」をクリックします。
成功メッセージが表示されます。

ヒント:
「コントロール・パネル」で、「ページの編集」をクリックしてページの詳細を編集することもできます。

6.6 Webシート・アプリケーションの削除

Webシートは、「Webシート・プロパティ」ページで削除します。

Webシート・アプリケーションを削除するには、次のステップを実行します。

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

2. Webシート・アプリケーションを選択します。
「Webシート・プロパティ」ページが表示されます。

3. 「削除」をクリックします。

関連項目:
「Webシート・プロパティの理解」

6.7 Webシート・ダッシュボードの表示

Webシート・ダッシュボードには、カレントWebシート・アプリケーションの詳細(最近の変更、トップ・ユーザーおよびトップ・ページ)が表示されます。

Webシート・ダッシュボードを表示するには、次のステップを実行します。

1. Webシートを実行します。「Webシートの実行」を参照してください。

2. 「管理」メニューから、「ダッシュボード」を選択します。
ダッシュボードが次のセクションに分かれて表示されます。

- アプリケーション詳細

- 最近の変更

- トップ・ユーザー

- トップ・ページ

3. 時間枠を編集するには、「時間枠」リストから新しい値を選択します。

4. デフォルト設定に戻すには、「リセット」をクリックします。

6.8 Webシート・アクティビティの監視

アクティビティの監視ページを使用して、ページおよびコンテンツの使用状況、パフォーマンスおよび人気度を解析します。

アクティビティの監視ページにアクセスするには、次のステップを実行します。

1. Webシートにログインし、Webシートを実行します。「Webシートの実行」を参照してください。

2. 「管理」メニューから、「アクティビティの監視」を選択します。
「アクティビティの監視」ページが表示されます。このページは次のセクションに分かれています。

- アクティビティ

- ページ・ビュー

- トップ・ページ

- トップ・データ・グリッド

- トップ・レポート

- トップ・ユーザー

- 注釈

- トップ・ファイル

- トップ・ノート

- トップ・タグ

各レポートは、対話モード・レポートとして表示されます。対話モード・レポートおよび「アクション」メニューの詳細は、「エンド・ユーザーとしての対話モード・レポートのカスタマイズ」を参照してください。

6.9 Webシート・プロパティの理解

実行中のWebシートの内部または外部から、「Webシート・プロパティ」ページにアクセスできます。「Webシート・プロパティ」ページを使用して、アプリケーションの一般的なデフォルト設定および動作を制御できます。ホームページは、そのWebシートを実行するときに、ユーザーが最初にアクセスするホームページです。アプリケーションの名前は、ブレッドクラム内に表示されます。

- Webシート・プロパティの編集

- Webシート・プロパティ

関連項目:
「Webシート・アプリケーションの削除」

6.9.1 Webシート・プロパティの編集

「Webシート・プロパティ」ページにアクセスするには、次の手順を実行します。

1. Webシートにログインし、Webシートを実行します。「Webシートの実行」を参照してください。

2. 「管理」メニューから、「Webシート・プロパティ」を選択します。
「Webシート・プロパティ」が表示されます。

3. セクションを表示するには、セクション・タイトルの左側にある大なり記号(>)をクリックします。

4. 適切なプロパティを編集し、「変更の適用」をクリックします。

関連項目:
「Webシート・プロパティ」

6.9.2 Webシート・プロパティ

この項では、「Webシート・プロパティ」ページ上の属性について説明します。

- Webシート

- 詳細

- ロゴ

- スタイル

- 認証

- 認可

- SQL

6.9.2.1 Webシート

「Webシート」セクションを使用して、一般的なWebシート・アプリケーション・プロパティを制御します。表6-1に、アプリケーション属性を示します。

表6-1 「Webシート」属性

属性

説明

名前

アプリケーションの名前を指定します。アプリケーションの実行中は、この名前がブレッドクラム内に表示されます。

ステータス

アプリケーションのステータスを指定します。

ホームページ

このWebシートのホームページを選択します。これは、Webシートを実行するときに、ユーザーに対して最初に表示されるページです。

アプリケーション日付書式

アプリケーションで使用する日付書式を決定します。

この日付書式を使用して、NLS_DATE_FORMATデータベース・セッションの設定が変更されてから、アプリケーション内のページが表示または送信されます。この値には、有効なOracle日付書式マスクを含むリテラル文字列、または置換構文を使用したアイテム参照を指定できます。値が指定されていない場合は、データベース・セッションからデフォルトの日付書式が実行時に取得されます。

デフォルトのアプリケーション言語

アプリケーションのデフォルト言語を指定します。ユーザーは、アプリケーション内から言語プリファレンスを変更できます。この言語リストは、インストールされたApplication Expressの翻訳済バージョンによって決まります。

デフォルトのアプリケーション地域

日付、言語、数字などの属性を制御する、アプリケーションのデフォルト地域を指定します。ユーザーは、アプリケーション内から地域プリファレンスを変更できます。

パスワードのリセットの表示

ログイン・ページでの「パスワードの再設定」リンクの表示を制御します。ユーザーは、このリンクを使用してパスワードをリセットできます。このオプションは、アプリケーションで「Application Expressアカウント」認証が使用されている場合にのみ機能します。

Webシートの電子メール送信元アドレス

Webシートで送信元アドレスとして使用する電子メール・アドレスを決定します。この送信元電子メール・アドレスは、Webシートのデータ・グリッドまたはレポート電子メール・ダウンロードから電子メールを送信する際に使用されます。

6.9.2.2 詳細

「詳細」セクションを使用して、アプリケーションの説明およびログイン・メッセージを編集します。表6-2に、「詳細」属性を示します。

表6-2 詳細

属性

説明

所有者

アプリケーションを所有するユーザーを指定します。

説明

アプリケーションについて説明するオプションの説明です。

ログイン・メッセージ

ログイン・ページにこのメッセージが表示されます。

6.9.2.3 ロゴ

「ロゴ」セクションを使用して、このWebシート・アプリケーションのロゴを作成します。このロゴは、Webシートの上部に表示されます。表6-3に、「ロゴ」属性を示します。

表6-3 ロゴ

属性

説明

ロゴ・タイプ

アプリケーションに使用するロゴのタイプを選択します。

ロゴ

アプリケーション・ロゴとして使用する完全なテキスト文字列を入力します。

6.9.2.4 スタイル

「スタイル」セクションを使用して、デフォルトのアプリケーション・スタイルを上書きし、カスタムCSSを使用します。

6.9.2.5 認証

「認証」セクションを使用して、このWebシートの認証スキームを選択します。表6-4に、「認証」属性を示します。

表6-4 認証

属性

説明

認証

アプリケーションのユーザーを認証する方法を選択します。認証スキームを変更するには、「認証の編集」をクリックします。次のリストが表示されます。

- Application Expressアカウント: 開発者アカウントのユーザー名とパスワードを使用して認証します。

- シングル・サインオン: Oracle Application Server Single Sign-Onを使用して認証します。これは、Application Expressインスタンスに対して構成する必要があります。

- LDAP: LDAPディレクトリを使用して認証します。これを構成するには、このページで追加パラメータを指定します。

- カスタム: 認証およびセッション管理タスクのための独自のコードを指定します。「Webシート・アクセスの制御」を参照してください。

ログアウトURL

このアプリケーションのLogout URL属性になるURLを指定します。この属性は、ログアウト・リンクで次のように参照されます。

&LOGOUT_URL.

このアプリケーションで組込みセッション検証を使用する場合、"wwv_flow_custom_auth_std.ws_logout?p_websheet_app_id=&WS_APP_ID.&p_next_url=ws?p=&WS_APP_ID.:home"を使用して組込みログアウト・プロシージャを起動できます。

Cookie名

URLのApplication ExpressセッションおよびセッションIDの識別に必要なセッションcookieの名前です。セッションcookie名に値が指定されていない場合、Application Expressによって、デフォルト値が指定されます。

Cookieパス

セッションcookieのパス属性。

Cookieドメイン

セッションcookieのドメイン属性。

セキュア

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

- はい: プロトコルがHTTPSの場合にのみ、ブラウザからセッション管理cookieを送信することを許可します。

- いいえ: プロトコルがHTTPまたはHTTPSの場合に、ブラウザからセッション管理cookieを送信することを許可します。

6.9.2.6 認可

「認可」セクションを使用して、Webシート・アプリケーションにログインできるユーザーを制御します。表6-5に、アプリケーション属性を示します。

表6-5 認可

属性

説明

アクセス制御リスト・タイプ

認証が「Application Expressアカウント」の場合、Application Expressワークスペース内のロールで認可を判断するか、アクセス制御リストで認可を判断するかを選択します。「Application Expressアカウント」以外のすべての認証タイプでは、認可は常にアクセス制御リストで判断されます。

パブリック・アクセスを許可

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

- はい: ユーザーにログインを要求せずに、ユーザーが読取り専用モードでアプリケーションを実行できるようになります。

- いいえ: アプリケーションを実行するには、すべてのユーザーはログインする必要があります。

ロールおよびそれらの権限の詳細は、「アクセス制御ロール」をクリックしてください。「アクセス制御リストの編集」をクリックして、アクセス制御リスト・ページにリンクします。詳細は、「Webシート・アクセスの制御」を参照してください。

6.9.2.7 SQL

「SQL」セクションを使用して、ユーザーがカレントWebシートでSQLを使用できるかどうかを決定します。デフォルトでは、この機能は無効化されています。デフォルトの設定を変更するには、「はい」を選択します。

有効な場合、ユーザーはアプリケーション内でSQLタグとSQLレポートを使用できます。「オブジェクトの追加」をクリックして、推奨オブジェクトページにリンクします。ユーザーは、カスタム・レポートを記述することも、カレント・ワークスペースに関連付けられたスキーマ内のデータベース・オブジェクトにSQLタグを使用することもできます。推奨オブジェクトとしてデータベース表またはビューを指定すると、ヘルプ・ページで表およびビューの列を公開することによりSQLを簡単に作成できるようになります。

ヒント:
インスタンスの管理者は、インスタンス全体に対してSQLを使用する機能を制御できます。詳細は、『Oracle Application Express管理ガイド』のWebシートでのSQLアクセスの有効化と無効化に関する説明を参照してください。

6.10 Webシート・アクセスの制御

この項では、Webシート・アプリケーションへのアクセスの制御方法について説明します。

- Webシート・アクセスの動作

- アクセス制御リスト・タイプの指定

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

6.10.1 Webシート・アクセスの動作

管理者は、次の認証メカニズムのいずれかを指定して、Webシート・アプリケーションにログインできるユーザーを制御します。

- パブリック・アクセス(認証なし)

- Oracle Application Expressアカウント

- シングル・サインオン検証

- LDAP資格証明の検証

- カスタム

認証が「カスタム」として定義されている場合は、このアプリケーションのユーザーの権限はアクセス制御リストで管理されます。

認証がOracle Application Expressアカウントの場合は、Application Expressワークスペースに定義されたユーザー・ロールで認可を判断するか、アクセス制御リストで認可を判断するかを指定する必要があります。Oracle Application Expressアカウント以外のすべての認証タイプでは、認可は常にアクセス制御リストで判断されます。

ユーザーがアプリケーションにログインすると、ユーザーに割り当てられたロールによってアクセス権が判断されます。ユーザーに割り当てられるロールには次のものがあります。

- リーダー: コンテンツを表示できますが、編集はできません。

- コントリビュータ: コンテンツを表示および編集できます。

- 管理者: コンテンツを表示および編集でき、「Webシート・プロパティ」の編集および「アクセス制御リスト」の管理を行うこともできます。

ユーザー・ロールと権限の詳細は、「ヘルプ」をクリックし、「アクセス制御」を選択してください。

6.10.2 アクセス制御リスト・タイプの指定

アクセス制御リストを使用するには、「Webシート・プロパティ」を編集し、「アクセス制御リスト・タイプ」を「カスタム」として定義します。

「Webシート・プロパティ」ページにアクセスするには、次の手順を実行します。

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

2. 「Webシート・アプリケーション」タブをクリックします。

3. 「アイコンの表示」ボタンをクリックします。

4. Webシートを選択し、「編集」をクリックします。
「Webシート・プロパティ」が表示されます。「Webシート・プロパティ」を参照してください。

5. 「認可」までスクロールします。

6. 「アクセス制御リスト・タイプ」から、「カスタム」を選択します。

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

関連項目:
「認証」

6.10.3 アクセス制御リスト・エントリの作成

アクセス制御リスト・エントリを作成するには、次のステップを実行します。

1. Webシートにログインし、Webシートを実行します。「Webシートの実行」を参照してください。

2. 「管理」メニューから、「アクセス制御」を選択します。

3. 「エントリの作成」をクリックします。
エントリの詳細ページが表示されます。

4. エントリの詳細ページで、次のステップを実行します。

1. ユーザー名: アクセス制御の対象ユーザーのユーザー名を入力します。

2. 権限: ユーザーの権限を指定します。

- リーダー: コンテンツを表示できますが、編集はできません。

- コントリビュータ: コンテンツを表示および編集できます。

- 管理者: コンテンツを表示および編集でき、「Webシート・プロパティ」の編集および「アクセス制御リスト」の管理を行うこともできます。

5. 「作成」または「作成後、さらに作成」をクリックします。

7 データベース・アプリケーションの作成

この項では、アプリケーション・ビルダーを使用してデータベース・アプリケーションを作成する方法について説明します。ここでは、アプリケーションの作成ウィザードを使用する利点、データベース・アプリケーションの作成方法、アプリケーション属性の編集方法、ページの管理に使用可能なビューの概要、アプリケーション・コメントの管理方法、およびアプリケーション・ユーティリティのサマリーについて説明します。

- アプリケーションの作成ウィザードの使用

- データベース・アプリケーションの作成

- モバイル・アプリケーションの作成

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

- アプリケーション属性の管理

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

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

- ページ・グループの作成

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

- 開発者コメントの追加

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

- アプリケーション・グループの管理

- アプリケーション・ユーティリティへのアクセス

関連項目:
「ユーザー・インタフェース設計の管理」、「パッケージ・アプリケーションの使用」、「データベース・アプリケーションとWebシート・アプリケーションの違い」、「アプリケーション・ビルダーの理解」、「レポートの開発」、「ページ・レイアウトの制御」および「ナビゲーションの追加」

7.1 アプリケーションの作成ウィザードの使用

アプリケーションの作成ウィザードを使用すると、複数のページを含む完全なアプリケーションを作成できます。この項では、アプリケーションの作成ウィザードの機能と、このウィザードの実行中に作成できるページ・タイプについて説明します。

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

- アプリケーションの作成ウィザードの実行中に使用可能なページ・タイプ

関連項目:
「ユーザー・インタフェース設計の管理」、「データベース・アプリケーションの作成」および「モバイル・アプリケーションの作成」

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

アプリケーションの作成ウィザードを使用すると、基本的なOracle Application Expressアプリケーションを設計し、簡単に設計できます。アプリケーションの作成ウィザードを使用すると、レポート、対話モード・レポート、フォーム、表形式フォーム、マスター・ディテール・フォームなどの複数のページを含む完全なアプリケーションを作成できます。このウィザードを使用してアプリケーションを作成した後、ページを変更したり、ページの作成ウィザードを使用してページを追加できます。

アプリケーションの作成ウィザードを使用すると、既存のデータベース表のSQL問合せに基づいて空白ページでアプリケーションを作成できます。表に基づいたアプリケーションは簡易レポート、フォームとレポート、または表形式フォームで構成されます。SQL問合せは、手動でSQLを入力しても、「クエリー・ビルダー」のグラフィカル・ユーザー・インタフェースを使用しても、どちらでも作成できます。

ワークスペースレベルでは、その表領域で構築されたアプリケーションに使用されるデフォルト値を設定するオプションがあります。これらのデフォルト値を設定すると、各ステップを介さずにウィザードを終了できます。ウィザードを終了する場合、ユーザーが作成したアプリケーションは、ユーザーがデフォルトとして指定した値を使用します。

関連項目:
「アプリケーションの作成ウィザードの実行中に使用可能なページ・タイプ」、「データベース・アプリケーションへのページの追加について」、『Oracle Application Express SQLワークショップ・ガイド』のクエリー・ビルダーを使用した問合せの構築に関する項および『Oracle Application Express管理ガイド』のアプリケーション・ビルダーのデフォルト値の利用に関する項

7.1.2 アプリケーションの作成ウィザードの実行中に使用可能なページ・タイプ

アプリケーションの作成ウィザードの実行中に選択するユーザー・インタフェースによって、使用可能なページ・タイプが決定します。表7-1「アプリケーションの作成ウィザード - 使用可能なページ・タイプ」に、アプリケーションの作成ウィザードの実行中に作成できる様々なページ・タイプを一覧表示します。すべてのページ・タイプがすべてのユーザー・インタフェースでサポートされるわけではありません。

表7-1 アプリケーションの作成ウィザード - 使用可能なページ・タイプ

ページ・タイプ

説明

デスクトップ

jQuery Mobileスマートフォン

空白

組込み機能のないページを作成します。

使用可能

使用可能

チャート

SQL問合せの結果を表すチャートを含むページを作成します。

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

使用可能

使用可能

列切替えレポート

モバイル・アプリケーションのレスポンシブなレポートを作成します。デフォルトでは、列切替えレポートはすべての列が同じ優先度に設定されて作成されます。ただし、開発者はレポート列属性を編集し、重要度に応じて列をランク付けできます。優先度がより低い列は、より狭い幅で表示されます(たとえば、優先度6の列は最初に非表示になり、優先度1の列は最後に非表示になります。)レポートには、エンド・ユーザーが表示する列を選択できる「列」ボタンが含まれています。

関連項目: 「レポートの開発」

使用不可

使用可能

フォーム

データベース表の単一行を更新するフォームを作成します。フォームを構築する表を選択します。

関連項目: 「フォームの開発」

使用可能

使用可能

リスト・ビュー

モバイル・アプリケーションのレスポンシブなレポートを作成します。リフロー表レポートは、表の列を縮小して、各行に対するラベルやデータ・ペアのブロックのような外観の積上げ表示形式にすることによって機能します。この切替えは、レポートを水平に表示できる十分な領域がない場合に発生します。

関連項目: 「レポートの開発」

使用不可

使用可能

リスト・ビューとフォーム

スマートフォンでデータの表示とナビゲーション用に最適化されます。

2ページのリスト・ビューとフォームの組合せを構築します。1ページ目では、「リスト・ビュー」から更新する行を選択します。2ページ目では、ユーザーは選択した表またはビューを更新できます。

関連項目: 「レポートの開発」

使用不可

使用可能

マスター・ディテール

1つのHTMLフォーム内にマスター行および複数のディテール行を表示するフォームを作成します。このフォームを使用すると、2つの表またはビューに対し、値の問合せ、挿入、更新および削除を行うことができます。マスター・レポートおよびディテール・フォームを構築する表を選択します。

関連項目: 「マスター・ディテール・フォームの管理」

使用可能

使用不可

リフロー・レポート

モバイル・アプリケーションのレスポンシブなレポートを作成します。レポートを水平に表示できる十分な領域がない場合、レポートは、表の列を縮小して、各行に対するラベルやデータ・ペアのブロックのような外観の積上げ表示形式にすることによって機能します。

関連項目: 「レポートの開発」

使用不可

使用可能

レポート

SQL問合せの書式設定された結果を含むページを作成します。レポートを作成する表を選択するか、カスタムSQL SELECT文またはSQL SELECT文を戻すPL/SQLファンクションを指定する表を選択します。その後、レポート実装(「対話モード」または「クラシック」)を選択します。

関連項目: 「レポートの開発」

使用可能

使用不可

レポートとフォーム

2ページのレポートとフォームの組合せを作成する表を選択します。その後、レポート実装(「対話モード」または「クラシック」)を選択します。1ページ目では、更新する行を選択します。2ページ目では、レコードを追加するか、あるいは既存のレコードの更新または削除を行うことができます。

関連項目: 「レポートの開発」

使用可能

使用不可

表形式フォーム

データベース表の複数の行に対して更新、挿入および削除を行うフォームを作成します。フォームを構築する表を選択します。

関連項目: 「表形式フォームの管理」

使用可能

使用不可

7.2 データベース・アプリケーションの作成

この項では、アプリケーションの作成ウィザードを実行することによってデータベース・アプリケーションを作成する方法について説明します。

- 表、問合せまたはドリルダウン問合せに基づくデータベース・アプリケーションの作成

- スプレッドシートからのデスクトップ・データベース・アプリケーションの作成

- データベース・アプリケーションのコピー

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

関連項目:
「ユーザー・インタフェース設計の管理」、「モバイル・アプリケーションの作成」、「アプリケーションの削除」および「データベース・アプリケーションとWebシート・アプリケーションの違い」

7.2.1 表、問合せまたはドリルダウン問合せに基づくデータベース・アプリケーションの作成

表、問合せまたはドリルダウン問合せに基づいて・データベースアプリケーションを作成するには、「アプリケーションの作成」ウィザードで「データベース」を選択します。「アプリケーションの作成」ウィザードを実行する場合の主なデシジョン・ポイントは、ターゲット・ユーザー・インタフェースの選択です。選択したユーザー・インタフェースに基づいて、適切なページ・タイプ、属性およびテーマを表示するようウィザードが最適化されています。

表、問合せまたはドリルダウン問合せに基づいてデータベース・アプリケーションを作成するには、次の手順を実行します。

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

2. 「作成」ボタンをクリックします。

3. アプリケーション・タイプを選択し、「デスクトップ」を選択して「次へ」をクリックします。

4. 「名前」で、次のステップを実行します。

1. スキーマ: アプリケーションは、すべてのSQLを特定のデータベース・スキーマとして解析することで、権限を取得します。データベース・スキーマ所有者を指定します。

2. 名前: 開発者がアプリケーションを識別するための名前を入力します。

3. アプリケーション: アプリケーションを識別する整数値を指定します。アプリケーションIDは、Application Expressインスタンス内で一意である必要があります。3000から9000の範囲のアプリケーションIDは、Oracle Application Expressの内部使用向けに予約されています。

4. テーマ: テーマを選択します。テーマは、アプリケーション全体のレイアウトおよびスタイルの定義に使用するテンプレートのコレクションです。
使用可能なテーマを表示するには、「テーマを選択」をクリックします。標準テーマが表示されます。追加テーマを表示するには、「表示」リストから選択します。テーマを選択すると、アプリケーションによって自動的にサブスクライブされます。詳細は、「テーマの使用」および「テーマのサブスクリプションの理解」を参照してください。

5. テーマ・スタイル: テーマ・スタイルを選択します。テーマ・スタイルは、テーマ42および51などの新しいアプリケーションに対してのみ使用可能です。「テーマ・スタイルの使用」を参照してください。

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

ヒント:
ログイン・ページと空白ページのみが含まれたインスタント・アプリケーションを作成するには、「アプリケーションの作成」ボタンをクリックします。

次に、ページをアプリケーションに追加します。

5. 「ページ」で、「ページの追加」をクリックします。
「アプリケーションの作成 - ページの追加」ダイアログで、次のステップを実行します。

1. 「ページ・タイプの選択」で、追加するページ・タイプを選択します。表7-1「アプリケーションの作成ウィザード - 使用可能なページ・タイプ」を参照してください。
アクション: 現在選択済のページ・タイプが表示されます。選択ごとに、表名の選択、レポート実装など異なる情報のタイプが求められます。詳細は、フィールドレベル・ヘルプを参照してください。

2. 「ページの追加」をクリックします。
ページがページ上部に表示されます。ページを削除するには、「削除」アイコン(右側の列のX)をクリックします。

3. すべてのページが追加されるまで前のステップを繰り返します。

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

ヒント:
ウィザードを早期に終了して「アプリケーション・ビルダーのデフォルト値」を使用するには、「アプリケーションの作成」ボタンをクリックします。「アプリケーション・ビルダーのデフォルト値」を構成するには、Oracle Application Express管理ガイドの「アプリケーション・ビルダーのデフォルト値の利用」を参照してください。

6. 「共有コンポーネント」で、共有コンポーネントを別のアプリケーションからコピーするかどうかを指定します。「はい」または「いいえ」を選択します。「はい」を選択した場合は、そのコピー元と、インポートするコンポーネントを選択します。
共有コンポーネントは、アプリケーション内の複数のページ間で表示または適用できる共通アプリケーション要素です。時間を節約するため、またはアプリケーション間の一貫性を保持するために、共有コンポーネントは既存のアプリケーションからコピーします。コピーできる共有コンポーネントのタイプには、ユーザー・インタフェースのテーマ、LOV、ナビゲーション・バー・エントリ、認可スキームおよび認証スキームがあります。別のアプリケーションからテーマをコピーする場合は、テーマをサブスクライブします。詳細は、「テーマのサブスクリプションの理解」を参照してください。

7. 「属性」で、次のステップを実行します。

1. 認証スキーム: アプリケーションにアクセスする前にユーザー・アイデンティティを確立する方法を決定します。オプションは次のとおりです。

- Application Expressアカウント: Application Expressサービス管理アプリケーションで作成および維持されるユーザー・アカウント資格証明を使用します。これらは、Application Express開発環境へのログインに使用するアカウントです。また、アプリケーションのエンド・ユーザー用として、このユーザー・アカウント・リポジトリにアカウントを作成することもできます。

- データベース・アカウント: アプリケーションへのユーザー・ログインには、認証するためにデータベース・スキーマ名(またはユーザー名)とそのパスワードが必要です。このアカウント情報は、Oracle Database全体で管理されます。

- 認証なし: データベース・アカウント資格証明とも呼ばれます。このオプションを使用すると、ユーザーはmod_plsql DAD定義に格納されているアカウント資格証明を使用して、アプリケーションにアクセスできるようになります。ほとんどの場合、アプリケーションへのアクセス時にログインを行う必要がなくなります。これは、公開アプリケーションを最も速く作成する方法です。

詳細は、「認証によるユーザー・アイデンティティの証明」を参照してください。

2. 言語: このアプリケーションのプライマリ言語を選択します。
アプリケーションを開発する言語をこの属性で指定します。この言語が、すべての変換の元となるベース言語になります。

3. ユーザー言語プリファレンスの派生元: エンジンによるアプリケーション言語の決定方法を指定します。アプリケーションのプライマリ言語は静的にする(Webブラウザの言語から派生される)か、またはユーザー・プリファレンスまたはアイテムから決定されるようにできます。データベース言語の設定では、日付の表示とソート特性を決定します。詳細は、フィールドレベル・ヘルプを参照してください。
「言語」および「ユーザー言語プリファレンスの派生元」属性は、グローバリゼーション属性の編集ページで後から変更できます。「グローバリゼーション属性の構成」を参照してください。

4. 日付書式: アプリケーションで使用する日付書式を指定します。
この日付書式を使用すると、NLS_DATE_FORMATデータベース・セッションの設定が変更されてから、アプリケーション内のページが表示または送信されます。この値には、有効なOracle日付書式マスクを含むリテラル文字列、または置換構文によるアイテム参照を指定できます。値が指定されていない場合は、データベース・セッションからデフォルトの日付書式が実行時に取得されます。指定されている場合は、DATE型の列から得られるすべてのアイテムの日付書式としても使用されます。

5. 日時書式: アプリケーションで使用する日時書式を指定します。
この日時書式は、置換参照&APP_DATE_TIME_FORMAT.を使用するか、PL/SQLでv('APP_DATE_TIME_FORMAT')ファンクションを使用して、アプリケーション内で参照できます。この属性によってNLS設定が変更されることはありません。この値には、有効なOracle日付書式マスクを含むリテラル文字列、または置換構文を使用したアイテム参照を指定できます。この属性値を指定しない場合、APP_DATE_TIME_FORMATへの参照はNLSデータベース・セッションの日付書式とNLS時刻書式を返します。

6. タイムスタンプ書式: アプリケーションで使用するタイムスタンプ書式を指定します。
このタイムスタンプ書式を使用すると、NLS_TIMESTAMP_FORMATデータベース・セッションの設定が変更されてから、アプリケーション内のページが表示または送信されます。この値には、有効なOracleタイムスタンプ書式マスクを含むリテラル文字列、または置換構文を使用したアイテム参照を指定できます。値が指定されていない場合は、データベース・セッションからデフォルトのタイムスタンプ書式が実行時に取得されます。

7. タイムスタンプ・タイムゾーン書式: アプリケーションで使用されるタイムゾーン付きタイムスタンプ書式を指定します。
このタイムゾーン付きタイムスタンプ書式を使用すると、NLS_TIMESTAMP_TZ_FORMATデータベース・セッションの設定が変更されてから、アプリケーション内のページが表示または送信されます。この値には、有効なOracleタイムゾーン付きタイムスタンプ書式マスクを含むリテラル文字列、または置換構文を使用したアイテム参照を指定できます。値が指定されていない場合は、データベース・セッションからデフォルトのタイムゾーン付きのタイムスタンプ書式が実行時に取得されます。

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

8. 選択内容を確認して、「アプリケーションの作成」をクリックします。

関連項目:
「データベース・アプリケーションのページの管理」および「レポートの開発」

7.2.2 スプレッドシートからのデスクトップ・データベース・アプリケーションの作成

スプレッドシート・データに基づいてデスクトップ・アプリケーションを作成するには、アプリケーションの作成ウィザードで「スプレッドシートから」を選択します。

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

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

2. 「作成」ボタンをクリックします。

3. 「スプレッドシートから」を選択します。

4. 「ロード方法」で、スプレッドシート・データのインポート方法を指定します。次のいずれかを選択し、「次へ」をクリックします。

1. ファイルをアップロード(カンマ区切り(*.csv)またはタブ区切り):次の項目を指定し、「次へ」をクリックします。

- テキスト・ファイル: ファイルの選択をクリックし、アップロードされるファイルを指定します。

- 「セパレータ」: カンマ区切り文字を指定します。タブ区切りには\tを使用します。

- 「囲み文字(オプション)」 - 区切り文字を入力します。この文字は、データ値の始まりと終わりを区切るために使用できます。区切り文字を指定した場合、データ値の始まりと終わりの前にあるスペースはウィザードで無視されます。このオプションを使用すると、指定した区切り文字でデータ値を囲むこともできます。

- 1行目のデータに列名が含まれる: 該当する場合、このオプションを選択します。

- 「ファイルのキャラクタ・セット」: テキスト・ファイルのエンコードに使用されるキャラクタ・セットを選択します。

2. コピー・アンド・ペースト: インポートするタブ区切りデータをコピーして貼り付けます。

5. 「表のプロパティ」で、次のステップを実行します。

1. スキーマ: データベース・スキーマ所有者を指定します。

2. 表: 作成する表の名前を入力します。

3. 表のプロパティを設定: 表のプロパティを確認します。データ・タイプを変更するか、または、書式masksを入力します。「アップロード」リストから「はい」または「いいえ」を選択して、列を含まれるかどうかを指定します。

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

6. 「ユーザー・インタフェースのデフォルト値」で、次のステップを実行します。

1. 表示された単数形の名前および複数形の名前を確認します。

2. (オプション)「列のユーザー・インタフェースのデフォルト値」で、表示された列ラベルを確認します。

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

7. 「アプリケーション・オプション」で、次のように指定します。

1. アプリケーション名: このアプリケーションの名前を英数字で入力します。

2. モードを作成します。

- 読取り専用: ページの挿入および更新は含まれません。

- 読み書き両用: ページの挿入および更新が含まれます。

3. レポート実装:

- クラシック: SQL レポートを作成します。

- 対話モード: 対話モード・レポートを作成します。

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

8. 「ユーザー・インタフェースのテーマ」で、テーマを選択し、「次へ」をクリックします。
テーマは、アプリケーション全体のレイアウトおよびスタイルの定義に使用するテンプレートのコレクションです。選択したテーマに応じて、テーマ・スタイルも表示できます。「テーマの使用」および「テーマ・スタイルの使用」を参照してください。

9. 選択内容を確認して、「アプリケーションの作成」をクリックします。

7.2.3 データベース・アプリケーションのコピー

アプリケーションの作成ウィザードを実行するか、アプリケーションのホームページでアプリケーションを選択してから「このアプリケーションのコピー」を選択することによって、既存のアプリケーションのコピーを作成できます。

- アプリケーションの作成ウィザードを使用したデータベース・アプリケーションのコピー

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

7.2.3.1 アプリケーションの作成ウィザードを使用したデータベース・アプリケーションのコピー

アプリケーションの作成ウィザードを実行してアプリケーションをコピーするには、次のステップを実行します。

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

2. 「作成」ボタンをクリックします。

3. 「既存アプリケーションのコピー」を選択します。

4. 「コピーのターゲットを指定」で、次のステップを実行します。

1. コピー元: コピーするアプリケーションの名前を選択します。

2. コピー先: アプリケーションの説明的な短い名前を入力し、選択リストおよびレポートで新しいアプリケーションを識別できるようにします。

3. 新しいアプリケーションID: アプリケーションを識別するための一意の整数値を入力します。3000から9000の間のアプリケーションIDは内部使用向けに予約されています。

4. サポートするオブジェクトの定義のコピー: サポートするオブジェクトの定義を含めるかどうかを指定します。オプションは次のとおりです。

- はい: データベース・オブジェクト定義、イメージ定義、およびシード・データSQL文を単一のファイルにカプセル化して含めます。

- いいえ: サポートするオブジェクトの定義を含めません。

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

5. 「アプリケーションの作成」をクリックします。

7.2.3.2 アプリケーションのホームページからのアプリケーションのコピー

アプリケーションのホームページからデータベース・アプリケーションをコピーするには、次のステップを実行します。

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

2. アプリケーションを選択します。
アプリケーションのホームページが表示されます。

3. 「タスク」リストで「このアプリケーションのコピー」をクリックします。

4. 「コピーのターゲットを指定」で、次のステップを実行します。

1. 新しいアプリケーションID: アプリケーションを識別するための一意の整数値を入力します。3000から9000の間のアプリケーションIDは内部使用向けに予約されています。

2. 新しいアプリケーション名: アプリケーションの説明的な短い名前を入力し、選択リストおよびレポートで新しいアプリケーションを識別できるようにします。

3. サポートするオブジェクトの定義のコピー: サポートするオブジェクトの定義を含めるかどうかを指定します。オプションは次のとおりです。

- はい: データベース・オブジェクト定義、イメージ定義、およびシード・データSQL文を単一のファイルにカプセル化して含めます。

- いいえ: サポートするオブジェクトの定義を含めません。

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

5. 「アプリケーションのコピー」をクリックします。

7.3 モバイル・アプリケーションの作成

モバイル・アプリケーションは特にモバイル・デバイスで実行するように設計されるので、モバイル接続に最適化された、最小のセマンティックHTMLで構築される必要があります。この項では、Oracle Application Expressでモバイル・アプリケーションを作成する方法を説明します。

- jQuery Mobileのサポートについて

- モバイル・アプリケーションの作成

関連項目:
「ユーザー・インタフェース設計の管理」、「レスポンシブ・デザインについて」および「アプリケーションの削除」

7.3.1 jQuery Mobileのサポートについて

モバイル・アプリケーション開発をサポートするために、Oracle Application ExpressにはjQuery Mobileが組み込まれています。jQuery MobileベースのWebページは、ごく少数のイメージおよびCSSファイルしか含まない、コンパクトで最小主義のWebサイトを作成できる、軽量なフレームワークを使用します。jQuery Mobileを使用して、これらのアプリケーションは、モバイル・オペレーティング・システム(iOS、Android、BlackberryおよびWindows Mobile)で実行することができます。

jQuery Mobileは、方向の変更やタッチ・イベントなどのモバイル・デバイス特有のイベントをサポートします。ThemeRollerなどのツールを使用するCSSを変更することで、jQuery Mobileベース・アプリケーションのルック・アンド・フィールを簡単に変更できます。詳細は次の場所を参照してください。

http://themeroller.jquerymobile.com/

関連項目:
http://jquerymobile.com/および「ユーザー・インタフェース設計の管理」

7.3.2 モバイル・アプリケーションの作成

モバイル・アプリケーションを作成するには:

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

2. 「作成」ボタンをクリックします。

3. アプリケーション・タイプで、「モバイル」を選択して「次へ」をクリックします。

4. 「名前」で、次のステップを実行します。

1. スキーマ: アプリケーションは、すべてのSQLを特定のデータベース・スキーマとして解析することで、権限を取得します。データベース・スキーマ所有者を指定します。

2. 名前: 開発者がアプリケーションを識別するための名前を入力します。

3. アプリケーション: アプリケーションを識別する整数値を指定します。アプリケーションIDは、Application Expressインスタンス内で一意である必要があります。3000から9000の範囲のアプリケーションIDは、Oracle Application Expressの内部使用向けに予約されています。

4. テーマ: テーマを選択します。テーマは、アプリケーション全体のレイアウトおよびスタイルの定義に使用するテンプレートのコレクションです。「テーマの使用」を参照してください。

5. テーマ・スタイル: テーマ・スタイルを選択します。テーマ・スタイルは、テーマ42および51などの新しいアプリケーションに対してのみ使用可能です。「テーマ・スタイルの使用」を参照してください。

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

ヒント:
ログイン・ページと空白ページのみを含むインスタント・アプリケーションを作成するには、「アプリケーションの作成」ボタンをクリックします。

次に、ページをアプリケーションに追加します。

5. 「ページ」で、「ページの追加」をクリックします。
「アプリケーションの作成 - ページの追加」ダイアログで、次のステップを実行します。

1. 「ページ・タイプの選択」で、追加するページ・タイプを選択します。表7-1「アプリケーションの作成ウィザード - 使用可能なページ・タイプ」を参照してください。
使用可能なページ・タイプは、前のステップで選択したユーザー・インタフェースによって異なります。

アクション: 現在選択済のページ・タイプが表示されます。選択ごとに、表名の選択、レポート実装など異なる情報のタイプが求められます。詳細は、フィールドレベル・ヘルプを参照してください。

2. 「ページの追加」をクリックします。
ページがページ上部に表示されます。ページを削除するには、「削除」アイコンをクリックします。

3. すべてのページが追加されるまで前のステップを繰り返します。

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

ヒント:
ウィザードを早期に終了して「アプリケーション・ビルダーのデフォルト値」を使用するには、「アプリケーションの作成」ボタンをクリックします。「アプリケーション・ビルダーのデフォルト値」を構成するには、Oracle Application Express管理ガイドの「アプリケーション・ビルダーのデフォルト値の利用」を参照してください。

6. 「共有コンポーネント」で、共有コンポーネントを別のアプリケーションからコピーするかどうかを指定します。「はい」または「いいえ」を選択します。「はい」を選択した場合は、そのコピー元と、インポートするコンポーネントを選択します。
共有コンポーネントは、アプリケーション内の複数のページ間で表示または適用できる共通アプリケーション要素です。時間を節約するため、またはアプリケーション間の一貫性を保持するために、共有コンポーネントは既存のアプリケーションからコピーします。コピーできる共有コンポーネントのタイプには、ユーザー・インタフェースのテーマ、LOV、ナビゲーション・バー・エントリ、認可スキームおよび認証スキームがあります。

7. 「属性」で、次のステップを実行します。

1. 認証スキーム: アプリケーションにアクセスする前にユーザー・アイデンティティを確立する方法を決定します。
詳細は、フィールドレベル・ヘルプおよび「認証によるユーザー・アイデンティティの証明」を参照してください。

2. 言語: このアプリケーションのプライマリ言語を選択します。
アプリケーションを開発する言語をこの属性で指定します。この言語が、すべての変換の元となるベース言語になります。

3. ユーザー言語プリファレンスの派生元: エンジンによるアプリケーション言語の決定方法を指定します。アプリケーションのプライマリ言語は静的にする(Webブラウザの言語から派生される)か、またはユーザー・プリファレンスまたはアイテムから決定されるようにできます。データベース言語の設定では、日付の表示とソート特性を決定します。詳細は、フィールドレベル・ヘルプを参照してください。
「言語」および「ユーザー言語プリファレンスの派生元」属性は、グローバリゼーション属性の編集ページで後から変更できます。「グローバリゼーション属性の構成」を参照してください。

4. 日付書式: アプリケーションで使用する日付書式を指定します。
この日付書式を使用すると、NLS_DATE_FORMATデータベース・セッションの設定が変更されてから、アプリケーション内のページが表示または送信されます。この値には、有効なOracle日付書式マスクを含むリテラル文字列、または置換構文によるアイテム参照を指定できます。値が指定されていない場合は、データベース・セッションからデフォルトの日付書式が実行時に取得されます。指定されている場合は、DATE型の列から得られるすべてのアイテムの日付書式としても使用されます。

5. 日時書式: アプリケーションで使用する日時書式を指定します。
この日時書式は、置換参照&APP_DATE_TIME_FORMAT.を使用するか、PL/SQLでv('APP_DATE_TIME_FORMAT')ファンクションを使用して、アプリケーション内で参照できます。この属性によってNLS設定が変更されることはありません。この値には、有効なOracle日付書式マスクを含むリテラル文字列、または置換構文を使用したアイテム参照を指定できます。この属性値を指定しない場合、APP_DATE_TIME_FORMATへの参照はNLSデータベース・セッションの日付書式とNLS時刻書式を返します。

6. タイムスタンプ書式: アプリケーションで使用するタイムスタンプ書式を指定します。
このタイムスタンプ書式を使用すると、NLS_TIMESTAMP_FORMATデータベース・セッションの設定が変更されてから、アプリケーション内のページが表示または送信されます。この値には、有効なOracleタイムスタンプ書式マスクを含むリテラル文字列、または置換構文を使用したアイテム参照を指定できます。値が指定されていない場合は、データベース・セッションからデフォルトのタイムスタンプ書式が実行時に取得されます。

7. タイムスタンプ・タイムゾーン書式: アプリケーションで使用されるタイムゾーン付きタイムスタンプ書式を指定します。
このタイムゾーン付きタイムスタンプ書式を使用すると、NLS_TIMESTAMP_TZ_FORMATデータベース・セッションの設定が変更されてから、アプリケーション内のページが表示または送信されます。この値には、有効なOracleタイムゾーン付きタイムスタンプ書式マスクを含むリテラル文字列、または置換構文を使用したアイテム参照を指定できます。値が指定されていない場合は、データベース・セッションからデフォルトのタイムゾーン付きのタイムスタンプ書式が実行時に取得されます。

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

8. 選択内容を確認して、「アプリケーションの作成」をクリックします。

関連項目:
「ユーザー・インタフェース設計の管理」

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

アプリケーションの削除は、アプリケーション・ビルダー内から行うことができます。または、アプリケーション属性の編集中にも削除できます。アプリケーションを削除すると、定義されたコンポーネント(レポート、チャートまたはフォーム)、ページ・コントロール(ボタン、アイテムまたはLOV)および共有コンポーネント(ブレッドクラム、リストおよびタブ、ただし、ユーザー・インタフェースのデフォルト値を除く)もすべて削除されます。

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

- 「アプリケーション定義の編集」ページからのアプリケーションの削除

関連項目:
「サポートするオブジェクトの削除」および「インストールしたパッケージ・アプリケーションの削除」

7.4.1 アプリケーションのホームページからのアプリケーションの削除

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

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

2. アプリケーションを選択します。
アプリケーションのホームページが表示されます。

3. アプリケーションのホームが表示されたら、ページ上部のアプリケーションIDおよびアプリケーション名を確認します。

4. 「タスク」リストで「このアプリケーションの削除」をクリックします。

5. プロンプトが表示されたら、「今すぐ完全に削除」をクリックします。

7.4.2 「アプリケーション定義の編集」ページからのアプリケーションの削除

「アプリケーション定義の編集」ページからアプリケーションを削除するには、次のようにします。

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

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

3. アプリケーション名の右側にある「アプリケーション・プロパティの編集」ボタンをクリックします。
「アプリケーション定義の編集」ページが表示されます。

4. アプリケーションIDおよびアプリケーション名を確認します。

5. ページの上部の「削除」をクリックします。

6. プロンプトが表示されたら、「今すぐ完全に削除」をクリックします。

関連項目:
「アプリケーション属性の編集」

7.5 アプリケーション属性の管理

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

- アプリケーション属性の編集

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

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

- アプリケーションのユーザー・インタフェースの管理

関連項目:
サポートするオブジェクト・ユーティリティを使用したパッケージ・アプリケーションの作成方法の詳細は、「カスタム・パッケージ・アプリケーションの作成方法」を参照してください。

7.5.1 アプリケーション属性の編集

この項では、アプリケーション属性(アプリケーション定義とも呼ばれる)を編集する方法について説明します。編集する一般的な属性には、アプリケーション名、プリケーションの可用性および事前定義された置換文字列が含まれます。

- アプリケーション定義の編集ページへのアクセス

- アプリケーション定義の編集ページ

7.5.1.1 アプリケーション定義の編集ページへのアクセス

アプリケーション定義の編集ページで、アプリケーション属性を編集します。

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

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

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

3. アプリケーション名の右側にある「アプリケーション・プロパティの編集」ボタンをクリックします。

「アプリケーション定義の編集」ページが表示されます。

7.5.1.2 アプリケーション定義の編集ページ

次の項では、アプリケーション定義の編集ページのリージョンおよび属性について説明します。ここで説明する属性に加えて、アプリケーション定義の編集ページには、定義済のビルド・オプション、関連するテーマ、テンプレートのデフォルト、およびコンポーネントのデフォルトが表示されます。必須の値には赤いアスタリスク(*)が付いています。

- 名前

- プロパティ

- 可用性

- エラー処理

- グローバル通知

- 置換

- ビルド・オプション

7.5.1.2.1 名前

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

表7-2「アプリケーション定義」の「名前」

属性

説明

名前

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

アプリケーションの別名

代替の英数字アプリケーション識別子を割り当てます。アプリケーション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」を使用している場合、アプリケーション・ビルダーは、この書式マスクをすべてのアプリケーション属性の最終更新日に置換します。

アプリケーション・グループ

このアプリケーションに現在関連付けられているアプリケーション・グループを表示します。別のアプリケーション・グループを選択するには、リストから選択します。既存のグループからアプリケーションを削除するには、「未割当て」を選択します。

関連項目: 「アプリケーション・グループの管理」

7.5.1.2.2 プロパティ

「プロパティ」セクションを使用して、「ロギング」、「デバッグ」、「完全置換」、「アプリケーション・グループ」、「フィードバック」および「デフォルトのエラー表示位置」属性を有効化します。表7-3に、「名前」のすべての属性を示します。

表7-3「アプリケーション定義」の「プロパティ」

属性

説明

ロギング

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

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

この属性は、Oracle Application Express管理サービスの「アプリケーション・アクティビティのロギング」属性が「アプリケーションの設定を使用(デフォルト)」に設定されている場合のみ変更できます。

関連項目: 『Oracle Application Express管理ガイド』のロギングのアプリケーション・アクティビティの有効化に関する説明。

デバッグ

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

- はい: デバッグ・モードでのアプリケーションの実行が有効になります。

- いいえ: エンド・ユーザーがデバッグ・モードでアプリケーションを実行できないようにします。

デバッグ・モードでのアプリケーションの実行は、アプリケーションが開発中の場合に役立ちます。ただし、本番アプリケーションの場合は、デバッグを無効にし、アプリケーション・ロジックをあいまいにすることをお薦めします。

フィードバックを許可

このアプリケーションに対するエンド・ユーザーのフィードバックへのサポートを有効にします。「はい」または「いいえ」を選択します。

このオプションを有効にする場合は、フィードバック・ページと、そのページをコールするナビゲーション・バー・アイコンを作成する必要があります。フィードバックを後で無効にすると、ナビゲーション・バー・アイコンは非表示になります。

関連項目: 「フィードバックの管理」

互換性モード

この属性は、Application Expressランタイム・エンジンの互換性モードを制御します。一部のランタイム動作はリリースのたびに変更されます。この属性を使用して、特定のアプリケーション動作を取得します。アプリケーションで新しい動作を認識するには、アプリケーションの互換性モードを最新バージョンに設定します。

アプリケーションの電子メール送信元アドレス

アプリケーションで送信元アドレスとして使用する電子メール・アドレスを決定します。

電子メール・ダウンロードまたはサブスクリプションから電子メールを送信するときに送信元アドレスとしてい使用する有効な電子メール・アドレスを入力します。値には、有効な電子メールを含むリテラル文字列、または置換構文APP_EMAILを使用してアプリケーションで定義された静的置換参照を指定できます。次に例を示します。

john.doe@abc.com
&MY_APP_EMAIL_FROM.

アイテムの置換は、電子メール・ダウンロードでのみ機能し、サブスクリプションでは機能しないため、アプリケーションまたはページレベルでのアイテムの置換の使用はお薦めしません。

「対話モード・レポートの属性」ページで送信元アドレスを指定することもできます。「コンポーネント・ビューでのクラシック・レポート属性の編集」を参照してください。

プロキシ・サーバー

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

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

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

7.5.1.2.3 可用性

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

表7-4「アプリケーション定義」の「可用性」

属性

説明

ステータス

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

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

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

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

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

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

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

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

関連項目: 『Oracle Application Express管理ガイド』の複数のアプリケーションのビルド・ステータスの変更に関する項、『Oracle Application Express管理ガイド』のデプロイ時のアプリケーションのビルド・ステータス・セットの変更に関する項および「アプリケーション、ページおよびページ・コンポーネントへのアクセスの制御」

ビルド・ステータス

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

- アプリケーションの実行および構築: 開発者とユーザーのどちらもアプリケーションを実行および開発できます。

- アプリケーションの実行のみ: ユーザーはアプリケーションの実行のみが可能です。このオプションは、本番インスタンスのアプリケーション用です。

関連項目: Oracle Application Express管理ガイドの「デプロイ時のアプリケーションのビルド・ステータス・セットの変更」

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

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

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

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

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

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

7.5.1.2.4 エラー処理

表7-5に示す「エラー処理」属性を使用して、アプリケーションがエラーのログを記録する方法を制御または変更します。

ヒント:
ここで指定するエラー処理ファンクションは、同様のページ・レベル属性によって上書きされます。

表7-5 「アプリケーション定義」の「エラー処理」

属性

説明

デフォルトのエラー表示位置

Application Expressまたはプラグインによって実行される基本検証の検証エラー・メッセージを表示する位置を指定します。検証エラー・メッセージは、通知領域(ページ・テンプレートの一部として定義)またはフィールド・ラベル内に表示できます。オプションは次のとおりです。

- フィールドおよび通知でインライン表示: エラー・メッセージは、ページ・テンプレートの一部として定義される通知領域に表示されます。

- フィールドでインライン表示: エラー・メッセージはフィールド・ラベル内に表示されます。

- 通知でインライン表示: ページでエラーが発生した場合に#NOTIFICATION_MESSAGE#テンプレート置換文字列に表示されます。

エラー処理ファンクション

既存のエラー・メッセージを変更し、よりわかりやすいメッセージを表示するか、エラーが発生した場合にそれをログに記録するためにコールするPL/SQLエラー・ファンクションの名前を入力します。このファンクションは、データベース内のパッケージ・ファンクションまたはスタンドアロンのファンクションを参照できます。次に例を示します。

log_apex_error

データベースのPL/SQLパッケージまたはスタンドアロンのファンクションを参照する場合、#OWNER#置換文字列を使用して、カレント・アプリケーションの解析対象スキーマを参照します。次に例を示します。

#OWNER#.log_apex_error

apex_errorパッケージで説明されている構文を使用してエラー処理ファンクションを実装する必要があります。

function <name of function> (
p_error in apex_error.t_error )
return apex_error.t_error_result

関連項目: 『Oracle Application Express APIリファレンス』のapex_errorに関する説明

注意: ここで指定するエラー処理ファンクションは、ページ・レベルで指定されるエラー処理により上書きされます。

7.5.1.2.5 グローバル通知

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

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

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

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

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

関連項目:
「置換文字列の理解」および「ページ・テンプレート」

7.5.1.2.6 置換

「置換」セクションを使用して、アプリケーションで使用する静的置換文字列を定義します。アプリケーション内の多くの場所に出現する文字列やラベルに静的置換文字列を使用できます。置換文字列を作成するには、「置換文字列」列に文字列名を、「置換値」列に文字列値を入力します。

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

関連項目:
「置換文字列の理解」

7.5.1.2.7 ビルド・オプション

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

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

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

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

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

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

- セキュリティ属性ページ

関連項目:
「アプリケーション・セキュリティの管理」

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

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

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

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

3. 「共有コンポーネント」をクリックします。
共有コンポーネント・ページが表示されます。

4. 「セキュリティ」で、「セキュリティ属性」をクリックします。
セキュリティ属性の編集ページが表示されます。

セキュリティ属性の編集ページは複数のセクションに分かれています。ページ上部のタブを選択すると、選択したセクションが表示され、その他のセクションはすべて一時的に非表示になります。ページのすべてのセクションを表示するには、「すべて表示」をクリックします。

ヒント:
「アプリケーション定義の編集」にナビゲートして「セキュリティ」タブをクリックしても、「セキュリティ属性の編集」にアクセスできます。「アプリケーション定義の編集ページへのアクセス」を参照してください。

7.5.2.2 セキュリティ属性ページ

次の項では、セキュリティ属性の編集ページのリージョンおよび属性について説明します。

- 認証

- 認可

- セッション管理

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

- ブラウザ・セキュリティ

- データベース・セッション

7.5.2.2.1 認証

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

表7-6 認証属性

属性

説明

パブリック・ユーザー

データベース・アクセス記述子(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」および「条件付きのレンダリングおよびプロセスの理解」

認証スキーム

アプリケーションに定義されている認証スキームから選択します。認証スキームを作成するには、「認証スキームの定義」をクリックします。

関連項目: 「認証の仕組み」および「認証スキームの作成」

7.5.2.2.2 認可

認可は、ユーザー権限に基づいて、特定のコントロールまたはコンポーネントへのユーザーのアクセスを制御します。表7-7に、「認可」で使用可能な属性を示します。

表7-7 「認可」属性

属性

説明

認可スキーム

このリストから選択して、アプリケーションの認可スキームを指定します。

たとえば、会社の従業員のみがアプリケーションにログインできるようにするには、ユーザーの電子メールが@somecompany.comで終わる場合にtrueになる認可スキームを定義し、このオプションでその認可スキームを選択します。アプリケーション全体に1つの認可スキームのみを割り当てることができます。ただし、認可スキームは、個々のページ、ページ・コントロール(リージョン、ボタン、アイテムなど)または共有コンポーネント(メニュー、リスト、タブなど)に割り当てることができます。

認可スキームの定義

「認可スキームの定義」をクリックして、認可スキームを作成します。

パブリック・ページで実行

パブリック・ページ(つまり、認可を必要としないページ)で、アプリケーション・レベルの認可スキームをチェックするかどうかを制御するには、「パブリック・ページで実行」を使用します。オプションは次のとおりです。

- はい: 「はい」を選択し、ページがパブリックの場合は、アプリケーション認可がチェックされます。

- いいえ: 「いいえ」を選択し、ページがパブリックの場合は、アプリケーション認可が無視されます。

通常、認可はユーザー名に依存するため、アプリケーション・レベルの認可は、(「パブリック・ページで実行」にかかわらず)ログイン・ページでは評価されません。

関連項目:
「アプリケーションへの認可スキームの割当て」

7.5.2.2.3 セッション管理

「セッション・タイムアウト」属性を使用して、アプリケーションでWebブラウザが開いたまま放置されたコンピュータに対する公開を抑制します。表7-8に、「セッション・タイムアウト」で使用可能な属性を示します。

表7-8 「セッション管理」

属性

説明

セッションを再結合

「セッションを再結合」属性は、Application ExpressがセッションIDを含まないアプリケーションURLをサポートするかどうかを制御します。セッションの再結合が有効で、URLにセッションIDが含まれていない場合、Application ExpressはセッションCookieを使用して既存のセッションを結合することを試みます。

このページ・レベルの値は、より制限的なインスタンス・レベルの設定によってオーバーライドされます。

注意: セッションの再結合を有効にすると、攻撃者が既存のエンド・ユーザー・セッションを乗っ取ることが可能になるため、アプリケーションのセキュリティが侵害される可能性があります。「「セッションを再結合」について」を参照してください。

「セッションを再結合」のオプションは次のとおりです。

- 無効 - URLにセッションIDが含まれていない場合、Application Expressは新しいセッションを作成します。

- パブリック・セッションに対して有効 - URLがパブリック・ページのもので、セッションIDが含まれていない場合、Application Expressはそのアプリケーションに対して確立された既存のセッションCookieの利用を試みます。Application Expressは、セッションがまだ認証されていない場合にのみCookieを使用して結合します。

- すべてのセッションに対して有効 - URLにセッションIDが含まれておらず、次の条件が満たされる場合、Application Expressはそのアプリケーションに対して確立された既存のセッションCookieの利用を試みます。
セッション・ステート保護がそのアプリケーションに対して有効で、URLに有効なチェックサムが含まれています。パブリック・ブックマークの場合、最も制限的なアイテム・レベルの保護は「制限なし」または「チェックサムが必要 - アプリケーション・レベル」である必要があります。

または、URLにペイロードが含まれていません(リクエスト・パラメータ、クリア・キャッシュまたはデータ値ペア)。

このオプションでは、「フレームへの埋込み」が「同じ起点から許可」または「拒否」に設定されている必要があります。これはURLペイロードの条件に関連付けられませんが、セッション・ステート保護されるURLにも適用されます。

ディープ・リンク

この属性を使用して、アプリケーションのディープ・リンクを有効または無効にします。オプションは次のとおりです。

- 有効: 特定のページへのURLは、最終的にそのページにリダイレクトされます(場合によってはユーザーのログイン後)。

- 無効: URLに有効なセッションIDが含まれていない場合、Application Expressは新しいセッションを開始し、アプリケーションのホーム・ページにリダイレクトします。

たとえば、多くの場合、ブラウザは開いたタブのURLを保存し、再起動後にセッションをリストアしようとするため、ディープ・リンクが発生します。この動作は望ましくない場合があります(URLがマルチステップ・ウィザードの途中のページを指す場合など)。「無効化」を選択すると、Application Expressは新しいセッションを開始し、アプリケーションのホーム・ページにリダイレクトします。

関連項目: ページ・レベルでこの動作を上書きする場合の詳細は、「セキュリティ」を参照してください。

最大セッションの長さ

セッションが存在し、このアプリケーションにより使用される秒数を制御する正の整数を入力します。インスタンス・レベルの設定に値を戻すには、この値をNULLのままにします。セッションが無期限に存在するようにするには、0を入力します。セッション存続期間より、8時間ごとに実行され、12時間より前から存在するセッションを削除するジョブの操作が優先される場合があります。

セッション・タイムアウトURL

最大セッション存続期間を超えた際にリダイレクトされるオプションのURLを入力します。このURLのターゲット・ページは、Application Expressで実装された場合、パブリック・ページである必要があります。このページの一般的な用途は、ユーザーにセッションの有効期間を知らせ、ログイン・リンクや他のオプションを表示することです。URLを指定しない場合、リダイレクト先はアプリケーションのホームページになります。

次の3つの置換アイテムのみがサポートされます。

- &APP_SESSION.

- &SESSION.

- &APP_ID.

このURLは特別な目的を持つため、リンクに&APP_SESSION.および&SESSION.のいずれも含める必要はありません。

最大セッション・アイドル時間

このアプリケーションで使用するセッションの停止またはアイドル時間を制御する正の整数を入力します。アイドル時間は、あるページ・リクエストと次のページ・リクエストとの間の時間です。インスタンス・レベルの設定に値を戻すには、この値をNULLのままにします。0に設定すると、セッションのアイドル時間のチェックは行われません。

セッション・アイドル・タイムアウトURL

最大セッション・アイドル時間を超えた際にリダイレクトされるオプションのURLを入力します。このURLのターゲット・ページは、Application Expressで実装された場合、パブリック・ページである必要があります。このページの一般的な用途は、ユーザーにセッションのタイムアウトを知らせ、ログイン・リンクや他のオプションを表示することです。URLを指定しない場合、リダイレクト先はアプリケーションのホームページになります。

このURLでは次の3つの置換アイテムのみがサポートされます:

- &APP_SESSION.

- &SESSION.

- &APP_ID.

リンクに&APP_SESSION.または&SESSION.のいずれかを含める必要はありません。

関連項目:
「セッション・タイムアウトの使用について」および『Oracle Application Express管理ガイド』のセッション・タイムアウトの構成に関する項

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

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

表7-9 「セッション・ステート保護」

属性

説明

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

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

この後に作成されるURLの許可

ブックマーク済リンクにチェックサムが含まれ、セッション・ステート保護がアプリケーションに対して有効な場合、ブックマーク済リンクをこのアプリケーションのページへのアクセスに使用できるようになった日時がリストされます。

この日付および時間より前に作成されたブックマークは、ブックマーク済リンクにチェックサムが含まれ、セッション・ステート保護がアプリケーションに対して有効な場合、このアプリケーションへのアクセスに使用できません。チェックサムを含まないブックマークまたは不要なチェックサムを含むブックマークは、この属性による影響を受けません。これらの有用性は、他の基準を使用して決定されます。非表示のアプリケーション属性(チェックサム・ソルト)は、計算時と、ページのレンダリング時に生成されたf?p= URLに含まれるチェックサムのその後の検証時に使用されます。チェックサムは、「セッション・ステート保護」がアプリケーションに対して有効な場合に含まれます。このチェックサム・ソルト属性は、「ブックマークの無効化」ボタンをクリックすると、いつでもリセットできます。

ブックマーク・ハッシュ関数

ブックマーク可能なURLのアプリケーション・レベルおよびユーザー・レベルのチェックサムを作成するために使用します。

ブックマークの無効化

「ブックマークの無効化」をクリックすると、この非表示のアプリケーション属性(チェックサム・ソルト)のソルト属性をいつでもリセットできます。このボタンをクリックすると、以前に生成されたチェックサムを含むブックマーク済URLは、その後にアプリケーションへのアクセスに使用されるときに失敗します。

ヒント: 「ブックマークの無効化」をクリックして、ブックマーク・ハッシュ関数を変更し、チェックサムを計算する別のアルゴリズムに切り替えることもできます。

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

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

関連項目:
「セッション・ステート保護の理解」

7.5.2.2.5 ブラウザ・セキュリティ

表7-10に、「ブラウザ・セキュリティ」で使用可能な属性を示します。

表7-10 「ブラウザ・セキュリティ」

属性

説明

キャッシュ

「キャッシュ」を使用して、アプリケーションのページ・コンテンツのブラウザによるキャッシュを有効化または無効化します。有効化すると、ブラウザはこのアプリケーションのページ・コンテンツを、メモリー内とディスク上の両方のキャッシュに保存します。キャッシュが有効になっている場合に、ブラウザの「戻る」ボタンがクリックされると、通常、ページはサーバーからではなくキャッシュからロードされます。無効にすると、ブラウザはアプリケーションのページ・コンテンツを保存しないように指示され、URLが変更されるたびにサーバーから最新のページ・コンテンツをリクエストします。

機密データが保存されないようにするために、この属性を無効にすることをお薦めします。そうしない場合、ログアウト後にブラウザ履歴で前に戻り、以前のセッションのキャッシュされたコンテンツを表示できる可能性があります。ブラウザのキャッシュを無効にすると、部分ページ・リフレッシュを使用するページ(対話モード・レポートを含むページなど)での問題も回避できます。

この属性が「無効」に設定されている場合、ページ・コンテンツをディスク上またはメモリー内にキャッシュしないようにブラウザに指示するHTTPヘッダーcache-control: no-storeがApplication Expressにより送信されます。この機能には、HTTPヘッダー・レスポンス変数cache-controlをサポートする最新のブラウザが必要であることに注意してください。

フレームへの埋込み

ブラウザのフレーム内にアプリケーションのページを表示するかどうかを制御します。使用可能なオプションは次のとおりです。

- 拒否: 実行するサイトに関係なく、ページをフレームに表示できません。

- 同じ起点から許可: ページ自体と同じ起点のフレームにのみ、ページを表示できます。

- 許可: ページを任意のフレームで表示できます。

フレーム内のページの表示は、クリックジャック攻撃で不正に使用される場合があります。クリックジャック攻撃では、攻撃者は複数のレイヤーを使用して、ユーザーがトップ・レベル・ページをクリックしようとしたときに、別のページ上のボタンやリンクをクリックさせます。したがって、意図したページに対するクリック(またはキーストローク)が攻撃者によりハイジャックされ、別のページに移動させられます。

HTMLエスケープ・モード

Oracle Application Expressで特殊文字をエスケープする方法を定義します。オプションは次のとおりです。

- 基本: &、"、<および>をエスケープします

- 拡張: &、"、<、>、'、/およびASCII以外の文字(データベース・キャラクタ・セットがAL32UTF8ではない場合)をエスケープします

HTTPレスポンス・ヘッダー

Oracle Application Expressが各レスポンスで送信する必要があり、別の方法(たとえば、「フレームへの埋込み」属性を使用したX-Frame-Options)でサポートしていないアプリケーション固有の追加のHTTPヘッダーを入力します。

例:

X-XSS-Protection: 1; mode=block

X-Content-Type-Options: nosniff

ヒント:
「キャッシュ」および「フレームへの埋込み」のいずれにも、HTTPヘッダー・レスポンス変数X-Frame-Optionsをサポートする最新のブラウザが必要です。

7.5.2.2.6 データベース・セッション

表7-11に、「データベース・セッション」で使用可能な属性を示します。

表7-11 「データベース・セッション」

属性

説明

解析対象スキーマ

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

初期化PL/SQLコード

この属性を使用して、現在の「ページの表示」または「ページの受入れ」リクエストに関連付けられたデータベース・セッションに対してコンテキストを設定するPL/SQLブロックを入力します。ここに入力したブロックは、ページ・リクエスト時の非常に早い段階(APP_USER値が確立された直後)で実行されます。APP_USERの値(:APP_USERまたはv('APP_USER')を使用)をブロック内で使用できます。セッション・ステート内の他のアイテムの値も参照できますが、これらのアイテムは現在のページ・リクエストが開始する前にセッション・ステートに確立されている必要があります。例を表示するには、フィールドレベル・ヘルプを参照してください。

PL/SQLコードのクリーンアップ

この属性を使用して、ページ・プロセスの最後に実行するPL/SQLブロックを入力します。これは、VPDコンテキストまたはデータベース・リンクなど、使用されたリソースの解放またはクリーンアップに使用できます。例を表示するには、フィールドレベル・ヘルプを参照してください。

ランタイムAPIの使用状況

このアプリケーションによる、アプリケーションとワークスペース・データを変更するOracle Application Express APIへの実行中のアクセス方法を制御します。オプションは次のとおりです。

- このアプリケーションを変更: アプリケーションはアプリケーション自体を変更できます。

- 他のアプリケーションを変更: アプリケーションはワークスペース内の他のアプリケーションを変更できます。

- ワークスペース・リポジトリを変更: アプリケーションはワークスペース・ユーザーとグループを変更できます。

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

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

アプリケーション・ビルダーでは、異なる言語で同時に実行可能なアプリケーションを開発できます。1つのアプリケーションを、異なる言語をサポートするよう変換できます。グローバリゼーション属性の編集ページの属性を使用して、プライマリ・アプリケーション言語などのグローバリゼーション・オプションを指定します。

- グローバリゼーション属性のページへのアクセス

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

関連項目:
「アプリケーションのグローバリゼーションの管理」

7.5.3.1 グローバリゼーション属性のページへのアクセス

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

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

2. アプリケーションを選択します。
アプリケーションのホームページが表示されます。

3. 「共有コンポーネント」をクリックします。
共有コンポーネント・ページが表示されます。

4. 「グローバリゼーション」で、「グローバリゼーション属性」をクリックします。
グローバリゼーション属性の編集ページが表示されます。

ヒント:
「アプリケーション定義の編集」にナビゲートして「グローバリゼーション」タブをクリックしても、グローバリゼーション属性の編集ページにアクセスできます。「アプリケーション定義の編集ページへのアクセス」を参照してください。

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

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

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

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

- アプリケーション日付書式

- アプリケーションの日時書式

- アプリケーションのタイムスタンプ書式

- アプリケーションのタイムスタンプ・タイムゾーン書式

- 文字の値の比較

- 文字の値の比較動作

- 自動タイムゾーン

- 自動CSVエンコーディング

関連項目:
「アプリケーションへのプライマリ言語の指定」

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

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

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

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

アプリケーション・ビルダーでのアプリケーション言語の特定または導出の方法を決定します。

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

このオプションを使用すると、派生したブラウザ言語のサポートを無効にできます。アプリケーションのプリファレンスから派生したアプリケーション言語を指定するオプションも表示されます。詳細は、「フィールドレベル・ヘルプ」を参照してください。

7.5.3.2.3 アプリケーション日付書式

アプリケーションで使用する日付書式を決定します。

この日付書式を使用すると、NLS_DATE_FORMATデータベース・セッションの設定が変更されてから、アプリケーション内のページが表示または送信されます。この値には、有効なOracle日付書式マスクを含むリテラル文字列、または置換構文を使用したアイテム参照を指定できます。値が指定されていない場合は、データベース・セッションからデフォルトの日付書式が実行時に取得されます。次に例を示します。

Month DD, YYYY
&MY_DATE_FORMAT.

7.5.3.2.4 アプリケーションの日時書式

アプリケーションで使用する日時書式を指定します。

この日時書式は、置換参照&APP_DATE_TIME_FORMAT.を使用するか、PL/SQLでv('APP_DATE_TIME_FORMAT')ファンクションを使用して、アプリケーション内で参照できます。この属性によってNLS設定が変更されることはありません。この値には、有効なOracle日付書式マスクを含むリテラル文字列、または置換構文を使用したアイテム参照を指定できます。この属性値を指定しない場合、APP_DATE_TIME_FORMATへの参照はNLSデータベース・セッションの日付書式とNLS時刻書式を返します。次に例を示します。

Month DD, RRRR HH24:MI
&MY_DATE_TIME_FORMAT.

7.5.3.2.5 アプリケーションのタイムスタンプ書式

アプリケーションで使用するタイムスタンプ書式を決定します。LOVからタイムスタンプ書式を選択します。

このタイムスタンプ書式を使用すると、NLS_TIMESTAMP_FORMATデータベース・セッションの設定が変更されてから、アプリケーション内のページが表示または送信されます。この値には、有効なOracleタイムスタンプ書式マスクを含むリテラル文字列、または置換構文を使用したアイテム参照を指定できます。値が指定されていない場合は、データベース・セッションからデフォルトのタイムスタンプ書式が実行時に取得されます。次に例を示します。

DD-MON-RR HH.MI.SSXFF AM
&MY_TIMESTAMP_FORMAT.

7.5.3.2.6 アプリケーションのタイムスタンプ・タイムゾーン書式

アプリケーションで使用するタイムゾーン付きのタイムスタンプ書式を決定します。

この日付書式を使用すると、NLS_TIMESTAMP_TZ_FORMATデータベース・セッションの設定が変更されてから、アプリケーション内のページが表示または送信されます。この値には、有効なOracleタイムスタンプ書式マスクを含むリテラル文字列、または置換構文を使用したアイテム参照を指定できます。値が指定されていない場合は、データベース・セッションからデフォルトのタイムゾーン付きのタイムスタンプ書式が実行時に取得されます。次に例を示します。

DD-MON-RR HH.MI.SSXFF AM TZR
&MY_TIMESTAMP_TZ_FORMAT.

7.5.3.2.7 文字の値の比較

ORDER BY、LIKE、MIN/MAXなど、様々なSQL操作およびSQL句で文字の値を比較する際の照合順序を決定します。

この値を使用すると、クラシック・レポートおよび対話モード・レポート・リージョンのSQL問合せの実行に対するNLS_SORTデータベース・セッション・パラメータが変更されます。値が指定されていない場合は、データベース・セッションからデフォルト値が実行時に取得されます。次に例を示します。

BINARY
GERMAN
CANADIAN_M

7.5.3.2.8 文字の値の比較動作

LIKE、MIN/MAXなど、SQL操作の照合動作を決定します。

この値を使用すると、クラシック・レポートおよび対話モード・レポート・リージョンのSQL問合せの実行に対するNLS_COMPデータベース・セッション・パラメータが変更されます。オプションは次のとおりです。

- データベース・セッションのNLS設定(デフォルト): NLS_COMP値は、実行時にデータベース・セッションから取得されます。

- バイナリ: WHERE句および他のSQL操作での比較はバイナリです。

- 言語形式: WHERE句および他のSQL操作での比較は、「文字の値の比較」属性(NLS_SORT)で指定した言語ソートを使用します。

7.5.3.2.9 自動タイムゾーン

データベース・セッションのタイムゾーンの設定を制御します。「はい」に設定すると、クライアント・タイムゾーンがクライアントのWebブラウザから取得され、Application Expressセッションの継続時間用に設定されます。

その後のページ・ビューには、ページ・ビューごとに適切なデータベース・セッション・タイムゾーンが設定されます。設定後、この設定はAPEX_UTIL.SET_SESSION_TIME_ZONEを使用して上書きしたり、APEX_UTIL.RESET_SESSION_TIME_ZONEを使用して再設定することができます。

関連項目:
『Oracle Application Express APIリファレンス』

7.5.3.2.10 自動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)でエンコードされます。

7.5.4 アプリケーションのユーザー・インタフェースの管理

データベース・アプリケーションを作成する場合、ユーザー・インタフェースを選択します。アプリケーション・ユーザー・インタフェース(デスクトップまたはモバイルなど)によって、アプリケーションのデフォルト特性が決定し、ターゲット環境での表示が最適化されます。ユーザー・インタフェース・ページおよびユーザー・インタフェースの詳細ページで属性を編集することで、ユーザー・インタフェースをカスタマイズできます。

- ユーザー・インタフェース属性へのアクセス

- ユーザー・インタフェース・ページ

- アプリケーション・ロゴの定義

- 新しいユーザー・インタフェースの作成

- ユーザー・インタフェースの詳細ページ

7.5.4.1 ユーザー・インタフェース属性へのアクセス

ユーザー・インタフェース属性にアクセスするには、次のステップを実行します。

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

2. アプリケーションを選択します。
アプリケーションのホームページが表示されます。

3. 「共有コンポーネント」をクリックします。
共有コンポーネント・ページが表示されます。

4. 「ユーザー・インタフェース」で「ユーザー・インタフェース属性」をクリックします。
ユーザー・インタフェース属性ページが表示されます。詳細は、「ユーザー・インタフェース・ページ」を参照してください。

5. 特定のユーザー・インタフェースの属性を編集するには、「ユーザー・インタフェース」までスクロール・ダウンして特定のユーザー・インタフェースを選択します。
ユーザー・インタフェースの詳細ページが表示されます。詳細は、「ユーザー・インタフェースの詳細ページ」を参照してください。

ヒント:
「アプリケーション定義の編集」にナビゲートして「ユーザー・インタフェース」タブをクリックしても、「ユーザー・インタフェース」属性にアクセスできます。「アプリケーション定義の編集ページへのアクセス」を参照してください。

7.5.4.2 ユーザー・インタフェース・ページ

この項では、ユーザー・インタフェース・ページで使用可能なセクションおよび属性について説明します。

- 一般プロパティ

- ロゴ

- ユーザー・インタフェースの検出

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

関連項目:
「ユーザー・インタフェース属性へのアクセス」

ヒント:
このページの属性の詳細は、フィールドレベル・ヘルプを参照してください。「フィールドレベル・ヘルプの表示」を参照してください。

7.5.4.2.1 一般プロパティ

「一般プロパティ」を使用して、アプリケーション・ユーザー・インタフェースの基本的な特性を定義します。表7-12に、「一般プロパティ」のすべての属性を示します。

表7-12 「ユーザー・インタフェース」の「一般プロパティ」

属性

説明

静的ファイルの接頭辞

Webサーバーがアプリケーションの静的ファイルを指定する場合に使用する仮想パスを特定します。この属性を使用すると、アプリケーション内のすべてのファイル参照を変更しないで、静的アプリケーション・ファイルのロード元となる場所を一元的に変更できます。たとえば、この属性を使用すると、Webサーバーのディレクトリを示すことによってデータベースからファイルをロードする必要がなくなり、アプリケーションのパフォーマンスが向上します。

「静的ファイルの接頭辞」を指定すると、置換文字列#APP_IMAGES#によってその値が返されます。たとえば、次のように、参照のために有効なURLを入力できます。

/myFiles/
http://contentDeveliveryNetwork.com/myFiles/

「静的ファイルの接頭辞」を指定しないと、置換string #APP_IMAGES#によって、データベースからファイルをロードする共有コンポーネント、静的ファイルからファイルを参照するURLが返されます。

ヒント: データベースにアプリケーション定義とともに格納されたファイルを参照する場合は、この属性を使用しないでください。

イメージ接頭辞

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

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

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

関連項目: 「IMAGE_PREFIX」

メディア・タイプ

インターネット・メディア・タイプを入力します。インターネット・メディア・タイプは、2つの部分で構成される、インターネット上のファイル形式を表す識別子です。メディア・タイプは、少なくともタイプとサブタイプの2つの部分で構成され、オプションで1つ以上のパラメータを指定します。メディア・タイプは、ページ描画の際にHTTPヘッダーのContent-Typeで使用されます。

ページ・レベルのメディア・タイプが、アプリケーション・レベルのメディア・タイプを上書きします。この属性のデフォルト値はNULLです。ページ・レベルとアプリケーション・レベルの両方でメディア・タイプの値がNULLの場合、メディア・タイプとしてtext/htmlが使用されます。

7.5.4.2.2 ロゴ

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

関連項目:
「アプリケーション・ロゴの定義」

7.5.4.2.3 ユーザー・インタフェースの検出

自動検出が失敗した際に、Oracle Application Expressが使用可能なユーザー・インタフェースを表示するためにロードする必要のあるスタイルシートのCSSファイルURLを入力します。各URLは新規行に書き込む必要があります。ファイルの縮小バージョンを指定する場合、置換文字列#MIN#を使用して、通常ページ・ビューのファイルURLに.minを含めたり、ページをデバッグ・モードに表示する場合は空の文字列を含めることができます。置換文字列#APP_VERSION#を使用して、アプリケーションのバージョンをそのファイルのURLに含めることもできます。URLを入力しない場合、Oracle Application Expressではデフォルトのスタイルシートが使用されます。

例を表示するには、フィールドレベル・ヘルプを参照してください。

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

現在のアプリケーションに定義されているユーザー・インタフェースを表示します。既存のユーザー・インタフェースを編集するには、ユーザー・インタフェース名をクリックします。新しいユーザー・インタフェースを追加するには、「新規ユーザー・インタフェースの追加」をクリックします。

関連項目:
「ユーザー・インタフェース属性へのアクセス」、「新しいユーザー・インタフェースの作成」および「ユーザー・インタフェースの詳細ページ」

7.5.4.3 アプリケーション・ロゴの定義

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

1. ユーザー・インタフェース・ページにアクセスします。「ユーザー・インタフェース属性へのアクセス」を参照してください。
次に、ロゴ属性を指定します。

2. ロゴがイメージの場合:

1. ロゴ・タイプ - 「イメージ」を選択します。

2. ロゴ - ファイル名の拡張子(たとえば、/i/oracle.gif)または完全修飾されたURL (イメージを参照している場合)を含む完全なイメージ名を入力します。
置換文字列を使用して、静的ファイル・リポジトリにアップロードされたイメージを参照できます。詳細は、「静的アプリケーション・ファイルの参照について」および「静的ワークスペース・ファイルの参照について」を参照してください。

3. ロゴ属性 - ロゴの適切な属性を入力するか、リストから選択します。

3. ロゴがテキストの場合:

1. 「ロゴ・タイプ」で、「テキスト」を選択します。

2. ロゴ - 次のような、完全なテキスト文字列を入力します。
Sample Application

3. ロゴ属性 - ロゴの適切な属性を入力するか、リストから選択します。

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

関連項目:
「静的アプリケーション・ファイルの管理」、「静的ワークスペース・ファイルの管理」、「カスタム・テーマの作成」および「ページ・テンプレート」

7.5.4.4 新しいユーザー・インタフェースの作成

新しいユーザー・インタフェースを追加するには、次のステップを実行します。

1. ユーザー・インタフェース・ページにナビゲートします。「ユーザー・インタフェース属性へのアクセス」を参照してください。

2. 「ユーザー・インタフェース」までスクロールし、「新規ユーザー・インタフェースの追加」をクリックします。

3. 画面に表示されるステップに従います。
属性の詳細は、フィールドレベル・ヘルプを参照してください。「フィールドレベル・ヘルプの表示」を参照してください。

4. 選択した内容を確認し、「作成」をクリックします。

関連項目:
「ユーザー・インタフェース属性へのアクセス」および「ユーザー・インタフェースの詳細ページ」

7.5.4.5 ユーザー・インタフェースの詳細ページ

この項では、ユーザー・インタフェースの詳細ページで使用可能なセクションおよび属性について説明します。

- 指定

- 属性

- ナビゲーション・バー

- JavaScript

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

- 連結されたファイル

関連項目:
ユーザー・インタフェースの詳細ページにアクセスする方法の詳細は、「ユーザー・インタフェース属性へのアクセス」を参照してください。

ヒント:
このページの属性の詳細は、フィールドレベル・ヘルプを参照してください。「フィールドレベル・ヘルプの表示」を参照してください。

7.5.4.5.1 指定

表7-13に、「ユーザー・インタフェースの詳細」の「指定」のすべての属性を示します。

表7-13 「ユーザー・インタフェースの詳細」の「指定」

属性

説明

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

選択したインタフェース・タイプを表示します。「デスクトップ」ユーザー・インタフェースは、主としてデスクトップで使用するために設計されたアプリケーションに使用されます。「モバイル」ユーザー・インタフェースは、主としてスマートフォンおよびタブレットで使用するために設計されたアプリケーションに使用されます。

表示名

ユーザー・インタフェースの表示名を指定します。表示名は、テーマの作成ウィザードなどのウィザードに表示されます。

順序

ユーザー・インタフェースの表示順序を指定します。

7.5.4.5.2 属性

表7-14に、「ユーザー・インタフェースの詳細」の「属性」のすべての属性を示します。

表7-14 「ユーザー・インタフェースの詳細」の「属性」

属性

説明

自動検出

ユーザー・インタフェースを自動的に検出する必要があるかどうかを選択します。自動検出を有効にすると、ユーザーは対応するログイン・ページまたはホームページにリダイレクトされます。

デフォルト

ユーザー・インタフェースを、アプリケーションのデフォルトのインタフェースにするかどうかを選択します。

ホームURL

現在のユーザー・インタフェースに対するアプリケーションのホームページを指定します。

ログインURL

現在のユーザー・インタフェースに対するアプリケーションのログイン・ページを指定します。

テーマ

現在ユーザー・インタフェースに関連付けられているテーマを表示します。関連項目: 「テーマの切替え」

テーマ・スタイル

テーマ・スタイルを選択します。このオプションは、テーマ・スタイルをサポートする新しいテーマに対してのみ表示されます。

関連項目: 「テーマ・スタイルの使用」

グローバル・ページ

定義されている場合、アプリケーションのグローバル・ページが表示されます。

関連項目: 「すべてのページにコンポーネントを表示するグローバル・ページの作成」

7.5.4.5.3 ナビゲーション・バー

「ナビゲーション・メニュー」属性は、新しいテーマとともにのみ表示されます。表7-15に、「ナビゲーション・メニュー」属性を示します。

表7-15 「ユーザー・インタフェースの詳細」の「ナビゲーション・メニュー」

属性

説明

実装

このアプリケーションのナビゲーション・バーの実装方法を選択します。オプションは次のとおりです。

- クラシック - ページ・テンプレートの#NAVIGATION_BAR#の位置に、クラシック・ナビゲーション・バーとしてナビゲーション・バーがレンダリングされます。

- リスト - ページ・テンプレートの#NAVIGATION_BAR#の位置に、選択されたリストおよびリスト・テンプレートを使用して、リストとしてナビゲーション・バーがレンダリングされます。

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

アプリケーションのナビゲーション・メニューに利用されるリストを選択します。

リスト・テンプレート

このアプリケーションのナビゲーション・メニューのレンダリングに使用されるリスト・テンプレートを選択します。

テンプレート・オプション

アプリケーションのナビゲーション・メニュー・リストに使用されるリスト・テンプレートのテンプレート・オプションを設定します。

7.5.4.5.4 JavaScript

表7-16で説明する属性を使用して、アプリケーションがJavaScriptを処理する方法を制御または変更します。

表7-16 「ユーザー・インタフェースの詳細」の「JavaScript」

属性

説明

コンテンツ配信ネットワーク

サード・パーティのライブラリ、jQueryおよびjQuery Mobileをロードするために使用するコンテンツ配信ネットワークを指定します。

コンテンツ配信ネットワークを使用すると、ユーザーが、同じコンテンツ配信ネットワークを使用してjQueryファイルをロードする他のWebサイトにアクセスしたことがある場合は、アプリケーションのロード時間を短縮できます。通常、これらのコールはまだブラウザ・キャッシュ内に存在し、再度ダウンロードする必要はありません。ファイルがキャッシュからパージされることは少ないため、特にブラウザ・キャッシュに制限のあるモバイル・デバイスでは、パフォーマンスが向上します。

注意: GoogleおよびMicrosoftコンテンツ・デリバリ・ネットワークでは、現在のところ、jQueryモバイル・ライブラリの正しいバージョンがホストされていないため、いずれかを選択した場合、jQueryライブラリのみがコンテンツ・デリバリ・ネットワークで処理され、jQueryモバイルには引き続きWebサーバーが対応することになります。

ファイルURL

すべてのページにロードするコードのJavaScriptのファイルURLを入力します。各URLを新しい行に記述する必要があります。ファイルの縮小バージョンを指定する場合、置換文字列#MIN#を使用して.minを、または#MIN_DIRECTORY#使用してminified/を通常ページ・ビューのファイルURLに含めたり、ページをデバッグ・モードで表示する場合は空の文字列を含めることができます。

ここに入力したJavaScriptのファイルURLによって、ページ・テンプレート内の#APPLICATION_JAVASCRIPT#置換文字列が置き換えられます。

注意: スクリプトの開始タグや閉じタグを含める必要はありません。URLのみを記述します。

次に例を示します。

- 標準ファイル参照:

/myjs/main.js

- 通常ページ・ビューの縮小ファイルmain.min.jsおよびデバッグ・モードのmain.jsをロードする標準ファイル参照。

/myjs/main#MIN#.js

- Internet Explorerの条件付きファイル

[if IE]/myjs/ie.js

レガシーJavaScriptを含める

レガシーJavaScriptファンクションがアプリケーション内のすべてのページに含まれているかどうかを指定します。使用しているアプリケーションに、レガシー・ファンクションへの参照が含まれていないことが確実な場合は、これを「いいえ」に設定して、ロードされるJavaScriptファイルの全体のサイズを削減します。

非推奨のjQuery機能が使用されているかどうかを特定するには、ブラウザ・コンソールのログを開いた状態でアプリケーションを実行し、jQuery移行によって表示されるログ・メッセージを検索します。

関連項目: 『Oracle Application Express APIリファレンス』のレガシーJavaScript APIに関する項

jQuery移行を含める

jQuery移行プラグインがアプリケーション内のすべてのページに含まれる必要があるかどうかを指定します。

プラグインはjQueryの非推奨の機能および動作をリストアし、古いJavaScriptコードおよびjQueryプラグインが、Application ExpressによってロードされたjQueryバージョンを使用して引き続き適切に実行されるようにします。

アプリケーションおよび使用しているjQueryプラグインに、非推奨のjQuery機能への参照が含まれていないことが確実な場合は、これを「いいえ」に設定すると、ロードされるJavaScriptファイルの全体のサイズが削減されます。

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

「ファイルURL」で、すべてのページにロードするカスケード・スタイルシートのファイルURLを入力します。各URLを新しい行に記述する必要があります。ファイルの縮小バージョンを指定する場合、置換文字列#MIN#を使用して.minを、または#MIN_DIRECTORY#使用してminified/を通常ページ・ビューのファイルURLに含めたり、ページをデバッグ・モードで表示する場合は空の文字列を含めることができます。アプリケーションのバージョンをファイルURLに含める場合、置換文字列#APP_VERSION#にアクセスすることもできます。

例は、フィールドレベル・ヘルプを参照してください。

7.5.4.5.6 連結されたファイル

連結されたファイルを使用すると、単一のファイルごとに複数のHTTPリクエストを発行するかわりにブラウザで1つのファイルのみをロードするため、ページをロードするパフォーマンスを向上できます。この方法には、開発中に、より小さく、よりモジュール化されたファイルを使用し、Application Express開発環境の外部のアプリケーションを実行するときには、単一の連結されたファイルを使用するオプションがあります。

連結されたファイルを作成するには、「連結されたファイル」をクリックして、画面に表示される手順に従います。詳細および例を確認するには、フィールドレベル・ヘルプを参照してください。

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

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

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

- ページの作成ウィザードの実行中に使用可能なページ・タイプ

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

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

- ページ・デザイナでのページの管理について

- コンポーネント・ビューでのページの管理について

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

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

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

関連項目:
「アプリケーション・ユーティリティへのアクセス」

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

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

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

- コンポーネント・ビューでページを表示する場合は、「作成」をクリックして「ページ」を選択します。「コンポーネント・ビューでのページの管理」を参照してください。

- ページ・デザイナでページを表示する場合は、「作成」をクリックして「ページ」を選択します。「ページ・デザイナでのページの管理」を参照してください。

7.6.2 ページの作成ウィザードの実行中に使用可能なページ・タイプ

表7-17「ページの作成ウィザードの実行中に使用可能なページ・タイプ」に、ページの作成ウィザードの実行中に作成できるページ・タイプを一覧表示します。サポートされるページ・タイプは、選択したユーザー・インタフェース(デスクトップ、jQuery Mobileスマートフォンなど)によって異なります。

表7-17 ページの作成ウィザードの実行中に使用可能なページ・タイプ

ページ・タイプ

説明

デスクトップ

jQuery Mobileスマートフォン

アクセス制御

アクセス制御リストを含むページを作成すると、開発者はアプリケーション、個別ページまたはページ・コンポーネントへのアクセスを制御できます。

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

使用可能

使用可能

空白ページ

組込み機能のないページを作成します。

使用可能

使用可能

カレンダ

月別、週別、日別表示のカレンダを生成します。

関連項目: カレンダの作成

使用可能

使用可能

チャート

HTML5およびFlashのグラフィカル・チャートを作成できます。

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

使用可能

使用可能

データのロード

新しいデータのロード・ウィザードを作成して、エンド・ユーザーが、権限を持つすべてのスキーマに対する表へのデータのロードを管理できるようにします。

関連項目: 「データ・ロード機能によるアプリケーションの作成」

使用可能

使用不可

フィードバック・ページ

フィードバック・ページを追加します。フィードバックは、アプリケーション・ユーザーからリアルタイム・コメント、拡張リクエストおよびバグを収集するプロセスです。

関連項目: 「フィードバックの管理」

使用可能

使用可能

フォーム、Webサービスのフォームとレポート

Webサービスの定義に基づいて、アイテムを含むページを作成します。このウィザードでは、ユーザー入力フォーム、Webサービスをコールするプロセスおよび送信ボタンを作成し、レポートに結果を表示します。

関連項目: 「Webサービスでの入力フォームとレポートの作成」

使用可能

使用可能

フォーム、プロシージャのフォーム

ストアド・プロシージャの引数に基づくフォームを構築します。ストアド・プロシージャまたはパッケージに実装済のロジックまたはデータ操作言語(DML)が存在する場合は、この方法を使用します。

使用可能

使用可能

フォーム、SQL問合せのフォーム

EQUIJOINなどのSQL問合せによって戻される列に基づくフォームを作成します。

使用可能

使用不可

フォーム、表またはビューのフォーム

データベース表の単一行を更新できるフォームを作成します。フォームを構築する表を選択できます。

使用可能

使用可能

フォーム、リスト・ビュー付きの表のフォーム

データベース表の単一行を更新できるフォームおよびリスト・ビューを作成します。フォームを構築する表を選択し、リスト・ビューのテキスト表示に使用する列を選択します。

注意: デスクトップ・アプリケーションは、このレポート書式をサポートしません。

使用不可

使用可能

フォーム、レポート付きの表のフォーム

2つのページを作成します。1つのページにはレポートが表示されます。各行に2ページ目へのリンクが提供され、これを使用して各レコードを更新できます。レポートおよびフォームを構築する表を選択できます。

注意: このウィザードでは、127列を超える列が含まれている表はサポートされていません。127列を超える列を選択すると、エラーが発生します。

使用可能

使用可能

フォーム、Webサービスのフォーム

Webサービスの定義に基づいて、アイテムを含むページを作成します。このウィザードでは、ユーザー入力フォーム、Webサービスをコールするプロセスおよび送信ボタンを作成します。

関連項目: 「Webサービスでのフォームの作成」

使用可能

使用可能

フォーム、マスター・ディテール・フォーム

2ページのレポートとフォームの組合せを構築します。1ページ目では、更新する行を選択します。2ページ目では、ユーザーは選択した表またはビューと関連するディテールを更新できます。マスター・レポートおよびディテール・フォームを構築する表を選択します。

関連項目: 「マスター・ディテール・フォームの管理」

使用可能

使用不可

フォーム、サマリー・ページ

読取り専用のフォームを作成します。通常、ウィザードの最後に確認ページを提供するために使用します。

使用可能

使用可能

フォーム、表形式フォーム

データベース表の複数の行に対して更新、挿入および削除を行うフォームを作成します。フォームを構築する表を選択します。

関連項目: 「表形式フォームの管理」

使用可能

使用不可

グローバル・ページ

グローバル・ページ(以前はページ0と呼ばれていた)は、マスター・ページとして機能します。

関連項目: 「すべてのページにコンポーネントを表示するグローバル・ページの作成」

使用可能

使用可能

ログイン・ページ

ログイン・ページを作成します。

関連項目: 「ログイン・ページの作成」

使用可能

使用可能

マップ・チャート

AnyChart AnyMap対話モード・マップ・コンポーネントに基づいてFlashマップを作成します。

関連項目: 「マップの作成」

使用可能

使用不可

プラグイン

リージョン・タイプ・プラグインに基づいて新しいページを作成します。開発者はプラグインを使用して、Oracle Application Expressで使用可能な組込みタイプを宣言的に拡張、共有および再利用できます。

関連項目: 「プラグイン・ページからのプラグインのインポート」

使用可能

使用可能

レポート、クラシック・レポート

SQL問合せの結果がフォーマット化されます。レポートを作成する表を選択するか、カスタムSQL SELECT文またはSQL SELECT文を戻すPL/SQLファンクションを指定することができます。SQL問合せの記述が不明な場合は、「クエリー・ビルダー」ボタンをクリックします。

関連項目: 「対話モード・レポートとクラシック・レポートの相違点」および「コンポーネント・ビューでのクラシック・レポートの編集」

使用可能

使用不可

レポート、列切替えレポート

モバイル・アプリケーションのレスポンシブなレポートを作成します。デフォルトでは、列切替えレポートはすべての列が同じ優先度に設定されて作成されます。ただし、開発者はレポート列属性を編集し、重要度に応じて列をランク付けできます。優先度がより低い列は、より狭い幅で表示されます。レポートには、エンド・ユーザーが表示する列を選択できる「列」ボタンが含まれています。

注意: デスクトップ・アプリケーションは、このレポート書式をサポートしません。

関連項目: 「レポートの開発」

使用不可

使用可能

レポート、対話モード・レポート

SQL問合せの結果がフォーマット化されます。指定するカスタムSQL SELECT文に基づいた対話モード・レポートを作成します。SQL問合せの記述が不明な場合は、「クエリー・ビルダー」ボタンをクリックします。対話モード・レポートは、デスクトップ・ページでのみサポートされ、1ページにつき1つの対話モード・レポートのみを定義できます。エンド・ユーザーは、「アクション」メニューのオプションを選択することによって、レポートのレイアウトと表示されるデータをカスタマイズできます。

注意: jQuery Mobileスマートフォンは、対話モード・レポートをサポートしません。

関連項目:「対話モード・レポートとクラシック・レポートの相違点」、「エンド・ユーザーとしての対話モード・レポートのカスタマイズ」および「コンポーネント・ビューでの対話モード・レポートの編集」

使用可能

使用不可

レポート、リスト・ビュー

リスト・ビューは、スマートフォンでのデータ表示およびナビゲーション用に最適化されています。

SQL問合せの書式設定された結果を含むページを作成します。リスト・ビューを作成する表を選択したり、リスト・ビュー・エントリに使用するデータベース列を選択します。

注意: デスクトップ・アプリケーションは、このレポート書式をサポートしません。

使用不可

使用可能

レポート、リフロー・レポート

モバイル・アプリケーションのレスポンシブなレポートを作成します。レポートを水平に表示できる十分な領域がない場合、レポートは、表の列を縮小して、各行に対するラベルやデータ・ペアのブロックのような外観の積上げ表示形式にすることによって機能します。

注意: デスクトップ・アプリケーションは、このレポート書式をサポートしません。

関連項目: 「レポートの開発」

使用不可

使用可能

レポート、Webサービスのレポート

Webサービスの結果でレポートを作成します。

関連項目: 「Webサービスの実装」

使用可能

使用可能

ツリー

階層的なデータまたは複数のレベルのデータをグラフィカルに通信し、必要に応じて各ツリー・ノードに固有のページまたはURLにナビゲートするためのツリーを作成します。

関連項目: ツリーの作成

使用可能

使用不可

ウィザード

ウィザードを作成します。

使用可能

使用可能

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

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

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

2. アプリケーションを選択します。
アプリケーションのホームページが表示されます。

3. 「ページの作成」ボタンをクリックします。

4. 「ページの作成」で、次のステップを実行します。

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

2. 「ページ・タイプの選択」で、作成するページ・タイプを選択します。表7-17「ページの作成ウィザードの実行中に使用可能なページ・タイプ」を参照してください。

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

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

関連項目:
「データベース・アプリケーションへのページの追加について」、「ページ・デザイナでのページ属性の編集」および「コンポーネント・ビューでのダイアログ属性の構成」

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

この項では、ダイアログ・ページを作成する方法について説明します。

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

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

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

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

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

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

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

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

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

Oracle Application Expressには、ダイアログ・ページに対するサポートが提供されています。モーダルまたは非モーダル・ダイアログ・ページは、テンプレート・タイプが「ダイアログ・ページ」のページ・テンプレートが、カレント・アプリケーション・テーマに1つ以上含まれている場合にのみサポートされます。新しいページを作成するときに、ウィザードによって、ページ・モードを選択するプロンプトが表示されます。ページ・モードによって、ページが標準のアプリケーション・ページかダイアログか(つまり、モーダル・ダイアログか非モーダル・ダイアログか)が決定されます。Oracle Application Expressは、次の2つのダイアログ・ページ・タイプをサポートしています。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

ダイアログ・ページ・テンプレートには、ダイアログ・ページの初期化、クローズおよび取消を処理するJavaScriptファンクション・コールが含まれています。これらのテンプレート属性の構成の詳細は、「必須のダイアログ・ページ・テンプレート属性」を参照してください。

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

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

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

1. ページ属性を編集します。「コンポーネント・ビューでのページ属性の表示」を参照してください。

2. ページ・モードを「モーダル・ダイアログ」および「非モーダル・ダイアログ」に設定します。

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

3. ページ・レベル・ダイアログ属性を定義します。「ダイアログ」を参照してください。

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

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

1. ページ属性を編集します。「ページ・デザイナでのページ属性の編集」を参照してください。

2. ページ・レベル・ダイアログ属性を定義します。「ページ・デザイナでのダイアログ属性の構成」を参照してください。

関連項目:
「データベース・アプリケーションへのページの追加について」

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

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

関連項目:
「動的アクションの管理」

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

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

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

関連項目:
「ページ・プロセスの理解」、「サンプル・データベース・アプリケーションの理解」および「ブランチを使用したナビゲーションの制御」

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

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

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

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

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

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

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

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

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

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

関連項目:
「動的アクションの管理」および「サンプル・データベース・アプリケーションの理解」

7.6.5 ページ・デザイナでのページの管理について

ページ・デザイナは、アプリケーション・ページの維持に関する開発者の生産性を最大化するように設計された、フル機能を備えた統合開発環境(IDE)です。ページ・デザイナのウィンドウは、3つの主要セクションに分かれています。

- ツリー・ペイン - ツリー・ペインは左の列に表示され、「レンダリング」、「動的アクション」、「プロセス」および「共有コンポーネント」のツリー・ビューがあります。

- グリッド・レイアウト - グリッド・レイアウトは中央の列に表示されます。グリッド・レイアウトは、ページを定義するリージョン、アイテムおよびボタンを視覚的に表します。ドラッグ・アンド・ドロップすることによって、ページ・コンポーネントの位置を編集できます。ギャラリからドラッグ・アンド・ドロップすることによって、新しいリージョン、アイテムおよびボタンを追加することもできます。

- プロパティ・エディタ - プロパティ・エディタは右の列に表示されます。プロパティ・エディタを使用して、ツリー・ペインまたはグリッド・レイアウトで現在選択されているコンポーネントのプロパティを編集します。

ヒント:
「レンダリング」ツリーおよびグリッド・レイアウトは、ページを定義するリージョン、アイテムおよびボタンの2つの異なる表現です。

関連項目:
「ページ・デザイナでのページの管理」

7.6.6 コンポーネント・ビューでのページの管理について

ページ・デザイナとは異なり、コンポーネント・ビューでは、ページを視覚的に表したり、ページ・コンポーネントをドラッグ・アンド・ドロップすることができません。ページ上のコンポーネントの位置をプレビューするには、ページを実行する必要があります。

コンポーネント・ビュー・ウィンドウは、次のセクションに分かれています。

- ページ・レンダリング。ページ・レンダリングとは、データベースからページを生成するプロセスです。「ページ・レンダリング」セクションを使用して、ページ属性、リージョン、ボタン、アイテム、ページ・レンダリングの計算、およびページ・プロセスを含むページのレンダリングに影響するコントロールを変更できます。

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

- 共有コンポーネント。「共有コンポーネント」セクションには、アプリケーション内の1つ以上のページで使用できる共通のコンポーネントが表示されます。

関連項目:
コンポーネント・ビューでのページの管理

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

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

関連項目:
「ページ・デザイナでのデータベース・アプリケーション・ページのコピー」および「コンポーネント・ビューでのデータベース・アプリケーション・ページのコピー」

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

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

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

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

- 対話モード・レポート

- Flashマップ

- Flashチャート

- ツリー・リージョン

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

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

関連項目:
「ページ・デザイナでのページの削除」および「コンポーネント・ビューでのページの削除」

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

この項では、コンポーネント・ビューでの「検索」アイコンの使用方法について説明します。

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

- アイテムの検索

- ページの検索

- 問合せの検索

- 表の検索

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

- イメージの検索

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

「検索」アイコンは懐中電灯のような形をしており、アプリケーションのホームページ、コンポーネント・ビュー、共有コンポーネント・ページ、アプリケーション定義の編集ページなど、アプリケーション・ビルダーの多くのページに表示されます。

「検索」アイコンをクリックすると、アイテム、ページ、問合せ、表、PL/SQLコード、イメージを検索して、デバッグ・レポート、セッション・ステート、エラーを表示できます。

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

「検索」アイコンを使用するには、次のステップを実行します。

1. 「検索」アイコンをクリックします。

「アイテム・ファインダ」が表示されます。

2. 次のいずれかのタブをクリックします。

- アイテム - 「アイテムの検索」

- ページ - 「ページの検索」

- 問合せ - 「問合せの検索」

- 表 - 「表の検索」

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

- イメージ - 「イメージの検索」

- デバッグ - 「デバッグ・レポートの表示」

- セッション - 「セッション・ステートの管理の理解」および「セッション・ページの使用」

- エラー - エラーの表示。

7.7.3 アイテムの検索

アプリケーション・ビルダーでは、アイテムはテキスト・フィールド、テキスト領域、パスワード、選択リスト、チェック・ボックスなどを示します。「アイテム・ファインダ」を使用すると、現在のアプリケーション内、またはワークスペースに関連付けられたスキーマ内のアイテムを検索できます。

関連項目:
「ページ・レベル・アイテムの理解」

アイテムを検索するには:

1. 「検索」アイコンをクリックします。

「アイテム・ファインダ」が表示されます。

検索バーはページの上部に表示され、次のコントロールが含まれています。

- 「検索列の選択」アイコン: 虫めがねに似ています。このアイコンをクリックして、検索を特定の列に絞り込みます。すべての列を検索するには、「すべての列」を選択します。

- テキスト領域: 大/小文字を区別しない検索基準(ワイルドカード文字を含む)を入力し、「実行」をクリックします。

- 「実行」ボタン: 検索を実行します。

- 「アクション」メニュー: アイコンをクリックすると、「アクション」メニューが表示されます。このメニューを使用して、対話モード・レポートをカスタマイズします。「「アクション」メニューについて」を参照してください。

2. 特定のアイテムを編集するには、該当するアイテムにナビゲートします。「ページ・レベル・アイテムの理解」を参照してください。

7.7.4 ページの検索

ページは、アプリケーションの基本的な構成要素です。「ページ・ファインダ」を使用すると、現在のアプリケーション内、またはワークスペースに関連付けられたスキーマ内のページを検索できます。

ページを検索するには、次のステップを実行します。

1. 「検索」アイコンをクリックします。

2. 「ページ」タブをクリックします。
「ページ・ファインダ」が表示されます。検索バーはページの上部に表示され、次のコントロールが含まれています。

- 「検索列の選択」アイコン: 虫めがねに似ています。このアイコンをクリックして、検索を特定の列に絞り込みます。すべての列を検索するには、「すべての列」を選択します。

- テキスト領域: 大/小文字を区別しない検索基準(ワイルドカード文字を含む)を入力し、「実行」をクリックします。

- 「実行」ボタン: 検索を実行します。

- 「アクション」メニュー: アイコンをクリックすると、「アクション」メニューが表示されます。このメニューを使用して、対話モード・レポートをカスタマイズします。「「アクション」メニューについて」を参照してください。

3. アイテム・ページにリンクするには、ページ番号をクリックします。

7.7.5 問合せの検索

問合せファインダを使用すると、アプリケーション内、またはワークスペースに関連付けられたスキーマ内の問合せを検索できます。

問合せファインダを使用して問合せを検索するには、次のステップを実行します。

1. 「検索」アイコンをクリックします。

2. 「問合せ」タブをクリックします。
「問合せファインダ」が表示されます。検索バーはページの上部に表示され、次のコントロールが含まれています。

- 「検索列の選択」アイコン: 虫めがねに似ています。このアイコンをクリックして、検索を特定の列に絞り込みます。すべての列を検索するには、「すべての列」を選択します。

- テキスト領域: 大/小文字を区別しない検索基準(ワイルドカード文字を含む)を入力し、「実行」をクリックします。

- 「実行」ボタン: 検索を実行します。

- 「アクション」メニュー: アイコンをクリックすると、「アクション」メニューが表示されます。このメニューを使用して、対話モード・レポートをカスタマイズします。「「アクション」メニューについて」を参照してください。

3. アイテム・ページにリンクするには、ページ番号をクリックします。

7.7.6 表の検索

「表ファインダ」を使用すると、ワークスペースに関連付けられたスキーマ内の表を表示できます。

現在のスキーマに関連付けられた表を表示するには、次のステップを実行します。

1. 「検索」アイコンをクリックします。

2. 「表」タブをクリックします。
「表ファインダ」が表示されます。検索バーはページの上部に表示され、次のコントロールが含まれています。

- 「検索列の選択」アイコン: 虫めがねに似ています。このアイコンをクリックして、検索を特定の列に絞り込みます。すべての列を検索するには、「すべての列」を選択します。

- テキスト領域: 大/小文字を区別しない検索基準(ワイルドカード文字を含む)を入力し、「実行」をクリックします。

- 「実行」ボタン: 検索を実行します。

- 「アクション」メニュー: アイコンをクリックすると、「アクション」メニューが表示されます。このメニューを使用して、対話モード・レポートをカスタマイズします。「「アクション」メニューについて」を参照してください。

3. 表名を選択します。
表定義が表示されます。

このレポートには列名、データ型、長さ、精度およびスケールが表示され、ページ下部には表を再作成するために必要なSQLが表示されます。

関連項目:
Oracle Application Express SQLワークショップ・ガイドの「表の管理」

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

PL/SQLファインダを使用すると、ワークスペースに関連付けられたスキーマ内の、各オブジェクトに関連付けられたストアド・プロシージャ、ファンクションおよびパッケージに関する詳細を検索して表示できます。

現在のスキーマのPL/SQLコードを検索するには、次のステップを実行します。

1. 「検索」アイコンをクリックします。

2. 「PL/SQL」タブをクリックします。
PL/SQLファインダが表示されます。検索バーはページの上部に表示され、次のコントロールが含まれています。

- 「検索列の選択」アイコン: 虫めがねに似ています。このアイコンをクリックして、検索を特定の列に絞り込みます。すべての列を検索するには、「すべての列」を選択します。

- テキスト領域: 大/小文字を区別しない検索基準(ワイルドカード文字を含む)を入力し、「実行」をクリックします。

- 「実行」ボタン: 検索を実行します。

- 「アクション」メニュー: アイコンをクリックすると、「アクション」メニューが表示されます。このメニューを使用して、対話モード・レポートをカスタマイズします。「「アクション」メニューについて」を参照してください。

3. 詳細を表示するには、プロシージャ、ファンクションまたはパッケージの名前を選択します。
プロシージャ、パッケージまたはファンクションの名前が、所有者、ソース名、ソース・タイプ、戻り型、引数名、データ型およびIN/OUTパラメータなどの情報とともに表示されます。

関連項目:
『Oracle Application Express SQLワークショップ・ガイド』の「オブジェクト・ブラウザを使用したデータベース・オブジェクトの管理」

7.7.8 イメージの検索

イメージ・ファインダを使用して、カレント・アプリケーションに使用可能なイメージを識別できます。

使用可能なイメージを表示するには、次のステップを実行します。

1. 「検索」アイコンをクリックします。

2. 「イメージ」タブをクリックします。
イメージ・ファインダが表示されます。

3. 「表示」から、表示するイメージのタイプを選択します。オプションは次のとおりです。

- 標準イメージ

- ワークスペース・イメージ

- アプリケーション・イメージ

関連項目:
『Oracle Application Express SQLワークショップ・ガイド』の「オブジェクト・ブラウザを使用したデータベース・オブジェクトの管理」

7.8 ページ・グループの作成

ページをページ・グループとして編成すると、アプリケーション内のページに簡単にアクセスできるようになります。ページ・グループを使用するには、グループを作成してからページをグループに割り当てます。

ヒント:
ページ・グループには、開発者がアプリケーション内のページを編成する場合に有効な機能以外の機能はありません。

- ページ・グループの表示

- ページ・グループの作成

- ページ・グループ定義の編集

- ページのページ・グループへの割当て

- ページ・グループごとのページの表示

- ページ・グループの削除

7.8.1 ページ・グループの表示

ここでは、ページ・グループの様々な表示方法について説明します。

ページ・グループ・ページにアクセスするには、次のステップを実行します。

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

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

3. 「ユーティリティ」アイコンをクリックします。

4. 「ページ固有のユーティリティ」から、「ページ・グループ」をクリックします。
ページ・グループ・ページが表示されます。

検索バーがページの上部に表示されます。使用可能なコントロールは次のとおりです。

- 検索列の選択: 虫めがねに似ています。このアイコンをクリックして、検索を絞り込みます。すべての列を検索するには、「すべての列」を選択します。

- テキスト領域: 名前でページ・グループを検索するための大/小文字を区別しない検索基準(ワイルドカード文字を含む)を入力し、「実行」をクリックします。

- 「実行」ボタン: 検索を実行したり、フィルタを適用します。

- 「アイコンの表示」: 各グループを大きいアイコンとして表示します。グループを編集するには、該当するアイコンをクリックします。

- レポートの表示: 各グループをレポート内の1行として表示します。グループを編集するには、名前をクリックします。

- 「アクション」メニュー: 「アクション」メニューを使用して、レポート・ビューをカスタマイズします。

5. グループに関連付けられたページを表示するには、「ページ・グループごとのページ」をクリックします。

関連項目:
「「アクション」メニューについて」

7.8.2 ページ・グループの作成

ページ・グループを作成するには、次のようにします。

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

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

3. 「ユーティリティ」アイコンをクリックします。

4. 「ページ固有のユーティリティ」から、「ページ・グループ」をクリックします。

5. ページ・グループ・ページで、「作成」をクリックします。

6. 名前および説明(オプション)を入力して、「作成」をクリックします。

7.8.3 ページ・グループ定義の編集

ページ・グループの作成時に、名前と説明を指定します。

ページ・グループ定義を編集するには、次のステップを実行します。

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

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

3. 「ユーティリティ」アイコンをクリックします。

4. 「ページ固有のユーティリティ」から、「ページ・グループ」をクリックします。

5. ページ・グループを選択します。

6. ページ・グループ・ページで名前または説明を編集し、「変更の適用」をクリックします。

7. 次のページ・グループ定義に移動するには、「前へ」ボタン(<)と「次へ」ボタン(>)をクリックして、前のステップを繰り返します。

7.8.4 ページのページ・グループへの割当て

ページをグループに割り当てるには、次のステップを実行します。

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

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

3. 「ユーティリティ」アイコンをクリックします。

4. 「ページ固有のユーティリティ」から、「ページ・グループ」をクリックします。

5. 「ページ割当て」タブをクリックします。
ページ割当てページが表示されます。

6. ページ番号をクリックします。
ページ属性ページが表示されます。

7. 「名前」リージョンを探し、「グループ」リストからグループを選択します。

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

関連項目:
ページ属性を編集したりグループを選択することによって、またはページの作成ウィザードの実行時にページをグループに関連付けることもできます。「ページ・デザイナでのページ属性の編集」、「コンポーネント・ビューでのページ属性の編集」および「アプリケーションの作成ウィザードの使用」を参照してください

7.8.5 ページ・グループごとのページの表示

ページ・グループごとにページを確認するには、次のステップを実行します。

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

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

3. 「ユーティリティ」アイコンをクリックします。

4. 「ページ固有のユーティリティ」から、「ページ・グループ」をクリックします。

5. 「ページ・グループごとのページ」タブをクリックします。
ページ・グループごとのページ・ページが表示されます。ページ番号をクリックすることで、ページ属性ページに移動できます。ページ名をクリックすることで、ページにリンクします。

6. 新しいグループを作成するには、「作成」をクリックして、画面に表示されるステップに従います。

7.8.6 ページ・グループの削除

ページ・グループを削除するには、次のようにします。

1. 削除するグループのすべてのページを削除します。「ページ・グループごとのページの表示」を参照してください。

2. ページ・グループ・ページにアクセスします。

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

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

3. 「ユーティリティ」アイコンをクリックします。

4. 「ページ固有のユーティリティ」から、「ページ・グループ」をクリックします。

3. ページ・グループを選択します。

4. 「削除」をクリックします。
「確認」ページが表示されます。

5. リクエストを確認します。

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

アプリケーション開発中の競合を回避するには、アプリケーション内のページをロックします。ページをロックすると、他の開発者がページを編集できなくなります。

- ページがロックされているかどうかの判別

- ページのロック

- ページのロック解除

7.9.1 ページがロックされているかどうかの判断

「ロック」アイコンは、ページが現在ロックされているかどうかを示します。ページのロックが解除されている場合、アイコンは鍵が開いた南京錠として表示されます。ページがロックされている場合、アイコンは鍵が掛かった南京錠として表示されます。「ロック」アイコンは、アプリケーションのホームページとページに表示されます。

アプリケーションのホーム・ページで「ロック」アイコンを表示するには、「レポートの表示」アイコンをクリックします。レポートが表示されます。「ロック」アイコンはページの右側に表示されます。

7.9.2 ページのロック

この項では、ページをロックする様々な方法について説明します。

- アプリケーションのホームページからのページのロック

- ページ・ロック・ページからのページのロック

- ページ・デザイナでのページのロック

- コンポーネント・ビューでのページのロック

7.9.2.1 アプリケーションのホームページからのページのロック

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

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

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

3. 検索バーで、「レポートの表示」または「詳細の表示」アイコンをクリックします。

4. 「ロック」アイコンをクリックします。

5. 「コメント」フィールドにコメントを入力します。

6. 「ページのロック」をクリックします。

7.9.2.2 ページ・ロック・ページからのページのロック

ページ・ロック・ページからページをロックするには、次のステップを実行します。

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

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

3. 「ユーティリティ」アイコンをクリックします。

4. 「ページ固有のユーティリティ」リストで、「クロス・ページ・ユーティリティ」をクリックします。

5. 「ページ・ロック」をクリックします。

6. 該当するページを選択して、「ロックを選択済」をクリックします。

7. 「コメント」フィールドにコメントを入力します。

8. 「ページのロック」をクリックします。

7.9.2.3 ページ・デザイナでのページのロック

ページ・デザイナ・ツールバーの「ページ・ロック」ボタンは、ページがロックされているかどうかを示します。ページのロックが解除されている場合、「ページ・ロック」ボタンは鍵が開いた南京錠として表示されます。

ページ・デザイナでページをロックするには、次のステップを実行します。

1. ページ・デザイナで適切なページにナビゲートします。「ページ・デザイナでのページの表示」を参照してください。

2. ページ・デザイナ・ツールバーで、「ページがロック解除されました」ボタンをクリックします。

3. 「コメント」フィールドにコメントを入力します。

4. 「ロック」をクリックします。
ページのロックが解除されると、「ページ・ロック」ボタンは鍵が掛かった南京錠として表示されます。

7.9.2.4 コンポーネント・ビューでのページのロック

コンポーネント・ビューでページをロックするには、次のステップを実行します。

1. コンポーネント・ビューで適切なページにナビゲートします。「コンポーネント・ビューでのページの表示」を参照してください。

2. 「ユーティリティ」をクリックして「ロック」をクリックします。

3. 「コメント」フィールドにコメントを入力します。

4. 「ページのロック」をクリックします。

7.9.3 ページのロック解除

この項では、ロックされたページのロックを解除する方法について説明します。ページをロックした開発者のみが、そのページのロックを解除できます。ただし、管理権限を持つ開発者は、他の開発者がロックしたページのロックを解除できます。

- ユーティリティからのページのロック解除

- アプリケーションのホームページからのページのロック解除

- ページ・デザイナでのページのロック解除

- コンポーネント・ビューでのページのロック解除

- ワークスペース管理者としてのページのロック解除

ヒント:
既存のページのロックに関する情報を表示するには、ロックの詳細ページにナビゲートして、「ロック履歴」リージョンを展開します。

7.9.3.1 ユーティリティからのページのロック解除

ページ定義からページのロックを解除するには、次のステップを実行します。

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

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

3. 「ユーティリティ」アイコンをクリックします。

4. 「ページ固有のユーティリティ」リストで、「クロス・ページ・ユーティリティ」をクリックします。

5. 「ページ・ロック」をクリックします。

6. 該当するページを選択します。

7. 「チェックした項目のロック解除」をクリックします。

7.9.3.2 アプリケーションのホームページからのページのロック解除

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

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

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

3. 検索バーで、「レポートの表示」アイコンをクリックします。

4. 「ロック」アイコンをクリックします。
ロックの詳細ページが表示されます。

5. 「ロック解除」をクリックします。

7.9.3.3 ページ・デザイナでのページのロック解除

ページ・デザイナ・ツールバーの「ページ・ロック」ボタンは、ページがロックされているかどうかを示します。ページがロックされている場合、「ページ・ロック」ボタンは鍵が掛かった南京錠として表示されます。鍵が掛かった「ページ・ロック」ボタンにカーソルをあわせると、ロックした人物を示すツールチップが表示されます。

ページ・デザイナでページのロックを解除するには、次のステップを実行します。

1. 適切なページにナビゲートします。「ページ・デザイナでのページの表示」を参照してください。
ページがロックされている場合、「ページ・ロック」ボタンは鍵が掛かった南京錠として表示されます。

2. ページ・デザイナ・ツールバーで、「ロックしたページ」ボタンをクリックします。
別のユーザーがページをロックした場合、「ロック」ボタンは赤く表示されます。別のユーザーがロックしたページのロックを解除することはできません。

3. 「ロック解除」をクリックします。
ページのロックが解除されると、「ページ・ロック」ボタンは鍵が開いた南京錠として表示されます。

7.9.3.4 コンポーネント・ビューでのページのロック解除

コンポーネント・ビューでページのロックを解除するには、次のステップを実行します。

1. 適切なページにナビゲートします。「コンポーネント・ビューでのページの表示」を参照してください。

2. 「ユーティリティ」をクリックして、「ロック解除」を選択します。

7.9.3.5 ワークスペース管理者としてのページのロック解除

ワークスペース管理者としてページのロックを解除するには、次のステップを実行します。

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

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

3. 「ユーティリティ」アイコンをクリックします。

4. 「ページ固有のユーティリティ」リストで、「クロス・ページ・ユーティリティ」をクリックします。

5. 「ページ・ロック」をクリックします。

6. 「ロック管理」をクリックします。

7. 該当するページを選択します。

8. 「ページのロック解除」をクリックします。

7.10 開発者コメントの追加

「開発者のコメント」、「バグ」または「To Do」ボタンを使用して、アプリケーション、ページまたはページ・グループに開発者コメントを追加できます。開発者コメントは、アプリケーションの変更の通知、問題の報告、または開発者の提案の記録などに使用できます。

- 「開発者のコメント」、「バグ」または「To Do」ボタン

- アプリケーションへの開発者コメントの追加

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

- 開発者コメントの削除

- 共有コンポーネントから開発者コメントへのアクセス

- 開発者コメントのカレンダの表示

関連項目:
「データベース・アプリケーション・コメントの追加」

7.10.1 「開発者のコメント」、「バグ」または「To Do」ボタン

「開発者のコメント」、「バグ」または「To Do」ボタンは、小さい吹出しの形をしています。このボタンは、特定のアプリケーションまたはアプリケーション・ページに関連するアプリケーション・ビルダー内のほとんどのページに表示されます。

7.10.2 アプリケーションへの開発者コメントの追加

アプリケーション、ページ、またはページ・グループに開発者のコメントを追加できます。

開発者コメントを追加するには、次のようにします。

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

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

3. 「開発者のコメント」、「バグ」または「To Do」ボタンをクリックします。

4. 「タイプ」リストから、「開発者のコメント」を選択します。
開発者のコメント・ページが表示されます。

5. 「コメント」に、テキストを最大4000文字まで入力します。

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

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

開発者コメントを編集するには、次のようにします。

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

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

3. 「開発者のコメント」、「バグ」または「To Do」ボタンをクリックします。

4. 「コメントの表示」をクリックします。
開発者のコメント・ページが表示されます。

5. コメントを編集するには、「編集」アイコンをクリックします。
「コメントの編集」ページが表示されます。

1. 「コメント」に、テキストを最大4000文字まで入力します。

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

ヒント:
開発者コメントは、共有コンポーネント・ページでも表示および編集できます。共有コンポーネント・ページに移動し、「タスク」リージョンの「開発者のコメント」をクリックします。「共有コンポーネントから開発者コメントへのアクセス」を参照してください。

7.10.4 開発者コメントの削除

この項では、開発者コメントを削除する方法について説明します。

- 特定の開発者コメントの削除

- 複数の開発者コメントの削除

7.10.4.1 特定の開発者コメントの削除

開発者コメントを削除するには、次のようにします。

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

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

3. 「開発者のコメント」、「バグ」または「To Do」アイコンをクリックします。

4. 「コメントの表示」をクリックします。
開発者のコメント・ページが表示されます。

5. 削除するコメントを探します。

6. 「編集」アイコンをクリックします。
「コメントの編集」ページが表示されます。

7. 「削除」をクリックします。

7.10.4.2 複数の開発者コメントの削除

複数の開発者コメントを削除するには、次のようにします。

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

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

3. 「開発者のコメント」、「バグ」または「To Do」アイコンをクリックします。

4. 「コメントの表示」をクリックします。

5. 「コメントの削除」をクリックします。

6. 次のアクションの1つを選択します。

- すべてのコメントの削除

- 開発者別に作成されたコメントの削除

- 日付別のコメントの削除

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

7.10.5 共有コンポーネントから開発者コメントへのアクセス

共有コンポーネントから開発者コメント・レポートにアクセスするには、次のステップを実行します。

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

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

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

4. 「タスク」で、「開発者のコメント」をクリックします。
開発者コメント・レポートが表示されます。

ナビゲーション・バーはページの上部に表示され、次のコントロールが含まれています。

- 検索列の選択: 虫めがねに似ています。このアイコンをクリックして、検索を特定の列のみに絞ります。すべての列を検索するには、「すべての列」を選択します。

- テキスト領域: 大/小文字を区別しない検索基準(ワイルドカード文字を含む)を入力し、「実行」をクリックします。

- 「実行」ボタン: 検索を実行します。

- 「アクション」メニュー: 「アクション」メニューを使用して、レポート・ビューをカスタマイズします。「「アクション」メニューについて」を参照してください。

関連項目:
「開発者コメントの表示と編集」および「開発者コメントの削除」

7.10.6 開発者コメントのカレンダの表示

「開発者コメントのカレンダ」にアクセスするには、次のステップを実行します。

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

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

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

4. 「タスク」で、「開発者のコメント」をクリックします。
開発者のコメント・ページが表示されます。

5. 「開発者コメントのカレンダ」をクリックします。
開発者コメントのカレンダ・ページが表示されます。

6. 「前へ」、「今日」および「次へ」ボタンを使用してナビゲートします。

7.11 データベース・アプリケーション・コメントの追加

アプリケーション・コメント・ページで、データベース・アプリケーション全体に関するコメントを追加できます。アプリケーションの説明またはアプリケーションで作業した開発者の追跡ができます。

アプリケーション・コメントを作成するには、次のステップを実行します。

1. 「ワークスペース」ホームページにナビゲートします。

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

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

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

5. 「タスク」で、「アプリケーション・コメントの編集」をクリックします。
アプリケーション・コメント・ページが表示されます。

6. 「コメント」フィールドにコメントを入力して、「変更の適用」をクリックします。

7.12 アプリケーション・グループの管理

アプリケーションをアプリケーション・グループに割り当てることにより、アプリケーションを整理できます。アプリケーション・グループを使用するには、最初にグループを作成し、その後、アプリケーションを割り当てます。

- データベース・アプリケーション・グループの表示

- データベース・アプリケーション・グループの作成

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

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

- データベース・アプリケーション・グループの削除

関連項目:
「クロス・ページ・ユーティリティの使用」

7.12.1 データベース・アプリケーション・グループの表示

データベース・アプリケーション・グループを表示するには、次のステップを実行します。

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

2. 「ワークスペース・ユーティリティ」をクリックします。

3. 「アプリケーション・グループ」をクリックします。
アプリケーション・グループ・ページが表示されます。

検索バーがページの上部に表示されます。使用可能なコントロールは次のとおりです。

- 検索列の選択: 虫めがねに似ています。このアイコンをクリックして、検索を絞り込みます。すべての列を検索するには、「すべての列」を選択します。

- テキスト領域: 名前でグループを検索するための大/小文字を区別しない検索基準(ワイルドカード文字を含む)を入力し、「実行」をクリックします。

- 「実行」ボタン: 検索を実行したり、フィルタを適用します。

- アイコンの表示(デフォルト): 各グループを大きいアイコンとして表示します。グループを編集するには、該当するアイコンをクリックします。

- レポートの表示: 各グループをレポート内の1行として表示します。グループを編集するには、名前をクリックします。

4. グループに関連付けられたアプリケーションを表示するには、グループ名をクリックします。

7.12.2 データベース・アプリケーション・グループの作成

データベース・アプリケーション・グループを作成するには、次のステップを実行します。

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

2. 「ワークスペース・ユーティリティ」をクリックします。

3. 「アプリケーション・グループ」をクリックします。

4. アプリケーション・グループ・ページで、「作成」をクリックします。

5. 名前および説明(オプション)を入力して、「作成」をクリックします。

7.12.3 アプリケーション・グループへのデータベース・アプリケーションの割当て

データベース・アプリケーションをグループに割り当てるには、次のステップを実行します。

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

2. 「ワークスペース・ユーティリティ」をクリックします。

3. 「アプリケーション・グループ」をクリックします。

4. 「タスク」リストで「未割当ての管理」をクリックします。
アプリケーション・グループ割当ての管理ページが表示されます。

5. 「新規グループ」リストから、グループを選択します。

6. 割り当てるアプリケーションを選択して、「チェックした項目の割当て」をクリックします。

ヒント:
アプリケーション・グループへのアプリケーションの割当ては、アプリケーション定義を編集して行うこともできます。グループは、「アプリケーション・グループ」リストから選択します。「アプリケーション属性の編集」を参照してください。

7.12.4 アプリケーション・グループからのデータベース・アプリケーションの削除

アプリケーション・グループからアプリケーションを削除するには、次のステップを実行します。

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

2. 「ワークスペース・ユーティリティ」をクリックします。

3. 「アプリケーション・グループ」をクリックします。

4. 「タスク」リストで「割当ての管理」をクリックします。
アプリケーション・グループ割当ての管理ページが表示されます。

5. 「新規グループ」リストから、「- 割当て解除 -」を選択します。

6. 割当てを解除するページを選択して、「チェックした項目の割当て」をクリックします。

ヒント:
アプリケーション・グループからのアプリケーションの削除は、アプリケーション定義を編集して行うこともできます。「アプリケーション・グループ」リストから「未割当て」を選択します。「アプリケーション属性の編集」を参照してください。

7.12.5 データベース・アプリケーション・グループの削除

アプリケーション・グループを削除するには、次の手順を実行します。

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

2. 「ワークスペース・ユーティリティ」をクリックします。

3. 「アプリケーション・グループ」をクリックします。

4. グループ内のすべてのアプリケーションを「未割当て」に割り当てるか、他のグループに割り当てます。「アプリケーション・グループからのデータベース・アプリケーションの削除」を参照してください。

5. アプリケーション・グループ・ページに戻ります。

6. 削除するアプリケーション・グループを選択します。

7. アプリケーション・グループ・ページで、「削除」をクリックします。
「確認」ページが表示されます。

8. リクエストを確認します。

7.13 アプリケーション・ユーティリティへのアクセス

この項では、様々な側面からアプリケーションを表示できるアプリケーション・ビルダー・ユーティリティおよびレポートについて説明します。これらのレポートを使用して、統計を表示したり、ページやアプリケーション・コンポーネントのレポート、テンプレート、プラグインおよび条件にアクセスできます。たとえば、アプリケーション内の全ページで使用されるボタンの詳細を表示できます。さらに、多くのレポートは更新可能なため、個々のページに移動せずにアイテムやリージョン・ラベルなどのコンポーネントを標準化できます。

- アプリケーション・ビルダー・ユーティリティの使用

- ページ固有のユーティリティへのアクセス

- クロス・ページ・ユーティリティの使用

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

- 対話モード・レポート・ユーティリティの使用

関連項目:
「APEX_ACTIVITY_LOGを使用したカスタム・アクティビティ・レポートの作成」

7.13.1 アプリケーション・ビルダー・ユーティリティの使用

この項では、アプリケーション・ビルダー・ユーティリティ・ページで使用できるツールおよびレポートについて説明します。

- ユーティリティ・ページへのアクセス

- アプリケーション・ダッシュボードの表示

- 「変更履歴」レポートの表示

- 「最近更新されたページ」レポートの表示

- 新しいコンポーネントを組み込むためのアプリケーションのアップグレード

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

- Application Expressビューへのアクセス

7.13.1.1 ユーティリティ・ページへのアクセス

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

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

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

3. 「ユーティリティ」アイコンをクリックします。
ユーティリティ・ページには、次のツールおよびレポートにリンクするアイコンがあります。

- アプリケーション・ダッシュボード: 「アプリケーション・ダッシュボードの表示」を参照してください。

- 変更履歴: 「「変更履歴」レポートの表示」を参照してください。

- 最近更新されたページ: 「「最近更新されたページ」レポートの表示」を参照してください。

- エクスポート・リポジトリ: 「エクスポート・リポジトリへのアクセス」を参照してください。

- デバッグ・メッセージ: 「アプリケーションのデバッグ」を参照してください。

- アドバイザ: 「アプリケーション整合性のチェックのためのアドバイザの実行」を参照してください。

- アプリケーションのアップグレード: 「アプリケーションのアップグレードの実行」を参照してください。

- データベース・オブジェクトの依存性: 「「データベース・オブジェクトの依存性」レポートの使用」を参照してください。

- 属性ディクショナリ: 「属性ディクショナリの使用」を参照してください。

- Application Expressビュー: 「Application Expressビューへのアクセス」を参照してください。

関連項目:
「ページ固有のユーティリティへのアクセス」および「クロス・ページ・ユーティリティの使用」

7.13.1.2 アプリケーション・ダッシュボードの表示

「アプリケーション・ダッシュボード」には、アプリケーション・コンポーネントと属性の詳細が表示されます。

アプリケーション・ダッシュボードを表示するには、次のステップを実行します。

1. 「ワークスペース」ホームページにナビゲートします。

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

3. アプリケーションを選択します。
アプリケーションのホームページが表示されます。

4. 「ユーティリティ」をクリックします。

5. 「アプリケーション・ダッシュボード」をクリックします。
「アプリケーション・ダッシュボード」が表示され、次のセクションが表示されます。

- アプリケーション概要: カレント・アプリケーションに関する詳細情報および統計(ID、名前、別名、解析対象スキーマ、関連付けられているグループ、ページ数、関連付けられているテーマなど)が表示されます。

- セキュリティ: 現在の認証スキーム、パブリック・ページと非パブリック・ページの数およびカレント・アプリケーション内で使用される認可スキームの数が表示されます。

- テンプレート: カレント・アプリケーション内で使用されるテンプレートのレポートへのリンクが表示されます。

- タイプ別の表示: コンポーネントのカウント(レポートとフォームのタイプ、動的HTMLなど)が表示されます

- アプリケーション・コンポーネント: アプリケーション・レベルのコントロールとロジックのレポート(リスト、ショートカット、LOV、タブ、アプリケーションの計算、アプリケーション・アイテム、プラグインおよびアプリケーション・プロセスなど)へのリンクが表示されます。

- ページ・コンポーネント: リージョン、アイテム、ブランチ、計算、検証、動的アクション、クラシック・レポートの列、対話モード・レポートの列およびボタンを含むページレベルのコントロールおよびロジックのレポートへのリンクが含まれています。

6. 特定のレポートを表示するには、コンポーネント・タイプまたはテンプレートの右にある数字をクリックします。

関連項目:
「問題を引き起こす可能性のあるパスワード・アイテムの識別」

7.13.1.3 「変更履歴」レポートの表示

「変更履歴」レポートには、カレント・アプリケーションに対する編集のサマリー・レポートが開発者、コンポーネント・タイプおよびページ番号別に表示されます。

「変更履歴」レポートを表示するには、次のステップを実行します。

1. 「ワークスペース」ホームページにナビゲートします。

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

3. アプリケーションを選択します。
アプリケーションのホームページが表示されます。

4. 「ユーティリティ」をクリックします。

5. 「変更履歴」をクリックします。
検索バーがページの上部に表示されます。「検索バーについて」を参照してください。

7.13.1.4 「最近更新されたページ」レポートの表示

「最近更新されたページ」レポートには、現在のユーザーによって最近更新されたページのレポートが表示されます。

「最近更新されたページ」レポートを表示するには、次のステップを実行します。

1. 「ワークスペース」ホームページにナビゲートします。

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

3. アプリケーションを選択します。
アプリケーションのホームページが表示されます。

4. 「ユーティリティ」をクリックします。

5. 「最近更新されたページ」をクリックします。
検索バーがページの上部に表示されます。「検索バーについて」を参照してください。

7.13.1.5 新しいコンポーネントを組み込むためのアプリケーションのアップグレード

この項では、現在のリリースで使用可能な新しいコンポーネントが組み込まれるように既存のアプリケーションをアップグレードする方法について説明します。

- 既存のアプリケーションのアップグレードについて

- アプリケーションのアップグレードの実行

7.13.1.5.1 既存のアプリケーションのアップグレードについて

ユーティリティ・ページの「アプリケーションのアップグレード」アイコンを使用して、次のコンポーネントをアップグレードします。

- 「テキスト・フィールド」アイテムを「数値フィールド」アイテムに更新します(IS NUMERIC検証がある場合)。

- 「必須の値」アイテム属性を「はい」に更新します(NOT NULL検証がある場合)。

- 日付ピッカー(クラシック)を新しい日付ピッカーにアップグレードします。

- ページ・アイテムのLOVのNULL戻り値で%null%を削除します。

- FCKeditor 2をCKEditor 4にアップグレードします。

- SVGチャートをHTML5チャートにアップグレードします。

- HTMLチャートをHTML5チャートにアップグレードします。

- FlashチャートをHTML5チャートにアップグレードします。

- 対話モード・レポート:

- 対話モード・レポートに対してグループ化を有効にします。

- 対話モード・レポートに対してパブリック・レポートの保存を有効にします。

- 対話モード・レポートに対してサブスクリプションを有効にします。

- 対話モード・レポートに対してページごとの行数セレクタを有効にします。

- ページ上部に固定されたレポート・ヘッダーを有効にします。

- 数値、必須および日付ピッカー・アイテムは条件付き検証に基づいて更新されます。
ウィザードでは、関連するすべての検証がページごとに表示され、アイテム設定に置き換える検証を選択できます。次に、検証を行わないボタン(「取消」など)を選択します。最後に、常に実行する検証(たとえば、削除前の権限のチェックなど)を選択できます。

関連項目:
「アプリケーションのアップグレードの実行」

7.13.1.5.2 アプリケーションのアップグレードの実行

既存のアプリケーションをアップグレードするには、次のステップを実行します。

1. 「ワークスペース」ホームページにナビゲートします。

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

3. アプリケーションを選択します。
アプリケーションのホームページが表示されます。

4. 「ユーティリティ」をクリックします。

5. 「アプリケーションのアップグレード」をクリックします。

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

関連項目:
「既存のアプリケーションのアップグレードについて」

7.13.1.6 「データベース・オブジェクトの依存性」レポートの使用

「データベース・オブジェクトの依存性」レポートは、カレント・アプリケーションで参照されるデータベース・オブジェクトを識別します。アプリケーションのデプロイ時に移動するオブジェクトを判別するには、このレポートを確認します。

データベース・オブジェクトの依存性レポートを表示するには、次のステップを実行します。

1. 「ワークスペース」ホームページにナビゲートします。

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

3. アプリケーションを選択します。
アプリケーションのホームページが表示されます。

4. 「ユーティリティ」をクリックします。

5. 「データベース・オブジェクトの依存性」をクリックします。
データベース・オブジェクトの依存性ページが表示されます。

6. 「依存性の計算」をクリックします。

ヒント:
アプリケーションのサイズや複雑性に応じて、レポートの表示に時間がかかる場合があります。

「データベース・オブジェクトの依存性」レポートが表示されます。

7.13.1.7 Application Expressビューへのアクセス

Application Expressビューは、アプリケーションのメタデータを公開するデータ・ディクショナリ・ビューです。Application Expressビューでは、ビューを表示するだけでなく、ビューに含まれているデータを表示することもできます。

「Application Expressビュー」へアクセスするには、次の手順を実行します。

1. 「ワークスペース」ホームページにナビゲートします。

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

3. アプリケーションを選択します。
アプリケーションのホームページが表示されます。

4. 「ユーティリティ」をクリックします。

5. 「Application Expressビュー」をクリックします。
Application Expressビュー・ページが表示されます。

検索バーがページの上部に表示されます。使用可能なコントロールは次のとおりです。

- 検索列の選択: 虫めがねに似ています。このアイコンをクリックして、検索を絞り込みます。すべての列を検索するには、「すべての列」を選択します。

- テキスト領域: 名前でビューを検索するための大/小文字を区別しない検索基準(ワイルドカード文字を含む)を入力し、「実行」をクリックします。

- 「実行」ボタン: 検索を実行したり、フィルタを適用します。

- アイコンの表示: 各ビューを大きいアイコンとして表示します。ビューにアクセスするには、適切なアイコンをクリックします。

- レポートの表示: 各ビューをレポート内の1行として表示します。ビューにアクセスするには、名前をクリックします。

- 「アクション」メニュー: 「アクション」メニューを使用して、レポート・ビューをカスタマイズします。「「アクション」メニューについて」を参照してください。

6. ビューを選択します。

ビュー内のデータを表示するには、「列の選択」タブで列を選択し、「結果」ボタンをクリックします。

「結果」タブで、「問合せ」リージョンを拡張して、実行された問合せを表示します。この問合せをコピーしてSQLコマンドまたはSQL Developerで再利用できます。

7.13.2 ページ固有のユーティリティへのアクセス

「ページ固有のユーティリティ」ページへアクセスするには、次の手順を実行します。

1. 「ワークスペース」ホームページにナビゲートします。

2. 「アプリケーション・ビルダー」アイコンをクリックします。
アプリケーション・ビルダーのホームページが表示されます。

3. アプリケーションを選択します。
アプリケーションのホームページが表示されます。

4. 「ユーティリティ」をクリックします。

5. 「ページ固有のユーティリティ」で、次のいずれかを選択します。

- クロス・ページ・ユーティリティ

- ページ・グループ

- リージョン・ユーティリティ

- ボタン・ユーティリティ

- アイテム・ユーティリティ

- 計算ユーティリティ

- 検証ユーティリティ

- プロセス・ユーティリティ

- 動的アクション・ユーティリティ

- ブランチ・ユーティリティ

関連項目:
「クロス・ページ・ユーティリティの使用」

7.13.3 クロス・ページ・ユーティリティの使用

この項では、クロス・ページ・ユーティリティ・ページで使用できるツールおよびレポートについて説明します。

- クロス・ページ・ユーティリティへのアクセス

- すべてのページのグリッド編集

- 複数のページの削除

- ページ属性

- ページ・グループ

- ページ・ロック

関連項目:
「アプリケーション・ユーティリティへのアクセス」

7.13.3.1 クロス・ページ・ユーティリティへのアクセス

クロス・ページ・ユーティリティ・ページにアクセスするには、次のステップを実行します。

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

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

3. 「ユーティリティ」をクリックします。

4. 「ページ固有のユーティリティ」で、「クロス・ページ・ユーティリティ」をクリックします。
クロス・ページ・ユーティリティ・ページでは、次のツールおよびレポートにアクセスできます。

- すべてのページのグリッド編集:「すべてのページのグリッド編集」を参照してください。

- 複数のページの削除: 「複数のページの削除」を参照してください。

- ページ属性: 「ページ属性」を参照してください。

- ページ・ロック: 「ページ・ロック」を参照してください。

7.13.3.2 すべてのページのグリッド編集

「すべてのページのグリッド編集」レポートを使用して、ページ名、別名、タイトル、ページ・テンプレートおよびセキュリティ・オプションを編集します。特定のページにリンクするには、ページ番号の横の「編集」アイコンをクリックします。変更を保存するには、「変更の適用」をクリックします。

7.13.3.3 複数ページの削除

複数のページを一度に削除するには、「複数のページの削除」を使用します。「複数のページの削除」を参照してください。

7.13.3.4 ページ属性

「ページ属性」レポートには、カレント・アプリケーション内の各ページの属性、コンポーネント、コントロールおよびアプリケーション・ロジックの詳細が表示されます。レポートをカスタマイズするには、ページ上部にある検索バーを使用します。「検索バーについて」を参照してください。

特定のページにリンクするには、ページ番号をクリックします。

7.13.3.5 ページ・グループ

アプリケーション内のページをより適切に編成するには、「ページ・グループ」を使用します。「ページ・グループの作成」を参照してください。

7.13.3.6 ページ・ロック

アプリケーション開発中に競合が発生しないようにするには、「ページ・ロック」を使用します。ページをロックすると、他の開発者がページを編集できなくなります。「ページ・デザイナの使用」および「ページのロックおよびロック解除」を参照してください。

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

現在のワークスペースで複数のアプリケーションの情報を表示および編集するには、アプリケーション間レポート・ページ上のリンクを使用します。ワークスペース・ユーティリティ・ページからアプリケーション間レポートにアクセスします。

アプリケーション間レポートにアクセスするには、次のステップを実行します。

1. Oracle Application Expressにサインインします。
ワークスペースのホームページが表示されます。

2. 「アプリケーション・ビルダー」アイコンをクリックします。
アプリケーション・ビルダーのホームページが表示されます。

3. 「ワークスペース・ユーティリティ」アイコンをクリックします。

4. ウィンドウの右側に、「アプリケーション間レポート」があります。

5. 「アプリケーション間レポート」で、「すべてのレポート」をクリックしてアプリケーション間レポート・ページを表示します。

6. 表示するレポートを選択します。

7.13.5 対話モード・レポート・ユーティリティの使用

この項では、ユーティリティ・ページの右側の対話モード・レポート・ユーティリティの下にあるオプションについて説明します。

- 保存された対話モード・レポートの削除

- サブスクリプションの表示

7.13.5.1 保存された対話モード・レポートの削除

保存された対話モード・レポート・ページには、現在選択しているアプリケーションに保存された対話モード・レポートが一覧表示されます。

保存された対話モード・レポートを管理するには、次の手順を実行します。

1. Oracle Application Expressにサインインします。
ワークスペースのホームページが表示されます。

2. 「アプリケーション・ビルダー」アイコンをクリックします。
アプリケーション・ビルダーのホームページが表示されます。

3. アプリケーションを選択します。
アプリケーションのホームページが表示されます。

4. 「ユーティリティ」をクリックします。

5. 「対話モード・レポート・ユーティリティ」で、「保存されたレポート」を選択します。
レポートに、プライマリ・デフォルトではないアプリケーションの保存されたレポートがすべて表示されます。各行には、ページ番号、リージョン名、レポート・タイプ、レポート名、レポートの別名および所有者が含まれます。

6. プライベートの保存済レポートを表示するには、検索バーの下にある「プライマリ・デフォルト」フィルタのチェック・ボックスの選択を解除します。

7. レポートを削除するには、ページ番号の横にあるチェック・ボックスを選択して「チェックした項目の削除」をクリックします。

8. レポートを含むページを表示するには、ページ番号をクリックします。

関連項目:
「共有対話モード・レポートへのリンクの設定」、「対話モード・レポートの保存」および『Oracle Application Express管理ガイド』の保存された対話モード・レポートの管理に関する項

7.13.5.2 サブスクリプションの表示

エンド・ユーザーはレポートをサブスクライブすると、レポートの更新バージョンを受信できます。ワークスペース管理者はサブスクリプション・ページでこのサブスクリプションを表示して管理できます。

保存された対話モード・レポートを管理するには、次の手順を実行します。

1. Oracle Application Expressにサインインします。
ワークスペースのホームページが表示されます。

2. 「アプリケーション・ビルダー」アイコンをクリックします。
アプリケーション・ビルダーのホームページが表示されます。

3. アプリケーションを選択します。
アプリケーションのホームページが表示されます。

4. 「ユーティリティ」をクリックします。

5. 「対話モード・レポート・ユーティリティ」で、「サブスクリプション」を選択します。
レポートが表示されます。

8 ページ・デザイナでのページの管理

アプリケーション・ビルダーでは、ページ・デザイナとコンポーネント・ビューの2つの方法でアプリケーション・ページを表示したり管理することができます。この項では、ページ・デザイナでデータベース・アプリケーション・ページを管理する方法について説明します。

- ページ・デザイナ・ウィンドウについて

- 共通のページ・デザイナUI要素の理解

- ページ・デザイナの使用

- ページ・デザイナでのページ属性の編集

- ページ・デザイナでのページの実行

- 実行時開発者ツールバー

- ページ・デザイナでのデータベース・アプリケーション・ページのコピー

- ページ・デザイナでのページの削除

関連項目:
「ページ・デザイナからコンポーネント・ビューへの切替え」、「開発者コメントの追加」、「データベース・アプリケーションの作成」、「ページ・レイアウトの制御」および「ナビゲーションの追加」

8.1 ページ・デザイナ・ウィンドウについて

ページ・デザイナは、アプリケーション・ページの維持に関する開発者の生産性を最大化するように設計された、フル機能を備えた統合開発環境(IDE)です。

前述の図に示すように、ページ・デザイナ・ウィンドウは3つのペインに分かれています。

- 左ペイン - 左ペインには、「レンダリング」タブ、「動的アクション」タブ、「プロセス」タブおよび「ページ共有コンポーネント」タブが表示されます。「ツリー・ペイン」を参照してください。

- 中央ペイン - 中央ペインには、「グリッド・レイアウト」タブと関連ギャラリ、「メッセージ」タブ、「ページ検索」タブおよび「ヘルプ」タブが表示されます。「中央ペイン」を参照してください。

- 右ペイン - 右ペインには、プロパティ・エディタが表示されます。プロパティ・エディタを使用して、ツリー・ペインまたはグリッド・レイアウトで現在選択されているコンポーネントのプロパティを編集します。「プロパティ・エディタ」を参照してください。

ヒント:
「レンダリング」ツリーおよびグリッド・レイアウトは、ページを定義するリージョン、アイテムおよびボタンの2つの異なる表現です。

各ペインのサイズを調整するには、縦横のスプリッタを選択してドラッグします。各ペインを展開または縮小するには、各スプリッタの中央にある小さい三角形をクリックします。

関連項目:
「共通のページ・デザイナUI要素の理解」

8.2 共通のページ・デザイナUI要素の理解

この項では、共通のページ・デザイナのUI要素について説明します。

- ページ・デザイナ・ツールバー

- ツリー・ペイン

- 中央ペイン

- グリッド・レイアウト

- ギャラリ

- メッセージ

- ページ検索

- ヘルプ

- プロパティ・エディタ

- コード・エディタ

ヒント:
開発者ナビゲーション・ツールは、ほとんどのOracle Application Expressページでヘッダー・リージョンに表示されます。詳細は、「開発者ナビゲーション・ツール」を参照してください。

関連項目:
「ページ・デザイナの使用」

8.2.1 ページ・デザイナ・ツールバー

ページ・デザイナ・ツールバーは、ページ上部に表示されます。カーソルをアクティブなボタンおよびメニューにあわせると、前の図に示すようにツールチップが表示されます。ページ・デザイナ・ツールバーのボタンおよびメニュー・オプションは次のとおりです。

- ページ・ファインダ。ページを検索するための「ページ・ファインダ」が表示されます。「ページの検索」を参照してください。

- ページがロック解除されましたおよびページがロックされました。「ページがロック解除されました」および「ページがロックされました」ボタンは、ページを編集できるかどうかを示します。ページのロックが解除されている場合、ボタンは鍵が開いた南京錠として表示されます。ページがロックされている場合、ボタンは鍵が掛かった南京錠として表示され、ページをロックしたユーザーがツールチップに表示されます。緑の鍵が掛かった南京錠は、自分がページをロックしたことを示します。赤の鍵が掛かった南京錠は、別の開発者がページをロックしたことを示します。ページのロック・ステータスを変更したりロック・コメントを更新するには、このボタンをクリックします。「ページのロックおよびロック解除」を参照してください。

- 元に戻す。ページ・データを変更するアクションに適用されます。「元に戻す」をクリックして、以前の変更を元に戻します。

- やり直し。ページ・データを変更するアクションに適用されます。「やり直し」をクリックして、以前元に戻した変更を繰り返します。

- 作成:

- ページ。「データベース・アプリケーションへのページの追加について」を参照してください。

- コピーとしてのページ。「ページ・デザイナでのデータベース・アプリケーション・ページのコピー」を参照してください。

- フォーム・リージョン。「ページ・デザイナでのフォームの作成」を参照してください。

- レポート・リージョン。「ページ・デザイナでのウィザードを使用したレポートの作成」を参照してください。

- ページ・コンポーネント。ページ・デザイナでページ・コンポーネントを作成する方法のサマリーを提供します。

- 共有コンポーネント。「共有コンポーネントの管理」を参照してください。

- ページ・グループ。「ページ・グループの作成」を参照してください。

- 開発者のコメント。「開発者コメントの追加」を参照してください。

- チーム開発。サブメニューの「機能」、「To Do」および「バグ」を表示します。「機能の追跡」、「To Doの追跡」および「バグの管理」を参照してください。

- ユーティリティ:

- ページの削除。「ページ・デザイナでのページの削除」を参照してください。

- アドバイザ: 「アプリケーション整合性のチェックのためのアドバイザの実行」を参照してください。

- キャッシュ。「ページ・デザイナでのリージョン・キャッシュの使用」および「コンポーネント・ビューでのリージョン・キャッシュの使用」を参照してください。

- 属性ディクショナリ。「属性ディクショナリの使用」を参照してください。

- 履歴。カレント・ページへの変更のレポートを表示します。

- エクスポート。「アプリケーションおよびアプリケーション・コンポーネントのエクスポート」を参照してください。

- クロス・ページ・ユーティリティ。「クロス・ページ・ユーティリティの使用」を参照してください。

- アプリケーション・ユーティリティ。「アプリケーション・ビルダー・ユーティリティの使用」を参照してください。

- ページ・グループ。「ページ・グループの作成」を参照してください。

- アプリケーションのアップグレード: 「アプリケーションのアップグレードの実行」を参照してください。

- コンポーネント・ビュー。コンポーネント・ビューでページを表示します。「コンポーネント・ビューでのページの管理」を参照してください。

- チーム開発:

ヒント:
この機能がワークスペースに対して有効化されている場合にのみ、「チーム開発」が表示されます。『Oracle Application Express管理ガイド』のチーム開発の管理に関する項を参照してください。

- 機能。「機能の作成」にリンクします。「機能の追跡」を参照してください。

- To Do - 「To Doの作成」にリンクします。「To Doの追跡」を参照してください。

- バグ - 「バグの作成」にリンクします。「バグの管理」を参照してください。

- フィードバック・エントリ - フィードバック・レポートにリンクします。「フィードバックの管理」を参照してください。

- 開発者のコメント。開発者コメントの表示ウィンドウが表示されます。「開発者コメントの追加」を参照してください。

- 共有コンポーネント。共有コンポーネント・ページにリンクします。共有コンポーネントは、アプリケーション内のすべてのページに表示または適用できます。「共有コンポーネントの管理」を参照してください。

- 保存。カレント・ページを保存します。

- ページの保存と実行。カレント・ページを保存して、実行します。「ページ・デザイナでのページの実行」を参照してください。

8.2.2 ツリー・ペイン

ツリー・ペインは、左ペインに表示され、リージョン、ページ・アイテム、ボタン、アプリケーション・ロジック(計算、プロセス、検証など)、動的アクション、ブランチおよび共有コンポーネントをノードとしてツリーに表示します。ツリー・ペインには次の4つのタブがあります。

- レンダリング - リージョン、ページ・アイテム、ページ・ボタン、ページ・コンポーネントおよびアプリケーション・ロジックがノードとしてツリーに表示されます。

- 動的アクション - このページに対して定義された動的アクションが表示されます。動的アクションを作成することによって、JavaScriptを必要としないで複雑なクライアント側の動作を宣言的に定義できます。「動的アクションの管理」を参照してください。

- プロセス - このページに対して定義されたアプリケーション・ロジックが表示されます。「計算、検証およびプロセスの管理」を参照してください。

- ページ共有コンポーネント - このページに関連付けられた共有コンポーネントが表示されます。「共有コンポーネントの管理」を参照してください。

「動的アクション」および「ページ共有コンポーネント」ツリーは、イベントまたはコンポーネント・タイプでグループ化され、順番に並べられます。「レンダリング」および「プロセス」ツリーは、Oracle Application Expressでの処理方法に基づいてグループ化され、並べられます。この編成により、コンポーネントがいつ処理されるか、およびページのレイアウト方法をよりよく理解できます。「レンダリング」および「プロセス」ツリーには、ノードをコンポーネント・タイプでグループ化するオプションがあります。ツリー・コンポーネントの表示方法を制御するには、ツリー・ヘッダー・バーの「処理順序別にグループ化」または「コンポーネント・タイプ別にグループ化」ボタンをクリックします。

ツリー・ペインの主な機能は次のとおりです。

- コンテキスト・メニュー。コンポーネントまたはコントロールを右クリックすると、コンテキスト・メニューが表示されます。

- プロパティ・エディタへの迅速なアクセス。1つのコンポーネントまたは複数のコンポーネントを選択すると、右ペインのプロパティ・エディタに対応する属性が表示されます。

- ドラッグ・アンド・ドロップ。ツリー内でドラッグ・アンド・ドロップすることによって、コンポーネントおよびコントロールを並べ替えます。

- ツールチップ。コンポーネントまたはコントロールの上にマウスをあわせると、リージョン・タイプ、アイテム・タイプなどの基本情報のツールチップが表示されます。

8.2.3 中央ペイン

ページ・デザイナの中央ペインには、次の4つのタブが表示されます。

- グリッド・レイアウト - 「グリッド・レイアウト」には、ページを定義するリージョン、アイテムおよびボタンが視覚的に表されます。「グリッド・レイアウト」を参照してください。ページ下部のギャラリから選択することによって、新しいリージョン、アイテムおよびボタンをページに追加できます。「ギャラリ」を参照してください。

- メッセージ - 「グリッド・レイアウト」の右に表示されます。ページ・デザイナでコンポーネントを作成したり属性を編集するとき、対処する必要があるエラーおよび警告が「メッセージ」で通知されます。「メッセージ」を参照してください。

- ページ検索 - 「メッセージ」の右に表示されます。「ページ検索」を使用して、リージョン、アイテム・ボタン、動的アクション、列などのすべてのページ・メタデータを検索します。「ページ検索」を参照してください。

- ヘルプ - 「ページ検索」の右に表示されます。「ヘルプ」には、プロパティ・エディタ属性のヘルプ・テキストが表示されます。「ヘルプ」を参照してください。

8.2.4 グリッド・レイアウト

グリッド・レイアウトは中央ペインに表示され、ページを定義するリージョン、アイテムおよびボタンが視覚的に表されます。ウィンドウ・スプリッタを使用すると、「グリッド・レイアウト」のサイズを変更できます。また、「開く」ボタンをクリックしてグリッド・レイアウトを拡大し、その後「リストア」をクリックして前のサイズに戻すこともできます。

「グリッド・レイアウト」メニューは、ペインの右側に表示されます。このメニューを使用すると、表示する情報のタイプおよび量のカスタマイズ、選択したコンポーネントの削除、移動およびコピーを実行できます。特定のリージョンが「グリッド・レイアウト」ペイン全体に表示されるようにするには、リージョンを選択して、「グリッド・レイアウト」メニューから「ここから表示」を選択します。選択したリージョンがグリッド・レイアウト全体に表示されます。ビューをリストアするには、「ページから表示」を選択します。

ドラッグ・アンド・ドロップで、リージョン、アイテムおよびボタンの移動、コピーおよび並べ替えを実行できます。ギャラリからドラッグしてページ上の目的の位置にドロップすることによって、新しいリージョン、アイテムおよびボタンを追加できます。アイテムを既存のアイテムと同じ行にドラッグするなど、コンポーネントを新しい位置にドラッグする場合は、コンポーネントを目的の位置にドラッグした後、グリッドが変更されて新しいドロップ位置が表示されるまで待つ必要があります。

グリッド・レイアウトの主な機能は次のとおりです。

- コンテキスト・メニュー。コンポーネントまたはコントロールを右クリックすると、コンテキスト・メニューが表示されます。

- プロパティ・エディタへの迅速なアクセス。1つのコンポーネントまたは複数のコンポーネントを選択すると、右ペインのプロパティ・エディタに対応する属性が表示されます。

- ドラッグ・アンド・ドロップ。新しく作成したり、ドラッグ・アンド・ドロップでリージョン、アイテムおよびボタンを移動、コピーおよび並べ替えることができます。

- ツールチップ。コンポーネントまたはコントロールの上にマウスをあわせると、リージョン・タイプ、アイテム・タイプなどの基本情報のツールチップが表示されます。

ヒント:
非表示のアイテムはグリッド・レイアウトに表示されませんが、「レンダリング」ツリーには表示されます。

8.2.5 ギャラリ

ギャラリは「グリッド・レイアウト」ペインの下部に表示され、「リージョン」、「アイテム」および「ボタン」の3つのタブがあります。デフォルトでは、サポートされているコントロールとコンポーネントのみが表示されます。コントロールまたはコンポーネントにカーソルをあわせると、それについて説明するツールチップが表示されます。ギャラリで選択してグリッド・レイアウトにドラッグ・アンド・ドロップすることによって、新しいコントロールおよびコンポーネントをページに追加できます。

関連項目:
「ドラッグ・アンド・ドロップによるリージョン、アイテムまたはボタンの追加」

8.2.6 メッセージ

ページ・デザイナでコンポーネントを作成したり属性を編集するとき、対処する必要があるエラーおよび警告が「メッセージ」で通知されます。「メッセージ」タブに、対処する必要があるメッセージの数を示した赤または黄色のバッジが表示されます。「メッセージ」タブには、次の2つのタイプのメッセージが表示されます。

- エラー - エラー・メッセージは赤で表示されます。エラー・メッセージを選択すると、プロパティ・エディタに関連する属性が赤で表示されます。ページを保存する前にエラーに対処する必要があります。

- 警告 - 警告メッセージは黄色で表示されます。警告メッセージを選択すると、プロパティ・エディタで、関連する属性が黄色で表示されます。警告メッセージには対処しないでページを保存できます。

ヒント:
エラーまたは警告のあるコンポーネントは、ツリーとグリッド・レイアウトの両方に、Xアイコンとともに赤で表示されるか、三角形のアイコンとともに黄色で表示されます。

関連項目:
「ドラッグ・アンド・ドロップによるリージョン、アイテムまたはボタンの追加」

8.2.7 ページ検索

「ページ検索」は、中央ペインの「メッセージ」の右に表示されます。「ページ検索」を使用して、リージョン、アイテム・ボタン、動的アクション、列などのすべてのページ・メタデータを検索します。ページを検索するには、指定のフィールドに検索文字列を入力します。大文字と小文字を区別するには、「大/小文字の区別」を選択します。正規表現を検索するには、「正規表現」を選択します。

8.2.8 ヘルプ

ページ・デザイナには、すべてのページ・エディタ属性のヘルプが含まれています。ヘルプを表示するには、属性を選択して「ヘルプ」タブをクリックします。「ヘルプ」ペインをアクティブ化すると、別の属性を選択するたびに表示されるコンテンツが変わります。

関連項目:
「ページ・デザイナでのヘルプの表示」

8.2.9 プロパティ・エディタ

プロパティ・エディタは、右ペインに表示され、現在のコンポーネントの属性がすべて表示されます。ツリー・ビューまたはグリッド・レイアウトのいずれかで異なるコンポーネントを選択すると、プロパティ・エディタは現在の選択を反映するように自動的に更新されます。属性は、目的を説明する機能グループに編成されます。必須属性は、属性ラベルの左上隅に赤の三角形が表示されます。

ペイン上部にある次のボタンを使用して、表示する情報の量を制御できます。

- 共通の表示 - デフォルト値が変更されていたり、よく編集される属性のみを表示します。

- すべて表示 - すべての属性を表示します(デフォルト)。

- すべて閉じる - 機能グループ・ヘッダーのみを表示します。

- すべて開く - 各グループ・ヘッダーの下にすべての属性を表示します。

- グループに移動 - 選択したグループの最初の属性を選択します。

8.2.10 コード・エディタ

大量のコードが必要な属性(リージョン・ソースなど)に対して、次の操作を実行できます。

- フィールドにテキストを直接入力します。

- 「コード・エディタ」をクリックして、フル機能を備えたコード・エディタにテキストを入力します。

関連項目:
「プロパティ・エディタへのアクセス」

コード・エディタは、モーダル・ダイアログとして表示されます。コード・エディタを使用して、大量のコードが必要な属性を編集できます。コード・エディタには、PL/SQL、SQL、HTML、CSSおよびJavaScriptのコンポーネント・プロパティを編集するための強化されたコード・エディタが用意されています。コードのハイライト表示は、特定のプロパティに必要な入力によって決定されます。

コード・エディタの主な機能は次のとおりです。

- 元に戻す

- やり直し

- 検索

- 置換

- クエリー・ビルダー

- オートコンプリート

- 検証

- 構文のハイライト処理

- ブロックのインデントおよびインデント解除

- ダイアログのサイズ変更

ヒント:
プレーン・テキスト・エディタに切り替えるには、「設定」メニューから「プレーン・テキスト・エディタの使用」を選択します。

8.3 ページ・デザイナの使用

この項では、ページ・デザイナを使用してデータベース・アプリケーションを表示および編集する方法について説明します。

- ページ・デザイナでのページの表示

- プロパティ・エディタへのアクセス

- ドラッグ・アンド・ドロップによるリージョン、アイテムまたはボタンの追加

- ギャラリ・コンテキスト・メニューを使用したリージョン、アイテムまたはボタンの追加

- 「レンダリング」ツリーからのリージョン、アイテムまたはボタンの追加

- レンダリング前ブランチ、計算およびプロセスの作成

- ページ送信ブランチ、検証、計算およびプロセスの作成

8.3.1 ページ・デザイナでのページの表示

ページ・デザイナでページを表示するには、次のステップを実行します。

1. 「ワークスペース」ホームページにナビゲートします。

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

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

4. ページを選択します。
デフォルト・ビューのページ・デザイナが表示されます。

ページを実行してプレビューします。アプリケーション・ページを実行すると、エンド・ユーザーに表示されるとおりにレンダリングされたバージョンが表示されます。

関連項目:
「コンポーネント・ビューからページ・デザイナへの切替え」および「ページ・デザイナでのページの実行」

8.3.2 プロパティ・エディタへのアクセス

プロパティ・エディタは、右ペインに表示され、現在選択しているコンポーネントのすべての属性が表示されます。

プロパティ・エディタにアクセスするには、次のステップを実行します。

1. ページ・デザイナでページを表示します。「ページ・デザイナでのページの表示」を参照してください。
ページ・デザイナが表示されます。

2. ツリー・ペインまたはグリッド・レイアウトから、編集するコンポーネントまたはコントロールを選択します。

ヒント:
コントロールまたはコンポーネントにカーソルをあわせると、それについて説明するツールチップが表示されます。

プロパティ・エディタには、選択したコンポーネントまたはコントロールの属性が表示されます。

関連項目:
「プロパティ・エディタ」

8.3.3 ドラッグ・アンド・ドロップによるリージョン、アイテムまたはボタンの追加

各ページにはボタンおよびフィールド(アイテムと呼ばれる)を配置でき、これらはリージョンと呼ばれるコンテナにグループ化されます。ギャラリからリージョン、アイテムおよびボタンをドラッグ・アンド・ドロップして、ページに追加できます。

ギャラリからリージョン、アイテムまたはボタンを追加するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。「ページ・デザイナでのページの表示」を参照してください。
ページ・デザイナが表示されます。

2. 必要に応じて、中央ペインの「グリッド・レイアウト」タブを選択します。

3. ギャラリから、作成するリージョン、アイテムまたはボタンを探します。

4. 作成されるコンポーネント上でマウスをクリックしたまま、グリッド・レイアウト内の目的の位置にドラッグします。

ヒント:
コンポーネントは、コンポーネント・タイプによって決定される適切なドロップ位置にのみドロップできます。既存のコンポーネントの横に新しいコンポーネントを配置する場合は、新しいコンポーネントを右にドラッグし、既存のコンポーネントと同じ高さに並べて、新しいドロップ・ゾーンが表示されるまで少し待ちます。

追加するコンポーネント・タイプに基づいて、ページ・デザイナが次に必要な操作を示します。「メッセージ」タブに、対処する必要があるメッセージの数を示した赤または黄色のバッジが表示されます。「メッセージ」を参照してください。次の例に、SQL文が必要だというエラー・メッセージが表示された新しい対話モード・レポート・リージョンを示します。

5. プロパティ・エディタで該当する属性を編集します。必要な属性は、属性ラベルの1つ上の左上隅に赤い三角形で表示されます。

6. 「保存」または「ページの保存と実行」をクリックします。

関連項目:
「ページ・デザイナでのページの実行」および「ギャラリ・コンテキスト・メニューを使用したリージョン、アイテムまたはボタンの追加」

8.3.4 ギャラリ・コンテキスト・メニューを使用したリージョン、アイテムまたはボタンの追加

ギャラリからコンポーネントをドラッグ・アンド・ドロップする以外に、コンポーネントを右クリックしてコンテキスト・メニューを表示することもできます。各コンテキスト・メニューには、コンポーネントを追加できる実際の位置を示す「追加先」オプションがあります。

関連項目:
「ドラッグ・アンド・ドロップによるリージョン、アイテムまたはボタンの追加」

8.3.5 「レンダリング」ツリーからのリージョン、アイテムまたはボタンの追加

「レンダリング」ツリー内で新しいコンポーネントを作成するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。「ページ・デザイナでのページの表示」を参照してください。
ページ・デザイナが表示されます。

2. 左ペインで、「レンダリング」タブを選択します。

3. 適切なリージョン、アイテムまたはリージョン・ボタンにナビゲートします。

4. 既存のコンポーネントまたはコンテナを右クリックして、コンポーネント・タイプのコンテキスト・メニューを表示します。

5. 「リージョンの作成」、「ページ・アイテムの作成」または「ボタンの作成」を選択します。使用可能なオプションは、選択するノードによって異なります。

6. プロパティ・エディタで該当する属性を編集します。必要な属性は、属性ラベルの1つ上の左上隅に赤い三角形で表示されます。

7. 「保存」または「ページの保存と実行」をクリックします。

関連項目:
「ページ・デザイナでのリージョンの管理」、「ページ・デザイナでのページ・レベル・アイテムの表示」および「ページ・デザイナでのボタンの管理」

8.3.6 レンダリング前ブランチ、計算およびプロセスの作成

ページのレンダリング前に実行するブランチ、計算およびプロセスを作成するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。「ページ・デザイナでのページの表示」を参照してください。
ページ・デザイナが表示されます。

2. 左ペインで、「レンダリング」タブを選択します。

3. 「レンダリング」ツリーの上部にある「レンダリング前」ノードを展開します。

4. 「ヘッダーの前」、「ヘッダーの後」、「リージョンの前」を右クリックして、そのプロセス・ポイントのコンテキスト・メニューを表示します。

5. 「ブランチの作成」、「計算の作成」または「プロセスの作成」を選択します。

6. プロパティ・エディタで該当する属性を編集します。必要な属性は、属性ラベルの1つ上の左上隅に赤い三角形で表示されます。

7. 「保存」または「ページの保存と実行」をクリックします。

ヒント:
デフォルトの表示を変更してコンポーネント・タイプごとにコンポーネントをグループ化している場合は、「プロセス」タブにナビゲートしてレンダリング前コンポーネントを保守する必要があります。

関連項目:
「計算、検証およびプロセスの管理」

8.3.7 ページ送信ブランチ、検証、計算およびプロセスの作成

ページの送信時に実行するブランチ、検証、計算およびプロセスを作成するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。「ページ・デザイナでのページの表示」を参照してください。
ページ・デザイナが表示されます。

2. 左ペインで、「プロセス」タブを選択します。

3. プロセス・ツリー内で、必要に応じて「送信後」、「検証中」、「プロセス」または「プロセスの後」にナビゲートします。

4. 識別子または既存のコンポーネントを右クリックして、そのプロセス・ポイントのコンテキスト・メニューを表示します。

5. 「ブランチの作成」、「検証の作成」、「計算の作成」または「プロセスの作成」を選択します。

6. プロパティ・エディタで該当する属性を編集します。必要な属性は、属性ラベルの1つ上の左上隅に赤い三角形で表示されます。

7. 「保存」または「ページの保存と実行」をクリックします。

ヒント:
コンテキスト・メニューを使用して、コンポーネントを複製および削除したり、その他のページにコピーすることができます。

関連項目:
「計算、検証およびプロセスの管理」

8.3.8 ページの検索

「ページ・ファインダ」は、ページ・デザイナ・ツールバーの最初のコントロールで、カレント・ページ番号を表示します。「ページ・ファインダ」を使用して、カレント・アプリケーション内のページを検索します。

アプリケーション内のページを検索するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。「ページ・デザイナでのページの表示」を参照してください。
ページ・デザイナが表示されます。

2. ページ・デザイナ・ツールバーで、「ページ・ファインダ」をクリックします。
「ページ・ファインダ」が表示されます。

3. ウィンドウ上部のタブをクリックして、ビューを変更します。

- 現在のユーザー・インタフェース - 現在のユーザー・インタフェースのページが表示されます。

- 現在のグループ - カレント・ページがグループに関連付けられている場合、このタブにはカレント・グループに関連付けられたページが表示されます。

- すべてのページ - カレント・アプリケーションのすべてのページが表示されます。

- 最近編集された - 最近編集されたページが表示されます。

4. 「検索」フィールドに検索文字列を入力し、[Enter]を押します。
ページ番号、ページ名、ユーザー・インタフェースまたはグループ名を検索します。検索では、大文字と小文字は区別されず、正規表現がサポートされています。

関連項目:
「ページ・デザイナでのページの実行」および「ページ・グループの作成」

8.4 ページ・デザイナでのページ属性の編集

この項では、ページ・デザイナのプロパティ・エディタでページ属性を表示および編集する方法について説明します。編集可能な共通のページ属性には、ページの名前またはタイトル、ヘッダーおよびフッター・テキスト、選択した認可スキームが含まれます。

- プロパティ・エディタでのページ属性の表示

- プロパティ・エディタ - ページ

- ページ・デザイナを使用したJavaScriptの組込み

- ページ・デザイナでのセッションの再結合の構成

- ページ・デザイナでのダイアログ属性の構成

8.4.1 プロパティ・エディタでのページ属性の表示

プロパティ・エディタでページ属性を表示するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。「ページ・デザイナでのページの表示」を参照してください。
ページ・デザイナが表示されます。

2. 「レンダリング」ツリーまたはグリッド・レイアウトのいずれかで、ページ名を選択します。ページ名は、ページの編集時にデフォルトで選択されます。
プロパティ・エディタにページ属性が表示されます。

3. 対象となる属性を編集します。
属性の詳細は、プロパティ・エディタで属性を選択し、中央ペインで「ヘルプ」タブをクリックして、参照してください。「ヘルプ」ペインをアクティブ化すると、別の属性を選択するたびに表示されるコンテンツが変わります。

関連項目:
「ページ・デザイナでのヘルプの表示」

8.4.2 プロパティ・エディタ - ページ

デフォルトでは、プロパティ・エディタにすべての属性が表示されます。

ペイン上部にある次のコントロールを使用して、属性の表示方法を制御できます。

- 共通の表示 - デフォルト値が変更されていたり、よく編集される属性のみを表示します。

- すべて表示 - すべての属性が表示されます。

- すべて閉じる - 機能グループ・ヘッダーのみを表示します。

- すべて開く - 各グループ・ヘッダーの下にすべての属性を表示します。

必須属性は、属性ラベルの左上隅に赤の三角形が表示されます。

属性の詳細は、プロパティ・エディタで属性を選択し、中央ペインで「ヘルプ」タブをクリックして、参照してください。「ヘルプ」ペインをアクティブ化すると、別の属性を選択するたびに表示されるコンテンツが変わります。

8.4.3 ページ・デザイナを使用したJavaScriptの組込み

JavaScriptグループの属性を編集することによって、ページにJavaScriptを含めることができます。これは、ページに固有のファンクションに有効な方法であり、ファンクションを.jsファイルに組み込む前にテストを行う有効な方法です。

次の例では、コードを追加することによって、カレント・ページの任意の場所からtestファンクションにアクセスできるようにしています。

JavaScriptコードをJavaScript属性に追加するには、次のステップを実行します。

1. プロパティ・エディタにページ属性を表示します。「プロパティ・エディタでのページ属性の表示」を参照してください。

2. 「すべて閉じる」アイコンをクリックして、「JavaScript」を見つけて展開します。

3. 「JavaScript」で、次の属性にコードを入力します。

ヒント:
属性の詳細を参照したり、例を表示するには、プロパティ・エディタで属性を選択して、中央ペインの「ヘルプ」タブをクリックします。

- ファイルURL: このページにロードするコードのJavaScriptファイルURLを入力します。各URLを新しい行に記述する必要があります。ファイルの縮小バージョンを指定する場合、置換文字列#MIN#を使用して.minを、または#MIN_DIRECTORY#使用してminified/を通常ページ・ビューのファイルURLに含めたり、ページをデバッグ・モードで表示する場合は空の文字列を含めることができます。アプリケーションのバージョンをファイルURLに含める場合、置換文字列#APP_VERSION#にアクセスすることもできます。

- ファンクションおよびグローバル変数の宣言 - このページで参照されるファンクションまたはグローバル変数宣言などのJavaScriptコードを入力します。複数のページで同じJavaScriptが必要な場合、重複を避け、ブラウザで静的ファイルをキャッシュするため、外部JavaScriptファイルにコードを挿入することを検討してください。
ここに入力したコードによって、ページ・テンプレート内の#PAGE_JAVASCRIPT#置換文字列が置き換えられます。

注意: スクリプトの開始タグや閉じタグを含めないでください。JavaScriptコードのみ含めます。

ショートカットを参照するには、次の方法を使用します。

"SHORTCUTNAME"

- ページ・ロード時に実行: ページのロード時に実行するJavaScriptコードを入力します。このコードはOracle Application Expressによって生成されたJavaScriptコードの後に実行されます。

たとえば、「ファンクションおよびグローバル変数の宣言」属性に次を追加すると、カレント・ページのすべての場所からアクセス可能なファンクションをテストします。

function test(){
alert('This is a test.');
}

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

8.4.4 ページ・デザイナでのセッションの再結合の構成

リージョンの再結合属性は、既存のセッションの結合(ディープ・リンクと同等)に対するサポートを制御します。技術的に、この属性は、このアプリケーションに対するURLにセッションIDを含むかどうかを決定します。

警告:
セッションの再結合を有効にすると、攻撃者が既存のエンド・ユーザー・セッションを乗っ取ることが可能になるため、アプリケーションのセキュリティが侵害される可能性があります。詳細は、「「セッションを再結合」について」を参照してください。

セッションの再結合を使用するには、管理者がインスタンス・レベルでセッションの再結合を有効化する必要があります。インスタンス・レベルでのセッションの再結合のより制限的な値は、アプリケーションおよびページ設定をオーバーライドします。

ページ・デザイナでセッションの再結合を構成するには、次のステップを実行します。

1. プロパティ・エディタにページ属性を表示します。「プロパティ・エディタでのページ属性の表示」を参照してください。

2. 「すべて閉じる」アイコンをクリックして、「セキュリティ」を見つけて展開します。

3. 「セッションを再結合」から、次のオプションを選択します。

- アプリケーション・デフォルト - アプリケーション・レベルで定義されている設定を継承します。「ブラウザ・セキュリティ」を参照してください。

- 無効 - URLにセッションIDが含まれていない場合、Application Expressは新しいセッションを作成します。

- パブリック・セッションに対して有効 - URLがパブリック・ページのもので、セッションIDが含まれていない場合、Application Expressはそのアプリケーションに対して確立された既存のセッションCookieの利用を試みます。Application Expressは、セッションがまだ認証されていない場合にのみCookieを使用して結合します。
オプション「パブリック・セッションに対して有効」では、「フレームへの埋込み」を「同じ起点から許可」または「拒否」に設定する必要があります。これはURLペイロードの条件に関連付けられませんが、セッション・ステート保護されるURLにも適用されます。

- すべてのセッションに対して有効 - URLにセッションIDが含まれておらず、次の条件が満たされる場合、Application Expressはそのアプリケーションに対して確立された既存のセッションCookieの利用を試みます。
セッション・ステート保護がそのアプリケーションに対して有効で、URLに有効なチェックサムが含まれています。パブリック・ブックマークの場合、最も制限的なアイテム・レベルの保護は「制限なし」または「チェックサムが必要 - アプリケーション・レベル」である必要があります。

URLにペイロード(リクエスト・パラメータ、クリア・キャッシュまたはデータ値ペア)は含まれません。この設定でも、アプリケーションの「フレームへの埋込み」を「同じ起点から許可」または「拒否」に設定する必要があります。

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

関連項目:
「ブラウザ・セキュリティ」、「「セッションを再結合」について」および『Oracle Application Express管理ガイド』のセッションの再結合の構成に関する項

8.4.5 ページ・デザイナでのダイアログ属性の構成

ヒント:
ダイアログ・ページの作成は、複数ステップのプロセスです。詳細は、「ダイアログ・ページの作成」を参照してください。

ページ・デザイナでダイアログ属性を構成するには、次のステップを実行します。

1. プロパティ・エディタにページ属性を表示します。「プロパティ・エディタでのページ属性の表示」を参照してください。

2. 「すべて閉じる」アイコンをクリックします。

3. 「外観」を展開して、「ページ・モード」が「モーダル・ダイアログ」または「非モーダル・ダイアログ」のいずれかに設定されていることを確認します。詳細は、フィールドレベル・ヘルプを参照してください。

4. 「ダイアログ」を展開して、表8-1に示す属性を構成します。

表8-1 ページ属性: ダイアログ

属性

説明

幅

ダイアログの幅をピクセルまたはパーセント単位で入力します。この設定は、ページ・テンプレート・レベルで指定されたデフォルトのダイアログ幅を上書きします。

デスクトップ・ユーザー・インタフェースを使用しているページの場合、値は500などのピクセル単位で設定する必要があります。jQueryモバイル・スマートフォン・ユーザー・インタフェースを使用しているページの場合、値は80%などのパーセント単位で設定する必要があります。

ページ・テンプレートのダイアログ初期化コード内の置換文字列#DIALOG_WIDTH#は、このアイテムに入力した値で置換されます。

高さ

ダイアログの高さを500などのピクセル単位で入力します。

ページ・テンプレートのダイアログ初期化コード内の置換文字列#DIALOG_HEIGHT#は、このアイテムに入力した値で置換されます。

最大幅

ダイアログの最大幅をピクセル単位で入力します。この設定は、ページ・テンプレート・レベルで指定されたデフォルトのダイアログ最大幅を上書きします。

jQueryモバイル・スマートフォン・ユーザー・インタフェースを使用しているページの場合、最大幅は500です。ページ・テンプレートのダイアログ初期化コード内の置換文字列#DIALOG_MAX_WIDTH#は、このアイテムに入力した値で置換されます。

属性

Oracle Application Expressのダイアログ・サポートは、ページのユーザー・インタフェースによって異なり、jQuery UIダイアログはデスクトップ・ユーザー・インタフェースに使用され、jQuery Mobileダイアログ・ウィジェットはモバイル・ユーザー・インタフェースに使用されます。Oracle Application Expressでは、ダイアログ属性のサブセットとして、高さ、幅および最大幅がサポートされます。

ダイアログの追加属性を定義するには、名前/値のペアをカンマ区切りリストに入力します。

ページ・テンプレート・レベルで定義されたダイアログ初期化コード内の置換文字列#DIALOG_ATTRIBUTES#は、このアイテムに入力された任意の値で置換されます。

詳細は、ヘルプを参照してください。

CSSクラス

ダイアログに適用する追加のCSSクラスをスペース区切りリストとして入力します。次に例を示します。

ui-dialog--wizard

ページ・テンプレートに出現した置換文字列#DIALOG_CSS_CLASSES#は、このフィールドで指定した値で置換されます。この値はページ・テンプレート・レベルで設定された値を上書きします。

チェーン・ダイアログ

このダイアログが別のダイアログによって開かれ、同じダイアログ・ウィンドウを再利用する場合、「はい」を選択します。たとえば、このダイアログが複数ページ・ダイアログ・ウィザードの一部で、ウィザードの各ステップにダイアログ・ウィンドウを再利用する場合です。

このダイアログが別のダイアログによって開かれ、新規ダイアログ・ウィンドウで開かれる必要がある場合、「いいえ」を選択します。たとえば、このダイアログがモーダルで、親モーダル・ダイアログ・ウィンドウ内で開く場合です。

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

関連項目:
「ダイアログ・ページの作成」

8.5 ページ・デザイナでのページの実行

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

ヒント:
「ページの保存と実行」ボタンを使用して、モーダルおよび非モーダル・ダイアログ・ページを直接実行することはできません。モーダルおよび非モーダル・ダイアログ・ページを表示するには、ダイアログ・ページを開くことのできる通常のページを実行して、そこからアクセスします。

ページ・デザイナでページを実行するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。「ページ・デザイナでのページの表示」を参照してください。
ページを実行してプレビューします。アプリケーション・ページを実行すると、エンド・ユーザーに表示されるとおりにレンダリングされたバージョンが表示されます。

2. 右上隅の「ページの保存と実行」ボタンをクリックします。「ページの保存と実行」ボタンは、青い右向きの矢印の形です。

レンダリングされたアプリケーション・ページが表示されます。

関連項目:
「アプリケーションまたはページの実行」および「実行時開発者ツールバー」

8.6 実行時開発者ツールバー

アプリケーション・ビルダーからデスクトップ・アプリケーションを実行する場合は、編集可能な実行中のページの下部に、実行時開発者ツールバーが表示されます。「開発者」ツールバーを使用すると、迅速に、カレント・アプリケーションまたは現在実行されているページを編集したり、セッション・ステートを表示することができます。実行時開発者ツールバーは、アプリケーション定義ページの「可用性」、「ステータス」属性が「開発者ツールバーで使用可能」に設定されている場合にのみ表示されます。

注意:
実行時開発者ツールバーは、ロックされたパッケージ・アプリケーション・ページまたはjQuery Mobileスマートフォン・ページには表示されません。

実行時開発者ツールバーは、次のコントロールで構成されています。

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

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

- 「ページの編集」: 現在実行中のページIDを表示します。表示されるビューは、現在のプリファレンスによって異なります。「ページ・デザイナとコンポーネント・ビューの違いの理解」を参照してください。

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

- デバッグの表示: デバッグ・レポートを表示します。「アプリケーションのデバッグ」を参照してください。

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

- グリッドの表示: 「グリッドの表示」と「グリッドの非表示」を切り替えます。このオプションは、グリッド・レイアウトが使用され、そのレイアウトでグリッドの表示がサポートされ、ページに複数の列がある場合にのみ適用されます。

- クイック編集: 開発者は、「クイック編集」モードを開始し、必要なコンポーネントを選択して、ページ・デザイナでそのコンポーネントに即時にアクセスできます。クイック編集モードを終了するには、[Esc]を押すかコンポーネントの外側をクリックします。

- テーマ・ローラー: カラー・ピッカーから色を選択したり値を設定することで、アプリケーションの外観を簡単にカスタマイズできます。「テーマ・ローラー」をサポートしているテーマにのみ表示されます。「テーマ・スタイルの使用」を参照してください。

- 開発者ツールバー・オプション: 右端に表示され、機械の歯車のような形をしています。次のコントロールを使用して、「開発者」ツールバーの表示方法をカスタマイズできます。

- 自動非表示

- アイコンのみの表示

- 表示位置 (上、左、下、右)

8.7 ページ・デザイナでのデータベース・アプリケーション・ページのコピー

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

ページをコピーする手順は次のとおりです。

1. コピーするページにナビゲートします。「ページ・デザイナでのページの表示」を参照してください。

2. ページ・デザイナ・ツールバーで、「作成」メニューをクリックして「コピーとしてのページ」を選択します。

3. 「ページのコピー・オプション」で、次のいずれかを選択します。

- このアプリケーションのページ

- 別のアプリケーションのページ

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

8.8 ページ・デザイナでのページの削除

ページを削除すると、対応する表、ブレッドクラムおよびリスト・エントリが削除されます。

- ページ・デザイナでのページの削除

- 複数のページの削除

- ページの範囲の削除

関連項目:
「ページのロックおよびロック解除」

8.8.1 ページ・デザイナでのページの削除

ページ・デザイナでページを削除するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。「ページ・デザイナでのページの表示」を参照してください。

2. ページ番号を確認します。

3. ページ・デザイナ・ツールバーで、「ユーティリティ」をクリックして「ページの削除」をクリックします。

4. 「ページを完全に削除」をクリックします。

関連項目:
「ページ・デザイナ・ツールバー」

8.8.2 複数のページの削除

複数ページを削除するには、次のステップを実行します。

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

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

3. 「ユーティリティ」をクリックします。

4. 「ページ固有のユーティリティ」で、「クロス・ページ・ユーティリティ」をクリックします。

5. 「複数のページの削除」をクリックします。

6. 削除するページを選択し、「ページの削除」をクリックします。

8.8.3 ページの範囲の削除

ページの範囲を削除するには、次のステップを実行します。

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

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

3. 「ユーティリティ」をクリックします。

4. 「ページ固有のユーティリティ」で、「クロス・ページ・ユーティリティ」をクリックします。

5. 「複数のページの削除」をクリックします。

6. 「範囲別ページの削除」タブをクリックします。

7. 削除するページを入力し、「ページの削除」をクリックします。

9 コンポーネント・ビューでのページの管理

アプリケーション・ビルダーでは、ページ・デザイナとコンポーネント・ビューの2つの方法でアプリケーション・ページを表示したり管理することができます。この項では、コンポーネント・ビューでデータベース・アプリケーション・ページを管理する方法について説明します。

- コンポーネント・ビュー・ウィンドウについて

- コンポーネント・ビューの共通のUI要素の理解

- コンポーネント・ビューの使用

- コンポーネント・ビューでのページ属性の編集

- コンポーネント・ビューでのアプリケーションまたはページの実行

- 実行時開発者ツールバー

- コンポーネント・ビューでのデータベース・アプリケーション・ページのコピー

- コンポーネント・ビューでのページの削除

関連項目:
「ページ・デザイナからコンポーネント・ビューへの切替え」、「開発者コメントの追加」、「データベース・アプリケーションの作成」、「ページ・レイアウトの制御」および「ナビゲーションの追加」

9.1 コンポーネント・ビュー・ウィンドウについて

コンポーネント・ビューは、アプリケーション・ビルダーでページを編集するための従来のユーザー・インタフェースです。コンポーネント・ビューは、ユーザー・インタフェース要素とアプリケーション・ロジックをコンポーネント・タイプ別にグループ化します。コンポーネントを編集するには、コンポーネント名をドリルダウンするか、アイコンをクリックします。ページ・デザイナとは異なり、コンポーネント・ビューでは、ページを視覚的に表したり、ページ・コンポーネントをドラッグ・アンド・ドロップすることができません。ページ上のコンポーネントの位置をプレビューするには、ページを実行する必要があります。

コンポーネント・ビュー・ウィンドウは、次のセクションに分かれています。

- ページ・レンダリング。ページ・レンダリングとは、データベースからページを生成するプロセスです。「ページ・レンダリング」セクションを使用して、ページ属性、リージョン、ボタン、アイテム、ページ・レンダリングの計算、およびページ・プロセスを含むページのレンダリングに影響するコントロールを変更できます。

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

- 共有コンポーネント。「共有コンポーネント」セクションには、アプリケーション内の1つ以上のページで使用できる共通のコンポーネントが表示されます。

関連項目:
「コンポーネント・ビューでのページの表示」および「コンポーネント・ビューでのページの編集」

9.2 コンポーネント・ビューの共通のUI要素の理解

この項では、共通のコンポーネント・ビューのUI要素について説明します。

- コンポーネント・ビュー・ツールバー

- ナビゲーション・バー

ヒント:
開発者ナビゲーション・ツールは、ほとんどのOracle Application Expressページでヘッダー・リージョンに表示されます。「開発者ナビゲーション・ツール」を参照してください。

関連項目:
「コンポーネント・ビューでのページの表示」および「コンポーネント・ビューでのページの編集」

9.2.1 コンポーネント・ビュー・ツールバー

コンポーネント・ビュー・ツールバーは、ページ上部に表示されます。カーソルをアクティブなボタンおよびメニューにあわせると、前の図に示すようにツールチップが表示されます。ページ・デザイナ・ツールバーのボタンおよびメニュー・オプションは次のとおりです。

- 開発者のコメント(バグまたはTo Do)。「開発者コメント、バグまたはTo Doの作成」ダイアログを表示します。「開発者コメントの追加」、「バグの管理」および「To Doの追跡」を参照してください。

- 「検索」アイコン。「検索」アイコンは懐中電灯の形をしています。「検索」アイコンをクリックして、アイテム、ページ、問合せ、表、PL/SQLコードまたはイメージを検索し、デバッグ・レポート、セッション・ステートおよびエラーを表示します。「「検索」アイコンの使用」を参照してください。

- 共有コンポーネント。共有コンポーネント・ページにリンクします。共有コンポーネントは、アプリケーション内のすべてのページに表示または適用できます。「共有コンポーネントの管理」を参照してください。

- ページの編集。カレント・ページを表示します。

- ページの実行。カレント・ページを実行します。「コンポーネント・ビューでのアプリケーションまたはページの実行」を参照してください。

9.2.2 ナビゲーション・バー

ナビゲーション・バーは、ページ上部のブレッドクラム・メニューの下に表示されます。このバーは、アプリケーション内のページ間をナビゲートするために使用します。

- ページ・ファインダ。「ページ・ファインダ」を使用してページ間をナビゲートします。ページにナビゲートするには、「ページ・ファインダ」にページ番号を入力して「実行」をクリックします。

- 前のページ - 「前のページ」(<)をクリックして、前のアプリケーション・ページを表示します。

- 次のページ - 「次のページ」(>)をクリックして、次のアプリケーション・ページを表示します。

- 作成:

- ページ。「データベース・アプリケーションへのページの追加について」を参照してください。

- コピーとしてのページ。「コンポーネント・ビューでのデータベース・アプリケーション・ページのコピー」を参照してください。

- リージョン。「コンポーネント・ビューでのリージョンの作成」を参照してください。

- ページ・コンポーネント。「ページ制御コンポーネント・ビューの作成」を参照してください。

- ページ・グループ。「ページ・グループの作成」を参照してください。

- 共有コンポーネント。「共有コンポーネントの管理」を参照してください。

- 開発者のコメント。「開発者コメントの追加」を参照してください。

- チーム開発。サブメニューの「機能」、「To Do」および「バグ」を表示します。「機能の追跡」、「To Doの追跡」および「バグの管理」を参照してください。

- ユーティリティ:

- ページの削除。「コンポーネント・ビューでのページの削除」を参照してください。

- アドバイザ: 「アプリケーション整合性のチェックのためのアドバイザの実行」を参照してください。

- コンポーネントの再順序付け。

- クリーンアップ。ページのアイテムを10ずつ再順序付けします。

- ロック。「ページのロックおよびロック解除」を参照してください。

- ページ・イベント。現在定義されているすべてのページ・コントロールおよびプロセスの詳細が、Application Expressエンジンによるページのレンダリング、ロジックの呼出しおよびプロセスの実行の順序で示されます。

- キャッシュ。「ページ・デザイナでのリージョン・キャッシュの使用」および「コンポーネント・ビューでのリージョン・キャッシュの使用」を参照してください。

- 属性ディクショナリ。「属性ディクショナリの使用」を参照してください。

- 履歴。カレント・ページへの変更のレポートを表示します。

- エクスポート。「アプリケーションおよびアプリケーション・コンポーネントのエクスポート」を参照してください。

- クロス・ページ・ユーティリティ。「クロス・ページ・ユーティリティの使用」を参照してください。

- アプリケーション・ユーティリティ。「アプリケーション・ビルダー・ユーティリティの使用」を参照してください。

- ページ・グループ。「ページ・グループの表示」を参照してください。

- アプリケーションのアップグレード: 「アプリケーションのアップグレードの実行」を参照してください。

- ページ・デザイナ - 「ページ・デザイナ」をクリックしてページ・デザイナのページを表示します。「ページ・デザイナでのページの管理」を参照してください。

9.3 コンポーネント・ビューの使用

この項では、コンポーネント・ビューを使用して、データベース・アプリケーション・ページを表示および編集する方法について説明します。

- コンポーネント・ビューでのページの表示

- コンポーネント・ビューでのページの編集

- ページ・レンダリングの理解

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

- 共有コンポーネントの理解

- ページ制御コンポーネント・ビューの作成

9.3.1 コンポーネント・ビューでのページの表示

コンポーネント・ビューでページを表示するには、次のステップを実行します。

1. 「ワークスペース」ホームページにナビゲートします。

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

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

4. ページを選択します。
デフォルト・ビューのページ・デザイナが表示されます。

ヒント:
前にコンポーネント・ビューでページを表示した場合は、コンポーネント・ビューがデフォルトで表示されます。

5. ページ・デザイナ・ツールバーで、「コンポーネント・ビュー」アイコンをクリックします。
コンポーネント・ビューが表示されます。

ページを実行してプレビューします。アプリケーション・ページを実行すると、エンド・ユーザーに表示されるとおりにレンダリングされたバージョンが表示されます。

9.3.2 コンポーネント・ビューでのページの編集

この項では、コンポーネント・ビューでページを編集する方法について説明します。

- コンポーネント・ビューの使用について

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

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

9.3.2.1 コンポーネント・ビューの使用について

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

コンポーネントを編集するには、コンポーネント名をドリルダウンするか、次のセクションで説明されているアイコンをクリックします。

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

サブセクションのタイトルの右側に表示される「すべて編集」アイコンをクリックすると、そのサブセクション内のコントロール、コンポーネントまたはロジックを編集できます。「すべて編集」アイコンは、紙の上に鉛筆が重なった形をしています。

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

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

「作成」アイコンは、プラス(+)記号の形です。「作成」アイコンをクリックすると、コントロールやコンポーネントが作成されます。

9.3.3 ページ・レンダリングの理解

この項では、コンポーネント・ビューの「ページ・レンダリング」のサブセクションについて説明します。

- ページ・レンダリングとは

- ページ・レンダリング

9.3.3.1 ページ・レンダリングとは

ページ・レンダリングとは、データベースからページを生成するプロセスです。開発者は、「ページ・レンダリング」セクションを使用して、ページ属性、リージョン、ボタン、アイテムおよびページ・プロセスを含むページのレンダリングに影響するコントロールを変更できます。

9.3.3.2 ページ・レンダリング

表9-1に、コンポーネント・ビューの「ページ・レンダリング」のサブセクションを示します。

表9-1 「ページ・レンダリング」のサブセクション

サブセクション

説明

ページ

ページ属性は、ページ名、ならびにページ・タイトルや関連するページ・テンプレート、ヘッダー・テキスト、および一部の名前のための選択された認可スキームといった表示属性などのページの詳細な特性を制御します。

関連項目: 「コンポーネント・ビューでのページ属性の編集」

リージョン

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

特定のリージョン・テンプレートによってリージョンの外観を制御できます。リージョンを使用して、ページ・コントロール(アイテムやボタンなど)をグループ化できます。また、追加のHTMLを生成しない単純なリージョンを作成したり、HTMLの表やイメージ内でコンテンツをフレーム表示する複雑なリージョンを作成できます。

関連項目: 「リージョンについて」、『Oracle Database開発ガイド』のPL/SQLを使用したWebアプリケーションの開発に関する情報および『Oracle Database PL/SQLパッケージおよびタイプ・リファレンス』のhtpパッケージに関する情報

ボタン

アプリケーションの設計時、ボタンを使用して、ユーザーを特定のページやURLにダイレクトしたり、ユーザーによるページの送信を可能にできます。ページを送信すると、Application Expressエンジンが情報を転送または処理します。ボタンの実装は、ボタン・テンプレートによって決定されます。ボタンを事前定義されたリージョン・テンプレートの位置に置くことも、フォーム内のアイテム間に置くこともできます。

関連項目: 「ボタンの作成」

アイテム

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

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

関連項目: 「ページ・レベル・アイテムの理解」および「アプリケーション・レベル・アイテムの理解」

プロセス

プロセスは、データ操作言語(DML)またはPL/SQLの実行に使用されるロジック・コントロールです。たとえば、プロセスを使用して、ページのレンダリングの際にセッション・ステートを移入したり、(PL/SQLなどを使用して)一部のタイプのロジックを実行したり、レンダリング・エンジンをコールできます。一般に、プロセスはアクションを実行します。プロセスは、ハンドコードしたPL/SQLの場合も、事前定義したプロセスの呼出しの場合もあります。

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

動的アクション

動的アクションは、JavaScriptを必要としないで複雑なクライアント側の動作を宣言的に定義する方法を提供します。定義された条件セットに基づいて実行されるアクションを指定できます。また、アクションの影響を受ける要素や、影響を受ける時期と影響も指定できます。

関連項目: 「動的アクションの管理」

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

この項では、コンポーネント・ビューの「ページ・プロセス」のサブセクションについて説明します。

- ページ・プロセスとは

- ページ・プロセス

9.3.4.1 ページ・プロセスとは

ページ・プロセスは、ページを送信するプロセスです。通常、ページは、ユーザーがボタンをクリックすると送信されます。「ページ・プロセス」セクションを使用して、計算、検証、プロセス、ブランチなどのアプリケーション・ロジックを指定します。

9.3.4.2 ページ・プロセス

表9-2に、コンポーネント・ビューの「ページ・プロセス」のサブセクションを示します。

表9-2 「ページ・プロセス」のサブセクション

サブセクション

説明

計算

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

関連項目: 「ページ計算の理解」

プロセス

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

関連項目: 「ページ・プロセスの理解」

ブランチ

ブランチは、ユーザーがアプリケーション内をナビゲートする方法を決定するロジック・コントロールの作成を可能にします。

関連項目: 「ブランチを使用したナビゲーションの制御」および「「対象ボタン」属性について」

9.3.5 共有コンポーネントの理解

この項では、コンポーネント・ビューの「共有コンポーネント」に表示されるサブセクションについて説明します。

- 共有コンポーネントとは

- 共有コンポーネント

関連項目:
「共有コンポーネントの管理」

9.3.5.1 共有コンポーネントとは

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

関連項目:
「共有コンポーネントの管理」

9.3.5.2 共有コンポーネント

表9-3に、コンポーネント・ビューの「ページ・プロセス」のサブセクションを示します。

表9-3 「共有コンポーネント」のサブセクション

サブセクション

説明

タブ

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

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

関連項目: 「タブの作成」

LOV

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

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

関連項目: 「アプリケーション・レベルでのLOVの作成」

ブレッドクラム

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

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

リスト

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

参照: 「リストの作成」

テーマ

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

関連項目: 「テーマの使用」

テンプレート

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

関連項目: 「カスタム・テーマの作成」

セキュリティ

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

関連項目: 「認可を介したセキュリティの提供」

ナビゲーション・バー

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

関連項目: 「ナビゲーション・バー・エントリの作成」

9.3.6 ページ制御コンポーネント・ビューの作成

ページ制御には、アイテム、ボタン、ブランチ、計算、プロセスまたは検証が含まれています。

コンポーネント・ビューでページ制御を追加するには、次のステップを実行します。

1. コンポーネント・ビューでページを表示します。「コンポーネント・ビューでのページの表示」を参照してください。

2. ナビゲーション・バーで、「作成」メニューをクリックして「ページ・コンポーネント」を選択します。
ページ・コンポーネントの作成ウィザードが表示されます。

3. 次のいずれかを選択します。

- アイテム。「ページ・レベル・アイテムの理解」を参照してください。

- ボタン。「ボタンの作成」を参照してください。

- ブランチ。「ブランチを使用したナビゲーションの制御」を参照してください。

- 計算。「ページ計算の理解」を参照してください。

- プロセス。「ページ・プロセスの理解」を参照してください。

- 検証。「検証の理解」を参照してください。

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

9.4 コンポーネント・ビューでのページ属性の編集

この項では、コンポーネント・ビューでページ属性を編集する方法について説明します。編集可能な共通のページ属性には、ページの名前またはタイトル、ヘッダーおよびフッター・テキスト、選択した認可スキームが含まれます。

- コンポーネント・ビューでのページ属性の表示

- コンポーネント・ビューのページ属性

- コンポーネント・ビューを使用したJavaScriptの組込み

- コンポーネント・ビューでのセッションの再結合の構成

9.4.1 コンポーネント・ビューでのページ属性の表示

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

1. コンポーネント・ビューでページを表示します。「コンポーネント・ビューでのページ属性の表示」を参照してください。

2. 「ページ」で、「編集」アイコンをクリックします。
ページ属性ページが表示されます。必須の値には赤いアスタリスク(*)が付いています。

3. 対象となる属性を編集します。
ページ属性ページは、セクションに分かれています。

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

4. 変更を保存するには、「変更の適用」をクリックします。

9.4.2 コンポーネント・ビューのページ属性

この項では、ページ属性ページのリージョンについて説明します。

- 名前

- 表示属性

- JavaScript

- CSS

- ダイアログ

- HTMLヘッダー

- ヘッダーおよびフッター

- 読取り専用

- セキュリティ

- 重複送信

- サーバー・キャッシュ

- 構成

- エラー処理

- ヘルプ

- コメント

9.4.2.1 名前

表9-4に、ページ名、英数字の別名(オプション)、関連付けられたページ・グループなど、カレント・ページの一般的な属性を示します。

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

属性

説明

名前

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

ページの別名

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

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

f?p=100:home

グループ

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

グループからページを削除するには、「- グループが割り当てられていない -」を選択し、「変更の適用」をクリックします。

関連項目: 「ページ・グループの作成」

9.4.2.2 表示属性

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

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

属性

説明

タイトル

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

ページ・モード

ページ・モードを選択します。オプションは次のとおりです。

- 標準 - ページは標準のApplication Expressアプリケーション・ページとして表示されます。

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

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

関連項目: 「ダイアログ・ページの作成」

ページ・テンプレート・オプション

テンプレート・オプションを使用すると、カレント・ページ・テンプレートに適用される各種CSSカスタマイズ設定の選択が可能になります。テンプレート・オプションとこれに対応するCSSクラスは、ページ・テンプレート・レベルで定義されます。属性の詳細は、フィールドレベル・ヘルプを参照してください。

関連項目: 「テーマの編集」

ページCSSクラス

ページ・テンプレートに置換文字列#PAGE_CSS_CLASSES#が含まれている場合に置換されるスペースで区切られたリストとして、追加のCSSクラスを入力します。

関連項目: 「テーマの編集」

カーソル・フォーカス

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

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

- JavaScriptを含める場合は、「フォーカスなし」を選択します。このオプションを選択すると、生成済JavaScriptとカスタムJavaScript間の競合を回避できます。

メディア・タイプ

インターネット・メディア・タイプを入力します。インターネット・メディア・タイプは、2つの部分で構成される、インターネット上のファイル形式を表す識別子です。メディア・タイプは、少なくともタイプとサブタイプの2つの部分で構成され、オプションで1つ以上のパラメータを指定します。メディア・タイプは、ページ描画の際にHTTPヘッダーのContent-Typeで使用されます。ページ・レベルのメディア・タイプが、アプリケーション・レベルのメディア・タイプを上書きします。この属性のデフォルト値はNULLです。ページ・レベルとアプリケーション・レベルの両方でメディア・タイプの値がNULLの場合、メディア・タイプとしてtext/htmlが使用されます。

9.4.2.3 JavaScript

表9-6に、カレント・ページにJavaScriptを含めることができる属性を示します。

表9-6 JavaScript属性

属性

説明

ファイルURL

このページにロードするコードのJavaScriptのファイルURLを入力します。各URLを新しい行に記述する必要があります。ファイルの縮小バージョンを指定する場合、置換文字列#MIN#を使用して.minを、または#MIN_DIRECTORY#使用してminified/を通常ページ・ビューのファイルURLに含めたり、ページをデバッグ・モードで表示する場合は空の文字列を含めることができます。アプリケーションのバージョンをファイルURLに含める場合、置換文字列#APP_VERSION#にアクセスすることもできます。

例を表示するには、フィールドレベル・ヘルプを参照してください。

ファンクションおよびグローバル変数の宣言

このページで使用するコードのJavaScriptコード(ファンクション、グローバル変数の宣言など)を入力します。コードを複数のページで使用する場合は、そのコードを外部のJavaScriptファイルに追加して重複を避けることを検討してください。

ここに入力したコードによって、ページ・テンプレート内の#PAGE_JAVASCRIPT#置換文字列が置き換えられます。

注意: スクリプトの開始タグや閉じタグを含めないでください。JavaScriptコードのみ含めます。

ショートカットを参照するには、次の方法を使用します。

"SHORTCUTNAME"

ページ・ロード時に実行

ページがロードされたときに実行されるJavaScriptコードを入力します。このコードはOracle Application Expressによって生成されたJavaScriptコードの後に実行されます。

ここに入力したコードによって、ページ・テンプレート内の#GENERATED_JAVASCRIPT#置換文字列が置き換えられます。

注意: スクリプトの開始タグや閉じタグを追加せず、JavaScriptコードのみ追加します。

9.4.2.4 CSS

表9-7に、カレント・ページにカスケード・スタイルシート(CSS)ファイルを含めることができる属性を示します。

表9-7 CSS属性

属性

説明

ファイルURL

このページにロードされるカスケード・スタイルシート・ファイルURLを入力します。各URLを新しい行に記述する必要があります。ファイルの縮小バージョンを指定する場合、置換文字列#MIN#を使用して.minを、または#MIN_DIRECTORY#使用してminified/を通常ページ・ビューのファイルURLに含めたり、ページをデバッグ・モードで表示する場合は空の文字列を含めることができます。アプリケーションのバージョンをファイルＵＲＬに含める場合は、置換文字列#APP_VERSION#を使用することもできます。

ここに入力したファイルURLによって、ページ・テンプレート内の#PAGE_CSS#置換文字列が置き換えられます。

注意: リンクの開始タグや閉じタグを含める必要はありません。ファイルURLのみを含めてください

例を表示するには、フィールドレベル・ヘルプを参照してください。

インライン

このページに使用されるカスケード・スタイルシートのコードを入力します。コードが複数のページで使用されている場合、重複を避け、ブラウザで静的ファイルをキャッシュするため、外部ファイルに挿入することを検討してください。

ここに入力したコードによって、ページ・テンプレート内の#PAGE_CSS#置換文字列が置き換えられます。

注意: スクリプトの開始スタイル・タグや閉じスタイル・タグを含めないでください。カスケード・スタイルシート・コードのみを含めます。

例を表示するには、フィールドレベル・ヘルプを参照してください。

9.4.2.5 ダイアログ

表9-8に、ダイアログとして表示するページを定義する属性を示します。次の属性は、ページ・モードが「モーダル・ダイアログ」または「非モーダル・ダイアログ」に設定されている場合にのみ適用されます。

ヒント:
次の属性は、ページ・テンプレート・レベルで定義された同様の設定を上書きします。「ダイアログ」を参照してください。

表9-8 ページ属性: ダイアログ

属性

説明

幅

ダイアログの幅をピクセルまたはパーセント単位で入力します。この設定は、ページ・テンプレート・レベルで指定されたデフォルトのダイアログ幅を上書きします。

デスクトップ・ユーザー・インタフェースを使用しているページの場合、値は500などのピクセル単位で設定する必要があります。jQueryモバイル・スマートフォン・ユーザー・インタフェースを使用しているページの場合、値は80%などのパーセント単位で設定する必要があります。

ページ・テンプレートのダイアログ初期化コード内の置換文字列#DIALOG_WIDTH#は、このアイテムに入力した値で置換されます。

高さ

ダイアログの高さを500などのピクセル単位で入力します。

ページ・テンプレートのダイアログ初期化コード内の置換文字列#DIALOG_HEIGHT#は、このアイテムに入力した値で置換されます。

最大幅

ダイアログの最大幅をピクセル単位で入力します。この設定は、ページ・テンプレート・レベルで指定されたデフォルトのダイアログ最大幅を上書きします。

jQueryモバイル・スマートフォン・ユーザー・インタフェースを使用しているページの場合、最大幅は500です。ページ・テンプレートのダイアログ初期化コード内の置換文字列#DIALOG_MAX_WIDTH#は、このアイテムに入力した値で置換されます。

属性

Oracle Application Expressのダイアログ・サポートは、ページのユーザー・インタフェースによって異なり、jQuery UIダイアログはデスクトップ・ユーザー・インタフェースに使用され、jQuery Mobileダイアログ・ウィジェットはモバイル・ユーザー・インタフェースに使用されます。Oracle Application Expressでは、ダイアログ属性のサブセットとして、高さ、幅および最大幅がサポートされます。

ページ・テンプレート・レベルで定義されたダイアログ初期化コード内の置換文字列#DIALOG_ATTRIBUTES#は、このアイテムに入力された任意の値で置換されます。

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

CSSクラス

ダイアログに適用する追加のCSSクラスをスペース区切りリストとして入力します。次に例を示します。

ui-dialog--wizard

ページ・テンプレートに出現した置換文字列#DIALOG_CSS_CLASSES#は、このフィールドで指定した値で置換されます。この値はページ・テンプレート・レベルで設定された値を上書きします。

チェーン・ダイアログ

このダイアログが別のダイアログによって開かれ、同じダイアログ・ウィンドウを再利用する場合、「はい」を選択します。たとえば、このダイアログが複数ページ・ダイアログ・ウィザードの一部で、ウィザードの各ステップにダイアログ・ウィンドウを再利用する場合です。

このダイアログが別のダイアログによって開かれ、新規ダイアログ・ウィンドウで開かれる必要がある場合、「いいえ」を選択します。たとえば、このダイアログがモーダルで、親モーダル・ダイアログ・ウィンドウ内で開く場合です。

9.4.2.6 HTMLヘッダー

表9-9に、ページ・ヘッダーおよびページのHTML本文テキストを定義する属性を示します。

表9-9 HTMLヘッダー属性

属性

説明

HTMLヘッダー

ページ・テンプレート・ヘッダー内の#HEAD#置換文字列を置換するテキストを入力します。ここで入力する値は、HTML <HEAD>タグの後に挿入されます。このページ属性を使用して、ページ固有のメタ・タグを追加します。

注意: JavaScriptコードまたはカスケード・スタイルシートを専用のJavaScriptおよびCSS属性に追加する必要があります。

ページのHTMLボディ属性

ページ・テンプレートの#ONLOAD#置換文字列に置き換えられるテキストを入力します。この機能を使用するには、ページ・テンプレートに#ONLOAD#置換文字列が含まれている必要があります。

9.4.2.7 ヘッダーおよびフッター

表9-10に、ヘッダーおよびフッター・テキストを定義する属性を示します。

表9-10 ヘッダー・テキストおよびフッター・テキスト

属性

説明

ヘッダー・テキスト

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

フッター・テキスト

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

9.4.2.8 読取り専用

このページでページ・アイテムを読取り専用としてレンダリングするために必要な条件タイプをリストから選択します。条件を選択しない場合、ページ・アイテムが通常どおりにレンダリングされます。読取り専用条件は、「ヘッダーの前」のプロセス・ポイントを持つプロセスを実行した後に評価されます。

ヒント:
一部のページ・アイテム(検索フィールドなど)または特定のリージョンのすべてのページ・アイテムを、この条件の評価内容とは無関係に常に入力可能なページ・アイテムとしてレンダリングする場合は、これらのリージョンまたはページ・アイテムの読取り専用条件を「なし」に設定します。

9.4.2.9 セキュリティ

表9-11に、カレント・ページの認可スキームおよび認証要件を定義する属性を示します。

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

属性

説明

認可スキーム

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

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

関連項目: 「認可を介したセキュリティの提供」

認証

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

関連項目: 認証によるユーザー・アイデンティティの証明

ディープ・リンク

この属性を使用して、アプリケーション・ページのディープ・リンクを有効または無効にします。オプションは次のとおりです。

- 有効: 特定のページへのURLは、最終的にそのページにリダイレクトされます(場合によってはユーザーのログイン後)。

- 無効: URLに有効なセッションIDが含まれていない場合、Application Expressは新しいセッションを開始し、アプリケーションのホーム・ページにリダイレクトします。

- アプリケーション・デフォルト: アプリケーションレベルの設定が使用されます。

関連項目: 「認証」

ページ・アクセス保護

注意: この属性は、アプリケーションについて「セッション・ステート保護」が有効化されている場合のみ表示されます。「セッション・ステート保護の理解」を参照してください。

カレント・ページのページ・アクセス保護レベルを選択します。

- 制限なし: セッション・ステート引数(Request、Clear Cache、Name/Values)の有無にかかわらず、URLを使用してページを要求できます。

- 引数にチェックサムが必要: URLにRequest、Clear CacheまたはName/Value引数が表示されている場合は、チェックサムも提供する必要があります。チェックサム・タイプは、引数として渡されるすべてのアイテムの最も厳密なセッション・ステート保護属性と互換性がある必要があります。

- 引数使用不可: URLを使用してページを要求できますが、Request、Clear CacheまたはName/Value引数は許可されません。

- URLアクセスなし: URLを使用してページにアクセスできませんが、ページは、URLリダイレクトを行わない「ページにブランチ」ブランチ・タイプのターゲットにできます。

フォームのオートコンプリート

この属性を「オン」に設定してもページには影響はありません。この値を「オフ」に設定すると、FORMタグに次のHTMLが生成されます。

autocomplete="off"

ブラウザ・キャッシュ

注意: この機能には、HTTPヘッダー・レスポンス変数cache-controlをサポートする最新のブラウザが必要です。

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

- アプリケーション・デフォルト: 実行時の値はアプリケーションの「ブラウザ・キャッシュ」属性から取得されます。

- 有効: ブラウザはアプリケーションのページ・コンテンツを、メモリー内とディスク上の両方のキャッシュに保存します。ユーザーがブラウザの「戻る」ボタンを押すと、通常、ページはサーバーからではなくキャッシュからロードされます。

- 無効: ブラウザは、ページ・コンテンツおよびサーバーからのリクエスト・コンテンツを保存しません。ページ・コンテンツをメモリー内またはディスク上にキャッシュしないようにブラウザに指示するHTTPヘッダーcache-control: no-storeがOracle Application Expressにより送信されます。ブラウザのキャッシュを無効にすると、部分ページ・リフレッシュを使用するページ(対話モード・レポートを含むページなど)での「戻る」ボタンのわずかな問題も回避できます。

セキュリティの観点からおよびベスト・プラクティスとして、ブラウザのキャッシュを無効にしておくことをお薦めします。これにより、ブラウザに機密データが格納されないようにし、URLが変わる場合に常にページがリクエストされます。そうしない場合、ログアウト後にブラウザ履歴で前に戻り、以前のセッションのキャッシュされたコンテンツを表示できる可能性があります。

セッションを再結合

「セッションを再結合」属性は、Application ExpressがセッションIDを含まないアプリケーションURLをサポートするかどうかを制御します。セッションの再結合が有効で、URLにセッションIDが含まれていない場合、Application ExpressはセッションCookieを使用して既存のセッションを結合することを試みます。このページ・レベルの値は、より制限的なインスタンス・レベルの設定によってオーバーライドされます。

警告: セッションの再結合を有効にすると、攻撃者が既存のエンド・ユーザー・セッションを乗っ取ることが可能になるため、アプリケーションのセキュリティが侵害される可能性があります。詳細は、「「セッションを再結合」について」を参照してください。

「セッションを再結合」から、次のオプションを選択します。

- アプリケーション・デフォルト - アプリケーション・レベルで定義されている設定を継承します。「ブラウザ・セキュリティ」を参照してください。

- 無効 - URLにセッションIDが含まれていない場合、Application Expressは新しいセッションを作成します。

- パブリック・セッションに対して有効 - URLがパブリック・ページのもので、セッションIDが含まれていない場合、Application Expressはそのアプリケーションに対して確立された既存のセッションCookieの利用を試みます。パブリック・ページと認証済ページの両方を持つアプリケーションの場合、エンド・ユーザーの認証後にセッションIDが定義されます。Application Expressは、セッションがまだ認証されていない場合にのみCookieを使用して結合します。

- すべてのセッションに対して有効 - URLにセッションIDが含まれておらず、次の条件が満たされる場合、Application Expressはそのアプリケーションに対して確立された既存のセッションCookieの利用を試みます。
セッション・ステート保護がそのアプリケーションに対して有効で、URLに有効なチェックサムが含まれています。パブリック・ブックマークの場合、最も制限的なアイテム・レベルの保護は「制限なし」または「チェックサムが必要 - アプリケーション・レベル」である必要があります。

URLにペイロードは含まれていません(リクエスト・パラメータ、クリア・キャッシュまたはデータ値ペア)。

この設定では、アプリケーションの「フレームへの埋込み」が「同じ起点から許可」または「拒否」に設定されている必要もあります。

関連項目: 「ブラウザ・セキュリティ」、「「セッションを再結合」について」および『Oracle Application Express管理ガイド』のセッションの再結合に関する項

9.4.2.10 重複送信

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

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

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

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

「複製ページの送信時は、このURLに移動」で、URLを入力します。「複製ページの送信を許可」を「いいえ」に設定している場合はこのフィールドを使用します。「いいえ」を選択していて同一ページを2回発行すると、Oracle Application Expressはエラー・メッセージとユーザーが指定したURLへのリンクを表示します。

9.4.2.11 サーバー・キャッシュ

表9-12に、カレント・ページのキャッシュを有効にする属性を示します。

表9-12 ページ属性: サーバー・キャッシュ

属性

説明

キャッシュ・ページ

ページ・キャッシュを有効にするかどうかを指定します。ページ・キャッシュは、ページを動的に表示せずにキャッシュから表示するため、パフォーマンスが向上します。オプションは次のとおりです。

- 無効 - コンテンツはキャッシュされず、リクエストごとに計算されます。

- 有効 - コンテンツはキャッシュされ、すべてのユーザーによって利用されます。

- ユーザー別のキャッシュ - コンテンツはユーザーごとにキャッシュされます。

- セッション別のキャッシュ - コンテンツはセッションごとにキャッシュされます。

キャッシュ・タイムアウト

「有効」または「ユーザー別のキャッシュ」を選択するかどうかを表示します。キャッシュされたページが有効な時間を指定してください。

キャッシュ・ページ条件

条件を指定してください。条件がTrueを戻す場合、ページはキャッシュから表示されます。条件がFalseを戻す場合、ページは動的にレンダリングされ、キャッシュから取得されません。

式1

選択した「キャッシュ・ページ条件」に従って条件付きで表示されます。選択した特定の条件タイプに基づいて、この属性に値を入力してください。

式2

選択した「キャッシュ・ページ条件」に従って条件付きで表示されます。選択した特定の条件タイプに基づいて、この属性に値を入力してください。

関連項目:
『Oracle Application Express管理ガイド』のキャッシュされたリージョンおよびページの管理に関する項および「コンポーネント・ビューでのリージョン・キャッシュの使用」

9.4.2.12 構成

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

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

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

9.4.2.13 エラー処理

表9-13に、アプリケーションがエラーのログを記録する方法を制御または変更するために使用する属性を示します。

「インライン・エラー通知テキスト」で、ページでエラーが発生した場合に#NOTIFICATION_MESSAGE#テンプレート置換文字列に表示するエラー・テキストを入力します。

表9-13 ページ属性: エラー処理

属性

説明

インライン・エラー通知テキスト

ページでエラーが発生した場合に#NOTIFICATION_MESSAGE#テンプレート置換文字列に表示するエラー・テキストを入力します。

エラー処理ファンクション

既存のエラー・メッセージと表示位置を変更するか、エラーが発生した場合にそれをログに記録するための、PL/SQLエラー・ファンクションの名前を入力します。このファンクションは、データベース内のパッケージ・ファンクションまたはスタンドアロンのファンクションを参照できます。次に例を示します。

log_apex_error

データベースのPL/SQLパッケージまたはスタンドアロンのファンクションを参照する場合、#OWNER#置換文字列を使用して、カレント・アプリケーションの解析対象スキーマを参照します。次に例を示します。

#OWNER#.log_apex_error

apex_errorパッケージで説明されている構文を使用してエラー処理ファンクションを実装する必要があります。

function <name of function> (
p_error in apex_error.t_error )
return apex_error.t_error_result

関連項目: 『Oracle Application Express APIリファレンス』のapex_errorに関する説明

注意: アプリケーション・レベルで指定するエラー処理ファンクションは、ページ・レベルで指定されるエラー処理により上書きされます。「アプリケーション属性の編集」を参照してください。

関連項目:
「ページ・テンプレート」

9.4.2.14 ヘルプ

この属性を使用して、カレント・ページのヘルプ・テキストを入力します。ヘルプ・テキストは、ヘルプ・システムを使用して表示されます。このヘルプ・システムは開発する必要があります。

関連項目:
「アプリケーションのヘルプの作成」および「ショートカットの使用」

9.4.2.15 コメント

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

9.4.3 コンポーネント・ビューを使用したJavaScriptの組込み

JavaScriptをページのJavaScript属性に追加することによって、JavaScriptをアプリケーションに含めることができます。これは、ページに固有のファンクションに有効な方法であり、ファンクションを.jsファイルに組み込む前にテストを行う有効な方法です。

次の例では、コードを追加することによって、カレント・ページの任意の場所からtestファンクションにアクセスできるようにしています。

JavaScriptコードをJavaScript属性に追加するには、次のステップを実行します。

1. コンポーネント・ビューでページを表示します。「コンポーネント・ビューでのページの表示」を参照してください。

2. 「ページ」で、「すべて編集」アイコンをクリックします。

3. 「JavaScript」で、次の属性にコードを入力します。

ヒント:
属性の詳細は、フィールドレベル・ヘルプを参照してください。「フィールドレベル・ヘルプの表示」を参照してください。

- ファイルURL: このページにロードするコードのJavaScriptファイルURLを入力します。各URLを新しい行に記述する必要があります。ファイルの縮小バージョンを指定する場合、置換文字列#MIN#を使用して.minを、または#MIN_DIRECTORY#使用してminified/を通常ページ・ビューのファイルURLに含めたり、ページをデバッグ・モードで表示する場合は空の文字列を含めることができます。アプリケーションのバージョンをファイルURLに含める場合、置換文字列#APP_VERSION#にアクセスすることもできます。

- ファンクションおよびグローバル変数の宣言: 対象のページで使用するコード用のJavaScriptコード(たとえば、ファンクションまたはグローバル変数宣言)を入力します。コードを複数のページで使用する場合は、そのコードを外部のJavaScriptファイルに追加して重複を避けることを検討してください。

- ページ・ロード時に実行: ページのロード時に実行するJavaScriptコードを入力します。このコードはOracle Application Expressによって生成されたJavaScriptコードの後に実行されます。

たとえば、次のコードを追加すると、カレント・ページのすべての場所からアクセス可能なファンクションをテストします。

function test(){
alert('This is a test.');
}

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

9.4.4 コンポーネント・ビューでのセッションの再結合の構成

リージョンの再結合属性は、既存のセッションの結合(ディープ・リンクと同等)に対するサポートを制御します。技術的に、この属性は、このアプリケーションに対するURLにセッションIDを含むかどうかを決定します。

警告:
セッションの再結合を有効にすると、攻撃者が既存のエンド・ユーザー・セッションを乗っ取ることが可能になるため、アプリケーションのセキュリティが侵害される可能性があります。詳細は、「「セッションを再結合」について」を参照してください。

セッションの再結合を使用するには、管理者がインスタンス・レベルでセッションの再結合を有効化する必要があります。インスタンス・レベルでのセッションの再結合のより制限的な値は、アプリケーションおよびページ設定をオーバーライドします。

コンポーネント・ビューでセッションの再結合を構成するには、次のステップを実行します。

1. コンポーネント・ビューでページを表示します。「コンポーネント・ビューでのページの表示」を参照してください。

2. 「ページ」で、「すべて編集」アイコンをクリックします。

3. 「セキュリティ」までスクロールします。

4. 「セッションを再結合」から、次のオプションを選択します。

- 無効 - すべてのURLにセッションIDを含む必要があります。

- パブリック・セッションに対して有効 - ユーザーがまだログインしていない場合、パブリック・ページのURLにセッションIDを含む必要はありません。

- すべてのセッションに対して有効 - チェックサムで保護されている場合、またはペイロード(リクエスト・パラメータ、クリア・キャッシュまたはアイテム・データ)が含まれていない場合、URLにセッションIDを含む必要はありません。この設定では、アプリケーションの「フレームへの埋込み」属性が「同じ起点から許可」または「拒否」に設定されている必要もあります。

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

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

ヒント:
ダイアログ・ページの作成は、複数ステップのプロセスです。詳細は、「ダイアログ・ページの作成」を参照してください。

コンポーネント・ビューでダイアログ属性を構成するには、次のステップを実行します。

1. コンポーネント・ビューでページを表示します。「コンポーネント・ビューでのページの表示」を参照してください。

2. 「ページ」で、「すべて編集」アイコンをクリックします。

3. 「表示属性」で、ページ・モードが「モーダル」または「非モーダル」のいずれかになっていることを確認します。詳細は、フィールドレベル・ヘルプを参照してください。

4. 「ダイアログ」までスクロール・ダウンします。

5. 「ダイアログ」で、表9-14に示す属性を構成します。

表9-14 ページ属性: ダイアログ

属性

説明

幅

ダイアログの幅をピクセルまたはパーセント単位で入力します。この設定は、ページ・テンプレート・レベルで指定されたデフォルトのダイアログ幅を上書きします。

デスクトップ・ユーザー・インタフェースを使用しているページの場合、値は500などのピクセル単位で設定する必要があります。jQueryモバイル・スマートフォン・ユーザー・インタフェースを使用しているページの場合、値は80%などのパーセント単位で設定する必要があります。

ページ・テンプレートのダイアログ初期化コード内の置換文字列#DIALOG_WIDTH#は、このアイテムに入力した値で置換されます。

高さ

ダイアログの高さを500などのピクセル単位で入力します。

ページ・テンプレートのダイアログ初期化コード内の置換文字列#DIALOG_HEIGHT#は、このアイテムに入力した値で置換されます。

最大幅

ダイアログの最大幅をピクセル単位で入力します。この設定は、ページ・テンプレート・レベルで指定されたデフォルトのダイアログ最大幅を上書きします。

jQueryモバイル・スマートフォン・ユーザー・インタフェースを使用しているページの場合、最大幅は500です。ページ・テンプレートのダイアログ初期化コード内の置換文字列#DIALOG_MAX_WIDTH#は、このアイテムに入力した値で置換されます。

属性

Oracle Application Expressのダイアログ・サポートは、ページのユーザー・インタフェースによって異なり、jQuery UIダイアログはデスクトップ・ユーザー・インタフェースに使用され、jQuery Mobileダイアログ・ウィジェットはモバイル・ユーザー・インタフェースに使用されます。Oracle Application Expressでは、ダイアログ属性のサブセットとして、高さ、幅および最大幅がサポートされます。

ページ・テンプレート・レベルで定義されたダイアログ初期化コード内の置換文字列#DIALOG_ATTRIBUTES#は、このアイテムに入力された任意の値で置換されます。

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

CSSクラス

ダイアログに適用する追加のCSSクラスをスペース区切りリストとして入力します。次に例を示します。

ui-dialog--wizard

ページ・テンプレートに出現した置換文字列#DIALOG_CSS_CLASSES#は、このフィールドで指定した値で置換されます。この値はページ・テンプレート・レベルで設定された値を上書きします。

チェーン・ダイアログ

このダイアログが別のダイアログによって開かれ、同じダイアログ・ウィンドウを再利用する場合、「はい」を選択します。たとえば、このダイアログが複数ページ・ダイアログ・ウィザードの一部で、ウィザードの各ステップにダイアログ・ウィンドウを再利用する場合です。

このダイアログが別のダイアログによって開かれ、新規ダイアログ・ウィンドウで開かれる必要がある場合、「いいえ」を選択します。たとえば、このダイアログがモーダルで、親モーダル・ダイアログ・ウィンドウ内で開く場合です。

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

関連項目:
「ダイアログ・ページの作成」

9.5 コンポーネント・ビューでのアプリケーションまたはページの実行

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

コンポーネント・ビューでページを実行するには、次のステップを実行します。

1. コンポーネント・ビューでページを表示します。「コンポーネント・ビューでのページの表示」を参照してください。

2. ページを実行するには、右上隅の「ページの実行」ボタンをクリックします。

レンダリングされたアプリケーション・ページが表示されます。

関連項目:
「アプリケーションまたはページの実行」

9.6 実行時開発者ツールバー

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

開発環境内からデスクトップ・アプリケーションを実行すると、デフォルトではページの下部に実行時開発者ツールバーが表示されます。実行時開発者ツールバーを使用すると、カレント・アプリケーションへのアクセス、カレント・ページの編集、ページ、セッション・ステートの表示またはデバッグ・モードの切替えを簡単に行うことができます。実行時開発者ツールバーは、アプリケーション定義ページで、「可用性」、「ステータス」属性が「開発者ツールバーで使用可能」に設定されている場合にのみ表示されます。

注意:
実行時開発者ツールバーは、ロックされたパッケージ・アプリケーション・ページまたはjQuery Mobileスマートフォン・ページには表示されません。

実行時開発者ツールバーは、次のコントロールで構成されています。

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

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

- ページの編集: 現在実行中のページの定義を表示します。表示されるビューは、現在のプリファレンスによって異なります。「ページ・デザイナとコンポーネント・ビューの違いの理解」を参照してください。

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

- デバッグの表示: デバッグ・レポートを表示します。「アプリケーションのデバッグ」を参照してください。

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

- グリッドの表示: グリッド・レイアウトが使用され、かつそのレイアウトでグリッドの表示がサポートされ、ページに複数の列がある場合にのみ適用されます。

- クイック編集: 開発者は、「クイック編集」モードを開始し、必要なコンポーネントを選択して、ページ・デザイナでそのコンポーネントに即時にアクセスできます。クイック編集モードを終了するには、[Esc]を押すかコンポーネントの外側をクリックします。

- テーマ・ローラー: カラー・ピッカーから色を選択したり値を設定することで、アプリケーションの外観を簡単にカスタマイズできます。「テーマ・ローラー」をサポートしているテーマにのみ表示されます。「テーマ・スタイルの使用」を参照してください。

- 開発者ツールバー・オプション: 「テーマ・ローラー」の右側に表示され、次のコントロールを使用して開発者ツールバーの表示をカスタマイズできます。

- 自動非表示

- アイコンのみの表示

- 表示位置 (上、左、下、右)

9.7 コンポーネント・ビューでのデータベース・アプリケーション・ページのコピー

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

ページをコピーする手順は次のとおりです。

1. コンポーネント・ビューでページを表示します。「コンポーネント・ビューでのページの表示」を参照してください。

2. 「作成」をクリックしてから「コピーとしてのページ」をクリックします。

3. 「ページ・オプションのコピー」で、次のいずれかを選択します。

- このアプリケーションのページ

- 別のアプリケーションのページ

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

9.8 コンポーネント・ビューでのページの削除

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

- コンポーネント・ビューでのページの削除

- ページ属性の編集中にページの削除

- 複数のページの削除

- ページの範囲の削除

関連項目:
「ページのロックおよびロック解除」

9.8.1 コンポーネント・ビューでのページの削除

コンポーネント・ビューでページを削除するには、次のステップを実行します。

1. コンポーネント・ビューでページを表示します。「コンポーネント・ビューでのページの表示」を参照してください。

2. ページ番号を確認します。

3. コンポーネント・ビュー・ツールバーで、「ユーティリティ」をクリックしてから「ページの削除」をクリックします。

4. 「ページを完全に削除」をクリックします。

関連項目:
「コンポーネント・ビューの使用」

9.8.2 ページ属性の編集中にページの削除

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

1. ページ属性ページにアクセスします。「コンポーネント・ビューでのページ属性の表示」を参照してください。

2. ページ番号とページ名を確認します。

3. 「削除」をクリックします。

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

関連項目:
「コンポーネント・ビューの使用」

9.8.3 複数のページの削除

複数ページを削除するには、次のステップを実行します。

1. コンポーネント・ビューでページを表示します。「コンポーネント・ビューでのページの表示」を参照してください。

2. ページ番号を確認します。

3. コンポーネント・ビュー・ツールバーで、「ユーティリティ」、「クロス・ページ」および「複数のページの削除」をクリックします。

4. 削除するページを選択し、「ページの削除」をクリックします。

9.8.4 ページの範囲の削除

ページの範囲を削除するには、次のステップを実行します。

1. コンポーネント・ビューでページを表示します。「コンポーネント・ビューでのページの表示」を参照してください。

2. ページ番号を確認します。

3. コンポーネント・ビュー・ツールバーで、「ユーティリティ」、「クロス・ページ・ユーティリティ」および「複数のページの削除」をクリックします。

4. 「範囲別ページの削除」タブをクリックします。

5. 削除するページを入力し、「ページの削除」をクリックします。

10 レポートの開発

この項では、Oracle Application Expressでレポートを生成する方法について説明します。Oracle Application Expressでは、レポートとは、SQL問合せの結果の書式を設定したものです。データベース・アプリケーションでのレポートの生成は、組込み問合せを選択して実行するか、またはSQL問合せに基づくレポート・リージョンを定義して行うことができます。

- 対話モード・レポートとクラシック・レポートの相違点

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

- ギャラリからのドラッグ・アンド・ドロップによるレポートの作成

- ページ・デザイナでの対話モード・レポートの編集

- コンポーネント・ビューでの対話モード・レポートの編集

- エンド・ユーザーとしての対話モード・レポートのカスタマイズ

- ページ・デザイナでのクラシック・レポートの編集

- コンポーネント・ビューでのクラシック・レポートの編集

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

関連項目:
「フォームの開発」および「データベース・アプリケーション・コンポーネントの管理」

10.1 対話モード・レポートとクラシック・レポートの相違点

データベース・アプリケーションを作成する場合、2つのタイプのレポート(対話モード・レポートまたはクラシック・レポート)を含めることができます。これら2つのレポート・タイプの主な違いは、エンド・ユーザーが、検索、フィルタ処理、ソート、列選択、ハイライトなどのデータ操作を行うことで、データの表示をカスタマイズできる範囲です。

- 対話モード・レポート

- クラシック・レポート

10.1.1 対話モード・レポート

次に、対話モード・レポートの例を示します。

対話モード・レポートを作成するには、開発者はテーブルを選択するか、SQL文を指定します。開発者は、エンド・ユーザーが使用できる機能を制限できます(ダウンロードの無効化や列の非表示のサポートなど)。エンド・ユーザーがレポートを表示する場合、レポート機能はアプリケーションのすべてのレポートで同じです。

対話モード・レポートを表示する場合、エンド・ユーザーはデータの表示方法と対象をカスタマイズできます。デフォルトでは、対話モード・レポートには、検索バー、「アクション」メニュー、列ヘッダー・メニューおよび各行の最初の列の「編集」アイコンがあります。「アクション」メニューのオプションを使用して、ユーザーは、特定の列の非表示または表示、フィルタの適用、ハイライト処理、ソート処理などを行ってレポートのレイアウトを変更できます。また、ブレーク、集計、チャート、グループ化を定義し、ユーザー独自の計算を追加することもできます。カスタマイズしたレポートは、プライベートまたはパブリックいずれかのレポートとして保存できます。

対話モード・レポートを定義すると、次の操作が可能です。

- ページごとに複数の対話モード・レポートを含めることができます

- レポート列を使用して100列を表示できます。

- 列ヘッダー・フィルタごとに999行を含めることができます(列属性でカスタムLOVが指定されていない場合)

関連項目:
「エンド・ユーザーとしての対話モード・レポートのカスタマイズ」、「ページ・デザイナでのクラシック・レポートの編集」および「コンポーネント・ビューでの対話モード・レポートの編集」

10.1.2 クラシック・レポート

対照的に、クラシック・ポートは、ソートおよび単純なフィルタ処理を除いて、エンド・ユーザーがカスタマイズすることはできません。次に、同じデータで構築したクラシック・レポートの例を示します。

クラシック・レポートを作成するには、開発者はテーブルを選択するか、SQL文を指定します。クラシック・レポートでは、一般的なキーワード検索機能、表示する行数を指定する機能および基本的な列のソート機能をサポートしています。

クラシック・レポートを使用すると、レポート列を使用して100列を表示できます。

ヒント:
開発者は、レポート・テンプレート(特に、名前付き列テンプレート)を使用して、高度にカスタマイズされたレポートを作成できます。「レポート・テンプレート」を参照してください。

関連項目:
「ページ・デザイナでのクラシック・レポートの編集」、「コンポーネント・ビューでのクラシック・レポートの編集」

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

アプリケーション・ビルダーには、レポートを生成できる多くの組込みウィザードが用意されています。この項では、アプリケーションの作成ウィザード、ページの作成ウィザードおよびリージョンの作成ウィザードを使用する場合のレポート・オプションの概要を示します。使用可能なレポート・オプションは、選択したユーザー・インタフェース(デスクトップ、jQuery Mobileスマートフォンなど)によって異なります。

- アプリケーションの作成ウィザードのレポート・オプション

- ページの作成ウィザードのレポート・オプション

- リージョンの作成ウィザードのレポート・オプション

- アプリケーションの作成ウィザードを使用したレポートの作成

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

- ページ・デザイナでのウィザードを使用したレポートの作成

ヒント:
ウィザードには、表を選択するものもあれば、SQL問合せを指定するものもあります。SQL問合せの記述が不明な場合は、「クエリー・ビルダー」ボタンをクリックします。『Oracle Application Express SQLワークショップ・ガイド』のクエリー・ビルダーを使用したSQL問合せの構築に関する項を参照してください。

関連項目:
「ページ・デザイナでのウィザードを使用したレポートの作成」、「アプリケーションのユーザー・インタフェースの管理」および「コンポーネント・ビューでのリージョンの作成」

10.2.1 アプリケーションの作成ウィザードのレポート・オプション

表10-1に、アプリケーションの作成ウィザードを使用する場合に使用可能なレポート・オプションを示します。

表10-1 アプリケーションの作成ウィザード - 使用可能なレポート・タイプ

ページ・タイプ

説明

デスクトップ

jQuery Mobileスマートフォン

列切替えレポート

モバイル・アプリケーションのレスポンシブなレポートを作成します。デフォルトでは、列切替えレポートはすべての列が同じ優先度に設定されて作成されます。ただし、開発者はレポート列属性を編集し、重要度に応じて列をランク付けできます。優先度がより低い列は、より狭い幅で表示されます(たとえば、優先度6の列は最初に非表示になり、優先度1の列は最後に非表示になります。)レポートには、エンド・ユーザーが表示する列を選択できる「列」ボタンが含まれています。

注意: デスクトップ・アプリケーションは、このレポート書式をサポートしません。

使用不可

使用可能

リスト・ビュー

モバイル・アプリケーションのリストにSQL問合せの結果を表示します。

注意: デスクトップ・アプリケーションは、このレポート書式をサポートしません。

使用不可

使用可能

リスト・ビューとフォーム

スマートフォンでデータの表示とナビゲーション用に最適化されます。

2ページのリスト・ビューとフォームの組合せを構築します。1ページ目では、「リスト・ビュー」から更新する行を選択します。2ページ目では、ユーザーは選択した表またはビューを更新できます。

注意: デスクトップ・アプリケーションは、このレポート書式をサポートしません。

使用不可

使用可能

リフロー・レポート

モバイル・アプリケーションのレスポンシブなレポートを作成します。レポートを水平に表示できる十分な領域がない場合、レポートは、表の列を縮小して、各行に対するラベルやデータ・ペアのブロックのような外観の積上げ表示形式にすることによって機能します。

注意: デスクトップ・アプリケーションは、このレポート書式をサポートしません。

使用不可

使用可能

レポート

SQL問合せの書式設定された結果を含むページを作成します。レポートを作成する表を選択するか、カスタムSQL SELECT文またはSQL SELECT文を戻すPL/SQLファンクションを指定する表を選択します。その後、レポート実装(「対話モード」または「クラシック」)を選択します。

注意: jQuery Mobileスマートフォンは、クラシック・レポートのみをサポートします。

使用可能

使用不可

レポートとフォーム

2ページのレポートとフォームの組合せを作成する表を選択します。その後、レポート実装(「対話モード」または「クラシック」)を選択します。1ページ目では、更新する行を選択します。2ページ目では、レコードを追加するか、あるいは既存のレコードの更新または削除を行うことができます。

使用可能

使用不可

関連項目:
「アプリケーションの作成ウィザードを使用したレポートの作成」

10.2.2 ページの作成ウィザードのレポート・オプション

表10-2に、ページの作成ウィザードを使用する場合のレポート・オプションを示します。

表10-2 ページの作成ウィザード - 使用可能なレポート・オプション

ページ・タイプ

説明

デスクトップ

jQuery Mobileスマートフォン

クラシック・レポート

SQL問合せの結果がフォーマット化されます。レポートを作成する表を選択するか、カスタムSQL SELECT文またはSQL SELECT文を戻すPL/SQLファンクションを指定することができます。SQL問合せの記述が不明な場合は、「クエリー・ビルダー」ボタンをクリックします。

関連項目: 「対話モード・レポートとクラシック・レポートの相違点」および「コンポーネント・ビューでのクラシック・レポートの編集」

使用可能

使用可能

列切替えレポート

モバイル・アプリケーションのレスポンシブなレポートを作成します。デフォルトでは、列切替えレポートはすべての列が同じ優先度に設定されて作成されます。ただし、開発者はレポート列属性を編集し、重要度に応じて列をランク付けできます。優先度がより低い列は、より狭い幅で表示されます(たとえば、優先度6の列は最初に非表示になり、優先度1の列は最後に非表示になります。)レポートには、エンド・ユーザーが表示する列を選択できる「列」ボタンが含まれています。

注意: デスクトップ・アプリケーションは、このレポート書式をサポートしません。

使用不可

使用可能

対話モード・レポート

SQL問合せの結果がフォーマット化されます。指定するカスタムSQL SELECT文に基づいた対話モード・レポートを作成します。SQL問合せの記述が不明な場合は、「クエリー・ビルダー」ボタンをクリックします。対話モード・レポートは、デスクトップ・ページでのみサポートされます。エンド・ユーザーは、「アクション」メニューのオプションを選択することによって、レポートのレイアウトと表示されるデータをカスタマイズできます。

注意: jQuery Mobileスマートフォンは、対話モード・レポートをサポートしません。

関連項目:「対話モード・レポートとクラシック・レポートの相違点」、「エンド・ユーザーとしての対話モード・レポートのカスタマイズ」および「コンポーネント・ビューでの対話モード・レポートの編集」

使用可能

使用不可

リスト・ビュー

リスト・ビューは、スマートフォンでのデータ表示およびナビゲーション用に最適化されています。

SQL問合せの書式設定された結果を含むページを作成します。リスト・ビューを作成する表を選択したり、リスト・ビュー・エントリに使用するデータベース列を選択します。

注意: デスクトップ・アプリケーションは、このレポート書式をサポートしません。

使用不可

使用可能

リフロー・レポート

モバイル・アプリケーションのレスポンシブなレポートを作成します。レポートを水平に表示できる十分な領域がない場合、レポートは、表の列を縮小して、各行に対するラベルやデータ・ペアのブロックのような外観の積上げ表示形式にすることによって機能します。

注意: デスクトップ・アプリケーションは、このレポート書式をサポートしません。

使用不可

使用可能

Webサービスのレポート

Webサービスの結果でレポートを作成します。

関連項目: 「Webサービスの実装」

使用可能

使用可能

関連項目:
「ページの作成ウィザードを使用したレポートの作成」

10.2.3 リージョンの作成ウィザードのレポート・オプション

表10-3に、リージョンの作成ウィザードを使用する場合のレポート・オプションを示します。

表10-3 リージョンの作成ウィザードのレポート・オプション

ページ・タイプ

説明

デスクトップ

jQuery Mobileスマートフォン

対話モード・レポート

SQL問合せの結果がフォーマット化されます。カスタムSQL SELECT文またはSQL問合せ文を戻すPL/SQLファンクションを指定します。

注意: jQuery Mobileスマートフォンは、対話モード・レポートをサポートしません。

関連項目: 「エンド・ユーザーとしての対話モード・レポートのカスタマイズ」、「ページ・デザイナでの対話モード・レポートの編集」および「コンポーネント・ビューでの対話モード・レポートの編集」

使用可能

使用不可

リフロー・レポート

モバイル・アプリケーションのレスポンシブなレポートを作成します。レポートを水平に表示できる十分な領域がない場合、レポートは、表の列を縮小して、各行に対するラベルやデータ・ペアのブロックのような外観の積上げ表示形式にすることによって機能します。

注意: デスクトップ・アプリケーションは、このレポート書式をサポートしません。

関連項目: 「レポートの開発」

使用不可

使用可能

列切替えレポート

モバイル・アプリケーションのレスポンシブなレポートを作成します。デフォルトでは、列切替えレポートはすべての列が同じ優先度に設定されて作成されます。ただし、開発者はレポート列属性を編集し、重要度に応じて列をランク付けできます。優先度がより低い列は、より狭い幅で表示されます(たとえば、優先度6の列は最初に非表示になり、優先度1の列は最後に非表示になります。)レポートには、エンド・ユーザーが表示する列を選択できる「列」ボタンが含まれています。

注意: デスクトップ・アプリケーションは、このレポート書式をサポートしません。

使用不可

使用可能

クラシック・レポート

SQL問合せの結果がフォーマット化されます。カスタムSQL SELECT文またはSQL問合せを戻すPL/SQLファンクションを指定します。

関連項目: 「ページ・デザイナでのクラシック・レポートの編集」および「コンポーネント・ビューでのクラシック・レポートの編集」

使用可能

使用不可

リスト・ビュー

リスト・ビューは、スマートフォンでのデータ表示およびナビゲーション用に最適化されています。

SQL問合せの書式設定された結果を含むページを作成します。カスタムSQL SELECT文またはSQL問合せを戻すPL/SQLファンクションを指定します。

注意: デスクトップ・アプリケーションは、このレポート書式をサポートしません。

使用不可

使用可能

Webサービスのレポート

Webサービスの結果でレポートを作成します。

関連項目: 「Webサービスの実装」

使用可能

使用可能

関連項目:
「リージョンについて」

10.2.4 アプリケーションの作成ウィザードを使用したレポートの作成

アプリケーションの作成ウィザードを実行すると、1つまたは複数のレポート・ページを含む新しいアプリケーションを作成できます。

アプリケーションの作成ウィザードを使用してレポートを作成するには、次のステップを実行します。

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

2. 「作成」ボタンをクリックします。

3. アプリケーション・タイプで「デスクトップ」を選択し、「次へ」をクリックします。

4. 「名前」で、次のステップを実行します。

1. スキーマ: アプリケーションは、すべてのSQLを特定のデータベース・スキーマとして解析することで、権限を取得します。データベース・スキーマ所有者を指定します。

2. 名前: アプリケーションを識別するための名前を入力します。

3. アプリケーション: アプリケーションを識別するための一意の整数値を入力します。3000から9000の範囲のアプリケーションIDは、Oracle Application Expressの内部使用向けに予約されています。

4. ユーザー・インタフェース: アプリケーションのユーザー・インタフェースを選択します。主としてデスクトップで使用するために設計するアプリケーションの場合は、「デスクトップ」を選択します。

5. テーマ: このアプリケーションのテーマを選択します。
テーマは、アプリケーション全体のレイアウトおよびスタイルの定義に使用できるテンプレートのコレクションです。「テーマの使用」を参照してください。

6. テーマ・スタイル: テーマ・スタイルを選択します。
テーマ・スタイルは、ユニバーサル・テーマ - 42やモバイル - 51などのより新しいアプリケーションにのみ使用できます。「テーマ・スタイルの使用」を参照してください。

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

ヒント:
この時点で、ログイン・ページと空白ページのみで構成されるアプリケーションを作成するには、「アプリケーションの作成」をクリックします。

次に、ページをアプリケーションに追加します。

5. 「ページの追加」ボタンをクリックします。「ページの追加」で、次のステップを実行します。

1. ページ・タイプの選択 - ページ・タイプを選択します。「アプリケーションの作成ウィザード - 使用可能なレポート・タイプ」を参照してください。

ヒント:
ページ・タイプによって、追加属性を表示するかどうかが決まります。属性の詳細は、フィールドレベル・ヘルプを参照してください。「フィールドレベル・ヘルプの表示」を参照してください。

2. 親ページ - このページが別のページに従属している場合は、親ページを選択します。

3. ページ名 - このページの名前を指定します。

4. 「ページの追加」をクリックします。

6. さらにページを追加するには、前のステップを繰り返します。

7. ページの追加が完了したら、「次へ」をクリックします。

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

関連項目:
「データベース・アプリケーションの作成」

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

ページの作成ウィザードを実行すると、レポートを含む新しいページを既存のアプリケーションに追加できます。

ページの作成ウィザードを使用してレポートを作成するには、次のステップを実行します。

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

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

3. 「ページの作成」をクリックして、「次へ」をクリックします。

4. 「ページの作成」で、次のステップを実行します。

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

2. ページ・タイプの選択: 「レポート」を選択します。

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

5. レポート・タイプを選択し、「次へ」をクリックします。「ページの作成ウィザード - 使用可能なレポート・オプション」を参照してください。
表示されるレポート・オプションは、アプリケーション・ユーザー・インタフェース(デスクトップ、jQuery Mobileスマートフォンなど)によって異なります。

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

7. 画面に表示されるステップに従います。
属性の詳細は、フィールドレベル・ヘルプを参照してください。「フィールドレベル・ヘルプの表示」を参照してください。

ヒント:
この項では、アプリケーションのホームページからページの作成ウィザードを実行することによってレポートを作成する方法を説明しています。「作成」メニューをクリックして「ページ」を選択することによって、ページ・デザイナおよびコンポーネント・ビューでこのウィザードを実行することもできます。

関連項目:
「データベース・アプリケーションのページの管理」

10.2.6 ページ・デザイナでのウィザードを使用したレポートの作成

ページ・デザイナでページに新しいレポートを宣言的に追加するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。「ページ・デザイナでのページの表示」を参照してください。

2. ページ上部のページ・デザイナ・ツールバーに移動します。

3. ページ・デザイナ・ツールバーで、「作成」メニューをクリックしてレポート・リージョンの作成を選択します。
「リージョンの作成」ウィザードが表示されます。

4. 作成するレポート・タイプを選択して、「次へ」をクリックします。レポート・オプションの詳細は、「リージョンの作成ウィザードのレポート・オプション」を参照してください。

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

10.3 ギャラリからのドラッグ・アンド・ドロップによるレポートの作成

ギャラリからドラッグ・アンド・ドロップでレポートを追加するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。「ページ・デザイナでのページの表示」を参照してください。
ページ・デザイナが表示されます。

2. グリッド・レイアウト下部にギャラリがあります。
ギャラリに、ページに追加できるコントロールまたはコンポーネントのタイプが一覧表示されます。カーソルをコントロールまたはコンポーネントにあわせると、説明するツールチップが表示されます。

3. ギャラリからレポート・リージョンを選択して、グリッド・レイアウトの適切な場所にドラッグします。

4. 追加するコンポーネント・タイプに基づいて、ページ・デザイナが次に必要な操作を示します。

ヒント:
コンポーネントは、コンポーネント・タイプで決定されたとおり、適切なドロップ・ゾーンにのみドロップできます。既存のコンポーネントの横に新しいコンポーネントを配置する場合は、新しいコンポーネントを右にドラッグし、既存のコンポーネントと同じ高さに並べて、新しいドロップ・ゾーンが表示されるまで少し待ちます。

「メッセージ」タブに、対処する必要があるメッセージの数を示した赤または黄色のバッジが表示されます。エラー・メッセージは赤で表示され、警告メッセージは黄色で表示されます。エラー・メッセージを選択すると、プロパティ・エディタの関連する属性がハイライトされます。ページを保存する前にエラーに対処する必要があります。

次に、SQL文が必要であることを示すエラー・メッセージが表示された新しい対話モード・レポート・リージョンの例を示します。

5. プロパティ・エディタで該当する属性を編集します。
必要な属性は、属性ラベルの1つ上の左上隅に赤い三角形で表示されます。

6. 変更を保存するには、「保存」をクリックします。ページを保存して実行するには、「ページの保存と実行」をクリックします。

10.4 ページ・デザイナでの対話モード・レポートの編集

デフォルトでは、対話モード・レポートの各行の最初の列には、検索バー、「アクション」メニュー、「列ヘッダー」メニューおよび「編集」アイコンがあります。ユーザーは、これらのコントロールを使用して、列の選択、フィルタの適用、ハイライトおよびソートを実行し、レポート・データのレイアウトを変更できます。この項では、ページ・デザイナで対話モード・レポートをカスタマイズして、これらのコントロールの表示を構成する方法について説明します。

- ページ・デザイナでのリージョン属性の編集

- ページ・デザイナでの列属性の編集

- ページ・デザイナでの対話モード・レポート属性の編集

- ページ・デザイナでの対話モード・レポート・ページ区切りの制御

- 対話モード・レポートの検索バーのカスタマイズ

- ページ・デザイナでの「アクション」メニューのカスタマイズ

- ページ・デザイナでのリンク列の管理

- 対話モード・レポートでの列 リンクの作成

- 対話モード・レポートの条件付き表示

- 対話モード・レポートでのLOVとしての列定義

- 対話モード・レポートでの列の書式設定

- ページ・デザイナでのアイコン・ビューの有効化

- ページ・デザイナでの詳細ビューの有効化

- 対話モード・レポートの詳細属性の構成

- 対話モード・レポートへのリンクの設定

- 共有対話モード・レポートへのリンクの設定

関連項目:
「ページ・デザイナでのページの管理」、「エンド・ユーザーとしての対話モード・レポートのカスタマイズ」および『Oracle Application Express APIリファレンス』のAPEX_IRに関する項

10.4.1 ページ・デザイナでのリージョン属性の編集

ページ・デザイナでリージョン・属性を編集するには、次のステップを実行します。

1. ページ・デザイナでリージョンを含むページを表示します。「ページ・デザイナでのページの表示」を参照してください。
ページ・デザイナが表示されます。

2. 「レンダリング」ツリーで、リージョンを選択します。
プロパティ・エディタの右の列にリージョン属性が表示されます。

属性は、機能グループに編成されます。必要な属性は、属性ラベルの1つ上の左上隅に赤い三角形で表示されます。

3. 対象となる属性を編集します。
詳細は、フィールドレベル・ヘルプを参照してください。

ヒント:
表示する情報の量を制御するには、「共通の表示」、「すべて表示」、「すべて閉じる」および「すべて開く」ボタンをクリックします。

4. 変更を保存するには、「保存」をクリックします。ページを保存して実行するには、「ページの保存と実行」をクリックします。

関連項目:
「プロパティ・エディタ」

10.4.2 ページ・デザイナでの列属性の編集

列属性を編集して、レポート・レイアウトを詳細に制御できます。たとえば、これらの属性を使用して、列ヘッダーの変更、列の位置の変更、列の非表示化またはユーザーが列を操作できる方法の制御を行うことができます。

列属性にアクセスするには、次のステップを実行します。

1. ページ・デザイナでページを表示します。「ページ・デザイナでのページの表示」を参照してください。
ページ・デザイナが表示されます。

2. 「レンダリング」ツリーで、リージョンを見つけて「列」ノードを展開します。
「レンダリング」ツリーに列が表示されます。

3. 編集する列を選択します
プロパティ・エディタにその列の属性が表示されます。

4. 対象となる属性を編集します。
詳細は、フィールドレベル・ヘルプを参照してください。

ヒント:
表示する情報の量を制御するには、「共通の表示」、「すべて表示」、「すべて閉じる」および「すべて開く」ボタンをクリックします。

5. 列ヘッダーを編集するには、次のステップを実行します。

1. 「ヘッダー」を見つけて展開します。

2. 「ヘッダー」属性と「位置合せ」属性を編集します。

6. ユーザーが列を操作する方法を制御するには、次のステップを実行します。

1. 「ユーザーの有効化」を見つけて展開します。

2. 「ユーザーの有効化」で、「はい」または「いいえ」を選択して、ユーザーがレポートを操作する方法を制御します。

7. 変更を保存するには、「保存」をクリックします。ページを保存して実行するには、「ページの保存と実行」をクリックします。

関連項目:
「プロパティ・エディタ」

10.4.3 ページ・デザイナでの対話モード・レポート属性の編集

レポート属性を編集して、レポート機能を詳細に制御できます。たとえば、これらの属性を使用して、ページ区切りの構成、エラー・メッセージの作成、検索バー、「アクション」メニューおよびダウンロード・オプションの構成、ユーザーがレポートを保存するかどうかとその方法の制御、サポートされるビューの構成を行うことができます。

ページ・デザイナでレポート属性を編集するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。「ページ・デザイナでのページの表示」を参照してください。
ページ・デザイナが表示されます。

2. 「レンダリング」ツリーで、レポートを含むリージョンを探します。

3. 「リージョン」で、「属性」ノードを選択します。
プロパティ・エディタに、プロパティ・エディタのレポート属性が表示されます。

4. 対象となる属性を編集します。
詳細は、フィールドレベル・ヘルプを参照してください。

ヒント:
表示する情報の量を制御するには、「共通の表示」、「すべて表示」、「すべて閉じる」および「すべて開く」ボタンをクリックします。

5. 変更を保存するには、「保存」をクリックします。ページを保存して実行するには、「ページの保存と実行」をクリックします。

関連項目:
「プロパティ・エディタ」

10.4.4 ページ・デザイナでの対話モード・レポート・ページ区切りの制御

ページ区切りによって、結果セット内の行数および現在の位置に関する情報が提供されます。プロパティ・エディタの属性ページの「ページ区切り」属性から選択することによって、ページ区切りの表示方法を制御します。

対話モード・レポートのページ区切りを編集するには、次のステップを実行します。

1. レポートの属性を表示します。「ページ・デザイナでの対話モード・レポート属性の編集」を参照してください。
属性がプロパティ・エディタに表示されます。

2. 「ページ区切り」属性を構成します。

1. 「ページ区切り」を見つけて展開します。

2. タイプ - このレポートのページ区切りタイプを選択します。多くの場合、ページには、レポートの特定数の行のみが表示されます。それ以上の行を表示するには、アプリケーション・エンド・ユーザーはレポートの次のページにナビゲートする必要があります。

3. 表示位置 - レポートのページ区切りの表示位置を選択します。
ページ区切りを表示できるのは、レポートの上または下(あるいは両方)で、位置は左または右に設定できます。

3. 変更を保存するには、「保存」をクリックします。ページを保存して実行するには、「ページの保存と実行」をクリックします。

ヒント:
問い合せる行の数は、パフォーマンスに影響する可能性があります。より少ない行を問い合せるとパフォーマンスが向上し、数千という行を問い合せるとパフォーマンスが低下します。「詳細」で「行カウント最大値」属性を編集することによって、問い合せる行の最大数を制御できます。

10.4.5 対話モード・レポートの検索バーのカスタマイズ

この項では、対話モード・レポートの検索バーをカスタマイズする方法について説明します。

- 対話モード・レポートの検索バーおよび「アクション」メニュー

- ページ・デザイナでの検索バーのカスタマイズ

- ページ・デザイナでの検索バーの削除

関連項目:
「コンポーネント・ビューでのアイコン・ビューの有効化」および「コンポーネント・ビューでの詳細ビューの有効化」

10.4.5.1 対話モード・レポートの検索バー

すべての対話モード・レポートのページ上部には検索バーがあり、そこに、「検索列の選択」アイコン、テキスト領域、「実行」ボタンおよび「アクション」メニューの各コントロールが含まれています。

プロパティ・エディタでレポート属性を構成することによって、検索バーを削除したりカスタマイズすることができます。

10.4.5.2 ページ・デザイナでの検索バーのカスタマイズ

検索バーをカスタマイズするには、次のステップを実行します。

1. レポートの属性を表示します。「ページ・デザイナでの対話モード・レポート属性の編集」を参照してください。
「属性」がプロパティ・エディタに表示されます。

2. 「検索バー」を見つけて展開します。

3. 「検索バー」の下のオプションを構成します。属性の詳細は、属性を選択して「ヘルプ」タブをクリックします。
表10-4に、「検索バー」属性を示します。

表10-4 プロパティ・エディタの「検索バー」属性

属性

説明

検索バーを含める

「はい」または「いいえ」を選択します。「いいえ」を選択すると検索バーが削除されます。

検索フィールド

検索条件を入力するためのテキスト・フィールドが検索バーに表示されます。「はい」または「いいえ」を選択します。

ファインダ・ドロップ・ダウン

選択した1列またはすべての列に対してユーザーが検索できるようにします。「はい」または「いいえ」を選択します。対話モード・レポート内では、このオプションは「検索列の選択」として識別されます。

レポート選択リスト

レポートに代替デフォルト、共有レポートまたはパーソナル・レポートが含まれている場合に、レポート選択リストを表示します。「はい」または「いいえ」を選択します。

関連項目: 「対話モード・レポートの保存」。

ページごとの行数セレクタ

独立したドロップ・ダウン行セレクタを検索バーに含めるかどうかを指定します。「はい」または「いいえ」を選択します。

関連項目: 「対話モード・レポートの保存」。

検索ボタン・ラベル

検索ボタン・ラベルとして使用するテキストを指定します。

最大行数/ページ

「ページごとの行数セレクタ」に表示する最大数を入力します。

4. 変更を保存するには、「保存」をクリックします。ページを保存して実行するには、「ページの保存と実行」をクリックします。

10.4.5.3 ページ・デザイナでの検索バーの削除

対話モード・レポートから検索バーを削除するには、次のステップを実行します。

1. レポートの属性を表示します。「ページ・デザイナでの対話モード・レポート属性の編集」を参照してください。
属性ページがプロパティ・エディタに表示されます。

2. 「検索バー」を見つけて展開します。

3. 「検索バーを含める」で、「いいえ」を選択します。

4. 変更を保存するには、「保存」をクリックします。ページを保存して実行するには、「ページの保存と実行」をクリックします。

10.4.6 ページ・デザイナでの「アクション」メニューのカスタマイズ

この項では、対話モード・レポートの「アクション」メニューをカスタマイズする方法について説明します。

- 対話モード・レポートの「アクション」メニュー

- ページ・デザイナでの「アクション」メニューのカスタマイズ

- ページ・デザイナでの「アクション」メニューのダウンロード・オプションの構成

10.4.6.1 対話モード・レポートの「アクション」メニュー

「アクション」メニューは、検索バーの「実行」ボタンの右に表示されます。このメニューを使用して、対話モード・レポートをカスタマイズできます。

プロパティ・エディタでレポート属性を構成することによって、「アクション」メニューを削除したりカスタマイズすることができます。

関連項目:
「「アクション」メニューについて」

10.4.6.2 ページ・デザイナでの「アクション」メニューのカスタマイズ

「アクション」メニューをカスタマイズするには、次のステップを実行します。

1. レポートの属性を表示します。「ページ・デザイナでの対話モード・レポート属性の編集」を参照してください。
属性ページがプロパティ・エディタに表示されます。

2. 「アクション・メニュー」を見つけて展開します。

3. 「はい」または「いいえ」を選択することによって、「アクション・メニュー」の下のオプションを構成します。

ヒント:
ヘルプを表示するには、属性を選択して「ヘルプ」タブをクリックします。「ヘルプ」ペインをアクティブ化すると、別の属性を選択するたびに表示されるコンテンツが変わります。

4. 変更を保存するには、「保存」をクリックします。ページを保存して実行するには、「ページの保存と実行」をクリックします。

10.4.6.3 ページ・デザイナでの「アクション」メニューのダウンロード・オプションの構成

「アクション」メニューに「ダウンロード」オプションを構成すると、ユーザーが対話モード・レポートをカンマ区切りファイル(CSV)形式、HTML、Microsoft Excel (XLS)形式、Adobe Portable Document Format (PDF)、Microsoft Wordリッチ・テキスト形式(RTF)、または電子メール添付のHTMLとしてダウンロードできます。

- ダウンロード形式の有効化

- CSVダウンロードの有効化

- 電子メール・ダウンロードの有効化

10.4.6.3.1 ダウンロード形式の有効化

ダウンロード形式を構成するには、次のステップを実行します。

1. レポートの属性を表示します。「ページ・デザイナでの対話モード・レポート属性の編集」を参照してください。
属性ページがプロパティ・エディタに表示されます。

2. プロパティ・エディタですべての属性を表示します。「すべて表示」ボタンをクリックします。

3. 次の属性を編集します。
詳細は、フィールドレベル・ヘルプを参照してください。

1. 検索バー、検索バーを含める - 「はい」を選択します。

2. アクション・メニュー、ダウンロード - 「はい」を選択します。

ヒント:
「ダウンロード」で「いいえ」を選択すると、「アクション」メニューに「ダウンロード」メニューが表示されなくなります。ユーザーがデータを完全にダウンロードできなくするには、次のステップで説明するすべてのダウンロード形式の選択を解除します。

3. ダウンロード、ダウンロード形式 - ダウンロード形式を選択します。

- CSV。「CSVダウンロードの有効化」を参照してください。

- HTML。

- 電子メール。「電子メール・ダウンロードの有効化」を参照してください。

- XLS。

- PDF。「PDFへのレポート出力について」を参照してください。

- RTF。

ヒント:
「アクション」メニューに「ダウンロード」オプションが表示されるのは、ファイル形式を選択した場合のみです。「インスタンス管理」内でレポート・サーバーが定義されていない場合は、特定のオプションが表示されません。詳細は、『Oracle Application Express管理ガイド』のレポート出力の構成に関する説明を参照してください。

4. 変更を保存するには、「保存」をクリックします。ページを保存して実行するには、「ページの保存と実行」をクリックします。

10.4.6.3.2 CSVダウンロードの有効化

CSVダウンロードを有効にするには、次のステップを実行します。

1. グローバリゼーション属性の編集ページで「CSV出力」オプションを有効にします。「グローバリゼーション属性のページへのアクセス」および「自動CSVエンコーディング」を参照してください。

2. ページ・デザイナでページを表示します。「ページ・デザイナでのページの表示」を参照してください。
ページ・デザイナが表示されます。

3. レポートの属性を表示します。「ページ・デザイナでの対話モード・レポート属性の編集」を参照してください。
属性ページがプロパティ・エディタに表示されます。

4. プロパティ・エディタですべての属性を表示します。「すべて表示」ボタンをクリックします。

5. 次の属性を編集します。
詳細は、フィールドレベル・ヘルプを参照してください。

1. 検索バー、検索バーを含める - 「はい」を選択します。

2. アクション・メニュー、ダウンロード - 「はい」を選択します。

ヒント:
「ダウンロード」で「いいえ」を選択すると、「アクション」メニューに「ダウンロード」メニューが表示されなくなります。ユーザーがデータを完全にダウンロードできなくするには、次のステップで説明するすべてのダウンロード形式の選択を解除します。

3. ダウンロード、ダウンロード形式:

1. ダウンロード形式 - 「CSV」を選択します。

ヒント:
「アクション」メニューに「ダウンロード」オプションが表示されるのは、ファイル形式を選択した場合のみです。

2. CSVセパレータ - 列セパレータを定義します。値が入力されていない場合は、現行のNLS設定に応じて、カンマまたはセミコロンが使用されます。

3. CSV囲み文字 - デリミタ文字を入力します。この文字は、データ値の開始境界および終了境界を区切ります。デフォルトのデリミタは二重引用符(" ")です。

4. ファイル名 - ダウンロードされたドキュメントの名前を入力します。ファイル拡張子は指定しないでください。拡張子は自動的に追加されます。これを空白のままにすると、リージョン名がファイル名として使用されます。

6. 変更を保存するには、「保存」をクリックします。ページを保存して実行するには、「ページの保存と実行」をクリックします。

10.4.6.3.3 電子メール・ダウンロードの有効化

特定の電子メール・アドレスに静的HTMLレポートを送信するように「ダウンロード」オプションを構成します。

ヒント:
電子メール・ダウンロードは、認証済ページでのみサポートされています。公開ページで電子メール・ダウンロードを有効にする場合、「ダウンロード」ダイアログには電子メール・ダウンロード・オプションは表示されません。

電子メール・ダウンロードを有効にするには、次のステップを実行します。

1. Oracle Application Express管理者は、インスタンス・レベルで電子メールを構成する必要があります。『Oracle Application Express管理ガイド』のメールの構成についての説明を参照してください。

2. レポートの属性を表示します。「ページ・デザイナでの対話モード・レポート属性の編集」を参照してください。
属性ページがプロパティ・エディタに表示されます。

3. 次の属性を編集します。
詳細は、フィールドレベル・ヘルプを参照してください。

1. 検索バー、検索バーを含める - 「はい」を選択します。

2. アクション・メニュー、ダウンロード - 「はい」を選択します。

ヒント:
「ダウンロード」で「いいえ」を選択すると、「アクション」メニューに「ダウンロード」メニューが表示されなくなります。ユーザーがデータを完全にダウンロードできなくするには、次のステップで説明するすべてのダウンロード形式の選択を解除します。

3. ダウンロード、ダウンロード形式 - 「電子メール」を選択します。

ヒント:
「アクション」メニューに「ダウンロード」オプションが表示されるのは、ファイル形式を選択した場合のみです。

4. 変更を保存するには、「保存」をクリックします。ページを保存して実行するには、「ページの保存と実行」をクリックします。

注意:
電子メール・ダウンロードから送信される電子メールには、電子メールの送信者を識別するシステム生成電子メール署名が含まれています。この署名は削除できません。

関連項目:
「対話モード・レポートからの電子メール送信について」

10.4.7 ページ・デザイナでのリンク列の管理

対話モード・レポートの左側には、「リンク列」が表示されます。この項では、単一行ビュー、カスタム・ターゲットにリンクするようにリンク列を構成する方法またはレポートからリンク列を除外する方法について説明します。

- 単一行ビューへのリンク

- 特定のページへのリンク

- URLへのリンク

- リンク列の除外

ヒント:
エンド・ユーザーはリンク列のソート、非表示、移動を行うことはできず、リンク列は列属性ページに定義されている標準の列リンクとは関係ありません。

10.4.7.1 単一行ビューへのリンクの設定

単一行ビューにリンクするには、次のステップを実行します。

1. レポートの属性を表示します。「ページ・デザイナでの対話モード・レポート属性の編集」を参照してください。
属性ページがプロパティ・エディタに表示されます。

2. 「リンク」属性を構成します。

1. 「リンク」を見つけて展開します。

2. リンク列 - 「単一行ビューへのリンク」を選択します。

3. 一意に行を識別する基準 - 「ROWID」または「一意列」を選択します。
「一意列」を選択した場合、「一意列」フィールドに列を指定します。

4. リンク・アイコン - デフォルトを使用するか、別のアイコンへのパスを指定します。

5. リンク属性 - 必要に応じて、<a href= >タグに含まれる追加の列リンク属性を指定します(リンク・ターゲット、クラス、スタイルなど)。

6. 認可スキーム - 認可スキームを選択して、リンク列と関連付けます。この認可スキームは、リンク列をレポートでレンダリングするためにTRUEと評価される必要があります。

7. 条件タイプ - このリンクをレンダリングするために満たす必要がある条件タイプをリストから選択します。

3. 「単一行ビュー」属性を構成します。

1. 「単一行ビュー」を見つけて展開します。

2. NULL値の除外 - 単一レコード・ビューでNULL列を非表示にするかどうかを指定します。

3. 表示されている列のみ - 現在表示されている列のみを単一レコード・ビューに表示するかどうかを指定します。「いいえ」を指定すると、非表示のレポート列も単一レコード・ビューに表示できます。

4. 変更を保存するには、「保存」をクリックします。ページを保存して実行するには、「ページの保存と実行」をクリックします。

ヒント:
対話モード・レポートが単一行ビューにリンクされており、リンク・アイコンにALTテキストがないか、ALTテキストが空である場合、レポートにアクセスできるようにするためにalt="単一行ビュー"が自動的に含められます。この動作を上書きするには、意味のあるALTテキストを含めてください。

10.4.7.2 特定のページへのリンク

特定のページにリンクするには、次のステップを実行します。

1. レポートの属性を表示します。「ページ・デザイナでの対話モード・レポート属性の編集」を参照してください。
属性ページがプロパティ・エディタに表示されます。

2. 「リンク」で、次のステップを実行します。

1. リンク列 - 「カスタム・ターゲットへのリンク」を選択します。

2. ターゲット -

- 「ターゲット」フィールドをクリックします。
「リンク・ビルダー - ターゲット」ダイアログが表示されます。

- ターゲット・タイプ: 「このアプリケーションのページ」を選択します。

- ページ: ターゲット・ページ番号を選択します。

- アイテムの設定: 「名前」および「値」を選択して、アイテムのセッション・ステートを指定します。

- キャッシュのクリア: キャッシュをクリアするページ番号を指定します。複数ページを指定するには、ページ番号のカンマ区切りリストを入力します。「対話モード・レポートへのリンクの設定」を参照してください。

- リクエスト: 使用するリクエストを指定します。

- このページのページ区切りをリセットするには、「ページ区切りのリセット」で「はい」を選択します。

- 「OK」をクリックします。

3. リンク・アイコン - デフォルトを使用するか、別のイメージを指定します。

4. リンク属性 (オプション) - <a href= >タグに含まれる追加の列リンク属性を指定します(リンク・ターゲット、クラス、スタイルなど)。

3. 変更を保存するには、「保存」をクリックします。ページを保存して実行するには、「ページの保存と実行」をクリックします。

10.4.7.3 URLへのリンクの設定

URLにリンクするには、次のステップを実行します。

1. レポートの属性を表示します。「ページ・デザイナでの対話モード・レポート属性の編集」を参照してください。
属性ページがプロパティ・エディタに表示されます。

2. 「リンク」属性を構成します。

1. 「リンク」を見つけて展開します。

2. リンク列 - 「カスタム・ターゲットへのリンク」を選択します。

3. 「ターゲット」を構成します。

- 「ターゲット」フィールドをクリックします。
「リンク・ビルダー - ターゲット」ダイアログが表示されます。

- ターゲット・タイプ: 「URL」を選択します。

- URL: 適切なアドレスを入力します。

- 「OK」をクリックします。

4. リンク・アイコン - デフォルトを使用するか、別のイメージを指定します。

5. リンク属性 (オプション) - <a href= >タグに含まれる追加の列リンク属性を指定します(リンク・ターゲット、クラス、スタイルなど)。

3. 変更を保存するには、「保存」をクリックします。ページを保存して実行するには、「ページの保存と実行」をクリックします。

10.4.7.4 リンク列の除外

列リンクを除外するには、次のステップを実行します。

1. レポートの属性を表示します。「ページ・デザイナでの対話モード・レポート属性の編集」を参照してください。
属性ページがプロパティ・エディタに表示されます。

2. 「リンク」を見つけて展開します。

3. 「リンク」属性を構成します。

1. 「リンク」を見つけて展開します。

2. 「リンク列」で、「リンク列の除外」を選択します。

4. 変更を保存するには、「保存」をクリックします。ページを保存して実行するには、「ページの保存と実行」をクリックします。

10.4.8 対話モード・レポートでの列リンクの作成

レポートからアプリケーション内の別のページまたはURLへのリンクを作成するには、「列属性」を使用します。

別のページへの列リンクを作成するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。「ページ・デザイナでのページの表示」を参照してください。
ページ・デザイナが表示されます。

2. 「レンダリング」ツリーで、リージョンを見つけて「列」ノードを展開します。
「レンダリング」ツリーに列が表示されます。

3. 編集する列を選択します
プロパティ・エディタにその列の属性が表示されます。

ヒント:
表示する情報の量を制御するには、「共通の表示」、「すべて表示」、「すべて閉じる」および「すべて開く」ボタンをクリックします。

4. 「指定」を展開します。「タイプ」から、「リンク」を選択します。

5. 「リンク」を展開して、「リンクが定義されていません」をクリックします。
「リンク・ビルダー - ターゲット」ダイアログが表示されます。

6. 別のページへのリンクを作成するには、「リンク・ビルダー - ターゲット」ダイアログで次のステップを実行します。

1. タイプ: 「このアプリケーションのページ」を選択します。

2. ページ: ターゲット・ページ番号を指定します。

3. アイテムの設定: 「名前」および「値」を選択して、アイテムのセッション・ステートを指定します。

4. セッション・ステートのクリア、キャッシュのクリア: キャッシュをクリアするページ番号を指定します。複数ページを指定するには、ページ番号のカンマ区切りリストを入力します。

5. ページ区切りのリセット: 「はい」を選択して、このページのページ区切りをリセットします。

6. 詳細、リクエスト: 使用するリクエストを指定します。

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

7. URLへのリンクを作成するには、「リンク・ビルダー - ターゲット」ダイアログで次のステップを実行します。

1. タイプ: 「URL」を選択します。

2. URL: URLアドレスを入力します。

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

8. 変更を保存するには、「保存」をクリックします。ページを保存して実行するには、「ページの保存と実行」をクリックします。

10.4.9 対話モード・レポートの条件付き表示

リージョン属性を編集することによって、対話モード・レポートを条件付きで表示するように指定できます。

対話モード・レポートを条件付きで表示するには、次のステップを実行します。

1. リージョン属性を表示します。「ページ・デザイナでのリージョン属性の編集」を参照してください。

2. 「条件」を見つけて展開します。

3. 「タイプ」で、条件タイプを選択して、画面に表示される手順に従います。
ページ・デザイナは、ページを保存する前に対処する必要があるエラーおよび警告を通知します。「メッセージ」タブに、対処する必要があるメッセージの数を示した赤または黄色のバッジが表示されます

4. 変更を保存するには、「保存」をクリックします。ページを保存して実行するには、「ページの保存と実行」をクリックします。

ヒント:
Asynchronous JavaScript and XML (AJAX)が対話モード・レポート全体で使用されています。AJAXは非同期であるため、条件付き表示用に評価される値はセッション内に含まれている必要があります。指定した値に基づいて対話モード・レポートを条件付きで表示するには、:REQUEST値のかわりにページ・アイテムを使用します。条件付き表示で:REQUESTを使用した場合、対話モード・レポート機能が正しく動作しません。

10.4.10 対話モード・レポートでのLOVとしての列定義

対話モード・レポートでは、LOVを使用して組込みフィルタ・ツールの速度を向上できます。

レポート列をLOVとして定義するには、次のステップを実行します。

1. リージョン属性を表示します。「ページ・デザイナでのリージョン属性の編集」を参照してください。

2. 「列」ノードを展開して、目的の列を選択します。

3. 「列フィルタ」を見つけて展開します。

4. 「列フィルタ」の「タイプ」で、レポート列ドロップ・ダウン・リストに表示されるフィルタの導出方法を選択します。オプションは次のとおりです。

- なし: LOVのフィルタが無効になります。

- 列タイプに基づくデフォルト: STRINGおよびNUMBERの列では固有の列値からLOVを導出します。DATE列では、事前定義された日付範囲からLOVを導出します。

- 「単語を含む」のフィルタ処理に定義済LOVを使用: 定義済LOVのSQL問合せからLOVを導出してcontainsフィルタを作成します。

- 完全一致のフィルタ処理に名前付きLOVを使用: 名前付きLOVからLOVを導出してequalフィルタを作成します。

- 「単語を含む」のフィルタ処理に名前付きLOVを使用: 名前付きLOVからLOVを導出してcontainsフィルタを作成します。

5. 変更を保存するには、「保存」をクリックします。ページを保存して実行するには、「ページの保存と実行」をクリックします。

10.4.11 ページ・デザイナでのアイコン・ビューの有効化

デフォルトでは、ほとんどの対話モード・レポートはレポートとして表示されます。必要に応じて、列をアイコンとして表示できます。列をアイコンとして表示するように構成すると、「アイコンの表示」アイコンが検索バーに表示されます。

アイコン・ビューを利用するには、アイコン、ラベルおよびターゲット(つまり、リンク)を識別するために使用する列を指定します。これらの列は通常エンド・ユーザーには役立たないため、非表示になるように設定することをお薦めします。

- 対話モード・レポートへのアイコン・ビューの追加

- カスタム・アイコン・ビュー・リンクの追加

10.4.11.1 「アイコンの表示」ボタンの追加

対話モード・レポートにアイコン・ビューを追加するには、次のステップを実行します。

1. レポートの属性を表示します。「ページ・デザイナでの対話モード・レポート属性の編集」を参照してください。
属性ページがプロパティ・エディタに表示されます。

2. 「アイコン・ビュー」を見つけて展開します。

3. 「アイコン・ビュー」属性を構成します。

ヒント:
例を表示するには、フィールドレベル・ヘルプを参照してください。

1. 有効: 「はい」を選択します。

2. カスタム・アイコン・ビュー: アイコン・ビューのカスタム・リンクを定義するかどうかを指定します。「はい」または「いいえ」を選択します。「カスタム・アイコン・ビュー・リンクの追加」を参照してください。

3. 1行当たりの行数: アイコン・ビューの1行当たりに表示するアイコンの数を選択します。値を5にすると、レポートの1行当たり5つのアイコンが表示されます。

4. リンク列: アイコンのリンク・ターゲットを返す列を選択します。

5. イメージ・ソース列: イメージ・ソースを返す列を指定します。

6. ラベル列: イメージ・ラベルを返す列を選択します。

4. 変更を保存するには、「保存」をクリックします。ページを保存して実行するには、「ページの保存と実行」をクリックします。

10.4.11.2 カスタム・アイコン・ビュー・リンクの追加

カスタム・アイコン・ビュー・リンクでは、複数列を使用できるなど、アイコン・ビューのコンテンツをより柔軟に定義できます。

カスタム・アイコン・ビュー・リンクを追加するには、次の手順を実行します。

1. レポートの属性を表示します。「ページ・デザイナでの対話モード・レポート属性の編集」を参照してください。
属性ページがプロパティ・エディタに表示されます。

2. 「アイコン・ビュー」を見つけて展開します。

3. 「アイコン・ビュー」属性を構成します。

1. 有効: 「はい」を選択します。

2. カスタム・アイコン・ビュー - 「はい」を選択します。

3. 1ページ当たりの列数 - アイコン・ビューの1行当たりに表示するアイコンの数を選択します。値を5にすると、レポートの1行当たり5つのアイコンが表示されます。

4. カスタム・リンク - アイコン・ビューの列リンクを入力します。次の例のように、列名に置換文字列を使用します。

<a href="#EMP_LINK#"><img src="#EMP_IMG#" title="#ENAME#" alt="#ENAME#"><br>#ENAME#</a>

4. 変更を保存するには、「保存」をクリックします。ページを保存して実行するには、「ページの保存と実行」をクリックします。

10.4.12 対話モード・レポートでの列の書式設定

対話モード・レポートでHTML式を使用して、列の表示をさらにカスタマイズできます。

列の書式設定を定義するには、次の手順を実行します。

1. 列属性を編集します。「ページ・デザイナでの列属性の編集」を参照してください。
対話モード・レポートの属性ページが表示されます。

2. 「列の書式」を見つけて展開します。

3. 「HTML式」で、列に表示するHTML式を指定します。HTMLで列値を示すには、#COLUMN#構文を使用します。
例1: 背景およびテキストの色の変更

<span style="background-color: yellow; color: red;">#EMPLOYEE_STATUS</span>

例2: ヘッダー2の使用

<h2>#EMPLOYEE_NAME#</h2>

例3: SQL問合せからの動的クラスの使用

<span class="#COLUMN_CLASS#">#EMPLOYEE_STATUS#</span>

この例で#COLUMN_CLASS#および#EMPLOYEE_STATUS#に代入されるのは、レポートSQL問合せで選択された列です。

例4: イメージの表示およびカーソルをあわせたときのツールチップの表示

<img src="#IMAGE_NAME#" title="#EMPLOYEE_NAME#">

4. 変更を保存するには、「保存」をクリックします。ページを保存して実行するには、「ページの保存と実行」をクリックします。

10.4.13 ページ・デザイナでの詳細ビューの有効化

デフォルトでは、ほとんどの対話モード・レポートはレポートとして表示されます。必要に応じて、各列の詳細を表示できます。構成すると、検索バーに「詳細の表示」アイコンが表示されます。

対話モード・レポートに詳細ビューを追加するには、次のステップを実行します。

1. レポートの属性を表示します。「ページ・デザイナでの対話モード・レポート属性の編集」を参照してください。
属性ページがプロパティ・エディタに表示されます。

2. 「詳細ビュー」を見つけて展開します。

3. 「詳細ビュー」属性を構成します。

1. 有効: 「はい」を選択します。

2. 行の前: レポート行の前に表示するHTMLを入力します。次に例を示します。

<TABLE>

3. 各行: 詳細ビューのレポート行の本体を入力します。列名および列ラベルに#COLUMN_NAME#置換文字列を使用します。次に例を示します。

<tr><td class="u-textRight">#ENAME_LABEL#:</td><td>#ENAME#</td></tr>
<tr><td class="u-textRight">#JOB_LABEL#:</td><td>#JOB#</td></tr>

4. 行の後: レポート行の後に表示するHTMLを入力します。次に例を示します。

</table>

4. 変更を保存するには、「保存」をクリックします。ページを保存して実行するには、「ページの保存と実行」をクリックします。

10.4.14 対話モード・レポートの詳細属性の構成

この項では、対話モード・レポートの詳細属性を構成する方法について説明します。詳細属性によって、リージョンの別名の定義、保存したレポートのIDを格納する値を持つアイテムの指定および対話モード・レポートのサブスクリプションまたは電子メール・ダウンロードの送信者アドレスの定義を行うことができます。

- ページ・デザイナでの詳細属性の構成

- 対話モード・レポートからの電子メール送信について

10.4.14.1 ページ・デザイナでの詳細属性の構成

詳細属性を構成するには、次のステップを実行します。

1. レポートの属性を表示します。「ページ・デザイナでの対話モード・レポート属性の編集」を参照してください。
属性ページがプロパティ・エディタに表示されます。

2. 「詳細」を見つけて展開します。
表 10-5に、使用可能な詳細属性を示します。

表10-5 詳細属性

属性

説明

リージョン別名

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

対象の対話モード・レポート・リージョンの英数字の別名を入力します。別名は、アプリケーション内で一意である必要があります。カスタムAPIコールでは、別名を使用して対話モード・レポート・リージョンを参照できます。たとえば、APEX_APPLICATION_PAGE_IRビューでALIAS列を問い合せることによって、INTERACTIVE_REPORT_IDを返すファンクションを記述できます。INTERACTIVE_REPORT_IDの値は、アプリケーションを別のインスタンスにエクスポートまたはインポートするときに変わる可能性があるため、別名を使用して対話モード・レポート・リージョンを参照する方法は有益です。

行カウント最大値

問い合せる最大行数を入力します。問い合せる行の数は、パフォーマンスに影響する可能性があります。より少ない行を問い合せるとパフォーマンスが向上し、数千という行を問い合せるとパフォーマンスが低下します。

レポートIDアイテム

このレポートのリージョンIDを格納するページまたはアプリケーション・アイテムを選択します。これで、保存されている代替またはパブリック・レポートにナビゲートするためのURLを定義する際、このアイテムの値を参照することでリージョンIDを含めることができます。

電子メール送信者アドレス

このレポートから電子メールを送信するときに送信者アドレスとして使用する有効な電子メール・アドレスを入力します。電子メールは、電子メール・タイプおよびサブスクリプション・タイプのダウンロードの場合にこのレポートから送信されます。値は、有効な電子メール・アドレスを含むリテラル文字列、または置換構文を使用してアプリケーションで定義された静的置換参照です。

アイテムの置換は、電子メール・ダウンロードでのみ機能し、サブスクリプションでは機能しないため、アプリケーションまたはページレベルでのアイテムの置換の使用はお薦めしません。

次に例を示します。

john.doe@abc.com
&MY_APP_EMAIL_FROM.
&APP_EMAIL.

3. 変更を保存するには、「保存」をクリックします。ページを保存して実行するには、「ページの保存と実行」をクリックします。

10.4.14.2 対話モード・レポートからの電子メール送信について

次の2つの方法で、対話モード・レポートから送信された電子メールの送信元アドレスを定義できます。

- 「アプリケーション定義の編集」ページの「アプリケーションの電子メール送信元アドレス」属性でのアプリケーションレベル。「アプリケーション定義ページの編集」を参照してください。

- 「対話モード・レポートの属性」ページの「電子メール送信者アドレス」属性での対話モード・レポートレベル。「対話モード・レポートの詳細属性の構成」を参照してください。

いずれの場合も、値には、有効な電子メールを含むリテラル文字列、アプリケーションレベルで定義したアプリケーションの電子メール送信元アドレスを返す置換構文または&APP_EMAIL.置換を使用してアプリケーションレベルで定義されたアプリケーション置換を指定できます。次に例を示します。

john.doe@abc.com
&MY_APP_EMAIL_FROM.
&APP_EMAIL.

アイテムの置換は、電子メール・ダウンロードでのみ機能し、サブスクリプションでは機能しないため、アプリケーションまたはページレベルでのアイテムの置換の使用はお薦めしません。

関連項目:
「電子メール・ダウンロードの有効化」および「置換文字列の理解」

10.4.15 対話モード・レポートへのリンクの設定

一般にページ・アイテムをレポート・パラメータとして使用するクラシック・レポートとは異なり、対話モード・レポートのデータは、宣言的なフィルタで決まります。ただし、開発者は、エンド・ユーザーに対する対話モード・レポート設定を変更することで、このレポート・パラメータを設定することができます。この設定は、エンド・ユーザーが作業中のレポートのみに影響します。保存済のレポート設定には影響しません。この項で説明する構文をURLのRequest値およびItemNamesセクションで使用して、対話モード・レポートにリンクします。

注意:
追加の対話モード・レポート・リージョンを追加する場合、古い単一の対話モード・レポートのリンク構文を必ず変更してください。変更しなければ、リンクでエラーが発生します。複数の対話モード・レポート・リージョン、RequestまたはName構文があるページへのリンクは、リージョンの静的IDで完全修飾する必要があります。

- Request構文

- Name構文およびValue構文

- ClearCache構文

- 対話モード・レポートにリンクする際の制限

- 有効なリンクの例

- 無効なリンクの例

- 共有対話モード・レポートへのリンクの設定

関連項目:
「URL構文の理解」および「f?p構文を使用したページのリンクについて」

10.4.15.1 Request構文

特定の保存済レポートにリンクするには、次のRequest構文を使用します。

IR[region static ID]_<report_alias>

次に例を示します。

IR[EMP]_dept20

注意:
URLでのRequestの使用はオプションです。複数の保存済レポートにリンクするには、各Requestをカンマで区切ります。

10.4.15.2 Name構文およびValue構文

フィルタを作成するには、次のitemNames構文およびitemValues構文を使用します。

IR[region static ID]<operator>_<target column alias>

次に例を示します。

IR[EMP]C_ENAME:KING

注意:
ページ上の対話モード・レポート・リージョンが1つのみの場合、itemNameはリージョンの静的IDで完全修飾する必要はありません。演算子が定義されていない場合、等号演算子によるフィルタが追加されます。

リンク内の対話モード・レポートにフィルタを作成するには、前述のitemNames構文を使用して、URLのItem Namesセクションの対応する場所にフィルタ値を追加します。

対話モード・レポートにフィルタを含む行テキストを作成するには、Item Name構文でターゲット列の別名としてROWFILTERを使用し、URLのitemValuesにフィルタ値を追加します。リンクは、タイプがSTRINGまたはNUMBERのレポートに表示されるすべての列を検索するRow Text Containsフィルタを追加します。

次に例を示します。

IR[EMP]_ROWFILTER:SALES

有効な演算子は、次のとおりです。

- C = 含む

- EQ = 等しい(これがデフォルトです)

- GTE = 以上

- GT = 次より大きい

- LIKE = SQLのLike演算子

- LT = 次より小さい

- LTE: より小さいか、等しい

- N = NULL

- NC = 含まない

- NEQ = 等しくない

- NLIKE = 類似ではない

- NN = NULLではない

- NIN = 次に含まれない(バックスラッシュ(\)を使用したカンマ区切り値をエスケープ)

- IN = 次に含まれる(バックスラッシュ(\)を使用したカンマ区切り値をエスケープ)

- ROWFILTER = 次を含む行テキスト(これは、タイプがSTRINGまたはNUMBERのレポートに表示されるすべての列を検索します)

10.4.15.3 ClearCache構文

ヒント:
保存済レポートの別名を指定しないでRequestでClearCacheを使用すると、プライマリ・デフォルト・レポートがクリアされます。複数の対話モード・レポートがあるページで、特定の対話モード・レポート・リージョンをクリアするには、保存済レポートの別名とともにリージョンの静的IDをRequestで指定します。

URLのClearCacheセクションで次の構文を使用して、対話モード・レポートのリセット、クリアまたはページ区切りのリセットを行います。

- RIR - 対話モード・レポートをリセットします。これは、エンド・ユーザーがターゲット・ページで対話モード・レポートの「アクション」メニューから「リセット」オプションを選択した場合に相当します。レポートは、開発者が指定したか、またはユーザーが保存したデフォルトのレポート設定に戻ります。

- CIR - 対話モード・レポートをクリアします。これにより、コントロール・ブレーク、集計、フラッシュバック、チャート、表示する行数、フィルタ、ハイライト、計算、グループ化、ピボットなどすべてのレポート設定がクリアされます。

- RP - 対話モード・レポートのページ区切りをリセットします。

10.4.15.4 対話モード・レポートにリンクする際の制限

対話モード・レポートにリンクする場合は、次の制限に注意してください。

1. Request値がURLで定義されていない場合、すべてのプライマリ・デフォルト・レポート設定が変更されます。

2. Requestが定義されておらず、かつ、itemNamesセクションに、リージョンの静的IDで完全修飾されたフィルタ列名が含まれていない場合、ターゲット・ページに複数の対話モード・レポート・リージョンが存在すると、エラーが発生します。

3. Request値が定義されておらず、かつ、itemNamesセクションに、リージョンの静的IDで完全修飾されたフィルタ列名が含まれていない場合、ターゲット・ページ内の対話モード・レポート・リージョンが1つのみであれば、プライマリ・デフォルト・レポートにフィルタが作成されます。

10.4.15.5 有効なリンクの例

この項では、有効なリンクの例について説明します。

有効なリンクの例1

この例には、Request値のないリンクが含まれていますが、URLのitemNamesセクションに、リージョンの静的IDで修飾されたフィルタ列が含まれています。この例では、参照されるリージョンのItem Nameのプライマリ・デフォルト・レポートにフィルタを作成しています。

f?p=&APP_ID.:2:&SESSION.::::IR[EMP]_ENAME:KING

有効なリンクの例2

以前のリリースとの下位互換性をサポートするために、この例では古い構文を使用しています。これは対話モード・レポート・リージョンが1つのページで機能します。

?p=&APP_ID.:1:&SESSION.:IR_REPORT_12345::RIR,CIR::RIR,CIR:IR_ENAME:KING

有効なリンクの例3

この例では、リンクにRequest値はありません。clear cacheセクションにはRIR、CIRまたはRPがあり、すべての対話モード・レポート・リージョンのプライマリ・デフォルト・レポートのリセット、クリアまたはページ区切りのリセットを行います。

f?p=&APP_ID.:1:&SESSION.:::RIR:

10.4.15.6 無効なリンクの例

この項では、無効なリンクの例について説明します。

無効なリンクの例1

このリンクには、Request値がなく、かつ、URLのItem Nameセクションに、リージョンの静的IDで完全修飾されたフィルタ列が含まれていません。この例では、ターゲット・ページに複数の対話モード・レポート・リージョンが存在すると、エラーが発生します。

f?p=&APP_ID.:2:&SESSION.::::ENAME:KING

無効なリンクの例2

この例には、2つのRequest値がカンマで区切られたリンクがあり、かつ、URLのItem Nameセクションに、リージョンの静的IDで完全修飾されたフィルタ列が含まれていません。この例では、フィルタを作成する必要がある場所が明確でないため、エラーが発生します。

f?p=&APP_ID.:2:&SESSION.:IR[test]_employee,IR[test2]_dept10:::ENAME:KING

無効なリンクの例3

この例では、対話モード・レポート・リージョンが複数あるページで、古いRequest値の構文を使用しています。この例ではエラーが発生します。古い構文は、対話モード・レポート・リージョンが1つの場合にのみ機能します。

f?p=&APP_ID.:2:&SESSION.:IR_REPORT_myrpt:::ENAME:KING

10.4.15.7 共有対話モード・レポートへのリンクの設定

この項では、URLのRequest値でIR[region static ID]_<report_alias>を使用して、保存されたプライマリ・デフォルト、代替デフォルトおよびパブリック・レポートにリンクする方法について説明します。

- ページ・デザイナでのデフォルト・レポートの別名の編集

- プライマリ・レポートへのリンクの例

- 保存済のレポートへのリンクの例

関連項目:
「f?p構文を使用したページのリンクについて」、「デフォルトの対話モード・レポートの保存」、「保存された対話モード・レポートの削除」および『Oracle Application Express管理ガイド』の保存された対話モード・レポートの管理に関する項

10.4.15.7.1 ページ・デザイナでのデフォルト・レポートの別名の編集

プロパティ・エディタで、デフォルトの対話モード・レポートの属性を表示できます。

デフォルトの対話モード・レポートの属性を表示するには、次のステップを実行します。

1. レポートの属性を表示します。「ページ・デザイナでの対話モード・レポート属性の編集」を参照してください。

2. 「属性」で、「保存されたレポート」を展開します。

3. 保存済レポートを選択します。
「保存されたレポート」属性がプロパティ・エディタに表示されます。

4. 「指定」を展開します。

5. 「別名」で、このレポートの新しい別名を入力します。この別名を使用して、この保存済レポートへのわかりやすいURLリンクを定義します。このリンクを使用して、アプリケーション内の別の場所から直接リンクできます。
詳細は、フィールドレベル・ヘルプを参照してください。「ページ・デザイナでのヘルプの表示」を参照してください。

6. 変更を保存するには、「保存」をクリックします。ページを保存して実行するには、「ページの保存と実行」をクリックします。

10.4.15.7.2 プライマリ・レポートへのリンクの例

次の例では、プライマリ・レポート(report_alias=PRIMARY)にリンクする方法を示します。

この例では、プライマリ・レポートへのリンクを設定しています。

f?p=100:1:&APP_SESSION.:IR_PRIMARY

この例では、プライマリ・レポートへのリンクを設定し、レポート設定のリセットおよびクリアを行っています。

f?p=100:1:&APP_SESSION.:IR_PRIMARY::RIR,CIR:

この例では、プライマリ・レポートへのリンクを設定し、レポート設定のリセットおよびクリアを行っています。さらに、プライマリ・レポートでENAME = 'KING'フィルタを作成しています。

f?p=100:1:&APP_SESSION.:IR_PRIMARY::RIR,CIR:IR_ENAME:KING

10.4.15.7.3 保存済のレポートへのリンクの例

次の各例では、保存済のレポート(report_alias=12345)へのリンクを設定する方法を示します。

この例では、保存済のレポートへのリンクを設定しています。

f?p=100:1:&SESSION.:IR_REPORT1

この例では、保存済レポートREPORT1にリンクし、設定をリセットおよびクリアしています。

f?p=100:1:&SESSION.:IR_REPORT1::RIR,CIR:

この例では、保存済レポートREPORT1にリンクし、設定をリセットおよびクリアしています。さらに、保存済レポートREPORT1でENAME = 'KING'フィルタを作成しています。

f?p=100:1:&SESSION.:IR_REPORT1::RIR,CIR::RIR,CIR:IR_ENAME:KING

10.5 コンポーネント・ビューでの対話モード・レポートの編集

デフォルトでは、対話モード・レポートの各行の最初の列には、検索バー、「アクション」メニュー、「列ヘッダー」メニューおよび「編集」アイコンがあります。ユーザーは、これらのコントロールを使用して、列の選択、フィルタの適用、ハイライトおよびソートを実行し、レポート・データのレイアウトを変更できます。この項では、開発者がコンポーネント・ビューで対話モード・レポートをカスタマイズして、これらのコントロールの表示を構成する方法について説明します。

- コンポーネント・ビューでの対話モード・レポート属性の編集

- コンポーネント・ビューでの列属性の編集

- 列グループの作成

- コンポーネント・ビューでの対話モード・レポートのページ区切りの制御

- コンポーネント・ビューでの検索バーおよび「アクション」メニューの管理

- 「アクション」メニューの「ダウンロード」オプションの構成

- コンポーネント・ビューでのリンク列の管理

- 対話モード・レポートでの列 リンクの作成

- 対話モード・レポートの条件付き表示

- 対話モード・レポートでのLOVとしての列定義

- 対話モード・レポートでの列の書式設定

- コンポーネント・ビューでのアイコン・ビューの有効化

- コンポーネント・ビューでの詳細ビューの有効化

- 対話モード・レポートの詳細属性の構成

- 対話モード・レポートへのリンクの設定

- 共有対話モード・レポートへのリンクの設定

- コンポーネント・ビューでの保存されたデフォルト対話モード・レポートの編集

関連項目:
「コンポーネント・ビューでのページの管理」、「エンド・ユーザーとしての対話モード・レポートのカスタマイズ」および『Oracle Application Express APIリファレンス』のAPEX_IRに関する項

10.5.1 コンポーネント・ビューでの対話モード・レポート属性の編集

この項では、レポート属性を編集して、対話モード・レポートをカスタマイズする方法について説明します。

- コンポーネント・ビューでの対話モード・レポートの属性ページへのアクセス

- レポート属性ページへのナビゲーション方法

10.5.1.1 コンポーネント・ビューでの対話モード・レポートの属性ページへのアクセス

レポート属性ページを表示するには、次のステップを実行します。

1. コンポーネント・ビューでページを表示します。「コンポーネント・ビューでのページの表示」を参照してください。
コンポーネント・ビューが表示されます。

2. 「リージョン」で、編集するレポート・リージョンの名前の横にある「対話モード・レポート」リンクをクリックします。

3. レポート属性ページが表示されます。このページは次のセクションに分かれています。

- 「列属性」はレポート・レイアウトを制御します。「コンポーネント・ビューでの列属性の編集」を参照してください。

- 「列グループ」属性を使用すると、複数列を単一行ビューにまとめることができます。「列グループの作成」を参照してください。

- 「ページ区切り」属性はレポートのページ区切りを制御します。「コンポーネント・ビューでの対話モード・レポートのページ区切りの制御」を参照してください。

- 「検索バー」には、対話モード・レポート内に検索バーを定義するための属性が含まれています。「コンポーネント・ビューでの検索バーおよび「アクション」メニューの管理」を参照してください。

- 「ダウンロード」を使用すると、「アクション」メニューにダウンロード・オプションを追加して、レポートをCSV、HTML、電子メール、XLS、PDFまたはRTFファイルでエクスポートできるようになります。「「アクション」メニューの「ダウンロード」オプションの構成」を参照してください。

- 「リンク列」属性を使用すると、列にリンクを追加できます。「コンポーネント・ビューでのリンク列の管理」および「対話モード・レポートでの列リンクの作成」を参照してください。

- 「詳細属性」を使用すると、「対話モード・レポート」リージョンの別名の定義、保存したレポートのIDを格納する値を持つアイテムの指定、およびセッション・ステートに設定するアイテムの定義を行うことができます。「対話モード・レポートの詳細属性の構成」を参照してください。

- 「アイコン・ビュー」属性を使用すると、検索バーに「アイコンの表示」アイコンを追加できます。「コンポーネント・ビューでのアイコン・ビューの有効化」を参照してください。

- 「詳細ビュー」属性を使用すると、検索バーに「詳細の表示」アイコンを追加できます。「コンポーネント・ビューでの詳細ビューの有効化」を参照してください。

- 「説明」には、現在のレポートの説明テキストが表示されます。

ヒント:
属性の詳細は、フィールドレベル・ヘルプを参照してください。「フィールドレベル・ヘルプの表示」を参照してください。

関連項目:
「コンポーネント・ビューでのクラシック・レポートの列リンクの作成」、「コンポーネント・ビューでの更新可能な列の定義」、「コンポーネント・ビューでのクラシック・レポートのLOVとしての列定義」および「コンポーネント・ビューでのクラシック・レポートの列の表示条件の制御」を参照してください

10.5.1.2 レポート属性ページへのナビゲーション方法

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

10.5.2 コンポーネント・ビューでの列属性の編集

レポート属性ページの「列属性」セクションを使用すると、レポート・レイアウトを詳細に制御できます。たとえば、これらの属性を使用して、列ヘッダー・テキストの変更、列の位置の変更、または列の非表示化を行うことができます。

「列属性」にアクセスするには、次のステップを実行します。

1. 対話モード・レポートの属性ページにアクセスします。「コンポーネント・ビューでの対話モード・レポートの属性ページへのアクセス」を参照してください。
ページ上部に「列属性」セクションがある対話モード・レポートの属性ページが表示されます。

「列属性」セクションを使用して、レポート列の外観と機能を制御します。

「ヘッダー」には、レポートに含めるヘッダー・テキストが表示されます。「タイプ」は、問合せ列の型を示します。「リンク」列は、リンク列が現在定義されているかどうかを示します。

表 10-6に、レポート列の基本的な編集操作を示します。

表 10-6 対話モード・レポートのレポート列の基本的な編集操作

説明

開発者アクション

列ヘッダーのテキストを変更します。

「ヘッダー」で、異なるヘッダー・テキストを入力します。

列グループの割当てを変更します。

列グループが定義されている場合、「列グループ」で列を個別に割り当てることができます。

列の表示方法を変更します。

「表示テキスト」からオプションを選択します。

列属性ページで、特定の列の属性をさらに詳細に指定できます。

2. 列属性ページにアクセスするには、該当する列の横にある「編集」アイコンをクリックします。
「列の定義」が表示されます。

3. 「列の定義」の「ユーザーに許可する操作」で、該当するチェック・ボックスを選択します。オプションには、「非表示」、「ソート」、「フィルタ」、「ハイライト」、「コントロール・ブレーク」、「集計」、「計算」、「チャート」および「グループ化」があります。選択したオプションによって、ユーザーがレポートを操作できる方法が決定されます。

4. 対象となる属性を編集します。
属性の詳細は、フィールドレベル・ヘルプを参照してください。

5. 「変更の適用」をクリックして、編集を保存します。

10.5.3 列グループの作成

列グループを使用すると、単一行ビューで列をグループ化できます。

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

1. 対話モード・レポートの属性ページにアクセスします。「コンポーネント・ビューでの対話モード・レポートの属性ページへのアクセス」を参照してください。
対話モード・レポートの属性ページが表示されます。

2. 「列グループ」までスクロールします。

3. 「グループの追加」をクリックします。

4. 「列グループ」で、次の手順を実行します。

1. 順序: この列グループの表示順序を入力します。この属性は、詳細ビューで列グループが表示される順番を決定します。

2. グループ名: 列グループ名を入力します。この名前は、詳細ビューでリージョン・ヘッダーに表示されます。

3. 説明: 列グループの説明を入力します(オプション)。この説明は、エンド・ユーザーには表示されません。

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

10.5.4 コンポーネント・ビューでの対話モード・レポートのページ区切りの制御

対話モード・レポートの属性ページの「ページ区切り」属性から選択することによって、ページ区切りの表示方法を制御します。

レポート属性ページの「ページ区切り」セクションにアクセスするには、次のステップを実行します。

1. 対話モード・レポートの属性ページにアクセスします。「コンポーネント・ビューでの対話モード・レポートの属性ページへのアクセス」を参照してください。
対話モード・レポートの属性ページが表示されます。

2. 「ページ区切り」までスクロールします。
「ページ区切り」属性では、ページ区切りスタイルの選択、ページ区切りの表示位置の決定、問合せの最大行数の指定、および最大行数を超える行が戻された場合や1行も戻されなかった場合に表示するメッセージの指定などを行います。

表10-7に、使用可能な「ページ区切り」属性を示します。

表10-7 「ページ区切り」属性

属性

説明

ページ区切りタイプ

ページ区切りタイプを選択します。ページ区切りによって、結果セット内の行数および現在の位置に関する情報が提供されます。ページ区切りの有効なオプションは、次のとおりです。

- XからYの範囲の行

- ZのXからYの範囲の行

ページ区切り表示位置

ページ区切りの表示位置を定義します。ページ区切りは、レポートの左側、右側、上部または下部に表示できます。

NULL値を置き換えて表示

NULL列に表示するテキストを入力します。デフォルト値は(null)です。

行カウント最大値

問合せを行う最大行数を定義します(例: 456行中の行1 - 10)。

この属性を200に設定すると、結果は次のように表示されます。

rows 1 - 10 of more than 200 rows

この属性はパフォーマンスに影響を与えます。より少ない行数をカウントするとパフォーマンスは向上し、数千という行数をカウントするとパフォーマンスは低下します。

最大行数を超える行データでメッセージが見つかったとき

最大行数を超える行が返されたときに表示するテキスト・メッセージを定義します。

データが見つからなかった場合のメッセージ

問合せから行が返されなかったときに表示するテキスト・メッセージを定義します。

3. 「変更の適用」をクリックして、編集を保存します。

10.5.5 コンポーネント・ビューでの検索バーおよび「アクション」メニューの管理

この項では、対話モード・レポートの検索バーをカスタマイズする方法について説明します。

- 対話モード・レポートの検索バーおよび「アクション」メニュー

- 検索バーおよび「アクション」メニューのカスタマイズ

- 検索バーの削除

- 「アクション」メニューの「ダウンロード」オプションの構成

関連項目:
「コンポーネント・ビューでのアイコン・ビューの有効化」および「コンポーネント・ビューでの詳細ビューの有効化」

10.5.5.1 対話モード・レポートの検索バーおよび「アクション」メニュー

検索バーは各対話モード・レポートの上部に表示され、「検索列の選択」アイコン、テキスト領域、「実行」ボタンおよび「アクション」メニューが含まれています。

対話モード・レポートの属性ページの「検索バー」セクションのオプションを選択および選択解除して、検索バーを削除したり、カスタマイズすることができます。

10.5.5.2 検索バーおよび「アクション」メニューのカスタマイズ

検索バーをカスタマイズするには、次のステップを実行します。

1. 対話モード・レポートの属性ページにアクセスします。「コンポーネント・ビューでの対話モード・レポートの属性ページへのアクセス」を参照してください。
対話モード・レポートの属性ページが表示されます。

2. 「検索バー」までスクロールします。

これらの属性を使用して、検索バーの表示方法をカスタマイズします。表10-8に、「検索バー」属性を示します。

表10-8 「検索バー」属性

属性

説明

検索バーを含める

「はい」または「いいえ」を選択します。「いいえ」を選択すると、次のデフォルトのコンポーネントが削除されます。

- 検索フィールド: 検索基準を入力するテキスト・フィールドが検索バーに表示されます。

- ファインダ・ドロップ・ダウン: 選択した1列またはすべての列に対してユーザーが検索できるようにします。

- レポート選択リスト: レポートに代替デフォルト、共有レポートまたはパーソナル・レポートが含まれている場合に、レポート選択リストを表示します。「対話モード・レポートの保存」を参照してください。

- ページごとの行数セレクタ: 選択リストが表示され、1ページ当たりに表示される行数をそのリストから選択できます。

- アクション・メニュー: 選択した「アクション」に基づいてユーザーがレポートをカスタマイズできるようにします。

アクション・メニューに含める

「アクション」メニューに含める機能を選択および選択解除します。使用可能なオプションは次のとおりです。

- 列の選択: レポート列の表示/非表示および並替えを行うときに使用します。

- フィルタ: レポートにフィルタを追加するときに使用します(たとえば、STATE = VA)。

- ページごとの行数: 「ページごとの行数」メニューを表示するときに使用します。

- ソート: 列をソートするときに使用します。

- コントロール・ブレーク: レポート列にコントロール・ブレークを作成するときに使用します。

- ハイライト: 特定の行をハイライトする条件を定義するときに使用します。

- 計算: 計算結果の列を追加するときに使用します。

- 集計: レポート列に集計計算を含めるときに使用します。

- チャート: レポートのデータを利用せずにFlashチャートを作成するときに使用します。

- グループ化: レポートのデータを利用せずに「グループ化」ビューを作成するときに使用します。

- ピボット: レポートのデータに基づいてクロス・タブ・ビューを作成するときに使用します。

- フラッシュバック: レポート・データを過去のある時点までフラッシュバックするときに使用します。

- レポートの保存: 後で利用できるようにレポート設定を保存するときに使用します。認証済ページにのみ使用できます。

- パブリック・レポートの保存: すべてのユーザーが表示できるようにパブリック・レポートを保存するときに使用します。このオプションを有効にするには、「レポートの保存」を選択する必要があります。認証済ページにのみ使用できます。

- リセット: レポートをデフォルト設定にリセットするときに使用します。

- ヘルプ: 対話モード・レポートの使用方法を表示するときに使用します。

- ダウンロード: レポートを様々な形式でダウンロードするときに使用します。
注意: 「ダウンロード」機能を無効にすると、「アクション」メニューに「ダウンロード」メニューが表示されなくなるだけです。ユーザーが完全にデータをダウンロードできなくするには、「ダウンロード形式」セクションのすべてのチェック・ボックスを選択解除します。

- サブスクリプション: レポートを電子メールで送信するようにサブスクリプションをスケジュールするときに使用します。認証済ページにのみ使用できます。

関連項目: 「「アクション」メニューについて」

レポートのパブリック保存の認可

ユーザーは、レポートを保存し、そのレポートをパブリックまたはプライベートとして分類できます。パブリック・レポートは、すべてのユーザーが表示できます。プライベート・レポートは、そのレポートを保存したユーザーのみが表示できます。

「アクション」メニューで「パブリック・レポートの保存」を有効にすることに加え、「パブリック・レポートの保存」を有効にする権限を持つユーザーを決定する認可スキームを定義することによって、セキュリティを強化できます。

パブリック・レポートのサポートを有効にするには、このリストから認証方式を選択する必要があります。

検索ボタン・ラベル

検索ボタン・ラベルとして使用するテキストを指定します。

最大行数/ページ

「ページごとの行数セレクタ」に表示する最大数を入力します。

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

10.5.5.3 検索バーの削除

検索バーを削除するには、次のステップを実行します。

1. 対話モード・レポートの属性ページにアクセスします。「コンポーネント・ビューでの対話モード・レポートの属性ページへのアクセス」を参照してください。
対話モード・レポートの属性ページが表示されます。

2. 「検索バー」までスクロールします。

3. 「検索バーを含める」から、「いいえ」を選択します。

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

10.5.5.4 「アクション」メニューの「ダウンロード」オプションの構成

「アクション」メニューに「ダウンロード」オプションを追加すると、ユーザーが対話モード・レポートをカンマ区切りファイル(CSV)形式、HTML、Microsoft Excel (XLS)形式、Adobe Portable Document Format (PDF)、Microsoft Wordリッチ・テキスト形式(RTF)、または電子メール添付のHTMLとしてダウンロードできます。

- ダウンロード形式の有効化

- CSVダウンロードの有効化

- 電子メール・ダウンロードの有効化

10.5.5.4.1 ダウンロード形式の有効化

ダウンロード形式を構成するには、次のステップを実行します。

1. 対話モード・レポートの属性ページにアクセスします。「コンポーネント・ビューでの対話モード・レポートの属性ページへのアクセス」を参照してください。
対話モード・レポートの属性ページが表示されます。

2. 「検索バー」までスクロールします。

1. 「検索バーを含める」で、「はい」を選択し、「アクション・メニュー」を選択します。

2. 「アクション・メニューに含める」で、「ダウンロード」を選択します。

ヒント:
「ダウンロード」機能を無効にすると、「アクション」メニューに「ダウンロード」メニューが表示されなくなるだけです。ユーザーが完全にデータをダウンロードできなくするには、「ダウンロード形式」セクションのすべてのチェック・ボックスを選択解除します。

3. 「ダウンロード」までスクロールします。

4. ダウンロード形式を選択します。オプションは次のとおりです。

- CSV。「CSVダウンロードの有効化」を参照してください。

- HTML。

- 電子メール。「電子メール・ダウンロードの有効化」を参照してください。

- XLS。

- PDF。「PDFへのレポート出力について」を参照してください。

- RTF。

ヒント:
「アクション」メニューに「ダウンロード」オプションが表示されるのは、ファイル形式を選択した場合のみです。「インスタンス管理」内でレポート・サーバーが定義されていない場合は、特定のオプションが表示されません。詳細は、『Oracle Application Express管理ガイド』のレポート出力の構成に関する説明を参照してください。

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

10.5.5.4.2 CSVダウンロードの有効化

CSVダウンロードを有効にするには、次のステップを実行します。

1. グローバリゼーション属性の編集ページで「CSV出力」オプションを有効にします。「グローバリゼーション属性のページへのアクセス」および「自動CSVエンコーディング」を参照してください。

2. 対話モード・レポートの属性ページにアクセスします。「コンポーネント・ビューでの対話モード・レポートの属性ページへのアクセス」を参照してください。
対話モード・レポートの属性ページが表示されます。

3. 「検索バー」までスクロールします。

1. 「検索バーを含める」で、「はい」を選択し、「アクション・メニュー」を選択します。

2. 「アクション・メニューに含める」で、「ダウンロード」を選択します。

4. 「ダウンロード」までスクロールします。

5. 「ダウンロード形式」から、「CSV」を選択します。

ヒント:
「アクション」メニューに「ダウンロード」オプションが表示されるのは、ファイル形式を選択した場合のみです。

6. 「CSVセパレータ」で、列セパレータを定義します。値が入力されていない場合は、現行のNLS設定に応じて、カンマまたはセミコロンが使用されます。

7. 「CSV囲み文字」にデリミタ文字を入力します。この文字は、データ値の開始境界および終了境界を区切ります。デフォルトのデリミタは二重引用符(" ")です。

8. 「ファイル名」にダウンロードするドキュメントのファイル名を入力します。ファイル拡張子は指定しないでください。拡張子は自動的に追加されます。これを空白のままにすると、リージョン名がファイル名として使用されます。

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

10.5.5.4.3 電子メール・ダウンロードの有効化

特定の電子メール・アドレスに静的HTMLレポートを送信するように「ダウンロード」オプションを構成します。

ヒント:
電子メール・ダウンロードは、認証済ページでのみサポートされています。公開ページで電子メール・ダウンロードを有効にする場合、「ダウンロード」ダイアログには電子メール・ダウンロード・オプションは表示されません。

電子メール・ダウンロードを有効にするには、次のステップを実行します。

1. Oracle Application Express管理者は、インスタンス・レベルで電子メールを構成する必要があります。Oracle Application Express管理ガイドの「メールの構成」を参照してください。

2. 対話モード・レポートの属性ページにアクセスします。「コンポーネント・ビューでの対話モード・レポートの属性ページへのアクセス」を参照してください。
対話モード・レポートの属性ページが表示されます。

3. 「検索バー」までスクロールします。

1. 「検索バーを含める」で、「はい」を選択し、「アクション・メニュー」を選択します。

2. 「アクション・メニューに含める」で、「ダウンロード」を選択します。

4. 「ダウンロード」までスクロールします。

5. 「ダウンロード形式」から、「電子メール」を選択します。

ヒント:
「アクション」メニューに「ダウンロード」オプションが表示されるのは、ファイル形式を選択した場合のみです。

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

注意:
電子メール・ダウンロードから送信される電子メールには、電子メールの送信者を識別するシステム生成電子メール署名が含まれています。この署名は削除できません。

関連項目:
「対話モード・レポートからの電子メール送信について」

10.5.6 コンポーネント・ビューでのリンク列の管理

対話モード・レポートの左側には、「リンク列」が表示されます。この項では、単一行ビュー、カスタム・ターゲットにリンクするようにリンク列を構成する方法またはレポートからリンク列を除外する方法について説明します。

- 単一行ビューへのリンク

- 特定のページへのリンク

- URLへのリンク

- リンク列の除外

ヒント:
エンド・ユーザーはリンク列のソート、非表示、移動を行うことはできず、リンク列は列属性ページに定義されている標準の列リンクとは関係ありません。

10.5.6.1 単一行ビューへのリンクの設定

単一行ビューにリンクするには、次のステップを実行します。

1. 対話モード・レポートの属性ページにアクセスします。「コンポーネント・ビューでの対話モード・レポートの属性ページへのアクセス」を参照してください。
対話モード・レポートの属性ページが表示されます。

2. 「リンク列」までスクロールします。

3. 「リンク列」で、「単一行ビューへのリンク」を選択します。

4. 「単一行ビュー」で、適切なオプションを選択します。

- NULL値の除外を許可: NULL値の列を除外します。

- 表示列を許可: レポートに表示されている列のみを表示します。

5. 「一意に行を識別する基準」で、「行ID」または「一意列」を選択します。
「一意列」を選択した場合、「一意列」フィールドに列を指定します。

6. 「リンク・アイコン」で、指定されたアイコンを使用するか、新しいイメージを指定します。

7. (オプション)「リンク属性」で、<a href= >タグに含める追加の列リンク属性(リンク・ターゲット、クラス、スタイルなど)を指定します。

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

ヒント:
対話モード・レポートが単一行ビューにリンクされており、リンク・アイコンにALTテキストがないか、ALTテキストが空である場合、レポートにアクセスできるようにするためにalt="単一行ビュー"が自動的に含められます。この動作を上書きするには、意味のあるALTテキストを含めてください。

10.5.6.2 特定のページへのリンク

特定のページにリンクするには、次のステップを実行します。

1. 対話モード・レポートの属性ページにアクセスします。「コンポーネント・ビューでの対話モード・レポートの属性ページへのアクセス」を参照してください。
対話モード・レポートの属性ページが表示されます。

2. 「リンク列」までスクロールします。

3. 「リンク列」で、「カスタム・ターゲットへのリンク」を選択します。

4. 「リンク・アイコン」で、アイコンを選択します。

5. (オプション)「リンク属性」で、<a href= >タグに含める追加の列リンク属性(リンク・ターゲット、クラス、スタイルなど)を指定します。

6. 「ターゲット」で、「このアプリケーションのページ」を選択します。

7. 「ページ」で、ターゲットのページ番号を選択します。このページのページ区切りをリセットするには、「ページ区切りのリセット」を選択します。

8. 「リクエスト」で、使用するリクエストを指定します。

9. 「キャッシュのクリア」で、キャッシュをクリアするページ(ページ番号)を指定します。ページ番号をカンマで区切ってリストすることによって、複数のページを指定できます。「対話モード・レポートへのリンクの設定」を参照してください。

10. 「名前」および「値」で、特定のアイテムのセッション・ステートを指定します。

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

10.5.6.3 URLへのリンクの設定

URLにリンクするには、次のステップを実行します。

1. 対話モード・レポートの属性ページにアクセスします。「コンポーネント・ビューでの対話モード・レポートの属性ページへのアクセス」を参照してください。
対話モード・レポートの属性ページが表示されます。

2. 「リンク列」までスクロールします。

3. 「リンク列」で、「カスタム・ターゲットへのリンク」を選択します。

4. 「リンク・アイコン」で、アイコンを選択します。

5. (オプション)「リンク属性」で、<a href= >タグに含める追加の列リンク属性(リンク・ターゲット、クラス、スタイルなど)を指定します。

6. 「ターゲット」から「URL」を選択します。

7. 「URL」で、該当するアドレスを入力します。

8. 「チェックサム」で、次のいずれかを選択します。

- デフォルトの使用

- アプリケーション・レベル - すべてのユーザーが再利用可能なリンク

- ユーザー・レベル - 現行のユーザーが再利用可能なリンク

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

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

10.5.6.4 リンク列の除外

列リンクを除外するには、次のステップを実行します。

1. 対話モード・レポートの属性ページにアクセスします。「コンポーネント・ビューでの対話モード・レポートの属性ページへのアクセス」を参照してください。
対話モード・レポートの属性ページが表示されます。

2. 「リンク列」までスクロールします。

3. 「リンク列」で、「リンク列の除外」を選択します。

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

10.5.7 対話モード・レポートでの列リンクの作成

レポートからアプリケーション内の別のページまたはURLへのリンクを作成するには、「列属性」を使用します。

- 別のページへの列リンクの作成

- URLへの列リンクの作成

10.5.7.1 別のページへの列リンクの作成

別のページへの列リンクを作成するには、次のステップを実行します。

1. 対話モード・レポートの属性ページにアクセスします。「コンポーネント・ビューでの対話モード・レポートの属性ページへのアクセス」を参照してください。
対話モード・レポートの属性ページが表示されます。

2. 「列属性」で、リンクを含む列を指定します。

3. 列名の横にある「編集」アイコンをクリックします。
列属性ページが表示されます。

4. 「列リンク」までスクロールします。

5. 別のページへの列リンクを作成するには、次のステップを実行します。

1. 「ターゲット」で、「このアプリケーションのページ」を選択します。

2. (オプション)「リンク属性」で、<a href= >タグに含める追加の列リンク属性(リンク・ターゲット、クラス、スタイルなど)を指定します。

3. 「リンク・テキスト」で、リンクとして表示されるテキストを入力するか、イメージ・タグを指定するか、またはデフォルトのイメージのリストから選択します。

4. 「ページ」で、ターゲット・ページ番号を指定します。このページのページ区切りをリセットするには、「ページ区切りのリセット」を選択します。

5. 「リクエスト」で、使用するリクエストを指定します。

6. 「キャッシュのクリア」で、キャッシュをクリアするページ(ページ番号)を指定します。ページ番号をカンマで区切ってリストすることによって、複数のページを指定できます。

7. 特定のアイテムのセッション・ステートを指定するには、「名前」フィールドおよび「値」フィールドを使用します。

8. 「チェックサム」で、次のいずれかを選択します。

- デフォルトの使用

- アプリケーション・レベル - すべてのユーザーが再利用可能なリンク

- ユーザー・レベル - 現行のユーザーが再利用可能なリンク

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

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

10.5.7.2 URLへの列リンクの作成

URLへの列リンクを作成するには、次のステップを実行します。

1. 対話モード・レポートの属性ページにアクセスします。「コンポーネント・ビューでの対話モード・レポートの属性ページへのアクセス」を参照してください。
対話モード・レポートの属性ページが表示されます。

2. 該当する列の横にある「編集」アイコンをクリックして、列属性ページにアクセスします。
列属性ページが表示されます。

3. 「列リンク」までスクロールします。

4. 「列リンク」で、次のように指定します。

1. 「ターゲット」から「URL」を選択します。

2. 「リンク・テキスト」で、リンクとして表示されるテキストを入力し、置換文字列を選択します。

3. (オプション)「リンク属性」で、<a href= >タグに含める追加の列リンク属性(リンク・ターゲット、クラス、スタイルなど)を指定します。

4. 「URL」で、該当するアドレスを入力します。

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

10.5.8 対話モード・レポートの条件付き表示

リージョンの編集ページでリージョン属性を編集することによって、対話モード・レポートを条件付きで表示するように指定できます。

対話モード・レポートを条件付きで表示するには、次のステップを実行します。

1. 適切なページにナビゲートします。「コンポーネント・ビューでのページの表示」を参照してください。

2. 「リージョン定義」にアクセスします。「リージョン」で、リージョン名を選択します。
リージョン定義が表示されます。

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

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

5. 表示されるフィールドに式を入力します。

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

ヒント:
Asynchronous JavaScript and XML (AJAX)が対話モード・レポート全体で使用されています。AJAXは非同期であるため、条件付き表示用に評価される値はセッション内に含まれている必要があります。指定した値に基づいて対話モード・レポートを条件付きで表示するには、:REQUEST値のかわりにページ・アイテムを使用します。条件付き表示で:REQUESTを使用した場合、対話モード・レポート機能が正しく動作しません。

10.5.9 対話モード・レポートでのLOVとしての列定義

対話モード・レポートでは、LOVを使用して組込みフィルタ・ツールの速度を向上できます。

レポート列をLOVとして定義するには、次のステップを実行します。

1. 対話モード・レポートの属性ページにアクセスします。「コンポーネント・ビューでの対話モード・レポートの属性ページへのアクセス」を参照してください。
対話モード・レポートの属性ページが表示されます。

2. 該当する列の横にある「編集」アイコンをクリックして、列属性ページにアクセスします。
列属性ページが表示されます。

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

4. 「LOV」の「列フィルタ・タイプ」で、LOVをレポートの列リストのフィルタとして作成する方法を指定します。使用可能なオプションは次のとおりです。

- なし: LOVのフィルタが無効になります。

- 列タイプに基づくデフォルト: STRINGおよびNUMBERの列では固有の列値からLOVを導出します。DATE列では、事前定義された日付範囲からLOVを導出します。

- 「単語を含む」のフィルタ処理に定義済LOVを使用: 定義済LOVのSQL問合せからLOVを導出してcontainsフィルタを作成します。

- 完全一致のフィルタ処理に名前付きLOVを使用: 名前付きLOVからLOVを導出してequalフィルタを作成します。

- 「単語を含む」のフィルタ処理に名前付きLOVを使用: 名前付きLOVからLOVを導出してcontainsフィルタを作成します。

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

10.5.10 対話モード・レポートでの列の書式設定

対話モード・レポートでHTML式を使用して、列の表示をさらにカスタマイズできます。

列の書式設定を定義するには、次の手順を実行します。

1. 対話モード・レポートの属性ページにアクセスします。「コンポーネント・ビューでの対話モード・レポートの属性ページへのアクセス」を参照してください。
対話モード・レポートの属性ページが表示されます。

2. 該当する列の横にある「編集」アイコンをクリックして、列属性ページにアクセスします。

3. 「列の書式」までスクロールします。

4. 列に表示するHTML式を指定します。列名に置換文字列を使用して、HTMLで列値を表示します。次に例を示します。
例1:

<span style="background-color: yellow; color: red;">#EMPLOYEE_STATUS</span>

例2:

<span class="#COLUMN_CLASS#">#EMPLOYEE_STATUS#</span>

前述の例では、この例の#COLUMN_CLASS#および#EMPLOYEE_STATUS#置換がレポートSQL問合せで選択された列です。

例3:

<img src="#IMAGE_NAME#" title="#EMPLOYEE_NAME#">

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

10.5.11 コンポーネント・ビューでのアイコン・ビューの有効化

デフォルトでは、ほとんどの対話モード・レポートはレポートとして表示されます。必要に応じて、列をアイコンとして表示できます。列をアイコンとして表示するように構成すると、「アイコンの表示」アイコンが検索バーに表示されます。

アイコン・ビューを利用するには、アイコン、ラベルおよびターゲット(つまり、リンク)を識別するために使用する列を指定します。これらの列は通常エンド・ユーザーには役立たないため、非表示になるように設定することをお薦めします。

- 対話モード・レポートへのアイコン・ビューの追加

- カスタム・アイコン・ビュー・リンクの追加

10.5.11.1 対話モード・レポートへのアイコン・ビューの追加

対話モード・レポートにアイコン・ビューを追加するには、次のステップを実行します。

1. 対話モード・レポートの属性ページにアクセスします。「コンポーネント・ビューでの対話モード・レポートの属性ページへのアクセス」を参照してください。
対話モード・レポートの属性ページが表示されます。

2. 「アイコン・ビュー」までスクロールします。

3. 「アイコン・ビューの有効化」で、「はい」を選択します。

4. 次の必須属性を指定します。

ヒント:
例を表示するには、フィールドレベル・ヘルプを参照してください。

- リンク列: アイコンのリンク・ターゲットを返す列を選択します。

- イメージ・ソース列: イメージ・ソースを返す列を指定します。

- ラベル列: イメージ・ラベルを返す列を選択します。

5. 「1行当たりの行数」で、1行当たりに表示するアイコン数を指定します。値として5を指定すると、1行当たり5つのアイコンが表示されます。

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

10.5.11.2 カスタム・アイコン・ビュー・リンクの追加

カスタム・アイコン・ビュー・リンクを追加するには、次の手順を実行します。

1. 対話モード・レポートの属性ページにアクセスします。「コンポーネント・ビューでの対話モード・レポートの属性ページへのアクセス」を参照してください。
対話モード・レポートの属性ページが表示されます。

2. 「アイコン・ビュー」までスクロールします。

3. 「カスタム・アイコン・リンクの使用」に「はい」選択します。

4. 「1行当たりの行数」で、1行当たりに表示するアイコン数を指定します。
値として5を指定すると、1行当たり5つのアイコンが表示されます。

5. 「カスタム・リンク」に、アイコン・ビューの列リンクを入力します。次の例のように、列名に置換文字列を使用します。

<a href="#ICON_LINK#"><img src="#DETAIL_IMG_NO_STYLE#" title="" alt="" width="75" height="75"><br />#PRODUCT_NAME#</a>

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

10.5.12 コンポーネント・ビューでの詳細ビューの有効化

デフォルトでは、ほとんどの対話モード・レポートはレポートとして表示されます。必要に応じて、各列の詳細を表示できます。構成すると、検索バーに「詳細の表示」アイコンが表示されます。

対話モード・レポートに詳細ビューを追加するには、次のステップを実行します。

1. 対話モード・レポートの属性ページにアクセスします。「コンポーネント・ビューでの対話モード・レポートの属性ページへのアクセス」を参照してください。
対話モード・レポートの属性ページが表示されます。

2. 「詳細ビュー」までスクロールします。

3. 「詳細ビューの有効化」で、「はい」を選択します。

4. 次の属性を指定します。

- 行の前: レポート行の前に表示するHTMLを入力します。次に例を示します。

<TABLE>

- 各行(#COLUMN_ALIAS#置換を使用): 列名および列ラベルに置換文字列を使用します。次に例を示します。

<tr><td align="right">#ENAME_LABEL#:</td><td>#ENAME#</td></tr>
<tr><td align="right">#JOB_LABEL#:</td><td>#JOB#</td></tr>

- 行の後: レポート行の後に表示するHTMLを入力します。次に例を示します。

</TABLE>

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

10.5.13 対話モード・レポートの詳細属性の構成

この項では、「対話モード・レポート」リージョンの別名の定義、保存したレポートのIDを格納する値を持つアイテムの指定、および対話モード・レポートのサブスクリプションまたは電子メール・ダウンロードの送信者アドレスの定義するように対話モード・レポートの属性ページの「拡張属性」セクションを構成する方法について説明します。

- 詳細属性の構成

- 対話モード・レポートからの電子メール送信について

10.5.13.1 詳細属性の構成

詳細属性を構成するには、次のステップを実行します。

1. 対話モード・レポートの属性ページにアクセスします。「コンポーネント・ビューでの対話モード・レポートの属性ページへのアクセス」を参照してください。
対話モード・レポートの属性ページが表示されます。

2. 詳細属性までスクロールします。
表 10-9に、使用可能な詳細属性を示します。

表10-9 詳細属性

属性

説明

リージョン別名

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

APIコールでは、別名を使用して対話モード・レポートを参照できます。たとえば、APEX_APPLICATION_PAGE_IRビューでALIAS列を問い合せることによって、INTERACTIVE_REPORT_IDを返すファンクションを記述できます。別名は、アプリケーション内で一意である必要があります。別のインスタンスに対するエクスポート操作またはインポート操作によりINTERACTIVE_REPORT_ID値は変わることがあるため、別名を使用して対話モード・レポート・リージョンを参照すると役立ちます。

レポートIDアイテム

デフォルトつまり作業ビューではなく保存されたレポートのビューにユーザーを送信できます。保存されたビューのレポートIDを保持する値のアイテムを指定します。レポートIDは、APEX_APPLICATION_PAGE_IR_RPTビューから取得できます。

電子メール送信者アドレス

電子メール・ダウンロードまたはサブスクリプションから電子メールを送信するときに送信元アドレスとしてい使用する有効な電子メール・アドレスを入力します。値には、有効な電子メールを含むリテラル文字列、アプリケーションレベルで定義したアプリケーションの電子メール送信元アドレスを返す置換構文または&APP_EMAIL.置換を使用してアプリケーションレベルで定義されたアプリケーション置換を指定できます。Examples:

john.doe@abc.com
&MY_APP_EMAIL_FROM.
&APP_EMAIL.

アイテムの置換は、電子メール・ダウンロードでのみ機能し、サブスクリプションでは機能しないため、アプリケーションまたはページレベルでのアイテムの置換の使用はお薦めしません。

ヒント: 電子メール送信者アドレスの優先順位は、次のとおりです。

レポート・レベルの電子メール送信者アドレス→アプリケーション・レベルのアプリケーションの電子メール送信元アドレス→インスタンス・レベルのデフォルトの電子メール送信元アドレス。

これらすべてがNULLの場合、電子メール送信元アドレスは、電子メール受信元アドレスと同じです。

関連項目: 「アプリケーション定義ページの編集」

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

10.5.13.2 対話モード・レポートからの電子メール送信について

次の2つの方法で、対話モード・レポートから送信された電子メールの送信元アドレスを定義できます。

- 「アプリケーション定義の編集」ページの「アプリケーションの電子メール送信元アドレス」属性でのアプリケーションレベル。「アプリケーション定義ページの編集」を参照してください。

- 「対話モード・レポートの属性」ページの「電子メール送信者アドレス」属性での対話モード・レポートレベル。「対話モード・レポートの詳細属性の構成」を参照してください。

いずれの場合も、値には、有効な電子メールを含むリテラル文字列、アプリケーションレベルで定義したアプリケーションの電子メール送信元アドレスを返す置換構文または&APP_EMAIL.置換を使用してアプリケーションレベルで定義されたアプリケーション置換を指定できます。Examples:

john.doe@abc.com
&MY_APP_EMAIL_FROM.
&APP_EMAIL.

アイテムの置換は、電子メール・ダウンロードでのみ機能し、サブスクリプションでは機能しないため、アプリケーションまたはページレベルでのアイテムの置換の使用はお薦めしません。

関連項目:
「電子メール・ダウンロードの有効化」および「置換文字列の理解」

10.5.14 対話モード・レポートへのリンクの設定

一般にページ・アイテムをレポート・パラメータとして使用するクラシック・レポートとは異なり、対話モード・レポートのデータは、宣言的なフィルタで決まります。ただし、開発者は、エンド・ユーザーに対する対話モード・レポート設定を変更することで、このレポート・パラメータを設定することができます。この設定は、エンド・ユーザーが作業中のレポートのみに影響します。保存済のレポート設定には影響しません。この項で説明する構文をURLのRequest値およびItemNamesセクションで使用して、対話モード・レポートにリンクします。

- Request構文

- Name構文およびValue構文

- ClearCache構文

- 対話モード・レポートにリンクする際の制限

- 有効なリンクの例

- 無効なリンクの例

関連項目:
「URL構文の理解」および「f?p構文を使用したページのリンクについて」

10.5.14.1 Request構文

特定の保存済レポートにリンクするには、次のRequest構文を使用します。

IR[region static ID]_<report_alias>

次に例を示します。

IR[EMP]_dept20

注意:
URLでのRequestの使用はオプションです。複数の保存済レポートにリンクするには、各Requestをカンマで区切ります。

10.5.14.2 Name構文およびValue構文

フィルタを作成するには、次のitemNames構文およびitemValues構文を使用します。

IR[region static ID]<operator>_<target column alias>

次に例を示します。

IR[EMP]C_ENAME:KING

注意:
ページ上の対話モード・レポート・リージョンが1つのみの場合、itemNameはリージョンの静的IDで完全修飾する必要はありません。演算子が定義されていない場合、等号演算子によるフィルタが追加されます。

リンク内の対話モード・レポートにフィルタを作成するには、前述のitemNames構文を使用して、URLのItem Namesセクションの対応する場所にフィルタ値を追加します。

対話モード・レポートにフィルタを含む行テキストを作成するには、Item Name構文でターゲット列の別名としてROWFILTERを使用し、URLのitemValuesにフィルタ値を追加します。リンクは、タイプがSTRINGまたはNUMBERのレポートに表示されるすべての列を検索するRow Text Containsフィルタを追加します。

次に例を示します。

IR[EMP]_ROWFILTER:SALES

有効な演算子は、次のとおりです。

- C = 含む

- EQ = 等しい(これがデフォルトです)

- GTE = 以上

- GT = 次より大きい

- LIKE = SQLのLike演算子

- LT = 次より小さい

- LTE: より小さいか、等しい

- N = NULL

- NC = 含まない

- NEQ = 等しくない

- NLIKE = 類似ではない

- NN = NULLではない

- NIN = 次に含まれない(バックスラッシュ(\)を使用したカンマ区切り値をエスケープ)

- IN = 次に含まれる(バックスラッシュ(\)を使用したカンマ区切り値をエスケープ)

- ROWFILTER = 次を含む行テキスト(これは、タイプがSTRINGまたはNUMBERのレポートに表示されるすべての列を検索します)

10.5.14.3 ClearCache構文

URLのClearCacheセクションで次の構文を使用して、対話モード・レポートのリセット、クリアまたはページ区切りのリセットを行います。

- RIR - 対話モード・レポートをリセットします。これは、エンド・ユーザーがターゲット・ページで対話モード・レポートの「アクション」メニューから「リセット」オプションを選択した場合に相当します。レポートは、開発者が指定したか、またはユーザーが保存したデフォルトのレポート設定に戻ります。

- CIR - 対話モード・レポートをクリアします。これにより、コントロール・ブレーク、集計、フラッシュバック、チャート、表示する行数、フィルタ、ハイライト、計算、グループ化、ピボットなどすべてのレポート設定がクリアされます。

- RP - 対話モード・レポートのページ区切りをリセットします。

10.5.14.4 対話モード・レポートにリンクする際の制限

対話モード・レポートにリンクする場合は、次の制限に注意してください。

1. Request値がURLで定義されていない場合、すべてのプライマリ・デフォルト・レポート設定が変更されます。

2. Requestが定義されておらず、かつ、itemNamesセクションに、リージョンの静的IDで完全修飾されたフィルタ列名が含まれていない場合、ターゲット・ページに複数の対話モード・レポート・リージョンが存在すると、エラーが発生します。

3. Request値が定義されておらず、かつ、itemNamesセクションに、リージョンの静的IDで完全修飾されたフィルタ列名が含まれていない場合、ターゲット・ページ内の対話モード・レポート・リージョンが1つのみであれば、プライマリ・デフォルト・レポートにフィルタが作成されます。

10.5.14.5 有効なリンクの例

この項では、有効なリンクの例について説明します。

有効なリンクの例1

この例には、Request値のないリンクが含まれていますが、URLのitemNamesセクションに、リージョンの静的IDで修飾されたフィルタ列が含まれています。この例では、参照されるリージョンのItem Nameのプライマリ・デフォルト・レポートにフィルタを作成しています。

f?p=&APP_ID.:2:&SESSION.::::IR[EMP]_ENAME:KING

有効なリンクの例2

以前のリリースとの下位互換性をサポートするために、この例では古い構文を使用しています。これは対話モード・レポート・リージョンが1つのページで機能します。

?p=&APP_ID.:1:&SESSION.:IR_REPORT_12345::RIR,CIR::RIR,CIR:IR_ENAME:KING

有効なリンクの例3

この例では、リンクにRequest値はありません。clear cacheセクションにはRIR、CIRまたはRPがあり、すべての対話モード・レポート・リージョンのプライマリ・デフォルト・レポートのリセット、クリアまたはページ区切りのリセットを行います。

f?p=&APP_ID.:1:&SESSION.:::RIR:

10.5.14.6 無効なリンクの例

この項では、無効なリンクの例について説明します。

無効なリンクの例1

このリンクには、Request値がなく、かつ、URLのItem Nameセクションに、リージョンの静的IDで完全修飾されたフィルタ列が含まれていません。この例では、ターゲット・ページに複数の対話モード・レポート・リージョンが存在すると、エラーが発生します。

f?p=&APP_ID.:2:&SESSION.::::ENAME:KING

無効なリンクの例2

この例には、2つのRequest値がカンマで区切られたリンクがあり、かつ、URLのItem Nameセクションに、リージョンの静的IDで完全修飾されたフィルタ列が含まれていません。この例では、フィルタを作成する必要がある場所が明確でないため、エラーが発生します。

f?p=&APP_ID.:2:&SESSION.:IR[test]_employee,IR[test2]_dept10:::ENAME:KING

無効なリンクの例3

この例では、対話モード・レポート・リージョンが複数あるページで、古いRequest値の構文を使用しています。この例ではエラーが発生します。古い構文は、対話モード・レポート・リージョンが1つの場合にのみ機能します。

f?p=&APP_ID.:2:&SESSION.:IR_REPORT_myrpt:::ENAME:KING

10.5.15 共有対話モード・レポートへのリンクの設定

この項では、URLのRequest値でIR_REPORT_[report_alias]を使用して、保存されたプライマリ・デフォルト、代替デフォルトおよびパブリック・レポートにリンクする方法について説明します。

- プライマリ・レポートへのリンクの例

- 保存済のレポートへのリンクの例

ヒント:
保存されたレポート・ページで、レポートの別名を編集したりリンク例を表示することができます。「コンポーネント・ビューでのデフォルト・レポートの別名の編集」を参照してください。

10.5.15.1 プライマリ・レポートへのリンクの例

次の各例では、プライマリ・レポート(report_alias=12345)へのリンクを設定する方法を示します。

この例では、プライマリ・レポートへのリンクを設定しています。

f?p=100:1:&APP_SESSION.:IR_REPORT_12345

この例では、プライマリ・レポートへのリンクを設定し、レポート設定のリセットおよびクリアを行っています。

f?p=100:1:&APP_SESSION.:IR_REPORT_12345::RIR,CIR:

この例では、プライマリ・レポートへのリンクを設定し、レポート設定のリセットおよびクリアを行っています。さらに、プライマリ・レポートでENAME = 'KING'フィルタを作成しています。

f?p=100:1:&APP_SESSION.:IR_REPORT_12345::RIR,CIR:IR_ENAME:KING

10.5.15.2 保存済のレポートへのリンクの例

次の各例では、保存済のレポート(report_alias=12345)へのリンクを設定する方法を示します。

この例では、保存済のレポートへのリンクを設定しています。

f?p=100:1:&SESSION.:IR_REPORT_1234

この例では、保存済のレポート12345へのリンクを設定し、レポート設定のリセットおよびクリアを行っています。

f?p=100:1:&SESSION.:IR_REPORT_12345::RIR,CIR:

この例では、保存済のレポート12345へのリンクを設定し、レポート設定のリセットおよびクリアを行っています。さらに、保存済のレポート12345でENAME = 'KING'フィルタを作成しています。

f?p=100:1:&SESSION.:IR_REPORT_12345::RIR,CIR::RIR,CIR:IR_ENAME:KING

IR_REPORT_[report_alias]リクエスト値のないURLを使用してフィルタをリセット、クリアまたは作成すると、プライマリ・レポートのフィルタがリセット、クリアまたは作成されます。たとえば、次のリンクはプライマリ・レポートに移動します。

f?p=100:1:&SESSION.:::RIR,CIR:IR_ENAME:KING

10.5.16 コンポーネント・ビューでの保存されたデフォルト対話モード・レポートの編集

この項では、開発者がデフォルト対話モード・レポートを表示および管理する方法について説明します。

- コンポーネント・ビューでのデフォルト・レポートの別名の編集

- コンポーネント・ビューでの保存されたデフォルト・レポートの削除

関連項目:
「デフォルトの対話モード・レポートの保存」および『Oracle Application Express管理ガイド』の保存された対話モード・レポートの管理に関する項

10.5.16.1 コンポーネント・ビューでのデフォルト・レポートの別名の編集

開発者は、保存されたレポート・ページで、レポートの別名を編集したり、デフォルト・レポートのリンク例を表示することができます。

デフォルト・レポートのレポートの別名を編集するには、次のステップを実行します。

1. 保存された対話モード・レポートを含む適切なページにナビゲートします。「コンポーネント・ビューでのページの表示」を参照してください。

2. 「リージョン」で、「保存されたレポート」リンクをクリックします。
保存されたレポート・ページが表示されます。

3. 「レポート別名」で、次のいずれかの操作を実行できます。

- 保存済のレポートの新しい別名を入力します。

- リンク例をコピー・アンド・ペーストして、保存済の特定のレポートへのリンクを設定します。

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

10.5.16.2 コンポーネント・ビューでの保存されたデフォルト・レポートの削除

保存されたデフォルト・レポートを削除するには、次のステップを実行します。

1. 保存された対話モード・レポートを含む適切なページにナビゲートします。「コンポーネント・ビューでのページの表示」を参照してください。

2. 「リージョン」で、「保存されたレポート」リンクをクリックします。
保存されたレポート・ページが表示されます。

3. レポートを削除するには、レポートを選択し、「チェックした項目の削除」をクリックします。

10.5.17 保存された対話モード・レポート・アクティビティの表示

開発者は、レポート属性の編集ページの「タスク」の下にある「保存されたレポート・アクティビティの表示」リンクをクリックして、保存済のレポートのアクティビティを表示できます。このリンクは、保存済のレポート(プライマリ・デフォルト・レポート以外)が存在する場合にのみ表示されます。このページを使用して、どのレポートが使用されていて、どのレポートが使用されていないかを判別できます。

保存済のレポートのアクティビティを表示するには、次のステップを実行します。

1. 対話モード・レポートの属性ページにアクセスします。「コンポーネント・ビューでの対話モード・レポートの属性ページへのアクセス」を参照してください。
対話モード・レポートの属性ページが表示されます。

2. 「タスク」リストで、「保存されたレポート・アクティビティの表示」をクリックします。

ヒント:
保存済のレポートのアクティビティは、ワークスペース管理ページから表示することもできます。ワークスペースのホームページで、「管理メニュー」をクリックして、「管理」、「アクティビティの監視」および「対話モード・レポート別」を選択します。

10.6 エンド・ユーザーとしての対話モード・レポートのカスタマイズ

ユーザーは、関心のある列の選択、フィルタの適用、ハイライト表示、ソート処理などを行って、対話モード・レポート・データのレイアウトを変更できます。また、ブレーク、集計、チャート、グループ化を定義し、ユーザー独自の計算を追加することもできます。

- 検索バーについて

- 「アクション」メニューについて

- 対話モード・レポート・フィルタの使用

- 対話モード・レポートの保存

関連項目:
「ウィザードを使用したレポートの作成」および『Oracle Application Expressエンド・ユーザー・ガイド』の「アクション」メニューを使用した対話モード・レポートのカスタマイズに関する項

10.6.1 検索バーについて

検索バーは各対話モード・レポートの上部に表示され、次の機能が含まれています。

- 検索列の選択 - このアイコンは、虫めがねに似ています。このアイコンをクリックして、検索を特定の列に絞り込みます。すべての列を検索するには、「すべての列」を選択します。

- テキスト領域 - 大/小文字を区別しない検索基準(ワイルドカード文字を含む)を入力し、「実行」をクリックします。

- 「実行」ボタン - 検索を実行します。

- レポート - 代替のデフォルトおよび保存済のプライベートまたはパブリック・レポートが表示されます。「対話モード・レポートの保存」を参照してください。

- アイコンの表示 - デフォルト・レポートの「アイコンの表示」、「レポートの表示」および「詳細の表示」を切り替えます(有効にしている場合)。「チャート」ビューおよび「グループ化」ビューを含めることもできます(定義している場合)。

- 「アクション」メニュー - 「アクション」メニューは対話モード・レポートのカスタマイズに使用します。「「アクション」メニューについて」を参照してください。

関連項目:
「対話モード・レポートの検索バーのカスタマイズ」および「コンポーネント・ビューでの検索バーおよび「アクション」メニューの管理」

10.6.2 「アクション」メニューについて

「アクション」メニューのオプションを選択することによって、対話モード・レポートをカスタマイズできます。

ヒント:
この項で説明するオプションすべてが各「アクション」メニューで使用できるということではありません。開発者は、表示するオプションをカスタマイズできます。「ページ・デザイナでの「アクション」メニューのカスタマイズ」および「検索バーおよび「アクション」メニューのカスタマイズ」を参照してください。

「アクション」メニューは、検索バーの「実行」ボタンの右に表示されます。このメニューを使用して、対話モード・レポートをカスタマイズします。

「アクション」メニューには、次のオプションがあります。

- 「列の選択」は、表示する列と順序を指定します。

- 「フィルタ」は、問合せでWHERE句を追加または編集することで、レポートの焦点を絞ります。

- 「ページごとの行数」は、現在のレポートに表示する行数を決定します。

- 「書式」には、次のサブメニューがあります。

- ソート: ソートする列を変更し、昇順でソートするか降順でソートするかを決定します。

- コントロール・ブレーク: 1つ以上の列にブレーク・グループを作成します。これにより、対話モード・レポートから列が抽出され、マスター・レコードとして表示されます。

- ハイライト: フィルタ基準を満たす行をハイライトするフィルタを定義します。

- 計算: 計算した列をレポートに追加できます。

- 集計: 列に対して算術計算を実行できます。

- チャート: レポート・データをチャートとして表示します。

- グループ化: 結果セットを1つ以上の列でグループ化し、列に対して算術計算を実行できます。

- ピボット: ピボット・レポートの定義を可能にします。

- 「フラッシュバック」: データを過去のある時点の状態で表示できます。

- 「レポートの保存」: 対話モード・レポートを保存します。ユーザーは、各自のユーザー資格証明に応じて、様々なレポートを保存できます。

- 「リセット」: レポートをデフォルトのレポート設定にリセットできます。

- 「ヘルプ」: 対話モード・レポートのカスタマイズ方法の説明を表示します。

- 「ダウンロード」: レポートをダウンロードできます。使用可能なダウンロード形式は、ご使用のインストールとレポート定義によって異なります。

- 「サブスクリプション」: 対話モード・レポートを電子メールで受け取ることができます。

関連項目:
『Oracle Application Expressエンド・ユーザー・ガイド』の「アクション」メニューを使用した対話モード・レポートのカスタマイズに関する項

10.6.3 対話モード・レポート・フィルタの使用

対話モード・レポートをカスタマイズするとき、検索バーとレポートの間にフィルタが表示されます。次の図は、2つのフィルタ「プロジェクト = 'Bug Tracker'」および「ステータス = 'On-Hold'」が表示されているレポートを示しています。

デフォルトでは、複数のフィルタが上下に積み上げられ、水平に表示されます。表示する情報の量を最小化してフィルタの詳細を非表示にするには、フィルタ名の左側の矢印をクリックします。次の図は、「プロジェクト」および「ステータス」のフィルタ詳細が非表示になった、同じレポートを示しています。

対話モード・レポートのその他の主要機能は、次のとおりです。

- 有効化/無効化 - フィルタを有効化および無効化するには、フィルタ名の左側にあるチェック・ボックスを選択および選択解除します。

- フィルタの編集 - フィルタを編集するには、フィルタ名をクリックします。

- フィルタの削除 - フィルタを削除するには、フィルタ名の右側にある「フィルタの削除」アイコンを選択します。

10.6.4 対話モード・レポートの保存

この項では、対話モード・レポートの保存方法について説明します。すべてのユーザーは、プライベートまたはパブリック対話型モード・レポートを保存できます。ただし、プライベート・レポートを作成したユーザーのみが、そのレポートの表示、保存、名前の変更または削除を行うことができます。ただし、開発者には、最初に表示されるプライマリ・デフォルト・レポートを保存したり、代替デフォルト・レポートを作成できる追加の保存機能があります。

- ユーザー・タイプおよび使用可能な保存オプションについて

- 構成の依存関係について

- パブリックまたはプライベートの対話モード・レポートの保存

- デフォルトの対話モード・レポートの保存

- パブリックまたはプライベートの対話モード・レポートの名前変更

- パブリックまたはプライベートの対話モード・レポートの削除

関連項目:
『Oracle Application Express管理ガイド』の保存された対話モード・レポートの管理に関する項

10.6.4.1 ユーザー・タイプおよび使用可能な保存オプションについて

エンド・ユーザーは、2つの方法で対話モード・レポートを保存できます。

- パブリック・レポート(エンド・ユーザーおよび開発者)。このレポートはすべてのユーザーが表示できます。ただし、パブリック・レポートを作成したユーザーのみが、そのレポートの保存、名前の変更または削除を行うことができます。すべてのユーザーがパブリック・レポートを表示できますが、保存は新しいレポート名の下でのみ実行できます。

- プライベート・レポート(エンド・ユーザーおよび開発者)。プライベート・レポートを作成したユーザーのみが、そのレポートを表示、保存、名前変更または削除できます。

また、開発者は、次の方法で対話モード・レポートを保存することもできます。

- プライマリ・デフォルト(開発者のみ)。プライマリ・デフォルトは、最初に表示されるレポートです。プライマリ・デフォルト・レポートは、名前を変更することも、削除することもできません。

- 代替レポート(開発者のみ)。開発者は、複数のレポート・レイアウトを作成できます。代替レポートの保存、名前の変更または削除ができるのは開発者のみです。

次に、対話モード・レポートの検索バーにある「レポート」リストを示します。

この例では、2つのレポートを示します。

- デフォルト: プライマリ・レポート。これは、アプリケーション開発者によって作成される最初のレポートです。デフォルト・プライマリ・レポートの名前を変更したり削除することはできません。

- プライベート: 1。タスクのあるプロジェクト。これは、プライベート・レポートです。プライベート・レポートを作成したユーザーのみが、そのレポートを表示、保存、名前変更または削除できます。

ヒント:
保存済のレポートのアクティビティは、ワークスペース管理ページから表示することができます。ワークスペースのホームページで、「管理メニュー」をクリックして、「管理」、「アクティビティの監視」および「対話モード・レポート別」を選択します。

10.6.4.2 構成の依存関係について

「アクション」の「レポートの保存」オプションは、アプリケーション開発者のみに表示されます。

- カレント・アプリケーションに認証スキームを定義した場合。「認証によるユーザー・アイデンティティの証明」を参照してください。

- レポートの検索バーの下で、「レポートの保存」または「パブリック・レポートの保存」を選択します。「コンポーネント・ビューでの検索バーおよび「アクション」メニューの管理」を参照してください。

検索バーの「レポート」選択リストは、アプリケーション開発者がレポート属性ページの検索バーで「レポート選択リスト」を選択した場合にのみ表示されます。「コンポーネント・ビューでの検索バーおよび「アクション」メニューの管理」を参照してください。

これらのオプションの多くはデフォルトで選択されていることに注意してください。

10.6.4.3 パブリックまたはプライベートの対話モード・レポートの保存

エンド・ユーザーは、対話モード・レポートを保存し、そのレポートをパブリックまたはプライベートとして分類できます。パブリック・レポートは、すべてのユーザーが表示できます。プライベート・レポートは、そのレポートを保存したユーザーのみが表示できます。

ヒント:
パブリック・レポートを保存するには、開発者は、レポート属性ページの「アクション・メニューに含める」で「パブリック・レポートの保存」を選択する必要があります。開発者は、認可スキームを適用して、「パブリック・レポートの保存」を有効または無効にすることもできます。「コンポーネント・ビューでの検索バーおよび「アクション」メニューの管理」を参照してください。

パブリックまたはプライベートの対話モード・レポートを保存するには、次のステップを実行します。

1. 保存する対話モード・レポートを含むページに移動します。

2. レポートをカスタマイズします(たとえば、列の非表示、フィルタの追加など)。「「アクション」メニューについて」を参照してください。

3. 「アクション」メニューをクリックし、「レポートの保存」を選択します。
「レポートの保存」ダイアログが表示されます。

4. エンド・ユーザーには、次の「レポートの保存」ダイアログが表示されます。

「レポートの保存」で、次の項目を指定します。

1. 名前: レポートの名前を入力します。

2. パブリック: レポートをすべてのユーザーが表示できるようにするには、このチェック・ボックスを選択します。レポートをプライベートにするには、このチェック・ボックスの選択を解除します。

3. 説明: 説明を入力します(オプション)。

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

5. 開発者には、次の「レポートの保存」ダイアログが表示されます。

「レポートの保存」で、次の項目を指定します。

1. 保存: 「名前付きレポートとして保存」を選択します。

2. 名前: レポートの名前を入力します。

3. パブリック: レポートをすべてのユーザーが表示できるようにするには、このチェック・ボックスを選択します。レポートをプライベートにするには、このチェック・ボックスの選択を解除します。

ヒント:
「パブリック」チェック・ボックスは、「パブリック・レポートの保存」レポート属性を有効にしている場合にのみ表示されます。

4. 説明: 説明を入力します(オプション)。

5. 「適用」をクリックします。

10.6.4.4 デフォルトの対話モード・レポートの保存

開発者は、プライマリおよび代替の2つのデフォルト対話モード・レポートを保存できます。両方のレポートは、検索バーの「レポート」リストに表示されます。ただし、プライマリ・デフォルト・レポートの名前を変更したり削除することはできません。

デフォルトの対話モード・レポートを保存するには、次のステップを実行します。

1. レポートを開発者として実行します。

2. レポートをカスタマイズします(たとえば、列の非表示、フィルタの追加など)。「「アクション」メニューについて」を参照してください。

3. 「アクション」メニューをクリックし、「レポートの保存」を選択します。
「レポートの保存」ダイアログが表示されます。

4. 「保存」から「デフォルトのレポート設定として保存」を選択します。
「デフォルト・レポートの保存」ダイアログが表示されます。

5. 「デフォルト・レポート・タイプ」で、次のいずれかを選択します。

- 主: このレポートは、ページの実行時にプライマリ・レポートとして表示されます。

- 代替: このレポートは、検索バーの「レポート」リストに代替オプションとして表示されます。「代替」を選択した場合、名前を入力します。

6. 「適用」をクリックします。

10.6.4.5 パブリックまたはプライベートの対話モード・レポートの名前変更

パブリックまたはプライベートの対話モード・レポートを名前変更するには、次の手順を実行します。

1. レポートを開発者として実行します。

2. 名前変更するパブリックまたはプライベートの対話モード・レポートを選択します。

3. 保存されたレポートのリンクをクリックします。

4. 「レポートの名前変更」ダイアログで、属性を編集して(新しい名前を入力するなど)、「適用」をクリックします。

10.6.4.6 パブリックまたはプライベートの対話モード・レポートの削除

パブリックまたはプライベートの対話モード・レポートを削除するには、次のステップを実行します。

1. レポートを開発者として実行します。

2. レポート名のリンクの横にある「レポートの削除」アイコンをクリックします。

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

10.6.4.7 対話モード・レポートのエクスポートについて

アプリケーションをエクスポートすると、プライマリ・デフォルト、代替デフォルト、パブリックのレポートがデフォルトで含まれます。エクスポート・プロセス中に「プライベート対話モード・レポート」で「はい」を選択して、パーソナル・レポートを含めるように指定することもできます。「アプリケーションのエクスポート」を参照してください。

10.7 ページ・デザイナでのクラシック・レポートの編集

この項では、開発者がクラシック・レポートを編集する方法について説明します。レポート属性ページを使用すると、開発者はクラシック・レポートのレポート・レイアウト、ページ区切り、列ソート、エラー・メッセージ、エクスポート・リンクおよび列ブレークを制御できます。

ヒント:
Oracle Application Expressリリース3.1に対話モード・レポートが追加されたため、以前のレポート・タイプはすべてクラッシック・レポートとして扱われます。

関連項目:
「ページ・デザイナでのページの管理」および『Oracle Application Express APIリファレンス』のAPEX_IRに関する項

- ページ・デザイナでのクラシック・レポート属性の編集

- ページ・デザイナでのクラシック・レポート・レイアウトの変更

- ページ・デザイナでのクラッシック・レポートのページ区切りの制御

- ページ・デザイナでのクラシック・レポートの列ソートの有効化

- ページ・デザイナでのクラシック・レポートへのダウンロード・リンクの追加

- ページ・デザイナでのクラシック・レポートのCSV出力オプションの有効化

- ページ・デザイナでのXMLファイルまたはCSVファイル・エクスポートのサポートの追加

- ページ・デザイナでのクラシック・レポートの列リンクの作成

- ページ・デザイナでのクラシック・レポートの更新可能な列の定義

- ページ・デザイナでのクラシック・レポートのLOVとしての列定義

- ページ・デザイナでのクラシック・レポートの列の表示条件の制御

- ページ・デザイナでのクラッシック・レポートの列ブレークの制御

10.7.1 ページ・デザイナでのクラシック・レポート属性の編集

この項では、ページ・デザイナでレポート属性を編集することによってクラシック・レポートをカスタマイズする方法について説明します。

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

1. ページ・デザイナで、クラシック・レポートを含むページを表示します。「ページ・デザイナでのページの表示」を参照してください。
ページ・デザイナが表示されます。

2. 「レンダリング」ツリーで、レポートを含むリージョンを展開し、「属性」ノードを選択します

プロパティ・エディタにレポート属性が表示されます。

属性は、機能グループに編成されます。必要な属性は、属性ラベルの1つ上の左上隅に赤い三角形で表示されます。

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

ヒント:
表示する情報の量を制御するには、「共通の表示」、「すべて表示」、「すべて閉じる」および「すべて開く」ボタンをクリックします。

4. ヘルプを表示するには、属性を選択して「ヘルプ」タブをクリックします。「ヘルプ」ペインをアクティブ化すると、別の属性を選択するたびに表示されるコンテンツが変わります。

5. 変更を保存するには、「保存」をクリックします。ページを保存して実行するには、「ページの保存と実行」をクリックします。

10.7.2 ページ・デザイナでのクラシック・レポート・レイアウトの変更

レポート属性ページの「列属性」セクションを使用すると、レポート・レイアウトを詳細に制御できます。たとえば、これらの属性を使用して、列ヘッダー・テキストの変更、列の位置の変更、列の非表示化、列の合計の作成、またはソート順序の選択を行うことができます。

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

1. ページ・デザイナでページを表示します。「ページ・デザイナでのページの表示」を参照してください。
ページ・デザイナが表示されます。

2. 「レンダリング」ツリーで、リージョンを見つけて「列」ノードを展開します。
「レンダリング」ツリーに列が表示されます。

3. 編集する列を選択します。
プロパティ・エディタにその列の属性が表示されます。

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

ヒント:
表示する情報の量を制御するには、「共通の表示」、「すべて表示」、「すべて閉じる」および「すべて開く」ボタンをクリックします。

表10-10に、レポート列の基本的な編集操作を示します。

表10-10 クラシック・レポートのレポート列の基本的な編集操作

説明

開発者アクション

列を非表示にします。

「タイプ」で、「非表示列」を選択します。

列ヘッダー・テキストを編集します。

「ヘッダー」で、「ヘッダー」および「位置合せ」を編集します。

列ヘッダー・テキストの位置合せを変更します。

「ヘッダー」で、「位置合せ」から新しく選択します。

列の表示順序を変更します。

「レイアウト」で、「順序」を編集します。

一意のソート順序を有効にします。

「ソート」の「ソート可能」で、「はい」をクリックして「デフォルト順序」を選択します。

任意の数の列をソート可能にできます。ただし、1つ以上の列にソート順序が定義されている必要があります。

列の合計を有効にします。

「詳細」の「合計の計算」で、「はい」を選択します。

5. ヘルプを表示するには、属性を選択して「ヘルプ」タブをクリックします。「ヘルプ」ペインをアクティブ化すると、別の属性を選択するたびに表示されるコンテンツが変わります。

6. 変更を保存するには、「保存」をクリックします。ページを保存して実行するには、「ページの保存と実行」をクリックします。

10.7.3 ページ・デザイナでのクラッシック・レポートのページ区切りの制御

この項では、クラシック・レポートでページ区切りを制御する方法について説明します。

- クラシック・レポートでのページ区切りの制御について

- クラシック・レポートのページ区切り属性の編集

10.7.3.1 クラシック・レポートでのページ区切りの制御について

クラシック・レポートで、レポート・ページ区切りを制御する方法を次に示します。

- ページ区切り置換文字列をレポート・テンプレートに含める方法

- レポート属性ページの「レイアウトおよびページ区切り」セクションから選択する方法

レポート属性ページの「ページ区切り」属性から選択することによって、ページ区切りの表示方法を制御します。

10.7.3.2 クラシック・レポートのページ区切り属性の編集

クラッシック・レポートのページ区切りを制御するには、次のステップを実行します。

1. クラシック・レポートの属性のページにアクセスします。「ページ・デザイナでのクラシック・レポート属性の編集」を参照してください。
右の列のプロパティ・エディタにレポート属性が表示されます。

2. 「ページ区切り」を見つけて展開します。

3. 「ページ区切り」で、次の属性を編集します。

1. タイプ - このレポートのページ区切りタイプを選択します。通常、結果のサブセットのみがレポートに当座表示されます。ページ区切りによって、結果セット内の行数および現在の位置に関する情報が提供されます。また、次のページまたは前のページへのナビゲートに使用するリンクまたはボタンのスタイルも定義されます。

2. 表示位置 - レポートのページ区切りの表示位置を選択します。

3. 部分ページ・リフレッシュ - 「部分ページ・リフレッシュ」(PPR)を使用してレポート表示を更新するかどうかを指定します。

4. ヘルプを表示するには、属性を選択して「ヘルプ」タブをクリックします。「ヘルプ」ペインをアクティブ化すると、別の属性を選択するたびに表示されるコンテンツが変わります。

5. 変更を保存するには、「保存」をクリックします。ページを保存して実行するには、「ページの保存と実行」をクリックします。

10.7.4 ページ・デザイナでのクラシック・レポートの列ソートの有効化

レポート属性ページで列ソートを有効にできます。

列ソートを有効にするには、次のステップを実行します。

1. ページ・デザイナでページを表示します。「ページ・デザイナでのページの表示」を参照してください。
ページ・デザイナが表示されます。

2. 「レンダリング」ツリーで、リージョンを見つけて「列」ノードを展開します。
「レンダリング」ツリーに列が表示されます。

3. 編集する列を選択します
プロパティ・エディタにその列の属性が表示されます。

ヒント:
表示する情報の量を制御するには、「共通の表示」、「すべて表示」、「すべて閉じる」および「すべて開く」ボタンをクリックします。

4. 「ソート」を見つけて展開します。次の属性を編集します。

1. デフォルト順序 - この列のソート順序を選択します。正しい順序でレポート出力するには、各列に一意の順序を持たせます。

2. ソート可能 - ソートを有効化するには、「はい」を選択します。「はい」を選択すると、エンド・ユーザーがレポートでこの列をソートできます。

5. 昇順イメージ属性および降順イメージ属性を指定するか、または「デフォルトの設定」をクリックします。

6. 変更を保存するには、「保存」をクリックします。ページを保存して実行するには、「ページの保存と実行」をクリックします。

ヒント:
レポートの最初および最後にNULL値を含む列を表示する場合は、列のソートを有効にする必要があります。「NULLのソート」属性の詳細は、「クラッシック・レポートのページ区切りの制御」を参照してください。

10.7.5 ページ・デザイナでのクラシック・レポートへのダウンロード・リンクの追加

レポート内にリンクを作成して、ユーザーがレポートをカンマ区切りファイル(.csv)としてエクスポートできるようにします。CSVリンクをレポートに追加するには、CSV出力オプションを有効にする必要があります。CSV出力オプションを使用する際、レポート・テンプレートは重要ではありません。CSVリンクは、CSVエクスポート置換文字列が定義されていればどのレポート・テンプレートに追加することもできます。

関連項目:
「自動CSVエンコーディング」

10.7.6 ページ・デザイナでのクラシック・レポートのCSV出力オプションの有効化

CSV出力の有効化オプションを使用するには、次のステップを実行します。

1. クラシック・レポートの属性のページにアクセスします。「ページ・デザイナでのクラシック・レポート属性の編集」を参照してください。
右の列のプロパティ・エディタにレポート属性が表示されます。

2. 「ダウンロード」を見つけて展開します。

ヒント:
表示する情報の量を制御するには、「共通の表示」、「すべて表示」、「すべて閉じる」および「すべて開く」ボタンをクリックします。

3. 「ダウンロード」で、次の属性を編集します。

1. CSVエクスポートの有効化 - エンド・ユーザーがレポート・コンテンツをCSVファイルにダウンロードできるかどうかを指定します。CSVダウンロードを有効にするには、#CSV_LINK#置換文字列を持つレポート・テンプレートを使用し、このオプションを「はい」に設定する必要があります。

2. CSVセパレータ - 列セパレータを入力します。値が入力されていない場合は、現行のNLS設定に応じて、カンマまたはセミコロンが使用されます。

3. CSV囲み文字 - データ値の開始境界および終了境界を区切るデリミタ文字を入力します。デフォルトのデリミタは二重引用符です。

4. リンク・テキスト - CSVダウンロードを起動するリンクのテキストを指定します。

5. ファイル名 - CSVダウンロード・ファイルの名前を指定します。名前を指定しないと、拡張子.csvが付いたリージョン名が使用されます。

4. 変更を保存するには、「保存」をクリックします。ページを保存して実行するには、「ページの保存と実行」をクリックします。

10.7.7 ページ・デザイナでのXMLファイルまたはCSVファイル・エクスポートのサポートの追加

レポート・テンプレートを選択することで、XMLまたはCSVとしてレポートをエクスポートする操作のサポートを追加できます。

レポートをファイルとしてエクスポートするには、次のステップを実行します。

1. クラシック・レポートの属性のページにアクセスします。「ページ・デザイナでのクラシック・レポート属性の編集」を参照してください。
右の列のプロパティ・エディタにレポート属性が表示されます。

2. 「外観」を見つけて展開します。

ヒント:
表示する情報の量を制御するには、「共通の表示」、「すべて表示」、「すべて閉じる」および「すべて開く」ボタンをクリックします。

3. 「外観」で、次を編集します。

1. テンプレート・タイプ - 「事前定義」を選択します。

2. テンプレート - 「XML」または「CSV」を選択します。
「XML」を選択すると、Application Expressエンジンでページがレンダリングされなくなり、コンテンツがXMLファイルにダンプされます。

4. 変更を保存するには、「保存」をクリックします。ページを保存して実行するには、「ページの保存と実行」をクリックします。

10.7.8 ページ・デザイナでのクラシック・レポートの列リンクの作成

レポートからアプリケーション内の別のページまたはURLへのリンクを作成するには、「列リンク」属性を使用します。

別のページへの列リンクを作成するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。「ページ・デザイナでのページの表示」を参照してください。
ページ・デザイナが表示されます。

2. 「レンダリング」ツリーで、リージョンを見つけて「列」ノードを展開します。
「レンダリング」ツリーに列が表示されます。

3. 編集する列を選択します
プロパティ・エディタにその列の属性が表示されます。

4. 「指定」を見つけて展開します。「タイプ」から、「リンク」を選択します。

5. 「リンク」を見つけて展開し、「リンクが定義されていません」をクリックします。
「リンク・ビルダー - ターゲット」ダイアログが表示されます。

6. 別のページへのリンクを作成するには、「リンク・ビルダー - ターゲット」ダイアログで次のステップを実行します。

1. タイプ: 「このアプリケーションのページ」を選択します。

2. ページ: ターゲット・ページ番号を指定します。

3. アイテムの設定: 「名前」および「値」を選択して、アイテムのセッション・ステートを指定します。

4. セッション・ステートのクリア、キャッシュのクリア: キャッシュをクリアするページ番号を指定します。複数ページを指定するには、ページ番号のカンマ区切りリストを入力します。

5. ページ区切りのリセット: 「はい」を選択して、このページのページ区切りをリセットします。

6. 詳細、リクエスト: 使用するリクエストを指定します。

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

7. URLへのリンクを作成するには、「リンク・ビルダー - ターゲット」ダイアログで次のステップを実行します。

1. タイプ: 「URL」を選択します。

2. URL: URLアドレスを入力します。

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

8. 変更を保存するには、「保存」をクリックします。ページを保存して実行するには、「ページの保存と実行」をクリックします。

10.7.9 ページ・デザイナでのクラシック・レポートの更新可能な列の定義

列属性ページの「表形式フォームの要素」属性を編集することで更新可能な列を作成できます。Application Expressエンジンは、次の場合にのみ更新を実行できることに注意してください。

- 複数行の更新が定義されている場合。

- 更新済データを処理するためにPL/SQLプロセスが実装されている場合。

- 組込み表形式フォームの要素および表示タイプを使用している場合、レポートは、SQL問合せ(更新可能レポート)のタイプを使用して定義する必要があります。

更新可能な列属性を定義するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。「ページ・デザイナでのページの表示」を参照してください。
ページ・デザイナが表示されます。

2. 「レンダリング」ツリーで、次のステップを実行します。

1. レポートまたは表形式フォームを含むリージョンを探します。

2. 「列」ノードを展開します。

3. 更新する列を選択します。

3. プロパティ・エディタで、「指定」を展開して「タイプ」属性を編集します。
詳細は、フィールドレベル・ヘルプを参照してください。

4. 変更を保存するには、「保存」をクリックします。ページを保存して実行するには、「ページの保存と実行」をクリックします。

10.7.10 ページ・デザイナでのクラシック・レポートのLOVとしての列定義

列は、ラジオ・グループとしてレンダリングするか、静的LOV、名前付きLOVまたは問合せベースのLOVとしてレンダリングできます。たとえば、選択リストまたはポップアップLOVを使用して列をレンダリングできます。または、LOVに基づく読取り専用テキストとして列をレンダリングすることもできます。

この最後の方法は、表示参照値を作成する場合に効果的な手法であり、特に、更新できない通常のレポートで役立ちます。この方法を使用すると、SQL JOIN文を記述することなく、列の値を表示できます。

LOVとしてレポート列をレンダリングするには、次のステップを実行します。

1. ページ・デザイナでページを表示します。「ページ・デザイナでのページの表示」を参照してください。
ページ・デザイナが表示されます。

2. 「レンダリング」ツリーで、次のステップを実行します。

1. レポートまたは表形式フォームを含むリージョンを探します。

2. 「列」ノードを展開します。

3. 更新する列を選択します。

3. プロパティ・エディタで、「指定」を展開し、「タイプ」を「プレーン・テキスト(LOVに基づく)」に変更します。

4. 「LOV」を展開して「タイプ」を選択し、適切なフィールドに入力します。
詳細は、フィールドレベル・ヘルプを参照してください。

5. 変更を保存するには、「保存」をクリックします。ページを保存して実行するには、「ページの保存と実行」をクリックします。

10.7.11 ページ・デザイナでのクラシック・レポートの列の表示条件の制御

「認可」属性および「条件」属性を使用すると、列の表示条件を制御できます。

認可を使用すると、事前定義されたユーザー権限に基づいて(レポート列などの)リソースへのアクセスを制御できます。たとえば、マネージャのみが特定のレポート列を表示できる認可スキームを作成できます。認可スキームを選択するには、まずその認可スキームを作成する必要があります。

条件とは、事前定義された条件タイプに基づいた列の表示の制御を可能にする論理単位です。条件は、「式」フィールドに入力した値に基づいて、trueまたはfalseと評価されます。

認可属性および条件属性を指定するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。「ページ・デザイナでのページの表示」を参照してください。
ページ・デザイナが表示されます。

2. 「レンダリング」ツリーで、レポートを含むリージョンを見つけて選択します。
プロパティ・エディタにリージョン属性が表示されます。

3. 認可スキームで列を制御する場合は、認可スキームを選択します。

1. 「セキュリティ」を見つけて展開します。

2. 認可スキーム - 選択します。

4. 条件で列を制御する場合は、条件を定義します。

1. 「条件」を見つけて展開します。

2. タイプ - 選択します。

3. 選択に応じて、指定のフィールドに式または値を入力します。

認可が正常に終了し、条件タイプの表示がtrueに評価されると、列が表示されます。

5. 変更を保存するには、「保存」をクリックします。ページを保存して実行するには、「ページの保存と実行」をクリックします。

関連項目:
「認可を介したセキュリティの提供」、「条件付きのレンダリングおよびプロセスの理解」および付録C「使用可能な条件」

10.7.12 ページ・デザイナでのクラッシック・レポートの列ブレークの制御

ブレーク書式属性を使用すると、出力する場合に、特定の列を繰り返すかどうか、および列のブレーク方法を制御できます。たとえば、レポートに、部門番号ごとに従業員情報を表示するとします。複数の従業員が同じ部門に所属している場合、部門番号が1回のみ表示されるように指定することによって、読みやすさを向上できます。

このタイプの列ブレークを作成するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。「ページ・デザイナでのページの表示」を参照してください。
ページ・デザイナが表示されます。

2. 「レンダリング」ツリーで、リージョンを見つけて「列」ノードを展開します。
「レンダリング」ツリーに列が表示されます。

3. 編集する列を選択します。
プロパティ・エディタにその列の属性が表示されます。

4. ブレーク書式を指定します。

1. 「ブレーク書式」を見つけて展開します。

2. 「ブレーク列」で、ブレーク書式に組み込むレポート列の数を選択します。列は、レポートに表示されている最初の列から始まる連続した列である必要があります。

5. 変更を保存するには、「保存」をクリックします。ページを保存して実行するには、「ページの保存と実行」をクリックします。

10.8 コンポーネント・ビューでのクラシック・レポートの編集

この項では、開発者がコンポーネント・ビューでクラシック・レポートを編集する方法について説明します。レポート属性ページを使用すると、開発者はクラシック・レポートのレポート・レイアウト、ページ区切り、列ソート、エラー・メッセージ、エクスポート・リンクおよび列ブレークを制御できます。

ヒント:
Oracle Application Expressリリース3.1に対話モード・レポートが追加されたため、以前のレポート・タイプはすべてクラッシック・レポートとして扱われます。

関連項目:
「コンポーネント・ビューでのページの管理」、「エンド・ユーザーとしての対話モード・レポートのカスタマイズ」および『Oracle Application Express APIリファレンス』のAPEX_IRに関する項

- コンポーネント・ビューでのクラシック・レポート属性の編集

- コンポーネント・ビューでのクラシック・レポート・レイアウトの変更

- コンポーネント・ビューでのクラッシック・レポートのページ区切りの制御

- コンポーネント・ビューでのクラシック・レポートの列ソートの有効化

- コンポーネント・ビューでのクラシック・レポートへのダウンロード・リンクの追加

- コンポーネント・ビューでのクラシック・レポートのCSV出力の有効化

- XMLファイルまたはCSVファイル・エクスポートのサポートの追加

- コンポーネント・ビューでのクラシック・レポートの列リンクの作成

- コンポーネント・ビューでの更新可能な列の定義

- コンポーネント・ビューでのクラシック・レポートのLOVとしての列定義

- コンポーネント・ビューでのクラシック・レポートの列の表示条件の制御

- コンポーネント・ビューでのクラッシック・レポートの列ブレークの制御

- クラシック・レポートの列の順序とリージョン・ソースの同期

10.8.1 コンポーネント・ビューでのクラシック・レポート属性の編集

この項では、レポート属性を編集することによってクラシック・レポートをカスタマイズする方法について説明します。

レポート属性ページを表示するには、次のステップを実行します。

1. コンポーネント・ビューで、レポートを含むページを表示します。「コンポーネント・ビューでのページの表示」を参照してください。
コンポーネント・ビューが表示されます。

2. レポート属性ページにアクセスするには、編集するレポート・リージョンの横にある「レポート」リンクをクリックします。

レポート属性ページが表示されます。このページは次のセクションに分かれています。

- 「列属性」はレポート・レイアウトを制御します。「コンポーネント・ビューでのクラシック・レポート・レイアウトの変更」を参照してください。

- 「レイアウトおよびページ区切り」属性はレポート・ページ区切りを制御します。「コンポーネント・ビューでのクラッシック・レポートのページ区切りの制御」を参照してください。

- 「メッセージ」の属性を使用すると、データが見つからない場合、または表示できる以上のデータが見つかった場合に表示されるメッセージを定義できます。

- 「レポートのエクスポート」属性を使用すると、レポートにダウンロード・リンクを追加するか、レポートをXMLファイルまたはCSVファイルとしてエクスポートできます。「コンポーネント・ビューでのクラシック・レポートへのダウンロード・リンクの追加」および「XMLファイルまたはCSVファイル・エクスポートのサポートの追加」を参照してください。

- 「ブレーク書式」属性を使用すると、出力時に特定の列を繰り返すかどうか、および列をどのようにブレークするかを制御できます。「コンポーネント・ビューでのクラッシック・レポートの列ブレークの制御」を参照してください。

- 「外部プロセス」属性を使用すると、後処理用のURLおよびリンク・ラベルを指定できます。

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

4. 変更を保存するには、「変更の適用」をクリックします。

10.8.2 コンポーネント・ビューでのクラシック・レポート・レイアウトの変更

レポート属性ページの「列属性」セクションを使用すると、レポート・レイアウトを詳細に制御できます。たとえば、これらの属性を使用して、列ヘッダー・テキストの変更、列の位置の変更、列の非表示化、列の合計の作成、またはソート順序の選択を行うことができます。

「列属性」にアクセスするには、次のステップを実行します。

1. クラシック・レポートの属性のページにアクセスします。「コンポーネント・ビューでのクラシック・レポート属性の編集」を参照してください。
ページ上部に「列属性」セクションがあるレポート属性ページが表示されます。

「列属性」セクションを使用して、レポート列の外観と機能を制御します。

「ヘッダー・タイプ」はレポートの見出しの生成方法を指定します。「リンク」列は列リンクが現在定義されているかどうかを示します。「編集」列は列が現在更新可能かどうかを示します。

表 10-11に、レポート列の基本的な編集操作を示します。

表 10-11 クラシック・レポートのレポート列の基本的な編集操作

説明

開発者アクション

列の表示順序を変更します。

上矢印および下矢印をクリックして、列の表示順序を変更します。

ヘッダーの位置合せを変更します。

「列の位置合せ」で、列の位置を選択します。

列ヘッダーのテキストを変更します。

「ヘッダー」で、異なるヘッダー・テキストを入力します。

表示する列を制御します。

「表示」をクリックして、列を表示させるようにします。

一意のソート順序を有効にします。

「ソート」をクリックし、「ソート順序」から順序番号を選択します。

任意の数の列をソート可能にできます。ただし、1つ以上の列にソート順序が定義されている必要があります。

列の合計を有効にします。

「合計」をクリックして、列の合計を有効にします。

列属性ページで、特定の列の属性をさらに詳細に指定できます。

2. 列属性ページにアクセスするには、該当する列の別名の横にある「編集」アイコンをクリックします。

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

関連項目:
「コンポーネント・ビューでのクラシック・レポートの列リンクの作成」、「コンポーネント・ビューでの更新可能な列の定義」、「コンポーネント・ビューでのクラシック・レポートのLOVとしての列定義」および「コンポーネント・ビューでのクラシック・レポートの列の表示条件の制御」を参照してください

10.8.3 コンポーネント・ビューでのクラッシック・レポートのページ区切りの制御

この項では、クラシック・レポートでページ区切りを制御する方法について説明します。

- クラシック・レポートでのページ区切りの制御について

- クラシック・レポートのページ区切りの制御

- クラシック・レポート内での行の後へのページ区切りの挿入

- クラシック・レポート内での行の前へのページ区切りの挿入

10.8.3.1 クラシック・レポートでのページ区切りの制御について

クラシック・レポートで、レポート・ページ区切りを制御する方法を次に示します。

- ページ区切り置換文字列をレポート・テンプレートに含める方法

- レポート属性ページの「レイアウトおよびページ区切り」セクションから選択する方法

「レポート属性」ページの「レイアウトおよびページ区切り」属性から選択することによって、ページ区切りの表示方法を制御します。

10.8.3.2 クラシック・レポートのページ区切りの制御

クラッシック・レポートのページ区切りを制御するには、次のステップを実行します。

1. クラシック・レポートの属性のページにアクセスします。「コンポーネント・ビューでのクラシック・レポート属性の編集」を参照してください。
レポート属性ページが表示されます。

2. 「レイアウトおよびページ区切り」で、次の項目を選択します。

1. レポート・テンプレート: レポート・テンプレートを選択します(オプション)。

2. ページ区切りスキーム: ページ区切りスキームを選択します。

3. 表示位置: 表示位置を選択します。

4. 行数: ページごとに表示する行数を指定します。

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

3. プロパティ・エディタで、表10-12に示す属性を見つけて編集します。
属性の詳細は、フィールドレベル・ヘルプを参照してください。「フィールドレベル・ヘルプの表示」を参照してください。

表10-12 「レイアウトおよびページ区切り」属性

属性

説明

レポート・テンプレート

このレポートに適用するテンプレートを指定します。レポート・テンプレートによって、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値の列が必要かどうかを指定してください。

関連項目: 「コンポーネント・ビューでのクラシック・レポートの列ソートの有効化」

10.8.3.3 クラッシック・レポート内での行の後へのページ区切りの挿入

レポート内の行の後にページ区切りを挿入するには、次のステップを実行します。

1. レポートを作成します。「ページの作成ウィザードを使用したレポートの作成」を参照してください。

2. クラシック・レポートの属性のページにアクセスします。「コンポーネント・ビューでのクラシック・レポート属性の編集」を参照してください。
レポート属性ページが表示されます。

3. 「レイアウトおよびページ区切り」で、次を指定します。

1. レポート・テンプレート: レポート・テンプレートを選択します(オプション)。

2. ページ区切りスキーム: ページ区切りスキームを選択します。

3. 表示位置: 表示位置を選択します。

4. 行数: ページごとに表示する行数を指定します。

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

4. レポート・テンプレートを編集します。

1. ページに移動します。「コンポーネント・ビューでのページの表示」を参照してください。

2. 「テンプレート」で、レポート・テンプレート名を選択します。

3. 「行の後」属性に#PAGINATION#置換文字列を含めます。

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

5. ページを実行します。

10.8.3.4 クラッシック・レポート内での行の前へのページ区切りの挿入

レポート内の行の前にページ区切りを挿入するには、次のステップを実行します。

1. レポートを作成します。「ページの作成ウィザードを使用したレポートの作成」を参照してください。

2. クラシック・レポートの属性のページにアクセスします。「コンポーネント・ビューでのクラシック・レポート属性の編集」を参照してください。
レポート属性ページが表示されます。

3. 「レイアウトおよびページ区切り」で、次のステップを実行します。

1. レポート・テンプレート: レポート・テンプレートを選択します(オプション)。

2. ページ区切りスキーム: ページ区切りスキームを選択します。

3. 表示位置: topという語が使用されている位置を選択します。

4. 行数: ページごとに表示する行数を指定します。

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

4. レポート・テンプレートを編集します。

1. ページに移動します。「コンポーネント・ビューでのページの表示」を参照してください。

2. 「テンプレート」で、レポート・テンプレート名を選択します。

3. 「行の前」属性に#TOP_PAGINATION#置換文字列を含めます。

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

5. ページを実行します。

10.8.4 コンポーネント・ビューでのクラシック・レポートの列ソートの有効化

レポート属性ページで列ソートを有効にできます。

列ソートを有効にするには、次のステップを実行します。

1. クラシック・レポートの属性のページにアクセスします。「コンポーネント・ビューでのクラシック・レポート属性の編集」を参照してください。
レポート属性ページが表示されます。

2. 「列属性」で、ソートする列の横にある「ソート」チェック・ボックスを選択します。

3. 「ソート順序」から、順序番号を選択します。
「ソート順序」はオプションです。ただし、ソート可能な列が1列以上ある場合は、定義済のソート順序が1列以上で必要です。

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

ヒント:
レポートの最初および最後にNULL値を含む列を表示する場合は、列のソートを有効にする必要があります。

10.8.5 コンポーネント・ビューでのクラシック・レポートへのダウンロード・リンクの追加

レポート内にリンクを作成して、ユーザーがレポートをカンマ区切りファイル(.csv)としてエクスポートできるようにします。CSVリンクをレポートに追加するには、CSV出力オプションを有効にする必要があります。CSV出力オプションを使用する際、レポート・テンプレートは重要ではありません。CSVリンクは、CSVエクスポート置換文字列が定義されていればどのレポート・テンプレートに追加することもできます。

関連項目:
「自動CSVエンコーディング」

10.8.6 コンポーネント・ビューでのクラシック・レポートのCSV出力の有効化

CSV出力の有効化オプションを使用するには、次のステップを実行します。

1. クラシック・レポートの属性のページにアクセスします。「コンポーネント・ビューでのクラシック・レポート属性の編集」を参照してください。
レポート属性ページが表示されます。

2. 「レポートのエクスポート」までスクロールします。

3. 「CSV出力の有効化」から、「はい」を選択します。

4. (オプション)「セパレータ」および「囲み文字」フィールドで、セパレータおよびデリミタを定義します。
デフォルトの囲み文字は、二重引用符(" ")です。デフォルトのデリミタは、カンマまたはセミコロンで、現在のNLS設定によって異なります。

5. 「リンク・ラベル」で、リンク・テキストを入力します。このテキストは、レポート内に表示され、ユーザーはダウンロードを起動できます。

6. (オプション)デフォルトのエクスポート・ファイル名を指定するには、「ファイル名」フィールドに名前を入力します。
デフォルトでは、Application Expressエンジンによって、リージョン名が取得され、該当するファイル名の拡張子(.csvまたは.xml)が追加されて、エクスポート・ファイル名が作成されます。

7. 「変更の適用」をクリックします。

10.8.7 XMLファイルまたはCSVファイル・エクスポートのサポートの追加

レポート・テンプレートを選択することで、XMLまたはCSVとしてレポートをエクスポートする操作のサポートを追加できます。

レポートをファイルとしてエクスポートするには、次のステップを実行します。

1. クラシック・レポートの属性のページにアクセスします。「コンポーネント・ビューでのクラシック・レポート属性の編集」を参照してください。
レポート属性ページが表示されます。

2. 「レイアウトおよびページ区切り」までスクロールします。

3. 「レポート・テンプレート」リストから、「エクスポート: XML」または「エクスポート: CSV」を選択します。
「エクスポート: XML」を選択すると、Application Expressエンジンでページがレンダリングされなくなり、コンテンツがXMLファイルにダンプされます。

4. 「変更の適用」をクリックします。

10.8.8 コンポーネント・ビューでのクラシック・レポートの列リンクの作成

この項では、アプリケーション内の別のページまたはURLへの列リンクを作成する方法について説明します。

- 別のページへの列リンクの作成

- URLへの列リンクの作成

10.8.8.1 別のページへの列リンクの作成

別のページへの列リンクを作成するには、次のステップを実行します。

1. クラシック・レポートの属性のページにアクセスします。「コンポーネント・ビューでのクラシック・レポート属性の編集」を参照してください。
レポート属性ページが表示されます。

2. 「列属性」で、リンクを含む列を指定します。

3. 列名の横にある「編集」アイコンをクリックします。
列属性ページが表示されます。

4. 「列リンク」までスクロールします。

5. 別のページへの列リンクを作成するには、次のステップを実行します。

1. 「ターゲット」で、「このアプリケーションのページ」を選択します。

2. (オプション)「リンク属性」で、<a href= >タグに含める追加の列リンク属性(リンク・ターゲット、クラス、スタイルなど)を指定します。

3. 「リンク・テキスト」で、リンクとして表示されるテキストを入力するか、イメージ・タグを指定するか、またはデフォルトのイメージのリストから選択します。

4. 「ページ」で、ターゲット・ページ番号を指定します。このページのページ区切りをリセットするには、「ページ区切りのリセット」を選択します。

5. 「リクエスト」で、使用するリクエストを指定します。

6. 「キャッシュのクリア」で、キャッシュをクリアするページ(ページ番号)を指定します。ページ番号をカンマで区切ってリストすることによって、複数のページを指定できます。「対話モード・レポートへのリンクの設定」を参照してください。

7. 特定のアイテムのセッション・ステートを指定するには、「名前」フィールドおよび「値」フィールドを使用します。

6. 「変更の適用」をクリックします。

10.8.8.2 URLへの列リンクの作成

URLへの列リンクを作成するには、次のステップを実行します。

1. クラシック・レポートの属性のページにアクセスします。「コンポーネント・ビューでのクラシック・レポート属性の編集」を参照してください。
レポート属性ページが表示されます。

2. 該当する列の横にある「編集」アイコンをクリックして、列属性ページにアクセスします。
列属性ページが表示されます。

3. 「列リンク」までスクロールします。

4. 「列リンク」で、次のように指定します。

1. 「ターゲット」から「URL」を選択します。

2. 「リンク・テキスト」で、リンクとして表示されるテキストを入力し、置換文字列を選択します。

3. (オプション)「リンク属性」で、<a href= >タグに含める追加の列リンク属性(リンク・ターゲット、クラス、スタイルなど)を指定します。

4. 「URL」で、該当するアドレスを入力します。

5. 「変更の適用」をクリックします。

10.8.9 コンポーネント・ビューでの更新可能な列の定義

列属性ページの「表形式フォームの要素」属性を編集することで更新可能な列を作成できます。Application Expressエンジンは、次の場合にのみ更新を実行できることに注意してください。

- 複数行の更新が定義されている場合

- 更新済データを処理するためにPL/SQLプロセスが実装されている場合

- 組込み表形式フォームの要素および表示タイプを使用している場合、レポートは、SQL問合せ(更新可能レポート)のタイプを使用して定義する必要があります。

更新可能な列属性を定義するには、次のステップを実行します。

1. クラシック・レポートの属性のページにアクセスします。「コンポーネント・ビューでのクラシック・レポート属性の編集」を参照してください。
レポート属性ページが表示されます。

2. 該当する列の横にある「編集」アイコンをクリックして、列属性ページにアクセスします。
列属性ページが表示されます。

3. 「列属性」で、次のように指定します。

1. 表示形式: 更新可能な列の型を選択します。
列を更新可能にするには、このオプションを使用します。更新は、複数行の更新が定義されている場合、または更新済データを処理するためにPL/SQLプロセスが実装されている場合にのみ実行できます。

2. 数値/日付書式: 「日付ピッカー」の「表示形式」タイプを選択している場合は選択を行います。

3. 要素の幅: フォーム・アイテムの幅を指定します。

4. 行数: テキスト領域に適応するフォーム・アイテムの高さを指定します。

5. 要素属性: スタイルまたは標準のフォーム要素属性を定義します。

6. 要素オプションの属性: ラジオ・グループまたはチェック・ボックス内のアイテムのフォーム要素属性を指定します。

4. 「表形式フォームの属性」で、次のように指定します。

1. デフォルト・タイプ: デフォルトのタイプを指定します。

2. デフォルト: デフォルトのソースを指定します。

3. 参照表の所有者: 参照される表の所有者を指定します。この属性では、アプリケーション間の列の参照を「ユーザー・インタフェースのデフォルト値」と比較します。この参照は、ウィザードによる初期化後、可能であれば手動で維持します。

4. 参照表名: 対象の列が参照する表またはビューを指定します。この属性では、アプリケーション間の列の参照を「ユーザー・インタフェースのデフォルト値」と比較します。この参照は、ウィザードによる初期化後、可能であれば手動で維持します。

5. 参照列名: 対象のレポート列が参照する列名を指定します。この属性では、アプリケーション間の列の参照を「ユーザー・インタフェースのデフォルト値」と比較します。この参照は、ウィザードによる初期化後、可能であれば手動で維持します。

5. 「変更の適用」をクリックします。

10.8.10 コンポーネント・ビューでのクラシック・レポートのLOVとしての列定義

列は、ラジオ・グループとしてレンダリングするか、静的LOV、名前付きLOVまたは問合せベースのLOVとしてレンダリングできます。たとえば、選択リストまたはポップアップLOVを使用して列をレンダリングできます。または、LOVに基づく読取り専用テキストとして列をレンダリングすることもできます。

この最後の方法は、表示参照値を作成する場合に効果的な手法であり、特に、更新できない通常のレポートで役立ちます。この方法を使用すると、SQL JOIN文を記述することなく、列の値を表示できます。

LOVとしてレポート列をレンダリングするには、次のステップを実行します。

1. クラシック・レポートの属性のページにアクセスします。「コンポーネント・ビューでのクラシック・レポート属性の編集」を参照してください。
レポート属性ページが表示されます。

2. 該当する列の横にある「編集」アイコンをクリックして、列属性ページにアクセスします。
列属性ページが表示されます。次に、列のレンダリング方法(ラジオ・グループ、LOV、選択リストなど)を指定します。

3. 「列属性」で、「表示形式」リストから選択します。

4. 「LOV」までスクロールします。

5. 「名前付きLOV」で、LOVリポジトリから選択します。

6. LOVにNULL値を含めるには、次のステップを実行します。

1. NULLの表示: 「はい」を選択します。

2. NULL表示値: ここにNULLオプションの表示値を入力します。

3. NULL戻り値: 対象のアイテムのLOVに使用するNULL値を入力します。値を指定しなかった場合のデフォルトは%null%です。

また、列には、LOVで表示されない値を格納することもできます。

7. LOVで表示されない値を定義するには、次のステップを実行します。

1. 「追加値の表示」で、「はい」を選択します。
追加値は、実際の列値がLOVの一部ではない場合に使用されます。このような場合は、実際の値が表示されます。追加値を表示しない場合は、誤った値になる可能性があり、データが不適切に自動更新されます。

2. 「NULL値」で、表示する値を指定します。

3. 名前付きLOVを選択していない場合は、「LOV問合せ」フィールドに選択リストを表示するための問合せを入力します。

8. 名前付きLOVを選択していない場合、LOV定義に選択リストを表示するために使用する問合せを入力します。

9. 「変更の適用」をクリックします。

10.8.11 コンポーネント・ビューでのクラシック・レポートの列の表示条件の制御

「認可」属性および「条件」属性を使用すると、列の表示条件を制御できます。

認可を使用すると、事前定義されたユーザー権限に基づいて(レポート列などの)リソースへのアクセスを制御できます。たとえば、マネージャのみが特定のレポート列を表示できる認可スキームを作成できます。認可スキームを選択するには、まずその認可スキームを作成する必要があります。

条件とは、事前定義された条件タイプに基づいた列の表示の制御を可能にする論理単位です。条件は、「式」フィールドに入力した値に基づいて、trueまたはfalseと評価されます。

認可属性および条件属性を指定するには、次のステップを実行します。

1. クラシック・レポートの属性のページにアクセスします。「コンポーネント・ビューでのクラシック・レポート属性の編集」を参照してください。
レポート属性ページが表示されます。

2. 該当する列の横にある「編集」アイコンをクリックして、列属性ページにアクセスします。
列属性ページが表示されます。

3. 認可スキームで列を制御する場合は、「認可スキーム」リストから選択します。

4. 条件で列を制御する場合は、条件を定義し、「条件タイプ」リストから選択します。選択に応じて、適切な「式」フィールドに式または値を入力します。
認可が正常に終了し、条件タイプの表示がtrueに評価されると、列が表示されます。

関連項目:
「認可を介したセキュリティの提供」、「条件付きのレンダリングおよびプロセスの理解」および付録C「使用可能な条件」

10.8.12 コンポーネント・ビューでのクラッシック・レポートの列ブレークの制御

ブレーク書式属性を使用すると、出力する場合に、特定の列を繰り返すかどうか、および列のブレーク方法を制御できます。たとえば、レポートに、部門番号ごとに従業員情報を表示するとします。複数の従業員が同じ部門に所属している場合、部門番号が1回のみ表示されるように指定することによって、読みやすさを向上できます。

このタイプの列ブレークを作成するには、次のステップを実行します。

1. クラシック・レポートの属性のページにアクセスします。「コンポーネント・ビューでのクラシック・レポート属性の編集」を参照してください。
レポート属性ページが表示されます。

2. 「ブレーク書式」までスクロールします。

3. 「ブレーク」リストから選択します。

10.8.13 クラシック・レポートの列の順序とリージョン・ソースの同期

クラシック・レポートの列の順序を、リージョン・ソースの問合せで定義された列の順序と同期化するには、次のステップを実行します。

1. クラシック・レポートの属性のページにアクセスします。「コンポーネント・ビューでのクラシック・レポート属性の編集」を参照してください。
レポート属性ページが表示されます。

2. 「タスク」から、「列の順序とリージョン・ソースの同期化」を選択します。

3. 「同期化」をクリックします。

10.9 レポート・リージョンの出力

いくつかの異なる形式にエクスポートすることによって、出力するレポート・リージョンを構成できます。Oracle BI Publisherでは、Adobe Portable Document Format(PDF)、Microsoft Wordリッチ・テキスト形式(RTF)、Microsoft Excel形式(XLS)またはExtensible Markup Language(XML)がサポートされます。Oracle Rest Data ServicesでもPDFおよびXMLがサポートされます。他のサード・パーティ・レンダリング・エンジンの使用を選択すると、他の出力形式も構成されます。

リージョン・レポート出力を利用すると、アプリケーション・ユーザーは、印刷の方向、ページ・サイズ、列ヘッダーおよびページのヘッダーとフッターが事前定義されたレポートを表示および出力できます。対話モード・レポートでも、PDF、RTF、Microsoft ExcelおよびCSVへのエクスポートが可能です。

注意:
対話モード・レポートでは、カスタム・レポート・レイアウトはサポートされません。

- PDFへのレポート出力について

- レポート出力の構成オプションについて

- クラシック・レポートの出力メソッドについて

- クラシック・レポート・リージョンの出力属性の構成

- 対話モード・レポート・リージョンの出力属性の構成

- レポート問合せについて

- レポート・レイアウトについて

ヒント:
Oracle Application ExpressをOracle Database 11g リリース1 (11.1)以上で実行している場合は、レポート出力を使用するためにネットワーク・サービスを有効にする必要があります。「Oracle Database 11g以上のネットワーク・サービスの有効化」を参照してください。

10.9.1 PDFへのレポート出力について

レポートをPDFに出力するには、インスタンスレベルで定義したレポート・サーバーを使用して、データを変換する必要があります。エンド・ユーザーの観点では、単に出力リンクをクリックします。ただし、開発者の観点では、PDF出力をサポートするリージョンを宣言的に作成する必要があります。

10.9.2 レポート出力の構成オプションについて

Oracle Application Expressでは、3つのレポート出力構成オプションが提供されています。

- Oracle REST Data Services: Oracle REST Data Services (旧名称はApplication Expressリスナー)リリース2.0以上を使用している場合は、このオプションを選択します。このオプションによって、Application Expressで提供されるデフォルトのテンプレートおよびカスタマイズしたXSL-FOテンプレートを使用して、レポート問合せの作成およびレポート・リージョンの出力を含む基本的な出力機能が使用できるようになります。

注意:
「Oracle REST Data Services」オプションでは、外部出力サーバーが必要なく、かわりに、レポート・データおよびスタイルシートがリスナーにダウンロードされ、リスナーによってPDF形式にレンダリングされてから、クライアントに送信されます。この設定のPDFドキュメントはデータベースに戻されないため、Oracle REST Data Servicesベースの構成を使用する場合、出力APIはサポートされません。

- 外部(Apache FOP): 外部J2EEサーバーでApache FOPを使用している場合に、このオプションを選択します。このオプションによって、Application Expressで提供されるデフォルトのテンプレートおよびカスタマイズしたXSL-FOテンプレートを使用して、レポート問合せの作成およびレポート・リージョンの出力を含む基本的な出力機能が使用できるようになります。

- Oracle BI Publisher: Oracle BI Publisher(Oracle XML Publisherとも呼ばれる)の使用許諾が必要です。このオプションによって、レポートの問合せ結果を取得し、Oracle BI Publisherを使用して、XMLからRTF形式に変換できるようになります。Application Express内でのレポート出力用に、独自にカスタマイズしたRTFまたはXSL-FOのテンプレートをアップロードする場合、このオプションを選択してください。

関連項目:
Oracle BI Publisherのインストールおよび構成の詳細は、「PDF Printing in Application Express」を参照してください。次の場所にアクセスしてください。

http://www.oracle.com/technetwork/developer-tools/apex/application-express/configure-printing-093060.html

レポート出力の機能をすべて使用するには、Oracle Application Expressのサービス管理者がこの機能をインスタンスで有効にする必要があります。詳細は、『Oracle Application Express管理ガイド』のレポート出力の構成に関する説明を参照してください。

10.9.3 クラシック・レポートの出力メソッドについて

クラシック・レポートのリージョンは、次の2つの方法で出力できます。

- レポート・リージョンの出力属性の構成。リージョンに対して出力属性を構成することによって、レポート・リージョンを出力できます。「クラシック・レポート・リージョンの出力属性の構成」を参照してください。

- レポート問合せの作成。レポート問合せを共有コンポーネントとして定義することで、レポートを出力できます。「レポート問合せの定義によるレポート・リージョンの印刷」を参照してください。

レポート・リージョンおよびレポート問合せは、次の形式でダウンロードできます。

- PDF: Adobe Portable Document Format。

- RTF: Microsoft Word Rich Text Format。

- XLS: Microsoft Excel形式。ただし、コンテンツはHTMLベースであるため、本当の.xlsファイルではありません。

- HTML

- XML: Extensible Markup Language。

レポート・リージョンまたはレポート問合せを書式設定するには、レポート・レイアウトと関連付けます。詳細は、「レポート・レイアウトを使用したレポート・リージョンまたはレポート問合せのフォーマット」を参照してください。

ヒント:
また、アイテムによって出力結果を指定させることもできます(このようなアイテムは実行時に出力形式を決定します)。形式値を保持するアイテムを選択します。有効な値は、「PDF」、「RTF」(ドキュメントをMicrosoft Wordで開く)、「XLS」(ドキュメントをMicrosoft Excelで開く)および「HTM」(ドキュメントをHTMLファイルとしてダウンロードする)です。

10.9.4 クラシック・レポート・リージョンの出力属性の構成

レポート・リージョンを出力する方法の1つは、出力属性を構成する方法です。構成後、これらの属性は現行のリージョンのみに適用され、リージョンのコンテキスト外では使用できません。

インスタンスに対して出力機能が設定されている場合、様々な形式で出力できるようにレポート・リージョンを構成できます。

- ページ・デザイナでのクラシック・レポート出力属性の構成

- コンポーネント・ビューでのクラシック・レポート出力属性の構成

関連項目:
「クラシック・レポートの出力メソッドについて」およびOracle Application Express管理ガイドの「レポート出力の構成」

10.9.4.1 ページ・デザイナでのクラシック・レポート出力属性の構成

出力用にクラシック・レポート・リージョンを構成するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。「ページ・デザイナでのページの表示」を参照してください。
ページ・デザイナが表示されます。

2. 出力属性を有効化します。

1. ページ・デザイナで、クラシック・レポートを含むページを表示します。「ページ・デザイナでのページの表示」を参照してください。

2. 「レンダリング」ツリーで、レポートを含むリージョンを展開し、「属性」ノードを選択します
プロパティ・エディタにレポート属性が表示されます。

3. プロパティ・エディタで、「出力」セクションを見つけて展開します。

4. 「出力」の「有効」で、「はい」を選択します。

5. 「保存」をクリックして、ページをリフレッシュします。

3. 「レンダリング」ツリーで、「属性」ノードを展開して「出力」ノードを選択します。

4. 「リージョン」で、「属性」ノードを選択します。

5. 適切な出力属性を編集します。
詳細は、フィールドレベル・ヘルプを参照してください。

6. 変更を保存するには、「保存」をクリックします。ページを保存して実行するには、「ページの保存と実行」をクリックします。

10.9.4.2 コンポーネント・ビューでのクラシック・レポート出力属性の構成

出力用にクラシック・レポート・リージョンを構成するには、次のステップを実行します。

1. アプリケーションで、出力する対話モード・レポート・リージョンを含むページを選択します。
ページが表示されます。

2. 「リージョン」で、出力するリージョンの横にある「出力」リンクをクリックします。
出力属性ページが表示されます。

3. 「出力」で、次の該当する情報を指定します。

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をボタン・ターゲットとして使用します。

4. 残りのセクションで、ページ・サイズ、用紙の向き、ページのヘッダーおよびフッター、フォント、テキストの色、背景の色を定義します。

5. 「レポート列」で、各列の幅を指定します。
デフォルトでは、各列の幅は同じになります。「合計幅」は表示専用フィールドであり、すべての列幅の合計を示します。個々の列の幅を変更すると、「合計幅」は自動的に再計算されます。「列幅の単位」が「ポイント」ではなく「割合」に設定されている場合は、列幅の合計を100以下にする必要があります。

「列幅のリセット」ボタンをクリックすると、「列幅の単位」が「割合」になり、すべての列幅がそれぞれのデフォルト値に戻ります。「再計算」ボタンをクリックすると、列幅の割合は現在の値を維持したままで、合計幅が100%以下になるように、すべての列幅が縮小されます。

6. 「変更の適用」をクリックします。

10.9.5 対話モード・レポート・リージョンの出力属性の構成

対話モード・レポートの出力属性は、クラシック・レポートの場合とは異なり、デフォルトのXSL-FOレイアウトのみを使用できます。また、この画面から直接開始するのではなく、「レポート属性」の「ダウンロード」セクションからのみ開始できます。構成した属性は、現行のリージョンのみに適用され、リージョンのコンテキスト以外では使用できません。

インスタンスに対して出力機能が設定されている場合、様々な形式で出力できるようにレポート・リージョンを構成できます。

- ページ・デザイナでの出力用の対話モード・レポート・リージョンの構成

- コンポーネント・ビューでの出力用の対話モード・レポート・リージョンの構成

10.9.5.1 ページ・デザイナでの出力用の対話モード・レポート・リージョンの構成

出力用に対話モード・レポート・リージョンを構成するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。「ページ・デザイナでのページの表示」を参照してください。
ページ・デザイナが表示されます。

2. 「レンダリング」ツリーで、レポートを含むリージョンを展開し、「属性」ノードを探します。

3. 「属性」ノードを展開して「出力」ノードを選択します。
プロパティ・エディタに出力属性が表示されます。

4. 適切な出力属性を編集します。
詳細は、フィールドレベル・ヘルプを参照してください。

5. 変更を保存するには、「保存」をクリックします。ページを保存して実行するには、「ページの保存と実行」をクリックします。

10.9.5.2 コンポーネント・ビューでの出力用の対話モード・レポート・リージョンの構成

出力用に対話モード・レポート・リージョンを構成するには、次のステップを実行します。

1. アプリケーションで、出力する対話モード・レポート・リージョンを含むページを選択します。
ページが表示されます。

2. 「リージョン」で、出力するリージョンの横にある「対話モード・レポート」をクリックします。

3. 「出力属性」タブをクリックします。

4. 「出力」で、次の該当する情報を指定します。

1. レスポンス・ヘッダー: Oracle Application Expressにより生成されたレスポンス・ヘッダーは、「レポート設定」または「プリント・サーバー」に基づきます。レスポンス・ヘッダーは、HTTPリクエストを受信した応答としてサーバーがブラウザに送信する情報です。レスポンス・ヘッダーには、サーバーがクライアントに送信するファイルの日付、サイズ、タイプに加えて、サーバー自体に関するデータも含まれています。コンテンツ配置(「ファイルの表示形式」属性を使用)およびファイル名を指定する場合、レスポンス・ヘッダーはレポート設定に基づいている必要があります。

2. ファイルの表示形式: レポート問合せドキュメントをWebブラウザでどのように開くかを選択します。オプションは次のとおりです。

- 添付ファイル: レポート問合せのダウンロード・ボタンをクリックすると、ファイルを開く/保存のダイアログ・ボックスが表示されます。

- インライン: レポート問合せドキュメントがブラウザ・ウィンドウ内に表示されます。

3. プリント・サーバーの上書き: 代替のプリント・サーバーを指定します。プリント・サーバーは通常、Oracle Application Express管理サービスのすべてのワークスペースについて一元的に設定されます。Oracle Application Express管理ガイドの「レポート出力の構成」を参照してください。
代替プリント・サーバーをレポート・レベルで構成すると、出力で予想される問題のデバッグと診断が簡単になり、カスタム作成した特定のエンド・ポイントを使用してカスタムのXSLT変換を実行することが可能になります。

5. 残りのセクションで、ページ・サイズ、用紙の向き、ページのヘッダーおよびフッター、フォント、テキストの色、背景の色を定義します。

6. 「変更の適用」をクリックします。

10.9.6 レポート問合せについて

レポート・リージョンは、レポート問合せを共有コンポーネントとして定義することによって出力できます。レポート問合せは、抽出されるデータを識別します。リージョンに含まれるSQL文とは異なり、レポート問合せには、問合せを保存すると有効化されるSQL文が含まれます。レポート問合せは、SQL文を戻すファンクションではなく、SQL文である必要があります。

関連項目:
「レポート問合せの定義によるレポート・リージョンの印刷」

10.9.7 レポート・レイアウトについて

クラシック・レポート・リージョンまたはレポート問合せのどちらかをフォーマットするには、レポート・レイアウトと関連付けます。レポート・レイアウトを使用すると、印刷用形式でデータをレンダリングできます。レポート・レイアウトを選択しない場合は、デフォルトのXSL-FOレイアウトが使用されます。対話モード・レポートのリージョンのレンダリングでは、常にデフォルトのXSL-FOレイアウトが使用されます。

関連項目:
「レポート・レイアウトを使用したレポート・リージョンまたはレポート問合せのフォーマット」

10.10 フォームおよびレポートでのBLOBサポートの理解

Oracle Application Expressでは、宣言的なBLOBサポートが提供されているため、開発者はフォームでのファイルの宣言的なアップロードや、レポートでのファイルのダウンロードおよび表示を行うことができます。BLOBの表示とダウンロードは、PL/SQLを使用して手続き的に作成することもできます。このセクションでは、ファイルのアップロード、ダウンロードおよび表示を行う方法と、BLOB列に格納されているファイルを正しく管理するために重要となる追加のファイル属性(MIMEタイプやファイル名など)の管理方法について説明します。この機能を使用すると、簡単にOracle Application Expressアプリケーションを拡張して、イメージ、ドキュメント、ビデオなどのファイルを管理できます。

- レポートでのBLOBサポートについて

- ダウンロード・リンクの提供について

- BLOBの表示について

- 手続き的なBLOBの使用について

10.10.1 レポートでのBLOBサポートについて

Oracle Application Expressでは、従来のレポートと対話モード・レポートの両方に対するBLOBサポートが提供されています。ウィザードを使用してレポートを作成し、BLOBタイプの列を含める場合は、基本的なサポートが含まれます。ダウンロード機能を使いやすくするために、生成後に詳細情報を追加する必要があります。

10.10.2 ダウンロード・リンクの提供について

レポートにダウンロード・リンクを容易に含めることができるように、レポートには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が使用されます。これは置換をサポートしています(翻訳されたアプリケーションに有効です)。

12

表所有者

はい

BLOBタイプのターゲット列を含む表所有者の名前を識別します。

次に例を示します。

DOWNLOAD:EMP:RESUME:EMPNO::RESUME_MIMETYPE:RESUME_FILENAME:RESUME_LAST_UPDATE::attachment:Resume

上述の説明に従い、これらのパラメータを入力し、形式を作成します。「数値/日付書式」アイテムには、「BLOBフォーマット」を選択する必要があります。選択すると、BLOB列属性リージョンが表示され、前述のすべてのパラメータを入力できます。

10.10.3 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

代替テキスト

いいえ

イメージに関連付けられている代替タグに使用する文字列です。

12

表所有者

はい

BLOBタイプのターゲット列を含む表所有者の名前を識別します。

次に例を示します。

IMAGE:EMP:RESUME:EMPNO::RESUME_MIMETYPE:RESUME_FILENAME:RESUME_LAST_UPDATE::attachment:Resume

上述の説明に従い、これらのパラメータを入力し、形式を作成します。「数値/日付書式」アイテムには、「BLOBフォーマット」を選択する必要があります。選択すると、新しいリージョンのBLOB列属性が表示され、上述の説明に従って、すべてのパラメータを記入できます。

10.10.4 手続き的なBLOBの使用について

ダウンロード・リンクを指定した組込み方式を使用するかわりに、APEX_UTIL.GET_BLOB_FILE_SRCファンクションを使用できます。この方法を使用すると、イメージの表示形式をより具体的に設定できます(高さタグおよび幅タグを使用)。この方法は、有効なOracle Application Expressセッションからコールされた場合にのみ有効です。また、BLOBを記述するパラメータを、アプリケーション内の有効なアイテムの書式としてリストする必要もあります。これにより、ファンクションからそのアイテムが参照されます。

関連項目:
Oracle Application Express APIリファレンスの「GET_BLOB_FILE_SRCファンクション」

11 フォームの開発

様々なタイプのフォームをアプリケーションに含めることができます。ユーザーが表内の単一行または複数行を更新できるフォームを含めることができます。この項では、ウィザードを使用してフォームを作成する方法、フォームを手動で作成する方法およびユーザー入力を検証する方法について説明します。

- ウィザードを使用したフォームの作成

- 表形式フォームの管理

- マスター・ディテール・フォームの管理

- コンポーネント・ビューでのフォームの手動作成

- フォームでのユーザー入力の検証

- フォームでのBLOBサポートの理解

関連項目:
「レポートの開発」

11.1 ウィザードを使用したフォームの作成

アプリケーション・ビルダーには、フォームの生成に使用できる組込みウィザードが用意されています。この項では、アプリケーションの作成ウィザード、ページの作成ウィザードおよびリージョンの作成ウィザードを使用する際のフォーム・オプションの概要を示します。使用可能なフォームは、選択したアプリケーション・ユーザー・インタフェース(デスクトップおよびjQuery Mobileスマートフォンなど)に応じて異なることに注意してください。

- ページの作成ウィザードのフォーム・オプション

- リージョンの作成ウィザードのフォーム・オプション

- ページの作成ウィザードを使用したフォームの作成

- アプリケーションの作成ウィザードを使用したフォームの作成

- ページ・デザイナでのフォームの作成

関連項目:
「アプリケーションの作成ウィザードを使用したレポートの作成」、「ページの作成ウィザードを使用したレポートの作成」および「コンポーネント・ビューでのリージョンの作成」

ヒント:
ウィザードには、表を選択するものもあれば、SQL問合せを指定するものもあります。SQL問合せの記述が不明な場合は、「クエリー・ビルダー」ボタンをクリックします。『Oracle Application Express SQLワークショップ・ガイド』のクエリー・ビルダーを使用したSQL問合せの構築に関する項を参照してください。

11.1.1 ページの作成ウィザードのフォーム・オプション

表11-1に、ページの作成ウィザードを使用する際のフォーム・オプションを示します。使用可能なフォーム・オプションは、選択したユーザー・インタフェース(デスクトップおよびjQuery Mobileスマートフォンなど)に応じて異なることに注意してください。

表11-1 ページの作成ウィザードのレポート・オプション

ページ・タイプ

説明

デスクトップ

jQuery Mobileスマートフォン

プロシージャのフォーム

ストアド・プロシージャの引数に基づくフォームを構築します。ストアド・プロシージャまたはパッケージに実装済のロジックまたはデータ操作言語(DML)が存在する場合は、この方法を使用します。

使用可能

使用可能

表またはビューのフォーム

データベース表の単一行を更新できるフォームを作成します。フォームを構築する表を選択できます。

使用可能

使用可能

リスト・ビュー付きの表のフォーム

データベース表の単一行を更新できるフォームおよびリスト・ビューを作成します。フォームを構築する表を選択し、リスト・ビューのテキスト表示に使用する列を選択します。

使用不可

使用可能

レポート付きの表のフォーム

2つのページを作成します。1つのページにはレポートが表示されます。各行に2ページ目へのリンクが提供され、これを使用して各レコードを更新できます。レポートおよびフォームを構築する表を選択できます。

注意: このウィザードでは、127列を超える列が含まれている表はサポートされていません。127列を超える列を選択すると、エラーが発生します。

使用可能

使用可能

マスター・ディテール・フォーム

1つのHTMLフォーム内にマスター行および複数のディテール行を表示するフォームを作成します。このフォームを使用すると、2つの表またはビューに対し、値の問合せ、挿入、更新および削除を行うことができます。マスター・レポートおよびディテール・フォームを構築する表を選択します。

関連項目: 「マスター・ディテール・フォームの管理」

使用可能

使用不可

表形式フォーム

データベース表の複数の行に対して更新、挿入および削除を行うフォームを作成します。フォームを構築する表を選択します。

関連項目: 「表形式フォームの管理」

使用可能

使用不可

SQL問合せのフォーム

EQUIJOINなどのSQL問合せによって戻される列に基づくフォームを作成します。

使用可能

使用可能

サマリー・ページ

読取り専用のフォームを作成します。このオプションを使用して、ウィザードの最後に確認ページを作成します。

使用可能

使用可能

Webサービスのフォーム

Webサービスの定義に基づいて、アイテムを含むページを作成します。このウィザードでは、ユーザー入力フォーム、Webサービスをコールするプロセスおよび送信ボタンを作成します。

関連項目: 「Webサービスでのフォームの作成」

使用不可

使用可能

Webサービスのフォームとレポート

Webサービスの定義に基づいて、アイテムを含むページを作成します。このウィザードでは、ユーザー入力フォーム、Webサービスをコールするプロセスおよび送信ボタンを作成し、レポートに結果を表示します。

関連項目: 「Webサービスでの入力フォームとレポートの作成」

使用可能

使用可能

関連項目:
「ページの作成ウィザードを使用したフォームの作成」

11.1.2 リージョンの作成ウィザードのフォーム・オプション

表11-2に、リージョンの作成ウィザードを使用する際のフォーム・オプションを示します。

表11-2 リージョンの作成ウィザードのフォーム・オプション

ページ・タイプ

説明

デスクトップ

jQuery Mobileスマートフォン

プロシージャのフォーム

ストアド・プロシージャの引数に基づくフォームを構築します。ストアド・プロシージャまたはパッケージに実装済のロジックまたはデータ操作言語(DML)が存在する場合は、この方法を使用します。

使用可能

使用可能

表またはビューのフォーム

データベース表の単一行を更新できるフォームを作成します。フォームを構築する表を選択できます。

使用可能

使用可能

リスト・ビュー付きの表のフォーム

データベース表の単一行を更新できるフォームおよびリスト・ビューを作成します。フォームを構築する表を選択し、リスト・ビューのテキスト表示に使用する列を選択します。

使用不可

使用可能

レポート付きの表のフォーム

2つのページを作成します。1つのページにはレポートが表示されます。各行に2ページ目へのリンクが提供され、これを使用して各レコードを更新できます。レポートおよびフォームを構築する表を選択できます。

注意: このウィザードでは、127列を超える列が含まれている表はサポートされていません。127列を超える列を選択すると、エラーが発生します。

使用可能

使用可能

マスター・ディテール・フォーム

2ページのレポートとフォームの組合せを構築します。1ページ目では、更新する行を選択します。2ページ目では、ユーザーは選択した表またはビューと関連するディテールを更新できます。マスター・レポートおよびディテール・フォームを構築する表を選択します。

関連項目: 「マスター・ディテール・フォームの管理」

使用可能

使用不可

表形式フォーム

データベース表の複数の行に対して更新、挿入および削除を行うフォームを作成します。フォームを構築する表を選択します。

関連項目: 「表形式フォームの管理」

使用可能

使用不可

SQL問合せのフォーム

EQUIJOINなどのSQL問合せによって戻される列に基づくフォームを作成します。

使用可能

使用可能

サマリー・ページ

読取り専用のフォームを作成します。通常、ウィザードの最後に確認ページを提供するために使用します。

使用可能

使用可能

Webサービスのフォーム

Webサービスの定義に基づいて、アイテムを含むページを作成します。このウィザードでは、ユーザー入力フォーム、Webサービスをコールするプロセスおよび送信ボタンを作成します。

関連項目: 「Webサービスでのフォームの作成」

使用可能

使用可能

Webサービスのフォームとレポート

Webサービスの定義に基づいて、アイテムを含むページを作成します。このウィザードでは、ユーザー入力フォーム、Webサービスをコールするプロセスおよび送信ボタンを作成し、レポートに結果を表示します。

関連項目: 「Webサービスでの入力フォームとレポートの作成」

使用可能

使用可能

関連項目:
「リージョンについて」

11.1.3 ページの作成ウィザードを使用したフォームの作成

フォームを作成する最も簡単な方法は、ページの作成ウィザードを使用することです。表11-1「ページの作成ウィザードのレポート・オプション」で説明したように、このウィザードには多数のフォーム・オプションが用意されています。

ページの作成ウィザードを使用してフォームを作成するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「ページの作成」をクリックします。

4. 「ページの作成」で、次のステップを実行します。

1. ユーザー・インタフェース: ページのユーザー・インタフェースを選択します。

2. ページ・タイプの選択: 「フォーム」を選択します。

3. 「次へ」をクリックします。

5. 作成するフォーム・ページのタイプを選択します。表11-1「ページの作成ウィザードのレポート・オプション」を参照してください。

6. 画面に表示されるステップに従います。
属性の詳細は、フィールドレベル・ヘルプを参照してください。「フィールドレベル・ヘルプの表示」を参照してください。

11.1.4 アプリケーションの作成ウィザードを使用したフォームの作成

アプリケーションの作成ウィザードを使用して、表内の単一行を更新するフォームを作成します。このウィザードでは、フォームを構築する表を選択できます。

アプリケーションの作成ウィザードを使用してフォームを作成するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. 「作成」ボタンをクリックします。

3. アプリケーション・タイプで「デスクトップ」を選択し、「次へ」をクリックします。

4. 「名前」で、次のステップを実行します。

1. スキーマ: アプリケーションは、すべてのSQLを特定のデータベース・スキーマとして解析することで、権限を取得します。データベース・スキーマ所有者を指定します。

2. 名前: 開発者がアプリケーションを識別するための名前を入力します。

3. アプリケーション: アプリケーションを識別する整数値を指定します。アプリケーションIDは、Application Expressインスタンス内で一意である必要があります。3000から9000の範囲のアプリケーションIDは、Oracle Application Expressの内部使用向けに予約されています。

4. テーマ: テーマを選択します。テーマは、アプリケーション全体のレイアウトおよびスタイルの定義に使用するテンプレートのコレクションです。「テーマの使用」を参照してください。

5. テーマ・スタイル: テーマ・スタイルを選択します。テーマ・スタイルは、テーマ42および51などの新しいアプリケーションに対してのみ使用可能です。「テーマ・スタイルの使用」を参照してください。

6. 「次へ」をクリックします。

ヒント:
この時点で、ログイン・ページと空白ページのみで構成されるアプリケーションを作成するには、「アプリケーションの作成」をクリックします。

次に、ページをアプリケーションに追加します。

5. 「ページ」で、「ページの追加」をクリックします。
「アプリケーションの作成 - ページの追加」ダイアログで、次のステップを実行します。

1. ページ・タイプの選択: 「フォーム」を選択します。

2. 親ページ: 該当する場合、従属ページを選択します。属性の詳細は、フィールドレベル・ヘルプを参照してください。

3. 表名: 表を選択します。

4. 「ページの追加」をクリックします。
ページがページ上部に表示されます。ページを削除するには、「削除」アイコンをクリックします。

5. すべてのページが追加されるまで前のステップを繰り返します。

6. 「次へ」をクリックします。

6. 画面に表示されるステップに従います。

ヒント:
属性の詳細は、フィールドレベル・ヘルプを参照してください。「フィールドレベル・ヘルプの表示」を参照してください。

関連項目:
「データベース・アプリケーションの作成」

11.1.5 ページ・デザイナでのフォームの作成

ページ・デザイナでのフォームを作成するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。「ページ・デザイナでのページの表示」を参照してください。

2. ページ上部のページ・デザイナ・ツールバーに移動します。

3. ページ・デザイナ・ツールバーで、「作成」メニューをクリックし、「フォーム・リージョンの作成」を選択します。
「リージョンの作成」ウィザードが表示されます。

4. 作成するフォームのタイプを選択し、「次へ」をクリックします。フォーム・オプションの詳細は、「リージョンの作成ウィザードのフォーム・オプション」を参照してください。

5. 画面に表示されるステップに従います。

11.2 表形式フォームの管理

表形式フォームを使用すると、1つのページから表内の複数の行を一度に更新できます。ウィザードを使用して作成した表形式フォームでは、データベース表内の複数の行に対して更新、挿入および削除操作を実行できます。このフォームには、バックグラウンドでコミット時ロックを実行してデータの整合性を維持する組込みの複数行更新プロセスが備わっています。

- 表形式フォームの作成について

- 表形式フォームの実行について

- 表形式フォームの仕組み

- アプリケーションの作成ウィザードを使用した表形式フォームの作成

- ページの作成ウィザードを使用した表形式フォームの作成

- 表形式フォームの列の順序とリージョン・ソースの同期

11.2.1 表形式フォームの作成について

表形式フォームの作成方法は主に次の2つです。

- アプリケーションの作成ウィザード

- ページの作成ウィザード

これらのウィザードを使用して作成した表形式フォームには、自動DMLプロセスが含まれています。これらのウィザードでは、データベース表内の複数の行に対して更新、挿入および削除操作を実行するフォームを作成します。または、表形式フォームを手動で作成することも可能であり、その場合は、更新可能なレポート・リージョンまたは更新可能な列を含む標準レポート・リージョンのいずれかを作成し、それとともに表形式フォームのデータを処理するカスタムPL/SQLページ・プロセスを使用します。

表形式フォームを作成する場合のベスト・プラクティス

表形式フォームを作成するときには、次のベスト・プラクティスを実施することをお薦めします。

- 表形式フォームのSQL文の選択リストは、ウィザードを使用して生成した後、変更しないでください。問合せを変更する場合は、更新可能な列の値が、Application Expressエンジンによってデータベースから問い合せられた後に変更されていないことを確認してください。

- 表示タイプ特有のJavaScriptロジックを使用する表示タイプにカスタムJavaScriptを追加しないでください(ラジオ・グループ、単純なチェック・ボックス、ポップアップ・キーLOVなど)。

11.2.2 表形式フォームの実行について

表形式フォームを実行すると、データは更新可能な列を含むレポートとしてレンダリングされます。これらの列は、様々なフォーム要素(テキスト・フィールド、テキスト領域、日付ピッカー、選択リスト、ラジオ・グループなど)を使用して示されます。

デフォルトでは、日付列は「日付ピッカー」アイテム・タイプを使用して作成されます。他の列については、ユーザー・インタフェースのデフォルト値を定義しておくことで、LOVに基づく選択リスト、または数値フィールドと大きなテキスト領域として自動的に作成できます。

関連項目:
Oracle Application Express SQLワークショップ・ガイドの「ユーザー・インタフェースのデフォルト値の管理」

数値フィールドおよび日付フィールドについては、日付と数値の書式マスクを事前に定義したり、初期フォームの生成後にそれらの書式マスクを適用することもできます。

また、各レポートには、(行セレクタと呼ばれる)チェック・ボックス列も含まれています。ユーザーは、この行セレクタを使用して1つ以上の列を選択し、データを更新または削除します。行を追加するには、「行の追加」をクリックします。

ヒント:
列属性を編集して、特定の列の外観を制御できます。

11.2.3 表形式フォームの仕組み

表形式フォームは、基礎となる表の列に問合せ列が関連付けられているSQL問合せに基づきます。単一レコードとは異なり、表形式フォームではデータはセッション・ステートに格納されません。表形式フォーム・ページが送信されると、表形式フォームのデータは組込みのデータ操作言語(DML)またはカスタムPL/SQLページ・プロセスを使用して処理されます。

自動DMLを備えた表形式フォームでは、複数行操作に対して次の2つのプロセスが使用されます。

- 複数行の更新(MRU)プロセスでは、作成操作と更新操作を実行します。

- 複数行の削除(MRD)プロセスでは、1つ以上の行に対するリクエストを削除します。

MRUプロセスとMRDプロセスでは、基礎となる表名と主キー列を参照します。DMLプロセスで正しいレコードを識別できるようにするには、主キー列を表形式フォームのSQL問合せに含め、レポート列を非表示にするか、表示専用(ステートを保存)にする必要があります。新しいレコードの場合、主キー値をNULLにして、新しいレコードとして識別されるようにする必要があります。削除操作は、削除対象の行の行番号を参照することによって実行されます。ユーザーが、カレント・ページ上の1つ以上の行をチェックし、「削除」ボタンをクリックすると、行番号によって対応する主キー値が識別され、一致する行が削除されます。

ウィザードによって生成される表形式フォームの組込みDMLには、更新の喪失を回避するためのチェックサム列が含まれています。コミット時ロックと呼ばれる方法を使用すると、表形式フォームのレンダリング時に各行のチェックサムが計算されます。このチェックサムは、表形式フォームの特別な非表示列に格納されます。更新のためにフォームを送信すると、データベースに格納されている現在のデータで追加のチェックサム・セットが計算されます。表形式フォームの初回レンダリング時に構築されたチェックサムと新しいチェックサムが比較され、不一致が見つかった場合、更新は拒否されます。これは、表形式フォームがレンダリングされてからデータが送信されるまでの間に、データベース内のデータが別のユーザーまたは別のプロセスによって変更されたためです。

また、ウィザードによって生成される表形式フォームでは、一部の列に対して検証が自動的に作成されます。検証は、基礎となる表でNOT NULLに設定されている列、およびタイプがNUMBER、DATEまたはTIMESTAMPの列に対して作成されます。ユーザーの選択または定義済のユーザー・インタフェースのデフォルト値に基づいて、列が読取り専用に設定されている場合、検証は作成されません。

11.2.4 アプリケーションの作成ウィザードを使用した表形式フォームの作成

アプリケーションの作成ウィザードは、複数のページおよびコンポーネントで構成される基本的なOracle Application Expressアプリケーションを簡単に作成できるように設計されています。そのため、このウィザードでは、一般的なベスト・プラクティスに基づいてアプリケーションが生成され、ページの作成ウィザードに含まれているいくつかの高度なオプションは使用されません。

ヒント:
表形式の作成時には、汎用列テンプレートを使用し、列レポート・テンプレートは使用しないことをお薦めします。「レポート・テンプレート」を参照してください。

アプリケーションの作成ウィザードを使用して表形式フォームを作成するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. 「作成」ボタンをクリックします。

3. アプリケーション・タイプで「デスクトップ」を選択し、「次へ」をクリックします。

4. 「名前」で、次のステップを実行します。

1. スキーマ: アプリケーションは、すべてのSQLを特定のデータベース・スキーマとして解析することで、権限を取得します。データベース・スキーマ所有者を指定します。

2. 名前: 開発者がアプリケーションを識別するための名前を入力します。

3. アプリケーション: アプリケーションを識別する整数値を指定します。アプリケーションIDは、Application Expressインスタンス内で一意である必要があります。3000から9000の範囲のアプリケーションIDは、Oracle Application Expressの内部使用向けに予約されています。

4. テーマ: テーマを選択します。テーマは、アプリケーション全体のレイアウトおよびスタイルの定義に使用するテンプレートのコレクションです。「テーマの使用」を参照してください。

5. テーマ・スタイル: テーマ・スタイルを選択します。テーマ・スタイルは、テーマ42および51などの新しいアプリケーションに対してのみ使用可能です。「テーマ・スタイルの使用」を参照してください。

6. 「次へ」をクリックします。

ヒント:
ログイン・ページと空白ページのみを含むインスタント・アプリケーションを作成するには、「アプリケーションの作成」ボタンをクリックします。

次に、ページをアプリケーションに追加します。

5. 「ページ」で、「ページの追加」をクリックします。
「アプリケーションの作成 - ページの追加」ダイアログで、次のステップを実行します。

1. ページ・タイプの選択: 「表形式フォーム」を選択します。

2. 親ページ: 該当する場合、従属ページを選択します。属性の詳細は、フィールドレベル・ヘルプを参照してください。

3. 表名: 表を選択します。

4. 「ページの追加」をクリックします。
ページ上部に新しいページが表示されます。

5. 「次へ」をクリックします。

6. 「共有コンポーネント」で、共有コンポーネントを別のアプリケーションからコピーするかどうかを指定します。「はい」または「いいえ」を選択します。「はい」を選択した場合は、そのコピー元と、インポートするコンポーネントを選択します。「共有コンポーネントの管理」を参照してください。

7. 「属性」で、必要に応じて構成し、「次へ」をクリックします。

ヒント:
属性の詳細は、フィールドレベル・ヘルプを参照してください。「フィールドレベル・ヘルプの表示」を参照してください。

8. 選択した内容を確認し、「作成」をクリックします。

関連項目:
Oracle Application Express SQLワークショップ・ガイドの「ユーザー・インタフェースのデフォルト値の管理」

11.2.5 ページの作成ウィザードを使用した表形式フォームの作成

ページの作成ウィザードを使用して、既存のアプリケーションに表形式フォームを追加します。表形式フォームの基となる表の名前を指定すると、その表の列がデータベース・データ・ディクショナリから読み取られます。

表形式フォームでは、表の列に対する挿入、更新および削除操作が実行されます。アプリケーションの作成ウィザードとは異なり、ページの作成ウィザードを使用して表形式フォームを作成するときに、行の識別方法を決定します。表に定義されている主キー、または表内の行を一意に識別するROWID擬似列のいずれかを指定できます。主キーを選択する場合は、3種類の主キーのソース・タイプ(トリガー、PL/SQLファンクションおよび順序)の中から選択できます。

ヒント:
表形式の作成時には、汎用列テンプレートを使用し、列レポート・テンプレートは使用しないことをお薦めします。「レポート・テンプレート」を参照してください。

ページの作成ウィザードを使用して表形式フォームを作成するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「ページの作成」をクリックします。

4. 「ページの作成」で、次のステップを実行します。

1. ユーザー・インタフェース: ページのユーザー・インタフェースを選択します。

2. ページ・タイプの選択: 「フォーム」を選択します。

3. 「次へ」をクリックします。

5. 「表形式フォーム」を選択します。
表形式フォームの作成ウィザードが表示されます。

6. 「表および列」で、次のステップを実行します。

1. 表/ビューの所有者: 表形式フォームのベースにする表またはビューの所有者を選択します。

2. 表/ビューの名前: 表形式フォーム・リージョンに含める列を含む表またはビューを選択します。

3. 列の選択: 表形式フォームに含める1つ以上の列を選択します。その後のページで、どの列を更新可能にするかを定義します。

4. 実行可能な操作: 表で実行する操作(たとえば、更新、挿入、削除)を選択します。

5. ユーザー・インタフェースのデフォルト値を使用: ユーザー・インタフェースのデフォルト値を使用するかどうかを選択します。詳細は、フィールドレベル・ヘルプおよび『Oracle Application Express SQLワークショップ・ガイド』のユーザー・インタフェースのデフォルト値の管理に関する項を参照してください。

6. 「次へ」をクリックします。

次に、主キーを定義します。表形式フォームでは、データベース内の表の行に対する挿入、更新および削除操作が実行されます。表に定義されている主キー、または表内の行を一意に識別するROWID擬似列のいずれかを使用して、行を識別します。

7. 「主キー」で、次のいずれかの項目を選択します。

- データベースで管理(ROWID): 表形式フォームは、ROWID擬似列を使用して、更新および削除する行を識別します。

- 主キー列の選択: 表形式フォームは、ソース表の主キー列を使用します。

8. 「データベースで管理(ROWID)」を選択した場合は、「次へ」をクリックして続行します。

9. 「主キー列の選択」を選択した場合は、次のようにします。

1. 主キー列1: 主キーの最初の列を選択します。

2. 主キー列2: 複合主キーが含まれている場合は、この属性の2つ目の主キー列を指定します。この属性はオプションです。

3. 「次へ」をクリックします。

4. 「ソース・タイプ」で、主キーの移入方法を選択します。

- 既存のトリガー: 挿入前トリガーによって主キーが移入される場合は、このオプションを選択します。このオプションは、フォームを完成させた後に主キー列ソースを指定する場合も選択できます。

- カスタムPL/SQLファンクション: 戻りキー値を生成するPL/SQLファンクションを指定する場合はこのオプションを選択します。

- 既存の順序: 選択されているスキーマで使用可能な順序のリストから順序を選択する場合は、このオプションを選択します。

5. 「次へ」をクリックします。

10. 「更新可能な列」で、次のステップを実行します。

1. 更新可能な列: フォームに含める更新可能な列を選択します。
ページの作成後、列の順序またはSQL問合せを変更できます。

2. 「次へ」をクリックします。

11. 「ページおよびリージョン属性」で、次のステップを実行します。

ヒント:
属性の詳細は、フィールドレベル・ヘルプを参照してください。「フィールドレベル・ヘルプの表示」を参照してください。

1. ページ: 更新可能な新しいレポートを含めるページを選択するか、または新しいページ番号を入力します。

2. ページ名: 新しいページを作成する場合は、名前を入力します。

3. ページ・モード: ページ・モードを選択します。

4. リージョン・タイトル: 更新可能なレポートが表示されるリージョンの名前を入力します。

5. リージョン・テンプレート: 更新可能なレポート・リージョンのリージョン・テンプレートを選択します。

6. レポート・テンプレート: レポート・テンプレートを選択します。

7. ブレッドクラム: ページでブレッドクラム・ナビゲーション・コントロールを使用するかどうか、およびどのブレッドクラム・ナビゲーション・コントロールを使用するかを選択します。

8. 「次へ」をクリックします。

12. 「ナビゲーション・メニュー」で、このページに含めるナビゲーションのタイプを指定し、「次へ」をクリックします。ナビゲーション・オプション(ナビゲーション・メニューまたはタブなど)はカレント・アプリケーションのテーマに応じて決まります。

13. 「ボタンとブランチ」で、次のステップを実行します。

1. 「取消」ボタン・ラベル: 「取消」ボタンに表示するテキストを入力します。

2. ページにブランチ: ユーザーが「取消」をクリックしたときの、ブランチ先のページ番号を指定します。

3. 変更の適用ボタン・ラベル: 「変更の適用」ボタンに表示されるテキストを入力します。

4. ページにブランチ: ユーザーが「送信」をクリックしたときの、ブランチ先のページ番号を指定します。

5. 「削除」ボタン・ラベル: 「削除」ボタンに表示するテキストを入力します。

6. 「行の追加」ボタン・ラベル: 「行の追加」ボタン・ラベルに表示するテキストを入力します。

7. 「次へ」をクリックします。

14. 「作成」をクリックします。
成功メッセージが表示されます。

11.2.6 表形式フォームの列の順序とリージョン・ソースの同期

クラシック・レポートの列の順序を、リージョン・ソースの問合せで定義された列の順序と同期化するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 表形式フォームを含むページを選択します。

4. コンポーネント・ビューでページを表示します。「コンポーネント・ビューでのページの表示」を参照してください。

5. レポート属性ページにアクセスするには、表形式フォーム・リージョンの横にある「レポート」リンクをクリックします。

6. 「タスク」から、「列の順序とリージョン・ソースの同期化」を選択します。

7. 「同期化」をクリックします。

11.3 マスター・ディテール・フォームの管理

この項では、マスター・ディテール・フォームを作成する方法について説明します。

- マスター・ディテール・フォームについて

- アプリケーションの作成ウィザードを使用したマスター・ディテール・フォームの作成

- ページの作成ウィザードを使用したマスター・ディテール・フォームの作成

11.3.1 マスター・ディテール・フォームについて

マスター・ディテール・フォームは、データベースの2つの表の1対多関係を示します。通常、マスター・ディテール・フォームには、1つのHTMLフォーム内にマスター行および複数のディテール行が表示されます。このフォームを使用すると、2つの表またはビューに対し、値の挿入、更新および削除を行うことができます。

マスター・ディテール・フォームを実行すると、データは様々なフォーム要素(テキスト・フィールド、テキスト領域、日付ピッカー、選択リスト、ラジオ・グループなど)を使用してレポートとしてレンダリングされます。デフォルトでは、日付列は「日付ピッカー」アイテム・タイプを使用して作成されます。他の列については、ユーザー・インタフェースのデフォルト値を定義しておくことで、LOVに基づく選択リスト、または数値フィールドと大きなテキスト領域として自動的に作成できます。

「マスター・ディテール」では、マスター・レコードは標準フォームとして表示され、詳細レコードはページの下部の表形式フォームに表示されます。この例では、ユーザーは「Add Item to Order」をクリックして新しい行を追加します。

関連項目:
Oracle Application Express SQLワークショップ・ガイドの「ユーザー・インタフェースのデフォルト値の管理」

数値フィールドおよび日付フィールドについては、日付と数値の書式マスクを事前に定義したり、初期フォームの生成後にそれらの書式マスクを適用することもできます。また、ウィザードによって生成されるマスター・ディテール・フォームでは、一部の列に対して検証が自動的に作成されます。検証は、基礎となる表でNOT NULLに設定されている列、およびタイプがNUMBER、DATEまたはTIMESTAMPの列に対して作成されます。ユーザーの選択または定義済のユーザー・インタフェースのデフォルト値に基づいて、列が読取り専用に設定されている場合、検証は作成されません。

ヒント:
列属性を編集して、特定の列の外観を制御できます。

11.3.2 アプリケーションの作成ウィザードを使用したマスター・ディテール・フォームの作成

アプリケーションの作成ウィザードは、複数のページおよびコンポーネントで構成される基本的なOracle Application Expressアプリケーションを簡単に作成できるように設計されています。このウィザードでは、一般的なベスト・プラクティスに基づいてアプリケーションが生成され、ページの作成ウィザードに含まれているいくつかの高度なオプションは使用されません。

アプリケーションの作成ウィザードを使用してマスター・ディテール・フォームを作成するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. 「作成」ボタンをクリックします。

3. アプリケーション・タイプで「デスクトップ」を選択し、「次へ」をクリックします。

4. 「名前」で、次のステップを実行します。

1. スキーマ: アプリケーションは、すべてのSQLを特定のデータベース・スキーマとして解析することで、権限を取得します。データベース・スキーマ所有者を指定します。

2. 名前: 開発者がアプリケーションを識別するための名前を入力します。

3. アプリケーション: アプリケーションを識別する整数値を指定します。アプリケーションIDは、Application Expressインスタンス内で一意である必要があります。3000から9000の範囲のアプリケーションIDは、Oracle Application Expressの内部使用向けに予約されています。

4. テーマ: テーマを選択します。テーマは、アプリケーション全体のレイアウトおよびスタイルの定義に使用するテンプレートのコレクションです。「テーマの使用」を参照してください。

5. テーマ・スタイル: テーマ・スタイルを選択します。テーマ・スタイルは、テーマ42および51などの新しいアプリケーションに対してのみ使用可能です。「テーマ・スタイルの使用」を参照してください。

6. 「次へ」をクリックします。

ヒント:
ログイン・ページと空白ページのみを含むインスタント・アプリケーションを作成するには、「アプリケーションの作成」ボタンをクリックします。

次に、ページをアプリケーションに追加します。

5. 「ページの追加」ボタンをクリックします。
「ページの追加」で、次のステップを実行します。

1. ページ・タイプの選択: 「マスター・ディテール」を選択します。

2. 親ページ: 該当する場合、従属ページを選択します。属性の詳細は、フィールドレベル・ヘルプを参照してください。

3. マスター表名: マスター表として使用する表またはビューを選択します。この表は、レポート・ページ、およびマスター・ディテール・ページのマスター・フォームを作成するために使用されます。

4. ディテール表名: ディテール表として使用する表またはビューを選択します。
外部キーを使用して選択したマスター表に関連付けられている表およびビューのみが表示されます。

5. ページ・モード: ページ・モードを選択します。

6. 「ページの追加」をクリックします。
ページ上部に新しいページが表示されます。

7. 「次へ」をクリックします。

6. 「共有コンポーネント」で、共有コンポーネントを別のアプリケーションからコピーするかどうかを指定します。「はい」または「いいえ」を選択します。「はい」を選択した場合は、そのコピー元と、インポートするコンポーネントを選択します。「共有コンポーネントの管理」を参照してください。

7. 「属性」で、必要に応じて構成し、「次へ」をクリックします。

ヒント:
属性の詳細は、フィールドレベル・ヘルプを参照してください。「フィールドレベル・ヘルプの表示」を参照してください。

8. 選択内容を確認して、「アプリケーションの作成」をクリックします。

11.3.3 ページの作成ウィザードを使用したマスター・ディテール・フォームの作成

ページの作成ウィザードでは、データベースに外部キー・リレーションシップが定義されていない2つの表からマスター・ディテールを作成できます。基礎となるデータベースで外部キーと適切に定義されたリレーションシップを使用することをお薦めしますが、開発者は必ずしも各自のデータベース・モデルを変更できるわけではありません。

ウィザードを使用して作成したマスター・ディテール・フォーム・ページ上のマスター・フォームには、ユーザーがマスター結果セット内で前後に移動するためのボタンが含まれています。ウィザードの実行中に、どの列でナビゲーションの順序を決定するかを選択します。また、2ページまたは3ページで構成されるマスター・ディテール・フォームを作成し、個別のページの単一レコード編集でレポートに表示される詳細レコードを含めることもできます。

ページの作成ウィザードを使用してマスター・ディテール・フォームを作成するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「ページの作成」をクリックします。

4. 「ページの作成」で、次のステップを実行します。

1. ユーザー・インタフェース: ページのユーザー・インタフェースを選択します。

2. ページ・タイプの選択: 「フォーム」を選択します。

3. 「次へ」をクリックします。

5. 「マスター・ディテール・フォーム」を選択して、「次へ」をクリックします。
マスター・ディテール・ウィザードが表示されます。

6. 「マスター表と列」で、次のステップを実行します。

1. 表/ビューの所有者: マスター表を所有するスキーマを選択します。

2. 表/ビューの名前: マスター・ページに含める列を含む表またはビューを選択します。
そのオブジェクト内の列が表示されます。

3. 列の選択: マスター・ページに表示する列を選択します。後で列を追加できます。

4. ユーザー・インタフェースのデフォルト値を使用: ユーザー・インタフェースのデフォルト値を使用するかどうかを選択します。詳細は、フィールドレベル・ヘルプおよび『Oracle Application Express SQLワークショップ・ガイド』のユーザー・インタフェースのデフォルト値の管理に関する項を参照してください。

5. 「次へ」をクリックします。

7. 「ディテール表と列」で、次のステップを実行します。

1. 関連する表のみの表示: ディテール表のリストを、マスター表に関連する表のみに制限するかどうかを指定します。「はい」または「いいえ」を選択します。

2. 表/ビューの所有者: 表またはビューの所有者を選択します。デフォルトで選択された表またはビューの所有者は、アプリケーションの所有者と同一です。アプリケーションの所有者が他のスキーマの表またはビューに対するSELECT権限を持っている場合、他のスキーマを選択できます。

3. 表/ビューの名前: ディテール・ページに含める列を含む表またはビューを選択します。
そのオブジェクト内の列が表示されます。

4. 列の選択: ディテール・ページに表示する列を選択します。後で列を追加できます。

5. 「次へ」をクリックします。

次に、主キーを定義します。フォームでは、データベース内の表の行に対する挿入、更新および削除操作が実行されます。表に定義されている主キー、または表内の行を一意に識別するROWID擬似列のいずれかを使用して、行を識別します。

8. 「主キーの定義」で、各表に対して次のいずれかを選択します。

- データベースで管理(ROWID): ROWID擬似列を使用して、更新および削除する行を識別します。

- 主キー列の選択: ソース表の主キー列を使用します。

9. 「データベースで管理(ROWID)」を選択した場合は、次のステップを実行します。

1. 「次へ」をクリックします。

2. 「マスター・オプション」で、マスター表とディテール表の関係を定義します。列名(表名で完全修飾された名前)を入力するか、またはリストから列名を選択できます。「次へ」をクリックします。

3. 「次へ」をクリックします。

10. 「主キー列の選択」を選択した場合は、次のようにします。

1. 「主キーの定義」で、各表について次の項目を選択します。

- 主キー列1: 主キーの最初の列を選択します。

- 主キー列2: 複合主キーが含まれている場合は、この属性の2つ目の主キー列を指定します。この属性はオプションです。

- 「次へ」をクリックします。

2. 「主キーのソース」で、主キーの移入方法を選択し、「次へ」をクリックします。

- 既存のトリガー: 挿入前トリガーによって主キーが移入される場合は、このオプションを選択します。このオプションは、フォームを完成させた後に主キー列ソースを指定する場合も選択できます。

- カスタムPL/SQLファンクション: 戻りキー値を生成するPL/SQLファンクションを指定する場合はこのオプションを選択します。

- 既存の順序: 選択されているスキーマで使用可能な順序のリストから順序を選択する場合は、このオプションを選択します。

3. 「マスター・オプション」で、マスター行のナビゲーションを含めるかどうかを指定して、「次へ」をクリックします。
マスター行のナビゲーションを含める場合は、ナビゲーション順の列を定義します。ナビゲーション順の列が定義されていないと、マスターの更新フォームは、主キー列を使用してナビゲートします。

4. 「次へ」をクリックします。

11. 「マスター・オプション」で、次のステップを実行します。

1. マスター行ナビゲーションを含めますか。 - マスター行ナビゲーションを使用すると、ユーザーはマスター更新フォームをナビゲートできます。マスター行ナビゲーションを含めるには、「はい」を選択します。

2. マスター行のナビゲーションの順序 - ナビゲーション順の列を選択します。列を選択しなかった場合、ナビゲーションはマスター表の主キーで順序付けされます。

3. セカンダリ・ナビゲーションの順序 - セカンダリ・ナビゲーション順の列を選択します。

4. マスター・レポートを含めますか。 - すでにレポート・ページがある場合は、マスター・レポート・ページを作成しないように選択できます。マスター・レポート・ページを含めるには、「はい」を選択します。

5. 「次へ」をクリックします。

12. マスター・ディテールの構築で、マスター・ディテール・ページのレイアウトを選択し、「次へ」をクリックします。オプションは次のとおりです

- 同一ページで表形式フォームとしてディテールの編集 - 2ページのマスター・ディテールが作成されます。

- 別のページでディテールの編集 - 3ページのマスター・ディテールが作成されます。

13. 「ページ属性」で、次のステップを実行します。

ヒント:
属性の詳細は、フィールドレベル・ヘルプを参照してください。「フィールドレベル・ヘルプの表示」を参照してください。

1. ページ属性: マスター・ページおよびディテール・ページ情報を確認および編集します。

2. ディテール・ページのディテール・リージョンのタイトル - ディテール・ページのタイトルを入力します。

3. ページ・グループ - このページと関連付けるページ・グループの名前を指定します。

4. ブレッドクラム: ページでブレッドクラム・ナビゲーション・コントロールを使用するかどうか、およびどのブレッドクラム・ナビゲーション・コントロールを使用するかを選択します。ブレッドクラム・エントリを作成するには、次のステップを実行します。

- 親エントリ: このブレッドクラム・エントリの親エントリを選択します。

- エントリ名(マスター・レポート): マスター・レポート・ページのブレッドクラム・エントリの名前を指定します。

- エントリ名(マスター・ディテール・ページ): マスター・ディテール・ページのブレッドクラム・エントリの名前を指定します。

- 親エントリ: このアイテムは、親エントリを選択している場合に表示されます。

5. 「次へ」をクリックします。

14. 「ナビゲーションのプリファレンス」で、このページに含めるナビゲーションのタイプを指定し、「次へ」をクリックします。ナビゲーション・オプション(ナビゲーション・メニューまたはタブなど)はカレント・アプリケーションのテーマに応じて決まります。

15. 「作成」をクリックします。

11.4 コンポーネント・ビューでのフォームの手動作成

この項では、フォームを手動で作成する方法について説明します。

- コンポーネント・ビューでのフォームの手動作成について

- フォームの処理

- コンポーネント・ビューでのフォームの移入

関連項目:
コンポーネント・ビューでのページの管理

11.4.1 コンポーネント・ビューでのフォームの手動作成について

次のステップを実行することによって、フォームを手動で作成することもできます。

- ステップ1 - (ページ・アイテムのコンテナとして機能する) HTMLリージョンを作成します

- ステップ2 - リージョンに表示するアイテムを作成します

- ステップ3 - プロセスおよびブランチを作成します

HTMLリージョンを作成することによって手動でフォームを作成するには、次のステップを実行します。

1. 適切なページにナビゲートします。「コンポーネント・ビューでのページの表示」を参照してください。

2. HTMLリージョンを作成します。「コンポーネント・ビューでのリージョンの作成」を参照してください。

3. ページへのアイテムの追加を開始します。「ページ・レベル・アイテムの理解」を参照してください。

11.4.2 フォームの処理

フォームを作成したら、次に、基礎となるデータベース表またはビューに対して挿入または更新を行うことによって、ユーザーが入力したデータを処理します。この項では、フォームを処理する3つの方法について説明します。

- 行の自動処理(DML)プロセスの作成

- 1つ以上の挿入文を含むプロセスの作成

- PL/SQL APIを使用したフォーム値の処理

11.4.2.1 行の自動処理(DML)プロセスの作成

フォームを実装するための一般的な方法の1つは、行の自動処理(DML)プロセスを手動で作成することです。この方法には、3つのメリットがあります。1つ目は、SQLコードを指定する必要がないことです。2つ目は、Oracle Application ExpressによってDMLプロセスが実行されることです。3つ目は、このプロセスによって、ロストした更新の検出が自動的に実行されることです。ロストした更新の検出によって、データに同時にアクセスできる複数のアプリケーションのデータの整合性が保証されます。

この方法を実現するには、次のステップを実行します。

- アイテムを追加し、「アイテム・ソース」タイプを「データベース列」に定義し、大/小文字が区別される列名を指定します。

- オプション「常にキャッシュ値より優先」を選択します。

行の自動処理(DML)プロセスを作成するには、次のステップを実行します。

1. 適切なページにナビゲートします。「コンポーネント・ビューでのページの表示」を参照してください

2. ページ・プロセスの作成ウィザードにアクセスします。「プロセス」で、「作成」アイコンをクリックします。

3. 「プロセス・タイプ」で、「データ操作」を選択し、「次へ」をクリックします。

4. プロセス・カテゴリ「行の自動処理(DML)」を選択し、「次へ」をクリックします。

5. 「プロセス属性」で、次のステップを実行します。

1. 名前 - プロセスを識別するための名前を入力します。

2. 順序 - 順序番号を指定します。

3. ポイント - このプロセスの実行ポイントを選択します(「ロード時 - ヘッダーの後」など)。

4. タイプ - 選択したプロセス・タイプを表示します。

5. 「次へ」をクリックします。

6. 画面に表示されるステップに従います。

11.4.2.2 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;

11.4.2.3 PL/SQL APIを使用したフォーム値の処理

アプリケーションによっては、表へのすべてのアクセスを単一または少数のPL/SQLパッケージにまとめて処理することが適しています。DML操作を処理するパッケージを作成した場合は、このパッケージのプロシージャおよびファンクションを、送信後のPL/SQLプロセスからコールして、リクエストの挿入、更新および削除を処理できます。

11.4.3 コンポーネント・ビューでのフォームの移入

Oracle Application Expressでは、ロード時またはApplication Expressエンジンによるページのレンダリング時にフォームが移入されます。フォームを移入するには、次のステップを実行します。

- プロセスを作成し、タイプを「行の自動フェッチ」に定義します。

- 非表示のセッション・ステート・アイテムを参照することによって、フォームを手動で移入します。

行の自動フェッチ・プロセスを作成するには、次のステップを実行します。

1. 適切なページにナビゲートします。「コンポーネント・ビューでのページの表示」を参照してください。

2. ページ・プロセスの作成ウィザードにアクセスします。「プロセス」で、「作成」アイコンをクリックします。

3. 「プロセス・タイプ」で、「データ操作」を選択し、「次へ」をクリックします。

4. プロセス・カテゴリを選択し、「行の自動フェッチ」を選択して「次へ」をクリックします。

5. 「プロセス属性」で、次のステップを実行します。

1. 名前 - プロセスを識別するための名前を入力します。

2. 順序 - 順序番号を指定します。

3. ポイント - このプロセスの実行ポイントを選択します。

4. タイプ - 選択したプロセス・タイプを表示します。

5. 「次へ」をクリックします。

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の値は、設定済です。

- このプロセスのプロセス・ポイントは、「ロード時 - リージョンの前」またはこれ以前に実行するように設定されます。

11.5 フォームでのユーザー入力の検証

この項では、フォームのユーザー入力を検証する方法について説明します。

- 検証およびエラー・メッセージの作成について

- ページ・デザイナでの検証と特定のアイテムとの関連付け

- コンポーネント・ビューでの検証と特定のアイテムとの関連付け

- エラー・メッセージ表示位置について

11.5.1 検証およびエラー・メッセージの作成について

検証を使用すると、ユーザーが入力したデータを処理前に確認できます。検証および関連するエラー・メッセージを作成したら、これらを特定のアイテムと関連付けることができます。検証エラー・メッセージをインライン表示(検証が実行されたページで表示)するか、個別のエラー・ページで表示するかを選択できます。

インラインのエラー・メッセージを作成するには、次のステップを実行します。

- ステップ1 - 検証を作成し、エラー・メッセージ・テキストを指定します。詳細は、「検証の理解」を参照してください。

- ステップ2 - 検証を特定のアイテムと関連付けます。

11.5.2 ページ・デザイナでの検証と特定のアイテムとの関連付け

アイテムを検証と関連付け、エラー・メッセージ・テキストを指定するには、次のステップを実行します。

1. ページ・デザイナで適切なページにナビゲートします。「ページ・デザイナでのページの表示」を参照してください。

2. ページ・デザイナで「プロセス」ツリーを選択します。

3. 「検証中」で、関連付ける検証アイテムを選択します。
プロパティ・エディタの表示が「プロパティ・エディタ - 検証」に変わります。

4. 「すべて閉じる」アイコンをクリックし、「プロパティ・エディタ・メニュー」から「すべて表示」を選択します。

5. 「エラー」を展開し、次のように構成します。

- エラー・メッセージ - エラー・メッセージを入力または編集します。

- 表示位置 - 検証エラー・メッセージの表示位置を指定します。表示位置を確認します。

- 関連付けられたアイテム: 対象の検証と関連付けるアイテムを選択します。

6. 「保存」をクリックします。

11.5.3 コンポーネント・ビューでの検証と特定のアイテムとの関連付け

アイテムを検証と関連付け、エラー・メッセージ・テキストを指定するには、次のステップを実行します。

1. コンポーネント・ビューで適切なページにナビゲートします。「コンポーネント・ビューでのページの表示」を参照してください。

2. ページ検証の編集ページにナビゲートします。「検証」で、関連付ける検証を選択します。
検証の属性ページが表示されます。

3. 「エラー・メッセージ」までスクロールします。

4. 「エラー・メッセージ」で、次のように入力します。

- エラー・メッセージ - エラー・メッセージを入力します。

- エラー・メッセージ表示位置 - 検証エラー・メッセージの表示位置を指定します。表示位置を確認します。

- 関連付けられたアイテム: 対象の検証と関連付けるアイテムを選択します。

5. 「変更の適用」をクリックします。

11.5.4 エラー・メッセージ表示位置について

エラー・メッセージ表示位置は、検証エラー・メッセージがどこに表示されるかを指定します。検証エラー・メッセージは、エラー・ページに表示したり、既存ページ内にインラインで表示できます。インライン・エラー・メッセージは、通知領域(ページ・テンプレートの一部として定義される)に表示したり、フィールド・ラベル内に表示できます。

残りのすべての検証を含むプロセスを停止するハード・エラーを作成する場合は、エラー・ページにエラーを表示する必要があります。

11.6 フォームでのBLOBサポートの理解

この項では、フォームでのBLOBサポートについて説明します。

- フォームでのBLOBサポートについて

- BLOBへのファイルのアップロードとダウンロードについて

- BLOBの表示について

- イメージ参照の削除について

11.6.1 フォームでのBLOBサポートについて

フォームを作成する場合(アプリケーションの作成ウィザードを使用して、フォーム型(またはレポートおよびフォーム型)のページを作成するか、フォーム型のリージョンを作成する)、または既存のフォームにアイテムを追加する場合、BLOB型のデータベース列がソースであるアイテムは、ファイル参照型のアイテムになります。フォームがINSERTにコールされる場合、ユーザーが選択したファイルは、BLOB列にロードされます。フォームが更新にコールされる場合、ダウンロード・リンクが「参照」ボタンの右に表示されます。ユーザーは、このリンクを使用してファイルをダウンロードできます。

11.6.2 BLOBへのファイルのアップロードとダウンロードについて

デフォルトのBLOBサポートでは、一般的なアプリケーションでBLOBを効果的に管理するために必要とされるすべての情報が提供されているわけではありません。列がBLOBであるという情報に加えて、ファイルの詳細情報も提供されると、エンド・ユーザーの使いやすさが向上します。ファイル参照ページ・アイテムには、この追加情報を完全に宣言的に管理することを容易にするための追加設定があります。

関連項目:
付録A、「アイテム・タイプについて」の「ファイル参照」、「ファイル参照」設定のアイテム・レベル・ヘルプ

ファイル参照アイテム・タイプ内では、次の2つの異なるタイプの記憶域タイプが使用できます。

- アイテム・ソース属性で指定されたBLOB列: ここで説明する追加設定の構成をサポートする、完全に宣言的なアプローチです。これは、所有するデータベース表のBLOBを参照します。

- WWV_FLOW_FILES表: 下位互換性のために用意されています。新しいアプリケーションでは使用できません。

- APEX_APPLICATION_TEMP_FILES表: APEX_APPLICATION_TEMP_FILESビューでアクセスできる一時的な場所に、アップロードされたファイルを格納します。「ファイルをパージするタイミング」の選択に応じて、Oracle Application Expressにより、セッションの最後またはアップロード要求の最後にファイルが自動的に削除されます。

この追加情報を提供するには、MIMEタイプ、ファイル名、最終更新日およびキャラクタ・セット設定を格納および追跡するための追加の列を元表に追加することをお薦めします。これは表を拡張することで実行できます。次に例を示します。

ALTER TABLE emp ADD
(ATTACH_MIMETYPE     VARCHAR2(255),
ATTACH_FILENAME     VARCHAR2(255),
ATTACH_LAST_UPDATE  DATE,
ATTACH_CHARSET      VARCHAR2(128));

注意:
BLOBのキャラクタ・セットはアップロード時に自動的に設定されません。BLOBのキャラクタ・セット値を格納する場合、キャラクタ・セットを格納するために使用する列にバインドされる追加のページ・アイテムをページに提供する必要があり、ユーザーはその場合、アップロードするドキュメント用のキャラクタ・セットを指定できるようになります。

カスタム表でフォームを手動作成する場合も、この機能を利用できます。このことを行うには、DMLプロセス・タイプがDML_PROCESS_ROWのページにおいて、「記憶域タイプ」設定が「アイテム・ソース属性で指定されたBLOB列」である「ファイル参照」アイテム・タイプを使用します。このプロセスによって、表名と主キー列が決定されます。

11.6.3 BLOBの表示について

作業中のBLOBがイメージである場合は、そのイメージをフォームでも表示できます。これを宣言的に処理するために、イメージの表示アイテム・タイプを使用できます。付録A、「アイテム・タイプについて」を参照してください。手続き的な処理については、「フォームおよびレポートでのBLOBサポートの理解」を参照してください。

11.6.4 イメージ参照の削除について

ファイル参照の使用時は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;

12 データベース・アプリケーション・コンポーネントの管理

この項では、カレンダ、マップ、チャートおよびヘルプなどのデータベース・アプリケーション・コンポーネントを作成および管理する方法について説明します。

- カレンダの作成

- マップの作成

- チャートの作成

- アプリケーションのヘルプの作成

関連項目:
「レポートの開発」、「ページ・レイアウトの制御」および「ナビゲーションの追加」

12.1 カレンダの作成

この項では、アプリケーション・ビルダーでカレンダを作成する方法について説明します。アプリケーション・ビルダーには月次、週次、日次およびリスト表示のカレンダを生成するための組込みウィザードが含まれています。カレンダのベースとなる表を一度指定すると、特定の列に格納された情報へのドリルダウン・リンクを作成して、ドラッグ・アンド・ドロップ機能を有効化できます。

- サポートされているカレンダについて

- サンプル・カレンダ

- 新しいページへのカレンダの追加

- ページ・デザイナでのカレンダ属性の管理

- コンポーネント・ビューでのカレンダの管理

- 日付列の書式マスクについて

- 既存のカレンダでのデータのドラッグ・アンド・ドロップの有効化

- レガシー・カレンダでサポートされているカレンダ置換文字列について

12.1.1 サポートされているカレンダについて

アプリケーション・ビルダーでは、次の2つのカレンダ・タイプがサポートされています。

- カレンダ - カレンダは、FullCalendar jQueryライブラリをベースにしており、CSSを介してのみカスタマイズできます。

- レガシー・カレンダ - レガシー・カレンダはテンプレートベースで、今後のリリースでは非推奨になります。

ヒント:
以前のリリースでは、レガシー・カレンダはカレンダ(テンプレート)、クラシック・カレンダ、簡易カレンダおよびSQLカレンダと呼ばれていました。

両方のカレンダ・オプションで、指定した表またはSQL問合せをベースとするカレンダを作成できます。作成プロセス中、日付列と表示列を選択するプロンプトが表示されます。適切なユーザー・インタフェースと様々な追加機能が提供されるため、すべてのレガシー・カレンダを最新カレンダに変換することをお薦めします。

Calendar

カレンダ・オプションでは、次のことがサポートされます。

- 複数ビューでのカレンダ・イベントのレンダリング(「月」、「週」、「日」または「リスト」)。

- 期間ベース・イベントおよび期間ベースでないイベントのレンダリング。

- イベントを異なる日付にドラッグ・アンド・ドロップすることによって開始日および終了日を変更する機能。

- イベントの長さをサイズ変更したり、終了日を変更することによって期間を変更する機能。

- フォームを使用し、イベントまたは空のカレンダ・セルのいずれかをクリックすることによって、カレンダの新規イベントを編集または追加する機能。

- Webサービス・コールまたはGoogleカレンダ・フィードを使用した外部ソースからのイベントのレンダリング。

- 単一または複数の行でイベント・タイトルをレンダリングする機能。

- 様々なCSSクラスを使用して、開発者は様々なイベント・タイプに様々なスタイルを選択できます。

- PDFの印刷可能な書式でイベントをダウンロードする機能

- イベントを共有する複数の形式(iCal、CSV、XML)のサポート。

- 各イベントの詳細を簡単に確認できるように、月次/週次/日次ビューにツールチップを追加する機能。

レガシー・カレンダ

レガシー・カレンダ・オプションでは、次のことがサポートされます。

- 1ページにつき1つのレガシー・カレンダの作成。

- 開始日のみのレンダリング。

- テンプレートによって定義されるルック・アンド・フィール。

- イベントのドラッグ・アンド・ドロップによる開始日の変更。

- 日次、週次、月次ビューを含むカレンダ。

- 日付列は、エントリが含まれるカレンダ上の日付を決定します。

- 表示列は、カレンダを表示する特定の行を定義します。

12.1.2 サンプル・カレンダ

次に、サンプル・データベース・アプリケーションからのサンプル・カレンダを示します。

このカレンダには次のボタンが含まれています。

- 前へ - 前月にナビゲートします。

- 次へ - 翌月にナビゲートします。

- 月 - すべての順序の月次ビューを表示します。

- リスト - すべての順序のリストを表示します。

ヒント:
基礎となるSQLを表示するには、ページ下部のSQLソース・リージョンを展開します。

12.1.3 新しいページへのカレンダの追加

この項では、アプリケーションのホームページから新規カレンダを追加する方法について説明します。

- 新しいページへのカレンダの追加

- 新しいページへのレガシー・カレンダの追加

関連項目:
「サポートされているカレンダについて」

12.1.3.1 新しいページへのカレンダの追加

アプリケーションのホームページからカレンダを作成するには、次のステップを実行します。

1. ページの作成ウィザードを実行します。

1. 「ワークスペース」ホームページにナビゲートします。

2. 「アプリケーション・ビルダー」アイコンをクリックします。

3. アプリケーションを選択します。

4. 「ページの作成」をクリックします。
ページの作成ウィザードが表示されます。

2. 「ページの作成」で、次のステップを実行します。

1. ユーザー・インタフェース: ページのユーザー・インタフェースを選択します。

2. ページ・タイプの選択: 「カレンダ」を選択します。

3. 「次へ」をクリックします。

3. 「カレンダ」を選択して、「次へ」をクリックします。

4. 「ページおよびリージョン属性」で、次のステップを実行します。

ヒント:
属性の詳細は、フィールドレベル・ヘルプを参照してください。「フィールドレベル・ヘルプの表示」を参照してください。

1. ページ番号: 新しいページ番号を指定した場合、ウィザードによって新しいページが作成されます。既存のページ番号を指定した場合、ウィザードによってそのページにコンポーネントが追加されます。

2. ページ名: 作成するページのタイトルを入力します。

3. ページ・モード: ページ・モードを選択します。

4. リージョン名: カレンダを含めるリージョンの名前を入力します。

5. ブレッドクラム: ページでブレッドクラム・ナビゲーション・コントロールを使用するかどうか、およびどのブレッドクラム・ナビゲーション・コントロールを使用するかを選択します。

6. 「次へ」をクリックします。

5. 「ナビゲーション・メニュー」で、このページに含めるナビゲーションのタイプを指定し、「次へ」をクリックします。表示されるナビゲート・オプションは、カレント・アプリケーション・テーマによって異なります。

6. 「ソース」で、カレンダ・ソースが表かSQL問合せかを選択します。
カレンダ・ソースが表の場合:

1. ソース・タイプ - 「表」を選択します。

2. 表/ビューの所有者 - カレンダを作成している表の所有者を選択します。

3. 表/ビューの名前 - カレンダの基になる表またはビューを選択します。

4. 列の選択 - カレンダに含める1つ以上の列を選択します。

5. 「次へ」をクリックします。

カレンダ・ソースがSQL問合せの場合:

1. ソース・タイプ - 「SQL問合せ」を選択します。

2. リージョン・ソースの入力 - カレンダに使用するSQL SELECT文を入力します。SQL SELECT文には2列以上を含める必要があり、そのうち1つはDATE列にする必要があります。
例は、フィールドレベル・ヘルプを参照してください。

3. 「次へ」をクリックします。

7. 「設定」で、次の項目を指定します。

1. 表示列 - このカレンダのイベントに表示されるテキストを保持する列を選択します。

2. 開始日列 - このカレンダに表示されるイベントの開始日を保持する列を選択します。

3. 終了日列 - このカレンダに表示されるイベントの終了日を保持する列を選択します。この属性を指定すると、カレンダには期間ベース・イベントが表示されます。

4. 時間の表示 - 日付の時間部分を表示するかどうかを選択します。

5. 作成ページの追加 - 新しいフォーム・ページを作成するかどうかを特定します。このフォームは、カレンダへのイベントの追加に使用されます。

6. 編集ページの追加 - 新しいフォーム・ページを作成するかどうかを特定します。このフォームは、カレンダへのイベントの編集に使用されます。

7. ドラッグ・アンド・ドロップ・コードの生成 - カレンダにドラッグ・アンド・ドロップのコードを含めるかどうかを指定します。このコードによって、エンド・ユーザーが1つの日付から別の日付にイベントをドラッグ・アンド・ドロップしたときの、イベント・レコードの更新に対するサポートが追加されます。

8. 「次へ」をクリックします。

8. 「作成/編集ページ」を含めることを選択した場合は、属性を設定し、画面に表示されるステップに従います。

9. 「作成」をクリックします。

ヒント:
ページ・デザイナで、新しいリージョン・タイプ「カレンダ」を直接追加する場合、カレンダのSQL問合せを指定して、「PL/SQLコードのドラッグ・アンド・ドロップ」などの追加属性を手動で定義する必要があります。また、手動でページの作成および編集を定義したり、既存のフォーム・ページにリンクする必要もあります。

12.1.3.2 新しいページへのレガシー・カレンダの追加

以前のリリースでは、レガシー・カレンダはカレンダ(テンプレート)、クラシック・カレンダ、簡易カレンダおよびSQLカレンダと呼ばれていました。レガシー・カレンダはテンプレートベースで、今後のリリースでは非推奨になります。

ヒント:
ページの作成ウィザードを実行してレガシー・カレンダを作成するときに、ドラッグ・アンド・ドロップ機能を有効化するために、オンデマンド・ページ・プロセスを手動で作成する必要があります。「既存のカレンダでのデータのドラッグ・アンド・ドロップの有効化」を参照してください。

ページの作成ウィザードを実行してレガシー・カレンダを作成するには、次のステップを実行します。

ヒント:
属性の詳細は、フィールドレベル・ヘルプを参照してください。「フィールドレベル・ヘルプの表示」を参照してください。

1. ページの作成ウィザードを実行します。

1. 「ワークスペース」ホームページにナビゲートします。

2. 「アプリケーション・ビルダー」アイコンをクリックします。

3. アプリケーションを選択します。

4. 「ページの作成」をクリックします。
ページの作成ウィザードが表示されます。

2. 「ページの作成」で、次のステップを実行します。

1. ユーザー・インタフェース: ページのユーザー・インタフェースを選択します。

2. ページ・タイプの選択: 「カレンダ」を選択します。

3. 「次へ」をクリックします。

3. 「カレンダ(テンプレート)」を選択して、「次へ」をクリックします。

4. 「ページ属性」で、次のステップを実行します。

1. ページ番号: 新しいページ番号を指定した場合、ウィザードによって新しいページが作成されます。既存のページ番号を指定した場合、ウィザードによってそのページにコンポーネントが追加されます。

2. ページ名: 作成するページのタイトルを入力します。

3. ページ・モード: ページ・モードを選択します。

4. リージョン・テンプレート: 新しいカレンダ・リージョンのリージョン・テンプレートを選択します。テンプレートは、リージョンの外観を制御します。

5. リージョン名: カレンダを含めるリージョンの名前を入力します。

6. 表示タイプ: カレンダの動作を決定します。オプションは次のとおりです。

- 標準: ページが、関連するリクエストとともに送信されます。

- 部分ページ・リフレッシュ: 「カレンダ」リージョンのみがリフレッシュされます。

ヒント:
カレンダが作成されると、表示タイプは変更できません。表示タイプを変更するには、カレンダを削除してから、再作成する必要があります。

7. ブレッドクラム: ページでブレッドクラム・ナビゲーション・コントロールを使用するかどうか、およびどのブレッドクラム・ナビゲーション・コントロールを使用するかを選択します。

8. 「次へ」をクリックします。

5. 「ナビゲーションのプリファレンス」で、このページに含めるナビゲーションのタイプを指定し、「次へ」をクリックします。ナビゲーション・オプション(ナビゲーション・メニューまたはタブなど)はカレント・アプリケーションのテーマに応じて決まります。

6. 「ソース」で、カレンダ・ソースが表かSQL問合せかを選択します。
カレンダ・ソースが表の場合:

1. ソース: 「表」を選択します。

2. 所有者: カレンダの作成元の表を所有するデータベース・スキーマを選択します。

3. 表/ビューの名前: カレンダで使用する表を指定します。

4. 「次へ」をクリックします。

カレンダ・ソースがSQL問合せの場合:

1. ソース: 「SQL問合せ」を選択します。

2. SQL問合せ: カレンダで使用するSQL SELECT文を入力します。SQL SELECT文には2列以上を含める必要があり、そのうち1つはDATE列にする必要があります。
例は、フィールドレベル・ヘルプを参照してください。

3. 「次へ」をクリックします。

7. 「カレンダ属性」で、次のステップを実行します。

1. 日付列: カレンダにエントリを配置する際に、日付として使用する列を指定します。

2. 表示列: カレンダに表示する列を指定します。

3. 日付書式: カレンダの日付の表示方法を指定します。オプションは次のとおりです。

- 日付のみ: 結果は月次およびリスト・カレンダで表示されます。

- 日付と時間: 結果は月次、週次、日次およびリスト・カレンダで表示されます。

4. カスタム日付範囲: カスタムの開始日および終了日を含めるかどうかを指定します。1か月を超える分を月次カレンダに表示できるようにする場合に、このオプションを使用します。

5. 「次へ」をクリックします。

次に、カレンダ・エントリの「リンクの詳細」を定義します。「リンク・ターゲット」により、ユーザーがカレンダ・エントリを選択したときのリダイレクト先が決まります。

8. 「リンクの詳細」で、次のステップを実行します。

1. リンク・ターゲット: カレンダ・エントリがリンク・ターゲットを持つかどうかを指定します。カレンダ・エントリを選択すると、ユーザーはリンク・ターゲットにリダイレクトされます。選択された「リンク・ターゲット」により、表示される追加属性が決まります。
詳細は、フィールドレベル・ヘルプを参照してください。

2. 「次へ」をクリックします。

9. 「作成」をクリックします。

12.1.4 ページ・デザイナでのカレンダ属性の管理

ヒント:
SQL問合せに基づいたカレンダの作成時に、ドラッグ・アンド・ドロップ機能を有効化するために、オンデマンド・ページ・プロセスを手動で作成する必要があります。「既存のカレンダでのデータのドラッグ・アンド・ドロップの有効化」を参照してください。

作成したカレンダは、プロパティ・エディタで属性を編集することで表示を変更できます。各カレンダには、2セットの編集可能な属性(リージョン属性とカレンダ属性)があります。リージョン属性は、カレンダのコンテナとして機能するページの領域を定義します。カレンダ属性は、テンプレート、日付列および一般的なカレンダ書式設定を指定します。

- プロパティ・エディタでのカレンダ属性の編集

- 追加および編集機能を含めるように既存のカレンダを編集

関連項目:
「コンポーネント・ビューでのカレンダの管理」

12.1.4.1 プロパティ・エディタでのカレンダ属性の編集

カレンダ属性を編集するには、次のステップを実行します。

1. ページ・デザイナで適切なページにナビゲートします。「ページ・デザイナでのページの表示」を参照してください。
ページ・デザイナが表示されます

2. 「レンダリング」ツリーで、カレンダ・タイトルを選択します。
プロパティ・エディタにリージョン属性が表示されます。

3. 「レンダリング」ツリーのカレンダ・タイトルの下で、「属性」ノードを選択します。
プロパティ・エディタにカレンダ属性が表示されます。

4. プロパティ・エディタですべての属性を表示します。「プロパティ・エディタ・メニュー」から「すべて表示」を選択します。

5. リージョン属性を編集します。

ヒント:
属性の詳細は、プロパティ・エディタで属性を選択し、中央ペインで「ヘルプ」タブをクリックして、参照してください。

6. 「保存」をクリックします。

12.1.4.2 追加および編集機能を含めるように既存のカレンダを編集

デスクトップ・アプリケーションのカレンダのリンクの作成およびリンクの編集を定義する場合、2つの異なるページを定義することをお薦めします。新規カレンダ・エントリの作成に使用するページでは、ページ・アクセス保護を「制限なし」として定義する必要があります。ただし、既存のカレンダ・エントリの編集に使用するページでは、ページ・アクセス保護を「引数にチェックサムが必要」に設定する必要があります。

追加および編集機能を含めるように既存のカレンダを編集するには、次のステップを実行します。

1. ページ・デザイナで適切なページにナビゲートします。「ページ・デザイナでのページの表示」を参照してください。
ページ・デザイナが表示されます

2. 「レンダリング」ツリーのカレンダ・タイトルの下で、「属性」ノードを選択します。
プロパティ・エディタにカレンダ属性が表示されます。

3. プロパティ・エディタですべての属性を表示します。「プロパティ・エディタ・メニュー」から「すべて表示」を選択します。

ヒント:
属性の詳細は、プロパティ・エディタで属性を選択し、中央ペインで「ヘルプ」タブをクリックして、参照してください。

4. 「リンクの作成」または「リンクの表示/編集」で、次のステップを実行します。

1. リンクを次の場所で開く - ページまたはURLでカレント・ページを置き換えるか、ダイアログを開くかを指定します。

2. ターゲットの作成 - 「リンクが定義されていません」をクリックします。

5. リンク・ビルダー - イベント・ターゲット・ダイアログで、次のステップを実行します。

1. タイプ: ターゲット・アプリケーションのタイプ(「このアプリケーションのページ」または「別のアプリケーションのページ」)を選択します。

2. アプリケーション: 「別のアプリケーションのページ」を選択した場合、アプリケーションを選択します。

3. ページ: ターゲット・ページ番号を指定します。

4. アイテムを設定します。

- 名前 - 「リンクの作成」で、開始日列を入力します。期間ベース・イベントの場合は、終了日列も入力します。「リンクの表示/編集」で、主キー列を入力します。

ヒント:
選択した日付列にはRRRRMMDDHH24MISSという書式マスクが必要です(カレンダはこの書式で日付を渡すため)。
日付アイテムの書式マスクを変更しない場合は、前述の書式マスクを持つ非表示のアイテムをフォーム・ページに作成する必要があります(この非表示のアイテムは、日付値を受け入れる日付アイテムとして選択してください)。

- 値 - 「リンクの作成」で、置換文字列&APEX$NEW_START_DATE.および&APEX$NEW_END_DATE.を入力します。「リンクの表示/編集」で、&ROWID.または&ID.などの適切な置換文字列を入力します。

ヒント:
レガシー・カレンダの場合、置換文字列#DATE_VALUE#および#PRIMARY_KEY_VALUE#を使用します。

5. 「OK」をクリックします。

6. 「エントリ」を展開します。「主キー列」で、カレンダ・データの編集時に渡す値を選択します。この値は、前述のステップで指定した#PRIMARY_KEY_VALUE#に置換されます。

7. 「保存」をクリックします。

12.1.5 コンポーネント・ビューでのカレンダの管理

この項では、コンポーネント・ビューでカレンダを管理する方法について説明します。

- コンポーネント・ビューでのカレンダの作成

- コンポーネント・ビューでのカレンダ属性の編集

ヒント:
SQL問合せに基づいたカレンダの作成時に、ドラッグ・アンド・ドロップ機能を有効化するために、オンデマンド・ページ・プロセスを手動で作成する必要があります。「既存のカレンダでのデータのドラッグ・アンド・ドロップの有効化」を参照してください。

関連項目:
「ページ・デザイナでのカレンダ属性の管理」

12.1.5.1 コンポーネント・ビューでのカレンダの作成

コンポーネント・ビューでカレンダを作成するには、次のステップを実行します。

1. 「カレンダ」リージョンを作成するには、次のステップを実行します。

1. ページに移動します。「コンポーネント・ビューでのページの表示」を参照してください。

2. 新しいカレンダ・リージョンを作成します。「リージョン」で、「作成」アイコンをクリックします。
「リージョンの作成」ウィザードが表示されます。

3. 「カレンダ」を選択して、「次へ」をクリックします。

2. 「実装」で、「カレンダ」を選択し、「次へ」をクリックします。

3. 「表示属性」で、次のステップを実行します。

1. タイトル: リージョンのタイトルを入力します。選択するリージョン・テンプレートにリージョン・タイトルが表示される際に、このタイトルが表示されます。

2. リージョン・テンプレート: リージョンの外観を制御するテンプレートを選択します。

3. 親リージョン: 新しいリージョンが属する親リージョンを定義します。

4. 表示ポイント: このリージョンの表示ポイントを指定します。詳細は、フィールドレベル・ヘルプを参照してください。

5. 順序: このコンポーネントの順序を指定します。これによって評価の順序が決まります。

6. 「次へ」をクリックします。

4. 「ソース」で、カレンダ・ソースが表かSQL問合せかを選択します。
カレンダ・ソースが表の場合:

1. ソース・タイプ - 「表」を選択します。

2. 表/ビューの所有者 - カレンダを作成している表の所有者を選択します。

3. 表/ビューの名前 - カレンダの基になる表またはビューを選択します。

4. 列の選択 - カレンダに含める1つ以上の列を選択します。

5. 「次へ」をクリックします。

カレンダ・ソースがSQL問合せの場合:

1. ソース・タイプ - 「SQL問合せ」を選択します。

2. リージョン・ソースの入力 - カレンダに使用するSQL SELECT文を入力します。SQL SELECT文には2列以上を含める必要があり、そのうち1つはDATE列にする必要があります。
例は、フィールドレベル・ヘルプを参照してください。

3. 「次へ」をクリックします。

5. 「設定」で、デフォルト値を受け入れ、「次へ」をクリックします。
属性の詳細は、フィールドレベル・ヘルプを参照してください。「フィールドレベル・ヘルプの表示」を参照してください。

6. 「条件付き表示」で、次のステップを実行します。

1. 条件タイプ: このコンポーネントがレンダリングされるために満たす必要があるリストから、条件タイプを選択します。

2. 認可スキーム: オプションで認可スキームを選択します。このコンポーネントをレンダリングまたは処理するためには、この認可スキームがTRUEと評価される必要があります。

3. 「リージョンの作成」をクリックします。

7. 「作成」をクリックします。

12.1.5.2 コンポーネント・ビューでのカレンダ属性の編集

作成したカレンダは、属性を編集することで表示を変更できます。各カレンダには、2セットの編集可能な属性(リージョン属性とカレンダ属性)があります。リージョン属性は、カレンダのコンテナとして機能するページの領域を定義します。カレンダ属性は、テンプレート、日付列および一般的なカレンダ書式設定を指定します。

ヒント:
カレンダの表示を無効にするには、カレンダ・ページで、「毎月」、「毎週」または「毎日」ボタンを削除する必要があります。

- カレンダ属性へのアクセス

- 追加および編集機能を含めるように既存のカレンダを編集

12.1.5.2.1 カレンダ属性へのアクセス

カレンダ属性にアクセスするには、次のステップを実行します。

1. 適切なページにナビゲートします。「コンポーネント・ビューでのページの表示」を参照してください。

2. リージョン定義ページにアクセスします。「リージョン」で、リージョン名を選択します。
リージョン定義が表示されます。これらの属性を使用して、リージョン・タイトルを含め、カレンダを保持するコンテナを変更します。

3. 「カレンダ属性」をクリックします。
カレンダ属性ページが表示されます。

4. 対象となる属性を編集します。
属性の詳細は、フィールドレベル・ヘルプを参照してください。「フィールドレベル・ヘルプの表示」を参照してください。

5. 「変更の適用」をクリックします。

12.1.5.2.2 追加および編集機能を含めるように既存のカレンダを編集

デスクトップ・アプリケーションのカレンダのリンクの作成およびリンクの編集を定義する場合、2つの異なるページを定義することをお薦めします。新規カレンダ・エントリの作成に使用するページでは、ページ・アクセス保護を「制限なし」として定義する必要があります。ただし、既存のカレンダ・エントリの編集に使用するページでは、ページ・アクセス保護を「引数にチェックサムが必要」に設定する必要があります。

追加および編集機能を含めるように既存のカレンダを編集するには、次のステップを実行します。

1. 該当するカレンダ属性ページにナビゲートします。「カレンダ属性へのアクセス」を参照してください。

2. 「リンクの作成」または「リンクの表示/編集」まで下にスクロールします。URLを入力します。
たとえば、ページ3にナビゲートする期間ベース・イベントの「リンクの作成」は次のとおりです。

f?p=&APP_ID.:3:&SESSION.::&DEBUG.:RP,3:P3_START_DATE,P3_END_DATE:#APEX$NEW_START_DATE#,#APEX$NEW_END_DATE#:

たとえば、主キー列のROWIDを使用し、ページ4にナビゲートする「リンクの表示/編集」は次のとおりです。

f?p=&APP_ID.:4:&SESSION.::&DEBUG.:RP,4:P4_ROWID:&ROWID.:

ヒント:
選択した日付列にはRRRRMMDDHH24MISSという書式マスクが必要です(カレンダはこの書式で日付を渡すため)。
日付アイテムの書式マスクを変更しない場合は、前述の書式マスクを持つ非表示のアイテムをフォーム・ページに作成する必要があります(この非表示のアイテムは、日付値を受け入れる日付アイテムとして選択してください)。

3. 「カレンダ表示」まで上にスクロールします。
「主キー列」で、カレンダ・データの編集時に渡す値を選択します。この値は、前述のステップで指定した#PRIMARY_KEY_VALUE#に置換されます。

4. 「変更の適用」をクリックします。

12.1.6 日付列の書式マスクについて

カレンダは特定の書式で日付を渡すため、選択した日付列がRRRRMMDDHH24MISSという書式マスクを持っている必要があります。日付アイテムの書式マスクを変更しない場合は、前述の書式マスクを持つ非表示のアイテムをフォーム・ページに作成する必要があります(この非表示のアイテムは、日付値を受け入れる日付アイテムとして選択してください)。日付列のデフォルト値を次のように変更する必要があります。

return to_char(to_date(<hidden item created>,'RRRRMMDDHH24MISS'),<Date item format mask>);

次に例を示します。

return to_char(to_date(:P130_HIREDATE_TMP,'RRRRMMDDHH24MISS'),:APP_DATE_TIME_FORMAT);

デフォルトのソース・タイプは値を戻すPL/SQLファンクションである必要があります。

12.1.7 既存のカレンダでのデータのドラッグ・アンド・ドロップの有効化

デスクトップ・カレンダを作成する際にドラッグ・アンド・ドロップ機能を有効化する場合、生成プロセスによってこの機能を実装するPL/SQLコードが自動的に定義されます。

レガシー・カレンダの場合、ドラッグ・アンド・ドロップ機能を有効化するには、オンデマンド・プロセスが必要です。このプロセスは、ページの作成ウィザードを使用すると自動的に作成されます。一方、ページの作成ウィザードを実行して新しいページでレガシー・カレンダを作成する場合、「ドラッグ・アンド・ドロップの有効化」オプションは表示されません。この機能を有効化するには、オンデマンド・プロセスを作成し、カレンダ・ページを作成してから、ページを編集してドラッグ・アンド・ドロップを有効化する必要があります。ベスト・プラクティスとして、カレンダの作成前にこのプロセスを作成しておくことをお薦めします。

レガシー・カレンダ・データのドラッグ・アンド・ドロップのサポートを有効化するには、次のステップを実行します。

1. カレンダの属性を編集します。

2. 「ドラッグ・アンド・ドロップ」を「はい」に設定します。

3. 置換変数APEX$NEW_START_DATE、APEX$NEW_END_DATEおよびAPEX$PK_VALUEを使用して、適切なPL/SQLコードを入力します。
たとえば、期間ベース・カレンダの場合は次のものを使用します。

begin
update projects
set start_date = to_date(:APEX$NEW_START_DATE, 'YYYYMMDDHH24MISS'),
end_date = to_date(:APEX$NEW_END_DATE, 'YYYYMMDDHH24MISS')
where id = :APEX$PK_VALUE;
end;

12.1.8 レガシー・カレンダでサポートされているカレンダ置換文字列について

アプリケーション・ビルダーでは、多くの日付書式置換文字列がサポートされています。「カレンダ・テンプレート」ページで、サポートされている置換文字列の完全なリストを表示できます。

カレンダでサポートされている置換文字列のリストを表示するには、次のステップを実行します。

1. 該当するカレンダ・テンプレートにナビゲートします。

2. ページの右側の「置換文字列」リストを表示します。

関連項目:
「テーマおよびテーマ・スタイルの使用」

12.2 マップの作成

アプリケーション・ビルダーには、「デスクトップ」ユーザー・インタフェースのページにマップ・チャートを生成するための組込みウィザードが用意されています。マップ・チャートの作成方法は、マップを既存ページに追加するか、マップを新しいページに追加するかによって異なります。

- マップ・チャートのサポートについて

- マップのSQL問合せの作成について

- 新しいページへのマップ・チャートの追加

- ページ・デザイナでのマップ・チャートの管理

- コンポーネント・ビューでのマップ・チャートの管理

12.2.1 マップ・チャートのサポートについて

Oracle Application Expressのマップ・チャートのサポートは、AnyChart AnyMap対話モード・マップ・コンポーネントをベースにしています。開発者は、Macromedia FlashベースのフレキシブルなソリューションであるAnyMapを使用して、地理関連データを視覚化できます。マップ・チャートはブラウザでレンダリングされ、使用するにはFlash Player 9以上が必要です。Anychartの詳細は、次を参照してください。

http://www.anychart.com

AnyChartでは、*.amap拡張子を持つファイルにマップ・データが格納され、アメリカ合衆国、ヨーロッパ、アジア、アフリカ、オセアニア、北アメリカおよび南アメリカの300個のマップ・ファイルがサポートされています。目的のマップをレンダリングするには、ウィザードでマップ・ソース(たとえば、「ドイツ」)を選択します。マップXMLによって、目的のマップ・ソースの.amapファイル(germany.amap)が自動的に参照されます。使用可能なマップについては、AnyChart User's Guideの「Map Reference」を参照してください。

http://6.anychart.com/products/anymap/docs/

12.2.2 マップのSQL問合せの作成について

アプリケーション・ビルダーでは、ウィザードを使用してマップを定義します。マップ・タイプとマップ・ソースを選択し、次の構文を使用してSQL問合せを指定します。

SELECT link, label, value
FROM   ...

説明:

- linkはURLです。

- labelは、データを関連付けるマップ上のポイントを示すテキストです。マップの「リージョンID」または「リージョン名」をラベルとして使用する必要があります。

- valueは、マップ上のポイントと関連付けるデータを定義する数値列です。

次に、ページを新規作成する例を示します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「ページの作成」をクリックします。

4. 「マップ・チャート」を選択し、「次へ」をクリックします。

5. 「マップ・タイプ」で、「アメリカ合衆国」を選択し、「次へ」をクリックします。

6. 「マップ・ソース」で、「国マップ」を展開し、「州」を選択します。

7. 「ページ属性」で、適切な属性を指定し、「次へ」をクリックします。

8. 「ナビゲーションのプリファレンス」で、このページに含めるナビゲーションのタイプを指定し、「次へ」をクリックします。ナビゲーション・オプション(ナビゲーション・メニューまたはタブなど)はカレント・アプリケーションのテーマに応じて決まります。

9. 「マップ属性」で、適切な属性を選択し、「次へ」をクリックします。
問合せページが表示されます。

10. スクロール・ダウンして、「マップ問合せ例」および「マップ参照情報」リージョンを展開して確認します。

11. スクロール・ダウンして、ページ下部にある「マップ参照情報」リージョンを展開して確認します。

12. 次のいずれかの方法でSQL問合せを指定します。

- 表示されているフィールドにSQL問合せを入力します。「マップのSQL問合せの作成について」を参照してください。

- 「問合せの作成」ボタンをクリックします。ビルド・チャート問合せウィザードが表示されたら、画面に表示されるステップに従います。

問合せを作成するときには、「マップ参照情報」リージョンの説明に従ってリージョン名の情報を組み込む必要があります。次の例では、フロリダ(Florida)とアラスカ(Alaska)の情報を含めています。

SELECT null link, region label, value Populations
FROM (
SELECT 'Florida' region, 18328340 value FROM dual
UNION ALL
SELECT 'Alaska' region, 686293 value FROM dual)

注意:
データベース表に格納されている地理情報を参照する場合、その情報は、マップ・ソースに関連付けられているリージョン情報に対応している必要があります。詳細は、AnyChart User's Guideを参照してください。
http://6.anychart.com/products/anymap/docs/

13. 「次へ」をクリックします。

14. 「終了」をクリックします。

12.2.3 新しいページへのマップ・チャートの追加

新しいページにマップ・チャートを追加するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「ページの作成」をクリックします。
ページの作成ウィザードが表示されます。

4. 「ページの作成」で、次のステップを実行します。

1. ユーザー・インタフェース: ページのユーザー・インタフェースを選択します。

2. ページ・タイプの選択: 「マップ・チャート」を選択します。

3. 「次へ」をクリックします。

5. マップ・タイプ(「ヨーロッパ」など)を選択して、「次へ」をクリックします。

6. 「マップ・ソース」の「ツリー」に、選択したマップ・タイプのマップ・ソース・ファイルのリストが表示されます。使用するマップ・ソース(たとえば、「デンマーク」)をクリックします。

7. 「ページ属性」で、次のステップを実行します。

1. ページ番号 - チャート・オブジェクトを表示するページを選択します。

2. ページ名 - 新しいページを作成する場合は、名前を入力します。

3. ページ・モード: ページ・モードを選択します。

4. リージョン・テンプレート: このマップが表示されるリージョンのリージョン・テンプレートを選択します。

5. リージョン名 - リージョンの名前を入力します。

6. ナビゲーション・リスト - トップ・レベル・エントリまたはナビゲーション・リスト階層のリンクとして、新しいページを既存のナビゲーション・リストに追加できます。「構成」をクリックして、ナビゲーション・リストにページを追加します。

7. ブレッドクラム: ページでブレッドクラム・ナビゲーション・コントロールを使用するかどうか、およびどのブレッドクラム・ナビゲーション・コントロールを使用するかを選択します。
属性の詳細は、フィールドレベル・ヘルプを参照してください。「フィールドレベル・ヘルプの表示」を参照してください。

8. 「次へ」をクリックします。

8. 「ナビゲーションのプリファレンス」で、このページに含めるナビゲーションのタイプを指定し、「次へ」をクリックします。ナビゲーション・オプション(ナビゲーション・メニューまたはタブなど)はカレント・アプリケーションのテーマに応じて決まります。

9. 「マップ属性」で、適切な属性を選択し、「次へ」をクリックします。
属性の詳細は、フィールドレベル・ヘルプを参照してください。「フィールドレベル・ヘルプの表示」を参照してください。

10. 問合せは次のいずれかの方法で指定します。

- 表示されているフィールドにSQL問合せを入力します。「マップのSQL問合せの作成について」を参照してください。

- 「問合せの作成」ボタンをクリックします。ビルド・チャート問合せウィザードが表示されたら、画面に表示されるステップに従います。

関連属性を指定します。選択したマップ・ソースに関連付けられているマップ参照情報を表示するには、ページの下部にある「マップ参照情報」リージョンを展開します。

データを地理的な位置に関連付けるには、「リージョン名」または「リージョンID」列の情報をマップ問合せに組み込む必要があります。「マップのSQL問合せの作成について」を参照してください。

11. 「次へ」をクリックします。

12. 「作成」をクリックします。

12.2.4 ページ・デザイナでのマップ・チャートの管理

この項では、ページ・デザイナでマップ・チャートを管理する方法について説明します。

- ページ・デザイナでのマップ・チャートの追加

- ページ・デザイナでのマップ・チャート属性の編集

- カスタムXMLとマップ・チャートの使用

- 自動更新の有効化

12.2.4.1 ページ・デザイナでのマップ・チャートの追加

既存のページにマップ・チャートを追加するには、次のステップを実行します。

1. ページ・デザイナで適切なページにナビゲートします。「ページ・デザイナでのページの表示」を参照してください。
ページ・デザイナが表示されます

2. ギャラリからマップ・チャート・リージョンを選択して、グリッド・レイアウトの適切な場所にドラッグします。

ヒント:
「マップ・チャート」リージョンを右クリックして「追加先」を選択し、適切な場所を選択することもできます。

ページ・デザイナは、次に必要なアクションを示します。

「メッセージ」タブには、対応する必要のあるメッセージを示す赤または黄色のバッジが表示されます。「メッセージ」タブには、次の2つのタイプのメッセージが表示されます。

- エラー - エラー・メッセージは赤で表示されます。エラー・メッセージを選択すると、プロパティ・エディタに関連する属性が赤で表示されます。ページを保存する前にエラーに対処する必要があります。

- 警告 - 警告メッセージは黄色で表示されます。警告メッセージを選択すると、プロパティ・エディタで、関連する属性が黄色で表示されます。ページを保存する前にエラーに対処する必要があります。警告メッセージには対処しないでページを保存できることに注意してください。

3. 「プロパティ・エディタ - リージョン」で、リージョン属性を編集します。必要な属性は、属性ラベルの1つ上の左上隅に赤い三角形で表示されます。

ヒント:
属性の詳細は、プロパティ・エディタで属性を選択し、中央ペインで「ヘルプ」タブをクリックして、参照してください。

1. タイトル - リージョンのタイトルを入力します。

2. 「レイアウト」で、次の項目を選択します。

- 順序 - このアイテムの表示順序を入力します。

- 親リージョン - このリージョンが属する親リージョンを選択します。

- 位置 - このリージョンの表示に使用されるテンプレートの位置を選択します。

3. 「外観」で、次の項目を選択します。

- テンプレート - リージョン・テンプレートを選択します。

- アイテム表示位置 - メイン・リージョン・コンテンツに対して相対的に、ページ・アイテムの表示位置を指定します。

4. レイアウト - 「順序」、「親リージョン」および「位置」を指定します。

5. 外観 - テンプレートを指定します。

4. マップ・チャート属性を表示します。「レンダリング」ツリーのマップ・チャート・タイトルで、「属性」ノードを選択します。

5. プロパティ・エディタで、次のマップ・チャート属性を編集します。

1. マップ、レベル1 - 使用可能なリストからマップ・レベルを選択します(「ヨーロッパ」など)。

2. マップ、レベル2 - 使用可能なリストからマップ・レベルを選択します(「デンマーク」など)。

3. ソース、SQL問合せ - チャート・シリーズに対するSQL問合せを入力します。

4. 必要に応じて、その他の属性を編集します。

ヒント:
属性の詳細は、プロパティ・エディタで属性を選択し、中央ペインで「ヘルプ」タブをクリックして、参照してください。

6. 「保存」をクリックします。

12.2.4.2 ページ・デザイナでのマップ・チャート属性の編集

作成したマップ・チャートの表示は、プロパティ・エディタで属性を編集することによって変更できます。

マップ・チャート属性を表示するには、次のステップを実行します。

1. ページ・デザイナで適切なページにナビゲートします。「ページ・デザイナでのページの表示」を参照してください。
ページ・デザイナが表示されます。

2. リージョン属性を編集するには、次のステップを実行します。

1. 「レンダリング」ツリーで、マップ・チャートを含むリージョンを選択します。
プロパティ・エディタにリージョン属性が表示されます。

2. 対象となる属性を編集します。

3. マップ・チャート属性を編集するには、次のステップを実行します。

1. 「レンダリング」ツリーのリージョン・タイトルで、「属性」ノードを選択します。
プロパティ・エディタにマップ・チャート属性が表示されます。

2. 対象となる属性を編集します。

ヒント:
属性の詳細は、プロパティ・エディタで属性を選択し、中央ペインで「ヘルプ」タブをクリックして、参照してください。

4. 「保存」をクリックします。

関連項目:
「カスタムXMLとマップ・チャートの使用」および「自動更新の有効化」

12.2.4.3 カスタムXMLとマップ・チャートの使用

マップ属性ページには、標準の属性で制御できない追加のマップ設定があります。チャートのルック・アンド・フィールをさらに制御するには、カスタムXMLを使用できます。

カスタムXMLを使用するには、次のステップを実行します。

1. ページ・デザイナで適切なページにナビゲートします。「ページ・デザイナでのページの表示」を参照してください。
ページ・デザイナが表示されます。

2. 「レンダリング」ツリーのリージョン・タイトルで、「属性」ノードを選択します。
プロパティ・エディタにマップ・チャート属性が表示されます。

3. 「カスタムXML」セクションを展開します。

4. 「カスタムXML」の「カスタム」で、「はい」を選択します。

5. XMLを編集します。

6. 「保存」をクリックします。

ヒント:
マップに対してサポートされているXML書式の詳細は、次のサイトのオンライン・マップXMLリファレンスを参照してください。
http://6.anychart.com/products/anymap/docs/

12.2.4.4 自動更新の有効化

マップ属性ページで「非同期更新」属性を有効にして、情報を監視するマップ・チャートを作成できます。この属性を有効にすると、マップが更新され、指定した時間間隔内に行われた基礎となるデータの変更が反映されます。

自動リフレッシュを有効化するには、次のステップを実行します。

1. ページ・デザイナで適切なページにナビゲートします。「ページ・デザイナでのページの表示」を参照してください。
ページ・デザイナが表示されます。

2. 「レンダリング」ツリーのリージョン・タイトルで、「属性」ノードを選択します。
プロパティ・エディタにマップ・チャート属性が表示されます。

3. 「自動リフレッシュ」セクションを展開します。

1. 自動リフレッシュ - 「はい」を選択します。

2. 間隔 - チャートの更新間隔を入力します。
重大なデータベース・パフォーマンスの問題が発生する可能性があるため、更新間隔を2秒などのように非常に短くすることはお薦めしません。

4. 「保存」をクリックします。

12.2.5 コンポーネント・ビューでのマップ・チャートの管理

この項では、コンポーネント・ビューでマップ・チャートを管理する方法について説明します。

- コンポーネント・ビューでのマップ・チャートの追加

- マップ・チャート属性の編集

- カスタムXMLとマップ・チャートの使用

- 非同期更新の有効化

12.2.5.1 コンポーネント・ビューでのマップ・チャートの追加

既存のページにマップ・チャートを追加するには、次のステップを実行します。

1. ページに移動します。「コンポーネント・ビューでのページの表示」を参照してください。

2. 新しいリージョンを作成します。「リージョン」で、「作成」アイコンをクリックします。
「リージョンの作成」ウィザードが表示されます。

3. 「マップ・チャート」を選択し、「次へ」をクリックします。

4. 「マップ・タイプ」で、マップ・タイプ(たとえば、「ヨーロッパ」)を選択し、「次へ」をクリックします。

5. 「マップ・ソース」の「ツリー」に、選択したマップ・タイプのマップ・ソース・ファイルのリストが表示されます。使用するマップ・ソース(たとえば、「デンマーク」)をクリックします。

6. 「表示属性」で、次のステップを実行します。

1. タイトル - リージョンのタイトルを入力します。選択するリージョン・テンプレートにリージョン・タイトルが表示されると、このタイトルが表示されます。

2. リージョン・テンプレート: リージョンの外観を制御するテンプレートを選択します。

3. 親リージョン: 新しいリージョンが属する親リージョンを定義します。

4. 表示ポイント: このリージョンの表示ポイントを指定します。詳細は、フィールドレベル・ヘルプを参照してください。

5. 順序: このコンポーネントの順序を指定します。これによって評価の順序が決まります。

6. 「次へ」をクリックします。

7. 「表示属性」で、適切なマップ属性を選択し、「次へ」をクリックします。
属性の詳細は、フィールドレベル・ヘルプを参照してください。「フィールドレベル・ヘルプの表示」を参照してください。

8. 問合せは次のいずれかの方法で指定します。

- 表示されているフィールドにSQL問合せを入力します。「マップのSQL問合せの作成について」を参照してください。

- 「問合せの作成」ボタンをクリックします。ビルド・チャート問合せウィザードが表示されたら、画面に表示されるステップに従います。

関連属性を指定します。選択したマップ・ソースに関連付けられているマップ参照情報を表示するには、ページの下部にある「マップ・リージョン情報」リージョンを展開します。

データを地理的な位置に関連付けるには、「リージョン名」または「リージョンID」列の情報をマップ問合せに組み込む必要があります。「マップのSQL問合せの作成について」を参照してください。

9. 「条件付き表示」で、次のステップを実行します。

1. 条件タイプ: このコンポーネントがレンダリングされるために満たす必要があるリストから、条件タイプを選択します。

2. 認可スキーム: オプションで認可スキームを選択します。このコンポーネントをレンダリングまたは処理するためには、この認可スキームがTRUEと評価される必要があります。

3. 「リージョンの作成」をクリックします。

12.2.5.2 マップ・チャート属性の編集

マップの作成後、マップ属性ページで属性を編集することによって表示を変更できます。

マップ属性ページにアクセスするには、次のステップを実行します。

1. ページに移動します。「コンポーネント・ビューでのページの表示」を参照してください。

2. チャート属性ページにアクセスします。

1. 「リージョン」で、リージョン名を選択します。
リージョン定義が表示されます。

2. 「マップ属性」をクリックします。

3. 対象となる属性を編集します。
属性の詳細は、フィールドレベル・ヘルプを参照してください。「フィールドレベル・ヘルプの表示」を参照してください。

4. 「変更の適用」をクリックします。

関連項目:
「カスタムXMLとマップ・チャートの使用」および「非同期更新の有効化」

12.2.5.3 カスタムXMLとマップ・チャートの使用

マップ属性ページには、標準の属性で制御できない追加のマップ設定があります。チャートのルック・アンド・フィールをさらに制御するには、カスタムXMLを使用できます。

カスタムXMLを使用するには、次のステップを実行します。

1. マップ・チャートを作成します。

2. ページに移動します。「コンポーネント・ビューでのページの表示」を参照してください。

3. マップ属性ページにアクセスします。「リージョン」で、リージョン名を選択します。

4. 「マップ属性」をクリックします。

5. 「マップXML」までスクロール・ダウンします。

6. 「カスタムXMLの使用」から「はい」を選択します。
カスタムXMLの使用を選択した場合、もう表示されない属性を持つリージョンは非表示となります。これらのリージョンを再度表示するには、「カスタムXMLの使用」で「いいえ」を選択します。

7. XMLを編集します。

8. 「変更の適用」をクリックします。

ヒント:
マップに対してサポートされているXML書式の詳細は、次のサイトのオンライン・マップXMLリファレンスを参照してください。
http://6.anychart.com/products/anymap/docs/

12.2.5.4 非同期更新の有効化

マップ属性ページで「非同期更新」属性を有効にして、情報を監視するマップ・チャートを作成できます。この属性を有効にすると、マップが更新され、指定した時間間隔内に行われた基礎となるデータの変更が反映されます。

非同期更新を有効にするには、次のステップを実行します。

1. マップ・チャートを作成します。

2. ページに移動します。「コンポーネント・ビューでのページの表示」を参照してください。

3. マップ属性ページにアクセスします。

4. 「リージョン」で、リージョン名を選択します。

5. 「マップ属性」をクリックします。

6. 「リフレッシュ」までスクロールします。

7. 「非同期更新」で、「はい」を選択します。

8. 「更新間隔」で、マップの更新間隔(秒)を入力します。最適なパフォーマンスを得るには、2秒を超える間隔を選択します。

9. 「変更の適用」をクリックします。

12.3 チャートの作成

この項では、Oracle Application Expressでチャートを作成する方法について説明します。アプリケーション・ビルダーには、FlashチャートおよびHTML5チャートを生成するための組込みウィザードが用意されています。また、SVGおよびHTMLチャートの編集もサポートされています。Oracle Application Expressは、この4つのグラフィカル・チャートのみサポートします。

- チャート・タイプについて

- チャートのSQL問合せの作成

- 新しいページへのチャートの追加

- ページ・デザイナでのチャートの管理

- コンポーネント・ビューでのチャートの管理

- SVGチャートのサポートの理解

- HTMLチャートのサポートの理解

- Flashチャートの保存について

- FlashおよびHTML5チャートとのカスタムXMLの使用

12.3.1 チャート・タイプについて

この項では、アプリケーション・ビルダーで作成できる様々なチャート・タイプについて説明します。

- HTML5チャートについて

- Flashチャートについて

12.3.1.1 HTML5チャートについて

Oracle Application ExpressのHTML5チャートのサポートは、AnyChart HTML5 Chart Componentをベースにしています。AnyChartはフレキシブルなFlashおよびJavaScript (HTML5)ベースのソリューションで、開発者は動きがありコンパクトでインタラクティブなチャートを作成できます。HTML5チャートはJavaScriptチャート・エンジンを使用し、SVG形式のチャートをレンダリングします。Flashは最新のモバイル・デバイスのほとんどでレンダリングできませんが、現在は新しいHTML5チャート作成ソリューションを利用して、チャートをモバイル・アプリケーションに組み込むことができます。HTML5チャートは、次のモバイル・プラットフォームの一般的なブラウザと互換性があります。

- Android: バージョン3.1、3.2、4.0、4.0.3および4.1

- IOS (iPhone、iPad、iPod Touch): Safari 3.2以上が必要

詳細は、次を参照してください。

http://6.anychart.com/products/anychart/docs/

12.3.1.2 Flashチャートについて

Oracle Application ExpressのFlashチャートのサポートは、AnyChart Flash Chart Componentをベースにしています。AnyChartはフレキシブルなFlashおよびJavaScriptベースのソリューションで、開発者は動きがありコンパクトでインタラクティブなチャートを作成できます。Flashチャートはブラウザでレンダリングされ、使用するにはFlash Player 9以上が必要です。AnyChart 6.0では、FlashチャートはFLASH_PREFERREDレンダリング・タイプを使用してレンダリングされます。チャートを表示するデバイスでFlash Playerを使用できない場合(iPhoneで表示されるページなど)、AnyChartは自動的にHTML5チャート・エンジンに切り替え、SVGベースのチャートを表示します。

12.3.2 チャートのSQL問合せの作成

この項では、アプリケーション・ビルダーでのチャートの作成についてサポートされる構文を説明します。

- 標準チャート構文

- ダイアル・チャート構文(FlashおよびHTML5)

- 複数シリーズ構文(FlashおよびHTML5)

- レンジ・チャート構文(FlashおよびHTML5)

- 散布チャート構文(FlashおよびHTML5)

- ローソク足チャート構文(FlashおよびHTML5)

- ガント・チャート構文(Flashのみ)

12.3.2.1 標準チャート構文

アプリケーション・ビルダーでチャートを定義するには、ウィザードを使用します。ほとんどのチャート・ウィザードでは、チャート・タイプを選択し、次の構文を使用してSQL問合せを指定します。

SELECT link, label, value
FROM   ...

説明:

- linkはURLです。

- labelは、バーに表示されるテキストです。

- valueは、バー・サイズを定義する数値列です。

次に例を示します。

SELECT null, last_name, salary
FROM   employees
WHERE  DEPARTMENT_ID = :P101_DEPARTMENT_ID

12.3.2.2 ダイアル・チャート構文(FlashおよびHTML5)

ダイアル・チャートを作成するには、ダイアル・チャート・タイプを選択し、次の構文を使用して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

12.3.2.3 複数シリーズ構文(FlashおよびHTML5)

列チャートおよび行チャートには、1つのSQL問合せで複数シリーズを定義できます。これらのチャート・タイプのシリーズ名は、問合せ内の関連する列別名から導出されます。複数シリーズのチャートを定義するには、次の構文を使用します。

SELECT link, label, series_1_value [, series_2_value [, ...]]
FROM   ...

12.3.2.4 レンジ・チャート構文(FlashおよびHTML5)

レンジ・チャートは、各バーに2つの値が必要です。レンジ・チャートを作成するには、チャートを作成し、次の構文を使用してSQL問合せを提供します。

SELECT link, label, low_value, high_value
FROM   ...

12.3.2.5 散布チャート構文(FlashおよびHTML5)

散布チャートは、各ポイントにx値およびy値が必要です。レンジ・チャートを作成するには、チャートを作成し、次の構文を使用してSQL問合せを提供します。

SELECT link, label, x_value, y_value
FROM   ...

12.3.2.6 ローソク足チャート構文(FlashおよびHTML5)

ローソク足チャートには、各ローソク足に始値、安値、高値および終値が必要です。ローソク足チャートを作成するには、チャートを作成し、次の構文を使用してSQL問合せを指定します。

SELECT link, label, open, low, high, close
FROM   ...

12.3.2.7 ガント・チャート構文(Flashのみ)

プロジェクト・ガント・チャートでは、各タスクのタスク名、タスクID、親タスクID、実際の開始日と終了日、および進捗の値が必要になります。計画開始日と計画終了日の2つの値も必要に応じて使用できます。プロジェクト・ガント・チャートを作成するには、Flashチャートを作成し、次の構文を使用してSQL問合せを指定します。

SELECT link, task_name, task_id, parent_task_id, actual_start_date, actual_end_date, progress
FROM   ...

リソース・ガント・チャートでは、各タスクのリソースID、リソース名、親リソースID、および実際の開始日と終了日の値が必要になります。リソース・ガント・チャートを作成するには、Flashチャートを作成し、次の構文を使用してSQL問合せを指定します。

SELECT link, resource_id, resource_name, resource_parent_id, actual_start_date, actual_end_date
FROM   ...

リソース・ガント・チャートで親子階層データを表すには、START WITH..CONNECT BY構文を使用してSQL問合せを指定します。

SELECT link,
resource_id,
resource_name,
resource_parent_id,
actual_start_date,
actual_end_date,
FROM ...
START WITH resource_parent_id IS NULL
CONNECT BY PRIOR resource_id = resource_parent_id
ORDER SIBLINGS BY resource_name

12.3.3 新しいページへのチャートの追加

新しいページにチャートを追加するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「ページの作成」をクリックします。

4. 「ページの作成」で、次のステップを実行します。

1. ユーザー・インタフェース: ページのユーザー・インタフェースを選択します。

2. ページ・タイプの選択: 「チャート」を選択します。

3. 「次へ」をクリックします。

5. 「チャート・タイプ」で、次のステップを実行します。

1. チャートのレンダリング: チャート・タイプを選択します。「チャート・タイプについて」を参照してください。

2. チャート・タイプ: チャート・タイプを指定します。チャート・タイプによっては、追加で選択するように求められる場合があります。

3. 「次へ」をクリックします。

6. 「ページおよびリージョン属性」で、次のステップを実行します。

1. ページ番号 - チャート・オブジェクトを表示するページを選択します。

2. ページ名 - 新しいページを作成する場合は、名前を入力します。

3. ページ・モード: ページ・モードを選択します。
詳細は、フィールドレベル・ヘルプを参照してください。「フィールドレベル・ヘルプの表示」を参照してください。

4. ページ・グループ - このページと関連付けるページ・グループの名前を指定します。

5. リージョン・テンプレート - このチャートを表示するリージョンのリージョン・テンプレートを選択します。

6. リージョン名 - リージョンの名前を入力します。

7. ナビゲーション・リスト - トップ・レベル・エントリまたはナビゲーション・リスト階層のリンクとして、新しいページを既存のナビゲーション・リストに追加できます。「構成」をクリックして、ナビゲーション・リストにページを追加します。

8. ブレッドクラム - ページでブレッドクラム・ナビゲーション・コントロールを使用するかどうかを選択します。

9. 「次へ」をクリックします。

7. 「ナビゲーションのプリファレンス」で、このページに含めるナビゲーションのタイプを指定し、「次へ」をクリックします。ナビゲーション・オプション(ナビゲーション・メニューまたはタブなど)はカレント・アプリケーションのテーマに応じて決まります。

8. 「チャート属性」で、適切な属性を指定し、「次へ」をクリックします。
属性の詳細は、フィールドレベル・ヘルプを参照してください。「フィールドレベル・ヘルプの表示」を参照してください。

9. 「問合せ」で、次のステップを実行します。

1. 問合せは次のいずれかの方法で指定します。

- 表示されているフィールドにSQL問合せを入力します。「チャートのSQL問合せの作成」を参照してください。

- 「問合せの作成」ボタンをクリックします。ビルド・チャート問合せウィザードが表示されたら、画面に表示されるステップに従います。

2. 関連するチャート属性を指定します。
属性の詳細は、フィールドレベル・ヘルプを参照してください。

3. 「次へ」をクリックします。

10. 「作成」をクリックします。

12.3.4 ページ・デザイナでのチャートの管理

この項では、ページ・デザイナでチャートを作成および編集する方法について説明します。

- ページ・デザイナでのチャートの追加

- ページ・デザイナでのチャート属性の編集

- HTML5チャートからFlashチャートへの切替え

- 非同期更新の有効化

12.3.4.1 ページ・デザイナでのチャートの追加

ページ・デザイナで既存ページにチャートを追加するには、次のステップを実行します。

1. ページ・デザイナでアイテムを含めるページを表示します。「ページ・デザイナでのページの表示」を参照してください。

2. ギャラリからチャート・リージョンを選択して、グリッド・レイアウトの適切な場所にドラッグします。

ヒント:
ツリー・リージョンを右クリックし、「追加先」を選択して適切な場所を選択することもできます。

ページ・デザイナは、次に必要なアクションを示します。

「メッセージ」タブには、対応する必要のあるメッセージを示す赤または黄色のバッジが表示されます。「メッセージ」タブには、次の2つのタイプのメッセージが表示されます。

- エラー - エラー・メッセージは赤で表示されます。エラー・メッセージを選択すると、プロパティ・エディタに関連する属性が赤で表示されます。ページを保存する前にエラーに対処する必要があります。

- 警告 - 警告メッセージは黄色で表示されます。警告メッセージを選択すると、プロパティ・エディタで、関連する属性が黄色で表示されます。ページを保存する前にエラーに対処する必要があります。警告メッセージには対処しないでページを保存できることに注意してください。

3. プロパティ・エディタですべての属性を表示します。「プロパティ・エディタ・メニュー」から「すべて表示」を選択します。

4. 「プロパティ・エディタ - リージョン」で、必要な属性を編集します。
必要な属性は、属性ラベルの1つ上の左上隅に赤い三角形で表示されます。

ヒント:
属性の詳細は、プロパティ・エディタで属性を選択し、中央ペインで「ヘルプ」タブをクリックして、参照してください。

5. チャート属性を編集します。

1. 「レンダリング」ツリーで、「属性」ノードを選択します。
「プロパティ・エディタ - 属性」が表示されます。

2. 必要なチャート属性を編集します。
必要な属性は、属性ラベルの1つ上の左上隅に赤い三角形で表示されます。

3. 「次へ」をクリックします。

6. シリーズを編集します。

1. 「レンダリング」ツリーで、「シリーズ」ノードを選択します。
「プロパティ・エディタ - シリーズ」が表示されます。

2. 必要なチャート属性を編集します。

3. 「次へ」をクリックします。

7. 「保存」をクリックします。

12.3.4.2 ページ・デザイナでのチャート属性の編集

チャートの作成後は、「チャート属性」ページでチャート属性を編集してチャートの表示を変更できます。

注意:
ページ・デザイナを使用して、非推奨のSVGチャート・タイプを編集することはできません。

「チャート属性」ページにアクセスするには、次のステップを実行します。

1. ページ・デザイナで、チャートを含むページを表示します。「ページ・デザイナでのページの表示」を参照してください。

2. 「レンダリング」ツリーで、「属性」ノードを選択します。
「プロパティ・エディタ - 属性」が表示されます。

3. プロパティ・エディタですべての属性を表示します。「プロパティ・エディタ・メニュー」から「すべて表示」を選択します。

4. チャート属性を編集します。
必要な属性は、属性ラベルの1つ上の左上隅に赤い三角形で表示されます。

5. 「保存」をクリックします。

12.3.4.3 HTML5チャートからFlashチャートへの切替え

HTML5チャートの作成後は、「チャート属性」ページでチャート属性を編集することによって、そのレンダリングをFlashに切り替えることができます。

HTML5チャートをFlashチャートに切り替えるには、次のステップを実行します。

1. ページ・デザイナで、チャートを含むページを表示します。「ページ・デザイナでのページの表示」を参照してください。

2. 「レンダリング」ツリーで、「属性」ノードを選択します。
「プロパティ・エディタ - 属性」が表示されます。

3. 「外観」セクションを開きます。

4. 「外観」の「レンダリング」で、「Flashチャート」を選択します。
属性の詳細は、フィールドレベル・ヘルプを参照してください。「フィールドレベル・ヘルプの表示」を参照してください。

5. 「保存」をクリックします。

12.3.4.4 非同期更新の有効化

チャート属性ページで「非同期更新」属性を有効するか、リフレッシュ・アクションとともに動的アクションを使用すると、SVGチャート、FlashチャートおよびHTML5チャートで情報を監視できます。

- 非同期更新属性の有効化

- リフレッシュ動的アクションの作成

12.3.4.4.1 非同期更新属性の有効化

「非同期更新」属性を有効にすると、チャートが更新され、指定した時間間隔内に基礎となるデータで行われた変更が反映されます。

非同期更新を有効にするには、次のステップを実行します。

1. ページ・デザイナでアイテムを含めるページを表示します。「ページ・デザイナでのページの表示」を参照してください。

2. 「レンダリング」ツリーで、「属性」ノードを選択します。
「プロパティ・エディタ - 属性」が表示されます。

3. プロパティ・エディタですべての属性を表示します。「プロパティ・エディタ・メニュー」から「すべて表示」を選択します。

4. 「自動リフレッシュ」で、「はい」を選択します。

5. 「保存」をクリックします。

12.3.4.4.2 ページ・デザイナでのリフレッシュ動的アクションの作成

リフレッシュ動的アクションを作成するには、次の手順を実行します。

1. ページ・デザイナでアイテムを含めるページを表示します。「ページ・デザイナでのページの表示」を参照してください。

2. 「レンダリング」ツリーの下の、ページの左側にある「動的アクション」アコーディオンをクリックします。

3. 「動的アクション」で、「イベント」を右クリックし、「動的アクションの作成」を選択します。
動的アクションの属性がプロパティ・エディタに表示されます。

ヒント:
「メッセージ」タブに、対処が必要なメッセージを示す赤または黄色の印が表示されます。メッセージを選択すると、プロパティ・エディタに関連する属性が表示されます。赤いエラー・メッセージは、保存する前に対処する必要があります。

4. プロパティ・エディタですべての属性を表示します。「プロパティ・エディタ・メニュー」から「すべて表示」を選択します。

5. 「プロパティ・エディタ - 動的アクション」で、次の属性を編集します。

ヒント:
属性の詳細は、プロパティ・エディタで属性を選択し、中央ペインで「ヘルプ」タブをクリックして、参照してください。

1. 指定、名前 - 動的アクションの名前を入力します。

2. 実行オプション、順序 - このコンポーネントの順序を指定します。これによって評価の順序が決まります。

3. 時期、イベント - 動的アクションを起動するイベントを指定します。

4. 時期、選択タイプ - イベントのトリガーに使用するページ要素または構成体のタイプを選択します。たとえば、プロパティ・エディタで属性を選択して、中央ペインの「ヘルプ」タブをクリックします。

5. 「次へ」をクリックします。

次に、イベントがTrueと評価された場合に実行するアクションを定義します。

6. 「レンダリング」ツリーで、Trueの下の最初のアクションを選択します。

1. アクション: 「リフレッシュ」を選択します。

2. 選択タイプ: 「リージョン」を選択します。

3. リージョン: チャートを含むリージョンを選択します。

7. 「保存」をクリックします。

12.3.5 コンポーネント・ビューでのチャートの管理

この項では、コンポーネント・ビューでチャートを作成および管理する方法について説明します。

- コンポーネント・ビューでのチャートの追加

- HTML5チャートからFlashチャートへの切替え

- コンポーネント・ビューでのチャート属性の編集

- 非同期更新の有効化

12.3.5.1 コンポーネント・ビューでのチャートの追加

コンポーネント・ビューで既存ページにチャートを追加するには、次のステップを実行します。

1. ページに移動します。「コンポーネント・ビューでのページの表示」を参照してください。

2. 新しいリージョンを作成します。「リージョン」で、「作成」アイコンをクリックします。
「リージョンの作成」ウィザードが表示されます。

3. 「リージョンの作成」で、「チャート」を選択して「次へ」をクリックします。

4. 「チャート・タイプ」で、次のステップを実行します。

1. チャートのレンダリング: チャート・タイプを選択します。「チャート・タイプについて」を参照してください。

2. チャート・タイプ: チャート・タイプを指定します。チャート・タイプによっては、追加で選択するように求められる場合があります。

3. 「次へ」をクリックします。

5. 「表示属性」で、次のステップを実行します。

1. タイトル - リージョンのタイトルを入力します。選択するリージョン・テンプレートにリージョン・タイトルが表示されると、このタイトルが表示されます。

2. リージョン・テンプレート - リージョンのタイトルを入力します。選択するリージョン・テンプレートにリージョン・タイトルが表示されると、このタイトルが表示されます。

3. 親リージョン - 新しいリージョンが属する親リージョンを定義します。

4. 表示ポイント: このリージョンの表示ポイントを指定します。詳細は、フィールドレベル・ヘルプを参照してください。
詳細は、フィールドレベル・ヘルプを参照してください。「フィールドレベル・ヘルプの表示」を参照してください。

5. 「次へ」をクリックします。

6. 「チャート属性」で、適切な属性を指定し、「次へ」をクリックします。
属性の詳細は、フィールドレベル・ヘルプを参照してください。

7. 「ソース」で、次のステップを実行します。

1. 問合せは次のいずれかの方法で指定します。

- 表示されているフィールドにSQL問合せを入力します。「チャートのSQL問合せの作成」を参照してください。

- 「問合せの作成」ボタンをクリックします。ビルド・チャート問合せウィザードが表示されたら、画面に表示されるステップに従います。

2. 関連するチャート属性を指定します。
属性の詳細は、フィールドレベル・ヘルプを参照してください。

8. 「条件付き表示」で、次のステップを実行します。

1. 条件タイプ: このコンポーネントがレンダリングされるために満たす必要があるリストから、条件タイプを選択します。「条件付きのレンダリングおよびプロセスの理解」を参照してください。

2. 認可スキーム: オプションで認可スキームを選択します。このコンポーネントをレンダリングまたは処理するためには、この認可スキームがTRUEと評価される必要があります。「認可を介したセキュリティの提供」を参照してください。

3. 「リージョンの作成」をクリックします。

12.3.5.2 HTML5チャートからFlashチャートへの切替え

HTML5チャートの作成後は、「チャート属性」ページでチャート属性を編集することによって、そのレンダリングをFlashに切り替えることができます。

HTML5チャートをFlashチャートに切り替えるには、次のステップを実行します。

1. ページに移動します。「コンポーネント・ビューでのページの表示」を参照してください。

2. チャート属性ページにアクセスします。

1. 「リージョン」で、リージョン名を選択します。
リージョン定義が表示されます。

2. 「チャート属性」をクリックします。

3. 「チャート・タイプ」で、次のステップを実行します。

1. チャートのレンダリング: 「Flashチャート」を選択します。

2. チャート・タイプ: チャート・タイプを指定します。3Dチャート・タイプはFlashチャートでのみサポートされているため、3Dオプションを使用するにはチャート・タイプを変更する必要がある場合があります。
属性の詳細は、フィールドレベル・ヘルプを参照してください。「フィールドレベル・ヘルプの表示」を参照してください。

4. 「変更の適用」をクリックします。

12.3.5.3 コンポーネント・ビューでのチャート属性の編集

チャートの作成後は、「チャート属性」ページでチャート属性を編集してチャートの表示を変更できます。

「チャート属性」ページにアクセスするには、次のステップを実行します。

1. ページに移動します。「コンポーネント・ビューでのページの表示」を参照してください。

2. チャート属性ページにアクセスします。「リージョン」で、リージョン名を選択します。

3. 対象となる属性を編集します。

4. 属性の詳細は、フィールドレベル・ヘルプを参照してください。「フィールドレベル・ヘルプの表示」を参照してください。

5. 「変更の適用」をクリックします。

12.3.5.4 非同期更新の有効化

チャート属性ページで「非同期更新」属性を有効するか、リフレッシュ・アクションとともに動的アクションを使用すると、SVGチャート、FlashチャートおよびHTML5チャートで情報を監視できます。

- 非同期更新属性の有効化

- リフレッシュ動的アクションの作成

12.3.5.4.1 非同期更新属性の有効化

「非同期更新」属性を有効にすると、チャートが更新され、指定した時間間隔内に基礎となるデータで行われた変更が反映されます。

非同期更新を有効にするには、次のステップを実行します。

1. 「チャート属性」ページにナビゲートします。「コンポーネント・ビューでのチャート属性の編集」を参照してください。
チャート属性ページが表示されます。

2. 「リフレッシュ」までスクロールします。

3. 「非同期更新」で、「はい」を選択します。

4. 「更新間隔」で、チャートの更新間隔(秒)を入力します。最適なパフォーマンスを得るには、2秒を超える間隔を選択します。

12.3.5.4.2 リフレッシュ動的アクションの作成

リフレッシュ動的アクションを作成するには、次の手順を実行します。

1. チャートを含むページにナビゲートします。「コンポーネント・ビューでのページの表示」を参照してください。

2. 「動的アクション」セクションで、「作成」をクリックします。

3. 「指定」で、次のステップを実行します。

1. 名前: 動的アクションの名前を入力します。

2. 順序: このコンポーネントの順序を指定します。これによって評価の順序が決まります。

3. 「次へ」をクリックします。

4. 「時期」で、次のステップを実行します。

1. イベント: 動的アクションの起動をトリガするイベントを指定します。

2. 選択タイプ: 動的アクションがいつ起動するかを定義するページ要素の選択タイプを指定します。特定のページ・アイテムの例を表示するには、フィールドレベル・ヘルプを参照してください。

3. 「次へ」をクリックします。

5. 「Trueアクション」で、次のステップを実行します。

1. アクション: 「リフレッシュ」を選択します。

2. 「次へ」をクリックします。

6. 「影響を受ける要素」で、次のステップを実行します。

1. 選択タイプ: 「リージョン」を選択します。

2. リージョン: チャートを含むリージョンを選択します。

3. 「次へ」をクリックします。

7. 「動的アクションの作成」をクリックします。

12.3.6 SVGチャートのサポートの理解

以前のリリースのOracle Application Expressでは、SVGチャートの作成がサポートされていました。既存のSVGチャートは引き続きサポートされていますが、Oracle Application Expressでは新しいSVGチャートの作成はサポートされなくなりました。

ヒント:
コンポーネント・ビューでのみSVGチャートを編集できます。

- SVGチャートのHTML5へのアップグレード

- SVGチャート・カスケード・スタイルシート・クラスの理解

- カスタムSVGチャート・カスケード・スタイルシートの参照

- SVGチャートのカスタムCSSスタイル・インラインの指定

- 他の言語でのSVGチャートの表示

12.3.6.1 SVGチャートのHTML5へのアップグレード

この項では、SVGチャートをHTML5にアップグレードする際に適用される制限と、アップグレードの手順について説明します。

- SVGチャートのアップグレードの制限事項について

- 1つのSVGチャートのHTML5へのアップグレード

- アプリケーション内のすべてのSVGチャートのHTML5へのアップグレード

単一または複数のSVGチャートを自動的にHTML5にアップグレードできます。

12.3.6.1.1 SVGチャートのアップグレードの制限事項について

SVGチャートをアップグレードできますが、次の制限事項があります。

- 軸の書式文字列で定義された数値書式のみが移行されます。日付書式および時間書式は無視されます。

- 次の項目を含む数値書式の要素が移行されます。

0,9,D,G,, (comma),. (period),$,C,L,FM

- HTML5チャートの各シリーズのラベルは、各シリーズの列の別名から導出されます。これは各シリーズのラベルが「シリーズ名」属性から導出されるSVGチャートによって異なります。

- SVGチャートでは、最初のシリーズのラベルがX軸に使用されます。HTML5チャートでは、最初のシリーズでデータのラベルが発生していなくても、すべてのデータが表示されるように拡張されています。

12.3.6.1.2 1つのSVGチャートのHTML5へのアップグレード

SVGチャートをHTML5にアップグレードするには、次のステップを実行します。

1. ページに移動します。「コンポーネント・ビューでのページの表示」を参照してください。

2. チャート属性ページにアクセスします。

1. 「リージョン」で、リージョン名を選択します。
リージョン定義が表示されます。

2. 「チャート属性」をクリックします。

3. 「タスク」リストで、「新しいHTML5チャートへのアップグレード」をクリックします。

4. 「アップグレード」をクリックします。

12.3.6.1.3 アプリケーション内のすべてのSVGチャートのHTML5へのアップグレード

すべてのSVGチャートをHTML5チャートにアップグレードするには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。
アプリケーション・ビルダーのホームページが表示されます。

2. アプリケーションを選択します。
アプリケーションのホームページが表示されます。

3. 「ユーティリティ」をクリックして、「アプリケーションのアップグレード」をクリックします。
「アプリケーション・サマリーのアップグレード」レポートが表示されます。

4. 「SVGチャートのHTML5チャートへのアップグレード」で、候補オブジェクトの数をクリックします。

5. アップグレードするオブジェクトを選択し、「アップグレード」をクリックします。

12.3.6.2 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;}

表12-1に、サポートされているすべてのCSSクラスを示します。一部のクラスは、特定のチャート・タイプにのみ適用されます。

表 12-1 使用可能な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

凡例内のすべての矩形アイテムに一律のスタイルを適用します。

12.3.6.3 SVGチャート・カスタム・カスケード・スタイルシートの参照

「チャート属性」ページの「CSS」セクションを使用して、チャート用のカスタム・カスケード・スタイルシートを参照できます。外部CSSを参照する場合は、全体を参照するか、または特定のスタイルを上書きできます。

カスタム・チャートCSSを参照するには、次のステップを実行します。

1. CSSをアプリケーション・ビルダーにアップロードします。「カスケード・スタイルシートのアップロードについて」を参照してください。

2. チャートを含むページにナビゲートします。「コンポーネント・ビューでのページの表示」を参照してください。

3. チャート属性ページにアクセスします。

1. 「リージョン」で、リージョン名を選択します。
リージョン定義が表示されます。

2. 「チャート属性」をクリックします。

4. 「チャート属性」ページで、CSSセクションまでスクロールします。

5. 「カスタムCSSを使用」で、「はい」を選択します。

6. 外部CSSを排他的に参照するには、次のステップを実行します。

1. 「カスタムCSS (リンク)」で、カスタムCSSへのリンクを入力します。次に例を示します。

#IMAGE_PREFIX#themes/theme_4/svg.css

2. CSSが排他的に使用されるように指定します。「カスタムCSS、インライン」で、次のように入力します。

/**/

7. カスタムCSSを参照し、特定のスタイルを上書きするには、次のステップを実行します。

1. 「カスタムCSS (リンク)」で、カスタム・スタイルシートへのリンクを入力します。次に例を示します。

#IMAGE_PREFIX#themes/theme_4/svg.css

2. 「カスタムCSS、インライン」で、上書きするカスタムCSSスタイルを入力します。

12.3.6.4 SVGチャートのカスタムCSSスタイル・インラインの指定

「チャート属性」ページの「カスタムCSS、インライン」属性を使用して、デフォルトCSS内の特定のスタイルを上書きできます。

デフォルトのCSS内の特定のスタイルを上書きするには、次のステップを実行します。

1. チャートを作成します。「SVGチャートのサポートの理解」を参照してください。

2. ページに移動します。「コンポーネント・ビューでのページの表示」を参照してください。

3. チャート属性ページにアクセスします。

1. 「リージョン」で、リージョン名を選択します。
リージョン定義が表示されます。

2. 「チャート属性」をクリックします。

4. 「CSS」までスクロールします。

5. 「カスタムCSSを使用」で、「はい」を選択します。

6. 「カスタムCSS、インライン」で、上書きするカスタムCSSスタイルを入力します。

12.3.6.5 他の言語でのSVGチャートの表示

SVGチャートを他の言語で表示するには、textおよびtspanクラスに正しい言語が反映されるように編集します。

SVGチャートを他の言語で表示するには、次のステップを実行します。

1. ページに移動します。「コンポーネント・ビューでのページの表示」を参照してください。

2. チャート属性ページにアクセスします。

1. 「リージョン」で、リージョン名を選択します。
リージョン定義が表示されます。

2. 「チャート属性」をクリックします。

3. 「CSS」までスクロールします。

4. 「カスタムCSSを使用」で、「はい」を選択します。

5. 「カスタムCSS、インライン」で、textおよびtspanクラスに正しい言語が反映されるように編集します。次の例では、チャートを韓国語に変更する方法を示します。

text{font-family:Batang;fill:#000000;}
tspan{font-family:Batang;fill:#000000;}

12.3.7 HTMLチャートのサポートの理解

以前のリリースのOracle Application Expressでは、HTMLチャートの作成がサポートされていました。既存のHTMLチャートは引き続きサポートされますが、Oracle Application Expressでは作成ウィザードによるHTMLチャートの新規作成はサポートされなくなりました。新しいHTMLチャートのリージョン・タイプのプラグインは、OTNからダウンロードできます。このプラグインは、ユーザーが自分のアプリケーションでHTMLチャート・リージョンを作成できるようにします。

- 1つのHTMLチャートのHTML5へのアップグレード

- すべてのHTMLチャートのHTML5へのアップグレード

関連項目:
リージョン・タイプ・プラグインのHTMLチャート:

http://www.oracle.com/technetwork/developer-tools/apex/application-express/apex-plug-ins-182042.html#region

12.3.7.1 1つのHTMLチャートのHTML5へのアップグレード

HTMLチャートをHTML5にアップグレードするには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。
アプリケーション・ビルダーのホームページが表示されます。

2. アプリケーションを選択します。
アプリケーションのホームページが表示されます。

3. ページに移動します。「コンポーネント・ビューでのページの表示」を参照してください。

4. チャート属性ページにアクセスします。

1. 「リージョン」で、リージョン名を選択します。
リージョン定義が表示されます。

2. 「チャート属性」をクリックします。

5. 「タスク」リストで、「HTML5チャートへのアップグレード」をクリックします。

6. 「アップグレード」をクリックします。

12.3.7.2 すべてのHTMLチャートのHTML5へのアップグレード

すべてのHTMLチャートをHTML5にアップグレードするには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。
アプリケーション・ビルダーのホームページが表示されます。

2. アプリケーションを選択します。
アプリケーションのホームページが表示されます。

3. 「ユーティリティ」をクリックして、「アプリケーションのアップグレード」をクリックします。
「アプリケーション・サマリーのアップグレード」レポートが表示されます。

4. 「HTMLチャートのHTML5チャートへのアップグレード」で、候補オブジェクトの数をクリックします。

5. アップグレードするオブジェクトを選択し、「アップグレード」をクリックします。

12.3.8 Flashチャートの保存について

イメージの保存をサポートするには、AnyChartはhttp://www.anychart.comに存在するサーバー側スクリプトを使用する必要があります。イメージの保存を試みると、データはBase64エンコーディングでこのサーバーに送信されます。次に、サーバーでデコードされ、デコードされたレスポンスが戻されます。

チャートの保存をローカルでサポートする場合は、デコーディング・スクリプトをローカル・サーバーでホストする必要があります。Flashチャートでは、AnyChart JavaScriptのファンクションgetPNGを使用する必要もあります。デフォルトでは、チャート・リージョンは埋込みHTMLタグを使用し、AnyChart JavaScriptコールを使用しません。AnyChart JavaScriptコールを使用するには、Flashチャートのリージョン・ソースを変更する必要があります。

関連項目:
ローカルでのFlashチャート保存のサポートを追加する方法については、AnyChartユーザーズ・ガイドでイメージまたはベクター・ファイルとしてのチャート保存に関する説明を参照してください。

12.3.9 FlashおよびHTML5チャートとのカスタムXMLの使用

チャート属性ページには、標準の属性で制御できない追加のチャート設定があります。チャートのルック・アンド・フィールをさらに制御するには、カスタムXMLを使用できます。

カスタムXMLを使用するには、次のステップを実行します。

1. チャート属性ページにアクセスします。

1. 「リージョン」で、リージョン名を選択します。
リージョン定義が表示されます。

2. 「チャート属性」をクリックします。

2. 「チャートXML」までスクロールします。

3. 「カスタムXMLの使用」から「はい」を選択します。
カスタムXMLの使用を選択した場合、もう適用されない属性を持つリージョンは非表示となります。これらのリージョンを再度表示するには、「カスタムXMLの使用」で「いいえ」を選択します。

4. XMLを編集します。

5. 「変更の適用」をクリックします。

ヒント:
サポートされているチャートのXML書式の詳細は、次のサイトのオンラインXMLリファレンスを参照してください。
http://6.anychart.com/products/anychart/docs/

12.4 アプリケーションのヘルプの作成

アプリケーション・ビルダーで作成したヘルプは、専用の「ヘルプ」ページに表示されます。ヘルプを表示するには、専用の「ヘルプ」ページへのリンクをクリックします。このヘルプ・ページには、表示しているページに固有のページ・ヘルプおよびフィールドレベル・ヘルプのトピックが表示されます。

- ページ・デザイナでのヘルプの作成

- コンポーネント・ビューでのヘルプの作成

- 複数のアイテム・ヘルプ・トピックの同時編集

- ヘルプ・ナビゲーション・バー・エントリの作成

12.4.1 ページ・デザイナでのヘルプの作成

この項では、ページ・デザイナでヘルプを作成する方法について説明します。

- ヘルプの作成について

- ページ・デザイナでのヘルプ・ページおよびヘルプ・リージョンの作成

- ページ・デザイナでのページ・ヘルプの定義

- ページ・デザイナでのアイテム・ヘルプの定義

12.4.1.1 ヘルプの作成について

アプリケーション・ビルダーには、アプリケーションのヘルプを作成するための組込み属性が含まれています。アプリケーションのヘルプを作成するには、次のステップを実行します。

- ステップ1: 専用のヘルプ・ページおよびヘルプ・リージョンを作成します。「ページ・デザイナでのヘルプ・ページおよびヘルプ・リージョンの作成」を参照してください。

- ステップ2: ページ・ヘルプ・テキストを定義します。「ページ・デザイナでのページ・ヘルプの定義」を参照してください。

- ステップ3: アイテム・ヘルプ・テキストを定義します。「ページ・デザイナでのアイテム・ヘルプの定義」を参照してください。

- ステップ4: ヘルプ・ページにリンクするためのナビゲーション・バー・アイコンを作成します。「ヘルプ・ナビゲーション・バー・エントリの作成」を参照してください。

12.4.1.2 ページ・デザイナでのヘルプ・ページおよびヘルプ・リージョンの作成

ページ・デザイナでヘルプ・ページおよびヘルプ・リージョンを作成するには、次のステップを実行します。

1. ヘルプ用の空白ページを作成します。「アプリケーションのホームページからのページの作成」を参照してください。

2. ページ・デザイナで適切なページにナビゲートします。「ページ・デザイナでのページの表示」を参照してください。
ページ・デザイナが表示されます。

3. ギャラリから、「ヘルプ・テキスト」リージョンを選択して、グリッド・レイアウトの適切な場所にドラッグします。

ヒント:
「ヘルプ・テキスト」リージョンを右クリックして、「追加先」を選択し、適切な場所を選択することもできます。

4. プロパティ・エディタですべての属性を表示します。「プロパティ・エディタ・メニュー」から「すべて表示」を選択します。

5. リージョン属性を編集します。

ヒント:
属性の詳細は、プロパティ・エディタで属性を選択し、中央ペインで「ヘルプ」タブをクリックして、参照してください。

1. 指定、タイトル - リージョンのタイトルを入力します。

2. レイアウト - 「順序」、「親リージョン」および「位置」を指定します。

3. 外観 - 「テンプレート」および「アイテム表示位置」を指定します。

6. 「保存」をクリックします。

12.4.1.3 ページ・デザイナでのページ・ヘルプの定義

ページ・デザイナでページ・ヘルプ・テキストを定義するには、次のステップを実行します。

1. ページ・デザイナで適切なページにナビゲートします。「ページ・デザイナでのページの表示」を参照してください。
ページ・デザイナが表示されます。

2. 「レンダリング」ツリーで、ページ名をクリックします。

3. 「プロパティ・エディタ - ページ」で、「ヘルプ」まで下にスクロールして「ヘルプ・テキスト」属性にテキストを入力します。

ヒント:
デフォルトでは、「ヘルプ」にはテキストNo help is available for this pageが入力されています。

4. 「保存」をクリックします。

12.4.1.4 ページ・デザイナでのアイテム・ヘルプの定義

ページ・デザイナでページ・ヘルプ・テキストを定義するには、次のステップを実行します。

1. ページ・デザイナで適切なページにナビゲートします。「ページ・デザイナでのページの表示」を参照してください。
ページ・デザイナが表示されます。

2. 「レンダリング」ツリーで、ヘルプを定義するアイテムをクリックします。

3. 「プロパティ・エディタ - ページ・アイテム」で、「ヘルプ」まで下にスクロールして「ヘルプ・テキスト」属性にテキストを入力します。

4. 「保存」をクリックします。
ヘルプ・テキストが必要な各アイテムに対して、これらのステップを実行します。

12.4.2 コンポーネント・ビューでのヘルプの作成

この項では、コンポーネント・ビューでヘルプを作成する方法について説明します。

- ヘルプの作成について

- コンポーネント・ビューでのヘルプ・ページおよびヘルプ・リージョンの作成

- コンポーネント・ビューでのページ・ヘルプの定義

- コンポーネント・ビューでのアイテム・ヘルプの定義

12.4.2.1 ヘルプの作成について

アプリケーション・ビルダーには、アプリケーションのヘルプを作成するための組込み属性が含まれています。アプリケーションのヘルプを作成するには、次のステップを実行します。

- ステップ1: 専用のヘルプ・ページおよびヘルプ・リージョンを作成します。「コンポーネント・ビューでのヘルプ・ページおよびヘルプ・リージョンの作成」を参照してください。

- ステップ2: ページ・ヘルプ・テキストを定義します。「コンポーネント・ビューでのページ・ヘルプの定義」を参照してください。

- ステップ3: アイテム・ヘルプ・テキストを定義します。「コンポーネント・ビューでのアイテム・ヘルプの定義」を参照してください。

- ステップ4: ヘルプ・ページにリンクするためのナビゲーション・バー・アイコンを作成します。「ヘルプ・ナビゲーション・バー・エントリの作成」を参照してください。

アプリケーション・ビルダーで作成したヘルプは、専用の「ヘルプ」ページに表示されます。ヘルプを表示するには、専用の「ヘルプ」ページへのリンクをクリックします。このヘルプ・ページには、表示しているページに固有のページ・ヘルプおよびフィールドレベル・ヘルプのトピックが表示されます。

12.4.2.2 コンポーネント・ビューでのヘルプ・ページおよびヘルプ・リージョンの作成

アプリケーションのヘルプを作成するための最初のステップは、専用のページおよび「ヘルプ・テキスト」リージョンを作成することです。次の構文を使用してコールすると、作成するリージョンに、カレント・ページのページ・ヘルプおよびアイテム・ヘルプが表示されます。

f?p=&APP_ID.:Page:Session:&APP_PAGE_ID.

コンポーネント・ビューでヘルプ・ページおよびヘルプ・リージョンを作成するには、次のステップを実行します。

1. ヘルプ用の空白ページを作成します。「アプリケーションのホームページからのページの作成」を参照してください。

2. コンポーネント・ビューでページを表示します。「コンポーネント・ビューでのページの表示」を参照してください。

3. 新しいリージョンを作成します。「リージョン」で、「作成」アイコンをクリックします。
「リージョンの作成」ウィザードが表示されます。

4. 「リージョン」で、「作成」アイコンをクリックします。

5. リージョン・タイプを選択するプロンプトが表示されたら、「ヘルプ・テキスト」を選択して「次へ」をクリックします。

6. 「表示属性」で、次のステップを実行します。

1. タイトル - リージョンのタイトルを入力します。選択するリージョン・テンプレートにリージョン・タイトルが表示される際に、このタイトルが表示されます。

2. リージョン・テンプレート: リージョンの外観を制御するテンプレートを選択します。

3. 親リージョン: 新しいリージョンが属する親リージョンを定義します。

4. 表示ポイント: このリージョンの表示ポイントを指定します。詳細は、フィールドレベル・ヘルプを参照してください。

5. 順序: このコンポーネントの順序を指定します。これによって評価の順序が決まります。

6. 「次へ」をクリックします。

7. 「ソース」で、「次へ」をクリックします。

8. 「条件付き表示」で、次のステップを実行します。

1. 条件タイプ: このコンポーネントがレンダリングされるために満たす必要があるリストから、条件タイプを選択します。「条件付きのレンダリングおよびプロセスの理解」を参照してください。

2. 認可スキーム: オプションで認可スキームを選択します。このコンポーネントをレンダリングまたは処理するためには、この認可スキームがTRUEと評価される必要があります。「認可を介したセキュリティの提供」を参照してください。

3. 「次へ」をクリックします。

9. 「リージョンの作成」をクリックします。

12.4.2.3 コンポーネント・ビューでのページ・ヘルプの定義

コンポーネント・ビューでページ・ヘルプ・テキストを定義するには、次のステップを実行します。

1. ページ・ヘルプを追加するページにナビゲートします。「コンポーネント・ビューでのページの表示」を参照してください。

2. 「ページ」で、「編集」アイコンをクリックします。

3. 「ヘルプ」までスクロールします。

4. 表示されたフィールドにヘルプ・テキストを入力します。

ヒント:
デフォルトでは、「ヘルプ」にはテキストNo help is available for this pageが入力されています。

5. 「変更の適用」をクリックします。

ページ・ヘルプ・テキストが必要な各ページに対して、これらのステップを実行します。

12.4.2.4 コンポーネント・ビューでのアイテム・ヘルプの定義

コンポーネント・ビューでアイテム・ヘルプを定義するには、次のステップを実行します。

1. ヘルプを追加するページにナビゲートします。「コンポーネント・ビューでのページの表示」を参照してください。

2. 「アイテム」で、編集するアイテムを探します。

3. アイテムの属性ページにアクセスします。「アイテム」で、アイテム名を選択します。
「ページ・アイテムの編集」ページが表示されます。

4. 「ヘルプ・テキスト」までスクロールします。

5. 表示されたフィールドにヘルプ・テキストを入力します。

6. 「変更の適用」をクリックします。

ヘルプ・テキストが必要な各アイテムに対して、これらのステップを実行します。

12.4.3 複数のアイテム・ヘルプ・トピックの同時編集

この項では、複数のヘルプ・トピックを一度に編集する様々な方法について説明します。

- 「アイテム・ヘルプをバルク編集」レポートへのアクセス

- アイテム・ヘルプ・トピックのシード

- 既存のアイテム・ヘルプ・トピックの検索

- アイテム・ラベルの検索

12.4.3.1 「アイテム・ヘルプをバルク編集」レポートへのアクセス

アプリケーションにヘルプを含める場合は、「アイテム・ヘルプをバルク編集」レポートを使用して、複数のヘルプ・トピックを一度に編集できます。

「アイテム・ヘルプをバルク編集」レポートを表示するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「ユーティリティ」アイコンをクリックします。

4. 「ページ固有のユーティリティ」から、「アイテム・ユーティリティ」を選択します。

5. 「すべてのアイテム・ヘルプ・テキストのグリッド編集」をクリックします。

6. アイテム・ヘルプのバルクレポートでは、次の操作が可能です。

- 既存のヘルプ・トピックを更新できます。表示されるヘルプ・テキストを編集し、「変更の適用」をクリックします。

- ページ番号をクリックして、アイテムが含まれているページにリンクできます。

- アイテム名をクリックして、ページ・アイテムにリンクできます。

12.4.3.2 アイテム・ヘルプ・トピックのシード

アプリケーションにヘルプが含まれていない場合は、デフォルトのヘルプ・テキストの一括更新を実行できます。

ヘルプ・トピックをシードするには、次のステップを実行します。

1. 「「アイテム・ヘルプをバルク編集」レポートへのアクセス」の説明に従って「アイテム・ヘルプをバルク編集」レポートにアクセスします。

2. 「アイテム・ヘルプ・テキストのシード」をクリックします。

3. 「デフォルトのヘルプ・テキスト」で、すべてのヘルプ・トピックに表示されるデフォルト・テキストを入力します。

4. 「変更の適用」をクリックします。

12.4.3.3 既存のアイテム・ヘルプ・トピックの検索

既存のヘルプ・テキストまたはアイテム・ラベルを検索できます。

既存のヘルプ・トピックを検索するには、次のステップを実行します。

1. 「「アイテム・ヘルプをバルク編集」レポートへのアクセス」の説明に従って「アイテム・ヘルプをバルク編集」レポートにアクセスします。

2. 「ヘルプの内容」にキーワードを入力します。

3. 「実行」をクリックします。

12.4.3.4 アイテム・ラベルの検索

アイテム・ラベルを検索するには、次のステップを実行します。

1. 「「アイテム・ヘルプをバルク編集」レポートへのアクセス」の説明に従って「アイテム・ヘルプをバルク編集」レポートにアクセスします。

2. 「ヘルプの内容」にキーワードを入力します。

3. 「実行」をクリックします。

関連項目:
「アプリケーション・ユーティリティへのアクセス」

12.4.4 ヘルプ・ナビゲーション・バー・エントリの作成

ヘルプを作成したら、次に、ユーザーがリンクに使用するためのナビゲーション・バー・エントリを作成します。

ナビゲーション・バー・エントリを作成するには、次のステップを実行します。

1. ナビゲーション・バー・エントリ・ページにナビゲートします。

1. 「ワークスペース」ホームページにナビゲートします。

2. 「アプリケーション・ビルダー」アイコンをクリックします。

3. アプリケーションを選択します。

4. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

5. 「ナビゲーション」で、「ナビゲーション・バー・エントリ」をクリックします。

2. 「作成」をクリックします。
ナビゲーション・バー・エントリの作成ウィザードが表示されます。

3. 「方法」で、「最初から」を選択し、「次へ」をクリックします。

4. 「タイプ」で、「URLへのナビゲーション」を選択して「次へ」をクリックします。

5. 「属性」で、次のように指定します。

1. 順序: このコンポーネントの評価の順序を指定します。

2. エントリ・ラベル: このナビゲーション・バー・エントリの表示テキストを入力します。

3. アイコン・イメージ名: イメージ名を入力します。ネーミング規則の詳細は、フィールドレベル・ヘルプを参照してください。「フィールドレベル・ヘルプの表示」を参照してください。

4. イメージALT: イメージのナビゲーション・アイコンのALTテキストを入力します。イメージ名を指定しないと、このテキストが表示されます。

5. イメージの高さ: イメージの高さをピクセルで定義します。

6. 「次へ」をクリックします。

6. 「ターゲット」で、次のステップを実行します。

1. ターゲットは: 「このアプリケーションのページ」を選択します。

2. ページ: 「ページ・デザイナでのヘルプの作成」で作成したヘルプ・ページのページ番号を指定します。

3. リクエスト: 次を入力します。

&APP_PAGE_ID.

「リクエスト」に置換文字列&APP_PAGE_IDを指定することによって、Application Expressエンジンに対して、ユーザーがこのアイコンをクリックした場合にカレント・ページのヘルプ・テキストを表示するように指示します。

4. 「次へ」をクリックします。

7. ナビゲーション・バー・エントリを表示するための条件を設定するには、条件タイプを選択します。

8. 「作成」をクリックします。

関連項目:
「ナビゲーション・バー・エントリの作成」

13 テーマおよびテーマ・スタイルの使用

ここでは、テーマおよびテンプレートを使用して、データベース・アプリケーションのユーザー・インタフェースおよびページ・レイアウトを変更する様々な方法について説明します。

- テーマの使用

- テーマおよびサブスクリプションの管理

- カスタム・テーマの作成

- カスタム・カスケード・スタイルシートの使用

13.1 テーマの使用

この項では、Oracle Application Expressアプリケーションを構築するときにテーマおよびテーマ・スタイルを使用する方法について説明します。

- テーマについて

- レスポンシブ・デザインについて

- グリッドベース・テーマについて

- テーマ・スタイルの使用

- テンプレート・オプションの理解

- テーマ・ページへのアクセス

- テーマの編集

関連項目:
「テーマおよびサブスクリプションの管理」および「テーマおよびサブスクリプションの管理」

13.1.1 テーマについて

テーマは、アプリケーション全体のレイアウトおよびスタイルを定義できるテンプレートのコレクションです。テーマにはテンプレートの完全なセットが用意され、アプリケーションに必要となる可能性があるすべてのUIパターンが提供されます。テンプレートはまず、テンプレート・タイプ別に分類され、次にテンプレート・クラス別に分類されます。テンプレート・タイプには、ページ、リージョン、レポート、リスト、ボタン、ラベルおよびポップアップ値リスト(LOV)があります。

各テンプレート・タイプには、多くのテンプレート・クラスがあります。テンプレート・クラスによって、テンプレート・タイプ内でのテンプレートの用途が定義されます。たとえば、リージョン・テンプレートは、フォーム・リージョン・テンプレート、レポート・リージョン・テンプレートなどとして分類できます。このような分類によって、Oracle Application Expressではテーマ間でのテンプレートのマッピングが可能になり、アプリケーション全体のルック・アンド・フィールを簡単に変更できます。

Oracle Application Expressには、広範なテーマ・リポジトリが同梱されています。管理者は、次のようにテーマをテーマ・リポジトリに追加できます。

- ワークスペース・テーマ - ワークスペース管理者は、ワークスペース内のすべての開発者が使用できるテーマを作成できます。「ワークスペース・テーマの管理」を参照してください。

- パブリック・テーマ - インスタンス管理者は、Oracle Application Express管理サービスに追加することでパブリック・テーマを作成できます。追加すると、これらのパブリック・テーマはインスタンス内のすべてのワークスペースですべての開発者が使用できます。詳細は、『Oracle Application Express管理ガイド』のパブリック・テーマの管理に関する説明を参照してください。

ユニバーサル・テーマ - 42やモバイル - 51などの新しいテーマには、テーマ・スタイルが含まれています。テーマ・スタイルは、ベースCSSに追加されるCSSスタイルシートです。開発者は、テーマ・ローラー・ユーティリティを使用してテーマ・スタイルを変更することによって、アプリケーションの外観を変更できます。

関連項目:
「テーマ・スタイルの使用」

13.1.2 レスポンシブ・デザインについて

レスポンシブ・デザインにより、ページを表示するデバイス(たとえば、デスクトップ・コンピュータ、ラップトップ・コンピュータ、タブレットまたはスマートフォン)にかかわらず、レイアウトを使用可能スペースに適合させるようなWebページを設計できます。レスポンシブ・デザインを実装することによって、ユーザーは大きい画面では完全な操作性を取得できます。スマートフォンやタブレットでも、レイアウトは特定のデバイスのサイズに調整されます。このサイズ変更のプロセス中に、要素の位置やサイズが変わったり、非表示になったりします。レスポンシブ・デザインの目的は、可能なすべての画面サイズで、すべての重要なコンテンツをユーザー・フレンドリな方法で表示することです。ユニバーサル・テーマ - 42は、レスポンシブ・ユーザー・インタフェース・テーマの例です。

レスポンシブ・デザインは単なる1セットのテンプレートの選択の問題ではありません。アプリケーション開発者として、テーマのテンプレートの使用に責任を負い、本当にレスポンシブ・デザインを促進するページを設計します。既存のアプリケーションをユニバーサル・テーマに変換するには、すべてのアプリケーション・ページを確認して、適切なテンプレートおよびレイアウトが確実に定義されていることが必要です。

Oracle Application Expressでは、任意の画面サイズに拡大/縮小可能なアプリケーションを構築できるレスポンシブ・ユーザー・インタフェース・テーマが提供されます。ユニバーサル・テーマ - 42は、レスポンシブ・デスクトップ・テーマです。開発者は、このテーマを使用して、様々な画面サイズで正しく機能するアプリケーションを構築できます。

モバイル・テーマ - 51を使用すると、スマートフォンやタブレットなどのモバイル・デバイスでの使用に最適化されたアプリケーションを構築できます。モバイル・テーマを使用して構築されたページは、デスクトップ・ページよりも小さく軽量であり、タッチ・イベントおよび方向の変更がサポートされます。

ヒント:
ユニバーサル・テーマ - 42を使用してアプリケーションを表示するには、「パッケージ・アプリケーションの使用」を参照してください

13.1.3 グリッドベース・テーマについて

Oracle Application Expressアプリケーションでは、リージョンおよびアイテムのページ上の位置は、グリッド設定を使用して定義されます。テーマ26 - 生産性アプリケーションなどの古いテーマでは、表ベースのグリッドが使用されます。表ベースのテーマでは、複数のリージョンを隣り合せに配置でき、フォームの単一行に複数のアイテムを含めることができます。ユニバーサル・テーマ - 42などの新しいテーマでは、DIVベースのグリッドが使用されます。DIVベースのグリッドを使用するページには、次のような利点があります。

- より簡単に維持および更新できます。DIVベースのページはコードが少ないため、複雑さが減少します。

- より速くロードされます。DIVベースのグリッドを使用するページは、一般的に、より速くロードされます。

表ベースのテーマからDIVベースのテーマに切り替える場合、テーマの切替えウィザードで「グリッドのリセット」オプション、「固定リージョン位置のリセット」を構成する必要があります。「固定リージョン位置のリセット」を選択すると、既存の設定は削除され、すべてのリージョンおよびアイテムが垂直に積み上げられて表示されます。

関連項目:
「テーマの切替え」

13.1.4 テーマ・スタイルの使用

ユニバーサル・テーマ - 42やモバイル - 51などの新しいテーマには、テーマ・スタイルが含まれています。テーマ・スタイルは、ベースCSSに追加されるCSSです。開発者は、テーマ・ローラー・ユーティリティを使用してアプリケーションの外観を変更できます。

- テーマ・スタイルについて

- テーマ・スタイルの作成

- テーマ・スタイルの編集

- テーマ・ローラーの使用

13.1.4.1 テーマ・スタイルについて

テーマ・スタイルでは、アプリケーションのルック・アンド・フィールを変更するためにベースCSSに追加される、CSSスタイルシートを定義します。ユニバーサル・テーマ - 42やモバイル - 51などの新しいテーマには、ベースCSSファイルに加えてテーマ・スタイルCSSファイルを含めることができます。テーマ・スタイルCSSファイルは、ページ・テンプレート内で#THEME_STYLE_CSS#置換文字列を使用して参照されます。Application Expressエンジンによって、この置換文字列は、テーマ・スタイル属性で定義されているCSSファイル参照と置き換えられます。テーマ・スタイルを使用して、テーマをカスタマイズしたり、別のカラー・スキームに切り替えたり、フラットな外観を適用したり、テーマをレスポンシブにします。1つのテーマに複数のテーマ・スタイルを設定し、その1つのスタイルをアクティブに設定できます。テーマ・スタイルCSSファイルは、テーマ・ローラーを使用して変更できます。

定義した後は、テーマ・スタイルを次のように選択できます。

- アプリケーションの作成ウィザードの実行時に、「テーマ・スタイル」属性を編集します。「アプリケーションの作成ウィザードの使用」を参照してください。

- 「ユーザー・インタフェースの詳細」、「属性」、「テーマ・スタイル」を編集します。「アプリケーションのユーザー・インタフェースの管理」を参照してください。

- テーマの作成/編集ページにアクセスし、「スタイル」を編集します。「テーマの編集」および「スタイル」を参照してください。

13.1.4.2 テーマ・スタイルの作成

テーマ・スタイルを作成するには、次のステップを実行します。

1. テーマ・ページにナビゲートします。「テーマ・ページへのアクセス」を参照してください。

2. テーマを選択し、「スタイル」タブをクリックします。

3. 「スタイルの追加」をクリックします。

4. 「設定」で、次の項目を指定します。

1. 名前 - テーマ・スタイルに説明的な短い名前を指定します。

2. カレント - このスタイルが、テーマで使用されている現在のスタイルかどうかを選択します。

3. ファイルURL - このスタイルが、テーマで使用されている現在のスタイルかどうかを選択します。

5. 「テーマ・ローラー属性」について:

1. 読取り専用 - テーマ・スタイルが更新されないようにする場合は、「はい」を選択します。テーマ・スタイルをテーマ・ローラーを使用して編集および上書きできるようにする場合は、「いいえ」を選択します。

2. 入力パラメータ・ファイルURL - テーマ・ローラーの使用時に、このテーマ・スタイルを生成するために使用されるLESSファイルのURLを入力します。

3. JSON構成 - テーマ・スタイルが保存されると、テーマ・ローラーによってJSON構成が生成されます。
構成を手動で更新することはお薦めしません。ただし、別のアプリケーションのテーマ・スタイルなど、別のテーマ・スタイルからJSON構成をコピーして手動で更新できます。

6. 「作成」をクリックします。

13.1.4.3 テーマ・スタイルの編集

テーマ・スタイルを編集するには、次のステップを実行します。

1. テーマ・ページにナビゲートします。「テーマ・ページへのアクセス」を参照してください。

2. テーマを選択し、「スタイル」タブをクリックします。

3. テーマ・スタイルを選択します。
テーマ・スタイル・ページが表示されます。

4. 現在のテーマ・スタイルを変更するには、該当する属性を編集し、「変更の適用」をクリックします。
属性の詳細は、フィールドレベル・ヘルプを参照してください。

5. 現在のテーマ・スタイルを削除するには、「削除」をクリックします。

6. 「作成」をクリックします。

13.1.4.4 テーマ・ローラーの使用

テーマ・ローラーは、開発者がコード行を変更することなく、アプリケーションの色や角丸などの属性を迅速に変更できる、ライブCSSエディタです。テーマ・ローラーは、テーマ・スタイルの少なくとも1つに、「入力パラメータ・ファイルURL」属性が定義されている場合に、実行時開発者ツールバーに表示されます。

ヒント:
テーマ・ローラーの例を参照するには、ユニバーサル・テーマ - 42を使用するパッケージ・アプリケーションを実行します。「パッケージ・アプリケーションの使用」を参照してください。

テーマ・ローラーを使用するには、次のステップを実行します。

1. ページを実行してプレビューします。「アプリケーションまたはページの実行」を参照してください。
開発者がデスクトップ・アプリケーションを実行すると、編集可能な実行中のページの下部に、実行時開発者ツールバーが表示されます。

ヒント:
テーマ・ローラーは、テーマ・スタイルが定義されている場合にのみ、実行時開発者ツールバーに表示されます。「テーマの編集」および「スタイル」を参照してください。

2. 実行時開発者ツールバーで、「テーマ・ローラー」をクリックします。
テーマ・ローラーによって、アプリケーションのスタイルがフェッチされ、エディタにロードされます。

アクティブなアイコンおよびメニューの上にカーソルをあわせると、その名前が表示されます。

3. セクション名をクリックすると、セクションを開閉できます。主なコントロールには、次のものがあります。

- 共通の表示 - すべての属性を表示します。

ヒント:
「カスタムCSS」セクションを変更することで、ユニバーサル・テーマのテーマ・スタイルを上書きできます。このセクションで使用するセレクタに注意してください。コンテンツを非表示または不鮮明な表示にすると、ユーザーの操作性が低下する場合があります。

- すべて表示 - すべての属性が表示されます。

- 元に戻す - 現在編集しているテーマを前のアクションに戻します。この機能は、テーマを切り替えた場合は動作しません。

- やり直し - 現在の「元に戻す」リビジョンを破棄し、履歴の次のリビジョンに進みます。この機能は、テーマを切り替えた場合は動作しません。

- 検索 - プロパティ、グループおよび色を検索します。検索すると、検索文字列と一致するプロパティのみがテーマ・ローラーによって自動的に表示されます。

- リセット - 選択したテーマをサーバーに保存されている最終バージョンに戻します。テーマをリセットしてページをリロードした後で、「元に戻す」および「やり直し」を使用して変更をリストアできます。

- ヘルプ - ヘルプ・ウィンドウを表示します。

4. 新しいスタイルを選択するには、既存のスタイルを「スタイル」リストから選択します。

5. テーマ・スタイルのすべての色を一度に変更するには、カラー・ホイールで円をドラッグします。テーマ・スタイルが1色に基づくようにするか(モノクロ)2色に基づくようにするか(二重)を選択できます。

6. 特定のコンポーネントを編集するには、グループを開き、編集するコンポーネントの色またはスタイル設定をクリックします。
前景色および背景色の選択をサポートする属性の場合、2つのカラー選択の前にあるチェック・ボックスは、Webコンテンツ・アクセシビリティ・ガイドライン(WCAG) 2.0に基づくカラー・コントラスト情報を示します。計算されたコントラスト・スコアがより高いことは、そのカラーの組合せのアクセシビリティがより高いことを示します。

ヒント:
作業中のテーマ・スタイルをアプリケーションの現在のテーマ・スタイルとして設定するには、「現行として設定」をクリックします。

7. 作業中のテーマ・スタイルをアプリケーションの現在のテーマ・スタイルとして設定するには。

8. 「保存」をクリックして、サーバーに変更をコミットします。選択したテーマが読取り専用の場合は、「名前を付けて保存」をクリックして、変更を新しいテーマとして保存します。

13.1.5 テンプレート・オプションの理解

開発者はテンプレート・オプションを使用して、宣言的な方法でOracle Application Expressのページ上のコンポーネントに様々なスタイルを適用できます。

- テンプレート・オプションについて

- デフォルト・テンプレート・オプションについて

関連項目:
「テンプレート・オプションの使用」

13.1.5.1 テンプレート・オプションについて

テンプレート・オプションによって、開発者は、ページ、リージョン、レポート、リスト、ブレッドクラム、アイテムおよびボタンに関して選択したテンプレートにCSS修飾子を宣言的に適用できます。CSS修飾子は、CSSスタイルシートで定義されたCSSクラスの参照です。CSS修飾子によって、開発者は同じHTMLマークアップを使用しながら、CSSを適用することでそれを様々なスタイルで表示できます。ボタンの色、リージョンの幅、フォントの設定、アイテム・ラベルのマークアップなどで様々なスタイルを実現するために、ほぼ同一の多数のテンプレートをテーマで定義する必要性が、テンプレート・オプションによって減少します。

開発者は、次に示す例のような方法で、テンプレート・オプションを使用できます。

- 様々な色またはアクセントの適用

- 様々な間隔および余白の適用

- 様々なスタイルでのボタンのレンダリング(アイコンあり/なし)

- 様々な位置合せでのフォーム・フィールドの表示。

テンプレート・オプションを使用しない場合、これらのバリエーションを適用するには、ほぼ同一の非常に多くのテンプレート、またはCSSに関する詳細な知識が必要になります。テンプレート・オプションがサポートされるコンポーネントには、ページ、リージョン、クラシック・レポート、ブレッドクラム、リスト、アイテム、ラベル、ボタンがあります。

13.1.5.2 デフォルト・テンプレート・オプションについて

開発者は、テンプレート・オプション・グループに含まれていないテンプレート・オプションを、特定のテンプレートのデフォルトにすることを選択できます。アプリケーション・ビルダーでは、テンプレートを参照するコンポーネントをレンダリングすることによって、デフォルト・テンプレート・オプションを自動的に適用します。デフォルト・テンプレート・オプションは、実際のコンポーネントには書き込まれません。かわりに、#DEFAULT#置換文字列がコンポーネントに対して定義されるため、開発者はテンプレート・オプションのデフォルトを一元的に変更できます。

開発者は、テンプレート・オプションのデフォルトを使用しないことを選択でき、その場合は、#DEFAULT#置換文字列がコンポーネントから削除されます。テンプレート・オプションのデフォルトを無効にすると、開発者は使用可能なテンプレート・オプションをコンポーネントに選択的に適用できます。コンポーネントを編集するときに直接選択したすべてのテンプレート・オプションは、コンポーネントのメタデータに書き込まれ、対応するCSSクラス文字列によって表されます。実行時に、選択されたテンプレート・オプションとデフォルト・テンプレート・オプションはデフォルトの一部であり、コンポーネントのCSSクラス文字列と組み合されてコンポーネントに適用されます。

13.1.5.3 テンプレート・オプション・グループおよび事前設定について

開発者は、テンプレート・オプション・グループを作成することによって、関連するテンプレート・オプションの用途を定義できます。テンプレート・オプション・グループの例には、ボタン・サイズ、ボタン・スタイル、リストの例、リスト・スタイルおよびフォーム・ラベルの位置があります。開発者は、テンプレート・オプション・グループを作成するときに、テンプレート・レベルでテンプレート・オプションの事前設定を指定できます。たとえば、テンプレート・オプションLargeおよびSmallがあるボタン・テンプレートがあるとします。Smallを事前設定として定義した場合、このテンプレートを参照する新しいボタンには、作成時にテンプレート・オプションSmallが自動的に適用されます。グループに含まれているテンプレート・オプションは、事前設定がテンプレート・レベルで定義されていない場合はオプションです。

13.1.6 テーマ・ページへのアクセス

テーマ・ページでテーマを管理します。

ヒント:
テーマに選択したデフォルトのテンプレートを、テーマの作成/編集ページで変更できます。「テーマの編集」を参照してください。

「テーマ」ページにアクセスするには、次の手順を実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「ユーザー・インタフェース」で、「テーマ」を選択します。
テーマ・ページが表示されます。

5. 「レポートの表示」アイコンをクリックします。
テーマ・ページがレポートとして表示されます。「カレント」列のチェック・マークはどのテーマが選択されているかを示します。

6. テーマ名をクリックします。
テーマの編集ページが表示されます。

13.1.7 テーマの編集

この項では、テーマ属性の編集方法について説明します。

- テーマの編集

- テーマ属性

関連項目:
「カスタム・テーマの作成」

13.1.7.1 テーマの編集

テーマを確認または編集するには、次の手順を実行します。

1. テーマ・ページにナビゲートします。「テーマ・ページへのアクセス」を参照してください。

2. テーマ名をクリックします。
テーマの作成/編集ページが表示され、このページはいくつかのセクションに分かれています。

3. 対象となる属性を編集します。
詳細は、「テーマ属性」を参照してください。

4. 変更を保存するには、「変更の適用」をクリックします。

13.1.7.2 テーマ属性

この項では、テーマ属性の作成/編集ページ上の属性について説明します。属性の詳細および例を確認するには、フィールドレベル・ヘルプを参照してください。

- 名前

- テーマのサブスクリプション

- JavaScriptおよびカスケード・スタイルシート

- コンポーネントのデフォルト値

- リージョンのデフォルト値

- ダイアログのデフォルト

- 遷移のデフォルト値

- グローバル・テンプレート・オプション

- アイコン

- イメージ

- スタイル

- ファイル

13.1.7.2.1 名前

表13-1に、「名前」の属性を示します。

表13-1 名前

属性

説明

アプリケーション

カレント・アプリケーションIDを指定します。

関連項目: 「アプリケーション属性の編集」

テーマ番号

テーマの番号を指定します。テーマは、アプリケーションのユーザー・インタフェースを定義するテンプレートのコレクションです。

名前

テーマの説明的な短い名前を入力します。

ユーザー・インタフェース

テーマの設計対象のユーザー・インタフェースを指定します。

関連項目: 「ユーザー・インタフェースの詳細ページ」

ナビゲーション・タイプ

選択するナビゲーション・タイプを指定します。有効なオプションは、「タブ」または「リスト」です。

関連項目: 「タブの作成」および「リストの作成」

ナビゲーション・バー実装

選択するナビゲーション・バー実装を指定します。有効なオプションは、「クラシック」または「リスト」です。

関連項目: 「ユーザー・インタフェースの詳細ページ」

説明

テーマの説明を入力します。

13.1.7.2.2 テーマのサブスクリプション

このアプリケーションがサブスクライブするテーマを表示します。アプリケーションがテーマにサブスクライブすると、すべてのテーマ属性、サブスクライブされたテンプレート・オプションおよびサブスクライブされたテンプレートは読取り専用に設定されます。

13.1.7.2.3 JavaScriptおよびカスケード・スタイルシート

表13-2に、「JavaScriptおよびカスケード・スタイルシート」の属性を示します。

表13-2 JavaScriptおよびカスケード・スタイルシート

属性

説明

JavaScriptファイルURL

すべてのページにロードするコードのJavaScriptのファイルURLを入力します。各URLを新しい行に記述する必要があります。ファイルの縮小バージョンを指定する場合、置換文字列#MIN#を使用して.minを、または#MIN_DIRECTORY#を使用してminified/を通常ページ・ビューのファイルURLに含めたり、ページをデバッグ・モードで表示する場合は空の文字列を含めることができます。ここに入力したJavaScriptのファイルURLによって、ページ・テンプレート内の#THEME_JAVASCRIPT#置換文字列が置き換えられます

例を表示するには、フィールドレベル・ヘルプを参照してください。

CSSファイルURL

すべてのページにロードするカスケード・スタイルシートのファイルURLを入力します。各URLを新しい行に記述する必要があります。ファイルの縮小バージョンを指定する場合、置換文字列#MIN#を使用して.minを、または#MIN_DIRECTORY#使用してminified/を通常ページ・ビューのファイルURLに含めたり、ページをデバッグ・モードで表示する場合は空の文字列を含めることができます。アプリケーションのバージョンをファイルURLに含める場合は、置換文字列#APP_VERSION#を使用することもできます。ここに入力したファイルURLによって、ページ・テンプレート内の#THEME_CSS#置換文字列が置き換えられます。

例を表示するには、フィールドレベル・ヘルプを参照してください。

13.1.7.2.4 コンポーネントのデフォルト値

表13-3に、デフォルトのテンプレートをコンポーネント・タイプ別に示します。

表13-3 コンポーネントのデフォルトのテンプレート

属性

説明

ページ

ページを表示するためのデフォルトのテンプレートを指定します。開発者が明示的にテンプレートを選択しない場合、Application Expressエンジンは、ここで指定されたテンプレートを使用します。

関連項目: 「表示属性」

ナビゲーション・バー・リスト

アプリケーションでナビゲーション・バー・タイプをリストとして定義する場合に使用されるデフォルトのナビゲーション・バー・リスト・テンプレートを指定します。開発者が明示的にテンプレートを選択しない場合、Application Expressエンジンは、ここで指定されたテンプレートを使用します。

関連項目: 「表示属性」

ナビゲーション・メニュー・リストの位置

デフォルトのナビゲーション・メニュー・リストの位置を指定します。

ナビゲーション・メニュー・リスト(トップ)

ページ上部に表示される新しいリストを作成する場合に使用されるデフォルトのナビゲーション・メニュー・リスト・テンプレートを指定します。

ナビゲーション・メニュー・リスト(サイド)

ページの横に表示される新しいリストを作成する場合に使用されるデフォルトのナビゲーション・メニュー・リスト・テンプレートを指定します。

ログイン・ページ

ページを表示するためのデフォルトのテンプレートを指定します。開発者が明示的にテンプレートを選択しない場合、Application Expressエンジンは、ここで指定されたテンプレートを使用します。

エラー・ページ

オプション。インライン表示されるエラーではなく、個別のページに表示されるエラーに使用するページ・テンプレートを指定します。エラーを表示するように設計されたテンプレートを使用しない場合、この属性は、空白のままにします。この設定は標準ページにのみ適用されます。

「印刷用」ページ

Application Expressエンジンが印刷用モードの場合に使用するテンプレートを指定します。

ページをレンダリングするためにApplication Expressをコールする場合、「はい」または「いいえ」の値で印刷用属性を指定するオプションがあります。「はい」を選択すると、印刷用テンプレートを使用してページが表示されます。Application Expressエンジンは、HTMLフォーム・フィールド内のすべてのテキストをテキストとして表示します。印刷用テンプレートには、#FORM_OPEN#タグまたは#FORM_CLOSE#タグは必要ありません。目的は、表をほとんど使用しないで、印刷に適した書式で情報を表示できるようにすることです。

ブレッドクラム

ブレッドクラムを作成する場合に使用するデフォルトのブレッドクラム・テンプレートを指定します。

ボタン

ボタンを作成する場合に使用するデフォルトのボタン・テンプレートを指定します。

レガシー・カレンダ

カレンダを作成する場合に使用するデフォルトのカレンダ・テンプレートを指定します。

デフォルトのラベル

新しいラベルを作成する場合に使用するデフォルトのラベル・テンプレートを指定します

オプションのラベル

新しいラベルを作成する場合に使用するデフォルトのオプションのラベル・テンプレートを指定します。

ページ・テンプレート・オプション

テンプレート・オプションによって、カレント・ページ・テンプレートに適用される多くのCSSカスタマイズ設定を選択できます。テンプレート・オプションとそれに対応するCSSクラスは、ページ・テンプレート・レベルで定義されます。ページ・テンプレートには、ページ・ヘッダーまたはボディで定義された置換文字列#PAGE_CSS_CLASSES#が必要です。文字列#PAGE_CSS_CLASSES#はすべての手動で入力したページCSSクラスに置き換えられ、これは選択したテンプレート・オプションで定義されているCSSクラスと組み合されます。

必須ラベル

新しいラベルを作成する場合に使用するデフォルトの必須ラベル・テンプレートを指定します。

リスト

リストを作成する場合に使用するデフォルトのリスト・テンプレートを指定します。

リージョン

リージョンを作成する場合に使用するデフォルトのリージョン・テンプレートを指定します。

クラシック・レポート

レポートを作成する場合に使用するデフォルトのリージョン・テンプレートを指定します。

ヘッダー・ツールバー

ヘッダーまたはフッター・ツールバーを含む新しいページを作成する場合に使用する、デフォルトのヘッダー・ツールバー・リージョン・テンプレートを指定します。

フッター・ツールバー

ヘッダーまたはフッター・ツールバーを含む新しいページを作成する場合に使用する、デフォルトのヘッダー・ツールバー・リージョン・テンプレートを指定します。

13.1.7.2.5 リージョンのデフォルト値

表13-4に、「リージョンのデフォルト値」で使用可能なデフォルトのテンプレートを示します。

表13-4 リージョンのデフォルト値

属性

説明

ブレッドクラム

ブレッドクラムを作成する場合に使用するデフォルトのブレッドクラム・テンプレートを指定します。

チャート

チャートを作成する場合に使用するデフォルトのチャート・テンプレートを指定します。

フォーム

フォームを作成する場合に使用するデフォルトのフォーム・テンプレートを指定します。

リスト

リストを作成する場合に使用するデフォルトのリージョン・テンプレートを指定します。

レポート

レポートを作成する場合に使用するデフォルトのリージョン・テンプレートを指定します。

表形式フォーム

表形式フォームを作成する場合に使用するデフォルトのリージョン・テンプレートを指定します。

ウィザード

新しいウィザード・コンポーネントを作成する場合に使用するデフォルトのリージョン・テンプレートを指定します。

対話モード・レポート

対話モード・レポートを作成する場合に使用するデフォルトのリージョン・テンプレートを指定します

13.1.7.2.6 ダイアログのデフォルト

表13-5に、「ダイアログのデフォルト」で使用可能なデフォルトのテンプレートを示します。

表13-5 ダイアログのデフォルト

属性

説明

ダイアログ・コンテンツ・リージョン

ページの作成ウィザードおよびアプリケーションの作成ウィザードを使用してダイアログのコンテンツ・リージョンを作成する場合に使用する、デフォルトのリージョン・テンプレートを指定します。

ダイアログ・ボタン・リージョン

ページの作成ウィザードおよびアプリケーションの作成ウィザードを使用してダイアログのボタン・リージョンを作成する場合に使用する、デフォルトのリージョン・テンプレートを指定します。

ダイアログ・ページ

モーダルまたは非モーダル・ダイアログ・ページを表示するためのデフォルトのテンプレートを指定します。開発者が明示的にテンプレートを選択しない場合、Application Expressエンジンは、ここで指定されたテンプレートを使用します。このテンプレートは、インライン表示されるエラーではなく、個別のページに表示されるエラーにも使用されます。

13.1.7.2.7 遷移のデフォルト値

「遷移のデフォルト値」は、モバイル・テーマについてのみ表示されます。表13-6に、「遷移のデフォルト値」で使用可能な属性を示します。

表13-6 遷移のデフォルト値

属性

説明

ページ遷移

新しいページにナビゲートするとき、またはページを送信したときに使用する遷移を指定します。

ポップアップ遷移

ポップアップが開かれたときに使用する遷移を指定します。

13.1.7.2.8 グローバル・テンプレート・オプション

グローバル・テンプレート・オプションは、テーマレベルで定義され、特定のタイプのすべてのコンポーネントで使用できます。

関連項目:
「テンプレート・オプションの理解」および「グローバル・テンプレート・オプションの管理」

13.1.7.2.9 アイコン

表13-7に、「アイコン」の属性を示します。

表13-7 アイコン

属性

説明

ライブラリ

Oracle Application Expressでページが表示されるときにロードするアイコン・ライブラリを選択します。ライブラリ内のアイコンは、ページ・デザイナ内に実装されるリージョンおよびボタン・アイコンCSSクラスのピッカーにも表示されます。

カスタム・ライブラリ・ファイルURL

すべてのページにロードするカスタム・アイコンのカスケード・スタイルシートのファイルURLを入力します。各URLを新しい行に記述する必要があります。ファイルの縮小バージョンを指定する場合、置換文字列#MIN#を使用して.minを、または#MIN_DIRECTORY#使用してminified/を通常ページ・ビューのファイルURLに含めたり、ページをデバッグ・モードで表示する場合は空の文字列を含めることができます。アプリケーションのバージョンをファイルURLに含める場合は、置換文字列#APP_VERSION#を使用することもできます。ここに入力したファイルURLによって、ページ・テンプレート内の#THEME_CSS#置換文字列が置き換えられます。

例を表示するには、フィールドレベル・ヘルプを参照してください。

カスタム・クラス

ページ・デザイナ内に実装されるリージョンおよびボタン・アイコンCSSクラスのピッカーに表示される、CSSクラス名のカンマ区切りリストを指定します。

カスタム接頭辞クラス

リージョン、ボタンおよびリストに対して定義されたアイコンCSSクラスがアイコン・ライブラリのクラスを使用していない場合に、それらの前に実行時に付けるCSSクラスを指定します。

日付ピッカー・アイコン名

タイプ「日付ピッカー」のアイテムが表示される場合に使用されるイメージの名前および場所を入力します。次に例を示します。

#IMAGE_PREFIX#new_cal.bmp

日付ピッカー・アイコン属性

カレンダ・アイコンのイメージ属性を入力します。次に例を示します。

width="16" height="16" alt="Display Calendar"

13.1.7.2.10 イメージ

「カスタム・イメージ」属性を使用して、このテーマがデフォルトのテーマ・イメージを使用するかアップロードされたテーマ・イメージを使用するかを指定します。「はい」または「いいえ」を選択します。

13.1.7.2.11 スタイル

現在のテーマで使用できるテーマ・スタイルを表示します。テーマ・スタイルによって、アプリケーションのテーマのCSSが定義され、アプリケーションのユーザー・インタフェースが制御されます。テーマ・スタイルは、ページ・テンプレート内で#THEME_STYLE_CSS#置換文字列を使用して参照されます。現在使用されているテーマ・スタイルには、「カレント」の下にチェック・マークが表示されます。

13.1.7.2.12 ファイル

「ファイルの接頭辞」属性には、Webサーバーがテーマのファイルを指すために使用する仮想パスが表示されます。データベースのテーマ定義とともに格納されたファイルを参照するものを指定しないでください。パフォーマンスの点から、テーマ・ファイルをWebサーバーに格納することもできます。「スタイル」で参照するには、#IMAGE_PREFIX#または有効なURLを使用します。

13.2 テーマおよびサブスクリプションの管理

この項では、開発者がテーマおよびテーマのサブスクリプションを管理する方法について説明します。

- テーマのサブスクリプションの理解

- テーマの作成

- テーマの切替え

- テーマ識別番号の変更

- テーマのコピー

- テーマの削除

- マスター・テーマ・アプリケーションの作成

- ワークスペース・テーマの管理

- インスタンス・テーマの管理

- テーマのエクスポートおよびインポートについて

- テーマ・レポートの表示

13.2.1 テーマのサブスクリプションの理解

この項では、テーマのサブスクリプションについて説明します。

- テーマのサブスクリプションについて

- テーマのサブスクリプションの変更について

- テーマのリフレッシュが必要かどうかの検証

- サブスクライブされたテーマのリフレッシュ

- テーマのサブスクライブ解除

- テーマの再サブスクライブ

13.2.1.1 テーマのサブスクリプションについて

開発者は、次の場合にテーマをサブスクライブします。

- アプリケーションの作成ウィザードを実行するとき。
開発者が、アプリケーションの作成ウィザードを実行するときに組込みテーマを選択すると、そのテーマが自動的にマスター・テーマにサブスクライブされます。組込みテーマを使用するかわりとして、アプリケーションの作成ウィザードには既存のアプリケーションからテーマをコピーするオプションが用意されています。既存のアプリケーションからテーマをコピーするとき、開発者は、そのテーマがサブスクライブされるようにするかどうかを選択できます。「アプリケーションの作成ウィザードの使用」を参照してください。

- テーマ・リポジトリから新しいテーマを作成するとき。新しいテーマを作成すると、関連するアプリケーションによって自動的にそのテーマがサブスクライブされます。「テーマの作成」を参照してください。

アプリケーションがマスター・テーマをサブスクライブすると、すべてのテーマ属性、サブスクライブされたテンプレート・オプションおよびサブスクライブされたテンプレートが読取り専用に設定されます。つまり、変更できるのはデフォルト・テンプレートのみだということです。マスター・テーマをサブスクライブすることの利点は、将来のOracle Application Expressのリリース時にテーマをアップグレードできることです。テーマがサブスクライブされた場合、開発者はテーマまたはテンプレート・メタデータにテーマまたはテンプレート編集ページからアクセスするときに、それらを変更できません。

13.2.1.2 テーマのサブスクリプションの変更について

マスター・テーマのサブスクリプションを解除しないでテンプレートを変更するために、開発者は自分のワークスペースにテンプレートのローカル・コピーを作成できます。ローカル・テンプレート・コピーはサブスクライブされないため、編集可能です。テーマ・スタイルについても同じ方法を利用できます。テーマ・スタイルのローカル・コピーを作成して、それをサブスクライブされたテーマに追加できます。ローカルで作成されたテーマ・スタイルは編集可能ですが、テーマのリフレッシュからは除外されます。

関連項目:
「テーマのコピー」

13.2.1.3 テーマのリフレッシュが必要かどうかの検証

テーマのサブスクリプションの検証ウィザードは、サブスクライブするテーマのすべてのテーマ属性、テンプレートおよびテンプレート・オプションを確認し、マスター・テーマと同期が取れていない対象にはエラーを表示します。また、マスター・テーマに定義されているが、サブスクライブするテーマにまだパブリッシュされていないテンプレートをハイライトします。

テーマのサブスクリプションの検証ウィザードを実行するには、次のステップを実行します。

1. テーマ・ページにナビゲートします。「テーマ・ページへのアクセス」を参照してください。

2. テーマを選択します。
テーマの作成/編集ページが表示されます。

3. テーマのサブスクリプションを見つけ、「確認」をクリックします。

4. 画面に表示されるステップに従います。
マスター・テーマからサブスクライブするテーマに変更をパブリッシュするには、ウィザードの最後で「リフレッシュ」をクリックします。

13.2.1.4 サブスクライブされたテーマのリフレッシュ

サブスクライブされたテーマをリフレッシュするには、次のステップを実行します。

1. テーマ・ページにナビゲートします。「テーマ・ページへのアクセス」を参照してください。

2. テーマを選択します。
テーマの作成/編集ページが表示されます。

3. テーマのサブスクリプションを見つけ、「テーマのリフレッシュ」をクリックします。

ヒント:
テーマがサブスクライブされていない場合、「テーマのリフレッシュ」ボタンは表示されません。「テーマの再サブスクライブ」を参照してください。

4. 「変更の適用」をクリックします。

13.2.1.5 テーマのサブスクライブ解除

注意:
テーマをサブスクライブ解除すると、それ以降テーマが更新されなくなります。テーマの再サブスクライブは、テーマのコピーや切替えを含む複数ステップのプロセスであることに注意してください。詳細は、「テーマの再サブスクライブ」を参照してください。

テーマをサブスクライブ解除すると、そのテーマに含まれるすべてのテンプレート、スタイル、ファイルなどもサブスクライブ解除されます。

テーマをサブスクライブ解除するには、次のステップを実行します。

1. テーマ・ページにナビゲートします。「テーマ・ページへのアクセス」を参照してください。

2. テーマを選択します。
テーマの作成/編集ページが表示されます。

3. テーマのサブスクリプションを見つけ、「サブスクライブ解除」をクリックします。
警告ダイアログが表示されます。

4. 「テーマのサブスクライブ解除」をクリックします。

13.2.1.6 テーマの再サブスクライブ

テーマを再サブスクライブするには、次のステップを実行します。

1. テーマ・ページにナビゲートします。「テーマ・ページへのアクセス」を参照してください。

2. 「指定番号の変更」をクリックし、テーマを新しい識別番号に変更します。「テーマ識別番号の変更」を参照してください。

3. テーマの作成ウィザードを実行し、再度テーマを作成します。「テーマの作成」を参照してください。

4. 新しいテーマを使用するように、カレント・アプリケーションを切り替えます。「テーマの切替え」を参照してください。

5. 新しい識別番号を作成した元のテーマを削除します。「テーマの削除」を参照してください。

13.2.2 テーマの作成

現在アプリケーションに関連付けられているテーマのみがテーマ・ページに表示されます。他のテーマにアクセスするには、テーマの作成ウィザードを実行する必要があります。テーマを作成すると、テーマ・ページでそのテーマにアクセスできるようになります。新しく作成するか、またはリポジトリから既存のテーマを選択することによって、テーマを作成できます。

ヒント:
新しいテーマを作成すると、関連するアプリケーションによって自動的にそのテーマがサブスクライブされます。「テーマおよびサブスクリプションの管理」を参照してください。

テーマを作成するには、次のステップを実行します。

1. テーマ・ページにナビゲートします。「テーマ・ページへのアクセス」を参照してください。

2. 「作成」をクリックします。

3. 次のいずれかの作成方法を選択します。

- リポジトリから: リポジトリからテーマを表示および選択します。

- 別のアプリケーションからのコピー: アプリケーションを選択してからテーマを選択します。

- 最初から: テーマを最初から作成します。

- エクスポートから: エクスポート・リポジトリからインポートするテーマを作成します。

4. 画面に表示されるステップに従います。
属性の詳細は、フィールドレベル・ヘルプを参照してください。「フィールドレベル・ヘルプの表示」を参照してください。

関連項目:
「テーマの編集」

13.2.3 テーマの切替え

この項では、アプリケーションのアクティブなテーマを変更する方法について説明します。

- アクティブなテーマの切替えについて

- ユニバーサル・テーマへの切替えについて

- アクティブなテーマの切替え

13.2.3.1 アクティブなテーマの切替えについて

テーマに切り替えると、テンプレートに割り当てられたすべてのコンポーネントは、テーマの対応するテンプレートに割り当てられます。アプリケーション・ビルダーは、テンプレート・クラス識別子の割当てによってテンプレート・マッピングを行います。

アクティブなテーマの切替えでは、次の点に注意してください。

- テーマが存在する場合にのみ、そのテーマに切り替えることができます。たとえば、リポジトリで使用可能なテーマに切り替える前に、最初にテーマを作成する必要があります。「テーマの作成」を参照してください。

- ウィザードによって複数の一致が検出された場合(つまり、複数のテンプレートが同じテンプレート・タイプおよびテンプレート・クラスを共有する場合)、ウィザードのデフォルトで、タイプ、クラスおよび名前が一致するテンプレートになります。一致するものが検出されなかった場合、同じタイプおよびクラスの別のテンプレートを選択する必要があります。

- 一致するテンプレートが見つからなかった場合(つまり、同じタイプおよびクラスのテンプレートが存在しない場合)、同じタイプでクラスが異なるテンプレートを選択するよう求められます。次に、この問題がページ機能の問題またはページの表示の問題の原因になる場合があることを説明する警告が表示されます。同じテンプレート・タイプのテンプレートが存在しない場合、テーマを切り替えることはできません。テーマの切替えがブロックされます。

13.2.3.2 ユニバーサル・テーマへの切替えについて

Oracle Application Expressの以前のリリースで提供されていたテーマと比べて、ユニバーサル・テーマにはいくつかの新機能が追加され、改善および最適化が行われています。さらに、ユニバーサル・テーマではOracle Application Expressリリース5の主要なUI機能のいくつかを利用し、アプリケーションのUIをカスタマイズする機能を大幅に拡張する新しいテンプレートおよびテンプレート・オプションが複数提供されています。ユニバーサル・テーマの利点の詳細およびユニバーサル・テーマへの切替え方法は、『移行ガイド - ユニバーサル・テーマへの移行』を参照してください。

https://apex.oracle.com/ut

13.2.3.3 アクティブなテーマの切替え

アクティブなテーマを切り替えるには、次の手順を実行します。

1. テーマ・ページにナビゲートします。「テーマ・ページへのアクセス」を参照してください。

ヒント:
インストール済のテーマが2つ以上存在しない場合は、「テーマの作成」をクリックします。テーマを最初から作成するか、単にリポジトリから既存のテーマを選択できます。「テーマの作成」を参照してください。

2. 「テーマの切替え」をクリックします。
テーマの切替えページが表示されます。

3. 「テーマの指定」で、次のステップを実行します。

1. 現在アクティブなテーマ: アプリケーションの現在のテーマを選択します。

2. 次のテーマに切替え: アプリケーションに新しいテーマを選択します。

3. グリッドのリセット: グリッドをリセットするかどうかを選択します。グリッド設定は、ページ上でのリージョンおよびアイテムの配置を定義します。詳細は、フィールドレベル・ヘルプを参照してください。「グリッドベース・テーマについて」を参照してください。

4. テンプレート・クラスの照合: 「はい」または「いいえ」を選択します。新しいテーマに切り替えると、アプリケーション・ビルダーによって、現在使用されているすべてのテンプレートが、テンプレート・クラスを使用している新しいテーマ内のテンプレートにマップされます。「テンプレート・クラスの照合」が「いいえ」に設定されている場合、テンプレートをテンプレート・クラスには関係なく、同じタイプのテンプレートに切り替えることができます。

5. 「次へ」をクリックします。

互換性の確認ページが表示されます。

4. 「ステータス」列を確認し、マッピング上の問題を特定します。

- チェック: マッピングが成功したことを示します。

- 警告: 切替え先のテーマに、指定されたクラスを持つ複数のテンプレートがあることを示します。この警告では、適切なテンプレートを選択するための選択リストが提供されます。

- エラー: アプリケーション・ビルダーがテーマ間でクラスをマップできなかったことを示します。クラスが両方のテーマのテンプレートで指定されていることを確認します。

注意:
この警告の解決に失敗すると、機能が消失したり、アプリケーションが正常に表示されなくなる場合があります。

5. 「次へ」をクリックして続行します。

6. 「テーマの切替え」をクリックします。

13.2.4 テーマ識別番号の変更

すべてのテーマには、識別番号(ID)があります。テーマIDの変更ユーティリティを使用して、テーマIDを別の識別番号に変更できます。テーマIDの変更は、テーマに異なる番号を付けてエクスポートし、別のアプリケーションにインポートする場合に便利です。

テーマ識別番号を変更するには、次のステップを実行します。

1. テーマ・ページにナビゲートします。「テーマ・ページへのアクセス」を参照してください。

2. 「タスク」リストで、「指定番号の変更」をクリックします。

3. テーマ番号の場合は、次のステップを実行します。

1. テーマの指定: テーマを選択します。

2. 新しいテーマ指定番号: 識別番号を指定します。

3. 「次へ」をクリックします。

4. 変更内容を確認して、「テーマIDの変更」をクリックします。

13.2.5 テーマのコピー

すべてのテーマは、数値による識別番号(ID)で識別されます。テーマをコピーする場合は、テーマIDを指定します。テーマのコピーは、テーマの編集を試行したり、テーマに異なるIDを付けてエクスポートする場合に便利です。

テーマをコピーするには、次のステップを実行します。

1. テーマ・ページにナビゲートします。「テーマ・ページへのアクセス」を参照してください。

2. 「タスク」リストで、「テーマのコピー」をクリックします。

3. 「テーマのコピー」で、次のステップを実行します。

1. 次のテーマからコピー: コピーするテーマを選択します。

2. このテーマIDにコピー - テーマの新しいIDを入力します。

3. テーマのサブスクライブ - 「はい」または「いいえ」を選択します。

4. 「次へ」をクリックします。

4. 「テーマのコピー」をクリックします。

13.2.6 テーマの削除

アクティブではないテーマのみ削除できます。テーマを削除すると、アプリケーション・ビルダーによって、アクティブではないテンプレートのみ削除されます。

ヒント:
テーマはアプリケーションに関連付けられています。テーマを変更した場合、その変更は編集中のアプリケーションにのみ適用されます。テーマを削除した場合、テンプレートの変更はすべて失われます。テンプレートの変更を維持するには、テーマをエクスポートする必要があります。「テーマのエクスポート」を参照してください。

テーマを削除するには、次のステップを実行します。

1. テーマ・ページにナビゲートします。「テーマ・ページへのアクセス」を参照してください。

2. 「タスク」リストで、「テーマの削除」をクリックします。

3. 「テーマの削除」で、削除するテーマを選択し、「次へ」をクリックします。

4. 「テーマの削除」をクリックします。

13.2.7 マスター・テーマ・アプリケーションの作成

この項では、マスター・テーマ・アプリケーションの作成方法について説明します。ベスト・プラクティスとして、ユニバーサル・テーマ- 42を使用する既存のパッケージ・アプリケーション(たとえば、サンプル・データベース・アプリケーション)から始めることをお薦めします。

- 新規アプリケーションの作成によるマスター・テーマ・アプリケーションの作成

- 既存のアプリケーションからのマスター・テーマ・アプリケーションの作成

13.2.7.1 新規アプリケーションの作成によるマスター・テーマ・アプリケーションの作成

新規アプリケーションを作成してマスター・テーマ・アプリケーションを作成するには、次のステップを実行します。

1. アプリケーションの作成ウィザードを実行して、新規アプリケーションを作成します。「アプリケーションの作成ウィザードの使用」を参照してください。

2. 既存のアプリケーションからコピーを選択し、ユニバーサル・テーマ- 42を使用するアプリケーション(たとえば、サンプル・データベース・アプリケーション)を選択します。

3. 画面に表示されるステップに従います。

13.2.7.2 既存のアプリケーションからのマスター・テーマ・アプリケーションの作成

既存のアプリケーションからマスター・テーマ・アプリケーションを作成するには、次のステップを実行します。

1. ユニバーサル・テーマ- 42を使用するアプリケーション(たとえば、サンプル・データベース・アプリケーション)からテーマをコピーし、そのテーマをサブスクライブします。「テーマのコピー」を参照してください。

2. 新しいテーマに切り替えます。「テーマの切替え」を参照してください。

3. 画面に表示されるステップに従います。

13.2.8 ワークスペース・テーマの管理

ワークスペース管理者は、ワークスペースのテーマ・リポジトリを管理します。ワークスペース管理者は、リポジトリにテーマを追加してワークスペース内のすべての開発者がそのテーマを使用できるようにしたり、テーマを削除することができます。

- テーマ・リポジトリへのワークスペース・テーマの追加

- 既存のワークスペース・テーマの表示

- ワークスペーステーマの削除

- ワークスペーステーマの変更

- ワークスペース・テーマのエクスポート

関連項目:
『Oracle Application Express管理ガイド』のパブリック・テーマの管理に関する項

13.2.8.1 テーマ・リポジトリへのワークスペース・テーマの追加

テーマをテーマ・リポジトリに追加するには、次のステップを実行します。

1. テーマ・ページにナビゲートします。「テーマ・ページへのアクセス」を参照してください。

2. 「タスク」から「ワークスペース・テーマの管理」をクリックします。

3. 「ワークスペース・テーマの作成」を選択し、「次へ」をクリックします。

ヒント:
ワークスペース・テーマが存在しない場合、ウィザードによって「作成」が選択されます。

4. 「ワークスペース・テーマの作成」で、次のステップを実行します。

1. アプリケーション - アプリケーションを選択します。

2. コピーするアプリケーション・テーマ: ワークスペース・テーマ・リポジトリにコピーするテーマを選択します。

3. 「次へ」をクリックします。

5. テーマの名前と番号を変更します。

1. テーマ番号 - ワークスペース内でこのテーマを一意に識別する、100より大きい値で番号を指定します。

2. テーマ名 - テーマ名を入力します。この名前は、アプリケーション・テーマ名と同じでも違っていてもかまいません。

3. 説明 - テーマの説明を入力します。

4. 「次へ」をクリックします。

6. 「ワークスペーステーマの作成」をクリックします。

13.2.8.2 既存のワークスペース・テーマの表示

既存のワークスペース・テーマを表示するには、次の手順を実行します。

1. テーマ・ページにナビゲートします。「テーマ・ページへのアクセス」を参照してください。

2. 「タスク」リストから「ワークスペーステーマの管理」をクリックします。
「ワークスペース・テーマ」ページが表示されます。

ヒント:
ワークスペーステーマを直接編集することはできません。ワークスペース・テーマを変更するには、そのテーマを使用してアプリケーションを作成し、変更し、ワークスペース・テーマ・リポジトリに手動で追加する必要があります。「ワークスペース・テーマの変更」を参照してください。

13.2.8.3 ワークスペース・テーマの削除

ワークスペーステーマを削除するには、次のステップを実行します。

1. テーマ・ページにナビゲートします。「テーマ・ページへのアクセス」を参照してください。

2. 「タスク」リストから「ワークスペーステーマの管理」をクリックします。
「ワークスペース・テーマ」ページが表示されます。

3. テーマ名を選択します。

4. 「削除」をクリックします。

5. 削除のリクエストを確認し、「OK」をクリックします。

13.2.8.4 ワークスペース・テーマの変更

ワークスペーステーマを直接編集することはできません。ワークスペース・テーマを変更するには、そのテーマを使用してアプリケーションを作成し、変更し、ワークスペース・テーマ・リポジトリに手動で追加する必要があります。

ワークスペーステーマを変更するには、次のステップを実行します。

1. 変更するテーマを使用して、アプリケーションを作成します。「データベース・アプリケーションの作成」を参照してください。

2. テーマを変更します。「テーマの編集」を参照してください。

3. 既存のワークスペーステーマを削除します。「ワークスペース・テーマの削除」を参照してください。

4. 変更したテーマをワークスペーステーマ・リポジトリに追加します。「テーマ・リポジトリへのワークスペース・テーマの追加」を参照してください。

13.2.8.5 ワークスペース・テーマのエクスポート

テーマのエクスポートは、関連するアプリケーション・ファイルのエクスポートと同様の方法で行います。ワークスペーステーマをエクスポートするには、次のステップを実行します。

1. テーマを使用して、アプリケーションを作成します。「データベース・アプリケーションの作成」を参照してください。

2. アプリケーションをエクスポートします。「アプリケーションのエクスポート」を参照してください。

3. エクスポートされたファイルをターゲットのOracle Application Expressインスタンスにインポートします。「アプリケーション、ページまたはコンポーネントのエクスポートのインポート」を参照してください。

4. エクスポートされたファイルをエクスポート・リポジトリからインストールします。「エクスポート・ファイルのインストール」を参照してください。

13.2.9 インスタンス・テーマの管理

Oracle Application Expressインスタンス全体のテーマ・リポジトリは、インスタンス管理者が管理します。リポジトリに対してテーマを追加または削除できるのは、インスタンス管理者のみです。詳細は、『Oracle Application Express管理ガイド』のパブリック・テーマの管理に関する項を参照してください。

13.2.10 テーマのエクスポートおよびインポートについて

テーマのエクスポートは、関連するアプリケーション・ファイルのエクスポートと同様の方法で行います。1つの開発インスタンスから別のインスタンスへテーマをエクスポートするには、次のステップを実行します。

1. テーマを使用して、アプリケーションを作成します。「データベース・アプリケーションの作成」を参照してください。

2. テーマをエクスポートします。「テーマのエクスポート」を参照してください。

3. エクスポートされたファイルをターゲットのOracle Application Expressインスタンスにインポートします。「エクスポート・ファイルのインポート」を参照してください。

4. エクスポートされたファイルをエクスポート・リポジトリからインストールします。「エクスポート・ファイルのインストール」を参照してください。

13.2.11 テーマ・レポートの表示

この項では、テーマおよびテンプレートの管理に役立ついくつかのレポートについて説明します。

- テーマのすべてのテンプレートの表示

- テーマ・テンプレート数の表示

- ファイル参照の表示

- クラス参照の表示

- テンプレートの置換文字列の表示

13.2.11.1 テーマのすべてのテンプレートの表示

テーマを構成しているすべてのテンプレートを表示するには、次のステップを実行します。

1. テーマ・ページにナビゲートします。「テーマ・ページへのアクセス」を参照してください。

2. 「レポート」をクリックします。

3. テーマ・レポート・ページで、次のステップを実行します。

1. レポート - 「アプリケーション・テンプレート」を選択します。

2. テーマ - テーマを選択するか、「すべてのテーマ」を選択します。

3. 「実行」をクリックします。

テンプレートのリストには、テンプレート・タイプ、テンプレート名、対応するテーマおよびテンプレート・クラスの一覧が表示されます。

4. テンプレートを編集するには、テンプレート名を選択します。

13.2.11.2 テーマ・テンプレート数の表示

「テーマ・テンプレート数」レポートには、現在、テンプレート・クラス用に作成されたテンプレートがあるテンプレート・クラスが表示されます。

テーマ・テンプレート数レポートを表示するには、次のステップを実行します。

1. テーマ・ページにナビゲートします。「テーマ・ページへのアクセス」を参照してください。

2. 「レポート」をクリックします。

3. テーマ・レポート・ページで、次のステップを実行します。

1. レポート - 「テーマ・テンプレート数」を選択します。

2. テーマ - テーマを選択するか、「すべてのテーマ」を選択します。

3. 「実行」をクリックします。

4. カスタムの分類を使用する場合は、「カスタムの表示」を選択し、「実行」をクリックします。

13.2.11.3 ファイル参照の表示

ファイル参照のレポートには、テンプレートに関連付けられたすべてのファイル、共有コンポーネント、カレント・アプリケーションのページ・コンポーネントの一覧が表示されます。

「ファイル参照」のレポートを表示するには、次のステップを実行します。

1. テーマ・ページにナビゲートします。「テーマ・ページへのアクセス」を参照してください。

2. テーマ・ページで「レポート」をクリックします。

3. テーマ・レポート・ページで、次のステップを実行します。

1. レポート - 「ファイル参照」を選択します。

2. テーマ - テーマを選択するか、「すべてのテーマ」を選択します。

3. 「実行」をクリックします。

4. 「ファイル参照」ページで、次のステップを実行します。

1. 表示 - レポートに含めるコンポーネントのタイプを選択します。選択しない場合は、結果が戻されません。

2. ファイルの表示 - 次のいずれかを選択します。

- コンテキスト付き: コンポーネント、テーマ識別番号、コンポーネント名、イメージ(使用可能な場合)、およびページ番号を表示します。ページ番号を選択します。

- コンテキストなし: ファイル名およびイメージ(使用可能な場合)のみ表示します。

3. ファイル拡張子 - 検索する拡張子のタイプを選択します。

4. 「実行」をクリックします。

5. このレポートのカンマ区切りファイル(.csv)をダウンロードするには、ページ下部の「ダウンロード」をクリックします。

13.2.11.4 クラス参照の表示

クラス参照のレポートにアクセスすると、テンプレートに関連付けられたクラス、共有コンポーネント、カレント・アプリケーションのページ・コンポーネントの一覧が表示されます。

クラス参照のレポートを表示するには、次のステップを実行します。

1. テーマ・ページにナビゲートします。「テーマ・ページへのアクセス」を参照してください。

2. 「レポート」をクリックします。

3. テーマ・レポート・ページで、次のステップを実行します。

1. レポート - 「クラス参照」を選択します。

2. テーマ - テーマを選択するか、「すべてのテーマ」を選択します。

3. 「実行」をクリックします。

4. 「クラス参照」ページで、次のステップを実行します。

1. 表示 - クラス参照を確認するコンポーネントを選択します。選択しない場合は、結果が戻されません。

2. クラス名の表示 - 次のいずれかを選択します。

- コンテキスト付き: コンポーネント、テーマ識別番号、コンポーネント名、イメージ(使用可能な場合)、およびページ番号を表示します。

- コンテキストなし: 参照されるクラスのみを表示します。

3. 「実行」をクリックします。

5. このレポートのカンマ区切りファイル(.csv)をダウンロードするには、ページ下部の「ダウンロード」をクリックします。

13.2.11.5 テンプレート置換文字列の表示

「テンプレート置換文字列」レポートを使用すると、コンポーネントがサポートする置換文字列がすべて表示されます。

「置換文字列」レポートを表示するには、次のステップを実行します。

1. テーマ・ページにナビゲートします。「テーマ・ページへのアクセス」を参照してください。

2. 「レポート」をクリックします。

3. テーマ・レポート・ページで、次のステップを実行します。

1. 「レポート」リスト- 「テンプレート置換文字列」を選択します。

2. 「テーマ」リスト - レポートに含めるテーマを選択します。

3. 「実行」をクリックします。

4. テンプレート定義にリンクするには、コンポーネント名を選択します。

関連項目:
「置換文字列の理解」

13.3 カスタム・テーマの作成

Application Expressエンジンは、テーマと呼ばれるテンプレートのコレクションに基づいて、アプリケーションのユーザー・インタフェースを作成します。テンプレートは、アプリケーション内のコンポーネントのルック・アンド・フィールを制御します。カスタム・テンプレートを作成するには、まず既存のテンプレートを変更する方法が最も簡単です。作成した1つ以上のデフォルト・テンプレートは、必要に応じて変更できます。

- カスケード・スタイルシートについて

- ページ・テンプレートからのJavaScriptファイルのコールについて

- 置換文字列でのエスケープ構文の使用について

- デフォルトのページ・テンプレートの選択

- 新しいテンプレートの作成

- テンプレート・レポートの表示

- テンプレートの管理

- ブレッドクラム・テンプレート

- ボタン・テンプレート

- レガシー・カレンダ・テンプレート

- ラベル・テンプレート

- リスト・テンプレート

- ページ・テンプレート

- ポップアップLOVテンプレート

- リージョン・テンプレート

- レポート・テンプレート

関連項目:
「テーマの使用」および「テーマおよびサブスクリプションの管理」

13.3.1 カスケード・スタイルシートについて

カスケード・スタイルシート(CSS)によって、構造を変更せずにWebページのスタイルを制御できます。CSSを適切に使用すると、カラー、余白、フォントなどの視覚属性がHTMLドキュメントの構造から切り離されます。Oracle Application Expressのテーマには、独自のCSSを参照するテンプレートを含めることができます。特定のテーマの各CSSで定義されたスタイル・ルールによって、レポートおよびリージョンの表示も指定されます。

組込みのテーマを使用する場合、テーマ固有のCSSファイルは次の場所にあります。

/i/themes/theme_xx
/i/themes/theme_xx/css

テーマ固有のイメージは次の場所にあります。

/i/themes/theme_xx
/i/themes/theme_xx/images

xxはテーマ番号です。テーマ固有のCSSファイルにはOracle Application Expressのバージョン番号が含まれており、以前のバージョンのテーマを使用しているアプリケーションをインポートした場合の下位互換性が維持されるようになっています。

関連項目:
「カスタム・カスケード・スタイルシートの使用」

13.3.2 ページ・テンプレートからのJavaScriptファイルのコールについて

Oracle Application Expressではページ・テンプレートで.jsファイルを参照できます。このアプローチによって、そのファイル内のすべてのJavaScriptがアプリケーションにアクセス可能になります。.jsファイルはアプリケーションの最初のページ・ビューにロードされてからブラウザでキャッシュされるため、これは最も効率的なアプローチです。

関連項目:
「JavaScript」

13.3.3 置換文字列でのエスケープ構文の使用について

開発者は、先頭に感嘆符(!)の付いた事前定義済のフィルタ名を置換文字列に追加することで、置換値の特殊文字をエスケープできます。出力のエスケープは、ブラウザでクロス・サイト・スクリプティング(XSS)攻撃を回避するための重要なセキュリティ手法です。

関連項目:
「置換文字列での出力のエスケープの制御」

13.3.4 デフォルトのページ・テンプレートの選択

この項では、デフォルト・ページ・テンプレートの選択方法について説明します。デフォルトのページ・テンプレートは、2つの方法で指定できます。

- 特定のテーマ内のデフォルトのページ・テンプレートを選択します。

- ページごとに特定のページ・テンプレートを選択します。

デフォルトでは、Application Expressエンジンは、テーマ・ページで指定されたページ・テンプレートを使用します。

- テーマ内のページ・レベル・テンプレートの選択

- 特定のページのページ・レベル・テンプレートの選択

13.3.4.1 テーマ内のページ・レベル・テンプレートの選択

テーマ内のデフォルトのページ・テンプレートを指定するには、次のステップを実行します。

1. テーマ・ページにナビゲートします。「テーマ・ページへのアクセス」を参照してください。

2. テーマ名を選択します。
テーマの作成/編集ページが表示されます。

3. 「コンポーネントのデフォルト値」までスクロールします。

4. 「ページ」から、新しい選択を行います。

5. ページ上部の「変更の適用」をクリックします。

関連項目:
「テーマの編集」

13.3.4.2 特定のページのページ・レベル・テンプレートの選択

特定のページにページ・レベル・テンプレートを指定するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. ページを選択します。
ページが表示されます。

4. 「ページ・デザイナ」でページ・レベル・テンプレートを編集するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。「ページ・デザイナでのページの表示」を参照してください。
「ページ・レンダリング」ツリーで、ページ・タイトルをクリックします。

2. プロパティ・エディタで「外観」セクションを見つけます。

3. 「外観」、「ページ・テンプレート」で、新しいテンプレートを選択します。

4. 「保存」をクリックします。

5. 「コンポーネント・ビュー」でページ・レベル・テンプレートを編集するには、次のステップを実行します。

1. 適切なページにナビゲートします。「コンポーネント・ビューでのページの表示」を参照してください。

2. 「ページ」で、「編集」アイコンをクリックします。
編集ページが表示されます。

3. 表示の外観、「ページ・テンプレート」で、新しいテンプレートを選択します。

4. 「変更の適用」をクリックします。

13.3.5 新しいテンプレートの作成

カスタム・テンプレートを作成するには、まず既存のテンプレートをコピーし、それを変更する必要があります。作成した1つ以上のデフォルト・テンプレートは、必要に応じて変更できます。

カスタム・テンプレートを作成するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. テンプレートをコピーするアプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「ユーザー・インタフェース」で、「テンプレート」を選択します。

5. 「作成」をクリックします。

6. 作成するテンプレートのタイプを選択し、「次へ」をクリックします。

7. 次のいずれかの作成方法を選択します。

- 最初から

- 既存のテンプレートのコピーとして

8. 画面に表示されるステップに従います。

ヒント:
テンプレートが適切なテーマに関連付けられていることを確認します。

13.3.6 テンプレート・オプションの使用

開発者はテンプレート・オプションを使用して、宣言的な方法でOracle Application Expressのページ上のコンポーネントに様々なスタイルを適用できます。

- グローバル・テンプレート・オプション・グループの管理

- グローバル・テンプレート・オプションの管理

- テンプレート・オプションの管理

関連項目:
「テンプレート・オプションの理解」

13.3.6.1 グローバル・テンプレート・オプション・グループの管理

グローバル・テンプレート・オプション・グループはテーマレベルで定義され、特定のタイプのコンポーネントすべてで使用できます。この項では、グローバル・テンプレート・オプション・グループを作成および編集する方法について説明します。

- グローバル・テンプレート・オプション・グループの作成

- グローバル・テンプレート・オプション・グループの編集

関連項目:
「テンプレート・オプション・グループおよび事前設定について」および「テンプレート・オプションの理解」

13.3.6.1.1 グローバル・テンプレート・オプション・グループの作成

グローバル・テンプレート・オプション・グループを作成するには、次のステップを実行します。

1. テーマ・ページにナビゲートします。「テーマ・ページへのアクセス」を参照してください。

2. テーマを選択します。
テーマの作成/編集ページが表示されます。

3. 「グローバル・テンプレート・オプション」を選択します。

4. 「テンプレート・オプション・グループの編集」をクリックします。
「テンプレート・オプション・グループ」ダイアログが表示されます。

5. グループを作成するには:

1. 「作成」をクリックします。

2. 対象となる属性を編集します。
属性の詳細は、フィールドレベル・ヘルプを参照してください。

3. 「作成」をクリックします。

13.3.6.1.2 グローバル・テンプレート・オプション・グループの編集

グローバル・テンプレート・オプション・グループを編集するには、次のステップを実行します。

1. テーマ・ページにナビゲートします。「テーマ・ページへのアクセス」を参照してください。

2. テーマを選択します。
テーマの作成/編集ページが表示されます。

3. 「グローバル・テンプレート・オプション」を選択します。

4. 「テンプレート・オプション・グループの編集」をクリックします。
「テンプレート・オプション・グループ」ダイアログが表示されます。

5. グループを編集するには:

1. グループ名をクリックします。

2. 対象となる属性を編集します。

3. 「変更の適用」をクリックします。

6. 次の手順を実行して、グループを削除します。

1. グループ名をクリックします。

2. 「削除」をクリックします。

13.3.6.2 グローバル・テンプレート・オプションの管理

この項では、グローバル・テンプレート・オプションを作成および編集する方法について説明します。

- グローバル・テンプレート・オプションの作成

- グローバル・テンプレート・オプションの編集

関連項目:
「テンプレート・オプションについて」

13.3.6.2.1 グローバル・テンプレート・オプションの作成

グローバル・テンプレート・オプションを作成するには、次のステップを実行します。

1. テーマ・ページにナビゲートします。「テーマ・ページへのアクセス」を参照してください。

2. テーマを選択します。
テーマの作成/編集ページが表示されます。

3. 「グローバル・テンプレート・オプション」を選択します。

4. 「テンプレート・オプションの追加」をクリックします。

5. 「テンプレート・オプション」で、次のステップを実行します。

1. 表示順序 - このオプションの順序を指定します。

2. テンプレート・タイプ - テンプレート・オプションを定義するテンプレートのタイプを選択します。

3. グループ - 一意のグループ名を入力します。グループ名によってテンプレート・オプションをグループ化し、競合するオプションが選択されないようにすることができます。
表示名 - テンプレート・オプションの名前を入力します。

4. オプション識別子 - テンプレート・オプションの識別子を大文字の英数字で入力します。識別子によって、テーマを切り替えるときにテンプレート・オプションが対応するテンプレート・オプションにマップされます。
CSSクラス - このテンプレート・オプションを定義する1つ以上のCSSクラスを入力します。

ヘルプ・テキスト - テンプレート・オプションの説明を入力します。

「作成」または「作成後、別のものを追加」をクリックします。

13.3.6.2.2 グローバル・テンプレート・オプションの編集

グローバル・テンプレート・オプションを編集するには、次のステップを実行します。

1. テーマ・ページにナビゲートします。「テーマ・ページへのアクセス」を参照してください。

2. テーマを選択します。
テーマの作成/編集ページが表示されます。

3. 「グローバル・テンプレート・オプション」を選択します。

4. テンプレート・オプションを編集するには、次のステップを実行します。

1. 表示名をクリックします。

2. 対象となる属性を編集します。属性の詳細は、フィールドレベル・ヘルプを参照してください。

ヒント:
CSSクラスの名前を編集した場合は、そのCSSクラス名を参照するすべてのコンポーネントを手動で更新する必要があります。オプション識別子はマッピングのために必要なため、変更できません。

3. 「変更の適用」をクリックします。

5. テンプレート・オプションを削除するには、次のステップを実行します。

1. 表示名をクリックします。

2. 「削除」をクリックします。

13.3.6.3 テンプレート・オプションの管理

この項では、テンプレート・オプションを作成および編集する方法について説明します。

- テンプレート・オプションの作成

- テンプレート・オプションの編集

関連項目:
「テンプレート・オプションの理解」

13.3.6.3.1 テンプレート・オプションの作成

テンプレート・オプションを作成するには、次のステップを実行します。

1. テンプレート・ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「ユーザー・インタフェース」で、「テンプレート」を選択します。

2. テンプレートを選択します。

3. 「テンプレート・オプション」を選択します。

4. 「テンプレート・オプションの追加」をクリックします。

5. 対象となる属性を編集します。
属性の詳細は、フィールドレベル・ヘルプを参照してください。

6. 「作成」または「作成後、別のものを追加」をクリックします。

13.3.6.3.2 テンプレート・オプションの編集

テンプレート・オプションを編集するには、次のステップを実行します。

1. テンプレート・ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「ユーザー・インタフェース」で、「テンプレート」を選択します。

2. テンプレートを選択します。

3. 「テンプレート・オプション」を選択します。

4. 該当する属性を編集し、「変更の適用」をクリックします。
属性の詳細は、フィールドレベル・ヘルプを参照してください。

ヒント:
CSSクラスの名前を編集した場合は、そのCSSクラス名を参照するすべてのコンポーネントを手動で更新する必要があります。オプション識別子はマッピングのために必要なため、変更できません。

5. テンプレート・オプションを削除するには、次のステップを実行します。

1. 「削除」をクリックします。

6. グローバル・テンプレート・オプションを表示するには、「グローバル・テンプレート・オプション」を展開します。

13.3.7 テンプレート・レポートの表示

アプリケーション・ビルダーには、テンプレートの使用状況、サブスクリプション、パブリッシュされたテンプレートおよび編集履歴を示すレポートがあります。

カレント・アプリケーションについてのテンプレート・レポートを表示するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「ユーザー・インタフェース」で、「テンプレート」を選択します。
テンプレート・ページは、対話モード・レポートとして表示されます。ビューをカスタマイズするには、ページ上部の検索バーを使用します。詳細は、「エンド・ユーザーとしての対話モード・レポートのカスタマイズ」を参照してください。

5. テンプレート・レポートを表示するには、次のタブをクリックします。

- サブスクリプション - アプリケーションでサブスクライブされたテンプレートを表示します。

- パブリッシュ - ワークスペースの他のテンプレートによってサブスクライブされたテンプレートを表示します。マスター・テンプレートの内容を、サブスクライブしているテンプレートにパブリッシュするには、パブリッシュする対象を選択して、「チェックした項目のパブリッシュ」をクリックします。

- 使用状況 - カレント・アプリケーションのすべてのテンプレート・タイプについてテンプレートの使用状況を表示します。「参照」列の数値は、特定のテンプレートを使用するページの合計数を示します。

- 履歴 - このアプリケーション内のページおよびリージョン・テンプレートの最近の変更を表示します。

13.3.8 テンプレートの管理

テンプレート・ページで、すべての使用可能なテンプレートを表示できます。また、特定のページに関連付けられているテンプレートにアクセスできます。

- テンプレート・ページでのテンプレートの表示

- 特定のページに関連付けられているテンプレートの表示

- テンプレートの置換

- アプリケーション内のすべてのテンプレートの置換

- ページ・テンプレート別のリージョン位置の使用状況の表示

- テンプレートのサブスクライブ解除

- テンプレートのパブリッシュ

関連項目:
「テーマのすべてのテンプレートの表示」

13.3.8.1 テンプレート・ページでのテンプレートの表示

既存のテンプレートを表示するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「ユーザー・インタフェース」で、「テンプレート」を選択します。
テンプレート・ページは、対話モード・レポートとして表示されます。ビューをカスタマイズするには、ページ上部の検索バーを使用します。詳細は、「エンド・ユーザーとしての対話モード・レポートのカスタマイズ」を参照してください。

5. テンプレート定義を表示または編集するには、テンプレート名をクリックします。
テンプレート定義が表示されます。

6. 対象となる属性を編集します。属性の詳細は、フィールドレベル・ヘルプを参照してください。「フィールドレベル・ヘルプの表示」を参照してください。
テンプレートを編集する場合、1つのウィンドウで変更を行い、テンプレート定義ページの右側で「ページに戻る」チェック・ボックスを選択することで、別のウィンドウでアプリケーションを実行できます。このチェック・ボックスを選択すると、「変更の適用」をクリックした後、現在編集中のページが維持されます。

7. 「変更の適用」をクリックします。

13.3.8.2 特定のページに関連付けられているテンプレートの表示

特定のページに関連付けられているテンプレートを表示するには、次のステップを実行します。

1. 適切なページにナビゲートします。「コンポーネント・ビューでのページの表示」を参照してください。
ページが表示されます。右端の列の「テンプレート」ヘッダーの下に、カレント・ページに関連付けられたテンプレートが表示されます。

2. テンプレート定義を表示または編集するには、テンプレート名をクリックします。
テンプレート定義が表示されます。

3. 対象となる属性を編集します。属性の詳細は、フィールドレベル・ヘルプを参照してください。「フィールドレベル・ヘルプの表示」を参照してください。
テンプレートを編集する場合、1つのウィンドウで変更を行い、テンプレート定義ページの右側で「ページに戻る」チェック・ボックスを選択することで、別のウィンドウでアプリケーションを実行できます。このチェック・ボックスを選択すると、「変更の適用」をクリックした後、現在編集中のページが維持されます。

4. 「変更の適用」をクリックします。

13.3.8.3 テンプレートの置換

テンプレートの置換ウィザードを使用してコンポーネントに関連付けられているテンプレートを更新できます。

コンポーネントに関連付けられているテンプレートを置換するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「ユーザー・インタフェース」で、「テンプレート」を選択します。
テンプレート・ページは、対話モード・レポートとして表示されます。ビューをカスタマイズするには、ページ上部の検索バーを使用します。詳細は、「エンド・ユーザーとしての対話モード・レポートのカスタマイズ」を参照してください。

5. 「タスク」リストから「テンプレートの置換」を選択します。

6. 「テンプレート・タイプ」からテンプレートを選択し、「次へ」をクリックします。

7. 「テンプレートの置換」で、次のステップを実行します。

1. 変更前: 変更するテンプレートを選択します。

2. 変更後: 変更後のテンプレートを選択します。

3. 「次へ」をクリックします。

8. 「終了」をクリックします。

13.3.8.4 アプリケーション内のすべてのテンプレートの置換

アプリケーション内のすべてのテンプレートを別のアプリケーションのテンプレートに置換するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「ユーザー・インタフェース」で、「テンプレート」を選択します。
テンプレート・ページは、対話モード・レポートとして表示されます。ビューをカスタマイズするには、ページ上部の検索バーを使用します。詳細は、「エンド・ユーザーとしての対話モード・レポートのカスタマイズ」を参照してください。

5. 「タスク」リストから「このアプリケーションのテンプレートを別のアプリケーションのテンプレートに置換。」を選択します。

6. 「テンプレートの置換」で、次のステップを実行します。

1. アプリケーションから置換: アプリケーションを選択します。

2. ユーザー・インタフェース: このアプリケーションを開発する対象のユーザー・インタフェースのタイプを選択します。

3. 「次へ」をクリックします。

7. 「テンプレートの置換」で、各コンポーネントの新しいテンプレートを選択し、「アクション」で次のいずれかを選択します。

- 置換: テンプレート定義をコピーします。

- 置換/サブスクライブ: テンプレートをコピーしてサブスクリプションを追加します。

8. 「テンプレートの置換」をクリックします。

13.3.8.5 ページ・テンプレート別のリージョン位置の使用状況の表示

ページ上のリージョンは、位置(表示ポイント)で構成されます。リージョンで使用可能な表示ポイントは、ページ・レベルのテンプレートによって決まります。

ページ・テンプレート別のリージョン位置の使用状況を表示するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「ユーザー・インタフェース」で、「テンプレート」を選択します。
テンプレート・ページは、対話モード・レポートとして表示されます。ビューをカスタマイズするには、ページ上部の検索バーを使用します。詳細は、「エンド・ユーザーとしての対話モード・レポートのカスタマイズ」を参照してください。

5. 「タスク」リストから「ページ・テンプレートのリージョン位置の使用状況の表示」を選択します。
「リージョン表示ポイントの使用状況」レポートが表示されます。

13.3.8.6 テンプレートのサブスクライブ解除

サブスクライブされるテンプレートとは、定義を別のテンプレートで管理されているテンプレート、つまり参照されるテンプレートです。アプリケーションで、サブスクライブされるテンプレートを使用している場合は、テンプレートのサブスクライブ解除ページでテンプレートのサブスクライブを解除できます。

テンプレートのサブスクライブを解除するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「ユーザー・インタフェース」で、「テンプレート」を選択します。
テンプレート・ページは、対話モード・レポートとして表示されます。ビューをカスタマイズするには、ページ上部の検索バーを使用します。詳細は、「エンド・ユーザーとしての対話モード・レポートのカスタマイズ」を参照してください。

5. 「タスク」リストから「テンプレートのサブスクライブ解除」を選択します。
テンプレートのサブスクライブ解除ページが表示されます。

6. 現行のテーマ内で特定のテンプレート・タイプをサブスクライブ解除するには、テンプレート・タイプを選択し、「サブスクライブ解除」をクリックします。

13.3.8.7 テンプレートのパブリッシュ

テンプレートのパブリッシュ・ページを使用して、ワークスペースの他のテンプレートによってサブスクライブされるテンプレートを表示します。

マスター・テンプレートの内容を、サブスクライブしているテンプレートにパブリッシュするには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「ユーザー・インタフェース」で、「テンプレート」を選択します。
テンプレート・ページは、対話モード・レポートとして表示されます。ビューをカスタマイズするには、ページ上部の検索バーを使用します。詳細は、「エンド・ユーザーとしての対話モード・レポートのカスタマイズ」を参照してください。

5. 「パブリッシュ」タブをクリックします。
テンプレートのパブリッシュ・ページが表示されます。

6. パブリッシュするテンプレートを選択し、「チェックした項目のパブリッシュ」をクリックします。

13.3.9 ブレッドクラム・テンプレート

ブレッドクラム・テンプレートは、ブレッドクラム・エントリの表示方法を制御します。このテンプレートは、リージョンの作成時に選択します。

- ブレッドクラム・スタイルのナビゲーションについて

- ブレッドクラム・テンプレート属性

関連項目:
「テーマの使用」

13.3.9.1 ブレッドクラム・スタイルのナビゲーションについて

ブレッドクラムは通常、現在のページが、アプリケーション内の他のページに対してどの位置にあるかを示します。また、ユーザーは特定のページをクリックするだけで、そのページを表示することができます。たとえば、Oracle Application Expressのサンプル・データベース・アプリケーションでは、Administrationページの上部にブレッドクラム・メニューが表示されます。

関連項目:
「ブレッドクラムの作成」

13.3.9.2 ブレッドクラム・テンプレート属性

ブレッドクラム・テンプレートは、ブレッドクラム・リージョン・タイプの表示方法を制御します。このテンプレートは、リージョンの作成時に選択します。特定の属性の詳細は、フィールドレベル・ヘルプを参照してください。

13.3.9.2.1 名前

「名前」は、テンプレートの名前を示します。テンプレートに翻訳が必要なテキスト文字列が含まれていることを示すには、「翻訳可能」チェック・ボックスを使用します。「テーマ」は、テンプレートが関連付けられているテーマを示します。「テンプレート・クラス」は、そのテンプレートに固有の用途を示します。テーマに切り替えると、あるテーマのすべてのテンプレートは、別のテーマの対応するテンプレートにマップされます。アプリケーション・ビルダーは、テンプレート・クラスの割当てによってこのテンプレート・マッピングを行います。

13.3.9.2.2 定義

定義属性は、ブレッドクラムの表示方法を制御します。表13-8に、定義属性を示します。

表13-8 定義属性

属性

説明

最初の前

最初のブレッドクラム・エントリの前に表示するテキストを定義します。置換文字列#COMPONENT_CSS_CLASSES#を使用して、CSSクラスをブレッドクラム・テンプレートに適用します。コンポーネントCSSクラスを編集するには、リージョン属性を編集します。

関連項目: 「ページ・デザイナでのリージョン属性の編集」および「コンポーネント・ビューでのリージョン属性の編集」

カレント・ページのブレッドクラム・エントリ

カレント・ページに対応するブレッドクラム・エントリの外観を定義します。

カレント・ページ以外のブレッドクラム・エントリ

カレント・ページに対応していないブレッドクラム・エントリの外観を定義します。

最後の後

最後のブレッドクラム・エントリの後に表示するテキストを定義します。

レベル間

ブレッドクラム・エントリのレベル間に表示するテキストを定義します。

最大レベル

ブレッドクラムをブレッドクラム・スタイルで表示する際に使用するレベル数を指定します。

13.3.9.2.3 置換文字列

置換文字列は、コンポーネント値を参照するためにサブテンプレート内で使用されます。表13-9に、使用可能なボタン・テンプレートの置換文字列を示します。

ヒント:
テンプレートのすべての置換文字列は、大文字で指定し、シャープ記号(#)で囲む必要があります。特定のテンプレートでサポートされる置換文字列のレポートを表示するには、ブレッドクラム・テンプレートの編集ページの「置換文字列」セクションを参照してください。

表13-9 ブレッドクラム・テンプレートの置換文字列

参照元

置換文字列

説明

最初の前

#COMPONENT_CSS_CLASSES#

コンポーネントCSSクラス。

#COMPONENT_CSS_CLASSES#文字列は、テンプレート・オプションが定義されているテンプレートの最初の前属性に含める必要があります。#COMPONENT_CSS_CLASSES#文字列には、対応するテンプレート・オプション・クラスが実行時に注入されます。

カレント・エントリ

#LINK#

URLリンク。

カレント・エントリ

#LONG_NAME#

ブレッドクラムの詳細な名前。

カレント・エントリ

#NAME#

ブレッドクラム・ラベル。

カレント・エントリ

#NAME_ESC_SC#

ブレッドクラム・ラベル(HTML文字をエスケープ)。

非カレント・エントリ

#LINK#

URLリンク。

非カレント・エントリ

#LONG_NAME#

ブレッドクラムの詳細な名前。

非カレント・エントリ

#NAME#

ブレッドクラム・ラベル。

非カレント・エントリ

#NAME_ESC_SC#

ブレッドクラム・ラベル(HTML文字をエスケープ)。

13.3.10 ボタン・テンプレート

ボタン・テンプレートを使用すると、開発者は、ボタンのルック・アンド・フィールをカスタマイズできます。ボタンを構築する場合、複数のイメージまたはHTMLタグを使用できます。ボタン・テンプレートの使用はオプションです。

関連項目:
「テーマの使用」

13.3.10.1 ボタン・テンプレート属性

この項では、ボタン・テンプレートの編集ページの一部のセクションについて説明します。特定の属性の詳細は、フィールドレベル・ヘルプを参照してください。

関連項目:
「テンプレート・オプションの理解」および「テーマのサブスクリプションの理解」

13.3.10.1.1 名前

「テンプレート名」は、テンプレートの名前を示します。テンプレートに変換が必要なテキスト文字列が含まれているかどうかを示すには、「翻訳可能」チェック・ボックスを使用します。「テーマ」は、テンプレートが関連付けられているテーマを示します。

「テンプレート・クラス」は、そのテンプレートに固有の用途を示します。テーマに切り替えると、あるテーマのすべてのテンプレートは、別のテーマの対応するテンプレートにマップされます。アプリケーション・ビルダーは、テンプレート・クラスの割当てによってこのテンプレート・マッピングを行います。

13.3.10.1.2 定義

「通常のテンプレート」では、ボタン・タイプが「標準」の場合に表示されるボタン・テンプレートが定義されます。たとえば、&ITEM_NAME値はレンダリング時に置換できます。「ホット・テンプレート」では、ボタン・タイプが「ホット」の場合に表示されるボタン・テンプレートが定義されます。標準のアプリケーション置換文字列を含めることもできます。たとえば、&ITEM_NAME値はレンダリング時に置換できます。

サポートされている置換文字列の詳細は、フィールドレベル・ヘルプを参照してください。

ヒント:
置換文字列はすべて大文字である必要があります。

13.3.10.1.3 置換文字列

置換文字列は、コンポーネント値を参照するためにサブテンプレート内で使用されます。表13-10に、使用可能なボタン・テンプレートの置換文字列を示します。

ヒント:
テンプレートのすべての置換文字列は、大文字で指定し、シャープ記号(#)で囲む必要があります。特定のテンプレートでサポートされる置換文字列のレポートを表示するには、ページ・テンプレートの編集ページの「置換文字列」セクションを参照してください。

表13-10 ボタン・テンプレートの置換文字列

参照元

置換文字列

説明

ホット・テンプレート

#BUTTON_ATTRIBUTES#

ボタン属性。

ホット・テンプレート

#BUTTON_CSS_CLASSES#

ボタンCSSクラス。

#BUTTON_CSS_CLASSES#文字列は、テンプレート・オプションが定義されているテンプレートに含める必要があります。#BUTTON_CSS_CLASSES#文字列には、対応するテンプレート・オプション・クラスが実行時に注入されます。

ホット・テンプレート

#BUTTON_ID#

生成されるボタンIDは、ボタンの静的ID (定義されている場合)または'B' || [Internal Button ID]という形式の内部生成されたID (定義されていない場合)です。

ホット・テンプレート

#ICON_CSS_CLASSES#

アイコンCSSクラス。

ホット・テンプレート

#JAVASCRIPT#

onclick属性で使用されます。

ホット・テンプレート

#LABEL#

ボタン・ラベル。

ホット・テンプレート

#LINK#

href属性で使用されます。

テンプレート

#BUTTON_ATTRIBUTES#

ボタン属性。

テンプレート

#BUTTON_CSS_CLASSES#

ボタンCSSクラス。

#BUTTON_CSS_CLASSES#文字列は、テンプレート・オプションが定義されているテンプレートに含める必要があります。#BUTTON_CSS_CLASSES#文字列には、対応するテンプレート・オプション・クラスが実行時に注入されます。

テンプレート

#BUTTON_ID#

生成されるボタンIDは、ボタンの静的ID (定義されている場合)または'B' || [Internal Button ID]という形式の内部生成されたID (定義されていない場合)です。

テンプレート

#ICON_CSS_CLASSES#

アイコンCSSクラス。

テンプレート

#JAVASCRIPT#

onclick属性で使用されます。

テンプレート

#LABEL#

ボタン・ラベル。

テンプレート

#LINK#

href属性で使用されます。

13.3.11 レガシー・カレンダ・テンプレート

レガシー・カレンダ・テンプレートは、カレンダの外観と配置を制御します。このテンプレートは、頻繁にHTML表を使用して日付を配置します。#DD#や#MONTH#などの置換文字列を使用してカレンダ属性を配置します。

- サポートされるレガシー・カレンダ・テンプレートの置換文字列

- レガシー・カレンダ・テンプレート属性

関連項目:
「サポートされているカレンダについて」、「カレンダの作成」および「テーマの使用」

13.3.11.1 サポートされるレガシー・カレンダ・テンプレートの置換文字列

サポートされている置換文字列のリストは、カレンダ・テンプレートの編集ページの右側に表示されます。テンプレートの置換文字列は大文字で指定し、シャープ記号(#)で囲む必要があることに注意してください。

13.3.11.2 レガシー・カレンダ・テンプレート属性

この項では、カレンダ・テンプレートの編集ページの一部のセクションについて説明します。特定の属性の詳細は、フィールドレベル・ヘルプを参照してください。

関連項目:
「テンプレート・オプションの理解」および「テーマのサブスクリプションの理解」

カレンダ定義

13.3.11.2.1 名前

「名前」は、テンプレートの名前を示します。テンプレートに変換が必要なテキスト文字列が含まれているかどうかを示すには、「翻訳可能」チェック・ボックスを使用します。「テーマ」は、テンプレートが関連付けられているテーマを示します。

「テンプレート・クラス」は、そのテンプレートに固有の用途を示します。テーマに切り替えると、あるテーマのすべてのテンプレートは、別のテーマの対応するテンプレートにマップされます。アプリケーション・ビルダーは、テンプレート・クラスの割当てによってこのテンプレート・マッピングを行います。

13.3.11.2.2 サブスクリプション

「サブスクリプション」を使用して、カレント・アプリケーションに既存のテンプレートを適用します。

「マスター・ラベル・テンプレートの参照元」を使用して、対象のワークスペースの既存のテンプレート、またはワークスペースのスキーマの別のテンプレートを選択します。既存のテンプレートを選択すると、ユーザーはそのテンプレートのサブスクライバになります。

マスター・テンプレートのコピーをロードするには、「リフレッシュ」をクリックします。

13.3.11.2.3 コメント

この属性を使用して、このコンポーネントに関するコメントを記録します。

月次カレンダ、週次カレンダ、日次カレンダ、カスタム・カレンダおよびリスト・カレンダ

「月次カレンダ」、「週次カレンダ」、「日次カレンダ」および「リスト・カレンダ」属性を使用して、特定のカレンダの外観および配置を制御します。

13.3.12 ラベル・テンプレート

ラベル・テンプレートは、ページ・アイテム・ラベルのHTMLマークアップを集中管理することを目的としています。各アイテムにはオプションのラベルがあります。ラベル・テンプレートを使用して、これらのラベルの表示方法を制御できます。たとえば、ユーザーに必須であることを示すイメージ(アスタリスクなど)を参照する「必須フィールド」というラベル・テンプレートを作成できます。

ラベル・テンプレートを使用すると、アイテムの先頭と末尾に追加するテキスト文字列を定義できます。

- ラベル・テンプレート属性

- #CURRENT_ITEM_HELP_TEXT#を使用したアイテム・ヘルプの作成について

関連項目:
「テーマの使用」

13.3.12.1 ラベル・テンプレート属性

関連項目:
「テンプレート・オプションの理解」および「テーマのサブスクリプションの理解」

ここでは、ラベル・テンプレートの編集ページの特定のセクションについて説明します。特定の属性の詳細は、フィールドレベル・ヘルプを参照してください。

13.3.12.1.1 名前

「テンプレート名」は、テンプレートの名前を示します。テンプレートに翻訳が必要なテキスト文字列が含まれていることを示すには、「翻訳可能」チェック・ボックスを使用します。「テーマ」は、テンプレートが関連付けられているテーマを示します。

「テンプレート・クラス」は、そのテンプレートに固有の用途を示します。テーマに切り替えると、あるテーマのすべてのテンプレートは、別のテーマの対応するテンプレートにマップされます。アプリケーション・ビルダーは、テンプレート・クラスの割当てによってこのテンプレート・マッピングを行います。

13.3.12.1.2 定義

定義属性は次のとおりです。

ヒント:
サポートされている置換文字列のリストおよび例は、フィールドレベル・ヘルプを参照してください。

- ラベルの前 - アイテム・ラベルの前に表示するHTMLを入力します。#ITEM_CSS_CLASSES#置換文字列は、テンプレート・オプションが定義されているテンプレートに含める必要があります。

- ラベルの後 - アイテム・ラベルの後に表示するHTMLを入力します。このラベルはこのリージョンのHTMLの前に自動的に表示されるため、「ラベルの前」リージョンの開始タグを閉じる必要があります。

- アイテムの前 - フォーム・アイテムの直前に表示するHTMLを入力します。これは通常、アイテムをDIVコンテナにラップするか、フォーム・アイテムの前または後にヘルプ・ボタンを表示するために使用されます。

- アイテムの後 - フォーム・アイテムの直後に表示するHTMLを入力します。これは通常、アイテムをDIVコンテナにラップするか、フォーム・アイテムの前または後にヘルプ・ボタンを表示するために使用されます。

- ヘルプ・テンプレート - ヘルプ・サブ・テンプレートでは、アイテム・レベルのヘルプの起動に使用されるリンクまたはボタンを定義できます。このサブテンプレートは、ヘルプが定義されているアイテムに対してのみレンダリングされます。「#CURRENT_ITEM_HELP_TEXT#を使用したアイテム・ヘルプの作成について」を参照してください。

13.3.12.1.3 エラー表示

エラー表示属性は次のとおりです。

ヒント:
サポートされている置換文字列のリストおよび例は、フィールドレベル・ヘルプを参照してください。

- ラベルの前のエラー発生時 - アプリケーションがアイテムのインライン検証エラー・メッセージを表示する場合に、そのアイテム・ラベルの前に表示するHTMLを入力します。

- ラベルの後のエラー発生時 - アプリケーションがアイテムのインライン検証エラー・メッセージを表示する場合に、そのアイテム・ラベルに追加するHTMLを入力します。

- エラー・テンプレート - インライン検証エラー・メッセージを表示するためにレンダリングされるHTMLを入力します。メッセージ・テキストを参照するには、#ERROR_MESSAGE#置換文字列を使用します。#ERROR_TEMPLATE#置換文字列を使用して、アイテム属性の前後にエラー・テンプレートを含めることができます。

13.3.12.1.4 フィールド・コンテナ

フィールド・コンテナ属性は次のとおりです。

ヒント:
サポートされている置換文字列のリストおよび例は、フィールドレベル・ヘルプを参照してください。

- 「ラベルの前」とアイテム - ラベルおよびアイテムの前に表示するHTMLを入力します。これは、通常、アイテムをDIVコンテナまたはフィールド・セットにラップするために使用されます。「「ラベルの前」とアイテム」属性は、表グリッドを使用してフォーム・アイテムを表示しないページにのみレンダリングされます。これには、モバイル・ページ・テンプレートを使用したページが含まれます。

- 「ラベルの後」とアイテム - ラベルおよびアイテムの後に表示するHTMLを入力します。これは、通常、アイテムをDIVコンテナまたはフィールド・セットにラップするために使用されます。後のアイテムおよびラベル属性は、表グリッドを使用してフォーム・アイテムを表示しないページにのみレンダリングされます。これには、モバイル・ページ・テンプレートを使用したページが含まれます。

13.3.12.1.5 置換文字列

このテンプレートの置換文字列の用途を一覧します。置換文字列は、サブテンプレート内でコンポーネント値を参照するために使用されます。

13.3.12.2 #CURRENT_ITEM_HELP_TEXT#を使用したアイテム・ヘルプの作成について

#CURRENT_ITEM_HELP_TEXT#置換文字列を使用すると、ページのレンダリング時にインライン・ページ・ヘルプ・テキストを作成できます。たとえば、この置換文字列を使用すると、マウスをページ・アイテム・ラベルにあわせたときにツールチップとして表示されるページ・ヘルプ・テキストを作成できます。このプレースホルダによって、コストのかかるAjaxコールを実行せずに、レンダリング時にページにヘルプ・テキストを表示できます。

ヒント:
ヘルプ・テキストが短い場合は、このプレースホルダのみが使用されます。生成されるページには常に、すべてのページ・アイテムのヘルプ・テキストが含まれます。

ラベル・テンプレートの例

ラベルの前:

<label for="#CURRENT_ITEM_NAME#" id="#LABEL_ID#">
<span class="helpText">#CURRENT_ITEM_HELP_TEXT#</span>

ラベルの後:

</label>

13.3.13 リスト・テンプレート

リストは、リンクの共有コレクションです。リストの外観は、リスト・テンプレートで制御します。テンプレート属性を使用すると、特定のページのカレントまたは非カレントとしてリスト要素を定義できます。

- 階層リストについて

- リスト・テンプレート属性

関連項目:
「リストの作成」および「テーマの使用」

13.3.13.1 階層リストについて

Oracle Application Expressでは、階層的なリストをサポートしています。階層的なリストを作成するには、次のステップを実行します。

- 階層的なリストをサポートするリスト・テンプレートを選択します。階層的なリストをサポートするリスト・テンプレートを判別するには、サブリスト付きというネーミング規則のあるテンプレートを検索します。

- 各リスト・エントリの作成時には親リスト・エントリを選択します。

関連項目:
「リストの作成」

13.3.13.2 リスト・テンプレート属性

関連項目:
「テンプレート・オプションの理解」および「テーマのサブスクリプションの理解」

この項では、リスト・テンプレートの編集ページの一部のセクションについて説明します。特定の属性の詳細は、フィールドレベル・ヘルプを参照してください。

13.3.13.2.1 名前

「名前」は、テンプレートの名前を示します。テンプレートに翻訳が必要なテキスト文字列が含まれていることを示すには、「翻訳可能」チェック・ボックスを使用します。「テーマ」は、テンプレートが関連付けられているテーマを示します。

「テンプレート・クラス」は、そのテンプレートに固有の用途を示します。新しいテーマに切り替えると、あるテーマのすべてのテンプレートは、別のテーマの対応するテンプレートにマップされます。アプリケーション・ビルダーは、テンプレート・クラスの割当てによってこのテンプレート・マッピングを行います。

13.3.13.2.2 リスト前のエントリ

リスト要素の前に表示するHTMLを入力します。この属性は、HTML表またはHTML表の行を開始するために使用できます。#COMPONENT_CSS_CLASSES#置換文字列は、テンプレート・オプションが定義されているテンプレートの行の前のリスト・テンプレート属性に含める必要があります。

13.3.13.2.3 テンプレート定義

カレントおよび非カレントのリスト・テンプレートを定義します。サポートされている置換文字列は、#LINK#、#TEXT#、#TEXT_ESC_SC#、#ICON_CSS_CLASSES#、#IMAGE_PREFIX#、#IMAGE#、#IMAGE_ATTR#および#A01#...#A10#です。

テンプレート定義属性は次のとおりです。

- カレント・リスト・テンプレート: 選択された(カレントの)リスト・テンプレートに置換されるHTMLまたはテキストを入力します。

- サブリスト・アイテムが含まれているカレント・リスト・テンプレート:アイテムにサブリスト・アイテムが含まれる場合は、選択された(カレントの)リスト・テンプレートに置換されるHTMLまたはテキストを入力します。指定しない場合、現在のリスト・アイテム・テンプレートが使用されます。

- 非カレント・リスト・テンプレート: 選択されていない(非カレントの)リスト・テンプレートに置換されるHTMLまたはテキストを入力します。

- サブリスト・アイテムが含まれている非カレント・リスト・テンプレート:アイテムにサブリスト・アイテムが含まれる場合は、選択されていない(非カレントの)リスト・テンプレートに置換されるHTMLまたはテキストを入力します。指定しない場合、現在のリスト・アイテム・テンプレートが使用されます。

- リスト要素間: リスト要素の間に表示するHTMLを入力します。HTMLを指定しないと、この属性が無視されます。

13.3.13.2.4 最初のエントリのテンプレート定義

選択可能な属性は次のとおりです。

- カレント・リスト・テンプレート(最初):定義されている場合、これは最初のリスト・アイテムに使用されます。選択された(カレントの)リスト・テンプレートに置換されるHTMLまたはテキストを入力します。

- サブリスト・アイテムが含まれているカレント・リスト・テンプレート(最初):定義されている場合、これは最初のリスト・アイテムに使用されます。アイテムにサブリスト・アイテムが含まれる場合に使用される、選択された(カレントの)リスト・テンプレートに置換されるHTMLまたはテキスト。

- 非カレント・リスト・テンプレート(最初):定義されている場合、これは最初のリスト・アイテムに使用されます。選択されていない(非カレントの)リスト・テンプレートに置換されるHTMLまたはテキストを入力します。

- サブリスト・アイテムが含まれている非カレント・リスト・テンプレート(最初):定義されている場合、これは最初のリスト・アイテムに使用されます。アイテムにサブリスト・アイテムが含まれる場合に使用される、選択されていない(非カレントの)リスト・テンプレートに置換されるHTMLまたはテキスト。

13.3.13.2.5 サブリスト・エントリ前

サブリスト要素の前に表示するHTMLを入力します。

13.3.13.2.6 サブリスト・エントリ

カレントおよび非カレントのリスト・テンプレートを定義します。サポートされている置換文字列は、#LINK#、#TEXT#、#ICON_CSS_CLASSES#、#IMAGE_PREFIX#、#IMAGE#、#IMAGE_ATTR#、#ICON_CSS_CLASSES#、#A01#...#A10#、#LIST_ITEM_ID#および#PARENT_LIST_ITEM_ID#です。

サブリスト・エントリ属性は次のとおりです。

- カレント・サブリスト・テンプレート:選択された(カレントの)リスト・テンプレートに置換されるHTMLまたはテキストを入力します。

- サブリスト・アイテムが含まれているカレント・サブリスト・テンプレート:アイテムにサブリスト・アイテムが含まれる場合は、選択された(カレントの)リスト・テンプレートに置換されるHTMLまたはテキストを入力します。指定しない場合、現在のリスト・アイテム・テンプレートが使用されます。

- 非カレント・サブリスト・テンプレート:選択されていない(非カレントの)リスト・テンプレートに置換されるHTMLまたはテキストを入力します。

- サブリスト・アイテムが含まれている非カレント・サブリスト・テンプレート:アイテムにサブリスト・アイテムが含まれる場合は、選択されていない(非カレントの)リスト・テンプレートに置換されるHTMLまたはテキストを入力します。指定しない場合、現在のリスト・アイテム・テンプレートが使用されます。

- サブリスト・アイテム間:リスト要素の間に表示するHTMLを入力します。HTMLを指定しないと、この属性が無視されます。

13.3.13.2.7 サブリスト後のエントリ

サブリスト要素を表示した後に表示するHTMLを入力します。

13.3.13.2.8 リスト後のエントリ

すべてのリスト要素を表示した後に表示するHTMLを入力します。この属性を使用して、リスト前の要素属性で開始したHTML表を閉じることができます。

13.3.13.2.9 置換文字列

このテンプレートの置換文字列の用途を一覧します。置換文字列は、サブテンプレート内でコンポーネント値を参照するために使用されます。

13.3.14 ページ・テンプレート

ページ・テンプレートは、ページの外観を定義します。各テンプレートは、ヘッダー・テンプレート、ボディ・テンプレート、フッター・テンプレートおよび多くのサブテンプレートで構成されます。ページ・レベル属性でページ・テンプレートを指定しない場合、Application Expressエンジンは、テーマの作成/編集ページで定義したデフォルトのページ・テンプレートを使用します。

ページ・テンプレートは、静的HTMLと実行時に置き換えられる置換文字列を組み合せたものです。置換文字列を使用して、ページ・テンプレート内のコンポーネントの存在と配置を指定します。さらに、サブテンプレートを使用して、コンポーネントの表示方法を指定できます。

- ページ・テンプレート属性

- 必須のダイアログ・ページ・テンプレート属性

関連項目:
「テーマの使用」

13.3.14.1 ページ・テンプレート属性

関連項目:
「テンプレート・オプションの理解」および「テーマのサブスクリプションの理解」

ここでは、ページ・テンプレートの編集ページの特定のセクションについて説明します。サポートされている置換文字列など、特定の属性の詳細は、フィールドレベル・ヘルプを参照してください。

13.3.14.1.1 名前

「名前」は、テンプレートの名前を示します。「テーマ」は、テンプレートが関連付けられているテーマを示します。

「テンプレート・クラス」は、そのテンプレートに固有の用途を示します。新しいテーマに切り替えると、あるテーマのすべてのテンプレートは、別のテーマの対応するテンプレートにマップされます。アプリケーション・ビルダーは、テンプレート・クラスの割当てによってこのテンプレート・マッピングを行います。

「翻訳可能」チェック・ボックスを使用して、対象のテンプレートに翻訳が必要なテキスト文字列が含まれているかどうかを示します。

「テンプレート・タイプ」はページ・テンプレート・タイプを指定します。「ダイアログ・ページ」に設定すると、そのテンプレートを選択できるのは、ページ・モードが「モーダル」または「非モーダル」のページのみになります。「標準ページ」に設定すると、そのテンプレートを選択できるのは、ページ・モードが「標準」のページのみになります。

関連項目:
「ダイアログ・ページの作成」および「必須のダイアログ・ページ・テンプレート属性」

13.3.14.1.2 定義

各テンプレートは、ヘッダー、ボディ、フッターおよびサブテンプレートで構成されます。動的コンテンツを含めるには、置換文字列を使用します。テンプレートのすべての置換文字列は、大文字で指定し、シャープ記号(#)で囲む必要があります。

ヒント:
サポートされている置換文字列のリストおよび例は、フィールドレベル・ヘルプを参照してください。

定義属性は次のとおりです。

- ヘッダー - HTMLドキュメントの<Head>セクションを定義するHTMLを入力します。このテンプレート・セクションには、少なくとも#TITLE#および#HEAD#を含めることをお薦めします。

- ボディ - HTMLドキュメントの<Body>セクションを構成するHTMLを入力します。ボディ・コンテンツの配置場所および追加のリージョン位置を定義する置換文字列を含めます。

- フッター - ボディの後に表示する、ページ・テンプレートの3番目のセクションを定義するHTMLを入力します。

13.3.14.1.3 JavaScript

選択可能な属性は次のとおりです。

ヒント:
サポートされている置換文字列のリストおよび例は、フィールドレベル・ヘルプを参照してください。

- ファイルURL - このページにロードするコードのJavaScriptファイルURLを入力します。各URLを新しい行に記述する必要があります。ファイルの縮小バージョンを指定する場合、置換文字列#MIN#を使用して、通常ページ・ビューのファイルURLに.minを含めたり、ページをデバッグ・モードで表示する場合は空の文字列を含めることができます。置換文字列#APP_VERSION#を使用すると、ファイルURLにアプリケーションのバージョンを含めることができます。ここに入力したJavaScriptのファイルURLによって、ページ・テンプレート内の#TEMPLATE_JAVASCRIPT#置換文字列が置き換えられます。
スクリプトの開始タグや閉じタグを含めずに、URLのみを記述します。

- ファンクションおよびグローバル変数の宣言 - このページ・テンプレートで使用するコード用のJavaScriptコード(たとえば、ファンクションまたはグローバル変数宣言)を入力します。重複を避け、ブラウザで静的ファイルをキャッシュするため、外部ファイルに挿入することを検討してください。ここに入力したコードによって、ページ・テンプレート内の#TEMPLATE_JAVASCRIPT#置換文字列が置き換えられます。
スクリプトの開始タグや閉じタグを含めずに、JavaScriptコードのみを含めます。

ショートカットを参照するには、"SHORTCUTNAME"を使用します。

- ページ・ロード時に実行 - ページのロード時に実行するJavaScriptコードを入力します。このコードはOracle Application Expressによって生成されたJavaScriptコードの後に実行されます。ここに入力したコードによって、ページ・テンプレート内の#GENERATED_JAVASCRIPT#置換文字列が置き換えられます。

- ダイアログ初期化コード - この属性は、「テンプレート・タイプ」が「ダイアログ・ページ」の場合にのみ表示されます。ダイアログとしてページを初期化するJavaScriptコードを入力します。置換文字列は、レンダリング時に該当する値で置換されます。

- ダイアログ・クロージャ・コード。この属性は、「テンプレート・タイプ」が「ダイアログ・ページ」の場合にのみ表示されます。ダイアログ・ページを閉じるJavaScriptコードを入力します。

- ダイアログ取消コード。この属性は、「テンプレート・タイプ」が「ダイアログ・ページ」の場合にのみ適用されます。ダイアログ・ページを取り消すJavaScriptコードを入力します。

13.3.14.1.4 カスケード・スタイルシート

選択可能な属性は次のとおりです。

- ファイルURL - このページ・テンプレートにロードされるカスケード・スタイルシート・ファイルURLを入力します。各URLを新しい行に記述する必要があります。ファイルの縮小バージョンを指定する場合、置換文字列#MIN#を使用して、通常ページ・ビューのファイルURLに.minを含めたり、ページをデバッグ・モードで表示する場合は空の文字列を含めることができます。置換文字列#APP_VERSION#を使用すると、ファイルURLにアプリケーションのバージョンを含めることができます。ここに入力したファイルURLによって、テンプレート内の#TEMPLATE_CSS#置換文字列が置き換えられます。
スクリプトの開始タグや閉じタグを含めずに、ファイルURLのみを含めます。

- インライン - このページ・テンプレートに使用されるカスケード・スタイルシートのコードを入力します。重複を避け、ブラウザで静的ファイルをキャッシュするため、外部ファイルに挿入することを検討してください。ここに入力したコードによって、テンプレート内の#TEMPLATE_CSS#置換文字列が置き換えられます。
開始スタイル・タグや閉じスタイル・タグを含めずに、カスケード・スタイルシートのコードのみを含めます。

13.3.14.1.5 サブテンプレート

次のサブテンプレートのHTMLを入力します。サブテンプレートは、置換文字列を使用してページ・テンプレートのボディ内に配置されます。

サブテンプレートは次のとおりです。

- 成功メッセージ - テンプレート・ボディ、ヘッダー、フッター内の文字列#SUCCESS_MESSAGE#を置換するHTMLを入力します。

- ナビゲーション・バー - テンプレート・ヘッダー、ボディ、フッター内の文字列#NAVIGATION_BAR#を置換するHTMLまたはテキストを入力します。置換文字列#BAR_BODY#を使用して、ナビゲーション・バーにエントリが表示される位置を指定します。

- ナビゲーション・バー・エントリ - 各ナビゲーション・バー・エントリのナビゲーション・バー#BAR_BODY#置換文字列に置換されるHTMLまたはテキストを入力します。

- 通知 - #NOTIFICATION_MESSAGE#置換文字列が、テンプレートのヘッダー、ボディまたはフッターで参照される際に置換されるHTMLまたはテキストを入力します。

13.3.14.1.6 イメージ・ベースのタブ属性

このサブテンプレートは、完全にイメージに基づくタブに使用します。選択可能な属性は次のとおりです。

- カレント・イメージ・タブ - イメージベースのタブが現在選択されていることを示すために使用するHTMLを入力します。タブに表示される名前を示す#TAB_TEXT#置換文字列を含めます。

- 非カレント・イメージ・タブ - イメージ・タブが現在選択されていないことを示すために使用するHTMLを入力します。タブに表示される名前を示す#TAB_TEXT#置換文字列を含めます。

13.3.14.1.7 グリッド・レイアウト

ページで使用するレイアウト・グリッドのタイプを指定します。選択したタイプによって、表示される属性が決まります。属性の詳細は、フィールドレベル・ヘルプを参照してください。

「タイプ」から、グリッド・レイアウトを選択します。

- HTML表: HTML表を使用して、リージョン、ページ・アイテムおよびボタンを配置します。

- 固定列数: 画面を固定のグリッド列数で分割するグリッドに使用します。

- 可変列数: リージョン、ページ・アイテムおよびボタンの配置方法に応じて、グリッド列を最大n列まで表示できるグリッドに使用します。

13.3.14.1.8 表示ポイント

選択可能な属性は次のとおりです。

- ブレッドクラム表示ポイント - ブレッドクラムを使用する生成済コンポーネントに適用されます。ブレッドクラムが配置されるページ上の位置を定義します。サイドバー表示ポイント

- サイドバー表示ポイント - サイドバーを使用する生成済コンポーネントに適用されます。サイドバーが配置されるページ上の位置を定義します。

13.3.14.1.9 ダイアログ

ダイアログ属性は、「テンプレート・タイプ」に「ダイアログ・ページ」を選択した場合にのみ表示されます。これらの設定は、ページ・レベルで指定された類似の属性によって上書きされます。

選択可能なダイアログ属性は次のとおりです。

- 幅 - ダイアログの幅をピクセル単位または比率で入力します。

- 高さ - ダイアログの高さをピクセル単位で入力します(たとえば、500)。

- 最大幅 - ダイアログの最大幅をピクセル単位で入力します。jQuery Mobileスマートフォン・ユーザー・インタフェースを使用しているページの場合、最大幅は500です。

- CSSクラス - ダイアログに適用する追加のCSSクラスを、空白区切りのリストとして入力します。

- フレームへの埋込みを許可 - ページ・テンプレート・レベルのブラウザ・フレーム・オプションが、各オプションの現在の設定とともに下に示されます。ブラウザでアプリケーションのページをフレーム内に表示できるかどうかを選択します。現在の設定が、このページ・テンプレートを使用する各モーダルおよび非モーダル・ページのデフォルトです。詳細は、フィールドレベル・ヘルプを参照してください。
Oracle Application Expressは、iframeにモーダル・ダイアログを埋め込みます。アプリケーション・セキュリティ属性ブラウザ・フレームを「拒否」に設定する場合、「モーダル・ダイアログ」の「フレームへの埋込みを許可」を選択すると、かわりにこのテンプレートを使用するダイアログ・ページの「同じ起点から許可」が使用されます

関連項目:
「必須のダイアログ・ページ・テンプレート属性」

13.3.14.1.10 エラー・ページ・テンプレートの制御

ページ・テンプレートをエラー・テンプレートとして指定する場合は、この属性を使用します。

13.3.14.1.11 置換文字列

表13-11に、使用可能なページ・テンプレートの置換文字列を示します。置換文字列は、サブテンプレート内でコンポーネント値を参照するために使用されます。

ヒント:
テンプレートのすべての置換文字列は、大文字で指定し、シャープ記号(#)で囲む必要があります。特定のテンプレートでサポートされる置換文字列のレポートを表示するには、ページ・テンプレートの編集ページの「置換文字列」セクションを参照してください。

表 13-11 ページ・テンプレートの置換文字列

参照元

置換文字列

説明

すべて

#HIGH_CONTRAST_TOGGLE#

ハイ・コントラストの切替え。

すべて

#PAGE_STATIC_ID#

ページの静的ID (例: 'P100')。

すべて

#PARENT_TAB_CELLS#

親タブの表示。

すべて

#REGION_POSITION_01#

リージョン位置1。

すべて

#REGION_POSITION_02#

リージョン位置2。

すべて

#REGION_POSITION_03#

リージョン位置3。

すべて

#REGION_POSITION_04#

リージョン位置4。

すべて

#REGION_POSITION_05#

リージョン位置5。

すべて

#REGION_POSITION_06#

リージョン位置6。

すべて

#REGION_POSITION_07#

リージョン位置7。

すべて

#REGION_POSITION_08#

リージョン位置8。

すべて

#REQUESTED_URL#

ブラウザによってリクエストされたページURL

すべて

#SCREEN_READER_TOGGLE#

スクリーン・リーダーの切替え。

すべて

#SWITCH_UI_TO_DESKTOP#

デスクトップ・ユーザー・インタフェースのホームページへのハイパーリンク。

すべて

#SWITCH_UI_TO_JQM_SMARTPHONE#

スマートフォン・ユーザー・インタフェースのホーム・ページへのハイパーリンク。

すべて

#TITLE#

ページ・タイトルを定義します。通常、HTMLのtitleタグ内に含まれます。

ボディ

#BODY#

ページ・ボディ。

ボディ

#BOX_BODY#

ボディを表示する位置。ボディがNULLの場合、かわりに#BOX_BODY#が使用されます。

ボディ

#FORM_OPEN#

HTMLのフォームの開始タグ<form>を配置する位置。フォームを送信するには、この置換文字列を含める必要があります。

ボディ

#GENERATED_CSS#

コンポーネントによって作成されるカスケード・スタイルシート・ファイル。

ボディ

#GLOBAL_NOTIFICATION#

グローバル通知属性を表示します。グローバル通知は、システム・ステータス(保留中のシステム停止時間など)との通信に使用します。APEX_APPLICATION.G_GLOBAL_NOTIFICATIONを使用すると、この値をプログラムによって設定できます。

関連項目: 「グローバル通知」

ボディ

#LOGO#

アプリケーション・イメージまたはログ。

「アプリケーション定義の編集」ページの「ロゴ」セクションで、アプリケーションのロゴのイメージおよびイメージ属性を指定できます。この機能を使用するには、「ヘッダー」または「ボディ」ページ・テンプレートに置換文字列#LOGO#も含める必要があります。

関連項目: 「ロゴ」

ボディ

#NAVIGATION_BAR#

ナビゲーション・バー。

関連項目: 「ナビゲーション・バー」サブテンプレートは、サブテンプレートを参照してください。

ボディ

#NOTIFICATION_MESSAGE#

インライン・エラー・メッセージのサマリーが表示される位置を定義します。インライン・エラー・メッセージは、フィールドの横または通知領域にインライン(あるいはその両方)で表示できます。

ボディ

#SUCCESS_MESSAGE#

成功メッセージ。ページの成功メッセージおよびエラー・メッセージを表示する位置を定義します。エラーなしでページ・プロセスが実行されると、このテキストが表示されます。

成功メッセージの前後にHTMLを追加すると、各テンプレートの成功メッセージの表示をカスタマイズできます。

ボディ

#TAB_CELLS#

標準タブの表示。

ボディ

#TEMPLATE_JAVASCRIPT#

標準タブの表示。

フッター

#CUSTOMIZE#

「カスタマイズ」リンク。

フッター

#FORM_CLOSE#

HTMLのフォームの終了タグ<form>を配置する位置。

ヘッダー

#APEX_CSS#

Application Expressによって使用されるカスケード・スタイルシート・ファイル。

ヘッダー

#APEX_JAVASCRIPT#

Oracle Application Expressによって使用されるJavaScriptファイルとコード。

ヘッダー

#APPLICATION_CSS#

ユーザー・インタフェース・レベルで定義されているCSSファイル。

ヘッダー

#APPLICATION_JAVASCRIPT#

ユーザー・インタフェース・レベルで定義されているJavaScriptファイル。

ヘッダー

#GENERATED_JAVASCRIPT#

コンポーネントによって必要に応じて作成されるJavaScriptコード。

ヘッダー

#HEAD#

<head>開始タグと</head>閉じタグの間に使用します。オプションで、各ページの#HEAD#のコンテンツを定義できます(たとえば、追加のスタイルシートまたはJavaScriptライブラリを参照するように定義できます)。

ヘッダー

#ONLOAD#

ページのonload。

Webブラウザでページがロードされたときに実行されるJavaScriptコールで、この文字列を置換文字列として使用します。コールするJavaScriptは、ページごとに変更できます。

ヘッダー

#PAGE_CSS#

ページ・レベルで定義されているカスケード・スタイルシート・ファイルとインライン・スタイル。

ヘッダー

#PAGE_JAVASCRIPT#

ページ・レベルで定義されているJavaScriptファイルとコード。

ヘッダー

#TEMPLATE_CSS#

ページ・テンプレート・レベルで定義されているカスケード・スタイルシート・ファイルとインライン・スタイル。

ヘッダー

#THEME_CSS#

テーマレベルで定義されているカスケード・スタイルシート・ファイル。

ヘッダー

#THEME_JAVASCRIPT#

テーマレベルで定義されているJavaScriptファイル。

ヘッダー

#THEME_STYLE_CSS#

テーマ・スタイル・レベルで定義されているカスケード・スタイルシート・ファイル。

ページ

#PAGE_TRANSITION#

jQuery Mobileアプリケーションの他のページにナビゲートするために使用されるデフォルトのページ遷移。この新しいプレースホルダは、タイプrole="page"のDIVで使用する必要があります。次に例を示します。

<div id="#PAGE_STATIC_ID#" data-role="page" data-apex-page-transition="#PAGE_TRANSITION#" data-apex-popup-transition="#POPUP_TRANSITION#" data-url="#REQUESTED_URL#">

ページ

#PAGE_URL#

ページURL。

ページ

#POPUP_TRANSITION#

jQuery Mobileアプリケーションでダイアログを開くために使用されるデフォルトのページ遷移。この新しいプレースホルダは、タイプrole="page"のDIVで使用する必要があります。次に例を示します。

<div id="#PAGE_STATIC_ID#" data-role="page" data-apex-page-transition="#PAGE_TRANSITION#" data-apex-popup-transition="#POPUP_TRANSITION#" data-url="#REQUESTED_URL#">

JavaScript

#DIALOG_ATTRIBUTES#

宣言的にサポートされていないダイアログ属性を定義します。

JavaScript

#DIALOG_CSS_CLASSES#

ダイアログCSSクラス。

JavaScript

#DIALOG_HEIGHT#

ダイアログの高さ。

JavaScript

#DIALOG_MAX_WIDTH#

ダイアログの最大幅。

JavaScript

#DIALOG_WIDTH#

ダイアログの幅。

JavaScript

#IS_MODAL#

ダイアログ・ページ・モード(たとえば、モーダルの場合はtrue、非モーダルの場合はfalse)。

JavaScript

#SIDE_GLOBAL_NAVIGATION_LIST#

ナビゲーション・メニュー(サイド)。

JavaScript

#TOP_GLOBAL_NAVIGATION_LIST#

ナビゲーション・メニュー(トップ)。

JavaScript

#TRIGGERING_ELEMENT#

トリガー要素(たとえば、現在のDOM要素)。

13.3.14.2 必須のダイアログ・ページ・テンプレート属性

ダイアログ・ページ・テンプレートを作成するには、表13-12に示すページ・テンプレート属性を定義する必要があります。

表13-12 ダイアログ・ページ・テンプレートの必須属性

属性

説明

名前、テンプレート・タイプ

「ダイアログ・ページ」として定義する必要があります。

JavaScript、ダイアログ初期化コード

ダイアログとしてページを初期化するJavaScriptコードを入力します。ファンクション・コール構文は、フィールドレベル・ヘルプを参照してください。

JavaScript、ダイアログ・クロージャ・コード

ダイアログ・ページを閉じるJavaScriptコードを入力します。ファンクション・コール構文は、フィールドレベル・ヘルプを参照してください。

JavaScript、ダイアログ取消コード

ダイアログ・ページを取り消すJavaScriptコードを入力します。ファンクション・コール構文は、フィールドレベル・ヘルプを参照してください。

ダイアログ、幅

ダイアログのデフォルトの幅を設定します。ページ・テンプレート・レベルの設定は、ページ・レベルで上書きできます。

ダイアログ、高さ

ダイアログのデフォルトの高さを設定します。ページ・テンプレート・レベルの設定は、ページ・レベルで上書きできます。

ダイアログ、最大幅

ダイアログの最大幅をピクセル単位で設定します。ページ・テンプレート・レベルの設定は、ページ・レベルで上書きできます。

ダイアログ、CSSクラス

ダイアログに適用する追加のCSSクラスを入力します。ページ・テンプレート・レベルの設定は、ページ・レベルで上書きできます。

ダイアログ、フレームへの埋込みを許可

この属性を使用してブラウザでアプリケーションのページをフレーム内に表示できるかどうかを制御するページ・モードを選択します。Application Expressは、iframeにモーダル・ダイアログを埋め込みます。アプリケーション・セキュリティ属性ブラウザ・フレームを「拒否」に設定する場合、「モーダル・ダイアログ」の「フレームへの埋込みを許可」を選択すると、かわりにこのテンプレートを使用するダイアログ・ページの「同じ起点から許可」が使用されます。

関連項目:
「ダイアログ・ページの作成」および「ページ・テンプレート属性」

13.3.15 ポップアップLOVテンプレート

ポップアップLOVテンプレートは、POPUPとして定義したすべてのアイテムに対するポップアップ・リストの表示方法を制御します。ポップアップLOVテンプレートは、各テーマに1つのみ指定できます。

関連項目:
「アプリケーション・レベルでのLOVの作成」および「テーマの使用」

13.3.15.1 ポップアップLOVテンプレート属性

関連項目:
「テーマのサブスクリプションの理解」

この項では、ポップアップLOVテンプレートの編集ページの一部のセクションについて説明します。属性の詳細は、フィールドレベル・ヘルプを参照してください。

13.3.15.1.1 検索フィールド

これらの属性を使用して、「検索」フィールドの表示方法を指定します。表13-13に、使用可能な検索フィールドの属性を示します。

表13-13 検索フィールドの属性

属性

説明

フィールド・テキストの前

ポップアップLOVの検索フィールドを表示する前に表示するテキストを定義します。

フィールド・テキストの後

検索フィールド、検索ボタンおよび閉じるボタンを表示した後にこのテキストを表示します。

フィルタ幅

この幅を使用して、HTML INPUT TYPE = TEXTウィジェットを表示します。

フィルタ最大幅

この最大幅を使用して、HTML INPUT TYPE = TEXTウィジェットを表示します。

フィルタ・テキスト属性

これらの属性を使用して、HTML INPUT TYPE = TEXTウィジェットを表示します。これは、HTML入力タグ内に含まれます。

13.3.15.1.2 ボタン

これらの属性を使用して、ボタン名および「検索」、「閉じる」、「次へ」および「戻る」ボタンの属性を定義します。

13.3.15.1.3 ウィンドウ

JavaScriptを使用してポップアップLOVが実行されます。これらの属性を使用して、scrollbars=、resizable=、width=およびheight=の値を制御します。

13.3.15.1.4 ページ区切り

行カウント結果の表示方法を定義します。

13.3.15.1.5 結果セット

これらの属性を使用して、結果セットの前後に表示するテキストまたはHTMLを定義します。

13.3.15.1.6 ページ属性

これらの属性を使用してポップアップ・ページを定義します。

13.3.16 リージョン・テンプレート

関連項目:
「テンプレート・オプションの理解」および「テーマのサブスクリプションの理解」

リージョン・テンプレートは、リージョン属性の外観と配置を制御します。#BODY#や#EDIT#などの置換文字列を使用してリージョン属性を配置します。テンプレートの置換文字列は、大文字で指定し、シャープ記号(#)で囲む必要があります。

関連項目:
「リージョンについて」および「テーマの使用」

13.3.16.1 リージョン・テンプレート属性

関連項目:
「テンプレート・オプションの理解」および「テーマのサブスクリプションの理解」

この項では、リージョン・テンプレートの編集ページの一部の属性について説明します。特定の属性の詳細は、フィールドレベル・ヘルプを参照してください。

13.3.16.1.1 名前

「テーマ」は、テンプレートが関連付けられているテーマを示します。「名前」は、テンプレートの名前を示します。

「テンプレート・クラス」は、そのテンプレートに固有の用途を示します。新しいテーマに切り替えると、あるテーマのすべてのテンプレートは、別のテーマの対応するテンプレートにマップされます。アプリケーション・ビルダーは、テンプレート・クラスの割当てによってこのテンプレート・マッピングを行います。テンプレートに翻訳が必要なテキスト文字列が含まれていることを示すには、「翻訳可能」チェック・ボックスを使用します。

13.3.16.1.2 定義

リージョン・テンプレートにより、リージョンと呼ばれるページ部分の外観が決まります。置換文字列を使用して、リージョン内のコンポーネントの存在と配置を指定します。必要な置換文字列は#BODY#のみで、リージョン・ソースが配置される位置を指定します。他のすべての置換文字列はオプションです。有効な置換文字列は次のとおりです。

- #TITLE#

- #PAGE_TITLE#

- #EXPAND#

- #CHANGE#

- #BODY#

- #SUB_REGION_HEADERS#

- #SUB_REGIONS#

- #FORM_OPEN#

- #FORM_CLOSE#

- #REGION_ID#

- #REGION_STATIC_ID#

- #REGION_CSS_CLASSES#

- #REGION_ATTRIBUTES#

- #REGION_HEADER#

- #REGION_FOOTER#

リージョン位置にボタンを作成すると、定義した位置が選択リストに表示されます。次の置換文字列を使用して、リージョンにボタンを配置する位置を定義してください。

- #EDIT#

- #CLOSE#

- #CREATE#

- #CREATE2#

- #EXPAND#

- #HELP#

- #DELETE#

- #COPY#

- #NEXT#

- #PREVIOUS#

関連項目:
「置換文字列の理解」

13.3.16.1.3 グリッド・レイアウト

ページ・アイテムは、リージョン内で表示されます。ページ・テンプレートのグリッド・タイプが「表」に設定されている場合、各アイテムはHTML表に含まれます。この属性を使用して、この表の属性を設定します。

13.3.16.1.4 サブリージョン

「ヘッダー・テンプレート」および「ヘッダー・エントリ・テンプレート」を使用して、現在のリージョンにおけるすべてのサブリージョンのリージョン・タイトルのリストを生成します。どちらのテンプレートでも、必要な置換文字列は#ENTRIES#のみです。

「テンプレート」を使用して、サブリージョンを追加のHTMLコードでラップします。必要な置換文字列は#SUB_REGION#のみです。この置換文字列は、サブリージョンのソースの配置場所を示します。他のすべての置換文字列はオプションです。

13.3.16.1.5 置換文字列

コンポーネント値を参照するためにテンプレート内で使用される置換文字列を示します。

13.3.17 レポート・テンプレート

レポート列テンプレートによって、SQL問合せによって戻される1行の結果を制御できます。このタイプのテンプレートは、行全体ではなく、セルを定義します。

各レポート・テンプレートでは、#1#、#2#、#3#などの構文を使用して列名を識別します。#ENAME#や#EMPNO#などの列名の置換構文を使用して、列に名前を付けることもできます。アプリケーションのどのアイテムもテンプレート内で参照できます。たとえば、テンプレートのABC.というアイテムを参照するには、置換文字列&ABC.を正確に含めます。ABC.の実際の値は、ABCという名前のアプリケーションのアイテムを編集するエンド・ユーザーによって提供されます。

関連項目:
「テーマの使用」、「テンプレート・オプションの理解」および「テーマのサブスクリプションの理解」

- 汎用列テンプレートおよび名前付き列テンプレート

- 汎用列テンプレートのレポート列テンプレート属性

- 名前付き列テンプレートのレポート列テンプレート属性

- 列テンプレートでのJavaScriptの使用について

13.3.17.1 汎用列テンプレートおよび名前付き列テンプレート

Oracle Application Expressには、次の2種類のレポート・テンプレートが含まれています。

- 汎用列テンプレート

- 名前付き列テンプレート

13.3.17.1.1 汎用列テンプレート

汎用列テンプレートは、列の外観を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

13.3.17.1.2 名前付き列テンプレート

名前付き列テンプレートを使用すると、より柔軟にレポートを設計できます。ただし、名前付きテンプレートは名前で列を参照するため、それらの列を基にしたレポートでのみ使用されます。次に例を示します。

<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>

13.3.17.2 汎用列テンプレートのレポート列テンプレート属性

ここでは、汎用列テンプレートのレポート・テンプレートの編集ページの特定のセクションについて説明します。特定の属性の詳細は、フィールドレベル・ヘルプを参照してください。

13.3.17.2.1 レポート・テンプレート

「テンプレート名」は、テンプレートの名前を示します。「テンプレート・タイプ」には、テンプレートのタイプを指定します。名前付き列テンプレートは、テンプレートの列名を参照します。汎用列テンプレートは、テンプレートの#COLUMN_VALUE#置換文字列を参照します。

「テーマ」は、テンプレートが関連付けられているテーマを示します。「テンプレート・クラス」は、そのテンプレートに固有の用途を示します。新しいテーマに切り替えると、あるテーマのすべてのテンプレートは、別のテーマの対応するテンプレートにマップされます。アプリケーション・ビルダーは、テンプレート・クラスの割当てによってこのテンプレート・マッピングを行います。テンプレートに翻訳が必要なテキスト文字列が含まれていることを示すには、「翻訳可能」チェック・ボックスを使用します。

13.3.17.2.2 行の前

「行の前」では、レポート・テンプレートの最初に1回表示するHTMLを入力します。

HTML表は、一般的に、次のようにこの属性を使用して開始します。

<table>

置換文字列#TOP_PAGINATION#を含めることによって、レポートの上部にページ区切りを含めることができます。この置換文字列は、開始タグ<tr>で始まり、閉じタグ</tr>で終わるHTMLを生成します。たとえば、表の開始タグと#TOP_PAGINATION#置換文字列を含めるには、次のように入力します。

<table>#TOP_PAGINATION#

また、置換文字列 #CSV_LINK#を使用すると、ほぼすべてのスプレッドシート・プログラムと互換性があるカンマ区切り値(CSV)形式にレポートをエクスポートできるようになります。

また、置換文字列#REPORT_ATTRIBUTES#を使用することもできます。この置換文字列は、レポート属性ページのレポート・リージョンごとに設定されます。

13.3.17.2.3 列ヘッダー

「列ヘッダーの前」を使用して、レポート・ヘッダーの前にテキストを表示します。

「列ヘッダー・テンプレート」を使用して、各列ヘッダーのセルをカラーにします。この属性のテキストには、セルのヘッダー・テキストをカラーにする位置を示すヘルプを含める必要があります。次に例を示します。

<th >Item Help Text</th>

列ヘッダーを使用しない場合は、次のように入力します。

OMIT

この属性を使用しない場合は、Application Expressエンジンによって、デフォルトの列ヘッダー・テンプレートが適用されます。

「列ヘッダーの後」を使用して、レポート・ヘッダーの後にテキストを表示します。

13.3.17.2.4 各行の前

「各行の前」では、レポートのすべての列の前に表示するテキストを入力します。この属性は、新しいHTML行を開始するために使用します。「各行の前」では、次の置換文字列をサポートします。

- #ROWNUM#
この置換文字列は、現行の行を指定するために使用します。

- #COLCOUNT#
この置換文字列は、列の数を指定するために使用します。

- #HIGHLIGHT_ROW#
この置換文字列は、ハイライトされた行の数を指定するために使用します。

13.3.17.2.5 列テンプレート

列テンプレートは、各列の外観を定義します。最大4つの列テンプレートを定義できます。各テンプレートは、条件付きにできます。たとえば、偶数行と奇数行に異なる背景色を指定したり、PL/SQLで定義した条件に一致する行をハイライトできます。

各列テンプレートでは、各列の外観を定義します。表13-14に、列テンプレートでサポートされる置換文字列を示します。

表 13-14 列テンプレートの置換文字列

置換文字列

説明

#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

13.3.17.2.6 各行の後

「各行の後」には、レポートを表示する際にすべての列の後に表示するHTMLを入力します。多くの場合、この属性は、HTML表の行を閉じるために使用されます。次に例を示します。

</tr>

13.3.17.2.7 行の後

「行の後」を使用して、最後の行の後に表示するテキストを指定します。HTML表のタグは、一般的に、この属性を使用して閉じます。次に例を示します。

</table>

「行の後」属性は、次の置換文字列をサポートします。

- #PAGINATION#
ページ区切り属性で置換されます。

- #COLCOUNT#
実行時に、レポートで定義された列数に置換されます。

- #CSV_LINK#
CSVのエクスポートが有効な場合に、CSVダウンロード・リンクに実行時に置換されます。それ以外の場合、文字列は表示されません。

- #EXTERNAL_LINK#
実行時に、外部処理エンジン(PDFエクスポートなど)を使用するエクスポートのダウンロード・リンクに置換されます。この機能が有効でない場合、文字列は表示されません。

13.3.17.2.8 行選択

「チェックした行のバックグラウンド・カラー」では、行セレクタが選択されている場合のレポート行の背景色が制御されます。「カレント行のバックグラウンド・カラー」では、ユーザーがその行の上にマウスを移動した場合のレポート行の背景色を制御します。

13.3.17.2.9 ページ区切りサブテンプレート

「ページ区切りのサブテンプレート」セクションには、「ページ区切りテンプレート」、「次のページ・テンプレート」、「前のページ・テンプレート」、「次のセット・テンプレート」および「前のセット・テンプレート」を編集する属性が含まれています。ページ区切りのサブテンプレートは、置換文字列#PAGINATION_NEXT#、#PAGINATION_NEXT_SET#、#PAGINATION_PREVIOUS#および#PAGINATION_PREVIOUS_SET#をサポートしています。表13-17に、これらのテンプレートについて示します。

表 13-15 ページ区切りのサブテンプレート属性

ページ区切りサブテンプレート属性

説明

ページ区切りテンプレート

ページ区切りサブテンプレート全体に適用します。次に例を示します。

<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>

13.3.17.2.10 コメント

この属性を使用して、このコンポーネントに関するコメントを記録します。

13.3.17.3 名前付き列テンプレートのレポート列テンプレート属性

ここでは、名前付き列テンプレートのレポート・テンプレートの編集ページの特定のセクションについて説明します。ページの各セクションにアクセスするには、ページをスクロール・ダウンするか、ページ上部のナビゲーション・ボタンをクリックします。ページ上部のボタンを選択すると、選択されたセクションが表示され、その他のセクションはすべて一時的に非表示になります。ページのすべてのセクションを表示するには、「すべて表示」をクリックします。

13.3.17.3.1 名前

「テンプレート名」は、テンプレートの名前を示します。「テンプレート・タイプ」には、テンプレートのタイプを指定します。名前付き列テンプレートは、テンプレートの列名を参照します。汎用列テンプレートは、テンプレートの#COLUMN_VALUE#置換文字列を参照します。

「テーマ」は、テンプレートが関連付けられているテーマを示します。テンプレートに翻訳が必要なテキスト文字列が含まれていることを示すには、「翻訳可能」チェック・ボックスを使用します。「テンプレート・クラス」は、そのテンプレートに固有の用途を示します。新しいテーマに切り替えると、あるテーマのすべてのテンプレートは、別のテーマの対応するテンプレートにマップされます。アプリケーション・ビルダーは、テンプレート・クラスの割当てによってこのテンプレート・マッピングを行います。

13.3.17.3.2 サブスクリプション

「サブスクリプション」を使用して、カレント・アプリケーションに既存のテンプレートを適用します。既存のテンプレートを選択すると、ユーザーはそのテンプレートのサブスクライバになります。

マスター・テンプレートの新しいコピーをロードするには、「リフレッシュ」をクリックします。

13.3.17.3.3 行テンプレート

行テンプレートは、各行の外観を定義します。最大4つの行テンプレートを定義できます。各テンプレートは、条件付きにできます。

各行テンプレートでは、各行の外観を定義します。表13-16に、行テンプレートでサポートされる置換文字列を示します。

表 13-16 行テンプレートの置換文字列

置換文字列

説明

#ALIGNMENT#

行の位置合せを指定します。ユーザーが指定します。

#COLCOUNT#

列数のカウントを定義します。

#COLNUM#

現在の列番号を定義します。

#COLUMN_HEADER#

列ヘッダーを定義します。

#COLUMN_VALUE#

列の値に置換されます。

#ROWNUM#

現在の行番号を指定します。

条件を作成すると、指定した条件に一致するかどうかによって行の表示が異なるレポートを作成できます。条件付きで使用される行テンプレートを指定するには、列テンプレートの条件リストから条件タイプを選択します。有効な値は、次のとおりです。

- PL/SQL式に基づく使用:その行のデータに基づき、条件付きで列を書式化します。

- 偶数行で使用:偶数行を条件付きで書式化します。

- 奇数行で使用:奇数行を条件付きで書式化します。

「PL/SQL式に基づく使用」を選択する場合は、次に列テンプレートの式フィールドでPL/SQL式を入力します。たとえば、次の式で値が2000より大きい場合、その値を太字で表示します。

#SAL# > 2000

置換文字列#ROWNUM#を使用することもできます。次に例を示します。

#ROWNUM# > 2000

13.3.17.3.4 列ヘッダー

各列ヘッダーのセルに色を追加するには、このテンプレートを使用します。この属性のテキストには、セルのヘッダー・テキストをカラー化する位置を指定する必要があります。「列ヘッダー・テンプレート」を入力しない場合は、デフォルトの列ヘッダー・テンプレートが適用されます。列ヘッダーを使用しない場合は、OMITを入力します。次に例を示します。

<th #ALIGNMENT#>#COLUMN_HEADER#</th>

13.3.17.3.5 最初の行の前と最後の行の後のテキスト

「行の前」では、レポート・テンプレートの最初に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#
実行時に、レポートで定義された列数に置換されます。

13.3.17.3.6 ページ区切り

「ページ区切り」セクションには、「ページ区切りテンプレート」、「次のページ・テンプレート」、「前のページ・テンプレート」、「次のセット・テンプレート」および「前のセット・テンプレート」を編集する属性が含まれています。ページ区切りのサブテンプレートは、置換文字列#PAGINATION_NEXT#、#PAGINATION_NEXT_SET#、#PAGINATION_PREVIOUS#および#PAGINATION_PREVIOUS_SET#をサポートしています。表13-17に、これらのテンプレートについて示します。

表 13-17 ページ区切りのサブテンプレート属性

ページ区切りサブテンプレート属性

説明

ページ区切りテンプレート

ページ区切りサブテンプレート全体に適用します。次に例を示します。

<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>

13.3.17.3.7 コメント

この属性を使用して、このコンポーネントに関するコメントを記録します。

13.3.17.4 列テンプレートでの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>" );

関連項目:
「リージョンについて」

13.4 カスタム・カスケード・スタイルシートの使用

カスケード・スタイルシート(CSS)によって、構造を変更せずにWebページのスタイルを制御できます。CSSを適切に使用すると、カラー、余白、フォントなどの視覚属性がHTMLドキュメントの構造から切り離されます。Oracle Application Expressのテーマには、独自のCSSを参照するテンプレートを含めることができます。特定のテーマの各CSSで定義されたスタイル・ルールによって、レポートおよびリージョンの表示も指定されます。

- カスケード・スタイルシートのアップロードについて

- ページ・テンプレートのアップロードされたカスケード・スタイルシートの参照

ヒント:
アプリケーションでユニバーサル・テーマ - 42を使用する場合、テーマ・スタイルを利用し、テーマ・ローラーでアプリケーションの外観を更新することもできます。「テーマ・スタイルの使用」および「テーマ・ローラーの使用」を参照してください。

13.4.1 カスケード・スタイルシートのアップロードについて

ワークスペース内の特定のアプリケーションで使用するために、またはすべてのアプリケーションで使用するために、ファイル(CSSファイルを含む)をアップロードできます。詳細は、「静的アプリケーション・ファイルの管理」および「静的アプリケーション・ファイルの管理」を参照してください。

関連項目:
「ページ・テンプレートのアップロードされたカスケード・スタイルシートの参照」

13.4.2 ページ・テンプレートのアップロードされたカスケード・スタイルシートの参照

ページ・テンプレートのヘッダー・セクション内でアップロードされたカスケード・スタイルシートを参照できます。ヘッダー・セクションを使用して、HTMLドキュメントの<HEAD>セクションを構成するHTMLを入力します。

アップロードされたカスケード・スタイルシートを参照するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「ユーザー・インタフェース」で、「テーマ」を選択します。
テーマ・ページが表示されます。

5. 「タスク」リストで、「テンプレートの表示」をクリックします。

6. 編集するページ・テンプレートの名前を選択します。

7. 「ヘッダー」セクション内の<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」

14 ページ・レイアウトの制御

この項では、グローバル・ページの使用、リージョンのカスタマイズおよびアイテム属性の編集によって、データベース・アプリケーションのページ・レイアウトをカスタマイズする方法について説明します。この項では、イメージおよび静的ファイルを管理する方法と、カスタムPOL/SQLを使用してHTMLをレンダリングする方法についても説明します。

- Oracle Application Expressのページ・レイアウトについて

- すべてのページにコンポーネントを表示するグローバル・ページの作成

- リージョンについて

- ページ・デザイナでのリージョンの管理

- コンポーネント・ビューでのリージョンの管理

- 他のWebサイトからのコンテンツの組込みについて

- イメージの管理について

- カスタムPL/SQLを使用したHTMLのレンダリング

関連項目:
「ナビゲーションの追加」、「アプリケーションのユーザー・インタフェースの管理」および「テーマおよびテーマ・スタイルの使用」

14.1 Oracle Application Expressのページ・レイアウトについて

Application Expressエンジンは、開発者によって定義されたアプリケーション・コンポーネントおよびデータベース内のデータをテンプレートと組み合せてページをレンダリングします。

全体的なフレームワーク(またはページの構造)は、ページ・テンプレートによって決まります。たとえば、ページ・テンプレートは、ページでタブおよびナビゲーション・バーを使用するかどうかを制御します。また、ページの左側にナビゲーションまたはセカンダリ・コンテンツ用のプレースホルダとして機能するバーを含めるかどうかを定義することもできます。さらに、ページ・テンプレートには、リージョン位置の定義を含めることができます。これによって、HTML表またはスタイルシート定義を使用してリージョンの位置を正確に制御できます。ページ・テンプレート自体は、置換文字列と組み合されたHTMLで構成され、これらの置換文字列は、実行時に適切なコンポーネントに置換されます。

開発者は、リージョンを作成することによってページにコンテンツを追加します。リージョンはページの領域で、コンテンツのコンテナとして機能します。各リージョンには、HTML、レポート、フォーム、チャート、リスト、ブレッドクラム、PL/SQL、ツリー、URL、カレンダなどの様々なコンテンツが含まれます。他のリージョンとの相対位置によって(順序番号および列に基づいて)、またはページ・テンプレートに定義されたリージョン位置を使用して、リージョンを配置します。リージョンのスタイルは、リージョン・テンプレートによっても制御されます。ページ・テンプレートと同様に、リージョン・テンプレートは、リージョンを表示するページ上の領域の構造を定義します。リージョン・テンプレートは、リージョン・タイトルを表示するかどうか、およびメイン・コンテンツ(ボディ)に対するリージョン・タイトルの相対的な表示位置を定義します。リージョンでは、ボタンの絶対位置を定義することもできます。

関連項目:
「コンポーネント・ビューでのリージョンの作成」および「テーマおよびテーマ・スタイルの使用」

14.2 印刷用ページの最適化

特定の印刷用テンプレートを作成し、テーマの作成/編集ページでそのテンプレートを選択することで、印刷用のページを最適化できます。一般に、印刷用テンプレートは、印刷用のページを最適化します。たとえば、印刷用テンプレートは、次のことを行います。

- タブまたはナビゲーション・バーを非表示にします。

- アイテムをフォーム要素ではなくテキストとして表示します

選択したテーマに印刷用テンプレートが含まれていない場合、新しいページ・テンプレートを作成することによって印刷用テンプレートを作成できます。

- アプリケーションの印刷用テンプレートの選択

- f?p構文を使用した印刷用モードへの切替え

関連項目:
「テーマの編集」および「テーマの作成」

14.2.1 アプリケーションの印刷用テンプレートの選択

印刷用テンプレートを選択するには、次のステップを実行します。

1. テーマ・ページにナビゲートします。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「ユーザー・インタフェース」で、「テーマ」を選択します。
テーマ・ページが表示されます。

2. 「レポートの表示」アイコンをクリックして、レポート・ビューに切り替えます。

3. 「テーマ」リストで、テーマ名をクリックします。
テーマの作成/編集ページが表示されます。

4. 「コンポーネントのデフォルト値」までスクロールします。

5. 「「印刷用」ページ」リストから選択します。

6. 「変更の適用」をクリックします。

関連項目:
「テーマの編集」

14.2.2 f?p構文を使用した印刷用モードへの切替え

印刷用テンプレートを作成して選択した後、f?p構文を使用して印刷用モードに切り替えることができます。f?p構文の9番目の引数(PrinterFriendly)を指定すると、ページが印刷用(印刷用に最適化された)モードでレンダリングされます。たとえば、リンクのコーディング時、またはナビゲーション・バー・アイコンの作成時に、この引数を含めることができます。

関連項目:
「f?p構文を使用したページのリンクについて」

14.3 すべてのページにコンポーネントを表示するグローバル・ページの作成

この項では、グローバル・ページの作成方法について説明します。グローバル・ページ(以前はページ0と呼ばれていた)は、マスター・ページとして機能します。各ユーザー・インタフェースに、個別のグローバル・ページを作成できます。Application Expressエンジンは、アプリケーション内の各ページの「グローバル」ページに追加したすべてのコンポーネントをレンダリングします。Application Expressエンジンでコンポーネントをレンダリングするか、または条件を定義することで計算、検証またはプロセスを実行するかを制御することもできます。

関連項目:
「データベース・アプリケーションのページの管理」、「条件付きのレンダリングおよびプロセスの理解」および「使用可能な条件」

- グローバル・ページの作成

- グローバル・ページへのナビゲート

14.3.1 グローバル・ページの作成

グローバル・ページを作成するには、次の手順を実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。

2. アプリケーションを選択します。
アプリケーションのホームページが表示されます。

3. 「ページの作成」ボタンをクリックします。

4. 「ページの作成」で、次のステップを実行します。

1. ユーザー・インタフェース: アプリケーションの選択されたユーザー・インタフェースを表示します。

2. ページ・タイプの選択 - 「グローバル・ページ」を選択します。
アプリケーションに指定したユーザー・インタフェースの「グローバル」ページがない場合にのみ、「グローバル・ページ」オプションが表示されることに注意してください。

5. 「ページ番号」で、アプリケーション内のページを識別する整数値を入力します。

6. 「終了」をクリックします。

関連項目:
「アプリケーションのユーザー・インタフェースの管理」

14.3.2 グローバル・ページへのナビゲート

「グローバル」ページへナビゲートするには、次の手順を実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。
アプリケーション・ビルダーのホームページが表示されます。

2. アプリケーションを選択します。
アプリケーションのホームページが表示されます。

3. 「グローバル・ページ」(より古いアプリケーションの場合は「ページ0(ゼロ)」)を選択します。

14.4 リージョンについて

Oracle Application Expressアプリケーションの各ページに、1つ以上のリージョンが含まれます。リージョンはページ上の領域で、コンテンツのコンテナとして機能します。各ページには任意の数のリージョンを配置できます。特定のリージョン・テンプレートによってリージョンの外観を制御できます。リージョン・テンプレートでは、リージョンの外観およびサイズの制御、枠線または背景色を使用するかどうかの指定、表示するフォントの決定を行います。また、リージョン位置に配置されるボタンの標準配置も制御します。

リージョンを使用して、ページ・コントロール(アイテムやボタンなど)をグループ化できます。追加のHTMLを生成しない単純なリージョンを作成したり、HTML表やイメージ内でコンテンツを形成する詳細なリージョンを作成できます。

リージョンはページ・テンプレート・ボディに順次表示されるか、またはリージョン位置に明示的に配置できます。ページ構造を定義するには、HTML表または今日より一般的なDIVタグを使用します。

関連項目:
「ページ・デザイナでのリージョンの管理」、「コンポーネント・ビューでのリージョンの管理」および「ページ固有のユーティリティへのアクセス」

14.5 ページ・デザイナでのリージョンの管理

Oracle Application Expressアプリケーションの各ページに、1つ以上のリージョンが含まれます。リージョンはコンテンツのコンテナとして機能します。この項では、リージョンを作成および管理する方法について説明します。

- ページ・デザイナでのリージョンの作成

- ページ・デザイナでのリージョンの管理

- ページ・デザイナでのリージョンのコピー

- ページ・デザイナでのリージョンの削除

関連項目:
「リージョンについて」および「コンポーネント・ビューでのリージョンの管理」

14.5.1 ページ・デザイナでのリージョンの作成

ページ・デザイナでリージョンを作成するには、次のステップを実行します。

1. ページ・デザイナで適切なページにナビゲートします。「ページ・デザイナでのページの表示」を参照してください。
ページ・デザイナが表示されます。ページ下部にギャラリが表示されます。コントロールまたはコンポーネントにカーソルをあわせると、それについて説明するツールチップが表示されます。

2. ギャラリからリージョンを選択し、グリッド・レイアウトの適切な場所にドラッグします。
リージョン・タイプに基づいて、次に必要なアクションがページ・デザイナにより指示されます。

「メッセージ」タブには、対応する必要のあるメッセージを示す赤または黄色のバッジが表示されます。「メッセージ」タブには、2つのタイプのメッセージが表示されます

- エラー - エラー・メッセージは赤で表示されます。エラー・メッセージを選択すると、プロパティ・エディタに関連する属性が赤で表示されます。ページを保存する前にエラーに対処する必要があります。

- 警告 - 警告メッセージは黄色で表示されます。警告メッセージを選択すると、プロパティ・エディタで、関連する属性が黄色で表示されます。ページを保存する前にエラーに対処する必要があります。警告メッセージには対処しないでページを保存できることに注意してください。

3. プロパティ・エディタですべての属性を表示します。「プロパティ・エディタ・メニュー」から「すべて表示」を選択します。

4. プロパティ・エディタで該当する属性を編集します。
必要な属性は、属性ラベルの1つ上の左上隅に赤い三角形で表示されます。

ヒント:
属性の詳細は、プロパティ・エディタで属性を選択し、中央ペインで「ヘルプ」タブをクリックして、参照してください。

5. 「保存」をクリックします。

14.5.2 ページ・デザイナでのリージョンの管理

リージョンとは、コンテンツのコンテナとしての役割を持つページ領域のことです。この項では、リージョン属性を編集してページの外観を変更する方法について説明します。

- ページ・デザイナでのリージョン属性の編集

- リージョン位置の制御

- リージョンのヘッダーおよびフッターの指定

- ユーザーによるページのカスタマイズの可能化

- ページ・デザイナでのリージョン・キャッシュの使用

- 静的リージョンIDの指定

- リージョン・イメージの追加

- リージョン表示セレクタの作成

14.5.2.1 ページ・デザイナでのリージョン属性の編集

リージョン属性を編集するには、次のステップを実行します。

1. ページ・デザイナで適切なページにナビゲートします。「ページ・デザイナでのページの表示」を参照してください。
ページ・デザイナが表示されます。

2. 「レンダリング」ツリーまたはグリッド・レイアウトでリージョンを選択します。
プロパティ・エディタに、リージョンの属性が表示されます。

3. プロパティ・エディタですべての属性を表示します。「プロパティ・エディタ・メニュー」から「すべて表示」を選択します。

4. プロパティ・エディタで該当する属性を編集します。
属性の詳細は、フィールドレベル・ヘルプを参照してください。「フィールドレベル・ヘルプの表示」を参照してください。

5. 「保存」をクリックします。

14.5.2.2 リージョン位置の制御

リージョンを作成するとき、プロパティ・エディタで「レイアウト」の「位置」属性を編集することにより、その位置を指定できます。ページのユーザー・インタフェースの現在のテーマ内で定義されているテンプレート位置によって、使用可能な選択肢が決まります。

14.5.2.3 リージョンのヘッダーおよびフッターの指定

リージョンのボディ・コンテンツに加えて、プロパティ・エディタで「ヘッダー」および「フッター」属性を編集することにより、追加の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

14.5.2.4 ユーザーによるページのカスタマイズの可能化

「カスタマイズ」属性を使用すると、リージョンの表示属性をユーザーがカスタマイズできるかどうかを制御できます。この機能を使用するには、ページ・テンプレートのヘッダー、ボディまたはフッター・セクションに#CUSTOMIZE#置換文字列を含める必要があります。

エンド・ユーザーによるカスタマイズが1つ以上のリージョンでサポートされる場合、「カスタマイズ」というリンクがページ・テンプレートで#CUSTOMIZE#置換文字列を含めた場所に表示されます。このリンクをクリックするとウィンドウが表示され、ユーザーは、ページのリージョンを表示または非表示にできます。

関連項目:
「カスタム・テーマの作成」

エンド・ユーザーは次の手順でカスタマイズできます。

1. ページ・デザイナで適切なページにナビゲートします。「ページ・デザイナでのページの表示」を参照してください。
ページ・デザイナが表示されます。

2. 「レンダリング」ツリーまたはグリッド・レイアウトでリージョンを選択します。
プロパティ・エディタに、リージョンの属性が表示されます。

3. 「すべて閉じる」アイコンをクリックし、「プロパティ・エディタ・メニュー」から「すべて表示」を選択します。

4. 「カスタマイズ」を展開します。「カスタマイズ可能」から、次のいずれかを選択します。

- エンドユーザーではカスタマイズ不可

- デフォルトでカスタマイズ可能および非表示

- デフォルトでカスタマイズ可能および表示

5. 「保存」をクリックします。

14.5.2.5 ページ・デザイナでのリージョン・キャッシュの使用

この項では、静的リージョンのパフォーマンス向上のためにリージョン・キャッシュを使用する利点について説明します。

ヒント:
リージョン・キャッシュは、対話モード・レポート・リージョンに対しては使用できません。

- リージョン・キャッシュについて

- ページ・デザイナでのリージョン・キャッシュの有効化

関連項目:
『Oracle Application Express管理ガイド』のページおよびリージョン・キャッシュの管理に関する項

14.5.2.5.1 リージョン・キャッシュについて

リージョン・キャッシュの有効化は、条件を使用しないリストを含むリージョンまたは静的HTMLを含むリージョンなどの静的リージョンのパフォーマンスの向上に効果的な方法です。

リージョン・キャッシュを有効化すると、Application Expressエンジンによって、リージョンを動的にレンダリングするかわりにキャッシュされた(または格納された)リポジトリからリージョンをレンダリングします。実際のセッション識別子はキャッシュされないことに注意してください。かわりに、Application Expressエンジンでは、&SESSION.置換文字列がキャッシュされ、キャッシュされたリージョンをレンダリングしたカレント・セッションが表示時に代入されます。たとえば、リージョンにリンクが含まれ、リンクにセッションが含まれる場合、リンクがすべてのセッションで動作するようにするため、完全なセッションはキャッシュされません。

Application Expressエンジンは、リージョンが定義した条件を満たす場合にのみキャッシュからレンダリングします。また、リージョンは、ユーザーまたはキャッシュされた独立したユーザーに対してのみキャッシュできます。

関連項目:
「サーバー・キャッシュ」

14.5.2.5.2 ページ・デザイナでのリージョン・キャッシュの有効化

リージョン・キャッシュを有効化するには、次のステップを実行します。

1. ページ・デザイナで適切なページにナビゲートします。「ページ・デザイナでのページの表示」を参照してください。
ページ・デザイナが表示されます。

2. 「レンダリング」ツリーまたはグリッド・レイアウトでリージョンを選択します。
プロパティ・エディタに、リージョンの属性が表示されます。

3. 「すべて閉じる」アイコンをクリックし、「プロパティ・エディタ・メニュー」から「すべて表示」を選択します。

4. 「サーバー・キャッシュ」を展開します。「キャッシュ」から次のいずれかを選択します。

- 無効 - コンテンツはキャッシュされず、リクエストごとに計算されます。

- 有効 - コンテンツはキャッシュされ、すべてのユーザーによって利用されます。

- ユーザー別のキャッシュ - コンテンツはユーザーごとにキャッシュされます。

- セッション別のキャッシュ - コンテンツはセッションごとにキャッシュされます。

- キャッシュ・タイムアウト - 「有効」または「ユーザー別のキャッシュ」を選択した場合に表示されます。キャッシュされたページの有効期間を選択します。タイムアウトの場合、後続のページ・リクエストはキャッシュされたページを使用しません。

- タイプ - 条件を指定します。条件がTrueを戻す場合、ページはキャッシュから表示されます。条件がFalseを戻す場合、ページは動的にレンダリングされ、キャッシュから取得されません。

5. 「保存」をクリックします。

14.5.2.6 静的リージョンIDの指定

カスタムJavaScriptまたはカスケード・スタイルシートの作成時に静的リージョンIDを指定すると有用です。リージョンの編集ページの「静的ID」属性を使用して、リージョンを一意に識別できます。リージョン・テンプレート、ヘッダー、フッターまたはボディの#REGION_STATIC_ID#置換文字列を使用してリージョンを参照できます。

静的リージョンIDを含めるには、HTML要素IDとしてリージョン・コンテナ・オブジェクト(表またはDIV)に割り当てます。HTML要素のIDはページ全体で一意である必要があります。たとえば、ページHTMLを有効にしておくため、ボタンとリージョンのIDを同じにすることはできません。

静的リージョンIDを指定するには、次のステップを実行します。

1. ページ・デザイナで適切なページにナビゲートします。「ページ・デザイナでのページの表示」を参照してください。
ページ・デザイナが表示されます。

2. 「レンダリング」ツリーまたはグリッド・レイアウトでリージョンを選択します。
プロパティ・エディタに、リージョンの属性が表示されます。

3. 「すべて閉じる」アイコンをクリックし、「プロパティ・エディタ・メニュー」から「すべて表示」を選択します。

4. 「詳細」を展開し、「静的ID」を見つけます。

5. 「静的ID」に、このリージョンの静的IDを入力します。定義されている場合、これが置換文字列#REGION_STATIC_ID#でリージョンのIDとして使用され、リージョンのカスタムJavaScript動作を開発する際に役立ちます。これが定義されていない場合、リージョンによって内部IDが生成されます。

ヒント:
入力した静的IDをリージョンで使用するには、テンプレートに#REGION_STATIC_ID#置換文字列が含まれている必要があります。

6. 「保存」をクリックします。

14.5.2.7 リージョン・イメージの追加

「リージョン・イメージ」および「イメージ・タグ属性」を使用すると、リージョンの左上にイメージを追加できます。

リージョン・イメージを追加するには、次のステップを実行します。

1. ページ・デザイナで適切なページにナビゲートします。「ページ・デザイナでのページの表示」を参照してください。
ページ・デザイナが表示されます。

2. 「レンダリング」ツリーまたはグリッド・レイアウトでリージョンを選択します。
プロパティ・エディタに、リージョンの属性が表示されます。

3. 「すべて閉じる」アイコンをクリックし、「プロパティ・エディタ・メニュー」から「すべて表示」を選択します。

4. 「詳細」を展開し、次のように指定します。

- リージョン・イメージ - リージョンの左上に表示されるイメージへの参照を入力します。このイメージの表示に使用される表タグを制御することはできません。

- イメージ・タグ属性 - イメージHTMLに含めるイメージ・タグ属性を入力します。これは、高さ、幅またはイメージのALTテキスト(装飾的なイメージではない場合)などの属性に使用できます。
イメージ・タグ属性にALTが定義されていない場合、Application Expressはデフォルトで装飾的なイメージとしてイメージをレンダリングします(空のALTタグなど)。

5. 「保存」をクリックします。

14.5.2.8 リージョン表示セレクタの作成

「リージョン表示セレクタ」リージョンでは、ページの各リージョンに表示と非表示のコントロールを表示できます。

リージョン表示セレクタを作成するには、次のステップを実行します。

1. リージョン・ページ・セレクタに含めるページおよびリージョンを作成します。

2. セレクタに含めるリージョンごとに、「リージョン表示セレクタ」属性で「はい」を選択します。「ページ・デザイナでのリージョンの管理」を参照してください。

3. タイプが「リージョン表示セレクタ」のリージョンを作成します。

1. ギャラリからリージョン・タイプ「リージョン表示セレクタ」を選択し、グリッド・レイアウトの適切な場所にドラッグします。

2. プロパティ・エディタでリージョン属性を編集します。

- 「すべて閉じる」アイコンをクリックし、「プロパティ・エディタ・メニュー」から「すべて表示」を選択します。

- 「指定」を展開し、「タイトル」を編集します。

- 「詳細」を展開し、「リージョン表示セレクタ」で「はい」を選択します。

3. 「保存」をクリックします。

14.5.3 ページ・デザイナでのリージョンのコピー

注意:
「ツリー」タイプのリージョンには複数のリージョンが含まれるため、コピーできません。

リージョンをコピーするには、次のステップを実行します。

1. ページ・デザイナで適切なページにナビゲートします。「ページ・デザイナでのページの表示」を参照してください。
ページ・デザイナが表示されます。

2. グリッド・レイアウトでリージョンを右クリックし、「コピー先」を選択して、サブメニューからコピー先を選択します。

ヒント:
リージョンを別のページにコピーするには、「レンダリング」ツリーでリージョンを選択し、右クリックして「他のページにコピー」を選択します。画面に表示されるステップに従います。

14.5.4 ページ・デザイナでのリージョンの削除

リージョンを削除するには、次のステップを実行します。

1. ページ・デザイナで適切なページにナビゲートします。「ページ・デザイナでのページの表示」を参照してください。
ページ・デザイナが表示されます。

2. 「レンダリング」ツリーで1つ以上のリージョンを選択します。

3. 右クリックして「削除」を選択します。

4. 「保存」をクリックします。

14.6 コンポーネント・ビューでのリージョンの管理

Oracle Application Expressアプリケーションの各ページに、1つ以上のリージョンが含まれます。リージョンはコンテンツのコンテナとして機能します。この項では、リージョンを作成および管理する方法について説明します。

- リージョンの作成ウィザード実行時のリージョン・タイプについて

- コンポーネント・ビューでのリージョンの作成

- コンポーネント・ビューでのリージョンの管理

- リージョン表示セレクタの作成

- コンポーネント・ビューでのリージョンのコピー

- コンポーネント・ビューでのリージョンの削除

関連項目:
「リージョンについて」および「ページ・デザイナでのリージョンの管理」

14.6.1 リージョンの作成ウィザード実行時のリージョン・タイプについて

リージョンの作成時には、リージョン・タイプを選択します。Application Expressエンジンは、選択したリージョン・タイプに応じてリージョンを解釈します。表14-1「リージョンの作成ウィザード実行時のリージョン・タイプ」に、使用可能なリージョン・タイプを示します。使用可能なリージョン・タイプは、選択したユーザー・インタフェース(デスクトップやjQuery Mobileスマートフォンなど)に応じて異なります。

表14-1 リージョンの作成ウィザード実行時のリージョン・タイプ

リージョン・タイプ

説明

デスクトップ

jQuery Mobileスマートフォン

静的コンテンツ

アイテムのコンテナとして機能し、指定したHTMLが含まれます。入力するHTMLには、置換文字列を含めることができます。

使用可能

使用可能

複数の静的コンテンツ

複数の静的コンテンツ・リージョンを一度に作成するには、このオプションを使用します。表示されるフィールドで、各リージョンの順序、タイトル、表示ポイント、レポート・テンプレートおよび列を指定します。

使用可能

使用可能

レポート、対話モード・レポート

SQL問合せの結果がフォーマット化されます。カスタムSQL SELECT文またはSQL問合せ文を戻すPL/SQLファンクションを指定します。SQL問合せの記述が不明な場合は、「クエリー・ビルダー」ボタンをクリックします。

注意: jQuery Mobileスマートフォンは、対話モード・レポートをサポートしません。

関連項目: 「エンド・ユーザーとしての対話モード・レポートのカスタマイズ」

使用可能

使用不可

レポート、クラシック・レポート

SQL問合せの結果がフォーマット化されます。カスタムSQL SELECT文またはSQL問合せを戻すPL/SQLファンクションを指定します。SQL問合せの記述が不明な場合は、「クエリー・ビルダー」ボタンをクリックします。

関連項目: 「レポートの開発」

使用可能

使用可能

レポート、Webサービスの結果のレポート

Webサービスの結果でレポートを作成します。

関連項目: 「Webサービスの実装」

使用可能

使用可能

レポート、リスト・ビュー

リスト・ビューは、スマートフォンでのデータ表示およびナビゲーション用に最適化されています。

SQL問合せの書式設定された結果を含むページを作成します。カスタムSQL SELECT文またはSQL問合せを戻すPL/SQLファンクションを指定します。

注意: デスクトップ・アプリケーションは、リスト・ビューをサポートしません。

使用不可

使用可能

レポート、列切替えレポート

モバイル・アプリケーションのレスポンシブなレポートを作成します。デフォルトでは、列切替えレポートはすべての列が同じ優先度に設定されて作成されます。ただし、開発者はレポート列属性を編集し、重要度に応じて列をランク付けできます。優先度がより低い列は、より狭い幅で表示されます。レポートには、エンド・ユーザーが表示する列を選択できる「列」ボタンが含まれています。

注意: デスクトップ・アプリケーションは、このレポート書式をサポートしません。

使用不可

使用可能

リフロー・レポート

モバイル・アプリケーションのレスポンシブなレポートを作成します。レポートを水平に表示できる十分な領域がない場合、レポートは、表の列を縮小して、各行に対するラベルやデータ・ペアのブロックのような外観の積上げ表示形式にすることによって機能します。

注意: デスクトップ・アプリケーションは、このレポート書式をサポートしません。

使用不可

使用可能

フォーム、プロシージャのフォーム

ストアド・プロシージャの引数に基づくフォームを構築します。ストアド・プロシージャまたはパッケージに実装済のロジックまたはデータ操作言語(DML)が存在する場合は、この方法を使用します。

使用可能

使用可能

フォーム、表またはビューのフォーム

データベース表の単一行を更新できるフォームを作成します。フォームを構築する表を選択できます。

使用可能

使用可能

フォーム、リスト・ビュー付きの表のフォーム

データベース表の単一行を更新できるフォームおよびリスト・ビューを作成します。フォームを構築する表を選択し、リスト・ビューのテキスト表示に使用する列を選択します。

使用不可

使用可能

フォーム、レポート付きの表のフォーム

2つのページを作成します。1つのページにはレポートが表示されます。各行に2ページ目へのリンクが提供され、これを使用して各レコードを更新できます。レポートおよびフォームを構築する表を選択できます。

ヒント: このオプションでは、127列を超える列が含まれている表はサポートされません。127列を超える列を選択すると、エラーが発生します。

使用可能

使用不可

フォーム、マスター・ディテール・フォーム

1つのHTMLフォーム内にマスター行および複数のディテール行を表示するフォームを作成します。ユーザーは2つの表またはビューに対し、値の問合せ、挿入、更新および削除を実行できます。マスター・レポートおよびディテール・フォームを構築する表を選択します。マスター・レポートおよびディテール・フォームを構築する表を選択します。

関連項目: 「マスター・ディテール・フォームの管理」

使用可能

使用不可

フォーム、表形式フォーム

データベース表の複数の行に対して更新、挿入および削除を行うフォームを作成します。フォームを構築する表および列を選択します。

関連項目: 「表形式フォームの管理」

使用可能

使用不可

フォーム、SQL問合せのフォーム

EQUIJOINなどのSQL問合せによって戻される列に基づくフォームを作成します。SQL問合せの記述が不明な場合は、「クエリー・ビルダー」をクリックします。

使用可能

使用可能

フォーム、サマリー・ページ

読取り専用のフォームを作成します。このオプションを使用して、ウィザードの最後に確認ページを作成します。

使用可能

使用可能

フォーム、Webサービスのフォーム

Webサービスの定義に基づいて、アイテムを含むページを作成します。このウィザードでは、ユーザー入力フォーム、Webサービスをコールするプロセスおよび送信ボタンを作成します。

関連項目: 「Webサービスでのフォームの作成」

使用不可

使用可能

フォーム、Webサービスのフォームとレポート

Webサービスの定義に基づいて、アイテムを含むページを作成します。このウィザードでは、ユーザー入力フォーム、Webサービスをコールするプロセスおよび送信ボタンを作成し、レポートに結果を表示します。

関連項目: 「Webサービスでの入力フォームとレポートの作成」

使用可能

使用可能

プラグイン

開発者はプラグインを使用して、Application Expressで使用可能な組込みタイプを宣言的に拡張できます。

参照: 「プラグインの実装」

使用可能

使用可能

チャート

SQL問合せに基づいて線グラフ、棒グラフまたは円グラフを作成します。

関連項目: 「チャートの作成」

使用可能

使用可能

マップ・チャート

宣言的に定義されたFlashマップを作成します。

関連項目: 「マップの作成」

使用可能

使用不可

ツリー

実行時に実行されるSQL問合せに基づいて、階層的なナビゲーション・コントロール(またはツリー)を作成します。

関連項目: ツリーの作成

使用可能

使用不可

カレンダ

月次、週次、日次およびリスト表示のカレンダを含むリージョンを作成します。

関連項目: カレンダの作成

使用可能

使用可能

リスト

リストと呼ばれるリンクの共有コレクションを含むリスト・リージョンを作成します。

参照: 「リストの作成」

使用可能

使用不可

ブレッドクラム

ブレッドクラムを含むリージョンを作成します。ブレッドクラムはリンクの階層リストです。

参照: 「ブレッドクラムの作成」

使用可能

使用可能

PL/SQL動的コンテンツ

PL/SQL WebツールキットでHTMLまたはテキストをレンダリングできるようにする、PL/SQLベースのリージョンを作成します。

使用可能

使用可能

URL

事前定義されたURLを使用してWebサーバーをコールすることでコンテンツを取得する、URLベースのリージョンを作成します。

関連項目: 「他のWebサイトからのコンテンツの組込みについて」

使用可能

使用可能

リージョン表示セレクタ

「リージョン表示セレクタ」リージョンでは、リージョン表示選択が有効化されている、ページの各リージョンに表示と非表示のコントロールを表示できます。

参照: 「リージョン表示セレクタの作成」

使用可能

使用可能

ヘルプ・テキスト

「ヘルプ・テキスト」リージョンでは、アプリケーションにページ・レベルのヘルプを指定できます。

関連項目: 「アプリケーションのヘルプの作成」

使用可能

使用可能

14.6.2 コンポーネント・ビューでのリージョンの作成

「リージョンの作成」ウィザードを実行して、リージョンを作成します。

リージョンを作成するには、次のようにします。

1. 適切なページにナビゲートします。「コンポーネント・ビューでのページの表示」を参照してください。

2. 「リージョン」で、「作成」アイコンをクリックします。
「リージョンの作成」ウィザードが表示されます。

3. リージョン・タイプを選択します。表14-1「リージョンの作成ウィザード実行時のリージョン・タイプ」を参照してください。
「リージョンの作成」ウィザードが表示されます。

4. 画面に表示されるステップに従います。

14.6.3 コンポーネント・ビューでのリージョンの管理

リージョンとは、コンテンツのコンテナとしての役割を持つページ領域のことです。この項では、リージョン属性を編集してページの外観を変更する方法について説明します。

- コンポーネント・ビューでのリージョン属性の編集

- リージョン属性がページ・レイアウトに与える影響

- リージョンのヘッダーおよびフッターの指定

- ユーザーによるページのカスタマイズの可能化

- コンポーネント・ビューでのリージョン・キャッシュの使用

- 静的リージョンIDの指定

- リージョン・イメージの追加

- コンポーネント・ビューでの複数リージョンの同時編集

- コンポーネント・ビューでのサブリージョンの管理

14.6.3.1 コンポーネント・ビューでのリージョン属性の編集

コンポーネント・ビューでリージョン属性を編集するには、次のステップを実行します。

1. 適切なページにナビゲートします。「コンポーネント・ビューでのページの表示」を参照してください。

2. 「リージョン」で、リージョン名を選択します。
リージョンの編集ページ(または、リージョン定義ページ)が表示されます。

注意:
プラグイン・タイプのリージョンの詳細は、「プラグイン・ページからのプラグインのインポート」を参照してください。

3. 対象となる属性を編集します。
属性の詳細は、フィールドレベル・ヘルプを参照してください。「フィールドレベル・ヘルプの表示」を参照してください。

4. 「変更の適用」をクリックします。

関連項目:
「リージョン属性がページ・レイアウトに与える影響」、「リージョン位置の制御」および「リージョンのヘッダーおよびフッターの指定」

14.6.3.2 リージョン属性がページ・レイアウトに与える影響

この項では、リージョン属性によるページの外観およびレイアウトの制御方法について説明します。

- ページ・レイアウトに影響を与えるコンポーネント・ビューのリージョン属性

- リージョン位置の制御

14.6.3.2.1 ページ・レイアウトに影響を与えるコンポーネント・ビューのリージョン属性

表14-2「ページ・レイアウトに影響を与えるリージョン属性」に、ページ・レイアウトに影響を与えるリージョン属性を示します。

表 14-2 ページ・レイアウトに影響を与えるリージョン属性

リージョン、属性

説明

ユーザー・インタフェース、順序

ページ内のリージョンの表示順を指定します。

ユーザー・インタフェース、親リージョン

現在のリージョンが属している親リージョンを定義します。親リージョンを選択することで、2つのリージョン間に親/子関係を作成します。

関連項目: 「コンポーネント・ビューでのサブリージョンの管理」

ユーザー・インタフェース、表示ポイント

ページ内でリージョンを表示する位置を指定します。リージョンは、「表示ポイント」の順序番号順にレンダリングされます。ページ・レイアウトを表示するには、「ビュー」アイコンをクリックして、位置を選択します。

選択可能な表示ポイントは、ページ・レベル・テンプレート(ページ属性)によって決定されます。ページ・レベル・テンプレートを選択しなかった場合は、「アプリケーションの定義」で定義されたデフォルトのページ・レベル・テンプレートが使用されます。

ユーザー・インタフェース、テンプレート

リージョンの外観を決定します。テンプレート属性を表示するには、そのページでテンプレート名をクリックします。

関連項目: 「カスタム・テーマの作成」および「リージョン・テンプレート」

ユーザー・インタフェース、アイテム表示位置

ページ・アイテムをメイン・リージョン・コンテンツの上部に表示するか下部に表示するかを決定します。

グリッド・レイアウト、新規グリッドの開始

このリージョンを新しいグリッドに表示するかまたは以前のリージョンと同じグリッドに表示するかを決定します。

グリッド・レイアウト、新規行の開始

このリージョンを以前のリージョンと同じ行に表示するかまたは次の行に表示するかを決定します。

グリッド・レイアウト、列

リージョンを特定のグリッド列に表示するかどうかを決定します。「自動」を選択すると、リージョンを表示する次の使用可能なグリッド列が自動的に決定されます。

グリッド・レイアウト、列スパン

リージョンによって占有されるグリッド列数を決定します。「自動」を選択すると、同じグリッド行のすべてのリージョン内で使用可能なグリッド列を均一に配置します。

グリッド・レイアウト、列CSSクラス

グリッド列に設定する追加のCSSクラスを入力します。この値によって、グリッド・レイアウト列テンプレートの#CSS_CLASSES#置換プレースホルダが置き換えられます。

グリッド・レイアウト、列属性

グリッド列に設定する追加属性を入力します。この値によって、グリッド・レイアウト列テンプレートの#ATTRIBUTES#置換プレースホルダが置き換えられます。

属性、リージョンのCSSクラス

リージョン・テンプレートに置換文字列#REGION_CSS_CLASSES#が含まれている場合に置換されるスペースで区切られたリストとして、追加のCSSクラスを入力します。

属性、リージョン

置換文字列#REGION_ATTRIBUTES#を含むリージョン・テンプレートは、この値で置換されます。

属性、リージョン表示セレクタ

リージョン表示セレクタを使用して、リージョンが、リージョン表示セレクタのリージョン・タイプに表示されるように指定します。リージョン表示セレクタを使用すると、ページ上のその他のリージョンを非表示にし、特定のリージョンのみを表示することができます。リージョン表示セレクタは、この属性を使用して指定されたリージョンのみを表示します。

属性、リージョン・イメージ

移入されている場合、指定されたイメージがリージョンの左上に表示されます。このイメージの表示に使用される表タグを制御することはできません。

参照: 「リージョン・イメージの追加」

属性、イメージ・タグ属性

「リージョン・イメージ」属性とともに使用します。イメージhtmlに含める属性を入力します。たとえば、高さと幅にこの属性を使用します。

注意: イメージ・タグ属性にALTが定義されていない場合、Oracle Application Expressはデフォルトで装飾的なイメージとしてイメージをレンダリングします(空のALTタグなど)。

参照: 「リージョン・イメージの追加」

ヘッダーおよびフッター

リージョンの最上部(#BODY#コンテンツの直前)に表示されるHTMLテキストを指定します。

条件

リージョンを表示するかどうかを決定する条件および適切な式を定義します。条件では、セッション・ステート、現在ログインしているユーザーまたは環境設定(ページが印刷用ビュー・モードかどうかなど)を参照できます。

関連項目: 「条件付きのレンダリングおよびプロセスの理解」および「印刷用ページの最適化」

読取り専用、読取り専用条件タイプ

このリージョンでページ・アイテムを読取り専用としてレンダリングするために必要な条件タイプをリストから選択します。条件を選択しない場合、ページ・アイテムが通常どおりにレンダリングされます。

注意: 条件タイプを「なし」に設定すると、このリージョンのアイテムは常に入力可能なフィールドとしてレンダリングされます。これは、ページ・レベルで定義した、読取り専用条件をすべて上書きします。

カスタマイズ

エンド・ユーザーによるカスタマイズを可能にします。この機能を使用するには、ページ・テンプレートのヘッダー、ボディまたはフッター・セクションに#CUSTOMIZE#置換文字列を含める必要があります。

関連項目: 「ユーザーによるページのカスタマイズの可能化」

14.6.3.2.2 コンポーネント・ビューでのリージョン位置の制御

リージョンを作成する際に、ページ・テンプレート内でのこのリージョンの位置(「表示ポイント」)を指定する必要があります。表示ポイントに加えて、リージョンを配置する列を指定できます。複数の列にリージョンを配置する場合は、Oracle Application Expressによって必要なHTMLが自動的にレンダリングされ、複数列のレイアウトが生成されます。

14.6.3.3 リージョンのヘッダーおよびフッターの指定

リージョンのボディ・コンテンツ(レポート、チャートまたはフォーム要素付きの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

関連項目:
「リージョンの作成ウィザード実行時のリージョン・タイプについて」

14.6.3.4 ユーザーによるページのカスタマイズの可能化

「カスタマイズ」属性を使用すると、リージョンの表示属性をユーザーがカスタマイズできるかどうかを制御できます。この機能を使用するには、ページ・テンプレートのヘッダー、ボディまたはフッター・セクションに#CUSTOMIZE#置換文字列を含める必要があります。

エンド・ユーザーによるカスタマイズが1つ以上のリージョンでサポートされる場合、「カスタマイズ」というリンクがページ・テンプレートで#CUSTOMIZE#置換文字列を含めた場所に表示されます。このリンクをクリックするとウィンドウが表示され、ユーザーは、ページのリージョンを表示または非表示にできます。

関連項目:
「カスタム・テーマの作成」

エンド・ユーザーは次の手順でカスタマイズできます。

1. ページに移動します。「コンポーネント・ビューでのページの表示」を参照してください。

2. 「リージョン」で、リージョン名を選択します。
リージョンの編集ページが表示されます。

3. 「カスタマイズ」までスクロールして、次のいずれかを選択します。

- デフォルトでカスタマイズ可能および非表示

- デフォルトでカスタマイズ可能および表示

- エンドユーザーではカスタマイズ不可

4. 「カスタマイズ・オプション名」に、ページのこのリージョンをユーザーに示すラベルを入力します。

5. ページ・テンプレートの「ヘッダー」、「ボディ」または「フッター」セクションに#CUSTOMIZE#置換文字列を含めます。

14.6.3.5 コンポーネント・ビューでのリージョン・キャッシュの使用

この項では、ページおよびリージョンのパフォーマンス向上のためにキャッシュを使用する利点について説明します。

ヒント:
リージョン・キャッシュは、対話モード・レポート・リージョンに対しては使用できません。

- リージョン・キャッシュについて

- リージョン・キャッシュの有効化

- キャッシュされたリージョンの管理

関連項目:
『Oracle Application Express管理ガイド』のページおよびリージョン・キャッシュの管理に関する項

14.6.3.5.1 リージョン・キャッシュについて

リージョン・キャッシュの有効化は、条件を使用しないリストを含むリージョンまたは静的HTMLを含むリージョンなどの静的リージョンのパフォーマンスの向上に効果的な方法です。

リージョン・キャッシュを有効化すると、Application Expressエンジンによって、リージョンを動的にレンダリングするかわりにキャッシュされた(または格納された)リポジトリからリージョンをレンダリングします。実際のセッション識別子はキャッシュされないことに注意してください。かわりに、Application Expressエンジンでは、&SESSION.置換文字列がキャッシュされ、キャッシュされたリージョンをレンダリングしたカレント・セッションが表示時に代入されます。たとえば、リージョンにリンクが含まれ、リンクにセッションが含まれる場合、リンクがすべてのセッションで動作するようにするため、完全なセッションはキャッシュされません。

Application Expressエンジンは、リージョンが定義した条件を満たす場合にのみキャッシュからレンダリングします。また、リージョンは、ユーザーまたはキャッシュされた独立したユーザーに対してのみキャッシュできます。

関連項目:
「サーバー・キャッシュ」および「キャッシュされたリージョンの管理」

14.6.3.5.2 リージョン・キャッシュの有効化

リージョン・キャッシュを有効化するには、次のステップを実行します。

1. ページに移動します。
「コンポーネント・ビューでのページの表示」を参照してください。

2. 「リージョン」で、リージョン名を選択します。
リージョンの編集ページが表示されます。

3. 「キャッシュ」までスクロールします。

4. 「キャッシュ」で次のいずれかを選択します。

- 未キャッシュ: この機能を無効にします。

- キャッシュ済: ユーザーとは関係なくリージョンをキャッシュします。

- ユーザー別のキャッシュ: 指定されたユーザーに固有のリージョンをキャッシュします。

5. 「キャッシュ済」または「ユーザー別のキャッシュ」を選択する場合は、次のように指定します。

1. 次の後にキャッシュをタイムアウト: キャッシュされたリージョンが有効な期間を指定します。

2. キャッシュ条件タイプ: リストから条件タイプを選択します。条件がFalseを戻す場合、リージョンは動的にレンダリングされ、キャッシュされません。条件がTrueを戻す場合、リージョンはキャッシュされます。

3. 式1および式2: 選択した特定の条件タイプに基づいて値を入力します。

6. 「変更の適用」をクリックします。

14.6.3.5.3 キャッシュされたリージョンの管理

キャッシュされたリージョンはキャッシュされたリージョン・ページで管理できます。

キャッシュされたリージョン・ページにアクセスするには、次のステップを実行します。

1. ページに移動します。「コンポーネント・ビューでのページの表示」を参照してください。

2. 「ユーティリティ」メニューをクリックし、「キャッシュ」を選択します。

3. リージョン・キャッシュで、「管理」をクリックします。
キャッシュされたリージョン・ページが表示されます。

4. ページ上部の検索バーを使用してページの概観をカスタマイズできます。

5. 消去するリージョンを選択して、次のいずれかをクリックします。

- 期限切れのパージ

- チェックした項目のパージ

6. キャッシュされたリージョンをすべて消去するには、「すべて消去」をクリックします。

関連項目:
『Oracle Application Express管理ガイド』のページおよびリージョン・キャッシュの管理に関する項

14.6.3.6 静的リージョンIDの指定

カスタムJavaScriptまたはカスケード・スタイルシートの作成時に静的リージョンIDを指定すると有用です。リージョンの編集ページの「静的ID」属性を使用して、リージョンを一意に識別できます。リージョン・テンプレート、ヘッダー、フッターまたはボディの#REGION_STATIC_ID#置換文字列を使用してリージョンを参照できます。

静的リージョンIDを含めるには、HTML要素IDとしてリージョン・コンテナ・オブジェクト(表またはDIV)に割り当てます。HTML要素のIDはページ全体で一意である必要があります。たとえば、ページHTMLを有効にしておくため、ボタンとリージョンのIDを同じにすることはできません。

静的リージョンIDを指定するには、次のステップを実行します。

1. 適切なページにナビゲートします。「コンポーネント・ビューでのページの表示」を参照してください。

2. 「リージョン」で、リージョン名を選択します。
リージョンの編集ページが表示されます。

3. 「属性」までスクロールします。

4. 「静的ID」に、このリージョンを識別する値を入力します。この値を参照するには、置換文字列#REGION_STATIC_ID#を使用します。

5. 「変更の適用」をクリックします。

14.6.3.7 リージョン・イメージの追加

「リージョン・イメージ」および「イメージ・タグ属性」を使用すると、リージョンの左上にイメージを追加できます。

リージョン・イメージを追加するには、次のステップを実行します。

1. 適切なページにナビゲートします。「コンポーネント・ビューでのページの表示」を参照してください。

2. 「リージョン」で、リージョン名を選択します。
リージョンの編集ページが表示されます。

3. 「属性」までスクロールします。

4. 「属性」で、次のように指定します。

- リージョン・イメージ: リージョンの左上に表示するイメージを指定します。

- イメージ・タグ属性: イメージhtmlに含める属性を入力します。入力した属性を使用して、高さと幅を指定します。

5. 「変更の適用」をクリックします。

14.6.3.8 コンポーネント・ビューでの複数リージョンの同時編集

この項では、複数のリージョンを同時に編集する方法について説明します。

- すべてのリージョンにわたる複数の属性の編集

- リージョン・ユーティリティへのアクセス

14.6.3.8.1 すべてのリージョンにわたる複数の属性の編集

リージョン・ページを使用すると、順序、列、リージョン名、表示ポイントなど、ページのすべてのリージョンのリージョン属性を更新できます。

関連項目:
リージョン属性についての詳細は、リージョンの編集ページに移動してください。「コンポーネント・ビューでのリージョンの管理」を参照してください。

すべてのリージョンにわたる複数の属性を編集するには、次のステップを実行します。

1. 適切なページにナビゲートします。「コンポーネント・ビューでのページの表示」を参照してください。

2. 「リージョン」で「すべて編集」アイコンをクリックします。「すべて編集」アイコンは、鉛筆が置かれた小さいグリッドの形をしています。
リージョン・ページが表示されます。

3. 適切な属性を更新します。

4. 「変更の適用」をクリックします。

14.6.3.8.2 リージョン・ユーティリティへのアクセス

ユーティリティ・ページを使用すると、選択したアプリケーション内の全ページに対するグリッド編集ページとレポートにアクセスできます。

リージョン・ユーティリティ・ページにアクセスするには、次のステップを実行します。

1. 適切なページにナビゲートします。「コンポーネント・ビューでのページの表示」を参照してください。

2. 「リージョン」で「すべて編集」アイコンをクリックします。「すべて編集」アイコンは、鉛筆が置かれた小さいグリッドの形をしています。
リージョン・ページが表示されます。

3. 「ユーティリティ」をクリックします。

4. ユーティリティを選択して、画面に表示される手順に従います。

関連項目:
「コンポーネント・ビューでのリージョンの管理」

14.6.3.9 コンポーネント・ビューでのサブリージョンの管理

サブリージョンを使用すると、2つのリージョン間に親/子関係を作成できます。サブリージョンは親リージョン内に表示されます。サブリージョンは、リージョンを新規作成するとき、またはリージョン属性を編集するときに、親リージョンを選択することによって作成できます。

- サブリージョンの使用について

- コンポーネント・ビューでのサブリージョンの作成

- リージョン属性の編集によるサブリージョンの作成

14.6.3.9.1 サブリージョンの使用について

このサブリージョンは、様々な方法で使用できます。1つのユースケースとして、情報をグループ化するためにサブリージョンを作成します。たとえば、枠線があるリージョンがあるとします。この機能を使用すると、このリージョン内に2つのクラシック・レポート(サブリージョン)を表示できます。また、サブリージョンを使用して、リージョンをタブまたはアコーディオンとして表示できます。親リージョンとサブリージョンの表示方法を制御するには、リージョン・テンプレートの「サブリージョン」属性を編集します。

関連項目:
「リージョン・テンプレート」

14.6.3.9.2 コンポーネント・ビューでのサブリージョンの作成

サブリージョンを作成するには、次のステップを実行します。

1. 適切なページにナビゲートします。「コンポーネント・ビューでのページの表示」を参照してください。

2. 「リージョン」で、「作成」アイコンをクリックします。

3. リージョン・タイプを選択します。表14-1「リージョンの作成ウィザード実行時のリージョン・タイプ」を参照してください。
「リージョンの作成」ウィザードが表示されます。

4. 「表示属性」で、次のステップを実行します。

1. タイトル - リージョンのタイトルを入力します。選択するリージョン・テンプレートにリージョン・タイトルが表示されると、このタイトルが表示されます。

2. リージョン・テンプレート - リージョンのタイトルを入力します。選択するリージョン・テンプレートにリージョン・タイトルが表示されると、このタイトルが表示されます。

3. 親リージョン - 新しいリージョンが属する親リージョンを選択します。

4. 表示ポイント: このリージョンの表示ポイントを指定します。ページ・テンプレート位置およびページ・ボディ位置という2つのタイプの表示ポイントが存在します。
ページ・テンプレート位置により、ページ・テンプレート内でのリージョンの正確な配置が可能になります。ページ・テンプレート位置は、ページ・テンプレート置換文字列(#REGION_POSITION_01#から#REGION_POSITION_08#)によって制御されます。ページ・ボディ位置は、ページ・テンプレート内の#BODY#置換文字列によって指定される位置に表示されます。

5. 「次へ」をクリックします。

5. 画面に表示されるステップに従います。

14.6.3.9.3 リージョン属性の編集によるサブリージョンの作成

リージョン属性の編集によってサブリージョンを作成するには、次のステップを実行します。

1. 適切なページにナビゲートします。「コンポーネント・ビューでのページの表示」を参照してください。

2. 「リージョン」で、リージョン名を選択します。
リージョンの編集ページが表示されます。

3. 「ユーザー・インタフェース」までスクロールします。

4. 「親リージョン」で、リージョンが属する親リージョンを選択します。

5. 必要に応じて追加の属性を編集します。
属性の詳細は、フィールドレベル・ヘルプを参照してください。「フィールドレベル・ヘルプの表示」を参照してください。

6. 「変更の適用」をクリックします。

関連項目:
「リージョン属性がページ・レイアウトに与える影響」、「リージョン位置の制御」および「リージョンのヘッダーおよびフッターの指定」

14.6.4 リージョン表示セレクタの作成

「リージョン表示セレクタ」リージョンでは、ページの各リージョンに表示と非表示のコントロールを表示できます。

リージョン表示セレクタを作成するには、次のステップを実行します。

1. リージョン・ページ・セレクタに含めるページおよびリージョンを作成します。

2. セレクタに含める各リージョンの「リージョン表示セレクタ」属性を編集します。

1. 適切なページにナビゲートします。「コンポーネント・ビューでのページの表示」を参照してください。

2. 「リージョン」で、リージョン名を選択します。
リージョンの編集ページが表示されます。

3. 「属性」で、「リージョン表示セレクタ」を「はい」に変更します。

4. 「変更の適用」をクリックします。

3. タイプがリージョン表示セレクタのリージョンを作成します。

1. ページに移動します。「コンポーネント・ビューでのページの表示」を参照してください。

2. 「リージョン」で、「作成」アイコンをクリックします。
「リージョンの作成」ウィザードが表示されます。

3. リージョン・タイプ「リージョン表示セレクタ」を選択します。

4. 「作成」をクリックします。

14.6.5 コンポーネント・ビューでのリージョンのコピー

注意:
「ツリー」タイプのリージョンには複数のリージョンが含まれるため、コピーできません。

リージョンをコピーするには、次のステップを実行します。

1. ページに移動します。「コンポーネント・ビューでのページの表示」を参照してください。

2. 「リージョン」で「コピー」アイコンをクリックします。「コピー」アイコンは、小さいページが2つ重なった形をしています。
リージョンのコピー・ウィザードが表示されます。

3. コピーするリージョンを選択します。

4. 「コピー先ページ」で、次のステップを実行します。

1. 「コピー先ページ」から、リージョンのコピー先のページを選択します。

2. ボタンを選択するか、「はい」または「いいえ」を選択することによって、コピーするリージョン・アイテムを選択します(使用可能な場合)。

3. 「次へ」をクリックします。

5. 「リージョンのコピー」をクリックします。

14.6.6 コンポーネント・ビューでのリージョンの削除

この項では、リージョンを削除する方法について説明します。

- リージョンの削除

- 複数リージョンの同時削除

14.6.6.1 リージョンの削除

リージョンを削除するには、次のステップを実行します。

1. 適切なページにナビゲートします。「コンポーネント・ビューでのページの表示」を参照してください。

2. 「リージョン」で、リージョン名を選択します。
リージョンの編集ページが表示されます。

3. 「削除」をクリックします。

14.6.6.2 複数リージョンの同時削除

一度に複数のリージョンを削除するには、次のステップを実行します。

1. 適切なページにナビゲートします。「コンポーネント・ビューでのページの表示」を参照してください。

2. 「すべて編集」アイコンをクリックします。「すべて編集」アイコンは、鉛筆が置かれた小さいグリッドの形をしています。
リージョン・ページが表示されます。

3. 「複数のリージョンの削除」タブをクリックします。

4. 次の項目を指定します。

1. ボタンを削除するカスケード: 「はい」を選択すると、対応するリージョンのボタンが削除されます。

2. アイテムを削除するカスケード: 「はい」を選択すると、対応するリージョンのアイテムが削除されます。

3. 関連付けられたリストおよびリスト・エントリを削除しますか。: 「はい」を選択すると対応するリストが削除されます。このオプションは、削除されるリージョンがこのリストを参照する唯一のリージョンである場合にのみ表示されます。

4. 動的アクションを削除するカスケード: 「はい」を選択すると、対応するリージョン・アイテムが削除されます。

5. 削除するリージョンを選択します。

6. 「変更の適用」をクリックします。

14.7 他の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を取得します。「アプリケーション属性の編集」を参照してください。

また、開発者は、リージョン属性「組入れモード」を使用して、Oracle Application Expressによってコンテンツが取得および表示される方法を制御することもできます。オプションは次のとおりです。

- IFrame - ブラウザによって、HTML iframeにリモート・コンテンツが表示されます。Oracle Application Expressが表示のためにこのコンテンツをデータベースにフェッチする必要はありません。

- インライン(特殊文字をエスケープ) - ページのレンダリング時に、データベースによってリモート・コンテンツがロードされるようにします。その後、リージョンの位置に、フェッチされたデータがインラインで表示されます。クロス・サイト・スクリプティングを回避するために、コンテンツ内のHTML特殊文字はエスケープされます。

- インライン(エスケープなし) - このモードは、HTML文字がエスケープされない点を除いて、インライン(特殊文字をエスケープ)に類似しています。開発者は、リモート・コンテンツが常に安全な場合にのみ、このモードを使用する必要があります。

関連項目:
「ページ・デザイナでのリージョン属性の編集」および「コンポーネント・ビューでのリージョン属性の編集」

SSL有効URLでの作業

SSL有効URL(Webサービスの起動など)をコールする場合、またはSSL有効URLタイプのリージョンを作成する場合、ウォレットを作成する必要があります。ウォレットは、SSLに必要な認証および署名された資格証明(秘密鍵、証明書および信頼できる証明書)の格納に使用されるパスワード保護されたコンテナです。

ヒント:
Oracle Application Express管理ガイドの「ウォレット情報の構成」を参照してください。

14.8 イメージの管理について

アプリケーション内でイメージを参照するには、静的ファイル・リポジトリにイメージをアップロードする必要があります。アップロード・プロセス中に、そのファイルをすべてのアプリケーションで使用可能にするか、特定のアプリケーションでのみ使用可能にするかを指定します。

関連項目:
「静的アプリケーション・ファイルの管理」および「静的ワークスペース・ファイルの管理」

14.9 カスタム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;

15 データベース・アプリケーション・コントロールの管理

この項では、データベース・アプリケーションのページ・コントロール(ページ・レベルのアイテム、動的アクション、ボタン、ツリーを含む)を作成および管理する方法と、JavaScriptを組み込む方法について説明します。

- ページ・レベル・アイテムの理解

- ページ・デザイナでのページ・レベル・アイテムの管理

- コンポーネント・ビューでのページ・レベル・アイテムの管理

- 動的アクションの管理

- ボタンの作成

- ツリーの作成

- アプリケーションへのJavaScriptの組込みについて

関連項目:
「レポートの開発」、「ページ・レイアウトの制御」、「ナビゲーションの追加」および「Oracle Application Expressコンポーネントの手動リフレッシュ」

15.1 ページ・レベル・アイテムの理解

アイテムは、HTMLフォームの一部です。アイテムは、テキスト・フィールド、テキスト領域、パスワード、選択リスト、チェック・ボックスなどを示します。アイテム属性は、ページ上のアイテムの表示に影響します。たとえば、これらの属性は、ラベルの表示位置、アイテムの大きさおよびアイテムの表示位置(前のアイテムの横または下)に影響します。

- ページ・アイテムとアプリケーション・アイテムの違いについて

- アイテムのネーミング規則について

- アイテム値の参照

- JavaScriptを使用したアイテムの参照

- 複数選択リスト・アイテムでの操作

関連項目:
「ページ・デザイナでのページ・レベル・アイテムの管理」および「コンポーネント・ビューでのページ・レベル・アイテムの管理」

15.1.1 ページ・アイテムとアプリケーション・アイテムの違いについて

アイテムには、ページ・アイテムとアプリケーション・アイテムの2つのタイプが存在します。ページ・アイテムはページ上に配置され、「表示のみ」、「ラベル」、「ラベル・テンプレート」などの関連付けられたユーザー・インタフェースのプロパティを持ちます。ページ・レベル・アイテムの例としてはチェック・ボックス、日付ピッカー、テキストとしての表示、「ファイル参照」フィールド、「ポップアップLOV」、「選択リスト」、または「テキスト領域」などがあります。アプリケーション・アイテムはページに関連付けられないため、ユーザー・インタフェースのプロパティを持ちません。アプリケーション・アイテムは、グローバル変数として使用できます。

関連項目:
「アプリケーション・レベル・アイテムの管理」

15.1.2 アイテムのネーミング規則について

アイテム名を指定する場合は、次の規則に注意してください。規則は次のとおりです。

- アプリケーション内で一意である必要があります。

- 引用符を含めることはできません。

- 先頭は文字または数字である必要があります。その後は、文字、数字またはアンダースコア文字を使用できます。

- 大/小文字が区別されません。

- 30文字以内にする必要があります。30文字を超えるアイテムは、バインド変数構文を使用して参照できません。「バインド変数構文を使用したセッション・ステートの参照」を参照してください。

- 基本ASCIIキャラクタ・セット以外の文字を含めることはできません。

アイテム名を指定する場合は、ページ番号を含めることをお薦めします。デフォルトでは、ウィザードによってページ・アイテム名の先頭にP<page no>_<item name>が付けられます(たとえば、P1_NAME)。

15.1.3 アイテム値の参照

リージョン、計算、プロセス、検証およびブランチのセッション・ステートに格納されたアイテム値を参照できます。表 15-1に、アイテム値を参照するためにサポートされている構文を示します。

関連項目:
「セッション・ステート値の管理」

表15-1アイテム値を参照するための構文

タイプ

構文

説明

SQL

:MY_ITEM

名前が30バイト以下のアイテム用の標準のバインド変数構文。この構文は、SQL問合せおよびPL/SQLコード内の参照用に使用します。

PL/SQL

V('MY_ITEM')

Vファンクションを使用してアイテム値を参照するPL/SQL構文。この構文は、パッケージまたはストアド・プロシージャやファンクションのPL/SQLコードで使用します。

この構文をSQL文で使用しないでください。使用すると、パフォーマンスの問題が発生する場合があります。

関連項目: Oracle Application Express APIリファレンス

PL/SQL

NV('MY_NUMERIC_ITEM')

NVファンクションを使用して数値アイテム値を参照する標準のPL/SQL構文。この構文は、パッケージまたはストアド・プロシージャやファンクションのPL/SQLコードで使用します。

この構文をSQL文で使用しないでください。使用すると、パフォーマンスの問題が発生する場合があります。

関連項目: Oracle Application Express APIリファレンス

静的テキスト(完全置換)

&MY_ITEM.

静的テキスト。完全置換です。

注意: 正確な置換構文をSQLまたはPL/SQLコードで使用しないでください。使用すると、SQLインジェクションに対して脆弱になる可能性があります。

次のいずれかの方法を使用すると、アプリケーションのアイテム値を設定できます。

- ページ・レベル・アイテムの場合、ソース属性を使用してアイテム値を設定します。
ページから、アイテム名を選択してページ・アイテムの編集ページを表示します。「ソース」までスクロールして、該当するフィールドを編集します。

次の構文を使用して、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);
F

関連項目:
「セッション・ステートのクリア」、『Oracle Application Express APIリファレンス』および「クロスサイト・スクリプティング保護の理解」

15.1.4 JavaScriptを使用したアイテムの参照

アイテムを参照する場合、最も有効な方法は、IDで参照する方法です。WebブラウザでOracle Application ExpressページのHTMLソースを表示すると、すべてのアイテムにID属性が含まれていることがわかります。このIDは、アイテム・ラベルではなく、アイテム名に対応します。たとえば、P1_FIRST_NAMEという名前で、First Nameというラベルを持つアイテムを作成した場合、IDはP1_FIRST_NAMEになります。

JavaScriptファンクション$v('P1_FIRST_NAME')と$s('P1_FIRST_NAME', 'Joe');を使用して、アイテム属性と値を取得および設定できます。次に例を示します。

function showFirstName(){
alert('First Name is ' +$v('P1_FIRST_NAME'))
};
function setFirstName(pFirstName){
$s('P1_FIRST_NAME', pFirstName);
};

これらのファンクションは、他のJavaScriptファンクションにより、またはJavaScriptコードの実行動的アクションを使用してコールできます。

関連項目:
『Oracle Application Express APIリファレンス』のAPEX_JAVASCRIPTに関する説明

15.1.5 複数選択リスト・アイテムでの操作

この項では、複数の選択リスト・アイテムから返された値を処理する方法について説明します。

- 複数の選択リスト・アイテムから返された値の処理について

- APEX_UTIL.STRING_TO_TABLEを使用した選択値の変換

- シャトル・アイテムの作成

15.1.5.1 複数の選択リスト・アイテムから返された値の処理について

複数選択アイテムは複数選択リストのフォーム要素としてレンダリングされ、複数選択リストまたはシャトル・アイテム・タイプのいずれかになります。送信されると、選択した値は単一のコロンで区切られた文字列に戻されます。このフォーマットの値は3通りの方法で処理できます。

- INSTRファンクションの使用

- APEX_UTIL.STRING_TO_TABLEファンクションの使用

- シャトルの作成

15.1.5.2 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ファンクション」

15.1.5.3 シャトル・アイテムの作成

この項では、シャトル・アイテム・タイプを作成する方法について説明します。まず、DEPT表に、特定の部門に割り当てられている従業員を示すレポートおよびフォームを作成します。次に、従業員を部門に割り当てやすくするために従業員をアルファベット順に一覧表示するシャトル・アイテムを作成します。

- 表でのレポートおよびフォームの作成

- ページ・デザイナのフォーム・ページでのシャトル・アイテムの作成

- コンポーネント・ビューのフォーム・ページでのシャトル・アイテムの作成

15.1.5.3.1 表でのレポートおよびフォームの作成

表でレポートおよびフォームを作成するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「ページの作成」をクリックします。

4. 「ページの作成」で、次のステップを実行します。

1. ユーザー・インタフェース - 「デスクトップ」を選択します。

2. ページ・タイプの選択: 「フォーム」を選択します。

3. 「次へ」をクリックします。

5. 「レポート付きの表のフォーム」を選択して「次へ」をクリックします。

6. 「レポート・ページ属性」で、次のステップを実行します。

1. 必要に応じて属性を編集します。

2. 「次へ」をクリックします。

7. 「データ・ソース」で、次のステップを実行します。

1. 表/ビューの所有者 - レポートを作成している表の所有者を選択します。

2. 表/ビューの名前 - DEPTを選択します。

3. 「次へ」をクリックします。

8. 残りのデフォルト値を受け入れ、画面に表示されるステップに従います。
オプションの詳細は、フィールドレベル・ヘルプを参照してください。「フィールドレベル・ヘルプの表示」を参照してください。

15.1.5.3.2 ページ・デザイナのフォーム・ページでのシャトル・アイテムの作成

フォーム・ページでシャトルを作成するには、次のステップを実行します。

1. フォーム・ページに移動して、ページ・デザイナで表示します。「フィールドレベル・ヘルプの表示」を参照してください。

2. 「ページ・レンダリング」で、フォームを含むリージョンをクリックして「ページ・アイテムの作成」を選択します。
次に、「プロパティ・エディタ - ページ・アイテム」に属性を入力します。

3. 「指定」で、次の項目を指定します。

1. 名前 - PX_EMP_LISTを入力します。

ヒント:
この例では、アイテム名(P2_EMP_LISTなど)のPXはアイテムが存在するページを示しています。

2. タイプ - 「シャトル」を選択します。

4. 「LOV」で、次のステップを実行します。

1. タイプ - 「SQL問合せ」を選択します。

2. SQL文 - 次を入力します。

SELECT ename, empno FROM emp ORDER BY 1

5. 「ソース」で、次の項目を指定します。

1. タイプ - 「SQL問合せ(コロン区切りの値を返す)」を選択します。

2. SQL問合せ - 次を入力します。

SELECT empno FROM emp WHERE deptno = :P2_DEPTNO ORDER BY ename

6. 「ソース」で、次の項目を指定します。

- タイプ - 「SQL問合せ(コロン区切りの値を返す)」を選択します

- アイテム・ソース値: 次のように入力します。

SELECT empno FROM emp WHERE deptno = :P8_DEPTNO ORDER BY ename

7. 「保存」をクリックします。

8. 保存と実行をクリックして、ページを表示します。

15.1.5.3.3 コンポーネント・ビューのフォーム・ページでのシャトル・アイテムの作成

コンポーネント・ビューのフォーム・ページでシャトルを作成するには、次のステップを実行します。

1. フォーム・ページに移動して、コンポーネント・ビューで表示します。「コンポーネント・ビューでのページの表示」を参照してください。

2. 「アイテム」で、「作成」をクリックします。

3. 「アイテム・タイプ」で、「シャトル」を選択して「次へ」をクリックします。

4. 「アイテム名」で、PX_EMP_LISTを入力して「次へ」をクリックします。

ヒント:
この例では、アイテム名(P2_EMP_LISTなど)のPXはアイテムが存在するページを示しています。

5. 「アイテム属性」で、デフォルト値を受け入れ、「次へ」をクリックします。

6. 「設定」で、デフォルト値を受け入れ、「次へ」をクリックします。

7. 「LOV」で、次のようにします。

- LOV問合せ: 次のように入力します。

SELECT ename, empno FROM emp ORDER BY 1

- 「次へ」をクリックします。

8. 「LOV」で、次のようにします。

- ソース・タイプ - 「SQL問合せ(コロン区切りの値を返す)」を選択します

- アイテム・ソース値: 次のように入力します。

SELECT empno FROM emp WHERE deptno = :P8_DEPTNO ORDER BY ename

- 「アイテムの作成」をクリックします。

9. 「実行」をクリックして、ページを表示します。シャトル・アイテムが次の図のように表示されます。

15.2 ページ・デザイナでのページ・レベル・アイテムの管理

アイテムは、HTMLフォームの一部です。アイテムは、テキスト・フィールド、テキスト領域、パスワード、選択リスト、チェック・ボックスなどを示します。この項では、ページ・デザイナでページ・レベル・アイテムを作成する方法について説明します。

- ページ・デザイナでのページ・レベル・アイテムの表示

- ページ・レベル・アイテムの作成

- ページ・デザイナでのページ・レベル・アイテムの編集

関連項目:
「ページ・レベル・アイテムの理解」および「コンポーネント・ビューでのページ・レベル・アイテムの管理」

15.2.1 ページ・デザイナでのページ・レベル・アイテムの表示

アイテム属性は、ページ上のアイテムの表示に影響します。たとえば、これらの属性は、ラベルの表示位置、アイテムの大きさおよびアイテムの表示位置(前のアイテムの横または下)に影響します。

ページ・デザイナでページ・レベル属性を表示するには、次のステップを実行します。

1. ページ・デザイナでアイテムを含むページを表示します。「ページ・デザイナでのページの表示」を参照してください。

2. プロパティ・エディタですべての属性を表示します。「プロパティ・エディタ・メニュー」から「すべて表示」を選択します。

3. プロパティ・エディタで該当する属性を編集します。

ヒント:
属性の詳細は、プロパティ・エディタで属性を選択し、中央ペインで「ヘルプ」タブをクリックして、参照してください。

4. 「保存」をクリックします。

5. 保存と実行をクリックして、ページを表示します。シャトル・アイテムが次の図のように表示されます。

15.2.2 ページ・レベル・アイテムの作成

この項では、アイテムの作成ウィザードを実行して、ページ・レベル・アイテムを作成する方法について説明します。

- 「レンダリング」ツリーからのページ・レベル・アイテムの作成

- 「ギャラリ」からのページ・レベル・アイテムの追加

- 静的値リストの作成

- カスケードLOVの作成

関連項目:
「ページ・アイテムとアプリケーション・アイテムの違いについて」

15.2.2.1 「レンダリング」ツリーからのページ・レベル・アイテムの作成

「レンダリング」ツリーからページ・レベル・アイテムを作成するには、次のステップを実行します。

1. ページ・デザイナでアイテムを含めるページを表示します。「ページ・デザイナでのページの表示」を参照してください。

2. 必要に応じて、アイテムを含めるリージョンを作成します。「リージョンについて」を参照してください。

3. 「レンダリング」ツリーで、アイテムを含めるリージョンを右クリックし、「ページ・アイテムの作成」を選択します。
「プロパティ・エディタ - ページ・アイテム」が表示されます。

「メッセージ」タブに、対処が必要なメッセージを示す赤または黄色の印が表示されます。メッセージを選択すると、プロパティ・エディタに関連する属性が表示されます。赤いエラー・メッセージは、保存する前に対処する必要があります。

4. プロパティ・エディタですべての属性を表示します。「プロパティ・エディタ・メニュー」から「すべて表示」を選択します。

5. プロパティ・エディタで該当する属性を編集します。

ヒント:
属性の詳細は、プロパティ・エディタで属性を選択し、中央ペインで「ヘルプ」タブをクリックして、参照してください。

6. 「保存」をクリックします。

15.2.2.2 「ギャラリ」からのページ・レベル・アイテムの追加

「ギャラリ」から追加することによってページ・レベル・アイテムを作成するには、次のステップを実行します。

1. ページ・デザイナでアイテムを含めるページを表示します。「ページ・デザイナでのページの表示」を参照してください。

2. 必要に応じて、アイテムを含めるリージョンを作成します。「リージョンについて」を参照してください。

3. 「ギャラリ」で、「アイテム」タブをクリックします。
アイテムの上にカーソルを置くと、説明のツールチップが表示されます。

4. 「グリッド・レイアウト」でアイテムを選択し、適切な場所にドラッグします。

ヒント:
アイテムを右クリックし、「追加先」をクリックして、適切な場所を選択することもできます。

「プロパティ・エディタ - ページ・アイテム」が表示されます。

「メッセージ」タブに、対処が必要なメッセージを示す赤または黄色の印が表示されます。メッセージを選択すると、プロパティ・エディタに関連する属性が表示されます。赤いエラー・メッセージは、保存する前に対処する必要があります。

5. プロパティ・エディタですべての属性を表示します。「プロパティ・エディタ・メニュー」から「すべて表示」を選択します。

6. プロパティ・エディタで該当する属性を編集します。

ヒント:
属性の詳細は、プロパティ・エディタで属性を選択し、中央ペインで「ヘルプ」タブをクリックして、参照してください。

7. 「保存」をクリックします。

15.2.2.3 静的値リストの作成

静的値リストを作成する方法の1つに、アイテムのLOV定義の編集があります。このタイプのLOVは再使用できないことに注意してください。LOVをいつでも使用可能な共有コンポーネントとして作成することをお薦めします。

関連項目:
「アプリケーション・レベルでのLOVの作成」

静的値リストを作成するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。「ページ・デザイナでのページの表示」を参照してください。

2. 新規アイテムを作成します。「「レンダリング」ツリーからのページ・レベル・アイテムの作成」および「「ギャラリ」からのページ・レベル・アイテムの追加」を参照してください。

3. プロパティ・エディタですべての属性を表示します。「プロパティ・エディタ・メニュー」から「すべて表示」を選択します。

4. プロパティ・エディタで該当する属性を編集します。

ヒント:
属性の詳細は、プロパティ・エディタで属性を選択し、中央ペインで「ヘルプ」タブをクリックして、参照してください。

5. 「指定」で、次の項目を指定します。

1. 名前 - 名前を入力します。「アイテムのネーミング規則について」を参照してください。

2. タイプ - 「選択リスト」を選択します。

6. 「LOV」で、次のステップを実行します。

1. タイプ - 「静的値」を選択します。

2. 静的値 - 次の構文を使用して、この静的値リストのテキストを入力します。

STATIC[2]:Display Value[;Return Value],Display Value[;Return Value]

説明:

- 最初のキーワードはSTATICまたはSTATIC2になります。
テキストがSTATIC:で始まる場合、リスト値はアルファベット順に表示されます。また、テキストがSTATIC2:で始まる場合、リスト値はテキストに指定した順序と同じ順序で表示されます。

- セミコロンは各エントリで表示値と戻り値を区切ります。

- Return Valueはオプションです。Return Valueが含まれない場合、戻り値は表示値と同じになります。

7. 「保存」をクリックします。

8. 保存と実行をクリックして、ページを表示します。
次に例として、3つの異なる静的値リストに対する構文を示します。

15.2.2.3.1 例1: アルファベット順で表示される4つの値

この例では、アルファベット順で表示される4つの値(Cow、Dog、Cat、Lion)が値リストにあります。各エントリの戻り値は表示値と同じです。

STATIC:Cow,Dog,Cat,Lion

15.2.2.3.2 例2: リストされた順序で表示される10の値

この例では、定義にリストされた順序で表示される10の値が値リストにあります。各エントリの戻り値は表示値と同じです。

STATIC2:10,15,20,25,50,100,200,500,1000,10000

15.2.2.3.3 例3: 戻り値と表示値の両方を持つ値リスト

この例では、YesとNoという2つの値が値リストにあります(表示値Yesとその戻り値Y、表示値Noとその戻り値N)。

STATIC:Yes;Y,No;N

15.2.2.4 カスケードLOVの作成

カスケードLOVを作成すると、ページ上の1つのアイテムによって別のアイテムのLOVが決定されます。アプリケーション・ビルダーでは、選択リスト、シャトル、チェック・ボックス、ラジオ・グループ、ポップアップLOVおよびリスト・マネージャの各アイテム・タイプに対して、カスケードLOVがサポートされています。

カスケードLOVは、2つのアイテムを作成することによって作成します。2つ目のアイテムに値を移入するには、アイテムの作成ウィザードを実行しているときか、またはアイテムの属性を編集することによって、カスケードLOV親アイテムを指定します。

次の例では、2つの関連する選択リストを作成する方法を示します。この場合、最初のリストの値が2つ目のリストに移入されます。

値のカスケード・リストを作成するには、次の手順を実行します。

1. 最初のアイテムを作成し、そのアイテムにP1_DEPTNOという名前を付けます。

1. 選択リスト・アイテムを作成します。

2. 「指定」の「タイプ」で、「選択リスト」を選択します。

3. 「指定」で、次のステップを実行します。

- 名前 - 次を入力します。

P1_DEPTNO

- タイプ - 「選択リスト」を選択します。

4. 「ラベル」で、次のように入力します。

- ラベル - 次を入力します。

Department

5. 「LOV」で、次のようにします。

- タイプ - 「SQL問合せ」を選択します。

- 「SQL問合せ」で、次を入力します。

SELECT dname as d,
deptno as r
FROM dept
ORDER BY dname

- NULL値の表示 - 「はい」を選択します。

- NULL表示値 - 入力/選択します。

- Select Department -

6. 残りのデフォルト値を受け入れます。

7. 「保存」をクリックします。

2. P1_EMPNOという名前の2つ目のアイテムを作成します。

1. 選択リスト・アイテムを作成します。

2. 「指定」の「タイプ」で、「選択リスト」を選択します。

3. 「指定」で、次のステップを実行します。

- 名前 - 次を入力します。

P1_EMPNO

- タイプ - 「選択リスト」を選択します。

4. 「ラベル」で、次のように入力します。

- ラベル - 次を入力します。

Employee

5. 「LOV」で、次のようにします。

- タイプ - 「SQL問合せ」を選択します。

- 「SQL問合せ」で、次を入力します。

SELECT ename as d,
empno as r
FROM emp
WHERE deptno = :P1_DEPTNO
ORDER BY ename

- NULL値の表示 - 「はい」を選択します。

- NULL表示値 - 入力/選択します。

- Select Employee -

6. 残りのデフォルト値を受け入れます。

7. 「保存」をクリックします。

2つの選択リストが表示されます。「Department」選択リストで選択を行うと、「Employees」選択リストに表示される個人が決定されます。

15.2.3 ページ・デザイナでのページ・レベル・アイテムの編集

この項では、ページ・デザイナでページ・レベル・アイテムを編集する方法について説明します。

- プロパティ・エディタでのページ・アイテム属性の編集

- デフォルト値の定義

- ページ・アイテムのセキュリティの構成

- クイック選択の作成

- 条件付きページ・アイテムの表示

- 読取り専用ページ・アイテムの表示

- アイテム・ユーティリティの表示

15.2.3.1 プロパティ・エディタでのページ・アイテム属性の編集

プロパティ・エディタでアイテム属性を編集するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。「ページ・デザイナでのページ・レベル・アイテムの表示」を参照してください。
ページ・デザイナが表示されます。

2. 「レンダリング」ツリーまたは「グリッド・レイアウト」で、編集するアイテムを選択します。
プロパティ・エディタの表示が「プロパティ・エディタ - ページ・アイテム」に変わります。

3. プロパティ・エディタですべての属性を表示します。「プロパティ・エディタ・メニュー」から「すべて表示」を選択します。

4. 対象となる属性を編集します。
ページ上の特定の属性の詳細を表示するには、属性ラベルをクリックします。「フィールドレベル・ヘルプの表示」を参照してください。

15.2.3.2 デフォルト値の定義

アイテムのデフォルト値は、ページ・アイテムの編集ページの「デフォルト」の下にある属性を使用して定義します。デフォルト値は、アイテムの値がセッション・ステートから導出されない場合およびソース値がNULLの場合に使用されます。

アイテムのデフォルト値を定義するには、次のステップを実行します。

1. プロパティ・エディタでアイテム属性を表示します。「プロパティ・エディタでのページ・アイテム属性の編集」を参照してください。

2. プロパティ・エディタですべての属性を表示します。「プロパティ・エディタ・メニュー」から「すべて表示」を選択します。

3. 「デフォルト」を見つけて展開します。

4. 「デフォルト」で、次のステップを実行します。

1. デフォルト・タイプを選択します。

- 静的値

- PL/SQL式

- PL/SQLファンクション本体

2. 表示されたフィールドに、必要に応じて値またはコードを入力します。

ヒント:
属性の詳細は、プロパティ・エディタで属性を選択し、中央ペインで「ヘルプ」タブをクリックして、参照してください。

5. 「保存」をクリックします。

15.2.3.3 ページ・アイテムのセキュリティの構成

ページ・アイテムのセキュリティを構成するには、次のステップを実行します。

1. プロパティ・エディタでアイテム属性を表示します。「プロパティ・エディタでのページ・アイテム属性の編集」を参照してください。

2. プロパティ・エディタですべての属性を表示します。「プロパティ・エディタ・メニュー」から「すべて表示」を選択します。

3. 「セキュリティ」を見つけて展開します。

4. 表15-2に示すように「セキュリティ」属性を構成します。

表15-2 「プロパティ・エディタ - ページ・アイテム」の「セキュリティ」

属性

説明

認可スキーム

認可スキームを選択します(この認可スキームがTRUEと評価された場合はこのコンポーネントがレンダリングされ、そうでない場合は処理されます)。

関連項目: 「認可を介したセキュリティの提供」

セッション・ステート保護

「セッション・ステート保護」レベルを選択します。オプションは次のとおりです。

- 制限なし: URLまたはフォームでアイテムを渡して、アイテムを設定できます。URLにチェックサムは必要ありません。

- 制限付き - ブラウザから設定できない:URLまたはPOSTDATAを使用してアイテムを変更できません。アイテムの値を内部プロセス、計算などに設定できる方法を制限する場合は、このオプションを使用します。この属性は、データ・エントリ・アイテムとして使用できないアイテムのみに適用され、セッション・ステート保護が無効になっていても常に監視されます。
この属性は、「表示形式」タイプが「表示のみ」(状態の保存=なし)および「テキスト・フィールド」(無効、状態は保存されない)である、アプリケーション・アイテムまたはページ・アイテムに対して使用します。

「セッション・ステート保護」が有効な場合、これらの追加属性がアイテムに適用される場合があります。

- チェックサムが必要 - アプリケーション・レベル: ワークスペースおよびアプリケーション固有のチェックサムも入力する場合は、URLでアイテムを渡して、アイテムを設定できます。

- チェックサムが必要 - ユーザー・レベル: ワークスペース、アプリケーションおよびユーザー固有のチェックサムも入力する場合は、URLでアイテムを渡して、アイテムを設定できます。

- チェックサムが必要 - セッション・レベル: カレント・セッション固有のチェックサムも入力する場合は、URLでアイテムを渡して、アイテムを設定できます。

関連項目: 「セッション・ステート保護の理解」

セッション・ステートに暗号化された値を保存

セッション・ステートに格納する際、このアイテムを暗号化するかどうかを指定します。アイテムのコンテンツに機密データが含まれる場合、Application Expressセッション・ステート管理表に格納する際に値を暗号化する必要があります。そうしないと、Application Expressメタデータ表を読み取る権限を持つユーザーが問合せを記述し、この機密データを抽出する可能性があります。

最大4000バイトの長さの値を暗号化できます。4000バイトを超える値を暗号化しようとすると、エラー・メッセージが表示されます。

特殊文字をエスケープ

この属性は、いくつかのアイテム・タイプでのみ表示されます。クロスサイト・スクリプティング(XSS)攻撃を防ぐには、「はい」を選択します。ページ・アイテムまたはLOVのエントリに格納されているHTMLタグを実際にレンダリングする場合は、「いいえ」を選択します。

関連項目: 「クロスサイト・スクリプティング保護の理解」

制限付き文字

セッション・ステートに保存できる文字を制限するには、この属性を使用します。選択された文字制限に一致しないデータをユーザーが保存しようとすると、Oracle Application Expressからエラー・メッセージが表示されます。使用可能なオプションは次のとおりです。

- - すべての文字を許可 -
制限は適用されません。

- a-Z、0-9と空白のホワイトリスト
文字a-z、A-Z、0-9および空白のみ許可されます。

- ブラックリストHTMLコマンド文字(<>")。
予約済のHTML文字は許可されません。

- ブラックリスト&<>"/;,*|=%および--
&、<、>、"、/、;、","、*、|、=、%および"--" (PL/SQLコメント)は許可されません。

- ブラックリスト&<>"/;,*|=%または--と改行
&、<、>、"、/、;、","、*、|、=、%、"--"、および改行文字は許可されません。

関連項目: 「クロスサイト・スクリプティング保護の理解」

15.2.3.4 クイック選択の作成

アイテム・タイプでクイック選択がサポートされている場合は、「クイック選択」属性を使用して、特定のアイテムの下に表示される選択項目を最大10個定義できます。クイック選択をクリックすると、アイテムの値が設定されます。次の例は、5%、10%、15%および20%のクイック選択を示しています。

クイック選択を作成するには、次のステップを実行します。

1. プロパティ・エディタでアイテム属性を表示します。「プロパティ・エディタでのページ・アイテム属性の編集」を参照してください。

2. プロパティ・エディタですべての属性を表示します。「プロパティ・エディタ・メニュー」から「すべて表示」を選択します。

ヒント:
属性の詳細は、プロパティ・エディタで属性を選択し、中央ペインで「ヘルプ」タブをクリックして、参照してください。

3. 「クイック選択」で、次のステップを実行します。

1. クリック選択の表示 - 「はい」を選択します。

2. リンク属性 - 各クイック選択リンクの表示に関連付けるHTML属性を入力します。

3. ラベル X - 各クイック選択のラベルを入力します。このラベルは、アプリケーションのエンド・ユーザーに表示されるテキストです。

4. 値 X - 各クイック選択に関連付ける値を入力します。ユーザーがクイック選択をクリックすると、この値で既存のアイテム値が置換されます。

4. 「保存」をクリックします。

15.2.3.5 条件付きページ・アイテムの表示

条件付きアイテムを表示するには、次のステップを実行します。

1. プロパティ・エディタでアイテム属性を表示します。「プロパティ・エディタでのページ・アイテム属性の編集」を参照してください。

2. プロパティ・エディタですべての属性を表示します。「プロパティ・エディタ・メニュー」から「すべて表示」を選択します。

ヒント:
属性の詳細は、プロパティ・エディタで属性を選択し、中央ペインで「ヘルプ」タブをクリックして、参照してください。

3. 「条件」を展開します。条件タイプを選択し、表示されたフィールドに適切な情報を入力します。

4. 「保存」をクリックします。

15.2.3.6 読取り専用ページ・アイテムの表示

読取り専用アイテムを表示するには、次のステップを実行します。

1. プロパティ・エディタでアイテム属性を表示します。「プロパティ・エディタでのページ・アイテム属性の編集」を参照してください。

2. プロパティ・エディタですべての属性を表示します。「プロパティ・エディタ・メニュー」から「すべて表示」を選択します。

ヒント:
属性の詳細は、プロパティ・エディタで属性を選択し、中央ペインで「ヘルプ」タブをクリックして、参照してください。

3. プロパティ・エディタで該当する属性を編集します。

4. 「読取り専用」を展開します。「読取り専用」を選択し、表示されたフィールドに適切な情報を入力します。

5. 「保存」をクリックします。

15.2.3.7 アイテム・ユーティリティの表示

ユーティリティ・ページには、グリッド編集ページが含まれ、選択したアプリケーション内の複数のページのアイテムを編集できるユーティリティが表示されます。

ユーティリティ・ページにアクセスするには、次のステップを実行します。

1. 該当するアプリケーションにナビゲートします。

2. 「ユーティリティ」をクリックします。

3. 「ページ固有のユーティリティ」リージョンで、「アイテム・ユーティリティ」をクリックします。

4. 次のいずれかのレポートを選択します。

- すべてのアイテム・ラベルのグリッド編集

- すべてのアイテム・ヘルプ・テキストのグリッド編集

- アイテム・ヘルプのサブスクリプション

- すべてのページ・アイテム

- 条件付きアイテム

15.3 コンポーネント・ビューでのページ・レベル・アイテムの管理

アイテムは、HTMLフォームの一部です。アイテムは、テキスト・フィールド、テキスト領域、パスワード、選択リスト、チェック・ボックスなどを示します。この項では、コンポーネント・ビューでページ・レベル・アイテムを作成する方法について説明します。

- コンポーネント・ビューでのページ・レベル・アイテムの表示

- コンポーネント・ビューでのページ・レベル・アイテムの作成

- コンポーネント・ビューでのページ・レベル・アイテムの編集

関連項目:
「ページ・レベル・アイテムの理解」および「ページ・デザイナでのページ・レベル・アイテムの管理」

15.3.1 コンポーネント・ビューでのページ・レベル・アイテムの表示

この項では、ページ・レベル・アイテムの作成方法と編集方法について説明します。

コンポーネント・ビューでは、アイテムがセクション「アイテム」の下に表示されます。アイテムを編集、コピーおよび作成するには、セクション・タイトルの横にある次のアイコンをクリックします。

- すべて編集 - 「すべて編集」アイコンは、鉛筆が置かれた小さいグリッドの形をしています。すべてのアイテムを一度に編集する場合に、このアイコンを使用します。「複数のアイテムの同時編集」を参照してください。

- コピー - 「コピー」アイコンは、小さいページが2つ重なった形をしています。既存のアイテムをコピーする場合に、このアイコンを使用します。

- 作成 - 「作成」アイコンは、プラス(+)記号が置かれた小さいページの形をしています。アイテムを作成する場合に、このアイコンを使用します。

アイテムはリージョンごとに編成されます。アイテムを編集するには、アイテム名をクリックします。

関連項目:
「コンポーネント・ビューでのページ・アイテム属性の編集」

15.3.2 コンポーネント・ビューでのページ・レベル・アイテムの作成

この項では、アイテムの作成ウィザードを実行して、ページ・レベル・アイテムを作成する方法について説明します。

- コンポーネント・ビューでのページ・レベル・アイテムの作成

- 静的値リストの作成

- カスケードLOVの作成

- 表形式フォームを使用した複数のアイテムの作成

関連項目:
「ページ・アイテムとアプリケーション・アイテムの違いについて」および「アイテム・タイプについて」

15.3.2.1 コンポーネント・ビューでのページ・レベル・アイテムの作成

ページ・レベル・アイテムを作成するには、次のステップを実行します。

1. 適切なページにナビゲートします。「コンポーネント・ビューでのページの表示」を参照してください。

2. 必要に応じて、リージョンを作成します。「リージョンについて」を参照してください。

3. 「アイテム」で、「作成」アイコンをクリックします。
アイテムの作成ウィザードが表示されます。

4. 「アイテムの作成」で、次のステップを実行します。

1. アイテム・タイプ - アイテム・タイプを選択します。「アイテム・タイプについて」を参照してください。
ポップアップLOV、カラー・ピッカーまたはポップアップ計算機付きテキスト・フィールドを作成する場合は、「ポップアップLOV」を選択し、特定のポップアップLOVタイプを選択します。

2. 非サポートの表示 - 「いいえ」を選択すると、カレント・ページのユーザー・インタフェース用に設計されているアイテム・タイプのみが表示されます。「はい」を選択すると、他のユーザー・インタフェース用に設計されているその他のアイテム・タイプが表示されます。

3. 「次へ」をクリックします。

アイテム・タイプを選択します。「アイテム・タイプについて」を参照してください。

5. 「表示位置および名前」で、次のステップを実行します。

1. アイテム名 - アイテム名を入力します。この名前によって、アイテムの値を取得するためのハンドルが提供されます。30文字以上のアイテム名はバインド変数構文を使用して参照できません。「アイテムのネーミング規則について」を参照してください。

2. 順序: このコンポーネントの順序を指定します。これによって評価の順序が決まります。

3. リージョン - アイテムが配置されるリージョンを決定します。

4. 「次へ」をクリックします。

6. 画面に表示されるステップに従います。

7. 属性の詳細は、フィールドレベル・ヘルプを参照してください。「フィールドレベル・ヘルプの表示」を参照してください。

15.3.2.2 静的値リストの作成

静的値リストを作成する方法の1つに、アイテムのLOV定義の編集があります。このタイプのLOVは再使用できないことに注意してください。LOVをいつでも使用可能な共有コンポーネントとして作成することをお薦めします。

関連項目:
「アプリケーション・レベルでのLOVの作成」

静的値リストを作成するには、次のステップを実行します。

1. 適切なページにナビゲートします。「コンポーネント・ビューでのページの表示」を参照してください。

2. 必要に応じて、リージョンを作成します。「リージョンについて」を参照してください。

3. 「アイテム」で、「作成」アイコンをクリックします。
アイテムの作成ウィザードが表示されます。

4. 「アイテムの作成」で、次のステップを実行します。

1. アイテム・タイプ - 「選択リスト」を選択します。

2. 非サポートの表示 - 「いいえ」を選択すると、カレント・ページのユーザー・インタフェース用に設計されているアイテム・タイプのみが表示されます。「はい」を選択すると、他のユーザー・インタフェース用に設計されているその他のアイテム・タイプが表示されます。

3. 「次へ」をクリックします。

アイテム・タイプを選択します。「アイテム・タイプについて」を参照してください。

5. 「表示位置および名前」で、次のステップを実行します。

1. アイテム名 - アイテム名を入力します。この名前によって、アイテムの値を取得するためのハンドルが提供されます。30文字以上のアイテム名はバインド変数構文を使用して参照できません。「アイテムのネーミング規則について」を参照してください。

2. 順序: このコンポーネントの順序を指定します。これによって評価の順序が決まります。

3. リージョン - アイテムが配置されるリージョンを決定します。

4. 「次へ」をクリックします。

6. 「アイテム属性」で、次のステップを実行します。

1. ラベル - アイテム・ラベルを入力します。ラベルは、アイテムが表示される際に、その横に表示されるテキストです。ラベルが不要な場合は、ラベル属性を空白のままにします。

2. 高さ - アイテム表示の行の高さの数値を入力します。大部分のアイテムでは、これは1です。

3. テンプレート - オプションで、アイテムの表示を制御するフィールド・テンプレートを選択します。

4. 「次へ」をクリックします。

7. 「設定」で、次の項目を指定します。

1. 必須の値 - 「はい」に設定し、ページ・アイテムが表示されている場合、Application Expressでは、ページの送信時にNOT NULL検証が自動的に実行されます。

ヒント:
「共有コンポーネント」の「テキスト・メッセージ」でメッセージAPEX.PAGE_ITEM_IS_REQUIREDを定義すると、事前定義されたエラー・テキストをアプリケーション固有のエラー・テキストに置換できます。メッセージの表示位置は、アプリケーション・レベル設定の「デフォルトのエラー表示位置」によって定義します。

2. 選択時のページ・アクション - LOVから複数の値を選択できるようにするか、単一の値を選択できるようにするかを指定します。複数の値の場合、カンマ区切りのリストで返されます。

3. 複数選択を許可 - LOVから複数の値を選択できるようにするか、単一の値を選択できるようにするかを指定します。複数の値の場合、カンマ区切りのリストで返されます。

4. 「次へ」をクリックします。

8. 「LOV」で、次のようにします。

1. 「名前付きLOV」で、「名前付きLOVの選択」を選択します。

2. LOV問合せ - 次の構文を使用して問合せを入力します。

STATIC[2]:Display Value[;Return Value],Display Value[;Return Value]

説明:

- 最初のキーワードはSTATICまたはSTATIC2になります。
STATICでは、値が表示値のアルファベット順でソートされます。STATIC2では、値がリストに入力された順序で表示されます。

- セミコロンは各エントリで表示値と戻り値を区切ります。

- Return Valueはオプションです。Return Valueが含まれない場合、戻り値は表示値と同じになります。

3. 残りの属性を編集し、「次へ」をクリックします。

9. 必要に応じて残りの属性を編集し、「アイテムの作成」をクリックします。
次に例として、3つの異なる静的値リストに対する構文を示します。

15.3.2.2.1 例1: アルファベット順で表示される4つの値

この例では、アルファベット順で表示される4つの値(Cow、Dog、Cat、Lion)が値リストにあります。各エントリの戻り値は表示値と同じです。

STATIC:Cow,Dog,Cat,Lion

15.3.2.2.2 例2: リストされた順序で表示される10の値

この例では、定義にリストされた順序で表示される10の値が値リストにあります。各エントリの戻り値は表示値と同じです。

STATIC2:10,15,20,25,50,100,200,500,1000,10000

15.3.2.2.3 例3: 戻り値と表示値の両方を持つ値リスト

この例では、YesとNoという2つの値が値リストにあります(表示値Yesとその戻り値Y、表示値Noとその戻り値N)。

STATIC:Yes;Y,No;N

15.3.2.3 カスケードLOVの作成

カスケードLOVを作成すると、ページ上の1つのアイテムによって別のアイテムのLOVが決定されます。アプリケーション・ビルダーでは、選択リスト、シャトル、チェック・ボックス、ラジオ・グループ、ポップアップLOVおよびリスト・マネージャの各アイテム・タイプに対して、カスケードLOVがサポートされています。アイテム・タイプの詳細は、「アイテム・タイプについて」を参照してください。

カスケードLOVは、2つのアイテムを作成することによって作成します。2つ目のアイテムに値を移入するには、アイテムの作成ウィザードを実行しているときか、またはアイテムの属性を編集することによって、カスケードLOV親アイテムを指定します。

次の項では、2つの関連する選択リストを作成する方法を示します。この場合、最初のリストの値が2つ目のリストに移入されます。

値のカスケード・リストを作成するには、次の手順を実行します。

1. 最初のアイテムを作成し、そのアイテムにP1_DEPTNOという名前を付けます。

1. 適切なページにナビゲートします。「コンポーネント・ビューでのページの表示」を参照してください。

2. 必要に応じて、リージョンを作成します。「リージョンについて」を参照してください。

3. 「アイテム」で、「作成」アイコンをクリックします。
アイテムの作成ウィザードが表示されます。

4. 「アイテム・タイプ」で、「選択リスト」を選択します。

5. 「表示位置および名前」で、次のステップを実行します。

- アイテム名 - 次のように入力します。

P1_DEPTNO

- 残りのデフォルト値を受け入れ、「次へ」をクリックします。

6. 「アイテム属性」で、次のステップを実行します。

- ラベル - 「Department」と入力します

- 残りのデフォルト値を受け入れ、「次へ」をクリックします。

7. 「設定」で、デフォルト値を受け入れ、「次へ」をクリックします。

8. 「LOV」で、次のようにします。

- NULL値の表示: デフォルトの「はい」を受け入れます。

- NULL表示値: 「- Select Department -」と入力します。

- Select Department -

- 「LOV定義」で、次のように入力します。

SELECT dname as d,
deptno as r
FROM dept
ORDER BY dname

- 「次へ」をクリックします。

9. 残りのデフォルト値を受け入れます。

10. 「アイテムの作成」をクリックします。

2. P1_EMPNOという名前の2つ目のアイテムを作成します。

1. 適切なページにナビゲートします。「コンポーネント・ビューでのページの表示」を参照してください。

2. 必要に応じて、リージョンを作成します。「リージョンについて」を参照してください。

3. 「アイテム」で、「作成」アイコンをクリックします。
アイテムの作成ウィザードが表示されます。

4. 「アイテム・タイプ」で、「選択リスト」を選択します。

5. 「表示位置および名前」で、次のステップを実行します。

- アイテム名 - 次のように入力します。

P1_EMPNO

- 残りのデフォルト値を受け入れ、「次へ」をクリックします。

6. 「アイテム属性」で、次のステップを実行します。

- ラベル - 「Employee」と入力します。

- 残りのデフォルト値を受け入れ、「次へ」をクリックします。

7. 「設定」で、デフォルト値を受け入れ、「次へ」をクリックします。

8. 「LOV」で、次のようにします。

- NULL値の表示: デフォルトの「はい」を受け入れます。

- NULL表示値: 「- Select Department -」と入力します。

- Select Employee -

- カスケードLOV親アイテム: 「P1_DEPTNO」を選択します。

- 「LOV定義」で、次のように入力します。

SELECT ename as d,
empno as r
FROM emp
WHERE deptno = :P1_DEPTNO
ORDER BY ename

- 「次へ」をクリックします。

9. 残りのデフォルト値を受け入れます。

10. 「アイテムの作成」をクリックします。

3. 「実行」をクリックし、レンダリングされたページを表示します。
2つの選択リストが表示されます。「Department」選択リストで選択を行うと、「Employees」選択リストに表示される個人が決定されます。

関連項目:
「コンポーネント・ビューでのページ・レベル・アイテムの編集」

15.3.2.4 表形式フォームを使用した複数のアイテムの作成

複数のアイテムを同時に作成するには、次のステップを実行します。

1. 適切なページにナビゲートします。「コンポーネント・ビューでのページの表示」を参照してください。

2. 必要に応じて、リージョンを作成します。「リージョンについて」を参照してください。

3. アイテムの作成ウィザードにアクセスします。「アイテム」で、「作成」アイコンをクリックします。
アイテムの作成ウィザードが表示されます。

4. ページ下部の「表形式フォームを使用した複数アイテムの作成」リンクをクリックします。

5. 複数のアイテムの作成ページで、次のように指定します。

1. リージョンにアイテムの作成: アイテムを含めるリージョンを選択します。

2. アイテム・テンプレート: アイテム・テンプレートを選択します。

3. 各アイテムの「順序」、「名前」、「ラベル」、「タイプ」を入力し、アイテムがキャッシュする必要があるかどうかを指定します。

6. 「複数のアイテムの作成」をクリックします。

15.3.3 コンポーネント・ビューでのページ・レベル・アイテムの編集

ページ・アイテム属性を編集するか、または「すべて編集」アイコンか「アイテムの順序変更」アイコンを使用して、ページ・レベル・アイテムを編集できます。

- コンポーネント・ビューでのページ・アイテム属性の編集

- デフォルト値の定義

- ページ・アイテムのセキュリティの構成

- クイック選択の作成

- 条件付きページ・アイテムの表示

- 読取り専用ページ・アイテムの表示

- 複数のアイテムの同時編集

関連項目:
「アイテム・タイプについて」

15.3.3.1 コンポーネント・ビューでのページ・アイテム属性の編集

作成したページ・アイテムは、「ページ・アイテムの編集」ページで編集できます。

ページ・アイテム属性を編集するには、次のステップを実行します。

1. 適切なページにナビゲートします。「コンポーネント・ビューでのページの表示」を参照してください。

2. 「アイテム」で、アイテム名を選択します。
「ページ・アイテムの編集」ページが表示されます。

3. 属性の詳細は、フィールドレベル・ヘルプを参照してください。「フィールドレベル・ヘルプの表示」を参照してください。

4. 「変更の適用」をクリックします。

関連項目:
「クロスサイト・スクリプティング保護の理解」

15.3.3.2 デフォルト値の定義

アイテムのデフォルト値は、ページ・アイテムの編集ページの「デフォルト」の下にある属性を使用して定義します。デフォルト値は、アイテムの値がセッション・ステートから導出されない場合およびソース値がNULLの場合に使用されます。

アイテムのデフォルト値を定義するには、次のステップを実行します。

1. アイテムを作成します。「コンポーネント・ビューでのページ・レベル・アイテムの作成」を参照してください。

2. アイテム属性を表示します。「アイテム」で、アイテム名を選択します。
「ページ・アイテムの編集」ページが表示されます。

3. 「デフォルト」までスクロールします。

4. 「デフォルト値のタイプ」で、次のいずれかを選択します。

- セッション・ステートの置換機能付き静的テキスト

- PL/SQLファンクション本体

- PL/SQL式

5. 「デフォルト値」で、選択に基づいて値またはコードを入力します。

6. 「変更の適用」をクリックします。

15.3.3.3 ページ・アイテムのセキュリティの構成

「ページ・アイテムの編集」ページで、「セキュリティ」リージョンのアイテムのセキュリティを構成できます。

ページ・アイテムのセキュリティを構成するには、次のステップを実行します。

1. アイテムを作成します。「コンポーネント・ビューでのページ・レベル・アイテムの作成」を参照してください。

2. アイテム属性を表示します。「アイテム」で、アイテム名を選択します。
「ページ・アイテムの編集」ページが表示されます。

3. 「セキュリティ」までスクロールします。

4. 表15-3に示す属性を構成します。

表15-3 「ページ・アイテムの編集」の「セキュリティ」

属性

説明

認可スキーム

認可スキームを選択します(この認可スキームがTRUEと評価された場合はこのコンポーネントがレンダリングされ、そうでない場合は処理されます)。

関連項目: 「認可を介したセキュリティの提供」

セッション・ステート保護

「セッション・ステート保護」レベルを選択します。オプションは次のとおりです。

- 制限なし: URLまたはフォームでアイテムを渡して、アイテムを設定できます。URLにチェックサムは必要ありません。

- 制限付き - ブラウザから設定できない:URLまたはPOSTDATAを使用してアイテムを変更できません。アイテムの値を内部プロセス、計算などに設定できる方法を制限する場合は、このオプションを使用します。この属性は、データ・エントリ・アイテムとして使用できないアイテムのみに適用され、セッション・ステート保護が無効になっていても常に監視されます。
この属性は、「表示形式」タイプが「表示のみ」(状態の保存=なし)、「テキスト・フィールド」(無効、状態は保存されない)、および「グリッド・レイアウドの停止と開始」(ラベルのみ表示)である、アプリケーション・アイテムまたはページ・アイテムに対して使用します。

「セッション・ステート保護」が有効な場合、これらの追加属性がアイテムに適用される場合があります。

- チェックサムが必要 - アプリケーション・レベル: ワークスペースおよびアプリケーション固有のチェックサムも入力する場合は、URLでアイテムを渡して、アイテムを設定できます。

- チェックサムが必要 - ユーザー・レベル: ワークスペース、アプリケーションおよびユーザー固有のチェックサムも入力する場合は、URLでアイテムを渡して、アイテムを設定できます。

- チェックサムが必要 - セッション・レベル: カレント・セッション固有のチェックサムも入力する場合は、URLでアイテムを渡して、アイテムを設定できます。

関連項目: 「セッション・ステート保護の理解」

セッション・ステートに暗号化された値を保存

機密のセッション・ステートは、Application Expressセッション・ステート管理表に格納するときに暗号化することができます。このアイテムの暗号化されたセッション・ステートを保持するには、この値を「はい」に設定します。

最大4000バイトの長さの値を暗号化できます。4000バイトを超える値を暗号化しようとすると、エラー・メッセージが表示されます。

特殊文字をエスケープ

この属性は、いくつかのアイテム・タイプでのみ表示されます。クロスサイト・スクリプティング(XSS)攻撃を防ぐには、「はい」を選択します。ページ・アイテムまたはLOVのエントリに格納されているHTMLタグを実際にレンダリングする場合は、「いいえ」を選択します。

関連項目: 「クロスサイト・スクリプティング保護の理解」

制限付き文字

セッション・ステートに保存できる文字を制限するには、この属性を使用します。選択された文字制限に一致しないデータをユーザーが保存しようとすると、Oracle Application Expressからエラー・メッセージが表示されます。使用可能なオプションは次のとおりです。

- - すべての文字を許可 -
制限は適用されません。

- a-Z、0-9と空白のホワイトリスト
文字a-z、A-Z、0-9および空白のみ許可されます。

- ブラックリストHTMLコマンド文字(<>")。
予約済のHTML文字は許可されません。

- ブラックリスト&<>"/;,*|=%および--
&、<、>、"、/、;、","、*、|、=、%および"--" (PL/SQLコメント)は許可されません。

- ブラックリスト&<>"/;,*|=%または--と改行
&、<、>、"、/、;、","、*、|、=、%、"--"、および改行文字は許可されません。

関連項目: 「クロスサイト・スクリプティング保護の理解」

15.3.3.4 クイック選択の作成

アイテム・タイプでクイック選択がサポートされている場合は、「クイック選択」属性を使用して、特定のアイテムの下に表示される選択項目を最大10個定義できます。クイック選択をクリックすると、アイテムの値が設定されます。次の例は、5%、10%、15%および20%のクイック選択を示しています。

クイック選択を作成するには、次のステップを実行します。

1. アイテムを作成します。「コンポーネント・ビューでのページ・レベル・アイテムの作成」を参照してください。

2. アイテム属性を表示します。「アイテム」で、アイテム名を選択します。
「ページ・アイテムの編集」ページが表示されます。

3. 「クイック選択」までスクロールします。

4. 「クリック選択の表示」で、「はい」を選択します。

5. 各クイック選択のラベルと値を定義します。

1. 「ラベル」で、各選択項目に表示するラベルを入力します。

2. 「値」で、対応する値を入力します。

6. 「リンク属性」で、クイック選択の追加属性を入力します。

7. 「変更の適用」をクリックします。

15.3.3.5 条件付きページ・アイテムの表示

条件付きアイテムを表示するには、次のステップを実行します。

1. アイテムを作成します。「コンポーネント・ビューでのページ・レベル・アイテムの作成」を参照してください。

2. アイテム属性を表示します。「アイテム」で、アイテム名を選択します。
「ページ・アイテムの編集」ページが表示されます。

3. 「条件」までスクロールします。

4. 「条件タイプ」リストから選択します。

5. 表示されるフィールドに式を入力します。

6. 「変更の適用」をクリックします。

15.3.3.6 読取り専用ページ・アイテムの表示

読取り専用アイテムを表示するには、次のステップを実行します。

1. アイテムを作成します。「コンポーネント・ビューでのページ・レベル・アイテムの作成」を参照してください。

2. アイテム属性を表示します。「アイテム」で、アイテム名を選択します。
「ページ・アイテムの編集」ページが表示されます。

3. 「読取り専用」までスクロールします。「読取り専用」で、次のステップを実行します。

1. 「読取り専用条件タイプ」から選択します。
アイテムのタイプに応じ、読取り専用アイテムはプレイン・テキストまたは入力不可フィールドとしてレンダリングされます。条件を選択しない場合、アイテムは通常どおりレンダリングされます。

ヒント:
条件タイプを「なし」に設定すると、アイテムは常に入力可能なフィールドとしてレンダリングされます。この設定では、リージョンまたはページ・レベルで定義した読取り専用条件設定がすべて上書きされます。

2. 表示されるフィールドに式を入力します。

3. 「読取り専用の要素表のセル属性」で、HTML表セル・タグ<td>に含める属性を入力します。このタグには、読取り専用モードで表示される際のアイテムも含まれます。次に例を示します。

bgcolor="#FF0000"

ヒント:
読取り専用の要素表のセル属性は、アプリケーションでリージョンおよびページ・アイテムのレイアウトにHTML表を使用する場合のみ、表示されます。

4. 「変更の適用」をクリックします。

15.3.3.7 複数のアイテムの同時編集

アイテム属性でページ上のアイテムの表示方法を制御します。ページ・アイテム・ページを使用して順序、フィールド・ラベル、テンプレート、リージョン、およびページ上のすべてのアイテムの全体的な配置を編集できます。次に続くセクションでは、これらのページを使用したアイテムの編集方法について説明します。

- 複数のアイテムの編集

- リージョン・アイテムの再割当て

- 複数のアイテムの削除

- アイテム・ユーティリティの表示

- ページ・アイテム履歴の表示

15.3.3.7.1 複数のアイテムの編集

複数のアイテムを同時に編集するには、次のステップを実行します。

1. アイテムを含むページにナビゲートします。「コンポーネント・ビューでのページの表示」を参照してください。

2. ページ・アイテム・ページにアクセスします。「アイテム」で、「すべて編集」アイコンをクリックします。「すべて編集」アイコンは、鉛筆が置かれた小さいページの形をしています。
「アイテム」タブが表示されます。

ページ上部にナビゲーション・バーが表示されます。他のページにナビゲートするには、「ページ」フィールドを使用します。「名前」フィールドを使用して、特定のアイテムを検索します。表示を特定のリージョンのアイテムのみに限定するには、「リージョン」リストから選択します。

関連項目:
「コンポーネント・ビューでのページ・アイテム属性の編集」

ページ・アイテム・ページには、編集可能なレポートのアイテムが表示されます。表15-4に、編集可能な属性を示します。

表 15-4 ページ・アイテム上の編集可能な属性

属性

説明

Sequence

このコンポーネントの表示順序を指定します。これによって評価の順序が決まります。

プロンプト

HTMLフォーム要素のラベルを入力します。HTML、JavaScriptおよびショートカットを含めることができます。置換文字列#CURRENT_ITEM_NAME#を使用して、このラベルに関連するアイテムの名前を取得することもできます。

フィールド・テンプレート

ラベル・テンプレートを決定します。ラベル・テンプレートを使用すると、中心部のユーザー・インタフェースの属性の定義、および多くのラベル間での定義の共有ができます。

リージョン

アイテムを表示するリージョンを定義します。すべてのアイテムは、リージョンに存在します。

新しい行

前のアイテムと同じ行に表示するかどうか、または次の行に表示するかどうかを決定します。アイテムはHTML表に配置されます。表の新しい行の第1フィールドとしてアイテムを表示する場合は、「はい」を選択します。

新規フィールド

「はい」に設定すると、このアイテムは固有のHTML表セル(デフォルト)にレンダリングされます。「いいえ」に設定すると、アイテムは前のページ・アイテムと同じHTML表セルにレンダリングされます。

同じ表セルにレンダリングする方が、前のページ・アイテムとの関連性が高く見えます。

幅

このアイテムに対して表示されるフォーム要素の長さを(文字で)指定します。

高さ

テキスト領域および複数の選択リストのための高さを(列で)指定します。

列スパン

アイテムは、HTML表に配置されます。このプロパティは表セルのCOLSPAN属性に使用される値を定義します。

行スパン

アイテムは、HTML表に配置されます。この属性はアイテムを表示する表セルのROWSPAN属性に使用される値を定義します。

PostElement

テキストまたはHTMLコードがページ・アイテム要素の直後にレンダリングされます。

15.3.3.7.2 リージョン・アイテムの再割当て

リージョン・アイテムの再割当てページを使用してアイテムを新しいリージョンに割り当てます。

リージョン・アイテムの再割当てページで新しいリージョンにアイテムを割り当てるには、次のステップを実行します。

1. アイテムを含むページにナビゲートします。「コンポーネント・ビューでのページの表示」を参照してください。

2. ページ・アイテム・ページにアクセスします。「アイテム」で、「すべて編集」アイコンをクリックします。「すべて編集」アイコンは、鉛筆が置かれた小さいページの形をしています。

3. 「リージョン・アイテムの再割当て」をクリックします。
リージョン・アイテムの再割当てページが表示されます。

ページ上部のナビゲーション・バーを使用して、表示を縮小または拡大します。使用可能なオプションは次のとおりです。

- ページ: 新しい番号を選択または入力して「実行」をクリックします。

- リージョンの表示: 表示するリージョンを選択して「実行」をクリックします。

4. アイテムを他のリージョンに再割当てするには、次のステップを実行します。

1. 再割当てするアイテムを選択します。

2. 「リージョンへの割当て」から、新しいリージョンを選択します。

3. 「再割当て」をクリックします。

15.3.3.7.3 複数のアイテムの削除

複数のアイテムを一度に削除するには、複数のアイテムの削除ページを使用します。

複数のアイテムを削除するには、次のステップを実行します。

1. アイテムを含むページにナビゲートします。「コンポーネント・ビューでのページの表示」を参照してください。

2. ページ・アイテム・ページにアクセスします。「アイテム」で、「すべて編集」アイコンをクリックします。「すべて編集」アイコンは、鉛筆が置かれた小さいページの形をしています。

3. 「複数のアイテムの削除」をクリックします。
複数のアイテムの削除ページが表示されます。

ページ上部のナビゲーション・バーを使用して、表示を縮小または拡大します。新しいページにナビゲートするには、「ページ」フィールドを使用します。新しい番号を選択または入力して「実行」をクリックします。

4. アイテムを削除するには、次のステップを実行します。

1. アイテムを選択します。

2. 「アイテムの削除」をクリックします。

15.3.3.7.4 アイテム・ユーティリティの表示

ユーティリティ・ページには、グリッド編集ページが含まれ、選択したアプリケーション内の複数のページのアイテムを編集できるユーティリティが表示されます。

ユーティリティ・ページにアクセスするには、次のステップを実行します。

1. アイテムを含むページにナビゲートします。「コンポーネント・ビューでのページの表示」を参照してください。

2. ページ・アイテム・ページにアクセスします。「アイテム」で、「すべて編集」アイコンをクリックします。「すべて編集」アイコンは、鉛筆が置かれた小さいページの形をしています。

3. 「ユーティリティ」をクリックします。

4. 次のいずれかのレポートを選択します。

- すべてのアイテム・ラベルのグリッド編集

- すべてのアイテム・ヘルプ・テキストのグリッド編集

- アイテム・ヘルプのサブスクリプション

- すべてのページ・アイテム

- 条件付きアイテム

15.3.3.7.5 ページ・アイテム履歴の表示

履歴ページを使用してページ・レベル・アイテムに対して行われた最近の編集の概要を表示します。

履歴ページにアクセスするには、次のステップを実行します。

1. アイテムを含むページにナビゲートします。「コンポーネント・ビューでのページの表示」を参照してください。

2. ページ・アイテム・ページにアクセスします。「アイテム」で、「すべて編集」アイコンをクリックします。「すべて編集」アイコンは、鉛筆が置かれた小さいページの形をしています。

3. 「履歴」をクリックします。
ページ・アイテム履歴ページが表示されます。

15.4 動的アクションの管理

このセクションでは、動的アクションの概要と、動的アクションの作成および変更方法について説明します。

- 動的アクションについて

- プラグインの例の表示

- 動的アクション・イベントについて

- ページ・デザイナでの動的アクションの管理

- コンポーネント・ビューでの動的アクションの管理

- 動的アクションを使用したJavaScriptのコールについて

- 動的アクションのデバッグ

関連項目:
「ページ固有のユーティリティへのアクセス」

15.4.1 動的アクションについて

動的アクションは、JavaScriptを必要としないで複雑なクライアント側の動作を宣言的に定義する方法を提供します。動的アクションの作成ウィザードを使用して、定義された条件セットが発生したときに実行されるアクションを指定します。また、アクションの影響を受ける要素や、影響を受ける時期と影響も指定できます。

動的アクションを使用するとき、ページに追加する動的アクションが多くなるほど全体のページ・サイズが大きくなることに注意する必要があります。これは、動的アクション・フレームワークでは、定義された各動的アクションについてクライアントへの追加コードを生成し、そのコードはクライアント内のフレームワークによってダウンロードおよび実行される必要があるためです。問題をデバッグする方法についての情報は、「動的アクションのデバッグ」を参照してください。

動的アクションを実装するプロセスには、次の手順があります。

1. ページ上で、アイテム、ボタン、リージョン、JavaScript式またはjQueryセレクタを編集または作成します。このコンポーネントは、起動される時期を定義する際、動的アクション内で参照されます。

2. アクションを起動するアプリケーション・ページから動的アクションを作成します。

3. 動的アクションをテストするためにアプリケーションを実行します。

動的アクションの実装例については、次の場所にあるLearning Libraryに移動し、「All Content」タブをクリックして、Application Express(APEX)製品OBEの検索基準を入力します。

http://www.oracle.com/technetwork/tutorials/index.html

15.4.2 プラグインの例の表示

動的アクションの実装例については、次の場所にあるLearning Libraryに移動し、「All Content」タブをクリックして、Application Express (APEX)製品OBEの検索基準を入力します。

http://www.oracle.com/technetwork/tutorials/index.html

15.4.3 動的アクション・イベントについて

ページで発生するイベントに基づいて起動する動的アクションを定義できます。Oracle Application Expressには、ブラウザ・イベント、フレームワーク・イベント、コンポーネント・イベントおよびカスタム・イベントの4種類のカテゴリが含まれています。この項では、サポートされるすべてのイベントについて説明します(JavaScriptの内部イベント名をカッコで示します)。

ブラウザ・イベント

注意:
ページの現在のユーザー・インタフェース・タイプに応じて、表示されるイベントは異なります。別のタイプに対応するイベントを選択する場合、現在のタイプに対応しないものも含むすべてのイベントを表示する「非サポートの表示」を選択できます。

- 変更(change): コントロールが入力フォーカスを失い、フォーカスの取得後に値が変更された場合に起動します。サポートされているユーザー・インタフェース・タイプ: デスクトップおよびjQuery Mobileスマートフォン。

- クリック(click): ポインティング・デバイスのボタンがトリガー要素上でクリックされたときに起動します。サポートされているユーザー・インタフェース・タイプ: デスクトップおよびjQuery Mobileスマートフォン。

- ダブルクリック(dblclick): ポインティング・デバイスのボタンがトリガー要素上でダブルクリックされたときに起動します。サポートされているユーザー・インタフェース・タイプ: デスクトップ。

- フォーカスを取得(focusing): ポインティング・デバイスまたは要素へのタブによる移動によってトリガー要素がフォーカスを受け取ったときに起動します。サポートされているユーザー・インタフェース・タイプ: デスクトップおよびjQuery Mobileスマートフォン。

- キー・ダウン(keydown): キーボード上のキーが押されたときに起動します。矢印キーなどの特殊なキーストロークを(キーが押された後に)取得するときにこのイベントを使用します。サポートされているユーザー・インタフェース・タイプ: デスクトップおよびjQuery Mobileスマートフォン。

- キー・プレス(keypress): キーボード上のキーが押され、結果としてテキストが入力されたときに起動します。実際のテキスト入力を取得するときにこのイベントを使用します。サポートされているユーザー・インタフェース・タイプ: デスクトップおよびjQuery Mobileスマートフォン。

- キー・リリース(keyup): キーボード上のキーが解放されたときに起動します。矢印キーなどの特殊なキーストロークを(キーが解放された後に)取得するときにこのイベントを使用します。サポートされているユーザー・インタフェース・タイプ: デスクトップおよびjQuery Mobileスマートフォン。

- フォーカスを失う(focusout): ポインティング・デバイスまたは要素からのタブによる移動によってトリガー要素がフォーカスを失ったときに起動します。サポートされているユーザー・インタフェース・タイプ: デスクトップおよびjQuery Mobileスマートフォン。

- マウス・ボタン・プレス(mousedown): ポインティング・デバイスのボタンがトリガー要素上で押されたときに起動します。サポートされているユーザー・インタフェース・タイプ: デスクトップ。

- マウス・ボタン・リリース(mouseup): ポインティング・デバイスのボタンがトリガー要素上で解放されたときに起動します。サポートされているユーザー・インタフェース・タイプ: デスクトップ。

- マウス・エンター(mouseenter): ポインティング・デバイスがトリガー要素内に移動すると起動します。サポートされているユーザー・インタフェース・タイプ: デスクトップ。

- マウス・リーブ(mouseleave): ポインティング・デバイスがトリガー要素外に移動すると起動します。サポートされているユーザー・インタフェース・タイプ: デスクトップ。

- マウス・ムーブ(mousemove): ポインティング・デバイスがトリガー要素上にあるとき、移動すると起動します。サポートされているユーザー・インタフェース・タイプ: デスクトップ。

- 方向の変更(orientationchange): デバイスの方向を(水平方向または垂直方向に)変更する際に起動します。'this.browserEvent' JavaScriptオブジェクトには、'portrait'または'landscape'のいずれかと同等な'orientation'プロパティが含まれています。サポートされるユーザー・インタフェース・タイプ: jQuery Mobileスマートフォン。

- ページのロード(「デスクトップ」ユーザー・インタフェースではreadyを使用し、「jQuery Mobileスマートフォン」ユーザー・インタフェースではpageintを使用): ページのロード時に起動します。サポートされているユーザー・インタフェース・タイプ: デスクトップおよびjQuery Mobileスマートフォン。

- ページのアンロード(unload): ページがアンロードされるときに起動します。サポートされているユーザー・インタフェース・タイプ: デスクトップおよびjQuery Mobileスマートフォン。

- サイズ変更(resize): ブラウザ・ウィンドウがサイズ変更されるときに起動します。サポートされているユーザー・インタフェース・タイプ: デスクトップ。

- リソースのロード(load): トリガー要素がウィンドウ要素の場合(「時期」属性の「JavaScript式」値にwindowを使用)、ブラウザでドキュメント内のすべてのコンテンツ(ウィンドウ、フレーム、オブジェクトおよびイメージを含む)のロードが完了したときにイベントが起動します。その他の要素では、このイベントはURLに関連付けられた要素(イメージ、スクリプト、フレーム、iframe)にのみ使用できます。サポートされているユーザー・インタフェース・タイプ: デスクトップおよびjQuery Mobileスマートフォン。

- スクロール(scroll): スクロール可能なトリガー要素がスクロールされるときに起動します。これは、ブラウザ・ウィンドウ(「時期」属性の「JavaScript式」値にwindowを使用)、スクロール可能なフレーム、またはCSSプロパティのoverflowがscroll (要素の明示的な高さがコンテンツの高さよりも低いときはauto)に設定されている要素が考えられます。サポートされているユーザー・インタフェース・タイプ: デスクトップおよびjQuery Mobileスマートフォン。

- スクロール・スタート(scrollstart): スクロールの開始時に起動します。サポートされるユーザー・インタフェース・タイプ: jQuery Mobileスマートフォン。

- スクロール・ストップ(scrollstop): スクロールの終了時に起動します。サポートされるユーザー・インタフェース・タイプ: jQuery Mobileスマートフォン。

- 選択(select): ユーザーがテキスト・フィールドの一部のテキストを選択するときに起動します。サポートされているユーザー・インタフェース・タイプ: デスクトップおよびjQuery Mobileスマートフォン。

- スワイプ(swipe): 1秒以内に水平方向に30px以上(および垂直方向に75px未満)ドラッグされた場合に起動します。サポートされるユーザー・インタフェース・タイプ: jQuery Mobileスマートフォン。

- 左スワイプ(swipeleft): 左方向へ移動するスワイプ・イベントが発生した場合に起動します。サポートされるユーザー・インタフェース・タイプ: jQuery Mobileスマートフォン。

- 右スワイプ(swiperight): 右方向へ移動するスワイプ・イベントが発生した場合に起動します。サポートされるユーザー・インタフェース・タイプ: jQuery Mobileスマートフォン。

- タップ(tap): クイック・タッチ・イベント後に起動します。サポートされるユーザー・インタフェース・タイプ: jQuery Mobileスマートフォン。

- タップ・アンド・ホールド(taphold): ホールド・タッチ・イベント(1秒近くのホールド)後に起動します。サポートされるユーザー・インタフェース・タイプ: jQuery Mobileスマートフォン。

- タッチ・キャンセル(vmousecancel): タッチまたはマウスキャンセル・イベントを処理する正規化されたイベント。サポートされるユーザー・インタフェース・タイプ: jQuery Mobileスマートフォン。

- タッチ・エンド(vmouseup): タッチ・エンドまたはマウス・アップ・イベントを処理する正規化されたイベント。サポートされるユーザー・インタフェース・タイプ: jQuery Mobileスマートフォン。

- タッチ・ムーブ(vmousemove): タッチ・ムーブまたはマウス・ムーブ・イベントを処理する正規化されたイベント。サポートされるユーザー・インタフェース・タイプ: jQuery Mobileスマートフォン。

- タッチ・スタート(vmousedown): タッチ・スタートまたはマウス・ダウン・イベントを処理する正規化されたイベント。サポートされるユーザー・インタフェース・タイプ: jQuery Mobileスマートフォン。

- 仮想クリック(vclick): タッチ・エンドまたはマウス・クリック・イベントを処理する正規化されたイベント。タッチ・デバイスでは、このイベントは「タッチ・エンド」後に送信されます。サポートされるユーザー・インタフェース・タイプ: jQuery Mobileスマートフォン。

フレームワーク・イベント

- リフレッシュ後(apexafterrefresh): トリガー要素がリフレッシュされた後に起動します。このイベントは、部分ページ・リフレッシュを実行し、このイベントを起動するトリガー要素にのみ有効です。これをサポートするネイティブ・コンポーネントは、「対話モード・レポート」、「クラシック・レポート」、「チャート」、「リスト・ビュー」およびカスケードLOVサポートが存在するすべてのアイテム・タイプです。プラグインでもこのイベントがサポートされる場合があります。サポートされているユーザー・インタフェース・タイプ: デスクトップおよびjQuery Mobileスマートフォン。

- ページの送信前(apexbeforepagesubmit): ページが送信される前に起動します。サポートされているユーザー・インタフェース・タイプ: デスクトップおよびjQuery Mobileスマートフォン。

- リフレッシュ前(apexbeforerefresh): トリガー要素がリフレッシュされる前に起動します。このイベントは、部分ページ・リフレッシュを実行し、このイベントを起動するトリガー要素にのみ有効です。これをサポートするネイティブ・コンポーネントは、「対話モード・レポート」、「クラシック・レポート」、「チャート」、「リスト・ビュー」およびカスケードLOVサポートが存在するすべてのアイテム・タイプです。プラグインでもこのイベントがサポートされる場合があります。サポートされているユーザー・インタフェース・タイプ: デスクトップおよびjQuery Mobileスマートフォン。

コンポーネント・イベント

これらのイベントは、カスタム・イベントをトリガーする、アプリケーションで使用可能なコンポーネント(アイテム、リージョンまたは動的アクションのいずれか)が存在する場合にのみ使用できます。これらのイベントは、イベント名[コンポーネント名]の書式で表示され、たとえばShuttleネイティブ・アイテム・タイプによってトリガーされるChange Orderイベントは、Change Order [Shuttle]と表示されます。コンポーネントのイベントは、Oracle Application Expressに付属のネイティブ・コンポーネントまたはアプリケーションにインストールしたプラグイン・コンポーネントのいずれかからトリガーされます。

- ネイティブ・コンポーネントによってトリガーされるイベント
順序の変更[シャトル](shuttlechangeorder): 右側の選択リストの値の順序が変更された(Move Top、Move Up、Move DownまたはMove Bottomを使用)ときに起動します。Oracle Application Expressでは現在、ネイティブ・コンポーネントによってトリガーされるイベントは他にありません。サポートされているユーザー・インタフェース・タイプ: デスクトップおよびjQuery Mobileスマートフォン。

- プラグイン・コンポーネントによってトリガーされるイベント
これらは現在のアプリケーションに追加されると使用可能になり、イベント名[コンポーネント名]の書式になります。プラグインが発生させるイベントに関連したヘルプについては、「共有コンポーネント」、「プラグイン」、「プラグイン名」、「ヘルプ・テキスト」にナビゲートして、プラグイン構成ページのヘルプ・テキストを参照してください(プラグイン作成者がここにドキュメントを格納している場合があります)。サポートされるユーザー・インタフェース・タイプ: プラグインの「ユーザー・インタフェース」→「サポート対象」設定によって決まります。

- カスタム・イベント:
「カスタム」を選択すると、カスタム・イベントを定義できる追加のフィールドが表示されます。これは、ネイティブまたはプラグインによって提供されるイベントが十分でない場合に役立ちます。

15.4.4 ページ・デザイナでの動的アクションの管理

この項では、ページ・デザイナで動的アクションを管理する方法について説明します。

- ページ・デザイナでの動的アクションの作成

- ページ・デザイナでの動的アクションの編集

- 動的アクションのイベント有効範囲の定義

- ページ・デザイナでの動的アクションの削除

15.4.4.1 ページ・デザイナでの動的アクションの作成

動的アクションの作成には、アクションが発生する時期(オプション条件を指定する)、実行されるアクションおよびアクションの影響を受ける要素を指定する手順が含まれます。

1. ページ・デザイナでアイテムを含めるページを表示します。「ページ・デザイナでのページの表示」を参照してください。

2. ページの左側の「レンダリング」ツリーの下にある「動的アクション」タブをクリックします。

3. 「動的アクション」で、「イベント」を右クリックし、「動的アクションの作成」を選択します。

ヒント:
イベント・タイプを選択してから右クリックして、「動的アクションの作成」を選択することもできます。

動的アクションの属性がプロパティ・エディタに表示されます。

ヒント:
「メッセージ」タブに、対処が必要なメッセージを示す赤または黄色の印が表示されます。メッセージを選択すると、プロパティ・エディタに関連する属性が表示されます。赤いエラー・メッセージは、保存する前に対処する必要があります。

4. プロパティ・エディタですべての属性を表示します。「プロパティ・エディタ・メニュー」から「すべて表示」を選択します。

5. 「プロパティ・エディタ - 動的アクション」で、次の属性を編集します。

ヒント:
属性の詳細は、プロパティ・エディタで属性を選択し、中央ペインで「ヘルプ」タブをクリックして、参照してください。

1. 指定、名前 - 動的アクションの名前を入力します。

2. 実行オプション、順序 - この計算の順序を入力します。これによって実行の順序が決まります。

3. 時期、イベント - 動的アクションを起動するイベントを指定します。「動的アクション・イベントについて」を参照してください。

4. 時期、選択タイプ - イベントのトリガーに使用するページ要素または構成体のタイプを選択します。特定の選択タイプの使用例は、関連する属性のヘルプを参照してください。

注意:
選択されたイベントでページ要素の定義がサポートされている場合にのみ、使用できます。「ページのロード」、「ページのアンロード」、「サイズ変更」、「ページの送信前」、「方向の変更」のイベントを選択すると、このフィールドは非表示になります。他のすべてのイベント・タイプでは、このフィールドが表示されます。

5. 次のように、ページ要素の名前を指定します。

- アイテム: 動的アクションをトリガーする1つ以上のページ・アイテム名を入力または選択します。複数のアイテムを指定する場合は、ページ・アイテムをカンマで区切ります。

- ボタン: 動的アクションをトリガーするボタンを選択します。ボタンがテンプレート・ボタンの場合、選択されたボタンは、#BUTTON_ID#に設定されたID属性を含むボタン・テンプレートを使用する必要があります。動的アクション・フレームワークは、ボタンを参照するためにこのID値を使用します。

- リージョン: 動的アクションをトリガーするリージョン名を選択します。選択されたリージョンは、ID属性を#REGION_STATIC_ID#に設定したコンテナ要素を含むリージョン・テンプレートを使用する必要があります。動的アクション・フレームワークは、リージョンを参照するためにこのID値を使用します。
リージョンは、これ自体でイベントを発生させることも(「リフレッシュ前」や「リフレッシュ後」イベントなど)、リージョン内のアイテムまたは他の要素で発生するイベントを捕捉するコンテナになることもできます。このことがサポートされているイベントのサブセットは、変更(change)、クリック(click)、ダブルクリック(dblclick)、フォーカスの取得(focus)、キー・ダウン(keydown)、キー・プレス、キー・リリース(keyup)、フォーカスを失う(blur)、マウス・ボタン・プレス(mousedown)、マウス・ボタン・リリース(mouseup)、マウス・ムーブ(mousemove)のみです。

- jQueryセレクタ: 動的アクションをトリガーする1つ以上のページ要素を戻すjQueryセレクタ構文を入力します。

- JavaScript式: 動的アクションをトリガーするDOMまたはjQueryオブジェクトを返すための、JavaScript式を入力します。

次に、イベントがTrueまたはFalseに評価された場合に実行するアクションを定義します。

6. 既存のアクションを編集するには、次のステップを実行します。

1. 「動的アクション」ツリーを展開し、「True」または「False」ノードを表示します。

2. 「True」または「False」で、アクションを選択します。

3. プロパティ・エディタでアクションを編集します。

7. 新規アクションを追加するには、次のようにします。

1. 「動的アクション」ツリーを展開します。

2. 動的アクションを右クリックし、「TRUEアクションの作成」または「FALSEアクションの作成」を選択します。

3. プロパティ・エディタでアクションを編集します。

8. 「保存」をクリックします。

15.4.4.2 ページ・デザイナでの動的アクションの編集

動的アクションを作成した後、作成プロセス中に定義した属性を変更したり、プロセス中に指定できなかった属性を指定したり(「認可スキーム」の指定など)、追加のtrueアクションを追加できます。

動的アクションを編集するには、次のステップを実行します。

1. ページ・デザイナでアイテムを含めるページを表示します。「ページ・デザイナでのページの表示」を参照してください。

2. ページの左側にある「動的アクション」タブをクリックします。動的アクションがイベント別に編成されます。

3. 該当するイベントを展開し、動的アクションを選択します。
動的アクションの属性がプロパティ・エディタに表示されます。

4. 「プロパティ・エディタ - 動的アクション」で、対象となる属性を編集します。

ヒント:
属性の詳細は、プロパティ・エディタで属性を選択し、中央ペインで「ヘルプ」タブをクリックして、参照してください。

5. 既存のアクションを編集するには、次のステップを実行します。

1. 「動的アクション」ツリーを展開し、「True」または「False」ノードを表示します。

2. 「True」または「False」で、アクションを選択します。

3. プロパティ・エディタでアクションを編集します。

6. 新規アクションを追加するには、次のようにします。

1. 「動的アクション」ツリーを展開します。

2. 動的アクションを右クリックし、「TRUEアクションの作成」または「FALSEアクションの作成」を選択します。

3. プロパティ・エディタでアクションを編集します。

7. 「保存」をクリックします。

関連項目:
「コンポーネント・ビューでの動的アクションの作成」、「Trueアクションの追加」および「頻度と有効範囲の定義」

15.4.4.3 動的アクションのイベント有効範囲の定義

動的アクションを作成した後、アクションの有効範囲を1回のみのトリガーとするか、現在のページの存続期間中とするか、トリガー要素が部分ページ・リフレッシュ(PPR)によって更新されるまでとするかを変更できます。

有効範囲を指定するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。「ページ・デザイナでのページの表示」を参照してください。

2. ページの左側の「レンダリング」ツリーの下にある「動的アクション」タブをクリックします。

3. 「動的アクション」で、動的アクションを選択します。
「プロパティ・エディタ - 動的アクション」が表示されます。

4. プロパティ・エディタですべての属性を表示します。「プロパティ・エディタ・メニュー」から「すべて表示」を選択します。

5. 「詳細」で、「イベント有効範囲」を選択します。オプションは次のとおりです。

- 静的

- 動的

- 1回

ヒント:
属性の詳細は、プロパティ・エディタで属性を選択し、中央ペインで「ヘルプ」タブをクリックして、参照してください。

6. 「保存」をクリックします。

15.4.4.4 ページ・デザイナでの動的アクションの削除

動的アクションを削除するには、次のステップを実行します。

1. ページ・デザイナでアイテムを含めるページを表示します。「ページ・デザイナでのページの表示」を参照してください。

2. ページの左側にある「動的アクション」タブをクリックします。

3. 該当するイベントを展開し、削除する動的アクションを見つけます。

4. 動的アクションを右クリックして、「削除」を選択します。

5. 「保存」をクリックします。

15.4.5 コンポーネント・ビューでの動的アクションの管理

この項では、コンポーネント・ビューで動的アクションを管理する方法について説明します。

- コンポーネント・ビューでの動的アクションの作成

- コンポーネント・ビューでの動的アクションの編集

- Trueアクションの追加

- 頻度と有効範囲の定義

関連項目:
「ページ・デザイナでの動的アクションの管理」

15.4.5.1 コンポーネント・ビューでの動的アクションの作成

動的アクションの作成には、アクションが発生する時期(オプション条件を指定する)、実行されるアクションおよびアクションの影響を受ける要素を指定する手順が含まれます。

1. 適切なページにナビゲートします。「コンポーネント・ビューでのページの表示」を参照してください。

2. 「ページ・レンダリング」で、「動的アクション」までスクロールして、「作成」アイコンをクリックします。
「動的アクション」ウィザードが表示されます。

3. 「指定」で、次の内容を入力し、「次へ」をクリックします。

- 名前: 動的アクションの名前を入力します。

- 順序: このコンポーネントの順序を入力します。これによって実行の順序が決まります。

4. 「時期」で、次の内容を入力し、「次へ」をクリックします。

1. イベント - 動的アクションを起動するイベントを指定します。「動的アクション・イベントについて」を参照してください。

2. 選択タイプ: 動的アクションをトリガーするページ要素のタイプを選択します。ページ要素の名前を指定するための対応する名前フィールドが表示されます。

注意:
選択されたイベントでページ要素の定義がサポートされている場合にのみ、使用できます。「ページのロード」、「ページのアンロード」、「サイズ変更」、「ページの送信前」、「方向の変更」のイベントを選択すると、このフィールドは非表示になります。他のすべてのイベント・タイプでは、このフィールドが表示されます。

3. 動的アクションをトリガーする1つ以上のページ要素の名前を指定します。複数ある場合は、ページ要素名をカンマで区切ります。

- アイテム: 動的アクションをトリガーする1つ以上のページ・アイテム名を入力または選択します。複数のアイテムを指定する場合は、ページ・アイテムをカンマで区切ります。

- ボタン: 動的アクションをトリガーするボタンを選択します。ボタンがテンプレート・ボタンの場合、選択されたボタンは、#BUTTON_ID#に設定されたID属性を含むボタン・テンプレートを使用する必要があります。動的アクション・フレームワークは、ボタンを参照するためにこのID値を使用します。

- リージョン: 動的アクションをトリガーするリージョン名を選択します。選択されたリージョンは、ID属性を#REGION_STATIC_ID#に設定したコンテナ要素を含むリージョン・テンプレートを使用する必要があります。動的アクション・フレームワークは、リージョンを参照するためにこのID値を使用します。
リージョンは、これ自体でイベントを発生させることも(「リフレッシュ前」や「リフレッシュ後」イベントなど)、リージョン内のアイテムまたは他の要素で発生するイベントを捕捉するコンテナになることもできます。このことがサポートされているイベントのサブセットは、変更(change)、クリック(click)、ダブルクリック(dblclick)、フォーカスの取得(focus)、キー・ダウン(keydown)、キー・プレス、キー・リリース(keyup)、フォーカスを失う(blur)、マウス・ボタン・プレス(mousedown)、マウス・ボタン・リリース(mouseup)、マウス・ムーブ(mousemove)のみです。

- jQueryセレクタ - 動的アクションをトリガーする1つ以上のページ要素を戻すjQueryセレクタ構文を入力します。

- JavaScript式: 動的アクションをトリガーするDOMまたはjQueryオブジェクトを返すための、JavaScript式を入力します。

4. 条件: 条件を指定するには、「条件」リストから選択します。条件タイプによっては、条件をテストする値を入力する必要がある場合があります。条件が指定されない場合、Trueアクションのみが起動されます。条件を指定する場合、条件を満たすと、Trueアクションが起動され、条件を満たさない場合は、Falseアクションが起動されます。

5. 「Trueアクション」で、以前指定されたイベントが発生して条件が満たされた場合に実行されるアクションを指定し、「次へ」をクリックします。

- アクション - 条件が満たされた場合または「- 条件なし -」が指定されている場合に起動するTrueアクションを選択します。選択されたアクションによっては、追加のオプションが表示されます。

ヒント:
詳細は、フィールドレベル・ヘルプを参照してください。「フィールドレベル・ヘルプの表示」を参照してください。

- ページのロード時に実行 - ページをロードするときにこのアクションをトリガーするには、このオプションを選択します。選択したアクションのタイプに応じて、このオプションを選択する場合もあれば、選択しない場合もあります。

- 反対のFALSEアクションの生成: 反対のFALSEアクションも生成するには、このオプションを選択します。反対のアクションとして扱われるものには、「表示/非表示」、「有効/無効」および「クラスの追加/クラスの削除」があります。このオプションは、上述のアクションのいずれかが選択された場合および条件が指定された場合にのみ表示されます。

6. 「影響を受ける要素」(影響を受ける要素がサポートされているアクションでのみ使用可能)で、この動的アクションによる影響を受ける要素と要素が受ける影響を指定し、「次へ」をクリックします。
動的アクションを作成する最終ステップは、影響を受ける要素の選択が、選択したアクションによってサポートされているかどうかによって異なります。「ページの送信」のような一部のアクションでは、影響を受ける要素を選択する必要はありません。「表示」などの他のアクションでは、影響を受ける要素を選択する必要があります。影響を受ける要素の選択が、選択したアクションによってサポートされていない場合、最後のページは動的アクションの詳細を確認できる、確認ページとなります。影響を受ける要素の選択が、選択したアクションによってサポートされている場合、このページのオプションは次のとおりです。

- 選択タイプ: 動的アクションによる影響を受けるページ要素のタイプを選択します。選択されたタイプによって、追加のオプションが表示されます。これらのオプションを使用して、要素が受ける影響を指定するために必要な追加の設定と値を指定します。

ヒント:
詳細は、選択を行ってからフィールドレベル・ヘルプを参照してください。「フィールドレベル・ヘルプの表示」を参照してください。

7. 「動的アクションの作成」をクリックします。

15.4.5.2 コンポーネント・ビューでの動的アクションの編集

動的アクションを作成した後、作成プロセス中に定義した属性を変更したり、プロセス中に指定できなかった属性を指定したり(「認可スキーム」の指定など)、追加のtrueアクションを追加できます。

動的アクションを編集するには、次のステップを実行します。

1. 適切なページにナビゲートします。「コンポーネント・ビューでのページの表示」を参照してください。

2. 「ページ・レンダリング」で、「動的アクション」までスクロールして、変更する動的アクションをクリックします。
動的アクションの編集ページが表示されます。

3. 対象となる属性を編集します。
属性の詳細は、フィールドレベル・ヘルプを参照してください。「フィールドレベル・ヘルプの表示」を参照してください。

4. 「変更の適用」をクリックします。

関連項目:
「コンポーネント・ビューでの動的アクションの作成」、「Trueアクションの追加」および「頻度と有効範囲の定義」

15.4.5.3 Trueアクションの追加

この項では、Trueアクションを追加する方法について説明します。

- Trueアクションの追加について

- Trueアクションの追加

15.4.5.3.1 Trueアクションの追加について

動的アクションには、Trueアクションが起動する時期を制御するために指定できる条件が含まれています。たとえば、従業員情報をマネージャに表示するアプリケーションについて考えます。従業員が上級一般職の場合は給与が表示され、それ以外の場合は時給が表示されます。

動的アクション作成ウィザードでは、1つのTrueアクションのみ指定できます。複数のアクションを追加するには、動的アクションを作成するための作成ウィザードを使用した後、Trueアクションを追加するようにアクションを編集する必要があります。

15.4.5.3.2 Trueアクションの追加

アクションを追加するには、次の手順を実行します。

1. 適切なページにナビゲートします。「コンポーネント・ビューでのページの表示」を参照してください。

2. 「ページ・レンダリング」で、「動的アクション」までスクロールして、変更する動的アクションをクリックします。
動的アクションの編集ページが表示されます。

3. 条件が満たされたとき、または条件が指定されなかったときに実行されるアクションを追加するには、「Trueアクション」までスクロールして、「Trueアクションの追加」をクリックします。
アクションの作成/編集ページが表示されます。

4. 「指定」で、次の項目を指定します。

1. 順序: このコンポーネントの順序を入力します。これは、実行順序を示します。

2. アクション: 条件がtrueのときにトリガーされるアクションを選択します。

5. 「実行オプション」で、次の項目を指定します。

1. ページのロード時に実行: ページをロードするときにもアクションをトリガーする場合に選択します。

2. 対象となる属性を編集します。
属性の詳細は、フィールドレベル・ヘルプを参照してください。「フィールドレベル・ヘルプの表示」を参照してください。

6. 「影響を受ける要素」で、次の項目を指定します(選択されたアクションで、影響を受ける要素の定義がサポートされる場合にのみ使用可能)。

注意:
選択されたアクションのタイプによって、次のフィールドの一部またはすべてを選択できないことがあります。たとえば、「無効化」アクションでは、影響を受ける要素として「リージョン」を選択することがサポートされていません。

1. 選択タイプ: 動的アクションによる影響を受けるページ要素のタイプを選択します。ページ要素の名前を指定するための対応する名前フィールドが表示されます。

7. 「コメント」に、開発者のコメントまたは注意を入力します。これらのコメントは、アプリケーションの実行中に表示されません。

8. 「作成」をクリックします。
動的アクションの編集ページが表示され、追加したアクションが「Trueアクション」の下に表示されます。

15.4.5.4 頻度と有効範囲の定義

動的アクションを作成した後、アクションの有効範囲を1回のみのトリガーとするか、現在のページの存続期間中とするか、トリガー要素が部分ページ・リフレッシュ(PPR)によって更新されるまでとするかを変更できます。

有効範囲を指定するには、次のステップを実行します。

1. 適切なページにナビゲートします。「コンポーネント・ビューでのページの表示」を参照してください。

2. 「ページ・レンダリング」で、「動的アクション」までスクロールして、変更する動的アクションをクリックします。
動的アクションの編集ページが表示されます。

3. 「詳細」までスクロールします。「イベント有効範囲」で、次のいずれかを選択します。

1. 静的(デフォルト): 現在のページの存続期間中、イベント・ハンドラをトリガー要素にバインドします。ただし、トリガー要素が部分ページ・リフレッシュ(PPR)を通じて更新された場合はバインドされなくなります。

2. 動的: 現在のページの存続期間中、イベント・ハンドラをトリガー要素にバインドします(部分ページ・リフレッシュ(PPR)を通じて更新されたトリガー要素を含む)。「動的」を指定すると、追加のフィールド「静的コンテナ(jQueryセレクタ)」が表示されます。静的コンテナを指定すると、動的イベント有効範囲でのイベント処理のパフォーマンスの向上に役立ちます。これは、それ自体は再生成されないページの要素ですが、部分ページ・リフレッシュ(PPR)によって再生成されるトリガー要素を含みます。この要素参照は、jQueryセレクタとして定義する必要があります。
たとえば、(PPRによって再作成される)対話モード・レポート・リージョンの行になんらかの処理を実行する動的アクションがある場合、レポートのリフレッシュ後も動的アクションが機能するようにするには、「イベント有効範囲」が「動的」である必要があります。また、静的コンテナの値を、リージョンの静的ID値を選択するjQueryセレクタに設定できます(例: '#my_region')。

3. 1回: 1回のみのイベントについて、イベント・ハンドラをトリガー要素にバインドします。

4. 「変更の適用」をクリックします。

15.4.6 動的アクションを使用したJavaScriptのコールについて

動的アクションを作成することによっても、JavaScriptコードを実行できます。JavaScriptコードは、JavaScriptの実行と「値の設定」タイプで実行できます。条件タイプを「JavaScript式」に設定することにより、動的アクションの条件に対してJavaScriptコードを使用することもできます。

関連項目:
「動的アクションの管理」

15.4.7 動的アクションのデバッグ

この項では、Oracle Application Expressで動的アクションをデバッグする方法について説明します。

- 動的アクションのデバッグについて

- 動的アクションのデバッグ

15.4.7.1 動的アクションのデバッグについて

Oracle Application Express内での動的アクションのデバッグは、他のデバッグと少し異なります。これは、動的アクション・フレームワーク内で実行される処理の多くが、サーバー側でなくクライアント側で実行されるためです。動的アクションをデバッグするには、ブラウザでJavaScriptコンソールがサポートされている場合、Oracle Application Expressがデバッグ情報をブラウザのJavaScriptコンソールに出力します(たとえば、FirebugがインストールされたFirefoxは、デバッグ情報を「Console」ペインに表示します)。デバッグ情報には、動的アクションの起動時、動的アクションの名前およびAction JavaScriptオブジェクトが記載されており、クライアントがアクションを実行するために必要なすべての情報(イベント名、時期の詳細、アクション、影響を受ける要素など)が含まれています。

15.4.7.2 動的アクションのデバッグ

動的アクションをデバッグするには、次のステップを実行します。

1. 動的アクションが含まれているアプリケーションのデバッグが有効化されていることを確認します。「デバッグ・モードの使用」を参照してください。

2. 動的アクションが含まれているページを実行します。

3. ブラウザのJavaScriptコンソールを開きます。

4. 開発者ツールバーで、「デバッグ」をクリックします。
ページがリフレッシュされます。ページのロード時に起動するように設定されている動的アクションがある場合は、コンソールに次のテキスト出力が表示されます。

Dynamic Action Fired: [Dynamic action name] ({JavaScript Object containing all Dynamic Action information})

デバッグ情報はデバッグ・モードで実行されている場合にのみ出力されるため、デバッグ・モードをオンのままにすることで、動的アクションが予期される時期に起動されるかどうかをさらにテストできます。たとえば、ある特定のアイテムの値が変更されるときに起動する動的アクションを定義した場合、そのアイテムの値を変更すると、動的アクションが起動したかどうかのデバッグ出力がコンソールに表示されます。

15.5 ボタンの作成

この項では、アプリケーションにボタンを追加する方法について説明します。アプリケーションを設計する際、ボタンを使用して、特定のページまたはURLを表示したり、情報をポストまたは処理するようにできます(たとえば、「作成」、「取消」、「次へ」、「前へ」または「削除」ボタンを作成します)。

- ボタンで実行できる操作

- ページ・デザイナでのボタンの管理

- コンポーネント・ビューでのボタンの管理

- ボタンからのJavaScriptのコールについて

- ボタン名とREQUESTの関係について

- ボタンを使用したブランチ処理について

関連項目:
「ボタンのURLからのページのコール」および「ページ固有のユーティリティへのアクセス」

15.5.1 ボタンで実行できる操作

ボタンでは、様々なタイプの操作を実行できます。次の操作を実行できます。

- ページの送信(フォーム・ページに対する変更の保存など)

- 異なるページまたはカスタムURLのいずれかへのリダイレクト

- 実行しない(ボタンの動作が「動的アクション」で定義されていない場合など)。

15.5.2 ページ・デザイナでのボタンの管理

この項では、ページ・デザイナでボタンを管理する方法について説明します。

- ページ・デザイナでのボタンの作成

- ページ・デザイナでのボタンの編集

- ボタンの条件付き表示

関連項目:
「コンポーネント・ビューでのボタンの管理」

15.5.2.1 ページ・デザイナでのボタンの作成

ページ・デザイナでボタンを作成するには、次のステップを実行します。

1. ページ・デザイナでアイテムを含めるページを表示します。「ページ・デザイナでのページの表示」を参照してください。

2. 必要に応じて、アイテムを含めるリージョンを作成します。「リージョンについて」を参照してください。

3. ギャラリで、「ボタン」タブをクリックします。
ボタンにカーソルをあわせると、ボタンを説明するツールチップが表示されます。

4. ボタンを選択して、グリッド・レイアウトの適切な場所にドラッグします。

ヒント:
アイテムを右クリックして「追加先」を選択し、適切な場所を選択することもできます。

「プロパティ・エディタ - ページ・アイテム」が表示されます。

「メッセージ」タブに、対処が必要なメッセージを示す赤または黄色の印が表示されます。メッセージを選択すると、プロパティ・エディタに関連する属性が表示されます。赤いエラー・メッセージは、保存する前に対処する必要があります。

5. プロパティ・エディタですべての属性を表示します。「プロパティ・エディタ・メニュー」から「すべて表示」を選択します。

6. プロパティ・エディタで該当する属性を編集します。

ヒント:
属性の詳細は、プロパティ・エディタで属性を選択し、中央ペインで「ヘルプ」タブをクリックして、参照してください。

7. 「保存」をクリックします。

15.5.2.2 ページ・デザイナでのボタンの編集

ページ・デザイナでリージョン・ボタンを作成するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。「ページ・デザイナでのページ・レベル・アイテムの表示」を参照してください。
ページ・デザイナが表示されます。

2. 「レンダリング」ツリーまたはグリッド・レイアウトのいずれかで、編集するボタンを選択します。
プロパティ・エディタが、「プロパティ・エディタ - ボタン」を表示するように変わります。

3. プロパティ・エディタですべての属性を表示します。「プロパティ・エディタ・メニュー」から「すべて表示」を選択します。

4. 対象となる属性を編集します。
ページ上の特定の属性の詳細を表示するには、属性ラベルをクリックします。「フィールドレベル・ヘルプの表示」を参照してください。

15.5.2.3 ボタンの条件付き表示

ボタンを条件付きで表示するには、「ページ・ボタンの編集」ページの属性を編集します。

ボタンを条件付きで表示するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。「ページ・デザイナでのページ・レベル・アイテムの表示」を参照してください。
ページ・デザイナが表示されます。

2. 「レンダリング」ツリーまたはグリッド・レイアウトのいずれかで、編集するボタンを選択します。
プロパティ・エディタが、「プロパティ・エディタ - ボタン」を表示するように変わります。

3. プロパティ・エディタですべての属性を表示します。「プロパティ・エディタ・メニュー」から「すべて表示」を選択します。

ヒント:
属性の詳細は、プロパティ・エディタで属性を選択し、中央ペインで「ヘルプ」タブをクリックして、参照してください。

4. 「条件」を展開します。条件タイプを選択し、表示されたフィールドに適切な情報を入力します。

5. 「保存」をクリックします。

関連項目:
「バインド変数構文を使用したセッション・ステートの参照」

15.5.3 コンポーネント・ビューでのボタンの管理

この項では、コンポーネント・ビューでボタンを作成する方法について説明します。

- コンポーネント・ビューでのボタンの作成

- コンポーネント・ビューでの複数のボタンの作成

- コンポーネント・ビューでのボタンの編集

- ボタンの条件付き表示

関連項目:

15.5.3.1 コンポーネント・ビューでのボタンの作成

コンポーネント・ビューでリージョン・ボタンを作成するには、次のステップを実行します。

1. 適切なページにナビゲートします。「コンポーネント・ビューでのページの表示」を参照してください。

2. 必要に応じて、リージョンを作成します。「リージョンについて」を参照してください。

3. 「ボタン」で、「作成」アイコンをクリックします。

4. 「ボタン・リージョン」で、ボタンのリージョンを選択して「次へ」をクリックします。

5. 「ボタン位置」で、次のステップを実行します。

1. 位置 - このボタンの位置を選択します。

- リージョン位置にボタンの作成: リージョン位置にボタンを配置する場合は、このオプションを選択します。リージョン位置は、リージョン・テンプレートで定義された位置です。

- このリージョン・アイテムで表示されるボタンの作成: ページ・アイテム内またはページ・アイテム間にボタンを表示する場合は、このオプションを選択します(たとえば、フォーム・フィールドの横にボタンを直接追加する場合)。

2. 「次へ」をクリックします。

6. 「ボタン属性」で、次のステップを実行します。

ヒント:
属性の詳細は、フィールドレベル・ヘルプを参照してください。「フィールドレベル・ヘルプの表示」を参照してください。

1. ボタン名: 対象のボタンの名前を入力します。「ページの送信」のアクションを行うボタンでは、ボタンの名前がページ・リクエストの値になります。たとえば、ボタンにFLOW_RESET_BUTTONという名前を付けると、送信を行わずにカレント・ページをリセットすることがボタンの目的になります。

2. ラベル: ボタンに表示するラベルを入力します。

3. ボタン・テンプレート: どのテンプレートでボタンの表示を制御するかを定義します。ボタン・テンプレートは、テンプレート・ページで定義します。少なくとも1つのボタン・テンプレートを定義しておかないと、ボタン・テンプレートを使用できません。

4. ボタン・タイプ: この属性を使用して、ボタン・テンプレートの「標準」または「ホット」いずれかのテンプレートを選択します。
「ホット」を選択すると、ボタン・テンプレートの「ホット・テンプレート」属性に格納されたテンプレートを使用してボタンがレンダリングされます。値が定義されない場合、標準のボタン・テンプレートが使用されます。

5. ボタン属性: 入力したテキストは、HTML要素の定義に追加されます。次の例では、テキスト・ボタンのクラスを設定しています。

class="myclass"

テンプレートに基づくボタンの場合、テンプレートに#BUTTON_ATTRIBUTES#置換文字列を含める必要があります。これを使用してタブの停止を制御できます。次に例を示します。

tabindex="3"

6. 「次へ」をクリックします。

「表示プロパティ」が表示されます。「表示プロパティ」に表示されるオプションは、選択されたリージョン位置によって決まります。

7. 「表示プロパティ」で、次のステップを実行します。

- ボタン位置が「リージョン位置にボタンの作成」の場合は、次の項目を指定します。

- 順序: このコンポーネントの順序を入力します。これによって評価の順序が決まります。

- 位置: このボタンの位置を選択します。

- 位置合せ: 「右」または「左」を選択します。

- 「次へ」をクリックします。

- ボタン位置が「このリージョン・アイテムで表示されるボタンの作成」の場合は、次の項目を指定します。

- 順序: このコンポーネントの順序を入力します。これによって評価の順序が決まります。

- 「次へ」をクリックします。

8. 「クリックされたときのアクション」で、次のステップを実行します。

1. ヒント:
属性の詳細は、フィールドレベル・ヘルプを参照してください。「フィールドレベル・ヘルプの表示」を参照してください。

アクション: ボタンがクリックされたときの動作を選択します。

2. 検証の実行: 「検証の実行」では、ページ送信時の検証の実行を制御します。たとえば、ユーザーがレコードを削除しているときに、「削除」ボタンに無関係な検証エラー・メッセージを表示しないようにする場合に使用できます。
この設定に関係なく特定の検証を常に実行する場合、検証属性の「常に実行」を「はい」に設定します。詳細は、「検証の実行タイミングの決定について」を参照してください。

3. 「次へ」をクリックします。

9. 「条件付き表示」で、対象のコンポーネントをレンダリングするうえで満たす必要がある条件タイプをリストから選択します。

10. 「ボタンの作成」をクリックします。

関連項目:
「ボタン名とREQUESTの関係について」

15.5.3.2 コンポーネント・ビューでの複数のボタンの作成

コンポーネント・ビューでは、複数のボタンの作成ウィザードを使用して、同じリージョン内に複数の「ページの送信」ボタンを一度に作成できます。

一度に複数のボタンを作成するには、次のステップを実行します。

1. 適切なページにナビゲートします。「コンポーネント・ビューでのページの表示」を参照してください。

2. 必要に応じて、リージョンを作成します。「リージョンについて」を参照してください。

3. コンポーネント・ビューで「ボタン」セクションを探し、「作成」アイコンをクリックします。
ボタンの作成ウィザードが表示されます。

4. 「複数のボタンの作成」リンクをクリックします。
「複数のボタンの作成」ウィザードが表示されます。

5. 「リージョン」で、このボタンを含めるリージョンを選択します。

6. 「テンプレート」からテンプレートを選択します。テンプレートを選択しない場合、HTMLスタイルのボタンが作成されます。

7. 「HTML属性」で、これらのボタンのHTML属性を指定します。このテキストがHTML要素の定義に追加されます。たとえば、テキスト・ボタンのクラスを次のように設定できます。

class="myclass"

8. 残りのフィールドに迅速に移入するには、ページの右側にある「クイック・ボタン」リストから選択します。

9. 「ボタンの作成」をクリックします。

15.5.3.3 コンポーネント・ビューでのボタンの編集

この項では、コンポーネント・ビューでボタンを編集する方法について説明します。

- ボタン属性の編集

- 「検証の実行」について

- 複数のボタンの同時編集

15.5.3.3.1 ボタン属性の編集

既存のボタンの属性を編集するには、次のようにします。

1. 適切なページにナビゲートします。「コンポーネント・ビューでのページの表示」を参照してください。

2. 「ボタン」で、ボタン名を選択します。

3. ボタン属性を編集します。
属性の詳細は、フィールドレベル・ヘルプを参照してください。「フィールドレベル・ヘルプの表示」を参照してください。

4. 「変更の適用」をクリックします。

15.5.3.3.2 「検証の実行」について

ページ・ボタンの編集ページの「ボタンがクリックされたときのアクション」、「検証の実行」属性は、ページを送信するときの検証の実行を制御します。たとえば、ユーザーがレコードを削除しているときに、「削除」ボタンに無関係な検証エラー・メッセージを表示しないようにする場合に使用できます。

「検証の実行」では、次を選択できます。

- はい: ページが送信され、この属性が「はい」に設定されている場合、そのページに定義されているすべての検証とすべての組込みの検証が実行されます(たとえば、必須の値が設定されていることを確認するためや、その値が有効な数値や日付であるかどうかを判別するため)。

- いいえ: 「いいえ」に設定すると、定義済の検証と組込みの検証はいずれも実行されません。

この設定に関係なく特定の検証を常に実行する場合、検証属性の「常に実行」を「はい」に設定します。

関連項目:
「検証の実行タイミングの決定について」

15.5.3.3.3 複数のボタンの同時編集

ボタン・ページを使用して、複数のボタンを削除したり、最近の変更の履歴を表示します。

一度に複数のボタンを編集するには、次のステップを実行します。

1. 適切なページにナビゲートします。「コンポーネント・ビューでのページの表示」を参照してください。

2. 「ボタン」で、「すべて編集」アイコンをクリックします。「すべて編集」アイコンは、鉛筆が置かれた小さいグリッドの形をしています。
ボタン・ページが表示されます。ボタン・ページには、リージョン内のボタンのリストを示す表が含まれています。

3. 属性を編集し、「変更の適用」をクリックします。

15.5.3.3.4 複数のボタンの削除

一度に複数のボタンを削除するには、次のステップを実行します。

1. 適切なページにナビゲートします。「コンポーネント・ビューでのページの表示」を参照してください。

2. 「ボタン」で、「すべて編集」アイコンをクリックします。「すべて編集」アイコンは、鉛筆が置かれた小さいグリッドの形をしています。
ボタン・ページが表示されます。ボタン・ページには、リージョン内のボタンのリストを示す表が含まれています。

3. 「複数のボタンの削除」をクリックします。
複数のボタンの削除ページが表示されます。

4. 削除するボタンを選択して、「ボタンの削除」をクリックします。

15.5.3.3.5 履歴

履歴ページを使用して、ボタンの最近の変更のサマリーを表示します。

15.5.3.4 ボタンの条件付き表示

ボタンを条件付きで表示するには、「ページ・ボタンの編集」ページの属性を編集します。

ボタンを条件付きで表示するには、次のステップを実行します。

1. ボタンを作成します。「コンポーネント・ビューでのボタンの作成」を参照してください。

2. 適切なページにナビゲートします。「コンポーネント・ビューでのページの表示」を参照してください。

3. 「ボタン」で、ボタン名をクリックします。

4. 「条件」までスクロールします。

5. 「条件タイプ」リストから選択します。

6. 表示されるフィールドに式を入力します。

7. 「変更の適用」をクリックします。

関連項目:
「バインド変数構文を使用したセッション・ステートの参照」

15.5.4 ボタンからのJavaScriptのコールについて

リクエストを確認する最も有効な方法は、ボタンからJavaScriptをコールする方法です。実際、Oracle Application Expressでは、ほぼすべてのオブジェクトの削除操作にこの方法を使用します。たとえば、ボタンを削除する場合は、リクエストの確認を求める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');
}

この例では、削除操作を確認するファンクションを作成した後、ボタンからそのファンクションをコールします。このファンクションは、オプションでページを送信し、内部変数:REQUESTの値をDeleteに設定するため、リクエストの値に基づいて条件付きで実行されるプロセスを使用して削除を実行します。

ボタンを作成する際に、「URLにリダイレクト」を選択する必要があります。その後、URLターゲットを次のように指定します。

javascript:confirmDelete('Would you like to perform this delete action?');

JavaScriptコードを実行する場合は、動的アクションを使用することをお薦めします。次に例を示します。

1. 「動的アクションで定義」のアクションを実行するボタンを作成します。「コンポーネント・ビューでのボタンの作成」を参照してください。

2. 動的アクションを作成し、アクション・タイプ「JavaScriptコードの実行」を使用して前述のコードを実行します。たとえば、次のようにします。

if (confirm("Would you like to perform this delete action?")) {
apex.submit('Delete');
}

この例ではJavaScriptを使用していますが、JavaScriptを使用しなくても、この例を簡単に実装できます。かわりに、同様に翻訳可能な宣言的アクションの「確認」と「ページの送信」を使用できます。詳細は、「動的アクションの管理」を参照してください。

15.5.5 ボタン名と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="apex.submit('Finish');">

この例では、FinishはREQUESTの名前で、大/小文字が区別されます。

15.5.6 ボタンを使用したブランチ処理について

各ページには、任意の数のブランチを含めることができます。ブランチは、アプリケーションの他のページまたはURLにリンクします。Application Expressでは、ページ・プロセス中の異なる時点でブランチが検討されます。プロセス前、計算前、検証前およびプロセス後のどの時点でブランチするかを選択できます。アプリケーション・ビルダーの他のコントロールと同様に、ブランチ処理には条件を設定できます。たとえば、ユーザーがボタンをクリックした場合にブランチできます。ブランチを作成する場合は、ブランチを特定のボタンに関連付けます。ブランチは、ユーザーがボタンをクリックした場合にのみ検討されます。

関連項目:
「ブランチを使用したナビゲーションの制御」

15.6 ツリーの作成

この項では、アプリケーション・ビルダーでツリー・コンポーネントを作成する方法について説明します。

- ツリーについて

- レガシーjsTreeのサポートについて

- 新しいページでのツリーの作成

- ページ・デザイナでのツリーの管理

- コンポーネント・ビューでのツリーの管理

ヒント:
Oracle Application Expressリリース5.0では、引き続き既存のjsTreeリージョンを編集できますが、作成はできなくなりました。「ツリーについて」を参照してください。

15.6.1 ツリーについて

アプリケーション・ビルダーには、階層表示を示すツリーを生成するための組込みウィザードが用意されています。Oracle Application Expressリリース5.0では、ツリーで新しいAPEXツリー実装が使用されます。レガシーjsTreeリージョンと同様に、この新しいツリー実装は、オプションのキーボード・ナビゲーションおよびオプションのステート保存の機能を持つ、JavaScriptベースのブラウザに依存しないツリー・コンポーネントです。APEXツリーは、jsTreeと同じ機能を共有しますが、例外として、テンプレート属性は新しいツリーに適用されません。新しい実装では、外観、有用性およびアクセシビリティも向上します。引き続き既存のjsTreeリージョンを編集できますが、作成はできなくなりました。

ツリーは、表またはビューでIDと親ID列を識別することによって階層関係を指定する問合せから作成できます。ツリー問合せでは、START WITH .. CONNECT BY句を利用して、階層問合せを生成します。

ヒント:
APEXツリー・リージョンは、「デスクトップ」ユーザー・インタフェースを使用したページでのみ作成できます。

15.6.2 レガシーjsTreeのサポートについて

以前のリリースのOracle Application Expressでは、jsTreeツリー・リージョンの作成がサポートされていました。既存のツリーはまだサポートされていますが、Oracle Application ExpressではjsTreeツリー・リージョンの作成はサポートされなくなりました。Oracle Application Expressでは、現在、APEXツリーのツリー・リージョンの生成がサポートされています。APEXツリーは、jsTreeに類似したJavaScriptベースのブラウザに依存しないツリー・コンポーネントです。

15.6.3 新しいページでのツリーの作成

ツリーは問合せに基づき、階層形式で表現できるデータを戻します。ページの作成ウィザードを使用してツリーを作成すると、ウィザードにより、選択したオプションに基づいてこの階層問合せが生成されます。

新しいページでツリーを作成するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「ページの作成」をクリックします。

4. 「ページの作成」で、次のステップを実行します。

1. ユーザー・インタフェース - 「デスクトップ」を選択します。

2. ページ・タイプの選択 - 「ツリー」を選択します。

3. 「次へ」をクリックします。

5. 「ページ属性」で、次のように指定します。

1. ページ番号: ツリーを作成する必要があるページを指定します。

2. ページ名: 新しいページにツリーを作成する場合、ページ名を入力します。

3. ページ・モード: ページ・モードを選択します。

4. ページ・グループ: このページと関連付けるページ・グループの名前を選択します。このオプションは、アプリケーションにグループが含まれる場合にのみ表示されます。

5. リージョン・テンプレート: ツリー・リージョンのリージョン・テンプレートを選択します。

6. リージョン名: ツリーを含めるリージョンの名前を入力します。

7. ブレッドクラム: ページでブレッドクラム・ナビゲーション・コントロールを使用するかどうか、およびどのブレッドクラム・ナビゲーション・コントロールを使用するかを選択します。「ブレッドクラム」を選択した場合、次のように入力します。

- エントリ名: ブレッドクラム・エントリの名前を入力します。

- 親エントリの選択: 親エントリを選択します。

8. 「次へ」をクリックします。

6. 「ナビゲーションのプリファレンス」で、このページに含めるナビゲーションのタイプを指定し、「次へ」をクリックします。ナビゲーション・オプション(ナビゲーション・メニューまたはタブなど)はカレント・アプリケーションのテーマに応じて決まります。

7. 「表/ビューの所有者」および「表/ビューの名前」で次を実行します。

1. 表/ビューの所有者: ツリーの基になる表の所有者を選択します。

2. 表/ビューの名前: マスター・ページに含める列を含む表またはビューを選択します。

3. 「次へ」をクリックします。

8. 「問合せ」で、IDおよび親IDとして使用する列を指定し、ノードに表示するテキストを指定します。

1. ID: IDとして使用する列を選択します。

2. 親ID: 親IDとして使用する列を選択します。

3. ノード・テキスト: ツリー・ノードに表示するテキストを選択します。

4. 開始: 階層ツリー問合せのルートを指定するために使用する列を選択します。

5. ツリーを開始: 問合せの開始方法を選択します。オプションは次のとおりです。

- 既存のアイテムに基づく: 既存のアプリケーション・アイテムまたはページ・アイテムを選択します。

- SQL問合せに基づく: 単一行または単一列を返すSQL問合せを入力します。

- 静的値に基づく: 静的値を入力します。

- 値: NULLです。

6. 「次へ」をクリックします。

9. 「WHEREおよびORDER BY」で、次のように指定します。

1. WHERE句: オプションのWHERE句を入力します。次に例を示します。

ename='JONE'

2. ORDER SIBLINGS BY: 列による兄弟の並替えを選択します(ENAMEなど)。デフォルト値は、選択した「ノード・テキスト」列に基づきます。

3. 「次へ」をクリックします。

10. 「ツリー属性」で、次のように指定します。

1. ボタンを含む: 含めるボタンを選択します。

2. 選択したノードのページ・アイテム: 選択したノード値を保持するページまたはアプリケーション・アイテムを選択します。このアイテムを使用して、最後に選択したツリー・ノードの値を保持することで、ツリーの状態を保存できます。選択したノードの値は、ノード・リンク属性またはページ・プロセスを使用して、選択したアイテムに保存できます。ツリーがリロードされると、最後に選択したツリー・ノードがツリーに開きます。

3. ツールチップ: マウスをリーフ・ノードに合わせたときにツールチップを表示します。オプションは次のとおりです。

- 静的割当て: ツールチップ・テキストとして使用する静的値を指定します。静的テキストで置換文字列を使用して、SQL問合せからの情報をツールチップ・テキストに組み込むことができます。使用可能な置換文字列は次のとおりです。
#VALUE#: 「ID」列の値を参照します。

#TITLE#: 「ノード・テキスト」列の値を参照します。

#LINK#: 「リンク」オプションの値を参照します。

- データベース列: ツールチップ・テキストとして使用する列を選択します。

4. 「リンク・オプション」で、次のオプションを選択します。

- 既存のアプリケーション・アイテム: リーフ・ノード・テキストをリンクにします。このオプションを選択する場合、リンク先のページおよびリーフ・ノード・テキストをリンクする既存アプリケーション・アイテムを指定する必要があります。
このオプションは、「既存のアプリケーション・アイテム」リンク・オプションを選択した場合にのみ表示されます。

- なし

5. 「次へ」をクリックします。

11. 選択した内容を確認し、「作成」をクリックします。

ヒント:
APEXツリー・リージョンは、「デスクトップ」ユーザー・インタフェースを使用したページで作成できます。

15.6.4 ページ・デザイナでのツリーの管理

この項では、ページ・デザイナでツリーを管理する方法について説明します。

- ページ・デザイナでのツリーの作成

- ページ・デザイナでのツリー属性の編集

15.6.4.1 ページ・デザイナでのツリーの作成

既存のページでツリーを作成するには、次のステップを実行します。

1. ページ・デザイナで適切なページにナビゲートします。「ページ・デザイナでのページの表示」を参照してください。
ページ・デザイナが表示されます

2. ギャラリからツリー・リージョンを選択し、グリッド・レイアウトの適切な場所にドラッグします。

ヒント:
ツリー・リージョンを右クリックし、「追加先」を選択して適切な場所を選択することもできます。

ページ・デザイナは、次に必要なアクションを示します。

「メッセージ」タブには、対応する必要のあるメッセージを示す赤または黄色のバッジが表示されます。「メッセージ」タブには、次の2つのタイプのメッセージが表示されます。

- エラー - エラー・メッセージは赤で表示されます。エラー・メッセージを選択すると、プロパティ・エディタに関連する属性が赤で表示されます。ページを保存する前にエラーに対処する必要があります。

- 警告 - 警告メッセージは黄色で表示されます。警告メッセージを選択すると、プロパティ・エディタで、関連する属性が黄色で表示されます。ページを保存する前にエラーに対処する必要があります。警告メッセージには対処しないでページを保存できることに注意してください。

3. プロパティ・エディタですべての属性を表示します。「プロパティ・エディタ・メニュー」から「すべて表示」を選択します。

4. リージョン属性を編集します。

ヒント:
属性の詳細は、プロパティ・エディタで属性を選択し、中央ペインで「ヘルプ」タブをクリックして、参照してください。

1. 指定 - リージョンのタイトルを入力します。

2. ソース - ツリーの基礎となるSQL問合せを入力します。問合せは、次の形式にする必要があります。

SELECT status, level, name, icon, id, tooltip, link
FROM ...
WHERE ...
START WITH...
CONNECT BY PRIOR id = pid

ORDER SIBLINGS BY ...

注意:
ツリーSQL問合せのSTATUS列は、ツリーに適したJSONデータソースをレンダリングする際にツリー・ロジックによって使用されるため、変更しないでください。

次に例を示します。

SELECT case WHEN connect_by_isleaf = 1 THEN 0 WHEN level = 1 THEN 1 ELSE -1 END as status,
level,
ename as title,
'icon-tree-folder' as icon,
empno as value,
ename as tooltip,
NULL as link
FROM emp
START WITH mgr IS NULL
CONNECT BY PRIOR empno = mgr
ORDER SIBLINGS BY ename

注意:
デフォルトでは、ツリーのイメージを表すCSSクラス'icon-tree-folder'を使用して、新しいAPEXツリーが作成されます。jsTree(レガシー)ツリー実装を作成する場合は、上の例のCSSクラスのかわりにイメージ参照を使用する必要があるため、'icon-tree-folder'を'#IMAGE_PREFIX#go-small.png'で置き換えます。

3. レイアウト - 「順序」、「親リージョン」および「位置」を指定します。

4. 外観 - テンプレートを指定します。

5. 「レンダリング」ツリーでリージョンの「属性」を選択します。
プロパティ・エディタに、ツリーの属性が表示されます。

6. プロパティ・エディタですべての属性を表示します。「プロパティ・エディタ・メニュー」から「すべて表示」を選択します。

7. ツリー属性を編集します。

1. ツリー実装 - ツリーの実装方法を「APEXツリー」または「jsTree(レガシー)」から選択します。

2. ツリー・テンプレート - 使用可能なjsTreeテンプレート・オプションから、ツリーに適用するテンプレートを選択します。このオプションはjsTreeリージョンにのみ適用可能です。

3. 次のものでノード・リンクをアクティブ化 - ツリーでノード・リンクをアクティブ化するために必要なアクションを選択します。

4. 選択したノードのページ・アイテム - 選択したノード値を保持するページまたはアプリケーション・アイテムを選択します。

5. ツールチップ - ツールチップを表示するかどうか、およびツールチップのソースを選択します。

6. 静的ツリーID - ツリーの一意の識別子を入力します。

7. アイコン・タイプ - CSSクラスを使用して、すべてのノードで使用されるアイコン・タイプを指定します。このオプションはAPEXツリー・リージョンにのみ適用可能です。

8. 「保存」をクリックします。

15.6.4.2 ページ・デザイナでのツリー属性の編集

デフォルトではツリーにフォーカスが置かれておらず、シングルクリック・アクションによってノード・リンクがアクティブ化されます。このセクションでは、開発者がツリー属性を編集してツリーをカスタマイズする方法について説明します。

ツリー属性ページにアクセスするには、次のステップを実行します。

1. ページ・デザイナで適切なページにナビゲートします。「ページ・デザイナでのページの表示」を参照してください。
ページ・デザイナが表示されます。

2. 「レンダリング」ツリーまたはグリッド・レイアウトでリージョンを選択します。
プロパティ・エディタに、ツリー・リージョンの属性が表示されます。

3. プロパティ・エディタですべての属性を表示します。「プロパティ・エディタ・メニュー」から「すべて表示」を選択します。

4. リージョン属性を編集します。

ヒント:
属性の詳細は、プロパティ・エディタで属性を選択し、中央ペインで「ヘルプ」タブをクリックして、参照してください。

5. 「保存」をクリックします。

15.6.5 コンポーネント・ビューでのツリーの管理

この項では、コンポーネント・ビューでツリーを管理する方法について説明します。

- コンポーネント・ビューでのツリーの作成

- コンポーネント・ビューでのツリー属性の編集

15.6.5.1 コンポーネント・ビューでのツリーの作成

コンポーネント・ビューでツリーを作成するには、次のステップを実行します。

1. ページに移動します。「コンポーネント・ビューでのページの表示」を参照してください。

2. 「リージョン」で、「作成」アイコンをクリックします。
「リージョンの作成」ウィザードが表示されます。

3. 「ツリー」を選択し、「次へ」をクリックします。

4. 「表示属性」で、次のステップを実行します。

1. タイトル - リージョンのタイトルを入力します。選択するリージョン・テンプレートにリージョン・タイトルが表示されると、このタイトルが表示されます。

2. リージョン・テンプレート: リージョンの外観を制御するテンプレートを選択します。

3. 親リージョン - 新しいリージョンが属する親リージョンを定義します。

4. 表示ポイント: このリージョンの表示ポイントを指定します。ページ・テンプレート位置およびページ・ボディ位置の2種類の表示ポイントが存在します。属性の詳細は、フィールドレベル・ヘルプを参照してください。

5. 順序: このコンポーネントの順序を指定します。これによって評価の順序が決まります。

6. 「次へ」をクリックします。

5. 「表/ビューの所有者」および「表/ビューの名前」で次を実行します。

1. 表/ビューの所有者: ツリーの基になる表の所有者を選択します。

2. 表/ビューの名前: マスター・ページに含める列を含む表またはビューを選択します。

3. 「次へ」をクリックします。

6. 「問合せ」で、IDおよび親IDとして使用する列を指定し、ノードに表示するテキストを指定します。

1. ID: IDとして使用する列を選択します。

2. 親ID: 親IDとして使用する列を選択します。

3. ノード・テキスト: ツリー・ノードに表示するテキストを選択します。

4. 開始: 階層ツリー問合せのルートを指定するために使用する列を選択します。

5. ツリーを開始: 問合せの開始方法を選択します。オプションは次のとおりです。

- 既存のアイテムに基づく: 既存のアプリケーション・アイテムまたはページ・アイテムを選択します。

- SQL問合せに基づく: 単一行または単一列を返すSQL問合せを入力します。

- 静的値に基づく: 静的値を入力します。

- 値: NULLです。

6. 「次へ」をクリックします。

7. 「WHEREおよびORDER BY」で、次のように指定します。

1. WHERE句: オプションのWHERE句を入力します。

2. ORDER SIBLINGS BY: 兄弟の並替え基準として使用する列を選択します。

3. 「次へ」をクリックします。

8. 「ツリー属性」で、次のように指定します。

1. ボタンを含む: 含めるボタンを選択します。

2. 選択したノードのページ・アイテム: 選択したノード値を保持するために使用できます。アプリケーション・アイテムを選択した場合、このアイテムを使用して、最後に選択したツリー・ノードの値を保持することで、ツリーの状態を保存できます。

3. ツールチップ: マウスをリーフ・ノードに合わせたときにツールチップを表示します。オプションは次のとおりです。

- 静的割当て: ツールチップ・テキストとして使用する静的値を指定します。静的テキストで置換文字列を使用して、SQL問合せからの情報をツールチップ・テキストに組み込むことができます。使用可能な置換文字列は次のとおりです。
#VALUE#: 「ID」列の値を参照します。

#TITLE#: 「ノード・テキスト」列の値を参照します。

#LINK#: 「リンク」オプションの値を参照します。

- データベース列: ツールチップ・テキストとして使用する列を選択します。

4. 「リンク・オプション」で、次のオプションを選択します。

- 既存のアプリケーション・アイテム: リーフ・ノード・テキストをリンクにします。このオプションを選択する場合、リンク先のページおよびリーフ・ノード・テキストをリンクする既存アプリケーション・アイテムを指定する必要があります。
このオプションは、「既存のアプリケーション・アイテム」リンク・オプションを選択した場合にのみ表示されます。

- なし

5. 「次へ」をクリックします。

9. 選択した内容を確認し、「リージョンの作成」をクリックします。

15.6.5.2 コンポーネント・ビューでのツリー属性の編集

デフォルトではツリーにフォーカスが置かれておらず、シングルクリック・アクションによってノード・リンクがアクティブ化されます。このセクションでは、開発者がツリー属性を編集してツリーをカスタマイズする方法について説明します。

ツリー属性ページにアクセスするには、次のステップを実行します。

1. 適切なページにナビゲートします。「コンポーネント・ビューでのページの表示」を参照してください。

2. リージョン属性ページにアクセスします。「リージョン」で、編集するツリー・リージョンの名前の横にある「ツリー」リンクをクリックします。
対象となる属性を編集します。

ヒント:
属性の詳細は、フィールドレベル・ヘルプを参照してください。「フィールドレベル・ヘルプの表示」を参照してください。

3. 「変更の適用」をクリックします。

15.7 アプリケーションへのJavaScriptの組込みについて

Web配置のすべてのメリットを失わずに、検出されたクライアント/サーバー・アプリケーションを擬似実行するファンクションを追加する最も有効な方法は、JavaScriptをWebアプリケーションに追加する方法です。Oracle Application Expressには、JavaScript追加専用に設計された複数の組込みインタフェース(フック)が含まれています。

JavaScriptは、データ処理集中型検証には適していません。たとえば、名前が大規模データベース表内に含まれていることを検証するには、大容量のHTMLドキュメントを作成して、すべてのレコードをクライアントにプルダウンする必要があります。通常、複雑な操作には、JavaScriptではなくサーバー・サイドApplication Express検証の方がより適しています。詳細は、適切なコントロールまたはコンポーネントのJavaScriptディスカッションを参照してください。

関連項目:
「エスケープされた一重引用符を持つJavaScriptのテキスト」(JavaScriptリテラル文字列内のショートカットの参照の詳細)、「検証の理解」および「プラグインでのJavaScriptコードの使用について」

16 ナビゲーションの追加

データベース・アプリケーションを作成するとき、様々なタイプのナビゲーション・コントロールを含めることができます。使用可能なナビゲーション・オプションは、アプリケーション・テーマによって異なります。共通のナビゲーション・コントロールは、タブ、リスト(ナビゲーション・メニューを含む)、ブレッドクラム、ナビゲーション・バー・エントリおよびブランチです。このセクションでは、アプリケーションでナビゲーションを実装する方法について説明します。

- ナビゲーションとしてのリストの作成について

- タブの作成

- ブレッドクラムの作成

- ナビゲーション・バー・エントリの作成

- ブランチを使用したナビゲーションの制御

関連項目:
「ツリーの作成」

16.1 ナビゲーションとしてのリストの作成について

リストは、リンクの共有コレクションです。リージョンを作成してリージョン・タイプを「リスト」に指定することによって、リストをページに追加します。リストの外観は、リスト・テンプレートで制御します。たとえば、テンプレート「箇条書き付きで、順序付けされていない縦のリスト」を使用すると、ナビゲーションとして機能する静的リストを作成できます。ユニバーサル・テーマ - 42などの新しいテーマでは、ナビゲーション・メニューの作成がサポートされています。ナビゲーション・メニューは、ページ上部に(タブのように)レンダリングされるリストまたはサイド・バーとして表示されるリストです。サンプル・データベース・アプリケーションには、ナビゲーション・メニューが含まれています。

関連項目:
「リストの作成」、「ナビゲーション・メニューについて」および「サンプル・データベース・アプリケーションの理解」

16.2 タブの作成

タブは、アプリケーションのページ間でのナビゲートに有効な方法です。アプリケーションにタブを含めることができるかどうかは、アプリケーション・テーマによって異なります。テーマ26 - 生産性アプリケーションなどの古いテーマには、タブベースのナビゲーションが含まれています。ユニバーサル・テーマ - 42などの新しいテーマには、リストベースのナビゲーション・メニューが含まれています。

アプリケーションには、タブのないページ、1レベルのタブを持つページおよび2レベルのタブを持つページを含めることができます。標準タブを使用した場合は、1レベルのタブのみを表示できます。2レベルのタブを表示するには、親タブと標準タブの両方を定義します。

ヒント:
タブのかわりに、リストを使用してタブ・コントロールを表示できます。リスト・テンプレートを使用すると、HTMLの生成をさらに制御できます。「リストの作成」および「ナビゲーション・メニューについて」を参照してください。

- タブについて

- タブ・ページについて

- タブ・テンプレート・サポートの確認

- タブの作成

- タブの編集

- タブ・レポートへのアクセス

注意:
アプリケーションの作成ウィザードを実行すると、オプションで、タブ付きのアプリケーションを作成できます。次のステップでは、タブ付きでないアプリケーションを作成済であると想定しています。

関連項目:
「データベース・アプリケーションの作成」

16.2.1 タブについて

標準タブは、ページと1対1の関係にしたり、複数のページのカレント・タブにすることができます。アプリケーション・ビルダーには、次の2つのタイプのタブが含まれています。

- 標準タブ
タブが1レベルのみのアプリケーションでは、標準タブ・セットを使用します。標準タブ・セットは、特定のページおよびページ番号に関連付けられます。標準タブを使用すると、特定のページにユーザーをリンクできます。

- 親タブ
親タブは標準タブ・セットの表示を制御できます。親タブをクリックすると、カレント・ページとしてデフォルト・ページを使用して、対応する標準タブが表示されます。親タブによって、別のレベルのナビゲーションおよびアプリケーション内のコンテキスト(または場所)が提供されます。ユーザーが特定のページに関連付けられた特定のURLにリンクするために親タブを使用できます。

タブをタブ・セットと呼ばれるコレクションにグループ化できます。各タブは、タブ・セットに属している必要があります。

ヒント:
タブを使用するアプリケーションの例は、サンプル・パッケージ・アプリケーションであるサンプル・データベース・アプリケーションを参照してください。「サンプル・データベース・アプリケーションの理解」を参照してください。

16.2.2 タブ・ページについて

タブ・ページには、アプリケーションに定義されているタブの説明が表示されます。

タブ・ページにアクセスするには、次のステップを実行します。

1. 共有コンポーネント・ページにナビゲートします。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。
共有コンポーネント・ページが表示されます。

2. 「ナビゲーション」で、「タブ」をクリックします。
タブ・ページが表示されます。

「タブ表示」セクションには、カレント・タブまたはタブ・セットの表示の構成方法に関する追加情報が表示されます。

ページ下部の「ページ・テンプレート」リージョンには、カレント・アプリケーションに関連付けられているページ・テンプレートのレポートが表示されます。このリージョンはデフォルトで非表示になっています。表示するには、ページ・テンプレートの左側にある大なり記号(>)アイコンをクリックします。

関連項目:
「タブ・テンプレート・サポートの確認」および「サンプル・データベース・アプリケーションの理解」

16.2.3 タブ・テンプレート・サポートの確認

親タブおよび標準タブを作成する前に、デフォルトのテンプレートで、適切な置換文字列を使用して標準タブおよび親タブの両方に位置を定義していることを確認する必要があります。このテンプレートは、ページ・レベルで上書きしないでください。

ページ・テンプレートを表示するには、次のステップを実行します。

1. 共有コンポーネント・ページにナビゲートします。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。
共有コンポーネント・ページが表示されます。

2. 「ナビゲーション」で、「タブ」をクリックします。
タブ・ページが表示されます。

3. ページの下部の「ページ・テンプレート」に移動します。必要に応じて、「ページ・テンプレート」リージョンを拡張します。

関連項目:
「ページ・テンプレート」および「テーマの使用」(アプリケーション・レベルでのデフォルト・ページ・テンプレート設定の詳細について)

16.2.4 タブの作成

アプリケーションには、タブのないページ、1レベルのタブを持つページおよび2レベルのタブを持つページを含めることができます。標準タブを使用した場合は、1レベルのタブのみを表示できます。2レベルのタブを表示するには、親タブと標準タブの両方を定義する必要があります。

タブを作成するには:

1. タブ・ページにアクセスします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

4. 「ナビゲーション」で、「タブ」をクリックします。

2. 「タブの管理」をクリックします。

3. 親タブを追加するには、上の行の「追加」ボタンをクリックします。
アプリケーションで定義されたタブがグラフィカルに表示されます。

親タブは標準タブ・セットの表示を制御できます。親タブをクリックすると、カレント・ページとしてデフォルト・ページを使用して、対応する標準タブが表示されます。

4. 標準タブを作成するには、下の行の「追加」ボタンをクリックします。

親タブの作成ウィザードまたは標準タブの作成ウィザードが表示されます。

5. 画面に表示されるステップに従います。

関連項目:
「タブについて」

16.2.5 タブの編集

この項では、タブの編集方法について説明します。複数のタブを同時に編集できます。また、標準タブを使用している場合は、「標準タブのタスク」リストを使用して、ラベルや順序などのタブのプロパティを更新できます。

- 複数のタブの同時編集

- 標準タブの管理

16.2.5.1 複数のタブの同時編集

複数のタブを同時に編集するには、次のステップを実行します。

1. 「タブ」ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「ナビゲーション」で、「タブ」をクリックします。

2. ページ上部で次のいずれかのタブをクリックします。

- 標準タブの編集

- 親タブの編集

レポートが表示されます。

3. 特定のタブを編集するには、「編集」アイコンをクリックします。

4. 該当する属性を編集し、「変更の適用」をクリックします。

16.2.5.2 標準タブの管理

「標準タブのタスク」リストが「タブ」ページの右側に表示されます。このリスト上のリンクにアクセスすると、標準タブの異なる親タブへの移動、標準タブ・セットの名前の変更、表示順序の変更、タブ・セットへのページの関連付け、新規標準タブの作成または新規標準タブ・セットの作成ができます。

「標準タブのタスク」リストにアクセスするには、次のステップを実行します。

1. 「タブ」ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「ナビゲーション」で、「タブ」をクリックします。

2. 「タブの管理」をクリックします。

3. ページの右側にある「標準タブのタスク」リストから選択します。

- 選択した標準タブを異なる親タブに移動

- 標準タブ・セット名の変更

- 表示順序の変更

- 選択した標準タブでページを関連付け

- 新しい標準タブの作成

- 新しい標準タブ・セットの作成

16.2.6 タブ・レポートへのアクセス

このセクションでは、「条件付き表示」、「使用状況」および「履歴」レポートについて説明します。

「条件付き表示」レポートを表示するには、次のステップを実行します。

1. 「タブ」ページにナビゲートします。

1. 「ワークスペース」ホームページにナビゲートします。

2. 「アプリケーション・ビルダー」アイコンをクリックします。

3. アプリケーションを選択します。

4. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

5. 「ナビゲーション」で、「タブ」をクリックします。
タブ・ページが表示されます。

2. 該当するタブをクリックします。

- 条件付き表示 - 条件付き表示レポートには、条件付きで表示するように構成された標準タブと親タブが表示されます。表示をフィルタ処理するには、タブ・タイプを選択して、「実行」をクリックします。

- 使用状況 - 使用状況レポートには、カレント・アプリケーションで使用されている標準タブが一覧表示されます。

- 履歴 - 履歴レポートには、カレント・アプリケーションのタブ属性に対する変更の履歴が表示されます。

16.3 ブレッドクラムの作成

この項では、ブレッドクラムの作成および管理方法について説明します。ブレッドクラムを使用すると、階層的にナビゲートできます。ブレッドクラムは、テンプレートを使用して表示されるリンクの階層的なリストです。ブレッドクラムは、リンクのリストまたはブレッドクラム・パスとして表示できます。

- ブレッドクラムとは

- ページ作成中のブレッドクラムの作成

- ブレッドクラムの編集

- ブレッドクラム・エントリの親の変更

- 未使用のブレッドクラム・エントリの削除

- ブレッドクラム・レポートへのアクセス

関連項目:
「テーマの作成」および「ブレッドクラム・テンプレート」

16.3.1 ブレッドクラムとは

ブレッドクラムは、アプリケーション内のどの部分が表示されているかを階層で示すリンクの階層リストです。特定のブレッドクラム・リンクをクリックすると、すぐにページを表示できます。各ページの上部でナビゲーションの第2レベルとしてブレッドクラムを使用し、タブおよびリストなどの他のユーザー・インタフェース要素を補完します。

関連項目:
「サンプル・データベース・アプリケーションの理解」

16.3.2 ページ作成中のブレッドクラムの作成

ページの作成中にブレッドクラムを作成するには、次のステップを実行します。

1. ページの作成ウィザードを実行して、新規ページを追加します。「データベース・アプリケーションのページの管理」を参照してください。
ウィザードの途中で、「ブレッドクラム」オプションが表示されます。このリストが表示される実際のページは、作成するページのタイプによって異なります。

2. 「ブレッドクラム」リストから、「ブレッドクラム」を選択するか、既存のブレッドクラムを選択します(使用可能な場合)。

3. 「ブレッドクラム」を選択する場合は、次のステップを実行します。

1. 親エントリ - 親ページ(使用可能な場合)を選択するか、「親エントリなし」を選択します。

2. エントリ名 - ブレッドクラムの名前を入力します。

4. 画面に表示されるステップに従います。

16.3.3 ブレッドクラムの手動作成

この項では、ブレッドクラムを手動で作成する方法について説明します。

- ブレッドクラムの手動作成について

- ブレッドクラムの作成

- ブレッドクラム・エントリの追加

- ブレッドクラム・リージョンの追加

- 動的ブレッドクラムの作成について

16.3.3.1 ブレッドクラムの手動作成について

ブレッドクラムを手動で作成するには、次のように、アプリケーションの各ページにブレッドクラムを追加する必要があります。

- ステップ1: ブレッドクラムの作成/編集ウィザードを実行してブレッドクラムを作成します。このウィザードには、共有コンポーネント・ページ、ページ・デザイナまたはコンポーネント・ビューからアクセスできます。「ブレッドクラムの作成」を参照してください。

- ステップ2: ブレッドクラムにエントリを追加します。「ブレッドクラム・エントリの追加」を参照してください。

- ステップ3: リージョンを作成して、ブレッドクラムをページに追加します。「ブレッドクラム・リージョンの追加」を参照してください。

16.3.3.2 ブレッドクラムの作成

この項では、ブレッドクラムを作成する様々な方法について説明します。

- 共有コンポーネントとしてのブレッドクラムの作成

- ページ・デザイナからのブレッドクラムの作成

- コンポーネント・ビューからのブレッドクラムの作成

16.3.3.2.1 共有コンポーネントとしてのブレッドクラムの作成

共有コンポーネント・ページからブレッドクラムを作成するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

4. 「ナビゲーション」で、「ブレッドクラム」をクリックします。
ブレッドクラム・ページが表示されます。

5. 「ブレッドクラムの作成」をクリックします。

6. 名前を入力して、「作成」をクリックします。

7. ブレッドクラム・エントリを追加します。「ブレッドクラム・エントリの追加」を参照してください。

16.3.3.2.2 ページ・デザイナからのブレッドクラムの作成

ページ・デザイナからブレッドクラムを作成するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。「ページ・デザイナでのページの表示」を参照してください。

2. ページ・デザイナ・ツールバーで、「作成」メニューをクリックして「共有コンポーネント」を選択します。

3. 「アプリケーション・コンポーネントの作成」で、「ブレッドクラム」を選択して「次へ」をクリックします。

4. 「ブレッドクラム名」に、このブレッドクラムの名前を入力して「作成」をクリックします。

5. 名前付きのブレッドクラムを作成した後、ブレッドクラム・エントリを追加できます。「ブレッドクラム・エントリの追加」を参照してください。

16.3.3.2.3 コンポーネント・ビューからのブレッドクラムの作成

コンポーネント・ビューからブレッドクラムを作成するには、次のステップを実行します。

1. コンポーネント・ビューでページを表示します。「コンポーネント・ビューでのページの表示」を参照してください。

2. 「作成」メニューをクリックして、「共有コンポーネント」を選択します。

3. 「アプリケーション・コンポーネントの作成」で、「ブレッドクラム」を選択して「次へ」をクリックします。

4. 「ブレッドクラム名」に、このブレッドクラムの名前を入力して「作成」をクリックします。

5. 名前付きのブレッドクラムを作成した後、ブレッドクラム・エントリを追加できます。「ブレッドクラム・エントリの追加」を参照してください。

16.3.3.3 ブレッドクラム・エントリの追加

ブレッドクラム・エントリを追加するには、次のステップを実行します。

1. ブレッドクラム・ページにナビゲートします。

1. 「ワークスペース」ホームページにナビゲートします。

2. 「アプリケーション・ビルダー」アイコンをクリックします。

3. アプリケーションを選択します。

4. 「共有コンポーネント」をクリックします。

5. 「ナビゲーション」で、「ブレッドクラム」をクリックします。
ブレッドクラム・ページが表示されます。

2. エントリを追加するブレッドクラムを選択します。

3. 「ブレッドクラム・エントリの作成」をクリックします。

4. 「ブレッドクラム」で、このブレッドクラム・エントリが表示されるページを選択します。

5. 「エントリ」で、次の項目を指定します。

1. 順序: ブレッドクラム・エントリを表示する順序を指定します。これによって評価の順序が決まります。

2. 親エントリ: このエントリの親を指定します。ブレッドクラムには、親IDを持たないアイテムとして識別されるルート・ノードが1つのみ必要です。

3. 短縮名: このブレッドクラム・エントリの短縮名を指定します。ブレッドクラム・テンプレートから、短縮名と詳細名の両方を参照できます。

4. 詳細な名前: このブレッドクラム・エントリの詳細名を指定します。ブレッドクラム・テンプレートから、短縮名と詳細名の両方を参照できます。

6. 「ターゲット」で、ターゲットの場所を指定します。

1. ターゲットは: 「このアプリケーションのページ」を選択します。

2. ページ: ターゲット・ページ番号を指定します。
ページのページ区切りをリセットするには、「このページのページ区切りをリセット」を選択します。

3. リクエスト: REQUESTと呼ばれる組込みアプリケーション・アイテムを設定するテキストを入力します。これは、クリックしたボタンの名前で設定されるアイテムでもあります。

4. キャッシュのクリア: ユーザーのセッション・ステートをクリアするページのページ番号を、カンマで区切って入力します。

5. セッション・ステートを設定するには(リストされたアイテムに値を与えます)、次のステップを実行します。

- 次のアイテムを設定 - セッション・ステートを設定(リストしたアイテムに値を指定)するアプリケーション・アイテム名をカンマで区切って入力します。

- 次の値を使用 - 次のアイテムを「設定」で指定したアイテムの値をカンマで区切って入力します。静的な値または置換構文(&APP_ITEM_NAME.など)を指定できます。
静的な値または置換構文(&APP_ITEM_NAME.など)を指定できます。URLのf?p=に渡されるアイテム値にはコロン(:)を使用しないでください。また、バックスラッシュでアイテム値全体を囲んだ場合(\1234,56\など)を除いて、カンマも使用しないでください。

7. 「条件」で、次のステップを実行します。

1. 条件タイプ: リストから条件タイプを選択します。この条件は、このコンポーネントをレンダリングまたは処理するために必要です。

2. 表示されるフィールドに式を入力します。

8. 「認可」で、オプションで認可スキームを選択します。この認可スキームは、このコンポーネントをレンダリングまたは処理するためにTRUEと評価される必要があります。

9. 「構成」で、このコンポーネントのビルド・オプションを選択します。ビルド・オプションは、アプリケーション内のコンポーネントが有効かどうかを判別する事前定義された設定です。

10. 「ブレッドクラム・エントリの作成」をクリックします。

作成する各ブレッドクラム・エントリに対して、これらのステップを実行します。

16.3.3.4 ブレッドクラム・リージョンの追加

リージョンはページ上の領域で、コンテンツのコンテナとして機能します。ブレッドクラムおよびブレッドクラム・テンプレートを作成した後、リージョンを作成します。ブレッドクラム・リージョンを作成すると、ページにブレッドクラムを追加できます。

- ページ・デザイナでのブレッドクラム・リージョンの追加

- コンポーネント・ビューでのブレッドクラム・リージョンの追加

関連項目:
メニュー表示の変更方法については、「新しいテンプレートの作成」および「ブレッドクラム・テンプレート」を参照してください。

16.3.3.4.1 ページ・デザイナでのブレッドクラム・リージョンの追加

ページ・デザイナでブレッドクラム・リージョンを作成するには、次のステップを実行します。

1. ページ・デザイナで適切なページにナビゲートします。「ページ・デザイナでのページの表示」を参照してください。
ページ・デザイナが表示されます。ページ下部にギャラリが表示されます。コントロールまたはコンポーネントにカーソルをあわせると、それについて説明するツールチップが表示されます。

2. ギャラリの「リージョン」から、「ブレッドクラム」を選択して、グリッド・レイアウトの適切な場所にドラッグします。
ページ・デザイナは、次に必要なアクションを示します。

「メッセージ」タブには、対応する必要のあるメッセージを示す赤または黄色のバッジが表示されます。「メッセージ」タブには、2つのタイプのメッセージが表示されます

- エラー - エラー・メッセージは赤で表示されます。エラー・メッセージを選択すると、プロパティ・エディタに関連する属性が赤で表示されます。ページを保存する前にエラーに対処する必要があります。

- 警告 - 警告メッセージは黄色で表示されます。警告メッセージを選択すると、プロパティ・エディタで、関連する属性が黄色で表示されます。ページを保存する前にエラーに対処する必要があります。警告メッセージには対処しないでページを保存できることに注意してください。

3. プロパティ・エディタですべての属性を表示します。「プロパティ・エディタ・メニュー」から「すべて表示」を選択します。
必要な属性は、属性ラベルの1つ上の左上隅に赤い三角形で表示されます。

4. プロパティ・エディタで該当する属性を編集します。

ヒント:
属性の詳細は、プロパティ・エディタで属性を選択し、中央ペインで「ヘルプ」タブをクリックして、参照してください。

1. 指定、タイトル - リージョン・タイトルを入力します。リージョン・タイトルは、リージョン・テンプレートに定義されている場合にのみ表示されます。

2. レイアウト、順序 - このアイテムの表示順序を入力します。順序および他のグリッド・レイアウト設定によって、リージョン内の他のアイテムに対して相対的に、このアイテムの表示位置が決定されます。

3. レイアウト、位置 - このリージョンの表示に使用されるテンプレートの位置を選択します。使用可能な選択肢は、ページのユーザー・インタフェースに対して現在のテーマ内に定義されている適切なテンプレートの位置から導出されます。

4. 外観、テンプレート - リージョン・テンプレートを選択します。

5. 外観、アイテム表示位置 - メイン・リージョン・コンテンツに対して相対的に、ページ・アイテムの表示位置を指定します。

5. 「保存」をクリックします。

ブレッドクラム・ナビゲーションを追加する各ページに対して、これらのステップを実行します。

16.3.3.4.2コンポーネント・ビューでのブレッドクラム・リージョンの追加

コンポーネント・ビューでブレッドクラム・リージョンを作成するには、次のステップを実行します。

1. 適切なページにナビゲートします。「コンポーネント・ビューでのページの表示」を参照してください。

2. 「リージョン」で、「作成」アイコンをクリックします。
「リージョンの作成」ウィザードが表示されます。

3. リージョン・タイプについて、「ブレッドクラム」を選択して「次へ」をクリックします。

4. 「ブレッドクラム・コンテナ・リージョン」で、次のステップを実行します。

1. リージョン・タイトル: リージョンのタイトルを入力します。

2. リージョン・テンプレート: リージョン・テンプレートを選択します。

3. 表示ポイント: 表示ポイントを選択します。
リージョンは、位置(または表示ポイント)別に編成されています。リージョンの適切な位置を決定するには、懐中電灯アイコンをクリックします。グラフィカルな画面が表示されます。

4. 順序: 順序の番号を入力します。これによって評価の順序が決まります。

5. 「次へ」をクリックします。

5. 「ブレッドクラム」で、次のステップを実行します。

1. ブレッドクラム: このリージョンに関連付けるブレッドクラムを選択します。

2. ブレッドクラム・テンプレート: テンプレートを選択します。

3. 「次へ」をクリックします。

6. ブレッドクラム・リージョンの情報を確認し、「次へ」をクリックします。

7. 「終了」をクリックします。

ブレッドクラム・ナビゲーションを追加する各ページに対して、これらのステップを実行します。

16.3.3.5 動的ブレッドクラムの作成について

より詳細なコンテキストを表示するために、ブレッドクラムにセッション・ステートを含めて、ブレッドクラムを動的にすることができます。たとえば、アプリケーションのページに特定の会社への注文リストが表示される場合に、次のブレッドクラムを含めるとします。

Home > Orders > Orders for ACME Inc

この例で、ACME Incは、ユーザーが現在表示しているページおよびナビゲーション・パスも示しています。Application Expressエンジンによって、ACME Inc.のセッション・ステートの値が格納されます。

このタイプの動的メニューを作成するには、ブレッドクラムの短縮名または詳細な名前に、セッション・ステート・アイテムへの参照を含める必要があります。次に例を示します。

&COMPANY_NAME.

16.3.4 ブレッドクラムの編集

作成したブレッドクラムは、ブレッドクラム・ページで編集できます。

ブレッドクラムを編集するには、次のステップを実行します。

1. ブレッドクラム・ページにナビゲートします。

1. 「ワークスペース」ホームページにナビゲートします。

2. 「アプリケーション・ビルダー」アイコンをクリックします。

3. アプリケーションを選択します。

4. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

5. 「ナビゲーション」で、「ブレッドクラム」を選択します。
ブレッドクラム・ページが表示されます。

2. ブレッドクラムを選択します。

3. ブレッドクラム・エントリを選択します。
作成/編集ページが表示されます。

4. 対象となる属性を編集します。
特定のアイテムの詳細は、フィールドレベル・ヘルプを参照してください。「フィールドレベル・ヘルプの表示」を参照してください。

5. (オプション)ページ右側にある「ブレッドクラム・エントリ」リストで、ページ名とタイトルとのブレッドクラムの同期化に関するオプションを選択できます。
このオプションを選択することで、ページ名とブレッドクラムの変更が1ステップでできるようになります。ブレッドクラム名に指定した情報は、参照ページ名とタイトルの更新に使用されます。

6. 「変更の適用」をクリックします。

関連項目:
「ブレッドクラム・レポートへのアクセス」

16.3.5 ブレッドクラム・エントリの親の変更

エントリの親の変更ページの選択ブレッドクラム・エントリに新たな親を選択できます。

ブレッドクラム・エントリの親を変更するには、次のステップを実行します。

1. ブレッドクラム・ページにナビゲートします。

1. 「ワークスペース」ホームページにナビゲートします。

2. 「アプリケーション・ビルダー」アイコンをクリックします。

3. アプリケーションを選択します。

4. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

5. 「ナビゲーション」で、「ブレッドクラム」を選択します。
ブレッドクラム・ページが表示されます。

2. ブレッドクラムを選択します。
エントリ・ページが表示されます。

3. 「タスク」リストから、「このブレッドクラム内におけるエントリの親の変更」をクリックします。
エントリの親の変更ページが表示されます。

4. ビューを編集またはフィルタを適用するためにナビゲーション・バーを使用するには、次のステップを実行します。

- ブレッドクラム: 編集するブレッドクラムを指定して、「実行」をクリックします。

- 開始: ブレッドクラム階層のサブセットの表示の制限を選択し、「実行」をクリックします。

5. 「親の変更先」から、新たな親を選択します。

6. 移動するブラッドクラム・エントリを選択し、「チェックしたエントリの親の変更」をクリックします。

16.3.6 未使用のブレッドクラム・エントリの削除

未使用のブレッドクラム・エントリを削除するには、次のステップを実行します。

1. ブレッドクラム・ページにナビゲートします。

1. 「ワークスペース」ホームページにナビゲートします。

2. 「アプリケーション・ビルダー」アイコンをクリックします。

3. アプリケーションを選択します。

4. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

5. 「ナビゲーション」で、「ブレッドクラム」を選択します。
ブレッドクラム・ページが表示されます。

2. ブレッドクラムを選択します。
ブレッドクラム・エントリ・ページが表示されます。

3. 「タスク」リストで、「未使用のブレッドクラム・エントリの削除」をクリックします。
削除ページが表示されます。

4. 削除するエントリを選択し、「チェックした項目の削除」をクリックします。

16.3.7 ブレッドクラム・レポートへのアクセス

ブレッドクラム・ページ上部の該当するタブをクリックして、「ブレッドクラム階層」、「ブレッドクラムのグリッド編集」、「ブレッドクラムの例外」、「ブレッドクラムの使用状況」および「ブレッドクラム履歴」レポートを表示できます。

注意:
これらのレポートが表示されるのは、ブレッドクラムを作成した後のみです。

ブレッドクラム・レポートを表示するには、次のステップを実行します。

1. ブレッドクラム・ページにナビゲートします。

1. 「ワークスペース」ホームページにナビゲートします。

2. 「アプリケーション・ビルダー」アイコンをクリックします。

3. アプリケーションを選択します。

4. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

5. 「ナビゲーション」で、「ブレッドクラム」を選択します。
ブレッドクラム・ページが表示されます。

2. 該当するタブをクリックします。

- 階層 - 「階層」をクリックすると、ブレッドクラムがページおよび階層別に表示されます。ページにリンクするにはページ番号をクリックします。

- グリッド編集 - 「グリッド編集」をクリックすると、一度にすべてのブラッドクラム名を編集できます。ページにリンクするにはページ番号をクリックします。

- 例外 - 「例外」をクリックすると、例外ページが表示されます。

- 使用状況
「使用状況」をクリックすると、ブレッドクラム・レポートにアクセスできます。このレポートには、ブレッドクラムがページごとに表示されます。ページ番号をクリックして、特定のページに進みます。

- 履歴 - 「履歴」をクリックすると、ブレッドクラムの履歴レポートにアクセスできます。このレポートには、ブレッドクラムの最近の変更が示されます。

ページの外観は、ページ上部にある検索バーを使用して変更できます。「エンド・ユーザーとしての対話モード・レポートのカスタマイズ」を参照してください。

16.4 ナビゲーション・バー・エントリの作成

この項では、ナビゲーション・バー・エントリを作成および編集する方法について説明します。ナビゲーション・バー・エントリを使用すると、アプリケーションのページ間を容易に移動できます。たとえば、ナビゲーション・エントリを使用すると、イメージまたはテキストからのリンクを表示できます。関連付けられたページ・テンプレートによってナビゲーション・バーの位置が決定します。

- ナビゲーション・バーについて

- ナビゲーション・バー・エントリの作成

- ナビゲーション・バー・エントリのコピー

- ナビゲーション・バー・エントリの編集

- 複数のナビゲーション・バー・エントリの同時編集

- ナビゲーション・バー・エントリ・レポートへのアクセス

関連項目:
「カスタム・テーマの作成」

16.4.1 ナビゲーション・バーについて

ナビゲーション・バー・エントリは、イメージ、テキストまたは下にテキストが付いているイメージです。ナビゲーション・バー・エントリに使用するイメージおよびテキストを入力する必要があります。

ナビゲーション・バーは、ページごとにこれらを参照する必要がないという点で、他の共有コンポーネントとは異なります。使用するページ・テンプレートに#NAVIGATION_BAR#置換文字列が含まれている場合、Application Expressエンジンは、ページをレンダリングする際、自動的に定義済ナビゲーション・バーを含めます。

関連項目:
「サンプル・データベース・アプリケーションの理解」

16.4.2 ナビゲーション・バー・エントリの作成

ナビゲーション・バーを追加する前に、ナビゲーション・バー・エントリを作成する必要があります。ナビゲーション・バー・エントリは、最初から作成するか、または既存のエントリをコピーして作成できます。

- ナビゲーション・バー・エントリを最初から作成

- フィードバック用ナビゲーション・バー・エントリの作成

16.4.2.1 ナビゲーション・バー・エントリを最初から作成

ナビゲーション・バー・エントリを最初から作成するには、次のステップを実行します。

1. ナビゲーション・バー・エントリ・ページにナビゲートします。

1. 「ワークスペース」ホームページにナビゲートします。

2. 「アプリケーション・ビルダー」アイコンをクリックします。

3. アプリケーションを選択します。

4. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

5. 「ナビゲーション」で、「ナビゲーション・バー・エントリ」をクリックします。

2. 「作成」をクリックします。
ナビゲーション・バー・エントリの作成ウィザードが表示されます。

3. 「方法」で、「最初から」を選択します。

4. 「タイプ」で、「URLへのナビゲーション」を選択します。

ヒント:
フィードバックの詳細は、「フィードバック用ナビゲーション・バー・エントリの作成」を参照してください。

5. 「属性」で、次のように指定します。

1. 順序: このコンポーネントの評価の順序を指定します。

ヒント:
既存のエントリを確認するには、ページ下部の「既存のナビゲーション・バー・エントリ」リンクをクリックします。

2. エントリ・ラベル: このナビゲーション・バー・エントリの表示テキストを入力します。

3. アイコン・イメージ名: イメージ名を入力します。ネーミング規則の詳細は、フィールドレベル・ヘルプを参照してください。「フィールドレベル・ヘルプの表示」を参照してください。

4. イメージALT: イメージのナビゲーション・アイコンのALTテキストを入力します。イメージ名を指定しないと、このテキストが表示されます。

5. イメージの高さ: イメージの高さをピクセルで定義します。

6. 幅: イメージの幅を定義します。

7. 「次へ」をクリックします。

6. 「ターゲット」で、次のように指定します。

1. ターゲット位置がURLの場合、次を指定します。

- ターゲットは: 「URL」を選択します。

- URLターゲット: URLを入力します。次に例を示します。

http://www.yahoo.com

2. ターゲット位置がページの場合、次を指定します。

- ターゲットは: 「このアプリケーションのページ」を選択します。

- ページ: ターゲット・ページ番号を指定します。
ページ区切りをリセットするには「このページのページ区切りをリセット」を選択します。

アプリケーションの「印刷用」テンプレートを使用してターゲット・ページを表示するには、「印刷用」を選択します。「印刷用」テンプレートにより、印刷用ページが最適化されます。「テーマの編集」および「印刷用ページの最適化」を参照してください。

- リクエスト: REQUESTと呼ばれる組込みアプリケーション・アイテムを定義するテキストを入力します。

- キャッシュのクリア: ユーザーのセッション・ステートをクリアするページ番号を入力します。複数入力するときはカンマで区切ります。

3. セッション・ステートを設定するには(リストされたアイテムに値を与えます)、次のステップを実行します。

- 次のアイテムを設定: セッション・ステートを設定するアプリケーション・アイテム名のリストを入力します。複数のアイテムはカンマで区切ります。セッション・ステートを設定すると、リストしたアイテムに値が指定されます。

- 次の値を使用: 指定したアイテムの値をカンマで区切って入力します。
静的な値または置換構文(&APP_ITEM_NAME.など)を指定できます。URLのf?p=に渡されるアイテム値にはコロン(:)を使用しないでください。また、バックスラッシュでアイテム値全体を囲んだ場合(\1234,56\など)を除いて、カンマも使用しないでください。

4. 「次へ」をクリックします。

7. ナビゲーション・バー・エントリを表示するための条件を設定するには、条件タイプを選択します。

8. 「作成」をクリックします。

ヒント:
ナビゲーション・バーを表示するには、使用するページ・テンプレートに#NAVIGATION_BAR#置換文字列が含まれている必要があります。詳細は、「ページ・テンプレート」を参照してください。

16.4.2.2 フィードバック用ナビゲーション・バー・エントリの作成

フィードバックは、アプリケーション・ユーザーからリアルタイム・コメント、拡張リクエストおよびバグを収集するプロセスです。アプリケーションにフィードバック・ページを追加するには、フィードバック・ページを追加します。

フィードバック用ナビゲーション・バー・エントリを作成するには、次のステップを実行します。

1. ナビゲーション・バー・エントリ・ページにナビゲートします。

1. 「ワークスペース」ホームページにナビゲートします。

2. 「アプリケーション・ビルダー」アイコンをクリックします。

3. アプリケーションを選択します。

4. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

5. 「ナビゲーション」で、「ナビゲーション・バー・エントリ」をクリックします。

2. 「作成」をクリックします。
ナビゲーション・バー・エントリの作成ウィザードが表示されます。各ウィザード・ページには、左側にステップの順序を示す一連のブロックが表示されます。ハイライトされたブロックは実行中のステップを表します。

3. 「方法」で、「最初から」を選択します。

4. 「タイプ」で、「フィードバック」を選択します。

5. 「フィードバック」で、次のステップを実行します。

1. フィードバック・ページ: フィードバック・ページを選択します。

2. エントリ・ラベル: 新しいナビゲーション・バー・エントリのラベルを入力します。

3. 表示順序: 新しいナビゲーション・バー・エントリの順序を指定します。これによって評価の順序が決まります。

6. 「作成」をクリックします。

関連項目:
「フィードバックの管理」

ヒント:
ナビゲーション・バーを表示するには、使用するページ・テンプレートに#NAVIGATION_BAR#置換文字列が含まれている必要があります。「ページ・テンプレート」を参照してください。

16.4.3 ナビゲーション・バー・エントリのコピー

ナビゲーション・バー・エントリをコピーするには、次のステップを実行します。

1. ナビゲーション・バー・エントリ・ページにナビゲートします。

1. 「ワークスペース」ホームページにナビゲートします。

2. 「アプリケーション・ビルダー」アイコンをクリックします。

3. アプリケーションを選択します。

4. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

5. 「ナビゲーション」で、「ナビゲーション・バー・エントリ」をクリックします。

2. 「作成」をクリックします。
ナビゲーション・バー・エントリの作成ウィザードが表示されます。

3. 「方法」で、「既存のナビゲーション・バーのコピーとして」を選択して、「次へ」をクリックしてください。

4. 「コピー元アプリケーション」で、アプリケーションを選択して、「次へ」をクリックします。

5. 「新しい名前」で、新しいエントリの名前を入力し、コピーおよびサブスクライブするかどうかを選択します。

6. 「ナビゲーション・バー・エントリのコピー」をクリックします。

16.4.4 ナビゲーション・バー・エントリの編集

作成したナビゲーション・バー・エントリは、ナビゲーション・バー・エントリ・ページで編集できます。

ナビゲーション・バー・エントリを編集するには、次のステップを実行します。

1. ナビゲーション・バー・エントリ・ページにナビゲートします。

1. 「ワークスペース」ホームページにナビゲートします。

2. 「アプリケーション・ビルダー」アイコンをクリックします。

3. アプリケーションを選択します。

4. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

5. 「ナビゲーション」で、「ナビゲーション・バー・エントリ」をクリックします。

ナビゲーション・バー・エントリ・ページが表示されます。

2. ナビゲーション・バー・エントリを選択します。
編集ページが表示されます。

3. 対象となる属性を編集します。

4. ページの特定アイテムの詳細は、フィールドレベル・ヘルプを参照してください。「フィールドレベル・ヘルプの表示」を参照してください。

5. 「変更の適用」をクリックします。

16.4.5 複数のナビゲーション・バー・エントリの同時編集

複数のナビゲーション・バー・エントリを同時に編集するには、次のステップを実行します。

1. ナビゲーション・バー・エントリ・ページにナビゲートします。

1. 「ワークスペース」ホームページにナビゲートします。

2. 「アプリケーション・ビルダー」アイコンをクリックします。

3. アプリケーションを選択します。

4. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

5. 「ナビゲーション」で、「ナビゲーション・バー・エントリ」をクリックします。

2. ページ上部の「グリッド編集」をクリックします。

3. 該当する属性を編集し、「変更の適用」をクリックします。

16.4.6 ナビゲーション・バー・エントリ・レポートへのアクセス

「ナビゲーション・バー・エントリ」ページ上部の該当するタブをクリックすると、ナビゲーション・バー・エントリ・サブスクリプションおよびナビゲーション・バー・エントリ履歴のレポートを表示できます。

注意:
「サブスクリプション」ボタンと「履歴」ボタンが表示されるのは、ナビゲーション・バーを作成した後のみです。

1. ナビゲーション・バー・エントリ・ページにナビゲートします。

1. 「ワークスペース」ホームページにナビゲートします。

2. 「アプリケーション・ビルダー」アイコンをクリックします。

3. アプリケーションを選択します。

4. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

5. 「ナビゲーション」で、「ナビゲーション・バー・エントリ」をクリックします。

2. 該当するタブをクリックします。

- サブスクリプション - 「サブスクリプション」をクリックすると、「サブスクライブされたナビゲーション・バー」レポートにアクセスできます。このレポートには、アプリケーションでサブスクライブされたナビゲーション・バー・エントリが表示されます。

- 履歴 - 「履歴」をクリックすると、「ナビゲーション・バー履歴」レポートにアクセスできます。このレポートには、ナビゲーション・バーの最近の変更が示されます。

16.5 ブランチを使用したナビゲーションの制御

この項では、アプリケーションへのブランチの追加方法について説明します。ブランチは、指定したページが送信された後の特定のページ、プロシージャまたはURLへのリンクに対する指示です。たとえば、ページ1の送信後、ページ1からページ2にブランチできます。

- ページ・デザイナでのブランチの作成

- コンポーネント・ビューでのブランチの作成

- 条件付きブランチ処理について

関連項目:
「クロス・ページ・ユーティリティの使用」

16.5.1 ページ・デザイナでのブランチの作成

ページ・デザイナでブランチを作成するには、次のステップを実行します。

1. ページに移動します。「コンポーネント・ビューでのページの表示」を参照してください。

2. 「レンダリング」または「プロセス」タブで、プロセスが発生するノードを探します。「ブランチ」を右クリックして、「ブランチの作成」を選択します。
プロセス属性がプロパティ・エディタに表示されます。

ヒント:
「メッセージ」タブに、対処が必要なメッセージを示す赤または黄色の印が表示されます。メッセージを選択すると、プロパティ・エディタに関連する属性が表示されます。赤いエラー・メッセージは、保存する前に対処する必要があります。

3. プロパティ・エディタですべての属性を表示します。「プロパティ・エディタ・メニュー」から「すべて表示」を選択します。

ヒント:
属性の詳細は、プロパティ・エディタで属性を選択し、中央ペインで「ヘルプ」タブをクリックして、参照してください。

4. 「指定」の「名前」で、開発者が簡単に識別できるブランチ名を指定します。

5. 「実行オプション」で、次のステップを実行します。

1. 順序: このコンポーネントの順序を指定します。これによって評価の順序が決まります。

2. ポイント: このブランチ・アクションが考慮される処理内のポイントを選択します。

6. 「動作」の「タイプ」で、ページ・ブランチ・タイプを選択します。
プロパティ・エディタに表示される属性は、選択したブランチ・タイプによって異なります。詳細は、「ヘルプ」タブをクリックしてください。

タイプが「ページまたはURL(リダイレクト)」の場合、「ターゲット」フィールドをクリックして、リンク・ビルダー・ターゲット・ダイアログで属性を編集します。

7. 「条件」で、次のステップを実行します。

1. 対象ボタン - ユーザーが特定のボタンをクリックした場合にのみこのブランチを実行するには、リストからボタンを選択します。このボタンの条件を他の条件と統合し、このブランチをいつ実行するかをさらに絞り込むことができます。

2. 条件タイプ: このコンポーネントをレンダリングまたは処理するために満たす必要がある条件タイプをリストから選択します。

8. 「保存」をクリックします。

関連項目:
「「対象ボタン」属性について」、「レンダリング前ブランチ、計算およびプロセスの作成」および「ページ送信ブランチ、検証、計算およびプロセスの作成」

16.5.2 コンポーネント・ビューでのブランチの作成

ブランチの作成ウィザードを実行し、ブランチ・ポイントおよびブランチ・タイプを指定すると、ブランチを作成できます。

ブランチを作成するには、次のステップを実行します。

1. ページに移動します。「コンポーネント・ビューでのページの表示」を参照してください。

2. 「ブランチ」で、「作成」アイコンをクリックします。
ブランチの作成ウィザードが表示されます。

3. 「ブランチ属性」で、次のステップを実行します。

1. 名前: 開発者が簡単に識別できるブランチ名を指定します。

2. 順序: このコンポーネントの順序を指定します。これによって評価の順序が決まります。

3. ブランチ・ポイント: ブランチ・ポイントを選択します。オプションは次のとおりです。

- 送信時: 計算の前: 計算、検証またはプロセスの前にブランチが実行されます。このオプションは、プロセスを起動する必要がないボタン(「取消」ボタンなど)に使用します。

- 送信時: 検証の前: 計算の後、検証またはプロセスの前にブランチが実行されます。検証が失敗すると、ページ・プロセスは停止し、ロールバックが実行され、ページにエラーが表示されます。このデフォルト動作のために、ブランチを作成して検証を提供する必要がありません。ただし、計算の結果に応じてブランチする必要がある場合があります(たとえば、前のブランチ・ポイントに戻る場合)。

- 送信時: プロセスの前: 計算および検証の後、プロセスの前にブランチが実行されます。このオプションを使用すると、検証されたセッション・ステートに基づいて、ページ・プロセスの実行前にブランチされます。

- 送信時: プロセスの後: 計算、検証およびプロセスの後にブランチが実行されます。このオプションを使用すると、計算、検証およびプロセスの実行後にURLまたはページにブランチされます。このオプションを使用する際、任意のブランチ・ポイントに複数のブランチが存在する場合は、ブランチを順序付ける必要があります。

- ロード時: ヘッダーの前: ページのレンダリング前にブランチが実行されます。このオプションを使用すると、カレント・ページではなく別のページが表示されるか、またはユーザーが別のURLまたはプロシージャにリダイレクトされます。

4. ブランチ・タイプ: ブランチ・タイプを選択します。最も一般的なブランチ・タイプは「ページまたはURLにブランチ」です。

5. 「次へ」をクリックします。

4. 「ターゲット」で、画面に表示される手順に従います。表示される属性は、選択した「ブランチ・タイプ」タイプによって異なります。詳細は、アイテムのヘルプを参照してください。

5. 「ブランチ条件」で、次のステップを実行します。

1. 対象ボタン - ユーザーが特定のボタンをクリックした場合にのみこのブランチを実行するには、リストからボタンを選択します。このボタンの条件を他の条件と統合し、このブランチをいつ実行するかをさらに絞り込むことができます。

2. 条件タイプ: このコンポーネントをレンダリングまたは処理するために満たす必要がある条件タイプをリストから選択します。

6. 「ブランチの作成」をクリックします。

関連項目:
「「対象ボタン」属性について」

16.5.3 条件付きブランチ処理について

他のコントロールと同様に、ブランチが条件付きで実行されるように設定できます。条件付きブランチを作成するには、「条件タイプ」リストから条件タイプを選択し、その条件タイプを実装するテキストを式のフィールドに入力します。

17 計算、検証およびプロセスの管理

この項では、計算、検証およびプロセスの管理方法について説明します。

- ページ計算の理解

- 検証の理解

- ページ・プロセスの理解

- ブランチについて

- アプリケーション・プロセスの理解

- アプリケーションの計算の理解

- 属性ディクショナリの使用

関連項目:
「クイック・スタート」、「アプリケーション・ビルダーの概念」、「データベース・アプリケーションの作成」、「ページ・レイアウトの制御」および「ナビゲーションの追加」

17.1 ページ計算の理解

この項では、ページ・デザイナおよびコンポーネント・ビューでページ計算を管理する方法について説明します。ページ計算を使用して、ページの送信時または表示時に、指定したアイテムに値を割り当てることができます。アプリケーション・レベルの計算を使用して、アイテムに値を割り当てることもできます。ほとんどのページ・レベルの計算では、ページ・アイテムを移入します。一方、ほとんどのアプリケーション・レベルの計算では、アプリケーション・アイテムを移入します。

- ページ計算について

- ページ・デザイナでのページ計算の管理

- コンポーネント・ビューでのページ計算の管理

関連項目:
「アプリケーションの計算の理解」

17.1.1 ページ計算について

ページ計算では、ページが表示または送信(レンダリングおよび処理)されたときに、指定したアイテムに値が割り当てられます。ページ計算を作成するには、ページ計算の作成ウィザードを実行します。各計算には、計算の作成対象のアイテムおよび計算タイプを指定します。

17.1.2 ページ・デザイナでのページ計算の管理

この項では、ページ・デザイナでページ計算を作成する方法について説明します。

ヒント:
検証エラーがあった際の処理の詳細は、「検証が失敗した場合の処理」を参照してください。

- ページ・デザイナでのページ計算の作成

- 計算ポイントおよび計算構文の例

- ページ・デザイナでのページ計算属性の編集

- 計算ポイントおよびソースの編集について

- 条件付き計算の作成について

関連項目:
「アプリケーションの計算の理解」

17.1.2.1 ページ・デザイナでのページ計算の作成

ページ計算を作成するには、次のステップを実行します。

1. ページ・デザイナで適切なページにナビゲートします。「ページ・デザイナでのページの表示」を参照してください。

2. 「レンダリング」ツリーで、「レンダリング前」または「レンダリング後」ノードを展開して、計算を配置する場所を見つけます。

3. 「計算」を右クリックして、「計算の作成」を選択します。
計算の属性がプロパティ・エディタに表示されます。

ヒント:
「メッセージ」タブに、対処が必要なメッセージを示す赤または黄色の印が表示されます。メッセージを選択すると、プロパティ・エディタに関連する属性が表示されます。赤いエラー・メッセージは、保存する前に対処する必要があります。

4. プロパティ・エディタですべての属性を表示します。「プロパティ・エディタ・メニュー」から「すべて表示」を選択します。

5. 「プロパティ・エディタ - 計算」で、次の属性を編集します。

ヒント:
属性の詳細は、プロパティ・エディタで属性を選択し、中央ペインで「ヘルプ」タブをクリックして、参照してください。

1. 指定、アイテム名 - この計算によって移入されるページまたはアプリケーション・アイテムを入力します。

2. 実行オプション、順序 - この計算の順序を指定します。これによって実行の順序が決まります。

3. 実行オプション、ポイント - ページのレンダリングまたは処理のどのポイントでこの計算を実行するかを選択します。最も一般的な計算ポイントは、「送信後」です。

4. 計算、タイプ - 計算タイプを選択します。オプションのリストを表示するには、ヘルプを参照してください。

次に、イベントがTrueまたはFalseに評価された場合に実行するアクションを定義します。

6. 「保存」をクリックします。

関連項目:
「レンダリング前ブランチ、計算およびプロセスの作成」および「ページ送信ブランチ、検証、計算およびプロセスの作成」

17.1.2.2 ページ・デザイナでのページ計算属性の編集

作成した計算は、ページ計算の編集ページで編集できます。

ページ計算を編集するには、次のステップを実行します。

1. ページ・デザイナでアイテムを含めるページを表示します。「ページ・デザイナでのページの表示」を参照してください。

2. 「レンダリング」ツリーで、「レンダリング前」または「レンダリング後」ノードを展開して、計算を選択します。

3. 「プロパティ・エディタ - 計算」で、適切な属性を編集します。

ヒント:
属性の詳細は、プロパティ・エディタで属性を選択し、中央ペインで「ヘルプ」タブをクリックして、参照してください。

4. 「保存」をクリックします。

17.1.2.3 計算ポイントおよびソースの編集について

計算を実行するタイミングは、「実行オプション」、順序および実行オプション、「ポイント」を使用して制御します。「順序」属性によって、評価の順序が決定されます。「ポイント」属性によって、計算を実行するページのレンダリングまたは処理のポイントが決定されます。最も一般的な計算ポイントは、「送信後」です。たとえば、「新しいインスタンス開始時」を選択すると、新しいセッション(またはインスタンス)の生成時に計算が実行されます。

順序およびポイントの指定後、「計算」にアイテムの値を計算するための式または問合せを入力します。計算が失敗した場合のために、「エラー・メッセージ」属性にエラー・メッセージを定義できます(オプション)。

関連項目:
「コンポーネント・ビューでのページ計算属性の編集」

17.1.2.4 条件付き計算の作成について

「条件」、「タイプ」リストから選択し、適切なフィールドを移入することによって、計算条件を作成できます。

関連項目:
「条件付きのレンダリングおよびプロセスの理解」

17.1.3 コンポーネント・ビューでのページ計算の管理

この項では、コンポーネント・ビューでページ計算を作成する方法について説明します。

ヒント:
検証エラーがあった際の処理の詳細は、「検証が失敗した場合の処理」を参照してください。

- コンポーネント・ビューでのページ計算の作成

- コンポーネント・ビューでのページ計算の作成

- コンポーネント・ビューでのページ計算属性の編集

- 条件付き計算の作成について

関連項目:
「アプリケーションの計算の理解」および「クロス・ページ・ユーティリティの使用」

17.1.3.1 コンポーネント・ビューでのページ計算の作成

ページ計算では、ページが表示または送信(レンダリングおよび処理)されたときに、指定したアイテムに値が割り当てられます。ページ計算を作成するには、ページ計算の作成ウィザードを実行します。各計算について、計算の作成対象のアイテムを指定し、計算タイプを選択します。

ページ計算を作成するには、次のステップを実行します。

1. 適切なページにナビゲートします。「コンポーネント・ビューでのページの表示」を参照してください。

2. 計算の作成ウィザードにアクセスします。「計算」で、「作成」アイコンをクリックします。

3. 「アイテム・タイプ」で、計算を実行する場所を選択して、「次へ」をクリックします。位置オプションは次のとおりです。

- このページのアイテム

- 他のページのアイテム

- アプリケーション・レベル・アイテム

4. 「アイテム」で、次を選択します。

1. 計算するアイテム: 計算によって更新されるアイテムを選択します。

2. 順序: 評価の順序を選択します。

3. 計算ポイント: 計算を実行するポイントを選択します。計算ポイント「新しいインスタンス開始時」では、新しいセッション(またはインスタンス)の生成時に計算が実行されます。

4. 計算タイプ: 作成する計算方法を選択します。

5. 「次へ」をクリックします。

5. 「計算」で、選択した計算タイプに対応する計算を入力し、「次へ」をクリックします。

6. 「条件」で、計算を条件付きにするかどうかを選択できます。計算を条件付きにする場合、「条件タイプ」リストから選択し、式フィールドにテキストを入力します。

7. 「計算の作成」をクリックします。

17.1.3.2 コンポーネント・ビューでのページ計算属性の編集

作成した計算は、ページ計算の編集ページで編集できます。

ページ計算を編集するには、次のステップを実行します。

1. 適切なページにナビゲートします。「コンポーネント・ビューでのページの表示」を参照してください。

2. ページ計算の編集ページにアクセスします。「計算」で、計算名を選択します。
ページ計算の編集ページが表示されます。

3. 対象となる属性を編集します。

4. 「変更の適用」をクリックします。

17.1.3.3 計算ポイントおよびソースの編集について

計算を実行するタイミングは、ページ計算の編集ページの「順序」および「計算ポイント」属性を使用して制御します。「順序」属性によって、評価の順序が決定されます。「計算ポイント」属性によって、アイテムの計算を実行するポイントを指定できます。たとえば、「新しいインスタンス開始時」を選択すると、新しいセッション(またはインスタンス)の生成時に計算が実行されます。

順序および計算ポイントの指定後、「ソース」で、アイテムの値を計算するための式または問合せを「計算」フィールドに入力します。計算が失敗した場合のために、「計算エラー・メッセージ」フィールドにエラー・メッセージを定義できます(オプション)。

関連項目:
「コンポーネント・ビューでのページ計算属性の編集」

17.1.3.4 条件付き計算の作成について

ページ計算の編集ページで、「条件タイプ」リストから選択し、式のフィールドにテキストを入力することによって、条件付き計算を作成できます。

関連項目:
「コンポーネント・ビューでのページ計算属性の編集」および「条件付きのレンダリングおよびプロセスの理解」

17.1.4 計算ポイントおよび計算構文の例

計算のわかりやすい使用例として、電話番号入力用のフォーム・フィールドを含むページがあげられます。この例では、電話番号は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. 「作成」をクリックします。

17.2 検証の理解

この項では、検証の作成方法について説明します。

- 検証について

- ページ・デザイナでの検証の管理

- コンポーネント・ビューでの検証の管理

- 検証の実行タイミングの決定について

- 検証エラー・メッセージの表示方法の定義について

- 検証の条件付き実行

- 「エラーに移動」リンクの変更について

- 検証が失敗した場合の処理

17.2.1 検証について

検証は編集確認です。単一アイテムに固有の検証は、ページ・アイテムの検証です。ページ全体に適用する検証は、ページの検証です。単一列に固有の表形式フォームの検証は、列レベルの検証です。単一列に適用しない表形式フォームの検証は、表形式フォームの行の検証です。

検証を宣言的に定義するには、検証方法を選択します。検証メッセージ・フィールドに、実際の検証の編集確認を入力します。検証が失敗した場合は、後続のページ・プロセスまたは計算が行われないことに注意してください。また、入力した検証は、選択した検証タイプと一貫性がある必要があることも注意してください。

17.2.2 ページ・デザイナでの検証の管理

この項では、検証の作成方法について説明します。

- ページ・デザイナでの検証の作成

- ページ・デザイナでの検証の編集

関連項目:
「フォームでのユーザー入力の検証」、「「検証の実行」について」および「アイテム・タイプについて」

17.2.2.1 ページ・デザイナでの 検証の作成

ページ・デザイナで検証を作成するには、次のステップを実行します。

注意:
検証に対して入力するテキストは、3,950文字以下にする必要があります。

1. ページ・デザイナでページを表示します。「ページ・デザイナでのページの表示」を参照してください。

2. 「レンダリング」ツリーの下の、ページ左側にある「プロセス」タブをクリックします。

3. 「検証中」を展開します。「検証」を右クリックして、「検証の作成」を選択します。
検証属性がプロパティ・エディタに表示されます。

ヒント:
「メッセージ」タブに、対処が必要なメッセージを示す赤または黄色の印が表示されます。メッセージを選択すると、プロパティ・エディタに関連する属性が表示されます。赤いエラー・メッセージは、保存する前に対処する必要があります。

4. プロパティ・エディタですべての属性を表示します。「プロパティ・エディタ・メニュー」から「すべて表示」を選択します。

5. 「プロパティ・エディタ - 検証」で、次の属性を編集します。

ヒント:
属性の詳細は、プロパティ・エディタで属性を選択し、中央ペインで「ヘルプ」タブをクリックして、参照してください。

1. 指定、名前 - 検証の名前を入力します。

2. 実行オプション、順序 - この検証の順序を入力します。これによって実行の順序が決まります。

3. 検証、リージョン - 関連するリージョンを選択します。

4. 検証、タイプ - この検証に対してテストする等価のタイプを選択します。選択によっては、この検証を完全に定義するために1つ以上の追加属性が必要となります。検証が等価テストをパスした場合、またはTRUEと評価された場合、検証エラー・メッセージは表示されません。検証エラー・メッセージは、検証が等価テストに失敗した場合、FALSEと評価された場合、または空でないテキスト文字列が返された場合に表示されます。詳細は、「ヘルプ」タブをクリックしてください。

5. 検証、常に実行 - この検証を常に実行するかどうかを指定します。

6. エラー、エラー・メッセージ - エラー・メッセージのテキストを入力します。

7. エラー、表示位置 - この検証のエラー・メッセージが表示される位置を選択します。

8. エラー、関連付けられたアイテム/関連付けられた列 - この検証のエラー・メッセージを表示するアイテムまたは列を選択します。

6. 「保存」をクリックします。

関連項目:
「レンダリング前ブランチ、計算およびプロセスの作成」および「ページ送信ブランチ、検証、計算およびプロセスの作成」

17.2.2.2 ページ・デザイナでの検証の編集

ページ・デザイナで検証を編集するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。「ページ・デザイナでのページの表示」を参照してください。

2. 「レンダリング」ツリーの下の、ページ左側にある「プロセス」タブをクリックします。

3. 「検証中」を展開してから「検証」を展開し、検証を選択します。
検証属性がプロパティ・エディタに表示されます。

ヒント:
「メッセージ」タブに、対処が必要なメッセージを示す赤または黄色の印が表示されます。メッセージを選択すると、プロパティ・エディタに関連する属性が表示されます。赤いエラー・メッセージは、保存する前に対処する必要があります。

4. プロパティ・エディタですべての属性を表示します。「プロパティ・エディタ・メニュー」から「すべて表示」を選択します。

5. 「プロパティ・エディタ - 検証」で、適切な属性を編集します。

ヒント:
属性の詳細は、プロパティ・エディタで属性を選択し、中央ペインで「ヘルプ」タブをクリックして、参照してください。

6. 「保存」をクリックします。

17.2.3 コンポーネント・ビューでの検証の管理

検証の作成ウィザードを実行して、検証を作成します。このウィザードは、検証対象に応じてわずかに変化します。検証は、指定のフィールドに固有(単一ページ・アイテムまたは表形式フォーム列の検証)か、フィールドに固有のものではない(ページまたは表形式フォーム行の検証)かのいずれかです。

- ページ・アイテムの検証の作成

- ページ全体の検証の作成

- 表形式フォーム列の検証の作成

- 表形式フォーム行の検証の作成

- コンポーネント・ビューでの検証の編集

関連項目:
「フォームでのユーザー入力の検証」、「「検証の実行」について」および「アイテム・タイプについて」

17.2.3.1 ページ・アイテムの検証の作成

ページ・アイテムの検証を作成するには、次のステップを実行します。

注意:
検証に対して入力するテキストは、3,950文字以下にする必要があります。

1. 適切なページにナビゲートします。「コンポーネント・ビューでのページの表示」を参照してください。

2. 検証の作成ウィザードにアクセスします。「ページ・プロセス」で、「検証」を探します。「作成」アイコンをクリックします。
検証の作成ウィザードが表示されます。

3. 「検証レベルの指定」で、「ページ・アイテム」を選択して「次へ」をクリックします。

4. 「検証するページ・アイテムを指定してください」で、検証するアイテムを選択して「次へ」をクリックします。

5. 「順序と名前」で、次のステップを実行します。

1. 順序: このアイテムの順序番号を入力します。

2. 「検証名」: この検証の名前を入力します。

3. エラー表示位置: 検証エラー・メッセージの表示位置を選択します。検証エラー・メッセージは、エラー・ページに表示したり、送信済ページにインラインで表示できます。インライン検証は、通知領域(ページ・テンプレートの一部として定義される)に表示したり、フィールド・ラベル内に表示することができます。

4. 「次へ」をクリックします。

6. 「検証タイプ」で、表17-1の説明に従って方法を選択し、「次へ」をクリックします。

表17-1 ページ・アイテムの検証方法

検証方法

説明

NOT 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

SQL

データベース内の値と比較します。検証タイプを選択します。

- 存在

- NOT EXISTS

- SQL式

たとえば、SQL検証を使用して、フィールドに入力した姓がデータベースに存在するかどうかを検証できます。次のEXISTS SQL検証では、フィールドはP1_LAST_NAMEという名前で、表はcustomersという名前です。

SELECT 1 FROM customers
WHERE last_name = :P1_LAST_NAME

PL/SQL

複雑なロジックが必要な場合に便利です。検証タイプを選択します。

- PL/SQL式

- 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);

7. 「検証」で、次のステップを実行します。

1. エラー・メッセージ: 検証方法に応じて、検証が失敗した場合に表示する検証またはメッセージ・テキストを入力します。
関連付けられたページ・アイテムのプレースホルダとして、#LABEL#を使用できます。

2. 常に実行: ページが送信されるときに検証を実行するかどうかを決定します。この属性は、ページを送信するボタンまたは特定のページについての「検証の実行」属性とともに使用します。オプションは次のとおりです。

- 「はい」: 検証は、ページ上のボタンまたはアイテムの検証設定とは無関係に常に実行されます。定義済条件が依然として適用されることに注意してください。

- 「いいえ」: 検証は、ページを送信するために使用されるボタンまたはアイテムの「検証の実行」属性が「はい」に設定されているときにのみ実行されます。

詳細は、「検証の実行タイミングの決定について」を参照してください。

3. 「次へ」をクリックします。

8. この検証に適用される条件を定義し、「作成」をクリックします。

17.2.3.2 ページ全体の検証の作成

ページ全体の検証を作成するには、次のステップを実行します。

注意:
検証に対して入力するテキストは、3,950文字以下にする必要があります。

1. 適切なページにナビゲートします。「コンポーネント・ビューでのページの表示」を参照してください。

2. 検証の作成ウィザードにアクセスするには、次のステップを実行します。「ページ・プロセス」で、「検証」を探します。「作成」アイコンをクリックします。
検証の作成ウィザードが表示されます。

3. 「検証レベル」で、「ページ」を選択し、「次へ」をクリックします。

4. 「順序と名前」で、次のステップを実行します。

1. 順序: このアイテムの順序番号を入力します。

2. 「検証名」: この検証の名前を入力します。

3. エラー表示位置: 検証エラー・メッセージの表示位置を選択します。検証エラー・メッセージは、エラー・ページに表示したり、送信済ページにインラインで表示できます。インライン検証は、通知領域(ページ・テンプレートの一部として定義される)に表示したり、フィールド・ラベル内に表示することができます。

4. 「次へ」をクリックします。

5. 「検証タイプ」で、表17-2の説明に従って方法を選択し、「次へ」をクリックします。

表17-2 ページの検証方法

検証方法

説明

SQL

データベース内の値と比較します。検証タイプを選択します。

- 存在

- NOT EXISTS

- SQL式

PL/SQL

複雑なロジックが必要な場合に便利です。検証タイプを選択します。

- PL/SQL式

- PL/SQLエラー

- ブールを戻すファンクション

- エラー・テキストを戻すファンクション

6. 「検証」で、次のステップを実行します。

1. 検証コード: 選択した検証タイプに対応するコードを入力します。

2. エラー・メッセージ: 検証方法に応じて、検証が失敗した場合に表示する検証またはメッセージ・テキストを入力します。
関連付けられたページ・アイテムのプレースホルダとして、#LABEL#を使用できます。

3. 常に実行: ページが送信されるときに検証を実行するかどうかを決定します。この属性は、ページを送信するボタンまたは特定のページについての「検証の実行」属性とともに使用します。オプションは次のとおりです。

- 「はい」: 検証は、ページ上のボタンまたはアイテムの検証設定とは無関係に常に実行されます。定義済条件が依然として適用されることに注意してください。

- 「いいえ」: 検証は、ページを送信するために使用されるボタンまたはアイテムの「検証の実行」属性が「はい」に設定されているときにのみ実行されます。

詳細は、「検証の実行タイミングの決定について」を参照してください。

4. 「次へ」をクリックします。

7. この検証に適用される条件を定義し、「作成」をクリックします。

17.2.3.3 表形式フォーム列の検証の作成

表形式フォーム列の検証を作成するには、次のステップを実行します。

注意:
検証に対して入力するテキストは、3,950文字以下にする必要があります。

1. 適切なページにナビゲートします。「コンポーネント・ビューでのページの表示」を参照してください。

2. 検証の作成ウィザードにアクセスするには、次のステップを実行します。「ページ・プロセス」で、「検証」を探します。「作成」アイコンをクリックします。
検証の作成ウィザードが表示されます。

3. 「検証レベル」で、次のステップを実行します。

1. 表形式フォーム: この検証に関連付ける表形式フォーム・リージョンを選択します。

2. 検証レベルの指定: 「列」を選択します。

3. 「次へ」をクリックします。

4. 「検証する列を指定してください」で、列を選択して「次へ」をクリックします。

5. 「順序と名前」で、次のように指定し、「次へ」をクリックします。

- 順序: このアイテムの順序番号を入力します。

- 「検証名」: この検証の名前を入力します。

- エラー表示位置: 検証エラー・メッセージの表示位置を選択します。検証エラー・メッセージは、エラー・ページに表示したり、送信済ページにインラインで表示できます。インライン検証は、通知領域(ページ・テンプレートの一部として定義される)に表示したり、フィールド・ラベル内に表示することができます。

6. 「検証タイプ」で、方法を選択し、画面に表示される手順に従って「次へ」をクリックします。

7. 「検証」で、次のステップを実行します。

1. 検証を定義します。表示される属性は、選択した検証タイプによって異なります。

2. エラー・メッセージ: 検証方法に応じて、検証が失敗した場合に表示する検証またはメッセージ・テキストを入力します。
関連付けられた表形式フォーム列の列ヘッダーのプレースホルダとして、#COLUMN_HEADER#を使用できます。

3. 常に実行: ページが送信されるときに検証を実行するかどうかを決定します。この属性は、ページを送信するボタンまたは特定のページについての「検証の実行」属性とともに使用します。オプションは次のとおりです。

- 「はい」: 検証は、ページ上のボタンまたはアイテムの検証設定とは無関係に常に実行されます。定義済条件が依然として適用されることに注意してください。

- 「いいえ」: 検証は、ページを送信するために使用されるボタンまたはアイテムの「検証の実行」属性が「はい」に設定されているときにのみ実行されます。

詳細は、「検証の実行タイミングの決定について」を参照してください。

4. 「次へ」をクリックします。

8. 「条件」で、この検証に適用する条件を定義します。

9. 「検証の作成」をクリックします。

17.2.3.4 表形式フォーム行の検証の作成

表形式フォーム行の検証を作成するには、次のステップを実行します。

注意:
検証に対して入力するテキストは、3,950文字以下にする必要があります。

1. 適切なページにナビゲートします。「コンポーネント・ビューでのページの表示」を参照してください。

2. 検証の作成ウィザードにアクセスするには、次のステップを実行します。「ページ・プロセス」で、「検証」を探します。「作成」アイコンをクリックします。
検証の作成ウィザードが表示されます。

3. 「検証レベル」で、次のステップを実行します。

1. 表形式フォーム: この検証に関連付ける表形式フォーム・リージョンを選択します。

2. 検証レベルの指定: 「表形式フォームの行」を選択します。

3. 「次へ」をクリックします。

4. 「順序と名前」で、次のように指定し、「次へ」をクリックします。

- 順序: このアイテムの順序番号を入力します。

- 「検証名」: この検証の名前を入力します。

- エラー表示位置: 検証エラー・メッセージの表示位置を選択します。検証エラー・メッセージは、エラー・ページに表示したり、送信済ページにインラインで表示できます。インライン検証は、通知領域(ページ・テンプレートの一部として定義される)に表示したり、フィールド・ラベル内に表示することができます。

5. 「検証タイプ」で、検証タイプを選択し、画面に表示される手順に従って「次へ」をクリックします。

6. 「検証」で、次のステップを実行します。

1. 検証コード: 選択した検証タイプに対応するコードを入力します。

2. エラー・メッセージ: 検証方法に応じて、検証が失敗した場合に表示する検証またはメッセージ・テキストを入力します。
関連付けられた表形式フォーム列の列ヘッダーのプレースホルダとして、#COLUMN_HEADER#を使用できます。

3. 常に実行: ページが送信されるときに検証を実行するかどうかを決定します。この属性は、ページを送信するボタンまたは特定のページについての「検証の実行」属性とともに使用します。オプションは次のとおりです。

- 「はい」: 検証は、ページ上のボタンまたはアイテムの検証設定とは無関係に常に実行されます。定義済条件が依然として適用されることに注意してください。

- 「いいえ」: 検証は、ページを送信するために使用されるボタンまたはアイテムの「検証の実行」属性が「はい」に設定されているときにのみ実行されます。

詳細は、「検証の実行タイミングの決定について」を参照してください。

4. 「次へ」をクリックします。

7. 「条件」で、次のステップを実行します。

1. 対象ボタン - 選択したときに他の条件に従ってこの検証を実行するページ・ボタンを選択します。

2. 条件タイプ - このコンポーネントをレンダリング処理するために満たす必要がある条件タイプをリストから選択します。

3. 「次へ」をクリックします。

8. 「検証の作成」をクリックします。

17.2.3.5 コンポーネント・ビューでの検証の編集

表形式フォーム行の検証を作成するには、次のステップを実行します。

注意:
検証に対して入力するテキストは、3,950文字以下にする必要があります。

1. 適切なページにナビゲートします。「コンポーネント・ビューでのページの表示」を参照してください。

2. 「検証」で、検証を選択します。
ページ検証の編集ページが表示されます。

3. 対象となる属性を編集します。
属性の詳細は、フィールドレベル・ヘルプを参照してください。「フィールドレベル・ヘルプの表示」を参照してください。

4. 「変更の適用」をクリックします。

17.2.4 検証の実行タイミングの決定について

検証を作成するときに、「常に実行」属性で、ページが送信されるときに検証が実行されるかどうかが決定されます。この属性は、ページを送信する、ボタンまたは特定のページ・アイテムに使用します。「常に実行」属性には2つのオプションがあります。

- 「はい」: 検証は、ページ上のボタンまたはアイテムの検証設定とは無関係に常に実行されます。
たとえば、現行ユーザーに現行レコードの変更や削除を許可するかどうかを決定するセキュリティ・チェックとしての検証の場合は、「はい」を選択します。これにより、いずれの操作に対しても検証が実行され、権限のないユーザーによる変更を防ぐことができます。

- 「いいえ」: 検証は、ページを送信するために使用されるボタンまたはアイテムの「検証の実行」属性が「はい」に設定されているときにのみ実行されます。
たとえば、ユーザーが単にレコードを削除しようとしているときに、アイテムが数値であることを検証してエラー・メッセージを表示しても役立ちません。この場合は、ユーザーが「作成」または「変更の適用」ボタンをクリックしたときにのみ検証を実行する必要があります。

この動作を実現するには、次のステップを実行します。

- 検証で、「常に実行」に「いいえ」を設定します。

- 「作成」および「変更の適用」ボタンでは、「検証の実行」に「はい」を設定します。

- 「削除」ボタンでは、「検証の実行」を「いいえ」に設定し、不要な検証を回避します。

関連項目:
「ページ・デザイナでの検証の編集」および「コンポーネント・ビューでの検証の編集」

17.2.5 検証エラー・メッセージの表示方法の定義について

検証エラー・メッセージをインライン表示(検証が実行されたページで表示)するか、個別のエラー・ページで表示するかを選択できます。

次の検証属性を構成することによって、検証エラー・メッセージの表示方法を定義します。

1. エラー・メッセージ - このフィールドにエラー・メッセージ・テキストを入力します。

2. 表示位置 - この検証のエラー・メッセージが表示される位置を選択します。検証エラー・メッセージは、別のエラー・ページに表示したり、既存ページ内にインラインで表示することができます。インライン・エラー・メッセージは、ページ・テンプレートの一部として定義されている「関連付けられたアイテム」ラベルの下/「通知」領域内に表示されます。

ヒント:
コンポーネント・ビューでは、この属性は「エラー・メッセージ表示位置」という名前です。

オプションは次のとおりです。

- 「フィールドおよび通知でインライン表示」: エラーは、フィールド・ラベル内および通知領域(ページ・テンプレートの一部として定義される)にインラインで表示されます。

- 「フィールドでインライン表示」: エラーはフィールド・ラベル内にインラインで表示されます

- 「通知でインライン表示」: エラーは、通知領域(ページ・テンプレートの一部として定義される)にインラインで表示されます。

- 「エラー・ページ」: エラーは、個別のエラー・ページに表示されます。すべての処理(検証を含む)を停止するハード・エラーを作成する場合は、エラー・ページにエラーを表示する必要があります。

3. 関連付けられたアイテム (または関連付けられた列) - この検証のエラー・メッセージを表示するアイテム(または列)を選択します。
アイテムを選択し、エラー・メッセージの表示位置に「フィールドでインライン表示」が含まれる場合、エラー・メッセージは指定されたアイテム・ラベルの下に表示されます。エラー・メッセージの表示位置に「フィールドでインライン表示」が含まれない場合、この属性はエラー・メッセージの表示に影響しません。

関連項目:
「ページ・デザイナでの検証の編集」および「コンポーネント・ビューでの検証の編集」

17.2.6 検証の条件付き実行

次の条件属性を構成することによって、検証をいつ実行するか、および実行するかどうかを制御できます。

1. 対象ボタン: このページ処理コンポーネントを、指定したボタンがクリックされたときのみ実行する場合、リストからボタンを選択します。このボタンの条件を他の条件と統合し、このページ処理コンポーネントがいつ実行されるかをさらに絞り込むことができます。
ボタンがクリックされない場合、検証を実行する前に他の条件が評価されます。

2. 実行スコープ: 表形式フォームにのみ適用されます。次のようにして、実行スコープを指定します。

- 作成済および変更済の列: 表形式フォームで作成および変更した行でのみ検証を実行します。

- すべての送信済の列: 送信したすべての行で検証を実行します。

3. 条件タイプ: このコンポーネントをレンダリングまたは処理するために満たす必要がある条件タイプをリストから選択します。オプション・リストを表示するには、「ヘルプ」タブをクリックします。

関連項目:
「ページ・デザイナでの検証の編集」、「コンポーネント・ビューでの検証の編集」および「条件付きのレンダリングおよびプロセスの理解」

17.2.7 「エラーに移動」リンクの変更について

関連付けるアイテムを定義すると、Oracle Application Expressによって、対応するエラー・メッセージの隣の通知表示位置に「エラーに移動」リンクがレンダリングされます。クリックすると、ユーザーのフォーカスが関連付けられたアイテムに移動します。

「エラーに移動」テキストを変更して、デフォルトのテキストを変更したり、Oracle Application Expressによってデフォルトでは翻訳されない言語に翻訳することができます。いずれの場合でも、必要なテキストと言語とともに、APEX.GO_TO_ERRORという名前のテキスト・メッセージを定義してください。さらに、APEX.GO_TO_ERRORテキスト・メッセージのテキストを単なるシングル・スペースに設定して、この機能を無効化し、「エラーに移動」リンクを削除できます。詳細は、「Oracle Application Expressにより内部使用されるメッセージの翻訳」を参照してください。

17.2.8 検証が失敗した場合の処理

ページが送信され一部の検証が失敗した場合、Oracle Application Expressは既存のページを、すべてのインライン検証エラーを含めて再表示します。インライン・エラーの表示中は、Oracle Application Expressはページ・レンダリング中(つまり、すべての「ロード時%」の表示ポイント)に実行するように定義されている計算、アプリケーション・プロセスまたはページ・プロセス(行の自動フェッチなど)を実行しません。ただし、計算およびプロセスで「インライン検証エラーあり」条件タイプが使用されている場合のみ例外です。

これらの計算およびプロセスをスキップする理由は、これらによりユーザーが入力したデータが変更される可能性があるためです。たとえば、検証エラーを修正するためにユーザーが実際に入力されたデータを必要とする場合に、行の自動フェッチ・プロセスは、変更されたデータをフェッチし、データベースからの値で上書きします。

計算がスキップされた場合、デバッグ出力に次の内容が表示されます。

Do not perform computation because inline validation errors found.

アプリケーションまたはページ・プロセスがスキップされる場合、デバッグ出力に次の内容が表示されます。

Skip because inline validation errors found.

17.3 ページ・プロセスの理解

この項では、ページ・プロセスの作成方法について説明します。

- ページ・プロセスについて

- ページ・デザイナでのページ・プロセスの管理

- コンポーネント・ビューでのページ・プロセスの管理

17.3.1 ページ・プロセスについて

1つのページ・プロセスは、ページのレンダリング中または送信中の指定されたポイントで1つのアクションを実行します。たとえば、ページ・プロセスを作成して、ロジックを実行したり、Application Expressエンジンをコールできます。ページ・プロセスは、ページのロードや送信など、特定のイベントが発生したときに実行するロジックの単位です。

ファンクションの観点からみると、ページ・レベルのプロセスとアプリケーション・レベルのプロセスに違いはありません。これらの2つのプロセス・タイプの違いは、プロセスが定義された場所(ページ・レベルかアプリケーション・レベルか)です。

関連項目:
「アプリケーション・プロセスの理解」および「クロス・ページ・ユーティリティの使用」

17.3.2 ページ・デザイナでのページ・プロセスの管理

この項では、ページ・プロセスの作成方法について説明します。

- ページ・デザイナでのページ・プロセスの作成

- ページ・デザイナでのページ・プロセス属性の編集

- ページ・デザイナでページ・プロセスを実行するタイミングの制御

- ページ・デザイナでのページ・プロセスの成功メッセージとエラー・メッセージの作成

- ページ・デザイナでのページ・プロセス条件の作成

関連項目:
「アプリケーション・プロセスの理解」および「クロス・ページ・ユーティリティの使用」

ヒント:
検証エラーがあった際の処理の詳細は、「検証が失敗した場合の処理」を参照してください。

17.3.2.1 ページ・デザイナでのページ・プロセスの作成

ページ・プロセスを作成するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。「ページ・デザイナでのページの表示」を参照してください。

2. 「レンダリング」または「プロセス」タブで、プロセスが発生するノードを探します。右クリックして、「プロセスの作成」を選択します。
プロセス属性がプロパティ・エディタに表示されます。

ヒント:
「メッセージ」タブに、対処が必要なメッセージを示す赤または黄色の印が表示されます。メッセージを選択すると、プロパティ・エディタに関連する属性が表示されます。赤いエラー・メッセージは、保存する前に対処する必要があります。

3. プロパティ・エディタですべての属性を表示します。「プロパティ・エディタ・メニュー」から「すべて表示」を選択します。

ヒント:
属性の詳細は、プロパティ・エディタで属性を選択し、中央ペインで「ヘルプ」タブをクリックして、参照してください。

4. 「指定」で、次の項目を指定します。

1. 名前 - プロセスの名前を入力します。

2. タイプ - 実行するプロセス・タイプを指定します。選択したタイプによって、表示される設定属性が決定されます。

5. 「設定」で、適切な属性を編集します。
必要な属性は、属性ラベルの1つ上の左上隅に赤い三角形で表示されます。

6. 「実行オプション」で、次の項目を指定します。

1. 順序 - この計算の順序を指定します。これによって実行の順序が決まります。

2. ポイント - このプロセスが実行されるポイントを選択します。

3. プロセスの実行 - このプロセスが実行される頻度を選択します。

7. 「成功メッセージ」で、次のステップを実行します。

1. エラー・メッセージ - このプロセスの成功メッセージを入力します。プロセスが実行され、エラーが発生しない場合は、表示される結果のページの通知セクションに、このプロセス成功メッセージが表示されます。

8. 「エラー」で、次のステップを実行します。

1. エラー・メッセージ - このプロセスのエラー・メッセージを入力します。未処理例外が発生した場合、このメッセージが表示されます。エラー・プロセスが停止した後は、常にロールバックが実行され、エラー・メッセージが表示されます。

2. 表示位置 - このプロセスが正常に完了しなかった場合のこのプロセス・エラー・メッセージの表示場所を選択します。

9. 「保存」をクリックします。

関連項目:
「レンダリング前ブランチ、計算およびプロセスの作成」および「ページ送信ブランチ、検証、計算およびプロセスの作成」

17.3.2.2 ページ・デザイナでのページ・プロセス属性の編集

既存のページ・プロセスを編集するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。「ページ・デザイナでのページの表示」を参照してください。

2. 「レンダリング」または「プロセス」タブで、ノードを展開し、プロセスを見つけて選択します。
プロセス属性がプロパティ・エディタに表示されます。

3. プロパティ・エディタですべての属性を表示します。「プロパティ・エディタ・メニュー」から「すべて表示」を選択します。

4. 「プロパティ・エディタ - プロセス」で、適切な属性を編集します。

ヒント:
属性の詳細は、プロパティ・エディタで属性を選択し、中央ペインで「ヘルプ」タブをクリックして、参照してください。

5. 「保存」をクリックします。

17.3.2.3 ページ・デザイナでページ・プロセスを実行するタイミングの制御

プロセスをいつ実行するかを制御するには、次の属性を編集します。

1. プロセス属性をプロパティ・エディタに表示します。「ページ・デザイナでのページ・プロセス属性の編集」を参照してください。

2. 次の属性を編集します。

1. 実行オプション、順序 - このコンポーネントの順序を指定します。これによって実行の順序が決まります。

2. 実行オプション、ポイント - このブランチ・アクションが考慮される処理内のポイントを選択します。

3. 「保存」をクリックします。

17.3.2.4 ページ・デザイナでのページ・プロセスの成功メッセージとエラー・メッセージの作成

プロセスの実行時に表示する成功メッセージとエラー・メッセージの両方を定義できます。エラー・メッセージの表示方法は、プロセス・ポイントによって異なります。「送信時 - 計算および検証の前」または「送信時 - 計算および検証の後」プロセス・ポイントを持つプロセスでは、カレント・ページにインラインでエラー・メッセージを表示するか(デフォルト)、別のページに表示するかを指定できます。他のすべてのページ・プロセスでは、エラー・メッセージは別のエラー・ページに表示されます。

ページ・プロセスのエラー・メッセージまたは成功メッセージを作成するには、次のステップを実行します。

1. プロセス属性をプロパティ・エディタに表示します。「ページ・デザイナでのページ・プロセス属性の編集」を参照してください。

2. 次の属性を編集します。

1. 成功メッセージ、成功メッセージ - このプロセスの成功メッセージを入力します。プロセスが実行され、エラーが発生しない場合は、表示される結果のページの通知セクションに、このプロセス成功メッセージが表示されます。URLリダイレクトを介して別のページにブランチする場合は、成功メッセージの保存属性を選択する必要があります。

2. エラー、エラー・メッセージ - このプロセスのエラー・メッセージを入力します。未処理例外が発生した場合、このメッセージが表示されます。エラー・プロセスが停止した後は、常にロールバックが実行され、エラー・メッセージが表示されます。

3. エラー、表示位置 - このプロセスが正常に完了しなかった場合のこのプロセス・エラー・メッセージの表示場所を選択します。
オプションは次のとおりです。

- 通知でインライン表示: プロセス・エラー・メッセージが「通知」領域(ページ・テンプレートの一部として定義)に表示されます。

- エラー・ページ: エラーは別のエラー・ページに表示されます。

3. 「保存」をクリックします。

関連項目:
「ページ・テンプレート」

17.3.2.5 ページ・デザイナでのページ・プロセス条件の作成

条件付きページ・プロセスを作成するには、次の属性を編集します。

1. プロセス属性をプロパティ・エディタに表示します。「ページ・デザイナでのページ・プロセス属性の編集」を参照してください。

2. 次の属性を編集します。

1. 条件、対象ボタン - このページ処理コンポーネントを、指定したボタンがクリックされたときのみ実行する場合、リストからボタンを選択します。このボタンの条件を他の条件と統合し、このページ処理コンポーネントがいつ実行されるかをさらに絞り込むことができます。

2. 条件、実行スコープ - 表形式フォームにのみ適用されます。次のようにして、実行スコープを指定します。

- 作成済および変更済の列: 表形式フォームで作成および変更した行でのみ検証を実行します。

- すべての送信済の列: 送信したすべての行で検証を実行します。

3. 条件、条件タイプ - このコンポーネントをレンダリングまたは処理するために満たす必要がある条件タイプをリストから選択します。

3. 「保存」をクリックします。

17.3.3 コンポーネント・ビューでのページ・プロセスの管理

この項では、ページ・プロセスの作成方法について説明します。

- コンポーネント・ビューでのページ・プロセスの管理

- コンポーネント・ビューでのページ・プロセスの作成

- コンポーネント・ビューでのページ・プロセス属性の編集

- ページ・プロセスを実行するタイミングの制御

- ページ・プロセスの成功メッセージとエラー・メッセージの作成

- ページ・プロセスを条件付きにする

関連項目:
「アプリケーション・プロセスの理解」および「クロス・ページ・ユーティリティの使用」

ヒント:
検証エラーがあった際の処理の詳細は、「検証が失敗した場合の処理」を参照してください。

17.3.3.1 コンポーネント・ビューでのページ・プロセスの作成

この項では、ページ・プロセスの作成方法について説明します。プロセスの作成ウィザードを実行して、プロセスを作成します。ウィザードの実行中にプロセス名を定義し、順序、およびプロセスが実行されるポイントを指定し、プロセス・カテゴリを選択します。ページ・プロセスの編集ページで、これらのほぼすべての属性を変更できます。

- ページ・プロセスの作成

- 表形式フォームのページ・プロセスの作成

17.3.3.1.1 ページ・プロセスの作成

ページ・プロセスを作成するには、次のステップを実行します。

1. 適切なページにナビゲートします。「コンポーネント・ビューでのページの表示」を参照してください。

2. ページ・プロセスの作成ウィザードにアクセスします。「プロセス」で、「作成」アイコンをクリックします。

3. 表17-3の説明に従って、「プロセス・タイプ」で、作成するプロセスのカテゴリを選択します。

表17-3 ページ・プロセス・タイプ

プロセス・カテゴリ

説明

セッション・ステートのクリア

Oracle Application Express内に格納されているセッション・ステートをクリアします。このプロセス・タイプを選択すると、既存のユーザー設定、アプリケーション、セッションまたはアイテムのキャッシュがクリアされます。

関連項目:「セッション・ステート値の管理」および Oracle Application Express管理ガイドの「ユーザー・プリファレンスの管理」

ダイアログを閉じる

現在のモーダルまたは非モーダル・ダイアログ・ページを閉じます。

データ操作

ウィザードでは、データ操作言語(DML)のアクションをサポートするために、「データ操作」プロセス・タイプが頻繁に使用されます。Application Builderでは、次のような宣言によるデータ操作プロセスをサポートしています。

- 自動的なデータ操作言語(DML)プロセスを作成するには、「行の自動フェッチ」および「行の自動処理(DML)」を選択します。

- 「複数行の更新」および「複数行の削除」は、表形式フォームとともに使用します。

- 「表形式フォームに行の追加」は、表形式フォームとともに使用します。

フォーム・ページ区切り

データベース表またはビューから前後のレコードを取得するプロセス。このプロセスを使用すると、フォーム・ページにページ区切りが配置され、エンド・ユーザーはレポートに戻ることなく前後のレコードを取得できます。

PL/SQLコード

指定したPL/SQLコードを実行するプロセス。このプロセス・タイプを使用して、プロセスに直接入力したPL/SQLブロックを実行したり、既存のAPIをコールします。

プラグイン

開発者はプラグインを使用して、Application Expressで使用可能な組込みタイプを宣言的に拡張できます。このオプションは、プラグイン・タイプのプロセスがこのアプリケーション内に存在する場合にのみ使用可能です。

関連項目: 「プラグインの実装」

Reset Pagination

カレント・ページでレポートのページ区切りをリセットするプロセス。

電子メールの送信

アプリケーションから電子メールおよび1つ以上の添付ファイル(オプション)を送信するプロセス。

ユーザー・プリファレンス

エンド・ユーザーのユーザー・プリファレンスを設定するプロセス。

関連項目: 『Oracle Application Express管理ガイド』のユーザー・プリファレンスの管理に関する項

Webサービス

Webサービスをページ上のプロセスとして実装します。このプロセスを実行すると、リクエストがサービス・プロバイダに送信されます。

関連項目: 「Webサービスをプロセスとして起動する方法」

4. 画面に表示されるステップに従います。

17.3.3.1.2 表形式フォームのページ・プロセスの作成

表形式フォームのページ・プロセスを作成するには、次のステップを実行します。

1. 適切なページにナビゲートします。「コンポーネント・ビューでのページの表示」を参照してください。

2. ページ・プロセスの作成ウィザードにアクセスします。「プロセス」で、「作成」アイコンをクリックします。

3. 「プロセス・タイプ」で、次の項目を指定します。

- 表形式フォーム: 関連する表形式フォーム・リージョンを選択します。

- プロセス・タイプ: 表17-4に示すプロセス・タイプを選択します。

表17-4 ページ・プロセス・タイプ

プロセス・カテゴリ

説明

セッション・ステートのクリア

Oracle Application Express内に格納されているセッション・ステートをクリアします。このプロセス・タイプを選択すると、既存のユーザー設定、アプリケーション、セッションまたはアイテムのキャッシュがクリアされます。

関連項目:「セッション・ステート値の管理」および Oracle Application Express管理ガイドの「ユーザー・プリファレンスの管理」

ダイアログを閉じる

現在のモーダルまたは非モーダル・ダイアログ・ページを閉じます。

データ操作

ウィザードでは、データ操作言語(DML)のアクションをサポートするために、「データ操作」プロセス・タイプが頻繁に使用されます。Application Builderでは、次のような宣言によるデータ操作プロセスをサポートしています。

- 自動的なデータ操作言語(DML)プロセスを作成するには、「行の自動フェッチ」および「行の自動処理(DML)」を選択します。

- 「複数行の更新」および「複数行の削除」は、表形式フォームとともに使用します。

- 「表形式フォームに行の追加」は、表形式フォームとともに使用します。

フォーム・ページ区切り

データベース表またはビューから前後のレコードを取得するプロセス。このプロセスを使用すると、フォーム・ページにページ区切りが配置され、エンド・ユーザーはレポートに戻ることなく前後のレコードを取得できます。

PL/SQLコード

指定したPL/SQLコードを実行するプロセス。このプロセス・タイプを使用して、プロセスに直接入力したPL/SQLブロックを実行したり、既存のAPIをコールします。

プラグイン

開発者はプラグインを使用して、Application Expressで使用可能な組込みタイプを宣言的に拡張できます。このオプションは、プラグイン・タイプのプロセスがこのアプリケーション内に存在する場合にのみ使用可能です。

関連項目: 「プラグインの実装」

Reset Pagination

カレント・ページでレポートのページ区切りをリセットするプロセス。

電子メールの送信

アプリケーションから電子メールおよび1つ以上の添付ファイル(オプション)を送信するプロセス。

ユーザー・プリファレンス

エンド・ユーザーのユーザー・プリファレンスを設定するプロセス。

関連項目: 『Oracle Application Express管理ガイド』のユーザー・プリファレンスの管理に関する項

Webサービス

Webサービスをページ上のプロセスとして実装します。このプロセスを実行すると、リクエストがサービス・プロバイダに送信されます。

関連項目: 「Webサービスをプロセスとして起動する方法」

4. 画面に表示されるステップに従います。

17.3.3.2 コンポーネント・ビューでのページ・プロセス属性の編集

プロセスを作成すると、「ページ・プロセスの編集」ページで属性を編集することによって、プロセスを実行するタイミングおよびプロセスの内容を制御できます。

既存のページ・プロセスを編集するには、次のステップを実行します。

1. 適切なページにナビゲートします。「コンポーネント・ビューでのページの表示」を参照してください。

2. ページ・プロセスの編集ページにアクセスします。「プロセス」で、プロセス名をクリックします。
「ページ・プロセスの編集」ページが表示されます。

3. 対象となる属性を編集します。詳細は、フィールドレベル・ヘルプおよび後続の項を参照してください。

4. 「変更の適用」をクリックします。

17.3.3.3 ページ・プロセスを実行するタイミングの制御

プロセスを実行するタイミングを制御するには、ページ・プロセスの編集ページの「プロセス・ポイント」で順序番号およびプロセス・ポイントを指定します。「プロセスの実行」でオプションを選択すると、後続のページへのアクセス時におけるプロセスの実行を制限できます。

プロセスを実行するタイミングを制御するには、次のステップを実行します。

1. ページ・プロセスの編集ページにアクセスします。「コンポーネント・ビューでのページ・プロセス属性の編集」を参照してください。

2. 次の属性を編集します。

1. プロセス・ポイント、順序 - このコンポーネントの順序を指定します。これによって実行の順序が決まります。

2. プロセス・ポイント、プロセス・ポイント - このブランチ・アクションが考慮される処理内のポイントを選択します。

3. プロセス・ポイント、プロセスの実行 - このプロセスを実行する頻度を選択します。

3. 「変更の適用」をクリックします。

17.3.3.4 ページ・プロセスの成功メッセージとエラー・メッセージの作成

プロセスの実行時に表示する成功メッセージとエラー・メッセージの両方を定義できます。エラー・メッセージの表示方法は、プロセス・ポイントによって異なります。「送信時 - 計算および検証の前」または「送信時 - 計算および検証の後」プロセス・ポイントを持つプロセスでは、カレント・ページにインラインでエラー・メッセージを表示するか(デフォルト)、別のページに表示するかを指定できます。他のすべてのページ・プロセスでは、エラー・メッセージは別のエラー・ページに表示されます。

ページ・プロセスのエラー・メッセージまたは成功メッセージを作成するには、次のステップを実行します。

1. ページ・プロセスの編集ページにアクセスします。「コンポーネント・ビューでのページ・プロセス属性の編集」を参照してください。

2. 次の属性を編集します。

1. メッセージ、プロセスの成功メッセージ - プロセスが正常に実行された場合に表示するメッセージを入力します。

2. メッセージ、プロセス・エラー・メッセージ - 未処理例外が発生した場合に表示されるメッセージを入力します。成功メッセージとエラー・メッセージの両方についてサポートされる置換文字列の詳細は、フィールドレベル・ヘルプを参照してください。

3. メッセージ、エラー・メッセージ表示位置 - プロセス・エラー・メッセージを表示する位置を指定します。プロセス・エラー・メッセージは、エラー・ページに表示するか、通知領域(ページ・テンプレートの一部として定義される)の既存のページでインライン表示できます。

3. 「変更の適用」をクリックします。

関連項目:
「ページ・テンプレート」

17.3.3.5 ページ・プロセスを条件付きにする

条件付きのページ・プロセスを作成するには、次のステップを実行します。

1. ページ・プロセスの編集ページにアクセスします。「コンポーネント・ビューでのページ・プロセス属性の編集」を参照してください。

2. 次の属性を編集します。

1. 条件、対象ボタン - ページ・ボタンを選択します。選択したボタンをユーザーがクリックすると、検証が実行されます(定義された他の条件によって異なります)。この検証は、指定されたボタンをクリックする以外の方法でページが送信された場合に実行されます。
ボタンがクリックされない場合、検証を実行する前に他の条件が評価されます。

2. 条件、実行スコープ - 表形式フォームにのみ適用されます。次のようにして、実行スコープを指定します。

- 作成済および変更済の列: 表形式フォームで作成および変更した行でのみ検証を実行します。

- すべての送信済の列: 送信したすべての行で検証を実行します。

3. 条件、条件タイプ - このコンポーネントがレンダリング処理されるために満たす必要がある条件タイプをリストから選択します。

- 式属性: 選択した条件タイプに応じて、式属性に値を入力します。

- 実行条件: 表形式フォームにのみ適用されます。次のいずれかを選択します。
各行: 条件で表形式フォームの列を参照する場合は、このオプションを選択します。このオプションにより、表形式フォームの各行で条件が評価されます。

1回: 表形式フォームに固有の値を参照しない場合は、このオプションを選択します。

3. 「変更の適用」をクリックします。

17.4 ブランチについて

ブランチは、特定のページ、プロシージャまたはURLへ移動する指示です。たとえば、ページ1の送信後、ページ1からページ2にブランチできます。ブランチを作成する場合、ブランチ・ポイントとブランチ・タイプを指定します。

関連項目:
「ブランチを使用したナビゲーションの制御」

17.5 アプリケーション・プロセスの理解

この項では、アプリケーション・プロセスを作成および管理する方法について説明します。アプリケーション・プロセスとは、アプリケーションの複数ページからのプロセスを使用して、特定のポイントで実行されるように設定されているPL/SQLロジックのブロックです。デフォルトでは、アプリケーション・プロセスはアプリケーション内のすべてのページについて同じポイントで実行されます。ただし、特定のページに対する条件を適用して、プロセスが実行されるタイミングを制御できます。

ヒント:
検証エラーがあった際の処理の詳細は、「検証が失敗した場合の処理」を参照してください。

- オンデマンド・アプリケーション・プロセスについて

- 新しいインスタンス開始時に実行されるアプリケーション・プロセスについて

- ページ・リクエストからのオンデマンド・プロセスの実行について

- アプリケーション・プロセスの例

- アプリケーション・プロセスの作成

- アプリケーション・プロセス属性の編集

- アプリケーション・プロセスのエラー・メッセージの作成

- 「アプリケーション・プロセス履歴」レポートの表示

関連項目:
「ページ・プロセスの理解」

17.5.1 オンデマンド・アプリケーション・プロセスについて

「オンデマンド」プロセスは、プロセス・ポイントが「オンデマンド」の特殊なタイプのアプリケーション・プロセスで、ページ・レベルの「オンデマンド」プロセスからコールされた場合またはブラウザからのAJAXコールによってのみ実行されます。オンデマンド・プロセスは、複数のページにわたって様々な実行ポイントから実行するPL/SQLロジックがある場合に有効です。

オンデマンド・プロセスは、通常、アプリケーションレベルではなく、ページに作成される必要があります。アプリケーションレベルで作成されたオンデマンド・プロセスは、初期認可スキームの「パブリック・ユーザーは不可」で作成されます。これは、認証されていないセッションのユーザーからプロセスが起動されることを禁止します。

関連項目:
「コンポーネント・ビューでのページ・プロセスの作成」

17.5.2 新しいインスタンス開始時に実行されるアプリケーション・プロセスについて

通常、アプリケーション・プロセスは、アプリケーション内の複数のページにわたって同じポイントで実行されます。プロセス・ポイントが「新しいインスタンス開始時」であるプロセスは例外です。これらのタイプのプロセスは、ユーザーのセッション内で情報を1回のみ取得する必要がある場合に便利です。たとえば、アプリケーション・アイテムがログインしているユーザーに依存していない場合は、プロセス・ポイント「新しいインスタンス開始時」を使用してそれらのアイテムを初期化できます。また、ユーザーに依存する情報を検索するために、「認証後」を使用することもできます。

認証スキーム(「新しいインスタンス開始時」および「ログイン後」)で同じCookie名を設定することによって、アプリケーションが同じセッションを共有するように構成すると、アプリケーション・プロセスは、Oracle Application Expressがアプリケーションのリクエストを最初に処理するとき(「新しいインスタンス開始時」)や、アプリケーションに対して認証されたユーザーのリクエストを処理するとき(「認証後」)、常に実行されます。

17.5.3 ページ・リクエストからのオンデマンド・プロセスの実行について

次の構文を使用すると、ページ・リクエストでオンデマンド・プロセスを実行できます。

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でセッション・ステート(アイテムの名前および値)を設定することはできますが、「キャッシュのクリア」オプションは無視されます。

- 認証、認可、またはプロセス条件が失敗してもエラー・メッセージや失敗に対するその他のインジケータは表示されず、多くの場合、空白ページが表示されます。アプリケーション・ビルダーに開発者としてログインした場合、エラー・メッセージが表示されます。

- プロセスを名前で指定すると、指定した(大/小文字が区別される)名前を持つ最初のプロセスが検出されます。

関連項目:
「セッション・ステートのクリア」

17.5.4 アプリケーション・プロセスの例

アプリケーション・プロセスを使用する場合の例として、ショッピング・カート・アプリケーションがあげられます。たとえば、各ページ・ビューでユーザーのショッピング・カートのコンテンツを表示するには、アプリケーションのページ0(ゼロ)に、アプリケーション・レベル・アイテムTOTAL_CART_ITEMSおよびTOTAL_PURCHASE_PRICEの値を表示するリージョンを作成します。

関連項目:
「すべてのページにコンポーネントを表示するグローバル・ページの作成」

各ページでTOTAL_CART_ITEMSおよびTOTAL_PURCHASE_PRICEの値を設定するプロセスを記述するかわりに、「ロード時: ヘッダーの前」というタイプのアプリケーション・プロセスを記述して、これらの値を計算できます。これによって、Application Expressエンジンは、アプリケーションをレンダリングするよう各ページでプロセスを実行します。この結果、各ページでTOTAL_CART_ITEMSおよびTOTAL_PURCHASE_PRICEの最新の値が表示されます。

17.5.5 アプリケーション・プロセスの作成

アプリケーション・プロセスを作成するには、次のステップを実行します。

1. 共有コンポーネント・ページにナビゲートします。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。
共有コンポーネント・ページが表示されます。

2. 「アプリケーション・ロジック」で、「アプリケーション・プロセス」を選択します。
アプリケーション・プロセス・ページが表示されます。

3. 「作成」をクリックします。

4. 「指定」で、次のステップを実行します。

1. 名前: アプリケーション・プロセスの名前を入力します。

2. 順序: このプロセスの順序番号を指定します。この順序番号によって、同じポイントで実行される他のプロセスに対する、プロセスの相対的な評価順序が決まります。

3. ポイント: アプリケーションの各ページの処理において、このプロセスが実行されるポイントを指定します。「オンデマンド」オプションは、ページ・プロセスによりリクエストされた場合にのみ実行されることに注意してください。

4. 「次へ」をクリックします。

5. 「ソース」で、次のステップを実行します。

1. PL/SQLコード: アプリケーション・プロセスのPL/SQLコードを入力します。コードは、自動的にBeginとEnd;で囲まれます。

2. 「エラー・メッセージ」: プロセスでエラーが発生した場合に表示するエラー・メッセージを入力します。「アプリケーション・プロセスのエラー・メッセージの作成」を参照してください。

3. 「次へ」をクリックします。

6. 「条件付け」で、次のステップを実行します。

1. 条件タイプ: このプロセスを実行するために満たされる必要がある条件タイプを選択します。

2. 式1、式2: これらの属性を使用して、プロセスが実行されるかどうかを条件付きで制御します。選択した特定の条件タイプに基づいて、この属性に値を入力します。指定した条件が満たされた場合、プロセスが実行されます。

3. 「プロセスの作成」をクリックします。

17.5.6 アプリケーション・プロセス属性の編集

既存のページ・プロセスを編集するには、次のステップを実行します。

1. 共有コンポーネント・ページにナビゲートします。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。
共有コンポーネント・ページが表示されます。

2. 「ロジック」で、「アプリケーション・プロセス」を選択します。
アプリケーション・プロセス・ページが表示されます。

3. プロセス名をクリックします。

4. 対象となる属性を編集します。詳細は、フィールドレベル・ヘルプを参照してください。

5. 「変更の適用」をクリックします。

17.5.7 アプリケーション・プロセスのエラー・メッセージの作成

プロセスでエラーが発生した場合にユーザーに表示するエラー・メッセージを定義できます。エラー・メッセージの表示方法は、プロセス・ポイントによって異なります。「送信時 - 計算および検証の前」または「送信時 - 計算および検証の後」プロセス・ポイントを持つプロセスでは、カレント・ページにインラインでエラー・メッセージを表示するか(デフォルト)、別のページに表示するかを指定できます。他のすべてのアプリケーション・プロセスでは、エラー・メッセージは別のエラー・ページに表示されます。

アプリケーション・プロセスのエラー・メッセージを作成するには、次のステップを実行します。

1. アプリケーション・プロセス属性にアクセスします。「アプリケーション・プロセス属性の編集」を参照してください。

2. 次の属性を編集します。

1. ソース、プロセス・エラー・メッセージ - 未処理例外が発生した場合に表示されるメッセージを入力します。

2. エラー・メッセージ表示位置 - 「送信時 - 計算および検証の前」または「送信時 - 計算および検証の後」のプロセス・ポイントを持つプロセスに適用され、エラー・メッセージの表示位置を指定できます。
次のいずれかを選択します。

- 通知でインライン表示: エラーは、通知領域(ページ・テンプレートの一部として定義される)内のページにインラインで表示されます。

- エラー・ページ: エラーは別のエラー・ページに表示されます。
アプリケーションに、(SQL文のAPEX_ITEMコールを使用して)手動で作成された表形式フォームが含まれている場合は、「エラー・ページ」を選択してください。そうしない場合、ユーザーが行った変更はページが再レンダリングされるときに破棄されます。エラーが別のエラー・ページに表示される場合、ユーザーはブラウザの「戻る」ボタンを使用して、入力された値を保持できます。

3. 「変更の適用」をクリックします。

17.5.8 「アプリケーション・プロセス履歴」レポートの表示

「アプリケーション・プロセス履歴」レポートには、アプリケーション・プロセスに行われた最近の変更が表示されます。

「アプリケーション・プロセス履歴」レポートにアクセスするには、次のステップを実行します。

1. 共有コンポーネント・ページにナビゲートします。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。
共有コンポーネント・ページが表示されます。

2. 「ロジック」で、「アプリケーション・プロセス」を選択します。
アプリケーション・プロセス・ページが表示されます。

3. ページ上部の 「履歴」 タブを選択します。

4. ページ上部の検索バーを使用してページの概観をカスタマイズできます。使用可能なコントロールは次のとおりです。

- 検索列の選択: 虫めがねに似ています。このアイコンをクリックして、検索を絞り込みます。すべての列を検索するには、「すべての列」を選択します。

- テキスト領域: 名前でプロセスを検索するための大/小文字を区別しない検索基準(ワイルドカード文字を含む)を入力し、「実行」をクリックします。

- 「実行」ボタン: 検索を実行したり、フィルタを適用します。

- 「アクション」メニュー: 「アクション」メニューを使用して、レポート・ビューをカスタマイズします。「「アクション」メニューについて」を参照してください。

17.6 アプリケーションの計算の理解

この項では、アプリケーションの計算を作成する方法について説明します。

ヒント:
検証エラーがあった際の処理の詳細は、「検証が失敗した場合の処理」を参照してください。

- アプリケーションの計算について

- 新しいインスタンス開始時に実行されるアプリケーションの計算について

- アプリケーションの計算の作成

- アプリケーション計算履歴レポートへのアクセス

17.6.1 アプリケーションの計算について

アプリケーションの計算は、単一のページ・レベル・アイテムまたはアプリケーション・レベル・アイテムの値を設定するロジックの単位であり、アプリケーション内の複数のページにわたって同じポイントで実行されます。ページ・レベルの計算と同様に、アプリケーションの計算も静的値、アイテム値、PL/SQLまたはSQLに基づくことができます。

アプリケーション・アイテムの一般的な用途は、アプリケーションで最後に参照されたページの値を格納することです。アイテムに値を格納することで、戻るボタンを追加して、計算で求められたページ番号にユーザーをリダイレクトできます。このタイプの計算は、たとえばユーザーがエラー・ページを取り消せるようにする場合に効果的です。

次に、最後にアクセスされたページを格納する計算の例を示します。この例では、計算によって次のことが実行されます。

- LAST_PAGEというアイテムへの最後にアクセスされたアプリケーション・ページの格納

- CURRENT_PAGE_ITEMの値が次に示す計算ボディを含むPL/SQLのファンクション本体のタイプであるかどうかの確認

BEGIN
:LAST_PAGE := nvl(:CURRENT_PAGE,:APP_PAGE_ID);
:CURRENT_PAGE := :APP_PAGE_ID;
RETURN :LAST_PAGE;
END;

17.6.2 新しいインスタンス開始時に実行されるアプリケーションの計算について

通常、アプリケーションの計算は、アプリケーション内の複数のページにわたって同じポイントで実行されます。例外は、「新しいインスタンス開始時」という計算ポイントを持つ計算です。これらのタイプの計算は、ユーザーのセッション内で情報を1回のみ取得する必要がある場合に便利です。たとえば、ログインしているユーザーに依存しないアプリケーション・アイテムは、計算ポイント「新しいインスタンス開始時」を使用して初期化できます。また、ユーザーに依存する情報を検索するために、「認証後」を使用することもできます。

認証スキーム(「新しいインスタンス開始時」および「ログイン後」)で同じCookie名を設定することによって、アプリケーションが同じセッションを共有するように構成すると、アプリケーション・プロセスは、Oracle Application Expressがアプリケーションのリクエストを最初に処理するとき(「新しいインスタンス開始時」)や、アプリケーションに対して認証されたユーザーのリクエストを処理するとき(「認証後」)、常に実行されます。

17.6.3 アプリケーションの計算の作成

アプリケーションの計算を作成するには、次のステップを実行します。

1. 共有コンポーネント・ページにナビゲートします。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。
共有コンポーネント・ページが表示されます。

2. 「ロジック」で、「アプリケーションの計算」を選択します。

3. 「作成」をクリックします。

4. 次の属性を編集します。

1. アイテム、順序 - このコンポーネントの順序を指定します。これによって評価の順序が決まります。

2. アイテム、計算アイテム - この計算によって影響を受けるアイテムを選択します。

3. 頻度、計算ポイント - この計算を実行するプロセス・ポイントを選択します。「送信後」を選択すると、ページが表示され送信された後でのみ計算が実行されます。

4. 計算、計算タイプ - この計算の実行方法を選択します。

5. 計算、計算 - 計算タイプに対応する計算ロジックを入力します。例は、フィールドレベル・ヘルプを参照してください。

6. 計算、計算エラー・メッセージ - 計算が失敗した場合に表示されるエラー・メッセージを入力します。

7. 認可、認可スキーム (オプション) - この計算を実行するためにTrueと評価される必要がある認可スキームを選択します。

8. 条件、条件タイプ (オプション) - この計算を実行するために満たされる必要がある条件タイプを選択します。

9. ビルド・オプション (オプション) - このコンポーネント用のビルド・オプションを選択します。「ビルド・オプションを使用した構成の制御」を参照してください。

5. 「計算の作成」をクリックします。

17.6.4 アプリケーション計算履歴レポートへのアクセス

アプリケーションの計算を作成すると、アプリケーション計算履歴レポートを表示できます。アプリケーション計算履歴レポートには、最近変更されたアプリケーション計算の履歴が日付ごとに表示されます。

アプリケーション計算履歴レポートにアクセスするには、次のステップを実行します。

1. 共有コンポーネント・ページにナビゲートします。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。
共有コンポーネント・ページが表示されます。

2. 「ロジック」で、「アプリケーションの計算」を選択します。

3. ページ上部の「履歴」を選択します。

4. ページ上部の検索バーを使用してページの概観をカスタマイズできます。使用可能なコントロールは次のとおりです。

- 検索列の選択: 虫めがねに似ています。このアイコンをクリックして、検索を絞り込みます。すべての列を検索するには、「すべての列」を選択します。

- テキスト領域: 大/小文字を区別しない検索基準(ワイルドカード文字を含む)を入力し、「実行」をクリックします。

- 「実行」ボタン: 検索を実行したり、フィルタを適用します。

- 「アクション」メニュー: 「アクション」メニューを使用して、レポート・ビューをカスタマイズします。「「アクション」メニューについて」を参照してください。

17.7 属性ディクショナリの使用

この項では、属性ディクショナリの使用方法について説明します。

- 属性ディクショナリについて

- 「属性ディクショナリの管理」へのアクセス

17.7.1 属性ディクショナリについて

属性ディクショナリには、フォームとレポートの作成に使用する列についての属性のセットが含まれます。定義は列名によって照合され、シノニムを使用することで特定の定義を複数の列間で共有できます。

「属性ディクショナリの管理」ページを使用して、現在のページの値を属性ディクショナリ内の値で更新するか、現在のページの値で属性ディクショナリを更新することができます。

17.7.2 「属性ディクショナリの管理」へのアクセス

属性ディクショナリの管理ページにアクセスするには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。
アプリケーション・ビルダーのホームページが表示されます。

2. アプリケーションを選択します。

3. 「ユーティリティ」をクリックします。

4. 「ユーティリティ」をクリックして、「属性ディクショナリ」をクリックします。
このページは、「ページ・アイテム」と「レポート列」の2つのセクションに分かれています。

ページ・アイテムおよびレポート列の定義を使用して、属性ディクショナリを更新します。また、属性ディクショナリを使用してページ・アイテムおよびレポート列を更新することもできます。

(非表示のリージョンおよびボタン・アイテム内の)非表示オブジェクトは、更新に使用されないため、アイテムおよびレポート列の候補数に入りません。

5. 現在のページを更新するか、現在の属性ディクショナリを更新するには、適切なページ・リンクを選択します。
「属性ディクショナリ」が表示されます。

少なくとも1つの属性について異なる値を持つアイテムおよびレポート列のみが表示されます。挿入または更新するオブジェクトおよび含める属性を選択します。非表示オブジェクト、非表示リージョン内のオブジェクトおよびボタン・アイテムは含まれないため、使用できるアイテムおよびレポート列は合計よりも少ないことがあります。

ヒント:
ページ・デザイナとコンポーネント・ビューのどちらでも、「ユーティリティ」をクリックして「属性ディクショナリ」を選択することによって、属性ディクショナリにアクセスできます。

18 共有コンポーネントの管理

共有コンポーネントは、アプリケーション内のすべてのページに表示または適用できます。この項では、共有コンポーネントを使用する利点、および特に、静的アプリケーション・ファイル、静的ワークスペース・ファイル、イメージ、アプリケーション・レベル・アイテム、LOV、リスト、ショートカットおよびレポート出力を管理する方法について説明します。

- 共有コンポーネントでの作業

- コンポーネント設定の管理

- 静的アプリケーション・ファイルの管理

- 静的ワークスペース・ファイルの管理

- アプリケーション・レベル・アイテムの管理

- アプリケーション・レベルでのLOVの作成

- リストの作成

- ショートカットの使用

- レポート出力の管理

関連項目:
「アプリケーション・ビルダーの概念」、「データベース・アプリケーションの作成」、「ページ・レイアウトの制御」および「ナビゲーションの追加」

18.1 共有コンポーネントでの作業

共有コンポーネントは、アプリケーション内のすべてのページに表示または適用される共通の要素です。共有コンポーネント・ページのツールやウィザードを、アプリケーション・レベルまたは特定のページで使用できます。

- 共有コンポーネントを使用する利点について

- 共有コンポーネント・ページへのアクセス

- 「共有コンポーネント」アイコンについて

- 共有コンポーネント・ページ

関連項目:
「アプリケーションおよびアプリケーション・コンポーネントのエクスポート」

18.1.1 共有コンポーネントを使用する利点について

タブ、リスト、ブレッドクラムおよびナビゲーション・バー・エントリは共有コンポーネントです。共有コンポーネントは、アプリケーション内のすべてのページに表示または適用される共通の要素です。共有コンポーネント・ページのツールやウィザードを、アプリケーション・レベルまたは特定のページで使用できます。共有コンポーネントの大きな利点は、作成した共有コンポーネントをデータベース・アプリケーション内の任意のページに追加できることです。

関連項目:
「共有コンポーネントでの作業」

18.1.2 共有コンポーネント・ページへのアクセス

「共有コンポーネント」ページにアクセスするには、次のステップを実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。
共有コンポーネント・ページが表示されます。

4. 共有コンポーネントを作成するには、該当するリンクを選択します。

18.1.3 「共有コンポーネント」アイコンについて

アプリケーションを選択した後、ページ上部の「共有コンポーネント」アイコンをクリックすることで、共有コンポーネント・ページにアクセスできます。「共有コンポーネント」アイコンは、丸と四角形の上に三角形がある形です。このアイコンは、アプリケーションのホームページ、ページ・デザイナ、コンポーネント・ビュー、サポートするオブジェクト、ユーティリティなど、ほとんどのアプリケーション・ビルダー・ページの上部に表示されます。

18.1.4 共有コンポーネント・ページ

この項では、共有コンポーネント・ページのリージョンおよびリンクについて説明します。

- アプリケーション・ロジック

- セキュリティ

- 他のコンポーネント

- ナビゲーション

- ユーザー・インタフェース

- ファイル

- データ参照

- レポート

- グローバリゼーション

- 「タスク」リージョン

関連項目:
「共有コンポーネント・ページへのアクセス」

18.1.4.1 アプリケーション・ロジック

表18-1に、共有コンポーネント・ページの「アプリケーション・ロジック」のリンクを示します。

表18-1 共有コンポーネント・ページの「アプリケーション・ロジック」リンク

リンク

説明

アプリケーション定義属性

アプリケーション定義の編集ページにリンクします。このページを使用して、アプリケーションの属性を編集します。属性は、「定義」、「セキュリティ」、「グローバリゼーション」および「ユーザー・インタフェース」の4つのカテゴリにグループ化されます。

関連項目: 「アプリケーション属性の管理」

アプリケーション・アイテム

アプリケーション・レベル・アイテムは表示されませんが、アプリケーションのグローバル変数として使用されます。一般に、アプリケーションまたはページの計算を使用して、ページ・レベル・アイテムの値を設定します。

関連項目: 「アプリケーション・レベル・アイテムの管理」

アプリケーション・プロセス

アプリケーション・プロセスを使用すると、次のようにPL/SQLロジックを実行できます。

- アプリケーションの各ページの特定のポイントで

- プロセスの実行条件で定義されているとおりに

- 新しいセッションの作成時

「オンデマンド」プロセスは、ページ・レベルの「オンデマンド」プロセスからコールされた場合か、ブラウザからAJAXを使用してコールされた場合にのみ実行されます。

関連項目: 「アプリケーション・プロセスの理解」

アプリケーションの計算

アプリケーション・レベルの計算を使用すると、表示される各ページに対して、または新規アプリケーション・セッションの作成時に、アプリケーション・レベル・アイテムとページ・レベル・アイテムに値を割り当てることができます。また、アプリケーション・レベルの計算を作成し、条件付きで複数のページで実行することもできます。

関連項目: 「アプリケーションの計算の理解」

18.1.4.2 セキュリティ

表18-2に、共有コンポーネント・ページの「セキュリティ」のリンクを示します。

表18-2 共有コンポーネント・ページの「セキュリティ」リンク

リンク

説明

セキュリティ属性

セキュリティ属性の編集ページを使用して、アプリケーション内のすべてのページの一般的なセキュリティ属性を構成します。

関連項目: 「セキュリティ属性の構成」

認証スキーム

認証は、ユーザーがアプリケーションにアクセスする前に、そのユーザーのアイデンティティを証明するプロセスです。認証では、ユーザー名とパスワードの入力や、ユーザーのアイデンティティまたは保護キーの使用が必要となる場合があります。

関連項目: 認証によるユーザー・アイデンティティの証明

認可スキーム

認可は、事前定義されたユーザー権限に基づいて、特定のコントロールやコンポーネントに対するユーザーのアクセスを制限するものです。

関連項目: 「認可を介したセキュリティの提供」

セッション・ステート保護

セッション・ステート保護は、ハッカーがアプリケーション内のURLを改ざんするのを防ぐための組込み機能です。URL改ざんにより、プログラム・ロジック、セッション・ステートの内容および情報プライバシが悪影響を受ける可能性があります。

関連項目: 「セッション・ステート保護の理解」

ビルド・オプション

ビルド・オプションを使用すると、アプリケーション内の特定の機能を条件付きで表示または処理できます。ビルド・オプションを使用して、アプリケーションの各デプロイについて、アプリケーションのどの機能をオンにするかを制御できます。

関連項目: 「ビルド・オプションを使用した構成の制御」。

18.1.4.3 他のコンポーネント

表18-3に、共有コンポーネント・ページの「セキュリティ」のリンクを示します。

表18-3 共有コンポーネント・ページの「他のコンポーネント」リンク

リンク

説明

LOV

LOVは、ポップアップLOV、選択リスト、チェック・ボックスまたはラジオ・グループを表示するために使用される静的または動的な値のセットです。

関連項目: 「アプリケーション・レベルでのLOVの作成」

プラグイン

アプリケーション・ビルダーには、組込みのアイテム・タイプ、リージョン・タイプ、動的アクションおよびプロセスが含まれています。新しい宣言的なタイプをアプリケーションに追加するためにプラグインを使用します。

関連項目: 「プラグインの実装」

コンポーネント設定

「コンポーネント設定」を使用して、組込みのOracle Application Expressコンポーネントおよびインストール済プラグインのアプリケーション・レベル値を設定します。

関連項目: 「コンポーネント設定の管理」

ショートカット

ショートカットを使用すると、HTMLまたはPL/SQLファンクションを繰り返しコーディングする必要がなくなります。ショートカットを作成して、ボタン、HTMLテキスト、PL/SQLプロシージャ、HTMLなどのページ・コントロールを定義できます。定義したショートカットは、アプリケーション内の様々な位置から参照できるように中央リポジトリに格納されます。

関連項目: 「ショートカットの使用」

18.1.4.4 ナビゲーション

表18-4に、共有コンポーネント・ページの「ナビゲーション」のリンクを示します。

表18-4 共有コンポーネント・ページの「ナビゲーション」リンク

リンク

説明

リスト

リストは、リンクの共有コレクションです。リストの外観は、リスト・テンプレートで制御します。各リスト要素には、表示のタイミングを制御できる表示条件があります。

関連項目: 「リストの作成」

ナビゲーション・メニュー

ナビゲーション・メニューは、アプリケーション内のページへのナビゲートを可能にするリスト・リンクです。ナビゲーション・メニューは、ユニバーサル・テーマ - 42を使用するアプリケーションでのみサポートされます。

関連項目: 「ナビゲーション・メニューについて」

タブ

タブは、アプリケーションのページ間でのナビゲートに有効な方法です。標準タブまたは親タブという2つのタイプのタブを作成できます。標準タブ・セットは、特定のページおよびページ番号に関連付けられます。親タブ・セットは、標準タブのグループを保持するコンテナとして機能します。

関連項目: 「タブの作成」

ブレッドクラム

ブレッドクラムを使用すると、階層的にナビゲートできます。ブレッドクラムは、テンプレートを使用して表示されるリンクの階層的なリストです。ブレッドクラムは、リンクのリストまたはブレッドクラム・パスとして表示できます。

関連項目: 「ブレッドクラムの作成」

ナビゲーション・バー・エントリ

ナビゲーション・バー・エントリは、アプリケーションのページ間を移動する単純なナビゲーション・パスを提供します。ナビゲーション・バーの位置は、関連付けられたページ・テンプレートによって異なります。ナビゲーション・バー・エントリは、イメージまたはテキストからのリンクとして表示できます。ナビゲーション・バー・エントリは、イメージ、説明付きのイメージまたはテキストです。

関連項目: 「ナビゲーション・バー・エントリの作成」

18.1.4.5 ユーザー・インタフェース

表18-5に、共有コンポーネント・ページの「ユーザー・インタフェース」のリンクを示します。

表18-5 共有コンポーネント・ページの「ユーザー・インタフェース」リンク

リンク

説明

ユーザー・インタフェース属性

「ユーザー・インタフェース」ページを使用して、アプリケーションのユーザー・インタフェース・オプションを指定します。

関連項目: 「アプリケーションのユーザー・インタフェースの管理」

テーマ

テーマは、アプリケーションのユーザー・インタフェースを定義するテンプレートの名前付きコレクションです。

関連項目: 「テーマの使用」

テンプレート

テンプレートは、アプリケーション内の特定の構成要素(ページ、リージョン、アイテム、メニューなど)のルック・アンド・フィールを制御します。

関連項目: 「カスタム・テーマの作成」

18.1.4.6 ファイル

表18-6に、共有コンポーネント・ページの「ユーザー・インタフェース」のリンクを示します。

表18-6 共有コンポーネント・ページの「ファイル」リンク

リンク

説明

静的アプリケーション・ファイル

このリンクを使用して、スタイルシート(CSS)、イメージ、JavaScriptファイルなどのカレント・アプリケーションに関連する静的ファイルのアップロード、編集および削除を行います。

関連項目: 「静的アプリケーション・ファイルの管理」

静的ワークスペース・ファイル

このリンクを使用して、スタイルシート(CSS)、イメージ、JavaScriptファイルなどのカレント・アプリケーションに関連する静的ファイルのアップロード、編集および削除を行います。

関連項目: 「静的ワークスペース・ファイルの管理」

18.1.4.7 データ参照

表18-7に、共有コンポーネント・ページの「ユーザー・インタフェース」のリンクを示します。

表18-7 共有コンポーネント・ページの「データ参照」リンク

リンク

説明

データのロード

データ・ロード表を使用して、データ・ロードのページ作成ウィザードで使用する表を定義します。データ・ロード表は、データをアップロードするデータ・ロード・プロセスで使用するために選択したスキーマに存在する既存の表です。

関連項目: 「プラグイン・ページからのプラグインのインポート」

Webサービス参照

アプリケーション・ビルダーのWebサービス参照は通常、Simple Object Access Protocol(SOAP)またはRepresentational State Transfer(REST)アーキテクチャに基づいています。Webサービスへの参照を作成してアプリケーションに組み込み、フォームによって送信されたデータを処理したり、フォームまたはレポートに出力をレンダリングできます。

関連項目: 「Webサービスの実装」

18.1.4.8 レポート

表18-8に、共有コンポーネント・ページの「ユーザー・インタフェース」のリンクを示します。

表18-8 共有コンポーネント・ページの「データ参照」リンク

リンク

説明

レポート問合せ

「レポート問合せ」リンクを使用すると、カレント・アプリケーション内のストアド・クエリーのレポートを表示できます。

関連項目: 「レポート問合せの定義によるレポート・リージョンの印刷」

レポート・レイアウト

レポートまたは共通問合せとともに「レポート・レイアウト」を使用すると、Adobe Portable Document Format(PDF)、Microsoft Word Rich Text Format(RTF)、Microsoft Excel(XLS)形式などの印刷用形式でデータをレンダリングできます。

関連項目: 「レポート・レイアウトを使用したレポート・リージョンまたはレポート問合せのフォーマット」

18.1.4.9 グローバリゼーション

表18-9に、共有コンポーネント・ページの「ユーザー・インタフェース」のリンクを示します。

表18-9 共有コンポーネント・ページの「グローバリゼーション」リンク

リンク

説明

グローバリゼーション属性

異なる言語で同時に実行可能なアプリケーションを開発できます。このリンクをクリックして、「アプリケーションのプライマリ言語」、「アプリケーション言語の派生元」属性などのグローバリゼーション・オプションを指定します。

関連項目: 「グローバリゼーション属性の構成」および「アプリケーション翻訳およびグローバリゼーション・サポートの理解」

テキスト・メッセージ

テキスト・メッセージは、ユーザーが作成するPL/SQLコードからコールできる名前付きのテキスト文字列です。このPL/SQLは、ページ・プロセスおよびページ・リージョン、またはパッケージおよびプロシージャで無名ブロックとして使用できます。

関連項目: 「メッセージの翻訳」

アプリケーションの翻訳

Oracle Application Expressでは、異なる言語で同時に実行可能なアプリケーションを開発できます。1つのOracle DatabaseおよびOracle Application Expressインスタンスは、複数言語でアプリケーションをサポートできます。アプリケーションの翻訳には複数のステップが必要です。

関連項目: 「アプリケーション翻訳およびグローバリゼーション・サポートの理解」および「翻訳プロセスの理解」

18.1.4.10 「タスク」リージョン

共有コンポーネント・ページの右側にある「タスク」リストには、次のリンクが含まれます。

- アプリケーション・コンポーネントのエクスポート - コンポーネントのエクスポート・ページにリンクします。このページは、バックアップまたは別のインスタンスへのコンポーネントのロードを目的として、エクスポートされるアプリケーションのコンポーネントを識別する際に使用します。「アプリケーション・コンポーネントのエクスポート」を参照してください。

- サポートするオブジェクトの管理 - サポートするオブジェクト・ページにリンクします。このページは、パッケージ・アプリケーションを作成する際に使用します。「カスタム・パッケージ・アプリケーションの作成方法」を参照してください。

- アプリケーション・コメントの編集 - アプリケーション・コメント・ページにリンクします。このページを使用して、現在選択しているアプリケーションに固有のコメントを入力します。「データベース・アプリケーション・コメントの追加」を参照してください。

- 開発者コメントのレビュー - 開発者のコメント・ページにリンクします。「開発者コメントの追加」を参照してください。

- 開発者コメントのカレンダ - 開発者コメントのカレンダ・ページにリンクします。「開発者コメントのカレンダの表示」を参照してください。

18.2 コンポーネント設定の管理

この項では、コンポーネント設定ページを使用して、組込みのOracle Application Expressコンポーネントおよびインストール済プラグインのアプリケーション・レベル値を構成する方法について説明します。

- コンポーネント設定の編集

- コンポーネント設定の履歴レポートの表示

18.2.1 コンポーネント設定の編集

コンポーネント設定を編集するには、次の手順を実行します。

1. 共有コンポーネント・ページにナビゲートします。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。
共有コンポーネント・ページが表示されます。

2. 「他のコンポーネント」で、「コンポーネント設定」をクリックします。
「コンポーネント設定」ページは、対話モード・レポートとして表示されます。レポートをカスタマイズするには、ページ上部にある検索バーを使用します。詳細は、「検索バーについて」を参照してください。

3. 設定を編集し、「変更の適用」をクリックします。

18.2.2 コンポーネント設定の履歴レポートの表示

Oracle Application Expressコンポーネントおよび「コンポーネント設定履歴」ページのインストール済プラグインへ行った変更のレポートを表示できます。

「コンポーネント設定履歴」レポートを表示するには、次の手順を実行します。

1. 共有コンポーネント・ページにナビゲートします。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。
共有コンポーネント・ページが表示されます。

2. 「他のコンポーネント」で、「コンポーネント設定」をクリックします。

3. 「履歴」タブをクリックします。
「履歴」ページは、対話モード・レポートとして表示されます。レポートをカスタマイズするには、ページ上部にある検索バーを使用します。詳細は、「検索バーについて」を参照してください。

18.3 静的アプリケーション・ファイルの管理

この項では、静的アプリケーション・ファイル(イメージ、CSSファイルおよび個別に管理する必要があるその他のファイルを含む)をアップロード、表示、ダウンロードおよび削除する方法について説明します。

- 静的アプリケーション・ファイルの場所の指定

- 静的アプリケーション・ファイルのアップロード

- 「静的アプリケーション・ファイル」レポートの表示

- 静的アプリケーション・ファイルの参照について

- 静的アプリケーション・ファイルのダウンロード

- 静的アプリケーション・ファイルの削除

関連項目:
「静的ワークスペース・ファイルの管理」および「イメージの管理について」

18.3.1 静的アプリケーション・ファイルの場所の指定

アプリケーション・ファイルは、アプリケーション定義とともにOracleデータベースに格納されます。パフォーマンス上の理由から、アプリケーション・ファイルをWebサーバーに格納することもできます。

アプリケーションの「静的ファイルの接頭辞」属性を確認するには、次のステップを実行します。

1. 共有コンポーネント・ページにナビゲートします。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。
共有コンポーネント・ページが表示されます。

2. 「ユーザー・インタフェース」で「ユーザー・インタフェース属性」を選択します。

3. 「ユーザー・インタフェース」タブをクリックします。

4. 「静的ファイルの接頭辞」で、Webサーバーが静的アプリケーション・ファイルを指すために使用する仮想パスを入力します。データベースにアプリケーション定義とともに格納されたファイルを参照するには、この属性を空白のままにします。パフォーマンス上の理由から、アプリケーション・ファイルをWebサーバーに格納し、有効なURLを使用して参照することもできます。例:

/myFiles/
http://contentDeveliveryNetwork.com/myFiles/

5. 「変更の適用」をクリックします。

18.3.2 静的アプリケーション・ファイルのアップロード

静的アプリケーション・ファイルをアップロードするには、次のステップを実行します。

1. 共有コンポーネント・ページにナビゲートします。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。
共有コンポーネント・ページが表示されます。

2. 「ファイル」で、「静的アプリケーション・ファイル」を選択します。
静的アプリケーション・ファイル・ページが表示されます。

3. ファイルをアップロードするには、「ファイルのアップロード」をクリックします。

4. 「アップロード」で、次のステップを実行します。

1. ディレクトリ - ファイルの格納先ディレクトリの名前を入力します。ディレクトリを指定しない場合、ファイルはルート・ディレクトリに格納されます。

2. ファイル - アプリケーションに追加するファイルの場所を入力します。

3. ファイルの文字セット - アップロードするファイルの文字セット・エンコーディングを指定します。この属性は、テキスト・ファイルにのみ適用されます。

4. ファイルの解凍 - 「はい」の場合、アップロードしたZipファイルは自動的に解凍され、指定したディレクトリに格納されます。実際のZipファイルが格納されるわけではないことに注意してください。アップロードしたファイルがZipファイルでない場合、この属性は無視されます。

5. 「アップロード」または「アップロードと別のアップロード」をクリックします。

18.3.3 「静的アプリケーション・ファイル」レポートの表示

アップロードした静的アプリケーション・ファイルの詳細を表示するには、次のステップを実行します。

1. 共有コンポーネント・ページにナビゲートします。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。
共有コンポーネント・ページが表示されます。

2. 「ファイル」で、「静的アプリケーション・ファイル」を選択します。
静的アプリケーション・ファイル・ページが表示されます。

3. まだ選択していない場合は、「レポートの表示」アイコンをクリックします。
レポートが表示されます。レポートをカスタマイズするには、ページ上部にある検索バーを使用します。詳細は、「検索バーについて」を参照してください。

「静的アプリケーション・ファイル」レポートに、ファイル名、MIMEタイプ、ファイル・サイズ、ダウンロード・リンクおよび置換文字列構文が表示されます。

4. 追加の詳細を表示するには、「編集」アイコンをクリックします。ファイルがイメージの場合は、イメージが表示されます。

5. ファイルを削除するには、「削除」をクリックします。

6. 終了するには、「取消」をクリックします。

18.3.4 静的アプリケーション・ファイルの参照について

静的アプリケーション・ファイルは、現在選択されているアプリケーションでのみ使用可能です。アプリケーションの静的アプリケーション・ファイルは、#APP_IMAGES#置換文字列を使用して参照できます。アップロードしたイメージのサンプル構文を表示するには、「静的アプリケーション・ファイル」レポートの「参照」列を参照します。

関連項目:
「「静的アプリケーション・ファイル」レポートの表示」、「置換文字列の使用について」、「APP_IMAGES」および「アプリケーション・ロゴの定義」

18.3.5 静的アプリケーション・ファイルのダウンロード

この項では、静的アプリケーション・ファイルをダウンロードする方法について説明します。

- 静的アプリケーション・ファイルのダウンロード

- すべての静的アプリケーション・ファイルのZipでのダウンロード

18.3.5.1 静的アプリケーション・ファイルのダウンロード

アップロードした静的アプリケーション・ファイルをダウンロードするには、次のステップを実行します。

1. 共有コンポーネント・ページにナビゲートします。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。
共有コンポーネント・ページが表示されます。

2. 「ファイル」で、「静的アプリケーション・ファイル」を選択します。
静的アプリケーション・ファイル・ページが表示されます。

3. まだ選択していない場合は、「レポートの表示」アイコンをクリックします。
レポートが表示されます。

4. ダウンロードするファイルを探し、「ダウンロード」リンクをクリックします。

18.3.5.2 すべての静的アプリケーション・ファイルのZipでのダウンロード

すべての静的アプリケーション・ファイルをZipでダウンロードするには、次のステップを実行します。

1. 共有コンポーネント・ページにナビゲートします。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。
共有コンポーネント・ページが表示されます。

2. 「ファイル」で、「静的アプリケーション・ファイル」を選択します。
静的アプリケーション・ファイル・ページが表示されます。

3. 「Zipとしてダウンロード」をクリックします。

18.3.6 静的アプリケーション・ファイルの削除

この項では、アップロードした静的アプリケーション・ファイルを削除する方法について説明します。

- 静的アプリケーション・ファイルの削除

- すべての静的アプリケーション・ファイルの削除

18.3.6.1 静的アプリケーション・ファイルの削除

アップロードした静的アプリケーション・ファイルを削除するには、次のステップを実行します。

1. 共有コンポーネント・ページにナビゲートします。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。
共有コンポーネント・ページが表示されます。

2. 「ファイル」で、「静的アプリケーション・ファイル」を選択します。
静的アプリケーション・ファイル・ページが表示されます。

3. まだ選択していない場合は、「レポートの表示」アイコンをクリックします。
レポートが表示されます。レポートをカスタマイズするには、ページ上部にある検索バーを使用します。詳細は、「検索バーについて」を参照してください。

4. 削除するファイルを選択します。

5. 編集ページで、「削除」をクリックします。

18.3.6.2 すべての静的アプリケーション・ファイルの削除

アップロードしたすべての静的アプリケーション・ファイルを削除するには、次のステップを実行します。

1. 共有コンポーネント・ページにナビゲートします。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。
共有コンポーネント・ページが表示されます。

2. 「ファイル」で、「静的アプリケーション・ファイル」を選択します。
静的アプリケーション・ファイル・ページが表示されます。

3. 「すべてのファイルの削除」をクリックします。

18.4 静的ワークスペース・ファイルの管理

この項では、静的ワークスペース・ファイル(イメージ、CSSファイルおよび個別に管理する必要があるその他のファイルを含む)をアップロード、表示、ダウンロードおよび削除する方法について説明します。

- 静的ワークスペース・ファイルのアップロード

- 「静的ワークスペース・ファイル」レポートの表示

- 静的ワークスペース・ファイルの参照について

- 静的ワークスペース・ファイルのダウンロード

- 静的ワークスペース・ファイルの削除

関連項目:
「静的アプリケーション・ファイルの管理」および「イメージの管理について」

18.4.1 静的ワークスペース・ファイルのアップロード

静的ワークスペース・ファイルをアップロードするには、次のステップを実行します。

1. 共有コンポーネント・ページにナビゲートします。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。
共有コンポーネント・ページが表示されます。

2. 「ファイル」で、「静的ワークスペース・ファイル」を選択します。
静的ワークスペース・ファイル・ページが表示されます。

3. ファイルをアップロードするには、「ファイルのアップロード」をクリックします。

4. 「アップロード」で、次のステップを実行します。

1. ディレクトリ - ファイルの格納先ディレクトリの名前を入力します。ディレクトリを指定しない場合、ファイルはルート・ディレクトリに格納されます。

2. ファイル - アプリケーションに追加するファイルの場所を入力します。

3. ファイルの文字セット - アップロードするファイルの文字セット・エンコーディングを指定します。この属性は、テキスト・ファイルにのみ適用されます。

4. ファイルの解凍 - 「はい」の場合、アップロードしたZipファイルは自動的に解凍され、指定したディレクトリに格納されます。実際のZipファイルが格納されるわけではないことに注意してください。アップロードしたファイルがZipファイルでない場合、この属性は無視されます

5. 「アップロード」または「アップロードと別のアップロード」をクリックします。

18.4.2 「静的ワークスペース・ファイル」レポートの表示

「静的ワークスペース・ファイル」レポートを表示するには、次のステップを実行します。

1. 共有コンポーネント・ページにナビゲートします。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。
共有コンポーネント・ページが表示されます。

2. 「ファイル」で、「静的ワークスペース・ファイル」を選択します。
静的ワークスペース・ファイル・ページが表示されます。レポートをカスタマイズするには、ページ上部にある検索バーを使用します。詳細は、「検索バーについて」を参照してください。

3. まだ選択していない場合は、「レポートの表示」アイコンをクリックします。
「静的アプリケーション・ファイル」レポートに、ファイル名、MIMEタイプ、ファイル・サイズ、ダウンロード・リンクおよび置換文字列構文が表示されます。

4. 追加の詳細情報を表示するには、ファイルを選択します。ファイルがイメージの場合は、イメージが表示されます。

5. ファイルを削除するには、「削除」をクリックします。

6. 終了するには、「取消」をクリックします。

18.4.3 静的ワークスペース・ファイルの参照について

現在のワークスペース内のすべてのアプリケーションの静的ワークスペース・ファイルを参照できます。アプリケーションの静的ワークスペース・ファイルは、#WORKSPACE_IMAGES#置換文字列を使用して参照できます。アップロードしたイメージのサンプル構文を表示するには、「静的ワークスペース・ファイル」レポートの「参照」列を参照します。

関連項目:
「「静的ワークスペース・ファイル」レポートの表示」、「組込み置換文字列の使用」、「WORKSPACE_IMAGES」および「アプリケーション・ロゴの定義」

18.4.4 静的ワークスペース・ファイルのダウンロード

この項では、静的ワークスペース・ファイルをダウンロードする方法について説明します。

- 静的アプリケーション・ファイルのダウンロード

- すべての静的アプリケーション・ファイルのZipでのダウンロード

18.4.4.1 静的ワークスペース・ファイルのダウンロード

アップロードした静的ワークスペース・ファイルをダウンロードするには、次のステップを実行します。

1. 共有コンポーネント・ページにナビゲートします。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。
共有コンポーネント・ページが表示されます。

2. 「ファイル」で、「静的ワークスペース・ファイル」を選択します。
静的ワークスペース・ファイル・ページが表示されます。

3. まだ選択していない場合は、「レポートの表示」アイコンをクリックします。
レポートが表示されます。

4. ダウンロードするファイルを探し、「ダウンロード」リンクをクリックします。

18.4.4.2 すべての静的ワークスペース・ファイルのZipでのダウンロード

すべての静的ワークスペース・ファイルをZipでダウンロードするには、次のステップを実行します。

1. 共有コンポーネント・ページにナビゲートします。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。
共有コンポーネント・ページが表示されます。

2. 「ファイル」で、「静的ワークスペース・ファイル」を選択します。
静的アプリケーション・ファイル・ページが表示されます。

3. 「Zipとしてダウンロード」をクリックします。

18.4.5 静的ワークスペース・ファイルの削除

この項では、アップロードした静的ワークスペース・ファイルを削除する方法について説明します。

- 静的ワークスペース・ファイルの削除

- すべての静的ワークスペース・ファイルの削除

18.4.5.1 静的ワークスペース・ファイルの削除

アップロードした静的ワークスペース・ファイルを削除するには、次のステップを実行します。

1. 共有コンポーネント・ページにナビゲートします。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。
共有コンポーネント・ページが表示されます。

2. 「ファイル」で、「静的ワークスペース・ファイル」を選択します。
静的ワークスペース・ファイル・ページが表示されます。

3. まだ選択していない場合は、「レポートの表示」アイコンをクリックします。
レポートが表示されます。レポートをカスタマイズするには、ページ上部にある検索バーを使用します。詳細は、「検索バーについて」を参照してください。

4. 削除するファイルを選択します。

5. 編集ページで、「削除」をクリックします。

18.4.5.2 すべての静的ワークスペース・ファイルの削除

アップロードしたすべての静的ワークスペース・ファイルを削除するには、次のステップを実行します。

1. 共有コンポーネント・ページにナビゲートします。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。
共有コンポーネント・ページが表示されます。

2. 「ファイル」で、「静的ワークスペース・ファイル」を選択します。
静的ワークスペース・ファイル・ページが表示されます。

3. 「すべてのファイルの削除」をクリックします。

18.5 アプリケーション・レベル・アイテムの管理

アプリケーション・レベル・アイテムは表示されませんが、アプリケーションのグローバル変数として使用されます。アプリケーション・アイテムは、グローバル変数として使用できます。

- アプリケーション・レベル・アイテムの作成

- アプリケーション・アイテムの使用状況の表示

- アプリケーション・レベル・アイテム属性の編集

- グローバル変数として機能するアプリケーション・レベル・アイテムの作成について

関連項目:
「ページ・アイテムとアプリケーション・アイテムの違い」および「アイテム値の参照」

18.5.1 アプリケーション・レベル・アイテムの作成

アプリケーション・レベル・アイテムを作成するには、次のステップを実行します。

1. 共有コンポーネント・ページにナビゲートします。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。
共有コンポーネント・ページが表示されます。

2. 「アプリケーション・ロジック」で、「アプリケーション・アイテム」を選択します。
アプリケーション・アイテム・ページが表示されます。

3. アプリケーション・アイテムを作成するには、「作成」をクリックします。
作成/編集ページが表示されます。

4. 「名前」で、次のステップを実行します。

1. 名前: アプリケーション・レベル・アイテムの名前を入力します。

2. 有効範囲: 次のオプションがあります。

- グローバル: アプリケーションが同じワークスペース内の他のアプリケーションとセッション・ステートを共有する場合は、このオプションを選択します。詳細は、「グローバル変数として機能するアプリケーション・レベル・アイテムの作成について」を参照してください。

- アプリケーション: アプリケーションが別のアプリケーションとセッション・ステートを共有する場合は、このオプションを選択します。

5. 「セキュリティ」の「データ型」で、このアイテムのデータ型を選択します。

6. 「セキュリティ」の「セッション・ステート保護」で、このアイテムのセッション・ステート保護を選択します。オプションは次のとおりです。

- 制限なし: URLまたはフォームでアイテム名/値を渡して、アイテムのセッション・ステートを設定できます。URLにチェックサムは必要ありません。
注意: Ajaxを使用してこのアイテムの値をセッション・ステートに設定する必要がある場合は、アイテムに対して「制限なし」保護レベルを使用する必要があります(たとえば「動的アクション」の場合は、「値の設定」、「送信するページ・アイテム」または「カスケードLOV」、「送信するページ・アイテム」)。

- 制限付き - ブラウザから設定できない: URLまたはPOSTDATAを使用してアイテムを変更できません。アイテムの値を内部プロセス、計算などに設定できる方法を制限する場合は、このオプションを使用します。この属性は、データ・エントリ・アイテムとして使用できないアイテムのみに適用され、セッション・ステート保護が無効になっていても常に監視されます。次の表示形式タイプのアプリケーション・アイテムについては、この属性を使用します。

- 表示のみ(状態の保存=なし)

- 表示のみ(状態の保存=なし)

- グリッド・レイアウドの停止と開始(ラベルのみ表示)

- チェックサムが必要 - アプリケーション・レベル: スキーマ固有のチェックサムを入力する場合は、URLでアイテムの名前/値を渡して、アイテムのセッション・ステートを設定できます。ユーザー・レベル・チェックサムまたはセッション・レベル・チェックサムも使用できます(次の項目を参照)。現行のワークスペースの別のセッションで同じアプリケーションを実行しているユーザーが生成したチェックサムを含むURLによってのみ、このアイテムを設定できるようにする場合に、このオプションを使用します。

- チェックサムが必要: ユーザー・レベル: ワークスペース、アプリケーションおよびユーザー固有のチェックサムを入力する場合は、URLでアイテムの名前/値を渡して、アイテムのセッション・ステートを設定できます。セッション・レベル・チェックサムも使用できます(次の項目を参照)。現行のワークスペースの別のセッションで同じアプリケーションを実行しているユーザーが生成したチェックサムを含むURLによってのみ、このアイテムを設定できるようにする場合に、このオプションを使用します。

- チェックサムが必要: セッション・レベル: カレント・セッション固有のチェックサムを入力する場合は、URLでアイテムの名前/値を渡して、アイテムのセッション・ステートを設定できます。カレント・セッションで生成されたチェックサムを含むURLによってのみ、このアイテムを設定できるようにする場合に、このオプションを使用します。

7. 「構成」の「ビルド・オプション」で、このコンポーネントのビルド・オプションを選択します。ビルド・オプションは、アプリケーション内のコンポーネントが有効かどうかを判別する事前定義された設定です。

8. 「コメント」に、このアイテムに関するメモを入力します。

9. 「アプリケーション・アイテムの作成」をクリックします。

18.5.2 アプリケーション・アイテムの使用状況の表示

アプリケーション・アイテム・ページの上部にある「使用状況」タブをクリックして、アプリケーション・アイテムが使用されている場所のリストを表示できます。

使用状況レポートを表示するには、次のステップを実行します。

1. 共有コンポーネント・ページにナビゲートします。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。
共有コンポーネント・ページが表示されます。

2. 「アプリケーション・ロジック」で、「アプリケーション・アイテム」を選択します。
アプリケーション・アイテム・ページが表示されます。

3. ページ上部で「使用状況」をクリックします。

18.5.3 アプリケーション・レベル・アイテム属性の編集

作成したアプリケーション・レベル・アイテムは、アプリケーション・アイテムの作成/編集ページで編集できます。

アプリケーション・レベル・アイテム属性を編集するには、次のステップを実行します。

1. 共有コンポーネント・ページにナビゲートします。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。
共有コンポーネント・ページが表示されます。

2. 「アプリケーション・ロジック」で、「アプリケーション・アイテム」を選択します。
アプリケーション・アイテム・ページが表示されます。

3. アプリケーション・アイテムを選択します。
作成/編集ページが表示されます。

4. 属性を編集します。
属性の詳細は、フィールドレベル・ヘルプを参照してください。「フィールドレベル・ヘルプの表示」を参照してください。

5. 「変更の適用」をクリックします。

関連項目:
「クロスサイト・スクリプティング保護の理解」

18.5.4 グローバル変数として機能するアプリケーション・レベル・アイテムの作成について

大規模なアプリケーションは、通常、同じワークスペースに存在するいくつかの物理アプリケーションに分けられます。これらのアプリケーションは、通常、各アプリケーションで同じCookie名を構成することでセッション・ステートを共有します。

このタイプのアーキテクチャのもう1つの要件は、2、3のグローバル変数を共有する必要があることです。グローバル変数の数を少なく維持する必要がありますが、グローバル変数はアプリケーション間の通信を促進する効果的な手段として機能します。次に例を示します。

- カレント・ユーザーのプロパティ(電子メール・アドレス、従業員番号など)。

- マルチテナント・アプリケーションの現在の会社。

すべてのアプリケーション間で同じ名前を持つアプリケーション・レベル・アイテムを作成し、有効範囲をグローバルに設定することによって、グローバル変数を作成できます。

グローバル変数として機能するアプリケーション・レベル・アイテムを作成するには、次のステップを実行します。

1. セッション・ステートを共有する各アプリケーションで、同じ名前のアプリケーション・レベル・アイテムを作成します。

2. 「有効範囲」で、「グローバル」を選択します。

3. 「セキュリティ」の「セッション・ステート保護」で、制限付きを選択します。

関連項目:
「アプリケーション・レベル・アイテムの作成」

18.6 アプリケーション・レベルでのLOVの作成

この項では、値リストを作成する方法について説明します。

- 値リストとは

- アプリケーション・レベルでの名前付きのLOVの作成

- 静的LOVについて

- 既存のLOVの編集

- LOV内でのセッション・ステートの参照について

- LOVレポートへのアクセス

18.6.1 値リストとは

LOVは、ポップアップLOV、選択リスト、チェック・ボックス、ラジオ・グループ、複数の選択リストなどの、特定のタイプのページ・アイテムを表示するために使用される静的または動的な値のセットです。アプリケーション・レベルでLOVを作成することによって、共有コンポーネントを作成しています。共有コンポーネントとしてLOVを作成することには次のような利点があります。

- アプリケーション内のすべてのページに追加できます。

- すべてのLOV定義は1つの場所に格納されるため、検索と更新が簡単になります。

関連項目:
「ページ・レベル・アイテムの作成」および「共有コンポーネントでの作業」

18.6.2 アプリケーション・レベルでの名前付きのLOVの作成

アプリケーション・レベルで名前付き(共有) LOVを定義するには、「LOVの作成」ウィザードを実行して、これらのLOVをLOVリポジトリに追加します。すべてのLOVは、静的LOVまたは動的LOVとして定義できます。静的リストは、表示値と戻り値の事前定義された組合せに基づきます。動的リストは、表から値を選択するように作成したSQL問合せに基づきます。

名前付きLOVを作成するには、次のステップを実行します。

1. 共有コンポーネント・ページにナビゲートします。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。
共有コンポーネント・ページが表示されます。

2. 「他のコンポーネント」で、「LOV」を選択します。
LOVページが表示されます。

3. LOVを作成するには、「作成」をクリックします。

4. 画面に表示されるステップに従います。
新しい名前付きのLOVがLOVリポジトリに追加されます。LOVをページに追加するには、適切なアイテムまたは列を編集して、名前付きのLOVを選択する必要があります。

18.6.3 静的LOVについて

静的LOVは、LOVの作成ウィザードの実行時に指定する表示値と戻り値の静的リストに基づきます。静的LOVを作成するには、LOVの作成ウィザードを実行して、LOVタイプに「静的」を選択します。Oracle Application Expressによって、指定した表示値、戻り値およびソート順序がLOVリポジトリに格納されます。リポジトリに静的LOVを追加すると、アイテムを作成し、この定義に基づいてチェック・ボックス、ラジオ・グループ、選択リストまたはポップアップ・リストとしてアイテムを表示できます。

18.6.4 既存のLOVの編集

既存のLOVを編集するには、「LOV」ページでLOVを選択します。

- LOVの編集

- LOVのバルク編集

18.6.4.1 LOVの編集

LOVを編集するには、次のステップを実行します。

1. 共有コンポーネント・ページにナビゲートします。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。
共有コンポーネント・ページが表示されます。

2. 「他のコンポーネント」で、「LOV」を選択します。
LOVページが表示されます。

3. LOVを選択します。
編集ページが表示されます。

4. 属性を編集します。
属性の詳細は、フィールドレベル・ヘルプを参照してください。「フィールドレベル・ヘルプの表示」を参照してください。

5. 「変更の適用」をクリックします。

18.6.4.2 LOVのバルク編集

「LOVの編集」ページで「グリッド編集」ボタンをクリックすることによって、すべての静的LOVの表示値を編集できます。

静的LOVのバルク編集を実行するには、次のステップを実行します。

1. 共有コンポーネント・ページにナビゲートします。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。
共有コンポーネント・ページが表示されます。

2. 「他のコンポーネント」で、「LOV」を選択します。
デフォルトでは、LOVはアイコンとして表示されます。

3. 「グリッド編集」タブをクリックします。

4. 表示テキストを編集し、「変更の適用」をクリックします。

18.6.5 LOV内でのセッション・ステートの参照について

バインド変数を使用することでセッション・ステートを参照できます。セッション・ステートを参照するとLOVは再利用性が多少低下しますが、開発手法として推奨されています。次の例では、このLOVはmy_deptnoというアイテムに有効な部門番号が含まれている場合のみ機能します。

SELECT ename, empno FROM emp WHERE deptno = :P1_DEPTNO

18.6.6 LOVレポートへのアクセス

LOVレポートへのアクセス

1. 共有コンポーネント・ページにナビゲートします。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。
共有コンポーネント・ページが表示されます。

2. 「他のコンポーネント」で、「LOV」を選択します。
デフォルトでは、LOVはアイコンとして表示されます。

3. ページ上部の次のいずれかのタブを選択します。

- NULLテキストの編集 - アプリケーション内のすべてのLOVのNULLテキストを編集します。

- ローカルに定義 - アイテムの定義でローカルに定義されているすべてのLOVが表示されます。複数のページで使用可能なLOVは、共有LOVに変換できます。ローカルに定義されたLOVを共有LOVに変換すると、再利用が促進されます。

- グリッド編集 - すべての静的LOVの表示値を編集できます。

- 条件付きエントリ - 条件付きで表示されるすべてのLOVが表示されます。

- サブスクリプション - アプリケーションに存在するサブスクライブされたLOVがすべて表示されます。

- 使用状況 - アプリケーション内でLOVが使用されている場所が表示されます

- 履歴 - 最近変更されたLOVの履歴が日付ごとに表示されます

4. 画面に表示されるステップに従います。

18.7 リストの作成

この項では、リンク(またはリスト)の共有コレクションをデータベース・アプリケーションに追加する方法について説明します。リージョンを作成してリージョン・タイプを「リスト」に指定することによって、リストをページに追加します。リストの外観は、リスト・テンプレートで制御します。

- リストの作成について

- ナビゲーション・メニューについて

- 静的リストの作成

- 動的リストの作成

- リストのコピー

- ページへのリストの追加

- リスト属性の編集

- リスト・レポートへのアクセス

関連項目:
s

18.7.1 リストの作成について

Oracle Application Expressでは、次の2つのタイプのリストをサポートしています。

- 静的リスト - 静的リストを作成する場合、リスト・エントリ・ラベルおよびターゲット(ページまたはURLのいずれか)を定義します。既存のエントリをコピーするかリスト・エントリを追加することによって、リストを作成(最初から作成)するときにリスト・エントリを追加できます。表示条件を定義することにより、リスト・エントリを表示するタイミングを制御できます。

- 動的リスト - 動的リストは、SQL問合せまたは実行時に実行されるPL/SQLファンクションに基づいています。動的リストを使用すると、jQuery Mobileなどのモバイル・フレームワークをサポートするスタイル・リスト・アイテムを動的に作成できます。

リスト定義には、特定のタイプのページ・アイテム(進捗バー、サイドバー、箇条書きナビゲーション・リスト、ナビゲーション・メニューなど)が表示されます。テンプレートによってリストの表示方法を制御できます。

関連項目:
「静的リストの作成」、「動的リストの作成」、「動的リスト構文の理解」、「新しいテンプレートの作成」および「リスト・テンプレート」

18.7.2 ナビゲーション・メニューについて

古いテーマでは、タブの作成によるナビゲーション・サポートが提供されています。ユニバーサル・テーマ - 42などの新しいテーマでは、ナビゲーション・メニューの作成によるナビゲーション・サポートが提供されます。使用しているテーマがナビゲーション・メニューをサポートしている場合、アプリケーションの作成ウィザードを実行すると自動的にナビゲーション・メニューが作成されます。サンプル・データベース・アプリケーションには、サイドバーに表示されるナビゲーション・メニューが含まれています。

ナビゲーション・メニューは、階層型サブメニューの作成をサポートしています。ページ上部のタブまたは(前述の例に示すように)サイド・バーのいずれかとして、ナビゲーション・メニューをレンダリングできます。サイド・バーとして表示されるナビゲーション・メニューは、反応性があります。使用可能な領域に基づいて、ナビゲーション・バーは完全なメニューを表示するか、または幅の狭いアイコン・バーに縮小されます。サイド・ナビゲーション・メニューは、テーマおよびユーザー・インタフェース・レベルによって制御されます。

代替リスト・テンプレートを選択するか、「ユーザー・インタフェースの詳細」を編集してナビゲーション・メニューの位置を変更することができます。テーマを編集することで、使用可能なナビゲーション・メニュー・リスト・テンプレートを構成できます。

関連項目:
「アプリケーションのユーザー・インタフェースの管理」および「テーマの編集」

タブからナビゲーション・メニューへの切替えについて

1レベルのタブを使用する既存のアプリケーションが使用されていた場合、開発者はタブを使用するテーマからナビゲーション・メニューを使用するテーマに切り替えることができます。既存のアプリケーションが2レベルのタブを使用している場合、テーマを変更する前に1レベルに変換する必要があります。

18.7.3 静的リストの作成

この項では、静的リストの作成について説明します。

- 静的リストの作成プロセスについて

- リストを最初から作成

- 静的リストへのエントリとサブリストの追加について

- エントリまたはサブリストを最初から追加

- リスト間での静的リスト・エントリのコピー

- 静的リスト・エントリの親の変更

- 孤立した静的リスト・エントリの管理

- 静的リスト・エントリの順序変更

18.7.3.1 静的リストの作成プロセスについて

静的リストの作成プロセスでは、次のステップを実行します。

- ステップ1: リストの作成ウィザードを実行して、リストを作成します。

- ステップ2: 最初からリストを作成するか既存リストをコピーするかを指定します。
エントリを最初から作成するか、または既存リストからエントリをコピーすることによって、リスト・エントリを追加できます。リスト全体をコピーすると、すべてのリスト・エントリもコピーされます。

- ステップ3: 最初からリストを作成する場合は、リスト・タイプを選択するプロンプトが表示されます。「静的」を選択します。
各リスト要素には、いつ表示するかを制御できる表示条件があります。特定のページのカレントまたは非カレントとしてリスト要素を定義できます。

- ステップ4: リスト・リージョンを作成して、ページにリストを追加します。

これらのステップは必要に応じて実行します。リストの作成ウィザードを実行するときに最初の3つのステップを実行できます。または、これらのステップを一度に1つ実行することもできます。

関連項目:
「ページへのリストの追加」、「リスト属性の編集」および「リスト・レポートへのアクセス」

18.7.3.2 静的リストを最初から作成

リストを最初から作成するには、次のステップを実行します。

1. リストの作成/編集ウィザードへのアクセス

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

4. 「ナビゲーション」で、「リスト」をクリックします。

5. 「作成」をクリックします。

2. 「ソース」で「最初から」を選択し、「次へ」をクリックします。

3. 「名前およびタイプ」で、次のステップを実行します。

1. 名前: 数字または英数字のリスト名を入力します。

2. タイプ: 「静的」を選択します。

3. ビルド・オプション: このコンポーネントのビルド・オプションを選択します(使用可能な場合)。ビルド・オプションは、アプリケーション内のコンポーネントが有効かどうかを判別する事前定義された設定です。

4. 「次へ」をクリックします。

4. 「リスト・エントリの定義」で、次のように指定します。

1. リスト・エントリ・ラベル: 数字または英数字のリスト名を入力します。

2. ターゲット・ページIDまたはカスタムURL: ターゲット・ページを選択するか、またはカスタムURLを入力します。

3. 「次へ」をクリックします。

5. 「確認」で、次のように指定します。

1. リスト・リージョンを作成しますか。: リスト・リージョンを作成するかどうかを選択します。オプションは次のとおりです。

- リスト・リージョンを作成しない

- カレント・ページにリスト・リージョンを作成する

- 各ターゲット・ページのリスト・リージョンを作成する

2. リージョン位置: 新しいリージョンを作成する場合は、リージョン位置を選択します。

3. リージョン・テンプレート: 新しいリージョンを作成する場合は、リージョン・テンプレートを選択します。

4. リスト・テンプレート: リストの外観の制御に使用するリスト・テンプレートを選択します。

5. 「リストの作成」をクリックします。

18.7.3.3 静的リストへのエントリとサブリストの追加について

リストの作成後、リストにエントリを追加する必要があります。リストを最初から作成するか、リスト・エントリをリスト内からコピーするか、または既存のエントリをあるリストから別のリストにコピーすると、リスト・エントリを追加できます。

サブリストを含む階層的なリストも作成できます。階層的なリストを作成するには、次のステップを実行します。

- 階層的なリストをサポートするリスト・テンプレートを選択します。階層的なリストをサポートするリスト・テンプレートを判別するには、サブリスト付きというネーミング規則のあるテンプレートを検索します。

- 各リスト・エントリの作成時には親リスト・アイテムを選択します。

関連項目:
「カスタム・テーマの作成」および「リスト・テンプレート」

18.7.3.4 エントリまたはサブリストを最初から追加

エントリまたはサブリストを最初から追加するには、次のステップを実行します。

1. リスト・ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

4. 「ナビゲーション」で、「リスト」を選択します。
リスト・ページが表示されます。

2. リストを選択します。
リスト詳細ページが表示されます。

3. 「リスト・エントリの作成」をクリックします。

4. 「エントリ」で、次の項目を指定します。

1. 親リスト・エントリ: 該当する場合、このリスト・エントリの親を選択します。サブリストを含む階層的なリストを作成する場合は、この属性を使用します。
この属性は、親リスト・エントリを作成する場合は表示されません。

2. 順序: リストにおけるリスト・エントリの表示順序を指定します。これによって評価の順序が決まります。

3. イメージ: このリスト・エントリの表示に使用するイメージのファイル名を指定します。この属性の制御はリスト・テンプレートによって行われます。

4. 属性: リスト要素イメージのイメージ属性(width="12" height="12"など)を指定します。
リスト・ラベル・テキストを参照するには、#LIST_LABEL#置換文字列を使用します。この置換文字列を使用すると、リスト・ラベル・テキストの値に基づいてタイトル・イメージ属性を自動的に設定できます。次に例を示します。

title="#LIST_LABEL#"

5. Alt属性: リスト要素イメージのイメージalt属性を指定します。
リスト・ラベル・テキストを参照するには、#LIST_LABEL#置換文字列を使用します。この置換文字列を使用すると、リスト・ラベル・テキストの値に基づいてAlt属性を自動的に設定できます。次に例を示します。

...alt="#LIST_LABEL#"...

6. リスト・エントリ・ラベル: このリンクのラベル・テキストを入力します。

5. ターゲット・タイプを指定します。オプション: 「URL」または「このアプリケーションのページ」。
ターゲット位置がURLの場合、次のように指定します。

1. ターゲット・タイプ: 「URL」を選択します。

2. URLターゲット: URLを入力します。次に例を示します。

http://www.yahoo.com

ターゲット位置がページの場合、次のステップを実行します。

1. ターゲット・タイプ: 「このアプリケーションのページ」を選択します。

2. ページ: ターゲット・ページ番号を指定します。
他のオプションは次のとおりです。

- このページのページ区切りをリセット: ユーザーの新規問合せに合うデータの最初のセットにページを戻すには、このオプションを選択します。

- 印刷用: このオプションを選択すると、アプリケーションの「印刷用」テンプレートを使用するターゲット・ページが表示されます。「印刷用」テンプレートにより、印刷用ページが最適化されます。「テーマの編集」および「印刷用ページの最適化」を参照してください。

3. リクエスト: 組込みアプリケーション・アイテムREQUESTを設定するテキストを入力します。これは、クリックしたボタンの名前で設定されるアイテムでもあります。

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. リスト属性の定義の終了後、「作成」または「作成後、別のものの作成」をクリックします。

18.7.3.5 リスト間での静的リスト・エントリのコピー

あるリストから別のリストに静的リスト・エントリをコピーできます。

リスト間でリスト・エントリをコピーするには、次のステップを実行します。

1. リスト・ページにナビゲートします。

1. 「ワークスペース」ホームページにナビゲートします。

2. 「アプリケーション・ビルダー」アイコンをクリックします。

3. アプリケーションを選択します。

4. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

5. 「ナビゲーション」で、「リスト」をクリックします。
リスト・ページが表示されます。

2. コピーするリストを選択します。

3. 「タスク」リストで、「あるリストから別のリストへのリスト・エントリのコピー」をクリックします。

4. 「リスト・エントリのコピー」で、コピー先のリストを選択し、「次へ」をクリックします。

5. 「リスト・エントリのコピー」をクリックします。

18.7.3.6 静的リスト・エントリの親の変更

リスト・エントリの親の変更ページは、リスト・エントリ階層を管理するために使用します。

リスト・エントリの親を変更するには、次のステップを実行します。

1. リスト・ページにナビゲートします。

1. 「ワークスペース」ホームページにナビゲートします。

2. 「アプリケーション・ビルダー」アイコンをクリックします。

3. アプリケーションを選択します。

4. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

5. 「ナビゲーション」で、「リスト」をクリックします。
リスト・ページが表示されます。

2. リストを選択します。

3. 「タスク」リストで、「このリスト内におけるリスト・エントリの親の変更」をクリックします。

4. 表示を階層のサブセットに制限するには、「開始」を使用します。選択して「実行」をクリックします。

5. 「親の変更先」で新しい親を選択します。

6. 移動するエントリを選択します。

7. 「チェックしたエントリの親の変更」をクリックします。

18.7.3.7 孤立した静的リスト・エントリの管理

孤立リスト・エントリとは、親が現在のリストのメンバーではないリスト・エントリです。リスト・エントリが孤立している場合は、親のエントリを削除します。

孤立リスト・エントリを管理するには、次のステップを実行します。

1. リスト・ページにナビゲートします。

1. 「ワークスペース」ホームページにナビゲートします。

2. 「アプリケーション・ビルダー」アイコンをクリックします。

3. アプリケーションを選択します。

4. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

5. 「ナビゲーション」で、「リスト」をクリックします。
リスト・ページが表示されます。

2. リストを選択します。

3. 「タスク」リストで、「孤立リスト・エントリの管理」をクリックします。

4. 削除するエントリを選択します。

5. 「親エントリのクリア」をクリックします。

18.7.3.8 静的リスト・エントリの順序変更

クリーンアップ・ページで、リスト・エントリの順序を10単位で変更できます。

リスト・エントリをクリーンアップするには、次のステップを実行します。

1. リスト・ページにナビゲートします。

1. 「ワークスペース」ホームページにナビゲートします。

2. 「アプリケーション・ビルダー」アイコンをクリックします。

3. アプリケーションを選択します。

4. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

5. 「ナビゲーション」で、「リスト」をクリックします。
リスト・ページが表示されます。

2. リストを選択します。

3. 「タスク」リストで、「リストのエントリのクリーンアップ」をクリックします。

4. 「クリーンアップ」をクリックします。

18.7.4 動的リストの作成

この項では、動的リストの作成について説明します。

- 動的リストの作成プロセスについて

- 動的リスト構文の理解

- 動的リストを最初から作成

18.7.4.1 動的リストの作成プロセスについて

動的リストを使用すると、jQuery Mobileなどのモバイル・フレームワークをサポートするスタイル・リスト・アイテムを動的に作成できます。動的リストは、SQL問合せまたはSQL問合せを戻すPL/SQLファンクションに基づいています。

動的リストの作成プロセスでは、次のステップを実行します。

- ステップ1: リストの作成ウィザードを実行して、リストを作成します。

- ステップ2: 最初からリストを作成するか既存リストをコピーするかを指定します。

- ステップ3: 最初からリストを作成する場合は、リスト・タイプを選択するプロンプトが表示されます。「動的」を選択します。

- ステップ4: SQL問合せまたはSQL問合せを戻すPL/SQLファンクションを入力します。

- ステップ5: リスト・リージョンを作成して、ページにリストを追加します。

関連項目:
「ページへのリストの追加」、「リスト属性の編集」および「リスト・レポートへのアクセス」

18.7.4.2 動的リスト構文の理解

SQL問合せまたはSQL問合せを戻すファンクションを使用して、動的リストを作成します。

SQL問合せの構文は、次のとおりです。

SELECT level, labelValue label,
[targetValue]            target,
[is_current]             is_current_list_entry,
[imageValue]             image,
[imageAttributeValue]    image_attribute,
[imageAltValue]          image_alt_attribute,
[attribute1]             attribute1,
[attribute2]             attribute2,
[attribute3]             attribute3,
[attribute4]             attribute4,
[attribute5]             attribute5,
[attribute6]             attribute6,
[attribute7]             attribute7,
[attribute8]             attribute8,
[attribute9]             attribute9,
[attribute10]            attribute10
FROM ...
WHERE ...
ORDER BY ...

SQL問合せを戻すファンクションの構文は、次のとおりです。

RETURN
'SELECT level, labelValue label,'||
'       [targetValue]         target,'||
'       [is_current]          is_current_list_entry,'||
'       [imageValue]          image,'||
'       [imageAttributeValue] image_attribute, '||
'       [imageAltValue]       image_alt_attribute,'||
'       [attribute1]          attribute1,'||
'       [attribute2]          attribute2,'||
'       [attribute3]          attribute3,'||
'       [attribute4]          attribute4,'||
'       [attribute5]          attribute5,'||
'       [attribute6]          attribute6,'||
'       [attribute7]          attribute7,'||
'       [attribute8]          attribute8,'||
'       [attribute9]          attribute9,'||
'       [attribute10]         attribute10'||
'FROM ...'||
'WHERE ...'||
'ORDER BY ...';

説明:

- levelおよびlabelvalueが必要です。

- level: 階層リストで、levelパラメータを指定する必要があります。階層リスト以外では、このパラメータをNULLに設定できます。

- labelvalue: リスト・エントリとして表示されるテキスト。

- targetvalue: リスト・エントリの選択時にブランチ先となるターゲットURL。

- is_current: リスト・エントリの動作を制御します。値は次のとおりです。

- NULL: ターゲットの現行性はターゲットURLに基づきます。

- 'YES': リスト・エントリが常にカレントです。

- 'NO': リスト・エントリがカレントではありません。

- imagevalue: リスト・エントリに表示されるイメージ名。

- imageattributevalue: 幅や高さなどのイメージの属性。

- imagealtvalue: ユーザーがイメージ上でクリックする必要のあるテンプレートでアクセシビリティに必要なイメージALTタグの値。

- attribute1から10: これらの属性は、静的リスト・エントリページで公開される既存の10のユーザー属性と一致します。

18.7.4.3 動的リストを最初から作成

動的リストを作成するには、次のステップを実行します。

1. リストの作成/編集ウィザードへのアクセス

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

4. 「ナビゲーション」で、「リスト」をクリックします。

5. 「作成」をクリックします。

2. 「最初から」をクリックし、「次へ」をクリックします。

3. 「名前およびタイプ」で、次のステップを実行します。

1. 名前: 数字または英数字のリスト名を入力します。

2. タイプ: 「動的」を選択します。

3. ビルド・オプション: このコンポーネントのビルド・オプションを選択します(使用可能な場合)。ビルド・オプションは、アプリケーション内のコンポーネントが有効かどうかを判別する事前定義された設定です。

4. 「次へ」をクリックします。

4. 「問合せまたは静的値」で、次のステップを実行します。

1. 問合せソース・タイプ: 「SQL問合せ」または「SQL問合せを戻すファンクション」を選択します。

2. 問合せ: SQL問合せまたはSQL問合せを戻すファンクションを入力します。SQL問合せの例を表示するには、「例」リージョンを展開します。

関連項目:
「動的リスト構文の理解」

3. 問合せの作成: 「問合せの作成」をクリックし、ウィザードを使用して選択した表またはビューで問合せを作成します。画面に表示されるステップに従います。

4. 「次へ」をクリックします。

5. 「リストの作成」で、リスト・リージョンを作成するかどうかを指定します。

1. カレント・ページで「リストの作成」リージョンを選択すると、次の属性が表示されます。

- リージョン位置: 新しいリージョンを作成する場合は、リージョン位置を選択します。

- リージョン・テンプレート: 新しいリージョンを作成する場合は、リージョン・テンプレートを選択します。

- リスト・テンプレート: 新しいリージョンを作成する場合は、リスト・テンプレートを選択します。

2. リージョン位置: 新しいリージョンを作成する場合は、リージョン位置を選択します。

3. リージョン・テンプレート: 新しいリージョンを作成する場合は、リージョン・テンプレートを選択します。

4. 「作成」をクリックします。

18.7.5 リストのコピー

この項では、リストのコピー方法について説明します。別のアプリケーションまたは既存のアプリケーションからリストをコピーできます。

- カレント・アプリケーションからのリストのコピー

- アプリケーション間でのリストのコピー

18.7.5.1 カレント・アプリケーションからのリストのコピー

あるリストから別のリストにリスト・エントリをコピーできます。

リスト間でリスト・エントリをコピーするには、次のステップを実行します。

1. リスト・ページにナビゲートします。

1. 「ワークスペース」ホームページにナビゲートします。

2. 「アプリケーション・ビルダー」アイコンをクリックします。

3. アプリケーションを選択します。

4. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

5. 「ナビゲーション」で、「リスト」をクリックします。
リスト・ページが表示されます。

2. コピーするリストを選択します。

3. 「タスク」リストで、「リストのコピー」をクリックします。

4. 「リストをコピー」で、「このアプリケーションのリスト」を選択し、「次へ」をクリックします。

5. 「リストを指定」で、次のステップを実行します。

1. リストのコピー: コピーするリストを選択します。

2. 新しいリスト名: コピーされたリストに新しい名前を入力します。

3. 「コピー」をクリックします。

18.7.5.2 アプリケーション間でのリストのコピー

カレント・アプリケーションまたは別のアプリケーションからリストをコピーできます。

リストをコピーするには、次のステップを実行します。

1. リスト・ページにナビゲートします。

1. 「ワークスペース」ホームページにナビゲートします。

2. 「アプリケーション・ビルダー」アイコンをクリックします。

3. アプリケーションを選択します。

4. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

5. 「ナビゲーション」で、「リスト」をクリックします。
リスト・ページが表示されます。

2. コピーするリストを選択します。

3. 「タスク」リストで、「リストのコピー」をクリックします。

4. 「リストをコピー」で、「別のアプリケーションのリスト」を選択し、「次へ」をクリックします。

5. 「リストを指定」で、次のステップを実行します。

1. アプリケーションからコピー: リストのコピー元となるアプリケーションを選択します。

2. リストのコピー: コピーしているリストを選択します。

3. 新しいリスト名: 新しいリストの名前を入力します。

4. 「コピー」をクリックします。

18.7.6 ページへのリストの追加

リストとリスト・エントリの作成後、リージョンを作成してリージョン・タイプを「リスト」に指定することによって、このリストをページに追加します。

関連項目:
「ページ・デザイナでのリージョンの作成」

ページにリストを追加するには、次のステップを実行します。

1. 適切なページにナビゲートします。「コンポーネント・ビューでのページの表示」を参照してください。

2. 「リージョン」で、「作成」アイコンをクリックします。
「リージョンの作成」ウィザードが表示されます。

3. 「リージョン」で、リージョン・タイプとして「リスト」を選択し、「次へ」をクリックします。

4. 「表示属性」で、次のステップを実行します。

1. タイトル: リージョンのタイトルを入力します。選択するリージョン・テンプレートにリージョン・タイトルが表示されると、このタイトルが表示されます。

2. リージョン・テンプレート: リージョンの外観を制御するテンプレートを選択します。

3. 親リージョン: 新しいリージョンが属する親リージョンを定義します。

4. 表示ポイント: このリージョンの表示ポイントを指定します。

5. 順序: このコンポーネントの順序を指定します。これによって評価の順序が決まります。

6. 「次へ」をクリックします。

5. 「ソース」で、次のステップを実行します。

1. リスト: 追加するリストを選択します。

2. リスト・テンプレート: リストの外観を制御するテンプレートを選択します。

3. 「次へ」をクリックします。

6. 「条件付き表示」で、次のステップを実行します。

1. 条件タイプ: このコンポーネントがレンダリングされるために満たす必要があるリストから、条件タイプを選択します。「条件付きのレンダリングおよびプロセスの理解」を参照してください。

2. 認可スキーム: オプションで認可スキームを選択します。このコンポーネントをレンダリングまたは処理するためには、この認可スキームがTRUEと評価される必要があります。「認可を介したセキュリティの提供」を参照してください。

3. 「リージョンの作成」をクリックします。

リストを追加する各ページに対して、これらのステップを実行します。

関連項目:
リスト表示の変更方法については、「新しいテンプレートの作成」および「リスト・テンプレート」を参照してください。

18.7.7 リスト属性の編集

作成したリストは、リスト・ページで編集できます。

リストを編集するには、次のステップを実行します。

1. リスト・ページにナビゲートします。

1. 「ワークスペース」ホームページにナビゲートします。

2. 「アプリケーション・ビルダー」アイコンをクリックします。

3. アプリケーションを選択します。

4. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

5. 「ナビゲーション」で、「リスト」をクリックします。
リスト・ページが表示されます。

2. リストを選択します。
リスト詳細ページが表示されます。

3. リスト名またはビルド・オプションを変更するには、「リストの編集」ボタンをクリックします。

4. リスト名またはビルド・オプションを変更するには、次のステップを実行します。

1. 「リストの編集」ボタンをクリックします。

2. 対象となる属性を編集します。

3. 「変更の適用」をクリックします。

5. リスト順序、リンク・テキスト、ターゲットまたはすべてのリスト・エントリの現在のステータスを編集するには、「グリッド編集」をクリックします。

1. リスト順序、リンク・テキスト、ターゲットまたはすべてのリスト・エントリの現在のステータスを編集するには、「グリッド編集」をクリックします。

2. 対象となる属性を編集します。

3. 「変更の適用」をクリックします。

18.7.8 リスト・レポートへのアクセス

リスト・ページ上部の該当するタブをクリックして、「未使用」、「条件付きエントリ」、「使用状況」および「履歴」レポートを表示できます。これらのレポートは、リストの作成後にのみ表示されます。

リスト・レポートを表示するには、次のステップを実行します。

1. リスト・ページにナビゲートします。

1. 「ワークスペース」ホームページにナビゲートします。

2. 「アプリケーション・ビルダー」アイコンをクリックします。

3. アプリケーションを選択します。

4. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

5. 「ナビゲーション」で、「リスト」をクリックします。
リスト・ページが表示されます。

2. 該当するタブをクリックします。

- 未使用 - 「未使用」タブをクリックすると、カレント・アプリケーションで使用されていないリストが識別されます。

- 条件付きエントリ - 「条件付きエントリ」タブをクリックすると、条件付きリストが表示されます。

- 使用状況 - 「リストの使用状況」タブをクリックすることで、使用状況レポートにアクセスします。このレポートに、カレント・アプリケーションに含まれるすべてのリストが表示されます。レポートから、次の操作を実行できます。

- リスト名を選択して、リスト・エントリを編集します。

- 「ページ」列の番号をクリックして、リストに表示されるページを表示します。

- 「リスト・テンプレートの使用状況」を展開して名前をクリックし、リスト・テンプレートを表示または編集することによって、リストで使用されるテンプレートを表示します。

- 履歴 - 「履歴」タブをクリックすると、リスト定義およびリスト・エントリに対する変更が開発者および日付ごとに表示されます。

18.8 ショートカットの使用

この項では、ショートカットを作成および使用する方法について説明します。

- ショートカットとは

- ショートカット・タイプの理解

- ショートカットの定義と参照

- 既存のショートカットの編集

- ショートカット・レポートの表示

18.8.1 ショートカットとは

ショートカットを使用すると、HTMLまたはPL/SQLファンクションを繰り返しコーディングする必要がなくなります。ショートカットを使用して、ボタン、HTMLテキスト、PL/SQLプロシージャ、HTMLなどのページ・コントロールを定義できます。ショートカットを定義すると、そのショートカットが使用される位置に固有な特定の構文を使用して起動できます。ショートカットは何度でも参照できるため、コードの重複を削減できます。

次の属性でショートカットを使用できます。

- 「HTMLテキスト(ショートカットあり)」として定義されたリージョンのリージョン・ソース属性。「リージョンについて」を参照してください。

- リージョンのヘッダーおよびフッターのテキスト属性。「リージョンのヘッダーおよびフッターの指定」を参照してください。

- アイテム・ラベル属性、要素の前のテキスト、要素の後のテキストおよびデフォルト値属性。

- リージョン・テンプレート属性。「カスタム・テーマの作成」を参照してください。

18.8.2 ショートカット・タイプの理解

この項では、Oracle Application Expressでサポートされるショートカット・タイプについて説明します。

- サポートされるショートカット・タイプ

- エスケープされた一重引用符を持つJavaScriptのテキスト

- メッセージ

- エスケープされた一重引用符を持つJavaScriptのメッセージ

18.8.2.1 サポートされるショートカット・タイプ

ショートカットの作成時に、ショートカット・タイプを選択します。Oracle Application Expressは、次のショートカット・タイプをサポートしています。

- PL/SQLファンクション本体

- HTMLテキスト

- エスケープされた特殊文字を持つHTMLテキスト

- イメージ

- エスケープされた一重引用符を持つJavaScriptのテキスト

- メッセージ

- エスケープされた一重引用符を持つJavaScriptのメッセージ

18.8.2.2 エスケープされた一重引用符を持つJavaScriptのテキスト

このタイプのショートカットを使用して、JavaScriptリテラル文字列内部のショートカットを参照します。このショートカットは、テキスト文字列を定義します。ショートカットが参照されると、JavaScriptに必要な一重引用符がエスケープされます。

18.8.2.3 メッセージ

このタイプのショートカットを使用して、実行時に変換可能なメッセージを参照します。このショートカットにはショートカット・ボディがないため、ショートカット名と、対応するメッセージ名が一致する必要があります。実行時、ショートカット名は、現在の言語に翻訳可能なメッセージのテキストに展開されます。

18.8.2.4 エスケープされた一重引用符を持つJavaScriptのメッセージ

このタイプのショートカットを使用して、JavaScriptリテラル文字列内部のショートカットを参照し、実行時に変換可能なメッセージを参照します。

関連項目:
「アプリケーション翻訳およびグローバリゼーション・サポートの理解」

18.8.3 ショートカットの定義と参照

ショートカットをアプリケーションに組み込むには、ショートカットを定義して、ショートカット・リポジトリに追加する必要があります。この項では、ショートカットを定義および参照する方法について説明します。

- ショートカットを最初から定義

- 既存のショートカットのコピー

- ショートカットの参照

18.8.3.1 ショートカットを最初から定義

ショートカットを定義するには、次のステップを実行します。

1. 共有コンポーネント・ページにナビゲートします。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。
共有コンポーネント・ページが表示されます。

2. 「他のコンポーネント」で、「ショートカット」を選択します。

3. 「作成」をクリックします。

4. 「ショートカットの作成」で、「最初から」を選択して「次へ」をクリックします。

5. 「ショートカットの属性」で、次のステップを実行します。

1. 名前 - ショートカットを参照する名前を入力します。

2. タイプ - ショートカット・タイプを選択します。オプションは次のとおりです。

- PL/SQLファンクション本体

- HTMLテキスト

- エスケープされた特殊文字を持つHTMLテキスト

- イメージ

- エスケープされた一重引用符を持つJavaScriptのテキスト

- メッセージ

- エスケープされた一重引用符を持つJavaScriptのメッセージ

3. ショートカット - ショートカットのテキストを入力します。ショートカットは、30,000文字未満の長さにする必要があります。

4. エラー・テキスト - ショートカットの処理中にエラーが発生した場合に表示するテキストを入力します。

5. ビルド・オプション - このコンポーネントのビルド・オプションを選択します。

6. 「作成」をクリックします。
新しいショートカットはショートカット・ページ(ショートカット・リポジトリとも呼ばれる)に追加されます。

18.8.3.2 既存のショートカットのコピー

既存のショートカットをコピーするには、次のステップを実行します。

1. 共有コンポーネント・ページにナビゲートします。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。
共有コンポーネント・ページが表示されます。

2. 「他のコンポーネント」で、「ショートカット」を選択します。

3. 「作成」をクリックします。

4. 「ショートカットの作成」で、「既存のショートカットのコピーとして」を選択して「次へ」をクリックします。

5. 「コピー元アプリケーション」で、ショートカットをコピーするアプリケーションを選択して「次へ」をクリックします。

6. 「新しいショートカット」で、次のステップを実行します。

7. 「ショートカットのコピー」をクリックします。

1. コピー先 - コピーされるショートカットの新しい名前を入力します。

2. コピー - 「はい」、「いいえ」または「コピーおよびサブスクライブ」を選択します。

3. 「ショートカットのコピー」をクリックします。

新しいショートカットはショートカット・ページ(ショートカット・リポジトリとも呼ばれる)に追加されます。

18.8.3.3 ショートカットの参照

ショートカットを参照するには、次の構文を使用します。

"MY_SHORTCUT"

ショートカットの名前は、大文字で指定し、引用符で囲む必要があります。

18.8.4 既存のショートカットの編集

作成したショートカットは、ショートカットの編集ページで属性を編集することで変更できます。

既存のショートカットを編集するには、次のようにします。

1. 共有コンポーネント・ページにナビゲートします。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。
共有コンポーネント・ページが表示されます。

2. 「他のコンポーネント」で、「ショートカット」を選択します。

3. ショートカットを選択します。
ショートカットの編集ページが表示されます。

4. 属性を編集します。
属性の詳細は、フィールドレベル・ヘルプを参照してください。「フィールドレベル・ヘルプの表示」を参照してください。

5. 「変更の適用」をクリックします。

18.8.5 ショートカット・レポートの表示

ショートカット・レポートにアクセスするには、次のステップを実行します。

1. 共有コンポーネント・ページにナビゲートします。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。
共有コンポーネント・ページが表示されます。

2. 「他のコンポーネント」で、「ショートカット」を選択します。

3. 次のいずれかのタブをクリックします。

- サブスクリプション - アプリケーションにすべてのサブスクライブされたショートカットを表示するサブスクライブされたショートカット・ページが表示されます。

- 履歴 - 最近変更されたショートカットの履歴を日付ごとに表示するショートカット履歴ページが表示されます。

注意:
「サブスクリプション」タブおよび「履歴」タブが表示されるのは、ショートカットを作成した後のみです。

18.9 レポート出力の管理

この項では、レポート問合せを定義することによってレポート・リージョンを印刷する方法、およびレポート・レイアウトを使用してレポート・リージョンをフォーマットする方法について説明します。

- レポート問合せの定義によるレポート・リージョンの印刷

- レポート・レイアウトを使用したレポート・リージョンまたはレポート問合せのフォーマット

18.9.1 レポート問合せの定義によるレポート・リージョンの印刷

この項では、レポート問合せを定義することによってレポート・リージョンを印刷する方法について説明します。

- レポート問合せについて

- レポート問合せの作成

- レポート問合せの編集

- レポート問合せのコピー

18.9.1.1 レポート問合せについて

レポート・リージョンは、レポート問合せを共有コンポーネントとして定義することによって出力できます。レポート問合せは、抽出されるデータを識別します。リージョンに含まれるSQL文とは異なり、レポート問合せには、問合せを保存すると有効化されるSQL文が含まれます。レポート問合せは、SQL文を戻すファンクションではなく、SQL文である必要があります。

レポート問合せは、レポート・レイアウトに関連付けて、書式化されたドキュメントとしてダウンロードできます。レポート・レイアウトが選択されていない場合は、汎用のレイアウトが使用されます。汎用レイアウトは、レポート問合せのテストと検証の目的で使用します。汎用レイアウト・オプションを使用する場合にソース問合せが複数定義されていると、最初の結果セットのみが出力ドキュメントに含まれます。レポートには、現行のアプリケーションのセッション・ステートを含めることができます。

これらのレポートをアプリケーションと統合することにより、エンド・ユーザーから使用できるようにします。たとえば、ボタン、リスト・アイテム、ブランチ、またはターゲットとしてURLを使用できるその他のナビゲーション・コンポーネントをレポート問合せに関連付けることができます。そのアイテムを選択すると、出力プロセスが開始します。

18.9.1.2 レポート問合せの作成

「レポート問合せ」オプションの可用性は、サービス管理者がインスタンスに対してどのようなレポート出力設定を行ったかによって異なります。次のステップに示すすべてのオプションが使用可能であるとはかぎりません。

レポート問合せを作成するには、次のステップを実行します。

1. 共有コンポーネント・ページにナビゲートします。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。
共有コンポーネント・ページが表示されます。

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. レポート・レイアウトのデータ・ソース: このオプションは、レポート定義のエクスポート・ファイルをダウンロードするために使用します。

ヒント:
レポート問合せ定義とは、開発者が、BI Publisher DesktopやAltova Stylevisionのようなツールのソースとして使用してレポート・レイアウトを作成するためのものです。ツールによってはデータのXMLエクスポートとXMLスキーム定義の両方をソースとして受け入れますが、どちらか一方しか受け入れないツールもあります。ソース問合せによって設計時にデータが戻されない場合は、XMLスキーマによってデータなしで定義をエクスポートする方法が提供されます。

「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. 「終了」をクリックします。
レポート問合せは、「共有コンポーネント」に作成および保存されます。

関連項目:
「レポート出力の構成オプションについて」

18.9.1.3 レポート問合せの編集

レポート問合せを編集するには、次のステップを実行します。

1. 共有コンポーネント・ページにナビゲートします。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。
共有コンポーネント・ページが表示されます。

2. レポートの下の「レポート問合せ」をクリックします。

3. 目的のレポート問合せを選択します。

4. 編集ページで、該当する属性を編集します。

5. 「変更の適用」をクリックします。

18.9.1.4 レポート問合せのコピー

レポート問合せをコピーするには、次のステップを実行します。

1. 共有コンポーネント・ページにナビゲートします。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。
共有コンポーネント・ページが表示されます。

2. レポートの下の「レポート問合せ」をクリックします。

3. レポート問合せページで、「コピー」をクリックします。

4. 「レポート問合せのコピー」で、コピーする問合せを選択して、レポート問合せの名前を入力し、「コピー」をクリックします。
コピーが問合せリストに表示されます。

18.9.2 レポート・レイアウトを使用したレポート・リージョンまたはレポート問合せのフォーマット

この項では、レポート・レイアウトを使用してレポート・リージョンまたはレポート・レイアウトをフォーマットする方法について説明します。

- レポート・レイアウトについて

- レポート・レイアウト・オプションの概要

- レポート・レイアウトの作成

- レポート・レイアウトの編集

- レポート・レイアウトのコピー

18.9.2.1 レポート・レイアウトについて

クラシック・レポート・リージョンまたはレポート問合せのどちらかをフォーマットするには、レポート・レイアウトと関連付けます。レポート・レイアウトを使用すると、印刷用形式でデータをレンダリングできます。レポート・レイアウトを選択しない場合は、デフォルトのXSL-FOレイアウトが使用されます。対話モード・レポートのリージョンのレンダリングでは、常にデフォルトのXSL-FOレイアウトが使用されます。

レポート・レイアウトを作成して使用すると、次のことができるようになります。

- レポート・リージョンのデフォルト・レイアウト、およびOracle Application Expressで用意されているレポート問合せの汎用レイアウトを利用できます。

- コードをコピーしてカスタマイズすることによって、レポート・リージョンの組込みXSL-FOベースのレイアウトが利用できます。レポート・リージョンに対して、ページ・サイズ、フォント、色などを制御するいくつかの属性を編集できます。

- RTFまたはXSL-FOレポート・レイアウトを作成してレポートのルック・アンド・フィールをカスタマイズできます。RTFレポート・レイアウトを使用するには、Oracle Application Expressのサービス管理者が、そのサイトに対して詳細設定を選択している必要があります。Oracle Application Express管理ガイドの「レポート出力の構成」を参照してください。

注意:
対話モード・レポートでは、カスタム・レポート・レイアウトはサポートされません。

18.9.2.2 レポート・レイアウト・オプションの概要

レポート・レイアウトは、次のいずれかのオプションに基づいて作成できます。

- 汎用列: 汎用レポート・レイアウトはほとんどの問合せ結果セットに使用できます。このレイアウトを使用すると、出力可能なドキュメントの生成時に、列の数が自動的に調整されます。
多くのレポート・レイアウト属性は、組込みのデフォルトXSL-FOレイアウトを使用して、レポート・リージョンに対して宣言的に定義できます。レポート・レイアウトを追加制御する必要がある場合は、このステップによりカスタマイズ可能な組込みのデフォルトXSL-FOレイアウトのコピーを作成できます。

- 名前付き列: 名前付き列のレポート・レイアウトは、問合せ固有のレポート・レイアウトで、問合せ結果セットに含まれる列の定義済リストで使用できるよう設計されています。このレイアウト・タイプはページ・アイテムおよび問合せ列の位置を正確に制御する必要がある場合に、個別に設計されたレイアウトで使用されます。

「レポート・レイアウト」オプションの可用性は、サイト管理者がサイトでどのようなレポート出力設定を行ったかによって異なります。次のステップに示すすべてのオプションが使用可能であるとはかぎりません。

関連項目:
Oracle Application Express管理ガイドの「レポート出力の構成」

18.9.2.3 レポート・レイアウトの作成

レポート・レイアウトを作成するには、次のステップを実行します。

1. 共有コンポーネント・ページにナビゲートします。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。
共有コンポーネント・ページが表示されます。

2. 「レポート」の下の「レポート・レイアウト」をクリックします。

3. 「作成」をクリックします。
レポート・レイアウトの作成ウィザードが表示されます。

4. 「レポート・レイアウト・タイプ」で、オプションを選択し、「次へ」をクリックします。

- 汎用列(XSL-FO) - デフォルト・テンプレートを使用してレポートに移入します。次のステップで、デフォルト・コードをカスタマイズできます。

- 名前付き列(XSL-FO) - 次のステップでXSL-FOまたはRTFファイルをアップロードする必要があります。

5. 「レイアウト・ソース」で、該当する情報を確認および編集します。このページに表示されるオプションは、選択したレイアウト・タイプによって異なります。

- 汎用列を選択した場合は、次のステップを実行します。

1. レポート・レイアウト名: レポート問合せまたはレポート・リージョンに関連付ける際にレポート・レイアウトを識別するための名前を入力します。

2. レポート・レイアウト: レポート・レイアウトは、ページ書式のXSL-FOベースの定義です。ページ・サイズ、向き、フォント、スタイルなどを定義する属性は、すべてこのセクションで定義されます。

3. レポートの列ヘッダー: レポート・ヘッダー行の各セルの外観を定義します。

4. レポート列: すべてのレポート行に対する各セルの外観を定義します。

5. レポート列の幅: 実行時に計算されるか、またはレポート・リージョンのレポート列定義から導出できます。

- 名前付き列を選択した場合は、次のステップを実行します。

1. レイアウト名: レポート問合せまたはレポート・リージョンに関連付ける際に、レポート・レイアウトを識別するための名前を入力します。

2. レポート・レイアウト・ファイル - レポート・レイアウトが含まれるファイルをアップロードします。

6. 「レイアウトの作成」をクリックします。

18.9.2.4 レポート・レイアウトの編集

汎用列のレポート・レイアウトを直接Application Expressで編集できます。ただし、名前付き列のレポート・レイアウトを編集するには、現行のファイルをダウンロードしてそれを編集し、再度アップロードする必要があります。

レポート・レイアウトを編集するには、次のステップを実行します。

1. 共有コンポーネント・ページにナビゲートします。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。
共有コンポーネント・ページが表示されます。

2. 「レポート」の下の「レポート・レイアウト」をクリックします。

3. レポート・レイアウト・ページで、編集するレイアウトを選択します。

4. 汎用列レイアウトの場合は、レポート・レイアウトの編集ページで直接レイアウトを編集し、「変更の適用」をクリックします。

5. 名前付き列のレイアウトの場合は、「ダウンロード」をクリックして、コンピュータにファイルを保存します。
ファイルを編集して、新しいレポート・レイアウトとして更新されたバージョンをアップロードします。

18.9.2.5 レポート・レイアウトのコピー

レポート・レイアウトをコピーして編集および保存できます。

レポート・レイアウトをコピーするには、次のステップを実行します。

1. 共有コンポーネント・ページにナビゲートします。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。
共有コンポーネント・ページが表示されます。

2. 「レポート」の下の「レポート・レイアウト」をクリックします。

3. レポート・レイアウト・ページで、「コピー」をクリックします。

4. レポート・レイアウトのコピー・ページで、コピーするレイアウトを選択して、コピーの名前を入力し、「コピー」をクリックします。
コピーがレイアウト・リストに表示されます。

5. レポート・レイアウトのコピーで、次のステップを実行します。

1. レポート・レイアウトのコピー - コピーするレイアウトを選択します。

2. レポート・レイアウト名 - コピーの名前を入力します。

3. 「コピー」をクリックします。

19 アプリケーション機能の拡張

この項では、電子メールの管理、バックグラウンドPL/SQLの実行、プラグインの使用、jQueryサポートの理解を含め、アプリケーション機能の拡張方法について説明します。

- アプリケーションからの電子メール送信

- プラグインの実装

- jQueryおよびjQuery UIサポートの理解

- Oracle Application Expressコンポーネントの手動リフレッシュ

関連項目:
Oracle Application Express APIリファレンスおよび「アプリケーションのデプロイ」

19.1 アプリケーションからの電子メール送信

この項では、Oracle Application Expressで電子メールを構成および管理する方法について説明します。

- 電子メールの構成について

- 電子メール・プロビジョニングについて

- メール・キューについて

- APEX_MAILパッケージについて

19.1.1 電子メールの構成について

Oracle Application Expressで電子メールを送信できるようにするには、インスタンス管理者が電子メール設定を構成する必要があります。この項では、完全開発環境およびランタイム環境で電子メール設定を構成する方法について説明します。

関連項目:
『Oracle Application Express管理ガイド』の電子メールの構成に関する説明

- ネットワーク・サービスの有効化について

- 完全開発環境での電子メールの構成について

19.1.1.1 ネットワーク・サービスの有効化について

Oracle Database 11g以上でOracle Application Expressを実行している場合、アウトバウンド・メールを有効にする必要があります。Oracle Database 11gリリース1(11.1)以上では、ネットワーク・サービスと通信する機能がデフォルトで無効になっています。

Oracle Database 11g以上では、ネットワーク・サービスとの通信機能がデフォルトで無効になっています。このため、Oracle Database 11g以上でOracle Application Expressを実行している場合は、DBMS_NETWORK_ACL_ADMINパッケージを使用して、APEX_050000データベース・ユーザーにすべてのホストに対する接続権限を付与する必要があります。これらの権限を付与しないと、次の動作で問題が発生します。

- Oracle Application Expressでアウトバウンド・メールを送信する。

- Oracle Application ExpressでWebサービスを使用する。

- PDF/レポートを印刷する。

関連項目:
構成シナリオについては、『Oracle Application Expressインストレーション・ガイド』のOracle Database 11gでのネットワーク・サービスの有効化に関する項および『Oracle Application Express管理ガイド』の電子メールの構成に関する項

19.1.1.2 完全開発環境での電子メールの構成について

完全開発環境でメールを送信するようにOracle Application Expressを構成するには、インスタンス管理者がOracle Application Express管理サービスにログインし、インスタンスの設定ページにナビゲートして、「電子メール」属性を構成する必要があります。

関連項目:
『Oracle Application Express管理ガイド』の電子メールの構成に関する説明

19.1.2 電子メール・プロビジョニングについて

新しいワークスペース・リクエストが承認されたときにユーザーにログイン資格証明が電子メールで自動的に送信されるように、Oracle Application Expressを構成できます。これを行うには、電子メール構成プロセスを完了し、プロビジョニング・ステータスの電子メールの検証でのリクエストを選択する必要があります。

関連項目:
『Oracle Application Express管理ガイド』の電子メールの構成、ワークスペースの作成方法の指定およびプロビジョニング・モードの選択に関する項

19.1.3 メール・キューについて

インスタンス管理者は、メール・キュー内の電子メール・メッセージ、およびメール・ログを監視することで、アプリケーションから送信された電子メールを管理できます。

関連項目:
『Oracle Application Express管理ガイド』のメール・キューの管理に関する項

19.1.4 APEX_MAILパッケージについて

APEX_MAILパッケージを使用して、Oracle Application Expressアプリケーションから電子メールを送信できます。このパッケージは、Oracleで提供されるUTL_SMTPパッケージをベースとして構築されています。このような依存性があるため、APEX_MAILを使用するには、UTL_SMTPパッケージがインストールされており、機能している必要があります。

関連項目:
『Oracle Application Express APIリファレンス』のAPEX_MAILに関する説明および『Oracle Application Express管理ガイド』のメールの構成に関する説明

19.2 プラグインの実装

この項では、プラグインを追加、管理、再利用および共有する方法について説明します。プラグインの例はOracle Technology NetworkのOracle Application Expressプラグイン・リポジトリにあり、サンプル・データベース・アプリケーションに含まれています。

- プラグインについて

- プラグインの例の表示

- プラグイン・ページへのアクセス

- プラグインの作成

- プラグインの編集

- プラグインへのカスタム属性の追加

- プラグインに関連付けられたファイルのアップロード

- プラグインへのイベントの追加

- プラグインの削除

- プラグイン・リポジトリの表示

- プラグイン・ページからのプラグインのインポート

- プラグイン・ページからのプラグインのエクスポート

- プラグイン対話モード・レポートのリセット

- プラグインの使用状況ページの表示

- プラグイン履歴の表示

関連項目:
「プラグインの例の表示」および「プラグイン・リポジトリの表示」

19.2.1 プラグインについて

開発者はプラグインを使用して、Oracle Application Expressで使用可能な組込みタイプを宣言的に拡張、共有および再利用できます。

Oracle Application Expressは、認証スキーム、認可スキーム、アイテム、リージョン、動的アクションとプロセス・タイプのグループ・セットをサポートします。プラグインによってアプリケーション内で新しいタイプを宣言的に作成および使用することによって、これらの組込みタイプを拡張する手段が提供されます。プラグインは再利用を目的として設計されているため、開発者はプラグインを別のワークスペースにエクスポートおよびインポートしたり、プラグイン・リポジトリを使用してプラグインをOracle Application Expressプラグイン・コミュニティと共有できます。

プラグインを実装するプロセスには、次のステップがあります。

1. アプリケーション・ワークスペースでプラグインを作成するか、またはインポートします。

2. プラグインを使用するための認可スキーム、アイテム、リージョン、プロセスまたは動的アクション・タイプを編集または作成します。

3. プラグインをテストするためにアプリケーションを実行します。

19.2.2 プラグインの例の表示

プラグインの実装例を表示するには、次のステップを実行します。

- Oracleプラグイン・リポジトリに移動します。
「プラグイン・リポジトリの表示」を参照してください。

- パッケージ・アプリケーションであるサンプル・データベース・アプリケーションをインストールします。
「完全開発環境でのパッケージ・アプリケーションの管理」および「サンプル・データベース・アプリケーションのインストールおよび実行」を参照してください。

- 次の場所にあるOracle Learning Libraryに移動し、ページの下部にあるリンクをクリックしてライブラリにアクセスし、Oracle Application Express (APEX)製品OBEの検索基準を入力します。
http://www.oracle.com/technetwork/tutorials/index.html

19.2.3 プラグイン・ページへのアクセス

プラグイン・ページにアクセスするには、次のステップを実行します

1. 共有コンポーネント・ページにナビゲートします。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。
共有コンポーネント・ページが表示されます。

2. 「他のコンポーネント」で、「プラグイン」をクリックします。
プラグイン・ページが表示され、「プラグイン」タブがデフォルトで選択されます。使用可能なすべてのプラグインが表示されます。

ページの外観は、ページ上部にある検索バーを使用してカスタマイズできます。詳細は、「エンド・ユーザーとしての対話モード・レポートのカスタマイズ」を参照してください。

19.2.4 プラグインの作成

プラグインを作成するには、次のようにします。

ヒント:
この項で説明する属性の詳細は、フィールドレベル・ヘルプを参照してください。「Oracle Application Expressでのフィールドレベル・ヘルプの表示」を参照してください。

1. プラグイン・ページにナビゲートします。「プラグイン・ページへのアクセス」を参照してください。

2. 「作成」をクリックします。
プラグインの作成ウィザードが表示されます。

3. 「プラグインの作成」で、プラグインを作成する方法を選択し、「次へ」をクリックします。

4. 「名前」で、次の項目を指定します。

1. 名前(必須): プラグインの名前を入力します。

2. 内部名(必須): プラグインの内部名を入力します。この名前は、現在のアプリケーション内で一意である必要があります。

ヒント:
内部名をワールドワイドでグローバルな一意名とするために、組織のドメイン名を内部プラグイン名の接頭辞として使用することをお薦めします。たとえば、ドメイン名mycompany.comをSliderという名前のプラグインに接頭辞として付けると、内部名はCOM.MYCOMPANY.SLIDERとなります。

3. タイプ(必須): このプラグインを使用するコンポーネントのタイプを選択します。選択したプラグイン・タイプに応じて、「コールバック」および「標準属性」の下のオプションが変わります。詳細は、フィールドレベル・ヘルプを参照してください。

4. カテゴリ: 選択したタイプが「動的アクション」の場合にのみ表示されます。ユーザー・インタフェースでプラグインが表示されるカテゴリを選択します。

5. 「サブスクリプション」で、次の項目を指定します。

- マスター・プラグインの参照元 - このプラグインを、このワークスペースの別のプラグインに基づくようにするには、リストからプラグインを選択します。それ以外の場合、このフィールドをブランクのままにし、これをこのプラグインのマスター・コピーとします。

6. 「ソース」で、次の項目を指定します。

1. PL/SQLコード - このプラグインのレンダリング、検証、実行およびAJAXコールバックの実行用のプロシージャを含むコードのPL/SQL無名ブロックを入力します。パフォーマンス上の理由から、このコードはデータベース内のPL/SQLパッケージに格納することもできます。

2. PL/SQLコードを検証しない(実行時にのみPL/SQLコードを解析)。 - PL/SQLコードを実行時にのみ解析する場合は、このオプションを選択します。選択しない場合、コードはプラグインが作成されるときに解析されます。

7. 「コールバック」で、該当する属性を構成します。表示される属性はプラグイン・タイプに応じて決まります。属性の詳細および例を確認するには、フィールドレベル・ヘルプを参照してください。

ヒント:
すべてのコールバック・ファンクション名は、無名PL/SQLコード・ブロックのファンクション、パッケージ内のファンクションまたはデータベース内のスタンドアロン・ファンクションを参照できます。

8. 「ユーザー・インタフェース」で、このプラグインに対してアプリケーション・ビルダーでサポートする必要のある表示デバイスを選択します。オプションは次のとおりです。

- デスクトップ

- モバイル

9. 「標準属性」で、このプラグインに適用する属性を選択します。「標準属性」は、一部のプラグインには表示されません。詳細は、フィールドレベル・ヘルプを参照してください。

10. 「情報」で、次のステップを実行します。

1. バージョン: プラグインのバージョンを識別する文字列を入力します。

2. URL情報: プラグイン作成者のホームページのURL、またはプラグインに関する追加情報のURLです。

11. 「ヘルプ・テキスト」に、ユーザーがプラグインの機能を理解するのに使用するヘルプ・テキストを入力します。

12. 「コメント」に、アプリケーションが実行されているときに表示されないコメントおよび注意を入力します。
各オプションの詳細は、フィールドレベル・ヘルプを参照してください。

13. 「作成」をクリックします。プラグイン。
プラグインが作成されたら、追加のカスタム属性の指定、プラグインと関連付けるイメージ、CSSおよびJavaScriptファイルなどのファイルのアップロードおよびイベントの追加を実行できます。「プラグインへのカスタム属性の追加」、「プラグインに関連付けられたファイルのアップロード」および「プラグインへのイベントの追加」を参照してください。

19.2.5 プラグインの編集

プラグインを編集するには、次のようにします。

1. プラグイン・ページにナビゲートします。「プラグイン・ページへのアクセス」を参照してください。

2. 編集または表示するプラグインをクリックします。
プラグインの作成/編集ページが表示されます。

3. 変更を加えます。
各オプションの詳細は、フィールドレベル・ヘルプを参照してください。

4. 「変更の適用」をクリックします。

関連項目:
「プラグインの作成」、「プラグインへのカスタム属性の追加」、「プラグインに関連付けられたファイルのアップロード」および「プラグインへのイベントの追加」

19.2.6 プラグインへのカスタム属性の追加

プラグイン属性は、プラグインが使用されるとき、開発者に追加データの入力を求めるプロンプトをアプリケーション・ビルダー内で表示するために使用します。

プラグインにカスタム属性を追加するには、次の手順を実行します。

1. プラグイン・ページにナビゲートします。「プラグイン・ページへのアクセス」を参照してください。

2. 変更するプラグインをクリックします。
プラグインの作成/編集ページが表示されます。

3. 「カスタム属性」で、属性値の置換を有効化または無効化します。

- 代替属性値: 開発者が指定するカスタム属性値には、&P1_DNAMEなどの置換構文で参照されるアイテムが含まれる場合があります。
「はい」に設定すると、Application Expressにより自動的に置換構文が実際の値で置き換えられます。

「いいえ」に設定すると、p_plugin、p_item、p_regionなどのattribute_01からattribute_15までのレコード・タイプ属性に置換構文が変更されずに書き込まれます。プラグインの開発者は、これらの置換構文の参照をapex_plugin_util.replace_substitutionsのコールで置換するか、同様の置換を行う必要があります。詳細は、アイテム・ヘルプを参照してください。

詳細は、フィールドレベル・ヘルプを参照してください。

4. 属性を追加するには、「属性の追加」をクリックします。
属性の編集ページが表示されます。対象となる属性を編集します。

特定の属性の詳細は、フィールドレベル・ヘルプを参照してください。

5. 属性を作成して編集ページに戻るために「作成」をクリックするか、属性を作成して別の属性の作成を続行するために「作成後、さらに作成」をクリックします。

注意:
「作成」または「作成後、さらに作成」をクリックするとき、右側のパネルの「プラグイン」の下の「ページに戻る」チェック・ボックスが選択されていると、同じ属性の編集ページが表示されます。

19.2.7 プラグインに関連付けられたファイルのアップロード

この項では、プラグインに関連付けられたファイルをアップロードする方法について説明します。

- プラグインに関連付けられたファイルのアップロード

- CSSおよびJavaScriptファイルの自動ロード

19.2.7.1 プラグインに関連付けられたファイルのアップロード

ファイルをアップロードする手順は、次のとおりです。

1. プラグイン・ページにナビゲートします。「プラグイン・ページへのアクセス」を参照してください。

2. プラグインを選択します。
プラグインの作成/編集ページが表示されます。

3. 「ファイル」セクションを見つけます。
「ファイルの接頭辞」は、Webサーバーがプラグインのファイルを指す場合に使用する仮想パスを特定します。プラグイン定義とともにデータベースに格納されているファイルを参照する場合は、何も指定しないでください。

4. ファイルをアップロードする手順は、次のとおりです。

1. 「ファイルのアップロード」をクリックします。

2. アップロードするファイルを参照して選択します。

3. 「アップロード」をクリックします。
作成/編集ページが表示されます。アップロード対象ファイルの名前が「ファイル」の下に表示されます。

5. 「変更の適用」をクリックします。

19.2.7.2 CSSおよびJavaScriptファイルの自動ロード

「ロードするファイルURL」属性を構成すると、ページでプラグインが使用されるときに、CSSおよびJavaScriptファイルをOracle Application Expressで自動的にロードできます。どのアップロード済ファイルをどの順序でロードする必要があるかを指定するには、次のステップを実行します。

CSSまたはJavaScriptファイルを自動ロードするには、次のステップを実行します。

1. プラグイン・ページにナビゲートします。「プラグイン・ページへのアクセス」を参照してください。

2. プラグインを選択します。
プラグインの作成/編集ページが表示されます。

3. 「ロードするファイルURL」で、次のステップを実行します。

1. カスケード・スタイルシート - このプラグインでロードするカスケード・スタイルシート・ファイルURLを入力します。

2. JavaScript - このプラグインでロードするコードのJavaScriptファイルURLを入力します。

置換文字列#PLUGIN_FILES#を使用することで、プラグインのファイル接頭辞の値を置換できます。次に例を示します。

#PLUGIN_FILES#my_plugin.css

詳細および例を確認するには、フィールドレベル・ヘルプを参照してください。

4. 「変更の適用」をクリックします。

19.2.8 プラグインへのイベントの追加

この項では、アイテム、リージョンまたは動的アクション・タイプのプラグインにイベントを追加して、動的アクションに公開できるようにする方法について説明します。たとえば、Start Slide、Sliding、Stop Slideなどのイベントを公開するSliderプラグインによって、これらのイベントが発生したときに応答できる動的アクションを作成できます。

プラグインにイベントを追加するには、次の手順を実行します。

1. プラグイン・ページにナビゲートします。「プラグイン・ページへのアクセス」を参照してください。

2. 編集するプラグインをクリックします。
プラグインの作成/編集ページが表示されます。

3. 「イベント」で、「イベントの追加」をクリックします。
「イベント」の下に新しい行が表示されます。

4. 「イベント」で、次のように入力します。

1. 名前: 動的アクション内でプラグイン・イベントが表示される表示名(例: Start Slide)。

2. 内部名: 動的アクションをトリガーする割り当てられたJavaScriptイベントの名前。例: slidestart。

5. 「イベントの追加」をクリックします。

6. 手順3から4を繰り返して、別のイベントを追加します。

7. 「変更の適用」をクリックします。

19.2.9 プラグインの削除

プラグインは使用中でなければ削除できます。プラグインを使用中の場合、「削除」ボタンは表示されません。

プラグインを削除するには、次のようにします。

1. プラグイン・ページにナビゲートします。「プラグイン・ページへのアクセス」を参照してください。

2. 削除するプラグインをクリックします。
プラグインの作成/編集ページが表示されます。

3. 「削除」をクリックします。

4. 確認して、「OK」をクリックします。

19.2.10 プラグイン・リポジトリの表示

プラグイン・リポジトリによって、開発者がプラグインを共有およびダウンロードできる一元的な場所が提供されます。リポジトリはOracle Technology Networkにあります。

プラグイン・リポジトリを表示するには、次の手順を実行します。

1. プラグイン・ページにナビゲートします。「プラグイン・ページへのアクセス」を参照してください。

2. 「プラグイン・リポジトリの表示」をクリックします。
Oracle Application Expressプラグイン・リポジトリが表示されます。

19.2.11 プラグイン・ページからのプラグインのインポート

エクスポートされたプラグインをアプリケーションにインポートするにはこのオプションを使用します。プラグインのインポートは、ここで説明するように、プラグイン・ページの「共有コンポーネント」からか、アプリケーション・ビルダーのホームページから実行できます。「プラグインのインポート」を参照してください。

プラグインをインポートするには、次の手順を実行します。

1. プラグイン・ページにナビゲートします。「プラグイン・ページへのアクセス」を参照してください。

2. 「インポート」をクリックします。
プラグインのインポート・ページが表示されます。

3. 「ファイルの指定」で、次の項目を指定します。

1. インポート・ファイル: インポート・ファイルの名前を入力または参照します。

2. ファイル・タイプ: 「プラグイン」を選択します。

3. ファイルのキャラクタ・セット: インポート・ファイルのキャラクタ・セット・エンコードを選択します。

4. 「次へ」をクリックします。

4. 「ファイルのインポートの確認」で、「次へ」をクリックします。

5. 「インストール」で、「プラグインのインストール」をクリックします。

19.2.12 プラグイン・ページからのプラグインのエクスポート

プラグイン定義をファイルにエクスポートするにはこのオプションを使用します。このファイルは任意のAPEXアプリケーションにインポートできます。プラグインのエクスポートは、ここで説明するように、プラグイン・ページの「共有コンポーネント」からか、「ワークスペース」ホームページから実行できます。「プラグインのエクスポート」を参照してください。

プラグイン・ページからプラグインをエクスポートするには、次のステップを実行します。

1. プラグイン・ページにナビゲートします。「プラグイン・ページへのアクセス」を参照してください。

2. 「タスク」で、「プラグインのエクスポート」をクリックします。
プラグインのエクスポート・ページが表示されます。

3. プラグインのエクスポート・ページで、次のステップを実行します。

1. アプリケーション: プラグインのエクスポート元のアプリケーションを選択します。

2. プラグイン: プラグインを選択します。

3. ファイル形式: プラグイン・エクスポートのファイル形式を選択します。

4. 「エクスポート」をクリックします。

4. 「エクスポート」をクリックします。
ダウンロード完了メッセージが表示されます。

19.2.13 プラグイン対話モード・レポートのリセット

プラグインの対話モード・レポートをリセットして、現在レポートに適用されているすべてのフィルタをクリアします。

対話モード・レポートをリセットするには、次の手順を実行します。

1. プラグイン・ページにナビゲートします。「プラグイン・ページへのアクセス」を参照してください。

2. プラグイン・ページで、「リセット」をクリックします。

19.2.14 プラグインの使用状況ページの表示

プラグインの使用状況ページには、各プラグインを使用するページ、コンポーネントおよびリージョンが表示されます。

プラグインの使用状況を表示するには、次の手順を実行します。

1. プラグイン・ページにナビゲートします。「プラグイン・ページへのアクセス」を参照してください。

2. 「使用状況」をクリックします。
使用状況ページが表示されます。

19.2.15 プラグイン履歴の表示

プラグイン履歴ページには、各プラグインで実行されたアクション、アクションを実行した開発者および各アクションの日付が表示されます。

プラグインの履歴を表示するには、次の手順を実行します。

1. プラグイン・ページにナビゲートします。「プラグイン・ページへのアクセス」を参照してください。

2. 「履歴」をクリックします。
履歴ページが表示されます。

19.3 jQueryおよびjQuery UIサポートの理解

Oracle Application Expressには、jQuery 1.11.2および2.1.3、jQuery UI 1.10.4、jQuery Mobile - 1.4.4 JavaScriptライブラリが含まれています。この項では、jQuery UIで使用できる機能と、JavaScriptコードでjQueryライブラリを参照する場合のベスト・プラクティスについて説明します。

- jQueryおよびjQueryUIの更新済JavaScriptライブラリについて

- 使用できるjQuery UI機能について

- JavaScriptコードでのjQueryライブラリの参照

19.3.1 jQueryおよびjQueryUIの更新済JavaScriptライブラリについて

Oracle Application Expressが使用するjQueryおよびjQueryUIのJavaScriptライブラリが次のように更新されました。

- jQueryは、バージョン1.7.1からバージョン2.1.3に更新されました。

- jQueryUIは、バージョン1.8.14からバージョン1.10.4に更新されました。

ヒント:
バグ修正および拡張のリストは、次のjQueryおよびjQueryUIのリリース・ノートを参照してください。

- http://docs.jquery.com/Downloading_jQuery#Current_Release

- http://jqueryui.com/docs/Changelog

このアップグレードは、次のように既存のアプリケーションに影響する場合があります。

jQueryバージョンの更新で考えられる影響

アプリケーションのJavaScriptコードでjQueryを使用している場合、jQueryバージョンの更新による動作変更によって影響を受ける場合があります。最も大きな影響は、jQuery attrメソッドの使用です。このメソッドでは、ある状況下では若干異なる値が返されることがあります。これについての詳細およびその他の変更については、jQueryの変更ログを確認してください。

アプリケーションへの影響が懸念される場合、次の対処に従ってください。

1. コードで以前のバージョンのjQueryにフォールバックします。「ページ・テンプレート」→「ヘッダー」で<head>…</head>タグに次を追加することにより、jQuery 1.7.1およびjQuery UI 1.8.14を含めることができます(#HEAD#置換文字列の直後のライブラリを追加する前に追加することが重要です)。

...
#HEAD#
<script src="#IMAGE_PREFIX#libraries/jquery/1.7.1/jquery-1.7.1.min.js" type="text/javascript"></script>
...

Oracle Application Expressは、この後も#APEX_JAVASCRIPT#置換の一部としてjQuery 2.1.3を含めますが、後で1.7.1を含めるということは、変数$およびjQueryがjQueryバージョン1.7.1を指すため、引き続きアプリケーションで使用できることを意味します。

ヒント:
jQuery 1.7.1は引き続きOracle Application Express配布に含まれるため、Webサーバーに追加する必要はありません。

2. jQueryコードを確認および再テストし、変更の影響を受けているか確認します。これによって最初に必要な作業は増えますが、2つの利点があります。1つ目は、アプリケーションにロードするjQueryライブラリのバージョンが1つでよいことです。2つ目は、最新バージョンの拡張を使用できるというメリットです。

jQuery UIの更新で考えられる影響

Oracle Application Expressに、デフォルトで含まれていないjQuery UIコンポーネントを含めている場合は、互換性の問題が発生することがあります。ページ・サイズおよびページ・プロセスを削減するために、Oracle Application Expressには、Oracle Application Expressの基本機能で使用されるjQuery UIコンポーネントのみが含まれています。これらのデフォルト・コンポーネントはすべて、jQuery UI 1.10.4を使用しています。古いバージョンのjQuery UIを参照している場合、互換性の問題が発生することがあります。

デフォルトのコンポーネントはすべてjQuery UI 1.10.4を使用していますが、以前から含まれているコンポーネントは古いバージョンを参照している可能性があります。これは、すでに含まれているjQuery UIコンポーネントのバージョンと、デフォルトで含まれている更新後のjQueryおよびjQuery UIバージョンの間に互換性の問題がある可能性があることを示します。

アプリケーションへの影響が懸念される場合の対処として、次の2つのオプションがあります。

1. コードで以前のバージョンのjQueryおよびjQuery UIにフォールバックします。「ページ・テンプレート」→「ヘッダー」で<head>…</head>タグに次を追加することにより、jQuery 1.7.1およびjQuery UI 1.8.14を簡単に含めることができます(#HEAD#置換文字列の直後のライブラリを追加する前に追加することが重要です)。

...
#HEAD#
<script src="#IMAGE_PREFIX#libraries/jquery/1.7.1/jquery-1.7.1.min.js" type="text/javascript"></script>
<script src="#IMAGE_PREFIX#libraries/jquery-ui/1.8.14/ui/minified/jquery-ui-1.8.14.custom.min.js" type="text/javascript"></script>
...

Oracle Application Expressには、#APEX_JAVASCRIPT#置換の一部としてjQuery 2.1.3およびjQuery UI 1.10.4が引き続き含まれますが、古いバージョンは、参照する可能性のある他のjQuery UIコンポーネントとの互換性のためにのみ含まれています。

ヒント:
jQuery 2.1.3およびjQuery UI 1.10.4は引き続きOracle Application Expressに含まれるため、Webサーバーに追加する必要はありません。

2. jQuery UIコードを確認し、すべてのjQuery UIコンポーネントがバージョン1.10.4を参照するように更新し、再テストします。この方法によって最初に必要な作業は増えますが、アプリケーションにロードするjQueryライブラリとjQuery UIライブラリのバージョンが1つでよいというメリットが得られます。また、最新バージョンの拡張を使用できるというメリットもあります。
参照が、将来のバージョン変更による影響に対応できるように、JavaScriptコードを含むファイル、およびアプリケーション・ビルダーのアプリケーション検索で、libraries/jquery-ui/を検索し、#JQUERYUI_DIRECTORY#に置き換えることをお薦めします。

19.3.2 使用できるjQuery UI機能について

Oracle Application Expressでは、Oracle Application Expressの基本機能に必要なjQuery UIのコンポーネントのみがロードされます。Oracle Application ExpressにjQuery UIライブラリ全体を含めると、ページ・ロードごとにダウンロードと処理にかかる時間が大幅に増大するため、ライブラリ全体は含まれません。Oracle Application Expressにデフォルトで含まれるコンポーネントは次のとおりです。

- jQuery UI Core: すべての相互作用とウィジェットに必要です。

- Query UI Widget: すべてのウィジェットの基礎となるウィジェット・ファクトリです。

- jQuery UI Mouse: マウス・ウィジェットは、すべての相互作用とマウスによる相互作用が頻繁に行われるウィジェット用の基本クラスです。

- jQuery UI Position: 要素の他の要素に対する相対位置を設定するためのユーティリティ・プラグインです。

- jQuery UI Draggable: ページ上の任意の要素をドラッグ可能にします。

- jQuery UI Resizable: ページ上の任意の要素をサイズ変更可能にします。

- jQuery UI Dialog: ドラッグ可能でありサイズ変更可能なダイアログ内で既存のマークアップを開きます。

- jQuery UI Datepicker: 入力から切り替えられるかインラインで表示できる日付ピッカーです。

- jQuery UI Effects: モーフィングやイージングなどのjQueryの内部エフェクトを拡張し、他のすべてのエフェクトで必要です。

- jQuery UI Effects Drop: 要素を一方向に移動させながら同時に非表示にするドロップ・アウト・エフェクトです。

- jQuery UI Tooltip: カーソルをあわせるか、フォーカスすると、要素の追加情報を表示します

jQuery UIとこれらの特定のコンポーネントの詳細は、次のjQuery UIのサイトを参照してください。

http://jqueryui.com/

19.3.2.1 その他のjQuery UIコンポーネントへのアクセスについて

Oracle Application Expressには、jQuery UIライブラリ全体は含まれていません。関連ファイルを含めるだけで、jQuery UIの他のコンポーネントを簡単にアクティブ化できます。たとえば、アプリケーションにjQuery UI Widgetのタブを含めるには、ユーザー・インタフェース定義に次の内容を含めます。

カスケード・スタイルシートを設定する場合:

#JQUERYUI_DIRECTORY#themes/base/#MIN_DIRECTORY#jquery.ui.tabs#MIN#.css

JavaScriptを設定する場合:

#JQUERYUI_DIRECTORY#ui/#MIN_DIRECTORY#jquery.ui.tabs#MIN#.js

ヒント:
前述のデフォルト・コンポーネントのリストに示すように、UI CoreとUI Widgetのタブの依存性はOracle Application Expressにデフォルトで含まれているため、この依存性を含める必要はありません。

19.3.3 JavaScriptコードでのjQueryライブラリの参照

独自のJavaScriptコードでjQueryライブラリへの$、jQueryおよびapex.jQuery参照をいつ使用するかは、どこでそれを使用するかによって決まります。

Oracle Application Expressのより新しいバージョンには、jQueryライブラリの更新バージョンが含まれていることがあります。新しいバージョンのjQueryがリリースされる際に、既存の機能を無効にする変更が導入されることがあります。これらの問題は、特定のバージョンのリリース・ノートの変更ログに記載されています。新しいバージョンのOracle Application Expressにアップグレードする際に問題が発生する可能性を最小限に抑えるには、後続の項で説明するベスト・プラクティスに従うことをお薦めします。

- アプリケーションでのJavaScriptコードの管理について

- プラグインでのJavaScriptコードの使用について

19.3.3.1 アプリケーションでのJavaScriptコードの管理について

アプリケーション内の独自のJavaScriptコードでjQueryを使用する場合は、次の理由により、jQueryまたはショートカット$を使用することをお薦めします。

1. Oracle Application Expressにアップグレードする場合、新しいバージョンのjQueryにより既存のコードが無効化される可能性があります。
新しいバージョンのjQueryにあわせて、アプリケーションの重点的なテストと大幅な再作成を行わなくて済むようにするには、Oracle Application Expressリリース4.1に付属の古いバージョンのjQueryを、ページ・テンプレートの<head>…</head>タグで囲まれたヘッダーの#HEAD#置換文字列の後に入れます。次に例を示します。

...
#HEAD#
...
<script src="#IMAGE_PREFIX#libraries/jquery/1.6.2/jquery-1.6.2.min.js" type="text/javascript"></script>
...

この例では、jQueryライブラリへの参照である「$」および「jQuery」が指し示すのは、jQueryバージョン1.6.2 (Oracle Application Expressリリース4.1に含まれるバージョン)であり、Oracle Application Expressリリース5.0に含まれる新しいバージョンの2.1.3ではありません。

ヒント:
Oracle Application Expressリリース5.0にはjQueryバージョン2.1.3が含まれるため、ご使用のWebサーバーにこれを追加する必要はありません。

追加のコード変更は必要ありません。この方法により、新しいバージョンのApplication Expressにアップグレードする際に、jQueryのカスタム・コードが無効化されるリスクが最小限に抑えられます。

2. 使用しているjQueryプラグインに異なるバージョンのjQueryが必要であり、そのバージョンを自分のアプリケーションの他のコードで使用する場合。
この場合、(新しいまたは古い)バージョンのjQueryライブラリを、前述のステップで説明したようにページ・テンプレートに含めることができます(つまり、#HEAD#置換文字列の後ろに置きます)。変数$とjQueryが、適切なjQueryバージョンを指すようになります。

3. 使用しているjQueryプラグインに異なるバージョンのjQueryが必要であるが、そのバージョンをアプリケーションの他のコードでは使用しない場合。
たとえば、jQueryプラグインにはjQuery 1.6.2が必要だが、Oracle Application Expressに付属のjQuery 1.7.1を使用するとします。jQueryバージョン1.6.2を、ページ・テンプレートの<head>…</head>タグ内のヘッダーで、#HEAD#置換文字列の前に含めます。

この場合、プラグイン固有のjQueryバージョン(たとえば、jQuery_1_6_2)を格納するための新しい変数を定義してそれを割り当てるJavaScriptスニペットも必要です。次に例を示します。

...
<script src="#IMAGE_PREFIX#libraries/jquery/1.6.2/jquery-1.6.2.min.js" type="text/javascript"></script>
<script type="text/javascript">
var jQuery_1_6_2 = jQuery;
</script>
...
#HEAD#
...

jQuery_1_6_2変数を使用するようにjQueryプラグインの初期化コードを変更する必要もあります。たとえば、次のようにします。

(function($) {
... plugin code ...
})(jQuery_1_6_2);

jQueryプラグインの初期化の詳細は、「プラグインでのJavaScriptコードの使用について」を参照してください。

ヒント:
これらのすべてのシナリオで、必要なバージョンを指定するために、アプリケーションで変数$とjQueryを使用します。Oracle Application Expressに付属のjQueryのバージョンに依存する組込み機能をサポートするために、変数apex.jQueryは引き続きそのバージョンを指すことに注意してください。

19.3.3.2 プラグインでのJavaScriptコードの使用について

Oracle Application ExpressプラグインでjQueryを使用する場合は、jQueryライブラリへのapex.jQuery参照を使用することをお薦めします。この参照には、apex.jQuery参照を使用するために含まれているjQueryプラグインの初期化コードの変更も含める必要があります。

jQueryプラグインのJavaScriptコードを見ると、そのほとんどは次のコード構造を持っていることがわかります。

(function($) {
... plugin code ...
})(jQuery);

この構造はパラメータ$を持つ無名のJavaScript関数を宣言し、この関数はすぐにコールされて、現在のjQuery変数のパラメータ値が渡されます。jQueryショートカットとしての$の使用は、安全な方法で実装されているため、$がまだ主要jQueryライブラリの参照に使用されているという事実に依存しなくてもよくなります。

jQueryプラグイン・ファイルをコピーして、apexという接頭辞を付けることをお薦めします(たとえば、apex.jquery.maskedinput-1.2.2.js)。これにより、このファイルが変更されたことがOracle Application Expressに明確に示されます。その後、次の例に示すように、初期化コードで参照をjQueryからapex.jQueryに変更します。

(function($) {
... plugin code ...
})(apex.jQuery);

この方法を使用する他の理由

プラグイン開発者は、テストにかける労力を最小限に抑えながら、完全に制御可能な環境を構築することを希望しています。前述の項で説明した推奨事項に従っていないと仮定してみます。プラグインで異なるバージョンのjQueryが使用されているとしたら、どうなるでしょうか。

この場合、奇妙なプラグイン動作を引き起こす可能性があります。さらに、作成したプラグインが実際に異なるバージョンのjQueryを参照しているかどうかが不明なため、その動作を再現することが困難になる可能性があります。apex.jQueryネームスペースを使用することにより、開発者にとっての問題が発生する可能性が低減すると同時に、ユーザーに対して問題が発生する可能性も低減します。この方法により、サポート対象のOracle Application Expressバージョンでプラグインをテストできます。

19.4 Oracle Application Expressコンポーネントの手動リフレッシュ

動的アクション・フレームワークには、サポートされるOracle Application Expressコンポーネントに対するリフレッシュ機能がありますが、JavaScriptコードから手動でリフレッシュを起動することが必要となる場合があります。これを実行するには、次のように関連コンポーネントのapexrefreshイベントをトリガーします。

apex.event.trigger( "#myRegionStaticID", "apexrefresh" );

20 アプリケーション・セキュリティの管理

この項では、Oracle Application Expressアプリケーション・セキュリティにベスト・プラクティスを実装する方法について説明します。管理者は、Oracle Application Expressインストールのセキュリティを保証する必要があります。開発者は、セキュアなアプリケーションを構築する必要があります。

- セキュリティに関する管理者のベスト・プラクティスの理解

- セキュリティに関する開発者のベスト・プラクティスの理解

- アプリケーション、ページおよびページ・コンポーネントへのアクセスの制御

- 認証によるユーザー・アイデンティティの証明

- 認可を介したセキュリティの提供

関連項目:
「アプリケーション・ビルダーの概念」および「アプリケーション・ビルダーの理解」

20.1 セキュリティに関する管理者のベスト・プラクティスの理解

ヒント:
この項では、Administration Servicesアプリケーション内で使用する多くの設定について説明します。Administration Servicesアプリケーションの機能は、Oracle Database Cloud Service (Database Schema)には適用されません。

このセクションでは、Oracle Application Express管理者のためのセキュリティのベスト・プラクティスについて説明します。

- Oracle Application Express管理者のロールについて

- Oracle Application ExpressでのOracle REST Data Servicesの構成について

- Oracle Application Expressでのmod_plsqlを使用したOracle HTTP Serverの構成について

- 埋込みPL/SQLゲートウェイを使用する場合のセキュリティに関する考慮事項について

- インスタンス・セキュリティの管理

- インスタンス設定の構成

- ワークスペースの消去設定の構成について

- ワークスペース管理の理解

- Oracle BI Publisherとの統合について

- Application Expressのランタイム環境の利点について

- Oracle Database 11g以上のネットワーク・サービスの有効化

関連項目:
「セキュリティに関する開発者のベスト・プラクティスの理解」

20.1.1 Oracle Application Express管理者のロールについて

Oracle Application Express開発環境にアクセスするには、ユーザーはワークスペースという作業用の共有領域にログインします。Oracle Application Expressには、2種類の管理者が含まれています。

- ワークスペース管理者は、ユーザー・アカウントの管理、ワークスペース・アクティビティの監視、ログ・ファイルの表示など、ワークスペース固有の管理タスクを実行するユーザーです。

- インスタンス管理者は、Application Express管理サービス・アプリケーションを使用して、ホスティングされたインスタンス全体を管理するスーパーユーザーです。

ヒント:
インスタンス管理者のロールは、Oracle Database Cloud Service (Database Schema)では使用できません。

関連項目:
ワークスペースおよびインスタンス管理の詳細は、『Oracle Application Express管理ガイド』を参照してください

20.1.2 Oracle Application ExpressでのOracle REST Data Servicesの構成について

Oracle REST Data Services (以前のOracle Oracle Application Express Listener)は、SQL*Net接続経由でブラウザ・リクエストをApplication Expressエンジン・データベースにマッピングすることによってOracle Databaseと通信するJ2EEアプリケーションです。Oracle REST Data ServicesはOracle Application Expressの戦略的方向性であり、実質的にすべての環境で使用することをお薦めします。本番環境では、Oracle Web Logic ServerなどのサポートされているJava EEアプリケーションにOracle REST Data Services Webアーカイブ・ファイルをデプロイします。各デプロイは、個別に構成し、Oracleデータベースと通信するためのmod_plsqlデータベース・アクセス記述子と同じ目的で利用できます。

Oracle REST Data Servicesのデプロイ構成には、複数のセキュリティ関連パラメータが含まれます。Oracle Application Expressの構成では、パラメータsecurity.requestValidationFunctionをwwv_flow_epg_include_modules.authorizeに設定することをお薦めします。これにより、Oracle Application Expressに付属のコール可能なプロシージャのホワイト・リストがアクティブ化され、他のプロシージャへのコールが禁止されます。これは、Oracle Application Expressに付属する検証ファンクションを使用して拡張できます。詳細は、『Oracle Application Express管理ガイド』のデータベース・アクセス記述子(DAD)によるOracle Application Expressへのアクセスの制限に関する説明を参照してください。

20.1.3 Oracle Application Expressでのmod_plsqlを使用したOracle HTTP Serverの構成について

ヒント:
Oracle HTTP Server 12c (12.1.3)時点で、mod_plsqlは非推奨となっています。この非推奨に関する詳細は、My Oracle Supportノート1576588.1を参照してください。かわりに、Oracle REST Data Servicesを使用することをお薦めします。

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管理ガイド』のデータベース・アクセス記述子(DAD)によるOracle Application Expressへのアクセスの制限に関する説明を参照してください。

20.1.4 埋込みPL/SQLゲートウェイを使用する場合のセキュリティに関する考慮事項について

埋込みPL/SQLゲートウェイは、Oracle XML DB HTTPリスナーの一部としてデータベースで実行されます。Oracle XML DB HTTPリスナーおよび埋込みPL/SQLゲートウェイには、Oracle HTTP Serverおよびmod_plsqlと同等の主要機能があります。HTTPリスナーは、Oracle Application Expressがインストールされているデータベースと同じデータベースで実行されるため、HTTPリスナーをデータベースから分けることはできません。このため、インターネット上で実行されるアプリケーションまたは本番アプリケーションに埋込みPL/SQLゲートウェイを使用することはお薦めしません。かわりに、Oracle REST Data Servicesを使用することをお薦めします。また、埋込みPL/SQLゲートウェイでは、Oracle REST Data Servicesほどに柔軟な構成および詳細なログは提供されません。

20.1.5 インスタンス・セキュリティの管理

この項では、Oracle Application Expressインスタンスを管理する場合のセキュリティに関するベスト・プラクティスの概要を示します。

- ログイン制御の作成について

- パブリック・ファイルのアップロードの有効化について

- IPアドレスによるユーザー・アクセスの制限について

- インスタンス・プロキシの指定について

- Secure Sockets Layerの使用について

- RESTfulアクセスの有効化について

- 「セッションを再結合」について

- ワークスペースの分離について

- セッション・タイムアウトの使用について

- パスワードの再利用の制限

- WebシートでのSQLの使用について

- RESTfulサービスの有効化について

関連項目:
『Oracle Application Express管理ガイド』のセキュリティ設定の構成に関する項

20.1.5.1 ログイン制御の作成について

ワークスペースの管理者および開発者は、Oracle Application Expressの開発環境にログインし、ワークスペース内で開発されたアプリケーションに対するエンド・ユーザーの認証を行うためのユーザー・アカウントを作成できます。

管理者は、インスタンス全体または各ワークスペースのログイン制御を構成することができます。たとえば、インスタンス管理者がOracle Application Express管理サービスでアカウント・ログイン制御を構成した場合、その構成は開発インスタンス全体ですべてのワークスペースの全Application Expressアカウントに適用されます。

インスタンス管理者がインスタンス全体でログイン制御を有効にしない場合は、各ワークスペース管理者がワークスペースごとに次の制御を有効にできます。

- エンド・ユーザーのアカウント有効期限およびロック。

- エンド・ユーザー・アカウントへのログイン試行失敗の最大回数。

- パスワード存続期間(つまりエンド・ユーザー・アカウントのパスワードを使用できる期限が切れるまでの残りの日数)。

関連項目:
『Oracle Application Express管理ガイド』のインスタンスのログイン制御の作成およびワークスペースのアカウント・ログイン制御の作成に関する項。

20.1.5.2 パブリック・ファイルのアップロードの有効化について

管理者は、「パブリック・ファイルのアップロードを許可」属性を使用して、認証されていないユーザーがファイルのアップロード機能を提供するアプリケーションでファイルをアップロードできるかどうかを制御できます。

関連項目:
『Oracle Application Express管理ガイド』のパブリック・ファイルのアップロードの制御に関する項

20.1.5.3 IPアドレスによるユーザー・アクセスの制限について

管理者は、インスタンスの管理、セキュリティ・ページで「IPアドレス別にアクセスを制限」属性の許容されるIPアドレスのカンマ区切りリストを入力して、Oracle Application Expressインスタンスへのユーザー・アクセスを制限できます。

関連項目:
『Oracle Application Express管理ガイド』のIPアドレス別のユーザー・アクセスの制限に関する項

20.1.5.4 インスタンス・プロキシの指定について

管理者は、「インスタンス・プロキシ」属性を使用して、すべてのアウトバウンドHTTPトラフィックにプロキシを使用するようにOracle Application Expressインスタンス全体を構成できます。インスタンス・レベルでのプロキシの設定は、アプリケーション・レベルまたはWebサービス参照で定義されているすべてのプロキシより優先されます。プロキシが指定されている場合、URLタイプのリージョン、Webサービスおよびレポート出力で、そのプロキシが使用されます。

関連項目:
『Oracle Application Express管理ガイド』のインスタンス用のプロキシ・サーバーの構成に関する項

20.1.5.5 Secure Sockets Layerの使用について

Secure Sockets Layer(SSL)は、インターネット上に転送されるデータのセキュリティを管理するためのプロトコルです。SSLは、HTTPSプロトコルを使用してWebアプリケーションに実装されます。機密データが暗号化されていない(クリアテキストの)通信チャネルに送信されないように、SSL (HTTPSプロトコル)を使用してOracle Application Expressアプリケーションを実行することをお薦めします。

管理者は、「HTTPSが必要」属性および「アウトバウンドHTTPSが必要」属性を構成することで、Oracle Application Expressインスタンスとすべての関連アプリケーションでHTTPSを必要とするように構成できます。これらの属性を構成すると、アプリケーション・ビルダー内の認証済ページでは、ネットワーク通信を暗号化するHTTPSを要求することが強制されます。「HTTPSが必要」オプションを変更しても、Webサーバーにはまったく影響しません。これらのオプションが意味を持つためには、HTTPSに対してWebサーバーを有効化する必要があります。HTTPSの有効化の詳細は、使用する特定のWebサーバーのドキュメントを参照してください。

「HTTPSが必要」オプションは次のとおりです。

- 常時 - すべてのアプリケーション(Oracle Application Express開発および管理アプリケーションを含む)にHTTPSを要求するように強制します。

- 開発および管理 - Oracle Application Express内のすべての内部アプリケーション(つまり、アプリケーション・ビルダー、SQLワークショップ、インスタンス管理など)にHTTPSを要求するように強制します。

- アプリケーション固有 - HTTPSをアプリケーション・レベル設定依存にします。

関連項目:
Oracle Application Express管理ガイドの「HTTPSの必要性」

20.1.5.6 RESTfulアクセスの有効化について

管理者は、「RESTfulアクセスを許可」属性を使用して、開発者がレポート・リージョンをRESTfulサービスとして公開できるかどうかを制御できます。

関連項目:
『Oracle Application Express管理ガイド』のインスタンスのRESTfulサービスの制御に関する項

20.1.5.7 「セッションを再結合」について

「セッションを再結合」属性は、Oracle Application ExpressでセッションIDを含まないURLをサポートするかどうかを制御します。セッションの再結合を有効にすると、URLにセッションIDが含まれていない場合、Oracle Application Expressはセッションcookieを使用して既存のセッションを結合しようとします。

「セッションを再結合」を使用するには、管理者はアプリケーション・レベルまたはページ・レベルで「セッションを再結合」を有効にする必要があります。「セッションを再結合」にインスタンス・レベルでより制限の多い値が設定されている場合、これによりアプリケーションおよびページ設定が上書きされます。

セッション結合のサポートは便利ですが、複数の重大なセキュリティ・リスクが存在します。

- セッション・ステートの悪意のある変更または他の変更のトリガー。
攻撃者がユーザーにアプリケーション・リンクをクリックさせた場合に、セッション・ステートの悪意のある変更または他の変更がトリガーされる可能性があります。このリスクのため、Application Expressには、データの変更を伴うリクエスト処理のタイミングを攻撃者が推測できないチェックサムが必要です。

- アプリケーション間の予期しない変更のトリガー。
ユーザーが同じOracle Application Expressインスタンスの個別のタブで2つのアプリケーションを開いている場合、一方のアプリケーションが他方のアプリケーションで予期しない変更をトリガーする可能性があります。攻撃側のアプリケーションはハッカーによって作成されたか、攻撃者にコードの挿入を可能にするXSS脆弱性がある場合があります。このアプリケーションは、他のアプリケーションとのユーザーの相互作用をシミュレートするAjaxコールを使用することがあります。

ヒント:
セキュリティ上の理由から、管理者は、ワークスペース・レベルまたはインスタンス・レベルで「ホスト名の許可」属性を構成してワークスペース分離を実装する場合を除いて、「セッションを再結合」を無効にすることをお薦めします。「ワークスペースの分離について」を参照してください。

20.1.5.8 ワークスペースの分離について

ワークスペースの分離は、ブラウザ攻撃を防ぐ効果的な方法です。ワークスペースを実際に分離する唯一の方法は、Oracle Application Express管理サービスで「ホスト名の許可」属性を構成して、URLで異なるドメインを強制することです。攻撃者と攻撃を受ける側のURLでドメインとホスト名が異なる場合、ブラウザの同一起点ポリシーによって攻撃が回避されます。

「ホスト名の許可」の構成によるワークスペースの分離は、ワークスペースの境界を越えようとするクライアント側攻撃への対策となります。このセキュリティ対策は、他のフレームワークおよび言語(Oracle Application Development Framework (ADF)やJavaなど)で作成されたアプリケーションを含むインスタンスのホストを使用してアクセスできるすべてのアプリケーションを信頼できる場合は、必要ありません。

関連項目:
『Oracle Application Express管理ガイド』のワークスペースの分離によるブラウザ攻撃の回避およびインスタンス内のすべてのワークスペースの分離に関する項

20.1.5.9 セッション・タイムアウトの使用について

「セッション・タイムアウト」属性を構成すると、アプリケーションの公開を抑制できます。ユーザーは、長時間コンピュータを操作しなかったり、アプリケーションを終了せずにコンピュータの元を離れることが頻繁にあります。このため、アプリケーションのユーザー・アイデンティティが、権限のないユーザーによって簡単に引き継がれる可能性があります。セッション・タイムアウトおよびアイドル・タイムアウトを設定すると、指定したタイムアウトの後、ユーザーは自動的にアプリケーションからログアウトされます。

「セッション・タイムアウト」属性には、次のものがあります。

- 最大セッションの長さ

- セッション・タイムアウトURL

- 最大セッション・アイドル時間

- アイドル・タイムアウトURL

開発者は特定のアプリケーションのセッション・タイムアウトを構成でき、管理者はインスタンス全体のセッション・タイムアウトを構成できます。

関連項目:
これらの属性をアプリケーション・レベルで構成する方法の詳細は、「セッション管理」を参照してください。Oracle Application Expressインスタンス全体でこれらの属性を構成するには、『Oracle Application Express管理ガイド』のセッション・タイムアウトの構成に関する項を参照してください。

20.1.5.10 パスワードの再利用の制限

サイト管理者は、すべての管理者アカウント、開発者アカウントおよびエンド・ユーザー・アカウントに対し、そのアカウントに以前使用されたパスワードの履歴に基づいて、パスワードの再利用を制限することができます。

パスワードの再利用を制限するには、次のステップを実行します。

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

ヒント:
APEX_ADMINISTRATOR_ROLEは、別のデータベース・ロールを介してではなく、ユーザーに直接付与される必要があります。

2. 次の文を実行します。

ALTER SESSION SET CURRENT_SCHEMA = APEX_050000;

3. 次の文を実行します。

BEGIN
APEX_INSTANCE_ADMIN.SET_PARAMETER('PASSWORD_HISTORY_DAYS',365);
COMMIT;
END;
/

これによって、作成または更新するパスワードは、過去365日間にそのアカウント用として使用されていないものに制限されます。以前に使用されたパスワード(実際は、パスワードのハッシュ表現)は、Oracle Application Expressをインストールしたときから記録されます。

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ファンクションも使用することができます。

20.1.5.11 WebシートでのSQLの使用について

SQL Webシート属性を許可属性を無効にすると、管理者は、WebシートのユーザーがSQLタグを使用して基盤となるデータベース・オブジェクトにアクセスしたり、SQLレポートを作成することを防ぐことができます。

関連項目:
『Oracle Application Express管理ガイド』のWebシートでのSQLアクセスの有効化と無効化に関する項

20.1.5.12 RESTfulサービスの有効化について

「RESTfulサービスを有効にする」属性を無効にすると、開発者は、Oracle REST Data Services 2.0以上とともに使用されるSQLおよびPL/SQLにマップされるRESTful Webサービスを作成および編集できなくなります。

関連項目:
『Oracle Application Express管理ガイド』のインスタンスのRESTfulサービスの制御に関する項

20.1.6 インスタンス設定の構成

この項では、Oracle Application Expressインスタンスを構成する場合のセキュリティに関するベスト・プラクティスの概要を示します。

- ワークスペースのセルフ・サービス割当ての有効化について

- 電子メールの有効化および構成について

- 記憶域オプションの構成について

- ウォレットの作成について

関連項目:
『Oracle Application Express管理ガイド』のインスタンス設定の構成に関する項

20.1.6.1 ワークスペースのセルフ・サービス割当ての有効化について

管理者は、新規ワークスペースの割当て(または作成)時に自動化の量を決定します。割当ての動作方法を決定するには、インスタンス管理者は、インスタンスの設定ページで次のいずれかのオプションを選択します。

- 手動 - 管理者が新しいワークスペースを作成し、ワークスペース管理者にログイン情報を手動で通知します。

- リクエスト - ユーザーがセルフ・サービス方式で直接ワークスペースをリクエストします。

- 電子メールの検証でのリクエスト - このモードでは、ユーザーがログイン・ページでリンクをクリックしてワークスペースを直接リクエストし、リクエスト・フォームにアクセスします。各ユーザーは、検証リンクを含む電子メールを最初に受信します。ユーザーが検証リンクをクリックすると、リクエストが処理されます。ユーザーは、この後サインイン・ページを使用してワークスペースにアクセスできます。

関連項目:
『Oracle Application Express管理ガイド』のワークスペースの作成方法の指定に関する項

20.1.6.2 電子メールの有効化および構成について

Oracle Application Expressアプリケーションから電子メールを送信するには、インスタンス管理者は電子メールSMTP設定を定義し、Oracle Database 11gR2以上に対してセキュアな接続を使用するように「SSL/TLSの使用」属性を設定する必要があります。

関連項目:
『Oracle Application Express管理ガイド』の電子メールの構成およびネットワーク・サービスを有効にする必要があるタイミングと理由に関する項

20.1.6.3 記憶域オプションの構成について

管理者は、ワークスペースや自動拡張表領域をリクエストした際に新しいスキーマを要求したり、指定日数に達したアップロード済ファイルを削除する記憶域オプションを構成できます。

関連項目:
『Oracle Application Express管理ガイド』の記憶域の構成に関する項

20.1.6.4 ウォレットの作成について

ウォレットは、SSLに必要な認証および署名された資格証明(秘密鍵、証明書および信頼できる証明書)の格納に使用されるパスワード保護されたコンテナです。次の場合は、ウォレットを作成する必要があります。

- SSL有効URLを呼び出す(たとえば、Webサービスを起動して)場合。

- タイプがSSL有効URLのリージョンを作成する場合。

- 「SSL/TLSの使用」属性を「はい」に設定してセキュアSMTPを構成する場合。

- 「認証付きSSL」を使用するように構成されたLDAP認証スキームを持つアプリケーションを使用する場合。

関連項目:
Oracle Application Express管理ガイドの「ウォレット情報の構成」

20.1.7 ワークスペースの消去設定の構成について

アクティブでないワークスペースは、貴重な記憶領域を消費して、システム・パフォーマンスを低下させます。「ワークスペースの消去設定」を有効にすることによって、管理者は、アクティブでないワークスペースを消去するようにOracle Application Expressを構成できます。

関連項目:
『Oracle Application Express管理ガイド』のアクティブでないワークスペースの消去に関する項

20.1.8 ワークスペース管理の理解

この項では、Oracle Application Expressでワークスペースを管理する場合のセキュリティに関するベスト・プラクティスの概要を示します。

- スキーマへのワークスペースの割当ての管理について

- 開発者およびユーザーの管理について

- コンポーネントの可用性の管理について

関連項目:
『Oracle Application Express管理ガイド』の既存のワークスペースの管理に関する項

20.1.8.1 スキーマへのワークスペースの割当ての管理について

ユーザーがOracle Application Expressにログインする場合、ワークスペースという作業用の共有領域にログインします。各ワークスペースに、複数のスキーマを関連付ける(マップする)ことができます。インスタンス管理者は、必要に応じてワークスペースとスキーマ間の関連付けを定義できます。ワークスペースをスキーマに関連付けることによって、開発者はワークスペースで、スキーマ内の新規データベース・オブジェクトの作成、およびスキーマ内のデータベース・オブジェクトと相互作用するアプリケーションの構築が可能です。

関連項目:
『Oracle Application Express管理ガイド』のスキーマへのワークスペースの割当ての管理に関する項

20.1.8.2 開発者およびユーザーの管理について

管理者は、どのスキーマ固有のユーザーにアクセス権を与えるか、およびそれらのユーザーのユーザー・ロール、つまり、ユーザーがワークスペース管理者、開発者またはエンド・ユーザーであるかを定義できます。管理者は、特定のApplication Expressコンポーネントへの開発者アクセスを制限し、アカウントをロックすることもできます。Oracle Application Expressには、開発者とユーザーを管理するための2つの個別のインタフェースがあります。ワークスペース管理者はワークスペース内でユーザー・アカウントを管理し、インスタンス管理者はApplication Express開発インスタンスにわたってすべてのユーザー・アカウントを管理します。

関連項目:
『Oracle Application Express管理ガイド』のApplication Expressインスタンスにわたるユーザーの管理およびワークスペースでのユーザーの管理に関する項

20.1.8.3 コンポーネントの可用性の管理について

ワークスペース管理者は、開発者がオブジェクト・ブラウザからPL/SQLプログラム・ユニットを編集およびコンパイルできるかどうかを決定する、主要コンポーネント(アプリケーション・ビルダー、チーム開発、SQLワークショップ、PL/SQL編集など)へのユーザー・アクセスを制御できます。たとえば、管理者がユーザーにデータベース・コンポーネントの構築、SQL文の実行を許可し、アプリケーションの作成は許可しない場合、管理者は特定のスキーマに対する権限を持つワークスペースを定義し、ワークスペース・プリファレンスの設定ページのオプションを使用してユーザーを開発者として構成します。

関連項目:
『Oracle Application Express管理ガイド』のワークスペース・プリファレンスの構成に関する項

20.1.9 Oracle BI Publisherとの統合について

Oracle Application ExpressとOracle BI Publisherを統合する場合は、Secure Sockets Layer(SSL)を使用することをお薦めします。Oracle BI Publisherサーバー用にSSL(HTTPSプロトコル)を構成したら、ウォレットを作成して、内部管理環境設定でレポート・サーバーにHTTPSプロトコルを指定する必要があります。

関連項目:
Oracle Application Express管理ガイドの「ウォレット情報の構成」および「レポート出力の構成」

20.1.10 Application Expressのランタイム環境の利点について

Oracle Application Expressのランタイム環境では本番アプリケーションを実行できますが、管理用のWebインタフェースは使用できず、これらのアプリケーションを直接開発することはできません

機密の本番Oracle Application Expressアプリケーションは、Oracle Application Expressのランタイム・インストールで実行することをお薦めします。ランタイム・インストールでは、Webベースのアプリケーション開発環境が使用されないため、Application Builder、SQL Workshopおよび本番インストールに関係するユーティリティが使用できません。また、ランタイム環境に含まれるのは、アプリケーションの実行に必要なOracle Application Expressデータベース・オブジェクトおよび権限のみであるため、より堅牢な環境になります。

関連項目:
『Oracle Application Express管理ガイド』のランタイム環境にエクスポートされたアプリケーションのインストールに関する項

20.1.11 Oracle Database 11g以上のネットワーク・サービスの有効化

この項では、Oracle Database 11g以上でネットワーク・サービスを有効化する方法について説明します。

- ネットワーク・サービスを有効化する必要があるタイミングと理由

- Oracle Database 12cより前の接続権限の付与

- Oracle Database 12cでの接続権限の付与

- 無効なACLエラーのトラブルシューティングについて

20.1.11.1 ネットワーク・サービスを有効化する必要があるタイミングと理由

Oracle Database 11gリリース1または2以上では、ネットワーク・サービスとの通信機能が、デフォルトで無効化されています。このため、Oracle Database 11gリリース1または2以上でOracle Application Expressを実行している場合は、新しいDBMS_NETWORK_ACL_ADMINパッケージを使用して、APEX_050000データベース・ユーザーにすべてのホストに対する接続権限を付与する必要があります。これらの権限を付与しないと、次の場合に問題が発生します。

- Oracle Application Expressによる外部への電子メールの送信
ユーザーはAPEX_MAILパッケージからメソッドをコールできますが、外部へ電子メールを送信するときに問題が発生します。

- Oracle Application Express内のWebサービスの使用

- PDF/レポートの印刷。

ヒント:
このセクションで示されている例を実行するには、データベースのcompatible初期化パラメータが11.1.0.0.0以上に設定されている必要があります。デフォルトでは、Oracle Database 11gまたは12cのパラメータは事前に適切に設定されていますが、以前のリリースからOracle Database 12cにアップグレードされたデータベースのパラメータは適切に設定されていない場合があります。データベースの初期化パラメータの変更の詳細は、Oracle Database管理者ガイドのOracle Databaseの作成と構成に関する項を参照してください。

20.1.11.2 Oracle Database 12cより前の接続権限の付与

次の例は、APEX_050000データベース・ユーザーにすべてのホストに対する接続権限を付与する方法を示しています。この例では、Oracle Application Expressがインストールされているデータベースに、SYSDBAロールが指定されているSYSとして接続するとします。

DECLARE
ACL_PATH  VARCHAR2(4000);
ACL_ID    RAW(16);
BEGIN
-- Look for the ACL currently assigned to '*' and give APEX_050000
-- the "connect" privilege if APEX_050000 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, ensure 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_050000'
-- 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_050000',
'connect') IS NULL THEN
DBMS_NETWORK_ACL_ADMIN.ADD_PRIVILEGE(ACL_PATH,
'APEX_050000', 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_050000', TRUE, 'connect');
DBMS_NETWORK_ACL_ADMIN.ASSIGN_ACL('power_users.xml','*');
END;
/
COMMIT;

次の例は、ローカル・ネットワーク・リソースへのアクセス権について、より少ない権限を付与する方法を示しています。この例では、電子メールやレポート・サーバーなど、ローカル・ホストのサーバーへのアクセスのみを有効にします。

DECLARE
ACL_PATH  VARCHAR2(4000);
ACL_ID    RAW(16);
BEGIN
-- Look for the ACL currently assigned to 'localhost' and give APEX_050000
-- the "connect" privilege if APEX_050000 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, ensure 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_050000'
-- 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_050000',
'connect') IS NULL THEN
DBMS_NETWORK_ACL_ADMIN.ADD_PRIVILEGE(ACL_PATH,
'APEX_050000', 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_050000', TRUE, 'connect');
DBMS_NETWORK_ACL_ADMIN.ASSIGN_ACL('local-access-users.xml','localhost');
END;
/
COMMIT;

20.1.11.3 Oracle Database 12cでの接続権限の付与

DBMS_NETWORK_ACL_ADMINのプロシージャCREATE_ACL、ASSIGN_ACL、ADD_PRIVILEGEおよびCHECK_PRIVILEGEは、Oracle Database 12cでは非推奨です。かわりにAPPEND_HOST_ACEを使用することをお薦めします。次の例は、APEX_050000データベース・ユーザーにすべてのホストに対する接続権限を付与する方法を示しています。この例では、Oracle Application Expressがインストールされているデータベースに、SYSDBAロールが指定されているSYSとして接続するとします。

BEGIN
DBMS_NETWORK_ACL_ADMIN.APPEND_HOST_ACE(
host => '*',
ace => xs$ace_type(privilege_list => xs$name_list('connect'),
principal_name => 'apex_050000',
principal_type => xs_acl.ptype_db));
END;
/

次の例は、ローカル・ネットワーク・リソースへのアクセス権について、より少ない権限を付与する方法を示しています。この例では、電子メールやレポート・サーバーなど、ローカル・ホストのサーバーへのアクセスのみを有効にします。

BEGIN
DBMS_NETWORK_ACL_ADMIN.APPEND_HOST_ACE(
host => 'localhost',
ace => xs$ace_type(privilege_list => xs$name_list('connect'),
principal_name => 'apex_050000',
principal_type => xs_acl.ptype_db));
END;
/

20.1.11.4 無効な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_050000ユーザーにACLを適用する必要があります。「Oracle Database 12cより前の接続権限の付与」を参照してください。

20.2 セキュリティに関する開発者のベスト・プラクティスの理解

このセクションでは、Oracle Application Express開発者のためのセキュリティのベスト・プラクティスについて説明します。

- タイプ・パスワードのアイテムについて

- 問題を引き起こす可能性のあるパスワード・アイテムの識別

- クロスサイト・スクリプティング保護の理解

- セッション・ステートおよびセキュリティについて

- セッション・ステート保護の理解

- ファイルのアップロードの保護について

関連項目:
「セキュリティに関する管理者のベスト・プラクティスの理解」および「Application Expressのユーザー・ロールの概要」

20.2.1 タイプ・パスワードのアイテムについて

パスワード・アイテムは、Webブラウザ画面に入力されたテキストを表示しません。パスワード・アイテムを作成するときは、セッション・ステートを保存しないパスワード属性を使用することをお薦めします。これによって、パスワードがセッション・ステート表のデータベースに保存されるのを回避できます。

設定可能なパスワード・アイテム・タイプ属性は、次のとおりです。

- 必須の値: 「はい」に設定し、ページ・アイテムが表示されている場合、Oracle Application Expressでは、ページの送信時にNOT NULL検証が自動的に実行されます。「いいえ」に設定すると、検証が行われず、NULL値が受け入れられます。

- [Enter]を押すと送信: 「はい」に設定した場合、ユーザーがフィールドで[ENTER]キーを押すと、ページが送信されます。

- 状態を保存しない: 「はい」に設定すると、パスワードがセッション・ステートに保存されません。セキュリティ上の理由により、この属性は常に「はい」に設定する必要があります。「いいえ」に設定する場合は、「セッション・ステートに暗号化された値を保存」属性を「はい」に設定することを考慮してください。

- 認可スキーム: オプションで認可スキームを選択します。このコンポーネントをレンダリングまたは処理するためには、この認可スキームがTRUEと評価される必要があります。

- セッション・ステート保護: この属性を「制限なし」または「制限付き」に設定して、セッション・ステート保護のレベルを選択できます。

- 制限なし: URLまたはフォームでアイテムを渡して、アイテムを設定できます。URLにチェックサムは必要ありません。

- 制限付き: アイテムをブラウザから設定することはできません。アイテムの値を内部プロセス、計算などに設定できる方法を制限する場合は、このオプションを使用します。この属性は、データ・エントリ・アイテムとして使用できないアイテムのみに適用され、「セッション・ステート保護」が無効になっていても常に監視されます。

- セッション・ステートに暗号化された値を保存: 機密のセッション・ステートは、Application Expressセッション・ステート管理表に格納するときに暗号化することができます。このアイテムの暗号化されたセッション・ステートを保持するには、この値を「はい」に設定します。詳細は、「セッション・ステートおよびセキュリティの概要」を参照してください。

関連項目:
「アイテム・タイプについて」、「ページ・デザイナでのページ・レベル・アイテムの編集」および「コンポーネント・ビューでのページ・レベル・アイテムの作成」

20.2.2 問題を引き起こす可能性のあるパスワード・アイテムの識別

問題を引き起こす可能性のあるパスワード・アイテムは、次のいずれかです。

- セッション・ステートを保存しないパスワード・アイテム・タイプを1つも使用しないもの。

- 暗号化していない値をセッション・ステートに格納するもの。

この項では、「セキュリティ・プロファイル」および「パスワード・アイテム」レポートを使用して、問題を引き起こす可能性のあるパスワード・アイテムを識別する方法について説明します。

- 「セキュリティ・プロファイル」レポートの表示

- 「パスワード・アイテム」レポートの表示

20.2.2.1 「セキュリティ・プロファイル」レポートの表示

「セキュリティ・プロファイル」レポートを表示するには、次のステップを実行します。

1. 「ワークスペース」ホームページにナビゲートします。

2. 「アプリケーション・ビルダー」アイコンをクリックします。
アプリケーション・ビルダーのホームページが表示されます。

3. 「ワークスペース・ユーティリティ」アイコンをクリックします。

4. ウィンドウの右側に、「アプリケーション間レポート」があります。

5. 「アプリケーション間レポート」で、「セキュリティ・プロファイル」レポートをクリックします。
このレポートには、現在のワークスペース内のすべてのアプリケーションに関する次の情報が表示されます。

- アプリケーション

- 名前

- 解析対象スキーマ

- アプリケーション・レベル認可スキーム

- 認証

- 認可スキーム

- 認可スキーム

- ページ

- 暗号化アイテム

- 問題を引き起こす可能性のあるパスワード・アイテム

20.2.2.2 「パスワード・アイテム」レポートの表示

問題を引き起こす可能性のあるパスワード・アイテムを識別するには、次のステップを実行します。

1. 「ワークスペース」ホームページにナビゲートします。

2. 「アプリケーション・ビルダー」アイコンをクリックします。
アプリケーション・ビルダーのホームページが表示されます。

3. 「ワークスペース・ユーティリティ」アイコンをクリックします。

4. ウィンドウの右側に、「アプリケーション間レポート」があります。

5. 「アプリケーション間レポート」で、「パスワード・アイテム」をクリックします。
「パスワード・アイテム」レポートには、アプリケーション内にあるすべてのパスワード・アイテムが、暗号化を使用するかどうかおよびステートを保存するかどうかとともに表示されます。いずれも行わないパスワード・アイテムは、「問題を引き起こす可能性」とハイライトされます。

ヒント:
パスワード・アイテムを含むページで、ページ属性「フォームのオートコンプリート」を「オフ」に設定します。この属性を「オフ」に設定すると、Webブラウザによって、ページでアイテムのオートコンプリートが試行されなくなります。

20.2.3 クロスサイト・スクリプティング保護の理解

この項では、クロスサイト・スクリプティング・セキュリティ攻撃からアプリケーションを保護するためのベスト・プラクティスについて説明します。

- クロスサイト・スクリプティング・セキュリティ攻撃の概要

- HTMLリージョンなどの静的領域の保護

- 動的出力の保護について

- レポート・リージョンの保護について

- フォーム・アイテムの保護について

- アイテムに入力する文字の制限について

20.2.3.1 クロスサイト・スクリプティング・セキュリティ攻撃の概要

クロスサイト・スクリプティング(XSS)は、動的に生成されるWebページを利用するセキュリティ攻撃です。XSS攻撃では、ユーザーのブラウザに読み込まれたときにアクティブになるスクリプトがWebアプリケーションに送信されます。これらのスクリプトがアクティブになると、データまたは場合によってはセッション資格証明が盗まれ、それらの情報が攻撃者に送信される可能性があります。

悪意のあるコードがOracle Application Expressアプリケーションに侵入すると、通常のページ・レンダリング時に、そのコードがアプリケーション内のHTMLリージョンや他の場所にレンダリングされる可能性があります。セッション・ステートへの不正なコードの挿入を阻止するため、Application Expressエンジンは特定の場合に文字をエスケープします。

20.2.3.2 HTMLリージョンなどの静的領域の保護

この項では、HTMLリージョンなどの静的表示領域を保護する方法について説明します。

- HTMLリージョンなどの静的領域の保護について

- 安全なアイテム表示タイプの概要

- 値をエスケープするかどうかを決定するために使用されるルールについて

- 安全なアイテム・タイプを使用したHTMLマークアップの保持および表示について

20.2.3.2.1 HTMLリージョンなどの静的領域の保護について

HTMLリージョンなどの静的領域では、置換文字列を使用してセッション・ステートを参照できます。テンプレート内で使用可能な特別な置換文字列は、シャープ記号(#)で示します(例: #ABC#)。ページまたはアプリケーション・アイテムを参照するには、&ITEM.表記法を使用します。

静的表示領域の例には、HTMLリージョン、ページのヘッダーとフッター、リージョンのヘッダーとフッター、リージョン・タイトル、ボタン・ラベル、ヘルプ・テキスト、フォーム・アイテム・ラベルおよび要素の後のテキスト、テンプレート、(フィールド・テキストの前後の)ラジオ・グループ、イベント成功メッセージ、イベント・エラー・メッセージ、ナビゲーション・バー属性、アプリケーション静的置換文字列値、チャート・ラベルおよび凡例、ブレッドクラムおよびリスト・フレーム・テキスト、カレンダ・テキスト、ラベル、凡例などがあります。

開発者は、感嘆符(!)の後に事前定義済のフィルタ名を続けたものをページまたはアプリケーション・アイテム名、あるいはレポート列参照に追加して、置換値内の特殊文字をエスケープできます。

関連項目:
「置換文字列の使用について」および「置換文字列での出力のエスケープの制御」

20.2.3.2.2 安全なアイテム表示タイプについて

セッション・ステートがこのように参照される場合、ページに表示される値には、参照されるアイテムが「表示のみ」で「セッション・ステートの保存」属性が「いいえ」、および特殊をエスケープが「いいえ」に設定されている場合にエスケープされる特殊文字(<、>、&、")が含まれません。

参照されるアイテムに「セッション・ステートの保存」属性が「いいえ」に設定されている「表示のみ」以外の表示タイプが含まれている場合、ページに表示される値には、エスケープされる特殊文字が含まれます。また、アプリケーション・レベルのアイテムには、安全な表示タイプが含まれているとみなされますが、実際にフォーム・アイテムに含まれているような表示プロパティは含まれていません。

関連項目:
「ページ・レベル・アイテムの理解」

20.2.3.2.3 値をエスケープするかどうかを決定するために使用されるルールについて

Application Expressエンジンは、事前定義済のスマート・エスケープ・ルールを使用して、セッション・ステートからフェッチされた値をエスケープするかどうか、およびいつそれを実行するかを決定します。

このルールを使用するのは、前にリストした表示タイプを使用したアイテムは、通常フィルタ処理(エスケープ)されずにブラウザに表示されることを意図したHTMLを含むテキスト用であるためです。安全に行われる方法は、これらのタイプのアイテムが常にエスケープされてアプリケーションに入力されるルールを実施する以外にありません。たとえば、ユーザーが、Oracle Application Expressのf?p URL構文を使用して、一部のテキストを安全なアイテムに渡す場合、Application Expressエンジンは値をセッション・ステートに保存する際に特殊文字をエスケープします。これにより次の2つの結果が予想されます。

1. 値に特殊文字が含まれていなかった場合、渡された値は指定されたとおりにセッション・ステートに保存される。

2. 値に特殊文字が含まれていた場合、値をセッション・ステートに保存する際に特殊文字をエスケープする。

いずれの状況でも、アイテムは、現在、前述のHTMLリージョンなどの静的領域で&ITEM.表記法を使用して安全に参照できます。

20.2.3.2.4 安全なアイテム・タイプを使用したHTMLマークアップの保持および表示について

前にリストした安全なアイテム・タイプを使用して、ブラウザにHTMLマークアップを保持および表示します。たとえば、安全なページ・アイテムP1_XXX(&P1_XXXを使用)を参照して、太字で一部のテキストをレンダリングする要件があるとします。アイテムP1_XXXには次のHTMLが含まれているとします。

<b>ABABABAB</b>

実行するには、アプリケーション・コントロール(計算、プロセス、アイテムのソース式、アイテムのデフォルト値など)を使用して、値をこれらの安全なアイテムに格納します。値をこのように挿入する場合は、コンテンツの安全性を確認します。これらの方法を使用する場合、Application Expressエンジンは、値をセッション・ステートに保存する際に特殊文字をエスケープしません。

安全なアイテムの安全性は、最終的に、アイテムがページにポストされず、ページ送信の一部としてApplication Expressエンジンに発行されないルールによって確認されます。

20.2.3.3 動的出力の保護について

htp.pなどの方法を使用してセッション・ステートからフェッチし、レンダリングするアイテムは、必要に応じてコードで明示的にエスケープする必要があります。たとえば、ページ上のPL/SQL動的コンテンツ・リージョンで次を使用するとします。

htp.p(v('SOME_ITEM'));

セッション・ステートからフェッチするアイテムの値に予期しないタグやスクリプトが含まれる可能性がある場合は、リージョンで次を使用できます。

htp.p(apex_escape.html(:SOME_ITEM));

ただし、フェッチする値を安全にレンダリングできることが確かな場合は、この値をエスケープする必要はありません。開発者は、出力をエスケープしない方が適切な場合を判断する必要があります。

次のように、このルールに従うことをお薦めします。

- アイテムが「安全なアイテム表示タイプについて」に示される安全なタイプでないかぎり、エスケープせずにセッション・ステートからフェッチされたアイテムを表示しないでください。

これを行うのは、開発者としてハッカーが悪意ある値を安全ではないアイテムにポストするのを防ぐ方法はないためです。アプリケーションがこれらのアイテムを一般ユーザーに見えるように表示しなくても、このルールに従わないと、ハッカーはアプリケーションを使用してXSS攻撃をマウントできることに注意してください。

20.2.3.4 レポート・リージョンの保護について

Application Expressエンジンは、レポートのボディでレンダリングされるデータをエスケープします。レポートのヘッダーおよびメッセージにおけるセッション・ステートへの参照は、安全なアイテム・タイプの値はエスケープされず、その他のアイテム・タイプの値はエスケープされるように、スマート・エスケープ・ルールを使用してセッション・ステートからフェッチされます。

Oracle Application Expressでは、列の「特殊文字をエスケープ」属性が「はい」に設定されている場合、レポート列のHTML特殊文字が自動的にエスケープされます。プレーン列値のかわりにHTMLフラグメントをレンダリングする必要がある場合(たとえば、ハイライトのために)、(「特殊文字をエスケープ」の使用を妨げる)問合せ自体でのHTMLフラグメントの連結を行わずに、レポート列の「HTML式」属性を使用する必要があります。「HTML式」属性で、静的HTMLを入力し、#COLUMN#表記法を使用してエスケープされた列値を埋め込むことができます。拡張された列表記法により、Oracle Application Expressが列値をエスケープする方法を制御できます。

- #COLUMN!HTML# - 予約済のHTML文字をエスケープします。

- #COLUMN!ATTR# - HTML属性のコンテキストで予約済の文字をエスケープします。

- #COLUMN!JS# - JavaScriptのコンテキストで予約済の文字をエスケープします。

- #COLUMN!RAW# - 元のアイテム値を保持し、文字をエスケープしません。

- #COLUMN!STRIPHTML# - HTMLタグを出力から削除し、予約済のHTML文字をエスケープします。

たとえば、次の問合せに基づくレポートがあるとします。

SELECT
empno,
ename,
NULL DELETE_LINK
FROM emp

この例では、すべての列がエスケープされます。「HTML式」をDELETE_LINKで次のように定義できます。

<a href="javascript:if (confirm('Do you really want to delete #ENAME!JS#?')) doSubmit('DELETE-#EMPNO#');">Delete</a>

この例では、従業員を削除するかどうかを確認するリンクがレンダリングされ、ユーザーが確認した場合は、行を削除するリクエストが送信されます。#ENAME!JS#ではなく#ENAME#を使用した場合、O'Neillのような名前は構文エラーの原因となり、攻撃者は不適切なエスケープをクロスサイト・スクリプティングに利用できます。

関連項目:
「置換文字列での出力のエスケープの制御」、「ページ・デザイナでの列属性の編集」および「コンポーネント・ビューでの列属性の編集」

20.2.3.5 フォーム・アイテムの保護について

ブラウザに送信されるフォーム・ページの生成中に、フォーム・アイテム(隠しアイテムなど)が値を取得する場合、結果テキストはレンダリング前にエスケープされます。一部の安全なアイテム・タイプは、各表示タイプの意図する動作をサポートするため、このルールにおける例外となります。

一部のアイテム・タイプには、「特殊文字をエスケープ」セキュリティ属性があります。「特殊文字をエスケープ」属性を使用して、値をエスケープするかどうかを指定します。デフォルトでは「はい」に設定されています。HTMLコードを表示する場合は、この属性を「いいえ」に設定します。

開発者は、感嘆符(!)の後に事前定義済のフィルタ名を続けたものをページまたはアプリケーション・アイテム名、あるいはレポート列参照に追加して、置換値内の特殊文字をエスケープできます。

関連項目:
「置換文字列での出力のエスケープの制御」

20.2.3.6 アイテムに入力する文字の制限について

ユーザーがアイテムに入力できる文字を制限することで、クロスサイト・スクリプティングおよびその他のインジェクション攻撃を制限できます。これを行うためには、「ページ・アイテムの編集」ページの「セキュリティ」リージョンで「制限付き文字」属性を使用します。「制限付き文字」はセッション・ステートに保存できます。使用可能なオプションは次のとおりです。

- - すべての文字を許可 -
制限は適用されません。

- a-Z、0-9と空白のホワイトリスト
文字a-z、A-Z、0-9および空白のみ許可されます。

- ブラックリストHTMLコマンド文字(<>")。
予約済のHTML文字は許可されません。

- ブラックリスト&<>"/;,*|=%および--
&、<、>、"、/、;、","、*、|、=、%および"--" (PL/SQLコメント)は許可されません。

- ブラックリスト&<>"/;,*|=%または--と改行
&、<、>、"、/、;、","、*、|、=、%、"--"、および改行文字は許可されません。

制限を選択する場合、選択された文字制限に一致しないデータをユーザーが保存しようとすると、Oracle Application Expressからエラー・メッセージが表示されます。

関連項目:
「ページ・アイテムのセキュリティの構成」および「ページ・アイテムのセキュリティの構成」

20.2.4 セッション・ステートおよびセキュリティについて

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バイトを超える値を暗号化しようとすると、エラー・メッセージが表示されます。

20.2.5 セッション・ステート保護の理解

セッション・ステート保護は、ハッカーがアプリケーション内のURLを改ざんするのを防ぐための組込み機能です。URL改ざんにより、プログラム・ロジック、セッション・ステートの内容および情報プライバシが悪影響を受ける可能性があります。

- セッション・ステート保護の仕組み

- セッション・ステート保護の有効化

- セッション・ステート保護の構成

20.2.5.1 セッション・ステート保護の仕組み

セッション・ステート保護を有効にすると、「ページ・アクセス保護」属性と「セッション・ステート保護」項目属性が、f?p= URL内に配置されたチェックサムとともに使用され、URL改ざんと、セッション・ステートに対する権限のないアクセスおよび変更が防止されます。セッション・ステート保護を無効にすると、セッション・ステート保護に関連するページ属性および項目属性が無視され、生成されるf?p= URLにはチェックサムが含まれません。

20.2.5.2 セッション・ステート保護の有効化

セッション・ステート保護は、セキュリティ属性の編集ページまたはセッション・ステート保護ページから有効にできます。

セッション・ステート保護は2ステップのプロセスで有効にします。最初に、この機能を有効にします。次に、ページおよびアイテムのセキュリティ属性を設定します。これらのステップは、ウィザードを使用して実行するか、セッション・ステート保護ページでページおよびアイテムのセキュリティ属性を手動で設定して行います。

- 「セキュリティ属性の編集」からのセッション・ステート保護の有効化

- 「ブックマークの無効化」ボタン

- 「セッション・ステート保護」からのセッション・ステート保護の有効化

20.2.5.2.1 「セキュリティ属性の編集」からのセッション・ステート保護の有効化

セキュリティ属性の編集ページからセッション・ステート保護を有効にするには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」アイコンをクリックします。

4. 「セキュリティ」で、「セキュリティ属性」をクリックします。

5. 「セッション・ステート保護」までスクロールして、「セッション・ステート保護」リストの「有効」を選択します。

6. セッション・ステート保護を構成するには、「セッション・ステート保護の管理」をクリックします。
セッション・ステート保護ページが表示されます。

7. ウィザードを使用してセッション・ステート保護の有効化、無効化または構成を行うには、「保護の設定」をクリックします。

8. あるいは、適切なページまたはアイテム属性ページにナビゲートし、「セキュリティ」属性を設定します。

ヒント:
セッション・ステート保護を無効にするには、同じステップを再度実行しますが、「有効」のかわりに「無効」を選択します。セッション・ステート保護を無効にしても、既存のセキュリティ属性の設定は変更されませんが、それらの属性は実行時に無視されます。

20.2.5.2.2 「ブックマークの無効化」ボタンについて

セッション・ステート保護を有効にすると、カレント・アプリケーションへのブックマーク・リンクが機能するかどうかに影響します。次の規則を考慮してください。

1. セッション・ステート保護を有効にした後に作成したブックマーク・リンクは、ブックマーク・リンクにチェックサムが含まれている場合に機能します。

2. セッション・ステート保護を有効にする前に作成したブックマーク・リンクは、ブックマーク・リンクにチェックサムが含まれている場合は機能しません。

3. チェックサムが含まれていないか、または不要なチェックサムが含まれているブックマークは、セッション・ステート保護の影響を受けません。

ページ・レンダリング時、Application Expressエンジンは、計算中に非表示のアプリケーション属性(チェックサムsalt)を使用し、f?p URLに含まれているチェックサムを確認します。セッション・ステート保護を有効にすると、Application Expressエンジンにチェックサムが含まれます。チェックサムsalt属性を再設定するには、セキュリティ属性の編集ページで「ブックマークの無効化」をクリックします。

ヒント:
「ブックマークの無効化」をクリックすると、アプリケーションへのアクセスに使用されるブックマークURLは、このアプリケーションに以前に生成されたチェックサムが含まれる場合は失敗するので注意してください。

ブックマークの無効化の確認ページで、ブックマーク・チェックサムの計算に使用されるハッシュ・アルゴリズムであるブックマーク・チェックサム・ファンクションを構成することもできます。

20.2.5.2.3 「セッション・ステート保護」からのセッション・ステート保護の有効化

セッション・ステート保護を有効にするには、次のステップを実行します。

1. 共有コンポーネント・ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「セキュリティ」で、「セッション・ステート保護」を選択します。

セッション・ステート保護ページが表示されます。セッション・ステート保護の現行のステータス(有効または無効)がページ上部に表示されることに注意してください。

2. 「保護の設定」ボタンをクリックします。
「セッション・ステート保護」ウィザードが表示されます。

3. 「操作の選択」で、「有効化」を選択して、「次へ」をクリックします。
次に、ページおよびアイテムのセキュリティ属性を設定するかどうか決定します。

4. 「有効化」を選択して、「次へ」をクリックします。

5. 「セッション・ステート保護の有効化」をクリックします。

ヒント:
セッション・ステート保護を無効にするには、同じステップを実行しますが、「有効化」のかわりに「無効化」を選択します。セッション・ステート保護を無効にしても、既存のセキュリティ属性の設定は変更されませんが、それらの属性は実行時に無視されます。

20.2.5.3 セッション・ステート保護の構成

- セッション・ステート保護の構成について

- 既存のセッション・ステート保護設定の確認

- ウィザードを使用したセッション・ステート保護の構成

- ページのセッション・ステート保護の構成

- ページ・アイテムのセッション・ステート保護の構成

- アプリケーション・アイテムのセッション・ステート保護の構成

ヒント:
セキュリティ属性を構成する前に、まずセッション・ステート保護を有効にする必要があります。「セッション・ステート保護の有効化」を参照してください。

20.2.5.3.1 セッション・ステート保護の構成について

セッション・ステート保護を有効にした後、セキュリティ属性を構成します。セキュリティ属性は2つの方法で構成できます。

- ウィザードを使用し、特定の属性カテゴリの値を選択する。この場合、選択内容がアプリケーション内のすべてのページおよびアイテムに適用されます。

- 個々のページ、アイテムまたはアプリケーション・アイテムの値を構成する。

20.2.5.3.2 既存のセッション・ステート保護設定の確認

「セッション・ステート保護」ウィザードの最初のページでは、ページ、アイテムおよびアプリケーション・アイテムのセッション・ステート保護設定のサマリーを確認できます。

既存のセッション・ステート保護設定のサマリーを表示するには、次のステップを実行します。

1. 「セッション・ステート保護」ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「セキュリティ」で、「セッション・ステート保護」を選択します。
セッション・ステート保護ページが表示されます。

2. 「保護の設定」をクリックします。

3. ページ下部で次のレポートを開きます。

- ページ・レベルのセッション・ステート保護サマリー

- ページ・アイテムのセッション・ステート保護サマリー

- アプリケーション・アイテムのセッション・ステート保護

20.2.5.3.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にチェックサムは必要ありません。
注意: Ajaxを使用してこのアイテムの値をセッション・ステートに設定する必要がある場合は、アイテムに対して「制限なし」保護レベルを使用する必要があります(たとえば「動的アクション」の場合は、「値の設定」、「送信するページ・アイテム」または「カスケードLOV」、「送信するページ・アイテム」)。

- チェックサムが必要 - アプリケーション・レベル: スキーマ固有のチェックサムを入力する場合は、URLでアイテムの名前/値を渡して、アイテムのセッション・ステートを設定できます。ユーザー・レベル・チェックサムまたはセッション・レベル・チェックサムも使用できます(次の項目を参照)。現行のワークスペースの別のセッションで同じアプリケーションを実行しているユーザーが生成したチェックサムを含むURLによってのみ、このアイテムを設定できるようにする場合に、このオプションを使用します。

- チェックサムが必要: ユーザー・レベル: ワークスペース、アプリケーションおよびユーザー固有のチェックサムを入力する場合は、URLでアイテムの名前/値を渡して、アイテムのセッション・ステートを設定できます。セッション・レベル・チェックサムも使用できます(次の項目を参照)。現行のワークスペースの別のセッションで同じアプリケーションを実行しているユーザーが生成したチェックサムを含むURLによってのみ、このアイテムを設定できるようにする場合に、このオプションを使用します。

- チェックサムが必要: セッション・レベル: カレント・セッション固有のチェックサムも入力する場合は、URLでアイテムの名前/値を渡して、アイテムのセッション・ステートを設定できます。カレント・セッションで生成されたチェックサムを含むURLによってのみ、このアイテムを設定できるようにする場合に、このオプションを使用します。

- 制限付き - ブラウザから設定できない: URLまたはPOSTDATAを使用してアイテムを変更できません。アイテムの値を内部プロセス、計算などに設定できる方法を制限する場合は、このオプションを使用します。この属性は、データ・エントリ・アイテムとして使用できないアイテムのみに適用され、セッション・ステート保護が無効になっていても常に監視されます。
次の表示形式タイプのアプリケーション・アイテムまたはページ・アイテムについては、この属性を使用します。

- テキストとして表示(特殊文字をエスケープし、状態は保存しない)

- テキストとして表示(状態は保存しない)

- テキストとして表示(LOVに基づき、状態は保存しない)

- テキストとして表示(PL/SQLに基づき、状態は保存しない)

- テキスト・フィールド(無効、状態を保存しない)

- HTML表の停止および開始(ラベルのみ表示)

6. 「ページのデータ・エントリ・アイテム保護」で、次のいずれかの項目を選択します。

- 制限なし: URLまたはフォームでアイテム名/値を渡して、アイテムのセッション・ステートを設定できます。URLにチェックサムは必要ありません。
注意: Ajaxを使用してこのアイテムの値をセッション・ステートに設定する必要がある場合は、アイテムに対して「制限なし」保護レベルを使用する必要があります(たとえば「動的アクション」の場合は、「値の設定」、「送信するページ・アイテム」または「カスケードLOV」、「送信するページ・アイテム」)。

- チェックサムが必要 - アプリケーション・レベル: スキーマ固有のチェックサムを入力する場合は、URLでアイテムの名前/値を渡して、アイテムのセッション・ステートを設定できます。ユーザー・レベル・チェックサムまたはセッション・レベル・チェックサムも使用できます(次の項目を参照)。現行のワークスペースの別のセッションで同じアプリケーションを実行しているユーザーが生成したチェックサムを含むURLによってのみ、このアイテムを設定できるようにする場合に、このオプションを使用します。

- チェックサムが必要: ユーザー・レベル: ワークスペース、アプリケーションおよびユーザー固有のチェックサムを入力する場合は、URLでアイテムの名前/値を渡して、アイテムのセッション・ステートを設定できます。セッション・レベル・チェックサムも使用できます(次の項目を参照)。現行のワークスペースの別のセッションで同じアプリケーションを実行しているユーザーが生成したチェックサムを含むURLによってのみ、このアイテムを設定できるようにする場合に、このオプションを使用します。

- チェックサムが必要: セッション・レベル: カレント・セッション固有のチェックサムを入力する場合は、URLでアイテムの名前/値を渡して、アイテムのセッション・ステートを設定できます。カレント・セッションで生成されたチェックサムを含むURLによってのみ、このアイテムを設定できるようにする場合に、このオプションを使用します。

7. 「ページの表示専用アイテム保護」で、次のいずれかの項目を選択します。

- 制限なし: URLまたはフォームでアイテムの名前/値を渡して、アイテムを設定できます。URLにチェックサムは必要ありません。
注意: Ajaxを使用してこのアイテムの値をセッション・ステートに設定する必要がある場合は、アイテムに対して「制限なし」保護レベルを使用する必要があります(たとえば「動的アクション」の場合は、「値の設定」、「送信するページ・アイテム」または「カスケードLOV」、「送信するページ・アイテム」)。

- チェックサムが必要 - アプリケーション・レベル: スキーマ固有のチェックサムを入力する場合は、URLでアイテムの名前/値を渡して、アイテムのセッション・ステートを設定できます。ユーザー・レベル・チェックサムまたはセッション・レベル・チェックサムも使用できます(次の項目を参照)。現行のワークスペースの別のセッションで同じアプリケーションを実行しているユーザーが生成したチェックサムを含むURLによってのみ、このアイテムを設定できるようにする場合に、このオプションを使用します。

- チェックサムが必要: セッション・レベル: カレント・セッション固有のチェックサムを入力する場合は、URLでアイテムの名前/値を渡して、アイテムのセッション・ステートを設定できます。カレント・セッションで生成されたチェックサムを含むURLによってのみ、このアイテムを設定できるようにする場合に、このオプションを使用します。

- チェックサムが必要: ユーザー・レベル: ワークスペース、アプリケーションおよびユーザー固有のチェックサムを入力する場合は、URLでアイテムの名前/値を渡して、アイテムのセッション・ステートを設定できます。セッション・レベル・チェックサムも使用できます。現行のワークスペースの別のセッションで同じアプリケーションを実行しているユーザーが生成したチェックサムを含むURLによってのみ、このアイテムを設定できるようにする場合に、このオプションを使用します。

- 制限付き - ブラウザから設定できない: URLまたはPOSTDATAを使用してアイテムを変更できません。アイテムの値を内部プロセス、計算などに設定できる方法を制限する場合は、このオプションを使用します。この属性は、セッション・ステート保護が無効になっていても、常に監視されます。
次の表示形式タイプについては、この属性を使用します。

- テキストとして表示(特殊文字をエスケープし、状態は保存しない)

- テキストとして表示(状態は保存しない)

- テキストとして表示(LOVに基づき、状態は保存しない)

- テキストとして表示(PL/SQLに基づき、状態は保存しない)

- テキスト・フィールド(無効、状態を保存しない)

- HTML表の停止および開始(ラベルのみ表示)

8. 「次へ」をクリックします。

9. 「終了」をクリックします。

20.2.5.3.4 ページのセッション・ステート保護の構成

ページのセッション・ステート保護を構成するには、次のステップを実行します。

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にチェックサムは必要ありません。
注意: Ajaxを使用してこのアイテムの値をセッション・ステートに設定する必要がある場合は、アイテムに対して「制限なし」保護レベルを使用する必要があります(たとえば「動的アクション」の場合は、「値の設定」、「送信するページ・アイテム」または「カスケードLOV」、「送信するページ・アイテム」)。

- チェックサムが必要 - アプリケーション・レベル: スキーマ固有のチェックサムを入力する場合は、URLでアイテムの名前/値を渡して、アイテムのセッション・ステートを設定できます。ユーザー・レベル・チェックサムまたはセッション・レベル・チェックサムも使用できます(次の項目を参照)。現行のワークスペースの別のセッションで同じアプリケーションを実行しているユーザーが生成したチェックサムを含むURLによってのみ、このアイテムを設定できるようにする場合に、このオプションを使用します。

- チェックサムが必要: ユーザー・レベル: ワークスペース、アプリケーションおよびユーザー固有のチェックサムを入力する場合は、URLでアイテムの名前/値を渡して、アイテムのセッション・ステートを設定できます。セッション・レベル・チェックサムも使用できます(次の項目を参照)。現行のワークスペースの別のセッションで同じアプリケーションを実行しているユーザーが生成したチェックサムを含むURLによってのみ、このアイテムを設定できるようにする場合に、このオプションを使用します。

- チェックサムが必要: セッション・レベル: カレント・セッション固有のチェックサムを入力する場合は、URLでアイテムの名前/値を渡して、アイテムのセッション・ステートを設定できます。カレント・セッションで生成されたチェックサムを含むURLによってのみ、このアイテムを設定できるようにする場合に、このオプションを使用します。

8. 「表示専用アイテム」を選択した場合は、各アイテムのセッション・ステート保護レベルを選択します。

- 制限なし: URLまたはフォームでアイテムの名前/値を渡して、アイテムを設定できます。URLにチェックサムは必要ありません。
注意: Ajaxを使用してこのアイテムの値をセッション・ステートに設定する必要がある場合は、アイテムに対して「制限なし」保護レベルを使用する必要があります(たとえば「動的アクション」の場合は、「値の設定」、「送信するページ・アイテム」または「カスケードLOV」、「送信するページ・アイテム」)。

- 制限付き - ブラウザから設定できない: URLまたはPOSTDATAを使用してアイテムを変更できません。アイテムの値を内部プロセス、計算などに設定できる方法を制限する場合は、このオプションを使用します。この属性は、セッション・ステート保護が無効になっていても、常に監視されます。次の表示形式タイプについては、この属性を使用します。

- テキストとして表示(特殊文字をエスケープし、状態は保存しない)

- テキストとして表示(状態は保存しない)

- テキストとして表示(LOVに基づき、状態は保存しない)

- テキストとして表示(PL/SQLに基づき、状態は保存しない)

- テキスト・フィールド(無効、状態を保存しない)

- HTML表の停止および開始(ラベルのみ表示)

- チェックサムが必要 - アプリケーション・レベル: スキーマ固有のチェックサムを入力する場合は、URLでアイテムの名前/値を渡して、アイテムのセッション・ステートを設定できます。ユーザー・レベル・チェックサムまたはセッション・レベル・チェックサムも使用できます(次の項目を参照)。現行のワークスペースの別のセッションで同じアプリケーションを実行しているユーザーが生成したチェックサムを含むURLによってのみ、このアイテムを設定できるようにする場合に、このオプションを使用します。

- チェックサムが必要: ユーザー・レベル: ワークスペース、アプリケーションおよびユーザー固有のチェックサムを入力する場合は、URLでアイテムの名前/値を渡して、アイテムのセッション・ステートを設定できます。セッション・レベル・チェックサムも使用できます(次の項目を参照)。現行のワークスペースの別のセッションで同じアプリケーションを実行しているユーザーが生成したチェックサムを含むURLによってのみ、このアイテムを設定できるようにする場合に、このオプションを使用します。

- チェックサムが必要: セッション・レベル: カレント・セッション固有のチェックサムを入力する場合は、URLでアイテムの名前/値を渡して、アイテムのセッション・ステートを設定できます。カレント・セッションで生成されたチェックサムを含むURLによってのみ、このアイテムを設定できるようにする場合に、このオプションを使用します。

9. 「変更の適用」をクリックします。

20.2.5.3.5 ページ・アイテムのセッション・ステート保護の構成

アイテムのセッション・ステート保護を構成するには、次のステップを実行します。

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にチェックサムは必要ありません。
注意: Ajaxを使用してこのアイテムの値をセッション・ステートに設定する必要がある場合は、アイテムに対して「制限なし」保護レベルを使用する必要があります(たとえば「動的アクション」の場合は、「値の設定」、「送信するページ・アイテム」または「カスケードLOV」、「送信するページ・アイテム」)。

- チェックサムが必要 - アプリケーション・レベル: スキーマ固有のチェックサムを入力する場合は、URLでアイテムの名前/値を渡して、アイテムのセッション・ステートを設定できます。ユーザー・レベル・チェックサムまたはセッション・レベル・チェックサムも使用できます(次の項目を参照)。現行のワークスペースの別のセッションで同じアプリケーションを実行しているユーザーが生成したチェックサムを含むURLによってのみ、このアイテムを設定できるようにする場合に、このオプションを使用します。

- チェックサムが必要: ユーザー・レベル: ワークスペース、アプリケーションおよびユーザー固有のチェックサムを入力する場合は、URLでアイテムの名前/値を渡して、アイテムのセッション・ステートを設定できます。セッション・レベル・チェックサムも使用できます(次の項目を参照)。現行のワークスペースの別のセッションで同じアプリケーションを実行しているユーザーが生成したチェックサムを含むURLによってのみ、このアイテムを設定できるようにする場合に、このオプションを使用します。

- チェックサムが必要: セッション・レベル: カレント・セッション固有のチェックサムを入力する場合は、URLでアイテムの名前/値を渡して、アイテムのセッション・ステートを設定できます。カレント・セッションで生成されたチェックサムを含むURLによってのみ、このアイテムを設定できるようにする場合に、このオプションを使用します。

8. 「表示専用アイテム」を選択した場合は、各アイテムのセッション・ステート保護レベルを選択します。

- 制限なし: URLまたはフォームでアイテムの名前/値を渡して、アイテムを設定できます。URLにチェックサムは必要ありません。
注意: Ajaxを使用してこのアイテムの値をセッション・ステートに設定する必要がある場合は、アイテムに対して「制限なし」保護レベルを使用する必要があります(たとえば「動的アクション」の場合は、「値の設定」、「送信するページ・アイテム」または「カスケードLOV」、「送信するページ・アイテム」)。

- 制限付き - ブラウザから設定できない: URLまたはPOSTDATAを使用してアイテムを変更できません。アイテムの値を内部プロセス、計算などに設定できる方法を制限する場合は、このオプションを使用します。この属性は、セッション・ステート保護が無効になっていても、常に監視されます。次の表示形式タイプについては、この属性を使用します。

- テキストとして表示(特殊文字をエスケープし、状態は保存しない)

- テキストとして表示(状態は保存しない)

- テキストとして表示(LOVに基づき、状態は保存しない)

- テキストとして表示(PL/SQLに基づき、状態は保存しない)

- テキスト・フィールド(無効、状態を保存しない)

- HTML表の停止および開始(ラベルのみ表示)

- チェックサムが必要 - アプリケーション・レベル: スキーマ固有のチェックサムを入力する場合は、URLでアイテムの名前/値を渡して、アイテムのセッション・ステートを設定できます。ユーザー・レベル・チェックサムまたはセッション・レベル・チェックサムも使用できます(次の項目を参照)。現行のワークスペースの別のセッションで同じアプリケーションを実行しているユーザーが生成したチェックサムを含むURLによってのみ、このアイテムを設定できるようにする場合に、このオプションを使用します。

- チェックサムが必要: ユーザー・レベル: ワークスペース、アプリケーションおよびユーザー固有のチェックサムを入力する場合は、URLでアイテムの名前/値を渡して、アイテムのセッション・ステートを設定できます。セッション・レベル・チェックサムも使用できます(次の項目を参照)。現行のワークスペースの別のセッションで同じアプリケーションを実行しているユーザーが生成したチェックサムを含むURLによってのみ、このアイテムを設定できるようにする場合に、このオプションを使用します。

- チェックサムが必要: セッション・レベル: カレント・セッション固有のチェックサムを入力する場合は、URLでアイテムの名前/値を渡して、アイテムのセッション・ステートを設定できます。カレント・セッションで生成されたチェックサムを含むURLによってのみ、このアイテムを設定できるようにする場合に、このオプションを使用します。

9. 「変更の適用」をクリックします。

20.2.5.3.6 アプリケーション・アイテムのセッション・ステート保護の構成

アプリケーション・アイテムのセッション・ステート保護を構成するには、次のステップを実行します。

1. 「セッション・ステート保護」ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「セキュリティ」で、「セッション・ステート保護」を選択します。
セッション・ステート保護ページが表示されます。

2. 「アプリケーション・アイテム」アイコンをクリックします。

3. ページ上部の検索バーを使用してページの概観をカスタマイズできます。詳細は、「検索バーについて」を参照してください。

4. アプリケーション・アイテムを選択します。

5. 「セキュリティ」で、「セッション・ステート保護」リストから次のいずれかを選択します。

- 制限なし: URLまたはフォームでアイテム名/値を渡して、アイテムのセッション・ステートを設定できます。URLにチェックサムは必要ありません。
注意: Ajaxを使用してこのアイテムの値をセッション・ステートに設定する必要がある場合は、アイテムに対して「制限なし」保護レベルを使用する必要があります(たとえば「動的アクション」の場合は、「値の設定」、「送信するページ・アイテム」または「カスケードLOV」、「送信するページ・アイテム」)。

- 制限付き - ブラウザから設定できない: URLまたはPOSTDATAを使用してアイテムを変更できません。アイテムの値を内部プロセス、計算などに設定できる方法を制限する場合は、このオプションを使用します。この属性は、データ・エントリ・アイテムとして使用できないアイテムのみに適用され、セッション・ステート保護が無効になっていても常に監視されます。次の表示形式タイプのアプリケーション・アイテムについては、この属性を使用します。

- テキストとして表示(特殊文字をエスケープし、状態は保存しない)

- テキストとして表示(状態は保存しない)

- テキストとして表示(LOVに基づき、状態は保存しない)

- テキストとして表示(PL/SQLに基づき、状態は保存しない)

- テキスト・フィールド(無効、状態を保存しない)

- HTML表の停止および開始(ラベルのみ表示)

- チェックサムが必要 - アプリケーション・レベル: スキーマ固有のチェックサムを入力する場合は、URLでアイテムの名前/値を渡して、アイテムのセッション・ステートを設定できます。ユーザー・レベル・チェックサムまたはセッション・レベル・チェックサムも使用できます(次の項目を参照)。現行のワークスペースの別のセッションで同じアプリケーションを実行しているユーザーが生成したチェックサムを含むURLによってのみ、このアイテムを設定できるようにする場合に、このオプションを使用します。

- チェックサムが必要: ユーザー・レベル: ワークスペース、アプリケーションおよびユーザー固有のチェックサムを入力する場合は、URLでアイテムの名前/値を渡して、アイテムのセッション・ステートを設定できます。セッション・レベル・チェックサムも使用できます(次の項目を参照)。現行のワークスペースの別のセッションで同じアプリケーションを実行しているユーザーが生成したチェックサムを含むURLによってのみ、このアイテムを設定できるようにする場合に、このオプションを使用します。

- チェックサムが必要: セッション・レベル: カレント・セッション固有のチェックサムを入力する場合は、URLでアイテムの名前/値を渡して、アイテムのセッション・ステートを設定できます。カレント・セッションで生成されたチェックサムを含むURLによってのみ、このアイテムを設定できるようにする場合に、このオプションを使用します。

6. 「変更の適用」をクリックします。

20.2.6 ファイルのアップロードの保護について

Oracle Application Expressを使用すると、ファイルをアップロードし、アップロードしたファイルにアクセスできるアプリケーションを簡単に作成できます。これらのファイルは、共通のファイル記憶域表にアップロードされます。データベース・ビューAPEX_APPLICATION_FILESでは、データベース・アカウント(またはワークスペース)に関連付けられたファイルが表示されますが、共通のファイル記憶域表へのプログラムを介したアクセスでは、認証が不要な場合もあり、アップロードされたファイルを他のユーザーが参照できます。このため、開発者は、「フォームおよびレポートでのBLOBサポートの理解」に記載された方法か、次に示すOTNのファイル・アップロードに関するOracle Application ExpressのHow Toドキュメントに記載された方法を使用することをお薦めします。

http://www.oracle.com/technetwork/developer-tools/apex/overview/index.html

いずれの方法の場合も、アップロードされたファイルは、パブリック表ではなく、スキーマ表に格納されます。

関連項目:
ファイル参照ページ・レベル・アイテムの作成の詳細は、「ページ・アイテムとアプリケーション・アイテムの違いについて」および「アイテム・タイプについて」を参照してください

20.3 アプリケーション、ページおよびページ・コンポーネントへのアクセスの制御

アクセス制御リストを作成することによって、アプリケーション、個別ページまたはページ・コンポーネントへのアクセスを制御できます。アクセス制御ページを作成するには、アプリケーション・スキーマにCREATE TABLE、CREATE TRIGGER、CREATE SEQUENCE権限を割り当てる必要があります。

- アクセス制御リストの動作方法

- アクセス制御リストの作成

- アプリケーション・モードの選択とユーザーの追加

- ページおよびページ・コンポーネントに対するアクセスの制御について

関連項目:
Oracle Application Express SQLワークショップ・ガイドの「クエリー・ビルダーを使用した問合せの構築」

20.3.1 アクセス制御リストの動作方法

アクセス制御ウィザードを実行して、アクセス制御リストを作成します。アクセス制御ウィザードは、アプリケーション・モードのリストとアクセス制御リストを含むアクセス制御管理ページという名前のページを作成します。アクセス制御管理ページを作成したら、次のステップを実行する必要があります。

- ステップ1 - アクセス制御管理ページを実行します。

- ステップ2 - 次のいずれかのアプリケーション・モードを選択します。

- すべての対象への完全なアクセス権。アクセス制御リストは使用されません。

- 制限されたアクセス。アクセス制御リストに定義されたユーザーのみが許可されます。

- パブリック読取り専用。アクセス制御リストによって制御される編集および管理の権限です。

- 管理アクセス専用。

- ステップ3 - アクセス制御リストにユーザーを追加します。

アクセス制御管理ページを作成する以外に、アクセス制御ウィザードでは次のものを作成します。

- アクセス制御を管理するためのアプリケーションのデフォルト・スキーマ内に2つの表

- アプリケーション・モード・リストのオプションに対応する認可スキーム

- 「アクセス制御」リストで使用可能な権限

これらの認可スキームの中の1つをページまたはコンポーネント属性ページで選択することで、特定のページまたはページ・コンポーネントへのアクセスを制御できます。アクセス制御を作成したら、アプリケーションの特定のニーズに合うようにページ、表および値をカスタマイズできます。

関連項目:
「アプリケーションへの認可スキームの割当て」

20.3.2 アクセス制御リストの作成

ページを作成することでアクセス制御リストを作成します。アプリケーションのホームページ上またはページの表示中にページを作成できます。

- アプリケーションのホームページからのアクセス制御リストの作成

- ページ編集中のアクセス制御の作成

20.3.2.1 アプリケーションのホームページからのアクセス制御リストの作成

アプリケーションのホームページからアクセス制御リストを作成するには、次のようにします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。
アプリケーションのホームページが表示されます。

3. 「ページの作成」をクリックします。

4. 「ページの作成」で、次のステップを実行します。

1. ユーザー・インタフェース: ページのユーザー・インタフェースを選択します。

2. ページ・タイプの選択: 「アクセス制御」を選択します。

3. 「次へ」をクリックします。

5. 「ページ」で、次のステップを実行します。

1. 管理ページ番号: 未使用のページ番号を指定します。

2. ページ・モード: ページ・モードを選択します。詳細は、フィールドレベル・ヘルプを参照してください。

3. 「次へ」をクリックします。

6. 「ナビゲーションのプリファレンス」で、このページに含めるナビゲーションのタイプを指定し、「次へ」をクリックします。ナビゲーション・オプション(ナビゲーション・メニューまたはタブなど)はカレント・アプリケーションのテーマに応じて決まります。

7. ページを確認して、「作成」をクリックします。

20.3.2.2 ページ編集中のアクセス制御の作成

ページ編集中にアクセス制御リストを作成するには、次のステップを実行します。

1. 適切なページにナビゲートします。

2. ページの作成ウィザードにアクセスします。

- ページ・デザイナ - ページ上部の「作成」メニューをクリックして、「ページ」を選択します。

- コンポーネント・ビュー - ページ上部の「作成」メニューをクリックして、「新しいページ」を選択します。

3. 「ページの作成」で、次のステップを実行します。

1. ユーザー・インタフェース: ページのユーザー・インタフェースを選択します。

2. ページ・タイプの選択: 「アクセス制御」を選択します。

3. 「次へ」をクリックします。

4. 「新しいページ」をクリックし、「新しいページ」を選択します。

5. ページ・タイプとして「アクセス制御」を選択し、「次へ」をクリックします。
アクセス制御ウィザードウィザードが表示されます。

6. 「ページ」で、次のステップを実行します。

1. 管理ページ番号: 未使用のページ番号を指定します。

2. ページ・モード: ページ・モードを選択します。詳細は、フィールドレベル・ヘルプを参照してください。

3. 「次へ」をクリックします。

7. 「ナビゲーションのプリファレンス」で、このページに含めるナビゲーションのタイプを指定し、「次へ」をクリックします。ナビゲーション・オプション(ナビゲーション・メニューまたはタブなど)はカレント・アプリケーションのテーマに応じて決まります。

8. ページを確認して、「作成」をクリックします。

20.3.3 アプリケーション・モードの選択とユーザーの追加

アクセス制御管理ページを実行し、アプリケーション・モードを選択してからアクセス制御リストへユーザーを追加することによって、アプリケーションへのアクセスを制御できます。

- アプリケーション・モードの選択

- アクセス制御リストへのユーザーの追加と権限の選択

- アクセス制御リストからのユーザーの削除

20.3.3.1 アプリケーション・モードの選択

アプリケーション・モードを選択するには、次のようにします。

1. アクセス制御リストを作成します。「アクセス制御リストの作成」を参照してください。
アクセス制御管理というページが作成されます。

2. アクセス制御管理ページを実行します。「アプリケーションまたはページの実行」を参照してください。

3. アプリケーション・モードで、次のオプションを選択します。

- すべての対象への完全なアクセス権。アクセス制御リストは使用されません。
すべてのユーザーがアプリケーションにアクセスできるようにするには、このオプションを選択します。

- 制限されたアクセス。アクセス制御リストに定義されたユーザーのみが許可されます。
アクセス制御リスト上のユーザーのみにアクセスを許可するには、このオプションを選択します。アクセス制御リスト上のユーザーのみが、認可スキームに関連付けられたページおよびコンポーネントを表示できます。

- パブリック読取り専用。アクセス制御リストによって制御される編集および管理の権限です。
アクセス制御 - 認可スキームの表示に関連付けられたページおよびコンポーネントに、パブリック・アクセスを提供します。

- 管理アクセス専用。
管理者権限を持つユーザーのみが、認可スキームに関連付けられたページまたはコンポーネントにアクセスできます。

4. 「アプリケーション・モードの設定」をクリックします。

ページのユーザー・インタフェースは、アプリケーションで選択したテーマによって異なります。「テーマの使用」を参照してください。

次は、アクセス制御リストにユーザーを追加します。

20.3.3.2 アクセス制御リストへのユーザーの追加と権限の選択

アクセス制御リストにユーザーを追加するには、次のようにします。

1. アクセス制御リストを作成します。「アクセス制御リストの作成」を参照してください。
アクセス制御管理というページが作成されます。

2. アクセス制御管理ページを実行します。「アプリケーションまたはページの実行」を参照してください。

3. アクセス制御リストの下で、「ユーザーの追加」をクリックします。
新しい行が表示されます。

4. 「ユーザー名」フィールドにユーザー名を入力します。

5. ユーザーに権限を関連付けます。使用可能なオプションは次のとおりです。

- 管理者

- 編集

- 表示

6. 「変更の適用」をクリックします。

7. すべてのユーザーに対して、ステップ1から5を繰り返します。

20.3.3.3 アクセス制御リストからのユーザーの削除

アクセス制御リストからユーザーを削除するには、次のようにします。

1. ユーザー名の左側のチェック・ボックスを選択して、削除するユーザーを選択します。

2. 「削除」をクリックします。

20.3.4 ページおよびページ・コンポーネントに対するアクセスの制御について

アクセス制御ウィザードでは、アプリケーション・モード・リストのオプションとアクセス制御リストで可能な権限に対応する認可スキームが作成されます。

次の認可スキームの中の1つをページまたはコンポーネント属性ページで選択することで、特定のページまたはページ・コンポーネントへのアクセスを制御できます。

- アクセス制御 - 管理者。管理者権限を持つユーザーのみがページまたはコンポーネントを表示できます。

- アクセス制御 - 編集。編集および管理者権限の両方を持つユーザーがページまたはコンポーネントを表示できます。表示権限を持つユーザーはページまたはコンポーネントを表示できません。

- アクセス制御 - 表示。管理者、編集または表示権限を持つユーザーがページまたはコンポーネントを表示できます。

- 非アクセス制御 - 管理者。管理者権限を持つユーザーはページまたはコンポーネントを表示できません。

- 非アクセス制御 - 編集。編集および管理者権限の両方を持つユーザーはページまたはコンポーネントを表示できません。表示権限を持つユーザーがページまたはコンポーネントを表示できます。

- 非アクセス制御 - 表示。管理者、編集または表示権限を持つユーザーはページまたはコンポーネントを表示できません。

関連項目:
「アプリケーション、ページまたはコンポーネントへの認可スキームの割当て」

20.4 認証によるユーザー・アイデンティティの証明

認証は、ユーザーがアプリケーションにアクセスする前に、そのユーザーの本人確認を行うプロセスです。この項では、認証を使用してユーザーのアイデンティティを証明する方法について説明します。

- 認証の理解

- 認証スキームの作成

- 事前構成済の認証スキームの理解

- 既存の認証スキームの管理

- アプリケーションに関連付けられた認証スキームの表示

- アプリケーションに関連付けられた認証スキームの変更

- ログイン・ページの作成

- 認証スキーム・レポートの表示

20.4.1 認証の理解

認証では、ユーザーにユーザー名とパスワードの指定を要求するか、またはデジタル証明書や保護キーを使用する可能性があります。

- 認証の仕組み

- ディープ・リンクのサポートについて

- 認証を含めるかどうかの決定について

20.4.1.1 認証の仕組み

アプリケーションがユーザーとどのように対話するかを決定します。すべてのユーザーが同じ権限を持つ場合、そのユーザーはパブリック・ユーザーとみなされます。ただし、アプリケーションが各ユーザーを個別に追跡する必要がある場合は、認証方式を指定する必要があります。

認証は、アプリケーションにアクセスする各ユーザーのアイデンティティの証明を行います。多くの認証プロセスで、ユーザーはなんらかの資格証明(ユーザー名とパスワードなど)を提供する必要があります。これらの資格証明は評価され、合格または不合格のいずれかとなります。資格証明が合格した場合、ユーザーはアプリケーションにアクセスできます。不合格の場合は、アクセスが拒否されます。

ユーザーの本人確認が行われると、Application Expressエンジンが組込み置換文字列APP_USERの値を設定して、各ユーザーを追跡します。ユーザーがページ間をナビゲートすると、Application ExpressエンジンがAPP_USERの値を設定して、本人確認を行います。Application Expressエンジンは、各ユーザーのセッション・ステートを追跡するための重要なコンポーネントとしてAPP_USERを使用します。

プログラミングの観点では、次の構文を使用してAPP_USERにアクセスできます。

- PL/SQLまたはSQLのいずれかのバインド変数として使用する場合

:APP_USER

- PL/SQLパッケージおよびトリガーを使用する場合

V('APP_USER')

- コンテキストAPEX$SESSIONの属性として使用する場合

sys_context('APEX$SESSION', 'APP_USER')

APP_USERを使用すると、独自のセキュリティ・チェックおよび条件付き処理を実行できます。たとえば、次の表を作成したと想定します。

CREATE TABLE my_security_table (
user_id   VARCHAR2(30),
privilege VARCHAR2(30));

表を作成したら、この表にユーザー権限情報を移入して、ページ、タブ、ナビゲーション・バー、ボタン、リージョン、または、その他のコントロールやコンポーネントの表示の制御に使用できます。

関連項目:
「APP_USER」および「セキュリティ属性の構成」

20.4.1.2 ディープ・リンクのサポートについて

認証スキームを使用するOracle Application Expressアプリケーションでは、ディープ・リンクがサポートされています。ディープ・リンクは、コンテキスト外(たとえば、電子メールのハイパーリンクまたはワークフロー通知から)のOracle Application Expressページにリンクする機能を指します。コンテキスト外のページにリンクし、そのアプリケーションでユーザー認証が必要な場合、ログイン・ページが表示されます。資格証明の検証後、Application Expressエンジンは元のリンクで参照されていたページを自動的に表示します。

20.4.1.3 認証を含めるかどうかの決定について

アプリケーションを作成する場合、認証を含めるかどうかを決定する必要があります。次の選択肢があります。

- 認証不要の選択。Oracle Application Expressはすべてのユーザーの資格証明をチェックしません。アプリケーションのすべてのページには、すべてのユーザーからアクセスできます。

- 組込み認証スキームの選択。使用可能な事前構成済の認証スキームに基づいて、認証方式を作成します。選択するスキームによっては、Oracle 10giAS、Oracle Internet Directoryまたは他の外部サービスの対応するコンポーネントを構成する必要もあります。詳細は、「事前構成済の認証スキームの理解」および「アプリケーションに関連付けられた認証スキームの変更」を参照してください。

- カスタム認証スキームの作成。カスタム認証方式を作成すると、認証インタフェースを完全に制御できます。この方法を実装するには、Application Expressエンジンが各ページ・リクエストを処理する前に実行するPL/SQLファンクションを提供する必要があります。このファンクションのブール戻り値によって、Application Expressエンジンが通常どおりにページを処理するか、または失敗ページを表示するかが決まります。「認可スキームの作成および編集」を参照してください。

20.4.2 認証スキームの作成

認証スキームを作成するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。
共有コンポーネント・ページが表示されます。

4. 「セキュリティ」で、「認証スキーム」を選択します。
認証スキーム・ページが表示されます。

5. ページ上部の検索バーを使用してページの概観をカスタマイズできます。詳細は、「検索バーについて」を参照してください。

6. 新しい認証スキームを作成するには、「作成」をクリックします。

7. 次のいずれかの項目を選択して、スキームの作成方法を指定します。

- 「ギャラリからの事前構成済スキームに基づく」。「事前構成済の認証スキームの理解」および「カスタム認証」を参照してください。

- 「既存の認証スキームのコピーとして」。

8. 画面に表示されるステップに従います。

20.4.3 事前構成済の認証スキームの理解

ギャラリから認証スキームを作成すると、標準動作の認証およびセッション管理を行う事前構成済認証スキームを選択できます。新しい認証スキームを作成すると、そのスキームは自動的に選択したアプリケーションのカレント認証スキームになります。この項では、Oracle Application Expressに付属するすべての事前構成済認証スキームについて説明します。

- Application Expressアカウント

- カスタム認証

- データベース・アカウント

- HTTPヘッダー変数

- LDAPディレクトリの検証

- 認証なし(DADを使用)

- 公開資格証明

- Oracle Application Server Single Sign-On Server

ヒント:
認証スキームはプラグインをサポートします。詳細は、「プラグインの実装」を参照してください。

20.4.3.1 Application Expressアカウント

この項では、Application Expressアカウント認証スキームを使用するタイミングおよびその構成方法について説明します。

- Application Expressアカウントについて

- Application Expressアカウント認証の設定

20.4.3.1.1 Application Expressアカウントについて

Application Expressアカウントは、Oracle Application Expressのユーザー・リポジトリで作成および管理されるユーザー・アカウントです。この方式を使用すると、これらのアカウントに対してアプリケーションが認証されます。

Application Expressアカウントは、次のような場合に有効です。

- ユーザー・アカウント・リポジトリを制御する場合。

- ユーザー名およびパスワードに基づいたセキュリティで十分な場合。

- シングル・サインオン・フレームワークへの統合が不要な場合。

この方法は特に、ユーザー・グループを新しいアプリケーションで迅速に起動および実行する必要がある場合に適しています。

関連項目:
『Oracle Application Express管理ガイド』の「Application Expressユーザーの管理」

20.4.3.1.2 Application Expressアカウント認証の設定

Application Expressアカウントを設定するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。
共有コンポーネント・ページが表示されます。

4. 「セキュリティ」で、「認証スキーム」を選択します。

5. 認証スキーム・ページで、「作成」をクリックします。

6. 「ギャラリからの事前構成済スキームに基づく」を選択し、「次へ」をクリックします。

7. 「名前」で、次の項目を指定します。

1. 名前: 他のアプリケーション開発者が認証スキームを参照するための名前を入力します。

2. スキーム・タイプ: 「Application Expressアカウント」を選択します。

3. 「作成」をクリックします。

20.4.3.2 カスタム認証

この項では、カスタム認証を使用するタイミングおよびその構成方法について説明します。

- カスタム認証について

- カスタム認証の設定

- セッション管理セキュリティについて

20.4.3.2.1 カスタム認証について

認証スキームを最初から作成すると、認証インタフェースを完全に制御できます。これは、次のいずれかに該当する場合に最適な方法です。

- データベース認証または他の方式が適切でない。

- 独自のログイン・フォームおよび関連方式を開発する必要がある。

- セッション管理のセキュリティ面を制御する必要がある。

- ユーザー・レベルまたはセッション・レベルでアクティビティを記録または監査する必要がある。

- セッションのアクティビティ制限または存続期限を施行する必要がある。

- Oracle Application Expressページ・プロセスの前に一方向の条件付きリダイレクト・ロジックをプログラムする必要がある。

- 一般的なセッション管理フレームワークを使用して、アプリケーションをOracle Application Express以外のアプリケーションと統合する必要がある。

- アプリケーションが、シームレス(たとえば、複数のアプリケーションID)に動作する複数のアプリケーションで構成されている。

ヒント:
複数のアプリケーションで同じ認証スキームの使用を計画している場合は、カスタム認証プラグインの記述を検討してください。「プラグインの実装」を参照してください。

20.4.3.2.2 カスタム認証の設定

カスタム認証スキームを作成するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。
共有コンポーネント・ページが表示されます。

4. 「セキュリティ」で、「認証スキーム」を選択します。

5. 認証スキーム・ページで、「作成」をクリックします。

6. 「ギャラリからの事前構成済スキームに基づく」を選択し、「次へ」をクリックします。

7. 「名前」で、次の項目を指定します。

1. 名前: 他のアプリケーション開発者が認証スキームを参照するための名前を入力します。

2. スキーム・タイプ: 「カスタム」を選択します。

8. 該当するフィールドに入力します。

9. 特定のフィールドの詳細は、フィールドレベル・ヘルプを参照してください。ヘルプが使用可能な場合は、カーソルをあわせると、アイテム・ラベルが疑問符付きに変わります。「フィールドレベル・ヘルプの表示」を参照してください。

10. 「作成」をクリックします。

20.4.3.2.3 セッション管理セキュリティについて

Oracle Application Expressは、カスタム認証を実行する際に、次の2つの不適切な状況が発生しないようにします。

- あるユーザーが、他のユーザーに属するセッション・ステートに故意にアクセスしようとすること。ただし、ユーザーは任意のアプリケーション・セッションIDをURLに入力できます。

- 失効したセッション・ステート(多くの場合、同じユーザーに属する以前のセッション・ステート)が不注意にアクセスされること。これは一般的に、アプリケーション・ページへのブックマークを使用したために発生します。

Oracle Application Expressは、カスタム認証ファンクションによって設定されたユーザーIDトークンが、アプリケーション・セッションが最初に作成された際に記録されたユーザーIDと一致するかどうかを確認します。ユーザーがまだ認証されておらず、ユーザーIDが認識されていない場合、アクセスをしているセッション・ステートは、他のユーザーに属していません。これらの確認によって、リクエスト内のセッションIDが使用可能かどうかが判断されます。セッションIDが使用不可能な場合、Application Expressエンジンは適切なセッションIDを使用して、同じページにリダイレクトします。

20.4.3.3 データベース・アカウント

この項では、データベース・アカウント資格証明認証を使用するタイミングおよびその構成方法について説明します。

- データベース・アカウント資格証明について

- データベース・アカウント資格証明の設定

20.4.3.3.1 データベース・アカウント資格証明について

データベース・アカウント資格証明は、データベース・スキーマ・アカウントを使用します。この認証スキームでは、データベース・ユーザー(スキーマ)はローカル・データベースに存在している必要があります。この方法を使用する場合、ユーザーの認証にデータベース・アカウントのユーザー名およびパスワードが使用されます。適用可能なアプリケーションの指定したユーザーごとに1つのデータベース・アカウントを持ち、ニーズに対応したデータベース・ツールによるアカウントのメンテナンスを行う場合は、データベース・アカウント資格証明を選択します。

20.4.3.3.2 データベース・アカウント資格証明の設定

データベース・アカウント資格証明を設定するには、次の手順を実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。
共有コンポーネント・ページが表示されます。

4. 「セキュリティ」で、「認証スキーム」を選択します。

5. 認証スキーム・ページで、「作成」をクリックします。

6. 「ギャラリからの事前構成済スキームに基づく」を選択し、「次へ」をクリックします。

7. 「名前」で、次の項目を指定します。

1. 名前: 他のアプリケーション開発者が認証スキームを参照するための名前を入力します。

2. スキーム・タイプ: 「データベース・アカウント」を選択します。

3. 「作成」をクリックします。

20.4.3.4 HTTPヘッダー変数

この項では、HTTPヘッダー変数認証を使用するタイミングおよびその構成方法について説明します。

- HTTPヘッダー変数について

- HTTPヘッダー変数の設定

20.4.3.4.1 HTTPヘッダー変数について

HTTPヘッダー変数は、ヘッダー変数を使用したユーザーの識別およびApplication Expressのユーザー・セッションの作成をサポートします。会社で、アプリケーションおよびテクノロジ全体でシングル・サインオンを実現するOracle Access Managerのような集中型Web認証ソリューションを使用する場合は、この認証スキームを使用します。これらのシステムによってユーザー資格証明検証が実行され、REMOTE_USER(デフォルト)のようなHTTPヘッダー変数を使用してOracle Application Expressにユーザー名が渡されます。

20.4.3.4.2 HTTPヘッダー変数の設定

HTTPヘッダー変数を設定するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。
共有コンポーネント・ページが表示されます。

4. 「セキュリティ」で、「認証スキーム」を選択します。

5. 認証スキーム・ページで、「作成」をクリックします。

6. 「ギャラリからの事前構成済スキームに基づく」を選択し、「次へ」をクリックします。

7. 「名前」で、次の項目を指定します。

1. 名前: 他のアプリケーション開発者が認証スキームを参照するための名前を入力します。

2. スキーム・タイプ: 「HTTPヘッダー変数」を選択します。

8. 該当するフィールドに入力します。

9. 特定のフィールドの詳細は、フィールドレベル・ヘルプを参照してください。「フィールドレベル・ヘルプの表示」を参照してください。

10. 「作成」をクリックします。

20.4.3.5 LDAPディレクトリの検証

この項では、LDAP資格証明認証を使用するタイミングおよびその構成方法について説明します。

- LDAPディレクトリの検証について

- LDAPディレクトリの検証の設定

20.4.3.5.1 LDAPディレクトリの検証について

ログイン・ページを使用する認証スキームは、Lightweight Directory Access Protocol(LDAP)を使用して、ログイン・ページで送信されるユーザー名およびパスワードを検証するように構成できます。

アプリケーション・ビルダーには、このオプションの構成方法を示すウィザードと編集ページが含まれています。これらのウィザードでは、この構成のために、ご使用のアプリケーションにアクセス可能なLDAPディレクトリがすでに存在していることと、LDAPディレクトリが資格証明の検証のSIMPLE_BIND_Sコールに応答できることを想定しています。LDAP資格証明の認証スキームを作成する場合、SSL、LDAPホスト名、LDAPポート、DN文字列、SSLの使用の有無、完全なDN、および完全なDNを使用しない場合のオプションの検索フィルタが要求され保存されます。オプションの事前処理ファンクションを指定して、APIに渡されるユーザー名の書式設定を調整できます。

20.4.3.5.2 LDAPディレクトリの検証の設定

LDAPディレクトリを設定するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。
共有コンポーネント・ページが表示されます。

4. 「セキュリティ」で、「認証スキーム」を選択します。

5. 認証スキーム・ページで、「作成」をクリックします。

6. 「ギャラリからの事前構成済スキームに基づく」を選択し、「次へ」をクリックします。

7. 「名前」で、次の項目を指定します。

1. 名前: 他のアプリケーション開発者が認証スキームを参照するための名前を入力します。

2. スキーム・タイプ: 「LDAPディレクトリ」を選択します。

8. 「設定」で、次のステップを実行します。

1. ホスト: LDAPディレクトリ・サーバーのホスト名を入力します。

2. ポート: LDAPディレクトリ・ホストのポート番号を入力します。デフォルト値は389です。

3. SSLの使用: LDAPディレクトリへのバインドにSSLを使用するかどうかを選択します。認証付きSSLを選択すると、Application Expressインスタンスに対してウォレットを構成する必要があります。

4. 識別名(DN)文字列: 完全なDNを使用する場合はDBMS_LDAP.SIMPLE_BIND_Sに完全修飾識別名(DN)文字列を構築するために使用されるパターンを、非完全なDNを使用する場合は検索ベースを入力します。%LDAP_USER%をユーザー名のプレースホルダとして使用します。次に例を示します。
完全なDN:

cn=%LDAP_USER%,l=amer,dc=yourdomain,dc=com

非完全なDN(検索ベース):

Non-Exact DN (Search Base)

5. 識別名(DN)の使用: LDAP識別名(DN)文字列が完全か非完全かを選択します。非完全の場合、LDAP識別名(DN)は検索ベースで、検索フィルタを指定する必要があります。

6. LDAPユーザー名編集ファンクション: ユーザー名をLDAPディレクトリ・エントリまたはLDAPユーザー名に最適な形式に変換するために実行される追加コードを指定できます。バインド変数:USERNAMEには、エンド・ユーザーが指定した名前が含まれます。たとえば、次のコードでは、DN文字列のすべてのピリオド(.)をアンダースコア(_)に置換する関数がコールされます。

return apex_custom_auth.ldap_dnprep(p_username => :USERNAME);

7. ユーザー名エスケープ: Oracle Application Expressが%LDAP_USER%で特殊文字をエスケープする方法を選択します。この属性の適切な値は、使用するLDAPサーバーおよびLDAPユーザー名編集ファンクションがすでに特殊文字をエスケープしているかどうかによって異なります。

9. 特定のフィールドの詳細は、フィールドレベル・ヘルプを参照してください。「フィールドレベル・ヘルプの表示」を参照してください。

10. 「作成」をクリックします。

注意:
SSLモードとして「認証付きSSL」を選択する場合は、Oracle Application Expressのインスタンス設定を使用してウォレットを設定する必要があります。また、LDAPサーバーのルート証明書を信頼できる証明書としてこのウォレットにインポートする必要があります。詳細は、『Oracle Application Express管理ガイド』の「ウォレット情報の構成」および『Oracle Database Advanced Securityガイド』の「Oracle Wallet Managerの使用」を参照してください。

20.4.3.6 認証なし(DADを使用)

この項では、データベース・アクセス記述子(DAD)データベース認証を使用するタイミングおよびその構成方法について説明します。

- DAD資格証明の検証について

- DAD資格証明の検証の設定

20.4.3.6.1 DAD資格証明の検証について

DAD資格証明の検証では、Oracleデータベース・ネイティブ認証およびユーザー・メカニズムを使用し、基本認証スキームを使用してユーザーを認証します。この認証スキームでは、DAD構成に格納された値か、アカウント情報がDAD構成に格納されていない場合はBasic認証要求を使用して取得されるユーザー名のいずれかとして、データベース・アクセス記述子(DAD)からユーザー名が取得されます。

DAD資格証明の検証を使用するには、次の条件を満たす必要があります。

- 各アプリケーション・ユーザーが、Oracle Databaseにユーザー・アカウントを持っている。

- Basic認証用のPL/SQL DADを構成している(アカウント情報なし)。
これによって、アプリケーション・ユーザーは、ブラウザ・セッションごとに1回ユーザー名/パスワードを要求されます。その後、ユーザー・アイデンティティ・トークンがAPP_USERアイテム内で使用可能になります。

DADデータベース認証は、管理可能な数のユーザーに対して最小限の設定のみが必要な認証方式を実装する場合に役立ちます。これらのユーザーがデータベース内に自己管理されたアカウントを持っており、この認証方式を短期間(たとえば、開発のデモンストレーションまたはプロトタイプ段階の間)のみ使用することが理想です。

この方法の主なデメリットは、特にユーザーが自分のパスワードを管理していないか、またはユーザーのデータベース・アカウントがアプリケーションへの認証を容易化するためのみに存在している場合に、アカウントのメンテナンスが負担となることです。

20.4.3.6.2 DAD資格証明の検証の設定

DAD資格証明の検証を設定するには、次の手順を実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。
共有コンポーネント・ページが表示されます。

4. 「セキュリティ」で、「認証スキーム」を選択します。

5. 認証スキーム・ページで、「作成」をクリックします。

6. 「ギャラリからの事前構成済スキームに基づく」を選択し、「次へ」をクリックします。

7. 「名前」で、次の項目を指定します。

1. 名前: 他のアプリケーション開発者が認証スキームを参照するための名前を入力します。

2. スキーム・タイプ: 「認証なし(DADを使用)」を選択します。

8. 「作成」をクリックします。

20.4.3.7 公開資格証明

この項では、公開資格証明を使用するタイミングおよびその構成方法について説明します。

- 公開資格証明について

- 公開資格証明の設定

20.4.3.7.1 公開資格証明について

公開資格証明を使用すると、ユーザー名を取得する組込みログイン・ページを使用して、自分のアプリケーションがすべてのユーザーからアクセス可能になります。この認証方式は、アプリケーションの開発時に有用です。

20.4.3.7.2 公開資格証明の設定

公開資格証明を設定するには、次の手順を実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。
共有コンポーネント・ページが表示されます。

4. 「セキュリティ」で、「認証スキーム」を選択します。

5. 認証スキーム・ページで、「作成」をクリックします。

6. 「ギャラリからの事前構成済スキームに基づく」を選択し、「次へ」をクリックします。

7. 「名前」で、次の項目を指定します。

1. 名前: 他のアプリケーション開発者が認証スキームを参照するための名前を入力します。

2. スキーム・タイプ: 「公開資格証明」を選択します。

8. 「作成」をクリックします。

20.4.3.8 Oracle Application Server Single Sign-On Server

この項では、Oracle Application Server Single Sign-Onの検証を使用するタイミングおよびその構成方法について説明します。

- Application Server Single Sign-On Serverについて

- Oracle Application Server Single Sign-Onの設定

20.4.3.8.1 Application Server Single Sign-On Serverについて

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)インフラストラクチャでパートナ・アプリケーションとして実行できます。Oracle Application Serverのパートナ・アプリケーションの登録手順に従い、アプリケーション(またはApplication Expressエンジン)をパートナ・アプリケーションとして登録し、Oracle 9iAS SSO Software Developer Kit (SDK)をインストールする必要があります。

この方法を選択する場合、ご使用のアプリケーションでは統合されたログイン・ページが使用されません。かわりに、ユーザーが新しいブラウザ・セッションでアプリケーションにアクセスすると、Application ExpressエンジンによってSingle Sign-Onログイン・ページにリダイレクトされます。ユーザーがSSOによって認証されると、SSOコンポーネントはアプリケーションにリダイレクトし、Application Expressエンジンにユーザー・アイデンティティおよびその他の情報を渡します。その後、ユーザーはログオフするか、ブラウザ・セッションを終了するか、またはその他のセッション終了イベントが発生するまでアプリケーションを使用できます。

20.4.3.8.2 Oracle Application Server Single Sign-Onの設定

Oracle Application Server Single Sign-Onを設定するには、次の手順を実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。
共有コンポーネント・ページが表示されます。

4. 「セキュリティ」で、「認証スキーム」を選択します。

5. 認証スキーム・ページで、「作成」をクリックします。

6. 「ギャラリからの事前構成済スキームに基づく」を選択し、「次へ」をクリックします。

7. 「名前」で、次の項目を指定します。

1. 名前: 他のアプリケーション開発者が認証スキームを参照するための名前を入力します。

2. スキーム・タイプ: 「Oracle Application Server Single Sign-On」を選択します。

8. 該当するフィールドに入力します。

9. 特定のフィールドの詳細は、フィールドレベル・ヘルプを参照してください。「フィールドレベル・ヘルプの表示」を参照してください。

10. 「作成」をクリックします。

20.4.4 既存の認証スキームの管理

認証スキームを作成すると、使用可能な認証スキームが認証スキーム・リポジトリに表示されます。

認証スキーム・リポジトリにナビゲートするには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。
共有コンポーネント・ページが表示されます。

4. 「セキュリティ」で、「認証スキーム」を選択します。

5. ページ上部の検索バーを使用してページの概観をカスタマイズできます。詳細は、「検索バーについて」を参照してください。

6. レポートとして特定の認証スキームを編集するには、認証スキーム名の左側にある「編集」アイコンをクリックします。
認証スキーム・ページが表示されます。

7. 特定のフィールドの詳細は、フィールドレベル・ヘルプを参照してください。「フィールドレベル・ヘルプの表示」を参照してください。

8. 該当する属性を編集し、「変更の適用」をクリックします。

20.4.5 アプリケーションに関連付けられた認証スキームの表示

アプリケーションのカレント認証スキームを表示するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「セキュリティ」で、「セキュリティ属性」をクリックします。

5. 「認証」セクションに移動します。カレント認証スキームが「認証スキーム」の横に表示されます。

6. 認証スキームを編集するには、「認証スキームの定義」。

20.4.6 アプリケーションに関連付けられた認証スキームの変更

アプリケーションの認証スキームを変更するには、次のステップを実行します。

1. 「認証スキーム」にナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。
共有コンポーネント・ページが表示されます。

4. 「セキュリティ」で、「認証スキーム」を選択します。

2. アクティブ化する認証スキームの横の「編集」アイコンをクリックします。
作成/編集ページが表示されます。

3. 「カレント・スキームにする」をクリックします。

関連項目:
「事前構成済の認証スキームの理解」

20.4.7 ログイン・ページの作成

Oracle Application Expressでアプリケーションを作成すると、ログイン・ページが作成されます。ページの別名は、LOGINです。このページは、認証スキームで無効なセッション・ページとして使用できます。このページは、Oracle Application ExpressのログインAPIをコールするプロセスを使用して、資格証明の検証およびセッションの登録を実行するように構成されています。

事前に構築されたモデル・ページを使用して、すべてのユーザー・インタフェースを調整し、要件に対してロジックを加工して、独自のログイン・ページを構築することもできます。

アプリケーションのログイン・ページを作成するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「ページの作成」をクリックします。

4. 「ページの作成」で、次のステップを実行します。

1. ユーザー・インタフェース: ページのユーザー・インタフェースを選択します。

2. ページ・タイプの選択: 「ログイン・ページ」を選択します。

3. 「次へ」をクリックします。

5. 「ログイン・ページ」を選択します。

6. ログイン・ページ属性を指定して、「作成」をクリックします。

20.4.8 認証スキーム・レポートの表示

認証スキーム・レポートを表示するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。
共有コンポーネント・ページが表示されます。

4. 「セキュリティ」で、「認証スキーム」を選択します。

5. ページ上部の該当するタブをクリックします。

- サブスクリプション - 「認証スキームのサブスクリプション」レポートを使用すると、アプリケーションのサブスクライブされた認証スキームを表示できます。

- 履歴 - 「認証スキーム履歴」レポートを使用すると、このアプリケーションのアイテムに最近行われた変更を表示できます。

20.5 認可を介したセキュリティの提供

認可は、ユーザー権限に基づいてリソースへのアクセスを制御することを示す広義語です。条件は特定のページ・コントロールまたはページ・コンポーネントのレンダリングおよび処理を制御しますが、認可スキームは特定のコントロールまたはコンポーネントへのユーザーのアクセスを制御します。

- 認可スキームの動作方法

- 認可スキームの作成および編集

- アプリケーション、ページまたはコンポーネントへの認可スキームの割当て

- 認可レポートの表示

20.5.1 認可スキームの動作方法

認可スキームは、アプリケーションの認証スキームのセキュリティを強化します。認可スキームは、アプリケーション全体、各ページ、またはリージョン、アイテム、ボタンなどの特定のコントロールに対して指定できます。たとえば、認可スキームを使用して、ユーザーに表示するタブ、リージョンまたはナビゲーション・バーを選択的に決定できます。

認可スキームの結果は、成功または失敗のいずれかです。認可スキームの一般的なタイプには、「EXISTS」、「NOT EXISTS SQL問合せ」および「ブールを戻すPL/SQLファンクション」が含まれます。コンポーネントまたはコントロール・レベルの認可スキームに成功すると、そのコンポーネントまたはコントロールがユーザーに表示されます。失敗すると、そのコンポーネントまたはコントロールはユーザーに表示されません。アプリケーション・レベルまたはページ・レベルの認可スキームに失敗すると、Oracle Application Expressは事前定義済のメッセージを表示します。

認可スキームを定義する場合は、一意の名前を指定します。定義した認可スキームは、アプリケーションのコンポーネントまたはコントロールに割り当てることができます。アプリケーションのコンポーネントまたはコントロールに認可スキームを割り当てるには、該当する属性ページにナビゲートして、「認可スキーム」リストから認可スキームを選択するのみです。

20.5.2 認可スキームの作成および編集

この項では、認可スキームを作成および編集する方法について説明します。認可スキームは、アプリケーションまたはアプリケーション・コンポーネントまたはコントロールに割り当てる前に作成する必要があります。

- 認可スキームの作成

- 既存の認可スキーム属性の編集

- 評価ポイント属性の変更

- 認可スキーム・ステートのリセット

20.5.2.1 認可スキーム・タイプについて

認可スキームを作成する場合、認可スキーム・タイプを選択します。認可スキーム・タイプにより、認可スキームの適用方法が決まります。開発者は、新しい認可タイプ・プラグインを作成して、このリストを拡張できます。

表20-1 認可スキーム・タイプ

認可スキーム・タイプ

説明

EXISTS SQL問合せ

認可スキームが1行以上を戻す場合は合格、行を戻さない場合は不合格となる問合せを入力します

NOT EXISTS SQL問合せ

認可スキームが行を戻さない場合は合格、1行以上を戻す場合は不合格となる問合せを入力します

ブールを戻すPL/SQLファンクション

ファンクション本体を入力します。ファンクションがtrueを戻す場合、認可は成功します。

式1のアイテムがNULL

アイテム名を入力します。アイテムがnullの場合、認可は成功します。

式1のアイテムがNOT NULL

アイテム名を入力します。アイテムがnullでない場合、認可は成功します。

式1のアイテムの値 = 式2

アイテム名と値を入力します。アイテムの値が認可値と等しい場合、認可は成功します。

式1のアイテムの値 != 式2

アイテム名と値を入力します。アイテムの値が認可値と等しくない場合、認可は成功します。

式1のプリファレンスの値 != 式2

プリファレンス名と値を入力します。プリファレンスの値が認可値と等しくない場合、認可は成功します。

式1のプリファレンスの値 = 式2

プリファレンス名と値を入力します。プリファレンスの値が認可値と等しい場合、認可は成功します。

グループ内

グループ名を入力します。グループがセッションの動的グループとして有効な場合、認可は成功します。『Oracle Application Express APIリファレンス』のAPEX_AUTHORIZATION.ENABLE_DYNAMIC_GROUPSに関する項を参照してください。

アプリケーションでApplication Expressアカウント認証が使用される場合、このチェックにはユーザーに付与されたワークスペース・グループも含まれます。アプリケーションでデータベース認証が使用される場合、このチェックにはユーザーに付与されたデータベース・ロールも含まれます。

グループ内にない

グループ名を入力します。グループがセッションの動的グループとして有効でない場合、認可は成功します。

20.5.2.2 認可スキームの作成

認可スキームを作成するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。
共有コンポーネント・ページが表示されます。

4. 「セキュリティ」で、「認可スキーム」を選択します。

5. 「作成」をクリックします。

6. 次のいずれかの項目を選択して、認可スキームの作成方法を指定します。

- 最初から

- 既存の認可スキームのコピーとして

7. 認可スキームの作成 - 詳細で、次のステップを実行します。

1. 名前 - この認可スキームを識別する一意の名前を入力します。

2. スキーム・タイプ - この認可スキームが適用される方法を選択します。「認可スキーム・タイプについて」を参照してください。

3. スキームの違反時に表示されるエラー・メッセージの指定 - 認可スキームが失敗した(つまり、カレント・ユーザーがセキュリティ・チェックに失敗した)場合に表示されるエラー・テキストを入力します。

4. 認可スキームの検証 - 認可スキームはセッションの最初の使用時に評価されます。その後の使用で再評価するかどうか、およびメモリーに保存された結果をいつ取得できるかを制御するには、このオプションを使用します。

詳細は、フィールドレベル・ヘルプを参照してください。「フィールドレベル・ヘルプの表示」を参照してください。

8. 「認可スキームの作成」をクリックします。

関連項目:
「アプリケーション、ページまたはコンポーネントへの認可スキームの割当て」、「評価ポイント属性の変更」および「認可スキーム・ステートのリセットについて」

20.5.2.3 既存の認可スキーム属性の編集

既存の認可スキームの属性を編集するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。
共有コンポーネント・ページが表示されます。

4. 「セキュリティ」で、「認可スキーム」を選択します。
認可スキーム・ページが表示されます。デフォルトでは、各スキームがアイコンとして表示されます。ページ上部の検索バーを使用してページの概観をカスタマイズできます。詳細は、「検索バーについて」を参照してください。

5. 認可スキームを選択します。

6. 対象となる属性を編集します。
詳細は、フィールドレベル・ヘルプを参照してください。「フィールドレベル・ヘルプの表示」を参照してください。

7. 変更を保存するには、「変更の適用」をクリックします。

20.5.2.4 評価ポイント属性の変更

「評価ポイント」、「認可スキームの検証」属性を使用して、認可スキームを検証するタイミングを制御できます。

認可スキームの評価ポイントを変更するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。
共有コンポーネント・ページが表示されます。

4. 「セキュリティ」で、「認可スキーム」を選択します。
認可スキーム・ページが表示されます。

デフォルトでは、各スキームがアイコンとして表示されます。ページ上部の検索バーを使用してページの概観をカスタマイズできます。詳細は、「検索バーについて」を参照してください。

5. 認可スキームを選択します。

6. 「評価ポイント」までスクロールして、「認可スキームの検証」属性を編集します。オプションは次のとおりです。

- セッションごとに1回 - 1回のみ評価し、その後は常にメモリーに保存された結果を使用します。

- ページ・ビューごとに1回 - 処理されるリクエストごとに1回評価します。認可スキームがページ上の複数のコンポーネントで参照される場合は、メモリーに保存された結果を使用します。

- コンポーネントごとに1回 - 認可スキームを参照するコンポーネントごとに1回評価しますが、結果をセッションに保存します。スキームのレンダリングまたは処理に対する以降のリクエストでは、コンポーネントについて記憶された結果を使用します。

- 常時(キャッシュなし) - 認可スキームは常に評価されます。

詳細は、フィールドレベル・ヘルプを参照してください。「フィールドレベル・ヘルプの表示」を参照してください。

7. 変更を保存するには、「変更の適用」をクリックします。

ヒント:
デフォルト値の「セッションごとに1回」が最も効率的です。認可チェックが、セッション・ステートの変化やセッション全体で一貫しない他の要因に依存する場合は、別の値を選択する必要があります。

20.5.2.5 認可スキーム・ステートのリセットについて

認可スキームがセッションごとに1回検証される場合、Oracle Application Expressは各ユーザーのセッション・キャッシュ内に検証結果をキャッシュします。セッションの認可スキーム・ステートは、APEX_AUTHORIZATION.RESET_CACHE APIをコールしてリセットできます。

関連項目:
『Oracle Application Express APIリファレンス』のAPEX_AUTHORIZATION.RESET_CACHEプロシージャに関する説明

20.5.3 アプリケーション、ページまたはコンポーネントへの認可スキームの割当て

作成した認可スキームは、アプリケーション全体、ページ、コントロールまたはコンポーネントに割り当てることができます。

- アプリケーションへの認可スキームの割当て

- ページへの認可スキームの割当て

- コントロールまたはコンポーネントへの認可スキームの割当て

20.5.3.1 アプリケーションへの認可スキームの割当て

認可スキームをアプリケーションに割り当てるには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」アイコンをクリックします。
共有コンポーネント・ページが表示されます。

4. 「セキュリティ」で、「セキュリティ属性」をクリックします。

5. 「認可」までスクロールして、「認可スキーム」リストから認可スキームを選択します。

6. パブリック・ページで実行で、(つまり、認可を必要としないページ)で、アプリケーション・レベルの認可スキームをチェックするかどうかを指定するには、「はい」または「いいえ」を選択します。詳細は、「認可」を参照してください。

7. 新しい認可スキームを定義するには、「認可スキームの定義」をクリックします。

20.5.3.2 ページへの認可スキームの割当て

認可スキームをページに割り当てるには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. ページを選択します。

4. 編集ページにアクセスするには、次の操作を実行します。

- ツリー・ビュー: 「ページ・レンダリング」で、ツリーの上部のページ・タイトルをダブルクリックします。

- コンポーネント・ビュー: 「ページ」で、ページ名をクリックします。

5. 「セキュリティ」までスクロールして、「認可スキーム」リストから認可スキームを選択します。

20.5.3.3 コントロールまたはコンポーネントへの認可スキームの割当て

認可スキームをページ・コンポーネントまたはコントロールに割り当てるには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. ページを選択します。

4. 認可スキームを適用するコンポーネントまたはコントロールの名前をクリックします。

5. 「セキュリティ」までスクロールして、「認可スキーム」リストから認可スキームを選択します。

20.5.4 認可レポートの表示

認可スキームのサブスクリプションおよび認可スキームの使用率レポートを使用すると、アプリケーション内の認可スキームをより効率的に管理できます。

認可スキーム・レポートを表示するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。
共有コンポーネント・ページが表示されます。

4. 「セキュリティ」で、「認可スキーム」を選択します。

5. ページ上部の該当するタブをクリックします。

- サブスクリプション - 認可スキームのサブスクリプション・レポートを使用して、認可スキームのサブスクリプションの詳細を表示します。

- コンポーネント別 - コンポーネント別レポートを使用すると、認可スキームに関連するこのアプリケーション内のすべてのコンポーネントが表示されます。レンダリングするコンポーネントには、コンポーネント・レベル、ページ・レベルおよびアプリケーション・レベルにある認可スキームを渡す必要があります。

- 使用率 - 認可スキームの使用率レポートを使用して、認可スキームの使用率の詳細を表示します。
ページの認可スキームの有無を示す詳細レポートを表示するには、「タスク」リストから次のいずれかを選択します。

- 認可スキームが指定されているレポート・ページ

- 認可スキームが指定されていないレポート・ページ

- 履歴 - 認可スキーム履歴レポートを使用すると、このアプリケーションの認可スキームに最近行われた変更が表示されます。

21 アプリケーションのグローバリゼーションの管理

アプリケーション・ビルダーで構築したアプリケーションを同時に複数の言語で実行できます。このセクションでは、アプリケーション・ビルダーで構築したアプリケーションを翻訳する方法を説明します。

- アプリケーション翻訳およびグローバリゼーション・サポートの理解

- アプリケーションへのプライマリ言語の指定

- 翻訳プロセスの理解

- メッセージの翻訳

- LOVをサポートするデータの翻訳

- サポートされるグローバリゼーション・コードの理解

関連項目:
Oracle Application Express管理ガイドの「インストール済の翻訳の表示」

21.1 アプリケーション翻訳およびグローバリゼーション・サポートの理解

アプリケーション・ビルダーで、同時に異なる言語で実行可能なアプリケーションを開発できます。1つのOracle DatabaseインスタンスとOracle Application Expressで、異なる言語をサポートするようにカスタマイズされた複数のデータベース・セッションをサポートできます。

- 翻訳プロセスについて

- 言語の指定について

- データベース・アプリケーションの翻訳ルールについて

- 翻訳済アプリケーションのレンダリング方法

- アプリケーション属性を翻訳可能に指定

21.1.1 翻訳プロセスについて

一般的に、アプリケーション・ビルダーで構築したアプリケーションの翻訳は、次のようなステップになります。

- ステップ1 - プライマリおよびターゲットのアプリケーションIDをマップします。

- ステップ2 - 翻訳用のファイルにテキストをシードおよびエクスポートします。

- ステップ3 - ファイルのテキストを翻訳します。

- ステップ4 - 翻訳済ファイルを適用します。

- ステップ5 - 翻訳済ファイルを公開します。

関連項目:
「翻訳プロセスの理解」

21.1.2 言語の指定について

アプリケーションの作成後、言語プリファレンスを指定します。次に、プライマリ・アプリケーションの言語を選択し、Application Expressエンジンによるアプリケーション言語の決定方法を決定します。アプリケーションのプライマリ言語は静的にすることも、Webブラウザ言語から導出したり、ユーザー・プリファレンスやアイテムから特定することもできます。

関連項目:
「アプリケーションへのプライマリ言語の指定」

21.1.3 データベース・アプリケーションの翻訳ルールについて

次のルールを使用して、使用する翻訳のバージョンを決定します。

- ユーザーの言語プリファレンスに完全一致する言語コードの翻訳済アプリケーションを検索します。

- 部分一致を検索します。つまり、言語およびロケールが存在するかどうかを確認します。たとえば、ユーザーの言語プリファレンスがen-usで、en-usの翻訳済バージョンが存在しない場合は、言語コードがenの翻訳済アプリケーションを検索します。

- アプリケーションのプライマリ言語を使用します。

たとえば、プライマリ言語がドイツ語(de)のアプリケーションを作成し、言語コードがen-usの翻訳バージョンを作成すると想定します。ユーザーがブラウザ言語en-usを使用してこのアプリケーションにアクセスすると、英語(en-us)バージョンのアプリケーションが実行されます。ユーザーがブラウザ言語en-gbを使用してこのアプリケーションにアクセスすると、アプリケーションがプライマリ言語(つまりドイツ語)で表示されます。この例では、enのすべてのバリエーションに対応するために、言語コードenを使用して英語の翻訳バージョンを作成する必要があります。

21.1.4 翻訳済アプリケーションのレンダリング方法

Oracle Application Expressがアプリケーションの言語を決定した後、Application Expressエンジンは、特定のページ・リクエストに対してデータベース言語を変更します。その後、適切な言語に翻訳されたアプリケーションを検索します。Application Expressエンジンはその言語を検出すると、その定義を使用してアプリケーションをレンダリングします。それ以外の場合は、ベース(プライマリ)のアプリケーション言語でアプリケーションをレンダリングします。

アプリケーション内に表示されるテキストは、すぐには翻訳されないことに注意してください。Oracle Application Expressは、ベース言語アプリケーション定義または代替アプリケーション定義のいずれかから動的にページ属性を収集します。

関連項目:
「テキスト文字列の動的翻訳について」および「LOVをサポートするデータの翻訳」

21.1.5 アプリケーション属性を翻訳可能に指定

Application Builderでアプリケーションを作成する際、フィールド・ラベル、リージョン・ヘッダー、ページ・ヘッダー・テキストなど、多数の宣言的な属性を定義します。この項では、アプリケーション内でアプリケーション属性を翻訳可能にする方法に関するベスト・プラクティスについて説明します。

- メッセージの言語変換をサポートするショートカットについて

- メッセージについて

- テキスト文字列の動的翻訳について

- リージョン・タイトルの翻訳について

- 翻訳テンプレートについて

21.1.5.1 メッセージの言語変換をサポートするショートカットについて

Application Builderには、翻訳可能なメッセージを参照できる2つのタイプのショートカットがあります。

- メッセージ: このショートカットを使用して、実行時に変換可能なメッセージを参照します。ショートカット名は、対応するメッセージ名と一致させる必要があります。実行時、ショートカット名は、現在の言語に翻訳可能なメッセージのテキストに展開されます。

- JavaScriptにより一重引用符がエスケープされたメッセージ: このショートカットを使用し、JavaScriptリテラル文字列内部のショートカットを参照し、実行時に翻訳可能なメッセージを参照します。このショートカットは、テキスト文字列を定義します。ショートカットが参照されると、JavaScriptに必要な一重引用符がエスケープされます。

関連項目:
「ショートカットの使用」

21.1.5.2 メッセージについて

アプリケーションにPL/SQLリージョンまたはPL/SQLプロセスが含まれている場合には、生成されるHTMLまたはテキストを翻訳する必要があります。また、Oracle Application Expressが翻訳されている10の言語以外の言語をアプリケーションで使用する場合、レポートで使用されるメッセージの翻訳が必要な場合もあります。

関連項目:
「メッセージの翻訳」

21.1.5.3 テキスト文字列の動的翻訳について

動的翻訳は、実行時に翻訳する必要があるデータベース・データに使用します。たとえば、動的翻訳を使用して、データベース問合せに基づくLOVを翻訳する場合があります。動的翻訳は、翻訳元の言語文字列、言語コードおよび翻訳先の文字列で構成されています。また、APEX_LANG.LANG APIを使用して、動的翻訳をプログラム的に取得できます。

関連項目:
「LOVをサポートするデータの翻訳」

21.1.5.4 リージョン・タイトルの翻訳について

デフォルトでは、ページ・リージョン・タイトルは、生成された翻訳ファイルに含まれます。ただし、リージョン・タイトルは、翻訳不可と指定できます。

- ページ・デザイナでリージョンを翻訳不可に指定

- ページ・デザイナでリージョンを翻訳不可に指定

21.1.5.4.1 ページ・デザイナでリージョンを翻訳不可に指定

リージョン・タイトルを翻訳不可と指定するには、次のステップを実行します。

1. ページ・デザイナで適切なページにナビゲートします。「ページ・デザイナでのページの表示」を参照してください。
ページ・デザイナが表示されます

2. 「レンダリング」ツリーで、リージョンを選択します。
プロパティ・エディタにリージョン属性が表示されます。

3. 「詳細」セクションを展開します。

4. 「タイトルを翻訳から除外」で、「はい」を選択します。

5. 「保存」をクリックします。

21.1.5.4.2 コンポーネント・ビューでリージョンを翻訳不可に指定

リージョン・タイトルを翻訳不可と指定するには、次のステップを実行します。

1. コンポーネント・ビューでページにナビゲートします。「コンポーネント・ビューの使用」を参照してください。

2. ページで、リージョン・タイトルを選択します。
リージョンの編集ページが表示されます。

3. 「指定」で、「タイトルを翻訳から除外」チェック・ボックスを選択します。

21.1.5.5 翻訳テンプレートについて

デフォルトでは、テンプレートは翻訳可能ではないため、生成された翻訳ファイルには含まれません。通常、テンプレートには翻訳可能なテキストを含めません。ただし、テンプレートを翻訳可能として指定する必要がある場合は、ページ・テンプレートの編集ページで、「翻訳可能」チェック・ボックスを選択します。

テンプレートを翻訳可能として指定するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

4. 「ユーザー・インタフェース」で、「テンプレート」を選択します。
テンプレート・ページが表示されます。

5. 編集するテンプレートを検索して、テンプレート名を選択します。

6. 「名前」の下で「翻訳可能」を選択します。

静的置換文字列を使用して翻訳可能なテキストを定義することで、翻訳可能なテキストをアプリケーション・レベルで含めることができます。アプリケーション・レベル属性は翻訳されるため、静的置換文字列として定義された任意のテキストは、生成された翻訳ファイルに含まれます。

関連項目:
「カスタム・テーマの作成」および「置換」

21.2 アプリケーションへのプライマリ言語の指定

グローバリゼーション属性は、Application Expressエンジンによるアプリケーションのプライマリ言語の決定方法を指定します。

グローバリゼーション属性を編集するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「グローバリゼーション」で、「グローバリゼーション属性」を選択します。

5. 「アプリケーションのプライマリ言語」で、アプリケーションが開発されている言語を選択します。

6. 「アプリケーション言語の導出元」で、Application Expressエンジンによるアプリケーション言語の決定(導出)方法を指定します。アプリケーションのプライマリ言語は静的にすることも、Webブラウザ言語から導出したり、ユーザー・プリファレンスやアイテムから特定することもできます。表21-1に、利用できるオプションを示します。

表21-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セッション言語はAPEX_UTIL.SET_SESSION_LANGプロシージャを使用するか、URLで"f" procedureのp_langパラメータを使用して設定できます。

7. 必要に応じて他のオプションを構成します。属性の詳細は、フィールドレベル・ヘルプを参照してください。

8. 「変更の適用」をクリックします。

関連項目:
「アプリケーション属性の編集」、「セキュリティ属性の構成」および「サポートされるグローバリゼーション・コードの理解」

21.2.1 アイテムの書式マスクの使用

この項では、アイテムの書式マスクの使用方法について説明します。

- アイテムへの書式マスクの適用について

- アイテム属性の編集例

21.2.1.1 アイテムへの書式マスクの適用について

Application Expressエンジンは、レンダリングされた各ページにグローバリゼーション設定を適用します。デフォルトの動作は、数字や日付などの特定のアイテムの表示に影響する可能性があります。

たとえば、ユーザーのブラウザの言語設定に基づいて、アプリケーション言語を決定するとします。Application Expressエンジンが、ユーザーのブラウザの言語設定をフランス語と決定した場合、日付および数字は、フランス語の標準に合わせた書式で表示されます。書式マスクを適用することによって、このデフォルトの動作をオーバーライドし、アイテムの表示方法を明示的に制御できます。「表示形式」リストから選択して、書式マスクを適用します。

- アイテム作成時。

- アイテム属性を編集してアイテムを作成した後。

21.2.1.2 アイテム属性の編集例

次の項では、データベース列のソース・タイプを持つアイテムのアイテム属性の編集方法について説明します。

アイテム属性を編集するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 適切なページにナビゲートします。「コンポーネント・ビューでのページの表示」を参照してください。

4. アイテムを選択します。
「ページ・アイテムの編集」ページが表示されます。

5. 「名前」の下で、「表示形式」リストから選択します。

6. 「ソース」の「書式マスク」で、書式マスクを選択するか入力します。

21.2.2 マルチバイト言語用のアプリケーション翻訳について

アプリケーションを複数の言語(中国語と日本語など)で同時に実行する必要がある場合、すべての言語をサポートするキャラクタ・セットを使用してデータベースを構成することを検討してください。UTF8およびAL32UTF8は、ほぼすべての言語をサポートするために使用できるキャラクタ・セットです。

21.3 翻訳プロセスの理解

この項では、アプリケーションの翻訳プロセスについて説明します。アプリケーション・ビルダーで開発したアプリケーションを翻訳するには、プライマリおよびターゲット言語をマップし、テキストを翻訳ファイルにシードおよびエクスポートし、テキストを翻訳し、翻訳ファイルを適用し、翻訳済アプリケーションを公開する必要があります。

- ステップ1: ターゲット言語のマップ

- ステップ2: 翻訳ファイルへのシードおよびダウンロード

- ステップ3: XLIFFファイルの翻訳

- ステップ4: 翻訳済XLIFFドキュメントのアップロードおよび適用

- ステップ5: アプリケーションのパブリッシュ

- 翻訳の手動編集

関連項目:
「メッセージの翻訳」および「LOVをサポートするデータの翻訳」

21.3.1 ステップ1: ターゲット言語のマップ

アプリケーション翻訳の最初のステップは、プライマリおよびターゲットのアプリケーション言語をマップすることです。プライマリ・アプリケーションは、翻訳されるアプリケーションです。ターゲット・アプリケーションは、翻訳結果のアプリケーションです。

プライマリおよびターゲットのアプリケーション言語をマップするには、次のステップを実行します。

1. アプリケーションの翻訳ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「グローバリゼーション」の下で「アプリケーションの翻訳」をクリックします。
翻訳ページが表示されます。

2. 「翻訳されたアプリケーションにプライマリ言語アプリケーションをマップ」をクリックします。
マッピング・ページが表示されます。

3. 「作成」をクリックします。

4. 翻訳アプリケーション・マッピング・ページで、次のステップを実行します。

- 翻訳アプリケーション: アプリケーションを識別する一意の整数値を入力します。アプリケーションIDは、Oracle Application Expressのインスタンスで一意である必要があります。

- 言語: 翻訳する言語を選択します。

- イメージ・ディレクトリ: イメージが取得されるディレクトリを入力します。翻訳されるイメージ・ディレクトリからの静的ファイルを使用する場合を除き、このフィールドは空白のままにします。これはデフォルトで、最も一般的なオプションです。

5. 「作成」をクリックします。

関連項目:
「ステップ2: 翻訳ファイルへのシードおよびダウンロード」

21.3.2 ステップ2: 翻訳ファイルへのシードおよびダウンロード

2番目のステップでは、翻訳表をシードし、翻訳テキストを翻訳ファイルにエクスポートします。

- 翻訳可能なテキストのシード

- XLIFFファイルのダウンロード

21.3.2.1 翻訳可能なテキストのシード

翻訳のシードにより、すべての翻訳可能なテキストが翻訳テキスト・リポジトリにコピーされます。言語を指定して翻訳テキストをシードすると、翻訳用のXLIFFファイルを生成してエクスポートできます。

シード・プロセスでは、プライマリ言語アプリケーションと翻訳テキスト・リポジトリの同期がとられます。プライマリ言語アプリケーションを変更するたびに、シード・プロセスを実行する必要があります。

翻訳可能なテキストをシードするには、次のステップを実行します。

1. アプリケーションの翻訳ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「グローバリゼーション」の下で「アプリケーションの翻訳」をクリックします。
翻訳ページが表示されます。

2. 「翻訳可能なテキストのシード」をクリックします。

3. 適切なターゲット・アプリケーションを選択します。

4. 「シード」をクリックします。
完了すると、次のメッセージが表示されます。

Successfully seeded translatable text.

21.3.2.2 XLIFFファイルのダウンロード

翻訳のマッピングが確立されると、アプリケーション内の翻訳可能なテキストが翻訳リポジトリにシードされます。このリポジトリを翻訳用のXML Localization Interchange File Format (XLIFF)ファイルにエクスポートします。

- XLIFFのエクスポート・ページについて

- アプリケーションのXLIFFファイルのダウンロード

- アプリケーション・ページのXLIFFファイルのダウンロード

- 含まれるXLIFFターゲット要素について

21.3.2.2.1 XLIFFのエクスポート・ページについて

XLIFFのエクスポート・ページは、2つのセクションに分かれています。アプリケーション全体の翻訳可能なテキスト(すべてのページ、LOV、メッセージなど)をエクスポートするには、上のセクションを使用します。特定のページの翻訳可能なテキストをエクスポートするには、下のセクションを使用します。

注意:
XLIFF(XML Localization Interchange File Format)は、ローカリゼーション・データを変換するためのXMLベースのフォーマットです。XLIFFについて、またはXLIFF仕様を確認するには、次の場所を参照してください。

http://www.xliff.org

21.3.2.2.2 アプリケーションのXLIFFファイルのダウンロード

完全なアプリケーションのXLIFFファイルをダウンロードするには、次のステップを実行します。

1. 翻訳可能なテキストをシードします。「翻訳可能なテキストのシード」を参照してください。

2. アプリケーションの翻訳ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「グローバリゼーション」の下で「アプリケーションの翻訳」をクリックします。
翻訳ページが表示されます。

3. 翻訳ページで、「XLIFFF翻訳ファイルのダウンロード」をクリックします。

4. 「完全なアプリケーション用のXLIFFファイルのダウンロード」で、次のステップを実行します。

1. 言語: XLIFFファイルでダウンロードする言語を選択します。

2. XLIFFターゲット要素を含める: XLIFFターゲット要素を含めるかどうかを指定します。含めるには、「XLIFFターゲット要素を含める」を選択します。

3. エクスポート: アプリケーションのすべての翻訳可能な要素をエクスポートするか、新規または更新された要素のみをエクスポートするかを選択します。

4. 「XLIFFのエクスポート」をクリックします。

5. 画面に表示されるステップに従います。

21.3.2.2.3 アプリケーション・ページのXLIFFファイルのダウンロード

特定ページのXLIFFファイルをダウンロードするには、次のステップを実行します。

1. 「翻訳可能なテキストのシード」のとおり、翻訳可能なテキストをシードします。

2. アプリケーションの翻訳ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「グローバリゼーション」の下で「アプリケーションの翻訳」をクリックします。
翻訳ページが表示されます。

3. 翻訳ページで、「XLIFFF翻訳ファイルのダウンロード」をクリックします。

4. 「アプリケーション・ページ用のXLIFFファイルのダウンロード」で、次のステップを実行します。

1. 言語: XLIFFファイルでダウンロードする言語を選択します。

2. ページ: ページを選択します。

3. XLIFFターゲット要素を含める: XLIFFターゲット要素を含めるかどうかを指定します。含めるには、「XLIFFターゲット要素を含める」を選択します。

4. エクスポート: ページのすべての翻訳可能な要素をエクスポートするか、新規または更新された要素のみをエクスポートするかを選択します。

5. 「XLIFFのエクスポート」をクリックします。

5. 画面に表示されるステップに従います。

21.3.2.2.4 含まれるXLIFFターゲット要素について

Oracle Application ExpressがXLIFFドキュメントを生成すると、各ドキュメントには複数の翻訳単位が含まれます。各翻訳単位は、ソース要素とターゲット要素で構成されます。XLIFFドキュメントは、各翻訳単位ごとのソースおよびターゲットの両方の要素で生成できます。生成するファイルにソース要素のみを含めることもできます。更新された翻訳は、翻訳単位のターゲット要素から適用されます。

21.3.3 ステップ3: XLIFFファイルの翻訳

翻訳可能なファイルをXLIFFフォーマットにエクスポートすると、これを適切な言語に翻訳できます。XLIFFは翻訳のためのオープン標準のXMLファイルであるため、ほとんどの翻訳ベンダーでサポートされています。Oracle Application Expressは、UTF-8キャラクタ・セットでエンコードされたXLIFFファイルのみをサポートしています。つまり、翻訳用のXLIFFファイルはUTF-8でエクスポートされ、翻訳済XLIFFファイルも同じキャラクタ・セットであることを前提としています。

翻訳は時間のかかるタスクです。Oracle Application Expressでは、アプリケーション開発と翻訳を並行して行えるように、増分的な翻訳をサポートしています。XLIFFファイルの一部のみが翻訳されている場合でも、ファイルを翻訳してOracle Application Expressにアップロードできます。対応する翻訳済アプリケーションに翻訳がない文字列の場合、Oracle Application Expressは、プライマリ言語の対応する文字列を使用します。

関連項目:
XLIFFの詳細またはXLIFF仕様を確認するには、次の場所を参照してください。

http://www.xliff.org

21.3.4 ステップ4: 翻訳済XLIFFドキュメントのアップロードおよび適用

XLIFFドキュメントの翻訳後に、ドキュメントをアップロードして適用します。

- 翻訳済XLIFFドキュメントのアップロード

- アップロードしたXLIFFドキュメントの適用

- アップロードしたXLIFFドキュメントの削除

21.3.4.1 翻訳済XLIFFドキュメントのアップロード

翻訳済XLIFFドキュメントをアップロードするには、次のステップを実行します。

1. アプリケーションの翻訳ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「グローバリゼーション」の下で「アプリケーションの翻訳」をクリックします。
翻訳ページが表示されます。

2. 「XLIFF翻訳ファイルの適用」をクリックします。
XLIFF翻訳ファイル・ページが表示されます。

3. 「ファイルのアップロード」をクリックします。

4. XLIFFのアップロード・ページで、次のステップを実行します。

1. アップロードするファイルを探します。

2. 「アップロード」をクリックします。

アップロードされたドキュメントが、XLIFF翻訳ファイル・ページに表示されます。

21.3.4.2 アップロードしたXLIFFドキュメントの適用

XLIFFドキュメントをアップロードした後、そのXLIFFドキュメントを適用して翻訳済アプリケーションを公開します。XLIFFドキュメントを適用すると、Application Expressエンジンはファイルを解析して、翻訳表を新しい翻訳可能なテキストで更新します。

アプリケーションを公開すると、ベース言語のアプリケーションのコピーが作成され、翻訳表の翻訳されたテキスト文字列が置換されます。その後、この公開されたアプリケーションを使用して、代替言語でアプリケーションをレンダリングできます。

アプリケーションを代替言語で実行するには、代替言語バージョンで表示するようにグローバリゼーション設定を行ってアプリケーションを実行する必要があります。たとえば、言語がブラウザ言語に従う場合は、ブラウザ言語を翻訳済アプリケーションと同じ言語に設定する必要があります。

関連項目:
「アプリケーションへのプライマリ言語の指定」

翻訳済XLIFFドキュメントを適用するには、次のステップを実行します。

1. アプリケーションの翻訳ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「グローバリゼーション」の下で「アプリケーションの翻訳」をクリックします。
アプリケーションの翻訳ページが表示されます。

2. 「XLIFF翻訳ファイルの適用」をクリックします。
XLIFF翻訳ファイル・ページが表示されます。

3. XLIFFドキュメントを適用するには、次のステップを実行します。

1. 適用するXLIFFファイルを選択します。

2. 「翻訳に適用」から、翻訳のマッピングを選択します。

3. 「チェックした項目の適用」をクリックします。

XLIFFファイルが解析され、コンテンツが翻訳リポジトリに適用されます。このプロセスが完了すると、各翻訳のアプリケーションをパブリッシュする必要があります。「ステップ5: アプリケーションのパブリッシュ」を参照してください。

21.3.4.3 アップロードしたXLIFFドキュメントの削除

アップロードしたXLIFFドキュメントを削除するには、次のステップを実行します。

1. アプリケーションの翻訳ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「グローバリゼーション」の下で「アプリケーションの翻訳」をクリックします。
翻訳ページが表示されます。

2. 「XLIFF翻訳ファイルの適用」をクリックします。
XLIFF翻訳ファイル・ページが表示されます。

3. XLIFFファイル・リポジトリで、ファイル名列の左側にあるチェック・ボックスを選択します。

4. 「チェックした項目の削除」をクリックします。

関連項目:
「アプリケーションへのプライマリ言語の指定」

21.3.5 ステップ5: アプリケーションのパブリッシュ

アプリケーションを公開すると、ベース言語のアプリケーションのコピーが作成され、翻訳表の翻訳されたテキスト文字列が置換されます。その後、この公開されたアプリケーションを使用して、代替言語でアプリケーションをレンダリングできます。

アプリケーションを代替言語で実行するには、代替言語バージョンで表示するようにグローバリゼーション設定を行ってアプリケーションを実行する必要があります。たとえば、言語がブラウザ言語に従う場合は、ブラウザ言語を翻訳済アプリケーションと同じ言語に設定する必要があります。

関連項目:
「アプリケーションへのプライマリ言語の指定」

アプリケーションを公開するには、次の手順を実行します。

1. アプリケーションの翻訳ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「グローバリゼーション」の下で「アプリケーションの翻訳」をクリックします。
アプリケーションの翻訳ページが表示されます。

2. 「翻訳済アプリケーションのパブリッシュ」をクリックします。
XLIFF翻訳ファイル・ページが表示されます。

3. パブリッシュするアイテムを選択し、「パブリッシュ」をクリックします。

アプリケーションを公開した後、翻訳済アプリケーションの有無を確認する必要があります。翻訳済アプリケーションは、アプリケーション・ビルダーのホームページの「選択可能なアプリケーション」リストには表示されません。かわりに、そのページの左側のアプリケーション・ナビゲート・リストを使用します。

翻訳済アプリケーションをアプリケーション・ビルダーに表示するには、アプリケーションのグローバリゼーション属性を正しく設定する必要があります。

21.3.6 翻訳の手動編集

ターゲット言語をマップし、翻訳可能なテキストをシードした後は、手動で翻訳を編集できます。

手動で翻訳を編集するには、次のステップを実行します。

1. ターゲット言語をマップします。「ステップ1: ターゲット言語のマップ」を参照してください。

2. 翻訳可能なテキストをシードします。「翻訳可能なテキストのシード」を参照してください。

3. 翻訳可能なテキストにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「グローバリゼーション」の下で「アプリケーションの翻訳」をクリックします。

4. 「翻訳ユーティリティ」で、「翻訳リポジトリ」をクリックします。
翻訳可能なテキスト・ページが表示されます。

5. 言語マッピング・ページを選択し、「設定」をクリックします。

6. レポートをさらにカスタマイズするには、ページ上部にある検索バーを使用します。詳細は、「エンド・ユーザーとしての対話モード・レポートのカスタマイズ」を参照してください。

7. 翻訳可能なテキストを編集するには、次のステップを実行します。

1. 「編集」アイコンをクリックします。
翻訳可能なテキスト・ページが表示されます。

2. 「翻訳先テキスト」で、適切なテキストを入力します。

3. 「変更の適用」をクリックします。

8. グリッド編集ページにアクセスするには、次のステップを実行します。

1. 「グリッド編集」をクリックします。
「翻訳可能テキスト - グリッド編集」ページが表示されます。

2. 「翻訳先」で、適切なテキストを入力します。

3. 「変更の適用」をクリックします。

21.4 メッセージの翻訳

この項では、Oracle Application Expressアプリケーションでメッセージをいつどのように翻訳するかについて説明します。

- メッセージの翻訳について

- PL/SQLプロシージャで使用されるメッセージの翻訳

- Oracle Application Expressにより内部使用されるメッセージの翻訳

21.4.1 メッセージの翻訳について

アプリケーションが次に当てはまる場合、メッセージを翻訳する必要があることがあります。

- PL/SQLリージョンまたはPL/SQLプロセスが含まれる場合、あるいはPL/SQLパッケージ、プロシージャ、またはファンクションをコールする場合。この場合、生成されたHTMLを翻訳する必要があることがあります。

- Oracle Application Expressが翻訳されている10言語以外の言語を使用する場合。この場合、レポートに使用されているメッセージを翻訳する必要があることがあります。

21.4.2 PL/SQLプロシージャで使用されるメッセージの翻訳

この項では、PL/SQLプロシージャで使用されるメッセージの翻訳方法について説明します。

- PL/SQLプロシージャで使用されるメッセージの翻訳について

- 翻訳メッセージの定義

関連項目:
『Oracle Application Express APIリファレンス』のAPEX_LANGに関する項

21.4.2.1 PL/SQLプロシージャで使用されるメッセージの翻訳について

アプリケーションにPL/SQLリージョンまたはPL/SQLプロセスが含まれる場合、あるいはアプリケーションがPL/SQLパッケージ、プロシージャ、またはファンクションをコールする場合は、生成されるHTMLを翻訳する必要がある場合があります。最初に、翻訳可能なメッセージ・ページで、各メッセージを定義します。次に、APEX_LANG.MESSAGE APIを使用して、PL/SQLストアド・プロシージャ、ファンクション、トリガーまたはパッケージ化されたプロシージャおよびファンクションのメッセージを翻訳します。

21.4.2.2 翻訳メッセージの定義

翻訳可能なメッセージ・ページで、翻訳可能なメッセージを作成します。

新しい翻訳メッセージを定義するには、次のステップを実行します。

1. アプリケーションの翻訳ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「グローバリゼーション」の下で「テキスト・メッセージ」をクリックします。

2. メッセージの翻訳ページで、「テキスト・メッセージの作成」をクリックします。

3. テキスト・メッセージを指定ページで、次のステップを実行します。

1. 名前: メッセージを識別するための名前を入力します。

2. 言語: メッセージが使用される言語を選択します。

3. JavaScriptで使用: メッセージがJavaScriptコードのAPEX.LANG APIコールで使用されている場合、「はい」を選択します。

4. テキスト: テキスト・メッセージがコールされたときに戻されるテキストを入力します。
たとえば、メッセージGREETING_MSGを次のように英語で定義できます。

Good morning %0

また、メッセージGREETING_MSGを次のようにドイツ語で定義できます。

Guten Tag %0

4. 「テキスト・メッセージの作成」をクリックします。

21.4.3 Oracle Application Expressにより内部使用されるメッセージの翻訳

Oracle Application Expressはドイツ語、スペイン語、フランス語、イタリア語、日本語、韓国語、ポルトガル語(ブラジル)、簡体字中国語、および繁体字中国語に翻訳されています。これらの翻訳された10言語以外の言語をアプリケーションで使用する場合は、Application Expressレポート・エンジンによって表示されるメッセージを翻訳する必要があります。

たとえば、ロシア語のアプリケーションを開発してロシア語のレポート・メッセージ(ページ区切りなど)を使用する場合は、レポートに表示されるメッセージで使用される文字列を翻訳する必要があります。

- テキスト・メッセージの作成

- テキスト・メッセージの編集

- 翻訳が必要な内部メッセージ

- 翻訳が必要な対話モード・レポートのメッセージ

21.4.3.1 テキスト・メッセージの作成

翻訳メッセージを作成するには、次のステップを実行します。

1. アプリケーションの翻訳ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「グローバリゼーション」の下で「テキスト・メッセージ」をクリックします。

2. メッセージの翻訳ページで、「テキスト・メッセージの作成」をクリックします。

3. 「テキスト・メッセージを指定」で、次のように指定します。

1. 名前: 翻訳する必要のある各メッセージの名前を入力します。「翻訳が必要な内部メッセージ」および「翻訳が必要な対話モード・レポートのメッセージ」を参照してください。

2. 言語: メッセージが使用される言語を選択します。

3. テキスト: テキスト・メッセージがコールされたときに戻されるテキストを入力します。英語のテキスト・メッセージに定位置の置換値(%0、%1など)が含まれている場合、ユーザー定義のメッセージにも同じ名前と数字の定位置の置換値を含めてください。

4. 「テキスト・メッセージの作成」をクリックします。

21.4.3.2 テキスト・メッセージの編集

テキスト・メッセージを編集するには、次のステップを実行します。

1. アプリケーションの翻訳ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「グローバリゼーション」の下で「テキスト・メッセージ」をクリックします。

2. テキスト・メッセージの編集で、次のステップを実行します。

1. メッセージ名をクリックします。

2. 適切な編集を加えます。
英語のテキスト・メッセージに定位置の置換値(%0、%1など)が含まれている場合、ユーザー定義のメッセージにも同じ名前と数字の定位置の置換値を含めてください。

3. 「変更の適用」をクリックします。

3. グリッド編集ページにアクセスするには、次のステップを実行します。

1. 「グリッド編集」をクリックします。
グリッド編集ページが表示されます。

2. 適切な編集を加えます。
英語のテキスト・メッセージに定位置の置換値(%0、%1など)が含まれている場合、ユーザー定義のメッセージにも同じ名前と数字の定位置の置換値を含めてください。

3. 「変更の適用」をクリックします。

ヒント:
グリッド編集ページから新しいメッセージを追加するには、ページの下部にある「テキスト・メッセージの追加」をクリックします。

21.4.3.3 翻訳が必要な内部メッセージ

表 21-2に、翻訳が必要な内部メッセージを示します。

表 21-2 翻訳が必要な内部メッセージ

メッセージ名

英語のテキスト

APEX.AUTHENTICATION.LOGIN_THROTTLE.COUNTER

Please wait <span id="apex_login_throttle_sec">%0</span> seconds to login again.

APEX.AUTHENTICATION.LOGIN_THROTTLE.ERROR

The login attempt has been blocked.

APEX.DATA_HAS_CHANGED

Current version of data in database has changed since user initiated update process. current checksum = "%0" application checksum = "%1".

APEX.DATEPICKER.ICON_TEXT

Popup Calendar: %0

APEX.DATEPICKER_VALUE_GREATER_MAX_DATE

#LABEL# is greater than specified maximum date %0.

APEX.DATEPICKER_VALUE_INVALID

#LABEL# does not match format %0.

APEX.DATEPICKER_VALUE_LESS_MIN_DATE

#LABEL# is less than specified minimum date %0.

APEX.DATEPICKER_VALUE_NOT_BETWEEN_MIN_MAX

#LABEL# is not between the valid range of %0 and %1.

APEX.DATEPICKER_VALUE_NOT_IN_YEAR_RANGE

#LABEL# is not within valid year range of %0 and %1.

APEX.FILE_BROWSE.DOWNLOAD_LINK_TEXT

Download

APEX.GO_TO_ERROR

Go to error

APEX.ITEM_TYPE.SLIDER.VALUE_NOT_BETWEEN_MIN_MAX

#LABEL# is not between the valid range of %0 and %1.

APEX.ITEM_TYPE.SLIDER.VALUE_NOT_MULTIPLE_OF_STEP

#LABEL# is not a multiple of %0.

APEX.ITEM_TYPE.YES_NO.INVALID_VALUE

#LABEL# must match to the values %0 and %1.

APEX.ITEM_TYPE.YES_NO.NO_LABEL

No

APEX.ITEM_TYPE.YES_NO.YES_LABEL

Yes

APEX.NUMBER_FIELD.VALUE_GREATER_MAX_VALUE

#LABEL# is greater than specified maximum %0.

APEX.NUMBER_FIELD.VALUE_INVALID

#LABEL# must be Numeric.

APEX.NUMBER_FIELD.VALUE_INVALID2

#LABEL# does not match number format %0 (For example, %1).

APEX.NUMBER_FIELD.VALUE_LESS_MIN_VALUE

#LABEL# is less than specified minimum %0.

APEX.NUMBER_FIELD.VALUE_NOT_BETWEEN_MIN_MAX

#LABEL# is not between the valid range of %0 and %1.

APEX.PAGE_ITEM_IS_REQUIRED

#LABEL# must have some value.

APEX.POPUP_LOV.ICON_TEXT

Popup List of Values: %0.

APEX.REGION.JQM_LIST_VIEW.SEARCH

Search

APEX.REGION.JQM_LIST_VIEW.LOAD_MORE

Load more

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

Next

PAGINATION.NEXT_SET

Next Set

PAGINATION.PREVIOUS

Previous

PAGINATION.PREVIOUS_SET

Previous Set

REPORT_TOTAL

report total

RESET

reset pagination

SINCE_DAYS_AGO

%0 days ago

SINCE_DAYS_FROM_NOW

%0 days from now

SINCE_HOURS_AGO

%0 hours ago

SINCE_HOURS_FROM_NOW

%0 hours from now

SINCE_MINUTES_AGO

%0 minutes ago

SINCE_MINUTES_FROM_NOW

%0 minutes from now

SINCE_MONTHS_AGO

%0 months ago

SINCE_MONTHS_FROM_NOW

%0 months from now

SINCE_NOW

Now

SINCE_SECONDS_AGO

%0 seconds ago

SINCE_SECONDS_FROM_NOW

%0 seconds from now

SINCE_WEEKS_AGO

%0 weeks ago

SINCE_WEEKS_FROM_NOW

%0 weeks from now

SINCE_YEARS_AGO

%0 years ago

SINCE_YEARS_FROM_NOW

%0 years from now

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.UNSAVED_DATA

This form contains unsaved changes.Press Ok to proceed without saving your changes.

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

21.4.3.4 翻訳が必要な対話モード・レポートのメッセージ

表 21-3に、翻訳が必要な対話モード・レポート・メッセージを示します。

表 21-3 翻訳が必要な対話モード・レポート・メッセージ

メッセージ名

英語のテキスト

4150_COLUMN_NUMBER

Column %0

APEXIR_3D

3D

APEXIR_ACTIONS

Actions

APEXIR_ACTIONS_MENU

Actions Menu

APEXIR_ADD

Add

APEXIR_ADD_FUNCTION

Add Function

APEXIR_ADD_GROUP_BY_COLUMN

Add Group By Column

APEXIR_ADD_PIVOT_COLUMN

Add Pivot Column

APEXIR_ADD_ROW_COLUMN

Add Row Column

APEXIR_ADD_SUBSCRIPTION

Add Subscription

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_AGGREGATE

Aggregate

APEXIR_AGGREGATE_DESCRIPTION

Aggregates are displayed after each control break and at the end of the report.

APEXIR_AGGREGATION

Aggregation

APEXIR_ALL

All

APEXIR_ALL_COLUMNS

All Columns

APEXIR_ALL_ROWS

All Rows

APEXIR_ALTERNATIVE

Alternative

APEXIR_ALTERNATIVE_DEFAULT_NAME

Alternative Default: %0

APEXIR_AND

and

APEXIR_APPLY

Apply

APEXIR_AS_OF

As of %0

APEXIR_ASCENDING

Ascending

APEXIR_AVERAGE_X

Average %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_LABEL_NOT_NULL

Chart label must be specified

APEXIR_CHART_MAX_ROW_CNT

The maximum row count for a chart query limits the number of rows in the base query, not the number of rows displayed.Your base query exceeds the maximum row count of %0.Please apply a filter to reduce the number of records in your base query.

APEXIR_CHART_TYPE

Chart Type

APEXIR_CHECK_ALL

Check All

APEXIR_CHOOSE_DOWNLOAD_FORMAT

Choose report download format

APEXIR_CLEAR

clear

APEXIR_COLUMN

Column

APEXIR_COLUMN_FILTER

Filter...

APEXIR_COLUMN_HEADING

Column Heading

APEXIR_COLUMN_HEADING_MENU

Column Heading Menu

APEXIR_COLUMN_INFO

Column Information

APEXIR_COLUMN_N

Column %0

APEXIR_COLUMNS

Columns

APEXIR_COMPARISON_CONTAINS

contains

APEXIR_COMPARISON_DOESNOT_CONTAIN

does not contain

APEXIR_COMPARISON_IN

in

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_ISNOT_IN_LAST

is not in the last

APEXIR_COMPARISON_ISNOT_IN_NEXT

is not in the next

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_EXPRESSION

Computation Expression

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_BREAK_COLUMNS

Control Break Columns

APEXIR_CONTROL_BREAKS

Control Breaks

APEXIR_COUNT_DISTINCT

Count Distinct

APEXIR_COUNT_DISTINCT_X

Count Distinct

APEXIR_COUNT_X

Count %0

APEXIR_DAILY

Daily

APEXIR_DATA_AS_OF

Report data as of %0 minutes ago.

APEXIR_DATE

Date

APEXIR_DAY

Day

APEXIR_DEFAULT

Default

APEXIR_DEFAULT_REPORT_TYPE

Default Report Type

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_DEFAULT_REPORT

Delete Default Report

APEXIR_DELETE_REPORT

Delete Report

APEXIR_DESCENDING

Descending

APEXIR_DESCRIPTION

説明

APEXIR_DETAIL_VIEW

Single Row View

APEXIR_DIRECTION

Direction

APEXIR_DISABLE

Disable

APEXIR_DISABLED

Disabled

APEXIR_DISPLAY

Display

APEXIR_DISPLAY_IN_REPORT

Display in Report

APEXIR_DISPLAYED

Displayed

APEXIR_DISPLAYED_COLUMNS

Displayed Columns

APEXIR_DO_NOT_AGGREGATE

- Do not aggregate -

APEXIR_DO_NOT_DISPLAY

Do Not Display

APEXIR_DOWN

Down

APEXIR_DOWNLOAD

Download

APEXIR_DUPLICATE_PIVOT_COLUMN

Duplicate pivot column.Pivot column list must be unique.

APEXIR_EDIT

Edit

APEXIR_EDIT_ALTERNATIVE_DEFAULT

Edit Alternative Default

APEXIR_EDIT_CHART

Edit Chart Settings

APEXIR_EDIT_CHART2

Edit Chart

APEXIR_EDIT_FILTER

Edit Filter

APEXIR_EDIT_GROUP_BY

Edit Group By

APEXIR_EDIT_HIGHLIGHT

Edit Highlight

APEXIR_EDIT_PIVOT

Edit Pivot

APEXIR_EMAIL

Email

APEXIR_EMAIL_ADDRESS

Email Address

APEXIR_EMAIL_BCC

Bcc

APEXIR_EMAIL_BODY

Body

APEXIR_EMAIL_CC

Cc

APEXIR_EMAIL_FREQUENCY

Frequency

APEXIR_EMAIL_NOT_CONFIGURED

Email has not been configured for this application.Please contact your administrator.

APEXIR_EMAIL_REQUIRED

Email Address must be specified.

APEXIR_EMAIL_SEE_ATTACHED

See attached.

APEXIR_EMAIL_SUBJECT

Subject

APEXIR_EMAIL_SUBJECT_REQUIRED

Email Subject must be specified.

APEXIR_EMAIL_TO

To

APEXIR_ENABLE

Enable

APEXIR_ENABLE_DISABLE_ALT

Enable/Disable

APEXIR_ENABLED

Enabled

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_FILTER_EXPRESSION

Filter Expression

APEXIR_FILTER_TYPE

Filter Type

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

Format

APEXIR_FORMAT_MASK

Format Mask

APEXIR_FUNCTION

Function

APEXIR_FUNCTION_N

Function %0

APEXIR_FUNCTIONS

Functions

APEXIR_FUNCTIONS_OPERATORS

Functions / Operators

APEXIR_GO

Go

APEXIR_GREEN

green

APEXIR_GROUP_BY

Group By

APEXIR_GROUP_BY_COL_NOT_NULL

Group by column must be specified

APEXIR_GROUP_BY_COLUMN

Group By Column

APEXIR_GROUP_BY_MAX_ROW_CNT

The maximum row count for a Group By query limits the number of rows in the base query, not the number of rows displayed.Your base query exceeds the maximum row count of %0.Please apply a filter to reduce the number of records in your base query.

APEXIR_GROUP_BY_SORT

Group By Sort

APEXIR_GROUP_BY_SORT_ORDER

Group By Sort Order

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_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 wildcard (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_FORMAT

<p>Format enable you to customize the display of the report.Format contains the following submenu:</p> <ul><li>Sort</li> <li>Control Break</li> <li>Highlight</li> <li>Compute</li> <li>Aggregate</li> <li>Chart</li> <li>Group By</li> <li>Pivot</li> </ul>

APEXIR_HELP_GROUP_BY

You can define one Group By view per saved report.Once defined, you can switch between the group by and report views using view icons on the Search bar.To create a Group By view, you select: <p></p><ul> <li>the columns on which to group</li> <li>the columns to aggregate along with the function to be performed (average, sum, count, etc.)</li> </ul>

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_PIVOT

You can define one Pivot view per saved report.Once defined, you can switch between the pivot and report views using view icons on the Search bar.To create a Pivot view, you select: <p></p> <ul> <li>the columns on which to pivot</li> <li>the columns to display as rows</li> <li>the columns to aggregate along with the function to be performed (average, sum, count, etc.)</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_ROWS_PER_PAGE

Sets the number of records to display per page.

APEXIR_HELP_SAVE_REPORT

Saves the customized report for future use.You provide a name and optional description and can make the report accessible to the public (that is, all users who can access the primary default report).4つのタイプの対話モード・レポートを保存できます。

- Primary Default (Developer Only).プライマリ・デフォルトは、最初に表示されるレポートです。プライマリ・デフォルト・レポートは、名前を変更することも、削除することもできません。

- Alternative Report (Developer Only).開発者は、複数のレポート・レイアウトを作成できます。代替レポートの保存、名前の変更または削除ができるのは開発者のみです。

- Public Report (End user).作成者であるエンド・ユーザーによって保存、名前変更、削除できます。他のユーザーは、別のレポートとしてレイアウトを表示および保存できます。

- Private Report (End user).レポートを作成したエンド・ユーザーのみが表示、保存、名前の変更または削除を実行できます。

If you save customized reports, a Reports selector displays in the Search bar to the left of the Rows selector (if this feature is enabled).

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_SEARCH_BAR_ACTIONS_MENU

<li><b>Actions Menu</b> enables you to customize a report.See the sections that follow.</li>

APEXIR_HELP_SEARCH_BAR_FINDER

<li><b>Select columns icon</b> enables you to identify which column to search (or all).</li>

APEXIR_HELP_SEARCH_BAR_REPORTS

<li><b>Reports</b> displays alternate default and saved private or public reports.</li>

APEXIR_HELP_SEARCH_BAR_ROWS

<li><b>Rows</b> sets the number of records to display per page.</li>

APEXIR_HELP_SEARCH_BAR_TEXTBOX

<li><b>Text area</b> enables you to enter case insensitive search criteria (wild card characters are implied).</li> <li><b>Go button</b> executes the search.Hitting the enter key will also execute the search when the cursor is in the search text area.</li>

APEXIR_HELP_SEARCH_BAR_VIEW

<li><b>View Icons</b> switches between the icon, report, detail, chart, group by, and pivot views of the report if they are defined.</li>

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_HELP_SUBSCRIPTION

When you add a subscription, you provide an email address (or multiple email addresses, separated by commas), email subject, frequency, and start and end dates.The resulting emails include an HTML version of the interactive report containing the current data using the report setting that were present when the subscription was added.

APEXIR_HIDE_COLUMN

Hide Column

APEXIR_HIGHLIGHT

Highlight

APEXIR_HIGHLIGHT_CONDITION

Highlight Condition

APEXIR_HIGHLIGHT_TYPE

Highlight Type

APEXIR_HIGHLIGHT_WHEN

Highlight When

APEXIR_HIGHLIGHTS

Highlights

APEXIR_INACTIVE_SETTING

1 inactive setting

APEXIR_INACTIVE_SETTINGS

%0 inactive settings

APEXIR_INTERACTIVE_REPORT_HELP

Interactive Report Help

APEXIR_INVALID

Invalid

APEXIR_INVALID_COMPUTATION

Invalid computation expression. %0

APEXIR_INVALID_END_DATE

The end date must be greater than the start date.

APEXIR_INVALID_END_DATE

The end date must be greater than the start date.

APEXIR_INVALID_FILTER

Invalid filter expression. %0

APEXIR_INVALID_FILTER_QUERY

Invalid filter query

APEXIR_INVALID_SETTING

1 invalid setting

APEXIR_INVALID_SETTINGS

%0 invalid settings

APEXIR_IS_IN_THE_LAST

%0 is in the last %1

APEXIR_IS_IN_THE_NEXT

%0 is in the next %1

APEXIR_IS_NOT_IN_THE_LAST

%0 is not in the last %1

APEXIR_IS_NOT_IN_THE_NEXT

%0 is not in the next %1

APEXIR_KEYPAD

Keypad

APEXIR_LABEL

Label

APEXIR_LABEL_AXIS_TITLE

Axis Title for Label

APEXIR_LABEL_PREFIX

Label Prefix

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_MAX_X

Maximum %0

APEXIR_MEDIAN_X

Median %0

APEXIR_MIN_AGO

%0 minutes ago

APEXIR_MIN_X

Minimum %0

APEXIR_MONTH

Month

APEXIR_MONTHLY

Monthly

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_NO_AGGREGATION_DEFINED

No aggregation defined.

APEXIR_NO_COLUMN_INFO

No column information available.

APEXIR_NO_COMPUTATION_DEFINED

No computation defined.

APEXIR_NO_END_DATE

- No End Date -

APEXIR_NONE

- None -

APEXIR_NOT_VALID_EMAIL

Not a valid email address.

APEXIR_NULL_SORTING

Null Sorting

APEXIR_NULLS_ALWAYS_FIRST

Nulls Always First

APEXIR_NULLS_ALWAYS_LAST

Nulls Always Last

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_PERCENT_OF_TOTAL_COUNT_X

Percent of Total Count %0 (%)

APEXIR_PERCENT_OF_TOTAL_SUM_X

Percent of Total Sum %0 (%)

APEXIR_PERCENT_TOTAL_COUNT

Percent of Total Count

APEXIR_PERCENT_TOTAL_SUM

Percent of Total Sum

APEXIR_PIE

Pie

APEXIR_PIVOT

Add Pivot Column

APEXIR_PIVOT_AGG_NOT_NULL

Aggregate must be specified.

APEXIR_PIVOT_AGG_NOT_ON_ROW_COL

You cannot aggregate on a column selected to as row column.

APEXIR_PIVOT_COLUMN_N

Pivot Column %0

APEXIR_PIVOT_COLUMN_NOT_NULL

Pivot column must be specified.

APEXIR_PIVOT_COLUMNS

Pivot Columns

APEXIR_PIVOT_MAX_ROW_CNT

The maximum row count for a Pivot query limits the number of rows in the base query, not the number of rows displayed.Your base query exceeds the maximum row count of %0.Please apply a filter to reduce the number of records in your base query.

APEXIR_PIVOT_SORT

Pivot Sort

APEXIR_PREVIOUS

&lt;

APEXIR_PRIMARY

Primary

APEXIR_PRIMARY_REPORT

Primary Report

APEXIR_PRIVATE

Private

APEXIR_PUBLIC

Public

APEXIR_RED

red

APEXIR_REMOVE

Remove

APEXIR_REMOVE_AGGREGATE

Remove Aggregate

APEXIR_REMOVE_ALL

Remove All

APEXIR_REMOVE_CHART

Remove Chart

APEXIR_REMOVE_CONTROL_BREAK

Remove Control Break

APEXIR_REMOVE_FILTER

Remove Filter

APEXIR_REMOVE_FLASHBACK

Remove Flashback

APEXIR_REMOVE_GROUP_BY

Remove Group By

APEXIR_REMOVE_HIGHLIGHT

Remove Highlight

APEXIR_REMOVE_PIVOT

Remove Pivot

APEXIR_RENAME_DEFAULT_REPORT

Rename Default Report

APEXIR_RENAME_REPORT

Rename Report

APEXIR_REPORT

Report

APEXIR_REPORT_ALIAS_DOES_NOT_EXIST

Saved Interactive report with alias %0 does not exist.

APEXIR_REPORT_DISPLAY_COLUMN_LIMIT_REACHED

The number of display columns in the report reached the limit.Please click Select Columns under Actions menu to minimize the report display column list.

APEXIR_REPORT_DOES_NOT_EXIST

Report does not exist.

APEXIR_REPORT_ID_DOES_NOT_EXIST

Saved Interactive Report ID %0 does not exist.

APEXIR_REPORT_SETTINGS

Report Settings

APEXIR_REPORT_VIEW

&lt; Report View

APEXIR_REPORTS

Reports

APEXIR_RESET

Reset

APEXIR_RESET_CONFIRM

Restore report to the default settings.

APEXIR_ROW

Row

APEXIR_ROW_COL_DIFF_FROM_PIVOT_COL

Row column must be different from the pivot column.

APEXIR_ROW_COLUMN_N

Row Column %0

APEXIR_ROW_COLUMN_NOT_NULL

Row column must be specified.

APEXIR_ROW_COLUMNS

Row Columns

APEXIR_ROW_FILTER

Row Filter

APEXIR_ROW_OF

Row %0 of %1

APEXIR_ROW_ORDER

Row Order

APEXIR_ROW_TEXT_CONTAINS

Row text contains

APEXIR_ROWS

Rows

APEXIR_ROWS_PER_PAGE

Rows Per Page

APEXIR_RPT_DISP_COL_EXCEED

The number of display columns in the report reached the limit.Please click Select Columns under Actions menu to minimize the report display column list.

APEXIR_SAVE

Save

APEXIR_SAVE_AS_DEFAULT

Save as Default

APEXIR_SAVE_DEFAULT_CONFIRM

The current report settings are used as the default for all users.

APEXIR_SAVE_DEFAULT_REPORT

Save Default Report

APEXIR_SAVE_REPORT

Save Report

APEXIR_SAVE_REPORT_DEFAULT

Save Report *

APEXIR_SAVED_REPORT

Saved Report

APEXIR_SAVED_REPORT_MSG

Saved Report = "%0"

APEXIR_SEARCH

Search

APEXIR_SEARCH_BAR

Search Bar

APEXIR_SEARCH_COLUMN

Search: %0

APEXIR_SEARCH_REPORT

Search Report

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_GROUP_BY_COLUMN

- Select Group By Column -

APEXIR_SELECT_PIVOT_COLUMN

- Select Pivot Column -

APEXIR_SELECT_ROW

Select Row

APEXIR_SELECT_ROW_COLUM

- Select Row Column -

APEXIR_SELECT_SORT_COLUMN

- Select Sort Column -

APEXIR_SELECT_VALUE

Select Value

APEXIR_SELECTED_COLUMNS

Selected Columns

APEXIR_SEND

Send

APEXIR_SEQUENCE

Sequence

APEXIR_SORT

Sort

APEXIR_SORT_ASCENDING

Sort Ascending

APEXIR_SORT_COLUMN

Sort Column

APEXIR_SORT_DESCENDING

Sort Descending

APEXIR_SORT_ORDER

Sort Order

APEXIR_SPACE_AS_IN_ONE_EMPTY_STRING

space

APEXIR_STATUS

Status

APEXIR_SUBSCRIPTION

Subscription

APEXIR_SUBSCRIPTION_ENDING

Ending

APEXIR_SUBSCRIPTION_STARTING_FROM

Starting From

APEXIR_SUBSCRIPTION_STARTING_FROM

Starting From

APEXIR_SUM_X

Sum %0

APEXIR_TABLE_SUMMARY

Region = %0, Report = %1, View = %2, Displayed Rows Start = %3, Displayed Rows End = %4, Total Rows = %5

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_TOGGLE

Toggle

APEXIR_TOP

Top

APEXIR_UNAUTHORIZED

Unauthorized

APEXIR_UNGROUPED_COLUMN

Ungrouped Column

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_DETAIL

View Detail

APEXIR_VIEW_GROUP_BY

View Group By

APEXIR_VIEW_ICONS

View Icons

APEXIR_VIEW_PIVOT

View Pivot

APEXIR_VIEW_REPORT

View Report

APEXIR_WEEK

Week

APEXIR_WEEKLY

Weekly

APEXIR_WORKING_REPORT

Working Report

APEXIR_X_DAYS

%0 days

APEXIR_X_HOURS

%0 hours

APEXIR_X_MINS

%0 minutes

APEXIR_X_MONTHS

%0 months

APEXIR_X_WEEKS

%0 weeks

APEXIR_X_YEARS

%0 years

APEXIR_YEAR

Year

APEXIR_YELLOW

yellow

APEXIR_YES

Yes

IR_AS_DEFAULT_REPORT_SETTING

As Default Report Settings

IR_AS_NAMED_REPORT

As Named Report

IR_STAR

Only displayed for developers

LAYOUT.T_CONDITION_EXPR2

Expression 2

OUT_OF_RANGE

Invalid set of rows requested, the source data of the report has been modified.

REPORT

Report

REPORTING_PERIOD

Reporting Period

RESET

Reset Pagination

SAVED_REPORTS.PRIMARY.DEFAULT

Primary Default

WWV_RENDER_REPORT3.X_Y_OF_Z_2

%0 - %1 of %2

21.5 LOVをサポートするデータの翻訳

動的データを翻訳するには、動的翻訳を作成します。たとえば、データベース問合せに基づくLOVで動的翻訳を使用する場合があります。

動的翻訳は、メッセージ名ではなく特定の文字列を問い合せるという点でメッセージとは異なります。動的翻訳は、動的翻訳ページで定義します。その後、APEX_LANG.LANG APIを使用して、パラメータp_primary_text_stringで指定された動的翻訳文字列を戻します。

関連項目:
『Oracle Application Express APIリファレンス』のAPEX_LANGに関する項

21.5.1 動的翻訳の定義

動的翻訳は、動的翻訳ページで定義します。動的翻訳は、翻訳元の言語文字列、言語コードおよび翻訳先の文字列で構成されています。

動的翻訳を定義するには、次のステップを実行します。

1. アプリケーションの翻訳ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「グローバリゼーション」の下で「アプリケーションの翻訳」をクリックします。

2. アプリケーションの翻訳ページの「翻訳ユーティリティ」で、「動的翻訳」を選択します。

3. 動的翻訳ページで、「作成」をクリックし、次のように指定します。

1. 言語: ターゲットの言語を選択します。

2. 翻訳元テキスト: 翻訳するテキストを入力します。

3. 翻訳先テキスト: 翻訳したテキストを入力します。

4. 「作成」をクリックします。

21.6 サポートされるグローバリゼーション・コードの理解

多言語アプリケーションを構築する場合、グローバリゼーション・コードが、アプリケーションの実行方法に与える影響を理解しておくことが重要です。これらのコードは、選択したアプリケーション・レベルのグローバリゼーション属性に基づいて自動的に設定されます。

関連項目:
「アプリケーションへのプライマリ言語の指定」

21.6.1 Oracle Application Expressのグローバリゼーション・コード

表21-4に、Oracle Application Expressのグローバリゼーション・コードを示します。NLS_LANGUAGEおよびNLS_TERRITORY によって、数字、日付および通貨のデフォルトの表示形式が決まります。

表21-4 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

22 アプリケーションのデバッグ

この項では、アプリケーションをデバッグする方法について説明します。

- アプリケーション整合性のチェックのためのアドバイザの実行

- セッション・ステートの確認

- アプリケーションとページのリソース使用の監視について

- SQLトレースの有効化およびTKPROFの使用

- デバッグ・モードの使用

- コントロールおよびコンポーネントの削除による問題の特定

関連項目:
『Oracle Application Express APIリファレンス』のAPEX_DEBUGに関する項および「アプリケーション・パフォーマンスの管理」

22.1 アプリケーション整合性のチェックのためのアドバイザの実行

Oracle Application Express Advisor(アドバイザ)によって、Oracle Application Expressアプリケーションの整合性と品質をチェックできます。Oracle Application Express AdvisorはコンパイラまたはLINTのように機能し、疑わしい動作またはエラーにフラグを付けます。アドバイザを実行すると、基礎となるメタデータに基づいてアプリケーションの整合性をチェックします。

- Oracle Application Express Advisorについて

- アプリケーション全体でのアドバイザの実行

- 単一ページ上でのアドバイザの実行

22.1.1 Oracle Application Express Advisorについて

アプリケーションをデプロイする前に、Oracle Application Express Advisorを使用して、アプリケーションで様々なチェックを実行できます。アドバイザでは、エラー、セキュリティ問題、パフォーマンスのボトルネック、品質保証およびその他のベスト・プラクティスについてチェックします。

22.1.2 アプリケーション全体でのアドバイザの実行

アドバイザをアプリケーション全体で実行するには、次のステップを実行します。

1. 該当するアプリケーションにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。
アプリケーション・ビルダーのホームページが表示されます。

2. アプリケーションを選択します。
アプリケーションのホームページが表示されます。

2. 「ユーティリティ」をクリックします。

3. 「アドバイザ」をクリックします。
アドバイザ・ページが表示されます。

4. 「実行する場合は選択」で、次のステップを実行します。

1. 「実行する場合は選択」を展開します。

2. 選択したオプションを確認します。必要に応じて、オプションを選択または選択解除します。

5. 「ページ」で、表示されているフィールドにページのカンマ区切りリストを入力します。すべてのページをチェックするには、このオプションを空白のままにします。

6. ページ上部の「チェックの実行」をクリックします。
結果ページが表示されます。

ヒント:
チェックを次回実行するときは、現在のアドバイザの設定が使用されます。

7. 既存のプリファレンスを変更するには、次のステップを実行します。

1. 「フィルタ結果」で、適切なオプションの選択を解除します。

2. 「フィルタの適用」をクリックします

8. アドバイザを再び実行するには、「チェックの実行」をクリックします。

22.1.3 単一ページ上でのアドバイザの実行

アドバイザを単一ページ上で実行するには、次のステップを実行します。

1. 適切なページにナビゲートします。

- ページ・デザイナの場合は、「ページ・デザイナでのページの表示」を参照してください。

- コンポーネント・ビューの場合は、「コンポーネント・ビューでのページの表示」を参照してください。

2. 「ユーティリティ」メニューをクリックし、「アドバイザ」を選択します。
アドバイザが表示されます。

3. 「実行する場合は選択」で、選択されたオプションを確認します。必要に応じて、オプションを選択または選択解除します。

4. ページ上部の「チェックの実行」をクリックします。
結果ページが表示されます。

5. 既存のプリファレンスを変更するには、次のステップを実行します。

1. 「フィルタ結果」で、適切なオプションの選択を解除します。

2. 「フィルタの適用」をクリックします

6. アドバイザを再実行して、レポートされた問題が修正されたことを確認するには、「チェックの実行」をクリックします。

22.2 セッション・ステートの確認

多くのアプリケーションは、アプリケーション・コントロールに含まれるデータに基づいています。たとえばボタンは、セッション・ステートに格納された値に基づいて、条件付きで表示できます。アプリケーションの現行のセッション・ステートを表示するには、実行時開発者ツールバーの「セッション」リンクをクリックします。

関連項目:
「実行時開発者ツールバー」、「セッション・ステートの表示」、「セッション・ステート値の管理」および『Oracle Application Express管理ガイド』のセッション・ステートおよびユーザー・プリファレンスの管理に関する項

22.3 アプリケーションとページのリソース使用の監視について

Oracle Application Expressでは、パッケージDBMS_APPLICATION_INFOをコールして、アプリケーションおよびページで使用されるリソースを簡単に監視できます。Application Expressエンジンがページをレンダリングまたは処理すると、モジュールがAPEXに設定され、アプリケーションIDおよびページ番号が含められます。設定後は、V$SESSIONおよびV$SQLAREAビューを問い合せて、トランザクションを監視できます。

22.4 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 SQLチューニング・ガイド』のSQLトレースおよびTKPROFの理解を参照してください。

22.5 デバッグ・モードの使用

デバッグ・モードを使用すると、予期しないアプリケーション動作を追跡できます。この項では、デバッグ・モードの有効化および無効化、f?p構文を使用したデバッグ・モードへのアクセスおよびデバッグ・レポートの表示を行う方法について説明します。

- アプリケーションのデバッグ・モードの有効化および無効化

- デバッグ・モードでのアプリケーションの実行

- 開発モードでのデバッグ・レポートの表示

- デバッグ・モードにアクセスするためのf?p構文の使用について

- デバッグ・レポートの表示

関連項目:
『Oracle Application Express APIリファレンス』のAPEX_DEBUGに関する説明

22.5.1 デバッグ・モードについて

デバッグ・モードは予期しないアプリケーション動作を追跡するために使用する組込みメカニズムです。実行時開発者ツールバーの「デバッグ」と「デバッグなし」リンクをクリックすることによって、カレント・ページとセッションのデバッグ・モードを有効化および無効化します。デバッグ・レポートを表示するには、実行時開発者ツールバーの「デバッグの表示」リンクをクリックします。

アプリケーションをデバッグ・モードで実行すると、Oracle Application Expressは各ページ・リクエストの処理に関する情報をログ表に書き込みます。詳細情報のロギング・レベルを制御したり、独自のコードにデバッグ・コールを追加したり、記述されたログ情報を分析することができます。

デバッグが有効な場合、Oracle Application Expressは縮小されていないJavaScriptファイルも使用して、問題の発生元である可能性がある箇所をクライアント側コードで特定しやすくします。

関連項目:
「実行時開発者ツールバー」および『Oracle Application Express APIリファレンス』のAPEX_DEBUGに関する項

22.5.2 アプリケーションのデバッグ・モードの有効化および無効化

エンド・ユーザーがアプリケーションをデバッグ・モードで実行できるかどうかを構成するには、アプリケーション定義の編集ページの「デバッグ」属性を使用します。アプリケーションが存在するワークスペースにログインしている開発者は、常にアプリケーションをデバッグ・モードで実行できます。

デバッグ・モードを有効化または無効化するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. アプリケーション名の右側にある「アプリケーション・プロパティの編集」ボタンをクリックします。
アプリケーションの編集ページが表示されます。

4. 「プロパティ」までスクロールします。

5. 「デバッグ」で、次の項目を指定します。

- 「はい」。実行時にブラウザを使用してアプリケーション・デバッグ・モードを有効化します。

- 「いいえ」。実行時にブラウザを使用してアプリケーション・デバッグ・モードを無効化します。

関連項目:
「アプリケーション属性の管理」

22.5.3 デバッグ・モードでのアプリケーションの実行

実行時開発者ツールバーの「デバッグ」と「デバッグなし」をクリックすることによって、デバッグ・モードを実行時に有効化および無効化します。アプリケーションのワークスペースに開発者としてログインしている場合を除き、デフォルトでデバッグ・モードは無効です。

実行時にデバッグ・モードを有効化または無効化するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. 必要なアプリケーションを選択します。

3. アプリケーションを実行します。

4. 実行時開発者ツールバーで、「デバッグ」をクリックします。
デバッグ・モードが有効になります。デバッグ・データがバックグラウンドで取得されます。

5. デバッグ・モードを無効化するには、実行時開発者ツールバーで、「デバッグなし」をクリックします。

関連項目:
「アプリケーションのデバッグ・モードの有効化および無効化」

22.5.4 開発モードでのデバッグ・レポートの表示

デバッグ・レポートを開発モードで表示するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. 必要なアプリケーションを選択します。

3. 「ユーティリティ」をクリックします。

4. ユーティリティ・ページで、「デバッグ・メッセージ」をクリックします。
デバッグ・ページが表示されます。

5. 表示するセッションの左にある「ビュー識別子」をクリックします。
デバッグ・メッセージ・データ・ページが表示されます。

6. 最も時間がかかったステップを表示するには、レポートの上のグラフのステップにカーソルを合わせます。
ステップの詳細が表示されます。

7. レポートのそのステップに移動するには、棒グラフをクリックします。

注意:
レポートにリストされているデバッグ・セッションは最低2週間存続し、アクティビティ・ログと一緒にエージ・アウトされます。これは通常、デバッグ目的では十分な期間です。

関連項目:
「アプリケーションのデバッグ・モードの有効化および無効化」

22.5.5 デバッグ・モードにアクセスするためのf?p構文の使用について

f?p構文を使用してアプリケーションをデバッグ・モードで実行することもできます。単純にページをコールし、デバッグ引数をYESまたはLEVELnに設定します(nは、1(最も簡易)から9(最も詳細)の間です)。次に例を示します。

f?p=100:1:&APP_SESSION.::YES

関連項目:
「f?p構文を使用したページのリンクについて」

22.5.6 実行中のアプリケーションからのデバッグ・レポートの表示

実行中のアプリケーションからデバッグ・レポートを表示するには、次のステップを実行します。

1. アプリケーションを探してデバッグ・モードで実行します。「デバッグ・モードでのアプリケーションの実行」を参照してください。

2. 実行時開発者ツールバーの「デバッグの表示」をクリックします。
デバッグ・レポートのリストが表示されます。

3. 表示するセッションの左にある「ビュー識別子」をクリックします。
デバッグ・メッセージ・データ・ページが表示されます。

4. 最も時間がかかったステップを表示するには、レポートの上のグラフのステップにカーソルを合わせます。
ステップの詳細が表示されます。

5. レポートのそのステップに移動するには、棒グラフをクリックします。

注意:
レポートにリストされているデバッグ・セッションは最低2週間存続し、アクティビティ・ログと一緒にエージ・アウトされます。これは通常、デバッグ目的では十分な期間です。

関連項目:
「アプリケーションのデバッグ・モードの有効化および無効化」

22.5.7 デバッグ・レポートの表示

デバッグ・レポートを表示するには、次のステップを実行します。

1. 「検索」アイコンをクリックします。

「アイテム・ファインダ」が表示されます。

2. 「デバッグ」タブをクリックします。

3. 表示するセッションの左にある「ビュー識別子」をクリックします。
デバッグ・レポートが表示されます。

4. 最も時間がかかったステップを表示するには、レポートの上のグラフのステップにカーソルを合わせます。
ステップの詳細が表示されます。

5. レポートのそのステップに移動するには、棒グラフをクリックします。

注意:
レポートにリストされているデバッグ・セッションは最低2週間存続し、アクティビティ・ログと一緒にエージ・アウトされます。これは通常、デバッグ目的では十分な期間です。

関連項目:
「アプリケーションのデバッグ・モードの有効化および無効化」

22.6 コントロールおよびコンポーネントの削除による問題の特定

ページを正常に実行できない場合は、コントロールとコンポーネントを一度に1つずつ削除することをお薦めします。この方法を使用すると、問題の原因となっている可能性があるコントロールまたはコンポーネントを迅速に判別できます。条件属性「なし」を選択すると、コントロールまたはコンポーネントを無効にできます。

条件付き属性を使用してコントロールまたはコンポーネントを削除するには、次のステップを実行します。

1. 適切なページにナビゲートします。「コンポーネント・ビューでのページの表示」を参照してください。

2. 無効にするコントロールまたはコンポーネントの名前を選択します。
該当する属性ページが表示されます。

3. 「条件タイプ」が表示されるまでスクロールして、「条件タイプ」リストから「なし」を選択します。

4. 「変更の適用」をクリックして、ページ定義に戻ります。

5. ページを再度実行します。

6. ページが正常に実行されるまで、コントロールまたはコンポーネントの削除を続けます。

関連項目:
「ページ・デザイナでのページの管理」および「コンポーネント・ビューでのページの管理」

23 アプリケーション・パフォーマンスの管理

この項では、アプリケーション・パフォーマンスを向上する方法について説明します。

- パフォーマンス向上のベスト・プラクティスについて

- パフォーマンス問題の特定

- ログおよびレポートの使用

- データベース・レポートの使用について

- パフォーマンスに影響するデータベース・パラメータについて

- リソース制限について

- Webサーバーへの静的ファイルのアップロードについて

- APEX_ACTIVITY_LOGを使用したカスタム・アクティビティ・レポートの作成

関連項目:
「アプリケーションのデバッグ」

23.1 パフォーマンス向上のベスト・プラクティスについて

多くの同時ユーザーが存在するアプリケーションでは、最適なパフォーマンスを保持することが重要です。アプリケーションのパフォーマンスを最適化するには、次の機能を使用する必要があります。

- アプリケーションではできるかぎりバインド変数を使用します。SQL問合せ、およびプロセスや検証から実行されるPL/SQLなどのアプリケーション・ロジックでバインド変数構文を使用すると、セッション・ステート値を参照できます。バインド変数を使用してセッション・ステートにアクセスすると、最も効率的にセッション・ステートを参照できます。「バインド変数構文を使用したセッション・ステートの参照」を参照してください。

- #TIMING#置換文字列をリージョン・フッターに含めて、各リージョンのタイミングを表示できます。「置換文字列の理解」を参照してください。

23.2 パフォーマンス問題の特定

この項では、Oracle Application Expressアプリケーションのパフォーマンス問題の特定および解決に役立ついくつかの主要な方法について説明します。

- 実行速度の遅いアプリケーションのトラブルシューティングについて

- パフォーマンス問題の診断

- 問題のあるSQL問合せのデバッグについて

- 速度の遅い問合せへの対処について

23.2.1 実行速度の遅いアプリケーションのトラブルシューティングについて

実行速度の遅いアプリケーションのトラブルシューティングにおける最初のステップは、ボトルネックの場所を特定することです。特定のページ・リクエストまたは送信がデータベースから返されるためにかかる時間を確認することによって、アプリケーションのパフォーマンスを評価できます。この時間が、ユーザーのブラウザでページをレンダリングするためにかかる時間よりも短い場合は、アプリケーションが遅いと認識される原因は他のコンポーネントにある可能性が高くなります。クライアント・マシン、ネットワーク、中間層、データベース、ディスクおよびストレージ・デバイスを含む、すべての関連コンポーネントを常にチェックすることがベスト・プラクティスとなります。データベースについては、システム・グローバル領域(SGA)、CPU使用率、ロックおよびデータベース・パラメータをチェックします。また、レガシー・アプリケーション、データ・ウェアハウス、バッチ・プログラム、データベース・ジョブなど、データベース内で他に実行されているものがあるかどうかを確認することも重要です。

ほとんどの場合、Oracle Application Expressアプリケーションのパフォーマンス問題は開発者が作成したSQLおよびPL/SQLによるものです。これらの問題に対処するには、標準のデータベース・パフォーマンス・チューニング手法を使用する必要があります。パフォーマンス問題がOracle Application ExpressまたはOracle Databaseのバグに関連していることはほとんどありません。

関連項目:
『Oracle Databaseパフォーマンス・チューニング・ガイド』およびOracle Database SQLチューニング・ガイド

23.2.2 パフォーマンス問題の診断

パフォーマンスの問題を診断するには、次のステップを実行します。

- ステップ1: 時間ウィンドウを特定します。

- ステップ2: データベース時間の最大のコンシューマを特定します。

- ステップ3: Oracle Application Expressワークスペースおよびアプリケーションを特定します。

- ステップ4: 問題の原因となっているSQLとアプリケーション内の特定の場所の関連を確認します。

実行速度の遅いページを特定したら、デバッグ・モードでアプリケーションを実行して、最も多くの時間を消費しているコンポーネントを特定する必要があります。

23.2.3 問題のあるSQL問合せのデバッグについて

問合せが正常に実行されていない可能性がある場合、SQL*Plus、SQL DeveloperまたはSQLコマンドでの実行を試してください。いずれの方法でも、アプリケーションのコンテキスト外で問合せがテストされるため、問題をより簡単に特定できます。

23.2.4 速度の遅い問合せへの対処について

最適化された問合せの処理が1秒を超える場合は、進捗バーの実装および複数のページ送信を回避することを検討します。ユーザーは即時の結果を期待し、ページがすぐに返されないと、多くの場合、ページを再送信します。適切に管理されていない場合、ページ送信ごとにデータベース内で新しいセッションが開始され、完了するまで継続します。多くの場合、複数のページ送信はパフォーマンスを低下させ、データベース・ロックにつながる可能性があります。このことは、特に対話モード・レポートに該当します。別の方法として、Oracle Application Expressコレクションを使用して問合せ結果を保持することをお薦めします。コレクションを使用すると、コストと時間のかかる問合せは、ページ区切りの実行やフィルタの作成ごとではなく、ユーザーごとに1回のみ実行されるようになります。

関連項目:
「コンポーネント・ビューでのページ属性の編集」、「重複送信」および「コレクションの使用について」

23.3 ログおよびレポートの使用

Application Expressエンジンは、使用状況およびパフォーマンス・データを取得するために、アクティビティ・ログを記録します。この情報は様々なレポートに表示されます。特定のページに対するアクセスが過剰である場合や、ページのレンダリングが遅い場合は、これらのレポートが問題のあるページを特定するために役立ちます。その後、それらの問題のあるページをさらに分析できます。たとえば、SQL Developerでレポート問合せを実行し、実行計画を確認できます。

- ログ・ファイルの管理方法

- 「アプリケーション・ダッシュボード」レポートの表示

- ワークスペース・アクティビティ・レポート

- インスタンス・アクティビティ・レポート

ヒント:
ページまたはプロセス内のコストのかかる要素を特定するもう1つの方法は、Application Expressデバッグ・モードを確認することです。『Oracle Application Express APIリファレンス』のAPEX_DEBUGに関する説明

関連項目:
「デバッグ・モードの使用」

23.3.1 ログ・ファイルの管理方法

インスタンス管理者は、アクティビティ・ログ・ファイルを削除し、ログ・ファイル情報が保持される間隔を管理できます。アクティビティ・ログ・ファイルを無期限に保持する場合は、アクティビティ・ログの表から別の表にレコードをコピーするバッチ・ジョブを作成する必要があります。

関連項目:
『Oracle Application Express管理ガイド』のログおよびファイルの管理に関する項

23.3.2 「アプリケーション・ダッシュボード」レポートの表示

アプリケーション・ダッシュボードを表示するには、次のステップを実行します。

1. 「ワークスペース」ホームページにナビゲートします。

2. 「アプリケーション・ビルダー」アイコンをクリックします。

3. アプリケーションを選択します。
アプリケーションのホームページが表示されます。

4. 「ユーティリティ」をクリックします。

5. 「アプリケーション・ダッシュボード」をクリックします。
アプリケーション・ダッシュボードが表示されます。左側にある最初の2つのリージョン(「アプリケーション概要」と「タイプ別の表示」)に現在のアプリケーションについての詳細情報と統計がリストされます。残りのリージョンは、次のセクションに分割されます。

- セキュリティ: 現在の認証スキーム、パブリック・ページと非パブリック・ページの数およびカレント・アプリケーション内で使用される認可スキームの数が表示されます。

- テンプレート: カレント・アプリケーション内で使用されるテンプレートのレポートへのリンクが表示されます。

- タイプ別の表示: タイプ別にページをリストします。

- アプリケーション・コンポーネント: アプリケーション・レベルのコントロールとロジックのレポート(LOV、タブ、リスト、アプリケーション・アイテム、アプリケーション・プロセス、アプリケーションの計算など)へのリンクが表示されます。

- ページ・コンポーネント: ページ・レベルのコントロールとロジックのレポート(アイテム、ボタン、プロセス、リージョン、ブランチ、検証、動的アクションなど)へのリンクが表示されます。

6. 特定のレポートを表示するには、コンポーネント・タイプまたはテンプレートの右にある数字をクリックします。

23.3.3 ワークスペース・アクティビティ・レポート

ワークスペース管理者は、ワークスペースに固有の管理タスクを実行するユーザーです。ワークスペース管理者は、次のアクティビティ・レポートにアクセスできます。

- ページ・ビュー - ビュー別、ユーザー別、アプリケーション別、アプリケーションとページ別、日別、時間別および対話モード・レポート別に構成されるページ・ビューのレポートが含まれます。

- 開発者アクティビティ: 開発者、日、アプリケーション、アプリケーション変更、および日または月別に構成された開発者アクティビティのレポートを提供します。

- ページ・ビューの分析 - 最も表示されたページ、日別のページ・ビュー、日別の使用状況(チャート)、重み付けされたページ・パフォーマンスおよびWebシート・ページ・ビューなどのレポート分析ページ・ビューが含まれます。

- セッション - アクティブ・セッションと現行のワークスペースがリストされます(レポートまたはチャート)。

- ログイン試行回数 - ログイン試行回数、認証結果ごとのログイン試行回数および開発者ログイン・サマリーをリストしたレポートを提供します。

- 環境 - ユーザー・エージェント別、ブラウザ別、外部アクセス別またはオペレーティング・システム別に構成される環境のレポートが含まれます。

- アプリケーション・エラー: アプリケーション・エラーのレポートが含まれます。

- ワークスペース・スキーマ・レポート - スキーマの表領域使用率およびスキーマ別のデータベース権限のサマリー、ワークスペース・スキーマおよびレポート表領域の使用率を提供します。

関連項目:
『Oracle Application Express管理ガイド』のワークスペース内のアクティビティの監視に関する項および「Application Expressのユーザー・ロールの概要」

23.3.4 インスタンス・アクティビティ・レポート

インスタンス管理者は、Application Express管理サービス・アプリケーションを使用して、ホスティングされたインスタンス全体を管理するスーパーユーザーです。インスタンス管理者は、次のアクティビティ・レポートにアクセスできます。

- ページ・ビュー: アプリケーション、ユーザー、ワークスペース、日またはRESTアクセス別にアクティビティを表示します。

- ワークスペースの消去: ダッシュボード・サマリー、アクティブでないワークスペース、消去済のワークスペース、アクティブになったワークスペースまたはワークスペースの消去ログを表示します。

- 環境レポート: 使用されるオペレーティング・システム、ブラウザ・タイプ、ユーザー・エージェントまたは外部サイトのサマリーを表示します。

- カレンダ・レポート: 最後に使用された日付別にワークスペースを表示し、日別、さらにアプリケーションおよびユーザー別、または時間別にページ・ビューを表示します。

- サービス・リクエスト: 新規サービス・リクエストまたはサインアップ・アンケートのアクティビティを表示します。

- ログ: メール・ログ、ジョブ・ログ、自動削除ログを表示、またはパッケージ・アプリケーションのインストールを監視します。

- ログイン試行回数: ログイン試行回数または最後の開発者ログインを表示します。

- 開発者アクティビティ: 開発者またはワークスペース別にアプリケーション変更を表示します。

関連項目:
『Oracle Application Express管理ガイド』の開発インスタンス間のアクティビティの監視に関する項および「Application Expressのユーザー・ロールの概要」

23.4 データベース・レポートの使用について

Oracle Application Expressは、Application ExpressエンジンをコールするAPEX_PUBLIC_USERとして、データベース・プールから物理的な接続を確立します。Application Expressエンジンは、別のユーザーである解析対象スキーマとして、SQL.DBMS_SYS_SQLを使用してSQLを解析します。データベースのV$SESSIONレコードには、クライアント情報、クライアント識別子およびモジュールに関するOracle Application Express固有の情報を含め、実行された各SQLの有用な情報が含まれています。Oracle Traceファイルを生成し、TKPROFを使用して解析するとき、関連するSQLを特定するためにこの情報を使用できます。また、Application Express URLの末尾に&p_trace=YESを追加したり、ALTER SESSIONを使用することもできます。

自動ワークロード・リポジトリ(AWR)レポートは、デフォルトで1時間ごとにパフォーマンス統計を収集します。アクティブ・セッション履歴(ASH)レポートは、データベース・アクティビティのシステム全体のレポートです。これらのレポートを使用して、リソース使用量の多いSQL文を特定できます。他のPL/SQLプログラムをさらにコールするPL/SQLパッケージ、プロシージャおよびファンクションについては、Oracle Database 11gでPL/SQLの階層型プロファイラを使用できます。これらのサブプログラムは、個別的に、実行時間の要因になります。

Oracle Application Expressには、Oracle Application Expressに関連するすべてのものをカタログ化するビューも含まれています。Oracle Application ExpressからSQL Developer、SQL*PlusおよびSQLコマンド(Oracle Application Express SQLワークショップ)などのツールを使用し、これらのビューを使用して情報にアクセスできます。APEX_ADMINISTRATOR_ROLEが付与されているユーザーは、スキーマ・ユーザーが関連付けられているワークスペースだけでなく、インスタンス全体に対する問合せを実行できます。

関連項目:
「SQLトレースの有効化およびTKPROFの使用」、『Oracle Databaseパフォーマンス・チューニング・ガイド』のAWRおよびASHデータに関する情報および『Oracle Application Express SQLワークショップ・ガイド』

23.5 パフォーマンスに影響するデータベース・パラメータについて

特定のデータベース・パラメータは、パフォーマンスに影響する可能性があります。特に、メモリー関連のパラメータ(MEMORY_TARGET、SGA_TARGET、PGA_AGGREGATE_TARGET、SHARED_POOL_SIZE)について、サイズが正しいことを確認する必要があります。埋込みPL/SQLゲートウェイを使用する場合は、複数の同時リクエストのパフォーマンスを向上させるために、SHARED_SERVERSのサイズが正しいことを確認する必要があります。また、データベースのシステム・グローバル領域(SGA)が実際のメモリーに収まることも確認する必要があります。SGAが小さいと、Application Expressのパフォーマンスに大きく影響する可能性があります。PL/SQLの共有プールおよびApplication Expressメタデータのバッファ・キャッシュには十分なメモリーが必要です。SGAのサイズが正しい場合、定期的にアクセスされるため、メモリーからスワップ・アウトされず、Application ExpressエンジンからPL/SQLプログラムを固定する必要がなくなります。Application Expressエンジンはデータベース内に存在するため、統計をAPEX_050000スキーマに集約することを強くお薦めします。正確な統計によって、コストベース・オプティマイザで、アプリケーション・メタデータにアクセスするための問合せ計画をより適切に作成できます。

23.6 リソース制限について

Oracle Database Enterprise Editionのオプションであるデータベース・リソース・マネージャは、Oracle Application Expressインスタンスの維持に非常に役立ちます。リソース・マネージャを使用すると、各ユーザー・リクエストに使用可能なシステム・リソースのタイプ(CPU_PER_CALLおよびLOGICAL_READS_PER_CALL)を制限できます。複数のリソース・プロファイルを設定し、プロファイル間の自動切替えを有効にすることによって、ユーザー・リクエストが特定のしきい値を超過した場合に、そのトランザクションに使用可能なCPUを削減できます。たとえば、デフォルト・プロファイルのAPEX_HIGHはCPUの70%を10秒間、APEX_MEDIUMはCPUの8%を120秒間、APEX_LOWはCPUの2%を1800秒間、OTHERSはCPUの20%を使用できるように定義できます。特定のトランザクションが10秒を超えると、使用可能なCPUを大幅に削減するAPEX_MEDIUMプロファイルに切り替わります。トランザクションがAPEX_LOWに切り替わって1800秒を超過した場合、SQLを取り消すかセッションを中断できます。この方法により、特定の1ユーザーや適切に作成されていないアプリケーションがCPUを独占することによって、他のユーザーおよびアプリケーションの応答が悪化することが回避されます。

ヒント:
インスタンス管理者は、個々のワークスペースに対してリソース・マネージャ・プロファイルを定義できます。『Oracle Application Express管理ガイド』のワークスペース分離属性の構成に関する項およびインスタンス・レベルのワークスペース分離属性の構成に関する項を参照してください。

関連項目:
『Oracle Database管理者ガイド』のOracle Database Resource Managerを使用したリソースの管理に関する項

23.7 Webサーバーへの静的ファイルのアップロードについて

パフォーマンスを向上させるには、Webサーバーに静的ファイルを置くことが必要です。また、ベスト・プラクティスとして、静的ファイルをブラウザに送信するときにファイル・サイズが最小化されるように、Webサーバーでgzipでの圧縮を有効化することもお薦めします。さらに、有効期限ヘッダーを送信することによって、ブラウザのファイル・キャッシュを有効化することもお薦めします。

関連項目:
「静的アプリケーション・ファイルの管理」および「静的ワークスペース・ファイルの管理」

23.8 APEX_ACTIVITY_LOGを使用したカスタム・アクティビティ・レポートの作成

この項では、APEX_ACTIVITY_LOGビューを使用して、現在のワークスペースのアクティビティを問い合せる方法について説明します。

- アプリケーションのロギングの有効化

- APEX_ACTIVITY_LOG

- APEX_ACTIVITY_LOGのサンプル問合せ

23.8.1 アプリケーションのロギングの有効化

アプリケーション定義の編集ページでアプリケーションのロギングを有効にできます。

アプリケーション定義を編集するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. アプリケーション名の右側にある「アプリケーション・プロパティの編集」ボタンをクリックします。
「アプリケーション定義の編集」ページが表示されます。

4. 「プロパティ」で、「ロギング」を見つけます。「はい」または「いいえ」を選択します。
「はい」に設定した場合、すべてのページ・ビューがログに記録されるため、管理者はアプリケーションごとにユーザー・アクティビティを監視できます。高容量アプリケーションでは、ロギングを無効にすることをお薦めします。

ヒント:
Oracle Application Express管理サービスの「アプリケーション・アクティビティのロギング」属性が「アプリケーションの設定を使用(デフォルト)」に設定されている場合、「ロギング」属性の変更のみ可能です。

関連項目:
『Oracle Application Express管理ガイド』のロギングでのアプリケーション・アクティビティの有効化に関する項

23.8.2 APEX_ACTIVITY_LOG

APEX_ACTIVITY_LOGビューには、開発者アクティビティ、アプリケーション実行時アクティビティなど、ワークスペースのすべてのアクティビティが記録されます。APEX_ACTIVITY_LOG使用して、現在のワークスペースのすべてのアクティビティを表示および問い合せることができます。たとえば、このビューを使用して、リアルタイムのパフォーマンス分析を提供する特定のアプリケーション内の監視レポートを開発できます。

表 23-1に、APEX_ACTIVITY_LOGビューの列を示します。

表 23-1 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アドレス

ir_report_id

NUMBER

対話モード・レポートID

ir_search

VARCHAR2

ユーザーが入力した対話モード・レポート検索条件。

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ブラウザ・ユーザー・エージェントが含まれます。

23.8.3 APEX_ACTIVITY_LOGのサンプル問合せ

次に、アプリケーション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つの異なるログ表を順番に使用することに注意してください。ログ表は2つあるので、ロギング情報はログのうち古い方の使用可能なエントリのみとなります。アプリケーションの特定のログ情報を常に保持する場合は、所有するアプリケーション表に両方のログ情報をコピーするか、アプリケーションに直接ロギングを実装する必要があります。

24 アプリケーションのデプロイ

この項では、アプリケーション・ビルダーで作成したデータベース・アプリケーションのデプロイに含まれるステップについて説明します。

- 推奨環境について

- 考慮すべきシステム開発のライフ・サイクル方法論

- デプロイ・プロセスの理解

- 別のインスタンスへのアプリケーションの移動方法

- カスタム・パッケージ・アプリケーションの作成方法

- アプリケーションおよびアプリケーション・コンポーネントのエクスポート

- エクスポート・ファイルのインポート

- エクスポート・ファイルのインストール

- データベース・アプリケーションURLの公開について

- Webシート・アプリケーションURLの公開について

- ビルド・オプションを使用した構成の制御

関連項目:
『Oracle Application Express管理ガイド』のアプリケーション機能の拡張に関する項およびApplication Expressユーザーの管理に関する項

ヒント:
デプロイ・オプションを示すチュートリアルを確認するには、Oracle Online Learning Library (http://apex.oracle.com/pls/apex/f?p=44785:1) で「Advanced Deployment of Your Application: Part 3」を検索してください。

24.1 推奨環境について

Oracle Application Expressでアプリケーションを開発する場合は、標準的なシステム開発のライフ・サイクル事例に従い、開発、テストおよび本番に異なる環境を使用することをお薦めします。開発者には開発環境内のアプリケーションおよび関連データベース・オブジェクトの変更のみを許可することがベスト・プラクティスとなります。

このポリシーをさらに強化するために、テスト環境と本番環境に、ランタイムのみのOracle Application Express環境をインストールすることをお薦めします。これにより、開発者がこれらの環境でアプリケーション・ビルダーおよびSQLワークショップにアクセスすることが禁止されます。一般的に、テスト環境と本番環境を更新する権限は、管理者(DBA)のみが持つようにします。DBAは提供された適切なAPIを使用し、SQL DeveloperやSQL*PlusなどのSQLインタフェースからアプリケーションをインポートする必要があります。

関連項目:
「ランタイム環境と完全開発環境の違いについて」

24.2 考慮すべきシステム開発のライフ・サイクル方法論

システム開発のライフ・サイクル(SDLC)は、定義された一連のステップを使用した、ソフトウェア開発全体のプロセスです。この項では、Oracle Application Expressでのアプリケーション開発に役立つ複数のSDLCモデルについて説明します。

- 反復開発と計画開発について

- プロトタイプ作成の利点について

- ウォーターフォール

- スパイラル

- 高速アプリケーション開発

24.2.1 反復開発と計画開発について

アプリケーション・ビルダーを使用してアプリケーションを開発する際、次のように大きく異なる2つの開発方法を考慮する必要があります。

- 反復による、迅速なアプリケーション開発

- 計画され、段階を経る開発

反復による、迅速なアプリケーション開発は、その高い柔軟性のために、プロジェクトが完了しないリスクがあります。それとは対照的に、計画され、段階を経る開発は、理論上は決められた要件を満たしていても、エンド・ユーザーのニーズに合わないアプリケーションが作成される可能性があります。

24.2.2 プロトタイプ作成の利点について

Oracle Application Expressの開発環境を使用すると、開発者は、開発においてより対話的な方法をとることができます。他の多くの開発環境とは異なり、プロトタイプの作成が容易です。Oracle Application Expressを使用すると、開発者は次のことを実行できます。

- 組込みウィザードを使用して、アプリケーションのユーザー・インタフェースを迅速に設計できます。

- ユーザーによる使用が可能なプロトタイプを作成し、フィードバックを収集できます。

- 変更をリアルタイムに実装し、新しいプロトタイプを即時に作成できます。

Oracle Application Expressを使用して機能する方法論として、スパイラルと高速アプリケーション開発(RAD)があります。

関連項目:
「スパイラル」および「高速アプリケーション開発」

24.2.3 ウォーターフォール

ウォーターフォールは、最も有名なSDLCモデルでしょう。この方法では、開発プロセスは次の段階に分類されます。

1. プロジェクトのプランニング

2. 要件の定義

3. 設計

4. 開発

5. 統合およびテスト

6. インストールおよび採用

7. メンテナンス

この方法は、ある段階の出力結果が次の段階の入力内容になることから、ウォーターフォールと呼ばれます。

この方法には、前の段階ですべての要件が確立されていることが前提となります。しかし、実際には、開発プロセスの途中で要件が変更されたり、新しい要件が加わることが多くあります。

24.2.4 スパイラル

スパイラルの方法は、実質的には、短いウォーターフォール・サイクルをつなげたものです。各ウォーターフォール・サイクルから新たな要件が発生し、開発チームによって堅牢なプロトタイプが作成できるようになります。この方法の利点の1つは、変化する要件に対応できることです。短所は、複雑なプロジェクト管理と開発が無期限に続くリスクです。

24.2.5 高速アプリケーション開発

高速アプリケーション開発(RAD)は、完成した製品に近いプロトタイプの作成を非常に重要視した方法です。プロトタイプは、要件フェーズの重要な部分です。このモデルの利点は、要件の変更に対応できること、開発サイクルが高速であること、進捗を容易に測定できることなどです。このモデルの主な短所は、プロトタイプの作成を重要視することによって有効範囲が肥大化する可能性があることです。その結果、開発者が完全なアプリケーションを作成しようとして、当初の目的を見失うことがあります。

24.3 デプロイ・プロセスの理解

この項では、デプロイ・プロセスの様々な手法について説明します。

- 別のインスタンスへのアプリケーションの移動について

- 考慮するデプロイ・オプション

- ワークスペースをコピーするかどうかについて

- データベースをコピーするかどうかについて

- アプリケーションIDについて

24.3.1 別のインスタンスへのアプリケーションの移動について

あるOracle Application Expressインスタンスから別のインスタンスにアプリケーションを移動するには、アプリケーションで使用されるメタデータとサポートするオブジェクトの両方を次のように移動する必要があります。

1. アプリケーション定義およびすべての関連ファイルを移動します。「別のインスタンスへのアプリケーションの移動方法」を参照してください。

2. サポートするオブジェクトを移動します。「データベース・オブジェクトの依存性」レポートを確認して、移動するオブジェクトを決定します。「「データベース・オブジェクトの依存性」レポートの使用」および「カスタム・パッケージ・アプリケーションの作成方法」を参照してください。

24.3.2 考慮するデプロイ・オプション

アプリケーション・ビルダーでアプリケーションを開発する場合は、特定のワークスペース内でアプリケーションを作成します。各ワークスペースには、一意のIDおよび名前が含まれます。通常は、開発インスタンスでアプリケーションを作成し、本番インスタンスにアプリケーションをデプロイします。

考慮するデプロイ・オプションには、次のものがあります。

1. 同一ワークスペースおよび同一スキーマの使用: アプリケーションをエクスポートしてからインポートし、別のアプリケーションIDを使用してインストールします。この方法は、基礎になるオブジェクトに対する変更は少ないが、アプリケーションの機能に対して頻繁に変更がある場合に有効です。

2. 別のワークスペースおよび同じスキーマの使用: アプリケーションをエクスポートしてから別のワークスペースにインポートします。この方法は、開発者によって本番アプリケーションが変更されないようにするために有効です。

3. 別のワークスペースおよび別のスキーマの使用: アプリケーションをエクスポートしてから別のワークスペースにインポートし、異なるスキーマを使用するためにアプリケーションをインストールします。この新しいスキーマには、アプリケーションに必要なデータベース・オブジェクトが含まれている必要があります。「「データベース・オブジェクトの依存性」レポートの使用」を参照してください。

4. すべてのバリエーションによる別のデータベースの使用: アプリケーションをエクスポートしてから別のOracle Application Expressインスタンスにインポートし、異なるワークスペース、スキーマおよびデータベースを使用してインストールします。

24.3.3 ワークスペースをコピーするかどうかについて

既存のワークスペースをコピーするかどうかを判断する際に、プリファレンスが問題になります。本番バージョンでは関係するすべてのオブジェクトへのアクセスが必要であることを覚えておいてください。たとえば、次のような場合にワークスペースをコピーする必要があります。

- 開発環境と他の環境の間で同じアプリケーション識別子を保持する場合。

- アプリケーションでOracle Application Express認証に依存する場合。ワークスペースをコピーすると、自動的にすべての必要なユーザー・データが移行されます。

24.3.4 データベースをコピーするかどうかについて

データベースをコピーするかどうかを判断する際、アプリケーションが実行されるスキーマは、開発インスタンスと同じオブジェクトにアクセスする必要があることを覚えておいてください。スキーマの実際の名前は重要ではありません。スキーマ名は、インポート・プロセスで変更できます。

24.3.5 アプリケーションIDについて

開発バージョンと本番バージョンのアプリケーションで、アプリケーションIDを一致させる必要はありません。実際、アプリケーションにアプリケーションIDをハード・コードしないことをお薦めします。かわりにアプリケーションの別名(アプリケーションの編集ページで定義される)を使用するか、組込み置換文字列(APP_ID、APP_ALIASなど)を使用します。置換文字列は、アプリケーションの機能に影響なくアプリケーションIDを変更できるため、置換文字列の使用をお薦めします。

関連項目:
アプリケーションの別名の定義の詳細は「名前」を、APP_IDおよびAPP_ALIASの使用方法の詳細は「組込み置換文字列の使用」を参照してください

24.4 別のインスタンスへのアプリケーションの移動方法

アプリケーションを他のワークスペースに移動するか、コピーを作成するのみかにかかわらず、デプロイでは次のステップを実行します。

1. サポートするデータベース・オブジェクトを移動します(適切な場合)。「データベース・オブジェクトの依存性」レポートを確認して、移動するオブジェクトを決定します。「「データベース・オブジェクトの依存性」レポートの使用」を参照してください。

2. アプリケーション定義とサポートするオブジェクトをパッケージ化して、カスタム・パッケージ・アプリケーションを作成します。「カスタム・パッケージ・アプリケーションの作成方法」を参照してください。

3. カスタム・パッケージ・アプリケーションのエクスポート「アプリケーションおよびアプリケーション・コンポーネントのエクスポート」を参照してください。

4. エクスポートされたファイルをターゲットのOracle Application Expressインスタンスにインポートします。「エクスポート・ファイルのインポート」を参照してください。

アプリケーションは、アプリケーションが開発されたワークスペース以外のワークスペースにもインポートできます。「考慮するデプロイ・オプション」を参照してください。

ヒント:
アプリケーション定義およびすべてのサポートするオブジェクトを手動でも移動できます。「アプリケーションおよびアプリケーション・コンポーネントのエクスポート」を参照してください。

24.4.1 データベース・オブジェクトの管理について

アプリケーションと適切な関連ファイルをエクスポートする前に、アプリケーションによって参照されるデータベース・オブジェクトも移行する必要があるかどうかを判断する必要があります。移動するデータベース・オブジェクトがわからない場合は、データベース・オブジェクトの依存性レポートを確認します。

関連項目:
「「データベース・オブジェクトの依存性」レポートの使用」および「カスタム・パッケージ・アプリケーションの作成方法」

ターゲットのスキーマが開発環境で使用されるスキーマとは異なる場合、アプリケーションによって参照されるデータベース・オブジェクトを移行する必要があります。多くの場合、Oracle Databaseのエクスポート・ユーティリティおよびインポート・ユーティリティを使用して、開発環境からターゲットのインスタンスにアプリケーション・スキーマをコピーするのみでこれを行うことができます。次に、この方法が適切でない2つの一般的なケースを示します。

- オブジェクト開発スキーマが、ターゲット・インスタンス・スキーマがアクセス権を持たない表領域を参照している場合。

- 開発インスタンス・スキーマに、ターゲット・インスタンス・スキーマに移行しないサンプル・データが含まれている場合。

データベース管理者またはOracle Application Express管理者がOracle Application Expressアプリケーションのエクスポートを行う場合、それらの管理者と連絡して、次のことを明示しておく必要があります。

- アプリケーションのエクスポート時に、すべてのデータを含める必要がある。

- 指定した特定の表のデータを含めない。

ヒント:
『Oracle Application Express SQLワークショップ・ガイド』のデータ・ワークショップを使用したデータの管理に関する説明

24.5 カスタム・パッケージ・アプリケーションの作成方法

サポートするオブジェクト・ページでカスタム・パッケージ・アプリケーションを作成すると、アプリケーションのデプロイに必要なステップを大幅に簡略化することができます。

- カスタム・パッケージ・アプリケーションの作成によってデプロイを簡略化する方法

- カスタム・パッケージ・アプリケーションの作成

- カスタム・パッケージ・アプリケーションへのアクセス制御リストの追加

- サポートするオブジェクトのインストール

- サポートするオブジェクトのスクリプト、メッセージ、およびインストール・オプションの削除

- カスタム・パッケージ・アプリケーションのアップグレード

- サポートするオブジェクトの削除

- インストール・サマリーの表示

関連項目:
「別のインスタンスへのアプリケーションの移動方法」および「アプリケーションおよびアプリケーション・コンポーネントのエクスポート」

24.5.1 カスタム・パッケージ・アプリケーションの作成によってデプロイを簡略化する方法

開発者にとって、アプリケーションのインポートおよびインストールは煩雑なプロセスです。最初に、ターゲットのデータベース・オブジェクトおよびシード・データを作成します。次に、アプリケーション定義およびすべての関連ファイル(イメージ、テーマ、他のすべての必要な静的ファイルなど)をインポートしてインストールします。

サポートするオブジェクト・ユーティリティを使用してカスタム・パッケージ・アプリケーションを作成すると、このプロセスを大幅に簡略化することができます。多くのステップを実行して、データベース・オブジェクトを作成し、アプリケーションおよびすべてのサポートするファイルをインポートしてインストールするかわりに、サポートするオブジェクトを定義すれば、アプリケーションおよびサポートするファイルを簡単な数ステップで移行できます。

ユーザーがアプリケーション定義をインポートしてインストールした後に、ウィザードにより簡単な数ステップで構成できます。ウィザードでは、サポートするアプリケーション・オブジェクトをインストールするかどうかが要求されます。ユーザーには、サポートするアプリケーション・オブジェクトをその場でインストールするか、後でインストールするかのオプションがあります。

開発者にとって、この機能には、次のような多くの利点があります。

- サポートするオブジェクトが正しい順序で作成されていることを確認してください。

- わずかなステップでアプリケーションを簡単にデプロイするための自動化プロセスを提供します。

- ユーザーがアプリケーション定義をインポートしてインストールするときにまたは後で、サポートするアプリケーション・オブジェクトをインストールするオプションをユーザーに提供します。「サポートするオブジェクトのインストール」を参照してください。

- ユーザーおよび開発者は、便利な方法で、アプリケーション定義、サポートするファイルおよびすべてのデータベース・オブジェクトを削除できます。「サポートするオブジェクトの削除」を参照してください。

- ユーザーおよび開発者に、前にリリースされたカスタム・パッケージ・アプリケーションを簡単にアップグレードする方法を提供します。「カスタム・パッケージ・アプリケーションのアップグレード」を参照してください。

また、アプリケーションをサポートする基礎となるデータベース・オブジェクトを簡単に編集するために、削除機能およびインストール機能を利用することができます。たとえば、すべてのデータベース・オブジェクトの削除、基礎となるデータベース・オブジェクトの作成スクリプトの編集、および再定義されたアプリケーション・オブジェクトの作成用の再インストールを行うことができます。

24.5.2 カスタム・パッケージ・アプリケーションの作成

カスタム・パッケージ・アプリケーションを作成するには、アプリケーションのサポートするオブジェクト(データベース・オブジェクト、イメージおよびシード・データを含む)およびすべてのインストール前の検証を定義するインストール・スクリプトを作成する必要があります。これらのオブジェクトとインストール・スクリプトおよび削除スクリプト、およびユーザーがサポートするオブジェクト・ページでインストールまたは削除する場合に表示するメッセージを定義します。

- サポートするオブジェクト・ページへのアクセス

- サポートするオブジェクト・ページについて

24.5.2.1 サポートするオブジェクト・ページへのアクセス

サポートするオブジェクト・ページで、カスタム・パッケージ・アプリケーションを作成します。

サポートするオブジェクト・ページのアプリケーションにアクセスするには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。
アプリケーションのホームページが表示されます。

3. 「サポートするオブジェクト」アイコンをクリックします。
サポートするオブジェクト・ページが表示されます。

24.5.2.2 サポートするオブジェクト・ページについて

サポートするオブジェクト・ページの上部に、アプリケーション名が表示され、「オブジェクトの確認」、「置換」、「インストール・スクリプト」、「システム権限の検証」、「必要な空きKB」、「使用許諾のプロンプト」、「検証」、「削除スクリプト」、「使用許諾のプロンプト」および「エクスポートに含める」の現在の選択が示されます。これらのオプションの詳細は、フィールドレベル・ヘルプを参照してください。「フィールドレベル・ヘルプの表示」を参照してください。

サポートするオブジェクトをアプリケーション・エクスポートとともに含めるかどうかを指定するには、「エクスポートに含める」リストから「はい」または「いいえ」を選択し、「変更の適用」をクリックします。

残りのページは3つのカテゴリに分割されています。

24.5.2.2.1 インストール

「インストール」のリンクを使用して次のタイプの情報を定義します。

- 前提条件: 必要なディスクの空き領域、必要なシステム権限、スキーマ・オブジェクト制限など、アプリケーションのインストール前に必要な組込みチェックを定義します。

- アプリケーション置換文字列: アプリケーションに対して定義された静的置換文字列をリストします。アプリケーション内の多くの語句またはラベルに対する静的置換文字列を定義できます。「置換」を参照してください。
アプリケーションをパッケージ化する場合、カスタム・パッケージ・アプリケーションをインストールする際にユーザーが指定できる置換文字列のプロンプトを含めることができます。

- ビルド・オプション: このアプリケーションに対して定義されたビルド・オプションをリストします。ビルド・オプションを使用して、アプリケーション内の特定の機能を条件付きで表示できます。「ビルド・オプションを使用した構成の制御」および「ビルド・オプションまたはビルド・オプション・ステータスのエクスポート」を参照してください。
アプリケーションをパッケージ化する場合、アプリケーションをインストールする際に表示される特定のビルド・オプションのプロンプトを含めることができます。

- インストール前の検証: カスタム・パッケージ・アプリケーションに対して定義された検証をリストします。標準のページ検証と同様に、ユーザー定義条件が満たされない場合、これらの検証によりユーザーはデータベース・オブジェクトをインストールできなくなります。「作成」をクリックして、画面に表示されるステップに従います。

- インストール・スクリプト: アプリケーションにサポートするオブジェクトをインストールする複数のインストール・スクリプトを定義できます。新規スクリプトを作成するには、「作成」をクリックして、画面に表示されるステップに従います。既存のスクリプトを編集するには、「編集」アイコンをクリックします。別の開発者がスクリプトを編集することを防ぐには、「ロック」アイコンをクリックします。スクリプトがロックされている場合、「ロック」アイコンは鍵が閉じた南京錠として表示されます。スクリプトのロックが解除されている場合、「ロック」アイコンは鍵が開いた南京錠として表示されます。

- メッセージ: ユーザーがアプリケーションをインストールまたは削除するときに表示するメッセージを定義します。サポートされるHTMLタグには、<b>、<i>、<u>、<p>、<br>、<hr>、<ul>、<ol>、<li>および<pre>が含まれます。
これらのメッセージを表示する際には、クロスサイト・スクリプティング(XSS)攻撃を防ぐために、一連の限定されたHTMLタグのみが認識されます。「クロスサイト・スクリプティング保護の理解」を参照してください。

24.5.2.2.2 アップグレード

「アップグレード」のリンクを使用して次のタイプの情報を定義します。

- アップグレード・スクリプト: 「アップグレード・スクリプト」をクリックして、既存のアプリケーションをアップグレードする際に、データベース・オブジェクト、イメージおよびシード・データをアップグレードするスクリプトを定義します。「カスタム・パッケージ・アプリケーションのアップグレード」を参照してください。

- メッセージのアップグレード:ユーザーがアプリケーションをアップグレードするときに表示するメッセージを定義します。サポートされるHTMLタグには、<b>、<i>、<u>、<p>、<br>、<hr>、<ul>、<ol>、<li>および<pre>が含まれます。
これらのメッセージを表示する際には、クロスサイト・スクリプティング(XSS)攻撃を防ぐために、一連の限定されたHTMLタグのみが認識されます。「クロスサイト・スクリプティング保護の理解」を参照してください。

24.5.2.2.3 削除

「削除」のリンクを使用して次のタイプの情報を定義します。

- 削除スクリプト: 「削除スクリプト」をクリックして、インストール・スクリプトにより作成されたデータベース・オブジェクトおよび静的ファイルを削除するスクリプトを定義します。既存のスクリプトを編集するには、「編集」アイコンをクリックします。

- 削除メッセージ:ユーザーがアプリケーションを削除するときに表示するメッセージを定義します。サポートされるHTMLタグには、<b>、<i>、<u>、<p>、<br>、<hr>、<ul>、<ol>、<li>および<pre>が含まれます。
これらのメッセージを表示する際には、クロスサイト・スクリプティング(XSS)攻撃を防ぐために、一連の限定されたHTMLタグのみが認識されます。「クロスサイト・スクリプティング保護の理解」を参照してください。

24.5.3 カスタム・パッケージ・アプリケーションへのアクセス制御リストの追加

アクセス制御リストを作成することによって、アプリケーション、個別ページまたはページ・コンポーネントへのアクセスを制御できます。

カスタム・パッケージ・アプリケーションのアクセス制御リストを追加するには、次のステップを実行します。

1. アクセス制御リストを作成します。「アプリケーション、ページおよびページ・コンポーネントへのアクセスの制御」を参照してください。

2. 次のように、サポートするオブジェクト・ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。
アプリケーションのホームページが表示されます。

3. 「サポートするオブジェクト」をクリックします。
サポートするオブジェクト・ページが表示されます。

3. 「インストール」で、「インストール・スクリプト」をクリックします。
インストール・スクリプト・ページが表示されます。

4. 「作成」をクリックします。

5. ページの下部で、「アクセス制御表のスクリプトの作成」をクリックします。
アクセス制御表が定義されている場合は、スクリプトの作成ページに、含まれる表が表示されます。

6. 「スクリプトの作成」をクリックします。

24.5.4 サポートするオブジェクトのインストール

サポートするオブジェクトを編集した後、適切なスクリプトを作成し、「タスク」リストの「サポートするオブジェクトのインストール」をクリックしてインストール・スクリプトを実行できます。

アプリケーション定義をインポートおよびインストールした後、カスタム・パッケージ・アプリケーション(またはサポートするオブジェクト)をインストールしないことを選択する場合は、エンド・ユーザーもこの機能を使用できます。

サポートするオブジェクトをインストールするには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「サポートするオブジェクト」をクリックします。
サポートするオブジェクト・ページが表示されます。

4. 「タスク」リストで、「サポートするオブジェクトのインストール」をクリックします。

5. インストール・スクリプトを実行する前にその詳細を表示するには、「インストール・スクリプトのプレビュー」をクリックします。
スクリプトのプレビュー・ページが表示され、サマリー情報、前提条件および実行する実際のスクリプトがリストされます。

6. スクリプトのプレビュー・ページを終了して続行するには、「閉じる」をクリックします。

7. 「サポートするオブジェクトのインストール」から、「はい」をクリックし、「次へ」をクリックします。

8. 画面に表示されるステップに従います。

24.5.5 サポートするオブジェクトのスクリプト、メッセージ、およびインストール・オプションの削除

サポートするオブジェクト・ページの「タスク」リストの「サポートするオブジェクトのインストールの削除」をクリックすると、カスタム・パッケージ・アプリケーションに関連付けられたサポートするオブジェクトのスクリプト、メッセージおよびインストール・オプションを定義するメタデータを削除できます。

サポートするオブジェクトのスクリプト、メッセージおよびインストール・オプションを定義するメタデータを削除するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「サポートするオブジェクト」をクリックします。
サポートするオブジェクト・ページが表示されます。

4. ページの右側の「タスク」リストで、「サポートするオブジェクトのインストールの削除」をクリックします。

5. 画面に表示されるステップに従います。

24.5.6 カスタム・パッケージ・アプリケーションのアップグレード

アップグレード・ページで、前に公開されたアプリケーションをアップグレードするスクリプトを定義できます。

- アップグレード・スクリプトの定義

- カスタム・パッケージ・アプリケーションのアップグレード

24.5.6.1 アップグレード・スクリプトの定義

アップグレード・ページを使用して、既存のアプリケーションをアップグレードする際に、データベース・オブジェクト、イメージおよびシード・データをアップグレードするスクリプトを定義できます。

アップグレード・スクリプトを作成するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「サポートするオブジェクト」をクリックします。
サポートするオブジェクト・ページが表示されます。

4. 「アップグレード」で、「アップグレード・スクリプト」をクリックします。

5. 「既存のサポートするオブジェクトの検出」セクションを使用して、適切なオブジェクトをインストールするか、またはアップグレードする必要があるかを決定します。

6. 「既存のサポートするオブジェクトを検査する問合せ」で、サポートするオブジェクトが存在する場合に少なくとも1つの行を戻す問合せをフィールドに入力します。
カスタム・パッケージ・アプリケーションをインストールするユーザーにインストール・スクリプトまたはアップグレード・スクリプトを実行するように求めるかどうかが、問合せにより決定されます。

7. スクリプトを作成するには、「作成」をクリックします。

ヒント:
このアプリケーションの様々な旧バージョンをユーザーがアップグレードできるようにするために、スクリプトのプロパティ・ページに移動してアップグレード・スクリプトに条件を追加できます。

8. 別の開発者がスクリプトを編集することを防ぐには、「ロック」アイコンをクリックします。
スクリプトがロックされている場合、「ロック」アイコンは鍵が閉じた南京錠として表示されます。スクリプトのロックが解除されている場合、「ロック」アイコンは鍵が開いた南京錠として表示されます。

9. 既存のスクリプトを編集するには、「編集」アイコンをクリックします。

10. 画面に表示されるステップに従います。

24.5.6.2 カスタム・パッケージ・アプリケーションのアップグレード

アップグレード・スクリプトの作成後、サポートするオブジェクト・ページの「タスク」リストの「サポートするオブジェクトのアップグレード」をクリックすることによりテストできます。

また、エンド・ユーザーもこの機能を使用して既存のカスタム・パッケージ・アプリケーションをアップグレードできます。

カスタム・パッケージ・アプリケーションをアップグレードするには、次のステップを実行します。

1. アップグレードする新しいバージョンのアプリケーションをインポートします(使用可能な場合)。「アプリケーション、ページまたはコンポーネントのエクスポートのインポート」を参照してください。

2. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

3. アプリケーションを選択します。

4. 「サポートするオブジェクト」をクリックします。
サポートするオブジェクト・ページが表示されます。

5. 「タスク」リストから、「サポートするオブジェクトのアップグレード」をクリックします。

6. 画面に表示されるステップに従います。

24.5.7 サポートするオブジェクトの削除

カスタム・パッケージ・アプリケーションを作成またはインストールすると、次のいずれかの方法で削除できます。

- サポートするオブジェクト・ページで、「サポートされているオブジェクトの削除」をクリックします。

- アプリケーションのホームページで、「このアプリケーションの削除」をクリックします。

アプリケーションを削除する場合、現在のアプリケーション定義を削除して、サポートするオブジェクトに定義された削除スクリプトを実行するオプションがあります。

関連項目:
「カスタム・パッケージ・アプリケーションの作成」

カスタム・パッケージ・アプリケーションを削除するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「サポートするオブジェクト」をクリックします。
サポートするオブジェクト・ページが表示されます。

4. 「タスク」リストから、「サポートされているオブジェクトの削除」をクリックします。

5. 削除オプションを次のように選択します。

- アプリケーション定義の削除: 現在のアプリケーション定義を削除します。

- データベース・オブジェクトの削除: このアプリケーションのデプロイ属性に定義された削除スクリプトを実行します。

6. 画面に表示されるステップに従います。

24.5.8 インストール・サマリーの表示

サポートするオブジェクト・ページで、「タスク」リストの「インストール・サマリーの表示」をクリックすると、最近のインストール・ログおよび削除ログを表示できます。このログには、現在のApplication Expressセッション中に発生した最新のインストールまたは削除の結果のみ表示されることに注意してください。

インストール・サマリーを表示するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「サポートするオブジェクト」をクリックします。
サポートするオブジェクト・ページが表示されます。

4. ページの右側の「タスク」リストで、「インストール・サマリーの表示」をクリックします。
サマリー・ページが表示されます。

24.6 アプリケーションおよびアプリケーション・コンポーネントのエクスポート

この項では、アプリケーションおよび関連ファイルを別のOracle Application Expressインスタンスにエクスポートする方法について説明します。

- エクスポート・プロセスについて

- エクスポート・ページについて

- アプリケーションのエクスポート

- アプリケーション・コンポーネントのエクスポート

- ワークスペースのエクスポート

- アプリケーションのページのエクスポート

- Webシートのエクスポート

- 静的ファイルのエクスポートについて

- テーマのエクスポート

- プラグインのエクスポート

- ユーザー・インタフェースのデフォルト値のエクスポート

- チーム開発フィードバックのエクスポート

- スクリプト・リポジトリからのスクリプト・ファイルのエクスポート

ヒント:
ダウンロードしたインストールzipファイルのUtilitiesフォルダにあるAPEXExportプログラムを使用して、コマンドラインからワークスペース、アプリケーションおよび関連ファイルをエクスポートすることもできます。詳細は、UtilitiesフォルダのReadme.txtファイルを参照してください。

24.6.1 エクスポート・プロセスについて

Oracle Application Expressからアプリケーションをエクスポートするプロセスは非常に単純で、これにより、.SQL拡張子を持つ読取り可能なスクリプト・ファイルが生成されます。このSQLスクリプトは、エクスポート元の環境と同じリリース以上のOracle Application Express環境で実行できます。たとえば、Oracle Application Expressリリース4.0からエクスポートしたアプリケーションは、Oracle Application Expressリリース4.0、4.1または4.2を実行している環境にインポートできます。ただし、Oracle Application Expressリリース4.2からエクスポートしたアプリケーションを、Oracle Application Expressリリース4.1以下を実行している環境にインポートすることはできません。

アプリケーションのエクスポートには、アプリケーション定義、サポートするオブジェクトおよび共有コンポーネント(プラグイン、イメージ、CSSファイル、JavaScriptファイル、個別に管理する必要があるその他のファイルなど)が含まれます。完全なアプリケーションをエクスポートするかわりに、ページなどの特定のコンポーネントをエクスポートすることもできます。この場合も、SQLスクリプト・ファイルが作成されます。異なる環境にコンポーネントをインポートする場合は、制限があります。ベスト・プラクティスとして、個々のコンポーネントではなく完全なアプリケーションをエクスポートすることをお薦めします。エクスポートしようとするアプリケーションに、まだテストの準備が整っていないページなどのコンポーネントがある場合は、ビルド・オプションを使用して、各種のアプリケーション・コンポーネントを含めたり、除外することができます。

関連項目:
「アプリケーションのエクスポート」、「アプリケーション・コンポーネントのエクスポート」および「ビルド・オプションを使用した構成の制御」

24.6.2 エクスポート・ページについて

アプリケーション定義およびすべての関連ファイルをエクスポートするには、エクスポート・ページの上部にある次のタブを使用します。「エクスポート」、「ワークスペース」、「アプリケーション」、「Webシート」、「テーマ」、「プラグイン」、「デフォルト値」および「フィードバック」。

ワークスペース・ユーザーを移行するか、ターゲット・インスタンス内で共有コンポーネント・サブスクリプションを複製する場合を除いて、ワークスペース全体をエクスポートする必要はありません。

アプリケーションとすべての関連ファイルをエクスポートしたら、それらをターゲットのOracle Application Expressインスタンスにインポートしてからインストールする必要があります。一般的に、常にアプリケーションをインポートしてから関連ファイルをインポートします。

ヒント:
カスタム・パッケージ・アプリケーションを作成すると、アプリケーションのデプロイに必要なステップを単純化できます。「カスタム・パッケージ・アプリケーションの作成方法」を参照してください。

関連項目:
「別のインスタンスへのアプリケーションの移動方法」

24.6.3 アプリケーションのエクスポート

アプリケーションのエクスポート時に、Oracle Application ExpressによってPL/SQL APIコールを含むテキスト・ファイルが生成されます。アプリケーションのエクスポートには、アプリケーション定義、サポートするオブジェクトおよび共有コンポーネント(プラグイン、イメージ、CSSファイル、JavaScriptファイル、個別に管理する必要があるその他のファイルなど)が含まれます。

関連項目:
『Oracle Application Express管理ガイド』のアプリケーション・コンポーネントのエクスポートに関する項およびエクスポートされたアプリケーションのランタイム環境へのインストールに関する項

アプリケーションをエクスポートするには、次のステップを実行します。

1. エクスポート・ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーション・ビルダー・ホームページで、「ワークスペース・ユーティリティ」をクリックします。

3. 「エクスポート」をクリックします。

2. 「アプリケーション」タブをクリックします。

3. 「アプリケーションの選択」で、エクスポートするアプリケーションを選択します。

4. 「アプリケーションのエクスポート」で、次のステップを実行します。

1. ファイル形式: エクスポート・ファイルでの行の書式設定の方法を選択します。オプションは次のとおりです。

- UNIX - 生成されるファイルには、改行で区切られた行が含まれます。

- DOS - 生成されるファイルには、キャリッジ・リターンと改行で区切られた行が含まれます。

- データベース - ダウンロードするファイルを生成するかわりにアプリケーションをファイル・リポジトリにエクスポートします。

2. 新しい所有者: オプションで別の所有者を選択します。デフォルトでは、アプリケーションはアプリケーション属性の所有者で識別される所有者が所有します。

3. 新しいビルド・ステータス: 次のいずれかの項目を選択します。

- アプリケーションの実行のみ - 開発者は、アプリケーションの実行のみができます。

- アプリケーションの実行および構築 - 開発者は、アプリケーションを実行および編集できます。

「アプリケーションの実行のみ」の選択は、他の開発者がアプリケーションを変更できないようにするために効果的な方法です。

ヒント:
「アプリケーションの実行のみ」を選択した場合は、引数p_traceをYesに設定できません。詳細は、「ビルド・オプションを使用した構成の制御」を参照してください。また、アプリケーションのインポート後にこの設定を変更する方法は、Oracle Application Express管理サービスにログインする以外ありません。Oracle Application Express管理ガイドの「デプロイ時のアプリケーションのビルド・ステータス・セットの変更」を参照してください。

4. デバッグ: 次のいずれかの項目を選択します。

- はい - デバッグが有効な状態でアプリケーションがエクスポートされます。

- いいえ - デバッグが無効な状態でアプリケーションがエクスポートされます。

5. 現在から: 適切な時点に戻り、使用するアプリケーションの以前のバージョンをエクスポートできます。たとえば、現在は削除されているオブジェクトを含むバージョンのアプリケーションをエクスポートするためにこのオプションを使用できます。表示されるフィールドに、時間を分単位で指定します。
このユーティリティは、DBMS_FLASHBACKパッケージを使用します。システム変更番号(SCN)マッピングへのタイムスタンプが約5分ごとにリフレッシュされるため、検索しているバージョンの検出にはそれと同じ時間がかかる場合があります。元に戻す情報が保持される時間は、起動パラメータUNDO_RETENTION(デフォルトは3時間)に影響されます。ただし、このパラメータはUNDO表領域のサイズにのみ影響します。2つのデータベースに同じUNDO_RETENTIONパラメータが含まれている場合でも、トランザクション数が少ないデータベースでは、UNDO表領域が一杯ではなく、以前のデータが強制的にアーカイブされるため、より前の時点に戻ることができます。

5. 「プリファレンスのエクスポート」で、次の項目を含めるか除外するために「はい」または「いいえ」を選択します。

- サポートするオブジェクトの定義をエクスポート

- パブリック対話モード・レポートのエクスポート

- プライベート対話モード・レポートのエクスポート

- 対話モード・レポートのサブスクリプションのエクスポート

- 開発者コメントのエクスポート

- 翻訳のエクスポート

- 元のIDでエクスポート

属性の詳細は、フィールドレベル・ヘルプを参照してください。「フィールドレベル・ヘルプの表示」を参照してください。

6. 「アプリケーションのエクスポート」をクリックします。

実際のアプリケーション・ファイルをエクスポートするのみでなく、カスケード・スタイルシート、イメージ、スクリプト・ファイルなど、その他の関連ファイルもエクスポートする必要がある場合があります。

関連項目:
「SQLトレースの有効化およびTKPROFの使用」および「アプリケーション、ページまたはコンポーネントのエクスポートのインポート」

24.6.4 アプリケーション・コンポーネントのエクスポート

コンポーネントのエクスポート・ページ上のページの共有コンポーネントまたはコンポーネントをエクスポートできます。このウィザードを使用して次のことを実行できます。

- 別のアプリケーションまたはワークスペースへの共有コンポーネントまたはページ・コンポーネントのエクスポート。

- コンポーネントの編集前のバックアップ。

- 別のOracle Application Expressインスタンスへのパッチとして機能するエクスポートの作成。

共有コンポーネントまたはページ・コンポーネントをエクスポートするには、次のステップを実行します。

1. コンポーネントのエクスポート・ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「タスク」リストから「アプリケーション・コンポーネントのエクスポート」をクリックします。
「コンポーネントのエクスポート」ページが表示されます。

2. 次のタブをクリックして、エクスポートするコンポーネントを選択します。

- 「コンポーネント」には、共有アプリケーション・コンポーネントおよびページ全体が表示されます。ページ上部のナビゲーション・バーを使用してコンポーネントを検索します。「共有コンポーネントでの作業」を参照してください。

- 「ページ別のコンポーネント」には、選択したページのコンポーネントがリストされます。ページから選択して特定のページにナビゲートします。「Check All」をクリックして、すべてのコンポーネントを選択します。

- 「ビルド・オプションのステータス」には、使用可能なビルド・オプションが表示されます。このページを使用してビルド・オプションを選択および選択解除します。「ビルド・オプションまたはビルド・オプション・ステータスのエクスポート」を参照してください。

タブごとに適切なコンポーネントを選択し、「エクスポートに追加」をクリックします。

3. 「次へ」をクリックします。

4. 「コンポーネントのエクスポート」で、次のステップを実行します。

1. ファイル形式: エクスポート・ファイルでの行の書式設定の方法を選択します。

- UNIX - 生成されるファイルには、改行で区切られた行が含まれます。

- DOS - 生成されるファイルには、キャリッジ・リターンと改行で区切られた行が含まれます。

2. 現在から: 何分前まで遡ってエクスポートするかを指定します。このオプションを使用すると、削除されたオブジェクトを元に戻すなどのために、アプリケーションの前の時点に戻ることができます。
このユーティリティは、DBMS_FLASHBACKパッケージを使用します。システム変更番号(SCN)マッピングへのタイムスタンプが約5分ごとにリフレッシュされるため、検索しているバージョンの検出にはそれと同じ時間がかかる場合があります。元に戻す情報が保持される時間は、起動パラメータUNDO_RETENTION(デフォルトは3時間)に影響されます。ただし、このパラメータはUNDO表領域のサイズにのみ影響します。2つのデータベースに同じUNDO_RETENTIONパラメータが含まれている場合でも、トランザクション数が少ないデータベースでは、UNDO表領域が一杯ではなく、以前のデータが強制的にアーカイブされるため、より前の時点に戻ることができます。

3. 「コンポーネントのエクスポート」をクリックします。

ヒント:
翻訳されたアプリケーションでは、「翻訳のエクスポート」フィールドが表示されます。プライマリ言語アプリケーションおよびすべての翻訳済アプリケーションの選択した共有コンポーネントをエクスポートするには、「翻訳のエクスポート」フィールドから、「はい」を選択します。テキスト文字列とマークアップを最新の状態にするには、翻訳済コンポーネントをエクスポートする前に翻訳済アプリケーションを同期化する必要があることに注意してください。

関連項目:
「アプリケーションのエクスポート」、「アプリケーションのページのエクスポート」、「アプリケーション、ページまたはコンポーネントのエクスポートのインポート」および「ビルド・オプションまたはビルド・オプション・ステータスのエクスポート」

24.6.5 ワークスペースのエクスポート

ワークスペースをエクスポートすることによって、ワークスペースを別のOracle Application Expressインスタンスに移動したりコピーできます。ワークスペースをエクスポートすると、Oracle Application Expressは、ユーザー、すべての定義されたユーザー・グループ、保存されたSQL、履歴、SQLスクリプトなどのSQLワークショップ・アーティファクト、およびオプションで、チーム開発データのASCIIテキストのSQLスクリプトを作成します。

ワークスペースをエクスポートするには、次のステップを実行します。

1. エクスポート・ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーション・ビルダー・ホームページで、「ワークスペース・ユーティリティ」をクリックします。

3. 「エクスポート」をクリックします。

2. エクスポート・ページで、「ワークスペース」タブをクリックします。

3. 「ワークスペースのエクスポート」で、次の項目を指定します。

- チーム開発を含める: 機能、マイルストン、To Do、バグ、フィードバック、リンク、ニュースなどのチーム開発データを含める場合は「はい」を設定します。このワークスペースのターゲット・インスタンスが実行時のみのインスタンスでない場合は、「はい」のみを選択します。そうでない場合は、「いいえ」を選択します。

- ファイル形式: エクスポート・ファイルでの行の書式設定の方法を選択します。

- UNIX - 生成されるファイルには、改行で区切られた行が含まれます。

- DOS - 生成されるファイルには、キャリッジ・リターンと改行で区切られた行が含まれます。

4. 「エクスポート」をクリックします。

関連項目:
『Oracle Application Express管理ガイド』の「Application Expressユーザーの管理」

24.6.6 アプリケーションのページのエクスポート

この項では、アプリケーションのページをエクスポートする方法について説明します。ページのエクスポート時に、エクスポートされるページが同じアプリケーションIDとワークスペースIDを持っている場合のみ正常にインポートされることを覚えておいてください。

アプリケーションのページをエクスポートするには、次のステップを実行します。

1. 適切なページにナビゲートします。

1. ページ・デザイナ:

- 適切なページにナビゲートします。「ページ・デザイナでのページの表示」を参照してください。

- 「ユーティリティ」メニューをクリックし、「エクスポート」を選択します。

2. コンポーネント・ビュー:

- 適切なページにナビゲートします。「コンポーネント・ビューでのページの表示」を参照してください。

- 「ユーティリティ」メニューをクリックし、「エクスポート」を選択します。

ページのエクスポート・ウィザードが表示されます。

2. 「ページ」で、エクスポートするページを選択します。

3. 「ファイル形式」から、エクスポート・ファイルで行を書式設定する方法を選択します。オプションは次のとおりです。

- UNIX - 生成されるファイルには、改行で区切られた行が含まれます。

- DOS - 生成されるファイルには、キャリッジ・リターンと改行で区切られた行が含まれます。

4. 「現在から」には、何分前まで遡ってエクスポートするかを指定します。このオプションを使用すると、削除されたオブジェクトを元に戻すなどのために、アプリケーションの前の時点に戻ることができます。
このユーティリティは、DBMS_FLASHBACKパッケージを使用します。システム変更番号(SCN)マッピングへのタイムスタンプが約5分ごとにリフレッシュされるため、検索しているバージョンの検出にはそれと同じ時間がかかる場合があります。元に戻す情報が保持される時間は、起動パラメータUNDO_RETENTION(デフォルトは3時間)に影響されます。ただし、このパラメータはUNDO表領域のサイズにのみ影響します。2つのデータベースに同じUNDO_RETENTIONパラメータが含まれている場合でも、トランザクション数が少ないデータベースでは、UNDO表領域が一杯ではなく、以前のデータが強制的にアーカイブされるため、より前の時点に戻ることができます。

5. 「ページのエクスポート」をクリックします。

関連項目:
「アプリケーション・コンポーネントのエクスポート」、「アプリケーションのエクスポート」および「アプリケーション、ページまたはコンポーネントのエクスポートのインポート」

24.6.7 Webシートのエクスポート

Webシートのエクスポート・ユーティリティを使用して、Webシート・アプリケーションを他のユーザーが使用できるようにします。

Webシート・アプリケーションをエクスポートするには、次のステップを実行します。

1. エクスポート・ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーション・ビルダー・ホームページで、「ワークスペース・ユーティリティ」をクリックします。

3. 「エクスポート」をクリックします。

2. エクスポート・ページで、「Webシート」タブをクリックします。

3. Webシート・ページで、次のステップを実行します。

1. Webシート・アプリケーション - エクスポートするWebシートを選択します。

2. ファイル形式: エクスポート・ファイルでの行の書式設定の方法を選択します。オプションは次のとおりです。

- UNIX - 生成されるファイルには、改行で区切られた行が含まれます。

- DOS - 生成されるファイルには、キャリッジ・リターンと改行で区切られた行が含まれます。

3. プリファレンスのエクスポート - 適切なオプションを選択します。

4. 「エクスポート」をクリックします。

関連項目:
「Webシート・アプリケーションの作成」および「Webシートのインポート」

24.6.8 静的ファイルのエクスポートについて

静的アプリケーション・ファイルおよび静的ワークスペース・ファイルをエクスポートするには、ZIPファイルを作成します。詳細は、「すべての静的アプリケーション・ファイルのZipでのダウンロード」および「すべての静的ワークスペース・ファイルのZipでのダウンロード」を参照してください。

24.6.9 テーマのエクスポート

テーマのエクスポート・ユーティリティを使用して、Oracle Application Expressの1つの開発インスタンスからファイルにテーマをエクスポートします。

アプリケーション・テーマをエクスポートするには、次のステップを実行します。

1. エクスポート・ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーション・ビルダー・ホームページで、「ワークスペース・ユーティリティ」をクリックします。

3. 「エクスポート」をクリックします。

2. 「テーマ」タブをクリックします。

3. 「テーマ」ページで、次のステップを実行します。

1. アプリケーション: アプリケーションを選択し、「アプリケーションの設定」をクリックします。

2. テーマのエクスポート: エクスポートするテーマを選択します。

3. ファイル形式: エクスポート・ファイルでの行の書式設定の方法を選択します。オプションは次のとおりです。

- UNIX - 生成されるファイルには、改行で区切られた行が含まれます。

- DOS - 生成されるファイルには、キャリッジ・リターンと改行で区切られた行が含まれます。

4. 「テーマのエクスポート」をクリックします。

関連項目:
「テーマのインポート」および「テーマの使用」

24.6.10 プラグインのエクスポート

プラグインのエクスポート・ユーティリティを使用して、Oracle Application Expressの1つの開発インスタンスからファイルにプラグインをエクスポートします。

エクスポート・ページからプラグインをエクスポートするには、次のステップを実行します。

1. エクスポート・ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーション・ビルダー・ホームページで、「ワークスペース・ユーティリティ」をクリックします。

3. 「エクスポート」をクリックします。

2. 「プラグイン」タブをクリックします。

3. 「プラグイン」ページで、次のステップを実行します。

1. アプリケーション: アプリケーションを選択し、「アプリケーションの設定」をクリックします。

2. プラグイン: エクスポートするプラグインを選択します。

3. ファイル形式: エクスポート・ファイルでの行の書式設定の方法を選択します。オプションは次のとおりです。

- UNIX - 生成されるファイルには、改行で区切られた行が含まれます。

- DOS - 生成されるファイルには、キャリッジ・リターンと改行で区切られた行が含まれます。

4. 「エクスポート」をクリックします。

関連項目:
「プラグインのインポート」

24.6.11 ユーザー・インタフェースのデフォルト値のエクスポート

この項では、ユーザー・インタフェースのデフォルト値をエクスポートする方法について説明します。

- ユーザー・インタフェースのデフォルト値のエクスポートについて

- エクスポート・ページからのユーザー・インタフェースのデフォルト値のエクスポート

- ユーザー・インタフェースのデフォルト値ページからのユーザー・インタフェースのデフォルト値のエクスポート

24.6.11.1 ユーザー・インタフェースのデフォルト値のエクスポートについて

ユーザー・インタフェースのデフォルト値のエクスポートは、ターゲット・システムでの開発を予定している場合に便利です。ユーザー・インタフェースのデフォルト値は、表ディクショナリと属性ディクショナリの2つのカテゴリに分かれています。

- 表ディクショナリは、選択されたスキーマ内の表および列に固有です。これらのデフォルト値は、属性ディクショナリに定義されている値に優先して使用されます。

- 属性ディクショナリは、フォームとレポートの作成に使用する列についての属性のセットを含みます。定義は列名によって照合され、シノニムを使用することで特定の定義を複数の列間で共有できます。

ユーザー・インタフェースのデフォルト値をエクスポートする場合は、選択したディクショナリとスキーマに対するすべてのユーザー・インタフェースのデフォルト値が、1つのSQLコマンド・スクリプトにエクスポートされます。プロンプトが表示されたら、このファイルをハードディスク・ドライブに保存してください。このファイルには、アプリケーションのPL/SQL APIをコールして表のヒントを作成するAPIコールが含まれています。このファイルを使用して、ユーザー・インタフェースのデフォルト値を別のデータベースおよびOracle Application Expressインスタンスにインポートできます。

関連項目:
『Oracle Application Express SQLワークショップ・ガイド』のユーザー・インタフェースのデフォルト値のインポートに関する項およびユーザー・インタフェースのデフォルト値の管理に関する項

24.6.11.2 エクスポート・ページからのユーザー・インタフェースのデフォルト値のエクスポート

エクスポート・ページからユーザー・インタフェースのデフォルト値をエクスポートするには、次のステップを実行します。

1. エクスポート・ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーション・ビルダー・ホームページで、「ワークスペース・ユーティリティ」をクリックします。

3. 「エクスポート」をクリックします。

2. 「ユーザー・インタフェースのデフォルト値」タブをクリックします。

3. 表ディクショナリ・ページで、次のステップを実行します。

1. スキーマ: ユーザー・インタフェースのデフォルト値に関連付けられた表を所有するスキーマを選択します。

2. ファイル形式: エクスポート・ファイルでの行の書式設定の方法を選択します。オプションは次のとおりです。

- UNIX - 生成されるファイルには、改行で区切られた行が含まれます。

- DOS - 生成されるファイルには、キャリッジ・リターンと改行で区切られた行が含まれます。

3. 「エクスポート」をクリックします。

4. 属性ディクショナリをエクスポートするには、「属性ディクショナリ」タブをクリックします。

5. 属性ディクショナリ・ページで、次のステップを実行します。

1. ファイル形式: エクスポート・ファイルでの行の書式設定の方法を選択します。オプションは次のとおりです。

- UNIX - 生成されるファイルには、改行で区切られた行が含まれます。

- DOS - 生成されるファイルには、キャリッジ・リターンと改行で区切られた行が含まれます。

2. 「エクスポート」をクリックします。

24.6.11.3 ユーザー・インタフェースのデフォルト値ページからのユーザー・インタフェースのデフォルト値のエクスポート

ユーザー・インタフェースのデフォルト値ページからユーザー・インタフェースのデフォルト値をエクスポートするには、次のステップを実行します。

1. ワークスペースホームページで、「SQLワークショップ」アイコンをクリックします。

2. 「ユーティリティ」をクリックします。

3. 「ユーザー・インタフェースのデフォルト値」をクリックします。
ユーザー・インタフェースのデフォルト値ページが表示されます。

4. ディクショナリを選択します

- 表ディクショナリの管理: 選択されたスキーマ内の特定の表と列をエクスポートするには、このボタンを選択します。

- 属性ディクショナリの管理: フォームとレポートを作成するために使用する列属性のセットをエクスポートするには、このボタンを選択します。

5. 「タスク」で、「エクスポート」をクリックします。

6. 「ファイル形式」で、オプションを選択します。

- UNIX - 生成されるファイルには、改行で区切られた行が含まれます。

- DOS - 生成されるファイルには、キャリッジ・リターンと改行で区切られた行が含まれます。

- データベース - ダウンロードするファイルを生成するかわりにファイル・リポジトリにエクスポートします。

7. 「エクスポート」をクリックします。

24.6.12 チーム開発フィードバックのエクスポート

フィードバックのエクスポート・ユーティリティを使用して、本番またはテスト・システムからのフィードバックを開発システムと同期します。開発システムは、ワークスペース情報の編集ページで設定されるワークスペース設定の「フィードバック同期のソース識別子」を使用することによって識別されます。開発システムからエクスポートする場合、エクスポート・プロセスには「デプロイメント・システム」という追加属性があり、更新されたフィードバックを同期するデプロイメント・システム(本番またはテスト)は、この属性で指定します。

チーム開発フィードバックをエクスポートするには、次のステップを実行します。

1. エクスポート・ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーション・ビルダー・ホームページで、「ワークスペース・ユーティリティ」をクリックします。

3. 「エクスポート」をクリックします。

2. 「フィードバック」タブをクリックします。

3. フィードバック・ページで、次のステップを実行します。

1. 変更時期: エクスポートする最も古いフィードバックの日付を選択します。この選択された日付から現在の日付までのすべてのフィードバックがエクスポートされます。

2. ファイル形式: エクスポート・ファイルでの行の書式設定の方法を選択します。オプションは次のとおりです。

- UNIX - 生成されるファイルには、改行で区切られた行が含まれます。

- DOS - 生成されるファイルには、キャリッジ・リターンと改行で区切られた行が含まれます。

3. 「エクスポート」をクリックします。

関連項目:
「チーム開発フィードバックのインポート」

24.6.13 スクリプト・リポジトリからのスクリプト・ファイルのエクスポート

エクスポートおよびインポート・タスクを使用して、選択したスクリプトを現行のスクリプト・リポジトリから別のワークスペース内のスクリプト・リポジトリに送信できます。

スクリプト・ファイルをエクスポートするには、次のステップを実行します。

1. ワークスペースホームページで、「SQLワークショップ」アイコンをクリックします。

2. 「SQLスクリプト」をクリックします。

3. 「タスク」リストで、「エクスポート」をクリックします。

4. 適切なスクリプト・ファイルを選択し、「エクスポートに追加」をクリックします。

5. ファイル名を確認し、「すべてのエクスポート」をクリックします。
スクリプトを削除するには、「削除」チェック・ボックスを選択します。

関連項目:
Oracle Application Express SQLワークショップ・ガイドの「SQLスクリプトの使用」

24.7 エクスポート・ファイルのインポート

アプリケーションとすべての関連ファイルをエクスポートしたら、それらをターゲットのOracle Application Expressインスタンスにインポートしてからインストールする必要があります。特定のリリースで作成されたアプリケーションを以前のバージョンにインポートすることはできません。一般的に、常にアプリケーションをインポートしてから関連ファイルをインポートします。

ヒント:
カスタム・パッケージ・アプリケーションを作成すると、アプリケーションのデプロイに必要なステップを単純化できます。「カスタム・パッケージ・アプリケーションの作成方法」を参照してください。

- アプリケーション、ページまたはコンポーネントのエクスポートのインポート

- アプリケーション・グループのインポートについて

- Webシートのインポート

- プラグインのインポート

- テーマのインポート

- ユーザー・インタフェースのデフォルト値のインポート

- チーム開発フィードバックのインポート

関連項目:
「別のインスタンスへのアプリケーションの移動方法」

24.7.1 アプリケーション、ページまたはコンポーネントのエクスポートのインポート

アプリケーション、ページまたはコンポーネントのエクスポートをターゲットのOracle Application Expressインスタンスにインポートするには、次のステップを実行します。

1. 次のように、インポート・ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーション・ビルダーのホームページで、「インポート」をクリックします。

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. 「アプリケーションのインストール」をクリックします。

関連項目:
「カスタム・パッケージ・アプリケーションの作成方法」

24.7.2 アプリケーション・グループのインポートについて

アプリケーション・グループはアプリケーションとともにエクスポートされます。アプリケーションのエクスポートには、グループID、名前およびコメントが含まれます。アプリケーションをインポートするときは、次のルールに従ってアプリケーションのインポートが行われます。

- インポートの際、アプリケーションはIDが一致すれば既存のグループを使用します。

- ターゲット・システム上に同じIDを持つアプリケーション・グループが存在しない場合は、アプリケーションのインポートで同じ名前を持つ別のグループIDが検索されます。名前の一致が検出されたら、このアプリケーション・グループ名に応じたIDを使用してアプリケーションがインポートされます。

- ターゲット・システムの既存のアプリケーション・グループとIDも名前も一致しない場合、新しいアプリケーション・グループが作成されます。新しいアプリケーション・グループは、IDがOracle Application Expressインスタンスで使用されていない場合、そのアプリケーション・グループIDを使用します。グループIDが使用されている場合、新しいIDが生成されます。

24.7.3 Webシートのインポート

関連項目:
「Webシート・アプリケーションの作成」

WebシートをターゲットのOracle Application Expressインスタンスにインポートするには、次のステップを実行します。

1. 次のように、インポート・ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーション・ビルダーのホームページで、「インポート」をクリックします。

2. 「ファイルの指定」で、次のステップを実行します。

1. インポート・ファイル: ファイルにナビゲートします。

2. ファイル・タイプ: 「Webシート・アプリケーションのエクスポート」を選択します。

3. 「次へ」をクリックします。

ファイルをインポートすると、ファイルをインストールするオプションが含まれています。

3. インポートしたファイルをインストールするには、「次へ」をクリックします。
アプリケーションのインストール・ウィザードが表示されます。

4. アプリケーションのインストール・ウィザードで、次のステップを実行します。

1. 次のアプリケーションとしてインストール: 次のいずれかの項目を選択します。

- 新しいアプリケーションIDを自動割当て

- エクスポート・ファイルからアプリケーションIDを再利用

- アプリケーションIDの変更

これらのオプションは、アプリケーションIDの競合を回避するために使用します。これらのオプションは、同じインスタンスに同じアプリケーションの2つのバージョンをインストールする場合に役立ちます。たとえば、本番インスタンスにアプリケーションを移行しているが、まだ開発バージョンを保持する必要がある場合などです。

2. 「インストール」をクリックします。

24.7.4 プラグインのインポート

エクスポートしたプラグイン・ファイルをインポートするには、次のステップを実行します。

1. 次のように、インポート・ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーション・ビルダーのホームページで、「インポート」をクリックします。

2. 「ファイルの指定」で、次のステップを実行します。

1. インポート・ファイル: ファイルにナビゲートします。

2. ファイル・タイプ: 「プラグイン」を選択します。

3. ファイルのキャラクタ・セットが正しいことを確認します。

4. 「次へ」をクリックします。

ファイルをインポートすると、ファイルをインストールするオプションが含まれています。

3. インポートしたファイルをインストールするには、「次へ」をクリックします。

4. 「プラグインのインストール」をクリックします。

注意:
同じ名前のプラグインが存在する場合、既存のプラグインを上書きする権限を要求するダイアログが表示されます。

24.7.5 テーマのインポート

アプリケーションをターゲットのOracle Application Expressインスタンスにインポートした後に、すべての関連ファイルをインポートする必要があります。

テーマのエクスポート・ファイルをインポートするには、次のステップを実行します。

1. 次のように、インポート・ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーション・ビルダーのホームページで、「インポート」をクリックします。

2. 「定義のインポート」で、次の内容を選択します。

1. インポート・ファイル: ファイルにナビゲートします。

2. ファイル・タイプ: 「エクスポート済のテーマ」を選択します。

3. ファイルのキャラクタ・セット: ファイルのキャラクタ・セットが正しいことを確認します。

4. 「次へ」をクリックします。

ファイルをインポートすると、ファイルをインストールするオプションが含まれています。

3. インポートしたファイルをインストールするには、「次へ」をクリックします。

4. 「テーマのインストール」をクリックします。

関連項目:
「テーマの使用」および「テーマのエクスポート」

24.7.6 ユーザー・インタフェースのデフォルト値のインポート

ユーザー・インタフェースのデフォルト値を使用して、指定したスキーマ内の表、列またはビューにデフォルトのユーザー・インタフェースのプロパティを割り当てることができます。

アプリケーションをターゲットのOracle Application Expressインスタンスにインポートした後に、すべての関連ファイルをインポートする必要があります。

ユーザー・インタフェースのデフォルト値をインポートするには、次のステップを実行します。

1. 次のように、インポート・ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーション・ビルダーのホームページで、「インポート」をクリックします。

2. アプリケーションを選択します。

3. 「定義のインポート」で、次のステップを実行します。

1. インポート・ファイル: ファイルにナビゲートします。

2. ファイル・タイプ: 「ユーザー・インタフェースのデフォルト値」を選択します。

3. ファイルのキャラクタ・セット: ファイルのキャラクタ・セットが正しいことを確認します。

4. 「次へ」をクリックします。

ファイルをインポートすると、ファイルをインストールするオプションが含まれています。

4. インポートしたファイルをインストールするには、「次へ」をクリックします。

5. 「ユーザー・インタフェースのデフォルト値のインストール」をクリックします。

関連項目:
Oracle Application Express SQLワークショップ・ガイドの「ユーザー・インタフェースのデフォルト値の管理」および「ユーザー・インタフェースのデフォルト値のエクスポート」

24.7.7 チーム開発フィードバックのインポート

チーム開発フィードバックをインポートするには、次のステップを実行します。

1. 次のように、インポート・ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーション・ビルダーのホームページで、「インポート」をクリックします。

2. 「フィードバック」を選択します。

3. 「ファイルのキャラクタ・セット」で、ファイルのキャラクタ・セットが正しいことを確認して、「次へ」をクリックします。
ファイルをインポートすると、ファイルをインストールするオプションが含まれています。

4. インポートしたファイルをインストールするには、「次へ」をクリックします。

5. フィードバックのインストールをクリックします。

24.8 エクスポート・ファイルのインストール

この項では、エクスポート・ファイルをインストールする方法について説明します。

- エクスポート・ファイルのインストールについて

- エクスポート・リポジトリへのアクセス

- エクスポート・リポジトリからのアプリケーション・エクスポートのインストール

- エクスポート・リポジトリからのその他ファイルのインストール

- エクスポート・リポジトリからのファイルの削除

- SQL*Plusからのエクスポート・ファイルのインストール

- SQL*Plusを使用したエクスポート・ファイルのインストール

24.8.1 エクスポート・ファイルのインストールについて

アプリケーションおよびすべての関連ファイルをターゲットのOracle Application Expressインスタンスにインポートすると、ファイルはエクスポート・リポジトリに格納されます。次に、そのファイルをインストールする必要があります。

次のようにエクスポート・ファイルをインストールできます。

- エクスポート・ファイルをインポートしたら、「インストール」ボタンをクリックして、画面に表示されるステップに従います。

- エクスポート・ファイルをアプリケーション・ビルダーにインポートした後、エクスポート・リポジトリからファイルをインストールします。

- エクスポート・ファイルをSQL*Plusからインストールします。

ヒント:
カスタム・パッケージ・アプリケーションを作成すると、アプリケーションのデプロイに必要なステップを単純化できます。「カスタム・パッケージ・アプリケーションの作成方法」を参照してください。

関連項目:
『Oracle Application Express管理ガイド』のエクスポートされたファイルの管理に関する項およびエクスポートされたアプリケーションのランタイム環境へのインストールに関する項

24.8.2 エクスポート・リポジトリへのアクセス

アプリケーションおよびすべての関連ファイルをターゲットのOracle Application Expressインスタンスにインポートすると、ファイルはエクスポート・リポジトリに格納されます。エクスポート・リポジトリを使用して、アーカイブされたアプリケーション・エクスポート、インポートおよびその他のファイルを管理できます。

エクスポート・リポジトリにアクセスするには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. アプリケーション・ビルダーのホームページで、「ユーティリティ」をクリックします。

4. 「エクスポート・リポジトリ」をクリックします。
「エクスポート・リポジトリ」が表示されます。

24.8.3 エクスポート・リポジトリからのアプリケーション・エクスポートのインストール

Oracle Application Expressインスタンスにアプリケーション・エクスポートをインポートした後に、そのファイルがアプリケーション・ビルダーでアクティブまたは使用可能になる前にインストールする必要があります。

エクスポート・リポジトリからアプリケーション・エクスポートをインストールするには、次のステップを実行します。

1. エクスポート・リポジトリにナビゲートします。「エクスポート・リポジトリへのアクセス」を参照してください。

2. アプリケーション・エクスポートを選択して、「アクション」列で「インストール」をクリックします。

3. 次の項目を指定します。

1. 解析対象スキーマ: スキーマを選択します。
このスキーマに対して、すべてのアプリケーションのSQLおよびPL/SQLが解析されます。

2. ビルド・ステータス: 次のいずれかの項目を選択します。

- アプリケーションの実行のみ

- アプリケーションの実行および構築

ターゲット・インスタンスでアプリケーションを実行し、開発者がアクセスできないようにするには、「Run Application Only」を選択します。

ヒント:
「アプリケーションの実行のみ」を選択する場合、アプリケーションのインポート後にこの設定を変更する方法は、Oracle Application Express管理サービスにログインする以外ありません。Oracle Application Express管理ガイドの「デプロイ時のアプリケーションのビルド・ステータス・セットの変更」を参照してください。

3. 次のアプリケーションとしてインストール: 次のいずれかの項目を選択します。

- 新しいアプリケーションIDを自動割当て

- エクスポート・ファイルからアプリケーションIDを再利用

- アプリケーションIDの変更

これらのオプションは、アプリケーションIDの競合を回避するために使用します。これらのオプションは、同じインスタンスに同じアプリケーションの2つのバージョンをインストールする必要がある場合に使用します。たとえば、本番インスタンスにアプリケーションを移行しているが、まだ開発バージョンを保持する必要がある場合などです。

4. 「インストール」をクリックします。

ヒント:
カスタム・パッケージ・アプリケーションをインストールしている場合、インストーラはカスタム・パッケージ・インストール・スクリプトをインストールするよう要求します。画面に表示されるステップに従います。

関連項目:
「カスタム・パッケージ・アプリケーションの作成方法」

24.8.4 エクスポート・リポジトリからのその他ファイルのインストール

Oracle Application Expressインスタンスにファイルをインポートした後、そのファイルがアプリケーション・ビルダーでアクティブまたは使用可能になる前にインストールする必要があります。

エクスポート・リポジトリに格納されたファイルをインストールするには、次のステップを実行します。

1. エクスポート・リポジトリにナビゲートします。「エクスポート・リポジトリへのアクセス」を参照してください。

2. インストールするファイルを選択して、「アクション」列で「インストール」をクリックします。

3. 画面に表示されるステップに従います。

24.8.5 エクスポート・リポジトリからのファイルの削除

エクスポート・リポジトリからファイルを削除できます。

エクスポート・リポジトリからファイルを削除するには、次のステップを実行します。

1. エクスポート・リポジトリにナビゲートします。「エクスポート・リポジトリへのアクセス」を参照してください。

2. 削除するファイルを選択し、「チェックした項目の削除」をクリックします。

24.8.6 SQL*Plusからのエクスポート・ファイルのインストール

エクスポート・ファイルはSQL*Plusからもインストールできます。エクスポート・ファイルは、インストール先と同じユーザー・データベース・アカウントで作成されている必要があります。

エクスポート・ファイルには次の制限が適用されます。

- エクスポート・ファイルがデータベース・アプリケーションの場合は、アプリケーションIDが上書きされます。そのため、ターゲットワークスペースは、インストールするアプリケーションのIDを所有している必要があります。

- エクスポート・ファイルがWebシート・アプリケーションの場合、ターゲット・ワークスペースにWebシート・データベース・オブジェクト設定が存在する必要があります。

- エクスポート・ファイルがWebシート・アプリケーションの場合、エクスポート・ファイルはWebシート・スキーマを使用してターゲット・ワークスペースにインストールする必要があります。

- エクスポート・ファイルがWebシート・アプリケーションの場合は、アプリケーションIDが上書きされます。

24.8.7 SQL*Plusを使用したエクスポート・ファイルのインストール

Oracle Application Expressエクスポート・ファイルをSQL*Plusからインストールするには、次のステップを実行します。

1. SQL*Plusにログインします。

2. エクスポート・ファイルを実行します。
たとえば、エクスポート・ファイルの名前がデフォルトでf144.sqlの場合は、コマンド・プロンプトで@f144と入力します。

24.9 データベース・アプリケーションURLの公開について

アプリケーションのデプロイ、データのロードおよびユーザーの作成が終了すると、本番URLを公開できます。次のいずれかによって、アプリケーションへのURLを決定できます。

- アプリケーションのホーム・ページでアプリケーションを選択し、「実行」ボタンを右クリックする。その後、使用するブラウザに応じて、「Copy link address」または「Copy link location」を選択します。

- アプリケーションを実行し、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

ヒント:
ユーザーはログイン時に一意のセッション番号を受信します。この番号は、URLの:homeの後に表示されます。セッション番号は、URLに含めないでください。別のユーザーがセッションIDを含むURLを実行しようとすると、エラーが表示されます。

関連項目:
「アプリケーション定義の編集ページへのアクセス」

24.10 Webシート・アプリケーションURLの公開について

Webシート・アプリケーションを完成した後で、本番URLを公開できます。アプリケーションを実行し、URLをコピーすることによって、Webシート・アプリケーションへのURLを決定できます。

次に例を示します。

http://apex.somewhere.com/pls/apex/ws?p=123:home

説明:

- apex.somewhere.comは、サーバーのURLです。

- plsは、mod_plsqlカートリッジを使用するためのインジケータです。

- apexは、データベース・アクセス記述子(DAD)名です。DADはHTTPリクエストを実行できるようにOracle HTTP Serverがデータベース・サーバーに接続する方法を示します。デフォルト値はapexです。

- ws?p=は、Oracle Applicationが使用する、Webシート・アプリケーションにリンクするための接頭辞です。

- 123は、コールされているWebシート・アプリケーションです。

- homeは、アプリケーションのプロパティ・ページでホームページとして定義されるホームページの別名です。

このサンプル・アプリケーションを実行するには、次のURLを使用します。

http://apex.somewhere.com/pls/apex/ws?p=123:home

ヒント:
ユーザーはログイン時に一意のセッション番号を受信します。この番号は、URLの:homeの後に表示されます。セッション番号は、URLに含めないでください。別のユーザーがセッションIDを含むURLを実行しようとすると、エラーが表示されます。

24.11 ビルド・オプションを使用した構成の制御

ビルド・オプションを使用すると、アプリケーションで特定の機能を条件付きで表示できます。

ビルド・オプションは、INCLUDEおよびEXCLUDEという2つの値をとることができます。属性を含めように指定すると、Application Expressエンジンは、実行時にその属性をアプリケーション定義の一部とみなします。逆に、属性を除外するように指定すると、Application Expressエンジンは、その属性を存在しないものとして処理します。

- ビルド・オプションの作成

- ビルド・オプションの管理

- ビルド・オプションの選択

- ビルド・オプションまたはビルド・オプション・ステータスのエクスポート

- ビルド・オプションの使用状況レポートの表示

関連項目:
『Oracle Application Express管理ガイド』の複数のアプリケーションのビルド・ステータスの変更に関する説明および『Oracle Application Express APIリファレンス』の「APEX_UTIL」のGET_BUILD_OPTION_STATUSプロシージャに関する説明とSET_BUILD_OPTION_STATUSプロシージャに関する説明

24.11.1 ビルド・オプションの作成

ビルド・オプション・ページのアプリケーションに対してビルド・オプションを作成します。

ビルド・オプションを作成するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

4. 「セキュリティ」で、「ビルド・オプション」をクリックします。

5. 新しいビルド・オプションを作成するには、「作成」をクリックします。

6. 画面に表示されるステップに従います。

24.11.2 ビルド・オプションの管理

ビルド・オプションは、INCLUDEおよびEXCLUDEという2つの値をとることができます。属性を含めように指定すると、Application Expressエンジンは、実行時にその属性をアプリケーション定義の一部とみなします。逆に、属性を除外するように指定すると、Application Expressエンジンは、その属性を存在しないものとして処理します。

ビルド・オプションを含めるまたは除外するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

4. 「セキュリティ」で、「ビルド・オプション」をクリックします。
ビルド・オプション・ページが表示されます。

5. ビルド・オプション名を選択します。
ビルド・オプションの作成/編集ページが表示されます。

6. 「ステータス」で、「INCLUDE」または「EXCLUDE」のいずれかを選択します。

24.11.3 ビルド・オプションの選択

ビルド・オプションを作成すると、ページ、コンポーネント(レポート、グラフまたはフォーム)、特定のページ・コントロール(ボタン・アイテム、LOV)、および別の共有コンポーネント(ブレッドクラム、リストまたはタブ)に対して選択できます。適切な属性ページに移動して、ビルド・オプションをページ、コンポーネント、ページ・コントロールまたは共有コンポーネントに適用します。ほとんどの属性ページには、定義済のビルド・オプションを選択できる「構成」セクションがあります。

関連項目:
「コンポーネント・ビューでのページ属性の編集」

24.11.4 ビルド・オプションまたはビルド・オプション・ステータスのエクスポート

コンポーネントのエクスポート・ページで、ビルド・オプションまたはビルド・オプション・ステータスをエクスポートできます。ビルド・オプション・ステータスのエクスポートは、別の環境内でビルド・オプションをオンまたはオフに切り替えるために効果的な方法です。たとえば、この機能を使用して、EXCLUDEのステータスを持つビルド・オプションと隠し機能のあるコンポーネントを関連付けることによって、隠し機能を備えた本番アプリケーションをデプロイできます。デプロイ後、ビルド・オプションのステータスをINCLUDEに変更して、ビルド・オプション・ステータスをエクスポートすると隠し機能を有効化できます。

ビルド・オプション・ステータスを本番インスタンスに適用すると、新しい機能が表示されます。

関連項目:
「カスタム・パッケージ・アプリケーションの作成方法」および「アプリケーション・コンポーネントのエクスポート」

ビルド・オプションまたはビルド・オプション・ステータスをエクスポートするには、次のステップを実行します。

1. コンポーネントのエクスポート・ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「タスク」リストから「アプリケーション・コンポーネントのエクスポート」をクリックします。
「コンポーネントのエクスポート」ページが表示されます。

2. エクスポートするビルド・オプションを次のように選択します。

1. 「ビルド・オプションのステータス」タブをクリックして、エクスポートするビルド・オプションを選択します。

2. 「エクスポートに追加」をクリックします。

3. 「次へ」をクリックします。

4. 「コンポーネントのエクスポート」で、次のステップを実行します。

1. ファイル形式: エクスポート・ファイルでの行の書式設定の方法を選択します。

- UNIX - 生成されるファイルには、改行で区切られた行が含まれます。

- DOS - 生成されるファイルには、キャリッジ・リターンと改行で区切られた行が含まれます。

2. 現在から: 何分前まで遡ってエクスポートするかを指定します。このオプションを使用すると、削除されたオブジェクトを元に戻すなどのために、アプリケーションの前の時点に戻ることができます。
このユーティリティは、DBMS_FLASHBACKパッケージを使用します。システム変更番号(SCN)マッピングへのタイムスタンプが約5分ごとにリフレッシュされるため、検索しているバージョンの検出にはそれと同じ時間がかかる場合があります。元に戻す情報が保持される時間は、起動パラメータUNDO_RETENTION(デフォルトは3時間)に影響されます。ただし、このパラメータはUNDO表領域のサイズにのみ影響します。2つのデータベースに同じUNDO_RETENTIONパラメータが含まれている場合でも、トランザクション数が少ないデータベースでは、UNDO表領域が一杯ではなく、以前のデータが強制的にアーカイブされるため、より前の時点に戻ることができます。

3. 「コンポーネントのエクスポート」をクリックします。

ヒント:
翻訳されたアプリケーションでは、「翻訳のエクスポート」フィールドが表示されます。プライマリ言語アプリケーションおよびすべての翻訳済アプリケーションの選択した共有コンポーネントをエクスポートするには、「翻訳のエクスポート」フィールドから、「はい」を選択します。テキスト文字列とマークアップを最新の状態にするには、翻訳済コンポーネントをエクスポートする前に翻訳済アプリケーションを同期化する必要があることに注意してください。

24.11.5 ビルド・オプションの使用状況レポートの表示

ビルド・オプションを作成すると、ビルド・オプション・ページに「使用状況」タブが表示されます。このレポートには、カレント・アプリケーションでのビルド・オプションの使用状況が詳述されます。

注意:
「使用状況」タブは、ビルド・オプションを作成した後のビルド・オプション・ページにのみ表示されます。

ビルド・オプションの使用状況レポートを表示するには、次のステップを実行します。

1. 「ビルド・オプション」ページにナビゲートします。

1. 「ワークスペース」ホームページにナビゲートします。

2. 「アプリケーション・ビルダー」アイコンをクリックします。

3. アプリケーションを選択します。

4. 「共有コンポーネント」をクリックします。

5. 「セキュリティ」で、「ビルド・オプション」をクリックします。
ビルド・オプション・ページが表示されます。

2. ビルド・オプション・ページで、「使用状況」をクリックします。
ビルド・オプションの使用状況レポートが表示されます。

3. ビルド・オプションを選択して、「実行」をクリックします。

25 アプリケーション・データの管理

この項では、データ・ロード機能を持つアプリケーションの作成、コレクションの使用、Webサービスの実装、データベース・リンクによるデータへのアクセス、およびデータ操作言語(DML)を利用した表の行の更新または削除など、アプリケーション・データの管理方法について説明します。

- データ・ロード機能によるアプリケーションの作成

- コレクションの使用について

- Webサービスの実装

- データベース・リンクを使用したデータへのアクセス

- DMLロックについて

25.1 データ・ロード機能を持つアプリケーションの作成

データ・ロード機能を持つアプリケーションでは、エンド・ユーザーは、アクセスできる任意のスキーマ内にある表にデータを動的にインポートできます。データをインポートするには、エンド・ユーザーは、ファイルからデータをアップロードするか、エンド・ユーザーがウィザードに直接入力したデータをコピー・アンド・ペーストするデータ・ロード・ウィザードを実行します。この項では、データ・ロード・ウィザードを作成する方法について説明します。

- データ・ロード・ウィザードの作成について

- データ・ロード・ウィザードの作成

- データ・ロード・ページの再作成

- データ・ロード定義の編集

関連項目:
データ・ロード・ウィザードの使用の詳細は、『Oracle Application Expressエンド・ユーザー・ガイド』のデータ・ロード・ウィザードの例に関する項。

注意:
データ・ロード・ウィザードは、何十万ものデータ行をロードするようには設計されていません。データ・ロード・ウィザードを使用してこの大量のデータをロードすることは可能ですが、大量のデータ・ファイルの転送およびロードの両方でパフォーマンスの問題が発生する可能性があります。Oracle SQL DeveloperおよびOracle SQL*Loaderのようなツールの方が、大量のデータのロードに適しています。

25.1.1 データ・ロード・ウィザードの作成について

アプリケーションの開発者は、ページの作成ウィザードでデータ・ロード・ページを作成することによって、データ・ロード・ウィザードを作成します。作成プロセスで、開発者はアップロード表とその一意の列、表参照およびデータ・トランスフォーメーション・ルールを指定できます。ページの作成ウィザードにより、データ・ロード・ウィザードを定義するデータ・ロード表が作成されます。

データ・ロード・ウィザードの実装には、次のサポートが含まれます。

- 表の定義: この定義は、一意のキー列を持つデータ・アップロード表の名前を指定します。

- データ・トランスフォーメーション・ルール - インポート・データを大文字や小文字に変更するといったトランスフォーメーションのフォーマットを行うために、データ・トランスフォーメーション・ルールを定義する必要があります。たとえば、インポート・ファイルに大文字と小文字の両方の列データが含まれ、アップロード表ではすべて大文字であることが必要な場合、大文字のみをターゲット列に挿入するようにデータ・トランスフォーメーション・ルールを定義できます。

- 検証のスキップ - 検証ステップをスキップすることで、大量のレコードをアップロードする際のデータ・ロードのパフォーマンスを向上できます。何千ものレコードをアップロードする場合、エンド・ユーザーは、各レコードの検証に関心がないことがあります。各レコードが新規レコードとして挿入されることが確実な場合は、データ・ロード・プロセスで重複をチェックする必要はありません。

- 表参照 - インポート・ファイルの既存データを別の表のデータにマッピングする必要がある場合、表参照を指定してマッピングを実行します。たとえば、インポート・ファイルにはDEPTNO列に部門名が含まれているが、アップロード表ではその列に数値が必要な場合、表参照ルールを使用して、別の表でその部門名に対応する部門番号を探します。

- 列名の別名 - 開発者がエンド・ユーザーに表の列名を公開したり、エンド・ユーザーにすべての列を公開することを望まない状況が数多くあります。このような状況では、公開する必要がある列の別名を作成できます。

- 同時実行性の管理 - 複数のユーザーが同時にデータをアップロードする場合、開発者は追加の列を使用して、基礎となる表のデータ・バージョンを追跡できます。データ・ロード・ウィザードでは、この列を使用して、別のユーザーが同時に同じデータを使用しているかどうかを確認し、エンド・ユーザーに伝えます。これは、定期的に更新される表にアップロードする場合に特に重要です。

- 複数のスプレッドシート列 - アップロードされるスプレッドシートに複数の列があり、開発者がその列を連結して1つの表の列にアップロードすることが必要な状況が数多くあります(スプレッドシートのFirstNameおよびLastNameをEMP表のENAMEにアップロードするなど)。

新たに生成されたデータ・ロード・ウィザードは4つのページで構成され、ユーザーはファイルからの、またはコピー・アンド・ペーストによるデータのアップロード、データおよび表のマッピングの定義、データの検証、および最終的な表へのデータのアップロードを行うことができます。開発者は後で、「共有コンポーネント」、「データ参照」、「データ・ロード定義」にアクセスして、表参照やデータ・トランスフォーメーション・ルールなどのデータ・ロード・ウィザードの定義を編集できます。

関連項目:
「データ・ロード・ウィザードの作成」および「データ・ロード定義の編集」

25.1.2 データ・ロード・ウィザードの作成

データ・ロード・ウィザードを作成するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「ページの作成」をクリックして、「次へ」をクリックします。

4. 「ページの作成」で、次のステップを実行します。

1. ユーザー・インタフェース: ページのユーザー・インタフェースを選択します。

2. ページ・タイプの選択 - 「データのロード」を選択します。

3. 「次へ」をクリックします。

5. 「データ・ロード表」で、次のステップを実行します。

1. 定義名 - このデータ・ロード定義の名前を入力します。

2. 所有者: データ・ロード表の所有者を選択します。

3. 表名: データのロードに使用する表を選択します。アップロード表とも呼ばれます。

4. 一意列1: データ・ロードの処理で一意の主キー列として使用する列名を選択します。少なくとも1つの一意のキー列が必要です。

5. 大/小文字区別 - 選択した一意キー列で大/小文字を区別するかどうかを指定します。デフォルトでは、これは「いいえ」に設定されます。

6. 一意列2 - データ・ロード表の一意キーの定義が、2つ以上の列から構成される複合キーの場合、データ・ロードの処理中に2番目の一意キーの列として使用される列名を選択します。

7. 大/小文字区別 - 選択した一意キー列で大/小文字を区別するかどうかを指定します。デフォルトでは、これは「いいえ」に設定されます。

8. 一意列3 - データ・ロード表の一意キーの定義が、2つ以上の列から構成される複合キーの場合、データ・ロードの処理中に3番目の一意キーの列として使用される列名を選択します。

9. 大/小文字区別 - 選択した一意キー列で大/小文字を区別するかどうかを指定します。デフォルトでは、これは「いいえ」に設定されます。

10. 「次へ」をクリックします。

6. トランスフォーメーション・ルールの追加(オプション)で、次を指定して「追加」をクリックします。

1. 順序: トランスフォーメーション・ルールの順序を指定します。これによって実行の順序が決まります。

2. ルール名: このトランスフォーメーション・ルールの名前を入力します。

3. 列の選択: トランスフォーメーションが必要な列の名前を選択し、右側に移動します。

4. タイプ: 実行するトランスフォーメーション・ルールのタイプを選択します。

5. 「次へ」をクリックします。

7. 追加するトランスフォーメーション・ルールごとに前のステップを繰り返し、「次へ」をクリックします。

8. 「表参照」(オプション)で、次のステップを実行します。

1. 列名 - 表参照定義の基礎とする列を指定します。

2. 所有者: 参照表の所有者を選択します。

3. 表名 - この表参照定義に使用される表を指定します。

4. 戻り列: 表参照で戻される列の名前を選択します。この値は、指定されたロード列に挿入されるもので、通常、外部キー・リレーションシップの親のキー値です。

5. アップロード列 - エンド・ユーザーによって戻り列のかわりにアップロードされる列の名前を選択します。これは、参照表の表示値を含む列です。

6. アップロード列2: 必要に応じて、戻り列を一意に識別するためにアップロードされる2番目の列の名前を選択します。

7. アップロード列3: 必要に応じて、戻り列を一意に識別するためにアップロードされる3番目の列の名前を選択します。

8. 「次へ」をクリックします。

9. 追加する表参照ごとに前のステップを繰り返し、「次へ」をクリックします。
ページ属性ページが表示され、作成されるデータ・ロード・ウィザードの各ページの短い説明が示されます。

10. 「ページ属性」で、必要に応じて、データ・ロード・ウィザードのページごとにデフォルトのページ名、ページ番号およびリージョン名を変更し、「次へ」をクリックします。

11. 「ナビゲーション・メニュー」で、このページに含めるナビゲーションのタイプを指定し、「次へ」をクリックします。ナビゲーション・オプションはカレント・アプリケーションのテーマに応じて決まります。

12. 「ボタンとブランチ」で、データ・ロード・ウィザードのページのボタンに使用するブランチを指定して、「次へ」をクリックします。

13. 確認ページを確認し、「作成」をクリックします。
ページ・デザイナが表示されます。

14. 「ページの保存と実行」をクリックして、データ・ロード・ウィザードをテストします。

ヒント:
データ・ロード・ウィザード・ページの作成後、変更が必要な場合は、次の項で説明するように、データ・ロード定義を削除するのではなく、新規ページを再作成することをお薦めします。

関連項目:
「データ・ロード・ページの再作成」および「ページ・デザイナでのページの管理」

25.1.3 データ・ロード・ページの再作成

データ・ロード・ウィザード・ページの変更が必要な場合は、データ・ロード定義を削除しないで、新規ページを再作成することをお薦めします。

データ・ロード定義を削除しないでデータ・ロード・ウィザード・ページを再作成するには、次のステップを実行します。

1. データ・ロード定義ページにナビゲートします。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。
共有コンポーネント・ページが表示されます。

4. 「データ参照」で、「データ・ロード定義」をクリックします。

2. 再作成するデータ・ロード定義をクリックします。
データ・ロード表の詳細ページが表示されます。

3. 「タスク」で、「データ・ロード・ページの再作成」をクリックします。
「データ・ロード・ウィザードの作成」のページ属性ページが表示されます。

4. ページごとに、該当する属性を編集し、「次へ」をクリックします。
属性の詳細は、フィールドレベル・ヘルプを参照してください。

5. 「確認」をクリックします。

25.1.4 データ・ロード定義の編集

データ・ロード定義は、アプリケーションのデータ・ロード・ウィザードで使用されるデータ・ロード表、表ルールおよび参照表で構成されます。データ・ロード表は、データをアップロードするデータ・ロード・プロセスで使用するために選択された、スキーマ内の既存の表です。

データ・ロード定義を編集するには、次のステップを実行します。

1. データ・ロード定義ページにナビゲートします。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。
共有コンポーネント・ページが表示されます。

4. 「データ参照」で、「データ・ロード定義」をクリックします。

2. 編集するデータ・ロード定義をクリックします。
データ・ロード表の詳細ページが表示されます。属性の詳細は、フィールドレベル・ヘルプを参照してください。

3. 「データ・ロード定義」で、次のように入力します。

- 名前 - データ・ロード定義の名前。

- データ・ロード表: データ・ロード表名を編集し、一意の列を追加、削除または編集します。

- 一意列1 - データ・ロードの処理で一意の主キー列として使用する列名。

- 大/小文字区別 - 選択した一意キー列1で大/小文字を区別するかどうかを指定します。デフォルトでは、これは「いいえ」に設定されます。

- 一意列2 - 選択した表の一意キーの定義が、2つ以上の列から構成される複合キーの場合、この列名が、データ・ロードの処理中に2番目の一意キーの列として使用されます。

- 大/小文字区別 - 選択した一意キー列2で大/小文字を区別するかどうかを指定します。デフォルトでは、これは「いいえ」に設定されます。

- 一意列3 - 選択した表の一意キーの定義が、2つ以上の列から構成される複合キーの場合、この列名が、データ・ロードの処理中に3番目の一意キーの列として使用されます。

- 大/小文字区別 - 選択した一意キー列3で大/小文字を区別するかどうかを指定します。デフォルトでは、これは「いいえ」に設定されます。

- 検証のスキップ - データ・ロードのステップの1つとして、アップロード対象のレコードに実行されるアクションを検証します。検証をスキップするには、「はい」を選択します。

4. 「トランスフォーメーション・ルール」には、以前定義したトランスフォーメーション・ルールがリストされます。

- 新規ルールを作成する手順は、次のとおりです。

1. 「トランスフォーメーション・ルールの作成」をクリックします。

2. 属性を編集します。
属性の詳細は、フィールドレベル・ヘルプを参照してください。

3. 「作成」をクリックします。

- 既存のルールを編集する手順は、次のとおりです。

1. ルール名をクリックします。

2. 属性を編集します。

3. 「変更の適用」をクリックします。

5. 表参照では、インポート・ファイルのデータを別の表にあるデータにマッピングします。

- 表参照を新規作成するには、次のステップを実行します。

1. 「表参照の作成」をクリックします。

2. 属性を編集します。

3. 「作成」をクリックします。

- 既存の表参照を編集するには、次のステップを実行します。

1. 列名をクリックします。

2. 属性を編集します。

3. 「変更の適用」をクリックします。

6. 列名の別名では、別名を定義して、ユーザーがアップロードする列を正しく識別できるようにします。
列名の別名を追加するには、次のステップを実行します。

1. 「LOVの編集」をクリックします。

2. 属性を編集します。

3. 「作成」をクリックします。

7. 「同時実行性列名」で、同時実効性管理に使用する列を選択します。
同時実行性により、開発者は、基礎となる表のデータ・バージョンを確認するための列を選択できます。これは、定期的に更新される表にアップロードする場合に特に重要です。

8. 「変更の適用」をクリックします。

25.2 コレクションの使用について

コレクションを使用すると、1つ以上の非スカラー値を一時的に取得できます。コレクションを使用して、現在セッション・ステートにある行および列を格納します。これによって、あるユーザーの特定のセッション中にそれらの行および列に対してアクセス、操作または処理を行うことができます。コレクションは、バケツのようなものと考えることができます。その中に情報の行を一時的に格納し、その情報を指定できます。

次に、コレクションを使用する場合の例を示します。

- データ入力ウィザードを作成しており、そのウィザードで、まず論理トランザクション中に複数行の情報を収集する必要がある場合。物理トランザクションと論理トランザクションの両方の完了時、ウィザードの最終ステップを実行する前に、コレクションを使用して、複数行の情報のコンテンツを一時的に格納できます。

- アプリケーションに、ユーザーが1つのページで複数の詳細行を更新する更新ページが含まれている場合。ユーザーは、複数の更新を行い、それらの更新をコレクションに適用した後、最終プロセスをコールしてそれらの変更をデータベースに適用できます。

- 任意の数の属性を収集するウィザードを構築している場合。コレクションに一時的に格納された情報が取得され、データベースに適用されるタスクをウィザードの最後にユーザーが実行するようにします。

コレクション情報は、PL/SQL API APEX_COLLECTIONを使用して挿入、更新および削除します。

関連項目:
『Oracle Application Express APIリファレンス』のAPEX_COLLECTIONに関する説明

25.3 Webサービスの実装

この項では、Oracle Application ExpressアプリケーションでWebサービスを使用する方法について説明します。

- Webサービスについて

- Oracle Application ExpressのWebサービス参照の作成

- SSL有効Webサービスでの作業について

- WSDLに基づいたWebサービス参照の作成

- Webサービス参照の手動作成

- RESTful Webサービス参照の作成

- Webサービス参照リポジトリの使用

- Webサービスでの入力フォームとレポートの作成

- Webサービスでのフォームの作成

- Webサービスをプロセスとして起動する方法

- Webサービス・プロセスの編集

- Webサービス参照履歴の表示

- RESTful Webサービスとしてのレポート・リージョンの公開

注意:
SOAP 1.1仕様はW3C技術ノートです。SOAPバージョン1.2仕様はW3C勧告です。
Simple Object Access Protocol(SOAP)については、次の場所を参照してください。

http://www.w3.org/TR/SOAP/

25.3.1 Webサービスについて

Webサービスを使用すると、プラットフォームおよび言語に依存しない環境で、Webを介したアプリケーション間の通信が可能になります。通常のWebサービス・シナリオでは、ビジネス・アプリケーションが、HTTPプロトコルを使用して、特定のURLにあるサービスに対してリクエストを送信します。サービスは、リクエストを受信すると、これを処理し、レスポンスを返します。外部Webサービスへのコールをアプリケーション・ビルダーで開発されたアプリケーションに組み込むことができます。

通常、Webサービスは、Simple Object Access Protocol(SOAP)またはRepresentational State Transfer(REST)アーキテクチャに基づいています。SOAPは、World Wide Web Consortium (W3C)が策定した、インターネットを介したリクエストとレスポンスの送受信用の標準プロトコルです。SOAPメッセージは、サービス・プロバイダとサービス・ユーザー間でSOAPエンベロープに入れて送受信できます。RESTful Webサービスはリソース指向です。WebサービスのスコープはURI内から検出され、サービスのメソッドは使用されるHTTPメソッドによって記述されます。これらのHTTPメソッドには、GET、POST、PUT、HEADおよびDELETEなどがあります。

SOAPには、主に2つのメリットがあります。

- SOAPはXMLをベースとしており、使用方法も容易です。

- このプロトコルではHTTPなどの単純な転送プロトコルが使用されているため、SOAPメッセージはファイアウォールでブロックされることはありません。

ヒント:
Oracle Application ExpressをOracle Database 11g リリース1 (11.1)以上とともに実行する場合は、Webサービスを使用するためにネットワーク・サービスを有効にする必要があります。「Oracle Database 11g以上のネットワーク・サービスの有効化」を参照してください

RESTには、同様のメリットがあります。

- このプロトコルではHTTPプロトコルが使用されるため、RESTメッセージもファイアウォールでブロックされません。

- RESTリクエストではXMLエンベロープやSOAPエンベロープのオーバーヘッドが不要であり、入力は、通常、URI内に指定されます。

25.3.2 Oracle Application ExpressのWebサービス参照の作成

Oracle Application ExpressでWebサービスを使用するには、ウィザードを使用してWebサービス参照を作成します。Webサービス参照は、Web Services Description Language(WSDL)ドキュメントに基づくか、RESTfulスタイルに基づくか、サービスに関する情報を指定して手動で作成することができます。

- Webサービス参照ページへのアクセス

- アプリケーション・プロキシ・サーバー・アドレスの指定

関連項目:
「WSDLに基づいたWebサービス参照の作成」、「Webサービス参照の手動作成」および「RESTful Webサービス参照の作成」

25.3.2.1 Webサービス参照ページへのアクセス

Webサービス参照は、Webサービス参照ページで管理します。

Webサービス参照ページにアクセスするには、次のステップを実行します。

1. 共有コンポーネント・ページにナビゲートします。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。
共有コンポーネント・ページが表示されます。

2. 「データ参照」で、「Webサービス参照」をクリックします。
Webサービス参照ページが表示されます。

25.3.2.2 アプリケーション・プロキシ・サーバー・アドレスの指定

インターネットのアクセスにプロキシ・サーバーが必要な環境の場合は、Webサービス参照を作成する前にアプリケーション属性ページでプロキシ・サーバー・アドレスを指定する必要があります。

アプリケーションにプロキシ・アドレスを指定するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。
アプリケーション・ビルダーのホームページが表示されます。

2. アプリケーションを選択します。
アプリケーションのホームページが表示されます。

3. 「アプリケーション・プロパティの編集」をクリックします。

4. 「プロパティ」の下の「プロキシ・サーバー」フィールドにプロキシ・サーバーを入力します。

5. 「変更の適用」をクリックします。

25.3.3 SSL有効Webサービスでの作業について

Secure Sockets Layer(SSL)は、RSA公開鍵による暗号化と対称鍵による暗号化を使用して、認証、暗号化およびデータの整合性を実現する業界標準プロトコルです。

通信する必要のあるWebサービスがSSL有効Webサービスの場合(つまり、Webサービスに対するURLにhttpsと表示される)、ウォレットを作成し、そのウォレットがOracle Application Expressによって使用されるように構成する必要があります。ウォレットは、SSLに必要な認証および署名された資格証明(秘密鍵、証明書および信頼できる証明書)の格納に使用されるパスワード保護されたコンテナです。

関連項目:
Oracle Application Express管理ガイドの「ウォレット情報の構成」

25.3.4 WSDLに基づいたWebサービス参照の作成

この項では、WSDLに基づいたWebサービス参照を作成する方法について説明します。

- WSDLに基づいたWebサービス参照の作成について

- WSDLドキュメントの指定によるWebサービス参照の作成

- WSDLから作成されたWebサービス参照のテスト

25.3.4.1 WSDLに基づいたWebサービス参照の作成について

WSDLに基づいてWebサービス参照を作成する前に、WSDLの位置の特定方法を決定する必要があります。WSDLの位置の特定には、次の2つの方法があります。

- Universal Description, Discovery and Integration (UDDI)レジストリを検索する

- WSDLドキュメントのURLを入力する

ヒント:
UDDIレジストリは企業がWebサービスを登録するディレクトリです。

WSDLに基づいてWebサービス参照を作成する場合、ウィザードはWSDLを分析し、すべての必要な情報を収集して、次を含んだ有効なSOAPメッセージを作成します。

- HTTP(S)を介したSOAPリクエストのポストに使用するURL

- SOAP HTTPリクエストを識別するUniversal Resource Identifier(URI)

- Webサービスの操作

- 各操作の入力パラメータ

- 各操作の出力パラメータ

25.3.4.2 WSDLドキュメントの指定によるWebサービス参照の作成

特定のWSDLドキュメントへのURLを指定して、Webサービスを作成するには、次のステップを実行します。

1. Webサービス参照ページにナビゲートします。「Webサービス参照ページへのアクセス」を参照してください。

2. 「作成」をクリックします。

3. 「Web参照タイプ」で、「WSDLに基づく」を選択し、「次へ」をクリックします。

4. WSDLを検出するためにUDDIレジストリを検索することを確認するプロンプトが表示されたら、「いいえ」の次に「次へ」をクリックします。

5. 「WSDLの位置」に、WSDLドキュメントへのURLを入力します。

6. 「ユーザー名」で、WSDLへのアクセスに必要なユーザー名を入力します。

7. 「パスワード」で、WSDLへのアクセスに必要なパスワードを入力します。

8. 「次へ」をクリックします。
Webサービスの詳細ページが表示されます。

9. 「基本認証」で次を選択します。

- いいえ: 認証資格証明をHTTPリクエストの一部として送信しない場合は、このオプションを選択します。

- はい: 認証資格証明をHTTPリクエストの一部として送信する場合は、このオプションを選択します。ユーザー名とパスワードがクリア・テキストで送信されるため、基本認証を使用するWebサービスでは、通常、HTTPS (SSL)プロトコルも使用されます。

10. 「参照の作成」をクリックします。
Webサービス参照がWebサービス参照リポジトリに追加されます。

11. 作成ページで、次を選択できます。

- Webサービス参照の表示: Webサービス参照ページに移動する場合に選択します。

- Webサービスのフォームの作成: このWebサービス参照のフォームを作成する場合に選択します。「参照を作成した後のフォームの作成」を参照してください。

- Webサービスのフォームとレポートの作成: このWebサービス参照のフォームとレポートを作成する場合に選択します。「参照を作成した後のフォームとレポートの作成」を参照してください。

25.3.4.3 WSDLから作成されたWebサービス参照のテスト

Webサービス参照を作成した後、Webサービス参照のテスト・ページでテストできます。

Webサービス参照をテストするには、次のステップを実行します。

1. Webサービス参照ページにナビゲートします。「Webサービス参照ページへのアクセス」を参照してください。

2. 「レポートの表示」アイコンを選択します。

3. テストするWebサービス参照の「テスト」アイコンをクリックします。
Webサービス参照のテスト・ページが表示されます。ページの上部に、Webサービス名とURLエンドポイントが表示されます。

4. 「操作」から、実行する操作を選択します。

5. 「入力パラメータ」で、適切な値を入力します。

6. 「テスト」をクリックします。
ページの下部の「メッセージ」の下に、メッセージ・リクエストとレスポンスが表示されます。

25.3.5 Webサービス参照の手動作成

この項では、Webサービス参照を手動で作成する方法について説明します。

- Webサービス参照の手動作成について

- Webサービス参照の手動作成

- 手動作成されたWebサービス参照のテスト

25.3.5.1 Webサービス参照の手動作成について

手動でWebサービス参照を作成する場合、必要な情報を指定して、次を含んだ有効なSOAPリクエストを作成します。

- HTTP(S)を介したSOAPリクエストのポストに使用するURL

- SOAP HTTPリクエストを識別するUniversal Resource Identifier(URI)

- アイテムの置換を含んだリクエストのSOAPエンベロープ

- オプションで、Webサービスからのレスポンスを格納するコレクション名

25.3.5.2 Webサービス参照の手動作成

Webサービス参照を手動作成するには、次のステップを実行します。

1. Webサービス参照ページにナビゲートします。「Webサービス参照ページへのアクセス」を参照してください。

2. 「作成」をクリックします。

3. 「手動」を選択し、「次へ」をクリックします。
Webサービスの作成/編集ページが表示されます。

4. 「Webサービス」の下の「名前」で、参照を識別するための名前を入力します。

5. 「サービスの説明」で、次の変更を行います。

1. URL: HTTPを介したSOAPリクエストのポストに使用するURLを入力します。これは、WSDLのサービス・ポートのsoap:addressの位置に対応します。

2. アクション: SOAP HTTPリクエストの目的を入力します(オプション)。値は目的を識別するURIです。SOAPは、URIの形式や特性、または変換可能かどうかについて制限を加えません。

3. プロキシ: このサービスのアプリケーション・プロキシを上書きするプロキシを入力します。

4. SOAPのバージョン: 「1.1」または「1.2」を選択します。

5. Basic認証: Webサービスが認証を必要とするかどうかを選択します。「はい」または「いいえ」を選択します。

6. 「SOAPエンベロープ」の下の「SOAPエンベロープ」で、WebサービスへのSOAPリクエストに使用するSOAPエンベロープを入力します。

注意:
#ITEM_NAME#構文を使用すると、SOAPエンベロープのセッション・ステートからアイテムを参照できます。

7. 「SOAPレスポンス」の下の「コレクションにレスポンスを格納」で、レスポンスを格納するコレクション名を入力します(オプション)。レスポンスはCLOB001列に格納されます。

8. 「作成」をクリックします。

Webサービス参照がWebサービス参照リポジトリに追加されます。

25.3.5.3 手動作成されたWebサービス参照のテスト

Webサービス参照を作成した後、Webサービス参照のテスト・ページでテストできます。

Webサービス参照をテストするには、次のステップを実行します。

1. Webサービス参照ページにナビゲートします。「Webサービス参照ページへのアクセス」を参照してください。

2. 「レポートの表示」アイコンを選択します。

3. テストするWebサービス参照の「テスト」アイコンをクリックします。
Webサービス参照のテスト・ページが表示されます。ページの上部に、Webサービス名とURLエンドポイントが表示されます。

4. 必要に応じて、「Basic認証」でユーザー名およびパスワードを入力します。

5. 「SOAPエンベロープ」テキスト領域では、オプションで、SOAPリクエスト・エンベロープを編集します。

6. 「テスト」をクリックします。
ページの下部の「メッセージ」の下に、メッセージ・リクエストとレスポンスが表示されます。

25.3.6 RESTful Webサービス参照の作成

この項では、RESTful Webサービス参照を作成する方法について説明します。

- RESTful Webサービス参照の作成について

- RESTful Webサービス参照の作成

- REST Webサービス参照のテスト

25.3.6.1 RESTful Webサービス参照の作成について

RESTful Webサービス参照を作成する場合、次を含むリクエストおよびレスポンスの構造に関する必要な情報を指定します。

- RESTfulリクエストを識別するUniversal Resource Identifier(URI)

- Webサービスのメソッドを識別するHTTPメソッド

- リクエストの一部であるHTTPヘッダー(必要に応じて)

- Webサービスに必要な入力のタイプ

- レスポンスの書式およびレスポンス・パラメータの識別方法

25.3.6.2 RESTful Webサービス参照の作成

RESTful Webサービス参照を作成するには、次のステップを実行します。

1. Webサービス参照ページにナビゲートします。「Webサービス参照ページへのアクセス」を参照してください。

2. 「作成」をクリックします。

3. 「REST」を選択して「次へ」をクリックします。

4. 「RESTの詳細」で、次のように指定します。

1. 名前: 参照を識別する名前を入力します。

2. URL: WebサービスのURLエンドポイントを入力します。

3. プロキシ: このサービスのアプリケーション・プロキシを上書きするプロキシを入力します(オプション)。この設定は、このインスタンスのプロキシ設定によってオーバーライドされます。『Oracle Application Express管理ガイド』のインスタンス用のプロキシ・サーバーの作成に関する説明を参照してください。

4. HTTPメソッド: Webサービスへのリクエストに使用するhttpメソッドを選択します。「GET」、「HEAD」、「POST」、「PUT」または「DELETE」を選択します。

5. 基本認証: HTTP基本認証が必要な場合は「はい」を選択します。そうでない場合は、「いいえ」を選択します。

6. REST HTTPヘッダー: リクエストで送信するHTTPヘッダーの名前を入力します。

7. 「次へ」をクリックします。

5. 「REST入力パラメータ」で、次のように指定します。

1. 名前: メソッドに必要な入力パラメータの名前を入力します。

2. タイプ: 入力タイプを選択します。

3. 「パラメータの追加」をクリックします。

4. 必要な各入力に対して、ステップaからcを繰り返します。

5. 「次へ」をクリックします。

6. 「REST出力パラメータ」で、次のように指定します。

1. 出力形式: Webサービスから返されるレスポンス形式について「XML」、「テキスト」または「JSON」を選択します。

2. 出力パラメータへのXPath(XMLのみ): レスポンスの関連部分へのXPath式を入力します。
次に例を示します。

/ListBucketResult/Contents

3. レスポンス・ネームスペース(XMLのみ): レスポンスXPathに対応する名前空間を入力します。
次に例を示します。

http://s3.amazonaws.com/doc/2006-03-01/

4. パラメータ・デリミタ(テキストのみ): Webサービスから返されるパラメータを区切る文字または順序を入力します。新しい行を表すには\nを、タブ文字を表すには\tを使用します。

5. 新規レコード・デリミタ(テキストのみ): Webサービスからのテキスト・レスポンスに含まれる新規レコードを特定する文字または順序を入力します。新しい行を表すには\nを、タブ文字を表すには\tを使用します。

6. 名前: メソッドによって戻される出力パラメータの名前を入力します。

7. パス: パスを入力します。レスポンスがXMLの場合、パスはノードへのXPath式です。レスポンスがテキストの場合、パスは数値です。レスポンスがJSONの場合は、指定したコレクションのCLOB001列にレスポンス全体が格納されます。

8. タイプ: 出力タイプを選択します。

9. 「パラメータの追加」をクリックします。

10. 返される各出力パラメータに対して、ステップfからhを繰り返します。

注意:
「テスト」をクリックしてRESTful Webサービスにリクエストを送信し、レスポンスを確認します。このテスト・プロセスは、適切な出力パラメータを指定する際に役立ちます。

7. 「作成」をクリックします。

Webサービス参照の作成成功ページが表示されます。Webサービス参照がWebサービス参照リポジトリに追加されます。

25.3.6.3 REST Webサービス参照のテスト

Webサービス参照を作成した後、Webサービス参照のテスト・ページでテストできます。

Webサービス参照をテストするには、次のステップを実行します。

1. Webサービス参照ページにナビゲートします。「Webサービス参照ページへのアクセス」を参照してください。

2. 「レポートの表示」アイコンを選択します。

3. テストするWebサービス参照の「テスト」アイコンをクリックします。
Webサービス参照のテスト・ページが表示されます。ページの上部に、Webサービス名とURLエンドポイントが表示されます。

4. 「URL」および「プロキシ・オーバーライド」フィールドで、オプションでテストの値を編集します。

5. 必要に応じて、「Basic認証」でユーザー名およびパスワードを入力します。

6. 「HTTPヘッダー」で、適切な値を入力します。

7. 「入力パラメータ」で、適切な値を入力します。

8. 「テスト」をクリックします。
ページの下部の「メッセージ」の下に、メッセージのレスポンスが表示されます。

25.3.7 Webサービス参照リポジトリの使用

Webサービス参照がWebサービス参照リポジトリに格納されます。

Webサービス参照リポジトリにアクセスするには、次のステップを実行します。

1. Webサービス参照ページにナビゲートします。「Webサービス参照ページへのアクセス」を参照してください。
Webサービス参照ページが表示されます。

検索バーがページの上部に表示されます。使用可能なコントロールは次のとおりです。

- 「列の検索」アイコン: 虫めがねに似ています。このアイコンをクリックして、検索を絞り込みます。すべての列を検索するには、「すべての列」を選択します。

- テキスト領域: 大/小文字を区別しない検索基準(ワイルドカード文字を含む)を入力し、「実行」をクリックします。

- 「実行」ボタン: 検索を実行したり、フィルタを適用します。

- アイコンの表示: 各Webサービス参照を大きいアイコンとして表示します。Webサービス参照を編集するには、該当するアイコンをクリックします。

- レポートの表示: 各Webサービス参照をレポート内の1行として表示します。

- アクション・メニュー: アクション・メニューを表示します。レポート・ビューをカスタマイズするにはこのメニューを使用します。「「アクション」メニューについて」を参照してください。

2. 「レポートの表示」アイコンをクリックします。

3. レポート・ビューでは、次の操作が可能です。

- 参照名をクリックして参照を編集します。

- 「テスト」アイコンをクリックして参照をテストします。

- 「ビュー」アイコンをクリックして参照に関する詳細を表示します。このオプションは、手動作成されたWebサービス参照またはREST Webサービス参照には使用できないことに注意してください。

25.3.8 Webサービスでの入力フォームとレポートの作成

この項では、Webサービスの入力フォームとレポートを作成する方法について説明します。

- Webサービスのフォームとレポートの作成ウィザードについて

- 参照を作成した後のフォームとレポートの作成

- 新しいページの追加によるフォームとレポートの作成

25.3.8.1 Webサービスのフォームとレポートの作成ウィザードについて

Webサービスのフォームとレポートの作成ウィザードでは、入力フォーム、送信ボタンおよび結果を表示するレポートが作成されます。WSDLまたはRESTfulスタイルWebサービスからWebサービス参照を作成した直後に、またはページを追加して、このウィザードを実行できます。

このウィザードは、Webサービスの結果が非スカラーであることが予想される場合に使用します。Amazon社のProduct API Webサービスがよい例です。このWebサービスでは、入力フォームに入力された検索基準に基づいて多くの結果が戻されます。

25.3.8.2 参照を作成した後のフォームとレポートの作成

Webサービス参照を作成した後に、フォームとレポートを作成するには、次のステップを実行します。

1. Webサービス参照を作成します。「WSDLに基づいたWebサービス参照の作成」および「RESTful Webサービス参照の作成」を参照してください。

2. Webサービス参照が追加された後で、「Webサービスのフォームとレポートの作成」を選択します。

3. 「サービスと操作の選択」で、次の選択を行い、「次へ」をクリックします。

1. Webサービス参照: Webサービス参照を選択します。

2. 操作: 実行方法を選択します。RESTスタイルWeb参照の場合、「doREST」を選択します。

3. ユーザー・インタフェース: デスクトップ用のフォームとレポートを作成する場合は、「デスクトップ」を選択します。携帯電話用のフォームとレポートを作成する場合は、「jQuery Mobileスマートフォン」を選択します。「jQuery Mobileスマートフォン」オプションは、アプリケーション・プロパティのユーザー・インタフェース・オプションで「jQuery Mobileスマートフォン」が選択されている場合にのみ使用可能です。「アプリケーションのユーザー・インタフェースの管理」を参照してください。

4. 「ページおよびリージョン属性」で、表示された属性を確認し、「次へ」をクリックします。

注意:
指定したページが存在しない場合は、ウィザードによってページが作成されます。

5. 「入力アイテム」で、次の選択を行い、「次へ」をクリックします。

1. フォームに追加するアイテムを指定します。アイテムを含めるには、「作成」列で「はい」を選択します。そうでない場合は、「いいえ」を選択します。

2. 必要に応じて、アイテム名を編集します。

3. 必要に応じて、アイテム・ラベルを編集します。

6. 該当する場合、Basic認証に「アイテム名」および「アイテム・ラベル」を指定して「次へ」をクリックします。

注意:
このステップは、Webサービス参照を作成したときに、Basic認証がこのWebサービス参照に対して指定された場合にのみ表示されます。

7. ウィンドウ・サービスの結果で、次の選択を行い、「次へ」をクリックします。

1. 一時結果セット名: Webサービスの結果を格納するコレクションの名前を入力します。

2. レポート対象の結果ツリー(RESTスタイルWebサービス参照では表示されない): レポートに含める情報を格納する、作成されるXML文書の一部を選択します。

8. 「レポート・パラメータ」で、レポートに含めるパラメータを選択し、「次へ」をクリックします。

9. 「タブ・オプション」で、ページにタブを含めるかどうかとタブの作成方法を選択し、「次へ」をクリックします。

10. 確認ページを確認して、「作成」をクリックします。

25.3.8.3 新しいページの追加によるフォームとレポートの作成

既存のWebサービス参照がある場合は、新しいページを追加して、入力フォームとレポートを作成できます。

新しいページを追加して、フォームとレポートを作成するには、次のステップを実行します。

1. Webサービス参照を作成します。「WSDLに基づいたWebサービス参照の作成」、「Webサービス参照の手動作成」および「RESTful Webサービス参照の作成」を参照してください。

2. 新しいページを作成します。「データベース・アプリケーションのページの管理」を参照してください。
「ページの作成」ウィザードで、次のステップを実行します。

1. 「ユーザー・インタフェース」で、「デスクトップ」を選択して、デスクトップのフォームおよびレポートを作成します。携帯電話用のフォームとレポートを作成する場合は、「jQuery Mobileスマートフォン」を選択します。「jQuery Mobileスマートフォン」オプションは、アプリケーション・プロパティのユーザー・インタフェース・オプションで「jQuery Mobileスマートフォン」が選択されている場合にのみ使用可能です。「アプリケーションのユーザー・インタフェースの管理」を参照してください。

2. 「フォーム」を選択して、「次へ」をクリックします。

3. 「Webサービスのフォームとレポート」を選択し、「次へ」をクリックします。

3. 「サービスと操作の選択」で、次の選択を行い、「次へ」をクリックします。

1. Webサービス参照: Webサービス参照を選択します。

2. 操作: 実行方法を選択します。RESTfulスタイルWeb参照の場合、doRESTが自動的に選択されます。手動スタイルWeb参照については、「操作」オプションは表示されません。

4. 「ページおよびリージョン属性」で、ページおよびリージョンの属性を確認し、「次へ」をクリックします。

注意:
指定したページが存在しない場合は、ウィザードによってページが作成されます。

5. 「入力アイテム」で、次の選択を行い、「次へ」をクリックします。

1. フォームに追加するアイテムを指定します。アイテムを含めるには、「作成」列で「はい」を選択します。そうでない場合は、「いいえ」を選択します。

2. 必要に応じて、アイテム名を編集します。

3. 必要に応じて、アイテム・ラベルを編集します。

6. 該当する場合、Basic認証に「アイテム名」および「アイテム・ラベル」を指定し、「次へ」をクリックします。

注意:
このステップは、Webサービス参照を作成したときに、Basic認証がこのWebサービス参照に対して指定された場合にのみ表示されます。

7. 画面に表示されるステップに従います。

8. 「終了」をクリックします。

25.3.9 Webサービスでのフォームの作成

この項では、Webサービスのフォームを作成する方法について説明します。

- Webサービスのフォームの作成ウィザードについて

- 参照を作成した後のフォームの作成

- 新しいページの追加によるフォームの作成

25.3.9.1 Webサービスのフォームの作成ウィザードについて

Webサービスのフォームの作成ウィザードでは、フォームと送信ボタンが作成されます。WSDLから、またはRESTfulスタイルのWebサービスで、Webサービス参照を作成した後に、またはページの作成ウィザードを実行することで、このウィザードを実行できます。

このウィザードは、Webサービスの結果がスカラーであることが予想される場合に使用します。株価を調べるWebサービスがよい例です。入力は銘柄記号で、出力はスカラーの適正価格であるためです。

25.3.9.2 参照を作成した後のフォームの作成

Webサービス参照を作成した後に、フォームを作成するには、次のステップを実行します。

1. Webサービス参照を作成します。「WSDLに基づいたWebサービス参照の作成」、「Webサービス参照の手動作成」および「RESTful Webサービス参照の作成」を参照してください。

2. Webサービス参照が追加された後で、「Webサービスのフォームの作成」を選択します。

3. 「サービスと操作の選択」で、次の選択を行い、「次へ」をクリックします。

1. Webサービス参照: Webサービス参照を選択します。

2. 操作: 実行方法を選択します。RESTfulスタイルWeb参照の場合、doRESTが自動的に選択されます。手動スタイルWeb参照については、「操作」オプションは表示されません。

3. ユーザー・インタフェース: デスクトップ用のフォームとレポートを作成する場合は、「デスクトップ」を選択します。携帯電話用のフォームとレポートを作成する場合は、「jQuery Mobileスマートフォン」を選択します。「jQuery Mobileスマートフォン」オプションは、アプリケーション・プロパティのユーザー・インタフェース・オプションで「jQuery Mobileスマートフォン」が選択されている場合にのみ使用可能です。「アプリケーションのユーザー・インタフェースの管理」を参照してください。

4. 「ページおよびリージョン属性」で、ページおよびリージョンの属性を確認し、「次へ」をクリックします。

注意:
指定したページが存在しない場合は、ウィザードによってページが作成されます。

5. 「入力アイテム」で、次の選択を行い、「次へ」をクリックします。

1. フォームに追加するアイテムを指定します。アイテムを含めるには、「作成」列で「はい」を選択します。そうでない場合は、「いいえ」を選択します。

2. 必要に応じて、アイテム名を編集します。

3. 必要に応じて、アイテム・ラベルを編集します。

6. 該当する場合、Basic認証に「アイテム名」および「アイテム・ラベル」を指定して「次へ」をクリックします。

注意:
このステップは、Webサービス参照を作成したときに、Basic認証がこのWebサービス参照に対して指定された場合にのみ表示されます。

7. 該当する場合、Basic認証に「アイテム名」および「アイテム・ラベル」を指定します。
このステップは、Webサービス参照を作成したときに、Basic認証がこのWebサービス参照に対して指定された場合にのみ表示されることに注意してください。

8. 「出力アイテム」で、次の選択を行い、「次へ」をクリックします。

1. フォームに追加するアイテムを指定します。アイテムを含めるには、「作成」列で「はい」を選択します。そうでない場合は、「いいえ」を選択します。

2. 必要に応じて、アイテム名を編集します。

3. 必要に応じて、アイテム・ラベルを編集します。

9. 「タブ・オプション」で、ページにタブを含めるかどうかとタブの作成方法を選択し、「次へ」をクリックします。

10. 確認ページを確認して、「作成」をクリックします。

25.3.9.3 新しいページの追加によるフォームの作成

既存のWebサービス参照がある場合は、新しいページを追加することで、Webサービス参照を基にフォームを作成できます。

新しいページを追加して、フォームを作成するには、次のステップを実行します。

1. Webサービス参照を作成します。「WSDLに基づいたWebサービス参照の作成」、「Webサービス参照の手動作成」および「Webサービス参照の手動作成」を参照してください。

2. 新しいページを作成します。「データベース・アプリケーションのページの管理」を参照してください。
「ページの作成」ウィザードで、次のステップを実行します。

1. 「ユーザー・インタフェース」で、「デスクトップ」を選択して、デスクトップのフォームおよびレポートを作成します。携帯電話用のフォームとレポートを作成する場合は、「jQuery Mobileスマートフォン」を選択します。「jQuery Mobileスマートフォン」オプションは、アプリケーション・プロパティのユーザー・インタフェース・オプションで「jQuery Mobileスマートフォン」が選択されている場合にのみ使用可能です。「アプリケーションのユーザー・インタフェースの管理」を参照してください。

2. 「フォーム」を選択して、「次へ」をクリックします。

3. 「Webサービスのフォーム」を選択し、「次へ」をクリックします。

3. 「サービスと操作の選択」で、次の選択を行い、「次へ」をクリックします。

1. Webサービス参照: Webサービス参照を選択します。

2. 操作: 実行方法を選択します。RESTfulスタイルWeb参照の場合、doRESTが自動的に選択されます。手動スタイルWeb参照については、「操作」オプションは表示されません。

4. 「ページおよびリージョン属性」で、ページおよびリージョンの属性を確認し、「次へ」をクリックします。

注意:
指定したページが存在しない場合は、ウィザードによってページが作成されます。

5. 「入力アイテム」で、次の選択を行い、「次へ」をクリックします。

1. フォームに追加するアイテムを指定します。アイテムを含めるには、「作成」列で「はい」を選択します。そうでない場合は、「いいえ」を選択します。

2. 必要に応じて、アイテム名を編集します。

3. 必要に応じて、アイテム・ラベルを編集します。

6. 該当する場合、Basic認証に「アイテム名」および「アイテム・ラベル」を指定して「次へ」をクリックします。

注意:
このステップは、Webサービス参照を作成したときに、Basic認証がこのWebサービス参照に対して指定された場合にのみ表示されます。

7. 該当する場合、Basic認証に「アイテム名」および「アイテム・ラベル」を指定します。
このステップは、Webサービス参照を作成したときに、Basic認証がこのWebサービス参照に対して指定された場合にのみ表示されることに注意してください。

8. 「出力アイテム」で、次の選択を行い、「次へ」をクリックします。

1. フォームに追加するアイテムを指定します。アイテムを含めるには、「作成」列で「はい」を選択します。そうでない場合は、「いいえ」を選択します。

2. 必要に応じて、アイテム名を編集します。

3. 必要に応じて、アイテム・ラベルを編集します。

9. 「タブ・オプション」で、ページにタブを含めるかどうかとタブの作成方法を選択し、「次へ」をクリックします。

10. 確認ページを確認して、「作成」をクリックします。

25.3.10 Webサービスをプロセスとして起動する方法

Webサービスをページ上でプロセスとして起動することもできます。Webサービス用のいずれかのフォームの作成ウィザードを実行すると、プロセスが作成されます。このプロセスを実行すると、リクエストがサービス・プロバイダに送信されます。その後で、レポートにリクエスト結果を表示できます。

- プロセスとしてのWebサービスの起動

- レポートでのWebサービス結果の表示

25.3.10.1 プロセスとしてのWebサービスの起動

Webサービスをプロセスとして起動するには、次のステップを実行します。

1. Webサービス参照を作成します。「WSDLに基づいたWebサービス参照の作成」、「Webサービス参照の手動作成」または「RESTful Webサービス参照の作成」を参照してください。

2. ページを作成します。「データベース・アプリケーションのページの管理」を参照してください。
「ページの作成」ウィザードで、次のステップを実行します。

1. 「空白ページ」を選択します。

2. ナビゲーション・メニューを使用するかどうかを尋ねるプロンプトが表示された場合は、「いいえ」を選択します。

3. 「ページの編集」をクリックします。「コンポーネント・ビューでのページ属性の編集」を参照してください。

4. 「ページ・レンダリング」または「ページ・プロセス」で、「プロセス」セクションを探し、右クリックして「プロセスの作成」をクリックします。
ページ・プロセスの作成ウィザードが表示されます。

5. 「プロセス・タイプ」で、「Webサービス」を選択して「次へ」をクリックします。

6. 「プロセス属性」で、次のように指定し、「次へ」をクリックします。

1. 名前: プロセス名を入力します。

2. 順序: このコンポーネントの順序を入力します。これによって評価の順序が決まります。

3. ポイント: プロセス・ポイントを選択します。

7. 「プロセス」で、次のように指定します。

1. Webサービス参照: このプロセスのWebサービス参照を選択します。
Web参照がWSDLから作成されたか、またはRESTfulスタイルである場合、「操作」の選択が表示されます。

2. 操作(WSDLまたはRESTfulスタイルWebサービス参照のみ): このプロセスが実行するWebサービス操作を選択します。
「Webサービスの入力パラメータ」と「Webサービスの出力パラメータ」が表示されます。

3. 「Webサービスの入力パラメータ」で、Webサービス・プロセスの入力を指定します。

- ソース: ソース・タイプを選択します。

- 値: ソース値を選択します。

4. 「Webサービスの出力パラメータ」で、結果の格納先を指定します。
コレクションに結果を格納するには、次のステップを実行します。

- 結果の格納場所: 「コレクション」を選択します。

- 値: コレクションの名前を入力します。

ページ上のアイテムに結果を格納するには、次のステップを実行します。

- 結果の格納場所: 「アイテム」を選択します。

- 値: 適切なアイテム値を選択します。

5. 「次へ」をクリックします。

8. 「メッセージ」で、次を入力し、「次へ」をクリックします。

1. 成功メッセージ: プロセスが正常に実行された場合に次のページに表示されるメッセージを入力します。

2. 失敗メッセージ: 未処理例外が発生した場合に表示されるメッセージを入力します。エラー・プロセスが停止した後は、常にロールバックが実行され、エラー・メッセージが表示されます。

9. 「プロセス条件」で、次の選択を行い、「次へ」をクリックします。

1. 対象ボタン: プロセスを実行させるボタンを選択します。

2. 条件タイプ: このコンポーネントを処理するために満たされる必要がある条件タイプを選択します。条件タイプに比較用の式が必要な場合、「式1」と、場合によっては「式2」フィールドが表示されます。必要に応じてこれらのフィールドに式を入力します。

10. 「プロセスの作成」をクリックします。

25.3.10.2 レポートでのWebサービス結果の表示

Webサービスのリクエスト結果を表示するレポートを作成するには、次のステップを実行します。

1. ページに移動します。「コンポーネント・ビューでのページの表示」を参照してください。

2. コンポーネント・ビューで、「リージョン」に対して「作成」アイコンをクリックします。
「リージョンの作成」ウィザードが表示されます。

3. リージョン・タイプで、「レポート」を選択し、「次へ」をクリックします。

4. 「リージョン」で、「Webサービスの結果」を選択し、「次へ」をクリックします。

5. 「表示属性」で、リージョン・タイトルを入力し、オプションでリージョン属性を編集し、「次へ」をクリックします。

6. Web参照がWSDLから手動で作成されたか、またはRESTfulスタイルであるかを選択し、「次へ」をクリックします。

7. Webサービス参照がWSDLから作成された場合、次のステップを実行します。

1. 「Webサービス参照」で、実行するWebサービス参照を選択します。

2. 「操作」で、実行するメソッドを選択します。

3. 「レポート対象の結果ツリー」で、作成されるXML文書(レポートに含める情報を含む)の一部を選択します。

4. 「レポート・パラメータとレポート・オプション」で、次を行います。

- 「一時結果セット名」に、Webサービスの結果を格納するコレクションの名前を入力します。

- 該当するパラメータを選択した後、選択解除します。

8. Webサービス参照が手動で作成された場合、次のステップを実行します。

1. Webサービス参照を選択します。

2. SOAPスタイルを選択します。

3. メッセージの書式を選択します。

4. レポートの対象となるノードへのXPath式を入力します。

5. SOAPレスポンス・エンベロープのネームスペースを入力し、「次へ」をクリックします。

6. レスポンス・メッセージが格納されているコレクション名を入力します。

7. レポートに含めるパラメータ名を入力します。

9. Webサービス参照がRESTスタイルの場合、次のステップを実行します。

1. Webサービス参照を選択します。

2. レスポンス・メッセージが格納されているコレクション名を入力します。

3. レポート・テンプレートと、ページごとに表示される行数を選択します。

4. レポートに含めるパラメータを選択します。

10. 「SQLレポートの作成」をクリックします。

25.3.11 Webサービス・プロセスの編集

WSDLから作成されたWebサービス参照またはRESTfulスタイルのWeb参照でWebサービス・タイプのプロセスを作成した後、サービスへの入力パラメータおよび出力パラメータの属性を変更できます。

Webサービス・プロセスを編集するには、次のステップを実行します。

1. Webサービス・プロセスを作成します。「Webサービスをプロセスとして起動する方法」を参照してください。

2. Webサービス・プロセスが含まれているページにナビゲートします。

3. プロセス名を選択します。
「ページ・プロセスの編集」ページが表示されます。

4. 入力パラメータを静的な値にマップするには、次のステップを実行します。

1. 「Webサービスの入力パラメータ」までスクロールします。

2. 該当するパラメータ名の横にある「値」フィールドに値を入力します。

5. 出力パラメータをコレクションにマップするには、次のステップを実行します。

1. 「Webサービスの出力パラメータ」までスクロールします。

2. レスポンスの格納場所で、「コレクション」を選択します。

3. 「値」で、レスポンスを格納するコレクションの名前を入力します。レスポンスは、予想されるレスポンスに基づいてCLOB001またはXMLTYPE001に格納されます。

6. 出力パラメータをアイテムにマップするには、次のステップを実行します。

1. 「Webサービスの出力パラメータ」までスクロールします。

2. レスポンスの格納場所で、「アイテム」を選択します。

3. 該当するパラメータ名の横にある「値」フィールドにアイテム名を入力します。

7. 「変更の適用」をクリックします。

25.3.12 Webサービス参照履歴の表示

「Webサービス履歴」では、カレント・アプリケーションのWebサービス参照の変更が、アプリケーションID、Webサービス参照名、開発者および日付ごとに表示されます。

Webサービス参照の変更履歴を表示するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。
共有コンポーネント・ページが表示されます。

4. 「ロジック」で、「Webサービス参照」をクリックします。

5. 「履歴」をクリックします。

注意:
Webサービス参照ページに「履歴」ボタンが表示されるのは、1つ以上の参照が存在する場合のみです。

25.3.13 RESTful Webサービスとしてのレポート・リージョンの公開

この項では、レポート・リージョンをRESTful Webサービスとして公開する方法について説明します。

- RESTful Webサービスとしてのレポート・リージョンの公開について

- レポート・リージョンへのRESTfulアクセスの有効化

- Webサービス・クライアントからのRESTful有効レポート・リージョンへのアクセスについて

関連項目:
『Oracle Application Express SQLワークショップ・ガイド』のRESTfulサービスの使用に関する説明を参照してください。

25.3.13.1 RESTful Webサービスとしてのレポート・リージョンの公開について

RESTful Webサービスとしてレポート・リージョンを公開するには、次のステップを実行します。

- ステップ1: インスタンス管理者は、インスタンス設定のRESTプロバイダ機能を有効化する必要があります。Oracle Application ExpressインスタンスへのRESTfulアクセスを有効化するには、『Oracle Application Express管理ガイド』のRESTfulアクセスの有効化に関する説明を参照してください。

- ステップ2: 開発者はレポート・リージョンへのRESTfulアクセスを有効化する必要があります。「レポート・リージョンへのRESTfulアクセスの有効化」を参照してください。

- ステップ3: レポートが格納されているページでは、認証が要求されないようにする必要があります。

25.3.13.2 レポート・リージョンへのRESTfulアクセスの有効化

レポート・リージョンへのRESTfulアクセスを有効化するには、認証が不要になるようにページを公開し、レポートをRESTfulアクセスのために有効化する必要があります。

ヒント:
Oracle Application ExpressインスタンスへのRESTfulアクセスを有効化するには、『Oracle Application Express管理ガイド』のRESTfulアクセスの有効化に関する説明を参照してください。

レポート・リージョンへのRESTfulアクセスを有効化するには、次のステップを実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。
アプリケーション・ビルダーのホームページが表示されます。

2. アプリケーションを選択します。

3. 有効化するレポートを含むページをコンポーネント・ビューで表示します。「コンポーネント・ビューでのページの表示」を参照してください。

4. ページを公開するには、次のステップを実行します。

1. 「ページ」で、「すべて編集」アイコンをクリックします。

2. 「セキュリティ」で、「認証」リストから「パブリック・ページ」を選択します。

3. 「変更の適用」をクリックします。

5. レポート・リージョンをRESTfulアクセス用に有効化するには、次のステップを実行します。

1. 「リージョン」で、有効化するレポートが格納されているリージョンの名前をクリックします。

2. 「属性」で、「静的ID」フィールドの値を入力します。この値はレポートにRESTfulにアクセスするために使用されます。

3. 「RESTfulアクセスの有効化」リストで、「はい」を選択します。

注意:
「RESTfulアクセスの有効化」リスト・オプションは、このOracle Application ExpressインスタンスへのRESTfulアクセスが有効な場合にのみ表示されます(『Oracle Application Express管理ガイド』のRESTfulアクセスの有効化に関する説明を参照してください)。

4. 「変更の適用」をクリックします。

25.3.13.3 Webサービス・クライアントからのRESTful有効レポート・リージョンへのアクセスについて

レポートをRESTfulアクセス用に有効化すると、RESTful Webサービスに渡すエンドポイントURLおよびパラメータを知ることが必要となります。エンドポイントURLは、Oracle Application Expressのこのインスタンスへのアクセスに使用するURLと似ており、リソースのapex_rest.getReportが後に続きます。次に例を示します。

http://apex.oracle.com/apex/apex_rest.getReport

ヒント:
クライアントがPOSTメソッドを使用する場合、HTTPヘッダーContent-Typeをapplication/x-www-form-urlencodedの値に設定する必要があります。

名前

デフォルト

必須

説明

app

N/A

はい

RESTful有効レポートが格納されているアプリケーションの数値IDまたは別名。

page

N/A

はい

RESTful有効レポートが格納されているページの数値IDまたは別名。

reportid

N/A

はい

RESTful有効レポートの静的ID属性。

parmvalues

null

いいえ

レポート・パラメータの値をカンマ区切りリストで送信できます(例: CLERK,10)

lang

en

いいえ

渡された言語に基づき、レポートを実行する前にNLS環境変数を設定します(例: de)

output

xml

はい

XMLまたはJSONのいずれがクライアントに戻されるかを決定します。有効な値のドメインはxml、jsonです。

また、apex_restサービスには、アプリケーションIDまたは別名を指定して、RESTful有効レポートを検出できるようにする操作もあります。レスポンスは、RESTful Webサービスによってアクセス可能なすべてのレポートを記述したXMLドキュメントです。このサービスは、次のようなURLを使用して起動します。

http://apex.oracle.com/apex/apex_rest.getServiceDescription?app=691

このURLで、691はアプリケーションの数値IDです。戻されるドキュメントは次のようになります。

<?xml version="1.0"?>
<urn:getServiceDescriptionResponse xmlns:urn="urn:oasis:names:tc:wsrp:v1:types">
<urn:requiresRegistration>false</urn:requiresRegistration>
<urn:offeredPortlets>
<urn:PortletDescription>
<urn:portletHandle>employees</urn:portletHandle>
<urn:markupTypes>
<urn:mimeType>application/xml</urn:mimeType>
<urn:mimeType>application/json</urn:mimeType>
</urn:markupTypes>
<urn:groupID>1</urn:groupID>
<urn:description/>
<urn:title>EMP</urn:title>
<urn:keywords>
<urn:value>P1_JOB</urn:value>
<urn:value>P1_DEPTNO</urn:value>
</urn:keywords>
</urn:PortletDescription>
</urn:offeredPortlets>
</urn:getServiceDescriptionResponse

portletHandleはレポート・リージョンの静的IDか、RESTリクエストのreportidパラメータにマップされます。groupIDは、RESTリクエストのページIDまたはページ・パラメータにマップされます。さらに、SQLレポートによって使用されるすべてのパラメータはkeywordsノードの子としてリストされます。

25.4 データベース・リンクを使用したデータへのアクセス

この項では、データベース・リンクを作成してデータにアクセスする方法について説明します。

- データベース・リンクについて

- データベース・リンクの作成

- 既存のデータベース・リンクの表示

関連項目:
Oracle Application Express SQLワークショップ・ガイドの「オブジェクト・ブラウザでのデータベース・オブジェクトの管理」、およびOracle Database管理者ガイドの「データベース・リンク」

25.4.1 データベース・リンクについて

ワークスペースのホームページはOracle Database上で実行されるため、ユーザーは、すべての分散Oracle Database機能を使用できます。通常、分散データベース操作は、データベース・リンクを使用して実行します。

データベース・リンクは1つのデータベースのスキーマ・オブジェクトであり、これを使用すると、別のデータベース上のオブジェクトにアクセスできます。データベース・リンクを作成すると、表名またはビュー名に@dblinkを追加することによって、リモート・オブジェクトにアクセスできます。この場合のdblinkは、データベース・オブジェクトの作成ウィザードで指定するデータベース・リンク名です。

注意:
デフォルトでは、CREATE DATABASE LINKシステム権限は、割り当てられたワークスペースまたはデータベース・ユーザーに付与されません。この機能を使用するには、DBAまたは管理者が、この特定の権限をユーザーのワークスペースのデータベース・ユーザーに付与する必要があります。Oracle Database管理者ガイドの「データベース・リンクの作成」を参照してください。

25.4.2 データベース・リンクの作成

データベース・リンクを作成するには、次のステップを実行します。

1. ワークスペースホームページで、「SQLワークショップ」をクリックして、「オブジェクト・ブラウザ」をクリックします。
「オブジェクト・ブラウザ」のホーム・ページが表示されます。

2. 「作成」をクリックします。

3. 「データベース・リンク」を選択して、「次へ」をクリックします。

4. 画面に表示されるステップに従います。
データベース・リンク名は、Oracleのネーミング規則に従う必要があり、空白を含めたり、数字やアンダースコアから開始することはできません。

25.4.3 既存のデータベース・リンクの表示

既存のデータベース・リンクを表示するには、次のステップを実行します。

1. ワークスペースホームページで、「SQLワークショップ」をクリックして、「オブジェクト・ブラウザ」をクリックします。
オブジェクト・ブラウザが表示されます。

2. ページ上部のオブジェクト・タイプ「データベース・リンク」を選択します。

25.5 DMLロックについて

この項では、Oracle Application Expressで自動的なデータ操作言語(DML)を使用して、表の行を更新または削除する方法について説明します。

- DMLロックについて

- APEX_DML_LOCK_WAIT_TIME

- FSP_DML_LOCK_ROW

25.5.1 DMLロックについて

Oracle Application Expressで自動的なデータ操作言語(DML)を使用して表内の行を更新または削除すると、トランザクションが開始され、最初に行をロックして、その行がページに表示されてから変更されたかどうかを確認し、最後に行に対する実際のUPDATE文またはDELETE文を発行します。

行のロックが頻繁に発生する一部の環境では、DML操作を制御してDML操作が次の状態かどうかを判別する場合があります。

- 無期限に待機

- 即時に失敗

- 指定した一定時間待機

25.5.2 APEX_DML_LOCK_WAIT_TIME

アプリケーション置換文字列、アプリケーション・アイテムまたはページ・アイテムの値をAPEX_DML_LOCK_WAIT_TIMEに設定すると、DML操作を制御できます。APEX_DML_LOCK_WAIT_TIMEでは次の値がサポートされます。

- NULLの場合(デフォルト)、Oracle Application Expressの以前のバージョンと同じ動作、つまり、無期限に待機します。

- 0の場合、他のデータベース・セッションによって行がロックされていると、即時に失敗します。

- 0以上で行がロックされている場合、指定した秒数間待機します。

アプリケーションで設定する場合、APEX_DML_LOCK_WAIT_TIMEの値はアプリケーション全体の自動DMLを使用するすべてのUPDATEおよびDELETE DML操作に適用されます。特定の自動DMLプロセスを制御するには、自動DMLプロセスの前にAPEX_DML_LOCK_WAIT_TIMEの値を更新して、自動DMLプロセスの後にリセットします。これは、表形式フォームを使用した更新および削除には影響しないことに注意してください。

25.5.3 FSP_DML_LOCK_ROW

アプリケーション置換文字列、アプリケーション・アイテムまたはページ・アイテムの値をFSP_DML_LOCK_ROWに設定して、DML操作を制御することもできます。FSP_DML_LOCK_ROWでは次の値がサポートされます。

- 値をFALSEに設定すると、SELECT FOR UPDATEは発行されません。

- 値がFALSE以外の場合は、自動DMLを使用してUPDATEまたはDELETE DML操作を発行すると、SELECT FOR UPDATEのデフォルトの動作が実行されます。

A アイテム・タイプについて

アイテムは、HTMLフォームの一部です。アイテムは、テキスト・フィールド、テキスト領域、パスワード、選択リスト、チェック・ボックスなどを示します。ページ・アイテムの機能を制御するには、そのページ・アイテムの属性を編集します。表A-1「使用可能なアイテム・タイプ」の各アイテム・タイプで、アイテムの機能を制御する主要な属性について説明します。すべてのアイテム属性の詳細は、フィールドレベル・ヘルプを参照してください。

関連項目:
「ページ・レベル・アイテムの理解」、「ページ・デザイナでのページ・レベル・アイテムの編集」および「コンポーネント・ビューでのページ・レベル・アイテムの編集」

A.1 使用可能なアイテム・タイプ

表A-1「使用可能なアイテム・タイプ」で、アプリケーション・ビルダーで使用可能なアイテム・タイプについて説明し、アイテムの動作を制御する重要な属性を示します。

表A-1 使用可能なアイテム・タイプ

アイテム・タイプ

説明

チェック・ボックス

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」を参照してください。

ページ・デザイナのアイテム属性:

- 検証、必須の値 - 「はい」を選択し、ページ・アイテムが表示されている場合、Oracle Application Expressでは、ページの送信時にNOT NULL検証が自動的に実行されます。詳細は、ヘルプを参照してください。

- 設定、数値列 - チェック・ボックスの表示に使用されるレイアウト列の数を入力します。たとえば、2という値を指定すると、2列のチェック・ボックスが表示されます。デフォルトでは、1つの列にすべての値を表示します。
参照: 「カスケードLOVの作成」

コンポーネント・ビューのアイテム属性:

- 設定、必須の値 - 「はい」を選択し、ページ・アイテムが表示されている場合、Oracle Application Expressでは、ページの送信時にNOT NULL検証が自動的に実行されます。詳細は、ヘルプを参照してください。

- 設定、列の数 - チェック・ボックスの表示に使用されるレイアウト列の数を入力します。たとえば、2という値を指定すると、2列のチェック・ボックスが表示されます。デフォルトでは、1つの列にすべての値を表示します。
参照: 「カスケードLOVの作成」

カラー・ピッカー

アイコン付きのテキスト・フィールドとしてレンダリングします。アイコンをクリックすると、ポップアップ・ウィンドウが表示されます。ユーザーがパレットから色を選択すると、その色のHTML値(黒の場合は#000000など)が戻されます。

注意: このタイプのアイテムを新規作成する場合は、「ポップアップLOV」を選択してから「カラー・ピッカー」を選択します。

ページ・デザイナのアイテム属性:

- 検証、必須の値 - 「はい」を選択し、ページ・アイテムが表示されている場合、Oracle Application Expressでは、ページの送信時にNOT NULL検証が自動的に実行されます。詳細は、ヘルプを参照してください。

コンポーネント・ビューのアイテム属性:

- 設定、必須の値 - 「はい」を選択し、ページ・アイテムが表示されている場合、Oracle Application Expressでは、ページの送信時にNOT NULL検証が自動的に実行されます。詳細は、ヘルプを参照してください。

日付ピッカー

横にカレンダ・アイコンが付いたテキスト・フィールドを表示します。このアイコンをクリックすると小さいカレンダが表示され、ユーザーは日付および時刻を選択できます(オプション)。

ページ・デザイナのアイテム属性:

- 設定、最小日付 - 入力または選択可能な最小日付を入力します。

- 設定、最大日付 - 入力または選択可能な最大日付を入力します。

- 設定、表示 - 日付ピッカーのポップアップ・カレンダをいつ表示するかを選択します。

- 設定、他の月を表示 - 先頭に前月の日付を表示し、末尾に翌月の日付を表示するかを指定します。先頭および末尾の日付によって、カレンダの最初の行と最後の行が完全に埋まります。

- 設定、次のナビゲーション・リスト - カレンダ・ポップアップ内の月または年に選択リストを表示するかどうかを選択します。

- 設定、ハイライトされた日付 - カレンダ・ポップアップを表示するときにハイライトされるデフォルトの日付値を入力します。詳細は、ヘルプを参照してください。

- 外観、書式マスク - このコンポーネントに適用する日付書式マスクを入力します。

- 検証、必須の値 - 「はい」を選択し、ページ・アイテムが表示されている場合、Oracle Application Expressでは、ページの送信時にNOT NULL検証が自動的に実行されます。

コンポーネント・ビューのアイテム属性:

- 設定、必須の値 - 「はい」を選択し、ページ・アイテムが表示されている場合、Oracle Application Expressでは、ページの送信時にNOT NULL検証が自動的に実行されます。

- 設定、書式マスク - アイテム・タイプで使用される日付書式マスクを指定します。置換構文を使用して、アプリケーションまたはページ・アイテムから動的書式マスクを参照できます。

- 設定、ハイライトされた日付 - カレンダ・ポップアップの起動時にハイライトされるデフォルトの日付値を入力します。指定されない場合、カレンダで現在の日付と時間がハイライトされます。詳細は、ヘルプを参照してください。

- 設定、最小日付 - 入力または選択可能な最小日付を入力します。

- 設定、最大日付 - 入力または選択可能な最大日付を入力します。

- 設定、表示 - 日付ピッカーのポップアップ・カレンダをいつ表示するかを選択します。

- 設定、他の月を表示 - 先頭に前月の日付を表示し、末尾に翌月の日付を表示するかを指定します。先頭および末尾の日付によって、カレンダの最初の行と最後の行が完全に埋まります。

- 設定、ナビゲーション・リスト - カレンダ・ポップアップ内の月または年に選択リストを表示するかどうかを選択します。

日付ピッカー(クラシック)

横にカレンダ・アイコンが付いたテキスト・フィールドを表示します。このアイコンをクリックすると小さいカレンダが表示され、ユーザーは日付および時刻を選択できます(オプション)。

必要な書式が「表示形式」リストに表示されない場合は、「日付ピッカー(アプリケーションの書式マスクを使用)」か「日付ピッカー(アイテムの書式マスクを使用)」を選択します。後者はページ・アイテムの編集ページの「ソース」セクションの「書式マスク」フィールドの値を使用します。

イメージの表示

別のページ・アイテムまたはBLOB列に格納されているイメージURLに格納されているイメージの表示を有効にします。イメージの格納場所を変更するには、アイテムを編集し、「基準」属性を構成します。オプションは次のとおりです。

ページ・デザイナおよびコンポーネント・ビューのアイテム属性:

- 設定、基準 - アイテムの取得元を決定します。属性の詳細は、フィールドレベル・ヘルプを参照してください。

- 設定、代替テキスト列 - このイメージの代替テキストを保持する大文字のページまたはアプリケーション・アイテム名を入力します。このテキストは、エンド・ユーザーがこのアイテムにナビゲートすると、スクリーン・リーダーによって読み上げられます。

- 設定、ファイル名列 - BLOB列に関連付けられているファイル名列値を保持する大文字のページまたはアプリケーション・アイテム名を入力します。

- 設定、BLOB最終更新列 - 指定した場合、この列はブラウザのキャッシュに使用されます。ブラウザからの最後のリクエスト以降にイメージが変更されているかどうかを識別します。入力していない場合、キャッシュは実行されません。注意: この属性では大/小文字が区別されます。また、列のタイプはDATEである必要があります。

表示のみ

アイテムを表示のみテキストとして表示します。

ページ・デザイナおよびコンポーネント・ビューのアイテム属性:

- 設定、セッション・ステートの保存 - ページの送信時にセッション・ステートの現在の値が保存されます。

- 設定、基準 - フィールドに表示される内容を指定します。
オプションは次のとおりです。

ページ・アイテム値: ページ・アイテムの現在の値が表示されます。

LOVの値の表示: ページ・アイテムの現在の値がLOVを使用して別の表示値にマップされます。

PL/SQLコードの出力: 指定したPL/SQLコードにより、ページ・アイテムの必要な出力が生成されます。

- 設定、改行の表示 - 「はい」を選択すると、表示値の改行がHTML改行に変換されて、HTML出力で表示されます。

ファイル参照

「参照」ボタンが付いたテキスト・フィールドを表示します。ユーザーは「参照」ボタンを使用して、ローカル・ファイル・システムのファイルを検索し、アップロードすることができます。

関連項目: 「ファイルのアップロードの保護について」

ページ・デザイナの属性:

- 設定、記憶域タイプ - アップロードしたファイルの格納場所を指定します。

- 設定、MIMEタイプ列 - アップロードしたファイルのMIMEタイプが格納される列の名前を指定します。

- 設定、ファイル名列 - アップロードしたファイルのファイル名が格納される列の名前を指定します。

- 設定、文字セット列 - アップロードしたファイルのキャラクタ・セットが格納される列の名前を指定します。

- 設定、BLOB最終更新列 - ファイルのアップロード時に現在のタイムスタンプを使用して更新する列の名前を指定します。

- 設定、ダウンロード・リンクの表示 - 「はい」を選択すると、「参照」ボタンの横にダウンロード・リンクが表示されます。

- 設定、リンク・テキストのダウンロード - ダウンロード・リンクに使用されるテキストです。

- 設定、コンテンツ配置 - ダウンロードしたコンテンツをブラウザ・ウィンドウ内にインラインで表示するか、オープン・ダイアログを表示するかを決定します。

- 検証、必須の値 - 「はい」を選択し、ページ・アイテムが表示されている場合、Oracle Application Expressでは、ページの送信時にNOT NULL検証が自動的に実行されます。

コンポーネント・ビューの属性:

- 設定、必須の値 - 「はい」を選択し、ページ・アイテムが表示されている場合、Oracle Application Expressでは、ページの送信時にNOT NULL検証が自動的に実行されます。

- 設定、記憶域タイプ - アップロードしたファイルの格納場所を指定します。

- 設定、MIMEタイプ列 - アップロードしたファイルのMIMEタイプが格納される列の名前を指定します。

- 設定、ファイル名列 - アップロードしたファイルのファイル名が格納される列の名前を指定します。

- 設定、文字セット列 - アップロードしたファイルのキャラクタ・セットが格納される列の名前を指定します。

- 設定、BLOB最終更新列 - ファイルのアップロード時に現在のタイムスタンプを使用して更新する列の名前を指定します。

- 設定、ダウンロード・リンクの表示 - 「はい」を選択すると、「参照」ボタンの横にダウンロード・リンクが表示されます。

- 設定、リンク・テキストのダウンロード - ダウンロード・リンクに使用されるテキストです。

- 設定、コンテンツ配置 - ダウンロードしたコンテンツをブラウザ・ウィンドウ内にインラインで表示するか、オープン・ダイアログを表示するかを決定します。

非表示

非表示のページ・アイテムを作成します。

ページ・デザイナおよびコンポーネント・ビューの属性:

- 設定、保護された値 - 「はい」を選択すると、ページがポストされたときに非表示の値が操作できないようになります。

リスト・マネージャ

LOVに基づきます。このアイテムを使用すると、アイテムを選択し、リストに追加してアイテム・リストを管理できます。LOVはポップアップ表示されます。

ページ・デザイナの属性:

- 設定、フェッチ - ポップアップLOVが開かれたときのデータの表示方法を選択します。

- 検証、必須の値 - 「はい」を選択し、ページ・アイテムが表示されている場合、Oracle Application Expressでは、ページの送信時にNOT NULL検証が自動的に実行されます。
参照: 「カスケードLOVの作成」

コンポーネント・ビューの属性:

- 設定、必須の値 - 「はい」を選択し、ページ・アイテムが表示されている場合、Oracle Application Expressでは、ページの送信時にNOT NULL検証が自動的に実行されます。

- 設定、フェッチ - ポップアップLOVが開かれたときのデータの表示方法を選択します。
参照: 「カスケードLOVの作成」

数値フィールド

数値フィールドを表示します。入力する値の数値範囲チェックを設定するには、「最小値」属性および「最大値」属性を設定します。このアイテム・タイプでは、入力された値が数値かどうかが自動的にチェックされます。追加検証は必要ありません。

ページ・デザイナの属性:

- 設定、最小値 - 最小許容値を入力します。値は、静的値または置換構文を使用した動的値です。

- 設定、最大値 - 最大許容値を入力します。値は、静的値または置換構文を使用した動的値です。

- 設定、数字の位置合せ - 表示する数値の位置合せ方法を選択します。アイテムが「読取り専用」としてレンダリングされる場合、または「HTMLフォームの要素属性」が指定されている場合、この設定は適用されません。

- 外観、書式マスク - このコンポーネントに適用する数値書式マスクを入力します。書式マスクを入力するか、事前定義された書式マスクのリストから選択します。置換構文を使用して、アプリケーションまたはページ・アイテムから書式マスクを参照することもできます。

- 検証、必須の値 - 「はい」を選択し、ページ・アイテムが表示されている場合、Oracle Application Expressでは、ページの送信時にNOT NULL検証が自動的に実行されます。

コンポーネント・ビューの属性:

- 設定、必須の値 - 「はい」を選択し、ページ・アイテムが表示されている場合、Oracle Application Expressでは、ページの送信時にNOT NULL検証が自動的に実行されます。

- 設定、書式マスク - アイテム・タイプで使用される数値書式マスクを指定します。置換構文を使用して、アプリケーションまたはページ・アイテムから動的書式マスクを参照できます。

- 設定、最小値 - 最小許容値を入力します。値は、静的値または置換構文を使用した動的値です。

- 設定、最大値 - 最大許容値を入力します。値は、静的値または置換構文を使用した動的値です。

- 設定、数字の位置合せ - 表示する数値の位置合せ方法を選択します。アイテムが「読取り専用」としてレンダリングされる場合、または「HTMLフォームの要素属性」が指定されている場合、この設定は適用されません。

パスワード

HTMLのパスワードのフォーム要素としてレンダリングします。

ページ・デザイナの属性:

- 設定、[Enter]を押すと送信 - このフィールドで[Enter]キーを押すと、ページが自動的に送信されるかどうかを指定します。

- 設定、状態を保存しない - パスワードがセッション・ステートに保存されるかどうかを指定します。
セキュリティ上の理由から、パスワードをセッション・ステートに書き込まないよう強くお薦めします。ブラウザ・キャッシュおよびApplication Expressセッション表から値が読み取られる可能性があります。この属性を「いいえ」に設定する場合、「セッション・ステートに暗号化された値を保存」を「はい」に設定することを検討してください。

- 検証、必須の値 - 「はい」を選択し、ページ・アイテムが表示されている場合、Oracle Application Expressでは、ページの送信時にNOT NULL検証が自動的に実行されます。詳細は、ヘルプを参照してください。

コンポーネント・ビューの属性:

- 設定、必須の値 - 「はい」を選択し、ページ・アイテムが表示されている場合、Oracle Application Expressでは、ページの送信時にNOT NULL検証が自動的に実行されます。詳細は、ヘルプを参照してください。

- 設定、[Enter]を押すと送信 - このフィールドで[Enter]キーを押すと、ページが自動的に送信されるかどうかを指定します。

- 設定、状態を保存しない - パスワードがセッション・ステートに保存されるかどうかを指定します。
セキュリティ上の理由から、パスワードをセッション・ステートに書き込まないよう強くお薦めします。ブラウザ・キャッシュおよびApplication Expressセッション表から値が読み取られる可能性があります。この属性を「いいえ」に設定する場合、「セッション・ステートに暗号化された値を保存」を「はい」に設定することを検討してください。

関連項目: 「セッション・ステートおよびセキュリティについて」。

ポップアップLOV

アイコン付きのテキスト・フィールドとしてレンダリングします。アイコンをクリックすると、LOVを含むポップアップ・ウィンドウが表示されます。このLOVは、一連のリンクとして表示されます。このリストから値を選択すると、選択した値がテキスト・フィールドに配置されます。

テンプレートでポップアップLOVを制御します。アプリケーションごとに1つのみポップアップLOVを指定できます。ポップアップLOVは、単一のページに戻すには大きすぎるLOVに対して有効です。

ポップアップLOVは、異なる列別名を持つ2つの列を選択する問合せに基づく必要があります。次に例を示します。

SELECT ename name, empno id
FROM emp

いずれかの列が式の場合は、別名を使用します。次に例を示します。

SELECT ename||' '||job display_value, empno FROM emp

注意: このタイプのアイテムを新規作成する場合は、「ポップアップLOV」を選択してから「ポップアップ計算機付きテキスト・フィールド」を選択します。

ページ・デザイナのアイテム属性:

- 設定、入力フィールド - アイテムが入力可能かどうかを選択します。

- 設定、フェッチ - LOV用のデータの初期フェッチ方法を選択します。

- 設定、複数選択を許可 - カンマ区切りの複数の値を選択することを許可します。

- 検証、必須の値 - 「はい」を選択し、ページ・アイテムが表示されている場合、Oracle Application Expressでは、ページの送信時にNOT NULL検証が自動的に実行されます。詳細は、ヘルプを参照してください。

コンポーネント・ビューのアイテム属性:

- 設定、必須の値 - 「はい」を選択し、ページ・アイテムが表示されている場合、Oracle Application Expressでは、ページの送信時にNOT NULL検証が自動的に実行されます。詳細は、ヘルプを参照してください。

- 設定、入力フィールド - アイテムが入力可能かどうかを選択します。

- 設定、フェッチ - LOV用のデータの初期フェッチ方法を選択します。

- 設定、複数選択を許可 - カンマ区切りの複数の値を選択することを許可します。

関連項目: 「カスケードLOVの作成」および「カスケードLOVの作成」

ラジオ・グループ

LOVに基づき、HTMLラジオ・グループ・フォーム要素としてレンダリングします。

次の例では、従業員名(ename)が表示されますが、従業員番号(empno)が戻されます。

SELECT ename, empno FROM emp

ページ・デザイナのアイテム属性:

- 設定、列の数 - 表示するラジオ・グループ列の数を入力します。たとえば、2という値では2列が表示されます。値が5個ある場合、3行に表示されます。

- 設定、選択時のページ・アクション - ラジオ・グループ値が選択されたときに実行されるアクションを選択します。詳細は、ヘルプを参照してください。

- 設定、検証の実行 - 「値の変更時のページ・アクション」が「ページの送信」に設定されているかどうかを表示します。ページの送信時の検証の実行を制御します。この属性を「いいえ」に設定すると、検証が実行されず、関連エラー・メッセージが表示されません。この属性を「はい」に設定すると、ページの送信時にすべてのページ検証、ビルトイン検証が実行され、関連エラー・メッセージが表示されます。この属性は、検証属性「常に実行」と組み合せて使用します。詳細は、「検証の実行タイミングの決定について」を参照してください。
関連項目: 「カスケードLOVの作成」および「カスケードLOVの作成」

- 検証、必須の値 - 「はい」を選択し、ページ・アイテムが表示されている場合、Oracle Application Expressでは、ページの送信時にNOT NULL検証が自動的に実行されます。詳細は、ヘルプを参照してください。

コンポーネント・ビューのアイテム属性:

- 設定、必須の値 - 「はい」を選択し、ページ・アイテムが表示されている場合、Oracle Application Expressでは、ページの送信時にNOT NULL検証が自動的に実行されます。詳細は、ヘルプを参照してください。

- 設定、列の数 - 表示するラジオ・グループ列の数を入力します。たとえば、2という値では2列が表示されます。値が5個ある場合、3行に表示されます。

- 設定、選択時のページ・アクション - ラジオ・グループ値が選択されたときに実行されるアクションを選択します。オプションは、「なし(デフォルト)」、「ページの送信」または「値のリダイレクトと設定」です。
「ページの送信」を選択すると、ラジオ・ボタンの選択時にページが送信されます。

- 設定、検証の実行 - 「値の変更時のページ・アクション」が「ページの送信」に設定されているかどうかを表示します。ページの送信時の検証の実行を制御します。この属性を「いいえ」に設定すると、検証が実行されず、関連エラー・メッセージが表示されません。この属性を「はい」に設定すると、ページの送信時にすべてのページ検証、ビルトイン検証が実行され、関連エラー・メッセージが表示されます。この属性は、検証属性「常に実行」と組み合せて使用します。詳細は、「検証の実行タイミングの決定について」を参照してください。
関連項目: 「カスケードLOVの作成」および「カスケードLOVの作成」

リッチ・テキスト・エディタ

HTMLのテキスト領域としてレンダリングします。テキスト領域として表示されるアイテムの最大長はありません。「高さ」および「幅」アイテム属性を編集して、高さと幅を制御します。

ページ・デザイナのアイテム属性:

- 設定、エディタ - 使用可能なテキスト書式設定オプションの表示に使用されるエディタを選択します。

- 設定、ツールバー - エディタ内で使用できるテキスト書式設定オプションの数を選択します。

- 設定、ツールバーの拡張 - リッチ・テキスト・エディタをロードするときにツールバーを展開して起動する必要があるかどうかを決定します。

- 設定、スキン - エディタのスタイル設定に使用されるエディタ・スキンを選択します。

- 設定、ツールバーの位置 - エディタを表示するテキスト領域内の場所を指定します。

- 検証、必須の値 - 「はい」を選択し、ページ・アイテムが表示されている場合、Oracle Application Expressでは、ページの送信時にNOT NULL検証が自動的に実行されます。詳細は、ヘルプを参照してください。

コンポーネント・ビューのアイテム属性:

- 設定、必須の値 - 「はい」を選択し、ページ・アイテムが表示されている場合、Oracle Application Expressでは、ページの送信時にNOT NULL検証が自動的に実行されます。詳細は、ヘルプを参照してください。

- 設定、エディタ - 使用可能なテキスト書式設定オプションの表示に使用されるエディタを選択します。

- 設定、ツールバー - エディタ内で使用できるテキスト書式設定オプションの数を選択します。

- 設定、ツールバーの拡張 - リッチ・テキスト・エディタをロードするときにツールバーを展開して起動する必要があるかどうかを決定します。

- 設定、スキン - エディタのスタイル設定に使用されるエディタ・スキンを選択します。

- 設定、ツールバーの位置 - エディタを表示するテキスト領域内の場所を指定します。

選択リスト

LOVを使用して表示します。選択リストとしてアイテムを表示するには、LOVが必要です。選択リストは、HTMLフォーム要素<selectを使用してレンダリングされます。選択リストの値は、名前付きLOVまたはアイテム・レベルで定義されたLOVで決まります。表示値および戻り値にはNULLを指定できます。

次の例では、従業員名(ename)および従業員番号(empno)がemp表から戻されます。列の別名は必須ではありませんが、この例では、意味を明確にするために含まれています。

SELECT ename display_text, empno return_value FROM emp

ページ・デザイナのアイテム属性:

- 選択時のページ・アクション - リスト値が選択されたときに実行されるアクションを選択します。オプションには、「なし」、「ページの送信」、「値のリダイレクトと設定」、「ページにリダイレクト(選択値に基づく)」または「URLにリダイレクト(選択値に基づく)」があります。

- 検証の実行 - 「選択時のページ・アクション」が「ページの送信」に設定されているかどうかを表示します。ページの送信時の検証の実行を制御します。この属性を「いいえ」に設定すると、検証が実行されず、関連エラー・メッセージが表示されません。この属性を「はい」に設定すると、ページの送信時にすべてのページ検証、ビルトイン検証が実行され、関連エラー・メッセージが表示されます。この属性は、検証属性「常に実行」と組み合せて使用します。詳細は、「検証の実行タイミングの決定について」を参照してください。

- 検証、必須の値 - 「はい」を選択し、ページ・アイテムが表示されている場合、Oracle Application Expressでは、ページの送信時にNOT NULL検証が自動的に実行されます。詳細は、ヘルプを参照してください。

コンポーネント・ビューのアイテム属性:

- 設定、必須の値 - 「はい」を選択し、ページ・アイテムが表示されている場合、Oracle Application Expressでは、ページの送信時にNOT NULL検証が自動的に実行されます。詳細は、ヘルプを参照してください。

- 選択時のページ・アクション - リスト値が選択されたときに実行されるアクションを選択します。オプションには、「なし」、「ページの送信」、「値のリダイレクトと設定」、「ページにリダイレクト(選択値に基づく)」または「URLにリダイレクト(選択値に基づく)」があります。

- 複数選択を許可: 選択リストで複数の値を選択できるようにします。「高さ」属性を使用して、選択リストに一度に表示されるエントリの数を定義します。

- 検証の実行 - 「選択時のページ・アクション」が「ページの送信」に設定されているかどうかを表示します。ページの送信時の検証の実行を制御します。この属性を「いいえ」に設定すると、検証が実行されず、関連エラー・メッセージが表示されません。この属性を「はい」に設定すると、ページの送信時にすべてのページ検証、ビルトイン検証が実行され、関連エラー・メッセージが表示されます。この属性は、検証属性「常に実行」と組み合せて使用します。詳細は、「検証の実行タイミングの決定について」を参照してください。

シャトル

複数のリストを含むボックスが2つある複数の選択リストとしてレンダリングします。左側にあるリストにはソースのLOVが表示されます。ユーザーはシャトル・コントロール・アイコンとボタンを使用してリスト・アイテムを選択し、左側にある「ソース」リストから右側にある「宛先」リストに移動します。各シャトルには、次の5つの制御があります。

- すべて移動: 「ソース」リストのすべてのアイテムを「宛先」リストに移動します。

- 選択項目を移動: 選択したアイテム([Ctrl]+[Shift]でアイテムを選択)のみを「宛先」リストに移動します。

- 選択対象の削除: 選択したアイテム([Ctrl]+[Shift]でアイテムを選択)のみを「ソース」リストに移動します。

- すべて削除: 「宛先」リストのすべてのアイテムを「ソース」リストに戻します。

- リフレッシュ: 「ソース」リストおよび「宛先」リストをリセットします。

右側にある「宛先」リストにはソート制御の「最上位に移動」ボタン、「上に移動」ボタン、「下に移動」ボタンおよび「最下位に移動」ボタンが含まれています。

ページ・デザイナのアイテム属性:

- 設定、コントロールの表示 - シャトルの中央に表示するデータ移動コントロールを選択します。オプションは、「なし」、「移動のみ」、「並替えのみ」または「すべて」です。

- 検証、必須の値 - 「はい」を選択し、ページ・アイテムが表示されている場合、Oracle Application Expressでは、ページの送信時にNOT NULL検証が自動的に実行されます。詳細は、ヘルプを参照してください。
注意: このアイテム・タイプを作成するにはLOVを定義する必要があります。「アプリケーション・レベルでのLOVの作成」、「複数選択リスト・アイテムでの操作」および「カスケードLOVの作成」を参照してください。

コンポーネント・ビューのアイテム属性:

- 設定、必須の値 - 「はい」を選択し、ページ・アイテムが表示されている場合、Oracle Application Expressでは、ページの送信時にNOT NULL検証が自動的に実行されます。詳細は、ヘルプを参照してください。

- 設定、コントロールの表示 - シャトルの中央に表示するデータ移動コントロールを選択します。オプションは、「なし」、「移動のみ」、「並替えのみ」または「すべて」です。
注意: このアイテム・タイプを作成するにはLOVを定義する必要があります。「アプリケーション・レベルでのLOVの作成」、「複数選択リスト・アイテムでの操作」および「カスケードLOVの作成」を参照してください。

スライダ

jQuery Mobileアプリケーションのスライダのアイテム・タイプをレンダリングします。このアイテム・タイプによって、ユーザーはスライド・ハンドラを使用して、値を設定できるようになります。

ページ・デザイナのアイテム属性:

- 設定、最小値 - 最小許容値を入力します。値は、静的値または置換構文を使用した動的値です。

- 設定、最大値 - 最大許容値を入力します。値は、静的値または置換構文を使用した動的値です。

- 設定、ステップ増分 - スライダを強制的に特定の増分にあわせる値を入力します。値は、静的値または置換構文を使用した動的値です。

- 設定、選択済をハイライト - スライダで、現在のスライダ・ハンドルの位置まで軌跡をハイライトするかどうかを指定します。

- 検証、必須の値 - 「はい」を選択し、ページ・アイテムが表示されている場合、Oracle Application Expressでは、ページの送信時にNOT NULL検証が自動的に実行されます。詳細は、ヘルプを参照してください。

コンポーネント・ビューのアイテム属性:

- 設定、必須の値 - 「はい」を選択し、ページ・アイテムが表示されている場合、Oracle Application Expressでは、ページの送信時にNOT NULL検証が自動的に実行されます。詳細は、ヘルプを参照してください。

- 設定、最小値 - 最小許容値を入力します。値は、静的値または置換構文を使用した動的値です。

- 設定、最大値 - 最大許容値を入力します。値は、静的値または置換構文を使用した動的値です。

- 設定、ステップ増分 - スライダを強制的に特定の増分にあわせる値を入力します。値は、静的値または置換構文を使用した動的値です。

- 設定、選択済をハイライト - スライダで、現在のスライダ・ハンドルの位置まで軌跡をハイライトするかどうかを指定します。

テキスト・フィールド

テキスト・フィールドとしてアイテムを表示します。

ページ・デザイナのアイテム属性:

- 設定、サブタイプ - HTML5テキスト・サブタイプを選択します。これによって、オンスクリーン・キーボードの付いたデバイスで、サブタイプごとに最適化されたキーボード・レイアウトを表示できるため、データ入力が簡単になります。サブタイプの選択は、ページ・アイテムの値を使用して適切なリンクをレンダリングする際にも使用されます(読取り専用でレンダリングされる場合)。物理キーボードを使用する場合、この属性でテキスト・アイテムやデータ・エントリは変更されません。

- 設定、空白の切捨て - ページの送信後のアイテム値の切捨て方法を選択します。この設定によって、入力されたテキストから、空白、タブおよび改行が切り捨てられます。

- 設定、[Enter]を押すと送信 - このフィールドで[Enter]キーを押すと、ページが自動的に送信されるかどうかを指定します。

- 設定、無効 - このアイテムを無効にし、エンド・ユーザーが値を変更できないようにするかどうかを指定します。HTML書式が削除される「表示のみ」のアイテム・タイプとは異なり、無効なテキスト・アイテムは同じHTML書式で表示されます。無効なテキスト・アイテムはページ・ソースの一部で、そのセッション・ステートを評価できます。反対に、表示のみのアイテムはセッション・ステートに格納されません。

- 検証、必須の値 - 「はい」を選択し、ページ・アイテムが表示されている場合、Oracle Application Expressでは、ページの送信時にNOT NULL検証が自動的に実行されます。詳細は、ヘルプを参照してください。

コンポーネント・ビューのアイテム属性:

- 設定、必須の値 - 「はい」を選択し、ページ・アイテムが表示されている場合、Oracle Application Expressでは、ページの送信時にNOT NULL検証が自動的に実行されます。詳細は、ヘルプを参照してください。

- 設定、サブタイプ - HTML5テキスト・サブタイプを選択します。これによって、オンスクリーン・キーボードの付いたデバイスで、サブタイプごとに最適化されたキーボード・レイアウトを表示できるため、データ入力が簡単になります。サブタイプの選択は、ページ・アイテムの値を使用して適切なリンクをレンダリングする際にも使用されます(読取り専用でレンダリングされる場合)。物理キーボードを使用する場合、この属性でテキスト・アイテムやデータ・エントリは変更されません。

- 設定、空白の切捨て - ページの送信後のアイテム値の切捨て方法を選択します。この設定によって、入力されたテキストから、空白、タブおよび改行が切り捨てられます。

- 設定、[Enter]を押すと送信 - このフィールドで[Enter]キーを押すと、ページが自動的に送信されるかどうかを指定します。

- 設定、無効 - このアイテムを無効にし、エンド・ユーザーが値を変更できないようにするかどうかを指定します。HTML書式が削除される「表示のみ」のアイテム・タイプとは異なり、無効なテキスト・アイテムは同じHTML書式で表示されます。無効なテキスト・アイテムはページ・ソースの一部で、そのセッション・ステートを評価できます。反対に、表示のみのアイテムはセッション・ステートに格納されません。

オートコンプリートが有効なテキスト・フィールド

ユーザーがフィールドへの入力を開始すると、指定可能な値のリストが表示されます。値は、定義済のLOV SQL文に基づきます。次の例では、従業員の名前(ename)を表示して、フィールドに格納しています。

SELECT ename FROM emp
ORDER BY 1

ページ・デザイナのアイテム属性:

- 設定、検索 - 入力値に対する検索の実行方法を選択します。「遅延ロード」を使用する場合、この設定が問合せのパフォーマンスに影響することがあります。「「次を含む」および「大/小文字を区別」」または「「次を含む」および「大/小文字区別なし」」を選択すると、列索引が使用されません。

- 設定、遅延ロード - 「遅延ロード」手法を使用して、一致する値をデータベースから取得するかどうかを指定します。遅延ロードでは、ユーザーが文字を入力するたびに、一致するレコードがデータベースから取得されます。それ以外の場合、ページをロードするときに、すべてのリスト値がロードされます。多数のレコードのロードによってページの初期ロード時間が影響を受けることがあるため、選択リストが大きい場合、「遅延ロード」を使用することをお薦めします。

- 設定、リスト内の最大値 - テキスト・フィールドに最初のオートコンプリート値が自動的に入力されるかどうかを指定します。

- 設定、自動入力 - テキスト・フィールドに最初のオートコンプリート値が自動的に入力されるかどうかを指定します。詳細は、ヘルプを参照してください。

- 設定、最初の選択 - キーボードやマウス・アクションにより手動で選択していない場合でも、エンド・ユーザーが[Tab]/[Return]を押すと、最初のオートコンプリート値が自動的に選択されるかどうかを指定します。手動で選択(ハイライト)された結果がある場合、その結果が優先されます。

- 設定、検索をハイライト - 一致するエントリの選択ボックスで一致するテキストをハイライトするかどうかを指定します。

- 検証、必須の値 - 「はい」を選択し、ページ・アイテムが表示されている場合、Oracle Application Expressでは、ページの送信時にNOT NULL検証が自動的に実行されます。詳細は、ヘルプを参照してください。

コンポーネント・ビューのアイテム属性:

- 設定、必須の値 - 「はい」を選択し、ページ・アイテムが表示されている場合、Oracle Application Expressでは、ページの送信時にNOT NULL検証が自動的に実行されます。詳細は、ヘルプを参照してください。

- 設定、検索 - 入力値に対する検索の実行方法を選択します。「遅延ロード」を使用する場合、この設定が問合せのパフォーマンスに影響することがあります。「「次を含む」および「大/小文字を区別」」または「「次を含む」および「大/小文字区別なし」」を選択すると、列索引が使用されません。

- 設定、遅延ロード - 「遅延ロード」手法を使用して、一致する値をデータベースから取得するかどうかを指定します。遅延ロードでは、ユーザーが文字を入力するたびに、一致するレコードがデータベースから取得されます。それ以外の場合、ページをロードするときに、すべてのリスト値がロードされます。多数のレコードのロードによってページの初期ロード時間が影響を受けることがあるため、選択リストが大きい場合、「遅延ロード」を使用することをお薦めします。

- 設定、リスト内の最大値 - テキスト・フィールドに最初のオートコンプリート値が自動的に入力されるかどうかを指定します。

- 設定、自動入力 - テキスト・フィールドに最初のオートコンプリート値が自動的に入力されるかどうかを指定します。詳細は、ヘルプを参照してください。

- 設定、最初の選択 - キーボードやマウス・アクションにより手動で選択していない場合でも、エンド・ユーザーが[Tab]/[Return]を押すと、最初のオートコンプリート値が自動的に選択されるかどうかを指定します。手動で選択(ハイライト)された結果がある場合、その結果が優先されます。

- 設定、検索をハイライト - 一致するエントリの選択ボックスで一致するテキストをハイライトするかどうかを指定します。

ポップアップ計算機付きテキスト・フィールド

アイコン付きのテキスト・フィールドとしてレンダリングします。このアイコンをクリックすると、計算機付きの小さいウィンドウが表示されます。計算結果は、テキスト・フィールドに表示されます。

注意: このタイプのアイテムを新規作成する場合は、「ポップアップLOV」を選択してから「ポップアップ計算機付きテキスト・フィールド」を選択します。

コンポーネント・ビューのアイテム属性:

- 設定、必須の値 - 「はい」を選択し、ページ・アイテムが表示されている場合、Oracle Application Expressでは、ページの送信時にNOT NULL検証が自動的に実行されます。詳細は、ヘルプを参照してください。

- 設定、複数選択を許可 - カンマ区切りの複数の値を選択することを許可します。

テキスト領域

HTMLのテキスト領域としてレンダリングします。テキスト領域として表示されるアイテムの最大長はありません。「高さ」、「幅」および「最大幅」属性を編集して、高さと幅を制御します。

ページ・デザイナのアイテム属性:

- 設定、サイズ変更可能 - マウスを使用したテキスト領域のサイズ変更が有効かどうかを指定します。

- 設定、高さ自動調整機能 - 表示されるテキストの量に基づいてテキスト領域の高さを変えるかどうかを指定します。テキスト領域をデータ量に応じて決める場合は、このオプションを使用します。

- 設定、文字カウント機能 - 「はい」を選択すると、フィールドに表示された文字数を表示するカウンタが含まれます。

- 設定、空白の切捨て - ページの送信後のアイテム値の切捨て方法を選択します。この設定によって、入力されたテキストから、空白、タブおよび改行が切り捨てられます。

- 検証、必須の値 - 「はい」を選択し、ページ・アイテムが表示されている場合、Oracle Application Expressでは、ページの送信時にNOT NULL検証が自動的に実行されます。

コンポーネント・ビューのアイテム属性:

- 設定、必須の値 - 「はい」を選択し、ページ・アイテムが表示されている場合、Oracle Application Expressでは、ページの送信時にNOT NULL検証が自動的に実行されます。

- 設定、サイズ変更可能 - マウスを使用したテキスト領域のサイズ変更が有効かどうかを指定します。

- 設定、高さ自動調整機能 - 表示されるテキストの量に基づいてテキスト領域の高さを変えるかどうかを指定します。テキスト領域をデータ量に応じて決める場合は、このオプションを使用します。

- 設定、文字カウント機能 - 「はい」を選択すると、フィールドに表示された文字数を表示するカウンタが含まれます。

- 設定、空白の切捨て - ページの送信後のアイテム値の切捨て方法を選択します。この設定によって、入力されたテキストから、空白、タブおよび改行が切り捨てられます。

はい/いいえ

jQuery Mobileユーザー・インタフェースのフリップ切替えスイッチおよび非モバイル環境の選択リストとして表示します。

コンポーネント・ビューのアイテム属性:

- 設定、必須の値 - 「はい」を選択し、ページ・アイテムが表示されている場合、Oracle Application Expressでは、ページの送信時にNOT NULL検証が自動的に実行されます。詳細は、ヘルプを参照してください。

- 設定、設定 - アプリケーション・レベルのコンポーネント設定が使用されるか、またはこのアイテムのカスタム設定が使用されるかを選択します。オプションには、「コンポーネント設定の使用」または「カスタム」があります。
「設定」が「カスタム」に設定されている場合、「Yes値」、「Yesラベル」、「No値」、「Noラベル」の属性が表示されます。詳細は、ヘルプを参照してください。

ページ・デザイナのアイテム属性:

- 設定、設定 - アプリケーション・レベルのコンポーネント設定が使用されるか、またはこのアイテムのカスタム設定が使用されるかを選択します。オプションには、「コンポーネント設定の使用」または「カスタム」があります。
「設定」が「カスタム」に設定されている場合、「Yes値」、「Yesラベル」、「No値」、「Noラベル」の属性が表示されます。詳細は、ヘルプを参照してください。

- 検証、必須の値 - 「はい」を選択し、ページ・アイテムが表示されている場合、Oracle Application Expressでは、ページの送信時にNOT NULL検証が自動的に実行されます。詳細は、ヘルプを参照してください。

B Oracle Application Expressの制限事項

Oracle Application Express開発環境には、ワークスペース数や特定のワークスペース内に存在できるユーザー数に関する制限はありません。表B-1「コンポーネントの制限事項」では、Oracle Application Expressコンポーネントに関連した制限事項について説明します。

B.1 コンポーネントの制限事項

表B-1「コンポーネントの制限事項」に、対話モード・レポート、クラシック・レポート、フォーム、表形式フォームなど、Oracle Application Expressコンポーネントに関連した制限事項を示します。

表B-1 コンポーネントの制限事項

コンポーネント

制限事項

対話モード・レポート

コンポーネント・ビューを使用すると、100列編集できます。ページ・デザイナを使用すると、追加の列を編集できます。

列ヘッダー・フィルタごとに999行(列属性にカスタムLOVが指定されていない場合)。

追加の列を編集するには、「レポート列属性」によってページ区切りします。

注意: 列の別名の長さに応じて、約26列(またはそれ未満)がサポートされます。

関連項目: 「レポートの開発」

クラシック・レポート

レポート列を使用すると、100列表示できます。ページ・デザイナを使用すると、追加の列を編集できます。

関連項目: 「レポートの開発」

フォーム

ページごとに200の入力可能アイテム。

32767バイトのテキスト領域またはリッチ・テキスト・エディタ・アイテム。

主キー用に2列(組込みDMLプロセスを使用する場合)。主キー列が3つ以上定義されているユーザーの場合、ROWIDも指定できます。

関連項目: 「フォームの開発」

表形式フォーム

ページごとに1つのウィザード生成表形式フォーム(組込みDMLを使用)

50の編集可能な表形式フォーム列(apex_application.g_f01-apex_application.g_f50)。apex_itemまたは組込み表形式フォーム表示タイプによって生成されます。

関連項目: 「表形式フォームの管理」

アイテム名

アイテム名は30文字以下にする必要があります。30文字を超えるアイテムは、バインド変数構文を使用して参照できません。

関連項目: 「バインド変数構文を使用したセッション・ステートの参照」および「アイテムのネーミング規則について」

検証

検証に対して入力するテキストは、3,950文字以下にする必要があります。

関連項目: 「検証の理解」

データのロード

データ・ロード時の列の最大数は45です。

関連項目: 「データ・ロード機能によるアプリケーションの作成」

C 使用可能な条件

この項では、アプリケーション・ビルダーで使用可能な条件について説明します。

- 条件について

- アプリケーション・ビルダーで使用可能な条件

C.1 条件について

条件とは、リージョン、アイテム、ボタンおよびタブの表示と、プロセス、計算および検証の実行を制御するために役立つ論理単位です。条件をコントロールまたはコンポーネントに適用すると、条件が評価されます。条件が真であるかどうかによって、コントロールまたはコンポーネントが表示されるかどうか、または処理が実行されるかどうかが決まります。

コントロール(リージョン、ボタンまたはアイテム)またはコンポーネント(タブ、リストまたはナビゲーション・バー)の作成時に条件タイプを選択するか、または条件属性で選択することによって、条件を指定できます。

関連項目:
「条件付きのレンダリングおよびプロセスの理解」および「アプリケーション・ビルダーで使用可能な条件」

C.2 アプリケーション・ビルダーで使用可能な条件

表C-1「使用可能な条件」に、アプリケーション・ビルダーで使用可能な条件を示します。任意のコントロールまたはコンポーネントに対して使用可能なすべての条件のリストを表示するには、「条件タイプ」リストの右にある「ビュー」アイコンをクリックします。「タイプ」リストのすぐ下に、一般的な選択項目へのショートカットが表示されます。条件に式が必要な場合は、該当するフィールドにその式を入力します。

表C-1 使用可能な条件

条件

説明

常時

常にtrueを戻します。主にページ・アイテムの読取り専用条件に使用されます。

クライアントのブラウザ: Microsoft Internet Explorer 5.5/6.0以上

クライアントのブラウザがMicrosoft Internet Explorer 5.5/6.0以上である場合は、trueと評価されます。

この条件をアイテムに設定すると、Microsoft Internet Explorer 5.5/6.0以上のブラウザを除くすべてのクライアントのブラウザでアイテムを非表示にします。

クライアントのブラウザ: Mozilla、Netscape 6.x/7x以上

クライアントのブラウザがMozilla、Netscape 6.x/7x以上のいずれかである場合は、trueと評価されます。

この条件をコンポーネントに設定すると、Mozilla、Netscape 6.x/7x以上のブラウザを除くすべてのクライアントのブラウザでコンポーネントを非表示にします。

クライアントのブラウザ: その他のブラウザ(または以前のバージョン)

クライアントのブラウザが、その他のブラウザ(または以前のバージョン)のいずれかである場合は、trueと評価されます。

クライアントのブラウザ: XHTML/CSS対応ブラウザ(NS 6.x/7x、Mozilla、IE 5.5/6.0以上)

クライアントのブラウザがNetscape 6.x/7x、MozillaまたはMicrosoft Internet Explorer 5.5/6.0以上のいずれかである場合は、trueと評価されます。

この条件をアイテムに設定すると、Netscape 6.x/7x、MozillaまたはMicrosoft Internet Explorer 5.5/6.0以上のブラウザを除くすべてのクライアントのブラウザでアイテムを非表示にします。

現在の言語!=式1

クライアント・ブラウザが現在実行されていない言語の設定を確認します。現在の言語が「式1」に入力した言語ではないことを確認します。

現在の言語=式1

クライアント・ブラウザが現在実行されている言語の設定を確認します。現在の言語が「式1」に入力した言語ではないことを確認します。

現在の言語が式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と評価されます。

関連項目: バインド変数の詳細は、「バインド変数構文を使用したセッション・ステートの参照」を参照してください

インライン検証エラーあり

この条件タイプは、インライン検証エラーがページに表示されたときにページ・コントロールまたはページ・コンポーネントを非表示にします。

Never

この条件タイプは、常に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.構文については、「置換文字列の理解」を参照してください。

式1のテキストが式2のアイテムの値に含まれる

この条件は、式1に含まれている文字列と、式2で参照されるアイテムの値を比較します。式1には、&ITEM.構文を使用して、セッション・ステートへの参照を含めることができます。

アイテムF100_P2_DAY_DATEがテキストWedを含むかどうかを確認するには、この条件を選択して、「式1」および「式2」に次のように入力します。

- 式1: Wed

- 式2: F100_P2_DAY_DATE

関連項目: &MY_ITEM.構文については、「置換文字列の理解」を参照してください。

式1のテキストが式2のテキストに含まれる

この条件は、文字列を含む2つの式を比較できます。いずれかの式には、&ITEM.構文を使用して、セッション・ステートへの参照を含めることができます。

関連項目: &MY_ITEM.構文については、「置換文字列の理解」を参照してください。

式1のテキストが式2のテキストに含まれない

この条件は、「式1のテキストが式2のテキストに含まれる」の反対の条件です。&ITEM.構文を使用して、片方の式にセッション・ステートの参照を含めることができます。

関連項目: &MY_ITEM.構文については、「置換文字列の理解」を参照してください。

認証済ユーザー(非パブリック・ユーザー)

カレント・ユーザーが組込み認証スキーマまたはカスタム認証スキームのいずれかを使用して認証されたかどうかを確認します。

関連項目: 認証の詳細は、「認証によるユーザー・アイデンティティの証明」を参照してください。

パブリック・ユーザー(認証されていないユーザー)

パブリック・ユーザーは、アプリケーション属性として定義されます。特定のアプリケーションに対してパブリック・ユーザーを設定するには、アプリケーション・ビルダーのホームページに移動し、そのアプリケーションに対応する編集リンクをクリックします。

パブリック・ユーザーは、複数のユーザーで使用されるユーザーです。アプリケーションには、認証およびログインが必要なパブリック・ページが含まれる場合があります。ユーザーがパブリック・ユーザーである(ユーザーがユーザー自身として認証されたか、またはアプリケーション属性Public Userで識別されたパブリック・ユーザー以外のユーザーとして認証された)場合、この条件はtrueを戻します。

関連項目: パブリック・ユーザーについては、「認証」を参照してください。

式1のアイテムの値!=式2

この条件は、「式1のアイテムの値=式2」の反対の条件です。これはアイテムの値を特定の文字列と比較します。この条件を使用した比較では、大/小文字が区別されます。

たとえば、アイテムF100_IDが値10と等しくないかどうかを確認するには、「式1」および「式2」フィールドに次のとおり入力します。

- 式1: F100_ID

- 式2: 10

式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のアイテムの値がNOT NULLかつ0(ゼロ)以外

この条件は、「式1」がNULLでなく、ゼロでないかどうかを確認するために使用します。

たとえば、アイテムF100_IDの値がNULLでなく、ゼロでないかどうかを確認するには、「式1」に次のとおり入力します。

- 式1: F100_ID

式1のアイテムの値が数値ではない

この条件は、「式1」の値が数値でないことを確認するために使用します。

たとえば、アイテムF100_USER_NAMEが数値でないかどうかを確認するには、「式1」に次のとおり入力します。

- 式1: F100_USER_NAME

式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でない任意のセッション・ステート・アイテムの値を変更すると、この条件が満たされます。

カレント・ページのアイテムを変更した場合

カレント・ページの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と評価されます。

D 付与された権限について

このセクションでは、付与された権限について説明します。

- データベース・ユーザーへの権限の付与について

- PUBLICに付与される権限の理解

D.1 データベース・ユーザーへの権限の付与について

Oracle Application Expressリリース4.2では、既存のスキーマでワークスペースを作成するときにデータベース・ユーザーに権限が付与されません。直接付与がない場合、Oracle Application Expressのデータベース・ユーザーは表などのデータベース・オブジェクトを作成できません。標準データベース・オブジェクトの作成を許可するために、オラクル社では次に示す直接付与による権限をお薦めします。

grant CREATE SESSION to [database username]

grant CREATE CLUSTER to [database username]

grant CREATE DIMENSION to [database username]

grant CREATE INDEXTYPE to [database username]

grant CREATE JOB to [database username]

grant CREATE MATERIALIZED VIEW to [database username]

grant CREATE OPERATOR to [database username]

grant CREATE PROCEDURE to [database username]

grant CREATE SEQUENCE to [database username]

grant CREATE SNAPSHOT to [database username]

grant CREATE SYNONYM to [database username]

grant CREATE TABLE to [database username]

grant CREATE TRIGGER to [database username]

grant CREATE TYPE to [database username]

grant CREATE VIEW to [database username]

D.2 PUBLICに付与される権限の理解

このセクションでは、既存のパブリック・シノニムについて説明します。パブリック・シノニムでは、Oracle Application Express製品スキーマ(たとえば、APEX_050000)が所有するパッケージ、プロシージャ、ファンクション、表およびビューに対するEXECUTE権限がPUBLICに付与されています。

- パッケージ

- プロシージャ

- ファンクション

- 表

- ビュー

- 順序

- タイプ

D.2.1 パッケージ

パブリック・シノニムが存在し、Oracle Application Express製品スキーマ(たとえば、APEX_050000)が所有する次のパッケージに対するEXECUTE権限がPUBLICに付与されます。

APEXWS

APEX_MIG_PROJECTS_UPDATE

APEX_UI_DEFAULT_UPDATE

HTMLDB_CUSTOM_AUTH

HTMLDB_ITEM

HTMLDB_LANG

HTMLDB_SITE_ADMIN_PRIVS

WWV_FLOW_APPLICATION_INSTALL

HTMLDB_UTIL

WWV_FLOW

WWV_FLOW_API

WWV_FLOW_AUDIT

WWV_FLOW_CSS_API

WWV_FLOW_APPLICATION_INSTALL

WWV_FLOW_AUDIT

WWV_FLOW_COLLECTION

WWV_FLOW_CSS

WWV_FLOW_CSS_API

WWV_FLOW_CUSTOMIZE

WWV_FLOW_CUSTOM_AUTH

WWV_FLOW_CUSTOM_AUTH_LDAP

WWV_FLOW_CUSTOM_AUTH_STD

WWV_FLOW_DEBUG_MESSAGE

WWV_FLOW_EPG_INCLUDE_MODULES

WWV_FLOW_FILE_MGR

WWV_FLOW_FND_USER_API

WWV_FLOW_GLOBAL

WWV_FLOW_HINT

WWV_FLOW_HTML_API

WWV_FLOW_ID

WWV_FLOW_IMAGE_API

WWV_FLOW_ITEM

WWV_FLOW_ITEM_HELP

WWV_FLOW_JAVASCRIPT

WWV_FLOW_LANG

WWV_FLOW_LDAP

WWV_FLOW_LOOKUP_TABLES

WWV_FLOW_MAIL

WWV_FLOW_PLSQL_JOB

WWV_FLOW_PLUGIN

WWV_FLOW_PLUGIN_UTIL

WWV_FLOW_PREFERENCES

WWV_FLOW_RANDOM

WWV_FLOW_RENDER_SHORTCUT

WWV_FLOW_REST

WWV_FLOW_SVG

WWV_FLOW_USER_API

WWV_FLOW_UTILITIES

WWV_FLOW_WEBSERVICES_API

WWV_FLOW_WS_IMPORT_API

WWV_MIG_ACC_LOAD

WWV_RENDER_CALENDAR2

WWV_RENDER_CHART2

Oracle Application Express製品スキーマ(たとえば、APEX_050000)が所有する次のパッケージに対するEXECUTE権限がPUBLICに付与されます。

WWV_CALCULATOR

WWV_FLOW_FLASH_CHART

WWV_FLOW_GENERATE_DDL

WWV_FLOW_IMAGE_GENERATOR

WWV_FLOW_TREE_GLOBAL_VARS

D.2.2 プロシージャ

パブリック・シノニムが存在し、Oracle Application Express製品スキーマ(たとえば、APEX_050000)が所有する次のプロシージャに対するEXECUTE権限がPUBLICに付与されます。

APEX

APEX_ADMIN

DEVELOPMENT_SERVICE_HOME

DEVELOPMENT_SERVICE_HOME_LOGIN

DEVELOPMENT_SERVICE_SIGNUP

F

HTMLDB

HTMLDB_ADMIN

HTMLDB_LOGIN

P

WS

WWV_FLOW_INIT_HTP_BUFFER

Z

D.2.3 ファンクション

パブリック・シノニムが存在し、Oracle Application Express製品スキーマ(たとえば、APEX_050000)が所有する次のファンクションに対するEXECUTE権限がPUBLICに付与されます。

NV

V

Oracle Application Express製品スキーマ(たとえば、APEX_050000)が所有する次のファンクションに対するEXECUTE権限がPUBLICに付与されます。

WWV_POPUP_FILTER

D.2.4 表

パブリック・シノニムが存在し、Oracle Application Express製品スキーマ(たとえば、APEX_050000)が所有する次の表に対するSELECT権限がPUBLICに付与されます。

WWV_FLOW_DUAL100

WWV_FLOW_TEMP_TABLE

WWV_FLOW_LOV_TEMP

D.2.5 ビュー

パブリック・シノニムが存在し、Oracle Application Express製品スキーマ(たとえば、APEX_050000)が所有する次のビューに対する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_CACHING

APEX_APPLICATION_COMPUTATIONS

APEX_APPLICATION_GROUPS

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_DA

APEX_APPLICATION_PAGE_DA_ACTS

APEX_APPLICATION_PAGE_DB_ITEMS

APEX_APPLICATION_PAGE_FLASH5

APEX_APPLICATION_PAGE_FLASH5_S

APEX_APPLICATION_PAGE_FLASH_CH

APEX_APPLICATION_PAGE_GROUPS

APEX_APPLICATION_PAGE_IR

APEX_APPLICATION_PAGE_IR_CAT

APEX_APPLICATION_PAGE_IR_CGRPS

APEX_APPLICATION_PAGE_IR_COL

APEX_APPLICATION_PAGE_IR_COMP

APEX_APPLICATION_PAGE_IR_COND

APEX_APPLICATION_PAGE_IR_GRPBY

APEX_APPLICATION_PAGE_IR_PIVOT

APEX_APPLICATION_PAGE_IR_PVAGG

APEX_APPLICATION_PAGE_IR_PVSRT

APEX_APPLICATION_PAGE_IR_RPT

APEX_APPLICATION_PAGE_IR_SUB

APEX_APPLICATION_PAGE_ITEMS

APEX_APPLICATION_PAGE_MAP

APEX_APPLICATION_PAGE_PROC

APEX_APPLICATION_PAGE_REGIONS

APEX_APPLICATION_PAGE_RPT

APEX_APPLICATION_PAGE_RPT_COLS

APEX_APPLICATION_PAGE_TREES

APEX_APPLICATION_PAGE_VAL

APEX_APPLICATION_PARENT_TABS

APEX_APPLICATION_PROCESSES

APEX_APPLICATION_SHORTCUTS

APEX_APPLICATION_SUBSTITUTIONS

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_TRANS_MAP

APEX_APPLICATION_TREES

APEX_APPLICATION_WEB_SERVICES

APEX_APPL_PLUGINS

APEX_APPL_PLUGIN_ATTRIBUTES

APEX_APPL_PLUGIN_ATTR_VALUES

APEX_APPL_PLUGIN_EVENTS

APEX_APPL_PLUGIN_FILES

APEX_DEBUG_MESSAGES

APEX_DEVELOPER_ACTIVITY_LOG

APEX_DICTIONARY

APEX_MIGRATION_ACC_FORMS

APEX_MIGRATION_ACC_PROJECTS

APEX_MIGRATION_ACC_QUERIES

APEX_MIGRATION_ACC_RPTS

APEX_MIGRATION_ACC_TABLES

APEX_MIGRATION_PROJECTS

APEX_MIGRATION_REV_FORMS

APEX_MIGRATION_REV_QUERIES

APEX_MIGRATION_REV_RPTS

APEX_MIGRATION_REV_TABLES

APEX_RELEASE

APEX_STANDARD_CONDITIONS

APEX_TEAM_BUGS

APEX_TEAM_FEEDBACK

APEX_TEAM_MILESTONES

APEX_TEAM_TODOS

APEX_THEMES

APEX_UI_DEFAULTS_ATTR_DICT

APEX_UI_DEFAULTS_COLUMNS

APEX_UI_DEFAULTS_GROUPS

APEX_UI_DEFAULTS_LOV_DATA

APEX_UI_DEFAULTS_TABLES

APEX_WORKSPACES

APEX_WORKSPACE_ACCESS_LOG

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

APEX_WS_APPLICATIONS

APEX_WS_APP_PAGES

APEX_WS_DATA_GRID

APEX_WS_DATA_GRID_COL

WWV_FLOW_CLICKTHRU_LOG

WWV_FLOW_COLLECTIONS

WWV_FLOW_FEEDBACK_TYPES

WWV_FLOW_GROUP_USERS

WWV_FLOW_LISTS_OF_VALUES$_V

WWV_FLOW_LIST_OF_VALUES_DATA_V

WWV_FLOW_MONTHS_MON

WWV_FLOW_MONTHS_MONTH

WWV_FLOW_PLSQL_JOBS

WWV_FLOW_USERS

WWV_FLOW_USER_ACCESS_LOG

WWV_FLOW_USER_ACTIVITY_LOG

WWV_FLOW_USER_MAIL_LOG

WWV_FLOW_YEARS

また、次のビューにはINSERTが付与されています。

WWV_FLOW_FILES

さらに、次のビューではPUBLICにSELECT権限が付与されていますが、シノニムが存在しません。

WWV_FLOW_HOURS_12

WWV_FLOW_HOURS_24

WWV_FLOW_MINUTES

WWV_FLOW_MINUTES_5

D.2.6 順序

次の順序にはパブリック・シノニムがあり、PUBLICにSELECT権限が付与されています。

WWV_FLOW_SESSION_SEQ

WWV_SEQ

D.2.7 タイプ

次のタイプでは、PUBLICにEXECUTEが付与されていますが、シノニムが存在しません。

WWV_FLOW_TREE_ENTRY

WWV_FLOW_TREE_SUBS

E Oracle Application Expressのアクセシビリティ

この項では、キーボードまたはFreedom Scientific社のスクリーン・リーダーJAWSのみを使用してOracle Application Expressにアクセスするユーザーに情報を提供します。

注意:
このセクションに記載されている内容は、すべてデフォルト設定のJAWSリリース16.0を使用しています。この項の手順はすべて、フル・サイズのキーボードの使用に基づきます。ラップトップのキーボードを使用している場合は、手順が異なることがあることに注意してください。

- スクリーン・リーダー・モードの理解

- ハイ・コントラスト・モードの理解

- JAWSを使用したフォーム・ページへのアクセス

- キーボードを使用したOracle Application Expressへのアクセス

参照:
Oracle製品のアクセシビリティに関する詳細は、「Oracle's Accessibility Program」を参照してください。
http://www.oracle.com/us/corporate/accessibility/index.html

E.1 スクリーン・リーダー・モードの理解

この項では、スクリーン・リーダー・モードについて説明します。セッションは、スクリーン・リーダーでの使用に最適化されるように定義できます。これには、Application Express開発環境を使用する場合と、ユーザー独自のアプリケーションを使用する場合の両方が含まれています。

- スクリーン・リーダー・モードの有効化

- データベース・アプリケーションでのスクリーン・リーダー・モードの使用

- スクリーン・リーダー・モードの機能

E.1.1 スクリーン・リーダー・モードの有効化

スクリーン・リーダー・モードを有効にするには、ワークスペースのホームページとOracle Application Express管理サービスのページにある「アクセシビリティ・モード」リストから「スクリーン・リーダー」を選択します。

Webシート・アプリケーションでスクリーン・リーダー・モードを有効にするには、「Webシート」ホームページの右側下にある「スクリーン・リーダー」リンクをクリックします。

Oracle Application Express開発環境をスクリーン・リーダーとともに使用する場合は、このオプションが有効であることを確認してください。

E.1.2 データベース・アプリケーションでのスクリーン・リーダー・モードの使用

Oracle Application Express開発環境、Webシート・ランタイムに加え、独自のデータベース・アプリケーション内でも、現在Oracle Application Expressのセッションはスクリーン・リーダー用に最適化済と確認できます。デフォルトでは、セッションはスクリーン・リーダー・モードで実行するようにフラグ付けされていません。この項では、独自のデータベース・アプリケーションのユーザーがこのモードを使用できるようにする方法とそれを拡張する方法について説明します。

ヒント:
スクリーン・リーダー・モードによって、スクリーン・リーダーによるOracle Application Expressの有用性が改善されますが、領域によっては未解決の問題が残っている場合があります。未解決の問題とその回避策(ある場合)の完全なリストは、「スクリーン・リーダー・モードの機能」および『Oracle Application Expressリリース・ノート』を参照してください。

- スクリーン・リーダー・モードのプロビジョニング

- スクリーン・リーダー・モードの拡張

関連項目:
「スクリーン・リーダー・モードの理解」

E.1.2.1 スクリーン・リーダー・モードのプロビジョニング

独自のデータベース・アプリケーションで使用するスクリーン・リーダー・モードをプロビジョニングするには、次の3つの方法があります。

1. ページ・テンプレート#SCREEN_READER_TOGGLE#置換文字列を使用します。
#SCREEN_READER_TOGGLE#置換文字列をページ・テンプレートに追加すると、Oracle Application Expressでは、モードをオンまたはオフにする(切り替える)ためのリンクがカレント・ページに表示されます。したがって、標準モードの場合、このプロシージャによってモードをオンに切り替えるリンクが生成されます。

2. スクリーン・リーダー・モードの制御にAPIを使用します。
1つの場所でのみ切替えをレンダリングし、ページ・テンプレート・レベルでは行わない場合や、実際に表示されるリンク・テキストをより詳細に制御する場合に、APIを使用したい場合があります。詳細は、『Oracle Application Express APIリファレンス』のAPEX_UTILに関する説明を参照してください。

3. f?p構文のREQUEST属性を使用してスクリーン・リーダー・モードを有効化および無効化します。
f?pの一般的な構文は、次のとおりです。

f?p=application:page:session:request:...

リクエストがSET_SESSION_SCREEN_READER_ONまたはSET_SESSION_SCREEN_READER_OFFの場合、セッションのスクリーン・リーダー・モードがオンまたはオフになります。次に例を示します。

<a href="f?p=100:1:&SESSION.:SET_SESSION_SCREEN_READER_ON">Set Screen Reader On</a>

E.1.2.2 スクリーン・リーダー・モードの拡張

「スクリーン・リーダー・モードの機能」で説明されている、このモードのデフォルトの機能に加えて、ユーザー独自のページ・コンポーネントを制御することもできます。たとえば、スクリーン・リーダー・モードでの実行時に、条件付きでリージョンを表示できます。関連するデータベース・ファンクション、APEX_UTIL.IS_SCREEN_READER_SESSIONおよびAPEX_UTIL.IS_SCREEN_READER_SESSION_YNの詳細は、『Oracle Application Express APIリファレンス』のAPEX_UTILに関する説明を参照してください。

E.1.3 スクリーン・リーダー・モードの機能

スクリーン・リーダー・モードを有効化すると、現在はデフォルトで次の機能を実行します。

- Oracle Application Express Flashチャートはスクリーン・リーダーから現在アクセスできないため、スクリーン・リーダー・モードで実行すると、ユーザーはチャートで伝達される情報のレポート表示を受け取ります。複数シリーズのチャートでは、各シリーズについて別々のレポートが生成されます。スクリーン・リーダー・モードで実行するとき、これらのデータ表には説明テキストが次の形式で格納されます。

- データベース・アプリケーションの場合

- サマリー・テキスト: チャート・タイトルとチャート・シリーズ・タイトルの組合せが使用されます。

- 列ヘッダー: チャート・シリーズ問合せの列名または別名は、レポートの列を識別します。

- Webシート・アプリケーションの場合

- サマリー・テキスト: セクション・タイトルがサマリー・テキストとして使用されます。

- 列ヘッダー: 「データ・グリッド」レポート・ラベルは、レポートの列を識別します。

- Report ViewまたはGroup By Viewの対話モード・レポート・リージョンでは、情報を伝達するためにデータ表が使用されます。データ表では、スクリーン・リーダーのユーザーに対して表が格納する情報を記述するテキスト記述が必要です。スクリーン・リーダー・モードで実行するとき、これらのデータ表には詳細なサマリー・テキストが次の形式で格納されます。

- リージョン: 開発者により定義されるリージョンの名前。

- レポート: 「対話モード・レポート」内の現在の「保存されたレポート」の名前。「保存されたレポート」が定義されていない場合は、デフォルトの「プライマリ・デフォルト」に設定されます。

- ビュー: レポートの現在のビュー(「レポート」または「グループ化」のいずれか)。

- 表示行の開始: 現在表示されている行セットの開始行。

- 表示行の終了: 現在表示されている行セットの終了行。

- 行合計: レポートにより返された行の合計数。

- 対話モード・レポート・リージョンには、レポート・データにAggregatesを追加する機能が提供されています。使用可能な集計の1つが列の値のSumです。スクリーン・リーダー・モードでの実行中、合計された値の接頭辞としてSum:のテキストが表示されます。標準モードでは、合計された値のみが表示されます。その他の集計では、モードにかかわらず、集計タイプ接頭辞がデフォルトで表示されます。

- アイテム・レベルのヘルプ・テキストは、スクリーン・リーダー・モードでは別の方法で提供されます。標準モードでは、特定アイテムのヘルプ・テキストを表示するダイアログがページに表示されます。ただし、これらのダイアログはスクリーン・リーダーと一緒に使用する場合に多くの問題があるため、スクリーン・リーダー・モードで実行するときは、クラシック・ポップアップ・ページを使用してアイテムのヘルプ・テキストを表示します。

- Application Expressによって、データベース・アプリケーションには、ツリーとjsTree (レガシー)の2つのツリー・リージョン・コンポーネント実装が含まれています。アクセシビリティの向上のために、ツリーを使用することをお薦めします。jsTree (legacy) にはアクセシビリティの問題がいくつかあるため、スクリーン・リーダー・モードで実行すると、ユーザーはツリーで伝達される情報の表示として、順序付けられていない階層リストを受け取ります。

- スクリーン・リーダー・モードでは、発生した検証エラーに対するユーザーの処理プロセスが大きく改善されています。次の例を想定してください。フォーム・ページが送信され、検証が失敗して、エラーが表示されました。ページ・アイテムに関連付けられているエラーがある場合、マークアップがページ・アイテムに追加され、フォーム・フィールドを移動する際に、スクリーン・リーダーによってアイテムに無効なエントリが含まれていることがユーザーに通知されます。さらに、フォーム・フィールドを移動する際に、対応するエラー・メッセージがユーザーに通知されます。

ヒント:
これらの改善を利用するには、使用するスクリーン・リーダーとブラウザの両方でWAI-ARIAがサポートされている必要があります。

- 対話モード・レポート・リージョンには固定ヘッダー・オプションがあり、開発者はこれを使用して、ビジュアル・ユーザー向けに対話モード・レポートのヘッダーを固定できます。この機能は基礎となる表構造を変更しますが、このことはスクリーン・リーダー・ユーザーにとって不利益となるため、スクリーン・リーダー・モードの実行時には、このオプションは無効になります。

E.2 ハイ・コントラスト・モードの理解

この項では、ハイ・コントラスト・モードについて説明します。Webシートおよびデータベース・アプリケーションでハイ・コントラスト用に最適化する対象としてセッションを指定できます。デフォルトでは、セッションはハイ・コントラスト・モードで実行するようにフラグ付けされていません。

- Webシート・アプリケーションでのハイ・コントラスト・モードの有効化

- データベース・アプリケーションでのハイ・コントラスト・モードの使用

- ハイ・コントラスト・モードの機能

E.2.1 Webシート・アプリケーションでのハイ・コントラスト・モードの有効化

Webシート・アプリケーションでハイ・コントラスト・モードを有効にするには、Webシート・ホームページの右側下にある「ハイ・コントラスト」リンクをクリックします

E.2.2 データベース・アプリケーションでのハイ・コントラスト・モードの使用

Webシート・アプリケーションおよび独自のデータベース・アプリケーションでハイ・コントラスト用に最適化する対象としてセッションを指定できます。この項では、独自のデータベース・アプリケーションのユーザーがこのモードを使用できるようにする方法とそれを拡張する方法について説明します。

- ハイ・コントラスト・モードのプロビジョニング

- ハイ・コントラスト・モードの拡張

関連項目:
「ハイ・コントラスト・モードの理解」

E.2.2.1 ハイ・コントラスト・モードのプロビジョニング

独自のデータベース・アプリケーションのユーザーに対してハイ・コントラスト・モードをプロビジョニングするには、次の3つの方法があります。

- ページ・テンプレート#HIGH_CONTRAST_TOGGLE#置換文字列を使用します。
#HIGH_CONTRAST_TOGGLE#置換文字列をページ・テンプレートに追加すると、Oracle Application Expressでは、モードをオンまたはオフにする(切り替える)ためのリンクがカレント・ページに表示されます。つまり、標準モードの場合、このプロシージャによってモードをオンに切り替えるリンクが生成されます。

- ハイ・コントラスト・モードの制御にAPIを使用します。
このモードの制御に、APEX_UTIL APIを使用します。1つの場所でのみ切替えをレンダリングし、ページ・テンプレート・レベルでは行わない場合や、実際に表示されるリンク・テキストをより詳細に制御する場合に、APIを使用したい場合があります。詳細は、『Oracle Application Express APIリファレンス』のAPEX_UTILに関する説明を参照してください。

- f?p構文のREQUEST属性を使用してハイ・コントラスト・モードを有効化および無効化します。
f?p構文のREQUEST属性の一般的な構文は、次のとおりです。

f?p=application:page:session:request:...

リクエストがSET_SESSION_HIGH_CONTRAST_ONまたはSET_SESSION_HIGH_CONTRAST_OFFの場合、セッションのハイ・コントラスト・モードがオンまたはオフになります。次に例を示します。

<a href="f?p=100:1:&SESSION.:SET_SESSION_HIGH_CONTRAST_ON">Set High Contrast On</a>

E.2.2.2 ハイ・コントラスト・モードの拡張

「ハイ・コントラスト・モードの機能」で説明されている、このモードのデフォルトの機能に加えて、ユーザー独自のコンポーネントを制御することもできます。たとえば、ハイ・コントラスト・モードでの実行時に、ハイ・コントラストに固有のCSSファイルを条件付きで含めることができます。

ファンクションAPEX_UTIL.IS_HIGH_CONTRAST_SESSIONとAPEX_UTIL.IS_HIGH_CONTRAST_SESSION_YNの詳細は、『Oracle Application Express APIリファレンス』のAPEX_UTILに関する説明を参照してください。

E.2.3 ハイ・コントラスト・モードの機能

ハイ・コントラスト・モードを有効化すると、次の動作が行われます。

- Application Express Webシート・ランタイム。
Webシート・アプリケーションにより、CSSベースのイメージ・リンクがテキスト・リンクで置き換えられます。これらのテキスト・リンクは、ソース・イメージが透明であり、その場所でCSS背景プロパティが使用されているイメージについてのみ作成されます。

- カスタム・データベース・アプリケーション。
フレームワークからネイティブには何も行われません。各開発者が、モードをプロビジョニングし、必要に応じて変更を行う必要があります。

E.3 JAWSを使用したフォーム・ページへのアクセス

Oracle Application Expressのページの多くは、アプリケーションのメタデータを保持するために設計されたフォーム・ページです。このセクションでは、これらのページの構造について理解し、JAWSなどのスクリーン・リーダーを使用して対話する方法について説明します。

- ページの構造について

- ヘルプ・テキストへのアクセス

- 検証エラーの処理

E.3.1 ページの構造について

多くのフォーム・ページは、論理的に異なるリージョンに分けられます。たとえば、「ページ・アイテムの編集」ページには、ページ・アイテムに関する情報を保持するためのフォーム・フィールドを含む次のリージョンがあります。

- 名前

- Displayed

- Label

- 設定

- LOV(アイテム・タイプに応じたもの)

- 要素

- ソース

- デフォルト

- クイック選択(アイテム・タイプに応じたもの)

- 条件

- 読取り専用

- セキュリティ

- 構成

- ヘルプ・テキスト

- コメント

Oracle Application Expressでは、その開発インタフェース全体を通じてヘッダー(Hn)・タグを使用し、ページ構造を定義します。たとえば、ページ・アイテムの編集ページには、カレント・アイテム名に関するテキストを含むH1ヘッダーが1つと、前述のリストのすべてのアイテム属性グループを含む、その他すべての個別のページ・セクション用のH2ヘッダーが含まれます。このようなページのナビゲートには、標準のスクリーン・リーダー・ヘッダー・ナビゲーションを使用してください。

E.3.2 ヘルプ・テキストへのアクセス

Application Express開発環境内の大部分のアイテムには、フィールドレベル・ヘルプが定義されています。フィールドレベル・ヘルプを実行するには、ヘルプが必要なアイテムにフォーカスを置いて、キーボード・ショートカット[Alt]+[F1]を押します。このキーボード・ショートカットを押すと、ヘルプ・テキストを含むポップアップ・ウィンドウが表示されます。

E.3.3 検証エラーの処理

Oracle Application Expressには、JAWSユーザーがフォーム・ページの検証エラーを処理する際に役立つ機能が多数組み込まれています。

- 「エラーが発生しました」の理解について

- エラーの確認

- データベース・アプリケーションへの検証通知の追加

- エラーを修正するために関連フィールドにナビゲート

- WAI-ARIAサポートについて

E.3.3.1 「エラーが発生しました」の理解について

スクリーン・リーダー・モードの使用時にフォーム・ページで検証が失敗すると、ページ・タイトルの前に次の接頭辞が付けられます。

x errors have occurred - [page title]

ページがロードされると、JAWSによりページ・タイトルが通知されます。つまり、JAWSのユーザーには、検証が失敗したことがすぐに伝わります。

ヒント:
この動作は、スクリーン・リーダー・モードをプロビジョニングするカスタム・データベース・アプリケーションでも、デフォルトで使用可能です。「スクリーン・リーダー・モードの理解」を参照してください。

E.3.3.2 エラーの確認

エラー・メッセージが表示されているページのセクションにナビゲートするには、このセクションの上部で「通知メッセージ」というテキストを含むH2(ヘッダー・レベル2)タグを見つけます。このヘッダーは視覚的には非表示になっていますが、スクリーン・リーダーのユーザーは使用できます。

E.3.3.3 データベース・アプリケーションへの検証通知の追加

独自のデータベース・アプリケーションに簡単に検証通知を追加できます。これを行うには、ページ・テンプレートの「ページ・テンプレート」、「サブテンプレート」、「通知」セクションに、置換文字列#NOTIFICATION_MESSAGE_HEADING#を追加します。このプレースホルダにより、組込みシステム・メッセージAPEX.NOTIFICATION_MESSAGE_HEADINGの内容が「通知メッセージ」というテキストに置換されます。

この表示テキストをカスタマイズするには、ご使用のアプリケーションで、使用するテキストとともに、APEX.NOTIFICATION_MESSAGE_HEADINGという名前のテキスト・メッセージを定義してください。

たとえば、ページ・テンプレートの「通知」セクションに、次を追加できます。

<h2 class="hideMeButHearMe">#NOTIFICATION_MESSAGE_HEADING#</h2>

この例では、hideMeButHearMe CSSクラスの使用によりコンテンツが視覚的に非表示になりますが、スクリーン・リーダーのユーザーはこれを使用できます。

E.3.3.4 エラーを修正するために関連フィールドにナビゲート

特定のページ・アイテムに関連する検証では、Oracle Application Expressにより、該当するエラー・メッセージの隣にある「通知」セクションに「エラーに移動」リンクが表示されます。ユーザーが「エラーに移動」リンクをクリック(またはアクティブ化)すると、関連するアイテムにフォーカスが移動します。これにより、(スクリーン・リーダーのユーザーのみでなく)すべてのユーザーが、エラーに関連するページにすぐに移動できるようになります。

「エラーに移動」テキストを変更して、デフォルトのテキストを変更したり、Oracle Application Expressによってデフォルトでは翻訳されない言語に翻訳することができます。いずれの場合でも、必要なテキストと言語とともに、APEX.GO_TO_ERRORという名前のテキスト・メッセージを定義してください。さらに、APEX.GO_TO_ERRORテキスト・メッセージのテキストを単なるシングル・スペースに設定して、この機能を無効化し、「エラーに移動」リンクを削除できます。

関連項目:
「Oracle Application Expressにより内部使用されるメッセージの翻訳」

。

E.3.3.5 WAI-ARIAサポートについて

スクリーン・リーダー・モードで実行する場合、Oracle Application Expressにより、無効なページ・アイテムにWeb Accessibility Initiative - Accessible Rich Internet Applications(WAI-ARIA)マークアップが含められます。この拡張により、WAI-ARIAをサポートするスクリーン・リーダーとブラウザの組合せに対するスクリーン・リーダーのユーザーの操作性が向上します。

特定のページ・アイテムに関連するエラーが発生すると、そのページ・アイテムに次の追加の属性が付けられます。

- aria-invalid="true"
これは、スクリーン・リーダーのユーザーがそのページ・アイテムにフォーカスすると、スクリーン・リーダーにより無効なエントリであることが通知されることを意味します。

- aria-describedby="[page_item_name]_error"
この属性値はそのアイテムに関連するエラー・メッセージに対応付けられているため、スクリーン・リーダーのユーザーがそのページ・アイテムにフォーカスすると、スクリーン・リーダーにより実際のエラーが通知されます。

この拡張が行われる前は、エラーのあるページ・アイテムにスクリーン・リーダーのユーザーがナビゲートすると、スクリーン・リーダーにより「ジョブ、編集、テキストのタイプ」と通知されることがありました。現在は、スクリーン・リーダーにより「ジョブの編集、無効なエントリ、ジョブに値が必要です、テキストのタイプ」と通知されます。

ヒント:
プラグイン・アイテムの開発者が独自のプラグインで同じWAI-ARIAサポートを提供するには、『Oracle Application Express APIリファレンス』のAPEX_ERROR.GET_ARIA_ERROR_ATTRIBUTESファンクションに関する説明を参照してください。

E.4 キーボードを使用したOracle Application Expressへのアクセス

このセクションでは、キーボードを使用してOracle Application Expressのコンポーネントにアクセスする方法について説明します。

- 新しい日付ピッカーの使用

- 対話モード・レポート・リージョンへのアクセス

- キーボード・ショートカット

E.4.1 新しい日付ピッカーの使用

日付ピッカー用の多数のキーボード・ショートカットがあります。

日付ピッカーを開くには、次のステップを実行します。

1. [Tab]を使用して、適切な入力フィールドに移動します。

2. [Ctrl]+[Home]を押して、日付ピッカーを開きます。

3. 日付ピッカーが開くと、次のナビゲート・オプションを使用できます。

- 月単位:

- [Page Up]を押すと、前の月に移動します。

- [Page Down]を押すと、次の月に移動します。

- [Ctrl]＋[Home]を押すと、現在の月に移動します。

- 週単位:

- [Ctrl]＋[↑]を押すと、前の週に移動します。

- [Ctrl]＋[↓]を押すと、次の週に移動します。

- 日単位:

- [Ctrl]＋[←]を押すと、前の日に移動します。

- [Ctrl]＋[→]を押すと、次の日に移動します。

日付ピッカーでの作業が終了したら、次のステップを実行します。

1. [Enter]を押して、選択された日付を受け入れます。

2. [Esc]を押して、選択せずに日付ピッカーを閉じます。

3. [Ctrl]＋[End]を押して、日付ピッカーを閉じて、日付を消去します。

E.4.2 対話モード・レポート・リージョンへのアクセス

このセクションでは、対話モード・レポート・リージョン内の一般的な機能にアクセスする方法について説明します。

- 対話モード・レポートでのデータの検索

- 「アクション」メニューの使用

- バルク更新の管理

- ドリルダウン・リンクの使用

- 既存のフィルタの編集

- 保存済レポートのロード

E.4.2.1 対話モード・レポートでのデータの検索

検索バーが対話モード・レポートの上に表示されている場合は、「レポート属性」の「検索バーを含める」属性が有効になっています。新しい対話モード・レポートを作成すると、この属性はデフォルトで有効になります。

検索を行うには、次のステップを実行します。

1. 検索フィールドがフォーカスされるまで、[Tab]を押します。

2. 検索フィールドに、検索キーワードを入力します。

3. [Enter]を押して、検索を実行します。

4. 特定の列に検索を絞り込むには、次のステップを実行します。

1. [Tab]を押して、検索フィールドの左にある虫眼鏡アイコンにアクセスします。

2. [Enter]を押して、プルダウン・メニューをアクティブにし、検索に使用できるすべての列のリストを表示します。

3. キーボードの[↓]または[↑]キーを押して、列のリストをナビゲートします。

4. [Enter]を押して、検索対象の列を選択します。これによって、後続の検索のコンテキストが、選択した列に特化したものに設定されます。

5. ステップ1および2を繰り返して、列に特化した検索を実行します。

E.4.2.2 「アクション」メニューの使用

新しい対話モード・レポートには、デフォルトで、検索バーおよび「アクション」メニューの両方が含まれています。これらの両方の機能は、レポート属性ページの「検索バーを含める」および「アクション」メニュー属性を有効にすることによって、開発者が制御します。開発者がレポートを作成する方法に応じて、「アクション」メニューには様々なオプションを含めることができます。

関連項目:
「「アクション」メニューについて」

キーボードを使用して「アクション」メニューにアクセスするには、次のステップを実行します。

1. 「アクション」メニューがフォーカスされるまで、[Tab]を押します。

2. [Enter]を押して、メニューを開きます。

3. メニューが開くと、次のナビゲート・オプションを使用できます。

- [↓]キーを押して、メニューを下に移動します。

- [↑]キーを押して、メニューを上に移動します。

- [→]キーを押して(右矢印で示されている)サブメニューを開き、フォーカスをサブメニューの最初のアイテムに移動します。

- [←]キーを押してサブメニューを閉じ、フォーカスを親メニューの適切なアイテムに戻します。

4. 「アクション」メニューを終了するには、次のステップを実行します。

- [Enter]を押して、アクション固有のダイアログをロードします。フォーカスは、ダイアログ・ボックス内のフォーカス可能な最初の要素に設定されます。

- [Esc]を押して、選択せずにメニューを閉じます。

E.4.2.3 バルク更新の管理

Oracle Application Expressの一部の対話モード・レポートには、バルク更新をコンポーネントに適用するためのフォーム・アイテムが含まれています。レポート内のすべてのフォーム・アイテムと、変更を適用するためのボタンには、キーボードでアクセスできます。また、一部のページには、バルク処理を実行するためのチェック・ボックスが最初の行にあり、対応する「すべて選択」と「すべて選択解除」リンクがレポートの下にあります。これらのすべてのアイテムには、キーボードでアクセスできます。

E.4.2.4 ドリルダウン・リンクの使用

Oracle Application Expressの一部の対話モード・レポートには、特定のサブコンポーネントを編集または表示するための1つ以上のリンクが含まれています。これらはすべて標準のリンクであるため、キーボードでアクセスできます。

E.4.2.5 既存のフィルタの編集

対話モード・レポートに既存の検索フィルタを適用すると、検索バーの下に検索フィルタが表示されます。

検索フィルタには、次のようにキーボードを使用してアクセスできます。

- 検索フィルタの編集
[Tab]を押して検索フィルタにナビゲートし、[Enter]を押して「フィルタ」ダイアログ・ボックスを開きます。フォーカスは、ダイアログ・ボックス内のフォーカス可能な最初の要素に自動的に設定されます。

- 検索フィルタの有効化または無効化
[Tab]を押してフィルタの左側にあるチェック・ボックスにナビゲートし、[Space]を押して、フィルタを有効化または無効化します。

- 検索フィルタの削除
[Tab]を押して検索フィルタにナビゲートし、[Enter]を押して、「フィルタ」ダイアログ・ボックスを開きます。[Tab]または[Shift]＋[Tab]を押して「削除」ボタンにナビゲートし、[Enter]を押します。

E.4.2.6 保存済レポートのロード

対話モード・レポートに、検索バー、「アクション」メニューおよび保存済レポートのサポートが含まれている場合、これらのオプションはレポート属性ページで開発者によって有効にされています。

関連項目:
「ページ・デザイナでの対話モード・レポートの編集」および「コンポーネント・ビューでの対話モード・レポートの編集」

保存済レポートをロードするには、次のステップを実行します。

1. 「レポート」選択リストがフォーカスされるまで、[Tab]を押します。「レポート」選択リストが表示されるのは、保存済レポートが存在する場合のみであることに注意してください。

2. [↑]および[↓]キーを押して、表示する特定の保存済レポートを選択します。

3. [Enter]を押して、保存済レポートを表示します。

E.4.3 キーボード・ショートカット

表E-1に、使用可能なOracle Application Expressキーボード・ショートカットを示します。

表E-1 Oracle Application Expressキーボード・ショートカット

使用場所

キー

アクション

ページ・デザイナのグリッド・レイアウト

[Ctrl]+[Alt]+[D]

ここから表示

ページ・デザイナのグリッド・レイアウト

[Ctrl]+[Alt]+[T]

ページから表示

ページ・デザイナ

[Alt]+[2]

動的アクションに移動

ページ・デザイナ

[Alt]+[9]

ギャラリ・ボタンに移動

ページ・デザイナ

[Alt]+[8]

ギャラリ・アイテムに移動

ページ・デザイナ

[Alt]+[7]

ギャラリ・リージョンに移動

ページ・デザイナ

[Alt]+[5]

グリッド・レイアウトに移動

ページ・デザイナ

[Alt]+[F1]

ヘルプに移動

ページ・デザイナ

[Ctrl]+[F1]

メッセージに移動

ページ・デザイナ

[Alt]+[4]

ページ共有コンポーネントに移動

ページ・デザイナ

[Alt]+[3]

処理に移動

ページ・デザイナ

[Alt]+[6]

プロパティ・エディタに移動

ページ・デザイナ

[Alt]+[1]

レンダリングに移動

ページ・デザイナ

[Alt]+[Shift]+[F1]

キーボード・ショットカットのリスト表示

ページ・デザイナ

[Ctrl]+[Alt]+[F]

ページ検索

ページ・デザイナ

[Ctrl]+[Y]

やり直し

ページ・デザイナ

[Alt]+[F11]

リストア/展開

ページ・デザイナ

[Ctrl]+[Alt]+[S]

Save

ページ・デザイナ

[Ctrl]+[Alt]+[R]

ページの保存と実行

ページ・デザイナ

[Ctrl]+[Alt]+[E]

「空の位置の非表示」の切替え

ページ・デザイナ

[Ctrl]+[Z]

元に戻す

ページ・デザイナで、コンテキスト・メニューがある場所にフォーカスを置いた状態

[Shift]+[F10]またはコンテキスト・メニュー・キー

コンテキスト・メニューを開く

ページ・デザイナのグリッド・レイアウトの、ウィザード内のギャラリおよびアイコン・リスト

矢印キー

選択の移動

ページ・デザイナのプロパティ・エディタで、グループ・ヘッダーにフォーカスを置いた状態

上/下矢印キー

前/次のグループに移動

ページ・デザイナのプロパティ・エディタで、グループ・ヘッダーにフォーカスを置いた状態

[Home]/[End]キー

最初/最後のグループに移動

ページ・デザイナのプロパティ・エディタで、グループ・ヘッダーにフォーカスを置いた状態

左/右矢印キーまたは[Enter]または[Space]

グループの展開または縮小

ページ・デザイナで、タブにフォーカスを置いた状態

矢印キー

前/次のタブを選択

スプリッタ・ハンドルにフォーカスを置いた状態

矢印キー

スプリッタの移動

スプリッタ・ハンドルにフォーカスを置いた状態

[Enter]

スプリッタの展開または縮小(スプリッタでサポートされている場合)

スプリッタがあるページ

[Ctrl]+[F6]

次のスプリッタに移動

スプリッタがあるページ

[Ctrl]+[Shift]+[F6]

前のスプリッタに移動

ヘルプ・アイコン(?)のあるフィールドにフォーカスを置いた状態

[Alt]+[F1]

フィールド・ヘルプ・ダイアログを開く

フィールド・ヘルプ・ダイアログにフォーカスを置いた状態

[Alt]+[F6]

ダイアログを閉じずにフォーカスをフィールドに戻す

ダイアログにフォーカスを置いた状態

[Esc]

ダイアログを閉じる

ページで、リージョン表示セレクタ・タブにフォーカスを置いた状態

矢印キー

前/次のタブを選択

SQLコマンド

[Ctrl]+[Enter]

現在のコマンドを実行

コード・エディタ

[Ctrl]+[Z]

元に戻す

コード・エディタ

[Ctrl]+[Shift]+[Z]

やり直し

コード・エディタ

[Ctrl]+[F]

検索

コード・エディタ

[Ctrl]+[Shift]+[F]

置換

コード・エディタで、検索フィールドにフォーカスを置いた状態

上/下矢印

前/次のインスタンスを検索

コード・エディタ

[Ctrl]+[Space]

オートコンプリート(使用可能な場合)

コード・エディタ

[Alt]+[F6]

コード・エディタを離れ、次のタブ・ストップに移動

コード・エディタ

[Alt]+[Shift]+[F6]

コード・エディタを離れ、前のタブ・ストップに移動

索引
A B C D E F G H I J K L M N O P Q R S T U V W X Z

A

ページ受入れ, 2.5.1

アクセス制御リスト

概要, 20.3

ユーザーの追加, 20.3.3.2

作成, 20.3.2

ユーザーの削除, 20.3.3.3

アプリケーション・モードの選択, 20.3.3

ユーザー権限の選択, 20.3.3.2

アクセス制御, 認可スキーム, 20.3.4 アクセシビリティ

概要, E

ハイ・コントラスト・モードについて, E.2

「アクセシビリティ・モード」リスト, E.1.1

キーボードを使用したコンポーネントへのアクセス, E.4

スクリーン・リーダー・モード, E.1

WAI-ARIAサポート, E.3.3.5

「アクセシビリティ・モード」リスト

スクリーン・リーダー, E.1.1

アカウント・メニュー, 1.3.4.4 アカウント・プロファイル

パスワードの変更, 1.4.1

電子メール・アドレスの編集, 1.4.1

名前の編集, 1.4.1

写真のアップロード, 1.4.1

「アクション」メニュー, 10.6.2

集計, 10.6.2

チャート, 10.6.2

計算, 10.6.2

コントロール・ブレーク, 10.6.2

カスタマイズ, 10.4.6

ダウンロード, 10.6.2

フィルタ, 10.6.2

フラッシュバック, 10.6.2

書式, 10.6.2

グループ化, 10.6.2

ヘルプ, 10.6.2

ハイライト, 10.6.2

リセット, 10.6.2

ページごとの行数, 10.6.2

レポートの保存, 10.6.2

列の選択, 10.6.2

ソート, 10.6.2

サブスクリプション, 10.6.2

アクティビティ・ログ, 23.8 アクティビティ・レポート, カスタムの作成, 23.8 「管理」メニュー, 1.3.4.2 「管理」メニュー

管理, 1.3.4.2

パスワードの変更, 1.3.4.2

ダッシュボード, 1.3.4.2

サービスの管理, 1.3.4.2

ユーザーとグループの管理, 1.3.4.2

アクティビティの監視, 1.3.4.2

「フィードバックを許可」属性, 7.5.1.2.2 「この後に作成されるURLの許可」属性, 7.5.2.2.4 AnyCo IT Department

概要, 3.4

インストール, 3.4.1

ナビゲート, 3.4.2

実行, 3.4.1

APEX_ACTIVITY_LOGビュー, 23.8 APEX_MAIL, 19.1.4 APEX_PUBLIC_USER, 23.4 アプリケーション

Webサイトからのコンテンツの追加, 14.7

データ・ロード・ウィザードの追加, 25.1

データ・ロードの追加, 25.1

認可スキームの割当て, 20.5.3.1

認証スキームの変更, 20.4.5, 20.4.6

ブランチを使用したナビゲーションの制御, 16.5

コピー, 4.4.6

作成, 2.1

デバッグ, 22, 23

プライマリ言語の定義, 21.2

削除, 4.4.6

デプロイ, 24.3, 24.4, 24.6.3

エクスポート, 24.4, 24.6.3

グループ化, 7.12

非表示機能, 24.11.4

エクスポート・ファイルのインポート, 24.7

SQL*Plusからのインポート, 24.8.6

言語プリファレンス, 21.1.2

リソース使用, 22.3

翻訳可能なコンポーネント, 21.1.4

翻訳, 21.1

マルチバイト言語の翻訳, 21.2.2

翻訳のレンダリング, 21.1.4

アップグレード, 7.13.1.5.1, 7.13.1.5.2

「アプリケーションの別名」属性, 7.5.1.2.1 アプリケーション属性

ビルド・オプション, 7.5.1.2.7

データベース・セッション, 7.5.2.2.6

編集, 7.5.1

エラー処理, 7.5.1.2.4

エクスポート, 24.6.4

置換, 7.5.1.2.6

アプリケーション・ビルダー

アクセス, 4.1, 4.3

ホームページ, 4.2

ページ, 2.2.1

ユーティリティ, 7.13.1

アプリケーション・ビルダーのホームページ, 4.1, 4.2, 4.3

「作成」ボタン, 4.2.2

移行リンク, 4.2.4

ナビゲーション・バー, 4.2.1

「最近」リスト, 4.2.3

「リセット」ボタン, 4.2.2

アプリケーション・ビルダー・ユーティリティ

アドバイザ, 7.13.1.1

アプリケーション・ダッシュボード, 7.13.1.1

Application Expressビュー, 7.13.1.1

属性ディクショナリ, 7.13.1.1

変更履歴, 7.13.1.1

データベース・オブジェクトの依存性, 7.13.1.1

デバッグ・メッセージ, 7.13.1.1

エクスポート・リポジトリ, 7.13.1.1

最近更新されたページ, 7.13.1.1

アプリケーションのアップグレード, 7.13.1.1

アプリケーションの計算

概要, 17.6.1

作成, 17.6.3

「新しいインスタンス開始時」の実行, 17.5.2, 17.6.2

履歴レポート, 17.6.4

アプリケーション・ダッシュボード, 7.13.1.2 「アプリケーション・ダッシュボード」レポート, 23.3.2 「アプリケーション日付書式」属性, 7.5.3.2.3 「アプリケーションの日時書式」属性, 7.5.3.2.4 アプリケーション定義, 編集, 7.5.1 Application Expressアカウント認証

設定, 20.4.3.1.2

Application Expressビュー, 7.13.1.7 アプリケーション・グループ, 7.12.1 「アプリケーション・グループ」属性, 7.5.1.2.1 アプリケーションのヘルプ, 作成, 12.4 アプリケーションのホームページ

データベース・アプリケーション・ページの追加, 7.6.3

「エクスポート」/「インストール」アイコン, 3.3.3.3, 4.4.2

「アプリケーションの実行」ボタン, 4.4.2

「アプリケーションの実行」アイコン, 3.3.3.3

「共有コンポーネント」アイコン, 3.3.3.3, 4.4.2

アプリケーション・ホームの「タスク」リスト

このアプリケーションのコピー, 4.4.6

このアプリケーションの削除, 4.4.6

アプリケーション・アイテム

概要, 15.1.1, 18.5

作成, 18.5.1

グローバル変数の作成, 18.5.4

属性の編集, 18.5.3

履歴, 18.5.2

アプリケーション言語, 7.5.3 「アプリケーション言語の派生元」属性, 7.5.3.2.2, 21.2 アプリケーション・レイアウト

印刷プレビュー・モード, 14.2

ショートカット, 18.8

「アプリケーションのプライマリ言語」属性, 7.5.3.2.1, 21.2 アプリケーション・プロセス

作成, 17.5.5

エラー・メッセージの作成, 17.5.7

属性の編集, 17.5.6

例, 17.5.4

オンデマンド, 17.5.1

レポート, 17.5.8

理解, 17.5

アプリケーションのタイムスタンプ書式, 7.5.3.2.5 アプリケーションのタイムスタンプ・タイムゾーン書式, 7.5.3.2.6 アプリケーション・ユーティリティ

アクセス, 7.13

アーキテクチャ, 1.1.2 非同期更新

チャート, 12.3.4.4, 12.3.5.4

マップ, 12.2.4.4, 12.2.5.4

属性ディクショナリ, 17.7

概要, 17.7.1

アクセス, 17.7.2

認証, 2.5.3, 20.4

認証スキーム・リポジトリ, 20.4.4

変更, 20.4.5, 20.4.6

認証スキームの作成, 20.4.2

既存のスキームの管理, 20.4.4

事前構成済の認証スキーム, 20.4.3

レポート, 20.4.8

セキュリティ属性, 7.5.2.2.1

理解, 20.4.1, 20.4.1.1

カレント・スキームの表示, 20.4.5

認証レポート

認証スキーム履歴, 20.4.8

認証スキームのサブスクリプション, 20.4.8

「認証スキーム」属性, 7.5.2.2.1 「認証スキーム履歴」レポート, 20.4.8 「認証スキームのサブスクリプション」レポート, 20.4.8 認証スキーム

Application Expressアカウント, 20.4.3.1

Cookieユーザー・アカウント, 20.4.3.1

カスタム認証, 20.4.3.2

DAD資格証明, 20.4.3.6

データベース・アカウント資格証明, 20.4.3.3

HTTPヘッダー変数, 20.4.3.4

LDAPディレクトリの検証, 20.4.3.5

公開資格証明, 20.4.3.7

シングル・サインオン検証, 20.4.3.8

認可, 2.5.4 「認可」属性, 7.5.2.2.2 認可スキーム

アプリケーションへの割当て, 20.5.3.1

コンポーネントへの割当て, 20.5.3.3

コントロールへの割当て, 20.5.3.3

ページへの割当て, 20.5.3.2

コンポーネント別レポート, 20.5.4

履歴レポート, 20.5.4

アプリケーション, 7.5.2.2.2

レポート, 20.5.4

指定, 7.5.2.2.2

サブスクリプション・レポート, 20.5.4

使用率レポート, 20.5.4

「認可スキーム」属性, 7.5.2.2.2 認可スキーム履歴レポート, 20.5.4 認可スキームのサブスクリプション・レポート, 20.5.4 認可スキームの使用率レポート, 20.5.4 認可スキーム, 20.5.1

アプリケーションへの割当て, 20.5.3.1

コンポーネントへの割当て, 20.5.3.3

コントロールへの割当て, 20.5.3.3

ページへの割当て, 20.5.3.2

作成, 20.5.2

アクセス制御, 20.3.4

「自動CSVエンコーディング」属性, 7.5.3.2.10 自動タイムゾーン, 7.5.3.2.9

B

バインド変数

構文, 2.9.4

リージョンでの使用, 2.9.4.2

PL/SQLに基づいたリージョンでの使用, 2.9.4.3

空白ページ

アプリケーションの作成ウィザードでの作成, 7.1.2

フォームでのBLOBサポート

概要, 11.6.1

BLOBの表示, 11.6.3

ファイルのダウンロード, 11.6.2

イメージ参照の削除, 11.6.4

ファイルのアップロード, 11.6.2

レポートでのBLOBサポート

概要, 10.10.1

BLOBの表示, 10.10.3

ダウンロード・リンクの提供, 10.10.2

BLOB

APEX_UTIL.GET_BLOB_FILE_SRC, 10.10.4

ダウンロード・サポート, 11.6.1

移入, 11.6.1

サポート, 10.10

フォームでのサポート, 11.6

手続き的な使用, 10.10.4

「ブックマーク・ハッシュ関数」属性, 7.5.2.2.4 ブランチ

概要, 17.4

作成, 16.5, 16.5.2

ページ送信, 8.3.7

レンダリング前, 8.3.6

「対象ボタン」属性, 2.10.4.32.2

BRANCH_TO_PAGE_ACCEPT, 2.10.4.32.5 ブランチ

条件付きの作成, 16.5.3

ロード時, ヘッダーの前, 16.5.2

送信時, プロセスの後, 16.5.2

送信時, 計算の前, 16.5.2

送信時, プロセス前, 16.5.2

送信時, 検証の前, 16.5.2

ボタンの使用, 15.5.6

ブレッドクラム・レポート, 16.3.7

ブレッドクラムの例外, 16.3.7

ブレッドクラム階層, 16.3.7

ブレッドクラム履歴, 16.3.7

ブレッドクラムの使用状況, 16.3.7

ブレッドクラムのグリッド編集, 16.3.7

ブレッドクラム・テンプレート, 13.3.9

定義, 13.3.9.2.2

名前, 13.3.9.2.1

置換文字列, 13.3.9.2.3

ブレッドクラム・テンプレートの置換文字列

#COMPONENT_CSS_CLASSES#, 13.3.9.2.3

#LINK#, 13.3.9.2.3, 13.3.9.2.3

#LONG_NAME#, 13.3.9.2.3, 13.3.9.2.3

#NAME#, 13.3.9.2.3, 13.3.9.2.3

NAME_ESC_SC#, 13.3.9.2.3, 13.3.9.2.3

ブレッドクラム

概要, 16.3.1

手動作成について, 16.3.3.1

ブレッドクラム・リージョンの追加, 16.3.3.4.1, 16.3.3.4.2

エントリの追加, 16.3.3.3, 16.3.3.3

ページへの追加, 16.3.3.4.1, 16.3.3.4.2

作成, 16.3

共有コンポーネントとしての作成, 16.3.3.2.1

動的の作成, 16.3.3.5, 16.3.3.5

コンポーネント・ビューからの作成, 16.3.3.2.3

ページ・デザイナからの作成, 16.3.3.2.2

未使用の削除, 16.3.6

編集, 16.3.4

例外レポート, 16.3.7

グリッド編集レポート, 16.3.7

階層レポート, 16.3.7

履歴レポート, 16.3.7

ナビゲーション, 13.3.9.1

エントリの親の変更, 16.3.5

使用状況レポート, 16.3.7

「参照」ボタン, A.1 バグ・レポート

バグ・ダッシュボード, 5.7.5.1

日別, 5.7.5.4

日別ページ, 5.7.5.4

開発者別, 5.7.5.3

開発者別ページ, 5.7.5.3

カレンダ・ページ, 5.7.5.2

バグ

ファイルの添付, 5.7.4

バグ・ページ, 5.7.1

作成, 5.7.2

編集, 5.7.3

管理, 5.7

表示, 5.7.1

レポートの表示, 5.7.5

ビルド・オプション, 24.11

ステータスの変更, 24.11.2

作成, 24.11.1

除外, 24.11.2

エクスポート, 24.11.4

ステータスのエクスポート, 24.11.4

包含, 24.11.2

レポート, 24.11.5

「ビルド・オプション」属性, 7.5.1.2.7 「ビルド・ステータス」属性, 7.5.1.2.3 組込み置換文字列, 2.10.4 「アイテム・ヘルプをバルク編集」レポート, 12.4.3 ボタン

ブランチ, 15.5.6

作成, 15.5, 15.5.2.1, 15.5.3.1

一度に複数を作成, 15.5.3.2

複数の削除, 15.5.3.3.4

条件付き表示, 15.5.2.3, 15.5.3.4

編集, 15.5.2.2, 15.5.3.3

複数の編集, 15.5.3.3.3

コンポーネント・ビューでの管理, 15.5.3

ページ・デザイナでの管理, 15.5.2

名前, 15.5.5

テンプレート, 13.3.10

ボタン・テンプレート

定義, 13.3.10.1.2

名前, 13.3.10.1.1

置換文字列, 13.3.10.1.3

ボタン・テンプレートの置換文字列

##ICON_CSS_CLASSES##, 13.3.10.1.3, 13.3.10.1.3

#BUTTON_ATTRIBUTES#, 13.3.10.1.3, 13.3.10.1.3, 13.3.10.1.3, 13.3.10.1.3

#BUTTON_CSS_CLASSES#, 13.3.10.1.3, 13.3.10.1.3

#BUTTON_ID#, 13.3.10.1.3, 13.3.10.1.3

#LABEL#, 13.3.10.1.3, 13.3.10.1.3

#LINK#, 13.3.10.1.3, 13.3.10.1.3

C

「キャッシュ」属性, 7.5.2.2.5

リージョンのキャッシュ, 14.5.2.5, 14.6.3.5

カレンダ

属性へのアクセス, 12.1.4.1, 12.1.5.2.1

カレンダの追加, 12.1.3.1

レガシー・カレンダの追加, 12.1.3.2

作成, 12.1

カレンダの作成, 12.1.5.1

属性の編集, 12.1.4, 12.1.5.2

ドラッグ・アンド・ドロップの有効化, 12.1.7

追加および編集機能を含める, 12.1.4.2, 12.1.5.2.2

コンポーネント・ビューでの管理, 12.1.5

サポートされている置換文字列, 12.1.8

サンプルの表示, 12.1.2

Calendar

新しいページへの追加, 12.1.3.1

カレンダ属性

アクセス, 12.1.4.1, 12.1.5.2.1

カスケード・スタイルシート

概要, 13.3.1

SVGチャートの参照, 12.3.6.3

ページ・テンプレートでの参照, 13.4.2

インラインの参照(SVGチャート) , 12.3.6.4

アップロード, 13.4.1

カスタムの使用, 13.4

中央ペイン, 8.1 「変更履歴」レポート, 7.13.1.3 文字の値の比較, 7.5.3.2.7 文字の値の比較動作, 7.5.3.2.8 グラフ

アプリケーションの作成ウィザードでの作成, 7.1.2

チャートの同期更新

更新動的アクションの作成, 12.3.4.4.2, 12.3.5.4.2

チャート属性の編集, 12.3.4.4.1, 12.3.5.4.1

チャート構文, 12.3.2.1 チャート

Flashについて, 12.3.1.2

ウィザードについて, 12.3.2.1

ページへの追加, 12.3.4.1, 12.3.5.1

新しいページへの追加, 12.3.3

表示の変更, 12.3.4.2, 12.3.5.3

非同期更新, 12.3.4.4, 12.3.5.4

ローソク足構文, 12.3.2.6

チャート構文, 12.3.2.1

作成, 12.3

ダイアル・チャート構文, 12.3.2.2

他の言語でのSVGチャートの表示, 12.3.6.5

属性の編集, 12.3.4.2, 12.3.5.3

非同期更新の有効化, 12.3.4.4.1, 12.3.5.4.1

ガント構文, 12.3.2.7

HTMLチャートのサポート, 12.3.7

HTML5チャートについて, 12.3.1.1

コンポーネント・ビューでの管理, 12.3.5

ページ・デザイナでの管理, 12.3.4

SVGのFlashへの移行, 12.3.6.1.2

情報の監視, 12.3.4.4, 12.3.5.4

複数シリーズ構文, 12.3.2.3

SQL問合せの作成, 12.3.2.1

レンジ構文, 12.3.2.4

散布構文, 12.3.2.5

SQL問合せ構文, 12.3.2

SVGチャートのサポート, 12.3.6

Flashへの切替え, 12.3.4.3, 12.3.5.2

タイプ, 12.3.2.1

1つのSVGチャートのHTML5へのアップグレード, 12.3.6.1.2

すべてのSVGチャートのHTML5へのアップグレード, 12.3.6.1.3

HTML5へのSVGチャートのアップグレード, 12.3.6.1

チェック・ボックス, A.1

依存LOVの作成, 15.3.2.3

クラシック・カレンダ・テンプレート

コメント, 13.3.11.2.3

日次カレンダ, 13.3.11.2.3

月次カレンダ, 13.3.11.2.3

名前, 13.3.11.2.1

テンプレートのサブスクリプション, 13.3.11.2.2

週次カレンダ, 13.3.11.2.3

クラシック・レポート

ダウンロード・リンクの追加, 10.7.5, 10.8.5

ページの作成ウィザードでの追加, 7.6.2, 10.2.2

変更, 10.7, 10.8

位置の変更, 10.7, 10.8

列属性の変更, 10.7, 10.8

列テキストの変更, 10.7, 10.8

ページ区切りの変更, 10.7.3, 10.8.3

列ブレークの制御, 10.7.12, 10.8.12

列の表示の制御, 10.7.11, 10.8.11

作成, 10.2

合計の作成, 10.7, 10.8

更新可能な列の作成, 10.7.9, 10.8.9

LOVとして列を定義, 10.7.10, 10.8.10

属性の編集, 10.7.1, 10.8.1

レポート・レイアウトの編集, 10.7.2, 10.8.2

エクスポート, 10.7.7, 10.8.7

列の非表示, 10.7, 10.8

列のソート, 10.7, 10.8

列の順序とリージョン・ソースの同期化, 10.8.13, 11.2.6

クラシック・レポート・リージョン

出力属性の構成, 10.9.4

出力メソッド, 10.9.3

クラシック・レポート

概要, 10.1.2

PL/SQLコードのクリーンアップ, 7.5.2.2.6 コレクション, 25.2 カラー・ピッカー, A.1 列テンプレート, JavaScriptの使用, 13.3.17.4 「コメント」属性, 9.4.2.15 「互換性モード」属性, 7.5.1.2.2 コンポーネント

認可スキームの割当て, 20.5.3.3

コンポーネント設定

編集, 18.2.1

管理, 18.2

履歴レポートの表示, 18.2.2

コンポーネント・ビュー

「すべて編集」アイコン, 9.3.2.2

ページの実行, 9.5

使用, 9.3.2.1

コンポーネント・ビュー, 9.3.2

ページ制御の追加, 9.3.6

ブランチ, 9.3.4.2

ブレッドクラム, 9.3.5.2

ボタン, 9.3.3.2

作成, ページ・グループ, 9.2.2

計算, 9.3.4.2

ダイアログ属性の構成, 9.4.5

「コピー」アイコン, 9.3.2.3

ページのコピー, 9.7

「作成」アイコン, 9.3.2.3

「作成」メニュー, 9.2.2

作成, 開発者のコメント, 9.2.2

作成, ページ, 9.2.2

作成, コピーとしてのページ, 9.2.2

作成, ページ・コンポーネント, 9.2.2

作成, リージョン, 9.2.2

作成, 共有コンポーネント, 9.2.2

作成, チーム開発, 9.2.2

アプリケーション・ページの削除, 9.8

「すべて編集」アイコン, 9.3.2.2

アイテム, 9.3.3.2

LOV, 9.3.5.2

リスト, 9.3.5.2

リージョン・タイトルを翻訳可能に指定, 21.1.5.4.2

ナビゲーション・バー, 9.3.5.2

「次のページ」ボタン, 9.2.2

ページ, 9.3.3.2

「ページ・デザイナ」ボタン, 9.2.2

ページ・ファインダ, 9.2.2

ページ・プロセス, 9.3.4

ページ・レンダリング, 9.3.3

「前のページ」ボタン, 9.2.2

プロセス, 9.3.4.2

リージョン, 9.3.3.2

実行時開発者ツールバー, 9.6

セキュリティ, 9.3.5.2

タブ, 9.3.5.2

テンプレート, 9.3.5.2

テーマ, 9.3.5.2

使用, 9.3

ユーティリティ, 9.2.2

ユーティリティ, アプリケーション・ユーティリティ, 9.2.2

ユーティリティ, 属性ディクショナリ, 9.2.2

ユーティリティ, キャッシュ, 9.2.2

ユーティリティ, クリーンアップ, 9.2.2

ユーティリティ, クロス・ページ・ユーティリティ, 9.2.2

ユーティリティ, 削除, 9.2.2

ユーティリティ, ページの削除, 9.2.2

ユーティリティ, エクスポート, 9.2.2

ユーティリティ, 履歴, 9.2.2

ユーティリティ, ロック, 9.2.2

ユーティリティ, ページ・イベント, 9.2.2

ユーティリティ, ページ・グループ, 9.2.2

ユーティリティ, コンポーネントの再順序付け, 9.2.2

フィールドレベル・ヘルプの表示, 1.6.5.1

コンポーネント・ビュー・ツールバー

概要, 9.2.1

作成, チーム開発, 9.2.1

ページの編集, 9.2.1

共有コンポーネント, 9.2.1

コンポーネント・ビュー, ページ属性, 9.4

認証, 9.4.2.9, 9.4.2.9

認可スキーム, 9.4.2.9

ブラウザ・キャッシュ, 9.4.2.9, 9.4.2.9

キャッシュ・ページ, 9.4.2.11

キャッシュ・ページ条件, 9.4.2.11

キャッシュ・タイムアウト, 9.4.2.11

コメント, 9.4.2.15

構成, 9.4.2.12

CSS, インライン, 9.4.2.4

カーソル・フォーカス, 9.4.2.2, 9.4.2.2

ディープ・リンク, 9.4.2.9

ダイアログ, 属性, 9.4.2.5

ダイアログ, CSSクラス, 9.4.2.5, 9.4.2.5

ダイアログ, 高さ, 9.4.2.5

ダイアログ, 最大幅, 9.4.2.5

ダイアログ, 幅, 9.4.2.5

表示属性, 9.4.2.2

重複送信, 9.4.2.10

エラー処理, 9.4.2.13

エラー処理ファンクション, 9.4.2.13

式1, 9.4.2.11, 9.4.2.11

ファイルURL, 9.4.2.4

フッター, 9.4.2.6, 9.4.2.7

フォームのオートコンプリート, 9.4.2.9

グループ, 9.4.2.1

ヘッダーおよびフッター, 9.4.2.7

ヘッダー・テキスト, 9.4.2.6, 9.4.2.7

ヘルプ 9.4.2.14

インライン・エラー通知テキスト, 9.4.2.13, 9.4.2.13

JavaScript, ページ・ロード時に実行, 9.4.2.3

JavaScript, ファイルURL, 9.4.2.3

JavaScript, ファンクションおよびグローバル変数の宣言, 9.4.2.3

名前, 9.4.2.1

ページの別名, 9.4.2.1

ページCSSクラス, 9.4.2.2

ページ・モード, 9.4.2.2

ページ・テンプレート・オプション, 9.4.2.2

読取り専用, 9.4.2.8

セッションを再結合, 9.4.2.9

セキュリティ, 9.4.2.9

サーバー・キャッシュ, 9.4.2.11

タイトル, 9.4.2.2

コンポーネント・ビュー, ページ・プロセス

ブランチ, 9.3.4.2

計算, 9.3.4.2

プロセス, 9.3.4.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

コンポーネント・ビュー, 共有コンポーネント

ブレッドクラム, 9.3.5.2

LOV, 9.3.5.2

リスト, 9.3.5.2

ナビゲーション・バー, 9.3.5.2

セキュリティ, 9.3.5.2

タブ, 9.3.5.2

テンプレート, 9.3.5.2

テーマ, 9.3.5.2

コンポーネント

キーボードを使用したアクセス, E.4

アクセス制御, 2.5.4

すべてのページでの表示, 14.3

各ページでの表示, 14.1

メッセージの翻訳, 21.4, 21.4.2, 21.4.3

コンポーネント, 可用性の管理, 20.1.8.3 条件タイプ, 2.5.2.2 条件付き

処理, 2.5.2

レンダリング, 2.5.2

条件

リージョンの表示, 14.6.3.2.1, 14.6.3.2.1

リスト, C.1

使用, 2.5.2

ボタンでの使用, 15.5.2.3, 15.5.3.4

構成, 制御, 24.11 確認ページ

作成について, 11.1.1, 14.6.1

制御, アクセス制御, 2.5.4 アプリケーションの作成ウィザード, 2.1

概要, 7.1.1

列切替えレポートの追加, 7.1.2, 10.2.1

空白ページの追加, 7.1.2

チャートの追加, 7.1.2

フォームの追加, 7.1.2

リスト・ビューとフォームの追加, 7.1.2, 10.2.1

リスト・ビュー・レポートの追加, 7.1.2, 10.2.1

マスター・ディテールの追加, 7.1.2

リフロー・レポートの追加, 7.1.2, 10.2.1

レポートの追加, 7.1.2, 10.2.1

レポートとフォームの追加, 7.1.2, 10.2.1

表形式フォームの追加, 7.1.2

フォームの作成, 11.1.4

レポートの作成, 10.2.4

ページ・オプション, 7.1.2

レポート・オプション, 10.2.1

ブランチの作成ウィザード, 16.5, 16.5.2 ナビゲーション・バー・エントリの作成ウィザード, 12.4.4, 16.4.2.1, 16.4.2.2, 16.4.3 ページ計算の作成ウィザード, 17.1.1, 17.1.3.1, 25.3.10.1 ページ・プロセスの作成ウィザード, 17.3.3.1 ページの作成ウィザード, 7.6.1

カレンダの追加, 7.6.2

チャートの追加, 7.6.2

列切替えレポートの追加, 7.6.2, 10.2.2

ログイン・ページの追加, 7.6.2, 7.6.2

マップの追加, 7.6.2

Webサービスのレポートの追加, 7.6.2, 10.2.2

ツリーの追加, 7.6.2

空白ページの追加, 7.6.2

クラシック・レポートの追加, 7.6.2, 10.2.2

対話モード・レポートの追加, 7.6.2, 10.2.2

リスト・ビューの追加, 7.6.2, 10.2.2

プラグインの追加, 7.6.2

リフロー・レポートの追加, 7.6.2, 10.2.2

ブレッドクラム, 14.6.1

カレンダ, 14.6.1

チャート, 14.6.1

フィードバック・ページの作成, 7.6.2

アクセス制御リストを含むページの作成, 7.6.2

ウィザードの作成, 7.6.2

データ・ロード・ウィザードの作成

データ・ロード・ウィザード, 25.1.1

データ・ロード・ウィザードの作成, 7.6.2 フォームの作成, 11.1.3 レポートの作成, 10.2.5 Webサービスのフォームとレポート, 14.6.1 Webサービスのフォームとレポート, 7.6.2, 11.1.1 プロシージャのフォーム, 7.6.2, 11.1.1 SQL問合せのフォーム, 14.6.1 SQL問合せのフォーム, 7.6.2, 11.1.1 レポート付きの表のフォーム, 7.6.2, 11.1.1 表またはビューのフォーム, 7.6.2, 11.1.1 リスト・ビュー付きの表のフォーム, 7.6.2, 11.1.1 Webサービスのフォーム, 14.6.1 Webサービスのフォーム, 7.6.2, 11.1.1 フォーム・オプション, 11.1.1 リスト, 14.6.1 マップ, 14.6.1 マスター・ディテール・フォーム, 7.6.2, 11.1.1 プラグイン, 14.6.1 レポート・オプション, 10.2.2 サマリー・ページ, 14.6.1 サマリー・ページ, 7.6.2, 11.1.1 表形式フォーム, 7.6.2, 11.1.1 ツリー, 14.6.1 リージョンの作成ウィザード, 12.1.5.1, 12.2.5.1, 12.3.5.1, 14.6.2, 14.6.2, 14.6.3.9.2, 14.6.4, 16.3.3.4.2, 18.7.6

列切替えレポートの追加, 10.2.3

列切替えレポートの追加, 14.6.1

対話モード・レポートの追加, 10.2.3

リフロー・レポートの追加, 10.2.3, 14.6.1

クラシック・レポート, 14.6.1

フォームの作成, 11.1.5

Webサービスのフォームとレポート, 11.1.2

プロシージャのフォーム, 11.1.2, 14.6.1

SQL問合せのフォーム, 11.1.2

レポート付きの表のフォーム, 11.1.2, 14.6.1

表またはビューのフォーム, 11.1.2, 14.6.1

リスト・ビュー付きの表のフォーム, 11.1.2, 14.6.1

Webサービスのフォーム, 11.1.2

フォーム・オプション, 11.1.2

ヘルプ・テキスト, 14.6.1

対話モード・レポート, 14.6.1

リスト・ビュー, 14.6.1

マスター・ディテール・フォーム, 14.6.1

マスター・ディテール・フォーム, 11.1.2

複数の静的コンテンツ, 14.6.1

PL/SQL動的コンテンツ, 14.6.1

リージョン表示セレクタ, 14.6.1

Webサービスの結果のレポート, 14.6.1

レポート・オプション, 10.2.3

静的コンテンツ, 14.6.1

サマリー・ページ, 11.1.2

表形式フォーム, 14.6.1

表形式フォーム, 11.1.2

URL, 14.6.1

レポート・リージョンの作成ウィザード

ページ・デザイナからのアクセス, 10.2.6

検証の作成ウィザード, 17.2.3.1, 17.2.3.2, 17.2.3.3, 17.2.3.4 クロス・ページ・ユーティリティ, 7.13.3

アクセス, 7.13.3.1

すべてのページのグリッド編集, 7.13.3.2, 7.13.3.3, 7.13.3.5, 7.13.3.6

ページ属性, 7.13.3.4

クロスサイト・スクリプティング

概要, 20.2.3.1

安全なアイテム・タイプについて, 20.2.3.2.2

動的出力, 20.2.3.3

値のエスケープ, 20.2.3.2.3

HTMLリージョン, 20.2.3.2

動的出力の保護, 20.2.3.3

フォーム・アイテムの保護, 20.2.3.5

HTMLリージョンの保護, 20.2.3.2.1

レポート・リージョンの保護, 20.2.3.4

静的領域の保護, 20.2.3.2.1

レポート・リージョン, 20.2.3.4

アイテムでの文字の制限, 20.2.3.6

静的表示領域, 20.2.3.2

セッション・ステート保護の理解, 20.2.5

安全なアイテム・タイプの使用, 20.2.3.2.4

CSSクラス, SVGチャート, 12.3.6.2 CSSファインダ, 7.7 カスタム認証

設定, 20.4.3.2.2

カスタム・パッケージ・アプリケーション

概要, 24.5.1

サポートするオブジェクト・ページの概要, 24.5.2.2

アクセス制御リストの追加, 24.5.3

ビルド・オプション, 24.5.2.2.1

サポートするオブジェクトの作成, 24.5.2

アップグレード・スクリプトの定義, 24.5.6.1

削除スクリプト, 24.5.2.2.3

削除, 24.5.7

インストール・オプションの削除, 24.5.5

メッセージの削除, 24.5.5

サポートするオブジェクトのスクリプトの削除, 24.5.5

作成方法, 24.5

インストール・スクリプト, 24.5.2.2.1

サポートするオブジェクトのインストール, 24.5.4

メッセージ, 24.5.2.2.1, 24.5.2.2.3

前提条件, 24.5.2.2.1

置換文字列, 24.5.2.2.1

インストール・スクリプトのテスト, 24.5.4

アップグレード・メッセージ, 24.5.2.2.2

アップグレード・スクリプト, 24.5.2.2.2

アップグレード, 24.5.6.2

検証, 24.5.2.2.1

インストール・サマリーの表示, 24.5.8

D

DAD資格証明の検証

設定,20.4.3.6.2

データ・ロード・ウィザード

作成について, 25.1.1

作成されたページについて, 25.1.1

アプリケーションへの追加, 25.1

作成, 25.1.2

ページの作成ウィザードでの作成, 25.1.1

データ・ロード定義, 25.1.1

ページの再作成, 25.1.3

データ・ローディング,

追加, 25.1

データベース・アカウント資格証明認証

設定, 20.4.3.3.2

データベース・アプリケーション

概要, 2.1.2.1

ページの追加, 7.6

コンポーネントの追加, 7.6.1

ページの追加, 7.6.1

グループへの割当て, 7.12.3

問合せに基づく, 7.2.1

スプレッドシートに基づく, 7.2.2

コピー, 7.2.3

アプリケーション・ホームページからのコピー, 7.2.3.2

アプリケーションの作成ウィザードでのコピー, 7.2.3.1

グループの作成, 7.12.2

表での作成, 7.2.1

削除, 7.4

グループ, 7.12.1

グループからの削除, 7.12.4

実行, 2.4

データベース・アプリケーション・グループ

ページの割当て, 7.12.3

作成, 7.12.2

削除, 7.12.5

ページの削除, 7.12.4

データベース・アプリケーション・ページ, 9.8

追加, 7.6

グループへの割当て, 7.8.4

コンポーネント・ビューでのコピー, 9.7

ページ・デザイナでのコピー, 8.7

アプリケーションのホームからの作成, 7.6.3

削除, 8.8

範囲の削除, 9.8.4

コンポーネント・ビューでの削除, 9.8.1, 9.8.2

ページ・デザイナでの削除, 8.8.1

複数の削除, 8.8.2, 9.8.3

範囲の削除, 8.8.3

ロック・ステータスの判別, 7.9.1

グループ化, 7.8

ロック, 7.9, 7.9.2

管理, 7.6

競合の回避, 7.9

グループからの削除, 7.8.5

実行, 2.4

ロック解除, 7.9, 7.9.3

データベース・アプリケーション・ページ・グループ, 7.8.2

ページの割当て, 7.8.4

作成, 7.8.2

グループ定義の編集, 7.8.3

削除, 7.8.6

ページの削除, 7.8.5

表示, 7.8.1

データベース・リンク, 25.4

概要, 25.4.1

作成, 25.4.2

既存のデータベース・リンクの表示, 25.4.3

「データベース・オブジェクトの依存性」レポート, 7.13.1.6 「データベース・セッション」属性, 7.5.2.2.6 データベース・ユーザー

付与される権限, D.1

権限の付与, D.1

日付ピッカー, A.1 日付ピッカー(クラシック), A.1 DBMS_APPLICATION_INFO, 22.3 デバッグ, 22, 23

エラーのチェック, 22.1

有効化および無効化, 22.5.2

問題の特定, 22.6

アプリケーションでの実行, 22.5.3

SQL問合せ, 23.2.3

SQLトレース, 22.4

デバッグ・モードの使用, 22.5

f?pを使用したアクセス, 22.5.5

実行時のレポート表示, 22.5.6

コンポーネント・ビューからのレポート表示, 22.5.7

開発モードでのレポート表示, 22.5.4

「デバッグ」属性, 7.5.1.2.2 ディープ・リンク, 20.4.1.2 「ディープ・リンク」属性, 7.5.2.2.3 認可スキームの定義, 7.5.2.2.2 定義, 25.3.2.2 エクスポート・ファイルの削除, 24.8.5 デモンストレーション・アプリケーション

サンプル・データベース・アプリケーションについて, 3.3

デプロイ, 24.4

サポートするオブジェクトの作成, 24.5.2

ページのエクスポート, 24.6.6

Webシートのエクスポート, 24.6.7

アプリケーション定義のエクスポート, 24.6.3

フィードバックのエクスポート, 24.6.12

スクリプト・ファイルのエクスポート, 24.6.13

静的ファイルのエクスポート, 24.6.8

テーマのエクスポート, 24.6.9, 24.6.10

「ユーザー・インタフェースのデフォルト値」のエクスポート, 24.6.11

ワークスペースのエクスポート, 24.6.5

SQL*Plusからのアプリケーションのインポート, 24.8.6

エクスポート・ファイルのインポート, 24.7

ファイルのインポート, 24.7

アプリケーション・エクスポートのインストール, 24.8.3

ファイルのインストール, 24.8.4

データベース・オブジェクトの管理, 24.4.1

アプリケーション, 24.3

オプション, 24.3.2

URLの公開, 24.9

Webシート・アプリケーションURLの公開, 24.10

プロセスの理解, 24.3

開発者コメント

ページ・デザイナでの追加, 7.10

アプリケーションへの追加, 7.10.2

アプリケーションへの追加, 7.10.2

削除, 7.10.4

編集, 7.10.3

表示, 7.10.3

レポートの表示, 7.10.5

開発者コメントのカレンダ, 7.10.6 開発者ナビゲーション・ツール

概要, 1.3.4

アカウント・メニュー, 1.3.4.4

「管理」メニュー, 1.3.4.2

グローバル検索, 1.3.4.1

「ヘルプ」メニュー, 1.3.4.3

開発者ツールバー

アプリケーション, 3.3.3.2, 8.6, 9.6

デバッグ, 3.3.3.2, 8.6, 9.6

開発者ツールバー・オプション, 3.3.3.2, 8.6, 9.6

ページの編集, 3.3.3.2, 8.6, 9.6

ホーム, 3.3.3.2, 8.6, 9.6

クイック編集, 3.3.3.2, 8.6, 9.6

セッション, 2.6.4, 3.3.3.2, 8.6, 9.6

グリッドの表示, 3.3.3.2, 8.6, 9.6

テーマ・ローラー, 3.3.3.2, 8.6, 9.6

デバッグの表示, 3.3.3.2, 8.6, 9.6

開発者ツールバー・オプション

自動非表示, 3.3.3.2, 8.6, 9.6

表示位置, 3.3.3.2, 8.6, 9.6

アイコンのみの表示, 3.3.3.2, 8.6, 9.6

開発プロセス

管理, 5

開発プロセス, 管理, 5 ダイアル・チャート構文, 12.3.2.2 ダイアログ・ボックス

属性の構成, 9.4.5

ページ・デザイナでの属性の構成, 8.4.5

ダイアログ・ページ・テンプレート, 7.6.4.2.1 ダイアログ・ページ・テンプレート属性, 13.3.14.2 ダイアログ・ページ, 7.6.4

サポート対象について, 7.6.4.1

ブランチ, 7.6.4.7

ダイアログ・ページ・テンプレートの作成, 7.6.4.2.1

定義, 7.6.4.3, 7.6.4.4

取消動的アクションの生成, 7.6.4.5

「ダイアログを閉じる」ページ・プロセスの生成, 7.6.4.6

リフレッシュ・アクションの処理, 7.6.4.8

モーダル・ダイアログ, 7.6.4.1

非モーダル・ダイアログ, 7.6.4.1

必須のテンプレート属性, 13.3.14.2

ダイアログ・ページ・テンプレートの使用, 7.6.4.2

DML

ロックについて, 25.5

APEX_DML_LOCK_WAIT_TIME, 25.5.2

FSP_DML_LOCK_ROW, 25.5.3

ドキュメント

概要, 1.6.1

アクセス, 1.6

ダウンロードしたライブラリの検索, 1.6.4

ドキュメント

ダウンロード, 1.6.3

動的アクション

アクションの追加, 15.4.5.3

作成, 15.4.4.1, 15.4.5.1

デバッグ, 15.4.7

削除, 15.4.4.4

編集, 15.4.4.2, 15.4.5.2

頻度と有効範囲, 15.4.4.3, 15.4.5.4

管理, 15.4

コンポーネント・ビューでの管理, 15.4.5

ページ・デザイナでの管理, 15.4.4

理解, 15.4.1

動的リスト

作成について, 18.7.4

最初から作成, 18.7.4.3

構文, 18.7.4.2

動的翻訳, 21.5

E

「すべて編集」アイコン, 9.3.2.2

アプリケーション定義の編集

フィードバックを許可, 7.5.1.2.2

アプリケーションの別名, 7.5.1.2.1

アプリケーション・グループ, 7.5.1.2.1

ビルド・ステータス, 7.5.1.2.3

互換性モード, 7.5.1.2.2

デバッグ, 7.5.1.2.2

電子メール送信者アドレス, 7.5.1.2.2

エラー処理, デフォルトのエラー表示位置, 7.5.1.2.4

エラー処理, エラー処理ファンクション, 7.5.1.2.4

グローバル通知, 7.5.1.2.5

ロギング, 7.5.1.2.2

使用できないアプリケーションに対するメッセージ, 7.5.1.2.3

「名前」属性, 7.5.1.2.1

プロキシ・サーバー, 7.5.1.2.2

アクセスの制限, 7.5.1.2.3

ステータス, 7.5.1.2.3

バージョン, 7.5.1.2.1

アプリケーション定義の編集ページ

概要, 7.5.1.2

アクセス, 7.5.1.1

アプリケーションの編集・ページ

データベース・セッション, 7.5.2.2.6

グローバリゼーション属性の編集, 7.5.3

アプリケーション日付書式, 7.5.3.2.3

アプリケーションの日時書式, 7.5.3.2.4

アプリケーション言語の導出元, 7.5.3.2.2

アプリケーションのプライマリ言語, 7.5.3.2.1

アプリケーションのタイムスタンプ書式, 7.5.3.2.5

アプリケーションのタイムスタンプ・タイムゾーン書式, 7.5.3.2.6

自動CSVエンコーディング, 7.5.3.2.10

自動タイムゾーン, 7.5.3.2.9

文字の値の比較, 7.5.3.2.7

文字の値の比較動作, 7.5.3.2.8

自動CSVエンコーディング, 7.5.2

アクセス, 7.5.2.1

認証, 7.5.2.2.1

認可, 7.5.2.2.2

セッション管理, 7.5.2.2.3

セッション・ステート保護, 7.5.2.2.4

電子メール

インスタンスの構成, 19.1.1.2

電子メール・ログ, 19.1

電子メール・キュー, 19.1

有効化, 20.1.6.2

管理, 19.1

送信の問題, 20.1.11

APEX_MAILパッケージでの送信, 19.1.4

「電子メール送信者アドレス」属性, 7.5.1.2.2 「フレームへの埋込み」属性, 7.5.2.2.5 埋込みPL/SQLゲートウェイ

セキュリティの実行, 20.1.4

エンジン, 1.1.2 環境, 構成, 1.2.3 エラー・メッセージ

ページ・プロセス用の作成, 17.3.2.4, 17.3.3.4

アプリケーション・プロセス用の作成, 17.5.7

エラー, 処理, 7.5.1.2.4, 9.4.2.13 「ブックマークの無効化」属性, 7.5.2.2.4 エクスポート

アプリケーション, 24.6.3

アプリケーション属性, 24.6.4

ビルド・オプション・ステータス, 24.6.4

データベース・アプリケーション, 24.6

データベース・アプリケーション・コンポーネント, 24.6

フィードバック, 24.6.12

データベース・オブジェクトの管理, 24.4.1

ページ, 24.6.6

ページ・コンポーネント, 24.6.4

プラグイン, 24.6.10

スクリプト・ファイル, 24.6.13

共有コンポーネント, 24.6.4

静的ファイル, 24.6.8

翻訳用テキスト, 21.3.2

テーマ, 24.6.9, 24.6.10

ユーザー・インタフェースのデフォルト値, 24.6.11

Webシート, 24.6.7

ワークスペース, 24.6.5

エクスポート・リポジトリ, 24.8.3, 24.8.4, 24.8.5

アクセス, 24.8.2

エクスポートしたアプリケーション, インポート, 24.7 「エクスポート」/「インストール」アイコン, 3.3.3.3, 4.4.2

F

f?p構文, 2.7.2

機能レポート

カレンダ・ページ, 5.4.6.2

変更履歴, 5.4.6.3

機能ユーティリティ, 5.4.6.7

フォーカス領域, 5.4.6.5

所有者, 5.4.6.6

進捗ログ, 5.4.6.4

ツリー・ページ, 5.4.6.1

機能ユーティリティ

マイルストンの割当て, 5.9.4

期日を超過した機能のマイルストンの変更, 5.9.4

マイルストン日付への機能の期日の設定, 5.9.4

機能ユーティリティ

オープンな機能の期限のプッシュ, 5.9.4

機能

ファイルの添付, 5.4.5

作成, 5.4.2

追跡, 5.4

更新, 5.4.4

表示, 5.4.1

レポートの表示, 5.4.6

フィードバック

ページの追加, 5.8.2

フィードバック・ページ, 5.8.1

コメントの確認, 5.8.4

使用, 5.8.3

表示, 5.8.1

レポートの表示, 5.8.5

フィードバック・レポート

カレンダ, 5.8.5.1

タグ・クラウド, 5.3

フィールドレベル・ヘルプ, 1.6.5

コンポーネント・ビューでの表示, 1.6.5.1

ページ・デザイナでの表示, 1.6.5.2

ファイル・アップロード表

セキュリティ・リスク, 20.2.6

「検索」アイコン, 7.7, 7.7.2, 9.2.1 Flashチャート

新しいページへの追加, 12.3.3

ローソク足構文, 12.3.2.6

ガント構文, 12.3.2.7

複数シリーズ構文, 12.3.2.3

レンジ構文, 12.3.2.4

ローカルへの保存, 12.3.8

散布構文, 12.3.2.5

カスタムXMLの使用, 12.3.9

フォーカス領域

編集, 5.9.5

フッター, 置換文字列, 14.5.2.3, 14.6.3.3 フォーム

アプリケーションの作成ウィザードでの作成, 7.1.2

フォーム

JAWSを使用したアクセス, E.3

行の自動処理(DML)プロセス, 11.4.2.1

マスター・ディテールの作成, 11.3

表形式フォームの作成, 11.2

手動作成, 11.4

ページの作成ウィザードを使用した作成, 11.1.3

アプリケーションの作成ウィザードでの作成, 11.1.4

リージョンの作成ウィザードでの作成, 11.1.5

移入, 11.4.3

プロセスの理解, 11.4.2

入力の検証, 11.5

完全開発環境, 1.1.3 ファンクション, 検索, 7.7.7

G

ギャラリ

概要, 8.2.5

使用, 8.3.3, 8.3.4, 8.3.5

「グローバル通知」属性, 7.5.1.2.5 グローバル・ページ, 14.3

作成, 14.3.1

ナビゲート, 14.3.2

グローバル・テンプレート・オプション・グループ, 13.3.6.1

作成, 13.3.6.1.1

編集, 13.3.6.1.2

グローバル・テンプレート・オプション

作成, 13.3.6.3.1

編集, 13.3.6.3.2

管理, 13.3.6.2

グローバル・テンプレート, 13.1.7.2.8 グローバル変数, 作成, 18.5.4 グローバル化

属性, 21.2

アプリケーション言語の判別, 7.5.3

書式マスク, 21.2.1

理解, 21.1

グラフィック

管理, 14.8

グループ

アプリケーション, 7.12

データベース・アプリケーション・ページ, 7.8

H

ヘルプ

アクセス, 1.6

作成, 12.4

ナビゲーション・バー・エントリの作成, 12.4.4

編集, 12.4.3

検索, 1.6

使用, 1.6

「ヘルプ」メニュー, 1.3.4.3 ヘルプ・テキスト

JAWSを使用したアクセス, E.3.2

アイテム用に定義, 12.4.2.4

ページ用に定義, 12.4.2.3

バルク編集, 12.4.3

アイテムの編集, 12.4.3

アイテム・ラベルの検索, 12.4.3.4

トピックの検索, 12.4.3.3

シード, 12.4.3.2

非表示アイテム, A.1 ハイ・コントラスト・モード, E.2

概要, E.2.2, E.2.3

APIでの制御, E.2.2.1

f?p構文を使用した制御, E.2.2.1

置換文字列での制御, E.2.2.1

有効化, E.2.1

拡張, E.2.2.2

プロビジョニング, E.2.2.1

HTML

カスタムPL/SQLを使用した生成, 14.9

Application Expressの処理対象外, 14.9

HTMLチャート

すべてのHTMLチャートのHTML5へのアップグレード, 12.3.7.2

HTML5へのアップグレード, 12.3.7.1

「HTMLエスケープ・モード」属性, 7.5.2.2.5 HTMLパスワード・フォーム要素, A.1 HTMLテキスト領域, A.1 HTML5チャート

概要, 12.3.1.1

新しいページへの追加, 12.3.3

複数シリーズ構文, 12.3.2.3

Flashチャートへの切替え, 12.3.4.3, 12.3.5.2

カスタムXMLの使用, 12.3.9

HTTPヘッダー変数認証

設定,20.4.3.4.2

「HTTPレスポンス・ヘッダー」属性, 7.5.2.2.5

I

イメージ・ファインダ, 7.7

「イメージ接頭辞」属性, 7.5.4.2.1

イメージ・リポジトリ, 14.8

イメージ, URLからの表示, A.1

イメージ

管理, 14.8

検索, 7.7.8

使用可能の表示, 7.7.8

イメージ・ファインダ, 7.7.8 実装

プラグイン, 19.2

インポート

フィードバック, 24.7.7

Webシート, 24.7.3

インポート

アプリケーション, 24.7.1

SQL*Plusを使用するアプリケーション, 24.8.6

エクスポート・ファイル, 24.7, 24.7

ページ, 24.7.1

プラグイン, 24.7.4

テーマ, 24.7.5

ユーザー・インタフェースのデフォルト値, 24.7.6

初期化PL/SQLコード, 7.5.2.2.6 インジェクション攻撃, アイテムでの文字の制限, 20.2.3.6 インストール

アプリケーション・ファイル, 24.8.3

エクスポート・ファイル, 24.8.4

アプリケーション・エクスポートのインストール, 24.8.3 エクスポート・ファイルのインストール, 24.8.4 インスタンス・プロキシ, 指定, 20.1.5.4 インスタンスの設定

構成, 20.1.6

電子メールの構成, 19.1.1.2

対話モード・レポート・フィルタ, 10.6.3

編集, 10.6.3

有効化と無効化, 10.6.3

削除, 10.6.3

詳細の表示および非表示, 10.6.3

対話モード・レポート・メッセージ, 翻訳, 21.4.3.4 対話モード・レポート・リージョン

出力属性の構成, 10.9.5

対話モード・レポート

概要, 10.1.1

リンク列について, 10.4.7, 10.5.6

検索バーについて, 10.6.1

「アクション」メニュー, 10.6.2

ダウンロード・オプションの追加, 10.4.6.3, 10.5.5.4

詳細属性, 10.4.14, 10.5.13

属性ページ, 10.5.1.1

ページ区切りの変更, 10.4.4, 10.5.4

列属性, 10.4.2, 10.5.2

作成, 10.2

列リンクの作成, 10.4.8, 10.5.7

グループの作成, 10.5.3

ページの作成ウィザードでの作成, 7.6.2, 10.2.2

リージョンの作成ウィザードでの作成, 10.2.3, 14.6.1

「アクション」メニューのカスタマイズ, 10.4.6

LOVとして列を定義, 10.4.10, 10.5.9

開発者として削除, 10.5.16.2

プライベート・レポートの削除, 10.6.4.6

パブリック・レポートの削除, 10.6.4.6

条件付き表示, 10.4.9, 10.5.8

開発者としての編集, 10.4, 10.5

電子メール送信者アドレス, 10.4.14.1, 10.5.13.1

アイコン・ビューの有効化, 10.4.11, 10.5.11

エクスポート, 10.4.6.3, 10.5.5.4

列の書式設定, 10.4.12, 10.5.10

無効なリンクの例, 10.4.15.6, 10.5.14.6

リンクの制限, 10.4.15.4, 10.5.14.4

リンクの設定, 10.4.15, 10.5.14

キャッシュのクリア構文を使用したリンク, 10.4.15.3, 10.5.14.3

名前および値の構文を使用したリンク, 10.4.15.2, 10.5.14.2

Request構文を使用したリンク, 10.4.15.1, 10.5.14.1

開発者として管理, 10.5.16

保存済レポートの管理, 7.13.5

サブスクリプションの管理, 7.13.5

行カウント最大値, 10.4.14.1

翻訳が必要なメッセージ, 21.4.3.4

リージョン別名, 10.4.14.1, 10.5.13.1

プライベート・レポートの名前変更, 10.6.4.5

パブリック・レポートの名前変更, 10.6.4.5

レポート属性, 10.4.3

レポートIDアイテム, 10.4.14.1, 10.5.13.1

保存, 10.6.4

代替の保存, 10.6.4.4

プライベートとして保存, 10.6.4.3

パブリックとして保存, 10.6.4.3

プライマリ・デフォルトの保存, 10.6.4.4

ユーザーの保存オプション, 10.6.4.1

使用, 10.6

フィルタの使用, 10.6.3

有効なリンクの例, 10.4.15.5, 10.5.14.5

開発者として表示, 10.5.16.2

保存済のレポートのアクティビティの表示, 10.5.17

内部メッセージ, 翻訳が必要, 21.4.3.3 IPアドレス, アクセスの制限, 20.1.5.3 ワークスペースの分離, 概要, 20.1.5.8 アイテム

ネーミング規則, 15.1.2

値の参照, 15.1.3

検索, 7.7.3

翻訳時に書式マスクを使用, 21.2.1

アイテム・ファインダ, 7.7, 7.7.3 アイテム・ヘルプ

編集, 12.4.3

表示, 1.6.5

アイテム・タイプ

チェック・ボックス, A.1

カラー・ピッカー, A.1

日付ピッカー, A.1

日付ピッカー(クラシック), A.1

イメージの表示, A.1

表示のみ, A.1

ファイル参照, A.1

非表示, A.1

リスト・マネージャ, A.1

数値フィールド, A.1

パスワード, A.1

ポップアップLOV, A.1

ラジオ, A.1

リッチ・テキスト・エディタ, A.1

選択リスト, A.1

シャトル, A.1

スライダ, A.1

テキスト領域, A.1

J

JavaScript, 13.3.14.1.11, 13.3.14.1.11

コンポーネント・ビューを使用した追加, 9.4.3

ページ・デザイナを使用した追加, 8.4.3

ボタンからのコール, 15.5.4

行テンプレート内, 13.3.17.4

.jsファイルに追加, 13.3.2

ページ・テンプレートに追加, 13.3.2

組込み, 15.7

ライブラリ, 13.3.14.1.11

アイテムの参照, 15.1.4

jQueryライブラリの参照, 19.3.3

アイテムへのフォーカスの設定, 9.4.2.2

動的アクションの使用, 15.4.6

プラグインでの使用, 19.3.3.2

jQueryの使用, 19.3.3.1

JavaScriptファインダ, 7.7 JAWS, E

検証エラーについて, E.3.3

フォームへのアクセス, E.3

ヘルプ・テキストへのアクセス, E.3.2

jQuery

サポート, 19.3

JavaScriptでの使用, 19.3.3.1

jQuery Mobile, 7.3.1

サポート, 7.3.1

jQuery UI

他のjQuery UIコンポーネントへのアクセス, 19.3.2.1

使用可能な機能, 19.3.2

サポート, 19.3

jsTree, サポート, 15.6.2

K

キーボード・ショートカット, E.4.3

L

ラベル・テンプレート

#CURRENT_ITEM_HELP_TEXT#, 13.3.12.2

ページ・アイテム・ヘルプの作成, 13.3.12.2

定義, 13.3.12.1.2

編集, 13.3.12

エラー表示, 13.3.12.1.3

フィールド・コンテナ, 13.3.12.1.4

名前, 13.3.12.1.1

置換文字列, 13.3.12.1.5

言語

アプリケーション用の定義, 21.2

マルチバイト, 21.2.2

プリファレンス, 21.1.2

レイアウト

リージョン属性について, 14.6.3.2

制御, 13

LDAPディレクトリの検証

設定, 20.4.3.5.2

レガシー・カレンダ

新しいページへの追加, 12.1.3.2

レガシー・カレンダ・テンプレート, 13.3.11 制限事項

クラシック・レポート, B.1

フォーム, B.1

対話モード・レポート, B.1

アイテム名, B.1

表形式フォーム, B.1

検証, B.1, B.1

リンク列

概要, 10.4.7, 10.5.6

除外, 10.4.7.4, 10.5.6.4

単一行ビューのリンク, 10.4.7.1, 10.5.6.1

ページへのリンク, 10.4.7.2, 10.5.6.2

URLへのリンク, 10.4.7.3, 10.5.6.3

リンク

ディープ, 20.4.1.2

リスト

作成について, 18.7, 18.7.1

動的について, 18.7.4

静的について, 18.7.3

ページへの追加, 18.7.6

「条件付きエントリ」レポート, 18.7.8

コピー, 18.7.5

アプリケーション間のコピー, 18.7.5.2

カレント・アプリケーションからのコピー, 18.7.5.1

階層の作成, 13.3.13.1

編集, 18.7.7

属性の編集, 18.7.7

「履歴」レポート, 18.7.8

リスト・ページ, 18.7.7

レポート, 18.7.8

タイプ, 18.7.1

「未使用」レポート, 18.7.8

「使用状況」レポート, 18.7.8

リスト・マネージャ, 依存LOVの作成, 15.3.2.3 LOV, 15.3.2.3

静的LOVのバルク編集, 18.6.4.2

「条件付きエントリ」レポート, 18.6.6

作成, 18.6

アプリケーション・レベルでの作成, 18.6.2

「NULLテキストの編集」レポート, 18.6.6

編集, 18.6.4

「グリッド編集」レポート, 18.6.6

「履歴」レポート, 18.6.6

「ローカルに定義」レポート, 18.6.6

名前付き, 18.6.2

セッション・ステートの参照, 18.6.5

レポート, 18.6.6

共有, 18.6.2

静的, 18.6.3

「サブスクリプション」レポート, 18.6.6

翻訳, 21.5

「使用状況」レポート, 18.6.6

リスト・レポート

条件付きエントリ, 18.7.8

履歴, 18.7.8

未使用, 18.7.8

使用状況, 18.7.8

リスト・テンプレート

リスト後のエントリ, 13.3.13.2.8

サブリスト後のエントリ, 13.3.13.2.7

リスト前のエントリ, 13.3.13.2.2

サブリスト前のエントリ, 13.3.13.2.5

編集, 13.3.13

名前, 13.3.13.2.1

サブリスト・エントリ, 13.3.13.2.6

置換文字列, 13.3.13.2.9, 13.3.14.1.11

テンプレート定義, 13.3.13.2.3

最初のエントリのテンプレート定義, 13.3.13.2.4

リスト・ビュー

ページの作成ウィザードでの追加, 7.6.2, 10.2.2

リージョンの作成ウィザードでの追加, 14.6.1

リスト・ビューとフォーム

アプリケーションの作成ウィザードでの作成, 7.1.2, 10.2.1

リスト・ビュー・レポート

アプリケーションの作成ウィザードでの作成, 7.1.2, 10.2.1

用語のリスト, A.1 リスト・ページ, 18.7.7 リスト・ウィザード, 18.7.3.1, 18.7.4.1 ロック

ロック・ステータスの判別, 7.9.1

データベース・アプリケーション・ページ用, 7.9

「ロギング」属性, 7.5.1.2.2 ログイン制御, 作成, 20.1.5.1 ログイン資格証明

ワークスペース名のリカバリ, 1.2.4.4

ログイン・ページ

作成, 20.4.7

ロゴ

定義, 7.5.4.3

「ロゴ」属性, 7.5.4.2.2 ログ

管理, 23.3.1

パフォーマンス,23.3

M

「セッション・ステート保護の管理」属性, 7.5.2.2.4

マップ

マップ・チャートのサポートについて, 12.2.1

ウィザードについて, 12.2.2

ページへの追加, 12.2.4.1, 12.2.5.1

新しいページへの追加, 12.2.3

作成, 12.2

SQL問合せの作成, 12.2.2

マップ属性の編集, 12.2.4.2, 12.2.5.2

非同期更新の有効化, 12.2.5.4

自動更新の有効化(ページ・デザイナ), 12.2.4.4

コンポーネント・ビューでの管理, 12.2.5

ページ・デザイナでの管理, 12.2.4

SQL問合せの作成, 12.2.2

カスタムXMLの使用, 12.2.4.3, 12.2.5.3

マスター・アプリケーション, 作成, 13.2.7 マスター・ディテール

アプリケーションの作成ウィザードでの作成, 7.1.2

マスター・ディテール・フォーム, 作成, 11.3 「最大セッション・アイドル時間」属性, 7.5.2.2.3 「最大セッションの長さ」属性, 7.5.2.2.3 メニュー, 1.3.4.1, 1.3.4.4 使用できないアプリケーションに対するメッセージ, 7.5.1.2.3 メッセージ

翻訳用に作成, 21.4.3.1

テキスト・メッセージの編集, 21.4.3.2

PL/SQLプロシージャ, 21.4.2

レポート

翻訳, 21.4.3

翻訳, 21.4, 21.4.2 内部の翻訳, 21.4.3 レポートでのメッセージ, 21.4.3 翻訳が必要なメッセージ

対話モード・レポート, 21.4.3.4

内部, 21.4.3.3

マイルストン・レポート

「所有者別」レポート, 5.5.4.2

「マイルストン別の機能」レポート, 5.5.4.3

マイルストン・カレンダ, 5.5.4.1

マイルストン

作成, 5.5.2

追跡, 5.5

更新, 5.5.3

表示, 5.5.1

レポートの表示, 5.5.4

モバイル・アプリケーション, 7.3, 7.3.1

設計について, 2.3.2

jQuery Mobile, 7.3.1

モバイル・デザイン, 2.3.3

レスポンシブ・デザイン, 2.3.3

モバイル・テーマ - 51, 13.1.2 アクティビティの監視

カレンダ・レポート, 23.3.4

開発者アクティビティ, 23.3.4

環境レポート, 23.3.4

ログイン試行回数, 23.3.4

ログ, 23.3.4

ページ・ビュー, 23.3.4

サービス・リクエスト, 23.3.4

ワークスペースのパージ, 23.3.4

複数選択リスト・アイテム, 15.1.5

戻り値の処理, 15.1.5.1

APEX_UTIL.STRING_TO_TABLEの使用, 15.1.5.2

N

ナビゲーション

ブランチ, 16.5

ブレッドクラム, 16.3

リスト, 18.7

親タブ, 16.2

標準タブ, 16.2

タブ, 16.2

ナビゲーション・バー, 16.4 ナビゲーション・バー・エントリ, 16.4

概要, 16.4.1

コピー, 16.4.3

作成, 16.4.2

フィードバック用に作成, 16.4.2.2

最初から作成, 16.4.2.1

編集, 16.4.4

複数の編集, 16.4.5

履歴レポート, 16.4.6

レポート, 16.4.6

サブスクリプション・レポート, 16.4.6

ナビゲーション・バー・エントリ・レポート

履歴, 16.4.6

サブスクリプション, 16.4.6

ニュース・エントリ, 1.3.3

追加, 5.9.8

削除, 5.9.8

編集, 5.9.8

数値フィールド, A.1 NVファンクション, 2.9.1

O

オンライン・ヘルプ, 1.6

問題, 20.1.11

検索, 1.6

公開資格証明

設定, 20.4.3.7.2

Oracle Application Express

概要, 1.1, 1.1.1

アーキテクチャ, 1.1.2

ブラウザ要件, 1.2.1

コンポーネントの制限, B.1

環境の構成, 1.2.3

キーボード・ショートカット, E.4.3

サインイン, 1.2

開発者としてのサインイン, 1.2.4

ユーザー・ロール, 1.2.2, 20.1.1

Oracle Application Express管理者, 1.2.2, 20.1.1 Oracle Application Expressアドバイザ

概要, 22.1.1

アプリケーションの整合性のチェック, 22.1

ページ上での実行, 22.1.3

アプリケーションでの実行, 22.1.2

Oracle Application Expressエンジン, 1.1.2 Oracle BI Publisher, 統合, 20.1.9 Oracle Help Center

検索, 1.6.1, 1.6.2

Oracle HTTP Server

セキュリティについて, 20.1.3

Oracle XML DB Protocol Server, HTTPサーバー・ポートの検証, 1.2.4.2.1 出力のエスケープ

置換文字列, 2.10.2, 13.3.3

P

パッケージ・アプリケーション

概要, 3.2.2

認証の変更, 3.2.6

インストール, 3.2.3, 3.2.4

管理, 3.2

生産性アプリケーション, 3.1

削除, 3.2.5

サンプル・アプリケーション, 3.1

更新, 3.2.8

パッケージ・アプリケーション

概要, 3.2.1

パッケージ・アプリケーション・ページ, 3.2.1, 3.2.2, 3.2.4, 3.2.5, 3.2.6, 3.2.7

アクセス, 3.2.1, 3.2.2

「パッケージ・アプリケーションのみ」ワークスペース, 3.5

アクセス, 3.5.3

アカウントの有効期限, 3.5.5.2

ダッシュボード, 3.5.3

定義, 3.5.1

エンド・ユーザー・アカウント・ライフタイム, 3.5.5.2

ロック, 3.5.5.2

サービス・リクエストの作成, 3.5.5.1

対話モード・レポートのサブスクリプションの管理, 3.5.5.5

保存された対話モード・レポートの管理, 3.5.5.4

ユーザーの管理, 3.5.5.3

ログイン失敗の最大回数, 3.5.5.2

パッケージ・アプリケーション管理, 3.5.3, 3.5.5

パッケージ・アプリケーション・ギャラリ, 3.5.3, 3.5.4

記憶域のリクエスト, 3.5.5.1

終了のリクエスト, 3.5.5.1

リクエスト, 3.5.2

プリファレンスの設定, 3.5.5.2

アクティビティ・レポートの表示, 3.5.5.6

ページ・ビューの表示, 3.5.5.7

トップ・ユーザーの表示, 3.5.5.8

パッケージ, 検索, 7.7.7 ページ

コンポーネント・ビューでの編集, 9.3.2

ページ属性

ページ・デザイナでの編集, 8.4

コンポーネント・ビューでの表示, 9.4.1

ページ・デザイナでの表示, 8.4.1

ページ・コンポーネント, アクセスの制御, 20.3.4 ページ計算

計算ポイント, 17.1.4

作成, 17.1.2.1, 17.1.3.1

計算ポイントの定義, 17.1.2.3, 17.1.3.3

計算ソースの定義, 17.1.2.3, 17.1.3.3

属性の編集, 17.1.2.2, 17.1.3.2

計算を条件付きにする, 17.1.2.4, 17.1.3.4

コンポーネント・ビューでの管理, 17.1.3

ページ・デザイナでの管理, 17.1.2

ページ送信, 8.3.7

レンダリング前, 8.3.6

構文, 17.1.4

ページ制御

コンポーネント・ビューからの追加, 9.3.6

ページ・デザイナ

アクセス, 8.3.1

プロパティ・エディタへのアクセス, 8.3.2

レポートの追加, ドラッグ・アンド・ドロップ, 10.3

ボタンの追加, 8.3.3, 8.3.4, 8.3.5

アイテムの追加, 8.3.3, 8.3.4, 8.3.5

リージョンの追加, 8.3.3, 8.3.4, 8.3.5

SQLの知識なしでのレポートの追加, 10.2.6

中央ペイン, 8.1

コード・エディタ, 8.2.10

ダイアログ属性の構成, 8.4.5

ページのコピー, 8.7

アプリケーション・ページの削除, 8.8

ページ属性の編集, 8.4

ギャラリ, 8.2.5

グリッド・レイアウト, 8.2.3, 8.2.4

ヘルプ, 8.2.8

リージョン・タイトルを翻訳可能に指定, 21.1.5.4.1

メッセージ, 8.2.6

ページ検索, 8.2.7

プロパティ・エディタ, 8.1, 8.2.9

プロパティ・エディタ - ページ, 8.4.2

ページの実行, 8.5

実行時開発者ツールバー, 8.6

ページの検索, 8.3.8

ツリー・ペイン, 8.1, 8.2.2

使用, 8.3

レポート・リージョンの作成ウィザードの使用, 10.2.6

フィールドレベル・ヘルプの表示, 1.6.5.2

ページ属性の表示, 8.4.1

ページ・デザイナ・ツールバー, 8.2.1

「作成」メニュー, 8.2.1

作成, フォーム・リージョンの作成, 8.2.1

作成, レポート・リージョンの作成, 8.2.1

作成, 開発者のコメント, 8.2.1

作成, ページ, 8.2.1

作成, コピーとしてのページ, 8.2.1

作成, ページ・コンポーネント, 8.2.1

作成, ページ・グループ, 8.2.1

作成, 共有コンポーネント, 8.2.1

作成, チーム開発, 8.2.1

「開発者のコメント」, 「バグ」または「To Do」ボタン, 8.2.1

ページに移動, 8.2.1

ページがロックされました, 8.2.1

ページがロック解除されました, 8.2.1

やり直し, 8.2.1

「ページの保存と実行」ボタン, 8.2.1

「保存」ボタン, 8.2.1

設定, バグ, 8.2.1

設定, 機能, 8.2.1

設定, フィードバック・エントリ, 8.2.1

設定, コンポーネント・ビューに移動, 8.2.1

設定, To Do, 8.2.1

共有コンポーネント, 8.2.1

元に戻す, 8.2.1

ユーティリティ, 8.2.1

ユーティリティ, アプリケーション・ユーティリティ, 8.2.1, 8.2.1

ユーティリティ, 属性ディクショナリ, 8.2.1

ユーティリティ, 削除, 8.2.1

ユーティリティ, ページの削除, 8.2.1

ユーティリティ, エクスポート, 8.2.1

ユーティリティ, 履歴, 8.2.1

ユーティリティ, ページ・グループ, 8.2.1

ユーティリティ, アプリケーションのアップグレード, 8.2.1, 9.2.2

ページ・デザイナ・ウィンドウ, 8.1 ページ・デザイナ, ページ属性

ダイアログ, 属性, 8.4.5, 9.4.5

ダイアログ, CSSクラス, 8.4.5, 8.4.5, 9.4.5

ダイアログ, 高さ, 8.4.5, 9.4.5

ダイアログ, 最大幅, 8.4.5, 9.4.5

ダイアログ, 幅, 8.4.5, 9.4.5

ページ・ファインダ, 7.7, 8.3.8 ページ・アイテム

ページの表示の編集, 15.3.3.7.1

タイプ, A

ページ・レイアウト, 概要, 14.1 ページ・モード

モーダル・ダイアログ, 9.4.2.2

非モーダル・ダイアログ, 9.4.2.2

標準, 9.4.2.2

ページ・プロセス

プロセス・ポイントの変更, 17.3.2.3, 17.3.3.3

ソースの変更, 17.3.2.3, 17.3.3.3

作成, 17.3.2.1, 17.3.3.1, 17.3.3.1.1

エラー・メッセージの作成, 17.3.2.4, 17.3.3.4

表形式フォーム用の作成, 17.3.3.1.2

成功メッセージの作成, 17.3.2.4, 17.3.3.4

属性の編集, 17.3.2.2, 17.3.3.2

条件付きの作成, 17.3.2.5, 17.3.3.5

ページ送信, 8.3.7

レンダリング前, 8.3.6

「対象ボタン」属性, 2.10.4.32.2

ページ・プロセス, 2.5.1

概要, 9.3.4

理解, 2.5

ページ・レンダリング, 2.5.1

理解, 2.5

ページ・レンダリング

概要, 9.3.3

ページ固有のユーティリティ, 7.13.2

ブランチ・ユーティリティ, 7.13.2

ボタン・ユーティリティ, 7.13.2

計算ユーティリティ, 7.13.2

クロス・ページ・ユーティリティ, 7.13.2

動的アクション・ユーティリティ, 7.13.2

アイテム・ユーティリティ, 7.13.2

ページ・グループ, 7.13.2

プロセス・ユーティリティ, 7.13.2

リージョン・ユーティリティ, 7.13.2

検証ユーティリティ, 7.13.2

ページ・テンプレート

ボディ, 13.3.14.1.2

カスケード・スタイルシート, 13.3.14.1.4

定義, 13.3.14.1.2

ダイアログ, 13.3.14.1.9

表示ポイント, 13.3.14.1.8

編集, 13.3.14

エラー・ページ・テンプレートの制御, 13.3.14.1.10

フッター, 13.3.14.1.2

グリッド・レイアウト, 13.3.14.1.7

ヘッダー, 13.3.14.1.2

イメージ・ベースのタブ属性, 13.3.14.1.6

JavaScript, 13.3.14.1.3

JavaScript, ダイアログ取消コード, 13.3.14.1.3

JavaScript, ダイアログ・クロージャ・コード, 13.3.14.1.3

JavaScript, ダイアログ初期化コード, 13.3.14.1.3

JavaScript, ページ・ロード時に実行, 13.3.14.1.3

JavaScript, ファイルURL, 13.3.14.1.3

JavaScript, ファンクションおよびグローバル変数の宣言, 13.3.14.1.3

名前, 13.3.14.1.1

選択, 13.3.4

デフォルトの指定, 13.3.4.1, 13.3.4.2

置換文字列, 13.3.14

サブテンプレート, 13.3.14.1.5

ページ・テンプレート置換文字列, 13.3.14

#APEX_CSS#, 13.3.14.1.11

#APP_VERSION#, 13.3.14.1.11, 13.3.14.1.11, 13.3.14.1.11, 13.3.14.1.11, 13.3.14.1.11, 13.3.14.1.11, 13.3.14.1.11, 13.3.14.1.11, 13.3.14.1.11, 13.3.14.1.11

#APPLICATION_CSS#, 13.3.14.1.11

#APPLICATION_JAVASCRIPT#, 13.3.14.1.11

#BOX_BODY#, 13.3.14.1.11, 13.3.14.1.11

#DIALOG_CSS_CLASSES#, 13.3.14.1.11

#DIALOG_HEIGHT#, 13.3.14.1.11

#DIALOG_MAX_WIDTH#, 13.3.14.1.11

#DIALOG_WIDTH#, 13.3.14.1.11

#FORM_CLOSE#, 13.3.14.1.11

#FORM_OPEN#, 13.3.14.1.11

#GLOBAL_NOTIFICATION#, 13.3.14.1.11

#HEAD#, 13.3.14.1.11

#IS_MODAL#, 13.3.14.1.11, 13.3.14.1.11

#LOGO#, 13.3.14.1.11, 13.3.14.1.11

#NAVIGATION_BAR#, 13.3.14.1.11

#NOTIFICATION_MESSAGE#, 13.3.14.1.11, 13.3.14.1.11, 13.3.14.1.11

#ONLOAD#, 13.3.14.1.11

#PAGE_TRANSITION#, 13.3.14.1.11

#REGION_POSITION_NN#, 13.3.14.1.11, 13.3.14.1.11, 13.3.14.1.11, 13.3.14.1.11, 13.3.14.1.11, 13.3.14.1.11, 13.3.14.1.11, 13.3.14.1.11

#SIDE_GLOBAL_NAVIGATION_LIST#, 13.3.14.1.11

#SUCCESS_MESSAGE#, 13.3.14.1.11

#TAB_CELLS#, 13.3.14.1.11, 13.3.14.1.11

#TEMPLATE_JAVASCRIPT#, 13.3.14.1.11

#THEME_JAVASCRIPT#, 13.3.14.1.11

#THEME_STYLE_CSS#, 13.3.14.1.11

#TITLE#, 13.3.14.1.11

#TOP_GLOBAL_NAVIGATION_LIST#, 13.3.14.1.11

#TRIGGERING_ELEMENT#, 13.3.14.1.11

PAGE_URL, 13.3.14.1.11

ページ・ゼロ, 14.1 ページ, 認可スキームの割当て, 20.5.3.2 ページ・レベル・アイテム

概要, 15.1.1

すべてのページ・アイテム, 15.3.3.7.4

条件付きアイテム, 15.3.3.7.4

「認可スキーム」の構成, 15.3.3.3

「特殊文字をエスケープ」の構成, 15.2.3.3, 15.3.3.3

「制限付き文字」の構成, 15.2.3.3, 15.3.3.3

セキュリティの構成, 15.2.3.3, 15.3.3.3

「セッション・ステート保護」の構成, 15.2.3.3, 15.3.3.3

「セッション・ステートに暗号化された値を保存」の構成, 15.2.3.3, 15.3.3.3

作成, 15.1, 15.2.2, 15.3.2, 15.3.2.1

シャトルの作成, 15.1.5.3

カスケードLOVの作成, 15.3.2.3

カスケードLOVの作成, 15.2.2.4

「ギャラリ」からの作成, 15.2.2.2

「レンダリング」ツリーからの作成, 15.2.2.1

表形式フォームを使用して複数を作成, 15.3.2.4

静的LOVの作成, 15.3.2.2

デフォルト値の定義, 15.2.3.2, 15.3.3.2

クイック選択の定義, 15.2.3.4, 15.3.3.4

複数の削除, 15.3.3.7.3

条件付きの表示, 15.2.3.5, 15.3.3.5

読取り専用の表示, 15.2.3.6, 15.3.3.6

属性の編集, 15.3.3.1

プロパティ・エディタでの編集, 15.2.3.1

複数の編集, 15.3.3.7

すべてのアイテム・ヘルプ・テキストのグリッド編集, 15.3.3.7.4

すべてのアイテム・ラベルのグリッド編集, 15.3.3.7.4

アイテム・ヘルプのサブスクリプション, 15.3.3.7.4

複数選択リスト・アイテム, 15.1.5

ネーミング規則, 15.1.2, 15.1.2

リージョンへの再割当て, 15.3.3.7.2

JavaScriptを使用した参照, 15.1.4

値の参照, 15.1.3

「認可スキーム」の指定, 15.2.3.3

静的LOV, 15.2.2.3

表示, 15.2.1

履歴の表示, 15.3.3.7.5

コンポーネント・ビューでの表示, 15.3.1

ユーティリティの表示, 15.2.3.7, 15.3.3.7.4

ページレベル・アイテム・レポート

すべてのページ・アイテム, 15.2.3.7

条件付きアイテム, 15.2.3.7

すべてのアイテム・ヘルプ・テキストのグリッド編集, 15.2.3.7

すべてのアイテム・ラベルのグリッド編集, 15.2.3.7

アイテム・ヘルプのサブスクリプション, 15.2.3.7

ページ・レベル・テンプレート, 13.3.4.2 ページ

概要, 2.2.1

グローバル・ページについて, 14.3

ボタンからのコール, 2.7.6

別名を使用したコール, 2.7.5

アクセス制御, 20.3.4

重複送信, 9.4.2.10

ユーザーによるカスタマイズの有効化, 14.5.2.4, 14.6.3.4

エクスポート, 24.6.6

f?p構文を使用したリンク, 2.7.2

印刷用に最適化, 14.2

リソース使用, 22.3

検索, 7.7.4

サーバー・キャッシュ, 9.4.2.11

ページ・テンプレートの指定, 13.3.4.2

ページ・ファインダ, 7.7.4 ページ区切りの挿入

クラシック・レポート, 10.7.3, 10.8.3

対話モード・レポート, 10.4.4, 10.5.4

レポート, 13.3.17.2.2, 13.3.17.3.5

ページ区切りサブテンプレート

次のページ・テンプレート, 13.3.17.3.6

次のセット・テンプレート, 13.3.17.3.6

ページ区切りテンプレート, 13.3.17.3.6

前のページ・テンプレート, 13.3.17.3.6

前のセット・テンプレート, 13.3.17.3.6

親タブ, 作成, 16.2 解析対象スキーマ, 7.5.2.2.6 パスワード

ベスト・プラクティス, 20.2.1

変更, 1.4.2, 1.4.2

問題の識別, 20.2.2

サインイン・ページからのリセット, 1.2.4.5

再利用の制限, 20.1.5.10

「セキュリティ・プロファイル」レポート, 20.2.2.1

パスワード

「パスワード・アイテム」レポート, 20.2.2.2

パッチ, 作成, 24.6.4 PDF出力, 問題, 20.1.11 パフォーマンス, 23

ベスト・プラクティス, 23.1

データベース・パラメータ, 23.4, 23.5

問題のあるSQL問合せのデバッグ, 23.2.3

問題の診断, 23.2.2

問題の特定, 23.2

リソース制限, 23.5

速度の遅い問合せ, 23.2.4

実行速度の遅いアプリケーション, 23.2.1

Webサーバーへの静的ファイルのアップロード, 23.7

ログおよびレポートの使用, 23.3

PL/SQLコード, 検索, 7.7.7 PL/SQLファインダ, 7.7 プラグイン

概要, 19.2.1

アクセス, 19.2.3

イベントの追加, 19.2.8

作成, 19.2.4

カスタム属性, 19.2.6

削除, 19.2.9

編集, 19.2.5

例, 19.2.2

エクスポート, 19.2.12

実装, 19.2

インポート, 19.2.11, 24.7.4

リセット, 19.2.13

関連付けられたファイルのアップロード, 19.2.7

JavaScriptコードの使用, 19.3.3.2

使用状況, 19.2.14

履歴の表示, 19.2.15

プラグイン・リポジトリの表示, 19.2.10

ポップアップLOV, A.1 ポップアップLOVテンプレート

ボタン, 13.3.15.1.2

編集, 13.3.15

ページ属性, 13.3.15.1.6

ページ区切り, 13.3.15.1.4

結果セット, 13.3.15.1.5

検索フィールド, 13.3.15.1.1

ウィンドウ, 13.3.15.1.3

ポップアップLOV, 依存LOVの作成, 15.3.2.3 事前構成済の認証スキーム, 20.4.3 「印刷用」テンプレート, 14.2 レポートの印刷, 10.9 権限

データベース・ユーザーへの付与について, D.1

データベース・ユーザーへの付与, D.1

PUBLICへの付与, D.2

プロシージャ・ファインダ, 7.7.7 プロシージャ, 検索, 7.7.7 プロセス

キャッシュ管理, 17.3.2.1, 17.3.3.1.1, 17.3.3.1.2

データ操作, 17.3.2.1, 17.3.3.1.1, 17.3.3.1.2

フォーム・ページ区切り, 17.3.2.1, 17.3.3.1.1, 17.3.3.1.2

オンデマンド, 17.3.2.1, 17.3.3.1.1, 17.3.3.1.2

PL/SQL, 17.3.2.1, 17.3.3.1.1, 17.3.3.1.2

レポート・ページ区切り, 17.3.2.1, 17.3.3.1.1, 17.3.3.1.2

Webサービス, 17.3.2.1, 17.3.3.1.1, 17.3.3.1.2

生産性アプリケーション, ロック解除, 3.2.7 プログラミング手法

コレクション, 25.2

データベース・リンク, 25.4

Webサービスの実装, 25.3

プロパティ・エディタ, 8.1 プロキシ・サーバー, 25.3.2.2 「プロキシ・サーバー」属性, 7.5.1.2.2 PUBLIC

付与される権限, D.2

パブリック・ファイルのアップロード, 有効化, 20.1.5.2 パブリック・シノニム, D.2 「パブリック・ユーザー」属性, 7.5.2.2.1

Q

問合せファインダ, 7.7, 7.7.5

問合せ, 検索, 7.7.5

R

ラジオ・グループ, A.1

LOV, 15.3.2.3

「最近更新されたページ」レポート, 7.13.1.4 リフロー・レポート

アプリケーションの作成ウィザードでの作成, 7.1.2, 10.2.1, 14.6.1

ページの作成ウィザードでの作成, 7.6.2, 10.2.2

リージョン・ページ・ウィザードでの作成, 10.2.3

リージョン

タイプについて, 14.6.1

ユーティリティおよびレポートへのアクセス, 14.6.3.8.2

イメージの追加, 14.5.2.7, 14.6.3.7

URLに基づく, 14.7

位置の制御, 14.5.2.2, 14.6.3.2.2

コピー, 14.5.3, 14.6.5

作成, 14.5.1, 14.5.1, 14.6.2, 14.6.2

リスト用の作成, 18.7.6

リージョン表示セレクタの作成, 14.5.2.8, 14.6.4

サブリージョンの作成, 14.6.3.9

削除, 14.5.4, 14.6.6

一度に複数のリージョンを削除, 14.6.6.2

条件付き表示, 14.6.3.2.1, 14.6.3.2.1

属性の編集, 14.5.2.1, 14.6.3.1, 14.6.3.9.3

複数のリージョンの属性の編集, 14.6.3.8.1

リージョン属性の編集, 14.5.2.1, 14.6.3.1, 14.6.3.9.3

カスタマイズの有効化, 14.5.2.4, 14.6.3.4

ユーザーによるページのカスタマイズの可能化, 14.5.2.4, 14.6.3.4

属性がレイアウトに与える影響, 14.6.3.2

静的リージョンIDの指定, 14.5.2.6, 14.6.3.6

ヘッダーとフッターの指定, 14.5.2.3, 14.6.3.3

理解, 14.5, 14.6

リージョン属性

キャッシュ, 14.5.2.5, 14.6.3.5

列, 14.6.3.2.1

列属性, 14.6.3.2.1

列CSSクラス, 14.6.3.2.1

列スパン, 14.6.3.2.1

条件タイプ, 14.6.3.2.1

カスタマイズ, 14.6.3.2.1

表示ポイント, 14.6.3.2.1

式, 14.6.3.2.1, 14.6.3.2.1

イメージ・タグ属性, 14.6.3.2.1

アイテム表示位置, 14.6.3.2.1

読取り専用条件タイプ, 14.6.3.2.1

リージョンのCSSクラス, 14.6.3.2.1, 14.6.3.2.1

リージョン表示セレクタ, 14.6.3.2.1

リージョン・フッター, 14.6.3.2.1

リージョン・ヘッダー, 14.6.3.2.1

リージョン・イメージ, 14.6.3.2.1

順序, 14.6.3.2.1, 14.6.3.2.1

新規グリッドの開始, 14.6.3.2.1, 14.6.3.2.1

静的ID, 14.5.2.6, 14.6.3.6

テンプレート, 14.6.3.2.1

リージョン表示セレクタ, 作成, 14.5.2.8, 14.6.4 リージョン・テンプレート

定義, 13.3.16.1.2

編集, 13.3.16

フォーム表属性, 13.3.16.1.3

名前, 13.3.16.1.1

「サブリージョン」属性, 13.3.16.1.4

Substitution Strings, 13.3.16.1.5

リージョン・タイトル

翻訳可能に指定, 21.1.5.4

リージョン・タイプ

ブレッドクラム, 14.6.1

カレンダ, 14.6.1

チャート, 14.6.1

クラシック・レポート, 14.6.1

Webサービスのフォームとレポート, 14.6.1

プロシージャのフォーム, 14.6.1

SQL問合せのフォーム, 14.6.1

表またはビューのフォーム, 14.6.1

リスト・ビュー付きの表のフォーム, 14.6.1

レポート付きの表のフォーム, 14.6.1

Webサービスのフォーム, 14.6.1

ヘルプ・テキスト, 14.6.1

対話モード・レポート, 14.6.1

リスト, 14.6.1

リスト・ビュー, 14.6.1

マップ, 14.6.1

マスター・ディテール・フォーム, 14.6.1

複数の静的コンテンツ, 14.6.1

PL/SQL動的コンテンツ, 14.6.1

プラグイン, 14.6.1

リージョン表示セレクタ, 14.6.1

Webサービスの結果のレポート, 14.6.1

静的コンテンツ, 14.6.1

サマリー・ページ, 14.6.1

表形式フォーム, 14.6.1

ツリー, 14.6.1

URL, 14.6.1

セッションを再結合

セキュリティ・リスクについて, 20.1.5.7

アプリケーション・レベルでの構成, 7.5.2.2.3

ページ・レベルでの構成, 8.4.4, 9.4.4

「セッションを再結合」属性, 7.5.2.2.3 レポート

アプリケーションの作成ウィザードでの作成, 7.1.2, 10.2.1

Oracleデータベース, 23.4

レポートとフォーム

アプリケーションの作成ウィザードでの作成, 7.1.2, 10.2.1

レポート列テンプレート

セル・ヘッダーのカラー化, 13.3.17.2.3

ヘッダーの省略, 13.3.17.2.3

レポート列テンプレート(汎用)

行の後, 13.3.17.2.7

各行の前, 13.3.17.2.4, 13.3.17.2.6

行の前, 13.3.17.2.2

列ヘッダー, 13.3.17.2.3

列テンプレート, 13.3.17.2.5

HTMLをすべての列の後に表示, 13.3.17.2.6

HTMLを最後の行の後に表示, 13.3.17.2.7

次のページ・テンプレート, 13.3.17.2.9

次のセット・テンプレート, 13.3.17.2.9

ページ区切りサブテンプレート, 13.3.17.2.9, 13.3.17.2.9

前のページ・テンプレート, 13.3.17.2.9

前のセット・テンプレート, 13.3.17.2.9

レポート・テンプレート, 13.3.17.2.1

行選択, 13.3.17.2.8

レポート列テンプレート(名前付き)

「行の前」属性, 13.3.17.3.5

列ヘッダー・セルのカラー化, 13.3.17.3.4

列ヘッダー, 13.3.17.3.4

ページ区切りサブテンプレート, 13.3.17.3.6

レポート・テンプレートの指定, 13.3.17.3.1

行テンプレート, 13.3.17.3.3

サブスクリプション, 13.3.17.3.2

レポート・レイアウト

概要, 18.9.2

コピー, 18.9.2.5

作成, 18.9.2.3

編集, 18.9.2.4

オプション, 18.9.2.2

Webサービスのレポート

ページの作成ウィザードでの作成, 7.6.2, 10.2.2

Webサービスの結果のレポート

リージョンの作成ウィザードでの作成, 14.6.1

レポート出力, 問題, 20.1.11 レポート問合せ

概要, 18.9.1

コピー, 18.9.1.4

作成, 18.9.1.2

編集, 18.9.1.3

レポート・リージョン

構成オプションについて, 10.9.2

出力, 10.9

PDFへの出力, 10.9.1

レポート・テンプレート, 13.3.17

編集, 13.3.17

汎用列テンプレート, 13.3.17.1.1

名前付き列テンプレート, 13.3.17.1.2

JavaScriptの使用, 13.3.17.4

レポート, 13.3.7

概要, 10

データベース・アプリケーションについて, 7.13

アクティブ・セッション履歴(ASH)レポート, 23.4

ドラッグ・アンド・ドロップによる追加, 10.3

アプリケーション・ダッシュボード, 7.13.1.2, 23.3.2

自動ワークロード・リポジトリ(AWR)レポート, 23.4

アイテム・ヘルプをバルク編集, 12.4.3

変更履歴, 7.13.1.3

クラス参照, 13.2.11.4

列リンクの作成, 10.7.8, 10.8.8

アプリケーションの作成ウィザードでの作成, 10.2.4

ページの作成ウィザードでの作成, 10.2.5

SQLの知識なしでの作成, 10.2.6

CSVエクスポート, 13.3.17.2.4

データベース・アプリケーション, 7.13

CSV形式へのエクスポート, 13.3.17.2.2, 13.3.17.3.5

ページ区切りを上に追加, 13.3.17.2.2, 13.3.17.3.5

アクティビティの監視, 23.3.4

パフォーマンス,23.3

出力, 10.9

最近更新されたページ, 7.13.1.4

列のソート, 10.7.4, 10.8.4

サポートされている置換文字列, 13.2.11.5

テンプレートのサブスクリプション, 13.3.7

テンプレートの使用状況, 13.3.7

テーマのテンプレート, 13.2.11.1

テーマ・ファイル参照, 13.2.11.3

テーマ・テンプレート数, 13.2.11.2

テーマ, 13.2.11

違いの理解, 10.1

ワークスペース・アクティビティ, 23.3.2, 23.3.3

REQUEST

スコープおよび値について, 2.10.4.32.1

「対象ボタン」属性について, 2.10.4.32.2

ボタン名, 15.5.5

宣言条件を使用した参照, 2.10.4.32.3

値の参照, 2.10.4.31

置換文字列, 2.10.4.31

表示プロセスでの使用, 2.10.4.32.4

リソース使用, 監視, 22.3 レスポンシブ・デザイン, 2.3.3 レスポンシブ・デザイン, 概要, 13.1.2 RESTfulアクセス, 有効化, 20.1.5.6 アクセスの制限, アプリケーションに対する, 7.5.1.2.3 「アプリケーションの実行」ボタン, 4.4.2 「アプリケーションの実行」アイコン, 3.3.3.3 「パブリック・ページで実行」属性, 7.5.2.2.2 ランタイムAPIの使用状況, 7.5.2.2.6 実行時開発者ツールバー, 8.6, 9.6 ランタイム環境, 1.1.3

利点, 20.1.10

S

安全なアイテム・タイプ, 20.2.3.2.2

サンプル・データベース・アプリケーション

概要, 3.3

Administrationページ, 3.3.2.9

Customersページ, 3.3.2.2, 3.3.2.3

編集, 3.3.3, 3.3.3.3

アプリケーションの編集, 3.3.3.3

ホームページ, 3.3.2.1

インストール, 3.3.1

モバイル・ページ, 3.3.2.10

変更, 3.3.3, 3.3.3.3

実行, 3.3.1

理解, 3.3, 3.3.2

スクリーン・リーダー・モード, E.1

概要, E.1.2, E.1.3

APIでの制御, E.1.2.1

f?p構文を使用した制御, E.1.2.1

置換文字列での制御, E.1.2.1

有効化, E.1.1

拡張, E.1.2.2

プロビジョニング, E.1.2.1

SDLC

高速アプリケーション開発, 24.2.5

スパイラル, 24.2.4

ワークスペースの検索, 1.3.4.1 Secure Sockets Layer, ベスト・プラクティス, 20.1.5.5 セキュリティ

属性, 7.5.2

ページ用, 9.4.2.9

セキュリティ属性

この後に作成されるURLの許可属性, 7.5.2.2.4

認証, 7.5.2.2.1

認証スキーム, 7.5.2.2.1

認可スキーム, 7.5.2.2.2, 7.5.2.2.2

ブックマーク・ハッシュ関数, 7.5.2.2.4

ブラウザ・セキュリティ, 7.5.2.2.5

キャッシュ, 7.5.2.2.5

データベース・セッション, 7.5.2.2.6, 7.5.2.2.6, 7.5.2.2.6, 7.5.2.2.6

ディープ・リンク, 7.5.2.2.3

認可スキームの定義, 7.5.2.2.2

フレームへの埋込み, 7.5.2.2.5

ブックマークの無効化, 7.5.2.2.4

HTMLエスケープ・モード, 7.5.2.2.5

HTTPレスポンス・ヘッダー, 7.5.2.2.5

セッション・ステート保護の管理, 7.5.2.2.4

最大セッション・アイドル時間, 7.5.2.2.3

最大セッションの長さ, 7.5.2.2.3

パブリック・ユーザー, 7.5.2.2.1

セッションを再結合, 7.5.2.2.3

パブリック・ページで実行, 7.5.2.2.2

セッション・アイドル・タイムアウトURL, 7.5.2.2.3

セッション管理, 7.5.2.2.3

セッション・ステート保護, 7.5.2.2.4, 7.5.2.2.4

セッション・タイムアウトURL, 7.5.2.2.3

セキュリティに関するベスト・プラクティス

インスタンス設定の構成, 20.1.6

記憶域オプションの構成, 20.1.6.3

ワークスペース設定の構成, 20.1.7

WebシートでのSQLアクセスの制御, 20.1.5.11, 20.1.5.11

ログイン制御の作成, 20.1.5.1

ウォレットの作成, 20.1.6.4

クロスサイト・スクリプティング保護, 20.2.3

埋込みPL/SQLゲートウェイ, 20.1.4

電子メールの有効化, 20.1.6.2

ネットワーク・サービスの有効化, 20.1.11

パブリック・ファイルのアップロードの有効化, 20.1.5.2

RESTfulアクセスの有効化, 20.1.5.6

RESTfulサービスの有効化, 20.1.5.12

ワークスペースのセルフ・サービス割当ての有効化, 20.1.6.1

管理者向け, 20.1

開発者向け, 20.2

問題を引き起こす可能性のあるパスワードの識別, 20.2.2

ワークスペースの分離, 20.1.5.8

タイプ・パスワードのアイテム, 20.2.1

コンポーネントの可用性の管理, 20.1.8.3

インスタンス・セキュリティの管理, 20.1.5

ユーザーの管理, 20.1.8.2

スキーマへのワークスペースの割当ての管理, 20.1.8.1

ワークスペースの管理, 20.1.8

Oracle BI Publisher, 20.1.9

Oracle HTTP Server, 20.1.3

IPアドレスによるアクセスの制限, 20.1.5.3

パスワードの再利用の制限, 20.1.5.10

ランタイム環境, 20.1.10

Secure Sockets Layer, 20.1.5.5

セッション結合, 20.1.5.7

セッション・ステート, 20.2.4

セッション・タイムアウト, 20.1.5.9

インスタンス・プロキシの指定, 20.1.5.4

セキュリティ・リスク, ファイル・アップロード表, 20.2.6 シード, 21.3.2 選択リスト, A.1 選択リスト, 依存LOVの作成, 15.3.2.3 セッションID, 2.6.3 セッション・アイドル・タイムアウトURL, 7.5.2.2.3 セッション結合

ブラウザ攻撃の防止, 20.1.5.7

セキュリティに関するベスト・プラクティス, 20.1.5.7

セッション管理, 7.5.2.2.3

指定, 7.5.2.2.3

セッション・ステート

クリア, 2.9.3

アプリケーション・キャッシュのクリア, 2.9.3.3

アイテムごとのキャッシュのクリア, 2.9.3.1

ページごとのキャッシュのクリア, 2.9.3.2

カレント・ユーザー・セッションのキャッシュのクリア, 2.9.3.5

2ページごとのキャッシュのクリア, 2.9.3.2.1

保護の有効化, 7.5.2.2.4

管理, 2.6

アイテム値の引渡し, 2.9.3.2.2

保護, 20.2.5

参照, 2.9.1

アプリケーションの完全なリセット, 2.9.3.4

セキュリティに関するベスト・プラクティス, 20.2.4

設定, 2.9.2

アプリケーション間での共有, 18.5.4

表示, 2.6.4

セッション・ステート保護

すべての属性の構成, 20.2.5.3.3

セキュリティ属性の構成, 20.2.5.3

無効化, 20.2.5.2

有効化, 20.2.5.2

「セキュリティ属性の編集」からの有効化, 20.2.5.2.1

「セッション・ステート保護」からの有効化, 20.2.5.2.3

ウィザードを使用した有効化, 20.2.5.2.3

レポート, 20.2.5.3.2

理解, 20.2.5.1

既存の設定の表示, 20.2.5.3.2

サマリーの表示, 20.2.5.3.2

「セッション・ステート保護」属性, 7.5.2.2.4, 7.5.2.2.4 セッション・ステート値, 管理, 2.9 セッション・タイムアウトURL, 7.5.2.2.3 セッション・タイムアウト, 使用, 20.1.5.9 共有コンポーネント

概要, 9.3.5, 18.1.4

アクセス, 18.1.2

バックアップ, 24.6.4

作成, 18.1.2

エクスポート, 24.6.4

アイコン, 3.3.3.3, 4.4.2

共有コンポーネント・ページ, 18.1

共有コンポーネント・ページ

アプリケーションの計算, 18.1.4.1

アプリケーション定義属性, 18.1.4.1

アプリケーション・アイテム, 18.1.4.1

アプリケーション・プロセス, 17.5, 18.1.4.1

認証スキーム, 18.1.4.2

認可スキーム, 18.1.4.2

ブレッドクラム, 18.1.4.4

ビルド・オプション, 18.1.4.2

コンポーネント設定, 18.1.4.3

データのロード, 18.1.4.7

開発者コメントのカレンダ, 18.1.4.10

アプリケーション・コメントの編集, 18.1.4.10

アプリケーション・コンポーネントのエクスポート, 18.1.4.10

グローバリゼーション属性, 18.1.4.9

LOV, 18.1.4.3

リスト, 18.1.4.4

サポートするオブジェクトの管理, 18.1.4.10

ナビゲーション・バー・エントリ, 18.1.4.4

ナビゲーション・メニュー, 18.1.4.4

プラグイン, 18.1.4.3

レポート・レイアウト, 18.1.4.8

レポート問合せ, 18.1.4.8

開発者コメントのレビュー, 18.1.4.10

セキュリティ属性, 18.1.4.2

セッション・ステート保護, 18.1.4.2

ショートカット, 18.1.4.3

静的アプリケーション・ファイル, 18.1.4.6

静的ワークスペース・ファイル, 18.1.4.6

タブ, 18.1.4.4

「タスク」リージョン, 18.1.4.10

テンプレート, 18.1.4.5

テキスト・メッセージ, 18.1.4.9

テーマ, 18.1.4.5

アプリケーションの翻訳, 18.1.4.9

ユーザー・インタフェース属性, 18.1.4.5

Webサービス参照, 18.1.4.7

共有対話モード・レポート, リンクの設定, 10.4.15.7, 10.5.15 ショートカット, 18.8

概要, 18.8.1

既存のショートカットのコピー, 18.8.3.2

定義, 18.8.3, 18.8.3.1, 18.8.3.2

ゼロからの定義, 18.8.3.1

属性の編集, 18.8.4

履歴レポート, 18.8.5

HTMLテキスト, 18.8.2.1, 18.8.3.1

エスケープされた特殊文字を持つHTMLテキスト, 18.8.2.1, 18.8.3.1

イメージ, 18.8.2.1, 18.8.3.1

メッセージ, 18.8.2.1, 18.8.3.1

エスケープされた一重引用符を持つJavaScriptのメッセージ, 18.8.2.1, 18.8.3.1

PL/SQLファンクション本体, 18.8.2.1, 18.8.3.1

参照, 18.8.3.3

レポート, 18.8.5

サブスクリプション・レポート, 18.8.5

翻訳可能なメッセージのサポート, 21.1.5.1

エスケープされた一重引用符を持つJavaScriptのテキスト, 18.8.2.1, 18.8.3.1

タイプ, 18.8.2

ページ表示, 2.5.1 シャトルの複数選択リスト, A.1 シャトル, 依存LOVの作成, 15.3.2.3 サインイン資格証明, 1.2.4.2 サインイン・ページ, 1.2

ログイン資格証明の理解, 1.2.4.2

サインイン, Oracle Application Express, 1.2.4 サインアウト, 1.2.4.3 シングル・サインオン

設定, 20.4.3.8.2

スライダ・アイテム・タイプ, A.1 SOAP, 25.3 SQLトレース, 有効化, 22.4 標準タブ, 作成, 16.2 静的アプリケーション・ファイル

削除, 18.3.6.1

すべて削除, 18.3.6.2

ダウンロード, 18.3.5.1

Zipファイルでのダウンロード, 18.3.5.2

管理, 18.3

#APP_IMAGES#を使用した参照, 18.3.4

アップロード, 18.3.2

詳細の表示, 18.3.3

静的ファイル

エクスポート, 24.6.8, 24.6.8

他のインスタンスへのインポート, 24.6.8

静的リスト

概要, 18.7.3

リスト・エントリの追加, 18.7.3.3

サブリストの追加, 18.7.3.3

エントリのコピー, 18.7.3.5

最初から作成, 18.7.3.2

孤立リスト・エントリの管理, 18.7.3.7

エントリの親の変更, 18.7.3.6

エントリの順序変更, 18.7.3.8

静的置換文字列, 7.5.1.2.6 静的ワークスペース・ファイル

削除, 18.4.5.1

すべて削除, 18.4.5.2

ダウンロード, 18.4.4.1

Zipファイルでのすべてのダウンロード, 18.4.4.2

管理, 18.4

#WORKSPACE_IMAGES#を使用した参照, 18.4.3

アップロード, 18.4.1

詳細の表示, 18.4.2

「ステータス」属性, 7.5.1.2.3 記憶域オプション, 構成, 20.1.6.3 スタイルシート, 13.3.1 サブリージョン, 14.6.3.9

作成, 14.6.3.9.2

属性の編集による作成, 14.6.3.9.3

使用, 14.6.3.9.1

置換の出力のエスケープ

ATTR, 2.10.2

HTML, 2.10.2

JS, 2.10.2

保持, エスケープしない, 2.10.2

RAW, 2.10.2

HTMLタグの削除, 2.10.2

HTML属性の予約済の文字, 2.10.2

JavaScriptコンテキストの予約済の文字, 2.10.2

予約済のHTML文字, 2.10.2

STRIPHTML, 2.10.2

置換文字列

#COLCOUNT#, 13.3.17.2.4

#CSV_LINK#, 13.3.17.2.2, 13.3.17.3.5

#GLOBAL_NOTIFICATION#, 7.5.1.2.5

#HIGHLIGHT_ROW#, 13.3.17.2.4

#ROWNUM#, 13.3.17.2.4

組込みについて, 2.10.4

APEX$ROW_NUM, 2.10.4.1

APEX$ROW_SELECTOR, 2.10.4.2

APEX$ROW_STATUS, 2.10.4.3

APP_AJAX_Xnn, 2.10.4.6

APP_ALIAS, 2.10.4.5

APP_DATE_TIME_FORMAT, 2.10.4.7

APP_ID, 2.10.4.4

APP_IMAGES, 2.10.4.8

APP_NLS_DATE_FORMAT, 2.10.4.9

APP_NLS_TIMESTAMP_FORMAT, 2.10.4.10

APP_NLS_TIMESTAMP_TZ_FORMAT, 2.10.4.11

APP_PAGE_ALIAS, 2.10.4.12

APP_PAGE_ID, 2.10.4.13

APP_REQUEST_DATA_HASH, 2.10.4.14

APP_SESSION, 2.10.4.15

APP_SESSION_VISIBLE, 2.10.4.16

APP_TITLE, 2.10.4.17

APP_UNIQUE_PAGE_ID, 2.10.4.18

APP_USER, 2.10.4.19

Application Expressスキーマ所有者, 2.10.4.33

AUTHENTICATED_URL_PREFIX, 2.10.4.20

BROWSER_LANGUAGE, 2.10.4.21

カレンダ, 12.1.8

CURRENT_PARENT_TAB_TEXT, 2.10.4.22

DEBUG, 2.10.4.23

アプリケーション・アイテム用, 2.10.1

ページ・アイテム用, 2.10.1

IMAGE_PREFIX, 2.10.4.25

ページ・テンプレート内, 13.3.14

LOGOUT_URL, 2.10.4.27

出力のエスケープ, 2.10.2, 13.3.3

PRINTER_FRIENDLY, 2.10.4.28

PROXY SERVER, 2.10.4.29

PUBLIC_URL_PREFIX, 2.10.4.30

サポート対象に関するレポート, 13.2.11.5

REQUEST, 2.10.4.31

SQLERRM, 2.10.4.34

静的, 7.5.1.2.6

リージョン・フッターでサポート, 14.5.2.3, 14.6.3.3

SYSDATE_YYYYMMDD, 2.10.4.35

理解, 2.10

テンプレート内での使用方法, 2.10.3

使用, 2.10.1

テンプレート内, 2.10.1

WORKSPACE_ID, 2.10.4.37

WORKSPACE_IMAGES, 2.10.4.36

成功メッセージ, ページ・プロセスの作成, 17.3.2.4, 17.3.3.4 サポートされるオブジェクト

作成, 24.5.2

削除, 24.5.7

SVGチャート

他の言語での表示, 12.3.6.5

Flashへの移行, 12.3.6.1.2

CSSスタイル・インラインの参照, 12.3.6.4

カスタムCSSの参照, 12.3.6.3

アップグレードの制限, 12.3.6.1.1

すべてのHTML5へのアップグレード, 12.3.6.1.3

HTML5へのアップグレード, 12.3.6.1.2

SVGチャート, CSSクラスの概要, 12.3.6.2 構文, 動的リスト, 18.7.4.2 システム・メッセージ, 1.3.3

T

タブ

タブ・ページについて, 16.2.2

追加, 16.2

「条件付き表示」レポート, 16.2.6

標準タブの作成, 16.2.5.2

標準タブ・セットの作成, 16.2.5.2

作成, 16.2.2, 16.2.4

編集, 16.2.5

複数の編集, 16.2.5.1

「履歴」レポート, 16.2.6

管理, 16.2.2

別の親への標準の移動, 16.2.5.2

親, 16.2.1

標準名の変更, 16.2.5.2

レポート, 16.2.6

順序の変更, 16.2.5.2

標準, 16.2.1

標準タブのタスク, 16.2.5.2

テンプレートのサポート, 16.2.3

「使用状況」レポート, 16.2.6

タブ・レポート

条件付き表示, 16.2.6, 16.2.6

履歴, 16.2.6

表ファインダ, 7.7 表ファインダ, 7.7.6 表, 検索, 7.7.6 タブ・ページ, 16.2.2 表形式フォーム

作成, 11.2

ページ・プロセスの作成, 17.3.3.1.2

アプリケーションの作成ウィザードでの作成, 7.1.2

タグ・クラウド, 5.3 チーム開発

アクセス, 5.1

機能ダッシュボード, 5.4.1, 5.4.6.1

ホームページ, 5.2

バグの管理, 5.7

フィードバックの管理, 5.8, 5.8.5.2

リンクの管理, 5.9.9

ニュース・エントリの管理, 5.9.8

To Doの管理, 5.6

「ニュース」リージョン, 5.2

データのパージ, 5.9.7

機能の追跡, 5.4

マイルストンの追跡, 5.5

ユーティリティ, 5.2

チーム開発のファイル添付

表示, 5.9.6

チーム開発ユーティリティ, 5.9

アクセス, 5.9.1

マイルストンの割当て, 5.9.4

期日を超過した機能のマイルストンの変更, 5.9.4

チーム開発の設定の構成, 5.9.2

フォーカス領域の編集, 5.9.5

ファイル・アップロードのサポートの有効化, 5.9.1

フォーカス領域の管理, 5.9.1

リンクの管理, 5.9.1

複数の機能のマイルストンの管理, 5.9.1

ニュースの管理, 5.9.1

アップロードしたファイルの管理, 5.9.1

リンクの管理, 5.9.9

ニュース・エントリの管理, 5.9.8

データのパージ, 5.9.1

データのパージ, 5.9.7

オープンな機能の期限のプッシュ, 5.9.4

期限経過したバグのプッシュ, 5.9.1

リリース・サマリー, 5.9.3

「リリース・サマリー」レポート, 5.9.1

マイルストン日付への機能の期日の設定, 5.9.4

チーム開発の設定, 5.9.1

割当て先の更新, 5.9.1

添付ファイルの表示, 5.9.6

テンプレート編集履歴, 13.3.7 テンプレート・オプションの事前設定, 13.1.5.3 テンプレート・オプション

概要, 13.1.5.1

デフォルト, 13.1.5.2

グループ, 13.1.5.3

事前設定, 13.1.5.3

使用, 13.1.5

テンプレート・オプション・グループ, 13.1.5.3 テンプレート

ブレッドクラム, 13.3.9

ボタン, 13.3.10

デフォルトの変更, 13.1.7

列, 13.3.17.2.5, 13.3.17.4

作成, 13.3.5

カスタマイズ, 13.3

ラベル, 13.3.12

レガシー・カレンダ, 13.3.11

リスト, 13.3.13

管理, 13.3.8

ページ, 13.3.14

ポップアップLOV, 13.3.15

公開, 13.3.8.7

リージョン, 13.3.16

置換, 13.3.8.3

すべて置換, 13.3.8.4

レポート, 13.3.17

ページに対する選択, 13.3.4.2

テーマのデフォルトの選択, 13.3.4.1

サポートされている置換文字列, 13.2.11.5

サブスクライブ解除, 13.3.8.6

特定のページの表示, 13.3.8.2

履歴レポートの表示, 13.3.7

テンプレート・ページでの表示, 13.3.8.1

パブリッシュ・レポートの表示, 13.3.7

リージョン位置の使用状況の表示, 13.3.8.5

レポートの表示, 13.3.7

サブスクリプション・レポートの表示, 13.3.7

使用状況レポートの表示, 13.3.7

テキスト領域, A.1 テキスト文字列, 21.4.3

翻訳, 21.4.2

テキスト文字列, 翻訳, 21.4 テーマ属性, 13.1.7.2

ブレッドクラム, 13.1.7.2.4, 13.1.7.2.5

ボタン, 13.1.7.2.4

チャート, 13.1.7.2.5

クラシック・レポート, 13.1.7.2.4

CSSファイルURL, 13.1.7.2.3

カスタム・クラス, 13.1.7.2.9

カスタム・イメージ, 13.1.7.2.10

カスタム・ライブラリ・ファイルURL, 13.1.7.2.9

カスタム接頭辞クラス, 13.1.7.2.9

日付ピッカー・アイコン属性, 13.1.7.2.9

日付ピッカー・アイコン名, 13.1.7.2.9

デフォルトのラベル, 13.1.7.2.4

ダイアログ・ボタン・リージョン, 13.1.7.2.6

ダイアログ・コンテンツ・リージョン, 13.1.7.2.6

ダイアログ・ページ, 13.1.7.2.6

エラー・ページ, 13.1.7.2.4

ファイル, 13.1.7.2.12

フッター・ツールバー, 13.1.7.2.4

フォーム, 13.1.7.2.5

グローバル・テンプレート・オプション, 13.1.7.2.8

ヘッダー・ツールバー, 13.1.7.2.4

対話モード・レポート, 13.1.7.2.5

JavaScriptファイルURL, 13.1.7.2.3

レガシー・カレンダ, 13.1.7.2.4

ライブラリ, 13.1.7.2.9

リスト, 13.1.7.2.4

リスト, 13.1.7.2.5

ログイン・ページ, 13.1.7.2.4

名前, アプリケーション, 13.1.7.2.1

名前, 説明, 13.1.7.2.1

名前, 名前, 13.1.7.2.1

名前, ナビゲーション・バー実装, 13.1.7.2.1

名前, ナビゲーション・タイプ, 13.1.7.2.1

名前, テーマ番号, 13.1.7.2.1

名前, ユーザー・インタフェース, 13.1.7.2.1

ナビゲーション・バー・リスト, 13.1.7.2.4

ナビゲーション・メニュー・リストの位置, 13.1.7.2.4

ナビゲーション・メニュー・リスト(トップ), 13.1.7.2.4, 13.1.7.2.4

オプションのラベル, 13.1.7.2.4

ページ, 13.1.7.2.4

ページ・テンプレート・オプション, 13.1.7.2.4

ページ遷移, 13.1.7.2.7

ポップアップ遷移, 13.1.7.2.7

「印刷用」ページ, 13.1.7.2.4

リージョン, 13.1.7.2.4

レポート, 13.1.7.2.5

必須ラベル, 13.1.7.2.4

スタイル, 13.1.7.2.11

表形式フォーム, 13.1.7.2.5

テーマのサブスクリプション, 13.1.7.2.2

ウィザード, 13.1.7.2.5

テーマ・レポート

アプリケーション・テンプレート, 13.2.11.1

クラス参照, 13.2.11.4

クラス参照, 13.2.11.4

ファイル参照, 13.2.11.3

ファイル参照, 13.2.11.3

サポートされている置換文字列, 13.2.11.5

テンプレート数, 13.2.11.2

テンプレート置換文字列, 13.2.11.5

テーマのテンプレート, 13.2.11.1

テーマ・テンプレート数, 13.2.11.2

テーマ・ローラー, 3.3.3.2, 8.6, 9.6

使用, 13.1.4.4

テーマ・スタイル, 13.1.4

概要, 13.1.4.1

作成, 13.1.4.2

削除, 13.1.4.3

編集, 13.1.4.3

テーマ・ローラー, 13.1.4.4

使用, 13

テーマのサブスクリプション

概要, 13.2.1, 13.2.1.1

変更, 13.2.1.2

リフレッシュ, 13.2.1.4

再サブスクライブ, 13.2.1.6

サブスクライブ解除, 13.2.1.5

リフレッシュの検証, 13.2.1.3

テーマ

概要, 13.1.1

サブスクリプションについて, 13.2.1

アクセス, 13.1.6

IDの変更, 13.2.4

識別番号(ID)の変更, 13.2.4

コピー, 13.2.5, 13.2.5

作成, 13.2.2

マスター・アプリケーションの作成, 13.2.7

デフォルト・テンプレート, 13.1.7

削除, 13.2.6, 13.2.6

編集, 13.1.7

テーマ属性の編集, 13.1.7.2

エクスポート, 13.2.10, 24.6.9, 24.6.10

エクスポートおよびインポート, 13.2.10

異なるIDを使用したエクスポート, 13.2.4

グリッドベース, 13.1.3

インポート, 13.2.10, 24.7.5

管理, 13.1

レポート, 13.2.11, 13.2.11

ページ・レベル・テンプレートの選択, 13.3.4.1

切替え, 13.2.3

ユニバーサル・テーマへの切替え, 13.2.3.2

テーマ・スタイル, 13.1.4

テーマ・ページ, 13.1.6

使用, 13

テーマ・ページ

共有コンポーネントからのアクセス, 13.1.6

To Doレポート

カレンダ・ページ, 5.6.5.1

進捗ログ, 5.6.5.2

To Do

ファイルの添付, 5.6.4

作成, 5.6.2

管理, 5.6

To Doページ, 5.6.1

タスクの更新, 5.6.3

表示, 5.6.1

レポートの表示, 5.6.5

翻訳可能なメッセージ, 定義, 21.4.2.2 翻訳, 21.4.3

PL/SQLプロシージャでのメッセージ, 21.4.2

翻訳, 21.1

アプリケーション, 21.1

動的, 21.5

動的テキスト文字列, 21.1.5.1

動的翻訳, 21.1.5.3

手動編集, 21.3.6

テキストのエクスポート, 21.3.2

グローバリゼーション・サポート, 21.1

言語の指定, 21.1.2

プライマリ・アプリケーションIDのマッピング, 21.3.1

ターゲット・アプリケーションIDのマッピング, 21.3.1

メッセージ, 21.1.5.1, 21.1.5.2

リージョン・タイトル, 21.1.5.4

ルール, 21.1.3, 21.1.3

シード, 21.3.2

ショートカット, 21.1.5.1, 21.1.5.1

ステップ, 21.3

テンプレート, 21.1.5.5

翻訳ファイル, 21.3.2.2

理解, 21.3

アプリケーション・レンダリングの理解, 21.1.4

XLIFF, 21.3.2.2

XLIFFターゲット要素, 21.3.2.2.4

翻訳ファイル, 21.3.2.2

公開, 21.3.4

アップロード, 21.3.4

ツリー・ペイン, 8.1 ツリー

概要, 15.6.1

作成, 15.6, 15.6.4.1, 15.6.5.1

新しいページでの作成, 15.6.3

属性の編集, 15.6.4.2, 15.6.5.2

コンポーネント・ビューでの管理, 15.6.5

ページ・デザイナでの管理, 15.6.4

U

UDDIレジストリ, 25.3.4.1

ユニバーサル・テーマ

移行ガイド, 13.2.3.2

切替え, 13.2.3.2

ユニバーサル・テーマ - 42, 13.1.2, 13.1.3 生産性アプリケーションのロック解除, 3.2.7 「アプリケーションのアップグレード」アイコン, 7.13.1.5.1, 7.13.1.5.2 URL

公開, 24.9, 24.10

SSL有効, 14.7

構文, 2.7

ユーザー・アイデンティティ

証明, 20.4

確認, 2.5.3

ユーザー・インタフェース

概要, 1.1, 1.1.1

モバイル・アプリケーションについて, 2.3.3

選択について, 2.3.1

制御, 13

設計の管理, 2.3

ユーザー・インタフェース属性

新規ユーザー・インタフェースの追加, 7.5.4.2.4

構成, 7.5.4

CSSファイルURL, 7.5.4.2.3

イメージ接頭辞, 7.5.4.2.1

ロゴ, 7.5.4.2.2

メディア・タイプ, 7.5.4.2.1

静的ファイルの接頭辞, 7.5.4.2.1

ユーザー・インタフェースの検出, 7.5.4.2.3

ユーザー・インタフェース, 7.5.4.2.4

ユーザー・インタフェースのデフォルト値

エクスポート, 24.6.11

インポート, 24.7.6

ユーザー・インタフェースの詳細, 7.5.4.5

自動検出, 7.5.4.5.2

連結されたファイル, 7.5.4.5.6

コンテンツ配信ネットワーク, 7.5.4.5.4

デフォルト, 7.5.4.5.2

表示名, 7.5.4.5.1

ファイルURL, 7.5.4.5.4, 7.5.4.5.5

グローバル・ページ, 7.5.4.5.2

ホームURL, 7.5.4.5.2

jQuery移行を含める, 7.5.4.5.4

レガシーJavaScriptを含める, 7.5.4.5.4

リスト・テンプレート, 7.5.4.5.3

ログインURL, 7.5.4.5.2

ナビゲーション・リスト, 7.5.4.5.3, 7.5.4.5.3

順序, 7.5.4.5.1

テンプレート・オプション, 7.5.4.5.3

テーマ, 7.5.4.5.2

テーマ・スタイル, 7.5.4.5.2

ユーザー・インタフェース・タイプ, 7.5.4.5.1

ユーザー・ロール

開発者, 1.2.2, 20.1.1

Oracle Application Express管理者, 1.2.2, 20.1.1

ワークスペース管理者, 1.2.2, 20.1.1

ユーザー

管理について, 20.1.8.2

ユーティリティ, 7.13.1

アプリケーション用にアクセス, 7.13

V

Vファンクション, 2.9.1

検証エラー, JAWSの実行, E.3.3

検証

概要, 17.2, 17.2.1

「エラーに移動」リンクについて, E.3.3.3

アイテムとの関連付け, 11.5.2, 11.5.3

作成, 17.2.2.1, 17.2.2.2

アイテム用に作成, 17.2.2

ページ用に作成, 17.2.2, 17.2.3.2

ページ・アイテム用に作成, 17.2.3.1

表形式フォーム列用に作成, 17.2.3.3

表形式フォーム行用に作成, 17.2.3.4

エラー・メッセージとともに作成, 11.5.1

エラー・メッセージの定義, 17.2.5

編集, 17.2.3.5

「エラーに移動」リンク, 17.2.7

条件付きの作成, 17.2.6

「対象ボタン」属性, 2.10.4.32.2

「バージョン」属性, 7.5.1.2.1 ビュー, データの表示, 7.13.1.7

W

WAI-ARIAサポート, E.3.3.5

ウォレット, 作成, 20.1.6.4

Webサービス・プロセス

プロセスの編集, 25.3.11

静的値への入力パラメータのマッピング, 25.3.11

Webサービス参照, 25.3.2

作成, 25.3.4

フォームの作成, 25.3.9

フォームおよびレポートの作成, 25.3.8

手動作成, 25.3.5, 25.3.5.3

WSDLの指定, 25.3.4.2

履歴の表示, 25.3.12

Webサービス参照ページ, 25.3.2.1 Webサービス, 25.3

WSDLからの参照の作成, 25.3.4.3

RESTful Webサービスの作成, 25.3.6.2

レポートでのWebサービス結果の表示, 25.3.10.2

Webサービス・プロセスの編集, 25.3.11

プロセスとしての起動, 25.3.10

問題, 20.1.11

RESTful Webサービス

レポート・リージョンの公開, 25.3.13

プロキシ・サーバー・アドレスの指定, 25.3.2.2 SSL有効, 25.3.3 RESTful Webサービス参照のテスト, 25.3.6.3 Webサービス参照の手動でのテスト, 25.3.5.3 使用, 25.3.2 Webサービス参照履歴の表示, 25.3.12 Webサービス参照リポジトリ, 25.3.7 Webサービス参照ページ, 25.3.2.1 Webシート・アプリケーション

概要, 2.1.2.2, 6

アクセス制御リスト, 6.10

アクセス制御, 6.10

ページのコピー, 6.3

作成, 6

アクセス制御リスト・エントリの作成, 6.10.3

「アプリケーション・ビルダー」から作成, 6.2.1

実行中のWebシートからの作成, 6.2.2

削除, 6.6

ページ詳細の編集, 6.5

アクティビティの監視, 6.8

実行, 6.4

アクセス制御リスト・エントリの指定, 6.10.2

Webシート・プロパティの理解, 6.9

Webシート・ダッシュボードの表示, 6.7

Webシート認証

Application Expressアカウント, 6.9.2.5

カスタム, 6.9.2.5

LDAP, 6.9.2.5

シングル・サインオン, 6.9.2.5

Webシート・ダッシュボード, 表示, 6.7 Webシート・プロパティ

概要, 6.9.2

アクセス制御リスト・タイプ, 6.9.2.6

パブリック・アクセスを許可, 6.9.2.6

アプリケーション日付書式, 6.9.2.1

認証, 6.9.2.5

Cookieドメイン, 6.9.2.5

Cookie名, 6.9.2.5

Cookieパス, 6.9.2.5

デフォルトのアプリケーション言語, 6.9.2.1

デフォルトのアプリケーション地域, 6.9.2.1

説明, 6.9.2.2

編集, 6.9.1

SQLアクセスの編集, 6.9.2.7

ホームページ, 6.9.2.1

ログイン・メッセージ, 6.9.2.2

ロゴ, 6.9.2.3

ロゴ・タイプ, 6.9.2.3

ログアウトURL, 6.9.2.5

名前, 6.9.2.1

所有者, 6.9.2.2

セキュア, 6.9.2.5

パスワードのリセットの表示, 6.9.2.1

ステータス, 6.9.2.1

スタイル, 6.9.2.4

Webシートの電子メール送信元アドレス, 6.9.2.1

Webシート

ナビゲーションについて, 3.4.3

編集, 3.4.4

変更, 3.4.4

ナビゲート, 3.4.2

ナビゲーションの理解, 3.4.3.1

ブレッドクラムの使用, 3.4.2.1

ウィザード

ページの作成, 7.6.1

ブランチの作成, 16.5.2

カレンダの作成, 12.1

チャートの作成, 12.3

リストの作成, 18.7.3.1, 18.7.4.1

LOVの作成, 18.6.2

ページ計算の作成, 17.1.1, 17.1.3.1, 25.3.10.1

ページ・プロセスの作成, 17.3.3.1

リージョンの作成, 14.6.2

アプリケーションの作成, 2.1.3

アプリケーションの作成, 2.1

ナビゲーション・バー・エントリの作成, 12.4.4, 16.4.2.1, 16.4.2.2, 16.4.3

検証の作成, 17.2.3.1, 17.2.3.2, 17.2.3.3, 17.2.3.4

ワークスペース

ワークスペース名のリカバリ, 1.2.4.4

リクエスト, 1.2.4.1

検索, 1.3.4.1

サインイン, 1.2.4.2

サインアウト, 1.2.4.3

ワークスペース・アクティビティ・レポート

アプリケーション・エラー, 23.3.3

開発者アクティビティ, 23.3.3

環境, 23.3.3

ログイン試行回数, 23.3.3

ページ・ビューの分析, 23.3.3

ページ・ビュー, 23.3.3

セッション, 23.3.3

ワークスペース・スキーマ・レポート, 23.3.3

ワークスペース管理者, 1.2.2, 20.1.1 ワークスペースホームページ

「アクセシビリティ・モード」リージョン, 1.3.6

「管理」メニュー, 1.3.4.2

「使用可能な更新」リージョン, 1.3.5

ニュース・エントリ, 1.3.3

システム・メッセージ, 1.3.3

「トップ・アプリケーション」リージョン, 1.3.2

「トップ・ユーザー」リージョン, 1.3.2

ワークスペース名

リカバリ, 1.2.4.4

ワークスペースのニュース

管理, 5.9.8

ワークスペースの割当て, セルフ・サービスの有効化, 20.1.6.1 ワークスペース設定, 構成, 20.1.7 ワークスペーステーマ

追加, 13.2.8.1

削除, 13.2.8.3

エクスポート, 13.2.8.5

管理, 13.2.8, 13.2.9

変更,13.2.8.4

既存の表示, 13.2.8.2

スキーマへのワークスペースの割当て, 管理, 20.1.8.1 ワークスペース, 管理, 20.1.8 WSDLドキュメント, 25.3.2

X

XLIFF, 21.3.2.2

適用, 21.3.4.2

アップロードしたドキュメントの削除, 21.3.4.3

ターゲット要素, 21.3.2.2.4

アップロード, 21.3.4.1

アップロードおよび公開, 21.3.4

Z

Zipファイル

静的アプリケーション・ファイルのダウンロード, 18.3.5.2

静的ワークスペース・ファイルのダウンロード, 18.4.4.2

オラクル社の法律上の注意点について

コピーライトについて

Copyright © 1994-2015, 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）、その他の対策を講じることは使用者の責任となります。このソフトウェアもしくはハードウェアを危険が伴うアプリケーションで使用したことに起因して損害が発生しても、オラクル社およびその関連会社は一切の責任を負いかねます。

第三者のコンテンツ、製品、サービスに対する免責事項

このソフトウェアまたはハードウェア、そしてドキュメントは、第三者のコンテンツ、製品、サービスへのアクセス、あるいはそれらに関する情報を提供することがあります。オラクル社およびその関連会社は、第三者のコンテンツ、製品、サービスに関して一切の責任を負わず、いかなる保証もいたしません。オラクル社およびその関連会社は、第三者のコンテンツ、製品、サービスへのアクセスまたは使用によって損失、費用、あるいは損害が発生しても一切の責任を負いかねます。

ドラフトのアルファ版およびベータ版ドキュメントについて

このドキュメントが試作版の場合:

このドキュメントは試作版であり、デモおよび暫定使用のみを目的としたものです。このソフトウェアを使用するハードウェアに限定するものではありません。オラクル社およびその関連会社は、このドキュメントに関して一切の責任を負わず、いかなる保証もいたしません。また、このドキュメントを使用したことによって損失、費用、あるいは損害が発生しても、一切の責任を負いかねます。