Oracle® Application Express

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

リリース5.1

E83810-03(原本部品番号:E64912-05)

2017年10月

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

E83810-03

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

原本著者: Terri Jennings

原本協力者: Christina Cho、Hilary Farrell、Michael Hichwa、Joel Kallman、Sharon Kennedy、Harish Konakondla、David Peake、Anthony Rayner、Marc Sewtz、John Synders、Jason Straub、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.1での変更点

- 新機能

- 非推奨となったかサポートが終了した機能

- その他の変更

1 クイック・スタート

- 1.1 開発環境へのアクセスについて

- 1.2 Oracle Application Expressの理解

- 1.2.1 Oracle Application Expressの概要

- 1.2.2 Oracle Application Expressの仕組み

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

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

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

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

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

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

- 1.3.4.1 グローバル検索フィールド

- 1.3.4.2 「管理」メニュー

- 1.3.4.2.1 「ヘルプ」メニュー

- 1.3.4.3 「アカウント」メニュー

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

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

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

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

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

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

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

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

- 1.4.2.4 移行リンク

- 1.4.2.5 ワークスペース・ユーティリティの使用

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

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

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

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

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

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

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

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

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

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

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

- 1.5.2 パスワードの変更

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

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

- 1.7.1 Oracle Help Centerへのアクセス

- 1.7.2 Oracle Help Centerの検索

- 1.7.3 ドキュメント・ライブラリのダウンロード

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

- 1.7.4.1 Oracle Application Expressでのフィールドレベル・ヘルプの表示

- 1.7.4.2 ページ・デザイナでのヘルプの表示

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

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

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

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

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

- 2.1.3.1 データベース・アプリケーションについて

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

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

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

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

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

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

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

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

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

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

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

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

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

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

- 2.4.2 暗黙的コミット・ポイントについて

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

- 2.4.3.1 条件の概要

- 2.4.3.2 条件の選択

- 2.4.3.3 条件の例: 式1のカレント・ページ

- 2.4.3.4 条件の例: 存在する

- 2.4.3.5 条件の例: PL/SQL式

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

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

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

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

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

- 2.6.2 セッションの概要

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

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

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

- 2.6.4.2 セッション・ページの使用

- 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.8.1 セッション・ステートの参照について

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

- 2.8.2.1 セッション・ステートの設定について

- 2.8.2.2 フォーム送信によるセッション・ステートの設定について

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

- 2.8.3.1 アイテムのキャッシュのクリアについて

- 2.8.3.2 すべてのページ・アイテムのキャッシュのクリア

- 2.8.3.2.1 例: 2つのページのキャッシュのクリアおよびページ区切りのリセット

- 2.8.3.2.2 例: ページのキャッシュのクリアおよびアイテム値の引渡し

- 2.8.3.2.3 例: ページのセッション・キャッシュのクリアおよび複数のアイテムに対する値の引渡し

- 2.8.3.3 例: アプリケーション全体のキャッシュのクリア

- 2.8.3.4 アプリケーションの完全なリセットについて

- 2.8.3.5 カレント・ユーザー・セッションのキャッシュのクリアについて

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

- 2.8.4.1 バインド変数構文の使用について

- 2.8.4.2 SQL問合せまたはLOVに基づいたリージョンでのバインド変数の使用について

- 2.8.4.3 PL/SQLに基づいたリージョンでのバインド変数の使用について

- 2.8.5 セッション・クローニングについて

- 2.9 置換文字列の理解

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

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

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

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

- 2.9.4.1 APEX$ROW_NUM

- 2.9.4.2 APEX$ROW_SELECTOR

- 2.9.4.3 APEX$ROW_STATUS

- 2.9.4.4 APP_ID

- 2.9.4.5 APP_ALIAS

- 2.9.4.6 APP_AJAX_X01, ... APP_AJAX_X10

- 2.9.4.7 APP_DATE_TIME_FORMAT

- 2.9.4.8 APP_IMAGES

- 2.9.4.9 APP_NLS_DATE_FORMAT

- 2.9.4.10 APP_NLS_TIMESTAMP_FORMAT

- 2.9.4.11 APP_NLS_TIMESTAMP_TZ_FORMAT

- 2.9.4.12 APP_PAGE_ALIAS

- 2.9.4.13 APP_PAGE_ID

- 2.9.4.14 APP_REQUEST_DATA_HASH

- 2.9.4.15 APP_SESSION

- 2.9.4.16 APP_SESSION_VISIBLE

- 2.9.4.17 APP_TITLE

- 2.9.4.18 APP_UNIQUE_PAGE_ID

- 2.9.4.19 APP_USER

- 2.9.4.20 AUTHENTICATED_URL_PREFIX

- 2.9.4.21 BROWSER_LANGUAGE

- 2.9.4.22 CURRENT_PARENT_TAB_TEXT

- 2.9.4.23 DEBUG

- 2.9.4.24 HOME_LINK

- 2.9.4.25 IMAGE_PREFIX

- 2.9.4.26 JET_BASE_DIRECTORY

- 2.9.4.27 JET_CSS_DIRECTORY

- 2.9.4.28 JET_JS_DIRECTORY

- 2.9.4.29 LOGIN_URL

- 2.9.4.30 LOGOUT_URL

- 2.9.4.31 PRINTER_FRIENDLY

- 2.9.4.32 PROXY_SERVER

- 2.9.4.33 PUBLIC_URL_PREFIX

- 2.9.4.34 REQUEST

- 2.9.4.35 REQUESTの使用

- 2.9.4.35.1 ポストされたページのREQUESTの有効範囲および値について

- 2.9.4.35.2 「対象ボタン」属性について

- 2.9.4.35.3 宣言条件を使用したREQUESTの参照について

- 2.9.4.35.4 表示プロセスでのREQUESTの使用について

- 2.9.4.35.5 BRANCH_TO_PAGE_ACCEPTの使用について

- 2.9.4.36 SCHEMA OWNER

- 2.9.4.37 SQLERRM

- 2.9.4.38 SYSDATE_YYYYMMDD

- 2.9.4.39 THEME_DB_IMAGES

- 2.9.4.40 THEME_IMAGES

- 2.9.4.41 WORKSPACE_IMAGES

- 2.9.4.42 WORKSPACE_ID

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.3 サンプル・データベース・アプリケーションの理解

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

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

- 3.3.2.1 Homeページ

- 3.3.2.2 Customersページ

- 3.3.2.3 Customersページの使用

- 3.3.2.3.1 顧客の編集

- 3.3.2.3.2 顧客の作成

- 3.3.2.3.3 データのアップロード

- 3.3.2.4 Productsページ

- 3.3.2.5 Productsページの使用

- 3.3.2.5.1 製品の編集

- 3.3.2.5.2 製品の追加

- 3.3.2.6 Ordersページ

- 3.3.2.7 Ordersページの使用

- 3.3.2.7.1 注文の編集

- 3.3.2.7.2 注文の発行

- 3.3.2.8 Reportsページ

- 3.3.2.9 Administrationページ

- 3.3.2.10 モバイル・バージョンへのアクセス

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

- 3.3.3.1 サンプル・データベース・アプリケーションを変更する理由

- 3.3.3.2 サンプル・データベース・アプリケーションの編集

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

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

- 3.4.2 Webシート・ナビゲーションの理解

- 3.4.3 AnyCo IT部門の理解

- 3.4.3.1 ページ間のナビゲートおよびページ・セクションの表示

- 3.4.3.2 Homeページ

- 3.4.3.3 Projectsページ

- 3.4.3.4 Project Reviewページ

- 3.4.3.5 Systemsページ

- 3.4.3.6 Planned Purchase Review

- 3.4.3.7 Systems Budget Review

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

- 3.4.4.1 サンプルWebシート・アプリケーションを変更する理由

- 3.4.4.2 Webシート・セクションの更新

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

- 3.5.1 サービス・リクエストの作成

- 3.5.2 ワークスペース・プリファレンスの設定

- 3.5.3 ユーザーの管理

- 3.5.4 保存された対話モード・レポートの管理

- 3.5.5 対話モード・レポートのサブスクリプションの管理

- 3.5.6 アクティビティ・レポートの表示

- 3.5.7 ページ・ビューの表示

- 3.5.8 トップ・ユーザーの表示

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

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

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

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

- 3.6.4 パッケージ・アプリケーション・ページの使用

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

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

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

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

- 4.4 機能の追跡

- 4.4.1 機能レポートの表示

- 4.4.2 機能の作成

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

- 4.4.4 機能の更新

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

- 4.4.5.1 機能へのファイルの添付

- 4.4.5.2 添付ファイルの表示、編集および削除

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

- 4.4.6.1 機能ツリーの表示

- 4.4.6.2 機能カレンダの表示

- 4.4.6.3 機能履歴レポートの表示

- 4.4.6.4 機能進捗ログの表示

- 4.4.6.5 機能フォーカス領域チャートの表示

- 4.4.6.6 承認ステータスの表示

- 4.4.6.7 機能所有者チャートの表示

- 4.4.6.8 機能ユーティリティ

- 4.5 マイルストンの追跡

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

- 4.5.2 マイルストンの作成

- 4.5.3 マイルストンの更新

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

- 4.5.4.1 マイルストン・カレンダの表示

- 4.5.4.2 「所有者別のマイルストン」レポートの表示

- 4.5.4.3 「マイルストン別の機能」レポートの表示

- 4.6 To Doの追跡

- 4.6.1 To Doの表示

- 4.6.2 To Doの作成

- 4.6.3 To Doの更新

- 4.6.4 To Doに添付されたファイルの管理

- 4.6.4.1 To Doへのファイルの添付

- 4.6.4.2 添付ファイルの表示、編集および削除

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

- 4.6.5.1 To Doカレンダの表示

- 4.6.5.2 To Do進捗ログの表示

- 4.7 バグの管理

- 4.7.1 バグの表示および編集

- 4.7.2 バグの作成

- 4.7.3 バグの編集

- 4.7.4 バグに添付されたファイルの管理

- 4.7.4.1 バグへのファイルの添付

- 4.7.4.2 添付ファイルの表示、編集および削除

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

- 4.7.5.1 バグ・ダッシュボード

- 4.7.5.2 バグ・カレンダの表示

- 4.7.5.3 開発者ごとのバグの表示

- 4.7.5.4 日別のバグの表示

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

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

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

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

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

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

- 4.8.5.1 フィードバック・カレンダの表示

- 4.8.5.2 ファイリング・ユーザー別のフィードバックの表示

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

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

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

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

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

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

- 4.9.6 添付ファイルの表示

- 4.9.7 データのパージ

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

- 4.9.9 リンクの管理

- 4.9.9.1 リンク・ページへのリンクの追加

- 4.9.9.2 リンクの編集または削除

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

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

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

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

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

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

- 5.4 Webシートの実行

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

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

- 5.4.3 WebシートURLの決定

- 5.5 ページの詳細の編集

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

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

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

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

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

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

- 5.9.2.1 Webシート

- 5.9.2.2 詳細

- 5.9.2.3 ロゴ

- 5.9.2.4 スタイル

- 5.9.2.5 認証

- 5.9.2.6 認可

- 5.9.2.7 SQL

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

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

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

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

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

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

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

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

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

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

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

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

- 6.2.3.1 アプリケーションの作成ウィザードを使用したデータベース・アプリケーションのコピー

- 6.2.3.2 アプリケーションのホームページからのアプリケーションのコピー

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

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

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

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

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

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

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

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

- 6.5.1.1 アプリケーション定義の編集ページへのアクセス

- 6.5.1.2 アプリケーション定義の編集ページ

- 6.5.1.2.1 名前

- 6.5.1.2.2 プロパティ

- 6.5.1.2.3 可用性

- 6.5.1.2.4 エラー処理

- 6.5.1.2.5 グローバル通知

- 6.5.1.2.6 置換

- 6.5.1.2.7 ビルド・オプション

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

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

- 6.5.2.2 セキュリティ属性ページ

- 6.5.2.2.1 認証

- 6.5.2.2.2 認可

- 6.5.2.2.3 セッション管理

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

- 6.5.2.2.5 ブラウザ・セキュリティ

- 6.5.2.2.6 データベース・セッション

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

- 6.5.3.1 グローバリゼーション属性のページへのアクセス

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

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

- 6.5.3.2.2 アプリケーション言語の導出元

- 6.5.3.2.3 文書方向

- 6.5.3.2.4 アプリケーション日付書式

- 6.5.3.2.5 アプリケーションの日時書式

- 6.5.3.2.6 アプリケーションのタイムスタンプ書式

- 6.5.3.2.7 アプリケーションのタイムスタンプ・タイムゾーン書式

- 6.5.3.2.8 文字の値の比較

- 6.5.3.2.9 文字の値の比較動作

- 6.5.3.2.10 自動タイムゾーン

- 6.5.3.2.11 自動CSVエンコーディング

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

- 6.5.4.1 ユーザー・インタフェース属性へのアクセス

- 6.5.4.2 ユーザー・インタフェース・ページ

- 6.5.4.2.1 一般プロパティ

- 6.5.4.2.2 ロゴ

- 6.5.4.2.3 ファビコン

- 6.5.4.2.4 ユーザー・インタフェースの検出

- 6.5.4.2.5 ユーザー・インタフェース

- 6.5.4.3 アプリケーション・ロゴの定義

- 6.5.4.4 新しいユーザー・インタフェースの作成

- 6.5.4.5 ユーザー・インタフェースの詳細ページ

- 6.5.4.5.1 指定

- 6.5.4.5.2 属性

- 6.5.4.5.3 ナビゲーション・メニュー

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

- 6.5.4.5.5 JavaScript

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

- 6.5.4.5.7 連結されたファイル

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

- 6.7.2 アイテムの検索

- 6.7.3 ページの検索

- 6.7.4 問合せの検索

- 6.7.5 表の検索

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

- 6.7.7 イメージの検索

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

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

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

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

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

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

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

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

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

- 6.9.2 ページのロック

- 6.9.2.1 アプリケーションのホームページからのページのロック

- 6.9.2.2 ページ・ロック・ページからのページのロック

- 6.9.2.3 ページ・デザイナでのページのロック

- 6.9.2.4 レガシー・コンポーネント・ビューでのページのロック

- 6.9.3 ページのロック解除

- 6.9.3.1 ユーティリティからのページのロック解除

- 6.9.3.2 アプリケーションのホームページからのページのロック解除

- 6.9.3.3 ページ・デザイナでのページのロック解除

- 6.9.3.4 レガシー・コンポーネント・ビューでのページのロック解除

- 6.9.3.5 ワークスペース管理者としてのページのロック解除

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

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

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

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

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

- 6.10.4.1 特定の開発者コメントの削除

- 6.10.4.2 複数の開発者コメントの削除

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

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

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

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

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

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

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

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

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

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

- 6.13.1 ユーティリティ・ページへのアクセス

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

- 6.13.3 新しいコンポーネントを組み込むためのアプリケーションのアップグレード

- 6.13.3.1 新しいコンポーネントを組み込むためのアップグレードについて

- 6.13.3.2 アプリケーションのアップグレードの実行

- 6.13.4 「最近更新されたページ」レポートの表示

- 6.13.5 「変更履歴」レポートの表示

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

- 6.13.7 Application Expressビューへのアクセス

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

- 6.13.9 クロス・ページ・ユーティリティへのアクセス

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

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

- 6.13.11.1 保存された対話モード・レポートの削除

- 6.13.11.2 サブスクリプションの表示

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

- 7.1 ページ・デザイナについて

- 7.2 ページ・デザイナUI要素の理解

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

- 7.2.2 ページ・デザイナの左ペイン

- 7.2.3 ページ・デザイナの中央ペイン

- 7.2.3.1 「レイアウト」タブ

- 7.2.3.2 ギャラリ

- 7.2.3.3 「コンポーネント・ビュー」タブ

- 7.2.3.4 「メッセージ」タブ

- 7.2.3.5 「ページ検索」タブ

- 7.2.3.6 「ヘルプ」タブ

- 7.2.4 ページ・デザイナの右ペイン(プロパティ・エディタ)

- 7.2.5 コード・エディタ

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

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

- 7.3.2 ページの検索

- 7.3.3 3ペイン・モードと2ペイン・モードの切替え

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

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

- 7.3.6 ギャラリ・コンテキスト・メニューを使用したコンポーネントの追加について

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

- 7.3.8 「コンポーネント・ビュー」タブからのリージョン、アイテムまたはボタンの追加

- 7.3.9 リージョン、アイテムまたはボタンのコピー

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

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

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

- 7.4.1 プロパティ・エディタでのページ属性の編集

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

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

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

- 7.4.5 保存されていない変更についてユーザーに警告するためのページ属性の構成

- 7.5 ページ・デザイナからのページの実行

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

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

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

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

- 7.8.2 複数のページの削除

- 7.8.3 ページの範囲の削除

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

8 レポートの開発

- 8.1 レポート・タイプについて

- 8.1.1 対話グリッド

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

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

- 8.1.4 レポートとフォーム

- 8.2 レポートの作成

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

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

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

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

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

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

- 8.3 対話グリッドの管理

- 8.3.1 対話グリッドのリージョン属性の管理

- 8.3.1.1 対話グリッドのリージョン属性の編集

- 8.3.1.2 既存の対話グリッドからのマスター・ディテールの作成

- 8.3.1.3 対話グリッドの条件付き表示

- 8.3.2 対話グリッド属性の管理

- 8.3.2.1 対話グリッド属性の編集

- 8.3.2.2 既存の対話グリッドを編集可能にする

- 8.3.2.3 対話グリッドのページ区切りの制御

- 8.3.2.4 対話グリッド・ツールバーのカスタマイズ

- 8.3.2.5 ユーザーが対話グリッドでパブリック・レポートを保存できるようにする

- 8.3.2.6 パブリック・レポートを保存できるユーザーの制限

- 8.3.2.7 対話グリッドでのアイコン・ビューの有効化

- 8.3.2.7.1 対話グリッドへのアイコン・ビューの追加

- 8.3.2.7.2 対話グリッドへのカスタム・アイコン・ビュー・リンクの追加

- 8.3.2.8 対話グリッドでの詳細ビューの有効化

- 8.3.2.8.1 対話グリッドへの詳細ビューの追加

- 8.3.3 対話グリッドの列属性の管理

- 8.3.3.1 グリッド列属性の編集

- 8.3.3.2 フィルタのLOVとしての列定義

- 8.3.3.3 対話グリッドでの列リンクの作成

- 8.3.4 実行中のアプリケーションでの対話モードのカスタマイズについて

- 8.3.5 対話グリッドの保存

- 8.3.5.1 ユーザー・タイプが使用可能な保存オプションに及ぼす影響

- 8.3.5.2 対話グリッドを保存するときの構成の依存関係について

- 8.3.5.3 プライベート対話グリッドの保存

- 8.3.5.4 パブリック対話グリッドの保存

- 8.3.5.5 プライマリ対話グリッドの保存または名前変更

- 8.3.5.6 代替対話グリッドの保存

- 8.3.5.7 保存された対話グリッド・レポートの名前変更

- 8.3.5.8 保存された対話グリッド・レポートの削除

- 8.3.5.9 保存された対話グリッド・レポートのリセット

- 8.4 対話モード・レポートの管理

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

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

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

- 8.4.1.3 対話モード・レポートの列での条件付きリンクのフィルタ処理について

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

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

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

- 8.4.1.6.1 対話モード・レポートの検索バー

- 8.4.1.6.2 ページ・デザイナでの検索バーのカスタマイズ

- 8.4.1.6.3 ページ・デザイナでの対話モード・レポートの検索バーの削除

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

- 8.4.1.8 ページ・デザイナでの「アクション」メニューのダウンロード・オプションの構成

- 8.4.1.8.1 ダウンロード形式の有効化

- 8.4.1.8.2 CSVダウンロードの有効化

- 8.4.1.8.3 電子メール・ダウンロードの有効化

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

- 8.4.1.9.1 単一行ビューへのリンクの設定

- 8.4.1.9.2 特定のページへのリンク

- 8.4.1.9.3 URLへのリンクの設定

- 8.4.1.9.4 リンク列の除外

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

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

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

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

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

- 8.4.1.14.1 「アイコンの表示」ボタンの追加

- 8.4.1.14.2 カスタム・アイコン・ビュー・リンクの追加

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

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

- 8.4.1.16.1 ページ・デザイナでの詳細属性の構成

- 8.4.1.16.2 対話モード・レポートからの電子メール送信について

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

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

- 8.4.2.1.1 コンポーネント・ビューでの対話モード・レポートの属性ページへのアクセス

- 8.4.2.1.2 レポート属性ページへのナビゲーション方法

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

- 8.4.2.3 列グループの作成

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

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

- 8.4.2.5.1 対話モード・レポートの検索バーおよび「アクション」メニュー

- 8.4.2.5.2 検索バーおよび「アクション」メニューのカスタマイズ

- 8.4.2.5.3 検索バーの削除

- 8.4.2.5.4 「アクション」メニューの「ダウンロード」オプションの構成

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

- 8.4.2.6.1 単一行ビューへのリンクの設定

- 8.4.2.6.2 特定のページへのリンク

- 8.4.2.6.3 URLへのリンクの設定

- 8.4.2.6.4 リンク列の除外

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

- 8.4.2.7.1 別のページへの列リンクの作成

- 8.4.2.7.2 URLへの列リンクの作成

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

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

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

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

- 8.4.2.11.1 対話モード・レポートへのアイコン・ビューの追加

- 8.4.2.11.2 カスタム・アイコン・ビュー・リンクの追加

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

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

- 8.4.2.13.1 詳細属性の構成

- 8.4.2.13.2 対話モード・レポートからの電子メール送信について

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

- 8.4.2.14.1 コンポーネント・ビューでのデフォルト・レポートの別名の編集

- 8.4.2.14.2 コンポーネント・ビューでの保存されたデフォルト・レポートの削除

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

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

- 8.4.3.1 Request構文

- 8.4.3.2 Name構文およびValue構文

- 8.4.3.3 ClearCache構文

- 8.4.3.4 対話モード・レポートにリンクする際の制限

- 8.4.3.5 有効なリンクの例

- 8.4.3.6 無効なリンクの例

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

- 8.4.3.7.1 ページ・デザイナでのデフォルト・レポートの別名の編集

- 8.4.3.7.2 プライマリ・レポートへのリンクの例

- 8.4.3.7.3 保存済のレポートへのリンクの例

- 8.4.4 実行中のアプリケーションでの対話モード・レポートのカスタマイズ

- 8.4.4.1 検索バーについて

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

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

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

- 8.4.4.4.1 ユーザー・タイプおよび使用可能な保存オプションについて

- 8.4.4.4.2 構成の依存関係について

- 8.4.4.4.3 パブリックまたはプライベートの対話モード・レポートの保存

- 8.4.4.4.4 デフォルトの対話モード・レポートの保存

- 8.4.4.4.5 パブリックまたはプライベートの対話モード・レポートの名前変更

- 8.4.4.4.6 パブリックまたはプライベートの対話モード・レポートの削除

- 8.4.4.4.7 対話モード・レポートのエクスポートについて

- 8.5 クラシック・レポートの管理

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

- 8.5.2.3.1 クラシック・レポートのページ区切り

- 8.5.2.3.2 クラシック・レポートのページ区切りの制御

- 8.5.2.3.3 クラッシック・レポート内での行の後へのページ区切りの挿入

- 8.5.2.3.4 クラッシック・レポート内での行の前へのページ区切りの挿入

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

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

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

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

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

- 8.5.2.8.1 別のページへの列リンクの作成

- 8.5.2.8.2 URLへの列リンクの作成

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

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

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

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

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

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

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

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

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

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

- 8.6.4.1 ページ・デザイナでのクラシック・レポート出力属性の構成

- 8.6.4.2 コンポーネント・ビューでのクラシック・レポート出力属性の構成

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

- 8.6.5.1 ページ・デザイナでの出力用の対話モード・レポート・リージョンの構成

- 8.6.5.2 レガシー・コンポーネント・ビューでの出力用の対話モード・レポート・リージョンの構成

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

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

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

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

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

- 8.7.3 BLOBの表示について

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

9 フォームの開発

- 9.1 フォーム・タイプの理解

- 9.1.1 編集可能対話グリッド

- 9.1.2 表のフォーム

- 9.1.3 マスター・ディテール・フォーム

- 9.2 フォームの作成

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

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

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

- 9.2.4 レガシー・コンポーネント・ビューでのフォームの手動作成

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

- 9.2.4.2 フォームの処理

- 9.2.4.2.1 行の自動処理(DML)プロセスの作成

- 9.2.4.2.2 1つ以上の挿入文を含むプロセスの作成

- 9.2.4.2.3 PL/SQL APIを使用したフォーム値の処理

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

- 9.2.5 ページ・デザイナでのフォーム・リージョンの作成

- 9.3 対話グリッドを編集可能にする操作の概要

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

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

- 9.4.2 アプリケーションの作成ウィザードを使用した1ページのマスター・ディテールの作成

- 9.4.3 ページの作成ウィザードを使用した1ページのマスター・ディテールの作成

- 9.4.4 ページの作成ウィザードを使用した2ページのマスター・ディテールの作成

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

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

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

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

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

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

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

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

- 9.6.3 BLOBの表示について

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

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

- 10.1 カレンダの作成

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

- 10.1.2 サンプル・カレンダ

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

- 10.1.4 ページ・デザイナでのカレンダの作成

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

- 10.1.5.1 プロパティ・エディタでのカレンダ属性の編集

- 10.1.5.2 追加および編集機能を含めるように既存のカレンダを編集

- 10.1.5.3 カレンダ初期化JavaScriptコードの追加

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

- 10.1.6 カレンダの動的アクションのサポートについて

- 10.2 マップの作成

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

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

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

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

- 10.2.4.1 ページ・デザイナでのマップ・チャートの追加

- 10.2.4.2 ページ・デザイナでのマップ・チャート属性の編集

- 10.2.4.3 カスタムXMLとマップ・チャートの使用

- 10.2.4.4 自動更新の有効化

- 10.2.5 レガシー・コンポーネント・ビューでのマップ・チャートの管理

- 10.2.5.1 コンポーネント・ビューでのマップ・チャートの追加

- 10.2.5.2 マップ・チャート属性の編集

- 10.2.5.3 カスタムXMLとマップ・チャートの使用

- 10.2.5.4 非同期更新の有効化

- 10.3 チャートの作成

- 10.3.1 サポートされるチャートについて

- 10.3.2 サンプル・チャート

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

- 10.3.4 チャートの管理

- 10.3.4.1 ページ・デザイナでのチャートの追加

- 10.3.4.2 ページ・デザイナでのチャート属性の編集

- 10.3.4.3 ページ・デザイナでのチャート・タイプの切替え

- 10.3.4.4 自動リフレッシュの有効化

- 10.3.4.4.1 「自動リフレッシュ」属性の有効化

- 10.3.4.4.2 ページ・デザイナでのリフレッシュ動的アクションの作成

- 10.3.5 カスタムJavaScriptとチャートの使用

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

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

- 10.4.1.1 ヘルプの作成について

- 10.4.1.2 ページ・デザイナでのヘルプ・ページおよびヘルプ・リージョンの作成

- 10.4.1.3 ページ・デザイナでのページ・ヘルプの定義

- 10.4.1.4 ページ・デザイナでのアイテム・ヘルプの定義

- 10.4.2 レガシー・コンポーネント・ビューでのヘルプの作成

- 10.4.2.1 ヘルプの作成について

- 10.4.2.2 コンポーネント・ビューでのヘルプ・ページおよびヘルプ・リージョンの作成

- 10.4.2.3 コンポーネント・ビューでのページ・ヘルプの定義

- 10.4.2.4 コンポーネント・ビューでのアイテム・ヘルプの定義

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

- 10.4.3.1 「アイテム・ヘルプをバルク編集」レポートの使用

- 10.4.3.2 アイテム・ヘルプ・トピックのシード

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

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

- 11.1 テーマの使用

- 11.1.1 テーマについて

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

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

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

- 11.1.4.1 テーマ・スタイルについて

- 11.1.4.2 テーマ・スタイルの作成

- 11.1.4.3 テーマ・ページからのテーマ・スタイルの編集

- 11.1.4.4 ユーザー・インタフェース・ページからのテーマ・スタイルの編集

- 11.1.4.5 ユーザーによるテーマ・スタイルの選択の可能化

- 11.1.4.6 テーマ・ローラーの使用

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

- 11.1.5.1 テンプレート・オプションについて

- 11.1.5.2 デフォルト・テンプレート・オプションについて

- 11.1.5.3 テンプレート・オプション・グループおよび事前設定について

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

- 11.1.7 テーマの編集

- 11.1.7.1 テーマの編集

- 11.1.7.2 テーマ属性

- 11.1.7.2.1 名前

- 11.1.7.2.2 テーマのサブスクリプション

- 11.1.7.2.3 JavaScriptおよびカスケード・スタイルシート

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

- 11.1.7.2.5 リージョンのデフォルト値

- 11.1.7.2.6 ダイアログのデフォルト

- 11.1.7.2.7 遷移のデフォルト値

- 11.1.7.2.8 グローバル・テンプレート・オプション

- 11.1.7.2.9 アイコン

- 11.1.7.2.10 イメージ

- 11.1.7.2.11 スタイル

- 11.1.7.2.12 ファイル

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

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

- 11.2.1.1 テーマのサブスクリプションについて

- 11.2.1.2 テーマのサブスクリプションの変更について

- 11.2.1.3 テーマのリフレッシュが必要かどうかの検証

- 11.2.1.4 サブスクライブされたテーマのリフレッシュ

- 11.2.1.5 テーマのサブスクライブ解除

- 11.2.1.6 組込みテーマの再サブスクライブ

- 11.2.2 テーマの作成

- 11.2.3 テーマの切替え

- 11.2.3.1 アクティブなテーマの切替えについて

- 11.2.3.2 ユニバーサル・テーマへの切替えについて

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

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

- 11.2.5 テーマのコピー

- 11.2.6 テーマの削除

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

- 11.2.7.1 新規アプリケーションの作成によるマスター・テーマ・アプリケーションの作成

- 11.2.7.2 既存のアプリケーションからのマスター・テーマ・アプリケーションの作成

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

- 11.2.8.1 テーマ・リポジトリへのワークスペース・テーマの追加

- 11.2.8.2 既存のワークスペース・テーマの表示

- 11.2.8.3 ワークスペース・テーマの削除

- 11.2.8.4 ワークスペース・テーマの変更

- 11.2.8.5 ワークスペース・テーマのエクスポート

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

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

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

- 11.2.11.1 テーマのすべてのテンプレートの表示

- 11.2.11.2 テーマ・テンプレート数の表示

- 11.2.11.3 ファイル参照の表示

- 11.2.11.4 クラス参照の表示

- 11.2.11.5 テンプレート置換文字列の表示

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

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

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

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

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

- 11.3.4.1 テーマ内のページ・レベル・テンプレートの選択

- 11.3.4.2 特定のページのページ・レベル・テンプレートの選択

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

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

- 11.3.6.1 グローバル・テンプレート・オプション・グループの管理

- 11.3.6.1.1 グローバル・テンプレート・オプション・グループの作成

- 11.3.6.1.2 グローバル・テンプレート・オプション・グループの編集

- 11.3.6.2 グローバル・テンプレート・オプションの管理

- 11.3.6.2.1 グローバル・テンプレート・オプションの作成

- 11.3.6.2.2 グローバル・テンプレート・オプションの編集

- 11.3.6.3 テンプレート・オプションの管理

- 11.3.6.3.1 テンプレート・オプションの作成

- 11.3.6.3.2 テンプレート・オプションの編集

- 11.3.6.3.3 ライブ・テンプレート・オプションを変更するためのクイック編集の使用

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

- 11.3.8 テンプレートの管理

- 11.3.8.1 テンプレート・ページでのテンプレートの表示

- 11.3.8.2 特定のページに関連付けられているテンプレートの表示

- 11.3.8.3 テンプレートの置換

- 11.3.8.4 アプリケーション内のすべてのテンプレートの置換

- 11.3.8.5 ページ・テンプレート別のリージョン位置の使用状況の表示

- 11.3.8.6 テンプレートのサブスクライブ解除

- 11.3.8.7 テンプレートのパブリッシュ

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

- 11.3.9.1 ブレッドクラム・スタイルのナビゲーションについて

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

- 11.3.9.2.1 名前

- 11.3.9.2.2 定義

- 11.3.9.2.3 置換文字列

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

- 11.3.10.1 ボタン・テンプレート属性

- 11.3.10.1.1 名前

- 11.3.10.1.2 定義

- 11.3.10.1.3 置換文字列

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

- 11.3.11.1 サポートされるレガシー・カレンダ・テンプレートの置換文字列

- 11.3.11.2 レガシー・カレンダ・テンプレート属性

- 11.3.11.2.1 名前

- 11.3.11.2.2 サブスクリプション

- 11.3.11.2.3 コメント

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

- 11.3.12.1 ラベル・テンプレート属性

- 11.3.12.1.1 名前

- 11.3.12.1.2 定義

- 11.3.12.1.3 エラー表示

- 11.3.12.1.4 フィールド・コンテナ

- 11.3.12.1.5 置換文字列

- 11.3.12.2 #CURRENT_ITEM_HELP_TEXT#を使用したアイテム・ヘルプの作成について

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

- 11.3.13.1 階層リストについて

- 11.3.13.2 リスト・テンプレート属性

- 11.3.13.2.1 名前

- 11.3.13.2.2 リスト前のエントリ

- 11.3.13.2.3 テンプレート定義

- 11.3.13.2.4 最初のエントリのテンプレート定義

- 11.3.13.2.5 サブリスト・エントリ前

- 11.3.13.2.6 サブリスト・エントリ

- 11.3.13.2.7 サブリスト後のエントリ

- 11.3.13.2.8 リスト後のエントリ

- 11.3.13.2.9 置換文字列

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

- 11.3.14.1 ページ・テンプレート属性

- 11.3.14.1.1 名前

- 11.3.14.1.2 定義

- 11.3.14.1.3 JavaScript

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

- 11.3.14.1.5 サブテンプレート

- 11.3.14.1.6 イメージ・ベースのタブ属性

- 11.3.14.1.7 レイアウト

- 11.3.14.1.8 表示ポイント

- 11.3.14.1.9 ダイアログ

- 11.3.14.1.10 エラー・ページ・テンプレートの制御

- 11.3.14.1.11 置換文字列

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

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

- 11.3.15.1 ポップアップLOVテンプレート属性

- 11.3.15.1.1 検索フィールド

- 11.3.15.1.2 ボタン

- 11.3.15.1.3 ウィンドウ

- 11.3.15.1.4 ページ区切り

- 11.3.15.1.5 結果セット

- 11.3.15.1.6 ページ属性

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

- 11.3.16.1 リージョン・テンプレート属性

- 11.3.16.1.1 名前

- 11.3.16.1.2 定義

- 11.3.16.1.3 レイアウト

- 11.3.16.1.4 サブリージョン

- 11.3.16.1.5 置換文字列

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

- 11.3.17.1 汎用列テンプレートおよび名前付き列テンプレート

- 11.3.17.1.1 汎用列テンプレート

- 11.3.17.1.2 名前付き列テンプレート

- 11.3.17.2 汎用列テンプレートのレポート列テンプレート属性

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

- 11.3.17.2.2 行の前

- 11.3.17.2.3 列ヘッダー

- 11.3.17.2.4 各行の前

- 11.3.17.2.5 列テンプレート

- 11.3.17.2.6 各行の後

- 11.3.17.2.7 行の後

- 11.3.17.2.8 行選択

- 11.3.17.2.9 ページ区切りサブテンプレート

- 11.3.17.2.10 コメント

- 11.3.17.3 名前付き列テンプレートのレポート列テンプレート属性

- 11.3.17.3.1 名前

- 11.3.17.3.2 サブスクリプション

- 11.3.17.3.3 行テンプレート

- 11.3.17.3.4 列ヘッダー

- 11.3.17.3.5 最初の行の前と最後の行の後のテキスト

- 11.3.17.3.6 ページ区切り

- 11.3.17.3.7 コメント

- 11.3.17.4 列テンプレートでのJavaScriptの使用について

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

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

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

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

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

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

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

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

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

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

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

- 12.4 リージョンについて

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

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

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

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

- 12.5.2.2 リージョン位置の制御

- 12.5.2.3 リージョンのヘッダーおよびフッターの指定

- 12.5.2.4 ユーザーによるページのカスタマイズの可能化

- 12.5.2.5 ページ・デザイナでのリージョン・キャッシュの使用

- 12.5.2.5.1 リージョン・キャッシュについて

- 12.5.2.5.2 ページ・デザイナでのリージョン・キャッシュの有効化

- 12.5.2.6 静的リージョンIDの指定

- 12.5.2.7 リージョン・イメージの追加

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

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

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

- 12.6 レガシー・コンポーネント・ビューでのリージョンの管理

- 12.6.1 リージョンの作成ウィザード実行時のリージョン・タイプ

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

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

- 12.6.3.1 コンポーネント・ビューでのリージョン属性の編集

- 12.6.3.2 リージョン属性がページ・レイアウトに与える影響

- 12.6.3.2.1 ページ・レイアウトに影響を与えるコンポーネント・ビューのリージョン属性

- 12.6.3.2.2 コンポーネント・ビューでのリージョン位置の制御

- 12.6.3.3 リージョンのヘッダーおよびフッターの指定

- 12.6.3.4 ユーザーによるページのカスタマイズの可能化

- 12.6.3.5 コンポーネント・ビューでのリージョン・キャッシュの使用

- 12.6.3.5.1 リージョン・キャッシュについて

- 12.6.3.5.2 リージョン・キャッシュの有効化

- 12.6.3.5.3 キャッシュされたリージョンの管理

- 12.6.3.6 静的リージョンIDの指定

- 12.6.3.7 リージョン・イメージの追加

- 12.6.3.8 コンポーネント・ビューでの複数リージョンの同時編集

- 12.6.3.8.1 すべてのリージョンにわたる複数の属性の編集

- 12.6.3.8.2 リージョン・ユーティリティへのアクセス

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

- 12.6.3.9.1 サブリージョンの使用について

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

- 12.6.3.9.3 リージョン属性の編集によるサブリージョンの作成

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

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

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

- 12.6.6.1 リージョンの削除

- 12.6.6.2 複数リージョンの同時削除

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

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

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

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

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

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

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

- 13.1.3 アイテム値の参照

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

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

- 13.1.5.1 複数の選択リスト・アイテムから返された値の処理について

- 13.1.5.2 APEX_UTIL.STRING_TO_TABLEを使用した選択値の変換

- 13.1.5.3 シャトル・アイテムの作成

- 13.1.5.3.1 表でのレポートおよびフォームの作成

- 13.1.5.3.2 ページ・デザイナのフォーム・ページでのシャトル・アイテムの作成

- 13.1.5.3.3 コンポーネント・ビューのフォーム・ページでのシャトル・アイテムの作成

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

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

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

- 13.2.2.1 「レンダリング」タブからのページ・レベル・アイテムの作成

- 13.2.2.2 「ギャラリ」からのページ・レベル・アイテムの追加

- 13.2.2.3 静的値リストの作成

- 13.2.2.3.1 例1: アルファベット順で表示される4つの値

- 13.2.2.3.2 例2: リストされた順序で表示される10の値

- 13.2.2.3.3 例3: 戻り値と表示値の両方を持つ値リスト

- 13.2.2.4 カスケードLOVの作成

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

- 13.2.3.1 プロパティ・エディタでのページ・アイテム属性の編集

- 13.2.3.2 ページ・アイテムのデフォルト値の定義

- 13.2.3.3 ページ・アイテムのセキュリティの構成

- 13.2.3.4 クイック選択の作成

- 13.2.3.5 条件付きページ・アイテムの表示

- 13.2.3.6 読取り専用ページ・アイテムの表示

- 13.2.3.7 保存されていない変更についてユーザーに警告するためのアイテム属性の構成

- 13.2.3.8 アイテム・ユーティリティの表示

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

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

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

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

- 13.3.2.2 静的値リストの作成

- 13.3.2.2.1 例1: アルファベット順で表示される4つの値

- 13.3.2.2.2 例2: リストされた順序で表示される10の値

- 13.3.2.2.3 例3: 戻り値と表示値の両方を持つ値リスト

- 13.3.2.3 カスケードLOVの作成

- 13.3.2.4 表形式フォームを使用した複数のアイテムの作成

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

- 13.3.3.1 コンポーネント・ビューでのページ・アイテム属性の編集

- 13.3.3.2 デフォルト値の定義

- 13.3.3.3 ページ・アイテムのセキュリティの構成

- 13.3.3.4 クイック選択の作成

- 13.3.3.5 条件付きページ・アイテムの表示

- 13.3.3.6 読取り専用ページ・アイテムの表示

- 13.3.3.7 複数のアイテムの同時編集

- 13.3.3.7.1 複数のアイテムの編集

- 13.3.3.7.2 リージョン・アイテムの再割当て

- 13.3.3.7.3 複数のアイテムの削除

- 13.3.3.7.4 アイテム・ユーティリティの表示

- 13.3.3.7.5 ページ・アイテム履歴の表示

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

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

- 13.4.2 動的アクションの例の表示

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

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

- 13.4.4.1 ページ・デザイナでの動的アクションの作成

- 13.4.4.2 ページ・デザイナでの動的アクションの編集

- 13.4.4.3 動的アクションのイベント有効範囲の定義

- 13.4.4.4 ページ・デザイナでの動的アクションの削除

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

- 13.4.5.1 コンポーネント・ビューでの動的アクションの作成

- 13.4.5.2 コンポーネント・ビューでの動的アクションの編集

- 13.4.5.3 Trueアクションの追加

- 13.4.5.3.1 Trueアクションの追加について

- 13.4.5.3.2 Trueアクションの追加

- 13.4.5.4 頻度と有効範囲の定義

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

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

- 13.4.7.1 動的アクションのデバッグについて

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

- 13.5 ボタンの作成

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

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

- 13.5.2.1 ページ・デザイナでのボタンの作成

- 13.5.2.2 ページ・デザイナでのボタンの編集

- 13.5.2.3 ボタンの条件付き表示

- 13.5.2.4 保存されていない変更についてユーザーに警告するためのボタン属性の構成

- 13.5.3 レガシー・コンポーネント・ビューでのボタンの管理

- 13.5.3.1 コンポーネント・ビューでのボタンの作成

- 13.5.3.2 コンポーネント・ビューでの複数のボタンの作成

- 13.5.3.3 レガシー・コンポーネント・ビューでのボタンの編集

- 13.5.3.3.1 ボタン属性の編集

- 13.5.3.3.2 「検証の実行」について

- 13.5.3.3.3 複数のボタンの同時編集

- 13.5.3.4 ボタンの条件付き表示

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

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

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

- 13.6 ツリーの作成

- 13.6.1 ツリーについて

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

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

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

- 13.6.3.2 ページ・デザイナでのツリーの作成

- 13.6.3.3 ページ・デザイナでのツリー属性の編集

- 13.6.4 レガシー・コンポーネント・ビューでのツリーの管理

- 13.6.4.1 コンポーネント・ビューでのツリーの作成

- 13.6.4.2 コンポーネント・ビューでのツリー属性の編集

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

14 ナビゲーションの追加

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

- 14.2 タブの作成

- 14.2.1 タブについて

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

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

- 14.2.4 タブの作成

- 14.2.5 タブの編集

- 14.2.5.1 複数のタブの同時編集

- 14.2.5.2 標準タブの管理

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

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

- 14.3.1 ブレッドクラムとは

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

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

- 14.3.3.1 ブレッドクラムの手動作成について

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

- 14.3.3.2.1 共有コンポーネントとしてのブレッドクラムの作成

- 14.3.3.2.2 ページ・デザイナでのブレッドクラム・リージョンの作成

- 14.3.3.2.3 コンポーネント・ビューからのブレッドクラムの作成

- 14.3.3.3 ブレッドクラム・エントリの追加

- 14.3.3.4 ブレッドクラム・リージョンの追加

- 14.3.3.4.1 ページ・デザイナでのブレッドクラム・リージョンの追加

- 14.3.3.4.2 レガシー・コンポーネント・ビューでのブレッドクラム・リージョンの追加

- 14.3.3.5 動的ブレッドクラムの作成について

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

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

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

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

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

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

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

- 14.4.2.1 ナビゲーション・バー・エントリを最初から作成

- 14.4.2.2 フィードバック用ナビゲーション・バー・エントリの作成

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

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

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

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

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

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

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

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

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

- 15.1 ページ計算の理解

- 15.1.1 ページ計算について

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

- 15.1.2.1 ページ・デザイナでのページ計算の作成

- 15.1.2.2 ページ・デザイナでのページ計算属性の編集

- 15.1.2.3 計算ポイントおよびソースの編集について

- 15.1.2.4 条件付き計算の作成について

- 15.1.3 レガシー・コンポーネント・ビューでのページ計算の管理

- 15.1.3.1 コンポーネント・ビューでのページ計算の作成

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

- 15.1.3.3 計算ポイントおよびソースの編集について

- 15.1.3.4 条件付き計算の作成について

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

- 15.2 検証の理解

- 15.2.1 検証について

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

- 15.2.2.1 ページ・デザイナでの 検証の作成

- 15.2.2.2 ページ・デザイナでの検証の編集

- 15.2.3 レガシー・コンポーネント・ビューでの検証の管理

- 15.2.3.1 ページ・アイテムの検証の作成

- 15.2.3.2 ページ全体の検証の作成

- 15.2.3.3 表形式フォーム列の検証の作成

- 15.2.3.4 表形式フォーム行の検証の作成

- 15.2.3.5 コンポーネント・ビューでの検証の編集

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

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

- 15.2.6 検証の条件付き実行

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

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

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

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

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

- 15.3.2.1 ページ・デザイナでのページ・プロセスの作成

- 15.3.2.2 ページ・デザイナでのページ・プロセス属性の編集

- 15.3.2.3 ページ・デザイナでページ・プロセスを実行するタイミングの制御

- 15.3.2.4 ページ・デザイナでのページ・プロセスの成功メッセージとエラー・メッセージの作成

- 15.3.2.5 ページ・デザイナでのページ・プロセス条件の作成

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

- 15.3.3.1 コンポーネント・ビューでのページ・プロセスの作成

- 15.3.3.1.1 ページ・プロセスの作成

- 15.3.3.1.2 表形式フォームのページ・プロセスの作成

- 15.3.3.2 コンポーネント・ビューでのページ・プロセス属性の編集

- 15.3.3.3 ページ・プロセスを実行するタイミングの制御

- 15.3.3.4 ページ・プロセスの成功メッセージとエラー・メッセージの作成

- 15.3.3.5 ページ・プロセスを条件付きにする

- 15.4 ブランチについて

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

- 16.1.4.1 アプリケーション・ロジック

- 16.1.4.2 セキュリティ

- 16.1.4.3 他のコンポーネント

- 16.1.4.4 ナビゲーション

- 16.1.4.5 ユーザー・インタフェース

- 16.1.4.6 ファイル

- 16.1.4.7 データ参照

- 16.1.4.8 レポート

- 16.1.4.9 グローバリゼーション

- 16.1.4.10 「タスク」リージョン

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

- 16.2.1 「コンポーネント設定」の構成

- 16.2.2 Googleカレンダとの統合

- 16.2.3 カラー・ピッカーの表示の構成

- 16.2.4 対話モード・レポートの「アクション」メニュー構造の構成

- 16.2.5 リージョンへのスライダの動的追加

- 16.2.6 スイッチのデフォルト値の構成

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

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

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

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

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

- 16.3.4 静的アプリケーション・ファイルの参照

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

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

- 16.3.5.2 すべての静的アプリケーション・ファイルのZipでのダウンロード

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

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

- 16.3.6.2 すべての静的アプリケーション・ファイルの削除

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

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

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

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

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

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

- 16.4.4.2 すべての静的ワークスペース・ファイルのZipでのダウンロード

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

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

- 16.4.5.2 すべての静的ワークスペース・ファイルの削除

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

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

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

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

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

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

- 16.6.1 値リストとは

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

- 16.6.3 静的LOVについて

- 16.6.4 既存のLOVの編集

- 16.6.4.1 LOVの編集

- 16.6.4.2 LOVのバルク編集

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

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

- 16.7 リストの作成

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

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

- 16.7.3 静的リストの作成

- 16.7.3.1 静的リストの作成プロセスについて

- 16.7.3.2 静的リストを最初から作成

- 16.7.3.3 静的リストへのエントリとサブリストの追加について

- 16.7.3.4 エントリまたはサブリストを最初から追加

- 16.7.3.5 リスト間での静的リスト・エントリのコピー

- 16.7.3.6 静的リスト・エントリの親の変更

- 16.7.3.7 孤立した静的リスト・エントリの管理

- 16.7.3.8 静的リスト・エントリの順序変更

- 16.7.4 動的リストの作成

- 16.7.4.1 動的リストの作成プロセスについて

- 16.7.4.2 動的リスト構文の理解

- 16.7.4.3 動的リストを最初から作成

- 16.7.5 リストのコピー

- 16.7.5.1 カレント・アプリケーションからのリストのコピー

- 16.7.5.2 アプリケーション間でのリストのコピー

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

- 16.7.7 リスト属性の編集

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

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

- 16.8.1 ショートカットとは

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

- 16.8.2.1 サポートされるショートカット・タイプ

- 16.8.2.2 エスケープされた一重引用符を持つJavaScriptのテキスト

- 16.8.2.3 メッセージ

- 16.8.2.4 エスケープされた一重引用符を持つJavaScriptのメッセージ

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

- 16.8.3.1 ショートカットを最初から定義

- 16.8.3.2 既存のショートカットのコピー

- 16.8.3.3 ショートカットの参照

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

- 16.8.5 ショートカット・レポートへのアクセス

- 16.9 レポート出力の管理

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

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

- 16.9.1.2 レポート問合せの作成

- 16.9.1.3 レポート問合せの編集

- 16.9.1.4 レポート問合せのコピー

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

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

- 16.9.2.2 レポート・レイアウト・オプションの概要

- 16.9.2.3 レポート・レイアウトの作成

- 16.9.2.4 レポート・レイアウトの編集

- 16.9.2.5 レポート・レイアウトのコピー

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

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

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

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

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

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

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

- 17.3 Webサービスの実装

- 17.3.1 Webサービスについて

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

- 17.3.2.1 Webサービス参照ページへのアクセス

- 17.3.2.2 アプリケーション・プロキシ・サーバー・アドレスの指定

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

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

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

- 17.3.4.2 WSDLドキュメントの指定によるWebサービス参照の作成

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

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

- 17.3.5.1 Webサービス参照の手動作成について

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

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

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

- 17.3.6.1 RESTful Webサービス参照の作成について

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

- 17.3.6.3 REST Webサービス参照のテスト

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

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

- 17.3.8.1 Webサービスのフォームとレポートの作成ウィザードについて

- 17.3.8.2 参照を作成した後のフォームとレポートの作成

- 17.3.8.3 新しいページの追加によるフォームとレポートの作成

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

- 17.3.9.1 Webサービスのフォームの作成ウィザードについて

- 17.3.9.2 参照を作成した後のフォームの作成

- 17.3.9.3 新しいページの追加によるフォームの作成

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

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

- 17.3.10.2 レポートでのWebサービス結果の表示

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

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

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

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

- 17.3.13.2 レポート・リージョンへのRESTfulアクセスの有効化

- 17.3.13.3 Webサービス・クライアントからのRESTful有効レポート・リージョンへのアクセスについて

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

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

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

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

- 17.5 DMLロックについて

- 17.5.1 DMLロックについて

- 17.5.2 APEX_DML_LOCK_WAIT_TIME

- 17.5.3 FSP_DML_LOCK_ROW

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

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

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

- 18.1.1.1 ネットワーク・サービスの有効化について

- 18.1.1.2 完全開発環境での電子メールの構成について

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

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

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

- 18.2 プラグインの実装

- 18.2.1 プラグインについて

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

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

- 18.2.4 プラグインの作成

- 18.2.5 プラグインの編集

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

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

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

- 18.2.7.2 CSSおよびJavaScriptファイルの自動ロード

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

- 18.2.9 プラグインの削除

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

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

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

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

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

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

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

- 18.3.1 Application Expressリリース4.Xから5.1にアップグレードする場合の互換性の問題について

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

- 18.3.2.1 その他のjQuery UIコンポーネントへのアクセスについて

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

- 18.3.3.1 アプリケーションでのJavaScriptコードの管理について

- 18.3.3.2 プラグインでのJavaScriptコードの使用について

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

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

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

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

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

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

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

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

- 19.1.5.1 ログイン制御の作成について

- 19.1.5.2 パブリック・ファイルのアップロードの有効化について

- 19.1.5.3 IPアドレスによるユーザー・アクセスの制限について

- 19.1.5.4 インスタンス・プロキシの指定について

- 19.1.5.5 Secure Sockets Layerの使用について

- 19.1.5.6 RESTfulアクセスの有効化について

- 19.1.5.7 「セッションを再結合」について

- 19.1.5.8 ワークスペースの分離について

- 19.1.5.9 セッション・タイムアウトの使用について

- 19.1.5.10 パスワードの再利用の制限

- 19.1.5.11 WebシートでのSQLの使用について

- 19.1.5.12 RESTfulサービスの有効化について

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

- 19.1.6.1 ワークスペースのセルフ・サービス割当ての有効化について

- 19.1.6.2 電子メールの有効化および構成について

- 19.1.6.3 記憶域オプションの構成について

- 19.1.6.4 ウォレットの作成について

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

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

- 19.1.8.1 スキーマへのワークスペースの割当ての管理について

- 19.1.8.2 開発者およびユーザーの管理について

- 19.1.8.3 コンポーネントの可用性の管理について

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

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

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

- 19.1.11.1 ネットワーク・サービスを有効化する必要があるタイミングと理由

- 19.1.11.2 Oracle Database 12c以前での接続権限の付与

- 19.1.11.3 Oracle Database 12cでの接続権限の付与

- 19.1.11.4 無効なACLエラーのトラブルシューティング

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

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

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

- 19.2.2.1 「セキュリティ・プロファイル」レポートの表示

- 19.2.2.2 「パスワード・アイテム」レポートの表示

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

- 19.2.3.1 クロスサイト・スクリプティング・セキュリティ攻撃の概要

- 19.2.3.2 HTMLリージョンなどの静的領域の保護

- 19.2.3.2.1 HTMLリージョンなどの静的領域の保護について

- 19.2.3.2.2 安全なアイテム表示タイプについて

- 19.2.3.2.3 値をエスケープするかどうかを決定するために使用されるルールについて

- 19.2.3.2.4 安全なアイテム・タイプを使用したHTMLマークアップの保持および表示について

- 19.2.3.3 動的出力の保護について

- 19.2.3.4 レポート・リージョンの保護について

- 19.2.3.5 フォーム・アイテムの保護について

- 19.2.3.6 アイテムに入力する文字の制限について

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

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

- 19.2.5.1 セッション・ステート保護の仕組み

- 19.2.5.2 セッション・ステート保護の有効化

- 19.2.5.2.1 「セキュリティ属性の編集」からのセッション・ステート保護の有効化

- 19.2.5.2.2 「セッション・ステート保護」からのセッション・ステート保護の有効化

- 19.2.5.3 セッション・ステート保護の構成

- 19.2.5.3.1 セッション・ステート保護の構成について

- 19.2.5.3.2 既存のセッション・ステート保護設定の確認

- 19.2.5.3.3 ウィザードを使用したセッション・ステート保護の構成

- 19.2.5.3.4 ページのセッション・ステート保護の構成

- 19.2.5.3.5 ページ・アイテムのセッション・ステート保護の構成

- 19.2.5.3.6 アプリケーション・アイテムのセッション・ステート保護の構成

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

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

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

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

- 19.3.2.1 アプリケーションのホームページからのアクセス制御リストの作成

- 19.3.2.2 ページ編集中のアクセス制御の作成

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

- 19.3.3.1 アプリケーション・モードの選択

- 19.3.3.2 アクセス制御リストへのユーザーの追加と権限の選択

- 19.3.3.3 アクセス制御リストからのユーザーの削除

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

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

- 19.4.1 認証の理解

- 19.4.1.1 認証の仕組み

- 19.4.1.2 ディープ・リンクのサポートについて

- 19.4.1.3 認証を含めるかどうかの決定について

- 19.4.2 認証スキームの作成

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

- 19.4.3.1 Application Expressアカウント

- 19.4.3.1.1 Application Expressアカウントについて

- 19.4.3.1.2 Application Expressアカウント認証の設定

- 19.4.3.2 カスタム認証

- 19.4.3.2.1 カスタム認証について

- 19.4.3.2.2 カスタム認証の設定

- 19.4.3.2.3 セッション管理セキュリティについて

- 19.4.3.3 データベース・アカウント

- 19.4.3.3.1 データベース・アカウント資格証明について

- 19.4.3.3.2 データベース・アカウント資格証明の設定

- 19.4.3.4 HTTPヘッダー変数

- 19.4.3.4.1 HTTPヘッダー変数について

- 19.4.3.4.2 HTTPヘッダー変数の設定

- 19.4.3.5 LDAPディレクトリの検証

- 19.4.3.5.1 LDAPディレクトリの検証について

- 19.4.3.5.2 LDAPディレクトリの検証の設定

- 19.4.3.6 認証なし(DADを使用)

- 19.4.3.6.1 DAD資格証明の検証について

- 19.4.3.6.2 DAD資格証明の検証の設定

- 19.4.3.7 公開資格証明

- 19.4.3.7.1 公開資格証明について

- 19.4.3.7.2 公開資格証明の設定

- 19.4.3.8 Oracle Application Server Single Sign-On Server

- 19.4.3.8.1 Application Server Single Sign-On Serverについて

- 19.4.3.8.2 Oracle Application Server Single Sign-Onの設定

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

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

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

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

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

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

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

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

- 19.5.2.1 認可スキーム・タイプについて

- 19.5.2.2 認可スキームの作成

- 19.5.2.3 既存の認可スキーム属性の編集

- 19.5.2.4 評価ポイント属性の変更

- 19.5.2.5 認可スキーム・ステートのリセットについて

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

- 19.5.3.1 アプリケーションへの認可スキームの割当て

- 19.5.3.2 ページへの認可スキームの割当て

- 19.5.3.3 コントロールまたはコンポーネントへの認可スキームの割当て

- 19.5.4 認可レポートの表示

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

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

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

- 20.1.2 言語の指定について

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

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

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

- 20.1.5.1 メッセージの言語変換をサポートするショートカットについて

- 20.1.5.2 メッセージについて

- 20.1.5.3 テキスト文字列の動的翻訳について

- 20.1.5.4 リージョン・タイトルの翻訳について

- 20.1.5.4.1 ページ・デザイナでリージョンを翻訳不可に指定

- 20.1.5.4.2 レガシー・コンポーネント・ビューでリージョンを翻訳不可に指定

- 20.1.5.5 翻訳テンプレートについて

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

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

- 20.3.1 アイテムへの書式マスクの適用について

- 20.3.2 アイテム属性の編集例

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

- 20.5 翻訳プロセスの理解

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

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

- 20.5.2.1 翻訳可能なテキストのシード

- 20.5.2.2 XLIFFファイルのダウンロード

- 20.5.2.2.1 XLIFFのエクスポート・ページについて

- 20.5.2.2.2 アプリケーションのXLIFFファイルのダウンロード

- 20.5.2.2.3 アプリケーション・ページのXLIFFファイルのダウンロード

- 20.5.2.2.4 含まれるXLIFFターゲット要素について

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

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

- 20.5.4.1 翻訳済XLIFFドキュメントのアップロード

- 20.5.4.2 アップロードしたXLIFFドキュメントの適用

- 20.5.4.3 アップロードしたXLIFFドキュメントの削除

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

- 20.5.6 翻訳の手動編集

- 20.6 メッセージの翻訳

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

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

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

- 20.6.2.2 翻訳メッセージの定義

- 20.6.3 翻訳が必要な対話グリッドのメッセージ

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

- 20.6.4.1 テキスト・メッセージの作成

- 20.6.4.2 テキスト・メッセージの編集

- 20.6.4.3 翻訳が必要な内部メッセージ

- 20.6.4.4 翻訳が必要な対話モード・レポートのメッセージ

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

- 20.7.1 動的翻訳の定義

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

- 21.8.2 APEX_ACTIVITY_LOG

- 21.8.3 APEX_ACTIVITY_LOGのサンプル問合せ

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 ウォーターフォール

- 23.2.4 スパイラル

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

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

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

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

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

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

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

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

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

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

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

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

- 23.5.2.1 サポートするオブジェクト・ページへのアクセス

- 23.5.2.2 サポートするオブジェクト・ページ

- 23.5.2.2.1 インストール

- 23.5.2.2.2 アップグレード

- 23.5.2.2.3 削除

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

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

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

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

- 23.5.6.1 アップグレード・スクリプトの定義

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

- 23.7.5 テーマのインポート

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

24 アプリケーション・レガシー・コンポーネントの管理

- 24.1 レガシー・コンポーネント・ビューでのページの管理

- 24.1.1 レガシー・コンポーネント・ビュー・ウィンドウ

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

- 24.1.3 レガシー・コンポーネント・ビューのUI要素の理解

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

- 24.1.3.2 コンポーネント・ビューのナビゲーション・バー

- 24.1.3.3 ページ・レンダリング

- 24.1.3.4 ページ・プロセス

- 24.1.3.5 共有コンポーネント

- 24.1.4 レガシー・コンポーネント・ビューの使用

- 24.1.4.1 レガシー・コンポーネント・ビューでのページの表示

- 24.1.4.2 「すべて編集」、「コピー」および「作成」アイコン

- 24.1.4.3 レガシー・コンポーネント・ビューでのページ・コントロールの作成

- 24.1.5 レガシー・コンポーネント・ビューでのページ属性へのアクセス

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

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

- 24.1.5.2.1 名前

- 24.1.5.2.2 表示属性

- 24.1.5.2.3 JavaScript

- 24.1.5.2.4 CSS

- 24.1.5.2.5 ダイアログ

- 24.1.5.2.6 HTMLヘッダー

- 24.1.5.2.7 ヘッダーおよびフッター

- 24.1.5.2.8 読取り専用

- 24.1.5.2.9 セキュリティ

- 24.1.5.2.10 重複送信

- 24.1.5.2.11 サーバー・キャッシュ

- 24.1.5.2.12 構成

- 24.1.5.2.13 エラー処理

- 24.1.5.2.14 ヘルプ

- 24.1.5.2.15 コメント

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

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

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

- 24.1.6 レガシー・コンポーネント・ビューでのページの実行

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

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

- 24.1.9 レガシー・コンポーネント・ビューでのページの削除

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

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

- 24.1.9.3 複数のページの削除

- 24.1.9.4 ページの範囲の削除

- 24.2 レガシー・チャートの管理

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

- 24.2.1.1 HTML5チャートについて

- 24.2.1.2 Flashチャートについて

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

- 24.2.2.1 標準チャート構文

- 24.2.2.2 ダイアル・チャート構文(FlashおよびHTML5)

- 24.2.2.3 複数シリーズ構文(FlashおよびHTML5)

- 24.2.2.4 レンジ・チャート構文(FlashおよびHTML5)

- 24.2.2.5 散布チャート構文(FlashおよびHTML5)

- 24.2.2.6 ローソク足チャート構文(FlashおよびHTML5)

- 24.2.2.7 ガント・チャート構文(Flashのみ)

- 24.2.3 新しいページへのレガシー・チャートの追加

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

- 24.2.4.1 ページ・デザイナでのチャートの追加

- 24.2.4.2 ページ・デザイナでのチャート属性の編集

- 24.2.4.3 HTML5チャートからFlashチャートへの切替え

- 24.2.4.4 非同期更新の有効化

- 24.2.4.4.1 非同期更新属性の有効化

- 24.2.4.4.2 ページ・デザイナでのリフレッシュ動的アクションの作成

- 24.2.5 レガシー・コンポーネント・ビューでのチャートの管理

- 24.2.5.1 コンポーネント・ビューでのチャートの追加

- 24.2.5.2 HTML5チャートからFlashチャートへの切替え

- 24.2.5.3 コンポーネント・ビューでのチャート属性の編集

- 24.2.5.4 非同期更新の有効化

- 24.2.5.4.1 非同期更新属性の有効化

- 24.2.5.4.2 リフレッシュ動的アクションの作成

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

- 24.2.6.1 SVGチャートのHTML5へのアップグレード

- 24.2.6.1.1 SVGチャートのアップグレードの制限事項について

- 24.2.6.1.2 1つのSVGチャートのHTML5へのアップグレード

- 24.2.6.1.3 アプリケーション内のすべてのSVGチャートのHTML5へのアップグレード

- 24.2.6.2 SVGチャート・カスケード・スタイルシート・クラスの理解

- 24.2.6.3 SVGチャート・カスタム・カスケード・スタイルシートの参照

- 24.2.6.4 SVGチャートのカスタムCSSスタイル・インラインの指定

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

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

- 24.2.7.1 1つのHTMLチャートのHTML5へのアップグレード

- 24.2.7.2 すべてのHTMLチャートのHTML5へのアップグレード

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

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

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

- 24.4 レガシー表形式フォームの管理

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

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

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

- 24.4.4 レガシー表形式フォームの作成

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

- 24.5 レガシー・カレンダの管理

- 24.5.1 レガシー・クラシック・カレンダの作成

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

- 24.5.2.1 コンポーネント・ビューでのカレンダ属性の編集

- 24.5.2.2 追加および編集機能を含めるように既存のカレンダを編集

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

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

- 24.6 ギャラリでのレガシー・コンポーネントの表示

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 タイプ

索引

はじめに

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 SQL言語リファレンス

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

表記規則

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

規則

意味

太字

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

イタリック体

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

固定幅フォント

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

このリリースでの変更点

「はじめに」の内容は次のとおりです。

トピック:

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

Oracle Application Expressリリース5.1での変更点

Oracle Application Expressリリース5.1のOracle Application Expressアプリケーション・ビルダー・ユーザーズ・ガイドの変更点は次のとおりです。

トピック:

- 新機能

- 非推奨となったかサポートが終了した機能

- その他の変更

新機能

このリリースの新機能は次のとおりです。

- 対話グリッド
対話グリッドでは、検索およびカスタマイズ可能なレポートの一連のデータがエンド・ユーザーに表示されます。機能の観点からは、対話グリッドには、対話モード・レポートで使用可能なカスタマイズ機能と、マウスを使用して対話的にレポートを再配置する機能が含まれています。編集可能対話グリッドでは、ユーザーはページ上で直接データ・セットを追加、変更およびリフレッシュすることもできます。

主な機能は次のとおりです。

- フル機能を備えたグリッド: 固定ヘッダー、固定列、スクロール・ページ区切り、複数のフィルタ、ソート、集計、計算などの強力なレポート機能が含まれています。固定ヘッダー、固定列、スクロール・ページ区切り、複数のフィルタ、ソート、集計、計算などの強力なレポート機能が含まれています。

- 拡張可能かつカスタマイズ可能: テキスト、数値データおよびLOVを編集します。対話グリッドは、すべてのアイテム・タイプとアイテム・タイプ・プラグインをサポートしています。

- マスター・ディテール: マスター・ディテール関係を作成し、その縦横のレベルの数は任意です。マスター・ディテール関係を作成し、その縦横のレベルの数は任意です。

「レポートの作成」、「対話グリッドの管理」および「マスター・ディテール・フォームの管理」を参照してください。

- Oracle JETチャート
Oracle Application Expressリリース5.1のチャートは、Oracle JETチャート作成ライブラリを基盤としています。Oracle JETチャートは、最新のJavaScript、CSS3およびHTML5のデザイン原理と開発原理に基づいたオープン・ソース・ツールキットである、Oracle JavaScript拡張機能ツールキット(JET)のコンポーネントです。Oracle JETチャートは、高速かつカスタマイズ可能で、様々な目的で使用できます。チャートはHTML5に完全に対応し、プラットフォーム、画面サイズまたは機能に関係なく、すべての最新のブラウザで動作します。アプリケーションのアップグレード・ウィザードを使用して、既存のAnyChartチャートを簡単に移行します。

チャートの作成を参照してください。

- ウィザードの簡略化
リリース5.1では、ウィザードが効率化および簡略化されています。

- アプリケーションの作成ウィザード: デスクトップ・アプリケーションのアプリケーションの作成ウィザードで、レポート、フォームおよびマスター・ディテールとしての対話グリッド・ページの作成がサポートされるようになりました。また、スプレッドシートからアプリケーションを作成する場合、このウィザードでは単一ページまたはレポートとフォーム・ページとしての対話グリッドもサポートされます。
アプリケーションの作成ウィザードの使用を参照してください。

- ページの作成ウィザード: ページの作成ウィザードには、一貫性と効率性が向上し、より少ないステップで構成されたインタフェースが備えられています。マスター・ディテール・フォームには、単一ページまたは2つのページに対話グリッド・リージョンが組み込まれました。
データベース・アプリケーションのページの管理を参照してください。

- Calendar
このリリースではカレンダに多くの改善が加えられました。

- 終了日の表示(その日を含む): リリース5.0では、CSSカレンダで終日イベントの終了日がその日を含まないとみなされていました(jQuery FullCalendarプラグインと同様)。リリース5.1では、他のすべてのOracle Application Expressコンポーネントと同様、終了日が含められます。

- JavaScriptカスタマイズ: 開発者は、新しい初期化JavaScriptコード属性を使用して、FullCalendar初期化のカスタマイズをサポートするJavaScriptコードを追加できます。

- 動的アクション・イベント: 開発者がカレンダ内のイベントを取得して、これらのイベントに対する動的アクションを定義できます。

- キーボート・サポート: カレンダ・グリッドがフォーカスされている場合、矢印キーを使用してカレンダ内をナビゲートできます。

カレンダの作成を参照してください。

- アイテム・タイプ
ファイル参照ページ・アイテムは、複数のファイル・アップロードをサポートするように構成することも、ファイル・タイプによって制限することもできます。

- ページ・デザイナ

- 「コンポーネント・ビュー」タブ: ページ・デザイナへの移行で開発者を支援するために、ページ・デザイナには「コンポーネント・ビュー」タブが含まれています。レガシー・コンポーネント・ビューの外観と同様、ページ・デザイナの「コンポーネント・ビュー」タブには、ユーザー・インタフェース要素とアプリケーション・ロジックがコンポーネント・タイプ別に表示されます。ただし、コンポーネントをクリックすると、プロパティ・エディタの右ペインで対応する属性がハイライトされます。

- 2ペイン・モード: ページ・デザイナで、開発者が3つではなく2つのペインのみを表示できるようになりました。2ペイン・モードにより、開発者が同時に2つのペインに集中できます。

- ドラッグ・アンド・ドロップによるタブの順序変更: 開発者がペイン間でタブを順序変更して、ページ・デザイナをカスタマイズできるようになりました。

- プロパティ・エディタのフィルタ・プロパティ検索: 「フィルタ・プロパティ」フィールドにキーワードを入力して、プロパティ・エディタのグループまたは属性を検索します。

- プロパティ・エディタの変更インジケータ: 変更した属性は、ページが保存されるまで青色のマーカーとともに表示されます。

ページ・デザイナでのページの管理を参照してください。

- ページの送信

- 「送信時にリロード」ページ属性: 開発者が、ページ送信後のページをリロードするタイミングを指定できます。

- ユニバーサル・テーマとユーザーの操作性の拡張

- フォントAPEX: フォントAPEXは、Oracle Application Expressおよびユニバーサル・テーマ用に特別に設計された新しいアイコン・ライブラリです。フォントAPEXには、1,000を超えるアイコンが含まれています。フォントAPEXの詳細は、ユニバーサル・テーマのサンプル・アプリケーションをインストールしてください。

- ライブ・テンプレート・オプション: ライブ・テンプレート・オプションにより、開発者は、ページをリフレッシュすることなくコンポーネントのテンプレート・オプションを変更できます。

- テーマ・スタイル: ユーザーが実行中のアプリケーションでテーマ・スタイルを選択できます。

ライブ・テンプレート・オプションを変更するためのクイック編集の使用 およびユーザーによるテーマ・スタイルの選択の可能化を参照してください。

非推奨となったかサポートが終了した機能

『Oracle Application Expressリリース・ノート』の非推奨となった機能およびサポートが終了した機能に関する項を参照してください。

その他の変更

このリリースでの追加変更は次のとおりです。

- すべての内容は、新機能に合わせて更新されました。

- スクリーンショットやグラフィックは、Oracle Application Expressリリース5.1のユーザー・インタフェースの拡張を反映する形で追加および更新されています。

- 『Oracle Application Expressアプリケーション・ビルダー・ユーザーズ・ガイド』に対する変更

- 新しい体系では、レガシー・アプリケーションのコンポーネントが同じグループに編成されました。レガシー・アプリケーション・コンポーネントは、引き続きOracleでサポートされますが、使用することはお薦めしません。
アプリケーション・レガシー・コンポーネントの管理を参照してください。

- 「付録E: Oracle Application Expressのアクセシビリティ」が削除されました。アクセシビリティに関する情報は、『Oracle Application Expressアクセシビリティ・ガイド』を参照してください。

1 クイック・スタート

「クイック・スタート」では、Oracle Application Expressの概要を説明します。この項では、開発環境にアクセスする方法について説明し、ワークスペースのホームページ、アプリケーション・ビルダーのホームページ、アプリケーションのホームページについて説明し、アカウント・プロファイルとユーザー・プリファレンスの編集方法および製品ドキュメントへのアクセス方法について説明します。

ヒント:

オンプレミス・インストールにアクセスしている場合は、続行する前にインストール・プロセスを完了してください。『Oracle Application Expressインストレーション・ガイド』を参照してください

トピック:

- 開発環境へのアクセスについて

- Oracle Application Expressの理解

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

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

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

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

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

1.1 開発環境へのアクセスについて

Oracle Application Expressにサインインおよびアクセスする方法は、ユーザー・ロールおよびOracle Application Expressが存在する場所に応じて異なります。Oracle Application Expressは、ローカルのオンプレミスOracle Databaseに、またはOracle Cloud Serviceなどのホストされた環境に存在する場合があります。サインインに使用するログイン資格証明は、インストール・タイプによって異なります。

Oracle Application Expressオンプレミス

Oracle Application Expressオンプレミスを実行する場合は、Oracle Application Expressワークスペースにサインインします。

関連項目:

『Oracle Application Expressインストレーション・ガイド』のOracle Application Expressへのアクセスに関する項およびワークスペース・リクエストが有効な場合のサインインに関する項。

Oracle Database Cloud

Oracle Application Expressは、Oracle Database Exadata Express Cloud ServiceやOracle Database Cloud - Database Schema ServiceなどのOracle Database Cloudサービスでインストールされ有効化されます。

Oracle Application ExpressはExadata Cloud ServiceとDatabase Cloud Serviceで使用できます。ただし、Oracle Application Expressをインストールして有効化するには、データベースを手動でカスタマイズする必要があります。

関連項目:

「Oracle Database Exadata Express Cloud Serviceの使用」および「Oracle Database Cloud - Database Schema Serviceの使用」

1.2 Oracle Application Expressの理解

Oracle Application Expressは、データベース集中型のWebアプリケーションを開発およびデプロイするためのホスティングされた宣言型の開発環境です。Oracle Application Expressをインストールする場合、タンタイム環境と完全開発環境のいずれかをインストールできます。

トピック:

- Oracle Application Expressの概要

- Oracle Application Expressの仕組み

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

1.2.1 Oracle Application Expressの概要

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

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

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

1.2.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.2.3 ランタイム環境と完全開発環境の違いについて

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

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

- 完全開発環境。完全開発環境では、ユーザーはApplication Expressアプリケーションを開発、変更、実行および削除できます。この環境では、このマニュアルで説明するOracle Application Express環境への完全なアクセス権が付与されます。

関連項目:

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

- 『Oracle Application Express管理ガイド』のエクスポートしたアプリケーションをランタイム環境にインストールに関する項

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

Oracle Application Express開発環境にサインインすると、ワークスペースのホームページが表示されます。ワークスペースは、オブジェクト、データおよびアプリケーションをプライベートに保ちながら、同一のOracle Application Expressのインストール内で複数のユーザーが作業可能な仮想プライベート・データベースです。この項では、ワークスペースのホームページについて説明します。

トピック:

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

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

- ニュースとメッセージ

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

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

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

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

ワークスペースのホームページの中央には、次の大きいアイコンがあります。

- アプリケーション・ビルダー - アプリケーション・ビルダーを使用して、一連のHTMLページから構成されるデータベース・オブジェクトに基づいたアプリケーションを作成します。

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

- チーム開発 - チーム開発を使用して、新機能、機能に関連しないタスク(To Doタスク)、バグおよびマイルストンを追跡します。また、ユーザーはリアルタイム・フィードバックを提供できます。このフィードバックは、機能、一般タスクまたはバグに分類できます。

- パッケージ・アプリケーション - 「パッケージ・アプリケーション」ページへのリンク。パッケージ・アプリケーションをインストールおよび実行して、作成可能なアプリケーションのタイプや特定のタイプのページを構成する方法について詳しく理解します。

メニュー・バーは、ページの上部にも表示されます。メニューをクリックして、アプリケーション・ビルダー、SQLワークショップ、チーム開発およびパッケージ・アプリケーション内の様々なコンポーネントへの別のナビゲーション・パスにアクセスします。次の図は「アプリケーション・ビルダー」メニューを示しています。

関連項目:

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

- Oracle Application Express 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開発環境にアクセスするには、ユーザーはワークスペースという作業用の共有領域にサインインします。ワークスペース管理者は、ワークスペースの監視と管理を行います。一般的なワークスペース管理タスクには、サービス・リクエストの管理、ワークスペース・プリファレンスの構成、ワークスペースのお知らせの作成、セッション・ステートの管理、ユーザー・アカウントの作成、グループの管理などがあります。

- サービスの管理: サービスの管理ページのオプションのサブメニューが表示されます。管理者は「サービスの管理」ページを使用して、サービス・リクエストの管理、ワークスペース・プリファレンスの構成、ワークスペースのお知らせの編集、ワークスペース使用率レポートの表示を行うことができます。

- ユーザーとグループの管理: ユーザーとグループの管理ページにリンクします。ワークスペース管理者は、新しいユーザー・アカウントの作成、既存のユーザー・アカウントの管理およびユーザー・パスワードの変更を行うことができます。

- アクティビティの監視: アクティビティの監視ページにリンクします。このページを使用して、ページ・ビュー、開発者アクティビティ、ページ・ビューの分析およびアクティブ・セッションへの変更を監視します。これにはログイン試行回数や外部アクセス・カウントなどの情報のレポートも表示されます。

- ダッシュボード: ダッシュボード・ページにリンクします。このページを使用して、現在のワークスペースの詳細の表示やユーザー、アクティビティ、開発者アクティビティ、パフォーマンス、Webシート・アプリケーション開発、アプリケーション開発の監視、およびデータベースの詳細の表示を行います。

- パスワードの変更: 「プロファイルの編集」ダイアログ・ボックスの「パスワードの変更」セクションにリンクします。

トピック:

- 「Help」メニュー

関連項目:

- 『Oracle Application Express管理ガイド』のワークスペースとアプリケーションの管理に関する項

- 『Oracle Application Express管理ガイド』のサービス・ページの管理に関する項

- 『Oracle Application Express管理ガイド』のワークスペースでのユーザーの管理に関する項

- Oracle Application Express管理ガイドの「ワークスペース内のアクティビティの監視」

- 『Oracle Application Express管理ガイド』のワークスペース・ダッシュボードの表示に関する項

- 「パスワードの変更」

1.3.4.2.1 「ヘルプ」メニュー

「ヘルプ」メニューの外観は、丸で囲まれた疑問符です。

「ヘルプ」メニューをクリックすると、次のメニュー・アイテムにアクセスできます。

- ドキュメント: Oracle Application Express、Oracle Help Centerにリンクします。

- ディスカッション・フォーラム: Application Express Discussion Forumにリンクします。

- Oracle Technology Network: Oracle Application Expressのページにリンクします。

- バージョン情報。「Application Expressについて」ダイアログにリンクします。このダイアログには、Oracle Application Expressインスタンスおよびデータベースのバージョンに関する情報が含まれています。

関連項目:

「Oracle Application Expressドキュメントの使用」

1.3.4.3 「アカウント」メニュー

アカウント・メニューはページの右上隅に表示され、人の輪郭が示されています。アカウント・メニューには、ユーザー名、現在のワークスペースおよびユーザー・ロールが表示されます。シングル・サインオン(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 アプリケーション・ビルダーの理解

開発者は、アプリケーション・ビルダーを使用して、Oracle Application Expressアプリケーションを構成するページを作成します。アプリケーション・ビルダーのホームページには、現在のOracle Application Expressインスタンスにインストールされているすべてのアプリケーションが表示されます。開発者が編集するアプリケーションを選択すると、アプリケーションのホームページが表示されます。アプリケーションのホームページを使用して、アプリケーションの実行、編集、インポート、エクスポート、コピーまたは削除を行います。

トピック:

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

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

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

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

関連項目:

クイック・スタートおよびアプリケーション・ビルダーの概念

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

アプリケーション・ビルダーを使用して、新しいアプリケーションの作成、編集するアプリケーションの選択、以前にエクスポートしたアプリケーションのインポート、ダッシュボードの表示およびワークスペース・ユーティリティへのアクセスを行います。

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

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

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

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

アプリケーション・ビルダーのホームページには、前の図に示すように、現在インストールされているアプリケーションが表示されます。

ヒント:

新しいワークスペースでは、ページの下部に2つの追加のリージョンが表示されます。アプリケーションの作成ウィザードにアクセスして新しいアプリケーションを作成するには、「新規アプリケーションの作成」をクリックします。パッケージ・アプリケーション・ページにアクセスしてパッケージ・アプリケーションをインストールし、サンプル・データをロードするには、「パッケージ・アプリケーションのインストール」をクリックします。アプリケーションを作成したりパッケージ・アプリケーションをインストールすると、これらのリージョンは表示されなくなります。

関連項目:

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

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

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

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

アプリケーション・ビルダーのホームページには、現在のOracle Application Expressインスタンスにインストールされているすべてのアプリケーションが表示されます。開発者は、アプリケーション・ビルダーのホームページを使用して、新しいアプリケーションの作成、編集するアプリケーションの選択、以前にエクスポートしたアプリケーションのインポート、ダッシュボードの表示およびワークスペース・ユーティリティへのアクセスを実行します。

ヒント:

新しいワークスペースでは、ページの下部に2つの追加のリージョンが表示されます。アプリケーションの作成ウィザードにアクセスして新しいアプリケーションを作成するには、「新規アプリケーションの作成」をクリックします。パッケージ・アプリケーション・ページにアクセスしてパッケージ・アプリケーションをインストールし、サンプル・データをロードするには、「パッケージ・アプリケーションのインストール」をクリックします。アプリケーションを作成したりパッケージ・アプリケーションをインストールすると、これらのリージョンは表示されなくなります。

トピック:

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

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

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

- 移行リンク

- ワークスペース・ユーティリティの使用

関連項目:

アプリケーション・ビルダーへのアクセスおよび開発者ナビゲーション・ツール

1.4.2.1 アプリケーション・ビルダーのホームページ

アプリケーション・ビルダーのホームページのアイコン

アプリケーション・ビルダーのホームページの上部には、次の4つの大きいアイコンがあります。

- 作成。アプリケーションの作成ウィザードを起動します。アプリケーションの作成ウィザードを使用して、複数のページを含む完全なアプリケーションを作成します。

- インポート。インポート・ウィザードを起動します。このウィザードを使用して、エクスポート・リポジトリからエクスポート・ファイルをインポートします。

- ダッシュボード。現在のワークスペース内のアプリケーションに関するメトリックを表示するアプリケーション・ビルダーのダッシュボードにリンクします。

- ワークスペース・ユーティリティ。ワークスペース・ユーティリティ・ページを使用して、アプリケーション・ビルダーのデフォルト値、そのホームページとチーム開発のホームページに表示されるニュース・アイテム、ワークスペース・テーマ、アプリケーション・グループ、Application Expressビューおよびアプリケーションのエクスポートを管理したり、アプリケーション間レポートにアクセスします。

アプリケーションおよびナビゲーション・バー

アプリケーション・ビルダーのホームページには、現在のOracle Application Expressインスタンスにインストールされているすべてのアプリケーションが表示されます。アプリケーション・ビルダーのホームページの外観は、ページの中央にあるナビゲーション・バーを使用してカスタマイズできます。

使用可能なコントロールは次のとおりです。

- 検索列の選択: このフィールドには、虫めがねのアイコンが表示されます。このアイコンをクリックして、検索を特定の列のみに絞ります。すべての列を検索するには、「すべての列」を選択します。

- テキスト領域: 大/小文字を区別しない検索基準(ワイルドカード文字を含む)を入力し、「実行」をクリックします。

- 「実行」ボタン: 検索を実行したり、フィルタを適用します。

- アイコンの表示(デフォルト): 各アプリケーションをアプリケーション名で識別される大きいアイコンとして表示します。

- レポートの表示: 各アプリケーションをレポート内の1行として表示します。各行には、アプリケーションID、アプリケーション名、アプリケーションの最終更新日、ページ・カウントおよびアプリケーションの最終更新者が含まれます。

- アクション・メニュー: アクション・メニューを表示します。レポート・ビューをカスタマイズするにはこのメニューを使用します。

ヒント:

新しいワークスペースでは、アプリケーション・ビルダーのホームページの下部に、「新規アプリケーションの作成」と「パッケージ・アプリケーションのインストール」の2つのリージョンが表示されます。「新規アプリケーションの作成」をクリックしてアプリケーションの作成ウィザードにアクセスし、新規アプリケーションを作成します。「パッケージ・アプリケーションのインストール」をクリックしてパッケージ・アプリケーション・ページにアクセスし、パッケージ・アプリケーションをインストールしたり、サンプル・データ・ユーティリティをロードします。これらのリージョンは、アプリケーションを作成したり、パッケージ・アプリケーションをインストールすると、表示されなくなります。

関連項目:

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

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

- 「ワークスペース・ユーティリティの使用」

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

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

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

- リセット。「リセット」をクリックすると、ページがデフォルト表示に戻ります。

- 作成。「作成」をクリックすると、アプリケーションが作成されるか、パッケージ・アプリケーションがインストールされます。

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

「最近」リストがページの右側に表示されます。このリージョンには、最近表示したアプリケーションへのリンクが表示されます。

1.4.2.4 移行リンク

「移行」リージョンは、ページの右下に表示されます。「移行」リンクをクリックすると、Oracle Application Expressアプリケーション移行ワークショップにアクセスします。移行ワークショップを使用して、Microsoft AccessアプリケーションまたはOracle FormsアプリケーションをOracle Application Expressアプリケーションに移行します。

関連項目:

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

1.4.2.5 ワークスペース・ユーティリティの使用

「ワークスペース・ユーティリティ」アイコンをクリックしてワークスペース・ユーティリティ・ページにアクセスします。ワークスペース・ユーティリティ・ページには、アプリケーション・ビルダーのデフォルト値、ニュースの管理、ワークスペース・テーマ、アプリケーション・グループ、Application Expressビュー、ページのエクスポートといった一般的なワークフロー・ユーティリティへのリンクが含まれます。

関連項目:

- 『Oracle Application Express管理ガイド』のアプリケーション・ビルダーのデフォルト値の利用に関する項

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

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

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

- Application Expressビューへのアクセス

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

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

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

アプリケーションのホームページを使用して、アプリケーションの実行、編集、インポート、エクスポート、コピーまたは削除を行います。

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

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

ワークスペースのホームページが表示されます。

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

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

3. アプリケーションのホームページでアプリケーションを選択します。

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

関連項目:

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

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

開発者がアプリケーション・ビルダーのホームページでアプリケーションを選択すると、アプリケーションのホームページが表示されます。アプリケーションのホームページを使用して、アプリケーションの実行、編集、インポート、エクスポート、コピーまたは削除を行います。

トピック:

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

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

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

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

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

- アプリケーションのホームページの「タスク」リスト

- 最近編集されたページ

関連項目:

開発者ナビゲーション・ツール

1.4.4.1 「アプリケーション・プロパティの編集」ボタン

アプリケーションIDとアプリケーション名が、アプリケーションのホームページ上部に表示されます。アプリケーションIDは、ページ上部のブレッドクラムにも表示されます。

「アプリケーション・プロパティの編集」ボタンは、アプリケーションIDおよび名前の右側に表示されています。「アプリケーション・プロパティの編集」をクリックして、アプリケーション名やアプリケーションの別名などのアプリケーション定義を編集します。

関連項目:

アプリケーション属性の編集

1.4.4.2 アプリケーションのホームページのアイコン

次の大きいアイコンが、アプリケーションIDおよびアプリケーション名の下に表示されます。

- アプリケーションの実行: カレント・アプリケーションのホームページをApplication Expressエンジンに送信し、表示可能なHTMLをレンダリングします。

- サポートするオブジェクト: サポートするオブジェクト・ページにリンクします。「サポートするオブジェクト」を使用して、アプリケーションのインポート時に呼び出されるデータベース・オブジェクトのインストール・スクリプトを定義します。アプリケーションを削除する際にオブジェクトを削除する削除スクリプトも定義できます。

- 共有コンポーネント: 共有コンポーネント・ページにリンクします。共有コンポーネントは、アプリケーション内のすべてのページに表示または適用できます。

- ユーティリティ: ユーティリティ・ページにリンクします。このページを使用して、開発者アクティビティの監視、ダッシュボードの表示、アドバイザの実行およびその他数多くのレポートの表示を行います。

- エクスポート/インポート: エクスポート・ウィザードとインポート・ウィザードにリンクします。このウィザードを使用して、アプリケーション全体のインポートとエクスポート、およびカスケード・スタイルシート、イメージ、静的ファイル、スクリプト・ファイル、テーマ、ユーザー・インタフェースのデフォルト値、ワークスペース・ユーザーなどの関連ファイルのインポートとエクスポートを行うことができます。

関連項目:

- 「Application Expressエンジンがページをレンダリングおよび処理する方法」

- カスタム・パッケージ・アプリケーションの作成方法

- 「共有コンポーネントの管理」

- アプリケーション・ユーティリティの使用

- アプリケーションおよびアプリケーション・コンポーネントのエクスポート

1.4.4.3 「ページの作成」ボタン

「ページの作成」ボタンをクリックすると、アプリケーションのページを作成するウィザードが起動します。

関連項目:

「アプリケーションのホームページからのページの作成」

1.4.4.4 アプリケーションのホームページのナビゲーション・バー

ナビゲーション・バーはアプリケーションのホームページの中央に表示されます。ナビゲーションを使用して、ページを検索したり、ページの外観をカスタマイズすることができます。

アプリケーション・ホームページのナビゲーション・バーには次のコントロールが含まれます。

- 検索列の選択: このフィールドには、虫めがねのアイコンが表示されます。このアイコンをクリックして、検索を特定の列のみに絞ります。すべての列を検索するには、「すべての列」を選択します。

- テキスト領域: 大/小文字を区別しない検索基準(ワイルドカード文字を含む)を入力し、「実行」をクリックします。

- 「実行」ボタン: 検索を実行したり、フィルタを適用します。

- 表示アイコン。これらのアイコンを使用して、3つのビューを切り替えます。

- アイコンの表示(デフォルト): 各ページをページ名で識別される大きいアイコンとして表示します。

- レポートの表示: 各ページがレポート内の1行として表示されます。各行には、ページID、ページ名、ページの最終更新日、更新者、ページ・タイプ、ユーザー・インタフェースの分類およびグループが含まれます。

- アクション・メニュー: アクション・メニューを表示します。レポート・ビューをカスタマイズするにはこのメニューを使用します。

関連項目:

アプリケーション・ビルダーのホームページ

1.4.4.5 アプリケーションのホームページのカスタマイズについて

次のアイコンを選択して、アプリケーションのホームページの表示方法を制御できます。

- アイコンの表示: (デフォルト)各ページがアイコンとして表示されます。
ページを表示するには、ページ・アイコンをクリックします。

- レポートの表示: 各ページがレポート内の1行として表示されます。各行にはページ番号(ID)、ページ名、ページの最新更新時、更新者、ページ・タイプ、関連グループ、ユーザー・インタフェースおよびロック・ステータスが含まれます。
ページを表示するには、ページ名をクリックしてください。「ロック」アイコンをクリックすると、アプリケーション開発中の競合を回避できます。「実行」アイコンをクリックすると、関連ページが実行され、表示可能なHTMLがレンダリングされます。

ヒント:

ダイアログ・ページまたはグローバル・ページは直接実行できないため、これらのページに「実行」アイコンは表示されません。

1.4.4.6 アプリケーションのホームページの「タスク」リスト

「タスク」リストがアプリケーションのホームページの右側に表示されます。

「タスク」リストには次のリンクが含まれます。

- このアプリケーションの削除: カレント・アプリケーションを削除します。

- このアプリケーションのコピー: カレント・アプリケーションのコピーを作成します。

関連項目:

- 「アプリケーションの削除」

- 「データベース・アプリケーションのコピー」

1.4.4.7 最近編集されたページ

「最近編集されたページ」リージョンには、カレント・アプリケーション内の最近編集されたページへのリンクが表示されます。特定のページにリンクするには、ページIDおよびページ名をクリックします。

1.5 アカウント・プロファイルの編集

Oracle Application Expressユーザーにはアカウント・プロファイルがあります。アカウント・プロファイルを編集して、電子メール・アドレスの更新、名または姓の編集、写真のアップロードまたはパスワードの変更を行うことができます。

トピック:

- アカウント・プロファイルの編集

- パスワードの変更

1.5.1 アカウント・プロファイルの編集

アカウント・プロファイルを編集するには、次のステップを実行します。

1. ヘッダー・リージョンでアカウント・メニューをクリックします。

2. 「プロファイルの編集」をクリックします。

「プロファイルの編集」ダイアログが表示されます。

3. 「プロファイル詳細」で、次の属性を編集します。

- 電子メール・アドレス

- 名

- 姓

属性の詳細は、フィールドレベル・ヘルプを参照してください。フィールドレベル・ヘルプの表示を参照してください。

4. 「プロファイル写真」で、写真の追加、変更または削除を行います。

5. 「パスワードの変更」で、新しいパスワードを入力します。

6. 「変更の適用」をクリックします。

1.5.2 パスワードの変更

パスワードをリセットするには:

1. ヘッダー・リージョンでアカウント・メニューをクリックし、「プロファイルの編集」を選択します。

「プロファイルの編集」ダイアログが表示されます。

2. 「パスワードの変更」までスクロールします。

- 現行のパスワードの入力: 現在のパスワードを入力します。現行のパスワードを変更しない場合は、パスワードを入力しないでください。

- 新規パスワードの入力: 新規パスワードを入力します。

- パスワードの確認 - 新規パスワードを再度入力します。

3. 「変更の適用」をクリックします。

関連項目:

Oracle Application Express管理ガイドの「エンド・ユーザー・パスワードの変更」およびアカウント・メニュー

1.6 ユーザー・プリファレンスの編集

ユーザー・プリファレンスを編集することによって、デフォルト・ワークスペース・スキーマの更新、デフォルト日付書式の指定、レガシー・コンポーネント・ビューを表示するかどうかの決定およびアプリケーションの実行時にOracle Application Expressでウィンドウとタブを管理する方法の決定を行うことができます。

ユーザー・プリファレンスを編集するには、次のステップを実行します。

1. ヘッダー・リージョンでアカウント・メニューをクリックし、「プリファレンス」をクリックします。

「プリファレンス」ダイアログが表示されます。

2. 次の属性を編集します。

- デフォルトのスキーマ: データの参照、アプリケーションの作成およびSQLスクリプトの実行に使用するデフォルト・スキーマを指定します。使用可能なスキーマが複数あるワークスペースを使用する場合、アプリケーションの作成、SQL問合せの実行などでは、このスキーマがデフォルトになります。この機能では、セキュリティは制御されず、ユーザーのプリファレンスのみが制御されます。

- デフォルトの日付書式: ユーザー用のデフォルトのOracle日付書式を指定します。この指定により、SQLワークショップ内のデフォルトの日付書式が制御されます。

- レガシー・コンポーネント・ビューの有効化: レガシー・コンポーネント・ビューは、デフォルトで無効化されています。レガシー・コンポーネント・ビューを有効にするには、「はい」を選択します。

- アプリケーションを新規ウィンドウで実行: アプリケーション・ビルダーからのアプリケーションの実行時にOracle Application Expressでウィンドウまたはタブを管理する方法を指定します。
このオプションは、Mozilla FirefoxおよびMicrosoft Internet Explorerを使用する場合にのみ影響し、他のブラウザを使用する場合は影響しません。オプション:

- はい - デフォルト。ブラウザのプリファレンスは無視され、新しいウィンドウが常に開かれます。

- いいえ - ランタイム・アプリケーションは、ブラウザのプリファレンスに基づいた新しいウィンドウまたはタブで開かれます。通常、Mozilla FirefoxおよびMicrosoft Internet Explorerでは、タブが最初に起動された場合を除き、同じウィンドウの別のタブにフォーカスは設定されません。

- すべてのアプリケーションの実行に単一ウィンドウを使用: 異なるアプリケーションで、同じアプリケーション・ランタイム・ウィンドウまたはタブを再利用するかどうかを指定します。オプション:

- はい - アプリケーション・ビルダーから実行する各アプリケーションで、前のアプリケーションの実行に使用されたウィンドウまたはタブを再利用します。

- いいえ - 実行する各アプリケーションは、独自のウィンドウまたはタブで開かれます。

3. 「変更の適用」をクリックします。

関連項目:

レガシー・コンポーネント・ビューでのページの管理

1.7 Oracle Application Expressドキュメントの使用

Oracle Application Expressには、ホスティングされたオンライン・ドキュメント・ライブラリおよびフィールドレベル・ヘルプがあります。Oracle Help Centerに移動して、オンライン・ドキュメント・ライブラリにアクセスしたり、オンライン・ドキュメント・ライブラリを検索またはダウンロードします。

トピック:

- Oracle Help Centerへのアクセス

- Oracle Help Centerの検索

- ドキュメント・ライブラリのダウンロード

- フィールドレベル・ヘルプの表示

1.7.1 Oracle Help Centerへのアクセス

Oracle Help Centerは、Oracle Application Expressの使用方法を説明するパブリケーションの包括的なライブラリを提供します。Oracle Application Expressを初めて使用するユーザーも、上級ユーザーも、スタート・ガイドから拡張機能までを網羅する情報の中からOracle Application Expressに関する有益な情報を見つけることができます。

Oracle Help Centerで利用可能なOracle Application Expressのドキュメントにアクセスする手順は、次のとおりです。

- 右上隅の「ヘルプ」メニューをクリックして、「ドキュメント」 を選択します。
Oracle Help Centerが表示されます。

- ユーザー・インタフェース内の「詳細...」リンクをクリックして、カレント・ページに関する情報を表示します。
カレント・ページに関する情報が表示されます。

「ヘルプ」メニューへのりダイレクト

管理者は、Oracle Application Express管理サービス・アプリケーションの「インスタンスの管理」や「インスタンスの設定」で、インスタンス・レベルの「ヘルプ」メニューにリダイレクトできます。Oracle Application Express管理サービスは、インスタンス管理者がOracle Application Expressのホスティングされたインスタンス全体を管理できるようにする個別のアプリケーションです。この機能は、ホスティングされたインスタンスを使用している一部のお客様は使用できません。

関連項目:

『Oracle Application Express管理ガイド』のヘルプ・メニューの構成に関する説明

1.7.2 Oracle Help Centerの検索

オンライン・ドキュメント・ライブラリのキーワード検索を実行するには、次のステップを実行します。

1. ほとんどのOracle Application Expressページの右上隅にある「ヘルプ」メニューをクリックします。

2. 「ドキュメント」 を選択します。
Oracle Help Centerが表示されます。

3. ライブラリ全体を検索するには、次のステップを実行します。

a. ページ上部の検索フィールドにキーワードを入力し、Enterを押します(または「検索」アイコンをクリックします)。
検索結果が表示されます。

b. 表示するトピックを選択します。

4. 特定のドキュメントを検索するには、次のステップを実行します。

a. 左ペインの検索フィールドにキーワードを入力し、Enterを押します(または「検索」アイコンをクリックします)。
検索結果が表示されます。

b. 表示するトピックを選択します。

ヒント:

トピックを表示する間、左ペインに目次が表示されます。このペインを非表示にするには、ドキュメント・タイトルの下にある左向き矢印をクリックします。左ペインが一時的に非表示になります。

1.7.3 ドキュメント・ライブラリのダウンロード

「Oracle Application Expressリリース5.1のすべてのドキュメントをダウンロードします。」リンクを使用して、Oracle Application Expressドキュメント・ライブラリをダウンロードします。

オンライン・ドキュメント・ライブラリをダウンロードするには、次のステップを実行してください。

1. Oracle Help Centerにアクセスします。右上隅の「ヘルプ」メニューをクリックして、「ドキュメント」 を選択します

2. 「Oracle Application Expressブックシェルフのダウンロード」で、「Oracle Application Expressリリース5.1のすべてのドキュメントをダウンロードします。」をクリックします。

3. Zipファイルをローカルに保存します。

4. Zipファイルをダウンロードし、ローカルで解凍します。

5. 解凍したフォルダを開き、index.htmlをクリックします。

Oracle Application Expressドキュメント・ライブラリのようこそページが表示されます。

1.7.4 フィールドレベル・ヘルプの表示

Oracle Application Expressのほとんどの選択リスト、チェック・ボックス、アイテムおよびフィールドには、フィールドレベル・ヘルプがあります。フィールドレベル・ヘルプは、表示する場所に応じて2種類の方法で表示されます。

トピック:

- Oracle Application Expressでのフィールドレベル・ヘルプの表示

- ページ・デザイナでのヘルプの表示

関連項目:

ページ・デザイナでのページの管理およびレガシー・コンポーネント・ビューでのページの管理

1.7.4.1 Oracle Application Expressでのフィールドレベル・ヘルプの表示

Oracle Application Expressのほとんどの選択リスト、チェック・ボックス、アイテムおよびフィールドには、フィールドレベル・ヘルプがあります。

フィールドレベル・ヘルプを表示するには、次のステップを実行します。

1. 情報が必要な属性にナビゲートします。

Oracle Application Express内のほとんどの属性には、フィールドレベル・ヘルプが含まれています。フィールドレベル・ヘルプを含む属性には、疑問符(?)の形をしたライト・グレーのアイコンが表示されます。アイコンの上にカーソルを置くと、ツールチップ、ヘルプ・テキスト...が表示されます。

2. フィールドレベル・ヘルプを表示するには、「ヘルプ・テキスト」アイコンをクリックします。

ヘルプ・ウィンドウが表示されます。

ヒント:

キーボードを使用してフィールドレベル・ヘルプにアクセスするには、正しいフィールドにフォーカスし、[Alt]+[F1]を押します。

関連項目:

Oracle Help Centerへのアクセス

1.7.4.2 ページ・デザイナでのヘルプの表示

ページ・デザイナには、プロパティ・エディタのすべてのプロパティのヘルプが含まれています。

ページ・デザイナでヘルプを表示するには、次のステップを実行します。

1. ページ・デザイナにアクセスします。

ページ・デザイナが表示されます。

2. 左ペインか中央ペインのいずれかで、コンポーネントまたはコントロールを選択します。

いずれかのビューでフォーカスを変更すると、プロパティ・エディタによって自動的に更新され、現在選択されているコンポーネントが反映されます。

3. プロパティ・エディタで、属性を選択します。

4. 属性のヘルプを表示するには、プロパティ・エディタで属性を選択して、中央ペインの「ヘルプ」タブをクリックします。

「ヘルプ」ペインをアクティブ化すると、別の属性を選択するたびに表示されるコンテンツが変わります。

ヒント:

「ページ・デザイナ」ウィンドウについてのみ説明するオンライン・サマリーを表示するには、ページ・デザイナでページを表示し、ページの上部にある「ヘルプ」メニューをクリックして、「ページ・デザイナのスタート・ガイド」を選択します。

関連項目:

「ページ・デザイナでのページの表示」

2 アプリケーション・ビルダーの概念

開発者は、アプリケーション・ビルダーを使用して、Oracle Application Expressアプリケーションを構成するページを作成します。アプリケーション・ビルダーを使用する前は、開発者は、レンダリングされたアプリケーション・ページの表示、セッション・ステートの管理、URL構文の理解、組込み置換文字列の使用などの、Application Expressアプリケーションに関する基本的な概念について理解する必要がありました。

トピック:

- 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 アプリケーション・ページの概要

ページは、アプリケーションの基本的な構成要素です。すべてのアプリケーションは、1つまたは複数のページで構成されます。各ページにはボタンおよびフィールド(アイテムと呼ばれる)を配置でき、これらはリージョンと呼ばれるコンテナにグループ化されます。ページには、アプリケーション・ロジック(プロセス)を含めることもできます。条件付きナビゲーションを使用したあるページから別のページへのブランチや、(計算と呼ばれる)計算の実行、(編集チェックなどの)検証の実行、レポート、カレンダおよびチャートの表示が可能です。ページは、ページ・デザイナで表示および編集します。

関連項目:

ページ・デザイナでのページの管理

2.1.3 データベース・アプリケーションとWebシート・アプリケーションの違い

Oracle Application Expressアプリケーションを使用して、開発者はOracle Databaseからのデータを管理および表示できます。アプリケーション・ビルダーを使用して、アプリケーションを構築します。アプリケーション・ビルダーを使用して、2つの異なるタイプのアプリケーション(データベース・アプリケーションおよびWebシート・アプリケーション)を作成できます。この項では、これらのアプリケーション・タイプの違いについて説明します。

トピック:

- データベース・アプリケーションについて

- Webシート・アプリケーションについて

2.1.3.1 データベース・アプリケーションについて

データベース・アプリケーションは、ナビゲーション・メニュー、タブ、ボタンまたはハイパーテキスト・リンクを使用して相互にリンクされたページの集合です。アプリケーションのページは、共通のセッション・ステートおよび認証を共有します。

データベース・アプリケーションを作成するには、アプリケーションの開発者はウィザードを実行して宣言的にページおよびナビゲーションを編成します。個々のページはリージョンと呼ばれるコンテナを使用して編成されます。リージョンには、テキスト、カスタムPL/SQL、レポート、チャート、マップ、カレンダ、Webサービス・コンテンツまたはフォームを含めることができます。フォームは、数多くの組込みタイプ(テキスト・フィールド、テキスト領域、ラジオ・グループ、選択リスト、チェック・ボックス、日付ピッカー、ポップアップLOVなど)から選択可能なフィールド(アイテムと呼ばれる)で構成されます。

また、開発者はプラグインを使用して独自のカスタム・アイテム・タイプを作成することもできます。セッション・ステート(アプリケーション・コンテキスト)は透過的に管理され、ユーザー・インタフェース・プレゼンテーションはアプリケーション・ロジックから分離されているため、開発者はアプリケーションのルック・アンド・フィールを別のテーマを選択することで簡単に変更できます。

関連項目:

データベース・アプリケーションの作成

2.1.3.2 Webシート・アプリケーションについて

Webシート・アプリケーションを作成すると、開発者の支援がなくても、エンド・ユーザーが構造化データおよび非構造化データを管理できます。ページ・セクションには、WYSIWYGエディタを使用して編集できる非構造化データが含まれます。データ・グリッドによって、SQLを記述しなくても構造化データを管理できます。ユーザーは実行時ダイアログ・ボックスを使用して、列の追加、列の名前の変更および検証を実行できます。各ページおよびデータ・グリッドの各行は、ファイル、タグ、ノートおよびリンクで注釈を付けることができます。ページには、セクション、レポートおよびデータ・グリッドを含めることができ、ナビゲーションを使用してすべてをリンクできます。すべての情報は、検索可能でエンド・ユーザーによって完全に制御されます。

関連項目:

Webシート・アプリケーションの作成

2.1.4 アプリケーションの作成ウィザードの実行について

Oracle Application Expressアプリケーションを作成するには、開発者はアプリケーションの作成ウィザードを実行します。アプリケーションの作成ウィザードを実行するには、アプリケーション・ビルダーのホームページで「作成」ボタンをクリックします。

ヒント:

アプリケーション・ビルダーのホームページに初めてアクセスすると、「新規アプリケーションの作成」というラベルの付いたグレーのボックスが表示されます。「新規アプリケーションの作成」をクリックすると、アプリケーションの作成ウィザードにアクセスするためのショートカットになります。

アプリケーションの作成ウィザードを実行すると、作成するアプリケーションのタイプを選択するよう求められます。デスクトップとモバイル・ユーザー・インタフェースの両方が定義されているデスクトップおよびモバイル・データベース・アプリケーションは、自動検出を使用して、デバイスの画面サイズに基づいた最適なユーザー・インタフェースを実行できます。アプリケーションがパーソナル・コンピュータから開始される場合は、デスクトップ・ユーザー・インタフェースを使用します。アプリケーションがスマートフォンで実行される場合は、モバイル・ユーザー・インタフェースを使用します。複数のユーザー・インタフェースのあるアプリケーションを開発するには、1つのユーザー・インタフェースでアプリケーションを定義した後で、「ユーザー・インタフェース」属性から他のユーザー・インタフェースを追加します。

主なデシジョン・ポイントは、次のとおりです。

- デスクトップ。デスクトップ・データベース・アプリケーションを使用すると、開発者は開発プロセスのあらゆる面を完全に制御でき、SQLおよびPL/SQLのプログラミング技術をそのまま活用できます。データベース・アプリケーションは、フロー制御全体で宣言的な制御を使用し、テンプレートおよびテーマの使用により完全なユーザー・インタフェース制御をサポートしています。アプリケーションの作成ウィザードの使用およびデータベース・アプリケーションの作成を参照してください。

- モバイル。モバイル・データベース・アプリケーションは、特にスマートフォン・デバイスで実行するように設計されています。アプリケーションの作成ウィザードの使用およびモバイル・アプリケーションの作成を参照してください。

- Webシート。Webシート・アプリケーションを使用すると、ユーザーはSQLのプログラミング知識がなくてもデータ中心のアプリケーションを作成できます。Webシート・アプリケーションは、ページ、データ・グリッド、レポートおよびコミュニティの貢献をサポートします。Webシート・アプリケーションの作成を参照してください。

- パッケージ・アプリケーション。「パッケージ・アプリケーション」ギャラリにリンクします。パッケージ・アプリケーションについてを参照してください。

- 追加のアプリケーションの作成オプションは、次のとおりです。

- スプレッドシートから。ファイルとして、またはコンテンツをコピー・アンド・ペーストすることによって、スプレッドシート情報をアップロードします。スプレッドシートからのデスクトップ・データベース・アプリケーションの作成を参照してください。

- 既存アプリケーションのコピー。データベース・アプリケーションのコピーを参照してください。

関連項目:

データベース・アプリケーションの作成

2.2 ユーザー・インタフェース設計の管理

開発者が初めてアプリケーションを作成する場合、ユーザー・インタフェースを選択します。アプリケーション・ビルダーでは、単一アプリケーション内の複数のユーザー・インタフェースがサポートされます。

トピック:

- アプリケーションのユーザー・インタフェースの決定について

- モバイル・アプリケーション設計について

- モバイル・デザインとレスポンシブ・デザインの違いの理解

2.2.1 アプリケーションのユーザー・インタフェースの決定について

アプリケーション・ビルダーでは、単一アプリケーション内の複数のユーザー・インタフェースがサポートされます。開発者は、デスクトップ、モバイル・デバイスまたはその両方のためのアプリケーションを構築することを選択できます。1つのアプリケーションに対して定義される各ユーザー・インタフェースには、固有のテーマ、ログイン・ページ、ホームページおよびグローバル・ページ(旧名称はページ0)があります。アプリケーション内のページを作成するときは、どのユーザー・インタフェースがそのページに関連付けられるかを指定する必要があります。選択したユーザー・インタフェースによって、ページおよびリージョンを作成するときに表示されるオプションが決まります。たとえば、マップ、データ・ロードおよび対話モード・レポートは、デスクトップ・ページのみでサポートされます。同様に、モバイル・ページでは、最も一般的な構成体はレポートとフォームではなくリストとフォームです。

関連項目:

- データベース・アプリケーションの作成

- 「モバイル・アプリケーションの作成」

- すべてのページにコンポーネントを表示するグローバル・ページの作成

2.2.2 モバイル・アプリケーション設計について

モバイル・アプリケーションは特にスマートフォン・デバイスで実行するように設計されるので、モバイル接続に最適化された、極小のセマンティックHTMLで構築される必要があります。Oracle Application Expressを使用して開発するモバイル・アプリケーションは、モバイル・デバイスのブラウザ内で実行されるブラウザ・ベースのアプリケーションです。したがって、これらのアプリケーションがOracle Databaseと通信するためには接続が必要で、切断された環境では操作できません。

HTML5機能を備えたモバイル・デバイスは、HTML5 date-picker、フィールド定義に基づき異なるキーパッドを表示するサブタイプなどを含む、アプリケーションに組込み可能なすべての機能を利用できます。より古いデバイスでは、アプリケーションはレンダリングされ、提供される拡張機能は少なくなります。ブラウザ・ベースのアプリケーションの大きな利点は、大多数のモバイル・デバイス向けに一度開発するだけでよいということです。ただし、1つの大きな制限は、連絡先リストなどのオンデバイス機能のアクセスです。Webアプリケーションの表示にネイティブ・アプリケーション・ラッパーを使用するハイブリッド・ソリューションの作成をサポートする、PhoneGapなどのソリューションと統合することで、この制限を軽減できます。Phonegapなどのソリューションによって、現在はHTML5またはJavaScriptを使用して利用できないネイティブ電話機能の多くにアクセスするための、様々なAPIが提供されます。詳細は次の場所を参照してください。

http://phonegap.com/

関連項目:

モバイル・アプリケーションの作成およびレスポンシブ・デザインについて

2.2.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.3 アプリケーションまたはページの実行

Application Expressエンジンは、データベース表に格納されたデータに基づいて、ページを動的にレンダリングおよび処理します。レンダリングされたアプリケーションを表示するには、アプリケーションを実行するか、またはApplication Expressエンジンに送信します。新しいページを作成したら、そのページを個別に実行するか、またはアプリケーション全体を実行できます。

トピック:

- 「アプリケーションの実行」および「ページの実行」ボタン

- アプリケーションの実行方法にブラウザが及ぼす影響

- アプリケーション・ビルダーのホームページからのアプリケーションの実行

- アプリケーションのホームページからのアプリケーションの実行

- アプリケーションのホームページでのページの実行

関連項目:

「ページ・デザイナからのページの実行」および「レガシー・コンポーネント・ビューでのページの実行」

2.3.1 「アプリケーションの実行」および「ページの実行」ボタン

「アプリケーションの実行」ボタンはアプリケーションのホームページに表示され、緑色の実行(または再生)ボタンがあるアプリケーション・ウィンドウと同様になります。アプリケーションのホームページからアプリケーションを実行するには、「アプリケーションの実行」をクリックします。

「ページの実行」ボタンは小さいグレーの再生ボタンのような形をしており、アプリケーション・ビルダー内の多くのページの右上に表示されます。「ページの実行」ボタンをクリックすると、カレント・ページまたは最後に選択したページが実行されます。

2.3.2 アプリケーションの実行方法にブラウザが及ぼす影響

アプリケーションを実行すると、そのアプリケーションは新しいウィンドウに表示されます。その新しいウィンドウが新しいタブになるか新しいブラウザ・ウィンドウになるかは、Webブラウザをどのように構成しているかによって異なります。Google ChromeまたはApple Safariを使用している場合、デフォルトでは、実行中のアプリケーションは新しいタブに表示されます。Microsoft Internet ExplorerまたはMozilla Firefoxを使用している場合、デフォルトでは、アプリケーションは新しいブラウザ・ウィンドウに表示されます。アカウントのプリファレンスを編集することによって、アプリケーション実行時にOracle Application Expressがタブおよびウィンドウを管理する方法をさらに制御できます。

関連項目:

ユーザー・プリファレンスの編集

2.3.3 アプリケーション・ビルダーのホームページからのアプリケーションの実行

アプリケーション・ビルダーのホームページからアプリケーションを実行するには、次のステップを実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. 「レポートの表示」アイコンをクリックします(オプション)。

「レポートの表示」を選択すると、各アプリケーションがレポート内の1行として表示されます。各行には、アプリケーションID、アプリケーション名、アプリケーション・ページ数および更新情報が含まれます。

3. 実行するアプリケーションに移動します。

4. アプリケーションを実行するには、次のステップを実行します。

- 「レポート」ビュー - 右端の列にある「ページの実行」アイコンをクリックします。

- 「アイコン」ビュー - ページ上部にある「アプリケーションの実行」アイコンをクリックします。

アプリケーションが新しいウィンドウに表示されます。

関連項目:

アプリケーションの実行方法にブラウザが及ぼす影響

2.3.4 アプリケーションのホームページからのアプリケーションの実行

アプリケーションのホームページからアプリケーションを実行するには、次のステップを実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

アプリケーション・ビルダーのホームページが表示されます。

2. アプリケーションを選択します。

3. ページ中央にある「アプリケーションの実行」アイコンをクリックします。

アプリケーションが新しいウィンドウに表示されます。

関連項目:

アプリケーションの実行方法にブラウザが及ぼす影響

2.3.5 アプリケーションのホームページでのページの実行

「ページ」リストからページを実行するには、次のステップを実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「レポートの表示」アイコンをクリックします。

「レポートの表示」を選択すると、各ページがレポート内の1行として表示されます。各行には、ページ番号、ページ名、ページの最終更新日、ページの最終更新者、ページ・タイプ、選択したユーザー・インタフェース、「ロック」アイコンおよび「実行」ボタンが含まれます。

4. 実行するページに移動します。

5. 右端の列にある「ページの実行」をクリックします。

アプリケーションが新しいウィンドウに表示されます。

関連項目:

ページのロックおよびロック解除およびアプリケーションの実行方法にブラウザが及ぼす影響

2.4 ページ・プロセスおよびページ・レンダリングの仕組み

アプリケーション・ビルダーでアプリケーションを作成する場合、タブ、ナビゲーション・メニュー、ボタンまたはハイパーテキスト・リンクを使用してページをリンクします。各ページにはボタンおよびアイテムを配置でき、アプリケーション・ロジックを含めることができます。ページでは、条件付きナビゲーションを使用したあるページから次のページへのブランチ、計算および検証の実行、およびレポート、カレンダおよびチャートの表示を行うことができます。組込みウィザードを使用してレポート、チャートおよびフォームを生成したり、静的HTMLを生成したり、PL/SQLプログラミングによってカスタム・レンダリングを行うことができます。

トピック:

- Application Expressエンジンがページをレンダリングおよび処理する方法

- 暗黙的コミット・ポイントについて

- 条件付きのレンダリングおよびプロセスの理解

- ユーザー・アイデンティティの確認について

- コントロールおよびコンポーネントへのアクセスの制御について

2.4.1 Application Expressエンジンがページをレンダリングおよび処理する方法

Application Expressエンジンは、Oracle Database表に格納されたデータに基づいて、ページを動的にレンダリングおよび処理します。レンダリングされたアプリケーションを表示するには、Application ExpressエンジンからURLを使用してそれをリクエストします。アプリケーションを実行すると、Application Expressエンジンによって次の2つのプロセスが使用されます。

- ページを表示 - 「ページを表示」は、すべてのページ属性(リージョン、アイテム、ボタンなど)を表示可能なHTMLページに編成するページ・レンダリング・プロセスです。URLを使用してページをリクエストする場合、エンジンはページ表示を実行します。

- ページ受入れ - ページ受入れでは、計算、検証、処理、ブランチなどのフォーム・ページの処理を実行します。ページを送信すると、Application Expressエンジンはページ受入れまたはページ・プロセスを実行します(その間に、送信された値をセッション・キャッシュに保存し、計算、検証または処理を実行します)。

2.4.2 暗黙的コミット・ポイントについて

Oracle Application Expressは次のポイントで暗黙的なコミットを発行します。

- ロード時、ページのレンダリングが終了した後。

- 送信時、別のページにブランチする前。

- 送信時、1つ以上の検証が失敗した場合、ページの再レンダリング前。

- 計算後。

- アイテムの値の変更後、たとえば、バインド変数値を変更するPL/SQLプロセスの後、またはAPEX_UTIL.SET_SESSION_STATEがコールされたとき。

- APEX_MAIL.PUSH_QUEUEがコールされたとき。

関連項目:

『Oracle Application Express APIリファレンス』のSET_SESSION_STATEプロシージャおよびPUSH_QUEUEプロシージャに関する項

2.4.3 条件付きのレンダリングおよびプロセスの理解

開発者は、アプリケーションで条件を使用して、ページおよびページ・コンポーネントの表示やプロセス、計算および検証の実行を制御できます。

トピック:

- 条件の概要

- 条件の選択

- 条件の例: 式1のカレント・ページ

- 条件の例: 存在する

- 条件の例: PL/SQL式

2.4.3.1 条件の概要

条件とは、リージョン、アイテム、ボタンおよびタブの表示と、プロセス、計算および検証の実行を制御するために役立つ、小さいロジックの単位です。たとえば、ボタンに条件を適用すると、レンダリング・エンジンによって、レンダリング(ページ表示)プロセス中にその条件が評価されます。条件に合格するかどうかによって、ボタンが表示されるかどうかが決まります。

関連項目:

使用可能な条件タイプの詳細なリストは、使用可能な条件を参照してください。

2.4.3.2 条件の選択

条件を指定するには、条件タイプを選択します。条件タイプは、コントロールまたはコンポーネントを最初に作成するとき、または後でコントロールまたはコンポーネントを編集するときに選択できます。

選択した条件のタイプに応じて、表示されるフィールドに適切な値を入力します。条件は、入力した値に基づいてtrueまたはfalseに評価されます。任意のコンポーネントまたはコントロールに使用可能なすべての条件のリストを表示するには、選択リストをクリックします。

2.4.3.3 条件の例: 式1のカレント・ページ

式1のカレント・ページは、カレント・ページ番号が、指定されたカンマで区切られたページ・リストに含まれている場合にtrueと評価されます。次に例を示します。

3,100,203

カレント・ページが100である場合、この条件はtrueに評価され、条件に合格します。

2.4.3.4 条件の例: 存在する

「存在する(SQL問合せが1行以上を戻す)」は、SQL問合せとして表現されます。問合せで1行以上が戻される場合、この条件はtrueと評価されます。次に例を示します。

SELECT 1 FROM employees WHERE department_id = :P101_DEPTNO

この例では、アイテムP101_DEPTNOがバインド変数として参照されます。アプリケーション・プロセスおよびSQL問合せリージョン内でバインド変数を使用すると、セッション・ステートからアイテムを参照できます。P101_DEPTNOの値に指定した部門に1人以上の従業員が存在する場合、この条件はtrueと評価されます。

関連項目:

バインド変数構文を使用したセッション・ステートの参照

2.4.3.5 条件の例: PL/SQL式

「PL/SQL式」は、trueまたはfalseを評価する式を有効なPL/SQL構文で指定するために使用します。次に例を示します。

NVL(:MY_ITEM,'NO') = 'YES'

前述の例のように、:MY_ITEMの値がYESであれば、この条件はtrueと評価されます。:MY_ITEMの値がYES以外の場合、この条件はfalseと評価されます。

2.4.4 ユーザー・アイデンティティの確認について

認証は、ユーザーのアプリケーションへのアクセスを可能にするために、ユーザーのアイデンティティを証明するプロセスです。認証では、ユーザーにユーザー名とパスワードの入力を求めたり、デジタル証明書や保護キーを使用する場合があります。

Oracle Application Expressは、モジュール認証をサポートしているため、必要に応じて認証メソッドを簡単に切り替えられます。ユーザー・アイデンティティの証明は、いくつかの組込み認証メソッドから選択するか、またはウィザードを使用して独自のカスタム認証方法を作成して実行できます。

関連項目:

認証によるユーザー・アイデンティティの証明

2.4.5 コントロールおよびコンポーネントへのアクセスの制御について

条件はページ上の特定のコントロールまたはコンポーネントのレンダリングおよび処理を制御しますが、認可スキームはユーザーのアクセスを制御します。認可は、ユーザー権限に基づいてリソースへのアクセスを制御することを示す広義語です。

認可スキームは、認証で証明されたアイデンティティを使用して、その中のアプリケーションおよびオブジェクトに権限を付与します。認可スキームは、アプリケーション全体、各ページ、またはリージョン、アイテム、ボタンなどの特定のページ・コントロールに対して指定できます。たとえば、認可スキームを使用して、ユーザーに表示するタブ、リージョンまたはナビゲーション・バー・エントリを選択的に決定できます。

関連項目:

認可を介したセキュリティの提供

2.5 ブックマークのサポートの有効化について

開発者は、セッションIDとしてゼロを使用するか、「セッションを再結合」を有効化することによって、アプリケーション・ページをブックマークするユーザーを支援できます。

以前のリリースでは、アプリケーション内のページが公開されていて認証の必要がない場合、セッションIDとしてゼロを使用することで、ユーザーは容易にページをブックマークできました。この方法は引き続きサポートされていますが、現在のOracle Application Expressには、開発者がこのタイプのサポートをページ、アプリケーションまたはインスタンス・レベルで制御できる「セッションを再結合」という新機能が含まれています。

関連項目:

「セッションを再結合」についておよびOracle Application Expressアプリケーション・ビルダー・ユーザーズ・ガイド、リリース4.2の「セッションIDにゼロを使用したブックマークの容易化」

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 セッション・ステート値の管理

インタラクティブな、データに応じて動作するWebアプリケーションを構築するには、セッション・ステート値にアクセスして管理する機能が重要です。Oracle Application Expressでは、セッション・ステートはページごとに自動的に管理され、静的HTML、またはプロセスや検証などのロジック・コントロールによって簡単に参照できます。

トピック:

- セッション・ステートの参照について

- セッション・ステートの設定

- セッション・ステートのクリア

- バインド変数構文を使用したセッション・ステートの参照

- セッション・クローニングについて

関連項目:

アイテム値の参照

2.8.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.8.2 セッション・ステートの設定

この項では、アプリケーションのアイテム値を設定し、その結果、セッション・ステートを設定する方法について説明します。

トピック:

- セッション・ステートの設定について

- フォーム送信によるセッション・ステートの設定について

2.8.2.1 セッション・ステートの設定について

次の方法を使用して、アプリケーションのアイテム値およびセッション・ステートを設定できます。

- フォーム送信。フォーム送信によるセッション・ステートの設定についてを参照してください。

- バインド変数。バインド変数構文を使用したセッション・ステートの参照を参照してください。

- 計算。アプリケーションの計算の理解を参照してください。

- f?p構文。f?p構文を使用したページのリンクについてを参照してください。

2.8.2.2 フォーム送信によるセッション・ステートの設定について

ページがユーザーによって送信されると、Application Expressエンジンは、フィールド(アイテム)に入力された値をセッション・ステートに自動的に格納します。たとえば、2つのページを持つアプリケーションが存在すると想定します。このアプリケーションの最初のページには、ユーザーが電話番号を入力できるフォームが含まれています。このフォームは、P1_PHONENOという名前のアイテムを作成して定義しています。2番目のページには、ユーザーがフォームに入力する情報を表示する必要があります。

このページが送信されると、Oracle Application Expressによって、電話番号フィールドに入力された値が取得され、今後使用するためにその値が格納されます。2番目のページで、ユーザーが入力した電話番号は、名前P1_PHONE_NOを表2-3の適切な構文で使用して、セッション・ステートから取得できます。

2.8.3 セッション・ステートのクリア

アプリケーションの開発時に、特定のアイテム、ページ上のすべてのアイテム、アプリケーション内のすべてのページ、または現行のユーザー・セッション用にキャッシュされた値をクリアする必要がある場合があります。キャッシュされた値をクリアすると、その値がNULLにリセットされます。この項では、セッション・ステートのクリアの具体的な例を示します。

トピック:

- アイテムのキャッシュのクリアについて

- すべてのページ・アイテムのキャッシュのクリア

- 例: アプリケーション全体のキャッシュのクリア

- アプリケーションの完全なリセットについて

- カレント・ユーザー・セッションのキャッシュのクリアについて

2.8.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.8.3.2 すべてのページ・アイテムのキャッシュのクリア

アプリケーション・アイテムをキャッシュすると、セッション・ステートを効率的に保持できます。ただし、ページ上のすべてのアイテムのキャッシュをクリアする必要がある場合もあります。たとえば、ユーザーが新しい注文を作成するリンクをクリックすると、ページ上のすべてのフィールドがクリアされるようにする必要があると想定します。ページ全体のキャッシュをクリアすることで、ページ上のすべてのアイテムの値をNULLに設定できます。

トピック:

- 例: 2つのページのキャッシュのクリアおよびページ区切りのリセット

- 例: ページのキャッシュのクリアおよびアイテム値の引渡し

- 例: ページのセッション・キャッシュのクリアおよび複数のアイテムに対する値の引渡し

2.8.3.2.1 例: 2つのページのキャッシュのクリアおよびページ区切りのリセット

この例では、2つのページのセッション・キャッシュがクリアされ、ページ区切りがリセットされます。

f?p=6000:6003:&APP_SESSION.::NO:RP,6004,6014

この例では、次のようになります。

- アプリケーション6000のページ6003が実行され、現行のセッションIDが使用されます。

- デバッグ情報を表示しないように指示されます(NO)。

- カレント・セッションのキャッシュに保持されたページ6004および6014のアイテムのすべての値がクリアされます。

- ページ6003 (リクエストされたページ)のリージョンのページ区切り(RP)がリセットされます。

2.8.3.2.2 例: ページのキャッシュのクリアおよびアイテム値の引渡し

この例では、更新フォームの実装方法を示します。既存の情報をクリアし、アイテムの値(通常、主キー)を設定します。

f?p=6000:6003:&APP_SESSION.::NO:6003:MY_ITEM:1234

この例では、次のようになります。

- アプリケーション6000のページ6003が実行され、現行のセッションIDが使用されます。

- デバッグ情報を表示しないように指示されます(NO)。

- カレント・セッションのキャッシュに保持されたページ6003のアイテムのすべての値がクリアされます。

- MY_ITEMというアイテムのセッション・ステートの値を1234に設定します。

2.8.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.8.3.3 例: アプリケーション全体のキャッシュのクリア

この例では、f?p構文を使用し、キーワードAPPを使用してClear Cache引数を作成することで、アプリケーションのキャッシュがクリアされます。

f?p=App:Page:Session::NO:APP

2.8.3.4 アプリケーションの完全なリセットについて

アプリケーション全体のキャッシュをリセットしても、アプリケーションは完全なリセット状態にはリストアされません。たとえば、アプリケーションに新しいインスタンス開始時の計算やプロセスが含まれている場合、Application Expressエンジンは、該当するアプリケーション・セッションが作成されたときに、これらの計算やプロセスを実行します。その後、キャッシュのクリア・リクエストを処理し、リクエストされたページを表示します。

(セッションIDの追跡にCookieが使用されていない場合に)セッションIDを指定せずにアプリケーションを完全にリセットするには、セッションIDを指定せずにURLを使用するか、または別のアプリケーションからAPEX_UTIL.CLEAR_APP_CACHEをコールして、そのアプリケーションをリクエストする必要があります。セッションIDがCookieを使用して追跡される場合、そのステートをリセットするためにログアウトする必要があります。

2.8.3.5 カレント・ユーザー・セッションのキャッシュのクリアについて

アプリケーション・キャッシュをクリアするもう1つの方法は、キーワードSESSIONを使用してClear Cache引数を作成することです。次に例を示します。

f?p=6000:6004:12507785108488427528::NO:SESSION

2.8.4 バインド変数構文を使用したセッション・ステートの参照

この項では、バインド変数構文を使用してセッション・ステートを参照する方法について説明します。

トピック:

- バインド変数構文の使用について

- SQL問合せまたはLOVに基づいたリージョンでのバインド変数の使用について

- PL/SQLに基づいたリージョンでのバインド変数の使用について

2.8.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.8.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.8.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.8.5 セッション・クローニングについて

以前のリリースでは、同じOracle Application Expressアプリケーションで複数のウィンドウ(またはブラウザのタブ)を開くと、多くの問題が発生していました。通常、すべてのブラウザのタブで同じセッションおよびセッション・ステートを共有していたため、予期できない望ましくない結果が発生していました。

現在では、開発者が1つのOracle Application Expressアプリケーションで新しいブラウザ・ウィンドウを開くことができ、そこで個別のセッション識別子を生成して、元のApplication Expressセッションから新しいセッションにセッションの値をコピーできるようになりました。このようにするには、開発者は、エンド・ユーザーが新しいブラウザのタブを開く方法を指定し、APEX_CLONE_SESSIONのREQUEST値を指定する必要があります。次に、URLの例を示します。

f?p=&APP_ID.:&APP_PAGE_ID.:&APP_SESSION.:APEX_CLONE_SESSION

この機能を使用する場合、開発者は次のことに注意する必要があります。

- Application Expressセッションに関連するアイドル時間は、すべてのApplication Expressセッション(元の、またはクローニングされたセッション)の影響を受けます。

- ユーザーが1つのセッション(元の、またはクローニングされたセッション)からログアウトすると、他のすべての関連するセッションからもログアウトします。

- セッションの最大存続期間は、元のApplication Expressセッションの機能およびその作成時点です。

- 管理ユーザーは、次のプロシージャを使用してこの機能を有効化または無効化できます。

apex_instance_admin.set_parameter(
p_parameter => 'CLONE_SESSION_ENABLED',
p_value     => 'Y');

関連項目:

Oracle Application Express APIリファレンス

2.9 置換文字列の理解

ページ・テンプレート内またはリージョン・ソース内で置換文字列を使用すると、情報を渡して文字列を別の値に置換できます。

トピック:

- 置換文字列の使用について

- 置換文字列での出力のエスケープの制御

- テンプレート内での置換文字列の使用方法の確認について

- 組込み置換文字列の使用

2.9.1 置換文字列の使用について

アプリケーション・ビルダーでは、次のように置換文字列を使用できます。

- コンポーネント値を参照するために置換文字列をテンプレート内に含めます。

- &ITEM構文を使用して、ページまたはアプリケーション・アイテムを参照します。

- 組込み置換文字列の使用

テンプレート内の置換文字列

テンプレート内で使用可能な特別な置換文字列は、シャープ記号(#)で示します。次に例を示します。

#ABC#

ページまたはアプリケーション・アイテムの置換文字列

置換変数を使用してページまたはアプリケーション・アイテムを参照するには、次のステップを実行します。

1. すべて大文字でページまたはアプリケーション・アイテムを参照します。

2. アイテム名の先頭にアンパサンド(&)を追加します。

3. アイテム名の末尾にピリオド(.)を追加します。

たとえば、リージョン、リージョン・タイトル、アイテム・ラベル、または静的テキストを使用するその他の多数のコンテキストでF101_Xという名前のアプリケーション・アイテムを参照する場合は、次のように入力します。

&F101_X.

最後にピリオドが必要であることに注意してください。Application Expressエンジンは、置換文字列の値をアイテムF101_Xの値に置き換えます。

2.9.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.9.3 テンプレート内での置換文字列の使用方法の確認について

テンプレートの定義を表示することによって、テンプレート固有のどの置換文字列がどのテンプレートでサポートされるかを確認できます。カスタム・テーマの作成を参照してください。

2.9.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_PAGE_ALIAS

- APP_PAGE_ID

- APP_REQUEST_DATA_HASH

- APP_SESSION

- APP_SESSION_VISIBLE

- APP_TITLE

- APP_UNIQUE_PAGE_ID

- APP_USER

- AUTHENTICATED_URL_PREFIX

- BROWSER_LANGUAGE

- CURRENT_PARENT_TAB_TEXT

- DEBUG

- HOME_LINK

- IMAGE_PREFIX

- JET_BASE_DIRECTORY

- JET_CSS_DIRECTORY

- JET_JS_DIRECTORY

- LOGIN_URL

- LOGOUT_URL

- PRINTER_FRIENDLY

- PROXY_SERVER

- PUBLIC_URL_PREFIX

- REQUEST

- REQUESTの使用

- SCHEMA OWNER

- SQLERRM

- SYSDATE_YYYYMMDD

- THEME_DB_IMAGES

- THEME_IMAGES

- WORKSPACE_IMAGES

- WORKSPACE_ID

関連項目:

置換および認証によるユーザー・アイデンティティの証明

2.9.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.9.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.9.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.9.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.9.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.9.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.9.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.9.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.9.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.9.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.9.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.9.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.9.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.9.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.9.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.9.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.9.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.9.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.9.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 variable

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.9.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.9.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.9.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.9.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.9.4.24 HOME_LINK

HOME_LINKは、アプリケーションのホームページです。ページが指定されておらず、かつ認証スキームのロジックによって代替ページが指定されていない場合、Application Expressエンジンによって、この場所にリダイレクトされます。ホームURLは、ユーザー・インタフェースの詳細ページで定義します。

表2-27に、HOME_LINKを参照するためにサポートされている構文を示します。

表2-27 HOME_LINK構文

参照タイプ

構文

直接PL/SQL

APEX_APPLICATION.G_HOME_LINK

PL/SQL

V('HOME_LINK')

テンプレート参照

#HOME_LINK#

置換文字列

&HOME_LINK.

関連項目:

ホームURL属性の詳細は、アプリケーションのユーザー・インタフェースの管理およびユーザー・インタフェースの詳細ページを参照してください。

2.9.4.25 IMAGE_PREFIX

IMAGE_PREFIXの値によって、Oracle Application Expressによって配布されたイメージ・ディレクトリを指すためにWebサーバーが使用する仮想パスが決まります。アップロードされたイメージを参照する場合は、WORKSPACE_IMAGESおよびAPP_IMAGESを使用します。表2-28に、IMAGE_PREFIXを参照するためにサポートされている構文を示します。

表2-28 IMAGE_PREFIX構文

参照タイプ

構文

バインド変数

:IMAGE_PREFIX

直接PL/SQL

APEX_APPLICATION.G_IMAGE_PREFIX

PL/SQL

V('IMAGE_PREFIX')

置換文字列

&IMAGE_PREFIX.

テンプレート置換

#IMAGE_PREFIX#

関連項目:

- 「APP_IMAGES」

- 「WORKSPACE_IMAGES」

- アプリケーション属性の編集

2.9.4.26 JET_BASE_DIRECTORY

JET_BASE_DIRECTORY置換文字列を使用して、Oracle Application Expressに付属のOracle JavaScript拡張機能ツールキット(JET)のベース・ディレクトリを参照します。JET_BASE_DIRECTORYを参照するためにサポートされている構文は、次のとおりです。

#JET_BASE_DIRECTORY#

2.9.4.27 JET_CSS_DIRECTORY

JET_CSS_DIRECTORY置換文字列を使用して、Oracle Application Expressに付属のOracle JavaScript拡張機能ツールキット(JET)のベース・ディレクトリを参照します。JET_CSS_DIRECTORYを参照するためにサポートされている構文は、次のとおりです。

#JET_CSS_DIRECTORY#

2.9.4.28 JET_JS_DIRECTORY

JET_JS_DIRECTORY置換文字列を使用して、Oracle Application Expressに付属のOracle JavaScript拡張機能ツールキット(JET)のコンポーネントのJavaScriptディレクトリを参照します。JET_JS_DIRECTORYを参照するためにサポートされている構文は、次のとおりです。

#JET_JS_DIRECTORY#

2.9.4.29 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.9.4.30 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.9.4.31 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.9.4.32 PROXY_SERVER

PROXY_SERVERは、アプリケーション属性です。この属性は、ソースがURLであるリージョンによって使用される場合があります。次に、直接PL/SQL参照用の適切な構文を示します。この参照は、データベースからリモートWebサーバーにアクセスするためのPL/SQLを記述する場合に使用します(たとえば、データベースに付属するutl_httpパッケージを使用する場合)。

APEX_APPLICATION.G_PROXY_SERVER

2.9.4.33 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.9.4.34 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.9.4.35 REQUESTの使用

REQUESTは、通常、受入れプロセス(ページのポスト時に発生するプロセス)中に参照されます。この項では、REQUEST置換文字列の使用方法に関する追加情報について説明します。

トピック:

- ポストされたページのREQUESTの有効範囲および値について

- 「対象ボタン」属性について

- 宣言条件を使用したREQUESTの参照について

- 表示プロセスでのREQUESTの使用について

- BRANCH_TO_PAGE_ACCEPTの使用について

関連項目:

REQUEST

2.9.4.35.1 ポストされたページのREQUESTの有効範囲および値について

ページをポストすると、受入れプロセスが起動されます。受入れプロセスは、計算、検証、プロセスおよびブランチで構成されています。REQUESTの値は、受入れプロセスの各フェーズで使用可能です。アプリケーションが別のページにブランチされると、REQUESTはNULLに設定されます。

REQUESTの値は、ユーザーがクリックするボタンの名前か、またはユーザーが選択するタブの名前です。たとえば、名前がCHANGEでラベルがApply Changeというボタンがあるとします。ユーザーがこのボタンをクリックすると、REQUESTの値がCHANGEになります。

2.9.4.35.2 「対象ボタン」属性について

検証、プロセスおよびブランチには「対象ボタン」属性があります。この属性は、選択リストとして表示され、カレント・ページにあるボタン名を含みます。「対象ボタン」から選択した場合、ボタンのREQUEST値を検証、プロセスまたはブランチに関連付けます。

ページの送信にボタンを使用する場合、REQUEST値がページに渡されます。受入れプロセス・ロジックにより、「対象ボタン」属性を使用する各検証、プロセスおよびブランチが評価され、コンポーネントを実行(起動)するかどうかが決定されます。コンポーネントの1つが実行される場合、関連付けられたボタンをユーザーが実際にクリックしてページが送信されたとはみなさないでください。同じリクエスト値を使用する別のボタンがページを送信した可能性があります。同様に、ページのJavaScriptもページを送信してリクエスト値を渡します。

2.9.4.35.3 宣言条件を使用したREQUESTの参照について

多くの開発者は、条件を使用してREQUESTを参照します。たとえば、ユーザーがレポート・ページ上の「実行」をクリックしたときにページ区切りをリセットする必要がある場合があります。ページ区切りは、送信時ページ・プロセスを作成してリセットできます。ページ・プロセスには、条件「リクエスト=式1」を使用して条件を付けることができます。

送信時ページ・プロセスに条件を設定するには、次のステップを実行します。

1. 「条件」で、条件タイプ「リクエスト=式1」を選択します。

2. 式1で「実行」を実行します。

2.9.4.35.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開発ガイド

2.9.4.35.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.9.4.36 SCHEMA OWNER

PL/SQLコードからアプリケーションへのコールを生成する場合、Oracle Application Expressスキーマの所有者を参照する必要があります。次に、直接PL/SQLの参照用の適切な構文を示します。

APEX_APPLICATION.G_FLOW_SCHEMA_OWNER

また、#FLOW_OWNER#を使用してSQL問合せおよびPL/SQL(リージョンやプロセスなど)でこの値を参照することもできます。

2.9.4.37 SQLERRM

SQLERRMは、アプリケーション・リージョン・エラー・メッセージでのみ使用可能なテンプレート置換です。リージョン・テンプレート置換を参照するためにサポートされている構文は、次のとおりです。

#SQLERRM#

2.9.4.38 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.9.4.39 THEME_DB_IMAGES

テーマの「ファイルの接頭辞」設定に関係なく、データベースにテーマ定義とともに格納されているファイルを常に参照するには、THEME_DB_IMAGES置換文字列を使用します。テンプレート置換のためにサポートされている構文は、次のとおりです。

#THEME_DB_IMAGES#

2.9.4.40 THEME_IMAGES

テーマ定義とともに格納されているファイルを参照するには、THEME_IMAGES置換文字列を使用します。テンプレート置換のためにサポートされている構文は、次のとおりです。

#THEME_IMAGES#

2.9.4.41 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.9.4.42 WORKSPACE_ID

ワークスペースIDを参照するには、この置換文字列を使用します。表2-36に、WORKSPACE_IDを参照するためにサポートされている構文を示します。

表2-36 WORKSPACE_ID構文

参照タイプ

構文

バインド変数

:WORKSPACE_ID

PL/SQL

V('WORKSPACE_ID')

置換文字列

&WORKSPACE_ID.

SYS_CONTEXT variable

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には、様々なパッケージ・アプリケーションが含まれています。開発者は、パッケージ・アプリケーションをインストールおよび実行して、作成可能なアプリケーションのタイプや特定のタイプのページを構成する方法について詳しく理解できます。

ヒント:

新しいワークスペースの作成時、デフォルトでは、デモンストレーション・アプリケーションおよびデモンストレーション・データベース・オブジェクトは作成されません。この動作を変更するには、インスタンス管理者は、管理サービス・アプリケーションの「機能構成」設定を変更する必要があります。Oracle Application Express管理ガイドの新規ワークスペースでのデモンストレーション・オブジェクトの作成の有効化および新規ワークスペースでのWebシート・オブジェクトの作成の有効化

トピック:

- パッケージ・アプリケーションについて

- 完全開発環境でのパッケージ・アプリケーションの管理

- サンプル・データベース・アプリケーションの理解

- AnyCo IT部門Webシートの理解

- パッケージ・アプリケーション管理の使用

- 「パッケージ・アプリケーションのみ」ワークスペースの使用

3.1 パッケージ・アプリケーションについて

「パッケージ・アプリケーション」ギャラリには、サンプル・アプリケーション、生産性アプリケーションおよびカスタム・アプリケーションの3つのタイプのアプリケーションが含まれています。

サンプルと生産性アプリケーションの間の主な相違点は、サポート・レベルです。デフォルトでは、サンプル・アプリケーションは完全に編集可能です。対照的に、パッケージ・アプリケーションを編集するには、そのロックを解除する必要があります。アプリケーションのロックを解除すると、そのアプリケーションは今後のアップグレードまたはOracleサポートによるサポートを受けられなくなります。

サンプル・アプリケーション

グループ名が示すように、Oracle提供のサンプル・アプリケーションは完全なアプリケーションではなく、かわりにコード・スニペットやサンプル・コードが含まれています。サンプル・アプリケーションはワークスペースでのインストールに使用でき、デフォルトで編集可能です。

生産性アプリケーション

生産性アプリケーションは、完全に機能するアプリケーションで、特定のビジネス要件に対応するように設計されています。生産性アプリケーションをそのままインストールして実行および使用することも、それを分析して特定のタイプの機能を作成する方法の理解に役立てることもできます。生産性アプリケーションはワークスペースでのインストールに使用できますが、デフォルトで編集可能ではありません。

カスタム・アプリケーション

カスタム・アプリケーションは、ユーザーが作成し、インスタンス管理者が管理するアプリケーションです。Oracle提供のパッケージ・アプリケーションと同様に、カスタム・パッケージ・アプリケーションには、通常、アプリケーション・ページとサポートするデータベース・オブジェクトの両方が含まれています。開発者は、アプリケーション・エクスポートを使用してカスタム・アプリケーションを作成します。エクスポート後、インスタンス管理者がインポートして使用可能にします。カスタム・アプリケーションはワークスペースでのインストールに使用できますが、デフォルトで編集可能ではありません。

関連項目:

『Oracle Application Express管理ガイド』のカスタム・アプリケーションの管理に関する項

3.2 完全開発環境でのパッケージ・アプリケーションの管理

開発者は、完全開発環境でパッケージ・アプリケーションを表示、インストール、実行、削除、ロック解除、エクスポート、認証変更および更新できます。

トピック:

- パッケージ・アプリケーションの表示

- パッケージ・アプリケーションのインストール

- インストールしたパッケージ・アプリケーションの実行

- インストールしたパッケージ・アプリケーションの削除

- インストールしたパッケージ・アプリケーションの認証の変更

- インストールした生産性アプリケーションのロック解除

- パッケージ・アプリケーションの更新

関連項目:

Oracle Application Express管理ガイドの「カスタム・アプリケーションの管理」および「パッケージ・アプリケーションのみ」ワークスペースの使用

3.2.1 パッケージ・アプリケーションの表示

パッケージ・アプリケーションを表示、インストール、実行、削除、ロック解除、エクスポート、認証変更および更新するには、パッケージ・アプリケーション・ページを使用します。

ヒント:

新しいワークスペースでは、アプリケーション・ビルダー・ホームページに、「パッケージ・アプリケーションのインストール」というラベルが付いたグレーのボックスが表示されます。ショートカットとして「パッケージ・アプリケーションのインストール」をクリックして、パッケージ・アプリケーション・ページにアクセスして、パッケージ・アプリケーションをインストールします。

パッケージ・アプリケーション・ページにアクセスするには、次のステップを実行します。

1. Oracle Application Expressにサインインします。

2. ワークスペースのホームページで、「パッケージ・アプリケーション」アイコンをクリックします。
パッケージ・アプリケーション・ページが表示されます。

3. インストールするアプリケーションを探します。表示を絞り込むには、ページ上部の「検索」フィールドを使用します。
パッケージ・アプリケーションの詳細ページが表示され、アプリケーションに関するサマリー情報が表示されます。

4. パッケージ・アプリケーションの詳細ページでは、次の操作を実行できます。

ヒント:

実際に表示されるオプションは、アプリケーションがインストールされているかどうかによって異なります。

- パッケージ・アプリケーションのインストール。インストールされていない場合は、「パッケージ・アプリケーションのインストール」をクリックしてインストールします。

- 管理。インストールされている場合は、「管理」をクリックすると、アプリケーション認証の変更、ロック解除またはアプリケーションの削除を実行できます。

- 実行。インストールされている場合は、「実行」をクリックしてアプリケーションを実行します。

関連項目:

- パッケージ・アプリケーションのインストール

- 「インストールしたパッケージ・アプリケーションの削除」

- 「インストールしたパッケージ・アプリケーションの認証の変更」

- 「インストールした生産性アプリケーションのロック解除」

- 「パッケージ・アプリケーションの更新」

3.2.2 パッケージ・アプリケーションのインストール

ヒント:

新しいワークスペースでは、アプリケーション・ビルダー・ホームページに、「パッケージ・アプリケーションのインストール」というラベルが付いたグレーのボックスが表示されます。ショートカットとして「パッケージ・アプリケーションのインストール」をクリックして、パッケージ・アプリケーション・ページにアクセスします。

パッケージ・アプリケーションをインストールするには、次のステップを実行します。

1. Oracle Application Expressにサインインします。

ワークスペースのホームページが表示されます。

2. 「パッケージ・アプリケーション」アイコンをクリックします。

パッケージ・アプリケーション・ページが表示されます。

3. インストールするアプリケーションを探します。表示を絞り込むには、ページ上部の「検索」フィールドを使用します

4. インストールするアプリケーションをクリックします。

パッケージ・アプリケーションの詳細ページが表示されます。

5. 「パッケージ・アプリケーションのインストール」をクリックします。

6. 認証スキームを選択し、「次へ」をクリックします。

7. 「パッケージ・アプリケーションのインストール」を再度クリックします。

パッケージ・アプリケーションの詳細ページが表示されます。ページ上部に、成功メッセージApplication installed,が表示されます。

8. 「管理」をクリックします。

「管理」ダイアログに次の3つのボタンが表示されます。

- 認証の変更

- ロック解除 削除

- 削除

ヒント:

「ロック解除」は、「パッケージ・アプリケーションのみ」ワークスペースでは使用できません。

9. アプリケーションを実行するには、「実行」アイコンをクリックします。

関連項目:

- 「インストールしたパッケージ・アプリケーションの認証の変更」

- 「インストールした生産性アプリケーションのロック解除」

- 「インストールしたパッケージ・アプリケーションの削除」

- インストールしたパッケージ・アプリケーションの実行

3.2.3 インストールしたパッケージ・アプリケーションの実行

インストールしたパッケージ・アプリケーションを実行するには、次のステップを実行します。

1. ワークスペースのホームページで、「パッケージ・アプリケーション」アイコンをクリックします。
パッケージ・アプリケーション・ページが表示されます。

2. 「インストール済」タブをクリックし、アプリケーションを選択して、「実行」アイコンをクリックします。

3. 適切な資格証明を入力します。

a. ユーザー名: ワークスペース・ユーザー名を入力します。

b. パスワード: ワークスペース・パスワードを入力します。

c. 「サインイン」をクリックします。

アプリケーションが新しいウィンドウに表示されます。

関連項目:

アプリケーションの実行方法にブラウザが及ぼす影響

3.2.4 インストールしたパッケージ・アプリケーションの削除

インストールしたパッケージ・アプリケーションを削除するには、次のステップを実行します。

1. ワークスペースのホームページで、「パッケージ・アプリケーション」アイコンをクリックします。

パッケージ・アプリケーション・ページが表示されます。

2. 「インストール済」タブをクリックして、削除するアプリケーションを選択します。

3. 「管理」をクリックします。

4. 「削除」をクリックします。

5. メッセージが表示されたら、「アプリケーションの削除」をクリックします。

ヒント:

このタスクは、アプリケーション詳細ページで実行することもできます。パッケージ・アプリケーションの表示を参照してください。

3.2.5 インストールしたパッケージ・アプリケーションの認証の変更

インストールしたパッケージ・アプリケーションの認証を変更するには、次のステップを実行します。

1. ワークスペースのホームページで、「パッケージ・アプリケーション」アイコンをクリックします。

パッケージ・アプリケーション・ページが表示されます。

2. 「インストール済」タブをクリックして、アプリケーションを選択します。

3. 「管理」をクリックします。

4. 「認証の変更」をクリックします。

認証の変更ページが表示されます。

5. 「認証」から、認証スキームを選択し、「変更の適用」をクリックします。

ヒント:

このタスクは、アプリケーション詳細ページで実行することもできます。パッケージ・アプリケーションの表示を参照してください。

関連項目:

認証によるユーザー・アイデンティティの証明

3.2.6 インストールした生産性アプリケーションのロック解除

Oracle提供のサンプルと生産性アプリケーションの間の主な相違点は、サポート・レベルです。生産性アプリケーションをインストールした場合、それを編集するには、ロックを解除する必要があります。デフォルトでは、サンプル・アプリケーションは完全に編集可能です。

注意:

生産性アプリケーションのロックを解除すると、そのアプリケーションは今後のアップグレードまたはOracleサポートによるサポートを受けられなくなります。

インストールした生産性アプリケーションのロックを解除するには、次のステップを実行します。

1. ワークスペースのホームページで、「パッケージ・アプリケーション」アイコンをクリックします。

パッケージ・アプリケーション・ページが表示されます。

2. 「インストール済」タブをクリックして、アプリケーションを選択します。

3. 「管理」をクリックします。

4. 「ロック解除」をクリックします。

ヒント:

「ロック解除」は、「パッケージ・アプリケーションのみ」ワークスペースでは使用できません。

パッケージ・アプリケーションのロック解除ページが表示されます。

5. 「アプリケーションのロック解除」をクリックします。

関連項目:

パッケージ・アプリケーションのインストール

3.2.7 パッケージ・アプリケーションの更新

パッケージ・アプリケーションの詳細ページに「更新」ボタンが表示される場合は、パッケージ・アプリケーションを更新できます。

パッケージ・アプリケーションを更新するには、次のステップを実行します。

1. ワークスペースのホームページで、「パッケージ・アプリケーション」アイコンをクリックします。

パッケージ・アプリケーション・ページが表示されます。

2. 「インストール済」タブをクリックして、削除するアプリケーションを選択します。

3. 「アプリケーションの更新」をクリックします。

パッケージ・アプリケーションの更新ページが表示されます。

注意:

サンプル・アプリケーションはデフォルトでロック解除されているため、更新できません。最新のサンプル・アプリケーションにアクセスする場合は、ワークスペースからサンプル・アプリケーションを削除して、「パッケージ・アプリケーション」ギャラリから再インストールすることをお薦めします。

関連項目:

インストールしたパッケージ・アプリケーションの実行

3.3 サンプル・データベース・アプリケーションの理解

サンプル・データベース・アプリケーションには、衣料品の注文および顧客情報を表示、更新および検索するための使用しやすいインタフェースがあります。「Home」、「Customers」「Products」、「Orders」および「Reports」ナビゲーション・メニューを使用して、ページ間を移動できます。すべてのサンプル・パッケージ・アプリケーションと同様に、サンプル・データベース・アプリケーションは完全に編集可能です。

トピック:

- サンプル・データベース・アプリケーションのインストールおよび実行

- サンプル・データベース・アプリケーションの理解

- サンプル・データベース・アプリケーションの変更

3.3.1 サンプル・データベース・アプリケーションのインストールおよび実行

サンプル・データベース・アプリケーションをインストールするには、次のステップを実行します。

1. Oracle Application Expressにサインインします。

ワークスペースのホームページが表示されます。

2. 「パッケージ・アプリケーション」アイコンをクリックします。

パッケージ・アプリケーション・ページが表示されます。

3. サンプル・データベース・アプリケーションを見つけて選択します。

ヒント:

表示を絞り込むには、ページ上部の「検索」フィールドを使用します。

パッケージ・アプリケーションの詳細ページが表示されます。

4. 「パッケージ・アプリケーションのインストール」をクリックします。

5. 認証スキームを選択し、「次へ」をクリックします。

6. 「パッケージ・アプリケーションのインストール」を再度クリックします。

パッケージ・アプリケーションの詳細ページが表示されます。ページ上部に、成功メッセージApplication installed,が表示されます。

7. アプリケーションを実行するには、「実行」をクリックします。適切なログイン資格証明を入力します。

a. ユーザー名: ワークスペース・ユーザー名を入力します。

b. パスワード: ワークスペース・パスワードを入力します。

c. 「サインイン」をクリックします。

ヒント:

パッケージ・アプリケーションをインストールすると、パッケージ・アプリケーション・ページの「インストールしたパッケージ・アプリケーション」に表示されます。

3.3.2 サンプル・データベース・アプリケーションの理解

サンプル・データベース・アプリケーションでは、次のことを示します。

- サマリー情報を表示する方法の例。

- 顧客、製品および注文の表示、更新および追加に関するレポートおよびフォーム

- Oracle Application Expressで使用可能な各種のチャートおよびマップ

- デスクトップ・ページで使用可能な機能のほとんどが複製されるモバイル・ページ

サンプル・データベース・アプリケーションには、次の組込み機能および主要なページがあります。

ヒント:

左ナビゲーション・メニューのサイズは、ウィンドウのサイズに応じて変化します。この項の一部の図では、ナビゲーション・メニューが最小化されています。

トピック:

- 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 - Top Productsは対話モード・レポートです。レポートは基礎となるSQL文に基づいており、Customersページに表示される情報のサブセットを示します。ユーザーは、製品をクリックするか、リージョンの右上隅にある「view Products」アイコン(右矢印)をクリックすることによって、追加の詳細を表示できます。

- 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. 顧客を削除するには、「Delete」をクリックします。

3.3.2.3.2 顧客の作成

新しい顧客を追加するには、次のステップを実行します。

1. 「Create Customer」ボタンをクリックします。

2. Customer Detailsページで、フィールドを編集し、「Add Customer」をクリックします。

3.3.2.3.3 データのアップロード

データをアップロードするには、次のステップを実行します。

1. 「データをアップロード」ボタンをクリックします。

2. 「インポート元」で、次のステップを実行します。

a. インポート元: 次のいずれかを選択します。

- ファイルをアップロード(カンマ区切り(*.csv)またはタブ区切り)。選択されている場合、「File Name」フォーム要素からファイルを選択します。

- コピー・アンド・ペースト。選択した場合は、ウィンドウの下部に「コピー・アンド・ペースト」フィールドが表示されます。

b. セパレータ: 列区切り文字を指定します。タブ区切りには\tを使用します。

c. 「囲み文字(オプション)」: 区切り文字を入力します。詳細は、フィールドレベル・ヘルプを参照してください。

d. 1行目に列名がある: 「はい」を選択または選択解除します。

e. ファイルの文字セット: 適切なファイルの文字セットを選択します。

f. 「次へ」をクリックします。

3. 「データと表のマッピング」でマッピングを確認し、「次へ」をクリックします。

4. 「データのロード」をクリックします。

5. 結果を確認します。

6. 「終了」をクリックします。

3.3.2.4 Productsページ

Productsページでは、製品情報を表示および編集できます。「Products」リージョンは、データベースに格納されたイメージを表示するカスタム・ファンクションを使用するSQL問合せに基づいています。

デフォルトでは、このページは「レポート」ビューに表示されます。「アクション」メニューの左側にある「アイコンの表示」および「詳細の表示」をクリックして、表示を変更できます。「レポート」ビューでは、列ヘッダーをクリックし、アイコンを選択して、列でソートできます。「アクション」メニューを使用すればレポートの外観を変更できます。

関連項目:

「実行中のアプリケーションでの対話モード・レポートのカスタマイズ」および「「アクション」メニューについて」

3.3.2.5 Productsページの使用

この項では、Customersページに組み込まれている機能について説明します。

トピック:

- 製品の編集

- 製品の追加

3.3.2.5.1 製品の編集

既存の製品を更新するには、次のステップを実行します。

1. 製品名をクリックします。

2. Product Detailsページで、フィールドを編集し、「変更の適用」をクリックします。

3. 製品を削除するには、「Delete」をクリックします。

3.3.2.5.2 製品の追加

新しい製品を追加するには、次のステップを実行します。

1. 「Add 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. 「Place order」ボタンをクリックします。

Identify Customerウィザードが表示されます。

2. 画面上の指示に従って注文情報を入力します。

3. 「Complete Order」をクリックします。

注文の確認ページが表示されます。

4. 「Close」をクリックします。

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. 特定の顧客または製品を編集するには、それを選択します。

フォームが表示されます。コンテンツを編集でき、その後「Apply Changes」をクリックします。レコードを削除するには、「Delete」をクリックします。

5. Homeページに戻るには、左上の「Home」アイコンをクリックします。

ホーム・ページが表示されます。

6. Homeページで、次を実行します。

- サンプル・データベース・アプリケーションのデスクトップ・バージョンに戻るには、「Full Site」をクリックします。

- アプリケーション・ビルダーに戻るには、「Logout」をクリックします。

関連項目:

インストールしたパッケージ・アプリケーションの実行

3.3.3 サンプル・データベース・アプリケーションの変更

サンプル・データベース・アプリケーションについて調査することは、Oracle Application Expressでのアプリケーションの構築方法を学習する1つの方法となります。

トピック:

- サンプル・データベース・アプリケーションを変更する理由

- サンプル・データベース・アプリケーションの編集

関連項目:

完全開発環境でのパッケージ・アプリケーションの管理

3.3.3.1 サンプル・データベース・アプリケーションを変更する理由

サンプル・データベース・アプリケーションなど、パッケージ・アプリケーションで使用可能な機能の種類を理解したら、次のステップは、各ページの構成を理解することです。早く理解するための効果的な方法は、パッケージ・アプリケーションのページを分析および分解することです。何かを破損しても、すぐにパッケージ・アプリケーションを削除してインストールしなおすことができます。

ヒント:

Oracle Application Expressには、サンプルと生産性アプリケーションの2種類のパッケージ・アプリケーションがあります。デフォルトでは、サンプル・アプリケーションは完全に編集可能です。対照的に、生産性アプリケーションを編集するには、そのロックを解除する必要があります。生産性パッケージ・アプリケーションのロックを解除すると、そのアプリケーションは今後のアップグレードまたはOracleサポートによるサポートを受けられなくなります。

3.3.3.2 サンプル・データベース・アプリケーションの編集

ヒント:

デスクトップ・アプリケーション・ページを作成するとき、ページ・モードとして「標準」または「モーダル」を選択します。標準ページは、標準のOracle Application Expressページです。モーダル・ダイアログは、エンド・ユーザーが閉じるまでアクティブのままになるオーバーレイ・ウィンドウです。編集可能な標準ページを実行すると、ページ下部に実行時開発者ツールバーが表示されます。開発者ツールバーを使用すると、迅速に、カレント・アプリケーションまたは現在実行されている標準ページを編集したり、セッション・ステートを表示することができます。実行時開発者ツールバーからモーダル・ダイアログ・ページを編集することはできません。

実行中のアプリケーションを編集するには、実行時開発者ツールバーの「アプリケーション」リンクをクリックします。アプリケーションのホームページが表示されます。アプリケーションIDとアプリケーション名がページ上部に表示されます。

アプリケーションを構成するページがアプリケーションのホームページの下部に表示されます。特定のページにアクセスするには、そのページをクリックします。特定のページを検索するには、「検索」フィールドに、ページ・タイトルに対する大/小文字を区別しない問合せまたはページ番号を入力して、「実行」をクリックします。

関連項目:

アプリケーションのホームページの使用 および実行時開発者ツールバー

3.4 AnyCo IT部門Webシートの理解

AnyCo IT部門は、多数のWebシートの機能と特長を重点的に紹介するサンプル・アプリケーションであり、いくつかのデータ・グリッドを使用して埋込みのレポートおよびチャートにデータを追加する方法を説明しています。すべてのサンプル・パッケージ・アプリケーションと同様に、AnyCo IT部門は完全に編集可能です。

トピック:

- AnyCo IT部門のインストールおよび実行

- Webシート・ナビゲーションの理解

- AnyCo IT部門の理解

- Webシート・コンテンツの変更

関連項目:

Webシート・アプリケーションの作成およびOracle Application Expressエンド・ユーザー・ガイドの「ワークシートの使用」

3.4.1 AnyCo IT部門のインストールおよび実行

「サンプルWebシート - AnyCo IT部門」をインストールして実行するには、次のステップを実行します。

1. Oracle Application Expressにサインインします。
ワークスペースのホームページが表示されます。

2. 「パッケージ・アプリケーション」アイコンをクリックします。
パッケージ・アプリケーション・ページが表示されます。

3. 「サンプルWebシート - AnyCo IT部門」を探して選択します。

ヒント:

表示を絞り込むには、ページ上部の「検索」フィールドを使用します。

パッケージ・アプリケーションの詳細ページが表示されます。

4. 「パッケージ・アプリケーションのインストール」をクリックします。

5. 認証スキームを選択し、「次へ」をクリックします。

6. 「パッケージ・アプリケーションのインストール」をクリックします。
成功メッセージが表示されます。

7. アプリケーションを実行するには、「実行」アイコンをクリックします。

8. 適切なログイン資格証明を入力します。

- ユーザー名: ワークスペース・ユーザー名を入力します。

- パスワード: ワークスペース・パスワードを入力します。

- 「サインイン」をクリックします。

ホームページに新しいウィンドウが表示されます。

関連項目:

アプリケーションの実行方法にブラウザが及ぼす影響

3.4.2 Webシート・ナビゲーションの理解

すべてのWebシートに、ページ内やページ間を簡単に移動するための、共通のナビゲーション要素が含まれています。各Webシート・ページは、セクションに分かれています。セクション・タイトルの左側にある矢印をクリックして、ページ・セクションを展開および縮小できます。次の例では、「Systems Overview」は縮小されています。

ブレッドクラムを使用したWebシート・ページ間のナビゲート

ブレッドクラムは、すべてのWebシート・ページの上部に表示されます。「ホーム」ブレッドクラムをクリックすると、Webシートのすべての上位レベル・ページへのリンクのメニューが表示されます。

3.4.3 AnyCo IT部門の理解

「サンプルWebシート - AnyCo IT部門」は、次の機能を示します。

- Webシート・ページを使用したテキスト、データおよびイメージの共有方法の例

- ページ・セクションおよびページ間の階層的なナビゲーション

- 形式が設定されたテキストと、それに含まれる、形式を簡単に設定できるリンク

- データ・グリッドの作成による表形式データの表示、およびレポート、対話モード・レポートまたはチャートとしてのコンテンツの表示

次の項では、各ページで使用可能な特定の機能について説明します。

トピック:

- ページ間のナビゲートおよびページ・セクションの表示

- Homeページ

- Projectsページ

- 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 (ナビゲーション)

- Systems Overview

- Systems Maintenance

- Purchasing Projections

「Systems」は、「Systems Overview」、「Systems Maintenance」および「Purchasing Projections」の各セクションへのリンクが含まれているナビゲーション・セクションです。

「Systems Overview」は、埋込みイメージが含まれているテキスト・セクションです。

「Systems 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シート・アプリケーションの作成

3.4.4.2 Webシート・セクションの更新

Webシート・セクションを更新するには、次のステップを実行します。

1. Webシートを実行します。

2. セクションの右上に表示される「編集」アイコンをクリックします。

セクションの編集ページが表示されます。特定のセクションを編集する方法は、セクション・タイプによって異なります。

3. 表示されたフィールドを編集します。

4. 書式設定を変更するには、右上隅にあるツールバーの展開アイコンをクリックします。

ツールバーが表示されます。カーソルをアイコンに重ねると、説明ツールチップが表示されます。

5. このツールバーを非表示にするには、ツールバーの折り畳みアイコンをクリックします。

6. 変更を保存するには、「変更の適用」をクリックします。

注意:

「パッケージ・アプリケーションについて」

3.5 パッケージ・アプリケーション管理の使用

管理者は「パッケージ・アプリケーション管理」を使用して、ワークスペースでパッケージ・アプリケーションを管理および監視します。

トピック:

- サービス・リクエストの作成

- ワークスペース・プリファレンスの設定

- ユーザーの管理

- 保存された対話モード・レポートの管理

- 対話モード・レポートのサブスクリプションの管理

- アクティビティ・レポートの表示

- ページ・ビューの表示

- トップ・ユーザーの表示

関連項目:

『Oracle Application Express管理ガイド』のワークスペースとアプリケーションの管理に関する項

3.5.1 サービス・リクエストの作成

ヒント:

管理者権限を持つユーザーのみが、この機能にアクセスできます。

追加の記憶域またはサービス停止のサービス・リクエストを作成するには、次のステップを実行します。

1. Oracle Application Expressにサインインします。

2. 「パッケージ・アプリケーション」をクリックします。

3. 「管理」をクリックします。

4. 「サービス・リクエストの作成」をクリックします。

5. リクエストするサービスのタイプを指定するには、次のいずれかを選択します。

- 記憶域のリクエスト

- 終了のリクエスト

ヒント:

ワークスペースで使用可能な空き領域の容量を表示するには、「表領域使用率」を展開し、「表領域使用率の詳細レポート(数秒かかります)」を選択します。

6. 画面に表示されるステップに従います。

3.5.2 ワークスペース・プリファレンスの設定

ヒント:

管理者権限を持つユーザーのみが、この機能にアクセスできます。

管理者は、ワークスペース・プリファレンスの設定ページでアカウント・ログイン制御を構成できます。

ワークスペース・プリファレンスを設定するには、次のステップを実行します。

1. Oracle Application Expressにサインインします。

2. 「パッケージ・アプリケーション」をクリックします。

3. 「管理」をクリックします。

4. 「ワークスペース・プリファレンスの設定」をクリックします。

5. 「アカウント・ログイン制御」には、次の項目があります。

ヒント:

属性の詳細は、フィールドレベル・ヘルプを参照してください。

a. アカウントの有効期限およびロック: Application Expressエンド・ユーザー・アカウントを期限切れにしたりロックできるかどうかを決定するために選択します。この機能は、Application Expressユーザー管理インタフェースを使用して作成されたエンド・ユーザー・アカウントにのみ適用されます。

b. 許可されるログイン失敗の最大回数: エンド・ユーザー・アカウントがロックされるまでに許可される認証の連続失敗の最大回数を正の整数で入力します。このフィールドの値を指定しない場合は、「許可されるログイン失敗の最大回数」のインスタンス・レベルの設定が使用されます。

c. エンドユーザー・アカウント・ライフタイム(日): エンド・ユーザー・アカウントのパスワードを使用できる期限が切れるまでの最大日数を正の整数で入力します。このフィールドの値を指定しない場合は、アカウント・パスワード・ライフタイムのインスタンス・レベルの設定が使用されます。

6. 「変更の適用」をクリックします。

3.5.3 ユーザーの管理

ヒント:

管理者権限を持つユーザーのみが、この機能にアクセスできます。このオプションは、「パッケージ・アプリケーションのみ」ワークスペースのみで使用可能であり、完全ワークスペースでは使用できません。

新しいユーザー・アカウントの作成、既存のユーザー・アカウントの管理およびユーザー・パスワードの変更を行うには、「ユーザーの管理」をクリックします。

「パッケージ・アプリケーションのみ」ワークスペースでユーザーを管理するには、次のステップを実行します。

1. 「パッケージ・アプリケーションのみ」ワークスペースにサインインします。

2. 「パッケージ・アプリケーション管理」をクリックします。

3. 「ユーザーの管理」をクリックします。

ユーザーの管理は、「パッケージ・アプリケーションのみ」ワークスペースで、ワークスペースレベルと同様に機能します。

関連項目:

『Oracle Application Express管理ガイド』のワークスペースでのユーザーの管理に関する項

3.5.4 保存された対話モード・レポートの管理

パッケージ・アプリケーションのユーザーによって作成された対話モード・レポートを表示および管理するには、「保存されたレポート」をクリックします。

保存された対話モード・レポートを管理するには、次の手順を実行します。

1. Oracle Application Expressにサインインします。

2. 「パッケージ・アプリケーション」をクリックします。

3. 「管理」をクリックします。

4. 「保存されたレポート」をクリックします。

保存された対話モード・レポートの管理は、「パッケージ・アプリケーションのみ」ワークスペースで、ワークスペースレベルと同様に機能します。

関連項目:

『Oracle Application Express管理ガイド』の保存された対話モード・レポートの表示および削除に関する項

3.5.5 対話モード・レポートのサブスクリプションの管理

パッケージ・アプリケーションのユーザーによって作成された対話モード・レポートのサブスクリプションを表示および管理するには、「サブスクリプション」をクリックします。

対話モード・レポートのサブスクリプションを管理するには、次の手順を実行します。

1. Oracle Application Expressにサインインします。

2. 「パッケージ・アプリケーション」をクリックします。

3. 「管理」をクリックします。

4. 「サブスクリプション」をクリックします。

対話モード・レポートのサブスクリプションの管理は、「パッケージ・アプリケーションのみ」ワークスペースで、ワークスペースレベルと同様に機能します。

関連項目:

Oracle Application Express管理ガイドの「対話モード・レポートのサブスクリプションの管理」

3.5.6 アクティビティ・レポートの表示

個別のユーザーについてレポートするアプリケーション・アクティビティの月次カレンダおよび日別の合計ページ・ビューを表示するには、「アプリケーション・アクティビティ」をクリックします。

「アプリケーション・アクティビティ」レポートを表示するには、次のステップを実行します。

1. Oracle Application Expressにサインインします。

2. 「パッケージ・アプリケーション」をクリックします。

3. 「管理」をクリックします。

4. 「パッケージ・アプリケーション・アクティビティ」をクリックします。

アプリケーション・アクティビティの月次カレンダが表示されます。

3.5.7 ページ・ビューの表示

各ページ・ビューの対話モード・レポートを表示し、ユーザー、ユーザー、経過時間およびページの詳細を示すには、「ページ・ビュー」をクリックします。

「ページ・ビュー」レポートを表示するには、次のステップを実行します。

1. Oracle Application Expressにサインインします。

2. 「パッケージ・アプリケーション」をクリックします。

3. 「管理」をクリックします。

4. 「ページ・ビュー」をクリックします。

3.5.8 トップ・ユーザーの表示

ユーザーごとに集計されたページ・ビューのレポートを表示するには、「トップ・ユーザー」をクリックします。

「トップ・ユーザー」レポートを表示するには、次のステップを実行します。

1. Oracle Application Expressにサインインします。

2. 「パッケージ・アプリケーション」をクリックします。

3. 「管理」をクリックします。

4. 「トップ・ユーザー」をクリックします。

3.6 「パッケージ・アプリケーションのみ」ワークスペースの使用

「パッケージ・アプリケーションのみ」ワークスペースを使用すると、開発者は、他の開発者および管理者とパッケージ・アプリケーションを共有できます。

注意:

この情報は、Oracle Database Cloud Service (Database Schema)には適用されません。

トピック:

- 「パッケージ・アプリケーションのみ」ワークスペースとは

- 「パッケージ・アプリケーションのみ」ワークスペースのリクエスト

- 「パッケージ・アプリケーションのみ」ワークスペースへのサインイン

- パッケージ・アプリケーション・ページの使用

3.6.1 「パッケージ・アプリケーションのみ」ワークスペースとは

「パッケージ・アプリケーションのみ」ワークスペースを使用すると、開発者は、他の開発者および管理者とパッケージ・アプリケーションを共有できます。これには、アプリケーション・ビルダーやSQLワークショップなどの開発ツールへのアクセスは含まれていません。「パッケージ・アプリケーションのみ」ワークスペースには、パッケージ・アプリケーション・ページおよびパッケージ・アプリケーション管理ページが含まれています。

ヒント:

エンド・ユーザーは「パッケージ・アプリケーションのみ」ワークスペースにアクセスできません。エンド・ユーザーは、既存のデータベースまたはWebシート・アプリケーションのみを実行できます。

3.6.2 「パッケージ・アプリケーションのみ」ワークスペースのリクエスト

「パッケージ・アプリケーションのみ」ワークスペースをリクエストするには、次のステップを実行します。

1. Webブラウザで、Oracle Application Expressのサインイン・ページにナビゲートします。

「サインイン」ページが表示されます。

2. 「ワークスペース」で、「ワークスペースのリクエスト」をクリックします。

サービスのリクエスト・ウィザードが表示されます。

3. 「パッケージ・アプリケーションのみ」を選択し、「次へ」をクリックします。

4. 画面に表示されるステップに従います。

詳細は、フィールドレベル・ヘルプを参照してください。

ヒント:

開発コンポーネントへのアクセスを無効化することによって、ワークスペースにアプリケーション・ビルダーなどの開発ツールを含めるかどうかを手動で制御できます。『Oracle Application Express管理ガイド』のワークスペース・プリファレンスの構成に関する項およびインスタンスのコンポーネント可用性の管理に関する項を参照してください。

3.6.3 「パッケージ・アプリケーションのみ」ワークスペースへのサインイン

ヒント:

サンプル・アプリケーションは、「パッケージ・アプリケーションのみ」ワークスペースでは使用できません。それ以外の場合、「パッケージ・アプリケーションのみ」ワークスペースのパッケージ・アプリケーション・ページは、完全開発環境と同様に動作します。完全開発環境でのパッケージ・アプリケーションの管理を参照してください。

「パッケージ・アプリケーションのみ」ワークスペースにサインインするには、次のステップを実行します。

1. 「パッケージ・アプリケーションのみ」ワークスペースにサインインします。

2. 「パッケージ・アプリケーション」アイコンをクリックします。

パッケージ・アプリケーション・ページが表示されます。

3. 「パッケージ・アプリケーション管理」をクリックして、パッケージ・アプリケーション管理ページにアクセスします。

関連項目:

パッケージ・アプリケーション管理の使用

3.6.4 パッケージ・アプリケーション・ページの使用

ヒント:

サンプル・アプリケーションは、「パッケージ・アプリケーションのみ」ワークスペースでは使用できません。それ以外の場合、「パッケージ・アプリケーションのみ」ワークスペースのパッケージ・アプリケーション・ページは、完全開発環境と同様に動作します。完全開発環境でのパッケージ・アプリケーションの管理を参照してください。

パッケージ・アプリケーション・ページにアクセスするには、次のステップを実行します。

1. 「パッケージ・アプリケーションのみ」ワークスペースにサインインします。

2. 「パッケージ・アプリケーション」アイコンをクリックします。

パッケージ・アプリケーション・ページが表示されます。

3. アプリケーションを検索するには、「検索」フィールドに検索語を入力します。

4. 表示するアプリケーションを選択します。

パッケージ・アプリケーションの詳細ページが表示されます。このページを使用して、パッケージ・アプリケーション、アプリケーションのインストール、アプリケーションの削除または以前にインストールしたパッケージ・アプリケーションの認証の変更に関する情報を表示します。

4 チーム開発によるアプリケーション・ライフサイクルの管理

チーム開発では、開発者が、新機能、機能に関連しないタスク(To Do)、バグおよびマイルストンを追跡することによって開発プロセスを管理できます。ユーザーはリアルタイム・フィードバックを提供でき、このフィードバックはTo Do、バグまたは機能に分類できます。

トピック:

- チーム開発へのアクセス

- チーム開発のホームページ

- タグ・サマリーの利用について

- 機能の追跡

- マイルストンの追跡

- To Doの追跡

- バグの管理

- フィードバックの管理

- チーム開発ユーティリティの管理

関連項目:

『Oracle Application Express管理ガイド』のチーム開発の管理に関する項

4.1 チーム開発へのアクセス

チーム開発にアクセスするには、次のステップを実行します。

1. Oracle Application Expressにサインインします。

ワークスペースのホームページが表示されます。

2. 「チーム開発」アイコンをクリックします。

チーム開発のホームページが表示されます。

関連項目:

チーム開発のホームページ

4.2 チーム開発のホームページ

チーム開発のホームページに、次の大きいアイコンが表示されます。

- 「マイルストン」。開発プロセスに関連するイベントを追跡し、マイルストンを機能、バグおよびTo Doに関連付けます。

- 「機能」。機能が最初に構想されてから実装されるまでを追跡します。機能は、リリース、割当て先、タグまたは関連付けられたマイルストン別に編成できます。

- 「To Do」。割当て、優先度付け、タグ付けおよび追跡が可能なアクション・アイテムを管理します。また、To Doに親タスクを関連付けることもできます。機能またはマイルストンに関連付けることもできますが、それは必須ではありません。

- 「バグ」。ソフトウェアの不具合またはバグを追跡します。バグは、割当て、マイルストンへの関連付けおよび追跡(期日、ステータスなどの属性を使用)が可能です。

- 「フィードバック」。アプリケーション・ユーザーからリアルタイムのコメント、拡張リクエストおよびバグを収集します。

「ニュース」リージョン

「ニュース」リージョンを使用して、他の開発者とやりとりします。ニュースを追加したり、他のワークスペース・ユーザーがポストしたニュース・エントリを表示することができます。ニュースは、Application Expressのホームページ、チーム開発のホームページおよびニュース・ページに表示されます。

「ユーティリティ」リージョン

「ユーティリティ」リージョンはページの右側に表示され、チーム開発のユーティリティ・ページへのクイック・アクセスを提供します。ユーティリティ・ページにアクセスするには、「すべてのユーティリティ」をクリックするか、特定のリンクをクリックします。

サマリー・リージョン

チーム開発のホームページの下部には、次のサマリー・リージョンがあります。

- 「マイルストン」。最終リリース・マイルストンまでの日数のサマリーが示されます。

- 「バグ」。クローズ・バグのサマリーが示されます。

- 「機能」。機能的に完全な機能の割合が表示されます。

- 「To Do」。完了したTo Doの割合が表示されます。

- 「フィードバック」。最新のフィードバック・エントリが表示されます。

- 「チーム開発のサマリー」。機能、To Do、マイルストン、バグおよびフィードバック・エントリの総数が表示されます。

- 「タグ」。すべてのチーム開発コンポーネントに関連付けられているすべてのタグの、重み付けリストを表示します。ハイパーリンクをクリックすると、選択したタグが付いたすべてのコンポーネントを示す検索ページが表示されます。タグ・サマリーを使用して、チーム開発コンポーネントを効果的に管理できます。このサマリーに情報を移入するには、「チーム開発」コンポーネント(機能、To Doタスク、バグおよびフィードバック・エントリ)を編集し、「タグ」フィールドを更新します。

ヒント:

ほとんどのサマリー・リージョンには、右上隅にプラス記号(+)と大なり記号(>)が表示されます。コンポーネントを追加する場合はプラス記号(+)をクリックし、コンポーネント・ダッシュボード・ページにリンクする場合は大なり記号(>)をクリックします。

関連項目:

「ニュース・エントリの管理」

4.3 タグ・サマリーの利用について

チーム開発のホームページにあるタグ・サマリーには、すべてのチーム開発コンポーネントに関連付けられているすべてのタグの重み付けリストが表示されます。ハイパーリンクをクリックすると、選択したタグが付いたすべてのコンポーネントを示す検索ページが表示されます。タグ・クラウド・サマリーを使用して、チーム開発コンポーネントを効果的に管理できます。

このサマリーに情報を移入するには、各チーム開発コンポーネント(つまり、機能、To Doタスク、バグおよびフィードバック・エントリ)の「タグ」フィールドを編集します。

4.4 機能の追跡

機能ページを使用して、機能が最初に構想されてから実装されるまでを追跡します。機能は、リリース、割当て先、タグまたは関連付けられたマイルストン別に編成できます。

トピック:

- 機能レポートの表示

- 機能の作成

- 親機能の作成について

- 機能の更新

- 機能にファイルを添付する方法

- その他の機能レポートの表示

4.4.1 機能レポートの表示

機能を表示するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「チーム開発」アイコンをクリックします。

2. 「機能」アイコンをクリックします。

機能ダッシュボードが表示されます。機能ダッシュボードには、ワークスペース内で定義されている機能の概要が表示されます。

3. 「リリース」、「承認ステータス」、「割当て先」または「アプリケーション」リストから選択し、「設定」をクリックすることで、表示をカスタマイズできます。

4. 「レポート」タブをクリックします。

機能レポート・ページが表示されます。ページの外観をカスタマイズするには、ページ上部にある検索バーを使用します。

関連項目:

「実行中のアプリケーションでの対話モード・レポートのカスタマイズ」および「機能の更新」

4.4.2 機能の作成

機能を作成するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「チーム開発」アイコンをクリックします。

2. 「機能」アイコンをクリックします。
機能ダッシュボードが表示されます。

3. 「機能の作成」をクリックします。

4. 該当するフィールドに入力します。必須フィールドには、赤いアスタリスク(*)が付いています。
属性の詳細は、フィールドレベル・ヘルプを参照してください。

5. 編集可能な選択リストに新しい値を追加するには、「新規」というタイトルが付いたフィールドに値を入力します。たとえば、「所有者」リストに名前を追加するには、「新規所有者」に値を入力します。
入力した値が追加されます。

6. 「機能の作成」をクリックします。

関連項目:

「フォーカス領域の編集」および「フィールドレベル・ヘルプの表示」

4.4.3 親機能の作成について

親機能属性を使用すると、階層的に機能をグループ化できます。親機能を選択すると、親/子関係が作成されます。ツリー・ビューで機能を表示すると、機能は、まずリリースごとにグループ化され、次に、親ごとにグループ化されます。

関連項目:

機能ツリーの表示

4.4.4 機能の更新

機能を更新するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「チーム開発」アイコンをクリックします。

2. 「機能」アイコンをクリックします。

機能ダッシュボードが表示されます。

3. 「レポート」タブをクリックします。

レポート・ページが表示されます。

4. 機能を編集するには、機能名をクリックします。

5. 該当するフィールドを編集します。

6. 「変更の適用」をクリックします。

関連項目:

フォーカス領域の編集

4.4.5 機能にファイルを添付する方法

ワークスペースレベルで有効にすると、機能にファイルを添付できます。

トピック:

- 機能へのファイルの添付

- 添付ファイルの表示、編集および削除

関連項目:

添付ファイルの表示およびOracle Application Express管理ガイドの「チーム開発でのファイル・アップロードに対するサポートの有効化」

4.4.5.1 機能へのファイルの添付

ヒント:

この機能を使用するには、「管理」、「サービスの管理」、「ワークスペース・プリファレンスの設定」で、「ファイル・リポジトリの有効化」属性を「はい」に設定する必要があります。

機能へファイルを添付するには、次の手順を実行します。

1. 機能へナビゲートします。

2. 「アクション」から、「ファイルの追加」をクリックします。

3. 「ファイルの追加」で、次の項目を指定します。

a. ファイル: アップロードするファイルを探します。

b. 説明: ファイルの説明を入力します。

c. 「ファイルの追加」をクリックします。

「ファイル」という新しいリージョンが「機能」ページの下部に表示されます。

注意:

「機能の更新」

4.4.5.2 添付ファイルの表示、編集および削除

添付ファイルを表示、編集または削除するには、次の手順を実行します。

1. 「機能」ページへナビゲートします。機能の更新を参照してください。

2. 「ファイル」までスクロールします。

3. 「ファイルの表示および管理」をクリックします。

「ファイル」ページが表示されます。

4. ファイルを表示するには、名前をクリックします。

5. ファイルの説明を編集するには、「編集」アイコンをクリックします。

6. 添付ファイルを削除するには、赤色の「削除」アイコンをクリックします。

4.4.6 その他の機能レポートの表示

この項では、チーム開発で使用できる機能レポートについて説明します。

トピック:

- 機能ツリーの表示

- 機能カレンダの表示

- 機能履歴レポートの表示

- 機能進捗ログの表示

- 機能フォーカス領域チャートの表示

- 承認ステータスの表示

- 機能所有者チャートの表示

- 機能ユーティリティ

関連項目:

チーム開発ユーティリティへのアクセス

4.4.6.1 機能ツリーの表示

機能ツリーを表示するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「チーム開発」アイコンをクリックします。

2. 「機能」アイコンをクリックします。

機能ダッシュボードが表示されます。

3. 「ツリー」タブをクリックします。

ツリー・ページには、リリースごとの階層ツリーで機能が表示されます。

新しいリリースを選択するには、「リリース」リストから選択し、「設定」をクリックします。機能の数と完了率が、機能名の右側に表示されます。完了率を非表示または表示するには、「完了率を含む」で「はい」または「いいえ」を選択し、「設定」をクリックします。機能を編集するには、機能をクリックします。

機能は、まずリリースごとにグループ化され、次に、親ごとにグループ化されます。グループ化を開くには、機能名の左側にある小さな三角形をクリックします。

ヒント:

指定のリリースごとに機能を表示する場合、異なるリリースに親または子機能を持つ機能は表示されません。

すべてのグループ化を開閉するには、「すべて開く」および「すべて閉じる」ボタンをクリックします。機能を表示または編集するには、機能名をクリックします。機能を作成するには、「機能の作成」をクリックし、オンラインの指示に従います。

4.4.6.2 機能カレンダの表示

機能カレンダを表示するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「チーム開発」アイコンをクリックします。

2. 「機能」アイコンをクリックします。

機能ダッシュボードが表示されます。

3. 「カレンダ」タブをクリックします。

カレンダ・ページには、機能がカレンダ形式で期日別または完了日別に表示されます。

親機能が定義されている場合、カレンダ形式で期日または完了日が表示されます。「前へ」および「次へ」ボタンをクリックして、他の月を表示します。当日の機能マイルストンを表示するには、「今日」をクリックします。特定の機能を表示するには、機能名をクリックします。機能を作成するには、「機能の作成」をクリックし、オンラインの指示に従います。

4.4.6.3 機能履歴レポートの表示

機能履歴レポートを表示するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「チーム開発」アイコンをクリックします。

2. 「機能」アイコンをクリックします。

機能ダッシュボードが表示されます。

3. 「履歴」タブをクリックします。

機能履歴レポートには、最近変更された機能の対話モード・レポートが表示されます。古い値と新しい値および更新者の情報などが含まれます。レポートをカスタマイズするには、ページ上部にある検索バーを使用します。

4. 特定の機能を表示するには、機能名をクリックします。

関連項目:

「実行中のアプリケーションでの対話モード・レポートのカスタマイズ」および「「アクション」メニューについて」

4.4.6.4 機能進捗ログの表示

機能進捗ログを表示するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「チーム開発」アイコンをクリックします。

2. 「機能」アイコンをクリックします。

機能ダッシュボードが表示されます。

3. 「進捗ログ」タブをクリックします。

進捗ログ・ページは、進捗ログ・エントリの対話モード・レポートとして表示されます。レポートをカスタマイズするには、ページ上部にある検索バーを使用します。

4. ログを編集するには、「編集」アイコンをクリックします。

関連項目:

「実行中のアプリケーションでの対話モード・レポートのカスタマイズ」および「「アクション」メニューについて」

4.4.6.5 機能フォーカス領域チャートの表示

機能フォーカス領域チャートを表示するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「チーム開発」アイコンをクリックします。

2. 「機能」アイコンをクリックします。

機能ダッシュボードが表示されます。

3. 「フォーカス領域」タブをクリックします。

フォーカス領域ページには、リリース別に定義されたフォーカス領域ごとの機能数のチャートが表示されます。チャートを変更するには、別のリリースまたは別の割当て先を選択し、「設定」をクリックします。デフォルトのチャートに戻すには、「リセット」をクリックします。

関連項目:

フォーカス領域の編集

4.4.6.6 承認ステータスの表示

機能の承認ステータスを表示するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「チーム開発」アイコンをクリックします。

2. 「機能」アイコンをクリックします。

機能ダッシュボードが表示されます。

3. 「承認ステータス」タブをクリックします。

承認ステータス・ページに、ステータスと説明が表示されます。新しいステータスを作成するには、「作成」をクリックします。

4.4.6.7 機能所有者チャートの表示

機能所有者チャートを表示するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「チーム開発」アイコンをクリックします。

2. 「機能」アイコンをクリックします。

機能ダッシュボードが表示されます。

3. 「機能所有者」タブをクリックします。

機能所有者ページには、所有者別の機能数のチャートが表示されます。チャートを変更するには、別のリリース、最小ステータスまたは最大ステータスを選択し、「設定」をクリックします。デフォルトのチャートに戻すには、「リセット」をクリックします。

4.4.6.8 機能ユーティリティ

「機能ユーティリティ」を使用します。複数の機能のマイルストンを管理するためのアクション・ページを選択します。次のいずれかを選択し、画面の指示に従います。

- マイルストンを機能(現在マイルストンが割り当てられていないもののみ)に割り当てます。

- 機能の期日をマイルストン日付に設定します(機能のみに影響を及ぼす)。

- 期日を超過した機能のマイルストンを変更します。

- オープンな機能の期限をプッシュします。

関連項目:

チーム開発ユーティリティへのアクセス

4.5 マイルストンの追跡

マイルストン・ページを使用して、重要なマイルストンを管理します。マイルストンによってイベントを追跡します。マイルストンは、機能、バグおよびTo Doに関連付けることができます。

トピック:

- マイルストン・レポートの表示

- マイルストンの作成

- マイルストンの更新

- その他のマイルストン・レポートの表示

4.5.1 マイルストン・レポートの表示

マイルストンを表示するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「チーム開発」アイコンをクリックします。

2. 「マイルストン」アイコンをクリックします。

マイルストン・ダッシュボードが表示されます。

マイルストン・ダッシュボードには、ワークスペース内のマイルストンの概要が表示されます。リリースでフィルタ処理したり、リンクから特定の1つまたは複数のマイルストンを所有者ごとに表示することができます。

3. 「レポート」タブをクリックします。

マイルストン・レポート・ページは、対話モード・レポートとして表示されます。ページの上部にある検索バーを使用して、ページの外観をカスタマイズできます。

関連項目:

「実行中のアプリケーションでの対話モード・レポートのカスタマイズ」および「マイルストンの更新」

4.5.2 マイルストンの作成

マイルストンを作成するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「チーム開発」アイコンをクリックします。

2. 「マイルストン」アイコンをクリックします。

マイルストン・ダッシュボード・ページが表示されます。

3. 「マイルストンの作成」をクリックします。

4. 該当するフィールドに入力します。必須フィールドには、赤いアスタリスク(*)が付いています。

属性の詳細は、フィールドレベル・ヘルプを参照してください。

5. 編集可能な選択リストに新しい値を追加するには、「新規」というタイトルが付いたフィールドに値を入力します。たとえば、「所有者」リストに名前を追加するには、「新規所有者」に値を入力します。

入力した値が追加されます。

6. 「マイルストンの作成」をクリックします。

4.5.3 マイルストンの更新

マイルストンを更新するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「チーム開発」アイコンをクリックします。

2. 「マイルストン」アイコンをクリックします。

マイルストン・ダッシュボード・ページが表示され、次のリージョンが表示されます。

3. 「マイルストン」タブをクリックします。

マイルストン・レポート・ページが表示されます。

4. マイルストンを選択します。

5. 該当するフィールドを編集します。

属性の詳細は、フィールドレベル・ヘルプを参照してください。

6. 「変更の適用」をクリックします。

4.5.4 その他のマイルストン・レポートの表示

この項では、チーム開発で使用できるマイルストン・レポートについて説明します。

トピック:

- マイルストン・カレンダの表示

- 「所有者別のマイルストン」レポートの表示

- 「マイルストン別の機能」レポートの表示

関連項目:

チーム開発ユーティリティへのアクセス

4.5.4.1 マイルストン・カレンダの表示

マイルストン・カレンダを表示するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「チーム開発」アイコンをクリックします。

2. 「マイルストン」アイコンをクリックします。

マイルストン・ダッシュボードが表示されます。

3. 「カレンダ」タブをクリックします。

カレンダ・ページには、マイルストンがカレンダ形式で日付別に表示されます。

リリースでフィルタするには、「リリース」リストから選択し、「設定」をクリックします。「前へ」および「次へ」ボタンをクリックして、他の月を表示します。当日のマイルストンを表示するには、「今日」をクリックします。特定のマイルストンを表示するには、ハイパーリンクをクリックします。マイルストンを作成するには、「マイルストンの作成」をクリックしてオンラインの指示に従ってください。

4.5.4.2 「所有者別のマイルストン」レポートの表示

「所有者別のマイルストン」レポートを表示するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「チーム開発」アイコンをクリックします。

2. 「マイルストン」アイコンをクリックします。

マイルストン・ダッシュボードが表示されます。

3. 「所有者別」タブをクリックします。

レポートを変更するには、別のリリースまたはマイルストンを選択し、「設定」をクリックします。デフォルトのチャートに戻すには、「リセット」をクリックします。

4.5.4.3 「マイルストン別の機能」レポートの表示

「マイルストン別の機能」レポートを表示するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「チーム開発」アイコンをクリックします。

2. 「マイルストン」アイコンをクリックします。

マイルストン・ダッシュボードが表示されます。

3. 「マイルストン別の機能」タブをクリックします。

「マイルストン別の機能」レポートは対話モード・レポートとして表示され、各マイルストンに関連する機能が表示されます。ページの上部にある検索バーを使用して、ページの外観をカスタマイズできます。

関連項目:

「実行中のアプリケーションでの対話モード・レポートのカスタマイズ」および「「アクション」メニューについて」

4.6 To Doの追跡

To Doは、機能ではなく作業割当てを追跡します。機能およびマイルストンに関連付けて、完了に必要なタスクを定義できます。To Doはリリース別に編成したり、開発者に割り当てたり、タグを付けることができます。

トピック:

- To Doの表示

- To Doの作成

- To Doの更新

- To Doに添付されたファイルの管理

- その他のTo Doレポートの表示

4.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の更新」

4.6.2 To Doの作成

To Doを作成するには、次の手順を実行します。

1. 「ワークスペース」ホームページで、「チーム開発」アイコンをクリックします。

2. 「To Do」アイコンをクリックします。

To Doダッシュボードが表示されます。

3. 「To Doの作成」をクリックします。

4. 該当するフィールドに入力します。必須フィールドには、赤いアスタリスク(*)が付いています。

属性の詳細は、フィールドレベル・ヘルプを参照してください。

5. 編集可能な選択リストに新しい値を追加するには、「新規」というタイトルが付いたフィールドに値を入力します。たとえば、「割当て先」リストに名前を追加するには、「新規割当て先」に値を入力します。

入力した値が追加されます。

6. 「To Doの作成」をクリックします。

関連項目:

「フィールドレベル・ヘルプの表示」

4.6.3 To Doの更新

To Doを更新するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「チーム開発」アイコンをクリックします。

2. 「To Do」アイコンをクリックします。

To Doダッシュボードが表示されます。

3. 「レポート」タブをクリックします。

4. To Doを選択します。

5. 該当するフィールドを編集します。

6. 「変更の適用」をクリックします。

4.6.4 To Doに添付されたファイルの管理

ワークスペースレベルで有効にすると、To Doにファイルを添付できます。

トピック:

- To Doへのファイルの添付

- 添付ファイルの表示、編集および削除

関連項目:

添付ファイルの表示およびOracle Application Express管理ガイドの「チーム開発でのファイル・アップロードに対するサポートの有効化」

4.6.4.1 To Doへのファイルの添付

ヒント:

この機能を使用するには、「管理」、「サービスの管理」、「ワークスペース・プリファレンスの設定」で、「ファイル・リポジトリの有効化」属性を「はい」に設定する必要があります。

To Doにファイルを添付するには、次の手順を実行します。

1. To Doへナビゲートします。

a. 「ワークスペース」ホームページで、「チーム開発」アイコンをクリックします。

b. 「To Do」アイコンをクリックします。
To Doダッシュボードが表示されます。

c. 「レポート」タブをクリックします。

d. To Doを選択します。

2. 「アクション」から、「ファイルの追加」をクリックします。

3. 「ファイルの追加」で、次の項目を指定します。

a. ファイル: アップロードするファイルを探します。

b. 説明: ファイルの説明を入力します。

c. 「ファイルの追加」をクリックします。

「ファイル」という新しいリージョンがページの下部に表示されます。

4.6.4.2 添付ファイルの表示、編集および削除

添付ファイルを管理するには、次の手順を実行します。

1. 「To Do」ページにナビゲートします。To Doの更新を参照してください。

2. 「ファイル」までスクロールします。

3. 「ファイルの表示および管理」をクリックします。

「ファイル」ページが表示されます。

4. ファイルを表示するには、名前をクリックします。

5. ファイルの説明を編集するには、「編集」アイコンをクリックします。

6. 添付ファイルを削除するには、「削除」アイコンをクリックします。

4.6.5 その他のTo Doレポートの表示

この項では、チーム開発で使用できるTo Doレポートについて説明します。

トピック:

- To Doカレンダの表示

- To Do進捗ログの表示

4.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の作成」をクリックしてオンラインの指示に従ってください。

4.6.5.2 To Do進捗ログの表示

To Doカレンダを表示するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「チーム開発」アイコンをクリックします。

2. 「To Do」アイコンをクリックします。

To Doダッシュボードが表示されます。

3. 「進捗ログ」タブをクリックします。

進捗ログ・ページには、進捗ログ・エントリの対話モード・レポートが表示されます。レポートをカスタマイズするには、ページ上部にある検索バーを使用します。ログを編集するには、「編集」アイコンをクリックします。

関連項目:

「実行中のアプリケーションでの対話モード・レポートのカスタマイズ」および「「アクション」メニューについて」

4.7 バグの管理

バグは、ソフトウェアの不具合を追跡するものです。バグは、割当て、マイルストンへの関連付けおよび追跡(期日、ステータスなどの属性を使用)が可能です。

トピック:

- バグの表示および編集

- バグの作成

- バグの編集

- バグに添付されたファイルの管理

- その他のバグ・レポートの表示

4.7.1 バグの表示および編集

バグを表示するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「チーム開発」アイコンをクリックします。

2. 「バグ」アイコンをクリックします。
バグ・ダッシュボードに、ソフトウェアの既知の不具合の概要が表示されます。

3. 「レポート」タブをクリックします。
バグ・レポート・ページが表示されます。ページ上部にある検索バーを使用して、ページの外観をカスタマイズします。

4. バグを編集するには、バグ・タイトルをクリックします。

関連項目:

「実行中のアプリケーションでの対話モード・レポートのカスタマイズ」および「バグの編集」

4.7.2 バグの作成

バグを作成するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「チーム開発」アイコンをクリックします。

2. 「バグ」アイコンをクリックします。
バグ・ダッシュボードが表示されます。

3. 「バグの作成」をクリックします。

4. 該当するフィールドに入力します。
必須フィールドには、赤いアスタリスク(*)が付いています。属性の詳細は、フィールドレベル・ヘルプを参照してください。

5. 編集可能な選択リストに新しい値を追加するには、「新規」というタイトルが付いたフィールドに値を入力します。たとえば、「割当て先」リストに名前を追加するには、「新規割当て先」に値を入力します。

入力した値が追加されます。

6. 「バグの作成」をクリックします。

関連項目:

「フィールドレベル・ヘルプの表示」

4.7.3 バグの編集

バグを編集するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「チーム開発」アイコンをクリックします。

2. 「バグ」アイコンをクリックします。
バグ・ダッシュボードに、ソフトウェアの既知の不具合の概要が表示されます。

3. 「レポート」タブをクリックします。
バグ・レポート・ページが表示されます。ページ上部にある検索バーを使用して、ページの外観をカスタマイズします。

4. バグを選択します。

5. 該当するフィールドを編集します。

属性の詳細は、フィールドレベル・ヘルプを参照してください。

6. 「変更の適用」をクリックします。

注意:

「フィールドレベル・ヘルプの表示」

4.7.4 バグに添付されたファイルの管理

ワークスペースレベルで有効にすると、バグにファイルを添付できます。

トピック:

- バグへのファイルの添付

- 添付ファイルの表示、編集および削除

関連項目:

添付ファイルの表示およびOracle Application Express管理ガイドの「チーム開発でのファイル・アップロードに対するサポートの有効化」

4.7.4.1 バグへのファイルの添付

ヒント:

この機能を使用するには、「管理」、「サービスの管理」、「ワークスペース・プリファレンスの設定」で、「ファイル・リポジトリの有効化」属性を「はい」に設定する必要があります。

バグへファイルを添付するには、次の手順を実行します。

1. 「ワークスペース」ホームページで、「チーム開発」アイコンをクリックします。

2. 「バグ」アイコンをクリックします。
バグ・ダッシュボードに、ソフトウェアの既知の不具合の概要が表示されます。

3. 「レポート」タブをクリックします。
バグ・レポート・ページが表示されます。ページ上部にある検索バーを使用して、ページの外観をカスタマイズします。

4. バグを編集するには、バグ・タイトルをクリックします。

5. 「アクション」で、「ファイルの追加」をクリックします。

6. 「ファイルの追加」で、次のステップを実行します。

a. ファイル: アップロードするファイルを探します。

b. 説明: ファイルの説明を入力します。

c. 「ファイルの追加」をクリックします。

「ファイル」という新しいリージョンがページの下部に表示されます。

4.7.4.2 添付ファイルの表示、編集および削除

添付ファイルを管理するには、次の手順を実行します。

1. 「バグ」ページへナビゲートします。バグの編集を参照してください。

2. 「ファイル」までスクロールします。

3. 「ファイルの表示および管理」をクリックします。

「ファイル」ページが表示されます。

4. ファイルを表示するには、名前をクリックします。

5. ファイルの説明を編集するには、「編集」アイコンをクリックします。

6. 添付ファイルを削除するには、「削除」アイコンをクリックします。

4.7.5 その他のバグ・レポートの表示

この項では、チーム開発で使用できるバグ・レポートについて説明します。

トピック:

- バグ・ダッシュボード

- バグ・カレンダの表示

- 開発者ごとのバグの表示

- 日別のバグの表示

4.7.5.1 バグ・ダッシュボード

バグ・ダッシュボードには、ソフトウェアの既知の不具合の概要が表示されます。ダッシュボード・ページには、次のリージョンがあります。

- クローズ率

- 割り当てられた開発者

- 重大度

- ステータス

ダッシュボードを編集するには、ページ上部にある「表示」および「リリース」リストを編集して、「設定」をクリックします。ダッシュボードをデフォルト表示にリセットするには、「リセット」ボタンをクリックします。

4.7.5.2 バグ・カレンダの表示

バグ・カレンダを表示するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「チーム開発」アイコンをクリックします。

2. 「バグ」アイコンをクリックします。

バグ・ダッシュボードが表示されます。

3. 「カレンダ」タブをクリックします。

カレンダ・ページの「表示」リストを使用して、推定クローズ日付のあるオープン・バグ、推定クローズ日付のないオープン・バグまたはクローズ・バグを表示します。「前へ」および「次へ」ボタンをクリックして、他の月を表示します。特定のバグを表示するには、バグの説明をクリックします。新しいバグを作成するには、「バグの作成」をクリックします。

4.7.5.3 開発者ごとのバグの表示

開発者別にバグを表示するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「チーム開発」アイコンをクリックします。

2. 「バグ」アイコンをクリックします。

バグ・ダッシュボードが表示されます。

3. 「開発者別」タブをクリックします。

開発者別ページには、バグが開発者別に表示されます。特定の割当て先に関連付けられているバグを表示するには、グラフの該当するセクションをクリックします。バグを開発者別に示したレポートが表示されます。

チャートを変更するには、別のリリースを選択し、「設定」をクリックします。デフォルトのチャートに戻すには、「リセット」をクリックします。新しいバグを作成するには、「バグの作成」をクリックします。

4.7.5.4 日別のバグの表示

日別にバグを表示するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「チーム開発」アイコンをクリックします。

2. 「バグ」アイコンをクリックします。

バグ・ダッシュボードが表示されます。

3. 「日別」タブをクリックします。

日別ページには、オープン・バグおよびクローズ・バグの数が日別に表示されます。チャートを変更するには、別のリリースを選択し、「設定」をクリックします。デフォルトの棒グラフに戻すには、「リセット」をクリックします。新しいバグを作成するには、「バグの作成」をクリックします。

4.8 フィードバックの管理

フィードバックは、アプリケーション・ユーザーからリアルタイム・コメント、拡張リクエストおよびバグを収集するプロセスです。アプリケーションのフィードバックを収集するには、フィードバック・ページを追加します。

トピック:

- フィードバックの表示

- アプリケーションへのフィードバック・ページの追加

- フィードバックの送信

- フィードバックの確認

- その他のフィードバック・レポートの表示

4.8.1 フィードバックの表示

フィードバックを表示するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「チーム開発」アイコンをクリックします。

2. 「フィードバック」アイコンをクリックします。

フィードバック・ダッシュボードが表示されます。

3. 「レポート」タブをクリックします。

フィードバック・レポート・ページには、フィードバック・エントリの詳細が表示されます。ページの上部にある検索バーを使用して、ページの外観をさらにカスタマイズできます。

関連項目:

「実行中のアプリケーションでの対話モード・レポートのカスタマイズ」

4.8.2 アプリケーションへのフィードバック・ページの追加

フィードバック・ページを使用して、アプリケーション・ユーザーからのフィードバックを収集できます。

アプリケーションにフィードバック・ページを追加するには、次のステップを実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。

2. それに関するフィードバックを追加するアプリケーションを選択します。
アプリケーションのホームページが表示されます。

3. 「ページの作成」ボタンをクリックします。

4. 「ページ・タイプ」で、「フィードバック・ページ」を選択します。

5. 「定義」は、次のようにします。

a. ページ番号 - デフォルトを受け入れるか、アプリケーション内のページを識別する整数値を指定します。

b. ページ名 - このページのテキスト名を指定します。

c. ページ・モード - ページ・モードを指定します。オプションの詳細は、フィールドレベル・ヘルプを参照してください。

d. ポップアップ・ページ・テンプレート - フィードバックを収集するために使用する、ポップアップ・ページのページ・テンプレートを選択します。

e. リージョン・テンプレート - フィードバックを収集するリージョンのリージョン・テンプレートを選択します。

f. ラベル・テンプレート - フィードバック・ページのアイテムに使用するラベル・テンプレートを選択します。

g. その他の属性 - フィードバック・ページに含める必要があるその他の属性の数を指定します。

ヒント:

その他の属性を指定する場合、それらの属性を編集して、ラベル、表示およびヘルプ・テキストを更新する必要があります。次に、フィードバックを保存するためにコールされるプロセスを更新して、すべての追加属性について正しいコンテキストが渡され、フィードバックの確認時に属性が表示されるようにする必要があります。

h. ナビゲーション・バーの作成 - カレント・アプリケーション内に、新しいフィードバック・ページを呼び出すためのナビゲーション・バー・エントリを作成するかどうかを指定します。

i. エントリ・ラベル - 新しいフィードバック・ページを呼び出すために使用する、新しいナビゲーション・バー・エントリの名前を入力します。

j. フィードバックの有効化 - この属性は、カレント・アプリケーションに対するフィードバック・サポートが有効化されていない場合にのみ表示されます。フィードバック・サポートを有効化するには、「はい」を選択します。

ヒント:

アプリケーション・レベルの属性「フィードバックを許可」の詳細は、アプリケーション属性の編集を参照してください。

6. 「作成」をクリックします。

4.8.3 フィードバックの送信

フィードバックを送信するには、次のステップを実行します。

1. フィードバック送信の対象となっているアプリケーションを実行します。

2. 「フィードバック」リンクをクリックします。

フィードバック・ウィンドウが表示されます。アプリケーションとページがウィンドウの上部に表示されます。開発者がこの情報を参照できるようになります。

3. 「フィードバック」にコメントを入力します。

4. 「フィードバック・タイプ」から、「一般的なコメント」、「拡張リクエスト」または「バグ」を選択します。

5. 「フィードバックの送信」をクリックします。

4.8.4 フィードバックの確認

フィードバックを確認するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「チーム開発」アイコンをクリックします。

2. 「フィードバック」アイコンをクリックします。
フィードバック・ダッシュボードが表示されます。

3. 「レポート」タブをクリックします。

4. フィードバック番号を選択し、フィードバックを確認します。

5. 「配置」で、次の操作を実行します。

a. ステータス: 新しいステータスを選択します。

b. タグは、対象のフィードバックをさらに詳しく説明するキーワードです。複数のタグを付ける場合は、カンマで区切ります。

c. 開発者のコメント: 追加のコメントを入力します。「開発者のコメント」はパブリックで表示可能ではないことに注意してください。

d. パブリック・レスポンス: パブリック・レスポンスを入力します。このレスポンスはパブリックで表示可能です。

6. フィードバックの記録方法を決定します。「配置」の右側で、次のいずれかをクリックします。

- 「バグとしてログイン」。適切な情報を入力し、「バグの作成」をクリックします。

- 「To Doとしてログイン」。適切な情報を入力し、「To Doの作成」をクリックします。

- 「機能としてログイン」。適切な情報を入力し、「機能としてログイン」をクリックします。

オプションの詳細は、フィールドレベル・ヘルプを参照してください。

7. フィードバック・エントリを削除するには、「削除」をクリックします。

8. 変更を送信するには、「変更の適用」をクリックします。

4.8.5 その他のフィードバック・レポートの表示

この項では、チーム開発で使用できるフィードバック・レポートについて説明します。

トピック:

- フィードバック・カレンダの表示

- ファイリング・ユーザー別のフィードバックの表示

4.8.5.1 フィードバック・カレンダの表示

フィードバック・カレンダを表示するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「チーム開発」アイコンをクリックします。

2. 「フィードバック」アイコンをクリックします。
フィードバック・ダッシュボードが表示されます。

3. 「フィードバック・カレンダ」タブをクリックします。
カレンダ・ページには、アプリケーションからのフィードバック・コメントの数が日別に表示されます。「前へ」および「次へ」ボタンをクリックして、他の月を表示します。

4.8.5.2 ファイリング・ユーザー別のフィードバックの表示

フィードバック・カレンダを表示するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「チーム開発」アイコンをクリックします。

2. 「フィードバック」アイコンをクリックします。
フィードバック・ダッシュボードが表示されます。

3. 「ファイリング・ユーザー別」タブをクリックします。
ファイリング・ユーザー別ページには、ファイリング・ユーザー別のオープン・フィードバックのチャートが表示されます。チャートのセクションをクリックして、詳細なレポートを表示します。

4.9 チーム開発ユーティリティの管理

「ユーティリティ」リージョンは、チーム開発のホームページの右側に表示されます。これらのリンクを使用して、チーム開発設定を構成し、リリース・サマリー情報を表示し、ファイル・アップロードに対するサポートを有効化し、機能ユーティリティにアクセスし、フォーカス領域を管理し、割当て先を更新し、アップロードされたファイルを表示し、データをパージし、ニュースを管理し、リンクを更新します。

トピック:

- チーム開発ユーティリティへのアクセス

- チーム開発の設定の構成

- リリース・サマリーの表示

- 機能ユーティリティの管理

- フォーカス領域の編集

- 添付ファイルの表示

- データのパージ

- ニュース・エントリの管理

- リンクの管理

関連項目:

『Oracle Application Express管理ガイド』のチーム開発の管理に関する項

4.9.1 チーム開発ユーティリティへのアクセス

チーム開発ユーティリティを使用して、チーム開発データを管理します。チーム開発ユーティリティには、チーム開発のホームページの「ユーティリティ」リージョンまたはユーティリティ・ページのいずれかからアクセスできます。

チーム開発ユーティリティにアクセスするには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「チーム開発」アイコンをクリックします。

2. ページの右側にある「ユーティリティ」リージョンを見つけます。

ヒント:

「ユーティリティ」リージョンでリンクをクリックするか、ユーティリティ・ページにアクセスすることで、ほとんどのユーティリティにアクセスできます。

3. ページの右側にある「ユーティリティ」リージョンで、「すべてのユーティリティ」をクリックします。

4. ユーティリティ・ページには、次のリンクがあります。

- チーム開発の設定 - To Doとバグの表示方法を指定し、リリース、所有者および優先度のデフォルト値を構成し、現在のワークスペースに対して有効にする追跡属性を決定します。

- リリース・サマリー: ワークスペースおよび開発者の統計を確認します。

- ファイルの有効化: ファイル・アップロードに対するサポートを追加できる管理ページにリンクします。

- 機能ユーティリティ - 複数の機能のマイルストンを一度に管理します。このページを使用すると、マイルストンを機能に割り当て、機能の期日をマイルストン日付に設定し、期日を超過した機能のマイルストンを変更し、オープンな機能の期日をプッシュできます。

- フォーカス領域の管理: 機能ページに表示されるフォーカス領域を管理します。

- 割当て先の更新: 選択したコンポーネントを再割当てできます。未完了のコンポーネントのみを再割当てできます(つまり、ステータスが100%未満か、マイルストン日付が将来の日付のコンポーネント)。

- ファイルの表示 - 機能、To Doおよびバグに添付されたアップロード済ファイルを管理します。

ヒント:

このオプションは、管理者がファイル・アップロード機能を有効にしたかどうかによって、「ファイルの表示」と「ファイルの有効化」を切り替えます。「ファイルの有効化」と表示された場合は、管理者によってファイル・アップロード機能がまだ有効化されていません。

- データの消去 - 選択したコンポーネントのすべてのエントリを削除します。このオプションは、新しい開発サイクルを開始するとき、またはテスト用のワークスペースの使用後に役立ちます。

- ニュースの管理: チーム開発のホームページおよびワークスペースのホームページに表示されるニュース・エントリを管理します。

- リンクの管理: 他のワークスペース・ユーザーと共有するリンクを管理します。

- To Doの自動作成: アプリケーションのすべてのページに自動的にTo Doを作成します。

- 期限経過したバグのプッシュ: オープン・バグの推定修正日を延期します。プッシュが必要なバグのみをフィルタ処理および選択して、任意の日数分延期できます。

関連項目:

- 「チーム開発の設定の構成」

- 『Oracle Application Express管理ガイド』のチーム開発でのファイル・アップロードに対するサポートの有効化に関する項

4.9.2 チーム開発の設定の構成

「チーム開発の設定」を使用すると、To Doとバグの表示方法、デフォルト値(リリース、所有者および優先度)、および現在のワークスペースに対して有効にする追跡属性を指定できます。

「チーム開発」設定を編集するには、次の手順を実行します。

1. 「ワークスペース」ホームページで、「チーム開発」アイコンをクリックします。

2. 「ユーティリティ」で、「チーム開発の設定」をクリックします。

設定ページが表示されます。

3. 対象となる属性を編集します。

属性の詳細は、フィールドレベル・ヘルプを参照してください。

4. 「変更の適用」をクリックします。

ヒント:

設定をデフォルト値に戻すには、「デフォルトにリセット」をクリックします。

4.9.3 リリース・サマリーの表示

「リリース・サマリー」レポートを使用すると、機能、To Doおよびバグを整理できます。

「リリース・サマリー」レポートにアクセスするには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「チーム開発」アイコンをクリックします。

2. 「ユーティリティ」で、「リリース・サマリー」をクリックします。
リリース・サマリー・ページが表示されます。

3. 検索バーを使用して、ビューを制限します。ビューをフィルタ処理するには、開発者またはリリースを選択し、「設定」をクリックします。

4. レポートを電子メールで送信するには、次の操作を実行します。

a. 「電子メール」をクリックします。
電子メール・レポート・ページが表示されます。

b. 該当するフィールドに入力します。必須フィールドには、赤いアスタリスク(*)が付いています。属性の詳細は、フィールドレベル・ヘルプを参照してください。

5. 「電子メール」をクリックします。

ヒント:

レポートをデフォルト・ビューに戻すには、「リセット」をクリックします。

4.9.4 機能ユーティリティの管理

機能ユーティリティ・ページを使用して、マイルストンを機能に割り当て、機能の期日をマイルストン日付に設定し、期日を超過した機能のマイルストンを変更し、オープンな機能の期日をプッシュできます。

機能ユーティリティにアクセスするには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「チーム開発」アイコンをクリックします。

2. 「ユーティリティ」で、「機能ユーティリティ」をクリックします。

3. 「機能ユーティリティ」で、ユーティリティを選択します。

- 機能へのマイルストンの割当て(現在マイルストンが割り当てられていない機能のみ)

- 機能の期日をマイルストン日付に設定(機能にのみ影響)

- 期日を超過した機能のマイルストンの変更

- オープンな機能の期限のプッシュ

4. 「次へ」をクリックします。

5. 画面に表示されるステップに従います。

4.9.5 フォーカス領域の編集

機能を作成または更新する際、「フォーカス領域」に割り当てることができます。

既存の機能「フォーカス領域」を編集するには、次の手順を実行します。

1. 「ワークスペース」ホームページで、「チーム開発」アイコンをクリックします。

2. 「ユーティリティ」で、「フォーカス領域の管理」をクリックします。

「フォーカス領域の管理」ページが表示されます。

3. 「フォーカス領域」を探し、「編集」アイコンをクリックします。

4. 「変更後の名前」に編集内容を入力します。

5. 「変更の適用」をクリックします。

4.9.6 添付ファイルの表示

ワークスペースレベルで有効にすると、機能、To Doまたはバグにファイルを添付できます。

ヒント:

この機能を使用するには、「管理」、「サービスの管理」、「ワークスペース・プリファレンスの設定」で、「ファイル・リポジトリの有効化」属性を「はい」に設定する必要があります。管理者は、「チーム・アクション」リストで「ファイルの有効化」をクリックすることで、チーム開発でこのページにアクセスすることもできます。

機能、To Doおよびバグに添付されたファイルを表示するには、次の手順を実行します。

1. 「ワークスペース」ホームページで、「チーム開発」アイコンをクリックします。

2. 「ユーティリティ」で、「ファイルの表示」をクリックします。

チーム開発ファイル・ページが表示されます。

3. ファイルを表示するには、名前をクリックします。

関連項目:

『Oracle Application Express管理ガイド』のチーム開発での添付ファイルに対するサポートの有効化に関する項。

4.9.7 データのパージ

データをパージすると、特定のタイプのデータに関連するすべてのデータ(機能、マイルストン、To Do、バグまたはフィードバック)が削除されます。

データをパージするには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「チーム開発」アイコンをクリックします。

2. 「ユーティリティ」で、「データのパージ」をクリックします。

3. 「データのパージ」で、パージするデータのタイプを選択し、「パージ」をクリックします。

4.9.8 ニュース・エントリの管理

「ニュース」リージョンは、現在のワークスペースの他のユーザーとやり取りする場合に使用します。ニュース・エントリを追加したり、他のワークスペース・ユーザーがポストしたニュース・エントリを表示することができます。ニュースは、Application Expressのホームページ、チーム開発のホームページおよびニュース・ページに表示されます。

ニュース・エントリを管理するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「チーム開発」アイコンをクリックします。

2. 「ユーティリティ」で、「ニュースの管理」をクリックします。
ニュース・ページが表示されます。

3. 検索バーを使用して、表示をフィルタ処理します。

4. ニュース・アイテムを追加するには、次のステップを実行します。

a. 「ニュースの追加」をクリックします。
ニュース・ページが表示されます。

b. 「ニュース・エントリ」フィールドにテキストを入力します。

c. 「ニュースの追加」をクリックします。

5. ニュース・アイテムを編集するには、次の操作を実行します。

a. ニュース・アイテムを選択します。

b. ニュース・エントリを編集します。

c. 「変更の適用」をクリックします。

6. ニュース・アイテムを削除するには、次の操作を実行します。

a. ニュース・アイテムを選択します。

b. 「削除」をクリックします。

4.9.9 リンクの管理

リンク・ページを使用して、チーム開発内のリンクを共有します。

トピック:

- リンク・ページへのリンクの追加

- リンクの編集または削除

4.9.9.1 リンク・ページへのリンクの追加

「リンク」ページにアクセスするには、次の手順を実行します。

1. 「ワークスペース」ホームページで、「チーム開発」アイコンをクリックします。

2. 「ユーティリティ」で、「リンクの管理」をクリックします。
リンク・ページが表示されます。

3. 検索バーを使用して、表示をフィルタ処理します。

4. リンクを追加するには:

a. 「リンクの作成」をクリックします。
リンク・ページが表示されます。

b. 該当するフィールドに入力します。必須フィールドには、赤いアスタリスク(*)が付いています。属性の詳細は、フィールドレベル・ヘルプを参照してください。

c. 「リンクの作成」をクリックします。

4.9.9.2 リンクの編集または削除

リンクを編集または削除するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「チーム開発」アイコンをクリックします。

2. 「ユーティリティ」で、「リンクの管理」をクリックします。
リンク・ページが表示されます。

3. リンクを編集する手順は、次のとおりです。

a. 「編集」アイコンをクリックします。
リンク・ページが表示されます。

b. 該当するフィールドを編集します。

c. 「変更の適用」をクリックします。

4. 新しいリンクを削除する手順は、次のとおりです。

a. 「編集」アイコンをクリックします。
リンク・ページが表示されます。

b. 「削除」をクリックします。

5 Webシート・アプリケーションの作成

Webシート・アプリケーションは、テキストとデータを組み合せた対話モードWebページです。この項では、Webシートの作成方法を説明します。

トピック:

- Webシート・アプリケーションについて

- Webシート・アプリケーションの作成

- 既存のWebシート・ページのコピー

- Webシートの実行

- ページの詳細の編集

- Webシート・アプリケーションの削除

- Webシート・ダッシュボードの表示

- Webシート・アクティビティの監視

- Webシート・プロパティの理解

- Webシート・アクセスの制御

関連項目:

- 『Oracle Application Expressエンド・ユーザーズ・ガイド』のWebシートの使用に関する項

- 『Oracle Application Express管理ガイド』のWebシート・データベース・オブジェクトの削除と検証に関する項およびサンプルWebシート・オブジェクトの作成の無効化に関する項

5.1 Webシート・アプリケーションについて

Webシート・アプリケーションは、テキストとデータを組み合せた対話モードWebページです。これらのアプリケーションは、ユーザーによって定義される非常に動的なアプリケーションです。Webシート・アプリケーションには、ナビゲーション・コントロール、検索機能や、ファイル、ノート、タグなどの注釈を追加する機能があります。Webシート・アプリケーションは、アクセス制御リストおよびいくつかの組込み認証モデルを使用して保護できます。

関連項目:

- 「データベース・アプリケーションとWebシート・アプリケーションの違い」

- 「AnyCo IT部門Webシートの理解」

- 『Oracle Application Expressエンド・ユーザーズ・ガイド』のWebシートの使用に関する項

5.2 Webシート・アプリケーションの作成

この項では、Webシート・アプリケーションの作成方法について説明します。アプリケーションの作成ウィザードを使用して、Webシート・アプリケーションを作成します。Webシート・ページを作成した後で、テキストまたはデータとしてコンテンツを追加します。

トピック:

- アプリケーション・ビルダーからのWebシートの作成

- 実行中のWebシートからのWebシート・アプリケーションの作成

関連項目:

- 『Oracle Application Expressエンド・ユーザーズ・ガイド』のWebシートの使用に関する項

- 「Webシート・データベース・オブジェクトの削除と検証」

- 「サンプルWebシート・オブジェクトの作成の無効化」

- 『Oracle Application Express管理ガイド』

5.2.1 アプリケーション・ビルダーからのWebシートの作成

Webシート・アプリケーションを作成するには、次のステップを実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. 「作成」ボタンをクリックします。

3. アプリケーション・タイプについて、「Webシート」を選択し、「次へ」をクリックします。

4. 「Webシートの作成」で、次の項目を指定します。

a. Webシート: アプリケーションを識別する一意の整数値を入力します。3000から9000の間のアプリケーションIDは内部使用向けに予約されています。

b. 名前: アプリケーションを識別するための名前を入力します。

c. SQLを許可: SQLタグおよびSQLレポートを定義できるかどうかを決定します。「はい」または「いいえ」を選択します。デフォルトでは、この属性は無効で、「いいえ」に設定されています。

d. スタート・ガイドを含める: このオプションを選択すると、Webシートのホーム・ページの最初のテキスト・セクションに、Webシートの使用に関する基本的な情報を含めます。1度確認した後、このテキスト・セクションを編集または削除できます。

5. 選択した内容を確認し、「Webシートの作成」をクリックします。
成功メッセージが表示されます。

6. レンダリングされたアプリケーションを表示するには、次のステップを実行します。

a. 「Webシートの実行」をクリックします。

b. Webシートの資格証明を入力します。

i. ユーザー名: ユーザー名を入力します。

ii. パスワード: パスワードを入力します。

iii. 「ログイン」または「サインイン」をクリックします。

ヒント:

表示される文言は、アプリケーションの作成者によって異なります。パッケージ・アプリケーションおよびOracle Application Express開発環境を含め、Oracleが提供するアプリケーションでは、「サインイン」/「サインアウト」が表示されます。ユーザーまたは開発者が作成したアプリケーションでは、「ログイン」/「ログアウト」が表示されます。

Webシート・アプリケーションが新しいウィンドウに表示されます。

Webシート・アプリケーションが新しいウィンドウに表示されます。

7. Webシート・コンテンツを追加します。

関連項目:

「Webシート・アプリケーションURLの公開について」および『Oracle Application Expressエンド・ユーザー・ガイド』のWebシートの使用に関する項

5.2.2 実行中のWebシートからのWebシート・アプリケーションの作成

実行中のWebシートからWebシート・アプリケーションを作成するには、次のステップを実行します。

1. Webシート・アプリケーションを実行します。Webシートの実行を参照してください。

2. 「作成」メニューから、「新しいWebシート」をクリックします。

3. 「Webシートの作成」で、次のステップを実行します。

a. Webシート: 一意の整数値を識別して、アプリケーションを識別します。3000から9000の間のアプリケーションIDは内部使用向けに予約されています。

b. 名前: アプリケーションを識別するための名前を入力します。

c. 説明: アプリケーションの説明を入力します。

d. 「次へ」をクリックします。

4. 選択した内容を確認し、「作成」をクリックします。

5. レンダリングされたWebシート・アプリケーションを表示するには、「Webシートの実行」をクリックします。
Webシート・アプリケーションが新しいウィンドウに表示されます。

6. Webシート・コンテンツを追加します。

関連項目:

- 「パッケージ・アプリケーションについて」

- 『Oracle Application Expressエンド・ユーザーズ・ガイド』のWebシートの使用に関する項

- 「Webシート・アプリケーションURLの公開について」

5.3 既存のWebシート・ページのコピー

既存のWebシート・ページをコピーするには、次のステップを実行します。

1. Webシート・アプリケーションを実行します。

2. 「作成」メニューから、「コピーの新規ページ」を選択します。

3. 「コピーの新規ページ」で、新しいページの名前を入力します。

4. 「ページのコピー」をクリックします。

成功メッセージが表示されます。

5. 次のいずれかを選択します。

- 現在のページの表示

- 新規ページの表示

ヒント:

ページの詳細を編集して、親ページを変更できます。ページの詳細の編集を参照してください。

関連項目:

「Webシートの実行」

5.4 Webシートの実行

レンダリングされたアプリケーションを表示するには、アプリケーションを実行するか、またはApplication Expressエンジンに送信します。

トピック:

- アプリケーション・ビルダーのホームページからのWebシートの実行

- アプリケーション・ホームページからのWebシートの実行

- WebシートURLの決定

関連項目:

Oracle Application Expressエンド・ユーザー・ガイドの「Webシートの使用」およびWebシート・アプリケーションURLの公開について

5.4.1 アプリケーション・ビルダーのホームページからのWebシートの実行

アプリケーション・ビルダーのホームページからWebシートを実行するには、次のステップを実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. 「検索」バーから、「レポートの表示」アイコンをクリックします。

3. 「アプリケーション」リストで、Webシート・アプリケーションを探します。

4. 右側の列にある「実行」アイコンをクリックします。

5. Webシートの資格証明を入力します。

a. ユーザー名: ユーザー名を入力します。

b. パスワード: パスワードを入力します。

c. 「ログイン」または「サインイン」をクリックします。

ヒント:

表示される文言は、アプリケーションの作成者によって異なります。パッケージ・アプリケーションおよびOracle Application Express開発環境を含め、Oracleが提供するアプリケーションでは、「サインイン」/「サインアウト」が表示されます。ユーザーまたは開発者が作成したアプリケーションでは、「ログイン」/「ログアウト」が表示されます。

Webシート・アプリケーションが新しいウィンドウに表示されます。

5.4.2 アプリケーション・ホームページからのWebシートの実行

アプリケーションのホームページからアプリケーションを実行するには、次のステップを実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。
アプリケーション・ビルダーのホームページが表示されます。

2. Webシート・アプリケーションを選択します。

3. 「実行」ボタンをクリックします。

4. Webシートの資格証明を入力します。

a. ユーザー名: ユーザー名を入力します。

b. パスワード: パスワードを入力します。

c. 「ログイン」または「サインイン」をクリックします。

ヒント:

表示される文言は、アプリケーションの作成者によって異なります。パッケージ・アプリケーションおよびOracle Application Express開発環境を含め、Oracleが提供するアプリケーションでは、「サインイン」/「サインアウト」が表示されます。ユーザーまたは開発者が作成したアプリケーションでは、「ログイン」/「ログアウト」が表示されます。

Webシート・アプリケーションが新しいウィンドウに表示されます。

5.4.3 WebシートURLの決定

Webシート・アプリケーションを完了すると、本番URLを公開できます。詳細は、Webシート・アプリケーションURLの公開についてを参照してください。

5.5 ページの詳細の編集

ページの詳細で、ページ番号、別名、親ページまたはページ詳細を変更できます。

ページの詳細を編集するには、次のステップを実行します。

1. Webシート・アプリケーションを実行します。

2. 「編集」メニューから、「ページの編集」を選択します。

3. 1つのページの詳細。

- 名前: ページの名前を指定します。このページ名は、ウィンドウ・タイトルおよびブレッドクラムに表示されます。

- 別名: ページの別名を使用して、他のページへのリンクをページ・セクションに作成できます。ページの別名は1つのアプリケーション内で一意である必要があります。

- 所有者: ページの所有者を指定します。

- 親ページ: 親ページを指定します。定義した親ページは、ブレッドクラムおよびページ間のナビゲーションの構築に使用されます。

- ページ詳細: ページについて説明する説明テキストです。

4. 「変更の適用」をクリックします。

成功メッセージが表示されます。

ヒント:

「コントロール・パネル」で、「ページの編集」をクリックしてページの詳細を編集することもできます。

関連項目:

「Webシートの実行」

5.6 Webシート・アプリケーションの削除

Webシートは、「Webシート・プロパティ」ページで削除します。

Webシート・アプリケーションを削除するには、次のステップを実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

アプリケーション・ビルダーのホームページが表示されます。

2. Webシート・アプリケーションを選択します。

「Webシート・プロパティ」ページが表示されます。

3. 「削除」をクリックします。

関連項目:

Webシート・プロパティの理解

5.7 Webシート・ダッシュボードの表示

Webシート・ダッシュボードには、カレントWebシート・アプリケーションの詳細(最近の変更、トップ・ユーザーおよびトップ・ページ)が表示されます。

Webシート・ダッシュボードを表示するには、次のステップを実行します。

1. Webシートを実行します。Webシートの実行を参照してください。

2. 「管理」メニューから、「ダッシュボード」を選択します。

ダッシュボードが次のセクションに分かれて表示されます。

- アプリケーション詳細

- 最近の変更

- トップ・ユーザー

- トップ・ページ

3. 時間枠を編集するには、「時間枠」リストから新しい値を選択します。

4. デフォルト設定に戻すには、「リセット」をクリックします。

5.8 Webシート・アクティビティの監視

アクティビティの監視ページを使用して、ページおよびコンテンツの使用状況、パフォーマンスおよび人気度を解析します。

アクティビティの監視ページにアクセスするには、次のステップを実行します。

1. Webシートにログインし、Webシートを実行します。

2. 「管理」メニューから、「アクティビティの監視」を選択します。

「アクティビティの監視」ページが表示されます。このページは次のセクションに分かれています。

- アクティビティ

- ページ・ビュー

- トップ・ページ

- トップ・データ・グリッド

- トップ・レポート

- トップ・ユーザー

- 注釈

- トップ・ファイル

- トップ・ノート

- トップ・タグ

各レポートは、対話モード・レポートとして表示されます。対話モード・レポートと「アクション」メニューの詳細は、「実行中のアプリケーションでの対話モード・レポートのカスタマイズ」を参照してください。

関連項目:

「Webシートの実行」

5.9 Webシート・プロパティの理解

実行中のWebシートの内部または外部から、「Webシート・プロパティ」ページにアクセスできます。「Webシート・プロパティ」ページを使用して、アプリケーションの一般的なデフォルト設定および動作を制御できます。ホームページは、そのWebシートを実行するときに、ユーザーが最初にアクセスするホームページです。アプリケーションの名前は、ブレッドクラム内に表示されます。

トピック:

- Webシート・プロパティの編集

- Webシート・プロパティ

関連項目:

Webシート・アプリケーションの削除

5.9.1 Webシート・プロパティの編集

「Webシート・プロパティ」ページにアクセスするには、次の手順を実行します。

1. Webシートにログインし、Webシートを実行します。

2. 「管理」メニューから、「Webシート・プロパティ」を選択します。

「Webシート・プロパティ」が表示されます。

3. セクションを表示するには、セクション・タイトルの左側にある大なり記号(>)をクリックします。

4. 適切なプロパティを編集し、「変更の適用」をクリックします。

関連項目:

「Webシートの実行」

5.9.2 Webシート・プロパティ

この項では、「Webシート・プロパティ」ページ上の属性について説明します。

- Webシート

- 詳細

- ロゴ

- スタイル

- 認証

- 認可

- SQL

トピック:

- Webシート

- 詳細

- ロゴ

- スタイル

- 認証

- 認可

- SQL

5.9.2.1 Webシート

「Webシート」セクションを使用して、一般的なWebシート・アプリケーション・プロパティを制御します。表5-1に、「アプリケーション」属性を示します。

表5-1 「Webシート」属性

属性

説明

名前

アプリケーションの名前を指定します。アプリケーションの実行中は、この名前がブレッドクラム内に表示されます。

ステータス

アプリケーションのステータスを指定します。

ホームページ

このWebシートのホームページを選択します。これは、Webシートを実行するときに、ユーザーに対して最初に表示されるページです。

アプリケーション日付書式

アプリケーションで使用する日付書式を決定します。

この日付書式を使用して、NLS_DATE_FORMATデータベース・セッションの設定が変更されてから、アプリケーション内のページが表示または送信されます。この値には、有効なOracle日付書式マスクを含むリテラル文字列、または置換構文を使用したアイテム参照を指定できます。値が指定されていない場合は、データベース・セッションからデフォルトの日付書式が実行時に取得されます。

デフォルトのアプリケーション言語

アプリケーションのデフォルト言語を指定します。ユーザーは、アプリケーション内から言語プリファレンスを変更できます。この言語リストは、インストールされたApplication Expressの翻訳済バージョンによって決まります。

デフォルトのアプリケーション地域

日付、言語、数字などの属性を制御する、アプリケーションのデフォルト地域を指定します。ユーザーは、アプリケーション内から地域プリファレンスを変更できます。

パスワードのリセットの表示

ログイン・ページでの「パスワードの再設定」リンクの表示を制御します。ユーザーは、このリンクを使用してパスワードをリセットできます。このオプションは、アプリケーションで「Application Expressアカウント」認証が使用されている場合にのみ機能します。

Webシートの電子メール送信元アドレス

Webシートで送信元アドレスとして使用する電子メール・アドレスを決定します。この送信元電子メール・アドレスは、Webシートのデータ・グリッドまたはレポート電子メール・ダウンロードから電子メールを送信する際に使用されます。

5.9.2.2 詳細

「詳細」セクションを使用して、アプリケーションの説明およびログイン・メッセージを編集します。表5-2に、「詳細」属性を示します。

表5-2 詳細

属性

説明

所有者

アプリケーションを所有するユーザーを指定します。

説明

アプリケーションについて説明するオプションの説明です。

ログイン・メッセージ

ログイン・ページにこのメッセージが表示されます。

5.9.2.3 ロゴ

「ロゴ」セクションを使用して、このWebシート・アプリケーションのロゴを作成します。このロゴは、Webシートの上部に表示されます。表5-3に、「ロゴ」属性を示します。

表5-3 ロゴ

属性

説明

ロゴ・タイプ

アプリケーションに使用するロゴのタイプを選択します。

ロゴ

アプリケーション・ロゴとして使用する完全なテキスト文字列を入力します。

5.9.2.4 スタイル

「スタイル」セクションを使用して、デフォルトのアプリケーション・スタイルを上書きし、カスタムCSSを使用します。

5.9.2.5 認証

「認証」セクションを使用して、このWebシートの認証スキームを選択します。表5-4に、「認証」属性を示します。

表5-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を送信することを許可します。

5.9.2.6 認可

「認可」セクションを使用して、Webシート・アプリケーションにログインできるユーザーを制御します。表5-5に、「アプリケーション」属性を示します。

表5-5 認可

属性

説明

アクセス制御リスト・タイプ

認証が「Application Expressアカウント」の場合、Application Expressワークスペース内のロールで認可を判断するか、アクセス制御リストで認可を判断するかを選択します。「Application Expressアカウント」以外のすべての認証タイプでは、認可は常にアクセス制御リストで判断されます。

パブリック・アクセスを許可

オプションは次のとおりです。

- はい: ユーザーにログインを要求せずに、ユーザーが読取り専用モードでアプリケーションを実行できるようになります。

- いいえ: アプリケーションを実行するには、すべてのユーザーはログインする必要があります。

ヒント:

ロールおよびそれらの権限の詳細は、「アクセス制御ロール」をクリックしてください。「アクセス制御リストの編集」をクリックして、アクセス制御リスト・ページにリンクします。詳細は、Webシート・アクセスの制御を参照してください。

5.9.2.7 SQL

「SQL」セクションを使用して、ユーザーがカレントWebシートでSQLを使用できるかどうかを決定します。デフォルトでは、この機能は無効化されています。デフォルトの設定を変更するには、「はい」を選択します。

有効な場合、ユーザーはアプリケーション内でSQLタグとSQLレポートを使用できます。「オブジェクトの追加」をクリックして、推奨オブジェクトページにリンクします。ユーザーは、カスタム・レポートを記述することも、カレント・ワークスペースに関連付けられたスキーマ内のデータベース・オブジェクトにSQLタグを使用することもできます。推奨オブジェクトとしてデータベース表またはビューを指定すると、ヘルプ・ページで表およびビューの列を公開することによりSQLを簡単に作成できるようになります。

ヒント:

インスタンスの管理者は、インスタンス全体に対してSQLを使用する機能を制御できます。詳細は、『Oracle Application Express管理ガイド』のWebシートでのSQLアクセスの有効化と無効化に関する説明を参照してください。

5.10 Webシート・アクセスの制御

この項では、Webシート・アプリケーションへのアクセスの制御方法について説明します。

トピック:

- Webシート・アクセスの動作

- アクセス制御リスト・タイプの指定

- アクセス制御リスト・エントリの作成

5.10.1 Webシート・アクセスの動作

管理者は、次の認証メカニズムのいずれかを指定して、Webシート・アプリケーションにログインできるユーザーを制御します。

- パブリック・アクセス(認証なし)

- Oracle Application Expressアカウント

- シングル・サインオン検証

- LDAP資格証明の検証

- カスタム

認証が「カスタム」として定義されている場合は、このアプリケーションのユーザーの権限はアクセス制御リストで管理されます。

認証がOracle Application Expressアカウントの場合は、Application Expressワークスペースに定義されたユーザー・ロールで認可を判断するか、アクセス制御リストで認可を判断するかを指定する必要があります。Oracle Application Expressアカウント以外のすべての認証タイプでは、認可は常にアクセス制御リストで判断されます。

ユーザーがアプリケーションにログインすると、ユーザーに割り当てられたロールによってアクセス権が判断されます。ユーザーに割り当てられるロールには次のものがあります。

- リーダー: コンテンツを表示できますが、編集はできません。

- コントリビュータ: コンテンツを表示および編集できます。

- 管理者: コンテンツを表示および編集でき、「Webシート・プロパティ」の編集および「アクセス制御リスト」の管理を行うこともできます。

ユーザー・ロールと権限の詳細は、「ヘルプ」をクリックし、「アクセス制御」を選択してください。

5.10.2 アクセス制御リスト・タイプの指定

アクセス制御リストを使用するには、「Webシート・プロパティ」を編集し、「アクセス制御リスト・タイプ」を「カスタム」として定義します。

「Webシート・プロパティ」ページにアクセスするには、次の手順を実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. 「Webシート・アプリケーション」タブをクリックします。

3. 「アイコンの表示」ボタンをクリックします。

4. Webシートを選択し、「編集」をクリックします。

「Webシート・プロパティ」が表示されます。

5. 「認可」までスクロールします。

6. 「アクセス制御リスト・タイプ」から、「カスタム」を選択します。

7. 「変更の適用」をクリックします。

関連項目:

認証

5.10.3 アクセス制御リスト・エントリの作成

アクセス制御リスト・エントリを作成するには、次のステップを実行します。

1. Webシートにログインし、Webシートを実行します。

2. 「管理」メニューから、「アクセス制御」を選択します。

3. 「エントリの作成」をクリックします。
エントリの詳細ページが表示されます。

4. エントリの詳細ページで、次のステップを実行します。

a. ユーザー名: アクセス制御の対象ユーザーのユーザー名を入力します。

b. 権限: ユーザーの権限を指定します。

- リーダー: コンテンツを表示できますが、編集はできません。

- コントリビュータ: コンテンツを表示および編集できます。

- 管理者: コンテンツを表示および編集でき、「Webシート・プロパティ」の編集および「アクセス制御リスト」の管理を行うこともできます。

5. 「作成」または「作成後、さらに作成」をクリックします。

関連項目:

「Webシートの実行」

6 データベース・アプリケーションの作成

開発者は、アプリケーションの作成ウィザードを使用して、Oracle Application Expressでアプリケーションを作成します。作成後、開発者は、アプリケーション属性を編集してアプリケーションを変更したり、ページの作成ウィザードを使用して新しいページを追加することができます。開発者は、ページ・グループの作成、ページのロックおよびロック解除、開発者コメントおよびアプリケーション・コメントの追加によって、および様々なアプリケーションやページ、クロス・ページ・ユーティリティ、レポートにアクセスして、開発プロセスをより詳細に管理できます。

トピック:

- アプリケーションの作成ウィザードの使用

- データベース・アプリケーションの作成

- モバイル・アプリケーションの作成

- アプリケーションの削除

- アプリケーション属性の管理

- データベース・アプリケーションのページの管理

- 「検索」アイコンの使用

- ページ・グループの作成

- ページのロックおよびロック解除

- 開発者コメントの追加

- データベース・アプリケーション・コメントの追加

- アプリケーション・グループの管理

- アプリケーション・ユーティリティの使用

関連項目:

「ユーザー・インタフェース設計の管理」および「データベース・アプリケーションとWebシート・アプリケーションの違い」

6.1 アプリケーションの作成ウィザードの使用

アプリケーションの作成ウィザードを使用して、複数のページを含む完全なアプリケーションを作成します。アプリケーションの作成ウィザードの動作は、作成するページのタイプによって異なります。

トピック:

- アプリケーションの作成ウィザードについて

- アプリケーションの作成ウィザードの実行中に使用可能なページ・タイプ

関連項目:

ユーザー・インタフェース設計の管理、データベース・アプリケーションの作成およびモバイル・アプリケーションの作成

6.1.1 アプリケーションの作成ウィザードについて

アプリケーションの作成ウィザードを使用すると、開発者は、基本的なOracle Application Expressアプリケーションを設計し、簡単に作成できます。アプリケーションの作成ウィザードを使用することにより、様々なレポートやフォームなど、複数のページを含む完全なアプリケーションを作成できます。このウィザードを使用してアプリケーションを作成した後、ページを変更したり、ページの作成ウィザードを使用してページを追加できます。

アプリケーションの作成ウィザードを使用すると、既存のデータベース表のSQL問合せに基づいて空白ページでアプリケーションを作成できます。表に基づいたアプリケーションは簡易レポート、フォームとレポート、または編集可能対話グリッドで構成できます。SQL問合せは、手動でSQLを入力しても、「クエリー・ビルダー」のグラフィカル・ユーザー・インタフェースを使用しても、どちらでも作成できます。

ワークスペースレベルでは、その表領域で構築されたアプリケーションに使用されるデフォルト値を設定するオプションがあります。これらのデフォルト値を設定すると、各ステップを介さずにウィザードを終了できます。ウィザードを終了する場合、ユーザーが作成したアプリケーションは、ユーザーがデフォルトとして指定した値を使用します。

関連項目:

- データベース・アプリケーションへのページの追加について

- Oracle Application Express SQLワークショップ・ガイドの「クエリー・ビルダーを使用した問合せの構築」

- 『Oracle Application Express管理ガイド』のアプリケーション・ビルダーのデフォルト値の利用に関する項

6.1.2 アプリケーションの作成ウィザードの実行中に使用可能なページ・タイプ

アプリケーションの作成ウィザードを実行したときに、ターゲット・ユーザー・インタフェースを選択します。選択したユーザー・インタフェースによって、使用可能なページ・タイプが決まります。すべてのページ・タイプがすべてのユーザー・インタフェースでサポートされるわけではありません。

デスクトップ・アプリケーションでサポートされるページ・タイプ

デスクトップ・アプリケーションを作成する場合、アプリケーションの作成ウィザードでサポートされるページ・タイプは次のとおりです。

表6-1 アプリケーションの作成ウィザード: デスクトップ・アプリケーションでサポートされるページ・タイプ

ページ・タイプ

説明

詳細情報

空白

組込み機能のないページを作成します。

適用されません。

レポート

SQL問合せの書式設定された結果を含むページを作成します。レポートを作成する表を選択するか、カスタムSQL SELECT文またはSQL SELECT文を戻すPL/SQLファンクションを指定する表を選択します。次に、レポート・タイプ(つまり、対話モード・レポート、対話グリッドまたはクラシック・レポート)を選択します。

レポートの開発を参照してください。

レポートとフォーム

2ページのレポートとフォームの組合せを作成する表を選択します。次に、レポート・タイプ(つまり、対話モード・レポート、対話グリッドまたはクラシック・レポート)を選択します。最初のページで、ユーザーは更新する行を選択します。2ページ目では、レコードを追加するか、あるいは既存のレコードの更新または削除を行うことができます。

レポートの開発を参照してください。

フォーム

データベース表の単一行を更新するフォームを作成します。フォームを構築する表を選択します。

フォームの開発を参照してください。

編集可能対話グリッド

対話グリッドでは、検索およびカスタマイズ可能なレポートのデータのセットがユーザーに表示されます。編集可能対話グリッドでは、ユーザーはページ上で直接データ・セットを追加、変更およびリフレッシュすることもできます。機能面では、対話グリッドには、対話モード・レポートで使用可能な多くのカスタマイズ機能と、マウスを使用して対話的にレポートを再配置する機能が含まれています。対話グリッドを構築する表を選択します。

対話グリッドの管理を参照してください。

マスター・ディテール

編集可能対話グリッドを含む1ページのマスター・ディテールを作成します。このページを使用すると、関連する2つの表またはビューに対し、値の問合せ、挿入、更新および削除を行うことができます。マスター・リージョンおよびディテール・リージョンを構築する表を選択します。

マスター・ディテール・フォームの管理を参照してください。

チャート

SQL問合せの結果を表すチャートを含むページを作成します。

チャートの作成を参照してください。

モバイル・アプリケーションでサポートされるページ・タイプ

モバイル・アプリケーションを作成する場合、アプリケーションの作成ウィザードでサポートされるページ・タイプは次のとおりです。

表6-2 アプリケーションの作成ウィザード: モバイル・アプリケーションでサポートされるページ・タイプ

ページ・タイプ

説明

詳細情報

空白

組込み機能のないページを作成します。

適用されません。

リスト・ビュー

モバイル・アプリケーションのレスポンシブなレポートを作成します。レポートは、表の列を縮小して、各行に対するラベルやデータ・ペアのブロックのような外観の積上げ表示形式にすることによって機能します。この切替えは、レポートを水平に表示できる十分な領域がない場合に発生します。

レポートの開発を参照してください。

列切替えレポート

モバイル・アプリケーションのレスポンシブなレポートを作成します。デフォルトでは、列切替えレポートはすべての列が同じ優先度に設定されて作成されます。ただし、開発者はレポート列属性を編集し、重要度に応じて列をランク付けできます。優先度がより低い列は、より狭い幅で表示されます(たとえば、優先度6の列は最初に非表示になり、優先度1の列は最後に非表示になります。)レポートには、エンド・ユーザーが表示する列を選択できる「列」ボタンが含まれています。

レポートの開発を参照してください。

リフロー・レポート

モバイル・アプリケーションのレスポンシブなレポートを作成します。レポートを水平に表示できる十分な領域がない場合、レポートは、表の列を縮小して、各行に対するラベルやデータ・ペアのブロックのような外観の積上げ表示形式にすることによって機能します。

レポートの開発を参照してください。

リスト・ビューとフォーム

スマートフォンでデータの表示とナビゲーション用に最適化されます。

2ページのリスト・ビューとフォームの組合せを構築します。1ページ目では、「リスト・ビュー」から更新する行を選択します。2ページ目では、ユーザーは選択した表またはビューを更新できます。

レポートの開発を参照してください。

フォーム

データベース表の単一行を更新するフォームを作成します。フォームを構築する表を選択します。

フォームの開発を参照してください。

チャート

SQL問合せの結果を表すチャートを含むページを作成します。

チャートの作成を参照してください。

6.2 データベース・アプリケーションの作成

表、問合せまたはドリルダウン問合せに基づいて・データベースアプリケーションを作成するには、「アプリケーションの作成」ウィザードで「データベース」を選択します。「アプリケーションの作成」ウィザードを実行する場合の主なデシジョン・ポイントは、ターゲット・ユーザー・インタフェースの選択です。選択したユーザー・インタフェースに基づいて、ウィザードに適切なページ・タイプ、属性およびテーマが表示されます。

トピック:

- 表、問合せまたはドリルダウン問合せに基づくデータベース・アプリケーションの作成

- スプレッドシートからのデスクトップ・データベース・アプリケーションの作成

- データベース・アプリケーションのコピー

関連項目:

- 「データベース・アプリケーションとWebシート・アプリケーションの違い」

- 「ユーザー・インタフェース設計の管理」

- 「モバイル・アプリケーションの作成」

- 「アプリケーションの削除」

6.2.1 表、問合せまたはドリルダウン問合せに基づくデータベース・アプリケーションの作成

表、問合せまたはドリルダウン問合せに基づいてデータベース・アプリケーションを作成するには、次の手順を実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. 「作成」ボタンをクリックします。

3. アプリケーション・タイプを選択し、「デスクトップ」を選択して「次へ」をクリックします。

4. 「名前」は、次のようにします。

a. スキーマ: アプリケーションは、すべてのSQLを特定のデータベース・スキーマとして解析することで、権限を取得します。データベース・スキーマ所有者を指定します。

b. 名前: 開発者がアプリケーションを識別するための名前を入力します。

c. アプリケーション: アプリケーションを識別する整数値を指定します。アプリケーションIDは、Application Expressインスタンス内で一意である必要があります。3000から9000の範囲のアプリケーションIDは、Oracle Application Expressの内部使用向けに予約されています。

d. テーマ: テーマを選択します。テーマは、アプリケーション全体のレイアウトおよびスタイルの定義に使用するテンプレートのコレクションです。
使用可能なテーマを表示するには、「テーマを選択」をクリックします。標準テーマが表示されます。追加テーマを表示するには、「表示」リストから選択します。テーマを選択すると、アプリケーションによって自動的にサブスクライブされます。

e. テーマ・スタイル: テーマ・スタイルを選択します。テーマ・スタイルは、テーマ42および51などの新しいアプリケーションに対してのみ使用可能です。

f. 「次へ」をクリックします。

ヒント:

ログイン・ページと空白ページのみが含まれたインスタント・アプリケーションを作成するには、「アプリケーションの作成」ボタンをクリックします。

次に、ページをアプリケーションに追加します。

5. 「ページ」で、「ページの追加」をクリックします。

a. ページ・タイプの選択: 追加するページ・タイプを選択します。「アプリケーションの作成ウィザードの実行中に使用可能なページ・タイプ」を参照してください。
ページ・タイプに基づいて、表名の選択、レポート実装など異なる情報が求められます。詳細は、フィールドレベル・ヘルプを参照してください。「アクション」に現在選択されているページ・タイプが表示されます。選択ごとに、表名の選択、レポート実装など異なる情報のタイプが求められます。詳細は、フィールドレベル・ヘルプを参照してください。

b. 「ページの追加」をクリックします。
ページがページ上部に表示されます。ページを削除するには、「削除」アイコン(右側の列のX)をクリックします。

c. すべてのページが追加されるまで前のステップを繰り返します。

ヒント:

ウィザードを早期に終了して「アプリケーション・ビルダーのデフォルト値」を使用するには、「アプリケーションの作成」ボタンをクリックします。

d. 「次へ」をクリックします。

6. 「共有コンポーネント」で、共有コンポーネントを別のアプリケーションからコピーするかどうかを指定します。「はい」または「いいえ」を選択します。「はい」を選択した場合は、そのコピー元と、インポートするコンポーネントを選択します。
共有コンポーネントは、アプリケーション内の複数のページ間で表示または適用できる共通アプリケーション要素です。時間を節約するため、またはアプリケーション間の一貫性を保持するために、共有コンポーネントは既存のアプリケーションからコピーします。コピーできる共有コンポーネントのタイプには、ユーザー・インタフェースのテーマ、LOV、ナビゲーション・バー・エントリ、認可スキームおよび認証スキームがあります。別のアプリケーションからテーマをコピーする場合は、テーマをサブスクライブします。

7. 「属性」は、次のようにします。

a. 認証スキーム: アプリケーションにアクセスする前にユーザー・アイデンティティを確立する方法を決定します。オプションは次のとおりです。

- Application Expressアカウント: Application Express管理サービス・アプリケーションで作成および保持されるユーザー・アカウント資格証明を使用します。これらは、Application Express開発環境へのログインに使用するアカウントです。また、アプリケーションのエンド・ユーザー用として、このユーザー・アカウント・リポジトリにアカウントを作成することもできます。

- 認証なし: データベース認証とも呼ばれます。このオプションを使用すると、ユーザーはmod_plsql DAD定義に格納されているアカウント資格証明を使用して、アプリケーションにアクセスできるようになります。この認証スキームでは、データベース・ユーザー(スキーマ)はローカル・データベースに存在している必要があります。ほとんどの場合、アプリケーションへのアクセス時にログインを行う必要がなくなります。これは、公開アプリケーションを最も早く作成する方法です。

- データベース・アカウント: アプリケーションへのユーザー・ログインには、データベース・スキーマ名(またはユーザー名)とパスワードが必要です。このアカウント情報は、Oracle Database全体で管理されます。

b. 言語: このアプリケーションのプライマリ言語を選択します。
アプリケーションを開発する言語をこの属性で指定します。この言語が、すべての変換の元となるベース言語になります。

ユーザー言語プリファレンスの導出元: Application Expressによる翻訳されたアプリケーション言語の導出方法を指定します。アプリケーションのプライマリ言語は静的にすることも、Webブラウザ言語から導出したり、ユーザー・プリファレンスやアイテムから特定することもできます。詳細は、フィールドレベル・ヘルプを参照してください。

ヒント:

「言語」および「ユーザー言語プリファレンスの導出元」属性は、グローバリゼーション属性の編集ページで後から変更できます。グローバリゼーション属性の設定を参照してください。

c. 日付書式: アプリケーションで使用する日付書式を指定します。
この日付書式を使用すると、NLS_DATE_FORMATデータベース・セッションの設定が変更されてから、アプリケーション内のページが表示または送信されます。この値には、有効なOracle日付書式マスクを含むリテラル文字列、または置換構文によるアイテム参照を指定できます。値が指定されていない場合は、データベース・セッションからデフォルトの日付書式が実行時に取得されます。指定されている場合は、DATE型の列から得られるすべてのアイテムの日付書式としても使用されます。

d. 日時書式: アプリケーションで使用する日時書式を指定します。
この日時書式は、置換参照&APP_DATE_TIME_FORMAT.を使用するか、PL/SQLでv('APP_DATE_TIME_FORMAT')ファンクションを使用して、アプリケーション内で参照できます。この属性によってNLS設定が変更されることはありません。この値には、有効なOracle日付書式マスクを含むリテラル文字列、または置換構文を使用したアイテム参照を指定できます。この属性値を指定しない場合、APP_DATE_TIME_FORMATへの参照はNLSデータベース・セッションの日付書式とNLS時刻書式を返します。

e. タイムスタンプ書式: アプリケーションで使用するタイムスタンプ書式を指定します。
このタイムスタンプ書式を使用すると、NLS_TIMESTAMP_FORMATデータベース・セッションの設定が変更されてから、アプリケーション内のページが表示または送信されます。この値には、有効なOracleタイムスタンプ書式マスクを含むリテラル文字列、または置換構文を使用したアイテム参照を指定できます。値が指定されていない場合は、データベース・セッションからデフォルトのタイムスタンプ書式が実行時に取得されます。

f. タイムスタンプ・タイムゾーン書式: アプリケーションで使用されるタイムゾーン付きタイムスタンプ書式を指定します。
このタイムゾーン付きタイムスタンプ書式を使用すると、NLS_TIMESTAMP_TZ_FORMATデータベース・セッションの設定が変更されてから、アプリケーション内のページが表示または送信されます。この値には、有効なOracleタイムゾーン付きタイムスタンプ書式マスクを含むリテラル文字列、または置換構文を使用したアイテム参照を指定できます。値が指定されていない場合は、データベース・セッションからデフォルトのタイムゾーン付きのタイムスタンプ書式が実行時に取得されます。

g. 「次へ」をクリックします。

8. 選択内容を確認して、「アプリケーションの作成」をクリックします。

関連項目:

- テーマの使用

- テーマ・スタイルの使用

- テーマのサブスクリプションの理解

- 認証によるユーザー・アイデンティティの証明

6.2.2 スプレッドシートからのデスクトップ・データベース・アプリケーションの作成

スプレッドシート・データに基づいてデスクトップ・アプリケーションを作成するには、アプリケーションの作成ウィザードで「スプレッドシートから」を選択します。

スプレッドシート・データからアプリケーションを作成するには、次のステップを実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. 「作成」ボタンをクリックします。

3. 「スプレッドシートから」を選択します。

4. 「ロード方法」で、スプレッドシート・データのインポート方法を指定します。

- ファイルをアップロード(カンマ区切り(*.csv)またはタブ区切り):次の項目を指定し、「次へ」をクリックします。

- テキスト・ファイル: ファイルの選択をクリックし、アップロードされるファイルを指定します。

- 「セパレータ」: カンマ区切り文字を指定します。タブ区切りには\tを使用します。

- 「囲み文字(オプション)」: 区切り文字を入力します。この文字は、データ値の始まりと終わりを区切るために使用できます。区切り文字を指定した場合、データ値の始まりと終わりの前にあるスペースはウィザードで無視されます。このオプションを使用すると、指定した区切り文字でデータ値を囲むこともできます。

- 1行目のデータに列名が含まれる: データの最初の行に列名が含まれる場合は、このオプションを選択します。

- 「ファイルのキャラクタ・セット」: テキスト・ファイルのエンコードに使用されるキャラクタ・セットを選択します。

- 「コピー・アンド・ペースト」。インポートするタブ区切りデータをコピーして貼り付けます。

5. 「表のプロパティ」で、次のステップを実行します。

a. スキーマ: データベース・スキーマ所有者を指定します。

b. 表: 作成する表の名前を入力します。

c. 表のプロパティを設定: 表のプロパティを確認します。データ型を変更するか、書式マスクを入力します。「アップロード」リストから「はい」または「いいえ」を選択して、列を含めるかどうかを指定します。

d. 「次へ」をクリックします。

6. 「アプリケーション・オプション」は、次のようにします。

a. アプリケーション名: このアプリケーションの名前を英数字で入力します。

b. レポート・タイプ: 次のいずれか1つを選択します。

- 対話グリッド: 対話グリッドを作成します。

- 対話モード・レポート: 対話モード・レポートを作成します。

- クラシック: SQLレポートを作成します。

c. ページ・タイプ: 生成するページ・タイプを選択します。表示されるオプションは、選択したレポート・タイプに応じて異なります。

ヒント:

レポート・タイプが対話グリッドの場合、編集不能対話グリッド(レポート)・ページと標準フォーム・ページを作成するか、単一ページに対話グリッドを作成できます。他のすべてのレポート・タイプでは、レポート・ページとフォーム・ページを作成します。

7. 「アプリケーションの作成」をクリックします。

関連項目:

テーマの使用およびテーマ・スタイルの使用

6.2.3 データベース・アプリケーションのコピー

アプリケーションの作成ウィザードを実行するか、アプリケーションのホームページでアプリケーションを選択してから「このアプリケーションのコピー」を選択することによって、既存のアプリケーションのコピーを作成できます。

トピック:

- アプリケーションの作成ウィザードを使用したデータベース・アプリケーションのコピー

- アプリケーションのホームページからのアプリケーションのコピー

6.2.3.1 アプリケーションの作成ウィザードを使用したデータベース・アプリケーションのコピー

アプリケーションの作成ウィザードを実行してアプリケーションをコピーするには、次のステップを実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. 「作成」ボタンをクリックします。

3. 「既存アプリケーションのコピー」を選択して、「次へ」をクリックします。

4. 「コピーのターゲットを指定」で、次のステップを実行します。

a. コピー元: コピーするアプリケーションの名前を選択します。

b. コピー先: アプリケーションの説明的な短い名前を入力し、選択リストおよびレポートで新しいアプリケーションを識別できるようにします。

c. 新しいアプリケーションID: アプリケーションを識別するための一意の整数値を入力します。3000から9000の間のアプリケーションIDは内部使用向けに予約されています。

d. サポートするオブジェクトの定義のコピー: サポートするオブジェクトの定義を含めるかどうかを指定します。オプションは次のとおりです。

- はい: データベース・オブジェクト定義、イメージ定義、およびシード・データSQL文を単一のファイルにカプセル化して含めます。

- いいえ: サポートするオブジェクトの定義を含めません。

e. 「次へ」をクリックします。

5. 「アプリケーションの作成」をクリックします。

6.2.3.2 アプリケーションのホームページからのアプリケーションのコピー

アプリケーションのホームページからデータベース・アプリケーションをコピーするには、次のステップを実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. コピーするアプリケーションを選択します。
アプリケーションのホームページが表示されます。

3. 「タスク」リストで「このアプリケーションのコピー」をクリックします。

4. 「コピーのターゲットを指定」で、次のステップを実行します。

a. 新しいアプリケーションID: アプリケーションを識別するための一意の整数値を入力します。3000から9000の間のアプリケーションIDは内部使用向けに予約されています。

b. 新しいアプリケーション名: アプリケーションの説明的な短い名前を入力し、選択リストおよびレポートで新しいアプリケーションを識別できるようにします。

c. サポートするオブジェクトの定義のコピー: サポートするオブジェクトの定義を含めるかどうかを指定します。オプションは次のとおりです。

- はい: データベース・オブジェクト定義、イメージ定義、およびシード・データSQL文を単一のファイルにカプセル化して含めます。

- いいえ: サポートするオブジェクトの定義を含めません。

d. 「次へ」をクリックします。

5. 「アプリケーションのコピー」をクリックします。

6.3 モバイル・アプリケーションの作成

モバイル・アプリケーションは特にモバイル・デバイスで実行するように設計されるので、モバイル接続に最適化された、最小のセマンティックHTMLで構築することをお薦めします。

トピック:

- jQuery Mobileのサポートについて

- モバイル・アプリケーションの作成

関連項目:

- 「ユーザー・インタフェース設計の管理」

- 「レスポンシブ・デザインについて」

- 「アプリケーションの削除」

6.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ベース・アプリケーションのルック・アンド・フィールを簡単に変更できます。

ヒント:

ThemeRollerの詳細は、http://themeroller.jquerymobile.comを参照してください。

jQuery Mobileの詳細は、http://jquerymobile.comを参照してください。

関連項目:

「ユーザー・インタフェース設計の管理」

6.3.2 モバイル・アプリケーションの作成

モバイル・アプリケーションを作成するには:

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. 「作成」ボタンをクリックします。

3. アプリケーション・タイプで、「モバイル」を選択して「次へ」をクリックします。

4. 「名前」は、次のようにします。

a. スキーマ: アプリケーションは、すべてのSQLを特定のデータベース・スキーマとして解析することで、権限を取得します。データベース・スキーマ所有者を指定します。

b. 名前: 開発者がアプリケーションを識別するための名前を入力します。

c. アプリケーション: アプリケーションを識別する整数値を指定します。アプリケーションIDは、Application Expressインスタンス内で一意である必要があります。3000から9000の範囲のアプリケーションIDは、Oracle Application Expressの内部使用向けに予約されています。

d. テーマ: テーマを選択します。テーマは、アプリケーション全体のレイアウトおよびスタイルの定義に使用するテンプレートのコレクションです。

e. テーマ・スタイル: アプリケーションのテーマ・スタイルを選択します。テーマ・スタイルは、アプリケーションのテーマのCSSを定義し、アプリケーションのUIを変更できます。

f. 「次へ」をクリックします。

ヒント:

ログイン・ページと空白ページのみを含むインスタント・アプリケーションを作成するには、「アプリケーションの作成」ボタンをクリックします。

次に、ページをアプリケーションに追加します。

5. 「ページ」で、「ページの追加」をクリックします。

「アプリケーションの作成 - ページの追加」ダイアログで、次のステップを実行します。

a. 「ページ・タイプの選択」で、追加するページ・タイプを選択します。「アプリケーションの作成ウィザードの実行中に使用可能なページ・タイプ」を参照してください。
使用可能なページ・タイプは、前のステップで選択したユーザー・インタフェースによって異なります。

アクション: 現在選択済のページ・タイプが表示されます。

選択ごとに、表名の選択、レポート実装など異なる情報のタイプが求められます。詳細は、フィールドレベル・ヘルプを参照してください。

b. 「ページの追加」をクリックします。
ページがページ上部に表示されます。ページを削除するには、「削除」アイコンをクリックします。

c. すべてのページが追加されるまで前のステップを繰り返します。

d. 「次へ」をクリックします。

ヒント:

ウィザードを早期に終了して「アプリケーション・ビルダーのデフォルト値」を使用するには、「アプリケーションの作成」ボタンをクリックします。「アプリケーション・ビルダーのデフォルト値」を構成するには、Oracle Application Express管理ガイドの「アプリケーション・ビルダーのデフォルト値の利用」を参照してください。

6. 「共有コンポーネント」で、共有コンポーネントを別のアプリケーションからコピーするかどうかを指定します。「はい」または「いいえ」を選択します。「はい」を選択した場合は、そのコピー元と、インポートするコンポーネントを選択します。

共有コンポーネントは、アプリケーション内の複数のページ間で表示または適用できる共通アプリケーション要素です。時間を節約するため、またはアプリケーション間の一貫性を保持するために、共有コンポーネントは既存のアプリケーションからコピーします。コピーできる共有コンポーネントのタイプには、ユーザー・インタフェースのテーマ、LOV、ナビゲーション・バー・エントリ、認可スキームおよび認証スキームがあります。

7. 「属性」は、次のようにします。

a. 認証スキーム: アプリケーションにアクセスする前にユーザー・アイデンティティを確立する方法を決定します。
詳細は、フィールドレベル・ヘルプを参照してください。

b. 言語: このアプリケーションのプライマリ言語を選択します。
アプリケーションを開発する言語をこの属性で指定します。この言語が、すべての変換の元となるベース言語になります。

c. ユーザー言語プリファレンスの導出元: Application Expressによる翻訳されたアプリケーション言語の導出方法を指定します。アプリケーションのプライマリ言語は静的にすることも、Webブラウザ言語から導出したり、ユーザー・プリファレンスやアイテムから特定することもできます。詳細は、フィールドレベル・ヘルプを参照してください。

ヒント:

「言語」および「ユーザー言語プリファレンスの導出元」属性は、グローバリゼーション属性の編集ページで後から変更できます。

d. 日付書式: アプリケーションで使用する日付書式を指定します。
日付書式を使用すると、NLS_DATE_FORMATデータベース・セッションの設定が変更されてから、アプリケーション内のページが表示または送信されます。この値には、有効なOracle日付書式マスクを含むリテラル文字列、または置換構文によるアイテム参照を指定できます。値が指定されていない場合は、データベース・セッションからデフォルトの日付書式が実行時に取得されます。指定されている場合は、DATE型の列から得られるすべてのアイテムの日付書式としても使用されます。

e. 日時書式: アプリケーションで使用する日時書式を指定します。
日時書式は、置換参照&APP_DATE_TIME_FORMAT.を使用するか、PL/SQLでv('APP_DATE_TIME_FORMAT')ファンクションを使用して、アプリケーション内で参照できます。この属性によってNLS設定が変更されることはありません。この値には、有効なOracle日付書式マスクを含むリテラル文字列、または置換構文を使用したアイテム参照を指定できます。この属性値を指定しない場合、APP_DATE_TIME_FORMATへの参照はNLSデータベース・セッションの日付書式とNLS時刻書式を返します。

f. タイムスタンプ書式: アプリケーションで使用するタイムスタンプ書式を指定します。
タイムスタンプ書式を使用すると、NLS_TIMESTAMP_FORMATデータベース・セッションの設定が変更されてから、アプリケーション内のページが表示または送信されます。この値には、有効なOracleタイムスタンプ書式マスクを含むリテラル文字列、または置換構文を使用したアイテム参照を指定できます。値が指定されていない場合は、データベース・セッションからデフォルトのタイムスタンプ書式が実行時に取得されます。

g. タイムスタンプ・タイムゾーン書式: アプリケーションで使用されるタイムゾーン付きタイムスタンプ書式を指定します。
タイムスタンプ・タイムゾーン書式を使用すると、NLS_TIMESTAMP_TZ_FORMATデータベース・セッションの設定が変更されてから、アプリケーション内のページが表示または送信されます。この値には、有効なOracleタイムゾーン付きタイムスタンプ書式マスクを含むリテラル文字列、または置換構文を使用したアイテム参照を指定できます。値が指定されていない場合は、データベース・セッションからデフォルトのタイムゾーン付きのタイムスタンプ書式が実行時に取得されます。

h. 「次へ」をクリックします。

8. 選択内容を確認して、「アプリケーションの作成」をクリックします。

関連項目:

- テーマの使用

- テーマ・スタイルの使用

- テーマのサブスクリプションの理解

- 認証によるユーザー・アイデンティティの証明

6.4 アプリケーションの削除

開発者は、アプリケーションの削除をアプリケーション・ビルダー内から行うことができます。または、アプリケーション属性の編集中にも削除できます。アプリケーションを削除すると、定義されたコンポーネント(レポート、チャートまたはフォーム)、ページ・コントロール(ボタン、アイテムまたはLOV)および共有コンポーネント(ブレッドクラム、リストおよびタブ、ただし、ユーザー・インタフェースのデフォルト値を除く)もすべて削除されます。

トピック:

- アプリケーションのホームページからのアプリケーションの削除

- 「アプリケーション定義の編集」ページからのアプリケーションの削除

関連項目:

サポートするオブジェクトの削除およびインストールしたパッケージ・アプリケーションの削除

6.4.1 アプリケーションのホームページからのアプリケーションの削除

アプリケーション・ビルダーからアプリケーションを削除するには、次のステップを実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

アプリケーションのホームページが表示されます。

3. アプリケーションのホームが表示されたら、ページ上部のアプリケーションIDおよびアプリケーション名を確認します。

4. 「タスク」リストで「このアプリケーションの削除」をクリックします。

5. プロンプトが表示されたら、「今すぐ完全に削除」をクリックします。

6.4.2 「アプリケーション定義の編集」ページからのアプリケーションの削除

「アプリケーション定義の編集」ページからアプリケーションを削除するには、次のようにします。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. アプリケーション名の右側にある「アプリケーション・プロパティの編集」ボタンをクリックします。

「アプリケーション定義の編集」ページが表示されます。

4. アプリケーションIDおよびアプリケーション名を確認します。

5. ページの上部の「削除」をクリックします。

6. プロンプトが表示されたら、「今すぐ完全に削除」をクリックします。

関連項目:

アプリケーション属性の編集

6.5 アプリケーション属性の管理

アプリケーション属性はアプリケーション全体の動作を制御するものであり、定義、セキュリティ、グローバリゼーション、ユーザー・インタフェースのカテゴリに分類されます。

トピック:

- アプリケーション属性の編集

- セキュリティ属性の構成

- グローバリゼーション属性の構成

- アプリケーションのユーザー・インタフェースの管理

関連項目:

カスタム・パッケージ・アプリケーションの作成方法(サポートするオブジェクト・ユーティリティを使用したパッケージ・アプリケーションの作成方法の詳細)

6.5.1 アプリケーション属性の編集

「アプリケーション定義の編集」ページでアプリケーション属性を編集すると、アプリケーション名の変更、様々なアプリケーション・プロパティおよび動作の変更、アプリケーションの可用性の制御、エラー処理の構成、置換文字列の定義などを行えます。

トピック:

- アプリケーション定義の編集ページへのアクセス

- アプリケーション定義の編集ページ

6.5.1.1 アプリケーション定義の編集ページへのアクセス

アプリケーション定義の編集ページにアクセスするには、次のステップを実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. アプリケーション名の右側にある「アプリケーション・プロパティの編集」ボタンをクリックします。

「アプリケーション定義の編集」ページが表示されます。

4. 該当する属性を編集し、「変更の適用」をクリックします。

6.5.1.2 アプリケーション定義の編集ページ

アプリケーション定義の編集ページは、次のリージョンに分かれています。

注意:

必須の値には赤いアスタリスク(*)が付いています。

トピック:

- 名前

- プロパティ

- 可用性

- エラー処理

- グローバル通知

- 置換

- ビルド・オプション

6.5.1.2.1 名前

「名前」属性を使用して、アプリケーションの基本的な特性(アプリケーション名、英数字の別名(オプション)、バージョン番号など)を定義します。表6-3に、「名前」のすべての属性を示します。

表6-3「アプリケーション定義」の「名前」

属性

説明

名前

アプリケーションの説明的な短い名前。この名前によって、アプリケーションを開発環境に存在する他のアプリケーションと区別します。

アプリケーションの別名

代替の英数字アプリケーション識別子を割り当てます。アプリケーション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」を使用している場合、アプリケーション・ビルダーは、この書式マスクをすべてのアプリケーション属性の最終更新日に置換します。

アプリケーション・グループ

このアプリケーションに現在関連付けられているアプリケーション・グループを表示します。別のアプリケーション・グループを選択するには、リストから選択します。既存のグループからアプリケーションを削除するには、「未割当て」を選択します。

関連項目: アプリケーション・グループの管理

6.5.1.2.2 プロパティ

「プロパティ」セクションを使用して、ロギング、デバッグ動作、フィードバック、互換性、電子メール送信者アドレスおよびアプリケーション・プロキシ・サーバーを構成します。表6-4に、「名前」のすべての属性を示します。

表6-4「アプリケーション定義」の「プロパティ」

属性

説明

ロギング

ユーザー・アクティビティをOracle Application Expressアクティビティ・ログに記録するかどうかを決定します。「はい」を選択すると、すべてのページ・ビューがログに記録されるため、管理者はアプリケーションごとにユーザー・アクティビティを監視できます。

高容量アプリケーションでは、ロギングを無効にすることをお薦めします。

この属性は、Oracle Application Express管理サービスの「アプリケーション・アクティビティのロギング」属性が「アプリケーションの設定を使用(デフォルト)」に設定されている場合のみ変更できます。

関連項目: 『Oracle Application Express管理ガイド』のロギングのアプリケーション・アクティビティの有効化に関する説明。

デバッグ

カレント・アプリケーションのデバッグ・モードを制御します。使用可能なオプションは次のとおりです。

- はい: デバッグ・モードでのアプリケーションの実行が有効になります。

- いいえ: エンド・ユーザーがデバッグ・モードでアプリケーションを実行できないようにします。

デバッグ・モードでのアプリケーションの実行は、アプリケーションが開発中の場合に役立ちます。本番アプリケーションの場合は、デバッグを無効にし、ユーザーがアプリケーション・ロジックを参照できないようにすることをお薦めします。

このデバッグ設定に関係なく、プログラム的にデバッグを有効にできます。アプリケーションが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からこのフィールドに入力した値を参照できます。

6.5.1.2.3 可用性

可用性属性を使用して、アプリケーションのステータスとビルド・ステータスを定義し、アプリケーションを管理します。たとえば、ステータス「制限されたアクセス」を選択すると、アプリケーションにアクセスして実行できるユーザーを指定できます。詳細は、表6-5を参照してください。

表6-5「アプリケーション定義」の「可用性」

属性

説明

ステータス

アプリケーションが使用可能または使用不可であることを指定します。オプションは次のとおりです。

- 使用可能: アプリケーションは制限なしで使用可能です。

- 開発者ツールバーで使用可能: アプリケーションを使用できます。開発者に対して、各ページに開発者ツールバーが表示されます。開発者は同じブラウザ・セッションでアプリケーション・ビルダーにログインする必要があります。

- 開発者のみ使用可能: 開発者権限を持つユーザーがアプリケーションを使用できます。

- 制限されたアクセス: カンマ区切りのユーザー・リスト限定に指定された開発者がアプリケーションを使用できます。

- 使用不可: アプリケーションを実行または編集できません。ユーザーがアプリケーションへのアクセスを試みると、「使用できないアプリケーションに対するメッセージ」内のメッセージが表示されます。

- 使用不可(PL/SQLで表示されるステータス): アプリケーションは実行も編集もできません。

- 使用不可(URLにリダイレクト) - アプリケーションは実行できません。ユーザーは、「使用できないアプリケーションに対するメッセージ」に入力されたURLにリンクされます。

関連項目:

- 『Oracle Application Express管理ガイド』の複数のアプリケーションのビルド・ステータスの変更に関する項と管理サービスでのアプリケーションのビルド・ステータスの変更に関する項

- 「アプリケーション、ページおよびページ・コンポーネントへのアクセスの制御」

ビルド・ステータス

カレント・アプリケーションのビルド・ステータスを指定します。オプションは次のとおりです。

- アプリケーションの実行および構築: 開発者とユーザーのどちらもアプリケーションを実行および開発できます。

- アプリケーションの実行のみ: ユーザーはアプリケーションの実行のみが可能です。このオプションは、本番インスタンスのアプリケーション用です。

関連項目: Oracle Application Express管理ガイドの「デプロイ時のアプリケーションのビルド・ステータス・セットの変更」

使用できないアプリケーションに対するメッセージ

この属性は、「ステータス」とともに使用します。「ステータス」を「使用不可」、「使用不可(PL/SQLで表示されるステータス)」または「使用不可(URLにリダイレクト)」に設定すると、この属性に入力したテキストが表示されます。「ステータス」を「使用可能」に設定した場合、この属性に入力したテキストは表示されません。

カンマ区切りのユーザー・リスト限定(ステータスが「制限されたアクセス」の場合のみ)

この属性はステータス「制限されたアクセス」とともに使用します。「ステータス」を「制限されたアクセス」に設定すると、この属性に示されているユーザーのみがアプリケーションを実行できます。

この属性を使用するには、次のステップを実行します。

1. 「ステータス」リストから、制限されたステータスを選択します。

2. 表示されたフィールドに、アプリケーションを実行できるユーザーのカンマ区切りのリストを入力します。

3. 「変更の適用」をクリックします。

6.5.1.2.4 エラー処理

表6-6に示す「エラー処理」属性を使用して、アプリケーションがエラーのログを記録する方法を制御または変更します。

ヒント:

ここで指定するエラー処理ファンクションは、同様のページ・レベル属性によって上書きされます。

表6-6 「アプリケーション定義」の「エラー処理」

属性

説明

デフォルトのエラー表示位置

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に関する説明

注意: ここで指定するエラー処理ファンクションは、ページ・レベルで指定されるエラー処理により上書きされます。

6.5.1.2.5 グローバル通知

「グローバル通知」属性を使用して、アプリケーション・ユーザーにシステム・ステータスを通知します。たとえば、この属性を使用して、スケジュールされた停止時間をユーザーに通知したり、アプリケーションの可用性に関するその他のメッセージを通知できます。アプリケーションで使用されるページ・テンプレートに#GLOBAL_NOTIFICATION#置換文字列が含まれている場合は、ここに入力するテキストがその文字列の場所に表示されます。

グローバル通知を作成するには、次のステップを実行します。

1. ページ・テンプレートに#GLOBAL_NOTIFICATION#置換文字列を含めます。

2. アプリケーション定義の編集ページにナビゲートし、「グローバル通知」属性にメッセージを入力します。

3. 「変更の適用」をクリックします。

関連項目:

置換文字列の理解およびページ・テンプレート

6.5.1.2.6 置換

「置換」セクションを使用して、アプリケーションで使用する静的置換文字列を定義します。アプリケーション内の多くの場所に出現する文字列やラベルに静的置換文字列を使用できます。置換文字列を作成するには、「置換文字列」列に文字列名を、「置換値」列に文字列値を入力します。

静的置換文字列を定義すると、このページで定義した「置換値」を変更するだけで、アプリケーション内の複数の場所のテキスト文字列をまとめて変更できます。

関連項目:

置換文字列の理解

6.5.1.2.7 ビルド・オプション

「ビルド・オプション」セクションには、既存のビルド・オプションが表示されます。ほとんどのアプリケーションには、ビルド・オプション属性があります。ビルド・オプションは、INCLUDEまたはEXCLUDEという2つの値をとることができます。属性を含めるように指定すると、Application Expressエンジンは、実行時にその属性を考慮します。ただし、属性を除外するように指定すると、Application Expressエンジンは、その属性を存在しないものとして処理します。

オブジェクトを特定のインストールから除外する場合を除き、ビルド・オプションは指定しないでください。

関連項目:

ビルド・オプションを使用した構成の制御

6.5.2 セキュリティ属性の構成

「セキュリティ属性の編集」ページを使用して、アプリケーション内のすべてのページのセキュリティを構成します。セキュリティ属性は、認証、認可、セッション管理、セッション・ステート保護、ブラウザ・セキュリティ、データベース・セッションのカテゴリに分類されます。

トピック:

- セキュリティ属性の編集ページへのアクセス

- セキュリティ属性ページ

関連項目:

アプリケーション・セキュリティの管理

6.5.2.1 セキュリティ属性の編集ページへのアクセス

セキュリティ属性の編集ページにアクセスするには、次のステップを実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

共有コンポーネント・ページが表示されます。

4. 「セキュリティ」で、「セキュリティ属性」をクリックします。

セキュリティ属性の編集ページが表示されます。

5. 該当する属性を編集し、「変更の適用」をクリックします。

ヒント:

「アプリケーション定義の編集」にナビゲートして「セキュリティ」タブをクリックしても、「セキュリティ属性の編集」にアクセスできます。アプリケーション定義の編集ページへのアクセスを参照してください。

6.5.2.2 セキュリティ属性ページ

セキュリティ属性の編集ページは、次のセクションに分かれています。

注意:

必須の値には赤いアスタリスク(*)が付いています。

トピック:

- 認証

- 認可

- セッション管理

- セッション・ステート保護

- ブラウザ・セキュリティ

- データベース・セッション

6.5.2.2.1 認証

認証は、ユーザーがアプリケーションにアクセスする前に、そのユーザーの本人確認を行うプロセスです。アプリケーションに対して複数の認証スキームを定義できますが、一度にカレントに設定できるスキームは1つだけです。表6-7に、認証で使用可能な属性を示します。

表6-7 認証属性

属性

説明

パブリック・ユーザー

データベース・アクセス記述子(DAD)を介したデータベースへの接続に使用するOracleスキーマ(またはユーザー)を示します。ユーザーの本人確認が行われると、Application Expressエンジンが組込み置換文字列APP_USERの値を設定して、各ユーザーを追跡します。

APP_USERがこの値と等しいと、Application Expressエンジンはカレント・セッションをパブリック・ユーザー・セッションとみなします。Application Expressエンジンは、次の組込み表示条件をサポートしています。

- USER_IS_PUBLIC_USER

- USER_IS_NOT_PUBLIC_USER

カレント・アプリケーション・ユーザー(APP_USER)がこの属性の値と等しい場合、ユーザーはパブリック・ユーザーとしてログインされます。一部のアプリケーションには、パブリック・モード(ログインが不要)およびプライベート・モード(ログインが必要)があります。ユーザーがパブリック・ユーザーかどうかを判断して、条件付きで情報の表示と非表示を切り替えることができます。

たとえば、ユーザーがパブリック・ユーザーの場合はログイン・ボタンを表示し、ユーザーがパブリック・ユーザーでない場合にはログアウト・リンクを表示するように設定できます。この値を参照するには、APEX_APPLICATION.G_PUBLIC_USERを使用します。

関連項目: HOME_LINKおよび条件付きのレンダリングおよびプロセスの理解

認証スキーム

アプリケーションに定義されている認証スキームから選択します。認証スキームを作成するには、「認証スキームの定義」をクリックします。

関連項目: 認証の仕組みおよび認証スキームの作成

6.5.2.2.2 認可

アプリケーション認可スキームによって、アプリケーション内のすべてのページへのアクセスが制御されます。アプリケーションに不当にアクセスすると、リクエストしたページに関係なく、エラー・ページが表示されます。表6-8に、「認可」で使用可能な属性を示します。

表6-8 認可属性

属性

説明

認可スキーム

アプリケーションの認可スキームを指定します。アプリケーションの認可スキームは、アクセス制御のためにアプリケーションに定義されます。ここで必要な認可スキームをアプリケーション・レベルで設定するには、アプリケーションのすべてのページが定義済の認可チェックに合格する必要があります。

認可スキームの定義

「認可スキームの定義」をクリックして、認可スキームを作成します。

パブリック・ページで実行

アプリケーション・レベルの認可スキームをパブリック・ページ(つまり、認可を必要としないページ)でチェックするかどうかを制御します。オプションは次のとおりです。

- はい: 「はい」を選択し、ページがパブリックの場合は、アプリケーション認可がチェックされます。

- いいえ: 「いいえ」を選択し、ページがパブリックの場合は、アプリケーション認可が無視されます。

通常、認可はユーザー名に依存するため、アプリケーション・レベルの認可は、(「パブリック・ページで実行」にかかわらず)ログイン・ページでは評価されません。

関連項目:

アプリケーションへの認可スキームの割当て

6.5.2.2.3 セッション管理

「セッション・タイムアウト」属性を使用して、アプリケーションでWebブラウザが開いたまま放置されたコンピュータに対する公開を抑制します。表6-9に、「セッション・タイムアウト」で使用可能な属性を示します。

表6-9 「セッション管理」

属性

説明

セッションを再結合

この属性を使用して、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は新しいセッションを開始し、アプリケーションのホームページにリダイレクトします。

関連項目: セキュリティ(ページ・レベルでこの動作を上書きする場合の詳細)

最大セッションの長さ

セッションが存続してこのアプリケーションで使用できる期間(秒単位)を定義します。

- セッションの存続期間を制御する正の整数を入力します。

- セッションを無期限に存続させる場合は、0を入力します。

- ワークスペース・レベルまたはインスタンス・レベルで定義されたセッションの存続期間を使用する場合は、値を空のままにします。

セッション存続期間より、8時間ごとに実行され、12時間より前から存在するセッションを削除するジョブの操作が優先される場合があります。

セッション・タイムアウトURL

最大セッション存続期間を超えた際にリダイレクトされるオプションのURLを入力します。このURLのターゲット・ページは、Application Expressで実装された場合、パブリック・ページである必要があります。

このページの一般的な用途は、ユーザーにセッションの有効期間を知らせ、ログイン・リンクや他のオプションを表示することです。URLが入力されていない場合、ユーザーには、メッセージ「セッションがタイムアウトしました。」およびアプリケーションのホームページのリンクが表示されます。#LOGOUT_URL#を入力すると、Application Expressは、ユーザーがアプリケーションのログアウト・リンクをクリックした場合と同じようにログアウトを実行します。
次の3つの置換アイテムのみがサポートされます。

- &APP_SESSION.

- &SESSION.

- &APP_ID.

このURLは特別な目的を持つため、リンクに&APP_SESSION.および&SESSION.のいずれも含める必要はありません。

最大セッション・アイドル時間

セッション・アイドル時間は、最後のページ・リクエストと次のページ・リクエストの間の時間です。オプションは次のとおりです。

- このアプリケーションで使用するセッションのアイドル時間を制御するには、正の整数を入力します。

- セッション・アイドル時間のチェックが実行されないようにするには、値を0に設定します。

- ワークスペース・レベルまたはインスタンス・レベルで定義されたアイドル期間を使用する場合は、値を空のままにします。

セッション・アイドル・タイムアウトURL

最大セッション・アイドル時間を超えた際にリダイレクトされるオプションのURLを入力します。このURLのターゲット・ページは、Application Expressで実装された場合、パブリック・ページである必要があります。このページの一般的な用途は、ユーザーにセッションの有効期間を知らせ、ログイン・リンクや他のオプションを表示することです。URLが入力されていない場合、ユーザーには、メッセージ「セッションがタイムアウトしました。」およびアプリケーションのホームページのリンクが表示されます。#LOGOUT_URL#を入力すると、Application Expressは、ユーザーがアプリケーションのログアウト・リンクをクリックした場合と同じようにログアウトを実行します。

このURLでは次の3つの置換アイテムのみがサポートされます:

- &APP_SESSION.

- &SESSION.

- &APP_ID.

このURLは特別な目的を持つため、リンクに&APP_SESSION.および&SESSIONのいずれも含める必要はありません。

関連項目:

セッション・タイムアウトの使用についておよびOracle Application Express管理ガイドの「セッション・タイムアウトの構成」

6.5.2.2.4 セッション・ステート保護

セッション・ステート保護を有効にすると、ハッカーがアプリケーション内のURLを改ざんするのを防ぐことができます。URL改ざんにより、プログラム・ロジック、セッション・ステートの内容および情報プライバシが悪影響を受ける可能性があります。表6-10に、「セッション・ステート保護」で使用可能な属性を示します。

表6-10 「セッション・ステート保護」

属性

説明

セッション・ステート保護

「セッション・ステート保護」リストから選択して、アプリケーションのセッション・ステート保護を有効化または無効化します。「有効」を選択すると、ページおよびアイテム・レベルで定義されたセッション・ステート保護コントロールがオンになります。詳細は、フィールドレベル・ヘルプを参照してください。

この後に作成されるURLの許可

ブックマーク済リンクにチェックサムが含まれ、セッション・ステート保護がアプリケーションに対して有効な場合、ブックマーク済リンクをこのアプリケーションのページへのアクセスに使用できるようになった日時がリストされます。

この日付および時間より前に作成されたブックマークは、ブックマーク済リンクにチェックサムが含まれ、セッション・ステート保護がアプリケーションに対して有効な場合、このアプリケーションへのアクセスに使用できません。チェックサムを含まないブックマークまたは不要なチェックサムを含むブックマークは、この属性による影響を受けません。これらの有用性は、他の基準を使用して決定されます。非表示のアプリケーション属性(チェックサム・ソルト)は、計算時と、ページのレンダリング時に生成されたf?p= URLに含まれるチェックサムのその後の検証時に使用されます。チェックサムは、「セッション・ステート保護」がアプリケーションに対して有効な場合に含まれます。このチェックサム・ソルト属性は、「ブックマークの無効化」ボタンをクリックすると、いつでもリセットできます。

ブックマーク・ハッシュ関数

ブックマーク可能なURLの、アプリケーション・レベルおよびユーザー・レベルのチェックサムを作成するために使用されます。

ブックマークの無効化

「ブックマークの無効化」をクリックすると、この非表示のアプリケーション属性(チェックサム・ソルト)のソルト属性をいつでもリセットできます。このボタンをクリックすると、以前に生成されたチェックサムを含むブックマーク済URLは、その後にアプリケーションへのアクセスに使用されるときに失敗します。

ヒント: 「ブックマークの無効化」をクリックして、ブックマーク・ハッシュ関数を変更し、チェックサムを計算する別のアルゴリズムに切り替えることもできます。

セッション・ステート保護の管理

「セッション・ステート保護の管理」をクリックして、セッション・ステート保護を構成します。

関連項目:

セッション・ステート保護の理解

6.5.2.2.5 ブラウザ・セキュリティ

表6-11に、「ブラウザ・セキュリティ」で使用可能な属性を示します。

表6-11 「ブラウザ・セキュリティ」

属性

説明

キャッシュ

「キャッシュ」を使用して、アプリケーションのページ・コンテンツのブラウザによるキャッシュを有効化または無効化します。有効化すると、ブラウザはこのアプリケーションのページ・コンテンツを、メモリー内とディスク上の両方のキャッシュに保存します。キャッシュが有効になっている場合に、ブラウザの「戻る」ボタンがクリックされると、通常、ページはサーバーからではなくキャッシュからロードされます。無効にすると、ブラウザはアプリケーションのページ・コンテンツを保存しないように指示され、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をサポートする最新のブラウザが必要です。

6.5.2.2.6 データベース・セッション

表6-12に、「データベース・セッション」で使用可能な属性を示します。

表6-12 「データベース・セッション」

属性

説明

解析対象スキーマ

アプリケーション内のすべての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管理者ガイド

6.5.3 グローバリゼーション属性の構成

「グローバリゼーション属性の編集」で属性を編集して、アプリケーションのグローバリゼーション・オプションを構成します。アプリケーション・ビルダーでは、異なる言語で同時に実行可能なアプリケーションを開発できます。

1つのアプリケーションを、異なる言語をサポートするよう変換できます。「グローバリゼーション属性の編集」ページの属性を使用して、アプリケーションのプライマリ言語や、日付書式、時間書式、タイムスタンプ書式、タイムゾーン書式およびCSVエンコーディングのデフォルトなどのグローバリゼーション・オプションを指定します。

トピック:

- グローバリゼーション属性のページへのアクセス

- グローバリゼーション属性の編集ページ

関連項目:

アプリケーションのグローバリゼーションの管理

6.5.3.1 グローバリゼーション属性のページへのアクセス

グローバリゼーション属性の編集ページにアクセスするには、次のステップを実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

アプリケーションのホームページが表示されます。

3. 「共有コンポーネント」をクリックします。

共有コンポーネント・ページが表示されます。

4. 「グローバリゼーション」で、「グローバリゼーション属性」をクリックします。

グローバリゼーション属性の編集ページが表示されます。

5. 該当する属性を編集し、「変更の適用」をクリックします。

ヒント:

「アプリケーション定義の編集」にナビゲートして「グローバリゼーション」タブをクリックしても、グローバリゼーション属性の編集ページにアクセスできます。アプリケーション定義の編集ページへのアクセスを参照してください。

6.5.3.2 グローバリゼーション属性の編集ページ

次の項では、グローバリゼーション属性の編集ページで使用可能な属性について説明します。

注意:

必須の値には赤いアスタリスク(*)が付いています。

トピック:

- アプリケーションのプライマリ言語

- アプリケーション言語の導出元

- 文書方向

- アプリケーション日付書式

- アプリケーションの日時書式

- アプリケーションのタイムスタンプ書式

- アプリケーションのタイムスタンプ・タイムゾーン書式

- 文字の値の比較

- 文字の値の比較動作

- 自動タイムゾーン

- 自動CSVエンコーディング

関連項目:

アプリケーションへのプライマリ言語の指定

6.5.3.2.1 アプリケーションのプライマリ言語

アプリケーションを開発する言語を指定します。この言語が、すべての変換の元となるベース言語になります。たとえば、英語で作成されたアプリケーション100が、フランス語に変換され、アプリケーション101として公開されたとします。英語がアプリケーションのプライマリ言語になります。

アプリケーションに対するすべての変更は、ここで指定したプライマリ言語で行う必要があります。

6.5.3.2.2 アプリケーション言語の導出元

翻訳されたアプリケーション言語がApplication Expressによって導出される方法を指定します。アプリケーションのプライマリ言語は静的にすることも、Webブラウザ言語から導出したり、ユーザー・プリファレンスやアイテムから特定することもできます。

使用可能なオプションの詳細は、フィールドレベル・ヘルプを参照してください。

6.5.3.2.3 文書方向

文書方向を設定します。オプションは次のとおりです。

- 左から右

- 右から左

6.5.3.2.4 アプリケーション日付書式

アプリケーションで使用する日付書式を決定します。

この日付書式を使用すると、NLS_DATE_FORMATデータベース・セッションの設定が変更されてから、アプリケーション内のページが表示または送信されます。この値には、有効なOracle日付書式マスクを含むリテラル文字列、または置換構文を使用したアイテム参照を指定できます。値が指定されていない場合は、データベース・セッションからデフォルトの日付書式が実行時に取得されます。次の例を参考にしてください。

Month DD, YYYY
&MY_DATE_FORMAT.

6.5.3.2.5 アプリケーションの日時書式

アプリケーションで使用する日時書式を指定します。

この日時書式は、置換参照&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.

6.5.3.2.6 アプリケーションのタイムスタンプ書式

アプリケーションで使用するタイムスタンプ書式を決定します。LOVからタイムスタンプ書式を選択します。

このタイムスタンプ書式を使用すると、NLS_TIMESTAMP_FORMATデータベース・セッションの設定が変更されてから、アプリケーション内のページが表示または送信されます。この値には、有効なOracleタイムスタンプ書式マスクを含むリテラル文字列、または置換構文を使用したアイテム参照を指定できます。値が指定されていない場合は、データベース・セッションからデフォルトのタイムスタンプ書式が実行時に取得されます。次の例を参考にしてください。

DD-MON-RR HH.MI.SSXFF AM
&MY_TIMESTAMP_FORMAT.

6.5.3.2.7 アプリケーションのタイムスタンプ・タイムゾーン書式

アプリケーションで使用するタイムゾーン付きのタイムスタンプ書式を決定します。

この日付書式を使用すると、NLS_TIMESTAMP_TZ_FORMATデータベース・セッションの設定が変更されてから、アプリケーション内のページが表示または送信されます。この値には、有効なOracleタイムスタンプ書式マスクを含むリテラル文字列、または置換構文を使用したアイテム参照を指定できます。値が指定されていない場合は、データベース・セッションからデフォルトのタイムゾーン付きのタイムスタンプ書式が実行時に取得されます。次の例を参考にしてください。

DD-MON-RR HH.MI.SSXFF AM TZR
&MY_TIMESTAMP_TZ_FORMAT.

6.5.3.2.8 文字の値の比較

ORDER BY、LIKE、MIN/MAXなど、様々なSQL操作およびSQL句で文字の値を比較する際の照合順序を決定します。

この値を使用すると、クラシック・レポートおよび対話モード・レポート・リージョンのSQL問合せの実行に対するNLS_SORTデータベース・セッション・パラメータが変更されます。値が指定されていない場合は、データベース・セッションからデフォルト値が実行時に取得されます。次の例を参考にしてください。

BINARY
GERMAN
CANADIAN_M

6.5.3.2.9 文字の値の比較動作

LIKE、MIN/MAXなど、SQL操作の照合動作を決定します。

この値を使用して、クラシック・レポート、対話モード・レポート、リスト・ビューの各リージョン、およびプラグインAPIのSQL問合せの実行のNLS_COMPデータベース・セッション・パラメータを変更します。オプションは次のとおりです。

- データベース・セッションのNLS設定(デフォルト): NLS_COMP値は、実行時にデータベース・セッションから取得されます。

- バイナリ: WHERE句および他のSQL操作での比較はバイナリです。

- 言語形式: WHERE句および他のSQL操作での比較は、「文字の値の比較」属性(NLS_SORT)で指定した言語ソートを使用します。

6.5.3.2.10 自動タイムゾーン

データベース・セッションのタイムゾーンの設定を制御します。「はい」に設定すると、クライアント・タイムゾーンがクライアントのWebブラウザから取得され、Application Expressセッションの継続時間用に設定されます。

その後のページ・ビューには、ページ・ビューごとに適切なデータベース・セッション・タイムゾーンが設定されます。設定後、この設定はAPEX_UTIL.SET_SESSION_TIME_ZONEを使用して上書きしたり、APEX_UTIL.RESET_SESSION_TIME_ZONEを使用して再設定することができます。

関連項目:

Oracle Application Express APIリファレンス

6.5.3.2.11 自動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)でエンコードされます。

6.5.4 アプリケーションのユーザー・インタフェースの管理

「ユーザー・インタフェース」ページの属性を編集して、アプリケーションのデフォルト特性を決定し、ターゲット環境(デスクトップまたはモバイルなど)用の表示を最適化します。ユーザー・インタフェース・ページの一般的な属性とユーザー・インタフェースの詳細ページの特定の属性を編集することで、ユーザー・インタフェースをカスタマイズできます。

トピック:

- ユーザー・インタフェース属性へのアクセス

- ユーザー・インタフェース・ページ

- アプリケーション・ロゴの定義

- 新しいユーザー・インタフェースの作成

- ユーザー・インタフェースの詳細ページ

6.5.4.1 ユーザー・インタフェース属性へのアクセス

ユーザー・インタフェース属性にアクセスするには、次のステップを実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

アプリケーションのホームページが表示されます。

3. 「共有コンポーネント」をクリックします。

共有コンポーネント・ページが表示されます。

4. 「ユーザー・インタフェース」で「ユーザー・インタフェース属性」をクリックします。

ユーザー・インタフェース属性ページが表示されます。詳細は次を参照してください。

5. 特定のユーザー・インタフェースの属性を編集するには、「ユーザー・インタフェース」リージョンで、以前に定義されたユーザー・インタフェースを選択します。

ユーザー・インタフェースの詳細ページが表示されます。

6. 該当する属性を編集し、「変更の適用」をクリックします。

ヒント:

「アプリケーション定義の編集」にナビゲートして「ユーザー・インタフェース」タブをクリックしても、「ユーザー・インタフェース」属性にアクセスできます。アプリケーション定義の編集ページへのアクセスを参照してください。

関連項目:

「ユーザー・インタフェース・ページ」と「ユーザー・インタフェースの詳細ページ」

6.5.4.2 ユーザー・インタフェース・ページ

ユーザー・インタフェース・ページは、次のセクションに分かれています。

ヒント:

このページの属性の詳細は、フィールドレベル・ヘルプを参照してください。

トピック:

- 一般プロパティ

- ロゴ

- ファビコン

- ユーザー・インタフェースの検出

- ユーザー・インタフェース

関連項目:

ユーザー・インタフェース属性へのアクセス

6.5.4.2.1 一般プロパティ

「一般プロパティ」を使用して、アプリケーション・ユーザー・インタフェースの基本的な特性を定義します。表6-13に、「一般プロパティ」のすべての属性を示します。

表6-13 「ユーザー・インタフェース」の「一般プロパティ」

属性

説明

静的ファイルの接頭辞

#APP_IMAGES#置換文字列の使用時に、Webサーバーが静的ファイルを指定する場合に使用する仮想パスを決定します。

データベースのアプリケーション定義とともに格納されたファイルを参照するものを指定しないでください。

パフォーマンス上の理由から、アプリケーション・ファイルをWebサーバーに格納することもできます。任意の有効なURLを使用してそれらを参照します。

次に例を示します。

- /myFiles/

- http://contentDeliveryNetwork.com/myFiles/

イメージ接頭辞

アプリケーション・ビルダーによって分散されたイメージ・ディレクトリを指すためにWebサーバーが使用する仮想パスを決定します。インストール時、仮想パスは/i/として構成されます。不明な場合は、管理者に連絡してください。

静的テキスト(ページ、リージョン・ヘッダー、リージョン・フッターなど)にイメージを埋め込む場合は、置換文字列#IMAGE_PREFIX#を使用してイメージを参照できます。たとえば、イメージgo.gifを参照するには、次の構文を使用します。

<img src="#IMAGE_PREFIX#go.gif">

注意: 入力されたイメージ接頭辞がインスタンス・イメージ接頭辞と同じである場合、アプリケーション・レベル属性は常にnullになります。これにより、異なるイメージ接頭辞を持つ可能性のある様々なインスタンス間で、アプリケーションを簡単に移動できます。

関連項目: IMAGE_PREFIX

メディア・タイプ

インターネット・メディア・タイプを入力します。インターネット・メディア・タイプは、2つの部分で構成される、インターネット上のファイル形式を表す識別子です。メディア・タイプは、少なくともタイプとサブタイプの2つの部分で構成され、オプションで1つ以上のパラメータを指定します。メディア・タイプは、ページ描画の際にHTTPヘッダーのContent-Typeで使用されます。

ページ・レベルのメディア・タイプが、アプリケーション・レベルのメディア・タイプを上書きします。この属性のデフォルト値はNULLです。ページ・レベルとアプリケーション・レベルの両方でメディア・タイプの値がNULLの場合、メディア・タイプとしてtext/htmlが使用されます。

6.5.4.2.2 ロゴ

「ロゴ」属性は、アプリケーション・ロゴを定義する際に使用します。アプリケーション・ロゴは、テキスト・ベースにもイメージ・ベースにもできます。この機能を使用するには、ページ・テンプレートに#LOGO#置換文字列が含まれている必要があります。

関連項目:

アプリケーション・ロゴの定義

6.5.4.2.3 ファビコン

この属性にファビコンHTMLコードを入力して、ファビコン(またはショートカット・アイコン)を作成します。この機能を使用するには、ページ・テンプレートに#FAVICONS#置換文字列が含まれている必要があります。次に例を示します。

<link rel="shortcut icon" href="/i51/favicon.ico">
<link rel="icon" sizes="16x16" href="/i51/favicon-16x16.png">
<link rel="icon" sizes="32x32" href="/i51/favicon-32x32.png">
<link rel="apple-touch-icon" sizes="180x180" href="/i51/favicon-180x180.png">

6.5.4.2.4 ユーザー・インタフェースの検出

自動検出が失敗した際に、Application Expressが使用可能なユーザー・インタフェースを表示するためにロードする必要のあるスタイルシートのCSSファイルURLを入力します。各URLを新しい行に記述する必要があります。ファイルの縮小バージョンを指定する場合、置換文字列#MIN#を使用して.min ,を、または#MIN_DIRECTORY#を使用して minified/を通常ページ・ビューのファイルURLに含めたり、ページをデバッグ・モードで表示する場合は空の文字列を含めることができます。アプリケーションのバージョンをファイルURLに含める場合、置換文字列#APP_VERSION#にアクセスすることもできます。

例を表示するには、フィールドレベル・ヘルプを参照してください。

6.5.4.2.5 ユーザー・インタフェース

現在のアプリケーションに定義されているユーザー・インタフェースを表示します。既存のユーザー・インタフェースを編集するには、ユーザー・インタフェース名をクリックします。新しいユーザー・インタフェースを追加するには、「新規ユーザー・インタフェースの追加」をクリックします。

関連項目:

ユーザー・インタフェース属性へのアクセス、新しいユーザー・インタフェースの作成およびユーザー・インタフェースの詳細ページ

6.5.4.3 アプリケーション・ロゴの定義

アプリケーション・ロゴを定義するには、次のステップを実行します。

1. ユーザー・インタフェース・ページにアクセスします。
次に、ロゴ属性を指定します。

2. ロゴがイメージの場合:

a. ロゴ・タイプ - 「イメージ」を選択します。

b. ロゴ - ファイル名の拡張子(たとえば、/i/oracle.gif)または完全修飾されたURL (イメージを参照している場合)を含む完全なイメージ名を入力します。

c. ロゴ属性 - ロゴの適切な属性を入力するか、リストから選択します。

3. ロゴがテキストの場合:

a. 「ロゴ・タイプ」で、「テキスト」を選択します。

b. ロゴ - 次のような、完全なテキスト文字列を入力します。
サンプル・アプリケーション

c. ロゴ属性 - ロゴの適切な属性を入力するか、リストから選択します。

4. 「変更の適用」をクリックします。

ヒント:

置換文字列を使用して、静的ファイル・リポジトリにアップロードされたイメージを参照することもできます。詳細は、「静的アプリケーション・ファイルの参照」および「静的ワークスペース・ファイルの参照について」を参照してください。

関連項目:

- ユーザー・インタフェース属性へのアクセス

- 「静的アプリケーション・ファイルの管理」

- 「静的ワークスペース・ファイルの管理」

- カスタム・テーマの作成

- ページ・テンプレート

6.5.4.4 新しいユーザー・インタフェースの作成

新しいユーザー・インタフェースを追加するには、次のステップを実行します。

1. ユーザー・インタフェース・ページにナビゲートします。

2. 「ユーザー・インタフェース」リージョンで、「新規ユーザー・インタフェースの追加」をクリックします。

3. 画面に表示されるステップに従います。

属性の詳細は、フィールドレベル・ヘルプを参照してください。

4. 選択した内容を確認し、「作成」をクリックします。

関連項目:

ユーザー・インタフェース属性へのアクセスおよびユーザー・インタフェースの詳細ページ

6.5.4.5 ユーザー・インタフェースの詳細ページ

ユーザー・インタフェースの詳細ページは、次のセクションに分かれています。

トピック:

- 識別

- 属性

- ナビゲーション・メニュー

- ナビゲーション・バー

- JavaScript

- カスケード・スタイルシート

- 連結されたファイル

関連項目:

ユーザー・インタフェース属性へのアクセス

6.5.4.5.1 指定

表6-14 「ユーザー・インタフェースの詳細」の「指定」

属性

説明

ユーザー・インタフェース・タイプ

選択したインタフェース・タイプを表示します。「デスクトップ」ユーザー・インタフェースは、主としてデスクトップで使用するために設計されたアプリケーションに使用されます。「モバイル」ユーザー・インタフェースは、主としてスマートフォンおよびタブレットで使用するために設計されたアプリケーションに使用されます。

表示名

ユーザー・インタフェースの表示名を指定します。表示名は、テーマの作成ウィザードなどのウィザードに表示されます。

順序

ユーザー・インタフェースの表示順序を指定します。

6.5.4.5.2 属性

表6-15 「ユーザー・インタフェースの詳細」の「属性」

属性

説明

自動検出

ユーザー・インタフェースを自動的に検出する必要があるかどうかを選択します。自動検出を有効にすると、ユーザーは対応するログイン・ページまたはホームページにリダイレクトされます。

デフォルト

ユーザー・インタフェースを、アプリケーションのデフォルトのインタフェースにするかどうかを選択します。

テーマ・スタイルを選択できるようにエンド・ユーザーを有効化

「はい」に設定すると、エンド・ユーザーは、カスタマイズ・ダイアログ内でセッションのテーマ・スタイルを選択できます。「パブリック」とマークされたテーマ・スタイルのみを選択できます。

関連項目: ユーザーによるテーマ・スタイルの選択の可能化

ホームURL

現在のユーザー・インタフェースに対するアプリケーションのホームページを指定します。

ログインURL

現在のユーザー・インタフェースに対するアプリケーションのログイン・ページを指定します。

テーマ

現在ユーザー・インタフェースに関連付けられているテーマを表示します。

関連項目: テーマの切替え

テーマ・スタイル

テーマ・スタイルを選択します。このオプションは、テーマ・スタイルをサポートする新しいテーマに対してのみ表示されます。

関連項目: テーマ・スタイルの使用

グローバル・ページ

定義されている場合、アプリケーションのグローバル・ページが表示されます。

関連項目: すべてのページにコンポーネントを表示するグローバル・ページの作成

6.5.4.5.3 ナビゲーション・メニュー

「ナビゲーション・メニュー」属性は、新しいテーマとともにのみ表示されます。

表6-16 「ユーザー・インタフェースの詳細」の「ナビゲーション・メニュー」

属性

説明

ナビゲーション・メニュー・リスト

アプリケーションのナビゲーション・メニューに利用されるリストを選択します。

位置

このアプリケーションにナビゲーション・メニューを配置する位置を選択します。

- サイド ページ・テンプレートの#SIDE_GLOBAL_NAVIGATION_LIST#の位置のナビゲーション・メニューのリスト・テンプレートがレンダリングされます。

- トップ ページ・テンプレートの#TOP_GLOBAL_NAVIGATION_LIST#の位置のナビゲーション・メニューのリスト・テンプレートがレンダリングされます。

たとえば、「サイド」を選択すると、ページの左側のツリーとしてナビゲーションをレンダリングできます。「トップ」を選択すると、ページのヘッダーのメニュー・バーとしてナビゲーションをレンダリングできます。

リスト・テンプレート

このアプリケーションのナビゲーション・メニューのレンダリングに使用されるリスト・テンプレートを選択します。

テンプレート・オプション

アプリケーションのナビゲーション・メニュー・リストに使用されるリスト・テンプレートのテンプレート・オプションを設定します。

6.5.4.5.4 ナビゲーション・バー

「ナビゲーション・バー」属性は、新しいテーマとともにのみ表示されます。

表6-17 「ユーザー・インタフェースの詳細」の「ナビゲーション・バー」

属性

説明

実装

このアプリケーションのナビゲーション・バーの実装方法を選択します。

- クラシック ページ・テンプレートの#NAVIGATION_BAR#の位置に、クラシック・ナビゲーション・バーとしてナビゲーション・バーがレンダリングされます。

- リスト ページ・テンプレートの#NAVIGATION_BAR#の位置に、選択されたリストおよびリスト・テンプレートを使用して、リストとしてナビゲーション・バーがレンダリングされます。

ナビゲーション・バー・リスト

このアプリケーションのナビゲーション・バーのレンダリングに使用されるリスト・テンプレートを選択します。

リスト・テンプレート

このアプリケーションのナビゲーション・メニューのレンダリングに使用されるリスト・テンプレートを選択します。

テンプレート・オプション

アプリケーションのナビゲーション・メニュー・リストに使用されるリスト・テンプレートのテンプレート・オプションを設定します。

6.5.4.5.5 JavaScript

これらの属性を使用して、アプリケーションがJavaScriptを処理する方法を制御または変更します。

表6-18 「ユーザー・インタフェースの詳細」の「JavaScript」

属性

説明

コンテンツ配信ネットワーク

Application ExpressでライブラリjQueryおよびjQuery Mobileをロードするために使用が試行されるコンテンツ配信ネットワーク(CDN)を指定します。Application Expressでは、そのCDNからこれらのライブラリをロードできない場合、かわりにWebサーバーからこれらのライブラリがロードされます。

CDNを使用すると、ユーザーがすでに同じCDNを使用する他の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ファイルの全体のサイズが削減されます。

6.5.4.5.6 カスケード・スタイルシート

「ファイルURL」で、すべてのページにロードするカスケード・スタイルシートのファイルURLを入力します。各URLを新しい行に記述する必要があります。ファイルの縮小バージョンを指定する場合、置換文字列#MIN#を使用して.min ,を、または#MIN_DIRECTORY#を使用して minified/を通常ページ・ビューのファイルURLに含めたり、ページをデバッグ・モードで表示する場合は空の文字列を含めることができます。アプリケーションのバージョンをファイルURLに含める場合、置換文字列#APP_VERSION#にアクセスすることもできます。

ここに入力したファイルURLによって、ページ・テンプレート内の#APPLICATION_CSS#置換文字列が置き換えられます。

例は、フィールドレベル・ヘルプを参照してください。

6.5.4.5.7 連結されたファイル

連結されたファイルを使用すると、単一のファイルごとに複数のHTTPリクエストを発行するかわりにブラウザで1つのファイルのみをロードするため、ページをロードするパフォーマンスを向上できます。この方法には、開発中に、より小さく、よりモジュール化されたファイルを使用し、Application Express開発環境の外部のアプリケーションを実行するときには、単一の連結されたファイルを使用するオプションがあります。

連結されたファイルを作成するには、「連結されたファイル」をクリックして、画面に表示される手順に従います。詳細および例を確認するには、フィールドレベル・ヘルプを参照してください。

6.6 データベース・アプリケーションのページの管理

ページは、アプリケーションの基本的な構成要素です。アプリケーション・ビルダーでアプリケーションを構築する際は、タブ、リスト、ボタン、アイテム、リージョンなどのユーザー・インタフェース要素を含むページを作成します。

ヒント:

アプリケーション・ビルダーでは、ページ・デザイナまたはコンポーネント・ビューを使用してアプリケーション・ページを表示および管理します。詳細は、ページ・デザイナでのページの管理またはアプリケーション・レガシー・コンポーネントの管理を参照してください。

トピック:

- データベース・アプリケーションへのページの追加について

- ページの作成ウィザード実行時のページ・タイプ

- アプリケーションのホームページからのページの作成

- ダイアログ・ページの作成

- データベース・アプリケーション・ページのコピーについて

- ユーザー・インタフェース間のページのコピーについて

- データベース・アプリケーション・ページの削除について

関連項目:

アプリケーション・ユーティリティの使用

6.6.1 データベース・アプリケーションへのページの追加について

開発者は、ページの作成ウィザードを実行することによって、既存のデータベース・アプリケーションにページを追加します。このウィザードには次のようにアクセスできます。

- アプリケーションのホームページ: 「ページの作成」をクリックします。アプリケーションのホームページからのページの作成を参照してください。

- ページ・デザイナでのページの表示: ページ・デザイナの開発者ツールバーで「作成」をクリックして「ページ」を選択します。ページ・デザイナ・ツールバーを参照してください。

- コンポーネント・ビューでのページの表示: コンポーネント・ビューのナビゲーション・バーで「作成」をクリックして「ページ」を選択します。コンポーネント・ビューのナビゲーション・バーを参照してください。

6.6.2 ページの作成ウィザード実行時のページ・タイプ

アプリケーションを作成するときに、ターゲット・ユーザー・インタフェースを選択します。選択したユーザー・インタフェースによって、使用可能なページ・タイプが決まります。すべてのページ・タイプがすべてのユーザー・インタフェースでサポートされるわけではありません。

デスクトップ・アプリケーションで使用可能なページ・タイプ

デスクトップ・アプリケーションを作成している場合、ページの作成ウィザードで次のページ・タイプがサポートされます。

表6-19 ページの作成ウィザード: デスクトップ・アプリケーションのページ・タイプ

ページ・タイプ

説明

詳細情報

空白ページ

組込み機能のないページを作成します。

該当なし

レポート

レポートは、SQL問合せの結果の書式を設定したものです。レポート・オプション:

- 対話モード・レポート

- 対話グリッド

- クラシック・レポート

- 表のレポートとフォーム

- Webサービスのレポート

関連項目:

- 「レポートの開発」

- 「レポート・タイプについて」

- 「ページの作成ウィザード実行時のレポート・オプション」

フォーム

フォームでは、ユーザーが表内の単一行または複数行を更新できます。フォーム・オプション:

- 表のフォーム付きレポート

- 編集可能対話グリッド

- 1ページのマスター・ディテール

- 2ページのマスター・ディテール

- 表のフォーム

- プロシージャのフォーム

- SQL問合せのフォーム

- Webサービスのフォーム

- Webサービスのレポートとフォーム

関連項目:

- 「フォームの作成」

- 「フォーム・タイプの理解」

- 「ページの作成ウィザード実行時のフォーム・オプション」

プラグイン

リージョン・タイプ・プラグインに基づいて新しいページを作成します。開発者はプラグインを使用して、Oracle Application Expressで使用可能な組込みタイプを宣言的に拡張、共有および再利用できます。

プラグイン・ページからのプラグインのインポートを参照してください。

チャート

グラフィカル・チャートを作成できます。

チャートの作成を参照してください。

Calendar

月別、週別、日別表示のカレンダを生成します。

カレンダの作成を参照してください。

ツリー

階層的なデータまたは複数のレベルのデータをグラフィカルに通信し、必要に応じて各ツリー・ノードに固有のページまたはURLにナビゲートするためのツリーを作成します。

ツリーの作成を参照してください。

ウィザード

ウィザードを作成します。

該当なし

データのロード

新しいデータのロード・ウィザードを作成して、エンド・ユーザーが、権限を持つすべてのスキーマに対する表へのデータのロードを管理できるようにします。

データ・ロード機能によるアプリケーションの作成を参照してください。

フィードバック・ページ

フィードバック・ページを追加します。フィードバックは、アプリケーション・ユーザーからリアルタイム・コメント、拡張リクエストおよびバグを収集するプロセスです。

フィードバックの管理を参照してください。

アクセス制御

アクセス制御リストを含むページを作成すると、開発者はアプリケーション、個別ページまたはページ・コンポーネントへのアクセスを制御できます。

アプリケーション、ページおよびページ・コンポーネントへのアクセスの制御を参照してください。

グローバル・ページ

グローバル・ページ(以前はページ0と呼ばれていた)は、マスター・ページとして機能します。

すべてのページにコンポーネントを表示するグローバル・ページの作成を参照してください。

レガシー・ページ

レガシー・ページに含まれるコンポーネントは、引き続きOracleでサポートされますが、使用することはお薦めしません。オプションは次のとおりです。

- 表形式フォーム

- レガシー・マスター・ディテール

- AnyChartチャート

- サマリー・ページ

- レガシー・カレンダ

アプリケーション・レガシー・コンポーネントの管理を参照してください。

モバイル・アプリケーションで使用可能なページ・タイプ

モバイル・アプリケーションを作成している場合、ページの作成ウィザードで次のページ・タイプがサポートされます。

表6-20 ページの作成ウィザード: モバイル・アプリケーションのページ・タイプ

ページ・タイプ

説明

詳細情報

空白ページ

組込み機能のないページを作成します。

該当なし

レポート

レポートは、SQL問合せの結果の書式を設定したものです。使用可能なレポート・オプションは次のとおりです。

- リスト・ビュー

- 列切替えレポート

- リフロー・レポート

- Webサービスのレポート

関連項目:

- 「レポートの開発」

- 「レポート・タイプについて」

- 「ページの作成ウィザード実行時のレポート・オプション」

フォーム

フォームでは、ユーザーが表内の単一行または複数行を更新できます。使用可能なフォーム・オプションは次のとおりです。

- 表のリスト・ビュー付きのレポート

- 表のフォーム

- プロシージャのフォーム

- SQL問合せのフォーム

- Webサービスのフォーム

- Webサービスのレポートとフォーム

関連項目:

- 「フォームの作成」

- 「フォーム・タイプの理解」

- 「ページの作成ウィザード実行時のフォーム・オプション」

プラグイン

リージョン・タイプ・プラグインに基づいて新しいページを作成します。開発者はプラグインを使用して、Oracle Application Expressで使用可能な組込みタイプを宣言的に拡張、共有および再利用できます。

プラグイン・ページからのプラグインのインポートを参照してください。

チャート

グラフィカル・チャートを作成できます。

レガシー・チャートの管理を参照してください。

Calendar

月別、週別、日別表示のカレンダを生成します。

カレンダの作成を参照してください。

ウィザード

ウィザードを作成します。

該当なし

フィードバック・ページ

フィードバック・ページを追加します。フィードバックは、アプリケーション・ユーザーからリアルタイム・コメント、拡張リクエストおよびバグを収集するプロセスです。

フィードバックの管理を参照してください。

アクセス制御

アクセス制御リストを含むページを作成すると、開発者はアプリケーション、個別ページまたはページ・コンポーネントへのアクセスを制御できます。

アプリケーション、ページおよびページ・コンポーネントへのアクセスの制御を参照してください。

レガシー・ページ

レガシー・ページに含まれるコンポーネントは、引き続きOracleでサポートされますが、使用することはお薦めしません。オプションは次のとおりです。

- AnyChartチャート

- サマリー・ページ

- レガシー・カレンダ

アプリケーション・レガシー・コンポーネントの管理を参照してください。

6.6.3 アプリケーションのホームページからのページの作成

アプリケーションのホームページからページを作成するには、次のステップを実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。

2. アプリケーションを選択します。
アプリケーションのホームページが表示されます。

3. 「ページの作成」ボタンをクリックします。

4. 「ページの作成」で、次のステップを実行します。

a. ユーザー・インタフェース: ページのユーザー・インタフェースを選択します。

b. 「ページ・タイプの選択」で、作成するページ・タイプを選択します。ページの作成ウィザード実行時のページ・タイプを参照してください。

c. 「次へ」をクリックします。

5. 画面に表示されるステップに従います。

関連項目:

- データベース・アプリケーションへのページの追加について

- 「ページ・デザイナでのページ属性の管理」

- 「コンポーネント・ビューでのダイアログ属性の構成」

6.6.4 ダイアログ・ページの作成

Oracle Application Expressには、ダイアログ・ページに対するサポートが提供されています。モーダルまたは非モーダル・ダイアログ・ページは、テンプレート・タイプが「ダイアログ・ページ」のページ・テンプレートが、カレント・アプリケーション・テーマに1つ以上含まれている場合にのみサポートされます。

トピック:

- サポートされるダイアログについて

- ダイアログ・ページ・テンプレートの使用

- コンポーネント・ビューでのダイアログとしてのページの定義

- ページ・デザイナでのダイアログとしてのページの定義

- ダイアログ・ページでの「ダイアログを取り消す」動的アクションの生成

- ダイアログ・ページでの「ダイアログを閉じる」ページ・プロセスの生成

- ダイアログ・ページでのブランチングについて

- 親ページでのリフレッシュ・アクションの処理

6.6.4.1 サポートされるダイアログについて

新しいページを作成するときに、ウィザードによって、ページ・モードを選択するプロンプトが表示されます。ページ・モードによって、ページが標準アプリケーション・ページであるかダイアログ・ページであるかが決まります。Oracle Application Expressは、次の2つのダイアログ・ページ・タイプをサポートしています。

- モーダル・ダイアログ - モーダル・ダイアログは、同じブラウザ・ウィンドウ内に配置されるオーバーレイ・ウィンドウです。モーダル・ダイアログは、ユーザーが終了して閉じるまで、アクティブでフォーカスされたままです。モーダル・ダイアログがアクティブである間は、ダイアログを閉じるまでユーザーは残りのページと対話できません。

- 非モーダル・ダイアログ - 非モーダル・ダイアログは、個別のポップアップ・ブラウザ・ウィンドウを表示します。ユーザーは、非モーダル・ダイアログおよびページのコンテンツと対話できます。リクエストされる情報が続行に必要でない場合に、非モーダル・ダイアログを使用します。このウィンドウ・タイプは、別の場所で作業が続いている間、開いたままにできます。

6.6.4.2 ダイアログ・ページ・テンプレートの使用

Oracle Application Expressには、ユニバーサル・テーマ - 42にダイアログ・ページ・テンプレートが含まれています。ページ・モードを「モーダル」または「非モーダル」に設定すると、Oracle Application Expressは自動的にデフォルトのダイアログ・ページ・テンプレートを使用します。この項では、テーマにダイアログ・テンプレートが含まれていない場合にそれを作成する方法と、ダイアログ・テンプレート属性を編集する方法について説明します。

トピック:

- ダイアログ・ページ・テンプレートの作成

- ダイアログ・ページ・テンプレート属性の定義について

6.6.4.2.1 ダイアログ・ページ・テンプレートの作成

既存のアプリケーションを使用し、テーマにそのようなダイアログ・ページ・テンプレートが含まれない場合は、ダイアログ・ページ・テンプレートを作成する必要があります。最初から作成できますが、最も簡単な方法は既存のダイアログ・テンプレートをコピーすることです。

ダイアログ・ページ・テンプレートを作成するには、次のステップを実行します。

1. サンプル・データベース・アプリケーションからダイアログ・ページ・テンプレートをコピーします。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. テンプレートをコピーするアプリケーションを選択します。

c. 「共有コンポーネント」をクリックします。

d. 「ユーザー・インタフェース」で、「テンプレート」を選択します。

e. 「作成」をクリックします。

f. テンプレートの作成ウィザードで、次のステップを実行します。

- テンプレート・タイプ - 「ページ」を選択して、「次へ」をクリックします。

- 作成方法 - 「既存のテンプレートのコピーとして」を選択して、「次へ」をクリックします。

- コピー元 - 「サンプル・データベース・アプリケーション」を選択して、「次へ」をクリックします。

- テーマの指定 - コピー元のテーマおよびコピー先のテーマを選択して、「次へ」をクリックします。

- 新規テンプレート - 「モーダル・ダイアログ」テンプレートを探します。「コピー」で、「はい」を選択します。

- 「ページ・テンプレートのコピー」を選択して作成します。

2. ダイアログ・ページ・テンプレートがカレント・テーマでアクティブになっていることを確認します。デフォルトのページ・テンプレートの選択を参照してください。

6.6.4.2.2 ダイアログ・ページ・テンプレート属性の定義について

ダイアログ・ページ・テンプレートには、ダイアログ・ページの初期化、クローズおよび取消を処理するJavaScriptファンクション・コールが含まれています。ダイアログ・ページ・テンプレートを作成する場合は、これらおよび他のダイアログ・ページ・テンプレート属性を定義する必要があります。

関連項目:

必須のダイアログ・ページ・テンプレート属性

6.6.4.3 コンポーネント・ビューでのダイアログとしてのページの定義

ダイアログ・ページを作成するには、ページ・モードを「モーダル・ダイアログ」または「非モーダル・ダイアログ」に設定する必要があります。ページの作成ウィザードの実行中またはページ属性の編集によってページ・モードを構成できます。

コンポーネント・ビューでダイアログとしてページを定義するには、次のステップを実行します。

1. ページ属性を編集します。コンポーネント・ビューでページを表示します。

2. ページ・モードを「モーダル・ダイアログ」および「非モーダル・ダイアログ」に設定します。

ヒント:

ページ属性を編集することによって、またはページの作成ウィザードの実行中にページ・モードを構成できます。

3. ページ・レベル・ダイアログ属性を定義します。

関連項目:

「コンポーネント・ビューでのページ属性の編集」および「ダイアログ」

6.6.4.4 ページ・デザイナでのダイアログとしてのページの定義

ページ・デザイナでダイアログとしてページを定義するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. ページを選択します。

ページ・デザイナが表示されます。

2. 「ページ・デザイナ」で「外観」を見つけます。

3. 「ページ・モード」で、次のいずれかを選択します。

- モーダル・ダイアログ - ページはモーダル・ダイアログとして表示されます。モーダル・ダイアログは、ビューポート内に配置されたオーバーレイ・ウィンドウで、エンド・ユーザーが終了する(閉じる)までアクティブでフォーカスされたままです。基になるページはグレーアウトされ、ダイアログを閉じるまで、エンド・ユーザーは残りのページと対話できません。

- 非モーダル・ダイアログ - ページは非モーダル・ダイアログとして表示されます。非モーダル・ダイアログはビューポート内に配置されたオーバーレイ・ウィンドウであり、エンド・ユーザーはこれを使用してダイアログおよびダイアログを起動したページのコンテンツと対話できます。非モーダル・ダイアログは、リクエストされる情報が続行するために必要な情報ではなく、ウィンドウが開いたままでも別の場所で作業を続行できる場合に使用できます。

4. 必要に応じて他の「外観」属性を編集します。

ヒント:

属性の詳細は、フィールドレベル・ヘルプを参照してください。

5. 「ダイアログ」で、適切な属性を編集します。

a. 幅 - ダイアログの幅をピクセル単位または比率で入力します。ページ・テンプレートのダイアログ初期化コード内の置換文字列#DIALOG_WIDTH#は、このアイテムに入力した値で置換されます。デスクトップ・ユーザー・インタフェースを使用しているページの場合、値は500などのピクセル単位で設定します。ただし、jQueryモバイル・スマートフォン・ユーザー・インタフェースを使用しているページの場合、値は80%などのパーセント単位で設定します。

b. 高さ - ダイアログの高さをピクセル単位で入力します(たとえば、500)。ページ・テンプレートのダイアログ初期化コード内の置換文字列#DIALOG_HEIGHT#は、入力した値で置換されます。

c. 最大幅 - ダイアログの最大幅をピクセル単位で入力します。ページ・テンプレートのダイアログ初期化コード内の置換文字列#DIALOG_MAX_WIDTH#は、このアイテムに入力した値で置換されます。

d. 属性 - ダイアログのサポートはページのユーザー・インタフェースによって異なります。高さ、幅および最大幅など、ダイアログ属性のサブセットは宣言的にサポートされます。ダイアログの追加属性を定義するには、名前/値のペアをカンマ区切りリストに入力します。ページ・テンプレート・レベルで定義されたダイアログ初期化コード内の置換文字列#DIALOG_ATTRIBUTES#は、このアイテムに入力された任意の値で置換されます。

e. CSSクラス - このコンポーネントに追加するクラスを入力します。複数のクラスは空白で区切って追加できます。

f. チェーン - このダイアログが別のダイアログによって開かれ、同じダイアログ・ウィンドウを再利用する場合、「はい」を選択します。たとえば、このダイアログが複数ページ・ダイアログ・ウィザードの一部で、ウィザードの各ステップにダイアログ・ウィンドウを再利用する場合です。このダイアログが別のダイアログによって開かれ、新規ダイアログ・ウィンドウで開かれる必要がある場合、「いいえ」を選択します。たとえば、このダイアログがモーダルで、親モーダル・ダイアログ・ウィンドウ内で開く場合です。

6. 変更内容を保存するには、保存をクリックします。

関連項目:

データベース・アプリケーションへのページの追加について

6.6.4.5 ダイアログ・ページでの「ダイアログを取り消す」動的アクションの生成

ダイアログ・ページに「取消」ボタンが含まれる場合は、そのボタンのクリックに基づいた動的アクションを生成し、そのTrueアクション・イベントを「ダイアログを取り消す」に設定する必要があります。この動的アクションは、ページ・テンプレート(apex.navigation.dialog.cancel)に含まれる取消のJavaScriptコールを使用して、ダイアログの取消を処理します。

関連項目:

動的アクションの管理

6.6.4.6 ダイアログ・ページでの「ダイアログを閉じる」ページ・プロセスの生成

「ダイアログを閉じる」ページ・プロセスを作成することによって、Oracle Application Expressでダイアログ・ページを閉じます。以前のリリースでは、このページ・プロセスは「ポップアップ・ウィンドウを閉じる」と呼ばれていました。このダイアログは、ページ・テンプレート(apex.navigation.dialog.close)に含まれるクローズのJavaScriptコールを使用して、ダイアログのクローズを処理します。ページ・プロセスは、親ページで参照することがあるダイアログ・ページ・アイテムの戻りもサポートしています。例を表示するには、サンプル・データベース・アプリケーションの任意のダイアログ・ページを編集します。

ヒント:

「ダイアログを閉じる」動的アクションでダイアログ・ページを閉じることもできます。動的アクションとプロセスの両方が、ダイアログ・ページ・アイテムの戻りをサポートしています。ページを送信する必要がある場合はページ・プロセスを使用し、ページを送信する必要がない場合は動的アクションを使用します。両方とも、最終的にはクローズのJavaScriptコールをコールします。または、ダイアログ・ページを閉じて、ブランチで指定したページにリダイレクトするページ・ブランチを作成できます。

関連項目:

- ページ・プロセスの理解

- サンプル・データベース・アプリケーションの理解

- ブランチを使用したナビゲーションの制御

6.6.4.7 ダイアログ・ページでのブランチングについて

ダイアログ・ページを開くには、ボタンまたはリンクを使用します。ダイアログ・ページでは、次のブランチング・オプションがサポートされています。

- ダイアログ・ページからダイアログ・ページへの場合。
1つのダイアログ・ページから別のダイアログ・ページに、ブランチできます。

- 両方のページは、「モーダル・ダイアログ」のような同じページ・モードで、ダイアログのChained属性は「はい」に設定されています。Chained属性を「はい」に設定すると、多くの内部Application Expressウィザードで表示されるチェーンまたはネスト・ダイアログがサポートされます。チェーンまたはネスト・ダイアログを使用すると、ダイアログ・ウィンドウを再度利用して各ページを表示できます。

- ダイアログ・ページから標準・ページの場合。

- ダイアログ・ページから標準・ページにブランチすると、ダイアログが閉じられ、ユーザーはブラウザ内の新しいページに移動します。新しいページは、親(または起動)ページ、もしくはアプリケーション内の別の標準ページです。

6.6.4.8 親ページでのリフレッシュ・アクションの処理

ダイアログ・ページで「ダイアログを閉じる」ページ・プロセスを生成した場合、新しい「ダイアログのクローズ」動的アクション・イベント・タイプを使用して、親ページにリフレッシュ・アクションを実装する必要があります。「値の設定」のTrueアクションを作成するとき、タイプ設定「ダイアログ戻りアイテム」を使用し、ダイアログの戻りアイテムに基づいて単一の値が設定されるようにできます。

例を表示するには、サンプル・データベース・アプリケーションの製品のページに移動します。製品のページで、「Create Product」ボタンにはダイアログを起動する動的アクションが関連付けられています。ダイアログを閉じると、「ダイアログのクローズ」動的アクションをトリガーします。定義するすべてのTrueアクションにこのタイプの動的アクションを使用できます。この例では、親ページのレポートをリフレッシュしてページを送信します。

ヒント:

親ページの部分ページ・リフレッシュを行う場合は、ダイアログを閉じるときの動的アクションを実装します(たとえば、レポート・ページおよびフォーム・ページのデータをモーダル・ダイアログ・フォームで編集し、閉じるときにのみレポートがリフレッシュされるようにする場合)。対照的に、マルチ・ステップのモーダル・ウィザードがある場合や、ダイアログを閉じるときに可能なターゲットページが複数ある場合は、ブランチ処理が最適な方法となります。

関連項目:

- 「サンプル・データベース・アプリケーションのインストールおよび実行」

- 動的アクションの管理

- サンプル・データベース・アプリケーションの理解

6.6.5 データベース・アプリケーション・ページのコピーについて

現在のアプリケーションまたは別のアプリケーションからページをコピーできます。コピー・プロセス中に、共有コンポーネントのコピーや、ターゲット・アプリケーションの共有コンポーネントへのマッピングを変更することもできます。

関連項目:

ページ・デザイナでのデータベース・アプリケーション・ページのコピーおよびレガシー・コンポーネント・ビューでのデータベース・アプリケーション・ページのコピー

6.6.6 ユーザー・インタフェース間のページのコピーについて

注意:

jQuery Mobileスマートフォン・ページへのデスクトップ・ページのコピー、またはデスクトップ・ページへのjQuery Mobileスマートフォン・ページのコピーはサポートしていません。

ページのコピー・ウィザードでは、ページを異なるユーザー・インタフェースにコピーできます。コピー・プロセス時に、ユーザーは新しいページのユーザー・インタフェースを選択できます。アプリケーションにデスクトップおよびモバイル・テーマが含まれる場合、両方のユーザー・インタフェース・オプションが表示されます。

jQuery Mobileスマートフォン・ページへのデスクトップ・ページのコピー、またはデスクトップ・ページへのjQuery Mobileスマートフォン・ページのコピーはサポートしていません。次のデスクトップ・ページをモバイル・ユーザー・インタフェースにコピーしようとすると、エラーが発生します。

- 対話モード・レポート

- Flashマップ

- Flashチャート

- ツリー・リージョン

6.6.7 データベース・アプリケーション・ページの削除について

ページを削除すると、対応する表、ブレッドクラムおよびリスト・エントリが削除されます。ロック解除されているか、自分がロックしたページのみを削除できます。

関連項目:

ページ・デザイナでのページの削除およびレガシー・コンポーネント・ビューでのページの削除

6.7 「検索」アイコンの使用

「検索」アイコンは懐中電灯の形をしており、アプリケーションのホームページ、レガシー・コンポーネント・ビュー、共有コンポーネント、アプリケーション定義の編集など、アプリケーション・ビルダーの多くのページに表示されます。

「検索」アイコンをクリックすると、アイテム、ページ、問合せ、表、PL/SQLコード、イメージを検索して、デバッグ・レポート、セッション・ステート、エラーを表示できます。

トピック:

- 「検索」アイコンの使用

- アイテムの検索

- ページの検索

- 問合せの検索

- 表の検索

- PL/SQLファインダの使用

- イメージの検索

6.7.1 「検索」アイコンの使用

「検索」アイコンを使用するには、次のステップを実行します。

1. 「検索」アイコンをクリックします。

「アイテム・ファインダ」が表示されます。

2. 次のいずれかのタブをクリックします。

- アイテム - 「アイテムの検索」を参照してください。

- ページ - 「ページの検索」を参照してください。

- 問合せ - 「問合せの検索」を参照してください。

- 表 - 「表の検索」を参照してください。

- PL/SQL - 「PL/SQLファインダの使用」を参照してください。

- イメージ - 「イメージの検索」を参照してください。

- デバッグ - 「デバッグ・レポートの表示」を参照してください。

- セッション - 「セッション・ステートの管理の理解」および「セッション・ページの使用」を参照してください。

- エラー - エラーの表示。

6.7.2 アイテムの検索

アプリケーション・ビルダーでは、アイテムはテキスト・フィールド、テキスト領域、パスワード、選択リスト、チェック・ボックスなどを示します。「アイテム・ファインダ」を使用すると、現在のアプリケーション内、またはワークスペースに関連付けられたスキーマ内のアイテムを検索できます。

アイテムを検索するには:

1. 「検索」アイコンをクリックします。

「アイテム・ファインダ」が表示されます。

検索バーはページの上部に表示され、次のコントロールが含まれています。

- 「検索列の選択」アイコン: 虫めがねに似ています。このアイコンをクリックして、検索を特定の列に絞り込みます。すべての列を検索するには、「すべての列」を選択します。

- テキスト領域: 大/小文字を区別しない検索基準(ワイルドカード文字を含む)を入力し、「実行」をクリックします。

- 「実行」ボタン: 検索を実行します。

- 「アクション」メニュー: アイコンをクリックすると、「アクション」メニューが表示されます。このメニューを使用して、対話モード・レポートをカスタマイズします。

2. 特定のアイテムを編集するには、該当するアイテムにナビゲートします。

関連項目:

ページ・レベル・アイテムの理解

6.7.3 ページの検索

ページは、アプリケーションの基本的な構成要素です。「ページ・ファインダ」を使用すると、現在のアプリケーション内、またはワークスペースに関連付けられたスキーマ内のページを検索できます。

ページを検索するには、次のステップを実行します。

1. 「検索」アイコンをクリックします。

2. 「ページ」タブをクリックします。

「ページ・ファインダ」が表示されます。検索バーはページの上部に表示され、次のコントロールが含まれています。

- 「検索列の選択」アイコン: 虫めがねに似ています。このアイコンをクリックして、検索を特定の列に絞り込みます。すべての列を検索するには、「すべての列」を選択します。

- テキスト領域: 大/小文字を区別しない検索基準(ワイルドカード文字を含む)を入力し、「実行」をクリックします。

- 「実行」ボタン: 検索を実行します。

- 「アクション」メニュー: アイコンをクリックすると、「アクション」メニューが表示されます。このメニューを使用して、対話モード・レポートをカスタマイズします。

3. アイテム・ページにリンクするには、ページ番号をクリックします。

6.7.4 問合せの検索

問合せファインダを使用すると、アプリケーション内、またはワークスペースに関連付けられたスキーマ内の問合せを検索できます。

問合せファインダを使用して問合せを検索するには、次のステップを実行します。

1. 「検索」アイコンをクリックします。

2. 「問合せ」タブをクリックします。

「問合せファインダ」が表示されます。検索バーはページの上部に表示され、次のコントロールが含まれています。

- 「検索列の選択」アイコン: 虫めがねに似ています。このアイコンをクリックして、検索を特定の列に絞り込みます。すべての列を検索するには、「すべての列」を選択します。

- テキスト領域: 大/小文字を区別しない検索基準(ワイルドカード文字を含む)を入力し、「実行」をクリックします。

- 「実行」ボタン: 検索を実行します。

- 「アクション」メニュー: アイコンをクリックすると、「アクション」メニューが表示されます。このメニューを使用して、対話モード・レポートをカスタマイズします。「アクション」メニューについてを参照してください。

3. アイテム・ページにリンクするには、ページ番号をクリックします。

6.7.5 表の検索

「表ファインダ」を使用すると、ワークスペースに関連付けられたスキーマ内の表を表示できます。

現在のスキーマに関連付けられた表を表示するには、次のステップを実行します。

1. 「検索」アイコンをクリックします。

2. 「表」タブをクリックします。

「表ファインダ」が表示されます。検索バーはページの上部に表示され、次のコントロールが含まれています。

- 「検索列の選択」アイコン: 虫めがねに似ています。このアイコンをクリックして、検索を特定の列に絞り込みます。すべての列を検索するには、「すべての列」を選択します。

- テキスト領域: 大/小文字を区別しない検索基準(ワイルドカード文字を含む)を入力し、「実行」をクリックします。

- 「実行」ボタン: 検索を実行します。

- 「アクション」メニュー: アイコンをクリックすると、「アクション」メニューが表示されます。このメニューを使用して、対話モード・レポートをカスタマイズします。

3. 表名を選択します。

表定義が表示されます。

このレポートには列名、データ型、長さ、精度およびスケールが表示され、ページ下部には表を再作成するために必要なSQLが表示されます。

関連項目:

Oracle Application Express SQLワークショップ・ガイドの「表の管理」

6.7.6 PL/SQLファインダの使用

PL/SQLファインダを使用すると、ワークスペースに関連付けられたスキーマ内の、各オブジェクトに関連付けられたストアド・プロシージャ、ファンクションおよびパッケージに関する詳細を検索して表示できます。

現在のスキーマのPL/SQLコードを検索するには、次のステップを実行します。

1. 「検索」アイコンをクリックします。

2. 「PL/SQL」タブをクリックします。

PL/SQLファインダが表示されます。検索バーはページの上部に表示され、次のコントロールが含まれています。

- 「検索列の選択」アイコン: 虫めがねに似ています。このアイコンをクリックして、検索を特定の列に絞り込みます。すべての列を検索するには、「すべての列」を選択します。

- テキスト領域: 大/小文字を区別しない検索基準(ワイルドカード文字を含む)を入力し、「実行」をクリックします。

- 「実行」ボタン: 検索を実行します。

- 「アクション」メニュー: アイコンをクリックすると、「アクション」メニューが表示されます。このメニューを使用して、対話モード・レポートをカスタマイズします。

3. 詳細を表示するには、プロシージャ、ファンクションまたはパッケージの名前を選択します。

プロシージャ、パッケージまたはファンクションの名前が、所有者、ソース名、ソース・タイプ、戻り型、引数名、データ型およびIN/OUTパラメータなどの情報とともに表示されます。

関連項目:

『Oracle Application Express SQLワークショップ・ガイド』の「オブジェクト・ブラウザを使用したデータベース・オブジェクトの管理」

6.7.7 イメージの検索

イメージ・ファインダを使用して、カレント・アプリケーションに使用可能なイメージを識別できます。

使用可能なイメージを表示するには、次のステップを実行します。

1. 「検索」アイコンをクリックします。

2. 「イメージ」タブをクリックします。

イメージ・ファインダが表示されます。

3. 「表示」から、表示するイメージのタイプを選択します。オプションは次のとおりです。

- 標準イメージ

- ワークスペース・イメージ

- アプリケーション・イメージ

関連項目:

『Oracle Application Express SQLワークショップ・ガイド』の「オブジェクト・ブラウザを使用したデータベース・オブジェクトの管理」

6.8 ページ・グループの作成

ページをページ・グループとして編成すると、アプリケーション内のページに簡単にアクセスできるようになります。ページ・グループを使用するには、グループを作成してからページをグループに割り当てます。

ヒント:

ページ・グループには、開発者がアプリケーション内のページを編成する場合に有効な機能以外の機能はありません。

トピック:

- ページ・グループの表示

- ページ・グループの作成

- ページ・グループ定義の編集

- ページのページ・グループへの割当て

- ページ・グループごとのページの表示

- ページ・グループの削除

6.8.1 ページ・グループの表示

ページ・グループ・ページにアクセスするには、次のステップを実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「ユーティリティ」アイコンをクリックします。

4. 「ページ固有のユーティリティ」から、「ページ・グループ」をクリックします。

ページ・グループ・ページが表示されます。

検索バーがページの上部に表示されます。使用可能なコントロールは次のとおりです。

- 検索列の選択: 虫めがねに似ています。このアイコンをクリックして、検索を絞り込みます。すべての列を検索するには、「すべての列」を選択します。

- テキスト領域: 名前でページ・グループを検索するための大/小文字を区別しない検索基準(ワイルドカード文字を含む)を入力し、「実行」をクリックします。

- 「実行」ボタン: 検索を実行したり、フィルタを適用します。

- 「アイコンの表示」: 各グループを大きいアイコンとして表示します。グループを編集するには、該当するアイコンをクリックします。

- レポートの表示: 各グループをレポート内の1行として表示します。グループを編集するには、名前をクリックします。

- アクション・メニュー: このアクション・メニューを使用して、レポート・ビューをカスタマイズします。

5. グループに関連付けられたページを表示するには、「ページ・グループごとのページ」をクリックします。

関連項目:

「アクション」メニューについて

6.8.2 ページ・グループの作成

ページ・グループを作成するには、次のようにします。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「ユーティリティ」アイコンをクリックします。

4. 「ページ固有のユーティリティ」から、「ページ・グループ」をクリックします。

5. ページ・グループ・ページで、「作成」をクリックします。

6. 名前および説明(オプション)を入力して、「作成」をクリックします。

6.8.3 ページ・グループ定義の編集

ページ・グループの作成時に、名前と説明を指定します。

ページ・グループ定義を編集するには、次のステップを実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「ユーティリティ」アイコンをクリックします。

4. 「ページ固有のユーティリティ」から、「ページ・グループ」をクリックします。

5. ページ・グループを選択します。

6. ページ・グループ・ページで名前または説明を編集し、「変更の適用」をクリックします。

7. 次のページ・グループ定義に移動するには、「前へ」ボタン(<)と「次へ」ボタン(>)をクリックして、前のステップを繰り返します。

6.8.4 ページのページ・グループへの割当て

ページをグループに割り当てるには、次のステップを実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「ユーティリティ」アイコンをクリックします。

4. 「ページ固有のユーティリティ」から、「ページ・グループ」をクリックします。

5. 「ページ割当て」タブをクリックします。

ページ割当てページが表示されます。

6. ページ番号をクリックします。

ページ属性ページが表示されます。

7. 「名前」リージョンを探し、「グループ」リストからグループを選択します。

8. 「変更の適用」をクリックします。

6.8.5 ページ・グループごとのページの表示

ページ・グループごとにページを確認するには、次のステップを実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「ユーティリティ」アイコンをクリックします。

4. 「ページ固有のユーティリティ」から、「ページ・グループ」をクリックします。

5. 「ページ・グループごとのページ」タブをクリックします。

ページ・グループごとのページ・ページが表示されます。ページ名をクリックするとページが表示されます。

6. グループからページを削除するには:

a. ページ番号をクリックします。
ページ属性ページが表示されます。

b. 「名前」、「グループ」で「- グループが割り当てられていない -」を選択します。

c. 「変更の適用」をクリックします。

7. 新しいグループを作成するには、「作成」をクリックして、画面に表示されるステップに従います。

6.8.6 ページ・グループの削除

ページ・グループを削除するには、次のようにします。

1. 削除するグループのすべてのページを削除します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. 「ページ固有のユーティリティ」から、「ページ・グループ」をクリックします。

d. 「ページ・グループごとのページ」タブをクリックします。

e. ページ番号をクリックします。
ページ属性ページが表示されます。

f. 「名前」、「グループ」で「- グループが割り当てられていない -」を選択します。

g. 「変更の適用」をクリックします。

2. グループのすべてのページを削除したら、「ページ・グループ」タブをクリックします。

3. 削除するグループを選択します。

4. 「削除」をクリックします。
「確認」ページが表示されます。

5. リクエストを確認します。

6.9 ページのロックおよびロック解除

アプリケーション内のページをロックして、アプリケーション開発中の競合を回避します。ページをロックすると、他の開発者がページを編集できなくなります。

トピック:

- ページがロックされているかどうかの判別

- ページのロック

- ページのロック解除

6.9.1 ページがロックされているかどうかの判別

「ロック」アイコンは、ページが現在ロックされているかどうかを示します。ページのロックが解除されている場合、アイコンは鍵が開いた南京錠として表示されます。ページがロックされている場合、アイコンは鍵が掛かった南京錠として表示されます。「ロック」アイコンは、アプリケーションのホームページとページに表示されます。

アプリケーションのホーム・ページで「ロック」アイコンを表示するには、「レポートの表示」アイコンをクリックします。レポートが表示されます。「ロック」アイコンはページの右側に表示されます。

6.9.2 ページのロック

開発者は、アプリケーションのホームページ、ページ・ロック・ページ、ページ・デザイナおよびコンポーネント・ビューでページをロックできます。

トピック:

- アプリケーションのホームページからのページのロック

- ページ・ロック・ページからのページのロック

- ページ・デザイナでのページのロック

- レガシー・コンポーネント・ビューでのページのロック

6.9.2.1 アプリケーションのホームページからのページのロック

アプリケーションのホームページからページをロックするには、次のステップを実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 検索バーで、「レポートの表示」または「詳細の表示」アイコンをクリックします。

4. 「ロック」アイコンをクリックします。

5. 「コメント」フィールドにコメントを入力します。

6. 「ページのロック」をクリックします。

6.9.2.2 ページ・ロック・ページからのページのロック

ページ・ロック・ページからページをロックするには、次のステップを実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「ユーティリティ」アイコンをクリックします。

4. 「ページ固有のユーティリティ」リストで、「クロス・ページ・ユーティリティ」をクリックします。

5. 「ページ・ロック」をクリックします。

6. 該当するページを選択して、「ロックを選択済」をクリックします。

7. 「コメント」フィールドにコメントを入力します。

8. 「ページのロック」をクリックします。

6.9.2.3 ページ・デザイナでのページのロック

ページ・デザイナ・ツールバーの「ページ・ロック」ボタンは、ページがロックされているかどうかを示します。ページのロックが解除されている場合、「ページ・ロック」ボタンは鍵が開いた南京錠として表示されます。

ページ・デザイナでページをロックするには、次のステップを実行します。

1. ページ・デザイナで適切なページにナビゲートします。

2. ページ・デザイナ・ツールバーで、「ページがロック解除されました」ボタンをクリックします。

3. 「コメント」フィールドにコメントを入力します。

4. 「ロック」をクリックします。

ページのロックが解除されると、「ページ・ロック」ボタンは鍵が掛かった南京錠として表示されます。

関連項目:

「ページ・デザイナでのページの表示」

6.9.2.4 レガシー・コンポーネント・ビューでのページのロック

コンポーネント・ビューでページをロックするには、次のステップを実行します。

1. コンポーネント・ビューで適切なページにナビゲートします。

2. 「ユーティリティ」をクリックして「ロック」をクリックします。

3. 「コメント」フィールドにコメントを入力します。

4. 「ページのロック」をクリックします。

関連項目:

「レガシー・コンポーネント・ビューでのページの表示」

6.9.3 ページのロック解除

ページをロックした開発者のみが、そのページのロックを解除できます。ただし、管理権限を持つ開発者は、他の開発者がロックしたページのロックを解除できます。

ヒント:

既存のページのロックに関する情報を表示するには、ロックの詳細ページにナビゲートして、「ロック履歴」リージョンを展開します。

トピック:

- ユーティリティからのページのロック解除

- アプリケーションのホームページからのページのロック解除

- ページ・デザイナでのページのロック解除

- レガシー・コンポーネント・ビューでのページのロック解除

- ワークスペース管理者としてのページのロック解除

6.9.3.1 ユーティリティからのページのロック解除

ページ定義からページのロックを解除するには、次のステップを実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「ユーティリティ」アイコンをクリックします。

4. 「ページ固有のユーティリティ」リストで、「クロス・ページ・ユーティリティ」をクリックします。

5. 「ページ・ロック」をクリックします。

6. 該当するページを選択します。

7. 「チェックした項目のロック解除」をクリックします。

6.9.3.2 アプリケーションのホームページからのページのロック解除

アプリケーションのホームページからページのロックを解除するには、次のステップを実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 検索バーで、「レポートの表示」アイコンをクリックします。

4. 「ロック」アイコンをクリックします。

ロックの詳細ページが表示されます。

5. 「ロック解除」をクリックします。

6.9.3.3 ページ・デザイナでのページのロック解除

ページ・デザイナ・ツールバーの「ページ・ロック」ボタンは、ページがロックされているかどうかを示します。ページがロックされている場合、「ページ・ロック」ボタンは鍵が掛かった南京錠として表示されます。鍵が掛かった「ページ・ロック」ボタンにカーソルをあわせると、ロックした人物を示すツールチップが表示されます。

ページ・デザイナでページのロックを解除するには、次のステップを実行します。

1. ページ・デザイナで適切なページにナビゲートします。

ページがロックされている場合、「ページ・ロック」ボタンは鍵が掛かった南京錠として表示されます。

2. ページ・デザイナ・ツールバーで、「ロックしたページ」ボタンをクリックします。

別のユーザーがページをロックした場合、「ロック」ボタンは赤く表示されます。別のユーザーがロックしたページのロックを解除することはできません。

3. 「ロック解除」をクリックします。

ページのロックが解除されると、「ページ・ロック」ボタンは鍵が開いた南京錠として表示されます。

「ページ・デザイナでのページの表示」

6.9.3.4 レガシー・コンポーネント・ビューでのページのロック解除

コンポーネント・ビューでページのロックを解除するには、次のステップを実行します。

1. レガシー・コンポーネント・ビューで適切なページにナビゲートします。

2. 「ユーティリティ」をクリックして、「ロック解除」を選択します。

関連項目:

レガシー・コンポーネント・ビューでのページの表示を参照してください。

6.9.3.5 ワークスペース管理者としてのページのロック解除

ワークスペース管理者としてページのロックを解除するには、次のステップを実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「ユーティリティ」アイコンをクリックします。

4. 「ページ固有のユーティリティ」リストで、「クロス・ページ・ユーティリティ」をクリックします。

5. 「ページ・ロック」をクリックします。

6. 「ロック管理」をクリックします。

7. 該当するページを選択します。

8. 「ページのロック解除」をクリックします。

6.10 開発者コメントの追加

開発者は、「開発者のコメント」、「バグ」または「To Do」ボタンを使用して、アプリケーション、ページまたはページ・グループにコメントを追加できます。開発者コメントは、アプリケーションの変更の通知、問題の報告、または開発者の提案の記録などに使用できます。

トピック:

- 「開発者のコメント」、「バグ」または「To Do」ボタン

- アプリケーションへの開発者コメントの追加

- 開発者コメントの表示と編集

- 開発者コメントの削除

- 共有コンポーネントから開発者コメントへのアクセス

- 開発者コメントのカレンダの表示

関連項目:

データベース・アプリケーション・コメントの追加

6.10.1 「開発者のコメント」、「バグ」または「To Do」ボタン

「開発者のコメント」、「バグ」または「To Do」ボタンは、小さい吹出しの形をしています。このボタンは、特定のアプリケーションまたはアプリケーション・ページに関連するアプリケーション・ビルダー内のほとんどのページに表示されます。

6.10.2 アプリケーションへの開発者コメントの追加

アプリケーション、ページ、またはページ・グループに開発者のコメントを追加できます。

開発者コメントを追加するには、次のようにします。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「開発者のコメント」、「バグ」または「To Do」ボタンをクリックします。

4. 「タイプ」リストから、「開発者のコメント」を選択します。

5. 「コメント」に、テキストを最大4000文字まで入力します。

6. 「作成」をクリックします。

6.10.3 開発者コメントの表示と編集

開発者コメントを編集するには、次のようにします。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「開発者のコメント」、「バグ」または「To Do」ボタンをクリックします。

4. 「コメントの表示」をクリックします。
開発者のコメント・ページが表示されます。

5. コメントを編集するには、「編集」アイコンをクリックします。
「コメントの編集」ページが表示されます。

a. 「コメント」に、テキストを最大4000文字まで入力します。

b. 「変更の適用」をクリックします。

ヒント:

開発者コメントは、共有コンポーネント・ページでも表示および編集できます。共有コンポーネント・ページに移動し、「タスク」リージョンの「開発者のコメント」をクリックします。共有コンポーネントから開発者コメントへのアクセスを参照してください。

6.10.4 開発者コメントの削除

特定の開発者コメントを削除したり、複数のコメントを一度に削除することができます。

トピック:

- 特定の開発者コメントの削除

- 複数の開発者コメントの削除

6.10.4.1 特定の開発者コメントの削除

開発者コメントを削除するには、次のようにします。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「開発者のコメント」、「バグ」または「To Do」アイコンをクリックします。

4. 「コメントの表示」をクリックします。

開発者のコメント・ページが表示されます。

5. 削除するコメントを探します。

6. 「編集」アイコンをクリックします。

「コメントの編集」ページが表示されます。

7. 「削除」をクリックします。

6.10.4.2 複数の開発者コメントの削除

複数の開発者コメントを削除するには、次のようにします。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「開発者のコメント」、「バグ」または「To Do」アイコンをクリックします。

4. 「コメントの表示」をクリックします。

5. 「コメントの削除」をクリックします。

6. 次のアクションの1つを選択します。

- すべてのコメントの削除

- 開発者別に作成されたコメントの削除

- 日付別のコメントの削除

7. 画面に表示されるステップに従います。

6.10.5 共有コンポーネントから開発者コメントへのアクセス

共有コンポーネントから開発者コメント・レポートにアクセスするには、次のステップを実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「タスク」で、「開発者のコメント」をクリックします。

開発者コメント・レポートが表示されます。

ナビゲーション・バーはページの上部に表示され、次のコントロールが含まれています。

- 検索列の選択: 虫めがねに似ています。このアイコンをクリックして、検索を特定の列のみに絞ります。すべての列を検索するには、「すべての列」を選択します。

- テキスト領域: 大/小文字を区別しない検索基準(ワイルドカード文字を含む)を入力し、「実行」をクリックします。

- 「実行」ボタン: 検索を実行します。

- アクション・メニュー: このアクション・メニューを使用して、レポート・ビューをカスタマイズします。「アクション」メニューについてを参照してください。

関連項目:

開発者コメントの表示と編集および開発者コメントの削除

6.10.6 開発者コメントのカレンダの表示

「開発者コメントのカレンダ」にアクセスするには、次のステップを実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「タスク」で、「開発者のコメント」をクリックします。

開発者のコメント・ページが表示されます。

5. 「開発者コメントのカレンダ」をクリックします。

開発者コメントのカレンダ・ページが表示されます。

6. 「前へ」、「今日」および「次へ」ボタンを使用してナビゲートします。

6.11 データベース・アプリケーション・コメントの追加

開発者は、アプリケーション・コメント・ページで、データベース・アプリケーション全体に関するコメントを追加できます。アプリケーションの説明またはアプリケーションで作業した開発者の追跡ができます。

アプリケーション・コメントを作成するには、次のステップを実行します。

1. 「ワークスペース」ホームページにナビゲートします。

2. 「アプリケーション・ビルダー」アイコンをクリックします。

3. アプリケーションを選択します。

4. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

共有コンポーネント・ページが表示されます。

5. 「タスク」で、「アプリケーション・コメントの編集」をクリックします。

アプリケーション・コメント・ページが表示されます。

6. 「コメント」フィールドにコメントを入力して、「変更の適用」をクリックします。

6.12 アプリケーション・グループの管理

開発者は、アプリケーションをアプリケーション・グループに割り当てることにより、アプリケーションを整理できます。アプリケーション・グループを使用するには、最初にグループを作成し、その後、アプリケーションを割り当てます。

トピック:

- データベース・アプリケーション・グループの表示

- データベース・アプリケーション・グループの作成

- アプリケーション・グループへのデータベース・アプリケーションの割当て

- アプリケーション・グループからのデータベース・アプリケーションの削除

- データベース・アプリケーション・グループの削除

関連項目:

ページ固有のユーティリティへのアクセス

6.12.1 データベース・アプリケーション・グループの表示

データベース・アプリケーション・グループを表示するには、次のステップを実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. 「ワークスペース・ユーティリティ」をクリックします。

3. 「アプリケーション・グループ」をクリックします。

アプリケーション・グループ・ページが表示されます。

検索バーがページの上部に表示されます。使用可能なコントロールは次のとおりです。

- 検索列の選択: 虫めがねに似ています。このアイコンをクリックして、検索を絞り込みます。すべての列を検索するには、「すべての列」を選択します。

- テキスト領域: 名前でグループを検索するための大/小文字を区別しない検索基準(ワイルドカード文字を含む)を入力し、「実行」をクリックします。

- 「実行」ボタン: 検索を実行したり、フィルタを適用します。

- アイコンの表示(デフォルト): 各グループを大きいアイコンとして表示します。グループを編集するには、該当するアイコンをクリックします。

- レポートの表示: 各グループをレポート内の1行として表示します。グループを編集するには、名前をクリックします。

4. グループに関連付けられたアプリケーションを表示するには、グループ名をクリックします。

6.12.2 データベース・アプリケーション・グループの作成

データベース・アプリケーション・グループを作成するには、次のステップを実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. 「ワークスペース・ユーティリティ」をクリックします。

3. 「アプリケーション・グループ」をクリックします。

4. アプリケーション・グループ・ページで、「作成」をクリックします。

5. 名前および説明(オプション)を入力して、「作成」をクリックします。

6.12.3 アプリケーション・グループへのデータベース・アプリケーションの割当て

データベース・アプリケーションをグループに割り当てるには、次のステップを実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. 「ワークスペース・ユーティリティ」をクリックします。

3. 「アプリケーション・グループ」をクリックします。

4. 「タスク」リストで「未割当ての管理」をクリックします。

アプリケーション・グループ割当ての管理ページが表示されます。

5. 「新規グループ」リストから、グループを選択します。

6. 割り当てるアプリケーションを選択して、「チェックした項目の割当て」をクリックします。

ヒント:

アプリケーション・グループへのアプリケーションの割当ては、アプリケーション定義を編集して行うこともできます。グループは、「アプリケーション・グループ」リストから選択します。アプリケーション属性の編集を参照してください。

6.12.4 アプリケーション・グループからのデータベース・アプリケーションの削除

アプリケーション・グループからアプリケーションを削除するには、次のステップを実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. 「ワークスペース・ユーティリティ」をクリックします。

3. 「アプリケーション・グループ」をクリックします。

4. 「タスク」リストで「割当ての管理」をクリックします。
アプリケーション・グループ割当ての管理ページが表示されます。

5. 「新規グループ」リストから、「- 割当て解除 -」を選択します。

6. 割当てを解除するページを選択して、「チェックした項目の割当て」をクリックします。

ヒント:

アプリケーション・グループからのアプリケーションの削除は、アプリケーション定義を編集して行うこともできます。「アプリケーション・グループ」リストから「未割当て」を選択します。アプリケーション属性の編集を参照してください。

6.12.5 データベース・アプリケーション・グループの削除

アプリケーション・グループを削除するには、次の手順を実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. 「ワークスペース・ユーティリティ」をクリックします。

3. 「アプリケーション・グループ」をクリックします。

4. グループ内のすべてのアプリケーションを「未割当て」に割り当てます。

a. 「タスク」リストで「割当ての管理」をクリックします。

b. 「新規グループ」リストから、「- 割当て解除 -」を選択します。

c. 割当てを解除するページを選択して、「チェックした項目の割当て」をクリックします。

5. アプリケーション・グループ・ページに戻ります。

6. 削除するアプリケーション・グループを選択します。

7. アプリケーション・グループ・ページで、「削除」をクリックします

「確認」ページが表示されます。

8. リクエストを確認します。

6.13 アプリケーション・ユーティリティの使用

ユーティリティ・ページには、開発者が様々な観点からアプリケーションを表示できるサマリーとレポートへのリンクがあります。

トピック:

- ユーティリティ・ページへのアクセス

- アプリケーション・ダッシュボードの表示

- 新しいコンポーネントを組み込むためのアプリケーションのアップグレード

- 「最近更新されたページ」レポートの表示

- 「変更履歴」レポートの表示

- 「データベース・オブジェクトの依存性」レポートの使用

- Application Expressビューへのアクセス

- ページ固有のユーティリティへのアクセス

- クロス・ページ・ユーティリティへのアクセス

- アプリケーション間レポートへのアクセス

- 対話モード・レポート・ユーティリティの使用

関連項目:

APEX_ACTIVITY_LOGを使用したカスタム・アクティビティ・レポートの作成

6.13.1 ユーティリティ・ページへのアクセス

アプリケーション・ビルダーのユーティリティ・ページにアクセスするには、次のステップを実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「ユーティリティ」アイコンをクリックします。

ユーティリティ・ページには、次のツールおよびレポートへのリンクがあります。

- アプリケーション・ダッシュボード。アプリケーション・コンポーネントと属性のサマリーが表示されます。
アプリケーション・ダッシュボードの表示を参照してください。

- アドバイザ。プログラミング・エラーのチェック、セキュリティ問題、品質保証およびその他のベスト・プラクティスなど、アプリケーションに対する様々なチェックを実行します。
アプリケーション整合性のチェックのためのアドバイザの実行を参照してください。

- アプリケーションのアップグレード。現在のアプリケーションを新規リリースにアップグレードします。アップグレードを受けられるコンポーネントを確認して、最新の機能を含めます。
アプリケーションのアップグレードの実行を参照してください。

- 最近更新されたページ。このアプリケーションに対して行われたページ更新履歴を表示します。
「最近更新されたページ」レポートの表示を参照してください。

- 属性ディクショナリ。選択したページのアイテムおよび列のユーザー・インタフェースのデフォルト値を管理します。
属性ディクショナリの使用を参照してください。

- 変更履歴。このアプリケーションで行われたコンポーネント更新のレポートを表示します。
「変更履歴」レポートの表示を参照してください。

- データベース・オブジェクトの依存性。このアプリケーションによって参照されたデータベース・オブジェクトのレポートを表示します。
「データベース・オブジェクトの依存性」レポートの使用を参照してください。

- デバッグ・メッセージ。このアプリケーションによって生成されたデバッグ・メッセージを確認します。
アプリケーションのデバッグを参照してください。

- Application Expressビュー。Application Expressメタデータに対して様々なビューを問い合せます。
「Application Expressビューへのアクセス」を参照してください。

- エクスポート・リポジトリ。アプリケーションのエクスポート履歴を表示します。
エクスポート・リポジトリへのアクセスを参照してください。

関連項目:

ページ固有のユーティリティへのアクセス

6.13.2 アプリケーション・ダッシュボードの表示

「アプリケーション・ダッシュボード」には、アプリケーション・コンポーネントと属性の詳細が表示されます。

アプリケーション・ダッシュボードを表示するには、次のステップを実行します。

1. 「ワークスペース」ホームページにナビゲートします。

2. 「アプリケーション・ビルダー」アイコンをクリックします。

3. アプリケーションを選択します。

アプリケーションのホームページが表示されます。

4. 「ユーティリティ」をクリックします。

5. 「アプリケーション・ダッシュボード」をクリックします。

「アプリケーション・ダッシュボード」が表示され、次のセクションが表示されます。

- アプリケーション概要: カレント・アプリケーションに関する詳細情報および統計(ID、名前、別名、解析対象スキーマ、関連付けられているグループ、ページ数、関連付けられているテーマなど)が表示されます。

- セキュリティ: 現在の認証スキーム、パブリック・ページと非パブリック・ページの数およびカレント・アプリケーション内で使用される認可スキームの数が表示されます。

- テンプレート: カレント・アプリケーション内で使用されるテンプレートのレポートへのリンクが表示されます。

- タイプ別の表示: コンポーネントのカウント(レポートとフォームのタイプ、動的HTMLなど)が表示されます

- アプリケーション・コンポーネント: アプリケーション・レベルのコントロールとロジックのレポート(リスト、ショートカット、LOV、タブ、アプリケーションの計算、アプリケーション・アイテム、プラグインおよびアプリケーション・プロセスなど)へのリンクが表示されます。

- ページ・コンポーネント: リージョン、アイテム、ブランチ、計算、検証、動的アクション、クラシック・レポートの列、対話モード・レポートの列およびボタンを含むページレベルのコントロールおよびロジックのレポートへのリンクが含まれています。

6. 特定のレポートを表示するには、コンポーネント・タイプまたはテンプレートの右にある数字をクリックします。

関連項目:

問題を引き起こす可能性のあるパスワード・アイテムの識別

6.13.3 新しいコンポーネントを組み込むためのアプリケーションのアップグレード

開発者は、現在のリリースで使用可能な新しいコンポーネントが組み込まれるように既存のアプリケーションをアップグレードできます。

トピック:

- 新しいコンポーネントを組み込むためのアップグレードについて

- アプリケーションのアップグレードの実行

6.13.3.1 新しいコンポーネントを組み込むためのアップグレードについて

ユーティリティ・ページの「アプリケーションのアップグレード」を使用して、次のコンポーネントをアップグレードします。

- AnyChartチャートをOracle JETチャートにアップグレードします。

- 「はい」および「いいえ」ラジオ・ボタンおよび選択リストをスイッチにアップグレードします。

- 表形式フォームを対話グリッドにアップグレードします。
次の属性は移行されません。

- デフォルトの列のソート順序と方向

- データが見つからなかった場合のメッセージ

- データがさらに見つかった場合のメッセージ

- 行カウント最大値

関連項目:

アプリケーションのアップグレードの実行

6.13.3.2 アプリケーションのアップグレードの実行

既存のアプリケーションをアップグレードするには、次のステップを実行します。

1. 「ワークスペース」ホームページにナビゲートします。

2. 「アプリケーション・ビルダー」アイコンをクリックします。

3. アプリケーションを選択します。

アプリケーションのホームページが表示されます。

4. 「ユーティリティ」をクリックします。

5. 「アプリケーションのアップグレード」をクリックします。

6. 画面に表示されるステップに従います。

関連項目:

新しいコンポーネントを組み込むためのアップグレードについて

6.13.4 「最近更新されたページ」レポートの表示

「最近更新されたページ」レポートには、現在のユーザーによって最近更新されたページのレポートが表示されます。

「最近更新されたページ」レポートを表示するには、次のステップを実行します。

1. 「ワークスペース」ホームページにナビゲートします。

2. 「アプリケーション・ビルダー」アイコンをクリックします。

3. アプリケーションを選択します。

アプリケーションのホームページが表示されます。

4. 「ユーティリティ」をクリックします。

5. 「最近更新されたページ」をクリックします。

検索バーがページの上部に表示されます。

6.13.5 「変更履歴」レポートの表示

「変更履歴」レポートには、カレント・アプリケーションに対する編集のサマリー・レポートが開発者、コンポーネント・タイプおよびページ番号別に表示されます。

「変更履歴」レポートを表示するには、次のステップを実行します。

1. 「ワークスペース」ホームページにナビゲートします。

2. 「アプリケーション・ビルダー」アイコンをクリックします。

3. アプリケーションを選択します。

アプリケーションのホームページが表示されます。

4. 「ユーティリティ」をクリックします。

5. 「変更履歴」をクリックします。

6.13.6 「データベース・オブジェクトの依存性」レポートの使用

「データベース・オブジェクトの依存性」レポートは、カレント・アプリケーションで参照されるデータベース・オブジェクトを識別します。アプリケーションのデプロイ時に移動するオブジェクトを判別するには、このレポートを確認します。

データベース・オブジェクトの依存性レポートを表示するには、次のステップを実行します。

1. 「ワークスペース」ホームページにナビゲートします。

2. 「アプリケーション・ビルダー」アイコンをクリックします。

3. アプリケーションを選択します。

アプリケーションのホームページが表示されます。

4. 「ユーティリティ」をクリックします。

5. 「データベース・オブジェクトの依存性」をクリックします。

データベース・オブジェクトの依存性ページが表示されます。

6. 「依存性の計算」をクリックします。

ヒント:

アプリケーションのサイズや複雑性に応じて、レポートの表示に時間がかかる場合があります。

「データベース・オブジェクトの依存性」レポートが表示されます。

6.13.7 Application Expressビューへのアクセス

Application Expressビューは、アプリケーションのメタデータを公開するデータ・ディクショナリ・ビューです。Application Expressビューでは、ビューを表示するだけでなく、ビューに含まれているデータを表示することもできます。

「Application Expressビュー」へアクセスするには、次の手順を実行します。

1. 「ワークスペース」ホームページにナビゲートします。

2. 「アプリケーション・ビルダー」アイコンをクリックします。

3. アプリケーションを選択します。

アプリケーションのホームページが表示されます。

4. 「ユーティリティ」をクリックします。

5. 「Application Expressビュー」をクリックします。

Application Expressビュー・ページが表示されます。

検索バーがページの上部に表示されます。使用可能なコントロールは次のとおりです。

- 検索列の選択: 虫めがねに似ています。このアイコンをクリックして、検索を絞り込みます。すべての列を検索するには、「すべての列」を選択します。

- テキスト領域: 名前でビューを検索するための大/小文字を区別しない検索基準(ワイルドカード文字を含む)を入力し、「実行」をクリックします。

- 「実行」ボタン: 検索を実行したり、フィルタを適用します。

- アイコンの表示: 各ビューを大きいアイコンとして表示します。ビューにアクセスするには、適切なアイコンをクリックします。

- レポートの表示: 各ビューをレポート内の1行として表示します。ビューにアクセスするには、名前をクリックします。

- アクション・メニュー: このアクション・メニューを使用して、レポート・ビューをカスタマイズします。「アクション」メニューについてを参照してください。

6. ビューを選択します。

ビュー内のデータを表示するには、「列の選択」タブで列を選択し、「結果」ボタンをクリックします。

「結果」タブで、「問合せ」リージョンを拡張して、実行された問合せを表示します。この問合せをコピーしてSQLコマンドまたはSQL Developerで再利用できます。

6.13.8 ページ固有のユーティリティへのアクセス

「ページ固有のユーティリティ」ページへアクセスするには、次の手順を実行します。

1. 「ワークスペース」ホームページにナビゲートします。

2. 「アプリケーション・ビルダー」アイコンをクリックします。

アプリケーション・ビルダーのホームページが表示されます。

3. アプリケーションを選択します。

アプリケーションのホームページが表示されます。

4. 「ユーティリティ」をクリックします。

5. 「ページ固有のユーティリティ」で、次のいずれかを選択します。

- クロス・ページ・ユーティリティ

- ページ・グループ

- リージョン・ユーティリティ

- ボタン・ユーティリティ

- アイテム・ユーティリティ

- 計算ユーティリティ

- 検証ユーティリティ

- プロセス・ユーティリティ

- 動的アクション・ユーティリティ

- ブランチ・ユーティリティ

関連項目:

「クロス・ページ・ユーティリティへのアクセス」

6.13.9 クロス・ページ・ユーティリティへのアクセス

クロス・ページ・ユーティリティ・ページにアクセスするには、次のステップを実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「ユーティリティ」をクリックします。

4. 「ページ固有のユーティリティ」で、「クロス・ページ・ユーティリティ」をクリックします。

クロス・ページ・ユーティリティ・ページでは、次のツールおよびレポートにアクセスできます。

- すべてのページのグリッド編集このレポートを使用して、ページ名、別名、タイトル、ページ・テンプレートおよびセキュリティ・オプションを編集します。特定のページにリンクするには、ページ番号の横の「編集」アイコンをクリックします。変更を保存するには、「変更の適用」をクリックします。

- 複数のページの削除。一度に複数のページを削除します。

- ページ属性。ページ名、ページ・タイトル、定義されたグループ、コンポーネントやコントロールのタイプおよび数、アプリケーション・ロジックなど、現在のアプリケーション内のすべてのページの詳細のレポートを表示します。レポートをカスタマイズするには、ページ上部にある検索バーを使用します。特定のページにリンクするには、ページ番号をクリックします。

- ページ・ロック。アプリケーション開発中に競合が発生しないようにするには、「ページ・ロック」を使用します。ページをロックすると、他の開発者がページを編集できなくなります。「」および「」を参照してください

関連項目:

- ページのロックおよびロック解除

- 「複数のページの削除」

- アプリケーション・ユーティリティの使用

6.13.10 アプリケーション間レポートへのアクセス

現在のワークスペースで複数のアプリケーションの情報を表示および編集するには、アプリケーション間レポート・ページ上のリンクを使用します。ワークスペース・ユーティリティ・ページからアプリケーション間レポートにアクセスします。

アプリケーション間レポートにアクセスするには、次のステップを実行します。

1. Oracle Application Expressにサインインします。

ワークスペースのホームページが表示されます。

2. 「アプリケーション・ビルダー」アイコンをクリックします。

アプリケーション・ビルダーのホームページが表示されます。

3. 「ワークスペース・ユーティリティ」アイコンをクリックします。

4. ウィンドウの右側に、「アプリケーション間レポート」があります。

5. 「アプリケーション間レポート」で、「すべてのレポート」をクリックしてアプリケーション間レポート・ページを表示します。

6. 表示するレポートを選択します。

6.13.11 対話モード・レポート・ユーティリティの使用

この項では、ユーティリティ・ページの右側の対話モード・レポート・ユーティリティの下にあるオプションについて説明します。

トピック:

- 保存された対話モード・レポートの削除

- サブスクリプションの表示

6.13.11.1 保存された対話モード・レポートの削除

保存された対話モード・レポート・ページには、現在選択しているアプリケーションに保存された対話モード・レポートが一覧表示されます。

保存された対話モード・レポートを管理するには、次の手順を実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

アプリケーションのホームページが表示されます。

3. 「ユーティリティ」をクリックします。

4. 「対話モード・レポート・ユーティリティ」で、「保存されたレポート」を選択します。

レポートに、プライマリ・デフォルトではないアプリケーションの保存されたレポートがすべて表示されます。各行には、ページ番号、リージョン名、レポート・タイプ、レポート名、レポートの別名および所有者が含まれます。

5. プライベートの保存済レポートを表示するには、検索バーの下にある「プライマリ・デフォルト」フィルタのチェック・ボックスの選択を解除します。

6. レポートを削除するには、ページ番号の横にあるチェック・ボックスを選択して「チェックした項目の削除」をクリックします。

7. レポートを含むページを表示するには、ページ番号をクリックします。

関連項目:

- 「共有対話モード・レポートへのリンクの設定」

- 「対話モード・レポートの保存」

- 『Oracle Application Express管理ガイド』の保存された対話モード・レポートの管理に関する項

6.13.11.2 サブスクリプションの表示

エンド・ユーザーはレポートをサブスクライブすると、レポートの更新バージョンを受信できます。ワークスペース管理者はサブスクリプション・ページでこのサブスクリプションを表示して管理できます。

保存された対話モード・レポートを管理するには、次の手順を実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

アプリケーションのホームページが表示されます。

3. 「ユーティリティ」をクリックします。

4. 「対話モード・レポート・ユーティリティ」で、「サブスクリプション」を選択します。

レポートが表示されます。

7 ページ・デザイナでのページの管理

開発者は、ページ・デザイナでアプリケーションを表示および管理できます。ページ・デザイナは、ツールバーと複数のペインを含む、フル機能を備えた統合開発環境(IDE)です。

トピック:

- ページ・デザイナについて

- ページ・デザイナUI要素の理解

- ページ・デザイナの使用

- ページ・デザイナでのページ属性の管理

- ページ・デザイナからのページの実行

- 実行時開発者ツールバー

- ページ・デザイナでのデータベース・アプリケーション・ページのコピー

- ページ・デザイナでのページの削除

- レガシー・コンポーネント・ビューからページ・デザイナへの切替え

関連項目:

- 「開発者コメントの追加」

- データベース・アプリケーションの作成

- 「ページ・レイアウトの制御」

- 「ナビゲーションの追加」

7.1 ページ・デザイナについて

ページ・デザイナは、ツールバーと複数のペインを含む、フル機能を備えた統合開発環境(IDE)です。ページ・デザイナを使用すると、Oracle Application Expressアプリケーション内のページをメンテナンスおよび拡張できます。

「ページ・デザイナ」ウィンドウは、3つの主要ペインに分かれています。

- 左ペイン: ツリーとして表示される「レンダリング」、「動的アクション」、「プロセス」および「共有コンポーネント」の4つのタブが含まれます。ページ・デザイナの左ペインを参照してください。

- 中央ペイン: 「レイアウト」、「コンポーネント・ビュー」、「メッセージ」、「ページ検索」および「ヘルプ」の5つのタブが含まれます。ページ・デザイナの中央ペインを参照してください。

- 右ペイン: プロパティ・エディタが表示されます。選択したコンポーネントの属性を更新するには、プロパティ・エディタを使用します。複数のコンポーネントを選択すると、プロパティ・エディタには共通の属性のみが表示されます。共通の属性を更新すると、選択したすべてのコンポーネントのその属性が更新されます。ページ・デザイナの右ペイン(プロパティ・エディタ)を参照してください。

各ペインのサイズを調整するには、縦横のスプリッタを選択してドラッグします。各ペインを展開または縮小するには、各スプリッタの中央にある「閉じる」というラベルの小さい三角形をクリックします。

ヒント:

「ページ・デザイナ」ウィンドウについて説明するオンラインのサマリーを表示できます。ページ・デザイナでページを表示し、ページの上部にある「ヘルプ」メニューをクリックして、「ページ・デザイナのスタート・ガイド」を選択します。

関連項目:

ページ・デザイナでのヘルプの表示、ページ・デザイナでのページの管理、ページ・デザイナUI要素の理解およびレガシー・コンポーネント・ビューでのページの表示

7.2 ページ・デザイナUI要素の理解

ページ・デザイナ・ウィンドウには、左ペイン、中央ペイン、右ペインの3つのペインがあります。

左ペインには、「レンダリング」、「動的アクション」、「プロセス」および「ページ共有コンポーネント」の4つのタブが表示されます。中央ペインには、「レイアウト」、「コンポーネント・ビュー」、「メッセージ」、「ページ検索」、「ヘルプ」の4つのタブがあり、下部に「ギャラリ」ペインがあります。右ペインには、プロパティ・エディタが表示されます。選択したコンポーネントの属性を編集するには、プロパティ・エディタを使用します。

ヒント:

この情報に関するオンライン・サマリーを表示できます。ページ・デザイナでページを表示し、ページの上部にある「ヘルプ」メニューをクリックして、「ページ・デザイナのスタート・ガイド」を選択します。

トピック:

- ページ・デザイナ・ツールバー

- ページ・デザイナの左ペイン

- ページ・デザイナの中央ペイン

- ページ・デザイナの右ペイン(プロパティ・エディタ)

- コード・エディタ

関連項目:

ページ・デザイナの使用

7.2.1 ページ・デザイナ・ツールバー

ページ上部に表示されるページ・デザイナ・ツールバーには、ボタンとメニュー・オプションの両方が含まれています。アクティブなボタンおよびメニューの上にカーソルを置くと、ツールチップが表示されます。

ヒント:

ページ・デザイナの使用方法に関するオンライン・サマリーを表示できます。ページ・デザイナでページを表示し、ページの上部にある「ヘルプ」メニューをクリックして、「ページ・デザイナのスタート・ガイド」を選択します。

ページ・デザイナ・ツールバーのボタンおよびメニュー・オプションは次のとおりです。

ページ・セレクタ

「ページ・セレクタ」には、カレント・ページが表示されます。下矢印(「ページ・ファインダ」というラベルが付いています)をクリックして、ページを検索します。または、フィールドにページ番号を入力して、「実行」をクリックします。前または次のページにナビゲートするには、「次のページにナビゲート」(上矢印)および「前のページにナビゲート」(下矢印)をクリックします。

関連項目:

ページの検索

ページがロック解除されましたおよびページがロックされました

ページのロック・ステータスを示します。「ページがロック解除されました」は、カレント・ページがロック解除され、編集可能であることを示します。「ページがロックされました」は、ページが編集不可であることを示します。南京錠アイコンの外観は、ロック・ステータスに応じて変わります。

- ロック解除された透明の南京錠: ページがロック解除されていることを示します。

- ロックされた緑の南京錠: 自分がページをロックしていることを示します。

- ロックされた赤の南京錠: 別のユーザーがページをロックしていることを示します。ロック所有者を表示したり、ロック・コメントを更新するには、赤の南京錠をクリックします。

関連項目:

ページのロックおよびロック解除

「元に戻す」および「やり直し」

ページ・データを変更するアクションに適用されます。「元に戻す」では、ページ・デザイナ内で行った前回の更新が元に戻されます。「やり直し」では、「元に戻す」を使用して元に戻した最後の更新が再適用されます。

作成

グラフィカルなプラス記号(+)で示されます。「作成」メニュー・オプションは、次のとおりです。

- ページ。ページの作成ウィザードにアクセスします。データベース・アプリケーションへのページの追加についてを参照してください。

- コピーとしてのページ。ページのコピー・ウィザードにアクセスします。ページ・デザイナでのデータベース・アプリケーション・ページのコピーを参照してください。

- ページ・コンポーネント。ページ・デザイナでページ・コンポーネントを作成する方法のサマリーを提供します。

- フォーム・リージョン。フォーム・リージョンの作成ウィザードにアクセスします。ページ・デザイナでのフォーム・リージョンの作成を参照してください。

- ブレッドクラム・リージョンブレッドクラムの作成ウィザードにアクセスします。ブレッドクラムの作成およびページ・デザイナでのブレッドクラム・リージョンの作成を参照してください。

- 共有コンポーネント。アプリケーション・コンポーネントの作成ウィザードにアクセスします。共有コンポーネントは、アプリケーション内のすべてのページに表示または適用される共通の要素です。共有コンポーネントの管理を参照してください。

- ページ・グループ。ページ・グループ・ページにリンクします。ページ・グループを使用してページを整理します。ページ・グループの作成を参照してください。

- 開発者のコメント。「開発者のコメント」ダイアログにアクセスします。開発者はアプリケーション、ページ、またはページ・グループにコメントを追加できます。開発者コメントの追加を参照してください。

- チーム開発。サブメニューの「機能」、「To Do」および「バグ」を表示します。機能の追跡、To Doの追跡およびバグの管理を参照してください。

ユーティリティ

レンチのグラフィックで示されます。「ユーティリティ」メニュー・オプションは次のとおりです。

- ページの削除。カレント・ページを削除します。ページ・デザイナでのページの削除を参照してください。

- アドバイザ。Oracle Application Express Advisor (Advisor)にアクセスします。Advisorを使用して、Oracle Application Expressアプリケーションの整合性と品質を確認します。  アプリケーション整合性のチェックのためのアドバイザの実行を参照してください。

- キャッシュ。キャッシュ・ページにリンクします。キャッシュを有効にすることは、パフォーマンスを向上させるための効果的な方法です。ページ・デザイナでのリージョン・キャッシュの使用およびコンポーネント・ビューでのリージョン・キャッシュの使用を参照してください。

- 属性ディクショナリ。属性ディクショナリにアクセスします。属性ディクショナリの使用を参照してください。

- 履歴。カレント・ページへの変更のレポートを表示します。

- エクスポート。カレント・ページをエクスポートします。アプリケーションおよびアプリケーション・コンポーネントのエクスポートを参照してください。

- クロス・ページ・ユーティリティ。クロス・ページ・ユーティリティにアクセスします。「クロス・ページ・ユーティリティへのアクセス」を参照してください。

- アプリケーション・ユーティリティ。アプリケーション・ユーティリティにアクセスします。アプリケーション・ユーティリティの使用を参照してください。

- ページ・グループ。ページ・グループ・ページにリンクします。ページ・グループを使用してページを整理します。ページ・グループの作成を参照してください。

- アプリケーションのアップグレード。既存のアプリケーションをアップグレードします。アプリケーションのアップグレードの実行を参照してください。

設定

ページ・デザイナに表示されるペインの数を制御します。3ペイン・モードと2ペイン・モードの切替えを参照してください。

チーム開発

2人の人のグラフィカルな輪郭で示されます。「チーム開発」メニュー・オプションは次のとおりです。

- 「機能」。「機能の作成」にリンクします。機能の追跡を参照してください。

- To Do - 「To Doの作成」にリンクします。To Doの追跡を参照してください。

- バグ - 「バグの作成」にリンクします。バグの管理を参照してください。

- フィードバック・エントリ - フィードバック・レポートにリンクします。フィードバックの管理を参照してください。

ヒント:

この機能がワークスペースに対して有効化されている場合にのみ、「チーム開発」が表示されます。『Oracle Application Express管理ガイド』のチーム開発の管理に関する項を参照してください。

開発者のコメント

「開発者コメント、バグまたはTo Doの作成」ダイアログが表示されます。開発者コメントの追加を参照してください。

共有コンポーネント

共有コンポーネント・ページにリンクします。共有コンポーネントは、アプリケーション内のすべてのページに表示または適用できます。共有コンポーネントの管理を参照してください。

「保存」および「ページの保存と実行」

カレント・ページを保存するには、「保存」をクリックします。カレント・ページを保存した後で実行するには、「ページの保存と実行」をクリックします。「ページ・デザイナからのページの実行」を参照してください。

7.2.2 ページ・デザイナの左ペイン

ページ・デザイナの左ペインには、「レンダリング」、「動的アクション」、「プロセス」および「ページ共有コンポーネント」の4つのタブが表示されます。各タブには、カレント・ページに作成された、対応するコンポーネント・タイプとコンポーネントのリストが表示されます。

左ペインの主な機能は次のとおりです。

- コンテキスト・メニュー。コンポーネントまたはコントロールを右クリックすると、コンテキスト・メニューが表示されます。

- プロパティ・エディタへの迅速なアクセス。1つのコンポーネントまたは複数のコンポーネントを選択すると、右ペインのプロパティ・エディタに対応する属性が表示されます。

- ドラッグ・アンド・ドロップ。コンポーネントをツリー内で上下にドラッグし、選択したコンポーネントの位置または順序を変更します。

- ツールチップ。コンポーネントまたはコントロールの上にマウスをあわせると、リージョン・タイプ、アイテム・タイプなどの基本情報のツールチップが表示されます。

「レンダリング」タブ

「レンダリング」タブには、リージョン、ページ・アイテム、ページ・ボタン、ページ・コンポーネントおよびアプリケーション・ロジックが表示されます。「レンダリング」タブでは、コンポーネントはOracle Application Expressでの処理方法に基づいてグループ化され、順序付けされます。

次のアイコンをクリックして、表示を変更できます。

- 処理順序別にグループ化

- コンポーネント・タイプ別にグループ化

- 「レンダリング」メニュー: 「下をすべて展開」または「下をすべて縮小」

「動的アクション」タブ

「動的アクション」タブには、カレント・ページに対して定義された動的アクションが表示されます。動的アクションを作成することによって、JavaScriptを必要としないで複雑なクライアント側の動作を宣言的に定義できます。

関連項目:

動的アクションの管理

「プロセス」タブ

「プロセス」タブには、このページに対して定義されたアプリケーション・ロジックが表示され、コンポーネントがOracle Application Expressでの処理方法に基づいてグループ化され、順序付けされます。

次のアイコンをクリックして、表示を変更できます。

- 処理順序別にグループ化

- コンポーネント・タイプ別にグループ化

- 「プロセス」メニュー: 「計算の作成」、「下をすべて展開」または「下をすべて縮小」

関連項目:

計算、検証およびプロセスの管理

「ページ共有コンポーネント」タブ

「ページ共有コンポーネント」タブには、このページに関連付けられている共有コンポーネントが表示されます。

関連項目:

「共有コンポーネントの管理」

7.2.3 ページ・デザイナの中央ペイン

ページ・デザイナの中央ペインには、「レイアウト」、「ギャラリ」、「コンポーネント・ビュー」、「ページ検索」、「ヘルプ」の5つのタブがあります。次の各トピックで、ページの編集時にこれらのタブを使用する方法について詳しく説明します。

トピック:

- 「レイアウト」タブ

- ギャラリ

- 「コンポーネント・ビュー」タブ

- 「メッセージ」タブ

- 「ページ検索」タブ

- 「ヘルプ」タブ

7.2.3.1 「レイアウト」タブ

ページ・デザイナの中央ペインに表示される「レイアウト」タブは、ページでのコンポーネントの配置状態を視覚的に表示します。「レイアウト」タブにはコンテキスト・メニューがあります。コンポーネントを選択して右クリックすることで、コンポーネントを削除、移動、またはページ上の他のリージョンや新しいリージョンにコピーできます。また、コンポーネントをクリックして新しい位置にドラッグするだけで、既存のリージョン、アイテムおよびボタンを他のコンポーネントに対して相対的に移動することもできます。たとえば、アイテムを相互に並べて配置するには、2つ目のアイテムを1つ目のアイテムの末尾にドラッグし、目的の場所にカーソルを合わせたときに表示される濃い黄色のボックス内にドロップします。新しいコンポーネントを既存のページに追加するには、「ギャラリ」からコンポーネントを「レイアウト」タブ内の目的の位置までドラッグするだけです。

各ペインのサイズを調整するには、縦横のスプリッタを選択してドラッグします。各ペインを展開または縮小するには、各スプリッタの中央にある「閉じる」というラベルの小さい三角形をクリックします。また、「開く」ボタンをクリックして「レイアウト」タブを拡大し、その後、「リストア」をクリックして前のサイズに戻すこともできます。

ヒント:

非表示のアイテムは「レイアウト」タブに表示されませんが、「レンダリング」ツリーには表示されます。

「レイアウト」タブの主な機能は次のとおりです。

- コンテキスト・メニュー。コンポーネントまたはコントロールを右クリックすると、コンテキスト・メニューが表示されます。

- プロパティ・エディタへの迅速なアクセス。1つのコンポーネントまたは複数のコンポーネントを選択すると、右ペインのプロパティ・エディタに対応する属性が表示されます。

- ドラッグ・アンド・ドロップ。ドラッグ・アンド・ドロップにより、リージョン、アイテムおよびボタンの移動、コピーおよび順序変更を行います。「ギャラリ」からリージョン、アイテムおよびボタンをドラッグしてページ上の目的の位置にドロップすることによって、新しく追加することもできます。

- ツールチップ。コンポーネントまたはコントロールの上にマウスをあわせると、リージョン・タイプ、アイテム・タイプなどの基本情報のツールチップが表示されます。

ヒント:

アイテムを既存のアイテムと同じ行にドラッグするなど、コンポーネントを新しい位置にドラッグする場合は、コンポーネントを目的の位置にドラッグした後、グリッドが変更されて新しいドロップ位置が表示されるまで待つ必要があります。ドラッグ・アンド・ドロップによるリージョン、アイテムまたはボタンの追加を参照してください。

「レイアウト」メニュー

「レイアウト」メニューは、ペインの右側に表示されます。このメニューを使用すると、表示する情報のタイプおよび量のカスタマイズ、選択したコンポーネントの削除、移動およびコピーを実行できます。特定のリージョンが「レイアウト」タブ全体に表示されるようにするには、リージョンを選択して、「レイアウト」メニューから「ここから表示」を選択します。選択したリージョンが「レイアウト」タブ全体に表示されます。ビューをリストアするには、「ページから表示」を選択します。

関連項目:
ドラッグ・アンド・ドロップによるリージョン、アイテムまたはボタンの追加

7.2.3.2 ギャラリ

ページ・デザイナの中央ペインの下部に表示される「ギャラリ」ペインには、「リージョン」、「アイテム」および「ボタン」の3つのタブがあります。コントロールまたはコンポーネントにカーソルをあわせると、それについて説明するツールチップが表示されます。ペインのサイズを調整するには、縦横のスプリッタをドラッグします。「ギャラリ」ペインを縮小またはリストアするには、各スプリッタの中央にある小さい三角形をクリックします。

「ギャラリ」からコントロールまたはコンポーネントを選択して「レイアウト」タブにドラッグ・アンド・ドロップすることによって、新しいコントロールおよびコンポーネントをページに追加できます。または、「ギャラリ」でコントロールまたはコンポーネントを選択して右クリックし、コンテキスト・メニューを表示することもできます。

関連項目:

ドラッグ・アンド・ドロップによるリージョン、アイテムまたはボタンの追加およびギャラリ・コンテキスト・メニューを使用したコンポーネントの追加について

「ギャラリ」メニュー

「ギャラリ」メニューは、「ギャラリ」ペインの右側に表示されます。デフォルトでは、「ギャラリ」にはサポートされているコントロールおよびコンポーネントのみが表示されます。サポートされないコントロールおよびコンポーネント(レガシー・アプリケーション・コンポーネントなど)を表示するには、「ギャラリ」メニューで「サポートされないコンポーネントの表示」を有効化します。レガシー・コントロールおよびレガシー・コンポーネントを表示するには、「ギャラリ」メニューで「レガシー・コンポーネントの表示」を有効化します。

注意:

アプリケーション・レガシー・コンポーネントの管理

7.2.3.3 「コンポーネント・ビュー」タブ

アプリケーション・ビルダーのレガシー・コンポーネント・ビュー・ウィンドウと同様、「コンポーネント・ビュー」タブでは、ユーザー・インタフェース要素とアプリケーション・ロジックがコンポーネント・タイプ別にグループ化されています。ページ・デザイナの中央ペインに表示される「コンポーネント・ビュー」タブは、次のセクションで構成されています。

- ページ・レンダリング.ページ・レンダリングとは、データベースからページを生成するプロセスです。「ページ・レンダリング」セクションを使用して、ページ属性、リージョン、ボタン、アイテム、ページ・レンダリングの計算、およびページ・プロセスを含むページのレンダリングに影響するコントロールを変更できます。

- ページ・プロセス.ページ・プロセスは、ページを送信するプロセスです。通常、ページは、ユーザーがボタンをクリックすると送信されます。「ページ・プロセス」セクションを使用して、計算、検証、プロセス、ブランチなどのアプリケーション・ロジックを指定します。通常、Application Expressエンジンは、ページに表示される順序でこのロジックを実行します。

- 共有コンポーネント.「共有コンポーネント」セクションには、アプリケーション内の1つ以上のページで使用できる共通のコンポーネントが表示されます。

「コンポーネント・ビュー」タブのサイズを調整するには、ウィンドウ・スプリッタを使用します。また、左上隅にある「開く」ボタンをクリックしてウィンドウを最大化し、その後、「リストア」をクリックして前のサイズに戻すこともできます。

コンポーネントを編集する場合は、コンポーネント名をクリックすると、右ペインのプロパティ・エディタで対応する属性がハイライトされます。「レイアウト」タブとは異なり、「コンポーネント・ビュー」タブでは、ページを視覚的に表示したり、ページ・コンポーネントをドラッグ・アンド・ドロップできません。ページ上のコンポーネントの位置をプレビューするには、「レイアウト」をクリックするか、またはページを実行します。

新しいコントロール、コンポーネントまたはプロセスを追加するには、セクション名の右側の「作成」アイコンをクリックします。

関連項目:

「コンポーネント・ビュー」タブからのリージョン、アイテムまたはボタンの追加およびレガシー・コンポーネント・ビューでのページの管理

7.2.3.4 「メッセージ」タブ

「メッセージ」タブは、ページ・デザイナの中央ペインに表示されます。ページ・デザイナでコンポーネントを作成したり属性を編集する際、「メッセージ」タブに、対処が必要なエラーおよび警告が表示されます。「メッセージ」タブに、対処する必要があるメッセージの数を示した赤または黄色のバッジが表示されます。メッセージをクリックすると、プロパティ・エディタ内で、エラーまたは警告に関連付けられた対応する属性にフォーカスが移動します。ヘルプを表示するには、「ヘルプ」タブをクリックし、右ペインにあるプロパティ・エディタで属性を選択します。

「メッセージ」タブには、次の2つのタイプのメッセージが表示されます。

- エラー - エラー・メッセージは赤で表示されます。エラー・メッセージを選択すると、プロパティ・エディタに関連する属性が赤で表示されます。ページを保存する前にエラーに対処する必要があります。

- 警告 - 警告メッセージは黄色で表示されます。警告メッセージを選択すると、プロパティ・エディタで、関連する属性が黄色で表示されます。警告メッセージには対処しないでページを保存できます。

ヒント:

エラーまたは警告のあるコンポーネントは、左ペインと「レイアウト」タブの両方に、Xアイコンとともに赤で表示されるか、三角形のアイコンとともに黄色で表示されます。

関連項目:

ドラッグ・アンド・ドロップによるリージョン、アイテムまたはボタンの追加およびギャラリ・コンテキスト・メニューを使用したコンポーネントの追加について

7.2.3.5 「ページ検索」タブ

「ページ検索」タブは、中央ペインの「メッセージ」の右側に表示されます。「ページ検索」を使用して、リージョン、アイテム・ボタン、動的アクション、列などのすべてのページ・メタデータを検索します。ページを検索するには、指定のフィールドに検索文字列を入力します。大文字と小文字を区別するには、「大/小文字の区別」を選択します。正規表現を検索するには、「正規表現」を選択します。

7.2.3.6 「ヘルプ」タブ

ページ・デザイナには、すべてのページ・エディタ属性のヘルプが含まれています。ヘルプを表示するには、属性を選択して「ヘルプ」タブをクリックします。「ヘルプ」ペインをアクティブ化すると、別の属性を選択するたびに表示されるコンテンツが変わります。この例では、「Customers」リージョンの「SQL問合せ」が選択されており、中央ペインには「SQL問合せ」属性の「ヘルプ」が表示されています。この図の詳細は、周辺の説明を参照してください。

関連項目:

ページ・デザイナでのヘルプの表示

7.2.4 ページ・デザイナの右ペイン(プロパティ・エディタ)

プロパティ・エディタ

ページ・デザイナの右ペインには、プロパティ・エディタが表示されます。プロパティ・エディタには、現在のコンポーネントについてすべての属性が表示されます。「コンポーネント・ビュー」タブをクリックすると、「メッセージ」タブまたは「ページ検索」タブについてもプロパティ・エディタの選択が変更されます。複数のコンポーネントを選択すると、プロパティ・エディタには共通の属性のみが表示されます。共通の属性を更新すると、選択したすべてのコンポーネントのその属性が更新されます。

プロパティ・エディタでは、属性が機能グループに編成されます。次のアイコンを使用して、これらのグループを展開または縮小します。

- 共通の表示 - デフォルト値が変更されていたり、よく編集される属性のみを表示します。

- すべて表示 - すべての属性を表示します(デフォルト)。

- すべて閉じる - グループ・ヘッダーのみが表示されるように機能グループを縮小します。

- すべて開く - すべての属性が表示されるように機能グループを展開します。

- グループに移動 - 選択したグループにナビゲートして、必要に応じて展開します。

グループまたは属性を検索するには、「フィルタ・プロパティ」フィールドにキーワードを入力します。その用語を含むグループと属性が表示されます。

関連項目:

ページ・デザイナの使用およびページ・デザイナでのページ属性の管理

7.2.5 コード・エディタ

大量のコードが必要な属性(リージョン・ソースなど)に対して、次の操作を実行できます。

- フィールドにテキストを直接入力します。

- 「コード・エディタ」をクリックして、フル機能を備えたコード・エディタにテキストを入力します。

関連項目:

プロパティ・エディタへのアクセス

コード・エディタは、モーダル・ダイアログとして表示されます。コード・エディタを使用して、大量のコードが必要な属性を編集できます。コード・エディタには、PL/SQL、SQL、HTML、CSSおよびJavaScriptのコンポーネント・プロパティを編集するための強化されたコード・エディタが用意されています。コードのハイライト表示は、特定のプロパティに必要な入力によって決定されます。

コード・エディタの主な機能は次のとおりです。

- 元に戻す

- やり直し

- 検索

- 置換

- クエリー・ビルダー

- オートコンプリート

- 検証

- 構文のハイライト

- ブロックのインデントおよびインデント解除

- ダイアログのサイズ変更

ヒント:

プレーン・テキスト・エディタに切り替えるには、「設定」メニューから「プレーン・テキスト・エディタの使用」を選択します。

7.3 ページ・デザイナの使用

ページ・デザイナを使用して、データベース・アプリケーション・ページを表示および編集します。

ヒント:

キーボード・ショートカットのリストを表示するには、[Alt]+[Shift]+[F1]を押します。または、ページの上部にある「ヘルプ」メニューをクリックして、「ショートカット」を選択します。

トピック:

- ページ・デザイナでのページの表示

- ページの検索

- 3ペイン・モードと2ペイン・モードの切替え

- プロパティ・エディタへのアクセス

- ドラッグ・アンド・ドロップによるリージョン、アイテムまたはボタンの追加

- ギャラリ・コンテキスト・メニューを使用したコンポーネントの追加について

- 「レンダリング」タブからのリージョン、アイテムまたはボタンの追加

- 「コンポーネント・ビュー」タブからのリージョン、アイテムまたはボタンの追加

- リージョン、アイテムまたはボタンのコピー

- レンダリング前ブランチ、計算およびプロセスの作成

- ページ送信ブランチ、検証、計算およびプロセスの作成

関連項目:

ページ・デザイナUI要素の理解およびページ・デザイナでのヘルプの表示

7.3.1 ページ・デザイナでのページの表示

ページ・デザイナでページを表示するには、次のステップを実行します。

1. 「ワークスペース」ホームページにナビゲートします。

2. 「アプリケーション・ビルダー」アイコンをクリックします。

3. アプリケーションを選択します。

4. ページを選択します。

デフォルト・ビューのページ・デザイナが表示されます。

ページを実行してプレビューします。アプリケーション・ページを実行すると、エンド・ユーザーに表示されるとおりにレンダリングされたバージョンが表示されます。

関連項目:

「レガシー・コンポーネント・ビューからページ・デザイナへの切替え」および「ページ・デザイナからのページの実行」

7.3.2 ページの検索

「ページ・セレクタ」は、ページ・デザイナ・ツールバーの最初のコントロールで、カレント・ページ番号を表示します。「ページ・セレクタ」を使用して、カレント・アプリケーション内のページを検索します。

アプリケーション内のページを検索するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. ページを選択します。

ページ・デザイナが表示されます。

2. ページ・デザイナ・ツールバーで、「ページ・セレクタ」をクリックします。

「ページ・ファインダ」が表示されます。

3. ウィンドウ上部のタブをクリックして、ビューを変更します。

- 現在のユーザー・インタフェース - 現在のユーザー・インタフェースのページが表示されます。

- 現在のグループ - カレント・ページがグループに関連付けられている場合、このタブにはカレント・グループに関連付けられたページが表示されます。

- すべてのページ - カレント・アプリケーションのすべてのページが表示されます。

- 最近編集された - 最近編集されたページが表示されます。

4. 「検索」フィールドに検索文字列を入力し、[Enter]を押すか、または「実行」をクリックします。

ページ番号、ページ名、ユーザー・インタフェースまたはグループ名を検索します。検索では、大文字と小文字は区別されず、正規表現がサポートされています。

関連項目:

「ページ・デザイナからのページの実行」および「ページ・グループの作成」

7.3.3 3ペイン・モードと2ペイン・モードの切替え

デフォルトでは、ページ・デザイナには3つのペインが表示されます。ページ・デザイナ・ツールバーの「設定」メニューにあるオプションを使用して、2ペイン・モードと3ペイン・モードを切り替えます。「2ペイン・モード」にアクセスする標準的なユースケースは、「レンダリング」ツリーとプロパティ・エディタのみを表示する必要がある場合です。

ページ・エディタのペインの非表示と表示を切り替えるには、次のステップを実行します。

1. ページ・デザイナでページを表示します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. ページを選択します。

ページ・デザイナが表示されます。

2. ページ・デザイナ・ツールバーで、「設定」をクリックし、次のいずれかを選択します。

a. 2ペイン・モード: 中央ペインと右ペインのみを表示します。

b. 3ペイン・モード: 左ペイン、中央ペインおよび右ペインを表示します。

c. レイアウトのリセット: レイアウトをデフォルト表示に戻します。このオプションは、タブをデフォルトの位置から移動した場合またはタブ・サイズをカスタマイズした場合に選択します。

ヒント:

ペイン間でタブをドラッグ・アンド・ドロップすることもできます。タブをデフォルトの位置に戻すには、ページ・デザイナ・ツールバーの「設定」メニューから「レイアウトのリセット」を選択します。

7.3.4 プロパティ・エディタへのアクセス

ページ・デザイナの右ペインに表示されるプロパティ・エディタには、現在選択しているコンポーネントのすべての属性が表示されます。

プロパティ・エディタにアクセスするには、次のステップを実行します。

1. ページ・デザイナでページを表示します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. ページを選択します。

ページ・デザイナが表示されます。

2. 左ペインまたは「レイアウト」タブのいずれかで、編集するコンポーネントやコントロールを選択します。コントロールまたはコンポーネントにカーソルをあわせると、それについて説明するツールチップが表示されます。

ヒント:

コンポーネントを選択したら、[Alt]+[6]を押してプロパティ・エディタに直接移動します。

プロパティ・エディタには、選択したコンポーネントまたはコントロールの属性が表示されます。左ペインまたは「レイアウト」タブで異なるコンポーネントを選択すると、プロパティ・エディタが自動的に更新され、選択したコンポーネントが反映されます。複数のコンポーネントを選択すると、プロパティ・エディタには共通の属性のみが表示されます。共通の属性を更新すると、選択したすべてのコンポーネントのその属性が更新されます。

ヒント:

属性のヘルプを表示するには、プロパティ・エディタで属性を選択し、中央ペインで「ヘルプ」タブをクリックします。

関連項目:

「ページ・デザイナの右ペイン(プロパティ・エディタ)」および『Oracle Application Expressアクセシビリティ・ガイド』

7.3.5 ドラッグ・アンド・ドロップによるリージョン、アイテムまたはボタンの追加

各アプリケーション・ページにはボタンおよびフィールド(アイテムと呼ばれる)を配置でき、これらはリージョンと呼ばれるコンテナにグループ化されます。「ギャラリ」からリージョン、アイテムおよびボタンをドラッグ・アンド・ドロップすることにより、ページに新しく追加できます。

リージョン、アイテムまたはボタンを追加するには、「ギャラリ」からドラッグ・アンド・ドロップします。

1. ページ・デザイナでページを表示します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. ページを選択します。

ページ・デザイナが表示されます。

2. 必要に応じて、中央ペインの「レイアウト」タブを選択します。

3. 中央ペインの下部にある「ギャラリ」で、作成するコンポーネントまたはコントロールを見つけます。

ギャラリに、ページに追加できるすべてのコントロールまたはコンポーネントが一覧表示されます。カーソルをコントロールまたはコンポーネントにあわせると、説明するツールチップが表示されます。

ヒント:

ギャラリからコンポーネントをドラッグ・アンド・ドロップする以外に、ギャラリでコンポーネントを右クリックしてコンテキスト・メニューを表示することもできます。「追加先」を選択して、コンポーネントを追加する位置を選択します。

4. 作成するコンポーネント上でマウスをクリックしたまま、「レイアウト」タブ内の目的の位置にドラッグします。

適切な位置にマウスが配置されると、「レイアウト」タブが暗い黄色の四角形として表示されます。マウスを離して、コンポーネントをドロップします。コンポーネントは、コンポーネント・タイプによって決定される適切なドロップ位置にのみドロップできます。

追加するコンポーネント・タイプに基づいて、ページ・デザイナが次に必要な操作を示します。「メッセージ」タブに、対処する必要があるメッセージの数を示した赤または黄色のバッジが表示されます。次に、SQL問合せが必要であることを示すエラー・メッセージが表示された新しい対話グリッド・リージョンの例を示します。

5. プロパティ・エディタで該当する属性を編集します。

ヒント:

属性のヘルプを表示するには、プロパティ・エディタで属性を選択し、中央ペインで「ヘルプ」タブをクリックします。

6. 「保存」または「ページの保存と実行」をクリックします。

関連項目:

- 「「メッセージ」タブ」

- 「ページ・デザイナからのページの実行」

- 「ギャラリ・コンテキスト・メニューを使用したコンポーネントの追加について」

7.3.6 ギャラリ・コンテキスト・メニューを使用したコンポーネントの追加について

ギャラリからコンポーネントをドラッグ・アンド・ドロップする以外に、ギャラリでコンポーネントを右クリックしてコンテキスト・メニューを表示することもできます。各コンテキスト・メニューには、コンポーネントを追加できる実際の位置を示す「追加先」オプションがあります。この例では、開発者は、コンテンツ本体リージョンの前に新しいレポートを追加しています。

関連項目:

ドラッグ・アンド・ドロップによるリージョン、アイテムまたはボタンの追加

7.3.7 「レンダリング」タブからのリージョン、アイテムまたはボタンの追加

「レンダリング」タブ内で新しいコンポーネントを作成するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. ページを選択します。

2. 左ペインで、「レンダリング」タブを選択します。

3. 適切なリージョン、アイテムまたはリージョン・ボタンを見つけて選択します。

4. 既存のコンポーネントまたはコンテナを右クリックして、該当するコンポーネント・タイプのコンテキスト・メニューを表示します。

5. コマンド(「リージョンの作成」、「サブリージョンの作成」、「ページ・アイテムの作成」、「ボタンの作成」など)を選択します。使用可能なオプションは、選択するノードによって異なります。

6. プロパティ・エディタで該当する属性を編集します。

ヒント:

属性のヘルプを表示するには、プロパティ・エディタで属性を選択し、中央ペインで「ヘルプ」タブをクリックします。

7. 「保存」または「ページの保存と実行」をクリックします。

関連項目:

- ページ・デザイナの右ペイン(プロパティ・エディタ)

- 「ページ・デザイナでのリージョンの管理」

- 「ページ・デザイナでのページ・レベル・アイテムの表示」

- 「ページ・デザイナでのボタンの管理」

7.3.8 「コンポーネント・ビュー」タブからのリージョン、アイテムまたはボタンの追加

ページ・デザイナへの移行で開発者を支援するために、ページ・デザイナには「コンポーネント・ビュー」タブが含まれています。レガシー・コンポーネント・ビューの外観と同様、ページ・デザイナの「コンポーネント・ビュー」タブには、ユーザー・インタフェース要素とアプリケーション・ロジックがコンポーネント・タイプ別に表示されます。

「コンポーネント・ビュー」タブから新しいコンポーネントを作成するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。ページ・デザイナでのページの表示を参照してください。

ページ・デザイナが表示されます。

2. 中央ペインで、「コンポーネント・ビュー」タブを選択します。

3. 適切なコンポーネント・タイプの下で、「作成」アイコンをクリックします。
ページ・デザイナの左ペインと中央ペインで、新しいコンポーネントが「新規」として識別されます。

4. プロパティ・エディタで該当する属性を編集します。

ヒント:

属性のヘルプを表示するには、プロパティ・エディタで属性を選択し、中央ペインで「ヘルプ」タブをクリックします。

5. 「保存」または「ページの保存と実行」をクリックします。

関連項目:

- 「ボタンの作成」

- 「ページ・デザイナでのリージョンの管理」

- 「ページ・デザイナでのページ・レベル・アイテムの表示」

7.3.9 リージョン、アイテムまたはボタンのコピー

各アプリケーション・ページにはボタンおよびフィールド(アイテムと呼ばれる)を配置でき、これらはリージョンと呼ばれるコンテナにグループ化されます。開発者は、コンテキスト・メニューを使用するか、または[Ctrl]を押してマウスでドラッグ・アンド・ドロップすることにより、リージョン、アイテムおよびボタンをコピーできます。

コンテキスト・メニューを使用したリージョン、アイテムまたはボタンのコピー

コンテキスト・メニューを使用してリージョン、アイテムまたはボタンをコピーするには、次のステップを実行します。

1. 中央ペインで、「レイアウト」タブを選択します。

2. 適切なリージョン、アイテムまたはリージョン・ボタンを見つけて選択します。

3. 右クリックしてコンテキスト・メニューを表示します。

4. コンテキスト・メニューから「コピー先」を選択し、次に、場所を選択します。

5. コンポーネント属性を編集します。

ドラッグ・アンド・ドロップによるリージョン、アイテムまたはボタンのコピー

ドラッグ・アンド・ドロップによってリージョン、アイテムまたはボタンをコピーするには、次のステップを実行します。

1. 左ペインで、「レンダリング」タブを選択します。

2. 適切なリージョン、アイテムまたはリージョン・ボタンを見つけて選択します。

3. [Ctrl]を押してから、マウスを使用してコンポーネントを新しい位置にドラッグ・アンド・ドロップします。
コンポーネントのコピーが新しい位置に表示されます。

4. コンポーネント属性を編集します。

別のページへのリージョン、アイテムまたはボタンのコピー

別のページにリージョン、アイテムまたはボタンをコピーするには、次のステップを実行します。

1. 左ペインで、「レンダリング」タブを選択します。

2. 適切なリージョン、アイテムまたはリージョン・ボタンを見つけて選択します。

3. コンポーネントを右クリックして、「他のページにコピー」を選択します。
適切なウィザードが表示されます。

4. 画面に表示されるステップに従います。

7.3.10 レンダリング前ブランチ、計算およびプロセスの作成

ページのレンダリング前に実行するブランチ、計算およびプロセスを作成するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. ページを選択します。

ページ・デザイナが表示されます。

2. 左ペインで、「レンダリング」タブを選択します。

3. 「レンダリング」タブの上部にある「レンダリング前」ノードを展開します。

4. プロセス・ポイントを決定します。「ヘッダーの前」、「ヘッダーの後」または「リージョンの前」を右クリックして、該当するプロセス・ポイントのコンテキスト・メニューを表示します。

5. 「ブランチの作成」、「計算の作成」または「プロセスの作成」から、適切なオプションを選択します。

6. プロパティ・エディタで該当する属性を編集します。

ヒント:

属性のヘルプを表示するには、プロパティ・エディタで属性を選択し、中央ペインで「ヘルプ」タブをクリックします。

7. 「保存」または「ページの保存と実行」をクリックします。

ヒント:

デフォルトの表示を変更してコンポーネント・タイプごとにコンポーネントをグループ化している場合は、「プロセス」タブにナビゲートしてレンダリング前コンポーネントを保守する必要があります。

関連項目:

計算、検証およびプロセスの管理

7.3.11 ページ送信ブランチ、検証、計算およびプロセスの作成

ページの送信時に実行するブランチ、検証、計算およびプロセスを作成するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. ページを選択します。

ページ・デザイナが表示されます。

2. 左ペインで、「プロセス」タブを選択します。

3. プロセス・ツリー内で、必要に応じて「送信後」、「検証中」、「プロセス」または「プロセスの後」にナビゲートします。

4. 識別子または既存のコンポーネントを右クリックして、そのプロセス・ポイントのコンテキスト・メニューを表示します。

5. 「ブランチの作成」、「検証の作成」、「計算の作成」または「プロセスの作成」を選択します。

6. プロパティ・エディタで該当する属性を編集します。

ヒント:

属性のヘルプを表示するには、プロパティ・エディタで属性を選択し、中央ペインで「ヘルプ」タブをクリックします。

7. 「保存」または「ページの保存と実行」をクリックします。

ヒント:

コンテキスト・メニューを使用して、コンポーネントを複製および削除したり、その他のページにコピーすることができます。

関連項目:

計算、検証およびプロセスの管理

7.4 ページ・デザイナでのページ属性の管理

ページ属性では、ページ名またはタイトル、ヘッダーおよびフッター・テキスト、ナビゲーション・メニュー、ページ・レベルのJavaScriptまたはCSSファイルの追加、エラー処理、選択した認可スキームなど、特定のページの基本情報と機能を制御します。

トピック:

- プロパティ・エディタでのページ属性の編集

- ページ・デザイナを使用したJavaScriptの組込み

- ページ・デザイナでのセッションの再結合の構成

- ページ・デザイナでのダイアログ属性の構成

- 保存されていない変更についてユーザーに警告するためのページ属性の構成

関連項目:

ページ・デザイナの右ペイン(プロパティ・エディタ)

7.4.1 プロパティ・エディタでのページ属性の編集

ページ・デザイナでページ属性を編集するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. ページを選択します。

ページ・デザイナが表示されます。

2. 「レンダリング」タブまたは「レイアウト」タブのいずれかで、ページ名を選択します。

プロパティ・エディタにページ属性が表示されます。

プロパティ・エディタでは、属性が機能グループに編成されます。次のアイコンを使用して、これらのグループを展開または縮小します。

- 共通の表示 - デフォルト値が変更されていたり、よく編集される属性のみを表示します。

- すべて表示 - すべての属性を表示します(デフォルト)。

- すべて閉じる - グループ・ヘッダーのみが表示されるように機能グループを縮小します。

- すべて開く - すべての属性が表示されるように機能グループを展開します。

- グループに移動 - 選択したグループにナビゲートして、必要に応じて展開します。

3. グループまたは属性を検索するには、「フィルタ・プロパティ」フィールドにキーワードを入力します。

その用語を含むグループと属性が表示されます。

4. プロパティ・エディタで該当する属性を編集します。

ページが保存されるまで、編集した属性の属性名の左側に青色のマーカーが表示されます。

注意:

属性の詳細は、フィールドレベル・ヘルプを参照してください。

5. 変更内容を保存するには、「保存」または「ページの保存と実行」をクリックします。

関連項目:

「ページ・デザイナの右ペイン(プロパティ・エディタ)」および「フィールドレベル・ヘルプの表示」

7.4.2 ページ・デザイナを使用したJavaScriptの組込み

JavaScriptグループの属性を編集することによって、ページにJavaScriptを含めることができます。これは、ページに固有のファンクションに有効な方法であり、ファンクションを.jsファイルに組み込む前にテストを行う有効な方法です。

次の例では、コードを追加することによって、カレント・ページの任意の場所からtestファンクションにアクセスできるようにしています。

JavaScriptコードをJavaScript属性に追加するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. ページを選択します。

ページ・デザイナが表示されます。

2. 「レンダリング」タブで、ページ名を選択します。
プロパティ・エディタにページ属性が表示されます。

3. 「すべて閉じる」アイコンをクリックして、「JavaScript」を見つけて展開します。

4. 「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.');
}

5. 「保存」をクリックします。

7.4.3 ページ・デザイナでのセッションの再結合の構成

リージョンの再結合属性は、既存のセッションの結合(ディープ・リンクと同等)に対するサポートを制御します。技術的に、この属性は、このアプリケーションに対するURLにセッションIDを含むかどうかを決定します。

警告:

セッションの再結合を有効にすると、攻撃者が既存のエンド・ユーザー・セッションを乗っ取ることが可能になるため、アプリケーションのセキュリティが侵害される可能性があります。詳細は、「セッションを再結合」についてを参照してください。

セッションの再結合を使用するには、管理者がインスタンス・レベルでセッションの再結合を有効化する必要があります。インスタンス・レベルでのセッションの再結合のより制限的な値は、アプリケーションおよびページ設定をオーバーライドします。

ページ・デザイナでセッションの再結合を構成するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. ページを選択します。

ページ・デザイナが表示されます。

2. 「レンダリング」タブで、ページ名を選択します。
プロパティ・エディタにページ属性が表示されます。

3. 「すべて閉じる」アイコンをクリックして、「セキュリティ」を見つけて展開します。

4. 「セキュリティ: セッションを再結合」で、オプションを選択します。

- アプリケーション・デフォルト - アプリケーション・レベルで定義されている設定を継承します。

- 無効 - URLにセッションIDが含まれていない場合、Application Expressは新しいセッションを作成します。

- パブリック・セッションに対して有効 - URLがパブリック・ページのもので、セッションIDが含まれていない場合、Application Expressはそのアプリケーションに対して確立された既存のセッションCookieの利用を試みます。Application Expressは、セッションがまだ認証されていない場合にのみCookieを使用して結合します。
オプション「パブリック・セッションに対して有効」では、「フレームへの埋込み」を「同じ起点から許可」または「拒否」に設定する必要があります。これはURLペイロードの条件に関連付けられませんが、セッション・ステート保護されるURLにも適用されます。

- すべてのセッションに対して有効 - URLにセッションIDが含まれておらず、次の条件が満たされる場合、Application Expressはそのアプリケーションに対して確立された既存のセッションCookieの利用を試みます。

- セッション・ステート保護がそのアプリケーションに対して有効で、URLに有効なチェックサムが含まれています。パブリック・ブックマークの場合、最も制限的なアイテム・レベルの保護は「制限なし」または「チェックサムが必要 - アプリケーション・レベル」である必要があります。

- URLにペイロードは含まれていません(リクエスト・パラメータ、クリア・キャッシュまたはデータ値ペア)。
この設定では、アプリケーションの「フレームへの埋込み」が「同じ起点から許可」または「拒否」に設定されている必要もあります。

ヒント:

「アプリケーション・デフォルト」オプションは、アプリケーション・レベルで定義されている設定を継承します。ブラウザ・セキュリティを参照してください。

5. 「保存」をクリックします。

関連項目:

- ブラウザ・セキュリティ

- 「セッションを再結合」について

- 『Oracle Application Express管理ガイド』のセッションの再結合の構成に関する項

7.4.4 ページ・デザイナでのダイアログ属性の構成

ヒント:

ダイアログ・ページの作成は、複数ステップのプロセスです。詳細は、ダイアログ・ページの作成を参照してください。

ページ・デザイナでダイアログ属性を構成するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. ページを選択します。

ページ・デザイナが表示されます。

2. 「レンダリング」タブで、ページ名を選択します。
プロパティ・エディタにページ属性が表示されます。

3. 「すべて閉じる」アイコンをクリックします。

4. 「外観」を見つけて展開し、「ページ・モード」が「モーダル・ダイアログ」または「非モーダル・ダイアログ」のいずれかに設定されていることを確認します。

5. 「ダイアログ」を展開して、次の属性を構成します。

ヒント:

属性のヘルプを表示するには、プロパティ・エディタで属性を選択し、中央ペインで「ヘルプ」タブをクリックします。

a. 幅

b. 高さ

c. 最大幅

d. 属性

e. CSSクラス

f. チェーン

6. 変更内容を保存するには、「保存」または「ページの保存と実行」をクリックします。

関連項目:

ダイアログ・ページの作成およびページ・デザイナの右ペイン(プロパティ・エディタ)

7.4.5 保存されていない変更についてユーザーに警告するためのページ属性の構成

開発者は「保存されていない変更の警告」ページ属性を有効にして、ユーザーがページから移動しようとしたときに、保存されていない変更について警告できます。

「保存されていない変更の警告」ページ属性を有効にするには、次のステップを実行します。

1. ページ・デザイナでページを表示します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. ページを選択します。

ページ・デザイナが表示されます。

2. 「レンダリング」タブで、ページ名を選択します。
プロパティ・エディタにページ属性が表示されます。

3. 「すべて閉じる」アイコンをクリックして、「ナビゲーション」を見つけて展開します。

ヒント:

属性を検索するには、「フィルタ・プロパティ」フィールドにキーワードを入力します。属性が表示されます。

4. ユーザーに警告するには、「保存されていない変更の警告」で、「はい」を選択します。

5. 「保存」をクリックします。

ヒント:

「保存されていない変更の警告」属性は、apex.page.warnOnUnsavedChanges APIを使用して実装されます。

関連項目:

- 「保存されていない変更についてユーザーに警告するためのボタン属性の構成」

- 「保存されていない変更についてユーザーに警告するためのアイテム属性の構成」

- Oracle Application Express APIリファレンス

7.5 ページ・デザイナからのページの実行

Application Expressエンジンは、データベース表に格納されたデータに基づいて、ページを動的にレンダリングおよび処理します。レンダリングされたアプリケーションを表示するには、アプリケーションを実行するか、またはApplication Expressエンジンに送信します。

ヒント:

「ページの保存と実行」ボタンを使用して、モーダルおよび非モーダル・ダイアログ・ページを直接実行することはできません。モーダルおよび非モーダル・ダイアログ・ページを表示するには、ダイアログ・ページを開くことのできる通常のページを実行して、そこからアクセスします。

ページ・デザイナでページを実行するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。ページ・デザイナでのページの表示を参照してください。

ページを実行してプレビューします。アプリケーション・ページを実行すると、エンド・ユーザーに表示されるとおりにレンダリングされたバージョンが表示されます。

2. 右上隅の「ページの保存と実行」ボタンをクリックします。「ページの保存と実行」ボタンは、青い右向きの矢印の形です。

レンダリングされたアプリケーション・ページが表示されます。

関連項目:

アプリケーションまたはページの実行および実行時開発者ツールバー

7.6 実行時開発者ツールバー

デスクトップ・アプリケーションを実行してページを表示する場合は、編集可能な実行中のページの下部に、実行時開発者ツールバーが表示されます。「開発者」ツールバーを使用すると、迅速に、カレント・アプリケーションまたは現在実行されているページを編集したり、セッション・ステートを表示することができます。

ヒント:

実行時開発者ツールバーは、アプリケーション定義ページの「可用性」、「ステータス」属性が「開発者ツールバーで使用可能」に設定されている場合にのみ表示されます

注意:

実行時開発者ツールバーは、ロックされたパッケージ・アプリケーション・ページまたはjQuery Mobileスマートフォン・ページには表示されません。

実行時開発者ツールバーには、次のコントロールが含まれています。

- ホーム: ワークスペースのホームページにリンクします。ワークスペースのホームページの理解を参照してください。

- 「アプリケーション」: アプリケーションのホームページにリンクします。アプリケーション・ビルダーのホームページの使用を参照してください。

- 「ページの編集」: 現在実行中のページIDを表示します。

- セッション: カレント・ページのセッション・ステート情報にリンクします。「セッション・ページの使用」を参照してください。

- デバッグの表示: デバッグ・レポートを表示します。「セッション・ページの使用」を参照してください。

- デバッグ: ページを「デバッグ」モードと「デバッグなし」モードとの間で切り替えます。「デバッグ・モードの使用」を参照してください。

- レイアウト列の表示: 「レイアウト列の表示」と「レイアウト列の非表示」との間で切り替えます。このオプションは、レイアウトが使用され、そのレイアウトでレイアウト列の表示がサポートされ、ページに複数の列がある場合にのみ適用されます。

- クイック編集: 開発者が、クイック編集モードを開始するか、ライブ・テンプレート・オプションにアクセスできます。

- クイック編集モードでのアクセス: 「クイック編集」をクリックして、目的のコンポーネントを選択すると、ページ・デザイナでそのコンポーネントに即時にアクセスできます。クイック編集モードを終了するには、[Esc]を押すかコンポーネントの外側をクリックします。

- ライブ・テンプレート・オプションの編集: 「クイック編集」をクリックして、テンプレート・オプションを変更するコンポーネントの上にマウスを移動して、右上隅のレンチ・アイコンをクリックします。ライブ・テンプレート・オプションを変更するためのクイック編集の使用を参照してください。

テーマ・ローラー: カラー・ピッカーから色を選択したり値を設定することで、アプリケーションの外観を簡単にカスタマイズできます。「テーマ・ローラー」をサポートしているテーマにのみ表示されます。テーマ・スタイルの使用を参照してください。

- 開発者ツールバー・オプション: 右端に表示され、機械の歯車のような形をしています。「開発者ツールバー・オプション」をクリックすると、実行時開発者ツールバーの表示方法をカスタマイズできます。使用可能なコントロールは次のとおりです。

- 自動非表示

- アイコンのみの表示

- 表示位置 (上、左、下、右)

7.7 ページ・デザイナでのデータベース・アプリケーション・ページのコピー

現在のアプリケーションまたは別のアプリケーションからページをコピーできます。コピー・プロセス中に、共有コンポーネントのコピーや、ターゲット・アプリケーションの共有コンポーネントへのマッピングを変更することもできます。

ページをコピーする手順は次のとおりです。

1. ページ・デザイナで、コピーするページを表示します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. ページを選択します。

ページ・デザイナが表示されます。

2. ページ・デザイナ・ツールバーで、「作成」メニューをクリックして「コピーとしてのページ」を選択します。

3. 「ページのコピー・オプション」で、次のいずれかを選択して、「次へ」をクリックします。

- このアプリケーションのページ

- 別のアプリケーションのページ

4. 画面に表示されるステップに従います。

7.8 ページ・デザイナでのページの削除

ページを削除すると、対応する表、ブレッドクラムおよびリスト・エントリが削除されます。

トピック:

- ページ・デザイナでのページの削除

- 複数のページの削除

- ページの範囲の削除

関連項目:

ページのロックおよびロック解除

7.8.1 ページ・デザイナでのページの削除

ページ・デザイナでページを削除するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. ページを選択します。

ページ・デザイナが表示されます。

2. ページ番号を確認します。

3. ページ・デザイナ・ツールバーで、「ユーティリティ」メニューを選択して「ページの削除」をクリックします。

ページの削除の確認ページが表示されます。

4. 「ページを完全に削除」をクリックします。

関連項目:

ページ・デザイナ・ツールバー

7.8.2 複数のページの削除

複数ページを削除するには、次のステップを実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「ユーティリティ」をクリックします。

4. 「ページ固有のユーティリティ」で、「クロス・ページ・ユーティリティ」をクリックします。

5. 「複数のページの削除」をクリックします。

6. 削除するページを選択し、「ページの削除」をクリックします。

7.8.3 ページの範囲の削除

ページの範囲を削除するには、次のステップを実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「ユーティリティ」をクリックします。

4. 「ページ固有のユーティリティ」で、「クロス・ページ・ユーティリティ」をクリックします。

5. 「複数のページの削除」をクリックします。

6. 「範囲別ページの削除」タブをクリックします。

7. 削除するページを入力し、「ページの削除」をクリックします。

7.9 レガシー・コンポーネント・ビューからページ・デザイナへの切替え

コンポーネント・ビューは、アプリケーション・ページを編集するためのレガシー・ユーザー・インタフェースです。開発者はレガシー・コンポーネント・ビューではなくページ・デザイナを使用することをお薦めします。対話グリッド、Oracle JETベースのチャートなど特定のコンポーネントは、レガシー・コンポーネント・ビューを使用して管理できません。ページ・デザイナとは異なり、レガシー・コンポーネント・ビューでは、ページを視覚的に表したり、ページ・コンポーネントをドラッグ・アンド・ドロップすることができません。ページ上のコンポーネントの位置をプレビューするには、ページを実行する必要があります。

ヒント:

ページ・デザイナへの移行で開発者を支援するために、ページ・デザイナには「コンポーネント・ビュー」タブが含まれています。レガシー・コンポーネント・ビューの外観と同様、ページ・デザイナの「コンポーネント・ビュー」タブには、ユーザー・インタフェース要素とアプリケーション・ロジックがコンポーネント・タイプ別に表示されます。ただし、コンポーネントをクリックすると、プロパティ・エディタの右ペインで対応する属性がハイライトされます。「コンポーネント・ビュー」タブを参照してください。

重要:

コンポーネント・ビューはデフォルトで無効化されています。コンポーネント・ビューを有効にするには、ユーザー・プリファレンスを編集します。ユーザー・プリファレンスの編集を参照してください。

レガシー・コンポーネント・ビューからページ・デザイナに切り替えるには、次のステップを実行します。

1. コンポーネント・ビューでページを表示します。

2. ページ・デザイナに切り替えるには、ページ上部の「ページ・デザイナ」アイコンをクリックします。

ページ・デザイナが表示されます。

3. アプリケーションを選択します。

関連項目:

「レガシー・コンポーネント・ビューでのページの表示」および「ページ・デザイナからレガシー・コンポーネント・ビューへの切替え」

8 レポートの開発

Oracle Application Expressでは、レポートとは、SQL問合せの結果の書式を設定したものです。SQL問合せは、ウィザードを実行するか、またはSQL問合せを手動で定義することによって生成できます。

トピック:

- レポート・タイプについて

- レポートの作成

- 対話グリッドの管理

- 対話モード・レポートの管理

- クラシック・レポートの管理

- レポート・リージョンの出力

- フォームおよびレポートでのBLOBサポートの理解

関連項目:

フォームの開発およびデータベース・アプリケーション・コンポーネントの管理

8.1 レポート・タイプについて

データベース・アプリケーションを作成する場合、開発者は4つの基本レポート・タイプ(対話グリッド、対話モード・レポート、表のレポートとフォームまたはクラシック・レポート)を作成できます。これらの異なるレポート・タイプの主な違いは、エンド・ユーザーが、検索、フィルタ処理、ソート、列選択、ハイライトなどのデータ操作を行うことで、データの表示をカスタマイズできる範囲と方法です。

トピック:

- 対話グリッド

- 対話モード・レポート

- クラシック・レポート

- レポートとフォーム

8.1.1 対話グリッド

対話グリッドでは、検索およびカスタマイズ可能なレポートのデータのセットがユーザーに表示されます。機能面では、対話グリッドには、対話モード・レポートで使用可能な多くのカスタマイズ機能と、マウスやキーボードを使用して対話的にレポートを再配置する機能が含まれています。

ユーザーは「アクション」および「列ヘッダー」メニューを使用して、個々の列をロック、非表示、フィルタ、固定、ハイライトおよびソートできます。上級ユーザーは、列に対してブレークおよび集計を定義することもできます。また、ユーザーは対話グリッドの外観を直接カスタマイズできます。ユーザーはマウスやキーボードを使用して列の幅を変更したり、列をグリッド内の別の場所にドラッグ・アンド・ドロップすることができます。カスタマイズしたレポートは、プライベートまたはパブリックいずれかのレポートとして保存できます。対話グリッドの作成は、アプリケーションの作成ウィザードとページの作成ウィザードの両方でサポートされています。

次に、対話グリッドの例を示します。

次に、編集可能対話グリッドの例を示します。編集可能対話グリッドでは、ユーザーはページ上で直接データ・セットを追加、変更およびリフレッシュすることもできます。編集不能対話グリッドには追加のコントロールが含まれます。各行の開始部分に「行アクション」メニューが表示され、行を追加、編集、リフレッシュすることができます。「アクション」メニューの右側に「編集」、「保存」および「行の追加」ボタンも表示されます。

関連項目:

- Oracle Application Expressエンド・ユーザーズ・ガイド

- 対話グリッドの管理

- 既存の対話グリッドを編集可能にする

8.1.2 対話モード・レポート

対話モード・レポートは、SQL問合せの結果の書式を設定したものです。対話モード・レポートの作成は、アプリケーションの作成ウィザードとページの作成ウィザードの両方でサポートされています。レポートを作成する表を選択するか、カスタムSQL SELECT文を指定する表を選択します。対話モード・レポートは、デスクトップ・アプリケーションでのみサポートされます。エンド・ユーザーは、「アクション」メニューのオプションを選択することによって、レポートのレイアウトと表示されるデータをカスタマイズできます。

次に、対話モード・レポートの例を示します。

開発者は各ページに複数の対話モード・レポートを含めることができ、エンド・ユーザーが使用できる機能を制限できます(ダウンロードの無効化や列の非表示のサポートなど)。エンド・ユーザーがレポートを表示する場合、レポート機能はアプリケーションのすべてのレポートで同じです。

対話モード・レポートを表示する場合、エンド・ユーザーはデータの表示方法と対象をカスタマイズできます。デフォルトでは、対話モード・レポートには、検索バー、「アクション」メニュー、列ヘッダー・メニューおよび各行の最初の列の「編集」アイコンがあります。「アクション」メニューのオプションを使用して、ユーザーは、特定の列の非表示または表示、フィルタの適用、ハイライト処理、ソート処理などを行ってレポートのレイアウトを変更できます。また、ブレーク、集計、チャート、グループ化を定義し、ユーザー独自の計算を追加することもできます。カスタマイズしたレポートは、プライベートまたはパブリックいずれかのレポートとして保存できます。

関連項目:

- 「ページ・デザイナでの対話モード・レポートの編集」

- 「レガシー・コンポーネント・ビューでの対話モード・レポートの編集」

- 『Oracle Application Expressアプリケーション・エンド・ユーザー・ガイド』の対話モード・レポートの使用に関する項

8.1.3 クラシック・レポート

クラシック・レポートとは、SQL問合せの結果の書式を設定したものです。レポートを作成する表を選択するか、カスタムSQL SELECT文またはSQL SELECT文を戻すPL/SQLファンクションを指定する表を選択します。クラシック・レポートは、ソートおよび単純なフィルタ処理を除いて、エンド・ユーザーがカスタマイズすることはできません。クラシック・レポートの作成は、アプリケーションの作成ウィザードとページの作成ウィザードの両方でサポートされています。

次に、クラシック・レポートの例を示します。

クラシック・レポートを作成するには、開発者はテーブルを選択するか、SQL文を指定します。クラシック・レポートでは、一般的なキーワード検索機能、表示する行数を指定する機能および基本的な列のソート機能をサポートしています。

ヒント:

開発者は、レポート・テンプレート(特に、名前付き列テンプレート)を使用して、高度にカスタマイズされたレポートを作成できます。レポート・テンプレートを参照してください。

関連項目:

「ページ・デザイナでのクラシック・レポートの編集」および「レガシー・コンポーネント・ビューでのクラシック・レポートの編集」

8.1.4 レポートとフォーム

開発者は、表のレポートとフォームを作成できます。開発者は「レポート・タイプ」を選択して、レポートを対話グリッド、対話モード・レポートまたはクラシック・レポートにするかを決定できます。ユーザーは「編集」アイコンをクリックしてフォームにアクセスできます。

レポートとフォームの組合せは、アプリケーションの作成ウィザードとページの作成ウィザードの両方でサポートされています。アプリケーションの作成ウィザードとページの作成ウィザードの主な違いは、カスタマイズの量です。アプリケーションの作成ウィザードでは、開発者はレポート・タイプ(つまり、対話グリッド、対話モード・レポートまたはクラシック)と表を選択できます。ページの作成ウィザードでは、レポート・タイプの選択に加えて、開発者はブレッドクラムやナビゲーション・メニューを追加して構成するかどうかを指定し、それらを表示する列および順序を選択することもできます。

次に、対話グリッド・レポートおよびフォームの例を示します。

関連項目:

- 「対話グリッド」

- 「対話モード・レポート」

- 「クラシック・レポート」

8.2 レポートの作成

開発者は、ウィザードを実行するか、ページ・デザイナでリージョン・タイプをドラッグ・アンド・ドロップして、レポートを作成できます。

トピック:

- ウィザードを使用したレポートの作成

- ギャラリからのドラッグ・アンド・ドロップによるレポートの作成

8.2.1 ウィザードを使用したレポートの作成

アプリケーション・ビルダーには、レポートを生成できる多くの組込みウィザードが用意されています。開発者は、アプリケーションの作成ウィザード、ページの作成ウィザードおよびリージョンの作成ウィザードを使用してレポートを作成できます。使用可能なレポート・オプションは、選択したユーザー・インタフェース(デスクトップやモバイルなど)によって異なります。

トピック:

- アプリケーションの作成ウィザード実行時のレポート・オプション

- ページの作成ウィザード実行時のレポート・オプション

- アプリケーションの作成ウィザードを使用したレポートの作成

- ページの作成ウィザードを使用したレポートの作成

8.2.1.1 アプリケーションの作成ウィザード実行時のレポート・オプション

アプリケーションの作成ウィザードを実行したときに、ターゲット・ユーザー・インタフェースを選択します。選択したユーザー・インタフェースによって、使用可能なページ・タイプとレポート・オプションが決まります。

デスクトップ・アプリケーションで使用可能なレポート

デスクトップ・アプリケーションを作成している場合、アプリケーションの作成ウィザードで次のレポート・タイプがサポートされます。

表8-1 アプリケーションの作成ウィザード: デスクトップ・アプリケーションで使用可能なレポート

レポート・タイプ

説明

レポート

SQL問合せの書式設定された結果を含むページを作成します。開発者が、レポートを作成する表を選択するか、カスタムSQL SELECT文を指定する表を選択します。開発者は、ページ・ソース(表またはSQL問合せ)を選択した後で、レポート・タイプ(対話モード・レポート、対話グリッドまたはクラシック・レポート)を選択します。

レポートとフォーム

2ページのレポートとフォームの組合せを作成する表を選択します。次に、レポート・タイプ(対話モード・レポート、対話グリッドまたはクラシック・レポート)を選択します。 1ページ目では、更新する行を選択します。2ページ目では、レコードを追加するか、あるいは既存のレコードの更新または削除を行うことができます。

編集可能対話グリッド

対話グリッドでは、検索およびカスタマイズ可能なレポートのデータのセットがユーザーに表示されます。編集可能対話グリッドでは、ユーザーはページ上で直接データ・セットを追加、変更およびリフレッシュすることもできます。機能面では、対話グリッドには、対話モード・レポートで使用可能な多くのカスタマイズ機能と、マウスまたはキーボードを使用して対話的にレポートを再配置する機能が含まれています。対話グリッドを構築する表を選択します。

モバイル・アプリケーションで使用可能なレポート

モバイル・アプリケーションを作成している場合、アプリケーションの作成ウィザードで次のレポート・タイプがサポートされます。

表8-2 アプリケーションの作成ウィザード: モバイル・アプリケーションで使用可能なレポート・タイプ

ページ・タイプ

説明

リスト・ビュー

モバイル・アプリケーションのレスポンシブなレポートを作成します。レポートは、表の列を縮小して、各行に対するラベルやデータ・ペアのブロックのような外観の積上げ表示形式にすることによって機能します。この切替えは、レポートを水平に表示できる十分な領域がない場合に発生します。

列切替えレポート

モバイル・アプリケーションのレスポンシブなレポートを作成します。デフォルトでは、列切替えレポートはすべての列が同じ優先度に設定されて作成されます。ただし、開発者はレポート列属性を編集し、重要度に応じて列をランク付けできます。優先度がより低い列は、より狭い幅で表示されます(たとえば、優先度6の列は最初に非表示になり、優先度1の列は最後に非表示になります。)レポートには、エンド・ユーザーが表示する列を選択できる「列」ボタンが含まれています。

リフロー・レポート

モバイル・アプリケーションのレスポンシブなレポートを作成します。レポートを水平に表示できる十分な領域がない場合、レポートは、表の列を縮小して、各行に対するラベルやデータ・ペアのブロックのような外観の積上げ表示形式にすることによって機能します。

リスト・ビュー

モバイル・アプリケーションのリストにSQL問合せの結果を表示します。

リスト・ビューとフォーム

スマートフォンでデータの表示とナビゲーション用に最適化されます。

2ページのリスト・ビューとフォームの組合せを構築します。1ページ目では、「リスト・ビュー」から更新する行を選択します。2ページ目では、ユーザーは選択した表またはビューを更新できます。

関連項目:

アプリケーションの作成ウィザードを使用したレポートの作成、アプリケーションの作成ウィザードの実行中に使用可能なページ・タイプおよびレポートの開発

8.2.1.2 ページの作成ウィザード実行時のレポート・オプション

アプリケーションを作成するときに、ターゲット・ユーザー・インタフェースを選択します。選択したユーザー・インタフェースによって、使用可能なレポート・タイプが決まります。

デスクトップ・アプリケーションで使用可能なレポート

デスクトップ・アプリケーションを作成している場合、ページの作成ウィザードで次のレポートがサポートされます。

表8-3 ページの作成ウィザード: デスクトップ・アプリケーションのレポート

レポート・タイプ

説明

詳細情報

対話モード・レポート

対話モード・レポートは、SQL問合せの結果の書式を設定したものです。開発者が、レポートを作成する表を選択するか、カスタムSQL SELECT文を指定する表を選択します。エンド・ユーザーは、「アクション」メニューのオプションを選択することによって、レポートのレイアウトと表示されるデータをカスタマイズできます。

「対話モード・レポートの管理」を参照してください

対話グリッド

対話グリッドは、SQL問合せの結果の書式を設定したものです。開発者が、レポートを作成する表を選択するか、カスタムSQL SELECT文を指定する表を選択します。

エンド・ユーザーは、列メニューおよびソート・オプションを使用してレポート・レイアウトを変更したり、ドラッグ・アンド・ドロップで列を再配置したり、「アクション」メニューのオプションを使用してデータの表示方法を変更することができます。

対話グリッドは、編集可能にすることも、編集不能にすることもできます。対話グリッドが編集可能である場合、エンド・ユーザーは基礎となるデータを編集したり、行を追加および削除できます。ページの作成ウィザードを実行しているときに編集可能対話グリッドを作成するには、「編集が有効」オプションに対して「はい」を選択します。

対話グリッドの管理または既存の対話グリッドを編集可能にするを参照してください。

クラシック・レポート

SQL問合せの結果がフォーマット化されます。レポートを作成する表を選択するか、カスタムSQL SELECT文またはSQL SELECT文を戻すPL/SQLファンクションを指定する表を選択します。クラシック・レポートは、ソートおよび単純なフィルタ処理を除いて、エンド・ユーザーがカスタマイズすることはできません。

クラシック・レポートの管理を参照してください。

表のフォーム付きレポート

指定する表に基づいた対話グリッド・レポートとフォームを作成します。レポートに対して、レポート・タイプ(対話モード・レポート、対話グリッドまたはクラシック・レポート)を選択します。

適用されません。

Webサービスのレポート

Webサービスの結果でレポートを作成します。

Webサービスの実装を参照してください。

モバイル・アプリケーションで使用可能なレポート

モバイル・アプリケーションを作成している場合、ページの作成ウィザードで次のレポートがサポートされます。

表8-4 ページの作成ウィザード: モバイル・アプリケーションでサポートされるレポート

ページ・タイプ

説明

詳細情報

リスト・ビュー

リスト・ビューは、スマートフォンでのデータ表示およびナビゲーション用に最適化されています。

SQL問合せの書式設定された結果を含むページを作成します。リスト・ビューを作成する表を選択したり、リスト・ビュー・エントリに使用するデータベース列を選択します。

レポートの開発を参照してください。

列切替えレポート

モバイル・アプリケーションのレスポンシブなレポートを作成します。デフォルトでは、列切替えレポートはすべての列が同じ優先度に設定されて作成されます。ただし、開発者はレポート列属性を編集し、重要度に応じて列をランク付けできます。優先度がより低い列は、より狭い幅で表示されます。レポートには、エンド・ユーザーが表示する列を選択できる「列」ボタンが含まれています。

レポートの開発を参照してください。

リフロー・レポート

モバイル・アプリケーションのレスポンシブなレポートを作成します。レポートを水平に表示できる十分な領域がない場合、レポートは、表の列を縮小して、各行に対するラベルやデータ・ペアのブロックのような外観の積上げ表示形式にすることによって機能します。

レポートの開発を参照してください。

Webサービスのレポート

Webサービスの結果でレポートを作成します。

Webサービスの実装を参照してください。

8.2.1.3 アプリケーションの作成ウィザードを使用したレポートの作成

アプリケーションの作成ウィザードを実行すると、1つまたは複数のレポート・ページを含む新しいアプリケーションを作成できます。

アプリケーションの作成ウィザードを使用してレポートを作成するには、次のステップを実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. 「作成」ボタンをクリックします。

3. アプリケーション・タイプを選択して「次へ」をクリックします。

4. 「名前」は、次のようにします。

a. スキーマ: アプリケーションは、すべてのSQLを特定のデータベース・スキーマとして解析することで、権限を取得します。データベース・スキーマ所有者を指定します。

b. 名前: 開発者がアプリケーションを識別するための名前を入力します。

c. アプリケーション: アプリケーションを識別する整数値を指定します。アプリケーションIDは、Application Expressインスタンス内で一意である必要があります。3000から9000の範囲のアプリケーションIDは、Oracle Application Expressの内部使用向けに予約されています。

d. テーマ: テーマを選択します。テーマは、アプリケーション全体のレイアウトおよびスタイルの定義に使用するテンプレートのコレクションです。
使用可能なテーマを表示するには、「テーマを選択」をクリックします。標準テーマが表示されます。追加テーマを表示するには、「表示」リストから選択します。テーマを選択すると、アプリケーションによって自動的にサブスクライブされます。

e. テーマ・スタイル: テーマ・スタイルを選択します。テーマ・スタイルは、テーマ42および51などの新しいアプリケーションに対してのみ使用可能です。

f. 「次へ」をクリックします。

ヒント:

ログイン・ページと空白ページのみが含まれたインスタント・アプリケーションを作成するには、「アプリケーションの作成」ボタンをクリックします。

次に、ページをアプリケーションに追加します。

5. 「ページ」で、「ページの追加」をクリックします。

a. ページ・タイプの選択: 追加するページ・タイプを選択します。「アプリケーションの作成ウィザード実行時のレポート・オプション」を参照してください。
ページ・タイプに基づいて、表名の選択、レポート実装など異なる情報が求められます。詳細は、フィールドレベル・ヘルプを参照してください。「アクション」に現在選択されているページ・タイプが表示されます。選択ごとに、表名の選択、レポート実装など異なる情報のタイプが求められます。詳細は、フィールドレベル・ヘルプを参照してください。

b. 「ページの追加」をクリックします。
ページがページ上部に表示されます。ページを削除するには、「削除」アイコン(右側の列のX)をクリックします。

c. すべてのページが追加されるまで前のステップを繰り返します。

ヒント:

ウィザードを早期に終了して「アプリケーション・ビルダーのデフォルト値」を使用するには、「アプリケーションの作成」ボタンをクリックします。

d. 「次へ」をクリックします。

6. ページの追加が完了したら、「次へ」をクリックします。

7. 画面に表示されるステップに従います。

関連項目:

- テーマの使用

- テーマのサブスクリプションの理解

- テーマ・スタイルの使用

- データベース・アプリケーションの作成

8.2.1.4 ページの作成ウィザードを使用したレポートの作成

ページの作成ウィザードを実行すると、レポートを含む新しいページを既存のアプリケーションに追加できます。

ページの作成ウィザードを使用してレポートを作成するには、次のステップを実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「ページの作成」をクリックします。

4. 「ページの作成」で、次のステップを実行します。

a. ユーザー・インタフェース: ページのユーザー・インタフェースを選択します。

b. ページ・タイプの選択: 「レポート」を選択します。

c. 「次へ」をクリックします。

5. レポート・タイプを選択します。ページの作成ウィザード実行時のレポート・オプションを参照してください。
表示されるレポート・オプションは、アプリケーション・ユーザー・インタフェース(デスクトップ、jQuery Mobileスマートフォンなど)によって異なります。

6. 「次へ」をクリックします。

7. 画面に表示されるステップに従います。
属性の詳細は、フィールドレベル・ヘルプを参照してください。

ヒント:

この項では、アプリケーションのホームページからページの作成ウィザードを実行することによってレポートを作成する方法を説明しています。「作成」メニューをクリックして「ページ」を選択することによって、ページ・デザイナおよびコンポーネント・ビューでこのウィザードを実行することもできます。

関連項目:

「データベース・アプリケーションのページの管理」および「フィールドレベル・ヘルプの表示」

8.2.2 ギャラリからのドラッグ・アンド・ドロップによるレポートの作成

ヒント:

ギャラリからレポート・リージョンをドラッグ・アンド・ドロップするときに、基礎となるSQL問合せを指定する必要があります。

ギャラリからドラッグ・アンド・ドロップでレポートを追加するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. ページを選択します。

ページ・デザイナが表示されます。

2. 中央ペインの下部にあるギャラリで、作成するレポート・タイプを探します。

ギャラリに、ページに追加できるすべてのコントロールまたはコンポーネントが一覧表示されます。カーソルをコントロールまたはコンポーネントにあわせると、説明するツールチップが表示されます。

ヒント:

ギャラリからコンポーネントをドラッグ・アンド・ドロップする以外に、ギャラリでコンポーネントを右クリックしてコンテキスト・メニューを表示することもできます。「追加先」を選択して、コンポーネントを追加する位置を選択します。

3. 作成されるコンポーネント上でマウスをクリックしたまま、「レイアウト」タブの目的の位置にドラッグします。

適切な位置にマウスが配置されると、「レイアウト」タブが暗い黄色の四角形として表示されます。マウスを離して、コンポーネントをドロップします。コンポーネントは、コンポーネント・タイプによって決定される適切なドロップ位置にのみドロップできます。

追加するコンポーネント・タイプに基づいて、ページ・デザイナが次に必要な操作を示します。「メッセージ」タブに、対処する必要があるメッセージの数を示した赤または黄色のバッジが表示されます。

次に、SQL文が必要であることを示すエラー・メッセージが表示された新しい対話モード・レポート・リージョンの例を示します。

4. プロパティ・エディタで該当する属性を編集します。

ヒント:

属性のヘルプを表示するには、プロパティ・エディタで属性を選択し、中央ペインで「ヘルプ」タブをクリックします。

5. 変更を保存するには、「保存」をクリックします。ページを保存して実行するには、「ページの保存と実行」をクリックします。

関連項目:

「「メッセージ」タブ」

8.3 対話グリッドの管理

対話グリッドでは、検索およびカスタマイズ可能なレポートのデータのセットがユーザーに表示されます。編集可能対話グリッドでは、ユーザーはページ上で直接データ・セットを追加、変更およびリフレッシュすることもできます。機能面では、対話グリッドには、対話モード・レポートで使用可能な多くのカスタマイズ機能と、マウスまたはキーボードを使用して対話的にレポートを再配置する機能が含まれています。ユーザーは「アクション」および「列ヘッダー」メニューを使用して、個々の列に対して非表示、フィルタ、固定、ハイライト、ソート、コントロール・ブレークの作成を行うことができます。上級ユーザーは、列または列グループの下部に表示される集計を定義することもできます。

開発者は、ページ・デザイナでリージョン属性、対話グリッド属性および列属性を編集して、対話グリッドの動作を制御します。たとえば、対話グリッド属性の編集により、基礎となるデータが読取り専用か、ユーザーが編集できるかが決定されます。

注意:

対話グリッドの機能について参照するには、サンプル・アプリケーションのサンプル対話グリッドをインストールしてください。パッケージ・アプリケーションのインストールを参照してください。

トピック:

- 対話グリッドのリージョン属性の管理

- 対話グリッド属性の管理

- 対話グリッドの列属性の管理

- 実行中のアプリケーションでの対話モードのカスタマイズについて

- 対話グリッドの保存

関連項目:

既存の対話グリッドを編集可能にする

8.3.1 対話グリッドのリージョン属性の管理

Oracle Application Expressアプリケーションの各ページに、1つ以上のリージョンが含まれます。リージョンはページ上の領域で、対話グリッドなどのコンテンツのコンテナとして機能します。開発者は、リージョン属性を編集して、SQLソースの変更、リージョンのレイアウトと外観の変更、リージョン表示セレクタの定義およびリージョン条件の作成を実行できます。

トピック:

- 対話グリッドのリージョン属性の編集

- 既存の対話グリッドからのマスター・ディテールの作成

- 対話グリッドの条件付き表示

関連項目:

ページ・デザイナでのページの管理

8.3.1.1 対話グリッドのリージョン属性の編集

ページ・デザイナでリージョン・属性を編集するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. ページを選択します。

ページ・デザイナが表示されます。

2. 「レンダリング」タブで、リージョンを選択します。

プロパティ・エディタの右ペインにリージョン属性が表示されます。

属性は、機能グループに編成されます。これらのグループを展開または縮小するには、「共通の表示」、「すべて表示」、「すべて閉じる」および「すべて開く」アイコンをクリックします。

3. 属性を検索するには、「フィルタ・プロパティ」フィールドにキーワード検索を入力します。

その用語を含むグループと属性が表示されます。

4. 対象となる属性を編集します。

ヒント:

属性のヘルプを表示するには、プロパティ・エディタで属性を選択し、中央ペインで「ヘルプ」タブをクリックします。

5. 変更を保存するには、「保存」をクリックします。ページを保存して実行するには、「ページの保存と実行」をクリックします。

関連項目:

ページ・デザイナの右ペイン(プロパティ・エディタ)

8.3.1.2 既存の対話グリッドからのマスター・ディテールの作成

1ページのマスター・ディテールには、2つの関連する表またはビューに基づく2つの編集可能対話グリッドがあります。既存の対話グリッドがある場合は、次のことを実行して、別の関連する対話グリッドを追加できます。

- 親対話グリッドを作成します。

- 主キーを定義します(必要に応じて)。

- 子対話グリッドを作成します。

- 子対話グリッドに対して、マスター・リージョンとマスター列を指定します。

次の例では、ページの作成ウィザードを実行して、部門表EBA_DEMO_IG_DEPTに対して対話グリッドを作成する方法を示します。このウィザードでは親対話グリッドが作成され、ユーザーは主キーを定義できます。次に、従業員表EBA_DEMO_IG_EMPに対して子対話グリッドを作成します。

既存のグリッドの下に関連する対話グリッドを追加するには:

1. アプリケーションを作成します。

2. ページの作成ウィザードを実行します。「アプリケーション」ホームページで、「ページの作成」をクリックします

3. 「ページの作成」ウィザードで、次のステップを実行します。

a. ページ・タイプの選択 - 「レポート」、「対話グリッド」の順に選択します。

b. ページ属性 - 「ページ名」にDepartmentsと入力して「次へ」をクリックします。

c. ナビゲーション・メニュー - デフォルト値を受け入れ、「次へ」をクリックします。

d. 「レポート・ソース」で、次のステップを実行します。

- 編集が有効 - 「はい」を選択します。

- 表/ビューの名前 - EBA_DEMO_IG_DEPTを選択します。

- 主キー列 - DEPTNO (数値)を選択します。

- 「作成」をクリックします。

ページ・デザイナが表示されます。

4. 「ページの保存と実行」をクリックして、レンダリングされたバージョンの親対話グリッドを表示します。

次の図は、EBA_DEMO_IG_DEPT表に対して作成された編集可能対話グリッドを示しています。

5. ページ・デザイナに戻ります。実行時開発者ツールバーでページXの編集をクリックします。

6. EBA_DEMO_IG_EMP表に対して子対話グリッドを作成します。

a. ギャラリで、「リージョン」タブを見つけます。

b. 「リージョン」で、「対話グリッド」を右クリックします。

c. 「追加先」、コンテンツ本体、リージョン、「部門」、「後」の順に選択します。
「レンダリング」タブと「レイアウト」タブに、新規リージョンが赤で表示されます。

7. 新しい子リージョンを編集します。

a. 「レンダリング」タブで、新しいリージョンを選択します。

b. プロパティ・エディタで、リージョン属性を編集します。

注意:

属性を検索するには、プロパティ・エディタ上部の「フィルタ・プロパティ」フィールドに検索文字列を入力します。

- 指定、タイトル - Employeesと入力します。

- ソース、SQL問合せ: 問合せを入力します。

select EMPNO,
ENAME,
JOB,
MGR,
HIREDATE,
SAL,
COMM,
ONLEAVE,
DEPTNO
from EBA_DEMO_IG_EMP

- レイアウト、新規行の開始: 「はい」を選択します。

- 外観、テンプレート: 「標準」を選択します。

- マスター・ディテール、マスター・リージョン - リージョン、Departmentsを選択します。

8. 子対話グリッドに対して、マスター列としてDEPTNOを定義します。

a. 「レンダリング」タブの子対話グリッドの下で、「列」ノードを展開してDEPTNOを選択します。

b. プロパティ・エディタで、次のものを編集します。

- マスター・ディテール、マスター列: DEPTNOを選択します。

9. 「保存」をクリックします。ページを実行するには、「ページの保存と実行」をクリックします。

親Departmentにより、子Employeesの結果がフィルタ処理されます。

次に、子Employeesを編集可能にします。

10. 子Employeesを編集可能にするには、次のステップを実行します。

a. ページ・デザイナにアクセスします。「開発者」ツールバーで、「ページの編集XX」をクリックします。

b. 「レンダリング」タブのEmployeesの下で、「属性」を選択します。

c. プロパティ・エディタで、次のものを編集します。

- 編集、有効: 「はい」を選択します。

- 実行可能な操作 - 次の操作が有効化されていることを確認します: 「行の追加」、「行の更新」、「行の削除」。

11. 「保存」をクリックします。ページを実行するには、「ページの保存と実行」をクリックします。

子対話グリッドEmployeesが編集可能になりました

8.3.1.3 対話グリッドの条件付き表示

リージョン属性を編集することによって、対話グリッドを条件付きで表示するように選択できます。

対話グリッドを条件付きで表示するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. ページを選択します。

ページ・デザイナが表示されます。

2. 「レンダリング」タブで、リージョンを選択します。
プロパティ・エディタの右ペインにリージョン属性が表示されます。

3. プロパティ・エディタで「すべて閉じる」アイコンをクリックし、「サーバー側の条件」を見つけて展開します。

4. 「タイプ」で、条件タイプを選択して、画面に表示される手順に従います。

ページ・デザイナで属性を編集するとき、対処する必要があるエラーおよび警告が「メッセージ」タブに表示されます。「メッセージ」タブに、対処する必要があるメッセージの数を示した赤または黄色のバッジが表示されます。「メッセージ」タブをクリックして、メッセージを確認します。

ヒント:

属性のヘルプを表示するには、プロパティ・エディタで属性を選択し、中央ペインで「ヘルプ」タブをクリックします。

5. 変更を保存するには、「保存」をクリックします。ページを保存して実行するには、「ページの保存と実行」をクリックします。

8.3.2 対話グリッド属性の管理

対話グリッド属性では、対話グリッドの動作方法を制御します。たとえば、開発者はこれらの属性を使用して、エンド・ユーザーが基礎となるデータの編集、レポートのページ区切りの構成、エラー・メッセージの作成、ツールバーおよびダウンロード・オプションの構成、ユーザーがパブリック・レポートを保存できるかどうかの制御、およびアイコン・ビューと詳細ビューの追加を行えるかどうかを決定します。

トピック:

- 対話グリッド属性の編集

- 既存の対話グリッドを編集可能にする

- 対話グリッドのページ区切りの制御

- 対話グリッド・ツールバーのカスタマイズ

- ユーザーが対話グリッドでパブリック・レポートを保存できるようにする

- パブリック・レポートを保存できるユーザーの制限

- 対話グリッドでのアイコン・ビューの有効化

- 対話グリッドでの詳細ビューの有効化

関連項目:

ページ・デザイナでのページの管理

8.3.2.1 対話グリッド属性の編集

対話グリッド属性を編集するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. ページを選択します。

ページ・デザイナが表示されます。

2. 「レンダリング」タブで、対話グリッドを含むリージョンを見つけます。

3. リージョンで、「属性」ノードを選択します。

プロパティ・エディタに、プロパティ・エディタの属性が表示されます。

属性は、機能グループに編成されます。これらのグループを展開または縮小するには、「共通の表示」、「すべて表示」、「すべて閉じる」および「すべて開く」アイコンをクリックします。

4. 属性を検索するには、「フィルタ・プロパティ」フィールドにキーワード検索を入力します。その用語を含むグループと属性が表示されます。

5. 対象となる属性を編集します。

ヒント:

属性のヘルプを表示するには、プロパティ・エディタで属性を選択し、中央ペインで「ヘルプ」タブをクリックします。

6. 変更を保存するには、「保存」をクリックします。ページを保存して実行するには、「ページの保存と実行」をクリックします。

関連項目:

ページ・デザイナの右ペイン(プロパティ・エディタ)

8.3.2.2 既存の対話グリッドを編集可能にする

エンド・ユーザーは、列メニューおよびソート・オプションを使用してレポート・レイアウトを変更したり、ドラッグ・アンド・ドロップで列を再配置したり、「アクション」メニューのオプションを使用してデータの表示方法を変更することができます。ただし、開発者は、基礎となるデータが読取り専用であるか編集可能であるかをユーザーごとに決定します。対話グリッドが編集可能である場合、エンド・ユーザーは基礎となるデータを編集したり、行を追加、削除およびリフレッシュすることができます。編集可能対話グリッドには、ツールバーにデフォルトで「保存」ボタンが含まれます。開発者は決定できます

対話グリッドを編集可能にするには、次のステップを実行します。

1. ページ・デザイナでページを表示します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. ページを選択します。

ページ・デザイナが表示されます。

2. 「レンダリング」タブで、対話グリッドを含むリージョンを見つけます。

3. リージョンで、「属性」ノードを選択します。

プロパティ・エディタに、プロパティ・エディタの属性が表示されます。

4. プロパティ・エディタで、「すべて閉じる」アイコンをクリックして「編集」を展開します。

対話グリッドが編集可能である場合は、レコードを処理するプロセスが自動的に作成されます。「有効」が「はい」に設定されている場合、追加のオプションが表示されます。

次の編集オプションを構成します。

a. 有効: 「はい」を選択します。

b. 実行可能な操作: サポートされているデータ操作を選択します。オプションには、「行の追加」、「行の更新」、「行の削除」があります。

c. 許可された行操作列 - 行ごとに許可する操作を制御するには、SQL問合せに列を追加し、ここでその列を選択します。列値は、更新を許可する場合はU、削除を許可する場合はD、両方を許可する場合はUDにする必要があります。

d. 失われた更新タイプ: 失われた更新に対してデータを保護する方法を選択します。失われた更新は、2人以上のユーザーが同じデータを更新しようとしたときに、前のユーザーが行った更新が最後の更新によって上書きされる場合に発生します。このことを防ぐために、更新ではデータベース内の既存の列値と、レコードが最初に問い合されたときに取得された値をチェックできます。例は、ページ・デザイナのヘルプを参照してください。
オプションは次のとおりです。

- 行の値: データを最初に問い合せる場合、チェックサム値が計算されます。チェックサムは、すべての更新可能な列を文字列に連結し、一意の値を生成して計算されます。更新されたレコードをコミットすると、このチェックサムがチェックサム値と比較されます。

- 行バージョン列: データベース表にデータベース・トリガー(可能な場合)によってレコードが更新されるたびに増える列が含まれている場合、チェックサムを計算するかわりにこの列を使用できます。対話グリッドで複数の表のデータを更新する場合、このオプションはお薦めしません。

e. 失われた更新タイプ: 失われた更新に対してデータを保護する方法を選択します。失われた更新は、2人以上のユーザーが同じデータを更新しようとしたときに、最初のユーザーが行った更新が最後の更新によって上書きされる場合に発生します。これが起きるのを防ぐために、更新ではデータベース内の既存の列値と、レコードが最初に問い合されたときに取得された値をチェックできます。

f. 空の場合に行を追加: 対話グリッドに現在戻されるレコードがない場合に新しい行を追加するかどうかを指定します。有効にした場合、少なくとも1つのレコードが常に表示されるため、No Data Foundメッセージは表示されません。追加されたレコードは、更新されなかった場合、リージョンが保存されるときに挿入されません。

5. 変更を保存するには、「保存」をクリックします。ページを保存して実行するには、「ページの保存と実行」をクリックします。

関連項目:

ページ・デザイナの右ペイン(プロパティ・エディタ)

8.3.2.3 対話グリッドのページ区切りの制御

ページ区切りによって、結果セット内の表示される行数および現在の位置に関する情報が提供されます。

対話グリッドのページ区切りを変更するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. ページを選択します。

ページ・デザイナが表示されます。

2. 「レンダリング」タブで、対話グリッドを含むリージョンを見つけます。

3. リージョンで、「属性」ノードを選択します。

プロパティ・エディタに、プロパティ・エディタの属性が表示されます。

4. プロパティ・エディタで、「すべて閉じる」アイコンをクリックして「ページ区切り」を展開します。

ページ区切り属性によって、結果セット内の表示される行数および現在の位置に関する情報が提供されます。

ヒント:

属性のヘルプを表示するには、プロパティ・エディタで属性を選択し、中央ペインで「ヘルプ」タブをクリックします。

次の「ページ区切り」属性を構成します。

a. タイプ: オプションを選択します。

- ページ - 「アクション」メニュー、「書式」、「ページごとの行数」オプションでの選択に基づいて行が表示されます。追加の行がある場合、レポート・フッターにコントロールが追加され、ユーザーは行セット間を前後にナビゲートできるようになります。

- スクロール: 対話グリッドの高さを埋める行が表示されます。エンド・ユーザーがスクロールすると、必要に応じて追加の行が表示されます。

b. 総行数の表示: 「はい」または「いいえ」を選択します。
「はい」を選択すると、レポート・フッターに総行数が表示されます。このオプションを有効にすると、追加の問合せが必要となり、非常に大きいデータ・セットのパフォーマンスが妨げられる場合があります。

5. 変更を保存するには、「保存」をクリックします。ページを保存して実行するには、「ページの保存と実行」をクリックします。

ヒント:

対話グリッドのページ区切りの例を確認するには、サンプル・アプリケーションのサンプル対話グリッドをインストールします。パッケージ・アプリケーションのインストールを参照してください。

8.3.2.4 対話グリッド・ツールバーのカスタマイズ

すべての対話グリッドは、ページの上部にツールバーがあります。開発者は、ツールバーにどのコントロールが表示されるかカスタマイズしたり、ツールバーを削除できます。

注意:

この手順で説明するオプションの中には、対話グリッドが編集可能である場合にのみ適用されるものがあります。既存の対話グリッドを編集可能にするを参照してください。

対話グリッド・ツールバーをカスタマイズするには、次のステップを実行します。

1. ページ・デザイナでページを表示します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. ページを選択します。

ページ・デザイナが表示されます。

2. 「レンダリング」タブで、対話グリッドを含むリージョンを見つけます。

3. リージョンで、「属性」ノードを選択します。

プロパティ・エディタに、プロパティ・エディタの属性が表示されます。

4. プロパティ・エディタで、「すべて閉じる」アイコンをクリックしてツールバーを展開します。

ヒント:

属性のヘルプを表示するには、プロパティ・エディタで属性を選択し、中央ペインで「ヘルプ」タブをクリックします。

5. 「表示」で、「はい」または「いいえ」を選択して、レポートの上部にツールバーを表示するかどうかを決定します。

6. 「ボタン」で、ツールバーに表示されるボタンを選択します。

オプションは次のとおりです。

- リセット: 「リセット」では、すべてのカスタマイズ(フィルタ、列幅、並替えなど)が削除され、サーバーからレポート定義がリロードされます。

- 保存 - 「保存」は、対話グリッドが編集可能で、かつ、エンド・ユーザーに追加、更新または削除する権限がある場合にのみ機能します。保存では、ページ全体を保存せずに、対話グリッドに行われた変更のみが保存されます。

7. 「追加ボタン・ラベル」は、対話グリッドが編集可能である場合にのみ表示されます。「追加」ボタンの代替ラベルを入力します。デフォルト・ラベルは、「行の追加」です。

8. 変更を保存するには、「保存」をクリックします。ページを保存して実行するには、「ページの保存と実行」をクリックします。

ヒント:

ツールバー・ボタンの追加例を表示するには、サンプル・アプリケーションのサンプル対話グリッドをインストールして、レポート、ツールバー・ボタンの追加に移動します。パッケージ・アプリケーションのインストールを参照してください。

8.3.2.5 ユーザーが対話グリッドでパブリック・レポートを保存できるようにする

開発者がその機能を有効にした場合、ユーザーは対話グリッドをパブリック・レポートとして保存できます。パブリック・レポートはツールバーの「保存されたレポート」リストに表示され、すべてのユーザーが使用できます。ただし、パブリック・レポートを作成したユーザーのみが、そのレポートの保存、名前の変更または削除を行うことができます。

ヒント:

「パブリック・レポートの保存」属性は、認証されたユーザーのみが使用でき、定義済の認可スキームによってさらに制限されます。パブリック・レポートを保存できるユーザーの制限を参照してください。

エンド・ユーザーがパブリック・レポートを保存できるようにするには:

1. ページ・デザイナでページを表示します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. ページを選択します。

ページ・デザイナが表示されます。

2. 「レンダリング」タブで、対話グリッドを含むリージョンを見つけます。

3. リージョンで、「属性」ノードを選択します。

プロパティ・エディタに、プロパティ・エディタの属性が表示されます。

4. プロパティ・エディタで、「すべて閉じる」アイコンをクリックして「ユーザーの有効化」を展開します。

5. 「パブリック・レポートの保存」で、「はい」を選択します。

6. 変更を保存するには、「保存」をクリックします。ページを保存して実行するには、「ページの保存と実行」をクリックします。

8.3.2.6 パブリック・レポートを保存できるユーザーの制限

開発者は認可スキームを選択して、パブリック・レポートを保存できるユーザーを制限できます。エンド・ユーザーがパブリック・レポートを保存できるようにするには、この認可スキームがそのユーザーに対してTRUEと評価される必要があります。認可スキームを選択しない場合、すべてのユーザーがパブリック・レポートを保存できます。

パブリック・レポートを保存できるユーザーを制限するには:

1. ページ・デザイナでページを表示します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. ページを選択します。

ページ・デザイナが表示されます。

2. 「レンダリング」タブで、対話グリッドを含むリージョンを見つけます。

3. リージョンで、「属性」ノードを選択します。

プロパティ・エディタに、プロパティ・エディタの属性が表示されます。

4. プロパティ・エディタで、「すべて閉じる」アイコンをクリックして「ユーザーの有効化」を展開します。

5. 「パブリック・レポートの保存」で、「はい」を選択します。

6. 「パブリック・レポートの保存の認可」で、認可スキームを選択します。

認可スキームを選択して、パブリック・レポート定義を保存できるユーザーを制限します。エンド・ユーザーがパブリック・レポートを保存できるようにするには、この認可スキームがそのユーザーに対してTRUEと評価される必要があります。認可スキームを選択しない場合、すべてのユーザーがパブリック・レポートを保存できます。

7. 変更を保存するには、「保存」をクリックします。ページを保存して実行するには、「ページの保存と実行」をクリックします。

8.3.2.7 対話グリッドでのアイコン・ビューの有効化

対話グリッドはデータの様々なビューをサポートしています。グリッド・ビューはデフォルトで表示され、ユーザーはチャート・ビューを定義することもできます。開発者はオプションで、ビュー選択ボタン・グループにアイコン・ボタンを追加できます(次の図を参照)。

アイコン・ビューを利用するには、アイコン、ラベルおよびターゲット(つまり、リンク)を識別するために使用する列を指定します。

ヒント:

このビューの実際の例を参照するには、サンプル・アプリケーションのサンプル対話グリッドをインストールして、レポート、アイコン・ビューおよび詳細ビューを確認します。パッケージ・アプリケーションのインストールを参照してください。

トピック:

- 対話グリッドへのアイコン・ビューの追加

- 対話グリッドへのカスタム・アイコン・ビュー・リンクの追加

8.3.2.7.1 対話グリッドへのアイコン・ビューの追加

アイコン・ビューの重要な要件は、ビューの各アイテムが同じ幅と高さを持ち、アイテム・コンテンツがはみ出さないことです。幅と高さは、クラスa-IconList-itemの要素でCSSルールを使用して設定されます。

対話グリッドにアイコン・ビューを追加するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. ページを選択します。

ページ・デザイナが表示されます。

2. 「レンダリング」タブで、対話グリッドを含むリージョンを見つけます。

3. リージョンで、「属性」ノードを選択します。

プロパティ・エディタに、プロパティ・エディタの属性が表示されます。

4. プロパティ・エディタで、「アイコン・ビュー」を見つけて展開します。

5. 次の「アイコン・ビュー」属性を構成します。

ヒント:

属性のヘルプを表示するには、プロパティ・エディタで属性を選択し、中央ペインで「ヘルプ」タブをクリックします。

a. 表示: 「はい」を選択します。

b. カスタム - 「いいえ」を選択します。「はい」を選択すると、アイコン・ビュー・アイテムのマークアップを完全に制御できますが、HTMLマークアップについて完全に理解している必要があります。

c. アイコン・タイプ: アイコン・イメージ・ソースを保持する列タイプを選択します。「アイコンCSSクラス」を選択します。また、アイコンのCSSクラスである値を持つSQL文に列を追加する必要があります(フォントAPEXアイコン・クラス名)。「URLのイメージ」を選択して、URLおよびアイコン属性を含む列を指定することもできます。

d. アイコンCSS - アイコンCSSクラスを保持する列を選択します。

e. リンク・ターゲット: 「リンク・ビルダー - リンク・ターゲット」ダイアログを表示する「リンク・ターゲット」をクリックします。アイコン・リンクをマウスまたはキーボードでアクティブ化すると、定義されたリンク・ターゲットがたどられます。

f. ラベル列 - アイコン・アイテムに使用するラベルを含む列を選択します。

6. 変更を保存するには、「保存」をクリックします。ページを保存して実行するには、「ページの保存と実行」をクリックします。

8.3.2.7.2 対話グリッドへのカスタム・アイコン・ビュー・リンクの追加

カスタム・アイコン・ビュー・リンクでは、複数列を使用できるなど、アイコン・ビューのコンテンツをより柔軟に定義できます。

対話グリッドにカスタム・アイコン・ビュー・リンクを追加するには:

1. ページ・デザイナでページを表示します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. ページを選択します。

ページ・デザイナが表示されます。

2. 「レンダリング」タブで、対話グリッドを含むリージョンを見つけます。

3. リージョンで、「属性」ノードを選択します。

プロパティ・エディタに、プロパティ・エディタの属性が表示されます。

4. プロパティ・エディタで、「アイコン・ビュー」を見つけて展開します。

5. 次の「アイコン・ビュー」属性を構成します。

ヒント:

属性のヘルプを表示するには、プロパティ・エディタで属性を選択し、中央ペインで「ヘルプ」タブをクリックします。

a. 表示: 「はい」を選択します。

b. カスタム - アイコン・ビューのカスタム・リンクを定義するかどうかを指定します。このオプションでは、複数列を使用できるなど、アイコン・ビューのコンテンツをより柔軟に定義できます。「はい」または「いいえ」を選択します。

c. アイコン・タイプ: アイコン・イメージ・ソースを保持する列タイプを選択します。「アイコンCSSクラス」を選択します。また、アイコンのCSSクラスである値を持つSQL文に列を追加する必要があります(フォントAPEXアイコン・クラス名)。「URLのイメージ」を選択して、URLおよびアイコン属性を含む列を指定することもできます。

d. アイコンCSS - アイコンCSSクラスを保持する列を選択します。

e. リンク・ターゲット: 「リンク・ビルダー - リンク・ターゲット」ダイアログを表示する「リンク・ターゲット」をクリックします。リンク・ターゲットを定義します。アイコン・リンクをマウスまたはキーボードでアクティブ化すると、定義されたリンク・ターゲットがたどられます。

f. ラベル列 - アイコン・アイテムに使用するラベルを含む列を選択します。

6. 変更を保存するには、「保存」をクリックします。ページを保存して実行するには、「ページの保存と実行」をクリックします。

8.3.2.8 対話グリッドでの詳細ビューの有効化

対話グリッドはデータの様々なビューをサポートしています。デフォルトでは、グリッド・ビューは常に含められ、ユーザーはチャート・ビューを定義できます。オプションで詳細ビューを定義できます。このビューには、開発者が定義したHTMLマークアップを使用して列値が表示されます(次の図を参照)。

ヒント:

このビューの実際の例を参照するには、サンプル・アプリケーションのサンプル対話グリッドをインストールして、レポート、アイコン・ビューおよび詳細ビューを確認します。パッケージ・アプリケーションのインストールを参照してください。

トピック:

- 対話グリッドへの詳細ビューの追加

8.3.2.8.1 対話グリッドへの詳細ビューの追加

対話グリッドに詳細ビューを追加するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. ページを選択します。

ページ・デザイナが表示されます。

2. 「レンダリング」タブで、対話グリッドを含むリージョンを見つけます。

3. リージョンで、「属性」ノードを選択します。

プロパティ・エディタに、プロパティ・エディタの属性が表示されます。

4. プロパティ・エディタで、「詳細ビュー」を見つけて展開します。

5. 次の「詳細ビュー」属性を構成します。

a. 表示: 「はい」を選択します。

b. 行の前: レポート行の前に表示するHTMLを入力します。

c. 各行 - 詳細ビューで各レポート行に使用するHTMLテンプレートを入力します。列名および列ラベルに#COLUMN_NAME#置換文字列を使用します。

使用可能な置換文字列は次のとおりです。

- &COLUMN_NAME. - 列ラベルと名前の置換文字列。

- &APEX$ROW_ID. - 行のレコード識別子。

- &APEX$ROW_INDEX. - レコード表示順序番号。

次に例を示します。

<tr><td align="right">&ENAME_LABEL.:</td><td>&ENAME.</td></tr> <tr><td align="right">&JOB_LABEL.:</td><td>&JOB.</td></tr>

d. 行の後: レポート行の後に表示するHTMLを入力します。

6. 変更を保存するには、「保存」をクリックします。ページを保存して実行するには、「ページの保存と実行」をクリックします。

8.3.3 対話グリッドの列属性の管理

列属性により、開発者は、対話グリッド列の表示、機能および動作を制御できます。開発者は、これらの属性を使用して、レイアウトと外観の変更、検証の作成、列リンクの定義、列フィルタの作成、エクスポートおよび印刷のサポートの追加など、列の動作のほぼすべての面を変更できます。

注意:

一部の設定は、レポート開発者が実行時に構成し、プライマリまたは代替レポートの一部として保存します(列の表示順序、レポートがソートされる列、列幅など)。保存オプションの詳細は、「対話グリッドの保存」を参照してください。

トピック:

- グリッド列属性の編集

- フィルタのLOVとしての列定義

- 対話グリッドでの列リンクの作成

関連項目:

ページ・デザイナでのページの管理

8.3.3.1 グリッド列属性の編集

対話グリッドの列属性を編集するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. ページを選択します。

ページ・デザイナが表示されます。

2. 「レンダリング」タブで、リージョンを見つけて「列」ノードを展開します。

「レンダリング」タブに列が表示されます。

3. 編集する列を選択します

プロパティ・エディタにその列の属性が表示されます。属性は、機能グループに編成されます。これらのグループを展開または縮小するには、「共通の表示」、「すべて表示」、「すべて閉じる」および「すべて開く」アイコンをクリックします。

4. 属性を検索するには、「フィルタ・プロパティ」フィールドにキーワード検索を入力します。その用語を含むグループと属性が表示されます。

5. 対象となる属性を編集します。

ヒント:

属性のヘルプを表示するには、プロパティ・エディタで属性を選択し、中央ペインで「ヘルプ」タブをクリックします。

6. 列ヘッダーを編集するには、次のステップを実行します。

a. 「ヘッダー」を見つけて展開します。

b. 「ヘッダー」、「位置合せ」および「代替ラベル」属性を編集します。

7. 列値の表示方法を制御する手順、および編集可能グリッドの場合は列値の編集方法を制御する手順:

a. 「指定」を見つけて展開します。

b. 「タイプ」を選択します。
選択したタイプによって様々な設定を使用できます。編集可能グリッドで、タイプ「表示のみ」を選択して、列を編集不能にします。非表示にする必要のある主キー列、またはテンプレートにのみ使用されるその他の列(アイコンや詳細ビュー、リンク・ターゲット、タイプ「HTML式」の列など)に対して、タイプ「非表示」を選択します。

8. ユーザーが列を操作する方法を制御するには、次のステップを実行します。

a. 「ユーザーの有効化」を見つけて展開します。

b. 「ソート/コントロール・ブレーク/集計/グループ化」で、「はい」または「いいえ」を選択します。「はい」を選択すると、ユーザーがソート、コントロール・ブレーク、集計およびグループ化でこの列を使用できます。

ヒント:

これらの操作を有効化すると、特に大きいデータ・セットでパフォーマンスの問題が発生したり、必要な場合に列索引が使用できない可能性があります。

9. 変更を保存するには、「保存」をクリックします。ページを保存して実行するには、「ページの保存と実行」をクリックします。

関連項目:

ページ・デザイナの右ペイン(プロパティ・エディタ)

8.3.3.2 フィルタのLOVとしての列定義

対話グリッド列をLOVとして定義して、組込みフィルタ・ツールの速度を向上できます。

レポート列をLOVとして定義するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. ページを選択します。

ページ・デザイナが表示されます。

2. 「レンダリング」タブで、リージョンを見つけて「列」ノードを展開します。

3. 目的の列を選択します。

4. プロパティ・エディタで、「列フィルタ」を見つけて展開します。次のように指定します。

a. 有効: 「はい」または「いいえ」を選択して、ユーザーがこの列をフィルタできるかどうかを指定します。

b. LOVタイプ: ユーザーが列ヘッダーまたは「フィルタ」ダイアログでクリックしたときのフィルタのLOVを導出する方法を選択します。詳細は、ページ・デザイナのヘルプを参照してください。

5. 変更を保存するには、「保存」をクリックします。ページを保存して実行するには、「ページの保存と実行」をクリックします。

8.3.3.3 対話グリッドでの列リンクの作成

レポートからアプリケーション内の別のページまたはURLへのリンクを作成するには、「列属性」を使用します。

別のページへの列リンクを作成するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. ページを選択します。

ページ・デザイナが表示されます。

2. 「レンダリング」タブで、リージョンを見つけて「列」ノードを展開します。

3. 目的の列を選択します。

プロパティ・エディタに列属性が表示されます。

ヒント:

表示する情報の量を制御するには、「共通の表示」、「すべて表示」、「すべて閉じる」および「すべて開く」ボタンをクリックします。

4. 「指定」を展開します。「タイプ」から、「リンク」を選択します。

5. 「リンク」を展開して、「リンクが定義されていません」をクリックします。

「リンク・ビルダー - ターゲット」ダイアログが表示されます。選択したターゲット・タイプによって、次のステップが決まります。

6. 別のページへのリンクを作成するには、「リンク・ビルダー - ターゲット」ダイアログで次のステップを実行します。

a. タイプ: 「このアプリケーションのページ」を選択します。

b. ページ: ターゲット・ページ番号を指定します。

c. アイテムの設定: 「名前」および「値」を選択して、アイテムのセッション・ステートを指定します。

d. セッション・ステートのクリア、キャッシュのクリア: キャッシュをクリアするページ番号を指定します。複数ページを指定するには、ページ番号のカンマ区切りリストを入力します。

e. ページ区切りのリセット: 「はい」を選択して、このページのページ区切りをリセットします。

f. 詳細、リクエスト: 使用するリクエストを指定します。

g. 「OK」をクリックします。

7. 別のアプリケーションの別のページへのリンクを作成するには、「リンク・ビルダー - ターゲット」ダイアログで次のステップを実行します。

a. タイプ: 「別のアプリケーションのページ」を選択します。

b. アプリケーション: アプリケーションを指定します。

c. ページ: ターゲット・ページ番号を指定します。

d. アイテムの設定: 「名前」および「値」を選択して、アイテムのセッション・ステートを指定します。

e. セッション・ステートのクリア、キャッシュのクリア: キャッシュをクリアするページ番号を指定します。複数ページを指定するには、ページ番号のカンマ区切りリストを入力します。

f. ページ区切りのリセット: 「はい」を選択して、このページのページ区切りをリセットします。

g. 詳細、リクエスト: 使用するリクエストを指定します。

h. 「OK」をクリックします。

8. URLへのリンクを作成するには、「リンク・ビルダー - ターゲット」ダイアログで次のステップを実行します。

a. タイプ: 「URL」を選択します。

b. URL: URLアドレスを入力します。

c. 「OK」をクリックします。

9. 変更を保存するには、「保存」をクリックします。ページを保存して実行するには、「ページの保存と実行」をクリックします。

8.3.4 実行中のアプリケーションでの対話モードのカスタマイズについて

アプリケーションの実行中、ユーザー(エンド・ユーザーと開発者の両方)は、列メニューおよびソート・オプションを使用してレポート・レイアウトを変更したり、ドラッグ・アンド・ドロップで列を再配置したり、「アクション」メニューのオプションを使用してデータの表示方法を変更することができます。対話グリッドが編集可能である場合、ユーザーは基礎となるデータの編集、行の追加、行の削除および行のリフレッシュも実行できます。ユーザーは、対話グリッドをカスタマイズした後、保存できます。ただし、使用可能な保存機能は、ユーザー・タイプによって異なります。

関連項目:

- 既存の対話グリッドを編集可能にする

- 「対話グリッドの保存」

- Oracle Application Expressエンド・ユーザーズ・ガイド

8.3.5 対話グリッドの保存

ユーザーは、対話グリッドをカスタマイズした後、それをプライベート・レポートまたはパブリック・レポートとして保存できます。プライベート・レポートを作成したユーザーのみが、そのレポートを表示、保存、名前変更または削除できます。レポート開発者は、これ以外に、プライマリ・レポート(つまり、すべてのユーザーに対して表示されるレポート)を保存したり、複数のレポート・レイアウトをテストするために代替レポートを作成して保存することができます。

ヒント:

保存された対話グリッドの実際の例を参照するには、サンプル・アプリケーションのサンプル対話グリッドをインストールして、レポート、保存されたレポートを確認します。パッケージ・アプリケーションのインストールを参照してください。

トピック:

- ユーザー・タイプが使用可能な保存オプションに及ぼす影響

- 対話グリッドを保存するときの構成の依存関係について

- プライベート対話グリッドの保存

- パブリック対話グリッドの保存

- プライマリ対話グリッドの保存または名前変更

- 代替対話グリッドの保存

- 保存された対話グリッド・レポートの名前変更

- 保存された対話グリッド・レポートの削除

- 保存された対話グリッド・レポートのリセット

8.3.5.1 ユーザー・タイプが使用可能な保存オプションに及ぼす影響

ユーザーは、対話グリッドをカスタマイズした後、保存できます。ただし、使用可能な保存機能は、ユーザー・タイプによって異なります。

エンド・ユーザー

エンド・ユーザーは、次のものとして対話グリッドを保存できます。

- プライベート・レポート。プライベート・レポートを作成したユーザーのみが、そのレポートを表示、保存、名前変更または削除できます。すべてのユーザー(つまり、エンド・ユーザーおよび開発者)が対話グリッド・プライベート・レポートを作成できます。

- パブリック・レポート。すべてのユーザーがプライベート・レポートを表示できます。ただし、パブリック・レポートを作成したユーザーのみが、そのレポートの保存、名前の変更または削除を行うことができます。他のすべてのユーザーは、パブリック・レポートを表示し、新しいレポート名で保存できます。

ヒント:

エンド・ユーザーは、レポート開発者がその機能を有効にした場合にのみ、パブリック・レポートを保存できます。「ユーザーが対話グリッドでパブリック・レポートを保存できるようにする」を参照してください。

開発者

開発者は、プライベート・レポートとパブリック・レポート以外に、2つのレポート書式を保存できます。

- プライマリ・レポート。プライマリ・レポートは、すべてのユーザーに表示されます。新しいプライマリ・レポートの保存、名前変更、削除ができるのは開発者のみです。

- 代替レポート。開発者は、代替レポートを使用して、複数のレポート・レイアウトを作成できます。代替レポートの保存、名前の変更または削除ができるのは開発者のみです。

8.3.5.2 対話グリッドを保存するときの構成の依存関係について

カスタマイズされたバージョンの対話グリッドを保存する場合、ユーザーは、「アクション」メニューを選択した後、「レポート」をクリックし、「保存」または「名前を付けて保存」をクリックします。アプリケーション開発者がアプリケーション・レベルの認証スキームを定義した場合にのみ、エンド・ユーザーは保存のオプションにアクセスできます。

ユーザーが対話グリッドを保存できるかどうかに影響を及ぼすその他の構成の問題には、次のようなものがあります。

- 対話グリッド・ツールバーの可用性。開発者は、対話グリッドにツールバーを含めるかどうかを決定する、対話グリッドの属性「ツールバー」を編集できます。ツールバーが無効になっている場合は、「保存」および「名前を付けて保存」を含む「アクション」メニューのすべてのオプションを使用できなくなります。

- パブリック・レポートの保存のサポート。デフォルトでは、エンド・ユーザーはパブリック・レポートを保存できません。パブリック・レポートのサポートを有効にするには、開発者がレポート属性「ユーザーの有効化」、「パブリック・レポートの保存」を編集します。

関連項目:

- 認証によるユーザー・アイデンティティの証明

- 対話グリッド・ツールバーのカスタマイズ

- 「ユーザーが対話グリッドでパブリック・レポートを保存できるようにする」

8.3.5.3 プライベート対話グリッドの保存

すべてのユーザー(つまり、エンド・ユーザーと開発者の両方)がプライベート対話グリッドを保存できます。プライベート対話グリッドを表示、保存、名前変更、削除できるのは、それを作成したユーザーのみです。

プライベート対話グリッドを保存するには、次のステップを実行します。

1. 対話グリッドを実行します。

2. レポートをカスタマイズします(たとえば、列の表示/非表示または移動、フィルタの作成など)。

3. 「アクション」メニューをクリックします。

4. 「レポート」、「名前を付けて保存」の順に選択します。

5. 「レポート - 名前を付けて保存」ダイアログで、次のようにします。

- タイプ - 「プライベート」を選択します。

- 名前- レポートの名前を入力します。

- 「保存」をクリックします。

ツールバーの「保存されたレポート」リストの「プライベート」ヘッダーの下に、プライベート・レポートが表示されます。

8.3.5.4 パブリック対話グリッドの保存

すべてのユーザー(つまり、エンド・ユーザーと開発者の両方)がパブリック対話グリッドを保存できます。ただし、パブリック対話グリッドを作成したユーザーのみが、そのレポートの保存、名前の変更または削除を行うことができます。パブリック・レポートを作成していないユーザーは、パブリック・レポートを表示したり、「名前を付けて保存」オプションを使用して自分のコピーを作成したりできます。

注意:

エンド・ユーザーは、レポート開発者がその機能を有効にした場合にのみ、パブリック対話グリッドを保存できます。「ユーザーが対話グリッドでパブリック・レポートを保存できるようにする」を参照してください。

パブリック対話グリッドを保存するには、次のステップを実行します。

1. 対話グリッドを実行します。

2. レポートをカスタマイズします(たとえば、列の表示/非表示または移動、フィルタの作成など)。

3. 「アクション」メニューをクリックします。

4. 「レポート」、「名前を付けて保存」の順に選択します。

5. 「レポート - 名前を付けて保存」ダイアログで、次のようにします。

- タイプ - 「パブリック」を選択します。

- 名前- レポートの名前を入力します。

- 「保存」をクリックします。

ツールバーの「保存されたレポート」リストの「パブリック」ヘッダーの下に、パブリック・レポートが表示されます。

8.3.5.5 プライマリ対話グリッドの保存または名前変更

プライマリ対話グリッドは、すべてのユーザーに表示されます。開発者のみがプライマリ・レポートを保存または名前変更できます。プライマリ・レポートを削除することはできません。

プライマリ対話グリッドを保存または名前変更するには:

1. 開発者として対話グリッドを実行します。

2. プライマリ対話グリッドをカスタマイズした後に保存するには:

a. レポートをカスタマイズします(たとえば、列の表示/非表示または移動、フィルタの作成など)。

b. 「アクション」メニューをクリックします。

c. 「レポート」、「保存」の順に選択します。

3. プライマリ・レポートを名前変更するには:

a. 「アクション」メニューをクリックします。

b. 「レポート」、「編集」の順に選択します。
「レポート - 編集」ダイアログが表示されます。

c. 「名前」に新しい名前を入力し、「保存」をクリックします。

4. 「レポート」、「保存」の順に選択します。

複数のレポートが再定義された場合は、ツールバーの「保存されたレポート」リストの「デフォルト」ヘッダーの下に、プライマリ・レポートが表示されます。

8.3.5.6 代替対話グリッドの保存

開発者は代替レポートを使用して、オプションで複数のレポート・レイアウトを定義でき、それをすべてのユーザーが使用できます(定義されている場合、任意の認証スキームに準拠します)。代替レポートの保存、名前の変更または削除ができるのは開発者のみです。新しい代替レポートの保存、名前変更、削除ができるのは、対話グリッドを作成した開発者のみです。

代替対話グリッドを保存するには、次のステップを実行します。

1. 開発者として対話グリッドを実行します。

2. レポートをカスタマイズします(たとえば、列の表示/非表示または移動、フィルタの作成など)。

3. 「アクション」メニューをクリックします。

4. 「レポート」、「名前を付けて保存」の順に選択します。

- タイプ - 「代替」を選択します。

- 名前- レポートの名前を入力します。

- 認可 - このレポートを表示できるユーザーを制限するために、代替認可スキームを選択します。

- 「保存」をクリックします。

代替レポートは、ツールバーの「保存されたレポート」リストの「デフォルト」ヘッダーの下に表示されます。

8.3.5.7 保存された対話グリッド・レポートの名前変更

すべてのユーザーが、自分が作成した対話グリッド・レポートの名前を変更できます。

対話グリッド・レポートの名前を変更するには、次のステップを実行します。

1. 対話グリッドを実行します。

2. ツールバーの「保存されたレポート」リストから、レポートを選択します。

3. 「アクション」メニューをクリックした後、「レポート」、「編集」の順に選択します。

4. 「レポート - 編集」ダイアログで、次のようにします。

a. タイプ - 編集するレポートのタイプを選択します。

b. 名前 - 新しい名前を入力します。

c. 「保存」をクリックします。

ツールバーの「保存されたレポート」リストに、新しいレポート名が表示されます。

8.3.5.8 保存された対話グリッド・レポートの削除

すべてのユーザーが、自分が作成した対話グリッド・レポートを削除できます。

対話グリッド・レポートを削除するには、次のステップを実行します。

1. 対話グリッドを実行します。

2. ツールバーの「保存されたレポート」リストから、レポートを選択します。

3. 「アクション」メニューをクリックした後、「レポート」、「削除」の順に選択します。

確認のダイアログが表示されます。

4. リクエストを確認し、「OK」をクリックします。

ツールバーの「保存されたレポート」リストに、レポートが表示されなくなります。

8.3.5.9 保存された対話グリッド・レポートのリセット

すべてのユーザーが、対話グリッド・レポートを最後に保存されたバージョンにリセットできます。

対話グリッド・レポートをリセットするには、次のステップを実行します。

1. 対話グリッドを実行します。

2. ツールバーの「保存されたレポート」リストから、レポートを選択します。

3. レポートをカスタマイズします(たとえば、列の表示/非表示または移動、フィルタの作成など)。

4. レポートを最後に保存されたバージョンにリセットします。「アクション」メニューをクリックした後、「レポート」、「リセット」の順に選択します。

ヒント:

ツールバーの「リセット」ボタンをクリックすることもできます。

更新されたレポートが表示されます。

8.4 対話モード・レポートの管理

対話モード・レポートは、SQL問合せの結果の書式を設定したものです。開発者が、レポートを作成する表を選択するか、カスタムSQL SELECT文を指定する表を選択します。対話モード・レポートは、デスクトップ・ページでのみサポートされます。エンド・ユーザーは、「アクション」メニューのオプションを選択することによって、レポートのレイアウトと表示されるデータをカスタマイズできます。

トピック:

- ページ・デザイナでの対話モード・レポートの編集

- レガシー・コンポーネント・ビューでの対話モード・レポートの編集

- 対話モード・レポートへのリンクの設定

- 実行中のアプリケーションでの対話モード・レポートのカスタマイズ

8.4.1 ページ・デザイナでの対話モード・レポートの編集

デフォルトでは、対話モード・レポートの各行の最初の列には、検索バー、「アクション」メニュー、「列ヘッダー」メニューおよび「編集」アイコンがあります。ユーザーは、これらのコントロールを使用して、列の選択、フィルタの適用、ハイライトおよびソートを実行し、レポート・データのレイアウトを変更できます。開発者は、ページ・デザイナで対話モード・レポートをカスタマイズして、これらのコントロールの表示を構成できます。

トピック:

- ページ・デザイナでの対話モード・レポート・リージョン属性の編集

- ページ・デザイナでの対話モード・レポート列属性の編集

- 対話モード・レポートの列での条件付きリンクのフィルタ処理について

- ページ・デザイナでの対話モード・レポート属性の編集

- ページ・デザイナでの対話モード・レポート・ページ区切りの制御

- 対話モード・レポートの検索バーのカスタマイズ

- ページ・デザイナでの「アクション」メニューのカスタマイズ

- ページ・デザイナでの「アクション」メニューのダウンロード・オプションの構成

- ページ・デザイナでのリンク列の管理

- 対話モード・レポートでの列 リンクの作成

- 対話モード・レポートの条件付き表示

- 対話モード・レポートでのLOVとしての列定義

- 対話モード・レポートでの列の書式設定

- ページ・デザイナでのアイコン・ビューの有効化

- ページ・デザイナでの詳細ビューの有効化

- 対話モード・レポートの詳細属性の構成

関連項目:

- ページ・デザイナでのページの管理

- 「対話モード・レポートへのリンクの設定」

- 「実行中のアプリケーションでの対話モード・レポートのカスタマイズ」

- 『Oracle Application Express APIリファレンス』のAPEX_IRに関する説明

8.4.1.1 ページ・デザイナでの対話モード・レポート・リージョン属性の編集

ページ・デザイナでリージョン・属性を編集するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. ページを選択します。

ページ・デザイナが表示されます。

2. 「レンダリング」タブで、リージョンを選択します。

プロパティ・エディタの右ペインにリージョン属性が表示されます。

属性は、機能グループに編成されます。これらのグループを展開または縮小するには、「共通の表示」、「すべて表示」、「すべて閉じる」および「すべて開く」アイコンをクリックします。

3. グループまたは属性を検索するには、「フィルタ・プロパティ」フィールドにキーワードを入力します。その用語を含むグループと属性が表示されます。

4. 対象となる属性を編集します。

ヒント:

属性のヘルプを表示するには、プロパティ・エディタで属性を選択し、中央ペインで「ヘルプ」タブをクリックします。

5. 変更を保存するには、「保存」をクリックします。ページを保存して実行するには、「ページの保存と実行」をクリックします。

関連項目:

ページ・デザイナの右ペイン(プロパティ・エディタ)

8.4.1.2 ページ・デザイナでの対話モード・レポート列属性の編集

列属性を編集して、レポート・レイアウトを詳細に制御します。たとえば、これらの属性を使用して、列ヘッダーの変更、列の位置の変更、列の非表示化またはユーザーが列を操作できる方法の制御を行うことができます。

列属性を編集するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. ページを選択します。

ページ・デザイナが表示されます。

2. 「レンダリング」タブで、リージョンを見つけて「列」ノードを展開します。
「レンダリング」タブに列が表示されます。

3. 編集する列を選択します。

プロパティ・エディタにその列の属性が表示されます。

属性は、機能グループに編成されます。これらのグループを展開または縮小するには、「共通の表示」、「すべて表示」、「すべて閉じる」および「すべて開く」アイコンをクリックします。

4. 属性を検索するには、「フィルタ・プロパティ」フィールドにキーワード検索を入力します。
その用語を含むグループと属性が表示されます。

5. 対象となる属性を編集します。

ヒント:

属性のヘルプを表示するには、プロパティ・エディタで属性を選択し、中央ペインで「ヘルプ」タブをクリックします。

6. 列ヘッダーを編集するには、次のステップを実行します。

a. 「ヘッダー」を見つけて展開します。

b. 「ヘッダー」属性と「位置合せ」属性を編集します。

7. ユーザーが列を操作する方法を制御するには、次のステップを実行します。

a. 「ユーザーの有効化」を見つけて展開します。

b. 「ユーザーの有効化」で、属性ごとに「はい」または「いいえ」を選択して、ユーザーがレポートを操作する方法を制御します。

8. 変更を保存するには、「保存」をクリックします。ページを保存して実行するには、「ページの保存と実行」をクリックします。

関連項目:

対話モード・レポートの列での条件付きリンクのフィルタ処理についておよびページ・デザイナの右ペイン(プロパティ・エディタ)

8.4.1.3 対話モード・レポートの列での条件付きリンクのフィルタ処理について

対話モード・レポートにリンクである列値があり、かつ、レポート問合せにリンク・マークアップが構成されている場合は、列ヘッダー・メニューからこの値に対するフィルタを定義しようとすると、失敗します。Oracle Application Expressでは列ヘッダー・メニューでリンクを正しくレンダリングすることはできません。これは、列値自体が、フィルタの適用先として選択できるように、リンクとしてレンダリングされるためです。開発者が問合せロジックに基づいて条件付きでリンクをレンダリングする必要がある場合に、そのリンクが、宣言的列リンク・サポートを使用しないで、レポート問合せで定義されていることがあります。

列の条件付きリンクに対するフィルタ処理を機能させるために、開発者には次の2つのオプションがあります。

- オプション1: HTML式列を使用します。

1. リンクからリンク・テキストと同等のテキストを選択する問合せに別の列を追加し、my_link_displayの列の別名を定義します。この列の別名は、列ヘッダー・メニューで使用される値になります。

2. my_link列を「非表示列」タイプに変更します。

3. my_link_display列で、列ヘッダーをmy_link列と同じに設定し、「HTML式」を#MY_LINK#に設定します。デフォルトの「特殊文字をエスケープ」を「はい」のままにします。

4. ページを実行します。
必要に応じて、列の順序を変更して、新しい列が古い列と同じ位置になるようにします。「アクション」メニューを選択し、「列の選択」を選択します。

5. 新しいデフォルト・レポートを保存します。「アクション」メニューを選択し、「レポートの保存」、デフォルトのレポート設定として保存の順に選択します。

リンクはレポートで適切にレンダリングされ、フィルタを正しく設定するmy_link_display値が列ヘッダー・メニューでレンダリングされるようになりました。

- オプション2: リンク・テキストに対して問い合せることができるリンク列にカスタム列フィルタを使用します。

関連項目:

ページ・デザイナでの対話モード・レポート列属性の編集

8.4.1.4 ページ・デザイナでの対話モード・レポート属性の編集

対話モード・レポート属性では、レポート機能を制御します。たとえば、これらの属性を使用して、ページ区切りの構成、エラー・メッセージの作成、検索バー、「アクション」メニューおよびダウンロード・オプションの構成、ユーザーがレポートを保存するかどうかとその方法の制御、サポートされるビューの構成を行うことができます。

ページ・デザイナで対話モード・レポート属性を編集するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. ページを選択します。

ページ・デザイナが表示されます。

2. 「レンダリング」タブで、レポートを含むリージョンを見つけます。

3. 「リージョン」で、「属性」ノードを選択します。

プロパティ・エディタに、プロパティ・エディタのレポート属性が表示されます。

属性は、機能グループに編成されます。これらのグループを展開または縮小するには、「共通の表示」、「すべて表示」、「すべて閉じる」および「すべて開く」アイコンをクリックします。

4. 対象となる属性を編集します。

ヒント:

属性のヘルプを表示するには、プロパティ・エディタで属性を選択し、中央ペインで「ヘルプ」タブをクリックします。

5. 変更を保存するには、「保存」をクリックします。ページを保存して実行するには、「ページの保存と実行」をクリックします。

関連項目:

ページ・デザイナの右ペイン(プロパティ・エディタ)

8.4.1.5 ページ・デザイナでの対話モード・レポート・ページ区切りの制御

ページ区切りによって、結果セット内の行数および現在の位置に関する情報が提供されます。プロパティ・エディタの属性ページの「ページ区切り」属性から選択することによって、ページ区切りの表示方法を制御します。

対話モード・レポートのページ区切りを編集するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. ページを選択します。

ページ・デザイナが表示されます。

2. 「レンダリング」タブで、レポートを含むリージョンを見つけます。

3. 「リージョン」で、「属性」ノードを選択します。

プロパティ・エディタに、プロパティ・エディタのレポート属性が表示されます。

属性は、機能グループに編成されます。これらのグループを展開または縮小するには、「共通の表示」、「すべて表示」、「すべて閉じる」および「すべて開く」アイコンをクリックします。

4. 「ページ区切り」属性を構成します。

a. 「ページ区切り」を見つけて展開します。

b. タイプ - このレポートのページ区切りタイプを選択します。多くの場合、ページには、レポートの特定数の行のみが表示されます。それ以上の行を表示するには、アプリケーション・エンド・ユーザーはレポートの次のページにナビゲートする必要があります。

c. 表示位置 - レポートのページ区切りの表示位置を選択します。
ページ区切りを表示できるのは、レポートの上または下(あるいは両方)で、位置は左または右に設定できます。

5. 変更を保存するには、「保存」をクリックします。ページを保存して実行するには、「ページの保存と実行」をクリックします。

8.4.1.6 対話モード・レポートの検索バーのカスタマイズ

すべての対話モード・レポートには、そのページの上部に検索バーがあります。開発者は、どのコントロールが表示されるかカスタマイズしたり、検索バーを削除できます。

トピック:

- 対話モード・レポートの検索バー

- ページ・デザイナでの検索バーのカスタマイズ

- ページ・デザイナでの対話モード・レポートの検索バーの削除

8.4.1.6.1 対話モード・レポートの検索バー

すべての対話モード・レポートのページ上部には検索バーがあり、そこに、「検索列の選択」アイコン、「テキスト」領域、「実行」ボタンおよび「アクション」メニューの各コントロールが含まれています。

複数のレポートを保存した場合は、保存したレポートの選択リストが「実行」ボタンの右に表示されます。このリストを使用して、保存された特定のレポートを選択できます。複数のビューが構成されている場合、ビュー選択ボタン・グループも表示され、エンド・ユーザーはビューを切り替えることができます。プロパティ・エディタでレポート属性を構成することによって、ページ・デザイナで検索バーを削除したりカスタマイズすることができます。

関連項目:

「ページ・デザイナでの検索バーのカスタマイズ」および「ページ・デザイナでの対話モード・レポートの検索バーの削除」

8.4.1.6.2 ページ・デザイナでの検索バーのカスタマイズ

検索バーをカスタマイズするには、次のステップを実行します。

1. ページ・デザイナでページを表示します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. ページを選択します。

ページ・デザイナが表示されます。

2. 「レンダリング」タブで、レポートを含むリージョンを見つけます。

3. 「リージョン」で、「属性」ノードを選択します。

プロパティ・エディタに、プロパティ・エディタのレポート属性が表示されます。

属性は、機能グループに編成されます。これらのグループを展開または縮小するには、「共通の表示」、「すべて表示」、「すべて閉じる」および「すべて開く」アイコンをクリックします。

4. 「検索バー」を見つけて展開します。

5. 「検索バー」の下のオプションを構成します。

ヒント:

属性のヘルプを表示するには、プロパティ・エディタで属性を選択し、中央ペインで「ヘルプ」タブをクリックします。

表8-5に、「検索バー」属性を示します。

表8-5 プロパティ・エディタの「検索バー」属性

属性

説明

検索バーを含める

レポートの上部に検索バーを含めるには、「はい」を選択します。また、検索バーを含める場合は、表示する機能を完全にカスタマイズすることもできます。検索バーを含めない場合は、「いいえ」を選択します。

検索フィールド

検索条件の入力に使用するテキスト・フィールドが検索バーに表示されます。「はい」または「いいえ」を選択します。

ファインダ・ドロップ・ダウン

「検索」フィールド内に組み込まれており、表示される列のドロップダウン・リストを表示します。列を選択すると、検索は選択した列の値に対してのみ実行されます。「はい」または「いいえ」を選択します。対話モード・レポート内では、このオプションは「検索列の選択」として識別されます。

レポート選択リスト

プライマリ・レポート、代替レポート、パブリック・レポート、プライベート・レポートなど、ユーザーに使用可能なすべてのレポートのリストが表示されます。このリストは、プライマリ・レポート以外のレポートにユーザーがアクセス可能な場合にのみ表示されます。「はい」または「いいえ」を選択します。

関連項目: 対話モード・レポートの保存

ページごとの行数セレクタ

1ページに表示する行数の選択に使用する選択リストが表示されます。「はい」または「いいえ」を選択します。

関連項目: 対話モード・レポートの保存

検索ボタン・ラベル

検索ボタン・ラベルとして使用するテキストを指定します。

最大行数/ページ

「ページごとの行数セレクタ」に表示する最大数を入力します。

6. 変更を保存するには、「保存」をクリックします。ページを保存して実行するには、「ページの保存と実行」をクリックします。

8.4.1.6.3 ページ・デザイナでの対話モード・レポートの検索バーの削除

対話モード・レポートから検索バーを削除するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. ページを選択します。

ページ・デザイナが表示されます。

2. 「レンダリング」タブで、レポートを含むリージョンを見つけます。

3. 「リージョン」で、「属性」ノードを選択します。

プロパティ・エディタに、プロパティ・エディタのレポート属性が表示されます。

属性は、機能グループに編成されます。これらのグループを展開または縮小するには、「共通の表示」、「すべて表示」、「すべて閉じる」および「すべて開く」アイコンをクリックします。

4. 「検索バー」を見つけて展開します。

5. 「検索バーを含める」で、「いいえ」を選択します。

6. 変更を保存するには、「保存」をクリックします。ページを保存して実行するには、「ページの保存と実行」をクリックします。

8.4.1.7 ページ・デザイナでの「アクション」メニューのカスタマイズ

ヒント:

対話モード・レポートの「アクション」メニューの構造は、対話グリッドと一貫するように変更されました。以前の(またはレガシー)構造を使用するように対話モード・レポートの「アクション」メニューを変更するには、「共有コンポーネント」、「コンポーネント設定」に移動し、「対話モード・レポート」コンポーネントを構成します。対話モード・レポートの「アクション」メニューの構造の構成を参照してください。

「アクション」メニューは、対話モード・レポートの検索バーの「実行」ボタンの右側に表示されます。ユーザーは、「アクション」メニューを使用して、レポート情報の表示方法をカスタマイズします。開発者は、対話モード・レポートの「アクション」メニューに表示するオプションをカスタマイズできます。

「アクション」メニューをカスタマイズするには、次のステップを実行します。

1. ページ・デザイナでページを表示します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. ページを選択します。

ページ・デザイナが表示されます。

2. 「レンダリング」タブで、レポートを含むリージョンを見つけます。

3. 「リージョン」で、「属性」ノードを選択します。

プロパティ・エディタに、プロパティ・エディタのレポート属性が表示されます。

属性は、機能グループに編成されます。これらのグループを展開または縮小するには、「共通の表示」、「すべて表示」、「すべて閉じる」および「すべて開く」アイコンをクリックします。

4. 「アクション・メニュー」を見つけて展開します。

5. 「はい」または「いいえ」を選択することによって、「アクション・メニュー」の下のオプションを構成します。

6. 変更を保存するには、「保存」をクリックします。ページを保存して実行するには、「ページの保存と実行」をクリックします。

8.4.1.8 ページ・デザイナでの「アクション」メニューのダウンロード・オプションの構成

「アクション」メニューに「ダウンロード」オプションを追加すると、ユーザーが対話モード・レポートをカンマ区切りファイル(CSV)形式、HTML、Microsoft Excel (XLS)形式、Adobe Portable Document Format (PDF)、Microsoft Word Rich Text Format (RTF)、または電子メール添付のHTMLとしてダウンロードできます。Microsoft Excel (XLS)、Microsoft Wordリッチ・テキスト形式(RTF)、Adobe Portable Document Format(PDF)の各形式では、印刷サーバーの構成が必要です。Microsoft ExcelおよびMicrosoft Word形式ではBI Publisherも必要です。

警告:

レポートからPDF、XLS、Wordなどの拡張形式へのダウンロードには、32Kの制限があります。エンド・ユーザーが表示している列の数が多すぎる場合は、これらの拡張形式にデータをダウンロードしようとすると、エラーが発生することがあります。また、大きいデータ・セットでは、ダウンロードが完了するまでかなりの時間がかかる場合があります。

注意:

グループ化ビューおよびピボット・ビューでは、XLS、PDF、RTFのダウンロード形式は、有効化され、レポート・サーバーが構成されている場合でもサポートされません。

トピック:

- ダウンロード形式の有効化

- CSVダウンロードの有効化

- 電子メール・ダウンロードの有効化

8.4.1.8.1 ダウンロード形式の有効化

ダウンロード形式を構成するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. ページを選択します。

ページ・デザイナが表示されます。

2. 「レンダリング」タブで、レポートを含むリージョンを見つけます。

3. 「リージョン」で、「属性」ノードを選択します。

プロパティ・エディタに、プロパティ・エディタのレポート属性が表示されます。

属性は、機能グループに編成されます。これらのグループを展開または縮小するには、「共通の表示」、「すべて表示」、「すべて閉じる」および「すべて開く」アイコンをクリックします。

4. プロパティ・エディタですべての属性を縮小します。「すべて閉じる」アイコンをクリックします。

5. 次の属性を編集します。

a. 検索バー、検索バーを含める - 「はい」を選択します。

b. アクション・メニュー、ダウンロード - 「はい」を選択します。

ヒント:

「ダウンロード」で「いいえ」を選択すると、「アクション」メニューに「ダウンロード」メニューが表示されなくなります。ユーザーがデータを完全にダウンロードできなくするには、次のステップで説明するすべてのダウンロード形式の選択を解除します。

c. ダウンロード、ダウンロード形式 - ダウンロード形式を選択します。

- CSV

- HTML

- Email

- XLS。

- PDF

- RTF

ヒント:

「アクション」メニューに「ダウンロード」オプションが表示されるのは、ファイル形式を選択した場合のみです。「インスタンス管理」内でレポート・サーバーが定義されていない場合は、特定のオプションが表示されません。詳細は、『Oracle Application Express管理ガイド』のレポート出力の構成に関する説明を参照してください。

6. 変更を保存するには、「保存」をクリックします。ページを保存して実行するには、「ページの保存と実行」をクリックします。

関連項目:

- 「CSVダウンロードの有効化」

- 「電子メール・ダウンロードの有効化」

- 「PDFへのレポート出力について」

8.4.1.8.2 CSVダウンロードの有効化

CSVダウンロードのサポートを有効にするには、まずグローバリゼーション属性の編集ページで自動CSVエンコーディングを有効にする必要があります。グローバリゼーション属性のページへのアクセスおよび自動CSVエンコーディングを参照してください。

対話モード・レポートでCSVダウンロードを有効にするには:

1. ページ・デザイナでページを表示します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. ページを選択します。

ページ・デザイナが表示されます。

2. 「レンダリング」タブで、レポートを含むリージョンを見つけます。

3. 「リージョン」で、「属性」ノードを選択します。

プロパティ・エディタに、プロパティ・エディタのレポート属性が表示されます。

属性は、機能グループに編成されます。これらのグループを展開または縮小するには、「共通の表示」、「すべて表示」、「すべて閉じる」および「すべて開く」アイコンをクリックします。

ヒント:

属性のヘルプを表示するには、プロパティ・エディタで属性を選択し、中央ペインで「ヘルプ」タブをクリックします。

4. 検索バー、検索バーを含める - 「はい」を選択します。

5. アクション・メニュー、ダウンロード - 「はい」を選択します。

ヒント:

「ダウンロード」で「いいえ」を選択すると、「アクション」メニューに「ダウンロード」メニューが表示されなくなります。ユーザーがデータを完全にダウンロードできなくするには、次のステップで説明するすべてのダウンロード形式の選択を解除します。

6. ダウンロード、ダウンロード形式:

a. ダウンロード形式 - 「CSV」を選択します。

ヒント:

「アクション」メニューに「ダウンロード」オプションが表示されるのは、ファイル形式を選択した場合のみです。

b. CSVセパレータ - 列セパレータを定義します。値が入力されていない場合は、現行のNLS設定に応じて、カンマまたはセミコロンが使用されます。

c. CSV囲み文字 - デリミタ文字を入力します。この文字は、データ値の開始境界および終了境界を区切ります。デフォルトのデリミタは二重引用符(" ")です。

d. ファイル名 - ダウンロードされたドキュメントの名前を入力します。ファイル拡張子は指定しないでください。拡張子は自動的に追加されます。これを空白のままにすると、リージョン名がファイル名として使用されます。

7. 変更を保存するには、「保存」をクリックします。ページを保存して実行するには、「ページの保存と実行」をクリックします。

8.4.1.8.3 電子メール・ダウンロードの有効化

特定の電子メール・アドレスに静的HTMLレポートを送信するように「ダウンロード」オプションを構成します。

ヒント:

電子メール・ダウンロードは、認証済ページでのみサポートされています。公開ページで電子メール・ダウンロードを有効にする場合、「ダウンロード」ダイアログには電子メール・ダウンロード・オプションは表示されません。

電子メール・ダウンロードのサポートを有効にするには、Oracle Application Express管理者はインスタンス・レベルで電子メールを構成する必要があります。『Oracle Application Express管理ガイド』のメールの構成についての説明を参照してください。

電子メール・ダウンロードを有効にするには、次のステップを実行します。

1. ページ・デザイナでページを表示します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. ページを選択します。

ページ・デザイナが表示されます。

2. 「レンダリング」タブで、レポートを含むリージョンを見つけます。

3. 「リージョン」で、「属性」ノードを選択します。

プロパティ・エディタに、プロパティ・エディタのレポート属性が表示されます。

属性は、機能グループに編成されます。これらのグループを展開または縮小するには、「共通の表示」、「すべて表示」、「すべて閉じる」および「すべて開く」アイコンをクリックします。

ヒント:

属性のヘルプを表示するには、プロパティ・エディタで属性を選択し、中央ペインで「ヘルプ」タブをクリックします。

4. 検索バー、検索バーを含める - 「はい」を選択します。

5. アクション・メニュー、ダウンロード - 「はい」を選択します。

ヒント:

「ダウンロード」で「いいえ」を選択すると、「アクション」メニューに「ダウンロード」メニューが表示されなくなります。ユーザーがデータを完全にダウンロードできなくするには、次のステップで説明するすべてのダウンロード形式の選択を解除します。

6. ダウンロード形式 - 「電子メール」を選択します。

ヒント:

「アクション」メニューに「ダウンロード」オプションが表示されるのは、ファイル形式を選択した場合のみです。

7. 変更を保存するには、「保存」をクリックします。ページを保存して実行するには、「ページの保存と実行」をクリックします。

注意:

電子メール・ダウンロードから送信される電子メールには、電子メールの送信者を識別するシステム生成電子メール署名が含まれています。この署名は削除できません。

関連項目:

対話モード・レポートからの電子メール送信について

8.4.1.9 ページ・デザイナでのリンク列の管理

対話モード・レポートの左側には、「リンク列」が表示されます。開発者は、単一行ビュー、カスタム・ターゲットにリンクするようにリンク列を構成したり、レポートからリンク列を除外できます。

ヒント:

エンド・ユーザーはリンク列のソート、非表示、移動を行うことはできず、リンク列は列属性ページに定義されている標準の列リンクとは関係ありません。

トピック:

- 単一行ビューへのリンク

- 特定のページへのリンク

- URLへのリンク

- リンク列の除外

8.4.1.9.1 単一行ビューへのリンクの設定

対話モード・レポートで単一行ビューにリンクするには:

1. ページ・デザイナでページを表示します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. ページを選択します。

ページ・デザイナが表示されます。

2. 「レンダリング」タブで、レポートを含むリージョンを見つけます。

3. 「リージョン」で、「属性」ノードを選択します。

プロパティ・エディタに、プロパティ・エディタのレポート属性が表示されます。

属性は、機能グループに編成されます。これらのグループを展開または縮小するには、「共通の表示」、「すべて表示」、「すべて閉じる」および「すべて開く」アイコンをクリックします。

ヒント:

属性のヘルプを表示するには、プロパティ・エディタで属性を選択し、中央ペインで「ヘルプ」タブをクリックします。

4. 「リンク」属性を構成します。

a. 「リンク」を見つけて展開します。

b. リンク列 - 「単一行ビューへのリンク」を選択します。

c. 一意に行を識別する基準 - 「ROWID」または「一意列」を選択します。

「一意列」を選択した場合、「一意列」フィールドに列を指定します。

d. リンク・アイコン - デフォルトを使用するか、別のアイコンへのパスを指定します。

e. リンク属性 - 必要に応じて、<a href= >タグに含まれる追加の列リンク属性を指定します(リンク・ターゲット、クラス、スタイルなど)。

f. 認可スキーム - 認可スキームを選択して、リンク列と関連付けます。この認可スキームは、リンク列をレポートでレンダリングするためにTRUEと評価される必要があります。

g. 条件タイプ - このリンクをレンダリングするために満たす必要がある条件タイプをリストから選択します。

5. 「単一行ビュー」属性を構成します。

a. 「単一行ビュー」を見つけて展開します。

b. NULL値の除外 - 単一レコード・ビューでNULL列を非表示にするかどうかを指定します

c. 表示されている列のみ - 現在表示されている列のみを単一レコード・ビューに表示するかどうかを指定します。「いいえ」を指定すると、非表示のレポート列も単一レコード・ビューに表示できます。

6. 変更を保存するには、「保存」をクリックします。ページを保存して実行するには、「ページの保存と実行」をクリックします。

ヒント:

対話モード・レポートが単一行ビューにリンクされており、リンク・アイコンにALTテキストがないか、ALTテキストが空である場合、アクセシビリティを改善するために alt="単一行ビュー"が自動的に含められます。これは、ALTテキストを行に固有なものにすることで(たとえば、alt="View Row: #COLUMN_NAME#"。COLUMN_NAMEは現在の行を一意に識別する列である必要があります)、さらに改善できます。

8.4.1.9.2 特定のページへのリンク

特定のページにリンクするには、次のステップを実行します。

1. ページ・デザイナでページを表示します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. ページを選択します。

ページ・デザイナが表示されます。

2. 「レンダリング」タブで、レポートを含むリージョンを見つけます。

3. 「リージョン」で、「属性」ノードを選択します。

プロパティ・エディタに、プロパティ・エディタのレポート属性が表示されます。

属性は、機能グループに編成されます。これらのグループを展開または縮小するには、「共通の表示」、「すべて表示」、「すべて閉じる」および「すべて開く」アイコンをクリックします。

ヒント:

属性のヘルプを表示するには、プロパティ・エディタで属性を選択し、中央ペインで「ヘルプ」タブをクリックします。

4. 「リンク」属性を構成します。

a. 「リンク」を展開します。

b. リンク列 - 「カスタム・ターゲットへのリンク」を選択します。

c. ターゲット -

- 「ターゲット」フィールドをクリックします。
「リンク・ビルダー - ターゲット」ダイアログが表示されます。

- ターゲット・タイプ: 「このアプリケーションのページ」を選択します。

- ページ: ターゲット・ページ番号を選択します。

- アイテムの設定: 「名前」および「値」を選択して、アイテムのセッション・ステートを指定します。

- セッション・ステートのクリア、キャッシュのクリア: キャッシュをクリアするページ番号を指定します。複数ページを指定するには、ページ番号のカンマ区切りリストを入力します。

- セッション・ステートのクリア、ページ区切りのリセット - このページのページ区切りをリセットするには、「ページ区切りのリセット」で「はい」を選択します。

- 詳細、リクエスト: 使用するリクエストを指定します。

- 「OK」をクリックします。

d. リンク・アイコン - デフォルトを使用するか、別のイメージを指定します。

e. リンク属性 (オプション) - <a href= >タグに含まれる追加の列リンク属性を指定します(リンク・ターゲット、クラス、スタイルなど)。

5. 変更を保存するには、「保存」をクリックします。ページを保存して実行するには、「ページの保存と実行」をクリックします。

8.4.1.9.3 URLへのリンクの設定

URLにリンクするには、次のステップを実行します。

1. ページ・デザイナでページを表示します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. ページを選択します。

ページ・デザイナが表示されます。

2. 「レンダリング」タブで、レポートを含むリージョンを見つけます。

3. 「リージョン」で、「属性」ノードを選択します。

プロパティ・エディタに、プロパティ・エディタのレポート属性が表示されます。

属性は、機能グループに編成されます。これらのグループを展開または縮小するには、「共通の表示」、「すべて表示」、「すべて閉じる」および「すべて開く」アイコンをクリックします。

ヒント:

属性のヘルプを表示するには、プロパティ・エディタで属性を選択し、中央ペインで「ヘルプ」タブをクリックします。

4. 「リンク」属性を構成します。

a. 「リンク」を展開します。

b. リンク列 - 「カスタム・ターゲットへのリンク」を選択します。

c. ターゲット -

- 「ターゲット」フィールドをクリックします。
「リンク・ビルダー - ターゲット」ダイアログが表示されます。

- ターゲット・タイプ: 「URL」を選択します。

- 「OK」をクリックします。

d. リンク・アイコン - デフォルトを使用するか、別のイメージを指定します。

e. リンク属性 (オプション) - <a href= >タグに含まれる追加の列リンク属性を指定します(リンク・ターゲット、クラス、スタイルなど)。

5. 変更を保存するには、「保存」をクリックします。ページを保存して実行するには、「ページの保存と実行」をクリックします。

8.4.1.9.4 リンク列の除外

列リンクを除外するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. ページを選択します。

ページ・デザイナが表示されます。

2. 「レンダリング」タブで、レポートを含むリージョンを見つけます。

3. 「リージョン」で、「属性」ノードを選択します。

プロパティ・エディタに、プロパティ・エディタのレポート属性が表示されます。

属性は、機能グループに編成されます。これらのグループを展開または縮小するには、「共通の表示」、「すべて表示」、「すべて閉じる」および「すべて開く」アイコンをクリックします。

ヒント:

属性のヘルプを表示するには、プロパティ・エディタで属性を選択し、中央ペインで「ヘルプ」タブをクリックします。

4. 「リンク」属性を構成します。

a. 「リンク」を展開します。

b. リンク列 - 「リンク列の除外」を選択します。

5. 変更を保存するには、「保存」をクリックします。ページを保存して実行するには、「ページの保存と実行」をクリックします。

8.4.1.10 対話モード・レポートでの列 リンクの作成

レポートからアプリケーション内の別のページまたはURLへのリンクを作成するには、「列属性」を使用します。

別のページへの列リンクを作成するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. ページを選択します。

ページ・デザイナが表示されます。

2. 「レンダリング」タブで、リージョンを見つけて「列」ノードを展開します。
「レンダリング」タブに列が表示されます。

3. 編集する列を選択します。

プロパティ・エディタにその列の属性が表示されます。

属性は、機能グループに編成されます。これらのグループを展開または縮小するには、「共通の表示」、「すべて表示」、「すべて閉じる」および「すべて開く」アイコンをクリックします。

ヒント:

属性のヘルプを表示するには、プロパティ・エディタで属性を選択し、中央ペインで「ヘルプ」タブをクリックします。

4. 「指定」を展開します。「タイプ」から、「リンク」を選択します

5. 「リンク」を展開して、「リンクが定義されていません」をクリックします。
「リンク・ビルダー - ターゲット」ダイアログが表示されます。

6. 別のページへのリンクを作成するには、「リンク・ビルダー - ターゲット」ダイアログで次のステップを実行します。

a. タイプ: 「このアプリケーションのページ」を選択します。

b. ページ - ターゲット・ページ番号を指定します。

c. アイテムの設定: 「名前」および「値」を選択して、アイテムのセッション・ステートを指定します。

d. セッション・ステートのクリア、キャッシュのクリア: キャッシュをクリアするページ番号を指定します。複数ページを指定するには、ページ番号のカンマ区切りリストを入力します。

e. ページ区切りのリセット - 「はい」を選択して、このページのページ区切りをリセットします。

f. 詳細、リクエスト: 使用するリクエストを指定します。

g. 「OK」をクリックします。

7. URLへのリンクを作成するには、「リンク・ビルダー - ターゲット」ダイアログで次のステップを実行します。

a. タイプ: 「URL」を選択します。

b. URL: URLアドレスを入力します。

c. 「OK」をクリックします。

8. 変更を保存するには、「保存」をクリックします。ページを保存して実行するには、「ページの保存と実行」をクリックします。

8.4.1.11 対話モード・レポートの条件付き表示

リージョン属性を編集することによって、対話モード・レポートを条件付きで表示するように指定できます。

対話モード・レポートを条件付きで表示するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. ページを選択します。

ページ・デザイナが表示されます。

2. 「レンダリング」タブで、レポートを含むリージョンを見つけます。

3. 「レンダリング」タブで、レポートを含むリージョンを見つけて選択します。

プロパティ・エディタに、プロパティ・エディタのレポート属性が表示されます。

属性は、機能グループに編成されます。これらのグループを展開または縮小するには、「共通の表示」、「すべて表示」、「すべて閉じる」および「すべて開く」アイコンをクリックします。

4. サーバー側の条件を構成します。

a. 「サーバー側の条件」を見つけて展開します。

b. 「タイプ」で、条件タイプを選択して、画面に表示される手順に従います
ページ・デザイナは、ページを保存する前に対処する必要があるエラーおよび警告を通知します。「メッセージ」タブに、対処する必要があるメッセージの数を示した赤または黄色のバッジが表示されます

5. 変更を保存するには、「保存」をクリックします。ページを保存して実行するには、「ページの保存と実行」をクリックします。

ヒント:

Asynchronous JavaScript and XML (AJAX)が対話モード・レポート全体で使用されています。AJAXは非同期であるため、条件付き表示用に評価される値はセッション内に含まれている必要があります。指定した値に基づいて対話モード・レポートを条件付きで表示するには、:REQUEST値のかわりにページ・アイテムを使用します。条件付き表示で:REQUESTを使用した場合、対話モード・レポート機能が正しく動作しません。

8.4.1.12 対話モード・レポートでのLOVとしての列定義

対話モード・レポートでは、LOVを使用して組込みフィルタ・ツールの速度を向上できます。

レポート列をLOVとして定義するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. ページを選択します。

ページ・デザイナが表示されます。

2. 「レンダリング」タブで、レポートを含むリージョンを見つけます。

3. 「レンダリング」タブで「列」ノードを展開して、必要な列を選択します。

4. 列フィルタを構成します。

a. 「列フィルタ」を見つけて展開します

b. 「タイプ」で、レポート列ドロップ・ダウン・リストに表示されるフィルタの導出方法を選択します。オプションは次のとおりです。

- なし: LOVのフィルタが無効になります。

- 列タイプに基づくデフォルト: STRINGおよびNUMBERの列では固有の列値からLOVを導出します。DATE列では、事前定義された日付範囲からLOVを導出します。

- 「単語を含む」のフィルタ処理に定義済LOVを使用: 定義済LOVのSQL問合せからLOVを導出してcontainsフィルタを作成します。

- 完全一致のフィルタ処理に名前付きLOVを使用: 名前付きLOVからLOVを導出してequalフィルタを作成します。

- 「単語を含む」のフィルタ処理に名前付きLOVを使用: 名前付きLOVからLOVを導出してcontainsフィルタを作成します。

5. 変更を保存するには、「保存」をクリックします。ページを保存して実行するには、「ページの保存と実行」をクリックします。

8.4.1.13 対話モード・レポートでの列の書式設定

対話モード・レポートでHTML式を使用して、列の表示をさらにカスタマイズできます。

列の書式設定を定義するには、次の手順を実行します。

1. ページ・デザイナでページを表示します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. ページを選択します。

ページ・デザイナが表示されます。

2. 「レンダリング」タブで、レポートを含むリージョンを見つけます。

3. 「レンダリング」タブで「列」ノードを展開して、必要な列を選択します。

4. 列フィルタを構成します。

a. 「列の書式」を見つけて展開します

b. 「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#" alt="#EMPLOYEE_NAME#" title="#EMPLOYEE_NAME#">

5. 変更を保存するには、「保存」をクリックします。ページを保存して実行するには、「ページの保存と実行」をクリックします。

8.4.1.14 ページ・デザイナでのアイコン・ビューの有効化

デフォルトでは、ほとんどの対話モード・レポートはレポートとして表示されます。必要に応じて、列をアイコンとして表示できます。列をアイコンとして表示するように構成すると、「アイコンの表示」アイコンが検索バーに表示されます。

アイコン・ビューを利用するには、アイコン、ラベルおよびターゲット(つまり、リンク)を識別するために使用する列を指定します。これらの列は通常エンド・ユーザーには役立たないため、非表示になるように設定することをお薦めします。

トピック:

- 「アイコンの表示」ボタンの追加

- カスタム・アイコン・ビュー・リンクの追加

8.4.1.14.1 「アイコンの表示」ボタンの追加

対話モード・レポートにアイコン・ビューを追加するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. ページを選択します。

ページ・デザイナが表示されます。

2. 「レンダリング」タブで、レポートを含むリージョンを見つけます。

3. 「リージョン」で、「属性」ノードを選択します。

プロパティ・エディタに、プロパティ・エディタのレポート属性が表示されます。

属性は、機能グループに編成されます。これらのグループを展開または縮小するには、「共通の表示」、「すべて表示」、「すべて閉じる」および「すべて開く」アイコンをクリックします。

4. 「アイコン・ビュー」を構成します。

a. 「アイコン・ビュー」を見つけて展開します。

b. 「アイコン・ビュー」属性を構成します。

ヒント:

属性のヘルプを表示するには、プロパティ・エディタで属性を選択し、中央ペインで「ヘルプ」タブをクリックします。

i. 表示: 「はい」を選択します。

ii. カスタム・アイコン・ビュー: アイコン・ビューのカスタム・リンクを定義するかどうかを指定します。このオプションでは、複数列を使用できるなど、アイコン・ビューのコンテンツをより柔軟に定義できます。「はい」または「いいえ」を選択します。

iii. 1行当たりの行数: アイコン・ビューの1行当たりに表示するアイコンの数を選択します。値を5にすると、レポートの1行当たり5つのアイコンが表示されます。

iv. リンク列: アイコンのリンク・ターゲットを返す列を選択します。

v. イメージ・ソース列: イメージ・ソースを返す列を指定します。

vi. ラベル列: イメージ・ラベルを返す列を選択します。

5. 変更を保存するには、「保存」をクリックします。ページを保存して実行するには、「ページの保存と実行」をクリックします。

関連項目:

「カスタム・アイコン・ビュー・リンクの追加」

8.4.1.14.2 カスタム・アイコン・ビュー・リンクの追加

カスタム・アイコン・ビュー・リンクでは、複数列を使用できるなど、アイコン・ビューのコンテンツをより柔軟に定義できます。

カスタム・アイコン・ビュー・リンクを追加するには、次の手順を実行します。

1. ページ・デザイナでページを表示します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. ページを選択します。

ページ・デザイナが表示されます。

2. 「レンダリング」タブで、レポートを含むリージョンを見つけます。

3. 「リージョン」で、「属性」ノードを選択します。

プロパティ・エディタに、プロパティ・エディタのレポート属性が表示されます。

属性は、機能グループに編成されます。これらのグループを展開または縮小するには、「共通の表示」、「すべて表示」、「すべて閉じる」および「すべて開く」アイコンをクリックします。

4. 「アイコン・ビュー」を見つけて展開します。

5. 「アイコン・ビュー」属性を構成します。

a. 表示: 「はい」を選択します。

b. カスタム: 「はい」を選択します。

c. 1ページ当たりの列数 - アイコン・ビューの1行当たりに表示するアイコンの数を選択します。値を5にすると、レポートの1行当たり5つのアイコンが表示されます。

d. カスタム・リンク - アイコン・ビューの列リンクを入力します。次の例のように、列名に置換文字列を使用します。
<a href="#EMP_LINK#"><img src="#EMP_IMG#" title="#ENAME#" alt=""><br>#ENAME#</a>

6. 変更を保存するには、「保存」をクリックします。ページを保存して実行するには、「ページの保存と実行」をクリックします。

関連項目:

「カスタム・アイコン・ビュー・リンクの追加」

8.4.1.15 ページ・デザイナでの詳細ビューの有効化

デフォルトでは、ほとんどの対話モード・レポートはレポートとして表示されます。必要に応じて、各列の詳細を表示できます。構成すると、検索バーに「詳細の表示」アイコンが表示されます。

対話モード・レポートに詳細ビューを追加するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. ページを選択します。

ページ・デザイナが表示されます。

2. 「レンダリング」タブで、レポートを含むリージョンを見つけます。

3. 「リージョン」で、「属性」ノードを選択します。

プロパティ・エディタに、プロパティ・エディタのレポート属性が表示されます。

属性は、機能グループに編成されます。これらのグループを展開または縮小するには、「共通の表示」、「すべて表示」、「すべて閉じる」および「すべて開く」アイコンをクリックします。

4. 「詳細ビュー」属性を構成します。

a. 「詳細ビュー」を見つけて展開します。

b. 表示: 「はい」を選択します。

c. 行の前: レポート行の前に表示するHTMLを入力します。次に例を示します。
<table>

d. 各行: 詳細ビューのレポート行の本体を入力します。列名および列ラベルに#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>

e. 行の後: レポート行の後に表示するHTMLを入力します。次に例を示します。
</table>

5. 変更を保存するには、「保存」をクリックします。ページを保存して実行するには、「ページの保存と実行」をクリックします。

8.4.1.16 対話モード・レポートの詳細属性の構成

詳細対話モード・レポート属性を構成することによって、開発者はリージョンの別名の定義、保存したレポートのIDを格納する値を持つアイテムの指定および対話モード・レポートのサブスクリプションまたは電子メール・ダウンロードの送信者アドレスの定義を行うことができます。

トピック:

- ページ・デザイナでの詳細属性の構成

- 対話モード・レポートからの電子メール送信について

8.4.1.16.1 ページ・デザイナでの詳細属性の構成

詳細属性を構成するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. ページを選択します。

ページ・デザイナが表示されます。

2. 「レンダリング」タブで、レポートを含むリージョンを見つけます。

3. 「リージョン」で、「属性」ノードを選択します。

プロパティ・エディタに、プロパティ・エディタのレポート属性が表示されます。

属性は、機能グループに編成されます。これらのグループを展開または縮小するには、「共通の表示」、「すべて表示」、「すべて閉じる」および「すべて開く」アイコンをクリックします。

4. 「詳細」を見つけて展開します。

表 8-6に、使用可能な詳細属性を示します。

表8-6 詳細属性

属性

説明

リージョン別名

対象の対話モード・レポート・リージョンの英数字の別名を入力します。別名は、アプリケーション内で一意である必要があります。カスタムAPIコールでは、別名を使用して対話モード・レポート・リージョンを参照できます。たとえば、APEX_APPLICATION_PAGE_IRビューでALIAS列を問い合せることによって、INTERACTIVE_REPORT_IDを返すファンクションを記述できます。INTERACTIVE_REPORT_IDの値は、アプリケーションを別のインスタンスにエクスポートまたはインポートするときに変わる可能性があるため、別名を使用して対話モード・レポート・リージョンを参照する方法は有益です。

レポートIDアイテム

保存されたレポートIDを格納する値を持つページまたはアプリケーション・アイテムを選択します。対話モード・レポートでは、このアイテム値を使用して保存済のレポートにリンクします。たとえば、定義されたアイテム名のリンク、および保存されたデフォルト・レポート、パブリックまたはプライベート・レポートにリンクする値として保存されたレポートIDとともに、保存されたレポートのリストを定義できます。保存されたレポートIDは、APEX_APPLICATION_PAGE_IR_RPTビューから取得できます。

電子メール送信者アドレス

このレポートから電子メールを送信するときに送信者アドレスとして使用する有効な電子メール・アドレスを入力します。電子メールは、電子メール・タイプおよびサブスクリプション・タイプのダウンロードの場合にこのレポートから送信されます。値は、有効な電子メール・アドレスを含むリテラル文字列、または置換構文を使用してアプリケーションで定義された静的置換参照です。

アイテムの置換は、電子メール・ダウンロードでのみ機能し、サブスクリプションでは機能しないため、アプリケーションまたはページレベルでのアイテムの置換の使用はお薦めしません。

次に例を示します。

john.doe@abc.com
&MY_APP_EMAIL_FROM.
&APP_EMAIL.

5. 変更を保存するには、「保存」をクリックします。ページを保存して実行するには、「ページの保存と実行」をクリックします。

8.4.1.16.2 対話モード・レポートからの電子メール送信について

次の2つの方法で、対話モード・レポートから送信された電子メールの送信元アドレスを定義できます。

- アプリケーションレベル - アプリケーション定義の編集ページで、「アプリケーションの電子メール送信元アドレス」属性を編集します。

- レポートレベル — レポート属性にアクセスします。「詳細」で、「電子メール送信者アドレス」属性を編集します。

いずれの場合も、値には、有効な電子メールを含むリテラル文字列、アプリケーションレベルで定義したアプリケーションの電子メール送信元アドレスを返す置換構文または&APP_EMAIL.置換を使用してアプリケーションレベルで定義されたアプリケーション置換を指定できます。次に例を示します。

john.doe@abc.com
&MY_APP_EMAIL_FROM.
&APP_EMAIL.

注意:

アイテムの置換は、電子メール・ダウンロードでのみ機能し、サブスクリプションでは機能しないため、アプリケーションまたはページレベルでのアイテムの置換の使用はお薦めしません。

関連項目:

- アプリケーション定義の編集ページへのアクセス

- 「対話モード・レポートの詳細属性の構成」

- 「電子メール・ダウンロードの有効化」

8.4.2 レガシー・コンポーネント・ビューでの対話モード・レポートの編集

デフォルトでは、対話モード・レポートの各行の最初の列には、検索バー、「アクション」メニュー、「列ヘッダー」メニューおよび「編集」アイコンがあります。ユーザーは、これらのコントロールを使用して、列の選択、フィルタの適用、ハイライトおよびソートを実行し、レポート・データのレイアウトを変更できます。開発者は、コンポーネント・ビューで対話モード・レポートをカスタマイズして、これらのコントロールの表示を構成できます。

トピック:

- コンポーネント・ビューでの対話モード・レポート属性の編集

- コンポーネント・ビューでの列属性の編集

- 列グループの作成

- コンポーネント・ビューでの対話モード・レポートのページ区切りの制御

- コンポーネント・ビューでの検索バーおよび「アクション」メニューの管理

- コンポーネント・ビューでのリンク列の管理

- 対話モード・レポートでの列 リンクの作成

- 対話モード・レポートの条件付き表示

- 対話モード・レポートでのLOVとしての列定義

- 対話モード・レポートでの列の書式設定

- コンポーネント・ビューでのアイコン・ビューの有効化

- コンポーネント・ビューでの詳細ビューの有効化

- 対話モード・レポートの詳細属性の構成

- コンポーネント・ビューでの保存されたデフォルト対話モード・レポートの編集

- 保存された対話モード・レポート・アクティビティの表示

関連項目:

「レガシー・コンポーネント・ビューでのページの管理」、「対話モード・レポートへのリンク」、「実行中のアプリケーションでの対話モード・レポートのカスタマイズ」、および『Oracle Application Express APIリファレンス』のAPEX_IRに関する項

8.4.2.1 コンポーネント・ビューでの対話モード・レポート属性の編集

開発者は、レポート属性を編集して、対話モード・レポートをカスタマイズできます。

トピック:

- コンポーネント・ビューでの対話モード・レポートの属性ページへのアクセス

- レポート属性ページへのナビゲーション方法

8.4.2.1.1 コンポーネント・ビューでの対話モード・レポートの属性ページへのアクセス

レポート属性ページを表示するには、次のステップを実行します。

1. コンポーネント・ビューでページを表示します。レガシー・コンポーネント・ビューでのページの表示を参照してください。

コンポーネント・ビューが表示されます。

2. 「リージョン」で、編集するレポート・リージョンの名前の横にある「対話モード・レポート」リンクをクリックします。

3. レポート属性ページが表示されます。このページは次のセクションに分かれています。

- 「列属性」はレポート・レイアウトを制御します。コンポーネント・ビューでの列属性の編集を参照してください。

- 「列グループ」属性を使用すると、複数列を単一行ビューにまとめることができます。列グループの作成を参照してください。

- 「ページ区切り」属性はレポートのページ区切りを制御します。コンポーネント・ビューでの対話モード・レポートのページ区切りの制御を参照してください。

- 「検索バー」には、対話モード・レポート内に検索バーを定義するための属性が含まれています。コンポーネント・ビューでの検索バーおよび「アクション」メニューの管理を参照してください。

- 「ダウンロード」を使用すると、「アクション」メニューにダウンロード・オプションを追加して、レポートをCSV、HTML、電子メール、XLS、PDFまたはRTFファイルでエクスポートできるようになります。「アクション」メニューのダウンロード・オプションの構成を参照してください。

- 「リンク列」属性を使用すると、列にリンクを追加できます。コンポーネント・ビューでのリンク列の管理および対話モード・レポートでの列リンクの作成を参照してください。

- 「詳細属性」を使用すると、「対話モード・レポート」リージョンの別名の定義、保存したレポートのIDを格納する値を持つアイテムの指定、およびセッション・ステートに設定するアイテムの定義を行うことができます。対話モード・レポートの詳細属性の構成を参照してください。

- 「アイコン・ビュー」属性を使用すると、検索バーに「アイコンの表示」アイコンを追加できます。コンポーネント・ビューでのアイコン・ビューの有効化を参照してください。

- 「詳細ビュー」属性を使用すると、検索バーに「詳細の表示」アイコンを追加できます。コンポーネント・ビューでの詳細ビューの有効化を参照してください。

- 「説明」には、現在のレポートの説明テキストが表示されます。

ヒント:

属性の詳細は、フィールドレベル・ヘルプを参照してください。フィールドレベル・ヘルプの表示を参照してください。

関連項目:

コンポーネント・ビューでのクラシック・レポートの列リンクの作成、コンポーネント・ビューでの更新可能な列の定義、コンポーネント・ビューでのクラシック・レポートのLOVとしての列定義およびコンポーネント・ビューでのクラシック・レポートの列の表示条件の制御を参照してください。

8.4.2.1.2 レポート属性ページへのナビゲーション方法

レポート属性ページは、これらのセクションに分かれています。これらのセクションにアクセスするには、ページをスクロール・ダウンするか、ページ上部のナビゲーション・ボタンをクリックします。ページ上部のボタンを選択すると、選択されたセクションが表示され、その他のセクションはすべて一時的に非表示になります。ページのすべてのセクションを表示するには、「すべて表示」をクリックします。

8.4.2.2 コンポーネント・ビューでの列属性の編集

レポート属性ページの「列属性」セクションを使用すると、レポート・レイアウトを詳細に制御できます。たとえば、これらの属性を使用して、列ヘッダー・テキストの変更、列の位置の変更、または列の非表示化を行うことができます。

「列属性」にアクセスするには、次のステップを実行します。

1. 対話モード・レポートの属性ページにアクセスします。コンポーネント・ビューでの対話モード・レポートの属性ページへのアクセスを参照してください。

ページ上部に「列属性」セクションがある対話モード・レポートの属性ページが表示されます。

「列属性」セクションを使用して、レポート列の外観と機能を制御します。

「ヘッダー」には、レポートに含めるヘッダー・テキストが表示されます。「タイプ」は、問合せ列の型を示します。「リンク」列は、リンク列が現在定義されているかどうかを示します。

表 8-7に、レポート列の基本的な編集操作を示します。

表 8-7 対話モード・レポートのレポート列の基本的な編集操作

説明

開発者アクション

列ヘッダーのテキストを変更します。

「ヘッダー」で、異なるヘッダー・テキストを入力します。

列グループの割当てを変更します。

列グループが定義されている場合、「列グループ」で列を個別に割り当てることができます。

列の表示方法を変更します。

「表示テキスト」からオプションを選択します。

列属性ページで、特定の列の属性をさらに詳細に指定できます。

2. 列属性ページにアクセスするには、該当する列の横にある「編集」アイコンをクリックします。

「列の定義」が表示されます。

3. 「列の定義」の「ユーザーに許可する操作」で、該当するチェック・ボックスを選択します。オプションには、「非表示」、「ソート」、「フィルタ」、「ハイライト」、「コントロール・ブレーク」、「集計」、「計算」、「チャート」および「グループ化」があります。選択したオプションによって、ユーザーがレポートを操作できる方法が決定されます。

4. 対象となる属性を編集します。

属性の詳細は、フィールドレベル・ヘルプを参照してください。

5. 「変更の適用」をクリックして、編集を保存します。

8.4.2.3 列グループの作成

列グループを使用すると、単一行ビューで列をグループ化できます。

列グループを作成するには、次のステップを実行します。

1. 対話モード・レポートの属性ページにアクセスします。コンポーネント・ビューでの対話モード・レポートの属性ページへのアクセスを参照してください。
対話モード・レポートの属性ページが表示されます。

2. 「列グループ」までスクロールします。

3. 「グループの追加」をクリックします。

4. 「列グループ」で、次のようにします。

a. 順序 - この列グループの表示順序を入力します。この属性は、詳細ビューで列グループが表示される順番を決定します。

b. グループ名 - 列グループ名を入力します。この名前は、詳細ビューでリージョン・ヘッダーに表示されます。

c. 説明 - 列グループの説明を入力します(オプション)。この説明は、エンド・ユーザーには表示されません。

5. 「作成」をクリックします。

8.4.2.4 コンポーネント・ビューでの対話モード・レポートのページ区切りの制御

対話モード・レポートの属性ページの「ページ区切り」属性から選択することによって、ページ区切りの表示方法を制御します。

レポート属性ページの「ページ区切り」セクションにアクセスするには、次のステップを実行します。

1. 対話モード・レポートの属性ページにアクセスします。コンポーネント・ビューでの対話モード・レポートの属性ページへのアクセスを参照してください。

対話モード・レポートの属性ページが表示されます。

2. 「ページ区切り」までスクロールします。

「ページ区切り」属性では、ページ区切りスタイルの選択、ページ区切りの表示位置の決定、問合せの最大行数の指定、および最大行数を超える行が戻された場合や1行も戻されなかった場合に表示するメッセージの指定などを行います。

表 8-8に、使用可能な「ページ区切り」属性を示します。

表8-8 「ページ区切り」属性

属性

説明

ページ区切りタイプ

ページ区切りタイプを選択します。ページ区切りによって、結果セット内の行数および現在の位置に関する情報が提供されます。ページ区切りの有効なオプションは、次のとおりです。

- XからYの範囲の行

- ZのXからYの範囲の行

ページ区切り表示位置

ページ区切りの表示位置を定義します。ページ区切りは、レポートの左側、右側、上部または下部に表示できます。

NULL値を置き換えて表示

NULL列に表示するテキストを入力します。デフォルト値は(null)です。

行カウント最大値

問合せを行う最大行数を定義します(例: 456行中の行1 - 10)。

この属性を200に設定すると、結果は次のように表示されます。

rows 1 - 10 of more than 200 rows

この属性はパフォーマンスに影響を与えます。より少ない行数をカウントするとパフォーマンスは向上し、数千という行数をカウントするとパフォーマンスは低下します。

最大行数を超える行データでメッセージが見つかったとき

最大行数を超える行が返されたときに表示するテキスト・メッセージを定義します。

データが見つからなかった場合のメッセージ

問合せから行が返されなかったときに表示するテキスト・メッセージを定義します。

3. 「変更の適用」をクリックして、編集を保存します。

8.4.2.5 コンポーネント・ビューでの検索バーおよび「アクション」メニューの管理

開発者は、検索バーおよび「アクション」を表示するかどうかとその方法をカスタマイズできます。

トピック:

- 対話モード・レポートの検索バーおよび「アクション」メニュー

- 検索バーおよび「アクション」メニューのカスタマイズ

- 検索バーの削除

- 「アクション」メニューの「ダウンロード」オプションの構成

関連項目:

コンポーネント・ビューでのアイコン・ビューの有効化およびコンポーネント・ビューでの詳細ビューの有効化

8.4.2.5.1 対話モード・レポートの検索バーおよび「アクション」メニュー

検索バーは各対話モード・レポートの上部に表示され、「検索列の選択」アイコン、テキスト領域、「実行」ボタンおよび「アクション」メニューが含まれています。

複数のレポートを保存した場合は、保存したレポートの選択リストが「実行」ボタンの右に表示されます。このリストを使用して、保存された特定のレポートを選択できます。複数のビューが構成されている場合、ビュー選択ボタン・グループも表示され、エンド・ユーザーはビューを切り替えることができます。開発者は対話モード・レポートの属性ページの「検索バー」セクションのオプションを選択および選択解除して、検索バーを削除したり、カスタマイズすることができます。

8.4.2.5.2 検索バーおよび「アクション」メニューのカスタマイズ

検索バーをカスタマイズするには、次のステップを実行します。

1. 対話モード・レポートの属性ページにアクセスします。コンポーネント・ビューでの対話モード・レポートの属性ページへのアクセスを参照してください。

対話モード・レポートの属性ページが表示されます。

2. 「検索バー」までスクロールします。

これらの属性を使用して、検索バーの表示方法をカスタマイズします。表8-9に、「検索バー」属性を示します。

表8-9 「検索バー」属性

属性

説明

検索バーを含める

「はい」または「いいえ」を選択します。「いいえ」を選択すると、次のデフォルトのコンポーネントが削除されます。

- 検索フィールド - 検索条件を入力するためのテキスト・フィールドが検索バーに表示されます。

- ファインダ・ドロップ・ダウン - 選択した1列またはすべての列に対してユーザーが検索できるようにします。

- レポート選択リスト: レポートに代替デフォルト、共有レポートまたはパーソナル・レポートが含まれている場合に、レポート選択リストを表示します。対話モード・レポートの保存を参照してください。

- ページごとの行数セレクタ - 選択リストが表示され、1ページ当たりに表示される行数をそのリストから選択できます。

- アクション・メニュー - 選択した「アクション」に基づいてユーザーがレポートをカスタマイズできるようにします。

アクション・メニューに含める

「アクション」メニューに含める機能を選択および選択解除します。使用可能なオプションは次のとおりです。

- 列の選択: レポート列の表示/非表示および並替えを行うときに使用します。

- フィルタ: レポートにフィルタを追加するときに使用します(たとえば、STATE = VA)。

- ページごとの行数: 「ページごとの行数」メニューを表示するときに使用します。

- ソート: 列をソートするときに使用します。

- コントロール・ブレーク: レポート列にコントロール・ブレークを作成するときに使用します。

- ハイライト: 特定の行をハイライトする条件を定義するときに使用します。

- 計算: 計算結果の列を追加するときに使用します。

- 集計: レポート列に集計計算を含めるときに使用します。

- チャート: レポートのデータを利用せずにFlashチャートを作成するときに使用します。

- グループ化: レポートのデータを利用せずに「グループ化」ビューを作成するときに使用します。

- ピボット: レポートのデータに基づいてクロス・タブ・ビューを作成するときに使用します。

- フラッシュバック: レポート・データを過去のある時点までフラッシュバックするときに使用します。

- レポートの保存: 後で利用できるようにレポート設定を保存するときに使用します。認証済ページにのみ使用できます。

- パブリック・レポートの保存: すべてのユーザーが表示できるようにパブリック・レポートを保存するときに使用します。このオプションを有効にするには、「レポートの保存」を選択する必要があります。認証済ページにのみ使用できます。

- リセット: レポートをデフォルト設定にリセットするときに使用します。

- ヘルプ: 対話モード・レポートの使用方法を表示するときに使用します。

- ダウンロード: レポートを様々な形式でダウンロードするときに使用します。
注意: 「ダウンロード」機能を無効にすると、「アクション」メニューに「ダウンロード」メニューが表示されなくなるだけです。ユーザーが完全にデータをダウンロードできなくするには、「ダウンロード形式」セクションのすべてのチェック・ボックスを選択解除します。

- サブスクリプション: レポートを電子メールで送信するようにサブスクリプションをスケジュールするときに使用します。認証済ページにのみ使用できます。

関連項目: 「アクション」メニューについて

レポートのパブリック保存の認可

ユーザーは、レポートを保存し、そのレポートをパブリックまたはプライベートとして分類できます。パブリック・レポートは、すべてのユーザーが表示できます。プライベート・レポートは、そのレポートを保存したユーザーのみが表示できます。

「アクション」メニューで「パブリック・レポートの保存」を有効にすることに加え、「パブリック・レポートの保存」を有効にする権限を持つユーザーを決定する認可スキームを定義することによって、セキュリティを強化できます。

パブリック・レポートのサポートを有効にするには、このリストから認証方式を選択する必要があります。

検索ボタン・ラベル

検索ボタン・ラベルとして使用するテキストを指定します。

最大行数/ページ

「ページごとの行数セレクタ」に表示する最大数を入力します。

3. 「変更の適用」をクリックします。

8.4.2.5.3 検索バーの削除

検索バーを削除するには、次のステップを実行します。

1. 対話モード・レポートの属性ページにアクセスします。コンポーネント・ビューでの対話モード・レポートの属性ページへのアクセスを参照してください。

対話モード・レポートの属性ページが表示されます。

2. 「検索バー」までスクロールします。

3. 「検索バーを含める」から、「いいえ」を選択します。

4. 「変更の適用」をクリックします。

8.4.2.5.4 「アクション」メニューの「ダウンロード」オプションの構成

「アクション」メニューに「ダウンロード」オプションを追加すると、ユーザーが対話モード・レポートをカンマ区切りファイル(CSV)形式、HTML、Microsoft Excel (XLS)形式、Adobe Portable Document Format (PDF)、Microsoft Word Rich Text Format (RTF)、または電子メール添付のHTMLとしてダウンロードできます。

警告:

レポートからPDF、XLS、Wordなどの拡張形式へのダウンロードには、32Kの制限があります。エンド・ユーザーが表示している列の数が多すぎる場合は、これらの拡張形式にデータをダウンロードしようとすると、エラーが発生することがあります。また、大きいデータ・セットでは、ダウンロードが完了するまでかなりの時間がかかる場合があります。

注意:

グループ化ビューおよびピボット・ビューでは、XLS、PDF、RTFのダウンロード形式は、有効化され、レポート・サーバーが構成されている場合でもサポートされません。

トピック:

- ダウンロード形式の有効化

- CSVダウンロードの有効化

- 電子メール・ダウンロードの有効化

8.4.2.5.4.1 ダウンロード形式の有効化

ダウンロード形式を構成するには、次のステップを実行します。

1. 対話モード・レポートの属性ページにアクセスします。コンポーネント・ビューでの対話モード・レポートの属性ページへのアクセスを参照してください。
対話モード・レポートの属性ページが表示されます。

2. 「検索バー」までスクロールします。

a. 「検索バーを含める」で、「はい」を選択し、「アクション・メニュー」を選択します。

b. 「アクション・メニューに含める」で、「ダウンロード」を選択します。

ヒント:

「ダウンロード」機能を無効にすると、「アクション」メニューに「ダウンロード」メニューが表示されなくなるだけです。ユーザーが完全にデータをダウンロードできなくするには、「ダウンロード形式」セクションのすべてのチェック・ボックスを選択解除します。

3. 「ダウンロード」までスクロールします。

4. ダウンロード形式を選択します。オプションは次のとおりです。

- CSV。CSVダウンロードの有効化を参照してください。

- HTML。

- 電子メール。電子メール・ダウンロードの有効化を参照してください。

- XLS。

- PDF。PDFへのレポート出力についてを参照してください。

- RTF。

ヒント:

「アクション」メニューに「ダウンロード」オプションが表示されるのは、ファイル形式を選択した場合のみです。「インスタンス管理」内でレポート・サーバーが定義されていない場合は、特定のオプションが表示されません。詳細は、『Oracle Application Express管理ガイド』のレポート出力の構成に関する説明を参照してください。

5. 「変更の適用」をクリックします。

8.4.2.5.4.2 CSVダウンロードの有効化

CSVダウンロードを有効にするには、次のステップを実行します。

1. グローバリゼーション属性の編集ページで「CSV出力」オプションを有効にします。グローバリゼーション属性のページへのアクセスおよび自動CSVエンコーディングを参照してください。

2. 対話モード・レポートの属性ページにアクセスします。コンポーネント・ビューでの対話モード・レポートの属性ページへのアクセスを参照してください。
対話モード・レポートの属性ページが表示されます。

3. 「検索バー」までスクロールします。

a. 「検索バーを含める」で、「はい」を選択し、「アクション・メニュー」を選択します。

b. 「アクション・メニューに含める」で、「ダウンロード」を選択します。

4. 「ダウンロード」までスクロールします。

5. 「ダウンロード形式」から、「CSV」を選択します。

ヒント:

「アクション」メニューに「ダウンロード」オプションが表示されるのは、ファイル形式を選択した場合のみです。

6. 「CSVセパレータ」で、列セパレータを定義します。値が入力されていない場合は、現行のNLS設定に応じて、カンマまたはセミコロンが使用されます。

7. 「CSV囲み文字」にデリミタ文字を入力します。この文字は、データ値の開始境界および終了境界を区切ります。デフォルトのデリミタは二重引用符(" ")です。

8. 「ファイル名」にダウンロードするドキュメントのファイル名を入力します。ファイル拡張子は指定しないでください。拡張子は自動的に追加されます。これを空白のままにすると、リージョン名がファイル名として使用されます。

9. 「変更の適用」をクリックします。

8.4.2.5.4.3 電子メール・ダウンロードの有効化

特定の電子メール・アドレスに静的HTMLレポートを送信するように「ダウンロード」オプションを構成します。

ヒント:

電子メール・ダウンロードは、認証済ページでのみサポートされています。公開ページで電子メール・ダウンロードを有効にする場合、「ダウンロード」ダイアログには電子メール・ダウンロード・オプションは表示されません。

電子メール・ダウンロードを有効にするには、次のステップを実行します。

1. Oracle Application Express管理者は、インスタンス・レベルで電子メールを構成する必要があります。Oracle Application Express管理ガイドの「メールの構成」を参照してください。

2. 対話モード・レポートの属性ページにアクセスします。コンポーネント・ビューでの対話モード・レポートの属性ページへのアクセスを参照してください。
対話モード・レポートの属性ページが表示されます。

3. 「検索バー」までスクロールします。

a. 「検索バーを含める」で、「はい」を選択し、「アクション・メニュー」を選択します。

b. 「アクション・メニューに含める」で、「ダウンロード」を選択します。

4. 「ダウンロード」までスクロールします。

5. 「ダウンロード形式」から、「電子メール」を選択します。

ヒント:

「アクション」メニューに「ダウンロード」オプションが表示されるのは、ファイル形式を選択した場合のみです。

6. 「変更の適用」をクリックします。

注意:

電子メール・ダウンロードから送信される電子メールには、電子メールの送信者を識別するシステム生成電子メール署名が含まれています。この署名は削除できません。

関連項目:

対話モード・レポートからの電子メール送信について

8.4.2.6 コンポーネント・ビューでのリンク列の管理

対話モード・レポートの左側には、「リンク列」が表示されます。この項では、単一行ビュー、カスタム・ターゲットにリンクするようにリンク列を構成する方法またはレポートからリンク列を除外する方法について説明します。

ヒント:

エンド・ユーザーはリンク列のソート、非表示、移動を行うことはできず、リンク列は列属性ページに定義されている標準の列リンクとは関係ありません。

トピック:

- 単一行ビューへのリンク

- 特定のページへのリンク

- URLへのリンク

- リンク列の除外

8.4.2.6.1 単一行ビューへのリンクの設定

単一行ビューにリンクするには、次のステップを実行します。

1. 対話モード・レポートの属性ページにアクセスします。コンポーネント・ビューでの対話モード・レポートの属性ページへのアクセスを参照してください。

対話モード・レポートの属性ページが表示されます。

2. 「リンク列」までスクロールします。

3. 「リンク列」で、「単一行ビューへのリンク」を選択します。

4. 「単一行ビュー」で、適切なオプションを選択します。

- NULL値の除外を許可: NULL値の列を除外します。

- 表示列を許可: レポートに表示されている列のみを表示します。

5. 「一意に行を識別する基準」で、「行ID」または「一意列」を選択します。

「一意列」を選択した場合、「一意列」フィールドに列を指定します。

6. 「リンク・アイコン」で、指定されたアイコンを使用するか、新しいイメージを指定します。

7. (オプション)「リンク属性」で、<a href= >タグに含める追加の列リンク属性(リンク・ターゲット、クラス、スタイルなど)を指定します。

8. 「変更の適用」をクリックします。

ヒント:

対話モード・レポートが単一行ビューにリンクされており、リンク・アイコンにALTテキストがないか、ALTテキストが空である場合、アクセシビリティを改善するために alt="単一行ビュー"が自動的に含められます。これは、ALTテキストを行に固有なものにすることで(たとえば、alt="View Row: #COLUMN_NAME#"。COLUMN_NAMEは現在の行を一意に識別する列である必要があります)、さらに改善できます。

8.4.2.6.2 特定のページへのリンク

特定のページにリンクするには、次のステップを実行します。

1. 対話モード・レポートの属性ページにアクセスします。コンポーネント・ビューでの対話モード・レポートの属性ページへのアクセスを参照してください。

対話モード・レポートの属性ページが表示されます。

2. 「リンク列」までスクロールします。

3. 「リンク列」で、「カスタム・ターゲットへのリンク」を選択します。

4. 「リンク・アイコン」で、アイコンを選択します。

5. (オプション)「リンク属性」で、<a href= >タグに含める追加の列リンク属性(リンク・ターゲット、クラス、スタイルなど)を指定します。

6. 「ターゲット」で、「このアプリケーションのページ」を選択します。

7. 「ページ」で、ターゲットのページ番号を選択します。このページのページ区切りをリセットするには、「ページ区切りのリセット」を選択します。

8. 「リクエスト」で、使用するリクエストを指定します。

9. 「キャッシュのクリア」で、キャッシュをクリアするページ(ページ番号)を指定します。ページ番号をカンマで区切ってリストすることによって、複数のページを指定できます。対話モード・レポートへのリンクの設定を参照してください。

10. 「名前」および「値」で、特定のアイテムのセッション・ステートを指定します。

11. 「変更の適用」をクリックします。

8.4.2.6.3 URLへのリンクの設定

URLにリンクするには、次のステップを実行します。

1. 対話モード・レポートの属性ページにアクセスします。コンポーネント・ビューでの対話モード・レポートの属性ページへのアクセスを参照してください。

対話モード・レポートの属性ページが表示されます。

2. 「リンク列」までスクロールします。

3. 「リンク列」で、「カスタム・ターゲットへのリンク」を選択します。

4. 「リンク・アイコン」で、アイコンを選択します。

5. (オプション)「リンク属性」で、<a href= >タグに含める追加の列リンク属性(リンク・ターゲット、クラス、スタイルなど)を指定します。

6. 「ターゲット」から「URL」を選択します。

7. 「URL」で、該当するアドレスを入力します。

8. 「チェックサム」で、次のいずれかを選択します。

- デフォルトを使用

- アプリケーション・レベル - すべてのユーザーが再利用可能なリンク

- ユーザー・レベル - 現行のユーザーが再利用可能なリンク

属性の詳細は、フィールドレベル・ヘルプを参照してください。

9. 「変更の適用」をクリックします。

8.4.2.6.4 リンク列の除外

列リンクを除外するには、次のステップを実行します。

1. 対話モード・レポートの属性ページにアクセスします。コンポーネント・ビューでの対話モード・レポートの属性ページへのアクセスを参照してください。

対話モード・レポートの属性ページが表示されます。

2. 「リンク列」までスクロールします。

3. 「リンク列」で、「リンク列の除外」を選択します。

4. 「変更の適用」をクリックします。

8.4.2.7 対話モード・レポートでの列 リンクの作成

レポートからアプリケーション内の別のページまたはURLへのリンクを作成するには、「列属性」を使用します。

トピック:

- 別のページへの列リンクの作成

- URLへの列リンクの作成

8.4.2.7.1 別のページへの列リンクの作成

別のページへの列リンクを作成するには、次のステップを実行します。

1. 対話モード・レポートの属性ページにアクセスします。コンポーネント・ビューでの対話モード・レポートの属性ページへのアクセスを参照してください。
対話モード・レポートの属性ページが表示されます。

2. 「列属性」で、リンクを含む列を指定します。

3. 列名の横にある「編集」アイコンをクリックします。
列属性ページが表示されます。

4. 「列リンク」までスクロールします。

5. 別のページへの列リンクを作成するには、次のステップを実行します。

a. 「ターゲット」で、「このアプリケーションのページ」を選択します。

b. (オプション)「リンク属性」で、<a href= >タグに含める追加の列リンク属性(リンク・ターゲット、クラス、スタイルなど)を指定します。

c. 「リンク・テキスト」で、リンクとして表示されるテキストを入力するか、イメージ・タグを指定するか、またはデフォルトのイメージのリストから選択します。

d. 「ページ」で、ターゲット・ページ番号を指定します。このページのページ区切りをリセットするには、「ページ区切りのリセット」を選択します。

e. 「リクエスト」で、使用するリクエストを指定します。

f. 「キャッシュのクリア」で、キャッシュをクリアするページ(ページ番号)を指定します。ページ番号をカンマで区切ってリストすることによって、複数のページを指定できます。

g. 特定のアイテムのセッション・ステートを指定するには、「名前」フィールドおよび「値」フィールドを使用します。

h. 「チェックサム」で、次のいずれかを選択します。

- デフォルトを使用

- アプリケーション・レベル - すべてのユーザーが再利用可能なリンク

- ユーザー・レベル - 現行のユーザーが再利用可能なリンク

詳細は、フィールドレベル・ヘルプを参照してください。

6. 「変更の適用」をクリックします。

8.4.2.7.2 URLへの列リンクの作成

URLへの列リンクを作成するには、次のステップを実行します。

1. 対話モード・レポートの属性ページにアクセスします。コンポーネント・ビューでの対話モード・レポートの属性ページへのアクセスを参照してください。
対話モード・レポートの属性ページが表示されます。

2. 該当する列の横にある「編集」アイコンをクリックして、列属性ページにアクセスします。
列属性ページが表示されます。

3. 「列リンク」までスクロールします。

4. 「列リンク」で、次のように指定します。

a. 「ターゲット」から「URL」を選択します。

b. 「リンク・テキスト」で、リンクとして表示されるテキストを入力し、置換文字列を選択します。

c. (オプション)「リンク属性」で、<a href= >タグに含める追加の列リンク属性(リンク・ターゲット、クラス、スタイルなど)を指定します。

d. 「URL」で、該当するアドレスを入力します。

5. 「変更の適用」をクリックします。

8.4.2.8 対話モード・レポートの条件付き表示

リージョンの編集ページでリージョン属性を編集することによって、対話モード・レポートを条件付きで表示するように指定できます。

対話モード・レポートを条件付きで表示するには、次のステップを実行します。

1. 適切なページにナビゲートします。レガシー・コンポーネント・ビューでのページの表示を参照してください。

2. 「リージョン定義」にアクセスします。「リージョン」で、リージョン名を選択します。

リージョン定義が表示されます。

3. 「条件」までスクロールします。

4. 「条件タイプ」リストから選択します。

5. 表示されるフィールドに式を入力します。

6. 「変更の適用」をクリックします。

ヒント:

Asynchronous JavaScript and XML (AJAX)が対話モード・レポート全体で使用されています。AJAXは非同期であるため、条件付き表示用に評価される値はセッション内に含まれている必要があります。指定した値に基づいて対話モード・レポートを条件付きで表示するには、:REQUEST値のかわりにページ・アイテムを使用します。条件付き表示で:REQUESTを使用した場合、対話モード・レポート機能が正しく動作しません。

8.4.2.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. 「変更の適用」をクリックします。

8.4.2.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#" alt="#EMPLOYEE_NAME#" title="#EMPLOYEE_NAME#">

5. 「変更の適用」をクリックします。

8.4.2.11 コンポーネント・ビューでのアイコン・ビューの有効化

デフォルトでは、ほとんどの対話モード・レポートはレポートとして表示されます。必要に応じて、列をアイコンとして表示できます。列をアイコンとして表示するように構成すると、「アイコンの表示」アイコンが検索バーに表示されます。

アイコン・ビューを利用するには、アイコン、ラベルおよびターゲット(つまり、リンク)を識別するために使用する列を指定します。これらの列は通常エンド・ユーザーには役立たないため、非表示になるように設定することをお薦めします。

トピック:

- 対話モード・レポートへのアイコン・ビューの追加

- カスタム・アイコン・ビュー・リンクの追加

8.4.2.11.1 対話モード・レポートへのアイコン・ビューの追加

対話モード・レポートにアイコン・ビューを追加するには、次のステップを実行します。

1. 対話モード・レポートの属性ページにアクセスします。コンポーネント・ビューでの対話モード・レポートの属性ページへのアクセスを参照してください。

対話モード・レポートの属性ページが表示されます。

2. 「アイコン・ビュー」までスクロールします。

3. 「アイコン・ビューの有効化」で、「はい」を選択します。

4. 次の必須属性を指定します。

ヒント:

例を表示するには、フィールドレベル・ヘルプを参照してください。

- リンク列: アイコンのリンク・ターゲットを返す列を選択します。

- イメージ・ソース列: イメージ・ソースを返す列を指定します。

- ラベル列: イメージ・ラベルを返す列を選択します。

5. 「1行当たりの行数」で、1行当たりに表示するアイコン数を指定します。値として5を指定すると、1行当たり5つのアイコンが表示されます。

6. 「変更の適用」をクリックします。

8.4.2.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. 「変更の適用」をクリックします。

8.4.2.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. 「変更の適用」をクリックします。

8.4.2.13 対話モード・レポートの詳細属性の構成

この項では、「対話モード・レポート」リージョンの別名の定義、保存したレポートのIDを格納する値を持つアイテムの指定、および対話モード・レポートのサブスクリプションまたは電子メール・ダウンロードの送信者アドレスの定義するように対話モード・レポートの属性ページの「拡張属性」セクションを構成する方法について説明します。

トピック:

- 詳細属性の構成

- 対話モード・レポートからの電子メール送信について

8.4.2.13.1 詳細属性の構成

詳細属性を構成するには、次のステップを実行します。

1. 対話モード・レポートの属性ページにアクセスします。コンポーネント・ビューでの対話モード・レポートの属性ページへのアクセスを参照してください。

対話モード・レポートの属性ページが表示されます。

2. 詳細属性までスクロールします。

表 8-10に、使用可能な詳細属性を示します。

表8-10 詳細属性

属性

説明

リージョン別名

対象の対話モード・レポート・リージョンの英数字の別名を入力します。別名は、アプリケーション内で一意である必要があります。

APIコールでは、別名を使用して対話モード・レポートを参照できます。たとえば、APEX_APPLICATION_PAGE_IRビューでALIAS列を問い合せることによって、INTERACTIVE_REPORT_IDを返すファンクションを記述できます。別名は、アプリケーション内で一意である必要があります。別のインスタンスに対するエクスポート操作またはインポート操作によりINTERACTIVE_REPORT_ID値は変わることがあるため、別名を使用して対話モード・レポート・リージョンを参照すると役立ちます。

レポートIDアイテム

保存されたレポートIDを格納する値を持つページまたはアプリケーション・アイテムを選択します。対話モード・レポートでは、このアイテム値を使用して保存済のレポートにリンクします。たとえば、定義されたアイテム名のリンク、および保存されたデフォルト・レポート、パブリックまたはプライベート・レポートにリンクする値として保存されたレポートIDとともに、保存されたレポートのリストを定義できます。保存されたレポートIDは、APEX_APPLICATION_PAGE_IR_RPTビューから取得できます。

電子メール送信者アドレス

電子メール・ダウンロードまたはサブスクリプションから電子メールを送信するときに送信元アドレスとしてい使用する有効な電子メール・アドレスを入力します。値には、有効な電子メールを含むリテラル文字列、アプリケーションレベルで定義したアプリケーションの電子メール送信元アドレスを返す置換構文または&APP_EMAIL.置換を使用してアプリケーションレベルで定義されたアプリケーション置換を指定できます。次に例を示します。

john.doe@abc.com
&MY_APP_EMAIL_FROM.
&APP_EMAIL.

アイテムの置換は、電子メール・ダウンロードでのみ機能し、サブスクリプションでは機能しないため、アプリケーションまたはページレベルでのアイテムの置換の使用はお薦めしません。

ヒント: 電子メール送信者アドレスの優先順位は、次のとおりです。

レポート・レベルの電子メール送信者アドレス→アプリケーション・レベルのアプリケーションの電子メール送信元アドレス→インスタンス・レベルのデフォルトの電子メール送信元アドレス。

これらすべてがNULLの場合、電子メール送信元アドレスは、電子メール受信元アドレスと同じです。

関連項目: アプリケーション定義ページの編集

3. 「変更の適用」をクリックします。

8.4.2.13.2 対話モード・レポートからの電子メール送信について

次の2つの方法で、対話モード・レポートから送信された電子メールの送信元アドレスを定義できます。

- 「アプリケーション定義の編集」ページの「アプリケーションの電子メール送信元アドレス」属性でのアプリケーションレベル。アプリケーション定義ページの編集を参照してください。

- 「対話モード・レポートの属性」ページの「電子メール送信者アドレス」属性での対話モード・レポートレベル。対話モード・レポートの詳細属性の構成を参照してください。

いずれの場合も、値には、有効な電子メールを含むリテラル文字列、アプリケーションレベルで定義したアプリケーションの電子メール送信元アドレスを返す置換構文または&APP_EMAIL.置換を使用してアプリケーションレベルで定義されたアプリケーション置換を指定できます。次に例を示します。

john.doe@abc.com
&MY_APP_EMAIL_FROM.
&APP_EMAIL.

アイテムの置換は、電子メール・ダウンロードでのみ機能し、サブスクリプションでは機能しないため、アプリケーションまたはページレベルでのアイテムの置換の使用はお薦めしません。

関連項目:

電子メール・ダウンロードの有効化および置換文字列の理解

8.4.2.14 コンポーネント・ビューでの保存されたデフォルト対話モード・レポートの編集

この項では、開発者がデフォルト対話モード・レポートを表示および管理する方法について説明します。

トピック:

- コンポーネント・ビューでのデフォルト・レポートの別名の編集

- コンポーネント・ビューでの保存されたデフォルト・レポートの削除

関連項目:

デフォルトの対話モード・レポートの保存およびOracle Application Express管理ガイドの「保存された対話モード・レポートの管理」

8.4.2.14.1 コンポーネント・ビューでのデフォルト・レポートの別名の編集

開発者は、保存されたレポート・ページで、レポートの別名を編集したり、デフォルト・レポートのリンク例を表示することができます。

デフォルト・レポートのレポートの別名を編集するには、次のステップを実行します。

1. 保存された対話モード・レポートを含む適切なページにナビゲートします。レガシー・コンポーネント・ビューでのページの表示を参照してください。

2. 「リージョン」で、「保存されたレポート」リンクをクリックします。

保存されたレポート・ページが表示されます。

3. 「レポート別名」で、次のいずれかの操作を実行できます。

- 保存済のレポートの新しい別名を入力します。

- リンク例をコピー・アンド・ペーストして、保存済の特定のレポートへのリンクを設定します。

4. 「変更の適用」をクリックします。

8.4.2.14.2 コンポーネント・ビューでの保存されたデフォルト・レポートの削除

保存されたデフォルト・レポートを削除するには、次のステップを実行します。

1. 保存された対話モード・レポートを含む適切なページにナビゲートします。レガシー・コンポーネント・ビューでのページの表示を参照してください。

2. 「リージョン」で、「保存されたレポート」リンクをクリックします。

保存されたレポート・ページが表示されます。

3. レポートを削除するには、レポートを選択し、「チェックした項目の削除」をクリックします。

8.4.2.15 保存された対話モード・レポート・アクティビティの表示

開発者は、レポート属性の編集ページの「タスク」の下にある「保存されたレポート・アクティビティの表示」リンクをクリックして、保存済のレポートのアクティビティを表示できます。このリンクは、保存済のレポート(プライマリ・デフォルト・レポート以外)が存在する場合にのみ表示されます。このページを使用して、どのレポートが使用されていて、どのレポートが使用されていないかを判別できます。

保存済のレポートのアクティビティを表示するには、次のステップを実行します。

1. 対話モード・レポートの属性ページにアクセスします。コンポーネント・ビューでの対話モード・レポートの属性ページへのアクセスを参照してください。

対話モード・レポートの属性ページが表示されます。

2. 「タスク」リストで、「保存されたレポート・アクティビティの表示」をクリックします。

ヒント:

保存済のレポートのアクティビティは、ワークスペース管理ページから表示することもできます。ワークスペースのホームページで、「管理メニュー」をクリックして、「管理」、「アクティビティのモニター」および「対話モード・レポート別」を選択します。

8.4.3 対話モード・レポートへのリンクの設定

一般にページ・アイテムをレポート・パラメータとして使用するクラシック・レポートとは異なり、対話モード・レポートのデータは、宣言的なフィルタで決まります。ただし、開発者は、エンド・ユーザーに対する対話モード・レポート設定を変更することで、このレポート・パラメータを設定することができます。この設定は、エンド・ユーザーが作業中のレポートのみに影響します。保存済のレポート設定には影響しません。この項で説明する構文をURLのRequest値およびItemNamesセクションで使用して、対話モード・レポートにリンクします。

注意:

追加の対話モード・レポート・リージョンを追加する場合、古い単一の対話モード・レポートのリンク構文を必ず変更してください。変更しなければ、リンクでエラーが発生します。複数の対話モード・レポート・リージョン、RequestまたはName構文があるページへのリンクは、リージョンの静的IDで完全修飾する必要があります。

トピック:

- Request構文

- Name構文およびValue構文

- ClearCache構文

- 対話モード・レポートにリンクする際の制限

- 有効なリンクの例

- 無効なリンクの例

- 共有対話モード・レポートへのリンクの設定

関連項目:

URL構文の理解およびf?p構文を使用したページのリンクについて

8.4.3.1 Request構文

特定の保存済レポートにリンクするには、次のRequest構文を使用します。

IR[region static ID]_<report_alias>

次に例を示します。

IR[EMP]_dept20

注意:

URLでのRequestの使用はオプションです。複数の保存済レポートにリンクするには、各Requestをカンマで区切ります。

8.4.3.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のレポートに表示されるすべての列を検索します)

8.4.3.3 ClearCache構文

ヒント:

保存済レポートの別名を指定しないでRequestでClearCacheを使用すると、プライマリ・デフォルト・レポートがクリアされます。複数の対話モード・レポートがあるページで、特定の対話モード・レポート・リージョンをクリアするには、保存済レポートの別名とともにリージョンの静的IDをRequestで指定します。

URLのClearCacheセクションで次の構文を使用して、対話モード・レポートのリセット、クリアまたはページ区切りのリセットを行います。

- RIR - 対話モード・レポートをリセットします。これは、エンド・ユーザーがターゲット・ページで対話モード・レポートの「アクション」メニューから「リセット」オプションを選択した場合に相当します。レポートは、開発者が指定したか、またはユーザーが保存したデフォルトのレポート設定に戻ります。

- CIR - 対話モード・レポートをクリアします。これにより、コントロール・ブレーク、集計、フラッシュバック、チャート、表示する行数、フィルタ、ハイライト、計算、グループ化、ピボットなどすべてのレポート設定がクリアされます。

- RP - 対話モード・レポートのページ区切りをリセットします。

8.4.3.4 対話モード・レポートにリンクする際の制限

対話モード・レポートにリンクする場合は、次の制限に注意してください。

1. Request値がURLで定義されていない場合、すべてのプライマリ・デフォルト・レポート設定が変更されます。

2. Requestが定義されておらず、かつ、itemNamesセクションに、リージョンの静的IDで完全修飾されたフィルタ列名が含まれていない場合、ターゲット・ページに複数の対話モード・レポート・リージョンが存在すると、エラーが発生します。

3. Request値が定義されておらず、かつ、itemNamesセクションに、リージョンの静的IDで完全修飾されたフィルタ列名が含まれていない場合、ターゲット・ページ内の対話モード・レポート・リージョンが1つのみであれば、プライマリ・デフォルト・レポートにフィルタが作成されます。

8.4.3.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:

8.4.3.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

8.4.3.7 共有対話モード・レポートへのリンクの設定

URLのRequest値でIR[region static ID]_<report_alias>を使用して、保存済のプライマリ・デフォルト、代替デフォルトおよびパブリック・レポートにリンクを設定できます。

トピック:

- ページ・デザイナでのデフォルト・レポートの別名の編集

- プライマリ・レポートへのリンクの例

- 保存済のレポートへのリンクの例

関連項目:

and

- f?p構文を使用したページのリンクについて

- 「デフォルトの対話モード・レポートの保存」

- 「保存された対話モード・レポートの削除」

- 『Oracle Application Express管理ガイド』の保存された対話モード・レポートの管理に関する項

8.4.3.7.1 ページ・デザイナでのデフォルト・レポートの別名の編集

プロパティ・エディタで、デフォルトの対話モード・レポートの属性を表示できます。

デフォルトの対話モード・レポートの属性を表示するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. ページを選択します。

ページ・デザイナが表示されます。

2. 「保存されたレポート」属性を選択します。

a. 「レンダリング」タブで、レポートを含むリージョンを見つけます。

b. 「リージョン」で、「属性」ノードを展開します。

c. 「保存されたレポート」を展開します。

d. 保存済レポートを選択します。

「保存されたレポート」属性がプロパティ・エディタに表示されます。

属性は、機能グループに編成されます。これらのグループを展開または縮小するには、「共通の表示」、「すべて表示」、「すべて閉じる」および「すべて開く」アイコンをクリックします。

3. 「指定」を展開します

4. 「別名」で、このレポートの新しい別名を入力します。この別名を使用して、この保存済レポートへのわかりやすいURLリンクを定義します。このリンクを使用して、アプリケーション内の別の場所から直接リンクできます。

5. 変更を保存するには、「保存」をクリックします。ページを保存して実行するには、「ページの保存と実行」をクリックします。

8.4.3.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

8.4.3.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:IR_ENAME:KING

8.4.4 実行中のアプリケーションでの対話モード・レポートのカスタマイズ

アプリケーションの実行中、ユーザー(エンド・ユーザーと開発者の両方)は、関心のある列の選択、フィルタの適用、ハイライト表示、ソート処理などを行って、対話モード・レポート・データのレイアウトを変更できます。また、ブレーク、集計、チャート、グループ化を定義し、ユーザー独自の計算を追加することもできます。

トピック:

- 検索バーについて

- 「アクション」メニューについて

- 対話モード・レポート・フィルタの使用

- 対話モード・レポートの保存

関連項目:

ウィザードを使用したレポートの作成およびOracle Application Expressエンド・ユーザー・ガイドの「「アクション」メニューを使用した対話モード・レポートのカスタマイズ」

8.4.4.1 検索バーについて

検索バーは各対話モード・レポートの上部に表示され、次の機能が含まれています。

- 検索列の選択 - このアイコンは、虫めがねに似ています。このアイコンをクリックして、検索を特定の列に絞り込みます。すべての列を検索するには、「すべての列」を選択します。

- テキスト領域 - 大/小文字を区別しない検索基準(ワイルドカード文字を含む)を入力し、「実行」をクリックします。

- 「実行」ボタン - 検索を実行します。

- レポート - 代替のデフォルトおよび保存済のプライベートまたはパブリック・レポートが表示されます。対話モード・レポートの保存を参照してください。

- アイコンの表示 - デフォルト・レポートの「アイコンの表示」、「レポートの表示」および「詳細の表示」を切り替えます(有効にしている場合)。「チャート」ビューおよび「グループ化」ビューを含めることもできます(定義している場合)。

- 「アクション」メニュー - 「アクション」メニューは対話モード・レポートのカスタマイズに使用します。「アクション」メニューについてを参照してください。

関連項目:

対話モード・レポートの検索バーのカスタマイズ

8.4.4.2 「アクション」メニューについて

注意:

対話モード・レポートの「アクション」メニューの構造は、対話グリッドと一貫するように変更されました。以前の(またはレガシー)構造を使用するように対話モード・レポートの「アクション」メニューを変更するには、「共有コンポーネント」、「コンポーネント設定」に移動し、「対話モード・レポート」コンポーネントを構成します。対話モード・レポートの「アクション」メニューの構造の構成を参照してください。

「アクション」メニューは、検索バーの「実行」ボタンの右に表示されます。エンド・ユーザーは、「アクション」メニューを使用して対話モード・レポートをカスタマイズできます。

関連項目:

『Oracle Application Expressエンド・ユーザー・ガイド』の「アクション」メニューを使用した対話モード・レポートのカスタマイズに関する項

8.4.4.3 対話モード・レポート・フィルタの使用

対話モード・レポートをカスタマイズするとき、検索バーとレポートの間にフィルタが表示されます。次の図は、1つのフィルタStatus = 'COMPLETED'が表示された対話モード・レポートを示しています。

対話モード・レポートのその他の主要機能は、次のとおりです。

- 有効/無効 - フィルタを有効または無効にするには、フィルタ名の左にあるチェック・ボックスを選択/解除します。

- フィルタの編集 - フィルタを編集するには、フィルタ名をクリックします。

- フィルタの削除 - フィルタを削除するには、フィルタ名の右側にある「フィルタの削除」アイコンを選択します。

デフォルトでは、複数のフィルタが上下に積み上げられ、水平に表示されます。表示する情報の量を最小化してフィルタの詳細を非表示にするには、フィルタ名の左側の矢印をクリックします。次の図は、フィルタ詳細が非表示になった、同じレポートを示しています。

8.4.4.4 対話モード・レポートの保存

すべてのユーザーは、プライベートまたはパブリック対話型モード・レポートを保存できます。ただし、プライベート・レポートを作成したユーザーのみが、そのレポートの表示、保存、名前の変更または削除を行うことができます。ただし、開発者には、最初に表示されるプライマリ・デフォルト・レポートを保存したり、代替デフォルト・レポートを作成できる追加の保存機能があります。

トピック:

- ユーザー・タイプおよび使用可能な保存オプションについて

- 構成の依存関係について

- パブリックまたはプライベートの対話モード・レポートの保存

- デフォルトの対話モード・レポートの保存

- パブリックまたはプライベートの対話モード・レポートの名前変更

- パブリックまたはプライベートの対話モード・レポートの削除

- 対話モード・レポートのエクスポートについて

関連項目:

『Oracle Application Express管理ガイド』の保存された対話モード・レポートの管理に関する項

8.4.4.4.1 ユーザー・タイプおよび使用可能な保存オプションについて

エンド・ユーザーは、2つの方法で対話モード・レポートを保存できます。

- パブリック・レポート(エンド・ユーザーおよび開発者)。このレポートはすべてのユーザーが表示できます。ただし、パブリック・レポートを作成したユーザーのみが、そのレポートの保存、名前の変更または削除を行うことができます。すべてのユーザーがパブリック・レポートを表示できますが、保存は新しいレポート名の下でのみ実行できます。

- プライベート・レポート(エンド・ユーザーおよび開発者)。プライベート・レポートを作成したユーザーのみが、そのレポートを表示、保存、名前変更または削除できます。

また、開発者は、次の方法で対話モード・レポートを保存することもできます。

- プライマリ・デフォルト(開発者のみ)。プライマリ・デフォルトは、最初に表示されるレポートです。プライマリ・デフォルト・レポートは、名前を変更することも、削除することもできません。

- 代替レポート(開発者のみ)。開発者は、複数のレポート・レイアウトを作成できます。代替レポートの保存、名前の変更または削除ができるのは開発者のみです。

次の図では、対話モード・レポートの検索バーにある「レポート」リストを示します。

この例では、2つのレポートを示します。

- デフォルト: プライマリ・レポート。これは、アプリケーション開発者によって作成される最初のレポートです。デフォルト・プライマリ・レポートの名前を変更したり削除することはできません。

- プライベート: 1。タスクのあるプロジェクト。これはプライベートのレポートです。プライベート・レポートを表示、保存、名前変更、削除できるのは、それを作成したユーザーのみです。

ヒント:

保存済のレポートのアクティビティは、ワークスペース管理ページから表示することができます。ワークスペースのホームページで、「管理メニュー」をクリックして、「管理」、「アクティビティのモニター」および「対話モード・レポート別」を選択します。

8.4.4.4.2 構成の依存関係について

開発者は、レポート属性を編集して、ユーザーが対話モード・レポートを保存する方法を制御します。

ユーザーがプライベート・レポートを完全に保存できるようにするには、開発者は次のステップを実行する必要があります。

- カレント・アプリケーションに認証スキームを定義した場合。

- 次のレポート属性を編集します。

- アクション・メニュー、レポートの保存: この属性を「はい」に設定して、エンド・ユーザーが現在のレポート定義を「パブリック」レポートとして保存できるようにします。

- アクション・メニュー、パブリック・レポートの保存: この属性を「はい」に設定して、エンド・ユーザーが現在のレポート定義を「プライベート」レポートとして保存できるようにします。

- 検索バー、レポート選択リスト: この属性を「はい」に設定して、「レポート」選択リストを検索バーに含めます。

- アクション・メニュー、パブリック・レポートの保存の認可: 認可スキームを選択して、パブリック・レポート定義を保存できるユーザーを制限します。エンド・ユーザーがパブリック・レポートを保存できるようにするには、この認可スキームはTRUEと評価される必要があります。認可スキームが指定されていない場合、すべてのユーザーがレポートを保存できます。

関連項目:

- 認証によるユーザー・アイデンティティの証明

- ページ・デザイナでの「アクション」メニューのカスタマイズ

- 対話モード・レポートの検索バーのカスタマイズ

8.4.4.4.3 パブリックまたはプライベートの対話モード・レポートの保存

エンド・ユーザーは、対話モード・レポートを保存し、そのレポートをパブリックまたはプライベートとして分類できます。パブリック・レポートは、すべてのユーザーが表示できます。プライベート・レポートは、そのレポートを保存したユーザーのみが表示できます。

ヒント:

パブリック・レポートを保存するには、開発者はレポート属性を編集する必要があります。プロパティ・エディタで、「アクション・メニュー」を見つけて「パブリック・レポートの保存」を「はい」に設定します。開発者は、認可スキームを適用して、「パブリック・レポートの保存」を有効または無効にすることもできます。構成の依存関係についてを参照してください。

パブリックまたはプライベートの対話モード・レポートを保存するには、次のステップを実行します。

1. 保存する対話モード・レポートを含むページに移動します。

2. レポートをカスタマイズします(たとえば、列の非表示、フィルタの追加など)。

3. 「アクション」メニューをクリックし、「レポート」、「レポートの保存」の順に選択します。
「レポートの保存」ダイアログが表示されます。

4. エンド・ユーザーには、次の「レポートの保存」ダイアログが表示されます。

「レポートの保存」で、次の項目を指定します。

a. 名前: レポートの名前を入力します。

b. パブリック: レポートをすべてのユーザーが表示できるようにするには、このチェック・ボックスを選択します。レポートをプライベートにするには、このチェック・ボックスの選択を解除します。

c. 説明: 説明を入力します(オプション)。

d. 「適用」をクリックします。

5. 開発者には、次の「レポートの保存」ダイアログが表示されます。

「レポートの保存」で、次の項目を指定します。

a. 保存: 「名前付きレポートとして保存」を選択します。

b. 名前: レポートの名前を入力します。

c. パブリック: レポートをすべてのユーザーが表示できるようにするには、このチェック・ボックスを選択します。レポートをプライベートにするには、このチェック・ボックスの選択を解除します。

ヒント:

「パブリック」チェック・ボックスは、「パブリック・レポートの保存」レポート属性を有効にしている場合にのみ表示されます。

d. 説明: 説明を入力します(オプション)。

e. 「適用」をクリックします。

8.4.4.4.4 デフォルトの対話モード・レポートの保存

開発者は、プライマリおよび代替の2つのデフォルト対話モード・レポートを保存できます。両方のレポートは、検索バーの「レポート」リストに表示されます。ただし、プライマリ・デフォルト・レポートの名前を変更したり削除することはできません。

デフォルトの対話モード・レポートを保存するには、次のステップを実行します。

1. レポートを開発者として実行します。

2. レポートをカスタマイズします(たとえば、列の非表示、フィルタの追加など)。

3. 「アクション」メニューをクリックし、「レポート」、「レポートの保存」の順に選択します。

「レポートの保存」ダイアログが表示されます。

4. 「保存」から「デフォルトのレポート設定として保存」を選択します。

「デフォルト・レポートの保存」ダイアログが表示されます。

5. 「デフォルト・レポート・タイプ」で、次のいずれかを選択します。

- 主: このレポートは、ページの実行時にプライマリ・レポートとして表示されます。

- 代替: このレポートは、検索バーの「レポート」リストに代替オプションとして表示されます。「代替」を選択した場合、名前を入力します。

6. 「適用」をクリックします。

8.4.4.4.5 パブリックまたはプライベートの対話モード・レポートの名前変更

パブリックまたはプライベートの対話モード・レポートを名前変更するには、次の手順を実行します。

1. レポートを開発者として実行します。

2. 名前変更するパブリックまたはプライベートの対話モード・レポートを選択します。

3. 保存されたレポートのリンクをクリックします。

4. 「レポートの名前変更」ダイアログで、属性を編集して(新しい名前を入力するなど)、「適用」をクリックします。

8.4.4.4.6 パブリックまたはプライベートの対話モード・レポートの削除

パブリックまたはプライベートの対話モード・レポートを削除するには、次のステップを実行します。

1. レポートを開発者として実行します。

2. レポート名のリンクの横にある「レポートの削除」アイコンをクリックします。

3. 「適用」をクリックします。

8.4.4.4.7 対話モード・レポートのエクスポートについて

アプリケーションをエクスポートすると、プライマリ・デフォルト、代替デフォルト、パブリックのレポートがデフォルトで含まれます。エクスポート・プロセス中に「プライベート対話モード・レポート」で「はい」を選択して、パーソナル・レポートを含めるように指定することもできます。

関連項目:

「アプリケーションのエクスポート」

8.5 クラシック・レポートの管理

クラシック・レポートは、SQL問合せの結果の書式を設定したものです。開発者が、レポートを作成する表を選択するか、カスタムSQL SELECT文またはSQL SELECT文を戻すPL/SQLファンクションを指定する表を選択します。クラシック・レポートは、ソートおよび単純なフィルタ処理を除いて、エンド・ユーザーがカスタマイズすることはできません。

トピック:

- ページ・デザイナでのクラシック・レポートの編集

- レガシー・コンポーネント・ビューでのクラシック・レポートの編集

8.5.1 ページ・デザイナでのクラシック・レポートの編集

レポート属性ページを使用すると、開発者はクラシック・レポートのレポート・レイアウト、ページ区切り、列ソート、エラー・メッセージ、エクスポート・リンクおよび列ブレークを制御できます。

トピック:

- ページ・デザイナでのクラシック・レポート・レイアウトの変更

- ページ・デザイナでのクラシック・レポート属性の編集

- ページ・デザイナでのクラシック・レポートのページ区切りの編集

- ページ・デザイナでのクラシック・レポートのCSV出力オプションの有効化

- ページ・デザイナでのXMLファイルまたはCSVファイル・エクスポートのサポートの追加

- ページ・デザイナでのクラシック・レポートの列ソートの有効化

- ページ・デザイナでのクラシック・レポートの列リンクの作成

- ページ・デザイナでのクラシック・レポートへのダウンロード・リンクの追加

- ページ・デザイナでのクラシック・レポートの更新可能な列の定義

- ページ・デザイナでのクラシック・レポートの列の表示条件の制御

- ページ・デザイナでのクラシック・レポートのLOVとしての列定義

- ページ・デザイナでのクラッシック・レポートの列ブレークの制御

関連項目:

ページ・デザイナでのページの管理およびOracle Application Express APIリファレンスの「APEX_IR」

8.5.1.1 ページ・デザイナでのクラシック・レポート・レイアウトの変更

レポート属性ページの「列属性」セクションを使用すると、レポート・レイアウトを詳細に制御できます。たとえば、これらの属性を使用して、列ヘッダー・テキストの変更、列の位置の変更、列の非表示化、列の合計の作成、またはソート順序の選択を行うことができます。

列属性を編集するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. ページを選択します。

ページ・デザイナが表示されます。

2. 「レンダリング」タブで、リージョンを見つけて「列」ノードを展開します。

「レンダリング」タブに列が表示されます。

3. 編集する列を選択します

プロパティ・エディタにその列の属性が表示されます。

4. 対象となる属性を編集します。

属性は、機能グループに編成されます。これらのグループを展開または縮小するには、「共通の表示」、「すべて表示」、「すべて閉じる」および「すべて開く」アイコンをクリックします。

次の表に、レポート列の基本的な編集操作を示します。

表 8-11 クラシック・レポートのレポート列の基本的な編集操作

説明

開発者アクション

列を非表示にします。

「指定」を見つけて展開します。「タイプ」に、「非表示列」を選択します。

列ヘッダー・テキストを編集します。

「ヘッダー」を見つけて展開します。「ヘッダー」属性と「位置合せ」属性を編集します。

列ヘッダー・テキストの位置合せを変更します。

「ヘッダー」を見つけて展開します。「ヘッダー」で、「位置合せ」から新しく選択します。

列の表示順序を変更します。

「レイアウト」を見つけて展開します。「順序」属性を編集します。

一意のソート順序を有効にします。

「ソート」を見つけて展開します。「ソート可能」で、「はい」をクリックして「デフォルト順序」を選択します。

任意の数の列をソート可能にできます。ただし、1つ以上の列にソート順序が定義されている必要があります。

列の合計を有効にします。

「詳細」を見つけて展開します。「合計の計算」で、「はい」を選択します。

ヒント:

ヘルプを表示するには、属性を選択して「ヘルプ」タブをクリックします。「ヘルプ」ペインをアクティブ化すると、別の属性を選択するたびに表示されるコンテンツが変わります。

5. 変更を保存するには、「保存」をクリックします。ページを保存して実行するには、「ページの保存と実行」をクリックします。

8.5.1.2 ページ・デザイナでのクラシック・レポート属性の編集

ページ・デザイナでレポート属性を編集して、クラシック・レポートをカスタマイズできます。

レポート属性を編集するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. ページを選択します。

ページ・デザイナが表示されます。

2. 「レンダリング」タブで、レポートを含むリージョンを見つけます。

3. 「リージョン」で、「属性」ノードを選択します。

プロパティ・エディタに、プロパティ・エディタのレポート属性が表示されます。

属性は、機能グループに編成されます。これらのグループを展開または縮小するには、「共通の表示」、「すべて表示」、「すべて閉じる」および「すべて開く」アイコンをクリックします。

4. 対象となる属性を編集します。

5. ヘルプを表示するには、属性を選択して「ヘルプ」タブをクリックします。「ヘルプ」ペインをアクティブ化すると、別の属性を選択するたびに表示されるコンテンツが変わります。

6. 変更を保存するには、「保存」をクリックします。ページを保存して実行するには、「ページの保存と実行」をクリックします。

8.5.1.3 ページ・デザイナでのクラシック・レポートのページ区切りの編集

クラッシック・レポートのページ区切りを制御するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. ページを選択します。

ページ・デザイナが表示されます。

2. 「レンダリング」タブで、レポートを含むリージョンを見つけます。

3. 「リージョン」で、「属性」ノードを選択します。

プロパティ・エディタに、プロパティ・エディタのレポート属性が表示されます。

属性は、機能グループに編成されます。これらのグループを展開または縮小するには、「共通の表示」、「すべて表示」、「すべて閉じる」および「すべて開く」アイコンをクリックします。

4. 「ページ区切り」を見つけて展開します。

5. 「ページ区切り」で、次を編集します。

ヒント:

属性のヘルプを表示するには、プロパティ・エディタで属性を選択し、中央ペインで「ヘルプ」タブをクリックします。

a. タイプ - このレポートのページ区切りタイプを選択します。通常、結果のサブセットのみがレポートに当座表示されます。ページ区切りによって、結果セット内の行数および現在の位置に関する情報が提供されます。また、次のページまたは前のページへのナビゲートに使用するリンクまたはボタンのスタイルも定義されます。

b. 表示位置 - レポートのページ区切りの表示位置を選択します。

c. 部分ページ・リフレッシュ - 「部分ページ・リフレッシュ」(PPR)を使用してレポート表示を更新するかどうかを指定します。
エンド・ユーザーがページ区切りリクエストや新しいソート列の選択などのアクションを実行した場合、現在のレポート行をリフレッシュする必要があります。この属性を「はい」に設定すると、レポート・リージョンのみがリフレッシュされます。この属性を「いいえ」に設定すると、ページ全体がリフレッシュされます。

6. 変更を保存するには、「保存」をクリックします。ページを保存して実行するには、「ページの保存と実行」をクリックします。

8.5.1.4 ページ・デザイナでのクラシック・レポートのCSV出力オプションの有効化

CSV出力の有効化オプションを使用するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. ページを選択します。

ページ・デザイナが表示されます。

2. 「レンダリング」タブで、レポートを含むリージョンを見つけます。

3. 「リージョン」で、「属性」ノードを選択します。

プロパティ・エディタに、プロパティ・エディタのレポート属性が表示されます。

属性は、機能グループに編成されます。これらのグループを展開または縮小するには、「共通の表示」、「すべて表示」、「すべて閉じる」および「すべて開く」アイコンをクリックします。

4. 「ダウンロード」を見つけて展開します。

5. 「ダウンロード」で、次を編集します。

a. CSVエクスポートの有効化 - エンド・ユーザーがレポート・コンテンツをCSVファイルにダウンロードできるかどうかを指定します。CSVダウンロードを有効にするには、#CSV_LINK#置換文字列を持つレポート・テンプレートを使用し、このオプションを「はい」に設定する必要があります。

b. CSVセパレータ - 列セパレータを入力します。値が入力されていない場合は、現行のNLS設定に応じて、カンマまたはセミコロンが使用されます。

c. CSV囲み文字 - データ値の開始境界および終了境界を区切るデリミタ文字を入力します。デフォルトのデリミタは二重引用符です。

d. リンク・テキスト - CSVダウンロードを起動するリンクのテキストを指定します。

e. ファイル名 - CSVダウンロード・ファイルの名前を指定します。名前を指定しないと、拡張子*.csvが付いたリージョン名が使用されます。

ヒント:

属性のヘルプを表示するには、プロパティ・エディタで属性を選択し、中央ペインで「ヘルプ」タブをクリックします。

6. 変更を保存するには、「保存」をクリックします。ページを保存して実行するには、「ページの保存と実行」をクリックします。

8.5.1.5 ページ・デザイナでのXMLファイルまたはCSVファイル・エクスポートのサポートの追加

レポート・テンプレートを選択することで、XMLまたはCSVとしてレポートをエクスポートする操作のサポートを追加できます。

レポートをファイルとしてエクスポートするには、次のステップを実行します。

1. ページ・デザイナでページを表示します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. ページを選択します。

ページ・デザイナが表示されます。

2. 「レンダリング」タブで、レポートを含むリージョンを見つけます。

3. 「リージョン」で、「属性」ノードを選択します。

プロパティ・エディタに、プロパティ・エディタのレポート属性が表示されます。

属性は、機能グループに編成されます。これらのグループを展開または縮小するには、「共通の表示」、「すべて表示」、「すべて閉じる」および「すべて開く」アイコンをクリックします。

4. 「外観」を見つけて展開します。

5. 「外観」で、次を編集します。

a. テンプレート・タイプ - 「事前定義」を選択します。

b. テンプレート - 「XML」または「CSV」を選択します。
「XML」を選択すると、Application Expressエンジンでページがレンダリングされなくなり、コンテンツがXMLファイルにダンプされます。

ヒント:

属性のヘルプを表示するには、プロパティ・エディタで属性を選択し、中央ペインで「ヘルプ」タブをクリックします。

6. 変更を保存するには、「保存」をクリックします。ページを保存して実行するには、「ページの保存と実行」をクリックします。

8.5.1.6 ページ・デザイナでのクラシック・レポートの列ソートの有効化

列ソートを有効にするには、次のステップを実行します。

1. ページ・デザイナでページを表示します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. ページを選択します。

ページ・デザイナが表示されます。

2. 「レンダリング」タブで、リージョンを見つけて「列」ノードを展開します。
「レンダリング」タブに列が表示されます。

3. 編集する列を選択します

プロパティ・エディタにその列の属性が表示されます。

属性は、機能グループに編成されます。これらのグループを展開または縮小するには、「共通の表示」、「すべて表示」、「すべて閉じる」および「すべて開く」アイコンをクリックします。

4. 「ソート」を見つけて展開します。

5. 「ソート」で、次を編集します。

a. デフォルト順序 - この列のソート順序を選択します。正しい順序でレポート出力するには、各列に一意の順序を持たせます。

b. ソート可能 - ソートを有効化するには、「はい」を選択します。「はい」を選択すると、エンド・ユーザーがレポートでこの列をソートできます。

ヒント:

属性のヘルプを表示するには、プロパティ・エディタで属性を選択し、中央ペインで「ヘルプ」タブをクリックします。

6. 変更を保存するには、「保存」をクリックします。ページを保存して実行するには、「ページの保存と実行」をクリックします。

ヒント:

レポートの最初および最後にNULL値を含む列を表示する場合は、列のソートを有効にする必要があります。「NULLのソート」属性の詳細は、「クラッシック・レポートのページ区切りの制御」を参照してください

8.5.1.7 ページ・デザイナでのクラシック・レポートの列リンクの作成

レポートからアプリケーション内の別のページまたはURLへのリンクを作成するには、「列リンク」属性を使用します。

別のページへの列リンクを作成するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. ページを選択します。

ページ・デザイナが表示されます。

2. 「レンダリング」タブで、リージョンを見つけて「列」ノードを展開します。
「レンダリング」タブに列が表示されます。

3. 編集する列を選択します

プロパティ・エディタにその列の属性が表示されます。

属性は、機能グループに編成されます。これらのグループを展開または縮小するには、「共通の表示」、「すべて表示」、「すべて閉じる」および「すべて開く」アイコンをクリックします。

4. 「指定」を見つけて展開します。「タイプ」から、「リンク」を選択します。

5. 「リンク」を見つけて展開し、「リンクが定義されていません」をクリックします。
「リンク・ビルダー - ターゲット」ダイアログが表示されます。

6. 別のページへのリンクを作成するには、「リンク・ビルダー - ターゲット」ダイアログで次のステップを実行します。

a. タイプ: 「このアプリケーションのページ」を選択します。

b. ページ: ターゲット・ページ番号を指定します。

c. アイテムの設定: 「名前」および「値」を選択して、アイテムのセッション・ステートを指定します。

d. セッション・ステートのクリア、キャッシュのクリア: キャッシュをクリアするページ番号を指定します。複数ページを指定するには、ページ番号のカンマ区切りリストを入力します。

e. ページ区切りのリセット: 「はい」を選択して、このページのページ区切りをリセットします。

f. 詳細、リクエスト: 使用するリクエストを指定します。

g. 「OK」をクリックします。

7. URLへのリンクを作成するには、「リンク・ビルダー - ターゲット」ダイアログで次のステップを実行します。

a. タイプ: 「URL」を選択します。

b. URL: URLアドレスを入力します。

c. 「OK」をクリックします。

8. 変更を保存するには、「保存」をクリックします。ページを保存して実行するには、「ページの保存と実行」をクリックします。

8.5.1.8 ページ・デザイナでのクラシック・レポートへのダウンロード・リンクの追加

開発者は、レポート内にリンクを作成して、ユーザーがレポートをカンマ区切りファイル(.csv)としてエクスポートできるようにします。レポートにCSVリンクを追加するには、自動CSVエンコーディングを有効にする必要があります。自動CSVエンコーディングを使用する際、レポート・テンプレートは重要ではありません。CSVリンクは、CSVエクスポート置換文字列が定義されていればどのレポート・テンプレートに追加することもできます。

関連項目:

「グローバリゼーション属性のページへのアクセス」および「自動CSVエンコーディング」

8.5.1.9 ページ・デザイナでのクラシック・レポートの更新可能な列の定義

開発者は列属性を編集して、列を更新可能にすることができます。Application Expressエンジンは、次の場合にのみ更新を実行できることに注意してください。

- 複数行の更新が定義されている場合。

- 更新済データを処理するためにPL/SQLプロセスが実装されている場合。

- 組込み表形式フォームの要素および表示タイプを使用している場合、レポートは、SQL問合せ(更新可能レポート)のタイプを使用して定義する必要があります。

更新可能な列属性を定義するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. ページを選択します。

ページ・デザイナが表示されます。

2. 「レンダリング」タブで、次のようにします。

a. レポートを含むリージョンを探します。

b. 「列」ノードを展開します。

c. 更新する列を選択します。

3. プロパティ・エディタで、「指定」を展開して「タイプ」属性を編集します。

ヒント:

ヘルプを表示するには、属性を選択して「ヘルプ」タブをクリックします。「ヘルプ」ペインをアクティブ化すると、別の属性を選択するたびに表示されるコンテンツが変わります。

4. 変更を保存するには、「保存」をクリックします。ページを保存して実行するには、「ページの保存と実行」をクリックします。

8.5.1.10 ページ・デザイナでのクラシック・レポートの列の表示条件の制御

「認可」属性および「条件」属性を使用すると、列の表示条件を制御できます。

認可を使用すると、事前定義されたユーザー権限に基づいて(レポート列などの)リソースへのアクセスを制御できます。たとえば、マネージャのみが特定のレポート列を表示できる認可スキームを作成できます。認可スキームを選択するには、まずその認可スキームを作成する必要があります。

条件とは、事前定義された条件タイプに基づいた列の表示の制御を可能にする論理単位です。条件は、「式」フィールドに入力した値に基づいて、trueまたはfalseと評価されます。

認可属性および条件属性を指定するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. ページを選択します。

ページ・デザイナが表示されます。

2. 「レンダリング」タブで、レポートを含むリージョンを見つけて選択します。
プロパティ・エディタにリージョン属性が表示されます。

3. 認可スキームで列を制御する場合は、認可スキームを選択します。

a. 「セキュリティ」を見つけて展開します。

b. 認可スキーム - 選択します。

4. 条件で列を制御する場合は、条件を定義します。

a. 「サーバー側の条件」を見つけて展開します。

b. タイプ - 選択します。

c. 選択に応じて、指定のフィールドに式または値を入力します。

認可が正常に終了し、条件タイプの表示がtrueに評価されると、列が表示されます。

5. 変更を保存するには、「保存」をクリックします。ページを保存して実行するには、「ページの保存と実行」をクリックします。

関連項目:

- 認可を介したセキュリティの提供

- 条件付きのレンダリングおよびプロセスの理解

- 「使用可能な条件」

8.5.1.11 ページ・デザイナでのクラシック・レポートのLOVとしての列定義

列は、ラジオ・グループとしてレンダリングするか、静的LOV、名前付きLOVまたは問合せベースのLOVとしてレンダリングできます。たとえば、選択リストまたはポップアップLOVを使用して列をレンダリングできます。または、LOVに基づく読取り専用テキストとして列をレンダリングすることもできます。

この最後の方法は、表示参照値を作成する場合に効果的な手法であり、特に、更新できない通常のレポートで役立ちます。この方法を使用すると、SQL JOIN文を記述することなく、列の値を表示できます。

LOVとしてレポート列をレンダリングするには、次のステップを実行します。

1. ページ・デザイナでページを表示します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. ページを選択します。

ページ・デザイナが表示されます。

2. 「レンダリング」タブで、リージョンを見つけて「列」ノードを展開します。
「レンダリング」タブに列が表示されます。

3. 編集する列を選択します

プロパティ・エディタにその列の属性が表示されます。

属性は、機能グループに編成されます。これらのグループを展開または縮小するには、「共通の表示」、「すべて表示」、「すべて閉じる」および「すべて開く」アイコンをクリックします。

4. 「指定」を見つけて展開します。「タイプ」で「プレーン・テキスト(LOVに基づく)」を選択します。

5. 「LOV」を見つけて展開します。 「タイプ」を選択して、該当するフィールドに入力します。

6. 変更を保存するには、「保存」をクリックします。ページを保存して実行するには、「ページの保存と実行」をクリックします。

8.5.1.12 ページ・デザイナでのクラッシック・レポートの列ブレークの制御

ブレーク書式属性を使用すると、出力する場合に、特定の列を繰り返すかどうか、および列のブレーク方法を制御できます。たとえば、レポートに、部門番号ごとに従業員情報を表示するとします。複数の従業員が同じ部門に所属している場合、部門番号が1回のみ表示されるように指定することによって、読みやすさを向上できます。

このタイプの列ブレークを作成するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. ページを選択します。

ページ・デザイナが表示されます。

2. 「レンダリング」タブで、レポートを含むリージョンを見つけます。

3. 「リージョン」で、「属性」ノードを選択します。

プロパティ・エディタに、プロパティ・エディタのレポート属性が表示されます。

属性は、機能グループに編成されます。これらのグループを展開または縮小するには、「共通の表示」、「すべて表示」、「すべて閉じる」および「すべて開く」アイコンをクリックします。

4. ブレーク書式を指定します。

a. 「ブレーク書式」を見つけて展開します。

b. 「ブレーク列」で、ブレーク書式に組み込むレポート列の数を選択します。列は、レポートに表示されている最初の列から始まる連続した列である必要があります。

5. 変更を保存するには、「保存」をクリックします。ページを保存して実行するには、「ページの保存と実行」をクリックします。

8.5.2 レガシー・コンポーネント・ビューでのクラシック・レポートの編集

開発者は、コンポーネント・ビューでクラシック・レポートを作成および編集できます。レポート属性ページを使用すると、開発者はクラシック・レポートのレポート・レイアウト、ページ区切り、列ソート、エラー・メッセージ、エクスポート・リンクおよび列ブレークを制御できます。

トピック:

- コンポーネント・ビューでのクラシック・レポート属性の編集

- コンポーネント・ビューでのクラシック・レポート・レイアウトの変更

- コンポーネント・ビューでのクラッシック・レポートのページ区切りの制御

- コンポーネント・ビューでのクラシック・レポートの列ソートの有効化

- コンポーネント・ビューでのクラシック・レポートへのダウンロード・リンクの追加

- コンポーネント・ビューでのクラシック・レポートのCSV出力の有効化

- XMLファイルまたはCSVファイル・エクスポートのサポートの追加

- コンポーネント・ビューでのクラシック・レポートの列リンクの作成

- コンポーネント・ビューでの更新可能な列の定義

- コンポーネント・ビューでのクラシック・レポートのLOVとしての列定義

- コンポーネント・ビューでのクラシック・レポートの列の表示条件の制御

- コンポーネント・ビューでのクラッシック・レポートの列ブレークの制御

- クラシック・レポートの列の順序とリージョン・ソースの同期

関連項目:

「レガシー・コンポーネント・ビューでのページの管理」、「実行中のアプリケーションでの対話モード・レポートのカスタマイズ」および『Oracle Application Express APIリファレンス』のAPEX_IRに関する項

8.5.2.1 コンポーネント・ビューでのクラシック・レポート属性の編集

この項では、レポート属性を編集することによってクラシック・レポートをカスタマイズする方法について説明します。

レポート属性ページを表示するには、次のステップを実行します。

1. コンポーネント・ビューで、レポートを含むページを表示します。レガシー・コンポーネント・ビューでのページの表示
コンポーネント・ビューが表示されます。

2. レポート属性ページにアクセスするには、編集するレポート・リージョンの横にある「レポート」リンクをクリックします。

レポート属性ページが表示されます。このページは次のセクションに分かれています。

- 「列属性」はレポート・レイアウトを制御します。コンポーネント・ビューでのクラシック・レポート・レイアウトの変更を参照してください。

- 「レイアウトおよびページ区切り」属性はレポート・ページ区切りを制御します。コンポーネント・ビューでのクラッシック・レポートのページ区切りの制御を参照してください。

- 「メッセージ」の属性を使用すると、データが見つからない場合、または表示できる以上のデータが見つかった場合に表示されるメッセージを定義できます。

- 「レポートのエクスポート」属性を使用すると、レポートにダウンロード・リンクを追加するか、レポートをXMLファイルまたはCSVファイルとしてエクスポートできます。コンポーネント・ビューでのクラシック・レポートへのダウンロード・リンクの追加およびXMLファイルまたはCSVファイル・エクスポートのサポートの追加を参照してください。

- 「ブレーク書式」属性を使用すると、出力時に特定の列を繰り返すかどうか、および列をどのようにブレークするかを制御できます。コンポーネント・ビューでのクラッシック・レポートの列ブレークの制御を参照してください。

- 「外部プロセス」属性を使用すると、後処理用のURLおよびリンク・ラベルを指定できます。

3. 属性の詳細は、フィールドレベル・ヘルプを参照してください。フィールドレベル・ヘルプの表示を参照してください。

4. 変更を保存するには、「変更の適用」をクリックします。

8.5.2.2 コンポーネント・ビューでのクラシック・レポート・レイアウトの変更

レポート属性ページの「列属性」セクションを使用すると、レポート・レイアウトを詳細に制御できます。たとえば、これらの属性を使用して、列ヘッダー・テキストの変更、列の位置の変更、列の非表示化、列の合計の作成、またはソート順序の選択を行うことができます。

「列属性」にアクセスするには、次のステップを実行します。

1. クラシック・レポートの属性のページにアクセスします。コンポーネント・ビューでのクラシック・レポート属性の編集を参照してください。

ページ上部に「列属性」セクションがあるレポート属性ページが表示されます。

「列属性」セクションを使用して、レポート列の外観と機能を制御します。

「ヘッダー・タイプ」はレポートの見出しの生成方法を指定します。「リンク」列は列リンクが現在定義されているかどうかを示します。「編集」列は列が現在更新可能かどうかを示します。

表 8-12に、レポート列の基本的な編集操作を示します。

表 8-12 クラシック・レポートのレポート列の基本的な編集操作

説明

開発者アクション

列の表示順序を変更します。

上矢印および下矢印をクリックして、列の表示順序を変更します。

ヘッダーの位置合せを変更します。

「列の位置合せ」で、列の位置を選択します。

列ヘッダーのテキストを変更します。

「ヘッダー」で、異なるヘッダー・テキストを入力します。

表示する列を制御します。

「表示」をクリックして、列を表示させるようにします。

一意のソート順序を有効にします。

「ソート」をクリックし、「ソート順序」から順序番号を選択します。

任意の数の列をソート可能にできます。ただし、1つ以上の列にソート順序が定義されている必要があります。

列の合計を有効にします。

「合計」をクリックして、列の合計を有効にします。

列属性ページで、特定の列の属性をさらに詳細に指定できます。

2. 列属性ページにアクセスするには、該当する列の別名の横にある「編集」アイコンをクリックします。

3. 属性の詳細は、フィールドレベル・ヘルプを参照してください。フィールドレベル・ヘルプの表示を参照してください。

関連項目:

コンポーネント・ビューでのクラシック・レポートの列リンクの作成、コンポーネント・ビューでの更新可能な列の定義、コンポーネント・ビューでのクラシック・レポートのLOVとしての列定義およびコンポーネント・ビューでのクラシック・レポートの列の表示条件の制御を参照してください。

8.5.2.3 コンポーネント・ビューでのクラッシック・レポートのページ区切りの制御

この項では、クラシック・レポートでページ区切りを制御する方法について説明します。

トピック:

- クラシック・レポートのページ区切り

- クラシック・レポートのページ区切りの制御

- クラシック・レポート内での行の後へのページ区切りの挿入

- クラシック・レポート内での行の前へのページ区切りの挿入

8.5.2.3.1 クラシック・レポートのページ区切り

クラシック・レポートで、レポート・ページ区切りを制御する方法を次に示します。

- ページ区切り置換文字列をレポート・テンプレートに含める方法

- レポート属性ページの「レイアウトおよびページ区切り」セクションから選択する方法

「レポート属性」ページの「レイアウトおよびページ区切り」属性から選択することによって、ページ区切りの表示方法を制御します。

8.5.2.3.2 クラシック・レポートのページ区切りの制御

クラッシック・レポートのページ区切りを制御するには、次のステップを実行します。

1. クラシック・レポートの属性のページにアクセスします。コンポーネント・ビューでのクラシック・レポート属性の編集を参照してください。
レポート属性ページが表示されます。

2. 「レイアウトおよびページ区切り」で、次の項目を選択します。

a. レポート・テンプレート: レポート・テンプレートを選択します(オプション)。

b. ページ区切りスキーム: ページ区切りスキームを選択します。

c. 表示位置: 表示位置を選択します。

d. 行数: ページごとに表示する行数を指定します。

e. 「変更の適用」をクリックします。

3. プロパティ・エディタで、表8-13に示す属性を見つけて編集します。
属性の詳細は、フィールドレベル・ヘルプを参照してください。フィールドレベル・ヘルプの表示を参照してください。

表8-13 「レイアウトおよびページ区切り」属性

属性

説明

レポート・テンプレート

このレポートに適用するテンプレートを指定します。レポート・テンプレートによって、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値の列が必要かどうかを指定してください。

関連項目: コンポーネント・ビューでのクラシック・レポートの列ソートの有効化

8.5.2.3.3 クラシック・レポート内での行の後へのページ区切りの挿入

レポート内の行の後にページ区切りを挿入するには、次のステップを実行します。

1. レポートを作成します。ページの作成ウィザードを使用したレポートの作成を参照してください。

2. クラシック・レポートの属性のページにアクセスします。コンポーネント・ビューでのクラシック・レポート属性の編集を参照してください。
レポート属性ページが表示されます。

3. 「レイアウトおよびページ区切り」で、次を指定します。

a. レポート・テンプレート: レポート・テンプレートを選択します(オプション)。

b. ページ区切りスキーム: ページ区切りスキームを選択します。

c. 表示位置: 表示位置を選択します。

d. 行数: ページごとに表示する行数を指定します。

e. 「変更の適用」をクリックします。

4. レポート・テンプレートを編集します。

a. ページに移動します。レガシー・コンポーネント・ビューでのページの表示を参照してください。

b. 「テンプレート」で、レポート・テンプレート名を選択します。

c. 「行の後」属性に#PAGINATION#置換文字列を含めます。

d. 「変更の適用」をクリックします。

5. ページを実行します。

8.5.2.3.4 クラシック・レポート内での行の前へのページ区切りの挿入

レポート内の行の前にページ区切りを挿入するには、次のステップを実行します。

1. レポートを作成します。ページの作成ウィザードを使用したレポートの作成を参照してください。

2. クラシック・レポートの属性のページにアクセスします。コンポーネント・ビューでのクラシック・レポート属性の編集を参照してください。
レポート属性ページが表示されます。

3. 「レイアウトおよびページ区切り」で、次のステップを実行します。

a. レポート・テンプレート: レポート・テンプレートを選択します(オプション)。

b. ページ区切りスキーム: ページ区切りスキームを選択します。

c. 表示位置: topという語が使用されている位置を選択します。

d. 行数: ページごとに表示する行数を指定します。

e. 「変更の適用」をクリックします。

4. レポート・テンプレートを編集します。

a. ページに移動します。レガシー・コンポーネント・ビューでのページの表示を参照してください。

b. 「テンプレート」で、レポート・テンプレート名を選択します。

c. 「行の前」属性に#TOP_PAGINATION#置換文字列を含めます。

d. 「変更の適用」をクリックします。

5. ページを実行します。

8.5.2.4 コンポーネント・ビューでのクラシック・レポートの列ソートの有効化

レポート属性ページで列ソートを有効にできます。

列ソートを有効にするには、次のステップを実行します。

1. クラシック・レポートの属性のページにアクセスします。コンポーネント・ビューでのクラシック・レポート属性の編集を参照してください。

レポート属性ページが表示されます。

2. 「列属性」で、ソートする列の横にある「ソート」チェック・ボックスを選択します。

3. 「ソート順序」から、順序番号を選択します。

「ソート順序」はオプションです。ただし、ソート可能な列が1列以上ある場合は、定義済のソート順序が1列以上で必要です。

4. 「変更の適用」をクリックします。

ヒント:

レポートの最初および最後にNULL値を含む列を表示する場合は、列のソートを有効にする必要があります。

8.5.2.5 コンポーネント・ビューでのクラシック・レポートへのダウンロード・リンクの追加

レポート内にリンクを作成して、ユーザーがレポートをカンマ区切りファイル(.csv)としてエクスポートできるようにします。CSVリンクをレポートに追加するには、CSV出力オプションを有効にする必要があります。CSV出力オプションを使用する際、レポート・テンプレートは重要ではありません。CSVリンクは、CSVエクスポート置換文字列が定義されていればどのレポート・テンプレートに追加することもできます。

関連項目:

自動CSVエンコーディング

8.5.2.6 コンポーネント・ビューでのクラシック・レポートのCSV出力の有効化

CSV出力の有効化オプションを使用するには、次のステップを実行します。

1. クラシック・レポートの属性のページにアクセスします。コンポーネント・ビューでのクラシック・レポート属性の編集を参照してください。

レポート属性ページが表示されます。

2. 「レポートのエクスポート」までスクロールします。

3. 「CSV出力の有効化」から、「はい」を選択します。

4. (オプション)「セパレータ」および「囲み文字」フィールドで、セパレータおよびデリミタを定義します。

デフォルトの囲み文字は、二重引用符(" ")です。デフォルトのデリミタは、カンマまたはセミコロンで、現在のNLS設定によって異なります。

5. 「リンク・ラベル」で、リンク・テキストを入力します。このテキストは、レポート内に表示され、ユーザーはダウンロードを起動できます。

6. (オプション)デフォルトのエクスポート・ファイル名を指定するには、「ファイル名」フィールドに名前を入力します。

デフォルトでは、Application Expressエンジンによって、リージョン名が取得され、該当するファイル名の拡張子(.csvまたは.xml)が追加されて、エクスポート・ファイル名が作成されます。

7. 「変更の適用」をクリックします。

8.5.2.7 XMLファイルまたはCSVファイル・エクスポートのサポートの追加

レポート・テンプレートを選択することで、XMLまたはCSVとしてレポートをエクスポートする操作のサポートを追加できます。

レポートをファイルとしてエクスポートするには、次のステップを実行します。

1. クラシック・レポートの属性のページにアクセスします。コンポーネント・ビューでのクラシック・レポート属性の編集を参照してください。

レポート属性ページが表示されます。

2. 「レイアウトおよびページ区切り」までスクロールします。

3. 「レポート・テンプレート」リストから、「エクスポート: XML」または「エクスポート: CSV」を選択します。

「エクスポート: XML」を選択すると、Application Expressエンジンでページがレンダリングされなくなり、コンテンツがXMLファイルにダンプされます。

4. 「変更の適用」をクリックします。

8.5.2.8 コンポーネント・ビューでのクラシック・レポートの列リンクの作成

この項では、アプリケーション内の別のページまたはURLへの列リンクを作成する方法について説明します。

トピック:

- 別のページへの列リンクの作成

- URLへの列リンクの作成

8.5.2.8.1 別のページへの列リンクの作成

別のページへの列リンクを作成するには、次のステップを実行します。

1. クラシック・レポートの属性のページにアクセスします。コンポーネント・ビューでのクラシック・レポート属性の編集を参照してください。
レポート属性ページが表示されます。

2. 「列属性」で、リンクを含む列を指定します。

3. 列名の横にある「編集」アイコンをクリックします。
列属性ページが表示されます。

4. 「列リンク」までスクロールします。

5. 別のページへの列リンクを作成するには、次のステップを実行します。

a. 「ターゲット」で、「このアプリケーションのページ」を選択します。

b. (オプション)「リンク属性」で、<a href= >タグに含める追加の列リンク属性(リンク・ターゲット、クラス、スタイルなど)を指定します。

c. 「リンク・テキスト」で、リンクとして表示されるテキストを入力するか、イメージ・タグを指定するか、またはデフォルトのイメージのリストから選択します。

d. 「ページ」で、ターゲット・ページ番号を指定します。このページのページ区切りをリセットするには、「ページ区切りのリセット」を選択します。

e. 「リクエスト」で、使用するリクエストを指定します。

f. 「キャッシュのクリア」で、キャッシュをクリアするページ(ページ番号)を指定します。ページ番号をカンマで区切ってリストすることによって、複数のページを指定できます。対話モード・レポートへのリンクの設定を参照してください。

g. 特定のアイテムのセッション・ステートを指定するには、「名前」フィールドおよび「値」フィールドを使用します。

6. 「変更の適用」をクリックします。

8.5.2.8.2 URLへの列リンクの作成

URLへの列リンクを作成するには、次のステップを実行します。

1. クラシック・レポートの属性のページにアクセスします。コンポーネント・ビューでのクラシック・レポート属性の編集を参照してください。
レポート属性ページが表示されます。

2. 該当する列の横にある「編集」アイコンをクリックして、列属性ページにアクセスします。
列属性ページが表示されます。

3. 「列リンク」までスクロールします。

4. 「列リンク」で、次のように指定します。

a. 「ターゲット」から「URL」を選択します。

b. 「リンク・テキスト」で、リンクとして表示されるテキストを入力し、置換文字列を選択します。

c. (オプション)「リンク属性」で、<a href= >タグに含める追加の列リンク属性(リンク・ターゲット、クラス、スタイルなど)を指定します。

d. 「URL」で、該当するアドレスを入力します。

5. 「変更の適用」をクリックします。

8.5.2.9 コンポーネント・ビューでの更新可能な列の定義

列属性ページの「表形式フォームの要素」属性を編集することで更新可能な列を作成できます。Application Expressエンジンは、次の場合にのみ更新を実行できることに注意してください。

- 複数行の更新が定義されている場合

- 更新済データを処理するためにPL/SQLプロセスが実装されている場合

- 組込み表形式フォームの要素および表示タイプを使用している場合、レポートは、SQL問合せ(更新可能レポート)のタイプを使用して定義する必要があります。

更新可能な列属性を定義するには、次のステップを実行します。

1. クラシック・レポートの属性のページにアクセスします。コンポーネント・ビューでのクラシック・レポート属性の編集を参照してください。
レポート属性ページが表示されます。

2. 該当する列の横にある「編集」アイコンをクリックして、列属性ページにアクセスします。
列属性ページが表示されます。

3. 「列属性」で、次のように指定します。

a. 表示形式: 更新可能な列の型を選択します。
列を更新可能にするには、このオプションを使用します。更新は、複数行の更新が定義されている場合、または更新済データを処理するためにPL/SQLプロセスが実装されている場合にのみ実行できます。

b. 数値/日付書式: 「日付ピッカー」の「表示形式」タイプを選択している場合は選択を行います。

c. 要素の幅: フォーム・アイテムの幅を指定します。

d. 行数: テキスト領域に適応するフォーム・アイテムの高さを指定します。

e. 要素属性: スタイルまたは標準のフォーム要素属性を定義します。

f. 要素オプションの属性: ラジオ・グループまたはチェック・ボックス内のアイテムのフォーム要素属性を指定します。

4. 「表形式フォームの属性」で、次のように指定します。

a. デフォルト・タイプ: デフォルトのタイプを指定します。

b. デフォルト: デフォルトのソースを指定します。

c. 参照表の所有者: 参照される表の所有者を指定します。この属性では、アプリケーション間の列の参照を「ユーザー・インタフェースのデフォルト値」と比較します。この参照は、ウィザードによる初期化後、可能であれば手動で維持します。

d. 参照表名: 対象の列が参照する表またはビューを指定します。この属性では、アプリケーション間の列の参照を「ユーザー・インタフェースのデフォルト値」と比較します。この参照は、ウィザードによる初期化後、可能であれば手動で維持します。

e. 参照列名: 対象のレポート列が参照する列名を指定します。この属性では、アプリケーション間の列の参照を「ユーザー・インタフェースのデフォルト値」と比較します。この参照は、ウィザードによる初期化後、可能であれば手動で維持します。

5. 「変更の適用」をクリックします。

8.5.2.10 コンポーネント・ビューでのクラシック・レポートのLOVとしての列定義

列は、ラジオ・グループとしてレンダリングするか、静的LOV、名前付きLOVまたは問合せベースのLOVとしてレンダリングできます。たとえば、選択リストまたはポップアップLOVを使用して列をレンダリングできます。または、LOVに基づく読取り専用テキストとして列をレンダリングすることもできます。

この最後の方法は、表示参照値を作成する場合に効果的な手法であり、特に、更新できない通常のレポートで役立ちます。この方法を使用すると、SQL JOIN文を記述することなく、列の値を表示できます。

LOVとしてレポート列をレンダリングするには、次のステップを実行します。

1. クラシック・レポートの属性のページにアクセスします。コンポーネント・ビューでのクラシック・レポート属性の編集を参照してください。
レポート属性ページが表示されます。

2. 該当する列の横にある「編集」アイコンをクリックして、列属性ページにアクセスします。
列属性ページが表示されます。次に、列のレンダリング方法(ラジオ・グループ、LOV、選択リストなど)を指定します。

3. 「列属性」で、「表示形式」リストから選択します。

4. 「LOV」までスクロールします。

5. 「名前付きLOV」で、LOVリポジトリから選択します。

6. LOVにNULL値を含めるには、次のステップを実行します。

a. NULLの表示: 「はい」を選択します。

b. NULL表示値: ここにNULLオプションの表示値を入力します。

c. NULL戻り値: 対象のアイテムのLOVに使用するNULL値を入力します。値を指定しなかった場合のデフォルトは%null%です。

また、列には、LOVで表示されない値を格納することもできます。

7. LOVで表示されない値を定義するには、次のステップを実行します。

a. 「追加値の表示」で、「はい」を選択します。
追加値は、実際の列値がLOVの一部ではない場合に使用されます。このような場合は、実際の値が表示されます。追加値を表示しない場合は、誤った値になる可能性があり、データが不適切に自動更新されます。

b. 「NULL値」で、表示する値を指定します。

c. 名前付きLOVを選択していない場合は、「LOV問合せ」フィールドに選択リストを表示するための問合せを入力します。

8. 名前付きLOVを選択していない場合、LOV定義に選択リストを表示するために使用する問合せを入力します。

9. 「変更の適用」をクリックします。

8.5.2.11 コンポーネント・ビューでのクラシック・レポートの列の表示条件の制御

「認可」属性および「条件」属性を使用すると、列の表示条件を制御できます。

認可を使用すると、事前定義されたユーザー権限に基づいて(レポート列などの)リソースへのアクセスを制御できます。たとえば、マネージャのみが特定のレポート列を表示できる認可スキームを作成できます。認可スキームを選択するには、まずその認可スキームを作成する必要があります。

条件とは、事前定義された条件タイプに基づいた列の表示の制御を可能にする論理単位です。条件は、「式」フィールドに入力した値に基づいて、trueまたはfalseと評価されます。

認可属性および条件属性を指定するには、次のステップを実行します。

1. クラシック・レポートの属性のページにアクセスします。コンポーネント・ビューでのクラシック・レポート属性の編集を参照してください。

レポート属性ページが表示されます。

2. 該当する列の横にある「編集」アイコンをクリックして、列属性ページにアクセスします。

列属性ページが表示されます。

3. 認可スキームで列を制御する場合は、「認可スキーム」リストから選択します。

4. 条件で列を制御する場合は、条件を定義し、「条件タイプ」リストから選択します。選択に応じて、適切な「式」フィールドに式または値を入力します。

認可が正常に終了し、条件タイプの表示がtrueに評価されると、列が表示されます。

関連項目:

認可を介したセキュリティの提供、条件付きのレンダリングおよびプロセスの理解および使用可能な条件

8.5.2.12 コンポーネント・ビューでのクラッシック・レポートの列ブレークの制御

ブレーク書式属性を使用すると、出力する場合に、特定の列を繰り返すかどうか、および列のブレーク方法を制御できます。たとえば、レポートに、部門番号ごとに従業員情報を表示するとします。複数の従業員が同じ部門に所属している場合、部門番号が1回のみ表示されるように指定することによって、読みやすさを向上できます。

このタイプの列ブレークを作成するには、次のステップを実行します。

1. クラシック・レポートの属性のページにアクセスします。コンポーネント・ビューでのクラシック・レポート属性の編集を参照してください。

レポート属性ページが表示されます。

2. 「ブレーク書式」までスクロールします。

3. 「ブレーク」リストから選択します。

8.5.2.13 クラシック・レポートの列の順序とリージョン・ソースの同期

クラシック・レポートの列の順序を、リージョン・ソースの問合せで定義された列の順序と同期化するには、次のステップを実行します。

1. クラシック・レポートの属性のページにアクセスします。コンポーネント・ビューでのクラシック・レポート属性の編集を参照してください。

レポート属性ページが表示されます。

2. 「タスク」から、「列の順序とリージョン・ソースの同期化」を選択します。

3. 「同期化」をクリックします。

8.6 レポート・リージョンの出力

ヒント:

Oracle Application ExpressをOracle Database 11g リリース1 (11.1)以上で実行している場合は、レポート出力を使用するためにネットワーク・サービスを有効にする必要があります。「Oracle Database 11g以上のネットワーク・サービスの有効化」を参照してください。

いくつかの異なる形式にエクスポートすることによって、出力するレポート・リージョンを構成できます。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へのレポート出力について

- レポート出力の構成オプションについて

- クラシック・レポートの出力メソッドについて

- クラシック・レポート・リージョンの出力属性の構成

- 対話モード・レポート・リージョンの出力属性の構成

- レポート問合せについて

- レポート・レイアウトについて

8.6.1 PDFへのレポート出力について

レポートをPDFに出力するには、インスタンスレベルで定義したレポート・サーバーを使用して、データを変換する必要があります。エンド・ユーザーの観点では、単に出力リンクをクリックします。ただし、開発者の観点では、PDF出力をサポートするリージョンを宣言的に作成する必要があります。

8.6.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のインストールおよび構成の詳細は、「レポート出力の構成オプションについて」を参照してください。

注意:

レポート出力の機能をすべて使用するには、Oracle Application Expressのサービス管理者がこの機能をインスタンスで有効にする必要があります。Oracle Application Express管理ガイドの「レポート出力の構成」を参照してください。

8.6.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で開く)および「HTML」(ドキュメントをHTMLファイルとしてダウンロードする)です。

関連項目:
レポート・レイアウトを使用したレポート・リージョンまたはレポート問合せのフォーマット

8.6.4 クラシック・レポート・リージョンの出力属性の構成

レポート・リージョンを出力する方法の1つは、出力属性を構成する方法です。構成した属性は、現行のリージョンのみに適用され、リージョンのコンテキスト以外では使用できません。インスタンスに対して出力機能が設定されている場合、様々な形式で出力できるようにレポート・リージョンを構成できます。

トピック:

- ページ・デザイナでのクラシック・レポート出力属性の構成

- コンポーネント・ビューでのクラシック・レポート出力属性の構成

関連項目:

クラシック・レポートの出力メソッドについておよびOracle Application Express管理ガイドの「レポート出力の構成」

8.6.4.1 ページ・デザイナでのクラシック・レポート出力属性の構成

出力用にクラシック・レポート・リージョンを構成するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. ページを選択します。

ページ・デザイナが表示されます。

2. 「レンダリング」タブで、レポートを含むリージョンを見つけます。

3. レポートで、「属性」ノードを選択します。

プロパティ・エディタに、プロパティ・エディタのレポート属性が表示されます。

属性は、機能グループに編成されます。これらのグループを展開または縮小するには、「共通の表示」、「すべて表示」、「すべて閉じる」および「すべて開く」アイコンをクリックします。

4. 出力を有効にします。

a. プロパティ・エディタで、「出力」を見つけて展開します。

b. 「有効」で、「はい」を選択します。

5. 「レンダリング」タブで、「属性」ノードを展開して「出力」ノードを選択します。
プロパティ・エディタに出力属性が表示されます。

6. 出力属性を編集します。

ヒント:

属性のヘルプを表示するには、プロパティ・エディタで属性を選択し、中央ペインで「ヘルプ」タブをクリックします。

7. 変更を保存するには、「保存」をクリックします。ページを保存して実行するには、「ページの保存と実行」をクリックします。

8.6.4.2 コンポーネント・ビューでのクラシック・レポート出力属性の構成

出力用にクラシック・レポート・リージョンを構成するには、次のステップを実行します。

1. アプリケーションで、出力する対話モード・レポート・リージョンを含むページを選択します。
ページが表示されます。

2. 「リージョン」で、出力するリージョンの横にある「出力」リンクをクリックします。
出力属性ページが表示されます。

3. 「出力」で、次の該当する情報を指定します。

a. レポート出力の有効化: 「はい」を選択します。

b. リンク・ラベル: 出力プロセスを開始するリンクのテキストを入力します。

c. レスポンス・ヘッダー: Oracle Application Expressにより生成されたレスポンス・ヘッダーは、「レポート設定」または「プリント・サーバー」に基づきます。レスポンス・ヘッダーは、HTTPリクエストを受信した応答としてサーバーがブラウザに送信する情報です。レスポンス・ヘッダーには、サーバーがクライアントに送信するファイルの日付、サイズ、タイプに加えて、サーバー自体に関するデータも含まれています。コンテンツ配置(「ファイルの表示形式」属性を使用)およびファイル名を指定する場合、レスポンス・ヘッダーはレポート設定に基づいている必要があります。

d. ファイルの表示形式: レポート問合せドキュメントをWebブラウザでどのように開くかを選択します。オプションは次のとおりです。

- 添付ファイル: レポート問合せのダウンロード・ボタンをクリックすると、ファイルを開く/保存のダイアログ・ボックスが表示されます。

- インライン: レポート問合せドキュメントがブラウザ・ウィンドウ内に表示されます。

e. (オプション)ファイル名: ダウンロードされるファイルの名前を入力してください。これを空白のままにすると、リージョン名がファイル名として使用されます。

f. 出力形式: 出力オプションを選択します。

g. アイテム: 「出力形式」で「アイテムから導出」を選択した場合にのみ有効になります。有効な場合、形式値を保持するアプリケーション・アイテムまたはページ・アイテムを選択します。

h. レポート・レイアウト: 組込みの汎用レポート・レイアウトを使用する場合は、「デフォルト・レポート・レイアウト」を選択します。自分または管理者が作成したレポート・レイアウトを選択することもできます。
カスタムXSL-FOレポート・レイアウトを構築する場合に使用可能な置換文字列のリストについては、フィールドレベル・ヘルプを参照してください。

i. プリント・サーバーの上書き: 代替のプリント・サーバーを指定します。プリント・サーバーは通常、Oracle Application Express管理サービスのすべてのワークスペースについて一元的に設定されます。Oracle Application Express管理ガイドの「レポート出力の構成」を参照してください。
代替プリント・サーバーをレポート・レベルで構成すると、出力で予想される問題のデバッグと診断が簡単になり、カスタム作成した特定のエンド・ポイントを使用してカスタムのXSLT変換を実行することが可能になります。

j. 出力URL: レポート・リージョンは、標準の出力リンク、またはページ・ボタンを使用して出力できます。ボタンを使用する場合、リンク・ラベルを削除し、ページにボタンを作成し、この属性に表示されるURLをボタン・ターゲットとして使用します。

4. 残りのセクションで、ページ・サイズ、用紙の向き、ページのヘッダーおよびフッター、フォント、テキストの色、背景の色を定義します。

5. 「レポート列」で、各列の幅を指定します。
デフォルトでは、各列の幅は同じになります。「合計幅」は表示専用フィールドであり、すべての列幅の合計を示します。個々の列の幅を変更すると、「合計幅」は自動的に再計算されます。「列幅の単位」が「ポイント」ではなく「割合」に設定されている場合は、列幅の合計を100以下にする必要があります。

「列幅のリセット」ボタンをクリックすると、「列幅の単位」が「割合」になり、すべての列幅がそれぞれのデフォルト値に戻ります。「再計算」ボタンをクリックすると、列幅の割合は現在の値を維持したままで、合計幅が100%以下になるように、すべての列幅が縮小されます。

6. 「変更の適用」をクリックします。

8.6.5 対話モード・レポート・リージョンの出力属性の構成

対話モード・レポートの出力属性は、クラシック・レポートの場合とは異なり、デフォルトのXSL-FOレイアウトのみを使用できます。また、この画面から直接開始するのではなく、「レポート属性」の「ダウンロード」セクションからのみ開始できます。構成した属性は、現行のリージョンのみに適用され、リージョンのコンテキスト以外では使用できません。

インスタンスに対して出力機能が設定されている場合、様々な形式で出力できるようにレポート・リージョンを構成できます。

トピック:

- ページ・デザイナでの出力用の対話モード・レポート・リージョンの構成

- レガシー・コンポーネント・ビューでの出力用の対話モード・レポート・リージョンの構成

8.6.5.1 ページ・デザイナでの出力用の対話モード・レポート・リージョンの構成

出力用に対話モード・レポート・リージョンを構成するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. ページを選択します。

ページ・デザイナが表示されます。

2. 「レンダリング」タブで、レポートを含むリージョンを見つけます。

3. 「リージョン」で、「属性」ノードを選択します。

プロパティ・エディタに、プロパティ・エディタのレポート属性が表示されます。

属性は、機能グループに編成されます。これらのグループを展開または縮小するには、「共通の表示」、「すべて表示」、「すべて閉じる」および「すべて開く」アイコンをクリックします。

4. 「属性」ノードを展開して「出力」ノードを選択します。

プロパティ・エディタに出力属性が表示されます。

5. 適切な出力属性を編集します。

ヒント:

属性のヘルプを表示するには、プロパティ・エディタで属性を選択し、中央ペインで「ヘルプ」タブをクリックします。

6. 変更を保存するには、「保存」をクリックします。ページを保存して実行するには、「ページの保存と実行」をクリックします。

8.6.5.2 レガシー・コンポーネント・ビューでの出力用の対話モード・レポート・リージョンの構成

出力用に対話モード・レポート・リージョンを構成するには、次のステップを実行します。

1. アプリケーションで、出力する対話モード・レポート・リージョンを含むページを選択します。
ページが表示されます。

2. 「リージョン」で、出力するリージョンの横にある「対話モード・レポート」をクリックします。

3. 「出力属性」タブをクリックします。

4. 「出力」で、次の該当する情報を指定します。

a. レスポンス・ヘッダー: Oracle Application Expressにより生成されたレスポンス・ヘッダーは、「レポート設定」または「プリント・サーバー」に基づきます。レスポンス・ヘッダーは、HTTPリクエストを受信した応答としてサーバーがブラウザに送信する情報です。レスポンス・ヘッダーには、サーバーがクライアントに送信するファイルの日付、サイズ、タイプに加えて、サーバー自体に関するデータも含まれています。コンテンツ配置(「ファイルの表示形式」属性を使用)およびファイル名を指定する場合、レスポンス・ヘッダーはレポート設定に基づいている必要があります。

b. ファイルの表示形式: レポート問合せドキュメントをWebブラウザでどのように開くかを選択します。オプションは次のとおりです。

- 添付ファイル: レポート問合せのダウンロード・ボタンをクリックすると、ファイルを開く/保存のダイアログ・ボックスが表示されます。

- インライン: レポート問合せドキュメントがブラウザ・ウィンドウ内に表示されます。

c. プリント・サーバーの上書き: 代替のプリント・サーバーを指定します。プリント・サーバーは通常、Oracle Application Express管理サービスのすべてのワークスペースについて一元的に設定されます。Oracle Application Express管理ガイドの「レポート出力の構成」を参照してください。
代替プリント・サーバーをレポート・レベルで構成すると、出力で予想される問題のデバッグと診断が簡単になり、カスタム作成した特定のエンド・ポイントを使用してカスタムのXSLT変換を実行することが可能になります。

5. 残りのセクションで、ページ・サイズ、用紙の向き、ページのヘッダーおよびフッター、フォント、テキストの色、背景の色を定義します。

6. 「変更の適用」をクリックします。

8.6.6 レポート問合せについて

レポート・リージョンは、レポート問合せを共有コンポーネントとして定義することによって出力できます。レポート問合せは、抽出されるデータを識別します。リージョンに含まれるSQL文とは異なり、レポート問合せには、問合せを保存すると有効化されるSQL文が含まれます。レポート問合せは、SQL文を戻すファンクションではなく、SQL文である必要があります。

関連項目:

レポート問合せの定義によるレポート・リージョンの印刷

8.6.7 レポート・レイアウトについて

クラシック・レポート・リージョンまたはレポート問合せのどちらかをフォーマットするには、レポート・レイアウトと関連付けます。レポート・レイアウトを使用すると、印刷用形式でデータをレンダリングできます。レポート・レイアウトを選択しない場合は、デフォルトのXSL-FOレイアウトが使用されます。対話モード・レポートのリージョンのレンダリングでは、常にデフォルトのXSL-FOレイアウトが使用されます。

関連項目:

レポート・レイアウトを使用したレポート・リージョンまたはレポート問合せのフォーマット

8.7 フォームおよびレポートでのBLOBサポートの理解

Oracle Application Expressでは、宣言的なBLOBサポートが提供されているため、開発者はフォームでのファイルの宣言的なアップロードや、レポートでのファイルのダウンロードおよび表示を行うことができます。BLOBの表示とダウンロードは、PL/SQLを使用して手続き的に作成することもできます。このセクションでは、ファイルのアップロード、ダウンロードおよび表示を行う方法と、BLOB列に格納されているファイルを正しく管理するために重要となる追加のファイル属性(MIMEタイプやファイル名など)の管理方法について説明します。この機能を使用すると、簡単にOracle Application Expressアプリケーションを拡張して、イメージ、ドキュメント、ビデオなどのファイルを管理できます。

トピック:

- レポートでのBLOBサポートについて

- ダウンロード・リンクの提供について

- BLOBの表示について

- 手続き的なBLOBの使用について

8.7.1 レポートでのBLOBサポートについて

Oracle Application Expressでは、従来のレポートと対話モード・レポートの両方に対するBLOBサポートが提供されています。ウィザードを使用してレポートを作成し、BLOBタイプの列を含める場合は、基本的なサポートが含まれます。ダウンロード機能を使いやすくするために、生成後に詳細情報を追加する必要があります。

8.7.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列属性リージョンが表示され、前述のすべてのパラメータを入力できます。

8.7.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列属性が表示され、上述の説明に従って、すべてのパラメータを記入できます。

8.7.4 手続き的なBLOBの使用について

ダウンロード・リンクを指定した組込み方式を使用するかわりに、APEX_UTIL.GET_BLOB_FILE_SRCファンクションを使用できます。この方法を使用すると、イメージの表示形式をより具体的に設定できます(高さタグおよび幅タグを使用)。この方法は、有効なOracle Application Expressセッションからコールされた場合にのみ有効です。また、BLOBを記述するパラメータを、アプリケーション内の有効なアイテムの書式としてリストする必要もあります。この項目は後でファンクションが参照します。

関連項目:

Oracle Application Express APIリファレンスの「GET_BLOB_FILE_SRCファンクション」

9 フォームの開発

開発者は、手動で、またはウィザードを使用して、様々なアプリケーション・フォームを作成できます。フォームの中には、ユーザーが表の単一行を更新できるものや、表の複数行を更新できるものがあります。

トピック:

- フォーム・タイプの理解

- フォームの作成

- 対話グリッドを編集可能にする操作の概要

- マスター・ディテール・フォームの管理

- フォームでのユーザー入力の検証

- フォームでのBLOBサポートの理解

関連項目:

- 「レガシー・マスター・ディテール・フォームの作成」

- 「レガシー表形式フォームの管理」

- 「レポートの開発」

9.1 フォーム・タイプの理解

データベース・アプリケーションを作成する場合、開発者は編集可能対話グリッド、表のフォームまたはマスター・ディテールという3つの基本的なフォーム・タイムを作成できます。

トピック:

- 編集可能対話グリッド

- 表のフォーム

- マスター・ディテール・フォーム

関連項目:

レガシー・マスター・ディテール・フォームの作成

9.1.1 編集可能対話グリッド

対話グリッドでは、検索およびカスタマイズ可能なレポートのデータのセットがユーザーに表示されます。編集可能対話グリッドでは、ユーザーはページ上で直接データ・セットを追加、変更およびリフレッシュすることもできます。機能面では、対話グリッドには、対話モード・レポートで使用可能な多くのカスタマイズ機能と、マウスを使用して対話的にレポートを再配置する機能が含まれています。

次に、編集可能対話グリッドの例を示します。

関連項目:

『Oracle Application Expressアプリケーション・エンド・ユーザー・ガイド』の編集可能対話グリッドの使用に関する項

9.1.2 表のフォーム

データベース表の単一行を更新できるフォームを作成します。フォームを構築する表を選択できます。

次に、表のフォームの例を示します。

関連項目:

ページの作成ウィザードを使用したフォームの作成

9.1.3 マスター・ディテール・フォーム

マスター・ディテール・フォームは、データベースの2つの表の1対多関係を示します。通常、マスター・ディテール・フォームには、1つのHTMLフォーム内にマスター行および複数のディテール行が表示されます。このフォームを使用すると、2つの表またはビューに対し、値の挿入、更新および削除を行うことができます。Oracle Application Expressでは、開発者は1ページまたは2ページのマスター・ディテールを作成できます。

1ページのマスター・ディテール

1ページのマスター・ディテールには、2つの関連する表またはビューに基づく2つの編集可能対話グリッドがあります。ユーザーは、マスター・グリッドの行を選択して、ディテール・グリッドを更新します。この例では、ユーザーがマスター・グリッドの部門を選択して、ディテール・グリッドの従業員を表示します。開発者は、アプリケーションの作成ウィザードまたはページの作成ウィザードを使用して、1ページのマスター・ディテールを作成できます。

2ページのマスター・ディテール

2ページのマスター・ディテールには、2つの関連する表またはビューに基づく2つのページがあります。最初のページは、編集不能対話グリッドです。ユーザーは、最初のページで「編集」アイコンをクリックし、2ページ目でアクセス詳細を編集します。2ページ目には、フォームと編集可能対話グリッドの両方が含まれています。開発者は、ページの作成ウィザードを使用して2ページのマスター・ディテールを作成できます。

この例では、ユーザーが「編集」アイコンをクリックして、部門内のすべての従業員を表示します。2ページ目には、部門の詳細を示すフォームと従業員の編集可能対話グリッドが含まれます。

9.2 フォームの作成

開発者は、アプリケーションの作成ウィザード、ページの作成ウィザード、リージョンの作成ウィザードなど、多数のウィザードを使用してフォームを作成できます。使用可能なフォームは、選択したアプリケーション・ユーザー・インタフェース(デスクトップやモバイルなど)に応じて異なることに注意してください。

ヒント:

ウィザードには、表を選択するものもあれば、SQL問合せを指定するものもあります。SQL問合せの記述が不明な場合は、「クエリー・ビルダー」ボタンをクリックします。『Oracle Application Express SQLワークショップ・ガイド』のクエリー・ビルダーの使用に関する項を参照してください。

トピック:

- ページの作成ウィザード実行時のフォーム・オプション

- ページの作成ウィザードを使用したフォームの作成

- アプリケーションの作成ウィザードを使用したフォームの作成

- レガシー・コンポーネント・ビューでのフォームの手動作成

- ページ・デザイナでのフォーム・リージョンの作成

関連項目:

- 「レポートの開発」

- 「レガシー表形式フォームの管理」

- 「レガシー・マスター・ディテール・フォームの作成」

9.2.1 ページの作成ウィザード実行時のフォーム・オプション

アプリケーションを作成するときに、ターゲット・ユーザー・インタフェースを選択します。選択するユーザー・インタフェースにより、使用可能なフォームが決まります。

デスクトップ・アプリケーションに使用可能なフォーム

デスクトップ・アプリケーションを作成する場合、ページの作成ウィザードでサポートされるフォームは次のとおりです。

表9-1 ページの作成ウィザード: デスクトップ・アプリケーション用のフォーム

フォーム・タイプ

説明

詳細情報

表のフォーム付きレポート

2つのページを作成します。1つのページは、対話グリッドとして表示されます。各行に2ページ目へのリンクが提供され、これを使用して各レコードを更新できます。レポートおよびフォームを構築する表を選択できます。

注意: このウィザードでは、127列を超える列が含まれている表はサポートされていません。127列を超える列を選択すると、エラーが発生します。

適用されません。

編集可能対話グリッド

対話グリッドでは、検索およびカスタマイズ可能なレポートのデータのセットがユーザーに表示されます。編集可能対話グリッドでは、ユーザーはページ上で直接データ・セットを追加、変更およびリフレッシュすることもできます。機能面では、対話グリッドには、対話モード・レポートで使用可能な多くのカスタマイズ機能と、マウスを使用して対話的にレポートを再配置する機能が含まれています。対話グリッドを構築する表を選択します。

対話グリッドの管理および既存の対話グリッドを編集可能にするを参照してください。

1ページのマスター・ディテール

編集可能対話グリッドを含む1ページのマスター・ディテールを作成します。このページを使用すると、関連する2つの表またはビューに対し、値の問合せ、挿入、更新および削除を行うことができます。マスター・リージョンおよびディテール・リージョンを構築する表を選択します。

マスター・ディテール・フォームの管理を参照してください。

2ページのマスター・ディテール

2ページのマスター・ディテールでは、マスター表の最初のページに1つの対話グリッドが作成され、2ページ目に(マスター用の)標準フォームおよびディテール用の対話グリッドが作成されます。

マスター・ディテール・フォームの管理を参照してください。

表のフォーム

データベース表の単一行を更新できるフォームを作成します。フォームを構築する表を選択できます。

適用されません。

プロシージャのフォーム

ストアド・プロシージャの引数に基づくフォームを構築します。ストアド・プロシージャまたはパッケージに実装済のロジックまたはデータ操作言語(DML)が存在する場合は、この方法を使用します。

適用されません。

SQL問合せのフォーム

EQUIJOINなどのSQL問合せによって戻される列に基づくフォームを作成します。

適用されません。

Webサービスのフォーム

Webサービスの定義に基づいて、アイテムを含むページを作成します。このウィザードでは、ユーザー入力フォーム、Webサービスをコールするプロセスおよび送信ボタンを作成します。

Webサービスでのフォームの作成を参照してください。

Webサービスのレポートとフォーム

Webサービスの定義に基づいて、アイテムを含むページを作成します。このウィザードでは、ユーザー入力フォーム、Webサービスをコールするプロセスおよび送信ボタンを作成し、レポートに結果を表示します。

Webサービスでの入力フォームとレポートの作成を参照してください。

モバイル・アプリケーションに使用可能なフォーム

モバイル・アプリケーションを作成する場合、ページの作成ウィザードでは、次のフォームがサポートされます。

表9-2 ページの作成ウィザード: モバイル・アプリケーション用のフォーム

フォーム・タイプ

説明

詳細情報

表のリスト・ビュー付きのレポート

データベース表の単一行を更新できるフォームおよびリスト・ビューを作成します。フォームを構築する表を選択し、リスト・ビューのテキスト表示に使用する列を選択します。

該当なし

表のフォーム

データベース表の単一行を更新できるフォームを作成します。フォームを構築する表を選択できます。

該当なし

プロシージャのフォーム

ストアド・プロシージャの引数に基づくフォームを構築します。ストアド・プロシージャまたはパッケージに実装済のロジックまたはデータ操作言語(DML)が存在する場合は、この方法を使用します。

該当なし

SQL問合せのフォーム

EQUIJOINなどのSQL問合せによって戻される列に基づくフォームを作成します。

該当なし

Webサービスのフォーム

Webサービスの定義に基づいて、アイテムを含むページを作成します。このウィザードでは、ユーザー入力フォーム、Webサービスをコールするプロセスおよび送信ボタンを作成します。

Webサービスでのフォームの作成を参照してください。

Webサービスのレポートとフォーム

Webサービスの定義に基づいて、アイテムを含むページを作成します。このウィザードでは、ユーザー入力フォーム、Webサービスをコールするプロセスおよび送信ボタンを作成し、レポートに結果を表示します。

Webサービスでの入力フォームとレポートの作成を参照してください。

関連項目:

ページの作成ウィザードを使用したフォームの作成

9.2.2 ページの作成ウィザードを使用したフォームの作成

フォームを作成する最も簡単な方法は、ページの作成ウィザードを使用することです。

ページの作成ウィザードを使用してフォームを作成するには、次のステップを実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「ページの作成」をクリックします。

4. 「ページの作成」で、次のステップを実行します。

a. ユーザー・インタフェース: ページのユーザー・インタフェースを選択します。

b. ページ・タイプの選択: 「フォーム」を選択します。

c. 「次へ」をクリックします。

5. 作成するフォーム・ページのタイプを選択します。ページの作成ウィザード実行時のフォーム・オプションを参照してください。

6. 画面に表示されるステップに従います。
属性の詳細は、フィールドレベル・ヘルプを参照してください。

9.2.3 アプリケーションの作成ウィザードを使用したフォームの作成

アプリケーションの作成ウィザードを使用して、表内の単一行を更新するフォームを作成します。このウィザードでは、フォームを構築する表を選択できます。

アプリケーションの作成ウィザードを使用してフォームを作成するには、次のステップを実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. 「作成」ボタンをクリックします。

3. アプリケーション・タイプで「デスクトップ」を選択し、「次へ」をクリックします。

4. 「名前」は、次のようにします。

a. スキーマ: アプリケーションは、すべてのSQLを特定のデータベース・スキーマとして解析することで、権限を取得します。データベース・スキーマ所有者を指定します。

b. 名前: 開発者がアプリケーションを識別するための名前を入力します。

c. アプリケーション: アプリケーションを識別する整数値を指定します。アプリケーションIDは、Application Expressインスタンス内で一意である必要があります。3000から9000の範囲のアプリケーションIDは、Oracle Application Expressの内部使用向けに予約されています。

d. テーマ: テーマを選択します。テーマは、アプリケーション全体のレイアウトおよびスタイルの定義に使用するテンプレートのコレクションです。

e. テーマ・スタイル: テーマ・スタイルを選択します。テーマ・スタイルは、テーマ42および51などの新しいアプリケーションに対してのみ使用可能です。
テーマ・スタイルは、ベースCSSに追加されるCSSです。開発者は、テーマ・ローラー・ユーティリティを使用してアプリケーションの外観を変更できます。

f. 「次へ」をクリックします。

ヒント:

この時点で、ログイン・ページと空白ページのみで構成されるアプリケーションを作成するには、「アプリケーションの作成」をクリックします。

次に、ページをアプリケーションに追加します。

5. 「ページ」で、「ページの追加」をクリックします。「アプリケーションの作成」ダイアログで、次のようにします。

a. ページ・タイプの選択: ページ・タイプ「フォーム」を選択します。

b. 親ページ: 該当する場合、従属ページを選択します。属性の詳細は、フィールドレベル・ヘルプを参照してください。

c. 表名: 表を選択します。

d. 「ページの追加」をクリックします。

ページがページ上部に表示されます。ページを削除するには、「削除」アイコンをクリックします。

6. すべてのページが追加されるまで前のステップを繰り返します。

7. 「次へ」をクリックします。

8. 画面に表示されるステップに従います。

ヒント:

属性の詳細は、フィールドレベル・ヘルプを参照してください。

関連項目:

- データベース・アプリケーションの作成

- テーマの使用

- テーマ・スタイルの使用

9.2.4 ページ・デザイナでのフォーム・リージョンの作成

注意:

「ギャラリ」でフォームを選択して「レイアウト」タブにドラッグしてドロップし、手動でフォームを作成することもできます。ただし、手動でフォームを作成する方法では、基礎となる必須のフォーム・アイテムとプロセスがすべて作成されるわけではないため、お薦めしません。

ページ・デザイナでのフォームを作成するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. ページを選択します。

ページ・デザイナが表示されます。

2. ページ上部のページ・デザイナ・ツールバーに移動します。

3. ページ・デザイナ・ツールバーで、「作成」メニューをクリックし、「フォーム・リージョン」を選択します。

「リージョンの作成」ウィザードが表示されます。

4. 作成するフォームのタイプを選択し、「次へ」をクリックします。
オプションは次のとおりです。

- 表のフォーム

- SQL問合せのフォーム

- プロシージャのフォーム

- Webサービスのフォーム

フォーム・リージョン・オプションの詳細は、リージョンの作成ウィザード実行時のリージョン・タイプを参照してください。

5. 画面に表示されるステップに従います。

9.2.4 レガシー・コンポーネント・ビューでのフォームの手動作成

この項では、コンポーネント・ビューでフォームを手動で作成する方法について説明します。

トピック:

- コンポーネント・ビューでのフォームの手動作成について

- フォームの処理

- コンポーネント・ビューでのフォームの移入

関連項目:

レガシー・コンポーネント・ビューでのページの管理

9.2.4.1 コンポーネント・ビューでのフォームの手動作成について

次のステップを実行することによって、フォームを手動で作成することもできます。

- ステップ1 - (ページ・アイテムのコンテナとして機能する) HTMLリージョンを作成します

- ステップ2 - リージョンに表示するアイテムを作成します

- ステップ3 - プロセスおよびブランチを作成します

HTMLリージョンを作成することによって手動でフォームを作成するには、次のステップを実行します。

1. 適切なページにナビゲートします。レガシー・コンポーネント・ビューでのページの表示を参照してください。

2. HTMLリージョンを作成します。コンポーネント・ビューでのリージョンの作成を参照してください。

3. ページへのアイテムの追加を開始します。ページ・レベル・アイテムの理解

9.2.4.2 フォームの処理

フォームを作成したら、次に、基礎となるデータベース表またはビューに対して挿入または更新を行うことによって、ユーザーが入力したデータを処理します。この項では、フォームを処理する3つの方法について説明します。

トピック:

- 行の自動処理(DML)プロセスの作成

- 1つ以上の挿入文を含むプロセスの作成

- PL/SQL APIを使用したフォーム値の処理

9.2.4.2.1 行の自動処理(DML)プロセスの作成

フォームを実装するための一般的な方法の1つは、行の自動処理(DML)プロセスを手動で作成することです。この方法には、3つのメリットがあります。1つ目は、SQLコードを指定する必要がないことです。2つ目は、Oracle Application ExpressによってDMLプロセスが実行されることです。3つ目は、このプロセスによって、ロストした更新の検出が自動的に実行されることです。ロストした更新の検出によって、データに同時にアクセスできる複数のアプリケーションのデータの整合性が保証されます。

この方法を実現するには、次のステップを実行します。

- アイテムを追加し、「アイテム・ソース」タイプを「データベース列」に定義し、大/小文字が区別される列名を指定します。

- オプション「常にキャッシュ値より優先」を選択します。

行の自動処理(DML)プロセスを作成するには、次のステップを実行します。

1. 適切なページにナビゲートします。レガシー・コンポーネント・ビューでのページの表示を参照してください。

2. ページ・プロセスの作成ウィザードにアクセスします。「プロセス」で、「作成」アイコンをクリックします。

3. 「プロセス・タイプ」で、「データ操作」を選択し、「次へ」をクリックします。

4. プロセス・カテゴリ「行の自動処理(DML)」を選択し、「次へ」をクリックします。

5. 「プロセス属性」で、次のステップを実行します。

a. 名前 - プロセスを識別するための名前を入力します。

b. 順序 - 順序番号を指定します。

c. ポイント - このプロセスの実行ポイントを選択します(「ロード時 - ヘッダーの後」など)。

d. タイプ - 選択したプロセス・タイプを表示します。

e. 「次へ」をクリックします。

6. 画面に表示されるステップに従います。

9.2.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;

9.2.4.2.3 PL/SQL APIを使用したフォーム値の処理

アプリケーションによっては、表へのすべてのアクセスを単一または少数のPL/SQLパッケージにまとめて処理することが適しています。DML操作を処理するパッケージを作成した場合は、このパッケージのプロシージャおよびファンクションを、送信後のPL/SQLプロセスからコールして、リクエストの挿入、更新および削除を処理できます。

9.2.4.3 コンポーネント・ビューでのフォームの移入

Oracle Application Expressでは、ロード時またはApplication Expressエンジンによるページのレンダリング時にフォームが移入されます。フォームを移入するには、次のステップを実行します。

- プロセスを作成し、タイプを「行の自動フェッチ」に定義します。

- 非表示のセッション・ステート・アイテムを参照することによって、フォームを手動で移入します。

行の自動フェッチ・プロセスを作成するには、次のステップを実行します。

1. 適切なページにナビゲートします。レガシー・コンポーネント・ビューでのページの表示を参照してください。

2. ページ・プロセスの作成ウィザードにアクセスします。「プロセス」で、「作成」アイコンをクリックします。

3. 「プロセス・タイプ」で、「データ操作」を選択し、「次へ」をクリックします。

4. プロセス・カテゴリを選択し、「行の自動フェッチ」を選択して「次へ」をクリックします。

5. 「プロセス属性」で、次のステップを実行します。

a. 名前 - プロセスを識別するための名前を入力します。

b. 順序 - 順序番号を指定します。

c. ポイント - このプロセスの実行ポイントを選択します。

d. タイプ - 選択したプロセス・タイプを表示します。

e. 「次へ」をクリックします。

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の値は、設定済です。

- このプロセスのプロセス・ポイントは、「ロード時 - リージョンの前」またはこれ以前に実行するように設定されます。

9.3 対話グリッドを編集可能にする操作の概要

対話グリッドでは、検索およびカスタマイズ可能なレポートのデータのセットがユーザーに表示されます。編集可能対話グリッドでは、ユーザーはページ上で直接データ・セットを追加、変更およびリフレッシュすることもできます。基礎となるデータが読取り専用か、ユーザーが編集できるかは、開発者が決定します。

Oracle Application Expressエンド・ユーザー・ガイドの対話グリッドの使用に関する項で説明されているとおり、ユーザーは個々の列をロック、非表示、フィルタ処理、凍結、ハイライトおよびソートできます。上級ユーザーは、列に対するブレーク、集計および計算を定義することもできます。また、ユーザーは対話グリッドの外観を直接カスタマイズできます。ユーザーはマウスを使用して列の幅を変更したり、列をグリッド内の別の場所にドラッグ・アンド・ドロップすることができます。

編集可能対話グリッドでは、ユーザーはページ上で直接データ・セットを追加、変更およびリフレッシュすることもできます。編集可能対話グリッドでは通常の対話グリッドの機能が拡張されて、ユーザーがグリッドの構造およびコンテンツをより直接的に更新できます。ユーザーは、行を追加および削除したり、セルのコンテンツを編集したり、グリッドを最新の更新でリフレッシュすることができます。

関連項目:

既存の対話グリッドを編集可能にするおよび対話グリッドの管理

9.4 マスター・ディテール・フォームの管理

マスター・ディテール・フォームは、データベースの2つの表の1対多関係を示します。通常、マスター・ディテール・フォームには、1つのHTMLフォーム内にマスター行および複数のディテール行が表示されます。このフォームを使用すると、2つの表またはビューに対し、値の挿入、更新および削除を行うことができます。

ヒント:

1ページまたは2ページのマスター・ディテール・フォームの実際の例を参照するには、サンプル・アプリケーションのサンプル・プロジェクトをインストールして、プロジェクト・ページを表示します。パッケージ・アプリケーションのインストールを参照してください。

トピック:

- マスター・ディテール・フォームについて

- アプリケーションの作成ウィザードを使用した1ページのマスター・ディテールの作成

- ページの作成ウィザードを使用した1ページのマスター・ディテールの作成

- ページの作成ウィザードを使用した2ページのマスター・ディテールの作成

関連項目:

既存の対話グリッドからのマスター・ディテールの作成およびレガシー・マスター・ディテール・フォームの作成

9.4.1 マスター・ディテール・フォームについて

マスター・ディテール・フォームは、データベースの2つの表の1対多関係を示します。通常、マスター・ディテール・フォームには、マスター行および複数のディテール行が表示されます。ページの作成ウィザードまたはアプリケーションの作成ウィザードを使用してマスター・ディテール・フォームを作成する場合、マスター・フォームおよびディテール・フォームを構築する表を選択します。

1ページのマスター・ディテール

1ページのマスター・ディテールには、2つの関連する表またはビューに基づく2つの編集可能対話グリッドがあります。ユーザーは、マスター・グリッドの行を選択して、ディテール・グリッドを更新します。開発者は、アプリケーションの作成ウィザードまたはページの作成ウィザードを使用して、1ページのマスター・ディテールを作成できます。

1ページのマスター・ディテールには、2つの関連する表またはビューに基づく2つの編集可能対話グリッドがあります。

ユーザーは、マスター・グリッドの行を選択して、ディテール・グリッドを更新します。この例では、ユーザーがマスター・グリッドの部門を選択して、ディテール・グリッドの従業員を表示します。開発者は、アプリケーションの作成ウィザードまたはページの作成ウィザードを使用して、1ページのマスター・ディテールを作成できます。

2ページのマスター・ディテール

2ページのマスター・ディテールには、2つの関連する表またはビューに基づく2つのページがあります。最初のページは、編集不能対話グリッドです。ユーザーは、最初のページで「編集」アイコンをクリックして、2ページ目で詳細を編集します。

この例では、ユーザーが「編集」アイコンをクリックして、部門内のすべての従業員にアクセスします。2ページ目には、標準フォーム(マスター)と従業員の編集可能対話グリッドの両方が含まれます。

数値フィールドおよび日付フィールドについては、日付と数値の書式マスクを事前に定義したり、初期フォームの生成後にそれらの書式マスクを適用することもできます。また、ウィザードによって生成されるマスター・ディテール・フォームでは、一部の列に対して検証が自動的に作成されます。検証は、基礎となる表でNOT NULLに設定されている列、およびタイプがNUMBER、DATEまたはTIMESTAMPの列に対して作成されます。ユーザーの選択または定義済のユーザー・インタフェースのデフォルト値に基づいて、列が読取り専用に設定されている場合、検証は作成されません。

ヒント:

列属性を編集して、特定の列の外観を制御できます。

9.4.2 アプリケーションの作成ウィザードを使用した1ページのマスター・ディテールの作成

アプリケーションの作成ウィザードを使用してマスター・ディテール・フォームを作成すると、2つの関連する表またはビューに基づく2つの編集可能対話グリッドを含む単一ページが作成されます。このページを使用すると、関連する2つの表またはビューに対し、値の問合せ、挿入、更新および削除を行うことができます。

ヒント:

アプリケーションの作成ウィザードでは、一般的なベスト・プラクティスに基づいてアプリケーションが生成され、ページの作成ウィザードに含まれているいくつかの高度なオプションは使用されません。

アプリケーションの作成ウィザードを使用してマスター・ディテール・フォームを作成するには、次のステップを実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. 「作成」ボタンをクリックします。

3. アプリケーション・タイプには「デスクトップ」を選択します。

4. 「名前」は、次のようにします。

a. スキーマ: アプリケーションは、すべてのSQLを特定のデータベース・スキーマとして解析することで、権限を取得します。データベース・スキーマ所有者を指定します。

b. 名前: 開発者がアプリケーションを識別するための名前を入力します。

c. アプリケーション: アプリケーションを識別する整数値を指定します。アプリケーションIDは、Application Expressインスタンス内で一意である必要があります。3000から9000の範囲のアプリケーションIDは、Oracle Application Expressの内部使用向けに予約されています。

d. テーマ: テーマを選択します。テーマは、アプリケーション全体のレイアウトおよびスタイルの定義に使用するテンプレートのコレクションです。

e. テーマ・スタイル: テーマ・スタイルを選択します。テーマ・スタイルは、テーマ42および51などの新しいアプリケーションに対してのみ使用可能です。

f. 「次へ」をクリックします。

5. 「ページの追加」ボタンをクリックします。

「アプリケーションの作成」で、次のようにします。

a. ページ・タイプの選択: 「マスター・ディテール」を選択します。

b. 親ページ: 該当する場合、従属ページを選択します。

c. マスター表名: マスター表として使用する表またはビューを選択します。この表は、レポート・ページ、およびマスター・ディテール・ページのマスター・フォームを作成するために使用されます。

d. ディテール表名: ディテール表として使用する表またはビューを選択します。
外部キーを使用して選択したマスター表に関連付けられている表およびビューのみが表示されます。

e. 「ページの追加」をクリックします
アプリケーションの作成ページの上部に新しいページが表示されます。

f. 「次へ」をクリックします。

6. 「共有コンポーネント」で、共有コンポーネントを別のアプリケーションからコピーするかどうかを指定します。「はい」または「いいえ」を選択します。「はい」を選択した場合は、そのコピー元と、インポートするコンポーネントを選択します。

7. 「属性」で、必要に応じて構成し、「次へ」をクリックします。属性の詳細は、フィールドレベル・ヘルプを参照してください。

8. 選択内容を確認して、「アプリケーションの作成」をクリックします。

9. 新しいマスター・ディテール・ページを表示するには、「ページの実行」をクリックします。
レンダリングされたページが表示されます。

関連項目:

- テーマの使用

- テーマ・スタイルの使用

- 「共有コンポーネントの管理」

9.4.3 ページの作成ウィザードを使用した1ページのマスター・ディテールの作成

ページの作成ウィザードを使用して、1ページのマスター・ディテールを作成できます。1ページのマスター・ディテールには、2つの関連する表またはビューに基づく2つの編集可能対話グリッドがあります。

ページの作成ウィザードを使用して1ページのマスター・ディテールを作成するには:

1. アプリケーションに移動するか、新しいアプリケーションを作成します。

2. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

3. アプリケーションを選択します。

4. 「ページの作成」をクリックします。

5. 「ページの作成」で、次のステップを実行します。

a. ユーザー・インタフェース: ページのユーザー・インタフェースを選択します。

b. ページ・タイプの選択: 「フォーム」を選択します。

6. 「ページの作成」で「1ページのマスター・ディテール」を選択します。

7. 「ページ属性」で、次のステップを実行します。

a. ページ番号 - マスター・ページのページ番号を入力します。新しいページ番号を指定した場合、ウィザードによって新しいページが作成されます。既存のページ番号を指定した場合、ウィザードによってそのページにコンポーネントが追加されます。

b. ページ名 - ページの名前を入力します。

c. ページ・モード - ページの名前を入力します。オプションは次のとおりです。

- 標準 - ページは標準のApplication Expressアプリケーション・ページとして表示されます。

- モーダル・ダイアログ - ページはモーダル・ダイアログとして表示されます。モーダル・ダイアログは、ビューポート内に配置されたオーバーレイ・ウィンドウで、エンド・ユーザーが終了する(閉じる)までアクティブでフォーカスされたままです。基になるページはグレーアウトされ、ダイアログを閉じるまで、エンド・ユーザーは残りのページと対話できません。

d. ブレッドクラム - ページでブレッドクラム・ナビゲーション・コントロールを使用するかどうかを選択します。ブレッドクラム・ナビゲーションを含めることに決定した場合、追加の属性が表示されます。

e. 「次へ」をクリックします。

8. ナビゲーション・メニューで、このページをどのようにナビゲーション・メニューに統合するかを選択します。選択したオプションに応じて、追加の属性が表示されます。「次へ」をクリックします。

9. 「マスター・ソース」で、次のステップを実行します。

a. マスター・リージョン・タイトル - マスター・リージョンのリージョン・タイトルを入力します。

b. 表/ビューの所有者 - 対話グリッドを作成している表の所有者を選択します。

c. 表/ビューの名前 - グリッドの基になる表またはビューを選択します。

d. 主キー列 - 表内の行を一意に識別する列の名前を選択します。

e. 列の選択 - リージョンに含める1つ以上の列を選択します。表示するすべての列を選択します。

f. 「次へ」をクリックします。

10. 「ディテール・ソース」で、次のステップを実行します。

a. ディテール・リージョンのタイトル - ディテール・リージョンのリージョン・タイトルを入力します。

b. 関連する表のみの表示: ディテール表のリストを、マスター表に関連する表のみに制限するかどうかを指定します。

c. 表/ビューの名前 - グリッドの基になる表またはビューを選択します。

d. 主キー列 - 表内の行を一意に識別する列の名前を選択します。

e. マスター・ディテール外部キー - マスター表とディテール表を関連付ける外部キーを選択します。

f. 列の選択 - リージョンに含める1つ以上の列を選択します。表示するすべての列を選択します。

g. 「作成」をクリックします。

ページ・デザイナが表示されます。

11. 新しいマスター・ディテールを表示するには、「ページの保存と実行」をクリックします。
レンダリングされたページが表示されます。

9.4.4 ページの作成ウィザードを使用した2ページのマスター・ディテールの作成

ページの作成ウィザードを使用して、2ページのマスター・ディテールを作成します。2ページのマスター・ディテールには、2つの関連する表またはビューに基づく2つのページがあります。最初のページは、編集不能対話グリッドです。ユーザーは、最初のページで「編集」アイコンをクリックして、2ページ目で詳細を編集します。

ページの作成ウィザードを使用して2ページのマスター・ディテールを作成するには:

1. アプリケーションに移動するか、新しいアプリケーションを作成します。

2. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

3. アプリケーションを選択します。

4. 「ページの作成」をクリックします。

5. 「ページの作成」で、次のステップを実行します。

a. ユーザー・インタフェース: ページのユーザー・インタフェースを選択します。

b. ページ・タイプの選択: 「フォーム」を選択します。

6. 「ページの作成」で「2ページのマスター・ディテール」を選択します。

7. 「ページ属性」で、次のステップを実行します。

a. マスター・ページ番号 - マスター・ページのページ番号を入力します。マスター・ページには、読取り専用のマスター対話グリッドが含まれます。新しいページ番号または既存のページ番号を入力します。

b. マスター・ページ名 - マスター・ページの名前を入力します。

c. ディテール・ページ番号 - ディテール・ページのページ番号を入力します。詳細ページには、フォームおよび編集可能対話グリッドが含まれます。

d. ディテール・ページ名 -ディテール・ページの名前を入力します。

e. ブレッドクラム - ページでブレッドクラム・ナビゲーション・コントロールを使用するかどうかを選択します。ブレッドクラム・ナビゲーションを含めることに決定した場合、追加の属性が表示されます。

f. 「次へ」をクリックします。

8. ナビゲーション・メニューで、このページをどのようにナビゲーション・メニューに統合するかを選択します。選択したオプションに応じて、追加の属性が表示されます。「次へ」をクリックします。

9. 「マスター・ソース」で、次のステップを実行します。

a. 表/ビューの所有者 - 対話グリッドを作成している表の所有者を選択します。

b. 表/ビューの名前 - グリッドの基になる表またはビューを選択します。

c. 主キー列 - 表内の行を一意に識別する列の名前を選択します。

d. フォームのナビゲーションの順序 - ディテール・ページで、別のマスター・レコードにナビゲートする前ボタンまたは次ボタンで使用されるナビゲーション順序列を選択します。

e. 列の選択 - リージョンに含める1つ以上の列を選択します。表示するすべての列を選択します。

f. 「次へ」をクリックします。

10. 「ディテール・ソース」で、次のステップを実行します。

a. 表/ビューの所有者 - 対話グリッドを作成している表の所有者を選択します。

b. 表/ビューの名前 - グリッドの基になる表またはビューを選択します。

c. 主キー列 - 表内の行を一意に識別する列の名前を選択します。

d. マスター・ディテール外部キー - マスター表とディテール表を関連付ける外部キーを選択します。

e. 列の選択 - リージョンに含める1つ以上の列を選択します。表示するすべての列を選択します。

f. 「作成」をクリックします。

ページ・デザイナが表示されます。

11. 新しいマスター・ディテールを表示するには、「ページの保存と実行」をクリックします。

レンダリングされたページが表示されます。

9.5 フォームでのユーザー入力の検証

開発者は、検証および関連するエラー・メッセージを作成して、ユーザーが入力したデータを処理する前にチェックすることができます。

トピック:

- 検証およびエラー・メッセージの作成について

- ページ・デザイナでの検証と特定のアイテムとの関連付け

- コンポーネント・ビューでの検証と特定のアイテムとの関連付け

- エラー・メッセージ表示位置について

9.5.1 検証およびエラー・メッセージの作成について

検証を使用すると、ユーザーが入力したデータを処理前に確認できます。検証および関連するエラー・メッセージを作成したら、これらを特定のアイテムと関連付けることができます。検証エラー・メッセージをインライン表示(検証が実行されたページで表示)するか、個別のエラー・ページで表示するかを選択できます。

インラインのエラー・メッセージを作成するには、次のステップを実行します。

- ステップ1 - 検証を作成し、エラー・メッセージ・テキストを指定します。詳細は、検証の理解を参照してください。

- ステップ2 - 検証を特定のアイテムと関連付けます。

9.5.2 ページ・デザイナでの検証と特定のアイテムとの関連付け

アイテムを検証と関連付け、エラー・メッセージ・テキストを指定するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. ページを選択します。

ページ・デザイナが表示されます。

2. ページ・デザイナで、左ペインの「プロセス」タブを選択します。

3. 「検証中」で、関連付ける検証を選択します。

プロパティ・エディタに検証属性が表示されます。

4. プロパティ・エディタですべての属性を表示するには、「すべて表示」をクリックします。

5. グループまたは属性を検索するには、「フィルタ・プロパティ」フィールドにキーワードを入力します。

6. 次の属性を編集します。

- エラー、エラー・メッセージ - 検証に合格しないイベントで表示されるテキストを入力します。

- エラー、表示位置 - この検証のエラー・メッセージが表示される位置を選択します。検証エラー・メッセージは、別のエラー・ページに表示したり、既存ページ内にインラインで表示することができます。インライン・エラー・メッセージは、ページ・テンプレートの一部として定義されている「関連付けられたアイテム」ラベルの下または通知領域内に表示されます。

- エラー、関連付けられたアイテム - この検証エラー・メッセージが表示されるアイテムを選択します。

ヒント:

属性の詳細は、プロパティ・エディタで属性を選択し、中央ペインで「ヘルプ」タブをクリックして、参照してください。

7. 「保存」をクリックします。

9.5.3 コンポーネント・ビューでの検証と特定のアイテムとの関連付け

アイテムを検証と関連付け、エラー・メッセージ・テキストを指定するには、次のステップを実行します。

1. コンポーネント・ビューで適切なページにナビゲートします。レガシー・コンポーネント・ビューでのページの表示を参照してください。

2. ページ検証の編集ページにナビゲートします。「検証」で、関連付ける検証を選択します。

検証の属性ページが表示されます。

3. 「エラー・メッセージ」までスクロールします。

4. 「エラー・メッセージ」で、次のように入力します。

- エラー・メッセージ - エラー・メッセージを入力します。

- エラー・メッセージ表示位置 - 検証エラー・メッセージの表示位置を指定します。表示位置を確認します。

- 関連付けられたアイテム: 対象の検証と関連付けるアイテムを選択します。

5. 「変更の適用」をクリックします。

9.5.4 エラー・メッセージ表示位置について

エラー・メッセージ表示位置は、検証エラー・メッセージがどこに表示されるかを指定します。検証エラー・メッセージは、エラー・ページに表示したり、既存ページ内にインラインで表示できます。インライン・エラー・メッセージは、通知領域(ページ・テンプレートの一部として定義される)に表示したり、フィールド・ラベル内に表示できます。

残りのすべての検証を含むプロセスを停止するハード・エラーを作成する場合は、エラー・ページにエラーを表示する必要があります。

9.6 フォームでのBLOBサポートの理解

この項では、フォームでのBLOBサポートについて説明します。

トピック:

- フォームでのBLOBサポートについて

- BLOBへのファイルのアップロードとダウンロードについて

- BLOBの表示について

- イメージ参照の削除について

9.6.1 フォームでのBLOBサポートについて

アプリケーションの作成ウィザードを使用してフォームを作成する場合、フォーム型またはレポートおよびフォーム型のページを作成する場合、フォーム型のリージョンを作成する場合、または既存のフォームにアイテムを追加する場合、BLOB型のデータベース列がソースであるアイテムは、ファイル参照型のアイテムになります。フォームがINSERTにコールされる場合、ユーザーが選択したファイルは、BLOB列にロードされます。フォームが更新にコールされる場合、ダウンロード・リンクが「参照」ボタンの右に表示されます。ユーザーは、このリンクを使用してファイルをダウンロードできます。

9.6.2 BLOBへのファイルのアップロードとダウンロードについて

デフォルトのBLOBサポートでは、一般的なアプリケーションでBLOBを効果的に管理するために必要とされるすべての情報が提供されているわけではありません。列がBLOBであるという情報に加えて、ファイルの詳細情報も提供されると、エンド・ユーザーの使いやすさが向上します。ファイル参照ページ・アイテムには、この追加情報を完全に宣言的に管理することを容易にするための追加設定があります。

ヒント:

ファイル参照設定の詳細は、「アイテム・タイプについて」の「ファイル参照」を参照してください。

ファイル参照アイテム・タイプ内では、次の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列」である「ファイル参照」アイテム・タイプを使用します。このプロセスによって、表名と主キー列が決定されます。

9.6.3 BLOBの表示について

使用するBLOBがイメージの場合は、イメージをフォームで表示できます。これを宣言的に処理するには、「アイテム・タイプについて」の説明に従って、イメージの表示アイテム・タイプを使用します。手続き的に処理するには、「フォームおよびレポートでのBLOBサポートの理解」を参照してください。

9.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;

10 データベース・アプリケーション・コンポーネントの管理

Oracle Application Expressは、カレンダ、マップ、チャートおよびアプリケーション・ヘルプの作成をサポートします。

トピック:

- カレンダの作成

- マップの作成

- チャートの作成

- アプリケーションのヘルプの作成

関連項目:

レポートの開発、ページ・レイアウトの制御およびナビゲーションの追加

10.1 カレンダの作成

アプリケーション・ビルダーには月次、週次、日次およびリスト表示のカレンダを生成するための組込みウィザードが含まれています。カレンダのベースとなる表を一度指定すると、特定の列に格納された情報へのドリルダウン・リンクを作成して、ドラッグ・アンド・ドロップ機能を有効化できます。

トピック:

- サポートされているカレンダについて

- サンプル・カレンダ

- 新しいページへのカレンダの追加

- ページ・デザイナでのカレンダの作成

- ページ・デザイナでのカレンダ属性の管理

- カレンダの動的アクションのサポートについて

関連項目:

レガシー・カレンダの管理およびGoogleカレンダとの統合

10.1.1 サポートされているカレンダについて

アプリケーション・ビルダーでは、次の2つのカレンダ・タイプがサポートされています。

- カレンダ - カレンダは、FullCalendar jQueryライブラリをベースにしており、CSSを介してのみカスタマイズできます。

- レガシー・カレンダ - レガシー・カレンダはテンプレートベースで、今後のリリースでは非推奨になる可能性があります。

ヒント:

以前のリリースでは、レガシー・カレンダはカレンダ(テンプレート)、クラシック・カレンダ、簡易カレンダおよびSQLカレンダと呼ばれていました。

両方のカレンダ・オプションで、指定した表またはSQL問合せをベースとするカレンダを作成できます。作成プロセス中、日付列と表示列を選択するプロンプトが表示されます。適切なユーザー・インタフェースと様々な追加機能が提供されるため、すべてのレガシー・カレンダを最新カレンダに変換することをお薦めします。

Calendar

カレンダ・オプションでは、次のことがサポートされます。

- 複数ビューでのカレンダ・イベントのレンダリング(「月」、「週」、「日」または「リスト」)。

- 期間ベース・イベントおよび期間ベースでないイベントのレンダリング。

- イベントを異なる日付にドラッグ・アンド・ドロップすることによって開始日および終了日を変更する機能。ドラッグ・アンド・ドロップは、ローカル・データ・ソース(つまり、参照されるデータベース・スキーマのデータベース・オブジェクト)でのみサポートされ、Googleカレンダなどの外部データ・ソースではサポートされません。

- イベントの長さをサイズ変更したり、終了日を変更することによって期間を変更する機能。

- フォームを使用し、イベントまたは空のカレンダ・セルのいずれかをクリックすることによって、カレンダの新規イベントを編集または追加する機能。

- Webサービス・コールまたはGoogleカレンダ・フィードを使用した外部ソースからのイベントのレンダリング。

- 単一または複数の行でイベント・タイトルをレンダリングする機能。

- 様々なCSSクラスを使用して、開発者は様々なイベント・タイプに様々なスタイルを選択できます。

- PDFの印刷可能な書式でイベントをダウンロードする機能

- イベントを共有する複数の形式(iCal、CSV、XML)のサポート。

- 各イベントの詳細を簡単に確認できるように、月次/週次/日次ビューにツールチップを追加する機能。

レガシー・カレンダ

レガシー・カレンダ・オプションでは、次のことがサポートされます。

- 1ページにつき1つのレガシー・カレンダの作成。

- 開始日のみのレンダリング。

- テンプレートによって定義されるルック・アンド・フィール。

- イベントのドラッグ・アンド・ドロップによる開始日の変更。

- 日次、週次、月次ビューを含むカレンダ。

- 日付列は、エントリが含まれるカレンダ上の日付を決定します。

- 表示列は、カレンダを表示する特定の行を定義します。

関連項目:

レガシー・カレンダの管理

10.1.2 サンプル・カレンダ

次に、サンプル・データベース・アプリケーションからのサンプル・カレンダを示します。

このカレンダの機能は次のとおりです。

- 前へ - 前月にナビゲートします。

- 次へ - 翌月にナビゲートします。

- 月 - すべての順序の月次ビューを表示します。

- リスト - すべての順序のリストを表示します。

ヒント:

その他のカレンダの例を確認するには、サンプル・カレンダ・アプリケーションをインストールします。パッケージ・アプリケーションのインストールを参照してください。

10.1.3 新しいページへのカレンダの追加

アプリケーションの作成ウィザードを実行して、カレンダを新しいページに追加します。

アプリケーションのホームページからカレンダを作成するには、次のステップを実行します。

1. ページの作成ウィザードを実行します。

a. 「ワークスペース」ホームページにナビゲートします。

b. 「アプリケーション・ビルダー」アイコンをクリックします。

c. アプリケーションを選択します。

d. 「ページの作成」をクリックします。
ページの作成ウィザードが表示されます。

2. 「ページの作成」で、次のステップを実行します。

a. ユーザー・インタフェース: ページのユーザー・インタフェースを選択します。

b. ページ・タイプの選択: 「カレンダ」を選択します。

c. 「次へ」をクリックします。

3. 「ページ属性」は、次のようにします。

ヒント:

属性の詳細は、フィールドレベル・ヘルプを参照してください。フィールドレベル・ヘルプの表示を参照してください。

a. ページ番号: 新しいページ番号を指定した場合、ウィザードによって新しいページが作成されます。既存のページ番号を指定した場合、ウィザードによってそのページにコンポーネントが追加されます。

b. ページ名: 作成するページのタイトルを入力します。

c. ページ・モード: ページ・モードを選択します。

d. ブレッドクラム: ページでブレッドクラム・ナビゲーション・コントロールを使用するかどうか、およびどのブレッドクラム・ナビゲーション・コントロールを使用するかを選択します。

e. 「次へ」をクリックします。

4. 「ナビゲーション・メニュー」で、このページに含めるナビゲーションのタイプを指定し、「次へ」をクリックします。表示されるナビゲート・オプションは、カレント・アプリケーション・テーマによって異なります。

5. 「ソース」で、カレンダ・ソースが表かSQL問合せかを選択します。
カレンダ・ソースが表の場合:

a. ソース・タイプ - 「表」を選択します。

b. 表/ビューの所有者 - カレンダを作成している表の所有者を選択します。

c. 表/ビューの名前 - カレンダの基になる表またはビューを選択します。

d. 列の選択 - カレンダに含める1つ以上の列を選択します。

e. 「次へ」をクリックします。

カレンダ・ソースがSQL問合せの場合:

a. ソース・タイプ - 「SQL問合せ」を選択します。

b. リージョン・ソースの入力 - カレンダに使用するSQL SELECT文を入力します。SQL SELECT文には2列以上を含める必要があり、そのうち1つはDATE列にする必要があります。

c. 「次へ」をクリックします。

6. 「設定」は、次のようにします。

a. 表示列 - このカレンダのイベントに表示されるテキストを保持する列を選択します。

b. 開始日列 - このカレンダに表示されるイベントの開始日を保持する列を選択します。

c. 終了日列 - このカレンダに表示されるイベントの終了日を保持する列を選択します。この属性を指定すると、カレンダには期間ベース・イベントが表示されます。

d. 時間の表示 - 日付の時間部分を表示するかどうかを選択します。

e. 「作成」をクリックします。

10.1.4 ページ・デザイナでのカレンダの作成

ヒント:

ページ・デザイナでカレンダを作成するには、SQL問合せを指定する必要があります。表を選択してカレンダを作成するには、ページの作成ウィザードを使用します。新しいページへのカレンダの追加を参照してください。

ページ・デザイナでカレンダを作成するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. ページを選択します。

ページ・デザイナが表示されます。

2. 必要に応じて、中央ペインで「レイアウト」タブをクリックします。

3. ギャラリで、「リージョン」タブをクリックします。

4. 「カレンダ」を右クリックして、「追加先」をクリックして適切な位置を選択します。

ヒント:

または、マウスを使用して「カレンダ」を選択して、「レイアウト」タブの適切な位置までドラッグします。

プロパティ・エディタにリージョン属性が表示されます。

「メッセージ」タブに、対処が必要なメッセージを示す赤または黄色の印が表示されます。メッセージを選択すると、プロパティ・エディタに関連する属性が表示されます。赤いエラー・メッセージは、保存する前に対処する必要があります。

5. プロパティ・エディタですべての属性を表示するには、「すべて表示」をクリックします。

6. グループまたは属性を検索するには、「フィルタ・プロパティ」フィールドにキーワードを入力します。

7. プロパティ・エディタで、該当するリージョン属性を編集します。

- 指定、タイトル - リージョン・タイトルを入力します。

- ソース、SQL問合せ: このカレンダに表示されるイベントのスタイルを設定するCSSクラスを保持する列を選択します。

ヒント:

デフォルト・クラスの詳細を参照したり、例を表示するには、プロパティ・エディタでSQL問合せ属性を選択して、中央ペインの「ヘルプ」タブをクリックします。

8. カレンダ属性を編集します。

- 「レンダリング」タブで、「カレンダ」リージョンを探し、「属性」をクリックします。
プロパティ・エディタにカレンダ属性が表示されます。

- カレンダ属性を編集します。

- 設定、表示列: このカレンダのイベントに表示されるテキストを保持する列を選択します。

- 設定、開始日: このカレンダに表示されるイベントの開始日を保持する列を選択します。

9. 「保存」をクリックします。

関連項目:

ページ・デザイナでのカレンダ属性の管理

10.1.5 ページ・デザイナでのカレンダ属性の管理

作成したカレンダは、プロパティ・エディタで属性を編集することで表示を変更できます。各カレンダには、2セットの編集可能な属性(リージョン属性とカレンダ属性)があります。リージョン属性は、カレンダのコンテナとして機能するページの領域を定義します。カレンダ属性は、テンプレート、日付列および一般的なカレンダ書式設定を指定します。

トピック:

- プロパティ・エディタでのカレンダ属性の編集

- 追加および編集機能を含めるように既存のカレンダを編集

- カレンダ初期化JavaScriptコードの追加

- 既存のカレンダでのデータのドラッグ・アンド・ドロップの有効化

10.1.5.1 プロパティ・エディタでのカレンダ属性の編集

カレンダ属性を編集するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. ページを選択します。

ページ・デザイナが表示されます。

2. 「レンダリング」タブで、カレンダを探して選択します。

プロパティ・エディタにリージョン属性が表示されます。

3. 「レンダリング」タブで、カレンダを探して「属性」ノードを選択します。

プロパティ・エディタにカレンダ属性が表示されます。

4. プロパティ・エディタですべての属性を表示するには、「すべて表示」をクリックします。

5. グループまたは属性を検索するには、「フィルタ・プロパティ」フィールドにキーワードを入力します。

6. カレンダ属性を編集します。

ヒント:

属性の詳細は、プロパティ・エディタで属性を選択し、中央ペインで「ヘルプ」タブをクリックして、参照してください。

7. 「保存」をクリックします。

10.1.5.2 追加および編集機能を含めるように既存のカレンダを編集

開発者は、追加および編集機能を含めるように既存のカレンダを編集できます。

ヒント:

デスクトップ・アプリケーションのカレンダのリンクの作成およびリンクの編集を定義する場合、2つの異なるページを定義することをお薦めします。リンクの編集を作成するには、カレンダ属性の主キー列としていずれかの表の列またはSQL問合せ列を選択します。

追加および編集機能を含めるように既存のカレンダを編集するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. ページを選択します。

ページ・デザイナが表示されます。

2. 「レンダリング」タブで、カレンダを探して選択します。

プロパティ・エディタにリージョン属性が表示されます。

3. 「レンダリング」タブで、カレンダを探して「属性」ノードを選択します。

プロパティ・エディタにカレンダ属性が表示されます。

4. プロパティ・エディタですべての属性を表示するには、「すべて表示」をクリックします。

5. グループまたは属性を検索するには、「フィルタ・プロパティ」フィールドにキーワードを入力します。

6. 「設定」→「リンクの作成」を編集して、ユーザーが空のセルまたは既存のカレンダ・エントリをクリックしたときにコールされるターゲット・ページを指定します。

a. 設定、リンクの作成: 「リンクが定義されていません」をクリックします。
「リンク・ビルダー - リンクの作成」ダイアログが表示されます。

b. タイプ: リンク・ターゲットのタイプを選択します。

c. アプリケーション: 「別のアプリケーションのページ」を選択した場合、アプリケーションIDを入力します。

d. ページ: ターゲット・ページ番号を指定します。

e. アイテムの設定: カレンダからターゲット・ページに渡される値を構成します。カレンダで日付または日付範囲を選択した後、「リンクの作成」がコールされます。このため、選択した開始日と終了日が「ページの作成」に渡される必要があります。

- 選択した日付または選択した日付範囲の開始日を渡すには、次のステップを実行します。

- 名前: イベントの開始日を含むターゲット・ページ・アイテムの名前を指定します。フォームの場合、これを日付ピッカー要素にする必要があります。

- 値: &APEX$NEW_START_DATE

- 日付範囲が選択された場合は、次のように終了日を渡します。

- 名前: イベントの終了日を含むターゲット・ページ・アイテムの名前を指定します。フォームの場合、これを日付ピッカー要素にする必要があります。

- 値: &APEX$NEW_END_DATE

追加の値は、アプリケーション・ページへの他のリンクと同じ方法で渡すことができます。

ヒント:

属性の詳細は、プロパティ・エディタで属性を選択し、中央ペインで「ヘルプ」タブをクリックして、参照してください。

7. 「設定」→「リンクの編集」を編集して、ユーザーが既存のエントリをクリックしたときにコールされるターゲット・ページを定義します。

ヒント:

リンクの編集を作成するには、フォームが表の行を参照するために、主キー値をターゲット・ページに渡す必要があります。

a. 設定、リンクの編集: 「リンクが定義されていません」をクリックします。
「リンク・ビルダー - リンクの作成」ダイアログが表示されます。

b. タイプ: リンク・ターゲットのタイプを選択します。

c. アプリケーション: 「別のアプリケーションのページ」を選択した場合、アプリケーションIDを入力します。

d. ページ: ターゲット・ページ番号を指定します。

e. アイテムの設定: カレンダからターゲット・ページに渡される値を構成します。カレンダで日付または日付範囲を選択した後、「リンクの作成」がコールされます。このため、選択した開始日と終了日が「ページの作成」に渡される必要があります。

- 名前: 次のような主キー値を含むターゲット・ページ・アイテム(通常、非表示のアイテム)の名前を指定します。
PX_ID

- 値: 次のような主キー値を含む表の列またはSQL問合せ列を指定します。
&ID

8. 「保存」をクリックします。

10.1.5.3 カレンダ初期化JavaScriptコードの追加

初期化JavaScriptコード属性を編集して、JavaScriptファンクションを追加して標準のjQuery FullCalendar初期化属性を上書きできます。このファンクションでは、パラメータとしてカレンダ初期化属性を含むJavaScriptオブジェクトが返される必要があります。

初期化JavaScriptコードを追加するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. ページを選択します。

ページ・デザイナが表示されます。

2. 「レンダリング」タブのカレンダ・タイトルの下で、「属性」ノードを選択します。

プロパティ・エディタにカレンダ属性が表示されます。

3. プロパティ・エディタですべての属性を表示するには、「すべて表示」をクリックします。

4. グループまたは属性を検索するには、「フィルタ・プロパティ」フィールドにキーワードを入力します。

5. 「詳細」を見つけて展開します。

ヒント:

グループまたは属性を検索するには、「フィルタ・プロパティ」フィールドにキーワードを入力します。その用語を含むグループと属性が表示されます。

6. 初期化JavaScriptコードに対して、JavaScriptファンクションを入力して標準のjQuery FullCalendar初期化属性を上書きします。

次に例を示します。

function ( pOptions) {
pOptions.titleFormat      = "[Conference Schedule]";                  // custom title
pOptions.minTime          = "07:00:00";                               // hide slots before minTime
pOptions.maxTime          = "18:00:00";                               // hide slots after maxTime
pOptions.columnFormat     = {month: '', week: 'dddd', day: 'dddd'};   // week view column headings
pOptions.slotDuration     = "00:15:00";                               // custom slot duration
pOptions.weekNumbers      = true;                                     // show week numbers
pOptions.weekNumberTitle  = "CW";
return pOptions;
}

7. 「保存」をクリックします。

注意:

この機能の例を確認するには、サンプル・カレンダ・サンプル・アプリケーションを実行します。ナビゲーション・メニューから、カスタム・カレンダ初期化を選択します。パッケージ・アプリケーションのインストールを参照してください。

10.1.5.4 既存のカレンダでのデータのドラッグ・アンド・ドロップの有効化

カレンダ・リージョンでは、ドラッグ・アンド・ドロップによるカレンダ・イベントの移動または変更をサポートしています。

カレンダ・リージョンのドラッグ・アンド・ドロップのサポートを有効化するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. ページを選択します。

ページ・デザイナが表示されます。

2. 「レンダリング」タブのカレンダ・タイトルの下で、「属性」ノードを選択します。

プロパティ・エディタに、カレンダの属性が表示されます。

3. プロパティ・エディタですべての属性を表示するには、「すべて表示」をクリックします。

4. グループまたは属性を検索するには、「フィルタ・プロパティ」フィールドにキーワードを入力します。

5. 「設定」を見つけて展開し、次の属性を編集します。

a. 設定、主キー列: 表の列またはSQL問合せ列を選択します。
「設定」に「ドラッグ・アンド・ドロップ」が表示されます。

b. 設定、ドラッグ・アンド・ドロップ: 「はい」を選択します。
「PL/SQLコードのドラッグ・アンド・ドロップ」が表示されます。

c. 設定、PL/SQLコードのドラッグ・アンド・ドロップ: エンド・ユーザーがイベントのドラッグ・アンド・ドロップを完了したときに実行するPL/SQLコードを入力します。
PL/SQLコード内では、次のように、ドラッグされたイベントのID、新しい開始日および終了日を参照できます。

:APEX$PK_VALUE, :APEX$NEW_START_DATE amd :APEX$_NEW_END_DATE

たとえば、エンド・ユーザーがイベントを新しい日付にドラッグした後は、次のコードでPROJECTS表のイベント行が変更されます。

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;

詳細は、中央ペインで「ヘルプ」タブをクリックします。

6. 「保存」をクリックします。

10.1.6 カレンダの動的アクションのサポートについて

動的アクションは、JavaScriptを必要としないで複雑なクライアント側の動作を宣言的に定義する方法を提供します。動的アクションの作成ウィザードを使用して、定義された条件セットが発生したときに実行されるアクションを指定します。また、アクションの影響を受ける要素や、影響を受ける時期と影響も指定できます。

動的アクションを使用するとき、ページに追加する動的アクションが多くなるほど全体のページ・サイズが大きくなることに注意する必要があります。これは、動的アクション・フレームワークでは、定義された各動的アクションについてクライアントへの追加コードを生成し、そのコードはクライアント内のフレームワークによってダウンロードおよび実行される必要があるためです。

動的アクションには、アクションを制御するために指定できる条件が含まれています。レポートやチャートなどのOracle Application Expressコンポーネントは、特定のカレンダ・イベントに対応できます。たとえば、カレンダを表示して、後続の月を表示するボタンをクリックしたときに、関連するレポートを自動的にリフレッシュする動的アクションを作成できます。

この機能を使用するには、開発者がページ・デザイナのカレンダ・ページで新しい動的アクションを作成します。ページ・デザイナの左ペインにある「動的アクション」タブで、新しい動的アクションを選択します。作成したら、新しい動的アクションが「新規」のラベルとともに赤色で表示されます。その後、開発者がプロパティ・エディタで動的アクション属性を編集します。プロパティ・エディタで、「時期」属性を見つけて展開します。「時期」属性の「イベント」で、次のいずれかのイベントを選択します。

- 日付の選択[カレンダ]
このイベントは、ユーザーがマウスまたはキーボードを使用して空の日付または日付範囲を選択したときに起動します。開発者がカレンダ属性で「リンクの作成」を指定した場合、イベントは起動しません。

現在のビューに関する情報は、データ・オブジェクトとして渡されます。

{ "newStartDate"::: "newEndDate"::: }

{ "newStartDate":{first day of selection} (YYYYMMDDHH24MISS),
"newEndDate": {last day of selection} YYYYMMDDHH24MISS }

- イベントの選択[カレンダ]
このイベントは、ユーザーがマウスを使用して既存のイベントをクリックしたとき、またはキーボードを使用して選択したときに起動します。開発者がカレンダ属性で「リンクの編集」を指定した場合、イベントは起動しません。データ・オブジェクトには、イベントのjQuery FullCalendarのJSON表現が含まれます。

関連項目:

FullCalendarドキュメントの「Event Data」、「Event Object」

- ビューの変更[カレンダ]
このイベントは、ビュー・タイプが変更されたとき(日、週、月、リスト)、またはビューが前または次のビュー・ページに変更されたときに起動します。データ・オブジェクトには、次の情報が含まれます。

{ "viewType": {view type, day, week, month or list},
"startDate": {first day of view} (YYYYMMDDHH24MISS),
"endDate": {last day of view} (YYYYMMDDHH24MISS) }

注意:

この機能の例を確認するには、サンプル・カレンダ・サンプル・アプリケーションを実行します。ナビゲーション・メニューから、カレンダおよび動的アクションを選択してカレンダ・イベントを選択します。パッケージ・アプリケーションのインストールを参照してください。

関連項目:

動的アクションの管理および動的アクションのデバッグ(問題をデバッグする方法の詳細)

10.2 マップの作成

アプリケーション・ビルダーには、「デスクトップ」ユーザー・インタフェースのページにマップ・チャートを生成するための組込みウィザードが用意されています。マップ・チャートの作成方法は、マップを既存ページに追加するか、マップを新しいページに追加するかによって異なります。

トピック:

- マップ・チャートのサポートについて

- マップのSQL問合せの作成について

- 新しいページへのマップ・チャートの追加

- ページ・デザイナでのマップ・チャートの管理

- レガシー・コンポーネント・ビューでのマップ・チャートの管理

10.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/

10.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/

「作成」をクリックします。

10.2.3 新しいページへのマップ・チャートの追加

新しいページにマップ・チャートを追加するには、次のステップを実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「ページの作成」をクリックします。
ページの作成ウィザードが表示されます。

4. 「ページの作成」で、次のステップを実行します。

a. ユーザー・インタフェース: ページのユーザー・インタフェースを選択します。

b. ページ・タイプの選択: 「チャート」を選択します。

5. 「チャートの作成」で「マップ・チャート」を選択します。

6. 「ページの作成」で、マップ・タイプ(たとえば、「ヨーロッパ」)を選択し、「次へ」をクリックします。

7. 「マップ・チャートの作成」でツリーを展開し、作成するマップを選択します。

8. 「ページ属性」で、次のステップを実行します。

a. ページ番号 - チャート・オブジェクトを表示するページを選択します。

b. ページ名 - 新しいページを作成する場合は、名前を入力します。

c. ページ・モード: ページ・モードを選択します。

d. ブレッドクラム: ページでブレッドクラム・ナビゲーション・コントロールを使用するかどうか、およびどのブレッドクラム・ナビゲーション・コントロールを使用するかを選択します。

e. 「次へ」をクリックします。

9. 「ナビゲーション・メニュー」で、このページに含めるナビゲーション・プリファレンスを指定し、「次へ」をクリックします。ナビゲーション・オプション(ナビゲーション・メニューまたはタブなど)はカレント・アプリケーションのテーマに応じて決まります。

10. 「マップ属性」で、適切な属性を選択し、「次へ」をクリックします。

注意:

属性の詳細は、フィールドレベル・ヘルプを参照してください。

11. 問合せは次のいずれかの方法で指定します。

- 表示されているフィールドにSQL問合せを入力します。

- 「問合せの作成」ボタンをクリックします。ビルド・チャート問合せウィザードが表示されたら、画面に表示されるステップに従います。

関連属性を指定します。選択したマップ・ソースに関連付けられているマップ参照情報を表示するには、ページの下部にある「マップ参照情報」リージョンを展開します。

データを地理的な位置に関連付けるには、「リージョン名」または「リージョンID」列の情報をマップ問合せに組み込む必要があります。

12. 「作成」をクリックします。

関連項目:

「マップのSQL問合せの作成について」

10.2.4 ページ・デザイナでのマップ・チャートの管理

ページ・デザイナでマップ・チャートを追加または編集します。

トピック:

- ページ・デザイナでのマップ・チャートの追加

- ページ・デザイナでのマップ・チャート属性の編集

- カスタムXMLとマップ・チャートの使用

- 自動更新の有効化

10.2.4.1 ページ・デザイナでのマップ・チャートの追加

既存のページにマップ・チャートを追加するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. ページを選択します。

ページ・デザイナが表示されます。

2. ギャラリから、「マップ・チャート」リージョンを選択して、「レイアウト」タブの適切な位置にドラッグします。

ヒント:

「マップ・チャート」リージョンを右クリックして「追加先」を選択し、適切な場所を選択することもできます。

ページ・デザイナは、次に必要なアクションを示します。

「メッセージ」タブには、対応する必要のあるメッセージを示す赤または黄色のバッジが表示されます。「メッセージ」タブには、次の2つのタイプのメッセージが表示されます。

- エラー - エラー・メッセージは赤で表示されます。エラー・メッセージを選択すると、プロパティ・エディタに関連する属性が赤で表示されます。ページを保存する前にエラーに対処する必要があります。

- 警告 - 警告メッセージは黄色で表示されます。警告メッセージを選択すると、プロパティ・エディタで、関連する属性が黄色で表示されます。ページを保存する前にエラーに対処する必要があります。警告メッセージには対処しないでページを保存できることに注意してください。

3. プロパティ・エディタで、次の属性を編集します。

ヒント:

属性の詳細は、プロパティ・エディタで属性を選択し、中央ペインで「ヘルプ」タブをクリックして、参照してください。

a. タイトル - リージョンのタイトルを入力します。

b. 「レイアウト」は、次のようにします。

- 順序 - このアイテムの表示順序を入力します。

- 親リージョン - このリージョンが属する親リージョンを選択します。

- 位置 - このリージョンの表示に使用されるテンプレートの位置を選択します。

c. 「外観」は、次のようにします。

- テンプレート - リージョン・テンプレートを選択します。

- アイテム表示位置 - メイン・リージョン・コンテンツに対して相対的に、ページ・アイテムの表示位置を指定します。

d. レイアウト - 「順序」、「親リージョン」および「位置」を指定します。

e. 外観 - テンプレートを指定します。

4. マップ・チャート属性を表示します。「レンダリング」タブのマップ・チャート・タイトルで、「属性」ノードを選択します。

プロパティ・エディタで、次のマップ属性を編集します。

a. マップ、レベル1 - 使用可能なリストからマップ・レベルを選択します(「ヨーロッパ」など)。

b. マップ、レベル2 - 使用可能なリストからマップ・レベルを選択します(「デンマーク」など)。

c. ソース、SQL問合せ - チャート・シリーズに対するSQL問合せを入力します。

d. 必要に応じて、その他の属性を編集します。

ヒント:

属性の詳細は、プロパティ・エディタで属性を選択し、中央ペインで「ヘルプ」タブをクリックして、参照してください。

5. 「保存」をクリックします。

10.2.4.2 ページ・デザイナでのマップ・チャート属性の編集

作成したマップ・チャートの表示は、プロパティ・エディタで属性を編集することによって変更できます。

マップ・チャート属性を表示するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. ページを選択します。

ページ・デザイナが表示されます。

2. リージョン属性を編集するには、次のステップを実行します。

a. 「レンダリング」タブで、マップ・チャートを含むリージョンを選択します。
プロパティ・エディタにリージョン属性が表示されます。

b. 対象となる属性を編集します。

3. マップ・チャート属性を編集するには、次のステップを実行します。

a. 「レンダリング」タブのリージョン・タイトルで、「属性」ノードを選択します。
プロパティ・エディタにマップ・チャート属性が表示されます。

b. 対象となる属性を編集します。

ヒント:

属性の詳細は、プロパティ・エディタで属性を選択し、中央ペインで「ヘルプ」タブをクリックして、参照してください。

4. 「保存」をクリックします。

関連項目:

カスタムXMLとマップ・チャートの使用および自動更新の有効化

10.2.4.3 カスタムXMLとマップ・チャートの使用

マップ属性ページには、標準の属性で制御できない追加のマップ設定があります。チャートのルック・アンド・フィールをさらに制御するには、カスタムXMLを使用できます。

カスタムXMLを使用するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. ページを選択します。

ページ・デザイナが表示されます。

2. 「レンダリング」タブのリージョン・タイトルで、「属性」ノードを選択します。

プロパティ・エディタにマップ・チャート属性が表示されます。

3. 「カスタムXML」を見つけて展開します。

4. 「カスタムXML」の「カスタム」で、「はい」を選択します。

5. XMLを編集します。

6. 「保存」をクリックします。

ヒント:

マップに対してサポートされているXML書式の詳細は、次のサイトのオンライン・マップXMLリファレンスを参照してください。

http://6.anychart.com/products/anymap/docs/

10.2.4.4 自動更新の有効化

マップ属性ページで「非同期更新」属性を有効にして、情報を監視するマップ・チャートを作成できます。この属性を有効にすると、マップが更新され、指定した時間間隔内に行われた基礎となるデータの変更が反映されます。

自動リフレッシュを有効化するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. ページを選択します。

ページ・デザイナが表示されます。

2. 「レンダリング」タブで、マップ・チャートを含むリージョンを選択します。
プロパティ・エディタにリージョン属性が表示されます。

3. 「レンダリング」タブのリージョン・タイトルで、「属性」ノードを選択します。
プロパティ・エディタにマップ・チャート属性が表示されます。

4. 「自動リフレッシュ」を見つけて展開します。

a. 自動リフレッシュ - 「はい」を選択します。

b. 間隔 - チャートの更新間隔を入力します。

注意:

重大なデータベース・パフォーマンスの問題が発生する可能性があるため、更新間隔を2秒などのように非常に短くすることはお薦めしません。

5. 「保存」をクリックします。

10.2.5 レガシー・コンポーネント・ビューでのマップ・チャートの管理

開発者は、コンポーネント・ビューでマップ・チャートを作成および編集できます。

トピック:

- コンポーネント・ビューでのマップ・チャートの追加

- マップ・チャート属性の編集

- カスタムXMLとマップ・チャートの使用

- 非同期更新の有効化

関連項目:

レガシー・コンポーネント・ビューでのページの管理

10.2.5.1 コンポーネント・ビューでのマップ・チャートの追加

既存のページにマップ・チャートを追加するには、次のステップを実行します。

1. ページに移動します。レガシー・コンポーネント・ビューでのページの表示を参照してください。

2. 新しいリージョンを作成します。「リージョン」で、「作成」アイコンをクリックします。
「リージョンの作成」ウィザードが表示されます。

3. 「マップ・チャート」を選択し、「次へ」をクリックします。

4. 「マップ・タイプ」で、マップ・タイプ(たとえば、「ヨーロッパ」)を選択し、「次へ」をクリックします。

5. 「マップ・ソース」の「ツリー」に、選択したマップ・タイプのマップ・ソース・ファイルのリストが表示されます。使用するマップ・ソース(たとえば、「デンマーク」)をクリックします。

6. 「表示属性」は、次のようにします。

a. タイトル - リージョンのタイトルを入力します。選択するリージョン・テンプレートにリージョン・タイトルが表示されると、このタイトルが表示されます。

b. リージョン・テンプレート: リージョンの外観を制御するテンプレートを選択します。

c. 親リージョン: 新しいリージョンが属する親リージョンを定義します。

d. 表示ポイント: このリージョンの表示ポイントを指定します。詳細は、フィールドレベル・ヘルプを参照してください。

e. 順序: このコンポーネントの順序を指定します。これによって評価の順序が決まります。

f. 「次へ」をクリックします。

7. 「表示属性」で、適切なマップ属性を選択し、「次へ」をクリックします。
属性の詳細は、フィールドレベル・ヘルプを参照してください。フィールドレベル・ヘルプの表示を参照してください。

8. 問合せは次のいずれかの方法で指定します。

- 表示されているフィールドにSQL問合せを入力します。マップのSQL問合せの作成についてを参照してください。

- 「問合せの作成」ボタンをクリックします。ビルド・チャート問合せウィザードが表示されたら、画面に表示されるステップに従います。

関連属性を指定します。選択したマップ・ソースに関連付けられているマップ参照情報を表示するには、ページの下部にある「マップ・リージョン情報」リージョンを展開します。

データを地理的な位置に関連付けるには、「リージョン名」または「リージョンID」列の情報をマップ問合せに組み込む必要があります。マップのSQL問合せの作成についてを参照してください。

9. 「条件付き表示」は、次のようにします。

a. 条件タイプ: このコンポーネントがレンダリングされるために満たす必要があるリストから、条件タイプを選択します。

b. 認可スキーム: オプションで認可スキームを選択します。このコンポーネントをレンダリングまたは処理するためには、この認可スキームがTRUEと評価される必要があります。

c. 「リージョンの作成」をクリックします。

10.2.5.2 マップ・チャート属性の編集

マップの作成後、マップ属性ページで属性を編集することによって表示を変更できます。

マップ属性ページにアクセスするには、次のステップを実行します。

1. ページに移動します。レガシー・コンポーネント・ビューでのページの表示を参照してください。

2. チャート属性ページにアクセスします。

a. 「リージョン」で、リージョン名を選択します。
リージョン定義が表示されます。

b. 「マップ属性」をクリックします。

3. 対象となる属性を編集します。
属性の詳細は、フィールドレベル・ヘルプを参照してください。フィールドレベル・ヘルプの表示を参照してください。

4. 「変更の適用」をクリックします。

関連項目:

カスタムXMLとマップ・チャートの使用および非同期更新の有効化

10.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/

10.2.5.4 非同期更新の有効化

マップ属性ページで「非同期更新」属性を有効にして、情報を監視するマップ・チャートを作成できます。この属性を有効にすると、マップが更新され、指定した時間間隔内に行われた基礎となるデータの変更が反映されます。

非同期更新を有効にするには、次のステップを実行します。

1. マップ・チャートを作成します。

2. ページに移動します。レガシー・コンポーネント・ビューでのページの表示を参照してください。

3. マップ属性ページにアクセスします。

4. 「リージョン」で、リージョン名を選択します。

5. 「マップ属性」をクリックします。

6. 「リフレッシュ」までスクロールします。

7. 「非同期更新」で、「はい」を選択します。

8. 「更新間隔」で、マップの更新間隔(秒)を入力します。最適なパフォーマンスを得るには、2秒を超える間隔を選択します。

9. 「変更の適用」をクリックします。

10.3 チャートの作成

アプリケーション・ビルダーには、チャートを生成するための組込みウィザードが用意されています。

トピック:

- サポートされるチャートについて

- サンプル・チャート

- 新しいページへのチャートの追加

- チャートの管理

- カスタムJavaScriptとチャートの使用

関連項目:

レガシー・チャートの管理

10.3.1 サポートされるチャートについて

アプリケーション・ビルダーでは、次の2つのチャート・タイプがサポートされています。

- チャート: Oracle Application Expressでのチャートのサポートは、Oracle JavaScript拡張機能ツールキット(Oracle JET)データ視覚化に基づいています。Oracle JETは、最新のJavaScript、CSS3およびHTML5のデザイン原理と開発原理に基づいたモジュラ・オープン・ソース・ツールキットを提供することによって開発者を支援します。Oracle JETのデータ視覚化コンポーネントには、カスタマイズ可能なチャート、ゲージ、およびデータ分析のためにフラットまたは階層的なデータをグラフィック表示で表すために使用できる、その他のコンポーネントがあります。各Oracle JET視覚化は、アニメーション、アクセシビリティ、レスポンシブ・レイアウト、国際化、テスト自動化および幅広いインター・アクティビティ機能をサポートしています。チャートでは、棒グラフ、折れ線グラフ、面グラフ、レンジ・チャート、組合せチャート、散布チャート、バブル・チャート、極チャート、レーダー・チャート、円グラフ、ドーナツ・グラフ、ファンネル・チャート、株価チャートなどの、様々な方法でデータ・セットを視覚化できます。

関連項目:

JavaScript拡張機能ツールキット(JET) Oracle JETによるアプリケーションの開発のデータ視覚化の操作

- AnyChartチャート: AnyChartチャートのサポートは、AnyChartによって提供されるサード・パーティのチャート作成ソリューションに基づきます。これはフレキシブルなFlashおよびJavaScript (HTML5)ベースのソリューションで、開発者は動きがありコンパクトでインタラクティブなチャートを作成できます。AnyChartチャートはレガシー・コンポーネントに分類されており、今後のリリースでは非推奨になる可能性があります。

関連項目:

レガシー・チャートの管理および新しいコンポーネントを組み込むためのアプリケーションのアップグレード

10.3.2 サンプル・チャート

次に、サンプル・チャート・サンプル・アプリケーションからのサンプル・チャートを示します。

このチャートには次の属性があります。

- 第2Y軸: Y2 Axis Titleのタイトルを表示し、Shop Cのデータのシリーズに関連付けられています。

- 分割二重Y軸: Store AとAcme Storeの2つのデータのシリーズが積み上げられて表示され、Y軸に関連付けられており、3つ目のデータのシリーズShop Cが第2Y軸に関連付けられて、他の2つのデータのシリーズの下に個別のチャートとしてレンダリングされます。

ページの下部にある棒グラフの情報リージョンを展開して、チャートの情報を確認します。

関連項目:

パッケージ・アプリケーションのインストール(サンプル・チャート・アプリケーションのインストールの詳細)

10.3.3 新しいページへのチャートの追加

新しいページにチャートを追加するには、次のステップを実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「ページの作成」をクリックします。

4. 「ページの作成」で、次のステップを実行します。

a. ユーザー・インタフェース: ページのユーザー・インタフェースを選択します。

b. ページ・タイプの選択: 「チャート」を選択します。

c. 「次へ」をクリックします。

5. 「チャート・タイプ」は、次のようにします。

a. チャート・タイプ: チャート・タイプを選択します。

ヒント:

「ガント」を選択した場合は、ガント・チャート・タイプを選択するように求められます。

b. 「次へ」をクリックします。

6. 「ページおよびリージョン属性」で、次のステップを実行します。

a. ページ番号: チャート・オブジェクトを表示するページを入力します。

b. ページ名: ページ名を入力します。

c. ページ・モード: ページ・モードを選択します。
詳細は、フィールドレベル・ヘルプを参照してください。フィールドレベル・ヘルプの表示を参照してください。

d. ブレッドクラム - ページでブレッドクラム・ナビゲーション・コントロールを使用するかどうかを選択します。

e. 「次へ」をクリックします。

7. 「ナビゲーションのプリファレンス」で、このページに含めるナビゲーションのタイプを指定し、「次へ」をクリックします。ナビゲーション・オプション(ナビゲーション・メニューまたはタブなど)はカレント・アプリケーションのテーマに応じて決まります。

ヒント:

次のステップでは、Oracle JETチャートを選択したと想定しています。Oracle JET以外のチャート(ガントなど)を選択した場合、次のステップが異なる場合があります。画面に表示されるステップに従います。

8. 「ソース」で、チャート・ソースが表かSQL問合せかを選択します。
チャート・ソースが表の場合:

a. ソース・タイプ - 「表」を選択します。

b. 表/ビューの所有者: チャートを作成している表の所有者を選択します。

c. 表/ビューの名前: チャートの基になる表またはビューを選択します。

d. 送信するページ・アイテム: チャート・データが各リクエストで読み取られるときにセッション・ステートに設定される、カレント・ページのページ・アイテムのカンマ区切りリストを入力します。

e. 最大行数: チャートの表示に使用する行の最大数を入力します。

f. 「次へ」をクリックします。

チャート・ソースがSQL問合せの場合:

a. ソース・タイプ - 「SQL問合せ」を選択します。

b. SQL問合せ: チャートに使用されるSQL SELECT文を入力します。SQL SELECT文には、少なくとも2つの列が含まれている必要があります。

c. 送信するページ・アイテム: チャート・データが各リクエストで読み取られるときにセッション・ステートに設定される、カレント・ページのページ・アイテムのカンマ区切りリストを入力します。

d. 最大行数: チャートの表示に使用する行の最大数を入力します。

e. 「次へ」をクリックします。

9. 「列のマッピング」は、次のようにします。

a. チャートにマップする列を選択します。表示されるオプションは、選択したチャート・タイプによって異なります。
属性の詳細は、フィールドレベル・ヘルプを参照してください。フィールドレベル・ヘルプの表示を参照してください。

b. 「次へ」をクリックします。

10. 「作成」をクリックします。

10.3.4 チャートの管理

開発者は、ページ・デザイナでチャート属性を作成および編集できます。

トピック:

- ページ・デザイナでのチャートの追加

- ページ・デザイナでのチャート属性の編集

- ページ・デザイナでのチャート・タイプの切替え

- 自動リフレッシュの有効化

関連項目:

「ページ・デザイナでのページの表示」

10.3.4.1 ページ・デザイナでのチャートの追加

ページ・デザイナで既存ページにチャートを追加するには、次のステップを実行します。

1. ページ・デザイナで、チャートを含むページを表示します。

2. 中央ペインの下部にあるギャラリで、「リージョン」をクリックして「チャート」を探します。

ギャラリに、ページに追加できるすべてのコントロールまたはコンポーネントが一覧表示されます。カーソルをコントロールまたはコンポーネントにあわせると、説明するツールチップが表示されます。

3. ギャラリから、「チャート」を右クリックしてコンテキスト・メニューを表示します。「追加先」を選択して目的の位置を選択します。

ヒント:

ギャラリで「チャート」をクリックして、「レイアウト」タブの適切な位置までドラッグすることもできます。

ページ・デザイナは、次に必要なアクションを示します。

4. 中央ペインで「メッセージ」タブをクリックします。

「メッセージ」タブには、対応する必要のあるメッセージを示す赤または黄色のバッジが表示されます。「メッセージ」タブには、次の2つのタイプのメッセージが表示されます。

- エラー - エラー・メッセージは赤で表示されます。エラー・メッセージを選択すると、プロパティ・エディタに関連する属性が赤で表示されます。ページを保存する前にエラーに対処する必要があります。

- 警告 - 警告メッセージは黄色で表示されます。警告メッセージを選択すると、プロパティ・エディタで、関連する属性が黄色で表示されます。ページを保存する前にエラーに対処する必要があります。警告メッセージには対処しないでページを保存できることに注意してください。

5. 必要なリージョン属性を編集します。

プロパティ・エディタですべての属性を表示するには、「すべて表示」を選択します。

ヒント:

属性の詳細は、プロパティ・エディタで属性を選択し、中央ペインで「ヘルプ」タブをクリックして、参照してください。

6. チャート属性を編集します。

a. 「レンダリング」タブで、「属性」ノードを選択します。
プロパティ・エディタに属性が表示されます。

b. 必要なチャート属性を編集します。

7. シリーズを編集します。

a. 「レンダリング」タブで、「シリーズ」ノードを選択します。
プロパティ・エディタにシリーズが表示されます。

b. シリーズのSQL問合せを入力して、選択したチャート・タイプに対して関連付けるその列のマッピングを定義します。

8. 軸を編集します。

ヒント:

「軸」ノードは、面グラフ、棒グラフ、バブル・チャート、組合せチャート、折れ線グラフ、面付き折れ線グラフ、極チャート、レーダー・チャート、レンジ・チャート、散布チャート、株価チャートなどの、軸をサポートするチャート・タイプの場合にのみ表示されます。

a. 「レンダリング」タブで、「軸」ノードを選択します。
プロパティ・エディタに軸が表示されます。

b. 必要な軸属性を編集して、軸の値に適用するデータ書式を定義します。

9. 「保存」または「ページの保存と実行」をクリックします。

10.3.4.2 ページ・デザイナでのチャート属性の編集

チャートの作成後は、ページ・デザイナでチャート属性を編集してチャートの表示を変更できます。Oracle JETベースのチャートをレガシー・コンポーネント・ビューで管理することはできません。

チャート属性を編集するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. ページを選択します。

ページ・デザイナが表示されます。

2. 左ペインの「レンダリング」タブで、チャートを探します。

3. チャートで、「属性」ノードを選択します。

プロパティ・エディタにチャート属性が表示されます。

4. プロパティ・エディタですべての属性を表示するには、「すべて表示」をクリックします。

5. グループまたは属性を検索するには、「フィルタ・プロパティ」フィールドにキーワードを入力します。

6. チャート属性を編集します。

7. 「保存」をクリックします。

10.3.4.3 ページ・デザイナでのチャート・タイプの切替え

チャートの作成後は、チャート属性を編集してチャート・タイプを切り替えることができます。

チャート・タイプを切り替えるには、次のステップを実行します。

1. ページ・デザイナで、チャートを含むページを表示します。

2. 「レンダリング」タブで、「属性」ノードを選択します。

「プロパティ・エディタ - 属性」が表示されます。

3. 「チャート」セクションを開きます。

4. 「タイプ」で、切り替えるチャート・タイプを選択します。たとえば、「組合せ」などです。

属性の詳細は、フィールドレベル・ヘルプを参照してください。

5. 「レンダリング」タブで、「シリーズ」ノードを選択します。

「プロパティ・エディタ - シリーズ」が表示されます。

a. すべての必要な列マッピングの列が定義されていることを確認します。

注意:

列マッピングはチャート・タイプごとに異なる場合があるため、選択したチャート・タイプですべての必要な列マッピングが定義されるようにする必要があります。

b. 「タイプ」で、チャート・シリーズ・タイプを選択します。たとえば、「棒の範囲」などです。

注意:

同じデータ・プロットでの異なるタイプのシリーズの組合せをサポートするのは、一部のチャート・タイプのみです。「シリーズ・タイプ」属性は、組合せチャート、極チャート、レーダー・チャートおよびレンジ・チャートのチャート・タイプの場合にのみ表示されます。

6. 「保存」または「ページの保存と実行」をクリックします。

10.3.4.4 自動リフレッシュの有効化

チャート属性ページで「自動リフレッシュ」属性を有効にするか、「リフレッシュ」アクションとともに動的アクションを使用すると、チャートで情報を監視できます。

トピック:

- 「自動リフレッシュ」属性の有効化

- ページ・デザイナでのリフレッシュ動的アクションの作成

10.3.4.4.1 「自動リフレッシュ」属性の有効化

「自動リフレッシュ」属性を有効にすると、チャートが更新され、指定した時間間隔内に基礎となるデータで行われた変更が反映されます。

自動リフレッシュ更新を有効化するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. ページを選択します。

ページ・デザイナが表示されます。

2. 「レンダリング」タブで、チャートを含むリージョンを見つけて、「属性」ノードを選択します。
属性がプロパティ・エディタに表示されます。

3. プロパティ・エディタですべての属性を表示するには、「すべて表示」をクリックします。

4. 「自動リフレッシュ」を探します。

ヒント:

グループまたは属性を検索するには、「フィルタ・プロパティ」フィールドにキーワードを入力します。

5. 「自動リフレッシュ」で、「はい」を選択します。

6. 「保存」をクリックします。

10.3.4.4.2 ページ・デザイナでのリフレッシュ動的アクションの作成

リフレッシュ動的アクションを作成するには、次の手順を実行します。

1. ページ・デザイナでページを表示します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. ページを選択します。

ページ・デザイナが表示されます。

2. 左ペインで「動的アクション」タブをクリックします。

3. 「動的アクション」で、「イベント」を右クリックし、「動的アクションの作成」を選択します。

動的アクションの属性がプロパティ・エディタに表示されます。

ヒント:

「メッセージ」タブに、対処が必要なメッセージを示す赤または黄色の印が表示されます。メッセージを選択すると、プロパティ・エディタに関連する属性が表示されます。赤いエラー・メッセージは、保存する前に対処する必要があります。

4. プロパティ・エディタで、次の動的アクション属性を編集します。

ヒント:

属性の詳細は、プロパティ・エディタで属性を選択し、中央ペインで「ヘルプ」タブをクリックして、参照してください。

a. 指定、名前 - 動的アクションの名前を入力します。

b. 実行オプション、順序 - このコンポーネントの順序を指定します。これによって評価の順序が決まります。

c. 時期、イベント - 動的アクションを起動するイベントを指定します。

d. 時期、選択タイプ - イベントのトリガーに使用するページ要素または構成体のタイプを選択します。たとえば、プロパティ・エディタで属性を選択して、中央ペインの「ヘルプ」タブをクリックします。

5. 「レンダリング」タブで、Trueの下の最初のアクションを選択します。

a. アクション: 「リフレッシュ」を選択します。

b. 選択タイプ: 「リージョン」を選択します。

c. リージョン: チャートを含むリージョンを選択します。

6. 「保存」をクリックします。

関連項目:

動的アクションの管理

10.3.5 カスタムJavaScriptとチャートの使用

カスタムJavaScriptを追加して、チャートのルック・アンド・フィールを制御します。

カスタムJavaScriptを使用するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. ページを選択します。

ページ・デザイナが表示されます。

2. 「レンダリング」タブで、チャートを含むリージョンを見つけて、「属性」ノードを選択します。
属性がプロパティ・エディタに表示されます。

3. プロパティ・エディタですべての属性を表示するには、「すべて表示」をクリックします。

4. 「詳細」を探します。

5. 「JavaScriptコード」に、チャートをカスタマイズするコードを入力します。

次に例を示します。

function( options ){
// Setup a callback function which gets called
// when data is retrieved, it allows to manipulate the series
options.dataFilter = function( data ) {

// e.g Set the first series of chart to the colour red
data.series[ 0 ].color = "red";
};
// Set chart initialization options
// e.g. Set chart type to Line
options.type = "line";
return options;
}

6. 「保存」をクリックします。

ヒント:

サポートされるチャート・オプションの詳細は、Oracle JavaScript拡張機能ツールキット(JET)のJSDocページのojChartを参照してください。

関連項目:

新しいページへのレガシー・チャートの追加

10.4 アプリケーションのヘルプの作成

アプリケーション・ビルダーで作成したヘルプは、専用のヘルプ・ページに表示されます。ヘルプを表示するには、専用の「ヘルプ」ページへのリンクをクリックします。このヘルプ・ページには、表示しているページに固有のページ・ヘルプおよびフィールドレベル・ヘルプのトピックが表示されます。

トピック:

- ページ・デザイナでのヘルプの作成

- レガシー・コンポーネント・ビューでのヘルプの作成

- 複数のアイテム・ヘルプ・トピックの同時編集

- ヘルプ・ナビゲーション・バー・エントリの作成

10.4.1 ページ・デザイナでのヘルプの作成

この項では、ページ・デザイナでヘルプを作成する方法について説明します。

トピック:

- ヘルプの作成について

- ページ・デザイナでのヘルプ・ページおよびヘルプ・リージョンの作成

- ページ・デザイナでのページ・ヘルプの定義

- ページ・デザイナでのアイテム・ヘルプの定義

10.4.1.1 ヘルプの作成について

アプリケーション・ビルダーには、アプリケーションのヘルプを作成するための組込み属性が含まれています。アプリケーションのヘルプを作成するには、次のステップを実行します。

- ステップ1: 専用のヘルプ・ページおよびヘルプ・リージョンを作成します。ページ・デザイナでのヘルプ・ページおよびヘルプ・リージョンの作成を参照してください。

- ステップ2: ページ・ヘルプ・テキストを定義します。ページ・デザイナでのページ・ヘルプの定義を参照してください。

- ステップ3: アイテム・ヘルプ・テキストを定義します。ページ・デザイナでのアイテム・ヘルプの定義を参照してください。

- ステップ4: ヘルプ・ページにリンクするためのナビゲーション・バー・アイコンを作成します。ヘルプ・ナビゲーション・バー・エントリの作成を参照してください。

10.4.1.2 ページ・デザイナでのヘルプ・ページおよびヘルプ・リージョンの作成

ページ・デザイナでヘルプ・ページおよびヘルプ・リージョンを作成するには、次のステップを実行します。

1. ヘルプ用の空白ページを作成します。

2. ページ・デザイナで新規ページを表示します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. ページを選択します。

ページ・デザイナが表示されます。

3. ギャラリで、「ヘルプ・テキスト」リージョンを右クリックして「追加先」を選択し、適切な位置を選択します。

ヒント:

ギャラリからドラッグ・アンド・ドロップすることもできます。ギャラリから、「ヘルプ・テキスト」リージョンを選択して、「レイアウト」タブの適切な位置にドラッグします。

4. プロパティ・エディタですべての属性を表示するには、「すべて表示」をクリックします。

5. 次の属性を編集します。

ヒント:

グループまたは属性を検索するには、「フィルタ・プロパティ」フィールドにキーワードを入力します。

a. 指定、タイトル - リージョンのタイトルを入力します。

b. レイアウト、順序 - このアイテムの表示順序を入力します。順序および他のレイアウト設定によって、リージョン内の他のアイテムに対して相対的に、このアイテムの表示位置が決定されます。

c. レイアウト、親リージョン - このリージョンが属する親リージョンを選択します。親リージョンが選択されている場合、このリージョンは完全に親リージョン内にレンダリングされます。

d. レイアウト、位置 - 順序、親リージョンおよび位置を指定します。

e. 外観、テンプレート - リージョン・テンプレートを選択して、このリージョンの外観とレイアウトを定義します。リージョン・テンプレートはアプリケーション・テーマで定義されます。リージョンが作成されると、テンプレートが、現在のテーマで定義されたデフォルトのリージョン・テンプレートに自動的に設定されます。

f. 外観、アイテム表示位置 - メイン・リージョン・コンテンツに対して相対的に、ページ・アイテムの表示位置を選択します。

ヒント:

属性の詳細は、プロパティ・エディタで属性を選択し、中央ペインで「ヘルプ」タブをクリックして、参照してください。

6. 「保存」をクリックします。

ヒント:

サポートされるチャート・オプションの詳細は、Oracle JavaScript拡張機能ツールキット(JET)のJSDocページのojChartを参照してください。

7. 「保存」をクリックします。

関連項目:

「アプリケーションのホームページからのページの作成」

10.4.1.3 ページ・デザイナでのページ・ヘルプの定義

ページ・デザイナでページ・ヘルプ・テキストを定義するには、次のステップを実行します。

1. ページ・デザイナで新規ページを表示します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. ページを選択します。

ページ・デザイナが表示されます。

2. 「レンダリング」タブで、ページ名をクリックします。

3. 「プロパティ・エディタ - ページ」で、「ヘルプ」まで下にスクロールして「ヘルプ・テキスト」属性にテキストを入力します。

4. 「保存」をクリックします。

10.4.1.4 ページ・デザイナでのアイテム・ヘルプの定義

ページ・デザイナでページ・ヘルプ・テキストを定義するには、次のステップを実行します。

1. ページ・デザイナで新規ページを表示します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. ページを選択します。

ページ・デザイナが表示されます。

2. 「レンダリング」タブで、ヘルプを定義するアイテムをクリックします。

3. プロパティ・エディタで「ヘルプ」を見つけて展開し、「ヘルプ・テキスト」属性にテキストを入力します。

4. 「保存」をクリックします。

5. ヘルプ・テキストが必要な各アイテムに対して、前述のステップを繰り返します。

10.4.2 レガシー・コンポーネント・ビューでのヘルプの作成

この項では、コンポーネント・ビューでヘルプを作成する方法について説明します。

注意:

レガシー・コンポーネント・ビューでのページの管理

トピック:

- ヘルプの作成について

- コンポーネント・ビューでのヘルプ・ページおよびヘルプ・リージョンの作成

- コンポーネント・ビューでのページ・ヘルプの定義

- コンポーネント・ビューでのアイテム・ヘルプの定義

10.4.2.1 ヘルプの作成について

アプリケーション・ビルダーには、アプリケーションのヘルプを作成するための組込み属性が含まれています。アプリケーションのヘルプを作成するには、次のステップを実行します。

- ステップ1: 専用のヘルプ・ページおよびヘルプ・リージョンを作成します。コンポーネント・ビューでのヘルプ・ページおよびヘルプ・リージョンの作成を参照してください。

- ステップ2: ページ・ヘルプ・テキストを定義します。コンポーネント・ビューでのページ・ヘルプの定義を参照してください。

- ステップ3: アイテム・ヘルプ・テキストを定義します。コンポーネント・ビューでのアイテム・ヘルプの定義を参照してください。

- ステップ4: ヘルプ・ページにリンクするためのナビゲーション・バー・アイコンを作成します。ヘルプ・ナビゲーション・バー・エントリの作成を参照してください。

アプリケーション・ビルダーで作成したヘルプは、専用のヘルプ・ページに表示されます。ヘルプを表示するには、専用の「ヘルプ」ページへのリンクをクリックします。このヘルプ・ページには、表示しているページに固有のページ・ヘルプおよびフィールドレベル・ヘルプのトピックが表示されます。

10.4.2.2 コンポーネント・ビューでのヘルプ・ページおよびヘルプ・リージョンの作成

アプリケーションのヘルプを作成するための最初のステップは、専用のページおよび「ヘルプ・テキスト」リージョンを作成することです。次の構文を使用してコールすると、作成するリージョンに、カレント・ページのページ・ヘルプおよびアイテム・ヘルプが表示されます。

f?p=&APP_ID.:Page:Session:&APP_PAGE_ID.

コンポーネント・ビューでヘルプ・ページおよびヘルプ・リージョンを作成するには、次のステップを実行します。

1. ヘルプ用の空白ページを作成します。アプリケーションのホームページからのページの作成を参照してください。

2. コンポーネント・ビューでページを表示します。レガシー・コンポーネント・ビューでのページの表示を参照してください。

3. 新しいリージョンを作成します。「リージョン」で、「作成」アイコンをクリックします。
「リージョンの作成」ウィザードが表示されます。

4. 「リージョン」で、「作成」アイコンをクリックします。

5. リージョン・タイプを選択するプロンプトが表示されたら、「ヘルプ・テキスト」を選択して「次へ」をクリックします。

6. 「表示属性」は、次のようにします。

a. タイトル - リージョンのタイトルを入力します。選択するリージョン・テンプレートにリージョン・タイトルが表示される際に、このタイトルが表示されます。

b. リージョン・テンプレート: リージョンの外観を制御するテンプレートを選択します。

c. 親リージョン: 新しいリージョンが属する親リージョンを定義します。

d. 表示ポイント: このリージョンの表示ポイントを指定します。詳細は、フィールドレベル・ヘルプを参照してください。

e. 順序: このコンポーネントの順序を指定します。これによって評価の順序が決まります。

f. 「次へ」をクリックします。

7. 「ソース」で、「次へ」をクリックします。

8. 「条件付き表示」は、次のようにします。

a. 条件タイプ: このコンポーネントがレンダリングされるために満たす必要があるリストから、条件タイプを選択します。条件付きのレンダリングおよびプロセスの理解を参照してください。

b. 認可スキーム: オプションで認可スキームを選択します。このコンポーネントをレンダリングまたは処理するためには、この認可スキームがTRUEと評価される必要があります。認可を介したセキュリティの提供を参照してください。

c. 「次へ」をクリックします。

9. 「リージョンの作成」をクリックします。

10.4.2.3 コンポーネント・ビューでのページ・ヘルプの定義

コンポーネント・ビューでページ・ヘルプ・テキストを定義するには、次のステップを実行します。

1. ページ・ヘルプを追加するページにナビゲートします。レガシー・コンポーネント・ビューでのページの表示を参照してください。

2. 「ページ」で、「編集」アイコンをクリックします。

3. 「ヘルプ」までスクロールします。

4. 表示されたフィールドにヘルプ・テキストを入力します。

ヒント:

デフォルトでは、「ヘルプ」にはテキストNo help is available for this pageが入力されています。

5. 「変更の適用」をクリックします。

ページ・ヘルプ・テキストが必要な各ページに対して、これらのステップを実行します。

10.4.2.4 コンポーネント・ビューでのアイテム・ヘルプの定義

コンポーネント・ビューでアイテム・ヘルプを定義するには、次のステップを実行します。

1. ヘルプを追加するページにナビゲートします。レガシー・コンポーネント・ビューでのページの表示を参照してください。

2. 「アイテム」で、編集するアイテムを探します。

3. アイテムの属性ページにアクセスします。「アイテム」で、アイテム名を選択します。

「ページ・アイテムの編集」ページが表示されます。

4. 「ヘルプ・テキスト」までスクロールします。

5. 表示されたフィールドにヘルプ・テキストを入力します。

6. 「変更の適用」をクリックします。

ヘルプ・テキストが必要な各アイテムに対して、これらのステップを実行します。

10.4.3 複数のアイテム・ヘルプ・トピックの同時編集

この項では、複数のヘルプ・トピックを一度に編集する様々な方法について説明します。

トピック:

- 「アイテム・ヘルプをバルク編集」レポートの使用

- アイテム・ヘルプ・トピックのシード

10.4.3.1 「アイテム・ヘルプをバルク編集」レポートの使用

アプリケーションにヘルプを含める場合は、「アイテム・ヘルプをバルク編集」レポートを使用して、アプリケーション内のすべてのヘルプ・トピックを一度に編集できます。さらに、「アイテム・ヘルプをバルク編集」レポートを使用して、アイテムのラベルや名前を表示し、アイテムまたはアイテムを含むページへのリンクにアクセスできます

アプリケーションにヘルプを含める場合は、「アイテム・ヘルプをバルク編集」レポートを使用して、複数のヘルプ・トピックを一度に編集できます。

「アイテム・ヘルプをバルク編集」レポートを表示するには、次のステップを実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「ユーティリティ」アイコンをクリックします。

4. 「ページ固有のユーティリティ」から、「アイテム・ユーティリティ」を選択します。

5. 「すべてのアイテム・ヘルプ・テキストのグリッド編集」をクリックします。

6. アイテム・ヘルプのバルクレポートでは、次の操作が可能です。

- 既存のヘルプ・トピックを更新できます。表示されるヘルプ・テキストを編集し、「変更の適用」をクリックします。

- ページ番号をクリックして、アイテムが含まれているページにリンクできます。

- アイテム名をクリックして、ページ・アイテムにリンクできます。

関連項目:

「アイテム・ヘルプ・トピックのシード」

10.4.3.2 アイテム・ヘルプ・トピックのシード

アプリケーションにヘルプが含まれていない場合は、デフォルトのヘルプ・テキストの一括更新を実行できます。

ヘルプ・トピックをシードするには、次のステップを実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「ユーティリティ」アイコンをクリックします。

4. 「ページ固有のユーティリティ」から、「アイテム・ユーティリティ」を選択します。

5. 「すべてのアイテム・ヘルプ・テキストのグリッド編集」をクリックします。

6. 「アイテム・ヘルプ・テキストのシード」をクリックします。

7. 既存のアイテム・ヘルプを編集するには:

a. 「アイテム・ヘルプ・テキスト」に、すべてのヘルプ・トピックに表示されるデフォルト・テキストを入力します。

b. 「変更の適用」をクリックします。

8. 現在ヘルプ・テキストのないすべてのアイテムにヘルプ・テキストを作成するには、「アイテム・ヘルプ・テキストのシード」 をクリックして画面上の指示に従います。

9. 「変更の適用」をクリックします。

10.4.4 ヘルプ・ナビゲーション・バー・エントリの作成

ヘルプを作成したら、次に、ユーザーがリンクに使用するためのナビゲーション・バー・エントリを作成します。

ナビゲーション・バー・エントリを作成するには、次のステップを実行します。

1. ナビゲーション・バー・エントリ・ページにナビゲートします。

a. 「ワークスペース」ホームページにナビゲートします。

b. 「アプリケーション・ビルダー」アイコンをクリックします。

c. アプリケーションを選択します。

d. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

e. 「ナビゲーション」で、「ナビゲーション・バー・エントリ」をクリックします。

2. 「作成」をクリックします。
ナビゲーション・バー・エントリの作成ウィザードが表示されます。

3. 「方法」で、「最初から」を選択し、「次へ」をクリックします。

4. 「タイプ」で、「URLへのナビゲーション」を選択して「次へ」をクリックします。

5. 「属性」で、次のように指定します。

a. 順序: このコンポーネントの評価の順序を指定します。

b. エントリ・ラベル: このナビゲーション・バー・エントリの表示テキストを入力します。

c. アイコン・イメージ名: イメージ名を入力します。ネーミング規則の詳細は、フィールドレベル・ヘルプを参照してください。フィールドレベル・ヘルプの表示を参照してください。

d. イメージALT: イメージのナビゲーション・アイコンのALTテキストを入力します。イメージ名を指定しないと、このテキストが表示されます。

e. イメージの高さ: イメージの高さをピクセルで定義します。

f. 「次へ」をクリックします。

6. 「ターゲット」は、次のようにします。

a. ターゲットは: 「このアプリケーションのページ」を選択します。

b. ページ: ページ・デザイナでのヘルプの作成で作成したヘルプ・ページのページ番号を指定します。

c. リクエスト: 次を入力します。

&APP_PAGE_ID.

「リクエスト」に置換文字列&APP_PAGE_IDを指定することによって、Application Expressエンジンに対して、ユーザーがこのアイコンをクリックした場合にカレント・ページのヘルプ・テキストを表示するように指示します。

d. 「次へ」をクリックします。

7. ナビゲーション・バー・エントリを表示するための条件を設定するには、条件タイプを選択します。

8. 「作成」をクリックします。

関連項目:

ナビゲーション・バー・エントリの作成

11 テーマおよびテーマ・スタイルの使用

開発者はテーマおよびテンプレートを使用して、データベース・アプリケーションのユーザー・インタフェースおよびページ・レイアウトを変更できます。

トピック:

- テーマの使用

- テーマおよびサブスクリプションの管理

- カスタム・テーマの作成

- カスタム・カスケード・スタイルシートの使用

11.1 テーマの使用

テーマとテーマ・スタイルを使用して、アプリケーションの作成時に生産性を向上させることができます。テーマは、アプリケーションのレイアウトとスタイルを定義するテンプレートのコレクションです。テーマにテーマ・スタイルが含まれる場合、開発者はテーマ・ローラー・ユーティリティを使用してアプリケーションの外観を変更できます。

トピック:

- テーマについて

- レスポンシブ・デザインについて

- グリッドベース・テーマについて

- テーマ・スタイルの使用

- テンプレート・オプションの理解

- テーマ・ページへのアクセス

- テーマの編集

関連項目:

テーマおよびサブスクリプションの管理およびテーマおよびサブスクリプションの管理

11.1.1 テーマについて

テーマは、アプリケーション全体のレイアウトおよびスタイルを定義できるテンプレートのコレクションです。テーマにはテンプレートの完全なセットが用意され、アプリケーションに必要となる可能性があるすべてのUIパターンが提供されます。テンプレートはまず、テンプレート・タイプ別に分類され、次にテンプレート・クラス別に分類されます。テンプレート・タイプには、ページ、リージョン、レポート、リスト、ボタン、ラベルおよびポップアップ値リスト(LOV)があります。

各テンプレート・タイプには、多くのテンプレート・クラスがあります。テンプレート・クラスによって、テンプレート・タイプ内でのテンプレートの用途が定義されます。たとえば、リージョン・テンプレートは、フォーム・リージョン・テンプレート、レポート・リージョン・テンプレートなどとして分類できます。このような分類によって、Oracle Application Expressではテーマ間でのテンプレートのマッピングが可能になり、アプリケーション全体のルック・アンド・フィールを簡単に変更できます。

Oracle Application Expressには、広範なテーマ・リポジトリが同梱されています。管理者は、次のようにテーマをテーマ・リポジトリに追加できます。

- ワークスペース・テーマ - ワークスペース管理者は、ワークスペース内のすべての開発者が使用できるテーマを作成できます。ワークスペース・テーマの管理を参照してください。

- パブリック・テーマ - インスタンス管理者は、Oracle Application Express管理サービスに追加することでパブリック・テーマを作成できます。追加すると、これらのパブリック・テーマはインスタンス内のすべてのワークスペースですべての開発者が使用できます。詳細は、『Oracle Application Express管理ガイド』のパブリック・テーマの管理に関する説明を参照してください。

ユニバーサル・テーマ - 42やモバイル - 51などの新しいテーマには、テーマ・スタイルが含まれています。テーマ・スタイルは、ベースCSSに追加されるCSSスタイルシートです。開発者は、テーマ・ローラー・ユーティリティを使用してテーマ・スタイルを変更することによって、アプリケーションの外観を変更できます。

関連項目:

テーマ・スタイルの使用

11.1.2 レスポンシブ・デザインについて

レスポンシブ・デザインにより、ページを表示するデバイス(たとえば、デスクトップ・コンピュータ、ラップトップ・コンピュータ、タブレットまたはスマートフォン)にかかわらず、レイアウトを使用可能スペースに適合させるようなWebページを設計できます。レスポンシブ・デザインを実装することによって、ユーザーは大きい画面では完全な操作性を取得できます。スマートフォンやタブレットでも、レイアウトは特定のデバイスのサイズに調整されます。このサイズ変更のプロセス中に、要素の位置やサイズが変わったり、非表示になったりします。レスポンシブ・デザインの目的は、可能なすべての画面サイズで、すべての重要なコンテンツをユーザー・フレンドリな方法で表示することです。ユニバーサル・テーマ - 42は、レスポンシブ・ユーザー・インタフェース・テーマの例です。

レスポンシブ・デザインは単なる1セットのテンプレートの選択の問題ではありません。アプリケーション開発者として、テーマのテンプレートの使用に責任を負い、本当にレスポンシブ・デザインを促進するページを設計します。既存のアプリケーションをユニバーサル・テーマに変換するには、すべてのアプリケーション・ページを確認して、適切なテンプレートおよびレイアウトが確実に定義されていることが必要です。

Oracle Application Expressでは、任意の画面サイズに拡大/縮小可能なアプリケーションを構築できるレスポンシブ・ユーザー・インタフェース・テーマが提供されます。ユニバーサル・テーマ - 42は、レスポンシブ・デスクトップ・テーマです。開発者は、このテーマを使用して、様々な画面サイズで正しく機能するアプリケーションを構築できます。

モバイル・テーマ - 51を使用すると、スマートフォンやタブレットなどのモバイル・デバイスでの使用に最適化されたアプリケーションを構築できます。モバイル・テーマを使用して構築されたページは、デスクトップ・ページよりも小さく軽量であり、タッチ・イベントおよび方向の変更がサポートされます。

ヒント:

ユニバーサル・テーマ - 42を使用してアプリケーションを表示するには、パッケージ・アプリケーションの使用を参照してください。

11.1.3 グリッドベース・テーマについて

Oracle Application Expressアプリケーションでは、リージョンおよびアイテムのページ上の位置は、グリッド設定を使用して定義されます。テーマ26 - 生産性アプリケーションなどの古いテーマでは、表ベースのグリッドが使用されます。表ベースのテーマでは、複数のリージョンを隣り合せに配置でき、フォームの単一行に複数のアイテムを含めることができます。ユニバーサル・テーマ - 42などの新しいテーマでは、DIVベースのグリッドが使用されます。DIVベースのグリッドを使用するページには、次のような利点があります。

- より簡単に維持および更新できます。DIVベースのページはコードが少ないため、複雑さが減少します。

- より速くロードされます。DIVベースのグリッドを使用するページは、一般的に、より速くロードされます。

表ベースのテーマからDIVベースのテーマに切り替える場合、テーマの切替えウィザードで「グリッドのリセット」オプション、「固定リージョン位置のリセット」を構成する必要があります。「固定リージョン位置のリセット」を選択すると、既存の設定は削除され、すべてのリージョンおよびアイテムが垂直に積み上げられて表示されます。

関連項目:

テーマの切替え

11.1.4 テーマ・スタイルの使用

ユニバーサル・テーマ - 42やモバイル - 51などの新しいテーマには、テーマ・スタイルが含まれています。テーマ・スタイルは、ベースCSSに追加されるCSSです。開発者は、テーマ・ローラー・ユーティリティを使用してアプリケーションの外観を変更できます。

トピック:

- テーマ・スタイルについて

- テーマ・スタイルの作成

- テーマ・ページからのテーマ・スタイルの編集

- ユーザー・インタフェース・ページからのテーマ・スタイルの編集

- ユーザーによるテーマ・スタイルの選択の可能化

- テーマ・ローラーの使用

11.1.4.1 テーマ・スタイルについて

テーマ・スタイルでは、アプリケーションのルック・アンド・フィールを変更するためにベースCSSに追加される、CSSスタイルシートを定義します。ユニバーサル・テーマ - 42やモバイル - 51などの新しいテーマには、ベースCSSファイルに加えてテーマ・スタイルCSSファイルを含めることができます。テーマ・スタイルCSSファイルは、ページ・テンプレート内で#THEME_STYLE_CSS#置換文字列を使用して参照されます。Application Expressエンジンによって、この置換文字列は、テーマ・スタイル属性で定義されているCSSファイル参照と置き換えられます。テーマ・スタイルを使用して、テーマをカスタマイズしたり、別のカラー・スキームに切り替えたり、フラットな外観を適用したり、テーマをレスポンシブにします。1つのテーマに複数のテーマ・スタイルを設定し、その1つのスタイルをアクティブに設定できます。テーマ・スタイルCSSファイルは、テーマ・ローラーを使用して変更できます。

定義後、開発者は次の方法でテーマ・スタイルを選択できます。

- アプリケーションの作成ウィザードの実行時に、「テーマ・スタイル」属性を編集します。アプリケーションの作成ウィザードの使用を参照してください。

- ユーザー・インタフェースの編集。ユーザー・インタフェース・ページからのテーマ・スタイルの編集を参照してください。

- テーマの作成/編集ページへのアクセス。テーマの編集およびテーマ・スタイルの作成を参照してください。

11.1.4.2 テーマ・スタイルの作成

テーマ・スタイルを作成するには、次のステップを実行します。

1. テーマ・ページにナビゲートします。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. 「共有コンポーネント」をクリックします。

d. 「ユーザー・インタフェース」で、「テーマ」を選択します。

2. テーマを選択し、「スタイル」タブをクリックします。

3. 「スタイルの追加」をクリックします。

テーマ・スタイル・ページが表示されます。

4. 「設定」について:

a. 名前 - テーマ・スタイルに説明的な短い名前を指定します。

b. カレント - このスタイルが、テーマで使用されている現在のスタイルかどうかを選択します。

c. パブリック - このスタイルが、エンド・ユーザーによって選択可能かどうかを選択します。

d. ファイルURL - このスタイルが、テーマで使用されている現在のスタイルかどうかを選択します。

属性の詳細は、フィールドレベル・ヘルプを参照してください。

5. 「テーマ・ローラー属性」について:

a. 読取り専用 - テーマ・スタイルが更新されないようにする場合は、「はい」を選択します。テーマ・スタイルをテーマ・ローラーを使用して編集および上書きできるようにする場合は、「いいえ」を選択します。

b. 入力パラメータ・ファイルURL - テーマ・ローラーの使用時に、このテーマ・スタイルを生成するために使用されるLESSファイルのURLを入力します。

c. 出力CSSファイルURL - このテーマ・スタイルについてテーマ・ローラーによって生成されるCSSファイルのURLを入力します。

d. テーマ・ローラーJSON構成、JSON構成 - テーマ・スタイルが保存されると、テーマ・ローラーによってJSON構成が生成されます。

構成を手動で更新することはお薦めしません。ただし、別のアプリケーションのテーマ・スタイルなど、別のテーマ・スタイルからJSON構成をコピーして手動で更新できます。

6. 「作成」をクリックします。

11.1.4.3 テーマ・ページからのテーマ・スタイルの編集

テーマ・スタイルを編集するには、次のステップを実行します。

1. テーマ・ページにナビゲートします。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. 「共有コンポーネント」をクリックします。

d. 「ユーザー・インタフェース」で、「テーマ」を選択します。

2. テーマ名をクリックします。

3. テーマを選択し、「スタイル」タブをクリックします。

4. テーマ・スタイルを選択します。

テーマ・スタイル・ページが表示されます。

5. 現在のテーマ・スタイルを変更するには、該当する属性を編集し、「変更の適用」をクリックします。

属性の詳細は、フィールドレベル・ヘルプを参照してください。

6. 現在のテーマ・スタイルを削除するには、「削除」をクリックします。

7. 「作成」をクリックします。

11.1.4.4 ユーザー・インタフェース・ページからのテーマ・スタイルの編集

ユーザー・インタフェース・ページからテーマ・スタイルを編集するには、次のステップを実行します。

1. ユーザー・インタフェース・ページにナビゲートします。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. 「共有コンポーネント」をクリックします。

d. 「ユーザー・インタフェース」で「ユーザー・インタフェース属性」をクリックします。

ユーザー・インタフェース・ページが表示されます。

2. ユーザー・インタフェース(デスクトップなど)を見つけて、テーマ・スタイル名をクリックします。

テーマ・スタイル・ページが表示されます。

3. 現在のテーマ・スタイルを変更するには、該当する属性を編集し、「変更の適用」をクリックします。

属性の詳細は、フィールドレベル・ヘルプを参照してください。

4. 現在のテーマ・スタイルを削除するには、「削除」をクリックします。

5. 「作成」をクリックします。

11.1.4.5 ユーザーによるテーマ・スタイルの選択の可能化

開発者は、実行中のアプリケーションでユーザーがテーマ・スタイルを選択できるようにすることができます。このことを可能にすると、実行中のアプリケーションで、「カスタマイズ」リンクが、通常は左下隅に表示されます。ユーザーが「カスタマイズ」リンクをクリックすると、ポップアップが表示され、使用可能なテーマ・スタイルがリストされます。ユーザーがテーマ・スタイルを選択すると、テーマ・スタイルがユーザー・プリファレンスとして永続的に格納され、将来のセッション中に保持されます。

ユーザーがテーマ・スタイルを選択できるようにするには、次のステップを実行します。

1. 2つ以上のテーマ・スタイルを含むアプリケーションを作成します。

2. アプリケーションのユーザー・インタフェース・ページに移動します。

a. 「共有コンポーネント」をクリックします。

b. 「ユーザー・インタフェース」で「ユーザー・インタフェース属性」をクリックします。

ユーザー・インタフェース属性ページが表示されます。定義されているユーザー・インタフェースが、ページの上部に表示されます。

3. ユーザー・インタフェースの詳細を編集します。

a. 該当するユーザー・インタフェース(デスクトップなど)の横にある「編集」アイコンをクリックします。

b. 「属性」の下で、「テーマ・スタイルを選択できるようにエンド・ユーザーを有効化」を「はい」に設定します。

c. 「変更の適用」をクリックします。

4. 各テーマ・スタイルを編集して、「パブリック」属性を「はい」に設定します。

a. ユーザー・インタフェース・ページで、テーマ・スタイル名(履歴など)をクリックします。

b. 「設定」の下で、「パブリック」を「はい」に設定します。

c. 「変更の適用」をクリックします。

ユーザー・インタフェース・ページが再表示されます。

11.1.4.6 テーマ・ローラーの使用

テーマ・ローラーは、開発者がコード行を変更することなく、アプリケーションの色や角丸などの属性を迅速に変更できる、ライブCSSエディタです。テーマ・ローラーは、テーマ・スタイルの少なくとも1つに、「入力パラメータ・ファイルURL」属性が定義されている場合に、実行時開発者ツールバーに表示されます。

ヒント:

テーマ・ローラーの例を参照するには、ユニバーサル・テーマ - 42を使用するパッケージ・アプリケーションをインストールして実行します。パッケージ・アプリケーションの使用を参照してください。

テーマ・ローラーを使用するには、次のステップを実行します。

1. ページを実行してプレビューします。

開発者がデスクトップ・アプリケーションを実行すると、編集可能な実行中のページの下部に、実行時開発者ツールバーが表示されます。

ヒント:

テーマ・ローラーは、テーマ・スタイルが定義されている場合にのみ、実行時開発者ツールバーに表示されます。テーマの編集およびスタイルを参照してください。

2. 実行時開発者ツールバーで、「テーマ・ローラー」をクリックします。

テーマ・ローラーによって、アプリケーションのスタイルがフェッチされ、エディタにロードされます。

アクティブなアイコンおよびメニューの上にカーソルをあわせると、その名前が表示されます。

3. セクション名をクリックすると、セクションを開閉できます。主なコントロールには、次のものがあります。

- 共通の表示 - すべての属性を表示します。

ヒント:

「カスタムCSS」セクションを変更することで、ユニバーサル・テーマのテーマ・スタイルを上書きできます。このセクションで使用するセレクタに注意してください。コンテンツを非表示または不鮮明な表示にすると、ユーザーの操作性が低下する場合があります。

- すべて表示 - すべての属性が表示されます。

- 元に戻す - 現在編集しているテーマを前のアクションに戻します。この機能は、テーマを切り替えた場合は動作しません。

- やり直し - 現在の「元に戻す」リビジョンを破棄し、履歴の次のリビジョンに進みます。この機能は、テーマを切り替えた場合は動作しません。

- 検索 - プロパティ、グループおよび色を検索します。検索すると、検索文字列と一致するプロパティのみがテーマ・ローラーによって自動的に表示されます。

- リセット - 選択したテーマをサーバーに保存されている最終バージョンに戻します。テーマをリセットしてページをリロードした後で、「元に戻す」および「やり直し」を使用して変更をリストアできます。

- ヘルプ - ヘルプ・ウィンドウを表示します。

4. 「スタイル」から新しいスタイルを選択し、リストから既存のスタイルを選択します。

5. 「グローバル色」の下で、色見本をクリックして新しい色を選択します。

6. 特定のコンポーネントを編集するには、グループを開き、編集するコンポーネントの新しい色またはスタイル設定を選択します。

前景色および背景色の選択をサポートする属性の場合、2つのカラー選択の前にあるチェック・ボックスは、Webコンテンツ・アクセシビリティ・ガイドライン(WCAG) 2.0に基づくカラー・コントラスト情報を示します。計算されたコントラスト・スコアがより高いことは、そのカラーの組合せのアクセシビリティがより高いことを示します。

ヒント:

作業中のテーマ・スタイルをアプリケーションの現在のテーマ・スタイルとして設定するには、「現行として設定」をクリックします。

7. 作業中のテーマ・スタイルをアプリケーションの現在のテーマ・スタイルとして設定するには。

8. 「保存」をクリックして、サーバーに変更をコミットします。選択したテーマが読取り専用の場合は、「名前を付けて保存」をクリックして、変更を新しいテーマとして保存します。

11.1.5 テンプレート・オプションの理解

開発者はテンプレート・オプションを使用して、宣言的な方法でOracle Application Expressのページ上のコンポーネントに様々なスタイルを適用できます。

トピック:

- テンプレート・オプションについて

- デフォルト・テンプレート・オプションについて

- テンプレート・オプション・グループおよび事前設定について

関連項目:

テンプレート・オプションの使用およびライブ・テンプレート・オプションを変更するためのクイック編集の使用

11.1.5.1 テンプレート・オプションについて

テンプレート・オプションによって、開発者は、ページ、リージョン、レポート、リスト、ブレッドクラム、アイテムおよびボタンに関して選択したテンプレートにCSS修飾子を宣言的に適用できます。CSS修飾子は、CSSスタイルシートで定義されたCSSクラスの参照です。CSS修飾子によって、開発者は同じHTMLマークアップを使用しながら、CSSを適用することでそれを様々なスタイルで表示できます。ボタンの色、リージョンの幅、フォントの設定、アイテム・ラベルのマークアップなどで様々なスタイルを実現するために、ほぼ同一の多数のテンプレートをテーマで定義する必要性が、テンプレート・オプションによって減少します。

開発者は、次に示す例のような方法で、テンプレート・オプションを使用できます。

- 様々な色またはアクセントの適用

- 様々な間隔および余白の適用

- 様々なスタイルでのボタンのレンダリング(アイコンあり/なし)

- 様々な位置合せでのフォーム・フィールドの表示。

テンプレート・オプションを使用しない場合、これらのバリエーションを適用するには、ほぼ同一の非常に多くのテンプレート、またはCSSに関する詳細な知識が必要になります。テンプレート・オプションがサポートされるコンポーネントには、ページ、リージョン、クラシック・レポート、ブレッドクラム、リスト、アイテム、ラベル、ボタンがあります。

11.1.5.2 デフォルト・テンプレート・オプションについて

開発者は、テンプレート・オプション・グループに含まれていないテンプレート・オプションを、特定のテンプレートのデフォルトにすることを選択できます。アプリケーション・ビルダーでは、テンプレートを参照するコンポーネントをレンダリングすることによって、デフォルト・テンプレート・オプションを自動的に適用します。デフォルト・テンプレート・オプションは、実際のコンポーネントには書き込まれません。かわりに、#DEFAULT#置換文字列がコンポーネントに対して定義されるため、開発者はテンプレート・オプションのデフォルトを一元的に変更できます。

開発者は、テンプレート・オプションのデフォルトを使用しないことを選択でき、その場合は、#DEFAULT#置換文字列がコンポーネントから削除されます。テンプレート・オプションのデフォルトを無効にすると、開発者は使用可能なテンプレート・オプションをコンポーネントに選択的に適用できます。コンポーネントを編集するときに直接選択したすべてのテンプレート・オプションは、コンポーネントのメタデータに書き込まれ、対応するCSSクラス文字列によって表されます。実行時に、選択されたテンプレート・オプションとデフォルト・テンプレート・オプションはデフォルトの一部であり、コンポーネントのCSSクラス文字列と組み合されてコンポーネントに適用されます。

11.1.5.3 テンプレート・オプション・グループおよび事前設定について

開発者は、テンプレート・オプション・グループを作成することによって、関連するテンプレート・オプションの用途を定義できます。テンプレート・オプション・グループの例には、ボタン・サイズ、ボタン・スタイル、リストの例、リスト・スタイルおよびフォーム・ラベルの位置があります。開発者は、テンプレート・オプション・グループを作成するときに、テンプレート・レベルでテンプレート・オプションの事前設定を指定できます。たとえば、テンプレート・オプションLargeおよびSmallがあるボタン・テンプレートがあるとします。Smallを事前設定として定義した場合、このテンプレートを参照する新しいボタンには、作成時にテンプレート・オプションSmallが自動的に適用されます。グループに含まれているテンプレート・オプションは、事前設定がテンプレート・レベルで定義されていない場合はオプションです。

11.1.6 テーマ・ページへのアクセス

テーマ・ページでテーマを管理します。

ヒント:

テーマに選択したデフォルトのテンプレートを、テーマの作成/編集ページで変更できます。テーマの編集を参照してください。

「テーマ」ページにアクセスするには、次の手順を実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「ユーザー・インタフェース」で、「テーマ」を選択します。

テーマ・ページが表示されます。

5. 「レポートの表示」アイコンをクリックします。

テーマ・ページがレポートとして表示されます。「カレント」列のチェック・マークはどのテーマが選択されているかを示します。

6. テーマ名をクリックします。

テーマの編集ページが表示されます。

11.1.7 テーマの編集

この項では、テーマ属性の編集方法について説明します。

トピック:

- テーマの編集

- テーマ属性

関連項目:

カスタム・テーマの作成

11.1.7.1 テーマの編集

テーマを確認または編集するには、次の手順を実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「ユーザー・インタフェース」で、「テーマ」を選択します。

テーマ・ページが表示されます。

5. テーマ・ページで、「レポートの表示」アイコンをクリックします。
テーマ・ページがレポートとして表示されます。「カレント」列のチェック・マークはどのテーマが選択されているかを示します。

6. テーマ名をクリックします。

テーマの作成/編集ページが表示され、このページはいくつかのセクションに分かれています。

7. 「テーマ属性」の説明に従って、適切な属性を編集します。

8. 変更を保存するには、「変更の適用」をクリックします。

11.1.7.2 テーマ属性

この項では、テーマ属性の作成/編集ページ上の属性について説明します。属性の詳細および例を確認するには、フィールドレベル・ヘルプを参照してください。

トピック:

- 名前

- テーマのサブスクリプション

- JavaScriptおよびカスケード・スタイルシート

- コンポーネントのデフォルト値

- リージョンのデフォルト値

- ダイアログのデフォルト

- 遷移のデフォルト値

- グローバル・テンプレート・オプション

- アイコン

- イメージ

- スタイル

- ファイル

11.1.7.2.1 名前

表11-1に、「名前」の属性を示します。

表11-1 名前

属性

説明

アプリケーション

カレント・アプリケーションIDを指定します。

関連項目: アプリケーション属性の編集

テーマ番号

テーマの番号を指定します。テーマは、アプリケーションのユーザー・インタフェースを定義するテンプレートのコレクションです。

名前

テーマの説明的な短い名前を入力します。

ユーザー・インタフェース

テーマの設計対象のユーザー・インタフェースを指定します。

関連項目: ユーザー・インタフェースの詳細ページ

ナビゲーション・タイプ

選択するナビゲーション・タイプを指定します。有効なオプションは、「タブ」または「リスト」です。

関連項目: タブの作成およびリストの作成

ナビゲーション・バー実装

選択するナビゲーション・バー実装を指定します。有効なオプションは、「クラシック」または「リスト」です。

関連項目: ユーザー・インタフェースの詳細ページ

説明

テーマの説明を入力します。

11.1.7.2.2 テーマのサブスクリプション

このアプリケーションがサブスクライブするテーマを表示します。アプリケーションがテーマにサブスクライブすると、すべてのテーマ属性、サブスクライブされたテンプレート・オプションおよびサブスクライブされたテンプレートは読取り専用に設定されます。

関連項目:

テーマのサブスクリプションの理解

11.1.7.2.3 JavaScriptおよびカスケード・スタイルシート

表11-2に、「JavaScriptおよびカスケード・スタイルシート」の属性を示します。

表11-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#置換文字列が置き換えられます。

例を表示するには、フィールドレベル・ヘルプを参照してください。

11.1.7.2.4 コンポーネントのデフォルト値

表11-3に、デフォルトのテンプレートをコンポーネント・タイプ別に示します。

表 11-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クラスと組み合されます。

必須ラベル

新しいラベルを作成する場合に使用するデフォルトの必須ラベル・テンプレートを指定します。

リスト

リストを作成する場合に使用するデフォルトのリスト・テンプレートを指定します。

リージョン

リージョンを作成する場合に使用するデフォルトのリージョン・テンプレートを指定します。

クラシック・レポート

レポートを作成する場合に使用するデフォルトのリージョン・テンプレートを指定します。

ヘッダー・ツールバー

ヘッダーまたはフッター・ツールバーを含む新しいページを作成する場合に使用する、デフォルトのヘッダー・ツールバー・リージョン・テンプレートを指定します。

フッター・ツールバー

ヘッダーまたはフッター・ツールバーを含む新しいページを作成する場合に使用する、デフォルトのヘッダー・ツールバー・リージョン・テンプレートを指定します。

11.1.7.2.5 リージョンのデフォルト値

表11-4に、「リージョンのデフォルト値」で使用可能なデフォルトのテンプレートを示します。

表11-4 リージョンのデフォルト値

属性

説明

ブレッドクラム

ブレッドクラムを作成する場合に使用するデフォルトのブレッドクラム・テンプレートを指定します。

チャート

チャートを作成する場合に使用するデフォルトのチャート・テンプレートを指定します。

フォーム

フォームを作成する場合に使用するデフォルトのフォーム・テンプレートを指定します。

リスト

リストを作成する場合に使用するデフォルトのリージョン・テンプレートを指定します。

レポート

レポートを作成する場合に使用するデフォルトのリージョン・テンプレートを指定します。

表形式フォーム

表形式フォームを作成する場合に使用するデフォルトのリージョン・テンプレートを指定します。

ウィザード

新しいウィザード・コンポーネントを作成する場合に使用するデフォルトのリージョン・テンプレートを指定します。

対話モード・レポート

対話モード・レポートを作成する場合に使用するデフォルトのリージョン・テンプレートを指定します

11.1.7.2.6 ダイアログのデフォルト

表11-5に、「ダイアログのデフォルト」で使用可能なデフォルトのテンプレートを示します。

表11-5 ダイアログのデフォルト

属性

説明

ダイアログ・コンテンツ・リージョン

ページの作成ウィザードおよびアプリケーションの作成ウィザードを使用してダイアログのコンテンツ・リージョンを作成する場合に使用する、デフォルトのリージョン・テンプレートを指定します。

ダイアログ・ボタン・リージョン

ページの作成ウィザードおよびアプリケーションの作成ウィザードを使用してダイアログのボタン・リージョンを作成する場合に使用する、デフォルトのリージョン・テンプレートを指定します。

ダイアログ・ページ

モーダルまたは非モーダル・ダイアログ・ページを表示するためのデフォルトのテンプレートを指定します。開発者が明示的にテンプレートを選択しない場合、Application Expressエンジンは、ここで指定されたテンプレートを使用します。このテンプレートは、インライン表示されるエラーではなく、個別のページに表示されるエラーにも使用されます。

11.1.7.2.7 遷移のデフォルト値

「遷移のデフォルト値」は、モバイル・テーマについてのみ表示されます。表11-6に、「遷移のデフォルト値」で使用可能な属性を示します。

表11-6 遷移のデフォルト値

属性

説明

ページ遷移

新しいページにナビゲートするとき、またはページを送信したときに使用する遷移を指定します。

ポップアップ遷移

ポップアップが開かれたときに使用する遷移を指定します。

11.1.7.2.8 グローバル・テンプレート・オプション

グローバル・テンプレート・オプションは、テーマレベルで定義され、特定のタイプのすべてのコンポーネントで使用できます。

関連項目:

テンプレート・オプションの理解およびグローバル・テンプレート・オプションの管理

11.1.7.2.9 アイコン

表11-7に、「アイコン」の属性を示します。

表11-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"

11.1.7.2.10 イメージ

「カスタム・イメージ」属性を使用して、このテーマがデフォルトのテーマ・イメージを使用するかアップロードされたテーマ・イメージを使用するかを指定します。「はい」または「いいえ」を選択します。

11.1.7.2.11 スタイル

現在のテーマで使用できるテーマ・スタイルを表示します。テーマ・スタイルによって、アプリケーションのテーマのCSSが定義され、アプリケーションのユーザー・インタフェースが制御されます。テーマ・スタイルは、ページ・テンプレート内で#THEME_STYLE_CSS#置換文字列を使用して参照されます。現在使用されているテーマ・スタイルには、「カレント」の下にチェック・マークが表示されます。

関連項目:

テーマ・スタイルの使用

11.1.7.2.12 ファイル

「ファイルの接頭辞」属性には、Webサーバーがテーマのファイルを指すために使用する仮想パスが表示されます。データベースのテーマ定義とともに格納されたファイルを参照するものを指定しないでください。パフォーマンスの点から、テーマ・ファイルをWebサーバーに格納することもできます。「スタイル」で参照するには、#IMAGE_PREFIX#または任意の有効なURLを使用します。

関連項目:

静的アプリケーション・ファイルの管理および静的ワークスペース・ファイルの管理

11.2 テーマおよびサブスクリプションの管理

開発者は、テーマを直接またはテーマのサブスクリプションを使用して管理できます。

アプリケーションがマスター・テーマをサブスクライブする際、変更できるのはデフォルト・テンプレートのみです。すべてのテーマ属性、サブスクライブされたテンプレート・オプションおよびサブスクライブされたテンプレートは読取り専用に設定されます。さらに、開発者はテーマまたはテンプレート・メタデータにテーマまたはテンプレート編集ページからアクセスするときに、それらを変更できません。テーマのサブスクリプションのもう1つの利点は、将来のOracle Application Expressのリリース時にマスター・テーマをアップグレードできることです。

トピック:

- テーマのサブスクリプションの理解

- テーマの作成

- テーマの切替え

- テーマ識別番号の変更

- テーマのコピー

- テーマの削除

- マスター・テーマ・アプリケーションの作成

- ワークスペース・テーマの管理

- インスタンス・テーマの管理

- テーマのエクスポートおよびインポートについて

- テーマ・レポートの表示

11.2.1 テーマのサブスクリプションの理解

この項では、テーマのサブスクリプションについて説明します。

トピック:

- テーマのサブスクリプションについて

- テーマのサブスクリプションの変更について

- テーマのリフレッシュが必要かどうかの検証

- サブスクライブされたテーマのリフレッシュ

- テーマのサブスクライブ解除

- 組込みテーマの再サブスクライブ

11.2.1.1 テーマのサブスクリプションについて

開発者は、次の場合にテーマをサブスクライブします。

- アプリケーションの作成ウィザードを実行するとき。
開発者が、アプリケーションの作成ウィザードを実行するときに組込みテーマを選択すると、そのテーマが自動的にマスター・テーマにサブスクライブされます。組込みテーマを使用するかわりとして、アプリケーションの作成ウィザードには既存のアプリケーションからテーマをコピーするオプションが用意されています。既存のアプリケーションからテーマをコピーするとき、開発者は、そのテーマがサブスクライブされるようにするかどうかを選択できます。アプリケーションの作成ウィザードの使用を参照してください。

- テーマ・リポジトリから新しいテーマを作成するとき。新しいテーマを作成すると、関連するアプリケーションによって自動的にそのテーマがサブスクライブされます。テーマの作成を参照してください。

アプリケーションがマスター・テーマをサブスクライブすると、すべてのテーマ属性、サブスクライブされたテンプレート・オプションおよびサブスクライブされたテンプレートが読取り専用に設定されます。つまり、変更できるのはデフォルト・テンプレートのみだということです。マスター・テーマをサブスクライブすることの利点は、将来のOracle Application Expressのリリース時にテーマをアップグレードできることです。テーマがサブスクライブされた場合、開発者はテーマまたはテンプレート・メタデータにテーマまたはテンプレート編集ページからアクセスするときに、それらを変更できません。

11.2.1.2 テーマのサブスクリプションの変更について

マスター・テーマのサブスクリプションを解除しないでテンプレートを変更するために、開発者は自分のワークスペースにテンプレートのローカル・コピーを作成できます。ローカル・テンプレート・コピーはサブスクライブされないため、編集可能です。テーマ・スタイルについても同じ方法を利用できます。テーマ・スタイルのローカル・コピーを作成して、それをサブスクライブされたテーマに追加できます。ローカルで作成されたテーマ・スタイルは編集可能ですが、テーマのリフレッシュからは除外されます。

関連項目:

テーマのコピー

11.2.1.3 テーマのリフレッシュが必要かどうかの検証

テーマのサブスクリプションの検証ウィザードは、サブスクライブするテーマのすべてのテーマ属性、テンプレートおよびテンプレート・オプションを確認し、マスター・テーマと同期が取れていない対象にはエラーを表示します。また、マスター・テーマに定義されているが、サブスクライブするテーマにまだパブリッシュされていないテンプレートをハイライトします。

テーマのサブスクリプションの検証ウィザードを実行するには、次のステップを実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「ユーザー・インタフェース」で、「テーマ」を選択します。

テーマ・ページが表示されます。

5. テーマ・ページで、「レポートの表示」アイコンをクリックします。
テーマ・ページがレポートとして表示されます。「カレント」列のチェック・マークはどのテーマが選択されているかを示します。

6. テーマを選択します。

テーマの作成/編集ページが表示されます。

7. テーマのサブスクリプションを見つけ、「確認」をクリックします。

8. 画面に表示されるステップに従います。

マスター・テーマからサブスクライブするテーマに変更をパブリッシュするには、ウィザードの最後で「リフレッシュ」をクリックします。

11.2.1.4 サブスクライブされたテーマのリフレッシュ

サブスクライブされたテーマをリフレッシュするには、次のステップを実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「ユーザー・インタフェース」で、「テーマ」を選択します。

テーマ・ページが表示されます。

5. テーマ・ページで、「レポートの表示」アイコンをクリックします。
テーマ・ページがレポートとして表示されます。「カレント」列のチェック・マークはどのテーマが選択されているかを示します。

6. テーマを選択します。

テーマの作成/編集ページが表示されます。

7. テーマのサブスクリプションを見つけ、「テーマのリフレッシュ」をクリックします。

ヒント:

テーマがサブスクライブされていない場合、「テーマのリフレッシュ」ボタンは表示されません。「組込みテーマの再サブスクライブ」を参照してください。

8. 「変更の適用」をクリックします。

11.2.1.5 テーマのサブスクライブ解除

注意:

テーマをサブスクライブ解除すると、それ以降テーマが更新されなくなります。テーマの再サブスクライブは、テーマのコピーや切替えを含む複数ステップのプロセスであることに注意してください。詳細は、「組込みテーマの再サブスクライブ」を参照してください。

テーマをサブスクライブ解除すると、そのテーマに含まれるすべてのテンプレート、スタイル、ファイルなどもサブスクライブ解除されます。

テーマをサブスクライブ解除するには、次のステップを実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「ユーザー・インタフェース」で、「テーマ」を選択します。

テーマ・ページが表示されます。

5. テーマ・ページで、「レポートの表示」アイコンをクリックします。
テーマ・ページがレポートとして表示されます。「カレント」列のチェック・マークはどのテーマが選択されているかを示します。

6. テーマを選択します。

テーマの作成/編集ページが表示されます。

7. テーマのサブスクリプションを見つけ、「サブスクライブ解除」をクリックします。

警告ダイアログが表示されます。

8. 「テーマのサブスクライブ解除」をクリックします。

11.2.1.6 組込みテーマの再サブスクライブ

テーマが現在サブスクライブ解除されている場合、このテーマのサブスクライブ・バージョンに戻ることができます。

テーマを再サブスクライブするには、次のステップを実行します。

1. テーマ・ページにナビゲートします。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. 「共有コンポーネント」をクリックします。

d. 「ユーザー・インタフェース」で、「テーマ」を選択します。

テーマ・ページが表示されます。

2. 「タスク」リストから「指定番号の変更」を選択し、テーマを新しい識別番号に変更します。テーマ識別番号の変更を参照してください。

3. テーマの作成ウィザードを実行し、再度テーマを作成します。テーマの作成を参照してください。

4. 新しいテーマを使用するように、カレント・アプリケーションを切り替えます。テーマの切替えを参照してください。

5. 新しい識別番号を作成した元のテーマを削除します。テーマの削除を参照してください。

11.2.2 テーマの作成

現在アプリケーションに関連付けられているテーマのみがテーマ・ページに表示されます。他のテーマにアクセスするには、テーマの作成ウィザードを実行する必要があります。テーマを作成すると、テーマ・ページでそのテーマにアクセスできるようになります。新しく作成するか、またはリポジトリから既存のテーマを選択することによって、テーマを作成できます。

ヒント:

新しいテーマを作成すると、関連するアプリケーションによって自動的にそのテーマがサブスクライブされます。テーマおよびサブスクリプションの管理を参照してください。

テーマを作成するには、次のステップを実行します。

1. テーマ・ページにナビゲートします。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. 「共有コンポーネント」をクリックします。

d. 「ユーザー・インタフェース」で、「テーマ」を選択します。

テーマ・ページが表示されます。

2. 「作成」をクリックします。

3. 次のいずれかの作成方法を選択します。

- リポジトリから: リポジトリからテーマを表示および選択します。

- 別のアプリケーションからのコピー: アプリケーションを選択してからテーマを選択します。

- 最初から: テーマを最初から作成します。

- エクスポートから: エクスポート・リポジトリからインポートするテーマを作成します。

4. 画面に表示されるステップに従います。

属性の詳細は、フィールドレベル・ヘルプを参照してください。

関連項目:

テーマの編集

11.2.3 テーマの切替え

この項では、アプリケーションのアクティブなテーマを変更する方法について説明します。

トピック:

- アクティブなテーマの切替えについて

- ユニバーサル・テーマへの切替えについて

- アクティブなテーマの切替え

11.2.3.1 アクティブなテーマの切替えについて

テーマに切り替えると、テンプレートに割り当てられたすべてのコンポーネントは、テーマの対応するテンプレートに割り当てられます。アプリケーション・ビルダーは、テンプレート・クラス識別子の割当てによってテンプレート・マッピングを行います。

アクティブなテーマの切替えでは、次の点に注意してください。

- テーマが存在する場合にのみ、そのテーマに切り替えることができます。たとえば、リポジトリで使用可能なテーマに切り替える前に、最初にテーマを作成する必要があります。テーマの作成を参照してください。

- ウィザードによって複数の一致が検出された場合(つまり、複数のテンプレートが同じテンプレート・タイプおよびテンプレート・クラスを共有する場合)、ウィザードのデフォルトで、タイプ、クラスおよび名前が一致するテンプレートになります。一致するものが検出されなかった場合、同じタイプおよびクラスの別のテンプレートを選択する必要があります。

- 一致するテンプレートが見つからなかった場合(つまり、同じタイプおよびクラスのテンプレートが存在しない場合)、同じタイプでクラスが異なるテンプレートを選択するよう求められます。次に、この問題がページ機能の問題またはページの表示の問題の原因になる場合があることを説明する警告が表示されます。同じテンプレート・タイプのテンプレートが存在しない場合、テーマを切り替えることはできません。テーマの切替えがブロックされます。

11.2.3.2 ユニバーサル・テーマへの切替えについて

Oracle Application Expressの以前のリリースで提供されていたテーマと比べて、ユニバーサル・テーマにはいくつかの新機能が追加され、改善および最適化が行われています。さらに、ユニバーサル・テーマではOracle Application Expressリリース5の主要なUI機能のいくつかを利用し、アプリケーションのUIをカスタマイズする機能を大幅に拡張する新しいテンプレートおよびテンプレート・オプションが複数提供されています。ユニバーサル・テーマの利点の詳細およびユニバーサル・テーマへの切替え方法は、『移行ガイド - ユニバーサル・テーマへの移行』を参照してください。

https://apex.oracle.com/ut

11.2.3.3 アクティブなテーマの切替え

アクティブなテーマを切り替えるには、次の手順を実行します。

1. テーマ・ページにナビゲートします。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. 「共有コンポーネント」をクリックします。

d. 「ユーザー・インタフェース」で、「テーマ」を選択します。

テーマ・ページが表示されます。

ヒント:

インストール済のテーマが2つ以上存在しない場合は、「テーマの作成」をクリックします。テーマを最初から作成するか、単にリポジトリから既存のテーマを選択できます。テーマの作成を参照してください。

2. 「テーマの切替え」をクリックします。
テーマの切替えページが表示されます。

3. 「テーマの指定」で、次のステップを実行します。

a. 現在アクティブなテーマ: アプリケーションの現在のテーマを選択します。

b. 次のテーマに切替え: アプリケーションに新しいテーマを選択します。

c. グリッドのリセット: グリッドをリセットするかどうかを選択します。グリッド設定は、ページ上でのリージョンおよびアイテムの配置を定義します。詳細は、フィールドレベル・ヘルプを参照してください。

d. テンプレート・クラスの照合: 「はい」または「いいえ」を選択します。新しいテーマに切り替えると、アプリケーション・ビルダーによって、現在使用されているすべてのテンプレートが、テンプレート・クラスを使用している新しいテーマ内のテンプレートにマップされます。「テンプレート・クラスの照合」が「いいえ」に設定されている場合、テンプレートをテンプレート・クラスには関係なく、同じタイプのテンプレートに切り替えることができます。

e. 「次へ」をクリックします。

互換性の確認ページが表示されます。

4. 「ステータス」列を確認し、マッピング上の問題を特定します。

- チェック: マッピングが成功したことを示します。

- 警告: 切替え先のテーマに、指定されたクラスを持つ複数のテンプレートがあることを示します。この警告では、適切なテンプレートを選択するための選択リストが提供されます。

- エラー: アプリケーション・ビルダーがテーマ間でクラスをマップできなかったことを示します。クラスが両方のテーマのテンプレートで指定されていることを確認します。

注意:

この警告の解決に失敗すると、機能が消失したり、アプリケーションが正常に表示されなくなる場合があります。

5. 「次へ」をクリックして、続行します。

6. 「テーマの切替え」をクリックします。

11.2.4 テーマ識別番号の変更

すべてのテーマには、識別番号(ID)があります。テーマIDの変更ユーティリティを使用して、テーマIDを別の識別番号に変更できます。テーマIDの変更は、テーマに異なる番号を付けてエクスポートし、別のアプリケーションにインポートする場合に便利です。

テーマ識別番号を変更するには、次のステップを実行します。

1. テーマ・ページにナビゲートします。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. 「共有コンポーネント」をクリックします。

d. 「ユーザー・インタフェース」で、「テーマ」を選択します。

テーマ・ページが表示されます。

2. 「タスク」リストで、「指定番号の変更」をクリックします。

3. 「テーマ番号」で、次のステップを実行します。

a. テーマの指定: テーマを選択します。

b. 新しいテーマ指定番号: 識別番号を指定します。

c. 「次へ」をクリックします。

4. 変更内容を確認して、「テーマIDの変更」をクリックします。

11.2.5 テーマのコピー

すべてのテーマは、数値による識別番号(ID)で識別されます。テーマをコピーする場合は、テーマIDを指定します。テーマのコピーは、テーマの編集を試行したり、テーマに異なるIDを付けてエクスポートする場合に便利です。

テーマをコピーするには、次のステップを実行します。

1. テーマ・ページにナビゲートします。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. 「共有コンポーネント」をクリックします。

d. 「ユーザー・インタフェース」で、「テーマ」を選択します。

テーマ・ページが表示されます。

2. 「タスク」リストで、「テーマのコピー」をクリックします。

3. 「テーマ番号」で、次のステップを実行します。

a. アプリケーション - カレント・アプリケーションIDを指定します。

b. 次のテーマからコピー: コピーするテーマを選択します。

c. このテーマIDにコピー - テーマの新しいIDを入力します。

d. テーマのサブスクライブ - 「はい」または「いいえ」を選択します。

e. 「次へ」をクリックします。

4. 変更内容を確認して、「テーマのコピー」をクリックします。

関連項目:

テーマのサブスクリプションの理解

11.2.6 テーマの削除

アクティブではないテーマのみ削除できます。テーマを削除すると、アプリケーション・ビルダーによって、アクティブではないテンプレートのみ削除されます。

ヒント:

テーマはアプリケーションに関連付けられています。テーマを変更した場合、その変更は編集中のアプリケーションにのみ適用されます。テーマを削除した場合、テンプレートの変更はすべて失われます。テンプレートの変更を維持するには、テーマをエクスポートする必要があります。テーマのエクスポートを参照してください。

テーマを削除するには、次のステップを実行します。

1. テーマ・ページにナビゲートします。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. 「共有コンポーネント」をクリックします。

d. 「ユーザー・インタフェース」で、「テーマ」を選択します。

テーマ・ページが表示されます。

2. 「タスク」リストで、「テーマの削除」をクリックします。

3. 「テーマの削除」で、削除するテーマを選択し、「次へ」をクリックします。

4. 「テーマの削除」をクリックします。

11.2.7 マスター・テーマ・アプリケーションの作成

開発者はマスター・テーマ・アプリケーションを作成できます。ベスト・プラクティスとして、ユニバーサル・テーマ- 42を使用する既存のパッケージ・アプリケーション(たとえば、サンプル・データベース・アプリケーション)から始めることをお薦めします。

トピック:

- 新規アプリケーションの作成によるマスター・テーマ・アプリケーションの作成

- 既存のアプリケーションからのマスター・テーマ・アプリケーションの作成

11.2.7.1 新規アプリケーションの作成によるマスター・テーマ・アプリケーションの作成

新規アプリケーションを作成してマスター・テーマ・アプリケーションを作成するには、次のステップを実行します。

1. アプリケーションの作成ウィザードを実行して、新規アプリケーションを作成します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. 「作成」ボタンをクリックします。

2. 「既存アプリケーションのコピー」を選択し、ユニバーサル・テーマ- 42を使用するアプリケーション(たとえば、サンプル・データベース・アプリケーション)を選択します。

3. 画面に表示されるステップに従います。

11.2.7.2 既存のアプリケーションからのマスター・テーマ・アプリケーションの作成

既存のアプリケーションからマスター・テーマ・アプリケーションを作成するには、次のステップを実行します。

1. ユニバーサル・テーマ- 42を使用するアプリケーション(たとえば、サンプル・データベース・アプリケーション)からテーマをコピーし、そのテーマをサブスクライブします。テーマのコピーを参照してください。

2. 新しいテーマに切り替えます。テーマの切替えを参照してください。

3. 画面に表示されるステップに従います。

11.2.8 ワークスペース・テーマの管理

ワークスペース管理者は、ワークスペースのテーマ・リポジトリを管理します。ワークスペース管理者は、リポジトリにテーマを追加してワークスペース内のすべての開発者がそのテーマを使用できるようにしたり、テーマを削除することができます。

トピック:

- テーマ・リポジトリへのワークスペース・テーマの追加

- 既存のワークスペース・テーマの表示

- ワークスペーステーマの削除

- ワークスペーステーマの変更

- ワークスペース・テーマのエクスポート

関連項目:

『Oracle Application Express管理ガイド』のパブリック・テーマの管理に関する項

11.2.8.1 テーマ・リポジトリへのワークスペース・テーマの追加

テーマをテーマ・リポジトリに追加するには、次のステップを実行します。

1. テーマ・ページにナビゲートします。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. 「共有コンポーネント」をクリックします。

d. 「ユーザー・インタフェース」で、「テーマ」を選択します。

テーマ・ページが表示されます。

2. 「タスク」リストで、「ワークスペース・テーマの管理」をクリックします。

3. 「ワークスペース・テーマの作成」を選択し、「次へ」をクリックします。

ヒント:

ワークスペース・テーマが存在しない場合、ウィザードによって「作成」が選択されます。

4. 「ワークスペース・テーマの作成」で、次のステップを実行します。

a. アプリケーション - アプリケーションを選択します。

b. コピーするアプリケーション・テーマ: ワークスペース・テーマ・リポジトリにコピーするテーマを選択します。

c. テーマのサブスクライブ - ワークスペース・テーマを選択したアプリケーション・テーマにサブスクライブするかどうかを選択します。このオプションにより、ワークスペース・テーマを、選択したアプリケーション・テーマに加えた変更を反映させてリフレッシュできます。

d. 「次へ」をクリックします。

a. テーマ番号 - 100より大きい値を持つ番号を入力します。この番号は、ワークスペース内でこのテーマを一意に識別します。

b. テーマ名 - テーマ名を入力します。この名前は、アプリケーション・テーマ名と同じでも違っていてもかまいません。

c. 説明 - テーマの説明を入力します。

d. 「次へ」をクリックします。

6. 「ワークスペーステーマの作成」をクリックします。

11.2.8.2 既存のワークスペース・テーマの表示

既存のワークスペース・テーマを表示するには、次の手順を実行します。

1. テーマ・ページにナビゲートします。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. 「共有コンポーネント」をクリックします。

d. 「ユーザー・インタフェース」で、「テーマ」を選択します。

テーマ・ページが表示されます。

2. 「タスク」リストから「ワークスペーステーマの管理」をクリックします。

「ワークスペース・テーマ」ページが表示されます。

ヒント:

ワークスペーステーマを直接編集することはできません。ワークスペース・テーマを変更するには、そのテーマを使用してアプリケーションを作成し、変更し、ワークスペース・テーマ・リポジトリに手動で追加する必要があります。ワークスペース・テーマの変更を参照してください。

11.2.8.3 ワークスペース・テーマの削除

ワークスペーステーマを削除するには、次のステップを実行します。

1. テーマ・ページにナビゲートします。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. 「共有コンポーネント」をクリックします。

d. 「ユーザー・インタフェース」で、「テーマ」を選択します。

テーマ・ページが表示されます。

2. 「タスク」リストから「ワークスペーステーマの管理」をクリックします。

「ワークスペース・テーマ」ページが表示されます。

3. テーマ名を選択します。

4. 「削除」をクリックします。

5. 削除のリクエストを確認し、「OK」をクリックします。

11.2.8.4 ワークスペーステーマの変更

ワークスペーステーマを直接編集することはできません。ワークスペース・テーマを変更するには、そのテーマを使用してアプリケーションを作成し、変更し、ワークスペース・テーマ・リポジトリに手動で追加する必要があります。

ワークスペーステーマを変更するには、次のステップを実行します。

1. 変更するテーマを使用して、アプリケーションを作成します。「データベース・アプリケーションの作成」を参照してください。

2. テーマを変更します。テーマの編集を参照してください。

3. 既存のワークスペーステーマを削除します。ワークスペース・テーマの削除を参照してください。

4. 変更したテーマをワークスペーステーマ・リポジトリに追加します。テーマ・リポジトリへのワークスペース・テーマの追加を参照してください。

11.2.8.5 ワークスペース・テーマのエクスポート

テーマのエクスポートは、関連するアプリケーション・ファイルのエクスポートと同様の方法で行います。ワークスペーステーマをエクスポートするには、次のステップを実行します。

1. テーマを使用して、アプリケーションを作成します。「データベース・アプリケーションの作成」を参照してください。

2. アプリケーションをエクスポートします。アプリケーションのエクスポートを参照してください。

3. エクスポートされたファイルをターゲットのOracle Application Expressインスタンスにインポートします。アプリケーション、ページまたはコンポーネントのエクスポートのインポートを参照してください。

4. エクスポートされたファイルをエクスポート・リポジトリからインストールします。エクスポート・ファイルのインストールを参照してください。

11.2.9 インスタンス・テーマの管理

Oracle Application Expressインスタンス全体のテーマ・リポジトリは、インスタンス管理者が管理します。リポジトリに対してテーマを追加または削除できるのは、インスタンス管理者のみです。

関連項目:

『Oracle Application Express管理ガイド』のパブリック・テーマの管理に関する項

11.2.10 テーマのエクスポートおよびインポートについて

テーマのエクスポートは、関連するアプリケーション・ファイルのエクスポートと同様の方法で行います。1つの開発インスタンスから別のインスタンスへテーマをエクスポートするには、次のステップを実行します。

1. テーマを使用して、アプリケーションを作成します。「データベース・アプリケーションの作成」を参照してください。

2. テーマをエクスポートします。テーマのエクスポートを参照してください。

3. エクスポートされたファイルをターゲットのOracle Application Expressインスタンスにインポートします。エクスポート・ファイルのインポートを参照してください。

4. エクスポートされたファイルをエクスポート・リポジトリからインストールします。エクスポート・ファイルのインストールを参照してください。

11.2.11 テーマ・レポートの表示

この項では、テーマおよびテンプレートの管理に役立ついくつかのレポートについて説明します。

- テーマのすべてのテンプレートの表示

- テーマ・テンプレート数の表示

- ファイル参照の表示

- クラス参照の表示

- テンプレートの置換文字列の表示

トピック:

- テーマのすべてのテンプレートの表示

- テーマ・テンプレート数の表示

- ファイル参照の表示

- クラス参照の表示

- テンプレートの置換文字列の表示

11.2.11.1 テーマのすべてのテンプレートの表示

テーマを構成しているすべてのテンプレートを表示するには、次のステップを実行します。

1. テーマ・ページにナビゲートします。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. 「共有コンポーネント」をクリックします。

d. 「ユーザー・インタフェース」で、「テーマ」を選択します。

テーマ・ページが表示されます。

2. 「レポート」をクリックします。

3. テーマ・レポート・ページで、次のステップを実行します。

a. レポート - 「アプリケーション・テンプレート」を選択します。

b. テーマ - テーマを選択するか、「すべて」を選択します。

c. 「実行」をクリックします。

テンプレートのリストには、テンプレート・タイプ、テンプレート名、対応するテーマおよびテンプレート・クラスの一覧が表示されます。

4. テンプレートを編集するには、テンプレート名を選択します。

11.2.11.2 テーマ・テンプレート数の表示

「テーマ・テンプレート数」レポートには、現在、テンプレート・クラス用に作成されたテンプレートがあるテンプレート・クラスが表示されます。

テーマ・テンプレート数レポートを表示するには、次のステップを実行します。

1. テーマ・ページにナビゲートします。テーマ・ページへのアクセスを参照してください。

2. 「レポート」をクリックします。

3. テーマ・レポート・ページで、次のステップを実行します。

a. レポート - 「テーマ・テンプレート数」を選択します。

b. テーマ - テーマを選択するか、「すべてのテーマ」を選択します。

c. 「実行」をクリックします。

4. カスタムの分類を使用する場合は、「カスタムの表示」を選択し、「実行」をクリックします。

11.2.11.3 ファイル参照の表示

ファイル参照のレポートには、テンプレートに関連付けられたすべてのファイル、共有コンポーネント、カレント・アプリケーションのページ・コンポーネントの一覧が表示されます。

「ファイル参照」のレポートを表示するには、次のステップを実行します。

1. テーマ・ページにナビゲートします。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. 「共有コンポーネント」をクリックします。

d. 「ユーザー・インタフェース」で、「テーマ」を選択します。

テーマ・ページが表示されます。

2. 「レポート」をクリックします。

3. テーマ・レポート・ページで、次のステップを実行します。

a. レポート - 「ファイル参照」を選択します。

b. テーマ - テーマを選択するか、「すべて」を選択します。

c. 「実行」をクリックします。

4. 「ファイル参照」ページで、次のステップを実行します。

a. 表示 - レポートに含めるコンポーネントのタイプを選択します。選択しない場合は、結果が戻されません。

b. ファイルの表示 - 次のいずれかを選択します。

- コンテキスト付き: コンポーネント、テーマ識別番号、コンポーネント名、イメージ(使用可能な場合)、およびページ番号を表示します。ページ番号を選択します。

- コンテキストなし: ファイル名およびイメージ(使用可能な場合)のみ表示します。

c. ファイル拡張子 - 検索する拡張子のタイプを選択します。

d. 「実行」をクリックします。

5. このレポートのカンマ区切りファイル(.csv)をダウンロードするには、ページ下部の「ダウンロード」をクリックします。

11.2.11.4 クラス参照の表示

クラス参照のレポートにアクセスすると、テンプレートに関連付けられたクラス、共有コンポーネント、カレント・アプリケーションのページ・コンポーネントの一覧が表示されます。

クラス参照のレポートを表示するには、次のステップを実行します。

1. テーマ・ページにナビゲートします。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. 「共有コンポーネント」をクリックします。

d. 「ユーザー・インタフェース」で、「テーマ」を選択します。

テーマ・ページが表示されます。

2. 「レポート」をクリックします。

3. テーマ・レポート・ページで、次のステップを実行します。

a. レポート - 「クラス参照」を選択します。

b. テーマ - テーマを選択するか、「すべて」を選択します。

c. 「実行」をクリックします。

4. 「クラス参照」ページで、次のステップを実行します。

a. 表示 - クラス参照を確認するコンポーネントを選択します。選択しない場合は、結果が戻されません。

b. クラス名の表示 - 次のいずれかを選択します。

- コンテキスト付き: コンポーネント、テーマ識別番号、コンポーネント名、イメージ(使用可能な場合)、およびページ番号を表示します。

- コンテキストなし: 参照されるクラスのみを表示します。

c. 「実行」をクリックします。

5. このレポートのカンマ区切りファイル(.csv)をダウンロードするには、ページ下部の「ダウンロード」をクリックします。

11.2.11.5 テンプレート置換文字列の表示

「テンプレート置換文字列」レポートを使用すると、コンポーネントがサポートする置換文字列がすべて表示されます。

「置換文字列」レポートを表示するには、次のステップを実行します。

1. テーマ・ページにナビゲートします。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. 「共有コンポーネント」をクリックします。

d. 「ユーザー・インタフェース」で、「テーマ」を選択します。

テーマ・ページが表示されます。

2. 「レポート」をクリックします。

3. テーマ・レポート・ページで、次のステップを実行します。

a. レポート - 「テンプレート置換文字列」を選択します。

b. テーマ - レポートに含めるテーマを選択します。

c. 「実行」をクリックします。

4. テンプレート定義にリンクするには、コンポーネント名を選択します。

関連項目:

置換文字列の理解

11.3 カスタム・テーマの作成

Application Expressエンジンは、テーマと呼ばれるテンプレートのコレクションに基づいて、アプリケーションのユーザー・インタフェースを作成します。テンプレートは、アプリケーション内のコンポーネントのルック・アンド・フィールを制御します。カスタム・テンプレートを作成するには、まず既存のテンプレートを変更する方法が最も簡単です。作成した1つ以上のデフォルト・テンプレートは、必要に応じて変更できます。

トピック:

- カスケード・スタイルシートについて

- ページ・テンプレートからのJavaScriptファイルのコールについて

- 置換文字列でのエスケープ構文の使用について

- デフォルトのページ・テンプレートの選択

- 新しいテンプレートの作成

- テンプレート・オプションの使用

- テンプレート・レポートの表示

- テンプレートの管理

- ブレッドクラム・テンプレート

- ボタン・テンプレート

- レガシー・カレンダ・テンプレート

- ラベル・テンプレート

- リスト・テンプレート

- ページ・テンプレート

- ポップアップLOVテンプレート

- リージョン・テンプレート

- レポート・テンプレート

関連項目:

テーマの使用およびテーマおよびサブスクリプションの管理

11.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のバージョン番号が含まれており、以前のバージョンのテーマを使用しているアプリケーションをインポートした場合の下位互換性が維持されるようになっています。

関連項目:

カスタム・カスケード・スタイルシートの使用

11.3.2 ページ・テンプレートからのJavaScriptファイルのコールについて

Oracle Application Expressではページ・テンプレートで.jsファイルを参照できます。このアプローチによって、そのファイル内のすべてのJavaScriptがアプリケーションにアクセス可能になります。.jsファイルはアプリケーションの最初のページ・ビューにロードされてからブラウザでキャッシュされるため、これは最も効率的なアプローチです。

関連項目:

JavaScript

11.3.3 置換文字列でのエスケープ構文の使用について

開発者は、先頭に感嘆符(!)の付いた事前定義済のフィルタ名を置換文字列に追加することで、置換値の特殊文字をエスケープできます。出力のエスケープは、ブラウザでクロス・サイト・スクリプティング(XSS)攻撃を回避するための重要なセキュリティ手法です。

関連項目:

置換文字列での出力のエスケープの制御

11.3.4 デフォルトのページ・テンプレートの選択

この項では、デフォルト・ページ・テンプレートの選択方法について説明します。デフォルトのページ・テンプレートは、2つの方法で指定できます。

- 特定のテーマ内のデフォルトのページ・テンプレートを選択します。

- ページごとに特定のページ・テンプレートを選択します。

デフォルトでは、Application Expressエンジンは、テーマ・ページで指定されたページ・テンプレートを使用します。

トピック:

- テーマ内のページ・レベル・テンプレートの選択

- 特定のページのページ・レベル・テンプレートの選択

11.3.4.1 テーマ内のページ・レベル・テンプレートの選択

テーマ内のデフォルトのページ・テンプレートを指定するには、次のステップを実行します。

1. テーマ・ページにナビゲートします。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. 「共有コンポーネント」をクリックします。

d. 「ユーザー・インタフェース」で、「テーマ」を選択します。

テーマ・ページが表示されます。

2. テーマ名を選択します。

テーマの作成/編集ページが表示されます。

3. 「コンポーネントのデフォルト値」までスクロールします。

4. 「ページ」から、新しい選択を行います。

5. ページ上部の「変更の適用」をクリックします。

関連項目:

テーマの編集

11.3.4.2 特定のページのページ・レベル・テンプレートの選択

特定のページにページ・レベル・テンプレートを指定するには、次のステップを実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「ページ・デザイナ」でページ・レベル・テンプレートを編集するには、次のステップを実行します。

a. ページ・デザイナでページを表示します。

b. 「レンダリング」タブで、ページ・タイトルをクリックします。

c. プロパティ・エディタで「外観」を見つけます。「ページ・テンプレート」から新しいテンプレートを選択します。

d. 「保存」をクリックします。

4. 「コンポーネント・ビュー」でページ・レベル・テンプレートを編集するには、次のステップを実行します。

a. コンポーネント・ビューでページを表示します。

b. 「ページ」で、「編集」アイコンをクリックします。
編集ページが表示されます。

c. 「表示属性」を見つけます。「ページ・テンプレート」から新しいテンプレートを選択します。

d. 「変更の適用」をクリックします。

関連項目:

「ページ・デザイナでのページの表示」および「レガシー・コンポーネント・ビューでのページの表示」

11.3.5 新しいテンプレートの作成

カスタム・テンプレートを作成するには、まず既存のテンプレートをコピーし、それを変更する必要があります。作成した1つ以上のデフォルト・テンプレートは、必要に応じて変更できます。

カスタム・テンプレートを作成するには、次のステップを実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. テンプレートをコピーするアプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「ユーザー・インタフェース」で、「テンプレート」を選択します。

5. 「作成」をクリックします。

6. 作成するテンプレートのタイプを選択し、「次へ」をクリックします。

7. 次のいずれかの作成方法を選択します。

- 最初から

- 既存のテンプレートのコピーとして

8. 画面に表示されるステップに従います。

ヒント:

テンプレートが適切なテーマに関連付けられていることを確認します。

11.3.6 テンプレート・オプションの使用

開発者はテンプレート・オプションを使用して、宣言的な方法でOracle Application Expressのページ上のコンポーネントに様々なスタイルを適用できます。

トピック:

- グローバル・テンプレート・オプション・グループの管理

- グローバル・テンプレート・オプションの管理

- テンプレート・オプションの管理

関連項目:

テンプレート・オプションの理解

11.3.6.1 グローバル・テンプレート・オプション・グループの管理

グローバル・テンプレート・オプション・グループはテーマレベルで定義され、特定のタイプのコンポーネントすべてで使用できます。この項では、グローバル・テンプレート・オプション・グループを作成および編集する方法について説明します。

トピック:

- グローバル・テンプレート・オプション・グループの作成

- グローバル・テンプレート・オプション・グループの編集

関連項目:

テンプレート・オプション・グループおよび事前設定についておよびテンプレート・オプションの理解

11.3.6.1.1 グローバル・テンプレート・オプション・グループの作成

グローバル・テンプレート・オプション・グループを作成するには、次のステップを実行します。

1. テーマ・ページにナビゲートします。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. 「共有コンポーネント」をクリックします。

d. 「ユーザー・インタフェース」で、「テーマ」を選択します。

テーマ・ページが表示されます。

2. テーマを選択します。

3. 「グローバル・テンプレート・オプション」を見つけます。

4. 「テンプレート・オプション・グループの編集」をクリックします。
「テンプレート・オプション・グループ」ダイアログが表示されます。

5. グループを作成するには:

a. 「作成」をクリックします。

b. 対象となる属性を編集します。
属性の詳細は、フィールドレベル・ヘルプを参照してください。

c. 「作成」をクリックします。

11.3.6.1.2 グローバル・テンプレート・オプション・グループの編集

グローバル・テンプレート・オプション・グループを編集するには、次のステップを実行します。

1. テーマ・ページにナビゲートします。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. 「共有コンポーネント」をクリックします。

d. 「ユーザー・インタフェース」で、「テーマ」を選択します。

テーマ・ページが表示されます。

2. テーマを選択します。

3. 「グローバル・テンプレート・オプション」を見つけます。

4. 「テンプレート・オプション・グループの編集」をクリックします。
「テンプレート・オプション・グループ」ダイアログが表示されます。

5. グループを編集するには:

a. グループ名をクリックします。

b. 対象となる属性を編集します。
属性の詳細は、フィールドレベル・ヘルプを参照してください。

c. 「変更の適用」をクリックします。

6. 次の手順を実行して、グループを削除します。

a. グループ名をクリックします。

b. 「削除」をクリックします。

11.3.6.2 グローバル・テンプレート・オプションの管理

この項では、グローバル・テンプレート・オプションを作成および編集する方法について説明します。

トピック:

- グローバル・テンプレート・オプションの作成

- グローバル・テンプレート・オプションの編集

関連項目:

テンプレート・オプションについて

11.3.6.2.1 グローバル・テンプレート・オプションの作成

グローバル・テンプレート・オプションを作成するには、次のステップを実行します。

1. テーマ・ページにナビゲートします。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. 「共有コンポーネント」をクリックします。

d. 「ユーザー・インタフェース」で、「テーマ」を選択します。

テーマ・ページが表示されます。

2. テーマを選択します。

3. 「グローバル・テンプレート・オプション」を見つけます。

4. 「テンプレート・オプションの追加」をクリックします。
「テンプレート・オプション・グループ」ダイアログが表示されます。

5. 「テンプレート・オプション」で、次のステップを実行します。

a. 表示順序 - このオプションの順序を指定します。

b. テンプレート・タイプ - テンプレート・オプションを定義するテンプレートのタイプを選択します。

c. グループ - 一意のグループ名を入力します。グループ名によってテンプレート・オプションをグループ化し、競合するオプションが選択されないようにすることができます。
表示名 - テンプレート・オプションの名前を入力します。

d. オプション識別子 - テンプレート・オプションの識別子を大文字の英数字で入力します。識別子によって、テーマを切り替えるときにテンプレート・オプションが対応するテンプレート・オプションにマップされます。

e. CSSクラス - このテンプレート・オプションを定義する1つ以上のCSSクラスを入力します。

f. ヘルプ・テキスト - テンプレート・オプションの説明を入力します。

g. 「作成」または「作成後、別のものを追加」をクリックします。

11.3.6.2.2 グローバル・テンプレート・オプションの編集

グローバル・テンプレート・オプションを編集するには、次のステップを実行します。

1. テーマ・ページにナビゲートします。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. 「共有コンポーネント」をクリックします。

d. 「ユーザー・インタフェース」で、「テーマ」を選択します。

テーマ・ページが表示されます。

2. テーマを選択します。

3. 「グローバル・テンプレート・オプション」を見つけます。

4. テンプレート・オプションを編集するには、次のステップを実行します。

a. 表示名をクリックします。

b. 対象となる属性を編集します。属性の詳細は、フィールドレベル・ヘルプを参照してください。

ヒント:

CSSクラスの名前を編集した場合は、そのCSSクラス名を参照するすべてのコンポーネントを手動で更新する必要があります。オプション識別子はマッピングのために必要なため、変更できません。

c. 「変更の適用」をクリックします。

5. テンプレート・オプションを削除するには、次のステップを実行します。

a. 表示名をクリックします。

b. 「削除」をクリックします。

11.3.6.3 テンプレート・オプションの管理

この項では、テンプレート・オプションを作成および編集する方法について説明します。

トピック:

- テンプレート・オプションの作成

- テンプレート・オプションの編集

- ライブ・テンプレート・オプションを変更するためのクイック編集の使用

関連項目:

テンプレート・オプションの理解

11.3.6.3.1 テンプレート・オプションの作成

テンプレート・オプションを作成するには、次のステップを実行します。

1. テーマ・ページにナビゲートします。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. 「共有コンポーネント」をクリックします。

d. 「ユーザー・インタフェース」で、「テンプレート」を選択します。

テンプレート・ページが表示されます。

2. テンプレートを選択します。

3. 「テンプレート・オプション」を選択します。

4. 「テンプレート・オプションの追加」をクリックします。

5. 対象となる属性を編集します。属性の詳細は、フィールドレベル・ヘルプを参照してください。

6. 「作成」または「作成後、別のものを追加」をクリックします。

11.3.6.3.2 テンプレート・オプションの編集

テンプレート・オプションを編集するには、次のステップを実行します。

1. テーマ・ページにナビゲートします。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. 「共有コンポーネント」をクリックします。

d. 「ユーザー・インタフェース」で、「テンプレート」を選択します。

テンプレート・ページが表示されます。

2. テンプレートを選択します。

3. 「テンプレート・オプション」を選択します。

4. 該当する属性を編集し、「変更の適用」をクリックします。

属性の詳細は、フィールドレベル・ヘルプを参照してください。

ヒント:

CSSクラスの名前を編集した場合は、そのCSSクラス名を参照するすべてのコンポーネントを手動で更新する必要があります。オプション識別子はマッピングのために必要なため、変更できません。

5. テンプレート・オプションを削除するには、「削除」をクリックします。

6. グローバル・テンプレート・オプションを表示するには、「グローバル・テンプレート・オプション」を展開します。

11.3.6.3.3 ライブ・テンプレート・オプションを変更するためのクイック編集の使用

開発者は、実行時開発者ツールバーのクイック編集を使用して、「ライブ・テンプレート・オプション」ダイアログにアクセスすることもできます。開発者は、「ライブ・テンプレート・オプション」ダイアログを使用して、ページをリフレッシュすることなくコンポーネントのテンプレート・オプションを変更できます。

ライブ・テンプレート・オプションにアクセスするには、次のステップを実行します。

1. ページを実行します。

2. 実行時開発者ツールバーから、「クイック編集」をクリックします。

3. テンプレート・オプションを変更するコンポーネントの上にマウスを移動します。右上隅にあるレンチ・アイコンをクリックします。

「ライブ・テンプレート・オプション」ダイアログが表示されます。リストやクラシック・レポートなどのリージョンベース・コンポーネントの場合は、ダイアログに「属性」タブが含まれます。

4. 該当するタブを選択して、該当する属性を編集し、「保存」をクリックします。

関連項目:

「実行時開発者ツールバー」

11.3.7 テンプレート・レポートの表示

アプリケーション・ビルダーには、テンプレートの使用状況、サブスクリプション、パブリッシュされたテンプレートおよび編集履歴を示すレポートがあります。

カレント・アプリケーションについてのテンプレート・レポートを表示するには、次のステップを実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「ユーザー・インタフェース」で、「テンプレート」を選択します。

テンプレート・ページは、対話モード・レポートとして表示されます。ビューをカスタマイズするには、ページ上部の検索バーを使用します。

5. テンプレート・レポートを表示するには、次のタブをクリックします。

- サブスクリプション - アプリケーションでサブスクライブされたテンプレートを表示します。

- パブリッシュ - ワークスペースの他のテンプレートによってサブスクライブされたテンプレートを表示します。マスター・テンプレートの内容を、サブスクライブしているテンプレートにパブリッシュするには、パブリッシュする対象を選択して、「チェックした項目のパブリッシュ」をクリックします。

- 使用状況 - カレント・アプリケーションのすべてのテンプレート・タイプについてテンプレートの使用状況を表示します。「参照」列の数値は、特定のテンプレートを使用するページの合計数を示します。

- 履歴 - このアプリケーション内のページおよびリージョン・テンプレートの最近の変更を表示します。

11.3.8 テンプレートの管理

テンプレート・ページで、すべての使用可能なテンプレートを表示できます。また、特定のページに関連付けられているテンプレートにアクセスできます。

トピック:

- テンプレート・ページでのテンプレートの表示

- 特定のページに関連付けられているテンプレートの表示

- テンプレートの置換

- アプリケーション内のすべてのテンプレートの置換

- ページ・テンプレート別のリージョン位置の使用状況の表示

- テンプレートのサブスクライブ解除

- テンプレートのパブリッシュ

関連項目:

テーマのすべてのテンプレートの表示

11.3.8.1 テンプレート・ページでのテンプレートの表示

既存のテンプレートを表示するには、次のステップを実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「ユーザー・インタフェース」で、「テンプレート」を選択します。

テンプレート・ページは、対話モード・レポートとして表示されます。ビューをカスタマイズするには、ページ上部の検索バーを使用します。

5. テンプレート定義を表示または編集するには、テンプレート名をクリックします。

テンプレート定義が表示されます。

6. 対象となる属性を編集します。属性の詳細は、フィールドレベル・ヘルプを参照してください。

テンプレートを編集する場合、1つのウィンドウで変更を行い、テンプレート定義ページの右側で「ページに戻る」チェック・ボックスを選択することで、別のウィンドウでアプリケーションを実行できます。このチェック・ボックスを選択すると、「変更の適用」をクリックした後、現在編集中のページが維持されます。

7. 「変更の適用」をクリックします。

11.3.8.2 特定のページに関連付けられているテンプレートの表示

特定のページに関連付けられているテンプレートを表示するには、次のステップを実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. ページ・デザイナでページを表示します。

a. 「レンダリング」タブで、ページ・タイトルをクリックします。

b. プロパティ・エディタで「外観」を見つけます。「ページ・テンプレート」に現在のテンプレートが表示されます。

c. 変更を保存するには、「保存」をクリックします。

4. コンポーネント・ビューでページを表示します。

a. 「ページ」で、「編集」アイコンをクリックします。
編集ページが表示されます。

b. 「表示属性」を見つけます。「ページ・テンプレート」に現在のテンプレートが表示されます。

c. 変更を保存するには、「変更の適用」をクリックします。

注意:

テンプレートを編集する場合、1つのウィンドウで変更を行い、テンプレート定義ページの右側で「ページに戻る」チェック・ボックスを選択することで、別のウィンドウでアプリケーションを実行できます。このチェック・ボックスを選択すると、「変更の適用」をクリックした後、現在編集中のページが維持されます。

関連項目:

「ページ・デザイナでのページの表示」および「レガシー・コンポーネント・ビューでのページの表示」

11.3.8.3 テンプレートの置換

テンプレートの置換ウィザードを使用してコンポーネントに関連付けられているテンプレートを更新できます。

コンポーネントに関連付けられているテンプレートを置換するには、次のステップを実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「ユーザー・インタフェース」で、「テンプレート」を選択します。
ビューをカスタマイズするには、ページ上部の検索バーを使用します。

5. 「タスク」リストから「テンプレートの置換」を選択します。

6. 「テンプレート・タイプ」で、次のステップを実行します。

a. ユーザー・インタフェース: ユーザー・インタフェースを選択します。

b. テンプレート・タイプ - 置換されるテンプレート・タイプを示します。

c. 「次へ」をクリックします。

7. 「テンプレートの置換」で、次のステップを実行します。

a. 変更前: 変更するテンプレートを選択します。

b. 変更後: 変更後のテンプレートを選択します。

c. 「次へ」をクリックします。

8. 「終了」をクリックします。

11.3.8.4 アプリケーション内のすべてのテンプレートの置換

アプリケーション内のすべてのテンプレートを別のアプリケーションのテンプレートに置換するには、次のステップを実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「ユーザー・インタフェース」で、「テンプレート」を選択します。
ビューをカスタマイズするには、ページ上部の検索バーを使用します。

5. 「タスク」リストから「このアプリケーションのテンプレートを別のアプリケーションのテンプレートに置換。」を選択します。

6. 「テンプレートの置換」で、次のステップを実行します。

a. アプリケーションから置換: アプリケーションを選択します。

b. ユーザー・インタフェース: このアプリケーションを開発する対象のユーザー・インタフェースのタイプを選択します。

c. 「次へ」をクリックします。

7. 「テンプレートの置換」で、各コンポーネントの新しいテンプレートを選択し、「アクション」で次のいずれかを選択します。

a. 置換: テンプレート定義をコピーします。

b. 置換/サブスクライブ: テンプレートをコピーしてサブスクリプションを追加します。

8. 「テンプレートの置換」をクリックします。

11.3.8.5 ページ・テンプレート別のリージョン位置の使用状況の表示

ページ上のリージョンは、位置(表示ポイント)で構成されます。リージョンで使用可能な表示ポイントは、ページ・レベルのテンプレートによって決まります。

ページ・テンプレート別のリージョン位置の使用状況を表示するには、次のステップを実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「ユーザー・インタフェース」で、「テンプレート」を選択します。
ビューをカスタマイズするには、ページ上部の検索バーを使用します。

5. 「タスク」リストから「ページ・テンプレートのリージョン位置の使用状況の表示」を選択します。

「リージョン表示ポイントの使用状況」レポートが表示されます。

11.3.8.6 テンプレートのサブスクライブ解除

サブスクライブされるテンプレートとは、定義を別のテンプレートで管理されているテンプレート、つまり参照されるテンプレートです。アプリケーションで、サブスクライブされるテンプレートを使用している場合は、テンプレートのサブスクライブ解除ページでテンプレートのサブスクライブを解除できます。

テンプレートのサブスクライブを解除するには、次のステップを実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「ユーザー・インタフェース」で、「テンプレート」を選択します。
ビューをカスタマイズするには、ページ上部の検索バーを使用します。

5. 「タスク」リストから「テンプレートのサブスクライブ解除」を選択します。

テンプレートのサブスクライブ解除ページが表示されます。

6. テーマを選択します。

7. 現行のテーマ内で特定のテンプレート・タイプをサブスクライブ解除するには、テンプレート・タイプを選択し、「サブスクライブ解除」をクリックします。

11.3.8.7 テンプレートのパブリッシュ

テンプレートのパブリッシュ・ページを使用して、ワークスペースの他のテンプレートによってサブスクライブされるテンプレートを表示します。

マスター・テンプレートの内容を、サブスクライブしているテンプレートにパブリッシュするには、次のステップを実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「ユーザー・インタフェース」で、「テンプレート」を選択します。
ビューをカスタマイズするには、ページ上部の検索バーを使用します。

5. 「パブリッシュ」タブをクリックします。

テンプレートのパブリッシュ・ページが表示されます。

6. パブリッシュするテンプレートを選択し、「チェックした項目のパブリッシュ」をクリックします。

11.3.9 ブレッドクラム・テンプレート

ブレッドクラム・テンプレートは、ブレッドクラム・エントリの表示方法を制御します。このテンプレートは、リージョンの作成時に選択します。

関連項目:

テーマの使用

トピック:

- ブレッドクラム・スタイルのナビゲーションについて

- ブレッドクラム・テンプレート属性

11.3.9.1 ブレッドクラム・スタイルのナビゲーションについて

ブレッドクラムは通常、現在のページが、アプリケーション内の他のページに対してどの位置にあるかを示します。また、ユーザーは特定のページをクリックするだけで、そのページを表示することができます。たとえば、Oracle Application Expressのサンプル・データベース・アプリケーションでは、Administrationページの上部にブレッドクラム・メニューが表示されます。

関連項目:

ブレッドクラムの作成

11.3.9.2 ブレッドクラム・テンプレート属性

ブレッドクラム・テンプレートは、ブレッドクラム・リージョン・タイプの表示方法を制御します。このテンプレートは、リージョンの作成時に選択します。特定の属性の詳細は、フィールドレベル・ヘルプを参照してください。

トピック:

- 名前

- 定義

- 置換文字列

11.3.9.2.1 名前

「名前」は、テンプレートの名前を示します。テンプレートに翻訳が必要なテキスト文字列が含まれていることを示すには、「翻訳可能」チェック・ボックスを使用します。「テーマ」は、テンプレートが関連付けられているテーマを示します。「テンプレート・クラス」は、そのテンプレートに固有の用途を示します。テーマに切り替えると、あるテーマのすべてのテンプレートは、別のテーマの対応するテンプレートにマップされます。アプリケーション・ビルダーは、テンプレート・クラスの割当てによってこのテンプレート・マッピングを行います。

11.3.9.2.2 定義

定義属性は、ブレッドクラムの表示方法を制御します。表11-8に、定義属性を示します。

表11-8 定義属性

属性

説明

最初の前

最初のブレッドクラム・エントリの前に表示するテキストを定義します。置換文字列#COMPONENT_CSS_CLASSES#を使用して、CSSクラスをブレッドクラム・テンプレートに適用します。コンポーネントCSSクラスを編集するには、リージョン属性を編集します。

関連項目: ページ・デザイナでのリージョン属性の編集およびコンポーネント・ビューでのリージョン属性の編集

カレント・ページのブレッドクラム・エントリ

カレント・ページに対応するブレッドクラム・エントリの外観を定義します。

カレント・ページ以外のブレッドクラム・エントリ

カレント・ページに対応していないブレッドクラム・エントリの外観を定義します。

最後の後

最後のブレッドクラム・エントリの後に表示するテキストを定義します。

レベル間

ブレッドクラム・エントリのレベル間に表示するテキストを定義します。

最大レベル

ブレッドクラムをブレッドクラム・スタイルで表示する際に使用するレベル数を指定します。

11.3.9.2.3 置換文字列

置換文字列は、コンポーネント値を参照するためにサブテンプレート内で使用されます。表11-9に、使用可能なボタン・テンプレートの置換文字列を示します。

ヒント:

テンプレートのすべての置換文字列は、大文字で指定し、シャープ記号(#)で囲む必要があります。特定のテンプレートでサポートされる置換文字列のレポートを表示するには、ブレッドクラム・テンプレートの編集ページの「置換文字列」セクションを参照してください。

表11-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文字をエスケープ)。

11.3.10 ボタン・テンプレート

ボタン・テンプレートを使用すると、開発者は、ボタンのルック・アンド・フィールをカスタマイズできます。ボタンを構築する場合、複数のイメージまたはHTMLタグを使用できます。ボタン・テンプレートの使用はオプションです。

関連項目:

テーマの使用

トピック:

- ボタン・テンプレート属性

11.3.10.1 ボタン・テンプレート属性

この項では、ボタン・テンプレートの編集ページの一部のセクションについて説明します。特定の属性の詳細は、フィールドレベル・ヘルプを参照してください。

トピック:

- 名前

- 定義

- 置換文字列

関連項目:

テンプレート・オプションの理解およびテーマのサブスクリプションの理解

11.3.10.1.1 名前

「テンプレート名」は、テンプレートの名前を示します。テンプレートに変換が必要なテキスト文字列が含まれているかどうかを示すには、「翻訳可能」チェック・ボックスを使用します。「テーマ」は、テンプレートが関連付けられているテーマを示します。

「テンプレート・クラス」は、そのテンプレートに固有の用途を示します。テーマに切り替えると、あるテーマのすべてのテンプレートは、別のテーマの対応するテンプレートにマップされます。アプリケーション・ビルダーは、テンプレート・クラスの割当てによってこのテンプレート・マッピングを行います。

11.3.10.1.2 定義

「通常のテンプレート」では、ボタン・タイプが「標準」の場合に表示されるボタン・テンプレートが定義されます。たとえば、&ITEM_NAME値はレンダリング時に置換できます。「ホット・テンプレート」では、ボタン・タイプが「ホット」の場合に表示されるボタン・テンプレートが定義されます。標準のアプリケーション置換文字列を含めることもできます。たとえば、&ITEM_NAME値はレンダリング時に置換できます。

サポートされている置換文字列の詳細は、フィールドレベル・ヘルプを参照してください。

ヒント:

置換文字列はすべて大文字である必要があります。

11.3.10.1.3 置換文字列

置換文字列は、コンポーネント値を参照するためにサブテンプレート内で使用されます。表11-10に、使用可能なボタン・テンプレートの置換文字列を示します。

ヒント:

テンプレートのすべての置換文字列は、大文字で指定し、シャープ記号(#)で囲む必要があります。特定のテンプレートでサポートされる置換文字列のレポートを表示するには、ページ・テンプレートの編集ページの「置換文字列」セクションを参照してください。

表11-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属性で使用されます。

11.3.11 レガシー・カレンダ・テンプレート

レガシー・カレンダ・テンプレートは、カレンダの外観と配置を制御します。このテンプレートは、頻繁にHTML表を使用して日付を配置します。#DD#や#MONTH#などの置換文字列を使用してカレンダ属性を配置します。

トピック:

- サポートされるレガシー・カレンダ・テンプレートの置換文字列

- レガシー・カレンダ・テンプレート属性

関連項目:

サポートされているカレンダについて、カレンダの作成およびテーマの使用

11.3.11.1 サポートされるレガシー・カレンダ・テンプレートの置換文字列

サポートされている置換文字列のリストは、カレンダ・テンプレートの編集ページの右側に表示されます。テンプレートの置換文字列は大文字で指定し、シャープ記号(#)で囲む必要があることに注意してください。

11.3.11.2 レガシー・カレンダ・テンプレート属性

この項では、カレンダ・テンプレートの編集ページの一部のセクションについて説明します。特定の属性の詳細は、フィールドレベル・ヘルプを参照してください。

関連項目:

テンプレート・オプションの理解およびテーマのサブスクリプションの理解

カレンダ定義

トピック:

- 名前

- サブスクリプション

- コメント

11.3.11.2.1 名前

「名前」は、テンプレートの名前を示します。テンプレートに変換が必要なテキスト文字列が含まれているかどうかを示すには、「翻訳可能」チェック・ボックスを使用します。「テーマ」は、テンプレートが関連付けられているテーマを示します。

「テンプレート・クラス」は、そのテンプレートに固有の用途を示します。テーマに切り替えると、あるテーマのすべてのテンプレートは、別のテーマの対応するテンプレートにマップされます。アプリケーション・ビルダーは、テンプレート・クラスの割当てによってこのテンプレート・マッピングを行います。

11.3.11.2.2 サブスクリプション

「サブスクリプション」を使用して、カレント・アプリケーションに既存のテンプレートを適用します。

「マスター・ラベル・テンプレートの参照元」を使用して、対象のワークスペースの既存のテンプレート、またはワークスペースのスキーマの別のテンプレートを選択します。既存のテンプレートを選択すると、ユーザーはそのテンプレートのサブスクライバになります。

マスター・テンプレートのコピーをロードするには、「リフレッシュ」をクリックします。

11.3.11.2.3 コメント

この属性を使用して、このコンポーネントに関するコメントを記録します。

月次カレンダ、週次カレンダ、日次カレンダ、カスタム・カレンダおよびリスト・カレンダ

「月次カレンダ」、「週次カレンダ」、「日次カレンダ」および「リスト・カレンダ」属性を使用して、特定のカレンダの外観および配置を制御します。

11.3.12 ラベル・テンプレート

ラベル・テンプレートは、ページ・アイテム・ラベルのHTMLマークアップを集中管理することを目的としています。各アイテムにはオプションのラベルがあります。ラベル・テンプレートを使用して、これらのラベルの表示方法を制御できます。たとえば、ユーザーに必須であることを示すイメージ(アスタリスクなど)を参照する「必須フィールド」というラベル・テンプレートを作成できます。

ラベル・テンプレートを使用すると、アイテムの先頭と末尾に追加するテキスト文字列を定義できます。

トピック:

- ラベル・テンプレート属性

- #CURRENT_ITEM_HELP_TEXT#を使用したアイテム・ヘルプの作成について

関連項目:

テーマの使用

11.3.12.1 ラベル・テンプレート属性

関連項目:

テンプレート・オプションの理解およびテーマのサブスクリプションの理解

ここでは、ラベル・テンプレートの編集ページの特定のセクションについて説明します。特定の属性の詳細は、フィールドレベル・ヘルプを参照してください。

トピック:

- 名前

- 定義

- エラー表示

- フィールド・コンテナ

- 置換文字列

11.3.12.1.1 名前

「テンプレート名」は、テンプレートの名前を示します。テンプレートに翻訳が必要なテキスト文字列が含まれていることを示すには、「翻訳可能」チェック・ボックスを使用します。 「テーマ」は、テンプレートが関連付けられているテーマを示します。

「テンプレート・クラス」は、そのテンプレートに固有の用途を示します。テーマに切り替えると、あるテーマのすべてのテンプレートは、別のテーマの対応するテンプレートにマップされます。アプリケーション・ビルダーは、テンプレート・クラスの割当てによってこのテンプレート・マッピングを行います。

11.3.12.1.2 定義

定義属性は次のとおりです。

ヒント:

サポートされている置換文字列のリストおよび例は、フィールドレベル・ヘルプを参照してください。

- ラベルの前 - アイテム・ラベルの前に表示するHTMLを入力します。#ITEM_CSS_CLASSES#置換文字列は、テンプレート・オプションが定義されているテンプレートに含める必要があります。

- ラベルの後 - アイテム・ラベルの後に表示するHTMLを入力します。このラベルはこのリージョンのHTMLの前に自動的に表示されるため、「ラベルの前」リージョンの開始タグを閉じる必要があります。

- アイテムの前 - フォーム・アイテムの直前に表示するHTMLを入力します。これは通常、アイテムをDIVコンテナにラップするか、フォーム・アイテムの前または後にヘルプ・ボタンを表示するために使用されます。

- アイテムの後 - フォーム・アイテムの直後に表示するHTMLを入力します。これは通常、アイテムをDIVコンテナにラップするか、フォーム・アイテムの前または後にヘルプ・ボタンを表示するために使用されます。

- アイテム事前テキスト - アイテム属性の前のテキストとして格納されるコンテンツを書式設定するためのアイテム事前テキスト・サブテンプレートのHTMLを入力します。このサブテンプレートは、#ITEM_PRE_TEXT#の置換を使用して要素前テンプレートで参照できます。

- アイテム事後テキスト - アイテム属性の後のテキストとして格納されるコンテンツを書式設定するためのアイテム事後テキスト・サブテンプレートのHTMLを入力します。このサブテンプレートは、#ITEM_PRE_TEXT#の置換を使用して要素後テンプレートで参照できます。

- ヘルプ・テンプレート - ヘルプ・サブテンプレートでは、開発者がアイテム・レベルのヘルプの起動に使用されるリンクまたはボタンを定義できます。このサブテンプレートは、ヘルプが定義されているアイテムに対してのみレンダリングされます。#CURRENT_ITEM_HELP_TEXT#を使用したアイテム・ヘルプの作成についてを参照してください。

- インライン・ヘルプ・テンプレート - ヘルプ・サブテンプレートでは、開発者がアイテムとともに即座に表示するインライン・ヘルプ・テキストを定義できます。このサブテンプレートは、インライン・ヘルプ・テキストが定義されているアイテムに対してのみレンダリングされます。

11.3.12.1.3 エラー表示

エラー表示属性は次のとおりです。

ヒント:

サポートされている置換文字列のリストおよび例は、フィールドレベル・ヘルプを参照してください。

- ラベルの前のエラー発生時 - アプリケーションがアイテムのインライン検証エラー・メッセージを表示する場合に、そのアイテム・ラベルの前に表示するHTMLを入力します。

- ラベルの後のエラー発生時 - アプリケーションがアイテムのインライン検証エラー・メッセージを表示する場合に、そのアイテム・ラベルに追加するHTMLを入力します。

- エラー・テンプレート - インライン検証エラー・メッセージを表示するためにレンダリングされるHTMLを入力します。メッセージ・テキストを参照するには、#ERROR_MESSAGE#置換文字列を使用します。#ERROR_TEMPLATE#置換文字列を使用して、アイテム属性の前後にエラー・テンプレートを含めることができます。

11.3.12.1.4 フィールド・コンテナ

フィールド・コンテナ属性は次のとおりです。

ヒント:

サポートされている置換文字列のリストおよび例は、フィールドレベル・ヘルプを参照してください。

- 「ラベルの前」とアイテム - ラベルおよびアイテムの前に表示するHTMLを入力します。これは、通常、アイテムをDIVコンテナまたはフィールド・セットにラップするために使用されます。「「ラベルの前」とアイテム」属性は、表グリッドを使用してフォーム・アイテムを表示しないページにのみレンダリングされます。これには、モバイル・ページ・テンプレートを使用したページが含まれます。

- 「ラベルの後」とアイテム - ラベルおよびアイテムの後に表示するHTMLを入力します。これは、通常、アイテムをDIVコンテナまたはフィールド・セットにラップするために使用されます。後のアイテムおよびラベル属性は、表グリッドを使用してフォーム・アイテムを表示しないページにのみレンダリングされます。これには、モバイル・ページ・テンプレートを使用したページが含まれます。

11.3.12.1.5 置換文字列

このテンプレートの置換文字列の用途を一覧します。置換文字列は、サブテンプレート内でコンポーネント値を参照するために使用されます。

11.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>

11.3.13 リスト・テンプレート

リストは、リンクの共有コレクションです。リストの外観は、リスト・テンプレートで制御します。テンプレート属性を使用すると、特定のページのカレントまたは非カレントとしてリスト要素を定義できます。

トピック:

- 階層リストについて

- リスト・テンプレート属性

関連項目:

リストの作成およびテーマの使用

11.3.13.1 階層リストについて

Oracle Application Expressでは、階層的なリストをサポートしています。階層的なリストを作成するには、次のステップを実行します。

- 階層的なリストをサポートするリスト・テンプレートを選択します。階層的なリストをサポートするリスト・テンプレートを判別するには、サブリスト付きというネーミング規則のあるテンプレートを検索します。

- 各リスト・エントリの作成時には親リスト・エントリを選択します。

関連項目:

リストの作成

11.3.13.2 リスト・テンプレート属性

関連項目:

テンプレート・オプションの理解およびテーマのサブスクリプションの理解

この項では、リスト・テンプレートの編集ページの一部のセクションについて説明します。特定の属性の詳細は、フィールドレベル・ヘルプを参照してください。

トピック:

- 名前

- リスト前のエントリ

- テンプレート定義

- 最初のエントリのテンプレート定義

- サブリスト・エントリ前

- サブリスト・エントリ

- サブリスト後のエントリ

- リスト後のエントリ

- 置換文字列

11.3.13.2.1 名前

「名前」は、テンプレートの名前を示します。テンプレートに翻訳が必要なテキスト文字列が含まれていることを示すには、「翻訳可能」チェック・ボックスを使用します。 「テーマ」は、テンプレートが関連付けられているテーマを示します。

「テンプレート・クラス」は、そのテンプレートに固有の用途を示します。新しいテーマに切り替えると、あるテーマのすべてのテンプレートは、別のテーマの対応するテンプレートにマップされます。アプリケーション・ビルダーは、テンプレート・クラスの割当てによってこのテンプレート・マッピングを行います。

11.3.13.2.2 リスト前のエントリ

リスト要素の前に表示するHTMLを入力します。この属性は、HTML表またはHTML表の行を開始するために使用できます。#COMPONENT_CSS_CLASSES#置換文字列は、テンプレート・オプションが定義されているテンプレートの行の前のリスト・テンプレート属性に含める必要があります。

11.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を指定しないと、この属性が無視されます。

11.3.13.2.4 最初のエントリのテンプレート定義

選択可能な属性は次のとおりです。

- カレント・リスト・テンプレート(最初):定義されている場合、これは最初のリスト・アイテムに使用されます。選択された(カレントの)リスト・テンプレートに置換されるHTMLまたはテキストを入力します。

- サブリスト・アイテムが含まれているカレント・リスト・テンプレート(最初):定義されている場合、これは最初のリスト・アイテムに使用されます。アイテムにサブリスト・アイテムが含まれる場合に使用される、選択された(カレントの)リスト・テンプレートに置換されるHTMLまたはテキスト。

- 非カレント・リスト・テンプレート(最初):定義されている場合、これは最初のリスト・アイテムに使用されます。選択されていない(非カレントの)リスト・テンプレートに置換されるHTMLまたはテキストを入力します。

- サブリスト・アイテムが含まれている非カレント・リスト・テンプレート(最初):定義されている場合、これは最初のリスト・アイテムに使用されます。アイテムにサブリスト・アイテムが含まれる場合に使用される、選択されていない(非カレントの)リスト・テンプレートに置換されるHTMLまたはテキスト。

11.3.13.2.5 サブリスト・エントリ前

サブリスト要素の前に表示するHTMLを入力します。

11.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を指定しないと、この属性が無視されます。

11.3.13.2.7 サブリスト後のエントリ

サブリスト要素を表示した後に表示するHTMLを入力します。

11.3.13.2.8 リスト後のエントリ

すべてのリスト要素を表示した後に表示するHTMLを入力します。この属性を使用して、リスト前の要素属性で開始したHTML表を閉じることができます。

11.3.13.2.9 置換文字列

このテンプレートの置換文字列の用途を一覧します。置換文字列は、サブテンプレート内でコンポーネント値を参照するために使用されます。

11.3.14 ページ・テンプレート

ページ・テンプレートは、ページの外観を定義します。各テンプレートは、ヘッダー・テンプレート、ボディ・テンプレート、フッター・テンプレートおよび多くのサブテンプレートで構成されます。ページ・レベル属性でページ・テンプレートを指定しない場合、Application Expressエンジンは、テーマの作成/編集ページで定義したデフォルトのページ・テンプレートを使用します。

ページ・テンプレートは、静的HTMLと実行時に置き換えられる置換文字列を組み合せたものです。置換文字列を使用して、ページ・テンプレート内のコンポーネントの存在と配置を指定します。さらに、サブテンプレートを使用して、コンポーネントの表示方法を指定できます。

トピック:

- ページ・テンプレート属性

- 必須のダイアログ・ページ・テンプレート属性

関連項目:

テーマの使用

11.3.14.1 ページ・テンプレート属性

関連項目:

テンプレート・オプションの理解およびテーマのサブスクリプションの理解

ここでは、ページ・テンプレートの編集ページの特定のセクションについて説明します。サポートされている置換文字列など、特定の属性の詳細は、フィールドレベル・ヘルプを参照してください。

トピック:

- 名前

- 定義

- JavaScript

- カスケード・スタイル・シート

- サブテンプレート

- イメージ・ベースのタブ属性

- レイアウト

- 表示ポイント

- ダイアログ

- エラー・ページ・テンプレートの制御

- 置換文字列

11.3.14.1.1 名前

「名前」は、テンプレートの名前を示します。「テーマ」は、テンプレートが関連付けられているテーマを示します。

「テンプレート・クラス」は、そのテンプレートに固有の用途を示します。新しいテーマに切り替えると、あるテーマのすべてのテンプレートは、別のテーマの対応するテンプレートにマップされます。アプリケーション・ビルダーは、テンプレート・クラスの割当てによってこのテンプレート・マッピングを行います。

「翻訳可能」チェック・ボックスを使用して、対象のテンプレートに翻訳が必要なテキスト文字列が含まれているかどうかを示します。

「テンプレート・タイプ」はページ・テンプレート・タイプを指定します。「ダイアログ・ページ」に設定すると、そのテンプレートを選択できるのは、ページ・モードが「モーダル」または「非モーダル」のページのみになります。「標準ページ」に設定すると、そのテンプレートを選択できるのは、ページ・モードが「標準」のページのみになります。

関連項目:

ダイアログ・ページの作成および必須のダイアログ・ページ・テンプレート属性

11.3.14.1.2 定義

各テンプレートは、ヘッダー、ボディ、フッターおよびサブテンプレートで構成されます。動的コンテンツを含めるには、置換文字列を使用します。テンプレートのすべての置換文字列は、大文字で指定し、シャープ記号(#)で囲む必要があります。

ヒント:

サポートされている置換文字列のリストおよび例は、フィールドレベル・ヘルプを参照してください。

定義属性は次のとおりです。

- ヘッダー: HTMLドキュメントの<Head>セクションを定義するHTMLを入力します。このテンプレート・セクションには、少なくとも#TITLE#および#HEAD#を含めることをお薦めします。

- ボディ: HTMLドキュメントの<Body>セクションを構成するHTMLを入力します。ボディ・コンテンツの配置場所および追加のリージョン位置を定義する置換文字列を含めます。

- フッター: ボディの後に表示する、ページ・テンプレートの3番目のセクションを定義するHTMLを入力します。

11.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コードを入力します。

11.3.14.1.4 カスケード・スタイル・シート

選択可能な属性は次のとおりです。

- ファイルURL - このページ・テンプレートにロードされるカスケード・スタイルシート・ファイルURLを入力します。各URLを新しい行に記述する必要があります。ファイルの縮小バージョンを指定する場合、置換文字列#MIN#を使用して、通常ページ・ビューのファイルURLに.minを含めたり、ページをデバッグ・モードで表示する場合は空の文字列を含めることができます。置換文字列#APP_VERSION#を使用すると、ファイルURLにアプリケーションのバージョンを含めることができます。ここに入力したファイルURLによって、テンプレート内の#TEMPLATE_CSS#置換文字列が置き換えられます。
スクリプトの開始タグや閉じタグを含めずに、ファイルURLのみを含めます。

- インライン - このページ・テンプレートに使用されるカスケード・スタイルシートのコードを入力します。重複を避け、ブラウザで静的ファイルをキャッシュするため、外部ファイルに挿入することを検討してください。ここに入力したコードによって、テンプレート内の#TEMPLATE_CSS#置換文字列が置き換えられます。
開始スタイル・タグや閉じスタイル・タグを含めずに、カスケード・スタイルシートのコードのみを含めます。

11.3.14.1.5 サブテンプレート

次のサブテンプレートのHTMLを入力します。サブテンプレートは、置換文字列を使用してページ・テンプレートのボディ内に配置されます。

サブテンプレートは次のとおりです。

- 成功メッセージ - テンプレート・ボディ、ヘッダー、フッター内の文字列#SUCCESS_MESSAGE#を置換するHTMLを入力します。

- ナビゲーション・バー - テンプレート・ヘッダー、ボディ、フッター内の文字列#NAVIGATION_BAR#を置換するHTMLまたはテキストを入力します。置換文字列#BAR_BODY#を使用して、ナビゲーション・バーにエントリが表示される位置を指定します。

- ナビゲーション・バー・エントリ - 各ナビゲーション・バー・エントリのナビゲーション・バー#BAR_BODY#置換文字列に置換されるHTMLまたはテキストを入力します。

- 通知 - #NOTIFICATION_MESSAGE#置換文字列が、テンプレートのヘッダー、ボディまたはフッターで参照される際に置換されるHTMLまたはテキストを入力します。

11.3.14.1.6 イメージ・ベースのタブ属性

このサブテンプレートは、完全にイメージに基づくタブに使用します。選択可能な属性は次のとおりです。

- カレント・イメージ・タブ - イメージベースのタブが現在選択されていることを示すために使用するHTMLを入力します。タブに表示される名前を示す#TAB_TEXT#置換文字列を含めます。

- 非カレント・イメージ・タブ - イメージ・タブが現在選択されていないことを示すために使用するHTMLを入力します。タブに表示される名前を示す#TAB_TEXT#置換文字列を含めます。

11.3.14.1.7 レイアウト

ページで使用するレイアウトのタイプを指定します。選択したタイプによって、表示される属性が決まります。属性の詳細は、フィールドレベル・ヘルプを参照してください。

「タイプ」から、レイアウトを選択します。

- HTML表: HTML表を使用して、リージョン、ページ・アイテムおよびボタンを配置します。

- 固定列数: 画面を固定のグリッド列数で分割するグリッドに使用します。

- 可変列数: リージョン、ページ・アイテムおよびボタンの配置方法に応じて、グリッド列を最大n列まで表示できるグリッドに使用します。

11.3.14.1.8 表示ポイント

選択可能な属性は次のとおりです。

- ブレッドクラム表示ポイント - ブレッドクラムを使用する生成済コンポーネントに適用されます。ブレッドクラムが配置されるページ上の位置を定義します。サイドバー表示ポイント

- サイドバー表示ポイント - サイドバーを使用する生成済コンポーネントに適用されます。サイドバーが配置されるページ上の位置を定義します。

11.3.14.1.9 ダイアログ

ダイアログ属性は、「テンプレート・タイプ」に「ダイアログ・ページ」を選択した場合にのみ表示されます。これらの設定は、ページ・レベルで指定された類似の属性によって上書きされます。

選択可能なダイアログ属性は次のとおりです。

- 幅 - ダイアログの幅をピクセル単位または比率で入力します。

- 高さ - ダイアログの高さをピクセル単位で入力します(たとえば、500)。

- 最大幅 - ダイアログの最大幅をピクセル単位で入力します。jQuery Mobileスマートフォン・ユーザー・インタフェースを使用しているページの場合、最大幅は500です。

- CSSクラス - ダイアログに適用する追加のCSSクラスを、空白区切りのリストとして入力します。

- フレームへの埋込みを許可 - ページ・テンプレート・レベルのブラウザ・フレーム・オプションが、各オプションの現在の設定とともに下に示されます。ブラウザでアプリケーションのページをフレーム内に表示できるかどうかを選択します。現在の設定が、このページ・テンプレートを使用する各モーダルおよび非モーダル・ページのデフォルトです。詳細は、フィールドレベル・ヘルプを参照してください。
Oracle Application Expressは、iframeにモーダル・ダイアログを埋め込みます。アプリケーション・セキュリティ属性ブラウザ・フレームを「拒否」に設定する場合、「モーダル・ダイアログ」の「フレームへの埋込みを許可」を選択すると、かわりにこのテンプレートを使用するダイアログ・ページの「同じ起点から許可」が使用されます

関連項目:

必須のダイアログ・ページ・テンプレート属性

11.3.14.1.10 エラー・ページ・テンプレートの制御

ページ・テンプレートをエラー・テンプレートとして指定する場合は、この属性を使用します。

11.3.14.1.11 置換文字列

表 11-11に、使用可能なページ・テンプレートの置換文字列を示します。置換文字列は、サブテンプレート内でコンポーネント値を参照するために使用されます。

ヒント:

テンプレートのすべての置換文字列は、大文字で指定し、シャープ記号(#)で囲む必要があります。特定のテンプレートでサポートされる置換文字列のレポートを表示するには、ページ・テンプレートの編集ページの「置換文字列」セクションを参照してください。

表 11-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#

インライン・エラー・メッセージのサマリーが表示される位置を定義します。インライン・エラー・メッセージは、フィールドの横または通知領域にインライン(あるいはその両方)で表示できます。

ボディ

#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#">

ボディ

#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#

テーマ・スタイル・レベルで定義されているカスケード・スタイルシート・ファイル。

ページ

#FAVICONS#

アプリケーションのユーザー・インタフェース属性ファビコンのサポートを有効化します。開発者は、ファビコン(またはショートカット・アイコン)を作成するために、ファビコン属性を使用できます。この機能を使用するには、ページ・テンプレートに#FAVICONS#置換文字列が含まれている必要があります。

ページ

#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。

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要素)。

11.3.14.2 必須のダイアログ・ページ・テンプレート属性

ダイアログ・ページ・テンプレートを作成するには、表11-12に示すページ・テンプレート属性を定義する必要があります。

表11-12 ダイアログ・ページ・テンプレートの必須属性

属性

説明

名前、テンプレート・タイプ

「ダイアログ・ページ」として定義する必要があります。

JavaScript、ダイアログ初期化コード

ダイアログとしてページを初期化するJavaScriptコードを入力します。ファンクション・コール構文は、フィールドレベル・ヘルプを参照してください。

JavaScript、ダイアログ・クロージャ・コード

ダイアログ・ページを閉じるJavaScriptコードを入力します。ファンクション・コール構文は、フィールドレベル・ヘルプを参照してください。

JavaScript、ダイアログ取消コード

ダイアログ・ページを取り消すJavaScriptコードを入力します。ファンクション・コール構文は、フィールドレベル・ヘルプを参照してください。

ダイアログ、幅

ダイアログのデフォルトの幅を設定します。ページ・テンプレート・レベルの設定は、ページ・レベルで上書きできます。

ダイアログ、高さ

ダイアログのデフォルトの高さを設定します。ページ・テンプレート・レベルの設定は、ページ・レベルで上書きできます。

ダイアログ、最大幅

ダイアログの最大幅をピクセル単位で設定します。ページ・テンプレート・レベルの設定は、ページ・レベルで上書きできます。

ダイアログ、CSSクラス

ダイアログに適用する追加のCSSクラスを入力します。ページ・テンプレート・レベルの設定は、ページ・レベルで上書きできます。

ダイアログ、フレームへの埋込みを許可

この属性を使用してブラウザでアプリケーションのページをフレーム内に表示できるかどうかを制御するページ・モードを選択します。Application Expressは、iframeにモーダル・ダイアログを埋め込みます。アプリケーション・セキュリティ属性ブラウザ・フレームを「拒否」に設定する場合、「モーダル・ダイアログ」の「フレームへの埋込みを許可」を選択すると、かわりにこのテンプレートを使用するダイアログ・ページの「同じ起点から許可」が使用されます。

関連項目:

ダイアログ・ページの作成およびページ・テンプレート属性

11.3.15 ポップアップLOVテンプレート

ポップアップLOVテンプレートは、POPUPとして定義したすべてのアイテムに対するポップアップ・リストの表示方法を制御します。ポップアップLOVテンプレートは、各テーマに1つのみ指定できます。

トピック:

- ポップアップLOVテンプレート属性

関連項目:

アプリケーション・レベルでのLOVの作成およびテーマの使用

11.3.15.1 ポップアップLOVテンプレート属性

関連項目:

テーマのサブスクリプションの理解

この項では、ポップアップLOVテンプレートの編集ページの一部のセクションについて説明します。属性の詳細は、フィールドレベル・ヘルプを参照してください。

トピック:

- 検索フィールド

- ボタン

- ウィンドウ

- ページ区切り

- 結果セット

- ページ属性

11.3.15.1.1 検索フィールド

これらの属性を使用して、「検索」フィールドの表示方法を指定します。表 11-13に、使用可能な検索フィールドの属性を示します。

表 11-13 検索フィールドの属性

属性

説明

フィールド・テキストの前

ポップアップLOVの検索フィールドを表示する前に表示するテキストを定義します。

フィールド・テキストの後

検索フィールド、検索ボタンおよび閉じるボタンを表示した後にこのテキストを表示します。

フィルタ幅

この幅を使用して、HTML INPUT TYPE = TEXTウィジェットを表示します。

フィルタ最大幅

この最大幅を使用して、HTML INPUT TYPE = TEXTウィジェットを表示します。

フィルタ・テキスト属性

これらの属性を使用して、HTML INPUT TYPE = TEXTウィジェットを表示します。これは、HTML入力タグ内に含まれます。

11.3.15.1.2 ボタン

これらの属性を使用して、ボタン名および「検索」、「閉じる」、「次へ」および「戻る」ボタンの属性を定義します。

11.3.15.1.3 ウィンドウ

JavaScriptを使用してポップアップLOVが実行されます。これらの属性を使用して、scrollbars=、resizable=、width=およびheight=の値を制御します。

11.3.15.1.4 ページ区切り

行カウント結果の表示方法を定義します。

11.3.15.1.5 結果セット

これらの属性を使用して、結果セットの前後に表示するテキストまたはHTMLを定義します。

11.3.15.1.6 ページ属性

これらの属性を使用してポップアップ・ページを定義します。

11.3.16 リージョン・テンプレート

関連項目:

テンプレート・オプションの理解およびテーマのサブスクリプションの理解

リージョン・テンプレートは、リージョン属性の外観と配置を制御します。#BODY#や#EDIT#などの置換文字列を使用してリージョン属性を配置します。テンプレートの置換文字列は、大文字で指定し、シャープ記号(#)で囲む必要があります。

トピック:

- リージョン・テンプレート属性

関連項目:

リージョンについておよびテーマの使用

11.3.16.1 リージョン・テンプレート属性

関連項目:

テンプレート・オプションの理解およびテーマのサブスクリプションの理解

この項では、リージョン・テンプレートの編集ページの一部の属性について説明します。特定の属性の詳細は、フィールドレベル・ヘルプを参照してください。

トピック:

- 名前

- 定義

- レイアウト

- サブリージョン

- 置換文字列

11.3.16.1.1 名前

「テーマ」は、テンプレートが関連付けられているテーマを示します。「名前」は、テンプレートの名前を示します。

「テンプレート・クラス」は、そのテンプレートに固有の用途を示します。新しいテーマに切り替えると、あるテーマのすべてのテンプレートは、別のテーマの対応するテンプレートにマップされます。アプリケーション・ビルダーは、テンプレート・クラスの割当てによってこのテンプレート・マッピングを行います。テンプレートに翻訳が必要なテキスト文字列が含まれていることを示すには、「翻訳可能」チェック・ボックスを使用します。

11.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#

関連項目:

置換文字列の理解

11.3.16.1.3 レイアウト

ページ・アイテムは、リージョン内で表示されます。ページ・テンプレートのレイアウトが「表」に設定されている場合、各アイテムはHTML表に含まれます。この属性を使用して、この表の属性を設定します。

11.3.16.1.4 サブリージョン

「ヘッダー・テンプレート」および「ヘッダー・エントリ・テンプレート」を使用して、現在のリージョンにおけるすべてのサブリージョンのリージョン・タイトルのリストを生成します。どちらのテンプレートでも、必要な置換文字列は#ENTRIES#のみです。

「テンプレート」を使用して、サブリージョンを追加のHTMLコードでラップします。必要な置換文字列は#SUB_REGION#のみです。この置換文字列は、サブリージョンのソースの配置場所を示します。他のすべての置換文字列はオプションです。

11.3.16.1.5 置換文字列

コンポーネント値を参照するためにテンプレート内で使用される置換文字列を示します。

11.3.17 レポート・テンプレート

レポート列テンプレートによって、SQL問合せによって戻される1行の結果を制御できます。このタイプのテンプレートは、行全体ではなく、セルを定義します。

各レポート・テンプレートでは、#1#、#2#、#3#などの構文を使用して列名を識別します。#ENAME#や#EMPNO#などの列名の置換構文を使用して、列に名前を付けることもできます。アプリケーションのどのアイテムもテンプレート内で参照できます。たとえば、テンプレートのABC.というアイテムを参照するには、置換文字列&ABC.を正確に含めます。ABC.の実際の値は、ABCという名前のアプリケーションのアイテムを編集するエンド・ユーザーによって提供されます。

トピック:

- 汎用列テンプレートおよび名前付き列テンプレート

- 汎用列テンプレートのレポート列テンプレート属性

- 名前付き列テンプレートのレポート列テンプレート属性

- 列テンプレートでのJavaScriptの使用について

関連項目:

テーマの使用、テンプレート・オプションの理解およびテーマのサブスクリプションの理解

11.3.17.1 汎用列テンプレートおよび名前付き列テンプレート

Oracle Application Expressには、次の2種類のレポート・テンプレートが含まれています。

トピック:

- 汎用列テンプレート

- 名前付き列テンプレート

11.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

11.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>

11.3.17.2 汎用列テンプレートのレポート列テンプレート属性

ここでは、汎用列テンプレートのレポート・テンプレートの編集ページの特定のセクションについて説明します。特定の属性の詳細は、フィールドレベル・ヘルプを参照してください。

トピック:

- レポート・テンプレート

- 行の前

- 列ヘッダー

- 各行の前

- 列テンプレート

- 各行の後

- 行の後

- 行選択

- ページ区切りサブテンプレート

- コメント

11.3.17.2.1 レポート・テンプレート

「テンプレート名」は、テンプレートの名前を示します。「テンプレート・タイプ」には、テンプレートのタイプを指定します。名前付き列テンプレートは、テンプレートの列名を参照します。汎用列テンプレートは、テンプレートの#COLUMN_VALUE#置換文字列を参照します。

「テーマ」は、テンプレートが関連付けられているテーマを示します。 「テンプレート・クラス」は、そのテンプレートに固有の用途を示します。新しいテーマに切り替えると、あるテーマのすべてのテンプレートは、別のテーマの対応するテンプレートにマップされます。アプリケーション・ビルダーは、テンプレート・クラスの割当てによってこのテンプレート・マッピングを行います。テンプレートに翻訳が必要なテキスト文字列が含まれていることを示すには、「翻訳可能」チェック・ボックスを使用します。

11.3.17.2.2 行の前

「行の前」では、レポート・テンプレートの最初に1回表示するHTMLを入力します。

HTML表は、一般的に、次のようにこの属性を使用して開始します。

<table>

置換文字列#TOP_PAGINATION#を含めることによって、レポートの上部にページ区切りを含めることができます。この置換文字列は、開始タグ<tr>で始まり、閉じタグ</tr>で終わるHTMLを生成します。たとえば、表の開始タグと#TOP_PAGINATION#置換文字列を含めるには、次のように入力します。

<table>#TOP_PAGINATION#

また、置換文字列 #CSV_LINK#を使用すると、ほぼすべてのスプレッドシート・プログラムと互換性があるカンマ区切り値(CSV)形式にレポートをエクスポートできるようになります。

また、置換文字列#REPORT_ATTRIBUTES#を使用することもできます。この置換文字列は、レポート属性ページのレポート・リージョンごとに設定されます。

11.3.17.2.3 列ヘッダー

「列ヘッダーの前」を使用して、レポート・ヘッダーの前にテキストを表示します。

「列ヘッダー・テンプレート」を使用して、各列ヘッダーのセルをカラーにします。この属性のテキストには、セルのヘッダー・テキストをカラーにする位置を示すヘルプを含める必要があります。次に例を示します。

<th >Item Help Text</th>

列ヘッダーを使用しない場合は、次のように入力します。

OMIT

この属性を使用しない場合は、Application Expressエンジンによって、デフォルトの列ヘッダー・テンプレートが適用されます。

「列ヘッダーの後」を使用して、レポート・ヘッダーの後にテキストを表示します。

11.3.17.2.4 各行の前

「各行の前」では、レポートのすべての列の前に表示するテキストを入力します。この属性は、新しいHTML行を開始するために使用します。「各行の前」では、次の置換文字列をサポートします。

- #ROWNUM#
この置換文字列は、現行の行を指定するために使用します。

- #COLCOUNT#
この置換文字列は、列の数を指定するために使用します。

- #HIGHLIGHT_ROW#
この置換文字列は、ハイライトされた行の数を指定するために使用します。

11.3.17.2.5 列テンプレート

列テンプレートは、各列の外観を定義します。最大4つの列テンプレートを定義できます。各テンプレートは、条件付きにできます。たとえば、偶数行と奇数行に異なる背景色を指定したり、PL/SQLで定義した条件に一致する行をハイライトできます。

各列テンプレートでは、各列の外観を定義します。表11-14に、列テンプレートでサポートされる置換文字列を示します。

表 11-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

11.3.17.2.6 各行の後

「各行の後」には、レポートを表示する際にすべての列の後に表示するHTMLを入力します。多くの場合、この属性は、HTML表の行を閉じるために使用されます。次に例を示します。

</tr>

11.3.17.2.7 行の後

「行の後」を使用して、最後の行の後に表示するテキストを指定します。HTML表のタグは、一般的に、この属性を使用して閉じます。次に例を示します。

</table>

「行の後」属性は、次の置換文字列をサポートします。

- #PAGINATION#
ページ区切り属性で置換されます。

- #COLCOUNT#
実行時に、レポートで定義された列数に置換されます。

- #CSV_LINK#
CSVのエクスポートが有効な場合に、CSVダウンロード・リンクに実行時に置換されます。それ以外の場合、文字列は表示されません。

- #EXTERNAL_LINK#
実行時に、外部処理エンジン(PDFエクスポートなど)を使用するエクスポートのダウンロード・リンクに置換されます。この機能が有効でない場合、文字列は表示されません。

11.3.17.2.8 行選択

「チェックした行のバックグラウンド・カラー」では、行セレクタが選択されている場合のレポート行の背景色が制御されます。「カレント行のバックグラウンド・カラー」では、ユーザーがその行の上にマウスを移動した場合のレポート行の背景色を制御します。

11.3.17.2.9 ページ区切りサブテンプレート

「ページ区切りのサブテンプレート」セクションには、「ページ区切りテンプレート」、「次のページ・テンプレート」、「前のページ・テンプレート」、「次のセット・テンプレート」および「前のセット・テンプレート」を編集する属性が含まれています。ページ区切りのサブテンプレートは、置換文字列#PAGINATION_NEXT#、#PAGINATION_NEXT_SET#、#PAGINATION_PREVIOUS#および#PAGINATION_PREVIOUS_SET#をサポートしています。表11-17に、これらのテンプレートについて示します。

表 11-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>

11.3.17.2.10 コメント

この属性を使用して、このコンポーネントに関するコメントを記録します。

11.3.17.3 名前付き列テンプレートのレポート列テンプレート属性

ここでは、名前付き列テンプレートのレポート・テンプレートの編集ページの特定のセクションについて説明します。ページの各セクションにアクセスするには、ページをスクロール・ダウンするか、ページ上部のナビゲーション・ボタンをクリックします。ページ上部のボタンを選択すると、選択されたセクションが表示され、その他のセクションはすべて一時的に非表示になります。ページのすべてのセクションを表示するには、「すべて表示」をクリックします。

トピック:

- 名前

- サブスクリプション

- 行テンプレート

- 列ヘッダー

- 最初の前および最後の後のテキスト

- ページ区切り

- コメント

11.3.17.3.1 名前

「テンプレート名」は、テンプレートの名前を示します。「テンプレート・タイプ」には、テンプレートのタイプを指定します。名前付き列テンプレートは、テンプレートの列名を参照します。汎用列テンプレートは、テンプレートの#COLUMN_VALUE#置換文字列を参照します。

「テーマ」は、テンプレートが関連付けられているテーマを示します。テンプレートに翻訳が必要なテキスト文字列が含まれていることを示すには、「翻訳可能」チェック・ボックスを使用します。「テンプレート・クラス」は、そのテンプレートに固有の用途を示します。新しいテーマに切り替えると、あるテーマのすべてのテンプレートは、別のテーマの対応するテンプレートにマップされます。アプリケーション・ビルダーは、テンプレート・クラスの割当てによってこのテンプレート・マッピングを行います。

11.3.17.3.2 サブスクリプション

「サブスクリプション」を使用して、カレント・アプリケーションに既存のテンプレートを適用します。既存のテンプレートを選択すると、ユーザーはそのテンプレートのサブスクライバになります。

マスター・テンプレートの新しいコピーをロードするには、「リフレッシュ」をクリックします。

11.3.17.3.3 行テンプレート

行テンプレートは、各行の外観を定義します。最大4つの行テンプレートを定義できます。各テンプレートは、条件付きにできます。

各行テンプレートでは、各行の外観を定義します。表11-16に、行テンプレートでサポートされる置換文字列を示します。

表 11-16 行テンプレートの置換文字列

置換文字列

説明

#ALIGNMENT#

行の位置合せを指定します。ユーザーが指定します。

#COLCOUNT#

列数のカウントを定義します。

#COLNUM#

現在の列番号を定義します。

#COLUMN_HEADER#

列ヘッダーを定義します。

#COLUMN_VALUE#

列の値に置換されます。

#ROWNUM#

現在の行番号を指定します。

条件を作成すると、指定した条件に一致するかどうかによって行の表示が異なるレポートを作成できます。条件付きで使用される行テンプレートを指定するには、列テンプレートの条件リストから条件タイプを選択します。有効な値は、次のとおりです。

- PL/SQL式に基づく使用: その行のデータに基づき、条件付きで列を書式化します。

- 偶数行で使用:偶数行を条件付きで書式化します。

- 奇数行で使用:奇数行を条件付きで書式化します。

「PL/SQL式に基づく使用」を選択する場合は、次に列テンプレートの式フィールドでPL/SQL式を入力します。たとえば、次の式で値が2000より大きい場合、その値を太字で表示します。

#SAL# > 2000

置換文字列#ROWNUM#を使用することもできます。次に例を示します。

#ROWNUM# > 2000

11.3.17.3.4 列ヘッダー

各列ヘッダーのセルに色を追加するには、このテンプレートを使用します。この属性のテキストには、セルのヘッダー・テキストをカラー化する位置を指定する必要があります。「列ヘッダー・テンプレート」を入力しない場合は、デフォルトの列ヘッダー・テンプレートが適用されます。列ヘッダーを使用しない場合は、OMITを入力します。次に例を示します。

<th #ALIGNMENT#>#COLUMN_HEADER#</th>

11.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#
実行時に、レポートで定義された列数に置換されます。

11.3.17.3.6 ページ区切り

「ページ区切り」セクションには、「ページ区切りテンプレート」、「次のページ・テンプレート」、「前のページ・テンプレート」、「次のセット・テンプレート」および「前のセット・テンプレート」を編集する属性が含まれています。ページ区切りのサブテンプレートは、置換文字列#PAGINATION_NEXT#、#PAGINATION_NEXT_SET#、#PAGINATION_PREVIOUS#および#PAGINATION_PREVIOUS_SET#をサポートしています。表11-17に、これらのテンプレートについて示します。

表 11-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>

11.3.17.3.7 コメント

この属性を使用して、このコンポーネントに関するコメントを記録します。

11.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>" );

関連項目:

リージョンについて

11.4 カスタム・カスケード・スタイルシートの使用

カスケード・スタイルシート(CSS)によって、構造を変更せずにWebページのスタイルを制御できます。CSSを適切に使用すると、カラー、余白、フォントなどの視覚属性がHTMLドキュメントの構造から切り離されます。Oracle Application Expressのテーマには、独自のCSSを参照するテンプレートを含めることができます。特定のテーマの各CSSで定義されたスタイル・ルールによって、レポートおよびリージョンの表示も指定されます。

ヒント:

アプリケーションでユニバーサル・テーマ - 42を使用する場合、テーマ・スタイルを利用し、テーマ・ローラーでアプリケーションの外観を更新することもできます。テーマ・スタイルの使用およびテーマ・ローラーの使用を参照してください。

トピック:

- カスケード・スタイルシートのアップロードについて

- ページ・テンプレートのアップロードされたカスケード・スタイルシートの参照

11.4.1 カスケード・スタイルシートのアップロードについて

ワークスペース内の特定のアプリケーションで使用するために、またはすべてのアプリケーションで使用するために、ファイル(CSSファイルを含む)をアップロードできます。詳細は、静的アプリケーション・ファイルの管理および静的アプリケーション・ファイルの管理を参照してください。

関連項目:

ページ・テンプレートのアップロードされたカスケード・スタイルシートの参照

11.4.2 ページ・テンプレートのアップロードされたカスケード・スタイルシートの参照

ページ・テンプレートのヘッダー・セクション内でアップロードされたカスケード・スタイルシートを参照できます。ヘッダー・セクションを使用して、HTMLドキュメントの<HEAD>セクションを構成するHTMLを入力します。

アップロードされたカスケード・スタイルシートを参照するには、次のステップを実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「ユーザー・インタフェース」で、「テーマ」を選択します。

テーマ・ページが表示されます。

5. テーマを選択します。

6. 「タスク」リストで、「テンプレートの表示」をクリックします。

7. 編集するページ・テンプレートの名前を選択します。

8. 「ヘッダー」セクション内の<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」

12 ページ・レイアウトの制御

開発者は、グローバル・ページの使用、リージョンのカスタマイズおよびアイテム属性の編集によって、データベース・アプリケーションのページ・レイアウトをカスタマイズできます。この項では、イメージおよび静的ファイルを管理する方法と、カスタムPOL/SQLを使用してHTMLをレンダリングする方法についても説明します。

トピック:

- Oracle Application Expressのページ・レイアウトについて

- 印刷用ページの最適化

- すべてのページにコンポーネントを表示するグローバル・ページの作成

- リージョンについて

- ページ・デザイナでのリージョンの管理

- レガシー・コンポーネント・ビューでのリージョンの管理

- 他のWebサイトからのコンテンツの組込みについて

- イメージの管理について

- カスタムPL/SQLを使用したHTMLのレンダリング

関連項目:

- 「ナビゲーションの追加」

- アプリケーションのユーザー・インタフェースの管理

- 「テーマおよびテーマ・スタイルの使用」

12.1 Oracle Application Expressのページ・レイアウトについて

Application Expressエンジンは、開発者によって定義されたアプリケーション・コンポーネントおよびデータベース内のデータをテンプレートと組み合せてページをレンダリングします。

全体的なフレームワーク(またはページの構造)は、ページ・テンプレートによって決まります。たとえば、ページ・テンプレートは、ページでタブおよびナビゲーション・バーを使用するかどうかを制御します。また、ページの左側にナビゲーションまたはセカンダリ・コンテンツ用のプレースホルダとして機能するバーを含めるかどうかを定義することもできます。さらに、ページ・テンプレートには、リージョン位置の定義を含めることができます。これによって、HTML表またはスタイルシート定義を使用してリージョンの位置を正確に制御できます。ページ・テンプレート自体は、置換文字列と組み合されたHTMLで構成され、これらの置換文字列は、実行時に適切なコンポーネントに置換されます。

開発者は、リージョンを作成することによってページにコンテンツを追加します。リージョンはページの領域で、コンテンツのコンテナとして機能します。各リージョンには、HTML、レポート、フォーム、チャート、リスト、ブレッドクラム、PL/SQL、ツリー、URL、カレンダなどの様々なコンテンツが含まれます。他のリージョンとの相対位置によって(順序番号および列に基づいて)、またはページ・テンプレートに定義されたリージョン位置を使用して、リージョンを配置します。リージョンのスタイルは、リージョン・テンプレートによっても制御されます。ページ・テンプレートと同様に、リージョン・テンプレートは、リージョンを表示するページ上の領域の構造を定義します。リージョン・テンプレートは、リージョン・タイトルを表示するかどうか、およびメイン・コンテンツ(ボディ)に対するリージョン・タイトルの相対的な表示位置を定義します。リージョンでは、ボタンの絶対位置を定義することもできます。

関連項目:

「テーマおよびテーマ・スタイルの使用」

12.2 印刷用ページの最適化

特定の印刷用テンプレートを作成し、テーマの作成/編集ページでそのテンプレートを選択することで、印刷用のページを最適化できます。一般に、印刷用テンプレートは、印刷用のページを最適化します。たとえば、印刷用テンプレートは、次のことを行います。

- タブまたはナビゲーション・バーを非表示にします。

- アイテムをフォーム要素ではなくテキストとして表示します

選択したテーマに印刷用テンプレートが含まれていない場合、新しいページ・テンプレートを作成することによって印刷用テンプレートを作成できます。

トピック:

- アプリケーションの印刷用テンプレートの選択

- f?p構文を使用した印刷用モードへの切替え

関連項目:

テーマの編集およびテーマの作成

12.2.1 アプリケーションの印刷用テンプレートの選択

印刷用テンプレートを選択するには、次のステップを実行します。

1. テーマ・ページにナビゲートします。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. 「共有コンポーネント」をクリックします。

d. 「ユーザー・インタフェース」で、「テーマ」を選択します。

テーマ・ページが表示されます。

2. テーマを選択します。

3. 「コンポーネントのデフォルト値」までスクロールします。

4. 「「印刷用」ページ」リストから選択します。

5. 変更内容を確認して、「変更の適用」をクリックします。

関連項目:

テーマの編集

12.2.2 f?p構文を使用した印刷用モードへの切替え

印刷用テンプレートを作成して選択した後、f?p構文を使用して印刷用モードに切り替えることができます。f?p構文の9番目の引数(PrinterFriendly)を指定すると、ページが印刷用(印刷用に最適化された)モードでレンダリングされます。たとえば、リンクのコーディング時、またはナビゲーション・バー・アイコンの作成時に、この引数を含めることができます。

関連項目:

f?p構文を使用したページのリンクについて

12.3 すべてのページにコンポーネントを表示するグローバル・ページの作成

グローバル・ページ(以前はページ0と呼ばれていた)は、マスター・ページとして機能します。開発者は、各ユーザー・インタフェースに、個別のグローバル・ページを作成できます。Application Expressエンジンは、アプリケーション内の各ページの「グローバル」ページに追加したすべてのコンポーネントをレンダリングします。Application Expressエンジンでコンポーネントをレンダリングするか、または条件を定義することで計算、検証またはプロセスを実行するかを制御することもできます。

トピック:

- グローバル・ページの作成

- グローバル・ページへのナビゲート

関連項目:

データベース・アプリケーションのページの管理、条件付きのレンダリングおよびプロセスの理解および使用可能な条件

12.3.1 グローバル・ページの作成

グローバル・ページを作成するには、次の手順を実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。

2. アプリケーションを選択します。
アプリケーションのホームページが表示されます。

3. 「ページの作成」ボタンをクリックします。

4. 「ページの作成」で、次のステップを実行します。

a. ユーザー・インタフェース: ページのユーザー・インタフェースを選択します。

b. ページ・タイプの選択 - 「グローバル・ページ」を選択します。
アプリケーションに指定したユーザー・インタフェースの「グローバル」ページがない場合にのみ、「グローバル・ページ」オプションが表示されることに注意してください。

5. 「ページ番号」で、アプリケーション内のページを識別する整数値を入力します。

6. 「終了」をクリックします。

関連項目:

アプリケーションのユーザー・インタフェースの管理

12.3.2 グローバル・ページへのナビゲート

「グローバル」ページへナビゲートするには、次の手順を実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

アプリケーション・ビルダーのホームページが表示されます。

2. アプリケーションを選択します。

アプリケーションのホームページが表示されます。

3. 「グローバル・ページ」(より古いアプリケーションの場合は「ページ0(ゼロ)」)を選択します。

12.4 リージョンについて

Oracle Application Expressアプリケーションの各ページに、1つ以上のリージョンが含まれます。リージョンはページ上の領域で、コンテンツのコンテナとして機能します。各ページには任意の数のリージョンを配置できます。特定のリージョン・テンプレートによってリージョンの外観を制御できます。リージョン・テンプレートでは、リージョンの外観およびサイズの制御、枠線または背景色を使用するかどうかの指定、表示するフォントの決定を行います。また、リージョン位置に配置されるボタンの標準配置も制御します。

リージョンを使用して、ページ・コントロール(アイテムやボタンなど)をグループ化できます。追加のHTMLを生成しない単純なリージョンを作成したり、HTML表やイメージ内でコンテンツを形成する詳細なリージョンを作成できます。

リージョンはページ・テンプレート・ボディに順次表示されるか、またはリージョン位置に明示的に配置できます。ページ構造を定義するには、HTML表または今日より一般的なDIVタグを使用します。

関連項目:

- 「ページ・デザイナでのリージョンの管理」

- 「レガシー・コンポーネント・ビューでのリージョンの管理」

- ページ固有のユーティリティへのアクセス

12.5 ページ・デザイナでのリージョンの管理

リージョンはコンテンツのコンテナとして機能します。Oracle Application Expressアプリケーションの各ページに、1つ以上のリージョンが含まれます。

トピック:

- ページ・デザイナでのリージョンの作成

- ページ・デザイナでのリージョンの管理

- ページ・デザイナでのリージョンのコピー

- ページ・デザイナでのリージョンの削除

関連項目:

リージョンについておよびレガシー・コンポーネント・ビューでのリージョンの管理

12.5.1 ページ・デザイナでのリージョンの作成

ヒント:

ページ・デザイナ・ツールバーから、フォーム・リージョンを作成することも、ブレッドクラム・リージョンを作成することもできます。ページ・デザイナ・ツールバーで、「作成」メニューをクリックして「フォーム・リージョン」または「ブレッドクラム・リージョン」を選択します。

ページ・デザイナでリージョンを作成するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. ページを選択します。

ページ・デザイナが表示されます。

2. 中央ペインの下部にあるギャラリで、作成するリージョン・タイプを探します。コントロールまたはコンポーネントにカーソルをあわせると、それについて説明するツールチップが表示されます。

ヒント:

ギャラリからコンポーネントをドラッグ・アンド・ドロップする以外に、ギャラリでコンポーネントを右クリックしてコンテキスト・メニューを表示することもできます。「追加先」を選択して、コンポーネントを追加する位置を選択します。

3. 作成されるリージョン上でマウスをクリックしたまま、「レイアウト」タブの目的の位置にドラッグします。

適切な位置にマウスが配置されると、「レイアウト」タブが暗い黄色の四角形として表示されます。マウスを離して、コンポーネントをドロップします。コンポーネントは、コンポーネント・タイプによって決定される適切なドロップ位置にのみドロップできます。

追加するコンポーネント・タイプに基づいて、ページ・デザイナが次に必要な操作を示します。「メッセージ」タブに、対処する必要があるメッセージの数を示した赤または黄色のバッジが表示されます。

4. プロパティ・エディタで該当する属性を編集します。

ヒント:

属性のヘルプを表示するには、プロパティ・エディタで属性を選択し、中央ペインで「ヘルプ」タブをクリックします。

5. 「保存」または「ページの保存と実行」をクリックします。

関連項目:

「「メッセージ」タブ」

12.5.2 ページ・デザイナでのリージョンの管理

リージョンとは、コンテンツのコンテナとしての役割を持つページ領域のことです。ページの外観を変更するには、リージョン属性を編集します。

トピック:

- ページ・デザイナでのリージョン属性の編集

- リージョン位置の制御

- リージョンのヘッダーおよびフッターの指定

- ユーザーによるページのカスタマイズの可能化

- ページ・デザイナでのリージョン・キャッシュの使用

- 静的リージョンIDの指定

- リージョン・イメージの追加

- リージョン表示セレクタの作成

12.5.2.1 ページ・デザイナでのリージョン属性の編集

リージョン属性を編集するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. ページを選択します。

ページ・デザイナが表示されます。

2. 「レンダリング」タブで、リージョンを選択します。

プロパティ・エディタの右ペインにリージョン属性が表示されます。

属性は、機能グループに編成されます。これらのグループを展開または縮小するには、「共通の表示」、「すべて表示」、「すべて閉じる」および「すべて開く」アイコンをクリックします。

3. プロパティ・エディタですべての属性を表示します。左ペイン上部の「すべて表示」アイコンをクリックします。

4. プロパティ・エディタで該当する属性を編集します。

属性の詳細は、フィールドレベル・ヘルプを参照してください。

5. 変更を保存するには、「保存」をクリックします。ページを保存して実行するには、「ページの保存と実行」をクリックします。

関連項目:

ページ・デザイナの右ペイン(プロパティ・エディタ)

12.5.2.2 リージョン位置の制御

リージョンを作成するとき、プロパティ・エディタで「レイアウト」の「位置」属性を編集することにより、その位置を指定できます。ページのユーザー・インタフェースの現在のテーマ内で定義されているテンプレート位置によって、使用可能な選択肢が決まります。

12.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

12.5.2.4 ユーザーによるページのカスタマイズの可能化

「カスタマイズ」属性を使用すると、リージョンの表示属性をユーザーがカスタマイズできるかどうかを制御できます。この機能を使用するには、ページ・テンプレートのヘッダー、ボディまたはフッター・セクションに#CUSTOMIZE#置換文字列を含める必要があります。

エンド・ユーザーによるカスタマイズが1つ以上のリージョンでサポートされる場合、「カスタマイズ」リンクがページ・テンプレートで#CUSTOMIZE#置換文字列を含めた場所に表示されます。このリンクをクリックするとウィンドウが表示され、ユーザーは、ページのリージョンを表示または非表示にできます。

エンド・ユーザーのカスタマイズを有効化するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. ページを選択します。

ページ・デザイナが表示されます。

2. 「レンダリング」タブまたは「レイアウト」タブで、リージョンを選択します。

プロパティ・エディタに、リージョンの属性が表示されます。

3. 「カスタマイズ」を見つけます。「カスタマイズ」で次のいずれかを選択します。

- エンドユーザーではカスタマイズ不可

- デフォルトでカスタマイズ可能および非表示

- デフォルトでカスタマイズ可能および表示

4. 「保存」をクリックします。

関連項目:

カスタム・テーマの作成

12.5.2.5 ページ・デザイナでのリージョン・キャッシュの使用

リージョン・キャッシュの有効化は、条件を使用しないリストを含むリージョンまたは静的HTMLを含むリージョンなどの静的リージョンのパフォーマンスの向上に効果的な方法です。

ヒント:

リージョン・キャッシュは、対話モード・レポート・リージョンに対しては使用できません。

トピック:

- リージョン・キャッシュについて

- ページ・デザイナでのリージョン・キャッシュの有効化

関連項目:

『Oracle Application Express管理ガイド』のページおよびリージョン・キャッシュの管理に関する項

12.5.2.5.1 リージョン・キャッシュについて

リージョン・キャッシュの有効化は、条件を使用しないリストを含むリージョンまたは静的HTMLを含むリージョンなどの静的リージョンのパフォーマンスの向上に効果的な方法です。

リージョン・キャッシュを有効化すると、Application Expressエンジンによって、リージョンを動的にレンダリングするかわりにキャッシュされた(または格納された)リポジトリからリージョンをレンダリングします。実際のセッション識別子はキャッシュされないことに注意してください。かわりに、Application Expressエンジンでは、&SESSION.置換文字列がキャッシュされ、キャッシュされたリージョンをレンダリングしたカレント・セッションが表示時に代入されます。たとえば、リージョンにリンクが含まれ、リンクにセッションが含まれる場合、リンクがすべてのセッションで動作するようにするため、完全なセッションはキャッシュされません。

Application Expressエンジンは、リージョンが定義した条件を満たす場合にのみキャッシュからレンダリングします。また、リージョンは、ユーザーまたはキャッシュされた独立したユーザーに対してのみキャッシュできます。

関連項目:

サーバー・キャッシュ

12.5.2.5.2 ページ・デザイナでのリージョン・キャッシュの有効化

リージョン・キャッシュを有効化するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. ページを選択します。

ページ・デザイナが表示されます。

2. 「レンダリング」タブまたは「レイアウト」タブで、リージョンを選択します。

プロパティ・エディタにリージョン属性が表示されます。

3. プロパティ・エディタですべての属性を表示するには、「すべて表示」をクリックします。

4. 「サーバー・キャッシュ」を展開します。「キャッシュ」で、次のいずれかを選択します。

- 無効 - コンテンツはキャッシュされず、リクエストごとに計算されます。

- 有効 - コンテンツはキャッシュされ、すべてのユーザーによって利用されます。

- ユーザー別のキャッシュ - コンテンツはユーザーごとにキャッシュされます。

- セッション別のキャッシュ - コンテンツはセッションごとにキャッシュされます。

5. 「保存」をクリックします。

12.5.2.6 静的リージョンIDの指定

カスタムJavaScriptまたはカスケード・スタイルシートの作成時に静的リージョンIDを指定すると有用です。リージョンの編集ページの「静的ID」属性を使用して、リージョンを一意に識別できます。リージョン・テンプレート、ヘッダー、フッターまたはボディの#REGION_STATIC_ID#置換文字列を使用してリージョンを参照できます。

静的リージョンIDを含めるには、HTML要素IDとしてリージョン・コンテナ・オブジェクト(表またはDIV)に割り当てます。HTML要素のIDはページ全体で一意である必要があります。たとえば、ページHTMLを有効にしておくため、ボタンとリージョンのIDを同じにすることはできません。

静的リージョンIDを指定するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. ページを選択します。

ページ・デザイナが表示されます。

2. 「レンダリング」タブまたは「レイアウト」タブで、リージョンを選択します。

プロパティ・エディタにリージョン属性が表示されます。

3. プロパティ・エディタですべての属性を表示するには、「すべて表示」をクリックします。

4. 「詳細」を探します。静的ID属性を編集します。

a. 「詳細」で「静的ID」を見つけます。

b. 「静的ID」に、このリージョンの静的IDを入力します。定義されている場合、これが置換文字列#REGION_STATIC_ID#でリージョンのIDとして使用され、リージョンのカスタムJavaScript動作を開発する際に役立ちます。これが定義されていない場合、リージョンによって内部IDが生成されます。

ヒント:

入力した静的IDをリージョンで使用するには、テンプレートに#REGION_STATIC_ID#置換文字列が含まれている必要があります。

5. 「保存」をクリックします。

12.5.2.7 リージョン・イメージの追加

「リージョン・イメージ」および「イメージ・タグ属性」を使用すると、リージョンの左上にイメージを追加できます。

リージョン・イメージを追加するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. ページを選択します。

ページ・デザイナが表示されます。

2. 「レンダリング」タブまたは「レイアウト」タブで、リージョンを選択します。

プロパティ・エディタにリージョン属性が表示されます。

3. 「詳細」を探します。次の属性を編集します。

- リージョン・イメージ - リージョンの左上に表示されるイメージへの参照を入力します。このイメージの表示に使用される表タグを制御することはできません。

- イメージ・タグ属性 - イメージHTMLに含めるイメージ・タグ属性を入力します。これは、高さ、幅またはイメージのALTテキスト(装飾的なイメージではない場合)などの属性に使用できます。
イメージ・タグ属性にALTが定義されていない場合、Application Expressはデフォルトで装飾的なイメージとしてイメージをレンダリングします(空のALTタグなど)。

4. 「保存」をクリックします。

12.5.2.8 リージョン表示セレクタの作成

「リージョン表示セレクタ」リージョンでは、ページの各リージョンに表示と非表示のコントロールを表示できます。

リージョン表示セレクタを作成するには、次のステップを実行します。

1. リージョン・ページ・セレクタに含めるページおよびリージョンを作成します。

2. セレクタに含める各リージョンで、「リージョン表示セレクタ」属性を「はい」に設定します。

3. ギャラリで、「リージョン表示セレクタ」リージョンを右クリックして「追加先」を選択し、適切な位置を選択します。

ヒント:

ギャラリからドラッグ・アンド・ドロップすることもできます。ギャラリから、「リージョン表示セレクタ」リージョンを選択して、「レイアウト」タブの適切な位置にドラッグします。

4. プロパティ・エディタでリージョン属性を編集します。

a. 指定、タイトル - リージョン・タイトルを入力します。リージョン・タイトルは、リージョン・テンプレートに定義されている場合にのみ表示されます。

b. 詳細、リージョン表示セレクタ - このリージョンをリージョン表示セレクタに含める場合、「はい」を選択します。この属性は、リージョン表示セレクタのリージョン・タイプが定義されてページ上に表示できる場合にのみ使用されます。

ヒント:

属性の詳細は、プロパティ・エディタで属性を選択し、中央ペインで「ヘルプ」タブをクリックして、参照してください。

5. 「保存」をクリックします。

12.5.3 ページ・デザイナでのリージョンのコピー

注意:

「ツリー」タイプのリージョンには複数のリージョンが含まれるため、コピーできません。

リージョンをコピーするには、次のステップを実行します。

1. ページ・デザイナでページを表示します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. ページを選択します。

ページ・デザイナが表示されます。

2. 「レイアウト」タブでリージョンを右クリックし、「コピー先」を選択して、サブメニューからコピー先を選択します。

ヒント:

リージョンを別のページにコピーするには、「レンダリング」タブでリージョンを選択し、右クリックして「他のページにコピー」を選択します。画面に表示されるステップに従います。

12.5.4 ページ・デザイナでのリージョンの削除

リージョンを削除するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. ページを選択します。

ページ・デザイナが表示されます。

2. 「レンダリング」タブで1つ以上のリージョンを選択します。

3. 右クリックして「削除」を選択します。

4. 「保存」をクリックします。

12.6 レガシー・コンポーネント・ビューでのリージョンの管理

リージョンはコンテンツのコンテナとして機能します。Oracle Application Expressアプリケーションの各ページに、1つ以上のリージョンが含まれます。

トピック:

- リージョンの作成ウィザード実行時のリージョン・タイプ

- コンポーネント・ビューでのリージョンの作成

- コンポーネント・ビューでのリージョンの管理

- リージョン表示セレクタの作成

- コンポーネント・ビューでのリージョンのコピー

- コンポーネント・ビューでのリージョンの削除

関連項目:

リージョンの作成ウィザード実行時のリージョン・タイプ、リージョンについておよびページ・デザイナでのリージョンの管理

12.6.1 リージョンの作成ウィザード実行時のリージョン・タイプ

アプリケーションを作成するときに、ターゲット・ユーザー・インタフェースを選択します。選択したユーザー・インタフェースによって、使用可能なリージョン・タイプが決まります。

デスクトップ・アプリケーションのリージョン・タイプ

デスクトップ・アプリケーションを作成している場合、リージョンの作成ウィザードで次のリージョンがサポートされます。

表12-1 リージョンの作成ウィザード: デスクトップ・アプリケーションのリージョン・タイプ

リージョン・タイプ

説明

静的コンテンツ

アイテムのコンテナとして機能し、指定したHTMLが含まれます。入力するHTMLには、置換文字列を含めることができます。

複数の静的コンテンツ

複数の静的コンテンツ・リージョンを一度に作成するには、このオプションを使用します。表示されるフィールドで、各リージョンの順序、タイトル、表示ポイント、レポート・テンプレートおよび列を指定します。

レポート、対話モード・レポート

SQL問合せの結果がフォーマット化されます。カスタムSQL SELECT文またはSQL問合せ文を戻すPL/SQLファンクションを指定します。SQL問合せの記述が不明な場合は、「クエリー・ビルダー」ボタンをクリックします。

注意: jQuery Mobileスマートフォンは、対話モード・レポートをサポートしません。

関連項目: 「実行中のアプリケーションでの対話モード・レポートのカスタマイズ」

レポート、クラシック・レポート

SQL問合せの結果がフォーマット化されます。カスタムSQL SELECT文またはSQL問合せを戻すPL/SQLファンクションを指定します。SQL問合せの記述が不明な場合は、「クエリー・ビルダー」ボタンをクリックします。

関連項目: レポートの開発

レポート、Webサービスの結果

Webサービスの結果でレポートを作成します。

関連項目: Webサービスの実装

フォーム、プロシージャのフォーム

ストアド・プロシージャの引数に基づくフォームを構築します。ストアド・プロシージャまたはパッケージに実装済のロジックまたはデータ操作言語(DML)が存在する場合は、この方法を使用します。

フォーム、表またはビューのフォーム

データベース表の単一行を更新できるフォームを作成します。フォームを構築する表を選択できます。

フォーム、表のフォーム

2つのページを作成します。1つのページにはレポートが表示されます。各行に2ページ目へのリンクが提供され、これを使用して各レコードを更新できます。レポートおよびフォームを構築する表を選択できます。

ヒント: このオプションでは、127列を超える列が含まれている表はサポートされません。127列を超える列を選択すると、エラーが発生します。

フォーム、SQL問合せのフォーム

EQUIJOINなどのSQL問合せによって戻される列に基づくフォームを作成します。SQL問合せの記述が不明な場合は、「クエリー・ビルダー」をクリックします。

フォーム、Webサービスのフォーム

Webサービスの定義に基づいて、アイテムを含むページを作成します。このウィザードでは、ユーザー入力フォーム、Webサービスをコールするプロセスおよび送信ボタンを作成し、レポートに結果を表示します。

関連項目: Webサービスでの入力フォームとレポートの作成

プラグイン

開発者はプラグインを使用して、Application Expressで使用可能な組込みタイプを宣言的に拡張できます。

関連項目: プラグインの実装

チャート

SQL問合せに基づいて線グラフ、棒グラフまたは円グラフを作成します。

関連項目: レガシー・チャートの管理

マップ・チャート

宣言的に定義されたFlashマップを作成します。

関連項目: マップの作成

ツリー

実行時に実行されるSQL問合せに基づいて、階層的なナビゲーション・コントロール(またはツリー)を作成します。

関連項目: ツリーの作成

Calendar

月次、週次、日次およびリスト表示のカレンダを含むリージョンを作成します。

関連項目: カレンダの作成

リスト

リストと呼ばれるリンクの共有コレクションを含むリスト・リージョンを作成します。

関連項目: リストの作成

ブレッドクラム

ブレッドクラムを含むリージョンを作成します。ブレッドクラムはリンクの階層リストです。

関連項目: ブレッドクラムの作成

PL/SQL動的コンテンツ

PL/SQL WebツールキットでHTMLまたはテキストをレンダリングできるようにする、PL/SQLベースのリージョンを作成します。

URL

事前定義されたURLを使用してWebサーバーをコールすることでコンテンツを取得する、URLベースのリージョンを作成します。

関連項目: 他のWebサイトからのコンテンツの組込みについて

リージョン表示セレクタ

「リージョン表示セレクタ」リージョンでは、リージョン表示選択が有効化されている、ページの各リージョンに表示と非表示のコントロールを表示できます。

関連項目: リージョン表示セレクタの作成

ヘルプ・テキスト

「ヘルプ・テキスト」リージョンでは、アプリケーションにページ・レベルのヘルプを指定できます。

関連項目: アプリケーションのヘルプの作成

モバイル・アプリケーションのリージョン・タイプ

モバイル・アプリケーションを作成している場合、リージョンの作成ウィザードで次のリージョンがサポートされます。

表12-2 リージョンの作成ウィザード: モバイル・アプリケーションのリージョン・タイプ

リージョン・タイプ

説明

静的コンテンツ

アイテムのコンテナとして機能し、指定したHTMLが含まれます。入力するHTMLには、置換文字列を含めることができます。

複数の静的コンテンツ

複数の静的コンテンツ・リージョンを一度に作成するには、このオプションを使用します。表示されるフィールドで、各リージョンの順序、タイトル、表示ポイント、レポート・テンプレートおよび列を指定します。

レポート、クラシック・レポート

SQL問合せの結果がフォーマット化されます。カスタムSQL SELECT文またはSQL問合せを戻すPL/SQLファンクションを指定します。SQL問合せの記述が不明な場合は、「クエリー・ビルダー」ボタンをクリックします。

関連項目: レポートの開発

レポート、Webサービスの結果

Webサービスの結果でレポートを作成します。

関連項目: Webサービスの実装

レポート、リスト・ビュー

リスト・ビューは、スマートフォンでのデータ表示およびナビゲーション用に最適化されています。

SQL問合せの書式設定された結果を含むページを作成します。カスタムSQL SELECT文またはSQL問合せを戻すPL/SQLファンクションを指定します。

注意: デスクトップ・アプリケーションは、リスト・ビューをサポートしません。

レポート、列切替えレポート

モバイル・アプリケーションのレスポンシブなレポートを作成します。デフォルトでは、列切替えレポートはすべての列が同じ優先度に設定されて作成されます。ただし、開発者はレポート列属性を編集し、重要度に応じて列をランク付けできます。優先度がより低い列は、より狭い幅で表示されます。レポートには、エンド・ユーザーが表示する列を選択できる「列」ボタンが含まれています。

注意: デスクトップ・アプリケーションは、このレポート書式をサポートしません。

リフロー・レポート

モバイル・アプリケーションのレスポンシブなレポートを作成します。レポートを水平に表示できる十分な領域がない場合、レポートは、表の列を縮小して、各行に対するラベルやデータ・ペアのブロックのような外観の積上げ表示形式にすることによって機能します。

注意: デスクトップ・アプリケーションは、このレポート書式をサポートしません。

フォーム、プロシージャのフォーム

ストアド・プロシージャの引数に基づくフォームを構築します。ストアド・プロシージャまたはパッケージに実装済のロジックまたはデータ操作言語(DML)が存在する場合は、この方法を使用します。

フォーム、表またはビューのフォーム

データベース表の単一行を更新できるフォームを作成します。フォームを構築する表を選択できます。

フォーム、リスト・ビュー付きの表のフォーム

データベース表の単一行を更新できるフォームおよびリスト・ビューを作成します。フォームを構築する表を選択し、リスト・ビューのテキスト表示に使用する列を選択します。

フォーム、SQL問合せのフォーム

EQUIJOINなどのSQL問合せによって戻される列に基づくフォームを作成します。SQL問合せの記述が不明な場合は、「クエリー・ビルダー」をクリックします。

フォーム、サマリー・ページ

読取り専用のフォームを作成します。このオプションを使用して、ウィザードの最後に確認ページを作成します。

フォーム、Webサービスのフォーム

Webサービスの定義に基づいて、アイテムを含むページを作成します。このウィザードでは、ユーザー入力フォーム、Webサービスをコールするプロセスおよび送信ボタンを作成します。

関連項目: Webサービスでのフォームの作成

フォーム、Webサービスのフォームとレポート

Webサービスの定義に基づいて、アイテムを含むページを作成します。このウィザードでは、ユーザー入力フォーム、Webサービスをコールするプロセスおよび送信ボタンを作成し、レポートに結果を表示します。

関連項目: Webサービスでの入力フォームとレポートの作成

プラグイン

開発者はプラグインを使用して、Application Expressで使用可能な組込みタイプを宣言的に拡張できます。

関連項目: プラグインの実装

チャート

SQL問合せに基づいて線グラフ、棒グラフまたは円グラフを作成します。

関連項目: レガシー・チャートの管理

Calendar

月次、週次、日次およびリスト表示のカレンダを含むリージョンを作成します。

関連項目: カレンダの作成

ブレッドクラム

ブレッドクラムを含むリージョンを作成します。ブレッドクラムはリンクの階層リストです。

関連項目: ブレッドクラムの作成

PL/SQL動的コンテンツ

PL/SQL WebツールキットでHTMLまたはテキストをレンダリングできるようにする、PL/SQLベースのリージョンを作成します。

URL

事前定義されたURLを使用してWebサーバーをコールすることでコンテンツを取得する、URLベースのリージョンを作成します。

関連項目: 他のWebサイトからのコンテンツの組込みについて

リージョン表示セレクタ

「リージョン表示セレクタ」リージョンでは、リージョン表示選択が有効化されている、ページの各リージョンに表示と非表示のコントロールを表示できます。

関連項目: リージョン表示セレクタの作成

ヘルプ・テキスト

「ヘルプ・テキスト」リージョンでは、アプリケーションにページ・レベルのヘルプを指定できます。

関連項目: アプリケーションのヘルプの作成

12.6.2 コンポーネント・ビューでのリージョンの作成

「リージョンの作成」ウィザードを実行して、リージョンを作成します。

リージョンを作成するには、次のようにします。

1. 適切なページにナビゲートします。レガシー・コンポーネント・ビューでのページの表示を参照してください。

2. 「リージョン」で、「作成」アイコンをクリックします。

「リージョンの作成」ウィザードが表示されます。

3. リージョン・タイプを選択します。詳細は、「リージョンの作成ウィザード実行時のリージョン・タイプ」を参照してください。

「リージョンの作成」ウィザードが表示されます。

4. 画面に表示されるステップに従います。

12.6.3 コンポーネント・ビューでのリージョンの管理

リージョンとは、コンテンツのコンテナとしての役割を持つページ領域のことです。ページの外観を変更するには、リージョン属性を編集します。

トピック:

- コンポーネント・ビューでのリージョン属性の編集

- リージョン属性がページ・レイアウトに与える影響

- リージョンのヘッダーおよびフッターの指定

- ユーザーによるページのカスタマイズの可能化

- コンポーネント・ビューでのリージョン・キャッシュの使用

- 静的リージョンIDの指定

- リージョン・イメージの追加

- コンポーネント・ビューでの複数リージョンの同時編集

- コンポーネント・ビューでのサブリージョンの管理

12.6.3.1 コンポーネント・ビューでのリージョン属性の編集

コンポーネント・ビューでリージョン属性を編集するには、次のステップを実行します。

1. 適切なページにナビゲートします。レガシー・コンポーネント・ビューでのページの表示を参照してください。

2. 「リージョン」で、リージョン名を選択します。

リージョンの編集ページ(または、リージョン定義ページ)が表示されます。

注意:

プラグイン・タイプのリージョンの詳細は、プラグイン・ページからのプラグインのインポートを参照してください。

3. 対象となる属性を編集します。

属性の詳細は、フィールドレベル・ヘルプを参照してください。フィールドレベル・ヘルプの表示を参照してください。

4. 「変更の適用」をクリックします。

関連項目:

リージョン属性がページ・レイアウトに与える影響、リージョン位置の制御およびリージョンのヘッダーおよびフッターの指定

12.6.3.2 リージョン属性がページ・レイアウトに与える影響

この項では、リージョン属性によるページの外観およびレイアウトの制御方法について説明します。

トピック:

- ページ・レイアウトに影響を与えるコンポーネント・ビューのリージョン属性

- コンポーネント・ビューでのリージョン位置の制御

12.6.3.2.1 ページ・レイアウトに影響を与えるコンポーネント・ビューのリージョン属性

表12-3に、ページのレイアウトに影響を与えるリージョン属性を示します。

表 12-3 ページ・レイアウトに影響を与えるリージョン属性

リージョン、属性

説明

ユーザー・インタフェース、順序

ページ内のリージョンの表示順を指定します。

ユーザー・インタフェース、親リージョン

現在のリージョンが属している親リージョンを定義します。親リージョンを選択することで、2つのリージョン間に親/子関係を作成します。

関連項目: コンポーネント・ビューでのサブリージョンの管理

ユーザー・インタフェース、表示ポイント

ページ内でリージョンを表示する位置を指定します。リージョンは、「表示ポイント」の順序番号順にレンダリングされます。ページ・レイアウトを表示するには、「ビュー」アイコンをクリックして、位置を選択します。

選択可能な表示ポイントは、ページ・レベル・テンプレート(ページ属性)によって決定されます。ページ・レベル・テンプレートを選択しなかった場合は、「アプリケーションの定義」で定義されたデフォルトのページ・レベル・テンプレートが使用されます。

ユーザー・インタフェース、テンプレート

リージョンの外観を決定します。テンプレート属性を表示するには、そのページでテンプレート名をクリックします。

関連項目: カスタム・テーマの作成およびリージョン・テンプレート

ユーザー・インタフェース、アイテム表示位置

ページ・アイテムをメイン・リージョン・コンテンツの上部に表示するか下部に表示するかを決定します。

グリッド・レイアウト、新規グリッドの開始

このリージョンを新しいグリッドに表示するかまたは以前のリージョンと同じグリッドに表示するかを決定します。

グリッド・レイアウト、新規行の開始

このリージョンを以前のリージョンと同じ行に表示するかまたは次の行に表示するかを決定します。

グリッド・レイアウト、列

リージョンを特定のグリッド列に表示するかどうかを決定します。「自動」を選択すると、リージョンを表示する次の使用可能なグリッド列が自動的に決定されます。

グリッド・レイアウト、列スパン

リージョンによって占有されるグリッド列数を決定します。「自動」を選択すると、同じグリッド行のすべてのリージョン内で使用可能なグリッド列を均一に配置します。

グリッド・レイアウト、列CSSクラス

グリッド列に設定する追加のCSSクラスを入力します。この値によって、グリッド・レイアウト列テンプレートの#CSS_CLASSES#置換プレースホルダが置き換えられます。

グリッド・レイアウト、列属性

グリッド列に設定する追加属性を入力します。この値によって、グリッド・レイアウト列テンプレートの#ATTRIBUTES#置換プレースホルダが置き換えられます。

属性、リージョンのCSSクラス

リージョン・テンプレートに置換文字列#REGION_CSS_CLASSES#が含まれている場合に置換されるスペースで区切られたリストとして、追加のCSSクラスを入力します。

属性、リージョン

置換文字列#REGION_ATTRIBUTES#を含むリージョン・テンプレートは、この値で置換されます。

属性、リージョン表示セレクタ

リージョン表示セレクタを使用して、リージョンが、リージョン表示セレクタのリージョン・タイプに表示されるように指定します。リージョン表示セレクタを使用すると、ページ上のその他のリージョンを非表示にし、特定のリージョンのみを表示することができます。リージョン表示セレクタは、この属性を使用して指定されたリージョンのみを表示します。

属性、リージョン・イメージ

移入されている場合、指定されたイメージがリージョンの左上に表示されます。このイメージの表示に使用される表タグを制御することはできません。

関連項目: リージョン・イメージの追加

属性、イメージ・タグ属性

「リージョン・イメージ」属性とともに使用します。イメージhtmlに含める属性を入力します。たとえば、高さと幅にこの属性を使用します。

注意: イメージ・タグ属性にALTが定義されていない場合、Oracle Application Expressはデフォルトで装飾的なイメージとしてイメージをレンダリングします(空のALTタグなど)。

関連項目: リージョン・イメージの追加

ヘッダーおよびフッター

リージョンの最上部(#BODY#コンテンツの直前)に表示されるHTMLテキストを指定します。

条件

リージョンを表示するかどうかを決定する条件および適切な式を定義します。条件では、セッション・ステート、現在ログインしているユーザーまたは環境設定(ページが印刷用ビュー・モードかどうかなど)を参照できます。

関連項目: 条件付きのレンダリングおよびプロセスの理解および印刷用ページの最適化

読取り専用、読取り専用条件タイプ

このリージョンでページ・アイテムを読取り専用としてレンダリングするために必要な条件タイプをリストから選択します。条件を選択しない場合、ページ・アイテムが通常どおりにレンダリングされます。

注意: 条件タイプを「なし」に設定すると、このリージョンのアイテムは常に入力可能なフィールドとしてレンダリングされます。これは、ページ・レベルで定義した、読取り専用条件をすべて上書きします。

カスタマイズ

エンド・ユーザーによるカスタマイズを可能にします。この機能を使用するには、ページ・テンプレートのヘッダー、ボディまたはフッター・セクションに#CUSTOMIZE#置換文字列を含める必要があります。

関連項目: ユーザーによるページのカスタマイズの可能化

12.6.3.2.2 コンポーネント・ビューでのリージョン位置の制御

リージョンを作成する際に、ページ・テンプレート内でのこのリージョンの位置(「表示ポイント」)を指定する必要があります。表示ポイントに加えて、リージョンを配置する列を指定できます。複数の列にリージョンを配置する場合は、Oracle Application Expressによって必要なHTMLが自動的にレンダリングされ、複数列のレイアウトが生成されます。

12.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

関連項目:

リージョンの作成ウィザード実行時のリージョン・タイプ

12.6.3.4 ユーザーによるページのカスタマイズの可能化

「カスタマイズ」属性を使用すると、リージョンの表示属性をユーザーがカスタマイズできるかどうかを制御できます。この機能を使用するには、ページ・テンプレートのヘッダー、ボディまたはフッター・セクションに#CUSTOMIZE#置換文字列を含める必要があります。

エンド・ユーザーによるカスタマイズが1つ以上のリージョンでサポートされる場合、「カスタマイズ」というリンクがページ・テンプレートで#CUSTOMIZE#置換文字列を含めた場所に表示されます。このリンクをクリックするとウィンドウが表示され、ユーザーは、ページのリージョンを表示または非表示にできます。

関連項目:

カスタム・テーマの作成

エンド・ユーザーは次の手順でカスタマイズできます。

1. ページに移動します。レガシー・コンポーネント・ビューでのページの表示を参照してください。

2. 「リージョン」で、リージョン名を選択します。

リージョンの編集ページが表示されます。

3. 「カスタマイズ」までスクロールして、次のいずれかを選択します。

- デフォルトでカスタマイズ可能および非表示

- デフォルトでカスタマイズ可能および表示

- エンドユーザーではカスタマイズ不可

4. 「カスタマイズ・オプション名」に、ページのこのリージョンをユーザーに示すラベルを入力します。

5. ページ・テンプレートの「ヘッダー」、「ボディ」または「フッター」セクションに#CUSTOMIZE#置換文字列を含めます。

12.6.3.5 コンポーネント・ビューでのリージョン・キャッシュの使用

この項では、ページおよびリージョンのパフォーマンス向上のためにキャッシュを使用する利点について説明します。

ヒント:

リージョン・キャッシュは、対話モード・レポート・リージョンに対しては使用できません。

トピック:

- リージョン・キャッシュについて

- リージョン・キャッシュの有効化

- キャッシュされたリージョンの管理

関連項目:

『Oracle Application Express管理ガイド』のページおよびリージョン・キャッシュの管理に関する項

12.6.3.5.1 リージョン・キャッシュについて

リージョン・キャッシュの有効化は、条件を使用しないリストを含むリージョンまたは静的HTMLを含むリージョンなどの静的リージョンのパフォーマンスの向上に効果的な方法です。

リージョン・キャッシュを有効化すると、Application Expressエンジンによって、リージョンを動的にレンダリングするかわりにキャッシュされた(または格納された)リポジトリからリージョンをレンダリングします。実際のセッション識別子はキャッシュされないことに注意してください。かわりに、Application Expressエンジンでは、&SESSION.置換文字列がキャッシュされ、キャッシュされたリージョンをレンダリングしたカレント・セッションが表示時に代入されます。たとえば、リージョンにリンクが含まれ、リンクにセッションが含まれる場合、リンクがすべてのセッションで動作するようにするため、完全なセッションはキャッシュされません。

Application Expressエンジンは、リージョンが定義した条件を満たす場合にのみキャッシュからレンダリングします。また、リージョンは、ユーザーまたはキャッシュされた独立したユーザーに対してのみキャッシュできます。

関連項目:

サーバー・キャッシュおよびキャッシュされたリージョンの管理

12.6.3.5.2 リージョン・キャッシュの有効化

リージョン・キャッシュを有効化するには、次のステップを実行します。

1. ページに移動します。
レガシー・コンポーネント・ビューでのページの表示を参照してください。

2. 「リージョン」で、リージョン名を選択します。
リージョンの編集ページが表示されます。

3. 「キャッシュ」までスクロールします。

4. 「キャッシュ」で次のいずれかを選択します。

- 未キャッシュ: この機能を無効にします。

- キャッシュ済: ユーザーとは関係なくリージョンをキャッシュします。

- ユーザー別のキャッシュ: 指定されたユーザーに固有のリージョンをキャッシュします。

5. 「キャッシュ済」または「ユーザー別のキャッシュ」を選択する場合は、次のように指定します。

a. 次の後にキャッシュをタイムアウト: キャッシュされたリージョンが有効な期間を指定します。

b. キャッシュ条件タイプ: リストから条件タイプを選択します。条件がFalseを戻す場合、リージョンは動的にレンダリングされ、キャッシュされません。条件がTrueを戻す場合、リージョンはキャッシュされます。

c. 式1および式2: 選択した特定の条件タイプに基づいて値を入力します。

6. 「変更の適用」をクリックします。

12.6.3.5.3 キャッシュされたリージョンの管理

キャッシュされたリージョンはキャッシュされたリージョン・ページで管理できます。

キャッシュされたリージョン・ページにアクセスするには、次のステップを実行します。

1. ページに移動します。レガシー・コンポーネント・ビューでのページの表示を参照してください。

2. 「ユーティリティ」メニューをクリックし、「キャッシュ」を選択します。

3. リージョン・キャッシュで、「管理」をクリックします。

キャッシュされたリージョン・ページが表示されます。

4. ページ上部の検索バーを使用してページの概観をカスタマイズできます。

5. 消去するリージョンを選択して、次のいずれかをクリックします。

- 期限切れのパージ

- チェックした項目のパージ

6. キャッシュされたリージョンをすべて消去するには、「すべて消去」をクリックします。

関連項目:

『Oracle Application Express管理ガイド』のページおよびリージョン・キャッシュの管理に関する項

12.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. 「変更の適用」をクリックします。

12.6.3.7 リージョン・イメージの追加

「リージョン・イメージ」および「イメージ・タグ属性」を使用すると、リージョンの左上にイメージを追加できます。

リージョン・イメージを追加するには、次のステップを実行します。

1. 適切なページにナビゲートします。レガシー・コンポーネント・ビューでのページの表示を参照してください。

2. 「リージョン」で、リージョン名を選択します。

リージョンの編集ページが表示されます。

3. 「属性」までスクロールします。

4. 「属性」で、次のように指定します。

- リージョン・イメージ: リージョンの左上に表示するイメージを指定します。

- イメージ・タグ属性: イメージhtmlに含める属性を入力します。入力した属性を使用して、高さと幅を指定します。

5. 「変更の適用」をクリックします。

12.6.3.8 コンポーネント・ビューでの複数リージョンの同時編集

この項では、複数のリージョンを同時に編集する方法について説明します。

トピック:

- すべてのリージョンにわたる複数の属性の編集

- リージョン・ユーティリティへのアクセス

12.6.3.8.1 すべてのリージョンにわたる複数の属性の編集

リージョン・ページを使用すると、順序、列、リージョン名、表示ポイントなど、ページのすべてのリージョンのリージョン属性を更新できます。

関連項目:

リージョン属性についての詳細は、リージョンの編集ページに移動してください。コンポーネント・ビューでのリージョンの管理を参照してください。

すべてのリージョンにわたる複数の属性を編集するには、次のステップを実行します。

1. 適切なページにナビゲートします。レガシー・コンポーネント・ビューでのページの表示を参照してください。

2. 「リージョン」で「すべて編集」アイコンをクリックします。「すべて編集」アイコンは、鉛筆が置かれた小さいグリッドの形をしています。

リージョン・ページが表示されます。

3. 適切な属性を更新します。

4. 「変更の適用」をクリックします。

12.6.3.8.2 リージョン・ユーティリティへのアクセス

ユーティリティ・ページを使用すると、選択したアプリケーション内の全ページに対するグリッド編集ページとレポートにアクセスできます。

リージョン・ユーティリティ・ページにアクセスするには、次のステップを実行します。

1. 適切なページにナビゲートします。レガシー・コンポーネント・ビューでのページの表示を参照してください。

2. 「リージョン」で「すべて編集」アイコンをクリックします。「すべて編集」アイコンは、鉛筆が置かれた小さいグリッドの形をしています。

リージョン・ページが表示されます。

3. 「ユーティリティ」をクリックします。

4. ユーティリティを選択して、画面に表示される手順に従います。

関連項目:

コンポーネント・ビューでのリージョンの管理

12.6.3.9 コンポーネント・ビューでのサブリージョンの管理

サブリージョンを使用すると、2つのリージョン間に親/子関係を作成できます。サブリージョンは親リージョン内に表示されます。サブリージョンは、リージョンを新規作成するとき、またはリージョン属性を編集するときに、親リージョンを選択することによって作成できます。

トピック:

- サブリージョンの使用について

- コンポーネント・ビューでのサブリージョンの作成

- リージョン属性の編集によるサブリージョンの作成

12.6.3.9.1 サブリージョンの使用について

このサブリージョンは、様々な方法で使用できます。1つのユースケースとして、情報をグループ化するためにサブリージョンを作成します。たとえば、枠線があるリージョンがあるとします。この機能を使用すると、このリージョン内に2つのクラシック・レポート(サブリージョン)を表示できます。また、サブリージョンを使用して、リージョンをタブまたはアコーディオンとして表示できます。親リージョンとサブリージョンの表示方法を制御するには、リージョン・テンプレートの「サブリージョン」属性を編集します。

関連項目:

リージョン・テンプレート

12.6.3.9.2 コンポーネント・ビューでのサブリージョンの作成

サブリージョンを作成するには、次のステップを実行します。

1. 適切なページにナビゲートします。レガシー・コンポーネント・ビューでのページの表示を参照してください。

2. 「リージョン」で、「作成」アイコンをクリックします。

3. リージョン・タイプを選択します。リージョンの作成ウィザード実行時のリージョン・タイプを参照してください。
「リージョンの作成」ウィザードが表示されます。

4. 「表示属性」は、次のようにします。

a. タイトル - リージョンのタイトルを入力します。選択するリージョン・テンプレートにリージョン・タイトルが表示されると、このタイトルが表示されます。

b. リージョン・テンプレート - リージョンのタイトルを入力します。選択するリージョン・テンプレートにリージョン・タイトルが表示されると、このタイトルが表示されます。

c. 親リージョン - 新しいリージョンが属する親リージョンを選択します。

d. 表示ポイント: このリージョンの表示ポイントを指定します。ページ・テンプレート位置およびページ・ボディ位置という2つのタイプの表示ポイントが存在します。
ページ・テンプレート位置により、ページ・テンプレート内でのリージョンの正確な配置が可能になります。ページ・テンプレート位置は、ページ・テンプレート置換文字列(#REGION_POSITION_01#から#REGION_POSITION_08#)によって制御されます。ページ・ボディ位置は、ページ・テンプレート内の#BODY#置換文字列によって指定される位置に表示されます。

e. 「次へ」をクリックします。

5. 画面に表示されるステップに従います。

12.6.3.9.3 リージョン属性の編集によるサブリージョンの作成

リージョン属性の編集によってサブリージョンを作成するには、次のステップを実行します。

1. 適切なページにナビゲートします。レガシー・コンポーネント・ビューでのページの表示を参照してください。

2. 「リージョン」で、リージョン名を選択します。

リージョンの編集ページが表示されます。

3. 「ユーザー・インタフェース」までスクロールします。

4. 「親リージョン」で、リージョンが属する親リージョンを選択します。

5. 必要に応じて追加の属性を編集します。

属性の詳細は、フィールドレベル・ヘルプを参照してください。フィールドレベル・ヘルプの表示を参照してください。

6. 「変更の適用」をクリックします。

関連項目:

リージョン属性がページ・レイアウトに与える影響、リージョン位置の制御およびリージョンのヘッダーおよびフッターの指定

12.6.4 リージョン表示セレクタの作成

「リージョン表示セレクタ」リージョンでは、ページの各リージョンに表示と非表示のコントロールを表示できます。

リージョン表示セレクタを作成するには、次のステップを実行します。

1. リージョン・ページ・セレクタに含めるページおよびリージョンを作成します。

2. セレクタに含める各リージョンの「リージョン表示セレクタ」属性を編集します。

a. 適切なページにナビゲートします。レガシー・コンポーネント・ビューでのページの表示を参照してください。

b. 「リージョン」で、リージョン名を選択します。
リージョンの編集ページが表示されます。

c. 「属性」で、「リージョン表示セレクタ」を「はい」に変更します。

d. 「変更の適用」をクリックします。

3. タイプがリージョン表示セレクタのリージョンを作成します。

a. ページに移動します。レガシー・コンポーネント・ビューでのページの表示を参照してください。

b. 「リージョン」で、「作成」アイコンをクリックします。
「リージョンの作成」ウィザードが表示されます。

c. リージョン・タイプ「リージョン表示セレクタ」を選択します。

d. 「作成」をクリックします。

12.6.5 コンポーネント・ビューでのリージョンのコピー

注意:

「ツリー」タイプのリージョンには複数のリージョンが含まれるため、コピーできません。

リージョンをコピーするには、次のステップを実行します。

1. ページに移動します。レガシー・コンポーネント・ビューでのページの表示を参照してください。

2. 「リージョン」で「コピー」アイコンをクリックします。「コピー」アイコンは、小さいページが2つ重なった形をしています。
リージョンのコピー・ウィザードが表示されます。

3. コピーするリージョンを選択します。

4. 「コピー先ページ」は、次のようにします。

a. 「コピー先ページ」から、リージョンのコピー先のページを選択します。

b. ボタンを選択するか、「はい」または「いいえ」を選択することによって、コピーするリージョン・アイテムを選択します(使用可能な場合)。

c. 「次へ」をクリックします。

5. 「リージョンのコピー」をクリックします。

12.6.6 コンポーネント・ビューでのリージョンの削除

この項では、リージョンを削除する方法について説明します。

トピック:

- リージョンの削除

- 複数リージョンの同時削除

12.6.6.1 リージョンの削除

リージョンを削除するには、次のステップを実行します。

1. 適切なページにナビゲートします。レガシー・コンポーネント・ビューでのページの表示を参照してください。

2. 「リージョン」で、リージョン名を選択します。

リージョンの編集ページが表示されます。

3. 「削除」をクリックします。

12.6.6.2 複数リージョンの同時削除

一度に複数のリージョンを削除するには、次のステップを実行します。

1. 適切なページにナビゲートします。レガシー・コンポーネント・ビューでのページの表示を参照してください。

2. 「すべて編集」アイコンをクリックします。「すべて編集」アイコンは、鉛筆が置かれた小さいグリッドの形をしています。
リージョン・ページが表示されます。

3. 「複数のリージョンの削除」タブをクリックします。

4. 次のように指定します。

a. ボタンを削除するカスケード: 「はい」を選択すると、対応するリージョンのボタンが削除されます。

b. アイテムを削除するカスケード: 「はい」を選択すると、対応するリージョンのアイテムが削除されます。

c. 関連付けられたリストおよびリスト・エントリを削除しますか。: 「はい」を選択すると対応するリストが削除されます。このオプションは、削除されるリージョンがこのリストを参照する唯一のリージョンである場合にのみ表示されます。

d. 動的アクションを削除するカスケード: 「はい」を選択すると、対応するリージョン・アイテムが削除されます。

5. 削除するリージョンを選択します。

6. 「変更の適用」をクリックします。

12.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管理ガイドの「ウォレット情報の構成」を参照してください。

12.8 イメージの管理について

アプリケーション内でイメージを参照するには、静的ファイル・リポジトリにイメージをアップロードする必要があります。アップロード・プロセス中に、そのファイルをすべてのアプリケーションで使用可能にするか、特定のアプリケーションでのみ使用可能にするかを指定します。

関連項目:

静的アプリケーション・ファイルの管理および静的ワークスペース・ファイルの管理

12.9 カスタムPL/SQLを使用したHTMLのレンダリング

Oracle Application Expressのフォーム、レポートおよびチャートによって処理されない特定のHTMLコンテンツを生成する必要がある場合、PL/SQLタイプのリージョンを使用できます。このタイプのリージョンにHTMLを生成するには、PL/SQL Webツールキットを使用する必要があります。バインド変数構文を使用して、セッション・ステートを参照できます。この方法でHTMLを生成する場合、テンプレートの場合と同じ一貫性および制御は得られないことに注意してください。

リージョン内に生成される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;

関連項目:

Oracle Database開発ガイド

13 データベース・アプリケーション・コントロールの管理

開発者は、ページ・レベル・アイテム、動的アクション、ボタン、ツリーなどの様々なデータベース・アプリケーションのページ・コントロールを作成および管理できます。

トピック:

- ページ・レベル・アイテムの理解

- ページ・デザイナでのページ・レベル・アイテムの管理

- レガシー・コンポーネント・ビューでのページ・レベル・アイテムの管理

- 動的アクションの管理

- ボタンの作成

- ツリーの作成

- アプリケーションへのJavaScriptの組込みについて

関連項目:

- 「ページ・レイアウトの制御」

- 「ナビゲーションの追加」

- 「Oracle Application Expressコンポーネントの手動リフレッシュ」

13.1 ページ・レベル・アイテムの理解

アイテムは、HTMLフォームの一部です。アイテムは、テキスト・フィールド、テキスト領域、パスワード、選択リスト、チェック・ボックスなどを示します。アイテム属性は、ページ上のアイテムの表示に影響します。たとえば、これらの属性は、ラベルの表示位置、アイテムの大きさおよびアイテムの表示位置(前のアイテムの横または下)に影響します。

トピック:

- ページ・アイテムとアプリケーション・アイテムの違いについて

- アイテムのネーミング規則について

- アイテム値の参照

- JavaScriptを使用したアイテムの参照

- 複数選択リスト・アイテムでの操作

関連項目:

ページ・デザイナでのページ・レベル・アイテムの管理およびレガシー・コンポーネント・ビューでのページ・レベル・アイテムの管理

13.1.1 ページ・アイテムとアプリケーション・アイテムの違いについて

アイテムには、ページ・アイテムとアプリケーション・アイテムの2つのタイプが存在します。ページ・アイテムはページ上に配置され、「表示のみ」、「ラベル」、「ラベル・テンプレート」などの関連付けられたユーザー・インタフェースのプロパティを持ちます。ページ・レベル・アイテムの例としてはチェック・ボックス、日付ピッカー、テキストとしての表示、「ファイル参照」フィールド、「ポップアップLOV」、「選択リスト」、または「テキスト領域」などがあります。アプリケーション・アイテムはページに関連付けられないため、ユーザー・インタフェースのプロパティを持ちません。アプリケーション・アイテムは、グローバル変数として使用できます。

関連項目:

アプリケーション・レベル・アイテムの管理

13.1.2 アイテムのネーミング規則について

アイテム名を指定する場合は、次の規則に注意してください。規則は次のとおりです。

- アプリケーション内で一意である必要があります。

- 引用符を含めることはできません。

- 先頭は文字または数字である必要があります。その後は、文字、数字またはアンダースコア文字を使用できます。

- 大/小文字が区別されません。

- 30文字以内にする必要があります。30文字を超えるアイテムは、バインド変数構文を使用して参照できません。バインド変数構文を使用したセッション・ステートの参照を参照してください。

- 基本ASCIIキャラクタ・セット以外の文字を含めることはできません。

アイテム名を指定する場合は、ページ番号を含めることをお薦めします。デフォルトでは、ウィザードによってページ・アイテム名の先頭にP<page no>_<item name>が付けられます(たとえば、P1_NAME)。

13.1.3 アイテム値の参照

リージョン、計算、プロセス、検証およびブランチのセッション・ステートに格納されたアイテム値を参照できます。表13-1に、アイテム値を参照するためにサポートされている構文を示します。

表13-1アイテム値を参照するための構文

データ型

構文

説明

SQL

:MY_ITEM

名前が30バイト以下のアイテム用の標準のバインド変数構文。この構文は、SQL問合せおよびPL/SQLコード内の参照用に使用します。

PL/SQL

V('MY_ITEM')

Vファンクションを使用してアイテム値を参照するPL/SQL構文。この構文は、パッケージまたはストアド・プロシージャやファンクションのPL/SQLコードで使用します。

この構文をSQL文で使用しないでください。使用すると、パフォーマンスの問題が発生する場合があります。

PL/SQL

NV('MY_NUMERIC_ITEM')

NVファンクションを使用して数値アイテム値を参照する標準のPL/SQL構文。この構文は、パッケージまたはストアド・プロシージャやファンクションのPL/SQLコードで使用します。

この構文をSQL文で使用しないでください。使用すると、パフォーマンスの問題が発生する場合があります。

静的テキスト(完全置換)

&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

関連項目:

- セッション・ステートのクリア

- クロスサイト・スクリプティング保護の理解

- セッション・ステート値の管理

13.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に関する説明

13.1.5 複数選択リスト・アイテムでの操作

この項では、複数の選択リスト・アイテムから返された値を処理する方法について説明します。

- 複数の選択リスト・アイテムから返された値の処理について

- APEX_UTIL.STRING_TO_TABLEを使用した選択値の変換

- シャトル・アイテムの作成

トピック:

- 複数の選択リスト・アイテムから返された値の処理について

- APEX_UTIL.STRING_TO_TABLEを使用した選択値の変換

- シャトル・アイテムの作成

13.1.5.1 複数の選択リスト・アイテムから返された値の処理について

複数選択アイテムは複数選択リストのフォーム要素としてレンダリングされ、複数選択リストまたはシャトル・アイテム・タイプのいずれかになります。送信されると、選択した値は単一のコロンで区切られた文字列に戻されます。このフォーマットの値は3通りの方法で処理できます。

- INSTRファンクションの使用

- APEX_UTIL.STRING_TO_TABLEファンクションの使用

- シャトルの作成

13.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ファンクション」

13.1.5.3 シャトル・アイテムの作成

この項では、シャトル・アイテム・タイプを作成する方法について説明します。まず、DEPT表に、特定の部門に割り当てられている従業員を示すレポートおよびフォームを作成します。次に、従業員を部門に割り当てやすくするために従業員をアルファベット順に一覧表示するシャトル・アイテムを作成します。

トピック:

- 表でのレポートおよびフォームの作成

- ページ・デザイナのフォーム・ページでのシャトル・アイテムの作成

- コンポーネント・ビューのフォーム・ページでのシャトル・アイテムの作成

13.1.5.3.1 表でのレポートおよびフォームの作成

この項の手順では、アプリケーションがすでに作成されていると想定しています。

表でレポートおよびフォームを作成するには、次のステップを実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「ページの作成」をクリックします。

4. 「ページの作成」で、次のステップを実行します。

a. ユーザー・インタフェース - 「デスクトップ」を選択します。

b. ページ・タイプの選択: 「フォーム」を選択します。

c. 「次へ」をクリックします。

5. 「表のフォーム付きレポート」を選択して「次へ」をクリックします。

6. 「レポート・ページ属性」で、次のステップを実行します。

a. 必要な属性を編集します。
オプションの詳細は、フィールドレベル・ヘルプを参照してください。

b. 「次へ」をクリックします。

7. 「ナビゲーション・メニュー」で、ナビゲーション・プリファレンスを選択して「次へ」をクリックします。

8. 「データ・ソース」で、次のステップを実行します。

a. 表/ビューの所有者 - レポートを作成している表の所有者を選択します。

b. 表/ビューの名前 - フォームの基になる表またはビューを選択します。

c. レポートに表示される列の選択(必須の値): レポートに含める1つ以上の列を選択します。

d. 「次へ」をクリックします。

9. 「フォーム・ページの定義」で、次のステップを実行します。

a. 主キー - 「データベースで管理(ROWID)」を選択して、フォームがROWID擬似列を使用して更新および削除する行を識別するようにします。ソース表の主キー列を使用するには、「主キー列の選択」を選択します。

b. フォームに含まれる列の選択(必須の値) - フォームに含める1つ以上の列を選択します。

c. 「作成」をクリックします。

13.1.5.3.2 ページ・デザイナのフォーム・ページでのシャトル・アイテムの作成

フォーム・ページでシャトルを作成するには、次のステップを実行します。

1. ページ・デザイナでフォーム・ページを表示します。

2. 「ページ・レンダリング」で、フォームを含むリージョンをクリックして「ページ・アイテムの作成」を選択します。
次に、「プロパティ・エディタ - ページ・アイテム」に属性を入力します。

3. 「指定」で、次の項目を指定します。

a. 名前 - このアイテムの名前(たとえばPX_EMP_LIST)を入力します。

ヒント:

この例では、アイテム名(P2_EMP_LISTなど)のPXはアイテムが存在するページを示しています。

b. タイプ - 「シャトル」を選択します。

4. 「LOV」で、次のステップを実行します。

a. タイプ - 「SQL問合せ」を選択します。

b. SQL文 - このLOVに移入するためのSQL問合せ定義を入力します。 次に例を示します。:

SELECT ename, empno FROM emp ORDER BY 1

5. 「ソース」で、次のようにします。

- タイプ - 「SQL問合せ(コロン区切りの値を返す)」を選択します

- アイテム・ソース値 - このアイテム値のソースとして使用される1行以上の行を返すSQL問合せ文を入力します。結果に複数の行が含まれる場合、各行の値が、コロンで区切られた1つの値に形成されます。次に例を示します。

SELECT empno FROM emp WHERE deptno = :P8_DEPTNO ORDER BY ename

6. 「保存」をクリックします。

7. 保存と実行をクリックして、ページを表示します。

13.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. 「実行」をクリックして、ページを表示します。シャトル・アイテムが次の図のように表示されます。

13.2 ページ・デザイナでのページ・レベル・アイテムの管理

アイテムは、HTMLフォームの一部です。アイテムは、テキスト・フィールド、テキスト領域、パスワード、選択リスト、チェック・ボックスなどを示します。この項では、ページ・デザイナでページ・レベル・アイテムを作成する方法について説明します。

トピック:

- ページ・デザイナでのページ・レベル・アイテムの表示

- ページ・レベル・アイテムの作成

- ページ・デザイナでのページ・レベル・アイテムの編集

関連項目:

ページ・レベル・アイテムの理解およびレガシー・コンポーネント・ビューでのページ・レベル・アイテムの管理

13.2.1 ページ・デザイナでのページ・レベル・アイテムの表示

アイテム属性は、ページ上のアイテムの表示に影響します。たとえば、これらの属性は、ラベルの表示位置、アイテムの大きさおよびアイテムの表示位置(前のアイテムの横または下)に影響します。

ページ・デザイナでページ・レベル属性を表示するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. ページを選択します。

ページ・デザイナが表示されます。

2. 「レンダリング」タブまたは「レイアウト」タブのいずれかで、編集するアイテムを選択します。

プロパティ・エディタが変更されて属性が表示されます。

属性は、機能グループに編成されます。これらのグループを展開または縮小するには、「共通の表示」、「すべて表示」、「すべて閉じる」および「すべて開く」アイコンをクリックします。

グループまたは属性を検索するには、「フィルタ・プロパティ」フィールドにキーワードを入力します。

3. プロパティ・エディタで該当する属性を編集します。

ヒント:

属性の詳細は、プロパティ・エディタで属性を選択し、中央ペインで「ヘルプ」タブをクリックして、参照してください。

4. 「保存」をクリックします。

5. 保存と実行をクリックして、ページを表示します。

13.2.2 ページ・レベル・アイテムの作成

この項では、アイテムの作成ウィザードを実行して、ページ・レベル・アイテムを作成する方法について説明します。

トピック:

- 「レンダリング」タブからのページ・レベル・アイテムの作成

- 「ギャラリ」からのページ・レベル・アイテムの追加

- 静的値リストの作成

- カスケードLOVの作成

関連項目:

ページ・アイテムとアプリケーション・アイテムの違いについて

13.2.2.1 「レンダリング」タブからのページ・レベル・アイテムの作成

「レンダリング」タブからページ・レベル・アイテムを作成するには、次のステップを実行します。

1. ページ・デザイナでアイテムを含めるページを表示します。

2. 必要に応じて、アイテムを含めるリージョンを作成します。

3. 「レンダリング」タブで、アイテムを含めるリージョンを右クリックし、「ページ・アイテムの作成」を選択します。

4. プロパティ・エディタですべての属性を表示するには、「すべて表示」をクリックします。

5. グループまたは属性を検索するには、「フィルタ・プロパティ」フィールドにキーワードを入力します。

6. プロパティ・エディタで該当する属性を編集します。

ヒント:

属性の詳細は、プロパティ・エディタで属性を選択し、中央ペインで「ヘルプ」タブをクリックして、参照してください。

7. 「保存」をクリックします。

関連項目:

「「ページ・デザイナでのページの表示」および「リージョンについて」

13.2.2.2 「ギャラリ」からのページ・レベル・アイテムの追加

「ギャラリ」から追加することによってページ・レベル・アイテムを作成するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. ページを選択します。

ページ・デザイナが表示されます。

2. 必要に応じて、アイテムを含めるリージョンを作成します。

3. 中央ペインで、「レイアウト」をクリックして、ギャラリの「アイテム」タブをクリックします。

アイテムの上にカーソルを置くと、説明のツールチップが表示されます。

4. アイテムを選択して、「レイアウト」タブの適切な位置までドラッグします。

ヒント:

アイテムを右クリックし、「追加先」をクリックして、適切な場所を選択することもできます。

プロパティ・エディタにページ・アイテム属性が表示されます。

「メッセージ」タブに、対処が必要なメッセージを示す赤または黄色の印が表示されます。メッセージを選択すると、プロパティ・エディタに関連する属性が表示されます。赤いエラー・メッセージは、保存する前に対処する必要があります。

5. プロパティ・エディタで該当する属性を編集します。

ヒント:

属性の詳細は、プロパティ・エディタで属性を選択し、中央ペインで「ヘルプ」タブをクリックして、参照してください。

6. 「保存」をクリックします。

関連項目:

「「ページ・デザイナでのページの表示」および「リージョンについて」

13.2.2.3 静的値リストの作成

静的値リストを作成する方法の1つに、アイテムのLOV定義の編集があります。このタイプのLOVは再使用できないことに注意してください。LOVをいつでも使用可能な共有コンポーネントとして作成することをお薦めします。

静的値リストを作成するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. ページを選択します。

ページ・デザイナが表示されます。

2. 新規アイテムを作成します。
プロパティ・エディタにページ・アイテム属性が表示されます。

3. プロパティ・エディタで該当する属性を編集します。

属性は、機能グループに編成されます。これらのグループを展開または縮小するには、「共通の表示」、「すべて表示」、「すべて閉じる」および「すべて開く」アイコンをクリックします。

グループまたは属性を検索するには、「フィルタ・プロパティ」フィールドにキーワードを入力します。

ヒント:

属性の詳細は、プロパティ・エディタで属性を選択し、中央ペインで「ヘルプ」タブをクリックして、参照してください。

4. 「指定」で、次のステップを実行します。

a. 名前 - このアイテムの名前を入力します。アイテム名は、有効なOracle識別子である必要があります。アイテム名は、30バイト以下にして、SQL問合せのバインド変数として使用できるようにすることをお薦めします。

b. タイプ - 「選択リスト」を選択します。

5. 「LOV」で、次のステップを実行します。

a. 名前 - 「静的値」を選択します。

b. 静的値 - 次の構文を使用して、この静的値リストのテキストを入力します。
STATIC[2]:Display Value[;Return Value],Display Value[;Return Value]
内容は次のとおりです。

- 最初のキーワードはSTATICまたはSTATIC2になります。
テキストがSTATIC:で始まる場合、リスト値はアルファベット順に表示されます。また、テキストがSTATIC2:で始まる場合、リスト値はテキストに指定した順序と同じ順序で表示されます。

- セミコロンは各エントリで表示値と戻り値を区切ります。

- Return Valueはオプションです。Return Valueが含まれない場合、戻り値は表示値と同じになります。

例を確認するには、中央ペインで「ヘルプ」タブをクリックします。

6. 「保存」をクリックします。

7. 保存と実行をクリックして、ページを表示します。

トピック:

- 例1: アルファベット順で表示される4つの値

- 例2: リストされた順序で表示される10の値

- 例3: 戻り値および表示値の両方を持つ値リスト

関連項目:

「アプリケーション・レベルでのLOVの作成」および「アイテムのネーミング規則について」

13.2.2.3.1 例1: アルファベット順で表示される4つの値

この例では、アルファベット順で表示される4つの値(Cow、Dog、Cat、Lion)が値リストにあります。各エントリの戻り値は表示値と同じです。

STATIC:Cow,Dog,Cat,Lion

13.2.2.3.2 例2: リストされた順序で表示される10の値

この例では、定義にリストされた順序で表示される10の値が値リストにあります。各エントリの戻り値は表示値と同じです。

STATIC2:10,15,20,25,50,100,200,500,1000,10000

13.2.2.3.3 例3: 戻り値と表示値の両方を持つ値リスト

この例では、YesとNoという2つの値が値リストにあります(表示値Yesとその戻り値Y、表示値Noとその戻り値N)。

STATIC:Yes;Y,No;N

13.2.2.4 カスケードLOVの作成

カスケードLOVを作成すると、ページ上の1つのアイテムによって別のアイテムのLOVが決定されます。アプリケーション・ビルダーでは、選択リスト、シャトル、チェック・ボックス、ラジオ・グループ、ポップアップLOVおよびリスト・マネージャの各アイテム・タイプに対して、カスケードLOVがサポートされています。

カスケードLOVは、2つのアイテムを作成することによって作成します。2つ目のアイテムに値を移入するには、アイテムの作成ウィザードを実行しているときか、またはアイテムの属性を編集することによって、カスケードLOV親アイテムを指定します。

次の例では、2つの関連する選択リストを作成する方法を示します。この場合、最初のリストの値が2つ目のリストに移入されます。

値のカスケード・リストを作成するには、次の手順を実行します。

1. 最初のアイテムを作成し、そのアイテムにP1_DEPTNOという名前を付けます。

a. 選択リスト・アイテムを作成します。

b. 「指定」の「タイプ」で、「選択リスト」を選択します。

c. 「指定」は、次のようにします。

- 名前 - 次のように入力します。

P1_DEPTNO

- タイプ - 「選択リスト」を選択します。

d. 「ラベル」は、次のようにします。

- ラベル - 次のように入力します。

Department

e. 「LOV」で、次のようにします。

- タイプ - 「SQL問合せ」を選択します。

- 「SQL問合せ」で、次を入力します。

SELECT dname as d,
deptno as r
FROM dept
ORDER BY dname

- NULL値の表示 - 「はい」を選択します。

- NULL表示値 - 入力/選択します。

- Select Department -

f. 残りのデフォルト値を受け入れます。

g. 「保存」をクリックします。

2. P1_EMPNOという名前の2つ目のアイテムを作成します。

a. 選択リスト・アイテムを作成します。

b. 「指定」の「タイプ」で、「選択リスト」を選択します。

c. 「指定」は、次のようにします。

- 名前 - 次のように入力します。

P1_EMPNO

- タイプ - 「選択リスト」を選択します。

d. 「ラベル」は、次のようにします。

- ラベル - 次のように入力します。

Employee

e. 「LOV」で、次のようにします。

- タイプ - 「SQL問合せ」を選択します。

- 「SQL問合せ」で、次を入力します。

SELECT ename as d,
empno as r
FROM emp
WHERE deptno = :P1_DEPTNO
ORDER BY ename

- NULL値の表示 - 「はい」を選択します。

- NULL表示値 - 入力/選択します。

- Select Employee -

f. 残りのデフォルト値を受け入れます。

g. 「保存」をクリックします。

2つの選択リストが表示されます。「Department」選択リストで選択を行うと、「Employees」選択リストに表示される個人が決定されます。

13.2.3 ページ・デザイナでのページ・レベル・アイテムの編集

この項では、ページ・デザイナでページ・レベル・アイテムを編集する方法について説明します。

トピック:

- プロパティ・エディタでのページ・アイテム属性の編集

- ページ・アイテムのデフォルト値の定義

- ページ・アイテムのセキュリティの構成

- クイック選択の作成

- 条件付きページ・アイテムの表示

- 読取り専用ページ・アイテムの表示

- 保存されていない変更についてユーザーに警告するためのアイテム属性の構成

- アイテム・ユーティリティの表示

13.2.3.1 プロパティ・エディタでのページ・アイテム属性の編集

プロパティ・エディタでアイテム属性を編集するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. ページを選択します。

ページ・デザイナが表示されます。

2. 「レンダリング」タブまたは「レイアウト」タブのいずれかで、編集するアイテムを選択します。

プロパティ・エディタが変更されてボタン属性が表示されます。

属性は、機能グループに編成されます。これらのグループを展開または縮小するには、「共通の表示」、「すべて表示」、「すべて閉じる」および「すべて開く」アイコンをクリックします。

グループまたは属性を検索するには、「フィルタ・プロパティ」フィールドにキーワードを入力します。

3. 対象となる属性を編集します。

ページが保存されるまで、編集した属性の属性名の左側に青色のマーカーが表示されます。

注意:

属性の詳細は、フィールドレベル・ヘルプを参照してください。フィールドレベル・ヘルプの表示を参照してください。

4. 「保存」をクリックします。

13.2.3.2 ページ・アイテムのデフォルト値の定義

アイテムのデフォルト値は、ページ・アイテムの編集ページの「デフォルト」の下にある属性を使用して定義します。デフォルト値は、アイテムの値がセッション・ステートから導出されない場合およびソース値がNULLの場合に使用されます。

アイテムのデフォルト値を定義するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. ページを選択します。

ページ・デザイナが表示されます。

2. 「レンダリング」タブまたは「レイアウト」タブのいずれかで、編集するアイテムを選択します。

プロパティ・エディタにアイテム属性が表示されます。

属性は、機能グループに編成されます。これらのグループを展開または縮小するには、「共通の表示」、「すべて表示」、「すべて閉じる」および「すべて開く」アイコンをクリックします。

グループまたは属性を検索するには、「フィルタ・プロパティ」フィールドにキーワードを入力します。

3. 「デフォルト」を探します。

4. 「タイプ」を選択します。

- 静的値

- PL/SQL式

- PL/SQLファンクション本体

5. 「保存」をクリックします。

13.2.3.3 ページ・アイテムのセキュリティの構成

ページ・アイテムのセキュリティを構成するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. ページを選択します。

ページ・デザイナが表示されます。

2. 「レンダリング」タブまたは「レイアウト」タブのいずれかで、編集するアイテムを選択します。

プロパティ・エディタにアイテム属性が表示されます。

属性は、機能グループに編成されます。これらのグループを展開または縮小するには、「共通の表示」、「すべて表示」、「すべて閉じる」および「すべて開く」アイコンをクリックします。

グループまたは属性を検索するには、「フィルタ・プロパティ」フィールドにキーワードを入力します。

3. 「セキュリティ」を見つけて展開します。次のセキュリティ属性を構成します。

表13-2 「プロパティ・エディタ - ページ・アイテム」の「セキュリティ」

属性

説明

認可スキーム

認可スキームを選択します(この認可スキームがTRUEと評価された場合はこのコンポーネントがレンダリングされ、そうでない場合は処理されます)。

関連項目: 認可を介したセキュリティの提供

セッション・ステート保護

「セッション・ステート保護」レベルを選択します。オプションは次のとおりです。

- 制限なし - URLまたはフォームでアイテムを渡して、アイテムを設定できます。URLにチェックサムは必要ありません。

- チェックサムが必要 - ユーザー・レベル - ワークスペース、アプリケーションおよびユーザー固有のチェックサムを含むURLでアイテムを渡して、アイテムを設定できます。

- チェックサムが必要 - セッション・レベル - セッション固有のチェックサムを含むURLでアイテムを渡して、アイテムを設定できます。

- 制限付き - ブラウザから設定できない: URLまたはPOSTDATAを使用してアイテムを変更できません。内部プロセス、計算などに設定できるアイテムの値を制限する場合は、このオプションを使用します。この属性は、データ・エントリ・アイテムとして使用されないアイテムのみに適用され、セッション・ステート保護が無効になっていても常に監視されます。この属性は、次の表示形式タイプのページまたはアプリケーション・アイテムに使用します

- 表示のみ(状態の保存=なし)

- テキスト・フィールド(無効、状態を保存しない)

関連項目: セッション・ステート保護の理解

セッション・ステートに暗号化された値を保存

セッション・ステートに格納する際、このアイテムを暗号化するかどうかを指定します。アイテムのコンテンツに機密データが含まれる場合、Application Expressセッション・ステート管理表に格納する際に値を暗号化する必要があります。そうしないと、Application Expressメタデータ表を読み取る権限を持つユーザーが問合せを記述し、この機密データを抽出する可能性があります。

最大4000バイトの長さの値を暗号化できます。4000バイトを超える値を暗号化しようとすると、エラー・メッセージが表示されます。

特殊文字をエスケープ

この属性は、いくつかのアイテム・タイプでのみ表示されます。クロスサイト・スクリプティング(XSS)攻撃を防ぐには、「はい」を選択します。ページ・アイテムまたはLOVのエントリに格納されているHTMLタグを実際にレンダリングする場合は、「いいえ」を選択します。

関連項目: クロスサイト・スクリプティング保護の理解

制限付き文字

セッション・ステートに保存できる文字を制限する方法を選択します。選択された文字制限に一致しないデータをユーザーが保存しようとすると、Application Expressからエラー・メッセージが表示されます。文字を制限することはアプリケーションのセキュリティを強化し、クロスサイト・スクリプティング(XSS)攻撃の対策となります。

使用可能なオプションは次のとおりです。

- すべての文字を保存できます。
制限は適用されません。

- a-Z、0-9と空白のホワイトリスト
文字a-z、A-Z、0-9および空白のみ許可されます。

- ブラックリストHTMLコマンド文字(<>")。
予約済のHTML文字は許可されません。

- ブラックリスト&<>"/;,*|=%および--
&、<、>、"、/、;、","、*、|、=、%および"--" (PL/SQLコメント)は許可されません。

- ブラックリスト&<>"/;,*|=%または--と改行
&、<、>、"、/、;、","、*、|、=、%、"--"、および改行文字は許可されません。

関連項目: クロスサイト・スクリプティング保護の理解

13.2.3.4 クイック選択の作成

クイック選択では、ユーザーは、テキストを入力したり、使用可能なオプションのリストから選択するかわりに、事前定義された値をワンクリックで選択できます。アイテム・タイプでクイック選択がサポートされている場合は、「クイック選択」属性を使用して、特定のアイテムの下に表示される選択項目を最大10個定義できます。クイック選択をクリックすると、アイテムの値が設定されます。次の例は、5%、10%、15%および20%のクイック選択を示しています。

クイック選択を作成するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. ページを選択します。

ページ・デザイナが表示されます。

2. 「レンダリング」タブまたは「レイアウト」タブのいずれかで、編集するアイテムを選択します。

プロパティ・エディタにアイテム属性が表示されます。

属性は、機能グループに編成されます。これらのグループを展開または縮小するには、「共通の表示」、「すべて表示」、「すべて閉じる」および「すべて開く」アイコンをクリックします。

グループまたは属性を検索するには、「フィルタ・プロパティ」フィールドにキーワードを入力します。

3. 「クイック選択」で、次のステップを実行します。

a. クリック選択の表示 - 「はい」を選択します。

b. リンク属性 - 各クイック選択リンクの表示に関連付けるHTML属性を入力します

c. ラベル - 各クイック選択のラベルを入力します。このラベルは、アプリケーションのエンド・ユーザーに表示されるテキストです。

d. 値 - 各クイック選択に関連付ける値を入力します。ユーザーがクイック選択をクリックすると、この値で既存のアイテム値が置換されます。

4. 「保存」をクリックします。

13.2.3.5 条件付きページ・アイテムの表示

条件付きアイテムを表示するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. ページを選択します。

ページ・デザイナが表示されます。

2. 「レンダリング」タブまたは「レイアウト」タブのいずれかで、編集するアイテムを選択します。

プロパティ・エディタにアイテム属性が表示されます。

属性は、機能グループに編成されます。これらのグループを展開または縮小するには、「共通の表示」、「すべて表示」、「すべて閉じる」および「すべて開く」アイコンをクリックします。

グループまたは属性を検索するには、「フィルタ・プロパティ」フィールドにキーワードを入力します。

3. 「サーバー側の条件」を見つけます。条件タイプを選択し、表示されたフィールドに適切な情報を入力します。

ヒント:

属性の詳細は、プロパティ・エディタで属性を選択し、中央ペインで「ヘルプ」タブをクリックして、参照してください。

4. 「保存」をクリックします。

13.2.3.6 読取り専用ページ・アイテムの表示

読取り専用アイテムを表示するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. ページを選択します。

ページ・デザイナが表示されます。

2. 「レンダリング」タブまたは「レイアウト」タブのいずれかで、編集するアイテムを選択します。

プロパティ・エディタにアイテム属性が表示されます。

属性は、機能グループに編成されます。これらのグループを展開または縮小するには、「共通の表示」、「すべて表示」、「すべて閉じる」および「すべて開く」アイコンをクリックします。

グループまたは属性を検索するには、「フィルタ・プロパティ」フィールドにキーワードを入力します。

3. 「読取り専用」で「タイプ」を選択し、表示されたフィールドに適切な情報を入力します。

ヒント:

属性の詳細は、プロパティ・エディタで属性を選択し、中央ペインで「ヘルプ」タブをクリックして、参照してください。

4. 「保存」をクリックします。

13.2.3.7 保存されていない変更についてユーザーに警告するためのアイテム属性の構成

開発者は、「保存されていない変更の警告」アイテム属性を使用して、保存されていない変更のチェックにページ・アイテムを含めるかどうかを指定できます。このチェックにより、保存されていない変更が含まれるページから移動しようとすると、ユーザーに警告が表示されます。データベース列に基づかないアイテム(検索アイテムなど)は、チェックする必要がありません。それらのアイテムに対しては、「保存されていない変更の警告」を「チェックしない」に設定します。

「保存されていない変更の警告」属性を構成するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. ページを選択します。

ページ・デザイナが表示されます。

2. 「レンダリング」タブまたは「レイアウト」タブのいずれかで、編集するアイテムを選択します。

プロパティ・エディタにアイテム属性が表示されます。

属性は、機能グループに編成されます。これらのグループを展開または縮小するには、「共通の表示」、「すべて表示」、「すべて閉じる」および「すべて開く」アイコンをクリックします。

グループまたは属性を検索するには、「フィルタ・プロパティ」フィールドにキーワードを入力します。

3. 「詳細」を見つけて展開します。

4. 「保存されていない変更の警告」で、次のいずれかを選択します。

- ページのデフォルトc「保存されていない変更の警告」がページ・レベルで有効化されている場合に、ボタンがクリックされたときに保存されていない変更をチェックします。

- チェックしない: アイテムの変更は、保存されていない変更のチェックで無視されます。データベース列に基づかないアイテム(検索アイテムなど)には、このオプションを選択します。

5. 「保存」をクリックします。

ヒント:

「保存されていない変更の警告」属性は、apex.page.warnOnUnsavedChanges APIを使用して実装されます。

関連項目:

保存されていない変更についてユーザーに警告するためのページ属性の構成およびOracle Application Express APIリファレンス

13.2.3.8 アイテム・ユーティリティの表示

ユーティリティ・ページには、グリッド編集ページが含まれ、選択したアプリケーション内の複数のページのアイテムを編集できるユーティリティが表示されます。

ユーティリティ・ページにアクセスするには、次のステップを実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「ユーティリティ」をクリックします。

4. 「ページ固有のユーティリティ」リージョンで、「アイテム・ユーティリティ」をクリックします。

5. 次のいずれかのレポートを選択します。

- すべてのアイテム・ラベルのグリッド編集

- すべてのアイテム・ヘルプ・テキストのグリッド編集

- アイテム・ヘルプのサブスクリプション

- すべてのページ・アイテム

- パスワード・アイテム

- 条件付きアイテム

13.3 レガシー・コンポーネント・ビューでのページ・レベル・アイテムの管理

アイテムは、HTMLフォームの一部です。アイテムは、テキスト・フィールド、テキスト領域、パスワード、選択リスト、チェック・ボックスなどを示します。この項では、コンポーネント・ビューでページ・レベル・アイテムを作成する方法について説明します。

トピック:

- コンポーネント・ビューでのページ・レベル・アイテムの表示

- コンポーネント・ビューでのページ・レベル・アイテムの作成

- コンポーネント・ビューでのページ・レベル・アイテムの編集

関連項目:

ページ・レベル・アイテムの理解およびページ・デザイナでのページ・レベル・アイテムの管理

13.3.1 コンポーネント・ビューでのページ・レベル・アイテムの表示

この項では、ページ・レベル・アイテムの作成方法と編集方法について説明します。

コンポーネント・ビューでは、アイテムがセクション「アイテム」の下に表示されます。アイテムを編集、コピーおよび作成するには、セクション・タイトルの横にある次のアイコンをクリックします。

- すべて編集 - 「すべて編集」アイコンは、鉛筆が置かれた小さいグリッドの形をしています。すべてのアイテムを一度に編集する場合に、このアイコンを使用します。複数のアイテムの同時編集を参照してください。

- コピー - 「コピー」アイコンは、小さいページが2つ重なった形をしています。既存のアイテムをコピーする場合に、このアイコンを使用します。

- 作成 - 「作成」アイコンは、プラス(+)記号が置かれた小さいページの形をしています。アイテムを作成する場合に、このアイコンを使用します。

アイテムはリージョンごとに編成されます。アイテムを編集するには、アイテム名をクリックします。

関連項目:

コンポーネント・ビューでのページ・アイテム属性の編集

13.3.2 コンポーネント・ビューでのページ・レベル・アイテムの作成

この項では、アイテムの作成ウィザードを実行して、ページ・レベル・アイテムを作成する方法について説明します。

トピック:

- コンポーネント・ビューでのページ・レベル・アイテムの作成

- 静的値リストの作成

- カスケードLOVの作成

- 表形式フォームを使用した複数のアイテムの作成

関連項目:

ページ・アイテムとアプリケーション・アイテムの違いについておよびアイテム・タイプについて

13.3.2.1 コンポーネント・ビューでのページ・レベル・アイテムの作成

ページ・レベル・アイテムを作成するには、次のステップを実行します。

1. 適切なページにナビゲートします。レガシー・コンポーネント・ビューでのページの表示を参照してください。

2. 必要に応じて、リージョンを作成します。リージョンについてを参照してください。

3. 「アイテム」で、「作成」アイコンをクリックします。
アイテムの作成ウィザードが表示されます。

4. 「アイテムの作成」で、次のステップを実行します。

a. アイテム・タイプ - アイテム・タイプを選択します。アイテム・タイプについてを参照してください。
ポップアップLOV、カラー・ピッカーまたはポップアップ計算機付きテキスト・フィールドを作成する場合は、「ポップアップLOV」を選択し、特定のポップアップLOVタイプを選択します。

b. 非サポートの表示 - 「いいえ」を選択すると、カレント・ページのユーザー・インタフェース用に設計されているアイテム・タイプのみが表示されます。「はい」を選択すると、他のユーザー・インタフェース用に設計されているその他のアイテム・タイプが表示されます。

c. 「次へ」をクリックします。

アイテム・タイプを選択します。アイテム・タイプについてを参照してください。

5. 「表示位置および名前」で、次のステップを実行します。

a. アイテム名 - アイテム名を入力します。この名前によって、アイテムの値を取得するためのハンドルが提供されます。30文字以上のアイテム名はバインド変数構文を使用して参照できません。アイテムのネーミング規則についてを参照してください。

b. 順序: このコンポーネントの順序を指定します。これによって評価の順序が決まります。

c. リージョン - アイテムが配置されるリージョンを決定します。

d. 「次へ」をクリックします。

6. 画面に表示されるステップに従います。

7. 属性の詳細は、フィールドレベル・ヘルプを参照してください。フィールドレベル・ヘルプの表示を参照してください。

13.3.2.2 静的値リストの作成

静的値リストを作成する方法の1つに、アイテムのLOV定義の編集があります。このタイプのLOVは再使用できないことに注意してください。LOVをいつでも使用可能な共有コンポーネントとして作成することをお薦めします。

関連項目:

アプリケーション・レベルでのLOVの作成

静的値リストを作成するには、次のステップを実行します。

1. 適切なページにナビゲートします。レガシー・コンポーネント・ビューでのページの表示を参照してください。

2. 必要に応じて、リージョンを作成します。リージョンについてを参照してください。

3. 「アイテム」で、「作成」アイコンをクリックします。
アイテムの作成ウィザードが表示されます。

4. 「アイテムの作成」で、次のステップを実行します。

a. アイテム・タイプ - 「選択リスト」を選択します。

b. 非サポートの表示 - 「いいえ」を選択すると、カレント・ページのユーザー・インタフェース用に設計されているアイテム・タイプのみが表示されます。「はい」を選択すると、他のユーザー・インタフェース用に設計されているその他のアイテム・タイプが表示されます。

c. 「次へ」をクリックします。

アイテム・タイプを選択します。アイテム・タイプについてを参照してください。

5. 「表示位置および名前」で、次のステップを実行します。

a. アイテム名 - アイテム名を入力します。この名前によって、アイテムの値を取得するためのハンドルが提供されます。30文字以上のアイテム名はバインド変数構文を使用して参照できません。アイテムのネーミング規則についてを参照してください。

b. 順序: このコンポーネントの順序を指定します。これによって評価の順序が決まります。

c. リージョン - アイテムが配置されるリージョンを決定します。

d. 「次へ」をクリックします。

6. 「アイテム属性」は、次のようにします。

a. ラベル - アイテム・ラベルを入力します。ラベルは、アイテムが表示される際に、その横に表示されるテキストです。ラベルが不要な場合は、ラベル属性を空白のままにします。

b. 高さ - アイテム表示の行の高さの数値を入力します。大部分のアイテムでは、これは1です。

c. テンプレート - オプションで、アイテムの表示を制御するフィールド・テンプレートを選択します。

d. 「次へ」をクリックします。

7. 「設定」は、次のようにします。

a. 必須の値 - 「はい」に設定し、ページ・アイテムが表示されている場合、Application Expressでは、ページの送信時にNOT NULL検証が自動的に実行されます。

ヒント:

「共有コンポーネント」の「テキスト・メッセージ」でメッセージAPEX.PAGE_ITEM_IS_REQUIREDを定義すると、事前定義されたエラー・テキストをアプリケーション固有のエラー・テキストに置換できます。メッセージの表示位置は、アプリケーション・レベル設定の「デフォルトのエラー表示位置」によって定義します。

b. 選択時のページ・アクション - LOVから複数の値を選択できるようにするか、単一の値を選択できるようにするかを指定します。複数の値の場合、カンマ区切りのリストで返されます。

c. 複数選択を許可 - LOVから複数の値を選択できるようにするか、単一の値を選択できるようにするかを指定します。複数の値の場合、カンマ区切りのリストで返されます。

d. 「次へ」をクリックします。

8. 「LOV」で、次のようにします。

a. 「名前付きLOV」で、「名前付きLOVの選択」を選択します。

b. LOV問合せ - 次の構文を使用して問合せを入力します。

STATIC[2]:Display Value[;Return Value],Display Value[;Return Value]

内容は次のとおりです。

- 最初のキーワードはSTATICまたはSTATIC2になります。
STATICでは、値が表示値のアルファベット順でソートされます。STATIC2では、値がリストに入力された順序で表示されます。

- セミコロンは各エントリで表示値と戻り値を区切ります。

- Return Valueはオプションです。Return Valueが含まれない場合、戻り値は表示値と同じになります。

c. 残りの属性を編集し、「次へ」をクリックします。

9. 必要に応じて残りの属性を編集し、「アイテムの作成」をクリックします。
次に例として、3つの異なる静的値リストに対する構文を示します。

トピック:

- 例1: アルファベット順で表示される4つの値

- 例2: リストされた順序で表示される10の値

- 例3: 戻り値および表示値の両方を持つ値リスト

13.3.2.2.1 例1: アルファベット順で表示される4つの値

この例では、アルファベット順で表示される4つの値(Cow、Dog、Cat、Lion)が値リストにあります。各エントリの戻り値は表示値と同じです。

STATIC:Cow,Dog,Cat,Lion

13.3.2.2.2 例2: リストされた順序で表示される10の値

この例では、定義にリストされた順序で表示される10の値が値リストにあります。各エントリの戻り値は表示値と同じです。

STATIC2:10,15,20,25,50,100,200,500,1000,10000

13.3.2.2.3 例3: 戻り値と表示値の両方を持つ値リスト

この例では、YesとNoという2つの値が値リストにあります(表示値Yesとその戻り値Y、表示値Noとその戻り値N)。

STATIC:Yes;Y,No;N

13.3.2.3 カスケードLOVの作成

カスケードLOVを作成すると、ページ上の1つのアイテムによって別のアイテムのLOVが決定されます。アプリケーション・ビルダーでは、選択リスト、シャトル、チェック・ボックス、ラジオ・グループ、ポップアップLOVおよびリスト・マネージャの各アイテム・タイプに対して、カスケードLOVがサポートされています。

ヒント:

アイテム・タイプの詳細は、アイテム・タイプについてを参照してください。

カスケードLOVは、2つのアイテムを作成することによって作成します。2つ目のアイテムに値を移入するには、アイテムの作成ウィザードを実行しているときか、またはアイテムの属性を編集することによって、カスケードLOV親アイテムを指定します。

次の項では、2つの関連する選択リストを作成する方法を示します。この場合、最初のリストの値が2つ目のリストに移入されます。

値のカスケード・リストを作成するには、次の手順を実行します。

1. 最初のアイテムを作成し、そのアイテムにP1_DEPTNOという名前を付けます。

a. 適切なページにナビゲートします。レガシー・コンポーネント・ビューでのページの表示を参照してください。

b. 必要に応じて、リージョンを作成します。リージョンについてを参照してください。

c. 「アイテム」で、「作成」アイコンをクリックします。
アイテムの作成ウィザードが表示されます。

d. 「アイテム・タイプ」で、「選択リスト」を選択します。

e. 「表示位置および名前」で、次のステップを実行します。

- アイテム名: 次のように入力します。

P1_DEPTNO

- 残りのデフォルト値を受け入れ、「次へ」をクリックします。

f. 「アイテム属性」は、次のようにします。

- ラベル - Departmentと入力します

- 残りのデフォルト値を受け入れ、「次へ」をクリックします。

g. 「設定」で、デフォルト値を受け入れ、「次へ」をクリックします。

h. 「LOV」で、次のようにします。

- NULL値の表示: デフォルトの「はい」を受け入れます。

- NULL表示値: 「- Select Department -」と入力します。

- Select Department -

- 「LOV定義」で、次のように入力します。

SELECT dname as d,
deptno as r
FROM dept
ORDER BY dname

- 「次へ」をクリックします。

i. 残りのデフォルト値を受け入れます。

j. 「アイテムの作成」をクリックします。

2. P1_EMPNOという名前の2つ目のアイテムを作成します。

a. 適切なページにナビゲートします。レガシー・コンポーネント・ビューでのページの表示を参照してください。

b. 必要に応じて、リージョンを作成します。リージョンについてを参照してください。

c. 「アイテム」で、「作成」アイコンをクリックします。
アイテムの作成ウィザードが表示されます。

d. 「アイテム・タイプ」で、「選択リスト」を選択します。

e. 「表示位置および名前」で、次のステップを実行します。

- アイテム名: 次のように入力します。

P1_EMPNO

- 残りのデフォルト値を受け入れ、「次へ」をクリックします。

f. 「アイテム属性」は、次のようにします。

- ラベル - Employeeと入力します。

- 残りのデフォルト値を受け入れ、「次へ」をクリックします。

g. 「設定」で、デフォルト値を受け入れ、「次へ」をクリックします。

h. 「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

- 「次へ」をクリックします。

i. 残りのデフォルト値を受け入れます。

j. 「アイテムの作成」をクリックします。

3. 「実行」をクリックし、レンダリングされたページを表示します。
2つの選択リストが表示されます。「Department」選択リストで選択を行うと、「Employees」選択リストに表示される個人が決定されます。

関連項目:

コンポーネント・ビューでのページ・レベル・アイテムの編集

13.3.2.4 表形式フォームを使用した複数のアイテムの作成

複数のアイテムを同時に作成するには、次のステップを実行します。

1. 適切なページにナビゲートします。レガシー・コンポーネント・ビューでのページの表示を参照してください。

2. 必要に応じて、リージョンを作成します。リージョンについてを参照してください。

3. アイテムの作成ウィザードにアクセスします。「アイテム」で、「作成」アイコンをクリックします。
アイテムの作成ウィザードが表示されます。

4. ページ下部の「表形式フォームを使用した複数アイテムの作成」リンクをクリックします。

5. 複数のアイテムの作成ページで、次のように指定します。

a. リージョンにアイテムの作成: アイテムを含めるリージョンを選択します。

b. アイテム・テンプレート: アイテム・テンプレートを選択します。

c. 各アイテムの「順序」、「名前」、「ラベル」、「タイプ」を入力し、アイテムがキャッシュする必要があるかどうかを指定します。

6. 「複数のアイテムの作成」をクリックします。

13.3.3 コンポーネント・ビューでのページ・レベル・アイテムの編集

ページ・アイテム属性を編集するか、または「すべて編集」アイコンか「アイテムの順序変更」アイコンを使用して、ページ・レベル・アイテムを編集できます。

トピック:

- コンポーネント・ビューでのページ・アイテム属性の編集

- デフォルト値の定義

- ページ・アイテムのセキュリティの構成

- クイック選択の作成

- 条件付きページ・アイテムの表示

- 読取り専用ページ・アイテムの表示

- 複数のアイテムの同時編集

関連項目:

アイテム・タイプについて

13.3.3.1 コンポーネント・ビューでのページ・アイテム属性の編集

作成したページ・アイテムは、「ページ・アイテムの編集」ページで編集できます。

ページ・アイテム属性を編集するには、次のステップを実行します。

1. 適切なページにナビゲートします。レガシー・コンポーネント・ビューでのページの表示を参照してください。

2. 「アイテム」で、アイテム名を選択します。

「ページ・アイテムの編集」ページが表示されます。

3. 属性の詳細は、フィールドレベル・ヘルプを参照してください。フィールドレベル・ヘルプの表示を参照してください。

4. 「変更の適用」をクリックします。

関連項目:

クロスサイト・スクリプティング保護の理解

13.3.3.2 デフォルト値の定義

アイテムのデフォルト値は、ページ・アイテムの編集ページの「デフォルト」の下にある属性を使用して定義します。デフォルト値は、アイテムの値がセッション・ステートから導出されない場合およびソース値がNULLの場合に使用されます。

アイテムのデフォルト値を定義するには、次のステップを実行します。

1. アイテムを作成します。コンポーネント・ビューでのページ・レベル・アイテムの作成を参照してください。

2. アイテム属性を表示します。「アイテム」で、アイテム名を選択します。

「ページ・アイテムの編集」ページが表示されます。

3. 「デフォルト」までスクロールします。

4. 「デフォルト値のタイプ」で、次のいずれかを選択します。

- セッション・ステートの置換機能付き静的テキスト

- PL/SQLファンクション本体

- PL/SQL式

5. 「デフォルト値」で、選択に基づいて値またはコードを入力します。

6. 「変更の適用」をクリックします。

13.3.3.3 ページ・アイテムのセキュリティの構成

「ページ・アイテムの編集」ページで、「セキュリティ」リージョンのアイテムのセキュリティを構成できます。

ページ・アイテムのセキュリティを構成するには、次のステップを実行します。

1. アイテムを作成します。コンポーネント・ビューでのページ・レベル・アイテムの作成を参照してください。

2. アイテム属性を表示します。「アイテム」で、アイテム名を選択します。

「ページ・アイテムの編集」ページが表示されます。

3. 「セキュリティ」までスクロールします。

4. 表13-3に示す属性を構成します。

表13-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コメント)は許可されません。

- ブラックリスト&<>"/;,*|=%または--と改行
&、<、>、"、/、;、","、*、|、=、%、"--"、および改行文字は許可されません。

関連項目: クロスサイト・スクリプティング保護の理解

13.3.3.4 クイック選択の作成

アイテム・タイプでクイック選択がサポートされている場合は、「クイック選択」属性を使用して、特定のアイテムの下に表示される選択項目を最大10個定義できます。クイック選択をクリックすると、アイテムの値が設定されます。次の例は、5%、10%、15%および20%のクイック選択を示しています。

クイック選択を作成するには、次のステップを実行します。

1. アイテムを作成します。コンポーネント・ビューでのページ・レベル・アイテムの作成を参照してください。

2. アイテム属性を表示します。「アイテム」で、アイテム名を選択します。
「ページ・アイテムの編集」ページが表示されます。

3. 「クイック選択」までスクロールします。

4. 「クリック選択の表示」で、「はい」を選択します。

5. 各クイック選択のラベルと値を定義します。

a. 「ラベル」で、各選択項目に表示するラベルを入力します。

b. 「値」で、対応する値を入力します。

6. 「リンク属性」で、クイック選択の追加属性を入力します。

7. 「変更の適用」をクリックします。

13.3.3.5 条件付きページ・アイテムの表示

条件付きアイテムを表示するには、次のステップを実行します。

1. アイテムを作成します。コンポーネント・ビューでのページ・レベル・アイテムの作成を参照してください。

2. アイテム属性を表示します。「アイテム」で、アイテム名を選択します。

「ページ・アイテムの編集」ページが表示されます。

3. 「条件」までスクロールします。

4. 「条件タイプ」リストから選択します。

5. 表示されるフィールドに式を入力します。

6. 「変更の適用」をクリックします。

13.3.3.6 読取り専用ページ・アイテムの表示

読取り専用アイテムを表示するには、次のステップを実行します。

1. アイテムを作成します。コンポーネント・ビューでのページ・レベル・アイテムの作成を参照してください。

2. アイテム属性を表示します。「アイテム」で、アイテム名を選択します。
「ページ・アイテムの編集」ページが表示されます。

3. 「読取り専用」までスクロールします。「読取り専用」で、次のステップを実行します。

a. 「読取り専用条件タイプ」から選択します。
アイテムのタイプに応じ、読取り専用アイテムはプレイン・テキストまたは入力不可フィールドとしてレンダリングされます。条件を選択しない場合、アイテムは通常どおりレンダリングされます。

ヒント:

条件タイプを「なし」に設定すると、アイテムは常に入力可能なフィールドとしてレンダリングされます。この設定では、リージョンまたはページ・レベルで定義した読取り専用条件設定がすべて上書きされます。

b. 表示されるフィールドに式を入力します。

c. 「読取り専用の要素表のセル属性」で、HTML表セル・タグ<td>に含める属性を入力します。このタグには、読取り専用モードで表示される際のアイテムも含まれます。次に例を示します。

bgcolor="#FF0000"

ヒント:

読取り専用の要素表のセル属性は、アプリケーションでリージョンおよびページ・アイテムのレイアウトにHTML表を使用する場合のみ、表示されます。

4. 「変更の適用」をクリックします。

13.3.3.7 複数のアイテムの同時編集

アイテム属性でページ上のアイテムの表示方法を制御します。ページ・アイテム・ページを使用して順序、フィールド・ラベル、テンプレート、リージョン、およびページ上のすべてのアイテムの全体的な配置を編集できます。次に続くセクションでは、これらのページを使用したアイテムの編集方法について説明します。

トピック:

- 複数のアイテムの編集

- リージョン・アイテムの再割当て

- 複数のアイテムの削除

- アイテム・ユーティリティの表示

- ページ・アイテム履歴の表示

13.3.3.7.1 複数のアイテムの編集

複数のアイテムを同時に編集するには、次のステップを実行します。

1. アイテムを含むページにナビゲートします。レガシー・コンポーネント・ビューでのページの表示を参照してください。

2. ページ・アイテム・ページにアクセスします。「アイテム」で、「すべて編集」アイコンをクリックします。「すべて編集」アイコンは、鉛筆が置かれた小さいページの形をしています。

「アイテム」タブが表示されます。

ページ上部にナビゲーション・バーが表示されます。他のページにナビゲートするには、「ページ」フィールドを使用します。「名前」フィールドを使用して、特定のアイテムを検索します。表示を特定のリージョンのアイテムのみに限定するには、「リージョン」リストから選択します。

関連項目:

コンポーネント・ビューでのページ・アイテム属性の編集

ページ・アイテム・ページには、編集可能なレポートのアイテムが表示されます。表13-4に、編集可能な属性を示します。

表 13-4 ページ・アイテム上の編集可能な属性

属性

説明

順序

このコンポーネントの表示順序を指定します。これによって評価の順序が決まります。

プロンプト

HTMLフォーム要素のラベルを入力します。HTML、JavaScriptおよびショートカットを含めることができます。置換文字列#CURRENT_ITEM_NAME#を使用して、このラベルに関連するアイテムの名前を取得することもできます。

フィールド・テンプレート

ラベル・テンプレートを決定します。ラベル・テンプレートを使用すると、中心部のユーザー・インタフェースの属性の定義、および多くのラベル間での定義の共有ができます。

リージョン

アイテムを表示するリージョンを定義します。すべてのアイテムは、リージョンに存在します。

新規行

前のアイテムと同じ行に表示するかどうか、または次の行に表示するかどうかを決定します。アイテムはHTML表に配置されます。表の新しい行の第1フィールドとしてアイテムを表示する場合は、「はい」を選択します。

新規フィールド

「はい」に設定すると、このアイテムは固有のHTML表セル(デフォルト)にレンダリングされます。「いいえ」に設定すると、アイテムは前のページ・アイテムと同じHTML表セルにレンダリングされます。

同じ表セルにレンダリングする方が、前のページ・アイテムとの関連性が高く見えます。

幅

このアイテムに対して表示されるフォーム要素の長さを(文字で)指定します。

高さ

テキスト領域および複数の選択リストのための高さを(列で)指定します。

列スパン

アイテムは、HTML表に配置されます。このプロパティは表セルのCOLSPAN属性に使用される値を定義します。

行スパン

アイテムは、HTML表に配置されます。この属性はアイテムを表示する表セルのROWSPAN属性に使用される値を定義します。

PostElement

テキストまたはHTMLコードがページ・アイテム要素の直後にレンダリングされます。

13.3.3.7.2 リージョン・アイテムの再割当て

リージョン・アイテムの再割当てページを使用してアイテムを新しいリージョンに割り当てます。

リージョン・アイテムの再割当てページで新しいリージョンにアイテムを割り当てるには、次のステップを実行します。

1. アイテムを含むページにナビゲートします。レガシー・コンポーネント・ビューでのページの表示を参照してください。

2. ページ・アイテム・ページにアクセスします。「アイテム」で、「すべて編集」アイコンをクリックします。「すべて編集」アイコンは、鉛筆が置かれた小さいページの形をしています。

3. 「リージョン・アイテムの再割当て」をクリックします。
リージョン・アイテムの再割当てページが表示されます。

ページ上部のナビゲーション・バーを使用して、表示を縮小または拡大します。使用可能なオプションは次のとおりです。

- ページ: 新しい番号を選択または入力して「実行」をクリックします。

- リージョンの表示: 表示するリージョンを選択して「実行」をクリックします。

4. アイテムを他のリージョンに再割当てするには、次のステップを実行します。

a. 再割当てするアイテムを選択します。

b. 「リージョンへの割当て」から、新しいリージョンを選択します。

c. 「再割当て」をクリックします。

13.3.3.7.3 複数のアイテムの削除

複数のアイテムを一度に削除するには、複数のアイテムの削除ページを使用します。

複数のアイテムを削除するには、次のステップを実行します。

1. アイテムを含むページにナビゲートします。レガシー・コンポーネント・ビューでのページの表示を参照してください。

2. ページ・アイテム・ページにアクセスします。「アイテム」で、「すべて編集」アイコンをクリックします。「すべて編集」アイコンは、鉛筆が置かれた小さいページの形をしています。

3. 「複数のアイテムの削除」をクリックします。
複数のアイテムの削除ページが表示されます。

ページ上部のナビゲーション・バーを使用して、表示を縮小または拡大します。新しいページにナビゲートするには、「ページ」フィールドを使用します。新しい番号を選択または入力して「実行」をクリックします。

4. アイテムを削除するには、次のステップを実行します。

a. アイテムを選択します。

b. 「アイテムの削除」をクリックします。

13.3.3.7.4 アイテム・ユーティリティの表示

ユーティリティ・ページには、グリッド編集ページが含まれ、選択したアプリケーション内の複数のページのアイテムを編集できるユーティリティが表示されます。

ユーティリティ・ページにアクセスするには、次のステップを実行します。

1. アイテムを含むページにナビゲートします。レガシー・コンポーネント・ビューでのページの表示を参照してください。

2. ページ・アイテム・ページにアクセスします。「アイテム」で、「すべて編集」アイコンをクリックします。「すべて編集」アイコンは、鉛筆が置かれた小さいページの形をしています。

3. 「ユーティリティ」をクリックします。

4. 次のいずれかのレポートを選択します。

- すべてのアイテム・ラベルのグリッド編集

- すべてのアイテム・ヘルプ・テキストのグリッド編集

- アイテム・ヘルプのサブスクリプション

- すべてのページ・アイテム

- 条件付きアイテム

13.3.3.7.5 ページ・アイテム履歴の表示

履歴ページを使用してページ・レベル・アイテムに対して行われた最近の編集の概要を表示します。

履歴ページにアクセスするには、次のステップを実行します。

1. アイテムを含むページにナビゲートします。レガシー・コンポーネント・ビューでのページの表示を参照してください。

2. ページ・アイテム・ページにアクセスします。「アイテム」で、「すべて編集」アイコンをクリックします。「すべて編集」アイコンは、鉛筆が置かれた小さいページの形をしています。

3. 「履歴」をクリックします。

ページ・アイテム履歴ページが表示されます。

13.4 動的アクションの管理

動的アクションにより、開発者は、JavaScriptを必要としないで複雑なクライアント側の動作を宣言的に定義できます。

トピック:

- 動的アクションについて

- 動的アクションの例の表示

- 動的アクション・イベントについて

- ページ・デザイナでの動的アクションの管理

- レガシー・コンポーネント・ビューでの動的アクションの管理

- 動的アクションを使用したJavaScriptのコールについて

- 動的アクションのデバッグ

関連項目:

ページ固有のユーティリティへのアクセス

13.4.1 動的アクションについて

動的アクションは、JavaScriptを必要としないで複雑なクライアント側の動作を宣言的に定義する方法を提供します。動的アクションの作成ウィザードを使用して、定義された条件セットが発生したときに実行されるアクションを指定します。また、アクションの影響を受ける要素や、影響を受ける時期と影響も指定できます。

動的アクションを使用するとき、ページに追加する動的アクションが多くなるほど全体のページ・サイズが大きくなることに注意する必要があります。これは、動的アクション・フレームワークでは、定義された各動的アクションについてクライアントへの追加コードを生成し、そのコードはクライアント内のフレームワークによってダウンロードおよび実行される必要があるためです。問題をデバッグする方法の詳細は、動的アクションのデバッグを参照してください。

動的アクションを実装するプロセスには、次の手順があります。

1. ページ上で、対話グリッド列、アイテム、ボタン、リージョン、JavaScript式またはjQueryセレクタを編集または作成します。このコンポーネントは、起動される時期を定義する際、動的アクション内で参照されます。

2. アクションを起動するアプリケーション・ページから動的アクションを作成します。

3. 動的アクションをテストするためにアプリケーションを実行します。

関連項目:

動的アクションのデバッグ

13.4.2 動的アクションの例の表示

動的アクションの例を表示するには、サンプル・アプリケーションのサンプル動的アクションをインストールします。または、Oracle Learning Library (http://www.oracle.com/oll/apex)に移動します。表示されるフィールドに検索基準(dynamic actionsなど)を入力して「検索」をクリックします。

関連項目:

パッケージ・アプリケーションのインストール

13.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スマートフォン。

- ダイアログのクローズ(apexafterclosedialog): Application Expressのダイアログを閉じたときに起動します。このイベントは、「ダイアログを閉じる」ページ・プロセスまたは「ダイアログを閉じる」動的アクションを使用してダイアログを閉じたときにのみ起動します。サポートされているユーザー・インタフェース・タイプ: デスクトップおよび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スマートフォン。

- プラグイン・コンポーネントによってトリガーされるイベント
これらは現在のアプリケーションに追加されると使用可能になり、イベント名[コンポーネント名]の書式になります。プラグインが発生させるイベントに関連したヘルプについては、「共有コンポーネント」、「プラグイン」、「プラグイン名」、「ヘルプ・テキスト」にナビゲートして、プラグイン構成ページのヘルプ・テキストを参照してください(プラグイン作成者がここにドキュメントを格納している場合があります)。サポートされるユーザー・インタフェース・タイプ: プラグインの「ユーザー・インタフェース」→「サポート対象」設定によって決まります。

- カスタム・イベント:
「カスタム」を選択すると、カスタム・イベントを定義できる追加のフィールドが表示されます。これは、ネイティブまたはプラグインによって提供されるイベントが十分でない場合に役立ちます。

13.4.4 ページ・デザイナでの動的アクションの管理

この項では、ページ・デザイナで動的アクションを管理する方法について説明します。

トピック:

- ページ・デザイナでの動的アクションの作成

- ページ・デザイナでの動的アクションの編集

- 動的アクションのイベント有効範囲の定義

- ページ・デザイナでの動的アクションの削除

13.4.4.1 ページ・デザイナでの動的アクションの作成

動的アクションの作成には、アクションが発生する時期(オプション条件を指定する)、実行されるアクションおよびアクションの影響を受ける要素を指定する手順が含まれます。プロパティ・エディタ属性の詳細は、属性を選択し、中央ペインで「ヘルプ」タブをクリックして、参照してください。

ページ・デザイナで動的アクションを作成するには:

1. ページ・デザイナでページを表示します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. ページを選択します。

ページ・デザイナが表示されます。

2. 左ペインで「動的アクション」タブをクリックします。

3. 「動的アクション」で、「イベント」を右クリックし、「動的アクションの作成」を選択します。

ヒント:

イベント・タイプを選択してから右クリックして、「動的アクションの作成」を選択することもできます。

プロパティ・エディタに動的アクション属性が表示されます。

「メッセージ」タブに、対処が必要なメッセージを示す赤または黄色の印が表示されます。メッセージを選択すると、プロパティ・エディタに関連する属性が表示されます。赤いエラー・メッセージは、保存する前に対処する必要があります。

4. プロパティ・エディタで、次の動的アクション属性を編集します。

ヒント:

属性の詳細は、プロパティ・エディタで属性を選択し、中央ペインで「ヘルプ」タブをクリックして、参照してください。

a. 指定、名前 - 動的アクションの名前を入力します。

b. 実行オプション、順序 - この計算の順序を入力します。これによって実行の順序が決まります。

c. 時期、イベント - 動的アクションを起動するイベントを指定します。

d. 時期、選択タイプ - イベントのトリガーに使用するページ要素または構成体のタイプを選択します。

注意:

選択されたイベントでページ要素の定義がサポートされている場合にのみ、使用できます。「ページのロード」、「ページのアンロード」、「サイズ変更」、「ページの送信前」、「方向の変更」のイベントを選択すると、この属性は非表示になります。他のすべてのイベント・タイプでは、このフィールドが表示されます。

e. クライアント側の条件、タイプ - オプションで、動的アクションのtrueおよびfalseアクション処理を制御する条件のタイプを選択します。クライアント側の条件が定義されていない場合、trueアクションのみが起動します。クライアント側の条件が定義されている場合、条件を満たすと、trueアクションが起動され、条件を満たさない場合は、falseアクションが起動されます。

注意:

宣言的に条件を定義できるように、他のプロパティはタイプに基づいて条件付きで表示されます。条件タイプItem = Valueの例では、ItemおよびValueプロパティが表示され、条件の評価でチェックされます。

次に、イベントがTrueまたはFalseに評価された場合に実行するアクションを定義します。

5. 既存のアクションを編集するには、次のステップを実行します。

a. 動的アクション・ツリーを展開し、既存のアクションを選択します(TrueまたはFalseを選択します)。

b. プロパティ・エディタで、次のアクション属性を編集します。

- アクション - 実行するアクションを指定します。

- 影響を受ける要素 - このアクションが実行されると影響を受けるページ・コンポーネントの定義方法を選択します。選択した要素のタイプに応じて、追加のオプションが表示されます。

- 実行オプション、イベント結果時に実行 - トリガー要素条件が満たされたときにアクションを起動する(Trueアクション)か、満たされないときに起動する(Falseアクション)かをTrueまたはFalseを選択して指定します。条件が指定されていない場合、Trueアクションのみが起動されます。

- 選択タイプ - このアクションが実行されると影響を受けるページ・コンポーネントの定義方法を選択します。

- 初期化時に実行 - 初期化時にアクションを起動するかどうかを指定します。
初期化の意味は、動的アクションがどのように定義されているかによって多少異なります。動的アクションが対話グリッド列で起動するように定義されている場合、これは、対話グリッド行が編集のためにアクティブ化されたときにアクションを起動するかどうかを指定します。他のすべての動的アクションでは、これは、ページがロードされたときにアクションを起動するかどうかを指定します。

6. 新規アクションを追加するには、次のようにします。

a. 「動的アクション」ツリーを展開します。

b. 動的アクションを右クリックし、「TRUEアクションの作成」または「FALSEアクションの作成」を選択します。

c. 前の手順で説明したように、プロパティ・エディタでアクションを編集します。

7. 「保存」をクリックします。

関連項目:

「動的アクション・イベントについて」

13.4.4.2 ページ・デザイナでの動的アクションの編集

動的アクションを作成した後、作成プロセス中に定義した属性を変更したり、プロセス中に指定できなかった属性を指定したり(「認可スキーム」の指定など)、追加のtrueアクションを追加できます。

動的アクションを編集するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. ページを選択します。

ページ・デザイナが表示されます。

2. 左ペインで「動的アクション」タブをクリックします。動的アクションがイベント別に編成されます。

3. 該当するイベントを展開し、動的アクションを選択します。
動的アクションの属性がプロパティ・エディタに表示されます。

4. プロパティ・エディタで、該当する動的アクション属性を編集します。

ヒント:

属性の詳細は、プロパティ・エディタで属性を選択し、中央ペインで「ヘルプ」タブをクリックして、参照してください。

5. 既存のアクションを編集するには、次のステップを実行します。

a. 「動的アクション」ツリーを展開し、「True」または「False」ノードを表示します。

b. 「True」または「False」で、アクションを選択します。

c. プロパティ・エディタでアクションを編集します。

6. 新規アクションを追加するには、次のようにします。

a. 「動的アクション」ツリーを展開します。

b. 動的アクションを右クリックし、「TRUEアクションの作成」または「FALSEアクションの作成」を選択します。

c. プロパティ・エディタでアクションを編集します。

7. 「保存」をクリックします。

関連項目:

- 「コンポーネント・ビューでの動的アクションの作成」

- 「Trueアクションの追加」

- 「頻度と有効範囲の定義」

13.4.4.3 動的アクションのイベント有効範囲の定義

動的アクションを作成した後、アクションの有効範囲を1回のみのトリガーとするか、現在のページの存続期間中とするか、トリガー要素が部分ページ・リフレッシュ(PPR)によって更新されるまでとするかを変更できます。

有効範囲を指定するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. ページを選択します。

ページ・デザイナが表示されます。

2. 左ペインで「動的アクション」タブをクリックします。

3. 「動的アクション」で、動的アクションを選択します。

プロパティ・エディタに、動的アクションの属性が表示されます。

属性は、機能グループに編成されます。これらのグループを展開または縮小するには、「共通の表示」、「すべて表示」、「すべて閉じる」および「すべて開く」アイコンをクリックします。

グループまたは属性を検索するには、「フィルタ・プロパティ」フィールドにキーワードを入力します。

4. プロパティ・エディタですべての属性を表示するには、「すべて表示」をクリックします。

5. 「詳細」で、「イベント有効範囲」を選択します。イベントの有効範囲によって、イベントが2回目または連続して評価されるタイミングが決まります。オプションは次のとおりです。

- 静的: カレント・ページの存続期間中、イベント・ハンドラをトリガー要素にバインドします。ただし、トリガー要素が部分ページ・リフレッシュ(PPR)で更新された場合はバインドされなくなります。

- 動的: 部分ページ・リフレッシュ(PPR)で再作成されるトリガー要素に関係なく、カレント・ページの存続期間中、イベント・ハンドラをトリガー要素にバインドします。

- 1回: イベント・ハンドラをトリガー要素に1回のみバインドします。ページが完全にリフレッシュされるまで、動的アクションが再度トリガーされることはありません。

6. 「保存」をクリックします。

13.4.4.4 ページ・デザイナでの動的アクションの削除

動的アクションを削除するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. ページを選択します。

ページ・デザイナが表示されます。

2. 左ペインで「動的アクション」タブをクリックします。

3. 該当するイベントを展開し、削除する動的アクションを見つけます。

4. 動的アクションを右クリックして、「削除」を選択します。

5. 「保存」をクリックします。

13.4.5 レガシー・コンポーネント・ビューでの動的アクションの管理

開発者は、コンポーネント・ビューで動的アクションを作成および編集できます。

トピック:

- コンポーネント・ビューでの動的アクションの作成

- コンポーネント・ビューでの動的アクションの編集

- Trueアクションの追加

- 頻度と有効範囲の定義

関連項目:

レガシー・コンポーネント・ビューでのページの管理

13.4.5.1 コンポーネント・ビューでの動的アクションの作成

動的アクションの作成には、アクションが発生する時期(オプション条件を指定する)、実行されるアクションおよびアクションの影響を受ける要素を指定する手順が含まれます。

1. 適切なページにナビゲートします。レガシー・コンポーネント・ビューでのページの表示を参照してください。

2. 「ページ・レンダリング」で、「動的アクション」までスクロールして、「作成」アイコンをクリックします。
「動的アクション」ウィザードが表示されます。

3. 「指定」で、次の内容を入力し、「次へ」をクリックします。

- 名前: 動的アクションの名前を入力します。

- 順序: このコンポーネントの順序を入力します。これによって実行の順序が決まります。

4. 「時期」で、次の内容を入力し、「次へ」をクリックします。

a. イベント - 動的アクションを起動するイベントを指定します。動的アクション・イベントについてを参照してください。

b. 選択タイプ: 動的アクションをトリガーするページ要素のタイプを選択します。ページ要素の名前を指定するための対応する名前フィールドが表示されます。

注意:

選択されたイベントでページ要素の定義がサポートされている場合にのみ、使用できます。「ページのロード」、「ページのアンロード」、「サイズ変更」、「ページの送信前」、「方向の変更」のイベントを選択すると、このフィールドは非表示になります。他のすべてのイベント・タイプでは、このフィールドが表示されます。

c. 動的アクションをトリガーする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式を入力します。

d. 条件: 条件を指定するには、「条件」リストから選択します。条件タイプによっては、条件をテストする値を入力する必要がある場合があります。条件が指定されない場合、Trueアクションのみが起動されます。条件を指定する場合、条件を満たすと、Trueアクションが起動され、条件を満たさない場合は、Falseアクションが起動されます。

5. 「Trueアクション」で、以前指定されたイベントが発生して条件が満たされた場合に実行されるアクションを指定し、「次へ」をクリックします。

- アクション - 条件が満たされた場合または「- 条件なし -」が指定されている場合に起動するTrueアクションを選択します。選択されたアクションによっては、追加のオプションが表示されます。

ヒント:

詳細は、フィールドレベル・ヘルプを参照してください。フィールドレベル・ヘルプの表示を参照してください。

- ページのロード時に実行 - ページをロードするときにこのアクションをトリガーするには、このオプションを選択します。選択したアクションのタイプに応じて、このオプションを選択する場合もあれば、選択しない場合もあります。

- 反対のFALSEアクションの生成: 反対のFALSEアクションも生成するには、このオプションを選択します。反対のアクションとして扱われるものには、「表示/非表示」、「有効/無効」および「クラスの追加/クラスの削除」があります。このオプションは、上述のアクションのいずれかが選択された場合および条件が指定された場合にのみ表示されます。

6. 「影響を受ける要素」(影響を受ける要素がサポートされているアクションでのみ使用可能)で、この動的アクションによる影響を受ける要素と要素が受ける影響を指定し、「次へ」をクリックします。
動的アクションを作成する最終ステップは、影響を受ける要素の選択が、選択したアクションによってサポートされているかどうかによって異なります。「ページの送信」のような一部のアクションでは、影響を受ける要素を選択する必要はありません。「表示」などの他のアクションでは、影響を受ける要素を選択する必要があります。影響を受ける要素の選択が、選択したアクションによってサポートされていない場合、最後のページは動的アクションの詳細を確認できる、確認ページとなります。影響を受ける要素の選択が、選択したアクションによってサポートされている場合、このページのオプションは次のとおりです。

- 選択タイプ: 動的アクションによる影響を受けるページ要素のタイプを選択します。選択されたタイプによって、追加のオプションが表示されます。これらのオプションを使用して、要素が受ける影響を指定するために必要な追加の設定と値を指定します。

ヒント:

詳細は、選択を行ってからフィールドレベル・ヘルプを参照してください。フィールドレベル・ヘルプの表示を参照してください。

7. 「動的アクションの作成」をクリックします。

13.4.5.2 コンポーネント・ビューでの動的アクションの編集

動的アクションを作成した後、作成プロセス中に定義した属性を変更したり、プロセス中に指定できなかった属性を指定したり(「認可スキーム」の指定など)、追加のtrueアクションを追加できます。

動的アクションを編集するには、次のステップを実行します。

1. 適切なページにナビゲートします。レガシー・コンポーネント・ビューでのページの表示を参照してください。

2. 「ページ・レンダリング」で、「動的アクション」までスクロールして、変更する動的アクションをクリックします。

動的アクションの編集ページが表示されます。

3. 対象となる属性を編集します。

属性の詳細は、フィールドレベル・ヘルプを参照してください。フィールドレベル・ヘルプの表示を参照してください。

4. 「変更の適用」をクリックします。

関連項目:

コンポーネント・ビューでの動的アクションの作成、Trueアクションの追加および頻度と有効範囲の定義

13.4.5.3 Trueアクションの追加

この項では、Trueアクションを追加する方法について説明します。

トピック:

- Trueアクションの追加について

- Trueアクションの追加

13.4.5.3.1 Trueアクションの追加について

動的アクションには、Trueアクションが起動する時期を制御するために指定できる条件が含まれています。たとえば、従業員情報をマネージャに表示するアプリケーションについて考えます。従業員が上級一般職の場合は給与が表示され、それ以外の場合は時給が表示されます。

動的アクション作成ウィザードでは、1つのTrueアクションのみ指定できます。複数のアクションを追加するには、動的アクションを作成するための作成ウィザードを使用した後、Trueアクションを追加するようにアクションを編集する必要があります。

13.4.5.3.2 Trueアクションの追加

アクションを追加するには、次の手順を実行します。

1. 適切なページにナビゲートします。レガシー・コンポーネント・ビューでのページの表示を参照してください。

2. 「ページ・レンダリング」で、「動的アクション」までスクロールして、変更する動的アクションをクリックします。
動的アクションの編集ページが表示されます。

3. 条件が満たされたとき、または条件が指定されなかったときに実行されるアクションを追加するには、「Trueアクション」までスクロールして、「Trueアクションの追加」をクリックします。
アクションの作成/編集ページが表示されます。

4. 「指定」で、次の項目を指定します。

a. 順序: このコンポーネントの順序を入力します。これは、実行順序を示します。

b. アクション: 条件がtrueのときにトリガーされるアクションを選択します。

5. 「実行オプション」で、次の項目を指定します。

a. ページのロード時に実行: ページをロードするときにもアクションをトリガーする場合に選択します。

b. 対象となる属性を編集します。
属性の詳細は、フィールドレベル・ヘルプを参照してください。フィールドレベル・ヘルプの表示を参照してください。

6. 「影響を受ける要素」で、次の項目を指定します(選択されたアクションで、影響を受ける要素の定義がサポートされる場合にのみ使用可能)。

注意:

選択されたアクションのタイプによって、次のフィールドの一部またはすべてを選択できないことがあります。たとえば、「無効化」アクションでは、影響を受ける要素として「リージョン」を選択することがサポートされていません。

a. 選択タイプ: 動的アクションによる影響を受けるページ要素のタイプを選択します。ページ要素の名前を指定するための対応する名前フィールドが表示されます。

7. 「コメント」に、開発者のコメントまたは注意を入力します。これらのコメントは、アプリケーションの実行中に表示されません。

8. 「作成」をクリックします。
動的アクションの編集ページが表示され、追加したアクションが「Trueアクション」の下に表示されます。

13.4.5.4 頻度と有効範囲の定義

動的アクションを作成した後、アクションの有効範囲を1回のみのトリガーとするか、現在のページの存続期間中とするか、トリガー要素が部分ページ・リフレッシュ(PPR)によって更新されるまでとするかを変更できます。

有効範囲を指定するには、次のステップを実行します。

1. 適切なページにナビゲートします。レガシー・コンポーネント・ビューでのページの表示を参照してください。

2. 「ページ・レンダリング」で、「動的アクション」までスクロールして、変更する動的アクションをクリックします。
動的アクションの編集ページが表示されます。

3. 「詳細」までスクロールします。「イベント有効範囲」で、次のいずれかを選択します。

a. 静的(デフォルト): 現在のページの存続期間中、イベント・ハンドラをトリガー要素にバインドします。ただし、トリガー要素が部分ページ・リフレッシュ(PPR)を通じて更新された場合はバインドされなくなります。

b. 動的: 現在のページの存続期間中、イベント・ハンドラをトリガー要素にバインドします(部分ページ・リフレッシュ(PPR)を通じて更新されたトリガー要素を含む)。「動的」を指定すると、追加のフィールド「静的コンテナ(jQueryセレクタ)」が表示されます。静的コンテナを指定すると、動的イベント有効範囲でのイベント処理のパフォーマンスの向上に役立ちます。これは、それ自体は再生成されないページの要素ですが、部分ページ・リフレッシュ(PPR)によって再生成されるトリガー要素を含みます。この要素参照は、jQueryセレクタとして定義する必要があります。たとえば、(PPRによって再作成される)対話モード・レポート・リージョンの行になんらかの処理を実行する動的アクションがある場合、レポートのリフレッシュ後も動的アクションが機能するようにするには、「イベント有効範囲」が「動的」である必要があります。また、静的コンテナの値を、リージョンの静的ID値を選択するjQueryセレクタに設定できます(例: '#my_region')。

c. 1回: 1回のみのイベントについて、イベント・ハンドラをトリガー要素にバインドします。

4. 「変更の適用」をクリックします。

13.4.6 動的アクションを使用したJavaScriptのコールについて

動的アクションを作成することによっても、JavaScriptコードを実行できます。JavaScriptコードは、「JavaScriptコードの実行」および「値の設定」タイプで実行できます。クライアント側の条件タイプを「JavaScript式」に設定することにより、動的アクションの条件に対してJavaScriptコードを使用することもできます。

関連項目:

動的アクションの管理

13.4.7 動的アクションのデバッグ

この項では、Oracle Application Expressで動的アクションをデバッグする方法について説明します。

トピック:

- 動的アクションのデバッグについて

- 動的アクションのデバッグ

13.4.7.1 動的アクションのデバッグについて

Oracle Application Express内での動的アクションのデバッグは、他のデバッグと少し異なります。これは、動的アクション・フレームワーク内で実行される処理の多くが、サーバー側でなくクライアント側で実行されるためです。動的アクションをデバッグするには、ブラウザでJavaScriptコンソールがサポートされている場合、Oracle Application Expressがデバッグ情報をブラウザのJavaScriptコンソールに出力します(たとえば、FirebugがインストールされたFirefoxは、デバッグ情報を「Console」ペインに表示します)。デバッグ情報により、動的アクションが起動した時期、および動的アクションについての追加情報が次の形式で表示されます。

Dynamic Action Fired: [Dynamic Action name] ([Action name]) {JavaScript object containing all Dynamic Action information}

この形式によって、動的アクション名、トリガーされたアクションを示すアクション名、動的アクションに関する多くの情報(WHEN要素、影響を受ける要素、イベント・オブジェクト、動的アクションに関連付けられているデータなど)を含むJavaScriptオブジェクトを識別できます。

13.4.7.2 動的アクションのデバッグ

動的アクションをデバッグするには、次のステップを実行します。

1. 動的アクションが含まれているアプリケーションのデバッグが有効化されていることを確認します。デバッグ・モードの使用を参照してください。

2. 動的アクションが含まれているページを実行します。

3. ブラウザのJavaScriptコンソールを開きます。

4. 開発者ツールバーで、「デバッグ」をクリックします。

ページがリフレッシュされます。ページのロード時に起動するように設定されている動的アクションがある場合は、ブラウザ・コンソールにデバッグ出力が表示されます。

デバッグ情報はデバッグ・モードで実行されている場合にのみ出力されるため、デバッグ・モードをオンのままにすることで、動的アクションが予期される時期に起動されるかどうかをさらにテストできます。たとえば、ある特定のアイテムの値が変更されるときに起動する動的アクションを定義した場合、そのアイテムの値を変更すると、動的アクションが起動したかどうかのデバッグ出力がコンソールに表示されます。

13.5 ボタンの作成

アプリケーションを設計する際、ボタンを使用して、特定のページまたはURLを表示したり、情報をポストまたは処理するようにできます(たとえば、「作成」、「取消」、「次へ」、「前へ」または「削除」ボタンを作成します)。

トピック:

- ボタンで実行できる操作

- ページ・デザイナでのボタンの管理

- レガシー・コンポーネント・ビューでのボタンの管理

- ボタンからのJavaScriptのコールについて

- ボタン名とREQUESTの関係について

- ボタンを使用したブランチ処理について

関連項目:

ボタンのURLからのページのコールおよびページ固有のユーティリティへのアクセス

13.5.1 ボタンで実行できる操作

ボタンでは、様々なタイプの操作を実行できます。次の操作を実行できます。

- ページの送信(フォーム・ページに対する変更の保存など)

- 異なるページまたはカスタムURLのいずれかへのリダイレクト

- 実行しない(ボタンの動作が「動的アクション」で定義されていない場合など)。

13.5.2 ページ・デザイナでのボタンの管理

この項では、ページ・デザイナでボタンを管理する方法について説明します。

トピック:

- ページ・デザイナでのボタンの作成

- ページ・デザイナでのボタンの編集

- ボタンの条件付き表示

- 保存されていない変更についてユーザーに警告するためのボタン属性の構成

関連項目:

レガシー・コンポーネント・ビューでのボタンの管理

13.5.2.1 ページ・デザイナでのボタンの作成

ページ・デザイナでボタンを作成するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. ページを選択します。

ページ・デザイナが表示されます。

2. 必要に応じて、アイテムを含めるリージョンを作成します。

3. ギャラリで、「ボタン」タブをクリックします。

ボタンにカーソルをあわせると、ボタンを説明するツールチップが表示されます。

4. ボタンを右クリックして「追加先」を選択し、適切な位置を選択します。

ヒント:

または、マウスを使用してボタンを選択して、「レイアウト」タブの適切な位置までドラッグします。

プロパティ・エディタにボタン属性が表示されます。

5. プロパティ・エディタですべての属性を表示するには、「すべて表示」をクリックします。

6. グループまたは属性を検索するには、「フィルタ・プロパティ」フィールドにキーワードを入力します。

7. プロパティ・エディタで該当する属性を編集します。

ヒント:

属性の詳細は、プロパティ・エディタで属性を選択し、中央ペインで「ヘルプ」タブをクリックして、参照してください。

8. 「保存」をクリックします。

関連項目:

リージョンについて

13.5.2.2 ページ・デザイナでのボタンの編集

ページ・デザイナでリージョン・ボタンを作成するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. ページを選択します。

ページ・デザイナが表示されます。

2. 「レンダリング」タブまたは「レイアウト」タブのいずれかで、編集するボタンを選択します。

プロパティ・エディタの右ペインにボタン属性が表示されます。

プロパティ・エディタでは、属性が機能グループに編成されます。これらのグループを展開または縮小するには、「共通の表示」、「すべて表示」、「すべて閉じる」および「すべて開く」アイコンをクリックします。

3. 属性を検索するには、「フィルタ・プロパティ」フィールドにキーワードを入力します。

属性が表示されます。

4. ボタン属性を編集します。

ページが保存されるまで、編集した属性の属性名の左側に青色のマーカーが表示されます。

注意:

属性の詳細は、フィールドレベル・ヘルプを参照してください。

5. 「保存」をクリックします。

13.5.2.3 ボタンの条件付き表示

ボタンを条件付きで表示するには、「ページ・ボタンの編集」ページの属性を編集します。

ボタンを条件付きで表示するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. ページを選択します。

ページ・デザイナが表示されます。

2. 「レンダリング」タブまたは「レイアウト」タブのいずれかで、編集するボタンを選択します。

プロパティ・エディタが変更されてボタン属性が表示されます。

属性は、機能グループに編成されます。これらのグループを展開または縮小するには、「共通の表示」、「すべて表示」、「すべて閉じる」および「すべて開く」アイコンをクリックします。

3. グループまたは属性を検索するには、「フィルタ・プロパティ」フィールドにキーワードを入力します。

4. 「サーバー側の条件」を見つけて展開します。タイプを選択し、表示されたフィールドに適切な情報を入力します。

ヒント:

属性の詳細は、プロパティ・エディタで属性を選択し、中央ペインで「ヘルプ」タブをクリックして、参照してください。

5. 「保存」をクリックします。

関連項目:

バインド変数構文を使用したセッション・ステートの参照

13.5.2.4 保存されていない変更についてユーザーに警告するためのボタン属性の構成

開発者は、「保存されていない変更の警告」ボタンを使用して、ユーザーがボタンをクリックしてページから移動しようとしたときに、保存されていない変更について警告できます。

「保存されていない変更の警告」属性を構成するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. ページを選択します。

ページ・デザイナが表示されます。

2. 「レンダリング」タブまたは「レイアウト」タブのいずれかで、編集するボタンを選択します。

プロパティ・エディタが変更されてボタン属性が表示されます。

3. 「動作」を見つけて展開します。

ヒント:

属性を検索するには、「フィルタ・プロパティ」フィールドにキーワードを入力します。属性が表示されます。

4. 「保存されていない変更の警告」で、次のいずれかを選択します。

- ページのデフォルトc「保存されていない変更の警告」がページ・レベルで有効化されている場合に、ボタンがクリックされたときに保存されていない変更をチェックします。

- チェックしない: 保存されていない変更のチェックは、ボタンがクリックされたときに実行されません。この設定は、「取消」、「削除」および「変更の適用」ボタンで使用します。

5. 「保存」をクリックします。

ヒント:

「保存されていない変更の警告」属性は、apex.page.warnOnUnsavedChanges APIを使用して実装されます。

関連項目:

保存されていない変更についてユーザーに警告するためのページ属性の構成およびOracle Application Express APIリファレンス

13.5.3 レガシー・コンポーネント・ビューでのボタンの管理

開発者は、コンポーネント・ビューでボタンを作成および編集します。

トピック:

- コンポーネント・ビューでのボタンの作成

- コンポーネント・ビューでの複数のボタンの作成

- レガシー・コンポーネント・ビューでのボタンの編集

- ボタンの条件付き表示

関連項目:

レガシー・コンポーネント・ビューでのページの管理

13.5.3.1 コンポーネント・ビューでのボタンの作成

コンポーネント・ビューでリージョン・ボタンを作成するには、次のステップを実行します。

1. 適切なページにナビゲートします。レガシー・コンポーネント・ビューでのページの表示を参照してください。

2. 必要に応じて、リージョンを作成します。リージョンについてを参照してください。

3. 「ボタン」で、「作成」アイコンをクリックします。

4. 「ボタン・リージョン」で、ボタンのリージョンを選択して「次へ」をクリックします。

5. 「ボタン位置」で、次のステップを実行します。

a. 位置 - このボタンの位置を選択します。

- リージョン位置にボタンの作成: リージョン位置にボタンを配置する場合は、このオプションを選択します。リージョン位置は、リージョン・テンプレートで定義された位置です。

- このリージョン・アイテムで表示されるボタンの作成: ページ・アイテム内またはページ・アイテム間にボタンを表示する場合は、このオプションを選択します(たとえば、フォーム・フィールドの横にボタンを直接追加する場合)。

b. 「次へ」をクリックします。

6. 「ボタン属性」は、次のようにします。

ヒント:

属性の詳細は、フィールドレベル・ヘルプを参照してください。フィールドレベル・ヘルプの表示を参照してください。

a. ボタン名: 対象のボタンの名前を入力します。「ページの送信」のアクションを行うボタンでは、ボタンの名前がページ・リクエストの値になります。たとえば、ボタンにFLOW_RESET_BUTTONという名前を付けると、送信を行わずにカレント・ページをリセットすることがボタンの目的になります。

b. ラベル: ボタンに表示するラベルを入力します。

c. ボタン・テンプレート: どのテンプレートでボタンの表示を制御するかを定義します。ボタン・テンプレートは、テンプレート・ページで定義します。少なくとも1つのボタン・テンプレートを定義しておかないと、ボタン・テンプレートを使用できません。

d. ボタン・タイプ: この属性を使用して、ボタン・テンプレートの「標準」または「ホット」いずれかのテンプレートを選択します。
「ホット」を選択すると、ボタン・テンプレートの「ホット・テンプレート」属性に格納されたテンプレートを使用してボタンがレンダリングされます。値が定義されない場合、標準のボタン・テンプレートが使用されます。

e. ボタン属性: 入力したテキストは、HTML要素の定義に追加されます。次の例では、テキスト・ボタンのクラスを設定しています。

class="myclass"

テンプレートに基づくボタンの場合、テンプレートに#BUTTON_ATTRIBUTES#置換文字列を含める必要があります。これを使用してタブの停止を制御できます。次に例を示します。

tabindex="3"

f. 「次へ」をクリックします。

「表示プロパティ」が表示されます。「表示プロパティ」に表示されるオプションは、選択されたリージョン位置によって決まります。

7. 「表示プロパティ」で、次のステップを実行します。

- ボタン位置が「リージョン位置にボタンの作成」の場合は、次の項目を指定します。

- 順序: このコンポーネントの順序を入力します。これによって評価の順序が決まります。

- 位置: このボタンの位置を選択します。

- 位置合せ: 「右」または「左」を選択します。

- 「次へ」をクリックします。

- ボタン位置が「このリージョン・アイテムで表示されるボタンの作成」の場合は、次の項目を指定します。

- 順序: このコンポーネントの順序を入力します。これによって評価の順序が決まります。

- 「次へ」をクリックします。

8. 「クリックされたときのアクション」で、次のステップを実行します。

a. ヒント:

属性の詳細は、フィールドレベル・ヘルプを参照してください。フィールドレベル・ヘルプの表示を参照してください。

アクション: ボタンがクリックされたときの動作を選択します。

b. 検証の実行: 「検証の実行」では、ページ送信時の検証の実行を制御します。たとえば、ユーザーがレコードを削除しているときに、「削除」ボタンに無関係な検証エラー・メッセージを表示しないようにする場合に使用できます。
この設定に関係なく特定の検証を常に実行する場合、検証属性の「常に実行」を「はい」に設定します。詳細は、検証の実行タイミングの決定についてを参照してください。

c. 「次へ」をクリックします。

9. 「条件付き表示」で、対象のコンポーネントをレンダリングするうえで満たす必要がある条件タイプをリストから選択します。

10. 「ボタンの作成」をクリックします。

関連項目:

ボタン名とREQUESTの関係について

13.5.3.2 コンポーネント・ビューでの複数のボタンの作成

コンポーネント・ビューでは、複数のボタンの作成ウィザードを使用して、同じリージョン内に複数の「ページの送信」ボタンを一度に作成できます。

一度に複数のボタンを作成するには、次のステップを実行します。

1. 適切なページにナビゲートします。レガシー・コンポーネント・ビューでのページの表示を参照してください。

2. 必要に応じて、リージョンを作成します。リージョンについてを参照してください。

3. コンポーネント・ビューで「ボタン」セクションを探し、「作成」アイコンをクリックします。

ボタンの作成ウィザードが表示されます。

4. 「複数のボタンの作成」リンクをクリックします。

「複数のボタンの作成」ウィザードが表示されます。

5. 「リージョン」で、このボタンを含めるリージョンを選択します。

6. 「テンプレート」からテンプレートを選択します。テンプレートを選択しない場合、HTMLスタイルのボタンが作成されます。

7. 「HTML属性」で、これらのボタンのHTML属性を指定します。このテキストがHTML要素の定義に追加されます。たとえば、テキスト・ボタンのクラスを次のように設定できます。

class="myclass"

8. 残りのフィールドに迅速に移入するには、ページの右側にある「クイック・ボタン」リストから選択します。

9. 「ボタンの作成」をクリックします。

13.5.3.3 レガシー・コンポーネント・ビューでのボタンの編集

開発者は、コンポーネント・ビューでボタンを編集できます。

トピック:

- ボタン属性の編集

- 「検証の実行」について

- 複数のボタンの同時編集

13.5.3.3.1 ボタン属性の編集

既存のボタンの属性を編集するには、次のようにします。

1. 適切なページにナビゲートします。レガシー・コンポーネント・ビューでのページの表示を参照してください。

2. 「ボタン」で、ボタン名を選択します。

3. ボタン属性を編集します。

属性の詳細は、フィールドレベル・ヘルプを参照してください。フィールドレベル・ヘルプの表示を参照してください。

4. 「変更の適用」をクリックします。

13.5.3.3.2 「検証の実行」について

ページ・ボタンの編集ページの「ボタンがクリックされたときのアクション」、「検証の実行」属性は、ページを送信するときの検証の実行を制御します。たとえば、ユーザーがレコードを削除しているときに、「削除」ボタンに無関係な検証エラー・メッセージを表示しないようにする場合に使用できます。

「検証の実行」では、次を選択できます。

- はい: ページが送信され、この属性が「はい」に設定されている場合、そのページに定義されているすべての検証とすべての組込みの検証が実行されます(たとえば、必須の値が設定されていることを確認するためや、その値が有効な数値や日付であるかどうかを判別するため)。

- いいえ: 「いいえ」に設定すると、定義済の検証と組込みの検証はいずれも実行されません。

この設定に関係なく特定の検証を常に実行する場合、検証属性の「常に実行」を「はい」に設定します。

関連項目:

検証の実行タイミングの決定について

13.5.3.3.3 複数のボタンの同時編集

ボタン・ページを使用して、複数のボタンを削除したり、最近の変更の履歴を表示します。

一度に複数のボタンを編集するには、次のステップを実行します。

1. 適切なページにナビゲートします。レガシー・コンポーネント・ビューでのページの表示を参照してください。

2. 「ボタン」で、「すべて編集」アイコンをクリックします。「すべて編集」アイコンは、鉛筆が置かれた小さいグリッドの形をしています。

ボタン・ページが表示されます。ボタン・ページには、リージョン内のボタンのリストを示す表が含まれています。

3. 属性を編集し、「変更の適用」をクリックします。

トピック:

- 複数のボタンの削除

- 履歴

13.5.3.3.3.1 複数のボタンの削除

一度に複数のボタンを削除するには、次のステップを実行します。

1. 適切なページにナビゲートします。レガシー・コンポーネント・ビューでのページの表示を参照してください。

2. 「ボタン」で、「すべて編集」アイコンをクリックします。「すべて編集」アイコンは、鉛筆が置かれた小さいグリッドの形をしています。

ボタン・ページが表示されます。ボタン・ページには、リージョン内のボタンのリストを示す表が含まれています。

3. 「複数のボタンの削除」をクリックします。

複数のボタンの削除ページが表示されます。

4. 削除するボタンを選択して、「ボタンの削除」をクリックします。

13.5.3.3.3.2 履歴

履歴ページを使用して、ボタンの最近の変更のサマリーを表示します。

13.5.3.4 ボタンの条件付き表示

ボタンを条件付きで表示するには、「ページ・ボタンの編集」ページの属性を編集します。

ボタンを条件付きで表示するには、次のステップを実行します。

1. ボタンを作成します。コンポーネント・ビューでのボタンの作成を参照してください。

2. 適切なページにナビゲートします。レガシー・コンポーネント・ビューでのページの表示を参照してください。

3. 「ボタン」で、ボタン名をクリックします。

4. 「条件」までスクロールします。

5. 「条件タイプ」リストから選択します。

6. 表示されるフィールドに式を入力します。

7. 「変更の適用」をクリックします。

関連項目:

バインド変数構文を使用したセッション・ステートの参照

13.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を使用しなくても、この例を簡単に実装できます。かわりに、同様に翻訳可能な宣言的アクションの「確認」と「ページの送信」を使用できます。詳細は、動的アクションの管理を参照してください。

13.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の名前で、大/小文字が区別されます。

13.5.6 ボタンを使用したブランチ処理について

各ページには、任意の数のブランチを含めることができます。ブランチは、アプリケーションの他のページまたはURLにリンクします。Application Expressでは、ページ・プロセス中の異なる時点でブランチが検討されます。プロセス前、計算前、検証前およびプロセス後のどの時点でブランチするかを選択できます。アプリケーション・ビルダーの他のコントロールと同様に、ブランチ処理には条件を設定できます。たとえば、ユーザーがボタンをクリックした場合にブランチできます。ブランチを作成する場合は、ブランチを特定のボタンに関連付けます。ブランチは、ユーザーがボタンをクリックした場合にのみ検討されます。

関連項目:

ブランチを使用したナビゲーションの制御

13.6 ツリーの作成

ツリーは階層情報を明確かつ使いやすい形式で表示します。SQL問合せを使用してツリー・コントロールを作成できます。

ヒント:

Oracle Application Expressリリース5.0では、引き続き既存のjsTreeリージョンを編集できますが、作成はできなくなりました。ツリーについてを参照してください。

トピック:

- ツリーについて

- レガシーjsTreeのサポートについて

- ページ・デザイナでのツリーの管理

- レガシー・コンポーネント・ビューでのツリーの管理

関連項目:

ツリーの例を表示するには、パッケージ・アプリケーションであるサンプル・ツリーをインストールします。

完全開発環境でのパッケージ・アプリケーションの管理を参照してください。

13.6.1 ツリーについて

アプリケーション・ビルダーには、階層表示を示すツリーを生成するための組込みウィザードが用意されています。Oracle Application Expressリリース5.0では、ツリーで新しいAPEXツリー実装が使用されます。レガシーjsTreeリージョンと同様に、この新しいツリー実装は、オプションのキーボード・ナビゲーションおよびオプションのステート保存の機能を持つ、JavaScriptベースのブラウザに依存しないツリー・コンポーネントです。APEXツリーは、jsTreeと同じ機能を共有しますが、例外として、テンプレート属性は新しいツリーに適用されません。新しい実装では、外観、有用性およびアクセシビリティも向上します。引き続き既存のjsTreeリージョンを編集できますが、作成はできなくなりました。

ツリーは、表またはビューでIDと親ID列を識別することによって階層関係を指定する問合せから作成できます。ツリー問合せでは、START WITH .. CONNECT BY句を利用して、階層問合せを生成します。

ヒント:

APEXツリー・リージョンは、「デスクトップ」ユーザー・インタフェースを使用したページでのみ作成できます。

13.6.2 レガシーjsTreeのサポートについて

以前のリリースのOracle Application Expressでは、jsTreeツリー・リージョンの作成がサポートされていました。既存のツリーはまだサポートされていますが、Oracle Application ExpressではjsTreeツリー・リージョンの作成はサポートされなくなりました。Oracle Application Expressでは、現在、APEXツリーのツリー・リージョンの生成がサポートされています。APEXツリーは、jsTreeに類似したJavaScriptベースのブラウザに依存しないツリー・コンポーネントです。

13.6.3 ページ・デザイナでのツリーの管理

この項では、ページ・デザイナでツリーを管理する方法について説明します。

トピック:

- 新しいページでのツリーの作成

- ページ・デザイナでのツリーの作成

- ページ・デザイナでのツリー属性の編集

13.6.3.1 新しいページでのツリーの作成

ツリーは問合せに基づき、階層形式で表現できるデータを戻します。ページの作成ウィザードを使用してツリーを作成すると、ウィザードにより、選択したオプションに基づいてこの階層問合せが生成されます。

新しいページでツリーを作成するには、次のステップを実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「ページの作成」をクリックします。

4. 「ページの作成」で、次のステップを実行します。

a. ユーザー・インタフェース - 「デスクトップ」を選択します。

b. ページ・タイプの選択 - 「ツリー」を選択します。

c. 「次へ」をクリックします。

5. 「ページ属性」で、次のように指定します。

a. ページ番号: ツリーを作成する必要があるページを指定します。

b. ページ名: 新しいページにツリーを作成する場合、ページ名を入力します。

c. ページ・モード: ページ・モードを選択します。

d. ページ・グループ: このページと関連付けるページ・グループの名前を選択します。このオプションは、アプリケーションにグループが含まれる場合にのみ表示されます。

e. リージョン・テンプレート: ツリー・リージョンのリージョン・テンプレートを選択します。

f. リージョン名: ツリーを含めるリージョンの名前を入力します。

g. ブレッドクラム: ページでブレッドクラム・ナビゲーション・コントロールを使用するかどうか、およびどのブレッドクラム・ナビゲーション・コントロールを使用するかを選択します。「ブレッドクラム」を選択した場合、次のように入力します。

- エントリ名: ブレッドクラム・エントリの名前を入力します。

- 親エントリの選択: 親エントリを選択します。

h. 「次へ」をクリックします。

6. 「ナビゲーションのプリファレンス」で、このページに含めるナビゲーションのタイプを指定し、「次へ」をクリックします。ナビゲーション・オプション(ナビゲーション・メニューまたはタブなど)はカレント・アプリケーションのテーマに応じて決まります。

7. 「表/ビューの所有者」および「表/ビューの名前」で次を実行します。

a. 表/ビューの所有者: ツリーの基になる表の所有者を選択します。

b. 表/ビューの名前: マスター・ページに含める列を含む表またはビューを選択します。

c. 「次へ」をクリックします。

8. 「問合せ」で、IDおよび親IDとして使用する列を指定し、ノードに表示するテキストを指定します。

a. ID: IDとして使用する列を選択します。

b. 親ID: 親IDとして使用する列を選択します。

c. ノード・テキスト: ツリー・ノードに表示するテキストを選択します。

d. 開始: 階層ツリー問合せのルートを指定するために使用する列を選択します。

e. ツリーを開始: 問合せの開始方法を選択します。オプションは次のとおりです。

- 既存のアイテムに基づく: 既存のアプリケーション・アイテムまたはページ・アイテムを選択します。

- SQL問合せに基づく: 単一行または単一列を返すSQL問合せを入力します。

- 静的値に基づく: 静的値を入力します。

- 値: NULLです。

f. 「次へ」をクリックします。

9. 「WHEREおよびORDER BY」で、次のように指定します。

a. WHERE句: オプションのWHERE句を入力します。次に例を示します。

ename='JONE'

b. ORDER SIBLINGS BY: 列による兄弟の並替えを選択します(ENAMEなど)。デフォルト値は、選択した「ノード・テキスト」列に基づきます。

c. 「次へ」をクリックします。

10. 「ツリー属性」で、次のように指定します。

a. ボタンを含む: 含めるボタンを選択します。

b. 選択したノードのページ・アイテム: 選択したノード値を保持するページまたはアプリケーション・アイテムを選択します。このアイテムを使用して、最後に選択したツリー・ノードの値を保持することで、ツリーの状態を保存できます。選択したノードの値は、ノード・リンク属性またはページ・プロセスを使用して、選択したアイテムに保存できます。ツリーがリロードされると、最後に選択したツリー・ノードがツリーに開きます。

c. ツールチップ: マウスをリーフ・ノードに合わせたときにツールチップを表示します。オプションは次のとおりです。

- 静的割当て: ツールチップ・テキストとして使用する静的値を指定します。静的テキストで置換文字列を使用して、SQL問合せからの情報をツールチップ・テキストに組み込むことができます。使用可能な置換文字列は次のとおりです。
#VALUE#: 「ID」列の値を参照します。

#TITLE#: 「ノード・テキスト」列の値を参照します。

#LINK#: 「リンク」オプションの値を参照します。

- データベース列: ツールチップ・テキストとして使用する列を選択します。

d. リンク・オプション:

- 既存のアプリケーション・アイテム: リーフ・ノード・テキストをリンクにします。このオプションを選択する場合、リンク先のページおよびリーフ・ノード・テキストをリンクする既存アプリケーション・アイテムを指定する必要があります。
このオプションは、「既存のアプリケーション・アイテム」リンク・オプションを選択した場合にのみ表示されます。

- なし

e. 「次へ」をクリックします。

11. 選択した内容を確認し、「作成」をクリックします。

ヒント:

APEXツリー・リージョンは、「デスクトップ」ユーザー・インタフェースを使用したページで作成できます。

13.6.3.2 ページ・デザイナでのツリーの作成

既存のページでツリーを作成するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. ページを選択します。

ページ・デザイナが表示されます。

2. 中央ペインで「レイアウト」タブをクリックします。

3. ギャラリで、「リージョン」タブをクリックします。次に、「ツリー」を右クリックして「追加先」を選択し、適切な位置を選択します。

ヒント:

ギャラリで「ツリー」リージョンを選択して、「レイアウト」タブの適切な位置までドラッグすることもできます。

ページ・デザイナは、次に必要なアクションを示します。

「メッセージ」タブには、対応する必要のあるメッセージを示す赤または黄色のバッジが表示されます。「メッセージ」タブには、次の2つのタイプのメッセージが表示されます。

- エラー - エラー・メッセージは赤で表示されます。エラー・メッセージを選択すると、プロパティ・エディタに関連する属性が赤で表示されます。ページを保存する前にエラーに対処する必要があります。

- 警告 - 警告メッセージは黄色で表示されます。警告メッセージを選択すると、プロパティ・エディタで、関連する属性が黄色で表示されます。ページを保存する前にエラーに対処する必要があります。警告メッセージには対処しないでページを保存できることに注意してください。

4. 「レンダリング」タブまたは「レイアウト」タブのいずれかで、新規ツリー・リージョンを選択します。

プロパティ・エディタの右ペインに属性が表示されます。

プロパティ・エディタでは、属性が機能グループに編成されます。これらのグループを展開または縮小するには、「共通の表示」、「すべて表示」、「すべて閉じる」および「すべて開く」アイコンをクリックします。

属性を検索するには、「フィルタ・プロパティ」フィールドにキーワードを入力します。

5. プロパティ・エディタで、次の属性を編集します。

a. 指定、タイトル - リージョン・タイトルを入力します。リージョン・タイトルは、リージョン・テンプレートに定義されている場合にのみ表示されます。

b. ソース、SQL問合せ - ツリーの基礎となる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#menu/go-small.png'で置き換えます。

c. レイアウト - 属性を編集します。

- 順序 - このアイテムの表示順序を入力します。順序および他のレイアウト設定によって、リージョン内の他のアイテムに対して相対的に、このアイテムの表示位置が決定されます。

- 親リージョン - このリージョンが属する親リージョンを選択します。親リージョンが選択されている場合、このリージョンは完全に親リージョン内にレンダリングされます。

- 位置 - このリージョンの表示に使用されるテンプレートの位置を選択します。使用可能な選択肢は、ページのユーザー・インタフェースに対して現在のテーマ内に定義されている適切なテンプレートの位置から導出されます。

d. 外観、テンプレート - テンプレートを指定します。リージョン・テンプレートを選択して、このリージョンの外観とレイアウトを定義します。
詳細は、中央ペインで「ヘルプ」タブをクリックします。

6. リージョン属性を編集します。

a. 「レンダリング」タブで、リージョンを探し、「属性」をクリックします。
プロパティ・エディタに属性が表示されます。

b. プロパティ・エディタで、リージョン属性を編集します。

- ツリー実装 - ツリーの実装方法を「APEXツリー」または「jsTree(レガシー)」から選択します。

- ツリー・テンプレート - 「jsTree(レガシー)」で実装されたツリーに対してのみ表示されます。使用可能なjsTreeテンプレート・オプションから、ツリーに適用するテンプレートを選択します。

- 次のものでノード・リンクをアクティブ化 - ツリーでノード・リンクをアクティブ化するために必要なアクションを選択します。

- 選択したノードのページ・アイテム - 選択したノード値を保持するページまたはアプリケーション・アイテムを選択します。

- ツールチップ - ツールチップを表示するかどうか、およびツールチップのソースを選択します。

- 静的ツリーID - ツリーの一意の識別子を入力します。
このIDは、ボタンのレガシーJavaScriptコードでツリーを開閉する場合にのみ必要となります。新しいアプリケーションでは、ツリーの操作に動的アクションが使用されます。

- アイコン・タイプ - CSSクラスを使用して、すべてのノードで使用されるアイコン・タイプを指定します。このオプションはAPEXツリー・リージョンにのみ適用可能です。

7. 「保存」をクリックします。

13.6.3.3 ページ・デザイナでのツリー属性の編集

デフォルトではツリーにフォーカスが置かれておらず、シングルクリック・アクションによってノード・リンクがアクティブ化されます。開発者は、ツリー属性を編集してツリーの動作をカスタマイズできます。

ツリー属性ページにアクセスするには、次のステップを実行します。

1. ページ・デザイナでページを表示します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. ページを選択します。

ページ・デザイナが表示されます。

2. 「レンダリング」タブまたは「レイアウト」タブで、ツリーを含むリージョンを選択します。

プロパティ・エディタの右ペインにツリーの属性が表示されます。

プロパティ・エディタでは、属性が機能グループに編成されます。これらのグループを展開または縮小するには、「共通の表示」、「すべて表示」、「すべて閉じる」および「すべて開く」アイコンをクリックします。

3. グループまたは属性を検索するには、「フィルタ・プロパティ」フィールドにキーワードを入力します。

4. ツリー属性を編集します。

ページが保存されるまで、編集した属性の属性名の左側に青色のマーカーが表示されます。

ヒント:

属性の詳細は、プロパティ・エディタで属性を選択し、中央ペインで「ヘルプ」タブをクリックして、参照してください。

5. 「保存」をクリックします。

13.6.4 レガシー・コンポーネント・ビューでのツリーの管理

重要:

レガシー・コンポーネント・ビューはデフォルトで無効化されています。レガシー・コンポーネント・ビューを有効化するには、ユーザー・プリファレンスを編集します。ユーザー・プリファレンスの編集を参照してください。

レガシー・コンポーネント・ビューは、アプリケーション・ページを編集するためのレガシー・ユーザー・インタフェースです。開発者はレガシー・コンポーネント・ビューではなくページ・デザイナを使用することをお薦めします。レガシー・コンポーネント・ビューは、ユーザー・インタフェース要素とアプリケーション・ロジックをコンポーネント・タイプ別にグループ化します。ページ・デザイナとは異なり、レガシー・コンポーネント・ビューでは、ページを視覚的に表したり、ページ・コンポーネントをドラッグ・アンド・ドロップすることができません。

ヒント:

ページ・デザイナへの移行で開発者を支援するために、ページ・デザイナには「コンポーネント・ビュー」タブが含まれています。レガシー・コンポーネント・ビューの外観と同様、ページ・デザイナの「コンポーネント・ビュー」タブには、ユーザー・インタフェース要素とアプリケーション・ロジックがコンポーネント・タイプ別に表示されます。ただし、コンポーネントをクリックすると、プロパティ・エディタの右ペインで対応する属性がハイライトされます。「コンポーネント・ビュー」タブを参照してください。

開発者は、コンポーネント・ビューでツリーを作成および編集できます。

注意:

レガシー・コンポーネント・ビューでのページの管理

トピック:

- コンポーネント・ビューでのツリーの作成

- コンポーネント・ビューでのツリー属性の編集

13.6.4.1 コンポーネント・ビューでのツリーの作成

コンポーネント・ビューでツリーを作成するには、次のステップを実行します。

1. ページに移動します。レガシー・コンポーネント・ビューでのページの表示を参照してください。

2. 「リージョン」で、「作成」アイコンをクリックします。
「リージョンの作成」ウィザードが表示されます。

3. 「ツリー」を選択し、「次へ」をクリックします。

4. 「表示属性」は、次のようにします。

a. タイトル - リージョンのタイトルを入力します。選択するリージョン・テンプレートにリージョン・タイトルが表示されると、このタイトルが表示されます。

b. リージョン・テンプレート: リージョンの外観を制御するテンプレートを選択します。

c. 親リージョン - 新しいリージョンが属する親リージョンを定義します。

d. 表示ポイント: このリージョンの表示ポイントを指定します。ページ・テンプレート位置およびページ・ボディ位置の2種類の表示ポイントが存在します。属性の詳細は、フィールドレベル・ヘルプを参照してください。

e. 順序: このコンポーネントの順序を指定します。これによって評価の順序が決まります。

f. 「次へ」をクリックします。

5. 「表/ビューの所有者」および「表/ビューの名前」で次を実行します。

a. 表/ビューの所有者: ツリーの基になる表の所有者を選択します。

b. 表/ビューの名前: マスター・ページに含める列を含む表またはビューを選択します。

c. 「次へ」をクリックします。

6. 「問合せ」で、IDおよび親IDとして使用する列を指定し、ノードに表示するテキストを指定します。

a. ID: IDとして使用する列を選択します。

b. 親ID: 親IDとして使用する列を選択します。

c. ノード・テキスト: ツリー・ノードに表示するテキストを選択します。

d. 開始: 階層ツリー問合せのルートを指定するために使用する列を選択します。

e. ツリーを開始: 問合せの開始方法を選択します。オプションは次のとおりです。

- 既存のアイテムに基づく: 既存のアプリケーション・アイテムまたはページ・アイテムを選択します。

- SQL問合せに基づく: 単一行または単一列を返すSQL問合せを入力します。

- 静的値に基づく: 静的値を入力します。

- 値: NULLです。

f. 「次へ」をクリックします。

7. 「WHEREおよびORDER BY」で、次のように指定します。

a. WHERE句: オプションのWHERE句を入力します。

b. ORDER SIBLINGS BY: 兄弟の並替え基準として使用する列を選択します。

c. 「次へ」をクリックします。

8. 「ツリー属性」で、次のように指定します。

a. ボタンを含む: 含めるボタンを選択します。

b. 選択したノードのページ・アイテム: 選択したノード値を保持するために使用できます。アプリケーション・アイテムを選択した場合、このアイテムを使用して、最後に選択したツリー・ノードの値を保持することで、ツリーの状態を保存できます。

c. ツールチップ: マウスをリーフ・ノードに合わせたときにツールチップを表示します。オプションは次のとおりです。

- 静的割当て: ツールチップ・テキストとして使用する静的値を指定します。静的テキストで置換文字列を使用して、SQL問合せからの情報をツールチップ・テキストに組み込むことができます。使用可能な置換文字列は次のとおりです。
#VALUE#: 「ID」列の値を参照します。

#TITLE#: 「ノード・テキスト」列の値を参照します。

#LINK#: 「リンク」オプションの値を参照します。

- データベース列: ツールチップ・テキストとして使用する列を選択します。

d. リンク・オプション:

- 既存のアプリケーション・アイテム: リーフ・ノード・テキストをリンクにします。このオプションを選択する場合、リンク先のページおよびリーフ・ノード・テキストをリンクする既存アプリケーション・アイテムを指定する必要があります。
このオプションは、「既存のアプリケーション・アイテム」リンク・オプションを選択した場合にのみ表示されます。

- なし

e. 「次へ」をクリックします。

9. 選択した内容を確認し、「リージョンの作成」をクリックします。

13.6.4.2 コンポーネント・ビューでのツリー属性の編集

デフォルトではツリーにフォーカスが置かれておらず、シングルクリック・アクションによってノード・リンクがアクティブ化されます。このセクションでは、開発者がツリー属性を編集してツリーをカスタマイズする方法について説明します。

ツリー属性ページにアクセスするには、次のステップを実行します。

1. 適切なページにナビゲートします。レガシー・コンポーネント・ビューでのページの表示を参照してください。

2. リージョン属性ページにアクセスします。「リージョン」で、編集するツリー・リージョンの名前の横にある「ツリー」リンクをクリックします。

対象となる属性を編集します。

ヒント:

属性の詳細は、フィールドレベル・ヘルプを参照してください。フィールドレベル・ヘルプの表示を参照してください。

3. 「変更の適用」をクリックします。

13.7 アプリケーションへのJavaScriptの組込みについて

Web配置のすべてのメリットを失わずに、検出されたクライアント/サーバー・アプリケーションを擬似実行するファンクションを追加する最も有効な方法は、JavaScriptをWebアプリケーションに追加する方法です。Oracle Application Expressには、JavaScript追加専用に設計された複数の組込みインタフェース(フック)が含まれています。

JavaScriptは、データ処理集中型検証には適していません。たとえば、名前が大規模データベース表内に含まれていることを検証するには、大容量のHTMLドキュメントを作成して、すべてのレコードをクライアントにプルダウンする必要があります。通常、複雑な操作には、JavaScriptではなくサーバー・サイドApplication Express検証の方がより適しています。詳細は、適切なコントロールまたはコンポーネントのJavaScriptディスカッションを参照してください。

関連項目:

エスケープされた一重引用符を持つJavaScriptのテキスト(JavaScriptリテラル文字列内のショートカットの参照の詳細)、検証の理解およびプラグインでのJavaScriptコードの使用について

14 ナビゲーションの追加

データベース・アプリケーションを作成するとき、様々なタイプのナビゲーション・コントロールを含めることができます。使用可能なナビゲーション・オプションは、アプリケーション・テーマによって異なります。共通のナビゲーション・コントロールは、タブ、リスト(ナビゲーション・メニューを含む)、ブレッドクラム、ナビゲーション・バー・エントリおよびブランチです。このセクションでは、アプリケーションでナビゲーションを実装する方法について説明します。

トピック:

- ナビゲーションとしてのリストの作成について

- タブの作成

- ブレッドクラムの作成

- ナビゲーション・バー・エントリの作成

- ブランチを使用したナビゲーションの制御

関連項目:

ツリーの作成

14.1 ナビゲーションとしてのリストの作成について

リストは、リンクの共有コレクションです。リージョンを作成してリージョン・タイプを「リスト」に指定することによって、リストをページに追加します。リストの外観は、リスト・テンプレートで制御します。たとえば、テンプレート「箇条書き付きで、順序付けされていない縦のリスト」を使用すると、ナビゲーションとして機能する静的リストを作成できます。ユニバーサル・テーマ - 42などの新しいテーマでは、ナビゲーション・メニューの作成がサポートされています。ナビゲーション・メニューは、ページ上部に(タブのように)レンダリングされるリストまたはサイド・バーとして表示されるリストです。サンプル・データベース・アプリケーションには、ナビゲーション・メニューが含まれています。

関連項目:

- リストの作成

- 「ナビゲーション・メニューについて」

- サンプル・データベース・アプリケーションの理解

14.2 タブの作成

タブは、アプリケーションのページ間でのナビゲートに有効な方法です。アプリケーションにタブを含めることができるかどうかは、アプリケーション・テーマによって異なります。テーマ26 - 生産性アプリケーションなどの古いテーマには、タブベースのナビゲーションが含まれています。ユニバーサル・テーマ - 42などの新しいテーマには、リストベースのナビゲーション・メニューが含まれています。

アプリケーションには、タブのないページ、1レベルのタブを持つページおよび2レベルのタブを持つページを含めることができます。標準タブを使用した場合は、1レベルのタブのみを表示できます。2レベルのタブを表示するには、親タブと標準タブの両方を定義します。

ヒント:

タブのかわりに、リストを使用してタブ・コントロールを表示できます。リスト・テンプレートを使用すると、HTMLの生成をさらに制御できます。

注意:

アプリケーションの作成ウィザードを実行すると、オプションで、タブ付きのアプリケーションを作成できます。次のステップでは、タブ付きでないアプリケーションを作成済であると想定しています。

トピック:

- タブについて

- タブ・ページについて

- タブ・テンプレート・サポートの確認

- タブの作成

- タブの編集

- タブ・レポートへのアクセス

関連項目:

- リストの作成

- 「ナビゲーション・メニューについて」

- データベース・アプリケーションの作成

14.2.1 タブについて

標準タブは、ページと1対1の関係にしたり、複数のページのカレント・タブにすることができます。アプリケーション・ビルダーには、次の2つのタイプのタブが含まれています。

- 標準タブ
タブが1レベルのみのアプリケーションでは、標準タブ・セットを使用します。標準タブ・セットは、特定のページおよびページ番号に関連付けられます。標準タブを使用すると、特定のページにユーザーをリンクできます。

- 親タブ
親タブは標準タブ・セットの表示を制御できます。親タブをクリックすると、カレント・ページとしてデフォルト・ページを使用して、対応する標準タブが表示されます。親タブによって、別のレベルのナビゲーションおよびアプリケーション内のコンテキスト(または場所)が提供されます。ユーザーが特定のページに関連付けられた特定のURLにリンクするために親タブを使用できます。

タブをタブ・セットと呼ばれるコレクションにグループ化できます。各タブは、タブ・セットに属している必要があります。

ヒント:

タブを使用するアプリケーションの例は、サンプル・パッケージ・アプリケーションであるサンプル・データベース・アプリケーションを参照してください。

関連項目:

サンプル・データベース・アプリケーションの理解

14.2.2 タブ・ページについて

タブ・ページには、アプリケーションに定義されているタブの説明が表示されます。

タブ・ページにアクセスするには、次のステップを実行します。

1. 共有コンポーネント・ページにナビゲートします。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。

b. アプリケーションを選択します。

c. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

共有コンポーネント・ページが表示されます。

2. 「ナビゲーション」で、「タブ」をクリックします。

タブ・ページが表示されます。

「タブ表示」セクションには、カレント・タブまたはタブ・セットの表示の構成方法に関する追加情報が表示されます。

ページ下部の「ページ・テンプレート」リージョンには、カレント・アプリケーションに関連付けられているページ・テンプレートのレポートが表示されます。このリージョンはデフォルトで非表示になっています。表示するには、ページ・テンプレートの左側にある大なり記号(>)アイコンをクリックします。

関連項目:

- 「タブ・テンプレート・サポートの確認」

- サンプル・データベース・アプリケーションの理解

14.2.3 タブ・テンプレート・サポートの確認

親タブおよび標準タブを作成する前に、デフォルトのテンプレートで、適切な置換文字列を使用して標準タブおよび親タブの両方に位置を定義していることを確認する必要があります。このテンプレートは、ページ・レベルで上書きしないでください。

ページ・テンプレートを表示するには、次のステップを実行します。

1. 共有コンポーネント・ページにナビゲートします。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。

b. アプリケーションを選択します。

c. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

2. 「ナビゲーション」で、「タブ」をクリックします。

タブ・ページが表示されます。

3. ページの下部の「ページ・テンプレート」に移動します。必要に応じて、「ページ・テンプレート」リージョンを拡張します。

関連項目:

- ページ・テンプレート

- アプリケーション・レベルでデフォルトのページ・テンプレートを設定する方法については、「テーマの使用」を参照してください

14.2.4 タブの作成

アプリケーションには、タブのないページ、1レベルのタブを持つページおよび2レベルのタブを持つページを含めることができます。標準タブを使用した場合は、1レベルのタブのみを表示できます。2レベルのタブを表示するには、親タブと標準タブの両方を定義する必要があります。

タブを作成するには:

1. タブ・ページにアクセスします。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

d. 「ナビゲーション」で、「タブ」をクリックします。

2. 「タブの管理」をクリックします。

3. 親タブを追加するには、上の行の「追加」ボタンをクリックします。

アプリケーションで定義されたタブがグラフィカルに表示されます。

親タブは標準タブ・セットの表示を制御できます。親タブをクリックすると、カレント・ページとしてデフォルト・ページを使用して、対応する標準タブが表示されます。

4. 標準タブを作成するには、下の行の「追加」ボタンをクリックします。

親タブの作成ウィザードまたは標準タブの作成ウィザードが表示されます。

5. 画面に表示されるステップに従います。

関連項目:

タブについて

14.2.5 タブの編集

この項では、タブの編集方法について説明します。複数のタブを同時に編集できます。また、標準タブを使用している場合は、「標準タブのタスク」リストを使用して、ラベルや順序などのタブのプロパティを更新できます。

トピック:

- 複数のタブの同時編集

- 標準タブの管理

14.2.5.1 複数のタブの同時編集

複数のタブを同時に編集するには、次のステップを実行します。

1. 「タブ」ページにナビゲートします。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. 「共有コンポーネント」をクリックします。

d. 「ナビゲーション」で、「タブ」をクリックします。

2. ページ上部で次のいずれかのタブをクリックします。

- 標準タブの編集

- 親タブの編集

レポートが表示されます。

3. 特定のタブを編集するには、「編集」アイコンをクリックします。

4. 該当する属性を編集し、「変更の適用」をクリックします。

14.2.5.2 標準タブの管理

「標準タブのタスク」リストが「タブ」ページの右側に表示されます。このリスト上のリンクにアクセスすると、標準タブの異なる親タブへの移動、標準タブ・セットの名前の変更、表示順序の変更、タブ・セットへのページの関連付け、新規標準タブの作成または新規標準タブ・セットの作成ができます。

「標準タブのタスク」リストにアクセスするには、次のステップを実行します。

1. 「タブ」ページにナビゲートします。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. 「共有コンポーネント」をクリックします。

d. 「ナビゲーション」で、「タブ」をクリックします。

2. 「タブの管理」をクリックします。

3. ページの右側にある「標準タブのタスク」リストから選択します。

- 選択した標準タブを異なる親タブに移動

- 標準タブ・セット名の変更

- 表示順序の変更

- 選択した標準タブでページを関連付け

- 新しい標準タブの作成

- 新しい標準タブ・セットの作成

14.2.6 タブ・レポートへのアクセス

このセクションでは、「条件付き表示」、「使用状況」および「履歴」レポートについて説明します。

「条件付き表示」レポートを表示するには、次のステップを実行します。

1. 「タブ」ページにナビゲートします。

a. 「ワークスペース」ホームページにナビゲートします。

b. 「アプリケーション・ビルダー」アイコンをクリックします。

c. アプリケーションを選択します。

d. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

e. 「ナビゲーション」で、「タブ」をクリックします。

タブ・ページが表示されます。

2. 該当するタブをクリックします。

- 条件付き表示 - 条件付き表示レポートには、条件付きで表示するように構成された標準タブと親タブが表示されます。表示をフィルタ処理するには、タブ・タイプを選択して、「実行」をクリックします。

- 使用状況 - 使用状況レポートには、カレント・アプリケーションで使用されている標準タブが一覧表示されます。

- 履歴 - 履歴レポートには、カレント・アプリケーションのタブ属性に対する変更の履歴が表示されます。

14.3 ブレッドクラムの作成

ブレッドクラムを使用すると、階層的にナビゲートできます。ブレッドクラムは、テンプレートを使用して表示されるリンクの階層的なリストです。ブレッドクラムは、リンクのリストまたはブレッドクラム・パスとして表示できます。

トピック:

- ブレッドクラムとは

- ページ作成中のブレッドクラムの作成

- ブレッドクラムの手動作成

- ブレッドクラムの編集

- ブレッドクラム・エントリの親の変更

- 未使用のブレッドクラム・エントリの削除

- ブレッドクラム・レポートへのアクセス

関連項目:

- 「テーマの作成」

- 「ブレッドクラム・テンプレート」

14.3.1 ブレッドクラムとは

ブレッドクラムは、アプリケーション内のどの部分が表示されているかを階層で示すリンクの階層リストです。特定のブレッドクラム・リンクをクリックすると、すぐにページを表示できます。各ページの上部でナビゲーションの第2レベルとしてブレッドクラムを使用し、タブおよびリストなどの他のユーザー・インタフェース要素を補完します。

関連項目:

サンプル・データベース・アプリケーションの理解

14.3.2 ページ作成中のブレッドクラムの作成

ページの作成中にブレッドクラムを作成するには、次のステップを実行します。

1. ページの作成ウィザードを実行して、新規ページを追加します。

ウィザードの途中で、「ブレッドクラム」オプションが表示されます。このリストが表示される実際のページは、作成するページのタイプによって異なります。

2. 「ブレッドクラム」リストから、「ブレッドクラム」を選択するか、既存のブレッドクラムを選択します(使用可能な場合)。

3. 「ブレッドクラム」を選択する場合は、次のステップを実行します。

a. 親エントリ - 親ページ(使用可能な場合)を選択するか、「親エントリなし」を選択します。

b. エントリ名 - ブレッドクラムの名前を入力します。

4. 画面に表示されるステップに従います。

関連項目:

データベース・アプリケーションのページの管理

14.3.3 ブレッドクラムの手動作成

この項では、ブレッドクラムを手動で作成する方法について説明します。

トピック:

- ブレッドクラムの手動作成について

- ブレッドクラムの作成

- ブレッドクラム・エントリの追加

- ブレッドクラム・リージョンの追加

- 動的ブレッドクラムの作成について

14.3.3.1 ブレッドクラムの手動作成について

ブレッドクラムを手動で作成するには、次のように、アプリケーションの各ページにブレッドクラムを追加する必要があります。

1. ブレッドクラムの作成/編集ウィザードを実行してブレッドクラムを作成します。このウィザードには、共有コンポーネント・ページ、ページ・デザイナまたはコンポーネント・ビューからアクセスできます。

2. エントリをブレッドクラムに追加します。

3. リージョンを作成して、ブレッドクラムをページに追加します。

関連項目:

- ブレッドクラムの作成

- 「ブレッドクラム・エントリの追加」

- 「ブレッドクラム・リージョンの追加」

14.3.3.2 ブレッドクラムの作成

この項では、ブレッドクラムを作成する様々な方法について説明します。

トピック:

- 共有コンポーネントとしてのブレッドクラムの作成

- ページ・デザイナでのブレッドクラム・リージョンの作成

- コンポーネント・ビューからのブレッドクラムの作成

14.3.3.2.1 共有コンポーネントとしてのブレッドクラムの作成

共有コンポーネント・ページからブレッドクラムを作成するには、次のステップを実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

4. 「ナビゲーション」で、「ブレッドクラム」をクリックします。

ブレッドクラム・ページが表示されます。

5. 「ブレッドクラムの作成」をクリックします。

6. 名前を入力して、「作成」をクリックします。

7. ブレッドクラム・エントリを追加します。

関連項目:

「ブレッドクラム・エントリの追加」

14.3.3.2.2 ページ・デザイナでのブレッドクラム・リージョンの作成

ページ・デザイナでブレッドクラム・リージョンを作成するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. ページを選択します。

ページ・デザイナが表示されます。

2. ページ上部のページ・デザイナ・ツールバーに移動します。

3. ページ・デザイナ・ツールバーで、「作成」メニューをクリックして「ブレッドクラム・リージョン」を選択します。

ブレッドクラムの作成ウィザードが表示されます。

4. 「リージョン属性」は、次のようにします。

a. リージョン・タイトル: リージョンのタイトルを入力します。

b. リージョン・テンプレート: リージョン・テンプレートを選択します。

c. 表示ポイント: 表示ポイントを指定します。

d. 順序: このコンポーネントの順序を指定します。これによって評価の順序が決まります。

e. 「次へ」をクリックします。

5. 「ブレッドクラム」は、次のようにします。

a. ブレッドクラム: このリージョンに関連付けるブレッドクラムを選択します。

b. ブレッドクラム・テンプレート: ブレッドクラム・テンプレートを指定します。

c. 「次へ」をクリックします。

6. 「ブレッドクラム・エントリ」は、次のようにします。

a. ブレッドクラム: このブレッドクラム・エントリのラベルを指定します。

b. 親エントリ: このブレッドクラム・エントリの階層親を選択します。

c. 「次へ」をクリックします。

7. 選択内容を確認して、「終了」をクリックします。

14.3.3.2.3 コンポーネント・ビューからのブレッドクラムの作成

コンポーネント・ビューからブレッドクラムを作成するには、次のステップを実行します。

1. コンポーネント・ビューでページを表示します。レガシー・コンポーネント・ビューでのページの表示を参照してください。

2. 「作成」メニューをクリックして、「共有コンポーネント」を選択します。

3. 「アプリケーション・コンポーネントの作成」で、「ブレッドクラム」を選択して「次へ」をクリックします。

4. 「ブレッドクラム名」に、このブレッドクラムの名前を入力して「作成」をクリックします。

5. 名前付きのブレッドクラムを作成した後、ブレッドクラム・エントリを追加できます。

関連項目:

「ブレッドクラム・エントリの追加」

14.3.3.3 ブレッドクラム・エントリの追加

ブレッドクラム・エントリを追加するには、次のステップを実行します。

1. ブレッドクラム・ページにナビゲートします。

a. 「ワークスペース」ホームページにナビゲートします。

b. 「アプリケーション・ビルダー」アイコンをクリックします。

c. アプリケーションを選択します。

d. 「共有コンポーネント」をクリックします。

e. 「ナビゲーション」で、「ブレッドクラム」をクリックします。

ブレッドクラム・ページが表示されます。

2. エントリを追加するブレッドクラムを選択します。

3. 「ブレッドクラム・エントリの作成」をクリックします。

4. 「ブレッドクラム」で、このブレッドクラム・エントリが表示されるページを選択します。

5. 「エントリ」で、次のステップを実行します。

a. 順序: ブレッドクラム・エントリを表示する順序を指定します。これによって評価の順序が決まります。

b. 親エントリ: このエントリの親を指定します。ブレッドクラムには、親IDを持たないアイテムとして識別されるルート・ノードが1つのみ必要です。

c. 短縮名: このブレッドクラム・エントリの短縮名を指定します。ブレッドクラム・テンプレートから、短縮名と詳細名の両方を参照できます。

d. 詳細な名前: このブレッドクラム・エントリの詳細名を指定します。ブレッドクラム・テンプレートから、短縮名と詳細名の両方を参照できます。

6. 「ターゲット」で、ターゲットの場所を指定します。

a. ターゲットは: 「このアプリケーションのページ」を選択します。

b. ページ: ターゲット・ページ番号を指定します。

ページのページ区切りをリセットするには、「このページのページ区切りをリセット」を選択します。

c. リクエスト: REQUESTと呼ばれる組込みアプリケーション・アイテムを設定するテキストを入力します。これは、クリックしたボタンの名前で設定されるアイテムでもあります。

d. キャッシュのクリア: ユーザーのセッション・ステートをクリアするページのページ番号を、カンマで区切って入力します。

e. セッション・ステートを設定するには(リストされたアイテムに値を与えます)、次のステップを実行します。

- 次のアイテムを設定 - セッション・ステートを設定(リストしたアイテムに値を指定)するアプリケーション・アイテム名をカンマで区切って入力します。

- 次の値を使用 - 次のアイテムを「設定」で指定したアイテムの値をカンマで区切って入力します。静的な値または置換構文(&APP_ITEM_NAME.など)を指定できます。

静的な値または置換構文(&APP_ITEM_NAME.など)を指定できます。URLのf?p=に渡されるアイテム値にはコロン(:)を使用しないでください。また、バックスラッシュでアイテム値全体を囲んだ場合(\1234,56\など)を除いて、カンマも使用しないでください。

7. 「条件」で、次のステップを実行します。

a. 条件タイプ: リストから条件タイプを選択します。この条件は、このコンポーネントをレンダリングまたは処理するために必要です。

b. 表示されるフィールドに式を入力します。

8. 「認可」で、オプションで認可スキームを選択します。この認可スキームは、このコンポーネントをレンダリングまたは処理するためにTRUEと評価される必要があります。

9. 「構成」で、このコンポーネントのビルド・オプションを選択します。ビルド・オプションは、アプリケーション内のコンポーネントが有効かどうかを判別する事前定義された設定です。

10. 「ブレッドクラム・エントリの作成」をクリックします。

作成する各ブレッドクラム・エントリに対して、これらのステップを実行します。

14.3.3.4 ブレッドクラム・リージョンの追加

リージョンはページ上の領域で、コンテンツのコンテナとして機能します。ブレッドクラムおよびブレッドクラム・テンプレートを作成した後、リージョンを作成します。ブレッドクラム・リージョンを作成すると、ページにブレッドクラムを追加できます。

トピック:

- ページ・デザイナでのブレッドクラム・リージョンの追加

- レガシー・コンポーネント・ビューでのブレッドクラム・リージョンの追加

関連項目:

- 「新しいテンプレートの作成」

- メニュー表示の変更方法については、「ブレッドクラム・テンプレート」を参照してください

14.3.3.4.1 ページ・デザイナでのブレッドクラム・リージョンの追加

ページ・デザイナでブレッドクラム・リージョンを作成するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. ページを選択します。

ページ・デザイナが表示されます。

注意:

ページ下部にギャラリが表示されます。コントロールまたはコンポーネントにカーソルをあわせると、それについて説明するツールチップが表示されます。

2. ギャラリで、「リージョン」タブをクリックします。次に、「ブレッドクラム」を右クリックして「追加先」を選択し、適切な位置を選択します。

ヒント:

ギャラリで「ブレッドクラム」リージョンを選択して、「レイアウト」タブの適切な位置までドラッグすることもできます。

ページ・デザイナは、次に必要なアクションを示します。

「メッセージ」タブには、対応する必要のあるメッセージを示す赤または黄色のバッジが表示されます。「メッセージ」タブには、次の2つのタイプのメッセージが表示されます。

- エラー - エラー・メッセージは赤で表示されます。エラー・メッセージを選択すると、プロパティ・エディタに関連する属性が赤で表示されます。ページを保存する前にエラーに対処する必要があります。

- 警告 - 警告メッセージは黄色で表示されます。警告メッセージを選択すると、プロパティ・エディタで、関連する属性が黄色で表示されます。ページを保存する前にエラーに対処する必要があります。警告メッセージには対処しないでページを保存できることに注意してください。

3. プロパティ・エディタですべての属性を表示するには、「すべて表示」をクリックします。

4. プロパティ・エディタで、ブレッドクラム属性を編集します。

ヒント:

属性の詳細は、プロパティ・エディタで属性を選択し、中央ペインで「ヘルプ」タブをクリックして、参照してください。

a. 指定、タイトル - リージョン・タイトルを入力します。リージョン・タイトルは、リージョン・テンプレートに定義されている場合にのみ表示されます。

b. レイアウト、順序 - このアイテムの表示順序を入力します。順序および他のレイアウト設定によって、リージョン内の他のアイテムに対して相対的に、このアイテムの表示位置が決定されます。

c. レイアウト、位置 - このリージョンの表示に使用されるテンプレートの位置を選択します。使用可能な選択肢は、ページのユーザー・インタフェースに対して現在のテーマ内に定義されている適切なテンプレートの位置から導出されます。

d. 外観、テンプレート - リージョン・テンプレートを選択して、このリージョンの外観とレイアウトを定義します。詳細は、中央ペインで「ヘルプ」タブをクリックします。

e. 外観、アイテム表示位置 - メイン・リージョン・コンテンツに対して相対的に、ページ・アイテムの表示位置を指定します。

5. 「保存」をクリックします。

ブレッドクラム・ナビゲーションを追加する各ページに対して、これらのステップを実行します。

14.3.3.4.2 レガシー・コンポーネント・ビューでのブレッドクラム・リージョンの追加

コンポーネント・ビューでブレッドクラム・リージョンを作成するには、次のステップを実行します。

1. 適切なページにナビゲートします。レガシー・コンポーネント・ビューでのページの表示を参照してください。

2. 「リージョン」で、「作成」アイコンをクリックします。

「リージョンの作成」ウィザードが表示されます。

3. リージョン・タイプについて、「ブレッドクラム」を選択して「次へ」をクリックします。

4. 「ブレッドクラム・コンテナ・リージョン」で、次のステップを実行します。

a. リージョン・タイトル: リージョンのタイトルを入力します。

b. リージョン・テンプレート: リージョン・テンプレートを選択します。

c. 表示ポイント: 表示ポイントを選択します。

リージョンは、位置(または表示ポイント)別に編成されています。リージョンの適切な位置を決定するには、懐中電灯アイコンをクリックします。グラフィカルな画面が表示されます。

d. 順序: 順序の番号を入力します。これによって評価の順序が決まります。

e. 「次へ」をクリックします。

5. 「ブレッドクラム」は、次のようにします。

a. ブレッドクラム: このリージョンに関連付けるブレッドクラムを選択します。

b. ブレッドクラム・テンプレート: テンプレートを選択します。

c. 「次へ」をクリックします。

6. ブレッドクラム・リージョンの情報を確認し、「次へ」をクリックします。

7. 「終了」をクリックします。

ブレッドクラム・ナビゲーションを追加する各ページに対して、これらのステップを実行します。

14.3.3.5 動的ブレッドクラムの作成について

より詳細なコンテキストを表示するために、ブレッドクラムにセッション・ステートを含めて、ブレッドクラムを動的にすることができます。たとえば、アプリケーションのページに特定の会社への注文リストが表示される場合に、次のブレッドクラムを含めるとします。

Home > Orders > Orders for ACME Inc

この例で、ACME Incは、ユーザーが現在表示しているページおよびナビゲーション・パスも示しています。Application Expressエンジンによって、ACME Inc.のセッション・ステートの値が格納されます。

このタイプの動的メニューを作成するには、ブレッドクラムの短縮名または詳細な名前に、セッション・ステート・アイテムへの参照を含める必要があります。次に例を示します。

&COMPANY_NAME.

14.3.4 ブレッドクラムの編集

作成したブレッドクラムは、ブレッドクラム・ページで編集できます。

ブレッドクラムを編集するには、次のステップを実行します。

1. ブレッドクラム・ページにナビゲートします。

a. 「ワークスペース」ホームページにナビゲートします。

b. 「アプリケーション・ビルダー」アイコンをクリックします。

c. アプリケーションを選択します。

d. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

e. 「ナビゲーション」で、「ブレッドクラム」を選択します。

ブレッドクラム・ページが表示されます。

2. ブレッドクラムを選択します。

3. ブレッドクラム・エントリを選択します。

作成/編集ページが表示されます。

4. 対象となる属性を編集します。

特定のアイテムの詳細は、フィールドレベル・ヘルプを参照してください。

5. オプション)ページ右側にある「ブレッドクラム・エントリ」リストで、ページ名とタイトルとのブレッドクラムの同期化に関するオプションを選択できます。

このオプションを選択することで、ページ名とブレッドクラムの変更が1ステップでできるようになります。ブレッドクラム名に指定した情報は、参照ページ名とタイトルの更新に使用されます。

6. 「変更の適用」をクリックします。

関連項目:

- 「フィールドレベル・ヘルプの表示」

- ブレッドクラム・レポートへのアクセス

14.3.5 ブレッドクラム・エントリの親の変更

エントリの親の変更ページの選択ブレッドクラム・エントリに新たな親を選択できます。

ブレッドクラム・エントリの親を変更するには、次のステップを実行します。

1. ブレッドクラム・ページにナビゲートします。

a. 「ワークスペース」ホームページにナビゲートします。

b. 「アプリケーション・ビルダー」アイコンをクリックします。

c. アプリケーションを選択します。

d. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

e. 「ナビゲーション」で、「ブレッドクラム」を選択します。

ブレッドクラム・ページが表示されます。

2. ブレッドクラムを選択します。

エントリ・ページが表示されます。

3. 「タスク」リストから、「このブレッドクラム内におけるエントリの親の変更」をクリックします。

エントリの親の変更ページが表示されます。

4. ビューを編集またはフィルタを適用するためにナビゲーション・バーを使用するには、次のステップを実行します。

- ブレッドクラム: 編集するブレッドクラムを指定して、「実行」をクリックします。

- 開始: ブレッドクラム階層のサブセットの表示の制限を選択し、「実行」をクリックします。

5. 「親の変更先」から、新たな親を選択します。

6. 移動するブラッドクラム・エントリを選択し、「チェックしたエントリの親の変更」をクリックします。

14.3.6 未使用のブレッドクラム・エントリの削除

未使用のブレッドクラム・エントリを削除するには、次のステップを実行します。

1. ブレッドクラム・ページにナビゲートします。

a. 「ワークスペース」ホームページにナビゲートします。

b. 「アプリケーション・ビルダー」アイコンをクリックします。

c. アプリケーションを選択します。

d. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

e. 「ナビゲーション」で、「ブレッドクラム」を選択します。

ブレッドクラム・ページが表示されます。

2. ブレッドクラムを選択します。

ブレッドクラム・エントリ・ページが表示されます。

3. 「タスク」リストで、「未使用のブレッドクラム・エントリの削除」をクリックします。

削除ページが表示されます。

4. 削除するエントリを選択し、「チェックした項目の削除」をクリックします。

14.3.7 ブレッドクラム・レポートへのアクセス

ブレッドクラム・ページ上部の該当するタブをクリックして、「ブレッドクラム階層」、「ブレッドクラムのグリッド編集」、「ブレッドクラムの例外」、「ブレッドクラムの使用状況」および「ブレッドクラム履歴」レポートを表示できます。

注意:

これらのレポートが表示されるのは、ブレッドクラムを作成した後のみです。

ブレッドクラム・レポートを表示するには、次のステップを実行します。

1. ブレッドクラム・ページにナビゲートします。

a. 「ワークスペース」ホームページにナビゲートします。

b. 「アプリケーション・ビルダー」アイコンをクリックします。

c. アプリケーションを選択します。

d. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

e. 「ナビゲーション」で、「ブレッドクラム」を選択します。

ブレッドクラム・ページが表示されます。

2. 該当するタブをクリックします。

- 階層 - 「階層」をクリックすると、ブレッドクラムがページおよび階層別に表示されます。ページにリンクするにはページ番号をクリックします。

- グリッド編集 - 「グリッド編集」をクリックすると、一度にすべてのブラッドクラム名を編集できます。ページにリンクするにはページ番号をクリックします。

- 例外 - 「例外」をクリックすると、例外ページが表示されます。

- 使用状況 - 「使用状況」をクリックすると、ブレッドクラム・レポートにアクセスできます。このレポートには、ブレッドクラムがページごとに表示されます。ページ番号をクリックして、特定のページに進みます。

- 履歴 「履歴」をクリックすると、ブレッドクラムの履歴レポートにアクセスできます。このレポートには、ブレッドクラムの最近の変更が示されます。

ページの外観は、ページ上部にある検索バーを使用して変更できます。

関連項目:

「実行中のアプリケーションでの対話モード・レポートのカスタマイズ」

14.4 ナビゲーション・バー・エントリの作成

この項では、ナビゲーション・バー・エントリを作成および編集する方法について説明します。ナビゲーション・バー・エントリを使用すると、アプリケーションのページ間を容易に移動できます。たとえば、ナビゲーション・エントリを使用すると、イメージまたはテキストからのリンクを表示できます。関連付けられたページ・テンプレートによってナビゲーション・バーの位置が決定します。

トピック:

- ナビゲーション・バーについて

- ナビゲーション・バー・エントリの作成

- ナビゲーション・バー・エントリのコピー

- ナビゲーション・バー・エントリの編集

- 複数のナビゲーション・バー・エントリの同時編集

- ナビゲーション・バー・エントリ・レポートへのアクセス

関連項目:

カスタム・テーマの作成

14.4.1 ナビゲーション・バーについて

ナビゲーション・バー・エントリは、イメージ、テキストまたは下にテキストが付いているイメージです。ナビゲーション・バー・エントリに使用するイメージおよびテキストを入力する必要があります。

ナビゲーション・バーは、ページごとにこれらを参照する必要がないという点で、他の共有コンポーネントとは異なります。使用するページ・テンプレートに#NAVIGATION_BAR#置換文字列が含まれている場合、Application Expressエンジンは、ページをレンダリングする際、自動的に定義済ナビゲーション・バーを含めます。

関連項目:

サンプル・データベース・アプリケーションの理解

14.4.2 ナビゲーション・バー・エントリの作成

ナビゲーション・バーを追加する前に、ナビゲーション・バー・エントリを作成する必要があります。ナビゲーション・バー・エントリは、最初から作成するか、または既存のエントリをコピーして作成できます。

トピック:

- ナビゲーション・バー・エントリを最初から作成

- フィードバック用ナビゲーション・バー・エントリの作成

14.4.2.1 ナビゲーション・バー・エントリを最初から作成

ナビゲーション・バー・エントリを最初から作成するには、次のステップを実行します。

1. ナビゲーション・バー・エントリ・ページにナビゲートします。

a. 「ワークスペース」ホームページにナビゲートします。

b. 「アプリケーション・ビルダー」アイコンをクリックします。

c. アプリケーションを選択します。

d. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

e. 「ナビゲーション」で、「ナビゲーション・バー・エントリ」をクリックします。

2. 「作成」をクリックします。

ナビゲーション・バー・エントリの作成ウィザードが表示されます。

3. 「方法」で、「最初から」を選択します。

4. 「タイプ」で、「URLへのナビゲーション」を選択します。

5. 「属性」で、次のように指定します。

a. 順序: このコンポーネントの評価の順序を指定します。

ヒント:

既存のエントリを確認するには、ページ下部の「既存のナビゲーション・バー・エントリ」リンクをクリックします。

b. エントリ・ラベル: このナビゲーション・バー・エントリの表示テキストを入力します。

c. アイコン・イメージ名: イメージ名を入力します。ネーミング規則の詳細は、フィールドレベル・ヘルプを参照してください。

d. イメージALT: イメージのナビゲーション・アイコンのALTテキストを入力します。イメージ名を指定しないと、このテキストが表示されます。

e. イメージの高さ: イメージの高さをピクセルで定義します。

f. 幅: イメージの幅を定義します。

g. 「次へ」をクリックします。

6. 「ターゲット」で、次のように指定します。

a. ターゲット位置がURLの場合、次を指定します。

- ターゲットは: 「URL」を選択します。

- URLターゲット: URLを入力します。次に例を示します。

http://www.yahoo.com

b. ターゲット位置がページの場合、次を指定します。

- ターゲットは: 「このアプリケーションのページ」を選択します。

- ページ: ターゲット・ページ番号を指定します。
ページ区切りをリセットするには「このページのページ区切りをリセット」を選択します。

アプリケーションの「印刷用」テンプレートを使用してターゲット・ページを表示するには、「印刷用」を選択します。「印刷用」テンプレートにより、印刷用ページが最適化されます。

- リクエスト: REQUESTと呼ばれる組込みアプリケーション・アイテムを定義するテキストを入力します。

- キャッシュのクリア: ユーザーのセッション・ステートをクリアするページ番号を入力します。複数入力するときはカンマで区切ります。

c. セッション・ステートを設定するには(リストされたアイテムに値を与えます)、次のステップを実行します。

- 次のアイテムを設定: セッション・ステートを設定するアプリケーション・アイテム名のリストを入力します。複数のアイテムはカンマで区切ります。セッション・ステートを設定すると、リストしたアイテムに値が指定されます。

- 次の値を使用: 指定したアイテムの値をカンマで区切って入力します。
静的な値または置換構文(&APP_ITEM_NAME.など)を指定できます。URLのf?p=に渡されるアイテム値にはコロン(:)を使用しないでください。また、バックスラッシュでアイテム値全体を囲んだ場合(\1234,56\など)を除いて、カンマも使用しないでください。

d. 「次へ」をクリックします。

7. ナビゲーション・バー・エントリを表示するための条件を設定するには、条件タイプを選択します。

8. 「作成」をクリックします。

ヒント:

ナビゲーション・バーを表示するには、使用するページ・テンプレートに#NAVIGATION_BAR#置換文字列が含まれている必要があります。詳細は、ページ・テンプレートを参照してください。

関連項目:

- 「フィードバック用ナビゲーション・バー・エントリの作成」

- 「フィールドレベル・ヘルプの表示」

- テーマの編集

- 「印刷用ページの最適化」

14.4.2.2 フィードバック用ナビゲーション・バー・エントリの作成

フィードバックは、アプリケーション・ユーザーからリアルタイム・コメント、拡張リクエストおよびバグを収集するプロセスです。アプリケーションにフィードバック・ページを追加するには、フィードバック・ページを追加します。

フィードバック用ナビゲーション・バー・エントリを作成するには、次のステップを実行します。

1. ナビゲーション・バー・エントリ・ページにナビゲートします。

a. 「ワークスペース」ホームページにナビゲートします。

b. 「アプリケーション・ビルダー」アイコンをクリックします。

c. アプリケーションを選択します。

d. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

e. 「ナビゲーション」で、「ナビゲーション・バー・エントリ」をクリックします。

2. 「作成」をクリックします。

ナビゲーション・バー・エントリの作成ウィザードが表示されます。各ウィザード・ページには、左側にステップの順序を示す一連のブロックが表示されます。ハイライトされたブロックは実行中のステップを表します。

3. 「方法」で、「最初から」を選択します。

4. 「タイプ」で、「フィードバック」を選択します。

5. 「フィードバック」で、次のステップを実行します。

a. フィードバック・ページ: フィードバック・ページを選択します。

b. エントリ・ラベル: 新しいナビゲーション・バー・エントリのラベルを入力します。

c. 表示順序: 新しいナビゲーション・バー・エントリの順序を指定します。これによって評価の順序が決まります。

6. 「作成」をクリックします。

ヒント:

ナビゲーション・バーを表示するには、使用するページ・テンプレートに#NAVIGATION_BAR#置換文字列が含まれている必要があります。ページ・テンプレートを参照してください。

関連項目:

フィードバックの管理

14.4.3 ナビゲーション・バー・エントリのコピー

ナビゲーション・バー・エントリをコピーするには、次のステップを実行します。

1. ナビゲーション・バー・エントリ・ページにナビゲートします。

a. 「ワークスペース」ホームページにナビゲートします。

b. 「アプリケーション・ビルダー」アイコンをクリックします。

c. アプリケーションを選択します。

d. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

e. 「ナビゲーション」で、「ナビゲーション・バー・エントリ」をクリックします。

2. 「作成」をクリックします。

ナビゲーション・バー・エントリの作成ウィザードが表示されます。

3. 「方法」で、「既存のナビゲーション・バーのコピーとして」を選択して、「次へ」をクリックしてください。

4. 「コピー元アプリケーション」で、アプリケーションを選択して、「次へ」をクリックします。

5. 「新しい名前」で、新しいエントリの名前を入力し、コピーおよびサブスクライブするかどうかを選択します。

6. 「ナビゲーション・バー・エントリのコピー」をクリックします。

14.4.4 ナビゲーション・バー・エントリの編集

作成したナビゲーション・バー・エントリは、ナビゲーション・バー・エントリ・ページで編集できます。

ナビゲーション・バー・エントリを編集するには、次のステップを実行します。

1. ナビゲーション・バー・エントリ・ページにナビゲートします。

a. 「ワークスペース」ホームページにナビゲートします。

b. 「アプリケーション・ビルダー」アイコンをクリックします。

c. アプリケーションを選択します。

d. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

e. 「ナビゲーション」で、「ナビゲーション・バー・エントリ」をクリックします。

ナビゲーション・バー・エントリ・ページが表示されます。

2. ナビゲーション・バー・エントリを選択します。

編集ページが表示されます。

3. 対象となる属性を編集します。

4. ページの特定アイテムの詳細は、フィールドレベル・ヘルプを参照してください。

5. 「変更の適用」をクリックします。

関連項目:

「フィールドレベル・ヘルプの表示」

14.4.5 複数のナビゲーション・バー・エントリの同時編集

複数のナビゲーション・バー・エントリを同時に編集するには、次のステップを実行します。

1. リスト・ページにナビゲートします。

a. 「ワークスペース」ホームページにナビゲートします。

b. 「アプリケーション・ビルダー」をクリックします。

c. アプリケーションを選択します。

d. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

e. 「ナビゲーション」で、「ナビゲーション・バー・リスト」をクリックします。

2. リストを選択します。

3. ページ上部の「グリッド編集」をクリックします。

4. 該当する属性を編集し、「保存」をクリックします。

14.4.6 ナビゲーション・バー・エントリ・レポートへのアクセス

「ナビゲーション・バー・エントリ」ページ上部の該当するタブをクリックすると、ナビゲーション・バー・エントリ・サブスクリプションおよびナビゲーション・バー・エントリ履歴のレポートを表示できます。

注意:

「サブスクリプション」ボタンと「履歴」ボタンが表示されるのは、ナビゲーション・バーを作成した後のみです。

1. ナビゲーション・バー・エントリ・ページにナビゲートします。

a. 「ワークスペース」ホームページにナビゲートします。

b. 「アプリケーション・ビルダー」アイコンをクリックします。

c. アプリケーションを選択します。

d. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

e. 「ナビゲーション」で、「ナビゲーション・バー・エントリ」をクリックします。

2. 該当するタブをクリックします。

- サブスクリプション - 「サブスクリプション」をクリックすると、「サブスクライブされたナビゲーション・バー」レポートにアクセスできます。このレポートには、アプリケーションでサブスクライブされたナビゲーション・バー・エントリが表示されます。

- 履歴 - 「履歴」をクリックすると、「ナビゲーション・バー履歴」レポートにアクセスできます。このレポートには、ナビゲーション・バーの最近の変更が示されます。

14.5 ブランチを使用したナビゲーションの制御

この項では、アプリケーションへのブランチの追加方法について説明します。ブランチは、指定したページが送信された後の特定のページ、プロシージャまたはURLへのリンクに対する指示です。たとえば、ページ1の送信後、ページ1からページ2にブランチできます。

トピック:

- ページ・デザイナでのブランチの作成

- コンポーネント・ビューでのブランチの作成

- 条件付きブランチ処理について

関連項目:

ページ固有のユーティリティへのアクセス

14.5.1 ページ・デザイナでのブランチの作成

ページ・デザイナでブランチを作成するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. ページを選択します。

ページ・デザイナが表示されます。

2. 「レンダリング」または「プロセスタブ」で、「ブランチ」を右クリックして、「ブランチの作成」を選択します。

プロパティ・エディタにブランチ属性が表示されます。

ヒント:

「メッセージ」タブに、対処が必要なメッセージを示す赤または黄色の印が表示されます。メッセージを選択すると、プロパティ・エディタに関連する属性が表示されます。赤いエラー・メッセージは、保存する前に対処する必要があります。

a. 指定、名前: 開発者が簡単に識別できるブランチ名を指定します。

b. 実行オプション:

i. 順序: このコンポーネントの順序を指定します。これによって実行の順序が決まります。

ii. ポイント: このブランチ・アクションが考慮される処理内のポイントを選択します。オプションは次のとおりです。

- 送信後(以前の名前は計算の前)

- 検証中(以前の名前は検証の前)

- プロセス(以前の名前はプロセスの前)

- プロセスの後(以前の名前はプロセスの後)

- ヘッダーの前(以前の名前はヘッダーの前)

c. 動作、タイプ: ページ・ブランチ・タイプを選択します。詳細は、中央ペインで「ヘルプ」タブをクリックします。

プロパティ・エディタに表示される属性は、選択したブランチ・タイプによって異なります。

タイプが「ページまたはURL(リダイレクト)」の場合、「ターゲット」をクリックして、リンク・ビルダー・ターゲット・ダイアログで属性を編集します。

d. サーバー側の条件:

i. 対象ボタン: このページ処理コンポーネントを、指定したボタンがクリックされたときのみ実行する場合、リストからボタンを選択します。このボタンの条件を他の条件と統合し、このページ処理コンポーネントがいつ実行されるかをさらに絞り込むことができます。

ii. 条件タイプ: このコンポーネントをレンダリングまたは処理するために満たす必要がある条件タイプをリストから選択します。詳細は、中央ペインで「ヘルプ」タブをクリックします。

3. プロパティ・エディタですべての属性を表示するには、「すべて表示」をクリックします。

4. 次のブランチ属性を編集します。

ヒント:

属性の詳細は、プロパティ・エディタで属性を選択し、中央ペインで「ヘルプ」タブをクリックして、参照してください。

5. 「保存」をクリックします。

関連項目:

- 「対象ボタン」属性について

- 「レンダリング前ブランチ、計算およびプロセスの作成」

- 「ページ送信ブランチ、検証、計算およびプロセスの作成」

14.5.2 コンポーネント・ビューでのブランチの作成

ブランチの作成ウィザードを実行し、ブランチ・ポイントおよびブランチ・タイプを指定すると、ブランチを作成できます。

ブランチを作成するには、次のステップを実行します。

1. ページに移動します。レガシー・コンポーネント・ビューでのページの表示を参照してください。

2. 「ブランチ」で、「作成」アイコンをクリックします。

ブランチの作成ウィザードが表示されます。

3. 「ブランチ属性」で、次のステップを実行します。

a. 名前: 開発者が簡単に識別できるブランチ名を指定します。

b. 順序: このコンポーネントの順序を指定します。これによって評価の順序が決まります。

c. ブランチ・ポイント: ブランチ・ポイントを選択します。オプションは次のとおりです。

- 送信時: 計算の前: 計算、検証またはプロセスの前にブランチが実行されます。このオプションは、プロセスを起動する必要がないボタン(「取消」ボタンなど)に使用します。

- 送信時: 検証の前: 計算の後、検証またはプロセスの前にブランチが実行されます。検証が失敗すると、ページ・プロセスは停止し、ロールバックが実行され、ページにエラーが表示されます。このデフォルト動作のために、ブランチを作成して検証を提供する必要がありません。ただし、計算の結果に応じてブランチする必要がある場合があります(たとえば、前のブランチ・ポイントに戻る場合)。

- 送信時: プロセスの前: 計算および検証の後、プロセスの前にブランチが実行されます。このオプションを使用すると、検証されたセッション・ステートに基づいて、ページ・プロセスの実行前にブランチされます。

- 送信時: プロセスの後: 計算、検証およびプロセスの後にブランチが実行されます。このオプションを使用すると、計算、検証およびプロセスの実行後にURLまたはページにブランチされます。このオプションを使用する際、任意のブランチ・ポイントに複数のブランチが存在する場合は、ブランチを順序付ける必要があります。

- ロード時: ヘッダーの前: ページのレンダリング前にブランチが実行されます。このオプションを使用すると、カレント・ページではなく別のページが表示されるか、またはユーザーが別のURLまたはプロシージャにリダイレクトされます。

d. ブランチ・タイプ: ブランチ・タイプを選択します。最も一般的なブランチ・タイプは「ページまたはURLにブランチ」です。

e. 「次」をクリックします。

4. 「ターゲット」で、画面に表示される手順に従います。表示される属性は、選択した「ブランチ・タイプ」タイプによって異なります。詳細は、アイテムのヘルプを参照してください。

5. 「ブランチ条件」で、次のステップを実行します。

a. 対象ボタン - ユーザーが特定のボタンをクリックした場合にのみこのブランチを実行するには、リストからボタンを選択します。このボタンの条件を他の条件と統合し、このブランチをいつ実行するかをさらに絞り込むことができます。

b. 条件タイプ: このコンポーネントをレンダリングまたは処理するために満たす必要がある条件タイプをリストから選択します。

6. 「ブランチの作成」をクリックします。

関連項目:

「対象ボタン」属性について

14.5.3 条件付きブランチ処理について

他のコントロールと同様に、ブランチが条件付きで実行されるように設定できます。ブランチが条件付きで実行されるようにするには、プロパティ・エディタでブランチ属性を表示します。「サーバー側の条件」で、適切な属性を編集します。

15 計算、検証およびプロセスの管理

この項では、計算、検証およびプロセスの管理方法について説明します。

トピック:

- ページ計算の理解

- 検証の理解

- ページ・プロセスの理解

- ブランチについて

- アプリケーション・プロセスの理解

- アプリケーションの計算の理解

- 属性ディクショナリの使用

関連項目:

- 「クイック・スタート」

- 「アプリケーション・ビルダーの概念」

- データベース・アプリケーションの作成

- 「ページ・レイアウトの制御」

- 「ナビゲーションの追加」

15.1 ページ計算の理解

この項では、ページ・デザイナおよびコンポーネント・ビューでページ計算を管理する方法について説明します。ページ計算を使用して、ページの送信時または表示時に、指定したアイテムに値を割り当てることができます。アプリケーション・レベルの計算を使用して、アイテムに値を割り当てることもできます。ほとんどのページ・レベルの計算では、ページ・アイテムを移入します。一方、ほとんどのアプリケーション・レベルの計算では、アプリケーション・アイテムを移入します。

トピック:

- ページ計算について

- ページ・デザイナでのページ計算の管理

- レガシー・コンポーネント・ビューでのページ計算の管理

- 計算ポイントおよび計算構文の例

関連項目:

アプリケーションの計算の理解

15.1.1 ページ計算について

ページ計算では、ページが表示または送信(レンダリングおよび処理)されたときに、指定したアイテムに値が割り当てられます。ページ計算を作成するには、ページ計算の作成ウィザードを実行します。各計算には、計算の作成対象のアイテムおよび計算タイプを指定します。

15.1.2 ページ・デザイナでのページ計算の管理

この項では、ページ・デザイナでページ計算を作成する方法について説明します。

ヒント:

検証エラーがあった際の処理の詳細を理解します。

トピック:

- ページ・デザイナでのページ計算の作成

- ページ・デザイナでのページ計算属性の編集

- 計算ポイントおよびソースの編集について

- 条件付き計算の作成について

関連項目:

- アプリケーションの計算の理解

- 「検証が失敗した場合の処理」

15.1.2.1 ページ・デザイナでのページ計算の作成

ページ計算を作成するには、次のステップを実行します。

1. ページ・デザイナで適切なページにナビゲートします。

2. 「レンダリング」タブで、「レンダリング前」または「レンダリング後」のノードを展開し、計算を配置する場所を見つけます。

3. その場所を右クリックして、「計算の作成」を選択します。

プロパティ・エディタに計算属性が表示されます。

4. プロパティ・エディタですべての属性を表示するには、「すべて表示」をクリックします。

5. 次の属性を編集します。

a. 指定、アイテム名 - この計算によって移入されるページまたはアプリケーション・アイテムを入力します。

b. 実行オプション、順序 - この計算の順序を指定します。これによって実行の順序が決まります。

c. 実行オプション、ポイント - ページのレンダリングまたは処理のどのポイントでこの計算を実行するかを選択します。最も一般的な計算ポイントは、「送信後」です。

d. 計算、タイプ - 計算タイプを選択します。オプションのリストを表示するには、ヘルプを参照してください。

ヒント:

属性の詳細は、プロパティ・エディタで属性を選択し、中央ペインで「ヘルプ」タブをクリックして、参照してください。

次に、イベントがTrueまたはFalseに評価された場合に実行するアクションを定義します。

6. 「保存」をクリックします。

関連項目:

- 「ページ・デザイナでのページの表示」

- 「レンダリング前ブランチ、計算およびプロセスの作成」

- 「ページ送信ブランチ、検証、計算およびプロセスの作成」

15.1.2.2 ページ・デザイナでのページ計算属性の編集

作成した計算は、ページ計算の編集ページで編集できます。

ページ計算を編集するには、次のステップを実行します。

1. ページ・デザイナでアイテムを含めるページを表示します。

2. 「レンダリング」タブで、「レンダリング前」または「レンダリング後」ノードを展開して、計算を選択します。

3. 「プロパティ・エディタ - 計算」で、適切な属性を編集します。

ヒント:

属性の詳細は、プロパティ・エディタで属性を選択し、中央ペインで「ヘルプ」タブをクリックして、参照してください。

4. 「保存」をクリックします。

関連項目:

ページ・デザイナでのページの表示

15.1.2.3 計算ポイントおよびソースの編集について

計算を実行するタイミングは、「実行オプション」、順序および実行オプション、「ポイント」を使用して制御します。「順序」属性によって、評価の順序が決定されます。「ポイント」属性によって、計算を実行するページのレンダリングまたは処理のポイントが決定されます。最も一般的な計算ポイントは、「送信後」です。たとえば、「新しいインスタンス開始時」を選択すると、新しいセッション(またはインスタンス)の生成時に計算が実行されます。

順序およびポイントの指定後、「計算」にアイテムの値を計算するための式または問合せを入力します。計算が失敗した場合のために、「エラー・メッセージ」属性にエラー・メッセージを定義できます(オプション)。

関連項目:

コンポーネント・ビューでのページ計算属性の編集

15.1.2.4 条件付き計算の作成について

プロパティ・エディタで計算属性を表示して、計算条件を作成できます。「サーバー側の条件」で、適切な属性を編集します。

関連項目:

- 条件付きのレンダリングおよびプロセスの理解

- プロパティ・エディタへのアクセス

15.1.3 レガシー・コンポーネント・ビューでのページ計算の管理

開発者は、コンポーネント・ビューでページ計算を作成および編集できます。

ヒント:

検証エラーがあった際の処理の詳細は、検証が失敗した場合の処理を参照してください。

トピック:

- コンポーネント・ビューでのページ計算の作成

- コンポーネント・ビューでのページ計算属性の編集

- 計算ポイントおよびソースの編集について

- 条件付き計算の作成について

関連項目:

- アプリケーションの計算の理解

- ページ固有のユーティリティへのアクセス

15.1.3.1 コンポーネント・ビューでのページ計算の作成

ページ計算では、ページが表示または送信(レンダリングおよび処理)されたときに、指定したアイテムに値が割り当てられます。ページ計算を作成するには、ページ計算の作成ウィザードを実行します。各計算について、計算の作成対象のアイテムを指定し、計算タイプを選択します。

ページ計算を作成するには、次のステップを実行します。

1. 適切なページにナビゲートします。レガシー・コンポーネント・ビューでのページの表示を参照してください。

2. 計算の作成ウィザードにアクセスします。「計算」で、「作成」アイコンをクリックします。

3. 「アイテム・タイプ」で、計算を実行する場所を選択して、「次へ」をクリックします。位置オプションは次のとおりです。

a. このページのアイテム

b. 他のページのアイテム

c. アプリケーション・レベル・アイテム

4. 「アイテム」は、次のようにします。

a. 計算するアイテム: 計算によって更新されるアイテムを選択します。

b. 順序: 評価の順序を選択します。

c. 計算ポイント: 計算を実行するポイントを選択します。計算ポイント「新規インスタンス開始時」では、新しいセッション(またはインスタンス)の生成時に計算が実行されます。

d. 計算タイプ: 作成する計算方法を選択します。

e. 「次へ」をクリックします。

5. 「計算」で、選択した計算タイプに対応する計算を入力し、「次へ」をクリックします。

6. 「条件」で、計算を条件付きにするかどうかを選択できます。計算を条件付きにする場合、「条件タイプ」リストから選択し、式フィールドにテキストを入力します。

7. 「計算の作成」をクリックします。

15.1.3.2 コンポーネント・ビューでのページ計算属性の編集

作成した計算は、ページ計算の編集ページで編集できます。

ページ計算を編集するには、次のステップを実行します。

1. 適切なページにナビゲートします。レガシー・コンポーネント・ビューでのページの表示を参照してください。

2. ページ計算の編集ページにアクセスします。「計算」で、計算名を選択します。

ページ計算の編集ページが表示されます。

3. 対象となる属性を編集します。

4. 「変更の適用」をクリックします。

15.1.3.3 計算ポイントおよびソースの編集について

計算を実行するタイミングは、ページ計算の編集ページの「順序」および「計算ポイント」属性を使用して制御します。「順序」属性によって、評価の順序が決定されます。「計算ポイント」属性によって、アイテムの計算を実行するポイントを指定できます。たとえば、「新しいインスタンス開始時」を選択すると、新しいセッション(またはインスタンス)の生成時に計算が実行されます。

順序および計算ポイントの指定後、「ソース」で、アイテムの値を計算するための式または問合せを「計算」フィールドに入力します。計算が失敗した場合のために、「計算エラー・メッセージ」フィールドにエラー・メッセージを定義できます(オプション)。

関連項目:

コンポーネント・ビューでのページ計算属性の編集

15.1.3.4 条件付き計算の作成について

ページ計算の編集ページで、「条件タイプ」リストから選択し、式のフィールドにテキストを入力することによって、条件付き計算を作成できます。

関連項目:

- コンポーネント・ビューでのページ計算属性の編集

- 条件付きのレンダリングおよびプロセスの理解

15.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. 「計算タイプ」で、次の計算タイプを作成できます。

a. 静的割当て:

- 「計算タイプ」で「静的割当て」を選択して、「次へ」をクリックします。

- 次の計算を入力します。

(&P10_AREA_CODE.) &P10_PREFIX.-&P10_LINE_NUMBER.

- 「次へ」をクリックします。

b. 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;

- 「次へ」をクリックします。

c. SQL問合せ(コロン区切りの値を返す):

- 「計算タイプ」で、「SQL問合せ(コロン区切りの値を返す)」を選択して、「次へ」をクリックします。

- 次の計算を入力します。

SELECT '('||:P10_AREA_CODE||')'||:P10_PREFIX||'-'||:P10_LINE_NUMBER FROM DUAL

- 「次へ」をクリックします。

d. PLSQL式:

- 「計算タイプ」で「PL/SQL式」を選択して、「次へ」をクリックします。

- 次の計算を入力します。

'('||:P10_AREA_CODE||')'||:P10_PREFIX||'-'||:P10_LINE_NUMBER

- 「次へ」をクリックします。

8. 「作成」をクリックします。

関連項目:

ページ・アイテムとアプリケーション・アイテムの違いについて

15.2 検証の理解

この項では、検証の作成方法について説明します。

トピック:

- 検証について

- ページ・デザイナでの検証の管理

- レガシー・コンポーネント・ビューでの検証の管理

- 検証の実行タイミングの決定について

- 検証エラー・メッセージの表示方法の定義について

- 検証の条件付き実行

- 「エラーに移動」リンクの変更について

- 検証が失敗した場合の処理

15.2.1 検証について

検証は編集確認です。単一アイテムに固有の検証は、ページ・アイテムの検証です。ページ全体に適用する検証は、ページの検証です。単一列に固有の表形式フォームの検証は、列レベルの検証です。単一列に適用しない表形式フォームの検証は、表形式フォームの行の検証です。

検証を宣言的に定義するには、検証方法を選択します。検証メッセージ・フィールドに、実際の検証の編集確認を入力します。検証が失敗した場合は、後続のページ・プロセスまたは計算が行われないことに注意してください。また、入力した検証は、選択した検証タイプと一貫性がある必要があることも注意してください。

15.2.2 ページ・デザイナでの検証の管理

この項では、検証の作成方法について説明します。

トピック:

- ページ・デザイナでの検証の作成

- ページ・デザイナでの検証の編集

関連項目:

関連項目:

- 「フォームでのユーザー入力の検証」

- 「検証の実行」について

- アイテム・タイプについて

15.2.2.1 ページ・デザイナでの 検証の作成

ページ・デザイナで検証を作成するには、次のステップを実行します。

注意:

検証に対して入力するテキストは、3,950文字以下にする必要があります。

1. ページ・デザイナでページを表示します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. ページを選択します。

ページ・デザイナが表示されます。

2. 左ペインで「プロセス」タブをクリックします。

3. 「検証」を右クリックして、「検証の作成」を選択します。

検証属性がプロパティ・エディタに表示されます。

プロパティ・エディタですべての属性を表示するには、「すべて表示」をクリックします。

4. グループまたは属性を検索するには、「フィルタ・プロパティ」フィールドにキーワードを入力します。

5. 次の属性を編集します。

a. 指定、名前 - 検証の名前を入力します。

b. 実行オプション、順序 - この検証の順序を入力します。これによって実行の順序が決まります。

c. 検証、編集可能リージョン - 関連するリージョンを選択します。

d. 検証、タイプ - この検証に対してテストする等価のタイプを選択します。選択によっては、この検証を完全に定義するために1つ以上の追加属性が必要となります。

検証が等価テストをパスした場合、またはTRUEと評価された場合、検証エラー・メッセージは表示されません。検証エラー・メッセージは、検証が等価テストに失敗した場合、FALSEと評価された場合、または空でないテキスト文字列が返された場合に表示されます。

e. 検証、常に実行 - この検証を常に実行するかどうかを指定します。

「はい」に設定した場合、ページを送信したボタンに対して定義されている「検証の実行」の設定に関係なく、この検証は常に評価されます。「いいえ」に設定した場合、この検証は、トリガー元のボタンの「検証の実行」の設定が「はい」の場合にのみ評価されます。

f. エラー、エラー・メッセージ - エラー・メッセージのテキストを入力します。

g. エラー、表示位置 - この検証のエラー・メッセージが表示される位置を選択します。

検証エラー・メッセージは、別のエラー・ページに表示したり、既存ページ内にインラインで表示することができます。インライン・エラー・メッセージは、ページ・テンプレートの一部として定義されている「関連付けられたアイテム」ラベルの下/「通知」領域内に表示されます。

h. エラー、関連付けられたアイテム/関連付けられた列 - この検証のエラー・メッセージを表示するアイテムまたは列を選択します。

アイテムを選択し、エラー・メッセージの表示位置に「フィールドでインライン表示」が含まれる場合、エラー・メッセージは指定されたアイテム・ラベルの下に表示されます。エラー・メッセージの表示位置に「フィールドでインライン表示」が含まれない場合、この属性はエラー・メッセージの表示に影響しません。

ヒント:

属性の詳細は、プロパティ・エディタで属性を選択し、中央ペインで「ヘルプ」タブをクリックして、参照してください。

6. 「保存」をクリックします。

関連項目:

- 「レンダリング前ブランチ、計算およびプロセスの作成」

- 「ページ送信ブランチ、検証、計算およびプロセスの作成」

15.2.2.2 ページ・デザイナでの検証の編集

ページ・デザイナで検証を編集するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. ページを選択します。

ページ・デザイナが表示されます。

2. 左ペインで「プロセス」タブをクリックします。

3. 「検証中」を展開してから「検証」を展開し、検証を選択します。

プロパティ・エディタに検証属性が表示されます。

4. プロパティ・エディタですべての属性を表示するには、「すべて表示」をクリックします。

5. グループまたは属性を検索するには、「フィルタ・プロパティ」フィールドにキーワードを入力します。

6. プロパティ・エディタで、適切な属性を編集します。

ヒント:

属性の詳細は、プロパティ・エディタで属性を選択し、中央ペインで「ヘルプ」タブをクリックして、参照してください。

7. 「保存」をクリックします。

15.2.3 レガシー・コンポーネント・ビューでの検証の管理

開発者は、検証の作成ウィザードを実行して、検証を作成します。このウィザードは、検証対象に応じてわずかに変化します。検証は、指定のフィールドに固有(単一ページ・アイテムまたは表形式フォーム列の検証)か、フィールドに固有のものではない(ページまたは表形式フォーム行の検証)かのいずれかです。

トピック:

- ページ・アイテムの検証の作成

- ページ全体の検証の作成

- 表形式フォーム列の検証の作成

- 表形式フォーム行の検証の作成

- コンポーネント・ビューでの検証の編集

関連項目:

- 「フォームでのユーザー入力の検証」

- 「検証の実行」について

- アイテム・タイプについて

15.2.3.1 ページ・アイテムの検証の作成

ページ・アイテムの検証を作成するには、次のステップを実行します。

注意:

検証に対して入力するテキストは、3,950文字以下にする必要があります。

1. 適切なページにナビゲートします。レガシー・コンポーネント・ビューでのページの表示を参照してください。

2. 検証の作成ウィザードにアクセスします。「ページ・プロセス」で、「検証」を探します。「作成」アイコンをクリックします。

検証の作成ウィザードが表示されます。

3. 「検証レベルの指定」で、「ページ・アイテム」を選択して「次へ」をクリックします。

4. 「検証するページ・アイテムを指定してください」で、検証するアイテムを選択して「次へ」をクリックします。

5. 「順序と名前」で、次のステップを実行します。

a. 順序: このアイテムの順序番号を入力します。

b. 「検証名」: この検証の名前を入力します。

c. エラー表示位置: 検証エラー・メッセージの表示位置を選択します。検証エラー・メッセージは、エラー・ページに表示したり、送信済ページにインラインで表示できます。インライン検証は、通知領域(ページ・テンプレートの一部として定義される)に表示したり、フィールド・ラベル内に表示することができます。

d. 「次へ」をクリックします。

6. 「検証タイプ」で、表15-1の説明に従って方法を選択し、「次へ」をクリックします。

表15-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

データベース内の値と比較します。検証タイプを選択します。

- EXISTS

- 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. 「検証」で、次の項目を指定します。

a. エラー・メッセージ: 検証方法に応じて、検証が失敗した場合に表示する検証またはメッセージ・テキストを入力します。

関連付けられたページ・アイテムのプレースホルダとして、#LABEL#を使用できます。

b. 常に実行: ページが送信されるときに検証を実行するかどうかを決定します。この属性は、ページを送信するボタンまたは特定のページについての「検証の実行」属性とともに使用します。オプションは次のとおりです。

- 「はい」: 検証は、ページ上のボタンまたはアイテムの検証設定とは無関係に常に実行されます。定義済条件が依然として適用されることに注意してください。

- 「いいえ」: 検証は、ページを送信するために使用されるボタンまたはアイテムの「検証の実行」属性が「はい」に設定されているときにのみ実行されます。

c. 「次へ」をクリックします。

8. この検証に適用される条件を定義し、「作成」をクリックします。

15.2.3.2 ページ全体の検証の作成

ページ全体の検証を作成するには、次のステップを実行します。

注意:

検証に対して入力するテキストは、3,950文字以下にする必要があります。

1. 適切なページにナビゲートします。レガシー・コンポーネント・ビューでのページの表示を参照してください。

2. 検証の作成ウィザードにアクセスするには、次のステップを実行します。「ページ・プロセス」で、「検証」を探します。「作成」アイコンをクリックします。

検証の作成ウィザードが表示されます。

3. 「検証レベル」で、「ページ」を選択し、「次へ」をクリックします。

4. 「順序と名前」で、次のステップを実行します。

a. 順序: このアイテムの順序番号を入力します。

b. 「検証名」: この検証の名前を入力します。

c. エラー表示位置: 検証エラー・メッセージの表示位置を選択します。検証エラー・メッセージは、エラー・ページに表示したり、送信済ページにインラインで表示できます。インライン検証は、通知領域(ページ・テンプレートの一部として定義される)に表示したり、フィールド・ラベル内に表示することができます。

d. 「次へ」をクリックします。

5. 「検証タイプ」で、表15-2の説明に従って方法を選択し、「次へ」をクリックします。

表15-2 ページの検証方法

検証方法

説明

SQL

データベース内の値と比較します。検証タイプを選択します。

- EXISTS

- NOT EXISTS

- SQL式

詳細は、このページの下部にある構文の例を参照してください。

PL/SQL

複雑なロジックが必要な場合に便利です。検証タイプを選択します。

- PL/SQL式

- PL/SQLエラー

- ブールを戻すファンクション

- エラー・テキストを戻すファンクション

詳細は、このページの下部にある構文の例を参照してください。

6. 「検証」で、次の項目を指定します。

a. 検証コード: 選択した検証タイプに対応するコードを入力します。

b. エラー・メッセージ: 検証方法に応じて、検証が失敗した場合に表示する検証またはメッセージ・テキストを入力します。

関連付けられたページ・アイテムのプレースホルダとして、#LABEL#を使用できます。

c. 常に実行: ページが送信されるときに検証を実行するかどうかを決定します。この属性は、ページを送信するボタンまたは特定のページについての「検証の実行」属性とともに使用します。オプションは次のとおりです。

- 「はい」: 検証は、ページ上のボタンまたはアイテムの検証設定とは無関係に常に実行されます。定義済条件が依然として適用されることに注意してください。

- 「いいえ」: 検証は、ページを送信するために使用されるボタンまたはアイテムの「検証の実行」属性が「はい」に設定されているときにのみ実行されます。

d. 「次へ」をクリックします。

7. この検証に適用される条件を定義し、「作成」をクリックします。

関連項目:

検証の実行タイミングの決定について

15.2.3.3 表形式フォーム列の検証の作成

表形式フォーム列の検証を作成するには、次のステップを実行します。

注意:

検証に対して入力するテキストは、3,950文字以下にする必要があります。

1. 適切なページにナビゲートします。レガシー・コンポーネント・ビューでのページの表示を参照してください。

2. 検証の作成ウィザードにアクセスするには、次のステップを実行します。「ページ・プロセス」で、「検証」を探します。「作成」アイコンをクリックします。

検証の作成ウィザードが表示されます。

3. 「検証レベル」で、次のステップを実行します。

a. 表形式フォーム: この検証に関連付ける表形式フォーム・リージョンを選択します。

b. 検証レベルの指定: 「列」を選択します。

c. 「次へ」をクリックします。

4. 「検証する列を指定してください」で、列を選択して「次へ」をクリックします。

5. 「順序と名前」で、次のように指定し、「次へ」をクリックします。

- 順序: このアイテムの順序番号を入力します。

- 「検証名」: この検証の名前を入力します。

- エラー表示位置: 検証エラー・メッセージの表示位置を選択します。検証エラー・メッセージは、エラー・ページに表示したり、送信済ページにインラインで表示できます。インライン検証は、通知領域(ページ・テンプレートの一部として定義される)に表示したり、フィールド・ラベル内に表示することができます。

6. 「検証タイプ」で、方法を選択し、画面に表示される手順に従って「次へ」をクリックします。

7. 「検証」で、次の項目を指定します。

a. 検証を定義します。表示される属性は、選択した検証タイプによって異なります。

b. エラー・メッセージ: 検証方法に応じて、検証が失敗した場合に表示する検証またはメッセージ・テキストを入力します。

関連付けられた表形式フォーム列の列ヘッダーのプレースホルダとして、#COLUMN_HEADER#を使用できます。

c. 常に実行: ページが送信されるときに検証を実行するかどうかを決定します。この属性は、ページを送信するボタンまたは特定のページについての「検証の実行」属性とともに使用します。オプションは次のとおりです。

- 「はい」: 検証は、ページ上のボタンまたはアイテムの検証設定とは無関係に常に実行されます。定義済条件が依然として適用されることに注意してください。

- 「いいえ」: 検証は、ページを送信するために使用されるボタンまたはアイテムの「検証の実行」属性が「はい」に設定されているときにのみ実行されます。

d. 「次へ」をクリックします。

8. 「条件」で、この検証に適用する条件を定義します。

9. 「検証の作成」をクリックします。

関連項目:

検証の実行タイミングの決定について

15.2.3.4 表形式フォーム行の検証の作成

表形式フォーム行の検証を作成するには、次のステップを実行します。

注意:

検証に対して入力するテキストは、3,950文字以下にする必要があります。

1. 適切なページにナビゲートします。レガシー・コンポーネント・ビューでのページの表示を参照してください。

2. 検証の作成ウィザードにアクセスするには、次のステップを実行します。「ページ・プロセス」で、「検証」を探します。「作成」アイコンをクリックします。

検証の作成ウィザードが表示されます。

3. 「検証レベル」で、次のステップを実行します。

a. 表形式フォーム: この検証に関連付ける表形式フォーム・リージョンを選択します。

b. 検証レベルの指定: 「表形式フォームの行」を選択します。

c. 「次へ」をクリックします。

4. 「順序と名前」で、次のように指定し、「次へ」をクリックします。

a. 順序: このアイテムの順序番号を入力します。

b. 「検証名」: この検証の名前を入力します。

c. エラー表示位置: 検証エラー・メッセージの表示位置を選択します。検証エラー・メッセージは、エラー・ページに表示したり、送信済ページにインラインで表示できます。インライン検証は、通知領域(ページ・テンプレートの一部として定義される)に表示したり、フィールド・ラベル内に表示することができます。

5. 「検証タイプ」で、検証タイプを選択し、画面に表示される手順に従って「次へ」をクリックします。

6. 「検証」で、次の項目を指定します。

a. 検証コード: 選択した検証タイプに対応するコードを入力します。

b. エラー・メッセージ: 検証方法に応じて、検証が失敗した場合に表示する検証またはメッセージ・テキストを入力します。

関連付けられた表形式フォーム列の列ヘッダーのプレースホルダとして、#COLUMN_HEADER#を使用できます。

c. 常に実行: ページが送信されるときに検証を実行するかどうかを決定します。この属性は、ページを送信するボタンまたは特定のページについての「検証の実行」属性とともに使用します。オプションは次のとおりです。

- 「はい」: 検証は、ページ上のボタンまたはアイテムの検証設定とは無関係に常に実行されます。定義済条件が依然として適用されることに注意してください。

- 「いいえ」: 検証は、ページを送信するために使用されるボタンまたはアイテムの「検証の実行」属性が「はい」に設定されているときにのみ実行されます。

d. 「次へ」をクリックします。

7. 「条件」で、次のステップを実行します。

a. 対象ボタン - 選択したときに他の条件に従ってこの検証を実行するページ・ボタンを選択します。

b. 条件タイプ - このコンポーネントをレンダリング処理するために満たす必要がある条件タイプをリストから選択します。

c. 「次へ」をクリックします。

8. 「検証の作成」をクリックします。

関連項目:

検証の実行タイミングの決定について

15.2.3.5 コンポーネント・ビューでの検証の編集

表形式フォーム行の検証を作成するには、次のステップを実行します。

注意:

検証に対して入力するテキストは、3,950文字以下にする必要があります。

1. 適切なページにナビゲートします。レガシー・コンポーネント・ビューでのページの表示を参照してください。

2. 「検証」で、検証を選択します。

ページ検証の編集ページが表示されます。

3. 対象となる属性を編集します。

属性の詳細は、フィールドレベル・ヘルプを参照してください。

4. 「変更の適用」をクリックします。

関連項目:

「フィールドレベル・ヘルプの表示」

15.2.4 検証の実行タイミングの決定について

検証を作成するときに、「常に実行」属性で、ページが送信されるときに検証が実行されるかどうかが決定されます。この属性は、ページを送信する、ボタンまたは特定のページ・アイテムに使用します。「常に実行」属性には2つのオプションがあります。

- 「はい」: 検証は、ページ上のボタンまたはアイテムの検証設定とは無関係に常に実行されます。
たとえば、現行ユーザーに現行レコードの変更や削除を許可するかどうかを決定するセキュリティ・チェックとしての検証の場合は、「はい」を選択します。これにより、いずれの操作に対しても検証が実行され、権限のないユーザーによる変更を防ぐことができます。

- 「いいえ」: 検証は、ページを送信するために使用されるボタンまたはアイテムの「検証の実行」属性が「はい」に設定されているときにのみ実行されます。
たとえば、ユーザーが単にレコードを削除しようとしているときに、アイテムが数値であることを検証してエラー・メッセージを表示しても役立ちません。この場合は、ユーザーが「作成」または「変更の適用」ボタンをクリックしたときにのみ検証を実行する必要があります。

この動作を実現するには、次のステップを実行します。

- 検証で、「常に実行」に「いいえ」を設定します。

- 「作成」および「変更の適用」ボタンでは、「検証の実行」に「はい」を設定します。

- 「削除」ボタンでは、「検証の実行」を「いいえ」に設定し、不要な検証を回避します。

関連項目:

- 「ページ・デザイナでの検証の編集」

- 「コンポーネント・ビューでの検証の編集」

15.2.5 検証エラー・メッセージの表示方法の定義について

検証エラー・メッセージをインライン表示(検証が実行されたページで表示)するか、個別のエラー・ページで表示するかを選択できます。

次の検証属性を構成することによって、検証エラー・メッセージの表示方法を定義します。

1. エラー・メッセージ - このフィールドにエラー・メッセージ・テキストを入力します。

2. 表示位置 - この検証のエラー・メッセージが表示される位置を選択します。検証エラー・メッセージは、別のエラー・ページに表示したり、既存ページ内にインラインで表示することができます。インライン・エラー・メッセージは、ページ・テンプレートの一部として定義されている「関連付けられたアイテム」ラベルの下/「通知」領域内に表示されます。
オプションは次のとおりです。

- 「フィールドおよび通知でインライン表示」: エラーは、フィールド・ラベル内および通知領域(ページ・テンプレートの一部として定義される)にインラインで表示されます。

- 「フィールドでインライン表示」: エラーはフィールド・ラベル内にインラインで表示されます

- 「通知でインライン表示」: エラーは、通知領域(ページ・テンプレートの一部として定義される)にインラインで表示されます。

- 「エラー・ページ」: エラーは、個別のエラー・ページに表示されます。すべての処理(検証を含む)を停止するハード・エラーを作成する場合は、エラー・ページにエラーを表示する必要があります。

3. 関連付けられたアイテム (または関連付けられた列) - この検証のエラー・メッセージを表示するアイテム(または列)を選択します。
アイテムを選択し、エラー・メッセージの表示位置に「フィールドでインライン表示」が含まれる場合、エラー・メッセージは指定されたアイテム・ラベルの下に表示されます。エラー・メッセージの表示位置に「フィールドでインライン表示」が含まれない場合、この属性はエラー・メッセージの表示に影響しません。

関連項目:

「ページ・デザイナでの検証の編集」

15.2.6 検証の条件付き実行

次の条件属性を構成することによって、検証をいつ実行するか、および実行するかどうかを制御できます。

1. 対象ボタン: このページ処理コンポーネントを、指定したボタンがクリックされたときのみ実行する場合、リストからボタンを選択します。このボタンの条件を他の条件と統合し、このページ処理コンポーネントがいつ実行されるかをさらに絞り込むことができます。

ボタンがクリックされない場合、検証を実行する前に他の条件が評価されます。

2. 実行スコープ: 表形式フォームにのみ適用されます。次のようにして、実行スコープを指定します。

- 作成済および変更済の列: 表形式フォームで作成および変更した行でのみ検証を実行します。

- すべての送信済の列: 送信したすべての行で検証を実行します。

3. 条件タイプ: このコンポーネントをレンダリングまたは処理するために満たす必要がある条件タイプをリストから選択します。オプション・リストを表示するには、「ヘルプ」タブをクリックします。

関連項目:

- 「ページ・デザイナでの検証の編集」

- 「コンポーネント・ビューでの検証の編集」

- 条件付きのレンダリングおよびプロセスの理解

15.2.7 「エラーに移動」リンクの変更について

関連付けるアイテムを定義すると、Oracle Application Expressによって、対応するエラー・メッセージの隣の通知表示位置に「エラーに移動」リンクがレンダリングされます。クリックすると、ユーザーのフォーカスが関連付けられたアイテムに移動します。

「エラーに移動」テキストを変更して、デフォルトのテキストを変更したり、Oracle Application Expressによってデフォルトでは翻訳されない言語に翻訳することができます。いずれの場合でも、必要なテキストと言語とともに、APEX.GO_TO_ERRORという名前のテキスト・メッセージを定義してください。さらに、APEX.GO_TO_ERRORテキスト・メッセージのテキストを単なるシングル・スペースに設定して、この機能を無効化し、「エラーに移動」リンクを削除できます。

関連項目:

Oracle Application Expressにより内部使用されるメッセージの翻訳

15.2.8 検証が失敗した場合の処理

ページが送信され一部の検証が失敗した場合、Oracle Application Expressは既存のページを、すべてのインライン検証エラーを含めて再表示します。インライン・エラーの表示中は、Oracle Application Expressはページ・レンダリング中(つまり、すべての「ロード時%」の表示ポイント)に実行するように定義されている計算、アプリケーション・プロセスまたはページ・プロセス(行の自動フェッチなど)を実行しません。ただし、計算およびプロセスで「インライン検証エラーあり」条件タイプが使用されている場合のみ例外です。

これらの計算およびプロセスをスキップする理由は、これらによりユーザーが入力したデータが変更される可能性があるためです。たとえば、検証エラーを修正するためにユーザーが実際に入力されたデータを必要とする場合に、行の自動フェッチ・プロセスは、変更されたデータをフェッチし、データベースからの値で上書きします。

計算がスキップされた場合、デバッグ出力に次の内容が表示されます。

Do not perform computation because inline validation errors found.

アプリケーションまたはページ・プロセスがスキップされる場合、デバッグ出力に次の内容が表示されます。

Skip because inline validation errors found.

15.3 ページ・プロセスの理解

この項では、ページ・プロセスの作成方法について説明します。

トピック:

- ページ・プロセスについて

- ページ・デザイナでのページ・プロセスの管理

- レガシー・コンポーネント・ビューでのページ・プロセスの管理

15.3.1 ページ・プロセスについて

1つのページ・プロセスは、ページのレンダリング中または送信中の指定されたポイントで1つのアクションを実行します。たとえば、ページ・プロセスを作成して、ロジックを実行したり、Application Expressエンジンをコールできます。ページ・プロセスは、ページのロードや送信など、特定のイベントが発生したときに実行するロジックの単位です。

ファンクションの観点からみると、ページ・レベルのプロセスとアプリケーション・レベルのプロセスに違いはありません。これらの2つのプロセス・タイプの違いは、プロセスが定義された場所(ページ・レベルかアプリケーション・レベルか)です。

関連項目:

- 「アプリケーション・プロセスの理解」

- ページ固有のユーティリティへのアクセス

15.3.2 ページ・デザイナでのページ・プロセスの管理

この項では、ページ・プロセスの作成方法について説明します。

関連項目:

- 「アプリケーション・プロセスの理解」

- 「クロス・ページ・ユーティリティへのアクセス」

ヒント:

検証エラーがあった際の処理の詳細は、検証が失敗した場合の処理を参照してください。

トピック:

- ページ・デザイナでのページ・プロセスの作成

- ページ・デザイナでのページ・プロセス属性の編集

- ページ・デザイナでページ・プロセスを実行するタイミングの制御

- ページ・デザイナでのページ・プロセスの成功メッセージとエラー・メッセージの作成

- ページ・デザイナでのページ・プロセス条件の作成

15.3.2.1 ページ・デザイナでのページ・プロセスの作成

ページ・プロセスを作成するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. ページを選択します。

ページ・デザイナが表示されます。

2. 「レンダリング」または「プロセス」タブで、プロセスが発生するノードを探します。右クリックして、「プロセスの作成」を選択します。

プロセス属性がプロパティ・エディタに表示されます。

ヒント:

「メッセージ」タブに、対処が必要なメッセージを示す赤または黄色の印が表示されます。メッセージを選択すると、プロパティ・エディタに関連する属性が表示されます。赤いエラー・メッセージは、保存する前に対処する必要があります。

3. プロパティ・エディタですべての属性を表示するには、「すべて表示」を選択します。

4. グループまたは属性を検索するには、「フィルタ・プロパティ」フィールドにキーワードを入力します。

ヒント:

属性の詳細は、プロパティ・エディタで属性を選択し、中央ペインで「ヘルプ」タブをクリックして、参照してください。

5. 「指定」で、次の項目を指定します。

a. 名前 - プロセスの名前を入力します。

b. タイプ - 実行するプロセス・タイプを指定します。選択したタイプによって、表示される設定属性が決定されます。

6. 「設定」で、適切な属性を編集します。

7. 「実行オプション」で、次の項目を指定します。

a. 順序 - この計算の順序を指定します。これによって実行の順序が決まります。

2つのコンポーネントの順序値が同じである場合は、アプリケーションを別の環境にエクスポートおよびインポートするときに、異なる順序で実行されることがあります。

b. ポイント - このプロセスが実行されるポイントを選択します。

c. プロセスの実行 - このプロセスが実行される頻度を選択します。

8. 「成功メッセージ」で、次のステップを実行します。

a. エラー・メッセージ - このプロセスの成功メッセージを入力します。

プロセスが実行され、エラーが発生しない場合は、表示される結果のページの通知セクションに、このプロセス成功メッセージが表示されます。

9. 「エラー」で、次のステップを実行します。

a. エラー・メッセージ - このプロセスのエラー・メッセージを入力します。

未処理例外が発生した場合、このメッセージが表示されます。エラー・プロセスが停止した後は、常にロールバックが実行され、エラー・メッセージが表示されます。

b. 表示位置 - このプロセスが正常に完了しなかった場合のこのプロセス・エラー・メッセージの表示場所を選択します。

10. 「保存」をクリックします。

関連項目:

- 「レンダリング前ブランチ、計算およびプロセスの作成」

- 「ページ送信ブランチ、検証、計算およびプロセスの作成」

15.3.2.2 ページ・デザイナでのページ・プロセス属性の編集

既存のページ・プロセスを編集するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. ページを選択します。

ページ・デザイナが表示されます。

2. 「レンダリング」または「プロセス」タブで、ノードを展開し、プロセスを見つけて選択します。

プロセス属性がプロパティ・エディタに表示されます。

3. プロパティ・エディタですべての属性を表示するには、「すべて表示」をクリックします。

4. グループまたは属性を検索するには、「フィルタ・プロパティ」フィールドにキーワードを入力します。

5. 対象となる属性を編集します。

ヒント:

属性の詳細は、プロパティ・エディタで属性を選択し、中央ペインで「ヘルプ」タブをクリックして、参照してください。

6. 「保存」をクリックします。

15.3.2.3 ページ・デザイナでページ・プロセスを実行するタイミングの制御

プロセスをいつ実行するかを制御するには、次の属性を編集します。

1. プロセス属性をプロパティ・エディタに表示します。

2. 次の属性を編集します。

a. 実行オプション、順序 - このコンポーネントの順序を指定します。これによって実行の順序が決まります。

b. 実行オプション、ポイント - このブランチ・アクションが考慮される処理内のポイントを選択します。

3. 「保存」をクリックします。

関連項目:

「ページ・デザイナでのページ・プロセス属性の編集」

15.3.2.4 ページ・デザイナでのページ・プロセスの成功メッセージとエラー・メッセージの作成

プロセスの実行時に表示する成功メッセージとエラー・メッセージの両方を定義できます。エラー・メッセージの表示方法は、プロセス・ポイントによって異なります。「送信時 - 計算および検証の前」または「送信時 - 計算および検証の後」プロセス・ポイントを持つプロセスでは、カレント・ページにインラインでエラー・メッセージを表示するか(デフォルト)、別のページに表示するかを指定できます。他のすべてのページ・プロセスでは、エラー・メッセージは別のエラー・ページに表示されます。

ページ・プロセスのエラー・メッセージまたは成功メッセージを作成するには、次のステップを実行します。

1. プロセス属性をプロパティ・エディタに表示します。

2. 次の属性を編集します。

a. 成功メッセージ、成功メッセージ - このプロセスの成功メッセージを入力します。プロセスが実行され、エラーが発生しない場合は、表示される結果のページの通知セクションに、このプロセス成功メッセージが表示されます。URLリダイレクトを介して別のページにブランチする場合は、成功メッセージの保存属性を選択する必要があります。

b. エラー、エラー・メッセージ - このプロセスのエラー・メッセージを入力します。未処理例外が発生した場合、このメッセージが表示されます。エラー・プロセスが停止した後は、常にロールバックが実行され、エラー・メッセージが表示されます。

c. エラー、表示位置 - このプロセスが正常に完了しなかった場合のこのプロセス・エラー・メッセージの表示場所を選択します。

オプションは次のとおりです。

- 通知でインライン表示: プロセス・エラー・メッセージが「通知」領域(ページ・テンプレートの一部として定義)に表示されます。

- エラー・ページ: エラーは別のエラー・ページに表示されます。

3. 「保存」をクリックします。

関連項目:

- 「ページ・デザイナでのページ・プロセス属性の編集」

- ページ・テンプレート

15.3.2.5 ページ・デザイナでのページ・プロセス条件の作成

条件付きページ・プロセスを作成するには、次の属性を編集します。

1. プロセス属性をプロパティ・エディタに表示します。

2. 「サーバー側の条件」で、次の属性を編集します。

a. 対象ボタン: このページ処理コンポーネントを、指定したボタンがクリックされたときのみ実行する場合、リストからボタンを選択します。このボタンの条件を他の条件と統合し、このページ処理コンポーネントがいつ実行されるかをさらに絞り込むことができます。

b. 実行スコープ - 編集可能対話グリッドにのみ適用されます。次のようにして、実行スコープを指定します。

- 作成済および変更済の列: 表形式フォームで作成および変更した行でのみ検証を実行します。

- すべての送信済の列: 送信したすべての行で検証を実行します。

c. 条件タイプ: このコンポーネントをレンダリングまたは処理するために満たす必要がある条件タイプをリストから選択します。

3. 「保存」をクリックします。

関連項目:

「ページ・デザイナでのページ・プロセス属性の編集」

15.3.3 レガシー・コンポーネント・ビューでのページ・プロセスの管理

開発者は、コンポーネント・ビューでページ・プロセスを作成および編集できます。

関連項目:

「アプリケーション・プロセスの理解」

ヒント:

検証エラーがあった際の処理の詳細は、検証が失敗した場合の処理を参照してください。

トピック:

- コンポーネント・ビューでのページ・プロセスの作成

- コンポーネント・ビューでのページ・プロセス属性の編集

- ページ・プロセスを実行するタイミングの制御

- ページ・プロセスの成功メッセージとエラー・メッセージの作成

- ページ・プロセスを条件付きにする

15.3.3.1 コンポーネント・ビューでのページ・プロセスの作成

この項では、ページ・プロセスの作成方法について説明します。プロセスの作成ウィザードを実行して、プロセスを作成します。ウィザードの実行中にプロセス名を定義し、順序、およびプロセスが実行されるポイントを指定し、プロセス・カテゴリを選択します。ページ・プロセスの編集ページで、これらのほぼすべての属性を変更できます。

トピック:

- ページ・プロセスの作成

- 表形式フォームのページ・プロセスの作成

15.3.3.1.1 ページ・プロセスの作成

ページ・プロセスを作成するには、次のステップを実行します。

1. 適切なページにナビゲートします。レガシー・コンポーネント・ビューでのページの表示を参照してください。

2. ページ・プロセスの作成ウィザードにアクセスします。「プロセス」で、「作成」アイコンをクリックします。

3. 表15-3の説明に従って、「プロセス・タイプ」で、作成するプロセスのカテゴリを選択します。

表15-3 ページ・プロセス・タイプ

プロセス・カテゴリ

説明

セッション・ステートのクリア

Oracle Application Express内に格納されているセッション・ステートをクリアします。このプロセス・タイプを選択すると、既存のユーザー設定、アプリケーション、セッションまたはアイテムのキャッシュがクリアされます。

関連項目: セッション・ステート値の管理およびOracle Application Express管理ガイドの「ユーザー・プリファレンスの管理」

ダイアログを閉じる

現在のモーダルまたは非モーダル・ダイアログ・ページを閉じます。

データ操作

ウィザードでは、データ操作言語(DML)のアクションをサポートするために、「データ操作」プロセス・タイプが頻繁に使用されます。アプリケーション・ビルダーでは、次のような宣言によるデータ操作プロセスをサポートしています。

- 自動的なデータ操作言語(DML)プロセスを作成するには、「行の自動フェッチ」および「行の自動処理(DML)」を選択します。

- 「複数行の更新」および「複数行の削除」は、表形式フォームとともに使用します。

- 「表形式フォームに行の追加」は、表形式フォームとともに使用します。

フォーム・ページ区切り

データベース表またはビューから前後のレコードを取得するプロセス。このプロセスを使用すると、フォーム・ページにページ区切りが配置され、エンド・ユーザーはレポートに戻ることなく前後のレコードを取得できます。

PL/SQLコード

指定したPL/SQLコードを実行するプロセス。このプロセス・タイプを使用して、プロセスに直接入力したPL/SQLブロックを実行したり、既存のAPIをコールします。

プラグイン

開発者はプラグインを使用して、Application Expressで使用可能な組込みタイプを宣言的に拡張できます。このオプションは、プラグイン・タイプのプロセスがこのアプリケーション内に存在する場合にのみ使用可能です。

関連項目: プラグインの実装

Reset Pagination

カレント・ページでレポートのページ区切りをリセットするプロセス。

電子メールの送信

アプリケーションから電子メールおよび1つ以上の添付ファイル(オプション)を送信するプロセス。

ユーザー・プリファレンス

エンド・ユーザーのユーザー・プリファレンスを設定するプロセス。

関連項目: 『Oracle Application Express管理ガイド』のユーザー・プリファレンスの管理に関する項

Webサービス

Webサービスをページ上のプロセスとして実装します。このプロセスを実行すると、リクエストがサービス・プロバイダに送信されます。

関連項目: Webサービスをプロセスとして起動する方法

4. 画面に表示されるステップに従います。

15.3.3.1.2 表形式フォームのページ・プロセスの作成

表形式フォームのページ・プロセスを作成するには、次のステップを実行します。

1. 適切なページにナビゲートします。レガシー・コンポーネント・ビューでのページの表示を参照してください。

2. ページ・プロセスの作成ウィザードにアクセスします。「プロセス」で、「作成」アイコンをクリックします。

3. 「プロセス・タイプ」で、次の項目を指定します。

- 表形式フォーム: 関連する表形式フォーム・リージョンを選択します。

- プロセス・タイプ: 表15-4に示すプロセス・タイプを選択します。

表15-4 ページ・プロセス・タイプ

プロセス・カテゴリ

説明

セッション・ステートのクリア

Oracle Application Express内に格納されているセッション・ステートをクリアします。このプロセス・タイプを選択すると、既存のユーザー設定、アプリケーション、セッションまたはアイテムのキャッシュがクリアされます。

関連項目: セッション・ステート値の管理およびOracle Application Express管理ガイドの「ユーザー・プリファレンスの管理」

ダイアログを閉じる

現在のモーダルまたは非モーダル・ダイアログ・ページを閉じます。

データ操作

ウィザードでは、データ操作言語(DML)のアクションをサポートするために、「データ操作」プロセス・タイプが頻繁に使用されます。アプリケーション・ビルダーでは、次のような宣言によるデータ操作プロセスをサポートしています。

- 自動的なデータ操作言語(DML)プロセスを作成するには、「行の自動フェッチ」および「行の自動処理(DML)」を選択します。

- 「複数行の更新」および「複数行の削除」は、表形式フォームとともに使用します。

- 「表形式フォームに行の追加」は、表形式フォームとともに使用します。

フォーム・ページ区切り

データベース表またはビューから前後のレコードを取得するプロセス。このプロセスを使用すると、フォーム・ページにページ区切りが配置され、エンド・ユーザーはレポートに戻ることなく前後のレコードを取得できます。

PL/SQLコード

指定したPL/SQLコードを実行するプロセス。このプロセス・タイプを使用して、プロセスに直接入力したPL/SQLブロックを実行したり、既存のAPIをコールします。

プラグイン

開発者はプラグインを使用して、Application Expressで使用可能な組込みタイプを宣言的に拡張できます。このオプションは、プラグイン・タイプのプロセスがこのアプリケーション内に存在する場合にのみ使用可能です。

関連項目: プラグインの実装

Reset Pagination

カレント・ページでレポートのページ区切りをリセットするプロセス。

電子メールの送信

アプリケーションから電子メールおよび1つ以上の添付ファイル(オプション)を送信するプロセス。

ユーザー・プリファレンス

エンド・ユーザーのユーザー・プリファレンスを設定するプロセス。

関連項目: 『Oracle Application Express管理ガイド』のユーザー・プリファレンスの管理に関する項

Webサービス

Webサービスをページ上のプロセスとして実装します。このプロセスを実行すると、リクエストがサービス・プロバイダに送信されます。

関連項目: Webサービスをプロセスとして起動する方法

4. 画面に表示されるステップに従います。

15.3.3.2 コンポーネント・ビューでのページ・プロセス属性の編集

プロセスを作成すると、「ページ・プロセスの編集」ページで属性を編集することによって、プロセスを実行するタイミングおよびプロセスの内容を制御できます。

既存のページ・プロセスを編集するには、次のステップを実行します。

1. 適切なページにナビゲートします。レガシー・コンポーネント・ビューでのページの表示を参照してください。

2. ページ・プロセスの編集ページにアクセスします。「プロセス」で、プロセス名をクリックします。

「ページ・プロセスの編集」ページが表示されます。

3. 対象となる属性を編集します。詳細は、フィールドレベル・ヘルプおよび後続の項を参照してください。

4. 「変更の適用」をクリックします。

15.3.3.3 ページ・プロセスを実行するタイミングの制御

プロセスを実行するタイミングを制御するには、ページ・プロセスの編集ページの「プロセス・ポイント」で順序番号およびプロセス・ポイントを指定します。「プロセスの実行」でオプションを選択すると、後続のページへのアクセス時におけるプロセスの実行を制限できます。

プロセスを実行するタイミングを制御するには、次のステップを実行します。

1. ページ・プロセスの編集ページにアクセスします。コンポーネント・ビューでのページ・プロセス属性の編集を参照してください。

2. 次の属性を編集します。

a. プロセス・ポイント、順序 - このコンポーネントの順序を指定します。これによって実行の順序が決まります。

b. プロセス・ポイント、プロセス・ポイント - このブランチ・アクションが考慮される処理内のポイントを選択します。

c. プロセス・ポイント、プロセスの実行 - このプロセスを実行する頻度を選択します。

3. 「変更の適用」をクリックします。

15.3.3.4 ページ・プロセスの成功メッセージとエラー・メッセージの作成

プロセスの実行時に表示する成功メッセージとエラー・メッセージの両方を定義できます。エラー・メッセージの表示方法は、プロセス・ポイントによって異なります。「送信時 - 計算および検証の前」または「送信時 - 計算および検証の後」プロセス・ポイントを持つプロセスでは、カレント・ページにインラインでエラー・メッセージを表示するか(デフォルト)、別のページに表示するかを指定できます。他のすべてのページ・プロセスでは、エラー・メッセージは別のエラー・ページに表示されます。

ページ・プロセスのエラー・メッセージまたは成功メッセージを作成するには、次のステップを実行します。

1. ページ・プロセスの編集ページにアクセスします。

2. 次の属性を編集します。

a. メッセージ、プロセスの成功メッセージ - プロセスが正常に実行された場合に表示するメッセージを入力します。

b. メッセージ、プロセス・エラー・メッセージ - 未処理例外が発生した場合に表示されるメッセージを入力します。成功メッセージとエラー・メッセージの両方についてサポートされる置換文字列の詳細は、フィールドレベル・ヘルプを参照してください。

c. メッセージ、エラー・メッセージ表示位置 - プロセス・エラー・メッセージを表示する位置を指定します。プロセス・エラー・メッセージは、エラー・ページに表示するか、通知領域(ページ・テンプレートの一部として定義される)の既存のページでインライン表示できます。

3. 「変更の適用」をクリックします。

関連項目:

- 「コンポーネント・ビューでのページ・プロセス属性の編集」

- ページ・テンプレート

15.3.3.5 ページ・プロセスを条件付きにする

条件付きのページ・プロセスを作成するには、次のステップを実行します。

1. ページ・プロセスの編集ページにアクセスします。

2. 次の属性を編集します。

a. 条件、対象ボタン - ページ・ボタンを選択します。選択したボタンをユーザーがクリックすると、検証が実行されます(定義された他の条件によって異なります)。この検証は、指定されたボタンをクリックする以外の方法でページが送信された場合に実行されます。

ボタンがクリックされない場合、検証を実行する前に他の条件が評価されます。

b. 条件、実行スコープ - 表形式フォームにのみ適用されます。次のようにして、実行スコープを指定します。

- 作成済および変更済の列: 表形式フォームで作成および変更した行でのみ検証を実行します。

- すべての送信済の列: 送信したすべての行で検証を実行します。

c. 条件、条件タイプ - このコンポーネントがレンダリング処理されるために満たす必要がある条件タイプをリストから選択します。

- 式属性: 選択した条件タイプに応じて、式属性に値を入力します。

- 実行条件: 表形式フォームにのみ適用されます。次のいずれかを選択します。
各行: 条件で表形式フォームの列を参照する場合は、このオプションを選択します。このオプションにより、表形式フォームの各行で条件が評価されます。

1回: 表形式フォームに固有の値を参照しない場合は、このオプションを選択します。

3. 「変更の適用」をクリックします。

関連項目:

「コンポーネント・ビューでのページ・プロセス属性の編集」

15.4 ブランチについて

ブランチは、特定のページ、プロシージャまたはURLへ移動する指示です。たとえば、ページ1の送信後、ページ1からページ2にブランチできます。ブランチを作成する場合、ブランチ・ポイントとブランチ・タイプを指定します。

関連項目:

ブランチを使用したナビゲーションの制御

15.5 アプリケーション・プロセスの理解

この項では、アプリケーション・プロセスを作成および管理する方法について説明します。アプリケーション・プロセスとは、アプリケーションの複数ページからのプロセスを使用して、特定のポイントで実行されるように設定されているPL/SQLロジックのブロックです。デフォルトでは、アプリケーション・プロセスはアプリケーション内のすべてのページについて同じポイントで実行されます。ただし、特定のページに対する条件を適用して、プロセスが実行されるタイミングを制御できます。

ヒント:

検証エラーがあった際の処理の詳細は、検証が失敗した場合の処理を参照してください。

トピック:

- オンデマンド・アプリケーション・プロセス

- 新しいインスタンス開始時に実行されるアプリケーション・プロセスについて

- ページ・リクエストからのオンデマンド・プロセスの実行について

- アプリケーション・プロセスの例

- アプリケーション・プロセスの作成

- アプリケーション・プロセス属性の編集

- アプリケーション・プロセスのエラー・メッセージの作成

- 「アプリケーション・プロセス履歴」レポートの表示

関連項目:

ページ・プロセスの理解

15.5.1 オンデマンド・アプリケーション・プロセス

「オンデマンド」プロセスは、プロセス・ポイントが「オンデマンド」の特殊なタイプのアプリケーション・プロセスで、ページ・レベルの「オンデマンド」プロセスからコールされた場合またはブラウザからのAJAXコールによってのみ実行されます。オンデマンド・プロセスは、複数のページにわたって様々な実行ポイントから実行するPL/SQLロジックがある場合に有効です。

オンデマンド・プロセスは、通常、アプリケーションレベルではなく、ページに作成される必要があります。アプリケーションレベルで作成されたオンデマンド・プロセスは、初期認可スキームの「パブリック・ユーザーは不可」で作成されます。これは、認証されていないセッションのユーザーからプロセスが起動されることを禁止します。

関連項目:

コンポーネント・ビューでのページ・プロセスの作成

15.5.2 新しいインスタンス開始時に実行されるアプリケーション・プロセスについて

通常、アプリケーション・プロセスは、アプリケーション内の複数のページにわたって同じポイントで実行されます。プロセス・ポイントが「新しいインスタンス開始時」であるプロセスは例外です。これらのタイプのプロセスは、ユーザーのセッション内で情報を1回のみ取得する必要がある場合に便利です。たとえば、アプリケーション・アイテムがログインしているユーザーに依存していない場合は、プロセス・ポイント「新しいインスタンス開始時」を使用してそれらのアイテムを初期化できます。また、ユーザーに依存する情報を検索するために、「認証後」を使用することもできます。

認証スキーム(「新しいインスタンス開始時」および「ログイン後」)で同じCookie名を設定することによって、アプリケーションが同じセッションを共有するように構成すると、アプリケーション・プロセスは、Oracle Application Expressがアプリケーションのリクエストを最初に処理するとき(「新しいインスタンス開始時」)や、アプリケーションに対して認証されたユーザーのリクエストを処理するとき(「認証後」)、常に実行されます。

15.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でセッション・ステート(アイテムの名前および値)を設定することはできますが、「キャッシュのクリア」オプションは無視されます。

- 認証、認可、またはプロセス条件が失敗してもエラー・メッセージや失敗に対するその他のインジケータは表示されず、多くの場合、空白ページが表示されます。アプリケーション・ビルダーに開発者としてログインした場合、エラー・メッセージが表示されます。

- プロセスを名前で指定すると、指定した(大/小文字が区別される)名前を持つ最初のプロセスが検出されます。

関連項目:

セッション・ステートのクリア

15.5.4 アプリケーション・プロセスの例

アプリケーション・プロセスを使用する場合の例として、ショッピング・カート・アプリケーションがあげられます。たとえば、各ページ・ビューでユーザーのショッピング・カートのコンテンツを表示するには、アプリケーションのページ0(ゼロ)に、アプリケーション・レベル・アイテムTOTAL_CART_ITEMSおよびTOTAL_PURCHASE_PRICEの値を表示するリージョンを作成します。

各ページでTOTAL_CART_ITEMSおよびTOTAL_PURCHASE_PRICEの値を設定するプロセスを記述するかわりに、「ロード時: ヘッダーの前」というタイプのアプリケーション・プロセスを記述して、これらの値を計算できます。これによって、Application Expressエンジンは、アプリケーションをレンダリングするよう各ページでプロセスを実行します。この結果、各ページでTOTAL_CART_ITEMSおよびTOTAL_PURCHASE_PRICEの最新の値が表示されます。

関連項目:

すべてのページにコンポーネントを表示するグローバル・ページの作成

15.5.5 アプリケーション・プロセスの作成

アプリケーション・プロセスを作成するには、次のステップを実行します。

1. 共有コンポーネント・ページにナビゲートします。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。

b. アプリケーションを選択します。

c. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

共有コンポーネント・ページが表示されます。

2. 「アプリケーション・ロジック」で、「アプリケーション・プロセス」を選択します。

アプリケーション・プロセス・ページが表示されます。

3. 「作成」をクリックします。

4. 「指定」で、次のステップを実行します。

a. 名前: アプリケーション・プロセスの名前を入力します。

b. 順序: このプロセスの順序番号を指定します。この順序番号によって、同じポイントで実行される他のプロセスに対する、プロセスの相対的な評価順序が決まります。

c. ポイント: アプリケーションの各ページの処理において、このプロセスが実行されるポイントを指定します。「オンデマンド」オプションは、ページ・プロセスによりリクエストされた場合にのみ実行されることに注意してください。

d. 「次へ」をクリックします。

5. 「ソース」で、次のステップを実行します。

a. PL/SQLコード: アプリケーション・プロセスのPL/SQLコードを入力します。コードは、自動的にBeginとEnd;で囲まれます。

b. 「エラー・メッセージ」: プロセスでエラーが発生した場合に表示するエラー・メッセージを入力します。

c. 「次へ」をクリックします。

6. 「条件付け」で、次のステップを実行します。

a. 条件タイプ: このプロセスを実行するために満たされる必要がある条件タイプを選択します。

b. 式1、式2 - これらの属性を使用して、プロセスが実行されるかどうかを条件付きで制御します。選択した特定の条件タイプに基づいて、この属性に値を入力します。指定した条件が満たされた場合、プロセスが実行されます。

c. 「プロセスの作成」をクリックします。

関連項目:

「アプリケーション・プロセスのエラー・メッセージの作成」

15.5.6 アプリケーション・プロセス属性の編集

既存のページ・プロセスを編集するには、次のステップを実行します。

1. 共有コンポーネント・ページにナビゲートします。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。

b. アプリケーションを選択します。

c. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

共有コンポーネント・ページが表示されます。

2. 「ロジック」で、「アプリケーション・プロセス」を選択します。

アプリケーション・プロセス・ページが表示されます。

3. プロセス名をクリックします。

4. 対象となる属性を編集します。詳細は、フィールドレベル・ヘルプを参照してください。

5. 「変更の適用」をクリックします。

15.5.7 アプリケーション・プロセスのエラー・メッセージの作成

プロセスでエラーが発生した場合にユーザーに表示するエラー・メッセージを定義できます。エラー・メッセージの表示方法は、プロセス・ポイントによって異なります。「送信時 - 計算および検証の前」または「送信時 - 計算および検証の後」プロセス・ポイントを持つプロセスでは、カレント・ページにインラインでエラー・メッセージを表示するか(デフォルト)、別のページに表示するかを指定できます。他のすべてのアプリケーション・プロセスでは、エラー・メッセージは別のエラー・ページに表示されます。

アプリケーション・プロセスのエラー・メッセージを作成するには、次のステップを実行します。

1. アプリケーション・プロセス属性にアクセスします。

2. 次の属性を編集します。

a. ソース、プロセス・エラー・メッセージ - 未処理例外が発生した場合に表示されるメッセージを入力します。

b. エラー・メッセージ表示位置 - 「送信時 - 計算および検証の前」または「送信時 - 計算および検証の後」のプロセス・ポイントを持つプロセスに適用され、エラー・メッセージの表示位置を指定できます。

次のいずれかを選択します。

- 通知でインライン表示: エラーは、通知領域(ページ・テンプレートの一部として定義される)内のページにインラインで表示されます。

- エラー・ページ: エラーは別のエラー・ページに表示されます。
アプリケーションに、(SQL文のAPEX_ITEMコールを使用して)手動で作成された表形式フォームが含まれている場合は、「エラー・ページ」を選択してください。そうしない場合、ユーザーが行った変更はページが再レンダリングされるときに破棄されます。エラーが別のエラー・ページに表示される場合、ユーザーはブラウザの「戻る」ボタンを使用して、入力された値を保持できます。

3. 「変更の適用」をクリックします。

関連項目:

「アプリケーション・プロセス属性の編集」

15.5.8 「アプリケーション・プロセス履歴」レポートの表示

「アプリケーション・プロセス履歴」レポートには、アプリケーション・プロセスに行われた最近の変更が表示されます。

「アプリケーション・プロセス履歴」レポートにアクセスするには、次のステップを実行します。

1. 共有コンポーネント・ページにナビゲートします。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。

b. アプリケーションを選択します。

c. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

共有コンポーネント・ページが表示されます。

2. 「ロジック」で、「アプリケーション・プロセス」を選択します。

アプリケーション・プロセス・ページが表示されます。

3. ページ上部の 「履歴」 タブを選択します。

4. ページ上部の検索バーを使用してページの概観をカスタマイズできます。使用可能なコントロールは次のとおりです。

- 検索列の選択: 虫めがねに似ています。このアイコンをクリックして、検索を絞り込みます。すべての列を検索するには、「すべての列」を選択します。

- テキスト領域: 名前でプロセスを検索するための大/小文字を区別しない検索基準(ワイルドカード文字を含む)を入力し、「実行」をクリックします。

- 「実行」ボタン: 検索を実行したり、フィルタを適用します。

- アクション・メニュー: このアクション・メニューを使用して、レポート・ビューをカスタマイズします。

関連項目:

「アクション」メニューについて

15.6 アプリケーションの計算の理解

この項では、アプリケーションの計算を作成する方法について説明します。

ヒント:

検証エラーがあった際の処理の詳細は、検証が失敗した場合の処理を参照してください。

トピック:

- アプリケーションの計算について

- 新しいインスタンス開始時に実行されるアプリケーションの計算について

- アプリケーションの計算の作成

- アプリケーション計算履歴レポートへのアクセス

15.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;

15.6.2 新しいインスタンス開始時に実行されるアプリケーションの計算について

通常、アプリケーションの計算は、アプリケーション内の複数のページにわたって同じポイントで実行されます。例外は、「新しいインスタンス開始時」という計算ポイントを持つ計算です。これらのタイプの計算は、ユーザーのセッション内で情報を1回のみ取得する必要がある場合に便利です。たとえば、ログインしているユーザーに依存しないアプリケーション・アイテムは、計算ポイント「新しいインスタンス開始時」を使用して初期化できます。また、ユーザーに依存する情報を検索するために、「認証後」を使用することもできます。

認証スキーム(「新しいインスタンス開始時」および「ログイン後」)で同じCookie名を設定することによって、アプリケーションが同じセッションを共有するように構成すると、アプリケーション・プロセスは、Oracle Application Expressがアプリケーションのリクエストを最初に処理するとき(「新しいインスタンス開始時」)や、アプリケーションに対して認証されたユーザーのリクエストを処理するとき(「認証後」)、常に実行されます。

15.6.3 アプリケーションの計算の作成

アプリケーションの計算を作成するには、次のステップを実行します。

1. 共有コンポーネント・ページにナビゲートします。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。

b. アプリケーションを選択します。

c. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

共有コンポーネント・ページが表示されます。

2. 「ロジック」で、「アプリケーションの計算」を選択します。

3. 「作成」をクリックします。

4. 次の属性を編集します。

a. アイテム、順序 - このコンポーネントの順序を指定します。これによって評価の順序が決まります。

b. アイテム、計算アイテム - この計算によって影響を受けるアイテムを選択します。

c. 頻度、計算ポイント - この計算を実行するプロセス・ポイントを選択します。「送信後」を選択すると、ページが表示され送信された後でのみ計算が実行されます。

d. 計算、計算タイプ - この計算の実行方法を選択します。

e. 計算、計算 - 計算タイプに対応する計算ロジックを入力します。例は、フィールドレベル・ヘルプを参照してください。

f. 計算、計算エラー・メッセージ - 計算が失敗した場合に表示されるエラー・メッセージを入力します。

g. 認可、認可スキーム (オプション) - この計算を実行するためにTrueと評価される必要がある認可スキームを選択します。

h. 条件、条件タイプ (オプション) - この計算を実行するために満たされる必要がある条件タイプを選択します。

i. ビルド・オプション (オプション) - このコンポーネント用のビルド・オプションを選択します。

5. 「計算の作成」をクリックします。

関連項目:

ビルド・オプションを使用した構成の制御

15.6.4 アプリケーション計算履歴レポートへのアクセス

アプリケーションの計算を作成すると、アプリケーション計算履歴レポートを表示できます。アプリケーション計算履歴レポートには、最近変更されたアプリケーション計算の履歴が日付ごとに表示されます。

アプリケーション計算履歴レポートにアクセスするには、次のステップを実行します。

1. 共有コンポーネント・ページにナビゲートします。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。

b. アプリケーションを選択します。

c. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

共有コンポーネント・ページが表示されます。

2. 「ロジック」で、「アプリケーションの計算」を選択します。

3. ページ上部の「履歴」を選択します。

4. ページ上部の検索バーを使用してページの概観をカスタマイズできます。使用可能なコントロールは次のとおりです。

- 検索列の選択: 虫めがねに似ています。このアイコンをクリックして、検索を絞り込みます。すべての列を検索するには、「すべての列」を選択します。

- テキスト領域: 大/小文字を区別しない検索基準(ワイルドカード文字を含む)を入力し、「実行」をクリックします。

- 「実行」ボタン: 検索を実行したり、フィルタを適用します。

- アクション・メニュー: このアクション・メニューを使用して、レポート・ビューをカスタマイズします。

関連項目:

「アクション」メニューについて

15.7 属性ディクショナリの使用

この項では、属性ディクショナリの使用方法について説明します。

トピック:

- 属性ディクショナリについて

- 「属性ディクショナリの管理」へのアクセス

15.7.1 属性ディクショナリについて

属性ディクショナリには、フォームとレポートの作成に使用する列についての属性のセットが含まれます。定義は列名によって照合され、シノニムを使用することで特定の定義を複数の列間で共有できます。

「属性ディクショナリの管理」ページを使用して、現在のページの値を属性ディクショナリ内の値で更新するか、現在のページの値で属性ディクショナリを更新することができます。

15.7.2 「属性ディクショナリの管理」へのアクセス

属性ディクショナリの管理ページにアクセスするには、次のステップを実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

アプリケーション・ビルダーのホームページが表示されます。

2. アプリケーションを選択します。

3. 「ユーティリティ」をクリックします。

4. 「ユーティリティ」をクリックして、「属性ディクショナリ」をクリックします。

このページは、「ページ・アイテム」と「レポート列」の2つのセクションに分かれています。

ページ・アイテムおよびレポート列の定義を使用して、属性ディクショナリを更新します。また、属性ディクショナリを使用してページ・アイテムおよびレポート列を更新することもできます。

(非表示のリージョンおよびボタン・アイテム内の)非表示オブジェクトは、更新に使用されないため、アイテムおよびレポート列の候補数に入りません。

5. 現在のページを更新するか、現在の属性ディクショナリを更新するには、適切なページ・リンクを選択します。

「属性ディクショナリ」が表示されます。

少なくとも1つの属性について異なる値を持つアイテムおよびレポート列のみが表示されます。挿入または更新するオブジェクトおよび含める属性を選択します。非表示オブジェクト、非表示リージョン内のオブジェクトおよびボタン・アイテムは含まれないため、使用できるアイテムおよびレポート列は合計よりも少ないことがあります。

ヒント:

ページ・デザイナとコンポーネント・ビューのどちらでも、「ユーティリティ」をクリックして「属性ディクショナリ」を選択することによって、属性ディクショナリにアクセスできます。

16 共有コンポーネントの管理

共有コンポーネントは、アプリケーション内のすべてのページに表示または適用できます。開発者は、共有コンポーネント・ページのツールやウィザードを、アプリケーション・レベルまたは特定のページで使用できます。

トピック:

- 共有コンポーネントでの作業

- コンポーネント設定の管理

- 静的アプリケーション・ファイルの管理

- 静的ワークスペース・ファイルの管理

- アプリケーション・レベル・アイテムの管理

- アプリケーション・レベルでのLOVの作成

- リストの作成

- ショートカットの使用

- レポート出力の管理

関連項目:

- 「アプリケーション・ビルダーの概念」

- データベース・アプリケーションの作成

- 「ページ・レイアウトの制御」

- 「ナビゲーションの追加」

16.1 共有コンポーネントでの作業

共有コンポーネントは、アプリケーション内のすべてのページに表示または適用される共通の要素です。共有コンポーネント・ページのツールやウィザードを、アプリケーション・レベルまたは特定のページで使用できます。

- 共有コンポーネントを使用する利点について

- 共有コンポーネント・ページへのアクセス

- 「共有コンポーネント」アイコンについて

- 共有コンポーネント・ページ

トピック:

- 共有コンポーネントを使用する利点について

- 共有コンポーネント・ページへのアクセス

- 「共有コンポーネント」アイコンについて

- 共有コンポーネント・ページ

関連項目:

アプリケーションおよびアプリケーション・コンポーネントのエクスポート

16.1.1 共有コンポーネントを使用する利点について

タブ、リスト、ブレッドクラムおよびナビゲーション・バー・エントリは共有コンポーネントです。共有コンポーネントは、アプリケーション内のすべてのページに表示または適用される共通の要素です。共有コンポーネント・ページのツールやウィザードを、アプリケーション・レベルまたは特定のページで使用できます。共有コンポーネントの大きな利点は、作成した共有コンポーネントをデータベース・アプリケーション内の任意のページに追加できることです。

関連項目:

共有コンポーネントでの作業

16.1.2 共有コンポーネント・ページへのアクセス

「共有コンポーネント」ページにアクセスするには、次のステップを実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

共有コンポーネント・ページが表示されます。

4. 共有コンポーネントを作成するには、該当するリンクを選択します。

16.1.3 「共有コンポーネント」アイコンについて

アプリケーションを選択した後、ページ上部の「共有コンポーネント」アイコンをクリックすることで、共有コンポーネント・ページにアクセスできます。「共有コンポーネント」アイコンは、丸と四角形の上に三角形がある形です。このアイコンは、アプリケーションのホームページ、ページ・デザイナ、コンポーネント・ビュー、サポートするオブジェクト、ユーティリティなど、ほとんどのアプリケーション・ビルダー・ページの上部に表示されます。

16.1.4 共有コンポーネント・ページ

共有コンポーネントは、アプリケーション内のすべてのページに表示または適用される共通の要素です。共有コンポーネント・ページのツールやウィザードを、アプリケーション・レベルまたは特定のページで使用します。「共有コンポーネント」は、次のリージョンに分かれています。

トピック:

- アプリケーション・ロジック

- セキュリティ

- その他のコンポーネント

- ナビゲーション

- ユーザー・インタフェース

- ファイル

- データ参照

- レポート

- グローバリゼーション

- 「タスク」リージョン

関連項目:

共有コンポーネント・ページへのアクセス

16.1.4.1 アプリケーション・ロジック

表16-1に、共有コンポーネント・ページの「アプリケーション・ロジック」のリンクを示します。

表16-1 共有コンポーネント・ページの「アプリケーション・ロジック」リンク

リンク

説明

アプリケーション定義属性

アプリケーション定義の編集ページにリンクします。このページを使用して、アプリケーションの属性を編集します。属性は、「定義」、「セキュリティ」、「グローバリゼーション」および「ユーザー・インタフェース」の4つのカテゴリにグループ化されます。

関連項目: アプリケーション属性の管理

アプリケーション・アイテム

アプリケーション・レベル・アイテムは表示されませんが、アプリケーションのグローバル変数として使用されます。一般に、アプリケーションまたはページの計算を使用して、ページ・レベル・アイテムの値を設定します。

関連項目: アプリケーション・レベル・アイテムの管理

アプリケーション・プロセス

アプリケーション・プロセスを使用すると、次のようにPL/SQLロジックを実行できます。

- アプリケーションの各ページの特定のポイントで

- プロセスの実行条件で定義されているとおりに

- 新しいセッションの作成時

「オンデマンド」プロセスは、ページ・レベルの「オンデマンド」プロセスからコールされた場合か、ブラウザからAJAXを使用してコールされた場合にのみ実行されます。

関連項目: アプリケーション・プロセスの理解

アプリケーションの計算

アプリケーション・レベルの計算を使用すると、表示される各ページに対して、または新規アプリケーション・セッションの作成時に、アプリケーション・レベル・アイテムとページ・レベル・アイテムに値を割り当てることができます。また、アプリケーション・レベルの計算を作成し、条件付きで複数のページで実行することもできます。

関連項目: アプリケーションの計算の理解

16.1.4.2 セキュリティ

表16-2に、共有コンポーネント・ページの「セキュリティ」のリンクを示します。

表16-2 共有コンポーネント・ページの「セキュリティ」リンク

リンク

説明

セキュリティ属性

セキュリティ属性の編集ページを使用して、アプリケーション内のすべてのページの一般的なセキュリティ属性を構成します。

関連項目: セキュリティ属性の構成

認証スキーム

認証は、ユーザーがアプリケーションにアクセスする前に、そのユーザーのアイデンティティを証明するプロセスです。認証では、ユーザー名とパスワードの入力や、ユーザーのアイデンティティまたは保護キーの使用が必要となる場合があります。

関連項目: 認証によるユーザー・アイデンティティの証明

認可スキーム

認可は、事前定義されたユーザー権限に基づいて、特定のコントロールやコンポーネントに対するユーザーのアクセスを制限するものです。

関連項目: 認可を介したセキュリティの提供

セッション・ステート保護

セッション・ステート保護は、ハッカーがアプリケーション内のURLを改ざんするのを防ぐための組込み機能です。URL改ざんにより、プログラム・ロジック、セッション・ステートの内容および情報プライバシが悪影響を受ける可能性があります。

関連項目: セッション・ステート保護の理解

ビルド・オプション

ビルド・オプションを使用すると、アプリケーション内の特定の機能を条件付きで表示または処理できます。ビルド・オプションを使用して、アプリケーションの各デプロイについて、アプリケーションのどの機能をオンにするかを制御できます。

関連項目: ビルド・オプションを使用した構成の制御

16.1.4.3 他のコンポーネント

表16-3に、共有コンポーネント・ページの「セキュリティ」のリンクを示します。

表16-3 共有コンポーネント・ページの「他のコンポーネント」リンク

リンク

説明

LOV

LOVは、ポップアップLOV、選択リスト、チェック・ボックスまたはラジオ・グループを表示するために使用される静的または動的な値のセットです。

関連項目: アプリケーション・レベルでのLOVの作成

プラグイン

アプリケーション・ビルダーには、組込みのアイテム・タイプ、リージョン・タイプ、動的アクションおよびプロセスが含まれています。新しい宣言的なタイプをアプリケーションに追加するためにプラグインを使用します。

関連項目: プラグインの実装

コンポーネント設定

「コンポーネント設定」を使用して、組込みのOracle Application Expressコンポーネントおよびインストール済プラグインのアプリケーション・レベル値を設定します。

関連項目: コンポーネント設定の管理

ショートカット

ショートカットを使用すると、HTMLまたはPL/SQLファンクションを繰り返しコーディングする必要がなくなります。ショートカットを作成して、ボタン、HTMLテキスト、PL/SQLプロシージャ、HTMLなどのページ・コントロールを定義できます。定義したショートカットは、アプリケーション内の様々な位置から参照できるように中央リポジトリに格納されます。

関連項目: ショートカットの使用

16.1.4.4 ナビゲーション

表16-4に、共有コンポーネント・ページの「ナビゲーション」のリンクを示します。

表16-4 共有コンポーネント・ページの「ナビゲーション」リンク

リンク

説明

リスト

リストは、リンクの共有コレクションです。リストの外観は、リスト・テンプレートで制御します。各リスト要素には、表示のタイミングを制御できる表示条件があります。

関連項目: リストの作成

ナビゲーション・メニュー

ナビゲーション・メニューは、アプリケーション内のページへのナビゲートを可能にするリスト・リンクです。ナビゲーション・メニューは、ユニバーサル・テーマ - 42を使用するアプリケーションでのみサポートされます。

関連項目: ナビゲーション・メニューについて

タブ

タブは、アプリケーションのページ間でのナビゲートに有効な方法です。標準タブまたは親タブという2つのタイプのタブを作成できます。標準タブ・セットは、特定のページおよびページ番号に関連付けられます。親タブ・セットは、標準タブのグループを保持するコンテナとして機能します。

関連項目: タブの作成

ブレッドクラム

ブレッドクラムを使用すると、階層的にナビゲートできます。ブレッドクラムは、テンプレートを使用して表示されるリンクの階層的なリストです。ブレッドクラムは、リンクのリストまたはブレッドクラム・パスとして表示できます。

関連項目: ブレッドクラムの作成

ナビゲーション・バー・エントリ

ナビゲーション・バー・エントリは、アプリケーションのページ間を移動する単純なナビゲーション・パスを提供します。ナビゲーション・バーの位置は、関連付けられたページ・テンプレートによって異なります。ナビゲーション・バー・エントリは、イメージまたはテキストからのリンクとして表示できます。ナビゲーション・バー・エントリは、イメージ、説明付きのイメージまたはテキストです。

関連項目: ナビゲーション・バー・エントリの作成

16.1.4.5 ユーザー・インタフェース

表16-5に、共有コンポーネント・ページの「ユーザー・インタフェース」のリンクを示します。

表16-5 共有コンポーネント・ページの「ユーザー・インタフェース」リンク

リンク

説明

ユーザー・インタフェース属性

「ユーザー・インタフェース」ページを使用して、アプリケーションのユーザー・インタフェース・オプションを指定します。

関連項目: アプリケーションのユーザー・インタフェースの管理

テーマ

テーマは、アプリケーションのユーザー・インタフェースを定義するテンプレートの名前付きコレクションです。

関連項目: テーマの使用

テンプレート

テンプレートは、アプリケーション内の特定の構成要素(ページ、リージョン、アイテム、メニューなど)のルック・アンド・フィールを制御します。

関連項目: カスタム・テーマの作成

16.1.4.6 ファイル

表16-6に、共有コンポーネント・ページの「ユーザー・インタフェース」のリンクを示します。

表16-6 共有コンポーネント・ページの「ファイル」リンク

リンク

説明

静的アプリケーション・ファイル

このリンクを使用して、スタイルシート(CSS)、イメージ、JavaScriptファイルなどのカレント・アプリケーションに関連する静的ファイルのアップロード、編集および削除を行います。

関連項目: 静的アプリケーション・ファイルの管理

静的ワークスペース・ファイル

このリンクを使用して、スタイルシート(CSS)、イメージ、JavaScriptファイルなどのカレント・アプリケーションに関連する静的ファイルのアップロード、編集および削除を行います。

関連項目: 静的ワークスペース・ファイルの管理

16.1.4.7 データ参照

表16-7に、共有コンポーネント・ページの「ユーザー・インタフェース」のリンクを示します。

表16-7 共有コンポーネント・ページの「データ参照」リンク

リンク

説明

データ・ロード定義

データ・ロード表を使用して、データ・ロードのページ作成ウィザードで使用する表を定義します。データ・ロード表は、データをアップロードするデータ・ロード・プロセスで使用するために選択したスキーマに存在する既存の表です。

関連項目: プラグイン・ページからのプラグインのインポート

Webサービス参照

アプリケーション・ビルダーのWebサービス参照は通常、Simple Object Access Protocol (SOAP)またはRepresentational State Transfer (REST)アーキテクチャに基づいています。Webサービスへの参照を作成してアプリケーションに組み込み、フォームによって送信されたデータを処理したり、フォームまたはレポートに出力をレンダリングできます。

関連項目: Webサービスの実装

16.1.4.8 レポート

表16-8に、共有コンポーネント・ページの「ユーザー・インタフェース」のリンクを示します。

表16-8 共有コンポーネント・ページの「データ参照」リンク

リンク

説明

レポート問合せ

「レポート問合せ」リンクを使用すると、カレント・アプリケーション内のストアド・クエリーのレポートを表示できます。

関連項目: レポート問合せの定義によるレポート・リージョンの印刷

レポート・レイアウト

レポートまたは共通問合せとともに「レポート・レイアウト」を使用すると、Adobe Portable Document Format(PDF)、Microsoft Word Rich Text Format(RTF)、Microsoft Excel(XLS)形式などの印刷用形式でデータをレンダリングできます。

関連項目: レポート・レイアウトを使用したレポート・リージョンまたはレポート問合せのフォーマット

16.1.4.9 グローバリゼーション

表16-9に、共有コンポーネント・ページの「ユーザー・インタフェース」のリンクを示します。

表16-9 共有コンポーネント・ページの「グローバリゼーション」リンク

リンク

説明

グローバリゼーション属性

異なる言語で同時に実行可能なアプリケーションを開発できます。このリンクをクリックして、「アプリケーションのプライマリ言語」、「アプリケーション言語の導出元」属性などのグローバリゼーション・オプションを指定します。

関連項目: グローバリゼーション属性の構成およびアプリケーション翻訳およびグローバリゼーション・サポートの理解

テキスト・メッセージ

テキスト・メッセージは、ユーザーが作成するPL/SQLコードからコールできる名前付きのテキスト文字列です。このPL/SQLは、ページ・プロセスおよびページ・リージョン、またはパッケージおよびプロシージャで無名ブロックとして使用できます。

関連項目: メッセージの翻訳

アプリケーションの翻訳

Oracle Application Expressでは、異なる言語で同時に実行可能なアプリケーションを開発できます。1つのOracle DatabaseおよびOracle Application Expressインスタンスは、複数言語でアプリケーションをサポートできます。アプリケーションの翻訳には複数のステップが必要です。

関連項目: アプリケーション翻訳およびグローバリゼーション・サポートの理解および翻訳プロセスの理解

16.1.4.10 「タスク」リージョン

共有コンポーネント・ページの右側にある「タスク」リストには、次のリンクが含まれます。

- アプリケーション・コンポーネントのエクスポート - コンポーネントのエクスポート・ページにリンクします。このページは、バックアップまたは別のインスタンスへのコンポーネントのロードを目的として、エクスポートされるアプリケーションのコンポーネントを識別する際に使用します。

- サポートするオブジェクトの管理 - サポートするオブジェクト・ページにリンクします。このページは、パッケージ・アプリケーションを作成する際に使用します。

- アプリケーション・コメントの編集 - アプリケーション・コメント・ページにリンクします。このページを使用して、現在選択しているアプリケーションに固有のコメントを入力します。

- 開発者コメントのレビュー - 開発者のコメント・ページにリンクします。

関連項目:

- 「アプリケーション・コンポーネントのエクスポート」

- カスタム・パッケージ・アプリケーションの作成方法

- データベース・アプリケーション・コメントの追加

- 「開発者コメントの追加」

16.2 コンポーネント設定の管理

「コンポーネント設定」を使用して、組込みのApplication Expressコンポーネントおよびインストール済プラグインのアプリケーション・レベル値を設定します。

ヒント:

環境内の「コンポーネント設定」は、現在選択されているアプリケーションに基づいて異なります。

トピック:

- 「コンポーネント設定」の構成

- Googleカレンダとの統合

- カラー・ピッカーの表示の構成

- 対話モード・レポートの「アクション」メニュー構造の構成

- リージョンへのスライダの動的追加

- スイッチのデフォルト値の構成

- コンポーネント設定の履歴レポートの表示

16.2.1 「コンポーネント設定」の構成

開発者は、「コンポーネント設定」を構成して、組込みのApplication Expressコンポーネントおよびインストール済プラグインのアプリケーション・レベル値を設定できます。
「コンポーネント設定」を構成するには、次のステップを実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

共有コンポーネント・ページが表示されます。

4. 「他のコンポーネント」で、「コンポーネント設定」をクリックします。

5. コンポーネント名をクリックします。

6. 「コンポーネント設定」で、該当する設定を構成し、「変更の適用」をクリックします。

ヒント:

特定の設定の詳細は、アイテムのヘルプを参照してください。

16.2.2 Googleカレンダとの統合

開発者は、「コンポーネント設定」の「カレンダ」を構成して、アプリケーション内のカレンダとGoogleカレンダ・データとの統合を有効化できます。
「コンポーネント設定」の「カレンダ」を構成するには、次のステップを実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

共有コンポーネント・ページが表示されます。

4. 「他のコンポーネント」で、「コンポーネント設定」をクリックします。

5. コンポーネント名「カレンダ」をクリックします。

6. 「コンポーネント設定」ダイアログで、次のようにします。

a. GoogleカレンダAPIキー: このアプリケーション内のカレンダをGoogleカレンダ・データと統合できるようにするために、GoogleカレンダAPIキーを入力します。

b. 「変更の適用」をクリックします。

16.2.3 カラー・ピッカーの表示の構成

開発者は、「コンポーネント設定」の「カラー・ピッカー」を構成して、カラー・ピッカーの表示スタイルを制御できます。
「コンポーネント設定」の「カラー・ピッカー」を構成するには、次のステップを実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

共有コンポーネント・ページが表示されます。

4. 「他のコンポーネント」で、「コンポーネント設定」をクリックします。

5. コンポーネント名「カラー・ピッカー」をクリックします。

6. 「コンポーネント設定」ダイアログで、次のようにします。

a. 表示スタイル: 次のオプションがあります。

- 最新: テキスト・フィールド内の小さい円としてカラー・プレビューをレンダリングします。

- プレビューなし: 選択したカラーのプレビューをレンダリングしません。

b. 「変更の適用」をクリックします。

16.2.4 対話モード・レポートの「アクション」メニュー構造の構成

対話モード・レポートの「アクション」メニューの構造は、対話グリッドと一貫するように変更されました。開発者は、「コンポーネント設定」の「対話モード・レポート」を構成して、新しい構造を使用することも、以前のリリースからのレガシー構造を保持することもできます。
「コンポーネント設定」の「対話モード・レポート」を構成するには、次のステップを実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

共有コンポーネント・ページが表示されます。

4. 「他のコンポーネント」で、「コンポーネント設定」をクリックします。

5. コンポーネント名「対話モード・レポート」をクリックします。

6. 「コンポーネント設定」ダイアログで、次のようにします。

a. 「アクション」メニュー構造: 対話モード・レポートでの「アクション」メニューの表示方法を指定します。オプションは次のとおりです。

- 対話グリッド: 対話モード・レポートの「アクション」メニューを対話グリッドと一致させる場合は「対話グリッド」を選択します。

- レガシー: 対話モード・レポートの「アクション」メニューでレガシー構造を使用する場合は「レガシー」を選択します。

b. 「変更の適用」をクリックします。

16.2.5 リージョンへのスライダの動的追加

開発者は、表示されるリージョン名がリージョンの幅を超える場合に、リージョンにスライダを動的に追加できます。
「コンポーネント設定」の「リージョン表示セレクタ」を構成するには、次のステップを実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

共有コンポーネント・ページが表示されます。

4. 「他のコンポーネント」で、「コンポーネント設定」をクリックします。

5. コンポーネント名「リージョン表示セレクタ」をクリックします。

6. 「コンポーネント設定」ダイアログで、次のようにします。

a. スライダを含める: 「はい」を選択すると、表示されるリージョン名がリージョンの幅を超える場合に、リージョンにスライダを動的に追加します。

b. 「変更の適用」をクリックします。

16.2.6 スイッチのデフォルト値の構成

切替えアイテム・タイプは、フリップ・トグル・スイッチとして表示します。開発者は、「コンポーネント設定」の「切替え」を構成して、デフォルトの切替え動作を構成できます。
「コンポーネント設定」の「切替え」を構成するには、次のステップを実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

共有コンポーネント・ページが表示されます。

4. 「他のコンポーネント」で、「切替え」をクリックします。

5. 「コンポーネント設定」ダイアログで、次のようにします。

a. オン値: エンド・ユーザーが「オン」オプションを選択した場合にページ・アイテムに格納される値を入力します。

b. オン・ラベル: 「オン」オプションとして表示されるテキストを入力します。テキストを入力しない場合は、システムのデフォルト・ラベルが使用されます。

c. オフ値: ユーザーが「オフ」オプションを選択した場合にページ・アイテムに格納される値を入力します。

注意:

この値は、ページ・アイテムに移入される値が「オン値」と「オフ値」のいずれにも一致しない場合に使用されます。

d. オフ・ラベル: 「オフ」オプションとして表示されるテキストを入力します。テキストを入力しない場合は、システムのデフォルト・ラベルが使用されます。

e. 「変更の適用」をクリックします。

16.2.7 コンポーネント設定の履歴レポートの表示

Oracle Application Expressコンポーネントおよび「コンポーネント設定履歴」ページのインストール済プラグインへ行った変更のレポートを表示できます。

「コンポーネント設定履歴」レポートを表示するには、次の手順を実行します。

1. 共有コンポーネント・ページにナビゲートします。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。

b. アプリケーションを選択します。

c. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

共有コンポーネント・ページが表示されます。

2. 「他のコンポーネント」で、「コンポーネント設定」をクリックします。

3. 「履歴」タブをクリックします。

「履歴」ページは、対話モード・レポートとして表示されます。レポートをカスタマイズするには、ページ上部にある検索バーを使用します。

16.3 静的アプリケーション・ファイルの管理

この項では、静的アプリケーション・ファイル(イメージ、CSSファイルおよび個別に管理する必要があるその他のファイルを含む)をアップロード、表示、ダウンロードおよび削除する方法について説明します。

トピック:

- 静的アプリケーション・ファイルの場所の指定

- 静的アプリケーション・ファイルのアップロード

- 「静的アプリケーション・ファイル」レポートの表示

- 静的アプリケーション・ファイルの参照

- 静的アプリケーション・ファイルのダウンロード

- 静的アプリケーション・ファイルの削除

関連項目:

- 「静的ワークスペース・ファイルの管理」

- 「イメージの管理について」

16.3.1 静的アプリケーション・ファイルの場所の指定

アプリケーション・ファイルは、アプリケーション定義とともにOracleデータベースに格納されます。パフォーマンス上の理由から、アプリケーション・ファイルをWebサーバーに格納することもできます。

アプリケーションの「静的ファイルの接頭辞」属性を確認するには、次のステップを実行します。

1. 共有コンポーネント・ページにナビゲートします。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。

b. アプリケーションを選択します。

c. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

共有コンポーネント・ページが表示されます。

2. 「ユーザー・インタフェース」で「ユーザー・インタフェース属性」を選択します。

3. 「ユーザー・インタフェース」タブをクリックします。

4. 「静的ファイルの接頭辞」で、Webサーバーが静的アプリケーション・ファイルを指すために使用する仮想パスを入力します。データベースにアプリケーション定義とともに格納されたファイルを参照するには、この属性を空白のままにします。パフォーマンス上の理由から、アプリケーション・ファイルをWebサーバーに格納し、有効なURLを使用して参照することもできます。例:

/myFiles/
http://contentDeveliveryNetwork.com/myFiles/

5. 「変更の適用」をクリックします。

16.3.2 静的アプリケーション・ファイルのアップロード

静的アプリケーション・ファイルをアップロードするには、次のステップを実行します。

1. 共有コンポーネント・ページにナビゲートします。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。

b. アプリケーションを選択します。

c. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

共有コンポーネント・ページが表示されます。

2. 「ファイル」で、「静的アプリケーション・ファイル」を選択します。

静的アプリケーション・ファイル・ページが表示されます。

3. ファイルをアップロードするには、「ファイルのアップロード」をクリックします。

4. 「アップロード」で、次のステップを実行します。

a. ディレクトリ - ファイルの格納先ディレクトリの名前を入力します。ディレクトリを指定しない場合、ファイルはルート・ディレクトリに格納されます。

b. ファイル - アプリケーションに追加するファイルの場所を入力します。

c. ファイルの文字セット - アップロードするファイルの文字セット・エンコーディングを指定します。この属性は、テキスト・ファイルにのみ適用されます。

d. ファイルの解凍 - 「はい」の場合、アップロードしたZipファイルは自動的に解凍され、指定したディレクトリに格納されます。実際のZipファイルが格納されるわけではないことに注意してください。アップロードしたファイルがZipファイルでない場合、この属性は無視されます。

5. 「アップロード」または「アップロードと別のアップロード」をクリックします。

16.3.3 「静的アプリケーション・ファイル」レポートの表示

アップロードした静的アプリケーション・ファイルの詳細を表示するには、次のステップを実行します。

1. 共有コンポーネント・ページにナビゲートします。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。

b. アプリケーションを選択します。

c. アプリケーションのホームページで、「共有コンポーネント」をクリックします。
共有コンポーネント・ページが表示されます。

2. 「ファイル」で、「静的アプリケーション・ファイル」を選択します。
静的アプリケーション・ファイル・ページが表示されます。

3. まだ選択していない場合は、「レポートの表示」アイコンをクリックします。
レポートが表示されます。レポートをカスタマイズするには、ページ上部にある検索バーを使用します。詳細は、検索バーについてを参照してください。

「静的アプリケーション・ファイル」レポートに、ファイル名、MIMEタイプ、ファイル・サイズ、ダウンロード・リンクおよび置換文字列構文が表示されます。

4. 追加の詳細を表示するには、「編集」アイコンをクリックします。ファイルがイメージの場合は、イメージが表示されます。

5. ファイルを削除するには、「削除」をクリックします。

6. 終了するには、「取消」をクリックします。

16.3.4 静的アプリケーション・ファイルの参照

静的アプリケーション・ファイルは、現在選択されているアプリケーションでのみ使用可能です。アプリケーションの静的アプリケーション・ファイルは、#APP_IMAGES#置換文字列を使用して参照できます。アップロードしたイメージのサンプル構文を表示するには、「静的アプリケーション・ファイル」レポートの「参照」列を参照します。

関連項目:

- 「「静的アプリケーション・ファイル」レポートの表示」

- 「置換文字列の使用について」

- 「APP_IMAGES」

- アプリケーション・ロゴの定義

16.3.5 静的アプリケーション・ファイルのダウンロード

この項では、静的アプリケーション・ファイルをダウンロードする方法について説明します。

トピック:

- 静的アプリケーション・ファイルのダウンロード

- すべての静的アプリケーション・ファイルのZipでのダウンロード

16.3.5.1 静的アプリケーション・ファイルのダウンロード

アップロードした静的アプリケーション・ファイルをダウンロードするには、次のステップを実行します。

1. 共有コンポーネント・ページにナビゲートします。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします

b. アプリケーションを選択します。

c. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

共有コンポーネント・ページが表示されます。

2. 「ファイル」で、「静的アプリケーション・ファイル」を選択します。

静的アプリケーション・ファイル・ページが表示されます。

3. まだ選択していない場合は、「レポートの表示」アイコンをクリックします。

レポートが表示されます。

4. ダウンロードするファイルを探し、「ダウンロード」リンクをクリックします。

16.3.5.2 すべての静的アプリケーション・ファイルのZipでのダウンロード

すべての静的アプリケーション・ファイルをZipでダウンロードするには、次のステップを実行します。

1. 共有コンポーネント・ページにナビゲートします。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。

b. アプリケーションを選択します。

c. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

共有コンポーネント・ページが表示されます。

2. 「ファイル」で、「静的アプリケーション・ファイル」を選択します。

静的アプリケーション・ファイル・ページが表示されます。

3. 「Zipとしてダウンロード」をクリックします。

16.3.6 静的アプリケーション・ファイルの削除

この項では、アップロードした静的アプリケーション・ファイルを削除する方法について説明します。

トピック:

- 静的アプリケーション・ファイルの削除

- すべての静的アプリケーション・ファイルの削除

16.3.6.1 静的アプリケーション・ファイルの削除

アップロードした静的アプリケーション・ファイルを削除するには、次のステップを実行します。

1. 共有コンポーネント・ページにナビゲートします。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。

b. アプリケーションを選択します。

c. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

共有コンポーネント・ページが表示されます。

2. 「ファイル」で、「静的アプリケーション・ファイル」を選択します。

静的アプリケーション・ファイル・ページが表示されます。

3. まだ選択していない場合は、「レポートの表示」アイコンをクリックします。

レポートが表示されます。レポートをカスタマイズするには、ページ上部にある検索バーを使用します。

4. 削除するファイルを選択します。

5. 編集ページで、「削除」をクリックします。

関連項目:

「検索バーについて」

16.3.6.2 すべての静的アプリケーション・ファイルの削除

アップロードしたすべての静的アプリケーション・ファイルを削除するには、次のステップを実行します。

1. 共有コンポーネント・ページにナビゲートします。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。

b. アプリケーションを選択します。

c. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

共有コンポーネント・ページが表示されます。

2. 「ファイル」で、「静的アプリケーション・ファイル」を選択します。

静的アプリケーション・ファイル・ページが表示されます。

3. 「すべてのファイルの削除」をクリックします。

16.4 静的ワークスペース・ファイルの管理

この項では、静的ワークスペース・ファイル(イメージ、CSSファイルおよび個別に管理する必要があるその他のファイルを含む)をアップロード、表示、ダウンロードおよび削除する方法について説明します。

トピック:

- 静的ワークスペース・ファイルのアップロード

- 「静的ワークスペース・ファイル」レポートの表示

- 静的ワークスペース・ファイルの参照について

- 静的ワークスペース・ファイルのダウンロード

- 静的ワークスペース・ファイルの削除

関連項目:

- 「静的アプリケーション・ファイルの管理」

- 「イメージの管理について」

16.4.1 静的ワークスペース・ファイルのアップロード

静的ワークスペース・ファイルをアップロードするには、次のステップを実行します。

1. 共有コンポーネント・ページにナビゲートします。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。

b. アプリケーションを選択します。

c. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

共有コンポーネント・ページが表示されます。

2. 「ファイル」で、「静的ワークスペース・ファイル」を選択します。

静的ワークスペース・ファイル・ページが表示されます。

3. ファイルをアップロードするには、「ファイルのアップロード」をクリックします。

4. 「アップロード」で、次のステップを実行します。

a. ディレクトリ - ファイルの格納先ディレクトリの名前を入力します。ディレクトリを指定しない場合、ファイルはルート・ディレクトリに格納されます。

b. ファイル - アプリケーションに追加するファイルの場所を入力します。

c. ファイルの文字セット - アップロードするファイルの文字セット・エンコーディングを指定します。この属性は、テキスト・ファイルにのみ適用されます。

d. ファイルの解凍 - 「はい」の場合、アップロードしたZipファイルは自動的に解凍され、指定したディレクトリに格納されます。実際のZipファイルが格納されるわけではないことに注意してください。アップロードしたファイルがZipファイルでない場合、この属性は無視されます

5. 「アップロード」または「アップロードと別のアップロード」をクリックします。

16.4.2 「静的ワークスペース・ファイル」レポートの表示

「静的ワークスペース・ファイル」レポートを表示するには、次のステップを実行します。

1. 共有コンポーネント・ページにナビゲートします。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。

b. アプリケーションを選択します。

c. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

共有コンポーネント・ページが表示されます。

2. 「ファイル」で、「静的ワークスペース・ファイル」を選択します。

静的ワークスペース・ファイル・ページが表示されます。レポートをカスタマイズするには、ページ上部にある検索バーを使用します。

3. まだ選択していない場合は、「レポートの表示」アイコンをクリックします。

「静的アプリケーション・ファイル」レポートに、ファイル名、MIMEタイプ、ファイル・サイズ、ダウンロード・リンクおよび置換文字列構文が表示されます。

4. 追加の詳細情報を表示するには、ファイルを選択します。ファイルがイメージの場合は、イメージが表示されます。

5. ファイルを削除するには、「削除」をクリックします。

6. 終了するには、「取消」をクリックします。

関連項目:

「検索バーについて」

16.4.3 静的ワークスペース・ファイルの参照について

現在のワークスペース内のすべてのアプリケーションの静的ワークスペース・ファイルを参照できます。アプリケーションの静的ワークスペース・ファイルは、#WORKSPACE_IMAGES#置換文字列を使用して参照できます。アップロードしたイメージのサンプル構文を表示するには、「静的ワークスペース・ファイル」レポートの「参照」列を参照します。

関連項目:

- 「「静的ワークスペース・ファイル」レポートの表示」

- 「組込み置換文字列の使用」

- 「WORKSPACE_IMAGES」

- アプリケーション・ロゴの定義

16.4.4 静的ワークスペース・ファイルのダウンロード

この項では、静的ワークスペース・ファイルをダウンロードする方法について説明します。

トピック:

- 静的ワークスペース・ファイルのダウンロード

- すべての静的ワークスペース・ファイルのZipでのダウンロード

16.4.4.1 静的ワークスペース・ファイルのダウンロード

アップロードした静的ワークスペース・ファイルをダウンロードするには、次のステップを実行します。

1. 共有コンポーネント・ページにナビゲートします。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。

b. アプリケーションを選択します。

c. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

共有コンポーネント・ページが表示されます。

2. 「ファイル」で、「静的ワークスペース・ファイル」を選択します。

静的ワークスペース・ファイル・ページが表示されます。

3. まだ選択していない場合は、「レポートの表示」アイコンをクリックします。

レポートが表示されます。

4. ダウンロードするファイルを探し、「ダウンロード」リンクをクリックします。

16.4.4.2 すべての静的ワークスペース・ファイルのZipでのダウンロード

すべての静的ワークスペース・ファイルをZipでダウンロードするには、次のステップを実行します。

1. 共有コンポーネント・ページにナビゲートします。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。

b. アプリケーションを選択します。

c. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

共有コンポーネント・ページが表示されます。

2. 「ファイル」で、「静的ワークスペース・ファイル」を選択します。

静的アプリケーション・ファイル・ページが表示されます。

3. 「Zipとしてダウンロード」をクリックします。

16.4.5 静的ワークスペース・ファイルの削除

この項では、アップロードした静的ワークスペース・ファイルを削除する方法について説明します。

トピック:

- 静的ワークスペース・ファイルの削除

- すべての静的ワークスペース・ファイルの削除

16.4.5.1 静的ワークスペース・ファイルの削除

アップロードした静的ワークスペース・ファイルを削除するには、次のステップを実行します。

1. 共有コンポーネント・ページにナビゲートします。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。

b. アプリケーションを選択します。

c. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

共有コンポーネント・ページが表示されます。

2. 「ファイル」で、「静的ワークスペース・ファイル」を選択します。

静的ワークスペース・ファイル・ページが表示されます。

3. まだ選択していない場合は、「レポートの表示」アイコンをクリックします。

レポートが表示されます。レポートをカスタマイズするには、ページ上部にある検索バーを使用します。

4. 削除するファイルを選択します。

5. 編集ページで、「削除」をクリックします。

関連項目:

「検索バーについて」

16.4.5.2 すべての静的ワークスペース・ファイルの削除

アップロードしたすべての静的ワークスペース・ファイルを削除するには、次のステップを実行します。

1. 共有コンポーネント・ページにナビゲートします。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。

b. アプリケーションを選択します。

c. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

共有コンポーネント・ページが表示されます。

2. 「ファイル」で、「静的ワークスペース・ファイル」を選択します。

静的ワークスペース・ファイル・ページが表示されます。

3. 「すべてのファイルの削除」をクリックします。

16.5 アプリケーション・レベル・アイテムの管理

アプリケーション・レベル・アイテムは表示されませんが、アプリケーションのグローバル変数として使用されます。アプリケーション・アイテムは、グローバル変数として使用できます。

トピック:

- アプリケーション・レベル・アイテムの作成

- アプリケーション・アイテムの使用状況の表示

- アプリケーション・レベル・アイテム属性の編集

- グローバル変数として機能するアプリケーション・レベル・アイテムの作成について

関連項目:

- ページ・アイテムとアプリケーション・アイテムの違いについて

- アイテム値の参照

16.5.1 アプリケーション・レベル・アイテムの作成

アプリケーション・レベル・アイテムを作成するには、次のステップを実行します。

1. 共有コンポーネント・ページにナビゲートします。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。

b. アプリケーションを選択します。

c. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

共有コンポーネント・ページが表示されます。

2. 「アプリケーション・ロジック」で、「アプリケーション・アイテム」を選択します。

アプリケーション・アイテム・ページが表示されます。

3. アプリケーション・アイテムを作成するには、「作成」をクリックします。

作成/編集ページが表示されます。

4. 「名前」は、次のようにします。

a. 名前: アプリケーション・レベル・アイテムの名前を入力します。

b. 有効範囲: 次のオプションがあります。

- グローバル: アプリケーションが同じワークスペース内の他のアプリケーションとセッション・ステートを共有する場合は、このオプションを選択します。

- アプリケーション: アプリケーションが別のアプリケーションとセッション・ステートを共有する場合は、このオプションを選択します。

5. 「セキュリティ」の「データ型」で、このアイテムのデータ型を選択します。

6. 「セキュリティ」の「セッション・ステート保護」で、このアイテムのセッション・ステート保護を選択します。オプションは次のとおりです。

- 制限なし: URLまたはフォームでアイテム名/値を渡して、アイテムのセッション・ステートを設定できます。URLにチェックサムは必要ありません。

注意:

Ajaxを使用してこのアイテムの値をセッション・ステートに設定する必要がある場合は、アイテムに対して「制限なし」保護レベルを使用する必要があります(たとえば「動的アクション」の場合は、「値の設定」、「送信するページ・アイテム」または「カスケードLOV」、「送信するページ・アイテム」)。

- 制限付き - ブラウザから設定できない: URLまたはPOSTDATAを使用してアイテムを変更できません。アイテムの値を内部プロセス、計算などに設定できる方法を制限する場合は、このオプションを使用します。この属性は、データ・エントリ・アイテムとして使用できないアイテムのみに適用され、セッション・ステート保護が無効になっていても常に監視されます。次の表示形式タイプのアプリケーション・アイテムについては、この属性を使用します。

- 表示のみ(状態の保存=なし)

- 表示のみ(状態の保存=なし)

- グリッド・レイアウドの停止と開始(ラベルのみ表示)

- チェックサムが必要 - アプリケーション・レベル: スキーマ固有のチェックサムを入力する場合は、URLでアイテムの名前/値を渡して、アイテムのセッション・ステートを設定できます。ユーザー・レベル・チェックサムまたはセッション・レベル・チェックサムも使用できます(次の項目を参照)。現行のワークスペースの別のセッションで同じアプリケーションを実行しているユーザーが生成したチェックサムを含むURLによってのみ、このアイテムを設定できるようにする場合に、このオプションを使用します。

- チェックサムが必要: ユーザー・レベル: ワークスペース、アプリケーションおよびユーザー固有のチェックサムを入力する場合は、URLでアイテムの名前/値を渡して、アイテムのセッション・ステートを設定できます。セッション・レベル・チェックサムも使用できます(次の項目を参照)。現行のワークスペースの別のセッションで同じアプリケーションを実行しているユーザーが生成したチェックサムを含むURLによってのみ、このアイテムを設定できるようにする場合に、このオプションを使用します。

- チェックサムが必要: セッション・レベル: カレント・セッション固有のチェックサムを入力する場合は、URLでアイテムの名前/値を渡して、アイテムのセッション・ステートを設定できます。カレント・セッションで生成されたチェックサムを含むURLによってのみ、このアイテムを設定できるようにする場合に、このオプションを使用します。

7. 「構成」の「ビルド・オプション」で、このコンポーネントのビルド・オプションを選択します。ビルド・オプションは、アプリケーション内のコンポーネントが有効かどうかを判別する事前定義された設定です。

8. 「コメント」に、このアイテムに関するメモを入力します。

9. 「アプリケーション・アイテムの作成」をクリックします。

関連項目:

「グローバル変数として機能するアプリケーション・レベル・アイテムの作成について」

16.5.2 アプリケーション・アイテムの使用状況の表示

アプリケーション・アイテム・ページの上部にある「使用状況」タブをクリックして、アプリケーション・アイテムが使用されている場所のリストを表示できます。

使用状況レポートを表示するには、次のステップを実行します。

1. 共有コンポーネント・ページにナビゲートします。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。

b. アプリケーションを選択します。

c. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

共有コンポーネント・ページが表示されます。

2. 「アプリケーション・ロジック」で、「アプリケーション・アイテム」を選択します。

アプリケーション・アイテム・ページが表示されます。

3. ページ上部で「使用状況」をクリックします。

16.5.3 アプリケーション・レベル・アイテム属性の編集

作成したアプリケーション・レベル・アイテムは、アプリケーション・アイテムの作成/編集ページで編集できます。

アプリケーション・レベル・アイテム属性を編集するには、次のステップを実行します。

1. 共有コンポーネント・ページにナビゲートします。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。

b. アプリケーションを選択します。

c. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

共有コンポーネント・ページが表示されます。

2. 「アプリケーション・ロジック」で、「アプリケーション・アイテム」を選択します。

アプリケーション・アイテム・ページが表示されます。

3. アプリケーション・アイテムを選択します。

作成/編集ページが表示されます。

4. 属性を編集します。

属性の詳細は、フィールドレベル・ヘルプを参照してください

5. 「変更の適用」をクリックします。

関連項目:

- 「フィールドレベル・ヘルプの表示」

- クロスサイト・スクリプティング保護の理解

16.5.4 グローバル変数として機能するアプリケーション・レベル・アイテムの作成について

大規模なアプリケーションは、通常、同じワークスペースに存在するいくつかの物理アプリケーションに分けられます。これらのアプリケーションは、通常、各アプリケーションで同じCookie名を構成することでセッション・ステートを共有します。

このタイプのアーキテクチャのもう1つの要件は、2、3のグローバル変数を共有する必要があることです。グローバル変数の数を少なく維持する必要がありますが、グローバル変数はアプリケーション間の通信を促進する効果的な手段として機能します。次に例を示します。

- カレント・ユーザーのプロパティ(電子メール・アドレス、従業員番号など)。

- マルチテナント・アプリケーションの現在の会社。

すべてのアプリケーション間で同じ名前を持つアプリケーション・レベル・アイテムを作成し、有効範囲をグローバルに設定することによって、グローバル変数を作成できます。

グローバル変数として機能するアプリケーション・レベル・アイテムを作成するには、次のステップを実行します。

1. セッション・ステートを共有する各アプリケーションで、同じ名前のアプリケーション・レベル・アイテムを作成します。

2. 「有効範囲」で、「グローバル」を選択します。

3. 「セキュリティ」の「セッション・ステート保護」で、制限付きを選択します。

関連項目:

アプリケーション・レベル・アイテムの作成

16.6 アプリケーション・レベルでのLOVの作成

この項では、値リストを作成する方法について説明します。

トピック:

- 値リストとは

- アプリケーション・レベルでの名前付きのLOVの作成

- 静的LOVについて

- 既存のLOVの編集

- LOV内でのセッション・ステートの参照について

- LOVレポートへのアクセス

16.6.1 値リストとは

LOVは、ポップアップLOV、選択リスト、チェック・ボックス、ラジオ・グループ、複数の選択リストなどの、特定のタイプのページ・アイテムを表示するために使用される静的または動的な値のセットです。アプリケーション・レベルでLOVを作成することによって、共有コンポーネントを作成しています。共有コンポーネントとしてLOVを作成することには次のような利点があります。

- アプリケーション内のすべてのページに追加できます。

- すべてのLOV定義は1つの場所に格納されるため、検索と更新が簡単になります。

関連項目:

ページ・レベル・アイテムの作成および共有コンポーネントでの作業

16.6.2 アプリケーション・レベルでの名前付きのLOVの作成

アプリケーション・レベルで名前付き(共有) LOVを定義するには、「LOVの作成」ウィザードを実行して、これらのLOVをLOVリポジトリに追加します。すべてのLOVは、静的LOVまたは動的LOVとして定義できます。静的リストは、表示値と戻り値の事前定義された組合せに基づきます。動的リストは、表から値を選択するように作成したSQL問合せに基づきます。

名前付きLOVを作成するには、次のステップを実行します。

1. 共有コンポーネント・ページにナビゲートします。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。

b. アプリケーションを選択します。

c. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

共有コンポーネント・ページが表示されます。

2. 「他のコンポーネント」で、「LOV」を選択します。

LOVページが表示されます。

3. LOVを作成するには、「作成」をクリックします。

4. 画面に表示されるステップに従います。

新しい名前付きのLOVがLOVリポジトリに追加されます。LOVをページに追加するには、適切なアイテムまたは列を編集して、名前付きのLOVを選択する必要があります。

16.6.3 静的LOVについて

静的LOVは、LOVの作成ウィザードの実行時に指定する表示値と戻り値の静的リストに基づきます。静的LOVを作成するには、LOVの作成ウィザードを実行して、LOVタイプに「静的」を選択します。Oracle Application Expressによって、指定した表示値、戻り値およびソート順序がLOVリポジトリに格納されます。リポジトリに静的LOVを追加すると、アイテムを作成し、この定義に基づいてチェック・ボックス、ラジオ・グループ、選択リストまたはポップアップ・リストとしてアイテムを表示できます。

16.6.4 既存のLOVの編集

既存のLOVを編集するには、「LOV」ページでLOVを選択します。

トピック:

- LOVの編集

- LOVのバルク編集

16.6.4.1 LOVの編集

LOVを編集するには、次のステップを実行します。

1. 共有コンポーネント・ページにナビゲートします。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。

b. アプリケーションを選択します。

c. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

共有コンポーネント・ページが表示されます。

2. 「他のコンポーネント」で、「LOV」を選択します。

LOVページが表示されます。

3. LOVを選択します。

編集ページが表示されます。

4. 属性を編集します。

属性の詳細は、フィールドレベル・ヘルプを参照してください。

5. 「変更の適用」をクリックします。

関連項目:

「フィールドレベル・ヘルプの表示」

16.6.4.2 LOVのバルク編集

「LOVの編集」ページで「グリッド編集」ボタンをクリックすることによって、すべての静的LOVの表示値を編集できます。

静的LOVのバルク編集を実行するには、次のステップを実行します。

1. 共有コンポーネント・ページにナビゲートします。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。

b. アプリケーションを選択します。

c. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

共有コンポーネント・ページが表示されます。

2. 「他のコンポーネント」で、「LOV」を選択します。

デフォルトでは、LOVはアイコンとして表示されます。

3. 「グリッド編集」タブをクリックします。

4. 表示テキストを編集し、「変更の適用」をクリックします。

16.6.5 LOV内でのセッション・ステートの参照について

バインド変数を使用することでセッション・ステートを参照できます。セッション・ステートを参照するとLOVは再利用性が多少低下しますが、開発手法として推奨されています。次の例では、このLOVはmy_deptnoというアイテムに有効な部門番号が含まれている場合のみ機能します。

SELECT ename, empno FROM emp WHERE deptno = :P1_DEPTNO

16.6.6 LOVレポートへのアクセス

LOVレポートへのアクセス

1. 共有コンポーネント・ページにナビゲートします。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。

b. アプリケーションを選択します。

c. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

共有コンポーネント・ページが表示されます。

2. 「他のコンポーネント」で、「LOV」を選択します。

デフォルトでは、LOVはアイコンとして表示されます。

3. ページ上部の次のいずれかのタブを選択します。

- NULLテキストの編集 - アプリケーション内のすべてのLOVのNULLテキストを編集します。

- ローカルに定義 - アイテムの定義でローカルに定義されているすべてのLOVが表示されます。複数のページで使用可能なLOVは、共有LOVに変換できます。ローカルに定義されたLOVを共有LOVに変換すると、再利用が促進されます。

- グリッド編集 - すべての静的LOVの表示値を編集できます。

- 条件付きエントリ - 条件付きで表示されるすべてのLOVが表示されます。

- サブスクリプション - アプリケーションに存在するサブスクライブされたLOVがすべて表示されます。

- 使用状況 - アプリケーション内でLOVが使用されている場所が表示されます

- 履歴 - 最近変更されたLOVの履歴が日付ごとに表示されます

4. 画面に表示されるステップに従います。

16.7 リストの作成

開発者は、リンク(またはリスト)の共有コレクションをデータベース・アプリケーションに追加できます。リージョンを作成してリージョン・タイプを「リスト」に指定することによって、リストをページに追加します。リストの外観は、リスト・テンプレートで制御します。

トピック:

- リストの作成について

- ナビゲーション・メニューについて

- 静的リストの作成

- 動的リストの作成

- リストのコピー

- ページへのリストの追加

- リスト属性の編集

- リスト・レポートへのアクセス

関連項目:

16.7.1 リストの作成について

Oracle Application Expressでは、次の2つのタイプのリストをサポートしています。

- 静的リスト - 静的リストを作成する場合、リスト・エントリ・ラベルおよびターゲット(ページまたはURLのいずれか)を定義します。既存のエントリをコピーするかリスト・エントリを追加することによって、リストを作成(最初から作成)するときにリスト・エントリを追加できます。表示条件を定義することにより、リスト・エントリを表示するタイミングを制御できます。

- 動的リスト - 動的リストは、SQL問合せまたは実行時に実行されるPL/SQLファンクションに基づいています。動的リストを使用すると、jQuery Mobileなどのモバイル・フレームワークをサポートするスタイル・リスト・アイテムを動的に作成できます。

リスト定義には、特定のタイプのページ・アイテム(進捗バー、サイドバー、箇条書きナビゲーション・リスト、ナビゲーション・メニューなど)が表示されます。テンプレートによってリストの表示方法を制御できます。

関連項目:

- 「静的リストの作成」

- 「動的リストの作成」

- 動的リスト構文の理解

- 「新しいテンプレートの作成」

- 「リスト・テンプレート」

16.7.2 ナビゲーション・メニューについて

古いテーマでは、タブの作成によるナビゲーション・サポートが提供されています。ユニバーサル・テーマ - 42などの新しいテーマでは、ナビゲーション・メニューの作成によるナビゲーション・サポートが提供されます。使用しているテーマがナビゲーション・メニューをサポートしている場合、アプリケーションの作成ウィザードを実行すると自動的にナビゲーション・メニューが作成されます。サンプル・データベース・アプリケーションには、サイドバーに表示されるナビゲーション・メニューが含まれています。

ナビゲーション・メニューは、階層型サブメニューの作成をサポートしています。ページ上部のタブまたは(前述の例に示すように)サイド・バーのいずれかとして、ナビゲーション・メニューをレンダリングできます。サイド・バーとして表示されるナビゲーション・メニューは、反応性があります。使用可能な領域に基づいて、ナビゲーション・バーは完全なメニューを表示するか、または幅の狭いアイコン・バーに縮小されます。サイド・ナビゲーション・メニューは、テーマおよびユーザー・インタフェース・レベルによって制御されます。

代替リスト・テンプレートを選択するか、「ユーザー・インタフェースの詳細」を編集してナビゲーション・メニューの位置を変更することができます。テーマを編集することで、使用可能なナビゲーション・メニュー・リスト・テンプレートを構成できます。

タブからナビゲーション・メニューへの切替えについて

1レベルのタブを使用する既存のアプリケーションが使用されていた場合、開発者はタブを使用するテーマからナビゲーション・メニューを使用するテーマに切り替えることができます。既存のアプリケーションが2レベルのタブを使用している場合、テーマを変更する前に1レベルに変換する必要があります。

関連項目:

- アプリケーションのユーザー・インタフェースの管理

- テーマの編集

16.7.3 静的リストの作成

この項では、静的リストの作成について説明します。

トピック:

- 静的リストの作成プロセスについて

- リストを最初から作成

- 静的リストへのエントリとサブリストの追加について

- エントリまたはサブリストを最初から追加

- リスト間での静的リスト・エントリのコピー

- 静的リスト・エントリの親の変更

- 孤立した静的リスト・エントリの管理

- 静的リスト・エントリの順序変更

16.7.3.1 静的リストの作成プロセスについて

静的リストの作成プロセスでは、次のステップを実行します。

- ステップ1: リストの作成ウィザードを実行して、リストを作成します。

- ステップ2: 最初からリストを作成するか既存リストをコピーするかを指定します。
エントリを最初から作成するか、または既存リストからエントリをコピーすることによって、リスト・エントリを追加できます。リスト全体をコピーすると、すべてのリスト・エントリもコピーされます。

- ステップ3: 最初からリストを作成する場合は、リスト・タイプを選択するプロンプトが表示されます。「静的」を選択します。
各リスト要素には、いつ表示するかを制御できる表示条件があります。特定のページのカレントまたは非カレントとしてリスト要素を定義できます。

- ステップ4: リスト・リージョンを作成して、ページにリストを追加します。

これらのステップは必要に応じて実行します。リストの作成ウィザードを実行するときに最初の3つのステップを実行できます。または、これらのステップを一度に1つ実行することもできます。

関連項目:

- 「ページへのリストの追加」

- 「リスト属性の編集」

- 「リスト・レポートへのアクセス」

16.7.3.2 リストを最初から作成

リストを最初から作成するには、次のステップを実行します。

1. リストの作成/編集ウィザードへのアクセス

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

d. 「ナビゲーション」で、「リスト」をクリックします。

e. 「作成」をクリックします。

2. 「ソース」で「最初から」を選択し、「次へ」をクリックします。

3. 「名前およびタイプ」で、次のステップを実行します。

a. 名前: 数字または英数字のリスト名を入力します。

b. タイプ: 「静的」を選択します。

c. ビルド・オプション: このコンポーネントのビルド・オプションを選択します(使用可能な場合)。ビルド・オプションは、アプリケーション内のコンポーネントが有効かどうかを判別する事前定義された設定です。

d. 「次へ」をクリックします。

4. 「リスト・エントリの定義」で、次のように指定します。

a. リスト・エントリ・ラベル: 数字または英数字のリスト名を入力します。

b. ターゲット・ページIDまたはカスタムURL: ターゲット・ページを選択するか、またはカスタムURLを入力します。

c. 「次へ」をクリックします。

5. 「確認」で、次のように指定します。

a. リスト・リージョンを作成しますか。: リスト・リージョンを作成するかどうかを選択します。オプションは次のとおりです。

- リスト・リージョンを作成しない

- カレント・ページにリスト・リージョンを作成する

- 各ターゲット・ページのリスト・リージョンを作成する

b. リージョン位置: 新しいリージョンを作成する場合は、リージョン位置を選択します。

c. リージョン・テンプレート: 新しいリージョンを作成する場合は、リージョン・テンプレートを選択します。

d. リスト・テンプレート: リストの外観の制御に使用するリスト・テンプレートを選択します。

e. 「リストの作成」をクリックします。

16.7.3.3 静的リストへのエントリとサブリストの追加について

リストの作成後、リストにエントリを追加する必要があります。リストを最初から作成するか、リスト・エントリをリスト内からコピーするか、または既存のエントリをあるリストから別のリストにコピーすると、リスト・エントリを追加できます。

サブリストを含む階層的なリストも作成できます。階層的なリストを作成するには、次のステップを実行します。

- 階層的なリストをサポートするリスト・テンプレートを選択します。階層的なリストをサポートするリスト・テンプレートを判別するには、サブリスト付きというネーミング規則のあるテンプレートを検索します。

- 各リスト・エントリの作成時には親リスト・アイテムを選択します。

関連項目:

- カスタム・テーマの作成

- 「リスト・テンプレート」

16.7.3.4 エントリまたはサブリストを最初から追加

エントリまたはサブリストを最初から追加するには、次のステップを実行します。

1. リスト・ページにナビゲートします。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

d. 「ナビゲーション」で、「リスト」を選択します。

リスト・ページが表示されます。

2. リストを選択します。

リスト詳細ページが表示されます。

3. 「エントリの作成」をクリックします。

4. 「エントリ」で、次のステップを実行します。

a. 親リスト・エントリ: 該当する場合、このリスト・エントリの親を選択します。サブリストを含む階層的なリストを作成する場合は、この属性を使用します。

この属性は、親リスト・エントリを作成する場合は表示されません。

b. 順序: リストにおけるリスト・エントリの表示順序を指定します。これによって評価の順序が決まります。

c. イメージ/クラス - このリスト・エントリを表示するために使用するイメージ・ファイル名またはFont Awesome CSSクラスを指定します。この属性はリスト・テンプレートによって指定されます。

d. 属性: リスト要素イメージのイメージ属性(width="12" height="12"など)を指定します。

リスト・ラベル・テキストを参照するには、#LIST_LABEL#置換文字列を使用します。この置換文字列を使用すると、リスト・ラベル・テキストの値に基づいてタイトル・イメージ属性を自動的に設定できます。次に例を示します。

title="#LIST_LABEL#"

e. Alt属性: リスト要素イメージのイメージalt属性を指定します。

リスト・ラベル・テキストを参照するには、#LIST_LABEL#置換文字列を使用します。この置換文字列を使用すると、リスト・ラベル・テキストの値に基づいてAlt属性を自動的に設定できます。次に例を示します。

...alt="#LIST_LABEL#"...

f. リスト・エントリ・ラベル: このリンクのラベル・テキストを入力します。

5. ターゲット・タイプを指定します。オプション: 「URL」または「このアプリケーションのページ」。

ターゲット位置がURLの場合、次のように指定します。

a. ターゲット・タイプ: 「URL」を選択します。

b. URLターゲット: URLを入力します。次に例を示します。

http://www.example.com

ターゲット位置がページの場合、次のステップを実行します。

a. ターゲット・タイプ: 「このアプリケーションのページ」を選択します。

b. ページ: ターゲット・ページ番号を指定します。

他のオプションは次のとおりです。

- このページのページ区切りをリセット: ユーザーの新規問合せに合うデータの最初のセットにページを戻すには、このオプションを選択します。

- 印刷用: このオプションを選択すると、アプリケーションの「印刷用」テンプレートを使用するターゲット・ページが表示されます。「印刷用」テンプレートにより、印刷用ページが最適化されます。

c. リクエスト: 組込みアプリケーション・アイテムREQUESTを設定するテキストを入力します。これは、クリックしたボタンの名前で設定されるアイテムでもあります。

d. キャッシュのクリア - ユーザーのセッション・ステートをクリアするページのページ番号を、カンマで区切って入力します。詳細は、フィールドレベル・ヘルプを参照してください。

e. セッション・ステートを設定するには(リストされたアイテムに値を与えます)、次のステップを実行します。

- 「次のアイテムを設定」で、セッション・ステートを設定するアイテム名をカンマで区切って入力します。

- 「次の値を使用」で、前述のステップで指定したアイテムの値をカンマで区切って入力します。

静的な値または置換構文(&APP_ITEM_NAME.など)を指定できます。URLのf?p=に渡されるアイテム値にはコロン(:)を使用しないでください。また、バックスラッシュでアイテム値全体を囲んだ場合(\1234,56\など)を除いて、カンマも使用しないでください。

6. カレント・リスト・エントリの項目は次のとおりです。

a. リスト・エントリがカレントとなるページ・タイプ: ページ・タイプに基づいて、このリスト・エントリがカレントとなる時点を指定します。

リスト・アイテムはカレントまたは非カレントにできます。カレント・リスト・アイテムではカレント・テンプレートが使用され、非カレント・リスト・アイテムでは非カレント・リスト・アイテム・テンプレートが使用されます。実際の条件およびテンプレートは後続の属性で定義されます。

b. リスト・エントリがカレントとなる条件: 条件付きで表示します。前述の選択に基づいて、評価する条件を定義します。この条件がTRUEの場合は、リスト・アイテムがカレントになります。詳細は、フィールドレベル・ヘルプを参照してください。

7. 「条件」で、リスト・エントリを条件付きにする適切な情報を指定します。

8. 「認可」で、認可スキームを指定できます。

この認可スキームは、このコンポーネントをレンダリングまたは処理するためにTRUEと評価される必要があります。

9. 「構成」で、このコンポーネントのビルド・オプションを選択します。

ビルド・オプションは、アプリケーション内のコンポーネントが有効かどうかを判別する事前定義された設定です。

10. 「クリック・カウント」で、リスト・エントリをクリック・カウントに含むかどうかを指定します。

これが外部ページへのリンクである場合、クリックをカウントできます。

11. 「ユーザー定義属性」で、追加属性を指定します。たとえば、次にtabindexやaccesskeyを追加します。
tabindex="15" accesskey="D"

12. リスト属性の定義の終了後、「作成」または「作成後、別のものの作成」をクリックします。

関連項目:

- テーマの編集

- 「印刷用ページの最適化」

- 『Oracle Application Express APIリファレンス』のCOUNT_CLICKプロシージャに関する項

16.7.3.5 リスト間での静的リスト・エントリのコピー

あるリストから別のリストに静的リスト・エントリをコピーできます。

リスト間でリスト・エントリをコピーするには、次のステップを実行します。

1. リスト・ページにナビゲートします。

a. 「ワークスペース」ホームページにナビゲートします。

b. 「アプリケーション・ビルダー」アイコンをクリックします。

c. アプリケーションを選択します。

d. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

e. 「ナビゲーション」で、「リスト」をクリックします。

リスト・ページが表示されます。

2. コピーするリストを選択します。

3. 「タスク」リストで、「あるリストから別のリストへのリスト・エントリのコピー」をクリックします。

4. 「リスト・エントリのコピー」で、コピー先のリストを選択し、「次へ」をクリックします。

5. 「リスト・エントリのコピー」をクリックします。

16.7.3.6 静的リスト・エントリの親の変更

リスト・エントリの親の変更ページは、リスト・エントリ階層を管理するために使用します。

リスト・エントリの親を変更するには、次のステップを実行します。

1. リスト・ページにナビゲートします。

a. 「ワークスペース」ホームページにナビゲートします。

b. 「アプリケーション・ビルダー」アイコンをクリックします。

c. アプリケーションを選択します。

d. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

e. 「ナビゲーション」で、「リスト」をクリックします。

リスト・ページが表示されます。

2. リストを選択します。

3. 「タスク」リストで、「このリスト内におけるリスト・エントリの親の変更」をクリックします。

4. 表示を階層のサブセットに制限するには、「開始」を使用します。選択して「実行」をクリックします。

5. 「親の変更先」で新しい親を選択します。

6. 移動するエントリを選択します。

7. 「チェックしたエントリの親の変更」をクリックします。

16.7.3.7 孤立した静的リスト・エントリの管理

孤立リスト・エントリとは、親が現在のリストのメンバーではないリスト・エントリです。リスト・エントリが孤立している場合は、親のエントリを削除します。

孤立リスト・エントリを管理するには、次のステップを実行します。

1. リスト・ページにナビゲートします。

a. 「ワークスペース」ホームページにナビゲートします。

b. 「アプリケーション・ビルダー」アイコンをクリックします。

c. アプリケーションを選択します。

d. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

e. 「ナビゲーション」で、「リスト」をクリックします。

リスト・ページが表示されます。

2. リストを選択します。

3. 「タスク」リストで、「孤立リスト・エントリの管理」をクリックします。

4. 削除するエントリを選択します。

5. 「親エントリのクリア」をクリックします。

16.7.3.8 静的リスト・エントリの順序変更

クリーンアップ・ページで、リスト・エントリの順序を10単位で変更できます。

リスト・エントリをクリーンアップするには、次のステップを実行します。

1. リスト・ページにナビゲートします。

a. 「ワークスペース」ホームページにナビゲートします。

b. 「アプリケーション・ビルダー」アイコンをクリックします。

c. アプリケーションを選択します。

d. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

e. 「ナビゲーション」で、「リスト」をクリックします。

リスト・ページが表示されます。

2. リストを選択します。

3. 「タスク」リストで、「リストのエントリのクリーンアップ」をクリックします。

4. 「クリーンアップ」をクリックします。

16.7.4 動的リストの作成

この項では、動的リストの作成について説明します。

トピック:

- 動的リストの作成プロセスについて

- 動的リスト構文の理解

- 動的リストを最初から作成

16.7.4.1 動的リストの作成プロセスについて

動的リストを使用すると、jQuery Mobileなどのモバイル・フレームワークをサポートするスタイル・リスト・アイテムを動的に作成できます。動的リストは、SQL問合せまたはSQL問合せを戻すPL/SQLファンクションに基づいています。

動的リストの作成プロセスでは、次のステップを実行します。

- ステップ1: リストの作成ウィザードを実行して、リストを作成します。

- ステップ2: 最初からリストを作成するか既存リストをコピーするかを指定します。

- ステップ3: 最初からリストを作成する場合は、リスト・タイプを選択するプロンプトが表示されます。「動的」を選択します。

- ステップ4: SQL問合せまたはSQL問合せを戻すPL/SQLファンクションを入力します。

- ステップ5: リスト・リージョンを作成して、ページにリストを追加します。

関連項目:

- 「ページへのリストの追加」

- 「リスト属性の編集」

- 「リスト・レポートへのアクセス」

16.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のユーザー属性と一致します。

16.7.4.3 動的リストを最初から作成

動的リストを作成するには、次のステップを実行します。

1. リストの作成/編集ウィザードへのアクセス

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

d. 「ナビゲーション」で、「リスト」をクリックします。

e. 「作成」をクリックします。

2. 「最初から」をクリックし、「次へ」をクリックします。

3. 「名前およびタイプ」で、次のステップを実行します。

a. 名前: 数字または英数字のリスト名を入力します。

b. 「タイプ」で、「動的」を選択します。

c. ビルド・オプション: このコンポーネントのビルド・オプションを選択します(使用可能な場合)。ビルド・オプションは、アプリケーション内のコンポーネントが有効かどうかを判別する事前定義された設定です。

d. 「次へ」をクリックします。

4. 「問合せまたは静的値」で、次のステップを実行します。

a. 問合せソース・タイプ: 「SQL問合せ」または「SQL問合せを戻すファンクション」を選択します。

b. 問合せ: SQL問合せまたはSQL問合せを戻すファンクションを入力します。SQL問合せの例を表示するには、「例」リージョンを展開します。

問合せの作成: 「問合せの作成」をクリックし、ウィザードを使用して選択した表またはビューで問合せを作成します。画面に表示されるステップに従います。

c. 「次へ」をクリックします。

5. 「リストの作成」で、リスト・リージョンを作成するかどうかを指定します。

a. カレント・ページで「リストの作成」リージョンを選択すると、次の属性が表示されます。

- リージョン位置: 新しいリージョンを作成する場合は、リージョン位置を選択します。

- リージョン・テンプレート: 新しいリージョンを作成する場合は、リージョン・テンプレートを選択します。

- リスト・テンプレート: 新しいリージョンを作成する場合は、リスト・テンプレートを選択します。

b. リージョン位置: 新しいリージョンを作成する場合は、リージョン位置を選択します。

c. リージョン・テンプレート: 新しいリージョンを作成する場合は、リージョン・テンプレートを選択します。

d. 「作成」をクリックします。

関連項目:

動的リスト構文の理解

16.7.5 リストのコピー

この項では、リストのコピー方法について説明します。別のアプリケーションまたは既存のアプリケーションからリストをコピーできます。

トピック:

- カレント・アプリケーションからのリストのコピー

- アプリケーション間でのリストのコピー

16.7.5.1 カレント・アプリケーションからのリストのコピー

あるリストから別のリストにリスト・エントリをコピーできます。

リスト間でリスト・エントリをコピーするには、次のステップを実行します。

1. リスト・ページにナビゲートします。

a. 「ワークスペース」ホームページにナビゲートします。

b. 「アプリケーション・ビルダー」アイコンをクリックします。

c. アプリケーションを選択します。

d. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

e. 「ナビゲーション」で、「リスト」をクリックします。

リスト・ページが表示されます。

2. コピーするリストを選択します。

3. 「タスク」リストで、「リストのコピー」をクリックします。

4. 「リストをコピー」で、「このアプリケーションのリスト」を選択し、「次へ」をクリックします。

5. 「リストを指定」で、次のステップを実行します。

a. リストのコピー: コピーするリストを選択します。

b. 新しいリスト名: コピーされたリストに新しい名前を入力します。

c. 「コピー」をクリックします。

16.7.5.2 アプリケーション間でのリストのコピー

カレント・アプリケーションまたは別のアプリケーションからリストをコピーできます。

リストをコピーするには:

1. リスト・ページにナビゲートします。

a. 「ワークスペース」ホームページにナビゲートします。

b. 「アプリケーション・ビルダー」アイコンをクリックします。

c. アプリケーションを選択します。

d. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

e. 「ナビゲーション」で、「リスト」をクリックします。

リスト・ページが表示されます。

2. コピーするリストを選択します。

3. 「タスク」リストで、「リストのコピー」をクリックします。

4. 「リストをコピー」で、「別のアプリケーションのリスト」を選択し、「次へ」をクリックします。

5. 「リストを指定」で、次のステップを実行します。

a. アプリケーションからコピー: リストのコピー元となるアプリケーションを選択します。

b. リストのコピー: コピーしているリストを選択します。

c. 新しいリスト名: 新しいリストの名前を入力します。

d. 「コピー」をクリックします。

16.7.6 ページへのリストの追加

リストとリスト・エントリの作成後、リージョンを作成してリージョン・タイプを「リスト」に指定することによって、このリストをページに追加します。

関連項目:

ページ・デザイナでのリージョンの作成

ページにリストを追加するには、次のステップを実行します。

1. 適切なページにナビゲートします。レガシー・コンポーネント・ビューでのページの表示を参照してください。

2. 「リージョン」で、「作成」アイコンをクリックします。

「リージョンの作成」ウィザードが表示されます。

3. 「リージョン」で、リージョン・タイプとして「リスト」を選択し、「次へ」をクリックします。

4. 「表示属性」で、次のステップを実行します。

a. タイトル - リージョンのタイトルを入力します。選択するリージョン・テンプレートにリージョン・タイトルが表示されると、このタイトルが表示されます。

b. リージョン・テンプレート: リージョンの外観を制御するテンプレートを選択します。

c. 親リージョン: 新しいリージョンが属する親リージョンを定義します。

d. 表示ポイント: このリージョンの表示ポイントを指定します。

e. 順序: このコンポーネントの順序を指定します。これによって評価の順序が決まります。

f. 「次へ」をクリックします。

5. 「ソース」で、次のステップを実行します。

a. リスト: 追加するリストを選択します。

b. リスト・テンプレート: リストの外観を制御するテンプレートを選択します。

c. 「次へ」をクリックします。

6. 「条件付き表示」で、次のステップを実行します。

a. 条件タイプ: このコンポーネントがレンダリングされるために満たす必要があるリストから、条件タイプを選択します。

b. 認可スキーム: オプションで認可スキームを選択します。このコンポーネントをレンダリングまたは処理するためには、この認可スキームがTRUEと評価される必要があります。

c. 「リージョンの作成」をクリックします。

リストを追加する各ページに対して、これらのステップを実行します。

関連項目:

- 条件付きのレンダリングおよびプロセスの理解

- 認可を介したセキュリティの提供

- 「新しいテンプレートの作成」

- リスト表示の変更方法については、「リスト・テンプレート」を参照してください

16.7.7 リスト属性の編集

作成したリストは、リスト・ページで編集できます。

リストを編集するには、次のステップを実行します。

1. リスト・ページにナビゲートします。

a. 「ワークスペース」ホームページにナビゲートします。

b. 「アプリケーション・ビルダー」アイコンをクリックします。

c. アプリケーションを選択します。

d. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

e. 「ナビゲーション」で、「リスト」をクリックします。

リスト・ページが表示されます。

2. リストを選択します。

リスト詳細ページが表示されます。

3. リスト名またはビルド・オプションを変更するには、「リストの編集」ボタンをクリックします。

4. リスト名またはビルド・オプションを変更するには、次のステップを実行します。

a. 「リストの編集」ボタンをクリックします。

b. 対象となる属性を編集します。

c. 「変更の適用」をクリックします。

5. リスト順序、リンク・テキスト、ターゲットまたはすべてのリスト・エントリの現在のステータスを編集するには、「グリッド編集」をクリックします。

a. リスト順序、リンク・テキスト、ターゲットまたはすべてのリスト・エントリの現在のステータスを編集するには、「グリッド編集」をクリックします。

b. 対象となる属性を編集します。

c. 「変更の適用」をクリックします。

16.7.8 リスト・レポートへのアクセス

リスト・ページ上部の該当するタブをクリックして、「未使用」、「条件付きエントリ」、「使用状況」および「履歴」レポートを表示できます。これらのレポートは、リストの作成後にのみ表示されます。

リスト・レポートを表示するには、次のステップを実行します。

1. リスト・ページにナビゲートします。

a. 「ワークスペース」ホームページにナビゲートします。

b. 「アプリケーション・ビルダー」アイコンをクリックします。

c. アプリケーションを選択します。

d. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

e. 「ナビゲーション」で、「リスト」をクリックします。

リスト・ページが表示されます。

2. 該当するタブをクリックします。

- 未使用 - 「未使用」タブをクリックすると、カレント・アプリケーションで使用されていないリストが識別されます。

- 条件付きエントリ - 「条件付きエントリ」タブをクリックすると、条件付きリストが表示されます。

- 使用状況 - 「リストの使用状況」タブをクリックすることで、使用状況レポートにアクセスします。このレポートに、カレント・アプリケーションに含まれるすべてのリストが表示されます。レポートから、次の操作を実行できます。

- リスト名を選択して、リスト・エントリを編集します。

- 「ページ」列の番号をクリックして、リストに表示されるページを表示します。

- 「リスト・テンプレートの使用状況」を展開して名前をクリックし、リスト・テンプレートを表示または編集することによって、リストで使用されるテンプレートを表示します。

- 履歴 - 「履歴」タブをクリックすると、リスト定義およびリスト・エントリに対する変更が開発者および日付ごとに表示されます。

16.8 ショートカットの使用

この項では、ショートカットを作成および使用する方法について説明します。

トピック:

- ショートカットとは

- ショートカット・タイプの理解

- ショートカットの定義と参照

- 既存のショートカットの編集

- ショートカット・レポートへのアクセス

16.8.1 ショートカットとは

ショートカットを使用すると、HTMLまたはPL/SQLファンクションを繰り返しコーディングする必要がなくなります。ショートカットを使用して、ボタン、HTMLテキスト、PL/SQLプロシージャ、HTMLなどのページ・コントロールを定義できます。ショートカットを定義すると、そのショートカットが使用される位置に固有な特定の構文を使用して起動できます。ショートカットは何度でも参照できるため、コードの重複を削減できます。

次の属性でショートカットを使用できます。

- 「HTMLテキスト(ショートカットあり)」として定義されたリージョンのリージョン・ソース属性。リージョンについてを参照してください。

- リージョンのヘッダーおよびフッターのテキスト属性。リージョンのヘッダーおよびフッターの指定を参照してください。

- アイテム・ラベル属性、要素の前のテキスト、要素の後のテキストおよびデフォルト値属性。

- リージョン・テンプレート属性。カスタム・テーマの作成を参照してください。

16.8.2 ショートカット・タイプの理解

この項では、Oracle Application Expressでサポートされるショートカット・タイプについて説明します。

トピック:

- サポートされるショートカット・タイプ

- エスケープされた一重引用符を持つJavaScriptのテキスト

- メッセージ

- エスケープされた一重引用符を持つJavaScriptのメッセージ

16.8.2.1 サポートされるショートカット・タイプ

ショートカットの作成時に、ショートカット・タイプを選択します。Oracle Application Expressは、次のショートカット・タイプをサポートしています。

- PL/SQLファンクション本体

- HTMLテキスト

- エスケープされた特殊文字を持つHTMLテキスト

- イメージ

- エスケープされた一重引用符を持つJavaScriptのテキスト

- メッセージ

- エスケープされた一重引用符を持つJavaScriptのメッセージ

16.8.2.2 エスケープされた一重引用符を持つJavaScriptのテキスト

このタイプのショートカットを使用して、JavaScriptリテラル文字列内部のショートカットを参照します。このショートカットは、テキスト文字列を定義します。ショートカットが参照されると、JavaScriptに必要な一重引用符がエスケープされます。

16.8.2.3 メッセージ

このタイプのショートカットを使用して、実行時に変換可能なメッセージを参照します。このショートカットにはショートカット・ボディがないため、ショートカット名と、対応するメッセージ名が一致する必要があります。実行時、ショートカット名は、現在の言語に翻訳可能なメッセージのテキストに展開されます。

16.8.2.4 エスケープされた一重引用符を持つJavaScriptのメッセージ

このタイプのショートカットを使用して、JavaScriptリテラル文字列内部のショートカットを参照し、実行時に変換可能なメッセージを参照します。

関連項目:

アプリケーション翻訳およびグローバリゼーション・サポートの理解

16.8.3 ショートカットの定義と参照

ショートカットをアプリケーションに組み込むには、ショートカットを定義して、ショートカット・リポジトリに追加する必要があります。この項では、ショートカットを定義および参照する方法について説明します。

トピック:

- ショートカットを最初から定義

- 既存のショートカットのコピー

- ショートカットの参照

16.8.3.1 ショートカットを最初から定義

ショートカットを定義するには、次のステップを実行します。

1. 共有コンポーネント・ページにナビゲートします。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。

b. アプリケーションを選択します。

c. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

共有コンポーネント・ページが表示されます。

2. 「他のコンポーネント」で、「ショートカット」を選択します。

3. 「作成」をクリックします。

4. 「ショートカットの作成」で、「最初から」を選択して「次へ」をクリックします。

5. 「ショートカットの属性」で、次のステップを実行します。

a. 名前 - ショートカットを参照する名前を入力します。

b. タイプ - ショートカット・タイプを選択します。オプションは次のとおりです。

- PL/SQLファンクション本体

- HTMLテキスト

- エスケープされた特殊文字を持つHTMLテキスト

- イメージ

- エスケープされた一重引用符を持つJavaScriptのテキスト

- メッセージ

- エスケープされた一重引用符を持つJavaScriptのメッセージ

c. ショートカット - ショートカットのテキストを入力します。ショートカットは、30,000文字未満の長さにする必要があります。

d. エラー・テキスト - ショートカットの処理中にエラーが発生した場合に表示するテキストを入力します。

e. ビルド・オプション - このコンポーネントのビルド・オプションを選択します。

6. 「作成」をクリックします。

新しいショートカットはショートカット・ページ(ショートカット・リポジトリとも呼ばれる)に追加されます。

16.8.3.2 既存のショートカットのコピー

既存のショートカットをコピーするには、次のステップを実行します。

1. 共有コンポーネント・ページにナビゲートします。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。

b. アプリケーションを選択します。

c. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

共有コンポーネント・ページが表示されます。

2. 「他のコンポーネント」で、「ショートカット」を選択します。

3. 「作成」をクリックします。

4. 「ショートカットの作成」で、「既存のショートカットのコピーとして」を選択して「次へ」をクリックします。

5. 「コピー元アプリケーション」で、ショートカットをコピーするアプリケーションを選択して「次へ」をクリックします。

6. 「新規ショートカット」で「ショートカットのコピー」をクリックします。

a. コピー先 - コピーされるショートカットの新しい名前を入力します。

b. コピー - 「はい」、「いいえ」または「コピーおよびサブスクライブ」を選択します。

c. 「ショートカットのコピー」をクリックします。

新しいショートカットはショートカット・ページ(ショートカット・リポジトリとも呼ばれる)に追加されます。

16.8.3.3 ショートカットの参照

ショートカットを参照するには、次の構文を使用します。

"MY_SHORTCUT"

ショートカットの名前は、大文字で指定し、引用符で囲む必要があります。

16.8.4 既存のショートカットの編集

作成したショートカットは、ショートカットの編集ページで属性を編集することで変更できます。

既存のショートカットを編集するには、次のようにします。

1. 共有コンポーネント・ページにナビゲートします。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。

b. アプリケーションを選択します。

c. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

共有コンポーネント・ページが表示されます。

2. 「他のコンポーネント」で、「ショートカット」を選択します。

3. ショートカットを選択します。

ショートカットの編集ページが表示されます。

4. 属性を編集します。

属性の詳細は、フィールドレベル・ヘルプを参照してください。

5. 「変更の適用」をクリックします。

関連項目:

「フィールドレベル・ヘルプの表示」

16.8.5 ショートカット・レポートへのアクセス

ショートカット・レポートにアクセスするには、次のステップを実行します。

1. 共有コンポーネント・ページにナビゲートします。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。

b. アプリケーションを選択します。

c. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

共有コンポーネント・ページが表示されます。

2. 「他のコンポーネント」で、「ショートカット」を選択します。

3. 次のいずれかのタブをクリックします。

- サブスクリプション - アプリケーションにすべてのサブスクライブされたショートカットを表示するサブスクライブされたショートカット・ページが表示されます。

- 履歴 - 最近変更されたショートカットの履歴を日付ごとに表示するショートカット履歴ページが表示されます。

注意:

「サブスクリプション」タブおよび「履歴」タブが表示されるのは、ショートカットを作成した後のみです。

16.9 レポート出力の管理

この項では、レポート問合せを定義することによってレポート・リージョンを印刷する方法、およびレポート・レイアウトを使用してレポート・リージョンをフォーマットする方法について説明します。

トピック:

- レポート問合せの定義によるレポート・リージョンの印刷

- レポート・レイアウトを使用したレポート・リージョンまたはレポート問合せのフォーマット

16.9.1 レポート問合せの定義によるレポート・リージョンの印刷

この項では、レポート問合せを定義することによってレポート・リージョンを印刷する方法について説明します。

トピック:

- レポート問合せについて

- レポート問合せの作成

- レポート問合せの編集

- レポート問合せのコピー

16.9.1.1 レポート問合せについて

レポート・リージョンは、レポート問合せを共有コンポーネントとして定義することによって出力できます。レポート問合せは、抽出されるデータを識別します。リージョンに含まれるSQL文とは異なり、レポート問合せには、問合せを保存すると有効化されるSQL文が含まれます。レポート問合せは、SQL文を戻すファンクションではなく、SQL文である必要があります。

レポート問合せは、レポート・レイアウトに関連付けて、書式化されたドキュメントとしてダウンロードできます。レポート・レイアウトが選択されていない場合は、汎用のレイアウトが使用されます。汎用レイアウトは、レポート問合せのテストと検証の目的で使用します。汎用レイアウト・オプションを使用する場合にソース問合せが複数定義されていると、最初の結果セットのみが出力ドキュメントに含まれます。レポートには、現行のアプリケーションのセッション・ステートを含めることができます。

これらのレポートをアプリケーションと統合することにより、エンド・ユーザーから使用できるようにします。たとえば、ボタン、リスト・アイテム、ブランチ、またはターゲットとしてURLを使用できるその他のナビゲーション・コンポーネントをレポート問合せに関連付けることができます。そのアイテムを選択すると、出力プロセスが開始します。

16.9.1.2 レポート問合せの作成

「レポート問合せ」オプションの可用性は、サービス管理者がインスタンスに対してどのようなレポート出力設定を行ったかによって異なります。次のステップに示すすべてのオプションが使用可能であるとはかぎりません。

レポート問合せを作成するには、次のステップを実行します。

1. 共有コンポーネント・ページにナビゲートします。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。

b. アプリケーションを選択します。

c. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

共有コンポーネント・ページが表示されます。

2. レポートの下の「レポート問合せ」をクリックします。

3. 「作成」をクリックします。

4. 問合せを実行するには、次の情報を指定します。

a. レポート問合せ名: レポート問合せを識別する名前を入力します。リンク・ターゲットとしてレポート問合せを参照する際に、レポート問合せ名はリクエスト文字列の一部になります。

b. 出力形式: レポート出力形式を選択します。有効なオプションは次のとおりです:

- PDF: Adobe Portable Document Format。

- Word: Microsoft Word Rich Text Format。

- Excel: Microsoft Excel形式。ただし、コンテンツはHTMLベースであるため、本当の.xlsファイルではありません。

- HTML

- XML: Extensible Markup Language。

c. アイテム: 形式の値を保持するアイテムを選択します。このアイテムは、実行時の出力形式を指定する際に使用できます。

d. ファイルの表示形式: レポート問合せドキュメントをWebブラウザでどのように開くかを選択します。オプションは次のとおりです。

- 添付ファイル: ユーザーがレポート問合せのダウンロード・ボタンをクリックすると、ファイルを開くか、または保存するかを尋ねるダイアログ・ボックスが表示されます。

- インライン: レポート問合せドキュメントをブラウザのウィンドウ内に表示します。

e. セッション・ステート: セッション・ステートの値(レポートのXML構造のページ・アイテムの値など)を参照するには、このチェック・ボックスを選択します。

f. 「次へ」をクリックします。

5. 「SQL問合せ」にSQL文を直接入力するか、「クエリー・ビルダー」をクリックして、クリックやポイントによってSQL文を作成します。

SQL文でアプリケーションおよびページ・アイテムを参照する場合は、バインド変数として参照します。「バインド変数の設定」をクリックすると、各バインド変数について値を入力し、問合せをテストして、目的の出力が戻されることを確認できます。

6. 「定義のダウンロード」で、次のように指定します。

a. レポート・レイアウトのデータ・ソース: このオプションは、レポート定義のエクスポート・ファイルをダウンロードするために使用します。

ヒント:

レポート問合せ定義とは、開発者が、BI Publisher DesktopやAltova Stylevisionのようなツールのソースとして使用してレポート・レイアウトを作成するためのものです。ツールによってはデータのXMLエクスポートとXMLスキーム定義の両方をソースとして受け入れますが、どちらか一方しか受け入れないツールもあります。ソース問合せによって設計時にデータが戻されない場合は、XMLスキーマによってデータなしで定義をエクスポートする方法が提供されます。

「XMLデータ」または「XML Schema」を選択し、「ダウンロード」をクリックします。

「XML Schema」を選択すると、XSDファイル(XML構造のXMLスキーマ定義)が作成されます。

b. 問合せの追加: このボタンをクリックすると、レポート問合せに別の問合せを追加できます。別の問合せを追加することにより、複数の出力コンポーネント(2つの異なる問合せをベースにしたチャートおよびレポートなど)を含む複雑なレポートの生成が可能になります。

c. レポート問合せの作成: このボタンをクリックすると、ウィザードが早期に終了します。「レポート・レイアウトのソース」には、汎用のレポート・レイアウトが使用されることになります。

d. 「次へ」をクリックします。

7. 「レポート・レイアウトのアップロード」で、次のように指定します。

a. レポート・レイアウトのソース: レポート・レイアウトの導出方法を指定します。レポート・ベースのファイル・レイアウトを選択した場合、レイアウト名とレポート・レイアウト・ファイルを指定する必要があります。

b. レイアウト名: レイアウト名を入力します(オプション)。デフォルトは、レポート問合せの名前です。

c. レポート・レイアウト・ファイル: 「参照」をクリックし、Rich Text Format(RTF)を選択します。

d. 「次へ」をクリックします。

8. 「確認」で、次のステップを実行します。

a. 問合せ名: 問合せを識別します。

b. レポート・レイアウト: 選択したレポート・レイアウトを識別します。

c. 出力形式: このレポート問合せの形式を識別します。

d. アイテムから導出: 形式情報を保持するアイテムを識別します。

e. URL: このレポートをアプリケーションに統合するには、表示されたURLをボタン、リスト・アイテム、リンクまたは他のナビゲーション・コンポーネントに対するターゲットとして使用します。これにより、たとえば、エンド・ユーザーはボタンをクリックして、出力プロセスを開始できます。

f. テスト・レポート: これをクリックして、レポートのプレビューを表示します。汎用レポート・レイアウトを使用するように指定している場合は、「テスト・レポート」をクリックしても出力は生成されません。

g. 「終了」をクリックします。

レポート問合せは、「共有コンポーネント」に作成および保存されます。

関連項目:

レポート出力の構成オプションについて

16.9.1.3 レポート問合せの編集

レポート問合せを編集するには、次のステップを実行します。

1. 共有コンポーネント・ページにナビゲートします。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。

b. アプリケーションを選択します。

c. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

共有コンポーネント・ページが表示されます。

2. レポートの下の「レポート問合せ」をクリックします。

3. 目的のレポート問合せを選択します。

4. 編集ページで、該当する属性を編集します。

5. 「変更の適用」をクリックします。

16.9.1.4 レポート問合せのコピー

レポート問合せをコピーするには、次のステップを実行します。

1. 共有コンポーネント・ページにナビゲートします。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。

b. アプリケーションを選択します。

c. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

共有コンポーネント・ページが表示されます。

2. レポートの下の「レポート問合せ」をクリックします。

3. レポート問合せページで、「コピー」をクリックします。

4. 「レポート問合せのコピー」で、コピーする問合せを選択して、レポート問合せの名前を入力し、「コピー」をクリックします。

コピーが問合せリストに表示されます。

16.9.2 レポート・レイアウトを使用したレポート・リージョンまたはレポート問合せのフォーマット

この項では、レポート・レイアウトを使用してレポート・リージョンまたはレポート・レイアウトをフォーマットする方法について説明します。

トピック:

- レポート・レイアウトについて

- レポート・レイアウト・オプションの概要

- レポート・レイアウトの作成

- レポート・レイアウトの編集

- レポート・レイアウトのコピー

16.9.2.1 レポート・レイアウトについて

クラシック・レポート・リージョンまたはレポート問合せのどちらかをフォーマットするには、レポート・レイアウトと関連付けます。レポート・レイアウトを使用すると、印刷用形式でデータをレンダリングできます。レポート・レイアウトを選択しない場合は、デフォルトのXSL-FOレイアウトが使用されます。対話モード・レポートのリージョンのレンダリングでは、常にデフォルトのXSL-FOレイアウトが使用されます。

レポート・レイアウトを作成して使用すると、次のことができるようになります。

- レポート・リージョンのデフォルト・レイアウト、およびOracle Application Expressで用意されているレポート問合せの汎用レイアウトを利用できます。

- コードをコピーしてカスタマイズすることによって、レポート・リージョンの組込みXSL-FOベースのレイアウトが利用できます。レポート・リージョンに対して、ページ・サイズ、フォント、色などを制御するいくつかの属性を編集できます。

- RTFまたはXSL-FOレポート・レイアウトを作成してレポートのルック・アンド・フィールをカスタマイズできます。RTFレポート・レイアウトを使用するには、Oracle Application Expressのサービス管理者が、そのサイトに対して詳細設定を選択している必要があります。

注意:

対話モード・レポートでは、カスタム・レポート・レイアウトはサポートされません。

関連項目:

『Oracle Application Express管理ガイド』のレポート出力の構成に関する項

16.9.2.2 レポート・レイアウト・オプションの概要

レポート・レイアウトは、次のいずれかのオプションに基づいて作成できます。

- 汎用列: 汎用レポート・レイアウトはほとんどの問合せ結果セットに使用できます。このレイアウトを使用すると、出力可能なドキュメントの生成時に、列の数が自動的に調整されます。
多くのレポート・レイアウト属性は、組込みのデフォルトXSL-FOレイアウトを使用して、レポート・リージョンに対して宣言的に定義できます。レポート・レイアウトを追加制御する必要がある場合は、このステップによりカスタマイズ可能な組込みのデフォルトXSL-FOレイアウトのコピーを作成できます。

- 名前付き列: 名前付き列のレポート・レイアウトは、問合せ固有のレポート・レイアウトで、問合せ結果セットに含まれる列の定義済リストで使用できるよう設計されています。このレイアウト・タイプはページ・アイテムおよび問合せ列の位置を正確に制御する必要がある場合に、個別に設計されたレイアウトで使用されます。

「レポート・レイアウト」オプションの可用性は、サイト管理者がサイトでどのようなレポート出力設定を行ったかによって異なります。次のステップに示すすべてのオプションが使用可能であるとはかぎりません。

関連項目:

Oracle Application Express管理ガイドの「レポート出力の構成」

16.9.2.3 レポート・レイアウトの作成

レポート・レイアウトを作成するには、次のステップを実行します。

1. 共有コンポーネント・ページにナビゲートします。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。

b. アプリケーションを選択します。

c. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

共有コンポーネント・ページが表示されます。

2. 「レポート」の下の「レポート・レイアウト」をクリックします。

3. 「作成」をクリックします。

レポート・レイアウトの作成ウィザードが表示されます。

4. 「レポート・レイアウト・タイプ」で、オプションを選択し、「次へ」をクリックします。

- 汎用列(XSL-FO) - デフォルト・テンプレートを使用してレポートに移入します。次のステップで、デフォルト・コードをカスタマイズできます。

- 名前付き列(XSL-FO) - 次のステップでXSL-FOまたはRTFファイルをアップロードする必要があります。

5. 「レイアウト・ソース」で、該当する情報を確認および編集します。このページに表示されるオプションは、選択したレイアウト・タイプによって異なります。

- 汎用列を選択した場合は、次のステップを実行します。

a. レポート・レイアウト名: レポート問合せまたはレポート・リージョンに関連付ける際にレポート・レイアウトを識別するための名前を入力します。

b. レポート・レイアウト: レポート・レイアウトは、ページ書式のXSL-FOベースの定義です。ページ・サイズ、向き、フォント、スタイルなどを定義する属性は、すべてこのセクションで定義されます。

c. レポートの列ヘッダー: レポート・ヘッダー行の各セルの外観を定義します。

d. レポート列: すべてのレポート行に対する各セルの外観を定義します。

e. レポート列の幅: 実行時に計算されるか、またはレポート・リージョンのレポート列定義から導出できます。

- 名前付き列を選択した場合は、次のステップを実行します。

a. レイアウト名: レポート問合せまたはレポート・リージョンに関連付ける際に、レポート・レイアウトを識別するための名前を入力します。

b. レポート・レイアウト・ファイル - レポート・レイアウトが含まれるファイルをアップロードします。

6. 「レイアウトの作成」をクリックします。

16.9.2.4 レポート・レイアウトの編集

汎用列のレポート・レイアウトを直接Application Expressで編集できます。ただし、名前付き列のレポート・レイアウトを編集するには、現行のファイルをダウンロードしてそれを編集し、再度アップロードする必要があります。

レポート・レイアウトを編集するには、次のステップを実行します。

1. 共有コンポーネント・ページにナビゲートします。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。

b. アプリケーションを選択します。

c. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

共有コンポーネント・ページが表示されます。

2. 「レポート」の下の「レポート・レイアウト」をクリックします。

3. レポート・レイアウト・ページで、編集するレイアウトを選択します。

4. 汎用列レイアウトの場合は、レポート・レイアウトの編集ページで直接レイアウトを編集し、「変更の適用」をクリックします。

5. 名前付き列のレイアウトの場合は、「ダウンロード」をクリックして、コンピュータにファイルを保存します。

ファイルを編集して、新しいレポート・レイアウトとして更新されたバージョンをアップロードします。

16.9.2.5 レポート・レイアウトのコピー

レポート・レイアウトをコピーして編集および保存できます。

レポート・レイアウトをコピーするには、次のステップを実行します。

1. 共有コンポーネント・ページにナビゲートします。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。

b. アプリケーションを選択します。

c. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

共有コンポーネント・ページが表示されます。

2. 「レポート」の下の「レポート・レイアウト」をクリックします。

3. レポート・レイアウト・ページで、「コピー」をクリックします。

4. レポート・レイアウトのコピー・ページで、コピーするレイアウトを選択して、コピーの名前を入力し、「コピー」をクリックします。

コピーがレイアウト・リストに表示されます。

5. レポート・レイアウトのコピーで、次のステップを実行します。

a. レポート・レイアウトのコピー - コピーするレイアウトを選択します。

b. レポート・レイアウト名 - コピーの名前を入力します。

c. 「コピー」をクリックします。

17 アプリケーション・データの管理

この項では、データ・ロード機能を持つアプリケーションの作成、コレクションの使用、Webサービスの実装、データベース・リンクによるデータへのアクセス、およびデータ操作言語(DML)を利用した表の行の更新または削除など、アプリケーション・データの管理方法について説明します。

トピック:

- データ・ロード機能によるアプリケーションの作成

- コレクションの使用について

- Webサービスの実装

- データベース・リンクを使用したデータへのアクセス

- DMLロックについて

17.1 データ・ロード機能を持つアプリケーションの作成

開発者は、エンド・ユーザーがアクセスできる任意のスキーマ内にある表にデータを動的にインポートできる、データ・ロード機能を持つアプリケーションを作成できます。データをインポートするには、エンド・ユーザーは、ファイルからデータをアップロードするか、エンド・ユーザーがウィザードに直接入力したデータをコピー・アンド・ペーストするデータ・ロード・ウィザードを実行します。

トピック:

- データ・ロード・ウィザードの作成について

- データ・ロード・ウィザードの作成

- データ・ロード・ページの再作成

- データ・ロード定義の編集

関連項目:

Oracle Application Expressエンド・ユーザー・ガイドの「データ・ロード・ウィザードの例」(データ・ロード・ウィザードの使用の詳細)

17.1.1 データ・ロード・ウィザードの作成について

データ・ロード・ウィザードを作成するには、アプリケーション開発者がページの作成ウィザードでデータ・ロード・ページを作成します。作成プロセスで、開発者はアップロード表とその一意の列、表参照およびデータ・トランスフォーメーション・ルールを指定できます。

注意:

データ・ロード・ウィザードは、何十万ものデータ行をロードするようには設計されていません。データ・ロード・ウィザードを使用してこの大量のデータをロードすることは可能ですが、大量のデータ・ファイルの転送およびロードの両方でパフォーマンスの問題が発生する可能性があります。Oracle SQL DeveloperおよびOracle SQL*Loaderのようなツールの方が、大量のデータのロードに適しています。

データ・ロード・ウィザードの実装には、次のサポートが含まれます。

- 表の定義: この定義は、一意のキー列を持つデータ・アップロード表の名前を指定します。

- データ・トランスフォーメーション・ルール - インポート・データを大文字や小文字に変更するといったトランスフォーメーションのフォーマットを行うために、データ・トランスフォーメーション・ルールを定義する必要があります。たとえば、インポート・ファイルに大文字と小文字の両方の列データが含まれ、アップロード表ではすべて大文字であることが必要な場合、大文字のみをターゲット列に挿入するようにデータ・トランスフォーメーション・ルールを定義できます。

- 表参照 - インポート・ファイルの既存データを別の表のデータにマッピングする必要がある場合、表参照を指定してマッピングを実行します。たとえば、インポート・ファイルにはDEPTNO列に部門名が含まれているが、アップロード表ではその列に数値が必要な場合、表参照ルールを使用して、別の表でその部門名に対応する部門番号を探します。

- 列名の別名 - 開発者がエンド・ユーザーに表の列名を公開したり、エンド・ユーザーにすべての列を公開することを望まない状況が数多くあります。このような状況では、公開する必要がある列の別名を作成できます。

- 同時実行性の管理 - 複数のユーザーが同時にデータをアップロードする場合、開発者は追加の列を使用して、基礎となる表のデータ・バージョンを追跡できます。データ・ロード・ウィザードでは、この列を使用して、別のユーザーが同時に同じデータを使用しているかどうかを確認し、エンド・ユーザーに伝えます。これは、定期的に更新される表にアップロードする場合に特に重要です。

- 複数のスプレッドシート列 - アップロードされるスプレッドシートに複数の列があり、開発者がその列を連結して1つの表の列にアップロードすることが必要な状況が数多くあります(スプレッドシートのFirstNameおよびLastNameをEMP表のENAMEにアップロードするなど)。

- 検証のスキップ - 検証ステップをスキップすることで、大量のレコードをアップロードする際のデータ・ロードのパフォーマンスを向上できます。何千ものレコードをアップロードする場合、エンド・ユーザーは、各レコードの検証に関心がないことがあります。各レコードが新規レコードとして挿入されることが確実な場合は、データ・ロード・プロセスで重複をチェックする必要はありません。

新たに生成されたデータ・ロード・ウィザードは4つのページで構成され、ユーザーはファイルからの、またはコピー・アンド・ペーストによるデータのアップロード、データおよび表のマッピングの定義、データの検証、および最終的な表へのデータのアップロードを行うことができます。開発者は後で、「共有コンポーネント」、「データ参照」、「データ・ロード定義」にアクセスして、表参照やデータ・トランスフォーメーション・ルールなどのデータ・ロード・ウィザードの定義を編集できます。

サポートされるデータ型

データ・ロード・ウィザードは、次のデータ型をサポートしています。

- VARCHAR2

- DATE

- TIMESTAMP

- NUMBER

サポートされないデータ型

データ・ロード・ウィザードは、次のデータ型をサポートしません。

- ラージ・オブジェクト(BLOBおよびCLOB)

- 複合型(XMLTYPEおよびSDO_GEOMETRY)

- CHAR

関連項目:

- 「データ・ロード・ウィザードの作成」

- 「データ・ロード定義の編集」

17.1.2 データ・ロード・ウィザードの作成

データ・ロード・ウィザードを作成するには、次のステップを実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「ページの作成」をクリックします。

4. 「ページの作成」で、次のステップを実行します。

a. ユーザー・インタフェース: ページのユーザー・インタフェースを選択します。

b. ページ・タイプの選択 - 「データのロード」を選択します。

5. 「データ・ロード表」で、次のステップを実行します。

a. 定義名 - このデータ・ロード定義の名前を入力します。

b. 所有者: データ・ロード表の所有者を選択します。

c. 表名: データのロードに使用する表を選択します。アップロード表とも呼ばれます。

d. 一意列1: データ・ロードの処理で一意の主キー列として使用する列名を選択します。少なくとも1つの一意のキー列が必要です。

e. 大/小文字区別 - 選択した一意キー列で大/小文字を区別するかどうかを指定します。デフォルトでは、これは「いいえ」に設定されます。

f. 一意列2 - データ・ロード表の一意キーの定義が、2つ以上の列から構成される複合キーの場合、データ・ロードの処理中に2番目の一意キーの列として使用される列名を選択します。

g. 大/小文字区別 - 選択した一意キー列で大/小文字を区別するかどうかを指定します。デフォルトでは、これは「いいえ」に設定されます。

h. 一意列3 - データ・ロード表の一意キーの定義が、2つ以上の列から構成される複合キーの場合、データ・ロードの処理中に3番目の一意キーの列として使用される列名を選択します。

i. 大/小文字区別 - 選択した一意キー列で大/小文字を区別するかどうかを指定します。デフォルトでは、これは「いいえ」に設定されます。

j. 「次へ」をクリックします。

6. トランスフォーメーション・ルールの追加(オプション)で、次を指定して「追加」をクリックします。

a. 列の選択: トランスフォーメーションが必要な列の名前を選択し、右側に移動します。

b. ルール名: このトランスフォーメーション・ルールの名前を入力します。

c. 順序: トランスフォーメーション・ルールの順序を指定します。これによって実行の順序が決まります。

d. タイプ: 実行するトランスフォーメーション・ルールのタイプを選択します。

e. 選択したトランスフォーメーション・タイプに基づいて追加の詳細を指定します。

f. 「トランスフォーメーションの追加」をクリックします。

7. 「表参照」(オプション)で、次のステップを実行します。

a. 列名 - 表参照定義の基礎とする列を指定します。

b. 参照表の所有者 - 参照表の所有者を選択します。

c. 参照表名 - この表参照定義に使用される表を指定します。

d. 戻り列: 表参照で戻される列の名前を選択します。この値は、指定されたロード列に挿入されるもので、通常、外部キー・リレーションシップの親のキー値です。

e. アップロード列 - エンド・ユーザーによって戻り列のかわりにアップロードされる列の名前を選択します。これは、参照表の表示値を含む列です

f. アップロード列2: 必要に応じて、戻り列を一意に識別するためにアップロードされる2番目の列の名前を選択します。

g. アップロード列3: 必要に応じて、戻り列を一意に識別するためにアップロードされる3番目の列の名前を選択します。

h. 「参照の追加」をクリックして参照定義を追加します。さらに表参照を追加するには、前の手順を繰り返します。

i. 「次へ」をクリックして、参照の作成を終了します。

8. 「ページ属性」で、必要に応じて、データ・ロード・ウィザードのページごとにデフォルトのページ名、ページ番号およびリージョン名を変更し、「次へ」をクリックします。

9. 「ナビゲーション・メニュー」で、このページに含めるナビゲーションのタイプを指定し、「次へ」をクリックします。ナビゲーション・オプションはカレント・アプリケーションのテーマに応じて決まります。

10. 「ボタンとブランチ」で、データ・ロード・ウィザードのページのボタンに使用するブランチを指定して、「作成」をクリックします。

11. 「ページの保存と実行」をクリックして、データ・ロード・ウィザードをテストします。

ヒント:

データ・ロード・ウィザード・ページの作成後、変更が必要な場合は、次の項で説明するように、データ・ロード定義を削除するのではなく、新規ページを再作成することをお薦めします。

関連項目:

- 「データ・ロード・ページの再作成」

- ページ・デザイナでのページの管理

17.1.3 データ・ロード・ページの再作成

データ・ロード・ウィザード・ページの変更が必要な場合は、データ・ロード定義を削除しないで、新規ページを再作成することをお薦めします。

データ・ロード定義を削除しないでデータ・ロード・ウィザード・ページを再作成するには、次のステップを実行します。

1. データ・ロード定義ページにナビゲートします。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。

b. アプリケーションを選択します。

c. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

共有コンポーネント・ページが表示されます。

d. 「データ参照」で、「データ・ロード定義」をクリックします。

2. 再作成するデータ・ロード定義をクリックします。

データ・ロード表の詳細ページが表示されます。

3. 「タスク」で、「データ・ロード・ページの再作成」をクリックします。

「データ・ロード・ウィザードの作成」のページ属性ページが表示されます。

4. ページごとに、該当する属性を編集し、「次へ」をクリックします。

属性の詳細は、フィールドレベル・ヘルプを参照してください。

5. 「確認」をクリックします。

17.1.4 データ・ロード定義の編集

データ・ロード定義は、アプリケーションのデータ・ロード・ウィザードで使用されるデータ・ロード表、表ルールおよび参照表で構成されます。データ・ロード表は、データをアップロードするデータ・ロード・プロセスで使用するために選択された、スキーマ内の既存の表です。

データ・ロード定義を編集するには、次のステップを実行します。

1. データ・ロード定義ページにナビゲートします。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。

b. アプリケーションを選択します。

c. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

共有コンポーネント・ページが表示されます。

d. 「データ参照」で、「データ・ロード定義」をクリックします。

2. 編集するデータ・ロード定義をクリックします。

データ・ロード表の詳細ページが表示されます。属性の詳細は、フィールドレベル・ヘルプを参照してください。

3. 「データ・ロード定義」で、次のように入力します。

- 名前 - データ・ロード定義の名前。

- データ・ロード表: データ・ロード表名を編集し、一意の列を追加、削除または編集します。

- 一意列1 - データ・ロードの処理で一意の主キー列として使用する列名。

- 大/小文字区別 - 選択した一意キー列1で大/小文字を区別するかどうかを指定します。デフォルトでは、これは「いいえ」に設定されます。

- 一意列2 - 選択した表の一意キーの定義が、2つ以上の列から構成される複合キーの場合、この列名が、データ・ロードの処理中に2番目の一意キーの列として使用されます。

- 大/小文字区別 - 選択した一意キー列2で大/小文字を区別するかどうかを指定します。デフォルトでは、これは「いいえ」に設定されます。

- 一意列3 - 選択した表の一意キーの定義が、2つ以上の列から構成される複合キーの場合、この列名が、データ・ロードの処理中に3番目の一意キーの列として使用されます。

- 大/小文字区別 - 選択した一意キー列3で大/小文字を区別するかどうかを指定します。デフォルトでは、これは「いいえ」に設定されます。

- 検証のスキップ - データ・ロードのステップの1つとして、アップロード対象のレコードに実行されるアクションを検証します。検証をスキップするには、「はい」を選択します。

4. 「トランスフォーメーション・ルール」には、以前定義したトランスフォーメーション・ルールがリストされます。

- 新規ルールを作成する手順は、次のとおりです。

a. 「トランスフォーメーション・ルールの作成」をクリックします。

b. 属性を編集します。
属性の詳細は、フィールドレベル・ヘルプを参照してください。

c. 「作成」をクリックします。

- 既存のルールを編集する手順は、次のとおりです。

a. ルール名をクリックします。

b. 属性を編集します。

c. 「変更の適用」をクリックします。

5. 表参照では、インポート・ファイルのデータを別の表にあるデータにマッピングします。

- 表参照を新規作成するには、次のステップを実行します。

a. 「表参照の作成」をクリックします。

b. 属性を編集します。

c. 「作成」をクリックします。

- 既存の表参照を編集するには、次のステップを実行します。

a. 列名をクリックします。

b. 属性を編集します。

c. 「変更の適用」をクリックします。

6. 列名の別名では、別名を定義して、ユーザーがアップロードする列を正しく識別できるようにします。

列名の別名を追加するには、次のステップを実行します。

a. 「LOVの編集」をクリックします。

b. 属性を編集します。

c. 「作成」をクリックします。

7. 「同時実行性列名」で、同時実効性管理に使用する列を選択します。

同時実行性により、開発者は、基礎となる表のデータ・バージョンを確認するための列を選択できます。これは、定期的に更新される表にアップロードする場合に特に重要です。

8. 「変更の適用」をクリックします。

17.2 コレクションの使用について

コレクションを使用すると、1つ以上の非スカラー値を一時的に取得できます。コレクションを使用して、現在セッション・ステートにある行および列を格納します。これによって、あるユーザーの特定のセッション中にそれらの行および列に対してアクセス、操作または処理を行うことができます。コレクションは、バケツのようなものと考えることができます。その中に情報の行を一時的に格納し、その情報を指定できます。

次に、コレクションを使用する場合の例を示します。

- データ入力ウィザードを作成しており、そのウィザードで、まず論理トランザクション中に複数行の情報を収集する必要がある場合。物理トランザクションと論理トランザクションの両方の完了時、ウィザードの最終ステップを実行する前に、コレクションを使用して、複数行の情報のコンテンツを一時的に格納できます。

- アプリケーションに、ユーザーが1つのページで複数の詳細行を更新する更新ページが含まれている場合。ユーザーは、複数の更新を行い、それらの更新をコレクションに適用した後、最終プロセスをコールしてそれらの変更をデータベースに適用できます。

- 任意の数の属性を収集するウィザードを構築している場合。コレクションに一時的に格納された情報が取得され、データベースに適用されるタスクをウィザードの最後にユーザーが実行するようにします。

コレクション情報は、PL/SQL API APEX_COLLECTIONを使用して挿入、更新および削除します。

関連項目:

『Oracle Application Express APIリファレンス』のAPEX_COLLECTIONに関する説明

17.3 Webサービスの実装

この項では、Oracle Application ExpressアプリケーションでWebサービスを使用する方法について説明します。

注意:

SOAP 1.1仕様はW3C技術ノートです。SOAPバージョン1.2仕様はW3C勧告です。

Simple Object Access Protocol(SOAP)については、次の場所を参照してください。

http://www.w3.org/TR/SOAP/

トピック:

- Webサービスについて

- Oracle Application ExpressのWebサービス参照の作成

- SSL有効Webサービスでの作業について

- WSDLに基づいたWebサービス参照の作成

- Webサービス参照の手動作成

- RESTful Webサービス参照の作成

- Webサービス参照リポジトリの使用

- Webサービスでの入力フォームとレポートの作成

- Webサービスでのフォームの作成

- Webサービスをプロセスとして起動する方法

- Webサービス・プロセスの編集

- Webサービス参照履歴の表示

- RESTful Webサービスとしてのレポート・リージョンの公開

17.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サービスを使用するためにネットワーク・サービスを有効にする必要があります。

RESTには、同様のメリットがあります。

- このプロトコルではHTTPプロトコルが使用されるため、RESTメッセージもファイアウォールでブロックされません。

- RESTリクエストではXMLエンベロープやSOAPエンベロープのオーバーヘッドが不要であり、入力は、通常、URI内に指定されます。

関連項目:

「Oracle Database 11g以上のネットワーク・サービスの有効化」

17.3.2 Oracle Application ExpressのWebサービス参照の作成

Oracle Application ExpressでWebサービスを使用するには、ウィザードを使用してWebサービス参照を作成します。Webサービス参照は、Web Services Description Language(WSDL)ドキュメントに基づくか、RESTfulスタイルに基づくか、サービスに関する情報を指定して手動で作成することができます。

トピック:

- Webサービス参照ページへのアクセス

- アプリケーション・プロキシ・サーバー・アドレスの指定

関連項目:

- 「WSDLに基づいたWebサービス参照の作成」

- 「Webサービス参照の手動作成」

- 「RESTful Webサービス参照の作成」

17.3.2.1 Webサービス参照ページへのアクセス

Webサービス参照は、Webサービス参照ページで管理します。

Webサービス参照ページにアクセスするには、次のステップを実行します。

1. 共有コンポーネント・ページにナビゲートします。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。

b. アプリケーションを選択します。

c. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

共有コンポーネント・ページが表示されます。

2. 「データ参照」で、「Webサービス参照」をクリックします。

Webサービス参照ページが表示されます。

17.3.2.2 アプリケーション・プロキシ・サーバー・アドレスの指定

インターネットのアクセスにプロキシ・サーバーが必要な環境の場合は、Webサービス参照を作成する前にアプリケーション属性ページでプロキシ・サーバー・アドレスを指定するか、インスタンス管理者がインスタンス・プロキシを定義する必要があります。

アプリケーションにプロキシ・アドレスを指定するには、次のステップを実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

アプリケーション・ビルダーのホームページが表示されます。

2. アプリケーションを選択します。

アプリケーションのホームページが表示されます。

3. 「アプリケーション・プロパティの編集」をクリックします。

4. 「プロパティ」の下の「プロキシ・サーバー」フィールドにプロキシ・サーバーを入力します。

5. 「変更の適用」をクリックします。

17.3.3 SSL有効Webサービスでの作業について

Secure Sockets Layer(SSL)は、RSA公開鍵による暗号化と対称鍵による暗号化を使用して、認証、暗号化およびデータの整合性を実現する業界標準プロトコルです。

通信する必要のあるWebサービスがSSL有効Webサービスの場合(つまり、Webサービスに対するURLにhttpsと表示される)、ウォレットを作成し、そのウォレットがOracle Application Expressによって使用されるように構成する必要があります。ウォレットは、SSLに必要な認証および署名された資格証明(秘密鍵、証明書および信頼できる証明書)の格納に使用されるパスワード保護されたコンテナです。

関連項目:

Oracle Application Express管理ガイドの「ウォレット情報の構成」

17.3.4 WSDLに基づいたWebサービス参照の作成

この項では、WSDLに基づいたWebサービス参照を作成する方法について説明します。

トピック:

- WSDLに基づいたWebサービス参照の作成について

- WSDLドキュメントの指定によるWebサービス参照の作成

- WSDLから作成されたWebサービス参照のテスト

17.3.4.1 WSDLに基づいたWebサービス参照の作成について

WSDLに基づいてWebサービス参照を作成する前に、WSDLの位置の特定方法を決定する必要があります。WSDLドキュメントにURLを入力して、WSDLの位置を特定します。

WSDLに基づいてWebサービス参照を作成する場合、ウィザードはWSDLを分析し、すべての必要な情報を収集して、次を含んだ有効なSOAPメッセージを作成します。

- HTTP(S)を介したSOAPリクエストのポストに使用するURL

- SOAP HTTPリクエストを識別するUniversal Resource Identifier(URI)

- Webサービスの操作

- 各操作の入力パラメータ

- 各操作の出力パラメータ

17.3.4.2 WSDLドキュメントの指定によるWebサービス参照の作成

特定のWSDLドキュメントへのURLを指定して、Webサービスを作成するには、次のステップを実行します。

1. 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サービス参照のフォームとレポートを作成する場合に選択します。

関連項目:

- 「Webサービス参照ページへのアクセス」

- 「参照を作成した後のフォームの作成」

- 「参照を作成した後のフォームとレポートの作成」

17.3.4.3 WSDLから作成されたWebサービス参照のテスト

Webサービス参照を作成した後、Webサービス参照のテスト・ページでテストできます。

Webサービス参照をテストするには、次のステップを実行します。

1. Webサービス参照ページにナビゲートします。

2. 「レポートの表示」アイコンを選択します。

3. テストするWebサービス参照の「テスト」アイコンをクリックします。

Webサービス参照のテスト・ページが表示されます。ページの上部に、Webサービス名とURLエンドポイントが表示されます。

4. 「操作」から、実行する操作を選択します。

5. 「入力パラメータ」で、適切な値を入力します。

6. 「テスト」をクリックします。

ページの下部の「メッセージ」の下に、メッセージ・リクエストとレスポンスが表示されます。

関連項目:

「Webサービス参照ページへのアクセス」

17.3.5 Webサービス参照の手動作成

この項では、Webサービス参照を手動で作成する方法について説明します。

トピック:

- Webサービス参照の手動作成について

- Webサービス参照の手動作成

- 手動作成されたWebサービス参照のテスト

17.3.5.1 Webサービス参照の手動作成について

手動でWebサービス参照を作成する場合、必要な情報を指定して、次を含んだ有効なSOAPリクエストを作成します。

- HTTP(S)を介したSOAPリクエストのポストに使用するURL

- SOAP HTTPリクエストを識別するUniversal Resource Identifier(URI)

- アイテムの置換を含んだリクエストのSOAPエンベロープ

- オプションで、Webサービスからのレスポンスを格納するコレクション名

17.3.5.2 Webサービス参照の手動作成

Webサービス参照を手動作成するには、次のステップを実行します。

Webサービス参照がWebサービス参照リポジトリに追加されます。

1. Webサービス参照ページにナビゲートします。

2. 「作成」をクリックします。

3. 「手動」を選択し、「次へ」をクリックします。

Webサービスの作成/編集ページが表示されます。

4. 「Webサービス」の下の「名前」で、参照を識別するための名前を入力します。

5. 「サービスの説明」で、次の変更を行います。

a. URL: HTTPを介したSOAPリクエストのポストに使用するURLを入力します。これは、WSDLのサービス・ポートのsoap:addressの位置に対応します。

b. アクション: SOAP HTTPリクエストの目的を入力します(オプション)。値は目的を識別するURIです。SOAPは、URIの形式や特性、または変換可能かどうかについて制限を加えません。

c. プロキシ: このサービスのアプリケーション・プロキシを上書きするプロキシを入力します。

d. SOAPのバージョン: 「1.1」または「1.2」を選択します。

e. Basic認証: Webサービスが認証を必要とするかどうかを選択します。「はい」または「いいえ」を選択します。

6. 「SOAPエンベロープ」の下の「SOAPエンベロープ」で、WebサービスへのSOAPリクエストに使用するSOAPエンベロープを入力します。

注意:

#ITEM_NAME#構文を使用すると、SOAPエンベロープのセッション・ステートからアイテムを参照できます。

7. 「SOAPレスポンス」の下の「コレクションにレスポンスを格納」で、レスポンスを格納するコレクション名を入力します(オプション)。レスポンスはCLOB001列に格納されます。

8. 「作成」をクリックします。

関連項目:

「Webサービス参照ページへのアクセス」

17.3.5.3 手動作成されたWebサービス参照のテスト

Webサービス参照を作成した後、Webサービス参照のテスト・ページでテストできます。

Webサービス参照をテストするには、次のステップを実行します。

1. Webサービス参照ページにナビゲートします。

2. 「レポートの表示」アイコンを選択します。

3. テストするWebサービス参照の「テスト」アイコンをクリックします。

Webサービス参照のテスト・ページが表示されます。ページの上部に、Webサービス名とURLエンドポイントが表示されます。

4. 必要に応じて、「Basic認証」でユーザー名およびパスワードを入力します。

5. 「SOAPエンベロープ」テキスト領域では、オプションで、SOAPリクエスト・エンベロープを編集します。

6. 「テスト」をクリックします。

ページの下部の「メッセージ」の下に、メッセージ・リクエストとレスポンスが表示されます。

関連項目:

「Webサービス参照ページへのアクセス」

17.3.6 RESTful Webサービス参照の作成

この項では、RESTful Webサービス参照を作成する方法について説明します。

トピック:

- RESTful Webサービス参照の作成について

- RESTful Webサービス参照の作成

- REST Webサービス参照のテスト

17.3.6.1 RESTful Webサービス参照の作成について

RESTful Webサービス参照を作成する場合、次を含むリクエストおよびレスポンスの構造に関する必要な情報を指定します。

- RESTfulリクエストを識別するUniversal Resource Identifier(URI)

- Webサービスのメソッドを識別するHTTPメソッド

- リクエストの一部であるHTTPヘッダー(必要に応じて)

- Webサービスに必要な入力のタイプ

- レスポンスの書式およびレスポンス・パラメータの識別方法

17.3.6.2 RESTful Webサービス参照の作成

RESTful Webサービス参照を作成するには、次のステップを実行します。

1. Webサービス参照ページにナビゲートします。

2. 「作成」をクリックします。

3. 「REST」を選択して「次へ」をクリックします。

4. 「RESTの詳細」で、次のように指定します。

a. 名前: 参照を識別する名前を入力します。

b. URL: WebサービスのURLエンドポイントを入力します。

c. プロキシ: このサービスのアプリケーション・プロキシを上書きするプロキシを入力します(オプション)。この設定は、このインスタンスのプロキシ設定によってオーバーライドされます。

d. HTTPメソッド: Webサービスへのリクエストに使用するhttpメソッドを選択します。「GET」、「HEAD」、「POST」、「PUT」または「DELETE」を選択します。

e. 基本認証: HTTP基本認証が必要な場合は「はい」を選択します。それ以外の場合は、「いいえ」を選択します。

f. REST HTTPヘッダー: リクエストで送信するHTTPヘッダーの名前を入力します。

g. 「次へ」をクリックします。

5. 「REST入力パラメータ」で、次のように指定します。

a. 名前: メソッドに必要な入力パラメータの名前を入力します。

b. タイプ: 入力タイプを選択します。

c. 「パラメータの追加」をクリックします。

d. 必要な各入力に対して、ステップaからcを繰り返します。

e. 「次へ」をクリックします。

6. 「REST出力パラメータ」で、次のように指定します。

a. 出力形式: Webサービスから返されるレスポンス形式について「XML」、「テキスト」または「JSON」を選択します。

b. 出力パラメータへのXPath(XMLのみ): レスポンスの関連部分へのXPath式を入力します。

次に例を示します。

/ListBucketResult/Contents

c. レスポンス・ネームスペース(XMLのみ): レスポンスXPathに対応する名前空間を入力します。

次に例を示します。

http://s3.amazonaws.com/doc/2006-03-01/

d. パラメータ・デリミタ(テキストのみ): Webサービスから返されるパラメータを区切る文字または順序を入力します。新しい行を表すには\nを、タブ文字を表すには\tを使用します。

e. 新規レコード・デリミタ(テキストのみ): Webサービスからのテキスト・レスポンスに含まれる新規レコードを特定する文字または順序を入力します。新しい行を表すには\nを、タブ文字を表すには\tを使用します。

f. 名前: メソッドによって戻される出力パラメータの名前を入力します。

g. パス: パスを入力します。レスポンスがXMLの場合、パスはノードへのXPath式です。レスポンスがテキストの場合、パスは数値です。レスポンスがJSONの場合は、指定したコレクションのCLOB001列にレスポンス全体が格納されます。

h. タイプ: 出力タイプを選択します。

i. 「パラメータの追加」をクリックします。

j. 返される各出力パラメータに対して、ステップfからhを繰り返します。

注意:

「テスト」をクリックしてRESTful Webサービスにリクエストを送信し、レスポンスを確認します。このテスト・プロセスは、適切な出力パラメータを指定する際に役立ちます。

7. 「作成」をクリックします。

Webサービス参照の作成成功ページが表示されます。Webサービス参照がWebサービス参照リポジトリに追加されます。

関連項目:

- 「Webサービス参照ページへのアクセス」

- 『Oracle Application Express管理ガイド』のインスタンス用のプロキシ・サーバーの作成に関する項

17.3.6.3 REST Webサービス参照のテスト

Webサービス参照を作成した後、Webサービス参照のテスト・ページでテストできます。

Webサービス参照をテストするには、次のステップを実行します。

1. Webサービス参照ページにナビゲートします。

2. 「レポートの表示」アイコンを選択します。

3. テストするWebサービス参照の「テスト」アイコンをクリックします。

Webサービス参照のテスト・ページが表示されます。ページの上部に、Webサービス名とURLエンドポイントが表示されます。

4. 「URL」および「プロキシ・オーバーライド」フィールドで、オプションでテストの値を編集します。

5. 必要に応じて、「Basic認証」でユーザー名およびパスワードを入力します。

6. 「HTTPヘッダー」で、適切な値を入力します。

7. 「入力パラメータ」で、適切な値を入力します。

8. 「テスト」をクリックします。

ページの下部の「メッセージ」の下に、メッセージのレスポンスが表示されます。

関連項目:

「Webサービス参照ページへのアクセス」

17.3.7 Webサービス参照リポジトリの使用

Webサービス参照がWebサービス参照リポジトリに格納されます。

Webサービス参照リポジトリにアクセスするには、次のステップを実行します。

1. Webサービス参照ページにナビゲートします。

Webサービス参照ページが表示されます。

検索バーがページの上部に表示されます。使用可能なコントロールは次のとおりです。

- 「列の検索」アイコン: 虫めがねに似ています。このアイコンをクリックして、検索を絞り込みます。すべての列を検索するには、「すべての列」を選択します。

- テキスト領域: 大/小文字を区別しない検索基準(ワイルドカード文字を含む)を入力し、「実行」をクリックします。

- 「実行」ボタン: 検索を実行したり、フィルタを適用します。

- アイコンの表示: 各Webサービス参照を大きいアイコンとして表示します。Webサービス参照を編集するには、該当するアイコンをクリックします。

- レポートの表示: 各Webサービス参照をレポート内の1行として表示します。

- アクション・メニュー: アクション・メニューを表示します。レポート・ビューをカスタマイズするにはこのメニューを使用します。

2. 「レポートの表示」アイコンをクリックします。

3. レポート・ビューでは、次の操作が可能です。

- 参照名をクリックして参照を編集します。

- 「テスト」アイコンをクリックして参照をテストします。

- 「ビュー」アイコンをクリックして参照に関する詳細を表示します。このオプションは、手動作成されたWebサービス参照またはREST Webサービス参照には使用できないことに注意してください。

関連項目:

- 「Webサービス参照ページへのアクセス」

- 「アクション」メニューについて

17.3.8 Webサービスでの入力フォームとレポートの作成

この項では、Webサービスの入力フォームとレポートを作成する方法について説明します。

トピック:

- Webサービスのフォームとレポートの作成ウィザードについて

- 参照を作成した後のフォームとレポートの作成

- 新しいページの追加によるフォームとレポートの作成

17.3.8.1 Webサービスのフォームとレポートの作成ウィザードについて

Webサービスのフォームとレポートの作成ウィザードでは、入力フォーム、送信ボタンおよび結果を表示するレポートが作成されます。WSDLまたはRESTfulスタイルWebサービスからWebサービス参照を作成した直後に、またはページを追加して、このウィザードを実行できます。

このウィザードは、Webサービスの結果が非スカラーであることが予想される場合に使用します。Amazon社のProduct API Webサービスがよい例です。このWebサービスでは、入力フォームに入力された検索基準に基づいて多くの結果が戻されます。

17.3.8.2 参照を作成した後のフォームとレポートの作成

Webサービス参照を作成した後に、フォームとレポートを作成するには、次のステップを実行します。

1. Webサービス参照を作成します。

2. Webサービス参照が追加された後で、「Webサービスのフォームとレポートの作成」を選択します。

3. 「サービスと操作の選択」で、次の選択を行い、「次へ」をクリックします。

a. Webサービス参照: Webサービス参照を選択します。

b. 操作: 実行方法を選択します。RESTスタイルWeb参照の場合、「doREST」を選択します。

c. ユーザー・インタフェース: デスクトップ用のフォームとレポートを作成する場合は、「デスクトップ」を選択します。携帯電話用のフォームとレポートを作成する場合は、「jQuery Mobileスマートフォン」を選択します。「jQuery Mobileスマートフォン」オプションは、アプリケーション・プロパティのユーザー・インタフェース・オプションで「jQuery Mobileスマートフォン」が選択されている場合にのみ使用可能です。

4. 「ページおよびリージョン属性」で、表示された属性を確認し、「次へ」をクリックします。

注意:

指定したページが存在しない場合は、ウィザードによってページが作成されます。

5. 「入力アイテム」で、次の選択を行い、「次へ」をクリックします。

a. フォームに追加するアイテムを指定します。アイテムを含めるには、「作成」列で「はい」を選択します。それ以外の場合は、「いいえ」を選択します。

b. 必要に応じて、アイテム名を編集します。

c. 必要に応じて、アイテム・ラベルを編集します。

6. 該当する場合、Basic認証に「アイテム名」および「アイテム・ラベル」を指定して「次へ」をクリックします。

注意:

このステップは、Webサービス参照を作成したときに、Basic認証がこのWebサービス参照に対して指定された場合にのみ表示されます。

7. ウィンドウ・サービスの結果で、次の選択を行い、「次へ」をクリックします。

a. 一時結果セット名: Webサービスの結果を格納するコレクションの名前を入力します。

b. レポート対象の結果ツリー(RESTスタイルWebサービス参照では表示されない): レポートに含める情報を格納する、作成されるXML文書の一部を選択します。

8. 「レポート・パラメータ」で、レポートに含めるパラメータを選択し、「次へ」をクリックします。

9. 「タブ・オプション」で、ページにタブを含めるかどうかとタブの作成方法を選択し、「次へ」をクリックします。

10. 確認ページを確認して、「作成」をクリックします。

関連項目:

- 「WSDLに基づいたWebサービス参照の作成」

- 「RESTful Webサービス参照の作成」

17.3.8.3 新しいページの追加によるフォームとレポートの作成

既存のWebサービス参照がある場合は、新しいページを追加して、入力フォームとレポートを作成できます。

新しいページを追加して、フォームとレポートを作成するには、次のステップを実行します。

1. Webサービス参照を作成します。

2. 新しいページを作成します。

「ページの作成」ウィザードで、次のステップを実行します。

a. 「ユーザー・インタフェース」で、「デスクトップ」を選択して、デスクトップのフォームおよびレポートを作成します。携帯電話用のフォームとレポートを作成する場合は、「jQuery Mobileスマートフォン」を選択します。「jQuery Mobileスマートフォン」オプションは、アプリケーション・プロパティのユーザー・インタフェース・オプションで「jQuery Mobileスマートフォン」が選択されている場合にのみ使用可能です。

b. 「フォーム」を選択して、「次へ」をクリックします。

c. 「Webサービスのフォームとレポート」を選択し、「次へ」をクリックします。

3. 「サービスと操作の選択」で、次の選択を行い、「次へ」をクリックします。

a. Webサービス参照: Webサービス参照を選択します。

b. 操作: 実行方法を選択します。RESTfulスタイルWeb参照の場合、doRESTが自動的に選択されます。手動スタイルWeb参照については、「操作」オプションは表示されません。

4. 「ページおよびリージョン属性」で、ページおよびリージョンの属性を確認し、「次へ」をクリックします。

注意:

指定したページが存在しない場合は、ウィザードによってページが作成されます。

5. 「入力アイテム」で、次の選択を行い、「次へ」をクリックします。

a. フォームに追加するアイテムを指定します。アイテムを含めるには、「作成」列で「はい」を選択します。それ以外の場合は、「いいえ」を選択します。

b. 必要に応じて、アイテム名を編集します。

c. 必要に応じて、アイテム・ラベルを編集します。

6. 該当する場合、Basic認証に「アイテム名」および「アイテム・ラベル」を指定し、「次へ」をクリックします。

注意:

このステップは、Webサービス参照を作成したときに、Basic認証がこのWebサービス参照に対して指定された場合にのみ表示されます。

7. 画面に表示されるステップに従います。

8. 「終了」をクリックします。

関連項目:

- 「WSDLに基づいたWebサービス参照の作成」

- 「Webサービス参照の手動作成」

- 「RESTful Webサービス参照の作成」

17.3.9 Webサービスでのフォームの作成

この項では、Webサービスのフォームを作成する方法について説明します。

トピック:

- Webサービスのフォームの作成ウィザードについて

- 参照を作成した後のフォームの作成

- 新しいページの追加によるフォームの作成

17.3.9.1 Webサービスのフォームの作成ウィザードについて

Webサービスのフォームの作成ウィザードでは、フォームと送信ボタンが作成されます。WSDLから、またはRESTfulスタイルのWebサービスで、Webサービス参照を作成した後に、またはページの作成ウィザードを実行することで、このウィザードを実行できます。

このウィザードは、Webサービスの結果がスカラーであることが予想される場合に使用します。株価を調べるWebサービスがよい例です。入力は銘柄記号で、出力はスカラーの適正価格であるためです。

17.3.9.2 参照を作成した後のフォームの作成

Webサービス参照を作成した後に、フォームを作成するには、次のステップを実行します。

1. Webサービス参照を作成します。

2. Webサービス参照が追加された後で、「Webサービスのフォームの作成」を選択します。

3. 「サービスと操作の選択」で、次の選択を行い、「次へ」をクリックします。

a. Webサービス参照: Webサービス参照を選択します。

b. 操作: 実行方法を選択します。RESTfulスタイルWeb参照の場合、doRESTが自動的に選択されます。手動スタイルWeb参照については、「操作」オプションは表示されません。

c. ユーザー・インタフェース: デスクトップ用のフォームとレポートを作成する場合は、「デスクトップ」を選択します。携帯電話用のフォームとレポートを作成する場合は、「jQuery Mobileスマートフォン」を選択します。「jQuery Mobileスマートフォン」オプションは、アプリケーション・プロパティのユーザー・インタフェース・オプションで「jQuery Mobileスマートフォン」が選択されている場合にのみ使用可能です。

4. 「ページおよびリージョン属性」で、ページおよびリージョンの属性を確認し、「次へ」をクリックします。

注意:

指定したページが存在しない場合は、ウィザードによってページが作成されます。

5. 「入力アイテム」で、次の選択を行い、「次へ」をクリックします。

a. フォームに追加するアイテムを指定します。アイテムを含めるには、「作成」列で「はい」を選択します。それ以外の場合は、「いいえ」を選択します。

b. 必要に応じて、アイテム名を編集します。

c. 必要に応じて、アイテム・ラベルを編集します。

6. 該当する場合、Basic認証に「アイテム名」および「アイテム・ラベル」を指定して「次へ」をクリックします。

注意:

このステップは、Webサービス参照を作成したときに、Basic認証がこのWebサービス参照に対して指定された場合にのみ表示されます。

7. 該当する場合、Basic認証に「アイテム名」および「アイテム・ラベル」を指定します。

このステップは、Webサービス参照を作成したときに、Basic認証がこのWebサービス参照に対して指定された場合にのみ表示されることに注意してください。

8. 「出力アイテム」で、次の選択を行い、「次へ」をクリックします。

a. フォームに追加するアイテムを指定します。アイテムを含めるには、「作成」列で「はい」を選択します。それ以外の場合は、「いいえ」を選択します。

b. 必要に応じて、アイテム名を編集します。

c. 必要に応じて、アイテム・ラベルを編集します。

9. 「タブ・オプション」で、ページにタブを含めるかどうかとタブの作成方法を選択し、「次へ」をクリックします。

10. 確認ページを確認して、「作成」をクリックします。

関連項目:

- 「WSDLに基づいたWebサービス参照の作成」

- 「Webサービス参照の手動作成」

- 「RESTful Webサービス参照の作成」

- アプリケーションのユーザー・インタフェースの管理

17.3.9.3 新しいページの追加によるフォームの作成

既存のWebサービス参照がある場合は、新しいページを追加することで、Webサービス参照を基にフォームを作成できます。

新しいページを追加して、フォームを作成するには、次のステップを実行します。

1. Webサービス参照を作成します。

2. 新しいページを作成します。

「ページの作成」ウィザードで、次のステップを実行します。

a. 「ユーザー・インタフェース」で、「デスクトップ」を選択して、デスクトップのフォームおよびレポートを作成します。携帯電話用のフォームとレポートを作成する場合は、「jQuery Mobileスマートフォン」を選択します。「jQuery Mobileスマートフォン」オプションは、アプリケーション・プロパティのユーザー・インタフェース・オプションで「jQuery Mobileスマートフォン」が選択されている場合にのみ使用可能です。

b. 「フォーム」を選択して、「次へ」をクリックします。

c. 「Webサービスのフォーム」を選択し、「次へ」をクリックします。

3. 「サービスと操作の選択」で、次の選択を行い、「次へ」をクリックします。

a. Webサービス参照: Webサービス参照を選択します。

b. 操作: 実行方法を選択します。RESTfulスタイルWeb参照の場合、doRESTが自動的に選択されます。手動スタイルWeb参照については、「操作」オプションは表示されません。

4. 「ページおよびリージョン属性」で、ページおよびリージョンの属性を確認し、「次へ」をクリックします。

注意:

指定したページが存在しない場合は、ウィザードによってページが作成されます。

5. 「入力アイテム」で、次の選択を行い、「次へ」をクリックします。

a. フォームに追加するアイテムを指定します。アイテムを含めるには、「作成」列で「はい」を選択します。それ以外の場合は、「いいえ」を選択します。

b. 必要に応じて、アイテム名を編集します。

c. 必要に応じて、アイテム・ラベルを編集します。

6. 該当する場合、Basic認証に「アイテム名」および「アイテム・ラベル」を指定して「次へ」をクリックします。

注意:

このステップは、Webサービス参照を作成したときに、Basic認証がこのWebサービス参照に対して指定された場合にのみ表示されます。

7. 該当する場合、Basic認証に「アイテム名」および「アイテム・ラベル」を指定します。

このステップは、Webサービス参照を作成したときに、Basic認証がこのWebサービス参照に対して指定された場合にのみ表示されることに注意してください。

8. 「出力アイテム」で、次の選択を行い、「次へ」をクリックします。

a. フォームに追加するアイテムを指定します。アイテムを含めるには、「作成」列で「はい」を選択します。それ以外の場合は、「いいえ」を選択します。

b. 必要に応じて、アイテム名を編集します。

c. 必要に応じて、アイテム・ラベルを編集します。

9. 「タブ・オプション」で、ページにタブを含めるかどうかとタブの作成方法を選択し、「次へ」をクリックします。

10. 確認ページを確認して、「作成」をクリックします。

関連項目:

- 「WSDLに基づいたWebサービス参照の作成」

- 「Webサービス参照の手動作成」

- 「Webサービス参照の手動作成」

- データベース・アプリケーションのページの管理

- アプリケーションのユーザー・インタフェースの管理

17.3.10 Webサービスをプロセスとして起動する方法

Webサービスをページ上でプロセスとして起動することもできます。Webサービス用のいずれかのフォームの作成ウィザードを実行すると、プロセスが作成されます。このプロセスを実行すると、リクエストがサービス・プロバイダに送信されます。その後で、レポートにリクエスト結果を表示できます。

トピック:

- プロセスとしてのWebサービスの起動

- レポートでのWebサービス結果の表示

17.3.10.1 プロセスとしてのWebサービスの起動

Webサービスをプロセスとして起動するには、次のステップを実行します。

1. Webサービス参照を作成します。WSDLに基づいたWebサービス参照の作成、Webサービス参照の手動作成またはRESTful Webサービス参照の作成を参照してください。

2. ページを作成します

「ページの作成」ウィザードで、次のステップを実行します。

a. 「空白ページ」を選択します。

b. ナビゲーション・メニューを使用するかどうかを尋ねるプロンプトが表示された場合は、「いいえ」を選択します。

3. 「ページの編集」をクリックします。

4. 「ページ・レンダリング」または「ページ・プロセス」で、「プロセス」セクションを探し、右クリックして「プロセスの作成」をクリックします。

ページ・プロセスの作成ウィザードが表示されます。

5. 「プロセス・タイプ」で、「Webサービス」を選択して「次へ」をクリックします。

6. 「プロセス属性」で、次のように指定し、「次へ」をクリックします。

a. 名前: プロセス名を入力します。

b. 順序: このコンポーネントの順序を入力します。これによって評価の順序が決まります。

c. ポイント: プロセス・ポイントを選択します。

7. 「プロセス」で、次のように指定します。

a. Webサービス参照: このプロセスのWebサービス参照を選択します。

Web参照がWSDLから作成されたか、またはRESTfulスタイルである場合、「操作」の選択が表示されます。

b. 操作(WSDLまたはRESTfulスタイルWebサービス参照のみ): このプロセスが実行するWebサービス操作を選択します。

「Webサービスの入力パラメータ」と「Webサービスの出力パラメータ」が表示されます。

c. 「Webサービスの入力パラメータ」で、Webサービス・プロセスの入力を指定します。

- ソース: ソース・タイプを選択します。

- 値: ソース値を選択します。

d. 「Webサービスの出力パラメータ」で、結果の格納先を指定します。

コレクションに結果を格納するには、次のステップを実行します。

- 結果の格納場所: 「コレクション」を選択します。

- 値: コレクションの名前を入力します。

ページ上のアイテムに結果を格納するには、次のステップを実行します。

- 結果の格納場所: 「アイテム」を選択します。

- 値: 適切なアイテム値を選択します。

e. 「次へ」をクリックします。

8. 「メッセージ」で、次を入力し、「次へ」をクリックします。

a. 成功メッセージ: プロセスが正常に実行された場合に次のページに表示されるメッセージを入力します。

b. 失敗メッセージ: 未処理例外が発生した場合に表示されるメッセージを入力します。エラー・プロセスが停止した後は、常にロールバックが実行され、エラー・メッセージが表示されます。

9. 「プロセス条件」で、次の選択を行い、「次へ」をクリックします。

a. 対象ボタン: プロセスを実行させるボタンを選択します。

b. 条件タイプ: このコンポーネントを処理するために満たされる必要がある条件タイプを選択します。条件タイプに比較用の式が必要な場合、「式1」と、場合によっては「式2」フィールドが表示されます。必要に応じてこれらのフィールドに式を入力します。

10. 「プロセスの作成」をクリックします。

関連項目:

- データベース・アプリケーションのページの管理

- レガシー・コンポーネント・ビューでのページ属性へのアクセス

17.3.10.2 レポートでのWebサービス結果の表示

Webサービスのリクエスト結果を表示するレポートを作成するには、次のステップを実行します。

1. ページに移動します。

2. コンポーネント・ビューで、「リージョン」に対して「作成」アイコンをクリックします。

「リージョンの作成」ウィザードが表示されます。

3. リージョン・タイプで、「レポート」を選択し、「次へ」をクリックします。

4. 「リージョン」で、「Webサービスの結果」を選択し、「次へ」をクリックします。

5. 「表示属性」で、リージョン・タイトルを入力し、オプションでリージョン属性を編集し、「次へ」をクリックします。

6. Web参照がWSDLから手動で作成されたか、またはRESTfulスタイルであるかを選択し、「次へ」をクリックします。

7. Webサービス参照がWSDLから作成された場合、次のステップを実行します。

a. 「Webサービス参照」で、実行するWebサービス参照を選択します。

b. 「操作」で、実行するメソッドを選択します。

c. 「レポート対象の結果ツリー」で、作成されるXML文書(レポートに含める情報を含む)の一部を選択します。

d. 「レポート・パラメータとレポート・オプション」で、次を行います。

- 「一時結果セット名」に、Webサービスの結果を格納するコレクションの名前を入力します。

- 該当するパラメータを選択した後、選択解除します。

8. Webサービス参照が手動で作成された場合、次のステップを実行します。

a. Webサービス参照を選択します。

b. SOAPスタイルを選択します。

c. メッセージの書式を選択します。

d. レポートの対象となるノードへのXPath式を入力します。

e. SOAPレスポンス・エンベロープのネームスペースを入力し、「次へ」をクリックします。

f. レスポンス・メッセージが格納されているコレクション名を入力します。

g. レポートに含めるパラメータ名を入力します。

9. Webサービス参照がRESTスタイルの場合、次のステップを実行します。

a. Webサービス参照を選択します。

b. レスポンス・メッセージが格納されているコレクション名を入力します。

c. レポート・テンプレートと、ページごとに表示される行数を選択します。

d. レポートに含めるパラメータを選択します。

10. 「SQLレポートの作成」をクリックします。

関連項目:

「レガシー・コンポーネント・ビューでのページの表示」

17.3.11 Webサービス・プロセスの編集

WSDLから作成されたWebサービス参照またはRESTfulスタイルのWeb参照でWebサービス・タイプのプロセスを作成した後、サービスへの入力パラメータおよび出力パラメータの属性を変更できます。

Webサービス・プロセスを編集するには、次のステップを実行します。

1. Webサービス・プロセスを作成します。

2. Webサービス・プロセスが含まれているページにナビゲートします。

3. プロセス名を選択します。

「ページ・プロセスの編集」ページが表示されます。

4. 入力パラメータを静的な値にマップするには、次のステップを実行します。

a. 「Webサービスの入力パラメータ」までスクロールします。

b. 該当するパラメータ名の横にある「値」フィールドに値を入力します。

5. 出力パラメータをコレクションにマップするには、次のステップを実行します。

a. 「Webサービスの出力パラメータ」までスクロールします。

b. レスポンスの格納場所で、「コレクション」を選択します。

c. 「値」で、レスポンスを格納するコレクションの名前を入力します。レスポンスは、予想されるレスポンスに基づいてCLOB001またはXMLTYPE001に格納されます。

6. 出力パラメータをアイテムにマップするには、次のステップを実行します。

a. 「Webサービスの出力パラメータ」までスクロールします。

b. レスポンスの格納場所で、「アイテム」を選択します。

c. 該当するパラメータ名の横にある「値」フィールドにアイテム名を入力します。

7. 「変更の適用」をクリックします。

関連項目:

「Webサービスをプロセスとして起動する方法」

17.3.12 Webサービス参照履歴の表示

「Webサービス履歴」では、カレント・アプリケーションのWebサービス参照の変更が、アプリケーションID、Webサービス参照名、開発者および日付ごとに表示されます。

Webサービス参照の変更履歴を表示するには、次のステップを実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

共有コンポーネント・ページが表示されます。

4. 「ロジック」で、「Webサービス参照」をクリックします。

5. 「履歴」をクリックします。

注意:

Webサービス参照ページに「履歴」ボタンが表示されるのは、1つ以上の参照が存在する場合のみです。

17.3.13 RESTful Webサービスとしてのレポート・リージョンの公開

この項では、レポート・リージョンをRESTful Webサービスとして公開する方法について説明します。

トピック:

- RESTful Webサービスとしてのレポート・リージョンの公開について

- レポート・リージョンへのRESTfulアクセスの有効化

- Webサービス・クライアントからのRESTful有効レポート・リージョンへのアクセスについて

関連項目:

『Oracle Application Express SQLワークショップ・ガイド』のRESTfulサービスの使用に関する説明を参照してください。

17.3.13.1 RESTful Webサービスとしてのレポート・リージョンの公開について

RESTful Webサービスとしてレポート・リージョンを公開するには、次のステップを実行します。

- ステップ1: インスタンス管理者は、インスタンス設定のRESTプロバイダ機能を有効化する必要があります。

- ステップ2: 開発者はレポート・リージョンへのRESTfulアクセスを有効化する必要があります。

- ステップ3: レポートが格納されているページでは、認証が要求されないようにする必要があります。

関連項目:

- 『Oracle Application Express管理ガイド』のRESTfulアクセスの有効化に関する項

- 「レポート・リージョンへのRESTfulアクセスの有効化」

17.3.13.2 レポート・リージョンへのRESTfulアクセスの有効化

レポート・リージョンへのRESTfulアクセスを有効化するには、認証が不要になるようにページを公開し、レポートをRESTfulアクセスのために有効化する必要があります。

ヒント:

Oracle Application ExpressインスタンスへのRESTfulアクセスを有効化するには、『Oracle Application Express管理ガイド』のRESTfulアクセスの有効化に関する説明を参照してください。

レポート・リージョンへのRESTfulアクセスを有効化するには、次のステップを実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。

アプリケーション・ビルダーのホームページが表示されます。

2. アプリケーションを選択します。

3. 有効化するレポートを含むページをコンポーネント・ビューで表示します。

4. ページを公開するには、次のステップを実行します。

a. 「ページ」で、「すべて編集」アイコンをクリックします。

b. 「セキュリティ」で、「認証」リストから「パブリック・ページ」を選択します。

c. 「変更の適用」をクリックします。

5. レポート・リージョンをRESTfulアクセス用に有効化するには、次のステップを実行します。

a. 「リージョン」で、有効化するレポートが格納されているリージョンの名前をクリックします。

b. 「属性」で、「静的ID」フィールドの値を入力します。この値はレポートにRESTfulにアクセスするために使用されます。

c. 「RESTfulアクセスの有効化」リストで、「はい」を選択します。

注意:

「RESTfulアクセスの有効化」リスト・オプションは、このOracle Application ExpressインスタンスへのRESTfulアクセスが有効な場合にのみ表示されます。

d. 「変更の適用」をクリックします。

関連項目:

- 「レガシー・コンポーネント・ビューでのページの表示」

- 『Oracle Application Express管理ガイド』のRESTfulアクセスの有効化に関する項

17.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ノードの子としてリストされます。

17.4 データベース・リンクを使用したデータへのアクセス

この項では、データベース・リンクを作成してデータにアクセスする方法について説明します。

トピック:

- データベース・リンクについて

- データベース・リンクの作成

- 既存のデータベース・リンクの表示

関連項目:

- 『Oracle Application Express SQLワークショップ・ガイド』のオブジェクト・ブラウザを使用したデータベース・オブジェクトの管理に関する項

- 『Oracle Database管理者ガイド』のデータベース・リンクに関する項

17.4.1 データベース・リンクについて

ワークスペースのホームページはOracle Database上で実行されるため、ユーザーは、すべての分散Oracle Database機能を使用できます。通常、分散データベース操作は、データベース・リンクを使用して実行します。

データベース・リンクは1つのデータベースのスキーマ・オブジェクトであり、これを使用すると、別のデータベース上のオブジェクトにアクセスできます。データベース・リンクを作成すると、表名またはビュー名に@dblinkを追加することによって、リモート・オブジェクトにアクセスできます。この場合のdblinkは、データベース・オブジェクトの作成ウィザードで指定するデータベース・リンク名です。

注意:

デフォルトでは、CREATE DATABASE LINKシステム権限は、割り当てられたワークスペースまたはデータベース・ユーザーに付与されません。この機能を使用するには、DBAまたは管理者が、この特定の権限をユーザーのワークスペースのデータベース・ユーザーに付与する必要があります。Oracle Database管理者ガイドの「データベース・リンクの作成」を参照してください。

17.4.2 データベース・リンクの作成

データベース・リンクを作成するには、次のステップを実行します。

1. ワークスペースのホームページで、「SQLワークショップ」をクリックして、「オブジェクト・ブラウザ」をクリックします。

「オブジェクト・ブラウザ」のホーム・ページが表示されます。

2. 「作成」をクリックします。

3. 「データベース・リンク」を選択して、「次へ」をクリックします。

4. 画面に表示されるステップに従います。

データベース・リンク名は、Oracleのネーミング規則に従う必要があり、空白を含めたり、数字やアンダースコアから開始することはできません。

17.4.3 既存のデータベース・リンクの表示

既存のデータベース・リンクを表示するには、次のステップを実行します。

1. ワークスペースのホームページで、「SQLワークショップ」をクリックして、「オブジェクト・ブラウザ」をクリックします。

オブジェクト・ブラウザが表示されます。

2. ページ上部のオブジェクト・タイプ「データベース・リンク」を選択します。

17.5 DMLロックについて

この項では、Oracle Application Expressで自動的なデータ操作言語(DML)を使用して、表の行を更新または削除する方法について説明します。

トピック:

- DMLロックについて

- APEX_DML_LOCK_WAIT_TIME

- FSP_DML_LOCK_ROW

17.5.1 DMLロックについて

Oracle Application Expressで自動的なデータ操作言語(DML)を使用して表内の行を更新または削除すると、トランザクションが開始され、最初に行をロックして、その行がページに表示されてから変更されたかどうかを確認し、最後に行に対する実際のUPDATE文またはDELETE文を発行します。

行のロックが頻繁に発生する一部の環境では、DML操作を制御してDML操作が次の状態かどうかを判別する場合があります。

- 無期限に待機

- 即時に失敗

- 指定した一定時間待機

17.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プロセスの後にリセットします。これは、表形式フォームを使用した更新および削除には影響しないことに注意してください。

17.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のデフォルトの動作が実行されます。

18 アプリケーション機能の拡張

この項では、電子メールの管理、バックグラウンドPL/SQLの実行、プラグインの使用、jQueryサポートの理解を含め、アプリケーション機能の拡張方法について説明します。

トピック:

- アプリケーションからの電子メール送信

- プラグインの実装

- jQueryおよびjQuery UIサポートの理解

- Oracle Application Expressコンポーネントの手動リフレッシュ

関連項目:

- Oracle Application Express APIリファレンス

- 「アプリケーションのデプロイ」

18.1 アプリケーションからの電子メール送信

Oracle Application Expressで電子メールを構成および管理するには、インスタンス管理者がOracle Application Express管理サービスにログインする必要があります。

トピック:

- 電子メールの構成について

- 電子メール・プロビジョニングについて

- メール・キューについて

- APEX_MAILパッケージについて

18.1.1 電子メールの構成について

Oracle Application Expressで電子メールを送信できるようにするには、インスタンス管理者が電子メール設定を構成する必要があります。この項では、完全開発環境およびランタイム環境で電子メール設定を構成する方法について説明します。

トピック:

- ネットワーク・サービスの有効化について

- 完全開発環境での電子メールの構成について

関連項目:

『Oracle Application Express管理ガイド』の電子メールの構成に関する説明

18.1.1.1 ネットワーク・サービスの有効化について

Oracle Database 11gリリース1または2以上では、ネットワーク・サービスとの通信機能が、デフォルトで無効化されています。このため、Oracle Database 11g リリース1または2以上でOracle Application Expressを実行している場合は、新しいDBMS_NETWORK_ACL_ADMINパッケージを使用して、apex_050100 データベース・ユーザーにすべてのホストに対する接続権限を付与する必要があります。これらの権限を付与しないと、次の場合に問題が発生します。

- Oracle Application Expressでアウトバウンド・メールを送信する。

- Oracle Application ExpressでWebサービスを使用する。

- PDF/レポートを印刷する。

関連項目:

- Oracle Application Expressインストレーション・ガイドの「Oracle Database 11g以上のネットワーク・サービスの有効化」の、該当するインストール・シナリオ:

- Application ExpressのインストールとOracle REST Data Servicesの構成

- Application Expressのインストールと埋込みPL/SQLゲートウェイの構成

- Application ExpressのインストールとOracle HTTP Serverの構成

- 『Oracle Application Express管理ガイド』の電子メールの構成に関する説明

18.1.1.2 完全開発環境での電子メールの構成について

完全開発環境でメールを送信するようにOracle Application Expressを構成するには、インスタンス管理者がOracle Application Express管理サービスにログインし、インスタンスの設定ページにナビゲートして、「電子メール」属性を構成する必要があります。

関連項目:

『Oracle Application Express管理ガイド』の電子メールの構成に関する説明

18.1.2 電子メール・プロビジョニングについて

新しいワークスペース・リクエストが承認されたときにユーザーにログイン資格証明が電子メールで自動的に送信されるように、Oracle Application Expressを構成できます。これを行うには、電子メール構成プロセスを完了し、プロビジョニング・ステータスの電子メールの検証でのリクエストを選択する必要があります。

関連項目:

- 『Oracle Application Express管理ガイド』の電子メールの構成に関する説明

- 『Oracle Application Express管理ガイド』のワークスペースの作成方法の指定に関する項

- 『Oracle Application Express管理ガイド』のプロビジョニング・モードの選択に関する項

18.1.3 メール・キューについて

インスタンス管理者は、メール・キュー内の電子メール・メッセージ、およびメール・ログを監視することで、アプリケーションから送信された電子メールを管理できます。

関連項目:

『Oracle Application Express管理ガイド』のメール・キューの管理に関する項

18.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管理ガイド』の電子メールの構成に関する説明

18.2 プラグインの実装

この項では、プラグインを追加、管理、再利用および共有する方法について説明します。プラグインの例はOracle Technology NetworkのOracle Application Expressプラグイン・リポジトリにあり、サンプル・データベース・アプリケーションに含まれています。

トピック:

- プラグインについて

- プラグインの例の表示

- プラグイン・ページへのアクセス

- プラグインの作成

- プラグインの編集

- プラグインへのカスタム属性の追加

- プラグインに関連付けられたファイルのアップロード

- プラグインへのイベントの追加

- プラグインの削除

- プラグイン・リポジトリの表示

- プラグイン・ページからのプラグインのインポート

- プラグイン・ページからのプラグインのエクスポート

- プラグイン対話モード・レポートのリセット

- プラグインの使用状況ページの表示

- プラグイン履歴の表示

関連項目:

- 「プラグインの例の表示」

- 「プラグイン・リポジトリの表示」

18.2.1 プラグインについて

開発者はプラグインを使用して、Oracle Application Expressで使用可能な組込みタイプを宣言的に拡張、共有および再利用できます。

Oracle Application Expressは、認証スキーム、認可スキーム、アイテム、リージョン、動的アクションとプロセス・タイプのグループ・セットをサポートします。プラグインによってアプリケーション内で新しいタイプを宣言的に作成および使用することによって、これらの組込みタイプを拡張する手段が提供されます。プラグインは再利用を目的として設計されているため、開発者はプラグインを別のワークスペースにエクスポートおよびインポートしたり、プラグイン・リポジトリを使用してプラグインをOracle Application Expressプラグイン・コミュニティと共有できます。

プラグインを実装するプロセスには、次のステップがあります。

1. アプリケーション・ワークスペースでプラグインを作成するか、またはインポートします。

2. プラグインを使用するための認可スキーム、アイテム、リージョン、プロセスまたは動的アクション・タイプを編集または作成します。

3. プラグインをテストするためにアプリケーションを実行します。

18.2.2 プラグインの例の表示

次の場所で、プラグインの実装例を表示できます。

- Oracleプラグイン・リポジトリに移動します。
プラグイン・リポジトリの表示を参照してください。

- パッケージ・アプリケーションであるサンプル・データベース・アプリケーションをインストールします。
完全開発環境でのパッケージ・アプリケーションの管理およびサンプル・データベース・アプリケーションのインストールおよび実行を参照してください。

- Oracle Learning Library (http://www.oracle.com/oll/apex)に移動します。表示されたフィールドに検索基準を入力し、「検索」をクリックします。

18.2.3 プラグイン・ページへのアクセス

プラグイン・ページにアクセスするには、次のステップを実行します

1. 共有コンポーネント・ページにナビゲートします。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。

b. アプリケーションを選択します。

c. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

共有コンポーネント・ページが表示されます。

2. 「他のコンポーネント」で、「プラグイン」をクリックします。

プラグイン・ページが表示され、「プラグイン」タブがデフォルトで選択されます。使用可能なすべてのプラグインが表示されます。

ページの外観は、ページ上部にある検索バーを使用してカスタマイズできます。

関連項目:

「実行中のアプリケーションでの対話モード・レポートのカスタマイズ」

18.2.4 プラグインの作成

プラグインを作成するには、次のようにします。

ヒント:

この項で説明する属性の詳細は、フィールドレベル・ヘルプを参照してください。Oracle Application Expressでのフィールドレベル・ヘルプの表示を参照してください。

1. プラグイン・ページにナビゲートします。

2. 「作成」をクリックします。

プラグインの作成ウィザードが表示されます。

3. 「プラグインの作成」で、プラグインを作成する方法を選択し、「次へ」をクリックします。

4. 「名前」で、次の項目を指定します。

a. 名前(必須): プラグインの名前を入力します。

b. 内部名(必須): プラグインの内部名を入力します。この名前は、現在のアプリケーション内で一意である必要があります。

注意:

内部名をワールドワイドでグローバルな一意名とするために、組織のドメイン名を内部プラグイン名の接頭辞として使用することをお薦めします。たとえば、ドメイン名example.com.comをSliderという名前のプラグインに接頭辞として付けると、内部名はCOM.EXAMPLE.SLIDERとなります。

c. タイプ(必須): このプラグインを使用するコンポーネントのタイプを選択します。選択したプラグイン・タイプに応じて、「コールバック」および「標準属性」の下のオプションが変わります。詳細は、フィールドレベル・ヘルプを参照してください。

d. カテゴリ: 選択したタイプが「動的アクション」の場合にのみ表示されます。ユーザー・インタフェースでプラグインが表示されるカテゴリを選択します。

5. 「サブスクリプション」で、次のようにします。

- マスター・プラグインの参照元 - このプラグインを、このワークスペースの別のプラグインに基づくようにするには、リストからプラグインを選択します。それ以外の場合、このフィールドをブランクのままにし、これをこのプラグインのマスター・コピーとします。

6. 「ソース」で、次のようにします。

a. PL/SQLコード - このプラグインのレンダリング、検証、実行およびAJAXコールバックの実行用のプロシージャを含むコードのPL/SQL無名ブロックを入力します。パフォーマンス上の理由から、このコードはデータベース内のPL/SQLパッケージに格納することもできます。

b. PL/SQLコードを検証しない(実行時にのみPL/SQLコードを解析)。 - PL/SQLコードを実行時にのみ解析する場合は、このオプションを選択します。選択しない場合、コードはプラグインが作成されるときに解析されます。

7. 「コールバック」で、該当する属性を構成します。表示される属性はプラグイン・タイプに応じて決まります。属性の詳細および例を確認するには、フィールドレベル・ヘルプを参照してください。

ヒント:

すべてのコールバック・ファンクション名は、無名PL/SQLコード・ブロックのファンクション、パッケージ内のファンクションまたはデータベース内のスタンドアロン・ファンクションを参照できます。

8. 「ユーザー・インタフェース」で、このプラグインに対してアプリケーション・ビルダーでサポートする必要のある表示デバイスを選択します。オプションは次のとおりです。

- デスクトップ

- モバイル

9. 「標準属性」で、このプラグインに適用する属性を選択します。「標準属性」は、一部のプラグインには表示されません。詳細は、フィールドレベル・ヘルプを参照してください。

10. 「情報」で、次のステップを実行します。

a. バージョン: プラグインのバージョンを識別する文字列を入力します。

b. URL情報: プラグイン作成者のホームページのURL、またはプラグインに関する追加情報のURLです。

11. 「ヘルプ・テキスト」に、ユーザーがプラグインの機能を理解するのに使用するヘルプ・テキストを入力します。

12. 「コメント」に、アプリケーションが実行されているときに表示されないコメントおよび注意を入力します。

各オプションの詳細は、フィールドレベル・ヘルプを参照してください。

13. 「プラグインの作成」をクリックします。

プラグインが作成されたら、追加のカスタム属性の指定、プラグインと関連付けるイメージ、CSSおよびJavaScriptファイルなどのファイルのアップロードおよびイベントの追加を実行できます。

関連項目:

- 「プラグイン・ページへのアクセス」」

- 「プラグインへのカスタム属性の追加」

- 「プラグインに関連付けられたファイルのアップロード」

- 「プラグインへのイベントの追加」

18.2.5 プラグインの編集

プラグインを編集するには、次のようにします。

1. プラグイン・ページにナビゲートします。

2. 編集または表示するプラグインをクリックします。

プラグインの作成/編集ページが表示されます。

3. 変更を加えます。

各オプションの詳細は、フィールドレベル・ヘルプを参照してください。

4. 「変更の適用」をクリックします。

関連項目:

- 「プラグイン・ページへのアクセス」」

- 「プラグインの作成」

- 「プラグインへのカスタム属性の追加」

- 「プラグインに関連付けられたファイルのアップロード」

- 「プラグインへのイベントの追加」

18.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. 属性を作成して編集ページに戻るために「作成」をクリックするか、属性を作成して別の属性の作成を続行するために「作成後、さらに作成」をクリックします。

注意:

「作成」または「作成後、さらに作成」をクリックするとき、右側のパネルの「プラグイン」の下の「ページに戻る」チェック・ボックスが選択されていると、同じ属性の編集ページが表示されます。

関連項目:

「プラグイン・ページへのアクセス」」

18.2.7 プラグインに関連付けられたファイルのアップロード

この項では、プラグインに関連付けられたファイルをアップロードする方法について説明します。

トピック:

- プラグインに関連付けられたファイルのアップロード

- CSSおよびJavaScriptファイルの自動ロード

18.2.7.1 プラグインに関連付けられたファイルのアップロード

ファイルをアップロードする手順は、次のとおりです。

1. プラグイン・ページにナビゲートします。

2. プラグインを選択します。

プラグインの作成/編集ページが表示されます。

3. 「ファイル」セクションを見つけます。

「ファイルの接頭辞」は、Webサーバーがプラグインのファイルを指す場合に使用する仮想パスを特定します。プラグイン定義とともにデータベースに格納されているファイルを参照する場合は、何も指定しないでください。

4. ファイルをアップロードする手順は、次のとおりです。

a. 「ファイルのアップロード」をクリックします。

b. アップロードするファイルを参照して選択します。

c. 「アップロード」をクリックします

作成/編集ページが表示されます。アップロード対象ファイルの名前が「ファイル」の下に表示されます。

5. 「変更の適用」をクリックします。

関連項目:

「プラグイン・ページへのアクセス」」

18.2.7.2 CSSおよびJavaScriptファイルの自動ロード

「ロードするファイルURL」属性を構成すると、ページでプラグインが使用されるときに、CSSおよびJavaScriptファイルをOracle Application Expressで自動的にロードできます。どのアップロード済ファイルをどの順序でロードする必要があるかを指定するには、次のステップを実行します。

CSSまたはJavaScriptファイルを自動ロードするには、次のステップを実行します。

1. プラグイン・ページにナビゲートします。

2. プラグインを選択します。

プラグインの作成/編集ページが表示されます。

3. 「ロードするファイルURL」で、次のステップを実行します。

a. カスケード・スタイルシート - このプラグインでロードするカスケード・スタイルシート・ファイルURLを入力します。

b. JavaScript - このプラグインでロードするコードのJavaScriptファイルURLを入力します。

置換文字列#PLUGIN_FILES#を使用することで、プラグインのファイル接頭辞の値を置換できます。次に例を示します。

#PLUGIN_FILES#my_plugin.css

詳細および例を確認するには、フィールドレベル・ヘルプを参照してください。

4. 「変更の適用」をクリックします。

関連項目:

「プラグイン・ページへのアクセス」」

18.2.8 プラグインへのイベントの追加

この項では、アイテム、リージョンまたは動的アクション・タイプのプラグインにイベントを追加して、動的アクションに公開できるようにする方法について説明します。たとえば、Start Slide、Sliding、Stop Slideなどのイベントを公開するSliderプラグインによって、これらのイベントが発生したときに応答できる動的アクションを作成できます。

プラグインにイベントを追加するには、次の手順を実行します。

1. プラグイン・ページにナビゲートします。

2. 編集するプラグインをクリックします。

プラグインの作成/編集ページが表示されます

3. 「イベント」で、「イベントの追加」をクリックします。

「イベント」の下に新しい行が表示されます。

4. 「イベント」で、次のように入力します。

a. 名前: 動的アクション内でプラグイン・イベントが表示される表示名(例: Start Slide)。

b. 内部名: 動的アクションをトリガーする割り当てられたJavaScriptイベントの名前。例: slidestart。

5. 「イベントの追加」をクリックします。

6. 手順3から4を繰り返して、別のイベントを追加します。

7. 「変更の適用」をクリックします。

関連項目:

「プラグイン・ページへのアクセス」」

18.2.9 プラグインの削除

プラグインは使用中でなければ削除できます。プラグインを使用中の場合、「削除」ボタンは表示されません。

プラグインを削除するには、次のようにします。

1. プラグイン・ページにナビゲートします。

2. 削除するプラグインをクリックします。

プラグインの作成/編集ページが表示されます。

3. 「削除」をクリックします。

4. 確認して、「OK」をクリックします。

関連項目:

「プラグイン・ページへのアクセス」」

18.2.10 プラグイン・リポジトリの表示

プラグイン・リポジトリによって、開発者がプラグインを共有およびダウンロードできる一元的な場所が提供されます。リポジトリはOracle Technology Networkにあります。

プラグイン・リポジトリを表示するには、次の手順を実行します。

1. プラグイン・ページにナビゲートします。プラグイン・ページへのアクセスを参照してください。

2. 「プラグイン・リポジトリの表示」をクリックします。

Oracle Application Expressプラグイン・リポジトリが表示されます。

18.2.11 プラグイン・ページからのプラグインのインポート

エクスポートされたプラグインをアプリケーションにインポートするにはこのオプションを使用します。プラグインのインポートは、ここで説明するように、プラグイン・ページの「共有コンポーネント」からか、アプリケーション・ビルダーのホームページから実行できます。

プラグインをインポートするには、次の手順を実行します。

1. プラグイン・ページにナビゲートします。

2. 「インポート」をクリックします。

プラグインのインポート・ページが表示されます。

3. 「ファイルの指定」で、次のステップを実行します。

a. インポート・ファイル: インポート・ファイルの名前を入力または参照します。

b. ファイル・タイプ: 「プラグイン」を選択します。

c. ファイルのキャラクタ・セット: インポート・ファイルのキャラクタ・セット・エンコードを選択します。

d. 「次へ」をクリックします。

4. 「ファイルのインポートの確認」で、「次へ」をクリックします。

5. 「インストール」で、「プラグインのインストール」をクリックします。

関連項目:

- プラグインのインポート

- 「プラグイン・ページへのアクセス」」

18.2.12 プラグイン・ページからのプラグインのエクスポート

プラグイン定義をファイルにエクスポートするにはこのオプションを使用します。このファイルは任意のAPEXアプリケーションにインポートできます。プラグインのエクスポートは、ここで説明するように、プラグイン・ページの「共有コンポーネント」からか、「ワークスペース」ホームページから実行できます。

プラグイン・ページからプラグインをエクスポートするには、次のステップを実行します。

1. プラグイン・ページにナビゲートします。

2. 「タスク」で、「プラグインのエクスポート」をクリックします。

プラグインのエクスポート・ページが表示されます。

3. プラグインのエクスポート・ページで、次のステップを実行します。

a. アプリケーション: プラグインのエクスポート元のアプリケーションを選択します。

b. プラグイン - プラグインを選択します。

c. ファイル形式: プラグイン・エクスポートのファイル形式を選択します。

d. 「エクスポート」をクリックします

4. 「エクスポート」をクリックします。

ダウンロード完了メッセージが表示されます。

関連項目:

- 「プラグインのエクスポート」

- 「プラグイン・ページへのアクセス」」

18.2.13 プラグイン対話モード・レポートのリセット

プラグインの対話モード・レポートをリセットして、現在レポートに適用されているすべてのフィルタをクリアします。

対話モード・レポートをリセットするには、次の手順を実行します。

1. プラグイン・ページにナビゲートします。次を参照

2. プラグイン・ページで、「リセット」をクリックします。

関連項目:

「プラグイン・ページへのアクセス」」

18.2.14 プラグインの使用状況ページの表示

プラグインの使用状況ページには、各プラグインを使用するページ、コンポーネントおよびリージョンが表示されます。

プラグインの使用状況を表示するには、次の手順を実行します。

1. プラグイン・ページにナビゲートします。

2. 「使用状況」をクリックします。

使用状況ページが表示されます。

関連項目:

「プラグイン・ページへのアクセス」」

18.2.15 プラグイン履歴の表示

プラグイン履歴ページには、各プラグインで実行されたアクション、アクションを実行した開発者および各アクションの日付が表示されます。

プラグインの履歴を表示するには、次の手順を実行します。

1. プラグイン・ページにナビゲートします。

2. 「履歴」をクリックします。

履歴ページが表示されます。

関連項目:

「プラグイン・ページへのアクセス」」

18.3 jQueryおよびjQuery UIサポートの理解

Oracle Application Expressには、jQuery 1.11.3および2.2.3、jQuery UI 1.10.4、jQuery Mobile - 1.4.5 JavaScriptライブラリが含まれています。この項では、jQuery UIで使用できる機能と、JavaScriptコードでjQueryライブラリを参照する場合のベスト・プラクティスについて説明します。

トピック:

- Application Expressリリース4.Xから5.1にアップグレードする場合の互換性の問題について

- 使用できるjQuery UI機能について

- JavaScriptコードでのjQueryライブラリの参照

18.3.1 Application Expressリリース4.Xから5.1にアップグレードする場合の互換性の問題について

Oracle Application Expressリリース4.Xから5.1へのアップグレードで、Oracle Application Expressが使用するjQueryおよびjQueryUIのJavaScriptライブラリが次のように更新されました。

- jQueryは、バージョン1.7.1からバージョン2.2.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#に置き換えることをお薦めします。

18.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/

トピック:

- その他のjQuery UIコンポーネントへのアクセスについて

18.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にデフォルトで含まれているため、この依存性を含める必要はありません。

18.3.3 JavaScriptコードでのjQueryライブラリの参照

独自のJavaScriptコードでjQueryライブラリへの$、jQueryおよびapex.jQuery参照をいつ使用するかは、どこでそれを使用するかによって決まります。

Oracle Application Expressのより新しいバージョンには、jQueryライブラリの更新バージョンが含まれていることがあります。新しいバージョンのjQueryがリリースされる際に、既存の機能を無効にする変更が導入されることがあります。これらの問題は、特定のバージョンのリリース・ノートの変更ログに記載されています。新しいバージョンのOracle Application Expressにアップグレードする際に問題が発生する可能性を最小限に抑えるには、後続の項で説明するベスト・プラクティスに従うことをお薦めします。

トピック:

- アプリケーションでのJavaScriptコードの管理について

- プラグインでのJavaScriptコードの使用について

18.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は引き続きそのバージョンを指すことに注意してください。

18.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バージョンでプラグインをテストできます。

18.4 Oracle Application Expressコンポーネントの手動リフレッシュ

動的アクション・フレームワークには、サポートされるOracle Application Expressコンポーネントに対するリフレッシュ機能がありますが、JavaScriptコードから手動でリフレッシュを起動することが必要となる場合があります。これを実行するには、次のように関連コンポーネントのapexrefreshイベントをトリガーします。

apex.event.trigger( "#myRegionStaticID", "apexrefresh" );

19 アプリケーション・セキュリティの管理

管理者は、Oracle Application Expressインストールのセキュリティを保証する必要があります。開発者は、セキュアなアプリケーションを構築する必要があります。この項では、Oracle Application Expressアプリケーション・セキュリティにベスト・プラクティスを実装する方法について説明します。

トピック:

- セキュリティに関する管理者のベスト・プラクティスの理解

- セキュリティに関する開発者のベスト・プラクティスの理解

- アプリケーション、ページおよびページ・コンポーネントへのアクセスの制御

- 認証によるユーザー・アイデンティティの証明

- 認可を介したセキュリティの提供

関連項目:

アプリケーション整合性のチェックのためのアドバイザの実行

19.1 セキュリティに関する管理者のベスト・プラクティスの理解

ヒント:

このセクションでは、Oracle Application Express管理サービス・アプリケーションの様々な設定について説明します。管理サービス・アプリケーションの機能は、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以上でのネットワーク・サービスの有効化
Oracle Database 11g以上のバージョンでのネットワーク・サービスの有効化を理解します。

関連項目:

セキュリティに関する開発者のベスト・プラクティスの理解

19.1.1 Oracle Application Express管理者のロールについて

Oracle Application Express開発環境にアクセスするには、ユーザーはワークスペースという作業用の共有領域にログインします。Oracle Application Expressには、2種類の管理者が含まれています。

- ワークスペース管理者は、ユーザー・アカウントの管理、ワークスペース・アクティビティの監視、ログ・ファイルの表示など、ワークスペース固有の管理タスクを実行するユーザーです。

- インスタンス管理者は、Application Express管理サービス・アプリケーションを使用して、ホスティングされたインスタンス全体を管理するスーパーユーザーです。

ヒント:

インスタンス管理者のロールは、Oracle Database Cloud Service (Database Schema)では使用できません。

関連項目:

『Oracle Application Express管理ガイド』のワークスペースおよびアプリケーションの管理に関する項およびOracle Application Express管理サービスに関する項

19.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へのアクセスの制限に関する項

19.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へのアクセスの制限」

19.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がインストールされているデータベースと同じデータベースで実行されるため、データベースから分離できません。このため、インターネット上で実行されるアプリケーションまたは本番アプリケーションに埋込みPL/SQLゲートウェイを使用することはお薦めしません。かわりに、Oracle REST Data Servicesを使用することをお薦めします。また、埋込みPL/SQLゲートウェイでは、Oracle REST Data Servicesほどに柔軟な構成および詳細なログは提供されません。

19.1.5 インスタンス・セキュリティの管理

この項では、Oracle Application Expressインスタンスを管理する場合のセキュリティに関するベスト・プラクティスの概要を示します。

トピック:

- ログイン制御の作成について

- パブリック・ファイルのアップロードの有効化について

- IPアドレスによるユーザー・アクセスの制限について

- インスタンス・プロキシの指定について

- Secure Sockets Layerの使用について

- RESTfulアクセスの有効化について

- 「セッションを再結合」について

- ワークスペースの分離について

- セッション・タイムアウトの使用について

- パスワードの再利用の制限

- WebシートでのSQLの使用について

- RESTfulサービスの有効化について

関連項目:

『Oracle Application Express管理ガイド』のセキュリティ設定の構成に関する項

19.1.5.1 ログイン制御の作成について

ワークスペースの管理者および開発者は、Oracle Application Expressの開発環境にログインし、ワークスペース内で開発されたアプリケーションに対するエンド・ユーザーの認証を行うためのユーザー・アカウントを作成できます。

管理者は、インスタンス全体または各ワークスペースのログイン制御を構成することができます。たとえば、インスタンス管理者がOracle Application Express管理サービスでアカウント・ログイン制御を構成した場合、その構成は開発インスタンス全体ですべてのワークスペースの全Application Expressアカウントに適用されます。

インスタンス管理者がインスタンス全体でログイン制御を有効にしない場合は、各ワークスペース管理者がワークスペースごとに次の制御を有効にできます。

- エンド・ユーザーのアカウント有効期限およびロック。

- エンド・ユーザー・アカウントへのログイン試行失敗の最大回数。

- パスワード存続期間(つまりエンド・ユーザー・アカウントのパスワードを使用できる期限が切れるまでの残りの日数)。

関連項目:

『Oracle Application Express管理ガイド』のインスタンスのログイン制御の作成およびワークスペースのアカウント・ログイン制御の作成に関する項。

19.1.5.2 パブリック・ファイルのアップロードの有効化について

管理者は、「パブリック・ファイルのアップロードを許可」属性を使用して、認証されていないユーザーがファイルのアップロード機能を提供するアプリケーションでファイルをアップロードできるかどうかを制御できます。

関連項目:

『Oracle Application Express管理ガイド』のパブリック・ファイルのアップロードの制御に関する項

19.1.5.3 IPアドレスによるユーザー・アクセスの制限について

管理者は、インスタンスの管理、セキュリティ・ページで「IPアドレス別にアクセスを制限」属性の許容されるIPアドレスのカンマ区切りリストを入力して、Oracle Application Expressインスタンスへのユーザー・アクセスを制限できます。

関連項目:

『Oracle Application Express管理ガイド』のIPアドレス別のユーザー・アクセスの制限に関する項

19.1.5.4 インスタンス・プロキシの指定について

管理者は、「インスタンス・プロキシ」属性を使用して、すべてのアウトバウンドHTTPトラフィックにプロキシを使用するようにOracle Application Expressインスタンス全体を構成できます。インスタンス・レベルでのプロキシの設定は、アプリケーション・レベルまたはWebサービス参照で定義されているすべてのプロキシより優先されます。プロキシが指定されている場合、URLタイプのリージョン、Webサービスおよびレポート出力で、そのプロキシが使用されます。

関連項目:

『Oracle Application Express管理ガイド』のインスタンス用のプロキシ・サーバーの構成に関する項

19.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の必要性」

19.1.5.6 RESTfulアクセスの有効化について

管理者は、「RESTfulアクセスを許可」属性を使用して、開発者がレポート・リージョンをRESTfulサービスとして公開できるかどうかを制御できます。

関連項目:

『Oracle Application Express管理ガイド』のインスタンスのRESTfulサービスの制御に関する項

19.1.5.7 「セッションを再結合」について

ヒント:

セキュリティ上の理由から、管理者は、ワークスペース・レベルまたはインスタンス・レベルで「ホスト名の許可」属性を構成してワークスペース分離を実装する場合を除いて、「セッションを再結合」を無効にすることをお薦めします。ワークスペースの分離についてを参照してください。

「セッションを再結合」属性は、Oracle Application ExpressでセッションIDを含まないURLをサポートするかどうかを制御します。セッションの再結合を有効にすると、URLにセッションIDが含まれていない場合、Oracle Application Expressはセッションcookieを使用して既存のセッションを結合しようとします。

「セッションを再結合」を使用するには、管理者はアプリケーション・レベルまたはページ・レベルで「セッションを再結合」を有効にする必要があります。「セッションを再結合」にインスタンス・レベルでより制限の多い値が設定されている場合、これによりアプリケーションおよびページ設定が上書きされます。

セッション結合のサポートは便利ですが、複数の重大なセキュリティ・リスクが存在します。

- セッション・ステートの悪意のある変更または他の変更のトリガー。
攻撃者がユーザーにアプリケーション・リンクをクリックさせた場合に、セッション・ステートの悪意のある変更または他の変更がトリガーされる可能性があります。このリスクのため、Application Expressには、データの変更を伴うリクエスト処理のタイミングを攻撃者が推測できないチェックサムが必要です。

- アプリケーション間の予期しない変更のトリガー。
ユーザーが同じOracle Application Expressインスタンスの個別のタブで2つのアプリケーションを開いている場合、一方のアプリケーションが他方のアプリケーションで予期しない変更をトリガーする可能性があります。攻撃側のアプリケーションはハッカーによって作成されたか、攻撃者にコードの挿入を可能にするXSS脆弱性がある場合があります。このアプリケーションは、他のアプリケーションとのユーザーの相互作用をシミュレートするAjaxコールを使用することがあります。

関連項目:

- ブックマークのサポートの有効化について

- ブラウザ・セキュリティ

- ページ・デザイナでのセッションの再結合の構成

- コンポーネント・ビューでのセッションの再結合の構成

- Oracle Application Express管理ガイドの「インスタンスへのセッション再結合の構成」

19.1.5.8 ワークスペースの分離について

ワークスペースの分離は、ブラウザ攻撃を防ぐ効果的な方法です。ワークスペースを実際に分離する唯一の方法は、Oracle Application Express管理サービスで「ホスト名の許可」属性を構成して、URLで異なるドメインを強制することです。攻撃者と攻撃を受ける側のURLでドメインとホスト名が異なる場合、ブラウザの同一起点ポリシーによって攻撃が回避されます。

「ホスト名の許可」の構成によるワークスペースの分離は、ワークスペースの境界を越えようとするクライアント側攻撃への対策となります。このセキュリティ対策は、他のフレームワークおよび言語(Oracle Application Development Framework (ADF)やJavaなど)で作成されたアプリケーションを含むインスタンスのホストを使用してアクセスできるすべてのアプリケーションを信頼できる場合は、必要ありません。

関連項目:

- Oracle Application Express管理ガイドの「ブラウザ攻撃を防ぐためのワークスペースの分離」

- Oracle Application Express管理ガイドの「インスタンスのすべてのワークスペースの分離」

19.1.5.9 セッション・タイムアウトの使用について

「セッション・タイムアウト」属性を構成すると、アプリケーションの公開を抑制できます。ユーザーは、長時間コンピュータを操作しなかったり、アプリケーションを終了せずにコンピュータの元を離れることが頻繁にあります。このため、アプリケーションのユーザー・アイデンティティが、権限のないユーザーによって簡単に引き継がれる可能性があります。セッション・タイムアウトおよびアイドル・タイムアウトを設定すると、指定したタイムアウトの後、ユーザーは自動的にアプリケーションからログアウトされます。

「セッション・タイムアウト」属性には、次のものがあります。

- 最大セッションの長さ

- セッション・タイムアウトURL

- 最大セッション・アイドル時間

- アイドル・タイムアウトURL

開発者は特定のアプリケーションのセッション・タイムアウトを構成でき、管理者はインスタンス全体のセッション・タイムアウトを構成できます。

関連項目:

- これらの属性をアプリケーション・レベルで構成する方法の詳細は、セッション管理を参照してください。

- Oracle Application Expressインスタンス全体でこれらの属性を構成するには、『Oracle Application Express管理ガイド』のセッション・タイムアウトの構成に関する項を参照してください。

19.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_050100;

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プロシージャ」

- Oracle Application Express APIリファレンスの「APEX_UTIL.STRONG_PASSWORD_VALIDATIONファンクション」

19.1.5.11 WebシートでのSQLの使用について

SQL Webシート属性を許可属性を無効にすると、管理者は、WebシートのユーザーがSQLタグを使用して基盤となるデータベース・オブジェクトにアクセスしたり、SQLレポートを作成することを防ぐことができます。

関連項目:

『Oracle Application Express管理ガイド』のWebシートでのSQLアクセスの有効化と無効化に関する項

19.1.5.12 RESTfulサービスの有効化について

「RESTfulサービスを有効にする」属性を無効にすると、開発者は、Oracle REST Data Services 2.0以上とともに使用されるSQLおよびPL/SQLにマップされるRESTful Webサービスを作成および編集できなくなります。

関連項目:

『Oracle Application Express管理ガイド』のインスタンスのRESTfulサービスの制御に関する項

19.1.6 インスタンス設定の構成

この項では、Oracle Application Expressインスタンスを構成する場合のセキュリティに関するベスト・プラクティスの概要を示します。

トピック:

- ワークスペースのセルフ・サービス割当ての有効化について

- 電子メールの有効化および構成について

- 記憶域オプションの構成について

- ウォレットの作成について

関連項目:

『Oracle Application Express管理ガイド』のインスタンス設定の構成に関する項

19.1.6.1 ワークスペースのセルフ・サービス割当ての有効化について

管理者は、新規ワークスペースの割当て(または作成)時に自動化の量を決定します。割当ての動作方法を決定するには、インスタンス管理者は、インスタンスの設定ページで次のいずれかのオプションを選択します。

- 手動 - 管理者が新しいワークスペースを作成し、ワークスペース管理者にログイン情報を手動で通知します。

- リクエスト - ユーザーがセルフ・サービス方式で直接ワークスペースをリクエストします。

- 電子メールの検証でのリクエスト - このモードでは、ユーザーがログイン・ページでリンクをクリックしてワークスペースを直接リクエストし、リクエスト・フォームにアクセスします。各ユーザーは、検証リンクを含む電子メールを最初に受信します。ユーザーが検証リンクをクリックすると、リクエストが処理されます。ユーザーは、この後サインイン・ページを使用してワークスペースにアクセスできます。

関連項目:

『Oracle Application Express管理ガイド』のワークスペースの作成方法の指定に関する項

19.1.6.2 電子メールの有効化および構成について

Oracle Application Expressアプリケーションから電子メールを送信するには、インスタンス管理者は電子メールSMTP設定を定義し、Oracle Database 11g R2以上に対してセキュアな接続を使用するように「SSL/TLSの使用」属性を設定する必要があります。

関連項目:

- 『Oracle Application Express管理ガイド』の電子メールの構成に関する説明

- 「ネットワーク・サービスを有効化する必要があるタイミングと理由」

19.1.6.3 記憶域オプションの構成について

管理者は、ワークスペースや自動拡張表領域をリクエストした際に新しいスキーマを要求したり、指定日数に達したアップロード済ファイルを削除する記憶域オプションを構成できます。

関連項目:

『Oracle Application Express管理ガイド』の記憶域の構成に関する項

19.1.6.4 ウォレットの作成について

ウォレットは、SSLに必要な認証および署名された資格証明(秘密鍵、証明書および信頼できる証明書)の格納に使用されるパスワード保護されたコンテナです。次の場合は、ウォレットを作成する必要があります。

- SSL有効URLを呼び出す(たとえば、Webサービスを起動して)場合。

- タイプがSSL有効URLのリージョンを作成する場合。

- 「SSL/TLSの使用」属性を「はい」に設定してセキュアSMTPを構成する場合。

- 「認証付きSSL」を使用するように構成されたLDAP認証スキームを持つアプリケーションを使用する場合。

関連項目:

Oracle Application Express管理ガイドの「ウォレット情報の構成」

19.1.7 ワークスペースの消去設定の構成について

アクティブでないワークスペースは、貴重な記憶領域を消費して、システム・パフォーマンスを低下させます。「ワークスペースの消去設定」を有効にすることによって、管理者は、アクティブでないワークスペースを消去するようにOracle Application Expressを構成できます。

関連項目:

『Oracle Application Express管理ガイド』のアクティブでないワークスペースの消去に関する項

19.1.8 ワークスペース管理の理解

この項では、Oracle Application Expressでワークスペースを管理する場合のセキュリティに関するベスト・プラクティスの概要を示します。

トピック:

- スキーマへのワークスペースの割当ての管理について

- 開発者およびユーザーの管理について

- コンポーネントの可用性の管理について

関連項目:

『Oracle Application Express管理ガイド』の既存のワークスペースの管理に関する項

19.1.8.1 スキーマへのワークスペースの割当ての管理について

ユーザーがOracle Application Expressにログインする場合、ワークスペースという作業用の共有領域にログインします。各ワークスペースに、複数のスキーマを関連付ける(マップする)ことができます。インスタンス管理者は、必要に応じてワークスペースとスキーマ間の関連付けを定義できます。ワークスペースをスキーマに関連付けることによって、開発者はワークスペースで、スキーマ内の新規データベース・オブジェクトの作成、およびスキーマ内のデータベース・オブジェクトと相互作用するアプリケーションの構築が可能です。

関連項目:

『Oracle Application Express管理ガイド』のスキーマへのワークスペースの割当ての管理に関する項

19.1.8.2 開発者およびユーザーの管理について

管理者は、どのスキーマ固有のユーザーにアクセス権を与えるか、およびそれらのユーザーのユーザー・ロール、つまり、ユーザーがワークスペース管理者、開発者またはエンド・ユーザーであるかを定義できます。管理者は、特定のApplication Expressコンポーネントへの開発者アクセスを制限し、アカウントをロックすることもできます。Oracle Application Expressには、開発者とユーザーを管理するための2つの個別のインタフェースがあります。ワークスペース管理者はワークスペース内でユーザー・アカウントを管理し、インスタンス管理者はApplication Express開発インスタンスにわたってすべてのユーザー・アカウントを管理します。

関連項目:

『Oracle Application Express管理ガイド』のApplication Expressインスタンスにわたるユーザーの管理およびワークスペースでのユーザーの管理に関する項

19.1.8.3 コンポーネントの可用性の管理について

ワークスペース管理者は、開発者がオブジェクト・ブラウザからPL/SQLプログラム・ユニットを編集およびコンパイルできるかどうかを決定する、主要コンポーネント(アプリケーション・ビルダー、チーム開発、SQLワークショップ、PL/SQL編集など)へのユーザー・アクセスを制御できます。たとえば、管理者がユーザーにデータベース・コンポーネントの構築、SQL文の実行を許可し、アプリケーションの作成は許可しない場合、管理者は特定のスキーマに対する権限を持つワークスペースを定義し、ワークスペース・プリファレンスの設定ページのオプションを使用してユーザーを開発者として構成します。

関連項目:

『Oracle Application Express管理ガイド』のワークスペース・プリファレンスの構成に関する項

19.1.9 Oracle BI Publisherとの統合について

Oracle Application ExpressとOracle BI Publisherを統合する場合は、Secure Sockets Layer(SSL)を使用することをお薦めします。Oracle BI Publisherサーバー用にSSL(HTTPSプロトコル)を構成したら、ウォレットを作成して、内部管理環境設定でレポート・サーバーにHTTPSプロトコルを指定する必要があります。

関連項目:

Oracle Application Express管理ガイドの「ウォレット情報の構成」および「レポート出力の構成」

19.1.10 Application Expressのランタイム環境の利点について

Oracle Application Expressのランタイム環境では本番アプリケーションを実行できますが、管理用のWebインタフェースは使用できず、これらのアプリケーションを直接開発することはできません

機密の本番Oracle Application Expressアプリケーションは、Oracle Application Expressのランタイム・インストールで実行することをお薦めします。ランタイム・インストールでは、Webベースのアプリケーション開発環境が使用されないため、アプリケーション・ビルダー、SQL Workshopおよび本番インストールに関係するユーティリティが使用できません。また、ランタイム環境に含まれるのは、アプリケーションの実行に必要なOracle Application Expressデータベース・オブジェクトおよび権限のみであるため、より堅牢な環境になります。

関連項目:

『Oracle Application Express管理ガイド』のエクスポートしたアプリケーションをランタイム環境にインストールに関する項

19.1.11 Oracle Database 11g以上のネットワーク・サービスの有効化

Oracle Database 11g以上のバージョンでのネットワーク・サービスの有効化を理解します。

トピック:

- ネットワーク・サービスを有効化する必要があるタイミングと理由
ネットワーク・サービスを有効化すると、Oracle Application Expressでのアウトバウンド・メールの送信、Oracle Application ExpressでのWebサービスの使用、PDFレポートの出力に対するサポートが有効になります。

- Oracle Database 12cより前の接続権限の付与
APEX_050100データベース・ユーザーに対して、任意のホストへの接続権限を付与する方法を示します。

- Oracle Database 12cでの前の接続権限の付与
DBMS_NETWORK_ACL_ADMINのプロシージャCREATE_ACL、ASSIGN_ACL、ADD_PRIVILEGEおよびCHECK_PRIVILEGEは、Oracle Database 12cでは非推奨です。APPEND_HOST_ACEを使用することをお薦めします。

- 無効なACLエラーのトラブルシューティング
問合せを実行して無効なACLエラーを特定する方法を理解します。

19.1.11.1 ネットワーク・サービスを有効化する必要があるタイミングと理由

ネットワーク・サービスを有効化すると、Oracle Application Expressでのアウトバウンド・メールの送信、Oracle Application ExpressでのWebサービスの使用、PDFレポートの出力に対するサポートが有効になります。

Oracle Database 11gリリース1または2以上では、ネットワーク・サービスとの通信機能が、デフォルトで無効化されています。このため、Oracle Database 11gリリース1または2以上でOracle Application Expressを実行している場合は、新しいDBMS_NETWORK_ACL_ADMINパッケージを使用して、APEX_050100データベース・ユーザーにすべてのホストに対する接続権限を付与する必要があります。これらの権限を付与しないと、次の場合に問題が発生します。

- Oracle Application Expressでアウトバウンド・メールを送信する。
ユーザーはAPEX_MAILパッケージからメソッドをコールできますが、アウトバンド・メールの送信時に問題が発生します。

- Oracle Application ExpressでWebサービスを使用する。

- PDFレポートを印刷する。

ヒント:

このセクションで示されている例を実行するには、データベースのcompatible初期化パラメータが11.1.0.0.0以上に設定されている必要があります。デフォルトでは、11gまたは12cデータベースのパラメータは事前に適切に設定されますが、以前のバージョンから11gまたは12cにアップグレードされたデータベースのパラメータは適切に設定されない場合があります。データベース初期化パラメータの変更の詳細は、『Oracle Database管理者ガイド』のOracle Databaseの作成と構成に関する項を参照してください。

19.1.11.2 Oracle Database 12cより前の接続権限の付与

APEX_050100データベース・ユーザーに対して、任意のホストへの接続権限を付与する方法を示します。

次の例は、APEX_050100データベース・ユーザーに対して、任意のホストへの接続権限を付与する方法を示しています。この例では、Oracle Application Expressがインストールされているデータベースに、SYSDBAロールが指定されているSYSとして接続するとします。

DECLARE
ACL_PATH  VARCHAR2(4000);
BEGIN
-- Look for the ACL currently assigned to '*' and give APEX_050100
-- the "connect" privilege if APEX_050100 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;

IF DBMS_NETWORK_ACL_ADMIN.CHECK_PRIVILEGE(ACL_PATH, 'APEX_050100',
'connect') IS NULL THEN
DBMS_NETWORK_ACL_ADMIN.ADD_PRIVILEGE(ACL_PATH,
'APEX_050100', 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_050100', TRUE, 'connect');
DBMS_NETWORK_ACL_ADMIN.ASSIGN_ACL('power_users.xml','*');
END;
/
COMMIT;

次の例は、ローカル・ネットワーク・リソースへのアクセス権について、より少ない権限を付与する方法を示しています。この例では、電子メールやレポート・サーバーなど、ローカル・ホストのサーバーへのアクセスのみを有効にします。

DECLARE
ACL_PATH  VARCHAR2(4000);
BEGIN
-- Look for the ACL currently assigned to 'localhost' and give APEX_050100
-- the "connect" privilege if APEX_050100 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;

IF DBMS_NETWORK_ACL_ADMIN.CHECK_PRIVILEGE(ACL_PATH, 'APEX_050100',
'connect') IS NULL THEN
DBMS_NETWORK_ACL_ADMIN.ADD_PRIVILEGE(ACL_PATH,
'APEX_050100', 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 users to connect to localhost',
'APEX_050100', TRUE, 'connect');
DBMS_NETWORK_ACL_ADMIN.ASSIGN_ACL('local-access-users.xml','localhost');
END;
/
COMMIT;

19.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_050100データベース・ユーザーに対して、任意のホストへの接続権限を付与する方法を示しています。この例では、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_050100',
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_050100',
principal_type => xs_acl.ptype_db));
END;
/

19.1.11.4 無効なACLエラーのトラブルシューティング

問合せを実行して無効な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_050100ユーザーにACLを適用する必要があります。

19.2 セキュリティに関する開発者のベスト・プラクティスの理解

このセクションでは、Oracle Application Express開発者のためのセキュリティのベスト・プラクティスについて説明します。

トピック:

- タイプ・パスワードのアイテムについて

- 問題を引き起こす可能性のあるパスワード・アイテムの識別

- クロスサイト・スクリプティング保護の理解

- セッション・ステートおよびセキュリティについて

- セッション・ステート保護の理解

- ファイルのアップロードの保護について

関連項目:

- 「セキュリティに関する管理者のベスト・プラクティスの理解」

- 「Oracle Application Express管理者のロールについて」

19.2.1 タイプ・パスワードのアイテムについて

パスワード・アイテムは、Webブラウザ画面に入力されたテキストを表示しません。パスワード・アイテムを作成するときは、セッション・ステートを保存しないパスワード属性を使用することをお薦めします。これによって、パスワードがセッション・ステート表のデータベースに保存されるのを回避できます。

設定可能なパスワード・アイテム・タイプ属性は、次のとおりです。

- 必須の値: 「はい」に設定し、ページ・アイテムが表示されている場合、Oracle Application Expressでは、ページの送信時にNOT NULL検証が自動的に実行されます。「いいえ」に設定すると、検証が行われず、NULL値が受け入れられます。

- [Enter]を押すと送信: 「はい」に設定した場合、ユーザーがフィールドで[ENTER]キーを押すと、ページが送信されます。

- 状態を保存しない: 「はい」に設定すると、パスワードがセッション・ステートに保存されません。セキュリティ上の理由により、この属性は常に「はい」に設定する必要があります。「いいえ」に設定する場合は、「セッション・ステートに暗号化された値を保存」属性を「はい」に設定することを考慮してください。

- 認可スキーム: オプションで認可スキームを選択します。このコンポーネントをレンダリングまたは処理するためには、この認可スキームがTRUEと評価される必要があります。

- セッション・ステート保護: この属性を「制限なし」または「制限付き」に設定して、セッション・ステート保護のレベルを選択できます。

- 制限なし: URLまたはフォームでアイテムを渡して、アイテムを設定できます。URLにチェックサムは必要ありません。

- 制限付き: アイテムをブラウザから設定することはできません。アイテムの値を内部プロセス、計算などに設定できる方法を制限する場合は、このオプションを使用します。この属性は、データ・エントリ・アイテムとして使用できないアイテムのみに適用され、「セッション・ステート保護」が無効になっていても常に監視されます。

- セッション・ステートに暗号化された値を保存: 機密のセッション・ステートは、Application Expressセッション・ステート管理表に格納するときに暗号化することができます。このアイテムの暗号化されたセッション・ステートを保持するには、この値を「はい」に設定します。詳細は、セッション・ステートおよびセキュリティについてを参照してください。

関連項目:

- アイテム・タイプについて

- 「ページ・デザイナでのページ・レベル・アイテムの編集」

- 「コンポーネント・ビューでのページ・レベル・アイテムの作成」

19.2.2 問題を引き起こす可能性のあるパスワード・アイテムの識別

問題を引き起こす可能性のあるパスワード・アイテムは、次のいずれかです。

- セッション・ステートを保存しないパスワード・アイテム・タイプを1つも使用しないもの。

- 暗号化していない値をセッション・ステートに格納するもの。

この項では、「セキュリティ・プロファイル」および「パスワード・アイテム」レポートを使用して、問題を引き起こす可能性のあるパスワード・アイテムを識別する方法について説明します。

トピック:

- 「セキュリティ・プロファイル」レポートの表示

- 「パスワード・アイテム」レポートの表示

19.2.2.1 「セキュリティ・プロファイル」レポートの表示

「セキュリティ・プロファイル」レポートを表示するには、次のステップを実行します。

1. 「ワークスペース」ホームページにナビゲートします。

2. 「アプリケーション・ビルダー」アイコンをクリックします。

アプリケーション・ビルダーのホームページが表示されます。

3. 「ワークスペース・ユーティリティ」アイコンをクリックします。

4. ウィンドウの右側に、「アプリケーション間レポート」があります。

5. 「アプリケーション間レポート」で、「セキュリティ・プロファイル」レポートをクリックします。

このレポートには、現在のワークスペース内のすべてのアプリケーションに関する次の情報が表示されます。

- アプリケーション

- 名前

- 解析対象スキーマ

- アプリケーション・レベル認可スキーム

- 認証

- 認可スキーム

- 認可スキーム

- ページ

- 暗号化アイテム

- 問題を引き起こす可能性のあるパスワード・アイテム

19.2.2.2 「パスワード・アイテム」レポートの表示

問題を引き起こす可能性のあるパスワード・アイテムを識別するには、次のステップを実行します。

1. 「ワークスペース」ホームページにナビゲートします。

2. 「アプリケーション・ビルダー」アイコンをクリックします。

アプリケーション・ビルダーのホームページが表示されます。

3. 「ワークスペース・ユーティリティ」アイコンをクリックします。

4. ウィンドウの右側に、「アプリケーション間レポート」があります。

5. 「アプリケーション間レポート」で、「パスワード・アイテム」をクリックします。

「パスワード・アイテム」レポートには、アプリケーション内にあるすべてのパスワード・アイテムが、暗号化を使用するかどうかおよびステートを保存するかどうかとともに表示されます。いずれも行わないパスワード・アイテムは、「問題を引き起こす可能性」とハイライトされます。

ヒント:

パスワード・アイテムを含むページで、ページ属性「フォームのオートコンプリート」を「オフ」に設定します。この属性を「オフ」に設定すると、Webブラウザによって、ページでアイテムのオートコンプリートが試行されなくなります。

19.2.3 クロスサイト・スクリプティング保護の理解

この項では、クロスサイト・スクリプティング・セキュリティ攻撃からアプリケーションを保護するためのベスト・プラクティスについて説明します。

トピック:

- クロスサイト・スクリプティング・セキュリティ攻撃の概要

- HTMLリージョンなどの静的領域の保護

- 動的出力の保護について

- レポート・リージョンの保護について

- フォーム・アイテムの保護について

- アイテムに入力する文字の制限について

19.2.3.1 クロスサイト・スクリプティング・セキュリティ攻撃の概要

クロスサイト・スクリプティング(XSS)は、動的に生成されるWebページを利用するセキュリティ攻撃です。XSS攻撃では、ユーザーのブラウザに読み込まれたときにアクティブになるスクリプトがWebアプリケーションに送信されます。これらのスクリプトがアクティブになると、データまたは場合によってはセッション資格証明が盗まれ、それらの情報が攻撃者に送信される可能性があります。

悪意のあるコードがOracle Application Expressアプリケーションに侵入すると、通常のページ・レンダリング時に、そのコードがアプリケーション内のHTMLリージョンや他の場所にレンダリングされる可能性があります。セッション・ステートへの不正なコードの挿入を阻止するため、Application Expressエンジンは特定の場合に文字をエスケープします。

19.2.3.2 HTMLリージョンなどの静的領域の保護

この項では、HTMLリージョンなどの静的表示領域を保護する方法について説明します。

トピック:

- HTMLリージョンなどの静的領域の保護について

- 安全なアイテム表示タイプの概要

- 値をエスケープするかどうかを決定するために使用されるルールについて

- 安全なアイテム・タイプを使用したHTMLマークアップの保持および表示について

19.2.3.2.1 HTMLリージョンなどの静的領域の保護について

HTMLリージョンなどの静的領域では、置換文字列を使用してセッション・ステートを参照できます。テンプレート内で使用可能な特別な置換文字列は、シャープ記号(#)で示します(例: #ABC#)。ページまたはアプリケーション・アイテムを参照するには、&ITEM.表記法を使用します。

静的表示領域の例には、HTMLリージョン、ページのヘッダーとフッター、リージョンのヘッダーとフッター、リージョン・タイトル、ボタン・ラベル、ヘルプ・テキスト、フォーム・アイテム・ラベルおよび要素の後のテキスト、テンプレート、(フィールド・テキストの前後の)ラジオ・グループ、イベント成功メッセージ、イベント・エラー・メッセージ、ナビゲーション・バー属性、アプリケーション静的置換文字列値、チャート・ラベルおよび凡例、ブレッドクラムおよびリスト・フレーム・テキスト、カレンダ・テキスト、ラベル、凡例などがあります。

開発者は、感嘆符(!)の後に事前定義済のフィルタ名を続けたものをページまたはアプリケーション・アイテム名、あるいはレポート列参照に追加して、置換値内の特殊文字をエスケープできます。

関連項目:

- 「置換文字列の使用について」

- 置換文字列での出力のエスケープの制御

19.2.3.2.2 安全なアイテム表示タイプについて

セッション・ステートがこのように参照される場合、ページに表示される値には、参照されるアイテムが「表示のみ」で「セッション・ステートの保存」属性が「いいえ」、および特殊をエスケープが「いいえ」に設定されている場合にエスケープされる特殊文字(<、>、&、")が含まれません。

参照されるアイテムに「セッション・ステートの保存」属性が「いいえ」に設定されている「表示のみ」以外の表示タイプが含まれている場合、ページに表示される値には、エスケープされる特殊文字が含まれます。また、アプリケーション・レベルのアイテムには、安全な表示タイプが含まれているとみなされますが、実際にフォーム・アイテムに含まれているような表示プロパティは含まれていません。

関連項目:

ページ・レベル・アイテムの理解

19.2.3.2.3 値をエスケープするかどうかを決定するために使用されるルールについて

Application Expressエンジンは、事前定義済のスマート・エスケープ・ルールを使用して、セッション・ステートからフェッチされた値をエスケープするかどうか、およびいつそれを実行するかを決定します。

このルールを使用するのは、前にリストした表示タイプを使用したアイテムは、通常フィルタ処理(エスケープ)されずにブラウザに表示されることを意図したHTMLを含むテキスト用であるためです。安全に行われる方法は、これらのタイプのアイテムが常にエスケープされてアプリケーションに入力されるルールを実施する以外にありません。たとえば、ユーザーが、Oracle Application Expressのf?p URL構文を使用して、一部のテキストを安全なアイテムに渡す場合、Application Expressエンジンは値をセッション・ステートに保存する際に特殊文字をエスケープします。これにより次の2つの結果が予想されます。

1. 値に特殊文字が含まれていなかった場合、渡された値は指定されたとおりにセッション・ステートに保存される。

2. 値に特殊文字が含まれていた場合、値をセッション・ステートに保存する際に特殊文字をエスケープする。

いずれの状況でも、アイテムは、現在、前述のHTMLリージョンなどの静的領域で&ITEM.表記法を使用して安全に参照できます。

19.2.3.2.4 安全なアイテム・タイプを使用したHTMLマークアップの保持および表示について

前にリストした安全なアイテム・タイプを使用して、ブラウザにHTMLマークアップを保持および表示します。たとえば、安全なページ・アイテムP1_XXX(&P1_XXXを使用)を参照して、太字で一部のテキストをレンダリングする要件があるとします。アイテムP1_XXXには次のHTMLが含まれているとします。

<b>ABABABAB</b>

実行するには、アプリケーション・コントロール(計算、プロセス、アイテムのソース式、アイテムのデフォルト値など)を使用して、値をこれらの安全なアイテムに格納します。値をこのように挿入する場合は、コンテンツの安全性を確認します。これらの方法を使用する場合、Application Expressエンジンは、値をセッション・ステートに保存する際に特殊文字をエスケープしません。

安全なアイテムの安全性は、最終的に、アイテムがページにポストされず、ページ送信の一部としてApplication Expressエンジンに発行されないルールによって確認されます。

19.2.3.3 動的出力の保護について

htp.pなどの方法を使用してセッション・ステートからフェッチし、レンダリングするアイテムは、必要に応じてコードで明示的にエスケープする必要があります。たとえば、ページ上のPL/SQL動的コンテンツ・リージョンで次を使用するとします。

htp.p(v('SOME_ITEM'));

セッション・ステートからフェッチするアイテムの値に予期しないタグやスクリプトが含まれる可能性がある場合は、リージョンで次を使用できます。

htp.p(apex_escape.html(:SOME_ITEM));

ただし、フェッチする値を安全にレンダリングできることが確かな場合は、この値をエスケープする必要はありません。開発者は、出力をエスケープしない方が適切な場合を判断する必要があります。

次のように、このルールに従うことをお薦めします。

- アイテムが安全なタイプでないかぎり、エスケープせずにセッション・ステートからフェッチされたアイテムを表示しないでください。

これを行うのは、開発者としてハッカーが悪意ある値を安全ではないアイテムにポストするのを防ぐ方法はないためです。アプリケーションがこれらのアイテムを一般ユーザーに見えるように表示しなくても、このルールに従わないと、ハッカーはアプリケーションを使用してXSS攻撃をマウントできることに注意してください。

関連項目:

「安全なアイテム表示タイプの概要」

19.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のような名前は構文エラーの原因となり、攻撃者は不適切なエスケープをクロスサイト・スクリプティングに利用できます。

関連項目:

- 置換文字列での出力のエスケープの制御

- ページ・デザイナでの対話モード・レポート列属性の編集

- 「コンポーネント・ビューでの列属性の編集」

19.2.3.5 フォーム・アイテムの保護について

ブラウザに送信されるフォーム・ページの生成中に、フォーム・アイテム(隠しアイテムなど)が値を取得する場合、結果テキストはレンダリング前にエスケープされます。一部の安全なアイテム・タイプは、各表示タイプの意図する動作をサポートするため、このルールにおける例外となります。

一部のアイテム・タイプには、「特殊文字をエスケープ」セキュリティ属性があります。「特殊文字をエスケープ」属性を使用して、値をエスケープするかどうかを指定します。デフォルトでは「はい」に設定されています。HTMLコードを表示する場合は、この属性を「いいえ」に設定します。

開発者は、感嘆符(!)の後に事前定義済のフィルタ名を続けたものをページまたはアプリケーション・アイテム名、あるいはレポート列参照に追加して、置換値内の特殊文字をエスケープできます。

関連項目:

置換文字列での出力のエスケープの制御

19.2.3.6 アイテムに入力する文字の制限について

ユーザーがアイテムに入力できる文字を制限することで、クロスサイト・スクリプティングおよびその他のインジェクション攻撃を制限できます。これを行うためには、「ページ・アイテムの編集」ページの「セキュリティ」リージョンで「制限付き文字」属性を使用します。「制限付き文字」はセッション・ステートに保存できます。使用可能なオプションは次のとおりです。

- - すべての文字を許可 -
制限は適用されません。

- a-Z、0-9と空白のホワイトリスト
文字a-z、A-Z、0-9および空白のみ許可されます。

- ブラックリストHTMLコマンド文字(<>")。
予約済のHTML文字は許可されません。

- ブラックリスト&<>"/;,*|=%および--
&、<、>、"、/、;、","、*、|、=、%および"--" (PL/SQLコメント)は許可されません。

- ブラックリスト&<>"/;,*|=%または--と改行
&、<、>、"、/、;、","、*、|、=、%、"--"、および改行文字は許可されません。

制限を選択する場合、選択された文字制限に一致しないデータをユーザーが保存しようとすると、Oracle Application Expressからエラー・メッセージが表示されます。

関連項目:

「ページ・アイテムのセキュリティの構成」

19.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バイトを超える値を暗号化しようとすると、エラー・メッセージが表示されます。

19.2.5 セッション・ステート保護の理解

セッション・ステート保護は、ハッカーがアプリケーション内のURLを改ざんするのを防ぐための組込み機能です。URL改ざんにより、プログラム・ロジック、セッション・ステートの内容および情報プライバシが悪影響を受ける可能性があります。

トピック:

- セッション・ステート保護の仕組み

- セッション・ステート保護の有効化

- セッション・ステート保護の構成

19.2.5.1 セッション・ステート保護の仕組み

セッション・ステート保護を有効にすると、「ページ・アクセス保護」属性と「セッション・ステート保護」項目属性が、f?p= URL内に配置されたチェックサムとともに使用され、URL改ざんと、セッション・ステートに対する権限のないアクセスおよび変更が防止されます。セッション・ステート保護を無効にすると、セッション・ステート保護に関連するページ属性および項目属性が無視され、生成されるf?p= URLにはチェックサムが含まれません。

19.2.5.2 セッション・ステート保護の有効化

セッション・ステート保護は、セキュリティ属性の編集ページまたはセッション・ステート保護ページから有効にできます。

セッション・ステート保護は2ステップのプロセスで有効にします。最初に、この機能を有効にします。次に、ページおよびアイテムのセキュリティ属性を設定します。これらのステップは、ウィザードを使用して実行するか、セッション・ステート保護ページでページおよびアイテムのセキュリティ属性を手動で設定して行います。

トピック:

- 「セキュリティ属性の編集」からのセッション・ステート保護の有効化

- 「セッション・ステート保護」からのセッション・ステート保護の有効化

19.2.5.2.1 「セキュリティ属性の編集」からのセッション・ステート保護の有効化

セキュリティ属性の編集ページからセッション・ステート保護を有効にするには、次のステップを実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」アイコンをクリックします。

4. 「セキュリティ」で、「セキュリティ属性」をクリックします。

5. 「セッション・ステート保護」までスクロールして、「セッション・ステート保護」リストの「有効」を選択します。

6. セッション・ステート保護を構成するには、「セッション・ステート保護の管理」をクリックします。

セッション・ステート保護ページが表示されます。

7. ウィザードを使用してセッション・ステート保護の有効化、無効化または構成を行うには、「保護の設定」をクリックします。

8. あるいは、適切なページまたはアイテム属性ページにナビゲートし、「セキュリティ」属性を設定します。

ヒント:

セッション・ステート保護を無効にするには、同じステップを再度実行しますが、「有効」のかわりに「無効」を選択します。セッション・ステート保護を無効にしても、既存のセキュリティ属性の設定は変更されませんが、それらの属性は実行時に無視されます。

トピック:

- 「ブックマークの無効化」ボタン

19.2.5.2.1.1 「ブックマークの無効化」ボタンについて

セッション・ステート保護を有効にすると、カレント・アプリケーションへのブックマーク・リンクが機能するかどうかに影響します。次の規則を考慮してください。

1. セッション・ステート保護を有効にした後に作成したブックマーク・リンクは、ブックマーク・リンクにチェックサムが含まれている場合に機能します。

2. セッション・ステート保護を有効にする前に作成したブックマーク・リンクは、ブックマーク・リンクにチェックサムが含まれている場合は機能しません。

3. チェックサムが含まれていないか、または不要なチェックサムが含まれているブックマークは、セッション・ステート保護の影響を受けません。

ページ・レンダリング時、Application Expressエンジンは、計算中に非表示のアプリケーション属性(チェックサムsalt)を使用し、f?p URLに含まれているチェックサムを確認します。セッション・ステート保護を有効にすると、Application Expressエンジンにチェックサムが含まれます。チェックサムsalt属性を再設定するには、セキュリティ属性の編集ページで「ブックマークの無効化」をクリックします。

ヒント:

「ブックマークの無効化」,をクリックすると、アプリケーションへのアクセスに使用されるブックマークURLは、このアプリケーションに以前に生成されたチェックサムが含まれる場合は失敗するので注意してください。

ブックマークの無効化の確認ページで、ブックマーク・チェックサムの計算に使用されるハッシュ・アルゴリズムであるブックマーク・チェックサム・ファンクションを構成することもできます。

19.2.5.2.2 「セッション・ステート保護」からのセッション・ステート保護の有効化

セッション・ステート保護を有効にするには、次のステップを実行します。

1. 共有コンポーネント・ページにナビゲートします。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. 「共有コンポーネント」をクリックします。

d. 「セキュリティ」で、「セッション・ステート保護」を選択します。

セッション・ステート保護ページが表示されます。セッション・ステート保護の現行のステータス(有効または無効)がページ上部に表示されることに注意してください。

2. 「保護の設定」ボタンをクリックします。

「セッション・ステート保護」ウィザードが表示されます。

3. 「操作の選択」で、「有効化」を選択して、「次へ」をクリックします。

次に、ページおよびアイテムのセキュリティ属性を設定するかどうか決定します。

4. 「有効化」を選択して、「次へ」をクリックします。

5. 「セッション・ステート保護の有効化」をクリックします。

ヒント:

セッション・ステート保護を無効にするには、同じステップを実行しますが、「有効化」のかわりに「無効化」を選択します。セッション・ステート保護を無効にしても、既存のセキュリティ属性の設定は変更されませんが、それらの属性は実行時に無視されます。

19.2.5.3 セッション・ステート保護の構成

ヒント:

セキュリティ属性を構成する前に、まずセッション・ステート保護を有効にする必要があります。セッション・ステート保護の有効化を参照してください。

トピック:

- セッション・ステート保護の構成について

- 既存のセッション・ステート保護設定の確認

- ウィザードを使用したセッション・ステート保護の構成

- ページのセッション・ステート保護の構成

- ページ・アイテムのセッション・ステート保護の構成

- アプリケーション・アイテムのセッション・ステート保護の構成

19.2.5.3.1 セッション・ステート保護の構成について

セッション・ステート保護を有効にした後、セキュリティ属性を構成します。セキュリティ属性は2つの方法で構成できます。

- ウィザードを使用し、特定の属性カテゴリの値を選択する。この場合、選択内容がアプリケーション内のすべてのページおよびアイテムに適用されます。

- 個々のページ、アイテムまたはアプリケーション・アイテムの値を構成する。

19.2.5.3.2 既存のセッション・ステート保護設定の確認

「セッション・ステート保護」ウィザードの最初のページでは、ページ、アイテムおよびアプリケーション・アイテムのセッション・ステート保護設定のサマリーを確認できます。

既存のセッション・ステート保護設定のサマリーを表示するには、次のステップを実行します。

1. 「セッション・ステート保護」ページにナビゲートします。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. 「共有コンポーネント」をクリックします。

d. 「セキュリティ」で、「セッション・ステート保護」を選択します。

セッション・ステート保護ページが表示されます。

2. 「保護の設定」をクリックします。

3. ページ下部で次のレポートを開きます。

- ページ・レベルのセッション・ステート保護サマリー

- ページ・アイテムのセッション・ステート保護サマリー

- アプリケーション・アイテムのセッション・ステート保護

19.2.5.3.3 ウィザードを使用したセッション・ステート保護の構成

ウィザードを使用してセッション・ステート保護を構成するときは、特定の属性カテゴリの値を設定します。この場合、選択内容がアプリケーション内のすべてのページおよびアイテムに適用されます。

ウィザードを使用してセッション・ステート保護を構成するには、次のステップを実行します。

1. 「セッション・ステート保護」ページにナビゲートします。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. 「共有コンポーネント」をクリックします。

d. 「セキュリティ」で、「セッション・ステート保護」を選択します。

セッション・ステート保護ページが表示されます。

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. 「終了」をクリックします。

19.2.5.3.4 ページのセッション・ステート保護の構成

ページのセッション・ステート保護を構成するには、次のステップを実行します。

1. 「セッション・ステート保護」ページにナビゲートします。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. 「共有コンポーネント」をクリックします。

d. 「セキュリティ」で、「セッション・ステート保護」を選択します。

セッション・ステート保護ページが表示されます。

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. 「変更の適用」をクリックします。

関連項目:

「検索バーについて」

19.2.5.3.5 ページ・アイテムのセッション・ステート保護の構成

アイテムのセッション・ステート保護を構成するには、次のステップを実行します。

1. 「セッション・ステート保護」ページにナビゲートします。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. 「共有コンポーネント」をクリックします。

d. 「セキュリティ」で、「セッション・ステート保護」を選択します。

セッション・ステート保護ページが表示されます。

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. 「変更の適用」をクリックします。

関連項目:

「検索バーについて」

19.2.5.3.6 アプリケーション・アイテムのセッション・ステート保護の構成

アプリケーション・アイテムのセッション・ステート保護を構成するには、次のステップを実行します。

1. 「セッション・ステート保護」ページにナビゲートします。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. 「共有コンポーネント」をクリックします。

d. 「セキュリティ」で、「セッション・ステート保護」を選択します。

セッション・ステート保護ページが表示されます。

2. 「アプリケーション・アイテム」アイコンをクリックします。

3. ページ上部の検索バーを使用してページの概観をカスタマイズできます。

4. アプリケーション・アイテムを選択します。

5. 「セキュリティ」で、「セッション・ステート保護」リストから次のいずれかを選択します。

- 制限なし: URLまたはフォームでアイテム名/値を渡して、アイテムのセッション・ステートを設定できます。URLにチェックサムは必要ありません。
注意: Ajaxを使用してこのアイテムの値をセッション・ステートに設定する必要がある場合は、アイテムに対して「制限なし」保護レベルを使用する必要があります(たとえば「動的アクション」の場合は、「値の設定」、「送信するページ・アイテム」または「カスケードLOV」、「送信するページ・アイテム」)。

- 制限付き - ブラウザから設定できない: URLまたはPOSTDATAを使用してアイテムを変更できません。アイテムの値を内部プロセス、計算などに設定できる方法を制限する場合は、このオプションを使用します。この属性は、データ・エントリ・アイテムとして使用できないアイテムのみに適用され、セッション・ステート保護が無効になっていても常に監視されます。次の表示形式タイプのアプリケーション・アイテムについては、この属性を使用します。

- テキストとして表示(特殊文字をエスケープし、状態は保存しない)

- テキストとして表示(状態は保存しない)

- テキストとして表示(LOVに基づき、状態は保存しない)

- テキストとして表示(PL/SQLに基づき、状態は保存しない)

- テキスト・フィールド(無効、状態を保存しない)

- HTML表の停止および開始(ラベルのみ表示)

- チェックサムが必要 - アプリケーション・レベル: スキーマ固有のチェックサムを入力する場合は、URLでアイテムの名前/値を渡して、アイテムのセッション・ステートを設定できます。ユーザー・レベル・チェックサムまたはセッション・レベル・チェックサムも使用できます(次の項目を参照)。現行のワークスペースの別のセッションで同じアプリケーションを実行しているユーザーが生成したチェックサムを含むURLによってのみ、このアイテムを設定できるようにする場合に、このオプションを使用します。

- チェックサムが必要: ユーザー・レベル: ワークスペース、アプリケーションおよびユーザー固有のチェックサムを入力する場合は、URLでアイテムの名前/値を渡して、アイテムのセッション・ステートを設定できます。セッション・レベル・チェックサムも使用できます(次の項目を参照)。現行のワークスペースの別のセッションで同じアプリケーションを実行しているユーザーが生成したチェックサムを含むURLによってのみ、このアイテムを設定できるようにする場合に、このオプションを使用します。

- チェックサムが必要: セッション・レベル: カレント・セッション固有のチェックサムを入力する場合は、URLでアイテムの名前/値を渡して、アイテムのセッション・ステートを設定できます。カレント・セッションで生成されたチェックサムを含むURLによってのみ、このアイテムを設定できるようにする場合に、このオプションを使用します。

6. 「変更の適用」をクリックします。

関連項目:

「検索バーについて」

19.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

いずれの方法の場合も、アップロードされたファイルは、パブリック表ではなく、スキーマ表に格納されます。

関連項目:

- ページ・アイテムとアプリケーション・アイテムの違いについて

- ファイル参照ページ・レベル・アイテムの作成の詳細は、「アイテム・タイプについて」を参照してください

19.3 アプリケーション、ページおよびページ・コンポーネントへのアクセスの制御

アクセス制御リストを作成することによって、アプリケーション、個別ページまたはページ・コンポーネントへのアクセスを制御できます。アクセス制御ページを作成するには、アプリケーション・スキーマにCREATE TABLE、CREATE TRIGGER、CREATE SEQUENCE権限を割り当てる必要があります。

トピック:

- アクセス制御リストの動作方法

- アクセス制御リストの作成

- アプリケーション・モードの選択とユーザーの追加

- ページおよびページ・コンポーネントに対するアクセスの制御について

関連項目:

Oracle Application Express SQLワークショップ・ガイドの「クエリー・ビルダーを使用した問合せの構築」

19.3.1 アクセス制御リストの動作方法

アクセス制御ウィザードを実行して、アクセス制御リストを作成します。アクセス制御ウィザードは、アプリケーション・モードのリストとアクセス制御リストを含むアクセス制御管理ページという名前のページを作成します。アクセス制御管理ページを作成したら、次のステップを実行する必要があります。

- ステップ1 - アクセス制御管理ページを実行します。

- ステップ2 - 次のいずれかのアプリケーション・モードを選択します。

- すべての対象への完全なアクセス権。アクセス制御リストは使用されません。

- 制限されたアクセス。アクセス制御リストに定義されたユーザーのみが許可されます。

- パブリック読取り専用。アクセス制御リストによって制御される編集および管理の権限です。

- 管理アクセス専用。

- ステップ3 - アクセス制御リストにユーザーを追加します。

アクセス制御管理ページを作成する以外に、アクセス制御ウィザードでは次のものを作成します。

- アクセス制御を管理するためのアプリケーションのデフォルト・スキーマ内に2つの表

- アプリケーション・モード・リストのオプションに対応する認可スキーム

- 「アクセス制御」リストで使用可能な権限

これらの認可スキームの中の1つをページまたはコンポーネント属性ページで選択することで、特定のページまたはページ・コンポーネントへのアクセスを制御できます。アクセス制御を作成したら、アプリケーションの特定のニーズに合うようにページ、表および値をカスタマイズできます。

関連項目:

アプリケーションへの認可スキームの割当て

19.3.2 アクセス制御リストの作成

ページを作成することでアクセス制御リストを作成します。アプリケーションのホームページ上またはページの表示中にページを作成できます。

トピック:

- アプリケーションのホームページからのアクセス制御リストの作成

- ページ編集中のアクセス制御の作成

19.3.2.1 アプリケーションのホームページからのアクセス制御リストの作成

アプリケーションのホームページからアクセス制御リストを作成するには、次のようにします。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

アプリケーションのホームページが表示されます。

3. 「ページの作成」をクリックします。

4. 「ページの作成」で、次のステップを実行します。

a. ユーザー・インタフェース: ページのユーザー・インタフェースを選択します。

b. ページ・タイプの選択: 「アクセス制御」を選択します。

c. 「次へ」をクリックします。

5. 「ページ」で、次のステップを実行します。

a. 管理ページ番号: 未使用のページ番号を指定します。

b. ページ・モード: ページ・モードを選択します。詳細は、フィールドレベル・ヘルプを参照してください。

c. ページ・グループ - ページ・グループを選択します。

d. 「次へ」をクリックします。

6. 「ナビゲーションのプリファレンス」で、このページに含めるナビゲーションのタイプを指定し、「次へ」をクリックします。ナビゲーション・オプション(ナビゲーション・メニューまたはタブなど)はカレント・アプリケーションのテーマに応じて決まります。

7. ページを確認して、「作成」をクリックします。

19.3.2.2 ページ編集中のアクセス制御の作成

ページ編集中にアクセス制御リストを作成するには、次のステップを実行します。

1. 適切なページにナビゲートします。

2. ページの作成ウィザードにアクセスします。

- ページ・デザイナ - ページ上部の「作成」メニューをクリックして、「ページ」を選択します。

- コンポーネント・ビュー - ページ上部の「作成」メニューをクリックして、「新しいページ」を選択します。

3. 「ページの作成」で、次のステップを実行します。

a. ユーザー・インタフェース: ページのユーザー・インタフェースを選択します。

b. ページ・タイプの選択: 「アクセス制御」を選択します。

c. 「次へ」をクリックします。

4. 「新しいページ」をクリックし、「新しいページ」を選択します。

5. ページ・タイプとして「アクセス制御」を選択し、「次へ」をクリックします。

アクセス制御ウィザードウィザードが表示されます。

6. 「ページ」で、次のステップを実行します。

a. 管理ページ番号: 未使用のページ番号を指定します。

b. ページ・モード: ページ・モードを選択します。詳細は、フィールドレベル・ヘルプを参照してください。

c. 「次へ」をクリックします。

7. 「ナビゲーションのプリファレンス」で、このページに含めるナビゲーションのタイプを指定し、「次へ」をクリックします。ナビゲーション・オプション(ナビゲーション・メニューまたはタブなど)はカレント・アプリケーションのテーマに応じて決まります。

8. ページを確認して、「作成」をクリックします。

19.3.3 アプリケーション・モードの選択とユーザーの追加

アクセス制御管理ページを実行し、アプリケーション・モードを選択してからアクセス制御リストへユーザーを追加することによって、アプリケーションへのアクセスを制御できます。

トピック:

- アプリケーション・モードの選択

- アクセス制御リストへのユーザーの追加と権限の選択

- アクセス制御リストからのユーザーの削除

19.3.3.1 アプリケーション・モードの選択

アプリケーション・モードを選択するには、次のようにします。

1. アクセス制御リストを作成します。

アクセス制御管理というページが作成されます。

2. アクセス制御管理ページを実行します。

3. アプリケーション・モードで、次のオプションを選択します。

- すべての対象への完全なアクセス権。アクセス制御リストは使用されません。
すべてのユーザーがアプリケーションにアクセスできるようにするには、このオプションを選択します。

- 制限されたアクセス。アクセス制御リストに定義されたユーザーのみが許可されます。
アクセス制御リスト上のユーザーのみにアクセスを許可するには、このオプションを選択します。アクセス制御リスト上のユーザーのみが、認可スキームに関連付けられたページおよびコンポーネントを表示できます。

- パブリック読取り専用。アクセス制御リストによって制御される編集および管理の権限です。
アクセス制御 - 認可スキームの表示に関連付けられたページおよびコンポーネントに、パブリック・アクセスを提供します。

- 管理アクセス専用。
管理者権限を持つユーザーのみが、認可スキームに関連付けられたページまたはコンポーネントにアクセスできます。

4. 「アプリケーション・モードの設定」をクリックします。

ページのユーザー・インタフェースは、アプリケーションで選択したテーマによって異なります。

次は、アクセス制御リストにユーザーを追加します。

関連項目:

- 「アクセス制御リストの作成」

- アプリケーションまたはページの実行

- テーマの使用

19.3.3.2 アクセス制御リストへのユーザーの追加と権限の選択

アクセス制御リストにユーザーを追加するには、次のようにします。

1. アクセス制御リストを作成します。

アクセス制御管理というページが作成されます。

2. アクセス制御管理ページを実行します。

3. アクセス制御リストの下で、「ユーザーの追加」をクリックします。

新しい行が表示されます。

4. 「ユーザー名」フィールドにユーザー名を入力します。

5. ユーザーに権限を関連付けます。使用可能なオプションは次のとおりです。

- 管理者

- 編集

- 表示

6. 「変更の適用」をクリックします。

7. すべてのユーザーに対して、ステップ1から5を繰り返します。

関連項目:

- 「アクセス制御リストの作成」

- アプリケーションまたはページの実行

19.3.3.3 アクセス制御リストからのユーザーの削除

アクセス制御リストからユーザーを削除するには、次のようにします。

1. ユーザー名の左側のチェック・ボックスを選択して、削除するユーザーを選択します。

2. 「削除」をクリックします。

19.3.4 ページおよびページ・コンポーネントに対するアクセスの制御について

アクセス制御ウィザードでは、アプリケーション・モード・リストのオプションとアクセス制御リストで可能な権限に対応する認可スキームが作成されます。

次の認可スキームの中の1つをページまたはコンポーネント属性ページで選択することで、特定のページまたはページ・コンポーネントへのアクセスを制御できます。

- アクセス制御 - 管理者。管理者権限を持つユーザーのみがページまたはコンポーネントを表示できます。

- アクセス制御 - 編集。編集および管理者権限の両方を持つユーザーがページまたはコンポーネントを表示できます。表示権限を持つユーザーはページまたはコンポーネントを表示できません。

- アクセス制御 - 表示。管理者、編集または表示権限を持つユーザーがページまたはコンポーネントを表示できます。

- 非アクセス制御 - 管理者。管理者権限を持つユーザーはページまたはコンポーネントを表示できません。

- 非アクセス制御 - 編集。編集および管理者権限の両方を持つユーザーはページまたはコンポーネントを表示できません。表示権限を持つユーザーがページまたはコンポーネントを表示できます。

- 非アクセス制御 - 表示。管理者、編集または表示権限を持つユーザーはページまたはコンポーネントを表示できません。

関連項目:

アプリケーション、ページまたはコンポーネントへの認可スキームの割当て

19.4 認証によるユーザー・アイデンティティの証明

認証は、ユーザーがアプリケーションにアクセスする前に、そのユーザーの本人確認を行うプロセスです。この項では、認証を使用してユーザーのアイデンティティを証明する方法について説明します。

トピック:

- 認証の理解

- 認証スキームの作成

- 事前構成済の認証スキームの理解

- 既存の認証スキームの管理

- アプリケーションに関連付けられた認証スキームの表示

- アプリケーションに関連付けられた認証スキームの変更

- ログイン・ページの作成

- 認証スキーム・レポートの表示

19.4.1 認証の理解

認証では、ユーザーにユーザー名とパスワードの指定を要求するか、またはデジタル証明書や保護キーを使用する可能性があります。

トピック:

- 認証の仕組み

- ディープ・リンクのサポートについて

- 認証を含めるかどうかの決定について

19.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」

- 「セキュリティ属性の構成」

19.4.1.2 ディープ・リンクのサポートについて

認証スキームを使用するOracle Application Expressアプリケーションでは、ディープ・リンクがサポートされています。ディープ・リンクは、コンテキスト外(たとえば、電子メールのハイパーリンクまたはワークフロー通知から)のOracle Application Expressページにリンクする機能を指します。コンテキスト外のページにリンクし、そのアプリケーションでユーザー認証が必要な場合、ログイン・ページが表示されます。資格証明の検証後、Application Expressエンジンは元のリンクで参照されていたページを自動的に表示します。

19.4.1.3 認証を含めるかどうかの決定について

アプリケーションを作成する場合、認証を含めるかどうかを決定する必要があります。次の選択肢があります。

- 認証不要の選択。Oracle Application Expressはすべてのユーザーの資格証明をチェックしません。アプリケーションのすべてのページには、すべてのユーザーからアクセスできます。

- 組込み認証スキームの選択。使用可能な事前構成済の認証スキームに基づいて、認証方式を作成します。選択するスキームによっては、Oracle 10giAS、Oracle Internet Directoryまたは他の外部サービスの対応するコンポーネントを構成する必要もあります。

- カスタム認証スキームの作成。カスタム認証方式を作成すると、認証インタフェースを完全に制御できます。この方法を実装するには、Application Expressエンジンが各ページ・リクエストを処理する前に実行するPL/SQLファンクションを提供する必要があります。このファンクションのブール戻り値によって、Application Expressエンジンが通常どおりにページを処理するか、または失敗ページを表示するかが決まります。

関連項目:

- 事前構成済の認証スキームの理解

- 「アプリケーションに関連付けられた認証スキームの変更」

- 「認可スキームの作成および編集」

19.4.2 認証スキームの作成

認証スキームを作成するには、次のステップを実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

共有コンポーネント・ページが表示されます。

4. 「セキュリティ」で、「認証スキーム」を選択します。

認証スキーム・ページが表示されます。

5. ページ上部の検索バーを使用してページの概観をカスタマイズできます。

6. 新しい認証スキームを作成するには、「作成」をクリックします。

7. 次のいずれかの項目を選択して、スキームの作成方法を指定します。

- 「ギャラリからの事前構成済スキームに基づく」。

- 「既存の認証スキームのコピーとして」。

8. 画面に表示されるステップに従います。

関連項目:

- 事前構成済の認証スキームの理解

- 「カスタム認証」

- 「検索バーについて」

19.4.3 事前構成済の認証スキームの理解

ギャラリから認証スキームを作成すると、標準動作の認証およびセッション管理を行う事前構成済認証スキームを選択できます。新しい認証スキームを作成すると、そのスキームは自動的に選択したアプリケーションのカレント認証スキームになります。この項では、Oracle Application Expressに付属するすべての事前構成済認証スキームについて説明します。

ヒント:

認証スキームはプラグインをサポートします。詳細は、プラグインの実装を参照してください。

トピック:

- Application Expressアカウント

- カスタム認証

- データベース・アカウント

- HTTPヘッダー変数

- LDAPディレクトリの検証

- 認証なし(DADを使用)

- 公開資格証明

- Oracle Application Server Single Sign-On Server

19.4.3.1 Application Expressアカウント

この項では、Application Expressアカウント認証スキームを使用するタイミングおよびその構成方法について説明します。

トピック:

- Application Expressアカウントについて

- Application Expressアカウント認証の設定

19.4.3.1.1 Application Expressアカウントについて

Application Expressアカウントは、Oracle Application Expressのユーザー・リポジトリで作成および管理されるユーザー・アカウントです。この方式を使用すると、これらのアカウントに対してアプリケーションが認証されます。

Application Expressアカウントは、次のような場合に有効です。

- ユーザー・アカウント・リポジトリを制御する場合。

- ユーザー名およびパスワードに基づいたセキュリティで十分な場合。

- シングル・サインオン・フレームワークへの統合が不要な場合。

この方法は特に、ユーザー・グループを新しいアプリケーションで迅速に起動および実行する必要がある場合に適しています。

関連項目:

『Oracle Application Express管理ガイド』の「Application Expressユーザーの管理」

19.4.3.1.2 Application Expressアカウント認証の設定

Application Expressアカウントを設定するには、次のステップを実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

共有コンポーネント・ページが表示されます。

4. 「セキュリティ」で、「認証スキーム」を選択します。

5. 認証スキーム・ページで、「作成」をクリックします。

6. 「ギャラリからの事前構成済スキームに基づく」を選択し、「次へ」をクリックします。

7. 「名前」で、次の項目を指定します。

a. 名前: 他のアプリケーション開発者が認証スキームを参照するための名前を入力します。

b. スキーム・タイプ: 「Application Expressアカウント」を選択します。

c. 「認証スキームの作成」をクリックします。

19.4.3.2 カスタム認証

この項では、カスタム認証を使用するタイミングおよびその構成方法について説明します。

トピック:

- カスタム認証について

- カスタム認証の設定

- セッション管理セキュリティについて

19.4.3.2.1 カスタム認証について

認証スキームを最初から作成すると、認証インタフェースを完全に制御できます。これは、次のいずれかに該当する場合に最適な方法です。

- データベース認証または他の方式が適切でない。

- 独自のログイン・フォームおよび関連方式を開発する必要がある。

- セッション管理のセキュリティ面を制御する必要がある。

- ユーザー・レベルまたはセッション・レベルでアクティビティを記録または監査する必要がある。

- セッションのアクティビティ制限または存続期限を施行する必要がある。

- Oracle Application Expressページ・プロセスの前に一方向の条件付きリダイレクト・ロジックをプログラムする必要がある。

- 一般的なセッション管理フレームワークを使用して、アプリケーションをOracle Application Express以外のアプリケーションと統合する必要がある。

- アプリケーションが、シームレス(たとえば、複数のアプリケーションID)に動作する複数のアプリケーションで構成されている。

ヒント:

複数のアプリケーションで同じ認証スキームの使用を計画している場合は、カスタム認証プラグインの記述を検討してください。プラグインの実装を参照してください。

19.4.3.2.2 カスタム認証の設定

カスタム認証スキームを作成するには、次のステップを実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

共有コンポーネント・ページが表示されます。

4. 「セキュリティ」で、「認証スキーム」を選択します。

5. 認証スキーム・ページで、「作成」をクリックします。

6. 「ギャラリからの事前構成済スキームに基づく」を選択し、「次へ」をクリックします。

7. 「名前」で、次の項目を指定します。

a. 名前: 他のアプリケーション開発者が認証スキームを参照するための名前を入力します。

b. スキーム・タイプ: 「カスタム」を選択します。

8. 該当するフィールドに入力します。

特定のフィールドの詳細は、フィールドレベル・ヘルプを参照してください。ヘルプが使用可能な場合は、カーソルをあわせると、アイテム・ラベルが疑問符付きに変わります。

9. 「認証スキームの作成」をクリックします。

関連項目:

「フィールドレベル・ヘルプの表示」

19.4.3.2.3 セッション管理セキュリティについて

Oracle Application Expressは、カスタム認証を実行する際に、次の2つの不適切な状況が発生しないようにします。

- あるユーザーが、他のユーザーに属するセッション・ステートに故意にアクセスしようとすること。ただし、ユーザーは任意のアプリケーション・セッションIDをURLに入力できます。

- 失効したセッション・ステート(多くの場合、同じユーザーに属する以前のセッション・ステート)が不注意にアクセスされること。これは一般的に、アプリケーション・ページへのブックマークを使用したために発生します。

Oracle Application Expressは、カスタム認証ファンクションによって設定されたユーザーIDトークンが、アプリケーション・セッションが最初に作成された際に記録されたユーザーIDと一致するかどうかを確認します。ユーザーがまだ認証されておらず、ユーザーIDが認識されていない場合、アクセスをしているセッション・ステートは、他のユーザーに属していません。これらの確認によって、リクエスト内のセッションIDが使用可能かどうかが判断されます。セッションIDが使用不可能な場合、Application Expressエンジンは適切なセッションIDを使用して、同じページにリダイレクトします。

19.4.3.3 データベース・アカウント

この項では、データベース・アカウント資格証明認証を使用するタイミングおよびその構成方法について説明します。

トピック:

- データベース・アカウント資格証明について

- データベース・アカウント資格証明の設定

19.4.3.3.1 データベース・アカウント資格証明について

データベース・アカウント資格証明は、データベース・スキーマ・アカウントを使用します。この認証スキームでは、データベース・ユーザー(スキーマ)はローカル・データベースに存在している必要があります。この方法を使用する場合、ユーザーの認証にデータベース・アカウントのユーザー名およびパスワードが使用されます。適用可能なアプリケーションの指定したユーザーごとに1つのデータベース・アカウントを持ち、ニーズに対応したデータベース・ツールによるアカウントのメンテナンスを行う場合は、データベース・アカウント資格証明を選択します。

19.4.3.3.2 データベース・アカウント資格証明の設定

データベース・アカウント資格証明を設定するには、次の手順を実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

共有コンポーネント・ページが表示されます。

4. 「セキュリティ」で、「認証スキーム」を選択します。

5. 認証スキーム・ページで、「作成」をクリックします。

6. 「ギャラリからの事前構成済スキームに基づく」を選択し、「次へ」をクリックします。

7. 「名前」で、次の項目を指定します。

a. 名前: 他のアプリケーション開発者が認証スキームを参照するための名前を入力します。

b. スキーム・タイプ: 「データベース・アカウント」を選択します。

c. 「認証スキームの作成」をクリックします。

19.4.3.4 HTTPヘッダー変数

この項では、HTTPヘッダー変数認証を使用するタイミングおよびその構成方法について説明します。

トピック:

- HTTPヘッダー変数について

- HTTPヘッダー変数の設定

19.4.3.4.1 HTTPヘッダー変数について

HTTPヘッダー変数は、ヘッダー変数を使用したユーザーの識別およびApplication Expressのユーザー・セッションの作成をサポートします。会社で、アプリケーションおよびテクノロジ全体でシングル・サインオンを実現するOracle Access Managerのような集中型Web認証ソリューションを使用する場合は、この認証スキームを使用します。これらのシステムによってユーザー資格証明検証が実行され、REMOTE_USER(デフォルト)のようなHTTPヘッダー変数を使用してOracle Application Expressにユーザー名が渡されます。

19.4.3.4.2 HTTPヘッダー変数の設定

HTTPヘッダー変数を設定するには、次のステップを実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

共有コンポーネント・ページが表示されます。

4. 「セキュリティ」で、「認証スキーム」を選択します。

5. 認証スキーム・ページで、「作成」をクリックします。

6. 「ギャラリからの事前構成済スキームに基づく」を選択し、「次へ」をクリックします。

7. 「名前」で、次の項目を指定します。

a. 名前: 他のアプリケーション開発者が認証スキームを参照するための名前を入力します。

b. スキーム・タイプ: 「HTTPヘッダー変数」を選択します。

8. 該当するフィールドに入力します。

特定のフィールドの詳細は、フィールドレベル・ヘルプを参照してください。

9. 「認証スキームの作成」をクリックします。

関連項目:

「フィールドレベル・ヘルプの表示」

19.4.3.5 LDAPディレクトリの検証

この項では、LDAP資格証明認証を使用するタイミングおよびその構成方法について説明します。

トピック:

- LDAPディレクトリの検証について

- LDAPディレクトリの検証の設定

19.4.3.5.1 LDAPディレクトリの検証について

ログイン・ページを使用する認証スキームは、Lightweight Directory Access Protocol(LDAP)を使用して、ログイン・ページで送信されるユーザー名およびパスワードを検証するように構成できます。

アプリケーション・ビルダーには、このオプションの構成方法を示すウィザードと編集ページが含まれています。これらのウィザードでは、この構成のために、ご使用のアプリケーションにアクセス可能なLDAPディレクトリがすでに存在していることと、LDAPディレクトリが資格証明の検証のSIMPLE_BIND_Sコールに応答できることを想定しています。LDAP資格証明の認証スキームを作成する場合、SSL、LDAPホスト名、LDAPポート、DN文字列、SSLの使用の有無、完全なDN、および完全なDNを使用しない場合のオプションの検索フィルタが要求され保存されます。オプションの事前処理ファンクションを指定して、APIに渡されるユーザー名の書式設定を調整できます。

19.4.3.5.2 LDAPディレクトリの検証の設定

LDAPディレクトリを設定するには、次のステップを実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

共有コンポーネント・ページが表示されます。

4. 「セキュリティ」で、「認証スキーム」を選択します。

5. 認証スキーム・ページで、「作成」をクリックします。

6. 「ギャラリからの事前構成済スキームに基づく」を選択し、「次へ」をクリックします。

7. 「名前」で、次の項目を指定します。

a. 名前: 他のアプリケーション開発者が認証スキームを参照するための名前を入力します。

b. スキーム・タイプ: 「LDAPディレクトリ」を選択します。

8. 「設定」で、次のステップを実行します。

a. ホスト: LDAPディレクトリ・サーバーのホスト名を入力します。

b. ポート: LDAPディレクトリ・ホストのポート番号を入力します。デフォルトは389です。

c. SSLの使用: LDAPディレクトリへのバインドにSSLを使用するかどうかを選択します。認証付きSSLを選択すると、Application Expressインスタンスに対してウォレットを構成する必要があります。

d. 識別名(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)

e. 識別名(DN)の使用: LDAP識別名(DN)文字列が完全か非完全かを選択します。非完全の場合、LDAP識別名(DN)は検索ベースで、検索フィルタを指定する必要があります。

f. LDAPユーザー名編集ファンクション: ユーザー名をLDAPディレクトリ・エントリまたはLDAPユーザー名に最適な形式に変換するために実行される追加コードを指定できます。バインド変数:USERNAMEには、エンド・ユーザーが指定した名前が含まれます。たとえば、次のコードでは、DN文字列のすべてのピリオド(.)をアンダースコア(_)に置換する関数がコールされます。

return apex_custom_auth.ldap_dnprep(p_username => :USERNAME);

g. ユーザー名エスケープ: Oracle Application Expressが%LDAP_USER%で特殊文字をエスケープする方法を選択します。この属性の適切な値は、使用するLDAPサーバーおよびLDAPユーザー名編集ファンクションがすでに特殊文字をエスケープしているかどうかによって異なります。

特定のフィールドの詳細は、フィールドレベル・ヘルプを参照してください。

9. 「認証スキームの作成」をクリックします。

注意:

SSLモードとして「認証付きSSL」を選択する場合は、Oracle Application Expressのインスタンス設定を使用してウォレットを設定する必要があります。また、LDAPサーバーのルート証明書を信頼できる証明書としてこのウォレットにインポートする必要があります。

関連項目:

- 「フィールドレベル・ヘルプの表示」

- 『Oracle Application Express管理ガイド』のウォレット情報の構成に関する項

- 『Oracle Database Advanced Securityガイド』のOracle Wallet Managerの使用に関する項

19.4.3.6 認証なし(DADを使用)

この項では、データベース・アクセス記述子(DAD)データベース認証を使用するタイミングおよびその構成方法について説明します。

トピック:

- DAD資格証明の検証について

- DAD資格証明の検証の設定

19.4.3.6.1 DAD資格証明の検証について

DAD資格証明の検証では、Oracleデータベース・ネイティブ認証およびユーザー・メカニズムを使用し、基本認証スキームを使用してユーザーを認証します。この認証スキームでは、DAD構成に格納された値か、アカウント情報がDAD構成に格納されていない場合はBasic認証要求を使用して取得されるユーザー名のいずれかとして、データベース・アクセス記述子(DAD)からユーザー名が取得されます。

DAD資格証明の検証を使用するには、次の条件を満たす必要があります。

- 各アプリケーション・ユーザーが、Oracle Databaseにユーザー・アカウントを持っている。

- Basic認証用のPL/SQL DADを構成している(アカウント情報なし)。
これによって、アプリケーション・ユーザーは、ブラウザ・セッションごとに1回ユーザー名/パスワードを要求されます。その後、ユーザー・アイデンティティ・トークンがAPP_USERアイテム内で使用可能になります。

DADデータベース認証は、管理可能な数のユーザーに対して最小限の設定のみが必要な認証方式を実装する場合に役立ちます。これらのユーザーがデータベース内に自己管理されたアカウントを持っており、この認証方式を短期間(たとえば、開発のデモンストレーションまたはプロトタイプ段階の間)のみ使用することが理想です。

この方法の主なデメリットは、特にユーザーが自分のパスワードを管理していないか、またはユーザーのデータベース・アカウントがアプリケーションへの認証を容易化するためのみに存在している場合に、アカウントのメンテナンスが負担となることです。

19.4.3.6.2 DAD資格証明の検証の設定

DAD資格証明の検証を設定するには、次の手順を実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

共有コンポーネント・ページが表示されます。

4. 「セキュリティ」で、「認証スキーム」を選択します。

5. 認証スキーム・ページで、「作成」をクリックします。

6. 「ギャラリからの事前構成済スキームに基づく」を選択し、「次へ」をクリックします。

7. 「名前」で、次の項目を指定します。

a. 名前: 他のアプリケーション開発者が認証スキームを参照するための名前を入力します。

b. スキーム・タイプ - 「認証なし」を選択します。

8. 「認証スキームの作成」をクリックします。

19.4.3.7 公開資格証明

この項では、公開資格証明を使用するタイミングおよびその構成方法について説明します。

トピック:

- 公開資格証明について

- 公開資格証明の設定

19.4.3.7.1 公開資格証明について

公開資格証明を使用すると、ユーザー名を取得する組込みログイン・ページを使用して、自分のアプリケーションがすべてのユーザーからアクセス可能になります。この認証方式は、アプリケーションの開発時に有用です。

19.4.3.7.2 公開資格証明の設定

公開資格証明を設定するには、次の手順を実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

共有コンポーネント・ページが表示されます。

4. 「セキュリティ」で、「認証スキーム」を選択します。

5. 認証スキーム・ページで、「作成」をクリックします。

6. 「ギャラリからの事前構成済スキームに基づく」を選択し、「次へ」をクリックします。

7. 「名前」で、次の項目を指定します。

a. 名前: 他のアプリケーション開発者が認証スキームを参照するための名前を入力します。

b. スキーム・タイプ: 「公開資格証明」を選択します。

8. 「認証スキームの作成」をクリックします。

19.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の設定

19.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エンジンにユーザー・アイデンティティおよびその他の情報を渡します。その後、ユーザーはログオフするか、ブラウザ・セッションを終了するか、またはその他のセッション終了イベントが発生するまでアプリケーションを使用できます。

19.4.3.8.2 Oracle Application Server Single Sign-Onの設定

Oracle Application Server Single Sign-Onを設定するには、次の手順を実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

共有コンポーネント・ページが表示されます。

4. 「セキュリティ」で、「認証スキーム」を選択します。

5. 認証スキーム・ページで、「作成」をクリックします。

6. 「ギャラリからの事前構成済スキームに基づく」を選択し、「次へ」をクリックします。

7. 「名前」で、次の項目を指定します。

a. 名前: 他のアプリケーション開発者が認証スキームを参照するための名前を入力します。

b. スキーム・タイプ: 「Oracle Application Server Single Sign-On」を選択します。

8. 該当するフィールドに入力します。

特定のフィールドの詳細は、フィールドレベル・ヘルプを参照してください。

9. 「認証スキームの作成」をクリックします。

関連項目:

「フィールドレベル・ヘルプの表示」

19.4.4 既存の認証スキームの管理

認証スキームを作成すると、使用可能な認証スキームが認証スキーム・リポジトリに表示されます。

認証スキーム・リポジトリにナビゲートするには、次のステップを実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

共有コンポーネント・ページが表示されます。

4. 「セキュリティ」で、「認証スキーム」を選択します。

5. ページ上部の検索バーを使用してページの概観をカスタマイズできます。

6. レポートとして特定の認証スキームを編集するには、認証スキーム名をクリックします。

認証スキーム・ページが表示されます。

特定のフィールドの詳細は、フィールドレベル・ヘルプを参照してください。

7. 該当する属性を編集し、「変更の適用」をクリックします。

関連項目:

- 「検索バーについて」

- 「フィールドレベル・ヘルプの表示」

19.4.5 アプリケーションに関連付けられた認証スキームの表示

アプリケーションのカレント認証スキームを表示するには、次のステップを実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「セキュリティ」で、「セキュリティ属性」をクリックします。

5. 「認証」セクションに移動します。カレント認証スキームが「認証スキーム」の横に表示されます。

6. 認証スキームを編集するには、「認証スキームの定義」。

19.4.6 アプリケーションに関連付けられた認証スキームの変更

アプリケーションの認証スキームを変更するには、次のステップを実行します。

1. 「認証スキーム」にナビゲートします。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

共有コンポーネント・ページが表示されます。

d. 「セキュリティ」で、「認証スキーム」を選択します。

2. アクティブ化する認証スキームを選択します。

作成/編集ページが表示されます。

3. 「カレント・スキームにする」をクリックします。

関連項目:

事前構成済の認証スキームの理解

19.4.7 ログイン・ページの作成

Oracle Application Expressでアプリケーションを作成すると、ログイン・ページが作成されます。ページの別名は、LOGINです。このページは、認証スキームで無効なセッション・ページとして使用できます。このページは、Oracle Application ExpressのログインAPIをコールするプロセスを使用して、資格証明の検証およびセッションの登録を実行するように構成されています。

事前に構築されたモデル・ページを使用して、すべてのユーザー・インタフェースを調整し、要件に対してロジックを加工して、独自のログイン・ページを構築することもできます。

アプリケーションのログイン・ページを作成するには、次のステップを実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「ページの作成」をクリックします。

4. 「ページの作成」で、次のステップを実行します。

a. ユーザー・インタフェース: ページのユーザー・インタフェースを選択します。

b. ページ・タイプの選択: 「ログイン・ページ」を選択します。

c. 「次へ」をクリックします。

5. 「ログイン・ページ」を選択します。

6. ログイン・ページ属性を指定して、「作成」をクリックします。

19.4.8 認証スキーム・レポートの表示

認証スキーム・レポートを表示するには、次のステップを実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

共有コンポーネント・ページが表示されます。

4. 「セキュリティ」で、「認証スキーム」を選択します。

5. ページ上部の該当するタブをクリックします。

- サブスクリプション: 「認証スキームのサブスクリプション」レポートを使用すると、アプリケーションのサブスクライブされた認証スキームを表示できます。

- 履歴: 「認証スキーム履歴」レポートを使用すると、このアプリケーションのアイテムに最近行われた変更を表示できます。

19.5 認可を介したセキュリティの提供

認可は、ユーザー権限に基づいてリソースへのアクセスを制御することを示す広義語です。条件は特定のページ・コントロールまたはページ・コンポーネントのレンダリングおよび処理を制御しますが、認可スキームは特定のコントロールまたはコンポーネントへのユーザーのアクセスを制御します。

トピック:

- 認可スキームの動作方法

- 認可スキームの作成および編集

- アプリケーション、ページまたはコンポーネントへの認可スキームの割当て

- 認可レポートの表示

19.5.1 認可スキームの動作方法

認可スキームは、アプリケーションの認証スキームのセキュリティを強化します。認可スキームは、アプリケーション全体、各ページ、またはリージョン、アイテム、ボタンなどの特定のコントロールに対して指定できます。たとえば、認可スキームを使用して、ユーザーに表示するタブ、リージョンまたはナビゲーション・バーを選択的に決定できます。

認可スキームの結果は、成功または失敗のいずれかです。認可スキームの一般的なタイプには、「EXISTS」、「NOT EXISTS SQL問合せ」および「ブールを戻すPL/SQLファンクション」が含まれます。コンポーネントまたはコントロール・レベルの認可スキームに成功すると、そのコンポーネントまたはコントロールがユーザーに表示されます。失敗すると、そのコンポーネントまたはコントロールはユーザーに表示されません。アプリケーション・レベルまたはページ・レベルの認可スキームに失敗すると、Oracle Application Expressは事前定義済のメッセージを表示します。

認可スキームを定義する場合は、一意の名前を指定します。定義した認可スキームは、アプリケーションのコンポーネントまたはコントロールに割り当てることができます。アプリケーションのコンポーネントまたはコントロールに認可スキームを割り当てるには、該当する属性ページにナビゲートして、「認可スキーム」リストから認可スキームを選択するのみです。

19.5.2 認可スキームの作成および編集

この項では、認可スキームを作成および編集する方法について説明します。認可スキームは、アプリケーションまたはアプリケーション・コンポーネントまたはコントロールに割り当てる前に作成する必要があります。

トピック:

- 認可スキーム・タイプについて

- 認可スキームの作成

- 既存の認可スキーム属性の編集

- 評価ポイント属性の変更

- 認可スキーム・ステートのリセット

19.5.2.1 認可スキーム・タイプについて

認可スキームを作成する場合、認可スキーム・タイプを選択します。認可スキーム・タイプにより、認可スキームの適用方法が決まります。開発者は、新しい認可タイプ・プラグインを作成して、このリストを拡張できます。

表19-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アカウント認証が使用される場合、このチェックにはユーザーに付与されたワークスペース・グループも含まれます。アプリケーションでデータベース認証が使用される場合、このチェックにはユーザーに付与されたデータベース・ロールも含まれます。

グループ内にない

グループ名を入力します。グループがセッションの動的グループとして有効でない場合、認可は成功します。

19.5.2.2 認可スキームの作成

認可スキームを作成するには、次のステップを実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。
共有コンポーネント・ページが表示されます。

4. 「セキュリティ」で、「認可スキーム」を選択します。

5. 「作成」をクリックします。

6. 次のいずれかの項目を選択して、認可スキームの作成方法を指定します。

- 最初から

- 既存の認可スキームのコピーとして

7. 認可スキームの作成 - 詳細で、次のステップを実行します。

a. 名前 - この認可スキームを識別する一意の名前を入力します。

b. スキーム・タイプ - この認可スキームが適用される方法を選択します。認可スキーム・タイプについてを参照してください。

c. スキームの違反時に表示されるエラー・メッセージの指定 - 認可スキームが失敗した(つまり、カレント・ユーザーがセキュリティ・チェックに失敗した)場合に表示されるエラー・テキストを入力します。

d. 認可スキームの検証 - 認可スキームはセッションの最初の使用時に評価されます。その後の使用で再評価するかどうか、およびメモリーに保存された結果をいつ取得できるかを制御するには、このオプションを使用します。

詳細は、フィールドレベル・ヘルプを参照してください。

8. 「認可スキームの作成」をクリックします。

関連項目:

- アプリケーション、ページまたはコンポーネントへの認可スキームの割当て

- 「評価ポイント属性の変更」

- 「認可スキーム・ステートのリセットについて」

19.5.2.3 既存の認可スキーム属性の編集

既存の認可スキームの属性を編集するには、次のステップを実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

共有コンポーネント・ページが表示されます。

4. 「セキュリティ」で、「認可スキーム」を選択します。

認可スキーム・ページが表示されます。デフォルトでは、各スキームがアイコンとして表示されます。ページ上部の検索バーを使用してページの概観をカスタマイズできます。詳細は、検索バーについてを参照してください。

5. 認可スキームを選択します。

6. 対象となる属性を編集します。

詳細は、フィールドレベル・ヘルプを参照してください。フィールドレベル・ヘルプの表示を参照してください。

7. 変更を保存するには、「変更の適用」をクリックします。

19.5.2.4 評価ポイント属性の変更

「評価ポイント」、「認可スキームの検証」属性を使用して、認可スキームを検証するタイミングを制御できます。

認可スキームの評価ポイントを変更するには、次のステップを実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

共有コンポーネント・ページが表示されます。

4. 「セキュリティ」で、「認可スキーム」を選択します。

認可スキーム・ページが表示されます。

デフォルトでは、各スキームがアイコンとして表示されます。ページ上部の検索バーを使用してページの概観をカスタマイズできます。

5. 認可スキームを選択します。

6. 「評価ポイント」までスクロールして、「認可スキームの検証」属性を編集します。オプションは次のとおりです。

- セッションごとに1回 - 1回のみ評価し、その後は常にメモリーに保存された結果を使用します。

- ページ・ビューごとに1回 - 処理されるリクエストごとに1回評価します。認可スキームがページ上の複数のコンポーネントで参照される場合は、メモリーに保存された結果を使用します。

- コンポーネントごとに1回 - 認可スキームを参照するコンポーネントごとに1回評価しますが、結果をセッションに保存します。スキームのレンダリングまたは処理に対する以降のリクエストでは、コンポーネントについて記憶された結果を使用します。

- 常時(キャッシュなし) - 認可スキームは常に評価されます。

詳細は、フィールドレベル・ヘルプを参照してください。

7. 変更を保存するには、「変更の適用」をクリックします。

ヒント:

デフォルト値の「セッションごとに1回」が最も効率的です。認可チェックが、セッション・ステートの変化やセッション全体で一貫しない他の要因に依存する場合は、別の値を選択する必要があります。

19.5.2.5 認可スキーム・ステートのリセットについて

認可スキームがセッションごとに1回検証される場合、Oracle Application Expressは各ユーザーのセッション・キャッシュ内に検証結果をキャッシュします。セッションの認可スキーム・ステートは、APEX_AUTHORIZATION.RESET_CACHE APIをコールしてリセットできます。

関連項目:

『Oracle Application Express APIリファレンス』のAPEX_AUTHORIZATION.RESET_CACHEプロシージャに関する説明

19.5.3 アプリケーション、ページまたはコンポーネントへの認可スキームの割当て

作成した認可スキームは、アプリケーション全体、ページ、コントロールまたはコンポーネントに割り当てることができます。

トピック:

- アプリケーションへの認可スキームの割当て

- ページへの認可スキームの割当て

- コントロールまたはコンポーネントへの認可スキームの割当て

19.5.3.1 アプリケーションへの認可スキームの割当て

認可スキームをアプリケーションに割り当てるには、次のステップを実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」アイコンをクリックします。

共有コンポーネント・ページが表示されます。

4. 「セキュリティ」で、「セキュリティ属性」をクリックします。

5. 「認可」までスクロールして、「認可スキーム」リストから認可スキームを選択します。

6. パブリック・ページで実行で、(つまり、認可を必要としないページ)で、アプリケーション・レベルの認可スキームをチェックするかどうかを指定するには、「はい」または「いいえ」を選択します。詳細は、認可を参照してください。

7. 新しい認可スキームを定義するには、「認可スキームの定義」をクリックします。

19.5.3.2 ページへの認可スキームの割当て

認可スキームをページに割り当てるには、次のステップを実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. ページを選択します。

4. 編集ページにアクセスするには、次の操作を実行します。

- ツリー・ビュー: 「ページ・レンダリング」で、ツリーの上部のページ・タイトルをダブルクリックします。

- コンポーネント・ビュー: 「ページ」で、ページ名をクリックします。

5. 「セキュリティ」までスクロールして、「認可スキーム」リストから認可スキームを選択します。

19.5.3.3 コントロールまたはコンポーネントへの認可スキームの割当て

認可スキームをページ・コンポーネントまたはコントロールに割り当てるには、次のステップを実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. ページを選択します。

4. 認可スキームを適用するコンポーネントまたはコントロールの名前をクリックします。

5. 「セキュリティ」までスクロールして、「認可スキーム」リストから認可スキームを選択します。

19.5.4 認可レポートの表示

認可スキームのサブスクリプションおよび認可スキームの使用率レポートを使用すると、アプリケーション内の認可スキームをより効率的に管理できます。

認可スキーム・レポートを表示するには、次のステップを実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

共有コンポーネント・ページが表示されます。

4. 「セキュリティ」で、「認可スキーム」を選択します。

5. ページ上部の該当するタブをクリックします。

- サブスクリプション: 認可スキームのサブスクリプション・レポートを使用して、認可スキームのサブスクリプションの詳細を表示します。

- コンポーネント別: コンポーネント別レポートを使用して、認可スキームに関連するこのアプリケーション内のすべてのコンポーネントを表示します。レンダリングするコンポーネントには、コンポーネント・レベル、ページ・レベルおよびアプリケーション・レベルにある認可スキームを渡す必要があります。

- 使用率: 認可スキームの使用率レポートを使用して、認可スキームの使用率の詳細を表示します。
ページの認可スキームの有無を示す詳細レポートを表示するには、「タスク」リストから次のいずれかを選択します。

- 認可スキームが指定されているレポート・ページ

- 認可スキームが指定されていないレポート・ページ

- 履歴: 認可スキームの履歴レポートを使用して、このアプリケーションの認可スキームに最近行われた変更を表示します。

20 アプリケーションのグローバリゼーションの管理

アプリケーション・ビルダーで構築したアプリケーションを同時に複数の言語で実行できます。この項では、アプリケーション・ビルダーで構築したアプリケーションを翻訳する方法を説明します。

トピック:

- アプリケーション翻訳およびグローバリゼーション・サポートの理解

- アプリケーションへのプライマリ言語の指定

- アイテムの書式マスクの使用

- マルチバイト言語用のアプリケーション翻訳について

- 翻訳プロセスの理解

- メッセージの翻訳

- LOVをサポートするデータの翻訳

- サポートされるグローバリゼーション・コードの理解

関連項目:

Oracle Application Express管理ガイドの「インストール済の翻訳の表示」

20.1 アプリケーション翻訳およびグローバリゼーション・サポートの理解

アプリケーション・ビルダーで、同時に異なる言語で実行可能なアプリケーションを開発できます。1つのOracle DatabaseインスタンスとOracle Application Expressで、異なる言語をサポートするようにカスタマイズされた複数のデータベース・セッションをサポートできます。

トピック:

- 翻訳プロセスについて

- 言語の指定について

- データベース・アプリケーションの翻訳ルールについて

- 翻訳済アプリケーションのレンダリング方法

- アプリケーション属性を翻訳可能に指定

20.1.1 翻訳プロセスについて

一般的に、アプリケーション・ビルダーで構築したアプリケーションの翻訳は、次のようなステップになります。

1. プライマリおよびターゲットのアプリケーションIDをマップします

2. 翻訳用のファイルにテキストをシードおよびエクスポートします

3. ファイルのテキストを翻訳します

4. 翻訳済ファイルを適用します

5. 翻訳済ファイルを公開します

関連項目:

翻訳プロセスの理解

20.1.2 言語の指定について

アプリケーションの作成後、言語プリファレンスを指定します。次に、プライマリ・アプリケーションの言語を選択し、Application Expressエンジンによるアプリケーション言語の決定方法を決定します。アプリケーションのプライマリ言語は静的にすることも、Webブラウザ言語から導出したり、ユーザー・プリファレンスやアイテムから特定することもできます。

関連項目:

アプリケーションへのプライマリ言語の指定

20.1.3 データベース・アプリケーションの翻訳ルールについて

次のルールを使用して、使用する翻訳のバージョンを決定します。

- ユーザーの言語プリファレンスに完全一致する言語コードの翻訳済アプリケーションを検索します。

- 部分一致を検索します。つまり、言語およびロケールが存在するかどうかを確認します。たとえば、ユーザーの言語プリファレンスがen-usで、en-usの翻訳済バージョンが存在しない場合は、言語コードがenの翻訳済アプリケーションを検索します。

- アプリケーションのプライマリ言語を使用します。

たとえば、プライマリ言語がドイツ語(de)のアプリケーションを作成し、言語コードがen-usの翻訳バージョンを作成すると想定します。ユーザーがブラウザ言語en-usを使用してこのアプリケーションにアクセスすると、英語(en-us)バージョンのアプリケーションが実行されます。ユーザーがブラウザ言語en-gbを使用してこのアプリケーションにアクセスすると、アプリケーションがプライマリ言語(つまりドイツ語)で表示されます。この例では、enのすべてのバリエーションに対応するために、言語コードenを使用して英語の翻訳バージョンを作成する必要があります。

20.1.4 翻訳済アプリケーションのレンダリング方法

Oracle Application Expressがアプリケーションの言語を決定した後、Application Expressエンジンは、特定のページ・リクエストに対してデータベース言語を変更します。その後、適切な言語に翻訳されたアプリケーションを検索します。Application Expressエンジンはその言語を検出すると、その定義を使用してアプリケーションをレンダリングします。それ以外の場合は、ベース(プライマリ)のアプリケーション言語でアプリケーションをレンダリングします。

アプリケーション内に表示されるテキストは、すぐには翻訳されないことに注意してください。Oracle Application Expressは、ベース言語アプリケーション定義または代替アプリケーション定義のいずれかから動的にページ属性を収集します。

関連項目:

- 「テキスト文字列の動的翻訳について」

- LOVをサポートするデータの翻訳

20.1.5 アプリケーション属性を翻訳可能に指定

アプリケーション・ビルダーでアプリケーションを作成する際、フィールド・ラベル、リージョン・ヘッダー、ページ・ヘッダー・テキストなど、多数の宣言的な属性を定義します。この項では、アプリケーション内でアプリケーション属性を翻訳可能にする方法に関するベスト・プラクティスについて説明します。

トピック:

- メッセージの言語変換をサポートするショートカットについて

- メッセージについて

- テキスト文字列の動的翻訳について

- リージョン・タイトルの翻訳について

- 翻訳テンプレートについて

20.1.5.1 メッセージの言語変換をサポートするショートカットについて

アプリケーション・ビルダーには、翻訳可能なメッセージを参照できる2つのタイプのショートカットがあります。

- メッセージ。このショートカットを使用して、実行時に変換可能なメッセージを参照します。ショートカット名は、対応するメッセージ名と一致させる必要があります。実行時、ショートカット名は、現在の言語に翻訳可能なメッセージのテキストに展開されます。

- JavaScriptにより一重引用符がエスケープされたメッセージ:このショートカットを使用し、JavaScriptリテラル文字列内部のショートカットを参照し、実行時に翻訳可能なメッセージを参照します。このショートカットは、テキスト文字列を定義します。ショートカットが参照されると、JavaScriptに必要な一重引用符がエスケープされます。

関連項目:

ショートカットの使用

20.1.5.2 メッセージについて

アプリケーションにPL/SQLリージョンまたはPL/SQLプロセスが含まれている場合には、生成されるHTMLまたはテキストを翻訳する必要があります。また、Oracle Application Expressが翻訳されている10の言語以外の言語をアプリケーションで使用する場合、レポートで使用されるメッセージの翻訳が必要な場合もあります。

関連項目:

メッセージの翻訳

20.1.5.3 テキスト文字列の動的翻訳について

動的翻訳は、実行時に翻訳する必要があるデータベース・データに使用します。たとえば、動的翻訳を使用して、データベース問合せに基づくLOVを翻訳する場合があります。動的翻訳は、翻訳元の言語文字列、言語コードおよび翻訳先の文字列で構成されています。また、APEX_LANG.LANG APIを使用して、動的翻訳をプログラム的に取得できます。

関連項目:

LOVをサポートするデータの翻訳

20.1.5.4 リージョン・タイトルの翻訳について

デフォルトでは、ページ・リージョン・タイトルは、生成された翻訳ファイルに含まれます。ただし、リージョン・タイトルは、翻訳不可と指定できます。

トピック:

- ページ・デザイナでリージョンを翻訳不可に指定

- レガシー・コンポーネント・ビューでリージョンを翻訳不可に指定

20.1.5.4.1 ページ・デザイナでリージョンを翻訳不可に指定

リージョン・タイトルを翻訳不可と指定するには、次のステップを実行します。

1. ページ・デザイナでページを表示します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. ページを選択します。

ページ・デザイナが表示されます。

2. 「レンダリング」タブで、リージョンを選択します。

プロパティ・エディタにリージョン属性が表示されます。

3. 「拡張」セクションを展開します。

4. 「タイトルを翻訳から除外」で、「はい」を選択します。

5. 「保存」をクリックします。

20.1.5.4.2 レガシー・コンポーネント・ビューでリージョンを翻訳不可に指定

リージョン・タイトルを翻訳不可と指定するには、次のステップを実行します。

1. コンポーネント・ビューでページにナビゲートします。レガシー・コンポーネント・ビューの使用を参照してください。

2. ページで、リージョン・タイトルを選択します。

リージョンの編集ページが表示されます。

3. 「指定」で、「タイトルを翻訳から除外」チェック・ボックスを選択します。

20.1.5.5 翻訳テンプレートについて

デフォルトでは、テンプレートは翻訳可能ではないため、生成された翻訳ファイルには含まれません。通常、テンプレートには翻訳可能なテキストを含めません。ただし、テンプレートを翻訳可能として指定する必要がある場合は、ページ・テンプレートの編集ページで、「翻訳可能」チェック・ボックスを選択します。

テンプレートを翻訳可能として指定するには、次のステップを実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

4. 「ユーザー・インタフェース」で、「テンプレート」を選択します。
テンプレート・ページが表示されます。

5. 編集するテンプレートを検索して、テンプレート名を選択します。

6. 「名前」の下で「翻訳可能」を選択します。

静的置換文字列を使用して翻訳可能なテキストを定義することで、翻訳可能なテキストをアプリケーション・レベルで含めることができます。アプリケーション・レベル属性は翻訳されるため、静的置換文字列として定義された任意のテキストは、生成された翻訳ファイルに含まれます。

関連項目:

- カスタム・テーマの作成

- 「"置換」

20.2 アプリケーションへのプライマリ言語の指定

グローバリゼーション属性は、Application Expressエンジンによるアプリケーションのプライマリ言語の決定方法を指定します。

グローバリゼーション属性を編集するには、次のステップを実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「グローバリゼーション」で、「グローバリゼーション属性」を選択します。

5. 「アプリケーションのプライマリ言語」で、アプリケーションが開発されている言語を選択します。

6. 「アプリケーション言語の導出元」で、Application Expressエンジンによるアプリケーション言語の決定(導出)方法を指定します。アプリケーションのプライマリ言語は静的にすることも、Webブラウザ言語から導出したり、ユーザー・プリファレンスやアイテムから特定することもできます。表20-1は、使用可能なオプションを示しています。

表 20-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. 「変更の適用」をクリックします。

関連項目:

アプリケーション属性の編集、セキュリティ属性の構成およびサポートされるグローバリゼーション・コードの理解

20.3 アイテムの書式マスクの使用

この項では、アイテムの書式マスクの使用方法について説明します。

トピック:

- アイテムへの書式マスクの適用について

- アイテム属性の編集例

20.3.1 アイテムへの書式マスクの適用について

Application Expressエンジンは、レンダリングされた各ページにグローバリゼーション設定を適用します。デフォルトの動作は、数字や日付などの特定のアイテムの表示に影響する可能性があります。

たとえば、ユーザーのブラウザの言語設定に基づいて、アプリケーション言語を決定するとします。Application Expressエンジンが、ユーザーのブラウザの言語設定をフランス語と決定した場合、日付および数字は、フランス語の標準に合わせた書式で表示されます。書式マスクを適用することによって、このデフォルトの動作をオーバーライドし、アイテムの表示方法を明示的に制御できます。「表示形式」リストから選択して、書式マスクを適用します。

- アイテム作成時。

- アイテム属性を編集してアイテムを作成した後。

20.3.2 アイテム属性の編集例

次の項では、データベース列のソース・タイプを持つアイテムのアイテム属性の編集方法について説明します。

アイテム属性を編集するには、次のステップを実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 適切なページにナビゲートします。

4. アイテムを選択します。
「ページ・アイテムの編集」ページが表示されます。

5. 「名前」の下で、「表示形式」リストから選択します。

6. 「ソース」の「書式マスク」で、書式マスクを選択するか入力します。

関連項目:

「レガシー・コンポーネント・ビューでのページの表示」

20.4 マルチバイト言語用のアプリケーション翻訳について

アプリケーションを複数の言語(中国語と日本語など)で同時に実行する必要がある場合、すべての言語をサポートするキャラクタ・セットを使用してデータベースを構成することを検討してください。UTF8およびAL32UTF8は、ほぼすべての言語をサポートするために使用できるキャラクタ・セットです。

20.5 翻訳プロセスの理解

この項では、アプリケーションの翻訳プロセスについて説明します。アプリケーション・ビルダーで開発したアプリケーションを翻訳するには、プライマリおよびターゲット言語をマップし、テキストを翻訳ファイルにシードおよびエクスポートし、テキストを翻訳し、翻訳ファイルを適用し、翻訳済アプリケーションをパブリッシュする必要があります。

トピック:

- ステップ1: ターゲット言語のマップ

- ステップ2: 翻訳ファイルへのシードおよびダウンロード

- ステップ3: XLIFFファイルの翻訳

- ステップ4: 翻訳済XLIFFドキュメントのアップロードおよび適用

- ステップ5: アプリケーションのパブリッシュ

- 翻訳の手動編集

関連項目:

- メッセージの翻訳

- LOVをサポートするデータの翻訳

20.5.1 ステップ1: ターゲット言語のマップ

アプリケーション翻訳の最初のステップは、プライマリおよびターゲットのアプリケーション言語をマップすることです。プライマリ・アプリケーションは、翻訳されるアプリケーションです。ターゲット・アプリケーションは、翻訳結果のアプリケーションです。

プライマリおよびターゲットのアプリケーション言語をマップするには、次のステップを実行します。

1. アプリケーションの翻訳ページにナビゲートします。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. 「共有コンポーネント」をクリックします。

d. 「グローバリゼーション」の下で「アプリケーションの翻訳」をクリックします。

翻訳ページが表示されます。

2. 「翻訳されたアプリケーションにプライマリ言語アプリケーションをマップ」をクリックします。

マッピング・ページが表示されます。

3. 「作成」をクリックします。

4. 翻訳アプリケーション・マッピング・ページで、次のステップを実行します。

- 翻訳アプリケーション - アプリケーションを識別する一意の整数値を入力します。アプリケーションIDは、Oracle Application Expressのインスタンスで一意である必要があります。

- 言語 - 翻訳する言語を選択します。

- イメージ・ディレクトリ - イメージが取得されるディレクトリを入力します。翻訳されるイメージ・ディレクトリからの静的ファイルを使用する場合を除き、このフィールドは空白のままにします。これはデフォルトで、最も一般的なオプションです。

5. 「作成」をクリックします。

関連項目:

ステップ2: 翻訳ファイルへのシードおよびダウンロード

20.5.2 ステップ2: 翻訳ファイルへのシードおよびダウンロード

2番目のステップでは、翻訳表をシードし、翻訳テキストを翻訳ファイルにエクスポートします。

トピック:

- 翻訳可能なテキストのシード

- XLIFFファイルのダウンロード

20.5.2.1 翻訳可能なテキストのシード

翻訳のシードにより、すべての翻訳可能なテキストが翻訳テキスト・リポジトリにコピーされます。言語を指定して翻訳テキストをシードすると、翻訳用のXLIFFファイルを生成してエクスポートできます。

シード・プロセスでは、プライマリ言語アプリケーションと翻訳テキスト・リポジトリの同期がとられます。プライマリ言語アプリケーションを変更するたびに、シード・プロセスを実行する必要があります。

翻訳可能なテキストをシードするには、次のステップを実行します。

1. アプリケーションの翻訳ページにナビゲートします。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. 「共有コンポーネント」をクリックします。

d. 「グローバリゼーション」の下で「アプリケーションの翻訳」をクリックします。

翻訳ページが表示されます。

2. 「翻訳可能なテキストのシード」をクリックします。

3. 適切なターゲット・アプリケーションを選択します。

4. 「シード」をクリックします。

完了すると、次のメッセージが表示されます。

Successfully seeded translatable text.

20.5.2.2 XLIFFファイルのダウンロード

翻訳のマッピングが確立されると、アプリケーション内の翻訳可能なテキストが翻訳リポジトリにシードされます。このリポジトリを翻訳用のXML Localization Interchange File Format (XLIFF)ファイルにエクスポートします。

トピック:

- XLIFFのエクスポート・ページについて

- アプリケーションのXLIFFファイルのダウンロード

- アプリケーション・ページのXLIFFファイルのダウンロード

- 含まれるXLIFFターゲット要素について

20.5.2.2.1 XLIFFのエクスポート・ページについて

XLIFFのエクスポート・ページは、2つのセクションに分かれています。アプリケーション全体の翻訳可能なテキスト(すべてのページ、LOV、メッセージなど)をエクスポートするには、上のセクションを使用します。特定のページの翻訳可能なテキストをエクスポートするには、下のセクションを使用します。

注意:

XLIFF(XML Localization Interchange File Format)は、ローカリゼーション・データを変換するためのXMLベースのフォーマットです。XLIFFおよびXLIFF 1.0の仕様の詳細は、次を参照してください。

https://www.oasis-open.org/committees/tc_home.php?wg_abbrev=xliff

20.5.2.2.2 アプリケーションのXLIFFファイルのダウンロード

完全なアプリケーションのXLIFFファイルをダウンロードするには、次のステップを実行します。

1. 翻訳可能なテキストをシードします。

2. アプリケーションの翻訳ページにナビゲートします。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. 「共有コンポーネント」をクリックします。

d. 「グローバリゼーション」の下で「アプリケーションの翻訳」をクリックします。

翻訳ページが表示されます。

3. 翻訳ページで、「XLIFF翻訳ファイルのダウンロード」をクリックします。

4. 「完全なアプリケーション用のXLIFFファイルのダウンロード」で、次のステップを実行します。

a. 言語 - XLIFFファイルでダウンロードする言語を選択します。

b. XLIFFターゲット要素を含める - XLIFFターゲット要素を含めるかどうかを指定します。含めるには、「XLIFFターゲット要素を含める」を選択します。

c. エクスポート - アプリケーションのすべての翻訳可能な要素をエクスポートするか、新規または更新された要素のみをエクスポートするかを選択します。

d. 「XLIFFのエクスポート」をクリックします。

5. 画面に表示されるステップに従います。

関連項目:

「翻訳可能なテキストのシード」

20.5.2.2.3 アプリケーション・ページのXLIFFファイルのダウンロード

特定ページのXLIFFファイルをダウンロードするには、次のステップを実行します。

1. 翻訳可能なテキストをシードします。

2. アプリケーションの翻訳ページにナビゲートします。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. 「共有コンポーネント」をクリックします。

d. 「グローバリゼーション」の下で「アプリケーションの翻訳」をクリックします。

翻訳ページが表示されます。

3. 翻訳ページで、「XLIFF翻訳ファイルのダウンロード」をクリックします。

4. 「アプリケーション・ページ用のXLIFFファイルのダウンロード」で、次のステップを実行します。

a. 言語 - XLIFFファイルでダウンロードする言語を選択します。

b. ページ - ページを選択します。

c. XLIFFターゲット要素を含める - XLIFFターゲット要素を含めるかどうかを指定します。含めるには、「XLIFFターゲット要素を含める」を選択します。

d. エクスポート - ページのすべての翻訳可能な要素をエクスポートするか、新規または更新された要素のみをエクスポートするかを選択します。

e. 「XLIFFのエクスポート」をクリックします。

5. 画面に表示されるステップに従います。

関連項目:

「翻訳可能なテキストのシード」

20.5.2.2.4 含まれるXLIFFターゲット要素について

Oracle Application ExpressがXLIFFドキュメントを生成すると、各ドキュメントには複数の翻訳単位が含まれます。各翻訳単位は、ソース要素とターゲット要素で構成されます。XLIFFドキュメントは、各翻訳単位ごとのソースおよびターゲットの両方の要素で生成できます。生成するファイルにソース要素のみを含めることもできます。更新された翻訳は、翻訳単位のターゲット要素から適用されます。

20.5.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 1.0の仕様の詳細は、次を参照してください。

https://www.oasis-open.org/committees/tc_home.php?wg_abbrev=xliff

20.5.4 ステップ4: 翻訳済XLIFFドキュメントのアップロードおよび適用

XLIFFドキュメントの翻訳後に、ドキュメントをアップロードして適用します。

トピック:

- 翻訳済XLIFFドキュメントのアップロード

- アップロードしたXLIFFドキュメントの適用

- アップロードしたXLIFFドキュメントの削除

20.5.4.1 翻訳済XLIFFドキュメントのアップロード

翻訳済XLIFFドキュメントをアップロードするには、次のステップを実行します。

1. アプリケーションの翻訳ページにナビゲートします。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. 「共有コンポーネント」をクリックします。

d. 「グローバリゼーション」の下で「アプリケーションの翻訳」をクリックします。

翻訳ページが表示されます。

2. 「XLIFF翻訳ファイルの適用」をクリックします。

XLIFF翻訳ファイル・ページが表示されます。

3. 「ファイルのアップロード」をクリックします。

4. XLIFFのアップロード・ページで、次のステップを実行します。

a. アップロードするファイルを探します。

b. 「アップロード」をクリックします

アップロードされたドキュメントが、XLIFF翻訳ファイル・ページに表示されます。

20.5.4.2 アップロードしたXLIFFドキュメントの適用

XLIFFドキュメントをアップロードした後、そのXLIFFドキュメントを適用して翻訳済アプリケーションを公開します。XLIFFドキュメントを適用すると、Application Expressエンジンはファイルを解析して、翻訳表を新しい翻訳可能なテキストで更新します。

アプリケーションを公開すると、ベース言語のアプリケーションのコピーが作成され、翻訳表の翻訳されたテキスト文字列が置換されます。その後、この公開されたアプリケーションを使用して、代替言語でアプリケーションをレンダリングできます。

アプリケーションを代替言語で実行するには、代替言語バージョンで表示するようにグローバリゼーション設定を行ってアプリケーションを実行する必要があります。たとえば、言語がブラウザ言語に従う場合は、ブラウザ言語を翻訳済アプリケーションと同じ言語に設定する必要があります。

翻訳済XLIFFドキュメントを適用するには、次のステップを実行します。

1. アプリケーションの翻訳ページにナビゲートします。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. 「共有コンポーネント」をクリックします。

d. 「グローバリゼーション」の下で「アプリケーションの翻訳」をクリックします。

アプリケーションの翻訳ページが表示されます。

2. 「XLIFF翻訳ファイルの適用」をクリックします。

XLIFF翻訳ファイル・ページが表示されます。

3. XLIFFドキュメントを適用するには、次のステップを実行します。

a. 適用するXLIFFファイルを選択します。

b. 「翻訳に適用」から、翻訳のマッピングを選択します。

c. 「チェックした項目の適用」をクリックします。

XLIFFファイルが解析され、コンテンツが翻訳リポジトリに適用されます。このプロセスが完了すると、各翻訳のアプリケーションをパブリッシュする必要があります。

関連項目:

- アプリケーションへのプライマリ言語の指定

- 「ステップ5: アプリケーションのパブリッシュ」

20.5.4.3 アップロードしたXLIFFドキュメントの削除

アップロードしたXLIFFドキュメントを削除するには、次のステップを実行します。

1. アプリケーションの翻訳ページにナビゲートします。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. 「共有コンポーネント」をクリックします。

d. 「グローバリゼーション」の下で「アプリケーションの翻訳」をクリックします。

翻訳ページが表示されます。

2. 「XLIFF翻訳ファイルの適用」をクリックします。

XLIFF翻訳ファイル・ページが表示されます。

3. XLIFFファイル・リポジトリで、ファイル名列の左側にあるチェック・ボックスを選択します。

4. 「チェックした項目の削除」をクリックします。

関連項目:

アプリケーションへのプライマリ言語の指定

20.5.5 ステップ5: アプリケーションのパブリッシュ

アプリケーションを公開すると、ベース言語のアプリケーションのコピーが作成され、翻訳表の翻訳されたテキスト文字列が置換されます。その後、この公開されたアプリケーションを使用して、代替言語でアプリケーションをレンダリングできます。

アプリケーションを代替言語で実行するには、代替言語バージョンで表示するようにグローバリゼーション設定を行ってアプリケーションを実行する必要があります。たとえば、言語がブラウザ言語に従う場合は、ブラウザ言語を翻訳済アプリケーションと同じ言語に設定する必要があります。

アプリケーションを公開するには、次の手順を実行します。

1. アプリケーションの翻訳ページにナビゲートします。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. 「共有コンポーネント」をクリックします。

d. 「グローバリゼーション」の下で「アプリケーションの翻訳」をクリックします。

アプリケーションの翻訳ページが表示されます。

2. 「翻訳済アプリケーションのパブリッシュ」をクリックします。

XLIFF翻訳ファイル・ページが表示されます

3. パブリッシュするアイテムを選択し、「パブリッシュ」をクリックします。

アプリケーションを公開した後、翻訳済アプリケーションの有無を確認する必要があります。翻訳済アプリケーションは、アプリケーション・ビルダーのホームページの「選択可能なアプリケーション」リストには表示されません。かわりに、そのページの左側のアプリケーション・ナビゲート・リストを使用します。

翻訳済アプリケーションをアプリケーション・ビルダーに表示するには、アプリケーションのグローバリゼーション属性を正しく設定する必要があります。

関連項目:

アプリケーションへのプライマリ言語の指定

20.5.6 翻訳の手動編集

ターゲット言語をマップし、翻訳可能なテキストをシードした後は、手動で翻訳を編集できます。

手動で翻訳を編集するには、次のステップを実行します。

1. ターゲット言語をマップします。

2. 翻訳可能なテキストをシードします。

3. 翻訳可能なテキストにナビゲートします。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. 「共有コンポーネント」をクリックします。

d. 「グローバリゼーション」の下で「アプリケーションの翻訳」をクリックします。

4. 「翻訳ユーティリティ」で、「翻訳リポジトリ」をクリックします。

翻訳可能なテキスト・ページが表示されます。

5. 言語マッピング・ページを選択し、「設定」をクリックします。

6. レポートをさらにカスタマイズするには、ページ上部にある検索バーを使用します。

7. 翻訳可能なテキストを編集するには、次のステップを実行します。

a. 「編集」アイコンをクリックします。

翻訳可能なテキスト・ページが表示されます。

b. 「翻訳先テキスト」で、適切なテキストを入力します。

c. 「変更の適用」をクリックします。

8. グリッド編集ページにアクセスするには、次のステップを実行します。

a. 「グリッド編集」をクリックします。

「翻訳可能テキスト - グリッド編集」ページが表示されます。

b. 「翻訳先」で、適切なテキストを入力します。

c. 「変更の適用」をクリックします。

関連項目:

- 「ステップ1: ターゲット言語のマップ」

- 「翻訳可能なテキストのシード」

- 「実行中のアプリケーションでの対話モード・レポートのカスタマイズ」

20.6 メッセージの翻訳

この項では、Oracle Application Expressアプリケーションでメッセージをいつどのように翻訳するかについて説明します。

トピック:

- メッセージの翻訳について

- PL/SQLプロシージャで使用されるメッセージの翻訳

- 翻訳が必要な対話グリッドのメッセージ

- Oracle Application Expressにより内部使用されるメッセージの翻訳

20.6.1 メッセージの翻訳について

アプリケーションが次に当てはまる場合、メッセージを翻訳する必要があることがあります。

- PL/SQLリージョンまたはPL/SQLプロセスが含まれる場合、あるいはPL/SQLパッケージ、プロシージャ、またはファンクションをコールする場合。この場合、生成されたHTMLを翻訳する必要があることがあります。

- Oracle Application Expressが翻訳されている10言語以外の言語を使用する場合。この場合、レポートに使用されているメッセージを翻訳する必要があることがあります。

20.6.2 PL/SQLプロシージャで使用されるメッセージの翻訳

この項では、PL/SQLプロシージャで使用されるメッセージの翻訳方法について説明します。

トピック:

- PL/SQLプロシージャで使用されるメッセージの翻訳について

- 翻訳メッセージの定義

関連項目:

『Oracle Application Express APIリファレンス』のAPEX_LANGに関する項

20.6.2.1 PL/SQLプロシージャで使用されるメッセージの翻訳について

アプリケーションにPL/SQLリージョンまたはPL/SQLプロセスが含まれる場合、あるいはアプリケーションがPL/SQLパッケージ、プロシージャ、またはファンクションをコールする場合は、生成されるHTMLを翻訳する必要がある場合があります。最初に、翻訳可能なメッセージ・ページで、各メッセージを定義します。次に、APEX_LANG.MESSAGE APIを使用して、PL/SQLストアド・プロシージャ、ファンクション、トリガーまたはパッケージ化されたプロシージャおよびファンクションのメッセージを翻訳します。

20.6.2.2 翻訳メッセージの定義

翻訳可能なメッセージ・ページで、翻訳可能なメッセージを作成します。

新しい翻訳メッセージを定義するには、次のステップを実行します。

1. アプリケーションの翻訳ページにナビゲートします。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. 「共有コンポーネント」をクリックします。

d. 「グローバリゼーション」の下で「テキスト・メッセージ」をクリックします。

2. メッセージの翻訳ページで、「テキスト・メッセージの作成」をクリックします。

3. テキスト・メッセージを指定ページで、次のステップを実行します。

a. 名前 - メッセージを識別するための名前を入力します。

b. 言語 - メッセージが使用される言語を選択します。

c. JavaScriptで使用 - メッセージがJavaScriptコードのAPEX.LANG APIコールで使用されている場合、「はい」を選択します。

d. テキスト - テキスト・メッセージがコールされたときに戻されるテキストを入力します。

たとえば、メッセージGREETING_MSGを次のように英語で定義できます。

Good morning %0

また、メッセージGREETING_MSGを次のようにドイツ語で定義できます。

Guten Tag %0

4. 「テキスト・メッセージの作成」をクリックします。

20.6.3 翻訳が必要な対話グリッドのメッセージ

「翻訳が必要な対話グリッドのメッセージ」に、翻訳が必要な対話グリッドのメッセージをリストします。

表 20-2 翻訳が必要な対話グリッドのメッセージ

メッセージ名

英語のテキスト

APEX.GV.BREAK_COLLAPSE

Collapse control break

APEX.GV.BREAK_EXPAND

Expand control break

APEX.GV.DELETED_COUNT

%0 rows deleted

APEX.GV.DUP_REC_ID

Duplicate identity

APEX.GV.FIRST_PAGE

First

APEX.GV.LAST_PAGE

Last

APEX.GV.LOAD_MORE

Load More Rows

APEX.GV.NEXT_PAGE

Next

APEX.GV.PAGE_RANGE_XY

%0 - %1

APEX.GV.PAGE_RANGE_XYZ

%0 - %1 of %2

APEX.GV.PREV_PAGE

Previous

APEX.GV.ROW_ADDED

Added

APEX.GV.ROW_CHANGED

Changed

APEX.GV.ROW_DELETED

Deleted

APEX.GV.SELECT_PAGE_N

Page %0

APEX.GV.SELECTION_COUNT

%0 rows selected

APEX.GV.SORT_ASCENDING

Sort Ascending

APEX.GV.SORT_ASCENDING_ORDER

Sort Ascending %0

APEX.GV.SORT_DESCENDING

Sort Descending

APEX.GV.SORT_DESCENDING_ORDER

Sort Descending %0

APEX.GV.SORT_OFF

Don't Sort

APEX.GV.TOTAL_PAGES

Total %0

APEX.IG.ACC_LABEL

Interactive Grid %0

APEX.IG.ACTIONS

Actions

APEX.IG.ADD

Add

APEX.IG.ADD_ROW

Add Row

APEX.IG.AGGREGATE

Aggregate

APEX.IG.AGGREGATION

Aggregation

APEX.IG.ALL

All

APEX.IG.ALL_TEXT_COLUMNS

All Text Columns

APEX.IG.ALTERNATIVE

Alternative

APEX.IG.AND

and

APEX.IG.APPROX_COUNT_DISTINCT

Approx.Count Distinct

APEX.IG.APPROX_COUNT_DISTINCT_OVERALL

Overal Approx.Count Distinct

APEX.IG.AREA

Area

APEX.IG.ASCENDING

Ascending

APEX.IG.AUTHORIZATION

認可

APEX.IG.AUTO

Auto

APEX.IG.AVG

Average

APEX.IG.AVG_OVERALL

Overall Average

APEX.IG.AXIS_LABEL_TITLE

Label Axis Title

APEX.IG.AXIS_VALUE_DECIMAL

Decimal Places

APEX.IG.AXIS_VALUE_TITLE

Value Axis Title

APEX.IG.BACKGROUND_COLOR

Background Color

APEX.IG.BAR

Bar

APEX.IG.BETWEEN

between

APEX.IG.BOTH

Both

APEX.IG.BUBBLE

Bubble

APEX.IG.CANCEL

Cancel

APEX.IG.CASE_SENSITIVE

Case Sensitive

APEX.IG.CASE_SENSITIVE_WITH_BRACKETS

(Case Sensitive)

APEX.IG.CHANGE_VIEW

Change View

APEX.IG.CHANGES_SAVED

Changes saved

APEX.IG.CHART

Chart

APEX.IG.CHART_VIEW

Chart View

APEX.IG.CLOSE_COLUMN

Close

APEX.IG.COLOR_BLUE

Blue

APEX.IG.COLOR_GREEN

Green

APEX.IG.COLOR_ORANGE

Orange

APEX.IG.COLOR_RED

Red

APEX.IG.COLOR_YELLOW

Yellow

APEX.IG.COLORS

Colors

APEX.IG.COLUMN

Column

APEX.IG.COLUMN_CONTEXT

Column %0

APEX.IG.COLUMN_TYPE

Column Purpose

APEX.IG.COLUMNS

Columns

APEX.IG.COMPLEX

Complex

APEX.IG.COMPUTE

Compute

APEX.IG.CONTAINS

contains

APEX.IG.CONTROL_BREAK

Control Break

APEX.IG.COUNT

Count

APEX.IG.COUNT_DISTINCT

Count Distinct

APEX.IG.COUNT_DISTINCT_OVERALL

Overall Count Distinct

APEX.IG.COUNT_OVERALL

Overall Count

APEX.IG.CREATE_X

Create %0

APEX.IG.DATA

Data

APEX.IG.DATA_TYPE

Data Type

APEX.IG.DATE

Date

APEX.IG.DAYS

days

APEX.IG.DEFAULT_SETTINGS

Default Settings

APEX.IG.DEFAULT_TYPE

Default Type

APEX.IG.DELETE

Delete

APEX.IG.DELETE_REPORT_CONFIRM

Are you sure you would like to delete this report?

APEX.IG.DELETE_ROW

Delete Row

APEX.IG.DELETE_ROWS

Delete Rows

APEX.IG.DESCENDING

Descending

APEX.IG.DETAIL

Detail

APEX.IG.DETAIL_VIEW

Detail View

APEX.IG.DIRECTION

Direction

APEX.IG.DISABLED

Disabled

APEX.IG.DOES_NOT_CONTAIN

does not contain

APEX.IG.DOES_NOT_START_WITH

does not start with

APEX.IG.DONUT

Donut

APEX.IG.DOWNLOAD

Download

APEX.IG.DOWNLOAD_FORMAT

Choose Format

APEX.IG.DUPLICATE_AGGREGATION

Duplicate Aggregation

APEX.IG.DUPLICATE_CONTROLBREAK

Duplicate Control Break

APEX.IG.DUPLICATE_ROW

Duplicate Row

APEX.IG.DUPLICATE_ROWS

Duplicate Rows

APEX.IG.EDIT

Edit

APEX.IG.EDIT_CHART

Edit Chart

APEX.IG.EDIT_GROUP_BY

Edit Group By

APEX.IG.EMAIL_BCC

Blind Copy (bcc)

APEX.IG.EMAIL_BODY

Message

APEX.IG.EMAIL_CC

Copy (cc)

APEX.IG.EMAIL_SENT

Email sent.

APEX.IG.EMAIL_SUBJECT

Subject

APEX.IG.EMAIL_TO

Recipient (to)

APEX.IG.ENABLED

Enabled

APEX.IG.EQUALS

equals

APEX.IG.EXAMPLE

Example

APEX.IG.EXPRESSION

Expression

APEX.IG.FD_TYPE

データ型

APEX.IG.FILTER

Filter

APEX.IG.FILTER_WITH_DOTS

Filter...

APEX.IG.FILTERS

Filters

APEX.IG.FIRST

First

APEX.IG.FLASHBACK

Flashback

APEX.IG.FORMAT

Format

APEX.IG.FORMAT_CSV

CSV

APEX.IG.FORMAT_HTML

HTML

APEX.IG.FORMATMASK

Format Mask

APEX.IG.FREEZE

Freeze

APEX.IG.FUNCTIONS_AND_OPERATORS

Functions and Operators

APEX.IG.FUNNEL

Funnel

APEX.IG.GO

Go

APEX.IG.GREATER_THAN

greater than

APEX.IG.GREATER_THAN_OR_EQUALS

次以上

APEX.IG.GRID

Grid

APEX.IG.GRID_VIEW

Grid View

APEX.IG.GROUP

Group

APEX.IG.GROUP_BY

Group By

APEX.IG.GROUP_BY_VIEW

Group By View

APEX.IG.HD_TYPE

Condition Type

APEX.IG.HEADING

Heading

APEX.IG.HEADING_ALIGN

Heading Alignment

APEX.IG.HELP

Help

APEX.IG.HELP.ACTIONS.EDITING

<p>You can insert, update, and delete data directly within this interactive grid.</p>

<p>Insert a new row by clicking the Add Row button.</p>

<p>Edit existing data by double-clicking a specific cell.For larger editing work, click Edit to enter editing mode.In editing mode, you can single-click or use the keyboard to edit specific cells.</p>

<p>Use the Change menu to duplicate and delete rows.To enable the Change menu, use the check boxes to select one or more rows.</p>

<p>Duplicate a selected row by clicking the Change menu and selecting Duplicate Rows.Delete a selected row by clicking the Change menu and selecting Delete Row.</p>

APEX.IG.HELP.ACTIONS.EDITING_HEADING

Editing Capabilities

APEX.IG.HELP.ACTIONS.INTRO

<p>An interactive grid presents a set of data in a searchable, customizable report.You can perform numerous operations to limit the records returned, and change the way the data is displayed.</p>

<p>Use the Search field to filter the records returned.Click Actions to access numerous options for modifying the report layout, or use the Column Heading menus on displayed columns.</p>

<p>Use Report Settings to save your customizations to a report.You can also download the data from the report to an external file or email the data to yourself or others.</p>

<p>To learn more, see Using Interactive Grids" in <em>Oracle Application Express End User's Guide</em></p>

APEX.IG.HELP.ACTIONS.INTRO_HEADING

Overview

APEX.IG.HELP.ACTIONS.REPORTING

<p>You can customize the interactive grid to display data in various different ways using the built-in capabilities.</p>

<p>Use the Column Heading menus or the Actions menu to determine which columns to display, in what sequence, and freeze columns.You can also define various data filters and sort the data returned.</p>

<p>Use the View button (adjacent to the Search field) to access other data views that may have been defined by the application developer.You can also create a chart or view an existing chart.</p>

<p><em>Note: Click <strong>Help</strong> in the interactive grid dialogs to obtain more detailed information on the selected function.</em></p>

APEX.IG.HELP.ACTIONS.REPORTING_HEADING

Reporting Capabilities

APEX.IG.HELP.ACTIONS_TITLE

Interactive Grid Help

APEX.IG.HELP.AGGREGATE

<p>Use this dialog to aggregate columns.Aggregated values display at the bottom of the data, or if Control Breaks are defined, at the bottom of each break.</p>

<p><strong>Aggregation List</strong><br>

The Aggregation list displays defined aggregations.Disable an existing aggregation by deselecting it.<br>

Click Add (&plus;) to create a new aggregation, or Delete (&minus;) to remove an existing aggregation.</p>

<p><strong>Aggregation Settings</strong><br>

Use the form on the right to define the aggregation.<br>

Select the Column name and Aggregation type.<br>

Optionally, enter a tooltip for the aggregation.<br>

If you have defined a Control Break, selecting <strong>Show Overall Value</strong> displays the overall average, total, or similar value at the bottom of the data.</p>

<p><em>Note: Access the Aggregation dialog in the Actions menu or by clicking the column heading and sum(&sum; ).</em></p>

APEX.IG.HELP.AGGREGATE_TITLE

Aggregation Help

APEX.IG.HELP.CHART

<p>Use this dialog to define a chart which displays as a separate data view.<br>

Select a chart Type, configure the chart settings, and click <strong>Save.</strong></p>

<p><strong>Chart Settings</strong></br>

The chart attributes that display vary depending on the chart type.A number of attributes can be entered to define the chart.Attributes marked with a red asterisk are mandatory.</p>

<p>Below are all available attributes across the different chart types (in alphabetical order):

<ul>

<li>Aggregation - Select how to aggregate the associated chart values.</li>

<li>Close - Select the column that contains the daily stock close price (Stock chart only).</li>

<li>Decimal Places - Enter the number of decimal places to which the values are rounded.</li>

<li>Direction - In relation to the Sort By attribute, specify whether the data is sorted in ascending or descending values.</li>

<li>High - Select the column that contains the high value (Range and Stock charts only).</li>

<li>Label - Select the column that contains the text for each data point.</li>

<li>Label Axis Title - Enter the title that displays on the label axis.</li>

<li>Low - Select the column that contains the low value (Range and Stock charts only).</li>

<li>Nulls - In relation to the Sort By attribute, specify how you want records with null values to be sorted in relation to records with non null values.</li>

<li>Open - Select the column that contains the daily stock opening price (Stock chart only).</li>

<li>Orientation - Select whether the chart elements, such as bars, display vertically or horizontally.</li>

<li>Series - Select the column used for defining your multi-series dynamic query.</li>

<li>Stack - Specify whether the data items are stacked.</li>

<li>Sort By - Select whether the chart is sorted by the label or the value(s).</li>

<li>Target - Select the column to be used for defining the target value on this chart.When set, the Value attribute defines the filled area within the slice and the Target represents the value of the whole slice (Funnel chart only).</li>

<li>Value - Select the column that contains the data to be plotted.</li>

<li>Value Axis Title - Enter the title that displays on the value axis.</li>

<li>Volume - Select the column that contains the daily stock volume (Stock chart only).</li>

<li>X - Select the column that contains the x-axis value for this chart (Bubble and Scatter charts only).</li>

<li>Y - Select the column that contains the y-axis value for this chart (Bubble and Scatter charts only).</li>

<li>Z - Select the column that contains the bar width or bubble radius (Bar, Bubble, and Range charts only)</li>

</p>

APEX.IG.HELP.CHART_TITLE

Chart Help

APEX.IG.HELP.COLUMNS

<p> Use this dialog to choose which columns display and in what order.</p>

<p>Hide a column by deselecting it.<br>

Reorder columns by clicking Move Up ( &uarr; ) or Move Down (&darr; ).<br>

Use the drop down selector to list All columns, Displayed columns, or Not Displayed columns.</p>

<p>Optionally, use the form to specify the minimum width of a column in pixels.</p>

<p><em> Note: You can also reorder displayed columns by clicking the drag handle (at the start of the column heading) and dragging the column left or right.You can also change the column width of displayed columns by selecting the column separator, between headings, and moving it left or right.</em></p>

APEX.IG.HELP.COLUMNS_TITLE

Columns Help

APEX.IG.HELP.COMPUTE

<p> Use this dialog to define additional columns based on mathematical and functional computations performed against existing columns.</p>

<p><strong>Computation List</strong><br>

The Computation list displays defined computations.Disable an existing computation by deselecting it.<br>

Click Add (&plus) to add a new computation, or Delete (&minus; ) to remove an existing computation.</p>

<p><strong>Computation Settings</strong><br>

Use the form to define the computation.<br>

Enter the column details such as heading, label, and select alignment settings.<br>

Use the Expression textarea to enter the column(s) and associated functions for the computation.<br>

Select the appropriate data type, and optionally a format mask, for the new column.</p>

APEX.IG.HELP.COMPUTE_TITLE

Compute Help

APEX.IG.HELP.CONTROL_BREAK

<p>Use this dialog to define a control break on one or more columns.</p>

<p><strong>Control Break List</strong><br>

The Control Break list displays defined control breaks.Disable an existing control break column by deselecting it.<br>

Click Add (&plus) to include a new column in the control break, or Delete (&minus; ) to remove an existing column from the control break.<br>

To reorder columns, click Move Up (&uarr; ) or Move Down (&darr; ) to move the selected column up and down relative to other columns. </p>

<p><strong>Control Break Settings</strong><br>

Use the form to define the control break column.<br>

Selected a control break column, the sort direction, and how to order null columns (columns with no value).</p>

<p><em> Note: When viewing the interactive grid, you can define a control break by clicking a Column Heading and selecting the control break icon.</em></p>

APEX.IG.HELP.CONTROL_BREAK_TITLE

Control Break Help

APEX.IG.HELP.DOWNLOAD

<p>Use this dialog to download all the current rows to an external file.The file will contain only the currently displayed columns, using any filters and sorts applied to the data.</p>

<p>Select the file format and click Download.<br>

Note: CSV will not include text formatting such as aggregates and control breaks.</p>

<p>To email the file, select Send as Email and enter the email details (Recipient, Subject and Message).</p>

APEX.IG.HELP.DOWNLOAD_TITLE

Download Help

APEX.IG.HELP.FILTER

<p>Use this dialog to configure data filters which limit the rows returned.</p>

<p><strong>Filter List</strong><br>

The Filter list displays defined filters.Disable an existing filter by deselecting it.<br>

Click Add (&plus) to create a new filter, or Delete (&minus; ) to remove an existing filter.</p>

<p><strong>Filter Settings</strong><br>

Use the form to define the filter properties. <br>

Select the appropriate filter type:<br>

&nbsp ; &nbsp; &nbsp; Row - filter for a term in any filterable column.<br>

&nbsp ; &nbsp; &nbsp; Column - filter a specific column with a specified operator and value.</p>

<p><em> Note: When viewing the interactive grid, you can define row filters by typing directly into the Search field.Click Select Columns to Search to limit the search to a specific column.Alternately, open a Column Heading menu and select a value to create a column filter.</em></p>

APEX.IG.HELP.FILTER_TITLE

Filter Help

APEX.IG.HELP.FLASHBACK

<p>Use this dialog to view the data as it existed at a previous point in time. </p>

<p>Enter the number of minutes in the past to execute the flashback query.</p>

APEX.IG.HELP.FLASHBACK_TITLE

Flashback Help

APEX.IG.HELP.GROUP_BY_TITLE

Group By Help

APEX.IG.HELP.HIGHLIGHT

<p>Use this dialog to highlight rows or columns of data based on the condition entered.</p>

<p><strong>Highlight List</strong><br>

The Highlight list displays defined highlights.Disable an existing highlight by deselecting it.<br>

Click Add (&plus) to create a new highlight, or Delete (&minus; ) to remove an existing highlight.<br>

<p><strong>Highlight Settings</strong><br>

Use the form to define the highlight properties.<br>

Enter the name, select Row or Column, and select the HTML color codes for the background and text.<br>

Select the appropriate <strong>Condition Type </strong> to highlight specific data: <br>

&nbsp ; &nbsp; &nbsp; Row - highlight the term in any column. <br>

&nbsp ; &nbsp; &nbsp; Column - highlight within a specific column based on the specified operator and value.</p>

APEX.IG.HELP.HIGHLIGHT_TITLE

Highlight Help

APEX.IG.HELP.REPORT

<p>Use this dialog to save changes you have made to the current grid layout and configuration.<br>

Application developers can define multiple alternate report layouts.Where permissible, you and other end users can save a report as Public, which makes the report available to all other users of the grid.You can also save a report as a Private report that only you can view.</p>

<p>Select from the available types and enter a name for the saved report.</p>

APEX.IG.HELP.REPORT_TITLE

Report Help

APEX.IG.HELP.SORT

<p>Use this dialog to set the display order.<p>

<p><strong>Sort List</strong><br>

The Sort dialog displays a list of configured sorting rules.<br>

Click Add (&plus) to create a sort column, or Delete (&minus; ) to remove a sort column.<br>

Click Move Up (&uarr; ) and Move Down (&darr; ) to move the selected sort column up and down relative to the other sort columns. </p>

<p><strong>Sort Settings</strong><br>

Select a sort column, the sort direction, and how to order null columns (columns with no value).</p>

<p><em> Note: Data can be sorted by columns which are not displayed; however, not all columns may be sortable.</em><br>

<em> Displayed columns can be sorted by pressing the up (ascending) or down (descending) arrows at the end of the column headings.To add a subsequent column to an existing sort, hold the Shift key and click the up or down arrow.</em></p>

APEX.IG.HELP.SORT_TITLE

Sort Help

APEX.IG.HELP.SUBSCRIPTION_TITLE

Subscription Help

APEX.IG.HIDE

Hide

APEX.IG.HIGH_COLUMN

High

APEX.IG.HIGHLIGHT

Highlight

APEX.IG.HORIZONTAL

Horizontal

APEX.IG.HOURS

hours

APEX.IG.ICON

Icon

APEX.IG.ICON_VIEW

Icon View

APEX.IG.IN

in

APEX.IG.IN_THE_LAST

in the last

APEX.IG.IN_THE_NEXT

in the next

APEX.IG.INACTIVE_SETTING

Inactive Setting

APEX.IG.INACTIVE_SETTINGS

Inactive Settings

APEX.IG.INTERNAL_ERROR

An internal error has occurred while processing the Interactive Grid request.

APEX.IG.INVALID_DATE_FORMAT

Invalid Date Format

APEX.IG.INVALID_SETTING

Invalid Setting

APEX.IG.INVALID_SETTINGS

Invalid Settings

APEX.IG.INVALID_SORT_BY

Sort By has been set to %0, but no column as been selected for %0.

APEX.IG.INVALID_VALUE

Invalid Value

APEX.IG.INVISIBLE

Not Displayed

APEX.IG.IS_NOT_NULL

is not empty

APEX.IG.IS_NULL

is empty

APEX.IG.LABEL

Label

APEX.IG.LABEL_COLUMN

Label

APEX.IG.LAST

Last

APEX.IG.LAST.DAY

Last Day

APEX.IG.LAST.HOUR

Last Hour

APEX.IG.LAST.MINUTE

Last Minute

APEX.IG.LAST.MONTH

Last Month

APEX.IG.LAST.WEEK

Last Week

APEX.IG.LAST.X_DAYS

Last %0 Days

APEX.IG.LAST.X_HOURS

Last %0 Hours

APEX.IG.LAST.X_MINUTES

Last %0 Minutes

APEX.IG.LAST.X_MONTHS

Last %0 Months

APEX.IG.LAST.X_WEEKS

Last %0 Weeks

APEX.IG.LAST.X_YEARS

Last %0 Years

APEX.IG.LAST.YEAR

Last Year

APEX.IG.LAYOUT_ALIGN

Cell Alignment

APEX.IG.LAYOUT_USEGROUPFOR

Use Group For

APEX.IG.LESS_THAN

less than

APEX.IG.LESS_THAN_OR_EQUALS

次以下

APEX.IG.LINE

Line

APEX.IG.LINE_WITH_AREA

Line with Area

APEX.IG.LISTAGG

Listagg

APEX.IG.LOW_COLUMN

Low

APEX.IG.MAILADRESSES_COMMASEP

Separate multiple Addresses with commas

APEX.IG.MATCHES_REGULAR_EXPRESSION

matches regular expression

APEX.IG.MAX

Maximum

APEX.IG.MAX_OVERALL

Overall Maximum

APEX.IG.MEDIAN

Median

APEX.IG.MEDIAN_OVERALL

Overall Median

APEX.IG.MIN

Minimum

APEX.IG.MIN_OVERALL

Overall Minimum

APEX.IG.MINUTES

minutes

APEX.IG.MINUTES_AGO

Minutes ago

APEX.IG.MONTHS

months

APEX.IG.MORE_DATA_FOUND

The data contains more than %0 rows which exceeds the maximum allowed.Please apply additional filters in order to view the results.

APEX.IG.NAME

Name

APEX.IG.NAMED_REPORT

Named Report

APEX.IG.NEXT.DAY

Next Day

APEX.IG.NEXT.HOUR

Next Hour

APEX.IG.NEXT.MINUTE

Next Minute

APEX.IG.NEXT.MONTH

Next Month

APEX.IG.NEXT.WEEK

Next Week

APEX.IG.NEXT.X_DAYS

Next %0 Days

APEX.IG.NEXT.X_HOURS

Next %0 Hours

APEX.IG.NEXT.X_MINUTES

Next %0 Minutes

APEX.IG.NEXT.X_MONTHS

Next %0 Months

APEX.IG.NEXT.X_WEEKS

Next %0 Weeks

APEX.IG.NEXT.X_YEARS

Next %0 Years

APEX.IG.NEXT.YEAR

Next Year

APEX.IG.NO_DATA_FOUND

No data found

APEX.IG.NOT_BETWEEN

not between

APEX.IG.NOT_EQUALS

not equals

APEX.IG.NOT_EXIST

Region with ID %0 is not an Interactive Grid region or does not exist in application %1.

APEX.IG.NOT_IN

not in

APEX.IG.NOT_IN_THE_LAST

not in the last

APEX.IG.NOT_IN_THE_NEXT

not in the next

APEX.IG.NULLS

Nulls

APEX.IG.NUMBER

Numeric

APEX.IG.OFF

Off

APEX.IG.ON

On

APEX.IG.ONE_MINUTE_AGO

1 minute ago

APEX.IG.OPEN_COLORPICKER

Open Color Picker: %0

APEX.IG.OPEN_COLUMN

Open

APEX.IG.OPERATOR

Operator

APEX.IG.ORIENTATION

Orientation

APEX.IG.PIE

Pie

APEX.IG.PIVOT

Pivot

APEX.IG.PIVOT_VIEW

Pivot View

APEX.IG.PLACEHOLDER_INVALUES

Separate values with "%0"

APEX.IG.POLAR

Polar

APEX.IG.POSITION_CENTER

Center

APEX.IG.POSITION_END

End

APEX.IG.POSITION_START

Start

APEX.IG.PRIMARY

Primary

APEX.IG.PRIMARY_DEFAULT

Primary Default

APEX.IG.PRIMARY_REPORT

Primary Report

APEX.IG.RADAR

Radar

APEX.IG.RANGE

Range

APEX.IG.REFRESH

Refresh

APEX.IG.REFRESH_ROW

Refresh Row

APEX.IG.REFRESH_ROWS

Refresh Rows

APEX.IG.REMOVE_CONTROL

Remove %0

APEX.IG.REPORT

Report

APEX.IG.REPORT.DELETED

Report deleted

APEX.IG.REPORT.SAVED.ALTERNATIVE

Alternative report saved for all users

APEX.IG.REPORT.SAVED.DEFAULT

Default report saved for all users

APEX.IG.REPORT.SAVED.PRIVATE

Private report saved

APEX.IG.REPORT.SAVED.PUBLIC

Public report saved for all users

APEX.IG.REPORT_DATA_AS_OF.X.MINUTES_AGO

Report data as of %0 minutes ago

APEX.IG.REPORT_DATA_AS_OF_ONE_MINUTE_AGO

Report data as of 1 minute ago

APEX.IG.REPORT_EDIT

Report - Edit

APEX.IG.REPORT_SAVE_AS

Report - Save As

APEX.IG.REPORT_SETTINGS

Report Settings

APEX.IG.REPORT_STATIC_ID_DOES_NOT_EXIST

Saved Interactive Grid with static ID %0 does not exist.

APEX.IG.REPORT_VIEW

Report View

APEX.IG.RESET

Reset

APEX.IG.REVERT_CHANGES

Revert Changes

APEX.IG.REVERT_ROWS

Revert Rows

APEX.IG.ROW

Row

APEX.IG.ROW_ACTIONS

Row Actions

APEX.IG.ROW_ACTIONS_FOR

Actions for row %0

APEX.IG.ROW_COLUMN_CONTEXT

Row %0 Column %1

APEX.IG.ROW_CONTEXT

Row %0

APEX.IG.ROWS_PER_PAGE

Rows Per Page

APEX.IG.SAVE

Save

APEX.IG.SAVE_AS

Save As

APEX.IG.SAVE_REPORT_SETTINGS

Save Report Settings

APEX.IG.SAVED_REPORT_DEFAULT

Default

APEX.IG.SAVED_REPORT_PRIVATE

Private

APEX.IG.SAVED_REPORT_PUBLIC

Public

APEX.IG.SAVED_REPORTS

Saved Reports

APEX.IG.SCATTER

Scatter

APEX.IG.SEARCH

Search

APEX.IG.SEARCH.ALL_COLUMNS

Search: All Text Columns

APEX.IG.SEARCH.COLUMN

Search: %0

APEX.IG.SEARCH.ORACLE_TEXT

Search: Full Text

APEX.IG.SEARCH_FOR.X

Search for '%0'

APEX.IG.SEL_ACTIONS

Selection Actions

APEX.IG.SELECT

- Select -

APEX.IG.SELECT_1_ROW_IN_MASTER

Select 1 row in the master region

APEX.IG.SELECT_COLUMNS_TO_SEARCH

Select columns to search

APEX.IG.SEND_AS_EMAIL

Send as Email

APEX.IG.SERIES_COLUMN

Series

APEX.IG.SHOW_OVERALL_VALUE

Show Overall Value

APEX.IG.SINGLE_ROW_VIEW

Single Row View

APEX.IG.SORT

Sort

APEX.IG.SORT_BY

Sort By

APEX.IG.SORT_ONLY_ONE_PER_COLUMN

You can define only one sort per column.

APEX.IG.SRV_CHANGE_MENU

Change Menu

APEX.IG.STACK

Stack

APEX.IG.STARTS_WITH

starts with

APEX.IG.STOCK

Stock

APEX.IG.SUBSCRIPTION

Subscription

APEX.IG.SUM

Sum

APEX.IG.SUM_OVERALL

Overall Sum

APEX.IG.SUMMARY

Interactive Grid with %0 rows and %1 columns.Report: %2, View: %3, Displayed Rows Start: %4, Displayed Rows End: %5

APEX.IG.TARGET_COLUMN

Target

APEX.IG.TEXT_COLOR

Text Color

APEX.IG.TOGGLE

Toggle

APEX.IG.TOOLTIP

Tooltip

APEX.IG.TYPE

データ型

APEX.IG.UNFREEZE

Unfreeze

APEX.IG.UNIT

Unit

APEX.IG.UNSAVED_CHANGES_CONTINUE_CONFIRM

There are unsaved changes.続行しますか。

APEX.IG.VALUE

Value

APEX.IG.VALUE_COLUMN

Value

APEX.IG.VALUE_REQUIRED

特定の値が必要です。

APEX.IG.VARCHAR2

Text

APEX.IG.VERTICAL

Vertical

APEX.IG.VIEW

View

APEX.IG.VISIBLE

Displayed

APEX.IG.VOLUME_COLUMN

Volume

APEX.IG.WEEKS

weeks

APEX.IG.WIDTH

Minimum Column Width (Pixel)

APEX.IG.X.BETWEEN.Y.AND.Z

%0 between %1 and %2

APEX.IG.X.CONTAINS.Y

%0 contains %1

APEX.IG.X.DOES_NOT_CONTAIN.Y

%0 does not contain %1

APEX.IG.X.EQUALS.Y

%0 equals %1

APEX.IG.X.GREATER_THAN.Y

%0 greater than %1

APEX.IG.X.GREATER_THAN_OR_EQUALS.Y

%0 greater than or equal to %1

APEX.IG.X.IN.Y

%0 in %1

APEX.IG.X.IN_THE_LAST.Y.DAYS

%0 in the last %1 days

APEX.IG.X.IN_THE_LAST.Y.HOURS

%0 in the last %1 hours

APEX.IG.X.IN_THE_LAST.Y.MINUTES

%0 in the last %1 minutes

APEX.IG.X.IN_THE_LAST.Y.MONTHS

%0 in the last %1 months

APEX.IG.X.IN_THE_LAST.Y.WEEKS

%0 in the last %1 weeks

APEX.IG.X.IN_THE_LAST.Y.YEARS

%0 in the last %1 years

APEX.IG.X.IN_THE_LAST_DAY

%0 in the last day

APEX.IG.X.IN_THE_LAST_HOUR

%0 in the last hour

APEX.IG.X.IN_THE_LAST_MINUTE

%0 in the last minute

APEX.IG.X.IN_THE_LAST_MONTH

%0 in the last month

APEX.IG.X.IN_THE_LAST_WEEK

%0 in the last week

APEX.IG.X.IN_THE_LAST_YEAR

%0 in the last year

APEX.IG.X.IN_THE_NEXT.Y.DAYS

%0 in the next %1 days

APEX.IG.X.IN_THE_NEXT.Y.HOURS

%0 in the next %1 hours

APEX.IG.X.IN_THE_NEXT.Y.MINUTES

%0 in the next %1 minutes

APEX.IG.X.IN_THE_NEXT.Y.MONTHS

%0 in the next %1 months

APEX.IG.X.IN_THE_NEXT.Y.WEEKS

%0 in the next %1 weeks

APEX.IG.X.IN_THE_NEXT.Y.YEARS

%0 in the next %1 years

APEX.IG.X.IN_THE_NEXT_DAY

%0 in the next day

APEX.IG.X.IN_THE_NEXT_HOUR

%0 in the next hour

APEX.IG.X.IN_THE_NEXT_MINUTE

%0 in the next minute

APEX.IG.X.IN_THE_NEXT_MONTH

%0 in the next month

APEX.IG.X.IN_THE_NEXT_WEEK

%0 in the next week

APEX.IG.X.IN_THE_NEXT_YEAR

%0 in the next year

APEX.IG.X.IS_NOT_NULL

%0 is not empty

APEX.IG.X.IS_NULL

%0 is empty

APEX.IG.X.LESS_THAN.Y

%0 less than %1

APEX.IG.X.LESS_THAN_OR_EQUALS.Y

%0 less than or equal to %1

APEX.IG.X.LIKE.Y

%0 like %1

APEX.IG.X.MATCHES_REGULAR_EXPRESSION.Y

%0 matches regular expression %1

APEX.IG.X.MINUTES_AGO

%0 minutes ago

APEX.IG.X.NOT_BETWEEN.Y.AND.Z

%0 not between %1 and %2

APEX.IG.X.NOT_EQUALS.Y

%0 not equals %1

APEX.IG.X.NOT_IN.Y

%0 not in %1

APEX.IG.X.NOT_IN_THE_LAST.Y.DAYS

%0 not in the last %1 days

APEX.IG.X.NOT_IN_THE_LAST.Y.HOURS

%0 not in the last %1 hours

APEX.IG.X.NOT_IN_THE_LAST.Y.MINUTES

%0 not in the last %1 minutes

APEX.IG.X.NOT_IN_THE_LAST.Y.MONTHS

%0 not in the last %1 months

APEX.IG.X.NOT_IN_THE_LAST.Y.WEEKS

%0 not in the last %1 weeks

APEX.IG.X.NOT_IN_THE_LAST.Y.YEARS

%0 not in the last %1 years

APEX.IG.X.NOT_IN_THE_LAST_DAY

%0 not in the last day

APEX.IG.X.NOT_IN_THE_LAST_HOUR

%0 not in the last hour

APEX.IG.X.NOT_IN_THE_LAST_MINUTE

%0 not in the last minute

APEX.IG.X.NOT_IN_THE_LAST_MONTH

%0 not in the last month

APEX.IG.X.NOT_IN_THE_LAST_WEEK

%0 not in the last week

APEX.IG.X.NOT_IN_THE_LAST_YEAR

%0 not in the last year

APEX.IG.X.NOT_IN_THE_NEXT.Y.DAYS

%0 not in the next %1 days

APEX.IG.X.NOT_IN_THE_NEXT.Y.HOURS

%0 not in the next %1 hours

APEX.IG.X.NOT_IN_THE_NEXT.Y.MINUTES

%0 not in the next %1 minutes

APEX.IG.X.NOT_IN_THE_NEXT.Y.MONTHS

%0 not in the next %1 months

APEX.IG.X.NOT_IN_THE_NEXT.Y.WEEKS

%0 not in the next %1 weeks

APEX.IG.X.NOT_IN_THE_NEXT.Y.YEARS

%0 not in the next %1 years

APEX.IG.X.NOT_IN_THE_NEXT_DAY

%0 not in the next day

APEX.IG.X.NOT_IN_THE_NEXT_HOUR

%0 not in the next hour

APEX.IG.X.NOT_IN_THE_NEXT_MINUTE

%0 not in the next minute

APEX.IG.X.NOT_IN_THE_NEXT_MONTH

%0 not in the next month

APEX.IG.X.NOT_IN_THE_NEXT_WEEK

%0 not in the next week

APEX.IG.X.NOT_IN_THE_NEXT_YEAR

%0 not in the next year

APEX.IG.X.NOT_LIKE.Y

%0 not like %1

APEX.IG.X.STARTS_WITH.Y

%0 starts with %1

APEX.IG.X_COLUMN

X

APEX.IG.Y_COLUMN

Y

APEX.IG.YEARS

years

APEX.IG.Z_COLUMN

Z

APEX.IG_FORMAT_SAMPLE_1

Monday, 12 January, 2016

APEX.IG_FORMAT_SAMPLE_2

January

APEX.IG_FORMAT_SAMPLE_3

16 hours ago

APEX.IG_FORMAT_SAMPLE_4

in 16h

APEX.RV.NOT_GROUPED_LABEL

Other Columns

APEX.RV.REC_XY

Row %0 of %1

APEX.RV.REC_X

Row %0

APEX.RV.EXCLUDE_HIDDEN

Displayed Columns

APEX.RV.EXCLUDE_NULL

Exclude Null Values

APEX.RV.PREV_RECORD

Previous

APEX.RV.NEXT_RECORD

Next

APEX.RV.SETTINGS_MENU

Settings Menu

APEX.RV.INSERT

Add

APEX.RV.DELETE

Delete

20.6.4 Oracle Application Expressにより内部使用されるメッセージの翻訳

Oracle Application Expressはドイツ語、スペイン語、フランス語、イタリア語、日本語、韓国語、ポルトガル語(ブラジル)、簡体字中国語、および繁体字中国語に翻訳されています。これらの翻訳された10言語以外の言語をアプリケーションで使用する場合は、Application Expressレポート・エンジンによって表示されるメッセージを翻訳する必要があります。

たとえば、ロシア語のアプリケーションを開発してロシア語のレポート・メッセージ(ページ区切りなど)を使用する場合は、レポートに表示されるメッセージで使用される文字列を翻訳する必要があります。

トピック:

- テキスト・メッセージの作成

- テキスト・メッセージの編集

- 翻訳が必要な内部メッセージ

- 翻訳が必要な対話モード・レポートのメッセージ

20.6.4.1 テキスト・メッセージの作成

翻訳メッセージを作成するには、次のステップを実行します。

1. アプリケーションの翻訳ページにナビゲートします。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. 「共有コンポーネント」をクリックします。

d. 「グローバリゼーション」の下で「テキスト・メッセージ」をクリックします。

2. メッセージの翻訳ページで、「テキスト・メッセージの作成」をクリックします。

3. 「テキスト・メッセージを指定」で、次のように指定します。

a. 名前 - 翻訳する必要のある各メッセージの名前を入力します。

b. 言語 - メッセージが使用される言語を選択します。

c. テキスト - テキスト・メッセージがコールされたときに戻されるテキストを入力します。英語のテキスト・メッセージに定位置の置換値(%0、%1など)が含まれている場合、ユーザー定義のメッセージにも同じ名前と数字の定位置の置換値を含めてください。

4. 「テキスト・メッセージの作成」をクリックします。

関連項目:

- 「翻訳が必要な内部メッセージ」

- 「翻訳が必要な対話モード・レポートのメッセージ」

20.6.4.2 テキスト・メッセージの編集

テキスト・メッセージを編集するには、次のステップを実行します。

1. アプリケーションの翻訳ページにナビゲートします。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. 「共有コンポーネント」をクリックします。

d. 「グローバリゼーション」の下で「テキスト・メッセージ」をクリックします。

2. テキスト・メッセージの編集で、次のステップを実行します。

a. メッセージ名をクリックします。

b. 適切な編集を加えます。

英語のテキスト・メッセージに定位置の置換値(%0、%1など)が含まれている場合、ユーザー定義のメッセージにも同じ名前と数字の定位置の置換値を含めてください。

c. 「変更の適用」をクリックします。

3. グリッド編集ページにアクセスするには、次のステップを実行します。

a. 「グリッド編集」をクリックします。

グリッド編集ページが表示されます。

b. 適切な編集を加えます。

英語のテキスト・メッセージに定位置の置換値(%0、%1など)が含まれている場合、ユーザー定義のメッセージにも同じ名前と数字の定位置の置換値を含めてください。

c. 「変更の適用」をクリックします。

ヒント:

グリッド編集ページから新しいメッセージを追加するには、ページの下部にある「テキスト・メッセージの追加」をクリックします。

20.6.4.3 翻訳が必要な内部メッセージ

「翻訳の必要な内部メッセージ」に、翻訳の必要な内部メッセージをリストします。

表 20-3 翻訳が必要な内部メッセージ

メッセージ名

英語のテキスト

APEX.ACTIONS.TOGGLE

Toggle %0

APEX.ACTIVE_STATE

(Active)

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.COMBOBOX.LIST_OF_VALUES

LOV

APEX.COMBOBOX.SHOW_ALL_VALUES

Open list for: %0

APEX.COMPLETED_STATE

(Completed)

APEX.CORRECT_ERRORS

Correct errors before saving.

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.DIALOG.CANCEL

Cancel

APEX.DIALOG.CLOSE

Close

APEX.DIALOG.HELP

Help

APEX.DIALOG.OK

OK

APEX.DIALOG.SAVE

Save

APEX.ERROR.PAGE_NOT_AVAILABLE

Sorry, this page isn't available

APEX.ERROR_MESSAGE_HEADING

Error Message

APEX.FILE_BROWSE.DOWNLOAD_LINK_TEXT

Download

APEX.GO_TO_ERROR

Go to error

APEX.ITEM.HELP_TEXT

Help Text: %0

APEX.ITEM.NOT_FOUND

Item %0 not found.

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.MENU.CURRENT_MENU

current

APEX.MENU.OVERFLOW_LABEL

More...

APEX.MENU.PROCESSING

Loading

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.DUPLICATE_SUBMIT

This page was already submitted and can not be re-submitted.

APEX.PAGE_ITEM_IS_REQUIRED

#LABEL# must have some value.

APEX.POPUP_LOV.ICON_TEXT

Popup List of Values: %0

APEX.PROCESSING

Processing

APEX.REGION.JQM_LIST_VIEW.LOAD_MORE

Load more

APEX.REGION.JQM_LIST_VIEW.SEARCH

Search

APEX.RICH_TEXT_EDITOR.ACCESSIBLE_LABEL

%0, rich text editor

APEX.SINCE.SHORT.DAYS_AGO

%0d

APEX.SINCE.SHORT.DAYS_FROM_NOW

in %0d

APEX.SINCE.SHORT.HOURS_AGO

%0h

APEX.SINCE.SHORT.HOURS_FROM_NOW

in %0h

APEX.SINCE.SHORT.MINUTES_AGO

%0m

APEX.SINCE.SHORT.MINUTES_FROM_NOW

in %0m

APEX.SINCE.SHORT.MONTHS_AGO

%0mo

APEX.SINCE.SHORT.MONTHS_FROM_NOW

in %0mo

APEX.SINCE.SHORT.SECONDS_AGO

%0s

APEX.SINCE.SHORT.SECONDS_FROM_NOW

in %0s

APEX.SINCE.SHORT.WEEKS_AGO

%0w

APEX.SINCE.SHORT.WEEKS_FROM_NOW

in %0w

APEX.SINCE.SHORT.YEARS_AGO

%0y

APEX.SINCE.SHORT.YEARS_FROM_NOW

in %0y

APEX.SUCCESS_MESSAGE_HEADING

Success Message

APEX.TABS.NEXT

Next

APEX.TABS.PREVIOUS

Previous

APEX.TB.TOOLBAR

Toolbar

APEX.TEMPLATE.EXPAND_COLLAPSE_NAV_LABEL

Expand / Collapse Navigation

APEX.TEMPLATE.EXPAND_COLLAPSE_SIDE_COL_LABEL

Expand / Collapse Side Column

APEX.THEMES.INVALID_THEME_NUMBER

Theme number is invalid or theme is not a current UI theme.

APEX.UI.BACK_TO_TOP

Start of page

APEX.VALUE_REQUIRED

Value Required

APEX.WAIT_UNTIL_PAGE_LOADED

Please wait until the page is fully loaded and try again.

CHART_SERIES_ERROR

Chart series error %0 for %1.

FLOW.SINGLE_VALIDATION_ERROR

1 error has occurred.

FLOW.VALIDATION_ERROR

%0 errors have occurred.

INVALID_CREDENTIALS

Invalid Login Credentials .

LAYOUT.CHART

Chart

LAYOUT.T_#EXPAND_COLLAPSE_NAV_LABEL#

Label for Expand / Collapse Navigation

LAYOUT.T_#EXPAND_COLLAPSE_SIDE_COL_LABEL#

Label for Expand / Collapse Side Column

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

REGION_NAME.NATIVE_JET_CHART

Chart

REPORT_TOTAL

report total

RESET

reset pagination

SHOW_ALL

Show All

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

UPGRADE_CANDLESTICK_CHART

After upgrading, ensure the series attribute Label Column is mapped to a Date / Timestamp column.

WWV_FLOW_CREATE_MODEL_APP.CREATE_IG

Unable to create interactive grid page. %0

WWV_FLOW_CUSTOMIZE.T_MESSAGE3

You can personalize the appearance of this application by changing the Theme Style.Please select a Theme Style from the list below and click on Apply Changes.

WWV_FLOW_CUSTOMIZE.T_REGION_DISP

Region Display

WWV_FLOW_CUSTOMIZE.T_REMOVE_STYLE

Use Application Default Style

WWV_FLOW_CUSTOMIZE.T_THEME_STYLE

Appearance

WWV_FLOW_DATA_EXPORT.AGG_COLUMN_IDX_NOT_EXIST

The column index referenced in the aggregate %0 does not exist.

WWV_FLOW_DATA_EXPORT.COLUMN_BREAK_MUST_BE_IN_THE_BEGGINING

The column break needs to be in the beggining of the columns array.

WWV_FLOW_DATA_EXPORT.COLUMN_GROUP_IDX_NOT_EXIST

The column group index referenced in %0 does not exist.

WWV_FLOW_DATA_EXPORT.HIGHLIGHT_COLUMN_IDX_NOT_EXIST

The column index referenced in the highlight %0 does not exist.

WWV_FLOW_DATA_EXPORT.PARENT_GROUP_IDX_NOT_EXIST

The parent group index referenced in %0 does not exist.

WWV_FLOW_UTILITIES.CAL

Calendar

WWV_FLOW_UTILITIES.CLOSE

Close

WWV_FLOW_UTILITIES.OK

Ok

WWV_FLOW_WEB_SERVICES.AUTHENTICATION_FAILED

Authentication failed.

WWV_FLOW_WEB_SERVICES.NO_VALID_OAUTH_TOKEN

OAuth access token not available or expired.

WWV_FLOW_WEB_SERVICES.UNSUPPORTED_OAUTH_TOKEN

Server responded with unsupported OAuth token type.

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

20.6.4.4 翻訳が必要な対話モード・レポートのメッセージ

表 20-4に、翻訳が必要な対話モード・レポート・メッセージを示します。

表 20-4 翻訳が必要な対話モード・レポート・メッセージ

メッセージ名

英語のテキスト

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

Data

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

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_EXPR_TOO_LONG

The filter expression is too long.

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).You can save four types of interactive reports:

- 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_MAP_IT

Map it

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_MULTIIR_PAGE_REGION_STATIC_ID_REQUIRED

Region Static ID must be specified as the page contains multiple interactive reports.

APEXIR_NAME

Name

APEXIR_NEW_AGGREGATION

New Aggregation

APEXIR_NEW_CATEGORY

- New Category -

APEXIR_NEW_CATEGORY_LABEL

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_ROW_COLUMN_INVALID

Select different row column.The HTML expression or link in the row column contains column defined as pivot or aggregate column.

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_REGION_STATIC_ID_DOES_NOT_EXIST

Region Static ID %0 does not exist.

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_REMOVE_REPORT

Remove Report

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_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

20.7 LOVをサポートするデータの翻訳

動的データを翻訳するには、動的翻訳を作成します。たとえば、データベース問合せに基づくLOVで動的翻訳を使用する場合があります。

動的翻訳は、メッセージ名ではなく特定の文字列を問い合せるという点でメッセージとは異なります。動的翻訳は、動的翻訳ページで定義します。その後、APEX_LANG.LANG APIを使用して、パラメータp_primary_text_stringで指定された動的翻訳文字列を戻します。

トピック:

- 動的翻訳の定義

関連項目:

『Oracle Application Express APIリファレンス』のAPEX_LANGに関する項

20.7.1 動的翻訳の定義

動的翻訳は、動的翻訳ページで定義します。動的翻訳は、翻訳元の言語文字列、言語コードおよび翻訳先の文字列で構成されています。

動的翻訳を定義するには、次のステップを実行します。

1. アプリケーションの翻訳ページにナビゲートします。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. 「共有コンポーネント」をクリックします。

d. 「グローバリゼーション」の下で「アプリケーションの翻訳」をクリックします。

2. アプリケーションの翻訳ページの「翻訳ユーティリティ」で、「動的翻訳」を選択します。

3. 動的翻訳ページで、「作成」をクリックし、次のように指定します。

a. 言語 - ターゲットの言語を選択します。

b. 翻訳元テキスト - 翻訳するテキストを入力します。

c. 翻訳先テキスト - 翻訳したテキストを入力します。

4. 「作成」をクリックします。

20.8 サポートされるグローバリゼーション・コードの理解

多言語アプリケーションを構築する場合、グローバリゼーション・コードが、アプリケーションの実行方法に与える影響を理解しておくことが重要です。これらのコードは、選択したアプリケーション・レベルのグローバリゼーション属性に基づいて自動的に設定されます。

トピック:

- Oracle Application Expressのグローバリゼーション・コード

関連項目:

アプリケーションへのプライマリ言語の指定

20.8.1 Oracle Application Expressのグローバリゼーション・コード

表20-5に、Oracle Application Expressのグローバリゼーション・コードを示します。NLS_LANGUAGEおよびNLS_TERRITORY によって、数字、日付および通貨のデフォルトの表示形式が決まります。

表20-5 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

21 アプリケーション・パフォーマンスの管理

この項では、アプリケーション・パフォーマンスを向上する方法について説明します。

トピック:

- パフォーマンス向上のベスト・プラクティスについて

- パフォーマンス問題の特定

- ログおよびレポートの使用

- データベース・レポートの使用について

- パフォーマンスに影響するデータベース・パラメータについて

- リソース制限について

- Webサーバーへの静的ファイルのアップロードについて

- APEX_ACTIVITY_LOGを使用したカスタム・アクティビティ・レポートの作成

関連項目:

アプリケーションのデバッグ

21.1 パフォーマンス向上のベスト・プラクティスについて

多くの同時ユーザーが存在するアプリケーションでは、最適なパフォーマンスを保持することが重要です。アプリケーションのパフォーマンスを最適化するには、次の機能を使用する必要があります。

- アプリケーションではできるかぎりバインド変数を使用します。SQL問合せ、およびプロセスや検証から実行されるPL/SQLなどのアプリケーション・ロジックでバインド変数構文を使用すると、セッション・ステート値を参照できます。バインド変数を使用してセッション・ステートにアクセスすると、最も効率的にセッション・ステートを参照できます。

- #TIMING#置換文字列をリージョン・フッターに含めて、各リージョンのタイミングを表示できます。

関連項目:

- バインド変数構文を使用したセッション・ステートの参照

- 置換文字列の理解

21.2 パフォーマンス問題の特定

この項では、Oracle Application Expressアプリケーションのパフォーマンス問題の特定および解決に役立ついくつかの主要な方法について説明します。

トピック:

- 実行速度の遅いアプリケーションのトラブルシューティングについて

- パフォーマンス問題の診断

- 問題のあるSQL問合せのデバッグについて

- 速度の遅い問合せへの対処について

21.2.1 実行速度の遅いアプリケーションのトラブルシューティングについて

実行速度の遅いアプリケーションのトラブルシューティングにおける最初のステップは、ボトルネックの場所を特定することです。特定のページ・リクエストまたは送信がデータベースから返されるためにかかる時間を確認することによって、アプリケーションのパフォーマンスを評価できます。この時間が、ユーザーのブラウザでページをレンダリングするためにかかる時間よりも短い場合は、アプリケーションが遅いと認識される原因は他のコンポーネントにある可能性が高くなります。クライアント・マシン、ネットワーク、中間層、データベース、ディスクおよびストレージ・デバイスを含む、すべての関連コンポーネントを常にチェックすることがベスト・プラクティスとなります。データベースについては、システム・グローバル領域(SGA)、CPU使用率、ロックおよびデータベース・パラメータをチェックします。また、レガシー・アプリケーション、データ・ウェアハウス、バッチ・プログラム、データベース・ジョブなど、データベース内で他に実行されているものがあるかどうかを確認することも重要です。

ほとんどの場合、Oracle Application Expressアプリケーションのパフォーマンス問題は開発者が作成したSQLおよびPL/SQLによるものです。これらの問題に対処するには、標準のデータベース・パフォーマンス・チューニング手法を使用する必要があります。パフォーマンス問題がOracle Application ExpressまたはOracle Databaseのバグに関連していることはほとんどありません。

関連項目:

Oracle Databaseパフォーマンス・チューニング・ガイド

21.2.2 パフォーマンス問題の診断

パフォーマンスの問題を診断するには、次のステップを実行します。

1. 時間ウィンドウを特定します。

2. データベース時間の最大のコンシューマを特定します。

3. Oracle Application Expressワークスペースおよびアプリケーションを特定します。

4. 問題の原因となっているSQLとアプリケーション内の特定の場所の関連を確認します。

実行速度の遅いページを特定したら、デバッグ・モードでアプリケーションを実行して、最も多くの時間を消費しているコンポーネントを特定する必要があります。

21.2.3 問題のあるSQL問合せのデバッグについて

問合せが正常に実行されていない可能性がある場合、SQL*Plus、SQL DeveloperまたはSQLコマンドでの実行を試してください。いずれの方法でも、アプリケーションのコンテキスト外で問合せがテストされるため、問題をより簡単に特定できます。

21.2.4 速度の遅い問合せへの対処について

最適化された問合せの処理が1秒を超える場合は、進捗バーの実装および複数のページ送信を回避することを検討します。ユーザーは即時の結果を期待し、ページがすぐに返されないと、多くの場合、ページを再送信します。適切に管理されていない場合、ページ送信ごとにデータベース内で新しいセッションが開始され、完了するまで継続します。多くの場合、複数のページ送信はパフォーマンスを低下させ、データベース・ロックにつながる可能性があります。このことは、特に対話モード・レポートに該当します。別の方法として、Oracle Application Expressコレクションを使用して問合せ結果を保持することをお薦めします。コレクションを使用すると、コストと時間のかかる問合せは、ページ区切りの実行やフィルタの作成ごとではなく、ユーザーごとに1回のみ実行されるようになります。

関連項目:

- レガシー・コンポーネント・ビューでのページ属性へのアクセス

- 「重複送信」

- 「コレクションの使用について」

21.3 ログおよびレポートの使用

Application Expressエンジンは、使用状況およびパフォーマンス・データを取得するために、アクティビティ・ログを記録します。この情報は様々なレポートに表示されます。特定のページに対するアクセスが過剰である場合や、ページのレンダリングが遅い場合は、これらのレポートが問題のあるページを特定するために役立ちます。その後、それらの問題のあるページをさらに分析できます。たとえば、SQL Developerでレポート問合せを実行し、実行計画を確認できます。

ヒント:

ページまたはプロセス内のコストのかかる要素を特定するもう1つの方法は、Application Expressデバッグ・モードを確認することです。

トピック:

- ログ・ファイルの管理方法

- 「アプリケーション・ダッシュボード」レポートの表示

- ワークスペース・アクティビティ・レポート

- インスタンス・アクティビティ・レポート

関連項目:

- 『Oracle Application Express APIリファレンス』のAPEX_DEBUGに関する説明

- デバッグ・モードの使用

21.3.1 ログ・ファイルの管理方法

インスタンス管理者は、アクティビティ・ログ・ファイルを削除し、ログ・ファイル情報が保持される間隔を管理できます。アクティビティ・ログ・ファイルを無期限に保持する場合は、アクティビティ・ログの表から別の表にレコードをコピーするバッチ・ジョブを作成する必要があります。

関連項目:

『Oracle Application Express管理ガイド』のログおよびファイルの管理に関する項

21.3.2 「アプリケーション・ダッシュボード」レポートの表示

アプリケーション・ダッシュボードを表示するには、次のステップを実行します。

1. 「ワークスペース」ホームページにナビゲートします。

2. 「アプリケーション・ビルダー」アイコンをクリックします。

3. アプリケーションを選択します。

アプリケーションのホームページが表示されます。

4. 「ユーティリティ」をクリックします。

5. 「アプリケーション・ダッシュボード」をクリックします。

アプリケーション・ダッシュボードが表示されます。左側にある最初の2つのリージョン(「アプリケーション概要」と「タイプ別の表示」)に現在のアプリケーションについての詳細情報と統計がリストされます。残りのリージョンは、次のセクションに分割されます。

- セキュリティ: 現在の認証スキーム、パブリック・ページと非パブリック・ページの数およびカレント・アプリケーション内で使用される認可スキームの数が表示されます。

- テンプレート: カレント・アプリケーション内で使用されるテンプレートのレポートへのリンクが表示されます。

- タイプ別の表示: タイプ別にページをリストします。

- アプリケーション・コンポーネント: アプリケーション・レベルのコントロールとロジックのレポート(LOV、タブ、リスト、アプリケーション・アイテム、アプリケーション・プロセス、アプリケーションの計算など)へのリンクが表示されます。

- ページ・コンポーネント: ページ・レベルのコントロールとロジックのレポート(アイテム、ボタン、プロセス、リージョン、ブランチ、検証、動的アクションなど)へのリンクが表示されます。

6. 特定のレポートを表示するには、コンポーネント・タイプまたはテンプレートの右にある数字をクリックします。

21.3.3 ワークスペース・アクティビティ・レポート

ワークスペース管理者は、ワークスペースに固有の管理タスクを実行するユーザーです。ワークスペース管理者は、次のアクティビティ・レポートにアクセスできます。

- ページ・ビュー - ビュー別、ユーザー別、アプリケーション別、アプリケーションとページ別、日別、時間別および対話モード・レポート別に構成されるページ・ビューのレポートが含まれます。

- 開発者アクティビティ: 開発者、日、アプリケーション、アプリケーション変更、および日または月別に構成された開発者アクティビティのレポートを提供します。

- ページ・ビューの分析 - 最も表示されたページ、日別のページ・ビュー、日別の使用状況(チャート)、重み付けされたページ・パフォーマンスおよびWebシート・ページ・ビューなどのレポート分析ページ・ビューが含まれます。

- セッション - アクティブ・セッションと現行のワークスペースがリストされます(レポートまたはチャート)。

- ログイン試行回数 - ログイン試行回数、認証結果ごとのログイン試行回数および開発者ログイン・サマリーをリストしたレポートを提供します。

- 環境 - ユーザー・エージェント別、ブラウザ別、外部アクセス別またはオペレーティング・システム別に構成される環境のレポートが含まれます。

- アプリケーション・エラー: アプリケーション・エラーのレポートが含まれます。

- ワークスペース・スキーマ・レポート - スキーマの表領域使用率およびスキーマ別のデータベース権限のサマリー、ワークスペース・スキーマおよびレポート表領域の使用率を提供します。

関連項目:

Oracle Application Express管理ガイドの「ワークスペース内のアクティビティの監視」

21.3.4 インスタンス・アクティビティ・レポート

インスタンス管理者は、Application Express管理サービス・アプリケーションを使用して、ホスティングされたインスタンス全体を管理するスーパーユーザーです。インスタンス管理者は、次のアクティビティ・レポートにアクセスできます。

- ページ・ビュー: アプリケーション、ユーザー、ワークスペース、日またはRESTアクセス別にアクティビティを表示します。

- ワークスペースの消去: ダッシュボード・サマリー、アクティブでないワークスペース、消去済のワークスペース、アクティブになったワークスペースまたはワークスペースの消去ログを表示します。

- 環境レポート: 使用されるオペレーティング・システム、ブラウザ・タイプ、ユーザー・エージェントまたは外部サイトのサマリーを表示します。

- カレンダ・レポート: 最後に使用された日付別にワークスペースを表示し、日別、さらにアプリケーションおよびユーザー別、または時間別にページ・ビューを表示します。

- サービス・リクエスト: 新規サービス・リクエストまたはサインアップ・アンケートのアクティビティを表示します。

- ログ: メール・ログ、ジョブ・ログ、自動削除ログを表示、またはパッケージ・アプリケーションのインストールを監視します。

- ログイン試行回数: ログイン試行回数または最後の開発者ログインを表示します。

- 開発者アクティビティ: 開発者またはワークスペース別にアプリケーション変更を表示します。

関連項目:

Oracle Application Express管理ガイドの「開発インスタンス間のアクティビティの監視」およびOracle Application Express管理者のロールについて

21.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_READ_ROLEまたはAPEX_ADMINISTRATOR_ROLEが付与されているユーザーは、スキーマ・ユーザーが関連付けられているワークスペースだけでなく、インスタンス全体に対する問合せを実行できます。モニタリング・ユーザーにはAPEX_ADMINISTRATOR_READ_ROLEを付与する必要があります。APEX_ADMINISTRATOR_ROLEはインスタンス・パラメータ、ワークスペースなどを管理するインスタンス管理者に使用する必要があります。

関連項目:

- SQLトレースの有効化およびTKPROFの使用

- Oracle Databaseパフォーマンス・チューニング・ガイド

- Oracle Application Express SQLワークショップ・ガイド

21.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_050100スキーマに集約することをお薦めします。正確な統計によって、コストベース・オプティマイザで、アプリケーション・メタデータにアクセスするための問合せ計画をより適切に作成できます。

21.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を使用したリソースの管理に関する項

21.7 Webサーバーへの静的ファイルのアップロードについて

パフォーマンスを向上させるには、Webサーバーに静的ファイルを置くことが必要です。また、ベスト・プラクティスとして、静的ファイルをブラウザに送信するときにファイル・サイズが最小化されるように、Webサーバーでgzipでの圧縮を有効化することもお薦めします。さらに、有効期限ヘッダーを送信することによって、ブラウザのファイル・キャッシュを有効化することもお薦めします。

関連項目:

- 「静的アプリケーション・ファイルの管理」

- 「静的ワークスペース・ファイルの管理」

21.8 APEX_ACTIVITY_LOGを使用したカスタム・アクティビティ・レポートの作成

この項では、APEX_ACTIVITY_LOGビューを使用して、現在のワークスペースのアクティビティを問い合せる方法について説明します。

トピック:

- アプリケーションのロギングの有効化

- APEX_ACTIVITY_LOG

- APEX_ACTIVITY_LOGのサンプル問合せ

21.8.1 アプリケーションのロギングの有効化

アプリケーション定義の編集ページでアプリケーションのロギングを有効にできます。

アプリケーション定義を編集するには、次のステップを実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. アプリケーション名の右側にある「アプリケーション・プロパティの編集」ボタンをクリックします。

「アプリケーション定義の編集」ページが表示されます。

4. 「プロパティ」で、「ロギング」を見つけます。「はい」または「いいえ」を選択します。

「はい」に設定した場合、すべてのページ・ビューがログに記録されるため、管理者はアプリケーションごとにユーザー・アクティビティを監視できます。高容量アプリケーションでは、ロギングを無効にすることをお薦めします。

ヒント:

Oracle Application Express管理サービスの「アプリケーション・アクティビティのロギング」属性が「アプリケーションの設定を使用(デフォルト)」に設定されている場合、「ロギング」属性の変更のみ可能です。

関連項目:

『Oracle Application Express管理ガイド』のロギングでのアプリケーション・アクティビティの有効化に関する項

21.8.2 APEX_ACTIVITY_LOG

APEX_ACTIVITY_LOGビューには、開発者アクティビティ、アプリケーション実行時アクティビティなど、ワークスペースのすべてのアクティビティが記録されます。APEX_ACTIVITY_LOG使用して、現在のワークスペースのすべてのアクティビティを表示および問い合せることができます。たとえば、このビューを使用して、リアルタイムのパフォーマンス分析を提供する特定のアプリケーション内の監視レポートを開発できます。

表 21-1に、APEX_ACTIVITY_LOGビューの列を示します。

表 21-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ブラウザ・ユーザー・エージェントが含まれます。

21.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つあるので、ロギング情報はログのうち古い方の使用可能なエントリのみとなります。アプリケーションの特定のログ情報を常に保持する場合は、所有するアプリケーション表に両方のログ情報をコピーするか、アプリケーションに直接ロギングを実装する必要があります。

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. 該当するアプリケーションにナビゲートします。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

アプリケーション・ビルダーのホームページが表示されます。

b. アプリケーションを選択します。

アプリケーションのホームページが表示されます。

2. 「ユーティリティ」をクリックします。

3. 「アドバイザ」をクリックします。

アドバイザ・ページが表示されます。

4. 「実行する場合は選択」で、次のステップを実行します。

a. 「実行する場合は選択」を展開します。

b. 選択したオプションを確認します。必要に応じて、オプションを選択または選択解除します。

5. 「ページ」で、表示されているフィールドにページのカンマ区切りリストを入力します。すべてのページをチェックするには、このオプションを空白のままにします。

6. ページ上部の「チェックの実行」をクリックします。

結果ページが表示されます。

ヒント:

チェックを次回実行するときは、現在のアドバイザの設定が使用されます。

7. 既存のプリファレンスを変更するには、次のステップを実行します。

a. 「フィルタ結果」で、適切なオプションの選択を解除します。

b. 「フィルタの適用」をクリックします。

8. アドバイザを再び実行するには、「チェックの実行」をクリックします。

22.1.3 単一ページ上でのアドバイザの実行

アドバイザを単一ページ上で実行するには、次のステップを実行します。

1. 適切なページにナビゲートします。

2. 「ユーティリティ」メニューをクリックし、「アドバイザ」を選択します。

アドバイザが表示されます。

3. 「実行する場合は選択」で、選択されたオプションを確認します。必要に応じて、オプションを選択または選択解除します。

4. ページ上部の「チェックの実行」をクリックします。

結果ページが表示されます。

5. 既存のプリファレンスを変更するには、次のステップを実行します。

a. 「フィルタ結果」で、適切なオプションの選択を解除します。

b. 「フィルタの適用」をクリックします。

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つずつ削除することをお薦めします。この方法を使用すると、問題の原因となっている可能性があるコントロールまたはコンポーネントを迅速に判別できます。ビルド・オプションを作成して、コントロールまたはコンポーネントを無効にできます。ビルド・オプションを使用すると、アプリケーションで特定の機能を条件付きで表示できます。

ビルド・オプションを使用すると、アプリケーションで特定の機能を条件付きで表示できます。ビルド・オプションは、INCLUDEおよびEXCLUDEという2つの値をとることができます。属性を含めように指定すると、Application Expressエンジンは、実行時にその属性をアプリケーション定義の一部とみなします。逆に、属性を除外するように指定すると、Application Expressエンジンは、その属性を存在しないものとして処理します。

条件を使用してコントロールまたはコンポーネントを削除するデメリット

Oracle Application Expressの以前のリリースでは、開発者は条件属性を「なし」に設定してコントロールまたはコンポーネントを無効化することが推奨されていました。このアプローチは引き続き有効ですが、大きなデメリットは既存の条件が上書きされることです。

関連項目:

ビルド・オプションを使用した構成の制御

23 アプリケーションのデプロイ

デプロイは、アプリケーションをテスト・フェーズから本番フェーズに移動するプロセスです。

ヒント:

デプロイの最適化およびOracle Application Expressアプリケーションのライフ・サイクル全体を通じたデプロイに関する推奨事項を確認するには、Oracle Application Expressでのライフ・サイクル管理を参照してください。 http://www.oracle.com/technetwork/developer-tools/apex/learnmore/apex-life-cycle-management-wp-3030229.pdfに移動します。

ヒント:

デプロイ・オプションを示すチュートリアルを確認するには、Oracle Online Learning Library (http://www.oracle.com/oll/apex)でAdvanced Deployment of Your Applicationを検索してください。

トピック:

- 推奨環境について

- 考慮すべきシステム開発のライフ・サイクル方法論

- デプロイ・プロセスの理解

- 別のインスタンスへのアプリケーションの移動方法

- カスタム・パッケージ・アプリケーションの作成方法

- アプリケーションおよびアプリケーション・コンポーネントのエクスポート

- エクスポート・ファイルのインポート

- エクスポート・ファイルのインストール

- データベース・アプリケーションURLの公開について

- Webシート・アプリケーションURLの公開について

- ビルド・オプションを使用した構成の制御

関連項目:

- 『Oracle Application Express管理ガイド』

- 「アプリケーション機能の拡張」

23.1 推奨環境について

Oracle Application Expressでアプリケーションを開発する場合は、標準的なシステム開発のライフ・サイクル事例に従い、開発、テストおよび本番に異なる環境を使用することをお薦めします。開発者には開発環境内のアプリケーションおよび関連データベース・オブジェクトの変更のみを許可することがベスト・プラクティスとなります。

このポリシーをさらに強化するために、テスト環境と本番環境に、ランタイムのみのOracle Application Express環境をインストールすることをお薦めします。これにより、開発者がこれらの環境でアプリケーション・ビルダーおよびSQLワークショップにアクセスすることが禁止されます。一般的に、テスト環境と本番環境を更新する権限は、管理者(DBA)のみが持つようにします。DBAは提供された適切なAPIを使用し、SQL DeveloperやSQL*PlusなどのSQLインタフェースからアプリケーションをインポートする必要があります。

関連項目:

ランタイム環境と完全開発環境の違いについて

23.2 考慮すべきシステム開発のライフ・サイクル方法論

システム開発のライフ・サイクル(SDLC)は、定義された一連のステップを使用した、ソフトウェア開発全体のプロセスです。この項では、Oracle Application Expressでのアプリケーション開発に役立つ複数のSDLCモデルについて説明します。

トピック:

- 反復開発と計画開発について

- プロトタイプ作成の利点について

- ウォーターフォール

- スパイラル

- 高速アプリケーション開発

23.2.1 反復開発と計画開発について

アプリケーション・ビルダーを使用してアプリケーションを開発するときには、次のように大きく異なる2つの開発方法の間でバランスを見いだす必要があります。

- 反復による、迅速なアプリケーション開発

- 計画され、段階を経る開発

反復による、迅速なアプリケーション開発は、その高い柔軟性のために、プロジェクトが完了しないリスクがあります。それとは対照的に、計画され、段階を経る開発は、理論上は決められた要件を満たしていても、エンド・ユーザーのニーズに合わないアプリケーションが作成される可能性があります。

23.2.2 プロトタイプ作成の利点について

Oracle Application Expressの開発環境を使用すると、開発者は、開発においてより対話的な方法をとることができます。他の多くの開発環境とは異なり、プロトタイプの作成が容易です。Oracle Application Expressを使用すると、開発者は次のことを実行できます。

- 組込みウィザードを使用して、アプリケーションのユーザー・インタフェースを迅速に設計できます。

- ユーザーによる使用が可能なプロトタイプを作成し、フィードバックを収集できます。

- 変更をリアルタイムに実装し、新しいプロトタイプを即時に作成できます。

Oracle Application Expressを使用して機能する方法論として、スパイラルと高速アプリケーション開発(RAD)があります。

関連項目:

- 「スパイラル」

- 「高速アプリケーション開発」

23.2.3 ウォーターフォール

ウォーターフォールは、最も有名なSDLCモデルでしょう。この方法では、開発プロセスは次の段階に分類されます。

1. プロジェクトのプランニング

2. 要件の定義

3. 設計

4. 開発

5. 統合およびテスト

6. インストールおよび採用

7. メンテナンス

この方法は、ある段階の出力結果が次の段階の入力内容になることから、ウォーターフォールと呼ばれます。

この方法には、前の段階ですべての要件が確立されていることが前提となります。しかし、実際には、開発プロセスの途中で要件が変更されたり、新しい要件が加わることが多くあります。

23.2.4 スパイラル

スパイラルの方法は、実質的には、短いウォーターフォール・サイクルの連続となります。各ウォーターフォール・サイクルから新たな要件が発生し、開発チームによって堅牢なプロトタイプが作成できるようになります。この方法の利点の1つは、変化する要件に対応できることです。短所は、複雑なプロジェクト管理と開発が無期限に続くリスクです。

23.2.5 高速アプリケーション開発

高速アプリケーション開発(RAD)の方法では、完成した製品に近いプロトタイプの作成を非常に重要視します。プロトタイプは、要件フェーズの重要な部分です。このモデルの利点は、要件の変更に対応できること、開発サイクルが高速であること、進捗を容易に測定できることなどです。このモデルの主な短所は、プロトタイプの作成を重要視することによって有効範囲が肥大化する可能性があることです。その結果、開発者が完全なアプリケーションを作成しようとして、当初の目的を見失うことがあります。

23.3 デプロイ・プロセスの理解

この項では、デプロイ・プロセスの様々な手法について説明します。

トピック:

- 別のインスタンスへのアプリケーションの移動について

- 考慮するデプロイ・オプション

- ワークスペースをコピーするかどうかについて

- データベースをコピーするかどうかについて

- アプリケーションIDについて

23.3.1 別のインスタンスへのアプリケーションの移動について

あるOracle Application Expressインスタンスから別のインスタンスにアプリケーションを移動するには、アプリケーションで使用されるメタデータとサポートするオブジェクトの両方を次のように移動する必要があります。

1. アプリケーション定義およびすべての関連ファイルを移動します。

2. サポートするオブジェクトを移動します。「データベース・オブジェクトの依存性」レポートを確認して、移動するオブジェクトを決定します。

関連項目:

- 別のインスタンスへのアプリケーションの移動方法

- 「「データベース・オブジェクトの依存性」レポートの使用」

- カスタム・パッケージ・アプリケーションの作成方法

23.3.2 考慮するデプロイ・オプション

アプリケーション・ビルダーでアプリケーションを開発する場合は、特定の作業領域内でアプリケーションを作成します。各ワークスペースには、一意のIDおよび名前が含まれます。通常は、開発インスタンスでアプリケーションを作成し、本番インスタンスにアプリケーションをデプロイします。

考慮するデプロイ・オプションには、次のものがあります。

1. 同一ワークスペースおよび同一スキーマの使用: アプリケーションをエクスポートしてからインポートし、別のアプリケーションIDを使用してインストールします。この方法は、基礎になるオブジェクトに対する変更は少ないが、アプリケーションの機能に対して頻繁に変更がある場合に有効です。

2. 別のワークスペースおよび同じスキーマの使用: アプリケーションをエクスポートしてから別のワークスペースにインポートします。この方法は、開発者によって本番アプリケーションが変更されないようにするために有効です。

3. 別のワークスペースおよび別のスキーマの使用: アプリケーションをエクスポートしてから別のワークスペースにインポートし、異なるスキーマを使用するためにアプリケーションをインストールします。この新しいスキーマには、アプリケーションに必要なデータベース・オブジェクトが含まれている必要があります。

4. すべてのバリエーションによる別のデータベースの使用: アプリケーションをエクスポートしてから別のOracle Application Expressインスタンスにインポートし、異なるワークスペース、スキーマおよびデータベースを使用してインストールします。

関連項目:

「「データベース・オブジェクトの依存性」レポートの使用」

23.3.3 ワークスペースをコピーするかどうかについて

既存のワークスペースをコピーするかどうかを判断する際に、プリファレンスが問題になります。本番バージョンでは関係するすべてのオブジェクトへのアクセスが必要であることを覚えておいてください。たとえば、次のような場合にワークスペースをコピーする必要があります。

- 開発環境と他の環境の間で同じアプリケーション識別子を保持する場合。

- アプリケーションでOracle Application Express認証に依存する場合。ワークスペースをコピーすると、自動的にすべての必要なユーザー・データが移行されます。

23.3.4 データベースをコピーするかどうかについて

データベースをコピーするかどうかを判断する際、アプリケーションが実行されるスキーマは、開発インスタンスと同じオブジェクトにアクセスする必要があることを覚えておいてください。スキーマの実際の名前は重要ではありません。スキーマ名は、インポート・プロセスで変更できます。

23.3.5 アプリケーションIDについて

開発バージョンと本番バージョンのアプリケーションで、アプリケーションIDを一致させる必要はありません。実際、アプリケーションにアプリケーションIDをハード・コードしないことをお薦めします。かわりにアプリケーションの別名(アプリケーションの編集ページで定義される)を使用するか、組込み置換文字列(APP_ID、APP_ALIASなど)を使用します。置換文字列は、アプリケーションの機能に影響なくアプリケーションIDを変更できるため、置換文字列の使用をお薦めします。

関連項目:

- アプリケーションの別名の定義の詳細は、「名前」

- APP_IDおよびAPP_ALIASの使用方法の詳細は「組込み置換文字列の使用」

23.4 別のインスタンスへのアプリケーションの移動方法

アプリケーションを他のワークスペースに移動するか、コピーを作成するのみかにかかわらず、デプロイでは次のステップを実行します。

1. サポートするデータベース・オブジェクトを移動します(適切な場合)。「データベース・オブジェクトの依存性」レポートを確認して、移動するオブジェクトを決定します。

2. アプリケーション定義とサポートするオブジェクトをパッケージ化して、カスタム・パッケージ・アプリケーションを作成します。

3. カスタム・パッケージ・アプリケーションのエクスポート

4. エクスポートされたファイルをターゲットのOracle Application Expressインスタンスにインポートします。

アプリケーションは、アプリケーションが開発されたワークスペース以外のワークスペースにもインポートできます。

ヒント:

アプリケーション定義およびすべてのサポートするオブジェクトを手動でも移動できます。

トピック:

- データベース・オブジェクトの管理について

関連項目:

- 「「データベース・オブジェクトの依存性」レポートの使用」

- カスタム・パッケージ・アプリケーションの作成方法

- アプリケーションおよびアプリケーション・コンポーネントのエクスポート

- 「エクスポート・ファイルのインポート」

- 「考慮するデプロイ・オプション」

- アプリケーションおよびアプリケーション・コンポーネントのエクスポート

23.4.1 データベース・オブジェクトの管理について

アプリケーションと適切な関連ファイルをエクスポートする前に、アプリケーションによって参照されるデータベース・オブジェクトも移行する必要があるかどうかを判断する必要があります。移動するデータベース・オブジェクトがわからない場合は、データベース・オブジェクトの依存性レポートを確認します。

ターゲットのスキーマが開発環境で使用されるスキーマとは異なる場合、アプリケーションによって参照されるデータベース・オブジェクトを移行する必要があります。多くの場合、Oracle Databaseのエクスポート・ユーティリティおよびインポート・ユーティリティを使用して、開発環境からターゲットのインスタンスにアプリケーション・スキーマをコピーするのみでこれを行うことができます。次に、この方法が適切でない2つの一般的なケースを示します。

- オブジェクト開発スキーマが、ターゲット・インスタンス・スキーマがアクセス権を持たない表領域を参照している場合。

- 開発インスタンス・スキーマに、ターゲット・インスタンス・スキーマに移行しないサンプル・データが含まれている場合。

データベース管理者またはOracle Application Express管理者がOracle Application Expressアプリケーションのエクスポートを行う場合、それらの管理者と連絡して、次のことを明示しておく必要があります。

- アプリケーションのエクスポート時に、すべてのデータを含める必要がある。

- 指定した特定の表のデータを含めない。

ヒント:

『Oracle Application Express SQLワークショップ・ガイド』のデータ・ワークショップを使用したデータの管理に関する説明

関連項目:

- 「「データベース・オブジェクトの依存性」レポートの使用」

- カスタム・パッケージ・アプリケーションの作成方法

23.5 カスタム・パッケージ・アプリケーションの作成方法

サポートするオブジェクト・ページでカスタム・パッケージ・アプリケーションを作成すると、アプリケーションのデプロイに必要なステップを大幅に簡略化することができます。

トピック:

- カスタム・パッケージ・アプリケーションの作成によってデプロイを簡略化する方法

- カスタム・パッケージ・アプリケーションの作成

- カスタム・パッケージ・アプリケーションへのアクセス制御リストの追加

- サポートするオブジェクトのインストール

- サポートするオブジェクトのスクリプト、メッセージ、およびインストール・オプションの削除

- カスタム・パッケージ・アプリケーションのアップグレード

- サポートするオブジェクトの削除

- インストール・サマリーの表示

関連項目:

- 別のインスタンスへのアプリケーションの移動方法

- アプリケーションおよびアプリケーション・コンポーネントのエクスポート

23.5.1 カスタム・パッケージ・アプリケーションの作成によってデプロイを簡略化する方法

開発者にとって、アプリケーションのインポートおよびインストールは煩雑なプロセスです。最初に、ターゲットのデータベース・オブジェクトおよびシード・データを作成します。次に、アプリケーション定義およびすべての関連ファイル(イメージ、テーマ、他のすべての必要な静的ファイルなど)をインポートしてインストールします。

サポートするオブジェクト・ユーティリティを使用してカスタム・パッケージ・アプリケーションを作成すると、このプロセスを大幅に簡略化することができます。多くのステップを実行して、データベース・オブジェクトを作成し、アプリケーションおよびすべてのサポートするファイルをインポートしてインストールするかわりに、サポートするオブジェクトを定義すれば、アプリケーションおよびサポートするファイルを簡単な数ステップで移行できます。

ユーザーがアプリケーション定義をインポートしてインストールした後に、ウィザードにより簡単な数ステップで構成できます。ウィザードでは、サポートするアプリケーション・オブジェクトをインストールするかどうかが要求されます。ユーザーには、サポートするアプリケーション・オブジェクトをその場でインストールするか、後でインストールするかのオプションがあります。

開発者にとって、この機能には、次のような多くの利点があります。

- サポートするオブジェクトが正しい順序で作成されていることを確認してください。

- わずかなステップでアプリケーションを簡単にデプロイするための自動化プロセスを提供します。

- ユーザーがアプリケーション定義をインポートしてインストールするときにまたは後で、サポートするアプリケーション・オブジェクトをインストールするオプションをユーザーに提供します。

- ユーザーおよび開発者は、便利な方法で、アプリケーション定義、サポートするファイルおよびすべてのデータベース・オブジェクトを削除できます。

- ユーザーおよび開発者に、前にリリースされたカスタム・パッケージ・アプリケーションを簡単にアップグレードする方法を提供します。

また、アプリケーションをサポートする基礎となるデータベース・オブジェクトを簡単に編集するために、削除機能およびインストール機能を利用することができます。たとえば、すべてのデータベース・オブジェクトの削除、基礎となるデータベース・オブジェクトの作成スクリプトの編集、および再定義されたアプリケーション・オブジェクトの作成用の再インストールを行うことができます。

関連項目:

- 「サポートするオブジェクトのインストール」

- 「サポートするオブジェクトの削除」

- 「カスタム・パッケージ・アプリケーションのアップグレード」

23.5.2 カスタム・パッケージ・アプリケーションの作成

カスタム・パッケージ・アプリケーションを作成するには、アプリケーションのサポートするオブジェクト(データベース・オブジェクト、イメージおよびシード・データを含む)およびすべてのインストール前の検証を定義するインストール・スクリプトを作成する必要があります。これらのオブジェクトとインストール・スクリプトおよび削除スクリプト、およびユーザーがサポートするオブジェクト・ページでインストールまたは削除する場合に表示するメッセージを定義します。

トピック:

- サポートするオブジェクト・ページへのアクセス

- サポートするオブジェクト・ページ

23.5.2.1 サポートするオブジェクト・ページへのアクセス

サポートするオブジェクト・ページで、カスタム・パッケージ・アプリケーションを作成します。

サポートするオブジェクト・ページのアプリケーションにアクセスするには、次のステップを実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

アプリケーションのホームページが表示されます。

3. 「サポートするオブジェクト」アイコンをクリックします。

サポートするオブジェクト・ページが表示されます。

23.5.2.2 サポートするオブジェクト・ページ

サポートするオブジェクト・ページの上部に、アプリケーション名が表示され、「オブジェクトの確認」、「システム権限の検証」、「必要な空きKB」、「使用許諾のプロンプト」および「エクスポートに含める」の現在の選択が示されます。これらのオプションの詳細は、フィールドレベル・ヘルプを参照してください。

サポートするオブジェクトをアプリケーション・エクスポートとともに含めるかどうかを指定するには、「エクスポートに含める」リストから「はい」または「いいえ」を選択し、「変更の適用」をクリックします。

ページの残りは、「インストール」、「アップグレード」および「削除」のカテゴリに分かれています。

トピック:

- インストール

- アップグレード

- 削除

関連項目:

「フィールドレベル・ヘルプの表示」

23.5.2.2.1 インストール

「インストール」のリンクを使用して次のタイプの情報を定義します。

- 前提条件。必要なディスクの空き領域、必要なシステム権限、スキーマ・オブジェクト制限など、アプリケーションのインストール前に必要な組込みチェックを定義します。

- アプリケーション置換文字列。アプリケーションに対して定義された静的置換文字列をリストします。アプリケーション内の多くの語句またはラベルに対する静的置換文字列を定義できます。
アプリケーションをパッケージ化する場合、カスタム・パッケージ・アプリケーションをインストールする際にユーザーが指定できる置換文字列のプロンプトを含めることができます。

- ビルド・オプション。このアプリケーションに対して定義されたビルド・オプションをリストします。ビルド・オプションを使用して、アプリケーション内の特定の機能を条件付きで表示できます。
アプリケーションをパッケージ化する場合、アプリケーションをインストールする際に表示される特定のビルド・オプションのプロンプトを含めることができます。

- インストール前の検証。カスタム・パッケージ・アプリケーションに対して定義された検証をリストします。標準のページ検証と同様に、ユーザー定義条件が満たされない場合、これらの検証によりユーザーはデータベース・オブジェクトをインストールできなくなります。「作成」をクリックして、画面に表示されるステップに従います。

- インストール・スクリプト。アプリケーションにサポートするオブジェクトをインストールする複数のインストール・スクリプトを定義できます。新規スクリプトを作成するには、「作成」をクリックして、画面に表示されるステップに従います。既存のスクリプトを編集するには、「編集」アイコンをクリックします。別の開発者がスクリプトを編集することを防ぐには、「ロック」アイコンをクリックします。スクリプトがロックされている場合、「ロック」アイコンは鍵が閉じた南京錠として表示されます。スクリプトのロックが解除されている場合、「ロック」アイコンは鍵が開いた南京錠として表示されます。

- メッセージ。ユーザーがアプリケーションをインストールまたは削除するときに表示するメッセージを定義します。サポートされるHTMLタグには、<b>、<i>、<u>、<p>、<br>、<hr>、<ul>、<ol>、<li>および<pre>が含まれます。
これらのメッセージを表示する際には、クロスサイト・スクリプティング(XSS)攻撃を防ぐために、一連の限定されたHTMLタグのみが認識されます。

関連項目:

- 「"置換」

- ビルド・オプションを使用した構成の制御

- 「ビルド・オプションまたはビルド・オプション・ステータスのエクスポート」

- クロスサイト・スクリプティング保護の理解

23.5.2.2.2 アップグレード

「アップグレード」のリンクを使用して次のタイプの情報を定義します。

- アップグレード・スクリプト。「アップグレード・スクリプト」をクリックして、既存のアプリケーションをアップグレードする際に、データベース・オブジェクト、イメージおよびシード・データをアップグレードするスクリプトを定義します。次を参照

- アップグレード・メッセージ。ユーザーがアプリケーションをアップグレードするときに表示するメッセージを定義します。サポートされるHTMLタグには、<b>、<i>、<u>、<p>、<br>、<hr>、<ul>、<ol>、<li>および<pre>が含まれます。
これらのメッセージを表示する際には、クロスサイト・スクリプティング(XSS)攻撃を防ぐために、一連の限定されたHTMLタグのみが認識されます。

関連項目:

- 「カスタム・パッケージ・アプリケーションのアップグレード」

- クロスサイト・スクリプティング保護の理解

23.5.2.2.3 削除

「削除」のリンクを使用して次のタイプの情報を定義します。

- 削除スクリプト。「削除スクリプト」をクリックして、インストール・スクリプトにより作成されたデータベース・オブジェクトおよび静的ファイルを削除するスクリプトを定義します。既存のスクリプトを編集するには、「編集」アイコンをクリックします。

- 削除メッセージ。ユーザーがアプリケーションを削除するときに表示するメッセージを定義します。サポートされるHTMLタグには、<b>、<i>、<u>、<p>、<br>、<hr>、<ul>、<ol>、<li>および<pre>が含まれます。
これらのメッセージを表示する際には、クロスサイト・スクリプティング(XSS)攻撃を防ぐために、一連の限定されたHTMLタグのみが認識されます。

関連項目:

クロスサイト・スクリプティング保護の理解

23.5.3 カスタム・パッケージ・アプリケーションへのアクセス制御リストの追加

アクセス制御リストを作成することによって、アプリケーション、個別ページまたはページ・コンポーネントへのアクセスを制御できます。

カスタム・パッケージ・アプリケーションのアクセス制御リストを追加するには、次のステップを実行します。

1. アクセス制御リストを作成します。

2. 次のように、サポートするオブジェクト・ページにナビゲートします。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

アプリケーションのホームページが表示されます。

c. 「サポートするオブジェクト」をクリックします。

サポートするオブジェクト・ページが表示されます。

3. 「インストール」で、「インストール・スクリプト」をクリックします。

インストール・スクリプト・ページが表示されます。

4. 「作成」をクリックします。

5. ページの下部で「タスク」リージョンを展開し、「アクセス制御表のスクリプトの作成」をクリックします。

アクセス制御表が定義されている場合は、スクリプトの作成ページに、含まれる表が表示されます。

6. 「スクリプトの作成」をクリックします。

関連項目:

「アプリケーション、ページおよびページ・コンポーネントへのアクセスの制御」

23.5.4 サポートするオブジェクトのインストール

サポートするオブジェクトを編集した後、適切なスクリプトを作成し、「タスク」リストの「サポートするオブジェクトのインストール」をクリックしてインストール・スクリプトを実行できます。

アプリケーション定義をインポートおよびインストールした後、カスタム・パッケージ・アプリケーション(またはサポートするオブジェクト)をインストールしないことを選択する場合は、エンド・ユーザーもこの機能を使用できます。

サポートするオブジェクトをインストールするには、次のステップを実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「サポートするオブジェクト」をクリックします。

サポートするオブジェクト・ページが表示されます。

4. 「タスク」リストで、「サポートするオブジェクトのインストール」をクリックします。

5. インストール・スクリプトを実行する前にその詳細を表示するには、「タスク」リージョンを展開し、「インストール・スクリプトのプレビュー」をクリックします。

スクリプトのプレビュー・ページが表示され、サマリー情報、前提条件および実行する実際のスクリプトがリストされます。

6. スクリプトのプレビュー・ページを終了して続行するには、「閉じる」をクリックします。

7. 「サポートするオブジェクトのインストール」から、「はい」をクリックし、「次へ」をクリックします。

8. 画面に表示されるステップに従います。

23.5.5 サポートするオブジェクトのスクリプト、メッセージ、およびインストール・オプションの削除

サポートするオブジェクト・ページの「タスク」リストの「サポートするオブジェクトのインストールの削除」をクリックすると、カスタム・パッケージ・アプリケーションに関連付けられたサポートするオブジェクトのスクリプト、メッセージおよびインストール・オプションを定義するメタデータを削除できます。

サポートするオブジェクトのスクリプト、メッセージおよびインストール・オプションを定義するメタデータを削除するには、次のステップを実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「サポートするオブジェクト」をクリックします。

サポートするオブジェクト・ページが表示されます。

4. ページの右側の「タスク」リストで、「サポートするオブジェクトのインストールの削除」をクリックします。

5. 画面に表示されるステップに従います。

23.5.6 カスタム・パッケージ・アプリケーションのアップグレード

アップグレード・ページで、前に公開されたアプリケーションをアップグレードするスクリプトを定義できます。

トピック:

- アップグレード・スクリプトの定義

- カスタム・パッケージ・アプリケーションのアップグレード

23.5.6.1 アップグレード・スクリプトの定義

アップグレード・ページを使用して、既存のアプリケーションをアップグレードする際に、データベース・オブジェクト、イメージおよびシード・データをアップグレードするスクリプトを定義できます。

アップグレード・スクリプトを作成するには、次のステップを実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「サポートするオブジェクト」をクリックします。

サポートするオブジェクト・ページが表示されます。

4. 「アップグレード」で、「アップグレード・スクリプト」をクリックします。

5. 「既存のサポートするオブジェクトの検出」セクションを使用して、適切なオブジェクトをインストールするか、またはアップグレードする必要があるかを決定します。

6. 「既存のサポートするオブジェクトを検査する問合せ」で、サポートするオブジェクトが存在する場合に少なくとも1つの行を戻す問合せをフィールドに入力します。

カスタム・パッケージ・アプリケーションをインストールするユーザーにインストール・スクリプトまたはアップグレード・スクリプトを実行するように求めるかどうかが、問合せにより決定されます。

7. スクリプトを作成するには、「作成」をクリックします。

ヒント:

このアプリケーションの様々な旧バージョンをユーザーがアップグレードできるようにするために、スクリプトのプロパティ・ページに移動してアップグレード・スクリプトに条件を追加できます。

8. 別の開発者がスクリプトを編集することを防ぐには、「ロック」アイコンをクリックします。

スクリプトがロックされている場合、「ロック」アイコンは鍵が閉じた南京錠として表示されます。スクリプトのロックが解除されている場合、「ロック」アイコンは鍵が開いた南京錠として表示されます。

9. 既存のスクリプトを編集するには、「編集」アイコンをクリックします。

10. 画面に表示されるステップに従います。

23.5.6.2 カスタム・パッケージ・アプリケーションのアップグレード

アップグレード・スクリプトの作成後、サポートするオブジェクト・ページの「タスク」リストの「サポートするオブジェクトのアップグレード」をクリックすることによりテストできます。

また、エンド・ユーザーもこの機能を使用して既存のカスタム・パッケージ・アプリケーションをアップグレードできます。

カスタム・パッケージ・アプリケーションをアップグレードするには、次のステップを実行します。

1. アップグレードする新しいバージョンのアプリケーションをインポートします(使用可能な場合)。

2. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

3. アプリケーションを選択します。

4. 「サポートするオブジェクト」をクリックします。

サポートするオブジェクト・ページが表示されます。

5. 「タスク」リストから、「サポートするオブジェクトのアップグレード」をクリックします。

6. 画面に表示されるステップに従います。

関連項目:

「アプリケーション、ページまたはコンポーネントのエクスポートのインポート」

23.5.7 サポートするオブジェクトの削除

カスタム・パッケージ・アプリケーションを作成またはインストールすると、次のいずれかの方法で削除できます。

- サポートするオブジェクト・ページで、「サポートされているオブジェクトの削除」をクリックします。

- アプリケーションのホームページで、「このアプリケーションの削除」をクリックします。

アプリケーションを削除する場合、現在のアプリケーション定義を削除して、サポートするオブジェクトに定義された削除スクリプトを実行するオプションがあります。

カスタム・パッケージ・アプリケーションを削除するには、次のステップを実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「サポートするオブジェクト」をクリックします。

サポートするオブジェクト・ページが表示されます。

4. 「タスク」リストから、「サポートされているオブジェクトの削除」をクリックします。

5. 削除オプションを次のように選択します。

- アプリケーション定義の削除: 現在のアプリケーション定義を削除します。

- データベース・オブジェクトの削除: このアプリケーションのデプロイ属性に定義された削除スクリプトを実行します。

6. 画面に表示されるステップに従います。

関連項目:

カスタム・パッケージ・アプリケーションの作成

23.5.8 インストール・サマリーの表示

サポートするオブジェクト・ページで、「タスク」リストの「インストール・サマリーの表示」をクリックすると、最近のインストール・ログおよび削除ログを表示できます。このログには、現在のApplication Expressセッション中に発生した最新のインストールまたは削除の結果のみ表示されることに注意してください。

インストール・サマリーを表示するには、次のステップを実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「サポートするオブジェクト」をクリックします。

サポートするオブジェクト・ページが表示されます。

4. ページの右側の「タスク」リストで、「インストール・サマリーの表示」をクリックします。

サマリー・ページが表示されます。

23.6 アプリケーションおよびアプリケーション・コンポーネントのエクスポート

開発者は、アプリケーションおよび関連ファイルを別のOracle Application Expressインスタンスにエクスポートできます。

ヒント:

開発者は、ダウンロードしたインストールzipファイルのUtilitiesフォルダにあるAPEXExportプログラムを使用して、コマンドラインからワークスペース、アプリケーションおよび関連ファイルをエクスポートすることもできます。Oracle Application Express管理ガイドを参照してください。

トピック:

- エクスポート・プロセスについて

- エクスポート・ページについて

- アプリケーションのエクスポート

- アプリケーション・コンポーネントのエクスポート

- ワークスペースのエクスポート

- アプリケーションのページのエクスポート

- Webシートのエクスポート

- 静的ファイルのエクスポートについて

- テーマのエクスポート

- プラグインのエクスポート

- ユーザー・インタフェースのデフォルト値のエクスポート

- チーム開発フィードバックのエクスポート

- スクリプト・リポジトリからのスクリプト・ファイルのエクスポート

23.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リリースにエクスポートすることはできません(たとえば、Application Expressリリース4.2からエクスポートしたアプリケーションを、Oracle Application Expressリリース4.1以前が実行されている環境にインポートすることはできません)。

アプリケーションのエクスポートには、アプリケーション定義、サポートするオブジェクトおよび共有コンポーネント(プラグイン、イメージ、CSSファイル、JavaScriptファイル、個別に管理する必要があるその他のファイルなど)が含まれます。完全なアプリケーションをエクスポートするかわりに、ページなどの特定のコンポーネントをエクスポートすることもできます。この場合も、SQLスクリプト・ファイルが作成されます。異なる環境にコンポーネントをインポートする場合は、制限があります。ベストプラクティスとして、個々のコンポーネントではなく完全なアプリケーションをエクスポートすることをお薦めします。エクスポートしようとするアプリケーションに、まだテストの準備が整っていないページなどのコンポーネントがある場合は、ビルド・オプションを使用して、各種のアプリケーション・コンポーネントを含めたり、除外することをお薦めします。

関連項目:

- 「アプリケーションのエクスポート」

- 「アプリケーション・コンポーネントのエクスポート」

- ビルド・オプションを使用した構成の制御

23.6.2 エクスポート・ページについて

アプリケーション定義およびすべての関連ファイルをエクスポートするには、エクスポート・ページの上部にある次のタブを使用します。「エクスポート」、「ワークスペース」、「アプリケーション」、「Webシート」、「テーマ」、「プラグイン」、「ユーザー・インタフェースのデフォルト値」および「フィードバック」。

ワークスペース・ユーザーを移行するか、ターゲット・インスタンス内で共有コンポーネント・サブスクリプションを複製する場合を除いて、ワークスペース全体をエクスポートする必要はありません。

アプリケーションとすべての関連ファイルをエクスポートしたら、それらをターゲットのOracle Application Expressインスタンスにインポートしてからインストールする必要があります。一般的に、常にアプリケーションをインポートしてから関連ファイルをインポートします。

ヒント:

カスタム・パッケージ・アプリケーションを作成すると、アプリケーションのデプロイに必要なステップを単純化できます。

関連項目:

- カスタム・パッケージ・アプリケーションの作成方法

- 別のインスタンスへのアプリケーションの移動方法

23.6.3 アプリケーションのエクスポート

アプリケーションのエクスポート時に、Oracle Application ExpressによってPL/SQL APIコールを含むテキスト・ファイルが生成されます。アプリケーションのエクスポートには、アプリケーション定義、サポートするオブジェクトおよび共有コンポーネント(プラグイン、イメージ、CSSファイル、JavaScriptファイル、個別に管理する必要があるその他のファイルなど)が含まれます。

アプリケーションをエクスポートするには、次のステップを実行します。

1. エクスポート・ページにナビゲートします。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーション・ビルダーのホームページで、「ワークスペース・ユーティリティ」をクリックします。

c. 「エクスポート」をクリックします。

2. 「アプリケーション」タブをクリックします。

3. 「アプリケーションの選択」で、エクスポートするアプリケーションを選択します。

4. 「アプリケーションのエクスポート」で、次のステップを実行します。

a. ファイル形式 - エクスポート・ファイルでの行の書式設定の方法を選択します。オプション:

- UNIX: 生成されるファイルには、改行で終了する行が含まれます。

- DOS: 生成されるファイルには、キャリッジ・リターンと改行で終了する行が含まれます。

- データベース: 生成されるファイルをダウンロードするかわりにエクスポート・リポジトリに保存します。

b. 所有者のオーバーライド - デフォルトでは、アプリケーションはアプリケーション属性の所有者で識別される所有者が所有します。この属性を使用するのは、このアプリケーションを、エクスポートするときとは異なるスキーマ所有者としてインポートする場合です。

c. ビルド・ステータスのオーバーライド - エクスポートしたアプリケーションのビルド・ステータスを選択します。オプションは次のとおりです。

- アプリケーションの実行のみ: ユーザーはアプリケーションの実行のみ可能です。このオプションの選択は、他の開発者がアプリケーションを変更できないようにするために効果的な方法です。

- アプリケーションの実行および構築: 開発者とユーザーのどちらもアプリケーションを実行および編集できます。

ヒント:

「アプリケーションの実行のみ」を選択した場合は、引数p_traceをYesに設定できません。アプリケーションのインポート後にこの設定を変更する方法は、Oracle Application Express管理サービスにログインする以外ありません。

d. デバッグ - オプション:

- はい - デバッグが有効な状態でアプリケーションがエクスポートされます。

- いいえ - デバッグが無効な状態でアプリケーションがエクスポートされます。

e. 現在から: 何分前まで遡ってエクスポートするかを指定します。このオプションを使用すると、削除されたオブジェクトを元に戻すなどのために、アプリケーションの前の時点に戻ることができます。

このユーティリティは、DBMS_FLASHBACKパッケージを使用します。システム変更番号(SCN)マッピングへのタイムスタンプが約5分ごとにリフレッシュされるため、検索しているバージョンの検出にはそれと同じ時間がかかる場合があります。元に戻す情報が保持される時間は、起動パラメータUNDO_RETENTION(デフォルトは3時間)に影響されます。ただし、このパラメータはUNDO表領域のサイズにのみ影響します。2つのデータベースに同じUNDO_RETENTIONパラメータが含まれている場合でも、トランザクション数が少ないデータベースでは、UNDO表領域が一杯ではなく、以前のデータが強制的にアーカイブされるため、より前の時点に戻ることができます。

5. 「プリファレンスのエクスポート」で、次のようにします。

a. サポートするオブジェクトの定義をエクスポート - アプリケーションとともにサポートするオブジェクトの定義をエクスポートするかどうかを指定します。

- はい: サポートするオブジェクトの定義をアプリケーションのエクスポートに含めます。コマンドラインから起動した場合、サポートするオブジェクトは自動的にロードされません。

- いいえ: サポートするオブジェクトの定義をエクスポートに含めません。

- インポート時に自動的にインストール: サポートするオブジェクトの定義とサポートするオブジェクトのインストールのコールをアプリケーションのエクスポートに含めます。このオプションは、コマンドライン・インストールの場合のみ有効です。アプリケーションをコマンドラインからインポートする場合、サポートするオブジェクトは自動的にインストールまたはアップグレードされます。

サポートするオブジェクトの定義にはすべての構成オプションとスクリプトが含まれ、アプリケーションのエクスポートにデータベース・オブジェクト定義、イメージ定義およびおよびシード・データSQL文を単一のファイルにカプセル化して含めることができます。

b. パブリック・レポートのエクスポート: アプリケーションにパブリック・レポートを含めるかどうかを指定します。パブリック・レポートは、ユーザーが対話モード・レポートまたは対話グリッドから保存した、パブリックで共有されるレポート設定です。

- はい: パブリック・レポートをアプリケーションのエクスポートに含めます。

- いいえ: パブリック・レポートをアプリケーションのエクスポートに含めません。

c. プライベート・レポートのエクスポート - アプリケーションにプライベート・レポートを含めるかどうかを指定します。プライベート・レポートは、ユーザーが対話モード・レポートまたは対話グリッドから保存した、カスタマイズされたプライベート設定です。

- はい: パブリック・レポートをアプリケーションのエクスポートに含めます。

- いいえ: パブリック・レポートをアプリケーションのエクスポートに含めません。

d. レポート・サブスクリプションのエクスポート - アプリケーションに対話モード・レポートまたは対話グリッドのサブスクリプション設定を含めるかどうかを指定します。このことは、アプリケーションのすべての対話モード・レポートまたは対話グリッドの、すべてのユーザーの期限が切れていないサブスクリプション設定に限定されます。

- はい: エクスポートするレポートのレポート・サブスクリプションをアプリケーションのエクスポートに含めます。

- いいえ: レポートのレポート・サブスクリプションをアプリケーションのエクスポートに含めません。

e. 開発者コメントのエクスポート - アプリケーションのエクスポートに開発者コメントを含めるかどうかを指定します。

- はい: 開発者コメントをアプリケーションのエクスポートに含めます。

- いいえ: 開発者コメントをアプリケーションのエクスポートに含めません。

f. 翻訳のエクスポート - アプリケーションのエクスポートに翻訳を含めるかどうかを指定します。

- はい: 翻訳マッピングおよび翻訳リポジトリのすべてのテキストを含めます。

- いいえ: 翻訳マッピングおよび翻訳リポジトリを含めません。

翻訳テキスト・メッセージおよび動的翻訳は、アプリケーションのエクスポートに常に含められます。

g. 元のIDでエクスポート - エクスポート・ファイルに現時点のアプリケーション・コンポーネントIDとこのアプリケーションの前回インポート時のアプリケーション・コンポーネントIDのどちらを含めるかを指定します。

- はい: 前回インポート時のIDを含めます。

- いいえ: コンポーネントの現在のIDを含めます。

6. 「エクスポート」をクリックします。

ヒント:

実際のアプリケーション・ファイルをエクスポートするのみでなく、カスケード・スタイルシート、イメージ、スクリプト・ファイルなど、その他の関連ファイルもエクスポートする必要がある場合があります。

関連項目:

- ビルド・オプションを使用した構成の制御

- 『Oracle Application Express管理ガイド』のデプロイ時のアプリケーションのビルド・ステータス・セットの変更に関する項

- 「エクスポート・ファイルのインポート」

- 『Oracle Application Express管理ガイド』のランタイム環境にエクスポートされたアプリケーションのインストールに関する項

23.6.4 アプリケーション・コンポーネントのエクスポート

コンポーネントのエクスポート・ウィザードを使用して、共有コンポーネントまたはページ・コンポーネントを別のアプリケーションまたはワークスペースにエクスポートしたり、編集前にコンポーネントをバックアップしたり、別のOracle Application Expressインスタンスに対するパッチとして機能するエクスポートを作成したりできます。

共有コンポーネントまたはページ・コンポーネントをエクスポートするには、次のステップを実行します。

1. コンポーネントのエクスポート・ページにナビゲートします。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. 「共有コンポーネント」をクリックします。

d. 「タスク」リストから「アプリケーション・コンポーネントのエクスポート」をクリックします。

「コンポーネントのエクスポート」ページが表示されます。

2. 次のタブをクリックして、エクスポートするコンポーネントを選択します。

- 「コンポーネント」には、共有アプリケーション・コンポーネントおよびページ全体が表示されます。ページ上部のナビゲーション・バーを使用してコンポーネントを検索します。

- 「ページ別のコンポーネント」には、選択したページのコンポーネントがリストされます。「ページ」リストから選択して特定のページにナビゲートします。

- 「ビルド・オプションのステータス」には、使用可能なビルド・オプションが表示されます。このページを使用してビルド・オプションを選択および選択解除します。

タブごとに適切なコンポーネントを選択し、「エクスポートに追加」をクリックします。

3. 「次へ」をクリックします。

4. 「コンポーネントのエクスポート」で、次のステップを実行します。

a. ファイル形式 - エクスポート・ファイルでの行の書式設定の方法を選択します。

- UNIX: 生成されるファイルには、改行で終了する行が含まれます。

- DOS: 生成されるファイルには、キャリッジ・リターンと改行で終了する行が含まれます。

b. 現在から: 何分前まで遡ってエクスポートするかを指定します。このオプションを使用すると、削除されたオブジェクトを元に戻すなどのために、アプリケーションの前の時点に戻ることができます。

このユーティリティは、DBMS_FLASHBACKパッケージを使用します。システム変更番号(SCN)マッピングへのタイムスタンプが約5分ごとにリフレッシュされるため、検索しているバージョンの検出にはそれと同じ時間がかかる場合があります。元に戻す情報が保持される時間は、起動パラメータUNDO_RETENTION(デフォルトは3時間)に影響されます。ただし、このパラメータはUNDO表領域のサイズにのみ影響します。2つのデータベースに同じUNDO_RETENTIONパラメータが含まれている場合でも、トランザクション数が少ないデータベースでは、UNDO表領域が一杯ではなく、以前のデータが強制的にアーカイブされるため、より前の時点に戻ることができます。

c. 「コンポーネントのエクスポート」をクリックします。

ヒント:

翻訳されたアプリケーションでは、「翻訳のエクスポート」フィールドが表示されます。プライマリ言語アプリケーションおよびすべての翻訳済アプリケーションの選択した共有コンポーネントをエクスポートするには、「翻訳のエクスポート」フィールドから、「はい」を選択します。テキスト文字列とマークアップを最新の状態にするには、翻訳済コンポーネントをエクスポートする前に翻訳済アプリケーションを同期化する必要があることに注意してください。

関連項目:

- 共有コンポーネントでの作業

- 「アプリケーション、ページまたはコンポーネントのエクスポートのインポート」

- 「ビルド・オプションまたはビルド・オプション・ステータスのエクスポート」

23.6.5 ワークスペースのエクスポート

ワークスペースをエクスポートすることによって、ワークスペースを別のOracle Application Expressインスタンスに移動したりコピーできます。ワークスペースをエクスポートすると、Oracle Application Expressは、ユーザー、定義されたユーザー・グループ、チーム開発データ、ワークスペース・アーティファクト(SQLスクリプト、SQLコマンドの履歴、保存されたSQL、ユーザー・プリファレンス、開発者のログイン履歴、電子メール・ログおよびユーザー・インタフェースのデフォルトなど)のASCIIテキストのSQLスクリプトを作成します。

ワークスペースをエクスポートするには、次のステップを実行します。

1. エクスポート・ページにナビゲートします。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーション・ビルダーのホームページで、「ワークスペース・ユーティリティ」をクリックします。

c. 「エクスポート」をクリックします。

2. エクスポート・ページで、「ワークスペース」タブをクリックします。

3. 「ワークスペースのエクスポート」で、次のようにします。

a. チーム開発を含める - 機能、マイルストン、To Do、バグ、フィードバック、リンク、ニュースなどのチーム開発データを含める場合は「はい」を設定します。このワークスペースのターゲット・インスタンスが実行時のみのインスタンスでない場合は、「はい」のみを選択します。そうではない場合、「いいえ」を選択します

b. エクスポート・タイプ - ほとんどの場合は、デフォルト値「最小」を変更しないでください。SQLスクリプト、SQLコマンドの履歴、保存されたSQL、ユーザー・プリファレンス、開発者のログイン履歴、電子メール・ログおよびユーザー・インタフェースのデフォルトを含め、すべてのワークスペース・アーティファクトを別のインスタンスに複製する場合にのみ、「完全」を選択します。

c. ファイル形式 - エクスポート・ファイルでの行の書式設定の方法を選択します。

- DOS: 生成されるファイルには、改行で終了する行が含まれます。

- UNIX: 生成されるファイルには、キャリッジ・リターンと改行で終了する行が含まれます。

d. ファイルの文字セット - エクスポート・ファイルは、指定した文字セットでエンコードされます。

4. 「エクスポート」をクリックします。

関連項目:

『Oracle Application Express管理ガイド』のApplication Expressユーザーの管理に関する項

23.6.6 アプリケーションのページのエクスポート

警告:

異なるシステム上の単一のページをエクスポートおよびインポートすることは高度なデプロイ手法であり、次の制限事項があります。

- 両方のシステムに同じアプリケーションIDとワークスペースIDが指定されている必要があります。

- 両方のシステムに共有コンポーネントの同じIDが指定されている必要があります。

- ページが新しい共有コンポーネントまたは更新された共有コンポーネントを参照する場合、それらの共有コンポーネントを最初にエクスポートおよびインポートする必要があります。

これらの制限事項が満たされない場合、インポートは失敗します。

アプリケーションのページをエクスポートするには、次のステップを実行します。

1. 該当するアプリケーション・ページにナビゲートします。

2. 「ユーティリティ」メニューをクリックし、「エクスポート」を選択します。

ページのエクスポート・ウィザードが表示されます。

3. 「ページ」で、エクスポートするページを識別します。一度のエクスポートに1つのページのみ選択できます。

4. 「ファイル形式」から、エクスポート・ファイルで行を書式設定する方法を選択します。オプションは次のとおりです。

- UNIX - 生成されるファイルには、改行で区切られた行が含まれます。

- DOS - 生成されるファイルには、キャリッジ・リターンと改行で区切られた行が含まれます。

5. 「現在から」には、何分前まで遡ってエクスポートするかを指定します。このオプションを使用すると、削除されたオブジェクトを元に戻すなどのために、アプリケーションの前の時点に戻ることができます。

このユーティリティは、DBMS_FLASHBACKパッケージを使用します。システム変更番号(SCN)マッピングへのタイムスタンプが約5分ごとにリフレッシュされるため、検索しているバージョンの検出にはそれと同じ時間がかかる場合があります。元に戻す情報が保持される時間は、起動パラメータUNDO_RETENTION(デフォルトは3時間)に影響されます。ただし、このパラメータはUNDO表領域のサイズにのみ影響します。2つのデータベースに同じUNDO_RETENTIONパラメータが含まれている場合でも、トランザクション数が少ないデータベースでは、UNDO表領域が一杯ではなく、以前のデータが強制的にアーカイブされるため、より前の時点に戻ることができます。

6. 「ページのエクスポート」をクリックします。

関連項目:

- 「ページ・デザイナでのページの表示」

- 「レガシー・コンポーネント・ビューでのページの表示」

- 「アプリケーション・コンポーネントのエクスポート」

- 「アプリケーションのエクスポート」

- 「アプリケーション、ページまたはコンポーネントのエクスポートのインポート」

23.6.7 Webシートのエクスポート

Webシートのエクスポート・ユーティリティを使用して、Webシート・アプリケーションを他のユーザーが使用できるようにします。

Webシート・アプリケーションをエクスポートするには、次のステップを実行します。

1. エクスポート・ページにナビゲートします。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーション・ビルダーのホームページで、「ワークスペース・ユーティリティ」をクリックします。

c. 「エクスポート」をクリックします。

2. エクスポート・ページで、「Webシート」タブをクリックします。

3. 「Webシートのエクスポート」で、次のようにします。

a. Webシート・アプリケーション - エクスポートするWebシートを選択します。

b. ファイル形式 - エクスポート・ファイルでの行の書式設定の方法を選択します。オプション:

- UNIX: 生成されるファイルには、改行で終了する行が含まれます。

- DOS: 生成されるファイルには、キャリッジ・リターンと改行で終了する行が含まれます。

c. プリファレンスのエクスポート - 適切なオプションを選択します。

d. 「エクスポート」をクリックします。

関連項目:

- Webシート・アプリケーションの作成

- 「Webシートのインポート」

23.6.8 静的ファイルのエクスポートについて

静的アプリケーション・ファイルおよび静的ワークスペース・ファイルをエクスポートするには、ZIPファイルを作成します。

関連項目:

- 「すべての静的アプリケーション・ファイルのZipでのダウンロード」

- 「すべての静的ワークスペース・ファイルのZipでのダウンロード」

23.6.9 テーマのエクスポート

テーマのエクスポート・ユーティリティを使用して、Oracle Application Expressの1つの開発インスタンスからファイルにテーマをエクスポートします。

アプリケーション・テーマをエクスポートするには、次のステップを実行します。

1. エクスポート・ページにナビゲートします。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーション・ビルダーのホームページで、「ワークスペース・ユーティリティ」をクリックします。

c. 「エクスポート」をクリックします。

2. 「テーマ」タブをクリックします。

3. 「テーマ」ページで、次のステップを実行します。

a. アプリケーション - アプリケーションを選択します。

b. テーマのエクスポート - - エクスポートするテーマを選択します。

c. ファイル形式 - エクスポート・ファイルでの行の書式設定の方法を選択します。オプションは次のとおりです。

- UNIX: 生成されるファイルには、改行で終了する行が含まれます。

- DOS: 生成されるファイルには、キャリッジ・リターンと改行で終了する行が含まれます。

d. 「エクスポート」をクリックします。

関連項目:

- 「テーマのインポート」

- テーマの使用

23.6.10 プラグインのエクスポート

プラグインのエクスポート・ユーティリティを使用して、Oracle Application Expressの1つの開発インスタンスからファイルにプラグインをエクスポートします。

エクスポート・ページからプラグインをエクスポートするには、次のステップを実行します。

1. エクスポート・ページにナビゲートします。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーション・ビルダーのホームページで、「ワークスペース・ユーティリティ」をクリックします。

c. 「エクスポート」をクリックします。

2. 「プラグイン」タブをクリックします。

3. 「プラグイン」ページで、次のステップを実行します。

a. アプリケーション - アプリケーションを選択します。

b. プラグイン - エクスポートするプラグインを選択します。

c. ファイル形式 - エクスポート・ファイルでの行の書式設定の方法を選択します。オプションは次のとおりです。

- UNIX - 生成されるファイルには、改行で区切られた行が含まれます。

- DOS - 生成されるファイルには、キャリッジ・リターンと改行で区切られた行が含まれます。

d. 「エクスポート」をクリックします。

関連項目:

プラグインのインポート

23.6.11 ユーザー・インタフェースのデフォルト値のエクスポート

この項では、ユーザー・インタフェースのデフォルト値をエクスポートする方法について説明します。

トピック:

- ユーザー・インタフェースのデフォルト値のエクスポートについて

- エクスポート・ページからのユーザー・インタフェースのデフォルト値のエクスポート

- ユーザー・インタフェースのデフォルト値ページからのユーザー・インタフェースのデフォルト値のエクスポート

23.6.11.1 ユーザー・インタフェースのデフォルト値のエクスポートについて

ユーザー・インタフェースのデフォルト値のエクスポートは、ターゲット・システムでの開発を予定している場合に便利です。ユーザー・インタフェースのデフォルト値は、表ディクショナリと属性ディクショナリの2つのカテゴリに分かれています。

- 表ディクショナリは、選択されたスキーマ内の表および列に固有です。これらのデフォルト値は、属性ディクショナリに定義されている値に優先して使用されます。

- 属性ディクショナリは、フォームとレポートの作成に使用する列についての属性のセットを含みます。定義は列名によって照合され、シノニムを使用することで特定の定義を複数の列間で共有できます。

ユーザー・インタフェースのデフォルト値をエクスポートする場合は、選択したディクショナリとスキーマに対するすべてのユーザー・インタフェースのデフォルト値が、1つのSQLコマンド・スクリプトにエクスポートされます。プロンプトが表示されたら、このファイルをハードディスク・ドライブに保存してください。このファイルには、アプリケーションのPL/SQL APIをコールして表のヒントを作成するAPIコールが含まれています。このファイルを使用して、ユーザー・インタフェースのデフォルト値を別のデータベースおよびOracle Application Expressインスタンスにインポートできます。

関連項目:

- 「ユーザー・インタフェースのデフォルト値のインポート」

- Oracle Application Express SQLワークショップ・ガイドのユーザー・インタフェースのデフォルト値の管理

23.6.11.2 エクスポート・ページからのユーザー・インタフェースのデフォルト値のエクスポート

エクスポート・ページからユーザー・インタフェースのデフォルト値をエクスポートするには、次のステップを実行します。

1. エクスポート・ページにナビゲートします。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーション・ビルダーのホームページで、「ワークスペース・ユーティリティ」をクリックします。

c. 「エクスポート」をクリックします。

2. 「ユーザー・インタフェースのデフォルト値」タブをクリックします。

3. 表ディクショナリ・ページで、次のステップを実行します。

a. スキーマ - ユーザー・インタフェースのデフォルト値に関連付けられた表を所有するスキーマを選択します。

b. ファイル形式 - エクスポート・ファイルでの行の書式設定の方法を選択します。オプションは次のとおりです。

- UNIX: 生成されるファイルには、改行で終了する行が含まれます。

- DOS: 生成されるファイルには、キャリッジ・リターンと改行で終了する行が含まれます。

c. 「エクスポート」をクリックします。

4. 属性ディクショナリ・ページで、次のステップを実行します。

a. ファイル形式 - エクスポート・ファイルでの行の書式設定の方法を選択します。オプションは次のとおりです。

- UNIX - 生成されるファイルには、改行で区切られた行が含まれます。

- DOS - 生成されるファイルには、キャリッジ・リターンと改行で区切られた行が含まれます。

b. 「エクスポート」をクリックします。

23.6.11.3 ユーザー・インタフェースのデフォルト値ページからのユーザー・インタフェースのデフォルト値のエクスポート

ユーザー・インタフェースのデフォルト値ページからユーザー・インタフェースのデフォルト値をエクスポートするには、次のステップを実行します。

1. ワークスペースホームページで、「SQLワークショップ」アイコンをクリックします。

2. 「ユーティリティ」をクリックします。

3. 「ユーザー・インタフェースのデフォルト値」をクリックします。

ユーザー・インタフェースのデフォルト値ページが表示されます。

4. ディクショナリを選択します。

- 表ディクショナリ - 選択されたスキーマ内の特定の表および列をエクスポートします。

- 属性ディクショナリ - フォームとレポートを作成するために使用する列属性のセットをエクスポートします。

5. 「タスク」で、「エクスポート」をクリックします。

6. 「ファイル形式」で、オプションを選択します。

- UNIX - 生成されるファイルには、改行で区切られた行が含まれます。

- DOS - 生成されるファイルには、キャリッジ・リターンと改行で区切られた行が含まれます。

- データベース - ダウンロードするファイルを生成するかわりにファイル・リポジトリにエクスポートします。

7. 「エクスポート」をクリックします。

23.6.12 チーム開発フィードバックのエクスポート

フィードバックのエクスポート・ユーティリティを使用して、本番またはテスト・システムからのフィードバックを開発システムと同期します。開発システムは、ワークスペース情報の編集ページで設定されるワークスペース設定の「フィードバック同期のソース識別子」を使用することによって識別されます。開発システムからエクスポートする場合、エクスポート・プロセスには「デプロイメント・システム」という追加属性があり、更新されたフィードバックを同期するデプロイメント・システム(本番またはテスト)は、この属性で指定します。

チーム開発フィードバックをエクスポートするには、次のステップを実行します。

1. エクスポート・ページにナビゲートします。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーション・ビルダーのホームページで、「ワークスペース・ユーティリティ」をクリックします。

c. 「エクスポート」をクリックします。

2. 「フィードバック」タブをクリックします。

3. フィードバック・ページで、次のステップを実行します。

a. 変更時期 - エクスポートする最も古いフィードバックの日付を選択します。この選択された日付から現在の日付までのすべてのフィードバックがエクスポートされます。

b. ファイル形式 - エクスポート・ファイルでの行の書式設定の方法を選択します。オプションは次のとおりです。

- UNIX - 生成されるファイルには、改行で区切られた行が含まれます。

- DOS - 生成されるファイルには、キャリッジ・リターンと改行で区切られた行が含まれます。

c. 「エクスポート」をクリックします。

関連項目:

チーム開発フィードバックのインポート

23.6.13 スクリプト・リポジトリからのスクリプト・ファイルのエクスポート

エクスポートおよびインポート・タスクを使用して、選択したスクリプトを現行のスクリプト・リポジトリから別のワークスペース内のスクリプト・リポジトリに送信できます。

スクリプト・ファイルをエクスポートするには、次のステップを実行します。

1. ワークスペースホームページで、「SQLワークショップ」アイコンをクリックします。

2. 「SQLスクリプト」をクリックします。

3. 「タスク」リストで、「エクスポート」をクリックします。

4. 適切なスクリプト・ファイルを選択し、「エクスポートに追加」をクリックします。

5. ファイル名を確認し、「すべてのエクスポート」をクリックします。

スクリプトを削除するには、「削除」チェック・ボックスを選択します。

関連項目:

Oracle Application Express SQLワークショップ・ガイドの「SQLスクリプトの使用」

23.7 エクスポート・ファイルのインポート

アプリケーションとすべての関連ファイルをエクスポートしたら、それらをターゲットのOracle Application Expressインスタンスにインポートしてからインストールする必要があります。特定のリリースで作成されたアプリケーションを以前のバージョンにインポートすることはできません。一般的に、常にアプリケーションをインポートしてから関連ファイルをインポートします。

ヒント:

カスタム・パッケージ・アプリケーションを作成すると、アプリケーションのデプロイに必要なステップを単純化できます。

トピック:

- アプリケーション、ページまたはコンポーネントのエクスポートのインポート

- アプリケーション・グループのインポートについて

- Webシートのインポート

- プラグインのインポート

- テーマのインポート

- ユーザー・インタフェースのデフォルト値のインポート

- チーム開発フィードバックのインポート

関連項目:

- カスタム・パッケージ・アプリケーションの作成方法

- 別のインスタンスへのアプリケーションの移動方法

23.7.1 アプリケーション、ページまたはコンポーネントのエクスポートのインポート

アプリケーション、ページまたはコンポーネントのエクスポートをターゲットのOracle Application Expressインスタンスにインポートするには、次のステップを実行します。

1. 次のように、インポート・ページにナビゲートします。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーション・ビルダーのホームページで、「インポート」をクリックします。

2. 「インポート」で、次のステップを実行します。

a. インポート・ファイル - ファイルにナビゲートします。

b. ファイル・タイプ - 「アプリケーション、ページまたはコンポーネントのエクスポート」を選択します。

c. ファイルのキャラクタ・セットが正しいことを確認します。

d. 「次へ」をクリックします。

ファイルをインポートすると、ファイルをインストールするオプションが含まれています。

3. ファイルをインストールするには、「次へ」をクリックします。

アプリケーションのインストール・ウィザードが表示されます。

4. インストール・ウィザードで、次のステップを実行します。

a. 解析対象スキーマ - スキーマを選択します。

このスキーマに対して、すべてのアプリケーションのSQLおよびPL/SQLが解析されます。

b. ビルド・ステータス - 次のいずれかの項目を選択します。

- アプリケーションの実行のみ: ユーザーはアプリケーションの実行のみ可能です。

- アプリケーションの実行および構築: ユーザーはアプリケーションの実行を、開発者はアプリケーションの実行および編集を行うことができます。

「アプリケーションの実行のみ」の選択は、他の開発者がアプリケーションを変更できないようにするために効果的な方法です。

ヒント:

「アプリケーションの実行のみ」を選択する場合、アプリケーションのインポート後にこの設定を変更する方法は、Oracle Application Express管理サービスにログインする以外ありません。

c. 次のアプリケーションとしてインストール - 次のいずれかの項目を選択します。

- 新しいアプリケーションIDを自動割当て

- エクスポート・ファイルからアプリケーションIDを再利用

- アプリケーションIDの変更

これらのオプションは、アプリケーションIDの競合を回避するために使用します。これらのオプションは、同じインスタンスに同じアプリケーションの2つのバージョンをインストールする場合に役立ちます。たとえば、アプリケーションを本番インスタンスに移行した後も、開発バージョンを保持する必要がある場合があります。

d. 「アプリケーションのインストール」をクリックします。

関連項目:

- 『Oracle Application Express管理ガイド』のデプロイ時のアプリケーションのビルド・ステータス・セットの変更に関する項

- カスタム・パッケージ・アプリケーションの作成方法

23.7.2 アプリケーション・グループのインポートについて

アプリケーション・グループはアプリケーションとともにエクスポートされます。アプリケーションのエクスポートには、グループID、名前およびコメントが含まれます。アプリケーションをインポートするときは、次のルールに従ってアプリケーションのインポートが行われます。

- インポートの際、アプリケーションはIDが一致すれば既存のグループを使用します。

- ターゲット・システム上に同じIDを持つアプリケーション・グループが存在しない場合は、アプリケーションのインポートで同じ名前を持つ別のグループIDが検索されます。名前の一致が検出されたら、このアプリケーション・グループ名に応じたIDを使用してアプリケーションがインポートされます。

- ターゲット・システムの既存のアプリケーション・グループとIDも名前も一致しない場合、新しいアプリケーション・グループが作成されます。新しいアプリケーション・グループは、IDがOracle Application Expressインスタンスで使用されていない場合、そのアプリケーション・グループIDを使用します。グループIDが使用されている場合、新しいIDが生成されます。

23.7.3 Webシートのインポート

WebシートをターゲットのOracle Application Expressインスタンスにインポートするには、次のステップを実行します。

1. 次のように、インポート・ページにナビゲートします。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーション・ビルダーのホームページで、「インポート」をクリックします。

2. 「ファイルの指定」で、次のステップを実行します。

a. インポート・ファイル - ファイルにナビゲートします。

b. ファイル・タイプ - 「Webシート・アプリケーションのエクスポート」を選択します。

c. 「次へ」をクリックします。

ファイルをインポートすると、ファイルをインストールするオプションが含まれています。

3. インポートしたファイルをインストールするには、「次へ」をクリックします。

アプリケーションのインストール・ウィザードが表示されます。

4. アプリケーションのインストール・ウィザードで、次のステップを実行します。

a. 次のアプリケーションとしてインストール - 次のいずれかの項目を選択します。

- 新しいアプリケーションIDを自動割当て

- エクスポート・ファイルからアプリケーションIDを再利用

- アプリケーションIDの変更

これらのオプションは、アプリケーションIDの競合を回避するために使用します。これらのオプションは、同じインスタンスに同じアプリケーションの2つのバージョンをインストールする場合に役立ちます。たとえば、アプリケーションを本番インスタンスに移行した後も、開発バージョンを保持する必要がある場合があります。

b. 「インストール」をクリックします。

関連項目:

Webシート・アプリケーションの作成

23.7.4 プラグインのインポート

エクスポートしたプラグイン・ファイルをインポートするには、次のステップを実行します。

1. 次のように、インポート・ページにナビゲートします。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーション・ビルダーのホームページで、「インポート」をクリックします。

2. 「ファイルの指定」で、次のステップを実行します。

a. インポート・ファイル - ファイルにナビゲートします。

b. ファイル・タイプ - 「プラグイン」を選択します。

c. ファイルのキャラクタ・セットが正しいことを確認します。

d. 「次へ」をクリックします。

ファイルをインポートすると、ファイルをインストールするオプションが含まれています。

3. インポートしたファイルをインストールするには、「次へ」をクリックします。

4. 「プラグインのインストール」をクリックします。

注意:

同じ名前のプラグインが存在する場合、既存のプラグインを上書きする権限を要求するダイアログが表示されます。

23.7.5 テーマのインポート

アプリケーションをターゲットのOracle Application Expressインスタンスにインポートした後に、すべての関連ファイルをインポートする必要があります。

テーマのエクスポート・ファイルをインポートするには、次のステップを実行します。

1. 次のように、インポート・ページにナビゲートします。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーション・ビルダーのホームページで、「インポート」をクリックします。

2. 「定義のインポート」で、次の内容を選択します。

a. インポート・ファイル - ファイルにナビゲートします。

b. ファイル・タイプ - 「エクスポート済のテーマ」を選択します。

c. ファイルのキャラクタ・セット - ファイルのキャラクタ・セットが正しいことを確認します。

d. 「次へ」をクリックします。

ファイルをインポートすると、ファイルをインストールするオプションが含まれています。

3. インポートしたファイルをインストールするには、「次へ」をクリックします。

4. 「テーマのインストール」をクリックします。

関連項目:

- テーマの使用

- 「テーマのエクスポート」

23.7.6 ユーザー・インタフェースのデフォルト値のインポート

ユーザー・インタフェースのデフォルト値を使用して、指定したスキーマ内の表、列またはビューにデフォルトのユーザー・インタフェースのプロパティを割り当てることができます。

アプリケーションをターゲットのOracle Application Expressインスタンスにインポートした後に、すべての関連ファイルをインポートする必要があります。

ユーザー・インタフェースのデフォルト値をインポートするには、次のステップを実行します。

1. 次のように、インポート・ページにナビゲートします。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーション・ビルダーのホームページで、「インポート」をクリックします。

2. アプリケーションを選択します。

3. 「定義のインポート」で、次のステップを実行します。

a. インポート・ファイル - ファイルにナビゲートします。

b. ファイル・タイプ - 「ユーザー・インタフェースのデフォルト値」を選択します。

c. ファイルのキャラクタ・セット - ファイルのキャラクタ・セットが正しいことを確認します。

d. 「次へ」をクリックします。

ファイルをインポートすると、ファイルをインストールするオプションが含まれています。

4. インポートしたファイルをインストールするには、「次へ」をクリックします。

5. 「ユーザー・インタフェースのデフォルト値のインストール」をクリックします。

関連項目:

- Oracle Application Express SQLワークショップ・ガイドのユーザー・インタフェースのデフォルト値の管理

- 「ユーザー・インタフェースのデフォルト値のエクスポート」

23.7.7 チーム開発フィードバックのインポート

チーム開発フィードバックをインポートするには、次のステップを実行します。

1. 次のように、インポート・ページにナビゲートします。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーション・ビルダーのホームページで、「インポート」をクリックします。

2. 「フィードバック」を選択します。

3. 「ファイルのキャラクタ・セット」で、ファイルのキャラクタ・セットが正しいことを確認して、「次へ」をクリックします。

ファイルをインポートすると、ファイルをインストールするオプションが含まれています。

4. インポートしたファイルをインストールするには、「次へ」をクリックします。

5. 「フィードバックのインストール」をクリックします。

23.8 エクスポート・ファイルのインストール

この項では、エクスポート・ファイルをインストールする方法について説明します。

トピック:

- エクスポート・ファイルのインストールについて

- エクスポート・リポジトリへのアクセス

- エクスポート・リポジトリからのアプリケーション・エクスポートのインストール

- エクスポート・リポジトリからのその他ファイルのインストール

- エクスポート・リポジトリからのファイルの削除

- SQL*Plusからのエクスポート・ファイルのインストール

- SQL*Plusを使用したエクスポート・ファイルのインストール

23.8.1 エクスポート・ファイルのインストールについて

アプリケーションおよびすべての関連ファイルをターゲットのOracle Application Expressインスタンスにインポートすると、ファイルはエクスポート・リポジトリに格納されます。次に、そのファイルをインストールする必要があります。

次のようにエクスポート・ファイルをインストールできます。

- エクスポート・ファイルをインポートしたら、「インストール」ボタンをクリックして、画面に表示されるステップに従います。

- エクスポート・ファイルをアプリケーション・ビルダーにインポートした後、エクスポート・リポジトリからファイルをインストールします。

- エクスポート・ファイルをSQL*Plusからインストールします。

ヒント:

カスタム・パッケージ・アプリケーションを作成すると、アプリケーションのデプロイに必要なステップを単純化できます。

関連項目:

- カスタム・パッケージ・アプリケーションの作成方法

- 「エクスポート・ファイルの管理」

- 『Oracle Application Express管理ガイド』のランタイム環境にエクスポートされたアプリケーションのインストールに関する項

23.8.2 エクスポート・リポジトリへのアクセス

アプリケーションおよびすべての関連ファイルをターゲットのOracle Application Expressインスタンスにインポートすると、ファイルはエクスポート・リポジトリに格納されます。エクスポート・リポジトリを使用して、アーカイブされたアプリケーション・エクスポート、インポートおよびその他のファイルを管理できます。

エクスポート・リポジトリにアクセスするには、次のステップを実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. アプリケーション・ビルダーのホームページで、「ユーティリティ」をクリックします。

4. 「エクスポート・リポジトリ」をクリックします。

「エクスポート・リポジトリ」が表示されます。

23.8.3 エクスポート・リポジトリからのアプリケーション・エクスポートのインストール

Oracle Application Expressインスタンスにアプリケーション・エクスポートをインポートした後に、そのファイルがアプリケーション・ビルダーでアクティブまたは使用可能になる前にインストールする必要があります。

エクスポート・リポジトリからアプリケーション・エクスポートをインストールするには、次のステップを実行します。

1. エクスポート・リポジトリにナビゲートします。

2. アプリケーション・エクスポートを選択して、「アクション」列で「インストール」をクリックします。

3. 次を指定します。

a. 解析対象スキーマ - スキーマを選択します。

このスキーマに対して、すべてのアプリケーションのSQLおよびPL/SQLが解析されます。

b. ビルド・ステータス - 次のいずれかの項目を選択します。

- アプリケーションの実行のみ

- アプリケーションの実行および構築

ターゲット・インスタンスでアプリケーションを実行し、開発者がアクセスできないようにするには、「Run Application Only」を選択します。

ヒント:

「アプリケーションの実行のみ」を選択する場合、アプリケーションのインポート後にこの設定を変更する方法は、Oracle Application Express管理サービスにログインする以外ありません。

c. 次のアプリケーションとしてインストール - 次のいずれかの項目を選択します。

- 新しいアプリケーションIDを自動割当て

- エクスポート・ファイルからアプリケーションIDを再利用

- アプリケーションIDの変更

これらのオプションは、アプリケーションIDの競合を回避するために使用します。これらのオプションは、同じインスタンスに同じアプリケーションの2つのバージョンをインストールする必要がある場合に使用します。たとえば、アプリケーションを本番インスタンスに移行した後も、開発バージョンを保持する必要がある場合があります。

d. 「インストール」をクリックします。

ヒント:

カスタム・パッケージ・アプリケーションをインストールしている場合、インストーラはカスタム・パッケージ・インストール・スクリプトをインストールするよう要求します。画面に表示されるステップに従います。

関連項目:

- 「エクスポート・リポジトリへのアクセス」

- 『Oracle Application Express管理ガイド』のデプロイ時のアプリケーションのビルド・ステータス・セットの変更に関する項

- カスタム・パッケージ・アプリケーションの作成方法

23.8.4 エクスポート・リポジトリからのその他ファイルのインストール

Oracle Application Expressインスタンスにファイルをインポートした後、そのファイルがアプリケーション・ビルダーでアクティブまたは使用可能になる前にインストールする必要があります。

エクスポート・リポジトリに格納されたファイルをインストールするには、次のステップを実行します。

1. エクスポート・リポジトリにナビゲートします。

2. インストールするファイルを選択して、「アクション」列で「インストール」をクリックします。

3. 画面に表示されるステップに従います。

関連項目:

「エクスポート・リポジトリへのアクセス」

23.8.5 エクスポート・リポジトリからのファイルの削除

エクスポート・リポジトリからファイルを削除できます。

エクスポート・リポジトリからファイルを削除するには、次のステップを実行します。

1. エクスポート・リポジトリにナビゲートします。

2. 削除するファイルを選択し、「チェックした項目の削除」をクリックします。

関連項目:

「エクスポート・リポジトリへのアクセス」

23.8.6 SQL*Plusからのエクスポート・ファイルのインストール

エクスポート・ファイルはSQL*Plusからもインストールできます。エクスポート・ファイルは、インストール先と同じユーザー・データベース・アカウントで作成されている必要があります。

エクスポート・ファイルには次の制限が適用されます。

- エクスポート・ファイルがデータベース・アプリケーションの場合は、アプリケーションIDが上書きされます。そのため、ターゲットワークスペースは、インストールするアプリケーションのIDを所有している必要があります。

- エクスポート・ファイルがWebシート・アプリケーションの場合、ターゲット・ワークスペースにWebシート・データベース・オブジェクト設定が存在する必要があります。

- エクスポート・ファイルがWebシート・アプリケーションの場合、エクスポート・ファイルはWebシート・スキーマを使用してターゲット・ワークスペースにインストールする必要があります。

- エクスポート・ファイルがWebシート・アプリケーションの場合は、アプリケーションIDが上書きされます。

23.8.7 SQL*Plusを使用したエクスポート・ファイルのインストール

Oracle Application Expressエクスポート・ファイルをSQL*Plusからインストールするには、次のステップを実行します。

1. SQL*Plusへのログイン

2. エクスポート・ファイルを実行します。

たとえば、エクスポート・ファイルの名前がデフォルトでf144.sqlの場合は、コマンド・プロンプトで@f144と入力します。

23.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を実行しようとすると、エラーが表示されます。

関連項目:

アプリケーション定義の編集ページへのアクセス

23.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を実行しようとすると、エラーが表示されます。

23.11 ビルド・オプションを使用した構成の制御

ビルド・オプションを使用すると、アプリケーションで特定の機能を条件付きで表示できます。

ビルド・オプションは、INCLUDEおよびEXCLUDEという2つの値をとることができます。属性を含めように指定すると、Application Expressエンジンは、実行時にその属性をアプリケーション定義の一部とみなします。逆に、属性を除外するように指定すると、Application Expressエンジンは、その属性を存在しないものとして処理します。

トピック:

- ビルド・オプションの作成

- ビルド・オプションの管理

- ビルド・オプションの選択

- ビルド・オプションまたはビルド・オプション・ステータスのエクスポート

- ビルド・オプションの使用状況レポートの表示

関連項目:

Oracle Application Express APIリファレンスの「APEX_UTIL」のGET_BUILD_OPTION_STATUSおよびSET_BUILD_OPTION_STATUSプロシージャ

23.11.1 ビルド・オプションの作成

ビルド・オプション・ページのアプリケーションに対してビルド・オプションを作成します。

ビルド・オプションを作成するには、次のステップを実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

4. 「セキュリティ」で、「ビルド・オプション」をクリックします。

5. 新しいビルド・オプションを作成するには、「作成」をクリックします。

6. 画面に表示されるステップに従います。

23.11.2 ビルド・オプションの管理

ビルド・オプションは、INCLUDEおよびEXCLUDEという2つの値をとることができます。属性を含めように指定すると、Application Expressエンジンは、実行時にその属性をアプリケーション定義の一部とみなします。逆に、属性を除外するように指定すると、Application Expressエンジンは、その属性を存在しないものとして処理します。

ビルド・オプションを含めるまたは除外するには、次のステップを実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

4. 「セキュリティ」で、「ビルド・オプション」をクリックします。

ビルド・オプション・ページが表示されます。

5. ビルド・オプション名を選択します。

ビルド・オプションの作成/編集ページが表示されます。

6. 「ステータス」で、「INCLUDE」または「EXCLUDE」のいずれかを選択します。

23.11.3 ビルド・オプションの選択

ビルド・オプションを作成すると、ページ、コンポーネント(レポート、グラフまたはフォーム)、特定のページ・コントロール(ボタン・アイテム、LOV)、および別の共有コンポーネント(ブレッドクラム、リストまたはタブ)に対して選択できます。適切な属性ページに移動して、ビルド・オプションをページ、コンポーネント、ページ・コントロールまたは共有コンポーネントに適用します。ほとんどの属性ページには、定義済のビルド・オプションを選択できる「構成」セクションがあります。

関連項目:

レガシー・コンポーネント・ビューでのページ属性へのアクセス

23.11.4 ビルド・オプションまたはビルド・オプション・ステータスのエクスポート

コンポーネントのエクスポート・ページで、ビルド・オプションまたはビルド・オプション・ステータスをエクスポートできます。ビルド・オプション・ステータスのエクスポートは、別の環境内でビルド・オプションをオンまたはオフに切り替えるために効果的な方法です。たとえば、この機能を使用して、EXCLUDEのステータスを持つビルド・オプションと隠し機能のあるコンポーネントを関連付けることによって、隠し機能を備えた本番アプリケーションをデプロイできます。デプロイ後、ビルド・オプションのステータスをINCLUDEに変更して、ビルド・オプション・ステータスをエクスポートすると隠し機能を有効化できます。

ビルド・オプション・ステータスを本番インスタンスに適用すると、新しい機能が表示されます。

ビルド・オプションまたはビルド・オプション・ステータスをエクスポートするには、次のステップを実行します。

1. コンポーネントのエクスポート・ページにナビゲートします。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. 「共有コンポーネント」をクリックします。

d. 「タスク」リストから「アプリケーション・コンポーネントのエクスポート」をクリックします。

「コンポーネントのエクスポート」ページが表示されます。

2. エクスポートするビルド・オプションを次のように選択します。

a. 「ビルド・オプションのステータス」タブをクリックして、エクスポートするビルド・オプションを選択します。

b. 「エクスポートに追加」をクリックします。

3. 「次へ」をクリックします。

4. 「コンポーネントのエクスポート」で、次のステップを実行します。

a. ファイル形式 - エクスポート・ファイルでの行の書式設定の方法を選択します。

- UNIX - 生成されるファイルには、改行で区切られた行が含まれます。

- DOS - 生成されるファイルには、キャリッジ・リターンと改行で区切られた行が含まれます。

b. 現在から: 何分前まで遡ってエクスポートするかを指定します。このオプションを使用すると、削除されたオブジェクトを元に戻すなどのために、アプリケーションの前の時点に戻ることができます。

このユーティリティは、DBMS_FLASHBACKパッケージを使用します。システム変更番号(SCN)マッピングへのタイムスタンプが約5分ごとにリフレッシュされるため、検索しているバージョンの検出にはそれと同じ時間がかかる場合があります。元に戻す情報が保持される時間は、起動パラメータUNDO_RETENTION(デフォルトは3時間)に影響されます。ただし、このパラメータはUNDO表領域のサイズにのみ影響します。2つのデータベースに同じUNDO_RETENTIONパラメータが含まれている場合でも、トランザクション数が少ないデータベースでは、UNDO表領域が一杯ではなく、以前のデータが強制的にアーカイブされるため、より前の時点に戻ることができます。

c. 「コンポーネントのエクスポート」をクリックします。

ヒント:

翻訳されたアプリケーションでは、「翻訳のエクスポート」フィールドが表示されます。プライマリ言語アプリケーションおよびすべての翻訳済アプリケーションの選択した共有コンポーネントをエクスポートするには、「翻訳のエクスポート」フィールドから、「はい」を選択します。テキスト文字列とマークアップを最新の状態にするには、翻訳済コンポーネントをエクスポートする前に翻訳済アプリケーションを同期化する必要があることに注意してください。

関連項目:

- カスタム・パッケージ・アプリケーションの作成方法

- 「アプリケーション・コンポーネントのエクスポート」

23.11.5 ビルド・オプションの使用状況レポートの表示

ビルド・オプションを作成すると、ビルド・オプション・ページに「使用状況」タブが表示されます。このレポートには、カレント・アプリケーションでのビルド・オプションの使用状況が詳述されます。

注意:

「使用状況」タブは、ビルド・オプションを作成した後のビルド・オプション・ページにのみ表示されます。

ビルド・オプションの使用状況レポートを表示するには、次のステップを実行します。

1. 「ビルド・オプション」ページにナビゲートします。

a. 「ワークスペース」ホームページにナビゲートします。

b. 「アプリケーション・ビルダー」アイコンをクリックします。

c. アプリケーションを選択します。

d. 「共有コンポーネント」をクリックします。

e. 「セキュリティ」で、「ビルド・オプション」をクリックします。

ビルド・オプション・ページが表示されます。

2. ビルド・オプション・ページで、「使用状況」をクリックします。

ビルド・オプションの使用状況レポートが表示されます。

3. ビルド・オプションを選択して、「実行」をクリックします。

24 アプリケーション・レガシー・コンポーネントの管理

レガシー・アプリケーション・コンポーネントは、引き続きOracleでサポートされますが、使用することはお薦めしません。

トピック:

- レガシー・コンポーネント・ビューでのページの管理

- レガシー・チャートの管理

- レガシー・マスター・ディテール・フォームの作成

- レガシー表形式フォームの管理

- レガシー・カレンダの管理

- ギャラリでのレガシー・コンポーネントの表示

24.1 レガシー・コンポーネント・ビューでのページの管理

重要:

レガシー・コンポーネント・ビューはデフォルトで無効化されています。レガシー・コンポーネント・ビューを有効化するには、ユーザー・プリファレンスを編集して、「レガシー・コンポーネント・ビューの有効化」を「はい」に設定します。ユーザー・プリファレンスの編集を参照してください。

レガシー・コンポーネント・ビューは、アプリケーション・ページを編集するためのレガシー・ユーザー・インタフェースです。開発者はレガシー・コンポーネント・ビューではなくページ・デザイナを使用することをお薦めします。ページ・デザイナとは異なり、レガシー・コンポーネント・ビューでは、ページを視覚的に表したり、ページ・コンポーネントをドラッグ・アンド・ドロップすることができません。ページ上のコンポーネントの位置をプレビューするには、ページを実行する必要があります。また、対話グリッドやOracle JETベースのチャートなど一部のアプリケーション・コンポーネントは、レガシー・コンポーネント・ビューを使用して編集または管理できません。

ヒント:

ページ・デザイナへの移行で開発者を支援するために、ページ・デザイナには「コンポーネント・ビュー」タブが含まれています。レガシー・コンポーネント・ビューの外観と同様、ページ・デザイナの「コンポーネント・ビュー」タブには、ユーザー・インタフェース要素とアプリケーション・ロジックがコンポーネント・タイプ別に表示されます。ただし、コンポーネントをクリックすると、プロパティ・エディタの右ペインで対応する属性がハイライトされます。「コンポーネント・ビュー」タブを参照してください。

トピック:

- レガシー・コンポーネント・ビュー・ウィンドウ

- ページ・デザイナからレガシー・コンポーネント・ビューへの切替え

- レガシー・コンポーネント・ビューのUI要素の理解

- レガシー・コンポーネント・ビューの使用

- レガシー・コンポーネント・ビューでのページ属性へのアクセス

- レガシー・コンポーネント・ビューでのページの実行

- 実行時開発者ツールバー

- レガシー・コンポーネント・ビューでのデータベース・アプリケーション・ページのコピー

- レガシー・コンポーネント・ビューでのページの削除

関連項目:

レガシー・コンポーネント・ビューからページ・デザイナへの切替え

24.1.1 レガシー・コンポーネント・ビュー・ウィンドウ

レガシー・コンポーネント・ビューは、アプリケーション・ビルダーでページを編集するための従来のユーザー・インタフェースです。コンポーネント・ビューは、ユーザー・インタフェース要素とアプリケーション・ロジックをコンポーネント・タイプ別にグループ化します。コンポーネントを編集するには、コンポーネント名をドリルダウンするか、アイコンをクリックします。ページ・デザイナとは異なり、コンポーネント・ビューでは、ページを視覚的に表したり、ページ・コンポーネントをドラッグ・アンド・ドロップすることができません。ページ上のコンポーネントの位置をプレビューするには、ページを実行する必要があります。

レガシー・コンポーネント・ビュー・ウィンドウは、次のセクションに分かれています。

- ページ・レンダリング.ページ・レンダリングとは、データベースからページを生成するプロセスです。「ページ・レンダリング」セクションを使用して、ページ属性、リージョン、ボタン、アイテム、ページ・レンダリングの計算、およびページ・プロセスを含むページのレンダリングに影響するコントロールを変更できます。

- ページ・プロセス.ページ・プロセスは、ページを送信するプロセスです。通常、ページは、ユーザーがボタンをクリックすると送信されます。「ページ・プロセス」セクションを使用して、計算、検証、プロセス、ブランチなどのアプリケーション・ロジックを指定します。通常、Application Expressエンジンは、ページに表示される順序でこのロジックを実行します。

- 共有コンポーネント.「共有コンポーネント」セクションには、アプリケーション内の1つ以上のページで使用できる共通のコンポーネントが表示されます。

関連項目:

- 「レガシー・コンポーネント・ビューでのページの表示」

- レガシー・コンポーネント・ビューの使用

24.1.2 ページ・デザイナからレガシー・コンポーネント・ビューへの切替え

重要:

レガシー・コンポーネント・ビューはデフォルトで無効化されています。レガシー・コンポーネント・ビューを有効化するには、ユーザー・プリファレンスを編集して、「レガシー・コンポーネント・ビューの有効化」を「はい」に設定します。ユーザー・プリファレンスの編集を参照してください。

ページ・デザイナからレガシー・コンポーネント・ビューに切り替えるには、次のステップを実行します。

1. ページ・デザイナでページを表示します。

a. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

b. アプリケーションを選択します。

c. ページを選択します。

ページ・デザイナが表示されます。

2. ページ・デザイナの中央ペインの「コンポーネント・ビュー」タブをクリックします。

3. ページ・デザイナ・ツールバーの下の「レガシー・コンポーネント・ビュー」リンクをクリックします。

関連項目:

レガシー・コンポーネント・ビューからページ・デザイナへの切替え

24.1.3 レガシー・コンポーネント・ビューのUI要素の理解

レガシー・コンポーネント・ビューのUIは、次のUI要素で構成されています。

ヒント:

開発者ナビゲーション・ツールは、ほとんどのOracle Application Expressページでヘッダー・リージョンに表示されます。開発者ナビゲーション・ツールを参照してください。

トピック:

- コンポーネント・ビュー・ツールバー

- コンポーネント・ビューのナビゲーション・バー

- ページ・レンダリング

- ページ・プロセス

- 共有コンポーネント

関連項目:

- 「レガシー・コンポーネント・ビューでのページの表示」

- レガシー・コンポーネント・ビューの使用

24.1.3.1 コンポーネント・ビュー・ツールバー

コンポーネント・ビュー・ツールバーは、ページ上部に表示されます。カーソルをアクティブなボタンおよびメニューにあわせると、前の図に示すようにツールチップが表示されます。

コンポーネント・ビュー・ツールバーのボタンおよびメニュー・オプションは次のとおりです。

- 開発者のコメント(バグまたはTo Do)。「開発者コメント、バグまたはTo Doの作成」ダイアログを表示します。

- 「検索」アイコン。「検索」アイコンは懐中電灯の形をしています。「検索」アイコンをクリックして、アイテム、ページ、問合せ、表、PL/SQLコードまたはイメージを検索し、デバッグ・レポート、セッション・ステートおよびエラーを表示します。

- 共有コンポーネント.共有コンポーネント・ページにリンクします。共有コンポーネントは、アプリケーション内のすべてのページに表示または適用できます。

- ページの編集。カレント・ページを表示します。

- ページの実行。カレント・ページを実行します。

関連項目:

- 「開発者コメントの追加」

- 「バグの管理」

- 「To Doの追跡」

- 「レガシー・コンポーネント・ビューでのページの実行」

24.1.3.2 コンポーネント・ビューのナビゲーション・バー

ナビゲーション・バーは、ページ上部のブレッドクラム・メニューの下に表示されます。このバーは、アプリケーション内のページ間をナビゲートするために使用します。

- ページ・セレクタ。ページ間をナビゲートします。ページにナビゲートするには、「ページ・セレクタ」にページ番号を入力して「実行」をクリックします。

- 前のページ - 「前のページ」(<)をクリックして、前のアプリケーション・ページを表示します。

- 次のページ - 「次のページ」(>)をクリックして、次のアプリケーション・ページを表示します。

- 作成。

- ページ。ページの作成ウィザードにアクセスします。

- コピーとしてのページ。ページのコピー・ウィザードにアクセスします。

- リージョン。リージョンの作成ウィザードにアクセスします。

- ページ・コンポーネント。ページ・コンポーネントの作成ウィザードにアクセスします。このウィザードを使用して、アイテム、ボタン、ブランチ、計算、プロセスまたは検証を作成します。

- 共有コンポーネント.アプリケーション・コンポーネントの作成ウィザードにアクセスします。共有コンポーネントは、アプリケーション内のすべてのページに表示または適用される共通の要素です。

- ページ・グループ。ページ・グループ・ページにリンクします。ページ・グループを使用してページを整理します。

- 開発者のコメント。「開発者のコメント」ダイアログにアクセスします。開発者はアプリケーション、ページ、またはページ・グループにコメントを追加できます。

- チーム開発。サブメニューの「機能」、「To Do」および「バグ」を表示します。

- ユーティリティ。

- ページの削除。カレント・ページを削除します。

- アドバイザ。Oracle Application Express Advisor (Advisor)にアクセスします。Advisorを使用して、Oracle Application Expressアプリケーションの整合性と品質を確認します。

- コンポーネントの再順序付け。ページのコンポーネントを10ずつ再順序付けします。

- ロック。アプリケーション内のページをロックして、アプリケーション開発中の競合を回避します。

- ページ・イベント。現在定義されているすべてのページ・コントロールおよびプロセスの詳細が、Application Expressエンジンによるページのレンダリング、ロジックの呼出しおよびプロセスの実行の順序で示されます。

- クリーンアップ。ページのアイテムを10ずつ再順序付けします。

- キャッシュ。キャッシュ・ページにリンクします。キャッシュを有効にすることは、パフォーマンスを向上させるための効果的な方法です。

- 属性ディクショナリ。属性ディクショナリにアクセスします。

- 履歴。カレント・ページのすべての要素に加えられた変更のレポートを表示します。

- エクスポート。カレント・ページをエクスポートします。

- クロス・ページ・ユーティリティ。クロス・ページ・ユーティリティにアクセスします。

- アプリケーション・ユーティリティ。アプリケーション・ユーティリティにアクセスします。

- ページ・グループ。ページ・グループ・ページにリンクします。ページ・グループを使用してページを整理します。

- アプリケーションのアップグレード。既存のアプリケーションをアップグレードします。

- ページ・デザイナ - 「ページ・デザイナ」をクリックしてページ・デザイナのページを表示します。

関連項目:

ページ・デザイナでのページの管理

24.1.3.3 ページ・レンダリング

ページ・レンダリングとは、データベースからページを生成するプロセスです。開発者は、コンポーネント・ビューの「ページ・レンダリング」セクションを使用して、ページ属性、リージョン、ボタン、アイテムおよびページ・プロセスを含むページのレンダリングに影響するコントロールを変更できます。

表24-1 「ページ・レンダリング」のサブセクション

サブセクション

説明

ページ

ページ属性は、ページ名、ならびにページ・タイトルや関連するページ・テンプレート、ヘッダー・テキスト、および一部の名前のための選択された認可スキームといった表示属性などのページの詳細な特性を制御します。

関連項目: レガシー・コンポーネント・ビューでのページ属性へのアクセス

リージョン

リージョンはページ上の領域で、コンテンツのコンテナとして機能します。各ページには任意の数のリージョンを配置できます。リージョンのコンテンツは、リージョン・ソースによって決まります。たとえば、リージョンのコンテンツは、定義したSQL問合せに基づくレポートにも、静的HTMLにもできます。

特定のリージョン・テンプレートによってリージョンの外観を制御できます。リージョンを使用して、ページ・コントロール(アイテムやボタンなど)をグループ化できます。また、追加のHTMLを生成しない単純なリージョンを作成したり、HTMLの表やイメージ内でコンテンツをフレーム表示する複雑なリージョンを作成できます。

関連項目:

Oracle Database開発ガイド

ボタン

アプリケーションの設計時、ボタンを使用して、ユーザーを特定のページやURLにダイレクトしたり、ユーザーによるページの送信を可能にできます。ページを送信すると、Application Expressエンジンが情報を転送または処理します。ボタンの実装は、ボタン・テンプレートによって決定されます。ボタンを事前定義されたリージョン・テンプレートの位置に置くことも、フォーム内のアイテム間に置くこともできます。

関連項目: ボタンの作成

アイテム

アイテムは、関連するセッション・ステートを持つ、テキスト・フィールド、選択リスト、チェック・ボックスなどのHTMLフォーム要素です。アイテム属性は、ページ上のアイテムの表示および動作に影響します。たとえば、これらの属性は、ラベルの表示位置、アイテムの大きさおよびアイテムの表示位置(左右、上下)に影響します。

アイテムには、ページ・アイテムとアプリケーション・アイテムという2つのカテゴリが存在します。ページ・レベル・アイテムはページ上に配置され、「表示形式」、「ラベル」、「ラベル・テンプレート」などの関連するユーザー・インタフェースのプロパティを持ちます。アプリケーション・レベル・アイテムはページに関連付けられないため、ユーザー・インタフェースのプロパティを持ちません。アプリケーション・アイテムは、グローバル変数として使用できます。

関連項目: ページ・レベル・アイテムの理解およびアプリケーション・レベル・アイテムの管理

プロセス

プロセスは、データ操作言語(DML)またはPL/SQLの実行に使用されるロジック・コントロールです。たとえば、プロセスを使用して、ページのレンダリングの際にセッション・ステートを移入したり、(PL/SQLなどを使用して)一部のタイプのロジックを実行したり、レンダリング・エンジンをコールできます。一般に、プロセスはアクションを実行します。プロセスは、ハンドコードしたPL/SQLの場合も、事前定義したプロセスの呼出しの場合もあります。

関連項目: ページ・プロセスの理解およびアプリケーション・プロセスの理解

動的アクション

動的アクションは、JavaScriptを必要としないで複雑なクライアント側の動作を宣言的に定義する方法を提供します。定義された条件セットに基づいて実行されるアクションを指定できます。また、アクションの影響を受ける要素や、影響を受ける時期と影響も指定できます。

関連項目: 動的アクションの管理

24.1.3.4 ページ・プロセス

ページ・プロセスは、ページを送信するプロセスです。通常、ページは、ユーザーがボタンをクリックすると送信されます。コンポーネント・ビューの「ページ・プロセス」セクションを使用して、計算、検証、プロセス、ブランチなどのアプリケーション・ロジックを指定します。

表24-2 「ページ・プロセス」のサブセクション

サブセクション

説明

計算

計算は、アイテムへのセッション・ステートの割当てに使用するロジックの単位であり、ページの処理時に実行されます。

プロセス

プロセスは、データ操作言語(DML)またはPL/SQLの実行に使用されるロジック・コントロールです。プロセスは、ページの送信後に実行されます。

ブランチ

ブランチは、ユーザーがアプリケーション内をナビゲートする方法を決定するロジック・コントロールの作成を可能にします。

関連項目:

- 「ページ計算の理解」

- ページ・プロセスの理解

- ブランチを使用したナビゲーションの制御

- 「対象ボタン」属性について

24.1.3.5 共有コンポーネント

「共有コンポーネント」セクションには、アプリケーション内のすべてのページに表示または適用可能な共通の要素が含まれます。

表24-3 「共有コンポーネント」のサブセクション

サブセクション

説明

タブ

タブは、アプリケーションのページ間でのナビゲートに有効な方法です。アプリケーション・ビルダーには、標準タブおよび親タブという2つのタイプのタブが含まれています。

タブが1レベルのみのアプリケーションでは、標準タブ・セットを使用します。標準タブ・セットは、特定のページに関連付けられます。標準タブを使用すると、アプリケーション内の他のページにユーザーをリンクできます。親タブ・セットは、標準タブのグループを保持するコンテナとして機能します。親タブを使用すると、ナビゲーションのレベルおよびアプリケーション内でのコンテキスト(位置)を増やすことができます。

関連項目: タブの作成

LOV

値リスト(LOV)は、ラジオ・グループ、チェック・ボックス、ポップアップ・リスト、選択リストなどの、特定のタイプのページ・アイテムを表示するために使用される静的定義または動的定義です。LOVは、静的(事前定義された一連の表示値および戻り値に基づく)または動的(表から値を選択するSQL問合せに基づく)のいずれかです。作成したLOVは、1つ以上のページ・アイテムによって参照できます。

LOVは、LOVウィザードを実行してLOVリポジトリに追加して、アプリケーション・レベルで定義します。

関連項目: アプリケーション・レベルでのLOVの作成

ブレッドクラム

ブレッドクラムは、テンプレートを使用してレンダリングされるリンクの階層的なリストです。たとえば、ブレッドクラムをリンクのリストまたはブレッドクラム・パスとして表示できます。

関連項目: ブレッドクラムの作成

リスト

リストは、テンプレートを使用してレンダリングされるリンクのコレクションです。リストの各エントリに対して、表示テキスト、ターゲットURL、およびリスト・エントリがいつどのように表示されるかを制御するその他の属性を指定します。リストの表示や、すべてのリスト・エントリの外観は、そのリストをテンプレートにリンクすることによって制御します。

関連項目: リストの作成

テーマ

テーマは、アプリケーションのユーザー・インタフェースを定義するテンプレートの名前付きコレクションです。各テーマには、すべてのタイプのアプリケーション・コンポーネントおよびページ・コントロール(個々のページ、リージョン、レポート、リスト、ラベル、メニュー、ボタンおよびLOV)のテンプレートが含まれます。

関連項目: テーマの使用

テンプレート

テンプレートは、アプリケーション内のページのルック・アンド・フィールを制御します。アプリケーションの作成時に、ページ、リージョン、レポート、リスト、ラベル、メニュー、ボタンおよびポップアップLOVのテンプレートを指定します。テンプレートのグループは、テーマという名前付きコレクションで構成されます。

関連項目: カスタム・テーマの作成

セキュリティ

アプリケーションに対するセキュリティを提供するには、認可スキームを指定します。認可は、ユーザー権限に基づいてリソースへのアクセスを制御することを示す広義語です。

関連項目: 認可を介したセキュリティの提供

ナビゲーション・バー

ナビゲーション・バーを使用すると、アプリケーション内の様々なページにユーザーをリンクできます。ナビゲーション・バーを使用すると、ユーザーがヘルプ・テキストにログイン、ログアウトまたはリンクできるようにできます。ナビゲーション・バーの位置は、関連付けられたページ・テンプレートによって異なります。ナビゲーション・バー・アイコンを使用すると、イメージまたはテキストからのリンクを表示できます。ナビゲーション・バー・アイコンの作成時に、イメージ名、テキスト、表示順序およびリンク先の位置(URLまたはページ)を指定できます。

関連項目: ナビゲーション・バー・エントリの作成

24.1.4 レガシー・コンポーネント・ビューの使用

開発者は、コンポーネント・ビューを使用して、データベース・アプリケーション・ページを表示および編集できます。

トピック:

- レガシー・コンポーネント・ビューでのページの表示

- 「すべて編集」、「コピー」および「作成」アイコン

- レガシー・コンポーネント・ビューでのページ・コントロールの作成

24.1.4.1 レガシー・コンポーネント・ビューでのページの表示

ヒント:

レガシー・コンポーネント・ビューは、アプリケーション・ページを編集するためのレガシー・ユーザー・インタフェースです。開発者はレガシー・コンポーネント・ビューではなくページ・デザイナを使用することをお薦めします。ページ・デザイナとは異なり、レガシー・コンポーネント・ビューでは、ページを視覚的に表したり、ページ・コンポーネントをドラッグ・アンド・ドロップすることができません。ページ上のコンポーネントの位置をプレビューするには、ページを実行する必要があります。また、対話グリッドやOracle JETベースのチャートなど一部のアプリケーション・コンポーネントは、レガシー・コンポーネント・ビューを使用して編集または管理できません。

レガシー・コンポーネント・ビューでページを表示するには、次のステップを実行します。

1. 「ワークスペース」ホームページにナビゲートします。

2. 「アプリケーション・ビルダー」アイコンをクリックします。

3. アプリケーションを選択します。

4. ページを選択します。

デフォルト・ビューであるページ・デザイナが表示されます。

5. 中央ペインで、「コンポーネント・ビュー」タブをクリックします。

ページ・デザイナへの移行で開発者を支援するために、ページ・デザイナには「コンポーネント・ビュー」タブが含まれています。レガシー・コンポーネント・ビューと外観が類似しており、「コンポーネント・ビュー」タブには、ユーザー・インタフェース要素とアプリケーション・ロジックがコンポーネント・タイプ別に表示されます。ただし、コンポーネントをクリックすると、右ペインのプロパティ・エディタで対応する属性がハイライトされます。

6. 「レガシー・コンポーネント・ビュー」をクリックします。

レガシー・コンポーネント・ビューが表示されます。

関連項目:

- レガシー・コンポーネント・ビューでのページの管理

- 「レガシー・コンポーネント・ビューのUI要素の理解」

24.1.4.2 「すべて編集」、「コピー」および「作成」アイコン

「すべて編集」アイコン

サブセクションのタイトルの右側に表示される「すべて編集」アイコンをクリックすると、そのサブセクション内のコントロール、コンポーネントまたはロジックを編集できます。「すべて編集」アイコンは、紙の上に鉛筆が重なった形をしています。

「コピー」アイコンおよび「作成」アイコンをクリックして、コントロールやコンポーネントをコピーまたは作成できます。

「コピー」アイコン

「コピー」アイコンは、小さいページが2つ重なった形をしています。「コピー」アイコンをクリックすると、既存のコントロールやコンポーネントのコピーが作成されます。

「作成」アイコン

「作成」アイコンは、プラス(+)記号の形です。「作成」アイコンをクリックすると、コントロールやコンポーネントが作成されます。

24.1.4.3 レガシー・コンポーネント・ビューでのページ・コントロールの作成

ページ制御には、アイテム、ボタン、ブランチ、計算、プロセスまたは検証が含まれています。

コンポーネント・ビューでページ制御を追加するには、次のステップを実行します。

1. コンポーネント・ビューでページを表示します。

2. ナビゲーション・バーで、「作成」メニューをクリックして「ページ・コンポーネント」を選択します。

ページ・コンポーネントの作成ウィザードが表示されます。

3. 次のいずれかを選択します。

- アイテム。

- ボタン。

- ブランチ。

- 計算。

- プロセス。

- 検証。

4. 画面に表示されるステップに従います。

関連項目:

- 「レガシー・コンポーネント・ビューでのページの表示」

24.1.5 レガシー・コンポーネント・ビューでのページ属性へのアクセス

編集可能な共通のページ属性には、ページの名前またはタイトル、ヘッダーおよびフッター・テキスト、選択した認可スキームが含まれます。

トピック:

- コンポーネント・ビューでのページ属性の編集

- コンポーネント・ビューのページ属性

- コンポーネント・ビューを使用したJavaScriptの組込み

- コンポーネント・ビューでのセッションの再結合の構成

- コンポーネント・ビューでのダイアログ属性の構成

24.1.5.1 コンポーネント・ビューでのページ属性の編集

ページ属性を編集するには、次のステップを実行します。

1. コンポーネント・ビューでページを表示します。

2. 「ページ」で、ページ名または「すべて編集」アイコンをクリックします。

ページ属性ページが表示されます。

3. 対象となる属性を編集します。

必須の値には赤いアスタリスク(*)が付いています。

ヒント:

属性の詳細は、フィールドレベル・ヘルプを参照してください。

ページ属性ページは、セクションに分かれています。

これらのセクションにはページをスクロール・ダウンするか、ページ上部のナビゲーション・ボタンをクリックすることでアクセスできます。ページ上部のボタンを選択すると、選択されたセクションが表示され、その他のセクションはすべて一時的に非表示になります。ページのすべてのセクションを表示するには、「すべて表示」をクリックします。

4. 変更を保存するには、「変更の適用」をクリックします。

関連項目:

- 「レガシー・コンポーネント・ビューでのページの表示」

- Oracle Application Expressでのフィールドレベル・ヘルプの表示

24.1.5.2 コンポーネント・ビューのページ属性

コンポーネント・ビューのページ属性ページは、次のセクションに分かれています。

トピック:

- 名前

- 表示属性

- JavaScript

- CSS

- ダイアログ

- HTMLヘッダー

- ヘッダーおよびフッター

- 読取り専用

- セキュリティ

- 重複送信

- サーバー・キャッシュ

- 構成

- エラー処理

- ヘルプ

- コメント

24.1.5.2.1 名前

表24-4に、ページ名、英数字の別名(オプション)、関連付けられたページ・グループなど、カレント・ページの一般的な属性を示します。

表 24-4 ページ属性: 名前

属性

説明

名前

アプリケーション開発者のカレント・ページの名前を指定します。この名前は、ページ番号およびページ・タイトルとともに、多くのページおよびレポートで使用されます。

ページの別名

このページの英数字の別名を入力します。この別名は、カレント・アプリケーション内で一意である必要があります。

たとえば、アプリケーション100のページ1で作業している場合、別名「home」を作成できます。その後、次のf?p構文を使用して他のページからこのページにアクセスできます。

f?p=100:home

グループ

このページと関連付けるページ・グループを指定します。ページ・グループは、機能に影響しませんが、開発者がアプリケーション内のページを管理するのに役立ちます。

グループからページを削除するには、「- グループが割り当てられていない -」を選択し、「変更の適用」をクリックします。

関連項目: ページ・グループの作成

24.1.5.2.2 表示属性

表24-5に、選択されるページ・テンプレート、標準タブ・セット、タイトル、カーソル・フォーカスなど、カレント・ページの一般的な表示属性を示します。

表 24-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が使用されます。

24.1.5.2.3 JavaScript

表24-6に、カレント・ページにJavaScriptを含めることができる属性を示します。

表24-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コードのみ追加します。

24.1.5.2.4 CSS

表24-7に、カレント・ページにカスケード・スタイルシート(CSS)ファイルを含めることができる属性を示します。

表24-7 CSS属性

属性

説明

ファイルURL

このページにロードされるカスケード・スタイルシート・ファイルURLを入力します。各URLを新しい行に記述する必要があります。ファイルの縮小バージョンを指定する場合、置換文字列#MIN#を使用して.minを、または#MIN_DIRECTORY#を使用してminified/を通常ページ・ビューのファイルURLに含めたり、ページをデバッグ・モードで表示する場合は空の文字列を含めることができます。アプリケーションのバージョンをファイルURLに含める場合、置換文字列#APP_VERSION#にアクセスすることもできます。

ここに入力したファイルURLによって、ページ・テンプレート内の#PAGE_CSS#置換文字列が置き換えられます。

注意: リンクの開始タグや閉じタグを含める必要はありません。ファイルURLのみを含めてください

例を表示するには、フィールドレベル・ヘルプを参照してください。

インライン

このページに使用されるカスケード・スタイルシートのコードを入力します。コードが複数のページで使用されている場合、重複を避け、ブラウザで静的ファイルをキャッシュするため、外部ファイルに挿入することを検討してください。

ここに入力したコードによって、ページ・テンプレート内の#PAGE_CSS#置換文字列が置き換えられます。

注意: スクリプトの開始スタイル・タグや閉じスタイル・タグを含めないでください。カスケード・スタイルシート・コードのみを含めます。

例を表示するには、フィールドレベル・ヘルプを参照してください。

24.1.5.2.5 ダイアログ

表24-8に、ダイアログとして表示するページを定義する属性を示します。次の属性は、ページ・モードが「モーダル・ダイアログ」または「非モーダル・ダイアログ」に設定されている場合にのみ適用されます。

ヒント:

次の属性は、ページ・テンプレート・レベルで定義された同様の設定を上書きします。ダイアログを参照してください。

表24-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#は、このフィールドで指定した値で置換されます。この値はページ・テンプレート・レベルで設定された値を上書きします。

チェーン・ダイアログ

このダイアログが別のダイアログによって開かれ、同じダイアログ・ウィンドウを再利用する場合、「はい」を選択します。たとえば、このダイアログが複数ページ・ダイアログ・ウィザードの一部で、ウィザードの各ステップにダイアログ・ウィンドウを再利用する場合です。

このダイアログが別のダイアログによって開かれ、新規ダイアログ・ウィンドウで開かれる必要がある場合、「いいえ」を選択します。たとえば、このダイアログがモーダルで、親モーダル・ダイアログ・ウィンドウ内で開く場合です。

24.1.5.2.6 HTMLヘッダー

表24-9に、ページ・ヘッダーおよびページのHTML本文テキストを定義する属性を示します。

表24-9 HTMLヘッダー属性

属性

説明

HTMLヘッダー

ページ・テンプレート・ヘッダー内の#HEAD#置換文字列を置換するテキストを入力します。ここで入力する値は、HTML <HEAD>タグの後に挿入されます。このページ属性を使用して、ページ固有のメタ・タグを追加します。

注意: JavaScriptコードまたはカスケード・スタイルシートを専用のJavaScriptおよびCSS属性に追加する必要があります。

ページのHTMLボディ属性

ページ・テンプレートの#ONLOAD#置換文字列に置き換えられるテキストを入力します。この機能を使用するには、ページ・テンプレートに#ONLOAD#置換文字列が含まれている必要があります。

24.1.5.2.7 ヘッダーおよびフッター

表24-10に、ヘッダーおよびフッター・テキストを定義する属性を示します。

表24-10 ヘッダー・テキストおよびフッター・テキスト

属性

説明

ヘッダー・テキスト

ページ・ヘッダーの直後かつボディ・コンテンツの前に配置するテキストまたはHTMLを入力します。

フッター・テキスト

ページ・テンプレート・フッターの前に表示するテキストまたはHTMLを入力します。

24.1.5.2.8 読取り専用

このページでページ・アイテムを読取り専用としてレンダリングするために必要な条件タイプをリストから選択します。条件を選択しない場合、ページ・アイテムが通常どおりにレンダリングされます。読取り専用条件は、「ヘッダーの前」のプロセス・ポイントを持つプロセスを実行した後に評価されます。

ヒント:

一部のページ・アイテム(検索フィールドなど)または特定のリージョンのすべてのページ・アイテムを、この条件の評価内容とは無関係に常に入力可能なページ・アイテムとしてレンダリングする場合は、これらのリージョンまたはページ・アイテムの読取り専用条件を「なし」に設定します。

24.1.5.2.9 セキュリティ

表24-11に、カレント・ページの認可スキームおよび認証要件を定義する属性を示します。

表 24-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管理ガイドの「セッション再結合の構成」

24.1.5.2.10 重複送信

「複製ページの送信を許可」リストを使用して、ユーザーがページを1行で繰り返し処理できるかどうかを指定します。重複するページ送信が繰り返し処理されないようにするには、この属性を「いいえ」に設定します。

重複するページ送信の例を次に示します。

- ユーザーが「送信」ボタンを繰り返しクリックした場合

- ブランチ・タイプ「ページにブランチ」を作成して、ユーザーがブラウザの再ロード・ボタンをクリックした場合

「複製ページの送信時は、このURLに移動」で、URLを入力します。「複製ページの送信を許可」を「いいえ」に設定している場合はこのフィールドを使用します。「いいえ」を選択していて同一ページを2回発行すると、Oracle Application Expressはエラー・メッセージとユーザーが指定したURLへのリンクを表示します。

24.1.5.2.11 サーバー・キャッシュ

表24-12に、カレント・ページのキャッシュを有効にする属性を示します。

表24-12 ページ属性: サーバー・キャッシュ

属性

説明

キャッシュ・ページ

ページ・キャッシュを有効にするかどうかを指定します。ページ・キャッシュは、ページを動的に表示せずにキャッシュから表示するため、パフォーマンスが向上します。オプションは次のとおりです。

- 無効 - コンテンツはキャッシュされず、リクエストごとに計算されます。

- 有効 - コンテンツはキャッシュされ、すべてのユーザーによって利用されます。

- ユーザー別のキャッシュ - コンテンツはユーザーごとにキャッシュされます。

- セッション別のキャッシュ - コンテンツはセッションごとにキャッシュされます。

キャッシュ・タイムアウト

「有効」または「ユーザー別のキャッシュ」を選択するかどうかを表示します。キャッシュされたページが有効な時間を指定してください。

キャッシュ・ページ条件

条件を指定してください。条件がTrueを戻す場合、ページはキャッシュから表示されます。条件がFalseを戻す場合、ページは動的にレンダリングされ、キャッシュから取得されません。

式1

選択した「キャッシュ・ページ条件」に従って条件付きで表示されます。選択した特定の条件タイプに基づいて、この属性に値を入力してください。

式2

選択した「キャッシュ・ページ条件」に従って条件付きで表示されます。選択した特定の条件タイプに基づいて、この属性に値を入力してください。

関連項目:

Oracle Application Express管理ガイドの「キャッシュされたリージョンおよびページの管理」およびコンポーネント・ビューでのリージョン・キャッシュの使用

24.1.5.2.12 構成

このページに対するビルド・オプションを選択します。ビルド・オプションを使用すると、機能を有効または無効にできます。ほとんどのアプリケーション属性は、ビルド・オプション属性を持ちます。特定の構成でページを除外する場合以外は、カレント・ページのビルド・オプションを指定しないでください。

ビルド・オプションは、INCLUDEおよびEXCLUDEという2つの値をとることができます。属性を含めように指定すると、Application Expressエンジンは、実行時にその属性をアプリケーション定義の一部とみなします。逆に、属性を除外するように指定すると、Application Expressエンジンは、その属性を存在しないものとして処理します。

関連項目:

ビルド・オプションを使用した構成の制御

24.1.5.2.13 エラー処理

表24-13に、アプリケーションがエラーのログを記録する方法を制御または変更するために使用する属性を示します。

「インライン・エラー通知テキスト」で、ページでエラーが発生した場合に#NOTIFICATION_MESSAGE#テンプレート置換文字列に表示するエラー・テキストを入力します。

表24-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に関する説明

注意: アプリケーション・レベルで指定するエラー処理ファンクションは、ページ・レベルで指定されるエラー処理により上書きされます。アプリケーション属性の編集を参照してください。

関連項目:

ページ・テンプレート

24.1.5.2.14 ヘルプ

この属性を使用して、カレント・ページのヘルプ・テキストを入力します。ヘルプ・テキストは、ヘルプ・システムを使用して表示されます。このヘルプ・システムは開発する必要があります。

関連項目:

- 「アプリケーションのヘルプの作成」

- ショートカットの使用

24.1.5.2.15 コメント

この属性を使用して、カレント・ページに関するコメントを記録します。これらのコメントは、アプリケーションの実行中に表示されません。

24.1.5.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. 「変更の適用」をクリックします。

関連項目:

- 「レガシー・コンポーネント・ビューでのページの表示」

- 「フィールドレベル・ヘルプの表示」

24.1.5.4 コンポーネント・ビューでのセッションの再結合の構成

リージョンの再結合属性は、既存のセッションの結合(ディープ・リンクと同等)に対するサポートを制御します。技術的に、この属性は、このアプリケーションに対するURLにセッションIDを含むかどうかを決定します。

警告:

セッションの再結合を有効にすると、攻撃者が既存のエンド・ユーザー・セッションを乗っ取ることが可能になるため、アプリケーションのセキュリティが侵害される可能性があります。詳細は、「セッションを再結合」についてを参照してください。

セッションの再結合を使用するには、管理者がインスタンス・レベルでセッションの再結合を有効化する必要があります。インスタンス・レベルでのセッションの再結合のより制限的な値は、アプリケーションおよびページ設定をオーバーライドします。

コンポーネント・ビューでセッションの再結合を構成するには、次のステップを実行します。

1. コンポーネント・ビューでページを表示します。

2. 「ページ」で、「すべて編集」アイコンをクリックします。

3. 「セキュリティ」までスクロールします。

4. 「セッションを再結合」から、次のオプションを選択します。

- 無効 - すべてのURLにセッションIDを含む必要があります。

- パブリック・セッションに対して有効 - ユーザーがまだログインしていない場合、パブリック・ページのURLにセッションIDを含む必要はありません。

- すべてのセッションに対して有効 - チェックサムで保護されている場合、またはペイロード(リクエスト・パラメータ、クリア・キャッシュまたはアイテム・データ)が含まれていない場合、URLにセッションIDを含む必要はありません。この設定では、アプリケーションの「フレームへの埋込み」属性が「同じ起点から許可」または「拒否」に設定されている必要もあります。

5. 「変更の適用」をクリックします。

関連項目:

- 「セッションを再結合」について

- 「レガシー・コンポーネント・ビューでのページの表示」

24.1.5.5 コンポーネント・ビューでのダイアログ属性の構成

ヒント:

ダイアログ・ページの作成は、複数ステップのプロセスです。詳細は、ダイアログ・ページの作成を参照してください。

コンポーネント・ビューでダイアログ属性を構成するには、次のステップを実行します。

1. コンポーネント・ビューでページを表示します。

2. 「ページ」で、「すべて編集」アイコンをクリックします。

3. 「表示属性」で、ページ・モードが「モーダル」または「非モーダル」のいずれかになっていることを確認します。詳細は、フィールドレベル・ヘルプを参照してください。

4. 「ダイアログ」までスクロール・ダウンします。

5. 「ダイアログ」で、属性を構成します。

表24-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. 「変更の適用」をクリックします。

関連項目:

- 「レガシー・コンポーネント・ビューでのページの表示」

- ダイアログ・ページの作成

24.1.6 レガシー・コンポーネント・ビューでのページの実行

Application Expressエンジンは、データベース表に格納されたデータに基づいて、ページを動的にレンダリングおよび処理します。レンダリングされたアプリケーションを表示するには、アプリケーションを実行するか、またはApplication Expressエンジンに送信します。

コンポーネント・ビューでページを実行するには、次のステップを実行します。

1. コンポーネント・ビューでページを表示します。

2. ページを実行するには、右上隅の「ページの実行」ボタンをクリックします。

レンダリングされたアプリケーション・ページが表示されます。

関連項目:

- 「レガシー・コンポーネント・ビューでのページの表示」

- アプリケーションまたはページの実行

24.1.7 実行時開発者ツールバー

デスクトップ・アプリケーションを実行してページを表示する場合は、編集可能な実行中のページの下部に、実行時開発者ツールバーが表示されます。「開発者」ツールバーを使用すると、迅速に、カレント・アプリケーションまたは現在実行されているページを編集したり、セッション・ステートを表示することができます。

ヒント:

実行時開発者ツールバーは、アプリケーション定義ページの「可用性」、「ステータス」属性が「開発者ツールバーで使用可能」に設定されている場合にのみ表示されます

注意:

実行時開発者ツールバーは、ロックされたパッケージ・アプリケーション・ページまたはjQuery Mobileスマートフォン・ページには表示されません。

実行時開発者ツールバーには、次のコントロールが含まれています。

- ホーム: ワークスペースのホームページにリンクします。ワークスペースのホームページの理解を参照してください。

- 「アプリケーション」: アプリケーションのホームページにリンクします。アプリケーション・ビルダーのホームページの使用を参照してください。

- 「ページの編集」: 現在実行中のページIDを表示します。

- セッション: カレント・ページのセッション・ステート情報にリンクします。「セッション・ページの使用」を参照してください。

- デバッグの表示: デバッグ・レポートを表示します。「セッション・ページの使用」を参照してください。

- デバッグ: ページを「デバッグ」モードと「デバッグなし」モードとの間で切り替えます。「デバッグ・モードの使用」を参照してください。

- レイアウト列の表示: 「レイアウト列の表示」と「レイアウト列の非表示」との間で切り替えます。このオプションは、レイアウトが使用され、そのレイアウトでレイアウト列の表示がサポートされ、ページに複数の列がある場合にのみ適用されます。

- クイック編集: 開発者が、クイック編集モードを開始するか、ライブ・テンプレート・オプションにアクセスできます。

- クイック編集モードでのアクセス: 「クイック編集」をクリックして、目的のコンポーネントを選択すると、ページ・デザイナでそのコンポーネントに即時にアクセスできます。クイック編集モードを終了するには、[Esc]を押すかコンポーネントの外側をクリックします。

- ライブ・テンプレート・オプションの編集: 「クイック編集」をクリックして、テンプレート・オプションを変更するコンポーネントの上にマウスを移動して、右上隅のレンチ・アイコンをクリックします。ライブ・テンプレート・オプションを変更するためのクイック編集の使用を参照してください。

テーマ・ローラー: カラー・ピッカーから色を選択したり値を設定することで、アプリケーションの外観を簡単にカスタマイズできます。「テーマ・ローラー」をサポートしているテーマにのみ表示されます。テーマ・スタイルの使用を参照してください。

- 開発者ツールバー・オプション: 右端に表示され、機械の歯車のような形をしています。「開発者ツールバー・オプション」をクリックすると、実行時開発者ツールバーの表示方法をカスタマイズできます。使用可能なコントロールは次のとおりです。

- 自動非表示

- アイコンのみの表示

- 表示位置 (上、左、下、右)

24.1.8 レガシー・コンポーネント・ビューでのデータベース・アプリケーション・ページのコピー

現在のアプリケーションまたは別のアプリケーションからページをコピーできます。コピー・プロセス中に、共有コンポーネントのコピーや、ターゲット・アプリケーションの共有コンポーネントへのマッピングを変更することもできます。

ページをコピーする手順は次のとおりです。

1. コンポーネント・ビューでページを表示します。

2. 「作成」をクリックしてから「コピーとしてのページ」をクリックします。

3. 「ページ・オプションのコピー」で、次のいずれかを選択します。

- このアプリケーションのページ

- 別のアプリケーションのページ

4. 画面に表示されるステップに従います。

関連項目:

「レガシー・コンポーネント・ビューでのページの表示」

24.1.9 レガシー・コンポーネント・ビューでのページの削除

ページを削除すると、対応する表、ブレッドクラムおよびリスト・エントリが削除されます。開発者は、ロック解除されているか、自分がロックしたページのみを削除できます。

トピック:

- コンポーネント・ビューでのページの削除

- ページ属性の編集中にページの削除

- 複数のページの削除

- ページの範囲の削除

関連項目:

- ページのロックおよびロック解除

- 「レガシー・コンポーネント・ビューでのページの表示」

24.1.9.1 コンポーネント・ビューでのページの削除

コンポーネント・ビューでページを削除するには、次のステップを実行します。

1. コンポーネント・ビューでページを表示します。

2. ページ番号を確認します。

3. コンポーネント・ビュー・ツールバーで、「ユーティリティ」をクリックしてから「ページの削除」をクリックします。

4. 「ページを完全に削除」をクリックします。

24.1.9.2 ページ属性の編集中にページの削除

ページ属性の編集中にページを削除するには、次のストップを実行します。

1. ページ属性ページにアクセスします。

2. ページ番号とページ名を確認します。

3. 「削除」をクリックします。

4. 画面に表示されるステップに従います。

24.1.9.3 複数のページの削除

複数ページを削除するには、次のステップを実行します。

1. コンポーネント・ビューでページを表示します。

2. ページ番号を確認します。

3. コンポーネント・ビュー・ツールバーで、「ユーティリティ」、「クロス・ページ」および「複数のページの削除」をクリックします。

4. 削除するページを選択し、「ページの削除」をクリックします。

24.1.9.4 ページの範囲の削除

ページの範囲を削除するには、次のステップを実行します。

1. コンポーネント・ビューでページを表示します。

2. ページ番号を確認します。

3. コンポーネント・ビュー・ツールバーで、「ユーティリティ」、「クロス・ページ・ユーティリティ」および「複数のページの削除」をクリックします。

4. 「範囲別ページの削除」タブをクリックします。

5. 削除するページを入力し、「ページの削除」をクリックします。

24.2 レガシー・チャートの管理

ヒント:

AnyChartチャートは、レガシー・アプリケーション・コンポーネントです。レガシー・コンポーネントは引き続きOracleでサポートされますが、Oracle JETチャートに基づく新しいチャートを作成することをお薦めします。チャートの作成を参照してください。

Oracle Application Expressのレガシー・チャートは、AnyChart HTML5 Chart ComponentとAnyChart Flash Chart Componentをベースにしています。

トピック:

- チャート・タイプについて

- チャートのSQL問合せの作成

- 新しいページへのレガシー・チャートの追加

- ページ・デザイナでのチャートの管理

- レガシー・コンポーネント・ビューでのチャートの管理

- SVGチャートのサポートの理解

- HTMLチャートのサポートの理解

- Flashチャートの保存について

- FlashおよびHTML5チャートとのカスタムXMLの使用

24.2.1 チャート・タイプについて

Oracle Application ExpressのHTML5チャートとFlashチャートのサポートは、AnyChart HTML5 Chart ComponentとAnyChart Flash Chart Componentをベースにしています。AnyChartはフレキシブルなFlashおよびJavaScriptベースのソリューションで、開発者は動きがありコンパクトでインタラクティブなチャートを作成できます。

トピック:

- HTML5チャートについて

- Flashチャートについて

24.2.1.1 HTML5チャートについて

Oracle Application ExpressのHTML5チャートのサポートは、AnyChart HTML5 Chart Componentをベースにしています。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を参照してください。

24.2.1.2 Flashチャートについて

Oracle Application ExpressのFlashチャートのサポートは、AnyChart Flash Chart Componentをベースにしています。Flashチャートはブラウザでレンダリングされ、使用するにはFlash Player 9以上が必要です。AnyChart 6.0では、FlashチャートはFLASH_PREFERREDレンダリング・タイプを使用してレンダリングされます。チャートを表示するデバイスでFlash Playerを使用できない場合(iPhoneで表示されるページなど)、AnyChartは自動的にHTML5チャート・エンジンに切り替え、SVGベースのチャートを表示します。

24.2.2 チャートのSQL問合せの作成

この項では、アプリケーション・ビルダーでのチャートの作成についてサポートされる構文を説明します。

トピック:

- 標準チャート構文

- ダイアル・チャート構文(FlashおよびHTML5)

- 複数シリーズ構文(FlashおよびHTML5)

- レンジ・チャート構文(FlashおよびHTML5)

- 散布チャート構文(FlashおよびHTML5)

- ローソク足チャート構文(FlashおよびHTML5)

- ガント・チャート構文(Flashのみ)

24.2.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

24.2.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

24.2.2.3 複数シリーズ構文(FlashおよびHTML5)

列チャートおよび行チャートには、1つのSQL問合せで複数シリーズを定義できます。これらのチャート・タイプのシリーズ名は、問合せ内の関連する列別名から導出されます。複数シリーズのチャートを定義するには、次の構文を使用します。

SELECT link, label, series_1_value [, series_2_value [, ...]]
FROM   ...

24.2.2.4 レンジ・チャート構文(FlashおよびHTML5)

レンジ・チャートは、各バーに2つの値が必要です。レンジ・チャートを作成するには、チャートを作成し、次の構文を使用してSQL問合せを提供します。

SELECT link, label, low_value, high_value
FROM   ...

24.2.2.5 散布チャート構文(FlashおよびHTML5)

散布チャートは、各ポイントにx値およびy値が必要です。レンジ・チャートを作成するには、チャートを作成し、次の構文を使用してSQL問合せを提供します。

SELECT link, label, x_value, y_value
FROM   ...

24.2.2.6 ローソク足チャート構文(FlashおよびHTML5)

ローソク足チャートには、各ローソク足に始値、安値、高値および終値が必要です。ローソク足チャートを作成するには、チャートを作成し、次の構文を使用してSQL問合せを指定します。

SELECT link, label, open, low, high, close
FROM   ...

24.2.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

24.2.3 新しいページへのレガシー・チャートの追加

新しいページにチャートを追加するには、次のステップを実行します。

注意:

レガシーAnyChartチャートは、レガシー・アプリケーション・コンポーネントです。レガシー・コンポーネントは引き続きOracleでサポートされますが、かわりにOracle JETデータ視覚化に基づく新しいチャートを作成することをお薦めします。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「ページの作成」をクリックします。

4. 「ページの作成」で、次のステップを実行します。

a. ユーザー・インタフェース: ページのユーザー・インタフェースを選択します。

b. ページ・タイプの選択: 「レガシー・ページ」を選択して、「AnyChartチャート」を選択します。

5. 「チャート・タイプ」で、次のステップを実行します。

a. チャートのレンダリング: チャート・タイプを選択します。

b. チャート・タイプ: チャート・タイプを指定します。チャート・タイプによっては、追加で選択するように求められる場合があります。

c. 「次へ」をクリックします。

6. 「チャート・タイプ」でチャート・タイプを選択し、「次へ」をクリックします。

7. 「ページおよびリージョン属性」で、次のステップを実行します。

a. ページ番号: チャートを作成するページ番号を入力します。

b. ページ名: ページ名を入力します。

c. ページ・モード: ページ・モードを選択します。

詳細は、フィールドレベル・ヘルプを参照してください。

d. ブレッドクラム: ページでブレッドクラム・ナビゲーション・コントロールを使用するかどうか、およびどのブレッドクラム・ナビゲーション・コントロールを使用するかを選択します。

e. 「次へ」をクリックします。

8. 「ナビゲーションのプリファレンス」で、このページに含めるナビゲーションのタイプを指定し、「次へ」をクリックします。ナビゲーション・オプション(ナビゲーション・メニューまたはタブなど)はカレント・アプリケーションのテーマに応じて決まります。

9. 「チャート属性」で、該当する属性を指定します。

ヒント:

表示される属性は、チャート・タイプによって異なります。属性の詳細は、フィールドレベル・ヘルプを参照してください。

10. 「ソース」で、次のステップを実行します。

チャートを表示するためのデータを戻す問合せを入力します。必要な問合せフォーマットは、チャート・タイプに応じて異なります。

a. SQL問合せ、またはSQL問合せを戻すPL/SQLファンクションを入力: チャートに移入するSQL問合せを指定します。

b. 問合せは次のいずれかの方法で指定します。

- 表示されているフィールドにSQL問合せを入力します。

- 「問合せの作成」ボタンをクリックします。ビルド・チャート問合せウィザードが表示されたら、画面に表示されるステップに従います。

c. 問合せの検証: チャート問合せを検証するかどうかを指定します。可能な場合は常に問合せを検証する必要があります。ただし、セッション内でアイテムを参照する場合は、ページを実行するまでこれを行うことはできません。このような場合は、検証しないで保存します。

d. 送信するページ・アイテム: チャート・データが各リクエストで読み取られるときにセッション・ステートに設定される、カレント・ページのページ・アイテムのカンマ区切りリストを入力します。

e. 最大行数: チャートの表示に使用する行の最大数を入力します。

f. データが見つからなかった場合のメッセージ: 問合せによって行が戻されない場合に使用するテキストを入力します。

g. 関連するチャート属性を指定します。

属性の詳細は、フィールドレベル・ヘルプを参照してください。

11. 「作成」をクリックします。

関連項目:

- 「チャート・タイプについて」

- 「チャートのSQL問合せの作成」

- 「フィールドレベル・ヘルプの表示」

24.2.4 ページ・デザイナでのチャートの管理

この項では、ページ・デザイナでチャートを作成および編集する方法について説明します。

トピック:

- ページ・デザイナでのチャートの追加

- ページ・デザイナでのチャート属性の編集

- HTML5チャートからFlashチャートへの切替え

- 非同期更新の有効化

24.2.4.1 ページ・デザイナでのチャートの追加

ページ・デザイナで既存ページにチャートを追加するには、次のステップを実行します。

1. ページ・デザイナでアイテムを含めるページを表示します。

2. ギャラリから「ギャラリ・メニュー」をクリックして、「レガシー・コンポーネントの表示」を選択します。

3. ギャラリで、チャート - AnyChart [レガシー]を右クリックして「追加先」を選択し、適切な位置を選択します。

ヒント:

ギャラリで、マウスを使用してチャート - AnyChart [レガシー]を選択して、「レイアウト」タブの適切な位置までドラッグすることもできます。

ページ・デザイナは、次に必要なアクションを示します。

「メッセージ」タブには、対応する必要のあるメッセージを示す赤または黄色のバッジが表示されます。「メッセージ」タブには、次の2つのタイプのメッセージが表示されます。

- エラー - エラー・メッセージは赤で表示されます。エラー・メッセージを選択すると、プロパティ・エディタに関連する属性が赤で表示されます。ページを保存する前にエラーに対処する必要があります。

- 警告 - 警告メッセージは黄色で表示されます。警告メッセージを選択すると、プロパティ・エディタで、関連する属性が黄色で表示されます。ページを保存する前にエラーに対処する必要があります。警告メッセージには対処しないでページを保存できることに注意してください。

4. チャート属性を編集します。

ヒント:

属性の詳細は、プロパティ・エディタで属性を選択し、中央ペインで「ヘルプ」タブをクリックして、参照してください。

a. 「レンダリング」タブで、チャートを探して「属性」ノードを選択します。

プロパティ・エディタに、チャートの属性が表示されます。

b. 属性を編集します。

5. シリーズを編集します。

a. 「レンダリング」タブで、「シリーズ」ノードを選択します。

プロパティ・エディタにシリーズ属性が表示されます。

b. 属性を編集します。

6. 「保存」をクリックします。

関連項目:

ページ・デザイナでのページの表示

24.2.4.2 ページ・デザイナでのチャート属性の編集

チャートの作成後は、ページ・デザイナでチャート属性を編集してチャートの表示を変更できます。

注意:

ページ・デザイナを使用して、非推奨のSVGチャート・タイプを編集することはできません。

チャート属性を編集するには、次のステップを実行します。

1. ページ・デザイナで、チャートを含むページを表示します。

2. 「レンダリング」タブで、チャートを探して「属性」ノードを選択します。

3. プロパティ・エディタですべての属性を表示するには、「すべて表示」をクリックします。

4. グループまたは属性を検索するには、「フィルタ・プロパティ」フィールドにキーワードを入力します。

5. チャート属性を編集します。

ヒント:

属性の詳細は、プロパティ・エディタで属性を選択し、中央ペインで「ヘルプ」タブをクリックして、参照してください。

6. 「保存」をクリックします。

注意:

「ページ・デザイナでのページの表示」

24.2.4.3 HTML5チャートからFlashチャートへの切替え

HTML5チャートの作成後は、「チャート属性」ページでチャート属性を編集することによって、そのレンダリングをFlashに切り替えることができます。

HTML5チャートをFlashチャートに切り替えるには、次のステップを実行します。

1. ページ・デザイナで、チャートを含むページを表示します。

2. 「レンダリング」タブで、「属性」ノードを選択します。

「プロパティ・エディタ - 属性」が表示されます。

3. 「外観」セクションを開きます。

4. 「外観」の「レンダリング」で、「Flashチャート」を選択します。

属性の詳細は、フィールドレベル・ヘルプを参照してください。

5. 「保存」をクリックします。

関連項目:

- 「ページ・デザイナでのページの表示」

- 「フィールドレベル・ヘルプの表示」

24.2.4.4 非同期更新の有効化

チャート属性ページで「非同期更新」属性を有効するか、リフレッシュ・アクションとともに動的アクションを使用すると、SVGチャート、FlashチャートおよびHTML5チャートで情報を監視できます。

トピック:

- 非同期更新属性の有効化

- ページ・デザイナでのリフレッシュ動的アクションの作成

24.2.4.4.1 非同期更新属性の有効化

「非同期更新」属性を有効にすると、チャートが更新され、指定した時間間隔内に基礎となるデータで行われた変更が反映されます。

非同期更新を有効にするには、次のステップを実行します。

1. ページ・デザイナでアイテムを含めるページを表示します。

2. 「レンダリング」タブで、チャートを探して「属性」ノードを選択します。

プロパティ・エディタに属性が表示されます。

3. プロパティ・エディタですべての属性を表示するには、「すべて表示」をクリックします。

4. グループまたは属性を検索するには、「フィルタ・プロパティ」フィールドにキーワードを入力します。

5. 「自動リフレッシュ」を探して「はい」を選択します。

6. 「間隔」を見つけて、リフレッシュ間隔を秒単位で指定します。

7. 「保存」をクリックします。

注意:

「ページ・デザイナでのページの表示」

24.2.4.4.2 ページ・デザイナでのリフレッシュ動的アクションの作成

リフレッシュ動的アクションを作成するには、次の手順を実行します。

1. ページ・デザイナでアイテムを含むページを表示します。

2. 左ペインで「動的アクション」タブをクリックします。

3. 「動的アクション」で、「イベント」を右クリックし、「動的アクションの作成」を選択します。

プロパティ・エディタに動的アクション属性が表示されます。

ヒント:

「メッセージ」タブに、対処が必要なメッセージを示す赤または黄色の印が表示されます。メッセージを選択すると、プロパティ・エディタに関連する属性が表示されます。赤いエラー・メッセージは、保存する前に対処する必要があります。

4. プロパティ・エディタですべての属性を表示するには、「すべて表示」をクリックします。

5. プロパティ・エディタで、次の動的アクション属性を編集します。

ヒント:

属性の詳細は、プロパティ・エディタで属性を選択し、中央ペインで「ヘルプ」タブをクリックして、参照してください。

a. 指定、名前 - 動的アクションの名前を入力します。

b. 実行オプション、順序 - このコンポーネントの順序を指定します。これによって実行の順序が決まります。

c. 時期、イベント - 動的アクションを起動するイベントを指定します。

d. 時期、選択タイプ - イベントのトリガーに使用するページ要素または構成体のタイプを選択します。特定の選択タイプの使用例は、関連する属性のヘルプを参照してください。

次に、イベントがTrueと評価された場合に実行するアクションを定義します。

6. 「レンダリング」タブで、Trueの下の最初のアクションを選択します。プロパティ・エディタで、次のアクション属性を編集します。

a. アクション: 「リフレッシュ」を選択します。

b. 選択タイプ: 「リージョン」を選択します。

c. リージョン: チャートを含むリージョンを選択します。

7. 「保存」をクリックします。

注意:

「ページ・デザイナでのページの表示」

24.2.5 レガシー・コンポーネント・ビューでのチャートの管理

開発者は、コンポーネント・ビューでチャートを作成および管理できます。

トピック:

- コンポーネント・ビューでのチャートの追加

- HTML5チャートからFlashチャートへの切替え

- コンポーネント・ビューでのチャート属性の編集

- 非同期更新の有効化

関連項目:
レガシー・コンポーネント・ビューでのページの管理

24.2.5.1 コンポーネント・ビューでのチャートの追加

コンポーネント・ビューで既存ページにチャートを追加するには、次のステップを実行します。

1. ページに移動します。

2. 新しいリージョンを作成します。「リージョン」で、「作成」アイコンをクリックします。

「リージョンの作成」ウィザードが表示されます。

3. 「リージョンの作成」で、「チャート」を選択して「次へ」をクリックします。

4. 「チャート・タイプ」で、次のステップを実行します。

a. チャートのレンダリング: チャート・タイプを選択します。

b. チャート・タイプ: チャート・タイプを指定します。チャート・タイプによっては、追加で選択するように求められる場合があります。

c. 「次へ」をクリックします。

5. 「表示属性」で、次のステップを実行します。

a. タイトル - リージョンのタイトルを入力します。選択するリージョン・テンプレートにリージョン・タイトルが表示されると、このタイトルが表示されます。

b. リージョン・テンプレート - リージョンのタイトルを入力します。選択するリージョン・テンプレートにリージョン・タイトルが表示されると、このタイトルが表示されます。

c. 親リージョン - 新しいリージョンが属する親リージョンを定義します。

d. 表示ポイント: このリージョンの表示ポイントを指定します。詳細は、フィールドレベル・ヘルプを参照してください。

詳細は、フィールドレベル・ヘルプを参照してください。

e. 「次へ」をクリックします。

6. 「チャート属性」で、適切な属性を指定し、「次へ」をクリックします。

属性の詳細は、フィールドレベル・ヘルプを参照してください。

7. 「ソース」で、次のステップを実行します。

a. 問合せは次のいずれかの方法で指定します。

- 表示されているフィールドにSQL問合せを入力します。

- 「問合せの作成」ボタンをクリックします。ビルド・チャート問合せウィザードが表示されたら、画面に表示されるステップに従います。

b. 関連するチャート属性を指定します。

属性の詳細は、フィールドレベル・ヘルプを参照してください。

8. 「条件付き表示」で、次のステップを実行します。

a. 条件タイプ: このコンポーネントがレンダリングされるために満たす必要があるリストから、条件タイプを選択します。

b. 認可スキーム: オプションで認可スキームを選択します。このコンポーネントをレンダリングまたは処理するためには、この認可スキームがTRUEと評価される必要があります。

c. 「リージョンの作成」をクリックします。

関連項目:

- 「レガシー・コンポーネント・ビューでのページの表示」

- 「チャート・タイプについて」

- 「フィールドレベル・ヘルプの表示」

- 「チャートのSQL問合せの作成」

- 条件付きのレンダリングおよびプロセスの理解

- 認可を介したセキュリティの提供

24.2.5.2 HTML5チャートからFlashチャートへの切替え

HTML5チャートの作成後は、「チャート属性」ページでチャート属性を編集することによって、そのレンダリングをFlashに切り替えることができます。

HTML5チャートをFlashチャートに切り替えるには、次のステップを実行します。

1. ページに移動します。

2. チャート属性ページにアクセスします。

a. 「リージョン」で、リージョン名を選択します。

リージョン定義が表示されます。

b. 「チャート属性」をクリックします。

3. 「チャート・タイプ」で、次のステップを実行します。

a. チャートのレンダリング: 「Flashチャート」を選択します。

b. チャート・タイプ: チャート・タイプを指定します。3Dチャート・タイプはFlashチャートでのみサポートされているため、3Dオプションを使用するにはチャート・タイプを変更する必要がある場合があります。

属性の詳細は、フィールドレベル・ヘルプを参照してください。

4. 「変更の適用」をクリックします。

関連項目:

- 「レガシー・コンポーネント・ビューでのページの表示」

- 「フィールドレベル・ヘルプの表示」

24.2.5.3 コンポーネント・ビューでのチャート属性の編集

チャートの作成後は、「チャート属性」ページでチャート属性を編集してチャートの表示を変更できます。

「チャート属性」ページにアクセスするには、次のステップを実行します。

1. ページに移動します。

2. チャート属性ページにアクセスします。「リージョン」で、リージョン名を選択します。

3. 対象となる属性を編集します。

4. 属性の詳細は、フィールドレベル・ヘルプを参照してください。

5. 「変更の適用」をクリックします。

関連項目:

- レガシー・コンポーネント・ビューでのページの表示

- 「フィールドレベル・ヘルプの表示」

24.2.5.4 非同期更新の有効化

チャート属性ページで「非同期更新」属性を有効するか、リフレッシュ・アクションとともに動的アクションを使用すると、SVGチャート、FlashチャートおよびHTML5チャートで情報を監視できます。

トピック:

- 非同期更新属性の有効化

- リフレッシュ動的アクションの作成

24.2.5.4.1 非同期更新属性の有効化

「非同期更新」属性を有効にすると、チャートが更新され、指定した時間間隔内に基礎となるデータで行われた変更が反映されます。

非同期更新を有効にするには、次のステップを実行します。

1. 「チャート属性」ページにナビゲートします。

チャート属性ページが表示されます。

2. 「リフレッシュ」までスクロールします。

3. 「非同期更新」で、「はい」を選択します。

4. 「更新間隔」で、チャートの更新間隔(秒)を入力します。最適なパフォーマンスを得るには、2秒を超える間隔を選択します。

注意:

「コンポーネント・ビューでのチャート属性の編集」

24.2.5.4.2 リフレッシュ動的アクションの作成

リフレッシュ動的アクションを作成するには、次の手順を実行します。

1. チャートを含むページにナビゲートします。

2. 「動的アクション」セクションで、「作成」をクリックします。

3. 「指定」で、次のステップを実行します。

a. 名前: 動的アクションの名前を入力します。

b. 順序: このコンポーネントの順序を指定します。これによって評価の順序が決まります。

c. 「次へ」をクリックします。

4. 「時期」で、次のステップを実行します。

a. イベント: 動的アクションの起動をトリガするイベントを指定します。

b. 選択タイプ: 動的アクションがいつ起動するかを定義するページ要素の選択タイプを指定します。特定のページ・アイテムの例を表示するには、フィールドレベル・ヘルプを参照してください。

c. 「次へ」をクリックします。

5. 「Trueアクション」で、次のステップを実行します。

a. アクション: 「リフレッシュ」を選択します。

b. 「次へ」をクリックします。

6. 「影響を受ける要素」で、次のステップを実行します。

a. 選択タイプ: 「リージョン」を選択します。

b. リージョン: チャートを含むリージョンを選択します。

c. 「次へ」をクリックします。

7. 「動的アクションの作成」をクリックします。

注意:

「レガシー・コンポーネント・ビューでのページの表示」

24.2.6 SVGチャートのサポートの理解

以前のリリースのOracle Application Expressでは、SVGチャートの作成がサポートされていました。既存のSVGチャートは引き続きサポートされていますが、Oracle Application Expressでは新しいSVGチャートの作成はサポートされなくなりました。

ヒント:

コンポーネント・ビューでのみSVGチャートを編集できます。

トピック:

- SVGチャートのHTML5へのアップグレード

- SVGチャート・カスケード・スタイルシート・クラスの理解

- カスタムSVGチャート・カスケード・スタイルシートの参照

- SVGチャートのカスタムCSSスタイル・インラインの指定

- 他の言語でのSVGチャートの表示

24.2.6.1 SVGチャートのHTML5へのアップグレード

この項では、SVGチャートをHTML5にアップグレードする際に適用される制限と、アップグレードの手順について説明します。

単一または複数のSVGチャートを自動的にHTML5にアップグレードできます。

トピック:

- SVGチャートのアップグレードの制限事項について

- 1つのSVGチャートのHTML5へのアップグレード

- アプリケーション内のすべてのSVGチャートのHTML5へのアップグレード

24.2.6.1.1 SVGチャートのアップグレードの制限事項について

SVGチャートをアップグレードできますが、次の制限事項があります。

- 軸の書式文字列で定義された数値書式のみが移行されます。日付書式および時間書式は無視されます。

- 次の項目を含む数値書式の要素が移行されます。

0,9,D,G,, (comma),. (period),$,C,L,FM

- HTML5チャートの各シリーズのラベルは、各シリーズの列の別名から導出されます。これは各シリーズのラベルが「シリーズ名」属性から導出されるSVGチャートによって異なります。

- SVGチャートでは、最初のシリーズのラベルがX軸に使用されます。HTML5チャートでは、最初のシリーズでデータのラベルが発生していなくても、すべてのデータが表示されるように拡張されています。

24.2.6.1.2 1つのSVGチャートのHTML5へのアップグレード

SVGチャートをHTML5にアップグレードするには、次のステップを実行します。

1. ページに移動します。

2. チャート属性ページにアクセスします。

a. 「リージョン」で、リージョン名を選択します。

リージョン定義が表示されます。

b. 「チャート属性」をクリックします。

3. 「タスク」リストで、「新しいHTML5チャートへのアップグレード」をクリックします。

4. 「アップグレード」をクリックします。

注意:

「レガシー・コンポーネント・ビューでのページの表示」

24.2.6.1.3 アプリケーション内のすべてのSVGチャートのHTML5へのアップグレード

すべてのSVGチャートをHTML5チャートにアップグレードするには、次のステップを実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

アプリケーション・ビルダーのホームページが表示されます。

2. アプリケーションを選択します。

アプリケーションのホームページが表示されます。

3. 「ユーティリティ」をクリックして、「アプリケーションのアップグレード」をクリックします。

「アプリケーション・サマリーのアップグレード」レポートが表示されます。

4. 「SVGチャートのHTML5チャートへのアップグレード」で、候補オブジェクトの数をクリックします。

5. アップグレードするオブジェクトを選択し、「アップグレード」をクリックします。

24.2.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;}

表24-15に、サポートされているすべてのCSSクラスを示します。一部のクラスは、特定のチャート・タイプにのみ適用されます。

表 24-15 使用可能な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

凡例内のすべての矩形アイテムに一律のスタイルを適用します。

24.2.6.3 SVGチャート・カスタム・カスケード・スタイルシートの参照

「チャート属性」ページの「CSS」セクションを使用して、チャート用のカスタム・カスケード・スタイルシートを参照できます。外部CSSを参照する場合は、全体を参照するか、または特定のスタイルを上書きできます。

カスタム・チャートCSSを参照するには、次のステップを実行します。

1. CSSをアプリケーション・ビルダーにアップロードします。

2. チャートを含むページにナビゲートします。

3. チャート属性ページにアクセスします。

a. 「リージョン」で、リージョン名を選択します。

リージョン定義が表示されます。

b. 「チャート属性」をクリックします。

4. 「チャート属性」ページで、CSSセクションまでスクロールします。

5. 「カスタムCSSを使用」で、「はい」を選択します。

6. 外部CSSを排他的に参照するには、次のステップを実行します。

a. 「カスタムCSS (リンク)」で、カスタムCSSへのリンクを入力します。次に例を示します。

#IMAGE_PREFIX#themes/theme_4/svg.css

b. CSSが排他的に使用されるように指定します。「カスタムCSS、インライン」で、次のように入力します。

/**/

7. カスタムCSSを参照し、特定のスタイルを上書きするには、次のステップを実行します。

a. 「カスタムCSS (リンク)」で、カスタム・スタイルシートへのリンクを入力します。次に例を示します。

#IMAGE_PREFIX#themes/theme_4/svg.css

b. 「カスタムCSS、インライン」で、上書きするカスタムCSSスタイルを入力します。

関連項目:

- 「カスケード・スタイルシートのアップロードについて」

- 「レガシー・コンポーネント・ビューでのページの表示」

24.2.6.4 SVGチャートのカスタムCSSスタイル・インラインの指定

「チャート属性」ページの「カスタムCSS、インライン」属性を使用して、デフォルトCSS内の特定のスタイルを上書きできます。

デフォルトのCSS内の特定のスタイルを上書きするには、次のステップを実行します。

1. チャートを作成します。

2. ページに移動します。

3. チャート属性ページにアクセスします。

a. 「リージョン」で、リージョン名を選択します。

リージョン定義が表示されます。

b. 「チャート属性」をクリックします。

4. 「CSS」までスクロールします。

5. 「カスタムCSSを使用」で、「はい」を選択します。

6. 「カスタムCSS、インライン」で、上書きするカスタムCSSスタイルを入力します。

関連項目:

- 「SVGチャートのサポートの理解」

- 「レガシー・コンポーネント・ビューでのページの表示」

24.2.6.5 他の言語でのSVGチャートの表示

SVGチャートを他の言語で表示するには、textおよびtspanクラスに正しい言語が反映されるように編集します。

SVGチャートを他の言語で表示するには、次のステップを実行します。

1. ページに移動します。

2. チャート属性ページにアクセスします。

a. 「リージョン」で、リージョン名を選択します。

リージョン定義が表示されます。

b. 「チャート属性」をクリックします。

3. 「CSS」までスクロールします。

4. 「カスタムCSSを使用」で、「はい」を選択します。

5. 「カスタムCSS、インライン」で、textおよびtspanクラスに正しい言語が反映されるように編集します。次の例では、チャートを韓国語に変更する方法を示します。

text{font-family:Batang;fill:#000000;}
tspan{font-family:Batang;fill:#000000;}

関連項目:

「レガシー・コンポーネント・ビューでのページの表示」

24.2.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

24.2.7.1 1つのHTMLチャートのHTML5へのアップグレード

HTMLチャートをHTML5にアップグレードするには、次のステップを実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

アプリケーション・ビルダーのホームページが表示されます。

2. アプリケーションを選択します。

アプリケーションのホームページが表示されます。

3. ページに移動します。

4. チャート属性ページにアクセスします。

a. 「リージョン」で、リージョン名を選択します。

リージョン定義が表示されます。

b. 「チャート属性」をクリックします。

5. 「タスク」リストで、「HTML5チャートへのアップグレード」をクリックします。

6. 「アップグレード」をクリックします。

関連項目:

「レガシー・コンポーネント・ビューでのページの表示」

24.2.7.2 すべてのHTMLチャートのHTML5へのアップグレード

すべてのHTMLチャートをHTML5にアップグレードするには、次のステップを実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

アプリケーション・ビルダーのホームページが表示されます。

2. アプリケーションを選択します。

アプリケーションのホームページが表示されます。

3. 「ユーティリティ」をクリックして、「アプリケーションのアップグレード」をクリックします。

「アプリケーション・サマリーのアップグレード」レポートが表示されます。

4. 「HTMLチャートのHTML5チャートへのアップグレード」で、候補オブジェクトの数をクリックします。

5. アップグレードするオブジェクトを選択し、「アップグレード」をクリックします。

24.2.8 Flashチャートの保存について

イメージの保存をサポートするには、AnyChartはhttp://www.anychart.comに存在するサーバー側スクリプトを使用する必要があります。イメージの保存を試みると、データはBase64エンコーディングでこのサーバーに送信されます。次に、サーバーでデコードされ、デコードされたレスポンスが戻されます。

チャートの保存をローカルでサポートする場合は、デコーディング・スクリプトをローカル・サーバーでホストする必要があります。Flashチャートでは、AnyChart JavaScriptのファンクションgetPNGを使用する必要もあります。デフォルトでは、チャート・リージョンは埋込みHTMLタグを使用し、AnyChart JavaScriptコールを使用しません。AnyChart JavaScriptコールを使用するには、Flashチャートのリージョン・ソースを変更する必要があります。

関連項目:

ローカルでのFlashチャート保存のサポートを追加する方法については、AnyChartユーザーズ・ガイドでイメージまたはベクター・ファイルとしてのチャート保存に関する説明を参照してください。

24.2.9 FlashおよびHTML5チャートとのカスタムXMLの使用

チャート属性ページには、標準の属性で制御できない追加のチャート設定があります。チャートのルック・アンド・フィールをさらに制御するには、カスタムXMLを使用できます。

カスタムXMLを使用するには、次のステップを実行します。

1. チャート属性ページにアクセスします。

a. 「リージョン」で、リージョン名を選択します。

リージョン定義が表示されます。

b. 「チャート属性」をクリックします。

2. 「チャートXML」までスクロールします。

3. 「カスタムXMLの使用」から「はい」を選択します。

カスタムXMLの使用を選択した場合、もう適用されない属性を持つリージョンは非表示となります。これらのリージョンを再度表示するには、「カスタムXMLの使用」で「いいえ」を選択します。

4. XMLを編集します。

5. 「変更の適用」をクリックします。

ヒント:

サポートされているチャートのXML書式の詳細は、次のサイトのオンラインXMLリファレンスを参照してください。

http://6.anychart.com/products/anychart/docs/

24.3 レガシー・マスター・ディテール・フォームの作成

注意:

レガシー・マスター・ディテール・フォームは、レガシー・アプリケーション・コンポーネントです。レガシー・コンポーネントは引き続きOracleでサポートされますが、開発者は1つ以上の対話グリッドを含む新しいマスター・ディテール・フォーマットを使用することをお薦めします。マスター・ディテール・フォームの管理を参照してください。

開発者は、ページの作成ウィザードを使用して、データベースに外部キー・リレーションシップが定義されていない2つの表からレガシー・マスター・ディテール・フォームを作成できます。基礎となるデータベースで外部キーと適切に定義されたリレーションシップを使用することをお薦めしますが、開発者は必ずしも各自のデータベース・モデルを変更できるわけではありません。

レガシー・マスター・ディテール・フォームでは、マスター・ディテール・フォーム・ページに、ユーザーがマスター結果セット内で前後に移動するためのボタンが含まれています。ウィザードの実行中に、どの列でナビゲーションの順序を決定するかを選択します。また、2ページまたは3ページで構成されるマスター・ディテール・フォームを作成し、個別のページの単一レコード編集でレポートに表示される詳細レコードを含めることもできます。

ページの作成ウィザードを使用してレガシー・マスター・ディテール・フォームを作成するには、次のステップを実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「ページの作成」をクリックします。

4. 「ページの作成」で、次のステップを実行します。

a. ユーザー・インタフェース: ページのユーザー・インタフェースを選択します。

b. ページ・タイプの選択: 「レガシー・ページ」を選択します。

c. 「次へ」をクリックします。

5. 「レガシー・マスター・ディテール」を選択して、「次へ」をクリックします。

マスター・ディテールの作成ウィザードが表示されます。

6. 「マスター表と列」で、次のステップを実行します。

a. 表/ビューの所有者: マスター表を所有するスキーマを選択します。

b. 表/ビューの名前: マスター・ページに含める列を含む表またはビューを選択します。

c. 列の選択: マスター・ページに表示する列を選択します。後で列を追加できます。

d. ユーザー・インタフェースのデフォルト値を使用: ユーザー・インタフェースのデフォルト値を使用してフォームを作成するかどうかを選択します。「いいえ」を選択した場合、ウィザードでユーザー・インタフェースのデフォルト値は使用されません。

e. 「次へ」をクリックします。

7. 「ディテール表と列」で、次のステップを実行します。

a. 関連する表のみの表示: ディテール表のリストを、マスター表に関連する表のみに制限するかどうかを指定します。「はい」または「いいえ」を選択します。

b. 表/ビューの所有者: 表またはビューの所有者を選択します。デフォルトで選択された表またはビューの所有者は、アプリケーションの所有者と同一です。アプリケーションの所有者が他のスキーマの表またはビューに対するSELECT権限を持っている場合、他のスキーマを選択できます。

c. 表/ビューの名前: ディテール・ページに含める列を含む表またはビューを選択します。

d. 列の選択: ディテール・ページに表示する列を選択します。後で列を追加できます。

e. 「次へ」をクリックします。

次に、主キーを定義します。フォームでは、データベース内の表の行に対する挿入、更新および削除操作が実行されます。表に定義されている主キー、または表内の行を一意に識別するROWID擬似列のいずれかを使用して、行を識別します。

8. 「主キーの定義」で、次のようにします。

表ごとに1つを選択します。

a. データベースで管理(ROWID): ROWID擬似列を使用して、更新および削除する行を識別します。

b. 主キー列の選択: フォームは、ソース表の主キー列を使用します。選択した場合、「主キー列1」と、オプションで「主キー列2」を指定します。詳細は、フィールドレベル・ヘルプを参照してください。

c. 「次へ」をクリックします。

9. 「マスター・ディテール・リンク」で、次のようにします。

マスター表とディテール表の関係を定義します。列名(表名で完全修飾された名前)を入力するか、またはリストから列名を選択できます。

a. リンク・マスター列: マスター列を選択します。

b. リンク・ディテール列: ディテール列を選択します。

c. 「次へ」をクリックします。

10. 「マスター・オプション」で、次のステップを実行します。

ナビゲーション順の列が定義されていないと、マスターの更新フォームは、主キー列を使用してナビゲートします。デフォルトでは、このウィザードでマスター・レポート・ページが作成されます。すでにレポート・ページがある場合は、マスター・レポート・ページを作成しないように選択できます。

a. マスター行ナビゲーションを含めますか。: 「はい」または「いいえ」を選択します。「はい」を選択した場合は、ナビゲーション順の列を定義します。ナビゲーション順の列が定義されていないと、マスターの更新フォームは、主キー列を使用してナビゲートします。

ナビゲーション順の列が定義されていないと、マスターの更新フォームは、主キー列を使用してナビゲートします。デフォルトでは、このウィザードでマスター・レポート・ページが作成されます。すでにレポート・ページがある場合は、マスター・レポート・ページを作成しないように選択できます。

b. マスター行のナビゲーションの順序: マスター行のナビゲーションの順序を選択します。

c. セカンダリ・ナビゲーションの順序: セカンダリ・ナビゲーションの順序を選択します。

d. マスター・レポートを含めますか。: すでにレポート・ページがある場合は、「いいえ」をクリックします。

e. 「次へ」をクリックします。

11. 「レイアウト」で、次のようにします。

a. 同一ページで表形式フォームとしてディテールの編集: 選択すると、2ページのマスター・ディテールが作成されます。

b. 別のページでディテールの編集: 選択すると、3ページのマスター・ディテールが作成されます。

c. 「次へ」をクリックします。

12. 「ページ属性」で、次のステップを実行します。

注意:

このページでは、マスターおよびディテール・ページの情報が示されます。指定したページが存在しない場合は、そのページが作成されます。

マスター・ページ

a. ページ番号: マスターおよびディテールを表示するページ番号を入力します。ページが存在しない場合は、新しいページが作成されます。

b. ページ・タイトル: 新規ページのページ・タイトルを入力します。ページがすでに存在する場合は、既存のページ名が表示されます。

c. リージョン・タイトル: マスターおよびディテールが含まれるリージョンの名前を入力します。

d. ページ・モード: ページ・モードを指定します。詳細は、フィールドレベル・ヘルプを参照してください。

ディテール・ページ

a. ページ番号: ページ番号を入力します。

b. ページ・タイトル: ページ・タイトルを入力します。

c. 「次へ」をクリックします。

13. ナビゲーション・メニューで、このページをどのようにナビゲーション・メニューに統合するかを選択して、「次へ」をクリックします。詳細は、フィールドレベル・ヘルプを参照してください。

14. 「確認」で、次のようにします。

属性を確かめて、選択を確認します。

15. 「作成」をクリックします。

関連項目:

マスター・ディテール・フォームの管理

24.4 レガシー表形式フォームの管理

注意:

表形式フォームは、レガシー・アプリケーション・コンポーネントです。引き続きサポートされますが、開発者はかわりに対話グリッドを使用することをお薦めします。

レガシー表形式フォームを使用すると、1つのページから表内の複数の行を一度に更新できます。ウィザードを使用して作成したレガシー表形式フォームでは、データベース表内の複数の行に対して更新、挿入および削除操作を実行できます。表形式フォームには、バックグラウンドでコミット時ロックを実行してデータの整合性を維持する組込みの複数行更新プロセスが備わっています。

トピック:

- 表形式フォームの作成について

- 表形式フォームの実行について

- 表形式フォームの仕組み

- レガシー表形式フォームの作成

- 表形式フォームの列の順序とリージョン・ソースの同期

関連項目:

- 「新しいコンポーネントを組み込むためのアプリケーションのアップグレード」

- 対話グリッドの管理

- フォームの開発

24.4.1 表形式フォームの作成について

ウィザードを使用して作成した表形式フォームには、自動DMLプロセスが含まれています。これらのウィザードでは、データベース表内の複数の行に対して更新、挿入および削除操作を実行するフォームを作成します。または、表形式フォームを手動で作成することも可能であり、その場合は、更新可能なレポート・リージョンまたは更新可能な列を含む標準レポート・リージョンのいずれかを作成し、それとともに表形式フォームのデータを処理するカスタムPL/SQLページ・プロセスを使用します。

表形式フォームを作成する場合のベスト・プラクティス

表形式フォームを作成するときには、次のベスト・プラクティスを実施することをお薦めします。

- 表形式フォームのSQL文の選択リストは、ウィザードを使用して生成した後、変更しないでください。問合せを変更する場合は、更新可能な列の値が、Application Expressエンジンによってデータベースから問い合せられた後に変更されていないことを確認してください。

- 表示タイプ特有のJavaScriptロジックを使用する表示タイプにカスタムJavaScriptを追加しないでください(ラジオ・グループ、単純なチェック・ボックス、ポップアップ・キーLOVなど)。

24.4.2 表形式フォームの実行について

表形式フォームを実行すると、データは更新可能な列を含むレポートとしてレンダリングされます。これらの列は、様々なフォーム要素(テキスト・フィールド、テキスト領域、日付ピッカー、選択リスト、ラジオ・グループなど)を使用して示されます。

デフォルトでは、日付列は「日付ピッカー」アイテム・タイプを使用して作成されます。他の列については、ユーザー・インタフェースのデフォルト値を定義しておくことで、LOVに基づく選択リスト、または数値フィールドと大きなテキスト領域として自動的に作成できます。

数値フィールドおよび日付フィールドについては、日付と数値の書式マスクを事前に定義したり、初期フォームの生成後にそれらの書式マスクを適用することもできます。

また、各レポートには、(行セレクタと呼ばれる)チェック・ボックス列も含まれています。ユーザーは、この行セレクタを使用して1つ以上の列を選択し、データを更新または削除します。行を追加するには、「行の追加」をクリックします。

ヒント:

列属性を編集して、特定の列の外観を制御できます。

関連項目:

Oracle Application Express SQLワークショップ・ガイドの「ユーザー・インタフェースのデフォルト値の管理」

24.4.3 表形式フォームの仕組み

表形式フォームは、基礎となる表の列に問合せ列が関連付けられているSQL問合せに基づきます。単一レコードとは異なり、表形式フォームではデータはセッション・ステートに格納されません。表形式フォーム・ページが送信されると、表形式フォームのデータは組込みのデータ操作言語(DML)またはカスタムPL/SQLページ・プロセスを使用して処理されます。

自動DMLを備えた表形式フォームでは、複数行操作に対して次の2つのプロセスが使用されます。

- 複数行の更新(MRU)プロセスでは、作成操作と更新操作を実行します。

- 複数行の削除(MRD)プロセスでは、1つ以上の行に対するリクエストを削除します。

MRUプロセスとMRDプロセスでは、基礎となる表名と主キー列を参照します。DMLプロセスで正しいレコードを識別できるようにするには、主キー列を表形式フォームのSQL問合せに含め、レポート列を非表示にするか、表示専用(ステートを保存)にする必要があります。新しいレコードの場合、主キー値をNULLにして、新しいレコードとして識別されるようにする必要があります。削除操作は、削除対象の行の行番号を参照することによって実行されます。ユーザーが、カレント・ページ上の1つ以上の行をチェックし、「削除」ボタンをクリックすると、行番号によって対応する主キー値が識別され、一致する行が削除されます。

ウィザードによって生成される表形式フォームの組込みDMLには、更新の喪失を回避するためのチェックサム列が含まれています。コミット時ロックと呼ばれる方法を使用すると、表形式フォームのレンダリング時に各行のチェックサムが計算されます。このチェックサムは、表形式フォームの特別な非表示列に格納されます。更新のためにフォームを送信すると、データベースに格納されている現在のデータで追加のチェックサム・セットが計算されます。表形式フォームの初回レンダリング時に構築されたチェックサムと新しいチェックサムが比較され、不一致が見つかった場合、更新は拒否されます。これは、表形式フォームがレンダリングされてからデータが送信されるまでの間に、データベース内のデータが別のユーザーまたは別のプロセスによって変更されたためです。

また、ウィザードによって生成される表形式フォームでは、一部の列に対して検証が自動的に作成されます。検証は、基礎となる表でNOT NULLに設定されている列、およびタイプがNUMBER、DATEまたはTIMESTAMPの列に対して作成されます。ユーザーの選択または定義済のユーザー・インタフェースのデフォルト値に基づいて、列が読取り専用に設定されている場合、検証は作成されません。

24.4.4 レガシー表形式フォームの作成

ページの作成ウィザードを使用して、既存のアプリケーションに表形式フォームを追加します。表形式フォームの基となる表の名前を指定すると、その表の列がデータベース・データ・ディクショナリから読み取られます。表に定義されている主キー、または表内の行を一意に識別するROWID擬似列のいずれかを指定できます。主キーを選択する場合は、3種類の主キーのソース・タイプ(トリガー、PL/SQLファンクションおよび順序)の中から選択できます。

ヒント:

表形式の作成時には、汎用列テンプレートを使用し、列レポート・テンプレートは使用しないことをお薦めします。

ページの作成ウィザードを使用して表形式フォームを作成するには、次のステップを実行します。

注意:

レガシー表形式フォームは、レガシー・アプリケーション・コンポーネントです。レガシー・コンポーネントは引き続きOracleでサポートされますが、かわりに対話グリッドを作成することをお薦めします。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「ページの作成」をクリックします。

4. 「ページの作成」で、次のステップを実行します。

a. ユーザー・インタフェース: ページのユーザー・インタフェースを選択します。

b. 「レガシー・ページ」を選択します。

c. 「次へ」をクリックします。

5. 「表形式フォーム」を選択して、「次へ」をクリックします。

表形式フォームの作成ウィザードが表示されます。

6. 「ページ属性」で、次のステップを実行します。

a. 実装: レポート実装タイプを選択します。

b. レポート・ページ番号: 新しいページ番号を指定した場合、ウィザードによって新しいページが作成されます。既存のページ番号を指定した場合、ウィザードによってそのページにコンポーネントが追加されます。

c. レポート・ページ名: レポートを含むページのタイトルを入力します。

d. フォーム・ページ・モード: ページ・モードを指定します。詳細は、フィールドレベル・ヘルプを参照してください。

e. ブレッドクラム: ページでブレッドクラム・ナビゲーション・コントロールを使用するかどうか、およびどのブレッドクラム・ナビゲーション・コントロールを使用するかを選択します。

f. 「次へ」をクリックします。

7. ナビゲーション・メニューで、このページをどのようにナビゲーション・メニューに統合するかを選択して、「次へ」をクリックします。詳細は、フィールドレベル・ヘルプを参照してください。

8. 「データ・ソース」は、次のようにします。

a. 表/ビューの所有者: 表形式フォームのベースにする表またはビューの所有者を選択します。

b. 表/ビューの名前: 表形式フォーム・リージョンに含める列を含む表またはビューを選択します。

c. レポートに表示される列の選択: 表形式フォームに含める1つ以上の列を選択します。その後のページで、どの列を更新可能にするかを定義します。

d. 「次へ」をクリックします。

次に、主キーを定義します。表形式フォームでは、データベース内の表の行に対する挿入、更新および削除操作が実行されます。表に定義されている主キー、または表内の行を一意に識別するROWID擬似列のいずれかを使用して、行を識別します。

9. 「フォーム・ページ」で、主キーについて次のいずれかを選択します。

- データベースで管理(ROWID): 表形式フォームは、ROWID擬似列を使用して、更新および削除する行を識別します。

- 主キー列の選択: 表形式フォームは、ソース表の主キー列を使用します。

10. 「データベースで管理(ROWID)」を選択した場合は、「次へ」をクリックして続行します。

11. 「主キー列の選択」を選択した場合は、次のようにします。

a. 主キー列1: 主キーの最初の列を選択します。

b. 主キー列2: 複合主キーが含まれている場合は、この属性の2つ目の主キー列を指定します。この属性はオプションです。

c. 「主キー列1のソース」で、主キーの移入方法を選択します。

- 既存のトリガー: 挿入前トリガーによって主キーが移入される場合は、このオプションを選択します。このオプションは、フォームを完成させた後に主キー列ソースを指定する場合も選択できます。

- 既存の順序: 選択されているスキーマで使用可能な順序のリストから順序を選択する場合は、このオプションを選択します。

d. 「作成」をクリックします。

関連項目:

- 「レポート・テンプレート」

- 対話グリッドの管理

24.4.5 表形式フォームの列の順序とリージョン・ソースの同期

クラシック・レポートの列の順序を、リージョン・ソースの問合せで定義された列の順序と同期化するには、次のステップを実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 表形式フォームを含むページを選択します。

4. コンポーネント・ビューでページを表示します。

5. レポート属性ページにアクセスするには、表形式フォーム・リージョンの横にある「レポート」リンクをクリックします。

6. 「タスク」から、「列の順序とリージョン・ソースの同期化」を選択します。

7. 「同期化」をクリックします。

関連項目:

レガシー・コンポーネント・ビューでのページの表示

24.5 レガシー・カレンダの管理

ヒント:

レガシー・カレンダは、レガシー・アプリケーション・コンポーネントです。レガシー・コンポーネントは引き続きサポートされていますが、新しいカレンダを作成することをお薦めします。現在のリリースでは、カレンダはFullCalendar jQueryライブラリに基づいています。

レガシー・カレンダはテンプレートベースです。以前のリリースでは、レガシー・カレンダはカレンダ(テンプレート、クラシック・カレンダ、簡易カレンダおよびSQLカレンダ)と呼ばれていました。

トピック:

- レガシー・クラシック・カレンダの作成

- レガシー・コンポーネント・ビューでのカレンダの管理

- レガシー・カレンダでサポートされているカレンダ置換文字列について

関連項目:

「カレンダの作成」

24.5.1 レガシー・クラシック・カレンダの作成

ヒント:

レガシー・カレンダは、レガシー・アプリケーション・コンポーネントです。レガシー・コンポーネントは引き続きサポートされていますが、新しいカレンダを作成することをお薦めします。現在のリリースでは、カレンダはFullCalendar jQueryライブラリに基づいています。

ヒント:

ページの作成ウィザードを実行してレガシー・カレンダを作成するときに、ドラッグ・アンド・ドロップ機能を有効化するために、オンデマンド・ページ・プロセスを手動で作成する必要があります。

ページの作成ウィザードを実行してレガシー・カレンダを作成するには、次のステップを実行します。

ヒント:

属性の詳細は、フィールドレベル・ヘルプを参照してください。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「ページの作成」をクリックします。

4. 「ページの作成」で、次のステップを実行します。

a. ユーザー・インタフェース: ページのユーザー・インタフェースを選択します。

b. 「レガシー・ページ」を選択します。

c. 「次へ」をクリックします。

5. 「レガシー・カレンダ」を選択し、「次へ」をクリックします。

カレンダ・ページの作成ウィザードが表示されます。

6. 「ページ属性」で、次のステップを実行します。

a. ページ番号: 新しいページ番号を指定した場合、ウィザードによって新しいページが作成されます。既存のページ番号を指定した場合、ウィザードによってそのページにコンポーネントが追加されます。

b. ページ名: 作成するページのタイトルを入力します。

c. ページ・モード: ページ・モードを選択します。詳細は、フィールドレベル・ヘルプを参照してください。

d. リージョン・テンプレート: 新しいカレンダ・リージョンのリージョン・テンプレートを選択します。テンプレートは、リージョンの外観を制御します。

e. リージョン名: カレンダを含めるリージョンの名前を入力します。

f. 表示タイプ: カレンダの動作を決定します。オプションは次のとおりです。

- 標準: ページが、関連するリクエストとともに送信されます。

- 部分ページ・リフレッシュ: 「カレンダ」リージョンのみがリフレッシュされます。

ヒント:

カレンダが作成されると、表示タイプは変更できません。表示タイプを変更するには、カレンダを削除してから、再作成する必要があります。

g. ブレッドクラム: ページでブレッドクラム・ナビゲーション・コントロールを使用するかどうか、およびどのブレッドクラム・ナビゲーション・コントロールを使用するかを選択します。

h. 「次へ」をクリックします。

7. 「ナビゲーション・メニュー」で、このページに含めるナビゲーションのタイプを指定し、「次へ」をクリックします。ナビゲーション・オプション(ナビゲーション・メニューまたはタブなど)はカレント・アプリケーションのテーマに応じて決まります。

8. 「ソース」で、カレンダ・ソースが表かSQL問合せかを選択します。

カレンダ・ソースが「表」の場合:

a. 所有者: カレンダの作成元の表を所有するデータベース・スキーマを選択します。

b. 表/ビューの名前: カレンダで使用する表を指定します。

c. 「次へ」をクリックします。

カレンダ・ソースが「SQL問合せ」の場合:

a. SQL問合せ: カレンダで使用するSQL SELECT文を入力します。SQL SELECT文には2列以上を含める必要があり、そのうち1つはDATE列にする必要があります。

たとえば、詳細はフィールドレベル・ヘルプを参照してください。

b. 「次へ」をクリックします。

9. 「カレンダ属性」で、次のステップを実行します。

a. 日付列: カレンダにエントリを配置する際に、日付として使用する列を指定します。

b. 表示列: カレンダに表示する列を指定します。

c. 日付書式: カレンダの日付の表示方法を指定します。オプションは次のとおりです。

- 日付のみ: 結果は月次およびリスト・カレンダで表示されます。

- 日付と時間: 結果は月次、週次、日次およびリスト・カレンダで表示されます。

d. カスタム日付範囲: カスタムの開始日および終了日を含めるかどうかを指定します。1か月を超える分を月次カレンダに表示できるようにする場合に、このオプションを使用します。

e. 「次へ」をクリックします。

次に、カレンダ・エントリの「リンクの詳細」を定義します。「リンク・ターゲット」により、ユーザーがカレンダ・エントリを選択したときのリダイレクト先が決まります。

10. 「リンクの詳細」で、次のステップを実行します。

a. ページ: 現在選択されているページを指定します。

b. リンク・ターゲット: カレンダ・エントリがリンク・ターゲットを持つかどうかを指定します。カレンダ・エントリを選択すると、ユーザーはリンク・ターゲットにリダイレクトされます。選択された「リンク・ターゲット」により、表示される追加属性が決まります。

詳細は、フィールドレベル・ヘルプを参照してください。

c. リンクを次の場所で開く: URLまたはページを開く場所を指定します。

d. 「次へ」をクリックします。

11. 「プロセス・オプション」で、次のようにします。

a. ページ: ページ番号を指定します。

b. 表/ビューの名前: フォームの基になる表の名前を指定します。

c. 「取消」ボタン・ラベル: 「取消」ボタンのラベルを入力します。

d. 「作成」ボタンの表示: ユーザーがフォームを使用した挿入操作を行えるかどうかを指定します。

e. 「作成」ボタン・ラベル: 「作成」ボタンのラベルを入力します。

f. 「保存」ボタンの表示: ユーザーがフォームを使用した更新操作を行えるかどうかを指定します。

g. 「保存」ボタン・ラベル: 「保存」ボタンのラベルを入力します。

h. 「削除」ボタンの表示: ユーザーがフォームを使用した削除操作を行えるかどうかを指定します。

i. 「削除」ボタン・ラベル: 「削除」ボタンのラベルを入力します。

12. 「次へ」をクリックします。

13. 「確認」で、次のようにします。

属性を確かめて、選択を確認します。

14. 「作成」をクリックします。

関連項目:

- カレンダの作成

- 「追加および編集機能を含めるように既存のカレンダを編集」

- 「フィールドレベル・ヘルプの表示」

24.5.2 レガシー・コンポーネント・ビューでのカレンダの管理

重要:

レガシー・コンポーネント・ビューはデフォルトで無効化されています。レガシー・コンポーネント・ビューを有効化するには、ユーザー・プリファレンスを編集します。

作成したレガシー・カレンダは、属性を編集することで表示を変更できます。各カレンダには、2セットの編集可能な属性(リージョン属性とカレンダ属性)があります。リージョン属性は、カレンダのコンテナとして機能するページの領域を定義します。カレンダ属性は、テンプレート、日付列および一般的なカレンダ書式設定を指定します。

トピック:

- コンポーネント・ビューでのカレンダ属性の編集

- 追加および編集機能を含めるように既存のカレンダを編集

- 既存のレガシー・カレンダでのデータのドラッグ・アンド・ドロップの有効化

関連項目:

ユーザー・プリファレンスの編集

24.5.2.1 コンポーネント・ビューでのカレンダ属性の編集

作成したカレンダは、属性を編集することで表示を変更できます。各カレンダには、2セットの編集可能な属性(リージョン属性とカレンダ属性)があります。リージョン属性は、カレンダのコンテナとして機能するページの領域を定義します。カレンダ属性は、テンプレート、日付列および一般的なカレンダ書式設定を指定します。

ヒント:

カレンダの表示を無効にするには、カレンダ・ページで、「毎月」、「毎週」または「毎日」ボタンを削除する必要があります。

カレンダ属性にアクセスするには、次のステップを実行します。

1. 適切なページにナビゲートします。次を参照してください。

2. リージョン定義ページにアクセスします。「リージョン」で、リージョン名を選択します。

リージョン定義が表示されます。これらの属性を使用して、リージョン・タイトルを含め、カレンダを保持するコンテナを変更します。

3. 「カレンダ属性」をクリックします。

カレンダ属性ページが表示されます。

4. 対象となる属性を編集します。

属性の詳細は、フィールドレベル・ヘルプを参照してください。

5. 「変更の適用」をクリックします。

関連項目:

- 「レガシー・コンポーネント・ビューでのページの表示」

- 「フィールドレベル・ヘルプの表示」

24.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. 「変更の適用」をクリックします。

関連項目:

「コンポーネント・ビューでのカレンダ属性の編集」

24.5.2.3 既存のレガシー・カレンダでのデータのドラッグ・アンド・ドロップの有効化

新しいページでレガシー・カレンダを作成する場合は、「ドラッグ・アンド・ドロップ」オプションは表示されません。この機能を有効化するには、オンデマンド・プロセスを作成し、レガシー・カレンダ・ページを作成してから、ページを編集してドラッグ・アンド・ドロップを有効化する必要があります。ベスト・プラクティスとして、カレンダの作成前にこのプロセスを作成しておくことをお薦めします。

カレンダ・データのドラッグ・アンド・ドロップのサポートを有効化するには、次のステップを実行します。

1. オンデマンド・アプリケーション・プロセスを作成します。
このプロセスは、カレンダ・データがドラッグ・アンド・ドロップされたときに実行される必要があります。これには、次の例のようなコードが必要です。

declare
l_date_value         varchar2(32767) := apex_application.g_x01;
l_primary_key_value  varchar2(32767) := apex_application.g_x02;
begin
update EMP set HIREDATE = to_date(l_date_value,'YYYYMMDD HH24MISS')
where ROWID = l_primary_key_value;
end;

2. 「カレンダ属性」にナビゲートします。

3. 「ドラッグ・アンド・ドロップ」まで下にスクロールします。

4. 「プロセス」で、ステップ1で作成したカスタム・ページ・プロセスを選択します。

5. 「変更の適用」をクリックします。

関連項目:

「アプリケーション・プロセスの理解」

24.5.3 レガシー・カレンダでサポートされているカレンダ置換文字列について

アプリケーション・ビルダーでは、多くの日付書式置換文字列がサポートされています。「カレンダ・テンプレート」ページで、サポートされている置換文字列の完全なリストを表示できます。

カレンダでサポートされている置換文字列のリストを表示するには、次のステップを実行します。

1. 該当するカレンダ・テンプレートにナビゲートします。

2. ページの右側の「置換文字列」リストを表示します。

関連項目:

- 「テーマおよびテーマ・スタイルの使用」

- 「レガシー・クラシック・カレンダの作成」

24.6 ギャラリでのレガシー・コンポーネントの表示

デフォルトでは、次のレガシー・コンポーネントはギャラリには表示されません。

- レガシー表形式フォーム

- レガシー・マスター・ディテール・フォーム

- レガシー・クラシック・カレンダ

- レガシーAnyChartチャート

ギャラリにレガシー・コンポーネントを表示するには、次のステップを実行します。

1. 「ワークスペース」ホームページにナビゲートします。

2. 「アプリケーション・ビルダー」アイコンをクリックします。

3. アプリケーションを選択します。

4. ページを選択します。

ページ・デザイナでページが表示されます。

5. 「ギャラリ・メニュー」をクリックして、「レガシー・コンポーネントの表示」を選択します。

A アイテム・タイプについて

アイテムは、HTMLフォームの一部です。アイテムは、テキスト・フィールド、テキスト領域、パスワード、選択リスト、チェック・ボックスなどを示します。開発者がページ・アイテムの機能を制御するには、そのページ・アイテムの属性を編集します。次の表に、アイテムの機能を制御する主な属性の説明を示します。特定のアイテム属性の詳細は、フィールドレベル・ヘルプを参照してください。

トピック:

- 使用可能なアイテム・タイプ

関連項目:

- フィールドレベル・ヘルプの表示

- ページ・レベル・アイテムの理解

- ページ・デザイナでのページ・レベル・アイテムの編集

- コンポーネント・ビューでのページ・レベル・アイテムの編集

A.1 使用可能なアイテム・タイプ

表A-1で、アプリケーション・ビルダーで使用可能なアイテム・タイプについて説明し、アイテムの動作を制御する重要な属性を示します。

表A-1 使用可能なアイテム・タイプ

アイテム・タイプ

説明

チェック・ボックス

複数の値をチェック・ボックスとして表示し、エンド・ユーザーが複数の値を選択できるようにします。チェック・ボックスとして表示されるアイテムには、LOVが必要です。選択されたボックスに対応する値は、1つのコロンで区切られた文字列に格納されます。

注意: はい/いいえのチェック・ボックス(つまり、値が1つのみになるチェック・ボックス)には、切替えアイテム・タイプを使用することをお薦めします。

次の例では、従業員名(ename)が表示されますが、従業員番号(empno)が戻されます。

SELECT ename, empno FROM emp;

参照: 戻り値の分割については、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カラー・コードを直接入力するか、アイコンをクリックしてカラー・パレット・ポップアップを表示します。エンド・ユーザーがパレットで色をクリックすると、選択した色に対応するHTMLカラー・コードが返されます。

注意: このタイプのアイテムを新規作成する場合は、「ポップアップ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出力で表示されます。

ファイル参照

「参照」ボタンが付いたテキスト・フィールドを表示します。ユーザーは「参照」ボタンを使用して、ローカル・ファイル・システムのファイルを検索し、アップロードすることができます。

関連項目: ファイルのアップロードの保護について

ページ・デザイナの属性:

- 設定、記憶域タイプ - アップロードしたファイルの格納場所を指定します。オプションは次のとおりです。

- アイテム・ソース属性で指定されたBLOB列 - 行の自動処理(DML)プロセスによって使用される表およびアイテム・ソース属性で指定された列にアップロードされるファイルを格納します。列はBLOBデータ型である必要があります。ファイルがダウンロードされる場合、行の自動フェッチ・プロセスの表名が使用されます。

- 表APEX_APPLICATION_TEMP_FILES - ビューAPEX_APPLICATION_TEMP_FILESでアクセスできる一時的な場所にアップロードしたファイルを格納します。「ファイルをパージするタイミング」の選択に応じて、Application Expressにより、セッションの最後またはアップロード・リクエストの最後にファイルが自動的に削除されます。

「記憶域タイプ」が「表APEX_APPLICATION_TEMP_FILES」の場合:

- ファイルをパージするタイミング - Application Expressが一時ファイルを削除する時間を定義します。

- 複数ファイルの許可 - 複数のファイルを一度にアップロードするかどうかを指定します。複数のファイル名は、コロンで区切られたリストとしてページ・アイテムに格納されます。

- ファイル・タイプ - ブラウザがアップロードするファイルを制限するために使用できるカンマで区切られたファイル・タイプのリストを指定します。

「記憶域タイプ」が「アイテム・ソースで指定されたBLOB列」の場合:

- MIMEタイプ列 - アップロードされたファイルのMIMEタイプの格納に使用する、ページまたはアプリケーション・アイテム名を大文字で入力します。MIMEタイプは、ファイルをダウンロードするときにBLOBのコンテンツの表示に使用するアプリケーションを識別するために、ブラウザによって使用されます。

- ファイル名列 - アップロードされたファイルのファイル名の格納に使用する、ページまたはアプリケーション・アイテムを入力します。

- 文字セット列 - アップロードされたファイルの文字セットの格納に使用する、ページまたはアプリケーション・アイテム名を大文字で入力します。BLOBのキャラクタ・セットはアップロード時に自動的に設定されません。エンド・ユーザーは、アップロードするドキュメントの文字セットを設定する必要があります。

- BLOB最終更新列 - ファイルのアップロード時の現在のタイムスタンプの格納に使用する、ページまたはアプリケーション・アイテム名を大文字で入力します。この日付値は、ブラウザ・キャッシュに使用されます。

- ダウンロード・リンクの表示 - このアイテムに空でないBLOBが関連付けられている場合にダウンロード・リンクを表示するかどうかを指定します。

- リンク・テキストのダウンロード - ダウンロード・リンクの一部として表示されるテキストを入力します。指定されない場合、共有コンポーネント内のAPEX.FILE_BROWSE.DOWNLOAD_LINK_TEXTのテキスト・メッセージに格納されているテキストが表示されます。

- コンテンツ配置 - ダウンロード時のブラウザによるコンテンツの処理方法を選択します。

- 設定、ファイル・タイプ - ブラウザがアップロードするファイルを制限するために使用できるカンマで区切られたファイル・タイプのリストを指定します。

コンポーネント・ビューの属性:

- 設定、必須の値 - 「はい」を選択し、ページ・アイテムが表示されている場合、Oracle Application Expressでは、ページの送信時にNOT NULL検証が自動的に実行されます。

- 設定、記憶域タイプ - アップロードしたファイルの格納場所を指定します。

- 設定、MIMEタイプ列 - アップロードしたファイルのMIMEタイプが格納される列の名前を指定します。

- 設定、ファイル名列 - アップロードしたファイルのファイル名が格納される列の名前を指定します。

- 設定、文字セット列 - アップロードしたファイルのキャラクタ・セットが格納される列の名前を指定します。

- 設定、BLOB最終更新列 - ファイルのアップロード時に現在のタイムスタンプを使用して更新する列の名前を指定します。

- 設定、ダウンロード・リンクの表示 - 「はい」を選択すると、「参照」ボタンの横にダウンロード・リンクが表示されます。

- 設定、リンク・テキストのダウンロード - ダウンロード・リンクに使用されるテキストです。

- 設定、コンテンツ配置 - ダウンロードしたコンテンツをブラウザ・ウィンドウ内にインラインで表示するか、オープン・ダイアログを表示するかを決定します。

非表示

ページ・ソース内に含まれているが、レンダリングされないアイテム。非表示のアイテム値は、セッション・ステートに保存されます。通常、ページ処理または他のページ・アイテムで必要とされる値の格納に使用されますが、エンド・ユーザーに表示されません。

ページ・デザイナおよびコンポーネント・ビューの属性:

- 設定、保護された値 - 「はい」を選択すると、ページがポストされたときに非表示の値が操作できないようになります。

リスト・マネージャ

ポップアップLOVアイコン、「追加」および「削除」ボタン、選択された値のリストを含むテキスト・アイテムを表示します。

値を入力するか、使用可能なアイテムのリストから選択します。これにより、ボタンを使用して、選択された値を管理できます。選択された値は、1つのコロンで区切られた文字列に格納されます。

ページ・デザイナの属性:

- 設定、フェッチ - ポップアップ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セッション表から値が読み取られる可能性があります。この属性を「いいえ」に設定する場合、「セッション・ステートに暗号化された値を保存」を「はい」に設定することを検討してください。

関連項目: セッション・ステートおよびセキュリティについて

パーセント・グラフ

パーセンテージ・グラフとして値を表示します。取得される値は、0から100までの間である必要があります。

ポップアップLOV

ポップアップLOVアイコン付きのテキスト・アイテムを表示します。エンド・ユーザーがアイコンをクリックすると、検索フィールドおよびサポートされる値のリストを含むポップアップ・ウィンドウが表示されます。

エンド・ユーザーが検索基準を入力して、表示される使用可能な値を絞り込むことができるため、大きなリストにはポップアップLOVが最適です。比較的小さなリストには、多くの場合、選択リストの方が適しています。

SELECT ename name, empno id
FROM emp

いずれかの列が式の場合は、別名を使用します。次に例を示します。

SELECT ename||' '||job display_value, empno FROM emp

ページ・デザイナのアイテム属性:

- 設定、入力フィールド - アイテムが入力可能かどうかを選択します。

- 設定、フェッチ - LOV用のデータの初期フェッチ方法を選択します。

- 検証、必須の値 - 「はい」を選択し、ページ・アイテムが表示されている場合、Oracle Application Expressでは、ページの送信時にNOT NULL検証が自動的に実行されます。詳細は、ヘルプを参照してください。

コンポーネント・ビューのアイテム属性:

- 設定、必須の値 - 「はい」を選択し、ページ・アイテムが表示されている場合、Oracle Application Expressでは、ページの送信時にNOT NULL検証が自動的に実行されます。詳細は、ヘルプを参照してください。

- 設定、入力フィールド - アイテムが入力可能かどうかを選択します。

- 設定、フェッチ - LOV用のデータの初期フェッチ方法を選択します。

関連項目: カスケードLOVの作成およびカスケードLOVの作成

ラジオ・グループ

複数の値をラジオ・ボタン・オプションとして表示し、エンド・ユーザーが1つの値を選択できるようにします。

次の例では、従業員名(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の作成

リッチ・テキスト・エディタ

様々なテキスト書式設定オプションを持つテキスト領域を表示します。エンド・ユーザーは、Microsoft Wordなどのワード・プロセッサを使用した場合と同様の形式で表示されるコンテンツを拡張できます。エンド・ユーザーは、Rich Text Format (RTF)ファイル形式のドキュメントをこのアイテムにカット・アンド・ペーストすることもできます。

ページ・デザイナのアイテム属性:

- 設定、エディタ - 使用可能なテキスト書式設定オプションの表示に使用されるエディタを選択します。

- 設定、ツールバー - エディタ内で使用できるテキスト書式設定オプションの数を選択します。

- 設定、ツールバーの拡張 - テキスト領域内で、エディタを最初に開いておくかどうかを指定します。

- 設定、スキン - エディタのスタイル設定に使用されるエディタ・スキンを選択します。

- 設定、ツールバーの位置 - エディタを表示するテキスト領域内の場所を指定します。

- 検証、必須の値 - 「はい」を選択し、ページ・アイテムが表示されている場合、Oracle Application Expressでは、ページの送信時にNOT NULL検証が自動的に実行されます。詳細は、ヘルプを参照してください。

コンポーネント・ビューのアイテム属性:

- 設定、必須の値 - 「はい」を選択し、ページ・アイテムが表示されている場合、Oracle Application Expressでは、ページの送信時にNOT NULL検証が自動的に実行されます。詳細は、ヘルプを参照してください。

- 設定、エディタ - 使用可能なテキスト書式設定オプションの表示に使用されるエディタを選択します。

- 設定、ツールバー - エディタ内で使用できるテキスト書式設定オプションの数を選択します。

- 設定、ツールバーの拡張 - リッチ・テキスト・エディタをロードするときにツールバーを展開して起動する必要があるかどうかを決定します。

- 設定、スキン - エディタのスタイル設定に使用されるエディタ・スキンを選択します。

- 設定、ツールバーの位置 - エディタを表示するテキスト領域内の場所を指定します。

選択リスト

値セレクタの組込みリスト付きのアイテムを表示します。エンド・ユーザーがアイテムをクリックすると、サポートされる値のリストが現在のアイテムに直接埋め込まれて表示されます。

選択リストは、比較的小さな不連続のリストに最適です。エンド・ユーザーは、ポップアップ・ダイアログにフォーカスを変更する必要なく、非常に迅速にリストから値を選択できます。大きなリストには、ポップアップLOVの使用を検討してください。

select [displayValue],
[returnValue]
from ...
where ...
order by ...

ページ・デザイナのアイテム属性:

- 設定、選択時のページ・アクション - リスト値が選択されたときに実行されるアクションを選択します。オプションのヘルプを参照してください。

- 設定、検証の実行 - 「選択時のページ・アクション」が「ページの送信」に設定されているかどうかを表示します。ページの送信時の検証の実行を制御します。この属性を「いいえ」に設定すると、検証が実行されず、関連エラー・メッセージが表示されません。この属性を「はい」に設定すると、ページの送信時にすべてのページ検証、ビルトイン検証が実行され、関連エラー・メッセージが表示されます。この属性は、検証属性「常に実行」と組み合せて使用します。詳細は、検証の実行タイミングの決定についてを参照してください。

- 検証、必須の値 - 「はい」を選択し、ページ・アイテムが表示されている場合、Oracle Application Expressでは、ページの送信時にNOT NULL検証が自動的に実行されます。詳細は、ヘルプを参照してください。

コンポーネント・ビューのアイテム属性:

- 設定、必須の値 - 「はい」を選択し、ページ・アイテムが表示されている場合、Oracle Application Expressでは、ページの送信時にNOT NULL検証が自動的に実行されます。詳細は、ヘルプを参照してください。

- 設定、選択時のページ・アクション - リスト値が選択されたときに実行されるアクションを選択します。

- 設定、検証の実行 - 「選択時のページ・アクション」が「ページの送信」に設定されているかどうかを表示します。ページの送信時の検証の実行を制御します。この属性を「いいえ」に設定すると、検証が実行されず、関連エラー・メッセージが表示されません。この属性を「はい」に設定すると、ページの送信時にすべてのページ検証、ビルトイン検証が実行され、関連エラー・メッセージが表示されます。この属性は、検証属性「常に実行」と組み合せて使用します。詳細は、検証の実行タイミングの決定についてを参照してください。

シャトル

リストを含む2つのボックスを含む複数の選択リストとして表示します。左のリストには、選択されていない値のソース・リストが表示され、右のリストには、現在選択されている値が表示されます。エンド・ユーザーは、リストで1つ以上の値を選択し、選択した値またはすべての値をシャトル・コントロールを使用して移動できます。

現在の値は、1つのコロンで区切られた文字列に格納されます。

ページ・デザイナのアイテム属性:

- 設定、コントロールの表示 - シャトルの中央に表示するデータ移動コントロールを選択します。オプションは、「なし」、「移動のみ」、「並替えのみ」または「すべて」です。

- 検証、必須の値 - 「はい」を選択し、ページ・アイテムが表示されている場合、Oracle Application Expressでは、ページの送信時にNOT NULL検証が自動的に実行されます。詳細は、ヘルプを参照してください。
注意: このアイテム・タイプを作成するにはLOVを定義する必要があります。アプリケーション・レベルでのLOVの作成、複数選択リスト・アイテムでの操作およびカスケードLOVの作成を参照してください。

コンポーネント・ビューのアイテム属性:

- 設定、必須の値 - 「はい」を選択し、ページ・アイテムが表示されている場合、Oracle Application Expressでは、ページの送信時にNOT NULL検証が自動的に実行されます。詳細は、ヘルプを参照してください。

- 設定、コントロールの表示 - シャトルの中央に表示するデータ移動コントロールを選択します。オプションは、「なし」、「移動のみ」、「並替えのみ」または「すべて」です。
注意: このアイテム・タイプを作成するにはLOVを定義する必要があります。アプリケーション・レベルでのLOVの作成、複数選択リスト・アイテムでの操作およびカスケードLOVの作成を参照してください。

スイッチ

フリップ・トグル・スイッチとして表示します。

ページ・デザイナのアイテム属性:

- 設定、設定 - アプリケーション・レベルのコンポーネント設定が使用されるか、またはこのアイテムのカスタム設定が使用されるかを選択します。オプションには、「コンポーネント設定の使用」または「カスタム」があります。「設定」が「カスタム」に設定されている場合、追加の属性が表示されます。

- 検証、必須の値 - 「はい」を選択し、ページ・アイテムが表示されている場合、Oracle Application Expressでは、ページの送信時にNOT NULL検証が自動的に実行されます。詳細は、ヘルプを参照してください。

コンポーネント・ビューのアイテム属性:

- 設定、必須の値 - 「はい」を選択し、ページ・アイテムが表示されている場合、Oracle Application Expressでは、ページの送信時にNOT NULL検証が自動的に実行されます。詳細は、ヘルプを参照してください。

- 設定、設定 - アプリケーション・レベルのコンポーネント設定が使用されるか、またはこのアイテムのカスタム設定が使用されるかを選択します。オプションには、「コンポーネント設定の使用」または「カスタム」があります。「設定」が「カスタム」に設定されている場合、追加の属性が表示されます。

関連項目: スイッチのデフォルト値の構成

スライダ

jQuery Mobileアプリケーションにのみ適用できます。スライダ・アイテム・タイプを表示します。ユーザーは、コントロールを左または右にスライドすることでアイテム値を更新できます。

ページ・デザイナのアイテム属性:

- 設定、最小値 - 最小許容値を入力します。値は、静的値または置換構文を使用した動的値です。

- 設定、最大値 - 最大許容値を入力します。値は、静的値または置換構文を使用した動的値です。

- 設定、ステップ増分 - スライダを強制的に特定の増分にあわせる値を入力します。値は、静的値または置換構文を使用した動的値です。

- 設定、選択済をハイライト - スライダで、現在のスライダ・ハンドルの位置まで軌跡をハイライトするかどうかを指定します。

- 検証、必須の値 - 「はい」を選択し、ページ・アイテムが表示されている場合、Oracle Application Expressでは、ページの送信時にNOT NULL検証が自動的に実行されます。詳細は、ヘルプを参照してください。

コンポーネント・ビューのアイテム属性:

- 設定、必須の値 - 「はい」を選択し、ページ・アイテムが表示されている場合、Oracle Application Expressでは、ページの送信時にNOT NULL検証が自動的に実行されます。詳細は、ヘルプを参照してください。

- 設定、最小値 - 最小許容値を入力します。値は、静的値または置換構文を使用した動的値です。

- 設定、最大値 - 最大許容値を入力します。値は、静的値または置換構文を使用した動的値です。

- 設定、ステップ増分 - スライダを強制的に特定の増分にあわせる値を入力します。値は、静的値または置換構文を使用した動的値です。

- 設定、選択済をハイライト - スライダで、現在のスライダ・ハンドルの位置まで軌跡をハイライトするかどうかを指定します。

テキスト・フィールド

テキスト・フィールドとしてアイテムを表示します。

ページ・デザイナのアイテム属性:

- 設定、サブタイプ - HTML5テキスト・サブタイプを選択します。これによって、オンスクリーン・キーボードの付いたデバイスで、サブタイプごとに最適化されたキーボード・レイアウトを表示できるため、データ入力が簡単になります。サブタイプの選択は、ページ・アイテムの値を使用して適切なリンクをレンダリングする際にも使用されます(読取り専用でレンダリングされる場合)。物理キーボードを使用する場合、この属性でテキスト・アイテムやデータ・エントリは変更されません。
注意: これはHTML5の機能のため、対応するブラウザでのみ機能します。より古い、HTML5に準拠していないブラウザではこの属性は無視され、ページ・アイテムは通常のテキスト・フィールドとしてレンダリングされます。

- 検証、必須の値 - 「はい」を選択し、ページ・アイテムが表示されている場合、Oracle Application Expressでは、ページの送信時にNOT NULL検証が自動的に実行されます。詳細は、ヘルプを参照してください。

コンポーネント・ビューのアイテム属性:

- 設定、必須の値 - 「はい」を選択し、ページ・アイテムが表示されている場合、Oracle Application Expressでは、ページの送信時にNOT NULL検証が自動的に実行されます。詳細は、ヘルプを参照してください。

- 設定、サブタイプ - HTML5テキスト・サブタイプを選択します。これによって、オンスクリーン・キーボードの付いたデバイスで、サブタイプごとに最適化されたキーボード・レイアウトを表示できるため、データ入力が簡単になります。サブタイプの選択は、ページ・アイテムの値を使用して適切なリンクをレンダリングする際にも使用されます(読取り専用でレンダリングされる場合)。物理キーボードを使用する場合、この属性でテキスト・アイテムやデータ・エントリは変更されません。

- 設定、空白の切捨て - ページの送信後のアイテム値の切捨て方法を選択します。この設定によって、入力されたテキストから、空白、タブおよび改行が切り捨てられます。

- 設定、[Enter]を押すと送信 - このフィールドで[Enter]キーを押すと、ページが自動的に送信されるかどうかを指定します。

- 設定、無効 - このアイテムを無効にし、エンド・ユーザーが値を変更できないようにするかどうかを指定します。HTML書式が削除される「表示のみ」のアイテム・タイプとは異なり、無効なテキスト・アイテムは同じHTML書式で表示されます。無効なテキスト・アイテムはページ・ソースの一部で、そのセッション・ステートを評価できます。反対に、表示のみのアイテムはセッション・ステートに格納されません。

オートコンプリートが有効なテキスト・フィールド

エンド・ユーザーが入力したテキストに基づいてテキスト・アイテムが埋め込まれた、使用可能な値のリストを表示するテキスト・フィールドを表示します。エンド・ユーザーがテキストを入力するにつれてリストが絞り込まれます。

select [displayValue],
[returnValue]
from ...
where ...
order by ...

ページ・デザイナのアイテム属性:

- 設定、検索 - 入力値に対する検索の実行方法を選択します。「遅延ロード」を使用する場合、この設定が問合せのパフォーマンスに影響することがあります。「「次を含む」および「大/小文字を区別」」または「「次を含む」および「大/小文字区別なし」」を選択すると、列索引が使用されません。

- 設定、遅延ロード - 「遅延ロード」手法を使用して、一致する値をデータベースから取得するかどうかを指定します。遅延ロードでは、ユーザーが文字を入力するたびに、一致するレコードがデータベースから取得されます。それ以外の場合、ページをロードするときに、すべてのリスト値がロードされます。多数のレコードのロードによってページの初期ロード時間が影響を受けることがあるため、選択リストが大きい場合、「遅延ロード」を使用することをお薦めします。

- 設定、リスト内の最大値 - 選択ボックスに表示するアイテムの最大数を入力します。この値によって、数の行を返すことによるパフォーマンスの問題を回避でき、数文字のみが入力された場合に戻りセットが非常に大きくなることも避けられます。

- 設定、自動入力 - テキスト・フィールドに最初のオートコンプリート値が自動的に入力されるかどうかを指定します。詳細は、ヘルプを参照してください。

- 設定、最初の選択 - キーボードやマウス・アクションにより手動で選択していない場合でも、エンド・ユーザーが[Tab]/[Return]を押すと、最初のオートコンプリート値が自動的に選択されるかどうかを指定します。手動で選択(ハイライト)された結果がある場合、その結果が優先されます。

- 設定、検索をハイライト - 一致するエントリの選択ボックスで一致するテキストをハイライトするかどうかを指定します。

- 検証、必須の値 - 「はい」を選択し、ページ・アイテムが表示されている場合、Oracle Application Expressでは、ページの送信時にNOT NULL検証が自動的に実行されます。詳細は、ヘルプを参照してください。

コンポーネント・ビューのアイテム属性:

- 設定、必須の値 - 「はい」を選択し、ページ・アイテムが表示されている場合、Oracle Application Expressでは、ページの送信時にNOT NULL検証が自動的に実行されます。詳細は、ヘルプを参照してください。

- 設定、検索 - 入力値に対する検索の実行方法を選択します。「遅延ロード」を使用する場合、この設定が問合せのパフォーマンスに影響することがあります。「「次を含む」および「大/小文字を区別」」または「「次を含む」および「大/小文字区別なし」」を選択すると、列索引が使用されません。

- 設定、遅延ロード - 「遅延ロード」手法を使用して、一致する値をデータベースから取得するかどうかを指定します。遅延ロードでは、ユーザーが文字を入力するたびに、一致するレコードがデータベースから取得されます。それ以外の場合、ページをロードするときに、すべてのリスト値がロードされます。多数のレコードのロードによってページの初期ロード時間が影響を受けることがあるため、選択リストが大きい場合、「遅延ロード」を使用することをお薦めします。

- 設定、リスト内の最大値 - テキスト・フィールドに最初のオートコンプリート値が自動的に入力されるかどうかを指定します。

- 設定、自動入力 - テキスト・フィールドに最初のオートコンプリート値が自動的に入力されるかどうかを指定します。詳細は、ヘルプを参照してください。

- 設定、最初の選択 - キーボードやマウス・アクションにより手動で選択していない場合でも、エンド・ユーザーが[Tab]/[Return]を押すと、最初のオートコンプリート値が自動的に選択されるかどうかを指定します。手動で選択(ハイライト)された結果がある場合、その結果が優先されます。

- 設定、検索をハイライト - 一致するエントリの選択ボックスで一致するテキストをハイライトするかどうかを指定します。

テキスト領域

複数行のテキスト領域を表示します。

アプリケーションの構成によっては、その他のアイテム・タイプ・プラグインもここで使用可能な場合があります。これらは、<My Plug-in> [Plug-in]と表示されます。次のプラグインが、このアプリケーションの共有コンポーネント内にインストールされます。

ページ・デザイナのアイテム属性:

- 設定、サイズ変更可能 - マウスを使用したテキスト領域のサイズ変更が有効かどうかを指定します。

- 設定、高さ自動調整機能 - 表示されるテキストの量に基づいてテキスト領域の高さを変えるかどうかを指定します。テキスト領域をデータ量に応じて決める場合は、このオプションを使用します。

- 設定、文字カウント機能 - 「はい」を選択すると、フィールドに表示された文字数を表示するカウンタが含まれます。

- 検証、必須の値 - 「はい」を選択し、ページ・アイテムが表示されている場合、Oracle Application Expressでは、ページの送信時にNOT NULL検証が自動的に実行されます。

コンポーネント・ビューのアイテム属性:

- 設定、必須の値 - 「はい」を選択し、ページ・アイテムが表示されている場合、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 コンポーネントの制限事項

コンポーネント

制限事項

対話モード・レポート

列ヘッダー・フィルタごとに999行(列属性にカスタムLOVが指定されていない場合)。

関連項目: レポートの開発

フォーム

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 使用可能な条件

条件

説明

行が返される

SQL問合せが1行以上を戻します。

行が返されない

SQL問合せは行を戻しません

SQL式

SQL式はTRUEと評価されます。

PL/SQL式

SQL式はTRUEと評価されます。

PL/SQLファンクション本体

PL/SQLファンクション本体がTRUEを戻します。

リクエスト = 値

ページ・リクエストは値属性に入力したテキストと同じです。

アイテム != 値

ページ・リクエストは値属性に入力したテキストと同じではありません。

リクエストは値に含まれる

ページ・リクエストは値属性に入力したテキストに含まれます。

リクエストは値に含まれない

ページ・リクエストは値属性に入力したテキストに含まれません。

アイテム = 値

選択したアイテムの値は値属性に入力したテキストと同じです。

アイテム != 値

選択したアイテムの値は値属性に入力したテキストと同じではありません。

アイテムはNULL

選択したアイテムの値は空です。

アイテムはNULLではない

選択したアイテムの値は空ではありません。

アイテムは0(ゼロ)

選択したアイテムの値は0(ゼロ)です。

アイテムは0(ゼロ)ではない

選択したアイテムの値は0(ゼロ)ではありません。

アイテムはNULLまたは0(ゼロ)

選択したアイテムの値は空または0(ゼロ)です。

アイテムはNULLでなく、0(ゼロ)でない

選択したアイテムの値は空ではなく、0(ゼロ)でもありません。

アイテムに空白が含まれない

選択したアイテムの値に空白が含まれません。

アイテムは数字

選択したアイテムの値は数値です。

アイテムは数字でない

選択したアイテムの値は数値ではありません。

アイテムは英数字

選択したアイテムの値は英数字で、文字と数字のみが含まれ、特殊文字は含まれません。

アイテムはコロンで区切られたリストに含まれる

選択したアイテムの値は値属性に入力したテキストに完全に含まれます。

アイテムはコロンで区切られたリストに含まれない

選択したアイテムの値は値属性に入力したテキストに完全には含まれません。

ユーザー・プリファレンス = 値

入力したプリファレンスの値は、値属性に入力したテキストと同じです。

ユーザー・プリファレンス != 値

入力したプリファレンスの値は、値属性に入力したテキストと同じではありません。

現在のページ = ページ

現在のページはページに入力した値と同じです。

現在のページ != ページ

現在のページはページに入力した値と同じではありません。

現在のページはカンマで区切られたリストに含まれる

現在のページはページに入力したカンマ区切りリストに含まれます。

現在のページはカンマで区切られたリストに含まれない

現在のページはページに入力したカンマ区切りリストに含まれません。

カレント・ページが「印刷用」モード

現在のページはエンド・ユーザーによって「印刷用」モードに切り替えられています。

カレント・ページは「印刷用」モードではない

現在のページはエンド・ユーザーによって「印刷用」モードに切り替えられていません。

ページ/リージョンは読取り専用

該当する場合、ページまたは親リージョンの「読取り専用」条件はTRUEと評価されます。

ページ/リージョンは読取り専用でない

該当する場合、ページおよび親リージョンは通常どおりに表示されます。

認証済ユーザー(非パブリック・ユーザー)

エンド・ユーザーはアプリケーションにログインしています。

関連項目: 認証の詳細は、認証によるユーザー・アイデンティティの証明を参照してください。

パブリック・ユーザー(認証されていないユーザー)

エンド・ユーザーはアプリケーションにログインしていません。

インライン検証エラーあり

ページ送信後、ページにインライン検証エラーが表示されます。

インライン検証エラーなし

ページにインライン検証エラーが表示されません。

現在の言語 = 値

エンド・ユーザーは現在、「値」属性に入力した言語でアプリケーションを実行しています。

現在の言語 != 値

エンド・ユーザーは現在、「値」属性に入力した言語でアプリケーションを実行していません。

現在の言語は値に含まれる

エンド・ユーザーは現在、「値」属性に入力した言語の1つでアプリケーションを実行しています。

現在の言語は値に含まれない

エンド・ユーザーは現在、「値」属性に入力した言語の1つでアプリケーションを実行していません。

なし

コンポーネントは操作されません。

注意: 条件を「なし」に変更すると、既存の条件は削除されます。コンポーネントを一時的に無効にする場合、ビルド・オプション属性を使用することをお薦めします。

D 付与された権限について

この項では、Oracle Application Expressで付与される権限について説明します。

トピック:

- データベース・ユーザーへの権限の付与について

- PUBLICに付与される権限の理解

D.1 データベース・ユーザーへの権限の付与について

Oracle Application Expressでは、既存のスキーマでワークスペースを作成するときにデータベース・ユーザーに権限が付与されません。直接付与がない場合、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_050100)が所有するパッケージ、プロシージャ、ファンクション、表およびビューに対するEXECUTE権限がPUBLICに付与されています。

トピック:

- パッケージ

- プロシージャ

- ファンクション

- 表

- ビュー

- 順序

- タイプ

D.2.1 パッケージ

パブリック・シノニムが存在し、Oracle Application Express製品スキーマ(たとえば、apex_050100)が所有する次のパッケージに対する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_050100)が所有する次のパッケージに対する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_050100)が所有する次のプロシージャに対する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_050100)が所有する次のファンクションに対するEXECUTE権限がPUBLICに付与されます。

NV

V

Oracle Application Express製品スキーマ(たとえば、apex_050100)が所有する次のファンクションに対するEXECUTE権限がPUBLICに付与されます。

WWV_POPUP_FILTER

D.2.4 表

パブリック・シノニムが存在し、Oracle Application Express製品スキーマ(たとえば、apex_050100)が所有する次の表に対するSELECT権限がPUBLICに付与されます。

WWV_FLOW_DUAL100

WWV_FLOW_TEMP_TABLE

WWV_FLOW_LOV_TEMP

D.2.5 ビュー

パブリック・シノニムが存在し、Oracle Application Express製品スキーマ(たとえば、apex_050100)が所有する次のビューに対する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_CHARTS

APEX_APPLICATION_PAGE_CHART_S

APEX_APPLICATION_PAGE_CHART_A

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_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_PAGE_IG_COLUMNS

APEX_APPL_PAGE_IG_COL_GROUPS

APEX_APPL_PAGE_IGS

APEX_APPL_PAGE_IG_RPTS

APEX_APPL_PAGE_IG_RPT_VIEWS

APEX_APPL_PAGE_IG_RPT_COMPUTES

APEX_APPL_PAGE_IG_RPT_FILTERS

APEX_APPL_PAGE_IG_RPT_COLUMNS

APEX_APPL_PAGE_IG_RPT_HIGHLTS

APEX_APPL_PAGE_IG_RPT_AGGS

APEX_APPL_PAGE_IG_RPT_CHT_COLS

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

索引

A  B  C  D  E  F  G  H  I  J  L  M  N  O  P  Q  R  S  T  U  V  W  X  Z

A

- ページ受入れ 2.4.1

- アクセス制御, 認可スキーム 19.3.4

- アクセス制御リスト

- 概要 19.3

- ユーザーの追加 19.3.3.2

- 作成 19.3.2

- ユーザーの削除 19.3.3.3

- アプリケーション・モードの選択 19.3.3

- ユーザー権限の選択 19.3.3.2

- アカウント・メニュー 1.3.4.3

- アカウント・プロファイル

- パスワードの変更 1.5.1

- 電子メール・アドレスの編集 1.5.1

- 名前の編集 1.5.1

- 写真のアップロード 1.5.1

- アクティビティ・ログ 21.8

- アクティビティ・レポート, カスタムの作成 21.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

- 「フィードバックを許可」属性 6.5.1.2.2

- 「この後に作成されるURLの許可」属性 6.5.2.2.4

- AnyCo IT部門

- 概要 3.4

- インストール 3.4.1

- ナビゲート 3.4.2

- 実行 3.4.1

- APEX_ACTIVITY_LOGビュー 21.8

- APEX_MAIL 18.1.4

- APP_AJAX_X01 2.9.4.6

- APP_AJAX_X10 2.9.4.6

- アプリケーション・ビルダー

- アクセス 1.4.1, 1.4.3

- ホームページ 1.4.2

- ページ 2.1.2

- アプリケーション・ビルダーのホームページ 1.4.1, 1.4.2, 1.4.3

- 「作成」ボタン 1.4.2.2

- 移行リンク 1.4.2.4

- ナビゲーション・バー 1.4.2.1

- 「最近」リスト 1.4.2.3

- 「リセット」ボタン 1.4.2.2

- アプリケーション・ビルダー・ユーティリティ

- アドバイザ 6.13.1

- アプリケーション・ダッシュボード 6.13.1

- Application Expressビュー 6.13.1

- 属性ディクショナリ 6.13.1

- 変更履歴 6.13.1

- データベース・オブジェクトの依存性 6.13.1

- デバッグ・メッセージ 6.13.1

- エクスポート・リポジトリ 6.13.1

- 最近更新されたページ 6.13.1

- アプリケーションのアップグレード 6.13.1

- アプリケーション

- Webサイトからのコンテンツの追加 12.7

- データ・ロードの追加 17.1

- データ・ロード・ウィザードの追加 17.1

- 認可スキームの割当て 19.5.3.1

- 認証スキームの変更 19.4.5, 19.4.6

- ブランチを使用したナビゲーションの制御 14.5

- コピー 1.4.4.6

- 作成 2.1

- デバッグ 21, 22

- プライマリ言語の定義 20.2

- 削除 1.4.4.6

- デプロイ 23.3, 23.4, 23.6.3

- エクスポート 23.4, 23.6.3

- グループ化 6.12

- 非表示機能 23.11.4

- エクスポート・ファイルのインポート 23.7

- SQL*Plusからのインポート 23.8.6

- 言語プリファレンス 20.1.2

- リソース使用 22.3

- 翻訳可能なコンポーネント 20.1.4

- 翻訳 20.1

- マルチバイト言語の翻訳 20.4

- 翻訳のレンダリング 20.1.4

- アップグレード 6.13.3.1, 6.13.3.2

- 「アプリケーションの別名」属性 6.5.1.2.1

- アプリケーション属性

- ビルド・オプション 6.5.1.2.7

- データベース・セッション 6.5.2.2.6

- 編集 6.5.1

- エラー処理 6.5.1.2.4

- エクスポート 23.6.4

- 置換 6.5.1.2.6

- アプリケーションの計算

- 概要 15.6.1

- 作成 15.6.3

- 新しいインスタンス開始時の実行 15.5.2, 15.6.2

- 履歴レポート 15.6.4

- アプリケーション・ダッシュボード 6.13.2

- 「アプリケーション・ダッシュボード」レポート 21.3.2

- 「アプリケーション日付書式」属性 6.5.3.2.4

- 「アプリケーションの日時書式」属性 6.5.3.2.5

- アプリケーション定義, 編集 6.5.1

- Application Expressアカウント認証

- 設定 19.4.3.1.2

- Application Expressビュー 6.13.7

- アプリケーション・グループ 6.12.1

- アプリケーション・グループの属性 6.5.1.2.1

- アプリケーションのヘルプ, 作成 10.4

- アプリケーションのホームページ

- データベース・アプリケーション・ページの追加 6.6.3

- 「エクスポート」/「インポート」アイコン 1.4.4.2

- 「アプリケーションの実行」ボタン 1.4.4.2

- 「共有コンポーネント」アイコン 1.4.4.2

- 「サポートするオブジェクト」アイコン 1.4.4.2

- 「ユーティリティ」アイコン 1.4.4.2

- アプリケーション・ホームの「タスク」リスト

- このアプリケーションのコピー 1.4.4.6

- このアプリケーションの削除 1.4.4.6

- アプリケーション・アイテム

- 概要 13.1.1, 16.5

- 作成 16.5.1

- グローバル変数の作成 16.5.4

- 属性の編集 16.5.3

- 履歴 16.5.2

- アプリケーション言語 6.5.3

- 「アプリケーション言語の導出元」属性 6.5.3.2.2, 20.2

- アプリケーション・レイアウト

- 印刷プレビュー・モード 12.2

- ショートカット 16.8

- 「アプリケーションのプライマリ言語」属性 6.5.3.2.1, 20.2

- アプリケーション・プロセス

- 作成 15.5.5

- エラー・メッセージの作成 15.5.7

- 属性の編集 15.5.6

- 例 15.5.4

- オンデマンド 15.5.1

- レポート 15.5.8

- 理解 15.5

- アプリケーションのタイムスタンプ書式 6.5.3.2.6

- アプリケーションのタイムスタンプ・タイムゾーン書式 6.5.3.2.7

- アプリケーション・ユーティリティ

- アクセス 6.13

- アーキテクチャ 1.2.2

- 非同期更新

- チャート 24.2.4.4, 24.2.5.4

- マップ 10.2.4.4, 10.2.5.4

- 属性ディクショナリ 15.7

- 概要 15.7.1

- アクセス 15.7.2

- 認証 2.4.4, 19.4

- 認証スキーム・リポジトリ 19.4.4

- 変更 19.4.5, 19.4.6

- 認証スキームの作成 19.4.2

- 既存のスキームの管理 19.4.4

- 事前構成された認証スキーム 19.4.3

- レポート 19.4.8

- セキュリティ属性 6.5.2.2.1

- 理解 19.4.1, 19.4.1.1

- カレント・スキームの表示 19.4.5

- 認証レポート

- 認証スキーム履歴 19.4.8

- 認証スキームのサブスクリプション 19.4.8

- 「認証スキーム」属性 6.5.2.2.1

- 「認証スキーム履歴」レポート 19.4.8

- 認証スキーム

- Application Expressアカウント 19.4.3.1

- Cookieユーザー・アカウント 19.4.3.1

- カスタム認証 19.4.3.2

- DAD資格証明 19.4.3.6

- データベース・アカウント資格証明 19.4.3.3

- HTTPヘッダー変数 19.4.3.4

- LDAPディレクトリの検証 19.4.3.5

- 公開資格証明 19.4.3.7

- シングル・サインオン検証 19.4.3.8

- 「認証スキームのサブスクリプション」レポート 19.4.8

- 認可 2.4.5

- 「認可」属性 6.5.2.2.2

- 認可スキーム

- アプリケーションへの割当て 19.5.3.1

- コンポーネントへの割当て 19.5.3.3

- コントロールへの割当て 19.5.3.3

- ページへの割当て 19.5.3.2

- 「コンポーネント別」レポート 19.5.4

- 履歴レポート 19.5.4

- アプリケーション 6.5.2.2.2

- レポート 19.5.4

- 指定 6.5.2.2.2

- 「サブスクリプション」レポート 19.5.4

- 使用状況レポート 19.5.4

- 「認可スキーム」属性 6.5.2.2.2

- 認可スキーム履歴レポート 19.5.4

- 認可スキーム 19.5.1

- アプリケーションへの割当て 19.5.3.1

- コンポーネントへの割当て 19.5.3.3

- コントロールへの割当て 19.5.3.3

- ページへの割当て 19.5.3.2

- 作成 19.5.2

- アクセス制御用 19.3.4

- 認可スキームのサブスクリプション・レポート 19.5.4

- 認可スキームの使用率レポート 19.5.4

- 「自動CSVエンコーディング」属性 6.5.3.2.11

- 自動タイムゾーン 6.5.3.2.10

B

- バインド変数

- 構文 2.8.4

- リージョンでの使用 2.8.4.2

- PL/SQLに基づいたリージョンでの使用 2.8.4.3

- 空白ページ

- アプリケーションの作成ウィザードでの作成 6.1.2

- BLOB

- APEX_UTIL.GET_BLOB_FILE_SRC 8.7.4

- ダウンロード・サポート 9.6.1

- 移入 9.6.1

- サポート 8.7

- フォームでのサポート 9.6

- 手続き的な使用 8.7.4

- フォームでのBLOBサポート

- 概要 9.6.1

- BLOBの表示 9.6.3

- ファイルのダウンロード 9.6.2

- イメージ参照の削除 9.6.4

- ファイルのアップロード 9.6.2

- レポートでのBLOBサポート

- 概要 8.7.1

- BLOBの表示 8.7.3

- ダウンロード・リンクの提供 8.7.2

- 「ブックマーク・ハッシュ関数」属性 6.5.2.2.4

- ブランチ

- 概要 15.4

- 作成 14.5, 14.5.2

- ページ送信 7.3.11

- レンダリング前 7.3.10

- 「対象ボタン」属性 2.9.4.35.2

- BRANCH_TO_PAGE_ACCEPT 2.9.4.35.5

- ブランチ

- 条件付きの作成 14.5.3

- ロード時, ヘッダーの前 14.5.2

- 送信時, プロセス後 14.5.2

- 送信時, 計算の前 14.5.2

- 送信時, プロセス前 14.5.2

- 送信時, 検証の前 14.5.2

- ボタンの使用 13.5.6

- ブレッドクラム・レポート 14.3.7

- ブレッドクラムの例外 14.3.7

- ブレッドクラム階層 14.3.7

- ブレッドクラム履歴 14.3.7

- ブレッドクラムの使用状況 14.3.7

- ブレッドクラムのグリッド編集 14.3.7

- ブレッドクラム

- 概要 14.3.1

- 手動作成について 14.3.3.1

- ブレッドクラム・リージョンの追加 14.3.3.4.1, 14.3.3.4.2

- エントリの追加 14.3.3.3

- ページに追加 14.3.3.4.1, 14.3.3.4.2

- 作成 14.3

- 共有コンポーネントとしての作成 14.3.3.2.1

- 動的な作成 14.3.3.5

- コンポーネント・ビューからの作成 14.3.3.2.3

- リージョンの作成ウィザードでの作成 14.3.3.2.2

- 未使用の削除 14.3.6

- 編集 14.3.4

- 例外レポート 14.3.7

- グリッド編集レポート 14.3.7

- 階層レポート 14.3.7

- 履歴レポート 14.3.7

- ナビゲーション 11.3.9.1

- エントリの親の変更 14.3.5

- 使用状況レポート 14.3.7

- ブレッドクラム・テンプレート 11.3.9

- 定義 11.3.9.2.2

- 名前 11.3.9.2.1

- 置換文字列 11.3.9.2.3

- ブレッドクラム・テンプレートの置換文字列

- #LINK# 11.3.9.2.3

- #LONG_NAME# 11.3.9.2.3

- #NAME# 11.3.9.2.3

- NAME_ESC_SC# 11.3.9.2.3

- 「参照」ボタン A.1

- バグ・レポート

- バグ・ダッシュボード 4.7.5.1

- 日別 4.7.5.4

- 日別ページ 4.7.5.4

- 開発者別 4.7.5.3

- 開発者別ページ 4.7.5.3

- カレンダ・ページ 4.7.5.2

- バグ

- ファイルの添付 4.7.4

- バグ・ページ 4.7.1

- 作成 4.7.2

- 編集 4.7.3

- 管理 4.7

- 表示 4.7.1

- レポートの表示 4.7.5

- ビルド・オプション 23.11

- ステータスの変更 23.11.2

- 作成 23.11.1

- 除外 23.11.2

- エクスポート 23.11.4

- ステータスのエクスポート 23.11.4

- 包含 23.11.2

- レポート 23.11.5

- 「ビルド・オプション」属性 6.5.1.2.7

- 「ビルド・ステータス」属性 6.5.1.2.3

- 組込み置換文字列 2.9.4

- 「アイテム・ヘルプをバルク編集」レポート 10.4.3

- アクセス 10.4.3.1

- ボタン

- ブランチ 13.5.6

- 作成 13.5, 13.5.2.1, 13.5.3.1

- 一度に複数を作成 13.5.3.2

- 複数の削除 13.5.3.3.3.1

- 条件付きの表示 13.5.2.3, 13.5.3.4

- 編集 13.5.2.2, 13.5.2.4, 13.5.3.3

- 複数の編集 13.5.3.3.3

- コンポーネント・ビューでの管理 13.5.3

- ページ・デザイナでの管理 13.5.2

- 名前 13.5.5

- テンプレート 11.3.10

- 保存されていない変更の警告 13.5.2.4

- ボタン・テンプレート

- 定義 11.3.10.1.2

- 名前 11.3.10.1.1

- 置換文字列 11.3.10.1.3

- ボタン・テンプレートの置換文字列

- ##ICON_CSS_CLASSES## 11.3.10.1.3

- #BUTTON_ATTRIBUTES# 11.3.10.1.3

- #BUTTON_CSS_CLASSES# 11.3.10.1.3

- #BUTTON_ID# 11.3.10.1.3

- #LABEL# 11.3.10.1.3

- #LINK# 11.3.10.1.3

C

- 「キャッシュ」属性 6.5.2.2.5

- リージョンのキャッシュ 12.5.2.5, 12.6.3.5

- カレンダ

- 属性へのアクセス 10.1.5.1, 24.5.2.1

- カレンダの追加 10.1.3

- 新しいページへの追加 10.1.3

- 初期化JavaScriptコードの追加 10.1.5.3

- 作成 10.1

- ページ・デザイナでの作成 10.1.4

- レガシー・カレンダの作成 24.5

- レガシー・クラシック・カレンダの作成 24.5.1

- 属性の編集 10.1.5

- ドラッグ・アンド・ドロップの有効化 10.1.5.4

- 追加および編集ファンクションの追加 10.1.5.2, 24.5.2.2

- Googleカレンダとの統合 16.2.2

- レガシー・コンポーネント・ビューでの管理 24.5.2

- サポートされる置換文字列 24.5.3

- サンプルの表示 10.1.2

- カレンダ属性

- アクセス 10.1.5.1, 24.5.2.1

- カスケード・スタイルシート

- 概要 11.3.1

- SVGチャートの参照 24.2.6.3

- インラインの参照(SVGチャート) 24.2.6.4

- ページ・テンプレートでの参照 11.4.2

- アップロード 11.4.1

- カスタムの使用 11.4

- 「変更履歴」レポート 6.13.5

- 文字の値の比較 6.5.3.2.8

- 文字の値の比較動作 6.5.3.2.9

- チャート

- アプリケーションの作成ウィザードでの作成 6.1.2

- チャート

- Flashについて 24.2.1.2

- ウィザードについて 24.2.2.1

- ページへの追加 10.3.4.1, 24.2.4.1, 24.2.5.1

- 新しいページへの追加 10.3.3

- レガシーAnyChartチャートの作成 24.2.3

- 表示の変更 10.3.4.2, 24.2.4.2, 24.2.5.3

- 非同期更新 24.2.4.4, 24.2.5.4

- 自動リフレッシュ 10.3.4.4

- 自動リフレッシュ属性

- 有効化 10.3.4.4.1

- ローソク足構文 24.2.2.6

- チャート構文 24.2.2.1

- 作成 10.3

- アプリケーションの作成ウィザードでの作成 6.1.2

- カスタムJavaScript 10.3.5

- ダイアル・チャート構文 24.2.2.2

- 他の言語でのSVGチャートの表示 24.2.6.5

- 動的アクション 10.3.4.4

- 属性の編集 10.3.4.2, 24.2.4.2, 24.2.5.3

- 非同期更新の有効化 24.2.4.4.1, 24.2.5.4.1

- ガント構文 24.2.2.7

- HTML5チャートについて 24.2.1.1

- HTMLチャートのサポート 24.2.7

- レガシー 24.2

- コンポーネント・ビューでの管理 24.2.5

- ページ・デザイナでの管理 10.3.4, 24.2.4

- SVGのFlashへの移行 24.2.6.1.2

- 情報の監視 24.2.4.4, 24.2.5.4

- 複数シリーズ構文 24.2.2.3

- SQL問合せの指定 24.2.2.1

- レンジ構文 24.2.2.4

- 散布構文 24.2.2.5

- SQL問合せ構文 24.2.2

- SVGチャートのサポート 24.2.6

- Flashへの切替え 24.2.4.3, 24.2.5.2

- タイプ 24.2.2.1

- すべてのSVGチャートのHTML5へのアップグレード 24.2.6.1.3

- 1つのSVGチャートのHTML5へのアップグレード 24.2.6.1.2

- HTML5へのSVGチャートのアップグレード 24.2.6.1

- チャートの同期更新

- リフレッシュ動的アクションの作成 10.3.4.4.2, 24.2.4.4.2, 24.2.5.4.2

- チャート属性の編集 24.2.4.4.1, 24.2.5.4.1

- チャート構文 24.2.2.1

- チャート・タイプ

- ページ・デザイナでの切替え 10.3.4.3

- チェック・ボックス A.1

- 依存LOVの作成 13.3.2.3

- クラシック・カレンダ・テンプレート

- コメント 11.3.11.2.3

- 日次カレンダ 11.3.11.2.3

- 月次カレンダ 11.3.11.2.3

- 名前 11.3.11.2.1

- テンプレート・サブスクリプション 11.3.11.2.2

- 週次カレンダ 11.3.11.2.3

- クラシック・レポート

- ダウンロード・リンクの追加 8.5.1.8, 8.5.2.5

- 変更 8.5.1, 8.5.2

- 位置の変更 8.5.1, 8.5.2

- 列属性の変更 8.5.1, 8.5.2

- 列テキストの変更 8.5.1, 8.5.2

- ページ区切りの変更 8.5.1.3, 8.5.2.3

- 列ブレークの制御 8.5.1.12, 8.5.2.12

- 列の表示の制御 8.5.1.10, 8.5.2.11

- 作成 8.2.1

- 合計の作成 8.5.1, 8.5.2

- 更新可能な列の作成 8.5.1.9, 8.5.2.9

- LOVとしての列定義 8.5.1.11, 8.5.2.10

- 属性の編集 8.5.1.2, 8.5.2.1

- レポート・レイアウトの編集 8.5.1.1, 8.5.2.2

- エクスポート 8.5.1.5, 8.5.2.7

- 列の非表示 8.5.1, 8.5.2

- 列のソート 8.5.1, 8.5.2

- 列の順序とリージョン・ソースの同期化 8.5.2.13, 24.4.5

- クラシック・レポート・リージョン

- 出力属性の構成 8.6.4

- 出力メソッド 8.6.3

- クラシック・レポート

- 概要 8.1.3

- PL/SQLコードのクリーンアップ 6.5.2.2.6

- コレクション 17.2

- カラー・ピッカー A.1

- 表示スタイルの構成 16.2.1, 16.2.3

- 列テンプレート, JavaScriptの使用 11.3.17.4

- 「コメント」属性 24.1.5.2.15

- コミット・ポイント 2.4.2

- 「互換性モード」属性 6.5.1.2.2

- コンポーネント

- 認可スキームの割当て 19.5.3.3

- アクセス制御 2.4.5

- すべてのページでの表示 12.3

- 各ページでの表示 12.1

- メッセージの翻訳 20.6, 20.6.2, 20.6.4

- コンポーネント, 可用性の管理 19.1.8.3

- コンポーネント設定

- スライダの追加 16.2.5

- カラー・ピッカー 16.2.1, 16.2.3

- Googleカレンダとの統合 16.2.2

- 対話モード・レポートの「アクション」メニュー 16.2.4

- 管理 16.2

- デフォルトの切替え 16.2.6

- 履歴レポートの表示 16.2.7

- コンポーネント・ビュー

- ページ制御の追加 24.1.4.3

- ブランチ 24.1.3.4

- ブレッドクラム 24.1.3.5

- ボタン 24.1.3.3

- 計算 24.1.3.4

- ダイアログ属性の構成 24.1.5.5

- 「コピー」アイコン 24.1.4.2

- ページのコピー 24.1.8

- 作成, 開発者のコメント 24.1.3.2

- 作成, ページ 24.1.3.2

- 作成, コピーとしてのページ 24.1.3.2

- 作成, 共有コンポーネント 24.1.3.2

- 作成, チーム開発 24.1.3.2

- 「作成」アイコン 24.1.4.2

- 「作成」メニュー 24.1.3.2

- アプリケーション・ページの削除 24.1.9

- 「すべて編集」アイコン 24.1.4.2

- 「すべて編集」アイコン 24.1.4.2

- アイテム 24.1.3.3

- LOV 24.1.3.5

- リスト 24.1.3.5

- リージョン・タイトルを翻訳可能に指定 20.1.5.4.2

- ナビゲーション・バー 24.1.3.5

- 「次のページ」ボタン 24.1.3.2

- ページ 24.1.3.3

- 「ページ・デザイナ」ボタン 24.1.3.2

- ページ・セレクタ 24.1.3.2

- 「前のページ」ボタン 24.1.3.2

- プロセス 24.1.3.4

- リージョン 24.1.3.3

- ページの実行 24.1.6

- セキュリティ 24.1.3.5

- タブ 24.1.3.5

- テンプレート 24.1.3.5

- テーマ 24.1.3.5

- 使用 24.1.4

- ユーティリティ 24.1.3.2

- ユーティリティ, アプリケーション・ユーティリティ 24.1.3.2

- ユーティリティ, 属性ディクショナリ 24.1.3.2

- ユーティリティ, キャッシュ 24.1.3.2

- ユーティリティ, クロス・ページ・ユーティリティ 24.1.3.2

- ユーティリティ, 削除 24.1.3.2

- ユーティリティ, ページの削除 24.1.3.2

- ユーティリティ, エクスポート 24.1.3.2

- ユーティリティ, 履歴 24.1.3.2

- ユーティリティ, ページ・グループ 24.1.3.2

- フィールドレベル・ヘルプの表示 1.7.4.1

- コンポーネント・ビュー, ページ属性 24.1.5

- 認証 24.1.5.2.9

- 認可スキーム 24.1.5.2.9

- ブラウザ・キャッシュ 24.1.5.2.9

- キャッシュ・ページ 24.1.5.2.11

- キャッシュ・ページ条件 24.1.5.2.11

- キャッシュ・タイムアウト 24.1.5.2.11

- コメント 24.1.5.2.15

- 構成 24.1.5.2.12

- CSS, インライン 24.1.5.2.4

- カーソル・フォーカス 24.1.5.2.2

- ディープ・リンク 24.1.5.2.9

- ダイアログ, 属性 24.1.5.2.5

- ダイアログ, CSSクラス 24.1.5.2.5

- ダイアログ, 高さ 24.1.5.2.5

- ダイアログ, 最大幅 24.1.5.2.5

- ダイアログ, 幅 24.1.5.2.5

- 表示属性 24.1.5.2.2

- 重複送信 24.1.5.2.10

- エラー処理 24.1.5.2.13

- エラー処理ファンクション 24.1.5.2.13

- 式1 24.1.5.2.11

- ファイルURL 24.1.5.2.4

- フッター 24.1.5.2.6, 24.1.5.2.7

- フォームのオートコンプリート 24.1.5.2.9

- グループ 24.1.5.2.1

- ヘッダーおよびフッター 24.1.5.2.7

- ヘッダー・テキスト 24.1.5.2.6, 24.1.5.2.7

- ヘルプ 24.1.5.2.14

- インライン・エラー通知テキスト 24.1.5.2.13

- JavaScript, ページ・ロード時に実行 24.1.5.2.3

- JavaScript, ファイルURL 24.1.5.2.3

- JavaScript, ファンクションおよびグローバル変数の宣言 24.1.5.2.3

- 名前 24.1.5.2.1

- ページの別名 24.1.5.2.1

- ページCSSクラス 24.1.5.2.2

- ページ・モード 24.1.5.2.2

- ページ・テンプレート・オプション 24.1.5.2.2

- 読取り専用 24.1.5.2.8

- セッションを再結合 24.1.5.2.9

- セキュリティ 24.1.5.2.9

- サーバー・キャッシュ 24.1.5.2.11

- タイトル 24.1.5.2.2

- コンポーネント・ビュー, ページ・プロセス

- ブランチ 24.1.3.4

- 計算 24.1.3.4

- プロセス 24.1.3.4

- コンポーネント・ビュー, ページ・レンダリング

- ボタン 24.1.3.3

- 動的アクション 24.1.3.3

- アイテム 24.1.3.3

- ページ 24.1.3.3

- プロセス 24.1.3.3

- リージョン 24.1.3.3

- コンポーネント・ビュー, 共有コンポーネント

- ブレッドクラム 24.1.3.5

- LOV 24.1.3.5

- リスト 24.1.3.5

- ナビゲーション・バー 24.1.3.5

- セキュリティ 24.1.3.5

- タブ 24.1.3.5

- テンプレート 24.1.3.5

- テーマ 24.1.3.5

- 「コンポーネント・ビュー」タブ

- ボタンの追加 7.3.8

- アイテムの追加 7.3.8

- リージョンの追加 7.3.8

- コンポーネント・ビュー・ツールバー

- 概要 24.1.3.1

- 作成, チーム開発 24.1.3.1

- ページの編集 24.1.3.1

- 共有コンポーネント 24.1.3.1

- 条件付き

- 処理 2.4.3

- レンダリング 2.4.3

- 条件

- リージョンの表示 12.6.3.2.1

- リスト C.1

- 使用 2.4.3

- ボタンでの使用 13.5.2.3, 13.5.3.4

- 条件タイプ 2.4.3.2

- 構成, コントロール 23.11

- 確認ページ

- 作成について 12.6.1

- 制御, アクセス制御 2.4.5

- アプリケーションの作成ウィザード 2.1

- 概要 6.1.1

- 列切替えレポートの追加 6.1.2

- 空白ページの追加 6.1.2

- チャートの追加 6.1.2

- 列切替えレポートの追加 8.2.1.1

- 編集可能対話グリッドの追加 6.1.2

- フォームの追加 6.1.2

- リスト・ビュー・レポートの追加 6.1.2

- マスター・ディテールの追加 6.1.2

- リフロー・レポートの追加 6.1.2

- レポートの追加 6.1.2

- レポートとフォームの追加 6.1.2, 8.2.1.1

- レポートの追加 8.2.1.1

- フォームの作成 9.2.3

- リスト・ビューとフォームの作成 8.2.1.1

- リスト・ビュー・レポートの作成 8.2.1.1

- リフロー・レポートの作成 8.2.1.1

- レポートの作成 8.2.1.3

- 編集可能対話グリッド 8.2.1.1

- ページ・タイプ 6.1.2

- レポート・オプション 8.2.1.1

- ブランチの作成ウィザード 14.5, 14.5.2

- ナビゲーション・バー・エントリの作成ウィザード 10.4.4, 14.4.2.1, 14.4.2.2, 14.4.3

- ページ計算の作成ウィザード 15.1.1, 15.1.3.1, 17.3.10.1

- ページ・プロセスの作成ウィザード 15.3.3.1

- ページの作成ウィザード 6.6.1

- 対話グリッドの追加 9.2.1

- マスター・ディテールの追加 9.2.1

- ブレッドクラム 12.6.1

- カレンダ 12.6.1

- チャート 12.6.1

- アクセス制御リストの作成 6.6.2

- ウィザードの作成 6.6.2

- 空白ページの作成 6.6.2

- カレンダの作成 6.6.2

- チャートの作成 6.6.2

- クラシック・レポートの作成 8.2.1.2

- 列切替えレポートの作成 8.2.1.2

- データ・ロード・ウィザードの作成 6.6.2

- データ・ロード・ウィザードの作成

- データ・ロード・ウィザード 17.1.1

- フィードバック・ページの作成 6.6.2

- プロシージャのフォームの作成 9.2.1

- SQL問合せのフォームの作成 9.2.1

- プロシージャのフォームの作成 9.2.1

- SQL問合せのフォームの作成 9.2.1

- 表のフォームの作成 9.2.1

- Webサービスのフォームの作成 9.2.1

- フォームの作成 9.2.2

- グローバル・ページの作成 6.6.2

- 対話グリッドの作成 8.2.1.2

- 対話モード・レポートの作成 8.2.1.2

- レガシー・ページの作成 6.6.2

- リスト・ビューの作成 8.2.1.2

- プラグインの作成 6.6.2

- リフロー・レポートの作成 8.2.1.2

- 表のレポートとフォームの作成 8.2.1.2

- Webサービスのレポートとフォームの作成 9.2.1

- Webサービスのレポートの作成 8.2.1.2

- レポートの作成 8.2.1.4

- 表のリスト・ビュー付きのレポートの作成 9.2.1

- 表のフォーム付きレポートの作成 9.2.1

- 1ページのマスター・ディテールの作成 9.2.1

- ツリーの作成 6.6.2

- ページの作成ウィザードでの作成 9.2.1

- ウィザードの作成 6.6.2

- データ・ロード・ウィザード

- 作成されたページについて 17.1.1

- データ・ロード定義 17.1.1

- Webサービスのフォームとレポート 12.6.1

- Webサービスのフォームとレポート 9.2.1

- SQL問合せのフォーム 12.6.1

- 表のフォーム 9.2.1

- Webサービスのフォーム 12.6.1

- Webサービスのフォーム 9.2.1

- フォーム・オプション 9.2.1

- リスト 12.6.1

- マップ 12.6.1

- プラグイン 12.6.1

- レポート・オプション 8.2.1.2

- サマリー・ページ 12.6.1

- ツリー 12.6.1

- リージョンの作成ウィザード 10.2.5.1, 12.6.2, 12.6.3.9.2, 12.6.4, 14.3.3.4.2, 16.7.6, 24.2.5.1

- 列切替えレポートの追加 12.6.1

- リフロー・レポートの追加 12.6.1

- クラシック・レポート 12.6.1

- ブレッドクラムの作成 14.3.3.2.2

- フォームの作成 9.2.5

- プロシージャのフォーム 12.6.1

- 表のフォーム 12.6.1

- リスト・ビュー付きの表のフォーム 12.6.1

- ヘルプ・テキスト 12.6.1

- 対話モード・レポート 12.6.1

- リスト・ビュー 12.6.1

- 複数の静的コンテンツ 12.6.1

- PL/SQL動的コンテンツ 12.6.1

- リージョン表示セレクタ 12.6.1

- Webサービスの結果のレポート 12.6.1

- 静的コンテンツ 12.6.1

- URL 12.6.1

- 検証の作成ウィザード 15.2.3.1, 15.2.3.2, 15.2.3.3, 15.2.3.4

- クロス・ページ・ユーティリティ

- アクセス 6.13.9

- 複数のページの削除 6.13.9

- すべてのページのグリッド編集 6.13.9

- ページ属性 6.13.9

- ページ・ロック 6.13.9

- クロスサイト・スクリプティング

- 概要 19.2.3.1

- 安全なアイテム・タイプについて 19.2.3.2.2

- 動的出力 19.2.3.3

- 値のエスケープ 19.2.3.2.3

- HTMLリージョン 19.2.3.2

- 動的出力の保護 19.2.3.3

- フォーム・アイテムの保護 19.2.3.5

- レポート・リージョンの保護 19.2.3.4

- レポート・リージョン 19.2.3.4

- アイテムでの文字の制限 19.2.3.6

- 静的表示領域 19.2.3.2

- セッション・ステート保護の理解 19.2.5

- 安全なアイテム・タイプの使用 19.2.3.2.4

- CSSクラス, SVGチャート 24.2.6.2

- CSSファインダ 6.7

- カスタム認証

- 設定 19.4.3.2.2

- カスタム・パッケージ・アプリケーション

- 概要 23.5.1

- サポートするオブジェクト・ページの概要 23.5.2.2

- アクセス制御リストの追加 23.5.3

- ビルド・オプション 23.5.2.2.1

- サポートするオブジェクトの作成 23.5.2

- アップグレード・スクリプトの定義 23.5.6.1

- 削除スクリプト 23.5.2.2.3

- 削除 23.5.7

- インストール・オプションの削除 23.5.5

- メッセージの削除 23.5.5

- サポートするオブジェクトのスクリプトの削除 23.5.5

- 作成方法 23.5

- インストール・スクリプト 23.5.2.2.1

- サポートするオブジェクトのインストール 23.5.4

- メッセージ 23.5.2.2.1, 23.5.2.2.3

- 前提条件 23.5.2.2.1

- 置換文字列 23.5.2.2.1

- インストール・スクリプトのテスト 23.5.4

- アップグレード・メッセージ 23.5.2.2.2

- アップグレード・スクリプト 23.5.2.2.2

- アップグレード 23.5.6.2

- 検証 23.5.2.2.1

- インストール・サマリーの表示 23.5.8

D

- DAD資格証明の検証

- 設定 19.4.3.6.2

- データベース・アカウント資格証明認証

- 設定 19.4.3.3.2

- データベース・アプリケーション

- 概要 2.1.3.1

- ページの追加 6.6

- コンポーネントの追加 6.6.1

- ページの追加 6.6.1

- グループへの割当て 6.12.3

- 問合せに基づく 6.2.1

- スプレッドシートに基づく 6.2.2

- コピー 6.2.3

- アプリケーション・ホームページからのコピー 6.2.3.2

- アプリケーションの作成ウィザードでのコピー 6.2.3.1

- グループの作成 6.12.2

- 表での作成 6.2.1

- 削除 6.4, 6.4.1, 6.4.2

- グループ 6.12.1

- グループからの削除 6.12.4

- 実行 2.3

- データベース・アプリケーション・グループ

- ページの割当て 6.12.3

- 作成 6.12.2

- 削除 6.12.5

- ページの削除 6.12.4

- データベース・アプリケーション・ページ 24.1.9

- 追加 6.6

- グループへの割当て 6.8.4

- コンポーネント・ビューでのコピー 24.1.8

- ページ・デザイナでのコピー 7.7

- アプリケーションのホームからの作成 6.6.3

- 削除 7.8

- 範囲の削除 24.1.9.4

- コンポーネント・ビューでの削除 24.1.9.1, 24.1.9.2

- ページ・デザイナでの削除 7.8.1

- 複数の削除 7.8.2, 24.1.9.3

- 範囲の削除 7.8.3

- ロック・ステータスの判別 6.9.1

- グループ化 6.8

- ロック 6.9, 6.9.2

- 管理 6.6

- 競合の回避 6.9

- グループからの削除 6.8.5

- 実行 2.3

- ロック解除 6.9, 6.9.3

- データベース・アプリケーション・ページ・グループ 6.8.2

- ページの割当て 6.8.4

- 作成 6.8.2

- グループ定義の編集 6.8.3

- 削除 6.8.6

- ページの削除 6.8.5

- 表示 6.8.1

- データベース・リンク 17.4

- 概要 17.4.1

- 作成 17.4.2

- 既存のデータベース・リンクの表示 17.4.3

- 「データベース・オブジェクトの依存性」レポート 6.13.6

- 「データベース・セッション」属性 6.5.2.2.6

- データベース・ユーザー

- 付与される権限 D.1

- 権限の付与 D.1

- データ・ロード

- 追加 17.1

- データ・ロード・ウィザード

- 作成について 17.1.1

- アプリケーションへの追加 17.1

- 作成 17.1.2

- ページの作成ウィザードでの作成 17.1.1

- ページの再作成 17.1.3

- 日付ピッカー A.1

- DBMS_APPLICATION_INFO 22.3

- デバッグ 21, 22

- エラーのチェック 22.1

- 有効化および無効化 22.5.2

- 問題の特定 22.6

- アプリケーションでの実行 22.5.3

- SQL問合せ 21.2.3

- SQLトレース 22.4

- デバッグ・モードの使用 22.5

- f?pを使用したアクセス 22.5.5

- 実行時のレポート表示 22.5.6

- 開発モードでのレポート表示 22.5.4

- 「デバッグ」属性 6.5.1.2.2

- デバッグ・レポート

- 表示 22.5.7

- ディープ・リンク 19.4.1.2

- 「ディープ・リンク」属性 6.5.2.2.3

- 認可スキームの定義 6.5.2.2.2

- 定義 17.3.2.2

- エクスポート・ファイルの削除 23.8.5

- デモンストレーション・アプリケーション

- サンプル・データベース・アプリケーションについて 3.3

- デプロイメント 23.4

- サポートするオブジェクトの作成 23.5.2

- ページのエクスポート 23.6.6

- アプリケーション定義のエクスポート 23.6.3

- Webシートのエクスポート 23.6.7

- フィードバックのエクスポート 23.6.12

- スクリプト・ファイルのエクスポート 23.6.13

- 静的ファイルのエクスポート 23.6.8

- テーマのエクスポート 23.6.9, 23.6.10

- 「ユーザー・インタフェースのデフォルト値」のエクスポート 23.6.11

- ワークスペースのエクスポート 23.6.5

- SQL*Plusからのアプリケーションのインポート 23.8.6

- エクスポート・ファイルのインポート 23.7

- ファイルのインポート 23.7

- アプリケーション・エクスポートのインストール 23.8.3

- ファイルのインストール 23.8.4

- データベース・オブジェクトの管理 23.4.1

- アプリケーション 23.3

- オプション 23.3.2

- URLの公開 23.9

- Webシート・アプリケーションURLの公開 23.10

- プロセスの理解 23.3

- 開発者コメント

- ページ・デザイナでの追加 6.10

- アプリケーションへの追加 6.10.2

- アプリケーションへの追加 6.10.2

- 削除 6.10.4

- 編集 6.10.3

- 表示 6.10.3

- レポートの表示 6.10.5

- 開発者コメントのカレンダ 6.10.6

- 開発者ナビゲーション・ツール

- 概要 1.3.4

- アカウント・メニュー 1.3.4.3

- 「管理」メニュー 1.3.4.2

- グローバル検索 1.3.4.1

- 「ヘルプ」メニュー 1.3.4.2.1

- 開発者ツールバー

- セッション 2.6.4

- 開発プロセス

- 管理 4

- 開発プロセス, 管理 4

- ダイアル・チャート構文 24.2.2.2

- ダイアログ

- 属性の構成 24.1.5.5

- ページ・デザイナでの属性の構成 7.4.4

- ダイアログ・ページ 6.6.4

- ブランチ処理について 6.6.4.7

- サポート対象について 6.6.4.1

- ダイアログ・ページ・テンプレートの作成 6.6.4.2.1

- 定義 6.6.4.3, 6.6.4.4

- 取消動的アクションの生成 6.6.4.5

- 「ダイアログを閉じる」ページ・プロセスの生成 6.6.4.6

- リフレッシュ・アクションの処理 6.6.4.8

- モーダル・ダイアログ 6.6.4.1

- 非モーダル・ダイアログ 6.6.4.1

- 必須のテンプレート属性 11.3.14.2

- ダイアログ・ページ・テンプレートの使用 6.6.4.2

- ダイアログ・ページ・テンプレート 6.6.4.2.1

- ダイアログ・ページ・テンプレート属性 11.3.14.2

- DML

- ロックについて 17.5

- APEX_DML_LOCK_WAIT_TIME 17.5.2

- FSP_DML_LOCK_ROW 17.5.3

- ドキュメント

- 概要 1.7.1

- アクセス 1.7

- 「文書方向」属性 6.5.3.2.3

- ドキュメント

- ダウンロード 1.7.3

- 動的アクション

- カレンダ 10.1.6

- 動的アクション

- アクションの追加 13.4.5.3

- 作成 13.4.4.1, 13.4.5.1

- デバッグ 13.4.7

- 削除 13.4.4.4

- 編集 13.4.4.2, 13.4.5.2

- 頻度と有効範囲 13.4.4.3, 13.4.5.4

- 管理 13.4

- コンポーネント・ビューでの管理 13.4.5

- ページ・デザイナでの管理 13.4.4

- 理解 13.4.1

- 動的リスト

- 作成について 16.7.4

- 最初から作成 16.7.4.3

- 構文 16.7.4.2

- 動的翻訳 20.7

E

- 編集可能対話グリッド 9.1.1

- アプリケーションの作成ウィザードでの作成 6.1.2

- 「すべて編集」アイコン 24.1.4.2

- アプリケーション定義の編集

- フィードバックを許可 6.5.1.2.2

- アプリケーションの別名 6.5.1.2.1

- アプリケーション・グループ 6.5.1.2.1

- ビルド・ステータス 6.5.1.2.3

- 互換性モード 6.5.1.2.2

- デバッグ 6.5.1.2.2

- 電子メール送信者アドレス 6.5.1.2.2

- エラー処理, デフォルトのエラー表示位置 6.5.1.2.4

- エラー処理, エラー処理ファンクション 6.5.1.2.4

- グローバル通知 6.5.1.2.5

- ロギング 6.5.1.2.2

- 使用できないアプリケーションに対するメッセージ 6.5.1.2.3

- 「名前」属性 6.5.1.2.1

- プロキシ・サーバー 6.5.1.2.2

- アクセスの制限 6.5.1.2.3

- ステータス 6.5.1.2.3

- バージョン 6.5.1.2.1

- アプリケーション定義の編集ページ

- 概要 6.5.1.2

- アクセス 6.5.1.1

- アプリケーションの編集ページ

- データベース・セッション 6.5.2.2.6

- グローバリゼーション属性の編集 6.5.3

- アプリケーション日付書式 6.5.3.2.4

- アプリケーションの日時書式 6.5.3.2.5

- アプリケーション言語の導出元 6.5.3.2.2

- アプリケーションのプライマリ言語 6.5.3.2.1

- アプリケーションのタイムスタンプ書式 6.5.3.2.6

- アプリケーションのタイムスタンプ・タイムゾーン書式 6.5.3.2.7

- 自動CSVエンコーディング 6.5.3.2.11

- 自動タイムゾーン 6.5.3.2.10

- 文字の値の比較 6.5.3.2.8

- 文字の値の比較動作 6.5.3.2.9

- 文書方向 6.5.3.2.3

- セキュリティ属性の編集 6.5.2

- アクセス 6.5.2.1

- 認証 6.5.2.2.1

- 認可 6.5.2.2.2

- セッション管理 6.5.2.2.3

- セッション・ステート保護 6.5.2.2.4

- 電子メール

- インスタンスの構成 18.1.1.2

- 電子メール・ログ 18.1

- 電子メール・キュー 18.1

- 有効化 19.1.6.2

- 管理 18.1

- APEX_MAILパッケージでの送信 18.1.4

- 「電子メール送信者アドレス」属性 6.5.1.2.2

- 埋込みPL/SQLゲートウェイ

- セキュリティの実行 19.1.4

- 「フレームへの埋込み」属性 6.5.2.2.5

- エンジン 1.2.2

- エラー・メッセージ

- ページ・プロセス用の作成 15.3.2.4, 15.3.3.4

- アプリケーション・プロセス用の作成 15.5.7

- エラー, 処理 6.5.1.2.4, 24.1.5.2.13

- 「ブックマークの無効化」属性 6.5.2.2.4

- エクスポート

- アプリケーション 23.6.3

- アプリケーション属性 23.6.4

- ビルド・オプション・ステータス 23.6.4

- データベース・アプリケーション 23.6

- データベース・アプリケーション・コンポーネント 23.6

- フィードバック 23.6.12

- データベース・オブジェクトの管理 23.4.1

- ページ 23.6.6

- ページ・コンポーネント 23.6.4

- プラグイン 23.6.10

- スクリプト・ファイル 23.6.13

- 共有コンポーネント 23.6.4

- 静的ファイル 23.6.8

- 翻訳用テキスト 20.5.2

- テーマ 23.6.9, 23.6.10

- ユーザー・インタフェースのデフォルト値 23.6.11

- Webシート 23.6.7

- ワークスペース 23.6.5

- 「エクスポート」/「インポート」アイコン 1.4.4.2

- エクスポートしたアプリケーション, インポート 23.7

- エクスポート・リポジトリ 23.8.3, 23.8.4, 23.8.5

- アクセス 23.8.2

F

- f?p構文 2.7.2

- 機能レポート

- 承認ステータス 4.4.6.6

- カレンダ・ページ 4.4.6.2

- 変更履歴 4.4.6.3

- 機能ユーティリティ 4.4.6.8

- フォーカス領域 4.4.6.5

- 所有者 4.4.6.7

- 進捗ログ 4.4.6.4

- ツリー・ページ 4.4.6.1

- 機能

- ファイルの添付 4.4.5

- 作成 4.4.2

- 追跡 4.4

- 更新 4.4.4

- 表示 4.4.1

- レポートの表示 4.4.6

- 機能ユーティリティ

- マイルストンの割当て 4.9.4

- 期日を超過した機能のマイルストンの変更 4.9.4

- マイルストン日付への機能の期日の設定 4.9.4

- 機能ユーティリティ

- オープンな機能の期限のプッシュ 4.9.4

- フィードバック

- ページの追加 4.8.2

- フィードバック・ページ 4.8.1

- コメントの確認 4.8.4

- 使用 4.8.3

- 表示 4.8.1

- レポートの表示 4.8.5

- フィードバック・レポート

- カレンダ 4.8.5.1

- タグ・クラウド4.3

- フィールドレベル・ヘルプ 1.7.4

- コンポーネント・ビューでの表示 1.7.4.1

- ページ・デザイナでの表示 1.7.4.2

- ファイル・アップロード表

- セキュリティ・リスク 19.2.6

- 「検索」アイコン 6.7, 6.7.1, 24.1.3.1

- Flashチャート

- 新しいページへの追加 24.2.3

- ローソク足構文 24.2.2.6

- ガント構文 24.2.2.7

- 複数シリーズ構文 24.2.2.3

- レンジ構文 24.2.2.4

- ローカルへの保存 24.2.8

- 散布構文 24.2.2.5

- カスタムXMLの使用 24.2.9

- フォーカス領域

- 編集 4.9.5

- フッター, 置換文字列 12.5.2.3, 12.6.3.3

- フォーム

- アプリケーションの作成ウィザードでの作成 6.1.2

- アプリケーションの作成ウィザードでの作成 6.1.2

- フォーム

- レガシー・マスター・ディテール・フォーム 24.3

- 表のフォーム 9.1.2

- フォーム

- 行の自動処理(DML)プロセス 9.2.4.2.1

- 表形式フォームの作成 24.4

- 手動作成 9.2.4

- 1ページのマスター・ディテールの作成 9.4.3

- 2ページのマスター・ディテールの作成 9.4.4

- ページの作成ウィザードを使用した作成 9.2.2

- アプリケーションの作成ウィザードでの作成 9.2.3

- リージョンの作成ウィザードでの作成 9.2.5

- 編集可能対話グリッド 9.1.1

- 表のフォーム 9.1.2

- マスター・ディテールの管理 9.4

- マスター・ディテール 9.4.1

- 移入 9.2.4.3

- プロセスの理解 9.2.4.2

- タイプの理解 9.1

- 入力の検証 9.5

- 完全開発環境 1.2.3

- ファンクション, 検索 6.7.6

G

- ギャラリ

- 概要 7.2.3.2

- 使用 7.3.5, 7.3.6, 7.3.7

- レガシー・コンポーネントの表示 24.6

- 「ギャラリ」メニュー

- レガシー・コンポーネントの表示 24.6

- グローバリゼーション

- 属性 20.2

- アプリケーション言語の判別 6.5.3

- 書式マスク 20.3

- 理解 20.1

- 「グローバル通知」属性 6.5.1.2.5

- グローバル・ページ 12.3

- 作成 12.3.1

- ナビゲート 12.3.2

- グローバル・テンプレート・オプション・グループ 11.3.6.1

- 作成 11.3.6.1.1

- 編集 11.3.6.1.2

- グローバル・テンプレート・オプション

- 作成 11.3.6.3.1

- 編集 11.3.6.3.2

- 管理 11.3.6.2

- グローバル・テンプレート 11.1.7.2.8

- グローバル変数, 作成 16.5.4

- グラフィック

- 管理 12.8

- 翻訳が必要なグリッドのメッセージ

- 対話グリッド 20.6.3

- グループ

- アプリケーション 6.12

- データベース・アプリケーション・ページ 6.8

H

- ヘルプ

- アクセス 1.7

- 作成 10.4

- ナビゲーション・バー・エントリの作成 10.4.4

- 編集 10.4.3

- 検索 1.7

- 使用 1.7

- 「ヘルプ」メニュー 1.3.4.2.1

- ヘルプ・テキスト

- アイテムの定義 10.4.2.4

- ページ用の定義 10.4.2.3

- バルク編集 10.4.3

- アイテムの編集 10.4.3

- シード 10.4.3.2

- 非表示アイテム A.1

- HTML

- カスタムPL/SQLを使用した生成 12.9

- Application Expressの処理対象外 12.9

- HTML5チャート

- 概要 24.2.1.1

- 新しいページへの追加 24.2.3

- 複数シリーズ構文 24.2.2.3

- Flashチャートへの切替え 24.2.4.3, 24.2.5.2

- カスタムXMLの使用 24.2.9

- HTMLチャート

- すべてのHTMLチャートのHTML5へのアップグレード 24.2.7.2

- HTML5へのアップグレード 24.2.7.1

- 「HTMLエスケープ・モード」属性 6.5.2.2.5

- HTMLパスワード・フォーム要素 A.1

- HTMLテキスト領域 A.1

- HTTPヘッダー変数認証

- 設定 19.4.3.4.2

- 「HTTPレスポンス・ヘッダー」属性 6.5.2.2.5

I

- イメージ, URLからの表示 A.1

- イメージ・ファインダ 6.7

- 「イメージ接頭辞」属性 6.5.4.2.1

- イメージ・リポジトリ 12.8

- イメージ

- 管理 12.8

- 検索 6.7.7

- 使用可能の表示 6.7.7

- イメージ・ファインダ 6.7.7

- 実装

- プラグイン 18.2

- インポート

- フィードバック 23.7.7

- Webシート 23.7.3

- インポート

- アプリケーション 23.7.1

- SQL*Plusを使用するアプリケーション 23.8.6

- エクスポート・ファイル 23.7

- ページ 23.7.1

- プラグイン 23.7.4

- テーマ 23.7.5

- ユーザー・インタフェースのデフォルト値 23.7.6

- 初期化PL/SQLコード 6.5.2.2.6

- インジェクション攻撃, アイテムでの文字の制限 19.2.3.6

- インストール

- ネットワーク・サービスの有効化 19.1.11

- インストール

- アプリケーション・ファイル 23.8.3

- エクスポート・ファイル 23.8.4

- アプリケーション・エクスポートのインストール 23.8.3

- エクスポート・ファイルのインストール 23.8.4

- インスタンス・プロキシ, 指定 19.1.5.4

- インスタンスの設定

- 構成 19.1.6

- 電子メールの構成 18.1.1.2

- 対話グリッド

- 作成 8.2.1

- ページの作成ウィザードでの作成 9.2.1

- 管理 8.3

- 翻訳が必要なメッセージ 20.6.3

- 対話グリッドのメッセージ, 翻訳 20.6.3

- 対話グリッド

- 概要 8.1.1

- ページ区切りの制御 8.3.2.3

- 列リンクの作成 8.3.3.3

- マスター・ディテール・フォームの作成 8.3.1.2

- 実行時のカスタマイズ 8.3.4

- ツールバーのカスタマイズ 8.3.2.4

- LOVとしての列定義 8.3.3.2

- レポートの削除 8.3.5.8

- 条件付きの表示 8.3.1.3

- 属性の編集 8.3.2.1

- 列属性の編集 8.3.3.1

- 詳細ビューの有効化 8.3.2.8

- アイコン・ビューの有効化 8.3.2.7

- パブリック・レポートの保存の有効化 8.3.2.5

- 編集可能にする 8.3.2.2

- 列属性の管理 8.3.3

- リージョン属性の管理 8.3.1, 8.3.2

- 保存されたレポートの名前変更 8.3.5.7

- レポートのリセット 8.3.5.9

- パブリック・レポートの保存の制限 8.3.2.6

- 保存 8.3.5

- 保存および認証 8.3.5.2

- 構成の依存関係の保存 8.3.5.2

- プライマリ・レポートの保存 8.3.5.5

- プライベート・レポートの保存 8.3.5.3

- パブリック・レポートの保存 8.3.5.4

- ユーザーの保存オプション 8.3.5.1

- 対話モード・レポート・フィルタ 8.4.4.3

- 編集 8.4.4.3

- 有効化および無効化 8.4.4.3

- 削除 8.4.4.3

- 詳細の表示および非表示 8.4.4.3

- 対話モード・レポート・メッセージ, 翻訳 20.6.4.4

- 対話モード・レポート・リージョン

- 出力属性の構成 8.6.5

- 対話モード・レポート

- 概要 8.1.2

- リンク列について 8.4.1.9, 8.4.2.6

- 検索バーについて 8.4.4.1

- 「アクション」メニュー 8.4.4.2

- 構造の構成 16.2.4

- ダウンロード・オプションの追加 8.4.1.8, 8.4.2.5.4

- 詳細属性 8.4.1.16, 8.4.2.13

- 属性 8.4.1.4

- 属性ページ 8.4.2.1.1

- ページ区切りの変更 8.4.1.5, 8.4.2.4

- 列属性 8.4.1.2, 8.4.2.2

- 「アクション」メニュー構造の構成 16.2.4

- 作成 8.2.1

- 列リンクの作成 8.4.1.10, 8.4.2.7

- グループの作成 8.4.2.3

- リージョンの作成ウィザードでの作成 12.6.1

- 実行時のカスタマイズ 8.4.4

- LOVとしての列定義 8.4.1.12, 8.4.2.9

- 開発者として削除 8.4.2.14.2

- プライベート・レポートの削除 8.4.4.4.6

- パブリック・レポートの削除 8.4.4.4.6

- 条件付きの表示 8.4.1.11, 8.4.2.8

- 開発者としての編集 8.4.1, 8.4.2

- 電子メール送信者アドレス 8.4.1.16.1, 8.4.2.13.1

- アイコン・ビューの有効化 8.4.1.14, 8.4.2.11

- エクスポート 8.4.1.8, 8.4.2.5.4

- 条件付きリンクのフィルタ処理 8.4.1.3

- 列の書式設定 8.4.1.13, 8.4.2.10

- 無効なリンクの例 8.4.3.6

- リンクの制限 8.4.3.4

- リンク付け 8.4.3

- キャッシュのクリア構文を使用したリンク 8.4.3.3

- 名前および値の構文を使用したリンク 8.4.3.2

- Request構文を使用したリンク 8.4.3.1

- 開発者として管理 8.4.2.14

- 保存済レポートの管理 6.13.11

- サブスクリプションの管理 6.13.11

- 翻訳が必要なメッセージ 20.6.4.4

- リージョン別名 8.4.1.16.1, 8.4.2.13.1

- プライベート・レポートの名前変更 8.4.4.4.5

- パブリック・レポートの名前変更 8.4.4.4.5

- レポートIDアイテム 8.4.1.16.1, 8.4.2.13.1

- 保存 8.4.4.4

- 代替の保存 8.4.4.4.4

- 代替レポートの保存 8.3.5.6

- プライベートとして保存 8.4.4.4.3

- パブリックとして保存 8.4.4.4.3

- プライマリ・デフォルトの保存 8.4.4.4.4

- ユーザーの保存オプション 8.4.4.4.1

- フィルタの使用 8.4.4.3

- 有効なリンクの例 8.4.3.5

- 開発者として表示 8.4.2.14.2

- 保存済のレポートのアクティビティの表示 8.4.2.15

- 内部メッセージ, 翻訳が必要 20.6.4.3

- IPアドレス, アクセスの制限 19.1.5.3

- ワークスペースの分離, 概要 19.1.5.8

- アイテム

- ネーミング規則 13.1.2

- 値の参照 13.1.3

- 検索 6.7.2

- 翻訳時に書式マスクを使用 20.3

- アイテム・ファインダ 6.7, 6.7.2

- アイテム・ヘルプ

- 複数トピックの編集 10.4.3.1

- アイテム・ヘルプ

- 編集 10.4.3

- 表示 1.7.4

- アイテム・タイプ

- チェック・ボックス 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

- テキスト領域 A.1

- テキスト・フィールド A.1

- オートコンプリートが有効なテキスト・フィールド A.1

J

- JavaScript 11.3.14.1.11

- コンポーネント・ビューを使用した追加 24.1.5.3

- ページ・デザイナを使用した追加 7.4.2

- ボタンからのコール 13.5.4

- .jsファイルに追加 11.3.2

- ページ・テンプレートに追加 11.3.2

- 組込み 13.7

- 行テンプレート内 11.3.17.4

- ライブラリ 11.3.14.1.11

- 参照アイテム 13.1.4

- jQueryライブラリの参照 18.3.3

- アイテムへのフォーカスの設定 24.1.5.2.2

- 動的アクションの使用 13.4.6

- プラグインでの使用 18.3.3.2

- jQueryの使用 18.3.3.1

- JavaScriptファインダ 6.7

- jQuery

- サポート 18.3

- JavaScriptでの使用 18.3.3.1

- jQuery Mobile 6.3.1

- サポート 6.3.1

- jQuery UI

- 他のjQuery UIコンポーネントへのアクセス 18.3.2.1

- 使用可能な機能 18.3.2

- サポート 18.3

- jsTree, サポート 13.6.2

L

- ラベル・テンプレート

- #CURRENT_ITEM_HELP_TEXT# 11.3.12.2

- ページ・アイテム・ヘルプの作成 11.3.12.2

- 定義 11.3.12.1.2

- 編集 11.3.12

- エラー表示 11.3.12.1.3

- フィールド・コンテナ 11.3.12.1.4

- 名前 11.3.12.1.1

- 置換文字列 11.3.12.1.5

- 言語

- アプリケーション用の定義 20.2

- マルチバイト 20.4

- プリファレンス 20.1.2

- レイアウト

- リージョン属性について 12.6.3.2

- 制御 11

- LDAPディレクトリの検証

- 設定 19.4.3.5.2

- レガシーAnyChartチャート 24.2.3

- レガシー・カレンダ 24.5

- ドラッグ・アンド・ドロップの有効化 24.5.2.3

- レガシー・カレンダ・テンプレート 11.3.11

- レガシー・クラシック・カレンダ 24.5.1

- レガシー・コンポーネント

- ギャラリでの表示 24.6

- 制限

- フォーム B.1

- 対話モード・レポート B.1

- アイテム名 B.1

- 表形式フォーム B.1

- 検証 B.1

- リンク列

- 概要 8.4.1.9, 8.4.2.6

- 除外 8.4.1.9.4, 8.4.2.6.4

- 単一行ビューのリンク 8.4.1.9.1, 8.4.2.6.1

- ページへのリンク 8.4.1.9.2, 8.4.2.6.2

- URLへのリンク 8.4.1.9.3, 8.4.2.6.3

- リンク

- ディープ 19.4.1.2

- リスト

- 作成について 16.7, 16.7.1

- 動的について 16.7.4

- 静的について 16.7.3

- ページへの追加 16.7.6

- 「条件付きエントリ」レポート 16.7.8

- コピー 16.7.5

- アプリケーション間のコピー 16.7.5.2

- カレント・アプリケーションからのコピー 16.7.5.1

- 階層の作成 11.3.13.1

- 編集 16.7.7

- 属性の編集 16.7.7

- 履歴レポート 16.7.8

- リスト・ページ 16.7.7

- レポート 16.7.8

- タイプ 16.7.1

- 「未使用」レポート 16.7.8

- 使用状況レポート 16.7.8

- リスト・マネージャ, 依存LOVの作成 13.3.2.3

- 値リスト 13.3.2.3

- 静的LOVのバルク編集 16.6.4.2

- 「条件付きエントリ」レポート 16.6.6

- 作成 16.6

- アプリケーション・レベルでの作成 16.6.2

- 編集 16.6.4

- 「NULLテキストの編集」レポート 16.6.6

- グリッド編集レポート 16.6.6

- 履歴レポート 16.6.6

- 「ローカルに定義」レポート 16.6.6

- 名前付き 16.6.2

- セッション・ステートの参照 16.6.5

- レポート 16.6.6

- 共有 16.6.2

- 静的 16.6.3

- 「サブスクリプション」レポート 16.6.6

- 翻訳 20.7

- 使用状況レポート 16.6.6

- リスト・レポート

- 条件付きエントリ 16.7.8

- 履歴 16.7.8

- 未使用 16.7.8

- 使用状況 16.7.8

- 用語のリスト A.1

- リスト・ページ 16.7.7

- リスト・ウィザード 16.7.3.1, 16.7.4.1

- リスト・テンプレート

- リスト後のエントリ 11.3.13.2.8

- サブリスト後のエントリ 11.3.13.2.7

- リスト前のエントリ 11.3.13.2.2

- サブリスト前のエントリ 11.3.13.2.5

- 編集 11.3.13

- 名前 11.3.13.2.1

- サブリスト・エントリ 11.3.13.2.6

- 置換文字列 11.3.13.2.9, 11.3.14.1.11

- テンプレート定義 11.3.13.2.3

- 最初のエントリのテンプレート定義 11.3.13.2.4

- リスト・ビュー

- リージョンの作成ウィザードでの追加 12.6.1

- リスト・ビュー・レポート

- アプリケーションの作成ウィザードでの作成 6.1.2

- ライブ・テンプレート・オプション

- 使用 11.3.6.3.3

- ロック

- ロック・ステータスの判別 6.9.1

- データベース・アプリケーション・ページ用 6.9

- ロギング属性 6.5.1.2.2

- ログイン制御, 作成 19.1.5.1

- ログイン・ページ

- 作成 19.4.7

- ロゴ

- 定義 6.5.4.3

- 「ロゴ」属性 6.5.4.2.2

- ログ

- 管理 21.3.1

- パフォーマンス 21.3

M

- 「セッション・ステート保護の管理」属性 6.5.2.2.4

- マップ

- マップ・チャートのサポートについて 10.2.1

- ウィザードについて 10.2.2

- ページへの追加 10.2.4.1, 10.2.5.1

- 新しいページへの追加 10.2.3

- 作成 10.2

- SQL問合せの作成 10.2.2

- マップ属性の編集 10.2.4.2, 10.2.5.2

- 非同期更新の有効化 10.2.5.4

- 自動更新の有効化(ページ・デザイナ) 10.2.4.4

- コンポーネント・ビューでの管理 10.2.5

- ページ・デザイナでの管理 10.2.4

- SQL問合せの指定 10.2.2

- カスタムXMLの使用 10.2.4.3, 10.2.5.3

- マスター・アプリケーション, 作成 11.2.7

- マスター・ディテール

- 1ページの作成 9.4.3, 9.4.4

- アプリケーションの作成ウィザードでの作成 6.1.2, 9.2.1

- ページの作成ウィザードでの作成 9.4.3, 9.4.4

- 管理 9.4

- マスター・ディテール, 1ページ

- 概要 9.1.3

- マスター・ディテール, 2ページ

- 概要 9.1.3

- マスター・ディテール・フォーム, 概要 9.4.1

- マスター・ディテール・フォーム

- 概要 9.1.3

- 「最大セッション・アイドル時間」属性 6.5.2.2.3

- 「最大セッションの長さ」属性 6.5.2.2.3

- メニュー 1.3.4.1, 1.3.4.3

- 使用できないアプリケーションに対するメッセージ 6.5.1.2.3

- メッセージ

- 翻訳用に作成 20.6.4.1

- テキスト・メッセージの編集 20.6.4.2

- PL/SQLプロシージャ 20.6.2

- レポート

- 翻訳 20.6.4

- 翻訳 20.6, 20.6.2

- 内部の翻訳 20.6.4

- レポートでのメッセージ 20.6.4

- 翻訳が必要なメッセージ

- 対話モード・レポート 20.6.4.4

- 内部 20.6.4.3

- マイルストン・レポート

- 「所有者別」レポート 4.5.4.2

- 「マイルストン別の機能」レポート 4.5.4.3

- マイルストン・カレンダ 4.5.4.1

- マイルストン

- 作成 4.5.2

- 追跡 4.5

- 更新 4.5.3

- 表示 4.5.1

- レポートの表示 4.5.4

- モバイル・アプリケーション 6.3.1

- 設計について 2.2.2

- 作成 6.3, 6.3.2

- jQuery Mobile 6.3.1

- モバイル・デザイン 2.2.3

- レスポンシブ・デザイン 2.2.3

- モバイル・テーマ - 51 11.1.2

- アクティビティの監視

- カレンダ・レポート 21.3.4

- 開発者アクティビティ 21.3.4

- 環境レポート 21.3.4

- ログイン試行回数 21.3.4

- ログ 21.3.4

- ページ・ビュー 21.3.4

- サービス・リクエスト 21.3.4

- ワークスペースのパージ 21.3.4

- 複数選択リスト・アイテム 13.1.5

- 戻り値の処理 13.1.5.1

- APEX_UTIL.STRING_TO_TABLEの使用 13.1.5.2

N

- ナビゲーション

- ブランチ 14.5

- ブレッドクラム 14.3

- リスト 16.7

- 親タブ 14.2

- 標準タブ 14.2

- タブ 14.2

- ナビゲーション・バー 14.4

- ナビゲーション・バー・エントリ 14.4

- 概要 14.4.1

- コピー 14.4.3

- 作成 14.4.2

- フィードバック用に作成 14.4.2.2

- 最初から作成 14.4.2.1

- 編集 14.4.4

- 複数の編集 14.4.5

- 履歴レポート 14.4.6

- レポート 14.4.6

- 「サブスクリプション」レポート 14.4.6

- ナビゲーション・バー・エントリ・レポート

- 履歴 14.4.6

- サブスクリプション 14.4.6

- ネットワーク・サービス

- 有効化 19.1.11

- 接続権限の付与 19.1.11.2

- 接続権限の付与, Oracle Database 12c 19.1.11.3

- 無効なACLエラー 19.1.11.4

- ニュース・エントリ 1.3.3

- 追加 4.9.8

- 削除 4.9.8

- 編集 4.9.8

- 数値フィールド A.1

- NV関数 2.8.1

O

- オンライン・ヘルプ 1.7

- 検索 1.7

- 公開資格証明

- 設定 19.4.3.7.2

- Oracle Application Express

- 概要 1.2, 1.2.1

- アーキテクチャ 1.2.2

- コンポーネントの制限 B.1

- サインイン 1.1

- ユーザー・ロール 19.1.1

- Oracle Application Express管理者 19.1.1

- Oracle Application Expressアドバイザ

- 概要 22.1.1

- アプリケーションの整合性のチェック 22.1

- ページ上での実行 22.1.3

- アプリケーションでの実行 22.1.2

- Oracle Application Expressエンジン 1.2.2

- Oracle BI Publisher, 統合 19.1.9

- Oracle Help Center

- 検索 1.7.1, 1.7.2

- Oracle HTTP Server

- セキュリティについて 19.1.3

- 出力のエスケープ

- 置換文字列 2.9.2, 11.3.3

P

- パッケージ・アプリケーション

- 認証の変更 3.2.5

- インストール 3.2.2, 3.2.3

- 管理 3.2

- 生産性アプリケーション 3.1

- 削除 3.2.4

- サンプル・アプリケーション 3.1

- 更新 3.2.7

- パッケージ・アプリケーション

- 概要 3.2.1

- パッケージ・アプリケーション・ページ 3.2.1

- アクセス 3.2.1

- パッケージ・アプリケーション管理

- サービス・リクエストの作成 3.5.1

- 保存された対話モード・レポートの管理 3.5.4

- サブスクリプションの管理 3.5.5

- 記憶域のリクエスト 3.5.1

- 終了のリクエスト 3.5.1

- ワークスペース・プリファレンスの設定 3.5.2

- 「パッケージ・アプリケーションのみ」ワークスペース 3.6

- アクセス 3.6.3

- アカウント有効期限 3.5.2

- ダッシュボード 3.6.3

- 定義 3.6.1

- エンド・ユーザー・アカウント・ライフタイム 3.5.2

- ロック 3.5.2

- ユーザーの管理 3.5.3

- ログイン失敗の最大回数 3.5.2

- パッケージ・アプリケーション管理 3.5, 3.6.3

- パッケージ・アプリケーション・ギャラリ 3.6.3, 3.6.4

- リクエスト 3.6.2

- アクティビティ・レポートの表示 3.5.6

- ページ・ビューの表示 3.5.7

- トップ・ユーザーの表示 3.5.8

- パッケージ, 検索 6.7.6

- ページ, 認可スキームの割当て 19.5.3.2

- ページ属性

- ページ・デザイナでの編集 7.4

- コンポーネント・ビューでの表示 24.1.5.1

- ページ・デザイナでの表示 7.4.1

- 保存されていない変更の警告 7.4.5

- ページ・コンポーネント, アクセスの制御 19.3.4

- ページ計算

- 計算ポイント 15.1.4

- 作成 15.1.2.1, 15.1.3.1

- 計算ポイントの定義 15.1.2.3, 15.1.3.3

- 計算ソースの定義 15.1.2.3, 15.1.3.3

- 属性の編集 15.1.2.2, 15.1.3.2

- 計算を条件付きにする 15.1.2.4, 15.1.3.4

- コンポーネント・ビューでの管理 15.1.3

- ページ・デザイナでの管理 15.1.2

- ページ送信 7.3.11

- レンダリング前 7.3.10

- 構文 15.1.4

- ページ制御

- コンポーネント・ビューからの追加 24.1.4.3

- ページ・デザイナ

- アクセス 7.3.1

- プロパティ・エディタへのアクセス 7.3.4

- レポートの追加, ドラッグ・アンド・ドロップ 8.2.2

- ボタンの追加 7.3.5, 7.3.6, 7.3.7

- アイテムの追加 7.3.5, 7.3.6, 7.3.7

- リージョンの追加 7.3.5, 7.3.6, 7.3.7

- コード・エディタ 7.2.5

- 「コンポーネント・ビュー」タブ 7.2.3.3

- ダイアログ属性の構成 7.4.4

- ボタンのコピー 7.3.9

- アイテムのコピー 7.3.9

- ページのコピー 7.7

- リージョンのコピー 7.3.9

- アプリケーション・ページの削除 7.8

- ページ属性の編集 7.4.1

- ギャラリ 7.2.3.2

- ヘルプ 7.2.3.6

- レイアウト 7.2.3.1

- ページ属性の管理 7.4

- リージョン・タイトルを翻訳可能に指定 20.1.5.4.1

- 「メッセージ」タブ 7.2.3.4

- 「ページ検索」タブ 7.2.3.5

- プロパティ・エディタ 7.2.4

- レイアウトのリセット 7.3.3

- 右ペイン 7.2.4

- ページの実行 7.5

- 実行時開発者ツールバー 7.6, 24.1.7

- ページの検索 7.3.2

- 3ペイン・モード 7.3.3

- ツリー・ペイン 7.2.2

- 2ペイン・モード 7.3.3

- 使用 7.3

- フィールドレベル・ヘルプの表示 1.7.4.2

- ページ・デザイナ, ページ属性

- ダイアログ, 属性 24.1.5.5

- ダイアログ, CSSクラス 24.1.5.5

- ダイアログ, 高さ 24.1.5.5

- ダイアログ, 最大幅 24.1.5.5

- ダイアログ, 幅 24.1.5.5

- ダイアログ: 属性 7.4.4

- ダイアログ: チェーン 7.4.4

- ダイアログ: CSSクラス 7.4.4

- ダイアログ: 高さ 7.4.4

- ダイアログ: 最大幅 7.4.4

- ダイアログ: 幅 7.4.4

- ページ・デザイナ・ツールバー 7.2.1

- 作成, ブレッドクラム・リージョンの作成 7.2.1

- 作成, 開発者のコメント 7.2.1

- 作成, ページ 7.2.1

- 作成, コピーとしてのページ 7.2.1

- 作成, ページ・グループ 7.2.1

- 作成, 共有コンポーネント 7.2.1

- 作成, チーム開発 7.2.1

- フォーム・リージョンの作成 7.2.1

- 「作成」メニュー 7.2.1

- 「開発者のコメント」, 「バグ」または「To Do」ボタン 7.2.1

- ページに移動 7.2.1

- ページ・ロック 7.2.1

- ページ・ロック解除 7.2.1

- やり直し 7.2.1

- 「ページの保存と実行」ボタン 7.2.1

- 「保存」ボタン 7.2.1

- 設定, バグ 7.2.1

- 設定, 機能 7.2.1

- 設定, フィードバック・エントリ 7.2.1

- 設定, To Do 7.2.1

- 設定, 2ペイン・モード 7.2.1

- 「設定」メニュー 7.2.1

- 共有コンポーネント 7.2.1

- 元に戻す 7.2.1

- ユーティリティ 7.2.1

- ユーティリティ, アプリケーション・ユーティリティ 7.2.1

- ユーティリティ, 属性ディクショナリ 7.2.1

- ユーティリティ, 削除 7.2.1

- ユーティリティ, ページの削除 7.2.1

- ユーティリティ, エクスポート 7.2.1

- ユーティリティ, 履歴 7.2.1

- ユーティリティ, ページ・グループ 7.2.1

- ユーティリティ, アプリケーションのアップグレード 7.2.1, 24.1.3.2

- ページ・ファインダ 6.7

- ページ・アイテム

- ページの表示の編集 13.3.3.7.1

- タイプ A

- ページ・レイアウト, 概要 12.1

- ページレベル・アイテム

- 概要 13.1.1

- すべてのページ・アイテム 13.3.3.7.4

- 条件付きアイテム 13.3.3.7.4

- 「認可スキーム」の構成 13.3.3.3

- 「特殊文字をエスケープ」の構成 13.2.3.3, 13.3.3.3

- 「制限付き文字」の構成 13.2.3.3, 13.3.3.3

- セキュリティの構成 13.2.3.3, 13.3.3.3

- 「セッション・ステート保護」の構成 13.2.3.3, 13.3.3.3

- 「セッション・ステートに暗号化された値を保存」の構成 13.2.3.3, 13.3.3.3

- 作成 13.1, 13.2.2, 13.3.2, 13.3.2.1

- シャトルの作成 13.1.5.3

- カスケードLOVの作成 13.3.2.3

- カスケードLOVの作成 13.2.2.4

- 「ギャラリ」からの作成 13.2.2.2

- 「レンダリング」タブからの作成 13.2.2.1

- 表形式フォームを使用して複数を作成 13.3.2.4

- 静的LOVの作成 13.3.2.2

- デフォルト値の定義 13.2.3.2, 13.3.3.2

- クイック選択の定義 13.2.3.4, 13.3.3.4

- 複数の削除 13.3.3.7.3

- 条件付きの表示 13.2.3.5, 13.3.3.5

- 読取り専用の表示 13.2.3.6, 13.3.3.6

- 属性の編集 13.3.3.1

- プロパティ・エディタでの編集 13.2.3.1

- 複数の編集 13.3.3.7

- すべてのアイテム・ヘルプ・テキストのグリッド編集 13.3.3.7.4

- すべてのアイテム・ラベルのグリッド編集 13.3.3.7.4

- アイテム・ヘルプのサブスクリプション 13.3.3.7.4

- 複数選択リスト・アイテム 13.1.5

- ネーミング規則 13.1.2

- リージョンへの再割当て 13.3.3.7.2

- JavaScriptを使用した参照 13.1.4

- 値の参照 13.1.3

- 「認可スキーム」の指定 13.2.3.3

- 値の静的リスト 13.2.2.3

- 表示 13.2.1

- 履歴の表示 13.3.3.7.5

- コンポーネント・ビューでの表示 13.3.1

- ユーティリティの表示 13.2.3.8, 13.3.3.7.4

- 保存されていない変更の警告 13.2.3.7

- ページレベル・アイテム・レポート

- すべてのページ・アイテム 13.2.3.8

- 条件付きアイテム 13.2.3.8

- すべてのアイテム・ヘルプ・テキストのグリッド編集 13.2.3.8

- すべてのアイテム・ラベルのグリッド編集 13.2.3.8

- アイテム・ヘルプのサブスクリプション 13.2.3.8

- ページレベル・テンプレート 11.3.4.2

- ページ・モード

- モーダル・ダイアログ 24.1.5.2.2

- 非モーダル・ダイアログ 24.1.5.2.2

- 標準 24.1.5.2.2

- ページ・プロセス

- プロセス・ポイントの変更 15.3.2.3, 15.3.3.3

- ソースの変更 15.3.2.3, 15.3.3.3

- 作成 15.3.2.1, 15.3.3.1, 15.3.3.1.1

- エラー・メッセージの作成 15.3.2.4, 15.3.3.4

- 表形式フォーム用の作成 15.3.3.1.2

- 成功メッセージの作成 15.3.2.4, 15.3.3.4

- 属性の編集 15.3.2.2, 15.3.3.2

- 条件付きにする 15.3.2.5, 15.3.3.5

- ページ送信 7.3.11

- レンダリング前 7.3.10

- 「対象ボタン」属性 2.9.4.35.2

- ページ・プロセス 2.4.1

- 理解 2.4

- ページ・レンダリング 2.4.1

- 理解 2.4

- ページ

- 概要 2.1.2

- グローバル・ページについて 12.3

- ボタンからのコール 2.7.6

- 別名を使用したコール 2.7.5

- アクセス制御 19.3.4

- 重複送信 24.1.5.2.10

- ユーザーによるカスタマイズの有効化 12.5.2.4, 12.6.3.4

- エクスポート 23.6.6

- f?p構文を使用したリンク 2.7.2

- 印刷用に最適化 12.2

- リソース使用 22.3

- 検索 6.7.3

- サーバー・キャッシュ 24.1.5.2.11

- ページ・テンプレートの指定 11.3.4.2

- ページ・セレクタ 7.3.2

- ページ・ファインダ 6.7.3

- ページ固有のユーティリティ 6.13.8

- ブランチ・ユーティリティ 6.13.8

- ボタン・ユーティリティ 6.13.8

- 計算ユーティリティ 6.13.8

- クロス・ページ・ユーティリティ 6.13.8

- 動的アクション・ユーティリティ 6.13.8

- アイテム・ユーティリティ 6.13.8

- ページ・グループ 6.13.8

- プロセス・ユーティリティ 6.13.8

- リージョン・ユーティリティ 6.13.8

- 検証ユーティリティ 6.13.8

- ページ・テンプレート

- ボディ 11.3.14.1.2

- カスケード・スタイル・シート 11.3.14.1.4

- 定義 11.3.14.1.2

- ダイアログ 11.3.14.1.9

- 表示ポイント 11.3.14.1.8

- 編集 11.3.14

- エラー・ページ・テンプレートの制御 11.3.14.1.10

- フッター 11.3.14.1.2

- ヘッダー 11.3.14.1.2

- イメージ・ベースのタブ属性 11.3.14.1.6

- JavaScript 11.3.14.1.3

- JavaScript、ダイアログ取消コード 11.3.14.1.3

- JavaScript、ダイアログ・クロージャ・コード 11.3.14.1.3

- JavaScript、ダイアログ初期化コード 11.3.14.1.3

- JavaScript, ページ・ロード時に実行 11.3.14.1.3

- JavaScript, ファイルURL 11.3.14.1.3

- JavaScript, ファンクションおよびグローバル変数の宣言 11.3.14.1.3

- レイアウト 11.3.14.1.7

- 名前 11.3.14.1.1

- 選択 11.3.4

- デフォルトの指定 11.3.4.1, 11.3.4.2

- 置換文字列 11.3.14

- サブテンプレート 11.3.14.1.5

- ページ・テンプレート置換文字列 11.3.14

- #APEX_CSS# 11.3.14.1.11

- #APP_VERSION# 11.3.14.1.11

- #APPLICATION_CSS# 11.3.14.1.11

- #APPLICATION_JAVASCRIPT# 11.3.14.1.11

- #BOX_BODY# 11.3.14.1.11

- #DIALOG_CSS_CLASSES# 11.3.14.1.11

- #DIALOG_HEIGHT# 11.3.14.1.11

- #DIALOG_MAX_WIDTH# 11.3.14.1.11

- #DIALOG_WIDTH# 11.3.14.1.11

- #FAVICONS# 11.3.14.1.11

- #FORM_CLOSE# 11.3.14.1.11

- #FORM_OPEN# 11.3.14.1.11

- #GLOBAL_NOTIFICATION# 11.3.14.1.11

- #HEAD# 11.3.14.1.11

- #IS_MODAL# 11.3.14.1.11

- #LOGO# 11.3.14.1.11

- #NAVIGATION_BAR# 11.3.14.1.11

- #NOTIFICATION_MESSAGE# 11.3.14.1.11

- #ONLOAD# 11.3.14.1.11

- #PAGE_TRANSITION# 11.3.14.1.11

- #REGION_POSITION_NN# 11.3.14.1.11

- #SUCCESS_MESSAGE# 11.3.14.1.11

- #TAB_CELLS# 11.3.14.1.11

- #TEMPLATE_JAVASCRIPT# 11.3.14.1.11

- #THEME_STYLE_CSS# 11.3.14.1.11

- #TITLE# 11.3.14.1.11

- PAGE_URL 11.3.14.1.11

- ページ・ゼロ 12.1

- ページ区切り

- クラシック・レポート 8.5.1.3, 8.5.2.3

- 対話モード・レポート 8.4.1.5, 8.4.2.4

- レポート 11.3.17.2.2, 11.3.17.3.5

- ページ区切りサブテンプレート

- 次のページ・テンプレート 11.3.17.3.6

- 次のセット・テンプレート 11.3.17.3.6

- ページ区切りテンプレート 11.3.17.3.6

- 前のページ・テンプレート 11.3.17.3.6

- 前のセット・テンプレート 11.3.17.3.6

- 親タブ, 作成 14.2

- 解析対象スキーマ 6.5.2.2.6

- パスワード

- ベスト・プラクティス 19.2.1

- 変更 1.5.2

- 問題の識別 19.2.2

- 再利用の制限 19.1.5.10

- 「セキュリティ・プロファイル」レポート 19.2.2.1

- パスワード

- 「パスワード・アイテム」レポート 19.2.2.2

- パッチ, 作成 23.6.4

- パーセント・グラフ A.1

- パフォーマンス 21

- ベスト・プラクティス 21.1

- データベース・パラメータ 21.4, 21.5

- 問題のあるSQL問合せのデバッグ 21.2.3

- 問題の診断 21.2.2

- 問題の特定 21.2

- リソース制限 21.5

- 速度の遅い問合せ 21.2.4

- 実行速度の遅いアプリケーション 21.2.1

- Webサーバーへの静的ファイルのアップロード 21.7

- ログおよびレポートの使用 21.3

- PL/SQLコード, 検索 6.7.6

- PL/SQLファインダ 6.7

- プラグイン

- 概要 18.2.1

- アクセス 18.2.3

- イベントの追加 18.2.8

- 作成 18.2.4

- カスタム属性 18.2.6

- 削除 18.2.9

- 編集 18.2.5

- 例 18.2.2

- エクスポート 18.2.12

- 実装 18.2

- インポート 18.2.11, 23.7.4

- リセット 18.2.13

- 関連付けられたファイルのアップロード 18.2.7

- JavaScriptコードの使用 18.3.3.2

- 使用状況 18.2.14

- 履歴の表示 18.2.15

- プラグイン・リポジトリの表示 18.2.10

- ポップアップLOV A.1

- ポップアップLOV, 依存LOVの作成 13.3.2.3

- ポップアップLOVテンプレート

- ボタン 11.3.15.1.2

- 編集 11.3.15

- ページ属性 11.3.15.1.6

- ページ区切り 11.3.15.1.4

- 結果セット 11.3.15.1.5

- 検索フィールド 11.3.15.1.1

- ウィンドウ 11.3.15.1.3

- 事前構成された認証スキーム 19.4.3

- 印刷用テンプレート 12.2

- レポートの印刷 8.6

- 権限

- データベース・ユーザーへの付与について D.1

- データベース・ユーザーへの付与 D.1

- プロシージャ・ファインダ 6.7.6

- プロシージャ, 検索 6.7.6

- プロセス

- キャッシュ管理 15.3.2.1, 15.3.3.1.1, 15.3.3.1.2

- データ操作 15.3.2.1, 15.3.3.1.1, 15.3.3.1.2

- フォーム・ページ区切り 15.3.2.1, 15.3.3.1.1, 15.3.3.1.2

- オンデマンド 15.3.2.1, 15.3.3.1.1, 15.3.3.1.2

- PL/SQL 15.3.2.1, 15.3.3.1.1, 15.3.3.1.2

- レポート・ページ区切り 15.3.2.1, 15.3.3.1.1, 15.3.3.1.2

- Webサービス 15.3.2.1, 15.3.3.1.1, 15.3.3.1.2

- 生産性アプリケーション, ロック解除 3.2.6

- プログラミング手法

- コレクション 17.2

- データベース・リンク 17.4

- Webサービスの実装 17.3

- プロキシ・サーバー 17.3.2.2

- 「プロキシ・サーバー」属性 6.5.1.2.2

- パブリック・ファイルのアップロード, 有効化 19.1.5.2

- パブリック・シノニム D.2

- 「パブリック・ユーザー」属性 6.5.2.2.1

Q

- 問合せ, 検索 6.7.4

- 問合せファインダ 6.7, 6.7.4

R

- ラジオ・グループ A.1

- LOV 13.3.2.3

- 「最近更新されたページ」レポート 6.13.4

- リフロー・レポート

- アプリケーションの作成ウィザードでの作成 6.1.2, 12.6.1

- リージョン

- タイプについて 12.6.1

- ユーティリティおよびレポートへのアクセス 12.6.3.8.2

- イメージの追加 12.5.2.7 12.6.3.7

- リージョンへのスライダの追加 16.2.5

- URLに基づく 12.7

- 位置の制御 12.5.2.2, 12.6.3.2.2

- コピー 12.5.3, 12.6.5

- 作成 12.5.1, 12.6.2

- リスト用の作成 16.7.6

- リージョン表示セレクタの作成 12.5.2.8, 12.6.4

- サブリージョンの作成 12.6.3.9

- 削除 12.5.4, 12.6.6

- 一度に複数のリージョンを削除 12.6.6.2

- 条件付きの表示 12.6.3.2.1

- 属性の編集 12.5.2.1, 12.6.3.1, 12.6.3.9.3

- 複数のリージョンの属性の編集 12.6.3.8.1

- リージョン属性の編集 12.5.2.1, 12.6.3.1, 12.6.3.9.3

- カスタマイズの有効化 12.5.2.4, 12.6.3.4

- ユーザーによるページのカスタマイズの可能化 12.5.2.4, 12.6.3.4

- 属性がレイアウトに与える影響 12.6.3.2

- 静的リージョンIDの指定 12.5.2.6, 12.6.3.6

- ヘッダーとフッターの指定 12.5.2.3, 12.6.3.3

- 理解 12.5, 12.6

- リージョン属性

- キャッシュ 12.5.2.5, 12.6.3.5

- 列 12.6.3.2.1

- 列属性 12.6.3.2.1

- 列CSSクラス 12.6.3.2.1

- 列スパン 12.6.3.2.1

- 条件タイプ 12.6.3.2.1

- カスタマイズ 12.6.3.2.1

- 表示ポイント 12.6.3.2.1

- 式 12.6.3.2.1

- イメージ・タグ属性 12.6.3.2.1

- アイテム表示位置 12.6.3.2.1

- 読取り専用条件タイプ 12.6.3.2.1

- リージョンのCSSクラス 12.6.3.2.1

- リージョン表示セレクタ 12.6.3.2.1

- リージョン・フッター 12.6.3.2.1

- リージョン・ヘッダー 12.6.3.2.1

- リージョン・イメージ 12.6.3.2.1

- 順序 12.6.3.2.1

- 新規グリッドの開始 12.6.3.2.1

- 静的ID 12.5.2.6, 12.6.3.6

- テンプレート 12.6.3.2.1

- リージョン表示セレクタ, 作成 12.5.2.8, 12.6.4

- リージョン・テンプレート

- 定義 11.3.16.1.2

- 編集 11.3.16

- フォーム表属性 11.3.16.1.3

- 名前 11.3.16.1.1

- 「サブリージョン」属性 11.3.16.1.4

- 置換文字列 11.3.16.1.5

- リージョン・タイトル

- 翻訳可能に指定 20.1.5.4

- リージョン・タイプ

- ブレッドクラム 12.6.1

- カレンダ 12.6.1

- チャート 12.6.1

- クラシック・レポート 12.6.1

- Webサービスのフォームとレポート 12.6.1

- プロシージャのフォーム 12.6.1

- SQL問合せのフォーム 12.6.1

- 表のフォーム 12.6.1

- リスト・ビュー付きの表のフォーム 12.6.1

- Webサービスのフォーム 12.6.1

- ヘルプ・テキスト 12.6.1

- 対話モード・レポート 12.6.1

- リスト 12.6.1

- リスト・ビュー 12.6.1

- マップ 12.6.1

- 複数の静的コンテンツ 12.6.1

- PL/SQL動的コンテンツ 12.6.1

- プラグイン 12.6.1

- リージョン表示セレクタ 12.6.1

- Webサービスの結果のレポート 12.6.1

- 静的コンテンツ 12.6.1

- サマリー・ページ 12.6.1

- ツリー 12.6.1

- URL 12.6.1

- セッションを再結合

- セキュリティ・リスクについて 19.1.5.7

- アプリケーション・レベルでの構成 6.5.2.2.3

- ページ・レベルでの構成 7.4.3, 24.1.5.4

- 「セッションを再結合」属性 6.5.2.2.3

- レポート 8.2.1.1

- アプリケーションの作成ウィザードでの作成 6.1.2

- Oracleデータベース 21.4

- レポートとフォーム

- アプリケーションの作成ウィザードでの作成 6.1.2

- レポート列テンプレート

- セル・ヘッダーのカラー化 11.3.17.2.3

- ヘッダーの省略 11.3.17.2.3

- レポート列テンプレート(汎用)

- 行の後 11.3.17.2.7

- 各行の前 11.3.17.2.4, 11.3.17.2.6

- 行の前 11.3.17.2.2

- 列ヘッダー 11.3.17.2.3

- 列テンプレート 11.3.17.2.5

- HTMLをすべての列の後に表示 11.3.17.2.6

- HTMLを最後の行の後に表示 11.3.17.2.7

- 次のページ・テンプレート 11.3.17.2.9

- 次のセット・テンプレート 11.3.17.2.9

- ページ区切りサブテンプレート 11.3.17.2.9

- 前のページ・テンプレート 11.3.17.2.9

- 前のセット・テンプレート 11.3.17.2.9

- レポート・テンプレート 11.3.17.2.1

- 行選択 11.3.17.2.8

- レポート列テンプレート(名前付き)

- 「行の前」属性 11.3.17.3.5

- 列ヘッダー・セルのカラー化 11.3.17.3.4

- 列ヘッダー 11.3.17.3.4

- ページ区切りサブテンプレート 11.3.17.3.6

- レポート・テンプレートの指定 11.3.17.3.1

- 行テンプレート 11.3.17.3.3

- サブスクリプション 11.3.17.3.2

- レポート・レイアウト

- 概要 16.9.2

- コピー 16.9.2.5

- 作成 16.9.2.3

- 編集 16.9.2.4

- オプション 16.9.2.2

- 表のフォームのレポート 8.1.4

- Webサービスの結果のレポート

- リージョンの作成ウィザードでの作成 12.6.1

- レポート問合せ

- 概要 16.9.1

- コピー 16.9.1.4

- 作成 16.9.1.2

- 編集 16.9.1.3

- レポート・リージョン

- 構成オプションについて 8.6.2

- 出力 8.6

- PDFへの出力 8.6.1

- レポート 11.3.7

- 概要 8

- データベース・アプリケーションについて 6.13

- アクティブ・セッション履歴(ASH)レポート 21.4

- ドラッグ・アンド・ドロップによる追加 8.2.2

- アプリケーション・ダッシュボード 6.13.2, 21.3.2

- 自動ワークロード・リポジトリ(AWR)レポート 21.4

- アイテム・ヘルプをバルク編集 10.4.3

- 変更履歴 6.13.5

- クラス参照 11.2.11.4

- 列リンクの作成 8.5.1.7, 8.5.2.8

- ウィザードを使用した作成 8.2.1

- アプリケーションの作成ウィザードでの作成 8.2.1.3

- ページの作成ウィザードでの作成 8.2.1.4

- CSVエクスポート 11.3.17.2.4

- データベース・アプリケーション 6.13

- CSV形式へのエクスポート 11.3.17.2.2, 11.3.17.3.5

- ページ区切りを上に追加 11.3.17.2.2, 11.3.17.3.5

- 対話グリッドの管理 8.3

- アクティビティの監視 21.3.4

- パフォーマンス 21.3

- 出力 8.6

- 最近更新されたページ 6.13.4

- レポートとフォーム 8.1.4

- 列のソート 8.5.1.6, 8.5.2.4

- サポートされる置換文字列 11.2.11.5

- テーマのテンプレート 11.2.11.1

- テンプレート・サブスクリプション 11.3.7

- テンプレートの使用状況 11.3.7

- テーマ・ファイル参照 11.2.11.3

- テーマ 11.2.11

- テーマ・テンプレート数 11.2.11.2

- タイプの理解 8.1

- ワークスペース・アクティビティ 21.3.2, 21.3.3

- レポート・テンプレート 11.3.17

- 編集 11.3.17

- 汎用列テンプレート 11.3.17.1.1

- 名前付き列テンプレート 11.3.17.1.2

- JavaScriptの使用 11.3.17.4

- REQUEST

- スコープおよび値について 2.9.4.35.1

- 「対象ボタン」属性について 2.9.4.35.2

- ボタン名 13.5.5

- 宣言条件を使用した参照 2.9.4.35.3

- 値の参照 2.9.4.34

- 置換文字列 2.9.4.34

- 表示プロセスでの使用 2.9.4.35.4

- リソース使用, 監視 22.3

- レスポンシブ・デザイン 2.2.3

- レスポンシブ・デザイン, 概要 11.1.2

- RESTfulアクセス, 有効化 19.1.5.6

- アクセスの制限, アプリケーションに対する 6.5.1.2.3

- 「アプリケーションの実行」ボタン 1.4.4.2

- 「パブリック・ページで実行」属性 6.5.2.2.2

- ランタイムAPIの使用状況 6.5.2.2.6

- 実行時開発者ツールバー 7.6, 24.1.7

- アプリケーション 7.6, 24.1.7

- デバッグ 7.6, 24.1.7

- 開発者ツールバー・オプション 7.6, 24.1.7

- ページの編集 7.6, 24.1.7

- ホーム 7.6, 24.1.7

- クイック編集 7.6, 24.1.7, 11.3.6.3.3

- セッション 7.6, 24.1.7

- レイアウト列の表示 7.6, 24.1.7

- ランタイム環境 1.2.3

- 利点 19.1.10

S

- 安全なアイテム・タイプ 19.2.3.2.2

- サンプル・チャート

- サンプルの表示 10.3.2

- サンプル・データベース・アプリケーション

- 概要 3.3

- Administrationページ 3.3.2.9

- Customersページ 3.3.2.2, 3.3.2.3

- 編集 3.3.3, 3.3.3.2

- アプリケーションの編集 3.3.3.2

- Homeページ 3.3.2.1

- インストール 3.3.1

- モバイル・ページ 3.3.2.10

- 変更 3.3.3, 3.3.3.2

- 実行 3.3.1

- 理解 3.3, 3.3.2

- パブリック・レポートの保存の認可 8.3.2.6

- SDLC

- 高速アプリケーション開発 23.2.5

- スパイラル 23.2.4

- ワークスペースの検索 1.3.4.1

- Secure Sockets Layer, ベスト・プラクティス 19.1.5.5

- セキュリティ

- 属性 6.5.2

- ページ用 24.1.5.2.9

- セキュリティ属性

- この後に作成されるURLの許可 6.5.2.2.4

- 認証 6.5.2.2.1

- 認証スキーム 6.5.2.2.1

- 認可スキーム 6.5.2.2.2

- ブックマーク・ハッシュ関数 6.5.2.2.4

- ブラウザ・セキュリティ 6.5.2.2.5

- キャッシュ 6.5.2.2.5

- データベース・セッション 6.5.2.2.6

- ディープ・リンク 6.5.2.2.3

- 認可スキームの定義 6.5.2.2.2

- フレームへの埋込み 6.5.2.2.5

- ブックマークの無効化 6.5.2.2.4

- HTMLエスケープ・モード 6.5.2.2.5

- HTTPレスポンス・ヘッダー 6.5.2.2.5

- セッション・ステート保護の管理 6.5.2.2.4

- 最大セッション・アイドル時間 6.5.2.2.3

- 最大セッションの長さ 6.5.2.2.3

- パブリック・ユーザー 6.5.2.2.1

- セッションを再結合 6.5.2.2.3

- パブリック・ページで実行 6.5.2.2.2

- セッション・アイドル・タイムアウトURL 6.5.2.2.3

- セッション管理 6.5.2.2.3

- セッション・ステート保護 6.5.2.2.4

- セッション・タイムアウトURL 6.5.2.2.3

- セキュリティに関するベスト・プラクティス

- インスタンス設定の構成 19.1.6

- 記憶域オプションの構成 19.1.6.3

- ワークスペース設定の構成 19.1.7

- WebシートでのSQLアクセスの制御 19.1.5.11

- ログイン制御の作成 19.1.5.1

- ウォレットの作成 19.1.6.4

- クロスサイト・スクリプティング保護 19.2.3

- 埋込みPL/SQLゲートウェイ 19.1.4

- 電子メールの有効化 19.1.6.2

- パブリック・ファイルのアップロードの有効化 19.1.5.2

- RESTfulアクセスの有効化 19.1.5.6

- RESTfulサービスの有効化 19.1.5.12

- ワークスペースのセルフ・サービス割当ての有効化 19.1.6.1

- 管理者向け 19.1

- 開発者向け 19.2

- 問題を引き起こす可能性のあるパスワードの識別 19.2.2

- ワークスペースの分離 19.1.5.8

- タイプ・パスワードのアイテム 19.2.1

- コンポーネントの可用性の管理 19.1.8.3

- インスタンス・セキュリティの管理 19.1.5

- ユーザーの管理 19.1.8.2

- ワークスペースの管理 19.1.8

- スキーマへのワークスペースの割当ての管理 19.1.8.1

- Oracle BI Publisher 19.1.9

- Oracle HTTP Server 19.1.3

- IPアドレスによるアクセスの制限 19.1.5.3

- パスワードの再利用の制限 19.1.5.10

- ランタイム環境 19.1.10

- Secure Sockets Layer 19.1.5.5

- セッション結合 19.1.5.7

- セッション・ステート 19.2.4

- セッション・タイムアウト, 19.1.5.9

- インスタンス・プロキシの指定 19.1.5.4

- セキュリティ・リスク, ファイル・アップロード表 19.2.6

- シード 20.5.2

- 選択リスト A.1

- 選択リスト, 依存LOVの作成 13.3.2.3

- セッション・クローニング

- 有効化 2.8.5

- セッションID 2.6.3

- セッション・アイドル・タイムアウトURL 6.5.2.2.3

- セッション結合

- ブラウザ攻撃の防止 19.1.5.7

- セキュリティに関するベスト・プラクティス 19.1.5.7

- セッション管理 6.5.2.2.3

- 指定 6.5.2.2.3

- セッション・ステート

- クリア 2.8.3

- アプリケーション・キャッシュのクリア 2.8.3.3

- アイテムごとのキャッシュのクリア 2.8.3.1

- ページごとのキャッシュのクリア 2.8.3.2

- カレント・ユーザー・セッションのキャッシュのクリア 2.8.3.5

- 2ページごとのキャッシュのクリア 2.8.3.2.1

- 保護の有効化 6.5.2.2.4

- 管理 2.6

- アイテム値の引渡し 2.8.3.2.2

- 保護 19.2.5

- 参照 2.8.1

- アプリケーションの完全なリセット 2.8.3.4

- セキュリティに関するベスト・プラクティス 19.2.4

- 設定 2.8.2

- アプリケーション間での共有 16.5.4

- 表示 2.6.4

- セッション・ステート保護

- すべての属性の構成 19.2.5.3.3

- セキュリティ属性の構成 19.2.5.3

- 無効化 19.2.5.2

- 有効化 19.2.5.2

- 「セキュリティ属性の編集」からの有効化 19.2.5.2.1

- 「セッション・ステート保護」からの有効化 19.2.5.2.2

- ウィザードを使用した有効化 19.2.5.2.2

- レポート 19.2.5.3.2

- 理解 19.2.5.1

- 既存の設定の表示 19.2.5.3.2

- サマリーの表示 19.2.5.3.2

- 「セッション・ステート保護」属性 6.5.2.2.4

- セッション・ステート値, 管理 2.8

- セッション・タイムアウト, 使用 19.1.5.9

- セッション・タイムアウトURL 6.5.2.2.3

- 共有コンポーネント

- 概要 16.1.4

- アクセス 16.1.2

- バックアップ 23.6.4

- 作成 16.1.2

- エクスポート 23.6.4

- 共有コンポーネント・ページ 16.1

- 「共有コンポーネント」アイコン 1.4.4.2

- 共有コンポーネント・ページ

- アプリケーションの計算 16.1.4.1

- アプリケーション定義属性 16.1.4.1

- アプリケーション・アイテム 16.1.4.1

- アプリケーション・プロセス 15.5, 16.1.4.1

- 認証スキーム 16.1.4.2

- 認可スキーム 16.1.4.2

- ブレッドクラム 16.1.4.4

- ビルド・オプション 16.1.4.2

- コンポーネント設定 16.1.4.3

- データ・ロード定義 16.1.4.7

- 開発者コメントのカレンダ 16.1.4.10

- アプリケーション・コメントの編集 16.1.4.10

- アプリケーション・コンポーネントのエクスポート 16.1.4.10

- グローバリゼーション属性 16.1.4.9

- LOV 16.1.4.3

- リスト 16.1.4.4

- サポートするオブジェクトの管理 16.1.4.10

- ナビゲーション・バー・エントリ 16.1.4.4

- ナビゲーション・メニュー 16.1.4.4

- プラグイン 16.1.4.3

- レポート・レイアウト 16.1.4.8

- レポート問合せ 16.1.4.8

- 開発者コメントのレビュー 16.1.4.10

- セキュリティ属性 16.1.4.2

- セッション・ステート保護 16.1.4.2

- ショートカット 16.1.4.3

- 静的アプリケーション・ファイル 16.1.4.6

- 静的ワークスペース・ファイル 16.1.4.6

- タブ 16.1.4.4

- 「タスク」リージョン 16.1.4.10

- テンプレート 16.1.4.5

- テキスト・メッセージ 16.1.4.9

- テーマ 16.1.4.5

- アプリケーションの翻訳 16.1.4.9

- ユーザー・インタフェース属性 16.1.4.5

- Webサービス参照 16.1.4.7

- 共有対話モード・レポート, リンクの設定 8.4.3.7

- ショートカット 16.8

- 概要 16.8.1

- 既存のショートカットのコピー 16.8.3.2

- 定義 16.8.3, 16.8.3.1, 16.8.3.2

- 最初から定義 16.8.3.1

- 属性の編集 16.8.4

- 履歴レポート 16.8.5

- HTMLテキスト 16.8.2.1, 16.8.3.1

- エスケープされた特殊文字を持つHTMLテキスト 16.8.2.1, 16.8.3.1

- イメージ 16.8.2.1, 16.8.3.1

- メッセージ 16.8.2.1, 16.8.3.1

- エスケープされた一重引用符を持つJavaScriptのメッセージ 16.8.2.1, 16.8.3.1

- PL/SQLファンクション本体 16.8.2.1, 16.8.3.1

- 参照 16.8.3.3

- レポート 16.8.5

- 「サブスクリプション」レポート 16.8.5

- 翻訳可能なメッセージのサポート 20.1.5.1

- エスケープされた一重引用符を持つJavaScriptのテキスト 16.8.2.1, 16.8.3.1

- タイプ 16.8.2

- ページの表示 2.4.1

- シャトル, 依存LOVの作成 13.3.2.3

- シャトルの複数選択リスト A.1

- サインイン・ページ 1.1

- シングル・サインオン

- 設定 19.4.3.8.2

- スライダ・アイテム・タイプ A.1

- SOAP 17.3

- SQLトレース, 有効化 22.4

- 標準タブ, 作成 14.2

- 静的アプリケーション・ファイル

- 削除 16.3.6.1

- すべて削除 16.3.6.2

- ダウンロード 16.3.5.1

- Zipファイルでのダウンロード 16.3.5.2

- 管理 16.3

- #APP_IMAGES#を使用した参照 16.3.4

- アップロード 16.3.2

- 詳細の表示 16.3.3

- 静的ファイル

- エクスポート 23.6.8

- 他のインスタンスへのインポート 23.6.8

- 静的リスト

- 概要 16.7.3

- リスト・エントリの追加 16.7.3.3

- サブリストの追加 16.7.3.3

- エントリのコピー 16.7.3.5

- 最初から作成 16.7.3.2

- 孤立リスト・エントリの管理 16.7.3.7

- エントリの親の変更 16.7.3.6

- エントリの順序変更 16.7.3.8

- 静的置換文字列 6.5.1.2.6

- 静的ワークスペース・ファイル

- 削除 16.4.5.1

- すべて削除 16.4.5.2

- ダウンロード 16.4.4.1

- Zipファイルでのすべてのダウンロード 16.4.4.2

- 管理 16.4

- #WORKSPACE_IMAGES#を使用した参照 16.4.3

- アップロード 16.4.1

- 詳細の表示 16.4.2

- 「ステータス」属性 6.5.1.2.3

- 記憶域オプション, 構成 19.1.6.3

- スタイルシート 11.3.1

- サブリージョン 12.6.3.9

- 作成 12.6.3.9.2

- 属性の編集による作成 12.6.3.9.3

- 使用 12.6.3.9.1

- 置換文字列 2.9.4.6

- #CSV_LINK# 11.3.17.2.2, 11.3.17.3.5

- #GLOBAL_NOTIFICATION# 6.5.1.2.5

- 組込みについて 2.9.4

- APEX$ROW_NUM 2.9.4.1

- APEX$ROW_SELECTOR 2.9.4.2

- APEX$ROW_STATUS 2.9.4.3

- APP_ALIAS 2.9.4.5

- APP_DATE_TIME_FORMAT 2.9.4.7

- APP_ID 2.9.4.4

- APP_IMAGES 2.9.4.8

- APP_NLS_DATE_FORMAT 2.9.4.9

- APP_NLS_TIMESTAMP_FORMAT 2.9.4.10

- APP_NLS_TIMESTAMP_TZ_FORMAT 2.9.4.11

- APP_PAGE_ALIAS 2.9.4.12

- APP_PAGE_ID 2.9.4.13

- APP_REQUEST_DATA_HASH 2.9.4.14

- APP_SESSION 2.9.4.15

- APP_SESSION_VISIBLE 2.9.4.16

- APP_TITLE 2.9.4.17

- APP_UNIQUE_PAGE_ID 2.9.4.18

- APP_USER 2.9.4.19

- Application Express SCHEMA OWNER 2.9.4.36

- AUTHENTICATED_URL_PREFIX 2.9.4.20

- BROWSER_LANGUAGE 2.9.4.21

- カレンダ 24.5.3

- CURRENT_PARENT_TAB_TEXT 2.9.4.22

- DEBUG 2.9.4.23

- アプリケーション・アイテム用 2.9.1

- ページ・アイテム用 2.9.1

- IMAGE_PREFIX 2.9.4.25

- ページ・テンプレート内 11.3.14

- JET_BASE_DIRECTORY 2.9.4.26

- JET_CSS_DIRECTORY 2.9.4.27

- JET_JS_DIRECTORY 2.9.4.28

- LOGOUT_URL 2.9.4.30

- 出力のエスケープ 2.9.2 11.3.3

- PRINTER_FRIENDLY 2.9.4.31

- PROXY SERVER 2.9.4.32

- PUBLIC_URL_PREFIX 2.9.4.33

- サポート対象に関するレポート 11.2.11.5

- REQUEST 2.9.4.34

- SQLERRM 2.9.4.37

- 静的 6.5.1.2.6

- リージョン・フッターでサポート 12.5.2.3, 12.6.3.3

- SYSDATE_YYYYMMDD 2.9.4.38

- THEME_DB_IMAGES 2.9.4.39

- THEME_IMAGES 2.9.4.40

- 理解 2.9

- テンプレート内での使用方法 2.9.3

- 使用 2.9.1

- テンプレート内 2.9.1

- WORKSPACE_ID 2.9.4.42

- WORKSPACE_IMAGES 2.9.4.41

- 成功メッセージ, ページ・プロセスの作成 15.3.2.4, 15.3.3.4

- サポートされるチャート

- Oracle JavaScript拡張機能ツールキット(Oracle JET) 10.3.1

- サポートされるオブジェクト

- 作成 23.5.2

- 削除 23.5.7

- 「サポートするオブジェクト」アイコン 1.4.4.2

- SVGチャート

- 他の言語での表示 24.2.6.5

- Flashへの移行 24.2.6.1.2

- CSSスタイル・インラインの参照 24.2.6.4

- カスタムCSSの参照 24.2.6.3

- アップグレードの制限 24.2.6.1.1

- すべてのHTML5へのアップグレード 24.2.6.1.3

- HTML5へのアップグレード 24.2.6.1.2

- SVGチャート, CSSクラスの概要 24.2.6.2

- 切替え

- 構成 16.2.6

- 切替えアイテム・タイプ A.1

- 構文, 動的リスト 16.7.4.2

- システム・メッセージ 1.3.3

T

- タブ

- タブ・ページについて 14.2.2

- 追加 14.2

- 「条件付き表示」レポート 14.2.6

- 標準タブの作成 14.2.5.2

- 標準タブ・セットの作成 14.2.5.2

- 作成 14.2.2, 14.2.4

- 編集 14.2.5

- 複数の編集 14.2.5.1

- 履歴レポート 14.2.6

- 管理 14.2.2

- 別の親への標準の移動 14.2.5.2

- 親 14.2.1

- 標準名の変更 14.2.5.2

- レポート 14.2.6

- 順序の変更 14.2.5.2

- 標準 14.2.1

- 標準タブのタスク 14.2.5.2

- テンプレートのサポート 14.2.3

- 使用状況レポート 14.2.6

- 表ファインダ 6.7

- 表, 検索 6.7.5

- 表ファインダ 6.7.5

- タブ・レポート

- 条件付き表示 14.2.6

- 履歴 14.2.6

- タブ・ページ 14.2.2

- 表形式フォーム

- 作成 24.4

- ページ・プロセスの作成 15.3.3.1.2

- タグ・クラウド4.3

- チーム開発

- アクセス 4.1

- 機能ダッシュボード 4.4.1, 4.4.6.1

- ホームページ 4.2

- バグの管理 4.7

- フィードバックの管理 4.8, 4.8.5.2

- リンクの管理 4.9.9

- ニュース・エントリの管理 4.9.8

- To Doの管理 4.6

- 「ニュース」リージョン 4.2

- データのパージ 4.9.7

- 機能の追跡 4.4

- マイルストンの追跡 4.5

- ユーティリティ 4.2

- チーム開発のファイル添付

- 表示 4.9.6

- チーム開発ユーティリティ 4.9

- アクセス 4.9.1

- マイルストンの割当て 4.9.4

- 期日を超過した機能のマイルストンの変更 4.9.4

- チーム開発の設定の構成 4.9.2

- フォーカス領域の編集 4.9.5

- ファイル・アップロードのサポートの有効化 4.9.1

- フォーカス領域の管理 4.9.1

- リンクの管理 4.9.1

- ニュースの管理 4.9.1

- アップロードしたファイルの管理 4.9.1

- リンクの管理 4.9.9

- ニュース・エントリの管理 4.9.8

- データのパージ 4.9.1

- データのパージ 4.9.7

- オープンな機能の期限のプッシュ 4.9.4

- 期限経過したバグのプッシュ 4.9.1

- リリース・サマリー 4.9.3

- 「リリース・サマリー」レポート 4.9.1

- マイルストン日付への機能の期日の設定 4.9.4

- チーム開発の設定 4.9.1

- 割当て先の更新 4.9.1

- 添付ファイルの表示 4.9.6

- テンプレート編集履歴 11.3.7

- テンプレート・オプションの事前設定 11.1.5.3

- テンプレート・オプション

- 概要 11.1.5.1

- デフォルト 11.1.5.2

- グループ 11.1.5.3

- 事前設定 11.1.5.3

- 使用 11.1.5

- テンプレート・オプション・グループ 11.1.5.3

- テンプレート

- ブレッドクラム 11.3.9

- ボタン 11.3.10

- デフォルトの変更 11.1.7

- 列 11.3.17.2.5, 11.3.17.4

- 作成 11.3.5

- カスタマイズ 11.3

- ラベル 11.3.12

- レガシー・カレンダ 11.3.11

- リスト 11.3.13

- 管理 11.3.8

- ページ 11.3.14

- ポップアップLOV 11.3.15

- 公開 11.3.8.7

- リージョン 11.3.16

- 置換 11.3.8.3

- すべて置換 11.3.8.4

- レポート 11.3.17

- ページに対する選択 11.3.4.2

- テーマのデフォルトの選択 11.3.4.1

- サポートされる置換文字列 11.2.11.5

- サブスクライブ解除 11.3.8.6

- 特定のページの表示 11.3.8.2

- 履歴レポートの表示 11.3.7

- テンプレート・ページでの表示 11.3.8.1

- パブリッシュ・レポートの表示 11.3.7

- リージョン位置の使用状況の表示 11.3.8.5

- レポートの表示 11.3.7

- サブスクリプション・レポートの表示 11.3.7

- 使用状況レポートの表示 11.3.7

- テキスト領域アイテム・タイプ A.1

- テキスト・フィールド・アイテム・タイプ A.1

- テキスト文字列 20.6.4

- 翻訳 20.6.2

- テキスト文字列, 翻訳 20.6

- オートコンプリートが有効なテキスト・フィールド・アイテム・タイプ A.1

- テーマ属性 11.1.7.2

- ブレッドクラム 11.1.7.2.4, 11.1.7.2.5

- ボタン 11.1.7.2.4

- チャート 11.1.7.2.5

- クラシック・レポート 11.1.7.2.4

- CSSファイルのURL 11.1.7.2.3

- カスタム・クラス 11.1.7.2.9

- カスタム・イメージ 11.1.7.2.10

- カスタム・ライブラリ・ファイルURL 11.1.7.2.9

- カスタム接頭辞クラス 11.1.7.2.9

- 日付ピッカー・アイコン属性 11.1.7.2.9

- 日付ピッカー・アイコン名 11.1.7.2.9

- デフォルトのラベル 11.1.7.2.4

- ダイアログ・ボタン・リージョン 11.1.7.2.6

- ダイアログ・コンテンツ・リージョン 11.1.7.2.6

- ダイアログ・ページ 11.1.7.2.6

- エラー・ページ 11.1.7.2.4

- ファイル 11.1.7.2.12

- フッター・ツールバー 11.1.7.2.4

- フォーム 11.1.7.2.5

- グローバル・テンプレート・オプション 11.1.7.2.8

- ヘッダー・ツールバー 11.1.7.2.4

- 対話モード・レポート 11.1.7.2.5

- JavaScript ファイルURL 11.1.7.2.3

- レガシー・カレンダ 11.1.7.2.4

- ライブラリ 11.1.7.2.9

- リスト 11.1.7.2.4

- リスト 11.1.7.2.5

- ログイン・ページ 11.1.7.2.4

- 名前, アプリケーション 11.1.7.2.1

- 名前, 説明 11.1.7.2.1

- 名前, 名前 11.1.7.2.1

- 名前, ナビゲーション・バー実装 11.1.7.2.1

- 名前, ナビゲーション・タイプ 11.1.7.2.1

- 名前, テーマ番号 11.1.7.2.1

- 名前, ユーザー・インタフェース 11.1.7.2.1

- ナビゲーション・バー・リスト 11.1.7.2.4

- ナビゲーション・メニュー・リスト(トップ) 11.1.7.2.4

- ナビゲーション・メニュー・リストの位置 11.1.7.2.4

- オプションのラベル 11.1.7.2.4

- ページ 11.1.7.2.4

- ページ・テンプレート・オプション 11.1.7.2.4

- ページ遷移 11.1.7.2.7

- ポップアップ遷移 11.1.7.2.7

- 印刷用ページ 11.1.7.2.4

- リージョン 11.1.7.2.4

- レポート 11.1.7.2.5

- 必須ラベル 11.1.7.2.4

- スタイル 11.1.7.2.11

- 表形式フォーム 11.1.7.2.5

- テーマのサブスクリプション 11.1.7.2.2

- ウィザード 11.1.7.2.5

- テーマ・レポート

- アプリケーション・テンプレート 11.2.11.1

- クラス参照 11.2.11.4

- クラス参照 11.2.11.4

- ファイル参照 11.2.11.3

- ファイル参照 11.2.11.3

- サポートされる置換文字列 11.2.11.5

- テンプレート数 11.2.11.2

- テーマのテンプレート 11.2.11.1

- テンプレート置換文字列 11.2.11.5

- テーマ・テンプレート数 11.2.11.2

- テーマ・ローラー 7.6, 24.1.7

- 使用 11.1.4.6

- テーマ

- 概要 11.1.1

- サブスクリプションについて 11.2.1

- アクセス 11.1.6

- IDの変更 11.2.4

- 識別番号(ID)の変更 11.2.4

- コピー 11.2.5

- 作成 11.2.2

- マスター・アプリケーションの作成 11.2.7

- デフォルト・テンプレート 11.1.7

- 削除 11.2.6

- 編集 11.1.7

- テーマ属性の編集 11.1.7.2

- エクスポート 11.2.10, 23.6.9, 23.6.10

- エクスポートおよびインポート 11.2.10

- 異なるIDを使用したエクスポート 11.2.4

- グリッドベース 11.1.3

- インポート 11.2.10, 23.7.5

- ライブ・テンプレート・オプション 11.3.6.3.3

- 管理 11.1

- レポート 11.2.11

- ページ・レベル・テンプレートの選択 11.3.4.1

- 切替え 11.2.3

- ユニバーサル・テーマへの切替え 11.2.3.2

- テーマ・ページ 11.1.6

- テーマ・スタイル 11.1.4

- 使用 11

- テーマ・ページ

- 共有コンポーネントからのアクセス 11.1.6

- テーマ・スタイル 11.1.4

- 概要 11.1.4.1

- 作成 11.1.4.2

- 削除 11.1.4.3

- 編集 11.1.4.3

- ユーザー・インタフェース・ページからの編集 11.1.4.4

- テーマ・ローラー 11.1.4.6

- 使用 11

- テーマのサブスクリプション

- 概要 11.2.1, 11.2.1.1

- 変更 11.2.1.2

- リフレッシュ 11.2.1.4

- 再サブスクライブ 11.2.1.6

- サブスクライブ解除 11.2.1.5

- リフレッシュの検証 11.2.1.3

- To Doレポート

- カレンダ・ページ 4.6.5.1

- 進捗ログ 4.6.5.2

- To Do

- ファイルの添付 4.6.4

- 作成 4.6.2

- 管理 4.6

- To Doページ 4.6.1

- タスクの更新 4.6.3

- 表示 4.6.1

- レポートの表示 4.6.5

- 翻訳可能なメッセージ, 定義 20.6.2.2

- 翻訳 20.6.4

- PL/SQLプロシージャでのメッセージ 20.6.2

- 変換 20.1

- アプリケーション 20.1

- 動的 20.7

- 動的テキスト文字列 20.1.5.1

- 動的翻訳 20.1.5.3

- 手動編集 20.5.6

- テキストのエクスポート 20.5.2

- グローバリゼーション・サポート 20.1

- 言語の指定 20.1.2

- プライマリ・アプリケーションIDのマッピング 20.5.1

- ターゲット・アプリケーションIDのマッピング 20.5.1

- メッセージ 20.1.5.1, 20.1.5.2

- リージョン・タイトル 20.1.5.4

- ルール 20.1.3

- シード 20.5.2

- ショートカット 20.1.5.1

- ステップ 20.5

- テンプレート 20.1.5.5

- 翻訳ファイル 20.5.2.2

- 理解 20.5

- アプリケーション・レンダリングの理解 20.1.4

- XLIFF 20.5.2.2

- XLIFFターゲット要素 20.5.2.2.4

- 翻訳ファイル 20.5.2.2

- 公開 20.5.4

- アップロード 20.5.4

- ツリー

- 概要 13.6.1

- 作成 13.6, 13.6.3.2, 13.6.4.1

- 新しいページでの作成 13.6.3.1

- 属性の編集 13.6.3.3, 13.6.4.2

- コンポーネント・ビューでの管理 13.6.4

- ページ・デザイナでの管理 13.6.3

U

- ユニバーサル・テーマ

- 移行ガイド 11.2.3.2

- 切替え 11.2.3.2

- ユニバーサル・テーマ - 42 11.1.2, 11.1.3

- ロック解除, 生産性アプリケーション 3.2.6

- 未保存の変更

- ユーザーへの警告 7.4.5, 13.2.3.7, 13.5.2.4

- 「アプリケーションのアップグレード」アイコン 6.13.3.1, 6.13.3.2

- URL

- 公開 23.9, 23.10

- SSL有効 12.7

- 構文 2.7

- ユーザー・アイデンティティ

- 証明 19.4

- 確認 2.4.4

- ユーザー・インタフェース

- 概要 1.2, 1.2.1

- モバイル・アプリケーションについて 2.2.3

- 選択について 2.2.1

- 制御 11

- 設計の管理 2.2

- ユーザー・インタフェース属性

- 新規ユーザー・インタフェースの追加 6.5.4.2.5

- 構成 6.5.4

- CSSファイルのURL 6.5.4.2.4

- ファビコン 6.5.4.2.3

- ファビコンHTML 6.5.4.2.3

- イメージ接頭辞 6.5.4.2.1

- ロゴ 6.5.4.2.2

- メディア・タイプ 6.5.4.2.1

- 静的ファイルの接頭辞 6.5.4.2.1

- ユーザー・インタフェースの検出 6.5.4.2.4

- ユーザー・インタフェース 6.5.4.2.5

- ユーザー・インタフェースのデフォルト値

- エクスポート 23.6.11

- インポート 23.7.6

- ユーザー・インタフェースの詳細 6.5.4.5

- 自動検出 6.5.4.5.2

- 連結されたファイル 6.5.4.5.7

- コンテンツ配信ネットワーク 6.5.4.5.5

- デフォルト 6.5.4.5.2

- 表示名 6.5.4.5.1

- テーマ・スタイルを選択できるようにエンド・ユーザーを有効化 6.5.4.5.2

- ファイルURL 6.5.4.5.5, 6.5.4.5.6

- グローバル・ページ 6.5.4.5.2

- ホームURL 6.5.4.5.2

- jQuery移行を含める 6.5.4.5.5

- レガシーJavaScriptを含める 6.5.4.5.5

- 実装 6.5.4.5.4

- リスト・テンプレート 6.5.4.5.3, 6.5.4.5.4

- ログインURL 6.5.4.5.2

- ナビゲーション・バー・リスト 6.5.4.5.4

- ナビゲーション・メニュー・リスト 6.5.4.5.3

- 位置 6.5.4.5.3

- 順序 6.5.4.5.1

- テンプレート・オプション 6.5.4.5.3, 6.5.4.5.4

- テーマ 6.5.4.5.2

- テーマ・スタイル 6.5.4.5.2

- ユーザー・インタフェース・タイプ 6.5.4.5.1

- ユーザー・プリファレンス

- デフォルト・スキーマ 1.6

- 編集 1.6

- レガシー・コンポーネント・ビューの有効化 1.6

- 新しいウィンドウでの実行 1.6

- 単一ウィンドウの使用 1.6

- ユーザー・ロール

- 開発者 19.1.1

- Oracle Application Express管理者 19.1.1

- ワークスペース管理者 19.1.1

- ユーザー

- 管理について 19.1.8.2

- ユーティリティ

- アプリケーション用にアクセス 6.13

- 「ユーティリティ」アイコン 1.4.4.2

V

- 検証

- 概要 15.2, 15.2.1

- アイテムとの関連付け 9.5.2, 9.5.3

- 作成 15.2.2.1, 15.2.2.2

- アイテム用に作成 15.2.2

- ページ用に作成 15.2.2, 15.2.3.2

- ページ・アイテム用に作成 15.2.3.1

- 表形式フォーム列用に作成 15.2.3.3

- 表形式フォーム行用に作成 15.2.3.4

- エラー・メッセージとともに作成 9.5.1

- エラー・メッセージの定義 15.2.5

- 編集 15.2.3.5

- 「エラーに移動」リンク 15.2.7

- 条件付きにする 15.2.6

- 「対象ボタン」属性 2.9.4.35.2

- 「バージョン」属性 6.5.1.2.1

- Vファンクション 2.8.1

- ビュー, データの表示 6.13.7

W

- ウォレット, 作成 19.1.6.4

- 保存されていない変更の警告 7.4.5, 13.2.3.7

- Webサービス・プロセス

- プロセスの編集 17.3.11

- 静的値への入力パラメータのマッピング 17.3.11

- Webサービス参照 17.3.2

- 作成 17.3.4

- フォームの作成 17.3.9

- フォームおよびレポートの作成 17.3.8

- 手動作成 17.3.5, 17.3.5.3

- WSDLの指定 17.3.4.2

- 履歴の表示 17.3.12

- Webサービス参照ページ 17.3.2.1

- Webサービス 17.3

- WSDLからの参照の作成 17.3.4.3

- RESTful Webサービスの作成 17.3.6.2

- レポートでのWebサービス結果の表示 17.3.10.2

- Webサービス・プロセスの編集 17.3.11

- プロセスとしての起動 17.3.10

- RESTful Webサービス

- レポート・リージョンの公開 17.3.13

- プロキシ・サーバー・アドレスの指定 17.3.2.2

- SSL有効 17.3.3

- RESTful Webサービス参照のテスト 17.3.6.3

- Webサービス参照の手動でのテスト 17.3.5.3

- 使用 17.3.2

- Webサービス参照履歴の表示 17.3.12

- Webサービス参照リポジトリ 17.3.7

- Webサービス参照ページ 17.3.2.1

- Webシート・アプリケーション

- 概要 2.1.3.2, 5

- アクセス制御リスト 5.10

- アクセス制御 5.10

- ページのコピー 5.3

- 作成 5

- アクセス制御リスト・エントリの作成 5.10.3

- 「アプリケーション・ビルダー」から作成 5.2.1

- 実行中のWebシートからの作成 5.2.2

- 削除 5.6

- ページ詳細の編集 5.5

- アクティビティの監視 5.8

- 実行 5.4

- アクセス制御リストの指定 5.10.2

- Webシート・プロパティの理解 5.9

- Webシート・ダッシュボードの表示 5.7

- Webシート認証

- Application Expressアカウント 5.9.2.5

- カスタム 5.9.2.5

- LDAP 5.9.2.5

- シングル・サインオン 5.9.2.5

- Webシート・ダッシュボード, 表示 5.7

- Webシート・プロパティ

- 概要 5.9.2

- アクセス制御リスト・タイプ 5.9.2.6

- パブリック・アクセスを許可 5.9.2.6

- アプリケーション日付書式 5.9.2.1

- 認証 5.9.2.5

- Cookieドメイン 5.9.2.5

- Cookie名 5.9.2.5

- Cookieパス 5.9.2.5

- デフォルトのアプリケーション言語 5.9.2.1

- デフォルトのアプリケーション地域 5.9.2.1

- 説明 5.9.2.2

- 編集 5.9.1

- SQLアクセスの編集 5.9.2.7

- ホームページ 5.9.2.1

- ログイン・メッセージ 5.9.2.2

- ロゴ 5.9.2.3

- ロゴ・タイプ 5.9.2.3

- ログアウトURL 5.9.2.5

- 名前 5.9.2.1

- 所有者 5.9.2.2

- セキュア 5.9.2.5

- パスワードのリセットの表示 5.9.2.1

- ステータス 5.9.2.1

- スタイル 5.9.2.4

- Webシートの電子メール送信元アドレス 5.9.2.1

- Webシート

- ナビゲーションについて 3.4.3

- 編集 3.4.4

- 変更 3.4.4

- ナビゲート 3.4.2

- ナビゲーションの理解 3.4.3.1

- ブレッドクラムの使用 3.4.2

- ウィザード

- ページの作成 6.6.1

- ブランチの作成 14.5.2

- カレンダの作成 10.1

- チャートの作成 10.3

- レガシー・チャートの作成 24.2

- リストの作成 16.7.3.1, 16.7.4.1

- LOVの作成 16.6.2

- アプリケーションの作成 2.1.4

- ページ計算の作成 15.1.1, 15.1.3.1, 17.3.10.1

- ページ・プロセスの作成 15.3.3.1

- アプリケーションの作成 2.1

- リージョンの作成 12.6.2

- ナビゲーション・バー・エントリの作成 10.4.4, 14.4.2.1, 14.4.2.2, 14.4.3

- 検証の作成 15.2.3.1, 15.2.3.2, 15.2.3.3, 15.2.3.4

- ワークスペース

- 検索 1.3.4.1

- ワークスペース・アクティビティ・レポート

- アプリケーション・エラー 21.3.3

- 開発者アクティビティ 21.3.3

- 環境 21.3.3

- ログイン試行回数 21.3.3

- ページ・ビューの分析 21.3.3

- ページ・ビュー 21.3.3

- セッション 21.3.3

- ワークスペース・スキーマ・レポート 21.3.3

- ワークスペース管理者 19.1.1

- ワークスペースのホームページ

- 「アクセシビリティ・モード」リージョン 1.3.6

- 「管理」メニュー 1.3.4.2

- 「使用可能な更新」リージョン 1.3.5

- ニュース・エントリ 1.3.3

- システム・メッセージ 1.3.3

- 「トップ・アプリケーション」リージョン 1.3.2

- 「トップ・ユーザー」リージョン 1.3.2

- ワークスペースのニュース

- 管理 4.9.8

- ワークスペースの割当て, セルフ・サービスの有効化 19.1.6.1

- ワークスペース, 管理 19.1.8

- ワークスペース設定, 構成 19.1.7

- ワークスペース・テーマ

- 追加 11.2.8.1

- 削除 11.2.8.3

- エクスポート 11.2.8.5

- 管理 11.2.8, 11.2.9

- 変更 11.2.8.4

- 既存の表示 11.2.8.2

- スキーマへのワークスペースの割当て, 管理 19.1.8.1

- ワークスペース・ユーティリティ

- アプリケーション・ビルダーのデフォルト値 1.4.2.5

- Application Expressビュー 1.4.2.5

- アプリケーション・グループ 1.4.2.5

- アプリケーション間レポート 1.4.2.5

- エクスポート 1.4.2.5

- ニュースの管理 1.4.2.5

- ワークスペース・テーマ 1.4.2.5

- WSDLドキュメント 17.3.2

X

- XLIFF 20.5.2.2

- 適用 20.5.4.2

- アップロードしたドキュメントの削除 20.5.4.3

- ターゲット要素 20.5.2.2.4

- アップロード 20.5.4.1

- アップロードおよび公開 20.5.4

Z

- Zipファイル

- 静的アプリケーション・ファイルのダウンロード 16.3.5.2

- 静的ワークスペース・ファイルのダウンロード 16.4.4.2

Oracleの法律上の注意点

コピーライト

Copyright © 1994-2018, Oracle and/or its affiliates. All rights reserved.

ライセンス制約の保証と結果的に生じる損害の免責

このソフトウェアおよび関連ドキュメントの使用と開示は、ライセンス契約の制約条件に従うものとし、知的財産に関する法律により保護されています。ライセンス契約で明示的に許諾されている場合もしくは法律によって認められている場合を除き、形式、手段に関係なく、いかなる部分も使用、複写、複製、翻訳、放送、修正、ライセンス供与、送信、配布、発表、実行、公開または表示することはできません。このソフトウェアのリバース・エンジニアリング、逆アセンブル、逆コンパイルは互換性のために法律によって規定されている場合を除き、禁止されています。

保証免責

ここに記載された情報は予告なしに変更される場合があります。また、誤りが無いことの保証はいたしかねます。誤りを見つけた場合は、オラクルまでご連絡ください。

制限付権利について

このソフトウェアまたは関連ドキュメントを、米国政府機関もしくは米国政府機関に代わってこのソフトウェアまたは関連ドキュメントをライセンスされた者に提供する場合は、次の通知が適用されます。

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 Corporationおよびその関連会社は一切の責任を負いかねます。

商標と登録商標について

OracleおよびJavaはオラクルおよびその関連会社の登録商標です。その他の社名、商品名等は各社の商標または登録商標である場合があります。

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およびその関連会社は、第三者のコンテンツ、製品、サービスへのアクセスまたは使用によって損失、費用、あるいは損害が発生しても一切の責任を負いかねます。

Pre-General Availability (一般提供前)版のドキュメントについて

このドキュメントがPre-General Availability (一般提供前)版の場合:

このドキュメントはPre-General Availability (一般提供前)版であり、デモおよび暫定使用のみを目的としたものです。このソフトウェアを使用するハードウェアに限定するものではありません。Oracle Corporationおよびその関連会社は、このドキュメントに関して一切の責任を負わず、いかなる保証もいたしません。また、このドキュメントを使用したことによって損失、費用、あるいは損害が発生しても、一切の責任を負いかねます。

非公開のPre-General Availability (一般提供前)版のドキュメントについて

このドキュメントが非公開のPre-General Availability (一般提供前)版の場合:

このドキュメントに含まれる情報は、情報の共有のみを目的としたものであって、顧客諮問委員会(Customer Advisory Board)のメンバーとしてのお客様の立場でのみ、またはお客様のPre-General Availability Trial Agreement (Pre-GAトライアル契約)のみに従って検討されるべきものとします。マテリアル、コード、または機能の提供をお約束するものではなく、購入決定を行う際の判断材料とすべきではありません。このドキュメントに記載されている特徴または機能の開発、リリースおよび時期については、オラクルの裁量により決定されます。

このドキュメントには、ソフトウェアまたは印刷物などの形式を問わず、オラクルが独占的な権利を有する財産的情報が含まれています。この機密資料へのアクセスと使用は、お客様とオラクルとの間で締結され、お客様が遵守に同意した、Oracle Master Agreement、Oracle License and Oracle Services Agreement (オラクル・ライセンスおよびサービスに関する契約書)、Oracle Partner Network Agreement、Oracle Distribution Agreementまたはその他のライセンス契約の条件に従うものとします。このドキュメントとその内容の開示、コピー、複製および配布には、オラクルによる事前の承諾を必要とします。このドキュメントはライセンス契約の一部となるものではなく、オラクルおよびその子会社や関連会社との契約を構成するものではありません。

ドキュメントのアクセシビリティ

オラクルのアクセシビリティについての詳細情報は、Oracle Accessibility ProgramのWebサイト(http://www.oracle.com/pls/topic/lookup?ctx=acc&id=docacc)を参照してください。

Oracle Supportへのアクセス

サポートをご契約のお客様には、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)を参照してください。