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

リリース4.2

B71110-01(原本部品番号:E35125-02)

目次

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

はじめに

- トピック概要

- 対象読者

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

- 関連ドキュメント

- 表記規則

このリリースでの変更点

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

1 クイック・スタート

- Oracle Application Expressの概要

- Oracle Application Expressについて

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

- Oracle Application Expressへのログイン

- ブラウザ要件について

- Oracle Application Express環境の構成

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

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

- Oracle Application Expressドキュメントについて

- オンライン・ドキュメント・ライブラリへのアクセス

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

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

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

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

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

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

- ページの概要

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

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

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

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

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

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

- セッションの概要

- セッションIDの理解

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

- URL構文の理解

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

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

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

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

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

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

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

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

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

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

- 置換文字列の理解

- 置換文字列の使用

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

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

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

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

- パッケージ・アプリケーション・ページへのアクセス

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

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

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

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

- インストールしたパッケージ・アプリケーションのエクスポート

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

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

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

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

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

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

- 「サンプルWebシート - AnyCo IT部門」について

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

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

- AnyCo IT部門の理解

- 共通のWebシート・ユーザー・インタフェース要素

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

4 開発プロセスの管理

- チーム開発のホームページについて

- 機能の追跡

- 機能の表示

- 機能の作成

- 機能の更新

- 機能へのファイルの添付について

- 機能レポートの表示

- マイルストンの追跡

- マイルストンの表示

- マイルストンの作成

- マイルストンの更新

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

- To Doの追跡

- To Doの表示

- To Doの作成

- To Doの更新

- To Doへのファイルの添付について

- To Doレポートの表示

- バグの管理

- バグの表示

- バグの作成

- バグの編集

- バグへのファイルの添付について

- バグ・レポートの表示

- フィードバックの管理

- フィードバックの表示

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

- フィードバックの確認

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

- タグ・サマリーの利用

- チーム・アクションの管理

- リンクの管理

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

- チーム開発の設定の管理

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

- ユーティリティについて

- フォーカス領域の編集

- 機能、To Doおよびバグへの添付ファイルの表示

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

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

- Webシート・ページとセクション間のナビゲート

- 言語について

- 「ヘルプ」リンクについて

- 「ビルダー」リンクについて

- 「ログアウト」リンクについて

- Webシート検索について

- コントロール・パネルについて

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

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

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

- Webシートの実行

- 新しいページの追加

- 既存のページのコピー

- ページの詳細の編集

- Webシートの削除

- ページ・セクションの追加と編集について

- セクション・タイプについて

- セクションの編集について

- ページ・セクションの削除

- セクション・タイトルと表示順序の編集

- テキスト・セクションについて

- テキスト・セクションの追加

- テキスト・セクションの編集

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

- ナビゲーション・セクションの追加

- データ・グリッドの追加について

- データ・グリッドについて

- データ・グリッドの作成

- データ・グリッドのコピー

- データ・グリッドの表示と編集

- データ・グリッドの変更履歴ログの表示

- データ・グリッドの削除

- データ・コンテンツの追加と編集について

- 使用できるデータ・ソース

- データ・レポートの作成に対するサポートの有効化について

- Webシート・ページへのデータの組込み

- データ・レポートの追加について

- データ・レポートについて

- データ・レポートの作成

- データ・レポートの表示と変更

- データ・レポートの削除

- データ・セクションについて

- ページへのデータ・セクションの追加

- データ・セクションの編集

- チャート・セクションについて

- チャート・セクションの追加

- チャート・セクションの編集

- PL/SQLセクションについて

- PL/SQLセクションの追加

- PL/SQLセクションの編集

- マークアップ構文の理解

- ページへのリンク

- セクションへのリンク

- 外部URLへのリンク

- データ・グリッドへのリンク

- SQLおよびSQLVALUE構文の使用

- 高度なデータ・グリッド問合せのルールについて

- 注釈の管理

- アップロード済ファイルとイメージの管理

- タグの追加

- ノートの追加

- 注釈の表示と削除

- Webシート・アプリケーションの管理

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

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

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

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

- Webシート・パスワードの変更

- Webシート・ページの電子メール送信

- Webシート・ページの出力

- Webシートの表示

- プレゼンテーション・モードについて

- ページ・ディレクトリの表示

- ページ履歴の表示

- Webシート・ディレクトリの表示

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

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

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

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

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

- ページ・メタデータの検索

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

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

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

- スプレッドシートからのアプリケーションの作成

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

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

- サンプル・アプリケーションのインストール

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

- アプリケーション・モデルとユーザー・インタフェースのデフォルト値について

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

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

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

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

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

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

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

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

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

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

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

- ページのグループ化

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

- ページの削除

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

- データベース・アプリケーション・コメントの作成および編集

- 開発者コメントの追加

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

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

- 開発者コメントの削除

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

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

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

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

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

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

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

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

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

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

- 「ページ定義」でのアイテムの表示

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

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

- アイテム値の参照

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

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

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

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

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

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

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

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

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

- ページ固有のユーティリティについて

- クロス・ページ・ユーティリティについて

- アプリケーション間レポートについて

8 データベース・アプリケーション・ページの操作

- 「ページ定義」について

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

- ツリー・ビューとコンポーネント・ビューについて

- ツリー・ビューでのページの編集

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

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

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

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

- 「ページ定義」の共通要素

- ページ属性の変更

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

- ページ 属性について

- ページ計算の理解

- ページ計算の作成

- 計算ポイントおよび計算構文の理解

- ページ計算属性の編集

- 検証の理解

- アイテムおよびページ検証の作成

- 検証の実行タイミングの決定

- 検証エラー・メッセージの表示方法の定義

- 検証の条件付き実行

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

- 「ページ・プロセスの作成について」

- ページ・プロセス属性の編集

- ページ・プロセスを実行するタイミングの制御

- ページ・プロセスの成功メッセージとエラー・メッセージの作成

- ページ・プロセスを条件付きにする

- ブランチの操作

- ブランチ・ポイントおよびブランチ・アクションの定義

- 条件付きブランチ処理

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

9 レポートの作成

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

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

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

- 検索バーの使用

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

- 「列ヘッダー」メニューの使用

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

- 表示する列の選択

- フィルタの追加

- ページごとの行数の指定

- 列のソート順序の選択

- コントロール・ブレークの作成

- ハイライトの追加

- 列の計算

- 列の集計

- 「アクション」メニューからのチャートの作成

- 列のグループ化

- フラッシュバック問合せの実行

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

- レポートのリセット

- レポートのダウンロード

- 電子メールで送信されるレポートのサブスクライブ

- 開発者としての対話モード・レポートの編集

- 対話モード・レポートの属性ページへのアクセス

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

- 列グループの作成

- 対話モード・レポートのページ区切りの制御

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

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

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

- リンク列の理解

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

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

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

- 対話モード値レポートの列の書式設定

- アイコン・ビューの有効化

- 詳細ビューの有効化

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

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

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

- 開発者としての保存されたレポートの管理

- 保存済のレポートのアクティビティの表示

- クラシック・レポートの編集

- クラッシック・レポートの属性へのアクセス

- 列属性を使用したクラシック・レポートのレイアウト変更

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

- クラシック・レポートでの列ソートの有効化

- クラシック・レポートへのダウンロード・リンクの追加

- クラシック・レポートのCSV出力オプションの有効化

- XMLファイルまたはCSVファイルとしてのクラシック・レポートのエクスポート

- クラシック・レポートでの列リンクの作成

- クラシック・レポートでの更新可能な列の定義

- クラシック・レポートでのLOVとしての列定義

- クラシック・レポートの列の表示条件の制御

- クラシック・レポートでの列ブレークの制御

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

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

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

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

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

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

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

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

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

10 データベース・アプリケーション・コンポーネントおよびコントロールの追加

- フォームの作成

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

- 表形式フォームの作成

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

- フォームの手動作成

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

- カレンダの作成

- カレンダの作成について

- サンプル・カレンダの表示

- 簡易カレンダの作成

- SQLカレンダの作成

- カレンダ属性の編集

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

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

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

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

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

- マップの作成

- Flashマップのサポートについて

- 既存ページへのFlashマップの追加

- 新しいページへのFlashマップの追加

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

- Flashマップ属性の編集

- FlashマップでのカスタムXMLの使用

- 非同期更新の有効化

- チャートの作成

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

- HTML5チャートの作成について

- Flashチャートの作成について

- SVGチャートについて

- HTMLチャートについて

- チャート属性の編集

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

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

- 非同期更新の有効化

- ボタンの作成

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

- コンポーネント・ビューでの複数のボタンの作成

- ボタンの編集

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

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

- ボタンの条件付き表示

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

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

- 静的LOVについて

- 既存のLOVの編集

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

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

- ショートカットの使用

- ショートカット・タイプについて

- ショートカットの定義

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

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

- ツリーの作成

- ツリーの作成

- 開発者としてのツリーの編集

- 共有コンポーネントとして作成されたツリーについて

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

- JavaScript属性を利用したJavaScriptの組込み

- HTMLヘッダー属性からのJavaScriptファイルのコール

- ページ・テンプレートからのJavaScriptファイルのコール

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

- 動的アクションを使用したJavaScriptのコール

- jQueryとjQuery UIサポートについて

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

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

- 印刷用ページの最適化

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

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

- ヘルプ・ページの作成

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

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

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

11 ナビゲーションの追加

- タブの作成

- タブについて

- タブ・ページについて

- タブの作成

- タブの編集

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

- リストの作成

- リスト・タイプについて

- 静的リストについて

- 動的リストについて

- リストのコピー

- リージョンの作成によるページへのリストの追加

- リスト属性の編集

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

- ブレッドクラムの作成

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

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

- ブレッドクラムの編集

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

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

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

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

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

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

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

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

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

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

- ブランチの作成

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

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

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

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

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

- リージョンの理解

- リージョンの作成

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

- リージョンの編集

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

- リージョンのコピー

- リージョンの削除

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

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

- イメージの管理

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

- イメージの参照

- イメージ属性の編集

- イメージの削除

- 静的ファイルの管理

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

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

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

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

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

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

- テーマの管理

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

- テーマの編集

- テーマの作成

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

- テーマのコピー

- テーマの削除

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

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

- テーマ識別番号の変更

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

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

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

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

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

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

- テンプレートの管理

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

- ボタン・テンプレート

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

- ラベル・テンプレート

- リスト・テンプレート

- ページ・テンプレート

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

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

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

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

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

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

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

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

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

- Oracle Application Express Advisorについて

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

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

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

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

- デバッグの有効化と無効化

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

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

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

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

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

- ページ・レポートの表示

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

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

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

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

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

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

- Secure Sockets Layer(SSL)の使用

- Oracle BI Publisherとの統合

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

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

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

- Oracle Database 11gおよびOracle Database 12cのネットワーク・サービスの有効化

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

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

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

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

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

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

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

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

- 認証の仕組みの理解

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

- 認証スキームの作成

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

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

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

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

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

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

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

- 認可スキームの作成

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

- 認可レポートの表示

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

- テーマのエクスポート

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

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

- フィードバックのエクスポート

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

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

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

- Webシートのインポート

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

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

- イメージのインポート

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

- テーマのインポート

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

- フィードバックのインポート

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

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

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

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

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

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

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

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

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

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

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

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

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

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

- DMLロックについて

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

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

- コレクションの使用

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

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

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

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

- Webサービスの実装

- Webサービス参照の理解

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

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

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

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

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

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

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

- REST Webサービス参照のテスト

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

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

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

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

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

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

- プラグインの実装

- プラグインについて

- プラグインへのアクセス

- プラグインの編集

- プラグインの作成

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

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

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

- プラグインの削除

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

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

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

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

- プラグインの使用状況の表示

- プラグイン履歴の表示

- 動的アクションの実装

- 動的アクションの理解

- 動的アクションの作成

- 動的アクションの編集

- Trueアクションの追加

- 頻度と有効範囲の定義

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

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

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

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

- 手続き的なBLOBの使用

- データベース・アプリケーションでのスクリーン・リーダー・モードの使用

- スクリーン・リーダー・モードのプロビジョニング

- スクリーン・リーダー・モードの拡張

- データベース・アプリケーションでのハイ・コントラスト・モードの使用

- ハイ・コントラスト・モードのプロビジョニング

- ハイ・コントラスト・モードの拡張

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

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

- データ・ロード・ウィザードの編集

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

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

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

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

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

- 言語の指定について

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

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

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

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

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

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

- 翻訳プロセスの理解

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

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

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

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

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

- 翻訳の手動編集

- メッセージの翻訳

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

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

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

- 動的翻訳の定義

- APEX_LANG.LANG API

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

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

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

B Oracle Application Expressの制限事項

- 開発環境の制限事項

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

C 使用可能な条件

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

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

- データベース・ユーザーへの権限の付与について

- PUBLICに付与された権限について

- パッケージ

- プロシージャ

- ファンクション

- 表

- ビュー

- 順序

- タイプ

E Oracle Application Expressのアクセシビリティ

- スクリーン・リーダー・モードについて

- スクリーン・リーダー・モードの機能

- スクリーン・リーダー・モードの有効化

- ハイ・コントラスト・モードについて

- ハイ・コントラスト・モードの機能

- ハイ・コントラスト・モードの有効化

- JAWSを使用した対話モード・レポートへのアクセス

- 「アクション」メニューへのアクセス

- JAWSを使用したフォーム・ページへのアクセス

- ページの構造の理解

- ページの「タスク」リンクの使用

- ヘルプ・テキストへのアクセス

- 検証エラーの処理

- キーボードを使用したコンポーネントへのアクセス

- 新しい日付ピッカーの使用

- 対話モード・レポート・リージョンへのアクセス

索引

Oracle® Application Express

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

リリース4.2

B71110-01(原本部品番号:E35125-02)

2012年10月

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

B71110-01

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

原本著者: Terri Jennings、Drue Swadener

原本協力者: Marco Adelfio、Christina Cho、Hilary Farrell、Michael Hichwa、Christopher Jones、Joel Kallman、Sharon Kennedy、David Peake、Anthony Rayner、Marc Sewtz、Scott Spadafore、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 Application Expressアプリケーション・ビルダー・ユーザーズ・ガイド』では、Oracle Application Express開発環境を使用して、データベース集中型のWebアプリケーションを構築およびデプロイする方法について説明します。Oracle Application Expressは、複数のワークグループが別々のデータベースで実行しているように、それらのワークスペースでアプリケーションを構築し、それらにアクセスできるようにすることで、単一のOracle Databaseを共有サービスにします。

内容は次のとおりです。

- トピック概要

- 対象読者

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

- 関連ドキュメント

- 表記規則

トピック概要

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

タイトル

説明

このリリースでの変更点

Oracle Application Expressのこのリリースでの変更点を説明します。

クイック・スタート

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

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

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

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

Oracle Application Expressに同梱されているサンプル・アプリケーションのインストール方法および実行方法について説明します。

開発プロセスの管理

組込み開発管理ツールであるチーム開発を使用して、新機能、機能に関連しないタスク(To Doタスク)、バグおよびマイルストンを追跡することによって開発プロセスを管理する方法について説明します。

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

アプリケーション・ビルダーを使用して、Webシート・アプリケーションにコンテンツを作成および追加する方法について説明します。

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

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

データベース・アプリケーション・ページの操作

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

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

アプリケーション・ビルダーを使用して、データベース・アプリケーションを構築し、アプリケーション・コンポーネントを管理する方法について説明します。

「データベース・アプリケーション」ページの操作

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

レポートの作成

データベース・アプリケーションで対話モード・レポートおよびクラシック・レポートを作成する方法について説明します。

データベース・アプリケーション・コンポーネントおよびコントロールの追加

アプリケーション・ビルダーを使用して、様々なアプリケーション・コンポーネント(フォーム、カレンダ、マップ、チャートなど)およびページ・コントロール(ボタン、LOV、ショートカット、ツリーなど)を作成する方法について説明します。

ナビゲーションの追加

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

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

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

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

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

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

Oracle Application Express Advisor(アドバイザ)の実行、デバッグ・モードの表示、SQLトレースの有効化、ページ・レポートの表示など、アプリケーションのデバッグ方法について説明します。

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

セキュリティに関するベスト・プラクティスの理解、ファイル・アップロードの保護、認証および認可によって、アプリケーション・ビルダーのアプリケーションにセキュリティを提供する方法について説明します。

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

アプリケーション・ビルダー内で構築されたアプリケーションをパッケージする方法と、アプリケーションと関連ファイルをエクスポート、インポートおよびインストールする方法について説明します。

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

データベース・リンクの確立、コレクションの使用、バックグラウンドSQLの実行、Webサービスの使用、プラグインの実装、動的アクションの作成、スクリーン・リーダー・モードおよびハイ・コントラスト・モードの使用、データをロードするアプリケーションの作成など、高度なプログラミング手法について説明します。

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

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

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

使用可能なアイテム・タイプおよびアイテムの動作を制御する重要なアイテム属性について説明します。

付録B: Oracle Application Expressの制限事項

Oracle Application Express開発環境およびアプリケーション・コンポーネントに関連した制限事項を示します。

付録C: 使用可能な条件

多数のアプリケーション・ビルダー条件について説明します。

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

Oracle Application Expressで付与される権限について説明します。

付録E: Oracle Application Expressのアクセシビリティ

キーボードまたはFreedom Scientific社のスクリーン・リーダーJAWSのみを使用してOracle Application Expressにアクセスするユーザーに情報を提供します。

対象読者

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

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

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

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

オラクル社のアクセシビリティへの取組みの詳細は、Oracle Accessibility ProgramのWebサイトhttp://www.oracle.com/pls/topic/lookup?ctx=acc&id=docaccを参照してください。

Oracleサポートへのアクセス

Oracleカスタマは、My Oracle Supportから電子サポートにアクセスできます。詳細は、http://www.oracle.com/pls/topic/lookup?ctx=acc&id=infoまたはhttp://www.oracle.com/pls/topic/lookup?ctx=acc&id=trs (聴覚障害者向け)を参照してください。

関連ドキュメント

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

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

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

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

- 『Oracle Application Expressエンド・ユーザーズ・ガイド』

- 『Oracle Application Express管理ガイド』

- Oracle Application Express SQLワークショップ・ガイド

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

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

- Oracle Database概要

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

- Oracle Database管理者ガイド

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

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

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

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

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

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

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

http://shop.oracle.com/

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

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

表記規則

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

規則

意味

太字

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

イタリック体

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

固定幅フォント

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

このリリースでの変更点

この章の内容は次のとおりです。

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

Oracle Application Expressリリース4.2での変更点

Oracle Application Expressリリース4.2での変更点は、次のとおりです。

新機能

このリリースの新機能は次のとおりです。

- モバイル・アプリケーションの構築
開発者は、モバイル・アプリケーションおよびモバイル・アプリケーションのコンポーネントを宣言的に定義できます。アプリケーションは、自動検出によりデスクトップ・ユーザー・インタフェースとモバイル・ユーザー・インタフェースの両方を備えることができるようになりました。詳細には次の情報が含まれます。

- リスト・ビュー・リージョン・タイプ
新しいリスト・ビュー・リージョン・タイプが組み込まれ、モバイル・アプリケーションの共通プレゼンテーション・モードとして、レポート・ビューのかわりに使用されます。

- 異なるユーザー・インタフェース用の新しい共通ページ
開発者は、ユーザー・インタフェースごとに個別のグローバル・ページ(以前のページ0)、ログイン・ページおよびホームページを定義できます。これにより、エンド・ユーザーがデスクトップ・マシンではなくモバイル・デバイスからアプリケーションにアクセスした際に異なるページを表示できます。

「コンポーネントをすべてのページに表示するためのグローバル・ページの作成」を参照してください。

- ユーザー・インタフェース固有のコンポーネント
ページに定義されたユーザー・インタフェースに基づいて、異なるリージョン・タイプおよびアイテム・タイプがデフォルトで使用可能です。たとえば、対話モード・レポートおよび表形式フォームがデスクトップ・ページの標準のリージョン・タイプであり、リスト・ビューがモバイル・ページの標準です。新しいスライダ・アイテム・タイプは、モバイル・ページのみの標準です。

「アプリケーションのユーザー・インタフェースの管理」を参照してください。

- モバイル・テーマおよびテンプレート
jQuery Mobileを利用することで、モバイル・テーマはすべての主要なモバイル・プラットフォームで変更なしで機能し、ページ遷移、HTML5アイテム・タイプなどの機能が含まれます。詳細には次の情報が含まれます。

- グリッド・レイアウトのサポート
ページ・テンプレート内で、リージョンおよびページ・アイテムの配置に使用するグリッド・レイアウトを指定できるようになりました。これは、Oracle Application Expressの以前のリリースで使用されたHTML表ベースのレイアウトにかわるものです。

- ページおよびポップアップの遷移
モバイル・ページ・テンプレートでは、ユーザーがモバイル・デバイスでより自然に操作できるように、ページおよびポップアップの遷移(スリップ、フリップ、フェードなど)を指定できます。

- カスケード・スタイルシートおよびJavaScriptファイルの置換の宣言的サポート
インライン・カスケード・スタイルシート(CSS)およびJavaScriptファイル用の新しいページおよびページ・テンプレート属性によって、開発者がファイルをアプリケーションにロードする際の宣言的サポートが提供されます。

- コンテンツ配信ネットワーク
ユーザー・インタフェースの新しいアプリケーション・レベル属性である「コンテンツ配信ネットワーク」によって、コンテンツ配信ネットワーク(Google、Microsoft、jQueryなど)からロードされるjQueryおよびjQuery Mobileファイルのサポートが提供されます。

「アプリケーションのユーザー・インタフェースの管理」を参照してください。

- HTML5チャート
Flashを使用せずにチャートのレンダリングを可能にするHTML5チャート作成。

「HTML5チャートの作成について」を参照してください。

- HTML5アイテム・タイプ
数値、電子メール、電話およびURLにアイテム・タイプを指定すると、HTML5対応の最新のモバイル・デバイスでデータを入力する際のユーザーの操作性が大幅に向上します。詳細には次の情報が含まれます。

- スライダ・アイテム・タイプ
スライダによってHTML5範囲入力タイプがレンダリングされ、これはモバイル・ページでは適切なスライダに切り替えられ、モバイル・ページ以外でも使用できます。

- はい/いいえアイテム・タイプ
はい/いいえは、モバイル・ページではフリップ切替えスイッチとして、モバイル・ページ以外ではラジオ・グループとしてレンダリングされます。

- 新しい「向きを表示」
チェック・ボックスおよびラジオ・グループ・アイテム・タイプに新しい「向きを表示」属性があり、「縦」(デフォルト)または「横」に設定できます。

「ページ・レベル・アイテムの理解」および「アイテム・タイプについて」を参照してください。

- パッケージ・アプリケーション
生産性アプリケーションのコレクションによって、ユーザーはデータベースに対する投資をすぐに利用し始めることができます。これらのアプリケーションのロックを解除する機能によって、開発者はベスト・プラクティスをカスタマイズおよび学習することもできます。

「パッケージ・アプリケーションの使用」を参照してください。

- その他の新機能

- 名前付きブランチ
開発者は、様々なブランチを識別しやすくするために、ブランチに名前を指定できるようになりました。

「ブランチを使用したナビゲーションの制御」を参照してください。

- RESTful Webサービス
SQLワークショップで、データベースからのRESTful Webサービスのコールを定義できるようになりました。これらの定義をOracle Application Express Listener 2.0と組み合せると、データベースはWebサービスを使用できるだけでなくRESTful Webサービスを生成できます。

『Oracle Application Express SQLワークショップ・ガイド』の「RESTfulサービスの使用」を参照してください。

- 読取り専用ページおよびリージョン
開発者は、読取り専用ページまたはリージョンを指定して、表示専用のコンポーネントを簡単に構築できるようになりました。

- アプリケーション間でのセッション・ステートの共有
大規模な論理アプリケーションは、同じCookie名を構成することで同じセッションを共有する複数の物理アプリケーションに分けられる場合が多くあります。アイテム有効範囲をグローバルとして定義することによって、これらのアプリケーション間でアプリケーション・アイテムを共有できるようになりました。

「グローバル変数として機能するアプリケーション・レベル・アイテムの作成」を参照してください。

非推奨となった機能

次の機能は、今回のリリースで非推奨であり、将来のリリースではサポートされない場合があります。

- DMLフェッチ・プロセスのメモリー・キャッシュの設定
DMLフェッチ・プロセスでは、セッション・ステートの設定の混乱や問題を回避するために、常に「フェッチ時にメモリー・キャッシュを設定」オプションを使用する必要があります。そのため、「表示時にメモリー・キャッシュを設定」オプションは非推奨となっており、DMLフェッチ・プロセスが現在そのオプションで定義されている場合にのみ表示されます。

その他の変更

このリリースでのその他の変更は、次のとおりです。

- 動的アクション:

- jQuery Mobileの有効化
JavaScriptおよび動的アクションがアイテム・タイプを操作するために使用される場合に、jQuery Mobileで機能するように既存のアイテム・タイプが変更されました(「値の設定」、「有効化」、「非表示」など)。

- jQuery Mobileイベントの表示
jQuery Mobileフレームワークによって、モバイル・アプリケーションの開発者にとって有用なフックを提供する数多くのイベントが表示されます。これらのイベントを組み込むように動的アクション・フレームワークが拡張されました。

- 非同期AJAXコール
常に非同期で起動するようにサーバー側のアクションを変更し、後続のアクションの起動方法を定義する機能を開発者に提供します。

- 影響を受ける要素の拡張
動的アクションの影響を受ける要素として指定可能なコンポーネントに開発者がボタンを追加できるようにします。

- プラグイン:

- カスタム属性の25への増加
カスタム属性の数が15から25に増加しました。

- フェッチされた行およびデータが見つからなかった場合のメッセージのリージョン・タイプ設定への追加
属性「フェッチされた行数」、「フェッチされた行数(アイテム)」および「データが見つからなかった場合のメッセージ」が標準属性として追加され、これらの標準属性はリージョン・ソース・データのページ区切りに対して表示またはフェッチする行数を判別するためにリージョン・タイプ・プラグインに対して公開できるか、または何も見つからなかった場合に表示できます。

- データ型チェックのサポート
「リージョンSQL文の列」属性が、データ型チェックをサポートするために追加されました。

- 対話モード・レポート

- 保存された対話モード・レポートを保持するための不変のID
保存されたレポート用の不変の識別子を導入することにより、新しいアプリケーション定義のインポート(開発から本番へのインポートなど)によってアプリケーションがアップグレードされたときに、サブスクリプションを保持できます。この識別子は、インポートされるアプリケーションに異なるアプリケーション識別子がある場合でも機能します。

- 列の書式設定
レポートでのレンダリングとHTMLおよび電子メール・ダウンロードに含めることが可能な列の定義で使用されるHTML式。

- 送信者アドレスの定義
サブスクリプションおよび電子メール・ダウンロードで、ユーザーは送信者アドレスを指定できるようになりました。

- ランタイムSQL問合せのAPI
実行されている問合せを開発者が判別できるように、新しいAPIによって対話モード・レポートの現在のSQL問合せが戻されます。これは、フィルタ、ソート、表示される列などのユーザー定義の条件がカスタマイズに必要な他の機能で、対話モード・レポートからの出力が使用される場合に役立ちます。

- 日付列で等しい(=)演算子の使用が可能
ユーザーは、等しい(=)演算子を使用して特定の日付でフィルタできます。

- Webシート

- 改善されたWebシートの作成ウィザード
アプリケーション開発者は、Webシートを作成してアプリケーションのプロパティを編集するのではなく、アプリケーションを作成するときに「SQLとPL/SQLの許可」を指定できるようになりました。

- ツールバー・メニューの拡張
既存のツールバー・メニュー・オプションが移動され、新しいオプションがレポート用に追加されました。これらの変更は、Webシートからのナビゲートがユーザーにとって、より容易、生産的、直感的になるように設計されています。

- データ・グリッドへの直接リンク
アクセスを容易にするために公開または電子メールで送信できるリンクを直接使用してデータ・グリッドまたはデータ・グリッド行(フォーム・ビュー)を編集する機能をユーザーに提供します。

- データのアップロード

- 列の別名の提供
エンド・ユーザーが表の列名を知らなくてもよいように、開発者はアップロードされる列の別名を定義できます。表の列名は、特に参照が定義されている列でエンド・ユーザーには紛らわしかったり混同したりする可能性があるため、たとえば、ユーザーはDEPTNOを必要とするかわりに、Department Nameをアップロードします。

- 参照キーの改善
1つの列参照のみを許可して数値を戻すかわりに、この改善によって3列を指定して任意のデータ型の参照値を識別できます。これは、参照表にマルチ・パート・キーがある値を一意に識別するために必要です。

- トランスフォーメーション・ルールの拡張
開発者は、複数の列に同じトランスフォーメーション・ルールを定義するのではなく、ルールを一度指定し、複数の列を割り当てることができるようになりました。

- キャラクタ・セットの変換
異なるキャラクタ・セットのデータをアップロードするユーザーのために、ファイルを正しく更新できるようにファイルの作成に使用されるキャラクタ・セットを指定できるようになりました。

- 同時実行性の保証
開発者は、エンド・ユーザーがアップロード・プロセスを開始した後に更新対象データが変更されていないことを保証するために使用される同時実行性用の列を定義できます。この機能は、定期的に更新される表にエンド・ユーザーがレコードをアップロードする際に重要です。

- 管理

- インスタンス・プロキシ
アプリケーションおよびWebサービス参照レベルのプロキシにかわって、インスタンス・レベルでプロキシを定義できるようになりました。

- すべてのアウトバウンド・トラフィックHTTPS
この新しいインスタンス設定を有効にすると、すべてのアウトバウンド・トラフィックがHTTPSプロトコルを使用する必要があります。

- ビッグファイル表領域
ワークスペースがプロビジョニングされ、Oracle Application Expressによって関連するデータベース・ユーザー、表領域およびデータファイルが作成されている場合、基礎となる表領域を非常に大きいサイズ(数TB)まで拡大可能なビッグファイル表領域として作成して、小さいファイルの表領域の制限を解決できます。

- 暗号化された表領域
データベース管理者がマスター暗号化鍵セットを使用して暗号化ウォレットを作成して開いている場合、ワークスペースをプロビジョニングする際にOracle Application Expressによって作成される表領域を、暗号化された表領域として作成できます。

- 複数のワークスペースの作成
インスタンス管理者は、ウィザードを使用して複数のワークスペースを一度にプロビジョニングできるようになりました。

- アプリケーション・トレースの有効化
インスタンス管理者は、アプリケーション・トレースを有効または無効にして、デバッグが有効なアプリケーションによってデータベース・トレース・ファイルをいつ作成できるかを制御できます。

- 対話モード・レポートのサブスクリプションに関するレポート
インスタンス管理者が対話モード・レポートのサブスクリプションを監視および確認できるようにします。

- パッケージ・アプリケーションのインストールのロギング
管理者は、パッケージ・アプリケーションに関してユーザーおよびインストールのパフォーマンスを監視できます。

- ログイン失敗の処理
管理者は、各ログイン試行が失敗した後にユーザーが待機する必要がある時間を定義できます。管理者は、指定した試行失敗回数の後のロックアウト時間も定義できます。

- リソース・コンシューマ・グループの定義
インスタンス管理者は、ワークスペースをリソース・コンシューマ・グループに関連付けて、共有環境内の様々なワークスペースのリソース使用状況をより適切に管理できます。

- その他の管理の機能拡張:

- ページごとの最大アイテム数の200への増加
ページに入力可能な最大アイテム数が100から200に変更されました。

- デバッグの機能拡張
開発者は、アプリケーション・ビルダーからアプリケーションを実行するときに、デバッグ情報を表示するためにデバッグ許可フラグを「はい」に変更する必要がなくなりました。Oracle Application Expressでは、様々なデバッグ・レベルの使用と、戻される詳細のレベルを管理するための制御が向上しました。

- オンデマンドの改善
認可および条件をオンデマンド・プロセスで使用できるようになりました。デフォルトでは、オンデマンド・プロセスは、認証されていないセッションでのユーザーによる実行を回避するために、初期の認可である「パブリック・ユーザーは不可」で作成されるようになりました。

- グローバリゼーションの機能拡張
翻訳リポジトリでの生産性を向上させるために、開発者はグリッドを使用してテキスト・メッセージを編集できます。

- チーム開発の添付ファイル
開発者は、外部ドキュメントを機能、バグおよびToDoに添付ファイルとして追加できるようになりました。

1 クイック・スタート

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

内容は次のとおりです。

- Oracle Application Expressの概要

- Oracle Application Expressについて

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

- Oracle Application Expressへのログイン

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

- Oracle Application Expressドキュメントについて

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

Oracle Application Expressの概要

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

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

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

Oracle Application Expressの詳細は、ワークスペース・ホームページの「詳細」リンクをクリックしてください。Oracle Application Expressについてのページが表示されます。

関連項目:
「Oracle Application Expressへのログイン」および「詳細について」

Oracle Application Expressについて

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

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

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

Application Expressエンジンについて

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

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

- 認証サービス

- 認可サービス

- ページ・フロー制御

- 検証処理

Oracle Application Expressの様々な環境

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

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

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

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

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

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

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

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

- エンド・ユーザー: 開発または管理機能にアクセスできないアプリケーション・ユーザー

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

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

Oracle Application Expressへのログイン

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

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

- Oracle Application Expressを最近インストールした場合は、開発環境を構成する必要があります。「Oracle Application Express環境の構成」を参照してください。

- 以前に構成した開発環境に開発者がログインする場合は、管理者がその開発者にワークスペースへのアクセス権を付与する必要があります。「Oracle Application Express環境の構成」を参照してください。

内容は次のとおりです。

- ブラウザ要件について

- Oracle Application Express環境の構成

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

ブラウザ要件について

Oracle Application Expressアプリケーションを表示または開発するには、WebブラウザでJava Script、HTML 4.0およびCSS 1.0標準がサポートされている必要があります。Oracle Application Expressでアプリケーションを開発するには、次のブラウザが必要です。

- Microsoft Internet Explorer 7.0以上

- Mozilla Firefox 14以上のバージョン

- Google Chrome 21以上のバージョン

- Apple Safari 5.0以上のバージョン

以前のWebブラウザ・バージョン(Microsoft Internet Explorer 6.0など)をサポートするApplication Expressアプリケーションを開発できます。

Oracle Application Express環境の構成

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

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

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

- 設定でOracle Application Expressリスナーを使用する場合は、次にナビゲートします。

http://hostname:port/apex/apex_admin

説明:

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

portは、Oracle HTTP Serverに割り当てられているポート番号です。この番号は、デフォルトのインストールの場合、Oracle WebLogic Serverでは7001、OC4Jでは8888、Oracle Glassfish Serverでは8080です。これらの番号は、このドキュメントの作成時における適切なデフォルト値です。詳細は、Oracle Application Expressリスナー・インストールおよび構成ガイドを参照してください。

apexは、Webサーバー構成ファイルで定義されているマウント・ポイントです。

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

http://hostname:port/apex/apex_admin

説明:

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

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

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

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

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

説明:

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

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

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

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

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

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

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

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

関連項目:
『Oracle Application Express管理ガイド』の「Oracle Application Express管理サービスへのログイン」

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

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

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

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

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

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

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

内容は次のとおりです。

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

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

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

- パスワードの再設定

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

- 設定でOracle Application Expressリスナーを使用する場合は、次にナビゲートします。

http://hostname:port/apex

説明:

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

- portは、Oracle HTTP Serverに割り当てられているポート番号です。この番号は、デフォルトのインストールの場合、Oracle WebLogic Serverでは7001、OC4Jでは8888、Oracle Glassfish Serverでは8080です。これら番号は、このドキュメントの作成時における適切なデフォルト値でした。Oracle Application Expressリスナーのドキュメントを参照してください。

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

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

http://hostname:port/apex

説明:

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

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

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

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

http://hostname:port/pls/apex

説明:

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

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

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

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

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

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

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

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

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

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

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

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

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

Oracle XML DB HTTP Serverポートの検証

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

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

- Windowsの場合:

SYSTEM_DRIVE:\ sqlplus /nolog
connect sys as sysdba

- UNIXおよびLinuxの場合:

$ sqlplus /nolog
connect sys as sysdba

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

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

SELECT DBMS_XDB.GETHTTPPORT FROM DUAL;

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

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

ワークスペース名の検索

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

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

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

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

パスワードの再設定

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

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

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

2. 「管理」アイコンをクリックします。
管理ページが表示されます。

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

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

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

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

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

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

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

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

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

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

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

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

図wrkspc_home.gifの説明

ページの中央に次の大きなアイコンが表示されます。

- 「アプリケーション・ビルダー」。アプリケーション・ビルダーを使用して、一連のHTMLページから構成されるデータベース・オブジェクトに基づいたアプリケーションを作成します。詳細は、「アプリケーション・ビルダーの概念」および「アプリケーション・ビルダーの使用」を参照してください。

- 「SQLワークショップ」。SQLワークショップを使用すると、データベース・オブジェクトを表示および管理するためのツールにアクセスできます。詳細は、Oracle Application Express SQLワークショップ・ガイドを参照してください。

- 「チーム開発」。チーム開発を使用すると、新機能、機能に関連しないタスク(To Doタスク)、バグおよびマイルストンを追跡できます。また、ユーザーはリアルタイム・フィードバックを提供できます。このフィードバックは、機能、一般タスクまたはバグに分類できます。詳細は、「開発プロセスの管理」を参照してください。

- 管理: ワークスペース管理ページにリンクしています。詳細は、Oracle Application Express管理ガイドの「ワークスペースとアプリケーションの管理」を参照してください。

「情報」ボックスの「詳細」リンクをクリックすると、Oracle Application Expressの概要が表示されます。対象となるトピックは、アーキテクチャ、セルフ・サービス、セキュリティ、Webシート、アプリケーション開発、SQLワークショップ、チーム開発、管理および開発の管理です。

システム・メッセージおよびニュース・リージョンについて

図wrkspc_home_news.gifの説明

システム・メッセージは、ワークスペース・ホームページの上部に表示されます。ニュース・リージョンはページの中央に表示されます。これらのリージョンを使用して、ワークスペースの他のユーザーと通信します。詳細は、Oracle Application Express管理ガイドの「システム・メッセージの定義」および「ニュース・エントリの管理」を参照してください。

「トップ・アプリケーション」および「トップ・ユーザー」について

トップ・アプリケーション・ダッシュボードおよびトップ・ユーザー・ダッシュボードは、ページの下部に表示されます。これらのリージョンには、現在のワークスペース内の開発アクティビティに関する情報がリアルタイムに表示されます。

「ワークスペースの検索」について

図search_wrkspc.gifの説明

「ワークスペースの検索」フィールドは、ワークスペース・ホームページの右上隅に表示されます。このフィールドを使用すると、アプリケーション名、アプリケーションIDとページ、ワークスペース・イメージ、ワークスペース・テーマ名およびその他のワークスペース・コンポーネントを検索できます。このフィールドではデフォルトで大/小文字が区別され、正規表現がサポートされます。

たとえば、特定のページおよびページにナビゲートするには、次の書式を使用します。

page
application_ID:page
application_ID-page

説明:

- application_ID: アプリケーションを識別する数値指定番号(ID)です。

- page: 特定のページを識別する数値指定番号です。

次に例を示します。

10
570-10
570:10

「詳細」について

図learn_more.gifの説明

チーム開発

team_dev_rergion.gifの説明

チーム開発を使用すると、機能、機能に関連しないタスク(つまりTo Do)、マイルストン、バグ、フィードバックおよびマイルストンを追跡して、開発プロセスを管理できます。これらのアイテムを管理するには、番号付きリンクをクリックします。詳細は、「開発プロセスの管理」を参照してください。

「使用可能な更新」について

このリージョンには、新しいバージョンのOracle Application ExpressまたはOracle Application Expressリスナーが使用可能かどうかが表示されます。

「アクセシビリティ・モード」について

「アクセシビリティ・モード」リストは、ページの右下隅に表示されます。「アクセシビリティ・モード」リストを使用して、ページがスクリーン・リーダー用に最適化されているかどうかを識別します。使用可能なオプションは、「標準」、「スクリーン・リーダー」、「ハイ・コントラスト」です。詳細は、「Oracle Application Expressのアクセシビリティ」、「データベース・アプリケーションでのスクリーン・リーダー・モードの使用」および「データベース・アプリケーションでのハイ・コントラスト・モードの使用」を参照してください。

Oracle Application Express ドキュメントについて

Oracle Application Expressには、ホスティングされたオンライン・ドキュメント・ライブラリおよびフィールドレベル・ヘルプがあります。

内容は次のとおりです。

- オンライン・ドキュメント・ライブラリへのアクセス

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

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

オンライン・ドキュメント・ライブラリへのアクセス

ほとんどのOracle Application Expressページの右上隅にある「ヘルプ」アイコンをクリックすると、オンラインのOracle Application Expressドキュメント・ライブラリにアクセスできます。

図hlp_ico.gifの説明

「ヘルプ」アイコンをクリックすると、ドキュメントおよびチュートリアル・ページが表示されます。ライブラリ全体を表示するには、ライブラリ全体の「HTML」リンクをクリックするか、特定の「HTML」または「PDF」リンクをクリックします。

ヒント:
Oracle Application Express管理サービスのインスタンス設定のインスタンス・レベルで、「ヘルプ」アイコンをリダイレクトできます。詳細は、『Oracle Application Express管理ガイド』のオンライン・ヘルプの構成に関する説明を参照してください。

オンライン・ドキュメント・ライブラリの検索

オンライン・ドキュメント・ライブラリのキーワード検索を実行するには、次のステップを実行します。

1. 「ヘルプ」アイコンをクリックします。
ドキュメントおよびチュートリアル・ページが表示されます。

2. ライブラリ全体を検索するには、次のステップを実行します。

1. ライブラリ全体の「HTML」リンクをクリックします。
ようこそページが表示されます。

2. 右上隅の検索フィールドにキーワードを入力し、「検索」をクリックします。
検索結果が表示されます。

3. 確認するトピックを選択します。

3. 特定ドキュメントを検索するには、次のステップを実行します。

1. ドキュメントの「HTML」リンクを選択します。

2. 左上隅の検索フィールドにキーワードを入力します。

3. 検索を絞り込むか、または検索範囲を広げるには、このドキュメントまたはライブラリ全体のいずれかを選択します。
検索結果が表示されます。

4. 確認するトピックを選択します。

オンライン・ドキュメント・ライブラリの主索引の使用

オンライン・ドキュメント・ライブラリの主索引を検索するには、次のステップを実行します。

1. 「ヘルプ」アイコンをクリックします。

2. ライブラリ全体の「HTML」リンクをクリックします。
ようこそページが表示されます。

3. 索引で、主索引のHTMLリンクをクリックします。

4. 文字をクリックして、特定トピックを表示します。
エントリは、索引用語およびドキュメントごとに編成されています。

5. 索引用語をクリックします。

ヒント:
特定のドキュメント内からも主索引にアクセスできます。クイック・ルックアップの下にある主索引のリンクをクリックします。

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

Oracle Application Expressドキュメント・ページから、Oracle Application Expressドキュメント・ライブラリをローカルにダウンロードできます。

オンライン・ドキュメント・ライブラリをダウンロードするには、次のステップを実行してください。

1. Oracle Application Expressドキュメント・ページに移動します。

http://www.oracle.com/technetwork/developer-tools/apex/application-express/apex-094287.html

2. ダウンロードするOracle Application Expressライブラリを検索し、「ZIP」リンクをクリックします。

3. ZIPファイルをダウンロードし、ローカルで解凍します。

4. 解凍したフォルダを開き、welcome.htmlをクリックします。
Oracle Application Expressドキュメント・ライブラリのようこそページが表示されます。

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

提供されたAcrobatの検索索引を使用すると、ダウンロードしたライブラリのPDFを素早く検索できます。

ヒント:
「オンライン・ドキュメント・ライブラリの検索」および「オンライン・ドキュメント・ライブラリの主索引の使用」にあるとおり、グローバル検索機能および主索引を使用するにはインターネットにアクセスする必要があります。

ダウンロードしたドキュメントでグローバル検索を実行するには、次のステップを実行します。

1. ダウンロードしたドキュメントの場所に移動します。

2. index.pdxをダブルクリックします。

3. [Shift]+[Ctrl]+[F]を押します。
検索ウィンドウが表示されます。

4. 検索条件を入力し、「検索」をクリックします。
検索結果が表示されます。

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

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

図hlp_item.gifの説明

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

図hlp_sys_link.gifの説明

右上隅にあるオンライン・ドキュメント・ライブラリへの「ヘルプ」リンクをクリックします。

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

このセクションでは、アプリケーション・ビルダーの基本概念を説明します。アプリケーション・ビルダーを使用すると、データベース・オブジェクトに基づいて、HTMLページのセットで構成されたアプリケーションを作成できます。各アプリケーションは、タブ、ボタンまたはハイパーテキスト・リンクを使用して相互にリンクされたページの集合です。

内容は次のとおりです。

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

- ページの概要

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

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

- URL構文の理解

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

- 置換文字列の理解

関連項目:
「アプリケーション・ビルダーの使用」

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

Oracle Application Expressアプリケーションを使用すると、Oracle Databaseのデータを管理および表示できます。アプリケーション・ビルダーを使用して、アプリケーションを構築できます。アプリケーション・ビルダーを使用して、2つの異なるタイプのアプリケーション(データベース・アプリケーションおよびWebシート・アプリケーション)を作成できます。

内容は次のとおりです。

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

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

関連項目:
「アプリケーション・ビルダーの使用」

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

アプリケーションとは、表またはプロシージャのようなデータベース・オブジェクトの上部に存在するHTMLインタフェースです。アプリケーションの作成ウィザードを使用して、データベース・アプリケーションとWebシート・アプリケーションの両方を作成します。これらの2タイプのアプリケーションにおける主な違いは、対象ユーザーです。データベース・アプリケーションはアプリケーション開発者を対象とし、Webシート・アプリケーションは開発経験のないエンド・ユーザーを対象としています。

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

データベース・アプリケーションは、タブ、ボタンまたはハイパーテキスト・リンクを使用して相互にリンクされたページの集合です。アプリケーションのページは、共通のセッション・ステートおよび認証を共有します。

データベース・アプリケーションを作成するには、アプリケーション開発者はウィザードを実行して宣言的にページおよびナビゲーションを構築します。個々のページはリージョンと呼ばれるコンテナを使用して編成されます。リージョンには、テキスト、カスタムPL/SQL、レポート、チャート、マップ、カレンダ、Webサービス・コンテンツまたはフォームを含めることができます。フォームは、数多くの組込みタイプ(テキスト・フィールド、テキスト領域、ラジオ・グループ、選択リスト、チェック・ボックス、日付ピッカー、ポップアップLOVなど)から選択可能なフィールド(アイテムと呼ばれる)で構成されます。また、開発者はプラグインを使用して独自のカスタム・アイテム・タイプを作成することもできます。セッション・ステート(アプリケーション・コンテキスト)は透過的に管理され、ユーザー・インタフェース・プレゼンテーションはアプリケーション・ロジックから分離されているため、開発者はアプリケーションのルック・アンド・フィールを別のテーマを選択することで簡単に変更できます。「データベース・アプリケーションについて」を参照してください。

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

Webシート・アプリケーションを作成すると、開発者の支援がなくても、エンド・ユーザーが構造化データおよび非構造化データを管理できます。ページ・セクションには、WYSIWYGエディタを使用して編集できる非構造化データが含まれます。データ・グリッドによって、SQLを記述しなくても構造化データを管理できます。ユーザーは実行時ダイアログ・ボックスを使用して、列の追加、列名の変更および検証を実行できます。各ページおよびデータ・グリッドの各行は、ファイル、タグ、ノートおよびリンクで注釈を付けることができます。ページには、セクション、レポートおよびデータ・グリッドを含めることができ、ナビゲーションを使用してすべてをリンクできます。すべての情報は、検索可能でエンド・ユーザーによって完全に制御されます。「Webシート・アプリケーションについて」を参照してください。

ヒント:
アプリケーションの詳細は、Application Expressのホームページの「詳細」リンクをクリックしてください。

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

アプリケーションの作成ウィザードを実行して、Oracle Application Expressアプリケーションを作成します。アプリケーションの作成ウィザードを実行するには、アプリケーション・ビルダーのホームページで「作成」ボタンをクリックします。

アプリケーションの作成ウィザードの主なデシジョン・ポイント

アプリケーションの作成ウィザードを実行すると、作成するアプリケーションのタイプを選択するよう求められます。

図create_app_wiz.gifの説明

オプションは次のとおりです。

- データベース。データベース・アプリケーションを使用すると、開発者は開発プロセスおよび最終アプリケーション機能のあらゆる面において完全な制御権限を持つことができます。データベース・アプリケーションの場合、開発者はSQLおよびPL/SQLのプログラミング技術をそのまま活用できます。データベース・アプリケーションは、フロー制御全体で宣言的な制御を使用し、テンプレートおよびテーマの使用により完全なユーザー・インタフェース制御をサポートしています。「データベース・アプリケーションについて」を参照してください。

- Webシート。Webシート・アプリケーションを使用すると、ユーザーはSQLのプログラミング知識がなくてもデータ中心のアプリケーションを作成できます。Webシート・アプリケーションは簡略化されていてページ、データ・グリッドおよびレポートをサポートしています。これらのアプリケーションは簡単に作成でき、コミュニティの貢献をサポートします。Webシート・アプリケーションの詳細は、Application Expressのホームページの「詳細」リンクをクリックしてください。「Webシート・アプリケーションについて」を参照してください。

- パッケージ・アプリケーション。パッケージ・アプリケーションは、特定のビジネス・ニーズに対応するように設計された完全版のアプリケーションです。パッケージ・アプリケーションをそのままの状態でインストール、実行および使用し、生産性アプリケーションのロックを解除して、提供されるソリューションをカスタマイズしたり、これらを分析して、アプリケーション・ビルダーを使用した特定の機能タイプの構築方法をよりよく理解することができます。「パッケージ・アプリケーションについて」を参照してください。

関連項目:
「スプレッドシートからのアプリケーションの作成」、「データベース・アプリケーションのコピー」、「テンプレートからのデータベース・アプリケーションの作成」および「パッケージ・アプリケーションのインストール」

ページの概要

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

ページ作成ウィザードを使用してすると、ページ定義にコントロールを自動的に追加したり、「ページ定義」でページにコントロールを追加できます。

既存のページの「ページ定義」を表示するには、次のステップを実行します。

1. 「ワークスペース」ホームページにナビゲートします。

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

3. アプリケーションを選択します。

4. ページを選択します。
「ページ定義」が次の3つの主要セクションに分かれて表示されます。

- ページ・レンダリング: ページのレンダリング中に実行されるユーザー・インタフェース・コントロールおよびロジックがリストされます。ページ・レンダリングとは、データベースからのページ生成プロセスです。「ページ・レンダリング・アイコンの使用」を参照してください。

- ページ・プロセス: ページの処理中に評価および実行されるロジック・コントロール(計算、プロセスなど)がリストされます。「ページ・プロセス・アイコンの使用」を参照してください。

- 共有コンポーネント: アプリケーションの1つ以上のページで使用可能な共通のコンポーネントをリストします。詳細は、「共有コンポーネント・アイコンの使用」を参照してください。

関連項目:
「「ページ定義」について」および「コンポーネント・ビューでのページの編集」

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

アプリケーション・ビルダーにアプリケーションを作成する際に、タブ、ボタンまたはハイパーテキスト・リンクを使用して複数のページをリンクできます。各ページにはボタンおよびアイテムを配置でき、アプリケーション・ロジックを含めることができます。ページでは、条件付きナビゲーションを使用したあるページから次のページへのブランチ、計算および検証の実行、およびレポート、カレンダおよびチャートの表示を行うことができます。組込みウィザードを使用してレポート、チャートおよびフォームを生成したり、静的HTMLを生成したり、PL/SQLプログラミングによってカスタム・レンダリングを行うことができます。

内容は次のとおりです。

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

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

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

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

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

Application Expressエンジンは、Oracle Database表に格納されたデータに基づいて、ページを動的にレンダリングおよび処理します。レンダリングされたアプリケーションを表示するには、Application Expressエンジンにそのアプリケーションをリクエストします。アプリケーションを実行すると、Application Expressエンジンによって次の2つのプロセスが使用されます。

- ページ表示は、ページ・レンダリング・プロセスです。このプロセスによって、すべてのページ属性(リージョン、アイテム、ボタンなど)が表示可能なHTMLページに編成されます。

- ページ受入れでは、ページの処理が行われます。このプロセスによって、すべての計算、検証、プロセスおよびブランチが実行されます。

URLを使用してページをリクエストする場合、エンジンはページ表示を実行します。ページを送信する場合、Application Expressエンジンはページ受入れを実行するか、送信した値をセッション・キャッシュに保存して、計算、検証または処理を行う間はページ・プロセスを実行します。

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

条件とは、リージョン、アイテム、ボタン、チャートおよびタブの表示と、プロセス、計算および検証の実行を制御するために役立つ論理単位です。たとえば、ボタンに条件を適用すると、レンダリング・エンジンによって、レンダリング(ページ表示)プロセス中にその条件が評価されます。条件に合格するかどうかによって、そのページ・コントロール(この場合はボタン)が表示されるかどうかが決まります。

条件を指定するには、条件タイプを選択します。条件タイプは、コントロールまたはコンポーネントを最初に作成するときに選択するか、コントロールまたはコンポーネントを編集する場合に条件タイプ属性から選択します。選択した条件タイプに応じて、「式」フィールドに適切な値を入力します。条件は、「式」フィールドに入力した値に基づいて、trueまたはfalseに評価されます。

注意:
「式」フィールドを使用するかどうかは、選択した条件タイプによって決まります。いずれのフィールドの値も必要としない条件タイプ、「式1」の値のみが必要な条件タイプ、両方のフィールドの値が必要な条件タイプなどがあります。これらのフィールドは「式1」および「式2」とラベル付けされていますが、指定した条件タイプの値が式という用語の公式の定義に準拠していない場合があります。これらの値は、選択した条件タイプに適したテキスト値です。

condition.gifの説明

任意のコンポーネントまたはコントロールに使用可能なすべての条件のリストを表示するには、「条件タイプ」リストの右側にある矢印をクリックします。リストのすぐ下に、一般的な選択項目へのショートカットが表示されます。条件に式が必要な場合は、該当するフィールドにその式を入力します。

次のセクションでは、一般的に使用されるいくつかの条件タイプについて説明します。

関連項目:
使用可能な条件タイプの詳細なリストは、付録C「使用可能な条件」を参照してください。

カレント・ページ=式1

式1のカレント・ページは、カレント・ページ番号が、「式1」内のカンマで区切られたページ・リストに含まれている場合にtrueと評価されます。次に例を示します。

3,100,203

カレント・ページが100である場合、この条件はtrueに評価され、条件に合格します。

EXISTS

「存在する(SQL問合せが1行以上を戻す)」は、SQL問合せとして表現されます。問合せで1行以上が戻される場合、この条件はtrueと評価されます。次に例を示します。

SELECT 1 FROM employees WHERE department_id = :P101_DEPTNO

この例では、アイテムP101_DEPTNOがバインド変数として参照されます。アプリケーション・プロセスおよびSQL問合せリージョン内でバインド変数を使用すると、アイテムのセッション・ステートを参照できます。P101_DEPTNOの値に指定した部門に1人以上の従業員が存在する場合、この条件はtrueと評価されます。

関連項目:
「バインド変数構文について」

PL/SQL式

「PL/SQL式」は、trueまたはfalseを評価する式を有効なPL/SQL構文で指定するために使用します。次に例を示します。

NVL(:MY_ITEM,'NO') = 'YES'

前述の例のように、:MY_ITEMの値が「はい」であれば、この条件はtrueと評価されます。:MY_ITEMの値が「はい」以外の場合、この条件はfalseと評価されます。

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

認証は、ユーザーのアプリケーションへのアクセスを可能にするために、ユーザーのアイデンティティを証明するプロセスです。認証では、ユーザーがユーザー名とパスワードを入力するか、またはデジタル証明書や保護キーを使用する場合があります。

Oracle Application Expressは、モジュール認証をサポートしているため、必要に応じて認証メソッドを簡単に切り替えられます。ユーザー・アイデンティティの証明は、いくつかの組込み認証メソッドから選択するか、またはウィザードを使用して独自のカスタム認証方法を作成して実行できます。

関連項目:
詳細は、「認証によるユーザー・アイデンティティの証明」を参照してください。

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

条件はページ上の特定のコントロールまたはコンポーネントのレンダリングおよび処理を制御しますが、認可スキームはユーザーのアクセスを制御します。認可は、ユーザー権限に基づいてリソースへのアクセスを制御することを示す広義語です。

認可スキームでは、アプリケーションやオブジェクトに対する権限を付与するために、認証によって設定されたIDが使用されます。認可スキームは、アプリケーション全体、各ページ、またはリージョン、アイテム、ボタンなどの特定のページ・コントロールに対して指定できます。たとえば、認可スキームを使用して、ユーザーに表示するタブ、リージョンまたはナビゲーション・バー・エントリを選択的に決定できます。

関連項目:
「認可を介したセキュリティの提供」

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

HTTP(HTMLページの配布に最も一般的に使用されるプロトコル)は、ステートレスなプロトコルです。Webブラウザは、ページ全体をダウンロードするために必要な時間のみサーバーに接続します。また、サーバーでは、各ページ・リクエストは、発生済または将来発生する他のページ・リクエストと関連しない個別のイベントとして処理されます。あるページで入力したフォーム値に後続のページでアクセスするには、値をセッション・ステートとして格納する必要があります。Oracle Application Expressは透過的にセッション・ステートを保持するため、開発者は、アプリケーションの任意のページでセッション・ステートの値を取得および設定できます。

内容は次のとおりです。

- セッションの概要

- セッションIDの理解

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

セッションの概要

セッションは、ページ・ビュー間で永続性(またはステートフルな動作)を確立する論理的な構成体です。各セッションには、一意の識別子が割り当てられています。Application Expressエンジンは、この識別子(セッションID)を使用して、各ページ・ビューの前後に、アプリケーションで作業中のデータ・セット(セッション・ステート)を格納および取得します。

個々のセッションは相互に完全に独立しているため、任意の数のセッションがデータベース内に同時に存在できます。また、ユーザーは複数のブラウザで、アプリケーションの複数のインスタンスを同時に実行できます。

セッションは、ページ・リクエストの処理に使用されるOracle Databaseセッションとは論理的にも物理的にも異なります。ユーザーはアプリケーションを、1つのOracle Application Expressセッションで、ログインからログアウトまで実行します。この期間は、通常分単位か時間単位です。このセッション中にページがリクエストされるたびに、Application ExpressエンジンはOracle Databaseセッションを作成または再利用してデータベース・リソースにアクセスします。多くの場合、これらのデータベース・セッションは、数分の1秒のみ存続します。

関連項目:
Oracle Application Express管理ガイドの「アクティブ・セッションの表示」を参照してください。

セッションIDの理解

Application Expressエンジンは、ページ・リクエストごとにユーザーのアイデンティティを証明し、データベースからセッション・ステートをフェッチするためにセッションIDを確立します。セッションIDは、ページ・リクエストのURL内に明示的に示されています。URLの第3パラメータとしてセッションIDが表示されます。次に例を示します。

http://apex.somewhere.com/pls/apex/f?p=4350:1:220883407765693447

この例では、セッションIDは220883407765693447です。

また、ページのHTML POSTデータにも明示的に示され、セッションのCookieのコンテンツ内にも間接的に示されています。このCookieは、認証時にApplication Expressエンジンによって送信され、アプリケーション(またはブラウザ)セッションの存続中、維持されます。

Oracle Application Expressは、認証プロセス中に新しいセッションIDを割り当て、認証されたユーザーのアイデンティティをセッションIDとともに記録し、続けて各ページ・リクエストのURLまたはPOSTデータをセッションのCookieおよびデータベースのセッション・レコードと照合して確認します。この確認によって、柔軟性とセキュリティが向上します。

セッションIDがセッション・ステート用のキーであるのに対し、セッションCookieおよびセッション・レコードは、セッションIDとユーザーの認証ステータスの整合性を保証します。

関連項目:
「ページに表示されるURLの理解」

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

Oracle Application Expressアプリケーションの動作は、通常、セッション・ステートの値によって決まります。たとえば、ボタンは、アイテムのセッション・ステートの値に基づいて、条件付きで表示できます。ページのセッション・ステートを表示するには、「開発者」ツールバーの「セッション」をクリックします。

図d_toolbar.gifの説明

セッション・ステート・ページについて

セッション・ステート・ページは、現在実行中のアプリケーションのセッションに関する有益な情報を提供します。特定のページを検索するには、ページ・フィールドにページ番号を入力して「実行」をクリックします。表2-1に、セッション・ステート・ページで参照可能な様々な情報を示します。

表2-1 セッション・ステート・ページで参照可能な情報

ヘッダー

説明

アプリケーション

アプリケーションの名前を表示します。

セッション

カレント・セッションのセッション・ステートのサマリーを表示します。

ユーザー

現行ユーザーを表示します。

ワークスペース

現行のワークスペースIDを表示します。

ブラウザ言語

現行のブラウザ言語を表示します。

ページ・アイテム

アプリケーションID、ページ番号、アイテム名、アイテムの表示方法(チェック・ボックス、日付ピッカー、表示のみ、テキスト・フィールド、非表示、ポップアップ、ラジオ・グループなど)、セッション・ステートのアイテム値、ステータスなどのページ・アイテムの属性が表示されます。

「ステータス」列には、セッション・ステートのステータスが示されます。表示される値を次に示します。

- I: 挿入

- U: 更新

- R: リセット

関連項目: 「ページ・レベル・アイテムの理解」

アプリケーション・アイテム

アプリケーション・アイテムは、ページに存在しないアイテムです。アプリケーション・アイテムは、関連付けられたユーザー・インタフェース・プロパティを持たないセッション・ステート変数です。

関連項目: アイテム値を参照する方法については、「アプリケーション・レベル・アイテムの理解」および「置換文字列の理解」を参照してください。

関連項目:
「セッション・ステート値の管理」

URL構文の理解

ページごとに表示されるURLは、Oracle Application Expressの場所、Oracle Application Expressのアドレス、アプリケーションID、ページ番号およびセッションIDを指定します。

アプリケーションIDは各アプリケーションを識別する一意の番号です。同様に、ページ番号はアプリケーション内の各ページを一意に識別します。アプリケーションおよびページには、英数字の別名がある場合もあります。アプリケーションの別名はワークスペース内で一意であり、ページの別名は各アプリケーション内で一意です。アプリケーションを実行する場合、Application Expressエンジンはユーザーのセッション・ステートに対するキーとして機能するセッション番号を生成します。

内容は次のとおりです。

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

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

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

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

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

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

ページごとに表示されるURLは、Oracle Application Expressの場所を指定します。また、Oracle Application Expressのアドレス、アプリケーションID、ページ番号およびセッションIDを指定します。次に例を示します。

http://apex.somewhere.com/pls/apex/f?p=4350:1:220883407765693447

この例の内容は次のとおりです。

- apex.somewhere.comは、サーバーのURLです。

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

- apexは、データベース・アクセス記述子(DAD)名です。DADにはHTTP Serverからデータベース・サーバーへの接続方法が記述されているため、HTTPリクエストを実行できます。デフォルト値はapexです。

- f?p=は、Oracle Application Expressによって使用される接頭辞です。

- 4350は、コールされているアプリケーションです。

- 1は、表示されるアプリケーション内のページです。

- 220883407765693447は、セッション番号です。

関連項目:
「データベース・アプリケーションURLの公開について」

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

アプリケーションのページ間にリンクを作成するには、次の構文を使用します。

f?p=App:Page:Session:Request:Debug:ClearCache:itemNames:itemValues:PrinterFriendly

表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\

PrinterFriendly

ページを「印刷用」モードでレンダリングするかどうかを決定します。PrinterFriendlyが「はい」に設定されている場合は、ページが「印刷用」モードでレンダリングされます。PrinterFriendlyの値は、リージョンなどの要素をページから削除して印刷される出力を最適化するための条件のレンダリングに使用されます。印刷用プリファレンスを参照するには、次の構文を使用します。

V('PRINTER_FRIENDLY')

参照時は、Application Expressエンジンはタブやナビゲーション・バーを表示せず、すべてのアイテムは、フォーム要素ではなくテキストで表示されます。

f?p構文の動作を理解しておくことが重要です。アプリケーション・ビルダーには、これらの参照を自動的に作成する多くのウィザードが含まれています。ただし、構文を自分自身で作成することが必要になる場合があります。次のセクションでは、f?p構文を使用してページをリンクする多くの具体的な場合について説明します。

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

アプリケーションおよびページの別名は、有効なOracle識別子で構成する必要があります。空白を含めることはできず、また大/小文字は区別されません。次の例では、アプリケーション内から、アプリケーションおよびページの別名を使用してページをコールします。アプリケーションmyappのページhomeが実行され、現行のセッションIDが使用されます。

f?p=myapp:home:&APP_SESSION.

アプリケーションの別名は、ワークスペース内で一意である必要があります。異なるワークスペースのアプリケーションに同じアプリケーション別名がある場合は、&c引数を使用してワークスペース名を指定します。次に例を示します。

f?p=common_alias:home:&APP_SESSION.&c=WORKSPACE_A

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

ボタンの作成時に、ユーザーがそのボタンをクリックするとリダイレクトされるURLを指定できます。この例では、アプリケーション6000のページ6001が実行され、現行のセッションIDが使用されます。

f?p=6000:6001:&APP_SESSION.

これは、ボタンを使用するための唯一の方法です。この方法は、ページの送信を省略し、そのページ上のハイパーリンクとして機能します。ボタン・クリックでページを送信することもできます。その方法では、ボタンをクリックすると、処理するページが送信され、フォームが送信された後、セッション・ステートが保存されます。

関連項目:
「ボタンの作成」および「APP_SESSION」

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

アプリケーション内のページが公開されていて認証の必要がない場合、セッションIDとしてゼロを使用することで、アプリケーション・ユーザーは容易にページをブックマークできます。

認証の必要がないアプリケーション・ページは、セッションIDがゼロ(単一の数字0)であるf?p URLを使用してアクセスできます。ブラウザにURLを入力するか、またはセッションIDに0を含むリンクをクリックしてページをリクエストすると、Application Expressエンジンは新しいセッションIDを割り当て、新しいセッションIDを含むセッションCookieをブラウザに送信します。アプリケーションのパブリック・ページを介してナビゲートすると、パブリック・ページへの生成済リンクすべてにセッションID0が含まれており、パブリック・ページへのブランチすべてに、表示されているセッションIDに0を使用する新しいURLが含まれていることがわかります。ただし、Application Expressエンジンは、バックグラウンドでカレント・セッションIDとしてCookieのセッションIDを使用してセッション・ステートを指定します。

カレント・セッションIDを非表示にする場合にこの機能は有効です。セッションIDを非表示にすると、ブックマーク・リンクにセッションIDを含めなくてもページをブックマークできるようになります。さらに優れた点として、セッションIDにゼロを使用すると、実際のセッションIDを検索エンジンから見えないようにします。

アプリケーションのセッションIDとしてゼロを使用するには、ゼロ・セッションIDを含むリンクを少なくとも1つ生成する必要があります。このリンクを使用することでゼロ・セッションIDメカニズムが開始されます。1つの方法として、「アプリケーション」ホームページでゼロ・セッションIDを含む単一の静的リンクを提供する方法があります。たとえば、通常はページ2へのリンクにf?p=&APP_ID.:2:&APP_SESSIONをコード化するところで、f?p=&APP_ID.:2:0をコード化します。

APEX_UTIL.PREPARE_URLについて

Oracleには、f?p構文を使用してアプリケーション・ページにアンカーを生成する際に開発者がPL/SQLを使用するためのユーティリティの機能があります。アプリケーションのPL/SQLでゼロ・セッションIDが要求される可能性のあるf?pアンカーが作成されるたびに、APEX_UTIL.PREPARE_URLを使用します。詳細は、Oracle Application Express APIリファレンスの「PREPARE_URL」を参照してください。

ゼロ・セッションID機能の動作方法

ゼロ・セッションID機能では、HTMLにアンカーを持つページ(テンプレートやHTMLリージョンなど)がサポートされます。Application Expressエンジンがf?pアンカーに直面した場合に、ある基準を満たしていると、そのアンカーを認識してセッションIDをゼロに置き換えます。

Application Expressエンジンは、次のいずれかの状況を検出した場合に、セッションIDコンポーネントをゼロに置き換えます。

- 現行のアプリケーションの数値ID

- 次のいずれかのパターン:

- すべて大文字またはすべて小文字で表された、現行のアプリケーションの英数字別名にコロンが続き、その後に現行のアプリケーションの公開ページの数値IDが続く

- すべて大文字またはすべて小文字で表された、現行のアプリケーションの公開ページの英数字別名にコロンが続き、その後に&APP_SESSION.または&SESSION.が続く

ゼロ・セッションIDに置換される候補となるHTMLのパターンには、次のものがあります。

- ページ10が公開ページの場合:

"f?p=&APP_ID.:10:&APP_SESSION.

- ページ10が公開ページの場合:

"f?p=100:10:&APP_SESSION.

- 公開ページの別名がhomeの場合:

"f?p=&APP_ID.:home:&APP_SESSION.

- 公開ページの別名がHOMEの場合:

"f?p=&APP_ID.:HOME:&APP_SESSION.

- アプリケーションの別名がPEOPLEで、公開ページの別名がHOMEの場合:

"f?p=PEOPLE:HOME:&APP_SESSION

これらの例では、アプリケーションがゼロ・セッションIDモードで実行され、ユーザーが公開ユーザーである場合に、パターン&APP_SESSION.(または&SESSION.(非表示))がゼロに置き換えられます。次のPL/SQL式がtrueの場合に、ユーザーは公開ユーザーであるとみなされます。

:app_user in ('nobody','HTMLDB_PUBLIC_USER','PUBLIC_USER','ANONYMOUS','APEX_PUBLIC_USER')"

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

インタラクティブな、データに応じて動作するWebアプリケーションを構築するには、セッション・ステート値にアクセスして管理する機能が重要です。Oracle Application Expressでは、セッション・ステートはページごとに自動的に管理され、静的HTML、またはプロセスや検証などのロジック・コントロールによって簡単に参照できます。

内容は次のとおりです。

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

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

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

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

関連項目:
「アイテム値の参照」

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

リージョン、計算、プロセス、検証およびブランチのセッション・ステートに格納されているアイテム値を参照できます。アイテムはフィールド、テキスト領域、パスワード、選択リスト、チェック・ボックスなどです。表2-3に、アイテム値を参照するためにサポートされている構文を示します。

表2-3 アイテム値を参照するための構文

タイプ

構文

説明

SQL

標準のアイテム構文:

:MY_ITEM

特殊文字を含むアイテム用の構文は次のとおりです。

:"MY_ITEM"

名前が30文字以内のアイテムは、コロン(:)にアイテム名を続けます。この構文は、SQL問合せおよびPL/SQL内の参照用に使用します。

特殊文字、マルチバイト文字またはunicode文字を含むページ・アイテムを参照するには、ページ・アイテム名を二重引用符で囲みます。

PL/SQL

V('MY_ITEM')

Vファンクションを使用してアイテム値を参照するPL/SQL構文を使用します。

関連項目: Oracle Application Express APIリファレンス

PL/SQL

NV('MY_NUMERIC_ITEM')

NVファンクションを使用して数値アイテム値を参照する標準のPL/SQL構文を使用します。

関連項目: Oracle Application Express APIリファレンス

静的テキスト(完全置換)

標準のアイテム構文:

&MY_ITEM.

特殊文字を含むアイテム用の構文は次のとおりです。

&"MY_ITEM".

静的テキストまたは完全置換の場合は、&ITEM_NAMEにピリオド(.)を続けた表記を使用します。

特殊文字、マルチバイト文字またはunicode文字を含むページ・アイテムを参照するには、ページ・アイテム名を二重引用符で囲みます。

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

次の方法を使用して、アプリケーションのアイテム値およびセッション・ステートを設定します。

- フォーム送信。「フォーム送信の例」を参照。

- バインド変数。「バインド変数構文について」を参照してください。

- 計算。詳細は、「アプリケーションの計算の理解」を参照してください。

- f?p構文。「f?p構文を使用したページのリンク」を参照。

フォーム送信の例

ページがユーザーによって送信されると、Application Expressエンジンは、フィールド(アイテム)に入力された値をセッション・ステートに自動的に格納します。たとえば、2つのページを持つアプリケーションが存在すると想定します。このアプリケーションの最初のページには、ユーザーが電話番号を入力できるフォームが含まれています。このフォームは、P2_PhoneNoという名前のアイテムを作成して定義しています。2番目のページには、ユーザーがフォームに入力する情報を表示する必要があります。

このページが送信されると、Oracle Application Expressによって、電話番号フィールドに入力された値が取得され、今後使用するためにその値が格納されます。ユーザーが入力した電話番号は、そのページのフィールドに関連付けられたアイテムを参照することで、セッション・ステートから取得できます。

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

アプリケーションの開発時に、特定のアイテム、ページ上のすべてのアイテム、アプリケーション内のすべてのページ、または現行のユーザー・セッション用にキャッシュされた値をクリアする必要がある場合があります。キャッシュされた値をクリアすると、その値がNULLにリセットされます。次のトピックでは、セッション・ステートをクリアする具体的な例について説明します。

内容は次のとおりです。

- アイテムごとのキャッシュのクリア

- ページごとのキャッシュのクリア

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

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

アイテムごとのキャッシュのクリア

1つのアイテムのキャッシュをクリアすると、そのアイテムの値がNULLにリセットされます。たとえば、ページがレンダリング用に準備されるときに特定のアイテムの値を確実にNULLにしておく必要がある場合に、この方法を使用します。

次の例では、標準f?p構文を使用してアイテムのキャッシュをクリアします。この例では、アプリケーション100のページ5がコールされます。f?p構文のClearCache位置にMY_ITEMを指定すると、MY_ITEMの値がNULLにリセットされます。

f?p=100:5:&APP_SESSION.::NO:MY_ITEM

次の例では、アイテムTHE_EMPNOおよびTHE_DEPTNOの値がリセットされます。

f?p=100:5:&APP_SESSION.::NO:THE_EMPNO,THE_DEPTNO

ページごとのキャッシュのクリア

アプリケーション・アイテムをキャッシュすると、セッション・ステートを効率的に保持できます。ただし、ページ上のすべてのアイテムのキャッシュをクリアする必要がある場合もあります。たとえば、ユーザーが新しい注文を作成するリンクをクリックすると、ページ上のすべてのフィールドがクリアされるようにする必要があると想定します。ページ全体のキャッシュをクリアすることで、ページ上のすべてのアイテムの値をNULLに設定できます。

2つのページのセッション・キャッシュのクリアおよびページ区切りのリセット

この例では、2つのページのセッション・キャッシュがクリアされ、ページ区切りがリセットされます。

f?p=6000:6003:&APP_SESSION.::NO:RP,6004,6014

この例では、次のようになります。

- アプリケーション6000のページ6003が実行され、現行のセッションIDが使用されます。

- デバッグ情報を表示しないように指示されます(NO)。

- カレント・セッションのキャッシュに保持されたページ6004および6014のアイテムのすべての値がクリアされます。

- ページ6003(リクエストされたページ)のリージョンのページ区切り(RP)がリセットされます。

ページのセッション・キャッシュのクリアおよびアイテム値の引渡し

この例では、更新フォームの実装方法を示します。既存の情報をクリアし、アイテムの値(通常、主キー)を設定します。

f?p=6000:6003:&APP_SESSION.::NO:6003:MY_ITEM:1234

この例では、次のようになります。

- アプリケーション6000のページ6003が実行され、現行のセッションIDが使用されます。

- デバッグ情報を表示しないように指示されます(NO)。

- カレント・セッションのキャッシュに保持されたページ6003のアイテムのすべての値がクリアされます。

- MY_ITEMというアイテムのセッション・ステートの値を1234に設定します。

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

この例は、値が複数のアイテムに渡されること以外は、前述の例に類似しています。

f?p=6000:6004:&APP_SESSION.::NO:6003:MY_ITEM1,MY_ITEM2,MY_ITEM3:1234,,5678

この例では、次のようになります。

- アプリケーション6000のページ6004が実行され、現行のセッションIDが使用されます。

- ページ6003のアイテムのカレント・セッションのキャッシュがクリアされます。

- デバッグ情報を表示しないように指示されます(NO)。

- MY_ITEM1の値が1234、MY_ITEM2の値がNULL(プレースホルダとして使用されたカンマによって示される)およびMY_ITEM3の値が5678に設定されます。

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

アプリケーション・キャッシュは、f?p構文を使用し、キーワードAPPを使用してClear Cache引数を作成することでクリアできます。次に例を示します。

f?p=App:Page:Session::NO:APP

注意:
アプリケーション全体のキャッシュをリセットしても、アプリケーションは完全なリセット状態にはリストアされません。たとえば、アプリケーションに新しいインスタンス開始時の計算やプロセスが含まれている場合、Application Expressエンジンは、該当するアプリケーション・セッションが作成されたときに、これらの計算やプロセスを実行します。その後、キャッシュのクリア・リクエストを処理し、リクエストされたページを表示します。
(セッションIDの追跡にCookieが使用されていない場合に)セッションIDを指定せずにアプリケーションを完全にリセットするには、セッションIDを指定せずにURLを使用するか、または別のアプリケーションからAPEX_UTIL.CLEAR_APP_CACHEをコールして、そのアプリケーションをリクエストする必要があります。セッションIDがCookieを使用して追跡される場合、そのステートをリセットするためにログアウトする必要があります。

カレント・ユーザー・セッションのキャッシュのクリア

アプリケーション・キャッシュをクリアするもう1つの方法は、キーワードSESSIONを使用してClear Cache引数を作成することです。次に例を示します。

f?p=6000:6004:12507785108488427528::NO:SESSION

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

バインド変数構文は、指定したアイテムのセッション・ステートを参照するためにOracle Application ExpressでSQLまたはPL/SQLを使用する場合はいつでも使用できます。次に例を示します。

SELECT * FROM employees WHERE last_name like '%' || :SEARCH_STRING || '%'

この例では、検索文字列がページ・アイテムです。リージョン・タイプがSQL問合せとして定義されている場合、標準SQLバインド変数構文を使用して値を参照できます。バインド変数を使用すると、解析済のSQL問合せがデータベースによって再利用されるため、サーバーによるメモリーの使用が最適化されます。

バインド変数構文を使用する場合は、次の規則に注意してください。

- バインド変数名は、アイテム名に対応している必要があります。

- バインド変数名は、大/小文字が区別されません。

- バインド変数名は、30文字以下である必要があります(有効なOracle識別子である必要があります)。
ページ・アイテム名とアプリケーション・アイテム名は255文字以下に設定できますが、アプリケーション・アイテムをバインド変数構文を使用したSQL内で使用する場合、そのアイテム名は30文字以下で指定する必要があります。

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

リージョン・タイプがSQL問合せ、SQL問合せ(SQL問合せを戻すPL/SQLファンクション本体)、またはLOVとして定義されている場合は、次の構文を使用してセッション・ステートを参照できます。

:MY_ITEM

これを行うための一般的な方法の1つは、セッション・ステート変数をWHERE句に組み込むことです。次の例では、アイテムTHE_DEPTNOの値を、SQL問合せから定義されるリージョンにバインドする方法を示します。

SELECT last_name, job_id, salary
FROM employees
WHERE department_id = :THE_DEPTNO

関連項目:
リージョンを作成する方法については、「リージョンの理解」を参照してください。

PL/SQLに基づくリージョンでのバインド変数の使用

PL/SQL動的コンテンツとして定義されたタイプのリージョンは、PL/SQL無名ブロック構文を使用して構築されます。つまり、開始キーワードおよび終了キーワードがPL/SQLブロックを囲むために自動的に追加されます。次に例を示します。

IF :P1_JOB IS NOT NULL THEN
INSERT INTO employees (employee_id, first_name, job_id)
VALUES (:P1_EMP_ID, :P1_NAME, :P1_JOB)
end if;

この例では、employee_id、first_nameおよびjob_idの値には、P1_EMP_ID、P1_NAMEおよびP1_JOBの値が移入されます。

置換文字列の理解

ページ・テンプレート内またはリージョン・ソース内で置換文字列を使用すると、文字列を別の値に置換できます。ユーザーによるアイテムの編集を可能にするアプリケーションを設計するには、情報を渡すために置換文字列を使用します。

内容は次のとおりです。

- 置換文字列の使用

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

置換文字列の使用

アプリケーション・ビルダーでは、次のように置換文字列を使用できます。

- コンポーネント値を参照するために置換文字列をテンプレート内に含めます。

- &ITEM構文を使用して、ページまたはアプリケーション・アイテムを参照します。

- 組込み置換文字列を使用します。

テンプレート内で使用可能な特別な置換文字列は、シャープ記号(#)で示します。次に例を示します。

#ABC#

置換変数を使用してページまたはアプリケーション・アイテムを参照するには、次のステップを実行します。

1. すべて大文字でページまたはアプリケーション・アイテムを参照します。

2. アイテム名の先頭にアンパサンド(&)を追加します。

3. アイテム名の末尾にピリオド(.)を追加します。

たとえば、HTMLリージョン、リージョン・タイトル、アイテム・ラベル、または静的テキストを使用するその他の多数のコンテキストでF101_Xという名前のアプリケーション・アイテムを参照する場合は、次のように入力します。

&F101_X.

最後にピリオドが必要であることに注意してください。Application Expressエンジンは、置換文字列の値をアイテムF101_Xの値に置き換えます。

指定テンプレート内での置換文字列の使用方法の定義

テンプレートの定義を表示することによって、テンプレート固有のどの置換文字列がどのテンプレートでサポートされるかを確認できます。「テンプレートのカスタマイズ」を参照してください。

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

アプリケーション・ビルダーでは、いくつかの組込み置換文字列がサポートされています。これらの値を参照して特定のタイプの機能を実行できます。

次の項では、これらの置換文字列について、使用する状況および現在サポートされている構文を説明します。バインド変数:USERはデータベース内で特別な意味を持つことに注意してください。また、直接PL/SQLという用語は、プロシージャおよびファンクションなどのストアド・データベース・オブジェクトで使用可能なPL/SQLを表します。

内容は次のとおりです。

- APEX$ROW_NUM

- APEX$ROW_SELECTOR

- APEX$ROW_STATUS

- APP_ID

- APP_ALIAS

- APP_IMAGES

- APP_PAGE_ID

- APP_SESSION

- APP_UNIQUE_PAGE_ID

- APP_USER

- APP_USER

- BROWSER_LANGUAGE

- CURRENT_PARENT_TAB_TEXT

- DEBUG

- HOME_LINK

- IMAGE_PREFIX

- LOGIN_URL

- LOGOUT_URL

- PRINTER_FRIENDLY

- PROXY_SERVER

- PUBLIC_URL_PREFIX

- REQUEST

- SCHEMA OWNER

- SQLERRM

- SYSDATE_YYYYMMDD

- WORKSPACE_IMAGES

関連項目:

- 静的置換文字列をアプリケーション属性として定義する方法については、「置換」を参照してください。

- 認証については、「認証によるユーザー・アイデンティティの証明」を参照してください。

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.

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.

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.

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.

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>

APP_IMAGES

この置換文字列を使用して、特定のアプリケーションに固有で、複数のアプリケーションでは共有されていないアップロードされたイメージ、JavaScriptおよびカスケード・スタイルシートを参照します。ファイルをアップロードして、そのファイルをアプリケーション固有に設定した場合は、この置換文字列またはバインド変数を使用する必要があります。表2-9に、APP_IMAGESを参照するためにサポートされている構文を示します。

表2-9 APP_IMAGES構文

参照タイプ

構文

バインド変数

:APP_IMAGES

直接PL/SQL

使用不可。

PL/SQL

V('APP_IMAGES')

置換文字列

&APP_IMAGES.

テンプレート置換

#APP_IMAGES#

関連項目:
「IMAGE_PREFIX」、「WORKSPACE_IMAGES」および「イメージの管理」

APP_PAGE_ID

APP_PAGE_IDはカレント・アプリケーションIDです。たとえば、アプリケーションが3ページ目に存在した場合、結果は3になります。この構文の使用は、複数のアプリケーションで汎用的に動作する必要があるアプリケーション・コンポーネントを記述する場合に有効です。表2-10に、APP_PAGE_IDを参照するためにサポートされている構文を示します。

表2-10 APP_PAGE_ID構文

参照タイプ

構文

バインド変数

:APP_PAGE_ID

PL/SQL

:APP_PAGE_ID

PL/SQLおよび直接PL

NV('APP_PAGE_ID')

置換文字列

&APP_PAGE_ID.

次に、置換文字列の参照の例を示します。

f?p=&APP_ID.:&APP_PAGE_ID.:&APP_SESSION.

APP_SESSION

APP_SESSIONは、最もよく使用される組込み置換文字列です。この置換文字列を使用して、セッション番号を渡すことによりセッション・ステートを維持するアプリケーション・ページ間のハイパーテキスト・リンクを作成できます。APP_SESSIONのかわりに置換文字列SESSIONを使用することもできます。表2-11に、APP_SESSIONを参照するためにサポートされている構文を示します。

表2-11 APP_SESSION構文

参照タイプ

構文

バインド変数

:APP_SESSION

PL/SQL

V('APP_SESSION')

短縮PL/SQL

V('SESSION')

置換文字列

&APP_SESSION.

次に例を示します。

- HTMLリージョン内からの参照:

<a href="f?p=100:5:&APP_SESSION.">click me</a>

- PL/SQLを使用した参照:

htf.anchor('f?p=100:5:'||V('APP_SESSION'),'click me');

- SQL問合せを使用した参照:

SELECT htf.anchor('f?p=100:5:'||:APP_SESSION,'clickme') FROM DUAL;

APP_UNIQUE_PAGE_ID

APP_UNIQUE_PAGE_IDは、各ページ・ビューに固有なOracle順序から生成される整数です。この数値は、アプリケーションでの重複ページの送信を防止するために使用され、その他の用途にも使用できます。たとえば、一意のURLを作成してブラウザのキャッシュの問題を防止するために、この数値を、fプロシージャへのコール内のリクエスト列またはデバッグ列に埋め込むことができます。表2-12に、APP_UNIQUE_PAGE_IDを参照するためにサポートされている構文を示します。

表2-12 APP_UNIQUE_PAGE_ID構文

参照タイプ

構文

バインド変数

:APP_UNIQUE_PAGE_ID

PL/SQL

V('APP_UNIQUE_PAGE_ID')

置換文字列

&APP_UNIQUE_PAGE_ID.

次に、HTMLの例を示します。

SELECT 'f?p=100:1:'||:APP_SESSION||':'||:APP_UNIQUE_PAGE_ID||
':::P1_EMPNO:'||employee_id,
first_name,
job_id
FROM employees

リクエスト列にAPP_UNIQUE_PAGE_IDが使用されていることに注意してください。これによって、このURLが一意になり、ブラウザによる過度のキャッシュの問題を回避できます。

APP_USER

APP_USERは、アプリケーションを実行しているカレント・ユーザーです。認証モデルに応じて、ユーザーの値の設定も異なります。アプリケーションがデータベース認証を使用して実行されている場合、ユーザーの値はデータベースの擬似列USERと同じになります。アプリケーションが、ユーザー認証を必要とする認証スキームを使用する場合、APP_USERの値はその認証スキームによって設定され、通常は、認証時に使用されるユーザー名に設定されます。表2-13に、APP_USERを参照するためにサポートされている構文を示します。

表2-13 APP_USER構文

参照タイプ

構文

バインド変数

:APP_USER

PL/SQL

V('APP_USER')

置換文字列

&APP_USER.

次に例を示します。

- HTMLリージョン内からの参照:

Hello you are logged in as &APP_USER.

- PL/SQLを使用した参照:

htp.p('Hello you are logged in as'||V('APP_USER'));

- バインド変数としての参照:

SELECT * FROM some_table WHERE user_id = :APP_USER

関連項目:
パブリック・ユーザー属性の詳細は、「認証」を参照してください。

AUTHENTICATED_URL_PREFIX

このアプリケーション・レベルの属性は、有効な認証済接頭辞(ログインしているURLの接頭辞)を示します。相対パスまたはhttpで始まるフルパスを使用できます。このアイテムは、アプリケーションが認証済(ログイン済)モードとパブリック(未ログイン)・モードの両方で実行可能な場合に有効です。AUTHENTICATED_URL_PREFIXを使用すると、認証済のページへのリンクを作成できます。このアイテムは、Basicデータベース認証の使用時に最も有効です。これは、URLの変更に認証が必要になる場合があるためです。表2-14に、AUTHENTICATED_URL_PREFIXを参照するためにサポートされている構文を示します。

表2-14 AUTHENTICATED_URL_PREFIX構文

参照タイプ

構文

バインド変数

:AUTHENTICATED_URL_PREFIX

PL/SQL

V('AUTHENTICATED_URL_PREFIX')

置換文字列

&AUTHENTICATED_URL_PREFIX.

BROWSER_LANGUAGE

BROWSER_LANGUAGEは、Webブラウザの現行の言語プリファレンスを参照します。表2-15に、BROWSER_LANGUAGEを参照するためにサポートされている構文を示します。

表2-15 BROWSER_LANGUAGE構文

参照タイプ

構文

バインド変数

:BROWSER_LANGUAGE

直接PL/SQL

APEX_APPLICATION.G_BROWSER_LANGUAGE

PL/SQL

V('BROWSER_LANGUAGE')

置換文字列

:BROWSER_LANGUAGE.

置換文字列

&BROWSER_LANGUAGE.

CURRENT_PARENT_TAB_TEXT

CURRENT_PARENT_TAB_TEXTは、ページ・テンプレートで最も有効です。ただし、この文字列は、2つのレベルのタブ(親タブと標準タブ)が使用されるアプリケーションでのみ使用できます。この文字列は、親タブ・ラベルの参照に使用します。この置換文字列を使用すると、現在選択されている親タブを、ページ・テンプレート内で繰り返すことができます。表2-16に、CURRENT_PARENT_TAB_TEXTを参照するためにサポートされている構文を示します。

表2-16 CURRENT_PARENT_TAB_TEXT構文

参照タイプ

構文

バインド変数

使用不可。

置換文字列

&CURRENT_PARENT_TAB_TEXT.

DEBUG

DEBUGフラグの有効値はYesまたはNoです。デバッグを有効にすると、アプリケーション・プロセスの詳細が表示されます。カスタム・コードを記述する場合は、デバッグ・モードがYesに設定されている場合にのみデバッグ情報を生成できます。表2-17に、DEBUGを参照するためにサポートされている構文を示します。

表2-17 DEBUG構文

参照タイプ

構文

バインド変数

:DEBUG

直接PL/SQL

APEX_APPLICATION.G_DEBUG

PL/SQL

V('DEBUG')

置換文字列

&DEBUG.

次に、DEBUGの現行の値を保持する置換文字列の参照の例を示します。

f?p=100:1:&APP_SESSION.::&DEBUG

HOME_LINK

HOME_LINKは、アプリケーションのホームページです。ページが指定されておらず、かつ認証スキームのロジックによって代替ページが指定されていない場合、Application Expressエンジンによって、この場所にリダイレクトされます。ホーム・リンクはアプリケーション属性ページに定義します。

表2-18に、HOME_LINKを参照するためにサポートされている構文を示します。

表2-18 HOME_LINK構文

参照タイプ

構文

直接PL/SQL

APEX_APPLICATION.G_HOME_LINK

PL/SQL

V('HOME_LINK')

テンプレート参照

#HOME_LINK#

置換文字列

&HOME_LINK.

関連項目:
ホーム・リンク属性については、「認証」を参照してください。

IMAGE_PREFIX

IMAGE_PREFIXの値によって、Oracle Application Expressによって配布されたイメージ・ディレクトリを指すためにWebサーバーが使用する仮想パスが決まります。アップロードされたイメージを参照する場合は、WORKSPACE_IMAGESおよびAPP_IMAGESを使用します。表2-19に、IMAGE_PREFIXを参照するためにサポートされている構文を示します。

関連項目:
「APP_IMAGES」、「WORKSPACE_IMAGES」および「アプリケーション定義の編集」

表2-19 IMAGE_PREFIX構文

参照タイプ

構文

バインド変数

:IMAGE_PREFIX

直接PL/SQL

APEX_APPLICATION.G_IMAGE_PREFIX

PL/SQL

V('IMAGE_PREFIX')

置換文字列

&IMAGE_PREFIX.

テンプレート置換

#IMAGE_PREFIX#

LOGIN_URL

現在ログインしていないユーザー用のログイン・ページへのリンクを表示するには、LOGIN_URLを使用します。表2-20に、LOGIN_URLを参照するためにサポートされている構文を示します。

関連項目:
「認証」および「セキュリティ属性ページについて」

表2-20 LOGIN_URL構文

参照タイプ

構文

バインド変数

:LOGIN_URL

直接PL/SQL

APEX_APPLICATION.G_LOGIN_URL

PL/SQL

V('LOGIN_URL')

置換文字列

&LOGIN_URL.

テンプレート置換

#LOGIN_URL#

LOGOUT_URL

LOGOUT_URLはアプリケーション・レベルの属性であり、ログアウトURLの指定に使用されます。これは、ユーザーをログアウト・ページにナビゲートさせるか、またはオプションで直接ユーザーをログアウトさせるURLです。ログアウト・ナビゲーション・バー・エントリを作成するには、&LOGOUT_URLの最後にピリオドを追加します(&LOGOUT_URL.)。ページ・テンプレートをコーディングしている場合は、#LOGOUT_URL#を使用します。表2-21に、LOGOUT_URLを参照するためにサポートされている構文を示します。

表2-21 LOGOUT_URL構文

参照タイプ

構文

バインド変数

:LOGOUT_URL

PL/SQL

V('LOGOUT_URL')

置換文字列

&LOGOUT_URL.

テンプレート置換

#LOGOUT_URL#

PRINTER_FRIENDLY

PRINTER_FRIENDLYの値によって、Application Expressエンジンが印刷表示モードで実行するかどうかが決まります。この設定は、印刷されたドキュメントに不要な要素をページから排除するための条件で参照できます。表2-22に、PRINTER_FRIENDLYを参照するためにサポートされている構文を示します。

表2-22 PRINTER_FRIENDLY構文

参照タイプ

構文

直接PL/SQL

APEX_APPLICATION.G_PRINTER_FRIENDLY (VARCHAR2 DATATYPE)

PL/SQL

V('PRINTER_FRIENDLY')

置換文字列

&PRINTER_FRIENDLY.

PROXY_SERVER

PROXY_SERVERは、アプリケーション属性です。この属性は、ソースがURLであるリージョンによって使用される場合があります。次に、データベースからリモートWebサーバーにアクセスするためのPL/SQLを記述する場合に使用する(たとえば、データベースに付属するutl_httpパッケージを使用する場合)直接PL/SQL参照用の適切な構文を示します。

APEX_APPLICATION.G_PROXY_SERVER

PUBLIC_URL_PREFIX

PUBLIC_URL_PREFIXは、アプリケーション・レベルの属性であり、ログイン・モードをパブリック表示に切り替えるURLを指定します。表2-23に、PUBLIC_URL_PREFIXを参照するためにサポートされている構文を示します。

表2-23 PUBLIC_URL_PREFIX構文

参照タイプ

構文

バインド変数

:PUBLIC_URL_PREFIX

PL/SQL

V('PUBLIC_URL_PREFIX')

置換文字列

&PUBLIC_URL_PREFIX.

テンプレート置換

#PUBLIC_URL_PREFIX#

REQUEST

REQUESTの値は、各アプリケーション・ボタンによって、そのボタンの名前またはそのボタンに関連付けられているリクエスト値属性に設定され、これによって、ユーザーがボタンをクリックしたときに、受入れプロセスでそのボタンの名前が参照されるようになります。f?p構文では、REQUESTは4つ目の引数を使用して設定できます。

REQUESTの値の参照

REQUESTは、通常、受入れプロセス(ページのポスト時に発生するプロセス)中に参照されます。表2-24に、REQUESTを参照するためにサポートされている構文を示します。

表2-24 REQUEST構文

参照タイプ

構文

バインド変数

:REQUEST

直接PL/SQL

APEX_APPLICATION.G_REQUEST

PL/SQL

V('REQUEST')

置換文字列

&REQUEST

&REQUEST. (構文の完全一致)

ポストされたページのREQUESTの有効範囲および値

ページをポストすると、受入れプロセスが起動されます。受入れプロセスは、計算、検証、プロセスおよびブランチで構成されています。REQUESTの値は、受入れプロセスの各フェーズで使用可能です。アプリケーションが別のページにブランチされると、REQUESTはNULLに設定されます。

REQUESTの値は、ユーザーがクリックするボタンの名前か、またはユーザーが選択するタブの名前です。たとえば、名前がCHANGEでラベルがApply Changeというボタンがあるとします。ユーザーがこのボタンをクリックすると、REQUESTの値がCHANGEになります。

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

検証、プロセスおよびブランチには「対象ボタン」属性があります。この属性は、選択リストとして表示され、カレント・ページにあるボタン名を含みます。「対象ボタン」から選択した場合、ボタンのREQUEST値を検証、プロセスまたはブランチに関連付けます。

ページの送信にボタンを使用する場合、REQUEST値がページに渡されます。受入れプロセス・ロジックにより、「対象ボタン」属性を使用する各検証、プロセスおよびブランチが評価され、コンポーネントを実行(起動)するかどうかが決定されます。コンポーネントの1つが実行される場合、関連付けられたボタンをユーザーが実際にクリックしてページが送信されたとはみなさないでください。同じリクエスト値を使用する別のボタンがページを送信した可能性があります。同様に、ページのJavaScriptもページを送信してリクエスト値を渡します。

宣言条件を使用したREQUESTの参照

REQUESTは、通常、条件を使用して参照されます。たとえば、ユーザーがレポート・ページ上の「実行」をクリックしたときにページ区切りをリセットする必要がある場合があります。ページ区切りは、送信時ページ・プロセスを作成してリセットできます。ページ・プロセスには、条件「リクエスト=式1」を使用して条件を付けることができます。

送信時ページ・プロセスに条件を設定するには、次のステップを実行します。

1. 「条件」で、条件タイプ「リクエスト=式1」を選択します。

2. 式1で「実行」を実行します。

表示プロセスでのREQUESTの使用

REQUESTは、f?p構文を使用してページに移動するときの表示プロセスにも使用できます。次に例を示します。

f?p=100:1:&APP_SESSION.:GO

f?p構文の4つ目の引数がREQUESTです。この例では、カレント・セッションのアプリケーション100のページ1に移動し、REQUESTの値がGOに設定されます。すべてのプロセスまたはリージョンでは、表示プロセスを使用してREQUESTの値を参照できます。

次に、PL/SQLを使用した同様の例を示します。

IF V ('REQUEST') = 'GO' THEN
htp.p('hello');
END IF;

htp.p('hello')は、特定のテキスト文字列を出力するためのPL/SQL Webツールキット・パッケージへのコールであることに注意してください。

関連項目:

- PL/SQLを使用したWebアプリケーションの開発の詳細は、Oracle Databaseアドバンスト・アプリケーション開発者ガイドを参照してください。

- htpパッケージの詳細は、Oracle Database PL/SQLパッケージおよびタイプ・リファレンスを参照してください。

SCHEMA OWNER

PL/SQLコードからアプリケーションへのコールを生成する場合、Oracle Application Expressスキーマの所有者を参照する必要がある場合があります。次に、直接PL/SQLの参照用の適切な構文を示します。

APEX_APPLICATION.G_FLOW_SCHEMA_OWNER

また、#FLOW_OWNER#を使用してSQL問合せおよびPL/SQL(リージョンやプロセスなど)でこの値を参照することもできます。

SQLERRM

SQLERRMは、アプリケーション・リージョン・エラー・メッセージでのみ使用可能なテンプレート置換です。次に、リージョン・テンプレート置換の参照用の適切な構文を示します。

#SQLERRM#

SYSDATE_YYYYMMDD

SYSDATE_YYYYMMDDは、データベース・サーバーの現在の日付にYYYYMMDD書式マスクを適用して表示します。この値を、SYSDATE()ファンクションを繰り返しコールするかわりに使用できます。次のリストに、SYSDATE_YYYYMMDDを参照するためにサポートされている構文を示します。

- バインド変数

:SYSDATE_YYYYMMDD

- PL/SQL

V('SYSDATE_YYYYMMDD')

- 直接PL/SQL

APEX_APPLICATION.G_SYSDATE (DATE DATATYPE)

表2-25 SYSDATE_YYYYMMDD構文

参照タイプ

構文

バインド変数

:SYSDATE_YYYYMMDD

直接PL/SQL

APEX_APPLICATION.G_SYSDATE (DATE DATATYPE)

PL/SQL

V('SYSDATE_YYYYMMDD')

WORKSPACE_IMAGES

この置換文字列を使用して、ワークスペース内の複数のアプリケーションで共有されているアップロードされたイメージ、JavaScriptおよびカスケード・スタイルシートを参照します。表2-26に、WORKSPACE_IMAGESを参照するためにサポートされている構文を示します。

表2-26 WORKSPACE_IMAGES構文

参照タイプ

構文

バインド変数

:WORKSPACE_IMAGES

直接PL/SQL

使用不可

PL/SQL

V('WORKSPACE_IMAGES')

置換文字列

&WORKSPACE_IMAGES.

テンプレート置換

#WORKSPACE_IMAGES#

関連項目:
「APP_IMAGES」および「IMAGE_PREFIX」

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

ここでは、Oracle Application Expressで使用できるパッケージ・アプリケーションのインストール方法と実行方法について説明します。

内容は次のとおりです。

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

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

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

- サンプルWebシート - AnyCo IT部門について

関連項目:
『Oracle Application Express管理ガイド』の「新しいワークスペースでのサンプル・アプリケーションの作成の無効化」および『Oracle Database Application Express 2日で開発者ガイド』の「パブリック・パッケージ・アプリケーションおよびサンプル・コードのダウンロード」

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

Oracle Application Expressには、2つのタイプのパッケージ・アプリケーションがあります。

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

- 生産性アプリケーション

サンプル・アプリケーションと生産性アプリケーションは、特定のビジネス・ニーズに対応するように設計された完全版のアプリケーションです。パッケージ・アプリケーションは、そのままの状態でインストール、実行および使用したり、分析してアプリケーション・ビルダーを使用した特定タイプの機能の構築方法をよりよく理解できます。

サンプル・アプリケーションと生産性アプリケーションの主な違いは、サポートのレベルです。デフォルトでは、サンプル・アプリケーションは完全に編集できます。一方、生産性アプリケーションは、編集する前にロックを解除する必要があります。生産性アプリケーションのロックを解除すると、アプリケーションは今後のアップグレードを受けられなくなるか、Oracleサポートによるサポートの対象外となります。

パッケージ・アプリケーションの管理

ここでは、パッケージ・アプリケーションを表示、インストール、実行および削除する方法について説明します。

内容は次のとおりです。

- パッケージ・アプリケーション・ページへのアクセス

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

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

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

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

- インストールされたパッケージ・アプリケーションのエクスポート

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

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

パッケージ・アプリケーション・ページへのアクセス

パッケージ・アプリケーション・ページにアクセスするには、次のステップを実行します。

1. Oracle Application Expressにログインします。
ワークスペースのホームページが表示されます。

2. 「アプリケーション・ビルダー」アイコンをクリックします。
アプリケーション・ビルダーのホームページが表示されます。

3. 「パッケージ・アプリケーション」タブを選択します。
図packapp_tab.gifの説明

パッケージ・アプリケーション・ページが表示されます。

図packapp_pg.gifの説明

アプリケーション・カテゴリ(たとえば、「ソフトウェア開発」や「サンプルWebシート」)がアプリケーション・タイトルの下に表示されます。製品カテゴリの下に表示される緑色の「インストール済」タグによって、インストール済のアプリケーションを識別できます。

図packapp_installed.gifの説明

4. ページの上部にある次のリストを使用して、表示をフィルタします。

- カテゴリ: アプリケーション・カテゴリでソートします。オプションには、「コミュニティ」、「IT管理」、「ナレッジ管理」、「マーケティング」、「プロジェクト管理」、「サンプル」、「ソフトウェア開発」、「チームの生産性」、「トラッキング」などがあります。

- タイプ: アプリケーション・タイプでソートします。オプションには、「すべてのアプリケーション」、「インストール済のみ」、「未インストール」、「データベース・アプリケーション」、「Webシート」があります。

5. パッケージ・アプリケーションに関する情報を表示したり、以前にインストールしたパッケージ・アプリケーションをインストールまたは削除するには、アプリケーション・イメージをクリックします。

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

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

1. パッケージ・アプリケーション・ページに移動します。「パッケージ・アプリケーション・ページへのアクセス」を参照してください。
「パッケージ・アプリケーション」ページが表示されます。

2. インストールするアプリケーションを探します。

ヒント:
「カテゴリ」リストおよび「タイプ」リストを使用して表示をフィルタします。

3. アプリケーション・イメージをクリックします。
サマリー・ページが表示されます。

4. 「アプリケーションのインストール」をクリックします。

5. 認証スキームを選択し、「次へ」をクリックします。

6. 「アプリケーションのインストール」を再度クリックします。
成功メッセージが表示されます。

7. アプリケーションを実行するには、「アプリケーションの実行」アイコンをクリックします。

8. 適切なログイン資格証明を入力します。

1. ユーザー名: ワークスペース・ユーザー名を入力します。

2. パスワード: ワークスペース・パスワードを入力します。

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

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

インストールされたパッケージ・アプリケーションを実行するには、次のステップを実行します。

1. パッケージ・アプリケーション・ページに移動します。「パッケージ・アプリケーション・ページへのアクセス」を参照してください。
「パッケージ・アプリケーション」ページが表示されます。

2. アプリケーションを選択します。

ヒント:
「カテゴリ」および「タイプ」リストを使用して、表示にフィルタを適用します。

3. アプリケーション・イメージをクリックします。

4. 「実行」をクリックします。

5. 適切なログイン資格証明を入力します。

1. ユーザー名: ワークスペース・ユーザー名を入力します。

2. パスワード: ワークスペース・パスワードを入力します。

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

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

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

1. パッケージ・アプリケーション・ページに移動します。「パッケージ・アプリケーション・ページへのアクセス」を参照してください。
「パッケージ・アプリケーション」ページが表示されます。

2. 削除するアプリケーションを選択します。

ヒント:
「カテゴリ」および「タイプ」リストを使用して、表示にフィルタを適用します。

3. アプリケーション・イメージをクリックします。

4. 「削除」をクリックします。

5. プロンプトが表示されたら、「アプリケーションの削除」をクリックします。

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

サンプル・パッケージ・アプリケーションと生産性パッケージ・アプリケーションの主な違いは、サポートのレベルです。生産性アプリケーションのインストール後、そのアプリケーションを編集する前にロックを解除する必要があります。デフォルトでは、サンプル・アプリケーションは完全に編集可能です。

注意:
生産性アプリケーションのロックを解除すると、そのアプリケーションは今後のアップグレードまたはOracleサポートによるサポートを受けられなくなります。

インストールされた生産性パッケージ・アプリケーションのロックを解除するには、次のステップを実行します。

1. パッケージ・アプリケーション・ページに移動します。「パッケージ・アプリケーション・ページへのアクセス」を参照してください。
「パッケージ・アプリケーション」ページが表示されます。

2. ロックを解除するアプリケーションを選択します。

ヒント:
「カテゴリ」および「タイプ」リストを使用して、表示にフィルタを適用します。

3. アプリケーション・イメージをクリックします。

4. 「管理」をクリックします。

5. 「アプリケーションのロック解除」をクリックし、「次へ」をクリックします。

6. プロンプトが表示されたら、「アプリケーションのロック解除」をクリックします。

インストールされたパッケージ・アプリケーションのエクスポート

インストールされたパッケージ・アプリケーションをエクスポートするには、次のステップを実行します。

1. パッケージ・アプリケーション・ページに移動します。「パッケージ・アプリケーション・ページへのアクセス」を参照してください。
「パッケージ・アプリケーション」ページが表示されます。

2. エクスポートするアプリケーションを探して選択します。

ヒント:
「カテゴリ」および「タイプ」リストを使用して、表示にフィルタを適用します。

3. 「管理」をクリックします。

4. 「アプリケーションのエクスポート」を選択し、「次へ」をクリックします。

5. パッケージ・アプリケーションのエクスポート・ページで、ダウンロード・リンクをクリックします。

- 「アプリケーションのエクスポート」ダウンロード

- 「サポートするオブジェクトのエクスポート」ダウンロード

各リンクをクリックすると、SQLスクリプトがダウンロードされます。

6. ダウンロードしたスクリプトを実行して、アプリケーションとサポートするオブジェクトを新しいワークスペースにインポートします。

ヒント:
ダウンロードしたスクリプトは、SQL*PlusやSQL Developerから実行するか、Oracle Application ExpressのSQLスクリプトを使用して実行できます。詳細は、『Oracle Application Express SQLワークショップ・ガイド』のSQLスクリプトの使用に関する説明を参照してください。

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

インストールされたパッケージ・アプリケーションの認証を変更するには、次のステップを実行します。

1. パッケージ・アプリケーション・ページに移動します。「パッケージ・アプリケーション・ページへのアクセス」を参照してください。
「パッケージ・アプリケーション」ページが表示されます。

2. インストールされたアプリケーションを探して選択します。

3. 「管理」をクリックします。

4. 「認証の変更」を選択し、「次へ」をクリックします。
認証スキーム・ページが表示されます。

5. 「名前」で、次の項目を指定します。

1. 名前: 他のアプリケーション開発者が認証スキームを参照するための名前を入力します。

2. スキーム・タイプ: 新しい認証スキームを選択します。

6. 該当するフィールドに入力します。

7. 特定のフィールドの詳細は、アイテムのヘルプを参照してください。
ヘルプが使用できる場合、カーソルは疑問符マークに変わります。「フィールドレベル・ヘルプについて」を参照してください。

関連項目:
「認証を介したユーザーの本人確認」

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

パッケージ・アプリケーションの名前の横に「更新があります」というメッセージが表示されている場合は、そのアプリケーションを更新できます。

パッケージ・アプリケーションを更新するには、次のステップを実行します。

1. パッケージ・アプリケーション・ページに移動します。「パッケージ・アプリケーション・ページへのアクセス」を参照してください。
「パッケージ・アプリケーション」ページが表示されます。

2. 更新するアプリケーションを探して選択します。

3. 「更新」をクリックします。
アプリケーションの更新ウィザードが表示されます。

4. 「アプリケーションの更新」をクリックします。
更新後、更新済のパッケージ・アプリケーション・ページが表示されます。

関連項目:
「インストールされたパッケージ・アプリケーションの実行」

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

ここでは、サンプル・データベース・アプリケーションというパッケージ・アプリケーションについて説明します。すべてのパッケージ・アプリケーションと同様に、サンプル・データベース・アプリケーションは完全に編集できます。このパッケージ・アプリケーションには、衣料品の注文および顧客情報を表示、更新および検索するための使用しやすいインタフェースがあります。「Home」、「Customers」、「Products」、「Orders」および「Reports」タブを使用して、ページ間を移動できます。

内容は次のとおりです。

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

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

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

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

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

1. パッケージ・アプリケーション・ページに移動します。「パッケージ・アプリケーション・ページへのアクセス」を参照してください。
「パッケージ・アプリケーション」ページが表示されます。

2. 「カテゴリ」リストで、「サンプル」を選択します。

3. 「タイプ」リストから「未インストール」を選択します。

4. 「サンプル・データベース・アプリケーション」を選択します。

ヒント:
「カテゴリ」および「タイプ」リストを使用して、表示にフィルタを適用します。

5. アプリケーション・イメージをクリックします。
サマリー・ページが表示されます。

6. 「アプリケーションのインストール」をクリックします。

7. 認証スキームを選択し、「次へ」をクリックします。

8. 「アプリケーションのインストール」を再度クリックします。
成功メッセージが表示されます。

9. アプリケーションを実行するには、「アプリケーションの実行」アイコンをクリックします。

10. 適切なログイン資格証明を入力します。

1. ユーザー名: ワークスペース・ユーザー名を入力します。

2. パスワード: ワークスペース・パスワードを入力します。

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

関連項目:
「インストールしたパッケージ・アプリケーションの実行」

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

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

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

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

- Oracle Application Expressで使用可能なFlashチャートおよびマップ

- カレンダ・レポート

- デスクトップ・ページで使用可能な機能の大部分をレプリケートするためのモバイル・ページ

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

内容は次のとおりです。

- ホームページについて

- Customersページについて

- Productsページについて

- Ordersページについて

- Reportsページについて

- Administrationページについて

- モバイル・バージョンについて

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

ホームページについて

sampl_app_plain.gifの説明

ホームページには4つのメイン・リージョンがあります。

- Sales Quota for this Month

- Top Customers

- Top Products

- Top Orders by Date

Sales for this Month: Flashダイアル・チャートの使用方法を示します。このチャートには、基礎となるSQL文に基づいた値が表示されます。この例では示されていませんが、Flashチャートの属性を編集して非同期リフレッシュを有効にできます。

Top Customers: SQL問合せに基づくレポートで、Customersページに表示される情報のサブセットを表示します。ユーザーは、顧客名をクリックするか、リージョンの右上隅にある「View Customer」アイコン(右矢印)をクリックすることによって、追加の詳細情報にリンクできます。

Top Products: これもSQL問合せに基づくレポートです。このレポートは、Productsページに表示される情報のサブセットを表示します。ユーザーは、製品名をクリックするか、リージョンの右上隅にある「View Products」 アイコンをクリックすることによって、製品の詳細情報にリンクできます。

Top Orders by Date: 日付別の注文と注文金額を表示します。ユーザーは右上隅の右矢印をクリックすることによって、Ordersページを表示できます。

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

Customersページについて

Customersページでは、ユーザーが顧客情報を表示および編集できます。

customer.gifの説明

Customers: 顧客情報を追跡するための対話モード・レポートです。顧客を検索するには、「検索」フィールドに顧客の名前を入力し、「実行」をクリックします。顧客名でソートするには、列ヘッダーをクリックして、昇順または降順モードでソートするための上または下向き矢印を選択します。「対話モード・レポートのカスタマイズ」を参照してください。

「アクション」メニューを使用してレポートの外観を変更できます。「「アクション」メニューについて」を参照してください。既存の顧客情報を更新するには、「編集」アイコンをクリックします。新規顧客を追加するには、「Create Customer」ボタンをクリックします。データをアップロードするには、「データをアップロード」ボタンをクリックします。

関連項目:
「対話モード・レポートのカスタマイズ」

Productsページについて

Productsページでは、製品情報を表示および編集できます。「Products」リージョン: 製品情報が表示されます。このリージョンは、データベースに格納されたイメージを表示するためのカスタム・ファンクションを使用するSQL問合せに基づきます。

products.gifの説明

デフォルトでは、このページは詳細ビューで表示されます。「実行」ボタンの右側にある「アイコンの表示」および「レポートの表示」をクリックして、ビューを変更できます。レポート・ビューでは、列ヘッダーをクリックして、昇順または降順モードでソートするための上または下向き矢印を選択することによって、製品カテゴリ別にソートできます。「アクション」メニューを使用すればレポートの外観を変更できます。「「アクション」メニューについて」を参照してください。製品の説明を編集するには、「編集」アイコンをクリックします。新しい製品を追加するには、ページ上部の「Create Product」ボタンをクリックします。

「Orders」ページについて

Ordersページでは、ユーザーが顧客の注文を表示および編集できます。

orders.gifの説明

My Ordersは注文情報を追跡するための対話モード・レポートです。列でソートするには、列ヘッダーをクリックして、昇順または降順モードでソートするための上または下向き矢印を選択します。

「アクション」メニューを使用してレポートの外観を変更できます。カレンダで注文を表示するには、「カレンダ」をクリックします。カレンダが表示されます。注文カレンダでカレンダのエントリをクリックすると、特定の注文にリンクできます。既存の顧客情報を更新するには、「編集」アイコンをクリックします。新しい注文を追加するには、「Enter New Order」ボタンをクリックします。

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

Reportsページについて

reports_pg.gifの説明

Reportsページでは、棒グラフ、円グラフ、マップ、ツリー、タグなどの様々な書式で情報を表示できます。レポートまたはチャートを表示するには、それを選択します。

関連項目:
「チャートの作成」、「マップの作成」および「ツリーの作成」

Administrationページについて

右上隅にある「Administration」リンクをクリックすると、Administrationページが表示されます。Administrationページを使用して、サンプル・データの管理、州コードと州名の管理およびユーザー・フィードバック機能の有効化を実行します。ページの右側にあるレポートを使用して、ユーザー・アクティビティの表示、ページ・ビューの表示および月次カレンダでのページ・ビューの表示を実行します。

Administrationページにアクセスするには、次のステップを実行します。

1. パッケージ・アプリケーション・ページに移動し、サンプル・データベース・アプリケーションを実行します。「インストールされたパッケージ・アプリケーションの実行」を参照してください。

2. ホームページで、右上隅にある「Administration」リンクをクリックします。
図samp_app_mobile_alink.gifの説明

Administrationページが表示され、このページには「Administration」リージョンと「Reports」リージョンがあります。

図samp_app_admin.gifの説明

「Administration」リージョンには、次のセクションがあります。

- Manage Sample Data: サンプル・データベース・アプリケーションに付属しているサンプル・データを削除または再作成します。

- Manage States: 州を追加、編集または削除します。

- Feedback: アプリケーションのフィードバックを有効化、無効化および管理します。詳細は、「フィードバックの管理」を参照してください。

「Reports」リージョンには、次のセクションがあります。

- Top Users: アプリケーションのユーザー・アクティビティを表示します。

- Page Views: アプリケーションのページ・ビューをユーザー別に表示します。

- Activity Calendar: ユーザー別のページ・ビューをカレンダ形式で表示します。

モバイル・バージョンについて

ホームページの右上隅にある「Mobile」リンクをクリックすると、サンプル・データベース・アプリケーションがモバイル・デバイスと互換性のある形式で表示されます。このモバイル・バージョンは、デスクトップ・バージョンで使用可能な機能の大部分をレプリケートします。

サンプル・データベース・アプリケーションのモバイル・バージョンにアクセスするには、次のステップを実行します。

1. パッケージ・アプリケーション・ページに移動し、サンプル・データベース・アプリケーションを実行します。「インストールしたパッケージ・アプリケーションの実行」を参照してください。

2. 右上隅にある「Mobile」リンクをクリックします。
図samp_app_mobile_mlink.gifの説明

サンプル・データベース・アプリケーションのモバイル・バージョンが表示されます。

図samp_app_mobile.gifの説明

3. ページを表示するには、それを選択します。

4. 特定の顧客または製品を編集するには、それを選択します。
図samp_app_mobile_cust.gifの説明

フォームが表示されます。

5. ホームページに戻るには、左上隅にある「Home」アイコンをクリックします。
ホームページが表示されます。

6. ホームページで、次のステップを実行します。

- サンプル・データベース・アプリケーションのデスクトップ・バージョンに戻るには、「Full Site」をクリックします。

- アプリケーション・ビルダーに戻るには、「Logout」をクリックします。

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

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

ヒント:
Oracle Application Expressには、サンプルアプリケーションと生産性アプリケーションの2種類のパッケージ・アプリケーションがあります。デフォルトでは、サンプル・アプリケーションは完全に編集可能です。対照的に、生産性アプリケーションを編集するには、そのロックを解除する必要があります。生産性パッケージ・アプリケーションのロックを解除すると、そのアプリケーションは今後のアップグレードまたはOracleサポートによるサポートを受けられなくなります。

内容は次のとおりです。

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

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

関連項目:
データベース・アプリケーションの構築の概要は、『Oracle Database Application Express 2日で開発者ガイド』を参照してください。

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

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

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

図d_toolbar_149.gifの説明

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

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

- アプリケーションID: 「アプリケーション」ホームページにリンクします。「「アプリケーション」ホームページについて」を参照してください。

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

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

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

- キャッシュ: キャッシュ・ページにリンクします。「キャッシュされたリージョンの管理」を参照してください。

- デバッグの表示: デバッグ・ウィンドウを表示します。「デバッグ・モードへのアクセス」を参照してください。

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

- 編集リンクの表示: 「編集リンクの表示」と「編集リンクを非表示」とを切り替えます。「編集リンクの表示」をクリックすると、ページ上の編集可能な各オブジェクトの横に小さなオレンジ色のアイコンが表示されます。各アイコンは、オレンジ色で中に三角形があり、その下に2本の罫線があります。リンクをクリックすると、オブジェクト編集用の別のウィンドウが表示されます。

- グリッドの表示: グリッド・レイアウトが使用されている場合に、リージョンおよびページ・アイテムがどのようにページに配置されているかを確認できます。

注意:
「開発者」ツールバーは、ロックされたパッケージ・アプリケーション・ページまたはjQuery Mobileスマートフォン・ページには表示されません。

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

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

実行中のアプリケーションを編集するには、「開発者」ツールバーの「アプリケーション」リンクをクリックします。「アプリケーション」ホームページが表示されます。アプリケーションIDとアプリケーション名がページ上部に表示されます。

図bldr_hm_top.gifの説明

次のいずれかをクリックすると、現在のアプリケーションの実行、サポートするオブジェクトの編集、共有コンポーネントの作成、または情報のエクスポートおよびインポートが可能になります。

- アプリケーションの実行: カレント・アプリケーションのページをApplication Expressエンジンに送信し、表示可能なHTMLをレンダリングします。詳細は、「Application Expressエンジンによるページのレンダリング方法および処理方法」を参照してください。

- サポートするオブジェクト: サポートするオブジェクト・ページにリンクします。「カスタム・パッケージ・アプリケーションの作成方法」を参照してください。

- 共有コンポーネント: アプリケーション内のすべてのページに表示または適用できる共有コンポーネントおよびユーザー・インタフェース・コントロールのリストにリンクします。詳細は、「共有コンポーネントでの作業」を参照してください。

- ユーティリティ: ユーティリティ・ページにリンクします。このページを使用して、開発者アクティビティの監視、ダッシュボードの表示、アドバイザの実行およびその他数多くのレポートの表示を行います。詳細は、「アプリケーション・ビルダー・ユーティリティの使用」を参照してください。

- エクスポート/インポート: エクスポート/インポート・ウィザードにリンクします。このウィザードを使用して、アプリケーション全体のインポートとエクスポート、およびカスケード・スタイルシート、イメージ、静的ファイル、スクリプト・ファイル、テーマ、ユーザー・インタフェースのデフォルト値、ワークスペース・ユーザーなどの関連ファイルのインポートとエクスポートを行うことができます。詳細は、「アプリケーションおよび関連ファイルのエクスポート」を参照してください。

アプリケーションを構成するページが「アプリケーション」ホームページに表示されます。特定のページにアクセスするには、そのページをクリックします。特定のページを検索するには、「ページ」フィールドにページ・タイトルを入力またはページ名に対して大文字小文字を区別しない問合せを入力して、「実行」をクリックします。

関連項目:
「「アプリケーション」ホームページについて」および「「ページ定義」について」

サンプルWebシート - AnyCo IT部門について

この項では、サンプルWebシート - AnyCo IT部門というパッケージ・アプリケーションについて説明します。サンプルWebシート - AnyCo IT部門は、Webシートの特徴と機能に焦点を当てています。

内容は次のとおりです。

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

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

- AnyCo IT部門の理解

- 共通のWebシート・ユーザー・インタフェース要素

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

関連項目:
Webシート・アプリケーションの作成の詳細は、「Webシート・アプリケーションについて」を参照してください。

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

サンプルWebシート - AnyCo IT部門をインストールおよび実行するには、次のステップを実行します。

1. パッケージ・アプリケーション・ページに移動します。「パッケージ・アプリケーション・ページへのアクセス」を参照してください。
「パッケージ・アプリケーション」ページが表示されます。

2. 「カテゴリ」リストから「サンプル」を選択します。

3. 「タイプ」リストから「Webシート」を選択します。

4. 「サンプルWebシート - AnyCo IT部門」を選択します。

5. アプリケーション・イメージをクリックします。
サマリー・ページが表示されます。

6. 「アプリケーションのインストール」をクリックします。

7. 認証スキームを選択し、「次へ」をクリックします。

8. 「アプリケーションのインストール」を再度クリックします。
成功メッセージが表示されます。

9. アプリケーションを実行するには、「アプリケーションの実行」アイコンをクリックします。

10. 適切なログイン資格証明を入力します。

1. ユーザー名: ワークスペース・ユーザー名を入力します。

2. パスワード: ワークスペース・パスワードを入力します。

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

ホームページが表示されます。

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

すべてのWebシートに、ページ内やページ間を簡単に移動するための、共通のナビゲーション要素が含まれています。各Webシート・ページは、セクションに分かれています。セクション・タイトルの左側にある矢印をクリックすると、ページ・セクションを表示したり非表示にすることができます。次の例では、「Systems Overview」は非表示になっています。

図websheet_nav1.gifの説明

ブレッドクラムを使用したWebシート・ページ間のナビゲート

ブレッドクラムは、すべてのWebシート・ページの上部に表示されます。「ホーム」・ブレッドクラムの上にマウスを置くと、Webシートのすべてのページに対するリンクのサブメニューが表示されます。

図websheet_bread.gifに関する説明

関連項目:
「ページ・ディレクトリの表示」

AnyCo IT部門の理解

サンプルWebシート - AnyCo IT部門では、次の機能を示します。

- Webシート・ページを使用したテキスト、データおよびイメージの共有方法の例

- ページ・セクションおよびページ間の階層的なナビゲーション

- 形式が設定されたテキストと、それに含まれる、形式を簡単に設定できるリンク

- データ・グリッドの作成による表形式データの表示、およびレポート、対話モード・レポートまたはチャートとしてのコンテンツの表示

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

内容は次のとおりです。

- ナビゲーションの理解

- ホームページについて

- Project Reviewページについて

- Systemsページについて

- Planned Purchase Reviewについて

- Systems Budget Reviewについて

ナビゲーションの理解

ホームページの上部に表示される階層ツリーにより、Webシート・ページ間をナビゲートできます。「ホーム」のブレッドクラムの左側にある矢印をクリックすると、ツリーを開閉できます。ナビゲーションの追加の詳細は、「ナビゲーション・セクションについて」を参照してください。

図websheet_nav.gifの説明

セクション内のサブセクション(または子)を表示するには、セクション名の左側にある矢印をクリックします。「すべて開く」をクリックすると、すべてのページおよびページのサブセクションが表示され、「リセット」をクリックすると、ツリーがデフォルト表示に戻ります。別のページにリンクするには、ページ名を選択します。

図websheet_nav2.gifの説明

ホームページについて

図websheet_home.gifの説明

サンプルWebシート - AnyCo IT部門のホームページには、次の4つのセクションがあります。

- ページ・ナビゲーション・ツリー

- AnyCo IT Department

- Projects Summary

- Systems Summary

「AnyCo IT Department」は、別のページへのリンクと埋込みイメージが含まれているテキスト・セクションです。

「Projects Summary」は、3Dグラフとして表示されるデータ・グリッドです。棒の上にカーソルを置くと、色が変化し、金額(ドル)が表示されます。

図websheet_proj_sum.gifの説明

「Systems Summary」は、ハードウェア、ソフトウェアおよびクラウド・サービスのレポートです。セクションの下部には、「Systems Management」レポートおよびSystemsページへのリンクがあります。

図websheet_sys_sum.gifの説明

関連項目:
「SQLおよびSQLVALUE構文の使用」

Projectsページについて

図websheet_table.gifの説明

プロジェクトには、「Projects Breakdown」という1つのセクションがあります。「Projects Breakdown」セクションには、Project Reviewページへのリンクおよび主なITプロジェクトの更新可能なレポートが含まれています。特定プロジェクトを編集するには、「行の編集」アイコンをクリックします。別のプロジェクトを追加するには、「行の追加」アイコンをクリックします。

関連項目:
「SQLおよびSQLVALUE構文の使用」

Project Reviewページについて

図websheet_proj_review.gifの説明

Project Reviewページには、「Budget Review」および「Task Analysis」という2つのセクションがあります。両セクションとも、異なるタイプの3Dグラフとして表示されるデータ・グリッドです。

関連項目:
「チャート・セクションについて」

Systemsページについて

図websheet_sys_nav.gifの説明

Systemsページには、次の3つのセクションがあります。

- System

- System Overview

- Systems Maintenance

- Purchasing Projections

「System」は、「Systems Overview」、「Systems Maintenance」および「Purchasing Projections」の各セクションへのリンクが含まれているナビゲーション・セクションです。

「System Overview」は、埋込みイメージおよび他のページへのリンクが含まれているテキスト・セクションです。

「System Maintenance」は、3D横棒グラフとして表示されるデータ・グリッドです。棒の上にカーソルを置くと、色が変化し、金額(ドル)が表示されます。

「Purchasing Projections」には、計画購入のレポートおよびPlanned Purchases Reviewページへのリンクが表示されます。エントリを追加するには、「行の追加」をクリックします。

計画購入の確認について

図websheet_plan_pur.gifの説明

Planned Purchase Reviewページには、次の2つのセクションがあります。

- Vendor Analysis

- Total Planned Purchases

「Vendor Analysis」は、ベンダーのレポートです。

「Total Planned Purchases」は、3D横棒グラフとして表示されるデータ・グリッドです。棒の上にカーソルを置くと、色が変化し、金額(ドル)が表示されます。

システム予算の確認について

図websheet_bud_alloc.gifの説明

Systems Budget Reviewページには、次の2つのセクションがあります。

- Annual Budget Allocation

- Remaining Budget for the Year

「Annual Budget Allocation」は、レポート予算カテゴリです。レポート項目を更新するには、「行の編集」アイコンをクリックします。

「Remaining Budget for the Year」は、3D円グラフとして表示されるデータ・グリッドです。円のセクションの上にカーソルを置くと、金額(ドル)が表示されます。セクションを選択すると、そのセクションが円からわずかに離れます。

共通のWebシート・ユーザー・インタフェース要素

次に続く項では、すべてのWebシートに共通のインタフェース要素について説明します。

内容は次のとおりです。

- Webシート・メニューについて

- Webシート検索について

- コントロール・パネルについて

- ファイル・リージョンについて

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

- ノート・リージョンについて

Webシート・メニューについて

図websheet_nav.gifの説明

各Webシートの上部に、次の5つのメニューが表示されます。

- 表示

- 作成

- 編集

- データ・グリッド

- 管理

これらのメニュー内の作成および編集オプションの多くは、ページの右側に表示されるコントロール・パネルと重複しています。詳細は、「Webシート・アプリケーションについて」を参照してください。

Webシート検索について

「Webシートの検索」フィールドは、各Webシート・ページの右上に表示されます。

図websheet_search.gifに関する説明

Webシートの検索を使用すると、アプリケーション・コンテンツの大/小文字を区別しない検索を実行できます。詳細は、「Webシート検索について」を参照してください。

コントロール・パネルについて

コントロール・パネルは、Webシート・ページの右側に表示され、ページ上部の「作成」、「編集」および「表示」メニューで使用可能なコマンドが含まれています。「コントロール・パネル」を非表示または表示するには、リージョン・タイトルの右側にある矢印をクリックします。

図websheet_control_panel.gifに関する説明

Webシートの「コントロール・パネル」には、次のオプションがあります。

- 「新規セクション」。「ページ・セクションの追加と編集について」を参照してください。

- 「セクションの編集」。「ページ・セクションの追加と編集について」を参照してください。

- 新しいページ: 「新しいページの追加」を参照してください。

- 「コピーの新規ページ」。「既存ページのコピー」を参照してください。

- 「ページの編集」。「ページの詳細の編集」を参照してください。

- 「ページ・ディレクトリ」。「ページ・ディレクトリの表示」を参照してください。

- 「新しいデータ・グリッド」。「データ・グリッドの作成」を参照してください。

ファイル・リージョンについて

ファイル・リージョンは、コントロール・パネルの下に表示されます。ファイル・リージョンには、現在のページに最近アップロードされたファイルが表示されます。「コントロール・パネル」を非表示または表示するには、リージョン・タイトルの右側にある矢印をクリックします。

関連項目:
「アップロード済ファイルとイメージの管理」

タグ・リージョンについて

タグ・リージョンを使用すると、現在のページを識別し、検索を容易にするタグを入力できます。タグ・リージョンを非表示または表示するには、リージョン・タイトルの右側にある矢印をクリックします。

関連項目:
「タグの追加」

ノート・リージョンについて

ノート・リージョンには、現在のページに関連する備考が表示されます。ノート・リージョンを非表示または表示するには、リージョン・タイトルの右側にある矢印をクリックします。

関連項目:
「ノートの追加」

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

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

ヒント:
Oracle Application Expressには、2つのタイプのパッケージ・アプリケーション(サンプル・アプリケーションと生産性アプリケーション)があります。デフォルトでは、サンプル・アプリケーションは完全に編集可能です。一方、生産性アプリケーションは、編集する前にロックを解除する必要があります。生産性パッケージ・アプリケーションのロックを解除すると、アプリケーションは今後のアップグレードを受けられなくなるか、Oracleサポートによるサポートの対象外となります。

この後の項では、Webシートの編集に関する高レベルの説明を示します。詳細は、「Webシート・アプリケーションについて」を参照してください。

Webシート・セクションを更新するには、次のステップを実行します。

1. 「パッケージ・アプリケーションについて」の説明に従ってWebシートを実行します。

2. セクションの右上に表示される「編集」アイコンをクリックします。
図websheet_edit_sect.gifに関する説明

セクションの編集ページが表示されます。特定のセクションを編集する方法は、セクション・タイプによって異なります。

3. 表示されたフィールドを編集します。

4. 書式設定を変更するには、右上隅にあるツールバーの展開アイコンをクリックします。
図websheet_toolbar2.gifに関する説明

ツールバーが表示されます。カーソルをアイコンに重ねると、説明ツールチップが表示されます。

5. このツールバーを非表示にするには、ツールバーの折り畳みアイコンをクリックします。
図websheet_toolbar.gifに関する説明

6. 変更を保存するには、「変更の適用」をクリックします。

関連項目:
Webシートの編集の詳細は、「ページ・セクションの追加と編集について」を参照してください。

4 開発プロセスの管理

チーム開発は組込みの開発管理ツールであり、このツールを使用すると、新機能、機能に関連しないタスク(つまりTo Do)、バグおよびマイルストンを追跡して、開発プロセスを管理できます。ユーザーはリアルタイム・フィードバックを提供でき、このフィードバックはTo Do、バグまたは機能に分類できます。

内容は次のとおりです。

- チーム開発のホームページについて

- 機能の追跡

- マイルストンの追跡

- To Doの追跡

- バグの管理

- フィードバックの管理

- タグ・サマリーの使用

- チーム・アクションの管理

チーム開発のホームページについて

チーム開発のホームページは、機能、マイルストン、To Do、バグおよびフィードバックを管理する起点となります。

図team_dev_icons.gifの説明

ページの中央に次の大きなアイコンが表示されます。

- 「マイルストン」。開発プロセスに関連するイベントを追跡します。マイルストンは、機能、バグおよびTo Doに関連付けることができます。「マイルストンの追跡」を参照してください。

- 「機能」。機能が最初に構想されてから実装されるまでを追跡します。機能は、リリース、割当て先、タグまたは関連付けられたマイルストン別に編成できます。「機能の追跡」を参照してください。

- 「To Do」。割当て、優先度付け、タグ付けおよび追跡が可能なアクション・アイテムを管理します。また、To Doに親タスクを関連付けることもできます。機能またはマイルストンに関連付けることもできますが、それは必須ではありません。「To Doの追跡」を参照してください。

- 「バグ」。ソフトウェアの不具合またはバグを追跡します。バグは、割当て、マイルストンへの関連付けおよび追跡(期日、ステータスなどの属性を使用)が可能です。「バグの管理」を参照してください。

- 「フィードバック」。アプリケーション・ユーザーからリアルタイムのコメント、拡張リクエストおよびバグを収集します。「フィードバックの管理」を参照してください。

ニュースについて

「ニュース」リージョンを使用して、他の開発者とやりとりします。ニュースを追加したり、他のワークスペース・ユーザーがポストしたニュース・エントリを表示することができます。ニュースは、Application Expressのホームページ、チーム開発のホームページおよびニュース・ページに表示されます。「ニュース・エントリの管理」を参照してください。

チーム・アクションについて

「チーム・アクション」リストはページの右側に表示されます。

図team_actions.gifの説明

「チーム・アクション」リストには、次のリンクが含まれています。

- 「リンクの管理」。「リンクの管理」を参照してください。

- 「ニュースの管理」。「ニュース・エントリの管理」を参照してください。

- 「チーム開発の設定」。「チーム開発の設定の管理」を参照してください。

- 「リリース・サマリー」。「リリース・サマリーの表示」を参照してください。

- 「ユーティリティ」。「ユーティリティについて」を参照してください。

- 「フォーカス領域の管理」。「フォーカス領域の編集」を参照してください。

- 「ファイルの表示」。「機能、To Doおよびバグに添付されたファイルの表示」を参照してください。

ヒント:
「チーム・アクション」リストの最後のアイテムは、管理者がファイル・アップロード機能を有効にしているかどうかに応じて、「ファイルの表示」と「ファイルの有効化」で切り替わります。「ファイルの有効化」が表示されている場合は、管理者がファイル・アップロード機能を有効にしていません。

チーム開発のサマリーについて

チーム開発のホームページの下部には、次のサマリーが表示されます。

- 「ダッシュボード」。最終リリースのマイルストンの前の日数、完了した機能、完了したTo Doおよびクローズ済バグのサマリーが表示されます。

- 「フィードバック」。「フィードバックの管理」を参照してください。

- 「タグ」。「タグ・サマリーの使用」を参照してください。

機能の追跡

機能ページを使用して、機能が最初に構想されてから実装されるまでを追跡します。機能は、リリース、割当て先、タグまたは関連付けられたマイルストン別に編成できます。

内容は次のとおりです。

- 機能の表示

- 機能の作成

- 機能の更新

- 機能へのファイルの添付について

- 機能レポートの表示

機能の表示

機能を表示するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「チーム開発」アイコンをクリックします。

2. 「機能」アイコンをクリックします。
機能ダッシュボードが表示されます。

機能ダッシュボードには、選択した割当て先、リリースまたはアプリケーションについて、ワークスペース内で定義されている機能の概要が表示されます。ハイパーリンクをクリックすると、選択した機能、所有者、コントリビュータなどに詳細が表示されます。詳細は、「機能ダッシュボードについて」を参照してください。

3. 「機能」タブをクリックします。「機能ページについて」を参照してください。

機能ページについて

機能ページには、各機能の詳細が表示される対話モード・レポートが表示されます。ページの上部にある検索バーを使用して、ページの外観をさらにカスタマイズできます。検索バーで使用可能なコントロールは次のとおりです。

- 検索列の選択: このアイコンは、虫めがねに似ています。このアイコンをクリックして、検索を特定の列のみに絞ります。すべての列を検索するには、「すべての列」を選択します。

- テキスト領域: 大/小文字を区別しない検索基準(ワイルドカード文字は暗黙的に定義される)を入力し、「実行」をクリックします。

- 「実行」ボタン: 検索を実行したり、フィルタを適用します。

- レポートの表示: 各機能をレポート内の1行として表示します。「アクション」メニューを使用して、このレポートをカスタマイズします。

- 詳細の表示: 各機能の詳細情報が表示されます。表示される情報量を減らすには、「基本」をクリックします。

- 「アクション」メニュー: このメニューを使用すると、レポート・ビューをカスタマイズできます。「「アクション」メニューについて」を参照してください。

機能の作成

機能を作成するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「チーム開発」アイコンをクリックします。

2. 「機能」アイコンをクリックします。
機能ダッシュボードが表示されます。

3. 「機能の作成」をクリックします。

4. 該当するフィールドに入力します。必須フィールドには、赤いアスタリスク(*)が付いています。

5. 特定のフィールドの詳細は、アイテムのヘルプを参照してください。「フィールドレベル・ヘルプについて」を参照してください。

6. 編集可能な選択リストに新しい値を追加するには、「新規」というタイトルが付いたフィールドに値を入力します。たとえば、「機能所有者」リストに名前を追加するには、「新規機能所有者」に値を入力します。
入力した値が追加されます。

7. 「機能の作成」をクリックします。

関連項目:
「フォーカス領域の編集」

親機能の作成

親機能属性を使用すると、階層的に機能をグループ化できます。親機能を選択すると、親/子関係が作成されます。ツリー・ビューで機能を表示すると、機能は、まずリリースごとにグループ化され、次に、親ごとにグループ化されます。詳細は、「ツリーについて」を参照してください。

機能の更新

機能を更新するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「チーム開発」アイコンをクリックします。

2. 「機能」アイコンをクリックします。
機能ダッシュボードが表示されます。

3. 「機能」タブをクリックします。
機能ページが表示されます。

4. 機能の説明の編集方法は、検索バーで選択したビューによって異なります。オプションは次のとおりです。

- 詳細の表示: 機能番号をクリックします。

- レポートの表示: 「編集」アイコンをクリックします。

5. 該当するフィールドを編集します。

6. 編集可能な選択リストに新しい値を追加するには、「新規」というタイトルが付いたフィールド(たとえば、「新規所有者」)に値を入力します。
たとえば、「機能所有者」リストに名前を追加するには、「新規所有者」に値を入力します。

入力した値が追加されます。

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

関連項目:
「フォーカス領域の編集」

機能へのファイルの添付について

ワークスペース・レベルで有効にした場合、機能にファイルを添付できます。詳細は、『Oracle Application Express管理ガイド』で、チーム開発での添付ファイルに対するサポートの有効化に関する説明を参照してください。

内容は次のとおりです。

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

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

関連項目:
「機能、To Doおよびバグへの添付ファイルの表示」

機能へのファイルの添付

機能にファイルを添付するには、次のステップを実行します。

1. 機能ページにナビゲートします。「機能の更新」を参照してください。

2. 「アクション」から、「ファイルの追加」をクリックします。

3. 「ファイルの追加」で、次の項目を指定します。

1. ファイル: アップロードするファイルを探します。

2. 説明: ファイルの説明を入力します。

3. 「ファイルの追加」をクリックします。

「ファイル」という新しいリージョンが、機能ページの下部に表示されます。

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

添付したファイルを表示、編集または削除するには、次のステップを実行します。

1. 「機能」ページへナビゲートします。「機能の更新」を参照してください。

2. 「ファイル」までスクロールします。

3. 「ファイルの表示および管理」をクリックします。
「ファイル」ページが表示されます。

4. ファイルを表示するには、名前をクリックします。

5. ファイルの説明を編集するには、「編集」アイコンをクリックします。

6. 添付ファイルを削除するには、「削除」アイコンをクリックします。

機能レポートの表示

機能レポートを使用して、機能を様々な観点から表示します。

内容は次のとおりです。

- 機能ダッシュボードについて

- ツリーについて

- カレンダについて

- 履歴について

- 進捗ログについて

- フォーカス領域について

- 所有者について

- ユーティリティについて

関連項目:
「機能ユーティリティについて」

機能ダッシュボードについて

機能ダッシュボードには、選択した割当て先、リリースまたはアプリケーションについて、ワークスペース内で定義されている機能の概要が表示されます。ハイパーリンクをクリックすると、選択した機能、所有者、コントリビュータなどに詳細が表示されます。ダッシュボード・ページには、次のリージョンがあります。

- 完了率

- 開発の進捗

- 所有者

- 新機能

ダッシュボードを編集するには、次のステップを実行します。

1. ページ上部の次のフィールドを編集し、「設定」をクリックします。

- 割当て先

- リリース

- アプリケーション

2. ダッシュボードをデフォルト表示にリセットするには、「リセット」ボタンをクリックします。

ツリーについて

ツリー・ページには、リリースごとの階層ツリーで機能が表示されます。新しいリリースを選択するには、「リリース」リストから選択します。機能の数と完了率が、機能名の右側に表示されます。完了率を表示または非表示にするには、「完了率を含む」で「はい」または「いいえ」を選択し、「設定」をクリックします。機能を編集するには、機能をクリックします。

図td_tree.gifの説明

機能は、まずリリースごとにグループ化され、次に、親ごとにグループ化されます。グループ化を開くには、機能名の左側にある小さな三角形をクリックします。

図td_tree_expand.gifの説明

ヒント:
指定のリリースごとに機能を表示する場合、異なるリリースに親または子機能を持つ機能は表示されません。

すべてのグループ化を開閉するには、「すべて開く」および「すべて閉じる」ボタンをクリックします。機能を表示または編集するには、機能名をクリックします。機能ページが表示されます。機能を作成するには、「機能の作成」をクリックし、オンラインの指示に従います。

関連項目:
「機能の作成」

カレンダについて

カレンダ・ページには、機能がカレンダ形式で期日別または完了日別に表示されます。「前へ」および「次へ」ボタンをクリックして、他の月を表示します。当日の機能マイルストンを表示するには、「今日」をクリックします。特定の機能を表示するには、機能名をクリックします。機能を作成するには、「機能の作成」をクリックし、オンラインの指示に従います。

関連項目:
「機能の作成」

親機能が定義されている場合、カレンダ形式で期日または完了日が表示されます。「前へ」および「次へ」ボタンをクリックして、他の月を表示します。当日の機能マイルストンを表示するには、「今日」をクリックします。特定の機能を表示するには、機能名をクリックします。機能を作成するには、「機能の作成」をクリックし、オンラインの指示に従います。

履歴について

古い値と新しい値、更新者など、最近変更された機能のレポートが表示されます。特定の機能を表示するには、機能名をクリックします。

変更履歴ページは、対話モード・レポートとして表示されます。レポートをカスタマイズするには、ページ上部にある検索バーを使用します。詳細は、「対話モード・レポートのカスタマイズ」を参照してください。

進捗ログについて

進捗ログ・エントリのレポートが表示されます。進捗ログには、すべての機能のすべての進捗エントリが表示されます。リリースごとにログ・エントリを表示するには、リリース選択リストから選択し、「設定」をクリックします。ログを編集するには、「編集」アイコンをクリックします。

進捗ログ・ページは、対話モード・レポートとして表示されます。レポートをカスタマイズするには、ページ上部にある検索バーを使用します。

フォーカス領域について

リリース別に定義されたフォーカス領域ごとの機能数のチャートが表示されます。チャートを変更するには、別のリリースまたは別の割当て先を選択し、「設定」をクリックします。デフォルトのチャートに戻すには、「リセット」をクリックします。

所有者について

所有者別の機能数のチャートが表示されます。チャートを変更するには、別のリリース、最小ステータスまたは最大ステータスを選択し、「設定」をクリックします。デフォルトのチャートに戻すには、「リセット」をクリックします。

ユーティリティについて

機能ユーティリティ・ページを使用すると、複数の機能のマイルストンを管理できます。次のいずれかを選択し、画面の指示に従います。

- マイルストンを機能(現在マイルストンが割り当てられていないもののみ)に割り当てます。

- 機能の期日をマイルストン日付に設定します(機能のみに影響を及ぼす)。

- 期日を超過した機能のマイルストンを変更します。

- オープンな機能の期限をプッシュします。

詳細は、「機能ユーティリティについて」を参照してください。

マイルストンの追跡

マイルストン・ページを使用して、重要なマイルストンを管理します。マイルストンによってイベントを追跡します。マイルストンは、機能、バグおよびTo Doに関連付けることができます。

内容は次のとおりです。

- マイルストンの表示

- マイルストンの作成

- マイルストンの更新

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

マイルストンの表示

マイルストンを表示するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「チーム開発」アイコンをクリックします。

2. 「マイルストン」アイコンをクリックします。
マイルストン・ダッシュボードが表示されます。

マイルストン・ダッシュボードには、ワークスペース内のマイルストンの概要が表示されます。リリースでフィルタ処理したり、リンクから特定の1つまたは複数のマイルストンを所有者ごとに表示することができます。「マイルストン・ダッシュボードについて」を参照してください。

3. 「マイルストン」タブをクリックします。
マイルストン・ページが表示されます。「マイルストン・ページについて」を参照してください。

マイルストン・ページについて

マイルストン・ページは、レポートとして表示されます。ページの上部にある検索バーを使用して、ページの外観をカスタマイズできます。検索バーで使用可能なコントロールは次のとおりです。

- 「検索」アイコン: 虫めがねに似ています。このアイコンをクリックして、検索を特定の列のみに絞ります。すべての列を検索するには、「すべての列」を選択します。

- テキスト領域: 大/小文字を区別しない検索基準(ワイルドカード文字は暗黙的に定義される)を入力し、「実行」をクリックします。

- 「実行」ボタン: 検索を実行したり、フィルタを適用します。

- アクション・メニュー: アクション・メニューを表示します。このメニューを使用して、レポートをカスタマイズします。「「アクション」メニューについて」を参照してください。

マイルストンの作成

マイルストンを作成するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「チーム開発」アイコンをクリックします。

2. 「マイルストン」アイコンをクリックします。
マイルストン・ダッシュボード・ページが表示され、次のリージョンが表示されます。

- マイルストン・カレンダ

- 最終マイルストンまでの日数

- コンポーネント・カウント

- マイルストン所有者

3. 「マイルストンの作成」をクリックします。

4. 該当するフィールドに入力します。必須フィールドには、赤いアスタリスク(*)が付いています。

5. 特定のフィールドの詳細は、アイテムのヘルプを参照してください。「フィールドレベル・ヘルプについて」を参照してください。

6. 編集可能な選択リストに新しい値を追加するには、「新規」というタイトルが付いたフィールドに値を入力します。たとえば、「所有者」リストに名前を追加するには、「新規所有者」に値を入力します。
入力した値が追加されます。

7. 「マイルストンの作成」をクリックします。

マイルストンの更新

マイルストンを更新するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「チーム開発」アイコンをクリックします。

2. 「マイルストン」アイコンをクリックします。

3. 「マイルストン」タブをクリックします。
マイルストン・ページが表示されます。

4. 説明の左側にある「編集」アイコンをクリックします。

5. 該当するフィールドを編集します。

6. 特定のフィールドの詳細を表示するには、アイテム・ラベルをクリックします。「フィールドレベル・ヘルプについて」を参照してください。

7. 編集可能な選択リストに新しい値を追加するには、「新規」というタイトルが付いたフィールドに値を入力します。たとえば、「所有者」リストに名前を追加するには、「新規所有者」に値を入力します。
入力した値が追加されます。

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

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

マイルストン・レポートを使用して、マイルストンを様々な観点から表示します。

内容は次のとおりです。

- マイルストン・ダッシュボードについて

- カレンダ・ビューについて

- 所有者別

- マイルストン別の機能について

関連項目:
「機能ユーティリティについて」

マイルストン・ダッシュボードについて

マイルストン・ダッシュボードには、ワークスペース内のマイルストンの概要が表示されます。リリースでフィルタ処理するには、「リリース」リストから選択します。特定のマイルストンを表示するには、マイルストン・ハイパーリンクまたはマイルストン所有者をクリックします。

マイルストン・ダッシュボード・ページが表示され、次のリージョンが表示されます。

- マイルストン・カレンダ

- 最終マイルストンまでの日数

- コンポーネント・カウント

- マイルストン所有者

ダッシュボードを編集するには、次のステップを実行します。

1. ページの上部にある次の「表示」および「リリース」リストを編集し、「設定」をクリックします。

2. ダッシュボードをデフォルト表示にリセットするには、「リセット」ボタンをクリックします。

カレンダ・ビューについて

カレンダ・ページには、マイルストンがカレンダ形式で日付別に表示されます。リリースでフィルタ処理するには、「リリース」リストから選択します。「前へ」および「次へ」ボタンをクリックして、他の月を表示します。当日のマイルストンを表示するには、「今日」をクリックします。特定のマイルストンを表示するには、ハイパーリンクをクリックします。マイルストンを作成するには、「マイルストンの作成」をクリックしてオンラインの指示に従ってください。

所有者別

所有者別ページでは、マイルストンを選択し、それに関連付けられているチーム開発オブジェクト(たとえば、所有者別の機能、機能メトリック、マイルストンの例外など)を表示できます。特定の所有者に関連付けられているマイルストンを表示するには、円グラフの該当するセクションをクリックします。マイルストンを所有者別に示したレポートが表示されます。

チャートを変更するには、別のリリースまたはマイルストンを選択し、「設定」をクリックします。デフォルトのチャートに戻すには、「リセット」をクリックします。

マイルストン別の機能について

「マイルストン別の機能」には、各マイルストンに関連付けられている機能のレポートが表示されます。このレポートは、進捗追跡に役立ちます。レポートを編集するには、別のリリースを選択し、「設定」をクリックします。デフォルト・レポートに戻るには、「リセット」をクリックします。

To Doの追跡

To Doとは、割当て、優先度付け、タグ付けおよび追跡が可能なアクション・アイテムです。また、To Doに親タスクを関連付けることもできます。機能またはマイルストンに関連付けることもできますが、それは必須ではありません。

内容は次のとおりです。

- To Doの表示

- To Doページについて

- To Doの作成

- To Doの更新

- To Doへのファイルの添付について

- To Doレポートの表示

To Doの表示

To Doを表示するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「チーム開発」アイコンをクリックします。

2. 「To Do」アイコンをクリックします。
To Doダッシュボードが表示されます。To Doダッシュボードには、ワークスペース内のTo Doの概要が表示されます。リリース、割当て先またはアプリケーションでフィルタ処理できます。「To Doダッシュボードについて」を参照してください。

3. 「To Do」タブをクリックします。
To Doページが表示されます。

To Doページについて

To Doページには、各タスクの詳細が表示されます。パーソナルTo Doを表示するには、ページの上部にある「To Do」ボタンをクリックします。ページの上部にある検索バーを使用して、ページの外観をカスタマイズできます。検索バーで使用可能なコントロールは次のとおりです。

- 検索: 虫めがねに似ています。このアイコンをクリックして、検索を特定の列に絞り込みます。すべての列を検索するには、「すべての列」を選択します。

- テキスト領域: 大/小文字を区別しない検索基準(ワイルドカード文字は暗黙的に定義される)を入力し、「実行」をクリックします。

- 「実行」ボタン: 検索を実行したり、フィルタを適用します。

- レポートの表示: 各アイテムをレポート内の1行として表示します。「アクション」メニューを使用して、このレポートをカスタマイズします。

- 詳細の表示: 各アイテムの詳細情報が表示されます。表示される情報量を減らすには、「基本」をクリックします。

- 「アクション」メニュー: このメニューを使用すると、レポート・ビューをカスタマイズできます。「「アクション」メニューについて」を参照してください。

To Doの作成

To Doを作成するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「チーム開発」アイコンをクリックします。

2. 「To Do」アイコンをクリックします。
To Doダッシュボードが表示されます。

3. 「To Doの作成」をクリックします。

4. 該当するフィールドに入力します。必須フィールドには、赤いアスタリスク(*)が付いています。

5. 特定のフィールドの詳細は、アイテムのヘルプを参照してください。「フィールドレベル・ヘルプについて」を参照してください。

6. 編集可能な選択リストに新しい値を追加するには、「新規」というタイトルが付いたフィールドに値を入力します。たとえば、「割当て先」リストに名前を追加するには、「新規割当て先」に値を入力します。
入力した値が追加されます。

7. 「To Doの作成」をクリックします。

To Doの更新

To Doを更新するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「チーム開発」アイコンをクリックします。

2. 「To Do」アイコンをクリックします。
To Doダッシュボードが表示されます。

3. 「To Do」タブをクリックします。

4. To Doの編集方法は、検索バーで選択したビューによって異なります。オプションは次のとおりです。

- 詳細の表示: To Do番号をクリックします。

- レポートの表示: To Do番号をクリックするか、「編集」アイコンをクリックします。

5. 該当するフィールドを編集します。

6. 編集可能な選択リストに新しい値を追加するには、「新規」というタイトルが付いたフィールドに値を入力します。たとえば、「割当て先」リストに名前を追加するには、「新規割当て先」に値を入力します。
入力した値が追加されます。

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

To Doへのファイルの添付について

ワークスペースレベルで有効にすると、To Doにファイルを添付できます。詳細は、『Oracle Application Express管理ガイド』の「チーム開発でのファイル添付のサポートの有効化」を参照してください。

内容は次のとおりです。

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

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

関連項目:
「機能、To Doおよびバグへの添付ファイルの表示」

To Doへのファイルの添付

To Doにファイルを添付するには、次のステップを実行します。

1. 「To Do」ページにナビゲートします。「To Doの更新」を参照してください。

2. 「アクション」から、「ファイルの追加」をクリックします。

3. 「ファイルの追加」で、次の項目を指定します。

1. ファイル: アップロードするファイルを探します。

2. 説明: ファイルの説明を入力します。

3. 「ファイルの追加」をクリックします。

「ファイル」という新しいリージョンがページの下部に表示されます。

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

添付ファイルを管理するには、次の手順を実行します。

1. 「To Do」ページにナビゲートします。「To Doの更新」を参照してください。

2. 「ファイル」までスクロールします。

3. 「ファイルの表示および管理」をクリックします。
「ファイル」ページが表示されます。

4. ファイルを表示するには、名前をクリックします。

5. ファイルの説明を編集するには、「編集」アイコンをクリックします。

6. 添付ファイルを削除するには、「削除」アイコンをクリックします。

To Doレポートの表示

To Doレポートを使用して、To Doを様々な観点から表示します。

内容は次のとおりです。

- To Doダッシュボードについて

- カレンダ・ビューについて

- 進捗ログについて

To Doダッシュボードについて

「To Do」ダッシュボードには、ワークスペース内のTo Doの概要が表示されます。リリース、割当て先またはアプリケーションでフィルタ処理できます。ページは、次のセクションに分かれています。

- 開発者の完了率
特定の所有者に関連付けられているTo Doを表示するには、割当て先の名前をクリックします。

- オープンTo Do

ダッシュボードを編集するには、次のステップを実行します。

1. ページ上部の次のフィールドを編集し、「設定」をクリックします。

- 表示

- リリース

- 割当て先

- アプリケーション

2. ダッシュボードをデフォルト表示にリセットするには、「リセット」ボタンをクリックします。

カレンダ・ビューについて

カレンダ・ページには、To Doがカレンダ形式で期日別または完了日別に表示されます。完了ステータスまたはリリースで表示をフィルタするには、「表示」および「リリース」選択リストから選択して「設定」をクリックします。「前へ」および「次へ」ボタンをクリックして、他の月を表示します。当日のTo Doを表示するには、「今日」をクリックします。特定のTo Doを表示するには、To Do名をクリックします。To Doを作成するには、「To Doの作成」をクリックしてオンラインの指示に従ってください。

進捗ログについて

進捗ログ・エントリのレポートが表示されます。進捗ログには、すべてのTo Doのすべての進捗エントリが表示されます。ログを編集するには、「編集」アイコンをクリックします。

進捗ログ・ページは、対話モード・レポートとして表示されます。レポートをカスタマイズするには、ページ上部にある検索バーを使用します。

バグの管理

バグは、ソフトウェアの不具合も追跡するものです。バグは、割当て、マイルストンへの関連付けおよび追跡(期日、ステータスなどの属性を使用)が可能です。

内容は次のとおりです。

- バグの表示

- バグ・ページについて

- バグの作成

- バグの編集

- バグへのファイルの添付について

- バグ・レポートの表示

バグの表示

バグを表示するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「チーム開発」アイコンをクリックします。

2. 「バグ」アイコンをクリックします。
バグ・ダッシュボードが表示されます。バグ・ダッシュボードには、ソフトウェアの既知の不具合の概要が表示されます。「バグ・ダッシュボードについて」を参照してください。

3. 「バグ」タブをクリックします。
バグ・ページが表示されます。「バグ・ページについて」を参照してください。

バグ・ページについて

バグ・ページには、各バグの詳細が表示されます。ページの上部にある検索バーを使用して、ページの外観をさらにカスタマイズできます。検索バーで使用可能なコントロールは次のとおりです。

- 「検索」アイコン: 虫めがねに似ています。このアイコンをクリックして、検索を特定の列のみに絞ります。すべての列を検索するには、「すべての列」を選択します。

- テキスト領域: 大/小文字を区別しない検索基準(ワイルドカード文字は暗黙的に定義される)を入力し、「実行」をクリックします。

- 「実行」ボタン: 検索を実行したり、フィルタを適用します。

- レポートの表示: 各バグをレポート内の1行として表示します。「アクション」メニューを使用して、このレポートをカスタマイズします。

- 詳細の表示: 各バグの詳細情報が表示されます。表示される情報量を減らすには、「基本」をクリックします。

- 「アクション」メニュー: このメニューを使用すると、レポート・ビューをカスタマイズできます。「「アクション」メニューについて」を参照してください。

バグの作成

バグを作成するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「チーム開発」アイコンをクリックします。

2. 「バグ」アイコンをクリックします。
バグ・ダッシュボードが表示されます。

3. 「バグの作成」をクリックします。

4. 該当するフィールドに入力します。必須フィールドには、赤いアスタリスク(*)が付いています。

5. 特定のフィールドの詳細は、アイテムのヘルプを参照してください。「フィールドレベル・ヘルプについて」を参照してください。

6. 編集可能な選択リストに新しい値を追加するには、「新規」というタイトルが付いたフィールドに値を入力します。たとえば、「割当て先」リストに名前を追加するには、「新規割当て先」に値を入力します。
入力した値が追加されます。

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

バグの編集

バグを編集するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「チーム開発」アイコンをクリックします。

2. 「バグ」アイコンをクリックします。
バグ・ダッシュボードが表示されます。

3. 「バグ」タブをクリックします。
バグ・ページが表示されます。

4. バグの編集方法は、検索バーで選択したビューによって異なります。オプションは次のとおりです。

- 詳細の表示: バグ番号をクリックするか、「編集」アイコンをクリックします。

- レポートの表示: 「編集」アイコンをクリックします。

5. 該当するフィールドを編集します。

6. 編集可能な選択リストに新しい値を追加するには、「新規」というタイトルが付いたフィールドに値を入力します。たとえば、「割当て先」リストに名前を追加するには、「新規割当て先」に値を入力します。
入力した値が追加されます。

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

バグへのファイルの添付について

ワークスペース・レベルで有効にした場合、To Doにファイルを添付できます。詳細は、『Oracle Application Express管理ガイド』の「チーム開発でのファイル添付のサポートの有効化」を参照してください。

内容は次のとおりです。

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

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

関連項目:
「機能、To Doおよびバグに添付されたファイルの表示」

バグへのファイルの添付

バグにファイルを添付するには、次のステップを実行します。

1. To Doページにナビゲートします。「バグの編集」を参照してください。

2. 「アクション」で「ファイルの追加」をクリックします。

3. 「ファイルの追加」で、次の項目を指定します。

1. ファイル: アップロードするファイルを探します。

2. 説明: ファイルの説明を入力します。

3. 「ファイルの追加」をクリックします。

「ファイル」という新しいリージョンが、ページの下部に表示されます。

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

添付したファイルを管理するには、次のステップを実行します。

1. バグ・ページにナビゲートします。「バグの編集」を参照してください。

2. 「ファイル」までスクロールします。

3. 「ファイルの表示および管理」をクリックします。
ファイル・ページが表示されます。

4. ファイルを表示するには、名前をクリックします。

5. ファイルの説明を編集するには、「編集」アイコンをクリックします。

6. 添付したファイルを削除するには、「削除」アイコンをクリックします。

バグ・レポートの表示

バグ・レポートを使用して、バグを様々な観点から表示します。

内容は次のとおりです。

- バグ・ダッシュボードについて

- カレンダについて

- 開発者別について

- 日別について

バグ・ダッシュボードについて

バグ・ダッシュボードには、ソフトウェアの既知の不具合の概要が表示されます。ダッシュボード・ページには、次のリージョンがあります。

- クローズ率

- 割り当てられた開発者

- 重大度

- ステータス

ダッシュボードを編集するには、次のステップを実行します。

1. ページ上部の次のフィールドを編集し、「設定」をクリックします。

- 表示

- リリース

2. ダッシュボードをデフォルト表示にリセットするには、「リセット」ボタンをクリックします。

カレンダについて

カレンダ・ページの「表示」リストを使用して、推定クローズ日付のあるオープン・バグ、推定クローズ日付のないオープン・バグ、またはクローズ・バグを表示します。「前へ」および「次へ」ボタンをクリックして、他の月を表示します。特定のバグを表示するには、バグの説明をクリックします。新しいバグを作成するには、「バグの作成」をクリックします。

開発者別について

開発者別ページには、バグが開発者別に表示されます。特定の割当て先に関連付けられているバグを表示するには、チャートの該当するセクションをクリックします。バグを開発者別に示したレポートが表示されます。

チャートを変更するには、別のリリースを選択し、「設定」をクリックします。デフォルトのチャートに戻すには、「リセット」をクリックします。新しいバグを作成するには、「バグの作成」をクリックします。

日別について

日別ページには、オープン・バグおよびクローズ・バグの数が日別に表示されます。チャートを変更するには、別のリリースを選択し、「設定」をクリックします。デフォルトの棒グラフに戻すには、「リセット」をクリックします。新しいバグを作成するには、「バグの作成」をクリックします。

フィードバックの管理

フィードバックは、アプリケーション・ユーザーからリアルタイム・コメント、拡張リクエストおよびバグを収集するプロセスです。アプリケーションにフィードバック・ページを追加するには、フィードバック・ページを追加します。

内容は次のとおりです。

- フィードバックの表示

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

- フィードバックの確認

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

フィードバックの表示

フィードバックを表示するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「チーム開発」アイコンをクリックします。

2. 「フィードバック」アイコンをクリックします。
フィードバック・ダッシュボードが表示されます。詳細は、「フィードバック・ダッシュボードについて」を参照してください。

3. 「フィードバック」タブをクリックします。
フィードバック・ページが表示されます。

フィードバック・ページについて

フィードバック・ページには、フィードバック・エントリの詳細が表示されます。ページの上部にある検索バーを使用して、ページの外観をさらにカスタマイズできます。検索バーで使用可能なコントロールは次のとおりです。

- 「検索」アイコン: 虫めがねに似ています。このアイコンをクリックして、検索を特定の列のみに絞ります。すべての列を検索するには、「すべての列」を選択します。

- テキスト領域: 大/小文字を区別しない検索基準(ワイルドカード文字は暗黙的に定義される)を入力し、「実行」をクリックします。

- 「実行」ボタン: 検索を実行したり、フィルタを適用します。

- レポートの表示: 各アイテムをレポート内の1行として表示します。「アクション」メニューを使用して、このレポートをカスタマイズします。

- 詳細の表示: 各アイテムの詳細情報が表示されます。表示される情報量を減らすには、「基本」をクリックします。

- 「アクション」メニュー: このメニューを使用すると、レポート・ビューをカスタマイズできます。「「アクション」メニューについて」を参照してください。

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

チーム開発のフィードバック・モジュールを使用するには、ターゲット・アプリケーションにフィードバック・ページを追加する必要があります。

内容は次のとおりです。

- フィードバック・ページの作成

- フィードバック・ページの使用

フィードバック・ページの作成

アプリケーションにフィードバック・ページを追加するには、次のステップを実行します。

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

2. フィードバックが必要なアプリケーションを選択します。
「アプリケーション」ホームページが表示されます。

3. 「ページの作成」ボタンをクリックします。

4. 「ページ・タイプ」で、「フィードバック・ページ」を選択します。

5. 「ページの作成」で、設定をカスタマイズします。

6. 「ナビゲーション・バー」で、ナビゲーション・バー・エントリを作成するかどうかを指定します。「はい」を選択した場合、エントリ・ラベルを入力します。

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

フィードバック・ページの使用

フィードバックを送信するには、次のステップを実行します。

1. フィードバック送信の対象となっているアプリケーションを実行します。

2. 「フィードバック」リンクをクリックします。
フィードバック・ウィンドウが表示されます。

3. 「フィードバック」にコメントを入力します。
アプリケーションとページに言及し、開発者がこの情報を参照することに注意してください。

4. 「フィードバック・タイプ」から、「一般的なコメント」、「拡張リクエスト」または「バグ」を選択します。

5. 「フィードバックの送信」をクリックします。

フィードバックの確認

フィードバックを確認するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「チーム開発」アイコンをクリックします。

2. 「フィードバック」アイコンをクリックします。
ダッシュボードが表示されます。

3. 「フィードバック」タブをクリックします。

4. 特定のフィードバックにアクセスする方法は、次のビューによって異なります。

- 詳細の表示: フィードバックIDをクリックします。

- レポートの表示: 「編集」アイコンをクリックします。

フィードバック・エントリがページの上部に表示されます。

5. 「配置」で、次の操作を実行します。

1. ステータス: 新しいステータスを選択します。

2. タグは、対象のフィードバックをさらに詳しく説明するキーワードです。複数のタグを付ける場合は、カンマで区切ります。

3. 開発者のコメント: 追加のコメントを入力します。

4. パブリック・レスポンス: パブリック・レスポンスを入力します。

6. バグ、To Doまたは機能を作成するには、次のボタンを選択します。

1. 「バグとしてログイン」。適切な情報を入力し、「バグの作成」をクリックします。

2. 「To Doとしてログイン」。適切な情報を入力し、「To Doの作成」をクリックします。

3. 「機能としてログイン」。適切な情報を入力し、「機能としてログイン」をクリックします。

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

フィードバック・レポートの表示

フィードバック・レポートを使用して、フィードバックを様々な観点から表示します。

内容は次のとおりです。

- フィードバック・ダッシュボードについて

- カレンダについて

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

- ファイリング・ユーザー別について

フィードバック・ダッシュボードについて

フィードバック・ダッシュボードには、次のリージョンがあります。

- クローズ率

- 個別のファイラ

- 更新後のステータス

- トップ・フィードバック・ファイラ

- サマリー

コンテンツをリフレッシュするには、「リフレッシュ」ボタンをクリックします。

カレンダについて

カレンダ・ページには、アプリケーションからのフィードバック・コメントの数が日別に表示されます。「前へ」および「次へ」ボタンをクリックして、他の月を表示します。

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

アプリケーション別ページには、アプリケーション別のフィードバックのチャートが表示されます。チャートのセクションをクリックして、詳細なレポートを表示します。

ファイリング・ユーザー別について

ファイリング・ユーザー別ページには、ファイリング・ユーザー別のオープン・フィードバックのチャートが表示されます。チャートのセクションをクリックして、詳細なレポートを表示します。

タグ・サマリーの使用

チーム開発のホームページにあるタグ・サマリーには、すべてのチーム開発コンポーネントに関連付けられているすべてのタグの重み付けリストが表示されます。ハイパーリンクをクリックすると、選択したタグが付いたすべてのコンポーネントを示す検索ページが表示されます。タグ・クラウド・サマリーを使用して、チーム開発コンポーネントを効果的に管理できます。

このサマリーに情報を移入するには、各チーム開発コンポーネント(つまり、機能、To Doタスク、バグおよびフィードバック・エントリ)の「タグ」フィールドを編集します。

チーム・アクションの管理

「チーム・アクション」リストはチーム開発のホームページの右側に表示されます。

図team_actions.gifの説明

内容は次のとおりです。

- リンクの管理

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

- チーム開発の設定の管理

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

- ユーティリティについて

- フォーカス領域の編集

- 機能、To Doおよびバグに添付されたファイルの表示

ヒント:
「チーム・アクション」リストの最後のアイテムは、管理者がファイル・アップロード機能を有効にしたかどうかによって、「ファイルの表示」と「ファイルの有効化」を切り替えます。「ファイルの有効化」と表示された場合は、管理者によってファイル・アップロード機能がまだ有効化されていません。

リンクの管理

リンク・ページを使用して、チーム開発内のリンクを共有します。

内容は次のとおりです。

- リンク・ページへのアクセス

- リンクの追加

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

リンク・ページへのアクセス

リンク・ページにアクセスするには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「チーム開発」アイコンをクリックします。

2. 「チーム・アクション」リストで、「リンクの管理」をクリックします。
リンク・ページが表示されます。

3. 検索バーを使用して、表示をフィルタ処理します。
検索バーで使用可能なコントロールは次のとおりです。

- 「検索」アイコン: 虫めがねに似ています。このアイコンをクリックして、検索を特定の列のみに絞ります。すべての列を検索するには、「すべての列」を選択します。

- テキスト領域: 大/小文字を区別しない検索基準(ワイルドカード文字は暗黙的に定義される)を入力し、「実行」をクリックします。

- 「実行」ボタン: 検索を実行したり、フィルタを適用します。

- アクション・メニュー: アクション・メニューを表示します。このメニューを使用して、対話モード・レポートをカスタマイズします。「「アクション」メニューについて」を参照してください。

リンクの追加

リンクを追加するには、次のようにします。

1. 「ワークスペース」ホームページで、「チーム開発」アイコンをクリックします。

2. 「チーム・アクション」リストで、「リンクの管理」をクリックします。
リンク・ページが表示されます。

3. 「リンクの作成」をクリックします。
リンク・ページが表示されます。

4. 該当するフィールドに入力します。必須フィールドには、赤いアスタリスク(*)が付いています。

5. 特定のフィールドの詳細は、アイテムのヘルプを参照してください。「フィールドレベル・ヘルプについて」を参照してください。

6. 「リンクの作成」をクリックします。

リンクの編集または削除

リンクを編集または削除するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「チーム開発」アイコンをクリックします。

2. 「チーム・アクション」リストで、「リンクの管理」をクリックします。
リンク・ページが表示されます。

3. リンクを編集する手順は、次のとおりです。

1. 「編集」アイコンをクリックします。
リンク・ページが表示されます。

2. 該当するフィールドを編集します。

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

4. 新しいリンクを削除する手順は、次のとおりです。

1. 「編集」アイコンをクリックします。
リンク・ページが表示されます。

2. 「削除」をクリックします。

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

team_dev_news.gifの説明

「ニュース」リージョンを使用して、他の開発者とやりとりします。ニュース・エントリを追加したり、他のワークスペース・ユーザーがポストしたニュース・エントリを表示することができます。ニュースは、Application Expressのホームページ、チーム開発のホームページおよびニュース・ページに表示されます。

内容は次のとおりです。

- ニュース・ページへのアクセス

- ニュース・エントリの追加

- ニュースの編集または削除

ニュース・ページへのアクセス

ニュース・ページにアクセスするには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「チーム開発」アイコンをクリックします。

2. 「チーム・アクション」リストで、「ニュースの管理」をクリックします。
ニュース・ページが表示されます。

3. 検索バーを使用して、表示をフィルタ処理します。使用可能なコントロールは次のとおりです。

- 「検索」アイコン: 虫めがねに似ています。このアイコンをクリックして、検索を特定の列のみに絞ります。すべての列を検索するには、「すべての列」を選択します。

- テキスト領域: 大/小文字を区別しない検索基準(ワイルドカード文字は暗黙的に定義される)を入力し、「実行」をクリックします。

- 「実行」ボタン: 検索を実行したり、フィルタを適用します。

- レポートの表示: 各エントリをレポート内の1行として表示します。

- 詳細の表示: 各ニュース・エントリの詳細情報が表示されます。

- アクション・メニュー: アクション・メニューを表示します。このメニューを使用して、対話モード・レポートをカスタマイズします。「「アクション」メニューについて」を参照してください。

ニュース・エントリの追加

ニュース・エントリを追加するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「チーム開発」アイコンをクリックします。

2. 「チーム・アクション」リストで、「ニュースの管理」をクリックします。
ニュース・ページが表示されます。

3. ニュースを追加するには、次のステップを実行します。

1. 「ニュースの追加」をクリックします。
ニュース・ページが表示されます。

2. 「ニュース・エントリ」フィールドにテキストを入力します。

3. 「ニュースの追加」をクリックします。

ニュースの編集または削除

ニュースを編集または削除するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「チーム開発」アイコンをクリックします。

2. 「チーム・アクション」リストで、「ニュースの管理」をクリックします。
ニュース・ページが表示されます。

3. ニュース・アイテムを編集するには、次の操作を実行します。

1. 「編集」アイコンをクリックします。

2. ニュース・アイテムを編集します。

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

4. ニュース・アイテムを削除するには、次の操作を実行します。

1. 「編集」アイコンをクリックします。

2. 「削除」をクリックします。

チーム開発の設定の管理

「チーム開発の設定」を使用すると、To Doとバグの表示方法、デフォルト値(リリース、所有者および優先度)、および現在のワークスペースに対して有効にする追跡属性を指定できます。

チーム開発の設定を編集するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「チーム開発」アイコンをクリックします。

2. 「チーム・アクション」リストで、「チーム開発の設定」をクリックします。
設定ページが表示されます。

3. 対象となる属性を編集します。

4. 特定のフィールドの詳細は、アイテムのヘルプを参照してください。「フィールドレベル・ヘルプについて」を参照してください。

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

ヒント:
設定をデフォルト値に戻すには、「デフォルトにリセット」をクリックします。

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

「リリース・サマリー」レポートを使用すると、機能、To Doおよびバグを整理できます。

「リリース・サマリー」レポートにアクセスするには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「チーム開発」アイコンをクリックします。

2. 「チーム・アクション」リストで、「リリース・サマリー」をクリックします。
リリース・サマリー・ページが表示されます。

3. 検索バーを使用して、ビューを制限します。ビューをフィルタ処理するには、開発者またはリリースを選択し、「設定」をクリックします。

4. レポートを電子メールで送信するには、次の操作を実行します。

1. 「電子メール」をクリックします。
電子メール・レポート・ページが表示されます。

2. 該当するフィールドに入力します。必須フィールドには、赤いアスタリスク(*)が付いています。

3. 特定のフィールドの詳細は、アイテムのヘルプを参照してください。「フィールドレベル・ヘルプについて」を参照してください。

5. 「電子メール」をクリックします。

ヒント:
レポートをデフォルト・ビューに戻すには、「リセット」をクリックします。

ユーティリティについて

チーム開発ユーティリティを使用して、チーム開発データを管理します。

チーム開発ユーティリティにアクセスするには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「チーム開発」アイコンをクリックします。

2. 「チーム・アクション」リストで、「ユーティリティ」をクリックします。

3. オプションは次のとおりです。

- 期限経過したバグのプッシュ: 未完了のバグの推定修正日を延期できます。プッシュが必要なバグのみをフィルタ処理および選択して、任意の日数分延期できます。

- 割当て先の更新: 選択したコンポーネントを現在のユーザーから別のユーザーに再割当てできます。この操作は、すべてのリリースを対象にすることも、選択したリリースのみを対象にすることもできます。未完了のコンポーネントのみが再割当てされます(つまり、ステータスが100%未満か、マイルストン日付が将来の日付のコンポーネント)。

- データの消去: 選択したコンポーネントのすべてのエントリを削除します。このオプションは、新しい開発サイクルを開始するとき、またはテスト用のワークスペースの使用後に役立ちます。

- チーム開発の設定の管理: 「チーム開発の設定の管理」を参照してください。

- 機能ユーティリティ: 「機能ユーティリティについて」を参照してください。

機能ユーティリティについて

機能ユーティリティ・ページを使用すると、複数の機能のマイルストンを一度に管理できます。この機能を使用すると、次の操作を実行できます。

- 機能へのマイルストンの割当て

- マイルストン日付への機能の期日の設定

- 期日を超過した機能のマイルストンの変更

- オープンな機能の期限のプッシュ

機能ユーティリティ・ページにアクセスするには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「チーム開発」アイコンをクリックします。

2. 「チーム・アクション」リストで、「ユーティリティ」をクリックします。

3. ユーティリティ・ページで、「機能ユーティリティ」リンクをクリックします。

4. 機能ユーティリティ・ページで、次のステップを実行します。

1. 次の中から選択します。

- マイルストンを機能(現在マイルストンが割り当てられていないもののみ)に割り当てます。

- 機能の期日をマイルストン日付に設定します(機能のみに影響を及ぼす)。

- 期日を超過した機能のマイルストンを変更します。

- オープンな機能の期限をプッシュします。

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

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

6. 特定のフィールドの詳細は、アイテムのヘルプを参照してください。「フィールドレベル・ヘルプについて」を参照してください。

フォーカス領域の編集

機能を作成または更新するときに、フォーカス領域に割り当てることができます。

既存の機能のフォーカス領域を編集するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「チーム開発」アイコンをクリックします。

2. 「チーム・アクション」リストで、「フォーカス領域の管理」をクリックします。
フォーカス領域の管理ページが表示されます。

3. フォーカス領域を選択し、「編集」アイコンをクリックします。

4. 「変更後」に編集内容を入力します。

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

機能、To Doおよびバグに添付されたファイルの表示

ワークスペース・レベルで有効にした場合、機能、To Doまたはバグにファイルを添付できます。詳細は、『Oracle Application Express管理ガイド』で、チーム開発での添付ファイルに対するサポートの有効化に関する説明を参照してください。

ヒント:
有効にしない場合、管理者は「チーム・アクション」リストの「ファイルの有効化」をクリックして、チーム開発からワークスペース管理の設定ページに直接アクセスできます。

機能、To Doおよびバグに添付されたファイルを表示するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「チーム開発」アイコンをクリックします。

2. 「チーム・アクション」リストで、「ファイルの表示」をクリックします。
「フォーカス領域の管理」ページが表示されます。

3. ファイルを表示するには、名前をクリックします。

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

Webシート・アプリケーションは、テキストをデータと組み合せる対話モードのWebページです。これらのアプリケーションは、ユーザーによって定義される非常に動的なアプリケーションです。Webシート・アプリケーションには、ナビゲーション・コントロール、検索機能や、ファイル、ノート、タグなどの注釈を追加する機能があります。Webシート・アプリケーションは、アクセス制御リストおよびいくつかの組込み認証モデルを使用して保護できます。

Oracle Application Expressに付属のサンプルWebシート・アプリケーションの表示の詳細は、「サンプルWebシート - AnyCo IT部門について」を参照してください。

内容は次のとおりです。

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

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

- ページ・セクションの追加と編集について

- テキスト・セクションについて

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

- データ・グリッドの追加について

- データ・コンテンツの追加と編集について

- データ・レポートの追加について

- データ・セクションについて

- チャート・セクションについて

- PL/SQLセクションについて

- マークアップ構文の理解

- 注釈の管理

- Webシート・アプリケーションの管理

- Webシートの表示

関連項目:
「データベース・アプリケーションとWebシート・アプリケーションの違いの理解」および『Oracle Application Express管理ガイド』のWebシート・データベース・オブジェクトの管理に関する説明

Webシート・アプリケーションの使用について

ここでは、すべてのWebシート・アプリケーションに共通のインタフェース要素について説明します。

内容は次のとおりです。

- Webシート・ページとセクション間のナビゲート

- 言語について

- 「ヘルプ」リンクについて

- 「ビルダー」リンクについて

- 「ログアウト」リンクについて

- Webシート・検索について

- コントロール・パネルについて

関連項目:
「Webシート・ナビゲーションについて」

Webシート・ページとセクション間のナビゲート

ブレッドクラムが各Webシート・ページの上部に表示されます。マウスを「ホーム」ブレッドクラムに重ねると、すべてのWebシート・ページへのリンクのサブメニューが表示されます。別のページを表示するには、子ブレッドクラム・エントリをクリックします。

図websheet_bread.gifに関する説明

関連項目:
「ページ・ディレクトリの表示」

ナビゲーション・セクションの使用

Webシートには、複数のページを含めることができます。多くのWebシートには、動的に生成されたナビゲーション・セクションが含まれます。各ナビゲーション・セクションに階層ツリーが含まれ、ページまたはページ・セクション間をナビゲートできます。

図websheet_nav.gifの説明

左側の矢印をクリックして、ツリーを展開または縮小します。特定のセクションまたはページにリンクするには、そのセクションまたはページを選択します。「すべて開く」をクリックすると、すべてのページおよびページのサブセクションが表示され、「リセット」をクリックすると、ツリーがデフォルト表示に戻ります。詳細は、「ナビゲーション・セクションについて」を参照してください。

ページ・セクションの表示または非表示

ページ・セクションを表示または非表示にできます。セクション内を表示または非表示にするには、セクション名の左側にある矢印をクリックします。

図websheet_nav1.gifの説明

言語について

図websheet_lang.gifに関する説明

「言語」ボタンをクリックすると、Webシート・プロパティ・ページの「言語の選択」セクションが表示されます。オプションは次のとおりです。

- 言語: このアプリケーションの実行中に使用する言語を選択します。ユーザーは、Oracle Application Expressにインストールされている言語からのみ選択できます。WebブラウザでCookieが有効な場合、この言語プリファレンスはCookieに書き込まれ、このインスタンスでのすべてのWebシート・アプリケーションの言語プリファレンスが制御されます。言語リストは、インストールされたOracle Application Expressの翻訳済バージョンによって決まります。

- 地域: このアプリケーションの実行中に使用する地域プリファレンスを選択します。これにより、デフォルトでの日付、数字およびカレンダの表示方法が制御されます。ブラウザでCookieが有効な場合、この地域プリファレンスはCookieに書き込まれ、このインスタンスでのすべてのWebシート・アプリケーションの地域プリファレンスが制御されます。

関連項目:
「Webシート・プロパティの編集」

「ヘルプ」リンクについて

図websheet_help.gifに関する説明

「ヘルプ」リンクをクリックすると、Webシート機能の概要を示す小さいヘルプ・システムが表示されます。「情報」、「概要」、「アクセス制御」、「マークアップ構文」、「データ・グリッド」、「アプリケーション・コンテンツ」、「FAQ」などのタブが使用可能です。このオンライン・ヘルプ内のコンテンツは、このガイドにも記載されています。

「ビルダー」リンクについて

図dev_return_ico.gifの説明

「ビルダー」アイコンは、アプリケーション・ビルダーからWebシート・アプリケーションを実行した場合にのみ表示されます。アプリケーション・ビルダーのホームページに戻るには、「ビルダー」アイコンをクリックします。

「ログアウト」リンクについて

図websheet_logout.gifに関する説明

実行中のWebシートからログアウトするには、ページの右上にある「ログアウト」リンクをクリックします。「ログイン」ページが表示されます。アプリケーション・ビルダーに戻るには、「開発に戻る」をクリックします。

Webシート検索について

「Webシートの検索」フィールドは、各Webシート・ページの右上に表示されます。

図websheet_search.gifに関する説明

「Webシートの検索」を使用して、アプリケーション・コンテンツの大/小文字を区別しない検索を実行します。検索結果はレポートに表示されます。

図websheet_search2.gifに関する説明

検索結果が表示された後で、ページの右側に表示される検索リージョンの検索オプションを選択または選択解除して検索を制御できます。

図websheet_search_reg.gifに関する説明

ビューをリフレッシュするには、「検索」ボタンをクリックします。

コントロール・パネルについて

ほとんどのWebシート・ページの右側に「コントロール・パネル」が表示されます。このリージョンには、「作成」、「編集」および「表示」メニューでも使用できるコマンドが含まれます。「コントロール・パネル」を非表示または表示するには、リージョン・タイトルの右側にある矢印をクリックします。

図websheet_control_panel.gifに関する説明

Webシートの「コントロール・パネル」には、次のオプションがあります。

- 「新規セクション」。「ページ・セクションの追加と編集について」を参照してください。

- 「セクションの編集」。「ページ・セクションの追加と編集について」を参照してください。

- 「新しいページ」。 「新しいページの追加」を参照してください。

- 「コピーの新規ページ」。「既存ページのコピー」を参照してください。

- 「ページの編集」。「ページの詳細の編集」を参照してください。

- 「ページ・ディレクトリ」。「ページ・ディレクトリの表示」を参照してください。

- 「新しいデータ・グリッド」。「データ・グリッドの作成」を参照してください。

Webシート・アプリケーションの作成について

アプリケーションの作成ウィザードを使用して、Webシート・アプリケーションを作成します。Webシート・ページを作成した後で、テキストまたはデータとしてコンテンツを追加します。

内容は次のとおりです。

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

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

- Webシートの実行

- 新しいページの追加

- 既存のページのコピー

- ページの詳細の編集

- Webシートの削除

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

Webシート・アプリケーションを作成するには、次のステップを実行します。

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

2. 「作成」ボタンをクリックします。

3. 「方法」で、「Webシート」を選択し、「次へ」をクリックします。

4. 「Webシートの作成」で、次のステップを実行します。

1. Webシート: アプリケーションを識別する一意の整数値を指定します。3000から9000の間のアプリケーションIDは内部使用向けに予約されています。

2. 名前: アプリケーションを識別するための名前を入力します。

3. SQLとPL/SQLの許可: SQLタグ、SQLレポートおよびPL/SQLセクションを定義できるかどうかを指定します。「はい」または「いいえ」を選択します。デフォルトでは、この属性は無効で、「いいえ」に設定されます。

4. スタート・ガイドを含める: Webシートのホームページの最初のテキスト・セクションにWebシートの使用に関する基本情報を含めるには、このオプションを選択します。
確認後、このテキスト・セクションを編集または削除できます。「ページ・セクションの追加と編集について」を参照してください。

5. 選択した内容を確認し、「Webシートの作成」をクリックします。
成功メッセージが表示されます。

6. レンダリングされたアプリケーションを表示するには、次のステップを実行します。

1. 「Webシートの実行」をクリックします。

2. ログイン・ページで、Webシートの資格証明を入力します。

- ユーザー名: ワークスペース・ユーザー名を入力します。

- パスワード: ワークスペース・パスワードを入力します。

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

デフォルトでは、Webシートの資格証明はワークスペースのログイン資格証明と同じです。

Webシート・アプリケーションが表示されます。

7. Webシート・コンテンツを追加します。

関連項目:
「ページ・セクションの追加と編集について」

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

実行中のWebシートからWebシート・アプリケーションを作成するには、次のステップを実行します。

1. Webシート・アプリケーションを実行します。「Webシートの実行」を参照してください。

2. 「作成」メニューで、「新しいWebシート」をクリックします。

3. 「Webシートの作成」で、次のステップを実行します。

1. Webシート: 一意の整数値を識別して、アプリケーションを識別します。3000から9000の間のアプリケーションIDは内部使用向けに予約されています。

2. 名前: アプリケーションを識別するための名前を入力します。

3. 説明: アプリケーションの説明を入力します。

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

4. 選択した内容を確認し、「作成」をクリックします。

5. レンダリングされたアプリケーションを表示するには、「実行」をクリックします。
Webシート・アプリケーションが表示されます。

6. Webシート・コンテンツを追加します。「ページ・セクションの追加と編集について」を参照してください。

関連項目:
「Webシートの実行」

Webシートの実行

レンダリングされたアプリケーションを表示するには、アプリケーションを実行するか、またはApplication Expressエンジンに送信します。

内容は次のとおりです。

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

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

- URLからのWebシートの実行

関連項目:
「Webシート・ページとセクション間のナビゲート」

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

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

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

2. 「Webシート・アプリケーション」タブをクリックします。

3. 「検索」バーから、「レポートの表示」アイコンをクリックします。

4. 「アプリケーション」リストで、Webシート・アプリケーションを探します。

5. 右側の列にある「実行」アイコンをクリックします。

6. ログイン・ページで、Webシートの資格証明を入力します。

- ユーザー名: ワークスペース・ユーザー名を入力します。

- パスワード: ワークスペース・パスワードを入力します。

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

Webシート・アプリケーションが表示されます。

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

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

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

2. Webシート・アプリケーションを選択します。

3. 「実行」アイコンをクリックします。

4. ログイン・ページで、Webシートの資格証明を入力します。

- ユーザー名: ワークスペース・ユーザー名を入力します。

- パスワード: ワークスペース・パスワードを入力します。

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

Webシート・アプリケーションが表示されます。

URLからのWebシートの実行

Webシート・アプリケーションを完成した後で、本番URLを公開できます。

「アプリケーション」ホームページからWebシート・アプリケーションを選択して「実行」アイコンにマウスを置くことにより、Webシート・アプリケーションへのURLを判別できます。URLがページの下部のステータス・バーに表示されます。

次に例を示します。

http://apex.somewhere.com/pls/apex/ws?p=123:home

詳細は、「Webシート・アプリケーションURLの公開について」を参照してください。

新しいページの追加

新しいWebシート・ページを追加するには、次のステップを実行します。

1. Webシート・アプリケーションを実行します。「Webシートの実行」を参照してください。

2. 「作成」メニューから、「新しいページ」を選択します。

3. 「ページの作成」で、次のステップを実行します。

1. 名前: ページ名を入力します。このページ名は、ウィンドウ・タイトルとして、およびブレッドクラムに表示されます。

2. ページの別名: ページの別名を指定します。この別名を使用して、このページにリンクできます。「ページへのリンク」を参照してください。

3. 親ページ: このページがページ階層の一部である場合は、親ページを選択します。

4. 「ページの作成」をクリックします。

既存のページのコピー

既存のページをコピーするには、次のステップを実行します。

1. Webシート・アプリケーションを実行します。「Webシートの実行」を参照してください。

2. 「作成」メニューから、「コピーの新規ページ」を選択します。

3. 「コピーの新規ページ」で、新しいページの名前を入力します。

4. 「ページのコピー」をクリックします。
成功メッセージが表示されます。

5. 次のいずれかのオプションを選択します。

- 現在のページの表示

- 新規ページの表示

ヒント:
ページの詳細を編集して、親ページを変更できます。「ページの詳細の編集」を参照してください。

ページの詳細の編集

ページの詳細で、ページ番号、別名、親ページまたはページ詳細を変更できます。

ページの詳細を編集するには、次のステップを実行します。

1. Webシート・アプリケーションを実行します。「Webシートの実行」を参照してください。

2. 「編集」メニューから、「ページの編集」を選択します。

3. 1つのページの詳細。

- 名前: ページの名前を指定します。このページ名は、ウィンドウ・タイトルおよびブレッドクラムに表示されます。

- 別名: ページの別名を使用して、他のページへのリンクをページ・セクションに作成できます。ページの別名は1つのアプリケーション内で一意である必要があります。「ページへのリンク」を参照してください。

- 所有者: ページの所有者を指定します。

- 親ページ: 親ページを指定します。定義した親ページは、ブレッドクラムおよびページ間のナビゲーションの構築に使用されます。

- ページ詳細: ページについて説明する説明テキストです。

4. 「変更の適用」をクリックします。
成功メッセージが表示されます。

ヒント:
「コントロール・パネル」で、「ページの編集」をクリックしてページの詳細を編集することもできます。

Webシートの削除

Webシートは、Webシート・プロパティ・ページで削除します。

Webシート・アプリケーションを削除するには、次のステップを実行します。

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

2. Webシート・アプリケーションを選択します。
Webシート・プロパティ・ページが表示されます。

3. 「削除」をクリックします。

関連項目:
「Webシート・プロパティの編集」

ページ・セクションの追加と編集について

ここでは、ページ・セクションの追加および編集方法について説明します。

内容は次のとおりです。

- セクション・タイプについて

- セクションの編集について

- ページ・セクションの削除

- セクション・タイトルと表示順序の編集

セクション・タイプについて

Webシートは、セクションと呼ばれるコンテナで構成されるページに編成されます。各Webシート・ページに対して、次のセクション・タイプを追加できます。

- テキスト: 入力したテキスト、インライン・イメージ、インライン・レポートや、レポート、データ・グリッド、他のページ、ファイル、外部URLへのリンクなどが表示されます。テキスト・セクションは、直感的なWYSIWIGエディタを使用して管理できます。「テキスト・セクションについて」を参照してください。

- ナビゲーション: 動的に生成されるナビゲーションを従属ページまたはページ・セクションに追加します。「ナビゲーション・セクションについて」を参照してください。

- データ: データ・グリッドまたはレポートに基づいて、インライン・レポートを作成します。「データ・グリッドの追加について」および「データ・レポートの追加について」を参照してください。

- チャート: データ・グリッドまたはレポートに基づいて、チャートを作成します。「チャート・セクションについて」を参照してください。

- PL/SQL: アプリケーション内で使用するSQLおよびSQLVALUE問合せを生成するためのデータ・グリッドを選択します。「PL/SQLセクションについて」を参照してください。

セクションの編集について

ページ・セクションを編集するには、次のステップを実行します。

1. 「Webシートの実行」の説明に従って、Webシートを実行します。

2. セクションの右上に表示される「編集」アイコンをクリックします。
図websheet_edit_sect.gifに関する説明

セクションの編集ページが表示されます。

図websheet_edit_sect2.gifに関する説明

ヒント:
セクションの編集ページの左側に、カレント・ページ上のすべてのセクションのリストが表示されます。カレント・セクションはハイライト表示されます。別のセクションに移動するには、そのセクションを選択します。

3. セクションを編集し、「変更の適用」をクリックします。

ページ・セクションの削除

ページ・セクションを削除するには、次のステップを実行します。

1. 「Webシートの実行」の説明に従って、Webシートを実行します。

2. セクションの右上に表示される「編集」アイコンをクリックします。
セクションの編集ページが表示されます。

3. 「削除」をクリックします。

セクション・タイトルと表示順序の編集

セクションの編集ページで、セクション・タイトルや表示順序を変更できます。

すべてのセクションを編集するには、次のステップを実行します。

1. Webシート・アプリケーションを実行します。「Webシートの実行」を参照してください。

2. 「編集」メニューから、「セクションの編集」を選択します。
セクションの編集ページが表示されます。

図websheet_edit_sections.gifに関する説明

3. セクション・タイトルを編集するには、新しいタイトルを入力します。

4. セクションの順序を変更するには、セクション・タイトルの隣にある「上へ」および「下へ」の矢印をクリックします。

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

ヒント:
「コントロール・パネル」で、「セクションの編集」をクリックしてセクションを編集することもできます。

テキスト・セクションについて

Webシート・ページにテキストを追加するには、テキスト・セクションを作成します。テキスト・セクションに直接入力することも、スプレッドシートからコンテンツをコピー・アンド・ペーストすることもできます。スプレッドシートからコピー・アンド・ペーストすると、スプレッドシートの行ごとに新しいセクションが作成されます。

内容は次のとおりです。

- テキスト・セクションの追加

- テキスト・セクションの編集

関連項目:
「ページ・セクションの削除」および「マークアップ構文の理解」

テキスト・セクションの追加

テキスト・セクションを追加するには、次のステップを実行します。

1. Webシート・アプリケーションを実行します。「Webシートの実行」を参照してください。

2. 「作成」メニューから、「新規セクション」を選択します。

3. セクション・タイプのプロンプトが表示されたら、「テキスト」を選択し、「次へ」をクリックします。

4. 「テキスト・セクションの作成」で、次のどちらかを選択します。

- 1つのテキスト・セクションの作成

- スプレッドシートから複数のテキスト・セクションを作成

5. 「1つのテキスト・セクションの作成」を選択する場合は、次のステップを実行します。

1. 順序: セクションの表示順序を入力します。

2. タイトル: セクション・タイトルを入力します。

3. コンテンツ: テキストを入力します。テキストの書式設定の詳細は、「テキスト・セクションの編集」を参照してください。

4. 「セクションの作成」をクリックします。

6. 「スプレッドシートから複数のテキスト・セクションを作成」を選択する場合は、次のステップを実行します。

1. 1行目に列ヘッダーが含まれる: 該当する場合にこのオプションを選択します。

2. スプレッドシート・データを貼付け: 2列のスプレッドシートまたはその他のタブ区切りデータを貼り付けます。1列目にはセクション・タイトル、2列目にはセクション・コンテンツが含まれている必要があります。

3. 「セクションの作成」をクリックします。

ヒント:
「コントロール・パネル」で、「新規セクション」を選択して新しいセクションを追加することもできます。

テキスト・セクションの編集

テキスト・セクションは、直感的なWYSIWIGエディタを使用して編集および書式設定できます。

テキスト・セクションを編集するには、次のステップを実行します。

1. 「Webシートの実行」の説明に従って、Webシートを実行します。

2. セクションの右上に表示される「編集」アイコンをクリックします。
図websheet_edit_sect.gifに関する説明

セクションの編集ページが表示されます。

3. 表示されたフィールドにテキストを入力します。

ヒント:
リンクの追加または埋込みの詳細は、「マークアップ構文の理解」を参照してください。

4. 書式設定を変更するには、右上隅にあるツールバーの展開アイコンをクリックします。
図websheet_toolbar2.gifに関する説明

ツールバーが表示されます。カーソルをアイコンに重ねると、説明ツールチップが表示されます。

5. このツールバーを非表示にするには、ツールバーの折り畳みアイコンをクリックします。
図websheet_toolbar.gifに関する説明

6. 変更を保存するには、「変更の適用」をクリックします。

ナビゲーション・セクションについて

ナビゲーション・セクションを作成して、動的に生成されるナビゲーションを従属ページまたはページ・セクションに追加できます。

関連項目:
「ナビゲーション・セクションの使用」、「ページ・セクションの削除」および「セクション・タイトルと表示順序の編集」

ナビゲーション・セクションの追加

ナビゲーション・セクションを追加するには、次のステップを実行します。

1. Webシート・アプリケーションを実行します。「Webシートの実行」を参照してください。

2. 「作成」メニューから、「新規セクション」を選択します。

3. セクション・タイプのプロンプトが表示されたら、「ナビゲーション」を選択し、「次へ」をクリックします。

4. 「ナビゲーション・タイプ」で、次のステップを実行します。

1. 次のいずれかを選択します。

- ページ・ナビゲーション: Webシート内のすべてのページのナビゲーションを作成します。

- セクション・ナビゲーション: ページ上のすべてのセクションのナビゲーションを作成します。

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

5. 「ページ・ナビゲーション」を選択する場合:

1. 順序: セクションの表示順序を入力します。

2. タイトル: セクション・タイトルを入力します。

3. 開始ページ: 階層ナビゲーションを表示する開始ページを選択します。

4. 最大レベル: 表示するレベルの最大数(つまりツリーの深さ)を選択します。

5. ORDER SIBLINGS BY: 列での兄弟の順序を選択します。定義しない場合、兄弟はページ名順にソートされます。

6. 「セクションの作成」をクリックします。

6. 「セクション・ナビゲーション」を選択する場合:

1. 順序: セクションの表示順序を入力します。

2. タイトル: セクション・タイトルを入力します。

3. 「セクションの作成」をクリックします。

データ・グリッドの追加について

データ・グリッドは、行および列に表示されるデータのセットです。データ・グリッドでは、スプレッドシートと同じ方法でデータが格納されます。作成後、時間の経過に応じて構造を修正できます。

内容は次のとおりです。

- データ・グリッドについて

- データ・グリッドの作成

- データ・グリッドのコピー

- データ・グリッドの表示と編集

- データ・グリッドの変更履歴ログの表示

- データ・グリッドの削除

関連項目:
「データ・コンテンツの追加と編集について」および「マークアップ構文の理解」

データ・グリッドについて

列名、データ・ソースおよび基本検証を使用してデータ・グリッドの構造を定義するか、スプレッドシート・データを貼り付けてデータ・グリッドを作成できます。作成後、必要に応じて構造を修正できます。

ユーザーは、列の選択、フィルタの適用、ハイライト処理、ソート処理などを行ってレポート・データのレイアウトを変更できます。ユーザーは、ブレーク、集計、グループ化、計算および各種チャートを定義することもできます。また、ユーザーは、データ・グリッドの複数のバリエーションを作成し、パブリックまたはプライベートの参照用に名前付きレポートとして保存できます。データ・グリッドからデータを使用し、それを任意のページにチャートまたはレポートとして含めることもできます。

関連項目:
「チャート・セクションについて」

データ・グリッドの作成

構造(列名、データ型および基本検証)を定義するか、またはスプレッドシート・データに貼り付けることによってデータ・グリッドを作成できます。各データ・グリッドには、定義済の列に加えて、所有者、作成者、作成日、更新者、更新日、行順序および注釈(ファイル、ノート、リンクおよびタグ)という標準の列が常に含まれます。

内容は次のとおりです。

- データ・グリッドを最初から作成

- スプレッドシート・データのコピー・アンド・ペーストによるデータ・グリッドの作成

データ・グリッドを最初から作成

データ・グリッドを最初から作成する場合は、列名、データ型および基本的な値を定義する必要があります。基本構造を作成した後で、それにデータを移入できます。

データ・グリッドを最初から作成するには、次のステップを実行します。

1. Webシート・アプリケーションを実行します。「Webシートの実行」を参照してください。

2. 「データ・グリッド」メニューから、「新しいデータ・グリッド」を選択します。

ヒント:
「コントロール・パネル」で、「新しいデータ・グリッド」を選択することもできます。

3. セクション・タイプのプロンプトが表示されたら、「最初から」を選択し、「次へ」をクリックします。
図data_grid_srcatch.gifに関する説明

4. 次の項目を指定します。

1. 名前: データ・グリッド名を入力します。

2. 別名: データ・グリッドの別名を入力します。この別名を使用して、他のページ・セクションでこのデータ・グリッドにリンクできます。データ・グリッドの別名は1つのアプリケーション内で一意である必要があります。

3. 列名とデータ型を指定して、データ・グリッド構造を定義します。順序を変更するには、「移動」の下で「上へ」および「下へ」矢印をクリックします。
列をさらに追加するには、「列の追加」をクリックします。

4. 「データ・グリッドの作成」をクリックします。

データ・グリッドが表示されます。

5. データを追加するには、「行の追加」をクリックします。「データ・グリッド・データの編集」を参照してください。

スプレッドシート・データのコピー・アンド・ペーストによるデータ・グリッドの作成

スプレッドシート・データをコピー・アンド・ペーストしてデータ・グリッドを作成するには、次のステップを実行します。

1. Webシート・アプリケーションを実行します。「Webシートの実行」を参照してください。

2. 「データ・グリッド」メニューから、「新しいデータ・グリッド」を選択します。

ヒント:
「作成」メニューまたは「コントロール・パネル」から「新しいデータ・グリッド」を選択することもできます。

3. セクション・タイプのプロンプトが表示されたら、「コピー・アンド・ペースト」を選択し、「次へ」をクリックします。

4. 次の項目を指定します。

1. 名前: データ・グリッド名を入力します。

2. 別名: データ・グリッドの別名を入力します。この別名を使用して、ページ・セクションでこのデータ・グリッドにリンクできます。データ・グリッドの別名は1つのアプリケーション内で一意である必要があります。

3. 1行目に列ヘッダーが含まれる: 該当する場合にこのオプションを選択します。

4. スプレッドシート・データを貼付け: スプレッドシート・プログラムからロードするデータをコピー・アンド・ペーストします。

5. 「アップロード」をクリックします。

データ・グリッドが表示されます。

データ・グリッドのコピー

データ・グリッドをコピーするには、次のステップを実行します。

1. Webシート・アプリケーションを実行します。「Webシートの実行」を参照してください。

2. 「データ・グリッド」メニューから、既存のデータ・グリッドを選択します。
データ・グリッドが表示されます。

3. 「管理」をクリックし、「コピー」を選択します。

4. 新しいデータ・グリッド名を入力し、「コピー」をクリックします。

データ・グリッドの表示と編集

データ・グリッドを作成した後で、それをデータ・ページで表示および編集できます。

内容は次のとおりです。

- 「データ」ページへのアクセス

- データ・グリッド・データの編集

- 手動でのデータ・グリッド列の編集

- 手動でのデータ・グリッド行の編集

- 単一のデータ・グリッド行の編集

- データ・グリッド・プロパティの編集

- データ・グリッドへのブックマーク・リンクの作成

ヒント:
データ・グリッドは対話モード・レポートとして表示されます。対話モード・レポートおよび「アクション」メニューの使用の詳細は、「対話モード・レポートのカスタマイズ」および「「アクション」メニューについて」を参照してください。

「データ」ページへのアクセス

「データ」ページにアクセスするには、次のステップを実行します。

1. Webシート・アプリケーションを実行します。「Webシートの実行」を参照してください。

2. 「データ・グリッド」メニューから、「すべてを表示」を選択します。
対話モード・レポートが表示され、すべてのデータ・グリッドが表示されます。

ヒント:
アイコンが表示されたら、「レポートの表示」アイコンをクリックします。

「レポート」ビューが表示されます。

図data_page_rpt.gifに関する説明

デフォルトでは、「レポート」ビューに、データ・グリッドの「名前」、「埋込みタグ」、「別名」、「ステータス」、「更新日」および「更新者」列が表示されます。「埋込みタグ」列には、ページのセクション内にレポートまたはデータ・グリッドへのリンクを埋め込む際に使用した構文が表示されます。

3. データ・グリッドを選択します。
データ・グリッドが表示されます。

図data_grid_view.gifに関する説明

チェック・ボックスの切替え

データ・グリッドを表示するときに、チェック・ボックスを有効または無効にすることができます。「管理」メニューから、「切替えチェックボックス」を選択します。このオプションを選択すると、各行の左側にチェック・ボックスが表示されます。

図data_grid_toggle.gifに関する説明

データ・グリッド・データの編集

データ・グリッドのデータを編集するには、次のステップを実行します。

1. Webシート・アプリケーションを実行します。「Webシートの実行」を参照してください。

2. 「データ・グリッド」メニューから、データ・グリッドを選択します。
データ・グリッドが表示されます。

3. 行を追加するには、次のステップを実行します。

1. 「行の追加」ボタンをクリックします。
フォームが表示されます。

2. 表示されたフィールドを編集し、「保存」または「保存してさらに追加」をクリックします。

手動でのデータ・グリッド列の編集

データ・グリッド列を手動で編集するには、次のステップを実行します。

1. Webシート・アプリケーションを実行します。「Webシートの実行」を参照してください。

2. 「データ・グリッド」メニューから、データ・グリッドを選択します。
データ・グリッドが表示されます。

3. 「管理」メニューから、「列」を選択します。
図data_grid_col.gifに関する説明

次のサブメニューが表示されます。

- 追加: 新しい列を追加します。列のすべてのプロパティ(列名、タイプ、値が必須かどうか、LOV、デフォルト・タイプ、デフォルト・テキストなど)を定義できます。

- 列プロパティ: 編集可能なプロパティには、順序、グループ、必要な値、ラベル、書式、ヘッダー、幅と高さ、列タイプ、デフォルト・テキスト、LOV、ヘルプ・テキストなどが含まれます。

- LOV: ユーザーが入力できる値を制限できます。「列プロパティ」で、LOVを列に関連付けます。

- 列グループ: グループを作成し、そのグループに列を追加します。「行の追加/編集」ページには、「データ」リージョンの下にサブセクションとしてグループが表示され、そのグループ内の列がリストされます。グループを使用して、「行の追加/編集」ページの表示を制御できます。

- 検証: 列検証およびエラー・メッセージを作成します。

- 列の削除: 削除する列を選択します。

4. サブメニュー・オプションを選択し、画面に表示されるステップに従います。

手動でのデータ・グリッド行の編集

「管理」メニューで「行」を選択して、データ・グリッドの行を手動で編集できます。

データ・グリッド行を手動で編集するには、次のステップを実行します。

1. Webシート・アプリケーションを実行します。「Webシートの実行」を参照してください。

2. 「データ・グリッド」メニューから、データ・グリッドを選択します。
データ・グリッドが表示されます。

3. 「管理」メニューから、「行」を選択します。
図data_grid_row.gifに関する説明

次のオプションが表示されます。

- 行の追加: 新しい行を追加します。

- 列値の設定: 列の事前定義済の値を設定します。

- 置換: 行を検索して置換します。

- 入力: nullの列値に上のセルの列値を入力します。

- 行の削除: 削除する行を選択します。

4. サブメニュー・オプションを選択して、画面に表示される手順に従います。

単一のデータ・グリッド行の編集

単一のデータ・グリッド行を手動で編集するには、次のステップを実行します。

1. Webシート・アプリケーションを実行します。「Webシートの実行」を参照してください。

2. 「データ・グリッド」メニューから、データ・グリッドを選択します。
データ・グリッドが表示されます。

3. 編集対象の行を選択し、「行の編集」アイコンをクリックします。
図data_grid_edit_row.gifに関する説明

行の追加/編集ページが表示されます。

4. 該当する行を編集し、「変更の適用」をクリックします。

ヒント:
行の追加/編集ページの「アクション」リージョンを使用して、新しい行の追加、注釈の追加、変更履歴の表示、列のプロパティとグループの編集、列の削除およびLOVまたは検証の作成を行うことができます。

単一のデータ・グリッド行への注釈の追加

注釈(つまり、ファイル、ノート、リンクおよびタグ)を単一のデータ・グリッド行に追加するには、次のステップを実行します。

1. Webシート・アプリケーションを実行します。「Webシートの実行」を参照してください。

2. 「データ・グリッド」メニューから、データ・グリッドを選択します。
データ・グリッドが表示されます。

3. 編集する行を選択し、「行の編集」アイコンをクリックします。
「行の追加/編集」ページが表示されます。

図data_grid_annot.gifに関する説明

4. 「アクション」リージョンで、次のいずれかを選択します。

- ファイルの追加

- ノートの追加

- リンクの追加

- タグの追加

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

関連項目:
「注釈の管理」

データ・グリッド・レポートでの注釈列の表示

データ・グリッド・レポートで注釈列を表示するには、次のステップを実行します。

1. 「単一のデータ・グリッド行への注釈の追加」の説明に従って、データ・グリッド・レポートに注釈を追加します。

2. データ・グリッド・レポートに列を含めるには、次のステップを実行します。

1. データ・グリッド・レポートを表示します。

2. 「アクション」メニューをクリックし、「列の選択」をクリックします。

3. 「列の選択」リージョンで、列(たとえば、ファイル、ノート、リンクおよびタグ)を「レポートに表示」に移動します。

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

3. すべてのユーザーが列を表示できるように、開発者は修正済レイアウトをデフォルト・レポートとして保存できます。

1. 「アクション」メニューをクリックし、「レポートの保存」を選択します。
「レポートの保存」リージョンが表示されます。

2. 「レポートの保存」で、次の項目を指定します。

1. 保存: 「デフォルトのレポート設定として保存」を選択します。

2. 名前: レポートの名前を入力します。

3. 説明: 説明を入力します(オプション)。

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

データ・グリッド・プロパティの編集

データ・グリッド・プロパティページで、データ・グリッドの名前、別名および説明を変更できます。

データ・グリッドを編集するには、次のステップを実行します。

1. Webシート・アプリケーションを実行します。「Webシートの実行」を参照してください。

2. 「データ・グリッド」メニューから、データ・グリッドを選択します。
データ・グリッドが表示されます。

3. 「管理」メニューから、「プロパティ」をクリックします。
データ・グリッド・プロパティページが表示されます。

4. 表示されたフィールドを編集し、「適用」をクリックします。

データ・グリッドへのブックマーク・リンクの作成

データ・グリッドまたは行に直接ブックマークするには、次の構文を使用します。

ws?p=100000:DG_<data grid alias>
ws?p=100000:DG_<data grid alias>:<session ID>:ROW_ID:<data grid row ID>

data grid row IDは、APEX$_WS_ROWS表のID列値です。

特定のデータ・グリッド行へのリンクを取得するには、次のステップを実行します。

1. データ・グリッドを実行します。

2. 「行の編集」アイコンをクリックします。

3. ブラウザのURLを書き留めます。

データ・グリッドの変更履歴ログの表示

「変更履歴の表示」ログに、データ・グリッドの変更のレポートが表示されます。このレポートには、行、列名、古い値、新しい値、変更したユーザー、変更がいつ行われたかが示されます。

データ・グリッドの変更履歴を表示するには、次のステップを実行します。

1. Webシート・アプリケーションを実行します。「Webシートの実行」を参照してください。

2. 「データ・グリッド」メニューから、データ・グリッドを選択します。
データ・グリッドが表示されます。

3. 「管理」メニューから、「履歴」を選択します。

データ・グリッドの削除

データ・グリッドをコピーするには、次のステップを実行します。

1. Webシート・アプリケーションを実行します。「Webシートの実行」を参照してください。

2. 「データ・グリッド」メニューから、データ・グリッドを選択します。
データ・グリッドが表示されます。

3. 「管理」メニューから、「データ・グリッドの削除」を選択します。

4. 選択内容を確認して、「削除」をクリックします。

データ・コンテンツの追加と編集について

この項では、データ・コンテンツの追加および編集方法について説明します。

内容は次のとおりです。

- 使用可能なデータ・ソース

- データ・レポートを作成するためのサポートの有効化について

- Webシート・ページへのデータの組込み

使用可能なデータ・ソース

Webシートには、データ・ソースを含めることができます。定義後、これらのデータ・ソースをWebシート・ページ・セクションに組み込むことができます。Webシートには、次のデータ・ソースを含めることができます。

- データ・グリッド: データ・グリッドは、高度なカスタマイズが可能で編集可能な表形式レポートです。データ・グリッドを使用して、Oracle Databaseに格納されているWebシート内にデータを保持できます。「データ・グリッドの追加について」を参照してください。

- レポート: レポートは、Oracle Databaseに存在する表またはビューに対して定義される問合せです。「データ・レポートの追加について」を参照してください。

データ・レポートを作成するためのサポートの有効化について

データ・レポートを定義するには、Webシート開発者がWebシート・プロパティ・ページで「SQLとPL/SQLの許可」属性を有効にする必要があります。デフォルトでは、この属性は無効になっています。

ヒント:
Webシート・プロパティ・ページで「SQLとPL/SQLの許可」属性を編集できるのは、Webシート・アプリケーション開発者のみです。詳細は、「Webシート・プロパティの編集」を参照してください。

Webシート・ページへのデータの組込み

データ・グリッドおよびデータ・レポートは、次のようにページ・セクションに組み込むことができます。

- データ・セクション内。「データ・レポートの追加について」を参照してください。

- チャート・セクション内。「チャート・セクションの追加」を参照してください。

- データ・グリッドへのリンク。「データ・グリッドへのリンク」を参照してください。

- 問合せの単一値または表形式の結果に含める。「SQLおよびSQLVALUE構文の使用」を参照してください。

データ・レポートの追加について

データ・レポートとは、基礎となるOracle Database内の表またはビューにコントリビュータが定義した問合せです。

ヒント:
データ・レポートを追加する前に、Webシート・アプリケーション開発者がWebシート・プロパティ・ページで「SQLとPL/SQLの許可」属性を有効にする必要があります。デフォルトでは、この属性は無効になっています。詳細は、「Webシート・プロパティの編集」を参照してください。

内容は次のとおりです。

- データ・レポートについて

- データ・レポートの作成

- データ・レポートの表示と変更

- データ・レポートの削除

関連項目:
「データ・コンテンツの追加と編集について」および「マークアップ構文の理解」

データ・レポートについて

データ・レポートはデータ・グリッドとは異なり、問合せのみで、Oracle Databaseからの既存のデータに基づいたものです。表またはビューの名前を指定してすべての列を取得したり、SQLを記述して必要なデータを取得することができます。

ユーザーは、列の選択、フィルタの適用、ハイライト処理、ソート処理などを行ってレポート・データのレイアウトを変更できます。ユーザーは、ブレーク、集計、グループ化、計算および各種チャートを定義することもできます。また、ユーザーは、データ・グリッドの複数のバリエーションを作成し、パブリックまたはプライベートの参照用に名前付きレポートとして保存できます。データ・レポートのデータを使用したり、それを任意のページにチャートまたはレポートとして含めることもできます。

関連項目:
「データ・セクションについて」および「チャート・セクションについて」

データ・レポートの作成

単に表またはビューの名前を入力するか、SQL問合せを入力してデータ・レポートを作成できます。

データ・レポートを作成するには、次のステップを実行します。

1. 「Webシートの実行」の説明に従って、Webシートを実行します。

2. 「レポート」メニューから、「新しいレポート」を選択します。

ヒント:
「コントロール・パネル」で、「新しいレポート」を選択することもできます。

レポートの作成ページが表示されます。

3. 「レポート・ソース」に、ソースの作成方法を指定します。オプションは次のとおりです。

1. 表: 「表」を選択し、次を入力します。

- 表またはビューの名前: レポートの基礎となる表の名前を選択します。

- レポート名: レポートの名前を入力します。

- レポート別名: レポートの別名を入力します。レポートの別名は、ページ・セクション内でレポートにリンクするために使用します。レポートの別名は1つのアプリケーション内で一意である必要があります。

2. SQL問合せ: 「SQL問合せ」を選択し、次を入力します。

- レポート名: レポートの名前を入力します。

- レポート別名: レポートの別名を入力します。レポートの別名は、ページ・セクション内でレポートにリンクするために使用します。レポートの別名は1つのWebシート内で一意である必要があります。

- 問合せ: レポートを定義するSQL問合せを入力します。

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

4. 選択内容を確認して、「レポートの作成」をクリックします。

データ・レポートの表示と変更

データ・レポートを表示または変更するには、次のステップを実行します。

1. 「Webシートの実行」の説明に従って、Webシートを実行します。

2. 「レポート」メニューから、「すべてを表示」を選択します。
レポート・ページが表示されます。

3. レポートを選択します。
レポートが表示されます。

4. レポート属性を編集するには、次のステップを実行します。

- 「管理」メニューから、「属性の編集」をクリックします。
レポート属性ページが表示されます。

- 属性を編集し、「変更の適用」をクリックします。

5. レポート問合せを編集するには、次のステップを実行します。

- 「管理」メニューから、「問合せの編集」をクリックします。
レポート問合せページが表示されます。

- 変更を保存するには、「変更の適用」をクリックします。

データ・レポートの削除

データ・レポートを削除するには、次のステップを実行します。

1. 「Webシートの実行」の説明に従って、Webシートを実行します。

2. 「レポート」メニューから、レポートを選択します。
レポートが表示されます。

3. 「管理」メニューから、「属性の編集」をクリックします。
レポート属性ページが表示されます。

4. 「削除」をクリックします。

データ・セクションについて

データ・グリッドまたはレポートに基づいて、データ・セクションを作成できます。

内容は次のとおりです。

- ページへのデータ・セクションの追加

- データ・セクションの編集

関連項目:
「データ・コンテンツの追加と編集について」

ページへのデータ・セクションの追加

データ・グリッドまたはレポートを作成した後、データ・セクションを追加してページにそれを追加できます。

関連項目:
「データ・グリッドの追加について」および「データ・レポートの追加について」

データ・セクションを追加するには、次のステップを実行します。

1. Webシート・アプリケーションを実行します。「Webシートの実行」を参照してください。

2. 「作成」メニューから、「新規セクション」を選択します。

3. セクション・タイプのプロンプトが表示されたら、「データ」を選択し、「次へ」をクリックします。

4. 次を指定します。

1. データ・セクション・ソース: 「データ・グリッド」または「レポート」のいずれかを選択します。

2. 表示順序: セクションの表示順序を入力します。

3. データ・グリッド/レポート: データ・セクションの表示に使用するデータ・グリッドまたはレポートを選択します。

4. 使用するレポート設定: 選択したデータ・グリッドまたはレポートで使用するレポート設定を選択します。この選択により、表示する行と列をフィルタしたり、表示する列を設定することができます。必要な設定が保存されているレポートがない場合は、セクションを追加する前に作成します。

5. タイトル: セクション・タイトルを入力します。

6. 含める: 次を追加するかどうかを選択します。

- 行の追加(「データ・セクション・ソース」が「データ・グリッド」の場合に使用可能)

- 行の編集(「データ・セクション・ソース」が「データ・グリッド」の場合に使用可能)

- 「検索」フィールド

7. スタイル: ユーザー・インタフェース・スタイルを選択します。

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

5. 「セクションの作成」をクリックします。

関連項目:
「データ・グリッドの追加について」および「データ・レポートの追加について」

データ・セクションの編集

ページにデータ・レポートを追加した後で、セクションの順序、タイトルおよびユーザー・インタフェース・スタイルを変更できます。

データ・セクションを編集するには、次のステップを実行します。

1. 「Webシートの実行」の説明に従って、Webシートを実行します。

2. セクションの右上に表示される「編集」アイコンをクリックします。
セクションの編集ページが表示されます。

3. 表示されたフィールドを編集します。詳細は、アイテム・ヘルプを参照してください。

4. 変更を保存するには、「変更の適用」をクリックします。

チャート・セクションについて

データ・グリッドまたはレポートに基づいて、インライン・チャートを作成できます。

内容は次のとおりです。

- チャート・セクションの追加

- チャート・セクションの編集

関連項目:
「データ・コンテンツの追加と編集について」

チャート・セクションの追加

チャート・セクションを追加するには、次のステップを実行します。

1. Webシート・アプリケーションを実行します。「Webシートの実行」を参照してください。

2. データ・グリッドまたはレポートを作成します。「データ・グリッドの追加について」を参照してください。

3. 「作成」メニューから、「新規セクション」を選択します。

4. セクション・タイプのプロンプトが表示されたら、「チャート」を選択し、「次へ」をクリックします。

5. 「グラフ・タイプの選択」で、次のステップを実行します。

1. 次のいずれかを選択します。

- 列

- 横棒

- 円

- 折れ線

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

6. 次の項目を指定します。

1. 表示順序: セクションの表示順序を入力します。

2. データ・グリッド: データ・グリッドを選択します。

3. 使用するレポート設定: 選択したデータ・グリッドまたはレポートで使用するレポート設定を選択します。この選択により、表示する行と列をフィルタできます。
必要な設定が保存されているレポートがない場合は、セクションを追加する前に作成します。

4. セクション・タイトル: セクション・タイトルを入力します。

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

7. 次の項目を指定します。

1. チャート・ラベル: ラベルとして使用する列を選択します。
「ラベルの軸タイトル」で、ラベルに選択した列に関連付けられた軸に表示するタイトルを入力します。

2. チャートの値: 値として使用する列を選択します。ファンクションがCOUNTである場合は、値を選択する必要はありません。
「値の軸タイトル」で、値に選択した列に関連付けられた軸に表示するタイトルを入力します。

3. ファンクション: 値に選択した列に対して実行されるファンクションを選択します。

4. ソート: チャートのソート方向を選択します。
チャートを3Dで表示するには、「3Dの有効化」を選択します。

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

8. サマリー・ページで選択を確認し、「セクションの作成」をクリックします。

チャート・セクションの編集

チャート・セクションを編集するには、次のステップを実行します。

1. Webシート・アプリケーションを実行します。「Webシートの実行」を参照してください。

2. セクションの右上に表示される「編集」アイコンをクリックします。
セクションの編集ページが表示されます。

3. 表示されたフィールドを編集します。詳細は、アイテム・ヘルプを参照してください。

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

PL/SQLセクションについて

PL/SQLについての知識があるユーザーは、PL/SQLセクションを使用して、関連付けられているスキーマに対して独自のコードを記述できます。

ヒント:
PL/SQLセクションは、Webシート・アプリケーション開発者がWebシート・プロパティ・ページで「SQLとPL/SQLの許可」属性を有効にした場合にのみ使用できます。詳細は、「Webシート・プロパティの編集」を参照してください。

内容は次のとおりです。

- PL/SQLセクションの追加

- PL/SQLセクションの編集

関連項目:
「ページ・セクションの削除」

PL/SQLセクションの追加

PL/SQLセクションを追加するには、次のステップを実行します。

1. Webシート・プロパティ・ページで、「SQLとPL/SQL」を有効にします。「Webシート・プロパティの編集」を参照してください。

2. Webシート・アプリケーションを実行します。「Webシートの実行」を参照してください。

3. 「作成」メニューから、「新規セクション」を選択します。

ヒント:
「コントロール・パネル」で、「新規セクション」を選択することもできます。「コントロール・パネルについて」を参照してください。

4. セクション・タイプのプロンプトが表示されたら、「PL/SQL」を選択し、「次へ」をクリックします。

5. 次を指定します。

1. 順序: セクションの表示順序を入力します。

2. タイトル: セクション・タイトルを入力します。

3. PL/SQLの入力: コードのPL/SQL無名ブロックを入力します。

4. 該当する場合、「PL/SQLコードを検証しない(実行時にのみPL/SQLコードを解析)。」を選択します。エラーが発生してもセクションを作成するには、このオプションを選択します。このオプションを使用してセクションを作成し、後でデバッグします。

ヒント:
例を表示するには、「PL/SQLの例」をクリックします。

6. 「セクションの作成」をクリックします。

PL/SQLセクションの編集

PL/SQLセクションを編集するには、次のステップを実行します。

1. 「Webシートの実行」の説明に従って、Webシートを実行します。

2. セクションの右上に表示される「編集」アイコンをクリックします。
セクションの編集ページが表示されます。

3. 次を編集します。

1. 順序: セクションの表示順序を入力します。

2. タイトル: セクション・タイトルを入力します。

3. PL/SQLの入力: コードのPL/SQL無名ブロックを入力します。

4. 変更を保存するには、「変更の適用」をクリックします。

マークアップ構文の理解

この項では、Webシート・ページ、ページ・セクション、外部URL、データ・グリッドにリンクを追加するための構文や、SQLまたはSQLVALUE構文を含めるための構文について説明します。

ヒント:
各Webシート・ページの右上隅に、「ヘルプ」ボタンが表示されています。ヘルプ・ページの「マークアップ構文」に、ここで説明する各種構文オプションがすべて示されます。

内容は次のとおりです。

- ページへのリンク

- セクションへのリンク

- 外部URLへのリンク

- データ・グリッドへのリンク

- SQLおよびSQLVALUE構文の使用

- 高度なデータ・グリッド問合せのルールについて

関連項目:
「アップロード済ファイルとイメージの管理」

ページへのリンク

Webシート内の他のページへのリンクをページ・セクションに含めるには、次の構文を使用します。そのページが存在する場合は、リンクが表示されます。そのページが存在しない場合は、ページを作成するためのリンクが表示されます。page:識別子の使用はオプションであることに注意してください。

構文:

[[ page: <page alias> | <link name> ]]
[[ <page alias> | <link name> ]]

構文の例:

[[page: home]]
[[mypage | My Page]]

コンテキスト内の例:

One of the most colorful fish is the [[ clownfish | Clown fish]].

セクションへのリンク

ページ・セクションへのリンクを含めるには、次の構文を使用します。セクションが存在する場合は、リンクが表示されます。セクションが存在しない場合は、セクションを作成するためのリンクが表示されます。セクションの前にページがない場合、そのセクションはカレント・ページにあるとみなされることに注意してください。

構文:

[[ section: <page alias> . <page section> | <link name> ]]
[[ section: <page section> | <link name> ]]

カレント・ページ内でリンクする構文の例:

[[section: clownfish | Clown Fish]]

異なるページにリンクする構文の例:

[[section: fish.clownfish | Clown Fish]]

コンテキスト内の例:

One of the most colorful fish is the [[ section: clownfish | Clown fish]].
Visit or fish page to see the [[ section: fish . clownfish | Clown fish]], also known as Nemo.

外部URLへのリンク

外部URLへのリンクをページ・セクションに含めるには、次の構文を使用します。url:識別子の使用はオプションであることに注意してください。新しいブラウザ・ウィンドウでリンクを開くには、ポップアップ接頭辞を使用します。

構文:

[[ url: <url> | <link name> ]]
[ popupurl: <url> | <link name> ]]
[[ <url> | <link name> ]]

構文の例:

[[url: http://www.company.com/store | commpanystore]]
[[popupurl: http://www.company.com/store | commpanystore]]
[[http://www.searchengine.com | searchengine]]
[[http://www.searchengine.com ]]

コンテキスト内の例:

You can buy Company software on the [[http://www.company.com/store | Company Store]] website.

データ・グリッドへのリンク

データ・グリッドへのリンクをページ・セクションに含めるには、次の構文を使用します。これらのリンクを使用して、データ・グリッドを表示したり、新しいデータを作成することができます。データ・グリッドは、1ワードまたは2ワードであることに注意してください。

構文:

[[ data grid: <datagrid alias | <link name> ]]
[[ datagrid: <datagrid alias | <link name> ]]
[[ datagrid: <datagrid alias . <saved report name (may not be private)> | <link name> ]]

構文の例:

[[ data grid: todo list | To Do List ]]
[[ data grid: todo list . open todo items | To Do List ]]
[[ datagrid: todo list | To Do List ]]

コンテキスト内の例:

Please review the [[ data grid: todo list | To Do List ]] and ensure your tasks can be accomplished by Friday.

SQLおよびSQLVALUE構文の使用

SQLまたはSQLVALUE構文を使用して、データ・グリッドまたは表やビューに対する問合せからの単一値や表形式の結果をページのセクションに含めることができます。SQLVALUEタグを使用すると、SQL問合せによって戻される最初の行の最初の列が表示され、文中(例: There are currently 5 types of cats.)にデータベース・データを埋め込むことができます。表形式の結果に対しては、SQLタグを使用します。SQLタグの結果は、検索可能なレポートで表示されます。ただし、デフォルトでは、NOSEARCH構文を使用してこの検索オプションを無効化できます。

データ・グリッドを操作する場合、「構文」の下に表示されるいくつかの追加オプションとルールがあります。データ・グリッド問合せを作成する際の基本的なルールは次のとおりです。

- データ・グリッドの名前または別名を中括弧で囲みます。次に例を示します。

{Cat Facts}

- データ・グリッドの列名を二重引用符で囲みます。次に例を示します。

"Type of Cat"

高度なルールの詳細は、「高度なデータ・グリッド問合せのルールについて」を参照してください。

表およびビューに対する問合せの構文:

[[sql: <select statement> ]]
[[sql: <select statement | limit="<maximum rows>" nosearch style="<style number>" ]]
[[sqlvalue: <select statement> ]]

データ・グリッド問合せの構文:

[[sql: <select statement> ]]
[[sql: <select statement | limit="<maximum rows>" nosearch style="<style number>" edit_row add_row show_sql ]]
[[sqlvalue: <select statement> ]]
[[sqlvalue: <select statement> | show_sql ]]

コンテキスト内SQLタグ構文の例:

[[sql: select ename "Employee Name", sal "Salary" from emp order by sal desc | limit="10" style="2"]].
[[sql: select "Type of Cat",
"Estimated Population",
"Largest Threats",
"Top Speed",
"Scientific Name",
"IUCN Status",
"Weight",
"Study Date"
from {Cat Facts} | add_row edit_row ]]

コンテキスト内SQLVALUEタグ構文の例:

We have [[sqlvalue: select count(*) from emp]] employees in our database, [[sqlvalue: select count(*) from emp where deptno=10 ]] work in department 10.We are currently tracking [[sqlvalue: select count(*) from {Cat Facts} ]] types of cats.

高度なデータ・グリッド問合せのルールについて

高度なデータ・グリッド問合せには、次のルールがあります。

- 行の編集または行の追加リンクを含めるには、問合せがデータ・グリッドを1回のみ参照している必要があります(つまり、問合せ内でデータ・グリッドをそれ自体に結合することはできません)。

- 行の編集リンクを含めるには、最初の列がデータ・グリッドの主キー(つまり、データの行を一意に識別する列)である必要があります。"edit_row"オプションが含まれ、かつ問合せに単一のselect文がある場合、主キー列が自動的に含められます。問合せに複数のselect文が含まれる場合、行の編集リンクを含めるために、"APXWS_DATA_GRID_PK"置換(常に二重引用符で囲みます)をSELECT文の最初の列として使用して、主キーを含めることができます。

- レポートの列名がデータ・グリッドの列名になりますが、標準SQLの列の別名指定構文を使用して変更できます。たとえば、次の例では、Minimum Number列からのデータが表示されますが、ヘッダーはMinとして表示されます。

select "Minimum Number" "Min" from ...

- 列名が30文字を超える場合、名前として最初の30文字のみを含めます。たとえば、次のように使用します。

"% of Estimated Lions per Region"

次の例は使用しません。

"% of Estimated Lions per Region"

- 実行される問合せを表示するには、"show_sql"オプションを含めます。このオプションを含めると、含まれているレポートの上に問合せが表示されます。これはデバッグには優れた方法ですが、本番アプリケーションに対する"show_sql"の使用はお薦めしません。

注釈の管理

注釈を追加して、Webページにコメントや詳細を追加できます。注釈は、アップロードされたファイル、ノート、リンクおよびタグの形式にすることができます。ページとデータ・グリッド・レコードの両方に追加できます。

内容は次のとおりです。

- アップロード済ファイルとイメージの管理

- タグの追加

- ノートの追加

- 注釈の表示と削除

アップロード済ファイルとイメージの管理

「ファイル」リージョンを使用して、Webシートにファイルとイメージをアップロードできます。アップロードした後で、アップロード済イメージをページ・セクションに表示したり、ファイルのダウンロード・リンクを埋め込むことができます。

内容は次のとおりです。

- ファイルとイメージのアップロード

- ページ・セクションにダウンロード・リンクを含める方法

- インラインでのアップロード済イメージの表示

- アップロード済ファイルの編集または削除

ファイルとイメージのアップロード

Webシートにファイルおよびイメージをアップロードするには、次のステップを実行します。

1. Webシートにログインし、Webシートを実行します。「Webシートの実行」を参照してください。

2. ページの右側の「ファイル」の下で、「ファイルの追加」アイコンをクリックします。
図websheet_files.gifに関する説明

3. ファイルの追加ページで、次のステップを実行します。

1. ファイル: 参照してアップロードするファイルを選択します。アップロードすると、そのファイルはカレント・ページに関連付けられます。イメージまたはファイル構文を使用して、アップロード済ファイルを任意のページで参照できます。「インラインでのアップロード済イメージの表示」またはオンライン・ヘルプの「マークアップ構文」を参照してください。

2. 別名: ファイルの別名を使用して、ダウンロード・リンクまたはイメージ・リンクをページ・セクションに埋め込むことができます。ファイルの別名は1つのアプリケーション内で一意である必要があります。

3. 説明: ファイルについて説明する説明テキストを入力します。

4. 「ファイルの追加」をクリックします。

ページ・セクションにダウンロード・リンクを含める方法

次の構文を使用して、アップロード済ファイルのダウンロード・リンクをページ・セクションに埋め込むことができます。

構文:

[[ file: < file name > | < link name > ]]
[[ file: < file alias > | < link name > ]]

構文の例:

[[file: myfile ]]
[[file: myfile.xls ]]
[[file: myfile | My File ]]

ファイル・マークアップの例:

This [[file: parts01.xls | spreadsheet ]] documents our part numbers.

インラインでのアップロード済イメージの表示

イメージをアップロードした後で、次の構文を使用してダウンロード・リンクを埋め込むことにより、アプリケーションの任意のページ・セクションでそのイメージを表示できます。イメージ名またはイメージの別名を使用して、アップロード済イメージを参照できます。

カレント・ページに定義されたイメージは、他のページに関連付けられたイメージよりも優先して使用されます。イメージ名があいまいな場合は、作成が最近のイメージが表示されます。

構文:

[[ image: < file name > | < properties > ]]
[[ image: < file alias > | < properties > ]]

構文の例:

[[image: myimage ]]
[[image: theimagename.jpg ]]
[[image: myimage | width="600" alt="my image" ]]

例:

This diagram [[image: diagram1]] illustrates the work flow.

アップロード済ファイルの編集または削除

詳細を編集したり、アップロード済ファイルを削除するには、次のステップを実行します。

1. Webシートにログインし、Webシートを実行します。「Webシートの実行」を参照してください。

2. 「ファイル」リージョンで、「ファイルの編集」アイコンをクリックします。
詳細ページが表示されます。

3. ファイルの詳細を編集するには、次のステップを実行します。

1. 表示されたフィールドを編集します。詳細は、アイテム・ヘルプを参照してください。

2. 変更を受け入れるには、「変更の適用」をクリックします。

4. ファイルを削除するには、次のステップを実行します。

1. 「削除」をクリックします。

2. 変更を受け入れるには、「OK」をクリックします。

タグの追加

タグを使用すると、Webシート内でキーワードを簡単に検索できます。

内容は次のとおりです。

- タグの追加

- 既存のタグの編集

タグの追加

Webシート・ページにタグを追加するには、次のステップを実行します。

1. Webシートにログインし、Webシートを実行します。「Webシートの実行」を参照してください。

2. ページの右側の「タグ」の下で、「タグの追加」アイコンをクリックします。
図websheet_tags.gifに関する説明

3. 表示されるフィールドにタグを入力します。複数のタグはカンマで区切ります。

4. 「タグの追加」をクリックします。

既存のタグの編集

既存のタグを編集するには、次のステップを実行します。

1. Webシートにログインし、Webシートを実行します。「Webシートの実行」を参照してください。

2. 「タグ」リージョンで、「タグの編集」アイコンをクリックします。
詳細ページが表示されます。

3. タグを編集し、「タグの追加」をクリックします。

ノートの追加

ノートを使用してユーザー・コメントを記録します。

内容は次のとおりです。

- ノートの追加

- 既存のノートの編集および削除

ノートの追加

Webシート・ページにノートを追加するには、次のステップを実行します。

1. Webシートにログインし、Webシートを実行します。「Webシートの実行」を参照してください。

2. ページの右側の「ノート」の下で、「ノートの追加」アイコンをクリックします。
図websheet_notes.gifに関する説明

3. 表示されるフィールドにテキストを入力します。

4. 「ノートの追加」をクリックします。

既存のノートの編集および削除

既存のノートを編集または削除するには、次のステップを実行します。

1. Webシートにログインし、Webシートを実行します。「Webシートの実行」を参照してください。

2. 「ノート」リージョンで、「ノートの編集」アイコンをクリックします。

3. ファイルの詳細を編集するには、次のステップを実行します。

1. 表示されたフィールドを編集します。詳細は、アイテム・ヘルプを参照してください。

2. 変更を受け入れるには、「変更の適用」をクリックします。

4. ノートを削除するには、「削除」をクリックします。

注釈の表示と削除

注釈ページで、すべてのWebシート注釈を表示および削除できます。注釈には、Webシート・ページまたはデータ・グリッド内の特定の行に追加されたアップロード済ファイル、ノート、リンクおよびタグが含まれます。

内容は次のとおりです。

- 注釈ページへのアクセス

- 注釈の削除

注釈ページヘのアクセス

注釈ページにアクセスするには、次のステップを実行します。

1. Webシートにログインし、Webシートを実行します。「Webシートの実行」を参照してください。

2. 「表示」メニューから、「注釈」を選択します。
注釈ページが表示されます。

図websheet_annot.gifに関する説明

3. 特定のタイプの注釈を表示するには、「ファイル」、「ノート」、「リンク」、「タグ」または「タグ・クラウド」タブをクリックします。

注釈の削除

アップロード済ファイル、ノート、リンクまたはタグを削除するには、次のステップを実行します。

1. Webシートにログインし、Webシートを実行します。「Webシートの実行」を参照してください。

2. 「表示」メニューから、「注釈」を選択します。
注釈ページが表示されます。

3. ページの上部にある適切なタブをクリックして、注釈タイプを選択します。

4. 該当するタブ(「ファイル」、「ノート」、「リンク」、「タグ」または「タグ・クラウド」)をクリックします。

5. 削除する注釈を選択します。

6. 選択しない場合は、「レポートの表示」アイコンをクリックします。
図websheet_annot_del.gifに関する説明

7. 「チェックした項目の削除」をクリックします。

Webシート・アプリケーションの管理

「管理」メニューのオプションを使用して、Webシート・ダッシュボードの表示、Webシート・アクティビティの監視、Webシート・プロパティの編集およびWebシート・アクセスの制御を実行します。

内容は次のとおりです。

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

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

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

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

- Webシート・パスワードの変更

- Webシート・ページの電子メール送信

- Webシート・ページの出力

関連項目:
「Webシート・アプリケーションURLの公開について」

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

Webシート・ダッシュボードには、カレントWebシート・アプリケーションの詳細(最近の変更、トップ・ユーザー、トップ・ページなど)が表示されます。

Webシート・ダッシュボードを表示するには、次のステップを実行します。

1. Webシートにログインし、Webシートを実行します。「Webシートの実行」を参照してください。

2. 「管理」メニューから、「ダッシュボード」を選択します。
ダッシュボードが次のセクションに分かれて表示されます。

- アプリケーション詳細

- 最近の変更

- トップ・ユーザー

- トップ・ページ

3. 時間枠を編集するには、「時間枠」リストから新しい値を選択します。

4. デフォルト設定に戻すには、「リセット」をクリックします。

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

アクティビティの監視ページを使用して、ページおよびコンテンツの使用状況、パフォーマンスおよび人気度を解析します。

アクティビティの監視ページにアクセスするには、次のステップを実行します。

1. Webシートにログインし、Webシートを実行します。「Webシートの実行」を参照してください。

2. 「管理」メニューから、「アクティビティの監視」を選択します。
アクティビティの監視ページが表示され、このページは次のセクションに分かれています。

- アクティビティ

- ページ・ビュー

- トップ・ページ

- トップ・データ・グリッド

- トップ・レポート

- トップ・ユーザー

- 注釈

- トップ・ファイル

- トップ・ノート

- トップ・タグ

各レポートは、対話モード・レポートとして表示されます。対話モード・レポートおよび「アクション」メニューの使用の詳細は、「対話モード・レポートのカスタマイズ」および「「アクション」メニューについて」を参照してください。

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

実行中のWebシートの内部または外部から、Webシート・プロパティ・ページにアクセスできます。Webシート・プロパティ・ページを使用して、アプリケーションの一般的なデフォルト設定および動作を制御できます。ホームページは、そのWebシートを実行するときに、ユーザーが最初にアクセスするホームページです。アプリケーションの名前は、ブレッドクラム内に表示されます。

内容は次のとおりです。

- 実行中のWebシートからWebシート・プロパティへのアクセス

- アプリケーション・ビルダーからWebシート・プロパティへのアクセス

- Webシート・プロパティについて

実行中のWebシートからWebシート・プロパティへのアクセス

Webシート・プロパティ・ページにアクセスするには、次のステップを実行します。

1. Webシートにログインし、Webシートを実行します。「Webシートの実行」を参照してください。

2. 「管理」メニューから、「Webシート・プロパティ」を選択します。
「Webシート・プロパティ」が表示されます。

3. セクションを表示するには、セクション・タイトルの左側にある大なり記号(>)をクリックします。

4. 特定の属性の詳細は、アイテム・ヘルプおよび「Webシート・プロパティについて」を参照してください。

アプリケーション・ビルダーからWebシート・プロパティへのアクセス

「Webシート・プロパティ」ページにアクセスするには、次の手順を実行します。

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

2. 「Webシート・アプリケーション」タブをクリックします。

3. 「アイコンの表示」ボタンをクリックします。

4. Webシートを選択し、「編集」をクリックします。
「Webシート・プロパティ」が表示されます。「Webシート・プロパティについて」を参照してください。

5. 特定の属性の詳細は、アイテムのヘルプを参照してください。

Webシート・プロパティについて

ここでは、Webシート・プロパティ・ページ上の属性について説明します。

アプリケーション

「アプリケーション」セクションを使用して、一般的なアプリケーション・プロパティを制御します。表5-1に、「アプリケーション」属性を示します。

表5-1 「アプリケーション」属性

属性

説明

名前

アプリケーションの名前を指定します。アプリケーションの実行中は、この名前がブレッドクラム内に表示されます。

ステータス

アプリケーションのステータスを指定します。使用可能なオプションは、「使用可能」または「使用不可」です。

ホームページ

このWebシートのホームページを選択します。これは、Webシートを実行するときに、ユーザーに対して最初に表示されるページです。

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

アプリケーションで使用する日付書式を決定します。

この日付書式を使用して、NLS_DATE_FORMATデータベース・セッションの設定が変更されてから、アプリケーション内のページが表示または送信されます。この値には、有効なOracle日付書式マスクを含むリテラル文字列、または置換構文を使用したアイテム参照を指定できます。値が指定されていない場合は、データベース・セッションからデフォルトの日付書式が実行時に取得されます。

デフォルトのアプリケーション言語

アプリケーションのデフォルト言語を指定します。ユーザーは、アプリケーション内から言語プリファレンスを変更できます。この言語リストは、インストールされたApplication Expressの翻訳済バージョンによって決まります。

デフォルトのアプリケーション地域

日付、言語、数字などの属性を制御する、アプリケーションのデフォルト地域を指定します。ユーザーは、アプリケーション内から地域プリファレンスを変更できます。

パスワードのリセットの表示

ログイン・ページでの「パスワードの再設定」リンクの表示を制御します。ユーザーは、このリンクを使用してパスワードをリセットできます。このオプションは、アプリケーションで「Application Expressアカウント」認証が使用されている場合にのみ機能します。

Webシートの電子メール送信元アドレス

Webシートで送信者アドレスとして使用する電子メール・アドレスを指定します。この送信者電子メール・アドレスは、Webシートのデータ・グリッドまたはレポート電子メール・ダウンロードから電子メールを送信するときに使用されます。

詳細

「詳細」セクションを使用して、アプリケーションの説明およびログイン・メッセージを編集します。表5-2に、「詳細」属性を示します。

表5-2 詳細

属性

説明

所有者

アプリケーションを所有するユーザーを指定します。

説明

アプリケーションについて説明するオプションの説明です。

ログイン・メッセージ

ログイン・ページにこのメッセージが表示されます。

ロゴ

「ロゴ」セクションを使用して、このWebシート・アプリケーションのロゴを作成します。このロゴは、Webシートの上部に表示されます。表5-3に、「ロゴ」属性を示します。

Table 5-3 ロゴ

属性

説明

ロゴ・タイプ

アプリケーションに使用するロゴのタイプを選択します。

ロゴ

アプリケーション・ロゴとして使用する完全なテキスト文字列を入力します。

スタイル

デフォルトのアプリケーション・スタイルを上書きし、カスタムCSSを使用するには、「スタイル」セクションを使用します。

認証

「認証」セクションを使用して、このWebシートの認証スキームを選択します。表5-4に、「認証」属性を示します。

Table 5-4 認証

属性

説明

認証

アプリケーションのユーザーを認証する方法を選択します。認証スキームを変更するには、「認証の編集」をクリックします。次のリストが表示されます。

- Application Expressアカウント: 開発者アカウントのユーザー名とパスワードを使用して認証します。

- シングル・サインオン: Oracle Application Server Single Sign-Onを使用して認証します。これは、Application Expressインスタンスに対して構成する必要があります。

- LDAP: LDAPディレクトリを使用して認証します。これを構成するには、このページで追加パラメータを指定します。

- カスタム: 認証およびセッション管理タスクのための独自のコードを指定します。「Webシート・アクセスの制御」を参照してください。

ログアウトURL

このアプリケーションのログアウト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名

Application ExpressセッションおよびURL内のセッションIDを識別するために必要なセッションCookieの名前。セッションCookie名の値が指定されていない場合、Application Expressはデフォルト値を選択します。

Cookieパス

セッションCookieのパス属性。

Cookieドメイン

セッションCookieのドメイン属性。

セキュア

オプションは次のとおりです。

- はい: プロトコルがHTTPSの場合のみ、セッション管理Cookieはブラウザによって送信されます。

- いいえ: プロトコルがHTTPまたはHTTPSいずれの場合も、セッション管理Cookieはブラウザによって送信されます。

認可

「認可」セクションを使用して、Webシート・アプリケーションにログインできるユーザーを制御します。表5-5に、「アプリケーション」属性を示します。

表5-5 認可

属性

説明

アクセス制御リスト・タイプ

認証が「Application Expressアカウント」の場合、Application Expressワークスペース内のロールで認可を判断するか、アクセス制御リストで認可を判断するかを選択します。「Application Expressアカウント」以外のすべての認証タイプでは、認可は常にアクセス制御リストで判断されます。

パブリック・アクセスを許可

オプションは次のとおりです。

- はい: ユーザーにログインを要求せずに、ユーザーが読取り専用モードでアプリケーションを実行できるようになります。

- いいえ: すべてのユーザーはアプリケーションを実行するためにログインする必要があります。

ロールおよびそれらの権限の詳細は、「アクセス制御ロール」をクリックしてください。「アクセス制御リストの編集」をクリックして、アクセス制御リスト・ページにリンクします。詳細は、「Webシート・アクセスの制御」を参照してください。

SQLおよびPL/SQL

「SQLとPL/SQL」セクションを使用して、ユーザーがカレントWebシートでSQLとPL/SQLを使用できるかどうかを決定します。デフォルトでは、この機能は無効化されています。デフォルト設定を変更するには、「SQLとPL/SQLの許可」で「はい」を選択します。

有効化すると、ユーザーはレポートおよびSQLタグ内でSQLを使用でき、ページ・セクション内にPL/SQLを含めることができます。「オブジェクトの追加」をクリックして、推奨オブジェクトページにリンクします。ユーザーは、カスタム・レポートを記述することも、カレント・ワークスペースに関連付けられたスキーマ内のデータベース・オブジェクトにSQLタグを使用することもできます。推奨オブジェクトとしてデータベース表またはビューを指定すると、ヘルプ・ページで表およびビューの列を公開することによりSQLを簡単に作成できるようになります。

ヒント:
インスタンスの管理者は、インスタンス全体に対してSQLとPL/SQLを使用する機能を制御できます。詳細は、『Oracle Application Express管理ガイド』のWebシートでのSQLアクセスの有効化と無効化に関する説明を参照してください。

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

この項では、Webシート・アプリケーションへのアクセスの制御方法について説明します。

内容は次のとおりです。

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

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

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

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

管理者は、次の認証メカニズムのいずれかを指定して、Webシート・アプリケーションにログインできるユーザーを制御します。

- パブリック・アクセス(認証なし)

- Oracle Application Expressアカウント

- シングル・サインオン検証

- LDAP資格証明の検証

- カスタム

認証が「カスタム」として定義されている場合は、このアプリケーションのユーザーの権限はアクセス制御リストで管理されます。

認証がOracle Application Expressアカウントの場合は、Application Expressワークスペースに定義されたユーザー・ロールで認可を判断するか、アクセス制御リストで認可を判断するかを指定する必要があります。Oracle Application Expressアカウント以外のすべての認証タイプでは、認可は常にアクセス制御リストで判断されます。

ユーザーがアプリケーションにログインすると、ユーザーに割り当てられたロールによってアクセス権が判断されます。ユーザーに割り当てられるロールには次のものがあります。

- リーダー: コンテンツを表示できますが、編集はできません。

- コントリビュータ: コンテンツを表示および編集できます。

- 管理者: コンテンツを表示および編集でき、「Webシート・プロパティ」の編集および「アクセス制御リスト」の管理を行うこともできます。

ユーザー・ロールと権限の詳細は、「ヘルプ」をクリックし、「アクセス制御」を選択してください。「「ヘルプ」リンクについて」を参照してください。

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

アクセス制御リストを使用するには、「Webシート・プロパティ」を編集し、「アクセス制御リスト・タイプ」を「カスタム」として定義します。

「Webシート・プロパティ」ページにアクセスするには、次の手順を実行します。

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

2. 「Webシート・アプリケーション」タブをクリックします。

3. 「アイコンの表示」ボタンをクリックします。

4. Webシートを選択し、「編集」をクリックします。
「Webシート・プロパティ」が表示されます。「Webシート・プロパティについて」を参照してください。

5. 「認可」までスクロールします。

6. 「アクセス制御リスト・タイプ」から、「カスタム」を選択します。

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

関連項目:
「認証」

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

アクセス制御リスト・エントリを作成するには、次のステップを実行します。

1. Webシートにログインし、Webシートを実行します。「Webシートの実行」を参照してください。

2. 「管理」メニューから、「アクセス制御」を選択します。

3. 「エントリの作成」をクリックします。
エントリの詳細ページが表示されます。

4. エントリの詳細ページで、次のステップを実行します。

1. ユーザー名: アクセス制御の対象ユーザーのユーザー名を入力します。

2. 権限: ユーザーの権限を指定します。

- リーダー: コンテンツを表示できますが、編集はできません。

- コントリビュータ: コンテンツを表示および編集できます。

- 管理者: コンテンツを表示および編集でき、「Webシート・プロパティ」の編集および「アクセス制御リスト」の管理を行うこともできます。

5. 「作成」または「作成後、さらに作成」をクリックします。

Webシート・パスワードの変更

Webシート・パスワードを変更するには、次のステップを実行します。

1. Webシートにログインし、Webシートを実行します。「Webシートの実行」を参照してください。

2. 「管理」メニューから、「パスワードの変更」を選択します。
パスワードの変更ページが表示されます。

3. 画面に表示されるステップに従い、「パスワードの変更」をクリックします。

Webシート・ページの電子メール送信

Webシート・ページを電子メール送信するには、次のステップを実行します。

1. Webシートにログインし、Webシートを実行します。「Webシートの実行」を参照してください。

2. 電子メール送信するページを探します。

3. 「コントロール・パネル」の上で、「電子メール」アイコンをクリックします。
図websheet_mail_pg.gifに関する説明

4. 「電子メール・ページ」で、次のステップを実行します。

1. To: 宛先の電子メール・アドレスを入力します。

2. 件名: この電子メールの説明を入力します。

3. 本文: Webシート・ページ・リンクとともに組み込む電子メール・コンテンツを入力します。

5. 「送信」をクリックします。

現在選択しているページへの電子メール・リンクが、電子メール・メッセージに自動的に組み込まれます。

関連項目:
『Oracle Application Express管理ガイド』の電子メールの構成に関する説明

Webシート・ページの出力

Webシートを印刷用モードで出力するには、次のステップを実行します。

1. Webシートにログインし、Webシートを実行します。「Webシートの実行」を参照してください。

2. 「コントロール・パネル」の上で、「出力」アイコンをクリックします。
図websheet_print.gifに関する説明

ページが印刷用モードで表示されます。

3. ページを印刷します。

Webシートの表示

「表示」メニューのオプションを使用して、プレゼンテーション・モードへのアクセス、ページ・ディレクトリの表示、ページ履歴へのアクセスおよびアプリケーション・ディレクトリの表示を実行します。

内容は次のとおりです。

- プレゼンテーション・モードについて

- ページ・ディレクトリの表示

- ページ履歴の表示

- Webシート・ディレクトリの表示

関連項目:
「注釈の管理」および「Webシート・アプリケーションURLの公開について」

プレゼンテーション・モードについて

プレゼンテーション・モードを使用すると、単一のWebシート・ページをプレゼンテーションとして表示できます。各ページ・セクションは、スライドとして一度に1枚ずつ表示されます。[→]キーと[←]キーやページの右上にある右矢印と左矢印を使用することで、またはセクション番号を入力して特定のセクションに素早くジャンプすることで、セクション間をナビゲートできます。

Webシートをプレゼンテーション・モードで表示するには、ページの右端にある「プレゼンテーション」アイコンをクリックします。

図websheet_pres.gifに関する説明

プレゼンテーション・モードでは、各ページ・セクションが個別のページとして表示されます。

図websheet_pres2.gifに関する説明

ページの右上にあるナビゲーション・バーを使用します。プレゼンテーション・モードを終了するには、終了アイコンをクリックするか、[Esc]キーを押します。

ページ・ディレクトリの表示

「ページ・ディレクトリ」を使用して、カレントWebシート内のすべてのページを表示します。各Webシートには、任意の数のページを含めることができます。

「ページ・ディレクトリ」にアクセスするには、次のステップを実行します。

1. Webシートにログインし、Webシートを実行します。「Webシートの実行」を参照してください。

2. 「表示」メニューから、「ページ・ディレクトリ」を選択します。
「ページ・ディレクトリ」は、対話モード・レポートとして表示されます。対話モード・レポートおよび「アクション」メニューの使用の詳細は、「対話モード・レポートのカスタマイズ」および「「アクション」メニューについて」を参照してください。

デフォルトでは、ページ・ディレクトリはアイコン・ビューで表示されます。

図websheet_pg_dir1.gifに関する説明

各Webシート内の1ページが、ホームページとして指定されます。ホームページは、Webシートの実行時に表示される開始ページです。アイコン・ビューでは、ホームページは、オレンジの家の輪郭を持つページとして表示されます。

3. レポートとしてページを表示するには、「レポートの表示」アイコンをクリックします。
デフォルトでは、レポート・ビューに「名前」、「ドキュメント・タイプ」、「作成」、「作成者」、「更新日」、「更新者」、「親ページ」および「親の親ページ」が表示されます。

4. 新しいページを作成するには、「ページの作成」をクリックします。

ヒント:
Webシートのホームページは、Webシート・プロパティ・ページで指定します。「Webシート・プロパティの編集」を参照してください。

ページ履歴の表示

「ページ履歴」を使用して、カレント・ページに対するすべての変更のログを表示します。

「ページ履歴」を表示するには、次のステップを実行します。

1. Webシートにログインし、Webシートを実行します。「Webシートの実行」を参照してください。

2. ページを選択します。

3. 「表示」メニューから、「ページ履歴」を選択します。
「ページ履歴」は、対話モード・レポートとして表示されます。

検索バーがページの上部に表示されます。使用可能なコントロールは次のとおりです。

- 検索列の選択: 虫めがねに似ています。このアイコンをクリックして、検索を絞り込みます。すべての列を検索するには、「すべての列」を選択します。

- テキスト領域: 名前でページ・グループを検索するための大/小文字を区別しない検索基準(ワイルドカード文字は暗黙的に定義される)を入力し、「実行」をクリックします。

- 「実行」ボタン: 検索を実行したり、フィルタを適用します。

- アイコンの表示: 各Webシートを大きいアイコンとして表示します。

- レポートの表示: 各Webシートをレポート内の1行として表示します。

- 「アクション」メニュー: 「アクション」メニューを使用して、レポート・ビューをカスタマイズします。「「アクション」メニューについて」を参照してください。

4. 変更をカレンダ形式で表示するには、「カレンダ」をクリックします。

Webシート・ディレクトリの表示

Webシート・ディレクトリを使用して、別のWebシート・アプリケーションにナビゲートします。

関連項目:
「Webシート・プロパティの編集」

Webシート・ディレクトリにアクセスするには、次のステップを実行します。

1. Webシートにログインし、Webシートを実行します。「Webシートの実行」を参照してください。

2. 「表示」メニューから、「Webシート・ディレクトリ」を選択します。
検索バーがページの上部に表示されます。使用可能なコントロールは次のとおりです。

- 検索列の選択: 虫めがねに似ています。このアイコンをクリックして、検索を絞り込みます。すべての列を検索するには、「すべての列」を選択します。

- テキスト領域: 名前でページ・グループを検索するための大/小文字を区別しない検索基準(ワイルドカード文字は暗黙的に定義される)を入力し、「実行」をクリックします。

- 「実行」ボタン: 検索を実行したり、フィルタを適用します。

- アイコンの表示: 各Webシートを大きいアイコンとして表示します。

- レポートの表示: 各Webシートをレポート内の1行として表示します。

- 「アクション」メニュー: 「アクション」メニューを使用して、レポート・ビューをカスタマイズします。「「アクション」メニューについて」を参照してください。

3. Webシートを表示するには、次のステップを実行します。

- アイコン・ビューで、該当するアイコンをクリックします。

- レポート・ビューで、「アクション」列の「実行」アイコンをクリックします。

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

このセクションでは、アプリケーション・ビルダーを使用して動的にレンダリングされるアプリケーションを構築する方法について、重要なバックグラウンド情報を説明します。

内容は次のとおりです。

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

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

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

関連項目:
「クイック・スタート」、「アプリケーション・ビルダーの概念」、「データベース・アプリケーションについて」、「ページ・レイアウトの制御」および「ナビゲーションの追加」

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

アプリケーションは、タブ、ボタンまたはハイパーテキスト・リンクを使用して相互にリンクされた、データベース・ドリブンのWebページのコレクションです。アプリケーション内のページは、共通のセッション・ステート定義および認証方式を共有します。アプリケーション・ビルダーは、アプリケーションを構成するページを構築するためのツールです。

アプリケーション・ビルダーにアクセスするには、次のステップを実行します。

1. Oracle Application Expressにログインします。「Oracle Application Expressへのログイン」を参照してください。
「ワークスペース」ホームページが表示されます。

2. 「アプリケーション・ビルダー」アイコンをクリックします。
「アプリケーション・ビルダー」ホームページが表示されます。

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

アプリケーション・ビルダーのホームページには、インストールされているすべてのアプリケーションが表示されます。アプリケーションは、データベース・アプリケーションとWebシート・アプリケーションの2つのカテゴリに分類されます。詳細は、「データベース・アプリケーションとWebシート・アプリケーションの違いの理解」を参照してください。

アプリケーション・ビルダーのホームページ上部にあるタブを使用して、表示するアプリケーションのタイプを選択できます。使用可能なタブは、「すべてのアプリケーション」、「データベース・アプリケーション」、「Webシート・アプリケーション」および「パッケージ・アプリケーション」です。パッケージ・アプリケーションの詳細は、「パッケージ・アプリケーションの使用」を参照してください。

app_bldr_home.gifの説明

アプリケーション・ビルダーのホームページの外観は、ページ上部にある検索バーを使用してカスタマイズできます。使用可能なコントロールは次のとおりです。

- 「検索」アイコン: 虫めがねに似ています。このアイコンをクリックして、検索を特定の列のみに絞ります。すべての列を検索するには、「すべての列」を選択します。

- テキスト領域: 大/小文字を区別しない検索基準(ワイルドカード文字は暗黙的に定義される)を入力し、「実行」をクリックします。

- 「実行」ボタン: 検索を実行したり、フィルタを適用します。

- アイコンの表示(デフォルト): 各アプリケーションをアプリケーション名で識別される大きいアイコンとして表示します。

- レポートの表示: 各アプリケーションをレポート内の1行として表示します。各行には、アプリケーションID、アプリケーション名、アプリケーションの最終更新日、ページ・カウントおよびアプリケーションの最終更新者が含まれます。

- ビューの詳細: 各アプリケーションに関する詳細情報を表示します。

- アクション・メニュー: アクション・メニューを表示します。レポート・ビューをカスタマイズするにはこのメニューを使用します。「「アクション」メニューについて」を参照してください。

次のボタンがナビゲーション・バーの右側に表示されます。

- リセット: 「リセット」をクリックすると、ページがデフォルト表示に戻ります。

- インポート: 「インポート」をクリックすると、エクスポートされたアプリケーション・ファイルがインポートされます。「エクスポート・ファイルのインポート」を参照してください。

- 作成: 「作成」をクリックすると、アプリケーションが作成されるか、デモンストレーション・アプリケーションがインストールされます。詳細は、「アプリケーションの作成ウィザードについて」を参照してください。

「タスク」リストについて

「タスク」リストがアプリケーション・ビルダーのホームページの右側に表示されます。

appbldr_task_list.gifの説明

「タスク」リストには次のリンクが含まれます。

- アプリケーション・ビルダーのデフォルト値: Oracle Application Express管理ガイドの「アプリケーション・ビルダーのデフォルト値の利用」を参照してください。

- アプリケーション・グループ: 「アプリケーション・グループの作成」を参照してください。

- ワークスペース・テーマ: 「ワークスペース・テーマの管理」を参照してください。

- アプリケーション間レポート: 「アプリケーション・ユーティリティおよびレポートの表示」を参照してください。

- Application Expressビュー: 「Application Expressビューについて」を参照してください。

- エクスポート: 「アプリケーションおよび関連ファイルのエクスポート」を参照してください。

「最近」について

最近のリストには、最近表示されたアプリケーションへのリンクが含まれます。

移行について

Oracle Application Expressのアプリケーション移行ワークショップにリンクしています。このツールを使用すると、Microsoft AccessアプリケーションをOracle Application Expressアプリケーションに移行したり、Oracle FormsアプリケーションをOracle Application Expressアプリケーションに変換できます。詳細は、Oracle Application Expressアプリケーション移行ガイドを参照してください。

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

特定のアプリケーションを表示するには、アプリケーション・ビルダーのホームページでそのアプリケーションを選択します。「アプリケーション」ホームページが表示されます。アプリケーションIDおよびアプリケーション名がページの上部に表示されます。アプリケーション定義にリンクするには、「アプリケーション・プロパティの編集」ボタンをクリックします。

関連項目:
「アプリケーション定義の編集」

図bldr_hm_top.gifの説明

続いて、次の大きいアイコンが表示されます。

- アプリケーションの実行: カレント・アプリケーションのホームページをApplication Expressエンジンに送信し、表示可能なHTMLをレンダリングします。詳細は、「Application Expressエンジンによるページのレンダリング方法および処理方法」を参照してください。

- サポートするオブジェクト: サポートするオブジェクト・ページにリンクします。「カスタム・パッケージ・アプリケーションの作成方法」を参照してください。

- 共有コンポーネント: アプリケーション内のすべてのページに表示または適用できる共有コンポーネントおよびユーザー・インタフェース・コントロールのリストにリンクします。詳細は、「共有コンポーネントでの作業」を参照してください。

- ユーティリティ: ユーティリティ・ページにリンクします。このページを使用して、開発者アクティビティの監視、ダッシュボードの表示、アドバイザの実行およびその他数多くのレポートの表示を行います。詳細は、「アプリケーション・ビルダー・ユーティリティの使用」を参照してください。

- エクスポート/インポート: エクスポート/インポート・ウィザードにリンクします。このウィザードを使用して、アプリケーション全体のインポートとエクスポート、およびカスケード・スタイルシート、イメージ、静的ファイル、スクリプト・ファイル、テーマ、ユーザー・インタフェースのデフォルト値、ワークスペース・ユーザーなどの関連ファイルのインポートとエクスポートを行うことができます。詳細は、「アプリケーションおよび関連ファイルのエクスポート」を参照してください。

「アプリケーション・プロパティの編集」ボタンについて

「アプリケーション・プロパティの編集」ボタンは、アプリケーションIDおよび名前の右側に表示されます。「アプリケーション・プロパティの編集」をクリックすると、アプリケーション定義を編集できます。「アプリケーション定義の編集」を参照してください。

「ページの作成」ボタンについて

「ページの作成」をクリックすると、アプリケーション内にページを作成できるウィザードが起動します。「「アプリケーション」ホームページからのページの作成」を参照してください。

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

ナビゲーション・バーは「アプリケーション」ホームページの中央に表示されます。これらのコントロールを使用して、ページを検索したり、ページ・ビューをカスタマイズできます。

図bldr_hm_nav.gifの説明

「アプリケーション」ホームページのナビゲーション・バーには次のコントロールが含まれます。

- 「検索」アイコン: 虫めがねに似ています。このアイコンをクリックして、検索を特定の列のみに絞ります。すべての列を検索するには、「すべての列」を選択します。

- テキスト領域: 大/小文字を区別しない検索基準(ワイルドカード文字は暗黙的に定義される)を入力し、「実行」をクリックします。

- 「実行」ボタン: 検索を実行したり、フィルタを適用します。

- アイコンの表示: これらのアイコンを使用して、3つのビュー間を切り替えます。

- アイコンの表示(デフォルト): 各ページをページ名で識別される大きいアイコンとして表示します。

- レポートの表示: 各ページをレポート内の1行として表示します。各行には、ページID、ページ名、ページの最終更新日、ページの最終更新者、ページ・タイプ、ユーザー・インタフェースの分類およびグループが含まれます。

- 詳細の表示: 各ページの詳細情報を表示します。

関連項目:
「ページの表示方法の理解」

- アクション・メニュー: アクション・メニューを表示します。レポート・ビューをカスタマイズするにはこのメニューを使用します。「「アクション」メニューについて」を参照してください。

「タスク」リストについて

「タスク」リストが「アプリケーション」ホームページの右側に表示されます。

bldr_task_list.gifの説明

「タスク」リストには次のリンクが含まれます。

- このアプリケーションの削除: カレント・アプリケーションを削除します。詳細は、「データベース・アプリケーションの削除」を参照してください。

- このアプリケーションのコピー: カレント・アプリケーションのコピーを作成します。詳細は、「データベース・アプリケーションのコピー」を参照してください。

- アイコンの非表示: 「アプリケーション」ホームページ上部に表示されるアイコンを非表示にします。「「アプリケーション」ホームページについて」を参照してください。このリンクは、アイコンが現在表示されているかどうかに応じて、「アイコンの非表示」と「アイコンの表示」に切り替わります。

ページの表示方法の理解

「アプリケーション」ホームページの表示方法を制御するには、「アイコンの表示」アイコン、「レポートの表示」アイコンまたは「詳細の表示」アイコンを選択します。

アイコンの表示(デフォルト): 各ページをアイコンとして表示します。

図bldr_hm_icons.gifの説明

「レポート」モードでは、各ページがレポート内の1行として表示されます。各行にはページ番号、ページ名、ページの最新更新時、更新者、ページ・タイプ、関連グループおよびロック・ステータスが含まれます。ページを表示するには、ページIDをクリックします。「ロック」アイコンをクリックすると、アプリケーション開発中の競合を回避できます。「実行」アイコンをクリックすると、関連ページが実行され、表示可能なHTMLがレンダリングされます。

bldr_hm_pglist.gifの説明

関連項目:
「ページのロックおよびロック解除」および「アプリケーションまたはページの実行」

「詳細の表示」では、個別のリージョンに各ページの詳細情報が表示されます。「実行」アイコンをクリックすると、関連ページが実行され、表示可能なHTMLがレンダリングされます。「編集」をクリックすると、「ページ定義」が表示されます。「ロック」アイコンをクリックすると、アプリケーション開発中の競合を回避できます。

図bldr_hm_details.gifの説明

最近編集されたページについて

「最近」リストには、カレント・アプリケーション内の最近編集されたページへのリンクが含まれています。特定のページにリンクするには、ページIDおよびページ名をクリックします。

開発者アクション・バーについて

開発者アクション・バーは、アプリケーション・ビルダーのほとんどのページで、右上隅にある「検索アプリケーション」フィールドの下に表示されます。

図bldr_hm_search_app.gifの説明

開発者アクション・バーには、いくつかのアイコンが含まれています。表示されるアイコンは、アプリケーション・ビルダーのどのページを表示しているかによって異なります。「ページの実行」アイコン、「ページの編集」アイコン、「開発者のコメント」アイコンおよび「検索」アイコンは、共有コンポーネントを作成および管理するページなど、アプリケーション・ビルダーの多くのページに表示されることに注意してください。「共有コンポーネントでの作業」を参照してください。

「ページの実行」アイコン

run_ico_green.gifの説明

「ページの実行」アイコンは、右矢印の形をしています。このアイコンをクリックすると、カレント・ページの表示可能なHTMLがレンダリングされます。ページを選択せずにこのアイコンをクリックすると、アプリケーションの最初のページが実行されます。ページを実行すると、Application Expressエンジンにより、データベースに格納されたデータに基づいてページが動的にレンダリングされます。「アプリケーションまたはページの実行」を参照してください。

「ページの編集」アイコン

図edit_icon.gifの説明

「ページの編集」アイコンは、小さい紙と鉛筆の形をしています。このアイコンをクリックすると、カレント・ページの「ページ定義」にアクセスできます。ページを選択せずにこのアイコンをクリックすると、アプリケーションの最初のページの「ページ定義」が表示されます。詳細は、「「ページ定義」について」を参照してください。

「共有コンポーネント」アイコン

図shared_comp_icon_2.gifの説明

「共有コンポーネント」アイコンは、小さな機械の歯車のような形をしています。このアイコンをクリックすると、アプリケーション内のすべてのページに表示または適用できる共有コンポーネントおよびユーザー・インタフェース・コントロールのリストが表示できます。「共有コンポーネントでの作業」を参照してください。

「アプリケーション・ユーティリティ」アイコン

図check_page_ico.gifの説明

「アプリケーション・ユーティリティ」アイコンは、4つの小さいボックスのような形をしています。このアイコンをクリックすると、ユーティリティ・ページにリンクします。ユーティリティ・ページは、アプリケーション全体の情報のサマリーを表示し、便利なツールへのアクセスを提供します。「アプリケーション・ビルダー・ユーティリティの使用」を参照してください。

「開発者のコメント」、「バグ」または「To Do」アイコン

図dev_comment_icon.gifの説明

「開発者のコメント(バグまたはTo Do)」アイコンは、プラス記号の付いた吹出しの形をしています。このアイコンをクリックして、開発者のコメント、バグまたはTo Doエントリを作成します。「開発者コメントの追加」、「バグの管理」および「To Doの追跡」を参照してください。

「検索」アイコン

図find_icon_2.gifの説明

「検索」アイコンは懐中電灯の形をしています。このアイコンをクリックすると、カレント・アプリケーション内のアイテム、ページ、問合せ、表、PL/SQL、イメージおよびカスケード・スタイルシート(CSS)またはワークスペースに関連付けられたスキーマを検索できます。「「検索」アイコンの使用」を参照してください。

「ヘルプ」アイコン

図help_icon.gifの説明

「ヘルプ」アイコンは疑問符の形をしています。「ヘルプ」アイコンをクリックすると、ドキュメントおよびチュートリアル・ページが表示されます。ライブラリ全体を表示するには、ライブラリ全体HTMLリンクをクリックするか、特定のHTMLまたはPDFリンクをクリックします。「Oracle Application Expressのドキュメントについて」を参照してください。

ページ・メタデータの検索

「検索アプリケーション」フィールドは開発者アクション・バーの上に表示されます。

図bldr_hm_search_app.gifの説明

このフィールドを使用して、アプリケーション内のメタデータを大/小文字を区別して検索します。このフィールドでは、正規表現がサポートされます。

特定のページをすばやく表示するには、application:pageまたはapplication-pageの書式を使用してアプリケーションおよびページ番号を入力し、[ENTER]を押します。次に例を示します。

4000-100
4000:100

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

この項では、アプリケーション・ビルダーを使用して、データベース・アプリケーションとアプリケーション・コンポーネントを構築する方法について説明します。アプリケーションの作成ステップ、ページの追加ステップ、およびコンポーネント(レポート、チャートまたはフォーム)、ページ・コントロール(ボタン、アイテムまたはLOV)および共有コンポーネント(ブレッドクラム、リストまたはタブ)の追加ステップについて説明します。Oracle Application Expressに付属のパッケージ・アプリケーションやサンプル・アプリケーションの表示の詳細は、「パッケージ・アプリケーションの使用」を参照してください。

内容は次のとおりです。

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

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

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

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

- 開発者コメントの追加

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

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

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

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

関連項目:
「データベース・アプリケーションとWebシート・アプリケーション間の違いの理解」、「アプリケーション・ビルダーの使用」、「レポートの作成」、「ページ・レイアウトの制御」および「ナビゲーションの追加」

データベース・アプリケーションの作成について

アプリケーションの作成ウィザードを使用すると、レポート、対話モード・レポート、フォーム、表形式フォーム、マスター・ディテール・フォームなどの複数のページを含む完全なアプリケーションを作成できます。アプリケーションの作成ウィザードは、基本的なOracle Application Expressアプリケーションを簡単かつ迅速に作成できるように設計されています。このウィザードを使用してアプリケーションを作成した後、ページを変更したり、ページの作成ウィザードを使用してページを追加できます。「データベース・アプリケーションのページの作成について」を参照してください。

アプリケーションの作成ウィザードを使用して、空白ページや、SQL問合せまたは既存のデータベース表に基づくページを作成できます。表に基づいたアプリケーションは簡易レポート、フォームとレポート、または表形式フォームで構成されます。詳細は、「フォームの作成」を参照してください。SQL問合せは、手動でSQLを入力しても、「クエリー・ビルダー」のGUIを使用しても、どちらでも作成できます。

ワークスペースレベルでは、その表領域で構築されたアプリケーションに使用されるデフォルト値を設定するオプションがあります。これらのデフォルト値を設定すると、各ステップを介さずにウィザードを終了できます。ウィザードを終了する場合、ユーザーが作成したアプリケーションは、ユーザーがデフォルトとして指定した値を使用します。

関連項目:
『Oracle Application Express SQLワークショップ・ガイド』の「クエリー・ビルダーを使用した問合せの構築」および『Oracle Application Express管理ガイド』の「アプリケーション・ビルダーのデフォルト値の利用」

内容は次のとおりです。

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

- スプレッドシートからのアプリケーションの作成

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

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

- サンプル・アプリケーションのインストール

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

- アプリケーション・モデルとユーザー・インタフェースのデフォルト値について

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

表、問合せまたはドリルダウン問合せに基づいてデータベース・アプリケーションを作成するには、アプリケーションの作成ウィザードで「データベース」を選択します。アプリケーションの作成ウィザードを実行する場合の重要な決定ポイントは、ターゲット・ユーザー・インタフェースの選択です。選択したユーザー・インタフェースに基づいて、適切なページ・タイプ、属性およびテーマを表示するようにウィザードが最適化されます。

関連項目:
「データベース・アプリケーションのページの管理」

表、問合せまたはドリルダウン問合せに基づいたデータベース・アプリケーションを作成するには、次のステップを実行します。

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

2. 「作成」ボタンをクリックします。

3. 「方法」で、「データベース」を選択し、「次へ」をクリックします。

4. 「名前」で、次のステップを実行します。

1. アプリケーション: アプリケーションを識別するための一意の整数値を入力します。3000から9000の間のアプリケーションIDは、Oracle Application Expressの内部使用向けに予約されていることに注意してください。

2. 名前: アプリケーションを識別するための名前を入力します。

3. スキーマ: アプリケーションは、すべてのSQLを特定のデータベース・スキーマとして解析することで、権限を取得します。データベース・スキーマ所有者を指定します。

4. 作成オプションを指定します。

- 最初から開始: すべてのページを手動で追加できるようにします。

- ホームページを含める: 追加された新しいページの親として自動的に機能する空白ページを含みます。リスト・リージョンもホーム・ページに作成され、追加ページへのナビゲーションが用意されます。

- 以前作成したアプリケーション・モデルを使用: 既存のアプリケーション定義を再利用します。既存のアプリケーション定義を使用すると、アプリケーションのプロパティ値を再入力せずに、このウィザードを実行できます。
それでもまだ他のアプリケーション属性はすべて定義する必要がありますが、一部の属性は、別のアプリケーションから共有コンポーネントをコピーすることによってコピーすることもできます(「アプリケーション・モデルとユーザー・インタフェースのデフォルト値について」を参照)。

5. ユーザー・インタフェース: アプリケーションのユーザー・インタフェースを選択します。主としてデスクトップで使用するために設計するアプリケーションの場合は、「デスクトップ」を選択します。

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

ヒント:
ログイン・ページと空白ページのみで構成されるインスタント・アプリケーションを作成するには、「アプリケーションの作成」をクリックします。

次に、ページをアプリケーションに追加します。

5. 「ページ」で、追加するページのタイプを選択します。

1. 追加するページのタイプを選択します。
表7-1に、ターゲット・ユーザー・インタフェース(デスクトップおよびjQuery Mobileスマートフォン)別に使用可能なページ・タイプをリストします。

表7-1 アプリケーションの作成ウィザードで使用可能なページ・タイプ

ページ・タイプ

説明

デスクトップ

jQuery Mobileスマートフォン

空白

組込み機能のないページを作成します。

使用可能

使用可能

リスト・ビュー

SQL問合せの書式設定された結果を含むページを作成します。リスト・ビューを組み込む表を選択し、リスト・ビューの表示情報に使用する列を選択できます。

適用なし

使用可能

レポート

SQL問合せの書式設定された結果を含むページを作成します。選択した表に基づいてレポートを作成するか、カスタムSQL SELECT文または指定したSQL SELECT文を戻すPL/SQLファンクションに基づいてレポートを作成するかを選択できます。

注意: jQuery Mobileスマートフォンはクラシック・レポートのみサポートしています。

使用可能

使用可能

リスト・ビューとフォーム

2ページのリスト・ビューとフォームの組合せを構築します。1ページ目では、リスト・ビューから更新する行を選択します。2ページ目では、選択した表またはビューを更新できます。

適用なし

使用可能

レポートとフォーム

2ページのレポートとフォームの組合せを構築します。1ページ目では、更新する行を選択します。2ページ目では、レコードを追加するか、あるいは既存のレコードの更新または削除を行うことができます。

使用可能

使用可能

フォーム

データベース表の単一行を更新するフォームを作成します。

使用可能

使用可能

表形式フォーム

データベース表の複数の行に対して更新、挿入および削除を行うフォームを作成します。

使用可能

適用なし

マスター・ディテール

2ページのレポートとフォームの組合せを構築します。1ページ目では、更新する行を選択します。2ページ目では、選択した表またはビューと関連するディテールを更新できます。

使用可能

適用なし

チャート

SQL問合せの結果を表すチャートを含むページを作成します。

使用可能

使用可能

アクション: 現在選択済のページ・タイプが表示されます。選択ごとに、表名の選択、レポート実装など異なる情報のタイプが求められます。詳細は、アイテムのヘルプを参照してください。

2. 「ページの追加」をクリックします。
ページがページ上部に表示されます。ページを削除するには、「削除」アイコンをクリックします。

3. すべてのページが追加されるまで前のステップを繰り返します。

4. 「次へ」をクリックします。

ヒント:
ウィザードを早期に終了して「アプリケーション・ビルダーのデフォルト値」を使用するには、「アプリケーションの作成」ボタンをクリックします。「アプリケーション・ビルダーのデフォルト値」を構成するには、Oracle Application Express管理ガイドの「アプリケーション・ビルダーのデフォルト値の利用」を参照してください。

6. 「共有コンポーネント」で、共有コンポーネントを別のアプリケーションからコピーするかどうかを指定します。「はい」または「いいえ」を選択します。「はい」を選択した場合は、そのコピー元と、インポートするコンポーネントを選択します。
共有コンポーネントは、アプリケーション内の複数のページ間で表示または適用できる共通アプリケーション要素です。時間を節約するため、またはアプリケーション間の一貫性を保持するために、共有コンポーネントは既存のアプリケーションからコピーします。コピーできる共有コンポーネントのタイプには、ユーザー・インタフェースのテーマ、LOV、ナビゲーション・バー・エントリ、認可スキームおよび認証スキームがあります。

7. 「属性」で、次のステップを実行します。

1. 認証スキーム: アプリケーションにアクセスする前にユーザー・アイデンティティを確立する方法を決定します。オプションは次のとおりです。

- Application Express: Application Expressサービス管理アプリケーションで作成および保持されるユーザー・アカウント資格証明を使用します。これらは、Application Express開発環境へのログインに使用するアカウントです。また、アプリケーションのエンド・ユーザー用として、このユーザー・アカウント・リポジトリにアカウントを作成することもできます。

- データベース・アカウント: アプリケーションへのユーザー・ログインには、認証するためにデータベース・スキーマ名(またはユーザー名)とそのパスワードが必要です。このアカウント情報は、Oracle Database全体で管理されます。

- 認証なし: データベース・アカウント資格証明とも呼ばれます。このオプションを使用すると、ユーザーはmod_plsql DAD定義に格納されているアカウント資格証明を使用して、アプリケーションにアクセスできるようになります。ほとんどの場合、アプリケーションへのアクセス時にログインを行う必要がなくなります。これは、公開アプリケーションを最も速く作成する方法です。

詳細は、「認証によるユーザー・アイデンティティの証明」を参照してください。

2. タブ: アプリケーションにタブを含めるかどうかを選択します。1レベルのタブ、2レベルのタブまたはタブなしで作成できます。詳細は、「タブの作成」を参照してください。
アプリケーションを開発する言語をこの属性で指定します。この言語が、すべての変換の元となるベース言語になります。

3. 言語: このアプリケーションのプライマリ言語を選択します。
アプリケーションを開発する言語をこの属性で指定します。この言語が、すべての変換の元となるベース言語になります。

4. ユーザー言語プリファレンスの派生元: エンジンによるアプリケーション言語の決定方法を指定します。アプリケーションのプライマリ言語は静的にする(Webブラウザの言語から派生される)か、またはユーザー・プリファレンスまたはアイテムから決定されるようにできます。データベース言語の設定では、日付の表示とソート特性を決定します。詳細は、アイテムのヘルプを参照してください。
「言語」および「ユーザー言語プリファレンスの派生元」属性は、グローバリゼーション属性の編集ページで後から変更できます。「グローバリゼーション属性の設定」を参照してください。

5. 日付書式: アプリケーションで使用する日付書式を指定します。
この日付書式を使用して、NLS_DATE_FORMATデータベース・セッションの設定が変更されてから、アプリケーション内のページが表示または送信されます。この値には、有効なOracle日付書式マスクを含むリテラル文字列、または置換構文によるアイテム参照を指定できます。値が指定されていない場合は、データベース・セッションからデフォルトの日付書式が実行時に取得されます。指定されている場合は、DATE型の列から得られるすべてのアイテムの日付書式としても使用されます。

6. 日時書式: アプリケーションで使用する日時書式を指定します。
この日時書式は、置換参照&APP_DATE_TIME_FORMAT.を使用するか、PL/SQLでv('APP_DATE_TIME_FORMAT')ファンクションを使用して、アプリケーション内で参照できます。この属性によってNLS設定が変更されることはありません。この値には、有効なOracle日付書式マスクを含むリテラル文字列、または置換構文を使用したアイテム参照を指定できます。この属性値を指定しない場合、APP_DATE_TIME_FORMATへの参照はNLSデータベース・セッションの日付書式とNLS時刻書式を返します。

7. タイムスタンプ書式: アプリケーションで使用するタイムスタンプ書式を指定します。
このタイムスタンプ書式を使用して、NLS_TIMESTAMP_FORMATデータベース・セッションの設定が変更されてから、アプリケーション内のページが表示または送信されます。この値には、有効なOracleタイムスタンプ書式マスクを含むリテラル文字列、または置換構文を使用したアイテム参照を指定できます。値が指定されていない場合は、データベース・セッションからデフォルトのタイムスタンプ書式が実行時に取得されます。

8. タイムスタンプ・タイムゾーン書式: アプリケーションで使用されるタイムゾーン付きタイムスタンプ書式を指定します。
このタイムゾーン付きタイムスタンプ書式を使用して、NLS_TIMESTAMP_TZ_FORMATデータベース・セッションの設定が変更されてから、アプリケーション内のページが表示または送信されます。この値には、有効なOracleタイムゾーン付きタイムスタンプ書式マスクを含むリテラル文字列、または置換構文を使用したアイテム参照を指定できます。値が指定されていない場合は、データベース・セッションからデフォルトのタイムゾーン付きのタイムスタンプ書式が実行時に取得されます。

9. 「次へ」をクリックします。

8. 「ユーザー・インタフェースのテーマ」で、テーマを選択し、「次へ」をクリックします。
テーマは、アプリケーション全体のレイアウトおよびスタイルの定義に使用できるテンプレートのコレクションです。「テーマの管理」を参照してください。

9. 選択内容を確認して、「アプリケーションの作成」をクリックします。

スプレッドシートからのアプリケーションの作成

スプレッドシート・データに基づいてアプリケーションを作成するには、アプリケーションの作成ウィザードで「スプレッドシートから」を選択します。

スプレッドシート・データからアプリケーションを作成するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. 「作成」ボタンをクリックします。

3. 「方法」で、「スプレッドシートから」を選択します。
図create_app_spread.gifの説明

4. 「ロード方法」で、スプレッドシート・データのインポート方法を指定します。次のいずれかを選択し、「次へ」をクリックします。

1. ファイルをアップロード(カンマ区切り(*.csv)またはタブ区切り):次の項目を指定し、「次へ」をクリックします。

- テキスト・ファイル: ファイルの選択をクリックし、アップロードされるファイルを指定します。

- 「セパレータ」: カンマ区切り文字を指定します。タブ区切りには\tを使用します。

- 「囲み文字(オプション)」: 区切り文字を入力します。この文字は、データ値の始まりと終わりを区切るために使用できます。区切り文字を指定した場合、データ値の始まりと終わりの前にあるスペースはウィザードで無視されます。このオプションを使用すると、指定した区切り文字でデータ値を囲むこともできます。該当する場合は、「1行目のデータに列名が含まれる」を選択します。

- 「ファイルのキャラクタ・セット」: テキスト・ファイルのエンコードに使用されるキャラクタ・セットを選択します。

2. コピー・アンド・ペースト: インポートするタブ区切りデータをコピーして貼り付けます。

5. 「表のプロパティ」で、次の項目を指定します。

1. スキーマ: データベース・スキーマ所有者を指定します。

2. 表: 作成する表の名前を入力します。

3. 表のプロパティを設定: 表のプロパティを確認します。データ型を変更するか、書式マスクを入力します。「アップロード」リストから「はい」または「いいえ」を選択して、列を含めるかどうかを指定します。

4. 「次へ」をクリックします。

6. 「ユーザー・インタフェースのデフォルト値」で、次のステップを実行します。

1. 表示された単数形の名前および複数形の名前を確認します。

2. (オプション)「列のユーザー・インタフェースのデフォルト値」で、表示された列ラベルを確認します。

3. 「次へ」をクリックします。

7. 「アプリケーション・オプション」で、次の内容を指定します。

1. アプリケーション名: このアプリケーションの名前を英数字で入力します。

2. 作成モード: 次のオプションがあります。

- 読取り専用: ページの挿入および更新は含まれません。

- 読み書き両用: ページの挿入および更新が含まれます。

3. レポート実装:

- クラシック: SQL レポートを作成します。

- 対話モード: 対話モード・レポートを作成します。

4. 「次へ」をクリックします。

8. 「ユーザー・インタフェースのテーマ」で、テーマを選択し、「次へ」をクリックします。
テーマは、アプリケーション全体のレイアウトおよびスタイルの定義に使用できるテンプレートのコレクションです。「テーマの管理」を参照してください。

9. 選択内容を確認して、「アプリケーションの作成」をクリックします。

データベース・アプリケーションのコピー

アプリケーションの作成ウィザードを実行するか、「アプリケーション」ホームページでアプリケーションを選択してから「このアプリケーションのコピー」を選択することによって、既存のアプリケーションのコピーを作成できます。

内容は次のとおりです。

- アプリケーションの作成ウィザードを使用したデータベース・アプリケーションのコピー

- 「アプリケーション」ホームページからのアプリケーションのコピー

アプリケーションの作成ウィザードを使用したデータベース・アプリケーションのコピー

アプリケーションの作成ウィザードを実行してアプリケーションをコピーするには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. 「作成」ボタンをクリックします。

3. 既存のアプリケーションのコピーを選択します。
図create_app_wiz_copy.gifの説明

4. 「方法」で、「既存アプリケーションのコピーとして保存」リンクをクリックします。

5. 「コピーのターゲットを指定」で、次のステップを実行します。

1. コピー元: コピーするアプリケーションの名前を選択します。

2. コピー先: アプリケーションの説明的な短い名前を入力し、選択リストおよびレポートで新しいアプリケーションを識別できるようにします。

3. 新しいアプリケーションID: アプリケーションを識別するための一意の整数値を入力します。3000から9000の間のアプリケーションIDは内部使用向けに予約されています。

4. サポートするオブジェクトの定義のコピー: サポートするオブジェクトの定義を含めるかどうかを指定します。オプションは次のとおりです。

- はい: データベース・オブジェクト定義、イメージ定義、およびシード・データSQL文を単一のファイルにカプセル化して含めます。

- いいえ: サポートするオブジェクトの定義を含めません。

5. 「次へ」をクリックします。

6. 「アプリケーションの作成」をクリックします。

「アプリケーション」ホームページからのアプリケーションのコピー

「アプリケーション」ホームページからデータベース・アプリケーションをコピーするには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。
「アプリケーション」ホームページが表示されます。

3. 「タスク」リストで「このアプリケーションのコピー」をクリックします。

4. 「コピーのターゲットを指定」で、次の手順を実行します。

1. 新しいアプリケーションID: アプリケーションを識別するための一意の整数値を入力します。3000から9000の間のアプリケーションIDは内部使用向けに予約されています。

2. 新しいアプリケーション名: アプリケーションの説明的な短い名前を入力し、選択リストおよびレポートで新しいアプリケーションを識別できるようにします。

3. サポートするオブジェクトの定義のコピー: サポートするオブジェクトの定義を含めるかどうかを指定します。オプションは次のとおりです。

- はい: データベース・オブジェクト定義、イメージ定義、およびシード・データSQL文を単一のファイルにカプセル化して含めます。

- いいえ: サポートするオブジェクトの定義を含めません。

4. 「次へ」をクリックします。

5. 「アプリケーションのコピー」をクリックします。

テンプレートからのデータベース・アプリケーションの作成

Oracle Application Expressインスタンス全体のテンプレート・アプリケーション・リポジトリは、インスタンス管理者が管理します。開発者は、テンプレート・アプリケーション・リポジトリに格納されているテンプレート・アプリケーションに基づいて、堅牢なアプリケーションを作成できます。

リポジトリからアプリケーション・テンプレートを追加または削除できるのは、インスタンス管理者のみです。テンプレート・アプリケーションを作成するには、インスタンス管理者はまずアプリケーションをエクスポートしてから、テンプレート・アプリケーション・リポジトリにそれを追加する必要があります。

関連項目:
『Oracle Application Express管理ガイド』のテンプレート・アプリケーションの管理に関する説明

テンプレート・アプリケーションに基づいてアプリケーションを作成するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. 「作成」ボタンをクリックします。

3. 「方法」で、「アプリケーション・テンプレートから」を選択します。
図create_app_wiz_temp.gifの説明

4. 「アプリケーションの選択」で、次のステップを実行します。

1. アプリケーション・タイプ: 新しいアプリケーションの基にするテンプレート・アプリケーションのタイプを選択します。「データベース」または「Webシート」のいずれかを選択します。

2. テンプレート・アプリケーション: 新しいアプリケーションの基にするテンプレート・アプリケーションの名前を選択します。

3. 名前: アプリケーションの説明的な短い名前を入力し、選択リストおよびレポートで新しいアプリケーションを識別できるようにします。

4. アプリケーション: アプリケーションを識別する整数値を指定します。アプリケーションIDは、Application Expressインスタンス内で一意である必要があります。
3000から9000の範囲内のアプリケーションIDは、Application Expressによる内部使用向けに予約されています。

5. スキーマ: アプリケーションは、すべてのSQLを特定のデータベース・スキーマとして解析することで、権限を取得します。データベース・スキーマ所有者を指定します。このオプションは、「アプリケーション・タイプ」で「データベース」を選択している場合にのみ表示されます。

6. 「次へ」をクリックします。

5. 選択内容を確認して、「アプリケーションの作成」をクリックします。

サンプル・アプリケーションのインストール

Oracle Application Expressには、多数のサンプル・アプリケーションが含まれています。サンプル・アプリケーションをそのままの状態でインストール、実行および使用するか、これらを分析して、アプリケーション・ビルダーを使用した特定の機能タイプの構築方法をよりよく理解することができます。

関連項目:
「パッケージ・アプリケーションの使用」

サンプル・アプリケーションをインストールするには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. 「作成」ボタンをクリックします。

3. 「方法」で、「サンプル・アプリケーションのインストール」を選択します。
図create_app_wiz_sample.gifの説明

パッケージ・アプリケーション・ページが表示されます。

図create_app_install_sampl.gifの説明

アプリケーション・タイトルの下にアプリケーション・カテゴリ(「サンプル・アプリケーション」など)が表示されていることに注意してください。製品カテゴリの下に表示されている緑色の「インストール済」タグで、インストール済のアプリケーションを識別できます。

図packapp_installed.gifの説明

4. インストールするアプリケーションを探します。

5. アプリケーション・イメージをクリックします。
サマリー・ページが表示されます。

6. 「アプリケーションのインストール」をクリックします。

7. 認証スキームを選択し、「次へ」をクリックします。

8. もう一度、「アプリケーションのインストール」をクリックします。
成功メッセージが表示されます。

9. アプリケーションを実行するには、「アプリケーションの実行」アイコンをクリックします。

10. 適切なログイン資格証明を入力します。

1. ユーザー名: ワークスペース・ユーザー名を入力します。

2. パスワード: ワークスペース・パスワードを入力します。

3. 「ログイン」をクリックします。

データベース・アプリケーションの削除

アプリケーションの削除は、アプリケーション・ビルダー内から行うことができます。または、アプリケーション属性の編集中にも削除できます。アプリケーションを削除すると、定義されたコンポーネント(レポート、チャートまたはフォーム)、ページ・コントロール(ボタン、アイテムまたはLOV)および共有コンポーネント(ブレッドクラム、リストおよびタブ、ただし、ユーザー・インタフェースのデフォルト値を除く)もすべて削除されます。

関連項目:
「サポートするオブジェクトの削除」

内容は次のとおりです。

- アプリケーション・ビルダーのホームページからのアプリケーションの削除

- アプリケーション定義の編集ページからのアプリケーションの削除

関連項目:
「サポートするオブジェクトの削除」

アプリケーション・ビルダーのホームページからのアプリケーションの削除

アプリケーション・ビルダーからアプリケーションを削除するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. アプリケーション・ビルダーが表示されたら、ページ上部のアプリケーションIDおよびアプリケーション名を確認します。

4. 「タスク」リストで「このアプリケーションの削除」をクリックします。

5. プロンプトが表示されたら、「今すぐ完全に削除」をクリックします。

アプリケーション定義の編集ページからのアプリケーションの削除

アプリケーション定義の編集ページからアプリケーションを削除するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. アプリケーション名の右側にある「アプリケーション・プロパティの編集」ボタンをクリックします。
「アプリケーション定義の編集」ページが表示されます。

4. アプリケーションIDおよびアプリケーション名を確認します。

5. ページの上部の「削除」をクリックします。

6. プロンプトが表示されたら、「今すぐ完全に削除」をクリックします。

関連項目:
「アプリケーション定義の編集」

アプリケーション・モデルとユーザー・インタフェースのデフォルト値について

アプリケーションの作成ウィザードは、開発者が複数回実行するという予測の下に設計されています。この反復アプローチをアプリケーション開発に利用するため、ウィザードを実行するたびに「ページ定義」がアプリケーション・モデルに保存されます。

次の例を想定してください。アプリケーションの作成ウィザードを実行してアプリケーションを作成します。そのアプリケーションを確認して、それが意図していたものと異なることに気付きました。それを変更するかわりに、ウィザードを再度実行してアプリケーション・モデルを選択します。ウィザードの再実行時に既存のアプリケーション・モデルを選択することで、作成したアプリケーションを効率的かつ迅速に改善できます。

関連項目:
Oracle Application Express管理ガイドの「アプリケーション・モデルの管理」

アプリケーションの作成時に生産性を向上させるもう1つの方法として、ユーザー・インタフェースのデフォルト値の指定があります。ユーザー・インタフェースのデフォルト値はメタデータで、ユーザーが指定したスキーマ内の表、列またはビューにデフォルトのユーザー・インタフェースのプロパティを割り当てることを可能にします。

関連項目:
Oracle Application Express SQLワークショップ・ガイドの「ユーザー・インタフェースのデフォルト値の管理」

アプリケーション・モデルとユーザー・インタフェースのデフォルト値の利用

アプリケーション・モデルとユーザー・インタフェースのデフォルト値を利用することで、アプリケーションの作成時の生産性を向上させることができます。次のようなシナリオを想定してください。

1. アプリケーションの作成ウィザードを実行して、表またはビューに基づくアプリケーションを作成します。

2. 生成されたアプリケーションを実行します。機能上の問題がないか注意します。

3. ユーザー・インタフェースのデフォルト値を作成または編集するかどうか検討します。
たとえば、ユーザー・インタフェースのデフォルト値を使用すると、フォーム・フィールドまたはレポート・ラベルの表示方法を制御できます。特定の列を表示したり、列を交互に表示するために、ユーザー・インタフェースのデフォルト値を利用することもできます。

4. アプリケーション・ビルダーのホームページにナビゲートし、「作成」をクリックしてアプリケーションを作成します。

5. 「方法」で、「データベース」を選択します。

6. 「名前」で、次のステップを実行します。

1. アプリケーション: アプリケーションを識別するための一意の整数値を入力します。3000から9000の間のアプリケーションIDはOracle Application Expressによる内部使用向けに予約されています。

2. 名前: アプリケーションを識別するための名前を入力します。

3. スキーマ: アプリケーションは、すべてのSQLを特定のデータベース・スキーマとして解析することで、権限を取得します。データベース・スキーマ所有者を指定します。

4. 作成オプション: 「以前作成したアプリケーション・モデルを使用」を選択します。このオプションでは、既存のアプリケーション定義を再利用します。既存のアプリケーション定義を使用すると、アプリケーションのプロパティ値を再入力せずに、ウィザードを実行できます。
他のすべてのアプリケーション属性を定義する必要があることに注意してください。また、一部の属性は、別のアプリケーションから共有コンポーネントをコピーすることによってコピーすることもできます(「アプリケーション・モデルとユーザー・インタフェースのデフォルト値について」を参照)。

5. ユーザー・インタフェース: アプリケーションのユーザー・インタフェースを選択します。

6. 「次へ」をクリックします。

7. 設計モデルおよび開発者を選択します。
以前ユーザーが作成したページがすでに表示されています。

8. ページの追加、編集または削除を行います。

9. ウィザードを終了します。

10. 目的とする機能上の要件をアプリケーションが満たすまで、ステップ2から9を繰り返します。

アプリケーション属性について

アプリケーション属性は、アプリケーション全体に適用されます。アプリケーションを作成した後、アプリケーション属性を確認し、必要に応じて更新します。

内容は次のとおりです。

- アプリケーション定義の編集

- セキュリティ属性の構成

- グローバリゼーション属性の構成

- アプリケーションのユーザー・インタフェースの管理

関連項目:
サポートするオブジェクト・ユーティリティを使用したパッケージ・アプリケーションの作成方法の詳細は、「カスタム・パッケージ・アプリケーションの作成方法」を参照してください。

アプリケーション定義の編集

アプリケーション定義の編集ページの属性を使用して、アプリケーションの名前と可用性の編集、および静的置換文字列の定義を行うことができます。また、アプリケーション定義の編集ページには、定義済のビルド・オプション、関連するテーマ、テンプレートのデフォルトおよびコンポーネントのデフォルト値が表示されます。必須の値には赤いアスタリスク(*)が付いています。

内容は次のとおりです。

- 定義の編集ページへのアクセス

- アプリケーション定義の編集ページについて

Edit Definitionページへのアクセス

アプリケーション定義を編集するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. アプリケーション名の右側にある「アプリケーション・プロパティの編集」ボタンをクリックします。
図bldr_hm_top.gifの説明

「アプリケーション定義の編集」ページが表示されます。

ナビゲーションの選択肢について

アプリケーション定義の編集ページは、「名前」、「プロパティ」、「可用性」、「エラー処理」、「グローバル通知」、「置換」、「ロゴ」、「ビルド・オプション」、「テーマ」、「テンプレートのデフォルト」および「コンポーネントのデフォルト値」の各セクションに分かれています。これらのセクションにアクセスするには、ページをスクロールするか、ページ上部のナビゲーション・ボタンをクリックします。

図app_attribute_tabs.gifの説明

ページ上部のボタンを選択すると、選択されたセクションが表示され、その他のセクションはすべて一時的に非表示になります。ページのすべてのセクションを表示するには、「すべて表示」をクリックします。

アプリケーション定義の編集ページについて

次のセクションでは、アプリケーション定義の編集ページで使用可能な属性について説明します。

内容は次のとおりです。

- 名前

- プロパティ

- 可用性

- エラー処理

- グローバル通知

- 置換

- ビルド・オプション

名前

「名前」を使用して、アプリケーションの基本特性(アプリケーション名、英数字の別名(オプション)、バージョン番号など)を定義します。表7-2に、「名前」のすべての属性を示します。

表7-2「アプリケーション定義」の「名前」

属性

説明

名前

アプリケーションに説明的な短い名前を指定します。この名前によって、アプリケーションを開発環境に存在する他のアプリケーションと区別します。

アプリケーションの別名

代替の英数字アプリケーション識別子を割り当てます。この識別子をアプリケーションIDに使用できます。

たとえば、アプリケーション105にmyappという別名を作成するとします。この場合、f?p構文を使用して、アプリケーション105を次のいずれかでコールできます。

- f?p=105:1

- f?p=myapp:1

参照: 「f?p構文を使用したページのリンク」

バージョン

アプリケーションのバージョン番号がページに表示されます。次に示す書式マスクを使用して、自動的にバージョンを最終更新日に結び付けることもできます。

- YYYY.MM.DD

- MM.DD.YYYY

- DD.MM.YYYY

アプリケーションのバージョンで「YYYY.MM.DD」を使用している場合、アプリケーション・ビルダーは、この書式マスクをすべてのアプリケーション属性の最終更新日に置換します。

アプリケーション・グループ

このアプリケーションに現在関連付けられているアプリケーション・グループを表示します。別のアプリケーション・グループを選択するには、リストから選択します。既存のグループからアプリケーションを削除するには、「未割当て」を選択します。

参照: 「アプリケーション・グループの作成」

プロパティ

「プロパティ」を使用して、属性「ロギング」、「デバッグ」、「完全置換」、「アプリケーション・グループ」、「フィードバック」および「デフォルトのエラー表示位置」を有効化します。表7-3に、「名前」のすべての属性を示します。

表7-3「アプリケーション定義」の「プロパティ」

属性

説明

ロギング

ユーザー・アクティビティをOracle Application Expressアクティビティ・ログに記録するかどうかを決定します。「はい」に設定した場合、すべてのページ・ビューがログに記録されるため、管理者はアプリケーションごとにユーザー・アクティビティを監視できます。

高容量アプリケーションでは、ロギングを無効にすることをお薦めします。

この属性を変更できるのは、Oracle Application Express管理サービスの「アプリケーション・アクティビティのロギング」属性がアプリケーションの設定を使用に設定されている場合のみです。

関連項目: 『Oracle Application Express管理ガイド』の「ロギング」のアプリケーション・アクティビティの有効化に関する説明

デバッグ

カレント・アプリケーションのデバッグ・モードを制御します。使用可能なオプションは次のとおりです。

- はい: デバッグ・モードでのアプリケーションの実行が有効になります。

- いいえ: エンド・ユーザーはデバッグ・モードでアプリケーションを実行できません。

デバッグ・モードでのアプリケーションの実行は、アプリケーションが開発中の場合に役立ちます。ただし、本番アプリケーションの場合は、デバッグを無効にし、ユーザーがアプリケーション・ロジックを参照できないようにすることをお薦めします。

フィードバックを許可

このアプリケーションに対するエンド・ユーザーのフィードバックへのサポートを有効にします。「はい」または「いいえ」を選択します。

このオプションを有効にする場合は、フィードバック・ページとそのページを呼び出すためのナビゲーション・バー・アイコンを作成する必要があります。後でフィードバックを無効にすると、ナビゲーション・バー・アイコンが非表示になります。

参照: 「フィードバックの管理」

互換性モード

この属性は、Application Expressエンジンの互換性モードを制御します。特定の実行時の動作はリリースによって異なります。この属性を使用して、特定のアプリケーション動作を取得します。アプリケーションで新しい動作を認識するには、アプリケーションの互換性モードを4.2に設定します。

詳細は、「フィールドレベル・ヘルプ」を参照してください。

アプリケーションの電子メール送信元アドレス

アプリケーションで送信者アドレスとして使用する電子メール・アドレスを指定します。

電子メール・ダウンロードまたはサブスクリプションから電子メールを送信するときに送信者アドレスとして使用する有効な電子メール・アドレスを入力します。値には、有効な電子メールを含むリテラル文字列、または置換構文APP_EMAILを使用してアプリケーションで定義された静的置換参照を指定できます。次に例を示します。

john.doe@abc.com
&MY_APP_EMAIL_FROM.

アイテムの置換は、電子メール・ダウンロードでのみ機能し、サブスクリプションでは機能しないため、アプリケーションまたはページレベルでのアイテムの置換の使用はお薦めしません。

対話モード・レポートの属性ページで送信者アドレスを指定することもできます。「クラシック・レポートの属性へのアクセス」を参照してください。

プロキシ・サーバー

プロキシ・サーバーを指定する場合は、このフィールドを使用します。

たとえば、URLリージョン・ソース・タイプを使用する場合、プロキシ・サーバーが必要になる場合があります。URLリージョン・ソースは、URLの結果(URLにナビゲートすると戻されるページ)をリージョン・ソースとして埋め込みます。ファイアウォールを使用している場合に、URLがアプリケーション・ビルダーに対してファイアウォールの外側にある場合は、プロキシ・サーバーを指定する必要があります。

PL/SQLパッケージ変数APEX_APPLICATION.G_PROXY_SERVERを使用すると、PL/SQLからこのフィールドに入力した値を参照できます。

可用性

「可用性」を使用して、アプリケーション・ステータスおよびビルド・ステータスを定義することによって、アプリケーションを管理します。たとえば、ステータス「制限されたアクセス」を選択すると、アプリケーションにアクセスして実行できるユーザーを指定できます。詳細は、表7-4を参照してください。

表7-4「アプリケーション定義」の「可用性」

属性

説明

ステータス

アプリケーションが使用可能または使用不可であることを指定します。オプションは次のとおりです。

- 使用可能: アプリケーションは制限なしで使用可能です。

- 編集リンクで使用可能: アプリケーションは使用可能です。開発者に対して、各ページの下部に「開発者」ツールバーが表示されます。開発者は同じブラウザ・セッションでアプリケーション・ビルダーにログインする必要があります。

- 開発者のみ使用可能: 開発者権限を持つユーザーがアプリケーションを使用できます。

- 制限されたアクセス: カンマ区切りのユーザー・リスト限定に指定された開発者がアプリケーションを使用できます。

- 使用不可: アプリケーションを実行または編集できません。ユーザーがアプリケーションへのアクセスを試みると、「使用できないアプリケーションに対するメッセージ」内のメッセージが表示されます。

- 使用不可(PL/SQLで表示されるステータス): アプリケーションは実行も編集もできません。

- 使用不可(URLにリダイレクト): アプリケーションは実行できません。ユーザーは、「使用できないアプリケーションに対するメッセージ」に入力されたURLにリンクされます。

参照: Oracle Application Express管理ガイドの「複数のアプリケーションのビルド・ステータスの変更」と「デプロイ時のアプリケーションのビルド・ステータス・セットの変更」、および「アプリケーション、ページおよびページ・コンポーネントへのアクセスの制御」

ビルド・ステータス

カレント・アプリケーションのビルド・ステータスを指定します。オプションは次のとおりです。

- アプリケーションの実行および構築: 開発者とユーザーのどちらもアプリケーションを実行および開発できます。

- アプリケーションの実行のみ: ユーザーはアプリケーションの実行のみが可能です。このオプションは、本番インスタンスのアプリケーション用です。

関連項目: Oracle Application Express管理ガイドの「デプロイ時のアプリケーションのビルド・ステータス・セットの変更」

使用できないアプリケーションに対するメッセージ

この属性は、「ステータス」とともに使用します。「ステータス」を「使用不可」、「使用不可(PL/SQLで表示されるステータス)」または「使用不可(URLにリダイレクト)」に設定すると、この属性に入力したテキストが表示されます。「ステータス」を「使用可能」に設定した場合、この属性に入力したテキストは表示されません。

カンマ区切りのユーザー・リスト限定(ステータスが「制限されたアクセス」の場合のみ)

この属性はステータス「制限されたアクセス」とともに使用します。ステータスを「制限されたアクセス」に設定すると、この属性に示されているユーザーのみがアプリケーションを実行できます。この属性を使用するには、次のステップを実行します。

1. 「ステータス」リストから、「制限されたアクセス」を選択します。

2. 表示されたフィールドに、アプリケーションを実行できるユーザーのカンマ区切りのリストを入力します。

エラー処理

表7-5で説明する属性を使用して、アプリケーションがエラーのログを記録する方法を制御または変更します。ここで指定するエラー処理ファンクションは、同様のページ・レベル属性によって上書きされます。詳細は、「ページ属性について」を参照してください。

表7-5 「アプリケーション定義」の「エラー処理」

属性

説明

デフォルトのエラー表示位置

Application Expressまたはプラグインによって実行される基本検証の検証エラー・メッセージを表示する位置を指定します。検証エラー・メッセージは、通知領域(ページ・テンプレートの一部として定義)またはフィールド・ラベル内に表示できます。オプションは次のとおりです。

- フィールドおよび通知でインライン表示: エラー・メッセージは、ページ・テンプレートの一部として定義される通知領域に表示されます。

- フィールドでインライン表示: エラー・メッセージはフィールド・ラベル内に表示されます。

- 通知でインライン表示: ページでエラーが発生した場合に#NOTIFICATION_MESSAGE#テンプレート置換文字列に表示するエラー・テキストを入力します。

エラー処理ファンクション

既存のエラー・メッセージを変更し、わかりやすいメッセージを表示するか、エラーが発生した場合にそれをログに記録するために呼び出すPL/SQLエラー・ファンクションの名前を入力します。このファンクションは、データベース内のパッケージ・ファンクションまたはスタンドアロンのファンクションを参照できます。次に例を示します。

log_apex_error

データベースのPL/SQLパッケージまたはスタンドアロンのファンクションを参照する場合、#OWNER#置換文字列を使用して、カレント・アプリケーションの解析対象スキーマを参照します。次に例を示します。

#OWNER#.log_apex_error

apex_errorパッケージで説明されている構文を使用してエラー処理ファンクションを実装する必要があります。

function <name of function> (
p_error in apex_error.t_error )
return apex_error.t_error_result

関連項目: 『Oracle Application Express APIリファレンス』のapex_errorに関する説明

注意: ここで指定するエラー処理ファンクションは、ページ・レベルで指定されるエラー処理により上書きされます。詳細は、「ページ属性について」を参照してください。

グローバル通知

「グローバル通知」属性は、アプリケーション・ユーザーに対するシステム・ステータスの通知に使用します。たとえば、この属性を使用して、スケジュールされた停止時間をユーザーに通知したり、アプリケーションの可用性に関するその他のメッセージを通知できます。アプリケーションで使用されるページ・テンプレートに#GLOBAL_NOTIFICATION#置換文字列が含まれている場合は、ここに入力するテキストがその文字列の場所に表示されます。

グローバル通知を作成するには、次のステップを実行します。

1. ページ・テンプレートに#GLOBAL_NOTIFICATION#置換文字列を含めます。

2. アプリケーション定義の編集ページにナビゲートし、「グローバル通知」属性にメッセージを入力します。

3. 「変更の適用」をクリックします。

関連項目:
「置換文字列の理解」および「ページ・テンプレート」

置換

これらのフィールドは、アプリケーションで使用する静的置換文字列を定義する際に使用します。アプリケーション内の多くの場所に出現する文字列やラベルに静的置換文字列を使用できます。置換文字列を作成するには、「置換文字列」列に文字列名を、「置換値」列に文字列値を入力します。

静的置換文字列を定義すると、このページで定義した「置換値」を変更するだけで、アプリケーション内の複数の場所のテキスト文字列をまとめて変更できます。

関連項目:
「置換文字列の理解」

ビルド・オプション

既存のビルド・オプションを表示します。ほとんどのアプリケーションには、ビルド・オプション属性があります。ビルド・オプションは、INCLUDEまたはEXCLUDEという2つの値をとることができます。属性を含めるように指定すると、Application Expressエンジンは、実行時にその属性を認識します。ただし、属性を除外するように指定すると、Application Expressエンジンは、その属性を存在しないものとして処理します。

オブジェクトを特定のインストールから除外する場合を除き、ビルド・オプションは指定しないでください。

関連項目:
「ビルド・オプションを使用した構成の制御」

セキュリティ属性の構成

アプリケーションに対するセキュリティを提供するには、セキュリティ属性の編集ページで属性を編集します。選択したセキュリティ属性は、アプリケーション内のすべてのページに適用されます。

内容は次のとおりです。

- セキュリティ属性の編集ページへのアクセス

- セキュリティ属性ページについて

関連項目:
「アプリケーション・セキュリティの管理」

「セキュリティ属性の編集」ページへのアクセス

セキュリティ属性の編集ページにアクセスするには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。
「共有コンポーネント」ページが表示されます。

4. 「セキュリティ」で、「セキュリティ属性」をクリックします。
セキュリティ属性の編集ページが表示されます。

ヒント:
「アプリケーション定義の編集」にナビゲートし、「セキュリティ」タブをクリックして「セキュリティ属性の編集」にアクセスすることもできます。「定義の編集ページへのアクセス」を参照してください。

ナビゲーションの選択肢について

セキュリティ属性の編集ページは、「認証」、「認可」、「データベース・スキーマ」、「セッション・タイムアウト」、「セッション・ステート保護」および「データベース・セッション」の各セクションに分かれています。これらのセクションにアクセスするには、ページをスクロールするか、ページ上部のナビゲーション・ボタンをクリックします。

図sec_attribute_tabs.gifの説明

ページ上部のボタンを選択すると、選択されたセクションが表示され、その他のセクションはすべて一時的に非表示になります。ページのすべてのセクションを表示するには、「すべて表示」をクリックします。

Security Attributesページについて

次のセクションでは、セキュリティ属性の編集ページで使用可能な属性について説明します。

内容は次のとおりです。

- 認証

- 認可

- データベース・スキーマ

- セッション・タイムアウト

- セッション・ステート保護

- ブラウザ・セキュリティ

- データベース・セッション

認証

認証は、ユーザーがアプリケーションにアクセスする前に、そのユーザーの本人確認を行うプロセスです。アプリケーションに対して複数の認証スキームを定義できますが、一度にカレントに設定できるスキームは1つだけです。表7-6に、認証で使用可能な属性を示します。

表7-6 認証属性

属性

説明

パブリック・ユーザー

データベース・アクセス記述子を介したデータベースへの接続に使用するOracleスキーマを示します。デフォルト値は、データベース・サーバーのバージョンがOracle Database Express Editionの環境ではANONYMOUS、その他すべてのバージョンのデータベース・サーバー環境ではAPEX_PUBLIC_USERです。

ユーザーの本人確認が行われると、Application Expressエンジンが組込み置換文字列APP_USERの値を設定して、各ユーザーを追跡します。

注意: 以前のバージョンのOracle Application Expressでは、組込み置換文字列HTMLDB_PUBLIC_USERが使用されていました。

APP_USERがこの値と等しいと、Application Expressエンジンはカレント・セッションをパブリック・ユーザー・セッションとみなします。Application Expressエンジンは、次の組込み表示条件をサポートしています。

- USER_IS_PUBLIC_USER

- USER_IS_NOT_PUBLIC_USER

カレント・アプリケーション・ユーザー(APP_USER)がこの属性の値と等しい場合、ユーザーはパブリック・ユーザーとしてログインされます。一部のアプリケーションには、パブリック・モード(ログインが不要)およびプライベート・モード(ログインが必要)があります。ユーザーがパブリック・ユーザーかどうかを判断して、条件付きで情報の表示と非表示を切り替えることができます。

たとえば、ユーザーがパブリック・ユーザーの場合はログイン・ボタンを表示し、ユーザーがパブリック・ユーザーでない場合にはログアウト・リンクを表示するように設定できます。この値を参照するには、APEX_APPLICATION.G_PUBLIC_USERを使用します。また、Application Expressエンジンには、組込み条件タイプUSER_IS_PUBLIC_USERおよびUSER_IS_NOT_PUBLICもあります。

関連項目: 「HOME_LINK」および「条件付きのレンダリングおよびプロセスの理解」

認証スキーム

アプリケーションに定義されている認証スキームから選択します。認証スキームを作成するには、「認証スキームの定義」をクリックします。

関連項目: 「認証の仕組みの理解」および「認証スキームの作成」

ディープ・リンク

この属性を使用して、アプリケーションへのディープ・リンクを有効または無効にします。オプションは次のとおりです。

- 有効: 特定のページへのURLは、最終的にその場所へリダイレクトされます(場合によってはユーザーのログインが必要)。

- 無効: URLに有効なセッションIDが含まれていない場合、Application Expressは新しいセッションを開始し、アプリケーションのホームページにリダイレクトされます。

たとえば、多くの場合、ブラウザは開いたタブのURLを保存し、再起動後にセッションを復元しようとするため、ディープ・リンクが発生します。この動作は望ましくない可能性があります(たとえば、URLがマルチステップ・ウィザードの途中のページを指す場合)。「無効」を選択すると、Application Expressは新しいセッションを開始し、アプリケーションのホームページにリダイレクトされます。

関連項目: ページ・レベルでこの動作を上書きする方法の詳細は、「セキュリティ」を参照してください。

認可

認可は、ユーザー権限に基づいて、特定のコントロールまたはコンポーネントへのユーザーのアクセスを制御します。「認可スキーム」リストから選択して、アプリケーションの認可スキームを指定できます。たとえば、会社の従業員のみがアプリケーションにログインできるようにするには、ユーザーの電子メール・アドレスが@somecompany.comで終わる場合にtrueになる認可スキームを定義し、その認可スキームをこのオプションに選択できます。認可スキームは、アプリケーション全体に対して1つのみ割り当てることができます。ただし、認可スキームは、個々のページ、ページ・コントロール(リージョン、ボタン、アイテムなど)または共有コンポーネント(メニュー、リスト、タブなど)に割り当てることができます。

認可スキームを作成するには、「認可スキームの定義」をクリックします。

「パブリック・ページで実行」を使用して、アプリケーション・レベルの認可スキームをパブリック・ページ(つまり、認可を必要としないページ)でチェックするかどうかを制御します。オプションは次のとおりです。

- はい: 「はい」を選択し、ページがパブリックの場合、アプリケーションの認可がチェックされます。

- いいえ: 「いいえ」を選択し、ページがパブリックの場合、アプリケーションの認可は無視されます。

一般的に、認可はユーザー名に依存するため、アプリケーション・レベルの認可は、(「パブリック・ページで実行」と関係なく)ログイン・ページでは評価されません。

関連項目:
「アプリケーションへの認可スキームの割当て」

データベース・スキーマ

カレント・アプリケーションのデータベース・スキーマを指定するには、解析対象スキーマを使用します。定義後は、アプリケーションによって発行されるすべてのSQLおよびPL/SQLコマンドが、定義したデータベース・スキーマの権限で実行されます。

セッション・タイムアウト

Webブラウザが開かれた状態で人がいないコンピュータにアプリケーションが公開される時間を短くするには、次の属性を使用します。

- 最大セッションの長さ: セッションが存在し、このアプリケーションにより使用される秒数を制御する正の整数を入力します。インスタンス・レベルの設定に値を戻すには、この値をNULLのままにします。セッションが無期限に存在するようにするには、0を入力します。セッション存続期間より、8時間ごとに実行され、12時間より前から存在するセッションを削除するジョブの操作が優先される場合があります。

- セッション・タイムアウト時に、このURLにダイレクト: 最大セッション存続期間を超えた際にリダイレクトされるオプションのURLを入力します。このURLのターゲット・ページは、Application Expressで実装された場合、パブリック・ページである必要があります。このページの一般的な用途は、ユーザーにセッションの有効期間を知らせ、ログイン・リンクや他のオプションを表示することです。URLを指定しない場合、リダイレクト先は「アプリケーション」ホームページになります。
このURLでは次の3つの置換アイテムのみがサポートされます:

- &APP_SESSION.

- &SESSION.

- &APP_ID.

このURLは特別な目的を持つため、リンクに&APP_SESSION.および&SESSION.のいずれも含める必要はありません。

- 最大セッション・アイドル時間: このアプリケーションが使用するセッションの停止時間またはアイドル時間を制御する正の整数を秒数で入力します。アイドル時間は、あるページ・リクエストと次のページ・リクエストとの間の時間です。インスタンス・レベルの設定に値を戻すには、この値をNULLのままにします。0に設定すると、セッションのアイドル時間のチェックは行われません。

- セッション・アイドル時間のタイムアウト時に、このURLにダイレクト: 最大セッション・アイドル時間を超えた場合にリダイレクト先となるオプションのURLを入力します。このURLのターゲット・ページは、Application Expressで実装された場合、パブリック・ページである必要があります。このページの一般的な用途は、ユーザーにセッションのタイムアウトを知らせ、ログイン・リンクや他のオプションを表示することです。URLを指定しない場合、リダイレクト先は「アプリケーション」ホームページになります。
このURLでは次の3つの置換アイテムのみがサポートされます:

- &APP_SESSION.

- &SESSION.

- &APP_ID.

このURLは特別な目的を持つため、リンクに&APP_SESSION.および&SESSION.のいずれも含める必要はありません。

関連項目:
「セッション・タイムアウトの理解」およびOracle Application Express管理ガイドの「セッション・タイムアウトの構成」

セッション・ステート保護

セッション・ステート保護を有効にすると、ハッカーがアプリケーション内のURLを改ざんするのを防ぐことができます。URL改ざんにより、プログラム・ロジック、セッション・ステートの内容および情報プライバシが悪影響を受ける可能性があります。

アプリケーションのセッション・ステート保護を有効または無効にするには、「セッション・ステート保護」リストから選択します。セッション・ステート保護を有効に設定すると、ページおよびアイテム・レベルで定義されたセッション・ステート保護コントロールがオンになります。

ブックマーク済リンクにチェックサムが含まれ、セッション・ステート保護がアプリケーションに対して有効な場合、「この後に作成されるURLの許可」に、ブックマーク済リンクをこのアプリケーションのページへのアクセスに使用できるようになった日時がリストされます。

この日付および時間より前に作成されたブックマークは、ブックマーク済リンクにチェックサムが含まれ、セッション・ステート保護がアプリケーションに対して有効な場合、このアプリケーションへのアクセスに使用できません。チェックサムを含まないブックマークまたは不要なチェックサムを含むブックマークは、この属性による影響を受けません。これらの有用性は、他の基準を使用して決定されます。非表示のアプリケーション属性(チェックサム・ソルト)は、計算時と、ページのレンダリング時に生成されたf?p= URLに含まれるチェックサムのその後の検証時に使用されます。チェックサムは、「セッション・ステート保護」がアプリケーションに対して有効な場合に含まれます。このチェックサム・ソルト属性は、「ブックマークの無効化」ボタンをクリックすると、いつでもリセットできます。このボタンをクリックすると、以前に生成されたチェックサムを含むブックマーク済URLは、その後にアプリケーションへのアクセスに使用されるときに失敗します。

セッション・ステート保護を構成するには、「セッション・ステート保護の管理」をクリックします。

関連項目:
「セッション・ステート保護の理解」

ブラウザ・セキュリティ

「キャッシュ」を使用して、アプリケーションのページ・コンテンツのブラウザによるキャッシュを有効化または無効化します。有効化すると、ブラウザでこのアプリケーションのページ・コンテンツを、メモリー内とディスク上の両方のキャッシュに保存します。キャッシュが有効になっている場合に、ブラウザの「戻る」ボタンがクリックされると、通常、ページはサーバーからではなくキャッシュからロードされます。無効にすると、ブラウザはアプリケーションのページ・コンテンツを保存しないように指示され、URLが変更されるたびにサーバーから最新のページ・コンテンツをリクエストします。

機密データが保存されないようにするために、この属性を無効にすることをお薦めします。そうしない場合、ログアウト後にブラウザ履歴で前に戻り、以前のセッションのキャッシュされたコンテンツを表示できる可能性があります。ブラウザのキャッシュを無効にすると、部分ページ・リフレッシュを使用するページ(対話モード・レポートを含むページなど)での問題も回避できます。

この属性を「無効」に設定すると、Application ExpressはHTTPヘッダーcache-control: no-storeを送信して、ブラウザにページ・コンテンツをディスクやメモリーにキャッシュしないように指示します。この機能には、HTTPヘッダー・レスポンス変数cache-controlをサポートする最新のブラウザが必要です。

「フレームへの埋込み」を使用して、ブラウザでアプリケーションのページをフレーム内に表示できるかどうかを制御します。使用可能なオプションは次のとおりです。

- 拒否: 実行するサイトに関係なく、ページをフレームに表示できません。

- 同じ起点から許可: ページ自体と同じ起点のフレームにのみ、ページを表示できます。

- 許可: ページを任意のフレームで表示できます。

フレーム内のページの表示は、クリックジャック攻撃で不正に使用される場合があります。クリックジャック攻撃では、攻撃者は複数のレイヤーを使用して、ユーザーがトップ・レベル・ページをクリックしようとしたときに、別のページ上のボタンやリンクをクリックさせます。したがって、意図したページに対するクリック(またはキーストローク)が攻撃者によりハイジャックされ、別のページに移動させられます。

ヒント:
これらのいずれの機能にも、HTTPヘッダー・レスポンス変数X-Frame-Optionsをサポートする最新のブラウザが必要です。

「HTMLエスケープ・モード」を使用して、Oracle Application Expressで特殊文字をエスケープする方法を定義します。オプションは次のとおりです。

- 基本: &、"、<および>をエスケープします。

- 拡張: データベースのキャラクタ・セットがAL32UTF8ではない場合、&、"、<、>、'、/およびASCII以外の文字をエスケープします。

データベース・セッション

「データベース・セッション」で使用できる属性には、次のものがあります。

- 初期化PL/SQLコード
この属性を使用して、現在の「ページの表示」または「ページの受入れ」リクエストに関連付けられたデータベース・セッションに対してコンテキストを設定するPL/SQLブロックを入力します。ここに入力したブロックは、ページ・リクエスト時の非常に早い段階(APP_USER値が確立された直後)で実行されます。APP_USERの値(:APP_USERまたはv('APP_USER')を使用)をブロック内で使用できます。セッション・ステート内の他のアイテムの値も参照できますが、これらのアイテムは現在のページ・リクエストが開始する前にセッション・ステートに確立されている必要があります。次に例を示します。

dbms_session.set_context('CTX_USER_QRY','USERPRIV',my_package.my_function(:APP_USER));

この例では、CTX_USER_QRYというコンテキストのUSERPRIVの値が、パッケージmy_packageのファンクションmy_functionによって返される値に設定されます。ファンクションには、入力引数としてAPP_USERの現行の値が渡されます。指定したコンテキストがVPDポリシー(すでにアプリケーションの解析対象スキーマ内で作成されている)内で使用され、認証されたユーザーに適した条件の生成が行われます。

ファイングレイン・アクセス制御(FGAC)とも呼ばれる仮想プライベート・データベースは、開発者がセキュリティ・ポリシーをデータベースの表およびビューに割り当てることができるApplication Programming Interface(API)を提供するOracle Databaseの機能です。開発者はPL/SQLを使用して、ストアド・プロシージャを含むセキュリティ・ポリシーを作成し、RDBMSパッケージをコールしてそのプロシージャを表またはビューにバインドできます。このようなポリシーは、データベース内に格納されているアプリケーション・データのコンテンツか、またはOracle Databaseが提供するコンテキスト変数に基づいています。これによって、VPDではアクセス・セキュリティ・メカニズムをアプリケーションから取り除き、特定のスキーマに近い状態にできます。

このセクションで入力するコードはVPD/FGACに関連付ける必要はありません。このコードはセキュリティにまったく関連していない場合があります。ページ・リクエストの最初の時点で実行する必要があるコードは、すべてここに指定できます。たとえば、各ページ・リクエストに対してデータベース・セッションのタイムゾーンを設定するには、次のように指定します。

BEGIN
EXECUTE IMMEDIATE 'alter session set time_zone = ''Australia/Sydney'' ';
END;

- PL/SQLコードのクリーンアップ
この属性を使用して、ページ・プロセスの最後に実行するPL/SQLブロックを入力します。たとえば、この属性は、VPDコンテキストまたはデータベース・リンクなどのリソースの解放またはクリーンアップに使用できます。

例1:

dbms_session.clear_context('CTX_USER_QRY');

このコールでは、データベース・セッションがセッション・プールに戻される前にCTX_USER_QRYというアプリケーション・コンテキストが再設定され、データベース・セッションが再利用される際に情報が漏洩しないようにします。

例2:

dbms_session.close_database_link('SALES');

このコールでは、リンクを介してデータを問い合せることにより、「初期化PL/SQLコード」でまたは暗黙的に開かれているデータベース・リンクSALESが閉じられます。これにより、リソースが解放され、データベース・セッションの再利用時のリソースの漏洩が防止されます。

関連項目:
「認可を介したセキュリティの提供」およびOracle Label Security管理者ガイド

グローバリゼーション属性の構成

アプリケーション・ビルダーでは、異なる言語で同時に実行可能なアプリケーションを開発できます。1つのアプリケーションを、異なる言語をサポートするよう変換できます。グローバリゼーション属性の編集ページの属性を使用して、プライマリ・アプリケーション言語などのグローバリゼーション・オプションを指定します。

内容は次のとおりです。

- グローバリゼーション属性のページへのアクセス

- グローバリゼーション属性の編集ページについて

関連項目:
「アプリケーションのグローバリゼーションの管理」

グローバリゼーション属性のページへのアクセス

グローバリゼーション属性の編集ページにアクセスするには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。
「アプリケーション」ホームページが表示されます。

3. 「共有コンポーネント」をクリックします。
「共有コンポーネント」ページが表示されます。

4. 「グローバリゼーション」で、「グローバリゼーション属性」をクリックします。
グローバリゼーション属性の編集ページが表示されます。

ヒント:
「アプリケーション定義の編集」にナビゲートし、「グローバリゼーション」タブをクリックしてグローバリゼーション属性の編集ページにアクセスすることもできます。「定義の編集ページへのアクセス」を参照してください。

Edit Globalization Attributesページについて

次のセクションでは、グローバリゼーション属性の編集ページで使用可能な属性について説明します。

関連項目:
「アプリケーションへのプライマリ言語の指定」

アプリケーションのプライマリ言語

アプリケーションを開発する言語を指定します。この言語が、すべての変換の元となるベース言語になります。たとえば、英語で作成されたアプリケーション100が、フランス語に変換され、アプリケーション101として公開されたとします。英語がアプリケーションのプライマリ言語になります。

アプリケーションに対するすべての変更は、ここで指定したプライマリ言語で行う必要があります。

アプリケーション言語の派生元

アプリケーション・ビルダーでのアプリケーション言語の特定または導出の方法を決定します。

アプリケーションのプライマリ言語は静的にすることも、Webブラウザ言語から導出したり、ユーザー・プリファレンスやアイテムから特定することもできます。また、データベース言語設定により、日付の表示方法や特定の情報のソート方法を決定することもできます。

このオプションを使用すると、派生したブラウザ言語のサポートを無効にできます。アプリケーションのプリファレンスから派生したアプリケーション言語を指定するオプションも表示されます。詳細は、「フィールドレベル・ヘルプ」を参照してください。

アプリケーション日付書式

アプリケーションで使用する日付書式を決定します。

この日付書式を使用して、NLS_DATE_FORMATデータベース・セッションの設定が変更されてから、アプリケーション内のページが表示または送信されます。この値には、有効なOracle日付書式マスクを含むリテラル文字列、または置換構文を使用したアイテム参照を指定できます。値が指定されていない場合は、データベース・セッションからデフォルトの日付書式が実行時に取得されます。次に例を示します。

Month DD, YYYY
&MY_DATE_FORMAT.

アプリケーションの日時書式

アプリケーションで使用する日時書式を指定します。

この日時書式は、置換参照&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.

アプリケーションのタイムスタンプ書式

アプリケーションで使用するタイムスタンプ書式を決定します。LOVからタイムスタンプ書式を選択します。

このタイムスタンプ書式を使用して、NLS_TIMESTAMP_FORMATデータベース・セッションの設定が変更されてから、アプリケーション内のページが表示または送信されます。この値には、有効なOracleタイムスタンプ書式マスクを含むリテラル文字列、または置換構文を使用したアイテム参照を指定できます。値が指定されていない場合は、データベース・セッションからデフォルトのタイムスタンプ書式が実行時に取得されます。次に例を示します。

DD-MON-RR HH.MI.SSXFF AM
&MY_TIMESTAMP_FORMAT.

アプリケーションのタイムスタンプ・タイムゾーン書式

アプリケーションで使用するタイムゾーン付きのタイムスタンプ書式を決定します。

この日付書式を使用して、NLS_TIMESTAMP_TZ_FORMATデータベース・セッションの設定が変更されてから、アプリケーション内のページが表示または送信されます。この値には、有効なOracleタイムスタンプ書式マスクを含むリテラル文字列、または置換構文を使用したアイテム参照を指定できます。値が指定されていない場合は、データベース・セッションからデフォルトのタイムゾーン付きのタイムスタンプ書式が実行時に取得されます。次に例を示します。

DD-MON-RR HH.MI.SSXFF AM TZR
&MY_TIMESTAMP_TZ_FORMAT.

文字の値の比較

ORDER BY、LIKE、MIN/MAXなどの様々なSQL操作および句の文字の値の比較の照合順序を決定します。

この値を使用して、クラシック・レポートおよび対話モード・レポート・リージョンのSQL問合せの実行のNLS_SORTデータベース・セッション・パラメータを変更します。値を指定しない場合、データベース・セッションからデフォルト値が実行時に導出されます。次に例を示します。

BINARY
GERMAN
CANADIAN_M

文字の値の比較動作

LIKE、MIN/MAXなどのSQL操作の照合動作を決定します。

この値を使用して、クラシック・レポートおよび対話モード・レポート・リージョンのSQL問合せの実行のNLS_COMPデータベース・セッション・パラメータを変更します。オプションは次のとおりです。

- データベース・セッションのNLS設定(デフォルト): データベース・セッションからNLS_COMP値が実行時に導出されます。

- バイナリ: WHERE句および他のSQL操作の比較はバイナリです。

- 言語形式: WHERE句および他のSQL操作の比較は、「文字の値の比較」属性(NLS_SORT)で指定する言語ソートを使用します。

自動タイムゾーン

データベース・セッションのタイムゾーンの設定を制御します。「はい」に設定すると、クライアント・タイムゾーンがクライアントのWebブラウザから取得され、Application Expressセッションの継続時間用に設定されます。

その後のページ・ビューには、ページ・ビューごとに適切なデータベース・セッション・タイムゾーンが設定されます。設定後、この設定はAPEX_UTIL.SET_SESSION_TIME_ZONEを使用して上書きしたり、APEX_UTIL.RESET_SESSION_TIME_ZONEを使用して再設定することができます。

関連項目:
『Oracle Application Express APIリファレンス』

自動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)でエンコードされます。

アプリケーションのユーザー・インタフェースの管理

ユーザー・インタフェース・ページの属性を使用して、アプリケーションのユーザー・インタフェース・オプションを指定します。

内容は次のとおりです。

- ユーザー・インタフェース・ページへのアクセス

- ユーザー・インタフェース・ページについて

- 新しいユーザー・インタフェースの作成

ユーザー・インタフェース・ページへのアクセス

ユーザー・インタフェース・ページにアクセスするには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。
「アプリケーション」ホームページが表示されます。

3. 「共有コンポーネント」をクリックします。
「共有コンポーネント」ページが表示されます。

4. 「ユーザー・インタフェース」で、「ユーザー・インタフェース属性」をクリックします。
ユーザー・インタフェース・ページが表示されます。

ヒント:
「アプリケーション定義の編集」にナビゲートし、「ユーザー・インタフェース」タブをクリックしてユーザー・インタフェース・ページにアクセスすることもできます。「定義の編集ページへのアクセス」を参照してください。

ユーザー・インタフェース・ページについて

次のセクションでは、ユーザー・インタフェース・ページで使用可能な属性について説明します。

内容は次のとおりです。

- 一般プロパティ

- ロゴ

- JavaScript

- ユーザー・インタフェースの検出

- ユーザー・インタフェース

一般プロパティ

「一般プロパティ」を使用して、アプリケーションのユーザー・インタフェースの基本特性を定義します。表7-7では、すべての「一般プロパティ」属性について説明します。

表7-7 「ユーザー・インタフェース」の「一般プロパティ」

属性

説明

イメージ接頭辞

アプリケーション・ビルダーで配布されるイメージ・ディレクトリを指すためにWebサーバーが使用する仮想パスを決定します。インストール時、仮想パスは/i/として構成されます。

静的テキスト(ページ、リージョン・ヘッダー、リージョン・フッターなど)にイメージを埋め込む場合は、置換文字列#IMAGE_PREFIX#を使用してイメージを参照できます。たとえば、イメージgo.gifを参照するには、次の構文を使用します。

<img src="#IMAGE_PREFIX#go.gif">

関連項目: 「IMAGE_PREFIX」、「イメージの管理」および「イメージの参照」

コンテンツ配信ネットワーク

サード・パーティのライブラリのjQueryおよびjQuery Mobileをロードするために使用するコンテンツ配信ネットワークを指定します。

コンテンツ配信ネットワークを使用すると、jQueryファイルのロードに同じコンテンツ配信ネットワークを使用するその他のWebサイトをユーザーがすでに訪問している場合、アプリケーションのロード時間を短縮できます。このようなファイル・コールは、ブラウザ・キャッシュ内に存在し、再度ダウンロードする必要がない場合がほとんどです。特にブラウザ・キャッシュに制限のあるモバイル・デバイスでは、ファイルがキャッシュからパージされることは少ないため、パフォーマンスが改善されます。

メディア・タイプ

インターネット・メディア・タイプを入力します。インターネット・メディア・タイプは、2つの部分で構成される、インターネット上のファイル形式を表す識別子です。メディア・タイプは、少なくともタイプとサブタイプの2つの部分で構成され、オプションで1つ以上のパラメータを指定します。メディア・タイプは、ページ描画の際にHTTPヘッダーのContent-Typeで使用されます。

ページ・レベルのメディア・タイプが、アプリケーション・レベルのメディア・タイプを上書きします。この属性のデフォルト値はNULLです。ページ・レベルとアプリケーション・レベルの両方でメディア・タイプの値がNULLの場合、メディア・タイプとしてtext/htmlが使用されます。

ロゴ

「ロゴ」属性は、アプリケーション・ロゴを定義する際に使用します。アプリケーション・ロゴは、テキスト・ベースにもイメージ・ベースにもできます。この機能を使用するには、ページ・テンプレートに#LOGO#置換文字列が含まれている必要があります。

アプリケーション・ロゴを定義するには、次のステップを実行します。

1. 「ロゴ・タイプ」で次のいずれかを選択します。

- アプリケーション・ロゴにイメージを使用する場合は、「イメージ」を選択します。

- アプリケーション・ロゴにテキストを使用する場合は、「テキスト」を選択します。

2. 「ロゴ」で、次のように入力します。

- イメージの場合、イメージの完全な名前(ファイル名拡張子を含む)を入力してください。次に例を示します。

/i/oracle.gif

- テキストの場合、テキスト文字列全体を入力してください。次に例を示します。

Sample Application

3. 「ロゴ属性」で、ロゴの適切な属性を入力するか、またはリストから選択します。
イメージの例:

width="100" height="20" alt="Company Logo"

テキストの例:

style="font-family:Arial; color:#000000; font-size:18; white-space:nowrap; font-weight:bold;"

関連項目:
「イメージの管理」、「仮想イメージ・ディレクトリの接頭辞の確認」、「テンプレートのカスタマイズ」および「ページ・テンプレート」

JavaScript

表7-8で説明する属性を使用して、アプリケーションがJavaScriptを処理する方法を制御または変更します。

表7-8 「ユーザー・インタフェース」の「JavaScript」

属性

説明

ファイルURL

各ページにロードするコードのJavaScriptのファイルURLを入力します。各URLは新規行に書き込む必要があります。ファイルの縮小バージョンを指定する場合、置換文字列#MIN#を使用して、通常ページ・ビューのファイルURLに.minを含めたり、ページをデバッグ・モードに表示する場合は空の文字列を含めることができます。

ここで入力した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ファイルの全体のサイズを削減します。

ユーザー・インタフェースの検出

自動検出が失敗した際に、Oracle Application Expressが使用可能なユーザー・インタフェースを表示するためにロードする必要のあるスタイルシートのカスケード・スタイルシート(CSS)のファイルURLを入力します。各URLは新規行に書き込む必要があります。ファイルの縮小バージョンを指定する場合、置換文字列#MIN#を使用して、通常ページ・ビューのファイルURLに.minを含めたり、ページをデバッグ・モードに表示する場合は空の文字列を含めることができます。アプリケーションのバージョンをファイルURLに含める場合、置換文字列#APP_VERSION#にアクセスすることもできます。URLを入力しない場合、Oracle Application Expressではデフォルトのスタイルシートが使用されます。

次に例を示します。

- 標準ファイル参照:

/mycss/main.css

- 通常ページ・ビューの縮小ファイルmain.min.cssおよびデバッグ・モードのmain.cssをロードする標準ファイル参照:

/mycss/main#MIN#.css

- 条件付きメディア問合せ:

[media="only screen and (max-device-width: 480px)"]/mycss/smartphone.css

- Internet Explorerの条件付きファイル:

[if IE]/mycss/ie.css

- アプリケーションのアップグレード時(およびバージョンが増分されるとき)にブラウザが新しいファイルをロードし、以前キャッシュされたファイルを無視するように、アプリケーション・バージョンを参照するURLで問合せ文字列を使用するファイル参照。

/mycss/main.css?version=#APP_VERSION#

スクリプトの開始タグや閉じタグを含める必要はありません。URLのみを記述します。

ユーザー・インタフェース

カレント・アプリケーションに定義されているユーザー・インタフェースが表示されます。既存のユーザー・インタフェースを編集するには、ユーザー・インタフェース名をクリックします。新しいユーザー・インタフェースを追加するには、「新規ユーザー・インタフェースの追加」をクリックします。

関連項目:
「テーマの管理」

新しいユーザー・インタフェースの作成

新しいユーザー・インタフェースを追加するには、次のステップを実行します。

1. ユーザー・インタフェース・ページにナビゲートします。「ユーザー・インタフェース・ページへのアクセス」を参照してください。

2. 「ユーザー・インタフェース」までスクロールし、「新規ユーザー・インタフェースの追加」をクリックします。

3. 「ユーザー・インタフェース」で、次の項目を指定します。

1. ユーザー・インタフェース: 現在のユーザー・インタフェースが表示されます。

2. タイプ: ユーザー・インタフェース・タイプを選択します。アプリケーションに現在関連付けられていないインタフェースのみを選択できます。

3. 表示名: ユーザー・インタフェースの表示名を指定します。

4. 順序: ユーザー・インタフェースの順序を指定します。

5. 自動検出: ユーザー・インタフェースを自動的に検出する必要があるかどうかを選択します。

6. ホームURL: URL、またはアプリケーションを実行するときに実行されるプロシージャを指定します。
たとえば、「ホーム・リンク」には、「アプリケーション」ホームページの位置を特定するために使用される相対URLを含めることができます。たとえば、f?p=6000:600は、ホームページ番号600を持つアプリケーション6000を指定します。この例では、アプリケーション・テンプレート内の#HOME_LINK#置換文字列は、「ホーム・リンク」に入力した値で置き換えられます。「HOME_LINK」を参照してください。

この属性を使用してプロシージャに名前を付けることもできます。たとえば、アプリケーション・ホームとして機能するHTMLページをレンダリングするpersonal_calendarなどのプロシージャを作成できます。

注意:
認証後に表示されるページを決定するために「ホーム・リンク」属性は使用しないでください。認証後に表示されるページは、アプリケーションの認証スキーム内の他のコンポーネントによって決定されます。

7. ログインURL: 現在のユーザー・インタフェースのログイン・ページとして使用するページのURLを指定します。これにより、HTMLの&LOGIN_URLまたはテンプレート内の#LOGIN_URL#置換文字列が置き換えられます。「LOGIN_URL」および「認証スキームの作成」を参照してください。

8. 「次へ」をクリックします。

4. 「テーマの指定」で、次の項目を指定します。

1. テーマ・タイプ: テーマ・タイプを選択します。Application Expressには標準テーマが用意されています。カスタム・テーマは、ワークスペースまたはOracle Application Expressインスタンス用に作成されたテーマです。レガシー・テーマは、Application Expressで提供される古いテーマです。

2. テーマ: テーマを選択します。テーマは、アプリケーションのルック・アンド・フィールを定義するテンプレートのコレクションを示します。

3. 「次へ」をクリックします。

5. 選択した内容を確認し、「作成」をクリックします。

データベース・アプリケーションのページの管理

ページは、アプリケーションの基本的な構成要素です。アプリケーション・ビルダーでアプリケーションを構築する際は、タブ、リスト、ボタン、アイテム、リージョンなどのユーザー・インタフェース要素を含むページを作成します。

内容は次のとおりです。

- データベース・アプリケーションのページの作成について

- 「アプリケーション」ホームページからのページの作成

- 「開発者」ツールバーからのページの作成

- データベース・アプリケーションのページのコピー

- アプリケーションまたはページの実行

- ページのグループ化

- ページのロックおよびロック解除

- ページの削除

関連項目:
「アプリケーション・ユーティリティおよびレポートの表示」および「データベース・アプリケーション・ページの操作」

データベース・アプリケーションのページの作成について

ページの追加、または既存のページへのコンポーネントの追加を行うには、ページの作成ウィザードを実行します。このウィザードにアクセスする方法を次に示します。

- 「アプリケーション」ホームページの「ページの作成」をクリックします。「「アプリケーション」ホームページからのページの作成」を参照してください。

- 「開発者」ツールバーの「作成」リンクをクリックして、「新しいページ」を選択します。「「開発者」ツールバーからのページの作成」を参照してください。

- 「ページ定義」で「作成」ボタンをクリックし、「新しいページ」を選択します。「「ページ定義」について」を参照してください。

注意:
「ページの作成」ウィザードを使用して、コンポーネント(つまりレポート、チャート、フォーム、ウィザード、カレンダまたはツリー)を既存のページに追加することもできます。プロンプトが表示されたら、既存のページ番号を指定します。

「アプリケーション」ホームページからのページの作成

「アプリケーション」ホームページからページを作成するには、次のステップを実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。

2. アプリケーションを選択します。
「アプリケーション」ホームページが表示されます。

3. 「ページの作成」ボタンをクリックします。

4. 表7-9「ページの作成ウィザードで使用可能なページ・タイプ」の説明に従って、作成するページのタイプを選択します。

表7-9 ページの作成ウィザードで使用可能なページ・タイプ

ページ・タイプ

説明

デスクトップ

jQuery Mobileスマートフォン

空白ページ

組込み機能のないページを作成します。

使用可能

使用可能

複数の空白ページ

複数の空白ページを作成します。

使用可能

使用可能

レポート

SQL問合せの結果がフォーマット化されます。使用可能なオプションは次のとおりです。

- クラシック・レポート: カスタムSQL SELECT文または指定したSQL SELECT文を戻すPL/SQLファンクションに基づいてレポートを作成します。

- リスト・ビュー: SQL問合せの書式設定された結果を含むページを作成します。リスト・ビューの基となる表を選択し、リスト・ビューの表示情報に使用する列を選択できます。
注意: デスクトップ・アプリケーションはリスト・ビューをサポートしていません。

- 対話モード・レポート: 指定するカスタムSQL SELECT文に基づいた対話モード・レポートを作成します。ユーザーは、特定の列の選択、フィルタの適用、ハイライト処理、ソート処理などを行ってレポート・データのレイアウトを変更できます。また、ブレーク、集計、各種チャート、ユーザー独自の計算などを定義することもできます。
注意: jQuery Mobileスマートフォンは対話モード・レポートをサポートしていません。

- Webサービスの結果のレポート: Webサービスの結果に基づいてレポートを作成します。
関連項目: 「Webサービスの実装」

- ウィザード・レポート: SQLの知識がなくてもレポートを作成できます。適切なスキーマ、表、列および結果セット表示を選択します。

使用可能

使用可能

フォーム

ユーザーが更新した表内の単一行または複数行を使用してフォームのインタフェースを作成します。

参照: フォームの作成

使用可能

使用可能

プラグイン

リージョン・タイプ・プラグインに基づいて新しいページを作成します。開発者はプラグインを使用して、Oracle Application Expressで使用可能な組込みタイプを宣言的に拡張、共有および再利用できます。

参照: 「プラグイン・ページからのプラグインのインポート」

使用可能

使用可能

チャート

HTML5およびFlashのグラフィカル・チャートを作成できます。

参照: チャートの作成

使用可能

なし。

マップ

AnyChart AnyMap対話モード・マップ・コンポーネントに基づいてFlashマップを作成します。

参照: 「マップの作成」

使用可能

適用不可。

ツリー

ツリーを作成すると、階層的なデータまたは複数レベルのデータ間でグラフィカルに通信できます。

参照: ツリーの作成

使用可能

適用不可。

カレンダ

月別、週別、日別表示のカレンダを生成します。

参照: カレンダの作成

使用可能

使用可能

ウィザード

ウィザードを作成します。

使用可能

使用可能

データのロード

新しいデータのロード・ウィザードを作成して、エンド・ユーザーが、権限を持つすべてのスキーマに対する表へのデータのロードを管理できるようにします。

関連項目: 「データ・ロード機能によるアプリケーションの作成」

使用可能

使用不可。

フィードバック・ページ

フィードバック・ページを追加します。フィードバックは、アプリケーション・ユーザーからリアルタイム・コメント、拡張リクエストおよびバグを収集するプロセスです。

参照: 「フィードバックの管理」

使用可能

使用可能

ログイン・ページ

ログイン・ページを作成します。

参照: 「ログイン・ページの構築について」

使用可能

使用可能

アクセス制御

アクセス制御リストを含むページを作成すると、開発者はアプリケーション、個別ページまたはページ・コンポーネントへのアクセスを制御できます。

関連項目: 「アプリケーション、ページおよびページ・コンポーネントへのアクセスの制御」

使用可能

使用可能

5. 画面に表示されるステップに従います。

関連項目:
「「開発者」ツールバーからのページの作成」および「アプリケーションまたはページの実行」

「開発者」ツールバーからのページの作成

レンダリングされたアプリケーションを表示するには、「実行」または「アプリケーションの実行」アイコンをクリックしてアプリケーションを実行するか、またはApplication Expressエンジンに送信します。

関連項目:
「アプリケーションまたはページの実行」

デスクトップ・アプリケーションを実行すると、ページの下部に「開発者」ツールバーが表示されます。「開発者」ツールバーを使用すると、カレント・ページの編集、ページ、リージョンまたはページ・コントロールの作成、セッション・ステートの表示、あるいは編集リンクのオン/オフの切替えを簡単に実行できます。「開発者」ツールバーの表示の有無は、アプリケーション定義の編集ページの「ステータス」属性を変更することで制御できます。「ステータス」属性の変更の詳細は、「アプリケーション定義の編集」を参照してください。

関連項目:
「アプリケーションまたはページの実行」および「「開発者」ツールバーについて」

「開発者」ツールバーからページを作成するには、次のステップを実行します。

1. アプリケーションを実行します。「アプリケーションまたはページの実行」を参照してください。

2. 「開発者」ツールバーで「作成」をクリックします。
「新しいコンポーネント」ウィザードが表示されます。

3. 作成するコンポーネントのタイプを選択し、「次へ」をクリックします。使用可能なオプションは次のとおりです。

- 新しいページ: 「ページ・タイプの作成について」を参照してください。

- このページのリージョン

- このページのページ・コントロール

- 共有コントロール

4. 画面に表示されるステップに従います。

関連項目:
「「アプリケーション」ホームページからのページの作成」、「アプリケーションまたはページの実行」および「「開発者」ツールバーについて」

ページ・タイプの作成について

「開発者」ツールバーからページの作成ウィザードを実行する場合は、ページ・タイプを選択します。表7-10は、選択したページ・タイプに基づいて選択可能なページの作成オプションを示します。

表7-10 「ページの作成」オプション

「ページの作成」オプション

デスクトップで使用可能な選択項目

新しいページ

使用可能なページ・タイプは、次のとおりです。

- 空白ページ

- 複数の空白ページ

- レポート。「レポートの作成」を参照してください。

- フォーム。「フォームの作成」を参照してください。

- プラグイン。詳細は、「プラグインの実装」を参照してください。

- チャート。「チャートの作成」を参照してください。

- マップ。「マップの作成」を参照してください。

- ツリー。「ツリーの作成」を参照してください。

- カレンダ。「カレンダの作成」を参照してください。

- ウィザード

- データのロード。「データ・ロード機能によるアプリケーションの作成」を参照してください。

- フィードバック・ページ。「フィードバックの管理」を参照してください。

- ログイン・ページ。「ログイン・ページの構築について」を参照してください。

- アクセス制御。「アプリケーション、ページおよびページ・コンポーネントへのアクセスの制御」を参照してください。

このページのリージョン

リージョンはコンテンツのコンテナとして機能します。使用可能なリージョン・タイプは、次のとおりです。

- HTML

- 複数のHTML

- レポート

- フォーム

- プラグイン(リージョン・タイプ・プラグインが存在する場合にのみ表示されます)

- チャート

- マップ

- ツリー

- カレンダ

- リスト

- ブレッドクラム

- PL/SQL動的コンテンツ

- URL

- リージョン表示セレクタ

- ヘルプ・テキスト

関連項目: 「リージョンの理解」および「リージョン・タイプについて」

このページのページ・コントロール

ページ・コントロールは次のとおりです。

- アイテム。「ページ・レベル・アイテムの理解」を参照。

- ボタン。「ボタンの作成」を参照してください。

- ブランチ。「ブランチを使用したナビゲーションの制御」を参照。

- 計算。「ページ計算の理解」を参照。

- プロセス。「ページ・プロセスの理解」を参照。

- 検証。「検証の理解」を参照してください。

共有コントロール

共有コンポーネント・オプションは次のとおりです。

- 「ナビゲーション・バー」アイコン。詳細は、「ナビゲーション・バー・エントリの作成」を参照してください。

- 「親」タブ。「タブの作成」を参照してください。

- 「標準」タブ。「タブの作成」を参照してください。

- LOV。「アプリケーション・レベルでのLOVの作成」を参照してください。

- リスト。「リストの作成」を参照してください。

- ブレッドクラム。「ブレッドクラムの作成」を参照してください。

データベース・アプリケーションのページのコピー

現在のアプリケーションまたは別のアプリケーションからページをコピーできます。コピー・プロセス中に、共有コンポーネントのコピーや、ターゲット・アプリケーションの共有コンポーネントへのマッピングを変更することもできます。

ページをコピーするには、次のようにします。

1. コピー先のアプリケーションにナビゲートします。

1. 「ワークスペース」ホームページにナビゲートします。

2. 「アプリケーション・ビルダー」アイコンをクリックします。

3. アプリケーションを選択します。

4. ページを選択します。
「ページ定義」が表示されます。

2. ツリー・ビューでは、次のステップを実行します。

1. 「ページ・レンダリング」で、ページ名を選択します。

2. 右クリックして「コピー」を選択します。

3. コンポーネント・ビューでは、次のステップを実行します。

1. 「ページ」で、「コピー」アイコンをクリックします。

2. 「ページ・オプションのコピー」で、次のいずれかを選択します。

- このアプリケーションのページ

- 別のアプリケーションのページ

4. 画面に表示されるステップに従います。

モバイル・ユーザー・インタフェースにコピーできないデスクトップ・ページ

ページのコピー・ウィザードでは、ページを別のユーザー・インタフェースにコピーできます。コピー処理中に、ユーザーは新規ページのユーザー・インタフェースを選択できます。アプリケーションにデスクトップおよびモバイル・テーマが含まれている場合、両方のユーザー・インタフェース・オプションが表示されます。ただし、次のデスクトップ・ページはモバイル・ユーザー・インタフェースにコピーできません。

- 対話モード・レポート

- Flashマップ

- Flashチャート

- jsTreeリージョン

これらのデスクトップ・ページをモバイル・ページにコピーしようとすると、エラーが表示されます。

アプリケーションまたはページの実行

Application Expressエンジンは、データベース表に格納されたデータに基づいて、ページを動的にレンダリングおよび処理します。レンダリングされたアプリケーションを表示するには、アプリケーションを実行するか、またはApplication Expressエンジンに送信します。新しいページを作成したら、そのページを個別に実行するか、またはアプリケーション全体を実行できます。アプリケーションを実行するには、「アプリケーションの実行」アイコンをクリックします。

内容は次のとおりです。

- 「アプリケーションの実行」アイコンと「ページの実行」アイコンについて

- アプリケーション・ビルダーのホームページからのアプリケーションの実行

- 「アプリケーション」ホームページからのアプリケーションの実行

- 「アプリケーション」ホームページでのページの実行

- 「ページ定義」からのページの実行

「アプリケーションの実行」アイコンと「ページの実行」アイコンについて

「アプリケーションの実行」アイコンは「アプリケーション」ホームページに表示されるアイコンで、実行(再生)ボタンの付いたアプリケーション・ウィンドウのような形をしています。「アプリケーションの実行」アイコンをクリックすると、アプリケーション全体が実行されます。

run_ico_sm.gifの説明

「ページの実行」アイコンは小さな灰色の再生ボタンのような形をしており、アプリケーション・ビルダー内の多くのページの右上隅に表示されます。「ページの実行」アイコンをクリックすると、現在のページが実行されます。

ヒント:
モバイル・アプリケーションおよびロックされたパッケージ・アプリケーションを実行した場合、「開発者」ツールバーは表示されません。ベスト・プラクティスとして、アプリケーション・ビルダーに簡単にアクセスできるように、アイコンを右クリックしてリンクを新規タブで開くを選択しておくことをお薦めします。

run_ico_green.gifの説明

アプリケーション・ビルダーのホームページからのアプリケーションの実行

アプリケーション・ビルダーのホームページからアプリケーション全体を実行するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. 「レポートの表示」アイコンをクリックします。

3. 「アプリケーション」リストからアプリケーションを指定します。

4. 右側の列にある「実行」アイコンをクリックします。

「アプリケーション」ホームページからのアプリケーションの実行

「アプリケーション」ホームページからアプリケーションを実行するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。
「アプリケーション・ビルダー」ホームページが表示されます。

2. アプリケーションを選択します。

3. ページ上部にある「アプリケーションの実行」アイコンをクリックします。

「アプリケーション」ホームページでのページの実行

ページ上部のナビゲーション・バーにある表示アイコンを選択して、「アプリケーション」ホームページの表示方法を制御できます。「レポートの表示」を選択すると、各ページがレポート内の1行として表示されます。各行には、ページ番号、ページ名、ページの最終更新日、ページの最終更新者、ページ・タイプ、選択したユーザー・インタフェース、「ロック」アイコンおよび「実行」アイコンが含まれます。

「ページ」リストからページを実行するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「レポートの表示」アイコンをクリックします。

4. 実行するページを探して、右側の列にある「実行」アイコンをクリックします。

関連項目:
「ページのロックおよびロック解除」

「ページ定義」からのページの実行

「ページ定義」から特定のページを実行するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. ページを選択します。
「ページ定義」が表示されます。

4. ページ上部の「実行」ボタンをクリックします。

ページのグループ化

ページをページ・グループとして編成すると、アプリケーション内のページに簡単にアクセスできるようになります。ページ・グループを使用するには、グループを作成してからページをグループに割り当てます。

ページ・グループには、開発者がアプリケーション内のページを編成する際に役立つ機能以外の機能はありません。

内容は次のとおりです。

- ページ・グループの表示

- ページ・グループの作成

- ページ・グループ定義の編集

- ページのページ・グループへの割当て

- ページ・グループごとのページの表示

- ページ・グループの削除

ページ・グループの表示

ここでは、ページ・グループの様々な表示方法について説明します。

ページ・グループ・ページにアクセスするには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「ユーティリティ」アイコンをクリックします。

4. 「ページ固有のユーティリティ」で、「クロス・ページ・ユーティリティ」をクリックします。

5. 「ページ・グループ」をクリックします。
ページ・グループ・ページが表示されます。

検索バーがページの上部に表示されます。使用可能なコントロールは次のとおりです。

- 検索列の選択: 虫めがねに似ています。このアイコンをクリックして、検索を絞り込みます。すべての列を検索するには、「すべての列」を選択します。

- テキスト領域: 名前でページ・グループを検索するための大/小文字を区別しない検索基準(ワイルドカード文字は暗黙的に定義される)を入力し、「実行」をクリックします。

- 「実行」ボタン: 検索を実行したり、フィルタを適用します。

- アイコンの表示: 各グループを大きいアイコンとして表示します。グループを編集するには、該当するアイコンをクリックします。

- レポートの表示: 各グループをレポート内の1行として表示します。グループを編集するには、名前をクリックします。

- 「アクション」メニュー: 「アクション」メニューを使用して、レポート・ビューをカスタマイズします。「「アクション」メニューについて」を参照してください。

6. グループに関連付けられたページを表示するには、「ページ・グループごとのページ」をクリックします。

ページ・グループの作成

ページ・グループを作成するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「ユーティリティ」アイコンをクリックします。

4. 「ページ固有のユーティリティ」で、「クロス・ページ・ユーティリティ」をクリックします。

5. 「ページ・グループ」をクリックします。

6. ページ・グループ・ページで、「作成」をクリックします。

7. 名前および説明(オプション)を入力して、「作成」をクリックします。

ページ・グループ定義の編集

ページ・グループの作成時に、名前と説明を指定します。

ページ・グループ定義を編集するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「ユーティリティ」アイコンをクリックします。

4. 「ページ固有のユーティリティ」で、「クロス・ページ・ユーティリティ」をクリックします。

5. 「ページ・グループ」をクリックします。

6. ページ・グループを選択します。

7. ページ・グループ・ページで名前または説明を編集し、「変更の適用」をクリックします。

8. 次のページ・グループ定義に移動するには、「前へ」ボタン(<)と「次へ」ボタン(>)をクリックして、前のステップを繰り返します。

ページのページ・グループへの割当て

ページをグループに割り当てるには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「ユーティリティ」アイコンをクリックします。

4. 「ページ固有のユーティリティ」で、「クロス・ページ・ユーティリティ」をクリックします。

5. 「ページ・グループ」をクリックします。

6. 「ページ割当て」タブをクリックします。
ページ割当てページが表示されます。

7. ページ番号をクリックします。
ページ属性ページが表示されます。

8. 「名前」リージョンを探して、「グループ」リストからグループを選択します。

9. 「変更の適用」をクリックします。

ページ・グループごとのページの表示

ページ・グループごとにページを確認するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「ユーティリティ」アイコンをクリックします。

4. 「ページ固有のユーティリティ」で、「クロス・ページ・ユーティリティ」をクリックします。

5. 「ページ・グループ」をクリックします。

6. 「ページ・グループごとのページ」タブをクリックします。
ページ・グループごとのページ・ページが表示されます。ページ番号をクリックすることで、ページ属性ページに移動できます。ページ名をクリックすることで、「ページ定義」にリンクします。

7. 新しいグループを作成するには、「作成」をクリックして、画面に表示されるステップに従います。

ページ・グループの削除

ページ・グループを削除するには、次のステップを実行します。

1. 削除するグループのすべてのページを削除します。「ページ・グループごとのページの表示」を参照してください。

2. ページ・グループ・ページにアクセスします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「ユーティリティ」アイコンをクリックします。

4. 「ページ固有のユーティリティ」で、「クロス・ページ・ユーティリティ」をクリックします。

5. 「ページ・グループ」をクリックします。

6. ページ・グループを選択します。

3. 「削除」をクリックします。
「確認」ページが表示されます。

4. リクエストを確認します。

ページのロックおよびロック解除

アプリケーション開発中の競合を回避するには、アプリケーション内のページをロックします。ページをロックすると、他の開発者がページを編集できなくなります。

内容は次のとおりです。

- ページがロックされているかどうかの判別

- ページのロック

- ページのロック解除

ページがロックされているかどうかの判別

「ロック」アイコンは、ページが現在ロックされているかどうかを示します。ページのロックが解除されている場合、アイコンは鍵が開いた南京錠として表示されます。ページがロックされている場合、アイコンは鍵が掛かった南京錠として表示されます。「ロック」アイコンは、「アプリケーション」ホームページと「ページ定義」に表示されます。

「アプリケーション」ホームページに「ロック」アイコンを表示するには、「レポートの表示」アイコンをクリックします。レポートが表示されます。「ロック」アイコンはページの右側に表示されます。

lock_ico.gifの説明

「ロック」アイコンは「ページ定義」の開発者アクション・バーにも表示されます。「開発者アクション・バーについて」を参照してください。

ページのロック

「アプリケーション」ホームページ(「レポートの表示」または「詳細の表示」をクリック)、ページ・ロック・ページの「ページ」リスト、および「ページ定義」から、ページをロックできます。

ページ・ロック・ページからのページのロック

ページ・ロック・ページからページをロックするには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「ユーティリティ」アイコンをクリックします。

4. 「ページ固有のユーティリティ」リストで、「クロス・ページ・ユーティリティ」をクリックします。

5. 「ページ・ロック」をクリックします。

6. 該当するページを選択して、「ロックを選択済」をクリックします。

7. 「コメント」フィールドにコメントを入力します。

8. 「ページのロック」をクリックします。

「アプリケーション」ホームページからのページのロック

「アプリケーション」ホームページからページをロックするには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 検索バーで、「レポートの表示」または「詳細の表示」アイコンをクリックします。

4. 「ロック」アイコンをクリックします。

5. 「コメント」フィールドにコメントを入力します。

6. 「ページのロック」をクリックします。

「ページ定義」からのページのロック

「ページ定義」からページをロックするには、次のステップを実行します。

1. 該当する「ページ定義」にナビゲートします。「「ページ定義」へのアクセス」を参照してください。

2. 開発者アクション・バーの「ロック」アイコンをクリックします。「開発者アクション・バーについて」を参照してください。

3. ロックするページを選択して、「チェックした項目のロック」をクリックします。

4. 「コメント」フィールドにコメントを入力します。

5. 「ページのロック」をクリックします。

ヒント:
「ページ定義」で「ユーティリティ」ボタンをクリックし、「ロック」をクリックしてページをロックすることもできます。

ページのロック解除

ページをロックした開発者のみが、そのページのロックを解除できます。ただし、管理権限を持つ開発者は、他の開発者がロックしたページのロックを解除できます。

ページ・ロック・ページからのページのロック解除

ページ・ロック・ページからロックを解除するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「ユーティリティ」アイコンをクリックします。

4. 「ページ固有のユーティリティ」リストで、「クロス・ページ・ユーティリティ」をクリックします。

5. 「ページ・ロック」をクリックします。

6. 該当するページを選択します。

7. 「チェックした項目のロック解除」をクリックします。

「アプリケーション」ホームページからのページのロック解除

「アプリケーション」ホームページからページをロック解除するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 検索バーで、「レポートの表示」または「詳細の表示」アイコンをクリックします。

4. 「ロック」アイコンをクリックします。
ロック・コメントの編集ページが表示されます。

5. 「ロック解除」をクリックします。

「ページ定義」からのページのロック解除

「ページ定義」からページのロックを解除するには、次のステップを実行します。

1. 該当する「ページ定義」にナビゲートします。「「ページ定義」へのアクセス」を参照してください。

2. 開発者アクション・バーの「ロック」アイコンをクリックします。「開発者アクション・バーについて」を参照してください。

3. ロック解除するページを選択し、「チェックした項目のロック解除」をクリックします。

ヒント:
「ページ定義」で「ユーティリティ」ボタンをクリックし、「ロック解除」をクリックしてページのロックを解除することもできます。

ワークスペース管理者としてのページのロック解除

ワークスペース管理者としてページのロックを解除するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「ユーティリティ」アイコンをクリックします。

4. 「ページ固有のユーティリティ」リストで、「クロス・ページ・ユーティリティ」をクリックします。

5. 「ページ・ロック」をクリックします。

6. 「ロック管理」をクリックします。

7. 該当するページを選択します。

8. 「ページのロック解除」をクリックします。

ページの削除

ページを削除すると、対応する表、ブレッドクラムおよびリスト・エントリが削除されます。削除できるのは、自分でロックまたはロック解除したページのみです。「ページのロックおよびロック解除」を参照してください。

内容は次のとおりです。

- 「ページ定義」からのページの削除

- ページ属性の編集中にページの削除

- 複数のページの削除

- ページの範囲の削除

「ページ定義」からのページの削除

「ページ定義」からページを削除するには、次のステップを実行します。

1. 該当する「ページ定義」にナビゲートします。「「ページ定義」へのアクセス」を参照してください。

2. ページ番号を確認します。

3. 「ユーティリティ」ボタンをクリックし、「削除」をクリックします。

4. 「ページを完全に削除」をクリックします。

関連項目:
ページ属性を編集する方法については、「コンポーネント・ビューでのページの編集」を参照してください

ページ属性の編集中にページの削除

ページ属性の編集中にページを削除するには、次のストップを実行します。

1. 「ページ定義」にナビゲートします。「「ページ定義」へのアクセス」を参照してください。

2. 編集ページにアクセスするには、次の操作を実行します。

- ツリー・ビュー: 「ページ・レンダリング」で、ツリーの上部のページ・タイトルをダブルクリックします。

- コンポーネント・ビュー: 「ページ」で、「すべて編集」アイコンをクリックします。

ページ属性ページが表示されます。必須の値には赤いアスタリスク(*)が付いています。

3. ページ番号とページ名を確認します。

4. 「削除」をクリックします。

5. 画面に表示されるステップに従います。

複数のページの削除

複数ページを削除するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「ユーティリティ」をクリックします。

4. 「ページ固有のユーティリティ」で、「クロス・ページ・ユーティリティ」をクリックします。

5. 「複数のページの削除」をクリックします。

6. 削除するページを選択し、「ページの削除」をクリックします。

ページの範囲の削除

ページの範囲を削除するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「ユーティリティ」をクリックします。

4. 「ページ固有のユーティリティ」で、「クロス・ページ・ユーティリティ」をクリックします。

5. 「複数のページの削除」をクリックします。

6. 「範囲別ページの削除」タブをクリックします。

7. 削除するページを入力し、「ページの削除」をクリックします。

データベース・アプリケーション・コメントの追加

アプリケーション・コメント・ページで、データベース・アプリケーション全体に関するコメントを追加できます。アプリケーションの説明またはアプリケーションで作業した開発者の追跡ができます。

内容は次のとおりです。

- データベース・アプリケーション・コメントの作成および編集

関連項目:
「開発者コメントの追加」

データベース・アプリケーション・コメントの作成および編集

アプリケーション・コメントを作成するには、次のステップを実行します。

1. 「ワークスペース」ホームページにナビゲートします。

2. 「アプリケーション・ビルダー」アイコンをクリックします。

3. アプリケーションを選択します。

4. 「アプリケーション」ホームページで、「共有コンポーネント」をクリックします。
「共有コンポーネント」ページが表示されます。

5. 「アプリケーション」で、「コメントの編集」をクリックします。
アプリケーション・コメント・ページが表示されます。

6. 「コメント」フィールドにコメントを入力して、「変更の適用」をクリックします。

開発者コメントの追加

「開発者のコメント」、「バグ」または「To Do」アイコンを使用して、アプリケーション、ページまたはページ・グループに開発者のコメントを追加できます。このアイコンは、プラス記号を含む小さい吹出しの形をしています。アイコンは、開発者アクション・バーに表示されます。

図comment_ico.gifの説明

開発者コメントは、アプリケーションの変更の通知、問題の報告、または開発者の提案の記録などに使用できます。

内容は次のとおりです。

- アプリケーションまたはページへの開発者コメントの追加

- 開発者コメントの表示と編集

- 開発者コメントの削除

- 開発者コメント・レポートについて

- 開発者コメントのカレンダの表示

関連項目:
「データベース・アプリケーション・コメントの追加」

アプリケーションまたはページへの開発者コメントの追加

「開発者のコメント」アイコンは、特定のアプリケーションまたはアプリケーション・ページに関連するアプリケーション・ビルダー内のページに表示されます。アプリケーション、ページ、またはページ・グループに開発者のコメントを追加できます。

開発者コメントを追加するには、次のようにします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「開発者のコメント」、「バグ」または「To Do」アイコンをクリックします。

4. 「コメント」アイコンをクリックします。
「コメントの作成」ページが別のウィンドウに表示されます。

5. 「関連ページ」で、コメントを適用するページを指定します。コメントの入力方法は次のとおりです。

- 特定のページに適用する場合、ページ番号を入力します。

- 複数のページに適用する場合、ページのカンマ区切りリストを入力します。次に例を示します。

1, 2, 3

- ページまたはページ・グループに適用しない場合、このフィールドをブランクのままにします。

6. 「コメント」に、テキストを最大4000文字まで入力します。

7. 「作成」または「作成後、別のものの作成」をクリックします。

開発者コメントの表示と編集

開発者コメントを編集するには、次のようにします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「開発者のコメント」、「バグ」または「To Do」アイコンをクリックします。

4. 「コメント」アイコンをクリックします。
「コメントの作成」ページが別のウィンドウに表示されます。

5. 「コメントの表示」をクリックします。
コメントの表示ページが表示されます。「コメントの表示ページのナビゲーション・バーについて」を参照してください。

6. コメントを編集するには、「編集」アイコンをクリックします。
「コメントの編集」ページが表示されます。

1. 「関連ページ」で、コメントを適用するページを指定します。コメントの入力方法は次のとおりです。

- 特定のページに適用する場合、ページ番号を入力します。

- 複数のページに適用する場合、ページのカンマ区切りリストを入力します。次に例を示します。

1, 2, 3

- ページまたはページ・グループに適用しない場合、このフィールドをブランクのままにします。

2. 「コメント」に、テキストを最大4000文字まで入力します。

7. 「変更の適用」をクリックします。

ヒント:
開発者コメントは、共有コンポーネント・ページでも表示および編集できます。共有コンポーネント・ページに移動し、「タスク」リストの「開発者のコメント」をクリックします。「共有コンポーネント・ページへのアクセス」を参照してください。

View Commentsページのナビゲーション・バーについて

ナビゲーション・バーはコメントの表示ページの上部に表示され、次のコントロールが含まれています。

- 「検索列の選択」。列を選択して「実行」をクリックします。すべて検索するには、検索フィールドをブランクのままにして「実行」をクリックします。

- レポートの選択。大/小文字を区別しない問合せを入力して「実行」をクリックします。すべてのページを表示する場合は、フィールドをブランクのままにして「実行」をクリックします。

- アクション: 「アクション」メニューを使用して、レポート・ビューをカスタマイズします。「「アクション」メニューについて」を参照してください。

- 「表示」。コメントの表示方法を指定します。表示されるコメント数の増減を行うには、「表示」リストで選択を行ってから「実行」をクリックします。

開発者コメントの削除

コメントの編集ページまたはコメントの管理ページで、開発者コメントを削除できます。

内容は次のとおりです。

- 特定の開発者コメントの削除

- 複数の開発者コメントの削除

特定の開発者コメントの削除

開発者コメントを削除するには、次のようにします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「開発者のコメント」、「バグ」または「To Do」アイコンをクリックします。

4. 「コメント」アイコンをクリックします。
「コメントの作成」ページが別のウィンドウに表示されます。

5. 「コメントの表示」をクリックします。

6. 削除するコメントを探します。「コメントの表示ページのナビゲーション・バーについて」を参照してください。

7. 「編集」アイコンをクリックします。
「コメントの編集」ページが表示されます。

8. 「削除」をクリックします。

複数の開発者コメントの削除

複数の開発者コメントを削除するには、次のようにします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「開発者のコメント」、「バグ」または「To Do」アイコンをクリックします。

4. 「コメント」アイコンをクリックします。
「コメントの作成」ページが別のウィンドウに表示されます。

5. 「コメントの管理」をクリックします。

6. 次のアクションの1つを選択します。

- すべてのコメントの削除

- 開発者別に作成されたコメントの削除

- 日付別のコメントの削除

7. 画面に表示されるステップに従います。

開発者コメント・レポートについて

開発者コメント・レポートから開発者コメントを表示、編集および管理することもできます。

内容は次のとおりです。

- 開発者コメント・レポートへのアクセス

- コメントの編集または開発者コメント・レポートからの削除

- 開発者コメント・レポートからのコメントの削除

- 開発者コメント・レポートからの複数のコメントの削除

開発者コメント・レポートへのアクセス

開発者コメント・レポートにアクセスするには、次のようにします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「タスク」で、「開発者のコメント」をクリックします。
開発者コメント・レポートが表示されます。

ナビゲーション・バーはページの上部に表示され、次のコントロールが含まれています。

- 検索列の選択: 虫めがねに似ています。このアイコンをクリックして、検索を特定の列のみに絞ります。すべての列を検索するには、「すべての列」を選択します。

- テキスト領域: 大/小文字を区別しない検索基準(ワイルドカード文字は暗黙的に定義される)を入力し、「実行」をクリックします。

- 「実行」ボタン: 検索を実行します。

- 「アクション」メニュー: 「アクション」メニューを使用して、レポート・ビューをカスタマイズします。「「アクション」メニューについて」を参照してください。

コメントの編集または開発者コメント・レポートからの削除

開発者コメント・レポートからコメントを編集するには、次のようにします。

1. 開発者コメント・レポートにナビゲートします。「開発者コメント・レポートへのアクセス」を参照してください。
開発者コメント・レポートが表示されます。

2. 編集するコメントを探します。

3. 「編集」アイコンをクリックします。
コメントの編集ページが別のウィンドウに表示されます。

1. 「関連ページ」で、コメントを適用するページを指定します。コメントの入力方法は次のとおりです。

- 特定のページに適用する場合、ページ番号を入力します。

- 複数のページに適用する場合、ページのカンマ区切りリストを入力します。次に例を示します。

1, 2, 3

- ページまたはページ・グループに適用しない場合、このフィールドをブランクのままにします。

2. 「コメント」に、テキストを最大4000文字まで入力します。

4. 「変更の適用」をクリックします。

開発者コメント・レポートからのコメントの削除

開発者コメント・レポートからコメントを削除するには、次のようにします。

1. 開発者コメント・レポートにナビゲートします。「開発者コメント・レポートへのアクセス」を参照してください。
開発者コメント・レポートが表示されます。

2. 削除するコメントを探します。

3. 「編集」アイコンをクリックします。
「コメントの編集」ページが別のウィンドウに表示されます。

4. 「削除」をクリックします。

開発者コメント・レポートからの複数のコメントの削除

開発者コメント・レポートから複数のコメントを削除するには、次のようにします。

1. 開発者コメント・レポートにナビゲートします。「複数の開発者コメントの削除」を参照してください。
開発者コメント・レポートが表示されます。

2. 削除するコメントを探します。

3. 「編集」アイコンをクリックします。
「コメントの編集」ページが別のウィンドウに表示されます。

4. 「コメントの管理」をクリックします。

5. 次のアクションの1つを選択します。

- すべてのコメントの削除

- 開発者別に作成されたコメントの削除

- 日付別のコメントの削除

6. 画面に表示されるステップに従います。

開発者コメントのカレンダの表示

「開発者コメントのカレンダ」にアクセスするには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「タスク」で、「開発者コメントのカレンダ」をクリックします。
開発者コメントのカレンダ・ページが表示されます。

5. 「前へ」、「今日」および「次へ」ボタンを使用してナビゲートします。

アプリケーション・グループの作成

アプリケーションをアプリケーション・グループに割り当てることにより、アプリケーションを整理できます。アプリケーション・グループを使用するには、「作成」ボタンをクリックしてグループを作成し、そのグループにアプリケーションを割り当てます。

内容は次のとおりです。

- データベース・アプリケーション・グループの表示

- データベース・アプリケーション・グループの作成

- アプリケーション・グループへのデータベース・アプリケーションの割当て

- アプリケーション・グループからのデータベース・アプリケーションの削除

- データベース・アプリケーション・グループの削除

関連項目:
「クロス・ページ・ユーティリティについて」

データベース・アプリケーション・グループの表示

この項では、データベース・アプリケーション・グループを表示する様々な方法について説明します。

アプリケーション・グループ・ページへのアクセス

アプリケーション・グループ・ページにアクセスするには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. ページの右側にある「タスク」リストで、「アプリケーション・グループ」をクリックします。
アプリケーション・グループ・ページが表示されます。

検索バーがページの上部に表示されます。使用可能なコントロールは次のとおりです。

- 検索列の選択: 虫めがねに似ています。このアイコンをクリックして、検索を絞り込みます。すべての列を検索するには、「すべての列」を選択します。

- テキスト領域: 名前でグループを検索するための大/小文字を区別しない検索基準(ワイルドカード文字は暗黙的に定義される)を入力し、「実行」をクリックします。

- 「実行」ボタン: 検索を実行したり、フィルタを適用します。

- アイコンの表示(デフォルト): 各グループを大きいアイコンとして表示します。グループを編集するには、該当するアイコンをクリックします。

- レポートの表示: 各グループをレポート内の1行として表示します。グループを編集するには、名前をクリックします。

3. グループに関連付けられたアプリケーションを表示するには、グループ名をクリックします。

注意:
「タスク」リストは、現在グループが存在する場合のみ表示されます。

データベース・アプリケーション・グループの作成

データベース・アプリケーション・グループを作成するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. ページの右側にある「タスク」リストで、「アプリケーション・グループ」をクリックします。

3. アプリケーション・グループ・ページで、「作成」をクリックします。

4. 名前および説明(オプション)を入力して、「作成」をクリックします。

データベース・アプリケーション・グループ定義の編集

ページ・グループの作成時に、名前と説明を指定します。

アプリケーション・グループ定義を編集するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. ページの右側にある「タスク」リストで、「アプリケーション・グループ」をクリックします。
アプリケーション・グループ・ページが表示されます。

3. アプリケーション・グループを選択します。

4. アプリケーション・グループ・ページで名前または説明を編集し、「変更の適用」をクリックします。

アプリケーション・グループへのデータベース・アプリケーションの割当て

アプリケーションをグループに割り当てるには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. ページの右側にある「タスク」リストで、「アプリケーション・グループ」をクリックします。

3. 「タスク」リストで「未割当ての管理」をクリックします。
アプリケーション・グループ割当ての管理ページが表示されます。

4. 「新規グループ」リストから、グループを選択します。

5. 割り当てるアプリケーションを選択して、「チェックした項目の割当て」をクリックします。

ヒント:
アプリケーション・グループへのアプリケーションの割当ては、アプリケーション定義を編集して行うこともできます。グループは、「アプリケーション・グループ」リストから選択します。「アプリケーション定義の編集」を参照してください。

アプリケーション・グループからのデータベース・アプリケーションの削除

アプリケーション・グループからアプリケーションを削除するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. ページの右側にある「タスク」リストで、「アプリケーション・グループ」をクリックします。

3. 「タスク」リストで「未割当ての管理」をクリックします。
アプリケーション・グループ割当ての管理ページが表示されます。

4. 「新規グループ」リストから、「- 割当て解除 -」を選択します。

5. 割当てを解除するページを選択して、「チェックした項目の割当て」をクリックします。

ヒント:
アプリケーション・グループからのアプリケーションの削除は、アプリケーション定義を編集して行うこともできます。「アプリケーション・グループ」リストから「未割当て」を選択します。「アプリケーション定義の編集」を参照してください。

データベース・アプリケーション・グループの削除

アプリケーション・グループを削除するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. ページの右側にある「タスク」リストで、「アプリケーション・グループ」をクリックします。

3. グループ内のすべてのアプリケーションに「- 割当て解除 -」を割り当てます。「アプリケーション・グループからのデータベース・アプリケーションの削除」を参照してください。

4. アプリケーション・グループ・ページに戻ります。

5. 削除するアプリケーション・グループを選択します。

6. アプリケーション・グループ・ページで、「削除」をクリックします。
「確認」ページが表示されます。

7. リクエストを確認します。

ページ・レベル・アイテムの理解

アイテムは、HTMLフォームの一部です。アイテムは、テキスト・フィールド、テキスト領域、パスワード、選択リスト、チェック・ボックスなどを示します。アイテム属性は、ページ上のアイテムの表示に影響します。たとえば、これらの属性は、ラベルの表示位置、アイテムの大きさおよびアイテムの表示位置(左右、上下)に影響します。

内容は次のとおりです。

- ページ・アイテムとアプリケーション・アイテムの違い

- 「ページ定義」でのアイテムの表示

- ページ・レベル・アイテムの作成

- ページ・レベル・アイテムの編集

- アイテム値の参照

- 条件付きページ・アイテムまたは読取り専用ページ・アイテムの表示

- 複数選択リスト・アイテムでの操作

関連項目:
「アプリケーション・レベル・アイテムの理解」、「アイテム属性がページ・レイアウトに与える影響」、「「アイテム・ファインダ」について」および「ページ固有のユーティリティについて」

ページ・アイテムとアプリケーション・アイテムの違い

アイテムには、ページ・アイテムとアプリケーション・アイテムの2つのタイプが存在します。ページ・アイテムはページ上に配置され、「表示のみ」、「ラベル」、「ラベル・テンプレート」などの関連付けられたユーザー・インタフェースのプロパティを持ちます。ページ・レベル・アイテムの例としてはチェック・ボックス、日付ピッカー、テキストとしての表示、「ファイル参照」フィールド、「ポップアップLOV」、「選択リスト」、または「テキスト領域」などがあります。アプリケーション・アイテムはページに関連付けられないため、ユーザー・インタフェースのプロパティを持ちません。アプリケーション・アイテムは、グローバル変数として使用できます。

関連項目:
「アプリケーション・レベル・アイテムの理解」

「ページ定義」でのアイテムの表示

「ページ定義」のページ・レベル・アイテムを作成および編集します。コンポーネント・ビューとツリー・ビューのどちらでも、アイテム・セクションは「ページ・レンダリング」セクションに表示されます。「ツリー・ビューとコンポーネント・ビューの切替え」を参照してください。

内容は次のとおりです。

- ツリー・ビューでのアイテムの表示

- コンポーネント・ビューでのアイテムの表示

ツリー・ビューでのアイテムの表示

ツリー・ビューでは、アイテムはツリー内のそのアイテムが含まれているリージョンの下に表示されます。

図pg_def_items_tree.gifの説明

アイテムを編集または追加するには、右クリックしてコンテキスト・メニューを表示します。次に、コンテキスト・メニューから選択します。

ヒント:
アイテム名をダブルクリックするか、または名前を選択して[Enter]キーを押すことでアイテムを編集することもできます。「ツリー・ビューでのページの編集」を参照してください。

図pg_def_item_menu.gifの説明

複数のアイテムを一度に編集するには、アイテムを右クリックし、「すべて編集」を選択します。アイテム・ページが表示されます。「複数のアイテムの同時編集」を参照してください。

コンポーネント・ビューでのアイテムの表示

図pg_def_items.gifの説明

コンポーネント・ビューでは、アイテムは「アイテム」の下に表示されます。「アイテム」アイコンをクリックすると、他のすべてのサブセクションを一時的に非表示にできます。表示を元に戻すには、「すべての表示」をクリックします。「すべて表示」アイコンは、下向き三角形の形をしています。

セクション・タイトルの横には次のアイコンが表示されます。

- すべて編集: 「すべて編集」アイコンは、鉛筆が置かれた小さいグリッドの形をしています。すべてのアイテムを一度に編集する場合に、このアイコンを使用します。「複数のアイテムの同時編集」を参照してください。

- コピー: 「コピー」アイコンは、小さいページが2つ重なった形をしています。既存のアイテムをコピーする場合に、このアイコンを使用します。

- 作成: 「作成」アイコンは、プラス(+)記号が置かれた小さいページの形をしています。アイテムを作成する場合に、このアイコンを使用します。

アイテムはリージョンごとに編成されます。アイテムを編集するには、アイテム名をクリックします。

関連項目:
ページ・アイテム属性の編集

ページ・レベル・アイテムの作成

アイテムの作成ウィザードを実行して、ページ・レベル・アイテムを作成できます。

内容は次のとおりです。

- アイテムのネーミング規則について

- 「ページ定義」でのページ・レベル・アイテムの作成

- 静的値リストの作成

- カスケードLOVの作成

- 表形式フォームを使用した複数のアイテムの作成

関連項目:
「ページ・アイテムとアプリケーション・アイテムの違い」および「アイテム・タイプについて」

アイテムのネーミング規則について

アイテム名を指定する場合は、次の規則に注意してください。規則は次のとおりです。

- アプリケーション内で一意である必要があります。

- 引用符を含めることはできません。

- 先頭は文字または数字である必要があります。その後は、文字、数字またはアンダースコア文字を使用できます。

- 大/小文字が区別されません。

- 30文字以内にする必要があります。30文字を超えるアイテムは、バインド変数構文を使用して参照できません。「バインド変数構文について」を参照してください。

- 基本ASCIIキャラクタ・セット以外の文字を含めることはできません。

アイテム名を指定する場合は、ページ番号を含めることをお薦めします。デフォルトでは、ウィザードによってページ・アイテム名の先頭にP<page no>_<item name>が付けられます(たとえば、P1_NAME)。

「ページ定義」でのページ・レベル・アイテムの作成

ページ・レベル・アイテムを作成するには、「ページ定義」から「アイテムの作成」ウィザードを実行します。

ページ・レベル・アイテムを作成するには、次のステップを実行します。

1. 該当する「ページ定義」にナビゲートします。「「ページ定義」へのアクセス」を参照してください。

2. 必要に応じて、HTMLリージョンを作成します。「リージョンの理解」を参照してください。

3. アイテムの作成ウィザードにアクセスするには、次のステップを実行します。

- ツリー・ビュー: ページ・レンダリングで、アイテムを含めるリージョンを右クリックし、「ページ・アイテムの作成」を選択します。

- コンポーネント・ビュー: 「アイテム」で、「作成」アイコンをクリックします。

アイテムの作成ウィザードが表示されます。

4. アイテム・タイプを選択します。「アイテム・タイプについて」を参照してください。
ポップアップLOV、カラー・ピッカーまたはポップアップ計算機付きテキスト・フィールドを作成する場合は、「ポップアップLOV」を選択し、特定のポップアップLOVタイプを選択します。

5. 「表示位置および名前」では、次のようにします。

1. アイテム名: アイテムの値の取得に使用する名前を入力します。「アイテムのネーミング規則について」を参照してください。

2. 順序: このコンポーネントの順序を指定します。これによって評価の順序が決まります。

3. リージョン: このアイテムを含めるリージョンを選択します。

4. 「次へ」をクリックします。

6. 画面に表示されるステップに従います。

7. 特定のフィールドの詳細を表示するには、フィールド・ラベルをクリックします。
ヘルプが使用可能な場合は、アイテムにカーソルをあわせると、カーソルが疑問符付きの矢印に変わります。「フィールドレベル・ヘルプについて」を参照してください。

静的値リストの作成

静的値リストを作成する方法の1つに、アイテムのLOV定義の編集があります。このタイプのLOVは再使用できないことに注意してください。LOVをいつでも使用可能な共有コンポーネントとして作成することをお薦めします。

関連項目:
「アプリケーション・レベルでのLOVの作成」

静的値リストを作成するには、次のステップを実行します。

1. 該当する「ページ定義」にナビゲートします。「「ページ定義」へのアクセス」を参照してください。

2. アイテムの属性ページにアクセスします。

- ツリー・ビュー: アイテムを右クリックし、「編集」を選択します。

- コンポーネント・ビュー: 「アイテム」で、アイテム名を選択します。

「ページ・アイテムの編集」ページが表示されます。

3. 「名前」で、アイテムのレンダリング方法を指定します。「表示形式」から「選択リスト」を選択します。

4. 「LOV」までスクロールします。

5. 「LOV」で、静的値リストを次のように作成します。

1. 「名前付きLOV」から、「名前付きLOVの選択」を選択します。

2. 「LOV」定義で、次の構文を使用して定義を入力します。

STATIC[2]:Display Value[;Return Value],Display Value[;Return Value]

説明:

- 最初のキーワードはSTATICまたはSTATIC2になります。
STATICでは、値が表示値のアルファベット順でソートされます。STATIC2では、値がリストに入力された順序で表示されます。

- セミコロンは各エントリで表示値と戻り値を区切ります。

- Return Valueはオプションです。Return Valueが含まれない場合、戻り値は表示値と同じになります。

6. ページ上の特定のアイテムのヘルプを表示するには、アイテム・ラベルをクリックします。「フィールドレベル・ヘルプについて」を参照してください。

7. 「変更の適用」をクリックします。
次に例として、3つの異なる静的値リストに対する構文を示します。

例1: アルファベット順で表示される4つの値

この例では、アルファベット順で表示される4つの値(Cow、Dog、Cat、Lion)が値リストにあります。各エントリの戻り値は表示値と同じです。

STATIC:Cow,Dog,Cat,Lion

例2: リストされた順序で表示される10の値

この例では、定義にリストされた順序で表示される10の値が値リストにあります。各エントリの戻り値は表示値と同じです。

STATIC2:10,15,20,25,50,100,200,500,1000,10000

例3: 戻り値および表示値の両方を持つ値リスト

この例では、YesとNoという2つの値が値リストにあります(表示値Yesとその戻り値Y、表示値Noとその戻り値N)。

STATIC:Yes;Y,No;N

カスケードLOVの作成

カスケードLOVを作成すると、ページ上の1つのアイテムによって別のアイテムのLOVが決定されます。アプリケーション・ビルダーでは、選択リスト、シャトル、チェック・ボックス、ラジオ・グループ、ポップアップLOVおよびリスト・マネージャの各アイテム・タイプに対して、カスケードLOVがサポートされています。アイテム・タイプの詳細は、付録A「アイテム・タイプについて」を参照してください。

カスケードLOVは、2つのアイテムを作成することによって作成します。2つ目のアイテムに値を移入するには、アイテムの作成ウィザードを実行しているときか、またはアイテムの属性を編集することによって、カスケードLOV親アイテムを指定します。

次の例では、2つの関連する選択リストを作成する方法を示します。この場合、最初のリストの値が2つ目のリストに移入されます。

カスケードLOVについては、次のステップを実行します。

1. 最初のアイテムを作成し、そのアイテムにP1_DEPTNOという名前を付けます。

1. 選択リスト・アイテムを作成します。「「ページ定義」でのページ・レベル・アイテムの作成」を参照してください。

2. 「アイテム・タイプ」で、「選択リスト」を選択します。

3. 「表示位置および名前」では、次のようにします。

- アイテム名: 次のように入力します。

P1_DEPTNO

- 残りのデフォルト値を受け入れ、「次へ」をクリックします。

4. 「アイテム属性」で、次のステップを実行します。

- ラベル: Departmentと入力します。

- 残りのデフォルト値を受け入れ、「次へ」をクリックします。

5. 「設定」で、デフォルト値を受け入れ、「次へ」をクリックします。

6. 「LOV」では次を実行します。

- NULL値の表示: デフォルトの「はい」を受け入れます。

- NULL表示値: 「- Select Department -」と入力します。

- Select Department -

- 「LOV定義」で、次のように入力します。

SELECT dname as d,
deptno as r
FROM dept
ORDER BY dname

- 「次へ」をクリックします。

7. 残りのデフォルト値を受け入れます。

8. 「アイテムの作成」をクリックします。

2. P1_EMPNOという名前の2つ目のアイテムを作成します。

1. 2つ目のアイテムを作成します。「「ページ定義」でのページ・レベル・アイテムの作成」を参照してください。

2. 「アイテム・タイプ」で、「選択リスト」を選択します。

3. 「表示位置および名前」では、次のようにします。

- アイテム名: 次のように入力します。

P1_EMPNO

- 残りのデフォルト値を受け入れ、「次へ」をクリックします。

4. 「アイテム属性」で、次のステップを実行します。

- ラベル: Employeeと入力します。

- 残りのデフォルト値を受け入れ、「次へ」をクリックします。

5. 「設定」で、デフォルト値を受け入れ、「次へ」をクリックします。

6. 「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

- 「次へ」をクリックします。

7. 残りのデフォルト値を受け入れます。

8. 「アイテムの作成」をクリックします。

2つの選択リストが表示されます。「Department」選択リストで選択を行うと、「Employees」選択リストに表示される個人が決定されます。

図cascading_lov.gifの説明

関連項目:
「ページ・レベル・アイテムの編集」

表形式フォームを使用した複数のアイテムの作成

複数のアイテムを同時に作成するには、次のステップを実行します。

1. 該当する「ページ定義」にナビゲートします。「「ページ定義」へのアクセス」を参照してください。

2. 必要に応じて、HTMLリージョンを作成します。「リージョンの理解」を参照してください。

3. アイテムの作成ウィザードにアクセスするには、次のステップを実行します。

- ツリー・ビュー: ページ・レンダリングで、アイテムを含めるリージョンを右クリックし、「ページ・アイテムの作成」を選択します。

- コンポーネント・ビュー: 「アイテム」で、「作成」アイコンをクリックします。

アイテムの作成ウィザードが表示されます。

4. ページ下部の「表形式フォームを使用した複数アイテムの作成」リンクをクリックします。

5. 複数のアイテムの作成ページで、次の項目を指定します。

1. リージョンにアイテムの作成: アイテムを含めるリージョンを選択します。

2. アイテム・テンプレート: アイテム・テンプレートを選択します。

3. 各アイテムの「順序」、「名前」、「ラベル」、「タイプ」を入力し、アイテムがキャッシュする必要があるかどうかを指定します。

6. 「複数のアイテムの作成」をクリックします。

ページ・レベル・アイテムの編集

ページ・アイテム属性を編集するか、または「すべて編集」アイコンか「アイテムの順序変更」アイコンを使用して、ページ・レベル・アイテムを編集できます。

内容は次のとおりです。

- ページ・アイテム属性の編集

- デフォルト値の定義

- ページ・アイテム・セキュリティの構成

- クイック選択の作成

- 複数のアイテムの同時編集

関連項目:
「条件付きページ・アイテムまたは読取り専用ページ・アイテムの表示」および「使用可能なアイテム・タイプ」

ページ・アイテム属性の編集

作成したページ・アイテムは、「ページ・アイテムの編集」ページで編集できます。

ページ・アイテム属性を編集するには、次のステップを実行します。

1. 該当する「ページ定義」にナビゲートします。「「ページ定義」へのアクセス」を参照してください。

2. アイテムの属性ページにアクセスします。

- ツリー・ビュー: アイテムを右クリックし、「編集」を選択します。

- コンポーネント・ビュー: 「アイテム」で、アイテム名を選択します。

ヒント:
アイテム名をダブルクリックするか、または名前を選択して[Enter]キーを押すことでアイテムを編集することもできます。「ツリー・ビューでのページの編集」を参照してください。

「ページ・アイテムの編集」ページが表示されます。

3. ページ上の特定の属性の詳細を表示するには、属性ラベルをクリックします。「フィールドレベル・ヘルプについて」を参照してください。

4. 「変更の適用」をクリックします。

関連項目:
「アイテム属性がページ・レイアウトに与える影響」および「クロスサイト・スクリプティング保護の理解」

ナビゲーションの選択肢について

ページ・アイテムの編集ページは、セクションに分かれています。表示されるセクションは、「表示形式」属性によって異なります。

これらのセクションにアクセスするには、ページをスクロールするか、ページ上部のナビゲーション・ボタンをクリックします。ページ上部のボタンを選択すると、選択されたセクションが表示され、その他のセクションはすべて一時的に非表示になります。ページのすべてのセクションを表示するには、「すべて表示」をクリックします。

デフォルト値の定義

アイテムのデフォルト値は、ページ・アイテムの編集ページの「デフォルト」の下にある属性を使用して定義します。デフォルト値は、アイテムの値がセッション・ステートから導出されない場合およびソース値がNULLの場合に使用されます。

アイテムのデフォルト値を定義するには、次のステップを実行します。

1. アイテムを作成します。「ページ・レベル・アイテムの作成」を参照してください。

2. 該当する「ページ定義」にナビゲートします。「「ページ定義」へのアクセス」を参照してください。

3. アイテムの属性ページにアクセスします。

- ツリー・ビュー: アイテムを右クリックし、「編集」を選択します。

- コンポーネント・ビュー: 「アイテム」で、アイテム名を選択します。

「ページ・アイテムの編集」ページが表示されます。

4. 「デフォルト」までスクロールします。

5. 「デフォルト値」に値を入力します。

6. 「デフォルト値のタイプ」で、次のいずれかを選択します。

- セッション・ステートの置換機能付き静的テキスト

- PL/SQLファンクション本体

- PL/SQL式

7. 「変更の適用」をクリックします。

ページ・アイテム・セキュリティの構成

ページ・アイテムの編集ページの「セキュリティ」リージョンで、アイテムのセキュリティを構成できます。

ページ・アイテム・セキュリティを構成するには、次のステップを実行します。

1. 該当する「ページ定義」にナビゲートします。「「ページ定義」へのアクセス」を参照してください。

2. アイテムの属性ページにアクセスします。

- ツリー・ビュー: アイテムを右クリックし、「編集」を選択します。

- コンポーネント・ビュー: 「アイテム」で、アイテム名を選択します。

「ページ・アイテムの編集」ページが表示されます。

3. 「セキュリティ」までスクロールします。

4. 表7-11に示す属性を構成します。

表7-11 ページ・アイテムの編集、「セキュリティ」

属性

説明

認可スキーム

このコンポーネントをレンダリングまたは処理するために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コメント)を許可しません。

- ブラックリスト<>"/;,*|=%または--と改行
&、<、>、"、/、;、"、"、*、|、=、%、"--"および改行文字を許可しません。

関連項目: 「クロスサイト・スクリプティング保護の理解」

クイック選択の作成

アイテム・タイプでクイック選択がサポートされている場合は、「クイック選択」属性を使用して、特定のアイテムの下に表示される選択項目を最大10個定義できます。クイック選択をクリックすると、アイテムの値が設定されます。次の例は、5%、10%、15%および20%のクイック選択を示しています。

図quick_pick.gifの説明

クイック選択を作成するには、次のステップを実行します。

1. アイテムを作成します。「ページ・レベル・アイテムの作成」を参照してください。

2. 該当する「ページ定義」にナビゲートします。「「ページ定義」へのアクセス」を参照してください。

3. アイテムの属性ページにアクセスします。

- ツリー・ビュー: アイテムを右クリックし、「編集」を選択します。

- コンポーネント・ビュー: 「アイテム」で、アイテム名を選択します。

「ページ・アイテムの編集」ページが表示されます。

4. 「クイック選択」までスクロールします。

5. 「クリック選択の表示」で、「はい」を選択します。

6. 各クイック選択のラベルと値を定義します。

1. 「ラベル」で、各選択項目に表示するラベルを入力します。

2. 「値」で、対応する値を入力します。

7. 「リンク属性」で、クイック選択の追加属性を入力します。

8. 「変更の適用」をクリックします。

複数のアイテムの同時編集

アイテム属性でページ上のアイテムの表示方法を制御します。ページ・アイテム・ページを使用して順序、フィールド・ラベル、テンプレート、リージョン、およびページ上のすべてのアイテムの全体的な配置を編集できます。次に続くセクションでは、これらのページを使用したアイテムの編集方法について説明します。

内容は次のとおりです。

- アイテム

- リージョン・アイテムの再割当て

- 複数のアイテムの削除

- アイテム・ユーティリティの表示

- 履歴

関連項目:
「アイテム属性がページ・レイアウトに与える影響」

アイテム

複数のアイテムを同時に編集するには、次のステップを実行します。

1. 該当する「ページ定義」にナビゲートします。「「ページ定義」へのアクセス」を参照してください。

2. ページ・アイテム・ページにアクセスします。

- ツリー・ビュー: 「アイテム」を右クリックし、「すべて編集」を選択します。

- コンポーネント・ビュー: 「アイテム」で、「すべて編集」アイコンをクリックします。「すべて編集」アイコンは、鉛筆が置かれた小さいページの形をしています。
図edit_all_item.gifの説明

「アイテム」タブが表示されます。

ページ上部にナビゲーション・バーが表示されます。「アイテム名」フィールドを使用して、特定のアイテムを検索します。他のページにナビゲートするには、「ページ」フィールドを使用します。表示を特定のリージョンのアイテムのみに限定するには、「リージョン」リストから選択します。

関連項目:
ページ・アイテム属性の編集

ページ・アイテム・ページには、編集可能なレポートのアイテムが表示されます。表7-12はそれぞれの編集可能な属性の説明です。

表 7-12 ページ・アイテム上の編集可能な属性

属性

説明

順序

このコンポーネントの表示順序を指定します。これによって評価の順序が決まります。

プロンプト

HTMLフォーム要素のラベルを入力します。HTML、JavaScriptおよびショートカットを含めることができます。置換文字列#CURRENT_ITEM_NAME#を使用して、このラベルに関連するアイテムの名前を取得することもできます。

フィールド・テンプレート

ラベル・テンプレートを決定します。ラベル・テンプレートを使用すると、中心部のユーザー・インタフェースの属性の定義、および多くのラベル間での定義の共有ができます。

リージョン

アイテムを表示するリージョンを定義します。すべてのアイテムは、リージョンに存在します。

新しい行

前のアイテムと同じ行に表示するかどうか、または次の行に表示するかどうかを決定します。アイテムはHTML表に配置されます。表の新しい行の第1フィールドとしてアイテムを表示する場合は、「はい」を選択します。

新規フィールド

「はい」に設定すると、このアイテムは固有のHTML表セル(デフォルト)にレンダリングされます。「いいえ」に設定すると、アイテムは前のページ・アイテムと同じHTML表セルにレンダリングされます。

同じ表セルにレンダリングする方が、前のページ・アイテムとの関連性が高く見えます。

幅

このアイテムに対して表示されるフォーム要素の長さを(文字で)指定します。

高さ

テキスト領域および複数の選択リストのための高さを(列で)指定します。

列スパン

アイテムは、HTML表に配置されます。このプロパティは表セルのCOLSPAN属性に使用される値を定義します。

行スパン

アイテムは、HTML表に配置されます。この属性はアイテムを表示する表セルのROWSPAN属性に使用される値を定義します。

PostElement

テキストまたはHTMLコードがページ・アイテム要素の直後にレンダリングされます。

リージョン・アイテムの再割当て

リージョン・アイテムの再割当てページを使用してアイテムを新しいリージョンに割り当てます。

リージョン・アイテムの再割当てページで新しいリージョンにアイテムを割り当てるには、次のステップを実行します。

1. 該当する「ページ定義」にナビゲートします。「「ページ定義」へのアクセス」を参照してください。

2. ページ・アイテム・ページにアクセスします。

- ツリー・ビュー: 「アイテム」を右クリックし、「すべて編集」を選択します。

- コンポーネント・ビュー: 「アイテム」で、「すべて編集」アイコンをクリックします。「すべて編集」アイコンは、鉛筆が置かれた小さいグリッドの形をしています。

ページ・アイテム・ページが表示されます。

3. 「リージョン・アイテムの再割当て」をクリックします。
リージョン・アイテムの再割当てページが表示されます。

ページ上部のナビゲーション・バーを使用して、表示を縮小または拡大します。使用可能なオプションは次のとおりです。

- ページ: 新しい番号を選択または入力して「実行」をクリックします。

- リージョンの表示: 表示するリージョンを選択して「実行」をクリックします。

4. アイテムを他のリージョンに再割当てするには、次のステップを実行します。

1. 再割当てするアイテムを選択します。

2. 「リージョンへの割当て」から、新しいリージョンを選択します。

3. 「再割当て」をクリックします。

複数のアイテムの削除

複数のアイテムを一度に削除するには、複数のアイテムの削除ページを使用します。

複数のアイテムを削除するには、次のステップを実行します。

1. 該当する「ページ定義」にナビゲートします。「「ページ定義」へのアクセス」を参照してください。

2. ページ・アイテム・ページにアクセスします。

- ツリー・ビュー: アイテムを右クリックし、「すべて編集」を選択します。

- コンポーネント・ビュー: 「アイテム」で、「すべて編集」アイコンをクリックします。「すべて編集」アイコンは、鉛筆が置かれた小さいグリッドの形をしています。

ページ・アイテム・ページが表示されます。

3. 「複数のアイテムの削除」をクリックします。
複数のアイテムの削除ページが表示されます。

ページ上部のナビゲーション・バーを使用して、表示を縮小または拡大します。新しいページにナビゲートするには、「ページ」フィールドを使用します。新しい番号を選択または入力して「実行」をクリックします。

4. アイテムを削除するには、次のステップを実行します。

1. アイテムを選択します。

2. 「アイテムの削除」をクリックします。

アイテム・ユーティリティの表示

ユーティリティ・ページには、選択したアプリケーション内の複数のページのアイテムを編集できるグリッド編集ページおよびレポートが含まれます。

ユーティリティ・ページにアクセスするには、次のステップを実行します。

1. 該当する「ページ定義」にナビゲートします。「「ページ定義」へのアクセス」を参照してください。

2. ページ・アイテム・ページにアクセスします。

- ツリー・ビュー: アイテムを右クリックし、「すべて編集」を選択します。

- コンポーネント・ビュー: 「アイテム」で、「すべて編集」アイコンをクリックします。「すべて編集」アイコンは、鉛筆が置かれた小さいグリッドの形をしています。

ページ・アイテム・ページが表示されます。

3. 次のいずれかのレポートを選択します。

- すべてのアイテム・ラベルのグリッド編集

- すべてのアイテム・ヘルプ・テキストのグリッド編集

- アイテム・ヘルプのサブスクリプション

- すべてのページ・アイテム

- 条件付きアイテム

履歴

履歴ページを使用してページ・レベル・アイテムに対して行われた最近の編集の概要を表示します。

アイテム値の参照

リージョン、計算、プロセス、検証およびブランチのセッション・ステートに格納されたアイテム値を参照できます。表 7-13に、アイテム値を参照するためにサポートされている構文を示します。

関連項目:
「セッション・ステート値の管理」

表7-13アイテム値を参照するための構文

タイプ

構文

説明

SQL

:MY_ITEM

名前が30バイト以下のアイテム用の標準のバインド変数構文。この構文は、SQL問合せおよびPL/SQLコード内の参照用に使用します。

PL/SQL

V('MY_ITEM')

Vファンクションを使用してアイテム値を参照するPL/SQL構文。この構文は、パッケージまたはストアド・プロシージャやファンクションのPL/SQLコードで使用します。

この構文をSQL文で使用しないでください。使用すると、パフォーマンスの問題が発生する場合があります。

関連項目: Oracle Application Express APIリファレンス

PL/SQL

NV('MY_NUMERIC_ITEM')

NVファンクションを使用して数値アイテム値を参照する標準のPL/SQL構文。この構文は、パッケージまたはストアド・プロシージャやファンクションのPL/SQLコードで使用します。

この構文をSQL文で使用しないでください。使用すると、パフォーマンスの問題が発生する場合があります。

関連項目: Oracle Application Express APIリファレンス

静的テキスト(完全置換)

&MY_ITEM.

静的テキスト。完全置換です。

注意: 正確な置換構文をSQLまたはPL/SQLコードで使用しないでください。使用すると、SQLインジェクションに対して脆弱になる可能性があります。

次のいずれかの方法を使用すると、アプリケーションのアイテム値を設定できます。

- ページ・レベル・アイテムの場合、ソース属性を使用してアイテム値を設定します。
「ページ定義」で、アイテム名を選択して「ページ・アイテムの編集」ページを表示します。「ソース」までスクロールして、該当するフィールドを編集します。

次の構文を使用して、PL/SQLまたはプロセスに基づく任意のリージョンのアイテム値を設定することもできます。

BEGIN
:MY_ITEM :=  'new value';
END;

- f?p構文を使用してURL参照の値を渡します。次に例を示します。

f?p=100:101:10636547268728380919::NO::MY_ITEM:ABC

- 計算を使用して値を設定します。計算は、アイテム値を設定するように設計されています。次に例を示します。

TO_CHAR(SYSDATE,'Day DD Month, YYYY');

- PL/SQL APIを使用して、PL/SQLコンテキストにアイテム値を設定します。次に例を示します。

APEX_UTIL.SET_SESSION_STATE('MY_ITEM',SYSDATE);

関連項目:
「セッション・ステートのクリア」、Oracle Application Express APIリファレンスおよび「クロスサイト・スクリプティング保護の理解」

条件付きページ・アイテムまたは読取り専用ページ・アイテムの表示

「ページ・アイテムの編集」ページで属性を編集することによって、アイテムを条件付きまたは読取り専用で表示できます。

内容は次のとおりです。

- 条件付きページ・アイテムの表示

- 読取り専用ページ・アイテムの表示

条件付きページ・アイテムの表示

条件付きアイテムを表示するには、次のステップを実行します。

1. アイテムを作成します。「ページ・レベル・アイテムの作成」を参照してください。

2. 該当する「ページ定義」にナビゲートします。「「ページ定義」へのアクセス」を参照してください。

3. アイテムの属性ページにアクセスします。

- ツリー・ビュー: アイテムを右クリックし、「編集」を選択します。

- コンポーネント・ビュー: 「アイテム」で、アイテム名を選択します。

「ページ・アイテムの編集」ページが表示されます。

4. 「条件」までスクロールします。

5. 「条件タイプ」リストから選択します。

6. 表示されるフィールドに式を入力します。

7. 「変更の適用」をクリックします。

読取り専用ページ・アイテムの表示

読取り専用アイテムを表示するには、次のステップを実行します。

1. アイテムを作成します。「ページ・レベル・アイテムの作成」を参照してください。

2. 該当する「ページ定義」にナビゲートします。「「ページ定義」へのアクセス」を参照してください。

3. アイテムの属性ページにアクセスします。

- ツリー・ビュー: アイテムを右クリックし、「編集」を選択します。

- コンポーネント・ビュー: 「アイテム」で、アイテム名を選択します。

「ページ・アイテムの編集」ページが表示されます。

4. 「読取り専用」までスクロールします。「読取り専用」で、次のステップを実行します。

1. 「読取り専用条件タイプ」リストから選択します。

2. 表示されるフィールドに式を入力します。

3. 「読取り専用の要素表のセル属性」で、HTML表セル・タグ<td>に含める属性を入力します。このタグには、読取り専用モードで表示される際のアイテムも含まれます。次に例を示します。

bgcolor="#FF0000"

5. 「変更の適用」をクリックします。

複数選択リスト・アイテムでの操作

複数選択アイテムは複数選択リストのフォーム要素としてレンダリングされ、複数選択リストまたはシャトル・アイテム・タイプのいずれかになります。送信されると、選択した値は単一のコロンで区切られた文字列に戻されます。このフォーマットの値は3通りの方法で処理できます。

- INSTRファンクションの使用

- APEX_UTIL.STRING_TO_TABLEファンクションの使用

- シャトルの作成

内容は次のとおりです。

- APEX_UTIL.STRING_TO_TABLEを使用した選択値の変換

- シャトル・アイテム・タイプの作成

APEX_UTIL.STRING_TO_TABLEを使用した選択値の変換

たとえば、部門の複数選択リストから選択した部門によって限定されているEMP表およびDEPT表に関するレポートがあるとします。まず、次の問合せを使用して、複数選択アイテム「P1_DEPTNO」を作成します。

SELECT dname, deptno
FROM dept

次に、次のように入力して、選択した部門内の従業員のみを戻します。

SELECT ename, job, sal, comm, dname
FROM emp e, dept d
WHERE d.deptno = e.deptno
AND instr(':'||:P1_DEPTNO||':',':'||e.deptno||':') > 0

次に、複数選択アイテム「P1_DEPTNO」で選択した値をプログラムで処理するとします。このタスクを実行するには、APEX_UTIL.STRING_TO_TABLEファンクションを使用して、コロンで区切られた文字列をPL/SQL配列に変換します。次の例では、選択した部門を問合せの日付が含まれている監査表に挿入する方法を示します。

DECLARE
l_selected APEX_APPLICATION_GLOBAL.VC_ARR2;
BEGIN
--
-- Convert the colon separated string of values into
-- a PL/SQL array

l_selected := APEX_UTIL.STRING_TO_TABLE(:P1_DEPTNO);

--
-- Loop over array to insert department numbers and sysdate
--

FOR i IN 1..l_selected.count
LOOP
INSERT INTO report_audit_table (report_date, selected_department)
VALUES (sysdate, l_selected(i));
END LOOP;
END;

関連項目:
Oracle Application Express APIリファレンスの「STRING_TO_TABLEファンクション」

シャトル・アイテム・タイプの作成

DEPT表に、特定の部門に割り当てられている従業員が表示されるフォームがあるとします。部門への従業員の割当てを容易にするには、従業員をアルファベット順にリストするシャトル・アイテムを作成します。

シャトル・アイテムを作成するには、次のステップを実行します。

1. 「レポート付きの表のフォーム」を使用して、DEPTに新しいフォーム・ページを作成します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「ページの作成」をクリックします。

4. 「ページ・タイプ」で、「フォーム」を選択します。

5. 「フォーム」で、「レポート付きの表のフォーム」を選択します。

6. 「レポート・ページ」で、デフォルト値を受け入れて「次」をクリックします。

7. 「表/ビューの名前」で、「DEPT」を選択します。

8. 残りのデフォルト値を受け入れ、画面に表示されるステップに従います。特定のフィールドの詳細を表示するには、アイテム・ラベルをクリックします。

2. P2_EMP_LISTという名前のシャトルとフォーム・ページを作成します。

1. フォーム・ページの「ページ定義」に移動します。

2. フォームが含まれるリージョンを右クリックし、「ページ・アイテムの作成」を選択します。

3. 「アイテム・タイプ」で、「シャトル」を選択します。

4. 「アイテム名」で、P2_EMP_LISTと入力し、「次へ」をクリックします。

ヒント:
この例では、アイテム名P2_EMP_LISTのP2はアイテムがページ2に存在することを示しています。

5. 「アイテム属性」で、デフォルト値を受け入れ、「次へ」をクリックします。

6. 「設定」で、デフォルト値を受け入れ、「次へ」をクリックします。

7. 「LOV」では次を実行します。

- LOV問合せ: 次のように入力します。

SELECT ename, empno FROM emp ORDER BY 1

- 「次へ」をクリックします。

8. 「ソース」で、次の項目を指定します。

- ソース・タイプ: 「SQL問合せ(コロン区切りの値を返す)」を選択します。

- アイテム・ソース値: 次のように入力します。

SELECT empno FROM emp WHERE deptno = :P2_DEPTNO ORDER BY ename

- 「アイテムの作成」をクリックします。

9. 「ページの実行」アイコンをクリックしてページを実行します。
図shuttle_example.gifの説明

アプリケーション・レベル・アイテムの理解

アプリケーション・レベル・アイテムは表示されませんが、アプリケーションのグローバル変数として使用されます。アプリケーション・アイテムは、グローバル変数として使用できます。

内容は次のとおりです。

- アプリケーション・レベル・アイテムの作成

- アプリケーション・アイテムの使用状況の表示

- アプリケーション・レベル・アイテム属性の編集

- グローバル変数として機能するアプリケーション・レベル・アイテムの作成

関連項目:
「ページ・アイテムとアプリケーション・アイテムの違い」および「アイテム値の参照」

アプリケーション・レベル・アイテムの作成

アプリケーション・レベル・アイテムを作成するには、次のステップを実行します。

1. 「ワークスペース」ホームページにナビゲートします。

2. 「アプリケーション・ビルダー」アイコンをクリックします。

3. アプリケーションを選択します。

4. 「アプリケーション」ホームページが表示されたら、「共有コンポーネント」をクリックします。

5. 「ロジック」で、「アプリケーション・アイテム」を選択します。
アプリケーション・アイテム・ページが表示されます。

6. アプリケーション・アイテムを作成するには、「作成」をクリックします。
作成/編集ページが表示されます。

7. 「名前」で、次のステップを実行します。

1. 名前: アプリケーション・レベル・アイテムの名前を入力します。

2. 有効範囲: オプションは次のとおりです。

- グローバル: アプリケーションが同じワークスペース内の他のアプリケーションとセッション・ステートを共有する場合は、このオプションを選択します。詳細は、「グローバル変数として機能するアプリケーション・レベル・アイテムの作成」を参照してください。

- アプリケーション: アプリケーションが別のアプリケーションとセッション・ステートを共有しない場合は、このオプションを選択します。

8. 「セキュリティ」の「セッション・ステート保護」で、次のように指定します。

- 制限なし: URLまたはフォームでアイテム名/値を渡して、アイテムのセッション・ステートを設定できます。URLにチェックサムは必要ありません。
注意: Ajaxを使用してこのアイテムの値をセッション・ステートに設定する必要がある場合は、アイテムに対して「制限なし」保護レベルを使用する必要があります(たとえば「動的アクション」の場合は、「値の設定」、「送信するページ・アイテム」またはカスケードLOV、「送信するページ・アイテム」)。

- 制限付き - ブラウザから設定できない: URLまたはPOSTDATAを使用してアイテムを変更できません。アイテムの値を内部プロセス、計算などに設定できる方法を制限する場合は、このオプションを使用します。この属性は、データ・エントリ・アイテムとして使用できないアイテムのみに適用され、セッション・ステート保護が無効になっていても常に監視されます。次の表示形式タイプのアプリケーション・アイテムについては、この属性を使用します。

- 表示のみ(ステートの保存=いいえ)

- 表示のみ(状態の保存=なし)

- 「グリッド・レイアウドの停止と開始」(ラベルのみ表示)

- チェックサムが必要 - アプリケーション・レベル: スキーマ固有のチェックサムを入力する場合は、URLでアイテムの名前/値を渡して、アイテムのセッション・ステートを設定できます。ユーザー・レベル・チェックサムまたはセッション・レベル・チェックサムも使用できます(次の項目を参照)。現行のワークスペースの別のセッションで同じアプリケーションを実行しているユーザーが生成したチェックサムを含むURLによってのみ、このアイテムを設定できるようにする場合に、このオプションを使用します。

- チェックサムが必要: ユーザー・レベル: ワークスペース、アプリケーションおよびユーザー固有のチェックサムを入力する場合は、URLでアイテムの名前/値を渡して、アイテムのセッション・ステートを設定できます。セッション・レベル・チェックサムも使用できます(次の項目を参照)。現行のワークスペースの別のセッションで同じアプリケーションを実行しているユーザーが生成したチェックサムを含むURLによってのみ、このアイテムを設定できるようにする場合に、このオプションを使用します。

- チェックサムが必要: セッション・レベル: カレント・セッション固有のチェックサムを入力する場合は、URLでアイテムの名前/値を渡して、アイテムのセッション・ステートを設定できます。カレント・セッションで生成されたチェックサムを含むURLによってのみ、このアイテムを設定できるようにする場合に、このオプションを使用します。

9. 「ビルド・オプション」で、このコンポーネント用のビルド・オプションを選択します。ビルド・オプションは、アプリケーション内のコンポーネントが有効かどうかを判別する事前定義された設定です。

10. 「コメント」に、このアイテムに関する注意を入力します。

11. 「アプリケーション・アイテムの作成」をクリックします。

「アプリケーション・アイテム」ページについて

アプリケーション・アイテムを作成すると、そのアイテムはアプリケーション・アイテム・ページに表示されます。ページの外観は、ページ上部にある検索バーを使用してカスタマイズできます。使用可能なコントロールは次のとおりです。

- 検索列の選択: 虫めがねに似ています。このアイコンをクリックして、検索を絞り込みます。すべての列を検索するには、「すべての列」を選択します。

- テキスト領域: 名前でアイテムを検索するための大/小文字を区別しない検索基準(ワイルドカード文字は暗黙的に定義される)を入力し、「実行」をクリックします。

- 「実行」ボタン: 検索を実行したり、フィルタを適用します。

- アイコンの表示: 各アイテムを大きいアイコンとして表示します。アイテムを編集するには、該当するアイコンをクリックします。

- レポートの表示: 各アイテムをレポート内の1行として表示します。アイテムを編集するには、名前をクリックします。

- 「アクション」メニュー: 「アクション」メニューを使用して、レポート・ビューをカスタマイズします。「「アクション」メニューについて」を参照してください。

アプリケーション・アイテムの使用状況の表示

アプリケーション・アイテム・ページの上部にある「使用状況」タブをクリックして、アプリケーション・アイテムが使用されている場所のリストを表示できます。

アプリケーション・レベル・アイテム属性の編集

作成したアプリケーション・レベル・アイテムは、アプリケーション・アイテムの作成/編集ページで編集できます。

アプリケーション・レベル・アイテム属性を編集するには、次のステップを実行します。

1. 「ワークスペース」ホームページにナビゲートします。

2. 「アプリケーション・ビルダー」アイコンをクリックします。

3. アプリケーションを選択します。

4. 「アプリケーション」ホームページが表示されたら、「共有コンポーネント」をクリックします。

5. 「ロジック」で、「アプリケーション・アイテム」を選択します。
アプリケーション・アイテム・ページが表示されます。「アプリケーション・アイテム・ページについて」を参照してください。

6. アプリケーション・アイテムを選択します。
作成/編集ページが表示されます。

7. ページ上の特定のアイテムの詳細を表示するには、アイテム・ラベルをクリックします。
ヘルプが使用可能な場合は、アイテムにカーソルをあわせると、カーソルが疑問符付きの矢印に変わります。「フィールドレベル・ヘルプについて」を参照してください。

8. 「変更の適用」をクリックします。

関連項目:
「クロスサイト・スクリプティング保護の理解」

ナビゲーションの選択肢について

アプリケーション・アイテムの作成/編集ページは、「名前」、「セキュリティ」、「構成」および「コメント」などのセクションに分かれています。

これらのセクションにはページをスクロールするか、ページ上部のナビゲーション・ボタンをクリックすることでアクセスできます。ページ上部のボタンを選択すると、選択されたセクションが表示され、その他のセクションはすべて一時的に非表示になります。ページのすべてのセクションを表示するには、「すべて表示」をクリックします。

グローバル変数として機能するアプリケーション・レベル・アイテムの作成

大規模なアプリケーションを同じワークスペースに配置される複数の物理アプリケーションに分割することがよくあります。多くの場合、これらのアプリケーションでは、各アプリケーションに同じCookie名を構成することで、セッション・ステートを共有します。

このタイプのアーキテクチャのもう1つの要件として、少数のグローバル変数を共有する必要があります。グローバル変数の数を少なく保つかぎり、グローバル変数はアプリケーション間の通信を簡単にする効果的な手段として機能します。次に例を示します。

- 現行ユーザーのプロパティ(電子メール・アドレス、従業員番号など)

- マルチテナント・アプリケーション内の現行の会社

グローバル変数は、アプリケーション・レベル・アイテムをすべてのアプリケーションで同じ名前で作成し、有効範囲を「グローバル」に設定することで生成できます。

グローバル変数として機能するアプリケーション・レベル・アイテムを作成するには、次のステップを実行します。

1. セッション・ステートを共有する各アプリケーションで、同じ名前でアプリケーション・レベル・アイテムを作成します。

2. 「有効範囲」で、「グローバル」を選択します。

3. 「セキュリティ」の「セッション・ステート保護」で、制限付きを選択します。

詳細は、「アプリケーション・レベル・アイテムの作成」を参照してください。

アプリケーション・ユーティリティおよびレポートの表示

Oracle Application Expressには数多くのレポートが用意され、アプリケーションの様々な側面からのビューが提供されます。これらのレポートを使用して、統計を表示したり、ページやアプリケーション・コンポーネントのレポート、テンプレート、プラグインおよび条件にアクセスできます。たとえば、アプリケーション内の全ページで使用されるボタンの詳細を表示できます。さらに、多くのレポートは更新可能なため、個々のページに移動せずにアイテムやリージョン・ラベルなどのコンポーネントを標準化できます。

内容は次のとおりです。

- アプリケーション・ビルダー・ユーティリティの使用

- ページ固有のユーティリティについて

- クロス・ページ・ユーティリティについて

- アプリケーション間レポートについて

関連項目:
「APEX_ACTIVITY_LOGを使用したカスタム・アクティビティ・レポートの作成」

アプリケーション・ビルダー・ユーティリティの使用

アプリケーション・ビルダー・ユーティリティ・ページには、アプリケーション全体の情報のサマリーを表示するツールおよびレポートが含まれています。

内容は次のとおりです。

- アプリケーション・ビルダー・ユーティリティ・ページについて

- アプリケーション・ダッシュボードの表示

- 「変更履歴」レポートの表示

- 「最近更新されたページ」レポートの表示

- 既存のアプリケーションのアップグレード

- 「データベース・オブジェクトの依存性」レポートの使用

- Application Expressビューについて

アプリケーション・ビルダー・ユーティリティ・ページについて

アプリケーション・ビルダー・ユーティリティ・ページにアクセスするには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「ユーティリティ」アイコンをクリックします。
図bldr_utilities.gifの説明

アプリケーション・ビルダー・ユーティリティ・ページには、次のツールおよびレポートにリンクするアイコンがあります。

- アプリケーション・ダッシュボード: 詳細は、「アプリケーション・ダッシュボードの表示」を参照してください。

- 変更履歴: 「「変更履歴」レポートの表示」を参照してください。

- 最近更新されたページ: 「「最近更新されたページ」レポートの表示」を参照してください。

- エクスポート・リポジトリ: 「エクスポート・リポジトリへのアクセス」を参照してください。

- デバッグ・メッセージ: 「アプリケーションのデバッグ」を参照してください。

- アドバイザ: 「アプリケーション整合性のチェックのためのアドバイザの実行」を参照してください。

- アプリケーションのアップグレード: 「既存のアプリケーションのアップグレード」を参照してください。

- データベース・オブジェクトの依存性: 「「データベース・オブジェクトの依存性」レポートの使用」を参照してください。

- 属性ディクショナリの管理: 「属性ディクショナリの使用」を参照してください。

- Application Expressビュー: 「Application Expressビューについて」を参照してください。

ページ固有のユーティリティ

図page_util.gifの説明

「ページ固有のユーティリティ」は、ユーティリティ・ページの右側に表示されます。これらのユーティリティを使用して、アプリケーション・ページ全体のコンポーネント・レポートを表示したり、コンポーネント・タイプ(たとえば、リージョン、ボタン、アイテム、検証、プロセス、動的アクションまたはブランチ)別のコンポーネント・レポートを表示できます。詳細は、「ページ固有のユーティリティについて」および「クロス・ページ・ユーティリティについて」を参照してください。

アプリケーション・ダッシュボードの表示

「アプリケーション・ダッシュボード」には、アプリケーション・コンポーネントと属性の詳細が表示されます。

「アプリケーション・ダッシュボード」を表示するには、次のステップを実行します。

1. 「ワークスペース」ホームページにナビゲートします。

2. 「アプリケーション・ビルダー」アイコンをクリックします。

3. アプリケーションを選択します。
「アプリケーション」ホームページが表示されます。

4. 「ユーティリティ」をクリックします。

5. 「アプリケーション・ダッシュボード」をクリックします。
「アプリケーション・ダッシュボード」が表示され、次のセクションが表示されます。

- アプリケーション概要: カレント・アプリケーションに関する詳細情報および統計(ID、名前、別名、解析対象スキーマ、関連付けられているグループ、ページ数、関連付けられているテーマなど)が表示されます。

- セキュリティ: 現在の認証スキーム、パブリック・ページと非パブリック・ページの数およびカレント・アプリケーション内で使用される認可スキームの数が表示されます。

- テンプレート: カレント・アプリケーション内で使用されるテンプレートのレポートへのリンクが表示されます。

- タイプ別の表示: コンポーネント(レポートとフォームのタイプ、動的HTMLなど)のカウントが表示されます。

- アプリケーション・コンポーネント: アプリケーション・レベルのコントロールとロジックのレポート(リスト、ショートカット、LOV、タブ、アプリケーションの計算、アプリケーション・アイテム、プラグイン、アプリケーション・プロセスなど)へのリンクが表示されます。

- ページ・コンポーネント: ページ・レベルのコントロールとロジックのレポート(リージョン、アイテム、ブランチ、計算、検証、動的アクション、クラシック・レポートの列、対話モード・レポートの列、ボタンなど)へのリンクが表示されます。

6. 特定のレポートを表示するには、コンポーネント・タイプまたはテンプレートの右にある数字をクリックします。

関連項目:
「問題を引き起こす可能性のあるパスワード・アイテムの識別」

「変更履歴」レポートの表示

「変更履歴」レポートには、カレント・アプリケーションに対する編集のサマリー・レポートが開発者、コンポーネント・タイプおよびページ番号別に表示されます。

「変更履歴」レポートを表示するには、次のステップを実行します。

1. 「ワークスペース」ホームページにナビゲートします。

2. 「アプリケーション・ビルダー」アイコンをクリックします。

3. アプリケーションを選択します。
「アプリケーション」ホームページが表示されます。

4. 「ユーティリティ」をクリックします。

5. 「変更履歴」をクリックします。
検索バーがページの上部に表示されます。「検索バーの使用」を参照してください。

「最近更新されたページ」レポートの表示

「最近更新されたページ」レポートには、現在のユーザーによって最近更新されたページのレポートが表示されます。

「最近更新されたページ」レポートを表示するには、次のステップを実行します。

1. 「ワークスペース」ホームページにナビゲートします。

2. 「アプリケーション・ビルダー」アイコンをクリックします。

3. アプリケーションを選択します。
「アプリケーション」ホームページが表示されます。

4. 「ユーティリティ」をクリックします。

5. 「最近更新されたページ」をクリックします。
検索バーがページの上部に表示されます。「検索バーの使用」を参照してください。

既存のアプリケーションのアップグレード

現在のリリースで使用可能な新しいコンポーネントが組み込まれるように既存のアプリケーションをアップグレードするには、ユーティリティ・ページの「アプリケーションのアップグレード」アイコンを使用します。この機能によって、次のコンポーネントがアップグレードされます。

- 「テキスト・フィールド」アイテムを「数値フィールド」アイテムに更新します(IS NUMERIC検証がある場合)。

- 「必須の値」アイテム属性を「はい」に更新します(NOT NULL検証がある場合)。

- 日付ピッカー(クラシック)を新しい日付ピッカーにアップグレードします。

- ページ・アイテムのLOVのNULL戻り値で%null%を削除します。

- FCKEditor 2をCKEditor 3にアップグレードします。

- SVGチャートをHTML5チャートにアップグレードします。

- FlashチャートをFlash 6チャートにアップグレードします。

- FlashチャートをHTML5チャートにアップグレードします。

- 対話モード・レポート:

- 対話モード・レポートに対してグループ化を有効にします。

- 対話モード・レポートに対してパブリック・レポートの保存を有効にします。

- 対話モード・レポートに対してサブスクリプションを有効にします。

- 対話モード・レポートに対してページごとの行数セレクタを有効にします。

- 数値、必須および日付ピッカー・アイテムは条件付き検証に基づいて更新されます。
ウィザードでは、関連するすべての検証がページごとに表示され、アイテム設定に置き換える検証を選択できます。続いて、検証を実行しないようにするボタン(「取消」など)を選択します。最後に、常に実行する検証(たとえば、削除前の権限のチェックなど)を選択できます。

既存のアプリケーションをアップグレードするには、次のステップを実行します。

1. 「ワークスペース」ホームページにナビゲートします。

2. 「アプリケーション・ビルダー」アイコンをクリックします。

3. アプリケーションを選択します。
「アプリケーション」ホームページが表示されます。

4. 「ユーティリティ」をクリックします。

5. 「アプリケーションのアップグレード」をクリックします。

6. 画面に表示されるステップに従います。

「データベース・オブジェクトの依存性」レポートの使用

「データベース・オブジェクトの依存性」レポートは、カレント・アプリケーションで参照されるデータベース・オブジェクトを識別します。アプリケーションのデプロイ時に移動するオブジェクトを判別するには、このレポートを確認します。

データベース・オブジェクトの依存性レポートを表示するには、次のステップを実行します。

1. 「ワークスペース」ホームページにナビゲートします。

2. 「アプリケーション・ビルダー」アイコンをクリックします。

3. アプリケーションを選択します。
「アプリケーション」ホームページが表示されます。

4. 「ユーティリティ」をクリックします。

5. 「データベース・オブジェクトの依存性」をクリックします。
データベース・オブジェクトの依存性ページが表示されます。

6. 「依存性の計算」をクリックします。

ヒント:
アプリケーションのサイズや複雑性に応じて、レポートの表示に時間がかかる場合があります。

「データベース・オブジェクトの依存性」レポートが表示されます。

Application Expressビューについて

Application Expressビューは、アプリケーションのメタデータを公開するデータ・ディクショナリ・ビューです。Application Expressビューでは、ビューを表示するだけでなく、ビューに含まれているデータを表示することもできます。

Application Expressビュー・ページにアクセスするには、次のステップを実行します。

1. 「ワークスペース」ホームページにナビゲートします。

2. 「アプリケーション・ビルダー」アイコンをクリックします。

3. アプリケーションを選択します。
「アプリケーション」ホームページが表示されます。

4. 「ユーティリティ」をクリックします。

5. 「Application Expressビュー」をクリックします。
Application Expressビュー・ページが表示されます。

検索バーがページの上部に表示されます。使用可能なコントロールは次のとおりです。

- 検索列の選択: 虫めがねに似ています。このアイコンをクリックして、検索を絞り込みます。すべての列を検索するには、「すべての列」を選択します。

- テキスト領域: 名前でビューを検索するための大/小文字を区別しない検索基準(ワイルドカード文字は暗黙的に定義される)を入力し、「実行」をクリックします。

- 「実行」ボタン: 検索を実行したり、フィルタを適用します。

- アイコンの表示: 各ビューを大きいアイコンとして表示します。ビューにアクセスするには、該当するアイコンをクリックします。

- レポートの表示: 各ビューをレポート内の1行として表示します。ビューにアクセスするには、名前をクリックします。

- 「アクション」メニュー: 「アクション」メニューを使用して、レポート・ビューをカスタマイズします。「「アクション」メニューについて」を参照してください。

6. ビューを選択します。

ビュー内のデータを表示するには、「列の選択」タブで列を選択し、「結果」ボタンをクリックします。

「結果」タブで、「問合せ」リージョンを拡張して、実行された問合せを表示します。この問合せをコピーしてSQLコマンドまたはSQL Developerで再利用できます。

図apex_views.gifの説明

ページ固有のユーティリティについて

「ページ固有のユーティリティ」は、ユーティリティ・ページの右側に表示されます。これらのユーティリティを使用して、アプリケーション・ページ全体のコンポーネント・レポートを表示したり、コンポーネント・タイプ(たとえば、リージョン、ボタン、アイテム、計算、検証、プロセス、動的アクションまたはブランチ)別のコンポーネント・レポートを表示します。

図page_util.gifの説明

ページ固有のユーティリティ・ページにアクセスするには、次のステップを実行します。

1. Oracle Application Expressにログインします。
「ワークスペース」ホームページが表示されます。

2. 「アプリケーション・ビルダー」アイコンをクリックします。
「アプリケーション・ビルダー」ホームページが表示されます。

3. アプリケーションを選択します。
「アプリケーション」ホームページが表示されます。

4. 「ユーティリティ」をクリックします。

5. 「ページ固有のユーティリティ」で、次のいずれかを選択します。

- クロス・ページ・ユーティリティ: 「クロス・ページ・ユーティリティについて」を参照してください。

- リージョン・ユーティリティ

- ボタン・ユーティリティ

- アイテム・ユーティリティ

- 計算ユーティリティ

- プロセス・ユーティリティ

- 動的アクション・ユーティリティ

- ブランチ・ユーティリティ

クロス・ページ・ユーティリティについて

クロス・ページ・ユーティリティ・ページでは、次のツールおよびレポートにアクセスできます。

- 最近更新されたページ: カレント・アプリケーションの最近更新されたページのレポートを表示します。「最近更新されたページについて」を参照してください。

- すべてのページのグリッド編集:複数のページに適用される複数のページ属性をグリッド形式で編集します。「すべてのページのグリッド編集について」を参照してください。

- 複数のページの削除: 「複数のページの削除について」を参照してください。

- ページ属性: 属性、コンポーネント、コントロールおよびアプリケーション・ロジックのページ別のレポートを表示します。「ページ属性について」を参照してください。

- ページ・グループ: 「ページ・グループについて」を参照してください。

- ページ・ロック: 「ページ・ロックについて」を参照してください。

関連項目:
「アプリケーション・ユーティリティとレポートの表示」

クロス・ページ・ユーティリティへのアクセス

ページ・ユーティリティ・ページにアクセスするには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「ユーティリティ」をクリックします。

4. 「ページ固有のユーティリティ」で、「クロス・ページ・ユーティリティ」をクリックします。

最近更新されたページについて

最近のページ・レポートには、カレント・アプリケーション内の最近アクセスしたページのレポートが表示されます。ページにリンクするには、ページ番号をクリックします。レポートをカスタマイズするには、ページ上部にある検索バーを使用します。「検索バーの使用」を参照してください。

すべてのページのグリッド編集について

「すべてのページのグリッド編集」レポートを使用して、ページ名、別名、タイトル、ページ・テンプレートおよびセキュリティ・オプションを編集します。特定のページにリンクするには、ページ番号の横の「編集」アイコンをクリックします。変更を保存するには、「変更の適用」をクリックします。

複数のページの削除について

複数のページを一度に削除するには、「複数のページの削除」を使用します。「複数のページの削除」を参照してください。

ページ属性について

「ページ属性」レポートには、カレント・アプリケーション内の各ページの属性、コンポーネント、コントロールおよびアプリケーション・ロジックの詳細が表示されます。レポートをカスタマイズするには、ページ上部にある検索バーを使用します。「検索バーの使用」を参照してください。

特定のページにリンクするには、ページ番号をクリックします。

ページ・グループについて

アプリケーション内のページをより適切に編成するには、「ページ・グループ」を使用します。「ページのグループ化」を参照してください。

ページ・ロックについて

アプリケーション開発中に競合が発生しないようにするには、「ページ・ロック」を使用します。ページをロックすると、他の開発者がページを編集できなくなります。「ページのロックおよびロック解除」を参照してください。

アプリケーション間レポートについて

現在のワークスペースで複数のアプリケーションの情報を表示および編集するには、アプリケーション間レポート・ページ上のリンクを使用します。アプリケーション間レポートには、アプリケーション・ビルダーのホームページからアクセスします。

アプリケーション間レポートにアクセスするには、次のステップを実行します。

1. Oracle Application Expressにログインします。
「ワークスペース」ホームページが表示されます。

2. 「アプリケーション・ビルダー」アイコンをクリックします。
「アプリケーション・ビルダー」ホームページが表示されます。

3. 「タスク」で、「アプリケーション間レポート」をクリックします。
アプリケーション間レポート・ページは次のセクションに分かれています。

- アプリケーション属性

- アプリケーションの比較レポート

- セキュリティ

- ユーザー・インタフェース

4. 確認するレポートを選択します。

8 データベース・アプリケーション・ページの操作

このセクションでは、データベース・アプリケーション内でページを操作する方法について、重要な情報を説明します。

内容は次のとおりです。

- 「ページ定義」について

- ページ属性の変更

- ページ計算の理解

- 検証の理解

- ページ・プロセスの理解

- ブランチの操作

- 共有コンポーネントでの作業

- アプリケーション・プロセスの理解

- アプリケーションの計算の理解

- 属性ディクショナリの使用

関連項目:
「クイック・スタート」、「アプリケーション・ビルダーの概念」、「データベース・アプリケーションについて」、「ページ・レイアウトの制御」および「ナビゲーションの追加」

「ページ定義」について

「ページ定義」は、ページの基本的な構成要素です。「ページ定義」を使用して、ページを定義するコントロールやアプリケーション・ロジックを表示、作成および編集できます。各ページはボタンとフィールド(アイテムと呼ばれる)を保持でき、これらのボタンとフィールドはリージョンと呼ばれるコンテナにグループ化されます。ページはアプリケーション・ロジック(プロセス)も保持できます。条件付きナビゲーションを使用したあるページから別のページへのブランチや、(計算と呼ばれる)計算の実行、(編集チェックなどの)検証の実行、レポート、カレンダおよびチャートの表示が可能です。「ページ定義」にアクセスして、ページを定義するコントロールの表示、作成および編集ができます。

内容は次のとおりです。

- 「ページ定義」へのアクセス

- ツリー・ビューとコンポーネント・ビューについて

- ツリー・ビューでのページの編集

- コンポーネント・ビューでのページの編集

- ページ・レンダリングについて

- ページ・プロセスについて

- 共有コンポーネントについて

- 「ページ定義」の共通要素

「ページ定義」へのアクセス

「ページ定義」を使用すると、ページを定義するコントロールを表示、作成および編集できます。

既存のページの「ページ定義」にアクセスするには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。
「アプリケーション・ビルダー」ホームページが表示されます。

2. アプリケーションを選択します。
「アプリケーション」ホームページが表示されます。

3. ページを選択します。
「ページ定義」が次のセクションに分かれて表示されます。

- ページ・レンダリング: ページ・レンダリングとは、データベースからページを生成するプロセスです。「ページ・レンダリング」セクションを使用して、ページ属性、リージョン、ボタン、アイテム、ページ・レンダリングの計算、およびページ・プロセスを含むページのレンダリングに影響するコントロールを変更できます。「ページ・レンダリングについて」を参照してください。

- ページ・プロセス: ページ・プロセスは、ページを送信するプロセスです。通常、ページは、ユーザーがボタンをクリックすると送信されます。「ページ定義」の「ページ・プロセス」セクションを使用して、計算、検証、プロセス、ブランチなどのアプリケーション・ロジックを指定します。通常、Application Expressエンジンは、「ページ定義」に表示される順序でこのロジックを実行します。詳細は、「ページ・プロセスについて」を参照してください。

- 共有コンポーネント: 「共有コンポーネント」セクションには、アプリケーション内の1つ以上のページで使用できる共通のコンポーネントが表示されます。詳細は、「共有コンポーネントについて」を参照してください。

ツリー・ビューとコンポーネント・ビューについて

ページは、アプリケーションの基本的な構成要素です。各ページには、 ページ番号、名前、および通常はヘッダー、タイトル、フッターなどのテキスト属性が含まれます。ページにコンテンツを追加するには、ページ・コントロール(リージョン、アイテムおよびボタン)を作成します。ページ・テンプレートおよびページ・リージョン・テンプレートは、各ページのルック・アンド・フィールを制御します。ページを表示する方法には、ツリー・ビューとコンポーネント・ビューの2通りあります。

内容は次のとおりです。

- ツリー・ビューとコンポーネント・ビューの切替え

- ツリー・ビューについて

- コンポーネント・ビューについて

ツリー・ビューとコンポーネント・ビューの切替え

ツリー・ビューとコンポーネント・ビューを切り替えるには、次のステップを実行します。

1. 「ページ定義」にナビゲートします。「「ページ定義」へのアクセス」を参照してください。
「ページ定義」が表示されます。デフォルトでは、各ページには、コンポーネントがツリーのノードとして表示されます。

2. コンポーネント・ビューに切り替えるには、ナビゲーション・バーの右にある「コメント・ビューに切替え」をクリックします。
図switch_to_component.gifの説明

3. ツリー・ビューに切り替えるには、「ツリー・ビューに切替え」をクリックします。
図switch_to_tree.gifの説明

ツリー・ビューについて

ツリー・ビューには、リージョン、ページ・アイテムおよびアプリケーション・ロジックがツリー内のノードとして表示されます。各ツリーでは、イベント順序や、Oracle Application Expressでページをレンダリングまたは処理するときのコンポーネントの処理方法に基づいてコンポーネントがグループ化されます。この編成により、コンポーネントが処理される時期をよりよく理解できます。

図pg_def_tree.gifの説明

このビューの主要な機能は次のとおりです。

- コンテキスト・メニュー: 各ツリー・ノードにはカスタム・コンテキスト・メニューがあります。コンテキスト・メニューにアクセスするには、右クリックします。

- 属性ページへの迅速なアクセス:属性を編集するには、ダブルクリックするか[ENTER]を押します。使用可能な場合、属性ページが表示されます。

- コンポーネントの容易な順序変更:ページ・アイテム、レポート列、プロセス、検証、ブランチまたは計算を別の表示、処理ポイントまたはリージョンにドラッグ・アンド・ドロップすることで、順序を変更できます。

- ツールチップ: 各ツリー・ノードには、コンポーネントについての基本情報(アイテム・タイプ、条件、認可など)を表示するツールチップがあります。

- コンポーネントの名前またはラベルの表示:ページを実行するときに表示されるコンポーネントの名前またはラベルのどちらを使用してページのコンポーネントを表示するかを選択できます(たとえば、アイテムの名前はP7_CUST_FIRST_NAMEですが、ラベルはFirst Nameです)。「名前とラベルの切替え」を参照してください

- 条件、認可およびビルド・オプションの識別:コンポーネントに条件、認可またはビルド・オプションがある場合、ツリー・ノード・ラベルはイタリック体で表示されます。

- デフォルト・ウィザードへの直接アクセス:各コンテキスト・メニューには、デフォルト・ウィザードにリンクするアクションが含まれています。たとえば、アイテムの「検証の作成」を選択すると、検証の作成ウィザードが表示されます。

詳細は、「ツリー・ビューでのページの編集」および「ツリー・ビューとコンポーネント・ビューの切替え」を参照してください。

コンポーネント・ビューについて

コンポーネント・ビューは、ユーザー・インタフェース要素とアプリケーション・ロジックをコンポーネント・タイプ別にグループ化します。

図pg_def.gifの説明

コンポーネントを編集するには、コンポーネント名をドリルダウンするか、アイコンをクリックします。詳細は、「コンポーネント・ビューでのページの編集」および「ツリー・ビューとコンポーネント・ビューの切替え」を参照してください。

ツリー・ビューでのページの編集

ツリー・ビューには、リージョン、ページ・アイテムおよびアプリケーション・ロジックがツリー内のノードとして表示されます。各ツリーでは、イベント順序や、Oracle Application Expressでページをレンダリングするときのコンポーネントの処理方法に基づいてコンポーネントがグループ化されます。この編成により、コンポーネントが処理される時期をよりよく理解できます。

内容は次のとおりです。

- ツリー・ビューについて

- コンテキスト・メニューへのアクセス

- 新規コンポーネントの作成

- ページ・コンポーネントの順序変更

- 名前とラベルの切替え

関連項目:
「ツリー・ビューとコンポーネント・ビューの切替え」および「「ページ定義」の共通要素」

ツリー・ビューについて

ツリー・ビューの「ページ定義」には、各ページ・コンポーネントがツリーのノードとして表示されます。

図pg_def_tree.gifの説明

各ツリーでは、イベント順序、またはアプリケーション・ビルダーでページをレンダリングまたは処理するときのコンポーネントの処理方法に基づいてコンポーネントがグループ化されています。

カーソルをコンポーネントに合わせると、ツールチップが表示されます。ツールチップでは、コンポーネントについての基本情報(アイテム・タイプ、条件、認可など)が表示されます。

図pg_def_tree_tip.gifの説明

コンテキスト・メニューへのアクセス

コンポーネントを編集または追加するには、右クリックしてコンテキスト・メニューを表示します。コンテキスト・メニューはコンポーネントのタイプに応じて異なります。次の例では、「編集」、「すべて開く」および「すべて閉じる」が含まれています。ただし、コンポーネントのタイプによっては他のオプション(「コピー」、「すべて編集」および「削除」など)が表示されることもあります。

図pg_def_context_menu.gifの説明

属性ページへのアクセス

ノードは、次のようにして編集できます。

- ノードを右クリックして、「すべて編集」または「編集」を選択します。

- ノードをダブルクリックします。

- ノードを選択して、[ENTER]を押します。

新規コンポーネントの作成

コントロールまたはコンポーネントは、右クリックして「作成」を選択して作成できます。

図pg_def_tree_create.gifの説明

ウィザードが表示されます。オンラインの指示に従ってください

ページ・コンポーネントの順序変更

ページ・アイテム、リージョン、レポート列、計算、プロセス、検証、ブランチおよび動的アクションの表示を別の表示、処理ポイントまたはリージョンにドラッグ・アンド・ドロップすることで、順序を変更できます。

名前とラベルの切替え

ページを実行するときに表示されるコンポーネントの名前またはラベルのどちらを使用してページのコンポーネントを表示するかを選択できます(たとえば、アイテムの名前はP7_CUST_FIRST_NAMEですが、ラベルはFirst Nameです)。

ビューを変更するには、次のステップを実行します。

1. 「ユーティリティ」ボタンをクリックします。

2. 「切替え」を選択して、次のいずれかを選択します。

- 名前の表示

- ラベルの表示

「ユーティリティ」ボタンの詳細は、「「ページ定義」の共通要素」を参照してください

コンポーネント・ビューでのページの編集

ページは、アプリケーションの基本的な構成要素です。各ページには、ページ番号、名前、および通常はヘッダー、タイトル、フッターなどのテキスト属性が含まれます。ページにコンテンツを追加するには、ページ・コントロール(リージョン、アイテムおよびボタン)を作成します。ページ・テンプレートおよびページ・リージョン・テンプレートは、各ページのルック・アンド・フィールを制御します。

内容は次のとおりです。

- コンポーネント・ビューについて

- ページ・レンダリング・アイコンの使用

- ページ・プロセス・アイコンの使用

- 共有コンポーネント・アイコンの使用

関連項目:
「ツリー・ビューとコンポーネント・ビューの切替え」

コンポーネント・ビューについて

「ページ定義」は、「ページ・レンダリング」、「ページ・プロセス」、および「共有コンポーネント」の3つのセクションで構成されます。これらのセクションはそれぞれ、コントロールのタイプ、コンポーネント、またはアプリケーション・ロジックを識別するヘッダーを持つサブセクションに分けられます。

図pg_def.gifの説明

コンポーネントを編集するには、コンポーネント名をドリルダウンするか、次のセクションで説明されているアイコンをクリックします。

内容は次のとおりです。

- 「すべての編集」アイコンについて

- 「コピー」または「作成」アイコンについて

「すべて編集」アイコンについて

サブセクションのタイトルの右側に表示される「編集」アイコンをクリックすると、そのサブセクション内のコントロール、コンポーネントまたはロジックを編集できます。「すべて編集」アイコンは紙に鉛筆が重なった形をしています。

図pg_def_editall_ico.gifの説明

「すべて編集」アイコンをクリックすると、複数のコントロール、コンポーネントまたはアプリケーション・ロジックを同時に編集または削除したり、最近の変更履歴を表示できます。

たとえば、「リージョン」で「すべての編集」アイコンを選択すると、カレント・ページで現在定義されているすべてのリージョンのサマリー・レポートが表示されます。このサマリー・ビューを使用して、次のことが可能です。

- 使用可能なフィールドおよび選択リストから選択して、一度に複数の属性を編集できます。

- 「編集」アイコンをクリックして、定義ページにリンクできます。

「ページ」ポップアップ・リストから別のページを選択することで、他のページ上の同様のサマリー・ビューにアクセスできます。サマリー・ビューへの編集内容を保存するには、「変更の適用」をクリックします。

「ページ定義」で名前を選択して、特定のコントロールまたはコンポーネントの属性を表示することもできます。たとえば、「ページ定義」にCustomersという名前のリージョンが含まれているとします。リージョン名「Customers」をクリックすると、そのリージョンのリージョン定義ページが表示されます。

「コピー」または「作成」アイコンについて

「コピー」アイコンおよび「作成」アイコンをクリックして、コントロールやコンポーネントをコピーまたは作成できます。「コピー」アイコンは、小さいページが2つ重なった形をしています。「コピー」アイコンをクリックすると、既存のコントロールやコンポーネントのコピーが作成されます。

図pg_def_copy_ico.gifの説明

「作成」アイコンはプラス(+)記号の形をしています。「作成」アイコンをクリックすると、コントロールやコンポーネントが作成されます。

図pg_def_create_ico.gifの説明

関連項目:
「「すべての編集」アイコンについて」

ページ・レンダリング・アイコンの使用

ページ・レンダリングとは、データベースからページを生成するプロセスです。「ページ・レンダリングについて」を参照してください。

コンポーネント・ビューでは、ヘッダーの下にあるアイコンをクリックすると、特定のサブセクションにナビゲートできます。これらのアイコンの1つを選択すると、そのサブセクションが表示され、その他すべてのサブセクションは一時的に非表示になります。表示を元に戻すには、「すべて表示」をクリックします。

図page_rendering.gifの説明

ページ・プロセス・アイコンの使用

ページ・プロセスは、ページを送信するプロセスです。通常、ページは、ユーザーがボタンをクリックすると送信されます。「ページ定義」の「ページ・プロセス」セクションを使用して、計算、検証、プロセス、ブランチなどのアプリケーション・ロジックを指定します。通常、Application Expressエンジンは、「ページ定義」に表示される順序でこのロジックを実行します。

図page_processing.gifの説明

ヘッダーの下にあるアイコンをクリックすると、特定のサブセクションに簡単にナビゲートできます。これらのアイコンの1つを選択すると、そのサブセクションが表示され、その他すべてのサブセクションは一時的に非表示になります。表示を元に戻すには、「すべて表示」をクリックします。

共有コンポーネント・アイコンの使用

「ページ定義」の「共有コンポーネント」セクションには、アプリケーション内のすべてのページに表示または適用可能な共通の要素が含まれます。

図shared_components.gifの説明

ヘッダーの下にあるアイコンをクリックすると、特定のサブセクションに簡単にナビゲートできます。これらのアイコンの1つを選択すると、そのサブセクションが表示され、その他すべてのサブセクションは一時的に非表示になります。表示を元に戻すには、「すべて表示」をクリックします。

関連項目:
「共有コンポーネントでの作業」

ページ・レンダリングについて

ページ・レンダリングとは、データベースからページを生成するプロセスです。「ページ・レンダリング」セクションを使用して、ページ属性、リージョン、ボタン、アイテムおよびページ・プロセスを含むページのレンダリングに影響するコントロールを変更できます。

この後のセクションでは、「ページ・レンダリング」の各サブセクションについて説明します。

内容は次のとおりです。

- ページ

- リージョン

- ボタン

- アイテム

- プロセス

- 動的アクション

ページ

ページ属性は、ページ名、ならびにページ・タイトルや関連するページ・テンプレート、ヘッダー・テキスト、および一部の名前のための選択された認可スキームといった表示属性などのページの詳細な特性を制御します。ページ属性には、「ページ定義」からアクセスします。

関連項目:
「ページ属性の変更」

リージョン

リージョンはページ上の領域で、コンテンツのコンテナとして機能します。各ページには任意の数のリージョンを配置できます。リージョンのコンテンツは、リージョン・ソースによって決まります。たとえば、リージョンのコンテンツは、定義したSQL問合せに基づくレポートにも、静的HTMLにもできます。

特定のリージョン・テンプレートによってリージョンの外観を制御できます。リージョンを使用して、ページ・コントロール(アイテムやボタンなど)をグループ化できます。また、追加のHTMLを生成しない単純なリージョンを作成したり、HTMLの表やイメージ内でコンテンツをフレーム表示する複雑なリージョンを作成できます。

関連項目:

- リージョンの作成および編集の詳細は、「リージョンの理解」を参照してください。

- PL/SQLを使用したWebアプリケーションの開発の詳細は、『Oracle Databaseアドバンスト・アプリケーション開発者ガイド』を参照してください。

- htpパッケージの詳細は、Oracle Database PL/SQLパッケージおよびタイプ・リファレンスを参照してください。

ボタン

アプリケーションの設計時、ボタンを使用して、ユーザーを特定のページやURLにダイレクトしたり、ユーザーによるページの送信を可能にできます。ページを送信すると、Application Expressエンジンが情報を転送または処理します。ボタンは、HTMLボタンとして、イメージとして、あるいはテンプレートを使用して実装できます。ボタンを事前定義されたリージョン・テンプレートの位置に置くことも、フォーム内のアイテム間に置くこともできます。

関連項目:
「ボタンの作成」

アイテム

アイテムは、関連するセッション・ステートを持つ、テキスト・フィールド、選択リスト、チェック・ボックスなどのHTMLフォーム要素です。アイテム属性は、ページ上のアイテムの表示および動作に影響します。たとえば、これらの属性は、ラベルの表示位置、アイテムの大きさおよびアイテムの表示位置(左右、上下)に影響します。

アイテムには、ページ・アイテムとアプリケーション・アイテムという2つのカテゴリが存在します。ページ・レベル・アイテムはページ上に配置され、「表示形式」、「ラベル」、「ラベル・テンプレート」などの関連するユーザー・インタフェースのプロパティを持ちます。アプリケーション・レベル・アイテムはページに関連付けられないため、ユーザー・インタフェースのプロパティを持ちません。アプリケーション・アイテムは、グローバル変数として使用できます。

関連項目:
「ページ・レベル・アイテムの理解」および「アプリケーション・レベル・アイテムの理解」

プロセス

プロセスは、データ操作言語(DML)またはPL/SQLの実行に使用されるロジック・コントロールです。たとえば、プロセスを使用して、ページのレンダリングの際にセッション・ステートを移入したり、(PL/SQLなどを使用して)一部のタイプのロジックを実行したり、レンダリング・エンジンをコールできます。一般に、プロセスはアクションを実行します。プロセスは、ハンドコードしたPL/SQLの場合も、事前定義したプロセスの呼出しの場合もあります。

関連項目:
「ページ・プロセスの理解」および「アプリケーション・プロセスの理解」

動的アクション

動的アクションは、JavaScriptを必要としないで複雑なクライアント側の動作を宣言的に定義する方法を提供します。定義された条件セットに基づいて実行されるアクションを指定できます。また、アクションの影響を受ける要素や、影響を受ける時期と影響も指定できます。

関連項目:
「動的アクションの実装」

ページ・プロセスについて

ページ・プロセスは、ページを送信するプロセスです。通常、ページは、ユーザーがボタンをクリックすると送信されます。「ページ定義」の「ページ・プロセス」セクションを使用して、計算、検証、プロセス、ブランチなどのアプリケーション・ロジックを指定します。通常、ページ定義をツリー・ビューで表示した場合、Application Expressエンジンでは、表示される順序でこのロジックが実行されます。

この後のセクションでは、「ページ・プロセス」の各サブセクションについて説明します。

内容は次のとおりです。

- 計算

- 検証

- プロセス

- ブランチ

計算

計算は、アイテムへのセッション・ステートの割当てに使用するロジックの単位であり、ページの処理時に実行されます。

関連項目:
「ページ計算の理解」

検証

検証は、ユーザーによる入力が有効かどうかを検証するロジック・コントロールの作成を可能にします。たとえば、検証は、ターゲット完了日フィールドに入力された日付が将来の日付かどうかをチェックできます。

関連項目:
「検証の理解」および「「対象ボタン」属性について」

プロセス

プロセスは、データ操作言語(DML)またはPL/SQLの実行に使用されるロジック・コントロールです。プロセスは、ページの送信後に実行されます。

関連項目:
「ページ・プロセスの理解」

ブランチ

ブランチは、ユーザーがアプリケーション内をナビゲートする方法を決定するロジック・コントロールの作成を可能にします。

関連項目:
「ブランチの操作」および「「対象ボタン」属性について」

共有コンポーネントについて

「ページ定義」の「共有コンポーネント」セクションには、アプリケーション内のすべてのページに表示または適用可能な共通の要素が含まれます。共有コンポーネントは、追加された後にのみ「ページ定義」に表示されます。

この後のセクションでは、「ページ定義」の「共有コンポーネント」の下に表示されることがある各サブセクションについて説明します。

関連項目:
「共有コンポーネントでの作業」

内容は次のとおりです。

- タブ

- LOV

- ブレッドクラム

- リスト

- テーマ

- テンプレート

- セキュリティ

- ナビゲーション・バー

関連項目:
「「ページ定義」について」、「「すべての編集」アイコンについて」および「「コピー」または「作成」アイコンについて」

タブ

タブは、アプリケーションのページ間でのナビゲートに有効な方法です。アプリケーション・ビルダーには、標準タブおよび親タブという2つのタイプのタブが含まれています。

タブが1レベルのみのアプリケーションでは、標準タブ・セットを使用します。標準タブ・セットは、特定のページに関連付けられます。標準タブを使用すると、アプリケーション内の他のページにユーザーをリンクできます。親タブ・セットは、標準タブのグループを保持するコンテナとして機能します。親タブを使用すると、ナビゲーションのレベルおよびアプリケーション内でのコンテキスト(位置)を増やすことができます。

関連項目:
「タブの作成」

LOV

値リスト(LOV)は、ラジオ・グループ、チェック・ボックス、ポップアップ・リスト、選択リストなどの、特定のタイプのページ・アイテムを表示するために使用される静的定義または動的定義です。LOVは、静的(事前定義された一連の表示値および戻り値に基づく)または動的(表から値を選択するSQL問合せに基づく)のいずれかです。作成したLOVは、1つ以上のページ・アイテムによって参照できます。

LOVは、LOVウィザードを実行してLOVリポジトリに追加して、アプリケーション・レベルで定義します。

関連項目:
「アプリケーション・レベルでのLOVの作成」

ブレッドクラム

ブレッドクラムは、テンプレートを使用してレンダリングされるリンクの階層的なリストです。たとえば、ブレッドクラムをリンクのリストまたはブレッドクラム・パスとして表示できます。

関連項目:
「ブレッドクラムの作成」

リスト

リストは、テンプレートを使用してレンダリングされるリンクのコレクションです。リストの各エントリに対して、表示テキスト、ターゲットURL、およびリスト・エントリがいつどのように表示されるかを制御するその他の属性を指定します。リストの表示や、すべてのリスト・エントリの外観は、そのリストをテンプレートにリンクすることによって制御します。

関連項目:
「リストの作成」

テーマ

テーマは、アプリケーションのユーザー・インタフェースを定義するテンプレートの名前付きコレクションです。各テーマには、すべてのタイプのアプリケーション・コンポーネントおよびページ・コントロール(個々のページ、リージョン、レポート、リスト、ラベル、メニュー、ボタンおよびLOV)のテンプレートが含まれます。

関連項目:
「テーマの管理」

テンプレート

テンプレートは、アプリケーション内のページのルック・アンド・フィールを制御します。アプリケーションの作成時に、ページ、リージョン、レポート、リスト、ラベル、メニュー、ボタンおよびポップアップLOVのテンプレートを指定します。テンプレートのグループは、テーマという名前付きコレクションで構成されます。

関連項目:
「テンプレートのカスタマイズ」

セキュリティ

アプリケーションに対するセキュリティを提供するには、認可スキームを指定します。認可は、ユーザー権限に基づいてリソースへのアクセスを制御することを示す広義語です。

関連項目:
「認可を介したセキュリティの提供」

ナビゲーション・バー

ナビゲーション・バーを使用すると、アプリケーション内の様々なページにユーザーをリンクできます。通常、ナビゲーション・バーは、ユーザーをヘルプ・テキストにログインおよびログアウトできるようにする場合、またはヘルプ・テキストにリンクできるようにする場合に使用します。ナビゲーション・バーの位置は、関連付けられたページ・テンプレートによって異なります。ナビゲーション・バー・アイコンを使用すると、イメージまたはテキストからのリンクを表示できます。ナビゲーション・バー・アイコンの作成時に、イメージ名、テキスト、表示順序およびリンク先の位置(URLまたはページ)を指定できます。

関連項目:
「ナビゲーション・バー・エントリの作成」

「ページ定義」の共通要素

「ページ定義」は、ページの基本的な構成要素です。「ページ定義」を使用して、ページを定義するコントロールやアプリケーション・ロジックを表示、作成および編集できます。この後のセクションで、「ページ定義」の共通のUI要素を説明します。

内容は次のとおりです。

- 開発者アクション・バーについて

- ページ・メタデータの検索

- ナビゲーション・バーについて

- 「開発者」ツールバーについて

関連項目:
「「ページ定義」へのアクセス」および「コンポーネント・ビューでのページの編集」

開発者アクション・バーについて

開発者アクション・バーは、右上隅の「検索アプリケーション」フィールドの下に表示されます。

図pg_def_icons.gifの説明

開発者アクション・バーには、「ページの実行」、「共有コンポーネント」、「アプリケーション・ユーティリティ」、「開発者のコメント」、「バグ」、「To Do」、「ページがロック解除されました」、「ページがロックされました」、「ページのエクスポート」、「検索」アイコンおよび「ヘルプ」があります。

「ページの実行」アイコン

「ページの実行」アイコンは、小さな薄い灰色の再生ボタンの形をしています。このアイコンをクリックすると、カレント・ページの表示可能なHTMLがレンダリングされます。ページを選択せずにこのアイコンをクリックすると、アプリケーションの最初のページが実行されます。ページを実行すると、Application Expressエンジンにより、データベースに格納されたデータに基づいてページが動的にレンダリングされます。「アプリケーションまたはページの実行」を参照してください。

「共有コンポーネント」アイコン

「共有コンポーネント」アイコンは、小さな機械の歯車のような形をしています。このアイコンをクリックすると、アプリケーション内のすべてのページに表示または適用できる共有コンポーネントおよびユーザー・インタフェース・コントロールのリストが表示できます。「共有コンポーネントでの作業」を参照してください。

アプリケーション・ユーティリティ

「アプリケーション・ユーティリティ」アイコンは、円と4つの小さいボックスのような形をしています。このアイコンをクリックすると、ユーティリティ・ページにリンクします。「アプリケーション・ビルダー・ユーティリティの使用」を参照してください。

「開発者のコメント」、「バグ」または「To Do」アイコン

「開発者のコメント」、「バグ」または「To Do」アイコンは、灰色の吹出しの形をしています。このアイコンをクリックして、アプリケーション、特定のページまたはページ・グループに関する開発者のコメント、バグまたはTo Doを作成します。「開発者コメントの追加」、「バグの管理」および「To Doの追跡」を参照してください。

「ページがロック解除されました」/「ページがロックされました」アイコン

「ページがロック解除されました」および「ページがロックされました」アイコンは、ページが編集可能かどうかを示します。ページのロックが解除されている場合、アイコンは鍵が開いた南京錠として表示されます。ページがロックされている場合、アイコンは鍵が掛かった南京錠として表示されます。ページのロック・ステータスを変更するには、このアイコンをクリックします。詳細は、「ページのロックおよびロック解除」を参照してください。

「ページのエクスポート」アイコン

「ページのエクスポート」アイコンは、下矢印の形をしています。このアイコンをクリックすると、カレント・ページがエクスポートされます。詳細は、「アプリケーション内のページのエクスポート」を参照してください。

「検索」アイコン

「検索」アイコンは懐中電灯の形をしています。このアイコンをクリックすると、カレント・アプリケーション内のアイテム、ページ、問合せ、表、PL/SQL、イメージおよびカスケード・スタイルシート(CSS)またはワークスペースに関連付けられたスキーマを検索できます。「「検索」アイコンの使用」を参照してください。

ヘルプ

このページのオンライン・ヘルプを表示するには、「ヘルプ」リンクをクリックします。「Oracle Application Expressのドキュメントについて」を参照してください。

ページ・メタデータの検索

「検索アプリケーション」フィールドは開発者アクション・バーの上に表示されます。

図pg_def_icons.gifの説明

このフィールドは、アプリケーション内のメタデータを検索する際に使用します。デフォルトでは、このフィールドは大/小文字を区別せず、正規表現構文をサポートします。通常の検索では、P1_NAMEを入力すると、アプリケーション内でP1_NAMEを含むすべての文字列を検索します。

次に示す拡張された正規表現検索では、P1_NAMEまたはP2_NAMEを含むすべての文字列が検出されます。

regexp:(P1_NAME)|(P2_NAME)

「検索アプリケーション」フィールドは、特定のページを迅速に表示するショートカットもサポートします。アプリケーション番号とページ番号を、page、application:pageまたはapplication-pageの形式を使用して入力し、[ENTER]を押します。次に例を示します。

10
570-10
570:10

ナビゲーション・バーについて

ナビゲーション・バーは、ページ上部のブレッドクラム・メニューの下に表示されます。このバーは、アプリケーション内のページ間をナビゲートするために使用します。

図pg_def_nav.gifの説明

「ページ」フィールドを使用してページ間をナビゲートします。「ページ」フィールドにページ番号を入力し、「実行」をクリックします。

「実行」、「ユーティリティ」、「作成」ボタンが右側に表示されます。

「実行」ボタンについて

データベースに格納されているデータに基づいてページを動的にレンダリングするには、「実行」をクリックします。「アプリケーションまたはページの実行」を参照してください。

「ユーティリティ」ボタンについて

図pg_def_util.gifの説明

ヒント:
一部の「ユーティリティ」メニュー・オプションは、ツリー・ビューでのみ表示されます。

「ユーティリティ」ボタンをクリックすると、次のメニューが表示されます。

- チェック: アドバイザにリンクします。このツールはOracle Application Expressアプリケーションの整合性と品質を確認するために使用します。「アプリケーション整合性のチェックのためのアドバイザの実行」を参照してください。

- クリーンアップ: このリンクをクリックして、順序ページ・コンポーネントを変更します。

- ロック: カレント・ページをロックします。「ページのロックおよびロック解除」を参照してください。

- 削除: カレント・ページを削除します。「ページの削除」を参照してください。

- 履歴: カレント・ページへの変更のレポートを表示します。

- エクスポート: エクスポート・ページにリンクします。「アプリケーションのエクスポート」を参照してください。

- キャッシュ: キャッシュ・ページを表示します。「キャッシュされたリージョンの管理」を参照してください。

- 属性ディクショナリ: 属性ディクショナリの管理ページにリンクします。「属性ディクショナリの使用」を参照してください。

- 「クロス・ページ」には次のページへのリンクが含まれています。

- 最近の更新: カレント・アプリケーションの最近更新されたページのレポートを表示します。

- グリッド編集: 複数ページにわたる複数のページ属性をグリッド形式で編集するためのレポートを表示します。

- 複数のページの削除: 「複数のページの削除」を参照してください。

- ページ属性: 属性、コンポーネント、コントロールおよびアプリケーション・ロジックのページ別のレポートを表示します。

- ページ・グループ: 「ページのグループ化」を参照してください。

- ページ・ロック: 「ページのロックおよびロック解除」を参照してください。

- ページ・イベント: 現在定義されているすべてのページ・コントロールおよびプロセスの詳細が、Application Expressエンジンによるページのレンダリング、ロジックの呼出しおよびプロセスの実行の順序で示されます。

- 参照データベース・オブジェクト: カレント・アプリケーションで参照されるデータベース・オブジェクトを識別します。「「データベース・オブジェクトの依存性」レポートの使用」を参照してください。

- 「切替え」(ツリー・ビューのみ):ページを実行するときに表示されるコンポーネントの名前またはラベルのどちらを使用してページのコンポーネントを表示するかを選択できます(たとえば、アイテムの名前はP7_CUST_FIRST_NAMEですが、ラベルはFirst Nameです)。「名前の表示」または「ラベルの表示」を選択します。

- ツリー・ビューの使用:ツリー・ビューの使用についての説明を表示します。「ツリー・ビューとコンポーネント・ビューについて」および「ツリー・ビューでのページの編集」を参照してください。

「作成」ボタンについて

「作成」をクリックすると、新しいページまたはコンポーネントが既存のページに追加されます。使用可能なオプションは次のとおりです。

- 新しいページ: 「データベース・アプリケーションのページの作成について」を参照してください。

- このページ内のリージョン: 「リージョンの理解」を参照してください。

- 共有コンポーネント: 「共有コンポーネントでの作業」を参照してください。

- コピーの新規ページ: 「データベース・アプリケーションのページのコピー」を参照してください。

- バグ: 「バグの管理」を参照してください。

- To Do: 「To Doの追跡」を参照してください。

- コメント: 「開発者のコメントの追加」を参照してください。

「開発者」ツールバーについて

Application Expressエンジンは、データベース表に格納されたデータに基づいて、ページを動的にレンダリングおよび処理します。レンダリングされたアプリケーションを表示するには、「実行」アイコンをクリックして、アプリケーションを実行するかApplication Expressエンジンに送信します。

関連項目:
「アプリケーションまたはページの実行」

開発環境内からデスクトップ・アプリケーションを実行すると、ページの下部に「開発者」ツールバーが表示されます。「開発者」ツールバーを使用すると、カレント・ページの編集、ページ、リージョンまたはページ・コントロールの作成、セッション・ステートの表示、デバッグ・モードの切替えを簡単に行うことができます。「開発者」ツールバーの表示の有無は、定義の編集ページの「ステータス」属性を変更することで制御できます。

図d_toolbar.gifの説明

注意:
「開発者」ツールバーは、ロックされたパッケージ・アプリケーション・ページまたはjQuery Mobileスマートフォン・ページには表示されません。

「開発者」ツールバーは、次のリンクで構成されています。

- ホーム: ワークスペースのホームページにリンクします。「ワークスペースのホームページについて」を参照してください。

- アプリケーション: 「アプリケーション」ホームページにリンクします。「「アプリケーション」ホームページについて」を参照してください。

- ページの編集: 現在実行されているページの「ページ定義」にアクセスします。「「ページ定義」について」を参照してください。

- 作成: ページ、リージョン、ページ・コントロール(アイテム、ボタン、ブランチ、計算、プロセスまたは検証)または共有コントロール(ナビゲーション・バー・アイコン、タブ、LOV、リストまたはブレッドクラム)を作成するためのウィザードにリンクします。「データベース・アプリケーションについて」を参照してください。

- セッション: カレント・ページのセッション・ステート情報にリンクします。詳細は、「セッション・ステートの表示」を参照してください。

- キャッシュ: キャッシュ・ページにリンクします。「キャッシュされたリージョンの管理」を参照してください。

- デバッグの表示: デバッグ・ウィンドウを表示します。「デバッグ・モードへのアクセス」を参照してください。

- デバッグ: ページを「デバッグ」モードと「デバッグなし」モードとの間で切り替えます。「デバッグ・モードへのアクセス」を参照してください。

- 編集リンクの表示: 「編集リンクの表示」と「編集リンクを非表示」とを切り替えます。「編集リンクの表示」をクリックすると、ページ上の編集可能な各オブジェクトの横に小さなオレンジ色のアイコンが表示されます。各アイコンは、オレンジ色で中に三角形があり、その下に2本の罫線があります。リンクをクリックすると、オブジェクト編集用の別のウィンドウが表示されます。

- 「グリッドの表示」には、グリッド・レイアウトの使用時にリージョンとページ・アイテムをページに配置する方法が表示されます。

ページ属性の変更

ページ属性は、ページ名、ならびにページ・タイトルや関連するページ・テンプレート、ヘッダー・テキストおよび選択された認可スキームといった表示属性などのページの詳細な特性を制御します。ページ属性には、「ページ定義」からアクセスします。

内容は次のとおりです。

- ページ属性へのアクセス

- ページ 属性について

ページ属性へのアクセス

ページ属性を編集するには、次のステップを実行します。

1. 「ページ定義」にナビゲートします。「「ページ定義」へのアクセス」を参照してください。

2. 編集ページにアクセスするには、次の操作を実行します。

- ツリー・ビュー: 「ページ・レンダリング」で、ツリーの上部のページ・タイトルをダブルクリックします。

- コンポーネント・ビュー: 「ページ」で、「すべて編集」アイコンをクリックします。

ページ属性ページが表示されます。必須の値には赤いアスタリスク(*)が付いています。

ページ属性について

ページ属性ページは、「名前」、「表示属性」、「JavaScript」、「HTMLヘッダー」、「ヘッダーおよびフッター」、「読取り専用」、「セキュリティ」、「重複送信」、「サーバー・キャッシュ」、「構成」、「エラー処理」、「ヘルプ」および「コメント」の各セクションに分かれています。

図pg_att_nav.gifの説明

これらのセクションにはページをスクロールするか、ページ上部のナビゲーション・ボタンをクリックすることでアクセスできます。ページ上部のボタンを選択すると、選択されたセクションが表示され、その他のセクションはすべて一時的に非表示になります。ページのすべてのセクションを表示するには、「すべて表示」をクリックします。

この後のトピックで、ページ属性ページ固有のセクションについて説明します。

名前

次の属性を使用して、ページ名、英数字の別名(オプション)、関連付けられたページ・グループなど、カレント・ページの一般的な属性を定義します。詳細は、表8-1を参照してください。

表 8-1 ページ属性: 名前

属性

説明

名前

アプリケーション開発者のカレント・ページの名前を指定します。この名前は、ページ番号およびページ・タイトルとともに、多くのページおよびレポートで使用されます。

ページの別名

このページの英数字の別名を入力します。この別名は、カレント・アプリケーション内で一意である必要があります。

たとえば、アプリケーション100のページ1で作業している場合、別名「home」を作成できます。その後、次のf?p構文を使用して他のページからこのページにアクセスできます。

f?p=100:home

グループ

このページと関連付けるページ・グループを指定します。ページ・グループは、機能に影響しませんが、開発者がアプリケーション内のページを管理するのに役立ちます。

グループからページを削除するには、「- グループが割り当てられていない -」を選択し、「変更の適用」をクリックします。

関連項目: 「ページのグループ化」

表示属性

次の属性を使用して、選択されるページ、標準タブ・セット、タイトル、カーソル・フォーカスなど、カレント・ページの一般的な表示属性を定義します。詳細は、表8-2を参照してください。

表 8-2 ページ属性: 表示属性

属性

説明

ページ・テンプレート

このページの外観を制御するページ・テンプレートを選択します。ページ・テンプレートを選択すると、現行のテーマ内に定義されたデフォルト・ページ・テンプレートが上書きされます。

関連項目: 「テーマの編集」

標準タブ・セット

このページに使用する標準タブ・セットを選択します。標準タブ・セットは、特定のページおよびページ番号に関連付けられます。標準タブを使用すると、特定のページにユーザーをリンクできます。

関連項目: 「タブの作成」

タイトル

ブラウザ・ウィンドウのタイトル・バーに表示するタイトルを入力します。Application Expressエンジンは、ページ・テンプレートで使用される#TITLE#置換文字列のかわりに、ここで指定するタイトルを使用します。このタイトルは、HTMLタグ<TITLE></TITLE>の間に挿入されます。

カーソル・フォーカス

カーソル・フォーカスを指定します。使用可能なオプションは次のとおりです。

- 「ページの最初のアイテム」を選択すると、カーソル・フォーカスはページの最初のフィールドに置かれます。

- JavaScriptを含める場合は、「フォーカスなし」を選択します。このオプションを選択すると、生成済JavaScriptとカスタムJavaScript間の競合を回避できます。

メディア・タイプ

インターネット・メディア・タイプを入力します。インターネット・メディア・タイプは、2つの部分で構成される、インターネット上のファイル形式を表す識別子です。メディア・タイプは、少なくともタイプとサブタイプの2つの部分で構成され、オプションで1つ以上のパラメータを指定します。メディア・タイプは、ページ描画の際にHTTPヘッダーのContent-Typeで使用されます。ページ・レベルのメディア・タイプが、アプリケーション・レベルのメディア・タイプを上書きします。この属性のデフォルト値はNULLです。ページ・レベルとアプリケーション・レベルの両方でメディア・タイプの値がNULLの場合、メディア・タイプとしてtext/htmlが使用されます。

JavaScript

次の属性を使用して、JavaScriptをカレント・ページに含めます。詳細は、表8-3を参照してください。

表8-3 JavaScript属性

属性

説明

ファイルURL

このページにロードするコードのJavaScriptのファイルURLを入力します。各URLを新しい行に記述する必要があります。ファイルの縮小バージョンを指定する場合、置換文字列#MIN#を使用して、通常ページ・ビューのファイルURLに.minを含めたり、ページをデバッグ・モードで表示する場合は空の文字列を含めることができます。置換文字列#APP_VERSION#にアクセスして、ファイルURLにアプリケーションのバージョンを含めることもできます。

ここで入力したJavaScriptのファイルURLによって、ページ・テンプレート内の#PAGE_JAVASCRIPT#置換文字列が置き換えられます。

注意: スクリプトの開始タグや閉じタグは含めないでください。URLのみを記述します。

次に例を示します。

- 標準ファイル参照:

/myjs/main.js

- 通常ページ・ビューの縮小ファイルmain.min.jsおよびデバッグ・モードのmain.jsをロードする標準ファイル参照。

/myjs/main#MIN#.js

- Internet Explorerの条件付きファイル

[if IE]/myjs/ie.js

- アプリケーションのアップグレード時(およびバージョンが増分されるとき)にブラウザが常に新しいファイルをロードし、以前キャッシュされたファイルを無視するように、アプリケーション・バージョンを参照するURLで問合せ文字列を使用するファイル参照。

/myjs/main.js?version=#APP_VERSION#

ファンクションおよびグローバル変数の宣言

このページで使用するコードのJavaScriptコード(ファンクション、グローバル変数の宣言など)を入力します。コードを複数のページで使用する場合は、そのコードを外部のJavaScriptファイルに追加して重複を避けることを検討してください。

ここに入力したコードによって、ページ・テンプレート内の#PAGE_JAVASCRIPT#置換文字列が置き換えられます。

注意: スクリプトの開始タグや閉じタグは含めないでください。JavaScriptコードのみ含めます。

ショートカットを参照するには、次の方法を使用します。

"SHORTCUTNAME"

ページ・ロード時に実行

ページがロードされたときに実行されるJavaScriptコードを入力します。このコードはOracle Application Expressによって生成されたJavaScriptコードの後に実行されます。

ここに入力したコードによって、ページ・テンプレート内の#GENERATED_JAVASCRIPT#置換文字列が置き換えられます。

注意: スクリプトの開始タグや閉じタグを追加せず、JavaScriptコードのみ追加してください。

CSS

次の属性を使用して、カスケード・スタイルシート(CSS)をカレント・ページに含めます。詳細は、表8-4を参照してください。

表8-4 CSS属性

属性

説明

ファイルURL

このページにロードするカスケード・スタイルシートのファイルURLを入力します。各URLを新しい行に記述する必要があります。ファイルの縮小バージョンを指定する場合、置換文字列#MIN#を使用して、通常ページ・ビューのファイルURLに.minを含めたり、ページをデバッグ・モードで表示する場合は空の文字列を含めることができます。アプリケーションのバージョンをファイルＵＲＬに含める場合は、置換文字列#APP_VERSION#を使用することもできます。

ここで入力したファイルURLによって、ページ・テンプレート内の#PAGE_CSS#置換文字列が置き換えられます。

注意: リンクの開始タグや閉じタグは含めないでください。ファイルURLのみを含めてください。

次に例を示します。

- 標準ファイル参照:

/myjs/main.js

- 通常ページ・ビューの縮小ファイルmain.min.cssおよびデバッグ・モードのmain.cssをロードする標準ファイル参照:

/mycss/main#MIN#.css

- 条件付きメディア問合せ:

[media="only screen and (max-device-width: 480px)"]/mycss/smartphone.css

- Internet Explorerの条件付きファイル:

[if IE]/myjs/ie.js

- アプリケーション・バージョンを参照するURLで問合せ文字列を使用するファイル参照(アプリケーションがアップグレードされた(バージョンが増分された)ときに、ブラウザが新しいファイルをロードして、以前にキャッシュされたファイルを無視するようなファイル参照):

/mycss/main.css?version=#APP_VERSION#

注意: スクリプトの開始タグや閉じタグを含めないでください。URLのみを記述します。詳細は、アイテムのヘルプを参照してください。

インライン

このページで使用するカスケード・スタイルシートのコードを入力します。コードを複数のページで使用する場合は、重複を避け、ブラウザによる静的ファイルのキャッシュを利用するために、外部ファイルに格納することを検討してください。

ここに入力したコードによって、ページ・テンプレート内の#PAGE_CSS#置換文字列が置き換えられます。

注意: スタイルの開始タグや閉じタグは含めないでください。カスケード・スタイルシートのコードのみを含めてください。

たとえば、CSSクラスdisplay_onlyをboldに設定するには、次のようにします。

.display_only {
font-weight:bold;
}

HTMLヘッダーおよびボディ属性

次の属性を使用して、ページ・ヘッダーとボディ・ヘッダー・テキストを定義します。詳細は、表8-5を参照してください。

表8-5 HTMLヘッダーおよびボディ属性

属性

説明

HTMLヘッダー

ページ・テンプレート・ヘッダー内の#HEAD#置換文字列を置換するテキストを入力します。ここで入力する値は、HTML <HEAD>タグの後に挿入されます。このページ属性の用途は次のとおりです。

- ページ固有のインライン・カスケード・スタイルシート・クラスのコード化

- 特定のページのスタイルシートの追加

- ページ固有のメタ・タグのコード化

ページのHTMLボディ属性

ページ・テンプレートの#ONLOAD#置換文字列を置き換えるテキストを入力します。この機能を使用するには、ページ・テンプレートに#ONLOAD#置換文字列が含まれている必要があります。

ヘッダーおよびフッター

次の属性を使用して、ヘッダーとフッターのテキストを定義します。詳細は、表8-6を参照してください。

表8-6 ヘッダー・テキストおよびフッター・テキスト

属性

説明

ヘッダー・テキスト

ページ・ヘッダーの直後かつボディ・コンテンツの前に配置するテキストまたはHTMLを入力します。

フッター・テキスト

ページ・テンプレート・フッターの前に表示するテキストまたはHTMLを入力します。

読取り専用

「読取り専用条件タイプ」で、このページでページ・アイテムを読取り専用としてレンダリングするために満たす必要のある条件タイプをリストから選択します。条件を選択しない場合、ページ・アイテムが通常どおりにレンダリングされます。読取り専用条件は、「ヘッダーの後」のプロセス・ポイントを持つプロセスを実行した後に評価されます。

ヒント:
この条件の評価方法とは無関係に、一部のページ・アイテム(たとえば、検索フィールド)または特定のリージョンのすべてのページ・アイテムを入力可能なページ・アイテムとして常にレンダリングする場合、これらのリージョン/ページ・アイテムの読取り専用条件を「なし」に設定し、親設定を上書きします。

セキュリティ

次の属性を使用して、カレント・ページの認可スキームおよび認証要件を指定します。詳細は、表8-7を参照してください。

表 8-7 ページ属性: セキュリティ

属性

説明

認可スキーム

ページに適用する認可スキームを選択します。認可スキームはアプリケーション・レベルで定義され、アプリケーション内の多くの要素に適用できます。

認可スキームは、アプリケーション・セッション(セッションの作成時)ごとに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"

重複する送信

「複製ページの送信を許可」リストを使用して、ユーザーがページを1行で繰り返し処理できるかどうかを指定します。重複するページ送信が繰り返し処理されないようにするには、この属性を「いいえ」に設定します。

重複するページ送信の例を次に示します。

- ユーザーが「送信」ボタンを繰り返しクリックした場合

- ブランチ・タイプ「ページにブランチ」を作成して、ユーザーがブラウザの再ロード・ボタンをクリックした場合

「複製ページの送信時は、このURLに移動」で、URLを入力します。「複製ページの送信を許可」を「いいえ」に設定している場合はこのフィールドを使用します。「いいえ」を選択していて同一ページを2回発行すると、Oracle Application Expressはエラー・メッセージとユーザーが指定したURLへのリンクを表示します。

キャッシュ

これらの属性を使用してカレント・ページのキャッシュを有効にします。ページ・キャッシュを有効にすることで、アプリケーションのパフォーマンスが改善され、静的ページの機能が改善されます。詳細は、表8-8を参照してください。

表8-8 キャッシュ属性

属性

説明

キャッシュ・ページ

「はい」または「いいえ」を選択して、ページ・キャッシュを有効にするかどうかを指定してください。ページ・キャッシュは、ページを動的に表示せずにキャッシュから表示するため、パフォーマンスが向上します。

キャッシュ・タイムアウト

キャッシュされたページが有効な時間を指定してください。

ユーザー別のキャッシュ

ページがユーザーによってキャッシュされる必要があるかどうかを指定します。「はい」の場合、ページは各ユーザー用にキャッシュされます。「いいえ」の場合、キャッシュされた同じページがすべてのユーザーに使用されます。

キャッシュ・ページ条件

条件を指定してください。条件がFalseを戻す場合、ページは動的にレンダリングされ、キャッシュされません。条件がTrueを戻す場合、ページはキャッシュから表示されます。

式1

選択した「キャッシュ・ページ条件」に従って条件付きで表示されます。

選択した特定の条件タイプに基づいて、この属性に値を入力してください。

式2

選択した「キャッシュ・ページ条件」に従って条件付きで表示されます。

選択した特定の条件タイプに基づいて、この属性に値を入力してください。

関連項目:
Oracle Application Express管理ガイドの「キャッシュされたリージョンおよびページの管理」、および「リージョン・キャッシュの使用」

構成

このページに対するビルド・オプションを選択します。ビルド・オプションを使用すると、機能を有効または無効にできます。ほとんどのアプリケーション属性は、ビルド・オプション属性を持ちます。特定の構成でページを除外する場合以外は、カレント・ページのビルド・オプションを指定しないでください。

ビルド・オプションは、INCLUDEおよびEXCLUDEという2つの値をとることができます。属性を含めるように指定すると、Application Expressエンジンは、実行時にその属性をアプリケーション定義の一部として認識します。逆に、属性を除外するように指定すると、Application Expressエンジンは、その属性を存在しないものとして処理します。

関連項目:
「ビルド・オプションを使用した構成の制御」

エラー処理

表8-9で説明する属性を使用して、アプリケーションがエラーのログを記録する方法を制御または変更します。

「インライン・エラー通知テキスト」で、ページでエラーが発生した場合に#NOTIFICATION_MESSAGE#テンプレート置換文字列に表示するエラー・テキストを入力します。

表8-9 「ページ属性」の「エラー処理」

属性

説明

インライン・エラー通知テキスト

ページでエラーが発生した場合に#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に関する説明

注意: アプリケーション・レベルで指定するエラー処理ファンクションは、ページ・レベルで指定されるエラー処理により上書きされます。「アプリケーション定義の編集」を参照してください。

関連項目:
「ページ・テンプレート」

ヘルプ

この属性を使用して、カレント・ページのヘルプ・テキストを入力します。ヘルプ・テキストは、ヘルプ・システムを使用して表示されます。このヘルプ・システムは開発する必要があります。

関連項目:
「ヘルプ・ページの作成」および「ショートカットの使用」

コメント

この属性を使用して、カレント・ページに関するコメントを記録します。これらのコメントは、アプリケーションの実行中に表示されません。

ページ計算の理解

ページ計算を使用して、ページが送信または表示されたときに、指定したアイテムに値を割り当てます。アプリケーション・レベルの計算を使用して、アイテムに値を割り当てることもできます。ほとんどのページ・レベルの計算では、ページ・アイテムを移入します。一方、ほとんどのアプリケーション・レベルの計算では、アプリケーション・アイテムを移入します。

内容は次のとおりです。

- ページ計算の作成

- 計算ポイントおよび計算構文の理解

- ページ計算属性の編集

関連項目:
「アプリケーションの計算の理解」および「クロス・ページ・ユーティリティについて」

ページ計算の作成

ページ計算では、ページが表示または送信(レンダリングおよび処理)されたときに、指定したアイテムに値が割り当てられます。ページ計算を作成するには、ページ計算の作成ウィザードを実行します。各計算には、計算の作成対象のアイテムおよび計算タイプを指定します。

ページ計算を作成するには、次のステップを実行します。

1. 該当する「ページ定義」にナビゲートします。「「ページ定義」へのアクセス」を参照してください。

2. 計算の作成ウィザードにアクセスします。

- ツリー・ビュー: 適切なページ・レンダリング・イベント(「ヘッダーの前」や「ヘッダーの後」など)で、「計算」を見つけます。右クリックして「作成」を選択します。

- コンポーネント・ビュー: 「計算」で、「作成」アイコンをクリックします。

3. 「アイテム・タイプ」で、計算を実行する場所を選択して、「次へ」をクリックします。位置オプションは次のとおりです。

- このページのアイテム

- 他のページのアイテム

- アプリケーション・レベル・アイテム

4. 「アイテム」で、アイテムおよび計算ポイントを選択します。

1. 計算するアイテム: 計算によって更新されるアイテムを選択します。

2. 順序: 評価の順序を選択します。

3. 計算ポイント: 計算を実行するポイントを選択します。計算ポイント「新しいインスタンス開始時」では、新しいセッション(またはインスタンス)の生成時に計算が実行されます。

4. 計算タイプ: 作成する計算方法を選択します。

5. 「次へ」をクリックします。

5. 「計算」で、選択した計算タイプに対応する計算を入力し、「次へ」をクリックします。

6. 「条件」で、計算を条件付きにするかどうかを選択できます。計算を条件付きにする場合、「条件タイプ」リストから選択し、式フィールドにテキストを入力します。

7. 「計算の作成」をクリックします。

計算ポイントおよび計算構文の理解

計算のわかりやすい使用例として、電話番号入力用のフォーム・フィールドを含むページがあげられます。この例では、電話番号は1つのデータベース列に格納されますが、データ・エントリ・フォームでは電話番号が市外局番、局番および回線番号の3つの要素に分割されます。この例では、ページ・アイテムはP10_AREA_CODE、P10_PREFIXおよびP10_LINE_NUMBERと呼ばれます。

次に、これらのアイテムに格納された値を1つの文字列に結合します。これは、「送信後」計算を使用して行い、結合した値をP10_PHONE_NUMBERというアイテムに格納します。

P10_AREA_CODE、P10_PREFIXおよびP10_LINE_NUMBERを結合した値を新規アイテムに格納するための計算を作成するには、次のステップを実行します。

1. 該当する「ページ定義」にナビゲートします。「「ページ定義」へのアクセス」を参照してください。

2. P10_PHONE_NUMBERという名前のアイテムを作成して、P10_AREA_CODE、P10_PREFIXおよびP10_LINE_NUMBERを結合した値を格納します。「ページ・アイテムとアプリケーション・アイテムの違い」を参照してください。

3. 計算の作成ウィザードにアクセスします。

- ツリー・ビュー: 該当するイベントで、「計算」を見つけます。右クリックして「作成」を選択します。

- コンポーネント・ビュー: 「計算」で、「作成」アイコンをクリックします。

4. 「アイテムの位置」で、「このページのアイテム」を選択して「次へ」をクリックします。

5. 「計算」で、「P10_PHONE_NUMBER」を選択します。

6. 「順序」で、評価の順序を選択します。

7. 「計算」では、次の計算タイプを作成できます。

1. 静的割当て:

- 「計算タイプ」で「静的割当て」を選択して、「次へ」をクリックします。

- 次の計算を入力します。

(&P10_AREA_CODE.) &P10_PREFIX.-&P10_LINE_NUMBER.

- 「次へ」をクリックします。

2. PL/SQLファンクション本体:

- 「計算タイプ」で「PL/SQLファンクション本体」を選択して、「次へ」をクリックします。

- 次の計算を入力します。

DECLARE
l_return_value  VARCHAR2(300) DEFAULT NULL;
BEGIN
l_return_value :=
'('||:P10_AREA_CODE||')'||:P10_PREFIX||'-'||:P10_LINE_NUMBER;
RETURN l_return_value;
END;

- 「次へ」をクリックします。

3. SQL問合せ(コロン区切りの値を返す):

- 「計算タイプ」で、「SQL問合せ(コロン区切りの値を返す)」を選択して、「次へ」をクリックします。

- 次の計算を入力します。

SELECT '('||:P10_AREA_CODE||')'||:P10_PREFIX||'-'||:P10_LINE_NUMBER FROM DUAL

- 「次へ」をクリックします。

4. PL/SQL式:

- 「計算タイプ」で「PL/SQL式」を選択して、「次へ」をクリックします。

- 次の計算を入力します。

'('||:P10_AREA_CODE||')'||:P10_PREFIX||'-'||:P10_LINE_NUMBER

- 「次へ」をクリックします。

8. 「作成」をクリックします。

ページ計算属性の編集

作成した計算は、ページ計算の編集ページで編集できます。

ページ計算を編集するには、次のステップを実行します。

1. 該当する「ページ定義」にナビゲートします。「「ページ定義」へのアクセス」を参照してください。

2. ページ計算の編集ページにアクセスします。

- ツリー・ビュー: 該当するイベントで、「計算」を見つけます。計算名を右クリックして「編集」を選択します。

- コンポーネント・ビュー: 「計算」で、計算名を選択します。

ページ計算の編集ページが表示されます。

3. 対象となる属性を編集します。

4. 「変更の適用」をクリックします。

計算ポイントおよびソースの編集

計算を実行するタイミングを制御するには、「計算ポイント」属性で順序および計算ポイントを指定します。計算ポイント「新しいインスタンス開始時」では、新しいセッション(またはインスタンス)の生成時に計算が実行されます。

「ソース」で、式または問合せを入力してアイテムの値を計算します。計算が失敗した場合のために、「計算エラー・メッセージ」フィールドにエラー・メッセージを定義できます(オプション)。

条件付き計算の作成

「条件タイプ」リストから条件タイプを選択し、式のフィールドにテキストを入力して、条件付き計算を作成できます。

検証の理解

検証は編集確認です。単一アイテムに固有の検証は、ページ・アイテムの検証です。ページ全体に適用する検証は、ページの検証です。単一列に固有の表形式フォームの検証は、列レベルの検証です。単一列に適用しない表形式フォームの検証は、表形式フォームの行の検証です。

検証を宣言的に定義するには、検証方法を選択します。検証メッセージ・フィールドに、実際の検証の編集確認を入力します。検証が失敗した場合は、後続のページ・プロセスまたは計算が行われないことに注意してください。また、入力した検証は、選択した検証タイプと一貫性がある必要があることも注意してください。

内容は次のとおりです。

- アイテムおよびページ検証の作成

- 検証の実行タイミングの決定

- 検証エラー・メッセージの表示方法の定義

- 検証の条件付き実行

関連項目:
「「対象ボタン」属性について」

アイテムおよびページ検証の作成

検証の作成ウィザードを実行して、検証を作成します。このウィザードは、検証対象に応じてわずかに変化します。検証は、指定のフィールドに固有(単一ページ・アイテムまたは表形式フォーム列の検証)か、フィールドに固有のものではない(ページまたは表形式フォーム行の検証)かのいずれかです。

内容は次のとおりです。

- ページ・アイテムの検証の作成

- ページ全体の検証の作成

- 表形式フォーム列の検証の作成

- 表形式フォーム行の検証の作成

関連項目:
「フォームでのユーザー入力の検証」、「「検証の実行」について」および「アイテム・タイプについて」

ページ・アイテムの検証の作成

ページ・アイテムの検証を作成するには、次のステップを実行します。

注意:
検証に対して入力するテキストは、3,950文字以下にする必要があります。

1. 該当する「ページ定義」にナビゲートします。「「ページ定義」へのアクセス」を参照してください。

2. 検証の作成ウィザードにアクセスします。

- ツリー・ビュー: 「ページ・プロセス」で、「検証中」を右クリックして、「検証の作成」を選択します。

- コンポーネント・ビュー: 「ページ・プロセス」で、「検証」を見つけます。「作成」アイコンをクリックします。

検証の作成ウィザードが表示されます。

3. 「検証レベル」で、「ページ・アイテム」を選択し、「次へ」をクリックします。

4. 「アイテム/列」で、検証するアイテムを選択し、「次へ」をクリックします。

5. 「順序と名前」で、次のステップを実行します。

1. 順序: このアイテムの順序番号を入力します。

2. 「検証名」: この検証の名前を入力します。

3. エラー表示位置: 検証エラー・メッセージの表示位置を選択します。検証エラー・メッセージは、エラー・ページに表示したり、送信済ページにインラインで表示できます。インライン検証は、通知領域(ページ・テンプレートの一部として定義される)に表示したり、フィールド・ラベル内に表示することができます。

4. 「次へ」をクリックします。

6. 「検証タイプ」で、表8-10の説明に従って方法を選択し、「次へ」をクリックします。

表8-10 ページ・アイテムの検証方法

検証方法

説明

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. 「検証」で、次のステップを実行します。

1. エラー・メッセージ: 検証方法に応じて、検証が失敗した場合に表示する検証またはメッセージ・テキストを入力します。
関連付けられたページ・アイテムのプレースホルダとして、#LABEL#を使用できます。

2. 常に実行: ページが送信されるときに検証を実行するかどうかを決定します。この属性は、ページを送信するボタンまたは特定のページについての「検証の実行」属性とともに使用します。オプションは次のとおりです。

- 「はい」: 検証は、ページ上のボタンまたはアイテムの検証設定とは無関係に常に実行されます。定義済条件が依然として適用されることに注意してください。

- 「いいえ」: 検証は、ページを送信するために使用されるボタンまたはアイテムの「検証の実行」属性が「はい」に設定されているときにのみ実行されます。

詳細は、「検証を実行するタイミングの決定」を参照してください。

3. 「次へ」をクリックします。

8. この検証に適用される条件を定義し、「作成」をクリックします。

ページ全体の検証の作成

ページ全体の検証を作成するには、次のステップを実行します。

注意:
検証に対して入力するテキストは、3,950文字以下にする必要があります。

1. 該当する「ページ定義」にナビゲートします。「「ページ定義」へのアクセス」を参照してください。

2. 検証の作成ウィザードにアクセスするには、次のステップを実行します。

- ツリー・ビュー: 「ページ・プロセス」で、「検証中」を右クリックして、「検証の作成」を選択します。

- コンポーネント・ビュー: 「ページ・プロセス」で、「検証」を見つけます。「作成」アイコンをクリックします。

検証の作成ウィザードが表示されます。

3. 「検証レベル」で、「ページ」を選択し、「次へ」をクリックします。

4. 「順序と名前」で、次のステップを実行します。

1. 順序: このアイテムの順序番号を入力します。

2. 「検証名」: この検証の名前を入力します。

3. エラー表示位置: 検証エラー・メッセージの表示位置を選択します。検証エラー・メッセージは、エラー・ページに表示したり、送信済ページにインラインで表示できます。インライン検証は、通知領域(ページ・テンプレートの一部として定義される)に表示したり、フィールド・ラベル内に表示することができます。

4. 「次へ」をクリックします。

5. 「検証タイプ」で、表8-11の説明に従って方法を選択し、「次へ」をクリックします。

表8-11 ページの検証方法

検証方法

説明

SQL

データベース内の値と比較します。検証タイプを選択します。

- EXISTS

- NOT EXISTS

- SQL式

詳細は、このページの下部にある構文の例を参照してください。

PL/SQL

複雑なロジックが必要な場合に便利です。検証タイプを選択します。

- PL/SQL式

- PL/SQLエラー

- ブールを戻すファンクション

- エラー・テキストを戻すファンクション

詳細は、このページの下部にある構文の例を参照してください。

6. 「検証」で、次のステップを実行します。

1. 検証コード: 選択した検証タイプに対応するコードを入力します。

2. エラー・メッセージ: 検証方法に応じて、検証が失敗した場合に表示する検証またはメッセージ・テキストを入力します。
関連付けられたページ・アイテムのプレースホルダとして、#LABEL#を使用できます。

3. 常に実行: ページが送信されるときに検証を実行するかどうかを決定します。この属性は、ページを送信するボタンまたは特定のページについての「検証の実行」属性とともに使用します。オプションは次のとおりです。

- 「はい」: 検証は、ページ上のボタンまたはアイテムの検証設定とは無関係に常に実行されます。定義済条件が依然として適用されることに注意してください。

- 「いいえ」: 検証は、ページを送信するために使用されるボタンまたはアイテムの「検証の実行」属性が「はい」に設定されているときにのみ実行されます。

詳細は、「検証を実行するタイミングの決定」を参照してください。

4. 「次へ」をクリックします。

7. この検証に適用される条件を定義し、「作成」をクリックします。

表形式フォーム列の検証の作成

表形式フォーム列の検証を作成するには、次のステップを実行します。

注意:
検証に対して入力するテキストは、3,950文字以下にする必要があります。

1. 該当する「ページ定義」にナビゲートします。「「ページ定義」へのアクセス」を参照してください。

2. 検証の作成ウィザードにアクセスするには、次のステップを実行します。

- ツリー・ビュー: 「ページ・プロセス」で、「検証中」を右クリックして、「検証の作成」を選択します。

- コンポーネント・ビュー: 「ページ・プロセス」で、「検証」を見つけます。「作成」アイコンをクリックします。

検証の作成ウィザードが表示されます。

3. 「検証レベル」で、次のステップを実行します。

1. 表形式フォーム: この検証に関連付ける表形式フォーム・リージョンを選択します。

2. 検証レベルの指定: 「列」を選択します。

3. 検証する列を選択します。

4. 「アイテム/列」で、次のステップを実行します。

1. 検証する列を選択します。

2. 「次へ」をクリックします。

5. 「順序と名前」で、次のステップを実行します。

1. 順序: このアイテムの順序番号を入力します。

2. 「検証名」: この検証の名前を入力します。

3. エラー表示位置: 検証エラー・メッセージの表示位置を選択します。検証エラー・メッセージは、エラー・ページに表示したり、送信済ページにインラインで表示できます。インライン検証は、通知領域(ページ・テンプレートの一部として定義される)に表示したり、フィールド・ラベル内に表示することができます。

4. 「次へ」をクリックします。

6. 「検証タイプ」で、表8-12の説明に従って方法を選択します。画面の指示に従い、「次へ」をクリックします。

表8-12 表形式フォーム列の検証方法

検証方法

説明

NOT NULL

セッション・ステートのアイテム値がnullかどうかを確認します。

文字列の比較

アイテム値を特定の文字列と比較します。プロンプトが表示されたら、検証タイプを選択します。

正規表現

正規表現は、テキスト・パターンを記述する方法を提供します。「正規表現」検証を使用して、データの検証を実行します。プロンプトが表示されたら、正規表現を入力します。

SQL

データベース内の値と比較します。検証タイプを選択します。

- EXISTS

- NOT EXISTS

- SQL式

詳細は、このページの下部にある構文の例を参照してください。

PL/SQL

複雑なロジックが必要な場合に便利です。検証タイプを選択します。

- PL/SQL式

- PL/SQLエラー

- ブールを戻すファンクション

- エラー・テキストを戻すファンクション

詳細は、このページの下部にある構文の例を参照してください。

7. 「検証」で、次のステップを実行します。

1. エラー・メッセージ: 検証方法に応じて、検証が失敗した場合に表示する検証またはメッセージ・テキストを入力します。
関連付けられた表形式フォーム列の列ヘッダーのプレースホルダとして、#COLUMN_HEADER#を使用できます。

2. 常に実行: ページが送信されるときに検証を実行するかどうかを決定します。この属性は、ページを送信するボタンまたは特定のページについての「検証の実行」属性とともに使用します。オプションは次のとおりです。

- 「はい」: 検証は、ページ上のボタンまたはアイテムの検証設定とは無関係に常に実行されます。定義済条件が依然として適用されることに注意してください。

- 「いいえ」: 検証は、ページを送信するために使用されるボタンまたはアイテムの「検証の実行」属性が「はい」に設定されているときにのみ実行されます。

詳細は、「検証を実行するタイミングの決定」を参照してください。

3. 「次へ」をクリックします。

8. この検証に適用される条件を定義し、「作成」をクリックします。

表形式フォーム行の検証の作成

表形式フォーム行の検証を作成するには、次のステップを実行します。

注意:
検証に対して入力するテキストは、3,950文字以下にする必要があります。

1. 該当する「ページ定義」にナビゲートします。「「ページ定義」へのアクセス」を参照してください。

2. 検証の作成ウィザードにアクセスします。

- ツリー・ビュー: 「ページ・プロセス」で、「検証中」を右クリックして、「検証の作成」を選択します。

- コンポーネント・ビュー: 「ページ・プロセス」で、「検証」を見つけます。「作成」アイコンをクリックします。

検証の作成ウィザードが表示されます。

3. 「検証レベル」で、次のステップを実行します。

1. 表形式フォーム: この検証に関連付ける表形式フォーム・リージョンを選択します。

2. 検証レベルの指定: 「表形式フォームの行」を選択します。

3. 「次へ」をクリックします。

4. 「順序と名前」で、次の内容を指定し、「次へ」をクリックします。

- 順序: このアイテムの順序番号を入力します。

- 「検証名」: この検証の名前を入力します。

- エラー表示位置: 検証エラー・メッセージの表示位置を選択します。検証エラー・メッセージは、エラー・ページに表示したり、送信済ページにインラインで表示できます。インライン検証は、通知領域(ページ・テンプレートの一部として定義される)に表示したり、フィールド・ラベル内に表示することができます。

5. 「検証タイプ」で、表8-13の説明に従って方法を選択します。

表8-13 表形式フォーム行の検証方法

検証方法

説明

SQL

データベース内の値と比較します。検証タイプを選択します。

- EXISTS

- NOT EXISTS

- SQL式

詳細は、このページの下部にある構文の例を参照してください。

PL/SQL

複雑なロジックが必要な場合に便利です。検証タイプを選択します。

- PL/SQL式

- PL/SQLエラー

- ブールを戻すファンクション

- エラー・テキストを戻すファンクション

詳細は、このページの下部にある構文の例を参照してください。

6. 「検証」で、次のステップを実行します。

1. 検証コード: 選択した検証タイプに対応するコードを入力します。

2. エラー・メッセージ: 検証方法に応じて、検証が失敗した場合に表示する検証またはメッセージ・テキストを入力します。
関連付けられた表形式フォーム列の列ヘッダーのプレースホルダとして、#COLUMN_HEADER#を使用できます。

3. 常に実行: ページが送信されるときに検証を実行するかどうかを決定します。この属性は、ページを送信するボタンまたは特定のページについての「検証の実行」属性とともに使用します。オプションは次のとおりです。

- 「はい」: 検証は、ページ上のボタンまたはアイテムの検証設定とは無関係に常に実行されます。定義済条件が依然として適用されることに注意してください。

- 「いいえ」: 検証は、ページを送信するために使用されるボタンまたはアイテムの「検証の実行」属性が「はい」に設定されているときにのみ実行されます。

詳細は、「検証を実行するタイミングの決定」を参照してください。

4. 「次へ」をクリックします。

7. この検証に適用される条件を定義し、「作成」をクリックします。

検証の実行タイミングの決定

検証を作成するときに、「常に実行」属性で、ページが送信されるときに検証が実行されるかどうかが決定されます。この属性は、ページを送信するボタンまたは特定のページについての「検証の実行」属性とともに使用します。この属性には、次の2つのオプションがあります。

- 「はい」: 検証は、ページ上のボタンまたはアイテムの検証設定とは無関係に常に実行されます。
たとえば、現行ユーザーに現行レコードの変更や削除を許可するかどうかを決定するセキュリティ・チェックとしての検証の場合は、「はい」を選択します。これにより、いずれの操作に対しても検証が実行され、権限のないユーザーによる変更を防ぐことができます。

- 「いいえ」: 検証は、ページを送信するために使用されるボタンまたはアイテムの「検証の実行」属性が「はい」に設定されているときにのみ実行されます。
たとえば、ユーザーが単にレコードを削除しようとしているときに、アイテムが数値であることを検証してエラー・メッセージを表示しても役立ちません。この場合は、ユーザーが「作成」または「変更の適用」ボタンをクリックしたときにのみ検証を実行する必要があります。

この動作を実現するには、次のステップを実行します。

- 検証で、「常に実行」に「いいえ」を設定します。

- 「作成」および「変更の適用」ボタンでは、「検証の実行」に「はい」を設定します。

- 「削除」ボタンでは、「検証の実行」に「いいえ」を設定し、不要な検証を回避します。

検証エラー・メッセージの表示方法の定義

検証エラー・メッセージをインライン表示(検証が実行されたページで表示)するか、個別のエラー・ページで表示するかを選択できます。

検証エラー・メッセージの表示方法を定義するには、次のステップを実行します。

1. 該当する「ページ定義」にナビゲートします。「「ページ定義」へのアクセス」を参照してください。

2. 検証の編集ページに移動します。

- ツリー・ビュー: 「ページ・プロセス」で「検証中」を見つけ、「検証」ブランチを展開します。検証名を右クリックして「編集」を選択します。

- コンポーネント・ビュー: 「検証」で、該当する検証を選択します。

3. 「エラー・メッセージ」までスクロールします。

4. 「エラー・メッセージ」に、エラー・メッセージ・テキストを入力します。詳細は、アイテム・ヘルプを参照してください。
検証エラー・メッセージは、エラー・ページに表示したり、既存ページ内にインラインで表示できます。

5. エラー・メッセージの表示から、次のいずれかを選択します。

- 「フィールドおよび通知でインライン表示」: エラーは、フィールド・ラベル内および通知領域(ページ・テンプレートの一部として定義される)にインラインで表示されます。

- 「フィールドでインライン表示」: エラーはフィールド・ラベル内にインラインで表示されます

- 「通知でインライン表示」: エラーは、通知領域(ページ・テンプレートの一部として定義される)にインラインで表示されます。

- 「エラー・ページ」: エラーは、個別のエラー・ページに表示されます。すべての処理(検証を含む)を停止するハード・エラーを作成する場合は、エラー・ページにエラーを表示する必要があります。

「フィールドでインライン表示」または「フィールドおよび通知でインライン表示」を選択した場合は、アイテムをエラー・メッセージに関連付ける必要があります。「関連付けられたアイテム」リストから、アイテムを選択します。

ヒント:
「フィールドでインライン表示」または「フィールドおよび通知でインライン表示」を選択した場合、検証エラー・メッセージが表示されてページが再レンダリングされる間、Application Expressエンジンでは計算またはプロセスが実行されないことに注意してください。

6. 「変更の適用」をクリックします。

関連項目:
「ページ・テンプレート」

「エラーに移動」リンクについて

関連付けるアイテムを定義すると、Oracle Application Expressによって、対応するエラー・メッセージの隣の通知表示位置に「エラーに移動」リンクがレンダリングされます。クリックすると、ユーザーのフォーカスが関連付けられたアイテムに移動します。

「エラーに移動」テキストを変更して、デフォルトのテキストを変更したり、Oracle Application Expressによってデフォルトでは翻訳されない言語に翻訳することができます。いずれの場合でも、必要なテキストと言語とともに、APEX.GO_TO_ERRORという名前のテキスト・メッセージを定義してください。さらに、APEX.GO_TO_ERRORテキスト・メッセージのテキストを単なるシングル・スペースに設定して、この機能を無効化し、「エラーに移動」リンクを削除できます。詳細は、「Oracle Application Expressにより内部使用されるメッセージの翻訳」を参照してください。

検証の条件付き実行

「条件」で、検証を実行するタイミングおよび検証を実行するかどうかを制御できます。

既存の検証に対して条件を作成するには、次のステップを実行します。

1. 該当する「ページ定義」にナビゲートします。「「ページ定義」へのアクセス」を参照してください。

2. 検証の編集ページに移動します。

- ツリー・ビュー: 「ページ・プロセス」で「検証中」を見つけ、「検証」ブランチを展開します。検証名を右クリックして「編集」を選択します。

- コンポーネント・ビュー: 「検証」で、該当する検証を選択します。

3. 「条件」までスクロールします。

4. 「条件」で、次の項目を指定します。

1. 対象ボタン: ページ・ボタンを選択します。選択したボタンをユーザーがクリックすると、検証が実行されます(定義された他の条件によって異なります)。この検証は、指定されたボタンをクリックする以外の方法でページが送信された場合に実行されます。
ボタンがクリックされない場合、検証を実行する前に他の条件が評価されます。

2. 実行スコープ: 表形式フォームにのみ適用されます。次のようにして、実行スコープを指定します。

- 作成済および変更済の列: 表形式フォームで作成および変更した行でのみ検証を実行します。

- すべての送信済の列: 送信したすべての行で検証を実行します。

3. 条件タイプ: 条件タイプを選択します。

- 式属性: 選択した条件タイプに応じて、式属性に値を入力します。

- 実行条件: 表形式フォームにのみ適用されます。次のいずれかを選択します。
各行: 条件で表形式フォームの列を参照する場合は、このオプションを選択します。このオプションにより、表形式フォームの各行で条件が評価されます。

1回: 表形式フォームに固有の値を参照しない場合は、このオプションを選択します。

指定した条件に一致した場合、検証がレンダリングまたは処理されます。

5. 「変更の適用」をクリックします。

ページ・プロセスの理解

1つのページ・プロセスは、ページのレンダリング中または送信中の指定されたポイントで1つのアクションを実行します。たとえば、ページ・プロセスを作成して、ロジックを実行したり、Application Expressエンジンをコールできます。ページ・プロセスは、ページのロードや送信など、特定のイベントが発生したときに実行するロジックの単位です。

ファンクションの観点からみると、ページ・レベルのプロセスとアプリケーション・レベルのプロセスに違いはありません。これらの2つのプロセス・タイプの違いは、プロセスが定義された場所(ページ・レベルかアプリケーション・レベルか)です。

内容は次のとおりです。

- 「ページ・プロセスの作成について」

- ページ・プロセス属性の編集

- ページ・プロセスを実行するタイミングの制御

- ページ・プロセスの成功メッセージとエラー・メッセージの作成

- ページ・プロセスを条件付きにする

関連項目:
「アプリケーション・プロセスの理解」および「クロス・ページ・ユーティリティについて」

ページ・プロセスの作成について

プロセスを作成するには、プロセスの作成ウィザードを実行します。ウィザードの実行中にプロセス名を定義し、順序、およびプロセスが実行されるポイントを指定し、プロセス・カテゴリを選択します。ページ・プロセスの編集ページで、これらのほぼすべての属性を変更できます。

内容は次のとおりです。

- ページ・プロセスの作成

- 表形式フォームのページ・プロセスの作成

ページ・プロセスの作成

ページ・プロセスを作成するには、次のステップを実行します。

1. 該当する「ページ定義」にナビゲートします。「「ページ定義」へのアクセス」を参照してください。

2. ページ・プロセスの作成ウィザードにアクセスします。

- ツリー・ビュー: 適切なページ・レンダリング・イベント(「ヘッダーの前」や「ヘッダーの後」など)で、「プロセス」を見つけます。右クリックして「作成」を選択します。

- コンポーネント・ビュー: 「プロセス」で、「作成」アイコンをクリックします。

3. 表8-14の説明に従って、「プロセス・タイプ」で、作成するプロセスのカテゴリを選択します。

表8-14 ページ・プロセスのカテゴリ

プロセス・カテゴリ

説明

PL/SQL

指定したPL/SQLを実行します。このプロセス・タイプを使用して、プロセスに直接入力したPL/SQLブロックを実行したり、既存のAPIをコールします。

ページ区切りのリセット

「レポート」リージョンで、ページ区切りを最初の結果セットへリセットします。Application Expressエンジンは、指定された結果セット内のユーザーの位置を追跡します。このプロセス・カテゴリは、ユーザーを最初の結果セットに戻します。つまり、レポート・リージョンに関連付けられたカウンタをリセットして、次回結果セットが表示されるときに、結果セットの最初の部分を戻します。

プラグイン

開発者はプラグインを使用して、Application Expressで使用可能な組込みタイプを宣言的に拡張できます。このオプションは、プラグイン・タイプのプロセスがこのアプリケーション内に存在する場合にのみ使用可能です。

関連項目: 「プラグインの実装」

セッション・ステート

既存のセッション・ステート・アイテムの値をNULLに設定します。このプロセス・タイプを選択すると、既存のユーザー設定、アプリケーション、セッションまたはアイテムのキャッシュがクリアされます。

関連項目:「セッション・ステート値の管理」および Oracle Application Express管理ガイドの「ユーザー・プリファレンスの管理」

データ操作

ウィザードでは、データ操作言語(DML)のアクションをサポートするために、「データ操作」プロセス・タイプが頻繁に使用されます。Application Builderでは、次のような宣言によるデータ操作プロセスをサポートしています。

- 自動的なデータ操作言語(DML)プロセスを作成するには、「行の自動フェッチ」および「行の自動処理(DML)」を選択します。

- 「複数行の更新」および「複数行の削除」は、表形式フォームとともに使用します。

- 「表形式フォームに行の追加」は、表形式フォームとともに使用します。

Webサービス

Webサービスをページ上のプロセスとして実装します。このプロセスを実行すると、リクエストがサービス・プロバイダに送信されます。

関連項目: 「プロセスとしてのWebサービスの起動」

フォーム・ページ区切り

マスター・ディテール・フォームに関連付けられたディテール・レコードのページ区切りを実装します。このプロセスは、マスター・ディテール・フォーム(マスター・ディテール・ウィザードなど)で最も頻繁に使用され、マスター表をチェックして該当するディテール・レコード・セットを判別したり、次のディテール・レコードを判別します。

関連項目: 「マスター・ディテール・フォームの作成」

電子メールの送信

APEX_MAIL.SEND_MAILパッケージのための宣言的なインタフェースを提供します。プロセス・タイプでは添付ファイルをサポートします。

ポップアップ・ウィンドウを閉じる

ポップアップ・ウィンドウ内で実行中のプロセスに適用されます。このプロセス・タイプを実行すると、現在のポップアップ・ウィンドウが閉じます。

オンデマンド・プロセスの実行

特定のページからコールされた場合のみ実行される、アプリケーション・レベルのプロセスを作成します。このプロセス・タイプをページ・レベルで作成すると、既存のアプリケーション・レベルのプロセスへの参照が作成されます。

参照: 「オンデマンド・アプリケーション・プロセスについて」

4. 画面に表示されるステップに従います。

表形式フォームのページ・プロセスの作成

表形式フォームのページ・プロセスを作成するには、次のステップを実行します。

1. 該当する「ページ定義」にナビゲートします。「「ページ定義」へのアクセス」を参照してください。

2. ページ・プロセスの作成ウィザードにアクセスします。

- ツリー・ビュー: 適切なページ・レンダリング・イベント(「ヘッダーの前」や「ヘッダーの後」など)で、「プロセス」を見つけます。右クリックして「作成」を選択します。

- コンポーネント・ビュー: 「プロセス」で、「作成」アイコンをクリックします。

3. 「プロセス・タイプ」で、次の項目を指定します。

- 表形式フォーム: 関連する表形式フォーム・リージョンを選択します。

- 表8-15の説明に従って、作成するプロセスのカテゴリを選択します。

表8-15 表形式フォーム・プロセスのカテゴリ

プロセス・カテゴリ

説明

PL/SQL

指定したPL/SQLを実行します。このプロセス・タイプを使用して、プロセスに直接入力したPL/SQLブロックを実行したり、既存のAPIをコールします。

プラグイン

開発者はプラグインを使用して、Application Expressで使用可能な組込みタイプを宣言的に拡張できます。このオプションは、プラグイン・タイプのプロセスがこのアプリケーション内に存在する場合にのみ使用可能です。

関連項目: 「プラグインの実装」

データ操作

ウィザードでは、データ操作言語(DML)のアクションをサポートするために、「データ操作」プロセス・タイプが頻繁に使用されます。Application Builderでは、次のような宣言によるデータ操作プロセスをサポートしています。

- 自動的なデータ操作言語(DML)プロセスを作成するには、「行の自動フェッチ」および「行の自動処理(DML)」を選択します。

- 「複数行の更新」および「複数行の削除」は、表形式フォームとともに使用します。

- 「表形式フォームに行の追加」は、表形式フォームとともに使用します。

Webサービス

Webサービスをページ上のプロセスとして実装します。このプロセスを実行すると、リクエストがサービス・プロバイダに送信されます。

関連項目: 「プロセスとしてのWebサービスの起動」

電子メールの送信

APEX_MAIL.SEND_MAILパッケージのための宣言的なインタフェースを提供します。プロセス・タイプでは添付ファイルをサポートします。

4. 画面に表示されるステップに従います。

ページ・プロセス属性の編集

プロセスを作成すると、「ページ・プロセスの編集」ページで属性を編集することによって、プロセスを実行するタイミングおよびプロセスの内容を制御できます。

既存のページ・プロセスを編集するには、次のステップを実行します。

1. 該当する「ページ定義」にナビゲートします。「「ページ定義」へのアクセス」を参照してください。

2. ページ・プロセスの編集ページにアクセスします。

- ツリー・ビュー: 適切なページ・レンダリング・イベント(「ヘッダーの前」や「ヘッダーの後」など)で、「プロセス」セクションを見つけます。右クリックして「編集」を選択します。

- コンポーネント・ビュー: 「プロセス」で、プロセス名を選択します。

「ページ・プロセスの編集」ページが表示されます。

3. 対象となる属性を編集します。詳細は、アイテム・ヘルプおよび次に続く各項を参照してください。

4. 「変更の適用」をクリックします。

ページ・プロセスを実行するタイミングの制御

プロセスを実行するタイミングを制御するには、「プロセス・ポイント」で順序番号およびプロセス・ポイントを指定します。「プロセスの実行」でオプションを選択すると、後続のページへのアクセス時におけるプロセスの実行を制限できます。

プロセス・ポイントまたはソースを変更するには、次のステップを実行します。

1. 該当する「ページ定義」にナビゲートします。「「ページ定義」へのアクセス」を参照してください。

2. ページ・プロセスの編集ページにアクセスします。

- ツリー・ビュー: 適切なページ・レンダリング・イベント(「ヘッダーの前」や「ヘッダーの後」など)で、「プロセス」セクションを見つけます。右クリックして「編集」を選択します。

- コンポーネント・ビュー: 「プロセス」で、プロセス名を選択します。

「ページ・プロセスの編集」ページが表示されます。

プロセスを実行するタイミングを制御するには、「プロセス・ポイント」で順序番号およびプロセス・ポイントを指定します。

3. 「プロセス・ポイント」セクションを見つけます。

4. 「順序」で、数値を入力します。これによって評価の順序が決まります。

5. 「プロセス・ポイント」から、プロセスを実行するポイントを選択します。

6. 「プロセスの実行」で次のオプションを選択すると、後続のページへのアクセス時におけるプロセスの実行を制限できます。

- ページへのアクセスごとに1回

- セッションごとまたはリセット時に1回

7. PL/SQLのプロセス・タイプに適切なコードを入力します。
「PL/SQL無名ブロック」プロセスの場合は、「プロセス」で適切なコードを入力します。

「キャッシュのクリア」プロセスの場合は、「ソース」に適切なコードを入力します。

8. オプションでエラー・メッセージを定義します。「ページ・プロセスの成功メッセージとエラー・メッセージの作成」を参照してください。

9. 「変更の適用」をクリックします。

ページ・プロセスの成功メッセージとエラー・メッセージの作成

プロセスの実行時に表示する成功メッセージとエラー・メッセージの両方を定義できます。エラー・メッセージの表示方法は、プロセス・ポイントによって異なります。「送信時 - 計算および検証の前」または「送信時 - 計算および検証の後」プロセス・ポイントを持つプロセスでは、カレント・ページにインラインでエラー・メッセージを表示するか(デフォルト)、別のページに表示するかを指定できます。他のすべてのページ・プロセスでは、エラー・メッセージは別のエラー・ページに表示されます。

ページ・プロセスのエラー・メッセージまたは成功メッセージを作成するには、次のステップを実行します。

1. 該当する「ページ定義」にナビゲートします。「「ページ定義」へのアクセス」を参照してください。

2. ページ・プロセスの編集ページにアクセスします。

- ツリー・ビュー: 適切なページ・レンダリング・イベント(「ヘッダーの前」や「ヘッダーの後」など)で、「プロセス」セクションを見つけます。右クリックして「編集」を選択します。

- コンポーネント・ビュー: 「プロセス」で、プロセス名を選択します。

「ページ・プロセスの編集」ページが表示されます。

3. 「メッセージ」までスクロールします。

4. 「プロセスの成功メッセージ」で、プロセスが正常に実行された場合に表示するメッセージを入力します。

5. 「プロセス・エラー・メッセージ」で、未処理例外が発生した場合に表示されるメッセージを入力します。成功メッセージとエラー・メッセージの両方についてサポートされる置換文字列の詳細は、アイテム・ヘルプを参照してください。

6. 「送信時 - 計算および検証の前」または「送信時 - 計算および検証の後」プロセス・ポイントを持つプロセスでは、エラー・メッセージの表示位置を指定できます。
「エラー・メッセージ表示位置」から、次のいずれかを選択します。

- 通知でインライン表示: エラーは、「通知」領域(ページ・テンプレートの一部として定義される)内の既存ページにインラインで表示されます。これは、新しいプロセスに対するデフォルトの設定です。

- エラー・ページ: エラーは別のエラー・ページに表示されます。
ページに、(SQL文のAPEX_ITEMコールを使用して)手動で作成された表形式フォームが含まれている場合は、「エラー・ページ」を選択してください。そうしない場合、ユーザーが行った変更はページが再レンダリングされるときに破棄されます。エラーが別のエラー・ページに表示される場合、ユーザーはブラウザの「戻る」ボタンを使用して、入力された値を保持できます。

7. 「変更の適用」をクリックします。

関連項目:
「ページ・テンプレート」

ページ・プロセスを条件付きにする

条件付きのページ・プロセスを作成するには、次のステップを実行します。

1. 該当する「ページ定義」にナビゲートします。「「ページ定義」へのアクセス」を参照してください。

2. ページ・プロセスの編集ページにアクセスします。

- ツリー・ビュー: 適切なページ・レンダリング・イベント(「ヘッダーの前」や「ヘッダーの後」など)で、「プロセス」セクションを見つけます。右クリックして「編集」を選択します。

- コンポーネント・ビュー: 「プロセス」で、プロセス名を選択します。

「ページ・プロセスの編集」ページが表示されます。

3. 「条件」までスクロールします。

4. 「条件」で、次の項目を指定します。

1. 対象ボタン: ページ・ボタンを選択します。選択したボタンをユーザーがクリックすると、検証が実行されます(定義された他の条件によって異なります)。この検証は、指定されたボタンをクリックする以外の方法でページが送信された場合に実行されます。
ボタンがクリックされない場合、検証を実行する前に他の条件が評価されます。

2. 実行スコープ: 表形式フォームにのみ適用されます。次のようにして、実行スコープを指定します。

- 作成済および変更済の列: 表形式フォームで作成および変更した行でのみ検証を実行します。

- すべての送信済の列: 送信したすべての行で検証を実行します。

3. 条件タイプ: 条件タイプを選択します。

- 式属性: 選択した条件タイプに応じて、式属性に値を入力します。

- 実行条件: 表形式フォームにのみ適用されます。次のいずれかを選択します。
各行: 条件で表形式フォームの列を参照する場合は、このオプションを選択します。このオプションにより、表形式フォームの各行で条件が評価されます。

1回: 表形式フォームに固有の値を参照しない場合は、このオプションを選択します。

指定した条件に一致した場合、検証がレンダリングまたは処理されます。

5. 「変更の適用」をクリックします。

ブランチの操作

ブランチは、特定のページ、プロシージャまたはURLへ移動する指示です。たとえば、ページ1の送信後、ページ1からページ2にブランチできます。

ブランチを作成するには、「ページ・ブランチの作成」ウィザードを実行して、ブランチ・ポイントおよびブランチ・タイプを指定します。ブランチ・タイプは、作成するブランチのタイプを定義します。ブランチ・タイプの詳細は、オンライン・ヘルプを参照してください。

内容は次のとおりです。

- ブランチ・ポイントおよびブランチ・アクションの定義

- 条件付きブランチ処理

関連項目:
「「対象ボタン」属性について」

ブランチ・ポイントおよびブランチ・アクションの定義

アプリケーションの標準タブをクリックすると、Application Expressエンジンはセッション・ステートを設定し、計算を実行してから、ユーザーをターゲット・ページにリンクします。プロセスまたは明示的に定義されたブランチは実行しません。標準タブをクリックせずにページを送信する場合、Application Expressエンジンはブランチを明示的に定義して、ユーザーを後続のページにリダイレクトします。

ブランチを実行するタイミングを制御するには、「ブランチ・ポイント」リストからブランチ・ポイントを選択します。使用可能なオプションは次のとおりです。

- 送信時: 計算の前: 計算、検証またはプロセスの前にブランチが実行されます。このオプションは、プロセスを起動しないボタン(「取消」ボタンなど)に使用します。

- 送信時: 検証の前: 計算の後、検証またはプロセスの前にブランチが実行されます。検証が失敗すると、ページ・プロセスは停止し、ロールバックが実行され、ページにエラーが表示されます。このデフォルト動作のために、ブランチを作成して検証を提供する必要がありません。ただし、計算の結果に応じてブランチする必要がある場合があります(たとえば、前のブランチ・ポイントに戻る場合)。

- 送信時: プロセスの前: 計算および検証の後、プロセスの前にブランチが実行されます。このオプションを使用すると、検証されたセッション・ステートに基づいて、ページ・プロセスの実行前にブランチされます。

- 送信時: プロセスの後: 計算、検証およびプロセスの後にブランチが実行されます。このオプションを使用すると、計算、検証およびプロセスの実行後にURLまたはページにブランチされます。このオプションを使用する際、任意のブランチ・ポイントに複数のブランチが存在する場合は、ブランチを順序付ける必要があります。

- ロード時: ヘッダーの前: ページのレンダリング前にブランチが実行されます。このオプションを使用すると、カレント・ページではなく別のページが表示されるか、またはユーザーが別のURLまたはプロシージャにリダイレクトされます。

選択したブランチ・タイプによっては、「アクション」属性に次の追加情報を指定できます。

- ブランチ先ページのページ番号

- 最後にブランチ・ターゲット・ページをレンダリングするPL/SQLプロシージャ

- URLアドレス

条件付きブランチ処理

他のコントロールと同様に、ブランチが条件付きで実行されるように設定できます。条件付きブランチを作成するには、「条件タイプ」リストから条件タイプを選択し、その条件タイプを実装するテキストを式のフィールドに入力します。

関連項目:
「ブランチを使用したナビゲーションの制御」

共有コンポーネントでの作業

共有コンポーネントは、アプリケーション内のすべてのページに表示または適用される共通の要素です。共有コンポーネント・ページのツールやウィザードを、アプリケーション・レベルまたは特定のページで使用できます。

内容は次のとおりです。

- 共有コンポーネント・ページへのアクセス

- 共有コンポーネント・ページについて

- 共有コンポーネントのエクスポートについて

共有コンポーネント・ページへのアクセス

「共有コンポーネント」ページにアクセスするには、次のステップを実行します。

1. 「ワークスペース」ホームページにナビゲートします。

2. 「アプリケーション・ビルダー」アイコンをクリックします。

3. アプリケーションを選択します。

4. 「アプリケーション」ホームページで、「共有コンポーネント」をクリックします。
「共有コンポーネント」ページが表示されます。

5. 共有コンポーネントを作成するには、該当するリンクを選択します。

「共有コンポーネント」アイコンの使用

開発者アクション・バーの「共有コンポーネント」アイコンをクリックしても、共有コンポーネント・ページにアクセスできます。「共有コンポーネント」アイコンは、小さい機械の歯車のような形をしており、アプリケーション・ビルダーのほとんどのページの「検索アプリケーション」フィールドの下に表示されます。

図shared_comp_icon.gifの説明

関連項目:
「「開発者」ツールバーについて」

共有コンポーネント・ページについて

次のセクションでは、共有コンポーネント・ページの各リンクについて説明します。

関連項目:
「共有コンポーネント・ページへのアクセス」

ロジック

次の項では、「ロジック」の下にあるリンクについて説明します。

アプリケーション・アイテム

アプリケーション・レベル・アイテムは表示されませんが、アプリケーションのグローバル変数として使用されます。一般に、アプリケーションまたはページの計算を使用して、ページ・レベル・アイテムの値を設定します。詳細は、「アプリケーション・レベル・アイテムの理解」を参照してください。

アプリケーション・プロセス

アプリケーション・プロセスを使用すると、次のようにPL/SQLロジックを実行できます。

- アプリケーションの各ページの特定のポイントで

- プロセスの実行条件で定義されているとおりに

- 新しいセッションの作成時

「オンデマンド」プロセスは、ページ・レベルの「オンデマンド」プロセスからコールされた場合か、ブラウザからAJAXを使用してコールされた場合にのみ実行されます。詳細は、「アプリケーション・プロセスの理解」を参照してください。

アプリケーションの計算

アプリケーション・レベルの計算を使用すると、表示される各ページに対して、または新規アプリケーション・セッションの作成時に、アプリケーション・レベル・アイテムとページ・レベル・アイテムに値を割り当てることができます。また、アプリケーション・レベルの計算を作成し、条件付きで複数のページで実行することもできます。詳細は、「アプリケーションの計算の理解」を参照してください。

Webサービス参照

アプリケーション・ビルダーのWebサービス参照は通常、Simple Object Access Protocol(SOAP)またはRepresentational State Transfer(REST)アーキテクチャに基づいています。Webサービスへの参照を作成してアプリケーションに組み込み、フォームによって送信されたデータを処理したり、フォームまたはレポートに出力をレンダリングできます。詳細は、「Webサービスの実装」を参照してください。

ビルド・オプション

ビルド・オプションを使用すると、アプリケーション内の特定の機能を条件付きで表示または処理できます。ビルド・オプションを使用して、アプリケーションの各デプロイについて、アプリケーションのどの機能をオンにするかを制御できます。詳細は、「ビルド・オプションを使用した構成の制御」を参照してください。

データのロード

データ・ロード表を使用して、データ・ロードのページ作成ウィザードで使用する表を定義します。データ・ロード表は、データをアップロードするデータ・ロード・プロセスで使用するために選択したスキーマに存在する既存の表です。「プラグインページからのプラグインのインポート」を参照してください。

ナビゲーション

次の項では、「ナビゲーション」の下にあるリンクについて説明します。

タブ

タブは、アプリケーションのページ間でのナビゲートに有効な方法です。標準タブまたは親タブという2つのタイプのタブを作成できます。標準タブ・セットは、特定のページおよびページ番号に関連付けられます。親タブ・セットは、標準タブのグループを保持するコンテナとして機能します。「タブの作成」を参照してください。

リスト

リストは、リンクの共有コレクションです。リストの外観は、リスト・テンプレートで制御します。各リスト要素には、表示のタイミングを制御できる表示条件があります。「リストの作成」を参照してください。

ブレッドクラム

ブレッドクラムを使用すると、階層的にナビゲートできます。ブレッドクラムは、テンプレートを使用して表示されるリンクの階層的なリストです。ブレッドクラムは、リンクのリストまたはブレッドクラム・パスとして表示できます。「ブレッドクラムの作成」を参照してください。

ナビゲーション・バー・エントリ

ナビゲーション・バー・エントリは、アプリケーションのページ間を移動する単純なナビゲーション・パスを提供します。ナビゲーション・バーの位置は、関連付けられたページ・テンプレートによって異なります。ナビゲーション・バー・エントリは、イメージまたはテキストからのリンクとして表示できます。ナビゲーション・バー・エントリは、イメージ、説明付きのイメージまたはテキストです。詳細は、「ナビゲーション・バー・エントリの作成」を参照してください。

セキュリティ

次の項では、「セキュリティ」の下にあるリンクについて説明します。

認証スキーム

認証は、ユーザーがアプリケーションにアクセスする前に、そのユーザーのアイデンティティを証明するプロセスです。認証では、ユーザー名とパスワードの入力や、ユーザーのアイデンティティまたは保護キーの使用が必要となる場合があります。「認証によるユーザー・アイデンティティの証明」を参照してください。

認可スキーム

認可は、事前定義されたユーザー権限に基づいて、特定のコントロールやコンポーネントに対するユーザーのアクセスを制限するものです。詳細は、「認可を介したセキュリティの提供」を参照してください。

セッション・ステート保護

セッション・ステート保護は、ハッカーがアプリケーション内のURLを改ざんするのを防ぐための組込み機能です。URL改ざんにより、プログラム・ロジック、セッション・ステートの内容および情報プライバシが悪影響を受ける可能性があります。詳細は、「セッション・ステート保護の理解」を参照してください。

セキュリティ属性

セキュリティ属性の編集ページを使用して、アプリケーション内のすべてのページの一般的なセキュリティ属性を構成します。詳細は、「セキュリティ属性の構成」を参照してください。

ユーザー・インタフェース

次の項では、「ユーザー・インタフェース」の下にあるリンクについて説明します。

ユーザー・インタフェース属性

ユーザー・インタフェース・ページを使用して、アプリケーションのユーザー・インタフェース・オプションを指定します。「アプリケーションのユーザー・インタフェースの管理」を参照してください。

テーマ

テーマは、アプリケーションのユーザー・インタフェースを定義するテンプレートの名前付きコレクションです。「テーマの管理」を参照してください。

テンプレート

テンプレートは、アプリケーション内の特定の構成要素(ページ、リージョン、アイテム、メニューなど)のルック・アンド・フィールを制御します。「テンプレートのカスタマイズ」を参照してください。

LOV

LOVは、ポップアップLOV、選択リスト、チェック・ボックスまたはラジオ・グループを表示するために使用される静的または動的な値のセットです。「アプリケーション・レベルでのLOVの作成」を参照してください。

ショートカット

ショートカットを使用すると、HTMLまたはPL/SQLファンクションを繰り返しコーディングする必要がなくなります。ショートカットを作成して、ボタン、HTMLテキスト、PL/SQLプロシージャ、HTMLなどのページ・コントロールを定義できます。定義したショートカットは、アプリケーション内の様々な位置から参照できるように中央リポジトリに格納されます。「ショートカットの使用」を参照してください。

プラグイン

アプリケーション・ビルダーには、組込みのアイテム・タイプ、リージョン・タイプ、動的アクションおよびプロセスが含まれています。新しい宣言的なタイプをアプリケーションに追加するためにプラグインを使用します。詳細は、「プラグインの実装」を参照してください。

コンポーネント設定

コンポーネント設定を使用して、組込みのOracle Application Expressコンポーネントおよびインストール済プラグインのアプリケーション・レベルの値を設定します。「コンポーネント設定の管理」を参照してください。

ユーザー・インタフェース属性

ユーザー・インタフェース属性を使用して、アプリケーションに関連付けられているユーザー・インタフェース定義を編集します。「アプリケーションのユーザー・インタフェースの管理」を参照してください。

ファイル

次の項では、「ファイル」の下にあるリンクについて説明します。

カスケード・スタイルシート

アプリケーション・ビルダーには、独自のカスケード・スタイルシート(CSS)を参照するテンプレートを保持するテーマが含まれます。「カスケード・スタイルシート」リンクを使用すると、カスケード・スタイルシートをワークスペースにアップロードできます。詳細は、「カスタム・カスケード・スタイルシートの使用」を参照してください。

イメージ

イメージをワークスペースにアップロードするには、「イメージ」リンクを使用します。「イメージの管理」を参照してください。

静的ファイル

静的ファイルをワークスペースにアップロードするには、「静的ファイル」リンクを使用します。詳細は、「静的ファイルの管理」を参照してください。

グローバリゼーション

次の項では、「グローバリゼーション」の下にあるリンクについて説明します。

アプリケーションの翻訳

Oracle Application Expressでは、異なる言語で同時に実行可能なアプリケーションを開発できます。1つのOracle DatabaseおよびOracle Application Expressインスタンスは、複数言語でアプリケーションをサポートできます。アプリケーションの翻訳には複数のステップが必要です。詳細は、「アプリケーションの翻訳およびグローバリゼーション・サポートについて」および「翻訳プロセスの理解」を参照してください。

テキスト・メッセージ

テキスト・メッセージは、ユーザーが作成するPL/SQLコードからコールできる名前付きのテキスト文字列です。このPL/SQLは、ページ・プロセスおよびページ・リージョン、またはパッケージおよびプロシージャで無名ブロックとして使用できます。「メッセージの翻訳」を参照してください。

グローバリゼーション属性

異なる言語で同時に実行可能なアプリケーションを開発できます。このリンクをクリックして、「アプリケーションのプライマリ言語」、「アプリケーション言語の派生元」属性などのグローバリゼーション・オプションを指定します。詳細は、「グローバリゼーション属性の構成」および「アプリケーションの翻訳およびグローバリゼーション・サポートについて」を参照してください。

レポート

次の項では、「レポート」の下にあるリンクについて説明します。

レポート問合せ

「レポート問合せ」リンクを使用すると、カレント・アプリケーション内のストアド・クエリーのレポートを表示できます。「レポート問合せについて」を参照してください。

レポート・レイアウト

レポートまたは共通問合せとともに「レポート・レイアウト」を使用すると、Adobe Portable Document Format(PDF)、Microsoft Word Rich Text Format(RTF)、Microsoft Excel(XLS)形式などの印刷用形式でデータをレンダリングできます。「レポート・レイアウトについて」を参照してください。

アプリケーション・リストについて

次の項では、ページの右側の「アプリケーション」リージョンの下にあるリンクについて説明します。

定義の編集

アプリケーション定義の編集ページにリンクします。このページを使用すると、アプリケーション名、アプリケーションの可用性および静的置換文字列を決定する属性を編集できます。また、ビルド・オプションやアプリケーション・ロゴなどのその他の属性を定義でき、関連付けられているテンプレートやコンポーネントのデフォルト値を表示することもできます。「アプリケーション定義の編集」を参照してください。

コメントの編集

「コメントの編集」を使用すると、現在選択しているアプリケーションに固有のコメントを入力できます。「データベース・アプリケーション・コメントの追加」を参照してください。

「タスク」リストについて

次に、「タスク」リストの下にあるリンクについて説明します。

- 「アプリケーション・コンポーネントのエクスポート」には、コンポーネントのエクスポート・ページへのリンクが表示されます。このページは、バックアップまたは別のインスタンスへのコンポーネントのロードを目的として、エクスポートされるアプリケーションのコンポーネントを識別する際に使用します。詳細は、「アプリケーション・コンポーネントのエクスポート」を参照してください。

- 「サポートするオブジェクトの管理」はサポートするオブジェクト・ページにリンクします。このページは、パッケージ・アプリケーションを作成する際に使用します。「カスタム・パッケージ・アプリケーションの作成方法」を参照してください。

- 「開発者のコメント」は開発者のコメント・ページにリンクします。「開発者コメントの追加」を参照してください。

- 「開発者コメントのカレンダ」は開発者コメントのカレンダ・ページにリンクします。「開発者コメントのカレンダの表示」を参照してください。

共有コンポーネントのエクスポートについて

コンポーネントのエクスポート・ページで、共有コンポーネントおよびページ・コンポーネントをエクスポートできます。また、このウィザードを使用して、編集前にコンポーネントをバックアップしたり、別のOracle Application Expressインスタンスに対するパッチとして機能するエクスポートを作成することもできます。

内容は次のとおりです。

- エクスポート・ページからの共有コンポーネントのエクスポート

- 共有コンポーネント・ページからの共有コンポーネントのエクスポート

Export・ページからの共有コンポーネントのエクスポート

共有コンポーネント・ページから共有コンポーネントをエクスポートするには、次のステップを実行します。

1. エクスポート・ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「アプリケーション」ホームページで、「エクスポート/インポート」をクリックします。

4. エクスポート/インポート・ページで、「エクスポート」をクリックしてから「次へ」をクリックします。

2. 「タスク」リストで、「コンポーネントのエクスポート」をクリックします。
「コンポーネントのエクスポート」ページが表示されます。詳細は、「アプリケーション・コンポーネントのエクスポート」を参照してください。

Shared Components・ページからの共有コンポーネントのエクスポート

共有コンポーネント・ページから共有コンポーネントをエクスポートするには、次のステップを実行します。

1. 「ワークスペース」ホームページにナビゲートします。

2. 「アプリケーション・ビルダー」アイコンをクリックします。

3. アプリケーションを選択します。

4. 「アプリケーション」ホームページで、「共有コンポーネント」をクリックします。
「共有コンポーネント」ページが表示されます。

5. 「タスク」リストで、「アプリケーション・コンポーネントのエクスポート」をクリックします。
「コンポーネントのエクスポート」ページが表示されます。詳細は、「アプリケーション・コンポーネントのエクスポート」を参照してください。

アプリケーション・プロセスの理解

アプリケーション・プロセスとは、アプリケーションの複数ページからのプロセスを使用して、特定のポイントで実行されるように設定されているPL/SQLロジックのブロックです。デフォルトでは、アプリケーション・プロセスはアプリケーション内のすべてのページについて同じポイントで実行されます。ただし、特定のページに対する条件を適用して、プロセスが実行されるタイミングを制御できます。

内容は次のとおりです。

- オンデマンド・アプリケーション・プロセスについて

- アプリケーション・プロセスの例

- アプリケーション・プロセスの作成

- アプリケーション・プロセス属性の編集

- アプリケーション・プロセスのエラー・メッセージの作成

- 「アプリケーション・プロセス履歴」レポートの表示

関連項目:
「ページ・プロセスの理解」

オンデマンド・アプリケーション・プロセスについて

オンデマンド・プロセスは、オンデマンドのプロセス・ポイントを持つ特殊なタイプのアプリケーション・プロセスであり、ページ・レベルのオンデマンド・プロセスからコールされた場合またはブラウザのAJAXコールでコールされた場合に実行されます。オンデマンド・プロセスは、複数のページにわたって様々な実行ポイントから実行するPL/SQLロジックがある場合に有効です。

通常、オンデマンド・プロセスは、アプリケーション・レベルではなく、ページ・レベルで作成する必要があります。アプリケーション・レベルで作成されたオンデマンド・プロセスは、「パブリック・ユーザーは不可」の初期認可スキームで作成されます。これにより、認証されているセッションでユーザーがプロセスを起動できなくなります。

関連項目:
「ページ・プロセスの作成について」

ページ・リクエストからのオンデマンド・プロセスの実行

次の構文を使用すると、ページ・リクエストでオンデマンド・プロセスを実行できます。

f?p=application_id:page_id:session:APPLICATION_PROCESS=process_id

説明:

- application_id は、アプリケーションIDまたは英数字の別名です。

- page_idは、ページ番号または英数字の別名です。

- session は、セッションIDです。

- APPLICATION_PROCESS=process_idは、キーワードAPPLICATION_PROCESS=の後に、「オンデマンド」のプロセス・ポイントを持つアプリケーション・レベル・プロセスのプロセスIDまたは英数字の名前が続いたものです。

この構文を使用すると、Application Expressエンジンでリクエストが認識され、次のルールを使用して処理されます。

- URL内のページ番号は、現在のページ番号または別名にできます。このタイプのリクエストでは特定のページにアクセスすることはないため、ページ番号または別名は構文プレースホルダとしてのみ必要です。

- プロセス認可スキーム、アプリケーションの認可スキームおよびプロセス条件がサポートされます。

- URLでセッション・ステート(アイテムの名前および値)を設定することはできますが、「キャッシュのクリア」オプションは無視されます。

- 認証、認可、またはプロセス条件が失敗してもエラー・メッセージや失敗に対するその他のインジケータは表示されず、多くの場合、空白ページが表示されます。アプリケーション・ビルダーに開発者としてログインしている場合、エラー・メッセージが表示されることに注意してください。

- プロセスを名前で指定すると、指定した(大/小文字が区別される)名前を持つ最初のプロセスが検出されます。

関連項目:
「セッション・ステートのクリア」

アプリケーション・プロセスの例

アプリケーション・プロセスを使用する場合の例として、ショッピング・カート・アプリケーションがあげられます。たとえば、各ページ・ビューでユーザーのショッピング・カートの内容を表示するには、アプリケーションのページ0 (ゼロ)に、アプリケーション・レベル・アイテムTOTAL_CART_ITEMSおよびTOTAL_PURCHASE_PRICEの値を表示するリージョンを作成します。

関連項目:
「コンポーネントをすべてのページに表示するためのグローバル・ページの作成」

各ページでTOTAL_CART_ITEMSおよびTOTAL_PURCHASE_PRICEの値を設定するプロセスを記述するかわりに、「ロード時: ヘッダーの前」というタイプのアプリケーション・プロセスを記述して、これらの値を計算できます。これによって、Application Expressエンジンは、アプリケーションをレンダリングするよう各ページでプロセスを実行します。この結果、各ページでTOTAL_CART_ITEMSおよびTOTAL_PURCHASE_PRICEの最新の値が表示されます。

アプリケーション・プロセスの作成

アプリケーション・プロセスを作成するには、次のステップを実行します。

1. 共有コンポーネント・ページにナビゲートします。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。

2. アプリケーションを選択します。

3. 「アプリケーション」ホームページで、「共有コンポーネント」をクリックします。
「共有コンポーネント」ページが表示されます。

2. 「ロジック」で、「アプリケーション・プロセス」を選択します。
アプリケーション・プロセス・ページが表示されます。

3. 「作成」をクリックします。

4. 「指定」で、次の項目を指定します。

1. 名前: アプリケーション・プロセスの名前を入力します。

2. 順序: このプロセスの順序番号を指定します。この順序番号によって、同じポイントで実行される他のプロセスに対する、プロセスの相対的な評価順序が決まります。

3. ポイント: アプリケーションの各ページの処理において、このプロセスが実行されるポイントを指定します。「オンデマンド」オプションは、ページ・プロセスによりリクエストされた場合にのみ実行されることに注意してください。

4. 「次へ」をクリックします。

5. 「ソース」で、次の項目を指定します。

1. プロセス・テキスト: プロセスのソースとなるテキストを入力します。PL/SQLタイプのプロセッサは、BeginとEnd;で囲まれます。

2. 「エラー・メッセージ」: プロセスでエラーが発生した場合に表示するエラー・メッセージを入力します。「アプリケーション・プロセスのエラー・メッセージの作成」を参照してください。

3. 「次へ」をクリックします。

6. 「条件付け」で、次の項目を指定します。

1. 条件タイプ: このプロセスを実行するために満たされる必要がある条件タイプを選択します。

2. 式1、式2: これらの属性を使用して、プロセスが実行されるかどうかを条件付きで制御します。選択した特定の条件タイプに基づいて、この属性に値を入力します。指定した条件が満たされた場合、プロセスが実行されます。

3. 「プロセスの作成」をクリックします。

アプリケーション・プロセス・ページについて

アプリケーション・プロセスを作成すると、そのアプリケーション・プロセスがアプリケーション・プロセス・ページに表示されます。検索バーがページの上部に表示されます。使用可能なコントロールは次のとおりです。

- 検索列の選択: 虫めがねに似ています。このアイコンをクリックして、検索を絞り込みます。すべての列を検索するには、「すべての列」を選択します。

- テキスト領域: 名前でプロセスを検索するための大/小文字を区別しない検索基準(ワイルドカード文字は暗黙的に定義される)を入力し、「実行」をクリックします。

- 「実行」ボタン: 検索を実行したり、フィルタを適用します。

- アイコンの表示: 各プロセスを大きいアイコンとして表示します。プロセスを編集するには、該当するアイコンをクリックします。

- レポートの表示: 各プロセスをレポート内の1行として表示します。プロセスを編集するには、名前をクリックします。

- 「アクション」メニュー: 「アクション」メニューを使用して、レポート・ビューをカスタマイズします。「「アクション」メニューについて」を参照してください。

アプリケーション・プロセス属性の編集

既存のページ・プロセスを編集するには、次のステップを実行します。

1. 共有コンポーネント・ページにナビゲートします。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。

2. アプリケーションを選択します。

3. 「アプリケーション」ホームページで、「共有コンポーネント」をクリックします。
「共有コンポーネント」ページが表示されます。

2. 「ロジック」で、「アプリケーション・プロセス」を選択します。
アプリケーション・プロセス・ページが表示されます。

3. プロセス名をクリックします。

4. 対象となる属性を編集します。詳細は、アイテムのヘルプを参照してください。

5. 「変更の適用」をクリックします。

アプリケーション・プロセスのエラー・メッセージの作成

プロセスでエラーが発生した場合にユーザーに表示するエラー・メッセージを定義できます。エラー・メッセージの表示方法は、プロセス・ポイントによって異なります。「送信時 - 計算および検証の前」または「送信時 - 計算および検証の後」プロセス・ポイントを持つプロセスでは、カレント・ページにインラインでエラー・メッセージを表示するか(デフォルト)、別のページに表示するかを指定できます。他のすべてのアプリケーション・プロセスでは、エラー・メッセージは別のエラー・ページに表示されます。

アプリケーション・プロセスのエラー・メッセージを作成するには、次のステップを実行します。

1. 共有コンポーネント・ページにナビゲートします。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。

2. アプリケーションを選択します。

3. 「アプリケーション」ホームページで、「共有コンポーネント」をクリックします。
「共有コンポーネント」ページが表示されます。

2. 「ロジック」で、「アプリケーション・プロセス」を選択します。
アプリケーション・プロセス・ページが表示されます。

3. プロセス名をクリックします。

4. 「ソース」までスクロールします。

5. 「プロセス・エラー・メッセージ」で、未処理例外が発生した場合に表示されるメッセージを入力します。成功メッセージとエラー・メッセージの両方の詳細およびサポートされる置換文字列については、アイテムのヘルプを参照してください。

6. 「送信時 - 計算および検証の前」または「送信時 - 計算および検証の後」プロセス・ポイントを持つプロセスでは、エラー・メッセージの表示位置を指定できます。
「エラー・メッセージ表示位置」から、次のいずれかを選択します。

- 通知でインライン表示: エラーは、通知領域(ページ・テンプレートの一部として定義される)内のページにインラインで表示されます。これは、新しいプロセスに対するデフォルトの設定です。

- エラー・ページ: エラーは別のエラー・ページに表示されます。
アプリケーションに、(SQL文のAPEX_ITEMコールを使用して)手動で作成された表形式フォームが含まれている場合は、「エラー・ページ」を選択してください。そうしない場合、ユーザーが行った変更はページが再レンダリングされるときに破棄されます。エラーが別のエラー・ページに表示される場合、ユーザーはブラウザの「戻る」ボタンを使用して、入力された値を保持できます。

7. 「変更の適用」をクリックします。

「アプリケーション・プロセス履歴」レポートの表示

アプリケーション・プロセスを作成した後、「アプリケーション・プロセス履歴」レポートにアクセスできます。このレポートには、最近変更されたアプリケーション・プロセスの履歴が日付ごとに表示されます。

アプリケーション・プロセス・レポートにアクセスするには、次のステップを実行します。

1. 「ワークスペース」ホームページにナビゲートします。

2. 「アプリケーション・ビルダー」をクリックします。

3. アプリケーションを選択します。

4. 「アプリケーション」ホームページで、「共有コンポーネント」をクリックします。

5. 「ロジック」で、「アプリケーション・プロセス」を選択します。

6. ページ上部の 「履歴」 タブを選択します。

7. ページ上部の検索バーを使用してページの概観をカスタマイズできます。使用可能なコントロールは次のとおりです。

- 検索列の選択: 虫めがねに似ています。このアイコンをクリックして、検索を絞り込みます。すべての列を検索するには、「すべての列」を選択します。

- テキスト領域: 名前でプロセスを検索するための大/小文字を区別しない検索基準(ワイルドカード文字は暗黙的に定義される)を入力し、「実行」をクリックします。

- 「実行」ボタン: 検索を実行したり、フィルタを適用します。

- 「アクション」メニュー: 「アクション」メニューを使用して、レポート・ビューをカスタマイズします。「「アクション」メニューについて」を参照してください。

アプリケーションの計算の理解

アプリケーションの計算は、単一のページ・レベル・アイテムまたはアプリケーション・レベル・アイテムの値を設定するロジックの単位であり、アプリケーション内の複数のページにわたって同じポイントで実行されます。ページ・レベルの計算と同様に、アプリケーションの計算も静的値、アイテム値、PL/SQLまたはSQLに基づくことができます。

内容は次のとおりです。

- アプリケーションの計算について

- アプリケーションの計算の作成

- アプリケーション計算履歴レポートへのアクセス

アプリケーションの計算について

アプリケーション・アイテムの一般的な用途は、アプリケーションで最後に参照されたページの値を格納することです。アイテムに値を格納することで、戻るボタンを追加して、計算で求められたページ番号にユーザーをリダイレクトできます。このタイプの計算は、たとえばユーザーがエラー・ページを取り消せるようにする場合に効果的です。

次に、最後にアクセスされたページを格納する計算の例を示します。この例では、計算によって次のことが実行されます。

- LAST_PAGEというアイテムへの最後にアクセスされたアプリケーション・ページの格納

- CURRENT_PAGE_ITEMの値が次に示す計算ボディを含むPL/SQLのファンクション本体のタイプであるかどうかの確認

BEGIN
:LAST_PAGE := nvl(:CURRENT_PAGE,:APP_PAGE_ID);
:CURRENT_PAGE := :APP_PAGE_ID;
RETURN :LAST_PAGE;
END;

新しいインスタンス開始時に実行されるアプリケーションの計算について

通常、アプリケーションの計算は、アプリケーション内の複数のページにわたって同じポイントで実行されます。例外は、「新しいインスタンス開始時」という計算ポイントを持つ計算です。このタイプの計算は、ユーザーが初めてアプリケーションにアクセスしたときにのみ実行されます。このタイプの計算は、ユーザーのセッション内で情報を1回のみ取得する場合(ユーザーの役職を取得する場合など)に便利です。

アプリケーションの計算の作成

アプリケーションの計算を作成するには、次のステップを実行します。

1. 共有コンポーネント・ページにナビゲートします。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。

2. アプリケーションを選択します。

3. 「アプリケーション」ホームページで、「共有コンポーネント」をクリックします。
「共有コンポーネント」ページが表示されます。

2. 「ロジック」で、「アプリケーションの計算」を選択します。

3. 「作成」をクリックします。

4. 「アイテム」で、次の項目を指定します。

1. 順序: このコンポーネントの順序を指定します。これによって評価の順序が決まります。

2. 計算アイテム: この計算によって影響を受けるアイテムを選択します。

5. 「計算ポイント」で、この計算を実行するプロセス・ポイントを選択します。「送信後」を選択すると、ページが表示され送信された後でのみ計算が実行されます。

6. 「計算」で、次の項目を指定します。

1. 計算タイプ: この計算の実行方法を選択します。

2. 計算: 計算タイプに対応する計算ロジックを入力します。

3. 計算エラー・メッセージ: 計算が失敗した場合に表示されるエラー・メッセージを入力します。

7. 「認可スキーム」(オプション)で、認可スキームを選択します。この計算を実行するには、選択した認可スキームがTrueと評価される必要があります。

8. 「条件」(オプション)で、次の項目を指定します。

1. 条件タイプ: この計算を実行するために満たされる必要がある条件タイプを選択します。

2. 式1および式2: これらの属性を使用して、計算が実行されるかどうかを条件付きで制御します。選択した特定の条件タイプに基づいて、この属性に値を入力します。指定した条件が満たされた場合、計算が実行されます。

9. 「ビルド・オプション」(オプション)で、このコンポーネント用のビルド・オプションを選択します。詳細は、「ビルド・オプションを使用した構成の制御」を参照してください。

10. 「計算の作成」をクリックします。

アプリケーションの計算ページについて

アプリケーションの計算を作成すると、そのアプリケーションの計算がアプリケーションの計算ページに表示されます。「ビュー」リストから選択して、ページの表示方法を制御します。使用可能なオプションは次のとおりです。

- アイコン(デフォルト): 各計算を大きいアイコンとして表示します。計算を編集するには、該当するアイコンをクリックします。

- 詳細: 各アプリケーション・プロセスをレポートで1行に表示します。計算プロセスを編集するには、名前をクリックします。

アプリケーション計算履歴レポートへのアクセス

アプリケーションの計算を作成すると、アプリケーション計算履歴レポートを表示できます。

アプリケーション計算履歴レポートにアクセスするには、次のステップを実行します。

1. 「ワークスペース」ホームページにナビゲートします。

2. 「アプリケーション・ビルダー」アイコンをクリックします。

3. アプリケーションを選択します。

4. アプリケーション・ビルダーが表示されたら、「共有コンポーネント」をクリックします。

5. 「ロジック」で、「アプリケーションの計算」を選択します。

6. ページ上部の「履歴」タブを選択します。
このアプリケーション計算履歴レポートには、最近変更されたアプリケーション計算の履歴が日付ごとに表示されます。

7. ページ上部の検索バーを使用してページの概観をカスタマイズできます。使用可能なコントロールは次のとおりです。

- 検索列の選択: 虫めがねに似ています。このアイコンをクリックして、検索を絞り込みます。すべての列を検索するには、「すべての列」を選択します。

- テキスト領域: 大/小文字を区別しない検索基準(ワイルドカード文字は暗黙的に定義される)を入力し、「実行」をクリックします。

- 「実行」ボタン: 検索を実行したり、フィルタを適用します。

- アイコンの表示: 各計算を大きいアイコンとして表示します。計算を編集するには、該当するアイコンをクリックします。

- レポートの表示: 各計算をレポート内の1行として表示します。計算を編集するには、名前をクリックします。

- 「アクション」メニュー: 「アクション」メニューを使用して、レポート・ビューをカスタマイズします。「「アクション」メニューについて」を参照してください。

属性ディクショナリの使用

属性ディクショナリには、フォームとレポートの作成に使用する列についての属性のセットが含まれます。定義は列名によって照合され、シノニムを使用することで特定の定義を複数の列間で共有できます。

属性ディクショナリの管理ページを使用して、現在のページの値を属性ディクショナリ内の値で更新するか、現在のページの値で属性ディクショナリを更新することができます。

属性ディクショナリの管理ページにアクセスするには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。
「アプリケーション・ビルダー」ホームページが表示されます。

2. アプリケーションを選択します。

3. ページを選択します。
「ページ定義」が表示されます。

4. 「ユーティリティ」ボタンをクリックした後、「属性ディクショナリ」をクリックします。
このページは、「ページ・アイテム」と「レポート列」の2つのセクションに分かれています。

ページ・アイテムとレポート列の定義を使用して属性ディクショナリを更新します。属性ディクショナリを使用してページ・アイテムとレポート列を更新することもできます。

非表示オブジェクト(つまり、非表示リージョン内のオブジェクトおよびボタン・アイテム)は更新には使用されないため、候補のアイテムおよびレポート列の数にカウントされません。

5. 現在のページを更新するか、現在の属性ディクショナリを更新するには、適切なページ・リンクを選択します。
属性ディクショナリが表示されます。

少なくとも1つの属性について異なる値を持つアイテムおよびレポート列のみが表示されます。挿入または更新するオブジェクトと、含める属性を選択します。非表示オブジェクト、非表示リージョンおよびボタン・アイテム内のオブジェクトは含まれないため、使用できるアイテムおよびレポート列は合計よりも少ないことがあります。

ヒント:
SQLワークショップの属性ディクショナリに移動するには、「タスク」リストの「属性ディクショナリへのアクセス」をクリックします。詳細は、Oracle Application Express SQLワークショップ・ガイドの「ユーザー・インタフェースのデフォルト値の管理」を参照してください。

9 レポートの作成

Oracle Application Expressでは、レポートとは、SQL問合せの結果の書式を設定したものです。データベース・アプリケーションでのレポートの生成は、組込み問合せを選択して実行するか、またはSQL問合せに基づくレポート・リージョンを定義して行うことができます。

内容は次のとおりです。

- 対話モード・レポートとクラシック・レポートの相違点

- ウィザードを使用したレポートの作成

- 対話モード・レポートのカスタマイズ

- 開発者としての対話モード・レポートの編集

- クラシック・レポートの編集

- レポート・リージョンの出力

関連項目:
「フォームの作成」および「データベース・アプリケーション・コンポーネントおよびコントロールの追加」

対話モード・レポートとクラシック・レポートの違い

データベース・アプリケーションを作成するときに、対話モード・レポートとクラシック・レポートという2つのタイプのレポートを含めることができます。これら2つのレポート・タイプの主な違いは、対話モード・レポートを使用すると、検索、フィルタ処理、ソート、列選択、ハイライトなどのデータ操作を行うことで、データの表示をカスタマイズできることです。

対話モード・レポートについて

次に、対話モード・レポートの例を示します。

rpt_ir.gifの説明

対話モード・レポートを使用して、エンド・ユーザーは高度にカスタマイズされたレポートを作成できます。ユーザーは、特定の列の非表示または公開、フィルタの適用、ハイライト処理、ソート処理などを行ってレポートのレイアウトを変更できます。また、ブレーク、集計、チャート、グループ化を定義し、ユーザー独自の計算を追加することもできます。カスタマイズしたレポートは、プライベートまたはパブリックいずれかのレポートとして保存できます。各対話モード・レポートの各行の最初の列には、検索バー、「アクション」メニュー、「列ヘッダー」メニューおよび「編集」アイコンがあります。これらのコンポーネントの詳細は、「対話モード・レポートのカスタマイズ」を参照してください。

対話モード・レポートを使用すると、次の操作が可能です。

- ページごとに1つの対話モード・レポートを含めることができます

- レポート列を使用して100列を表示できます。追加の列を編集するには、「ツリー」ビューを使用するか、または「レポート列属性」によってページ区切りします。

- 列ヘッダー・フィルタごとに1,000,000行(列属性にカスタムLOVが指定されていない場合)

- 列ヘッダー・フィルタごとに999行を含めることができます(列属性でカスタムLOVが指定されていない場合)

クラシック・レポートについて

一方、クラシック・レポートでは、高度にカスタマイズされたレポートの作成機能をサポートしません。次に、同じデータで構築したクラシック・レポートの例を示します。

rpt_classic.gifの説明

クラシック・レポートでは、一般的なキーワード検索機能、表示する行数を指定する機能および基本的な列のソート機能をサポートしています。

クラシック・レポートを使用すると、レポート列を使用して100列を表示できます。ツリー・ビューを使用するか、「レポート列属性」からページ区切りを行うことによって、追加の列を編集できます。

関連項目:
「クラシック・レポートの編集」

ウィザードを使用したレポートの作成

アプリケーション・ビルダーには、レポートを生成するための多くの組込みウィザードが用意されています。

ウィザードを使用してレポートを作成するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「ページの作成」をクリックして、「次へ」をクリックします。

4. 「レポート」を選択し、「次へ」をクリックします。

5. レポート・タイプを選択し、「次へ」をクリックします。オプションは次のとおりです。

- 対話モード・レポート: 指定するカスタムSQL SELECT文に基づいた対話モード・レポートを作成します。SQL問合せの記述が不明な場合は、「クエリー・ビルダー」ボタンをクリックします。対話モード・レポートは、デスクトップ・ページでのみサポートされており、ページごとに1つの対話モード・レポートのみ定義できます。エンド・ユーザーは、「アクション」メニューのオプションを選択することによって、レポートのレイアウトと表示されるデータをカスタマイズできます。「対話モード・レポートのカスタマイズ」および「開発者としての対話モード・レポートの編集」を参照してください。

- クラシック・レポート: カスタムSQL SELECT文または指定したSQL SELECT文を戻すPL/SQLファンクションに基づいてレポートを作成します。SQL問合せの記述が不明な場合は、「クエリー・ビルダー」ボタンをクリックします。「クラシック・レポートの編集」を参照してください。

- Webサービスの結果のレポート: Webサービスの結果に基づいてレポートを作成します。詳細は、「Webサービスの実装」を参照してください。

- ウィザード・レポート: SQLの知識がなくてもクラシック・レポートを作成できます。適切なスキーマ、表、列および結果セット表示を選択します。

6. 画面に表示されるステップに従います。特定のフィールドの詳細を表示するには、アイテム・ラベルをクリックします。
ヘルプが使用可能な場合、カーソルは矢印と疑問符マークに変わります。「フィールドレベル・ヘルプについて」を参照してください。

対話モード・レポートのカスタマイズ

対話モード・レポートを使用すると、エンド・ユーザーがレポートをカスタマイズできます。ユーザーは、関心のある列の選択、フィルタの適用、ハイライト表示、ソート処理などを行って、レポート・データのレイアウトを変更できます。また、ブレーク、集計、チャート、グループ化を定義し、ユーザー独自の計算を追加することもできます。

ユーザーは、指定の間隔でHTMLバージョンのレポートを電子メールで受け取るように、サブスクリプションを設定することもできます。また、レポートの複数のバリエーションを作成し、パブリックまたはプライベートの参照用に名前付きレポートとして保存できます。

対話モード・レポートは、検索バー、「アクション」メニューおよび「列ヘッダー」メニューの3つの方法でカスタマイズできます。

ヒント:
オプションによって対話モード・レポートに表示される内容を制御する方法の詳細は、「開発者としての対話モード・レポートの編集」を参照してください。

内容は次のとおりです。

- 検索バーの使用

- 「検索列の選択」アイコンの使用

- 「列ヘッダー」メニューの使用

- 「アクション」メニューについて

- 表示する列の選択

- フィルタの追加

- ページごとの行数の指定

- 列のソート順序の選択

- コントロール・ブレークの作成

- ハイライトの追加

- 列の計算

- 列の集計

- 「アクション」メニューからのチャートの作成

- 列のグループ化

- フラッシュバック問合せの実行

- 対話モード・レポートの保存

- レポートのリセット

- レポートのダウンロード

- 電子メールで送信されるレポートのサブスクライブ

検索バーの使用

ir_search_bar.gifの説明

検索バーは各対話モード・レポートの上部に表示され、次の機能が含まれています。

- 「検索列の選択」アイコン: 虫めがねに似ています。このアイコンをクリックして、検索を特定の列に絞り込みます。すべての列を検索するには、「すべての列」を選択します。「「検索列の選択」アイコンの使用」を参照してください。

- テキスト領域: 大/小文字を区別しない検索基準(ワイルド・カード文字は暗黙的に定義される)を入力し、「実行」をクリックします。

- 「実行」ボタン : 検索を実行します。

- レポート: 代替のデフォルトおよび保存済のプライベート・レポート、またはパブリック・レポートが表示されます。「対話モード・レポートの保存」を参照してください。

- ビュー・アイコン: デフォルト・レポートのアイコン・ビュー、レポート・ビューおよび詳細ビューを切り替えます(有効にしている場合)。「チャート」ビューおよび「グループ化」ビューを含めることもできます(定義している場合)。

- 「アクション」メニュー: 「アクション」メニューは対話モード・レポートのカスタマイズに使用します。「「アクション」メニューについて」を参照してください。

関連項目:
「対話モード・レポートの検索バーのカスタマイズ」

「検索列の選択」アイコンの使用

「検索列の選択」アイコンは、検索バーの左側に表示されます。このアイコンをクリックすると、現在のレポートのすべての列のリストが表示されます。

特定の列を検索するには、次のステップを実行します。

1. 「検索列の選択」アイコンをクリックして、列を選択します。
ir_select_col_rpt.gifの説明

2. テキスト領域にキーワードを入力して、「実行」をクリックします。

3. フィルタを無効にするには、「有効/無効」チェック・ボックスを選択します。

4. フィルタを削除するには、「フィルタの削除」アイコンをクリックします。

関連項目:
「表示する列の選択」

「列ヘッダー」メニューの使用

対話モード・レポートの列ヘッダーをクリックすると、「列ヘッダー」メニューが表示されます。各アイコンの上にカーソルを置くと、その機能を説明するツールチップが表示されます。

ir_col_head_menu.gifの説明

「列ヘッダー」メニューには、次のオプションがあります。

- 「昇順ソート」アイコン: レポートの列を昇順でソートします。

- 「降順ソート」アイコン: レポートの列を降順でソートします。

- 「列の非表示」: 列を非表示にします。すべての列を非表示にできるわけではありません。列を非表示にできない場合、「列の非表示」アイコンは表示されません。

- 「コントロール・ブレーク」: 列にブレーク・グループを作成します。これにより、レポートから列がマスター・レコードとして抽出されます。「コントロール・ブレークの作成」を参照してください。

- 「列情報」: 列に関するヘルプ・テキストを表示します(使用可能な場合)。

- テキスト領域: 大/小文字を区別しない検索基準を入力するために使用します。値を入力すると、メニュー下部のLOVが縮小されます。その後、下部から値を選択できます。選択した値は、LOVの「列フィルタ・タイプ」に応じて、equal記号(=)またはcontainsのいずれかを使用してフィルタとして作成されます。

- 一意のLOV: フィルタ基準を満たす一意の値のうち最初の500件が表示されます。列が日付の場合は、かわりに日付範囲のリストが表示されます。

「アクション」メニューについて

「アクション」メニューのオプションを選択することによって、対話モード・レポートをカスタマイズできます。

ヒント:
この項で説明するすべてのオプションを、すべての「アクション」メニューで使用できるわけではありません。開発者は、表示されるオプションをカスタマイズできます。詳細は、「対話モード・レポートの検索バーのカスタマイズ」を参照してください。

「アクション」メニューは、検索バーの「実行」ボタンの右に表示されます。このメニューを使用して、対話モード・レポートをカスタマイズします。

ir_action_menu.gifの説明

「アクション」メニューには、次のオプションがあります。

- 「列の選択」は、表示する列と順序を指定します。「表示する列の選択」を参照してください。

- 「フィルタ」は、問合せでWHERE句を追加または編集することで、レポートの焦点を絞ります。「フィルタの追加」を参照してください。

- 「ページごとの行数」は、現在のレポートに表示する行数を決定します。「ページごとの行数の指定」を参照してください。

- 「書式」には、次のサブメニューがあります。

- ソート: ソートする列を変更し、昇順でソートするか降順でソートするかを決定します。「列のソート順序の選択」を参照してください。

- コントロール・ブレーク: 1つ以上の列にブレーク・グループを作成します。これにより、対話モード・レポートから列が抽出され、マスター・レコードとして表示されます。「コントロール・ブレークの作成」を参照してください。

- ハイライト: フィルタ基準を満たす行をハイライトするフィルタを定義します。「ハイライトの追加」を参照してください。

- 計算: 計算した列をレポートに追加できます。「列の計算」を参照してください。

- 集計: 列に対して算術計算を実行できます。「列の集計」を参照してください。

- チャート: レポート・データをチャートとして表示します。「「アクション」メニューからのチャートの作成」を参照してください。

- グループ化: 結果セットを1つ以上の列でグループ化し、列に対して算術計算を実行できます。「列のグループ化」を参照してください。

- 「フラッシュバック」: データを過去のある時点の状態で表示できます。「フラッシュバック問合せの実行」を参照してください。

- 「レポートの保存」: 対話モード・レポートを保存します。ユーザーは、各自のユーザー資格証明に応じて、様々なタイプのレポートを保存できます。「対話モード・レポートの保存」を参照してください。

- 「リセット」: レポートをデフォルトのレポート設定にリセットします。「レポートのリセット」を参照してください。

- 「ヘルプ」: 対話モード・レポートのカスタマイズ方法の説明を表示します。

- 「ダウンロード」: レポートをダウンロードできます。使用可能なダウンロード形式は、ご使用のインストールとレポート定義によって異なります。「レポートのダウンロード」を参照してください。

- 「サブスクリプション」: 対話モード・レポートを電子メールで受け取ることができます。「電子メールで送信されるレポートのサブスクライブ」を参照してください。

関連項目:
「対話モード・レポートの検索バーのカスタマイズ」

表示する列の選択

レポートをカスタマイズして特定の列を含めるには、「アクション」メニューで「列の選択」を選択します。

「列の選択」オプションを使用するには、次のステップを実行します。

1. 「アクション」メニューをクリックし、「列の選択」を選択します。
「列の選択」リージョンが表示されます。

ir_select_column.gifの説明

2. 移動する列を選択します。中央にある矢印をクリックして、「レポートに表示」ボックスから「表示しない」ボックスに列を移動します。複数の列を同時に選択する場合は、[CTRL]キーを押したままにします。

3. 列の順序を変更するには、右側で一番上、上、下および一番下に対応する矢印をクリックします。

4. 「適用」をクリックします。
変更されたレポートが表示されます。

関連項目:
「レポートのリセット」

フィルタの追加

問合せでWHERE句を追加または変更して、対話モード・レポートにフィルタを作成できます。次の2種類のフィルタを作成できます。

- 列: カスタム列フィルタを作成します。列を選択し、Oracle標準の演算子(=、!=、not in、between)を選択し、比較対象の式を入力します。式では大/小文字が区別されます。ワイルドカードにはパーセント記号(%)を使用します。選択する列は、現在表示されている列である必要はありません。次に例を示します。

STATE_NAME like A%

- 行: カスタム行フィルタを作成します。このフィルタでは、列の別名および任意のOracleファンクションや演算子を使用して、複雑なWHERE句を作成します。次に例を示します。

G = 'VA' or G = 'CT'

ここで、GはCUSTOMER_STATEの別名です。

列フィルタの追加

列フィルタを追加するには、次のステップを実行します。

1. 「アクション」メニューをクリックし、「フィルタ」を選択します。
「フィルタ」リージョンが表示されます。

2. 「フィルタ・タイプ」で「列」を選択します。

3. 「フィルタ」リージョンで、列、演算子および式を指定します。
ir_filter_sel_col.gifの説明

この例では、Discussion Forumプロジェクトを表示するように絞り込んでいます。

4. 「適用」をクリックします。
ir_filter.gifの説明

レポート上部の「レポート設定」領域にフィルタProject = 'Discussion Forum'が追加されていることに注意してください。

5. フィルタを変更するには、次のステップを実行します。

1. フィルタ名(この例では、Project = 'Discussion Forum')をクリックします。

2. 選択内容を編集して、「適用」をクリックします。

6. フィルタを無効にするには、「フィルタの有効化/無効化」チェック・ボックスを選択します。

7. フィルタを削除するには、「フィルタの削除」をクリックします。

行フィルタの追加

行フィルタを追加するには、次のステップを実行します。

1. 「アクション」メニューをクリックし、「フィルタ」を選択します。
「フィルタ」リージョンが表示されます。

2. 「フィルタ・タイプ」で「行」を選択します。

3. 「フィルタ」リージョンで、次の操作を実行します。

1. 名前: 対象のフィルタを説明する名前を入力します。

2. フィルタ式: 式を入力します。リージョンの下部で列、およびファンクションまたは演算子を選択します。

ir_filter_sel_row.gifの説明

4. 「適用」をクリックします。
ir_filter_sel_row_rpt.gifの説明

行フィルタでは、コストが$5000以上のプロジェクトを表示するように絞り込んでいます。

5. フィルタを変更するには、次のステップを実行します。

1. 行フィルタ「Cost over $1000」をクリックします。

2. 選択内容を編集して、「適用」をクリックします。

6. フィルタを無効にするには、「フィルタの有効化/無効化」チェック・ボックスを選択します。

7. フィルタを削除するには、「フィルタの削除」をクリックします。

ページごとの行数の指定

「アクション」メニューで「ページごとの行数」を選択して、ページに表示する行数を指定できます。

表示する行数を指定するには、次のステップを実行します。

1. 「アクション」メニューをクリックし、「ページごとの行数」を選択します。

2. サブメニューから、数値を選択します。
ir_row_per_page.gifの説明

列のソート順序の選択

「書式」サブメニューで「ソート」を選択して、列のソート順序(昇順または降順)を指定できます。また、NULL値の処理方法も指定できます。デフォルト設定を使用すると、NULL値は常に末尾に表示されるか、常に先頭に表示されます。

列ごとにソートするには、次のステップを実行します。

1. 「アクション」メニューをクリックし、「書式」、「ソート」の順に選択します。
「ソート」リージョンが表示されます。

2. 列、ソート方向(「昇順」または「降順」)、および「NULLソート」の動作(「デフォルト」、「NULLを常に最後」または「NULLを常に最初」)を選択します。
ir_sort.gifの説明

3. 「適用」をクリックします。

コントロール・ブレークの作成

「アクション」の「書式」サブメニューで「コントロール・ブレーク」を選択して、1つ以上の列のブレーク・グループを作成できます。ブレーク・グループを作成すると、対話モード・レポートから列を抽出し、それをマスター・レコードとして表示できます。

ブレーク・グループを作成するには、次のステップを実行します。

1. 「アクション」メニューをクリックし、「書式」、「コントロール・ブレーク」の順に選択します。
「コントロール・ブレーク」リージョンが表示されます。

2. 列を選択してから、ステータス(「有効化」または「無効化」)を選択します。
ir_cntrl_brk.gifの説明

3. 「適用」をクリックします。
変更されたレポートが表示されます。

ir_ctrl_break_rpt.gifの説明

レポート上部の「レポート設定」領域に、定義したブレーク・グループProjectが表示されることに注意してください。

4. 「コントロール・ブレーク」フィルタを無効にするには、フィルタの有効化/無効化チェック・ボックスの選択を解除します。フィルタを有効にするには、フィルタの有効化/無効化チェック・ボックスを再度選択します。

5. フィルタを削除するには、ブレークの削除をクリックします。

ハイライトの追加

「アクション」の「書式」サブメニューで「ハイライト」を選択して、レポート内の特定の行をハイライトするように表示をカスタマイズできます。

ハイライトを追加するには、次の手順を実行します。

1. 「アクション」メニューをクリックし、「書式」、「ハイライト」を選択します。
「ハイライト」リージョンが表示されます。

ir_highlight.gifの説明

2. 次の情報を編集します。

1. 名前: 対象のフィルタを説明する名前を入力します。

2. 順序: ハイライトしているルールが評価される順序を示す数値を入力します。

3. 有効: 「はい」を選択します。

4. ハイライト・タイプ: 「セル」または「行」を選択します。

5. バックグラウンド・カラー: ハイライトされる領域のバックグラウンドの新しい色を選択します。

6. テキスト・カラー: ハイライトされる領域のテキストの新しい色を選択します。

7. ハイライト条件: 列、演算子および式を選択します。
ir_highlight2.gifの説明

3. 「適用」をクリックします。
ir_highlight_rpt.gifの説明

レポート上部の「レポート設定」領域に、ハイライトOn-Hold Projectsが表示されることに注意してください。

4. ハイライトを変更するには、ハイライト名をクリックして次の編集を行います。

1. バックグラウンド・カラー: 「イエロー」を選択します。

2. テキスト・カラー: 「グリーン」を選択します。

3. 「適用」をクリックします。

5. ハイライトを無効にするには、「有効/無効」チェック・ボックスを選択します。

6. ハイライトを削除するには、「ハイライトの削除」をクリックします。

列の計算

「アクション」の「書式」サブメニューで「計算」を選択して、列に計算を追加できます。これらの計算は、算術計算(たとえば、NBR_HOURS/24)にすることも、既存の列に適用されているOracle標準のファンクションにすることもできます。

計算を作成するには、次のステップを実行します。

1. 「アクション」メニューをクリックし、「書式」、「計算」の順に選択します。
「計算」リージョンが表示されます。

2. 「計算」リージョンで、次の操作を実行します。

1. 計算: 「新規計算」を選択します。

2. 列ヘッダー: 作成する新しい列の名前を入力します。

3. 書式マスク: 新しい列に適用するOracle書式マスクを選択します(たとえば、$5,234.10)。
次に、計算を作成します。

4. 計算を作成します。

- 列: 列または別名を選択します。

- キーパッド: よく使用するキー用のショートカットを選択します。

- ファンクション: 適切なファンクションを選択します。

次の例では、計算式H - I (Hがコスト、Iが予算金額)を使用して、新しい列で実際のコストと予算金額が比較されます。

ir_compute.gifの説明

3. 「適用」をクリックします。
更新されたレポートが表示されます。

ir_compute_eg.gifの説明

計算の削除

計算を削除するには、次のステップを実行します。

1. 「アクション」メニューをクリックし、「書式」、「計算」の順に選択します。
「計算」リージョンが表示されます。

2. 「計算」から、計算名を選択します。

3. 「削除」をクリックします。

列の集計

「アクション」の「書式」メニューで「集計」を選択して、列に対して集計を定義できます。集計は、各コントロール・ブレークの後に、集計が定義されているレポートの末尾の列内に表示されます。

列を集計するには、次の手順を実行します。

1. 「アクション」メニューをクリックし、「書式」、「集計」の順に選択します。
「集計」リージョンが表示されます。

2. 「集計」リージョンで、次の操作を実行します。

1. 集計: 「新規集計」を選択します。

2. ファンクション: 「合計」、「平均」、「カウント」、「別々にカウント」、「最小」、「最大」または「メジアン」のいずれかを選択します。

3. 列: 列を選択します。
ir_aggreg.gifの説明

この例では、Cost列の合計を作成しています。

3. 「適用」をクリックします。
レポートの下部に、計算が表示されます。

ir_aggreg_rpt.gifの説明

この例の集計は、Cost列の合計金額を示しています。

集計の削除

集計列を削除するには、次のステップを実行します。

1. 「アクション」メニューをクリックし、「書式」、「集計」の順に選択します。
「集計」リージョンが表示されます。

2. 「集計」から、以前に定義した集計を選択します。

3. 「削除」をクリックします。

「アクション」メニューからのチャートの作成

チャートを作成するには、「アクション」の「書式」メニューから「チャート」を選択します。対話モード・レポートごとに1つのチャートを作成できます。定義後は、検索バーのリンクを使用して、チャート・ビューとレポート・ビューを切り替えることができます。

チャートを作成するには、次のステップを実行します。

1. 「アクション」メニューをクリックし、「書式」、「チャート」の順に選択します。
「チャート」リージョンが表示されます。

2. 「チャート」リージョンで、適切なオプションを指定します。
ir_chart.gifの説明

次の属性は棒グラフ用です。

1. チャート・タイプ: 作成するチャートのタイプ(横棒、縦棒、円または折れ線)を選択します。

2. ラベル: ラベルとして使用する列を選択します。

3. ラベルの軸タイトル: 選択された列に関連付けられている軸に表示されるラベルのタイトルを入力します(円グラフには使用できません)。

4. 値: 値として使用する列を選択します。ファンクションがCOUNTである場合は、「値」を選択する必要はありません。

5. 値の軸タイトル: 選択された列に関連付けられている軸に表示される値のタイトルを入力します(円グラフでは使用できません)。

6. ファンクション: (オプション)選択された列で値に対して実行されるファンクションを選択します。

7. ソート: ソート方法を選択します。

3. 「適用」をクリックします。
チャートが表示されます。

ir_chart_rpt.gifの説明

検索バーに2つのアイコン「レポートの表示」および「チャートの表示」が表示されていることに注意してください。

4. これらのアイコンをクリックして、チャート・ビューとレポート・ビューを切り替えます。

チャートの編集

チャートを編集するには、次のステップを実行します。

1. レポートの表示中に、次のステップを実行します。

1. 「アクション」メニューをクリックし、「書式」、「チャート」の順に選択します。
「チャート」リージョンが表示されます。

2. 選択内容を編集して、「適用」をクリックします。

2. チャートの表示中に、次のステップを実行します。

1. 「チャートの編集」をクリックします。

2. 選択内容を編集して、「適用」をクリックします。

チャートの削除

チャートを削除するには、次の手順を実行します。

1. レポートの表示中に、次の手順を実行します。

1. 「アクション」メニューをクリックし、「書式」、「チャート」の順に選択します。
「チャート」リージョンが表示されます。

2. 選択内容を編集して、「適用」をクリックします。

2. チャートの表示中に、次のステップを実行します。

1. 「チャートの編集」をクリックします。

2. 選択内容を編集して、「適用」をクリックします。

列のグループ化

「グループ化」を使用すると、結果セットを1つ以上の列でグループ化し、列に対して算術計算を実行できます。グループ化を定義した後、検索バーのビュー・アイコンを使用して、グループ化ビューとレポート・ビューを切り替えることができます。

内容は次のとおりです。

- グループ化の作成

- グループ化の編集

- グループ化の削除

- グループ化のソート順序の選択

グループ化の作成

グループ化を作成するには、次のステップを実行します。

1. 「アクション」メニューをクリックし、「書式」、「グループ化」の順に選択します。
「グループ化」リージョンが表示されます。

ir_group_by.gifの説明

2. 「GROUP BY列」から、表示する列を3つまで選択します。

3. 計算を含めるには、ファンクション、列、ラベルおよび書式マスクを選択します。
ir_group_by2.gifの説明

4. 「適用」をクリックします。
ir_group_by_rpt.gifの説明

検索バーの下に「グループ化」アイコンが表示されます。結果のレポートには、Project、Task NameおよびBudget列が表示されます。また、新しい列Total Costが右側に表示されます。

グループ化の編集

グループ化を編集するには、次のステップを実行します。

1. 「グループ化の編集」をクリックします。
「グループ化」リージョンが表示されます。

2. 属性を編集します。

3. 「適用」をクリックします。

グループ化の削除

グループ化を削除するには、次のステップを実行します。

1. 「グループ化の編集」をクリックします。
「グループ化」リージョンが表示されます。

2. 「削除」をクリックします。

グループ化のソート順序の選択

グループ化列のヘッダーをクリックするか、「書式」サブメニューで「ソート別のグループ化」を選択して、グループ化列のソート順序(昇順または降順)を指定できます。また、NULL値の処理方法も指定できます。デフォルト設定を使用すると、NULL値は常に末尾に表示されるか、常に先頭に表示されます。

グループ化列をソートするには、次のステップを実行します。

1. 「グループ化」ビューにアクセスします。「グループ化の作成」を参照してください。

2. 「アクション」メニューをクリックし、「書式」、「ソート別のグループ化」の順に選択します。

ヒント:
「ソート別のグループ化」メニューは、「グループ化」ビューを表示している場合にのみ表示されます。

「ソート別のグループ化」リージョンが表示されます。

ir_group_by_sort.gifの説明

3. 列、ソート方向(「昇順」または「降順」)、および「NULLソート」の動作(「デフォルト」、「NULLを常に最後」または「NULLを常に最初」)を選択します。

4. 「適用」をクリックします。

フラッシュバック問合せの実行

「アクション」メニューから「フラッシュバック」を選択すると、フラッシュバック問合せを実行できます。フラッシュバック問合せを使用すると、データを過去のある時点の状態で表示することができます。フラッシュバック可能なデフォルトの時間は3時間(180分)ですが、実際の時間はデータベースによって異なります。

フラッシュバック問合せを実行するには、次のステップを実行します。

1. 「アクション」メニューをクリックし、「フラッシュバック」を選択します。

2. 「フラッシュバック」リージョンで、時間(分)を入力します。

3. 「適用」をクリックします。

対話モード・レポートの保存

すべてのユーザーが、プライベートまたはパブリックの対話モード・レポートを保存できます。ただし、プライベート・レポートは、作成したユーザーのみが表示、保存、名前変更または削除できます。開発者には、最初に表示されるプライマリ・デフォルト・レポートを保存したり、代替デフォルト・レポートを作成できる追加の保存機能があります。

内容は次のとおりです。

- ユーザー・タイプ別の保存オプション

- 構成の依存関係

- パブリックまたはプライベートの対話モード・レポートの保存

- デフォルトの対話モード・レポートの保存

- パブリックまたはプライベートの対話モード・レポートの名前変更

- パブリックまたはプライベートの対話モード・レポートの削除

関連項目:
「開発者としての保存されたレポートの管理」

ユーザー・タイプ別の保存オプション

エンド・ユーザーは、対話モード・レポートを次の2つの方法で保存できます。

- パブリック・レポート(エンド・ユーザーおよび開発者)。このレポートは、すべてのユーザーが表示できます。ただし、パブリック・レポートは、作成したユーザーのみが保存、名前変更または削除できます。すべてのユーザーがパブリック・レポートを表示できますが、新しいレポート名でのみ保存できます。

- プライベート・レポート(エンド・ユーザーおよび開発者)。プライベート・レポートは、作成したユーザーのみが表示、保存、名前変更または削除できます。

開発者は、さらに次の方法で対話モード・レポートを保存できます。

- プライマリ・デフォルト(開発者のみ)。プライマリ・デフォルトは、最初に表示されるレポートです。プライマリ・デフォルト・レポートは、名前を変更することも、削除することもできません。

- 代替レポート(開発者のみ)。開発者は、複数のレポート・レイアウトを作成できます。代替レポートの保存、名前の変更または削除ができるのは開発者のみです。

次に、対話モード・レポートの検索バーにある「レポート」リストを示します。

ir_reports_list.gifの説明

この例では、次の2つのレポートを示します。

- 「デフォルト」-「プライマリ・レポート」。これは、アプリケーション開発者が作成する最初のレポートです。デフォルトのプライマリ・レポートは、名前を変更することも、削除することもできません。

- 「プライベート」- 1.「制御」。これはプライベート・レポートです。プライベート・レポートは、作成したユーザーのみが表示、保存、名前変更または削除できます。

関連項目:
「開発者としての保存されたレポートの管理」

構成の依存関係

「アクション」の「レポートの保存」オプションは、アプリケーション開発者が次のことを実行した場合にのみ表示されます。

- カレント・アプリケーションに認証スキームを定義した場合。「認証によるユーザー・アイデンティティの証明」を参照してください。

- レポートの検索バーで「レポートの保存」または「パブリック・レポートの保存」を選択した場合。「対話モード・レポートの検索バーのカスタマイズ」を参照してください。

また、検索バーの「レポート」選択リストは、アプリケーション開発者がレポート属性ページの検索バーで「レポート選択リスト」を選択した場合にのみ表示されることにも注意してください。「対話モード・レポートの検索バーのカスタマイズ」を参照してください。

これらのオプションの多くはデフォルトで選択されていることに注意してください。

パブリックまたはプライベートの対話モード・レポートの保存

エンド・ユーザーは、対話モード・レポートを保存し、そのレポートをパブリックまたはプライベートとして分類できます。パブリック・レポートは、すべてのユーザーが表示できます。プライベート・レポートは、そのレポートを保存したユーザーのみが表示できます。

ヒント:
パブリック・レポートを保存するには、開発者は、レポート属性ページの「アクション・メニューに含める」で「パブリック・レポートの保存」を選択する必要があります。開発者は、認可スキームを適用して、「パブリック・レポートの保存」を有効または無効にすることもできます。「対話モード・レポートの検索バーのカスタマイズ」を参照してください。

パブリックまたはプライベートの対話モード・レポートを保存するには、次のステップを実行します。

1. 保存する対話モード・レポートを含むページに移動します。

2. レポートをカスタマイズします(たとえば、列の非表示、フィルタの追加など)。「「アクション」メニューについて」を参照してください。

3. 「アクション」メニューをクリックし、「レポートの保存」を選択します。
「レポートの保存」リージョンが表示されます。

4. エンド・ユーザーの場合、次の「レポートの保存」リージョンが表示されます。
ir_save_rpt.gifの説明

「レポートの保存」で、次の項目を指定します。

1. 名前: レポートの名前を入力します。

2. パブリック: レポートをすべてのユーザーが表示できるようにするには、このチェック・ボックスを選択します。レポートをプライベートにするには、このチェック・ボックスの選択を解除します。

3. 説明: 説明を入力します(オプション)。

4. 「適用」をクリックします。

5. 開発者の場合、次の「レポートの保存」リージョンが表示されます。
ir_save_rpt_dev.gifの説明

「レポートの保存」で、次の項目を指定します。

1. 保存: 「名前付きレポートとして保存」を選択します。

2. 名前: レポートの名前を入力します。

3. パブリック: レポートをすべてのユーザーが表示できるようにするには、このチェック・ボックスを選択します。レポートをプライベートにするには、このチェック・ボックスの選択を解除します。

4. 説明: 説明を入力します(オプション)。

5. 「適用」をクリックします。

デフォルトの対話モード・レポートの保存

開発者は、プライマリと代替という2種類のデフォルトの対話モード・レポートを保存できます。どちらのレポートも検索バーの「レポート」リストに表示されます。ただし、プライマリ・デフォルト・レポートの名前を変更したり削除することはできません。

デフォルトの対話モード・レポートを保存するには、次のステップを実行します。

1. レポートを開発者として実行します。

2. レポートをカスタマイズします(たとえば、列の非表示、フィルタの追加など)。「「アクション」メニューについて」を参照してください。

3. 「アクション」メニューをクリックし、「レポートの保存」を選択します。
「レポートの保存」リージョンが表示されます。

ir_save_rpt_dev.gifの説明

4. 「保存」で、「デフォルトのレポート設定として保存」を選択します。
別のリージョンが表示されます。

ir_save_rpt_dev2.gifの説明

5. 「デフォルト・レポート・タイプ」で、次のいずれかを選択します。

- 主: このレポートは、ページの実行時にプライマリ・レポートとして表示されます。

- 代替: このレポートは、検索バーの「レポート」リストに代替オプションとして表示されます。「代替」を選択した場合、名前を入力します。

6. 「適用」をクリックします。

パブリックまたはプライベートの対話モード・レポートの名前変更

パブリックまたはプライベートの対話モード・レポートの名前を変更するには、次のステップを実行します。

1. レポートを開発者として実行します。

2. 名前を変更するパブリックまたはプライベートの対話モード・レポートを選択します。

3. 「レポートの名前変更」リンクをクリックします。
ir_rename.gifの説明

4. 属性を編集します(たとえば、新しい名前を入力します)。

5. 「適用」をクリックします。

パブリックまたはプライベートの対話モード・レポートの削除

パブリックまたはプライベートの対話モード・レポートを削除するには、次のステップを実行します。

1. レポートを開発者として実行します。

2. レポート名のリンクの横にある「レポートの削除」アイコンをクリックします。
ir_delete.gifの説明

3. 「適用」をクリックします。

対話モード・レポートのエクスポートについて

アプリケーションをエクスポートすると、プライマリ・デフォルト、代替デフォルト、パブリックのレポートがデフォルトで含まれます。エクスポート・プロセス中に「プライベート対話モード・レポート」で「はい」を選択して、パーソナル・レポートを含めるように指定することもできます。「アプリケーションのエクスポート」を参照してください。

レポートのリセット

「アクション」メニューから「リセット」を選択すると、レポートをデフォルト設定にリセットできます。レポートをリセットすると、ユーザーが行ったすべてのカスタマイズが削除されます。

レポートをリセットするには、次のステップを実行します。

1. 「アクション」メニューをクリックし、「リセット」を選択します。

2. 「適用」をクリックします。

レポートのダウンロード

「アクション」メニューから「ダウンロード」を選択すると、対話モード・レポートをダウンロードできます。使用可能なダウンロード形式は、ご使用のインストールとレポート定義によって異なります。サポートされている形式は、カンマ区切りファイル(CSV)形式、HTML、電子メール、Microsoft Excel (XLS)形式、Adobe Portable Document Format (PDF)およびMicrosoft Wordリッチ・テキスト形式(RTF)です。

ヒント:
対話モード・レポートをダウンロードする機能は、アプリケーション開発者が構成できます。ダウンロード・オプションの構成の詳細は、「「アクション」メニューの「ダウンロード」オプションの構成」を参照してください。

レポートをダウンロードするには、次のステップを実行します。

1. 「アクション」メニューをクリックし、「ダウンロード」を選択します。

2. レポートのダウンロード形式を選択し、表示された指示に従います。

電子メールで送信されるレポートのサブスクライブ

エンド・ユーザーはレポートをサブスクライブすると、レポートの更新バージョンを受信できます。レポートをサブスクライブするには、「アクション」メニューの「サブスクリプション」をクリックします。対話モード・レポートから送信される電子メールには、電子メールの送信者を識別する、上書きできないシステム生成の電子メール署名が含まれています。

サブスクリプションを利用するための条件は次のとおりです。

- Oracle Application Express管理者は、インスタンス・レベルで電子メールを構成する必要があります。『Oracle Application Express管理ガイド』の「メールの構成」を参照してください。

- アプリケーション開発者は、対話モード・レポートの属性ページの「サブスクリプション」チェック・ボックスを選択する必要があります。「対話モード・レポートの検索バーのカスタマイズ」を参照してください。

更新版のレポート結果を電子メールで受け取るには、次のステップを実行します。

1. 「アクション」メニューをクリックし、「サブスクリプション」を選択します。
「サブスクリプションの追加」リージョンが表示されます。

2. 「サブスクリプションの追加」で、次の手順を実行します。

1. 電子メール・アドレス: レポートを受け取る電子メール・アドレスを入力します。複数の電子メール・アドレスを含める場合は、各電子メール・アドレスをカンマで区切ります。

2. 件名: 電子メールの件名行に表示するテキストを入力します。

3. 頻度: レポートの送信間隔を選択します。

4. 開始位置: 開始日時を選択します。

5. 終了: 終了日時を選択します。日、週、月または年を選択します。

6. 「適用」をクリックします。

注意:
サブスクリプションから送信される電子メールには、サブスクリプションの作成者を示すシステム生成の電子メール署名が含まれています。この署名は削除できません。

ヒント:
Oracle Application Express管理ガイドの「対話モード・レポートのサブスクリプションの管理」

開発者としての対話モード・レポートの編集

デフォルトでは、対話モード・レポートには、検索アイコンを含む検索バー、テキスト領域、「実行」ボタンおよび「アクション」メニューが含まれています。「対話モード・レポートのカスタマイズ」で説明されているとおり、ユーザーはこれらのコントロールを使用し、列の選択、フィルタの適用、ハイライト表示およびソートを行うことによってレポート・データのレイアウトを変更できます。このセクションでは、開発者がレポート属性を編集して、対話モード・レポートをカスタマイズする方法について説明します。

内容は次のとおりです。

- 対話モード・レポートの属性ページへのアクセス

- 対話モード・レポートの列属性の編集

- 列グループの作成

- 対話モード・レポートのページ区切りの制御

- 対話モード・レポートの列ソートの管理

- 対話モード・レポートの検索バーのカスタマイズ

- 「アクション」メニューの「ダウンロード」オプションの構成

- リンク列の理解

- 対話モード・レポートでの列 リンクの作成

- 対話モード・レポートの条件付き表示

- 対話モード・レポートでのLOVとしての列定義

- 対話モードの値レポートでの列の書式設定

- アイコン・ビューの有効化

- 詳細ビューの有効化

- 対話モード・レポートの詳細属性の構成

- 対話モード・レポートへのリンクの設定

- 共有対話モード・レポートへのリンクの設定

- 開発者としての保存されたレポートの管理

- 保存済のレポートのアクティビティの表示

ヒント:
対話モード・レポートをユーザーとして使用する方法の詳細は、「対話モード・レポートのカスタマイズ」を参照してください。

対話モード・レポートの属性ページへのアクセス

対話モード・レポートの属性ページで属性を編集することによって、対話モード・レポートをカスタマイズします。

レポート属性ページを表示するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 編集する対話モード・レポートを含むページを選択します。
「ページ定義」が表示されます。

4. 対話モード・レポートの属性ページにアクセスするには、次の操作を実行します。

- ツリー・ビュー: リージョン名を右クリックし、「レポート属性の編集」を選択します。
edit_rpt_attr_tree.gifの説明

- コンポーネント・ビュー: 「リージョン」で、編集するレポート・リージョンの名前の横にある「対話モード・レポート」リンクをクリックします。
int_rprt_att.gifの説明

関連項目:
「ツリー・ビューとコンポーネント・ビューの切替え」

5. レポート属性ページが表示されます。このページは次のセクションに分かれています。

- 「列属性」はレポート・レイアウトを制御します。「対話モード・レポートの列属性の編集」を参照してください。

- 「列グループ」属性を使用すると、複数列を単一行ビューにグループ化できます。「列グループの作成」を参照してください。

- 「ページ区切り」属性はレポートのページ区切りを制御します。「対話モード・レポートのページ区切りの制御」を参照してください。

- 「ソート」属性を使用すると、値をソートするためレポート見出しに表示するイメージの、イメージおよびイメージ属性を定義できます。「対話モード・レポートでの列ソートの管理」を参照してください。

- 「検索バー」には、対話モード・レポート内に検索バーを定義するための属性が含まれています。「対話モード・レポートの検索バーのカスタマイズ」を参照してください。

- 「ダウンロード」を使用すると、「アクション」メニューにダウンロード・オプションを追加して、レポートをCSV、HTML、電子メール、XLS、PDFまたはRTFファイルでエクスポートできるようになります。「「アクション」メニューのダウンロード・オプションの構成」を参照してください。

- 「リンク列」属性を使用すると、列にリンクを追加できます。「リンク列の理解」および「対話モード・レポートでの列リンクの作成」を参照してください。

- 「詳細属性」を使用すると、「対話モード・レポート」リージョンの別名の定義、保存したレポートのIDを格納する値を持つアイテムの指定、およびセッション・ステートに設定するアイテムの定義を行うことができます。「対話モード・レポートの詳細属性の構成」を参照してください。

- 「アイコン・ビュー」属性を使用すると、検索バーに「アイコンの表示」アイコンを追加できます。「アイコン・ビューの有効化」を参照してください。

- 「詳細ビュー」属性を使用すると、検索バーに「詳細の表示」アイコンを追加できます。「詳細ビューの有効化」を参照してください。

- 「説明」には、現在のレポートの説明テキストが表示されます。

6. 特定の属性の詳細を表示するには、アイテム・ラベルをクリックします。
ヘルプが使用可能な場合は、アイテムにカーソルをあわせると、カーソルが疑問符付きの矢印に変わります。「フィールドレベル・ヘルプについて」を参照してください。

関連項目:
「クラシック・レポートでの列リンクの作成」、「クラシック・レポートでの更新可能な列の定義」、「クラシック・レポートでのLOVとしての列定義」および「クラシック・レポートの列の表示条件の制御」

ナビゲーションの選択肢について

レポート属性ページは、「列属性」、「グループ」、「ページ区切り」、「ソート」、「検索バー」、「ダウンロード」、「リンク列」、「アイコン・ビュー」、「詳細ビュー」、「詳細」および「説明」の各セクションに分かれています。

これらのセクションにアクセスするには、ページをスクロールするか、ページ上部のナビゲーション・ボタンをクリックします。

図int_rprt_nav.gifの説明

ページ上部のボタンを選択すると、選択されたセクションが表示され、その他のセクションはすべて一時的に非表示になります。ページのすべてのセクションを表示するには、「すべて表示」をクリックします。

対話モード・レポートの列属性の編集

レポート属性ページの「列属性」セクションを使用すると、レポート・レイアウトを詳細に制御できます。たとえば、これらの属性を使用して、列ヘッダー・テキストの変更、列の位置の変更、または列の非表示化を行うことができます。

「列属性」にアクセスするには、次のステップを実行します。

1. 対話モード・レポートの属性ページにアクセスします。詳細は、「対話モード・レポートの属性ページへのアクセス」を参照してください。
ページ上部に「列属性」セクションがある対話モード・レポートの属性ページが表示されます。

int_rprt_col.gifの説明

「列属性」セクションを使用して、レポート列の外観と機能を制御します。

「ヘッダー」には、レポートに含めるヘッダー・テキストが表示されます。「タイプ」は、問合せ列の型を示します。「リンク」列は、リンク列が現在定義されているかどうかを示します。

表 9-1に、レポート列の基本的な編集操作を示します。

表 9-1 対話モード・レポートのレポート列の基本的な編集操作

説明

開発者の操作

列の表示順序を変更します。

上矢印および下矢印をクリックして、列の表示順序を変更します。

この表示順序は単一行ビュー(有効になっている場合)でのみ使用されます。レポート列の表示には影響しません。レポート列の表示は、レポートを実行して保存するときに変更できます。

列グループの割当てを変更します。

列グループが定義されている場合、「列グループ」で列を個別に割り当てることができます。

列ヘッダーのテキストを変更します。

「ヘッダー」で、異なるヘッダー・テキストを入力します。

列の表示方法を変更します。

「表示テキスト」からオプションを選択します。

列属性ページで、特定の列の属性をさらに詳細に指定できます。

2. 列属性ページにアクセスするには、該当する列の別名の横にある「編集」アイコンをクリックします。
「列の定義」が表示されます。

ir_col_def.gifの説明

「ユーザーに許可する操作」の下のチェック・ボックスを使用して、ユーザーによるレポートの操作を制御します。オプションには、「非表示」、「ソート」、「フィルタ」、「ハイライト」、「コントロール・ブレーク」、「集計」、「計算」、「チャート」および「グループ化」があります。

3. 「列の定義」の「ユーザーに許可する操作」で、該当するチェック・ボックスを選択します。
特定の属性の詳細を表示するには、アイテム・ラベルをクリックします。

列グループの作成

列グループを使用すると、列を単一行ビューにグループ化できます。

列グループを作成するには、次のステップを実行します。

1. 対話モード・レポートの属性ページにアクセスします。詳細は、「対話モード・レポートの属性ページへのアクセス」を参照してください。
対話モード・レポートの属性ページが表示されます。

2. 「列グループ」までスクロールします。

3. 「グループの追加」をクリックします。

4. 「列グループ」で、次の手順を実行します。

1. 順序: この列グループの表示順序を入力します。この属性は、詳細ビューで列グループが表示される順番を決定します。

2. グループ名: 列グループ名を入力します。この名前は、詳細ビューでリージョン・ヘッダーに表示されます。

3. 説明: 列グループの説明を入力します(オプション)。この説明は、エンド・ユーザーには表示されません。

5. 「作成」をクリックします。

対話モード・レポートのページ区切りの制御

対話モード・レポートの属性ページの「ページ区切り」属性から選択することによって、ページ区切りの表示方法を制御します。

レポート属性ページの「ページ区切り」セクションにアクセスするには、次のステップを実行します。

1. 対話モード・レポートの属性ページにアクセスします。詳細は、「対話モード・レポートの属性ページへのアクセス」を参照してください。
対話モード・レポートの属性ページが表示されます。

2. 「ページ区切り」までスクロールします。
「ページ区切り」属性では、ページ区切りスタイルの選択、ページ区切りの表示位置の決定、問合せの最大行数の指定、および最大行数を超える行が戻された場合や1行も戻されなかった場合に表示するメッセージの指定などを行います。

表9-2に、使用可能な「ページ区切り」属性を示します。

表 9-2 「ページ区切り」属性

属性

説明

ページ区切りタイプ

ページ区切りタイプを選択します。ページ区切りによって、結果セット内の行数および現在の位置に関する情報が提供されます。ページ区切りを表示できるのは、レポートの上または下(あるいは両方)です。位置は左または右に設定できます。ページ区切りの有効なオプションは、次のとおりです。

- XからYの範囲の行

- ZのXからYの範囲の行

ページ区切り表示位置

ページ区切りの表示位置を定義します。ページ区切りは、レポートの左側、右側、上部または下部に表示できます。

NULL値を置き換えて表示

NULL列に表示するテキストを入力します。デフォルト値は(null)です。

行カウント最大値

問合せを行う最大行数を定義します(例: 行1 - 10または456)。

この属性を200に設定すると、結果は次のように表示されます。

rows 1 - 10 of more than 200 rows

この属性はパフォーマンスに影響を与えます。より少ない行数をカウントするとパフォーマンスは向上し、数千という行数をカウントするとパフォーマンスは低下します。

最大行数を超える行データでメッセージが見つかったとき

最大行数を超える行が返されたときに表示するテキスト・メッセージを定義します。

データが見つからなかった場合のメッセージ

問合せから行が返されなかったときに表示するテキスト・メッセージを定義します。

対話モード・レポートの列ソートの管理

対話モード・レポートの属性ページで列ソートを管理できます。

列ソートを管理するには、次のステップを実行します。

1. 対話モード・レポートの属性ページにアクセスします。詳細は、「対話モード・レポートの属性ページへのアクセス」を参照してください。
対話モード・レポートの属性ページが表示されます。

2. 「列属性」で、ソートを有効にする列の「編集」アイコンをクリックします。

3. 「列の定義」で、「ソート」を選択し「変更の適用」をクリックします。
対話モード・レポートの属性ページが表示されます。

4. 「ソート」までスクロールします。

5. 昇順イメージ属性および降順イメージ属性を指定し、「変更の適用」をクリックします。

対話モード・レポートの検索バーのカスタマイズ

検索バーは各対話モード・レポートの上部に表示され、「検索列の選択」アイコン、テキスト領域、「実行」ボタンおよび「アクション」メニューが含まれています。

ir_search_bar.gifの説明

対話モード・レポートの属性ページの「検索バー」セクションのオプションを選択および選択解除して、検索バーを削除したり、カスタマイズすることができます。

内容は次のとおりです。

- 検索バーのカスタマイズ

- 検索バーの削除

関連項目:
「アイコン・ビューの有効化」および「詳細ビューの有効化」

検索バーのカスタマイズ

検索バーをカスタマイズするには、次のステップを実行します。

1. 対話モード・レポートの属性ページにアクセスします。詳細は、「対話モード・レポートの属性ページへのアクセス」を参照してください。
対話モード・レポートの属性ページが表示されます。

2. 「検索バー」までスクロールします。
ir_att_search_bar.gifの説明

これらの属性を使用して、検索バーの表示方法をカスタマイズします。表9-3に、「検索バー」属性を示します。

表9-3 「検索バー」属性

属性

説明

検索バーを含める

「はい」または「いいえ」を選択します。「いいえ」を選択すると、次のデフォルトのコンポーネントが削除されます。

- 検索フィールド: 検索基準を入力するテキスト・フィールドが検索バーに表示されます。

- ファインダ・ドロップ・ダウン: 選択した1列またはすべての列に対してユーザーが検索できるようにします。

- レポート選択リスト: レポートに代替デフォルト、共有レポートまたはパーソナル・レポートが含まれている場合に、レポート選択リストを表示します。「対話モード・レポートの保存」を参照してください。

- ページごとの行数セレクタ: 選択リストが表示され、1ページ当たりに表示される行数をそのリストから選択できます。

- アクション・メニュー: 選択した「アクション」に基づいてユーザーがレポートをカスタマイズできるようにします。

アクション・メニューに含める

「アクション」メニューに含める機能を選択および選択解除します。使用可能なオプションは次のとおりです。

- 列の選択: レポート列の表示/非表示および並替えを行うときに使用します。

- フィルタ: レポートにフィルタを追加するときに使用します(たとえば、STATE = VA)。

- ページごとの行数: 「ページごとの行数」メニューを表示するときに使用します。

- ソート: 列をソートするときに使用します。

- コントロール・ブレーク: レポート列にコントロール・ブレークを作成するときに使用します。

- ハイライト: 特定の行をハイライトする条件を定義するときに使用します。

- 計算: 計算結果の列を追加するときに使用します。

- 集計: レポート列に集計計算を含めるときに使用します。

- チャート: レポートのデータを利用せずにFlashチャートを作成するときに使用します。

- グループ化: レポートのデータを利用せずに「グループ化」ビューを作成するときに使用します。

- フラッシュバック: レポート・データを過去のある時点までフラッシュバックするときに使用します。

- レポートの保存: 後で利用できるようにレポート設定を保存するときに使用します。認証済ページにのみ使用できます。

- パブリック・レポートの保存*: すべてのユーザーが表示できるパブリック・レポートを保存するときに使用します。このオプションを有効にするには、「レポートの保存」を選択する必要があります。未認証ページにのみ使用できます。

- リセット: レポートをデフォルト設定にリセットするときに使用します。

- ヘルプ: 対話モード・レポートの使用方法を表示するときに使用します。

- ダウンロード: レポートを様々な形式でダウンロードするときに使用します。
注意: ダウンロード機能を無効にしても、「アクション」メニューに「ダウンロード」メニューが表示されなくなるだけです。ユーザーによるデータのダウンロードを完全に防止するには、「ダウンロード形式」セクションのすべてのチェック・ボックスの選択を解除します。

- サブスクリプション*: レポートを電子メールで送信するようにサブスクリプションをスケジュールするときに使用します。未認証ページにのみ使用できます。

関連項目: 「「アクション」メニューについて」。

レポートのパブリック保存の認可

ユーザーは、レポートを保存し、そのレポートをパブリックまたはプライベートとして分類できます。パブリック・レポートは、すべてのユーザーが表示できます。プライベート・レポートは、そのレポートを保存したユーザーのみが表示できます。

「アクション」メニューで「パブリック・レポートの保存」を有効にすることに加え、「パブリック・レポートの保存」を有効にする権限を持つユーザーを決定する認可スキームを定義することによって、セキュリティを強化できます。

パブリック・レポートのサポートを有効にするには、このリストから認証方式を選択する必要があります。

ボタン・テンプレート

検索リージョンおよびダイアログに表示されるボタンのテンプレートを選択します。

ファインダ・イメージ

イメージを指定します。イメージを定義しなかった場合、次のイメージが使用されます。

/i/htmldb/builder/finder_w_dropdown.gif

アクション・メニューのイメージ

イメージを指定します。イメージを定義しなかった場合、デフォルトのボタンが使用されます。

検索ボタン・ラベル

検索ボタン・ラベルとして使用するテキストを指定します。

最大行数/ページ

「ページごとの行数セレクタ」に表示する最大数を入力します。

3. 「変更の適用」をクリックします。

検索バーの削除

検索バーを削除するには、次のステップを実行します。

1. 対話モード・レポートの属性ページにアクセスします。詳細は、「対話モード・レポートの属性ページへのアクセス」を参照してください。
対話モード・レポートの属性ページが表示されます。

2. 「検索バー」までスクロールします。

3. 「検索バーを含める」から、「いいえ」を選択します。

4. 「変更の適用」をクリックします。

「アクション」メニューの「ダウンロード」オプションの構成

「アクション」メニューに「ダウンロード」オプションを追加すると、ユーザーが対話モード・レポートをカンマ区切りファイル(CSV)形式、HTML、Microsoft Excel (XLS)形式、Adobe Portable Document Format (PDF)、Microsoft Wordリッチ・テキスト形式(RTF)、または電子メール添付のHTMLとしてダウンロードできます。

図download.gifの説明

ダウンロード形式の有効化

ダウンロード形式を構成するには、次のステップを実行します。

1. 対話モード・レポートの属性ページにアクセスします。詳細は、「対話モード・レポートの属性ページへのアクセス」を参照してください。
対話モード・レポートの属性ページが表示されます。

2. 「検索バー」までスクロールします。

1. 「検索バーを含める」で、「はい」を選択し、「アクション・メニュー」を選択します。

2. 「アクション・メニューに含める」で、「ダウンロード」を選択します。

ヒント:
ダウンロード機能を無効にしても、「アクション」メニューに「ダウンロード」メニューが表示されなくなるだけです。ユーザーが完全にデータをダウンロードできなくするには、「ダウンロード形式」セクションのすべてのチェック・ボックスを選択解除します。

3. 「ダウンロード」までスクロールします。

4. ダウンロード形式を選択します。オプションは次のとおりです。

- 「CSV」。「CSVダウンロードの有効化」を参照してください。

- 「HTML」。

- 「電子メール」。「電子メール・ダウンロードの有効化」を参照してください。

- 「XLS」。

- 「PDF」。「PDFへのレポート出力について」を参照してください。

- 「RTF」。

ヒント:
「アクション」メニューに「ダウンロード」オプションが表示されるのは、ファイル形式を選択した場合のみです。レポート・サーバーがインスタンス管理内で定義されていない場合、一部のオプションは表示されません。詳細は、『Oracle Application Express管理ガイド』の「レポート出力の構成」を参照してください。

5. 「変更の適用」をクリックします。

CSVダウンロードの有効化

CSVダウンロードを有効にするには、次のステップを実行します。

1. グローバリゼーション属性の編集ページで「CSV出力」オプションを有効にします。「グローバリゼーション属性のページへのアクセス」および「自動CSVエンコーディング」を参照してください。

2. 対話モード・レポートの属性ページにアクセスします。詳細は、「対話モード・レポートの属性ページへのアクセス」を参照してください。
対話モード・レポートの属性ページが表示されます。

3. 「検索バー」までスクロールします。

1. 「検索バーを含める」で、「はい」を選択し、「アクション・メニュー」を選択します。

2. 「アクション・メニューに含める」で、「ダウンロード」を選択します。

4. 「ダウンロード」までスクロールします。

5. 「ダウンロード形式」から、「CSV」を選択します。

ヒント:
「アクション」メニューに「ダウンロード」オプションが表示されるのは、ファイル形式を選択した場合のみです。

6. 「CSVセパレータ」で、列セパレータを定義します。値が入力されていない場合は、現行のNLS設定に応じて、カンマまたはセミコロンが使用されます。

7. 「CSV囲み文字」にデリミタ文字を入力します。この文字は、データ値の開始境界および終了境界を区切るために使用されます。デフォルトのデリミタは二重引用符(" ")です。

8. 「ファイル名」にダウンロードするドキュメントのファイル名を入力します。ファイル拡張子は指定しないでください。拡張子は自動的に追加されます。これを空白のままにすると、リージョン名がファイル名として使用されます。

9. 「変更の適用」をクリックします。

電子メール・ダウンロードの有効化

特定の電子メール・アドレスに静的HTMLレポートを送信するように「ダウンロード」オプションを構成します。

ヒント:
電子メール・ダウンロードは、認証済ページでのみサポートされます。パブリック・ページで電子メール・ダウンロードを有効にしても、「電子メール」ダウンロード・オプションは「ダウンロード」ダイアログに表示されません。

電子メール・ダウンロードを有効にするには、次のステップを実行します。

1. Oracle Application Express管理者は、インスタンス・レベルで電子メールを構成する必要があります。Oracle Application Express管理ガイドの「メールの構成」を参照してください。

2. 対話モード・レポートの属性ページにアクセスします。詳細は、「対話モード・レポートの属性ページへのアクセス」を参照してください。
対話モード・レポートの属性ページが表示されます。

3. 「検索バー」までスクロールします。

1. 「検索バーを含める」で、「はい」を選択し、「アクション・メニュー」を選択します。

2. 「アクション・メニューに含める」で、「ダウンロード」を選択します。

4. 「ダウンロード」までスクロールします。

5. 「ダウンロード形式」から、「電子メール」を選択します。

ヒント:
「アクション」メニューに「ダウンロード」オプションが表示されるのは、ファイル形式を選択した場合のみです。

6. 「変更の適用」をクリックします。

注意:
電子メール・ダウンロードから送信された電子メールには、電子メールの送信元を特定するシステム生成の電子メール署名が含まれています。この署名は削除できません。

関連項目:
「対話モード・レポートからの電子メール送信について」

リンク列の理解

対話モード・レポートの左側には、「リンク列」が表示されます。この列は、単一行ビュー(カスタム・ターゲット)にリンクすることができます。また、レポートから除外することもできます。エンド・ユーザーからは、リンク列のソート、非表示、移動はできません。リンク列は、列属性ページに定義されている標準の列リンクとは関係ありません。

単一行ビューへのリンクの設定

単一行ビューにリンクするには、次のステップを実行します。

1. 対話モード・レポートの属性ページにアクセスします。詳細は、「対話モード・レポートの属性ページへのアクセス」を参照してください。
対話モード・レポートの属性ページが表示されます。

2. 「リンク列」までスクロールします。

3. 「リンク列」で、「単一行ビューへのリンク」を選択します。

4. 「単一行ビュー」で、適切なオプションを選択します。

- NULL値の除外を許可: NULL値の列を除外します。

- 表示列を許可: レポートに表示されている列のみを表示します。

5. 「一意に行を識別する基準」で、「行ID」または「一意列」を選択します。
「一意列」を選択した場合、「一意列」フィールドに列を指定します。

6. 「リンク・アイコン」で、アイコンを選択します。

7. (オプション)「リンク属性」で、<a href= >タグに含める追加の列リンク属性(リンク・ターゲット、クラス、スタイルなど)を指定します。

8. 「変更の適用」をクリックします。

ヒント:
対話モード・レポートが単一行ビューにリンクされており、リンク・アイコンにALTテキストがないか、ALTテキストが空である場合、レポートにアクセスできるようにするためにalt="単一行ビュー"が自動的に含められます。この動作を上書きするには、意味のあるALTテキストを含めてください。

特定のページへのリンクの設定

特定のページにリンクするには、次のステップを実行します。

1. 対話モード・レポートの属性ページにアクセスします。詳細は、「対話モード・レポートの属性ページへのアクセス」を参照してください。
対話モード・レポートの属性ページが表示されます。

2. 「リンク列」までスクロールします。

3. 「リンク列」で、「カスタム・ターゲットへのリンク」を選択します。

4. 「リンク・アイコン」で、アイコンを選択します。

5. (オプション)「リンク属性」で、<a href= >タグに含める追加の列リンク属性(リンク・ターゲット、クラス、スタイルなど)を指定します。

6. 「ターゲット」で、「このアプリケーションのページ」を選択します。

7. 「ページ」で、ターゲットのページ番号を選択します。このページのページ区切りをリセットするには、「ページ区切りのリセット」を選択します。

8. 「リクエスト」で、使用するリクエストを指定します。

9. 「キャッシュのクリア」で、キャッシュをクリアするページ(ページ番号)を指定します。ページ番号をカンマで区切ってリストすることによって、複数のページを指定できます。「対話モード・レポートへのリンクの設定」を参照してください。

10. 「名前」および「値」で、特定のアイテムのセッション・ステートを指定します。

11. 「変更の適用」をクリックします。

URLへのリンクの設定

URLにリンクするには、次のステップを実行します。

1. 対話モード・レポートの属性ページにアクセスします。詳細は、「対話モード・レポートの属性ページへのアクセス」を参照してください。
対話モード・レポートの属性ページが表示されます。

2. 「リンク列」までスクロールします。

3. 「リンク列」で、「カスタム・ターゲットへのリンク」を選択します。

4. 「リンク・アイコン」で、アイコンを選択します。

5. (オプション)「リンク属性」で、<a href= >タグに含める追加の列リンク属性(リンク・ターゲット、クラス、スタイルなど)を指定します。

6. 「ターゲット」から「URL」を選択します。

7. 「URL」で、該当するアドレスを入力します。

8. チェックサムで、次のいずれかを選択します。

- デフォルトの使用

- アプリケーション・レベル - すべてのユーザーが再利用可能なリンク

- ユーザー・レベル - 現行のユーザーが再利用可能なリンク

各オプションの詳細は、アイテムのヘルプを参照してください。

9. 「変更の適用」をクリックします。

列リンクの除外

列リンクを除外するには、次のステップを実行します。

1. 対話モード・レポートの属性ページにアクセスします。詳細は、「対話モード・レポートの属性ページへのアクセス」を参照してください。
対話モード・レポートの属性ページが表示されます。

2. 「リンク列」までスクロールします。

3. 「リンク列」で、「リンク列の除外」を選択します。

4. 「変更の適用」をクリックします。

対話モード・レポートでの列 リンクの作成

レポートからアプリケーション内の別のページまたはURLへのリンクを作成するには、「列属性」を使用します。

別のページへの列リンクを作成するには、次のステップを実行します。

1. 対話モード・レポートの属性ページにアクセスします。詳細は、「対話モード・レポートの属性ページへのアクセス」を参照してください。
対話モード・レポートの属性ページが表示されます。

2. 「列属性」で、リンクを含む列を指定します。

3. 列名の横にある「編集」アイコンをクリックします。
列属性ページが表示されます。

4. 「列リンク」までスクロールします。

5. 別のページへの列リンクを作成するには、次のステップを実行します。

1. 「ターゲット」で、「このアプリケーションのページ」を選択します。

2. (オプション)「リンク属性」で、<a href= >タグに含める追加の列リンク属性(リンク・ターゲット、クラス、スタイルなど)を指定します。

3. 「リンク・テキスト」で、リンクとして表示されるテキストを入力するか、イメージ・タグを指定するか、またはデフォルトのイメージのリストから選択します。

4. 「ページ」で、ターゲット・ページ番号を指定します。このページのページ区切りをリセットするには、「ページ区切りのリセット」を選択します。

5. 「リクエスト」で、使用するリクエストを指定します。

6. 「キャッシュのクリア」で、キャッシュをクリアするページ(ページ番号)を指定します。ページ番号をカンマで区切ってリストすることによって、複数のページを指定できます。

7. 特定のアイテムのセッション・ステートを指定するには、「名前」フィールドおよび「値」フィールドを使用します。

8. チェックサムで、次のいずれかを選択します。

- デフォルトの使用

- アプリケーション・レベル - すべてのユーザーが再利用可能なリンク

- ユーザー・レベル - 現行のユーザーが再利用可能なリンク

各オプションの詳細は、アイテムのヘルプを参照してください。

6. 「変更の適用」をクリックします。

URLへの列リンクを作成するには、次のステップを実行します。

1. 対話モード・レポートの属性ページにアクセスします。詳細は、「対話モード・レポートの属性ページへのアクセス」を参照してください。
対話モード・レポートの属性ページが表示されます。

2. 該当する列の横にある「編集」アイコンをクリックして、列属性ページにアクセスします。
列属性ページが表示されます。

3. 「列リンク」までスクロールします。

4. 「列リンク」で、次を指定します。

1. 「ターゲット」から「URL」を選択します。

2. 「リンク・テキスト」で、リンクとして表示されるテキストを入力し、置換文字列を選択します。

3. (オプション)「リンク属性」で、<a href= >タグに含める追加の列リンク属性(リンク・ターゲット、クラス、スタイルなど)を指定します。

4. 「URL」で、該当するアドレスを入力します。

5. 「変更の適用」をクリックします。

対話モード・レポートの条件付き表示

リージョンの編集ページでリージョン属性を編集することによって、対話モード・レポートを条件付きで表示するように指定できます。

対話モード・レポートを条件付きで表示するには、次のステップを実行します。

1. 該当する「ページ定義」にナビゲートします。「「ページ定義」へのアクセス」を参照してください。

2. リージョンの編集ページにアクセスします。

- コンポーネント・ビュー: 「リージョン」で、リージョン名を選択します。

- ツリー・ビュー: リージョン名を右クリックし、「編集」を選択します。

リージョンの編集ページが表示されます。

3. 「条件」までスクロールします。

4. 「条件タイプ」リストから選択します。

5. 表示されるフィールドに式を入力します。

6. 「変更の適用」をクリックします。

ヒント:
Asynchronous JavaScript and XML (AJAX)が対話モード・レポート全体で使用されています。AJAXは非同期であるため、条件付き表示用に評価される値はセッション内に含まれている必要があります。指定した値に基づいて対話モード・レポートを条件付きで表示するには、:REQUEST値のかわりにページ・アイテムを使用します。条件付き表示で:REQUESTを使用した場合、対話モード・レポート内の機能が正しく動作しません。

対話モード・レポートでの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. 「変更の適用」をクリックします。

対話モードの値レポートでの列の書式設定

対話モード・レポートで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#

前述の例の場合、この例の#COLUMN_CLASS#および#EMPLOYEE_STATUS#置換は、レポートSQL問合せで選択した列になります。

例3:

<img src="#IMAGE_NAME#" title="#EMPLOYEE_NAME#">

5. 「変更の適用」をクリックします。

アイコン・ビューの有効化

デフォルトでは、ほとんどの対話モード・レポートはレポートとして表示されます。必要に応じて、列をアイコンとして表示できます。構成すると、検索バーに「アイコンの表示」アイコンが表示されます。

ir_search_bar_icon.gifの説明

アイコン・ビューを利用するには、アイコン、ラベルおよびターゲット(つまり、リンク)を識別するために使用する列を指定します。これらの列は通常エンド・ユーザーには役立たないため、非表示になるように設定することをお薦めします。

内容は次のとおりです。

- 対話モード・レポートへのアイコン・ビューの追加

- カスタム・アイコン・ビュー・リンクの追加

対話モード・レポートへのアイコン・ビューの追加

対話モード・レポートにアイコン・ビューを追加するには、次のステップを実行します。

1. 対話モード・レポートの属性ページにアクセスします。詳細は、「対話モード・レポートの属性ページへのアクセス」を参照してください。
対話モード・レポートの属性ページが表示されます。

2. 「アイコン・ビュー」までスクロールします。
ir_icon_view.gifの説明

3. 「アイコン・ビューの有効化」で、「はい」を選択します。

4. 次の必須属性を指定します。

- リンク列: アイコンのリンク・ターゲットを返す列を選択します。例については、アイテム・ヘルプを参照してください。

- イメージ・ソース列: イメージ・ソースを返す列を指定します。例については、アイテム・ヘルプを参照してください。

- ラベル列: イメージ・ラベルを返す列を選択します。例については、アイテム・ヘルプを参照してください。

5. 「1行当たりの行数」で、1行当たりに表示するアイコン数を指定します。値として5を指定すると、1行当たり5つのアイコンが表示されます。

6. 「変更の適用」をクリックします。

カスタム・アイコン・ビュー・リンクの追加

カスタム・アイコン・ビュー・リンクを追加するには、次のステップを実行します。

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. 「変更の適用」をクリックします。

詳細ビューの有効化

デフォルトでは、ほとんどの対話モード・レポートはレポートとして表示されます。必要に応じて、各列の詳細を表示できます。構成すると、検索バーに「詳細の表示」アイコンが表示されます。

ir_search_bar_detail.gifの説明

対話モード・レポートに詳細ビューを追加するには、次のステップを実行します。

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. 「変更の適用」をクリックします。

対話モード・レポートの詳細属性の構成

「拡張属性」セクションを使用して、「対話モード・レポート」リージョンの別名の定義、保存したレポートのIDを格納する値を持つアイテムの指定、および対話モード・レポートのサブスクリプションまたは電子メール・ダウンロードの送信者アドレスの定義を行います。

詳細属性を構成するには、次のステップを実行します。

1. 対話モード・レポートの属性ページにアクセスします。詳細は、「対話モード・レポートの属性ページへのアクセス」を参照してください。
対話モード・レポートの属性ページが表示されます。

2. 詳細属性までスクロールします。
表 9-4に、使用可能な詳細属性を示します。

表 9-4 詳細属性

属性

説明

リージョン別名

対象の対話モード・レポート・リージョンの英数字の別名を入力します。別名は、アプリケーション内で一意である必要があります。

APIコールでは、別名を使用して対話モード・レポートを参照できます。たとえば、APEX_APPLICATION_PAGE_IRビューでALIAS列を問い合せることによって、INTERACTIVE_REPORT_IDを返すファンクションを記述できます。別名は、アプリケーション内で一意である必要があります。別のインスタンスに対するエクスポート操作またはインポート操作によりINTERACTIVE_REPORT_ID値は変わることがあるため、別名を使用して対話モード・レポート・リージョンを参照すると役立ちます。

レポートIDアイテム

デフォルトつまり作業ビューではなく保存されたレポートのビューをユーザーに表示できます。保存されたビューのレポートIDを格納する値を持つアイテムを指定します。レポートIDは、APEX_APPLICATION_PAGE_IR_RPTビューから取得できます。

電子メール送信者アドレス

電子メール・ダウンロードまたはサブスクリプションから電子メールを送信する際に送信者アドレスとして使用する有効な電子メール・アドレスを入力します。値には、有効な電子メールを含むリテラル文字列、置換構文を使用してアプリケーション・レベルで定義されているアプリケーション置換、またはアプリケーション・レベルで定義されている「アプリケーションの電子メール送信元アドレス」を返す&APP_EMAIL.置換を指定できます。Examples:

john.doe@abc.com
&MY_APP_EMAIL_FROM.
&APP_EMAIL.

アプリケーション・レベルまたはページ・レベルでのアイテム置換の使用は、電子メール・ダウンロードでのみ動作し、サブスクリプションでは動作しないためお薦めしません。

ヒント: 電子メール送信者アドレスは、次の優先順位で決定されます。

レポート・レベルの「電子メール送信者アドレス」 > アプリケーション・レベルの「アプリケーションの電子メール送信元アドレス」 > インスタンス・レベルの「デフォルトの電子メール送信元アドレス」

これらすべてがNULLの場合、電子メール送信者アドレスは電子メール宛先アドレスと同じになります。

関連項目: 「アプリケーション定義の編集ページについて」。

3. 「変更の適用」をクリックします。

対話モード・レポートからの電子メール送信について

次の2つの方法で、対話モード・レポートから送信される電子メールの送信者アドレスを定義できます。

- アプリケーション定義の編集ページの「アプリケーションの電子メール送信元アドレス」属性で、アプリケーション・レベルで定義できます。「アプリケーション定義の編集ページについて」を参照してください。

- 対話モード・レポートの属性ページの「電子メール送信者アドレス」属性で、対話モード・レポート・レベルで定義できます。「対話モード・レポートの詳細属性の構成」を参照してください。

いずれの場合も、値には、有効な電子メールを含むリテラル文字列、アプリケーション・レベルで置換構文を使用して定義されているアプリケーション置換、またはアプリケーション・レベルで定義されている「アプリケーションの電子メール送信元アドレス」を返す&APP_EMAIL.置換を指定できます。Examples:

john.doe@abc.com
&MY_APP_EMAIL_FROM.
&APP_EMAIL.

アプリケーション・レベルまたはページ・レベルでのアイテム置換の使用は、電子メール・ダウンロードでのみ動作し、サブスクリプションでは動作しないためお薦めしません。

関連項目:
「電子メール・ダウンロードの有効化」および「置換文字列の理解」

対話モード・レポートへのリンクの設定

一般にページ・アイテムをレポート・パラメータとして使用するクラシック・レポートとは異なり、対話モード・レポートのデータは、宣言的なフィルタで決まります。ただし、開発者は、エンド・ユーザーに対する対話モード・レポート設定を変更することで、このレポート・パラメータを設定できます。この設定は、エンド・ユーザーが作業しているレポートのみに影響し、保存済のレポート設定には影響しません。

リンク内の対話モード・レポートをリセットするには、「URL」の「キャッシュのクリア」セクションで文字列"RIR"を使用します。この値は、エンド・ユーザーがターゲット・ページで対話モード・レポートの「アクション」メニューから「リセット」オプションを選択した場合に相当します。レポートは、開発者が指定したか、またはユーザーが保存したデフォルトのレポート設定に戻ります。

対話モード・レポートにRow text containsフィルタを作成するには、URLのItem Namesセクションで文字列IR_ROWFILTERを使用します。この文字列を追加すると、URLのItem Valuesセクションの対応する場所にフィルタ値が渡されます。

リンク内の対話モード・レポートにフィルタを作成するには、URLのItem Namesセクションで文字列IR<operator>_<target column alias>を指定し、URLのItem Valuesセクションの対応する場所にフィルタ値を渡します。

有効な演算子は、次のとおりです。

- C = 含む

- EQ = 等しい(これがデフォルトです)

- GTE = 以上

- GT = より大きい

- LIKE = SQLのLike演算子

- LT = 未満

- LTE: より小さいか、等しい

- N = NULL

- NC = 含まない

- NEQ = 等しくない

- NLIKE = 次と類似ではない

- NN = NULLではない

- NIN = 次に含まれない(バックスラッシュ\でカンマ区切り値をエスケープします)

- IN = 次に含まれる(バックスラッシュ\でカンマ区切り値をエスケープします)

- ROWFILTER = 次を含む行テキスト(これにより、レポートに表示されるタイプSTRINGまたはNUMBERのすべての列が検索されます)

次に例を示します。

f?p=...:IR_ENAME:KING

前述の例は、エンド・ユーザーがターゲット・ページでENAME = KINGというフィルタを作成した場合に相当します。演算子を指定しない場合、デフォルトのEQが使用されます。

f?p=...:IRGT_SAL:3000

前述の例は、エンド・ユーザーがターゲット・ページでSAL > 3000というフィルタを作成するのと同じです。

共有対話モード・レポートへのリンクの設定

URLのリクエスト値でIR_REPORT_[report_alias]を使用して、保存済のプライマリ・デフォルト、代替デフォルトおよびパブリック・レポートにリンクを設定できます。

プライマリ・レポートへのリンクの例

次の各例では、プライマリ・レポート(report_alias=12345)へのリンクを設定する方法を示します。

この例では、プライマリ・レポートへのリンクを設定しています。

f?p=100:1:&APP_SESSION.:IR_REPORT_12345

この例では、プライマリ・レポートへのリンクを設定し、レポート設定のリセットおよびクリアを行っています。

f?p=100:1:&APP_SESSION.:IR_REPORT_12345::RIR,CIR:

この例では、プライマリ・レポートへのリンクを設定し、レポート設定のリセットおよびクリアを行っています。さらに、プライマリ・レポートでENAME = 'KING'フィルタを作成しています。

f?p=100:1:&APP_SESSION.:IR_REPORT_12345::RIR,CIR:IR_ENAME:KING

保存済のレポートへのリンクの例

次の各例では、保存済のレポート(report_alias=12345)へのリンクを設定する方法を示します。

この例では、保存済のレポートへのリンクを設定しています。

f?p=100:1:&SESSION.:IR_REPORT_1234

この例では、保存済のレポート12345へのリンクを設定し、レポート設定のリセットおよびクリアを行っています。

f?p=100:1:&SESSION.:IR_REPORT_12345::RIR,CIR:

この例では、保存済のレポート12345へのリンクを設定し、レポート設定のリセットおよびクリアを行っています。さらに、保存済のレポート12345でENAME = 'KING'フィルタを作成しています。

f?p=100:1:&SESSION.:IR_REPORT_12345::RIR,CIR::RIR,CIR:IR_ENAME:KING

IR_REPORT_[report_alias]リクエスト値のないURLを使用してフィルタをリセット、クリアまたは作成すると、プライマリ・レポートのフィルタがリセット、クリアまたは作成されます。たとえば、次のリンクはプライマリ・レポートに移動します。

f?p=100:1:&SESSION.:::RIR,CIR:IR_ENAME:KING

保存済のレポートの別名の編集

開発者は、保存されたレポート・ページに移動して、レポートの別名を編集したり、リンク例を表示することができます。

保存されたレポート・ページにアクセスするには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 保存済の対話モード・レポートを含む「ページ定義」に移動します。
「ページ定義」が表示されます。

4. 保存されたレポート・ページにアクセスするには、次の操作を実行します。

- ツリー・ビュー: リージョン名を右クリックし、「保存されたレポートの編集」を選択します。

- コンポーネント・ビュー: 「リージョン」で、「保存されたレポート」リンクをクリックします。
保存されたレポート・ページが表示されます。

5. 「レポート別名」で、次のいずれかの操作を実行できます。

- 保存済のレポートの新しい別名を入力します。

- リンク例をコピー・アンド・ペーストして、保存済の特定のレポートへのリンクを設定します。

6. 「変更の適用」をクリックします。

開発者としての保存されたレポートの管理

各対話モード・レポートには、複数のデフォルト・レポートを含めることができます。「プライマリ・デフォルト」と分類されたレポートは最初から表示され、名前を変更することも、削除することもできません。「代替デフォルト」として保存されたレポートは、検索バーの「レポート」リストから選択できます。

エンド・ユーザーは、レポートを保存し、そのレポートをパブリックまたはプライベートとして分類することもできます。パブリック・レポートは、すべてのユーザーが表示できます。プライベート・レポートは、そのレポートを保存したユーザーのみが表示できます。

関連項目:
「対話モード・レポートの保存」

内容は次のとおりです。

- 代替デフォルト対話モード・レポートの編集または名前変更

- 保存済のレポートの表示または削除

代替デフォルト対話モード・レポートの編集または名前変更

代替デフォルト対話モード・レポートの名前を変更するには、次のステップを実行します。

1. レポートを開発者として実行します。

2. 編集するレポートを選択します。

3. 「保存されたレポート」リンクをクリックします。
新しいリージョンが表示されます。

4. 属性を編集します(たとえば、新しい名前を入力したり、デフォルトのレポート・タイプを変更します)。

5. 「適用」をクリックします。

関連項目:
「デフォルトの対話モード・レポートの保存」

保存済のレポートの表示または削除

保存済のレポートのリストを表示するには、次のステップを実行します。

1. 対話モード・レポートの属性ページにアクセスします。詳細は、「対話モード・レポートの属性ページへのアクセス」を参照してください。
対話モード・レポートの属性ページが表示されます。

2. 「保存されたレポート」タブをクリックします。
レポートには、保存済のすべてのレポートがレポート・タイプ、レポート名、所有者およびレポート別名別に表示されます。

ir_saved_reports.gifの説明

3. レポートを削除するには、レポートを選択し、「チェックした項目の削除」をクリックします。

保存済のレポートのアクティビティの表示

開発者は、レポート属性の編集ページの「タスク」の下にある「保存されたレポート・アクティビティの表示」リンクをクリックして、保存済のレポートのアクティビティを表示できます。このリンクは、保存済のレポート(プライマリ・デフォルト・レポート以外)が存在する場合にのみ表示されます。このページを使用して、どのレポートが使用されていて、どのレポートが使用されていないかを判別できます。

保存済のレポートのアクティビティを表示するには、次のステップを実行します。

1. 対話モード・レポートの属性ページにアクセスします。詳細は、「対話モード・レポートの属性ページへのアクセス」を参照してください。
対話モード・レポートの属性ページが表示されます。

2. 「タスク」リストで、「保存されたレポート・アクティビティの表示」をクリックします。

ヒント:
保存済のレポートのアクティビティは、ワークスペース管理ページから表示することもできます。ワークスペースのホームページで、「管理」、「アクティビティの監視」の順にクリックします。「ページ・ビュー」で、「対話モード・レポート別」をクリックします。

クラシック・レポートの編集

開発者は、レポート属性ページを使用して、クラシック・レポートのレポート・レイアウト、ページ区切り、列ソート、エラー・メッセージ、エクスポート・リンクおよび列ブレークを制御できます。

ヒント:
Oracle Application Expressリリース3.1に対話モード・レポートが追加されたため、以前のレポート・タイプはすべてクラッシック・レポートとして扱われます。「開発者としての対話モード・レポートの編集」を参照してください。

内容は次のとおりです。

- クラッシック・レポートの属性へのアクセス

- 列属性を使用したクラシック・レポートのレイアウト変更

- クラシック・レポートのページ区切りの制御

- クラシック・レポートでの列ソートの有効化

- クラシック・レポートへのダウンロード・リンクの追加

- クラシック・レポートのCSV出力オプションの有効化

- XMLファイルまたはCSVファイルとしてのクラシック・レポートのエクスポート

- クラシック・レポートでの列リンクの作成

- クラシック・レポートでの更新可能な列の定義

- クラシック・レポートでのLOVとしての列定義

- クラシック・レポートの列の表示条件の制御

- クラシック・レポートでの列ブレークの制御

- クラシック・レポートの列の順序とリージョン・ソースの同期化

クラッシック・レポートの属性へのアクセス

「レポート属性」ページを表示するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. ページを選択します。
「ページ定義」が表示されます。

4. レポート属性ページを表示するには、次のステップを実行します。

- ツリー・ビュー: リージョン名を右クリックし、「レポート属性の編集」を選択します。
rprt_edit_tree.gifの説明

- コンポーネント・ビュー: 編集するレポート・リージョンの横にある「レポート」リンクをクリックします。
図rprt_edit.gifの説明

レポート属性ページが表示されます。このページは次のセクションに分かれています。

- 「列属性」はレポート・レイアウトを制御します。「列属性を使用したクラシック・レポートのレイアウト変更」を参照してください。

- 「レイアウトおよびページ区切り」属性はレポート・ページ区切りを制御します。「クラシック・レポートのページ区切りの制御」を参照してください。

- 「ソート」属性を使用すると、値をソートするためレポート見出しに表示するイメージの、イメージおよびイメージ属性を定義できます。「クラシック・レポートでの列ソートの有効化」を参照してください。

- 「メッセージ」の属性を使用すると、データが見つからない場合、または表示できる以上のデータが見つかった場合に表示されるメッセージを定義できます。

- 「レポートのエクスポート」属性を使用すると、レポートにダウンロード・リンクを追加するか、レポートをXMLファイルまたはCSVファイルとしてエクスポートできます。詳細は、「クラシック・レポートへのダウンロード・リンクの追加」および「XMLファイルまたはCSVファイルとしてのクラシック・レポートのエクスポート」を参照してください。

- 「ブレーク書式」属性を使用すると、出力時に特定の列を繰り返すかどうか、および列をどのようにブレークするかを制御できます。「クラシック・レポートでの列ブレークの制御」を参照してください。

- 「外部プロセス」属性を使用すると、後処理用のURLおよびリンク・ラベルを指定できます。

5. 特定の属性の詳細を表示するには、アイテム・ラベルをクリックします。
ヘルプが使用可能な場合は、アイテムにカーソルをあわせると、カーソルが疑問符付きの矢印に変わります。「フィールドレベル・ヘルプについて」を参照してください。

6. 変更を保存するには、「変更の適用」をクリックします。

関連項目:
「クラシック・レポートでの列リンクの作成」、「クラシック・レポートでの更新可能な列の定義」、「クラシック・レポートでのLOVとしての列定義」および「クラシック・レポートの列の表示条件の制御」

ナビゲーションの選択肢について

レポート属性ページは、「列属性」、「レイアウトおよびページ区切り」、「ソート」、「メッセージ」、「レポートのエクスポート」、「ブレーク書式」および「外部プロセス」の各セクションに分かれています。

これらのセクションにアクセスするには、ページをスクロールするか、ページ上部のナビゲーション・ボタンをクリックします。

classic_rprt_nav.gifの説明

ページ上部のボタンを選択すると、選択されたセクションが表示され、その他のセクションはすべて一時的に非表示になります。ページのすべてのセクションを表示するには、「すべて表示」をクリックします。

列属性を使用したクラッシック・レポートのレイアウトの変更

レポート属性ページの「列属性」セクションを使用すると、レポート・レイアウトを詳細に制御できます。たとえば、これらの属性を使用して、列ヘッダー・テキストの変更、列の位置の変更、列の非表示化、列の合計の作成、またはソート順序の選択を行うことができます。

「列属性」にアクセスするには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. ページを選択します。
「ページ定義」が表示されます。

4. クラシック・レポートの属性のページにアクセスします。「クラシック・レポートの属性へのアクセス」を参照してください。
ページ上部に「列属性」セクションがあるレポート属性ページが表示されます。

図rpt_att.gifの説明

「列属性」セクションを使用して、レポート列の外観と機能を制御します。

「ヘッダー・タイプ」はレポートの見出しの生成方法を指定します。「リンク」列は列リンクが現在定義されているかどうかを示します。「編集」列は列が現在更新可能かどうかを示します。

表 9-5に、レポート列の基本的な編集操作を示します。

表 9-5 クラシック・レポートのレポート列の基本的な編集操作

説明

開発者の操作

列の表示順序を変更します。

上矢印および下矢印をクリックして、列の表示順序を変更します。

ヘッダーの位置合せを変更します。

「列の位置合せ」で、列の位置を選択します。

列ヘッダーのテキストを変更します。

「ヘッダー」で、異なるヘッダー・テキストを入力します。

表示する列を制御します。

「表示」をクリックして、列を表示させるようにします。

一意のソート順序を有効にします。

「ソート」をクリックし、「ソート順序」から順序番号を選択します。

任意の数の列をソート可能にできます。ただし、1つ以上の列にソート順序が定義されている必要があります。

列の合計を有効にします。

「合計」をクリックして、列の合計を有効にします。

列属性ページで、特定の列の属性をさらに詳細に指定できます。

5. 列属性ページにアクセスするには、該当する列の別名の横にある「編集」アイコンをクリックします。
特定の属性の詳細を表示するには、アイテム・ラベルをクリックします。

ヘルプが使用可能な場合は、アイテムにカーソルをあわせると、カーソルが疑問符付きの矢印に変わります。「フィールドレベル・ヘルプについて」を参照してください。

関連項目:
「クラシック・レポートでの列リンクの作成」、「クラシック・レポートでの更新可能な列の定義」、「クラシック・レポートでのLOVとしての列定義」および「クラシック・レポートの列の表示条件の制御」

クラシック・レポートのページ区切りの制御

レポート・ページ区切りを制御する方法を次に示します。

- ページ区切り置換文字列をレポート・テンプレートに含める方法

- レポート属性ページの「レイアウトおよびページ区切り」セクションから選択する方法

「レポート属性」ページの「レイアウトおよびページ区切り」属性から選択することによって、ページ区切りの表示方法を制御します。

内容は次のとおりです。

- 「レイアウトおよびページ区切り」属性のアクセスと理解

- クラシック・レポート内での行の後へのページ区切りの挿入

- クラシック・レポート内での行の前へのページ区切りの挿入

「レイアウトおよびページ区切り」属性のアクセスと理解

レポート属性ページの「レイアウトおよびページ区切り」セクションにアクセスするには、次のステップを実行します。

1. レポートを作成します。「ウィザードを使用したレポートの作成」を参照してください。

2. 該当する「ページ定義」にナビゲートします。「「ページ定義」へのアクセス」を参照してください。

3. クラシック・レポートの属性のページにアクセスします。「クラシック・レポートの属性へのアクセス」を参照してください。
「レポート属性」ページが表示されます。

4. 「レイアウトおよびページ区切り」までスクロールします。
「レイアウトおよびページ区切り」属性を使用して、ページ区切りスタイルの選択、ページ区切りの発生位置の決定、ページごとに表示される行数の指定を行います。表9-6に、最も一般的に使用される「レイアウトおよびページ区切り」属性を示します。

特定の属性の詳細を表示するには、アイテム・ラベルをクリックします。ヘルプが使用可能な場合は、アイテムにカーソルをあわせると、カーソルが疑問符付きの矢印に変わります。「フィールドレベル・ヘルプについて」を参照してください。

表9-6 「レイアウトおよびページ区切り」属性

属性

説明

レポート・テンプレート

このレポートに適用するテンプレートを指定します。レポート・テンプレートによって、SQL問合せによって戻される1行の結果が制御されます。多数のデフォルトのテンプレートから選択するか、またはカスタム作成のテンプレートを選択できます。

レポート属性の置換

#REPORT_ATTRIBUTES#置換文字列を置換する値を入力します。#REPORT_ATTRIBUTES#置換文字列は、レポート・テンプレートの「行の前」属性でのみ置換されます。

NULL値を置き換えて表示

NULL列に表示するテキストを入力します。デフォルト値は(null)です。

ページ区切りスキーム

このレポートにページ区切りスキームを指定します。

ページ区切りによって、結果セット内の行数および現在の位置に関する情報が提供されます。また、次のページまたは前のページへのナビゲートに使用するリンクまたはボタンのスタイルも定義されます。

詳細は、この属性のヘルプ情報を参照してください。

部分ページ・リフレッシュの有効化

この属性が有効な場合は、結果セットでページ区切りが前後に移動したときに、レポート・リージョンがリフレッシュされます。

表示位置

ページ区切りの表示位置を定義します。

レポートの上にページ区切りを表示する場合は、選択したレポート・テンプレートで、このタイプの表示がサポートされている必要があります。

行数

ページごとに表示する最大行数を定義します。

行数(アイテム)

SQL問合せに対して、ページごとにデフォルトで表示する行数を定義します(アイテムから動的に取得されます)。この属性でアイテムを識別します。

行カウント最大値

問合せを行う最大行数を定義します(例: 456行中の行1 - 10)。

この属性を200に設定すると、結果は次のように表示されます。

rows 1 - 10 of more than 200 rows

この属性はパフォーマンスに影響します。より少ない行数をカウントするとパフォーマンスは向上し、数千という行数をカウントするとパフォーマンスは低下します。

HTMLを削除

HTML式、列リンク、およびCSVファイルとしてエクスポートされたレポート・データに対して、元の列値からHTMLタグを削除するかどうか指定します。

HTMLタグが含まれているデータベースから値を選択すると、それらのタグが列リンクまたはHTML式用に生成されたHTMLと競合する可能性があります。このオプションを有効にすると、列値の実際のデータ部分のみが使用されます。

NULLのソート

ソートされた列ヘッダーを含むレポートの場合、最初または最後にソートするNULL値の列が必要かどうかを指定してください。

関連項目: 「クラシック・レポートでの列ソートの有効化」

クラッシック・レポート内での行の後へのページ区切りの挿入

レポート内の行の後にページ区切りを挿入するには、次のステップを実行します。

1. レポートを作成します。「ウィザードを使用したレポートの作成」を参照してください。
次に、適切な「レイアウトおよびページ区切り」属性を選択します。

2. クラシック・レポートの属性のページにアクセスします。「クラシック・レポートの属性へのアクセス」を参照してください。
「レポート属性」ページが表示されます。

3. 「レイアウトおよびページ区切り」で、次の項目を選択します。

1. レポート・テンプレート: レポート・テンプレートを選択します(オプション)。

2. ページ区切りスキーム: ページ区切りスキームを選択します。

3. 表示位置: 表示位置を選択します。

4. 行数: ページごとに表示する行数を指定します。

5. 「変更の適用」をクリックします。

4. レポート・テンプレートを編集します。

1. 「ページ定義」にナビゲートします。「「ページ定義」へのアクセス」を参照してください。

2. 「テンプレート」で、レポート・テンプレート名を選択します。

3. 「行の後」属性に#PAGINATION#置換文字列を含めます。

4. 「変更の適用」をクリックします。

5. ページを実行します。

クラッシック・レポート内での行の前へのページ区切りの挿入

レポート内の行の前にページ区切りを挿入するには、次のステップを実行します。

1. レポートを作成します。「ウィザードを使用したレポートの作成」を参照してください。
次に、適切な「レイアウトおよびページ区切り」属性を選択します。

2. クラシック・レポートの属性のページにアクセスします。「クラシック・レポートの属性へのアクセス」を参照してください。
「レポート属性」ページが表示されます。

3. 「レイアウトおよびページ区切り」で、次のステップを実行します。

1. レポート・テンプレート: レポート・テンプレートを選択します(オプション)。

2. ページ区切りスキーム: ページ区切りスキームを選択します。

3. 表示位置: topという語が使用されている位置を選択します。

4. 行数: ページごとに表示する行数を指定します。

5. 「変更の適用」をクリックします。

4. レポート・テンプレートを編集します。

1. 「ページ定義」にナビゲートします。「「ページ定義」へのアクセス」を参照してください。

2. 「テンプレート」で、レポート・テンプレート名を選択します。

3. 「行の前」属性に#TOP_PAGINATION#置換文字列を含めます。

4. 「変更の適用」をクリックします。

5. ページを実行します。

クラシック・レポートでの列ソートの有効化

レポート属性ページで列ソートを有効にできます。

列ソートを有効にするには、次のステップを実行します。

1. クラシック・レポートの属性のページにアクセスします。「クラシック・レポートの属性へのアクセス」を参照してください。
レポート属性ページが表示されます。

2. 「列属性」で、ソートする列の横にある「ソート」チェック・ボックスを選択します。

3. 「ソート順序」から、順序番号を選択します。
「ソート順序」はオプションです。ただし、ソート可能な列が1列以上ある場合は、定義済のソート順序が1列以上で必要です。

4. 「ソート」までスクロールします。

5. 昇順イメージ属性および降順イメージ属性を指定するか、または「デフォルトの設定」をクリックします。

6. 「変更の適用」をクリックします。

ヒント:
レポートの最初または最後にNULL値を含む列を表示する場合は、列ソートを有効にする必要があります。「NULLのソート」属性の詳細は、「「レイアウトおよびページ区切り」属性のアクセスと理解」を参照してください。

クラシック・レポートへのダウンロード・リンクの追加

レポート内にリンクを作成して、ユーザーがレポートをカンマ区切りファイル(.csv)としてエクスポートできるようにします。CSVリンクをレポートに追加するには、CSV出力オプションを有効にする必要があります。CSV出力オプションを使用する際、レポート・テンプレートは重要ではありません。CSVリンクは、CSVエクスポート置換文字列が定義されていればどのレポート・テンプレートに追加することもできます。

関連項目:
「自動CSVエンコーディング」

クラッシック・レポートでのCSV出力オプションの有効化

CSV出力の有効化オプションを使用するには、次のステップを実行します。

1. クラシック・レポートの属性のページにアクセスします。「クラシック・レポートの属性へのアクセス」を参照してください。
レポート属性ページが表示されます。

2. 「レポートのエクスポート」までスクロールします。

3. 「CSV出力の有効化」から、「はい」を選択します。

4. (オプション)「セパレータ」および「囲み文字」フィールドで、セパレータおよびデリミタを定義します。
デフォルトの囲み文字は、二重引用符(" ")です。デフォルトのデリミタは、カンマまたはセミコロンで、現在のNLS設定によって異なります。

5. 「リンク・ラベル」に、リンク・テキストを入力します。このテキストはレポートに表示され、ユーザーはこのテキストを使用してダウンロードを起動できます。

6. (オプション)デフォルトのエクスポート・ファイル名を指定するには、「ファイル名」フィールドに名前を入力します。
デフォルトでは、Application Expressエンジンによって、リージョン名が取得され、該当するファイル名の拡張子(.csvまたは.xml)が追加されて、エクスポート・ファイル名が作成されます。

7. 「変更の適用」をクリックします。

XMLファイルまたはCSVファイルとしてのクラッシック・レポートのエクスポート

レポート・テンプレートを選択して、レポートをXMLファイルとしてエクスポートできます。

レポートをファイルとしてエクスポートするには、次のステップを実行します。

1. クラシック・レポートの属性のページにアクセスします。「クラシック・レポートの属性へのアクセス」を参照してください。
レポート属性ページが表示されます。

2. 「レイアウトおよびページ区切り」までスクロールします。

3. 「レポート・テンプレート」リストから、「エクスポート: XML」または「エクスポート: CSV」を選択します。
「エクスポート: XML」を選択すると、Application Expressエンジンでページがレンダリングされなくなり、コンテンツがXMLファイルにダンプされます。

4. 「変更の適用」をクリックします。

クラシック・レポートでの列リンクの作成

レポートからアプリケーション内の別のページまたはURLへのリンクを作成するには、「列リンク」属性を使用します。

別のページへの列リンクを作成するには、次のステップを実行します。

1. クラシック・レポートの属性のページにアクセスします。「クラシック・レポートの属性へのアクセス」を参照してください。
レポート属性ページが表示されます。

2. 「列属性」で、リンクを含む列を指定します。

3. 列名の横にある「編集」アイコンをクリックします。
「列属性」ページが表示されます。

4. 「列リンク」までスクロールします。

5. 別のページへの列リンクを作成するには、次のステップを実行します。

1. 「ターゲット」で、「このアプリケーションのページ」を選択します。

2. (オプション)「リンク属性」で、<a href= >タグに含める追加の列リンク属性(リンク・ターゲット、クラス、スタイルなど)を指定します。

3. 「リンク・テキスト」で、リンクとして表示されるテキストを入力するか、イメージ・タグを指定するか、またはデフォルトのイメージのリストから選択します。

4. 「ページ」で、ターゲット・ページ番号を指定します。このページのページ区切りをリセットするには、「ページ区切りのリセット」を選択します。

5. 「リクエスト」で、使用するリクエストを指定します。

6. 「キャッシュのクリア」で、キャッシュをクリアするページ(ページ番号)を指定します。ページ番号をカンマで区切ってリストすることによって、複数のページを指定できます。「対話モード・レポートへのリンクの設定」を参照してください。

7. 特定のアイテムのセッション・ステートを指定するには、「名前」フィールドおよび「値」フィールドを使用します。

6. 「変更の適用」をクリックします。

URLへの列リンクを作成するには、次のステップを実行します。

1. クラシック・レポートの属性のページにアクセスします。「クラシック・レポートの属性へのアクセス」を参照してください。
レポート属性ページが表示されます。

2. 該当する列の横にある「編集」アイコンをクリックして、列属性ページにアクセスします。
「列属性」ページが表示されます。

3. 「列リンク」までスクロールします。

4. 「列リンク」で、次を指定します。

1. 「ターゲット」から「URL」を選択します。

2. 「リンク・テキスト」で、リンクとして表示されるテキストを入力し、置換文字列を選択します。

3. (オプション)「リンク属性」で、<a href= >タグに含める追加の列リンク属性(リンク・ターゲット、クラス、スタイルなど)を指定します。

4. 「URL」で、該当するアドレスを入力します。

5. 「変更の適用」をクリックします。

クラシック・レポートでの更新可能な列の定義

列属性ページの「表形式フォームの要素」属性を編集することで更新可能な列を作成できます。Application Expressエンジンは、次の場合にのみ更新を実行できることに注意してください。

- 複数行の更新が定義されている場合

- 更新済データを処理するためにPL/SQLプロセスが実装されている場合

- 組込み表形式フォームの要素および表示タイプを使用している場合、レポートは、SQL問合せ(更新可能レポート)のタイプを使用して定義する必要があります。

更新可能な列属性を定義するには、次のステップを実行します。

1. クラシック・レポートの属性のページにアクセスします。「クラシック・レポートの属性へのアクセス」を参照してください。
レポート属性ページが表示されます。

2. 該当する列の横にある「編集」アイコンをクリックして、列属性ページにアクセスします。
「列属性」ページが表示されます。

3. 「列属性」で、次のように指定します。

1. 表示形式: 更新可能な列の型を選択します。
列を更新可能にするには、このオプションを使用します。更新は、複数行の更新が定義されている場合、または更新済データを処理するためにPL/SQLプロセスが実装されている場合にのみ実行できます。

2. 数値/日付書式: 「日付ピッカー」の「表示形式」タイプを選択している場合は選択を行います。

3. 要素の幅: フォーム・アイテムの幅を指定します。

4. 行数: テキスト領域に適応するフォーム・アイテムの高さを指定します。

5. 要素属性: スタイルまたは標準のフォーム要素属性を定義します。

6. 要素オプションの属性: ラジオ・グループまたはチェック・ボックス内のアイテムのフォーム要素属性を指定します。

4. 「表形式フォームの属性」で、次のように指定します。

1. デフォルト・タイプ: デフォルトのタイプを指定します。

2. デフォルト: デフォルトのソースを指定します。

3. 参照表の所有者: 参照される表の所有者を指定します。この属性は、アプリケーション間の列の参照を「ユーザー・インタフェースのデフォルト値」と比較するときに使用します。この参照は、ウィザードによる初期化後、可能であれば手動で維持します。

4. 参照表名: 対象の列が参照する表またはビューを指定します。この属性は、アプリケーション間の列の参照を「ユーザー・インタフェースのデフォルト値」と比較するときに使用します。この参照は、ウィザードによる初期化後、可能であれば手動で維持します。

5. 参照列名: 対象のレポート列が参照する列名を指定します。この属性は、アプリケーション間の列の参照を「ユーザー・インタフェースのデフォルト値」と比較するときに使用します。この参照は、ウィザードによる初期化後、可能であれば手動で維持します。

5. 「変更の適用」をクリックします。

クラシック・レポートでのLOVとしての列定義

列は、ラジオ・グループとしてレンダリングするか、静的LOV、名前付きLOVまたは問合せベースのLOVとしてレンダリングできます。たとえば、選択リストまたはポップアップLOVを使用して列をレンダリングできます。または、LOVに基づく読取り専用テキストとして列をレンダリングすることもできます。

この最後の方法は、表示参照値を作成する場合に効果的な手法であり、特に、更新できない通常のレポートで役立ちます。この方法を使用すると、SQL JOIN文を記述することなく、列の値を表示できます。

LOVとしてレポート列をレンダリングするには、次のステップを実行します。

1. クラシック・レポートの属性のページにアクセスします。「クラシック・レポートの属性へのアクセス」を参照してください。
レポート属性ページが表示されます。

2. 該当する列の横にある「編集」アイコンをクリックして、列属性ページにアクセスします。
列属性ページが表示されます。次に、列のレンダリング方法(ラジオ・グループ、LOV、選択リストなど)を指定します。

3. 「列属性」で、「表示形式」リストから選択します。

4. 「LOV」までスクロールします。

5. 「名前付きLOV」で、LOVリポジトリから選択します。

6. LOVにNULL値を含めるには、次のステップを実行します。

1. NULLの表示: 「はい」を選択します。

2. NULL表示値: ここにNULLオプションの表示値を入力します。

3. NULL戻り値: 対象のアイテムのLOVに使用するNULL値を入力します。値を指定しなかった場合のデフォルトは%null%です。

また、列には、LOVで表示されない値を格納することもできます。

7. LOVで表示されない値を定義するには、次のステップを実行します。

1. 「追加値の表示」で、「はい」を選択します。
追加値は、実際の列値がLOVの一部ではない場合に使用されます。このような場合は、実際の値が表示されます。追加値を表示しない場合は、誤った値になる可能性があり、データが不適切に自動更新されます。

2. 「NULL値」で、表示する値を指定します。

3. 名前付きLOVを選択していない場合は、「LOV問合せ」フィールドに選択リストを表示するための問合せを入力します。

8. 名前付きLOVを選択していない場合、LOV定義に選択リストを表示するために使用する問合せを入力します。

9. 「変更の適用」をクリックします。

クラシック・レポートの列の表示条件の制御

「認可」属性および「条件」属性を使用すると、列の表示条件を制御できます。

認可を使用すると、事前定義されたユーザー権限に基づいて(レポート列などの)リソースへのアクセスを制御できます。たとえば、マネージャのみが特定のレポート列を表示できる認可スキームを作成できます。認可スキームを選択するには、まずその認可スキームを作成する必要があります。

条件とは、事前定義された条件タイプに基づいた列の表示の制御を可能にする論理単位です。条件は、「式」フィールドに入力した値に基づいて、trueまたはfalseと評価されます。

認可属性および条件属性を指定するには、次のステップを実行します。

1. クラシック・レポートの属性のページにアクセスします。「クラシック・レポートの属性へのアクセス」を参照してください。
レポート属性ページが表示されます。

2. 該当する列の横にある「編集」アイコンをクリックして、列属性ページにアクセスします。
「列属性」ページが表示されます。

3. 「認可」で、「認可スキーム」リストから選択します。

4. 「条件」で、「条件タイプ」リストから選択し、その選択に応じて、該当する「式」フィールドに式または値を入力します。
認可が正常に終了し、条件タイプの表示がtrueに評価されると、列が表示されます。

関連項目:
「認可を介したセキュリティの提供」、「条件付きのレンダリングおよびプロセスの理解」および付録C「使用可能な条件」

クラシック・レポートでの列ブレークの制御

ブレーク書式属性を使用すると、出力する場合に、特定の列を繰り返すかどうか、および列のブレーク方法を制御できます。たとえば、レポートに、部門番号ごとに従業員情報を表示するとします。複数の従業員が同じ部門に所属している場合、部門番号が1回のみ表示されるように指定することによって、読みやすさを向上できます。

このタイプの列ブレークを作成するには、次のステップを実行します。

1. クラシック・レポートの属性のページにアクセスします。「クラシック・レポートの属性へのアクセス」を参照してください。
レポート属性ページが表示されます。

2. 「ブレーク書式」までスクロールします。

3. 「ブレーク」リストから選択します。

クラシック・レポートの列の順序とリージョン・ソースの同期化

クラシック・レポートの列の順序を、リージョン・ソースの問合せで定義された列の順序と同期化するには、次のステップを実行します。

1. クラシック・レポートの属性のページにアクセスします。「クラシック・レポートの属性へのアクセス」を参照してください。
レポート属性ページが表示されます。

2. 「タスク」から、「列の順序とリージョン・ソースの同期化」を選択します。

3. 「同期化」をクリックします。

レポート・リージョンの出力

いくつかの異なる形式にエクスポートすることによって、出力するクラシック・レポート・リージョンを構成できます。Oracle BI Publisherでは、Adobe Portable Document Format(PDF)、Microsoft Wordリッチ・テキスト形式(RTF)、Microsoft Excel形式(XLS)またはExtensible Markup Language(XML)がサポートされます。指定されたApache FOP代替付きOC4Jでは、PDFおよびXMLのみがサポートされます。他のサード・パーティ・レンダリング・エンジンの使用を選択すると、他の出力形式も構成されます。

リージョン・レポート出力を利用すると、アプリケーション・ユーザーは、印刷の方向、ページ・サイズ、列ヘッダーおよびページのヘッダーとフッターが事前定義されたレポートを表示および出力できます。対話モード・レポートでも、PDF、RTF、Microsoft ExcelおよびCSVへのエクスポートが可能です。対話モード・レポートの場合、カスタム・レポート・レイアウトは定義できないことに注意してください。

内容は次のとおりです。

- PDFへのレポート出力について

- レポート出力の構成オプションについて

- クラシック・レポートの出力メソッドについて

- レポート問合せについて

- レポート・レイアウトについて

- クラシック・レポート・リージョンの出力属性の構成

- 対話モード・レポート・リージョンの出力属性の構成

ヒント:
Oracle Application ExpressをOracle Database 11gリリース1 (11.1)以上で実行している場合は、レポート出力を使用するためにネットワーク・サービスを有効にする必要があります。「Oracle Database 11gおよびOracle Database 12cのネットワーク・サービスの有効化」を参照してください。

PDFへのレポート出力について

レポートをPDFに出力するには、インスタンス・レベルで定義されているレポート・サーバーを使用してデータを変換する必要があります。エンド・ユーザー側では、単に出力リンクをクリックするだけでこれを実行できます。ただし、開発者側では、PDF出力をサポートするリージョンを宣言的に作成する必要があります。

レポート出力の構成オプションについて

Oracle Application Expressには、3つのレポート出力の構成オプションが用意されています。

- Oracle Application Expressリスナー: Oracle Application Expressリスナー2.0以上を使用している場合は、このオプションを選択します。このオプションでは、Application Express付属のデフォルト・テンプレートや独自のカスタムXSL-FOテンプレートを使用したレポート問合せの作成およびレポート・リージョンの出力など、基本的な出力機能を使用できます。

注意:
Oracle Application Expressリスナー・オプションには、外部プリント・サーバーは必要ありませんが、そのかわりに、レポート・データおよびスタイルシートがリスナーにダウンロードされ、リスナーでPDF形式にレンダリングされた後、クライアントに送信されます。この設定のPDFドキュメントはデータベースに返されないため、Oracle Application Expressリスナー・ベースの構成を使用している場合、プリントAPIはサポートされません。

- 外部(Apache FOP): 外部J2EEサーバーでApache FOPを使用している場合は、このオプションを選択します。このオプションによって、Application Expressで提供されるデフォルトのテンプレートおよびカスタマイズしたXSL-FOテンプレートを使用して、レポート問合せの作成およびレポート・リージョンの出力を含む基本的な出力機能が使用できるようになります。

- Oracle BI Publisher: このオプションでは、Oracle BI Publisher (Oracle XML Publisherとも呼ばれる)の使用許諾が必要です。このオプションを使用すると、レポート問合せ結果を取得し、Oracle BI Publisherを使用してそれらの結果をXML形式からRTF形式に変換できます。Application Express内でレポート出力用に独自のカスタムRTFまたはXSL-FOテンプレートをアップロードする場合は、このオプションを選択します。

関連項目:
Oracle BI Publisherのインストールおよび構成の詳細は、「PDF Printing in Application Express」を参照してください。次のWebサイトにアクセスしてください。

http://www.oracle.com/technetwork/developer-tools/apex/application-express/configure-printing-093060.html

レポート出力のすべての機能を使用するには、Oracle Application Expressのサービス管理者によってこの機能がインスタンスに対して有効に設定されている必要があります。詳細は、『Oracle Application Express管理ガイド』の「レポート出力の構成」を参照してください。

クラシック・レポートの出力メソッドについて

クラシック・レポートのリージョンは、次の2つの方法で出力できます。

- レポート・リージョンの出力属性の構成。リージョンに対して出力属性を構成することによって、レポート・リージョンを出力できます。「クラシック・レポート・リージョンの出力属性の構成」を参照してください。

- レポート問合せの作成。レポート問合せを共有コンポーネントとして定義することで、レポートを出力できます。「レポート問合せについて」を参照してください。

レポート・リージョンおよびレポート問合せは、次の形式でダウンロードできます。

- PDF: Adobe Portable Document Format。

- RTF: Microsoft Word Rich Text Format。

- XLS: Microsoft Excel形式。ただし、コンテンツはHTMLベースであるため、本当の.xlsファイルではありません。

- HTML

- XML: Extensible Markup Language。

レポート・リージョンまたはレポート問合せを書式設定するには、レポート・レイアウトと関連付けます。詳細は、「レポート・レイアウトについて」を参照してください。

ヒント:
アイテムで出力結果を指定することもできます(このようなアイテムは実行時に出力形式を決定します)。形式の値を保持するアイテムを選択します。有効な値は、「PDF」、「RTF」(ドキュメントをMicrosoft Wordで開く)、「XLS」(ドキュメントをMicrosoft Excelで開く)および「HTM」(ドキュメントをHTMLファイルとしてダウンロードする)です。

レポート問合せについて

レポート・リージョンは、レポート問合せを共有コンポーネントとして定義することによって出力できます。レポート問合せは、抽出されるデータを識別します。リージョンに含まれるSQL文とは異なり、レポート問合せには、問合せを保存すると有効化されるSQL文が含まれます。レポート問合せは、SQL文を戻すファンクションではなく、SQL文である必要があります。

レポート問合せは、レポート・レイアウトに関連付けて、書式化されたドキュメントとしてダウンロードできます。レポート・レイアウトが選択されていない場合は、汎用のレイアウトが使用されます。汎用レイアウトは、レポート問合せのテストと検証の目的で使用します。汎用レイアウト・オプションを使用する場合にソース問合せが複数定義されていると、最初の結果セットのみが出力ドキュメントに含まれます。レポートには、現行のアプリケーションのセッション・ステートを含めることができます。

これらのレポートをアプリケーションと統合することにより、エンド・ユーザーから使用できるようにします。たとえば、ボタン、リスト・アイテム、ブランチ、またはターゲットとしてURLを使用できるその他のナビゲーション・コンポーネントをレポート問合せに関連付けることができます。そのアイテムを選択すると、出力プロセスが開始します。

内容は次のとおりです。

- レポート問合せの作成

- レポート問合せの編集

- レポート問合せのコピー

レポート問合せの作成

「レポート問合せ」オプションの可用性は、サービス管理者がインスタンスに対してどのようなレポート出力設定を行ったかによって異なります。次のステップに示すすべてのオプションが使用可能であるとはかぎりません。

関連項目:
「レポート出力の構成オプションについて」

レポート問合せを作成するには、次のステップを実行します。

1. 共有コンポーネント・ページにナビゲートします。「共有コンポーネント・ページへのアクセス」を参照してください。

2. レポートの下の「レポート問合せ」をクリックします。

3. 「作成」をクリックします。

4. 問合せを実行するには、次の情報を指定します。

1. レポート問合せ名: レポート問合せを識別する名前を入力します。リンク・ターゲットとしてレポート問合せを参照する際に、レポート問合せ名はリクエスト文字列の一部になります。

2. 出力形式: レポート出力形式を選択します。有効なオプションは次のとおりです。

- PDF: Adobe Portable Document Format。

- Word: Microsoft Word Rich Text Format。

- Excel: Microsoft Excel形式。ただし、コンテンツはHTMLベースであるため、本当の.xlsファイルではありません。

- HTML

- XML: Extensible Markup Language。

3. アイテム: 形式の値を保持するアイテムを選択します。このアイテムを使用して、実行時に出力形式を決定できます。

4. ファイルの表示形式: レポート問合せドキュメントをWebブラウザでどのように開くかを選択します。オプションは次のとおりです。

- 添付ファイル: ユーザーがレポート問合せのダウンロード・ボタンをクリックすると、ファイルを開くか、または保存するかを尋ねるダイアログ・ボックスが表示されます。

- インライン: レポート問合せドキュメントをブラウザのウィンドウ内に表示します。

5. セッション・ステート: セッション・ステートの値(レポートのXML構造のページ・アイテムの値など)を参照するには、このチェック・ボックスを選択します。

6. 「次へ」をクリックします。

5. 「SQL問合せ」にSQL文を直接入力するか、「クエリー・ビルダー」をクリックして、クリックやポイントによってSQL文を作成します。
SQL文でアプリケーションおよびページ・アイテムを参照する場合は、バインド変数として参照します。「バインド変数の設定」をクリックすると、各バインド変数について値を入力し、問合せをテストして、目的の出力が戻されることを確認できます。

6. 「定義のダウンロード」で、次の項目を指定します。

1. レポート・レイアウトのデータ・ソース: このオプションは、レポート定義のエクスポート・ファイルをダウンロードするために使用します。「XMLデータ」または「XML Schema」を選択してから、「ダウンロード」をクリックします。
「XML Schema」を選択すると、XSDファイル(XML構造のXMLスキーマ定義)が作成されます。

2. 問合せの追加: このボタンをクリックすると、レポート問合せに別の問合せを追加できます。別の問合せを追加することにより、複数の出力コンポーネント(2つの異なる問合せをベースにしたチャートおよびレポートなど)を含む複雑なレポートの生成が可能になります。

3. レポート問合せの作成: このボタンをクリックすると、ウィザードが早期に終了します。「レポート・レイアウトのソース」には、デフォルトで汎用レポート・レイアウトが使用されます。

4. 「次へ」をクリックします。

7. 「レポート・レイアウトのアップロード」で、次の項目を指定します。

1. レポート・レイアウトのソース: レポート・レイアウトの導出方法を指定します。レポート・ベースのファイル・レイアウトを選択した場合、レイアウト名とレポート・レイアウト・ファイルを指定する必要があります。

2. レイアウト名: レイアウト名を入力します(オプション)。デフォルトは、レポート問合せの名前です。

3. レポート・レイアウト・ファイル: 「参照」をクリックし、Rich Text Format(RTF)を選択します。

4. 「次へ」をクリックします。

8. 「確認」で、次の手順を実行します。

1. 問合せ名: 問合せを識別します。

2. レポート・レイアウト: 選択したレポート・レイアウトを識別します。

3. 出力形式: このレポート問合せの形式を識別します。

4. アイテムから派生: 形式情報を保持するアイテムを識別します。

5. URL: このレポートをアプリケーションに統合するには、表示されたURLをボタン、リスト・アイテム、リンクまたは他のナビゲーション・コンポーネントに対するターゲットとして使用します。これにより、たとえば、エンド・ユーザーはボタンをクリックして、出力プロセスを開始できます。

6. テスト・レポート: これをクリックして、レポートのプレビューを表示します。汎用レポート・レイアウトを使用するように指定している場合は、「テスト・レポート」をクリックしても出力は生成されません。

7. 「終了」をクリックします。
レポート問合せは、「共有コンポーネント」に作成および保存されます。

レポート問合せの編集

レポート問合せを編集するには、次のステップを実行します。

1. 共有コンポーネント・ページにナビゲートします。「共有コンポーネント・ページへのアクセス」を参照してください。

2. レポートの下の「レポート問合せ」をクリックします。

3. レポート問合せページで、ページ上部のナビゲーション・バーを使用して名前で問合せを検索したり、またはページの表示を変更できます。たとえば、「ビュー」リストから選択して、デフォルトの表示を変更できます。使用可能なオプションは次のとおりです。

- アイコン: (デフォルト)各問合せを大きいアイコンとして表示します。問合せを編集するには、該当するアイコンをクリックします。

- 詳細: 各問合せをレポートで1行に表示します。問合せを編集するには、名前をクリックします。

4. 目的のレポート問合せを選択します。レポート問合せの編集ページで、情報を編集します。

5. 「変更の適用」をクリックします。

レポート問合せのコピー

レポート問合せをコピーするには、次のステップを実行します。

1. 共有コンポーネント・ページにナビゲートします。「共有コンポーネント・ページへのアクセス」を参照してください。

2. レポートの下の「レポート問合せ」をクリックします。

3. レポート問合せページで、「コピー」をクリックします。

4. 「レポート問合せのコピー」で、コピーする問合せを選択して、レポート問合せの名前を入力し、「コピー」をクリックします。
コピーが問合せリストに表示されます。

レポート・レイアウトについて

クラシック・レポート・リージョンまたはレポート問合せのどちらかをフォーマットするには、レポート・レイアウトと関連付けます。レポート・レイアウトを使用すると、印刷用形式でデータをレンダリングできます。レポート・レイアウトを選択しない場合は、デフォルトのXSL-FOレイアウトが使用されます。対話モード・レポートのリージョンのレンダリングでは、常にデフォルトのXSL-FOレイアウトが使用されます。

レポート・レイアウトを作成して使用すると、次のことができるようになります。

- レポート・リージョンのデフォルト・レイアウト、およびOracle Application Expressで用意されているレポート問合せの汎用レイアウトを利用できます。

- コードをコピーしてカスタマイズすることによって、レポート・リージョンの組込みXSL-FOベースのレイアウトが利用できます。レポート・リージョンに対して、ページ・サイズ、フォント、色などを制御するいくつかの属性を編集できます。

- RTFまたはXSL-FOレポート・レイアウトを作成してレポートのルック・アンド・フィールをカスタマイズできます。RTFレポート・レイアウトを使用するには、Oracle Application Expressのサービス管理者が、そのサイトに対して詳細設定を選択している必要があります。Oracle Application Express管理ガイドの「レポート出力の構成」を参照してください。

内容は次のとおりです。

- レポート・レイアウト・オプションについて

- レポート・レイアウトの作成

- レポート・レイアウトの編集

- レポート・レイアウトのコピー

レポート・レイアウト・オプションについて

レポート・レイアウトは、次のいずれかのオプションに基づいて作成できます。

- 汎用列: 汎用レポート・レイアウトはほとんどの問合せ結果セットに使用できます。このレイアウトを使用すると、出力可能なドキュメントの生成時に、列の数が自動的に調整されます。
多くのレポート・レイアウト属性は、組込みのデフォルトXSL-FOレイアウトを使用して、レポート・リージョンに対して宣言的に定義できます。レポート・レイアウトを追加制御する必要がある場合は、このステップによりカスタマイズ可能な組込みのデフォルトXSL-FOレイアウトのコピーを作成できます。

- 名前付き列: 名前付き列のレポート・レイアウトは、問合せ固有のレポート・レイアウトで、問合せ結果セットに含まれる列の定義済リストで使用できるよう設計されています。このレイアウト・タイプはページ・アイテムおよび問合せ列の位置を正確に制御する必要がある場合に、個別に設計されたレイアウトで使用されます。

「レポート・レイアウト」オプションの可用性は、サイト管理者がサイトでどのようなレポート出力設定を行ったかによって異なります。次のステップに示すすべてのオプションが使用可能であるとはかぎりません。

関連項目:
Oracle Application Express管理ガイドの「レポート出力の構成」

レポート・レイアウトの作成

レポート・レイアウトを作成するには、次のステップを実行します。

1. 共有コンポーネント・ページにナビゲートします。「共有コンポーネント・ページへのアクセス」を参照してください。

2. 「レポート」の下の「レポート・レイアウト」をクリックします。

3. 「作成」をクリックします。
レポート・レイアウトの作成ウィザードが表示されます。

4. 「レポート・レイアウト・タイプ」で、オプションを選択し、「次へ」をクリックします。

- 汎用列(XSL-FO): このレイアウトは、デフォルトのテンプレートに事前移入され、ユーザーのニーズにあわせて編集可能です。

- 名前付き列(RTF): このレイアウトはRTFファイルとしてアップロードされます。

- 名前付き列(XSL-FO): このレイアウトはXSL-FOファイルとしてアップロードされます。

5. 「レイアウト・ソース」で、該当する情報を確認および編集します。このページに表示されるオプションは、選択したレイアウト・タイプによって異なります。

- 「汎用列」を選択した場合は、次のステップを実行します。

1. レポート・レイアウト名: レポート問合せまたはレポート・リージョンに関連付ける際にレポート・レイアウトを識別するための名前を入力します。

2. レポート・レイアウト: レポート・レイアウトは、ページ書式のXSL-FOベースの定義です。ページ・サイズ、向き、フォント、スタイルなどを定義する属性は、すべてこのセクションで定義されます。
有効な置換文字列のリストおよびその他の情報のリストを表示するには、アイテム・ラベル「レポート・レイアウト」をクリックします。個別のヘルプ・ウィンドウが開きます。

3. レポートの列ヘッダー: レポート・ヘッダー行の各セルの外観を定義します。

4. レポート列: すべてのレポート行に対する各セルの外観を定義します。

5. レポート列の幅: 実行時に幅を計算するか、またはレポート・リージョンのレポート列定義から導出できます。

- 名前付き列を選択した場合は、次のステップを実行します。

1. レイアウト名: レポート問合せまたはレポート・リージョンに関連付ける際に、レポート・レイアウトを識別するための名前を入力します。

2. レポート・レイアウト・ファイル: レポート・レイアウトが含まれるファイルをアップロードします。

レポート・レイアウトの編集

汎用列のレポート・レイアウトを直接Application Expressで編集できます。ただし、名前付き列のレポート・レイアウトを編集するには、現行のファイルをダウンロードしてそれを編集し、再度アップロードする必要があります。

レポート・レイアウトを編集するには、次のステップを実行します。

1. 共有コンポーネント・ページにナビゲートします。「共有コンポーネント・ページへのアクセス」を参照してください。

2. 「レポート」の下の「レポート・レイアウト」をクリックします。

3. レポート・レイアウト・ページで、編集するレイアウトを選択します。

4. 汎用列レイアウトの場合は、レポート・レイアウトの編集ページで直接レイアウトを編集してから、「変更の適用」をクリックします。

5. 名前付き列のレイアウトの場合は、「ダウンロード」をクリックして、コンピュータにファイルを保存します。
ファイルを編集して、新しいレポート・レイアウトとして更新されたバージョンをアップロードします。

レポート・レイアウトのコピー

レポート・レイアウトをコピーして編集および保存できます。

レポート・レイアウトをコピーするには、次のステップを実行します。

1. 共有コンポーネント・ページにナビゲートします。「共有コンポーネント・ページへのアクセス」を参照してください。

2. 「レポート」の下の「レポート・レイアウト」をクリックします。

3. レポート・レイアウト・ページで、「コピー」をクリックします。

4. レポート・レイアウトのコピー・ページで、コピーするレイアウトを選択して、コピーの名前を入力し、「コピー」をクリックします。
コピーがレイアウト・リストに表示されます。

クラシック・レポート・リージョンの出力属性の構成

レポート・リージョンを出力する方法の1つは、出力属性を構成する方法です。構成後、これらの属性は現行のリージョンのみに適用され、リージョンのコンテキスト外では使用できません。

インスタンスに対して出力機能が設定されている場合、様々な形式で出力できるようにレポート・リージョンを構成できます。

関連項目:
「クラシック・レポートの出力メソッドについて」およびOracle Application Express管理ガイドの「レポート出力の構成」

出力用にクラシック・レポート・リージョンを構成するには、次のステップを実行します。

1. アプリケーションで、出力するクラシック・レポート・リージョンを含むページを選択します。
「ページ定義」が表示されます。

2. レポート属性ページにアクセスします。「クラシック・レポートの属性へのアクセス」を参照してください。

3. 「出力属性」タブをクリックします。

4. 「出力」で、次の該当する情報を指定します。

1. レポート出力の有効化: 「はい」を選択します。

2. リンク・ラベル: 出力プロセスを開始するリンクのテキストを入力します。

3. レスポンス・ヘッダー: Oracle Application Expressにより生成されたレスポンス・ヘッダーは、「レポート設定」または「プリント・サーバー」に基づきます。レスポンス・ヘッダーは、HTTPリクエストを受信した応答としてサーバーがWebブラウザに返信する情報です。レスポンス・ヘッダーには、サーバーがクライアントに送信するファイルの日付、サイズ、タイプに加えて、サーバー自体に関するデータも含まれています。コンテンツ配置(「ファイルの表示形式」属性を使用)およびファイル名を指定する場合、レスポンス・ヘッダーはレポート設定に基づいている必要があります。

4. ファイルの表示形式: レポート問合せドキュメントをWebブラウザでどのように開くかを選択します。オプションは次のとおりです。

- 添付ファイル: レポート問合せのダウンロード・ボタンをクリックすると、ファイルを開く/保存のダイアログ・ボックスが表示されます。

- インライン: レポート問合せドキュメントがブラウザ・ウィンドウ内に表示されます。

5. (オプション)ファイル名: ダウンロードされるファイルの名前を入力してください。これを空白のままにすると、リージョン名がファイル名として使用されます。

6. 出力形式: 出力オプションを選択します。

7. アイテム: 「出力形式」で「アイテムから導出」を選択した場合にのみ有効になります。有効な場合、形式値を保持するアプリケーション・アイテムまたはページ・アイテムを選択します。

8. レポート・レイアウト: 組込みの汎用レポート・レイアウトを使用する場合は、「デフォルト・レポート・レイアウト」を選択します。自分または管理者が作成したレポート・レイアウトを選択することもできます。カスタムXSL-FOレポート・レイアウトを構築する場合に使用可能な置換文字列のリストについては、アイテム・ヘルプを参照してください。

9. プリント・サーバーの上書き: 代替のプリント・サーバーを指定します。プリント・サーバーは通常、Oracle Application Express管理サービスのすべてのワークスペースについて一元的に設定されます。Oracle Application Express管理ガイドの「レポート出力の構成」を参照してください。
代替プリント・サーバーをレポート・レベルで構成すると、出力で予想される問題のデバッグと診断が簡単になり、カスタム作成した特定のエンド・ポイントを使用してカスタムのXSLT変換を実行することが可能になります。

10. 出力URL: レポート・リージョンは、標準の出力リンク、またはページ・ボタンを使用して出力できます。ボタンを使用する場合、リンク・ラベルを削除し、ページにボタンを作成し、この属性に表示されるURLをボタン・ターゲットとして使用します。

5. 残りのセクションで、ページ・サイズ、用紙の向き、ページのヘッダーおよびフッター、フォント、テキストの色、背景の色を定義します。

6. 「レポート列」で、各列の幅を指定します。
デフォルトでは、各列の幅は同じになります。「合計幅」は表示専用フィールドであり、すべての列幅の合計を示します。個々の列の幅を変更すると、「合計幅」は自動的に再計算されます。「列幅の単位」が「ポイント」ではなく「割合」に設定されている場合は、列幅の合計を100以下にする必要があります。

「列幅のリセット」ボタンをクリックすると、「列幅の単位」が「割合」になり、すべての列幅がそれぞれのデフォルト値に戻ります。「再計算」ボタンをクリックすると、列幅の割合は現在の値を維持したままで、合計幅が100%以下になるように、すべての列幅が縮小されます。

7. 「変更の適用」をクリックします。

対話モード・レポート・リージョンの出力属性の構成

対話モード・レポートの出力属性は、クラシック・レポートの場合とは異なり、デフォルトのXSL-FOレイアウトのみを使用できます。また、この画面から直接開始するのではなく、「レポート属性」の「ダウンロード」セクションからのみ開始できます。構成した属性は、現行のリージョンのみに適用され、リージョンのコンテキスト以外では使用できません。

インスタンスに対して出力機能が設定されている場合、様々な形式で出力できるようにレポート・リージョンを構成できます。

出力用に対話モード・レポート・リージョンを構成するには、次のステップを実行します。

1. アプリケーションで、出力する対話モード・レポート・リージョンを含むページを選択します。
「ページ定義」が表示されます。

2. 「リージョン」で、出力するリージョンの横にある「対話モード・レポート」をクリックします。

3. 「出力属性」タブをクリックします。

4. 「出力」で、次の該当する情報を指定します。

1. レスポンス・ヘッダー: Oracle Application Expressにより生成されたレスポンス・ヘッダーは、「レポート設定」または「プリント・サーバー」に基づきます。レスポンス・ヘッダーは、HTTPリクエストを受信した応答としてサーバーがブラウザに送信する情報です。レスポンス・ヘッダーには、サーバーがクライアントに送信するファイルの日付、サイズ、タイプに加えて、サーバー自体に関するデータも含まれています。コンテンツ配置(「ファイルの表示形式」属性を使用)およびファイル名を指定する場合、レスポンス・ヘッダーはレポート設定に基づいている必要があります。

2. ファイルの表示形式: レポート問合せドキュメントをWebブラウザでどのように開くかを選択します。オプションは次のとおりです。

- 添付ファイル: レポート問合せのダウンロード・ボタンをクリックすると、ファイルを開く/保存のダイアログ・ボックスが表示されます。

- インライン: レポート問合せドキュメントがブラウザ・ウィンドウ内に表示されます。

3. プリント・サーバーの上書き: 代替のプリント・サーバーを指定します。プリント・サーバーは通常、Oracle Application Express管理サービスのすべてのワークスペースについて一元的に設定されます。Oracle Application Express管理ガイドの「レポート出力の構成」を参照してください。
代替プリント・サーバーをレポート・レベルで構成すると、出力で予想される問題のデバッグと診断が簡単になり、カスタム作成した特定のエンド・ポイントを使用してカスタムのXSLT変換を実行することが可能になります。

5. 残りのセクションで、ページ・サイズ、用紙の向き、ページのヘッダーおよびフッター、フォント、テキストの色、背景の色を定義します。

6. 「変更の適用」をクリックします。

10 データベース・アプリケーション・コンポーネントおよびコントロールの追加

この項では、アプリケーション・ビルダーを使用して、データベース・アプリケーション・コンポーネント(フォーム、カレンダ、マップ、チャートなど)とページ・コントロール(ボタン、LOV、ショートカット、ツリーなど)を作成する方法について説明します。対話モード・レポートおよびクラシック・レポートの作成方法の詳細は、「レポートの作成」を参照してください。

内容は次のとおりです。

- フォームの作成

- カレンダの作成

- マップの作成

- チャートの作成

- ボタンの作成

- アプリケーション・レベルでのLOVの作成

- ショートカットの使用

- ツリーの作成

- 「検索」アイコンの使用

- アプリケーション、ページおよびページ・コンポーネントへのアクセスの制御

- アプリケーションへのJavaScriptの組込み

- jQueryとjQuery UIサポートについて

- 印刷用ページの最適化

- ヘルプ・ページの作成

関連項目:
「ページ・レイアウトの制御」および「ナビゲーションの追加」

フォームの作成

様々なタイプのフォームをアプリケーションに含めることができます。表内の単一行のみを更新できるフォーム、または同時に複数行を更新できるフォームを含めることができます。アプリケーション・ビルダーには、自動的にフォームを作成するために使用できるいくつかのウィザードが含まれていますが、手動でフォームを作成することもできます。

内容は次のとおりです。

- ウィザードを使用したフォームの作成

- 表形式フォームの作成

- マスター・ディテール・フォームの作成

- フォームの手動作成

- フォームでのユーザー入力の検証

関連項目:
「レポートの作成」

ウィザードを使用したフォームの作成

フォームを作成する最も簡単な方法は、ウィザードを使用することです。たとえば、表またはビューのフォーム・ウィザードでは、1つの表の1列ごとに1つのアイテムを作成します。このウィザードには、主キーを使用した表への行の挿入、表の行の更新および削除に必要なボタンおよびプロセスが含まれています。各リージョンには、定義名および表示位置が指定されています。その他の属性には、アイテム、ボタン、プロセスおよびブランチがあります。

ウィザードを使用してフォームを作成するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「ページの作成」をクリックします。

4. 「フォーム」を選択して、「次へ」をクリックします。

5. 「フォーム」で、表 10-1に示すフォーム・ページのタイプを選択します。

表10-1 フォーム・ページのタイプ

フォーム・ページ・タイプ

説明

プロシージャのフォーム

ストアド・プロシージャの引数に基づくフォームを構築します。ストアド・プロシージャまたはパッケージに実装済のロジックまたはデータ操作言語(DML)が存在する場合は、この方法を使用します。

表またはビューのフォーム

データベース表の単一行を更新できるフォームを作成します。

レポート付きの表のフォーム

2つのページを作成します。1つのページにはレポートが表示されます。各行に2ページ目へのリンクが提供され、これを使用して各レコードを更新できます。

注意: このウィザードでは、127列を超える列が含まれている表はサポートされていません。127列を超える列を選択すると、エラーが発生します。

マスター・ディテール・フォーム

1つのHTMLフォーム内にマスター行および複数のディテール行を表示するフォームを作成します。このフォームを使用すると、2つの表またはビューに対し、値の問合せ、挿入、更新および削除を行うことができます。

関連項目: 「マスター・ディテール・フォームの作成」

表形式フォーム

データベースの複数の行を更新できるフォームを作成します。

関連項目: 「表形式フォームの作成」

SQL問合せのフォーム

EQUIJOINなどのSQL問合せによって戻される列に基づくフォームを作成します。

サマリー・ページ

読取り専用のフォームを作成します。通常、ウィザードの最後に確認ページを提供するために使用します。

Webサービスのフォーム

Webサービスの定義に基づいて、アイテムを含むページを作成します。このウィザードでは、ユーザー入力フォーム、Webサービスをコールするプロセスおよび送信ボタンを作成します。

関連項目: 「Webサービスでのフォームの作成」

Webサービスのフォームとレポート

Webサービスの定義に基づいて、アイテムを含むページを作成します。このウィザードでは、ユーザー入力フォーム、Webサービスをコールするプロセスおよび送信ボタンを作成し、レポートに結果を表示します。

参照: 「Webサービスでの入力フォームとレポートの作成」

6. 画面に表示されるステップに従います。特定のフィールドの詳細を表示するには、アイテム・ラベルをクリックします。
ヘルプが使用可能な場合は、アイテムにカーソルをあわせると、カーソルが疑問符付きの矢印に変わります。「フィールドレベル・ヘルプについて」を参照してください。

表形式フォームの作成

表形式フォームを使用すると、1つのページから表内の複数の行を一度に更新できます。ウィザードを使用して作成した表形式フォームでは、データベース表内の複数の行に対して更新、挿入および削除操作を実行できます。このフォームには、バックグラウンドでコミット時ロックを実行してデータの整合性を維持する組込みの複数行更新プロセスが備わっています。

内容は次のとおりです。

- 表形式フォームについて

- 表形式フォームの仕組み

- アプリケーションの作成ウィザードを使用した表形式フォームの作成

- ページの作成ウィザードを使用した表形式フォームの作成

- 表形式フォームの列の順序とリージョン・ソースの同期化

表形式フォームについて

表形式フォームの作成方法は主に次の2つです。

- アプリケーションの作成ウィザード

- ページの作成ウィザード

これらのウィザードを使用して作成した表形式フォームには、自動DMLプロセスが含まれています。これらのウィザードでは、データベース表内の複数の行に対して更新、挿入および削除操作を実行するフォームを作成します。また、更新可能なレポート・リージョンまたは更新可能な列を含む標準レポート・リージョンのいずれかを、表形式フォームのデータを処理するカスタムPL/SQLパッケージ・プロセスとあわせて作成することで、表形式フォームを手動で作成することもできます。

注意:
ウィザードによって表形式フォームが生成された後に、そのフォームのSQL文の選択リストを変更することはお薦めしません。問合せを変更する場合は、更新可能な列の値が、Application Expressエンジンによってデータベースから問い合せられた後に変更されていないことを確認してください。

表形式フォームの実行

表形式フォームを実行すると、データは更新可能な列を含むレポートとしてレンダリングされます。これらの列は、様々なフォーム要素(テキスト・フィールド、テキスト領域、日付ピッカー、選択リスト、ラジオ・グループなど)を使用して示されます。

rprt_tabular_form.gifの説明

デフォルトでは、日付列は「日付ピッカー」アイテム・タイプを使用して作成されます。他の列については、ユーザー・インタフェースのデフォルト値を定義しておくことで、LOVに基づく選択リスト、または数値フィールドと大きなテキスト領域として自動的に作成できます。

関連項目:
Oracle Application Express SQLワークショップ・ガイドの「ユーザー・インタフェースのデフォルト値の管理」

数値フィールドおよび日付フィールドについては、日付と数値の書式マスクを事前に定義したり、初期フォームの生成後にそれらの書式マスクを適用することもできます。

また、各レポートには、(行セレクタと呼ばれる)チェック・ボックス列も含まれています。ユーザーは、この行セレクタを使用して1つ以上の列を選択し、データを更新または削除します。行を追加するには、「行の追加」をクリックします。

ヒント:
列属性を編集して、特定の列の外観を制御できます。

表形式フォームの仕組み

表形式フォームは、基礎となる表の列に問合せ列が関連付けられているSQL問合せに基づきます。単一レコードとは異なり、表形式フォームではデータはセッション・ステートに格納されません。表形式フォーム・ページが送信されると、表形式フォームのデータは組込みのデータ操作言語(DML)またはカスタムPL/SQLページ・プロセスを使用して処理されます。

自動DMLを備えた表形式フォームでは、複数行操作に対して次の2つのプロセスが使用されます。

- 「複数行の更新」(MRU)プロセスでは、作成操作と更新操作を実行します

- 「複数行の削除」(MRD)プロセスでは、1つ以上の行に対するリクエストを削除します

MRUプロセスとMRDプロセスでは、基礎となる表名と主キー列を参照します。DMLプロセスで正しいレコードを識別できるようにするには、主キー列を表形式フォームのSQL問合せに含め、レポート列を非表示にするか、表示専用(ステートを保存)にする必要があります。新しいレコードの場合、主キー値をNULLにして、新しいレコードとして識別されるようにする必要があります。削除操作は、削除対象の行の行番号を参照することによって実行されます。ユーザーは、カレント・ページ上の1つ以上の行を確認できます。ユーザーが「削除」ボタンを押すと、行番号に基づいて対応する主キー値が識別され、一致する行が削除されます。

ウィザードによって生成される表形式フォームの組込みDMLには、更新の喪失を回避するためのチェックサム列が含まれています。コミット時ロックと呼ばれる方法を使用すると、表形式フォームのレンダリング時に各行のチェックサムが計算されます。このチェックサムは、表形式フォームの特別な非表示列に格納されます。更新のためにフォームを送信すると、データベースに格納されている現在の日付で追加のチェックサム・セットが計算されます。表形式フォームの初回レンダリング時に構築されたチェックサムと新しいチェックサムが比較され、不一致が見つかった場合、更新は拒否されます。これは、表形式フォームがレンダリングされてからデータが送信されるまでの間に、データベース内のデータが別のユーザーまたは別のプロセスによって変更されたためです。

また、ウィザードによって生成される表形式フォームでは、一部の列に対して検証が自動的に作成されます。検証は、基礎となる表でNOT NULLに設定されている列、およびタイプがNUMBER、DATEまたはTIMESTAMPの列に対して作成されます。ユーザーの選択または定義済のユーザー・インタフェースのデフォルト値に基づいて、列が読取り専用に設定されている場合、検証は作成されません。

アプリケーションの作成ウィザードを使用した表形式フォームの作成

アプリケーションの作成ウィザードは、複数のページおよびコンポーネントで構成される基本的なOracle Application Expressアプリケーションをすばやく作成できるように設計されています。そのため、このウィザードでは、一般的なベスト・プラクティスに基づいてアプリケーションが生成され、ページの作成ウィザードに含まれているいくつかの高度なオプションは使用されません。

アプリケーションの作成ウィザードを使用して表形式フォームを作成するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. 「作成」ボタンをクリックします。

3. 「方法」で、「データベース」を選択し、「次へ」をクリックします。

4. 「名前」で、次のステップを実行します。

1. アプリケーション: アプリケーションを識別するための一意の整数値を入力します。3000から9000の間のアプリケーションIDは、Oracle Application Expressの内部使用向けに予約されています。

2. 名前: アプリケーションを識別するための名前を入力します。

3. スキーマ: 各アプリケーションは、すべてのSQLを特定のデータベース・スキーマとして解析することで、権限を取得します。データベース・スキーマ所有者を指定します。

4. 作成オプション:

- 最初から開始: すべてのページを手動で追加できるようにします。

- ホームページを含める: 追加される新規ページの親として自動的に機能する空白ページを含めます。ホームページには、その他のページへのナビゲーションを提供するリスト・リージョンも作成されます。

- 以前作成したアプリケーション・モデルを使用: 既存のアプリケーション定義を再利用します。既存のアプリケーション定義を使用すると、アプリケーションのプロパティ値を再入力せずに、このウィザードを実行できます。
それでもまだ他のアプリケーション属性はすべて定義する必要がありますが、一部の属性は、別のアプリケーションから共有コンポーネントをコピーすることによってコピーすることもできます。

5. ユーザー・インタフェース: アプリケーションのユーザー・インタフェースを選択します。デスクトップでの使用を主として設計されているアプリケーションの場合は、「デスクトップ」を選択します。

6. 「次へ」をクリックします。

5. 「ページの追加」で、次のステップを実行します。

1. ページ・タイプの選択: 「表形式フォーム」を選択します。

2. ページに従属: 該当する場合、従属ページを選択します。詳細は、アイテムのヘルプを参照してください。

3. 表名: 表を選択します。

4. 「ページの追加」をクリックします。
ページ上部に新しいページが表示されます。

5. 「次へ」をクリックします。

6. 共有コンポーネントの場合、別のアプリケーションから共有コンポーネントをコピーするかどうかを指定します。「はい」または「いいえ」を選択します。「はい」を選択する場合は、コピー元の場所とインポートするコンポーネントを選択します。
共有コンポーネントは、アプリケーション内の複数のページに表示または適用できる共通のアプリケーション要素です。時間を節約したり、アプリケーション間の一貫性を維持するには、既存のアプリケーションから共有コンポーネントをコピーします。コピーできる共有コンポーネントのタイプには、ユーザー・インタフェースのテーマ、LOV、ナビゲーション・バー・エントリ、認可スキームおよび認証スキームがあります。

7. 「属性」で、次のステップを実行します。

1. 認証スキーム: アプリケーションにアクセスする前にユーザー・アイデンティティを確立する方法を決定します。オプションは次のとおりです。

- Application Express: Application Expressサービス管理アプリケーションで作成および保持されるユーザー・アカウント資格証明を使用します。これらは、Application Express開発環境へのログインに使用するアカウントです。また、アプリケーションのエンド・ユーザー用として、このユーザー・アカウント・リポジトリにアカウントを作成することもできます。

- データベース・アカウント: アプリケーションへのユーザー・ログインには、認証するためにデータベース・スキーマ名(またはユーザー名)とそのパスワードが必要です。このアカウント情報は、Oracle Database全体で管理されます。

- 認証なし: データベース・アカウント資格証明とも呼ばれます。このオプションを使用すると、ユーザーはmod_plsql DAD定義に格納されているアカウント資格証明を使用して、アプリケーションにアクセスできるようになります。ほとんどの場合、アプリケーションへのアクセス時にログインを行う必要がなくなります。これは、公開アプリケーションを最も速く作成する方法です。

詳細は、「認証によるユーザー・アイデンティティの証明」を参照してください。

2. タブ: アプリケーションにタブを含めるかどうかを選択します。1レベルまたは2レベルのタブを作成することも、タブをまったく作成しないこともできます。詳細は、「タブの作成」を参照してください。
アプリケーションを開発する言語をこの属性で指定します。この言語が、すべての変換の元となるベース言語になります。

3. 言語: このアプリケーションのプライマリ言語を選択します。
アプリケーションを開発する言語をこの属性で指定します。この言語が、すべての変換の元となるベース言語になります。

4. ユーザー言語プリファレンスの派生元: エンジンによるアプリケーション言語の決定方法を指定します。アプリケーションのプライマリ言語は静的にする(Webブラウザの言語から派生される)か、またはユーザー・プリファレンスまたはアイテムから判別されるようにできます。データベース言語の設定では、日付の表示とソート特性を決定します。詳細は、アイテムのヘルプを参照してください。
「言語」および「ユーザー言語プリファレンスの派生元」属性は、グローバリゼーション属性の編集ページで後から変更できます。「グローバリゼーション属性の設定」を参照してください。

5. 日付書式: アプリケーションで使用する日付書式を指定します。
この日付書式を使用して、NLS_DATE_FORMATデータベース・セッションの設定が変更されてから、アプリケーション内のページが表示または送信されます。この値には、有効なOracle日付書式マスクを含むリテラル文字列、または置換構文によるアイテム参照を指定できます。値が指定されていない場合は、データベース・セッションからデフォルトの日付書式が実行時に取得されます。指定されている場合は、DATE型の列から得られるすべてのアイテムの日付書式としても使用されます。

6. 日時書式: アプリケーションで使用する日時書式を指定します。
この日時書式は、置換参照&APP_DATE_TIME_FORMAT.を使用するか、PL/SQLでv('APP_DATE_TIME_FORMAT')ファンクションを使用して、アプリケーション内で参照できます。この属性によってNLS設定が変更されることはありません。この値には、有効なOracle日付書式マスクを含むリテラル文字列、または置換構文を使用したアイテム参照を指定できます。この属性値を指定しない場合、APP_DATE_TIME_FORMATへの参照はNLSデータベース・セッションの日付書式とNLS時刻書式を返します。

7. タイムスタンプ書式: アプリケーションで使用するタイムスタンプ書式を指定します。
このタイムスタンプ書式を使用して、NLS_TIMESTAMP_FORMATデータベース・セッションの設定が変更されてから、アプリケーション内のページが表示または送信されます。この値には、有効なOracleタイムスタンプ書式マスクを含むリテラル文字列、または置換構文を使用したアイテム参照を指定できます。値が指定されていない場合は、データベース・セッションからデフォルトのタイムスタンプ書式が実行時に取得されます。

8. タイムスタンプ・タイムゾーン書式: アプリケーションで使用するタイムゾーン付きタイムスタンプ書式を指定します。
このタイムゾーン付きタイムスタンプ書式を使用して、NLS_TIMESTAMP_TZ_FORMATデータベース・セッションの設定が変更されてから、アプリケーション内のページが表示または送信されます。この値には、有効なOracleタイムゾーン付きタイムスタンプ書式マスクを含むリテラル文字列、または置換構文を使用したアイテム参照を指定できます。値が指定されていない場合は、データベース・セッションからデフォルトのタイムゾーン付きのタイムスタンプ書式が実行時に取得されます。

9. 「次へ」をクリックします。

8. 「ユーザー・インタフェースのテーマ」で、テーマを選択し、「次へ」をクリックします。
テーマは、アプリケーション全体のレイアウトおよびスタイルの定義に使用できるテンプレートのコレクションです。「テーマの管理」を参照してください。

9. 選択した内容を確認し、「作成」をクリックします。

関連項目:
Oracle Application Express SQLワークショップ・ガイドの「ユーザー・インタフェースのデフォルト値の管理」

ページの作成ウィザードを使用した表形式フォームの作成

ページの作成ウィザードを使用して、既存のアプリケーションに表形式フォームを追加します。表形式フォームの基となる表の名前を指定すると、その表の列がデータベース・データ・ディクショナリから読み取られます。

表形式フォームでは、表の列に対する挿入、更新および削除操作が実行されます。アプリケーションの作成ウィザードとは異なり、ページの作成ウィザードを使用して表形式フォームを作成するときに、行の識別方法を決定します。表に定義されている主キー、または表内の行を一意に識別するROWID擬似列のいずれかを指定できます。主キーを選択する場合は、3種類の主キーのソース・タイプ(トリガー、PL/SQLファンクションおよび順序)の中から選択できます。

ページの作成ウィザードを使用して表形式フォームを作成するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「ページの作成」をクリックします。

4. 「フォーム」を選択して、「次へ」をクリックします。

5. 「表形式フォーム」を選択して、「次へ」をクリックします。
表形式フォームの作成ウィザードが表示されます。

6. 「表および列」で、次の項目を指定します。

1. 表/ビューの所有者: 表形式フォームのベースにする表またはビューの所有者を選択します。

2. 表/ビューの名前: 表形式フォーム・リージョンに含める列を含む表またはビューを選択します。

3. 列の選択: 表形式フォームに含める1つ以上の列を選択します。その後のページで、どの列を更新可能にするかを定義します。

4. 実行可能な操作: 表で実行する操作(たとえば、更新、挿入、削除)を選択します。

5. ユーザー・インタフェースのデフォルト値: ユーザー・インタフェースのデフォルト値を使用するかどうかを選択します。詳細は、アイテム・ヘルプと『Oracle Application Express SQLワークショップ・ガイド』の「ユーザー・インタフェースのデフォルト値の管理」を参照してください。

6. 「次へ」をクリックします。

次に、主キーを定義します。表形式フォームでは、データベース内の表の行に対する挿入、更新および削除操作が実行されます。表に定義されている主キー、または表内の行を一意に識別するROWID擬似列のいずれかを使用して、行を識別します。

7. 「主キー」で、次のいずれかの項目を選択します。

- データベースで管理(ROWID): 表形式フォームは、ROWID擬似列を使用して、更新および削除する行を識別します。

- 主キー列の選択: 表形式フォームは、ソース表の主キー列を使用します。

8. 「データベースで管理(ROWID)」を選択した場合は、「次へ」をクリックして続行します。

9. 「主キー列の選択」を選択した場合は、次のようにします。

1. 主キー列1: 主キーの最初の列を選択します。

2. 主キー列2: 複合主キーが含まれている場合は、この属性の2つ目の主キー列を指定します。この属性はオプションです。

3. 「次へ」をクリックします。

4. 「ソース・タイプ」で、主キーの移入方法を選択します。

- 既存のトリガー: 挿入前トリガーによって主キーが移入される場合は、このオプションを選択します。このオプションは、フォームを完成させた後に主キー列ソースを指定する場合も選択できます。

- カスタムPL/SQLファンクション: 戻りキー値を生成するPL/SQLファンクションを指定する場合はこのオプションを選択します。

- 既存の順序: 選択されているスキーマで使用可能な順序のリストから順序を選択する場合は、このオプションを選択します。

5. 「次へ」をクリックします。

10. 「更新可能な列」で、次のステップを実行します。

1. 更新可能な列: フォームに含める更新可能な列を選択します。
ページの作成後、列の順序またはSQL問合せを変更できます。

2. 「次へ」をクリックします。

11. 「ページおよびリージョン属性」で、次のステップを実行します。

1. ページ: 更新可能な新しいレポートを含めるページを選択するか、または新しいページ番号を入力します。

2. ページ名: 新しいページを作成する場合は、名前を入力します。

3. リージョン・タイトル: 更新可能なレポートが表示されるリージョンの名前を入力します。

4. リージョン・テンプレート: 更新可能なレポート・リージョンのリージョン・テンプレートを選択します。

5. レポート・テンプレート: レポート・テンプレートを選択します。

6. ブレッドクラム: ページでブレッドクラム・ナビゲーション・コントロールを使用するかどうか、およびどのブレッドクラム・ナビゲーション・コントロールを使用するかを選択します。

7. 「次へ」をクリックします。

12. 「タブ・オプション」で、ページでのタブの表示方法を示すオプションを選択し、「次へ」をクリックします。

13. 「ボタンとブランチ」で、次の項目を指定します。

1. 「取消」ボタン・ラベル: 「取消」ボタンに表示するテキストを入力します。

2. ページにブランチ: ユーザーが「取消」をクリックしたときの、ブランチ先のページ番号を指定します。

3. 「送信」ボタン・ラベル: 「送信」ボタンに表示するテキストを入力します。

4. ページにブランチ: ユーザーが「送信」をクリックしたときの、ブランチ先のページ番号を指定します。

5. 「削除」ボタン・ラベル: 「削除」ボタンに表示するテキストを入力します。

6. 「行の追加」ボタン・ラベル: 「行の追加」ボタン・ラベルに表示するテキストを入力します。

7. 「次へ」をクリックします。

14. 「作成」をクリックします。
成功メッセージが表示されます。

表形式フォームの列の順序とリージョン・ソースの同期化

クラシック・レポートの列の順序をリージョン・ソース問合せに定義されている列の順序と同期化するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 表形式フォームが含まれるページを選択します。
「ページ定義」が表示されます。

4. レポート属性ページを表示するには、次のステップを実行します。

- ツリー・ビュー: 表形式フォーム・リージョンを右クリックし、「レポート属性の編集」を選択します。

- コンポーネント・ビュー: 表形式フォーム・リージョンの横にある「レポート」リンクをクリックします。

5. 「タスク」から、「列の順序とリージョン・ソースの同期化」を選択します。

6. 「同期化」をクリックします。

マスター・ディテール・フォームの作成

マスター・ディテール・フォームは、データベースの2つの表の1対多関係を示します。通常、マスター・ディテール・フォームには、1つのHTMLフォーム内にマスター行および複数のディテール行が表示されます。このフォームを使用すると、2つの表またはビューに対し、値の挿入、更新および削除を行うことができます。

内容は次のとおりです。

- マスター・ディテール・フォームについて

- アプリケーションの作成ウィザードを使用したマスター・ディテール・フォームの作成

- ページの作成ウィザードを使用したマスター・ディテール・フォームの作成

マスター・ディテール・フォームについて

マスター・ディテール・フォームを実行すると、データは様々なフォーム要素(テキスト・フィールド、テキスト領域、日付ピッカー、選択リスト、ラジオ・グループなど)を使用してレポートとしてレンダリングされます。デフォルトでは、日付列は「日付ピッカー」アイテム・タイプを使用して作成されます。他の列については、ユーザー・インタフェースのデフォルト値を定義しておくことで、LOVに基づく選択リスト、または数値フィールドと大きなテキスト領域として自動的に作成できます。

rprt_master_detail2.gifの説明

「マスター・ディテール」では、マスター・レコードは標準フォームとして表示され、詳細レコードはページの下部の表形式フォームに表示されます。新しい行を追加するには、「Add Item to Order」をクリックします。

関連項目:
Oracle Application Express SQLワークショップ・ガイドの「ユーザー・インタフェースのデフォルト値の管理」

数値フィールドおよび日付フィールドについては、日付と数値の書式マスクを事前に定義したり、初期フォームの生成後にそれらの書式マスクを適用することもできます。また、ウィザードによって生成されるマスター・ディテール・フォームでは、一部の列に対して検証が自動的に作成されます。検証は、基礎となる表でNOT NULLに設定されている列、およびタイプがNUMBER、DATEまたはTIMESTAMPの列に対して作成されます。ユーザーの選択または定義済のユーザー・インタフェースのデフォルト値に基づいて、列が読取り専用に設定されている場合、検証は作成されません。

ヒント:
列属性を編集して、特定の列の外観を制御できます。

アプリケーションの作成ウィザードを使用したマスター・ディテール・フォームの作成

アプリケーションの作成ウィザードは、複数のページおよびコンポーネントで構成される基本的なOracle Application Expressアプリケーションをすばやく作成できるように設計されています。このウィザードでは、一般的なベスト・プラクティスに基づいてアプリケーションが生成され、ページの作成ウィザードに含まれているいくつかの高度なオプションは使用されません。

アプリケーションの作成ウィザードを使用してマスター・ディテール・フォームを作成するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. 「作成」ボタンをクリックします。

3. 「方法」で、「データベース」を選択し、「次へ」をクリックします。

4. 「名前」で、次のステップを実行します。

1. アプリケーション: アプリケーションを識別するための一意の整数値を入力します。3000から9000の範囲のアプリケーションIDは、Oracle Application Expressの内部使用向けに予約されています。

2. 名前: アプリケーションを識別するための名前を入力します。

3. スキーマ: アプリケーションは、すべてのSQLを特定のデータベース・スキーマとして解析することで、権限を取得します。データベース・スキーマ所有者を指定します。

4. 作成オプションを指定します。

- 最初から開始: すべてのページを手動で追加できるようにします。

- ホームページを含める: 追加された新しいページの親として自動的に機能する空白ページを含みます。リスト・リージョンもホーム・ページに作成され、追加ページへのナビゲーションが用意されます。

- 以前作成したアプリケーション・モデルを使用: 既存のアプリケーション定義を再利用します。既存のアプリケーション定義を使用すると、アプリケーションのプロパティ値を再入力せずに、このウィザードを実行できます。
この場合でも、他のアプリケーション属性をすべて定義する必要がありますが、一部の属性については、別のアプリケーションから共有コンポーネントのコピーを選択することできます。

5. ユーザー・インタフェース: アプリケーションのユーザー・インタフェースを選択します。主としてデスクトップで使用するために設計するアプリケーションの場合は、「デスクトップ」を選択します。

6. 「次へ」をクリックします。

ヒント:
ログイン・ページと空白ページのみで構成されるインスタント・アプリケーションを作成するには、「アプリケーションの作成」ボタンをクリックします。

次に、ページをアプリケーションに追加します。

5. 「ページ」で、次のステップを実行します。

1. ページ・タイプの選択: 「マスター・ディテール」を選択します。

2. ページに従属: 該当する場合、従属ページを選択します。詳細は、アイテムのヘルプを参照してください。

3. マスター表名: マスター表として使用する表またはビューを選択します。この表は、レポート・ページと、マスター・ディテール・ページのマスター・フォームを作成するために使用されます。

4. ディテール表名: ディテール表として使用する表またはビューを選択します。
外部キーを使用して選択したマスター表に関連付けられている表およびビューのみが表示されます。

5. 「ページの追加」をクリックします。
ページ上部に新しいページが表示されます。

6. 「次へ」をクリックします。

6. 「共有コンポーネント」で、共有コンポーネントを別のアプリケーションからコピーするかどうかを指定します。「はい」または「いいえ」を選択します。「はい」を選択した場合は、そのコピー元と、インポートするコンポーネントを選択します。
共有コンポーネントは、アプリケーション内の複数のページ間で表示または適用できる共通アプリケーション要素です。時間を節約するため、またはアプリケーション間の一貫性を保持するために、共有コンポーネントは既存のアプリケーションからコピーします。コピーできる共有コンポーネントのタイプには、ユーザー・インタフェースのテーマ、LOV、ナビゲーション・バー・エントリ、認可スキームおよび認証スキームがあります。

7. 「属性」で、次のステップを実行します。

1. 認証スキーム: アプリケーションにアクセスする前にユーザー・アイデンティティを確立する方法を決定します。オプションは次のとおりです。

- Application Express: Oracle Application Expressサービス管理アプリケーションで作成および保持されるユーザー・アカウント資格証明を使用します。これらは、Application Express開発環境へのログインに使用するアカウントです。また、アプリケーションのエンド・ユーザー用として、このユーザー・アカウント・リポジトリにアカウントを作成することもできます。

- データベース・アカウント: アプリケーションへのユーザー・ログインには、認証するためにデータベース・スキーマ名(またはユーザー名)とそのパスワードが必要です。このアカウント情報は、Oracle Database全体で管理されます。

- 認証なし: データベース・アカウント資格証明とも呼ばれます。このオプションを使用すると、ユーザーはmod_plsql DAD定義に格納されているアカウント資格証明を使用して、アプリケーションにアクセスできるようになります。ほとんどの場合、アプリケーションへのアクセス時にログインを行う必要がなくなります。これは、公開アプリケーションを最も速く作成する方法です。

詳細は、「認証によるユーザー・アイデンティティの証明」を参照してください。

2. タブ: アプリケーションにタブを含めるかどうかを選択します。1レベルのタブ、2レベルのタブまたはタブなしで作成できます。詳細は、「タブの作成」を参照してください。
アプリケーションを開発する言語をこの属性で指定します。この言語が、すべての変換の元となるベース言語になります。

3. 言語: このアプリケーションのプライマリ言語を選択します。
アプリケーションを開発する言語をこの属性で指定します。この言語が、すべての変換の元となるベース言語になります。

4. ユーザー言語プリファレンスの派生元: エンジンによるアプリケーション言語の決定方法を指定します。アプリケーションのプライマリ言語は静的にする(Webブラウザの言語から派生される)か、またはユーザー・プリファレンスまたはアイテムから決定されるようにできます。データベース言語の設定では、日付の表示とソート特性を決定します。詳細は、アイテムのヘルプを参照してください。
「言語」および「ユーザー言語プリファレンスの派生元」属性は、グローバリゼーション属性の編集ページで後から変更できます。「グローバリゼーション属性の設定」を参照してください。

5. 日付書式: アプリケーションで使用する日付書式を指定します。
この日付書式を使用して、NLS_DATE_FORMATデータベース・セッションの設定が変更されてから、アプリケーション内のページが表示または送信されます。この値には、有効なOracle日付書式マスクを含むリテラル文字列、または置換構文によるアイテム参照を指定できます。値が指定されていない場合は、データベース・セッションからデフォルトの日付書式が実行時に取得されます。指定されている場合は、DATE型の列から得られるすべてのアイテムの日付書式としても使用されます。

6. 日時書式: アプリケーションで使用する日時書式を指定します。
この日時書式は、置換参照&APP_DATE_TIME_FORMAT.を使用するか、PL/SQLでv('APP_DATE_TIME_FORMAT')ファンクションを使用して、アプリケーション内で参照できます。この属性によってNLS設定が変更されることはありません。この値には、有効なOracle日付書式マスクを含むリテラル文字列、または置換構文を使用したアイテム参照を指定できます。この属性値を指定しない場合、APP_DATE_TIME_FORMATへの参照はNLSデータベース・セッションの日付書式とNLS時刻書式を返します。

7. タイムスタンプ書式: アプリケーションで使用するタイムスタンプ書式を指定します。
このタイムスタンプ書式を使用して、NLS_TIMESTAMP_FORMATデータベース・セッションの設定が変更されてから、アプリケーション内のページが表示または送信されます。この値には、有効なOracleタイムスタンプ書式マスクを含むリテラル文字列、または置換構文を使用したアイテム参照を指定できます。値が指定されていない場合は、データベース・セッションからデフォルトのタイムスタンプ書式が実行時に取得されます。

8. タイムスタンプ・タイムゾーン書式: アプリケーションで使用されるタイムゾーン付きタイムスタンプ書式を指定します。
このタイムゾーン付きタイムスタンプ書式を使用して、NLS_TIMESTAMP_TZ_FORMATデータベース・セッションの設定が変更されてから、アプリケーション内のページが表示または送信されます。この値には、有効なOracleタイムゾーン付きタイムスタンプ書式マスクを含むリテラル文字列、または置換構文を使用したアイテム参照を指定できます。値が指定されていない場合は、データベース・セッションからデフォルトのタイムゾーン付きのタイムスタンプ書式が実行時に取得されます。

9. 「次へ」をクリックします。

8. 「ユーザー・インタフェースのテーマ」で、テーマを選択し、「次へ」をクリックします。
テーマは、アプリケーション全体のレイアウトおよびスタイルの定義に使用できるテンプレートのコレクションです。「テーマの管理」を参照してください。

9. 選択内容を確認して、「アプリケーションの作成」をクリックします。

ページの作成ウィザードを使用したマスター・ディテール・フォームの作成

ページの作成ウィザードでは、データベースに外部キー・リレーションシップが定義されていない2つの表からマスター・ディテールを作成できます。基礎となるデータベースで外部キーと適切に定義されたリレーションシップを使用することをお薦めしますが、開発者は必ずしも各自のデータベース・モデルを変更できるわけではありません。

ウィザードを使用して作成したマスター・ディテール・フォーム・ページ上のマスター・フォームには、ユーザーがマスター結果セット内で前後に移動するためのボタンが含まれています。ウィザードの実行中に、どの列でナビゲーションの順序を決定するかを選択します。また、2ページまたは3ページで構成されるマスター・ディテール・フォームを作成し、個別のページの単一レコード編集でレポートに表示される詳細レコードを含めることもできます。

ページの作成ウィザードを使用してマスター・ディテール・フォームを作成するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「ページの作成」をクリックします。

4. 「フォーム」を選択して、「次へ」をクリックします。

5. 「マスター・ディテール・フォーム」を選択して、「次へ」をクリックします。
マスター・ディテール・ウィザードが表示されます。

6. 「マスター表の定義」で、次のステップを実行します。

1. 表/ビューの所有者: マスター表を所有するスキーマを選択します。

2. 表/ビューの名前: マスター・ページに含める列を含む表またはビューを選択します。
そのオブジェクト内の列が表示されます。

3. 「次へ」をクリックします。

7. 「ディテール表を定義」で、次のステップを実行します。

1. 関連する表のみの表示: ディテール表のリストを、マスター表に関連する表のみに制限するかどうかを指定します。「はい」または「いいえ」を選択します。

2. 表/ビューの所有者: 表またはビューの所有者を選択します。デフォルトで選択された表またはビューの所有者は、アプリケーションの所有者と同一です。アプリケーションの所有者が他のスキーマの表またはビューに対するSELECT権限を持っている場合、他のスキーマを選択できます。

3. 表/ビューの名前: ディテール・ページに含める列を含む表またはビューを選択します。
そのオブジェクト内の列が表示されます。

4. ディテール・ページの列を選択してください: ディテール・ページに表示する列を選択します。後で列を追加できます。

5. 「次へ」をクリックします。

次に、主キーを定義します。フォームでは、データベース内の表の行に対する挿入、更新および削除操作が実行されます。表に定義されている主キー、または表内の行を一意に識別するROWID擬似列のいずれかを使用して、行を識別します。

8. 「主キーの定義」で、各表について次のいずれかの項目を選択します。

- データベースで管理(ROWID): ROWID擬似列を使用して、更新および削除する行を識別します。

- 主キー列の選択: ソース表の主キー列を使用します。

9. 「データベースで管理(ROWID)」を選択した場合は、次のステップを実行します。

1. 「次へ」をクリックします。

2. 「マスター・オプション」で、マスター表とディテール表の関係を定義します。列名(表名で完全修飾された名前)を入力するか、またはリストから列名を選択できます。「次へ」をクリックします。

3. 「次へ」をクリックします。

10. 「主キー列の選択」を選択した場合は、次のようにします。

1. 「主キーの定義」で、各表について次の項目を選択します。

- 主キー列1: 主キーの最初の列を選択します。

- 主キー列2: 複合主キーが含まれている場合は、この属性の2つ目の主キー列を指定します。この属性はオプションです。

- 「次へ」をクリックします。

2. 「主キーのソース」で、主キーの移入方法を選択し、「次へ」をクリックします。

- 既存のトリガー: 挿入前トリガーによって主キーが移入される場合は、このオプションを選択します。このオプションは、フォームを完成させた後に主キー列ソースを指定する場合も選択できます。

- カスタムPL/SQLファンクション: 戻りキー値を生成するPL/SQLファンクションを指定する場合はこのオプションを選択します。

- 既存の順序: 選択されているスキーマで使用可能な順序のリストから順序を選択する場合は、このオプションを選択します。

3. 「マスター・オプション」で、マスター行のナビゲーションを含めるかどうかを指定して、「次へ」をクリックします。
マスター行のナビゲーションを含める場合は、ナビゲーション順の列を定義します。ナビゲーション順の列が定義されていないと、マスターの更新フォームは、主キー列を使用してナビゲートします。

4. 「次へ」をクリックします。

11. 「レイアウト」で、マスター・ディテールの構築方法を指定して「次へ」をクリックします。オプションは次のとおりです。

- 「同一ページで表形式フォームとしてディテールの編集」では、2ページのマスター・ディテールが作成されます。「別のページでディテールの編集」では、3ページのマスター・ディテールが作成されます。

- 「別のページでディテールの編集」では、3ページのマスター・ディテールが作成されます。

12. 「ページ属性」で、次のステップを実行します。

1. ページ属性: マスター・ページおよびディテール・ページ情報を確認および編集します。

2. ブレッドクラム: ブレッドクラムを作成するかどうかを指定します。ブラッドクラム・エントリを作成するには、次のステップを実行します。

- エントリ名(マスター・レポート): マスター・レポート・ページのブレッドクラム・エントリの名前を指定します。

- エントリ名(マスター・ディテール・ページ): マスター・ディテール・ページのブレッドクラム・エントリの名前を指定します。

- 親エントリの選択: このブレッドクラム・エントリの親エントリを選択します。

- 親エントリ: このアイテムは、親エントリを選択している場合に表示されます。

3. 「次へ」をクリックします。

13. 「タブ・オプション」で、タブ・セットを含めるかどうかを指定し、「次へ」をクリックします。

14. 「作成」をクリックします。

フォームの手動作成

次のステップを実行することによって、フォームを手動で作成することもできます。

- (ページ・アイテムのコンテナとして機能する)HTMLリージョンを作成します。

- リージョンに表示するアイテムを作成します。

- プロセスおよびブランチを作成します。

HTMLリージョンを作成することによって手動でフォームを作成するには、次のステップを実行します。

1. 該当する「ページ定義」にナビゲートします。「「ページ定義」へのアクセス」を参照してください。

2. HTMLリージョンを作成します。「リージョンの作成」を参照してください。

3. ページへのアイテムの追加を開始します。「ページ・レベル・アイテムの作成」。

フォームの処理

フォームを作成したら、次に、基礎となるデータベース表またはビューに対して挿入または更新を行うことによって、ユーザーが入力したデータを処理します。フォームを処理する方法には、3通りあります。

- 行の自動処理(DML)プロセスの作成

- 1つ以上の挿入文を含むプロセスの作成

- PL/SQL APIを使用したフォーム値の処理

行の自動処理(DML)プロセスの作成

フォームを実装するための一般的な方法の1つは、行の自動処理(DML)プロセスを手動で作成することです。この方法には、3つのメリットがあります。1つ目は、SQLコードを指定する必要がないことです。2つ目は、Oracle Application ExpressによってDMLプロセスが実行されることです。3つ目は、このプロセスによって、ロストした更新の検出が自動的に実行されることです。ロストした更新の検出によって、データに同時にアクセスできる複数のアプリケーションのデータの整合性が保証されます。

この方法を実行するには、次のステップを実行します。

- アイテムを追加し、「アイテム・ソース」タイプを「データベース列」に定義し、大/小文字が区別される列名を指定します。

- オプション「常にキャッシュ値より優先」を選択します。

行の自動処理(DML)プロセスを作成するには、次のステップを実行します。

1. 該当する「ページ定義」にナビゲートします。「「ページ定義」へのアクセス」を参照してください。

2. ページ・プロセスの作成ウィザードにアクセスします。

- ツリー・ビュー: 該当する場所で、右クリックして「プロセスの作成」をクリックします。

- コンポーネント・ビュー: 「プロセス」で、「作成」アイコンをクリックします。

3. 「プロセス」で、「作成」アイコンをクリックします。

4. プロセスの「データ操作」を選択します。

5. プロセス・カテゴリの「行の自動処理(DML)」を選択します。

6. 次のプロセス属性を指定します。

1. 「名前」フィールドで、プロセスを識別するための名前を入力します。

2. 「順序」フィールドで、順序番号を指定します。

3. 「ポイント」リストから、適切なプロセス・ポイントを選択します。通常、「ロード時 - ヘッダーの後」を選択します。

4. 「タイプ」リストから、「行の自動処理(DML)」を選択します。

7. 画面に表示されるステップに従います。

1つ以上の挿入文を含むプロセスの作成

この方法でフォームを処理するには、挿入、更新および削除操作を実行する1つ以上のプロセスを作成します。Application Expressエンジンですべての操作を透過的に実行するかわりに、操作の制御はユーザーが行います。

たとえば、3つのアイテムを持つフォームが存在すると想定します。

- P1_ID: 表に現在表示されている行の主キーを格納するための非表示アイテム。

- P1_FIRST_NAME: ユーザー入力用のテキスト・フィールド。

- P1_LAST_NAME: ユーザー入力用のテキスト・フィールド。

また、「挿入」、「更新」および「削除」というラベルの3つのボタンがあるとします。さらに、3つの列id、first_nameおよびlast_nameを含む表Tがあるとします。この表には、値を指定しなかった場合に自動的にID列が移入されるトリガーがあります。

新しい行の挿入を処理するには、ユーザーが「挿入」ボタンをクリックしたときに実行されるPL/SQLの条件付きプロセスを作成します。次に例を示します。

BEGIN
INSERT INTO T ( first_name, last_name )
VALUES  (:P1_FIRST_NAME, :P1_LAST_NAME);
END;

行の更新を処理するには、PL/SQLの条件付きプロセスをもう1つ作成します。次に例を示します。

BEGIN
UPDATE T
SET first_name = :P1_FIRST_NAME,
last_name = :P1_LAST_NAME
WHERE ID = :P1_ID;
END;

行の削除を処理するには、ユーザーが「削除」ボタンをクリックしたときに実行される条件付きプロセスを作成します。次に例を示します。

BEGIN
DELETE FROM T
WHERE ID = :P1_ID;
END;

PL/SQL APIを使用したフォーム値の処理

アプリケーションによっては、表へのすべてのアクセスを単一または少数のPL/SQLパッケージにまとめて処理することが適しています。DML操作を処理するパッケージを作成した場合は、このパッケージのプロシージャおよびファンクションを、送信後のPL/SQLプロセスからコールして、リクエストの挿入、更新および削除を処理できます。

フォームの移入

Oracle Application Expressでは、ロード時またはApplication Expressエンジンによるページのレンダリング時にフォームが移入されます。フォームを移入するには、次のステップを実行します。

- プロセスを作成し、タイプを「行の自動フェッチ」に定義します。

- 非表示のセッション・ステート・アイテムを参照することによって、フォームを手動で移入します。

行の自動フェッチ・プロセスを作成するには、次のステップを実行します。

1. 該当する「ページ定義」にナビゲートします。「「ページ定義」へのアクセス」を参照してください。

2. ページ・プロセスの作成ウィザードにアクセスします。

- ツリー・ビュー: 該当する場所で、右クリックして「プロセスの作成」をクリックします。

- コンポーネント・ビュー: 「プロセス」で、「作成」アイコンをクリックします。

3. プロセス・タイプの「データ操作」を選択します。

4. プロセス・カテゴリの「行の自動フェッチ」を選択します。

5. 次のプロセス属性を指定します。

1. 「名前」フィールドで、プロセスを識別するための名前を入力します。

2. 「順序」フィールドで、順序番号を指定します。

3. 「ポイント」リストから、適切なプロセス・ポイントを選択します。

4. 「タイプ」リストから、「行の自動フェッチ」を選択します。

6. 画面に表示されるステップに従います。

非表示のセッション・ステート・アイテムを参照することによって、フォームを手動で移入することもできます。たとえば、PL/SQLタイプのOracle Application Expressプロセスの次のコードでは、enameおよびsalの値が設定されます。この例では、P2_IDという名前の非表示のセッション・ステートを参照することによってフォームを手動で移入する方法も示します。

FOR C1 in (SELECT ename, sal
FROM emp WHERE ID=:P2_ID)
LOOP
:P2_ENAME := C1.ename;
:P2_SAL := C1.sal;
END LOOP;

この例では、次のとおりです。

- C1は、暗黙カーソルです。

- P2_IDの値は、設定済です。

- このプロセスのプロセス・ポイントは、「ロード時 - リージョンの前」またはこれ以前に実行するように設定されます。

フォームでのユーザー入力の検証

検証を使用すると、ユーザーが入力したデータを処理前に確認できます。検証および関連するエラー・メッセージを作成したら、これらを特定のアイテムと関連付けることができます。検証エラー・メッセージをインライン表示(検証が実行されたページで表示)するか、個別のエラー・ページで表示するかを選択できます。

インラインのエラー・メッセージを作成するには、次のステップを実行します。

- 検証を作成し、エラー・メッセージ・テキストを指定します。詳細は、「アイテムとページ検証の作成」を参照してください。

- 検証を特定のアイテムと関連付けます。

内容は次のとおりです。

- 検証と特定のアイテムとの関連付け

- エラー・メッセージについて

検証と特定のアイテムとの関連付け

アイテムを検証と関連付け、エラー・メッセージ・テキストを指定するには、次のステップを実行します。

1. 該当する「ページ定義」にナビゲートします。「「ページ定義」へのアクセス」を参照してください。

2. ページ検証の編集ページにナビゲートします。

- ツリー・ビュー: 検証名を右クリックし、「編集」をクリックします。

- コンポーネント・ビュー: 「検証」で、関連付ける検証アイテムを選択します。

検証の属性ページが表示されます。

3. 「エラー・メッセージ」までスクロールします。

- エラー・メッセージ表示位置: 表示位置を検証します。

- 関連付けられたアイテム: 対象の検証と関連付けるアイテムを選択します。

4. 「変更の適用」をクリックします。

エラー・メッセージについて

「エラー・メッセージ表示位置」で、検証エラー・メッセージの表示位置が指定されます。検証エラー・メッセージは、エラー・ページに表示したり、既存ページ内にインラインで表示できます。インライン・エラー・メッセージは、通知領域(ページ・テンプレートの一部として定義される)に表示したり、フィールド・ラベル内に表示できます。

残りのすべての検証を含むプロセスを停止するハード・エラーを作成する場合は、エラー・ページにエラーを表示する必要があります。

カレンダの作成

アプリケーション・ビルダーには月次、週次、日次およびリスト表示のカレンダを生成するための組込みウィザードが含まれています。カレンダのベースとなる表を一度指定すると、特定の列に格納された情報へのドリルダウン・リンクを作成して、ドラッグ・アンド・ドロップ機能を有効化できます。

注意:
Oracle Application Expressは、1ページにつき1つのみのカレンダの作成をサポートします。

内容は次のとおりです。

- カレンダの作成について

- サンプル・カレンダの表示

- 簡易カレンダの作成

- SQLカレンダの作成

- カレンダ属性の編集

- 追加および編集機能を含めるように既存のカレンダを編集

- 既存のカレンダでのデータのドラッグ・アンド・ドロップの有効化

- カレンダ・タイトルの編集

- 以前のリリースで作成されたカレンダのアップグレード

- SQLカレンダへの簡易カレンダの変換

カレンダの作成について

アプリケーション・ビルダーでは2つのカレンダ・タイプがサポートされています。

- 簡易カレンダ: 指定したスキーマ、表および列に基づくカレンダを作成します。ウィザードによって、日付列および表示列の選択を求めるプロンプトが表示されます。「簡易カレンダの作成」を参照してください。

- SQLカレンダ: 指定したSQL問合せに基づくカレンダを作成します。SQL SELECT文には、少なくとも2つの列(日付列および表示列)が含まれている必要があります。「SQLカレンダの作成」を参照してください。

カレンダの作成方法は、既存のページにカレンダを追加するか、新しいページにカレンダを追加するかによって異なります。カレンダを作成する際は、次の点に注意してください。

- 各ページに1つのカレンダのみ作成できます。カレンダには、日次、週次および月次表示を含めることができます。

- 日付列は、エントリが含まれるカレンダ上の日付を決定します。

- 表示列は、カレンダを表示する特定の行を定義します。

関連項目:
「カレンダ表示」および

ドラッグ・アンド・ドロップ機能の追加について

簡易カレンダでドラッグ・アンド・ドロップ機能を有効化する場合、この機能を実装するオンデマンド・プロセスが、カレンダの生成プロセスにより自動的に作成されます。ただし、新しいページでSQLカレンダを作成する場合は、「ドラッグ・アンド・ドロップの有効化」オプションは表示されません。この機能を有効化するには、SQLカレンダ・ページを作成してから、ページを編集してドラッグ・アンド・ドロップを有効化します。詳細は、「既存のカレンダでのデータのドラッグ・アンド・ドロップの有効化」を参照してください。

サポートされているカレンダ置換文字列

アプリケーション・ビルダーでは、多くの日付書式置換文字列がサポートされています。「カレンダ・テンプレート」ページで、サポートされている置換文字列の完全なリストを表示できます。

カレンダでサポートされている置換文字列のリストを表示するには、次のステップを実行します。

1. 該当するカレンダ・テンプレートにナビゲートします。

2. ページの右側の「置換文字列」リストを表示します。

関連項目:
テーマおよびテンプレートの管理

サンプル・カレンダの表示

次に、ITプロジェクトのサンプル・カレンダを示します。

図calendar_example.gifの説明

このカレンダには次のボタンが含まれています。

- 月: すべてのプロジェクトを月単位で表示します。

- 週: プロジェクトを週単位で表示します。

- 日: プロジェクトを日単位で表示します。

- リスト: すべてのプロジェクトをリストで表示します。

- 前へ: 前のページにナビゲートします。

- 今日: 当日を表示します。

- 次へ: 次のページにナビゲートします。

前の例で、カレンダ・エントリをドラッグ・アンド・ドロップして、別の日付に移動できます。

簡易カレンダの作成

簡易カレンダは、指定したスキーマ、表および列に基づくカレンダを作成します。ウィザードによって、日付列および表示列の選択を求めるプロンプトが表示されます。

内容は次のとおりです。

- 既存ページへの簡易カレンダの追加

- 新規ページへの簡易カレンダの追加

既存ページへの簡易カレンダの追加

既存ページに簡易カレンダを追加するには、次のステップを実行します。

1. 「カレンダ」リージョンを作成するには、次のステップを実行します。

1. 「ページ定義」にナビゲートします。「「ページ定義」へのアクセス」を参照してください。

2. 「ページ定義」で、新しい「カレンダ」リージョンを作成します。

- ツリー・ビュー: 「ページ・レンダリング」で、「リージョン」を右クリックし、「作成」を選択します。

- コンポーネント・ビュー: 「リージョン」で、「作成」アイコンをクリックします。

「リージョンの作成」ウィザードが表示されます。

3. 「カレンダ」を選択して、「次へ」をクリックします。

2. 「実装」で、「簡易カレンダ」を選択し、「次へ」をクリックします。

3. 「リージョン属性」で、次の項目を指定します。

1. タイトル: リージョンのタイトルを入力します。選択するリージョン・テンプレートにリージョン・タイトルが表示される際に、このタイトルが表示されます。

2. リージョン・テンプレート: リージョンの外観を制御するテンプレートを選択します。

3. 親リージョン: 新しいリージョンが属する親リージョンを定義します。

4. 表示ポイント: このリージョンの表示ポイントを指定します。ページ・テンプレート位置およびページ・ボディ位置の2種類の表示ポイントが存在します。詳細は、オンライン・ヘルプを参照してください。

5. 順序: このコンポーネントの順序を指定します。これによって評価の順序が決まります。

6. 「次へ」をクリックします。

4. 「ソース」で、次の項目を指定します。

1. 所有者: カレンダの作成元の表を所有するデータベース・スキーマを選択します。

2. 表/ビューの名前: カレンダで使用する表を指定します。

3. 「次へ」をクリックします。

5. 「カレンダ属性」で、次の項目を指定します。

1. 日付列: エントリのカレンダへの配置に使用する日付として使用する列を指定します。

2. 表示列: カレンダに表示する列を指定します。

3. 日付書式: カレンダの日付の表示方法を指定します。オプションは次のとおりです。

- 日付のみ: 月次カレンダおよびリスト・カレンダが表示されます。

- 日付と時間: 月次、週次、日次およびリスト・カレンダが表示されます。

4. 主キー列: 表内の行を一意に識別する最初の列の名前を選択するか、ROWIDを選択します。ROWIDは、行の組込みのグローバル一意識別子です。次に例を示します。

EMPNO

5. ドラッグ・アンド・ドロップの有効化: カレンダ・データをカレンダ上の別の日付と時間にドラッグ・アンド・ドロップできるようにするかどうかを指定します。

6. 「次へ」をクリックします。

次に、カレンダ・エントリの「リンクの詳細」を定義します。「リンク・ターゲット」により、ユーザーがカレンダ・エントリを選択したときのリダイレクト先が決まります。選択された「リンク・ターゲット」により表示される属性が決まります。

6. 「リンクの詳細」で、次の操作を実行します。

1. リンク・ターゲット: カレンダ・エントリにリンク・ターゲットを含めるかどうかを指定します。カレンダ・エントリを選択すると、ユーザーはリンク・ターゲットにリダイレクトされます。オプションは次のとおりです。

- 新規編集ページの作成

- このアプリケーションのページ

- URL

- リンク・ターゲットの除外

2. 実行可能な操作: 実行できるデータ操作言語(DML)操作を指定します。カレンダ・データでのドラッグ・アンド・ドロップを有効化するには、「更新」を選択する必要があります。オプションは次のとおりです。

- 挿入

- 更新

- 削除

3. ページ番号: 作成するページの一意のページ番号を入力します。

4. ページ名: 作成するページのタイトルを入力します。

5. リージョン・テンプレート: 新しいカレンダ・リージョンのリージョン・テンプレートを選択します。

6. リージョン名: カレンダを含めるリージョンの名前を入力します。

7. 列の選択: フォームに含める列を選択します。目的の動作が行われるようにするには、「日付」列と「主キー」列をフォームに含めます。

8. リンクを次の場所で開く: URLまたはページを開く場所を指定します。

9. 「次へ」をクリックします。

7. 「プロセス・オプション」で、次の項目を指定します。

1. 「取消」ボタン・ラベル: 「取消」ボタンのラベルを入力します。

2. 「作成」ボタンの表示: ユーザーがフォームを使用した挿入操作を行えるかどうかを指定します。

3. 「作成」ボタン・ラベル: 「作成」ボタンのラベルを入力します。

4. 「保存」ボタンの表示: ユーザーがフォームを使用した更新操作を行えるかどうかを指定します。

5. 「保存」ボタン・ラベル: 「保存」ボタンのラベルを入力します。

6. 「削除」ボタンの表示: ユーザーがフォームを使用した削除操作を行えるかどうかを指定します。

7. 「削除」ボタン・ラベル: 「削除」ボタンのラベルを入力します。

8. 「次へ」を選択します。

8. 選択した内容を確認し、「作成」をクリックします。

新しいページへの簡易カレンダの追加

新しいページで簡易カレンダを作成するには、次のステップを実行します。

1. 次のようにして、カレンダ・ページを作成します。

1. 「ワークスペース」ホームページにナビゲートします。

2. 「アプリケーション・ビルダー」アイコンをクリックします。

3. アプリケーションを選択します。

4. 「ページの作成」をクリックします。
ページの作成ウィザードが表示されます。

2. 「カレンダ」を選択して、「次へ」をクリックします。

3. 「簡易カレンダ」を選択し、「次へ」をクリックします。

4. 「ページ属性」で、次のステップを実行します。

1. ページ番号: 新しいページ番号を指定すると、ウィザードによって新しいページが作成されます。既存のページ番号を指定すると、ウィザードによってコンポーネントがそのページに追加されます。

2. ページ名: 作成するページのタイトルを入力します。

3. リージョン・テンプレート: 新しいカレンダ・リージョンのリージョン・テンプレートを選択します。テンプレートでは、リージョンの外観を制御します。

4. リージョン名: カレンダを含めるリージョンの名前を入力します。

5. 表示タイプ: カレンダの動作を決定します。オプションは次のとおりです。

- 標準: ページが、関連するリクエストとともに送信されます。

- 部分ページ・リフレッシュ: 「カレンダ」リージョンのみがリフレッシュされます。

ヒント:
カレンダが作成されると、表示タイプは変更できません。表示タイプを変更するには、カレンダを削除してから、再作成する必要があります。

6. ブレッドクラム: ページでブレッドクラム・ナビゲーション・コントロールを使用するかどうか、およびどのブレッドクラム・ナビゲーション・コントロールを使用するかを選択します。

7. 「次へ」をクリックします。

5. 「タブ・オプション」で、タブ実装を指定し、「次へ」をクリックします。

6. 「ソース」で、次の項目を指定します。

1. 所有者: カレンダの作成元の表を所有するデータベース・スキーマを選択します。

2. 表/ビューの名前: カレンダで使用する表を指定します。

3. 「次へ」をクリックします。

7. 「カレンダ属性」で、次の項目を指定します。

1. 日付列: エントリのカレンダへの配置に使用する日付として使用する列を指定します。

2. 表示列: カレンダに表示する列を指定します。

3. 日付書式: カレンダの日付の表示方法を指定します。オプションは次のとおりです。

- 日付のみ: 結果は月次およびリスト・カレンダで表示されます。

- 日付と時間: 結果は月次、週次、日次およびリスト・カレンダで表示されます。

4. 主キー列: 表内の行を一意に識別する最初の列の名前を選択するか、ROWIDを選択します。
ROWIDは、行の組込みのグローバル一意識別子です。この列は、カレンダを使用した追加や編集およびドラッグ・アンド・ドロップに使用されます。次に例を示します。

EMPNO

5. カスタム日付範囲: カスタムの開始日および終了日を含めるかどうかを指定します。1か月を超える分を月次カレンダに表示できるようにする場合に、このオプションを使用します。

6. ドラッグ・アンド・ドロップの有効化: 「はい」または「いいえ」を選択します。カレンダ・データをカンレダ上の別の日付および時間にドラッグ・アンド・ドロップできるようにします。

ヒント:
「ドラッグ・アンド・ドロップの有効化」で「はい」を選択すると、ウィザードにより自動的にオンデマンド・プロセスが作成されます。

7. 「次へ」をクリックします。

次に、カレンダ・エントリの「リンクの詳細」を定義します。「リンク・ターゲット」により、ユーザーがカレンダ・エントリを選択したときのリダイレクト先が決まります。選択された「リンク・ターゲット」により、表示される属性が決まります。

8. 「リンクの詳細」で、次のステップを実行します。

1. リンク・ターゲット: カレンダ・エントリがリンク・ターゲットを持つかどうかを指定します。カレンダ・エントリを選択すると、ユーザーはリンク・ターゲットにリダイレクトされます。オプションは次のとおりです。

- 新規編集ページの作成

- このアプリケーションのページ

- URL

- リンク・ターゲットの除外

2. 実行可能な操作: 実行できるデータ操作言語(DML)操作を指定します。カレンダ・データのドラッグ・アンド・ドロップを有効化するには、「更新」を選択する必要があります。オプションは次のとおりです。

- 挿入

- 更新

- 削除

3. ページ番号: 作成するページの一意のページ番号を入力します。

4. ページ名: 作成するページのタイトルを入力します。

5. リージョン名: カレンダを含めるリージョンの名前を入力します。

6. リージョン・テンプレート: 新しいカレンダ・リージョンのリージョン・テンプレートを選択します。

7. リージョン名: カレンダを含めるリージョンの名前を入力します。

8. 列の選択: フォームに含める列を選択します。目的の動作が行われるようにするには、「日付」列と「主キー」列をフォームに含めます。

9. 「次へ」をクリックします。

9. 「プロセス・オプション」で、次の項目を指定します。

1. 「取消」ボタン・ラベル: 「取消」ボタンのラベルを入力します。

2. 「作成」ボタンの表示: ユーザーがフォームを使用した挿入操作を行えるかどうかを指定します。

3. 「作成」ボタン・ラベル: 「作成」ボタンのラベルを入力します。

4. 「保存」ボタンの表示: ユーザーがフォームを使用した更新操作を行えるかどうかを指定します。

5. 「保存」ボタン・ラベル: 「保存」ボタンのラベルを入力します。

6. 「削除」ボタンの表示: ユーザーがフォームを使用した削除操作を行えるかどうかを指定します。

7. 「削除」ボタン・ラベル: 「削除」ボタンのラベルを入力します。

8. 「次へ」を選択します。

10. 選択した内容を確認し、「作成」をクリックします。

関連項目:
「カレンダ属性の編集」

SQLカレンダの作成

SQLカレンダは、指定したSQL問合せに基づくカレンダを作成します。SQLカレンダを作成する場合は、日付を選択して列を表示する必要があります。また、SQLソースを使用しているため、主キーを明示的に指定する必要があります。

内容は次のとおりです。

- 既存ページへのSQLカレンダの追加

- 新しいページへのSQLカレンダの追加

ヒント:
SQLカレンダの作成時に、ドラッグ・アンド・ドロップ機能を有効化するために、オンデマンド・プロセスを手動で作成する必要があります。「既存のカレンダでのデータのドラッグ・アンド・ドロップの有効化」を参照してください。

既存ページへのSQLカレンダの追加

既存ページにSQLカレンダを追加するには、次のステップを実行します。

1. 「カレンダ」リージョンを作成するには、次のステップを実行します。

1. 「ページ定義」にナビゲートします。「「ページ定義」へのアクセス」を参照してください。

2. 「ページ定義」で、新しい「カレンダ」リージョンを作成します。

- ツリー・ビュー: 「ページ・レンダリング」で、「リージョン」を右クリックし、「作成」を選択します。

- コンポーネント・ビュー: 「リージョン」で、「作成」アイコンをクリックします。

「リージョンの作成」ウィザードが表示されます。

3. 「カレンダ」を選択して、「次へ」をクリックします。

2. 「実装」で、「SQLカレンダ」を選択し、「次へ」をクリックします。

3. 「リージョン属性」で、次の項目を指定します。

1. タイトル: リージョンのタイトルを入力します。選択するリージョン・テンプレートにリージョン・タイトルが表示される際に、このタイトルが表示されます。

2. リージョン・テンプレート: リージョンの外観を制御するテンプレートを選択します。

3. 親リージョン: 新しいリージョンが属する親リージョンを定義します。

4. 表示ポイント: このリージョンの表示ポイントを指定します。ページ・テンプレート位置およびページ・ボディ位置の2種類の表示ポイントが存在します。詳細は、オンライン・ヘルプを参照してください。

5. 順序: このコンポーネントの順序を指定します。これによって評価の順序が決まります。

6. 「次へ」をクリックします。

4. 「ソース」で、次の項目を指定します。

1. SQL問合せの入力: カレンダで使用するSELECT文を入力します。
次の構文を使用します。

SELECT id, name, date
FROM ...

次のことに注意してください。

- 少なくとも2列を含める必要があり、そのうちの1つはDATE列である必要があります。最初の列は、データ操作言語(DML)操作を管理するために使用される主キー列を識別します。

- ページ下部で例を確認してください。

2. 「次へ」をクリックします。

5. 「カレンダ属性」で、次の項目を指定します。

1. 日付列: カレンダ上のエントリの配置に使用する日付として使用する列を指定します。

2. 表示列: カレンダに表示する列を指定します。

3. 日付書式: カレンダの日付の表示方法を指定します。オプションは次のとおりです。

- 日付のみ: 結果は月次およびリスト・カレンダで表示されます。

- 日付と時間: 結果は月次、週次、日次およびリスト・カレンダで表示されます。

4. 主キー列: 表内の行を一意に識別する最初の列の名前を選択するか、ROWIDを選択します。ROWIDは、行の組込みのグローバル一意識別子です。次に例を示します。

EMPNO

5. カスタム日付範囲: カスタムの開始日および終了日を含めるかどうかを指定します。1か月を超える分を月次カレンダに表示できるようにする場合に、このオプションを使用します。

6. ドラッグ・アンド・ドロップの有効化: 「はい」または「いいえ」を選択します。カレンダ・データをカレンダ上の別の日付および時間にドラッグ・アンド・ドロップできるようにします。

ヒント:
SQLカレンダの作成時に、ドラッグ・アンド・ドロップ機能を有効化するために、オンデマンド・プロセスを手動で作成する必要があります。「既存のカレンダでのデータのドラッグ・アンド・ドロップの有効化」を参照してください。

7. 「次へ」をクリックします。

次に、カレンダ・エントリの「リンクの詳細」を定義します。「リンク・ターゲット」により、ユーザーがカレンダ・エントリを選択したときのリダイレクト先が決まります。選択された「リンク・ターゲット」により、表示される属性が決まります。

6. 「リンクの詳細」で、次のステップを実行します。

1. リンク・ターゲット: カレンダ・エントリがリンク・ターゲットを持つかどうかを指定します。カレンダ・エントリを選択すると、ユーザーはリンク・ターゲットにリダイレクトされます。オプションは次のとおりです。

- 新規編集ページの作成

- このアプリケーションのページ

- URL

- リンク・ターゲットの除外

2. 実行可能な操作: 実行できるデータ操作言語(DML)操作を指定します。カレンダ・データのドラッグ・アンド・ドロップを有効化するには、「更新」を選択する必要があります。オプションは次のとおりです。

- 挿入

- 更新

- 削除

3. ページ番号: 作成するページの一意のページ番号を入力します。

4. ページ名: 作成するページのタイトルを入力します。

5. リージョン・テンプレート: 新しいカレンダ・リージョンのリージョン・テンプレートを選択します。

6. リージョン名: カレンダを含めるリージョンの名前を入力します。

7. 所有者: 表を所有するスキーマを指定します。

8. 表/ビューの名前: このカレンダのベースにするデータベース・オブジェクト(表またはビュー)を選択します。

9. 日付列: カレンダにエントリを配置する際に、日付として使用する列を指定します。

10. 主キーのタイプ: オプションには次のものがあります。

- データベースで管理(ROWID): フォームは、ROWID擬似列を使用して、更新および削除する行を識別します。

- 主キー列の選択: ソース表の主キー列を使用します。

11. 列の選択: フォームに含める列を選択します。必要な機能のフォームには日付および主キー列を含める必要があります。

12. 「リンクを次の場所で開く」で、URLまたはページを開く場所を選択します。

13. 「次へ」をクリックします。

7. 「プロセス・オプション」で、次の項目を指定します。

1. 「取消」ボタン・ラベル: 「取消」ボタンのラベルを入力します。

2. 「作成」ボタンの表示: ユーザーがフォームを使用した挿入操作を行えるかどうかを指定します。

3. 「作成」ボタン・ラベル: 「作成」ボタンのラベルを入力します。

4. 「保存」ボタンの表示: ユーザーがフォームを使用した更新操作を行えるかどうかを指定します。

5. 「保存」ボタン・ラベル: 「保存」ボタンのラベルを入力します。

6. 「削除」ボタンの表示: ユーザーがフォームを使用した削除操作を行えるかどうかを指定します。

7. 「削除」ボタン・ラベル: 「削除」ボタンのラベルを入力します。

8. 「次へ」を選択します。

8. 選択した内容を確認し、「作成」をクリックします。

新しいページへのSQLカレンダの追加

新しいページで簡易カレンダを作成するには、次のステップを実行します。

1. 次のようにして、カレンダ・ページを作成します。

1. 「ワークスペース」ホームページにナビゲートします。

2. 「アプリケーション・ビルダー」アイコンをクリックします。

3. アプリケーションを選択します。

4. 「ページの作成」をクリックします。

5. 「カレンダ」を選択して、「次へ」をクリックします。

2. 「ページ」で、「SQLカレンダ」を選択し、「次へ」をクリックします。

3. 「ページ属性」で、次のステップを実行します。

1. ページ番号: 新しいページ番号を指定すると、ウィザードによって新しいページが作成されます。既存のページ番号を指定した場合、ウィザードによってそのページにコンポーネントが追加されます。

2. ページ名: 作成するページのタイトルを入力します。

3. リージョン・テンプレート: 新しいカレンダ・リージョンのリージョン・テンプレートを選択します。

4. リージョン名: カレンダを含めるリージョンの名前を入力します。

5. 表示タイプ: カレンダの動作を決定します。オプションは次のとおりです。

- 標準: ページが、関連するリクエストとともに送信されます。

- 部分ページ・リフレッシュ: 「カレンダ」リージョンのみがリフレッシュされます。

ヒント:
カレンダが作成されると、表示タイプは変更できません。表示タイプを変更するには、カレンダを削除してから、再作成する必要があります。

6. ブレッドクラム: ページでブレッドクラム・ナビゲーション・コントロールを使用するかどうか、およびどのブレッドクラム・ナビゲーション・コントロールを使用するかを選択します。

7. 「次へ」をクリックします。

4. 「タブ・オプション」で、タブ実装を指定し、「次へ」をクリックします。

5. 「ソース」で、次の項目を指定します。

1. SQL問合せの入力: カレンダで使用するSELECT文を入力します。
次の構文を使用します。

SELECT id, name, date
FROM ...

次のことに注意してください。

- 少なくとも2列を含める必要があり、そのうちの1つはDATE列である必要があります。最初の列は、データ操作言語(DML)操作を管理するために使用される主キー列を識別します。

- ページ下部で例を確認してください。

2. 「次へ」をクリックします。

6. 「カレンダ属性」で、次の項目を指定します。

1. 日付列: エントリのカレンダへの配置に使用する日付として使用する列を指定します。

2. 表示列: カレンダに表示する列を指定します。

3. 日付書式: カレンダの日付の表示方法を指定します。オプションは次のとおりです。

- 日付のみ: 結果は月次およびリスト・カレンダで表示されます。

- 日付と時間: 結果は月次、週次、日次およびリスト・カレンダで表示されます。

4. 主キー列: 表内の行を一意に識別する最初の列の名前を選択するか、ROWIDを選択します。ROWIDは、行の組込みのグローバル一意識別子です。

5. カスタム日付範囲: カスタムの開始日および終了日を含めるかどうかを指定します。1か月を超える分を月次カレンダに表示できるようにする場合に、このオプションを使用します。

6. ドラッグ・アンド・ドロップの有効化: カレンダの他の日付および時刻へのカレンダ・データのドラッグ・アンド・ドロップを有効にするかどうかを指定します。

7. 「次へ」をクリックします。

次に、カレンダ・エントリの「リンクの詳細」を定義します。「リンク・ターゲット」により、ユーザーがカレンダ・エントリを選択したときのリダイレクト先が決まります。選択された「リンク・ターゲット」により、表示される属性が決まります。

7. 「リンクの詳細」で、次のステップを実行します。

1. リンク・ターゲット: カレンダ・エントリがリンク・ターゲットを持つかどうかを指定します。カレンダ・エントリを選択すると、ユーザーはリンク・ターゲットにリダイレクトされます。オプションは次のとおりです。

- 新規編集ページの作成

- このアプリケーションのページ

- URL

- リンク・ターゲットの除外

2. 実行可能な操作: 実行できるデータ操作言語(DML)操作を指定します。カレンダ・データのドラッグ・アンド・ドロップを有効化するには、「更新」を選択する必要があります。オプションは次のとおりです。

- 挿入

- 更新

- 削除

3. ページ番号: 作成するページの一意のページ番号を入力します。

4. ページ名: 作成するページのタイトルを入力します。

5. リージョン・テンプレート: 新しいカレンダ・リージョンのリージョン・テンプレートを選択します。

6. リージョン名: カレンダを含めるリージョンの名前を入力します。

7. 所有者: 表を所有するスキーマを指定します。

8. 表/ビューの名前: このカレンダのベースにするデータベース・オブジェクト(表またはビュー)を選択します。

9. 日付列: カレンダにエントリを配置する際に、日付として使用する列を指定します。

10. 主キーのタイプ: オプションには次のものがあります。

- データベースで管理(ROWID): フォームは、ROWID擬似列を使用して、更新および削除する行を識別します。

- 主キー列の選択: ソース表の主キー列を使用します。

11. 列の選択: フォームに含める列を選択します。必要な機能のフォームには日付および主キー列を含める必要があります。

12. 「リンクを次の場所で開く」で、URLまたはページを開く場所を選択します。

13. 「次へ」をクリックします。

8. 「プロセス・オプション」で、次の項目を指定します。

1. 「取消」ボタン・ラベル: 「取消」ボタンのラベルを入力します。

2. 「作成」ボタンの表示: ユーザーがフォームを使用した挿入操作を行えるかどうかを指定します。

3. 「作成」ボタン・ラベル: 「作成」ボタンのラベルを入力します。

4. 「保存」ボタンの表示: ユーザーがフォームを使用した更新操作を行えるかどうかを指定します。

5. 「保存」ボタン・ラベル: 「保存」ボタンのラベルを入力します。

6. 「削除」ボタンの表示: ユーザーがフォームを使用した削除操作を行えるかどうかを指定します。

7. 「削除」ボタン・ラベル: 「削除」ボタンのラベルを入力します。

8. 「次へ」を選択します。

9. 選択した内容を確認し、「作成」をクリックします。

関連項目:
「カレンダ属性の編集」

カレンダ属性の編集

作成したカレンダは、カレンダ属性ページで属性を編集することで表示を変更できます。

カレンダの表示を無効にするには、カレンダ・ページで、「月」、「週」または「日」ボタンを削除する必要があります。

内容は次のとおりです。

- カレンダ属性ページへのアクセス

- カレンダ属性ページについて

カレンダ属性ページへのアクセス

カレンダ属性ページにアクセスするには、次のステップを実行します。

1. 該当する「ページ定義」にナビゲートします。「「ページ定義」へのアクセス」を参照してください。

2. カレンダ属性ページにアクセスします。

- ツリー・ビュー: 「ページ・レンダリング」で、リージョン名をダブルクリックします。

- コンポーネント・ビュー: 「リージョン」で、リージョン名を選択します。
リージョン定義が表示されます。

3. 「カレンダ属性」をクリックします。

4. 対象となる属性を編集します。ページ上の特定のアイテムの詳細を表示するには、アイテム・ラベルをクリックします。
ヘルプが使用可能な場合は、アイテムにカーソルをあわせると、カーソルが疑問符付きの矢印に変わります。

5. 「変更の適用」をクリックします。

関連項目:
「カレンダ属性ページについて」および「フィールドレベル・ヘルプについて」

ナビゲーションの選択肢について

カレンダ属性ページはセクションに分かれています。

これらのセクションにアクセスするには、ページをスクロールするか、ページ上部のナビゲーション・ボタンをクリックします。ページ上部のボタンを選択すると、選択されたセクションが表示され、その他のセクションはすべて一時的に非表示になります。ページのすべてのセクションを表示するには、「すべて表示」をクリックします。

カレンダ属性ページについて

次のトピックではカレンダ属性ページの各セクションを説明します。これらの属性を使用することで一般的なカレンダ書式設定の指定、カレンダに含まれる日付の定義、もしくはカレンダの列または日付へのリンクの作成を実行できます。

カレンダ表示

「カレンダ表示」を使用して、カレンダ・テンプレート、日付列および一般的なカレンダ書式設定を指定できます。表10-2に、「カレンダ表示」属性を示します。

表10-2 「カレンダ表示」属性

属性

説明

カレンダ・テンプレート

Application Expressエンジンによってカレンダがレンダリングされるときに使用されるテンプレートを決定します。

簡易SQL表の所有者

カレンダのベースにする表のデータベース所有者を示します。

簡易SQL表

カレンダのベースにするデータベース表を示します。

日付列

カレンダに配置する日付を含む表または問合せからの列を定義します。

日付書式

カレンダの日付の表示方法を指定します。オプションは次のとおりです。

- 日付のみ

- 日付と時間

日付アイテム

カレンダの基になる日付を保持するアイテムを定義します。

終了日アイテム

「カスタム」タイプのカレンダのベースになる終了日を保持するアイテムを指定します。

カレンダ・タイプ列

カレンダ・タイプを保持するアイテムを指定します。

表示タイプ

表示タイプを定義します。オプションは次のとおりです。

- 列

- カスタム

- 表示値なし

「表示タイプ」が「列」の場合、「表示列」属性を使用して、月次カレンダの日付のセルに表示する列を選択します。

「表示タイプ」が「カスタム」の場合、「列の書式」に、HTML式とサポートされている置換文字列を使用して、カスタム列の書式を入力します。

表示列

「表示タイプ」が「列」に設定されている場合は、月次カレンダの日付セルに表示する列を選択します。複数の列を表示するには、表示タイプを変更します。

主キー列

カレンダを使用してデータを編集するときに渡される主キー列の値。この値は、「列」リンク・アイテム値が#PRIMARY_KEY_VALUE#の場合にのみ、ターゲット・ページに渡されます。

列書式

対象の列に表示するHTML式を入力します。HTMLで列値を示すには、#COLUMN#構文を使用します。次に例を示します。

#EMPLOYEE_NAME#

次の例では、列にイメージを表示する方法を示します。

<img src="#IMAGE_NAME#">

関連項目:
「サポートされているカレンダ置換文字列」

表示属性

「表示属性」を使用して、カレンダに含める日付を定義します。表10-3に、「表示」属性を示します。

表10-3 「表示」属性

属性

説明

間隔の最初から開始

カレンダの開始時期を決定します。このオプションを選択すると、期間全体(たとえば、1か月間)のカレンダが作成されます。次に例を示します。

- 「間隔の最初から開始」を選択した場合、6月15日に月次カレンダを表示すると、6月1日から6月30日のカレンダが作成されます。

- 「間隔の最初から開始」を選択しなかった場合、6月15日に月次カレンダを表示すると、6月15日から6月30日のカレンダが作成されます。

月次カレンダの週の開始

月次表示のカレンダの開始曜日を決定します。

週次カレンダの開始日

週次カレンダの開始日を選択します。

週次カレンダの終了日

週次カレンダの終了日を選択します。

時間書式

時間書式を選択します。時間表示を12時間表示と24時間表示のどちらにするかを決定します。

開始時間

週次カレンダおよび日次カレンダを表示する開始時間を入力します。

終了時間

週次カレンダおよび日次カレンダを表示する終了時間を入力します。

データ背景色

カレンダに表示するこのデータの背景色を指定します。

データ・テキストの色

カレンダに表示するデータのテキストの色を指定します。

カスタム・ビュー日数

カスタム・カレンダに表示する日数の合計を入力します。

列リンク

「列リンク」を使用して、カレンダに表示するエントリ上のリンクを作成します。

これらの値によりセッション・ステートを設定するには、次のステップを実行します。

1. 該当するカレンダ属性ページにナビゲートします。「カレンダ属性ページへのアクセス」を参照してください。

2. 「列リンク」までスクロールします。

3. 「ターゲット」から、「このアプリケーションのページ」を選択します。

4. 「リンクを次の場所で開く」で、URLまたはページを開く場所を選択します。オプションは次のとおりです。

- 同じウィンドウ

- ポップアップ・ウィンドウ

5. 「ページ」で、ターゲット・ページ番号を指定します。このページのページ区切りをリセットするには、「このページのページ区切りをリセット)」を選択します。

6. 「リクエスト」で、REQUESTと呼ばれる組込みアプリケーション・アイテムのテキストを入力します。これは、クリックしたボタンの名前で設定されるアイテムでもあります。

7. 「キャッシュのクリア」で、キャッシュをクリアするページ(ページ番号)を指定します。ページ番号をカンマで区切ってリストすることによって、複数のページを指定します。
「次のアイテムを設定」と「次の値を使用」という2つの属性を使用して、セッション・ステートの設定(リストしたアイテムへの値の指定)を行うことができます。

8. これらの値によりセッション・ステートを設定するには、次のステップを実行します。

1. 「次のアイテムを設定」で、セッション・ステートを設定するアイテム名をカンマで区切って入力します。

2. 「次の値を使用」で、前述のステップで指定したアイテムの値をカンマで区切って入力します。
静的な値または置換構文(&APP_ITEM_Name.など)を指定できます。URLのf?p=に渡されるアイテム値にコロン(:)は使用できないことに注意してください。また、バックスラッシュでアイテム値全体を囲んだ場合(\1234,56\など)を除いて、カンマも使用しないでください。

9. 「変更の適用」をクリックします。

関連項目:
「サポートされているカレンダ置換文字列」

URLへの列リンクを作成するには、次のステップを実行します。

1. 該当するカレンダ属性ページにナビゲートします。

2. 「列リンク」までスクロールします。

3. 「ターゲット」から、「URL」を選択します。

4. 「URLターゲット」で、該当するアドレスを入力します。
URLへの列リンクを使用して、次のことを行えます。

- 問合せにより定義されたURLにリンクします。たとえば、次のようにします。

#URL#

ここで、URLは適切なURLを定義する問合せの列別名です。

- 問合せから、コールするページに値を渡します。たとえば、次のようにします。

f?p=&FLOW_ID.:3:&SESSION.::&DEBUG.:3:P3_EVENT_ID,P3_PREV_PAGE:#EVENT_ID#,1

ここで、EVENT_IDは問合せの列の別名です。

5. 「変更の適用」をクリックします。

関連項目:
「追加および編集機能を含めるように既存のカレンダを編集」

日付のリンク

「日付リンク」を使用して、カレンダの日付にリンクを作成します。この属性によって、カレンダの実際の数字(日付)にリンクが作成されます。

別のページへの日付リンクを作成するには、次のステップを実行します。

1. 該当するカレンダ属性ページにナビゲートします。「カレンダ属性ページへのアクセス」を参照してください。

2. 「日付のリンク」までスクロールします。

3. 「ターゲット」から、「このアプリケーションのページ」を選択します。

4. 「ページ」で、ターゲット・ページ番号を指定します。
このページのページ区切りをリセットするには、「このページのページ区切りをリセット)」を選択します。

5. 「リクエスト」で、REQUESTと呼ばれる組込みアプリケーション・アイテムのテキストを入力します。これは、クリックしたボタンの名前で設定されるアイテムでもあります。

6. 「キャッシュのクリア」で、キャッシュをクリアするページ(ページ番号)を指定します。ページ番号をカンマで区切ってリストすることによって、複数のページを指定します。
「次のアイテムを設定」と「次の値を使用」という2つの属性を使用して、セッション・ステートの設定(リストしたアイテムへの値の指定)を行うことができます。

7. セッション・ステートを設定するには、次のステップを実行します。

1. 「次のアイテムを設定」で、セッション・ステートを設定するアイテム名をカンマで区切って入力します。

2. 「次の値を使用」で、前述のステップで指定したアイテムの値をカンマで区切って入力します。
静的な値または置換構文(&APP_ITEM_Name.など)を指定できます。URLのf?p=に渡されるアイテム値にコロン(:)は使用できないことに注意してください。また、バックスラッシュでアイテム値全体を囲んだ場合(\1234,56\など)を除いて、カンマも使用しないでください。

8. 「変更の適用」をクリックします。

URLへの日付リンクを作成するには、次のステップを実行します。

1. 該当するカレンダ属性ページにナビゲートします。

2. 「日付のリンク」までスクロールします。

3. 「ターゲット」から、「URL」を選択します。

4. 「URLターゲット」で、適切なアドレスを入力します。

5. 「変更の適用」をクリックします。

追加および編集機能を含めるように既存のカレンダを編集

追加および編集機能を含めるように既存のカレンダを編集するには、次のステップを実行します。

1. 該当するカレンダ属性ページにナビゲートします。「カレンダ属性ページへのアクセス」を参照してください。

2. 「列リンク」までスクロールします。「列リンク」で、次のステップを実行します。

1. ターゲットは: 「このアプリケーションのページ」を選択します。

2. リンクを次の場所で開く: URLまたはページを開く場所を選択します。オプションは次のとおりです。

- 同じウィンドウ

- ポップアップ・ウィンドウ

3. ページ: フォームのページ番号を指定します。

4. 次のアイテムを設定: ターゲット・フォーム・ページから主キーおよび日付列を選択します。

ヒント:
選択した日付列にはRRRRMMDDHH24MISSという書式マスクが必要です(カレンダはこの書式で日付を渡すため)。
日付アイテムの書式マスクを変更しない場合は、前述の書式マスクを持つ非表示のアイテムをフォーム・ページに作成する必要があります(この非表示のアイテムは、日付値を受け入れる日付アイテムとして選択してください)。

5. 次の値を使用: 主キー値の置換文字列#PRIMARY_KEY_VALUE#と#DATE_VALUE#を入力します。たとえば、次のようにします。

#PRIMARY_KEY_VALUE#,#DATE_VALUE#

3. 「カレンダ表示」まで上にスクロールします。
「主キー列」で、カレンダ・データの編集時に渡す値を選択します。この値は、前述のステップで指定した#PRIMARY_KEY_VALUE#に置換されます。

4. 「変更の適用」をクリックします。

日付列の書式マスクについて

カレンダは特定の書式で日付を渡すため、選択した日付列がRRRRMMDDHH24MISSという書式マスクを持っている必要があります。日付アイテムの書式マスクを変更しない場合は、前述の書式マスクを持つ非表示のアイテムをフォーム・ページに作成する必要があります(この非表示のアイテムは、日付値を受け入れる日付アイテムとして選択してください)。日付列のデフォルト値を次のように変更する必要があります。

return to_char(to_date(<hidden item created>,'RRRRMMDDHH24MISS'),<Date item format mask>);

次に例を示します。

return to_char(to_date(:P130_HIREDATE_TMP,'RRRRMMDDHH24MISS'),:APP_DATE_TIME_FORMAT);

デフォルトのソース・タイプは値を戻すPL/SQLファンクションである必要があります。

既存のカレンダでのデータのドラッグ・アンド・ドロップの有効化

簡易カレンダでドラッグ・アンド・ドロップ機能を有効化する場合、この機能を実装するオンデマンド・プロセスが、カレンダの生成プロセスにより自動的に作成されます。このプロセスは、新しいページで簡易カレンダを作成するときに自動的に作成されます。既存のページで簡易カレンダを作成する場合は、新しいページ・プロセスを作成するプロンプトがウィザードから表示されます。詳細は、「簡易カレンダの作成」を参照してください。これらのウィザードは、このオンデマンド・プロセスの作成が自動的に容易になる唯一のウィザードです。

一方、新しいページでSQLカレンダを作成する場合は、「ドラッグ・アンド・ドロップの有効化」オプションは表示されません。この機能を有効化するには、オンデマンド・プロセスを作成し、SQLカレンダ・ページを作成してから、ページを編集してドラッグ・アンド・ドロップを有効化する必要があります。ベスト・プラクティスとして、カレンダの作成前にこのプロセスを作成しておくことをお薦めします。

カレンダ・データのドラッグ・アンド・ドロップのサポートを有効化するには、次のステップを実行します。

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. 「変更の適用」をクリックします。

カレンダ・タイトルの編集

カレンダの上部に表示されるタイトルは、リージョン・タイトルに対応しています。

リージョン・タイトルを変更するには、次のステップを実行します。

1. 「ページ定義」にナビゲートします。「「ページ定義」へのアクセス」を参照してください。

2. 「リージョン定義」にアクセスします。

- ツリー・ビュー: 「ページ・レンダリング」で、リージョン名をダブルクリックします。

- コンポーネント・ビュー: 「リージョン」で、リージョン名を選択します。

リージョン定義が表示されます。

3. 「指定」で、「タイトル」属性を編集します。

4. 「変更の適用」をクリックします。

以前のリリースで作成されたカレンダのアップグレード

デフォルトでは、Oracle Application Express 3.0で作成したカレンダは、日次、週次および月次表示になります。以前のリリースで作成したカレンダを更新してこれらの表示を含めた場合、次のことができます。

- 次のようにして、カレンダを作成します。

1. カレンダのページを作成して、以前のカレンダからSQL問合せを統合します。

2. アプリケーションで、以前のカレンダのページを新しいページと置換します。

- 次のようにして、テーマをアップグレードします。

1. 既存のテーマの識別番号の変更。「テーマ識別番号の変更」を参照してください。

2. テーマの再作成。「テーマの作成」を参照してください。

3. アプリケーションに新しいテーマの適用。「アクティブなテーマの切替え」を参照してください。

SQLカレンダへの簡易カレンダの変換

カレンダを作成するには、簡易カレンダを作成することが最も簡単な方法です。ただし、結果として作成された簡易カレンダが要件を満たさない場合は、そのカレンダをSQLカレンダに変換することができます。

簡易カレンダをSQLカレンダに変換するには、次のステップを実行します。

1. 該当するカレンダ属性ページにナビゲートします。「カレンダ属性ページへのアクセス」を参照してください。

2. 「タスク」リストで「SQLベースのカレンダに変換」をクリックします。
簡易カレンダがSQLカレンダに変換されると、「リージョン定義」に「リージョン・ソース」セクションが追加されます。「リージョン・ソース」には、カレンダを作成するSQL問合せが含まれます。「リージョン・ソース」へアクセスすることで、要件にあわせて問合せを編集できます。

マップの作成

アプリケーション・ビルダーには、デスクトップ・ユーザー・インタフェースを持つページでFlashマップを生成するための組込みウィザードが用意されています。Flashマップの作成方法は、マップを既存ページに追加するのか、マップを新しいページに追加するのかによって異なります。

内容は次のとおりです。

- Flashマップのサポートについて

- 既存ページへのFlashマップの追加

- 新しいページへのFlashマップの追加

- マップのSQL問合せの作成について

- Flashマップ属性の編集

- FlashマップでのカスタムXMLの使用

- 非同期更新の有効化

Flashマップのサポートについて

Oracle Application ExpressのFlashマップのサポートは、AnyChart AnyMap対話モード・マップ・コンポーネントをベースにしています。開発者は、Macromedia FlashベースのフレキシブルなソリューションであるAnyMapを使用して、地理関連データを視覚化できます。Flashマップはブラウザでレンダリングされ、使用するにはFlash Player 9以上が必要です。Anychartの詳細は、次を参照してください。

http://www.anychart.com

AnyChartでは、*.amap拡張子を持つファイルにマップ・データが格納され、アメリカ合衆国、ヨーロッパ、アジア、アフリカ、オセアニア、北アメリカおよび南アメリカの300個のマップ・ファイルがサポートされています。目的のマップをレンダリングするには、ウィザードでマップ・ソース(たとえば、「ドイツ」)を選択します。マップXMLによって、目的のマップ・ソースの.amapファイル(germany.amap)が自動的に参照されます。使用可能なマップについては、『AnyChart User's Guide』のマップの参照に関する説明を参照してください。

http://anychart.com/products/anychart/docs/users-guide/

既存ページへのFlashマップの追加

既存ページにFlashマップを追加するには、次のステップを実行します。

1. 「ページ定義」にナビゲートします。「「ページ定義」へのアクセス」を参照してください。

2. 「ページ定義」で、新しいリージョンを作成します。

- ツリー・ビュー: 「ページ・レンダリング」で、「リージョン」を右クリックし、「作成」を選択します。

- コンポーネント・ビュー: 「リージョン」で、「作成」アイコンをクリックします。

「リージョンの作成」ウィザードが表示されます。

3. 「マップ」を選択し、「次へ」をクリックします。

4. 「マップ・タイプ」で、マップ・タイプ(たとえば、「ヨーロッパ」)を選択し、「次へ」をクリックします。

5. 「マップ・ソース」の「ツリー」に、選択したマップ・タイプのマップ・ソース・ファイルのリストが表示されます。使用するマップ・ソース(たとえば、「デンマーク」)をクリックします。

6. 「表示属性」で、次の各項目を指定します。

1. タイトル

2. リージョン・テンプレート

3. 親リージョン

4. 表示ポイント

5. 順序
詳細を表示するには、アイテム・ラベルをクリックします。ヘルプが使用可能な場合は、アイテムにカーソルをあわせると、カーソルが疑問符付きの矢印に変わります。「フィールドレベル・ヘルプについて」を参照してください。

6. 「次へ」をクリックします。

7. 「表示属性」で、適切なマップ属性を選択し、「次へ」をクリックします。
特定の属性の詳細を表示するには、アイテム・ラベルをクリックします。「フィールドレベル・ヘルプについて」を参照してください。

8. 「ソース」で、次の項目を指定します。

1. 問合せは次のいずれかの方法で指定します。

- 表示されているフィールドにSQL問合せを入力します。「マップのSQL問合せの作成について」を参照してください。

- 「問合せの作成」ボタンをクリックします。ビルド・チャート問合せウィザードが表示されたら、画面に表示されるステップに従います。

2. 関連属性を指定します。選択したマップ・ソースに関連付けられているマップ参照情報を表示するには、ページの下部にある「マップ・リージョン情報」リージョンを展開します。
データを地理的な位置に関連付けるには、「リージョン名」または「リージョンID」列の情報をマップ問合せに組み込む必要があります。「マップのSQL問合せの作成について」を参照してください。

9. 「条件付き表示」で、次のステップを実行します。

1. 条件タイプ: このコンポーネントがレンダリングされるために満たす必要があるリストから、条件タイプを選択します。「条件付きのレンダリングおよびプロセスの理解」を参照してください。

2. 認可スキーム: オプションで認可スキームを選択します。このコンポーネントをレンダリングまたは処理するためには、この認可スキームがTRUEと評価される必要があります。詳細は、「認可を介したセキュリティの提供」を参照してください。

3. 「リージョンの作成」をクリックします。

新しいページへのFlashマップの追加

新しいページでFlashマップ・チャートを作成するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「ページの作成」をクリックします。

4. 「マップ」を選択し、「次へ」をクリックします。

5. 「マップ・タイプ」で、マップ・タイプ(たとえば、「ヨーロッパ」)を選択し、「次へ」をクリックします。

6. 「マップ・ソース」の「ツリー」に、選択したマップ・タイプのマップ・ソース・ファイルのリストが表示されます。使用するマップ・ソース(たとえば、「デンマーク」)をクリックします。

7. 「ページ属性」で、次のステップを実行します。

1. 次を指定します。

- ページ番号

- ページ名

- リージョン・テンプレート

- リージョン名

- ブレッドクラム

詳細を表示するには、アイテム・ラベルをクリックします。ヘルプが使用可能な場合は、アイテムにカーソルをあわせると、カーソルが疑問符付きの矢印に変わります。「フィールドレベル・ヘルプについて」を参照してください。

2. 「次へ」をクリックします。

8. タブを含めるかどうかを指定して、「次へ」をクリックします。

9. 「マップ属性」で、適切な属性を選択し、「次へ」をクリックします。
特定の属性の詳細を表示するには、アイテム・ラベルをクリックします。「フィールドレベル・ヘルプについて」を参照してください。

10. 「問合せ」で、次のステップを実行します。

1. 問合せは次のいずれかの方法で指定します。

- 表示されているフィールドにSQL問合せを入力します。「マップのSQL問合せの作成について」を参照してください。

- 「問合せの作成」ボタンをクリックします。ビルド・チャート問合せウィザードが表示されたら、画面に表示されるステップに従います。

2. 関連属性を指定します。選択したマップ・ソースに関連付けられているマップ参照情報を表示するには、ページの下部にある「マップ参照情報」リージョンを展開します。
データを地理的な位置に関連付けるには、「リージョン名」または「リージョンID」列の情報をマップ問合せに組み込む必要があります。「マップのSQL問合せの作成について」を参照してください。

3. 「次へ」をクリックします。

11. 「作成」をクリックします。

マップのSQL問合せの作成について

アプリケーション・ビルダーでは、ウィザードを使用してマップを定義します。ほとんどのチャート・ウィザードでは、マップ・タイプとマップ・ソースを選択し、次の構文を使用してSQL問合せを指定します。

SELECT link, label, value
FROM   ...

説明:

- linkはURLです。

- labelは、データを関連付けるマップ上のポイントを示すテキストです。マップの「リージョンID」または「リージョン名」をラベルとして使用する必要があります。

- valueは、マップ上のポイントと関連付けるデータを定義する数値列です。

次に、ページを新規作成する例を示します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「ページの作成」をクリックします。

4. 「マップ」を選択し、「次へ」をクリックします。

5. 「マップ・タイプ」で、「アメリカ合衆国」を選択し、「次へ」をクリックします。

6. 「マップ・ソース」で、「国マップ」を展開し、「州」を選択します。
maps_source1.gifの説明

7. 「ページ属性」で、適切な属性を指定し、「次へ」をクリックします。

8. タブを含めるかどうかを指定して、「次へ」をクリックします。

9. 「マップ属性」で、適切な属性を選択し、「次へ」をクリックします。
問合せページが表示されます。

10. ページの下部にある「マップ参照情報」リージョンを展開して確認します。
maps_source2.gifの説明

11. 「問合せ」で、次の操作を実行します。

1. 問合せは次のいずれかの方法で指定します。

- 表示されているフィールドにSQL問合せを入力します。「マップのSQL問合せの作成について」を参照してください。

- 「問合せの作成」ボタンをクリックします。ビルド・チャート問合せウィザードが表示されたら、画面に表示されるステップに従います。

2. 問合せを作成するときには、リージョン名の情報を組み込む必要があります。次の例では、フロリダ(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://anychart.com/products/anymap/docs/

3. 「次へ」をクリックします。

12. 「終了」をクリックします。

Flashマップ属性の編集

マップの作成後、マップ属性ページで属性を編集することによって表示を変更できます。

マップ属性ページにアクセスするには、次のステップを実行します。

1. 「ページ定義」にナビゲートします。「「ページ定義」へのアクセス」を参照してください。

2. チャート属性ページにアクセスします。

- ツリー・ビュー: 「ページ・レンダリング」で、リージョン名をダブルクリックします。

- コンポーネント・ビュー: 「リージョン」で、リージョン名を選択します。
リージョン定義が表示されます。

3. 「マップ属性」をクリックします。

4. 対象となる属性を編集します。
ページ上の特定のアイテムの詳細を表示するには、アイテム・ラベルをクリックします。

ヘルプが使用可能な場合は、アイテムにカーソルをあわせると、カーソルが疑問符付きの矢印に変わります。「フィールドレベル・ヘルプについて」を参照してください。

5. 「変更の適用」をクリックします。

ナビゲーションの選択肢について

マップ属性ページは複数のセクションに分かれています。これらのセクションにアクセスするには、ページをスクロールするか、ページ上部のナビゲーション・ボタンをクリックします。ページ上部のボタンを選択すると、選択されたセクションが表示され、その他のセクションはすべて一時的に非表示になります。ページのすべてのセクションを表示するには、「すべて表示」をクリックします。

FlashマップでのカスタムXMLの使用

マップ属性ページには、標準の属性で制御できない追加のマップ設定があります。チャートのルック・アンド・フィールをさらに制御するには、カスタムXMLを使用できます。

カスタムXMLを使用するには、次のステップを実行します。

1. 「ページ定義」にナビゲートします。「「ページ定義」へのアクセス」を参照してください。

2. マップ属性ページにアクセスします。

- ツリー・ビュー: 「ページ・レンダリング」で、リージョン名をダブルクリックします。

- コンポーネント・ビュー: 「リージョン」で、リージョン名を選択します。
リージョン定義が表示されます。

3. 「マップ属性」をクリックします。

4. 「マップXML」までスクロールします。

5. 「カスタムXMLの使用」から「はい」を選択します。
カスタムXMLを使用すると、存在しない属性を持つリージョンは非表示となります。これらのリージョンを再度表示するには、「カスタムXMLの使用」で「いいえ」を選択します。

6. XMLを編集します。

7. 「変更の適用」をクリックします。

ヒント:
マップに対してサポートされているXML書式の詳細は、次のサイトのオンライン・マップXMLリファレンスを参照してください。

http://www.anychart.com/

非同期更新の有効化

マップ属性ページで「非同期更新」属性を有効にして、情報を監視するFlashマップを作成できます。この属性を有効にすると、マップが更新され、指定した時間間隔内に行われた基礎となるデータの変更が反映されます。

非同期更新を有効にするには、次のステップを実行します。

1. Flashマップを作成します。「Flashマップのサポートについて」および「Flashマップのサポートについて」を参照してください。

2. 「ページ定義」にナビゲートします。「「ページ定義」へのアクセス」を参照してください。

3. マップ属性ページにアクセスします。

- ツリー・ビュー: 「ページ・レンダリング」で、リージョン名をダブルクリックします。

- コンポーネント・ビュー: 「リージョン」で、リージョン名を選択します。
リージョン定義が表示されます。

4. 「マップ属性」をクリックします。

5. 「リフレッシュ」までスクロールします。

6. 「非同期更新」で、「はい」を選択します。

7. 「更新間隔」で、マップの更新間隔(秒)を入力します。最適なパフォーマンスを得るには、2秒を超える間隔を選択します。

8. 「変更の適用」をクリックします。

チャートの作成

アプリケーション・ビルダーには、FlashチャートおよびHTML5チャートを生成するための組込みウィザードが用意されています。また、SVGチャートおよびHTMLチャートの編集もサポートされています。Oracle Application Expressは、この4つのグラフィカル・チャートのみサポートします。

内容は次のとおりです。

- チャートのSQL問合せの作成について

- HTML5チャートの作成について

- Flashチャートの作成について

- SVGチャートについて

- HTMLチャートについて

- チャート属性の編集

- Flashチャートの保存について

- 非同期更新の有効化

チャートのSQL問合せの作成について

アプリケーション・ビルダーでチャートを定義するには、ウィザードを使用します。ほとんどのチャート・ウィザードでは、チャート・タイプを選択し、次の構文を使用してSQL問合せを指定します。

SELECT link, label, value
FROM   ...

説明:

- linkはURLです。

- labelは、バーに表示されるテキストです。

- valueは、バー・サイズを定義する数値列です。

次に例を示します。

SELECT null, last_name, salary
FROM   employees
WHERE  DEPARTMENT_ID = :P101_DEPARTMENT_ID

ダイアル・チャート構文(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

複数シリーズ構文(FlashおよびHTML5)

列チャートおよび折れ線グラフには、1つのSQL問合せで複数シリーズを定義できます。これらのチャート・タイプのシリーズ名は、問合せ内の関連する列別名から導出されます。複数シリーズのチャートを定義するには、次の構文を使用します。

SELECT link, label, series_1_value [, series_2_value [, ...]]
FROM   ...

レンジ・チャート構文(FlashおよびHTML5)

レンジ・チャートは、各バーに2つの値が必要です。レンジ・チャートを作成するには、チャートを作成し、次の構文を使用してSQL問合せを指定します。

SELECT link, label, low_value, high_value
FROM   ...

スキャッタ・チャート構文(FlashおよびHTML5)

散布チャートは、各ポイントにx値およびy値が必要です。レンジ・チャートを作成するには、チャートを作成し、次の構文を使用してSQL問合せを提供します。

SELECT link, label, x_value, y_value
FROM   ...

ローソク足チャート構文(FlashおよびHTML5)

ローソク足チャートには、各ローソク足に始値、安値、高値および終値が必要です。ローソク足チャートを作成するには、チャートを作成し、次の構文を使用してSQL問合せを指定します。

SELECT link, label, open, low, high, close
FROM   ...

ガント・チャート構文(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   ...

HTML5チャートの作成について

Oracle Application ExpressのHTML5チャートのサポートは、AnyChart HTML5 Chart Componentをベースにしています。

内容は次のとおりです。

- HTML5チャートについて

- 既存ページへのHTML5チャートの追加

- 新しいページへのHTML5チャートの追加

- HTML5チャートからFlashチャートへの切替え

HTML5チャートについて

Oracle Application ExpressのHTML5チャートのサポートは、AnyChart HTML5 Chart Componentをベースにしています。AnyChartはフレキシブルなFlashおよびJavaScript (HTML5)ベースのソリューションで、開発者は動きがありコンパクトでインタラクティブなチャートを作成できます。HTML5チャートでは、JavaScriptチャート・エンジンを使用して、チャートをSVG形式でレンダリングします。ほとんどの最新モバイル・デバイスではFlashをレンダリングできませんが、新しいHTML5チャート作成ソリューションを利用して、チャートをモバイル・アプリケーションに組み込むことができます。HTML5チャートは、次のモバイル・プラットフォームに対応したポピュラーなブラウザと互換性があります。

- Android: バージョン3.1、3.2、4.0、4.0.3および4.1

- iOs (iPhone, iPad, iPod Touch): Safari 3.2以上が必要です。

詳細は、次を参照してください。

http://www.anychart.com

既存ページへのHTML5チャートの追加

既存ページにHTMLチャートを追加するには、次のステップを実行します。

1. 「ページ定義」にナビゲートします。「「ページ定義」へのアクセス」を参照してください。

2. 「ページ定義」で、新しいリージョンを作成します。

- ツリー・ビュー: 「ページ・レンダリング」で、「リージョン」を右クリックし、「作成」を選択します。

- コンポーネント・ビュー: 「リージョン」で、「作成」アイコンをクリックします。

「リージョンの作成」ウィザードが表示されます。

3. 「チャート」を選択して、「次へ」をクリックします。

4. 「チャート・タイプ」で、次のステップを実行します。

1. チャートのレンダリング: 「HTML5チャート」を選択します。

2. チャート・タイプ: チャート・タイプを指定します。チャート・タイプに応じて、1つまたは2つ選択するように求められることがあります。

3. 「次へ」をクリックします。

5. 「表示属性」で、次のステップを実行します。

1. 次を指定します。

- タイトル

- リージョン・テンプレート

- 親リージョン

- 表示ポイント

- 順序

詳細を表示するには、アイテム・ラベルをクリックします。ヘルプが使用可能な場合は、アイテムにカーソルをあわせると、カーソルが疑問符付きの矢印に変わります。「フィールドレベル・ヘルプについて」を参照してください。

2. 「次へ」をクリックします。

6. 「チャート属性」で、適切な属性を指定し、「次へ」をクリックします。
特定の属性の詳細を表示するには、アイテム・ラベルをクリックします。

7. 「ソース」で、次の項目を指定します。

1. 問合せは次のいずれかの方法で指定します。

- 表示されているフィールドにSQL問合せを入力します。「チャートのSQL問合せの作成について」を参照してください。

- 「問合せの作成」ボタンをクリックします。ビルド・チャート問合せウィザードが表示されたら、画面に表示されるステップに従います。

2. 関連するチャート属性を指定します。詳細を表示するには、アイテム・ラベルをクリックします。

8. 「条件付き表示」で、次のステップを実行します。

1. 条件タイプ: 対象のコンポーネントをレンダリングまたは処理するうえで満たす必要がある条件タイプをリストから選択します。詳細は、「条件付きのレンダリングおよびプロセス」を参照してください。

2. 認可スキーム: オプションで認可スキームを選択します。このコンポーネントをレンダリングまたは処理するためには、この認可スキームがTRUEと評価される必要があります。詳細は、「認可を介したセキュリティの提供」を参照してください。

3. 「リージョンの作成」をクリックします。

新しいページへのHTML5チャートの追加

新しいページでHTML5チャートを作成するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「ページの作成」をクリックします。

4. 「チャート」を選択して、「次へ」をクリックします。

5. 「チャート・タイプ」で、次のステップを実行します。

1. チャートのレンダリング: 「HTML5チャート」を選択します。

2. チャート・タイプ - チャート・タイプを指定します。チャート・タイプによっては、1つまたは2つ選択するように求められる場合があります。

3. 「次へ」をクリックします。

6. 「ページおよびリージョン属性」で、次のステップを実行します。

1. 次を指定します。

- ページ番号

- ページ名

- リージョン・テンプレート

- リージョン名

- ブレッドクラム

詳細を表示するには、アイテム・ラベルをクリックします。ヘルプが使用可能な場合は、アイテムにカーソルをあわせると、カーソルが疑問符付きの矢印に変わります。「フィールドレベル・ヘルプについて」を参照してください。

2. 「次へ」をクリックします。

7. 「タブ・オプション」で、タブを含めるかどうかを指定し、「次へ」をクリックします。

8. 「チャート属性」で、適切な属性を指定し、「次へ」をクリックします。
属性の詳細を表示するには、アイテム・ラベルをクリックしてください。ヘルプが使用可能な場合は、アイテムにカーソルをあわせると、カーソルが疑問符付きの矢印に変わります。「フィールドレベル・ヘルプについて」を参照してください。

9. 「問合せ」で、次のステップを実行します。

1. 問合せは次のいずれかの方法で指定します。

- 表示されているフィールドにSQL問合せを入力します。「チャートのSQL問合せの作成について」を参照してください。

- 「問合せの作成」ボタンをクリックします。ビルド・チャート問合せウィザードが表示されたら、画面に表示されるステップに従います。

2. 関連するチャート属性を指定します。詳細を表示するには、アイテム・ラベルをクリックします。

3. 「次へ」をクリックします。

10. 「作成」をクリックします。

HTML5チャートからFlashチャートへの切替え

HTML5チャートの作成後、チャート属性ページでチャート属性を編集してチャートのレンダリングをFlashに切り替えることができます。

HTML5チャートをFlashチャートに切り替えるには、次のステップを実行します。

1. 「ページ定義」にナビゲートします。「「ページ定義」へのアクセス」を参照してください。

2. チャート属性ページにアクセスします。

- ツリー・ビュー: 「ページ・レンダリング」で、リージョン名をダブルクリックします。

- コンポーネント・ビュー: 「リージョン」で、リージョン名を選択します。
リージョン定義が表示されます。

- 「チャート属性」をクリックします。

3. 「チャート・タイプ」で、次のステップを実行します。

1. チャートのレンダリング: 「Flashチャート」を選択します。

2. チャート・タイプ - チャート・タイプを指定します。3Dチャート・タイプは、Flashチャートでのみサポートされています。そのため、いずれかの3Dオプションを使用するようにチャート・タイプを変更する必要がある場合があります。
属性の詳細を表示するには、アイテム・ラベルをクリックしてください。ヘルプが使用可能な場合は、アイテムにカーソルをあわせると、カーソルが疑問符付きの矢印に変わります。「フィールドレベル・ヘルプについて」を参照してください。

4. 「変更の適用」をクリックします。

Flashチャートの作成について

Oracle Application ExpressのFlashチャートのサポートは、AnyChart Flash Chart Componentをベースにしています。

内容は次のとおりです。

- Flashチャートについて

- 既存ページへのFlashチャートの追加

- 新しいページへのFlashチャートの追加

- すべてのFlashチャートのFlash 6へのアップグレード

- すべてのFlashチャートのHTML5へのアップグレード

- 1つのFlash 3チャートのFlash 6へのアップグレード

- 1つのFlash 3チャートのHTML5へのアップグレード

- FlashチャートからHTML5チャートへの切替え

Flashチャートについて

Oracle Application ExpressのFlashチャートのサポートは、AnyChart Flash Chart Componentをベースにしています。AnyChartはフレキシブルなFlashおよびJavaScriptベースのソリューションで、開発者は動きがありコンパクトでインタラクティブなチャートを作成できます。Flashチャートはブラウザでレンダリングされ、使用するにはFlash Player 9以上が必要です。AnyChart 6.0では、FlashチャートはFLASH_PREFERREDレンダリング・タイプを使用してレンダリングされます。チャートを表示するデバイス(たとえば、iPhoneでページを表示)でFlash Playerを使用できない場合、AnyChartは自動的にHTML5チャート・エンジンに切り替わり、SVGベースのチャートを表示します。

既存ページへのFlashチャートの追加

既存ページにFlashチャートを追加するには、次のステップを実行します。

1. 「ページ定義」にナビゲートします。「「ページ定義」へのアクセス」を参照してください。

2. 「ページ定義」で、新しいリージョンを作成します。

- ツリー・ビュー: 「ページ・レンダリング」で、「リージョン」を右クリックし、「作成」を選択します。

- コンポーネント・ビュー: 「リージョン」で、「作成」アイコンをクリックします。

「リージョンの作成」ウィザードが表示されます。

3. 「チャート」を選択して、「次へ」をクリックします。

4. 「チャート・タイプ」で、次のステップを実行します。

1. チャートのレンダリング: 「Flashチャート」を選択します。

2. チャート・タイプ - チャート・タイプを指定します。チャート・タイプによっては、1つまたは2つ選択するように求められる場合があります。

3. 「次へ」をクリックします。

5. 「表示属性」で、次のステップを実行します。

1. 次を指定します。

- タイトル

- リージョン・テンプレート

- 親リージョン

- 表示ポイント

- 順序

詳細を表示するには、アイテム・ラベルをクリックします。ヘルプが使用可能な場合は、アイテムにカーソルをあわせると、カーソルが疑問符付きの矢印に変わります。「フィールドレベル・ヘルプについて」を参照してください。

2. 「次へ」をクリックします。

6. 「チャート属性」で、適切な属性を選択し、「次へ」をクリックします。
特定の属性の詳細を表示するには、アイテム・ラベルをクリックします。

7. 「ソース」で、次の項目を指定します。

1. 問合せは次のいずれかの方法で指定します。

- 表示されているフィールドにSQL問合せを入力します。「チャートのSQL問合せの作成について」を参照してください。

- 「問合せの作成」ボタンをクリックします。ビルド・チャート問合せウィザードが表示されたら、画面に表示されるステップに従います。

2. 関連するチャート属性を指定します。詳細を表示するには、アイテム・ラベルをクリックします。

3. 「次へ」をクリックします。

8. 「条件付き表示」で、次のステップを実行します。

1. 条件タイプ: このコンポーネントがレンダリングされるために満たす必要があるリストから、条件タイプを選択します。「条件付きのレンダリングおよびプロセスの理解」を参照してください。

2. 認可スキーム: オプションで認可スキームを選択します。このコンポーネントをレンダリングまたは処理するためには、この認可スキームがTRUEと評価される必要があります。詳細は、「認可を介したセキュリティの提供」を参照してください。

3. 「リージョンの作成」をクリックします。

新しいページへのFlashチャートの追加

新しいページでFlashチャートを作成するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「ページの作成」をクリックします。

4. 「チャート」を選択して、「次へ」をクリックします。

5. 「チャート・タイプ」で、次のステップを実行します。

1. チャートのレンダリング: 「Flashチャート」を選択します。

2. チャート・タイプ - チャート・タイプを指定します。チャート・タイプによっては、1つまたは2つ選択するように求められる場合があります。

3. 「次へ」をクリックします。

6. 「ページおよびリージョン属性」で、次のステップを実行します。

1. 次を指定します。

- ページ番号

- ページ名

- リージョン・テンプレート

- リージョン名

- ブレッドクラム

詳細を表示するには、アイテム・ラベルをクリックします。ヘルプが使用可能な場合は、アイテムにカーソルをあわせると、カーソルが疑問符付きの矢印に変わります。「フィールドレベル・ヘルプについて」を参照してください。

2. 「次へ」をクリックします。

7. タブを含めるかどうかを指定して、「次へ」をクリックします。

8. 「チャート属性」で、適切な属性を選択し、「次へ」をクリックします。
詳細を表示するには、アイテム・ラベルをクリックします。ヘルプが使用可能な場合は、アイテムにカーソルをあわせると、カーソルが疑問符付きの矢印に変わります。「フィールドレベル・ヘルプについて」を参照してください。

9. 「問合せ」で、次のステップを実行します。

1. 問合せは次のいずれかの方法で指定します。

- 表示されているフィールドにSQL問合せを入力します。「チャートのSQL問合せの作成について」を参照してください。

- 「問合せの作成」ボタンをクリックします。ビルド・チャート問合せウィザードが表示されたら、画面に表示されるステップに従います。

2. 残りの属性を指定します。詳細を表示するには、アイテム・ラベルをクリックします。

3. 「次へ」をクリックします。

10. 「作成」をクリックします。

すべてのFlashチャートのFlash 6へのアップグレード

アプリケーション内のすべてのFlashチャートをFlash 6にアップグレードするには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。
「アプリケーション・ビルダー」ホームページが表示されます。

2. アプリケーションを選択します。
「アプリケーション」ホームページが表示されます。

3. 「ユーティリティ」をクリックし、「アプリケーションのアップグレード」をクリックします。
「アプリケーション・サマリーのアップグレード」レポートが表示されます。

4. 「FlashチャートのFlashチャート5へのアップグレード」で、候補オブジェクトの数をクリックします。

5. アップグレードするオブジェクトを選択し、「アップグレード」をクリックします。

すべてのFlashチャートのHTML5へのアップグレード

アプリケーション内のすべてのFlashチャートをHTML5チャートにアップグレードするには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。
「アプリケーション・ビルダー」ホームページが表示されます。

2. アプリケーションを選択します。
「アプリケーション」ホームページが表示されます。

3. 「ユーティリティ」をクリックし、「アプリケーションのアップグレード」をクリックします。
「アプリケーション・サマリーのアップグレード」レポートが表示されます。

4. 「FlashチャートのFlashチャート5へのアップグレード」で、候補オブジェクトの数をクリックします。

5. アップグレードするオブジェクトを選択し、「アップグレード」をクリックします。

1つのFlash 3チャートのFlash 6へのアップグレード

1つのFlash 3チャートをFlash 6にアップグレードするには、次のステップを実行します。

1. 「ページ定義」にナビゲートします。「「ページ定義」へのアクセス」を参照してください。

2. チャート属性ページにアクセスします。

- ツリー・ビュー: 「ページ・レンダリング」で、リージョン名をダブルクリックします。

- コンポーネント・ビュー: 「リージョン」で、リージョン名を選択します。
リージョン定義が表示されます。

3. 「タスク」リストで、「Flash 6チャートへのアップグレード」をクリックします。

4. 「アップグレード」をクリックします。

1つのFlash 3チャートのHTML5へのアップグレード

1つのFlash 3チャートをHTML5にアップグレードするには、次のステップを実行します。

1. 「ページ定義」にナビゲートします。「「ページ定義」へのアクセス」を参照してください。

2. チャート属性ページにアクセスします。

- ツリー・ビュー: 「ページ・レンダリング」で、リージョン名をダブルクリックします。

- コンポーネント・ビュー: 「リージョン」で、リージョン名を選択します。
リージョン定義が表示されます。

3. 「タスク」リストで、「HTML5チャートへのアップグレード」をクリックします。

4. 「アップグレード」をクリックします。

FlashチャートからHTML5チャートへの切替え

Flashチャートの作成後、チャート属性ページでチャート属性を編集してチャートのレンダリングをHTML5に切り替えることができます。

FlashチャートをHTML5チャートに切り替えるには、次のステップを実行します。

1. 「ページ定義」にナビゲートします。「「ページ定義」へのアクセス」を参照してください。

2. チャート属性ページにアクセスします。

- ツリー・ビュー: 「ページ・レンダリング」で、リージョン名をダブルクリックします。

- コンポーネント・ビュー: 「リージョン」で、リージョン名を選択します。
リージョン定義が表示されます。

- 「チャート属性」をクリックします。

3. 「チャート・タイプ」で、次のステップを実行します。

1. チャートのレンダリング: 「HTML5チャート」を選択します。

2. チャート・タイプ - チャート・タイプを指定します。3Dチャート・タイプは、Flashチャートでのみサポートされています。そのため、いずれかの2Dオプションを使用するようにチャート・タイプを変更する必要がある場合があります。
属性の詳細を表示するには、アイテム・ラベルをクリックしてください。ヘルプが使用可能な場合は、アイテムにカーソルをあわせると、カーソルが疑問符付きの矢印に変わります。「フィールドレベル・ヘルプについて」を参照してください。

4. 「変更の適用」をクリックします。

SVGチャートについて

以前のリリースのOracle Application Expressでは、SVGチャートの作成がサポートされていました。既存のSVGチャートは引き続きサポートされていますが、Oracle Application Expressでは新しいSVGチャートの作成はサポートされなくなりました。

内容は次のとおりです。

- SVGチャートのHTML5へのアップグレードについて

- SVGチャート・カスケード・スタイルシート・クラスの理解

- カスタムSVGチャート・カスケード・スタイルシートの参照

- SVGチャートのカスタムCSSスタイル・インラインの指定

- 他の言語でのSVGチャートの表示

SVGチャートのHTML5へのアップグレードについて

この項では、SVGチャートをHTML5にアップグレードする際に適用される制限と、アップグレードの手順について説明します。

内容は次のとおりです。

- SVGチャートのアップグレードの制限事項について

- SVGチャートのHTML5へのアップグレード

- アプリケーション内のすべてのSVGチャートのHTML5へのアップグレード

単一または複数のSVGチャートを自動的にHTML5にアップグレードできます。

SVGチャートのアップグレードの制限事項について

SVGチャートをアップグレードする場合、次の制限事項があります。

- 軸の書式文字列で定義された数値書式のみが移行されます。日付書式および時間書式は無視されます。

- 次の項目を含む数値書式の要素が移行されます。

0,9,D,G,, (comma),. (period),$,C,L,FM

- HTML5チャートの各シリーズのラベルは、各シリーズの列の別名から導出されます。これは各シリーズのラベルが「シリーズ名」属性から導出されるSVGチャートによって異なります。

- SVGチャートでは、最初のシリーズのラベルがX軸に使用されます。HTML5チャートでは、最初のシリーズでデータのラベルが発生していなくても、すべてのデータが表示されるように拡張されています。

SVGチャートのHTML5へのアップグレード

SVGチャートをHTML5にアップグレードするには、次のステップを実行します。

1. 「ページ定義」にナビゲートします。「「ページ定義」へのアクセス」を参照してください。

2. チャート属性ページにアクセスします。

- ツリー・ビュー: 「ページ・レンダリング」で、リージョン名をダブルクリックします。

- コンポーネント・ビュー: 「リージョン」で、リージョン名を選択します。
リージョン定義が表示されます。

3. 「タスク」リストで、新しいHTML5チャートへのアップグレードをクリックします。

4. 「アップグレード」をクリックします。

アプリケーション内のすべてのSVGチャートのHTML5へのアップグレード

すべてのSVGチャートをHTML5チャートにアップグレードするには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。
「アプリケーション・ビルダー」ホームページが表示されます。

2. アプリケーションを選択します。
「アプリケーション」ホームページが表示されます。

3. 「ユーティリティ」をクリックし、「アプリケーションのアップグレード」をクリックします。
「アプリケーション・サマリーのアップグレード」レポートが表示されます。

4. 「SVGチャートのHTML5チャートへのアップグレード」で、候補オブジェクトの数をクリックします。

5. アップグレードするオブジェクトを選択し、「アップグレード」をクリックします。

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;}

表10-4に、サポートされているすべてのCSSクラスを示します。一部のクラスは、特定のチャート・タイプにのみ適用されます。

表 10-4 使用可能なSVGチャートCSSクラス

クラス

説明

text

チャートに表示されるテキストの外観を定義します。

tspan

チャートに表示されるテキストの外観を定義します。tspanはtextの定義と一致する必要があります。

text.title

デフォルトのチャート・テキストを上書きします。このクラスは、タイトル・テキストに使用します。

text.moredatafound

より多くのデータが検出されたテキストの外観を定義します。

rect.legend

チャート凡例を保持する矩形ボックスを作成します。

凡例の枠線を削除するには、rect.legendを次のように変更します。

rect.legend{fill:#CCCC99;stroke:none;}

text.legend

チャート凡例に表示されるテキストを定義します。

#background

SVGプラグイン用のバックグラウンド全体を作成します。

枠線なしの単色の立体バックグラウンドを作成するには、#backgroundを次のように変更します。

#background{fill:#FFFFFF;stroke:#FFFFFF;stroke-width:2;}

rect.chartholderbackground

円グラフおよびダイアル・チャートには適用されません。チャート・データを保持する矩形のバックグラウンドを作成します。

バックグラウンドに何も表示しない場合は、rect.chartholderbackgroundを次のように変更します。

rect.chartholderbackground(display:none;)

#timestamp

「非同期更新」チャート属性が「はい」に設定されている場合にのみ適用されます。更新タイムスタンプ・テストの外観を制御します。

タイムスタンプの表示を無効にするには、「カスタムCSS、インライン」属性で#timestampを次のように定義します。

"#timestamp{display:none;}"

関連項目: 「非同期更新の有効化」

text.tic

ダイアル・チャート専用。ダイアル・チャートの数値を定義します。

line.tic

ダイアル・チャート専用。ダイアル・チャートの数値の直下に表示される目盛り線を定義します。

#dial

ダイアル・チャート専用。ダイアル・チャートに表示される値を定義します。

#dial.alert

ダイアル・チャート専用。別の表示画面を使用してダイアル・チャートにレンダリングされる値(アラート値)を定義します。

#dialbackground

ダイアル・チャート専用。ダイアル・チャートのバックグラウンドを作成します。

#dialcenter

ダイアル・チャート専用。ダイアル・チャートにダイアルの中心を作成します。

#dialbackground-border

ダイアル・チャート専用。#dialbackgroundと連動して特定のグラフィック効果を作成します。

#low

ダイアル・チャート専用。チャートに表示されているデータの履歴上の最低水位標を定義します。

#high

ダイアル・チャート専用。チャートに表示されているデータの履歴上の最高水位標を定義します。

#XAxisTitle

X軸に表示されるタイトルを定義します。

#YAxisTitle

Y軸に表示されるタイトルを定義します。

.XAxisValue

X軸に表示される値を定義します。

.YAxisValue

Y軸に表示される値を定義します。

.AxisLabel

軸値に類似しています。

.nodatafound

情報を参照できない場合に表示されるテキスト要素を定義します。

.AxisLine

負の値を含むチャートの0(ゼロ)を示します。

.GridLine

チャートの横線および縦線を作成します。

g.dataholder rect

チャートに表示されるすべてのデータに一律のスタイルを適用します。

.legenditem rect

凡例内のすべての矩形アイテムに一律のスタイルを適用します。

カスタムSVGチャート・カスケード・スタイルシートの参照

「チャート属性」ページの「CSS」セクションを使用して、チャート用のカスタム・カスケード・スタイルシートを参照できます。外部CSSを参照する場合は、全体を参照するか、または特定のスタイルを上書きできます。

カスタム・チャートCSSを参照するには、次のステップを実行します。

1. CSSをアプリケーション・ビルダーにアップロードします。詳細は、「カスケード・スタイルシートのアップロード」を参照してください。

2. チャートを含む「ページ定義」にナビゲートします。「「ページ定義」へのアクセス」を参照してください。

3. チャート属性ページにアクセスします。

- ツリー・ビュー: 「ページ・レンダリング」で、リージョン名をダブルクリックします。

- コンポーネント・ビュー: 「リージョン」で、リージョン名を選択します。
リージョン定義が表示されます。

4. 「チャート属性」タブをクリックします。

5. チャート属性ページで、「CSS」セクションまでスクロールします。

6. 「カスタムCSSを使用」で、「はい」を選択します。

7. 外部CSSを排他的に参照するには、次のステップを実行します。

1. 「カスタムCSS (リンク)」で、カスタムCSSへのリンクを入力します。次に例を示します。

#IMAGE_PREFIX#themes/theme_4/svg.css

2. CSSが排他的に使用されるように指定します。「カスタムCSS、インライン」で、次のように入力します。

/**/

8. カスタムCSSを参照し、特定のスタイルを上書きするには、次のステップを実行します。

1. 「カスタムCSS (リンク)」で、カスタム・スタイルシートへのリンクを入力します。次に例を示します。

#IMAGE_PREFIX#themes/theme_4/svg.css

2. 「カスタムCSS、インライン」で、上書きするカスタムCSSスタイルを入力します。

SVGチャートのカスタムCSSスタイル・インラインの指定

「チャート属性」ページの「カスタムCSS、インライン」属性を使用して、デフォルトCSS内の特定のスタイルを上書きできます。

デフォルトのCSS内の特定のスタイルを上書きするには、次のステップを実行します。

1. チャートを作成します。「SVGチャートについて」を参照してください。

2. 「ページ定義」にナビゲートします。「「ページ定義」へのアクセス」を参照してください。

3. チャート属性ページにアクセスします。

- ツリー・ビュー: 「ページ・レンダリング」で、リージョン名をダブルクリックします。

- コンポーネント・ビュー: 「リージョン」で、リージョン名を選択します。
リージョン定義が表示されます。

4. 「チャート属性」タブをクリックします。

5. 「CSS」までスクロールします。

6. 「カスタムCSSを使用」で、「はい」を選択します。

7. 「カスタムCSS、インライン」で、上書きするカスタムCSSスタイルを入力します。

他の言語でのSVGチャートの表示

SVGチャートを他の言語で表示するには、textおよびtspanクラスに正しい言語が反映されるように編集します。

SVGチャートを他の言語で表示するには、次のステップを実行します。

1. 「ページ定義」にナビゲートします。「「ページ定義」へのアクセス」を参照してください。

2. チャート属性ページにアクセスします。

- ツリー・ビュー: 「ページ・レンダリング」で、リージョン名をダブルクリックします。

- コンポーネント・ビュー: 「リージョン」で、リージョン名を選択します。
リージョン定義が表示されます。

3. 「チャート属性」タブをクリックします。

4. 「CSS」までスクロールします。

5. 「カスタムCSSを使用」で、「はい」を選択します。

6. 「カスタムCSS、インライン」で、textおよびtspanクラスに正しい言語が反映されるように編集します。次の例では、チャートを韓国語に変更する方法を示します。

text{font-family:Batang;fill:#000000;}
tspan{font-family:Batang;fill:#000000;}

HTMLチャートについて

以前のリリースのOracle Application Expressでは、HTMLチャートの作成がサポートされていました。既存のHTMLチャートは引き続きサポートされていますが、Oracle Application Expressでは作成ウィザードを使用した新しいHTMLチャートの作成はサポートされなくなりました。新しいHTMLチャート・リージョン・タイプ・プラグインは、OTNからダウンロードできます。このプラグインを使用すると、ユーザーは使用しているアプリケーションでHTMLチャート・リージョンを作成できます。

詳細は、次を参照してください。

http://www.oracle.com/technetwork/developer-tools/apex/application-express/apex-plug-ins-182042.html#region

内容は次のとおりです。

- HTMLチャートのHTML5へのアップグレード

- すべてのHTMLチャートのHTML5へのアップグレード

HTMLチャートのHTML5へのアップグレード

HTMLチャートをHTML5にアップグレードするには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。
「アプリケーション・ビルダー」ホームページが表示されます。

2. アプリケーションを選択します。
「アプリケーション」ホームページが表示されます。

3. 「ページ定義」にナビゲートします。「「ページ定義」へのアクセス」を参照してください。

4. チャート属性ページにアクセスします。

- ツリー・ビュー: 「ページ・レンダリング」で、リージョン名をダブルクリックします。

- コンポーネント・ビュー: 「リージョン」で、リージョン名を選択します。
リージョン定義が表示されます。

- 「チャート属性」をクリックします。

5. 「タスク」リストで、「HTML5チャートへのアップグレード」をクリックします。

6. 「アップグレード」をクリックします。

すべてのHTMLチャートのHTML5へのアップグレード

すべてのHTMLチャートをHTML5にアップグレードするには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。
「アプリケーション・ビルダー」ホームページが表示されます。

2. アプリケーションを選択します。
「アプリケーション」ホームページが表示されます。

3. 「ユーティリティ」をクリックし、「アプリケーションのアップグレード」をクリックします。
「アプリケーション・サマリーのアップグレード」レポートが表示されます。

4. 「HTMLチャートのHTML5チャートへのアップグレード」で、候補オブジェクトの数をクリックします。

5. アップグレードするオブジェクトを選択し、「アップグレード」をクリックします。

チャート属性の編集

チャートの作成後は、「チャート属性」ページでチャート属性を編集してチャートの表示を変更できます。

関連項目:
「Flashチャートの保存について」

「チャート属性」ページにアクセスするには、次のステップを実行します。

1. 「ページ定義」にナビゲートします。「「ページ定義」へのアクセス」を参照してください。

2. チャート属性ページにアクセスします。

- ツリー・ビュー: 「ページ・レンダリング」で、リージョン名をダブルクリックします。

- コンポーネント・ビュー: 「リージョン」で、リージョン名を選択します。
リージョン定義が表示されます。

- 「チャート属性」をクリックします。

3. 対象となる属性を編集します。

4. ページ上の特定のアイテムの詳細を表示するには、アイテム・ラベルをクリックします。
ヘルプが使用可能な場合は、アイテムにカーソルをあわせると、カーソルが疑問符付きの矢印に変わります。「フィールドレベル・ヘルプについて」を参照してください。

5. 「変更の適用」をクリックします。

ヒント:
SVGチャート(「チャート・タイトル」属性)のチャート・タイトルを削除すると、チャート凡例の位置と表示に悪影響を及ぼす場合があります。

ナビゲーションの選択肢について

チャート属性ページは複数のセクションに分かれています。これらのセクションにアクセスするには、ページをスクロールするか、ページ上部のナビゲーション・ボタンをクリックします。ページ上部のボタンを選択すると、選択されたセクションが表示され、その他のセクションはすべて一時的に非表示になります。ページのすべてのセクションを表示するには、「すべて表示」をクリックします。

Flashチャートの保存について

イメージの保存をサポートするには、AnyChartでhttp://www.anychart.comに存在するサーバー側スクリプトを使用する必要があります。イメージを保存しようとすると、データはBase64エンコーディングでサーバーに送信されます。その後、サーバーでデコードされ、デコードされたレスポンスが返されます。

チャートのローカル保存をサポートする場合は、ローカル・サーバーでデコード・スクリプトをホストする必要があります。Flashチャートでは、AnyChart JavaScript関数getPNGも使用する必要があります。デフォルトでは、チャート・リージョンは埋め込まれたHTMLタグを使用し、AnyChart JavaScriptコールを使用しません。AnyChart JavaScriptコールを使用するには、Flashチャートのリージョン・ソースを変更する必要があります。

関連項目:
Flashチャートのローカル保存のサポートを追加する方法の詳細は、『AnyChart User's Guide』のイメージまたはベクター・ファイルとしてのチャートの保存に関する説明を参照してください。

FlashチャートおよびHTML5チャートとのカスタムXMLの使用

チャート属性ページには、標準の属性で制御できない追加のチャート設定があります。チャートのルック・アンド・フィールをさらに制御するには、カスタムXMLを使用できます。

カスタムXMLを使用するには、次のステップを実行します。

1. 「チャート属性」ページにナビゲートします。詳細は、「チャート属性の編集」を参照してください。

2. 「チャートXML」までスクロールします。

3. 「カスタムXMLの使用」から「はい」を選択します。
カスタムXMLを使用すると、属性が適用されないリージョンは非表示となります。これらのリージョンを再度表示するには、「カスタムXMLの使用」で「いいえ」を選択します。

4. XMLを編集します。

5. 「変更の適用」をクリックします。

ヒント:
チャートに対してサポートされているXML書式の詳細は、次のサイトのオンラインXMLリファレンスを参照してください。

http://www.anychart.com

非同期更新の有効化

チャート属性ページで「非同期更新」属性を有効にすると、SVG。FlashおよびHTML5チャートで情報を監視できます。この属性を有効にすると、チャートが更新され、指定した時間間隔内に基礎となるデータで行われた変更が反映されます。

非同期更新を有効にするには、次のステップを実行します。

1. 「チャート属性」ページにナビゲートします。詳細は、「チャート属性の編集」を参照してください。
チャート属性ページが表示されます。

2. 「リフレッシュ」までスクロールします。

3. 「非同期更新」で、「はい」を選択します。

4. 「更新間隔」で、チャートの更新間隔(秒)を入力します。最適なパフォーマンスを得るには、2秒を超える間隔を選択します。

SVGチャートに「非同期更新」を有効にすると、最終更新を示すタイムスタンプがチャートに表示されます。

「非同期更新」タイムスタンプを無効にするには、次のステップを実行します。

1. 「チャート属性」ページにナビゲートします。

2. 「CSS」セクションに移動します。

3. 「カスタムCSSを使用」で、「はい」を選択します。

4. 「カスタムCSS、インライン」で、#timestampを次のように編集します。

#timestamp{display:none;}

ボタンの作成

アプリケーションを設計する際、ボタンを使用して、特定のページまたはURLを表示したり、情報をポストまたは処理するようにできます(たとえば、「作成」、「取消」、「次へ」、「前へ」または「削除」ボタンを作成します)。

ボタンでは、4つの異なるタイプの操作を実行できます。ボタンでは、ページの送信(たとえば、フォーム・ページへの変更を保存するため)、または別のページまたはカスタムURLのいずれかへのリダイレクトを行うか、何も行わない(たとえば、ボタンの動作が「動的アクション」で定義されている場合)ことができます。

内容は次のとおりです。

- ウィザードを使用したボタンの作成

- コンポーネント・ビューでの複数のボタンの作成

- ボタンの編集

- ボタン名とREQUESTの関係の理解

- ボタンを使用したブランチ処理について

- ボタンの条件付き表示

関連項目:
「ボタンのURLからのページのコール」および「ページ固有のユーティリティについて」

ウィザードを使用したボタンの作成

ボタンを作成するには、「ページ定義」から「ボタンの作成」ウィザードを実行します。ボタンの作成方法は、ツリー・ビューとコンポーネント・ビューのどちらで「ページ定義」を表示するかによって異なります。詳細は、「ツリー・ビューとコンポーネント・ビューについて」を参照してください。

内容は次のとおりです。

- コンポーネント・ビューでのボタンの作成

- ツリー・ビューでのボタンの作成

コンポーネント・ビューでのボタンの作成

コンポーネント・ビューは、ユーザー・インタフェース要素とアプリケーション・ロジックをコンポーネント・タイプ別にグループ化します。コンポーネント・ビューでボタンを作成するには、ボタンの下で、「作成」アイコンをクリックします。

コンポーネント・ビューでリージョン・ボタンを作成するには、次のステップを実行します。

1. 該当する「ページ定義」にナビゲートします。「「ページ定義」へのアクセス」を参照してください。

2. 必要に応じて、リージョンを作成します。「リージョンの理解」を参照してください。

3. 「ボタン」で、「作成」アイコンをクリックします。

4. ボタンのリージョンを選択し、「次へ」をクリックします。

5. ボタンの位置を選択し、「次へ」をクリックします。

- リージョン位置にボタンの作成: リージョン位置にボタンを配置する場合は、このオプションを選択します。リージョン位置は、リージョン・テンプレートで定義された位置です。

- このリージョン・アイテムで表示されるボタンの作成: ページ・アイテム内またはページ・アイテム間にボタンを表示する場合は、このオプションを選択します(たとえば、フォーム・フィールドの横にボタンを直接追加する場合)。

6. 「ボタン属性」で、次のステップを実行します。

1. ボタン名: 対象のボタンの名前を入力します。「ページの送信」のアクションを行うボタンでは、ボタンの名前がページ・リクエストの値になります。たとえば、ボタンにFLOW_RESET_BUTTONという名前を付けると、送信を行わずにカレント・ページをリセットすることがボタンの目的になります。

2. ラベル: ボタンに表示するラベルを入力します。

3. ボタン・スタイル: 使用可能なオプションは次のとおりです。

- HTMLボタン

- テンプレート・ベースのボタン

- イメージ

ボタンがイメージの場合、イメージ名を指定する必要があります。テンプレートによって制御されるボタンの場合、テンプレート名を選択する必要があります。

4. ボタン・テンプレート: どのテンプレートでボタンの表示を制御するかを定義します。ボタン・テンプレートは、テンプレート・ページで定義します。少なくとも1つのボタン・テンプレートを定義しておかないと、ボタン・テンプレートを使用できません。

5. ボタン・タイプ: この属性を使用して、ボタン・テンプレートの「標準」または「ホット」いずれかのテンプレートを選択します。
「ホット」を選択すると、ボタン・テンプレートの「ホット・テンプレート」属性に格納されたテンプレートを使用してボタンがレンダリングされます。値が定義されない場合、標準のボタン・テンプレートが使用されます。

6. ボタン属性: 入力したテキストは、HTML要素の定義に追加されます。次の例では、テキスト・ボタンのクラスを設定しています。

class="myclass"

テンプレートに基づくボタンの場合、テンプレートに#BUTTON_ATTRIBUTES#置換文字列を含める必要があります。これを使用してタブの停止を制御できます。次に例を示します。

tabindex="3"

7. 「次へ」をクリックします。

「表示プロパティ」に表示されるオプションは、選択されたリージョン位置によって決まります。

7. 「表示プロパティ」で、次のステップを実行します。

- ボタン位置が「リージョン位置にボタンの作成」の場合は、次の項目を指定します。

- 順序: このコンポーネントの順序を入力します。これによって評価の順序が決まります。

- 位置: このボタンの位置を選択します。

- 位置合せ: 「右」または「左」を選択します。

- 「次へ」をクリックします。

- ボタン位置が「このリージョン・アイテムで表示されるボタンの作成」の場合は、次の項目を指定します。

- 順序: このコンポーネントの順序を入力します。これによって評価の順序が決まります。

- 「次へ」をクリックします。

8. 「クリックされたときのアクション」で、次の操作を実行します。

1. アクション: ボタンがクリックされたときの動作を選択します。

- ページの送信: 「ボタン名」と等しいREQUEST値とともにカレント・ページを送信します。

- このアプリケーションのページにリダイレクト: ターゲット・ページでのページ区切りのリセット、リクエスト値の設定、キャッシュのクリアおよびアイテム値の設定のためのオプションの追加プロパティとともに、現在のアプリケーション内のページにリダイレクトします。

- URLにリダイレクト: ターゲットURLにリダイレクトします。

- 動的アクションで定義: 何も行われません。ボタンの動作は、「動的アクション」によって定義されます。

- 出力可能なレポート問合せのダウンロード: これにより、「ページの送信」ボタンと対応するブランチが作成されます。ボタンがクリックされると、「レポート問合せ」から出力がダウンロードされます。
このアクションは、アプリケーションの「共有コンポーネント」でレポート問合せを定義している場合にのみ使用可能であることに注意してください。

2. 検証の実行: 「検証の実行」では、ページ送信時の検証の実行を制御します。たとえば、ユーザーがレコードを削除しているときに、「削除」ボタンに無関係な検証エラー・メッセージを表示しないようにする場合に使用できます。
オプションは次のとおりです。

- はい: ページが送信され、この属性が「はい」に設定されている場合、そのページに定義されているすべての検証とすべての組込みの検証が実行されます(たとえば、必須の値が設定されていることを確認するためや、その値が有効な数値や日付であるかどうかを判別するため)。

- いいえ: 「いいえ」に設定すると、定義済の検証と組込みの検証はいずれも実行されません。

この設定に関係なく特定の検証を常に実行する場合、検証属性の「常に実行」を「はい」に設定します。詳細は、「検証を実行するタイミングの決定」を参照してください。

3. 「次へ」をクリックします。

9. 「条件付き表示」で、対象のコンポーネントをレンダリングするうえで満たす必要がある条件タイプをリストから選択します。

10. 「ボタンの作成」をクリックします。

関連項目:
「ボタン名とREQUESTの関係の理解」

ツリー・ビューでのボタンの作成

ツリー・ビューには、リージョン、ページ・アイテムおよびアプリケーション・ロジックがツリー内のノードとして表示されます。ツリー・ビューでボタンを作成するには、リージョンを選択し、次の2つのオプションのいずれかを選択します。

- 「リージョン・ボタンの作成」は、リージョン位置にボタンを表示します。たとえば、リージョン・テンプレートで定義されたとおりに、リージョン位置にボタンを追加します。

- 「ページ・アイテム・ボタンの作成」は、ボタン・アイテム内またはボタン・アイテム間にボタンを表示します。たとえば、ページ・アイテムの後にボタンを配置する場合にこのオプションを使用します。

関連項目:
「ボタン名とREQUESTの関係の理解」

ツリー・ビューでリージョン・ボタンを作成するには、次のステップを実行します。

1. 該当する「ページ定義」にナビゲートします。「「ページ定義」へのアクセス」を参照してください。

2. 必要に応じて、リージョンを作成します。「リージョンの理解」を参照してください。

3. ボタンを含めるリージョンを右クリックし、次のいずれかを選択します。

- リージョン・ボタンの作成: リージョン位置にボタンを表示します。たとえば、リージョン・テンプレートで定義されたとおりに、リージョン位置にボタンを追加します。

- ページ・アイテム・ボタンの作成: ボタン・アイテム内またはボタン・アイテム間にボタンを表示します(たとえば、ページ・アイテムの後にボタンを配置します)。

4. 「ボタン属性」で、次のステップを実行します。

1. ボタン名: 対象のボタンの名前を入力します。「ページの送信」のアクションを行うボタンでは、ボタンの名前がページ・リクエストの値になります。たとえば、ボタンにFLOW_RESET_BUTTONという名前を付けると、送信を行わずにカレント・ページをリセットすることがボタンの目的になります。

2. ラベル: ボタンに表示するラベルを入力します。

3. ボタン・スタイル: 使用可能なオプションは次のとおりです。

- HTMLボタン

- テンプレート・ベースのボタン

- イメージ

ボタンがイメージの場合、イメージ名を指定する必要があります。テンプレートによって制御されるボタンの場合、テンプレート名を選択する必要があります。

4. ボタン・テンプレート: どのテンプレートでボタンの表示を制御するかを定義します。ボタン・テンプレートは、テンプレート・ページで定義します。少なくとも1つのボタン・テンプレートを定義しておかないと、ボタン・テンプレートを使用できません。

5. ボタン・タイプ: この属性を使用して、ボタン・テンプレートの「標準」または「ホット」いずれかのテンプレートを選択します。
「ホット」を選択すると、ボタン・テンプレートの「ホット・テンプレート」属性に格納されたテンプレートを使用してボタンがレンダリングされます。値が定義されない場合、標準のボタン・テンプレートが使用されます。

6. ボタン属性: 入力したテキストは、HTML要素の定義に追加されます。次の例では、テキスト・ボタンのクラスを設定しています。

class="myclass"

テンプレートに基づくボタンの場合、テンプレートに#BUTTON_ATTRIBUTES#置換文字列を含める必要があります。これを使用してタブの停止を制御できます。次に例を示します。

tabindex="3"

7. 「次へ」をクリックします。

「表示プロパティ」に表示されるオプションは、選択されたリージョン位置によって決まります。

5. 「表示プロパティ」で、次のステップを実行します。

- 「リージョン・ボタンの作成」で、次の項目を指定します。

- 順序: このコンポーネントの順序を入力します。これによって評価の順序が決まります。

- 位置: このボタンの位置を選択します。

- 位置合せ: 「右」または「左」を選択します。

- 「次へ」をクリックします。

- 「ページ・アイテム・ボタンの作成」で、次の項目を指定します。

- 順序: このコンポーネントの順序を入力します。これによって評価の順序が決まります。

- 「次へ」をクリックします。

6. 「クリックされたときのアクション」で、次の操作を実行します。

1. アクション: ボタンがクリックされたときの動作を選択します。

- ページの送信: 「ボタン名」と等しいREQUEST値とともにカレント・ページを送信します。

- このアプリケーションのページにリダイレクト: ターゲット・ページでのページ区切りのリセット、リクエスト値の設定、キャッシュのクリアおよびアイテム値の設定のためのオプションの追加プロパティとともに、現在のアプリケーション内のページにリダイレクトします。

- URLにリダイレクト: ターゲットURLにリダイレクトします。

- 動的アクションで定義: 何も行われません。ボタンの動作は、「動的アクション」によって定義されます。

- 出力可能なレポート問合せのダウンロード: これにより、「ページの送信」ボタンと対応するブランチが作成されます。ボタンがクリックされると、「レポート問合せ」から出力がダウンロードされます。
このアクションは、アプリケーションの「共有コンポーネント」でレポート問合せを定義している場合にのみ使用可能であることに注意してください。

2. 検証の実行: 「検証の実行」では、ページ送信時の検証の実行を制御します。たとえば、ユーザーがレコードを削除しているときに、「削除」ボタンに無関係な検証エラー・メッセージを表示しないようにする場合に使用できます。
オプションは次のとおりです。

- はい: ページが送信され、この属性が「はい」に設定されている場合、そのページに定義されているすべての検証とすべての組込みの検証が実行されます(たとえば、必須の値が設定されていることを確認するためや、その値が有効な数値や日付であるかどうかを判別するため)。

- いいえ: 「いいえ」に設定すると、定義済の検証と組込みの検証はいずれも実行されません。

この設定に関係なく特定の検証を常に実行する場合、検証属性の「常に実行」を「はい」に設定します。詳細は、「検証を実行するタイミングの決定」を参照してください。

3. 「次へ」をクリックします。

7. 「条件付き表示」で、対象のコンポーネントをレンダリングするうえで満たす必要がある条件タイプをリストから選択します。

8. 「ボタンの作成」をクリックします。

コンポーネント・ビューでの複数のボタンの作成

コンポーネント・ビューでは、複数のボタンの作成ウィザードを使用して、同じリージョン内に複数の「ページの送信」ボタンを一度に作成できます。

一度に複数のボタンを作成するには、次のステップを実行します。

1. コンポーネント・ビューで該当する「ページ定義」にナビゲートします。「ツリー・ビューとコンポーネント・ビューの切替え」を参照してください。

2. 必要に応じて、HTMLリージョンを作成します。「リージョンの理解」を参照してください。

3. コンポーネント・ビューで「ボタン」セクションを探し、「作成」アイコンをクリックします。
ボタンの作成ウィザードが表示されます。

4. 「複数のボタンの作成」リンクをクリックします。
「複数のボタンの作成」ウィザードが表示されます。

5. 「リージョン」で、このボタンを含めるリージョンを選択します。

6. 「テンプレート」からテンプレートを選択します。テンプレートを選択しない場合、HTMLスタイルのボタンが作成されます。

7. 「HTML属性」で、これらのボタンのHTML属性を指定します。このテキストがHTML要素の定義に追加されます。たとえば、テキスト・ボタンのクラスを次のように設定できます。

class="myclass"

8. 残りのフィールドに迅速に移入するには、ページの右側にある「クイック・ボタン」リストから選択します。

9. 「ボタンの作成」をクリックします。

ボタンの編集

ボタンを編集する場合は、「ページ定義」の「ボタン」セクションから開始します。ボタンの属性の変更、一度に複数のボタンの編集、またはリージョン内のボタン位置の変更を行うことができます。

内容は次のとおりです。

- ボタン属性の編集

- 複数のボタンの同時編集

ボタン属性の編集

ページ・ボタンの編集ページでボタンの属性を編集できます。

既存のボタンの属性を編集するには、次のようにします。

1. 該当する「ページ定義」にナビゲートします。「「ページ定義」へのアクセス」を参照してください。

2. ページ・ボタンの編集ページにアクセスします。

- ツリー・ビュー: 「ページ・レンダリング」で、ボタン名をダブルクリックします。

- コンポーネント・ビュー: 「ボタン」で、ボタン名を選択します。
ページ・ボタンの編集ページが表示されます。

3. ボタン属性を編集します。
ページ上の特定のアイテムの詳細を表示するには、アイテム・ラベルをクリックします。ヘルプが使用できる場合、アイテムの上にカーソルを置くと、カーソルは矢印と疑問符マークに変わります。「フィールドレベル・ヘルプについて」を参照してください。

4. 「変更の適用」をクリックします。

「検証の実行」について

「検証の実行」では、ページ送信時の検証の実行を制御します。たとえば、ユーザーがレコードを削除しているときに、「削除」ボタンに無関係な検証エラー・メッセージを表示しないようにする場合に使用できます。

オプションは次のとおりです。

- はい: ページが送信され、この属性が「はい」に設定されている場合、そのページに定義されているすべての検証とすべての組込みの検証が実行されます(たとえば、必須の値が設定されていることを確認するためや、その値が有効な数値や日付であるかどうかを判別するため)。

- いいえ: 「いいえ」に設定すると、定義済の検証と組込みの検証はいずれも実行されません。

この設定に関係なく特定の検証を常に実行する場合、検証属性の「常に実行」を「はい」に設定します。詳細は、「検証を実行するタイミングの決定」を参照してください。

複数のボタンの同時編集

ボタン・ページを使用して、複数のボタンを削除したり、最近の変更の履歴を表示します。

一度に複数のボタンを編集するには、次のステップを実行します。

1. 該当する「ページ定義」にナビゲートします。「「ページ定義」へのアクセス」を参照してください。

2. ページ・ボタンの編集ページにアクセスします。

- ツリー・ビュー: 「ページ・レンダリング」で、ボタン名を右クリックし、「すべて編集」を選択します。

- コンポーネント・ビュー: 「すべて編集」アイコンをクリックします。「すべて編集」アイコンは、鉛筆が置かれた小さいグリッドの形をしています。

ボタン・ページが表示されます。ボタン・ページには、リージョン内のボタンのリストを示す表が含まれています。

3. 属性を編集し、「変更の適用」をクリックします。

複数のボタンの削除

一度に複数のボタンを削除するには、次のステップを実行します。

1. 該当する「ページ定義」にナビゲートします。「「ページ定義」へのアクセス」を参照してください。

2. ページ・ボタンの編集ページにアクセスします。

- ツリー・ビュー: 「ページ・レンダリング」で、ボタン名を右クリックし、「すべて編集」を選択します。

- コンポーネント・ビュー: 「すべて編集」アイコンをクリックします。「すべて編集」アイコンは、鉛筆が置かれた小さいグリッドの形をしています。
ボタン・ページが表示されます。

3. 「複数のボタンの削除」をクリックします。
複数のボタンの削除ページが表示されます。

4. 削除するボタンを選択して、「ボタンの削除」をクリックします。

履歴

履歴ページを使用して、ボタンの最近の変更のサマリーを表示します。

ボタン名と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の名前で、大/小文字が区別されます。

ボタンを使用したブランチ処理について

各ページには、任意の数のブランチを含めることができます。ブランチは、アプリケーションの他のページまたはURLにリンクします。Application Expressでは、ページ・プロセス中の異なる時点でブランチが検討されます。プロセス前、計算前、検証前およびプロセス後のどの時点でブランチするかを選択できます。アプリケーション・ビルダーの他のコントロールと同様に、ブランチ処理には条件を設定できます。たとえば、ユーザーがボタンをクリックした場合にブランチできます。ブランチを作成する場合は、ブランチを特定のボタンに関連付けます。ブランチは、ユーザーがボタンをクリックした場合にのみ検討されます。

関連項目:
「ブランチを使用したナビゲーションの制御」

ボタンの条件付き表示

ボタンを条件付きで表示するには、「ページ・ボタンの編集」ページの属性を編集します。

ボタンを条件付きで表示するには、次のステップを実行します。

1. ボタンを作成します。詳細は、「ウィザードを使用したボタンの作成」を参照してください。

2. 該当する「ページ定義」にナビゲートします。「「ページ定義」へのアクセス」を参照してください。

3. ページ・ボタンの編集ページにアクセスします。

- ツリー・ビュー: 「ページ・レンダリング」で、ボタンを探し、ボタン名をダブルクリックします。

- コンポーネント・ビュー: 「ボタン」で、ボタン名をクリックします。

4. 「条件」までスクロールします。

5. 「条件タイプ」リストから選択します。

6. 表示されるフィールドに式を入力します。

7. 「変更の適用」をクリックします。

関連項目:
「バインド変数構文について」

アプリケーション・レベルでのLOVの作成

LOVは、ポップアップLOV、選択リスト、チェック・ボックス、ラジオ・グループ、複数の選択リストなどの、特定のタイプのページ・アイテムを表示するために使用される静的または動的な値のセットです。

共有コンポーネントとしてLOVを作成することには次のような利点があります。

- アプリケーション内のすべてのページに追加できます。

- すべてのLOV定義は1つの場所に格納されるため、検索と更新が簡単になります。

内容は次のとおりです。

- アプリケーション・レベルでの名前付きのLOVの作成

- 静的LOVについて

- 既存のLOVの編集

- LOV内でのセッション・ステートの参照

- LOVレポートへのアクセス

関連項目:
「静的値リストの作成」、「カスケードLOVの作成」および「共有コンポーネントでの作業」

アプリケーション・レベルでの名前付きのLOVの作成

アプリケーション・レベルで名前付き(共有) LOVを定義するには、「LOVの作成」ウィザードを実行して、これらのLOVをLOVリポジトリに追加します。すべてのLOVは、静的LOVまたは動的LOVとして定義できます。静的リストは、表示値と戻り値の事前定義された組合せに基づきます。動的リストは、表から値を選択するように作成したSQL問合せに基づきます。

名前付きLOVを作成するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。
「アプリケーション」ホームページが表示されます。

3. 「共有コンポーネント」アイコンをクリックします。

4. 「ユーザー・インタフェース」で、「LOV」を選択します。
LOVページが表示されます。

5. LOVを作成するには、「作成」をクリックします。

6. 画面に表示されるステップに従います。
新しい名前付きのLOVがLOVリポジトリに追加されます。LOVをページに追加するためには該当するアイテムまたは列を編集して名前付きのLOVを選択する必要があることに注意してください。

「LOV」ページについて

作成したLOVは、LOVページに表示されます。

図lov_page.gifの説明

ナビゲーション・バーはページの上部に表示され、次のコントロールが含まれています。

- 「検索列の選択」アイコン: 虫めがねに似ています。このアイコンをクリックして、検索を特定の列のみに絞ります。すべての列を検索するには、「すべての列」を選択します。

- テキスト領域: 大/小文字を区別しない検索基準(ワイルドカード文字は暗黙的に定義される)を入力し、「実行」をクリックします。

- 「実行」ボタン: 検索を実行したり、フィルタを適用します。

- アイコンの表示: 各LOVを大きいアイコンとして表示します。グループを編集するには、該当するアイコンをクリックします。

- レポートの表示: 各LOVをレポート内の1行として表示します。グループを編集するには、名前をクリックします。

- アクション・メニュー: アクション・メニューを表示します。このメニューを使用して、対話モード・レポートをカスタマイズします。「「アクション」メニューについて」を参照してください。

静的LOVについて

静的LOVは、LOVの作成ウィザードの実行時に指定する表示値と戻り値の静的リストに基づきます。静的LOVを作成するには、LOVの作成ウィザードを実行して、LOVタイプに「静的」を選択します。Oracle Application Expressによって、指定した表示値、戻り値およびソート順序がLOVリポジトリに格納されます。リポジトリに静的LOVを追加すると、アイテムを作成し、この定義に基づいてチェック・ボックス、ラジオ・グループ、選択リストまたはポップアップ・リストとしてアイテムを表示できます。

既存のLOVの編集

既存のLOVを編集するには、「LOV」ページでLOVを選択します。

LOVを編集するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「ユーザー・インタフェース」で、「LOV」を選択します。

5. LOVを選択します。
「編集」ページが表示されます。

6. ページ上の特定のアイテムの詳細を表示するには、アイテム・ラベルをクリックします。
ヘルプが使用可能な場合は、アイテムにカーソルをあわせると、カーソルが疑問符付きの矢印に変わります。「フィールドレベル・ヘルプについて」を参照してください。

7. 「変更の適用」をクリックします。

ナビゲーションの選択肢について

LOVの編集ページは、「名前」、「サブスクリプション」および「ソース」のセクションに分かれています。

これらのセクションにアクセスするには、ページをスクロールするか、ページ上部のナビゲーション・ボタンをクリックします。ページ上部のボタンを選択すると、選択されたセクションが表示され、その他のセクションはすべて一時的に非表示になります。ページのすべてのセクションを表示するには、「すべて表示」をクリックします。

静的LOVのバルク編集

「LOVの編集」ページで「グリッド編集」ボタンをクリックすることによって、すべての静的LOVの表示値を編集できます。

静的LOVのバルク編集を実行するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「ユーザー・インタフェース」で、「LOV」を選択します。
デフォルトでは、LOVはアイコンとして表示されます。

5. 「グリッド編集」タブをクリックします。

6. 表示テキストを編集し、「変更の適用」をクリックします。

LOV内でのセッション・ステートの参照

バインド変数を使用することでセッション・ステートを参照できます。セッション・ステートを参照するとLOVは再利用性が多少低下しますが、開発手法として推奨されています。次の例では、このLOVはmy_deptnoというアイテムに有効な部門番号が含まれている場合のみ機能します。

SELECT ename, empno FROM emp WHERE deptno = :P1_DEPTNO

LOVレポートへのアクセス

アプリケーション・ビルダーには、LOVの管理に役立つ多くのレポートが含まれています。

LOVレポートへのアクセス

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. アプリケーション・ビルダーが表示されたら、「共有コンポーネント」をクリックします。

4. 「ユーザー・インタフェース」で、「LOV」を選択します。

5. ページ上部の次のいずれかのタブを選択します。

- NULLテキストの編集

- ローカルに定義

- グリッド編集

- 条件付きエントリ

- サブスクリプション

- 使用状況

- 履歴

6. 画面に表示されるステップに従います。

NULLテキストの編集

「NULLテキストの編集」をクリックすると、アプリケーション内のすべてのLOVのNULLテキストを編集できます。

ローカルに定義

「ローカルに定義」をクリックすると、アイテムの定義でローカルに定義されているすべてのLOVが表示されます。複数のページで使用可能なLOVは、共有LOVに変換できます。ローカルに定義されたLOVを共有LOVに変換すると、再利用が促進されます。

グリッド編集

「グリッド編集」をクリックすると、すべての静的LOVの表示値を編集できます。

条件付きエントリ

「条件付きエントリ」をクリックすると、条件付きで表示されるLOVが表示されます。

サブスクリプション

「サブスクリプション」をクリックすると、LOVのサブスクリプション・ページが表示されます。このページには、アプリケーションに存在するサブスクライブされたLOVがすべて表示されます。

使用状況

「使用状況」をクリックすると、LOVがアプリケーションのどこで使用されているかを示すレポートが表示されます。

履歴

「履歴」をクリックすると、LOV履歴ページが表示されます。このページには、最近変更されたLOVの履歴が日付ごとに表示されます。

ショートカットの使用

ショートカットを使用すると、HTMLまたはPL/SQLファンクションを繰り返しコーディングする必要がなくなります。ショートカットを使用して、ボタン、HTMLテキスト、PL/SQLプロシージャ、HTMLなどのページ・コントロールを定義できます。ショートカットを定義すると、そのショートカットが使用される位置に固有な特定の構文を使用して起動できます。ショートカットは何度でも参照できるため、コードの重複を削減できます。

内容は次のとおりです。

- ショートカット・タイプについて

- ショートカットの定義

- 既存のショートカットの編集

- ショートカット・レポートの表示

ショートカット・タイプについて

ショートカットを作成する際は、作成するショートカットのタイプを指定する必要があります。Oracle Application Expressは、次のショートカット・タイプをサポートしています。

- PL/SQLファンクション本体

- HTMLテキスト

- エスケープされた特殊文字を持つHTMLテキスト

- イメージ

- エスケープされた一重引用符を持つJavaScriptのテキスト

- メッセージ

- エスケープされた一重引用符を持つJavaScriptのメッセージ

エスケープされた一重引用符を持つJavaScriptのテキスト

このタイプのショートカットを使用して、JavaScriptリテラル文字列内部のショートカットを参照します。このショートカットは、テキスト文字列を定義します。ショートカットが参照されると、JavaScriptに必要な一重引用符がエスケープされます。

メッセージ

このタイプのショートカットを使用して、実行時に変換可能なメッセージを参照します。このショートカットには、ショートカット・ボディがないため、ショートカット名と対応するメッセージ名が一致している必要があります。実行時、ショートカット名は、現在の言語に変換可能なメッセージのテキストに拡張されます。

エスケープされた一重引用符を持つJavaScriptのメッセージ

このタイプのショートカットを使用して、JavaScriptリテラル文字列内部のショートカットを参照し、実行時に変換可能なメッセージを参照します。

関連項目:
「アプリケーションの翻訳およびグローバリゼーション・サポートについて」

ショートカットの定義

ショートカットをアプリケーションに組み込むには、ショートカットを定義して、ショートカット・リポジトリに追加する必要があります。ショートカットを参照するには、次の構文を使用します。

"MY_SHORTCUT"

ショートカットの名前は、大文字で指定し、引用符で囲む必要があります。

ショートカットを定義するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. アプリケーション・ビルダーが表示されたら、「共有コンポーネント」をクリックします。

4. ユーザー・インタフェースで、「ショートカット」を選択します。

5. 「作成」をクリックします。

6. 次のいずれかの項目を選択します。

- 最初から

- 既存のショートカットのコピーとして

7. 画面に表示されるステップに従います。

新しいショートカットがショートカット・リポジトリに追加され、次の属性で選択可能になります。

- 「HTMLテキスト(ショートカットあり)」として定義されたリージョンのリージョン・ソース属性。「リージョンの理解」を参照してください。

- リージョンのヘッダーおよびフッターのテキスト属性。詳細は、「リージョンのヘッダーおよびフッターの指定」を参照してください。

- アイテム・ラベル属性およびデフォルト値属性。

- リージョン・テンプレート属性。「テンプレートのカスタマイズ」を参照してください。

ショートカット・ページについて

ショートカットを作成すると、そのショートカットがショートカット・ページに表示されます。「ビュー」リストから選択して、ページの表示方法を制御します。使用可能なオプションは次のとおりです。

- アイコン(デフォルト): 各ショートカットを大きいアイコンとして表示します。ショートカットを編集するには、該当するアイコンをクリックします。

- 詳細: 各ショートカットをレポートで1行に表示します。ショートカットを編集するには、名前をクリックします。

既存のショートカットの編集

作成したショートカットは、ショートカットの編集ページで属性を編集することで変更できます。

既存のショートカットを編集するには、次のようにします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. ユーザー・インタフェースで、「ショートカット」を選択します。

5. ショートカットを選択します。
ショートカットの編集ページが表示されます。

6. ページ上の特定のアイテムの詳細を表示するには、アイテム・ラベルをクリックします。
ヘルプが使用可能な場合は、アイテムにカーソルをあわせると、カーソルが疑問符付きの矢印に変わります。「フィールドレベル・ヘルプについて」を参照してください。

7. 「変更の適用」をクリックします。

ナビゲーションの選択肢について

ショートカットの編集ページは、「名前」、「サブスクリプション」、「ソース」、「構成」および「コメント」のセクションに分かれています。

これらのセクションにアクセスするには、ページをスクロールするか、ページ上部のナビゲーション・ボタンをクリックします。ページ上部のボタンを選択すると、選択されたセクションが表示され、その他のセクションはすべて一時的に非表示になります。ページのすべてのセクションを表示するには、「すべて表示」をクリックします。

ショートカット・レポートへのアクセス

アプリケーション・ビルダーには、ショートカットの管理に役立ついくつかのレポートが含まれています。

ショートカット・レポートにアクセスするには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. アプリケーション・ビルダーが表示されたら、「共有コンポーネント」をクリックします。

4. ユーザー・インタフェースで、「ショートカット」を選択します。

5. 次のいずれかのタブをクリックします。

- サブスクリプション

- 履歴

注意:
「サブスクリプション」タブおよび「履歴」タブが表示されるのは、ショートカットを作成した後のみです。

サブスクライブされたショートカット

「サブスクリプション」をクリックすると、サブスクライブされたショートカット・ページが表示されます。このページには、アプリケーションに存在するサブスクライブされたショートカットがすべて表示されます。

ショートカット履歴

「履歴」をクリックすると、ショートカット履歴ページが表示されます。このページには、最近変更されたショートカットの履歴が日付ごとに表示されます。

ツリーの作成

アプリケーション・ビルダーには、ツリーを生成するための組込みウィザードが用意されています。ツリーでは、jsTreeのJavaScriptベースのブラウザに依存しないツリー・コンポーネントが利用されます。このコンポーネントには、テーマのサポート、オプションのキーボード・ナビゲーションおよびオプションの状態保存機能が備わっています。ツリーは、表またはビューでIDと親ID列を識別することによって階層関係を指定する問合せから作成できます。ツリー問合せでは、START WITH .. CONNECT BY句を利用して、階層問合せを生成します。

内容は次のとおりです。

- ツリーの作成

- 開発者としてのツリーの編集

- 共有コンポーネントとして作成されたツリーについて

ヒント:
jsTreeリージョンの作成は、デスクトップ・ユーザー・インタフェースを使用しているページのみで可能です。

ツリーの作成

ウィザードを使用してツリーを作成するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「ページの作成」をクリックして、「次へ」をクリックします。

4. 「ページ・タイプ」で、「ツリー」を選択します。

5. 「ページ属性」で、次のように指定します。

1. ページ番号: ツリーを作成する必要があるページを指定します。

2. ページ名: 新しいページにツリーを作成する場合、ページ名を入力します。

3. リージョン・テンプレート: ツリー・リージョンのリージョン・テンプレートを選択します。

4. リージョン名: ツリーを含めるリージョンの名前を入力します。

5. ブレッドクラム: ページでブレッドクラム・ナビゲーション・コントロールを使用するかどうか、およびどのブレッドクラム・ナビゲーション・コントロールを使用するかを選択します。「ブレッドクラム」を選択した場合、次のように入力します。

- エントリ名: ブレッドクラム・エントリの名前を入力します。

- 親エントリの選択: 親エントリを選択します。

6. 「次へ」をクリックします。

6. 「タブ」で、ページにタブを含めるかどうかを指定し、「次へ」をクリックします。

7. 「ツリー・テンプレート」で、ツリー・テンプレートを選択し、「次へ」をクリックします。

8. 「表/ビューの所有者と名前」で、ツリーのベースにする表またはビューの所有者と名前を選択し、「次へ」をクリックします。

9. 「問合せ」で、ツリーに含める列を選択します。

1. ID: IDとして使用する列を選択します。

2. 親ID: 親IDとして使用する列を選択します。

3. ノード・テキスト: ツリー・ノードに表示するテキストを選択します。

4. 開始: 階層ツリー問合せのルートを指定するために使用する列を選択します。

5. ツリーを開始: 問合せの開始方法を選択します。オプションは次のとおりです。

- 既存のアイテムに基づく: 既存のアプリケーション・アイテムまたはページ・アイテムを選択します。

- SQL問合せに基づく: 単一行または単一列を返すSQL問合せを入力します。

- 静的値に基づく: 静的値を入力します。

- 値はNULL

6. 「次へ」をクリックします。

10. 「WHEREおよびORDER BY」で、次のように指定します。

1. WHERE句: オプションのWHERE句を入力します。

2. ORDER SIBLINGS BY: 兄弟の並替え基準として使用する列を選択します。

3. 「次へ」をクリックします。

11. 「ツリー属性」で、次のように指定します。

1. ボタンを含む: 含めるボタンを選択します。

2. 選択したノードのページ・アイテム: 選択したノード値を保持するために使用できます。アプリケーション・アイテムを選択した場合、このアイテムを使用して、最後に選択したツリー・ノードの値を保持することで、ツリーの状態を保存できます。

3. ツールチップ: マウスをリーフ・ノードに合わせたときにツールチップを表示します。オプションは次のとおりです。

- 静的割当て: ツールチップ・テキストとして使用する静的値を指定します。静的テキストで置換文字列を使用して、SQL問合せからの情報をツールチップ・テキストに組み込むことができます。使用可能な置換文字列は次のとおりです。
#VALUE#: 「ID」列の値を参照します。

#TITLE#: 「ノード・テキスト」列の値を参照します。

#LINK#: 「リンク」オプションの値を参照します。

- データベース列: ツールチップ・テキストとして使用する列を選択します。

4. 「リンク・オプション」で、次のオプションを選択します。

- 既存のアプリケーション・アイテム: リーフ・ノード・テキストをリンクにします。このオプションを選択する場合、リンク先のページおよびリーフ・ノード・テキストをリンクする既存アプリケーション・アイテムを指定する必要があります。
このオプションは、「既存のアプリケーション・アイテム」リンク・オプションを選択した場合にのみ表示されます。

- なし

5. 「次へ」をクリックします。

12. 選択内容を確認して、「終了」をクリックします。

開発者としてのツリーの編集

デフォルトではツリーにフォーカスが置かれておらず、シングルクリック・アクションによってノード・リンクがアクティブ化されます。このセクションでは、開発者がツリー属性を編集してツリーをカスタマイズする方法について説明します。

ツリー属性ページへのアクセス

開発者は、ツリー属性ページで属性を編集してツリーをカスタマイズできます。

ツリー属性ページにアクセスするには、次のステップを実行します。

1. 該当する「ページ定義」にナビゲートします。「「ページ定義」へのアクセス」を参照してください。

2. ツリー属性ページにアクセスします。

- ツリー・ビュー: リージョン名を右クリックし、「ツリーの編集」を選択します。

- コンポーネント・ビュー: 「リージョン」で、編集するツリー・リージョンの名前の横にある「ツリー」リンクをクリックします。

ツリー属性ページが表示されます。このページは次のセクションに分かれています。

- 「表示設定」を使用すると、ツリーの外観と機能を制御できます。これらの設定を使用して、ツリー・テンプレート、ツールチップおよびページ・アイテム(最後に選択したノード値を保持してツリー状態を保存するためのもの)の定義、ページのロード時にツリーをフォーカスするかどうかの決定、およびツリー上のノード・リンクをアクティブ化するためのアクションの決定を行います。

- 「問合せ」を使用すると、ツリーの基礎となるSQL問合せを編集できます。問合せは、次の形式にする必要があります。

SELECT status, level, name, icon, id, tooltip, link
FROM ...
WHERE ...
START WITH...
CONNECT BY PRIOR id = pid

ORDER SIBLINGS BY ...

3. 特定の属性の詳細を表示するには、アイテム・ラベルをクリックします。
ヘルプが使用可能な場合は、アイテムにカーソルをあわせると、カーソルが疑問符付きの矢印に変わります。「フィールドレベル・ヘルプについて」を参照してください。

4. 「変更の適用」をクリックします。

共有コンポーネントとして作成されたツリーについて

Oracle Application Expressの以前のリリースでは、共有コンポーネントとしてのツリーの作成がサポートされていました。既存のツリーはまだサポートされますが、Oracle Application Expressでは共有コンポーネントとしてのツリーの作成がサポートされなくなりました。

Oracle Application Expressでは、jsTreeツリー・リージョンの生成がサポートされるようになりました。jsTreeは、JavaScriptベースのブラウザに依存しないツリー・コンポーネントです。jQueryプラグインとしてパッケージ化されています。詳細は、「ツリーの作成」を参照してください。

内容は次のとおりです。

- 既存のツリーの編集

- 既存のツリー・レポートへのアクセス

既存のツリーの編集

ツリーを共有コンポーネントとして作成した後、そのツリーをツリー・ページで編集できます。

共有コンポーネントとして作成されたツリーを編集するには、次のステップを実行します。

1. ツリー・ページにナビゲートします。

1. 「ワークスペース」ホームページにナビゲートします。

2. 「アプリケーション・ビルダー」アイコンをクリックします。

3. アプリケーションを選択します。

4. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

5. 「ナビゲーション」で、「ツリー」をクリックします。
ツリー・ページが表示されます。

ページの外観は、ページ上部にある検索バーを使用して変更できます。「対話モード・レポートのカスタマイズ」を参照してください。

2. ツリーを選択します。
ツリーの編集ページが表示されます。

3. 対象となる属性を編集します。

4. ページ上の特定のアイテムの詳細を表示するには、アイテム・ラベルをクリックします。「フィールドレベル・ヘルプについて」を参照してください。

5. 「変更の適用」をクリックします。

ナビゲーションの選択肢について

ツリーの編集ページは、「名前」、「問合せ」、「前後」、「静的ノード・テンプレート」、「動的テンプレート」、「ノード・テキスト・テンプレート」および「リンク・テンプレート」というセクションに分かれています。

これらのセクションにアクセスするには、ページをスクロールするか、ページ上部のナビゲーション・ボタンをクリックします。ページ上部のボタンを選択すると、選択されたセクションが表示され、その他のセクションはすべて一時的に非表示になります。ページのすべてのセクションを表示するには、「すべて表示」をクリックします。

既存のツリー・レポートへのアクセス

「ツリー」ページ上部の該当するタブをクリックすると、ツリーの使用状況およびツリー履歴レポートを表示できます。

ツリー・レポートを表示するには、次のステップを実行します。

1. ツリー・ページにナビゲートします。

1. 「ワークスペース」ホームページにナビゲートします。

2. 「アプリケーション・ビルダー」アイコンをクリックします。

3. アプリケーションを選択します。

4. アプリケーションのホームページで、「共有コンポーネント」をクリックします。

5. 「ナビゲーション」で、「ツリー」をクリックします。

2. 該当するタブをクリックします。

- 使用状況

- 履歴

ページの外観は、ページ上部にある検索バーを使用して変更できます。「対話モード・レポートのカスタマイズ」を参照してください。

詳細は、次に続くセクションを参照してください。

注意:
「使用状況」ボタンと「履歴」ボタンが表示されるのは、ツリーを作成した後のみです。

ツリーの使用状況

ツリー・ページの「使用状況」をクリックすると、「ツリーの使用状況」レポートにアクセスできます。このレポートには、カレント・アプリケーションに含まれるすべてのツリーが表示されます。ツリーを編集するには、ツリー名を選択します。

ツリー履歴

ツリー・ページの「履歴」をクリックすると、ツリーに対する変更が開発者および日付ごとに表示されます。

「検索」アイコンの使用

アプリケーション・ビルダー内の多くのページで、「検索」アイコンをクリックすることでアイテム、ページ、問合せ、表、PL/SQLコードまたはイメージを検索できます。

内容は次のとおりです。

- 「検索」アイコンについて

- 「アイテム・ファインダ」について

- ページ・ファインダの使用

- 問合せファインダの使用

- 表ファインダの使用

- PL/SQLファインダの使用

- イメージ・ファインダの使用

関連項目:
「アプリケーションのデバッグ」

「検索」アイコンについて

「検索」アイコンは次の図に示すように懐中電灯のような形をしており、ほとんどの場合「ページの実行」および「ページの編集」アイコンの右側に表示されます。「検索」アイコンは、「アプリケーション」ホームページ、「ページ定義」、アプリケーション属性ページ、および共有コンポーネントを作成および管理するためのページなど、アプリケーション・ビルダーの多くのページに表示されます。

図find_icon.gifの説明

関連項目:
「「アプリケーション」ホームページについて」

「アイテム・ファインダ」について

アプリケーション・ビルダーでは、アイテムはテキスト・フィールド、テキスト領域、パスワード、選択リスト、チェック・ボックスなどを示します。「アイテム・ファインダ」を使用すると、現在のアプリケーション内、またはワークスペースに関連付けられたスキーマ内のアイテムを検索できます。

関連項目:
「ページ・レベル・アイテムの理解」

「アイテム・ファインダ」を使用してアイテムを検索するには、次のステップを実行します。

1. 「検索」アイコンをクリックします。
アイテム・ファインダが表示されます。検索バーはページの上部に表示され、次のコントロールが含まれています。

- 「列の選択」アイコン: 虫めがねに似ています。このアイコンをクリックして、検索を特定の列に絞り込みます。すべての列を検索するには、「すべての列」を選択します。

- テキスト領域: 大/小文字を区別しない検索基準(ワイルドカード文字は暗黙的に定義される)を入力し、「実行」をクリックします。

- 「実行」ボタン: 検索を実行します。

- 「アクション」メニュー: アイコンをクリックすると、「アクション」メニューが表示されます。このメニューを使用して、対話モード・レポートをカスタマイズします。「「アクション」メニューについて」を参照してください。

図item_finder.gifの説明

2. 特定のページのアイテムのみを表示するようにレポートを限定する場合は、一番右側の列で該当するページ番号をクリックします。
ページ上部の「ページ」フィールドに、選択したページ番号が表示されます。ビューを開いてすべてのページを表示するには、「ページ」フィールドのページ番号を削除して、「実行」をクリックします。

3. 特定のアイテムを編集するには、該当するアイテムにナビゲートします。「ページ・レベル・アイテムの理解」および「複数のアイテムの同時編集」を参照してください。

ページ・ファインダの使用

ページ(または「ページ定義」)はアプリケーションの基本的な構成要素です。ページ・ファインダを使用すると、現在のアプリケーション内、またはワークスペースに関連付けられたスキーマ内のページを検索できます。

ページを検索するには、次のステップを実行します。

1. 「検索」アイコンをクリックします。

2. 「ページ」タブをクリックします。
ページ・ファインダ・レポートが表示され、ここにページ番号、ページ名、ページ別名、タイトル、タブ・セット、およびページ上のアイテムおよびリージョン数のカウントが表示されます。

検索バーはページの上部に表示され、次のコントロールが含まれています。

- 「検索列の選択」アイコン: 虫めがねに似ています。このアイコンをクリックして、検索を特定の列に絞り込みます。すべての列を検索するには、「すべての列」を選択します。

- テキスト領域: 大/小文字を区別しない検索基準(ワイルドカード文字は暗黙的に定義される)を入力し、「実行」をクリックします。

- 「実行」ボタン: 検索を実行します。

- 「アクション」メニュー: アイコンをクリックすると、「アクション」メニューが表示されます。このメニューを使用して、対話モード・レポートをカスタマイズします。「「アクション」メニューについて」を参照してください。

図pages_finder.gifの説明

3. アイテム・ページにリンクするには、ページ番号をクリックします。

関連項目:
「「ページ定義」について」および「コンポーネント・ビューでのページの編集」

問合せファインダの使用

問合せファインダを使用すると、アプリケーション内、またはワークスペースに関連付けられたスキーマ内の問合せを検索できます。

問合せファインダを使用して問合せを検索するには、次のステップを実行します。

1. 「検索」アイコンをクリックします。

2. 「問合せ」タブをクリックします。
「問合せファインダ」レポートが表示され、その中にはページ番号、ページ名、問合せを含むリージョンおよび問合せソースが含まれます。

検索バーはページの上部に表示され、次のコントロールが含まれています。

- 「検索列の選択」アイコン: 虫めがねに似ています。このアイコンをクリックして、検索を特定の列に絞り込みます。すべての列を検索するには、「すべての列」を選択します。

- テキスト領域: 大/小文字を区別しない検索基準(ワイルドカード文字は暗黙的に定義される)を入力し、「実行」をクリックします。

- 「実行」ボタン: 検索を実行します。

- 「アクション」メニュー: アイコンをクリックすると、「アクション」メニューが表示されます。このメニューを使用して、対話モード・レポートをカスタマイズします。「「アクション」メニューについて」を参照してください。

図query_finder.gifの説明

3. アイテム・ページにリンクするには、ページ番号をクリックします。

関連項目:
「「ページ定義」について」および「コンポーネント・ビューでのページの編集」

表ファインダの使用

表ファインダを使用すると、ワークスペースに関連付けられたスキーマ内の表を表示できます。

現在のスキーマに関連付けられた表を表示するには、次のステップを実行します。

1. 「検索」アイコンをクリックします。

2. 「表」タブをクリックします。
表ファインダが表示されます。

図table_finder.gifの説明

選択したタブを表示する検索バーはページの上部に表示され、次のコントロールが含まれています。

- 「検索列の選択」アイコン: 虫めがねに似ています。このアイコンをクリックして、検索を特定の列に絞り込みます。すべての列を検索するには、「すべての列」を選択します。

- テキスト領域: 大/小文字を区別しない検索基準(ワイルドカード文字は暗黙的に定義される)を入力し、「実行」をクリックします。

- 「実行」ボタン: 検索を実行します。

- 「アクション」メニュー: アイコンをクリックすると、「アクション」メニューが表示されます。このメニューを使用して、対話モード・レポートをカスタマイズします。「「アクション」メニューについて」を参照してください。

3. 表名を選択します。
表定義が表示されます。

このレポートには列名、データ型、長さ、精度およびスケールが表示され、ページ下部には表を再作成するために必要なSQLが表示されます。

関連項目:
Oracle Application Express SQLワークショップ・ガイドの「表の管理」

PL/SQLファインダの使用

PL/SQLファインダを使用すると、ワークスペースに関連付けられたスキーマ内の、各オブジェクトに関連付けられたストアド・プロシージャ、ファンクションおよびパッケージに関する詳細を検索して表示できます。

現在のスキーマのPL/SQLコードを検索するには、次のステップを実行します。

1. 「検索」アイコンをクリックします。

2. 「PL/SQL」タブをクリックします。
PL/SQLファインダが表示されます。

検索バーはページの上部に表示され、次のコントロールが含まれています。

- 「検索列の選択」アイコン: 虫めがねに似ています。このアイコンをクリックして、検索を特定の列に絞り込みます。すべての列を検索するには、「すべての列」を選択します。

- テキスト領域: 大/小文字を区別しない検索基準(ワイルドカード文字は暗黙的に定義される)を入力し、「実行」をクリックします。

- 「実行」ボタン: 検索を実行します。

- 「アクション」メニュー: アイコンをクリックすると、「アクション」メニューが表示されます。このメニューを使用して、対話モード・レポートをカスタマイズします。「「アクション」メニューについて」を参照してください。

3. 詳細を表示するには、プロシージャ、ファンクションまたはパッケージの名前を選択します。
図plsql_finder.gifの説明

プロシージャ、パッケージまたはファンクションの名前が、所有者、ソース名、ソース・タイプ、戻り型、引数名、データ型およびIN/OUTパラメータなどの情報とともに表示されます。

関連項目:
『Oracle Application Express SQLワークショップ・ガイド』の「オブジェクト・ブラウザを使用したデータベース・オブジェクトの管理」

イメージ・ファインダの使用

イメージ・ファインダを使用して、カレント・アプリケーションに使用可能なイメージを識別できます。

使用可能なイメージを表示するには、次のステップを実行します。

1. 「検索」アイコンをクリックします。

2. 「イメージ」タブをクリックします。
イメージ・ファインダが表示されます。

図image_finder.gifの説明

検索バーはページの上部に表示され、次のコントロールが含まれています。

- 「検索列の選択」アイコン: 虫めがねに似ています。このアイコンをクリックして、検索を特定の列に絞り込みます。すべての列を検索するには、「すべての列」を選択します。

- テキスト領域: 大/小文字を区別しない検索基準(ワイルドカード文字は暗黙的に定義される)を入力し、「実行」をクリックします。

- 「実行」ボタン: 検索を実行します。

- 「アクション」メニュー: アイコンをクリックすると、「アクション」メニューが表示されます。このメニューを使用して、対話モード・レポートをカスタマイズします。「「アクション」メニューについて」を参照してください。

3. 「表示」から、表示するイメージのタイプを選択します。オプションは次のとおりです。

- 標準イメージ

- ワークスペース・イメージ

- アプリケーション・イメージ

関連項目:
『Oracle Application Express SQLワークショップ・ガイド』の「オブジェクト・ブラウザを使用したデータベース・オブジェクトの管理」

アプリケーション、ページおよびページ・コンポーネントへのアクセスの制御

アクセス制御リストを作成することによって、アプリケーション、個別ページまたはページ・コンポーネントへのアクセスを制御できます。アクセス制御ページを作成するには、アプリケーション・スキーマにCREATE TABLE、CREATE TRIGGER、CREATE SEQUENCE権限を割り当てる必要があります。

内容は次のとおりです。

- アクセス制御リストの動作方法

- アクセス制御リストの作成

- アプリケーション・モードの選択とユーザーの追加

- ページおよびページ・コンポーネントに対するアクセスの制御

関連項目:
Oracle Application Express SQLワークショップ・ガイドの「クエリー・ビルダーを使用した問合せの構築」

アクセス制御リストの動作方法

アクセス制御ウィザードを実行して、アクセス制御リストを作成します。アクセス制御ウィザードにより、Access Control Administrationという名前のページが作成されます。このページにはアプリケーション・モード・リストとアクセス制御リストが含まれます。アクセス制御管理ページを作成したら、次のようにします。

1. アクセス制御管理ページを実行します。

2. 次のいずれかのアプリケーション・モードを選択します。

- すべての対象への完全なアクセス権。アクセス制御リストは使用されません。

- 制限されたアクセス。アクセス制御リストに定義されたユーザーのみが許可されます。

- パブリック読取り専用。アクセス制御リストによって制御される編集および管理の権限です。

- 管理アクセス専用。

3. アクセス制御リストにユーザーを追加します。

アクセス制御管理ページを作成する以外に、アクセス制御ウィザードでは次のものを作成します。

- アクセス制御を管理するためのアプリケーションのデフォルト・スキーマ内に2つの表

- アプリケーション・モード・リストのオプションに対応する認可スキーム

- 「アクセス制御」リストで使用可能な権限

これらの認可スキームの中の1つをページまたはコンポーネント属性ページで選択することで、特定のページまたはページ・コンポーネントへのアクセスを制御できます。アクセス制御を作成したら、アプリケーションの特定のニーズに合うようにページ、表および値をカスタマイズできます。

関連項目:
「アプリケーションへの認可スキームの割当て」

アクセス制御リストの作成

ページを作成することでアクセス制御リストを作成します。「アプリケーション」ホームページ上で、または「ページ定義」の表示時に、または「開発者」ツールバーで「作成」をクリックすることで、ページを作成できます。

内容は次のとおりです。

- 「アプリケーション」ホームページからのアクセス制御リストの作成

- 「ページ定義」からのアクセス制御リストの作成

- 「開発者」ツールバーからのアクセス制御リストの作成

「アプリケーション」ホームページからのアクセス制御リストの作成

「アプリケーション」ホームページからアクセス制御リストを作成するには、次のようにします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。
「アプリケーション」ホームページが表示されます。

3. 「ページの作成」をクリックします。

4. ページ・タイプとして「アクセス制御」を選択し、「次へ」をクリックします。
アクセス制御ウィザードウィザードが表示されます。

5. ページ番号を指定し、「次へ」をクリックします。

6. タブ・オプションを選択し、「次へ」をクリックします。

7. 確認ページを確認して、「作成」をクリックします。

「ページ定義」からのアクセス制御リストの作成

「ページ定義」からアクセス制御リストを作成するには、次のようにします。

1. 該当する「ページ定義」にナビゲートします。「「ページ定義」へのアクセス」を参照してください。

2. ページ上部の「作成」ボタンをクリックします。

3. 「新しいページ」をクリックし、「新しいページ」を選択します。

4. ページ・タイプとして「アクセス制御」を選択し、「次へ」をクリックします。
アクセス制御ウィザードウィザードが表示されます。

5. ページ番号を指定し、「次へ」をクリックします。

6. タブ・オプションを選択し、「次へ」をクリックします。

7. ページを確認して、「終了」をクリックします。

「開発者」ツールバーからのアクセス制御リストの作成

「開発者」ツールバーからアクセス制御リストを作成するには、次のようにします。

1. アプリケーションを実行します。「アプリケーションまたはページの実行」を参照してください。

2. 「開発者」ツールバーで「作成」をクリックします。
「新しいコンポーネント」ウィザードが表示されます。

3. 「新しいページ」を選択して、「次へ」をクリックします。

4. ページ・タイプとして「アクセス制御」を選択し、「次へ」をクリックします。
アクセス制御ウィザードウィザードが表示されます。

5. ページ番号を指定し、「次へ」をクリックします。

6. タブ・オプションを選択し、「次へ」をクリックします。

7. ページを確認して、「終了」をクリックします。

アプリケーション・モードの選択とユーザーの追加

アクセス制御管理ページを実行し、アプリケーション・モードを選択してからアクセス制御リストへユーザーを追加することによって、アプリケーションへのアクセスを制御できます。

内容は次のとおりです。

- アプリケーション・モードの選択

- アクセス制御リストへのユーザーの追加と権限の選択

- アクセス制御リストからのユーザーの削除

アプリケーション・モードの選択

アプリケーション・モードを選択するには、次のようにします。

1. アクセス制御リストを作成します。「アクセス制御リストの作成」を参照してください。
アクセス制御管理というページが作成されます。

2. アクセス制御管理ページを実行します。「アプリケーションまたはページの実行」を参照してください。

3. アプリケーション・モードを選択します。オプションは次のとおりです。

- すべての対象への完全なアクセス権。アクセス制御リストは使用されません。
すべてのユーザーがアプリケーションにアクセスできるようにするには、このオプションを選択します。

- 制限されたアクセス。アクセス制御リストに定義されたユーザーのみが許可されます。
アクセス制御リスト上のユーザーのみにアクセスを許可するには、このオプションを選択します。アクセス制御リスト上のユーザーだけが、認可スキームに関連付けられたページおよびコンポーネントを表示できます。

- パブリック読取り専用。アクセス制御リストによって制御される編集および管理の権限です。
アクセス制御 - 認可スキームの表示に関連付けられたページおよびコンポーネントに、パブリック・アクセスを提供します。

- 管理アクセス専用。.
管理者権限を持つユーザーのみが、認可スキームに関連付けられたページまたはコンポーネントにアクセスできます。

4. 「アプリケーション・モードの設定」をクリックします。
access_control_1.gifの説明

ページのユーザー・インタフェースは、アプリケーションで選択したテーマによって異なります。「テーマの管理」を参照してください。

次は、アクセス制御リストにユーザーを追加します。

アクセス制御リストへのユーザーの追加と権限の選択

アクセス制御リストにユーザーを追加するには、次のようにします。

1. アクセス制御リストの下で、「ユーザーの追加」をクリックします。
新しい行が表示されます。

access_control_2.gifの説明

2. 「ユーザー名」フィールドにユーザー名を入力します。

3. ユーザーに権限を関連付けます。使用可能なオプションは次のとおりです。

- 管理者

- 編集

- 表示

4. 「変更の適用」をクリックします。

5. すべてのユーザーに対して、ステップ1から5を繰り返します。

アクセス制御リストからのユーザーの削除

アクセス制御リストからユーザーを削除するには、次のようにします。

1. ユーザー名の左側のチェック・ボックスを選択して、削除するユーザーを選択します。

2. 「削除」をクリックします。

ページおよびページ・コンポーネントに対するアクセスの制御

アクセス制御ウィザードでは、アプリケーション・モード・リストのオプションとアクセス制御リストで可能な権限に対応する認可スキームが作成されます。

次の認可スキームの中の1つをページまたはコンポーネント属性ページで選択することで、特定のページまたはページ・コンポーネントへのアクセスを制御できます。

- アクセス制御 - 管理者。管理者権限を持つユーザーのみがページまたはコンポーネントを表示できます。

- アクセス制御 - 編集。編集および管理者権限の両方を持つユーザーがページまたはコンポーネントを表示できます。表示権限を持つユーザーはページまたはコンポーネントを表示できません。

- アクセス制御 - 表示。管理者、編集または表示権限を持つユーザーがページまたはコンポーネントを表示できます。

- 非アクセス制御 - 管理者。管理者権限を持つユーザーはページまたはコンポーネントを表示できません。

- 非アクセス制御 - 編集。編集および管理者権限の両方を持つユーザーはページまたはコンポーネントを表示できません。表示権限を持つユーザーがページまたはコンポーネントを表示できます。

- 非アクセス制御 - 表示。管理者、編集または表示権限を持つユーザーはページまたはコンポーネントを表示できません。

関連項目:
「アプリケーション、ページまたはコンポーネントへの認可スキームの割当て」

アプリケーションへのJavaScriptの組込み

Webデプロイメントのすべてのメリットを失わずに、クライアント/サーバー・アプリケーションと同等の機能を追加する最も有効な方法は、JavaScriptをWebアプリケーションに追加する方法です。Oracle Application Expressには、JavaScript追加専用に設計された複数の組込みインタフェース(フック)が含まれています。

JavaScriptは、データ処理集中型検証には適していません。たとえば、名前が大規模データベース表内に含まれていることを検証するには、大容量のHTMLドキュメントを作成して、すべてのレコードをクライアントにプルダウンする必要があります。通常、複雑な操作には、JavaScriptではなくサーバー・サイドApplication Express検証の方がより適しています。

内容は次のとおりです。

- JavaScriptを使用したアイテムの参照

- JavaScript属性を利用したJavaScriptの組込み

- HTMLヘッダー属性からのJavaScriptファイルのコール

- ページ・テンプレートからのJavaScriptファイルのコール

- ボタンからのJavaScriptのコール

- 動的アクションを使用したJavaScriptのコール

関連項目:
「JavaScriptにより一重引用符がエスケープされたテキスト」(JavaScriptリテラル文字列内のショートカットの参照の詳細)、「検証の理解」および「プラグインでのJavaScriptコードの使用」

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に関する説明

JavaScript属性を利用したJavaScriptの組込み

JavaScriptをページのJavaScript属性に追加することによって、JavaScriptをアプリケーションに含めることができます。これは、ページに固有のファンクションに有効な方法であり、ファンクションを.jsファイルに組み込む前にテストを行う有効な方法です。

次の例では、コードを追加することによって、カレント・ページの任意の場所からtestファンクションにアクセスできるようにしています。

JavaScriptコードをJavaScript属性に追加するには、次のステップを実行します。

1. 「ページ定義」にナビゲートします。「「ページ定義」へのアクセス」を参照してください。

2. 編集ページにアクセスするには、次の操作を実行します。

- ツリー・ビュー: 「ページ・レンダリング」で、ツリーの上部のページ・タイトルをダブルクリックします。

- コンポーネント・ビュー: 「ページ」で、「編集」アイコンをクリックします。

3. 「JavaScript」までスクロールします。

4. 次の場所にコードを入力します。

- ファンクションおよびグローバル変数の宣言: 対象のページで使用するコード用のJavaScriptコード(たとえば、ファンクションまたはグローバル変数宣言)を入力します。コードを複数のページで使用する場合は、そのコードを外部のJavaScriptファイルに追加して重複を避けることを検討してください。
ここに入力したコードによって、ページ・テンプレート内の#JAVASCRIPT_CODE#置換文字列が置き換えられます。

- ページ・ロード時に実行: ページのロード時に実行するJavaScriptコードを入力します。このコードはOracle Application Expressによって生成されたJavaScriptコードの後に実行されます。

たとえば、次のコードを追加すると、カレント・ページのすべての場所からアクセス可能なファンクションをテストします。

function test(){
alert('This is a test.');
}

5. 変更を適用します。

HTMLヘッダー属性からのJavaScriptファイルのコール

HTMLヘッダー属性から.jsファイルをコールするには、次のステップを実行します。

1. 「ページ定義」にナビゲートします。「「ページ定義」へのアクセス」を参照してください。

2. 編集ページにアクセスするには、次の操作を実行します。

- ツリー・ビュー: 「ページ・レンダリング」で、ツリーの上部のページ・タイトルをダブルクリックします。

- コンポーネント・ビュー: 「ページ」で、「編集」アイコンをクリックします。

3. 「HTMLヘッダーおよびボディ属性」までスクロールします。

4. 「HTMLヘッダー」で、次の構文を使用してJavaScriptファイルをコールします。

<script src="/my_images/custom.js" type="text/javascript"></script>

5. 変更を適用します。

ページ・テンプレートからのJavaScriptファイルのコール

Oracle Application Expressではページ・テンプレートで.jsファイルを参照できます。このアプローチによって、そのファイル内のすべてのJavaScriptがアプリケーションにアクセス可能になります。.jsファイルはアプリケーションの最初のページ・ビューにロードされてからブラウザでキャッシュされるため、これは最も効率的なアプローチです。

ページ・テンプレートのヘッダー・セクションに.jsファイルを含める例を次に示します。script src=行が太字になっています。

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<title>#TITLE#</title>
#HEAD#
<script src="/my_images/custom.js" type="text/javascript"></script>
</head>
<body #ONLOAD#>#FORM_OPEN#

関連項目:
「ページ・テンプレート」

ボタンからの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を使用しなくても、この例を簡単に実装できます。かわりに、同様に翻訳可能な宣言的アクションの「確認」と「ページの送信」を使用できます。詳細は、「動的アクションの実装」を参照してください。

動的アクションを使用したJavaScriptのコール

動的アクションを作成することによっても、JavaScriptコードを実行できます。JavaScriptコードは、JavaScriptの実行と「値の設定」タイプで実行できます。条件タイプを「JavaScript式」に設定することにより、動的アクションの条件に対してJavaScriptコードを使用することもできます。詳細は、「動的アクションの実装」を参照してください。

jQueryとjQuery UIサポートについて

Oracle Application Expressには、jQuery 1.7.1、jQuery UI 1.8.22およびjQuery Mobile - 1.1.1 RC1 JavaScriptライブラリが含まれています。この項では、jQuery UIで使用できる機能と、JavaScriptコードでjQueryライブラリを参照する場合のベスト・プラクティスについて説明します。

内容は次のとおりです。

- 使用できるjQuery UI機能について

- JavaScriptコードでのjQueryライブラリの参照

使用できる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とこれらの特定のコンポーネントの詳細は、次のjQuery UIのサイトを参照してください。

http://jqueryui.com/

その他のjQuery UIコンポーネントへのアクセス

Oracle Application Expressには、jQuery UIライブラリ全体は含まれていません。関連ファイルを含めるだけで、jQuery UIの他のコンポーネントを簡単にアクティブ化できます。たとえば、Tabs jQuery UI Widgetをアプリケーションに含めるには、ページ・テンプレートの<head>...</head>タグで囲まれたヘッダーに、次の例に示す項目を含めます。

<link href="#IMAGE_PREFIX#libraries/jquery-ui/1.8.22/themes/base/minified/jquery.ui.tabs.min.css" rel="stylesheet" type="text/css" />
<script src="#IMAGE_PREFIX#libraries/jquery-ui/1.8.22/ui/minified/jquery.ui.tabs.min.js" type="text/javascript"></script>

ヒント:
前述のデフォルト・コンポーネントのリストに示すように、UI CoreとUI Widgetのタブの依存性はOracle Application Expressにデフォルトで含まれているため、この依存性を含める必要はありません。

JavaScriptコードでのjQueryライブラリの参照

独自のJavaScriptコードでjQueryライブラリへの$、jQueryおよびapex.jQuery参照をいつ使用するかは、どこでそれを使用するかによって決まります。

Oracle Application Expressのより新しいバージョンには、jQueryライブラリの更新バージョンが含まれていることがあります。新しいバージョンのjQueryがリリースされる際に、既存の機能を無効にする変更が導入されることがあります。これらの問題は、特定のバージョンのリリース・ノートの変更ログに記載されています。新しいバージョンのOracle Application Expressにアップグレードする際に問題が発生する可能性を最小限に抑えるには、後続の項で説明するベスト・プラクティスに従うことをお薦めします。

内容は次のとおりです。

- アプリケーションでのJavaScriptコードの管理

- プラグインでのJavaScriptコードの使用

アプリケーションでの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リリース4.2に含まれる新しいバージョン1.7.1ではありません。

ヒント:
Oracle Application Expressリリース4.2にはjQueryバージョン1.6.2が含まれるため、お使いの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は引き続きそのバージョンを指すことに注意してください。

プラグインでの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バージョンでプラグインをテストできます。

印刷用ページの最適化

特定の印刷用テンプレートを作成し、テーマの作成/編集ページでそのテンプレートを選択することで、印刷用のページを最適化できます。「テーマの編集」を参照してください。

一般に、印刷用テンプレートは、印刷用のページを最適化します。たとえば、印刷用テンプレートは、次のことを行います。

- タブまたはナビゲーション・バーを非表示にします。

- アイテムをフォーム要素ではなくテキストとして表示します

選択したテーマに印刷用テンプレートが含まれていない場合、新しいページ・テンプレートを作成することによって印刷用テンプレートを作成できます。

関連項目:
「テーマの編集」、「テーマの作成」および

内容は次のとおりです。

- アプリケーションの印刷用テンプレートの選択

- f?p構文を使用した印刷用モードへの切替え

アプリケーションの印刷用テンプレートの選択

印刷用テンプレートを選択するには、次のステップを実行します。

1. テーマ・ページにナビゲートします。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「ユーザー・インタフェース」で、「テーマ」を選択します。
テーマ・ページが表示されます。

2. 「レポートの表示」アイコンをクリックして、レポート・ビューに切り替えます。

3. 「テーマ」リストで、テーマ名をクリックします。
テーマの作成/編集ページが表示されます。

4. 「コンポーネントのデフォルト値」までスクロールして、「「印刷用」ページ」リストを探します。

5. 「「印刷用」ページ」リストから選択します。

6. 「変更の適用」をクリックします。

関連項目:
「テーマの編集」

f?p構文を使用した印刷用モードへの切替え

印刷用テンプレートを作成して選択した後、f?p構文を使用して印刷用モードに切り替えることができます。f?p構文の9番目の引数(PrinterFriendly)を指定すると、ページが印刷用(印刷用に最適化された)モードでレンダリングされます。たとえば、リンクのコーディング時、またはナビゲーション・バー・アイコンの作成時に、この引数を含めることができます。

関連項目:
「f?p構文を使用したページのリンク」

ヘルプ・ページの作成

アプリケーション・ビルダーには、アプリケーションのヘルプを作成するための組込み属性が含まれています。アプリケーションのヘルプを作成するには、次のステップを実行します。

1. 専用のヘルプ・ページおよび「ヘルプ」リージョンの作成

2. ページ・ヘルプ・テキストの定義

3. アイテム・ヘルプ・テキストの定義

4. ヘルプ・ページにリンクするためのナビゲーション・バー・アイコンの作成

アプリケーション・ビルダーで作成したヘルプは、専用の「ヘルプ」ページに表示されます。ヘルプを表示するには、専用の「ヘルプ」ページへのリンクをクリックします。この「ヘルプ」ページには、表示しているページに固有のページ・ヘルプおよびアイテム・ヘルプのトピックが表示されます。

内容は次のとおりです。

- ヘルプ・ページおよびヘルプ・リージョンの作成

- ヘルプ・テキストの定義

- ヘルプ・ナビゲーション・バー・エントリの作成

ヘルプ・ページおよびヘルプ・リージョンの作成

アプリケーションのヘルプを作成するための最初のステップは、専用のページおよび「ヘルプ・テキスト」リージョンを作成することです。

「ヘルプ・テキスト」リージョンを作成するには、次のステップを実行します。

1. ヘルプ用のページを作成します。「データベース・アプリケーションのページの管理」を参照してください。

2. ヘルプ・ページの「ページ定義」にナビゲートします。「「ページ定義」へのアクセス」を参照してください。

3. 「リージョン」で、「作成」アイコンをクリックします。

4. リージョン・タイプを選択するプロンプトが表示されたら、「ヘルプ・テキスト」を選択します。

5. 画面に表示されるステップに従います。

ヘルプ・テキストの定義

ページまたは1つのアイテムのヘルプ・テキストを定義するには、属性を編集します。アプリケーションの作成時にこれらの属性を定義することをお薦めします。次のステップでは、簡略化のために、これらの属性を定義した後にヘルプのテキストを定義する方法について説明します。

内容は次のとおりです。

- ページ用のヘルプの定義

- アイテム用のヘルプ・テキストの定義

- 複数のアイテム・ヘルプ・トピックの同時編集

ページ用のヘルプの定義

ページ・ヘルプ・テキストを定義するには、次のステップを実行します。

1. ページ・ヘルプを追加するページの「ページ定義」にナビゲートします。「「ページ定義」へのアクセス」を参照してください。

2. 「ページ」で、「ページ属性の編集」アイコンをクリックして、既存のページ属性を表示します。

3. 「ヘルプ」までスクロールします。

4. 表示されたフィールドにヘルプ・テキストを入力します。

5. 「変更の適用」をクリックします。

ページ・ヘルプ・テキストが必要な各ページに対して、これらのステップを実行します。

アイテム用のヘルプ・テキストの定義

アイテムのアイテム・ヘルプ・テキストを定義するには、次のステップを実行します。

1. アイテム・ヘルプを追加するページの「ページ定義」にナビゲートします。「「ページ定義」へのアクセス」を参照してください。

2. 「アイテム」で、編集するアイテム名をクリックします。

3. 「ヘルプ・テキスト」までスクロールします。

4. 表示されたフィールドにヘルプ・テキストを入力します。

5. 「変更の適用」をクリックします。

ヘルプ・テキストが必要な各アイテムに対して、これらのステップを実行します。

複数のアイテム・ヘルプ・トピックの同時編集

アプリケーションにアイテム・ヘルプを含める場合は、「アイテム・ヘルプをバルク編集」レポートを使用して、アイテム・ヘルプの複数のトピックを一度に編集できます。

「アイテム・ヘルプをバルク編集」レポートへのアクセス

「アイテム・ヘルプをバルク編集」レポートを表示するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「タスク」リストで、「アプリケーション・レポート」をクリックします。

4. 「ユーティリティ」アイコンをクリックします。

5. 「ページ固有のユーティリティ」から、「アイテム・ユーティリティ」を選択します。

6. 「すべてのアイテム・ヘルプ・テキストのグリッド編集」をクリックします。

7. アイテム・ヘルプのバルクレポートでは、次の操作が可能です。

- 既存のヘルプ・トピックを更新できます。表示されるヘルプ・テキストを編集し、「変更の適用」をクリックします。

- ページ番号をクリックして、アイテムが含まれている「ページ定義」にリンクできます。

- アイテム名をクリックして、ページ・アイテムにリンクできます。

アイテム・ヘルプ・トピックのシード

アプリケーションにアイテム・ヘルプが含まれていない場合は、デフォルトのヘルプ・テキストの一括更新を実行します。

アイテム・ヘルプ・トピックをシードするには、次のステップを実行します。

1. 「「アイテム・ヘルプをバルク編集」レポートへのアクセス」の説明に従って「アイテム・ヘルプをバルク編集」レポートにアクセスします。

2. 「アイテム・ヘルプ・テキストのシード」をクリックします。

3. 「デフォルトのヘルプ・テキスト」で、すべてのヘルプ・トピックに表示されるデフォルト・テキストを入力します。

4. 「変更の適用」をクリックします。

既存のアイテム・ヘルプ・トピックの検索

既存のヘルプ・テキストまたはアイテム・ラベルを検索できます。

既存のアイテム・ヘルプ・トピックを検索するには、次のステップを実行します。

1. 「「アイテム・ヘルプをバルク編集」レポートへのアクセス」の説明に従って「アイテム・ヘルプをバルク編集」レポートにアクセスします。

2. 「ヘルプの内容」にキーワードを入力します。

3. 「実行」をクリックします。

アイテム・ラベルの検索

アイテム・ラベルを検索するには、次のステップを実行します。

1. 「「アイテム・ヘルプをバルク編集」レポートへのアクセス」の説明に従って「アイテム・ヘルプをバルク編集」レポートにアクセスします。

2. 「ヘルプの内容」にキーワードを入力します。

3. 「実行」をクリックします。

関連項目:
「アプリケーション・ユーティリティとレポートの表示」

ヘルプ・ナビゲーション・バー・エントリの作成

ヘルプを作成したら、次に、ユーザーがリンクに使用するためのナビゲーション・バー・エントリを作成します。

ナビゲーション・バー・エントリを作成するには、次のステップを実行します。

1. 「ページ定義」にナビゲートします。「「ページ定義」へのアクセス」を参照してください。

2. 「ナビゲーション・バー」で、「作成」アイコンをクリックします。

3. 「属性」で、次のステップを実行します。

1. 順序: このコンポーネントの順序を指定します。これによって評価の順序が決まります。

2. altタグ・テキスト: イメージのナビゲーション・アイテムであるaltテキストを入力します。イメージ名を指定しないと、このテキストが表示されます。

3. アイコン・イメージ名: 表示されるイメージの名前を入力します。

4. イメージの高さ: イメージの高さを入力します。

5. イメージの幅: イメージの幅を入力します。

6. テキスト: イメージとともに表示する追加テキストを入力します。テキストを含めるか、テキストなしのアイコンを使用することができます。この属性はオプションであり、翻訳可能です。

7. 「次へ」をクリックします。

次に、ターゲット位置を指定します。

4. 「ターゲット」で、次のステップを実行します。

1. ターゲットは: 「このアプリケーションのページ」を選択します。

2. ページ: 「ヘルプ・ページおよびヘルプ・リージョンの作成」で作成したヘルプ・ページのページ番号を指定します。

3. リクエスト: 次を入力します。

&APP_PAGE_ID.

「リクエスト」に置換文字列&APP_PAGE_IDを指定することによって、Application Expressエンジンに対して、ユーザーがこのアイコンをクリックした場合にカレント・ページのヘルプ・テキストを表示するように指示します。

4. 「次へ」をクリックします。

5. 「作成」をクリックします。

11 ナビゲーションの追加

データベース・アプリケーションを構築する際、ナビゲーション・バー・エントリ、タブ、リスト、ブレッドクラム、ツリーを含む、様々なタイプのナビゲーション・コントロールを含めることができます。このセクションでは、アプリケーションでナビゲーションを実装する方法について説明します。

ナビゲーション・バー・エントリ、タブ、ブレッドクラム、リストなどのナビゲーション・コントロールは共有コンポーネントです。共有コンポーネントを使用すると、共有コンポーネント・ページのアプリケーション・レベルで特定のタイプのナビゲーション・コントロールを作成できます。作成後、データベース・アプリケーション内の任意のページにそれらを追加できます。

内容は次のとおりです。

- タブの作成

- リストの作成

- ブレッドクラムの作成

- ナビゲーション・バー・エントリの作成

- ブランチを使用したナビゲーションの制御

関連項目:
「共有コンポーネントでの作業」

タブの作成

タブは、アプリケーションのページ間でのナビゲートに有効な方法です。親タブ、標準タブおよびリストを使用して、アプリケーションのタブ付きの外観を作成できます。

アプリケーションには、タブのないページ、1レベルのタブを持つページおよび2レベルのタブを持つページを含めることができます。標準タブを使用した場合は、1レベルのタブのみを表示できます。2レベルのタブを表示するには、親タブと標準タブの両方を定義します。

ヒント:
タブのかわりに、リストを使用してタブ・コントロールを表示できます。リスト・テンプレートを使用すると、HTMLの生成をさらに制御できます。「リストの作成」を参照してください。

内容は次のとおりです。

- タブについて

- タブ・ページについて

- タブの作成

- タブの編集

- タブ・レポートへのアクセス

注意:
アプリケーションの作成ウィザードを実行すると、オプションで、タブ付きのアプリケーションを作成できます。次のステップでは、タブ付きでないアプリケーションを作成済であると想定しています。

関連項目:
「データベース・アプリケーションの作成について」

タブについて

標準タブは、ページと1対1の関係にしたり、複数のページのカレント・タブにすることができます。アプリケーション・ビルダーには、次の2つのタイプのタブが含まれています。

- 標準タブ
タブが1レベルのみのアプリケーションでは、標準タブ・セットを使用します。標準タブ・セットは、特定のページおよびページ番号に関連付けられます。標準タブを使用すると、特定のページにユーザーをリンクできます。

- 親タブ
親タブは標準タブ・セットの表示を制御できます。親タブをクリックすると、カレント・ページとしてデフォルト・ページを使用して、対応する標準タブが表示されます。親タブによって、別のレベルのナビゲーションおよびアプリケーション内のコンテキスト(または場所)が提供されます。ユーザーが特定のページに関連付けられた特定のURLにリンクするために親タブを使用できます。

タブをタブ・セットと呼ばれるコレクションにグループ化できます。各タブは、タブ・セットに属している必要があります。

テンプレートのサポートについて

親タブおよび標準タブを作成する前に、デフォルトのテンプレートで、適切な置換文字列を使用して標準タブおよび親タブの両方に位置を定義していることを確認する必要があります。このテンプレートは、ページ・レベルで上書きしないでください。

ページ・テンプレートを表示するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「アプリケーション」ホームページで、「共有コンポーネント」をクリックします。

4. 「ナビゲーション」で、「タブ」をクリックします。
タブ・ページが表示されます。

5. ページの下部にある「ページ・テンプレート」に移動します。必要に応じて、「ページ・テンプレート」リージョンを拡張します。

6. tabs_pg_templates.gifの説明

関連項目:

- アプリケーション・レベルでデフォルトのページ・テンプレートを設定する方法については、「テーマの管理」を参照してください。

- 「ページ・テンプレート」

タブ・ページについて

タブ・ページには、アプリケーションに定義されているタブの説明が表示されます。

タブ・ページにアクセスするには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「アプリケーション」ホームページで、「共有コンポーネント」をクリックします。

4. 「ナビゲーション」で、「タブ」をクリックします。
タブ・ページが表示されます。

tabs.gifの説明

次に続くセクションでは、タブ・ページの「タブ表示」セクションと「ページ・テンプレート」セクションについて説明します。

ヒント:
「ページ定義」の「共有コンポーネント」からタブ・ページにアクセスすることもできます。「「ページ定義」へのアクセス」を参照してください。

タブ表示

「タブ表示」には、カレント・タブまたはタブ・セットの表示の構成方法に関する追加情報が表示されます。

ページ・テンプレート

「ページ・テンプレート」には、カレント・アプリケーションに関連付けられているページ・テンプレートのレポートが表示されます。「テンプレートのサポートについて」を参照してください。

タブの作成

アプリケーションには、タブのないページ、1レベルのタブを持つページおよび2レベルのタブを持つページを含めることができます。標準タブを使用した場合は、1レベルのタブのみを表示できます。2レベルのタブを表示するには、親タブと標準タブの両方を定義します。詳細は、「タブについて」を参照してください。

タブを作成するには:

1. タブ・ページにアクセスします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「アプリケーション」ホームページで、「共有コンポーネント」をクリックします。

4. 「ナビゲーション」で、「タブ」をクリックします。

2. 「タブの管理」をクリックします。

3. 親タブを追加するには、上の行の「追加」ボタンをクリックします。
tabs_add_parent.gifの説明

親タブは標準タブ・セットの表示を制御できます。親タブをクリックすると、カレント・ページとしてデフォルト・ページを使用して、対応する標準タブが表示されます。

4. 標準タブを作成するには、下の行の「追加」ボタンをクリックします。
tabs_add_standard.gifの説明

親タブの作成ウィザードまたは標準タブの作成ウィザードが表示されます。

5. 画面に表示されるステップに従います。

タブの編集

複数のタブを同時に編集できます。また、標準タブを使用している場合は、「標準タブのタスク」リストを使用して、ラベルや順序などのタブのプロパティを更新できます。

複数のタブの同時編集

複数のタブを同時に編集できます。

複数のタブを同時に編集するには、次のステップを実行します。

1. 「タブ」ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「ナビゲーション」で、「タブ」をクリックします。

2. ページ上部で次のいずれかのタブをクリックします。

- 標準タブの編集

- 親タブの編集

レポートが表示されます。

3. 特定のタブを編集するには、「編集」アイコンをクリックします。

4. 該当する属性を編集し、「変更の適用」をクリックします。

「標準タブのタスク」リストの使用

「標準タブのタスク」リストが「タブ」ページの右側に表示されます。このリスト上のリンクにアクセスすると、標準タブ・セットの名前の変更、表示順序の変更、タブ・セットへのページの関連付け、新規標準タブの作成または新規標準タブ・セットの作成ができます。

「標準タブのタスク」リストにアクセスするには、次のステップを実行します。

1. 「タブ」ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「ナビゲーション」で、「タブ」をクリックします。

2. 「タブの管理」をクリックします。

3. 「標準タブのタスク」リストから次の項目を選択します。

- 標準タブ・セット名の変更

- 表示順序の変更

- 選択した標準タブでページを関連付け

- 新しい標準タブの作成

- 新しい標準タブ・セットの作成

タブ・レポートへのアクセス

このセクションでは、「条件付き表示」、「使用状況」および「履歴」レポートについて説明します。

「条件付き表示」レポートを表示するには、次のステップを実行します。

1. 「タブ」ページにナビゲートします。

1. 「ワークスペース」ホームページにナビゲートします。

2. 「アプリケーション・ビルダー」アイコンをクリックします。

3. アプリケーションを選択します。

4. 「アプリケーション」ホームページで、「共有コンポーネント」をクリックします。

5. 「ナビゲーション」で、「タブ」をクリックします。
タブ・ページが表示されます。

2. 該当するタブをクリックします。

- 条件付き表示

- 使用状況

- 履歴

詳細は、次に続くセクションを参照してください。

条件付き表示

「条件付き表示」レポートには、条件付きで表示するように構成された標準タブと親タブが表示されます。表示をフィルタするには、タブ・タイプを選択し、「実行」をクリックします。

使用状況

「使用状況」レポートには、カレント・アプリケーションで使用されている標準タブのリストが表示されます。

標準タブ履歴および親タブ履歴

「履歴」レポートには、カレント・アプリケーションのタブ属性に対する変更の履歴が表示されます。

リストの作成

リストは、リンクの共有コレクションです。リージョンを作成してリージョン・タイプを「リスト」に指定することによって、リストをページに追加します。リストの外観は、リスト・テンプレートで制御します。

静的または動的定義を作成することによって、リストを定義できます。定義によって、進捗バー、サイドバー、箇条書きナビゲーション・リストなど、特定のタイプのページ・アイテムが表示されます。次の図は、テンプレート「箇条書き付きで、順序付けされていない縦のリスト」を使用した静的リストの例です。

list.gifの説明

テンプレート属性を使用してリストの外観をさらに制御できます。リスト表示の変更の詳細は、「新しいテンプレートの作成」および「リスト・テンプレート」を参照してください。

内容は次のとおりです。

- リスト・タイプについて

- 静的リストについて

- 動的リストについて

- リストのコピー

- リージョンの作成によるページへのリストの追加

- リスト属性の編集

- リスト・レポートへのアクセス

リスト・タイプについて

Oracle Application Expressは、2つのタイプのリスト(静的および動的)をサポートします。

静的リスト

静的リストを作成する場合、リスト・エントリ・ラベルおよびターゲット(ページまたはURLのいずれか)を定義します。既存のエントリをコピーするかリスト・エントリを追加することによって、リストを作成(最初から作成)するときにリスト・エントリを追加できます。表示条件を定義することにより、リスト・エントリを表示するタイミングを制御できます。詳細は、「静的リストについて」を参照してください。

動的リスト

動的リストは、SQL問合せまたは実行時に実行されるPL/SQLファンクションに基づいています。動的リストを使用すると、jQuery Mobileなどのモバイル・フレームワークをサポートするスタイル・リスト・アイテムを動的に作成できます。詳細は、「動的リストについて」および「動的リスト構文の理解」を参照してください。

静的リストについて

静的リストを作成するには、次のステップを実行します。

1. リストの作成ウィザードを実行して、リストを作成します。

2. 最初からリストを作成するか既存リストをコピーするかを指定します。
エントリを最初から作成するか、または既存リストからエントリをコピーすることによって、リスト・エントリを追加できます。リスト全体をコピーすると、すべてのリスト・エントリもコピーされます。

3. 最初からリストを作成する場合は、リスト・タイプを選択するプロンプトが表示されます。「静的」を選択します。
各リスト要素には、いつ表示するかを制御できる表示条件があります。特定のページのカレントまたは非カレントとしてリスト要素を定義できます。「リスト属性の編集」および「条件付きエントリ」を参照してください。

4. リスト・リージョンを作成して、ページにリストを作成します。

これらのステップは必要に応じて実行します。リストの作成ウィザードを実行するときに3つのすべてのステップを実行できます。または、これらのステップを一度に1つ実行することもできます。

内容は次のとおりです。

- リストを最初から作成

- 静的リストへのエントリとサブリストの追加

- リスト間での静的リスト・エントリのコピー

- 静的リスト・エントリの親の変更

- 孤立した静的リスト・エントリの管理

- 静的リスト・エントリの順序変更

静的リストを最初から作成

リストを作成するには、次の手順を実行します。

1. リストの作成/編集ウィザードへのアクセス

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「アプリケーション」ホームページで、「共有コンポーネント」をクリックします。

4. 「ナビゲーション」で、「リスト」をクリックします。

5. 「作成」をクリックします。

2. 「ソース」で「最初から」を選択し、「次へ」をクリックします。

3. 「名前およびタイプ」で、次のステップを実行します。

1. 名前: 数字または英数字のリスト名を入力します。

2. タイプ: 「静的」を選択します。

3. ビルド・オプション: このコンポーネントのビルド・オプションを選択します(使用可能な場合)。ビルド・オプションは、アプリケーション内のコンポーネントが有効かどうかを判別する事前定義された設定です。

4. 「次へ」をクリックします。

4. 「リスト・エントリの定義」で、次の項目を指定します。

1. リスト・エントリ・ラベル: 数字または英数字のリスト名を入力します。

2. ターゲット・ページIDまたはカスタムURL: ターゲット・ページを選択するか、またはカスタムURLを入力します。

3. 「次へ」をクリックします。

5. 「確認」で、次の項目を指定します。

1. リスト・リージョンを作成しますか。: リスト・リージョンを作成するかどうかを選択します。オプションは次のとおりです。

- リスト・リージョンを作成しない

- カレント・ページにリスト・リージョンを作成する

- 各ターゲット・ページのリスト・リージョンを作成する

2. リージョン位置: 新しいリージョンを作成する場合は、リージョン位置を選択します。

3. リージョン・テンプレート: 新しいリージョンを作成する場合は、リージョン・テンプレートを選択します。

4. 「リストの作成」をクリックします。

ヒント:
「ページ定義」の「共有コンポーネント」でリストを作成することもできます。詳細は、「「ページ定義」へのアクセス」、「ツリー・ビューでのページの編集」および「コンポーネント・ビューでのページの編集」を参照してください。

静的リストへのエントリとサブリストの追加

リストの作成後、リストにエントリを追加する必要があります。リストを最初から作成するか、リスト・エントリをリスト内からコピーするか、または既存のエントリをあるリストから別のリストにコピーすると、リスト・エントリを追加できます。

サブリストを含む階層的なリストも作成できます。階層的なリストを作成するには、次のステップを実行します。

- 階層的なリストをサポートするリスト・テンプレートを選択します。階層的なリストをサポートするリスト・テンプレートを判別するには、サブリスト付きというネーミング規則のあるテンプレートを検索します。

- 各リスト・エントリの作成時には親リスト・アイテムを選択します。

関連項目:
「テンプレートのカスタマイズ」および「リスト・テンプレート」

エントリまたはサブリストを最初から追加

エントリまたはサブリストを最初から追加するには、次のステップを実行します。

1. リスト・ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「アプリケーション」ホームページで、「共有コンポーネント」をクリックします。

4. 「ナビゲーション」で、「リスト」を選択します。
リスト・ページが表示されます。

2. リストを選択します。
リスト詳細ページが表示されます。

3. 「リスト・エントリの作成」をクリックします。

4. 「エントリ」で、次の項目を指定します。

1. 親リスト・エントリ: 該当する場合、このリスト・エントリの親を選択します。サブリストを含む階層的なリストを作成する場合は、この属性を使用します。
この属性は、親リスト・エントリを作成する場合は表示されません。

2. 順序: リストにおけるリスト・エントリの表示順序を指定します。これによって評価の順序が決まります。

3. イメージ: このリスト・エントリの表示に使用するイメージのファイル名を指定します。この属性の制御はリスト・テンプレートによって行われます。

4. 属性: リスト要素イメージのイメージ属性(width="12" height="12"など)を指定します。
リスト・ラベル・テキストを参照するには、#LIST_LABEL#置換文字列を使用します。この置換文字列を使用すると、リスト・ラベル・テキストの値に基づいてタイトル・イメージ属性を自動的に設定できます。次に例を示します。

title="#LIST_LABEL#"

5. Alt属性: リスト要素イメージのイメージalt属性を指定します。
リスト・ラベル・テキストを参照するには、#LIST_LABEL#置換文字列を使用します。この置換文字列を使用すると、リスト・ラベル・テキストの値に基づいてAlt属性を自動的に設定できます。次に例を示します。

...alt="#LIST_LABEL#"...

6. リスト・エントリ・ラベル: このリンクのラベル・テキストを入力します。

5. ターゲット位置を指定します。オプション: 「URL」または「このアプリケーションのページ」。
ターゲット位置がURLの場合、次を指定します。

1. ターゲット・タイプ: 「URL」を選択します。

2. URLターゲット: URLを入力します。次に例を示します。

http://www.yahoo.com

ターゲット位置がページの場合、次のステップを実行します。

1. ターゲット・タイプ: 「このアプリケーションのページ」を選択します。

2. ページ: ターゲット・ページ番号を指定します。
他のオプションは次のとおりです。

- このページのページ区切りをリセット: ユーザーの新規問合せに合うデータの最初のセットにページを戻すには、このオプションを選択します。

- 印刷用: このオプションを選択すると、アプリケーションの「印刷用」テンプレートを使用するターゲット・ページが表示されます。「印刷用」テンプレートにより、印刷用ページが最適化されます。「テーマの編集」および「印刷用ページの最適化」を参照してください。

3. リクエスト: 組込みアプリケーション・アイテムREQUESTを設定するテキストを入力します。これは、クリックしたボタンの名前で設定されるアイテムでもあります。

4. キャッシュのクリア: キャッシュをクリアするページ番号を指定します。詳細は、アイテムのヘルプを参照してください。「フィールドレベル・ヘルプについて」を参照してください。

5. セッション・ステートを設定するには(リストされたアイテムに値を与えます)、次のステップを実行します。

- 「次のアイテムを設定」で、セッション・ステートを設定するアイテム名をカンマで区切って入力します。

- 「次の値を使用」で、前述のステップで指定したアイテムの値をカンマで区切って入力します。
静的な値または置換構文(&APP_ITEM_Name.など)を指定できます。URLのf?p=に渡されるアイテム値にはコロン(:)を使用しないでください。また、バックスラッシュでアイテム値全体を囲んだ場合(\1234,56\など)を除いて、カンマも使用しないでください。

6. カレント・リスト・エントリの項目は次のとおりです。

1. リスト・エントリがカレントとなるページ・タイプ: ページ・タイプに基づいて、このリスト・エントリがカレントとなる時点を指定します。
リスト・アイテムはカレントまたは非カレントにできます。カレント・リスト・アイテムではカレント・テンプレートが使用され、非カレント・リスト・アイテムでは非カレント・リスト・アイテム・テンプレートが使用されます。実際の条件およびテンプレートは後続の属性で定義されます。

2. リスト・エントリがカレントとなる条件: 条件付きで表示します。前述の選択に基づいて、評価する条件を定義します。この条件がTRUEの場合は、リスト・アイテムがカレントになります。詳細は、アイテムのヘルプを参照してください。「フィールドレベル・ヘルプについて」を参照してください。

7. 「条件」で、リスト・エントリを条件付きにする適切な情報を指定します。

8. 「認可」で、認可スキームを指定できます。
この認可スキームは、このコンポーネントをレンダリングまたは処理するためにTRUEと評価される必要があります。

9. 「構成」で、このコンポーネントのビルド・オプションを選択します。
ビルド・オプションは、アプリケーション内のコンポーネントが有効かどうかを判別する事前定義された設定です。

10. 「クリック・カウント」で、リスト・エントリをクリック・カウントに含むかどうかを指定します。
これがwww.google.comのような外部ページへのリンクである場合、クリックをカウントできます。詳細は、Oracle Application Express APIリファレンスの「COUNT_CLICKプロシージャ」を参照してください。

11. 追加属性を指定するには、「ユーザー定義属性」セクションを使用します。たとえば、次にtabindexやaccesskeyを追加します。

tabindex="15" accesskey="D"

12. リスト属性の定義の終了後、「作成」または「作成後、別のものの作成」をクリックします。

リスト間での静的リスト・エントリのコピー

あるリストから別のリストに静的リスト・エントリをコピーできます。

リスト間でリスト・エントリをコピーするには、次のステップを実行します。

1. リスト・ページにナビゲートします。

1. 「ワークスペース」ホームページにナビゲートします。

2. 「アプリケーション・ビルダー」アイコンをクリックします。

3. アプリケーションを選択します。

4. 「アプリケーション」ホームページで、「共有コンポーネント」をクリックします。

5. 「ナビゲーション」で、「リスト」をクリックします。
リスト・ページが表示されます。

2. コピーするリストを選択します。

3. 「タスク」リストで、「あるリストから別のリストへのリスト・エントリのコピー」をクリックします。

4. 「リスト・エントリのコピー」で、コピー先のリストを選択し、「次へ」をクリックします。

5. 「リスト・エントリのコピー」をクリックします。

静的リスト・エントリの親の変更

リスト・エントリの親の変更ページは、リスト・エントリ階層を管理するために使用します。

リスト・エントリの親を変更するには、次のステップを実行します。

1. リスト・ページにナビゲートします。

1. 「ワークスペース」ホームページにナビゲートします。

2. 「アプリケーション・ビルダー」アイコンをクリックします。

3. アプリケーションを選択します。

4. 「アプリケーション」ホームページで、「共有コンポーネント」をクリックします。

5. 「ナビゲーション」で、「リスト」をクリックします。
リスト・ページが表示されます。

2. リストを選択します。

3. 「タスク」リストで、「このリスト内におけるリスト・エントリの親の変更」をクリックします。

4. 表示を階層のサブセットに制限するには、「開始」を使用します。選択して「実行」をクリックします。

5. 「親の変更先」で新しい親を選択します。

6. 移動するエントリを選択します。

7. 「チェックしたエントリの親の変更」をクリックします。

孤立した静的リスト・エントリの管理

孤立リスト・エントリとは、親が現在のリストのメンバーではないリスト・エントリです。リスト・エントリが孤立している場合は、親のエントリを削除します。

孤立リスト・エントリを管理するには、次のステップを実行します。

1. リスト・ページにナビゲートします。

1. 「ワークスペース」ホームページにナビゲートします。

2. 「アプリケーション・ビルダー」アイコンをクリックします。

3. アプリケーションを選択します。

4. 「アプリケーション」ホームページで、「共有コンポーネント」をクリックします。

5. 「ナビゲーション」で、「リスト」をクリックします。
リスト・ページが表示されます。

2. リストを選択します。

3. 「タスク」リストで、「孤立リスト・エントリの管理」をクリックします。

4. 削除するエントリを選択します。

5. 「親エントリのクリア」をクリックします。

静的リスト・エントリの順序変更

クリーンアップ・ページで、リスト・エントリの順序を10単位で変更できます。

リスト・エントリをクリーンアップするには、次のステップを実行します。

1. リスト・ページにナビゲートします。

1. 「ワークスペース」ホームページにナビゲートします。

2. 「アプリケーション・ビルダー」アイコンをクリックします。

3. アプリケーションを選択します。

4. 「アプリケーション」ホームページで、「共有コンポーネント」をクリックします。

5. 「ナビゲーション」で、「リスト」をクリックします。
リスト・ページが表示されます。

2. リストを選択します。

3. 「タスク」リストで、「リストのエントリのクリーンアップ」をクリックします。

4. 「クリーンアップ」をクリックします。

動的リストについて

動的リストを使用すると、jQuery Mobileなどのモバイル・フレームワークをサポートするスタイル・リスト・アイテムを動的に作成できます。動的リストは、SQL問合せまたはSQL問合せを戻すPL/SQLファンクションに基づいています。

動的リストを作成するには、次のステップを実行します。

1. リストの作成ウィザードを実行して、リストを作成します。

2. 最初からリストを作成するか既存リストをコピーするかを指定します。

3. 最初からリストを作成する場合は、リスト・タイプを選択するプロンプトが表示されます。「動的」を選択します。

4. SQL問合せまたはSQL問合せを戻すPL/SQLファンクションを入力します。

5. リスト・リージョンを作成して、ページにリストを作成します。詳細は、「リージョンの作成によるページへのリストの追加」を参照してください。

内容は次のとおりです。

- 動的リスト構文の理解

- 動的リストを最初から作成

動的リスト構文の理解

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のユーザー属性と一致します。

動的リストを最初から作成

動的リストを作成するには、次のステップを実行します。

1. リストの作成/編集ウィザードへのアクセス

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「アプリケーション」ホームページで、「共有コンポーネント」をクリックします。

4. 「ナビゲーション」で、「リスト」をクリックします。

5. 「作成」をクリックします。

2. 「最初から」をクリックし、「次へ」をクリックします。

3. 「名前およびタイプ」で、次のステップを実行します。

1. 名前: 数字または英数字のリスト名を入力します。

2. タイプ: 「動的」を選択します。

3. ビルド・オプション: このコンポーネントのビルド・オプションを選択します(使用可能な場合)。ビルド・オプションは、アプリケーション内のコンポーネントが有効かどうかを判別する事前定義された設定です。

4. 「次へ」をクリックします。

4. 「問合せまたは静的値」で、次のステップを実行します。

1. 問合せソース・タイプ: 「SQL問合せ」または「SQL問合せを戻すファンクション」を選択します。

2. 問合せ: SQL問合せまたはSQL問合せを戻すファンクションを入力します。詳細は、「動的リスト構文の理解」を参照してください。

3. 「次へ」をクリックします。

5. 「確認」で、次の項目を指定します。

1. リスト・リージョンを作成しますか。: リスト・リージョンを作成するかどうかを選択します。オプションは次のとおりです。

- リスト・リージョンを作成しない

- カレント・ページにリスト・リージョンを作成する

2. リージョン位置: 新しいリージョンを作成する場合は、リージョン位置を選択します。

3. リージョン・テンプレート: 新しいリージョンを作成する場合は、リージョン・テンプレートを選択します。

4. リスト・テンプレート: 新しいリージョンを作成する場合は、リスト・テンプレートを選択します。

5. 「作成」をクリックします。

ヒント:
「ページ定義」の「共有コンポーネント」でリストを作成することもできます。詳細は、「「ページ定義」へのアクセス」、「ツリー・ビューでのページの編集」および「コンポーネント・ビューでのページの編集」を参照してください。

リストのコピー

別のアプリケーションまたは既存のアプリケーションからリストをコピーできます。

内容は次のとおりです。

- カレント・アプリケーションからのリストのコピー

- アプリケーション間でのリストのコピー

カレント・アプリケーションからのリストのコピー

あるリストから別のリストにリスト・エントリをコピーできます。

リスト間でリスト・エントリをコピーするには、次のステップを実行します。

1. リスト・ページにナビゲートします。

1. 「ワークスペース」ホームページにナビゲートします。

2. 「アプリケーション・ビルダー」アイコンをクリックします。

3. アプリケーションを選択します。

4. 「アプリケーション」ホームページで、「共有コンポーネント」をクリックします。

5. 「ナビゲーション」で、「リスト」をクリックします。
リスト・ページが表示されます。

2. コピーするリストを選択します。

3. 「タスク」リストで、「リストのコピー」をクリックします。

4. 「リストをコピー」で、「このアプリケーションのリスト」を選択し、「次へ」をクリックします。

5. 「リストを指定」で、次のステップを実行します。

1. リストのコピー: コピーするリストを選択します。

2. 新しいリスト名: コピーされたリストに新しい名前を入力します。

3. 「コピー」をクリックします。

アプリケーション間でのリストのコピー

カレント・アプリケーションまたは別のアプリケーションからリストをコピーできます。

リストをコピーするには、次のステップを実行します。

1. リスト・ページにナビゲートします。

1. 「ワークスペース」ホームページにナビゲートします。

2. 「アプリケーション・ビルダー」アイコンをクリックします。

3. アプリケーションを選択します。

4. 「アプリケーション」ホームページで、「共有コンポーネント」をクリックします。

5. 「ナビゲーション」で、「リスト」をクリックします。
リスト・ページが表示されます。

2. コピーするリストを選択します。

3. 「タスク」リストで、「リストのコピー」をクリックします。

4. 「リストをコピー」で、「別のアプリケーションのリスト」を選択し、「次へ」をクリックします。

5. 「リストを指定」で、次のステップを実行します。

1. アプリケーションからコピー: リストのコピー元となるアプリケーションを選択します。

2. リストのコピー: コピーしているリストを選択します。

3. 新しいリスト名: 新しいリストの名前を入力します。

4. 「コピー」をクリックします。

リージョンの作成によるページへのリストの追加

リストとリスト・エントリの作成後、リージョンを作成してリージョン・タイプを「リスト」に指定することによって、このリストをページに追加します。

関連項目:
リスト表示の変更方法については、「新しいテンプレートの作成」および「リスト・テンプレート」を参照してください。

ページにリストを追加するには、次のステップを実行します。

1. 該当する「ページ定義」にナビゲートします。「「ページ定義」へのアクセス」を参照してください。

2. 「ページ定義」で、リスト・リージョンを追加します。

- ツリー・ビュー: 「ページ・レンダリング」で、「リージョン」を右クリックし、「作成」を選択します。

- コンポーネント・ビュー: 「リージョン」で、「作成」アイコンをクリックします。

「リージョンの作成」ウィザードが表示されます。

3. 「リージョン」で、リージョン・タイプとして「リスト」を選択し、「次へ」をクリックします。

4. 「表示属性」で、次のステップを実行します。

1. タイトル: リージョンのタイトルを入力します。選択するリージョン・テンプレートにリージョン・タイトルが表示されると、このタイトルが表示されます。

2. リージョン・テンプレート: リージョンの外観を制御するテンプレートを選択します。

3. 親リージョン: 新しいリージョンが属する親リージョンを定義します。

4. 表示ポイント: このリージョンの表示ポイントを指定します。

5. 順序: このコンポーネントの順序を指定します。これによって評価の順序が決まります。

6. 「次へ」をクリックします。

5. 「ソース」で、次の項目を指定します。

1. リスト: 追加するリストを選択します。

2. リスト・テンプレート: リストの外観を制御するテンプレートを選択します。

3. 「次へ」をクリックします。

6. 「条件付き表示」で、次のステップを実行します。

1. 条件タイプ: このコンポーネントがレンダリングされるために満たす必要があるリストから、条件タイプを選択します。「条件付きのレンダリングおよびプロセスの理解」を参照してください。

2. 認可スキーム: オプションで認可スキームを選択します。このコンポーネントをレンダリングまたは処理するためには、この認可スキームがTRUEと評価される必要があります。詳細は、「認可を介したセキュリティの提供」を参照してください。

3. 「リージョンの作成」をクリックします。

リストを追加する各ページに対して、これらのステップを実行します。

リスト属性の編集

作成したリストは、リスト・ページで編集できます。

リストを編集するには、次のステップを実行します。

1. リスト・ページにナビゲートします。

1. 「ワークスペース」ホームページにナビゲートします。

2. 「アプリケーション・ビルダー」アイコンをクリックします。

3. アプリケーションを選択します。

4. 「アプリケーション」ホームページで、「共有コンポーネント」をクリックします。

5. 「ナビゲーション」で、「リスト」をクリックします。
リスト・ページが表示されます。

ページの外観は、ページ上部にある検索バーを使用して変更できます。「対話モード・レポートのカスタマイズ」を参照してください。

2. リストを選択します。
リスト詳細ページが表示されます。

3. リスト名、テンプレートまたはビルド・オプションを変更するには、「リストの編集」ボタンをクリックします。

4. 動的リストで、次のステップを実行します。

1. 対象となる属性を編集します。属性の詳細を表示するには、アイテム・ラベルをクリックしてください。「フィールドレベル・ヘルプについて」を参照してください。

2. 「変更の適用」をクリックします。

5. 静的リストで、次のステップを実行します。

1. リスト順序、リンク・テキスト、ターゲットまたはすべてのリスト・エントリの現在のステータスを編集するには、「グリッド編集」をクリックします。

2. 該当するリスト・エントリの横にある「編集」アイコンをクリックします。
作成/編集ページは複数のセクションに分かれています。これらのセクションにアクセスするには、ページをスクロールするか、ページ上部のナビゲーション・ボタンをクリックします。ページ上部のボタンを選択すると、選択されたセクションが表示され、その他のセクションはすべて一時的に非表示になります。ページのすべてのセクションを表示するには、「すべて表示」をクリックします。

3. 対象となる属性を編集します。属性の詳細を表示するには、アイテム・ラベルをクリックしてください。「フィールドレベル・ヘルプについて」を参照してください。

4. 「変更の適用」をクリックします。

リスト・レポートへのアクセス

リスト・ページ上部の該当するタブをクリックして、「未使用」、「条件付きエントリ」、「使用状況」および「履歴」レポートを表示できます。これらのレポートは、リストの作成後にのみ表示されます。

リスト・レポートを表示するには、次のステップを実行します。

1. リスト・ページにナビゲートします。

1. 「ワークスペース」ホームページにナビゲートします。

2. 「アプリケーション・ビルダー」アイコンをクリックします。

3. アプリケーションを選択します。

4. 「アプリケーション」ホームページで、「共有コンポーネント」をクリックします。

5. 「ナビゲーション」で、「リスト」をクリックします。
リスト・ページが表示されます。

2. 該当するタブをクリックします。

- 未使用

- 条件付きエントリ

- 使用状況

- 履歴

ページの外観は、ページ上部にある検索バーを使用して変更できます。「対話モード・レポートのカスタマイズ」を参照してください。

詳細は、次に続くセクションを参照してください。

未使用

「未使用」をクリックすると、カレント・アプリケーションで使用されていないリストが識別されます。

条件付きエントリ

「条件付きエントリ」タブをクリックすると、条件付きリストが表示されます。

使用状況

「リストの使用状況」タブをクリックすると、「使用状況」レポートにアクセスします。このレポートに、カレント・アプリケーションに含まれるすべてのリストが表示されます。このレポートでは、次の項目を実行できます。

- リスト・エントリを編集するには、リスト名を選択します。

- リストに表示されるページを表示するには、「ページ」列の番号をクリックします。

- リストとともに使用されるテンプレートを表示するには、「リスト・テンプレートの使用状況」を展開します。表示または編集するリスト・テンプレートの名前をクリックします。

履歴

「履歴」タブをクリックすると、リスト定義およびリスト・エントリに対する変更が開発者および日付ごとに表示されます。

ブレッドクラムの作成

ブレッドクラムを使用すると、階層的にナビゲートできます。ブレッドクラムは、テンプレートを使用して表示されるリンクの階層的なリストです。ブレッドクラムは、リンクのリストまたはブレッドクラム・パスとして表示できます。

内容は次のとおりです。

- ブレッドクラムについて

- ブレッドクラムの作成方法

- ブレッドクラムの編集

- ブレッドクラム・エントリの親の変更

- 未使用のブレッドクラム・エントリの削除

- ブレッドクラム・レポートへのアクセス

関連項目:
「テーマの作成」および「ブレッドクラム・テンプレート」

ブレッドクラムについて

ブレッドクラムは、アプリケーション内のどの部分が表示されているかを階層で示します。さらに、特定のブレッドクラムをクリックすると、すぐにページを表示できます。各ページの上部でナビゲーションの第2レベルとしてブレッドクラムを使用し、タブおよびリストなどの他のユーザー・インタフェース要素を補完します。

menu.gifの説明

ブレッドクラムの作成方法

ページの作成中にブレッドクラムを作成できます。または、ブレッドクラムの作成ウィザードを実行して手動で作成します。

内容は次のとおりです。

- ページ作成中のブレッドクラムの作成

- ブレッドクラムの手動作成

ページ作成中のブレッドクラムの作成

ページの作成中にブレッドクラムを作成するには、次のステップを実行します。

1. ページの作成ウィザードを実行して、新規ページを追加します。「データベース・アプリケーションのページの管理」を参照してください。
ウィザードの途中で、「ブレッドクラム」オプションが表示されます。このリストが表示される実際のページは、作成するページのタイプによって異なります。

2. 「ブレッドクラム」リストで、ブレッドクラムを選択するか、または「- ページにブレッドクラム・リージョンを追加しない -」を選択します。
ブレッドクラムを選択した場合、「ブレッドクラム・エントリの作成」フォームが表示されます。

図breadcrum_creage_pg.gifの説明

3. 「エントリ名」にブレッドクラムの名前を入力します。

4. 「親エントリ」で、次の操作を実行します。

- 親を指定するには、「親エントリの選択」リストから親ページを選択します。

- このブレッドクラムに親がない場合は、「親ブレッドクラム・エントリなし」を選択します。

5. 画面に表示されるステップに従います。

ブレッドクラムの手動作成

ブレッドクラムを手動で作成するには、次のように、アプリケーションの各ページにブレッドクラムを追加する必要があります。

1. 共有コンポーネント・ページ、または「ページ定義」のどちらかから、ブレッドクラムの作成/編集ウィザードを実行することによりブレッドクラムを作成します。「共有コンポーネント・ページからのブレッドクラムの作成」および「「ページ定義」からのブレッドクラムの作成」を参照してください。

2. エントリをブレッドクラムに追加します。「ブレッドクラム・エントリの追加」を参照してください。

3. リージョンを作成して、ブレッドクラムをページに追加します。「ブレッドクラム・リージョンの追加」を参照してください。

共有コンポーネント・ページからのブレッドクラムの作成

共有コンポーネント・ページからブレッドクラムを作成するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「アプリケーション」ホームページで、「共有コンポーネント」をクリックします。

4. 「ナビゲーション」で、「ブレッドクラム」をクリックします。
ブレッドクラム・ページが表示されます。

5. 「ブレッドクラムの作成」をクリックします。

6. 名前を入力して、「作成」をクリックします。

7. ブレッドクラム・エントリを追加します。「ブレッドクラム・エントリの追加」を参照してください。

「ページ定義」からのブレッドクラムの作成

「ページ定義」からブレッドクラムを作成するには、次のステップを実行します。

1. 該当する「ページ定義」にナビゲートします。「「ページ定義」へのアクセス」を参照してください。

2. ブレッドクラムの作成ウィザードにアクセスします。

- ツリー・ビュー: 「共有コンポーネント」で、「ブレッドクラム」を右クリックし、「作成」をクリックします。

- コンポーネント・ビュー: 「共有コンポーネント」で、「作成」アイコンをクリックします。
ブレッドクラム・ページが表示されます。

3. 「共有コンポーネント」で、「ブレッドクラム」までスクロールし、「作成」をクリックします。

4. 「作成」では、「ブレッドクラム」を選択し、「次へ」をクリックします。

5. 名前を入力して、「作成」をクリックします。

6. ブレッドクラム・エントリを追加します。「ブレッドクラム・エントリの追加」を参照してください。

ブレッドクラム・エントリの追加

ブレッドクラム・エントリを追加するには、次のステップを実行します。

1. ブレッドクラム・ページにナビゲートします。

1. 「ワークスペース」ホームページにナビゲートします。

2. 「アプリケーション・ビルダー」アイコンをクリックします。

3. アプリケーションを選択します。

4. 「アプリケーション」ホームページで、「共有コンポーネント」をクリックします。

5. 「ナビゲーション」で、「ブレッドクラム」をクリックします。
ブレッドクラム・ページが表示されます。

2. エントリを追加するブレッドクラムを選択します。

3. 「ブレッドクラム・エントリの作成」をクリックします。

4. 「ブレッドクラム」で、このブレッドクラム・エントリが表示されるページを指定します。

5. 「エントリ」で、次の項目を指定します。

1. 順序: ブレッドクラム・エントリを表示する順序を指定します。これによって評価の順序が決まります。

2. 親エントリ: このエントリの親を指定します。ブレッドクラムには、親IDを持たないアイテムとして識別されるルート・ノードが1つのみ必要です。

3. 短縮名: (ブレッドクラム・テンプレートで参照される)このエントリの短縮名を指定します。

4. 詳細な名前: (ブレッドクラム・テンプレートで参照される)このエントリの詳細な名前を指定します。

6. 「ターゲット」で、ターゲットの場所を指定します。

1. ターゲットは: 「このアプリケーションのページ」を選択します。

2. ページ: ターゲット・ページ番号を指定します。
「このページのページ区切りをリセット)」を選択することもできます。このオプションを選択すると、ユーザーの新規問合せに合うデータの最初のセットにページが戻されます。

3. リクエスト: 使用するリクエストを指定します。

4. キャッシュのクリア: キャッシュをクリアするページ番号を指定します。

5. セッション・ステートを設定するには(リストされたアイテムに値を与えます)、次のステップを実行します。

- 「次のアイテムを設定」で、セッション・ステートを設定するアイテム名をカンマで区切って入力します。

- 次の値を使用: 指定したアイテムの値をカンマで区切って入力します。
静的な値または置換構文(&APP_ITEM_Name.など)を指定できます。URLのf?p=に渡されるアイテム値にはコロン(:)を使用しないでください。また、バックスラッシュでアイテム値全体を囲んだ場合(\1234,56\など)を除いて、カンマも使用しないでください。

7. ブレッドクラムを条件付きにするには、次のステップを実行します。

1. 「条件タイプ」リストから選択します。

2. 表示されるフィールドに式を入力します。

8. 「認可」で、認可スキームを指定できます。
この認可スキームは、このコンポーネントをレンダリングまたは処理するためにTRUEと評価される必要があります。

9. 「構成」で、このコンポーネントのビルド・オプションを選択できます。
ビルド・オプションは、アプリケーション内のコンポーネントが有効かどうかを判別する事前定義された設定です。

10. 「ブレッドクラム・エントリの作成」をクリックします。

作成する各ブレッドクラム・エントリに対して、これらのステップを実行します。

ブレッドクラム・リージョンの追加

リージョンはページ上の領域で、コンテンツのコンテナとして機能します。ブレッドクラムおよびブレッドクラム・テンプレートを作成した後、リージョンを作成します。ブレッドクラム・リージョンを作成すると、ページにブレッドクラムを追加できます。

関連項目:
メニュー表示の変更方法については、「新しいテンプレートの作成」および「ブレッドクラム・テンプレート」を参照してください。

ブレッドクラム・リージョンを作成するには、次のステップを実行します。

1. 該当する「ページ定義」にナビゲートします。「「ページ定義」へのアクセス」を参照してください。

- ツリー・ビュー: 「ページ・レンダリング」で、「リージョン」を右クリックし、「作成」をクリックします。

- コンポーネント・ビュー: 「ページ・レンダリング」で、「作成」アイコンをクリックします。
「リージョンの作成」ウィザードが表示されます。

2. リージョン・タイプについて、「ブレッドクラム」を選択して「次へ」をクリックします。

3. 「ブレッドクラム・コンテナ・リージョン」で、次のようにします。

1. リージョン・タイトル: リージョンのタイトルを入力します。

2. リージョン・テンプレート: リージョン・テンプレートを選択します。

3. 表示ポイント: 表示ポイントを選択します。
リージョンは、位置(または表示ポイント)別に編成されています。リージョンの適切な位置を決定するには、懐中電灯アイコンをクリックします。グラフィカルな画面が表示されます。

4. 順序: 順序の番号を入力します。これによって評価の順序が決まります。

5. 「次へ」をクリックします。

4. 「ブレッドクラム」で、次のステップを実行します。

1. ブレッドクラム: このリージョンに関連付けるブレッドクラムを選択します。

2. ブレッドクラム・テンプレート: テンプレートを選択します。

3. 「次へ」をクリックします。

5. ブレッドクラム・リージョンの情報を確認し、「次へ」をクリックします。

6. 「終了」をクリックします。

ブレッドクラム・ナビゲーションを追加する各ページに対して、これらのステップを実行します。

動的ブレッドクラムの作成について

より詳細なコンテキストを表示するために、ブレッドクラムにセッション・ステートを含めて、ブレッドクラムを動的にすることができます。たとえば、アプリケーションのページに特定の会社への注文リストが表示される場合に、次のブレッドクラムを含めるとします。

Home > Orders > Orders for ACME Inc

この例で、ACME Incは、ユーザーが現在表示しているページおよびナビゲーション・パスも示しています。Application Expressエンジンによって、ACME Inc.のセッション・ステートの値が格納されます。

このタイプの動的メニューを作成するには、ブレッドクラムの短縮名または詳細な名前に、セッション・ステート・アイテムへの参照を含める必要があります。次に例を示します。

&COMPANY_NAME.

ブレッドクラムの編集

作成したブレッドクラムは、ブレッドクラム・ページで編集できます。

ブレッドクラムを編集するには、次のステップを実行します。

1. ブレッドクラム・ページにナビゲートします。

1. 「ワークスペース」ホームページにナビゲートします。

2. 「アプリケーション・ビルダー」アイコンをクリックします。

3. アプリケーションを選択します。

4. 「アプリケーション」ホームページで、「共有コンポーネント」をクリックします。

5. 「ナビゲーション」で、「ブレッドクラム」を選択します。
ブレッドクラム・ページが表示されます。

2. ブレッドクラムを選択します。

3. ブレッドクラム・エントリを選択します。
作成/編集ページが表示されます。

ヒント:
デフォルトでは、ブレッドクラム・エントリ・ページは階層リストで表示されます。「タスク」リストで「表形式表示」または「階層表示」を選択することによって、階層表示と表形式表示を切り替えることができます。

4. 対象となる属性を編集します。
特定のアイテムの詳細は、アイテムのヘルプを参照してください。「フィールドレベル・ヘルプについて」を参照してください。

5. (オプション)ページ右側にある「ブレッドクラム・エントリ」リストで、ページ名とタイトルとのブレッドクラムの同期化に関するオプションを選択できます。
このオプションを選択することで、ページ名とブレッドクラムの変更が1ステップでできるようになります。ブレッドクラム名に指定した情報は、参照ページ名とタイトルの更新に使用されます。

6. 「変更の適用」をクリックします。

関連項目:
「グリッド編集」

ナビゲーションの選択肢について

作成/編集ページは、「ブレッドクラム」、「エントリ」、「ターゲット」、「条件」、「認可」および「構成」というセクションに分かれています。

これらのセクションにアクセスするには、ページをスクロールするか、ページ上部のナビゲーション・ボタンをクリックします。ページ上部のボタンを選択すると、選択されたセクションが表示され、その他のセクションはすべて一時的に非表示になります。ページのすべてのセクションを表示するには、「すべて表示」をクリックします。

ブレッドクラム・エントリの親の変更

エントリの親の変更ページの選択ブレッドクラム・エントリに新たな親を選択できます。

ブレッドクラム・エントリの親を変更するには、次のステップを実行します。

1. ブレッドクラム・ページにナビゲートします。

1. 「ワークスペース」ホームページにナビゲートします。

2. 「アプリケーション・ビルダー」アイコンをクリックします。

3. アプリケーションを選択します。

4. 「アプリケーション」ホームページで、「共有コンポーネント」をクリックします。

5. 「ナビゲーション」で、「ブレッドクラム」を選択します。
ブレッドクラム・ページが表示されます。

2. ブレッドクラムを選択します。
エントリ・ページが表示されます。

3. 「タスク」リストから、「このブレッドクラム内におけるエントリの親の変更」をクリックします。
エントリの親の変更ページが表示されます。

4. ビューを編集またはフィルタを適用するためにナビゲーション・バーを使用するには、次のステップを実行します。

- ブレッドクラム: 編集するブレッドクラムを指定して、「実行」をクリックします。

- 開始: ブレッドクラム階層のサブセットの表示の制限を選択し、「実行」をクリックします。

5. 「親の変更先」から、新たな親を選択します。

6. 移動するブラッドクラム・エントリを選択し、「チェックしたエントリの親の変更」をクリックします。

未使用のブレッドクラム・エントリの削除

未使用のブレッドクラム・エントリを削除するには、次のステップを実行します。

1. ブレッドクラム・ページにナビゲートします。

1. 「ワークスペース」ホームページにナビゲートします。

2. 「アプリケーション・ビルダー」アイコンをクリックします。

3. アプリケーションを選択します。

4. 「アプリケーション」ホームページで、「共有コンポーネント」をクリックします。

5. 「ナビゲーション」で、「ブレッドクラム」を選択します。
ブレッドクラム・ページが表示されます。

2. ブレッドクラムを選択します。
ブレッドクラム・エントリ・ページが表示されます。

3. 「タスク」リストで、「未使用のブレッドクラム・エントリの削除」をクリックします。
削除ページが表示されます。

4. 削除するエントリを選択し、「チェックした項目の削除」をクリックします。

ブレッドクラム・レポートへのアクセス

ブレッドクラム・ページ上部の該当するタブをクリックして、「ブレッドクラム階層」、「ブレッドクラムのグリッド編集」、「ブレッドクラムの例外」、「ブレッドクラムの使用状況」および「ブレッドクラム履歴」レポートを表示できます。

注意:
これらのレポートが表示されるのは、ブレッドクラムを作成した後のみです。

ブレッドクラム・レポートを表示するには、次のステップを実行します。

1. ブレッドクラム・ページにナビゲートします。

1. 「ワークスペース」ホームページにナビゲートします。

2. 「アプリケーション・ビルダー」アイコンをクリックします。

3. アプリケーションを選択します。

4. 「アプリケーション」ホームページで、「共有コンポーネント」をクリックします。

5. 「ナビゲーション」で、「ブレッドクラム」を選択します。
ブレッドクラム・ページが表示されます。

2. 該当するタブをクリックします。

- 階層

- グリッド編集

- 例外

- 使用状況

- 履歴

ページの外観は、ページ上部にある検索バーを使用して変更できます。「対話モード・レポートのカスタマイズ」を参照してください。

詳細は、次に続くセクションを参照してください。

階層

「階層」をクリックすると、ブレッドクラムがページおよび階層別に表示されます。ページにリンクするにはページ番号をクリックします。

グリッド編集

「グリッド編集」をクリックすると、一度にすべてのブラッドクラム名を編集できます。ページにリンクするにはページ番号をクリックします。

例外

「例外」をクリックすると、例外ページが表示されます。

使用状況レポート

「使用状況」をクリックすると、ブレッドクラム・レポートにアクセスできます。このレポートには、ブレッドクラムがページごとに表示されます。ページ番号をクリックして、特定のページに進みます。

履歴レポート

「履歴」をクリックすると、ブレッドクラムの履歴レポートにアクセスできます。このレポートには、ブレッドクラムの最近の変更が示されます。

ナビゲーション・バー・エントリの作成

ナビゲーション・バー・エントリを使用すると、アプリケーションのページ間を容易に移動できます。たとえば、ナビゲーション・エントリを使用すると、イメージまたはテキストからのリンクを表示できます。関連付けられたページ・テンプレートによってナビゲーション・バーの位置が決定します。

内容は次のとおりです。

- ナビゲーション・バーについて

- ナビゲーション・バー・エントリの作成方法

- ナビゲーション・バー・エントリの編集

- 複数のナビゲーション・バー・エントリの同時編集

- ナビゲーション・バー・エントリ・レポートへのアクセス

関連項目:
「テンプレートのカスタマイズ」

ナビゲーション・バーについて

ナビゲーション・バー・エントリは、イメージ、テキストまたは下にテキストが付いているイメージです。ナビゲーション・バー・エントリに使用するイメージおよびテキストを入力する必要があります。

nav_bar_2.gifの説明

ナビゲーション・バーは、ページごとにこれらを参照する必要がないという点で、他の共有コンポーネントとは異なります。使用するページ・テンプレートに#NAVIGATION_BAR#置換文字列が含まれている場合、Application Expressエンジンは、ページをレンダリングする際、自動的に定義済ナビゲーション・バーを含めます。

関連項目:
「サポートされるページ・テンプレートの置換文字列について」

ナビゲーション・バー・エントリの作成方法

ナビゲーション・バーを追加する前に、ナビゲーション・バー・エントリを作成する必要があります。ナビゲーション・バー・エントリは、最初から作成するか、または既存のエントリをコピーして作成できます。

関連項目:
「アプリケーションの計算の理解」

内容は次のとおりです。

- ナビゲーション・バー・エントリを最初から作成

- フィードバック用ナビゲーション・バー・エントリの作成

- ナビゲーション・バー・エントリのコピー

ナビゲーション・バー・エントリを最初から作成

ナビゲーション・バー・エントリを最初から作成するには、次のステップを実行します。

1. ナビゲーション・バー・エントリ・ページにナビゲートします。

1. 「ワークスペース」ホームページにナビゲートします。

2. 「アプリケーション・ビルダー」アイコンをクリックします。

3. アプリケーションを選択します。

4. 「アプリケーション」ホームページで、「共有コンポーネント」をクリックします。

5. 「ナビゲーション」で、「ナビゲーション・バー・エントリ」をクリックします。

2. 「作成」をクリックします。
ナビゲーション・バー・エントリの作成ウィザードが表示されます。

3. 「方法」で、「最初から」を選択します。

4. 「タイプ」で、「URLへのナビゲーション」を選択します。フィードバックの詳細は、「フィードバック用ナビゲーション・バー・エントリの作成」を参照してください。

5. 「属性」で、次の項目を指定します。

1. 順序: このコンポーネントの評価の順序を指定します。

ヒント:
既存のエントリを確認するには、ページ下部の「既存のナビゲーション・バー・エントリ」リンクをクリックします。

2. エントリ・ラベル: このナビゲーション・バー・エントリの表示テキストを入力します。

3. アイコン・イメージ名: イメージ名を入力します。ネーミング規則の詳細は、アイテムのヘルプを参照してください。「フィールドレベル・ヘルプについて」を参照してください。

4. イメージALT: イメージのナビゲーション・アイコンのALTテキストを入力します。イメージ名を指定しないと、このテキストが表示されます。

5. イメージの高さ: イメージの高さをピクセルで定義します。

6. 「次へ」をクリックします。

6. 「ターゲット」で、次の項目を指定します。

1. ターゲット位置がURLの場合、次を指定します。

- ターゲットは: 「URL」を選択します。

- URLターゲット: URLを入力します。次に例を示します。

http://www.yahoo.com

2. ターゲット位置がページの場合、次を指定します。

- ターゲットは: 「このアプリケーションのページ」を選択します。

- ページ: ターゲット・ページ番号を指定します。
ユーザーの新規問合せに合うデータの最初のセットにページを戻すには、「このページのページ区切りをリセット」を選択します。

アプリケーションの「印刷用」テンプレートを使用してターゲット・ページを表示するには、「印刷用」を選択します。「印刷用」テンプレートにより、印刷用ページが最適化されます。「テーマの編集」および「印刷用ページの最適化」を参照してください。

- リクエスト: 使用するリクエストを指定します。

- キャッシュのクリア: キャッシュをクリアするページ番号を指定します。

3. セッション・ステートを設定するには(リストされたアイテムに値を与えます)、次のステップを実行します。

- 「次のアイテムを設定」で、セッション・ステートを設定するアイテム名をカンマで区切って入力します。

- 次の値を使用: 指定したアイテムの値をカンマで区切って入力します。
静的な値または置換構文(&APP_ITEM_Name.など)を指定できます。URLのf?p=に渡されるアイテム値にはコロン(:)を使用しないでください。また、バックスラッシュでアイテム値全体を囲んだ場合(\1234,56\など)を除いて、カンマも使用しないでください。

4. 「次へ」をクリックします。

7. ナビゲーション・バー・エントリを表示するための条件を設定するには、条件タイプを選択します。

8. 「作成」をクリックします。

ヒント:
ナビゲーション・バーを表示するには、使用するページ・テンプレートに#NAVIGATION_BAR#置換文字列が含まれている必要があります。詳細は、「サポートされるページ・テンプレートの置換文字列について」を参照してください。

フィードバック用ナビゲーション・バー・エントリの作成

フィードバックは、アプリケーション・ユーザーからリアルタイム・コメント、拡張リクエストおよびバグを収集するプロセスです。アプリケーションにフィードバック・ページを追加するには、フィードバック・ページを追加します。「フィードバックの管理」を参照してください。

フィードバック用ナビゲーション・バー・エントリを作成するには、次のステップを実行します。

1. ナビゲーション・バー・エントリ・ページにナビゲートします。

1. 「ワークスペース」ホームページにナビゲートします。

2. 「アプリケーション・ビルダー」アイコンをクリックします。

3. アプリケーションを選択します。

4. 「アプリケーション」ホームページで、「共有コンポーネント」をクリックします。

5. 「ナビゲーション」で、「ナビゲーション・バー・エントリ」をクリックします。

2. 「作成」をクリックします。
ナビゲーション・バー・エントリの作成ウィザードが表示されます。各ウィザード・ページには、左側にステップの順序を示す一連のブロックが表示されます。ハイライトされたブロックは実行中のステップを表します。

3. 「方法」で、「最初から」を選択します。

4. 「タイプ」で、「フィードバック」を選択します。

5. 「フィードバック」で、次の項目を指定します。

1. フィードバック・ページ: フィードバック・ページを選択します。

2. エントリ・ラベル: 新しいナビゲーション・バー・エントリのラベルを入力します。

3. 順序: 新しいナビゲーション・バー・エントリの順序を指定します。これによって評価の順序が決まります。

6. 「作成」をクリックします。

ヒント:
ナビゲーション・バーを表示するには、使用するページ・テンプレートに#NAVIGATION_BAR#置換文字列が含まれている必要があります。「サポートされるページ・テンプレートの置換文字列について」を参照してください。

ナビゲーション・バー・エントリのコピー

ナビゲーション・バー・エントリをコピーするには、次のステップを実行します。

1. ナビゲーション・バー・エントリ・ページにナビゲートします。

1. 「ワークスペース」ホームページにナビゲートします。

2. 「アプリケーション・ビルダー」アイコンをクリックします。

3. アプリケーションを選択します。

4. 「アプリケーション」ホームページで、「共有コンポーネント」をクリックします。

5. 「ナビゲーション」で、「ナビゲーション・バー・エントリ」をクリックします。

2. 「作成」をクリックします。
ナビゲーション・バー・エントリの作成ウィザードが表示されます。

3. 「方法」で、「既存のナビゲーション・バーのコピーとして」を選択し、「次へ」をクリックします。

4. 「アプリケーションからコピー」で、アプリケーションを選択し、「次へ」をクリックします。

5. 「新しい名前」で、新しいエントリの名前を入力し、コピーおよびサブスクライブするかどうかを選択します。

6. 「ナビゲーション・バー・エントリのコピー」をクリックします。

ナビゲーション・バー・エントリの編集

作成したナビゲーション・バー・エントリは、ナビゲーション・バー・エントリ・ページで編集できます。

ナビゲーション・バー・エントリを編集するには、次のステップを実行します。

1. ナビゲーション・バー・エントリ・ページにナビゲートします。

1. 「ワークスペース」ホームページにナビゲートします。

2. 「アプリケーション・ビルダー」アイコンをクリックします。

3. アプリケーションを選択します。

4. 「アプリケーション」ホームページで、「共有コンポーネント」をクリックします。

5. 「ナビゲーション」で、「ナビゲーション・バー・エントリ」をクリックします。

ナビゲーション・バー・エントリ・ページが表示されます。

ページの外観は、ページ上部にある検索バーを使用して変更できます。「対話モード・レポートのカスタマイズ」を参照してください。

2. ナビゲーション・バー・エントリを選択します。
「編集」ページが表示されます。

編集ページは、「エントリ表示」、「エントリ・イメージ」、「フィードバック・エントリ」、「ターゲット」、「条件」、「認可」、「構成」、「サブスクリプション」および「コメント」というセクションに分かれています。

これらのセクションにアクセスするには、ページをスクロールするか、ページ上部のナビゲーション・ボタンをクリックします。ページ上部のボタンを選択すると、選択されたセクションが表示され、その他のセクションはすべて一時的に非表示になります。ページのすべてのセクションを表示するには、「すべて表示」をクリックします。

3. 対象となる属性を編集します。

4. ページの特定アイテムの詳細は、アイテムのヘルプを参照してください。「フィールドレベル・ヘルプについて」を参照してください。

5. 「変更の適用」をクリックします。

複数のナビゲーション・バー・エントリの同時編集

複数のナビゲーション・バー・エントリを同時に編集するには、次のステップを実行します。

1. ナビゲーション・バー・エントリ・ページにナビゲートします。

1. 「ワークスペース」ホームページにナビゲートします。

2. 「アプリケーション・ビルダー」アイコンをクリックします。

3. アプリケーションを選択します。

4. 「アプリケーション」ホームページで、「共有コンポーネント」をクリックします。

5. 「ナビゲーション」で、「ナビゲーション・バー・エントリ」をクリックします。

2. ページ上部の「グリッド編集」をクリックします。

3. 該当する属性を編集し、「変更の適用」をクリックします。

ナビゲーション・バー・エントリ・レポートへのアクセス

「ナビゲーション・バー・エントリ」ページ上部の該当するタブをクリックすると、ナビゲーション・バー・エントリ・サブスクリプションおよびナビゲーション・バー・エントリ履歴のレポートを表示できます。

注意:
「サブスクリプション」ボタンと「履歴」ボタンが表示されるのは、ナビゲーション・バーを作成した後のみです。

1. ナビゲーション・バー・エントリ・ページにナビゲートします。

1. 「ワークスペース」ホームページにナビゲートします。

2. 「アプリケーション・ビルダー」アイコンをクリックします。

3. アプリケーションを選択します。

4. 「アプリケーション」ホームページで、「共有コンポーネント」をクリックします。

5. 「ナビゲーション」で、「ナビゲーション・バー・エントリ」をクリックします。

2. 該当するタブをクリックします。

- サブスクリプション

- 履歴

ナビゲーション・バー・エントリ・サブスクリプション・レポート

「サブスクリプション」をクリックすると、サブスクライブされたナビゲーション・バー・レポートにアクセスできます。このレポートには、アプリケーションでサブスクライブされたナビゲーション・バー・エントリが表示されます。

ナビゲーション・バー・エントリ履歴

「履歴」をクリックすると、ナビゲーション・バー履歴レポートにアクセスできます。このレポートには、ナビゲーション・バーの最近の変更が示されます。

ブランチを使用したナビゲーションの制御

ブランチは、指定したページが送信された後の特定のページ、プロシージャまたはURLへのリンクに対する指示です。たとえば、ページ1の送信後、ページ1からページ2にブランチできます。

内容は次のとおりです。

- ブランチの作成

関連項目:
「クロス・ページ・ユーティリティについて」

ブランチの作成

ブランチの作成ウィザードを実行し、ブランチ・ポイントおよびブランチ・タイプを指定すると、ブランチを作成できます。

ブランチを作成するには、次のステップを実行します。

1. 該当する「ページ定義」にナビゲートします。「「ページ定義」へのアクセス」を参照してください。

2. 「ブランチ」で、ブランチの作成ウィザードにアクセスします。

- ツリー・ビュー: 「ページ・プロセス」で、右クリックして「ブランチの作成」を選択します。

- コンポーネント・ビュー: 「ブランチ」で、「作成」アイコンをクリックします。

ブランチの作成ウィザードが表示されます。

3. 「ブランチ属性」で、次の項目を指定します。

1. 名前: 開発者が簡単に識別できるように、ブランチの名前を指定します。

2. 順序: このコンポーネントの順序を指定します。これによって評価の順序が決まります。

3. 「ブランチ・ポイント」のオプション:

- 送信時: 計算の前: 計算、検証またはプロセスの前に実行されます。このオプションは、「取消」ボタンに使用します。

- 送信時: 検証の前: 計算の後、検証またはプロセスの前に実行されます。通常は使用しません。検証が失敗すると、ページ・プロセスは停止し、ロールバックが実行され、ページにエラーが表示されます。このデフォルト動作のために、ブランチを作成して検証を提供する必要がありません。ただし、計算の結果に応じてブランチする必要がある場合があります(たとえば、前のブランチ・ポイントに戻る場合)。

- 送信時: プロセスの前: 計算および検証の後、プロセスの前に実行されます。このオプションを使用すると、検証されたセッション・ステートに基づいて、ページ・プロセスの実行前にブランチされます。

- 送信時: プロセスの後: 計算、検証およびプロセスの後に実行されます。このオプションを使用すると、計算、検証およびプロセスの実行後にURLまたはページにブランチされます。このオプションを使用する際、任意のブランチ・ポイントに複数のブランチが存在する場合は、ブランチを順序付ける必要があります。

- ロード時: ヘッダーの前: ページのレンダリング前に実行されます。このオプションを使用すると、カレント・ページではなく別のページが表示されるか、またはユーザーが別のURLまたはプロシージャにリダイレクトされます。

4. ブランチ・タイプを選択します。

5. 「次へ」をクリックします。

4. 「ターゲット」で、ターゲットの場所を指定します。ページに表示される情報は、選択したブランチ・タイプによって異なります。

1. ターゲット位置がURLの場合、次のステップを実行します。

- 「ブランチ・ターゲット」で、「URL」を選択します。

- URLターゲット: URLを入力します。次に例を示します。

http://www.yahoo.com

2. ターゲット位置がページの場合、次のステップを実行します。

- ブランチ・ターゲット: 「このアプリケーションのページ」を選択します。

- ページ: ターゲット・ページ番号を指定します。
ユーザーの問合せに合うデータの最初のセットにページを戻すには、「このページのページ区切りをリセット」を選択します。

ユーザーがページを送信してブランチが他のページに移動する場合にメッセージを表示するには、「プロセスの成功メッセージを含める」を選択します。メッセージの表示はページの送信の一部であり次のページの表示の一部ではないので、このオプションを選択しない場合は、メッセージは表示されません。

- リクエスト: REQUESTと呼ばれる組込みアプリケーション・アイテムに割り当てるテキストを入力します。詳細は、アイテムのヘルプを参照してください。「フィールドレベル・ヘルプについて」を参照してください。

- キャッシュのクリア: キャッシュをクリアするページ番号を指定します。複数のエントリをカンマで区切ります。

3. セッション・ステートを設定するには(リストされたアイテムに値を与えます)、次のステップを実行します。

- 「次のアイテムを設定」で、セッション・ステートを設定するアイテム名をカンマで区切って入力します。

- 「次の値を使用」で、「次のアイテムを設定」で指定したアイテムの値をカンマで区切って入力します。
静的な値または置換構文(&APP_ITEM_Name.など)を指定できます。URLのf?p=に渡されるアイテム値にはコロン(:)を使用しないでください。また、バックスラッシュでアイテム値全体を囲んだ場合(\1234,56\など)を除いて、カンマも使用しないでください。

4. 「次へ」をクリックします。

5. 画面に表示されるステップに従います。

関連項目:
「「対象ボタン」属性について」

12 ページ・レイアウトの制御

ここでは、リージョンのカスタマイズ、アイテム属性の編集およびイメージの組込みによって、データベース・アプリケーションのページ・レイアウトをカスタマイズする様々な方法について説明します。

内容は次のとおりです。

- Oracle Application Expressでのページ・レイアウトの理解

- すべてのページにコンポーネントを表示するグローバル・ページの作成

- リージョンの理解

- アイテム属性がページ・レイアウトに与える影響

- 他のWebサイトからのコンテンツの統合

- イメージの管理

- 静的ファイルの管理

- カスタムPL/SQLを使用したHTMLのレンダリング

関連項目:
「ナビゲーションの追加」および「アプリケーションのユーザー・インタフェースの管理」

Oracle Application Expressでのページ・レイアウトの理解

Application Expressエンジンは、開発者によって定義されたアプリケーション・コンポーネントおよびデータベース内のデータをテンプレートと組み合せてページをレンダリングします。

全体的なフレームワーク(またはページの構造)は、ページ・テンプレートによって決まります。たとえば、ページ・テンプレートは、ページでタブおよびナビゲーション・バーを使用するかどうかを制御します。また、ページの左側にナビゲーションまたはセカンダリ・コンテンツ用のプレースホルダとして機能するバーを含めるかどうかを定義することもできます。さらに、ページ・テンプレートには、リージョン位置の定義を含めることができます。これによって、HTML表またはスタイルシート定義を使用してリージョンの位置を正確に制御できます。ページ・テンプレート自体は、置換文字列と組み合されたHTMLで構成されます。これらの置換文字列は、実行時に、適切なコンポーネントに置換されます。

開発者は、リージョンを作成することによってページにコンテンツを追加します。リージョンはページの領域で、コンテンツのコンテナとして機能します。各リージョンには、HTML、レポート、フォーム、チャート、リスト、ブレッドクラム、PL/SQL、ツリー、URL、カレンダなどの様々なコンテンツが含まれます。他のリージョンとの相対位置によって(順序番号および列に基づいて)、またはページ・テンプレートに定義されたリージョン位置を使用して、リージョンを配置します。リージョンのスタイルは、リージョン・テンプレートによっても制御されます。ページ・テンプレートと同様に、リージョン・テンプレートは、リージョンを表示するページ上の領域の構造を定義します。リージョン・テンプレートは、リージョン・タイトルを表示するかどうか、およびメイン・コンテンツ(ボディ)に対するリージョン・タイトルの相対的な表示位置を定義します。リージョンでは、ボタンの絶対位置を定義することもできます。

関連項目:
「リージョンの作成」

コンポーネントをすべてのページに表示するためのグローバル・ページの作成

アプリケーションのグローバル・ページは、マスター・ページとして機能します。ユーザー・インタフェースごとに個別のグローバル・ページを追加できます。グローバル・ページに追加したすべてのコンポーネントが、Application Expressエンジンによってアプリケーション内のすべてのページでレンダリングされます。Application Expressエンジンでコンポーネントをレンダリングするか、または条件を定義することで計算、検証またはプロセスを実行するかを制御することもできます。

関連項目:
「データベース・アプリケーションのページの管理」、「条件付きのレンダリングおよびプロセスの理解」および「使用可能な条件」

内容は次のとおりです。

- グローバル・ページの作成

- グローバル・ページへのナビゲート

グローバル・ページの作成

グローバル・ページを作成するには、次のステップを実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。

2. アプリケーションを選択します。
「アプリケーション」ホームページが表示されます。

3. 「ページの作成」ボタンをクリックします。

4. 「ページの作成」で、次のステップを実行します。

1. ユーザー・インタフェース: ページのユーザー・インタフェースを選択します。

2. 「ページ・タイプの選択」で、「グローバル・ページ」を選択します。
「グローバル・ページ」オプションは、指定したユーザー・インタフェースのグローバル・ページがアプリケーションにない場合にのみ表示されます。

5. 「ページ番号」で、アプリケーション内でページを識別する整数値を入力します。

6. 「終了」をクリックします。

関連項目:
「アプリケーションのユーザー・インタフェースの管理」

グローバル・ページへのナビゲート

グローバル・ページにナビゲートするには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。
アプリケーション・ビルダーのホームページが表示されます。

2. アプリケーションを選択します。
「アプリケーション」ホームページが表示されます。

3. 「グローバル・ページ」を選択します。

リージョンの理解

リージョンはページ上の領域で、コンテンツのコンテナとして機能します。各ページには任意の数のリージョンを配置できます。特定のリージョン・テンプレートによってリージョンの外観を制御できます。リージョン・テンプレートでは、リージョンの外観およびサイズの制御、枠線または背景色を使用するかどうかの指定、表示するフォントの決定を行います。また、リージョン位置に配置されるボタンの標準配置も制御します。

リージョンを使用して、ページ・コントロール(アイテムやボタンなど)をグループ化できます。追加のHTMLを生成しない単純なリージョンを作成したり、HTML表やイメージ内でコンテンツを形成する詳細なリージョンを作成できます。

リージョンはページ・テンプレート・ボディに順次表示されるか、またはリージョン位置に明示的に配置できます。ページ構造を定義するには、HTML表または今日より一般的なDIVタグを使用します。

内容は次のとおりです。

- リージョンの作成

- リージョン・タイプについて

- リージョンの編集

- リージョン表示セレクタの作成

- リージョンのコピー

- リージョンの削除

関連項目:
「ページ固有のユーティリティについて」

リージョンの作成

「リージョンの作成」ウィザードを実行して、リージョンを作成します。

リージョンを作成するには、次のようにします。

1. 該当する「ページ定義」にナビゲートします。「「ページ定義」へのアクセス」を参照してください。

2. リージョンの作成ウィザードにアクセスします。

- 「コンポーネント」ビュー: 「リージョン」の下の「作成」アイコンをクリックします。

- 「ツリー」ビュー:「リージョン」を右クリックし、「作成」アイコンを選択します。

「リージョンの作成」ウィザードが表示されます。

3. リージョン・タイプを選択します。詳細は、「リージョン・タイプについて」を参照してください。

4. 表示属性を指定します。

- 「コンポーネント」ビュー: 「リージョン」の下の「作成」アイコンをクリックします。

- 「ツリー」ビュー:「リージョン」を右クリックし、「作成」アイコンを選択します。

「リージョンの作成」ウィザードが表示されます。

5. 画面に表示されるステップに従います。

関連項目:
「リージョン表示セレクタの作成」

サブリージョンの作成について

サブリージョンを使用すると、2つのリージョン間に親/子関係を作成できます。サブリージョンは親リージョン内に表示されます。親リージョンは、リージョンを新規作成するとき、またはリージョン属性を編集するときに指定できます。詳細は、「リージョンの作成」および「リージョンの編集」を参照してください。

この機能は、様々な方法で使用できます。ユースケースの1つは、サブリージョンを使用した情報のグループ化です。たとえば、枠線があるリージョンがあるとします。この機能を使用すると、このリージョン内に2つのクラシック・レポート(サブリージョン)を表示できます。また、サブリージョンを使用して、リージョンをタブまたはアコーディオンとして表示できます。親リージョンとサブリージョンの表示方法を制御するには、リージョン・テンプレートの「サブリージョン」属性を編集します。詳細は、「リージョン・テンプレート」を参照してください。

リージョン・タイプについて

リージョンの作成時には、リージョン・タイプを選択します。Application Expressエンジンは、選択したタイプに応じてリージョンを解釈します。表 12-1に、使用可能なリージョン・タイプを示します。

表 12-1 リージョン・タイプ

リージョン・タイプ

説明

HTML

HTMLを選択すると、次のいずれかを選択するプロンプトが表示されます。

- HTML: アイテムのコンテナとして機能し、指定したHTMLが含まれます。入力するHTMLには、置換文字列を含めることができます。

- HTMLテキスト(特殊文字をエスケープ): HTMLリージョンと同じですが、Application Expressエンジンによって、特殊文字がレンダリング前にエスケープされます。

- HTMLテキスト(ショートカットあり): HTMLリージョンと同じですが、ショートカットがサポートされます。

関連項目: 「ショートカットの使用」

複数のHTML

複数のHTMLリージョンを一度に作成するには、このオプションを使用します。表示されるフィールドで、各リージョンの順序、タイトル、表示ポイント、レポート・テンプレートおよび列を指定します。

レポート

レポート・リージョンは、SQL問合せを記述するか、またはウィザードを使用して問合せの記述に必要なステップを実行することによって定義できます。

関連項目:

フォーム

フォーム・リージョンは、フォームを含めるために使用されます。

参照: フォームの作成

プラグイン

開発者はプラグインを使用して、Application Expressで使用可能な組込みタイプを宣言的に拡張できます。

参照: 「プラグインの実装」

チャート

チャート・リージョンには、SQL問合せに基づく線グラフ、棒グラフまたは円グラフが含まれます。

関連項目: 「チャートの作成」

マップ

「マップ」リージョンには、宣言的に定義されたFlashマップが表示されます。

参照: 「マップの作成」

ツリー

ツリーは、実行時に実行されるSQL問合せに基づく、階層的なナビゲーション・コントロールです。

参照: ツリーの作成

カレンダ

カレンダ・リージョンは、カレンダを含めるために使用されます。

参照: カレンダの作成

リスト

リスト・リージョンには、リストと呼ばれるリンクの共有コレクションが含まれます。

参照: 「リストの作成」

ブレッドクラム

ブレッドクラム・リージョンには、ブレッドクラムと呼ばれるリンクの階層的なリストが含まれます。

参照: 「ブレッドクラムの作成」

PL/SQL動的コンテンツ

PL/SQLに基づくリージョンでは、PL/SQL Webツールキットを使用してHTMLまたはテキストをレンダリングできます。

URL

URLに基づくリージョンでは、事前定義されたURLを使用してWebサーバーをコールすることによって、コンテンツが取得されます。

参照: 「他のWebサイトからのコンテンツの統合」

リージョン表示セレクタ

「リージョン表示セレクタ」リージョンでは、リージョン表示選択が有効化されている、ページの各リージョンに表示と非表示のコントロールを表示できます。

参照: 「リージョン表示セレクタの作成」

ヘルプ・テキスト

ヘルプ・テキスト・リージョンでは、ページ・レベルのヘルプを指定できます。

参照: 「ヘルプ・ページの作成」

関連項目:

- PL/SQLを使用したWebアプリケーションの開発の詳細は、Oracle Databaseアドバンスト・アプリケーション開発者ガイドを参照してください。

- htpパッケージの詳細は、Oracle Database PL/SQLパッケージおよびタイプ・リファレンスを参照してください。

リージョンの編集

リージョンとは、コンテンツのコンテナとしての役割を持つページ領域のことです。ページの外観を変更するには、リージョン属性を編集します。

内容は次のとおりです。

- リージョン属性の編集

- リージョン属性がページ・レイアウトに与える影響

- リージョンのヘッダーおよびフッターの指定

- ユーザーによるページのカスタマイズの可能化

- リージョン・キャッシュの使用

- 静的リージョンIDの指定

- リージョン・イメージの追加

- 複数リージョンの同時編集

リージョン属性の編集

リージョン属性を編集するには、次のステップを実行します。

1. 該当する「ページ定義」にナビゲートします。「「ページ定義」へのアクセス」を参照してください。

2. リージョンの編集ページにアクセスします。

- コンポーネント・ビュー: 「リージョン」で、リージョン名を選択します。

- ツリー・ビュー: リージョン名を右クリックし、「編集」を選択します。

リージョンの編集ページが表示されます。

注意:
プラグイン・タイプのリージョンに関する詳細は、「プラグイン・ページからのプラグインのインポート」を参照してください。

3. 対象となる属性を編集します。

4. ページ上の特定のアイテムの詳細を表示するには、アイテム・ラベルをクリックします。
ヘルプが使用可能な場合は、アイテムにカーソルをあわせると、カーソルが疑問符付きの矢印に変わります。「フィールドレベル・ヘルプについて」を参照してください。

5. 「変更の適用」をクリックします。

関連項目:
「リージョン属性がページ・レイアウトに与える影響」、「リージョン位置の制御」および「リージョンのヘッダーおよびフッターの指定」

ナビゲーションの選択肢について

リージョン定義ページはセクションに分かれています。これらのセクションにアクセスするには、ページをスクロールするか、ページ上部のナビゲーション・ボタンをクリックします。ページ上部のボタンを選択すると、選択されたセクションが表示され、その他のセクションはすべて一時的に非表示になります。ページのすべてのセクションを表示するには、「すべて表示」をクリックします。

リージョン属性がページ・レイアウトに与える影響

リージョン属性はページの外観を制御します。表12-2に、ページのレイアウトに影響を与えるリージョン属性を示します。

表 12-2 ページ・レイアウトに影響を与えるリージョン属性

属性

説明

ユーザー・インタフェース、順序

ページ内のリージョンの表示順を指定します。

ユーザー・インタフェース、親リージョン

現在のリージョンが属している親リージョンを定義します。

ユーザー・インタフェース、表示ポイント

ページ内でリージョンを表示する位置を指定します。リージョンは、「表示ポイント」の順序番号順にレンダリングされます。ページ・レイアウトを表示するには、「ビュー」アイコンをクリックして、位置を選択します。

選択可能な表示ポイントは、ページ・レベル・テンプレート(ページ属性)によって決定されます。ページ・レベル・テンプレートを選択しなかった場合は、「アプリケーションの定義」で定義されたデフォルトのページ・レベル・テンプレートが使用されます。

ユーザー・インタフェース、テンプレート

リージョンの外観を決定します。テンプレート属性を表示するには、「ページ定義」でテンプレート名をクリックします。

関連項目: 「テンプレートのカスタマイズ」および「リージョン・テンプレート」

ユーザー・インタフェース、アイテム表示位置

ページ・アイテムがメイン・リージョン・コンテンツの上または下のいずれに表示されるかを決定します。

グリッド・レイアウト、新規グリッドの開始

このリージョンが新規グリッドに表示されるか、前のリージョンと同じグリッドに表示されるかを決定します。

グリッド・レイアウト、新規行の開始

このリージョンが前のリージョンと同じ行に表示されるか、次の行に表示されるかを決定します。

グリッド・レイアウト、列

リージョンを特定のグリッド列に表示するかどうかを決定します。リージョンを表示できる次のグリッド列を自動的に決定するには、「自動」を選択します。

グリッド・レイアウト、列スパン

リージョンが占有するグリッド列数を決定します。同じグリッド行のすべてのリージョンで使用可能なグリッド列を均等にするには、「自動」を選択します。

グリッド・レイアウト、列属性

グリッド列に設定する追加属性を入力します。この値によって、グリッド・レイアウト列テンプレートの#ATTRIBUTES#置換プレースホルダが置き換えられます。

属性、リージョンのCSSクラス

リージョン・テンプレートに置換文字列#REGION_CSS_CLASSES#が含まれている場合に置換される追加CSSクラスを、スペースで区切ったリストとして入力します。

属性、リージョン

置換文字列#REGION_ATTRIBUTES#が含まれているリージョン・テンプレートは、この値で置換されます。

属性、リージョン表示セレクタ

リージョン表示セレクタを使用して、リージョン表示セレクタ・リージョン・タイプに表示するリージョンを識別します。リージョン表示セレクタを使用すると、ページで他のリージョンを非表示にして、特定のリージョンのみを表示できます。リージョン表示セレクタには、この属性を使用して指定したリージョンのみが表示されます。

属性、リージョン・イメージ

移入されている場合、指定されたイメージがリージョンの左上に表示されます。このイメージの表示に使用される表タグを制御することはできません。

参照: 「リージョン・イメージの追加」

属性、イメージ・タグ属性

「リージョン・イメージ」属性とともに使用します。イメージhtmlに含める属性を入力します。たとえば、高さと幅にこの属性を使用します。

注意: イメージ・タグ属性でALTが定義されていない場合、Oracle Application Expressではデフォルトでイメージは装飾的なイメージとしてレンダリングされます(たとえば、空のALTタグを使用)。

参照: 「リージョン・イメージの追加」

ヘッダーおよびフッター

リージョンの最上部(#BODY#コンテンツの直前)に表示されるHTMLテキストを指定します。

条件

リージョンを表示するかどうかを決定する条件および適切な式を定義します。条件では、セッション・ステート、現在ログインしているユーザーまたは環境設定(ページが印刷用ビュー・モードかどうかなど)を参照できます。

関連項目: 「条件付きのレンダリングおよびプロセスの理解」および「印刷用ページの最適化」

カスタマイズ

エンド・ユーザーによるカスタマイズを可能にします。この機能を使用するには、ページ・テンプレートのヘッダー、ボディまたはフッター・セクションに#CUSTOMIZE#置換文字列を含める必要があります。

関連項目: 「ユーザーによるページのカスタマイズの可能化」

リージョン位置の制御

リージョンを作成する際に、ページでのそのリージョンの位置(「表示ポイント」)を指定する必要があります。デフォルト位置(ページ・テンプレート・ボディなど)またはテンプレートにユーザーが定義した位置(「ページ・テンプレートのリージョン位置1」など)のいずれかを選択できます。

表示ポイントに加えて、リージョンを配置する列を指定できます。複数の列にリージョンを配置する場合は、Oracle Application Expressによって必要なHTMLが自動的にレンダリングされ、複数列のレイアウトが生成されます。

リージョンのヘッダーおよびフッターの指定

リージョンのボディ・コンテンツ(レポート、チャートまたはフォーム要素付きのHTML)に加えて、追加のHTMLをリージョンの上下(ヘッダーおよびフッター)に配置できます。

すべてのレポート・リージョンで、置換文字列#TIMING#:はリージョンのレンダリングにかかる経過時間(秒)を表示できます。この置換文字列はデバッグに使用できます。

クラシック・レポート・リージョンの場合、リージョン・フッターで次の置換文字列がサポートされています。

- #ROWS_FETCHED#: Oracle Application Expressレポート・エンジンによってフェッチされた行数(ページ・サイズ)を表示できます。これらの置換文字列を使用して、カスタマイズされたメッセージをユーザーに表示できます。次に例を示します。

Fetched #ROWS_FETCHED# rows in #TIMING# seconds.

- #TOTAL_ROWS#: レポートに使用されたSQL問合せを満たす行の合計数を表示できます。

- #FIRST_ROW_FETCHED# および#LAST_ROW_FETCHED#: 表示される行の範囲を表示できます。次に例を示します。

Row(s) #FIRST_ROW_FETCHED# through #LAST_ROW_FETCHED# of #ROWS_FETCHED# displayed

関連項目:
「リージョン・タイプについて」

ユーザーによるページのカスタマイズの有効化

「カスタマイズ」属性を使用すると、リージョンの表示属性をユーザーがカスタマイズできるかどうかを制御できます。

エンド・ユーザーは次の手順でカスタマイズできます。

1. 該当する「ページ定義」にナビゲートします。「「ページ定義」へのアクセス」を参照してください。

2. リージョンの編集ページにアクセスします。

- コンポーネント・ビュー: 「リージョン」で、リージョン名を選択します。

- ツリー・ビュー: リージョン名を右クリックし、「編集」を選択します。

リージョンの編集ページが表示されます。

3. 「カスタマイズ」までスクロールして、次のいずれかを選択します。

- デフォルトでカスタマイズ可能および非表示

- デフォルトでカスタマイズ可能および表示

- エンドユーザーではカスタマイズ不可

4. 「カスタマイズ・オプション名」に、ページのこのリージョンをユーザーに示すラベルを入力します。

5. ページ・テンプレートの「ヘッダー」、「ボディ」または「フッター」セクションに#CUSTOMIZE#置換文字列を含めます。

この機能を使用するには、ページ・テンプレートのヘッダー、ボディまたはフッター・セクションに#CUSTOMIZE#置換文字列を含める必要があります。

エンド・ユーザーによるカスタマイズが1つ以上のリージョンでサポートされる場合、「カスタマイズ」というリンクがページ・テンプレートで#CUSTOMIZE#置換文字列を含めた場所に表示されます。このリンクをクリックするとウィンドウが表示され、ユーザーは、ページのリージョンのオン/オフを切り替えることができるようになります。

関連項目:
「テンプレートのカスタマイズ」

リージョン・キャッシュの使用

リージョン・キャッシュの有効化は、静的HTMLを含む条件またはリージョンが使用されていないリストが含まれるリージョンなどの静的リージョンのパフォーマンスの向上に効果的な方法です。

ヒント:
リージョン・キャッシュは、対話モード・レポート・リージョンに対しては使用できません。

リージョン・キャッシュを有効化すると、Application Expressエンジンによって、リージョンを動的にレンダリングするかわりにキャッシュされた(格納された)リポジトリからリージョンをレンダリングします。実際のセッション識別子はキャッシュされないことに注意してください。かわりに、Application Expressエンジンでは、&SESSION.置換文字列がキャッシュされ、キャッシュされたリージョンをレンダリングしたカレント・セッションが表示時に代入されます。たとえば、リージョンにリンクが含まれ、リンクにセッションが含まれる場合、リンクがすべてのセッションで動作するようにするため、完全なセッションはキャッシュされません。

Application Expressエンジンは、リージョンが定義した条件を満たす場合にのみキャッシュからレンダリングします。また、リージョンは、ユーザーまたはキャッシュされた独立したユーザーに対してのみキャッシュできます。

関連項目:
「キャッシュ」および「キャッシュされたリージョンの管理」

リージョン・キャッシュの有効化

リージョン・キャッシュを有効化するには、次のステップを実行します。

1. 該当する「ページ定義」にナビゲートします。「「ページ定義」へのアクセス」を参照してください。

2. リージョンの編集ページにアクセスします。

- コンポーネント・ビュー: 「リージョン」で、リージョン名を選択します。

- ツリー・ビュー: リージョン名を右クリックし、「編集」を選択します。

リージョンの編集ページが表示されます。

3. 「キャッシュ」までスクロールします。

4. 「キャッシュ」で次のいずれかを選択します。

- キャッシュ済: ユーザーとは関係なくリージョンをキャッシュします。

- ユーザー別のキャッシュ: 指定されたユーザーに固有のリージョンをキャッシュします。

- 未キャッシュ: この機能を無効にします。

5. 「キャッシュ済」または「ユーザー別のキャッシュ」を選択する場合は、次を指定します。

1. 次の後にキャッシュをタイムアウト: キャッシュされたリージョンが有効な期間を指定します。

2. キャッシュ条件タイプ: リストから条件タイプを選択します。条件がFalseを戻す場合、リージョンは動的にレンダリングされ、キャッシュされません。条件がTrueを戻す場合、リージョンはキャッシュされます。

3. 式1および式2: 選択した特定の条件タイプに基づいて値を入力します。

6. 「変更の適用」をクリックします。

キャッシュされたリージョンの管理

アプリケーションのパフォーマンスを改善するための方法の1つは、リージョンのキャッシュを使用することです。開発者はリージョンの編集ページで「キャッシュ」属性を設定することにより、リージョンのキャッシュを構成できます。詳細は、「リージョン・キャッシュの使用」を参照してください。

キャッシュされたリージョンはキャッシュされたリージョン・ページで管理できます。

キャッシュされたリージョン・ページにアクセスするには、次のステップを実行します。

1. 該当する「ページ定義」にナビゲートします。「「ページ定義」へのアクセス」を参照してください。

2. アプリケーションを選択します。

3. 「ユーティリティ」ボタンをクリックし、「キャッシュ」を選択します。

4. 「キャッシュされたリージョン」で「管理」をクリックします。
キャッシュされたリージョン・ページが表示されます。

5. ページ上部の検索バーを使用してページの概観をカスタマイズできます。4を参照してください。

6. 消去するリージョンを選択して、次のいずれかをクリックします。

- 期限切れの消去

- チェックした項目の消去

7. キャッシュされたリージョンをすべて消去するには、「すべて消去」をクリックします。

関連項目:
Oracle Application Express管理ガイドの「キャッシュされたリージョンの管理」

静的リージョン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. 「変更の適用」をクリックします。

リージョン・イメージの追加

「リージョン・イメージ」および「イメージ・タグ属性」を使用すると、リージョンの左上にイメージを追加できます。

リージョン・イメージを追加するには、次のステップを実行します。

1. 該当する「ページ定義」にナビゲートします。「「ページ定義」へのアクセス」を参照してください。

2. リージョンの編集ページにアクセスします。

- コンポーネント・ビュー: 「リージョン」で、リージョン名を選択します。

- ツリー・ビュー: リージョン名を右クリックし、「編集」を選択します。

リージョンの編集ページが表示されます。

3. 「属性」までスクロールします。

4. 「属性」で次を指定します。

- リージョン・イメージ: リージョンの左上に表示するイメージを指定します。

- イメージ・タグ属性: イメージhtmlに含める属性を入力します。入力した属性を使用して、高さと幅を指定します。

5. 「変更の適用」をクリックします。

複数リージョンの同時編集

アプリケーション・ビルダーには、複数のリージョンを一度に編集する方法が数多くあります。

内容は次のとおりです。

- すべてのリージョンにわたる複数の属性の編集

- リージョン・ユーティリティへのアクセス

すべてのリージョンにわたる複数の属性の編集

リージョン・ページを使用すると、順序、列、リージョン名、表示ポイントなど、ページのすべてのリージョンのリージョン属性を更新できます。

関連項目:
リージョン属性についての詳細は、リージョンの編集ページに移動してください。詳細は、「リージョンの編集」を参照してください。

すべてのリージョンにわたる複数の属性を編集するには、次のステップを実行します。

1. 該当する「ページ定義」にナビゲートします。「「ページ定義」へのアクセス」を参照してください。

2. リージョンの編集ページにアクセスします。

- コンポーネント・ビュー: 「すべて編集」アイコンをクリックします。「すべて編集」アイコンは、鉛筆が置かれた小さいグリッドの形をしています。

- 「ツリー」ビュー: 「リージョン」を右クリックし、「すべて編集」を選択します。

リージョン・ページが表示されます。

3. 適切な属性を編集します。

4. 「変更の適用」をクリックします。

リージョン・ユーティリティへのアクセス

ユーティリティ・ページを使用すると、選択したアプリケーション内の全ページに対するグリッド編集ページとレポートにアクセスできます。

リージョン・ユーティリティ・ページにアクセスするには、次のステップを実行します。

1. 該当する「ページ定義」にナビゲートします。「「ページ定義」へのアクセス」を参照してください。

2. リージョン・ページにアクセスします。

- コンポーネント・ビュー: 「すべて編集」アイコンをクリックします。「すべて編集」アイコンは、鉛筆が置かれた小さいグリッドの形をしています。

- 「ツリー」ビュー: 「リージョン」を右クリックし、「すべて編集」を選択します。

リージョン・ページが表示されます。

3. 「ユーティリティ」をクリックします。

4. ユーティリティを選択し、画面に表示されるステップに従います。

関連項目:
「リージョンの編集」

リージョン表示セレクタの作成

「リージョン表示セレクタ」リージョンでは、ページの各リージョンに表示と非表示のコントロールを表示できます。

リージョン表示セレクタを作成するには、次のステップを実行します。

1. リージョン・ページ・セレクタに含めるページおよびリージョンを作成します。

2. セレクタに含める各リージョンの「リージョン表示セレクタ」属性を編集します。

1. 該当する「ページ定義」にナビゲートします。「「ページ定義」へのアクセス」を参照してください。

2. リージョンの編集ページにアクセスします。

- コンポーネント・ビュー: 「リージョン」で、リージョン名を選択します。

- ツリー・ビュー: リージョン名を右クリックし、「編集」を選択します。

リージョンの編集ページが表示されます。

3. 「属性」で、「リージョン表示セレクタ」を「はい」に変更します。

4. 「変更の適用」をクリックします。

3. タイプがリージョン表示セレクタのリージョンを作成します。

1. 「ページ定義」にナビゲートします。「「ページ定義」へのアクセス」を参照してください。

2. リージョンの作成ウィザードにアクセスします。

- 「コンポーネント」ビュー: 「リージョン」の下の「作成」アイコンをクリックします。

- 「ツリー」ビュー:「リージョン」を右クリックし、「作成」アイコンを選択します。

「リージョンの作成」ウィザードが表示されます。

3. リージョン・タイプ「リージョン表示セレクタ」を選択します。

4. 「作成」をクリックします。

リージョンのコピー

注意:
「ツリー」タイプのリージョンには複数のリージョンが含まれるため、コピーできません。

リージョンをコピーするには、次のステップを実行します。

1. 「ページ定義」にナビゲートします。「「ページ定義」へのアクセス」を参照してください。

2. リージョンの編集ページにアクセスします。

- 「コンポーネント」ビュー: 「リージョン」で「コピー」アイコンをクリックします。「コピー」アイコンは、小さいページが2つ重なった形をしています。

- 「ツリー」ビュー: リージョンを右クリックし、「コピー」アイコンをクリックします。

リージョンのコピー・ウィザードが表示されます。

3. 「コンポーネント」ビューを使用する場合は、コピーするリージョンを選択します。使用しない場合は、次のステップに進みます。

4. 「コピー先ページ」で次を実行します。

1. コピー先ページ: リージョンのコピー先のページを選択します。

2. リージョン・アイテムのコピー: 「はい」または「いいえ」を選択し、このリージョン内のアイテムをコピーするかどうかを決定します。リージョンによっては、このオプションは表示されない場合があります。

3. ボタンのコピー: 「はい」または「いいえ」を選択し、このリージョン内のボタンをコピーするかどうかを決定します。リージョンによっては、このオプションは表示されない場合があります。

4. 「次へ」をクリックします。

5. 「リージョンのコピー」をクリックします。

リージョンの削除

リージョンを削除するには、次のステップを実行します。

1. 該当する「ページ定義」にナビゲートします。「「ページ定義」へのアクセス」を参照してください。

2. リージョンの編集ページにアクセスします。

- コンポーネント・ビュー: 「リージョン」で、リージョン名を選択します。

- ツリー・ビュー: リージョン名を右クリックし、「編集」を選択します。

リージョンの編集ページが表示されます。

3. 「削除」をクリックします。

複数リージョンの同時削除

一度に複数のリージョンを削除するには、次のステップを実行します。

1. 該当する「ページ定義」にナビゲートします。「「ページ定義」へのアクセス」を参照してください。

2. リージョンの編集ページにアクセスします。

- コンポーネント・ビュー: 「すべて編集」アイコンをクリックします。「すべて編集」アイコンは、鉛筆が置かれた小さいグリッドの形をしています。

- 「ツリー」ビュー: 「リージョン」を右クリックし、「すべて編集」を選択します。

リージョン・ページが表示されます。

3. 「複数のリージョンの削除」タブをクリックします。

4. 次を指定します。

1. ボタンを削除するカスケード: 「はい」を選択すると、対応するリージョンのボタンが削除されます。

2. アイテムを削除するカスケード: 「はい」を選択すると、対応するリージョンのアイテムが削除されます。

3. 関連付けられたリストおよびリスト・エントリを削除しますか。: 「はい」を選択すると対応するリストが削除されます。このオプションは、削除されるリージョンがこのリストを参照する唯一のリージョンである場合にのみ表示されます。

4. 動的アクションを削除するカスケード: 「はい」を選択すると、対応するリージョンのアイテムが削除されます。

5. 削除するリストを選択します。

6. 「変更の適用」をクリックします。

アイテム属性がページ・レイアウトに与える影響

アイテムはHTMLフォームの一部であり、テキスト・フィールド、テキスト領域、パスワード、選択リスト、チェック・ボックスなどを示します。アイテム属性を変更することで、ページの外観を変更できます。たとえば、これらの属性は、ラベルの表示位置、アイテムの大きさおよびアイテムの表示位置(左右、上下)に影響します。

関連項目:
「ページ・レベル・アイテムの理解」

アイテム属性を編集するには、次のステップを実行します。

1. 「ページ定義」にナビゲートします。「「ページ定義」へのアクセス」を参照してください。

2. アイテムの属性ページにアクセスします。

- ツリー・ビュー: アイテムを右クリックし、「編集」を選択します。

- コンポーネント・ビュー: 「アイテム」で、アイテム名を選択します。

ヒント:
アイテム名をダブルクリックするか、または名前を選択して[Enter]キーを押すことでアイテムを編集することもできます。「ツリー・ビューでのページの編集」を参照してください。

「ページ・アイテムの編集」ページが表示されます。

3. 「アイテム」で、アイテム名をクリックします。
「ページ・アイテムの編集」ページが表示されます。

表 12-3に、アイテム属性がページ・レイアウトに与える影響を示します。

表 12-3 ページ・レイアウトに影響を与えるアイテム属性

ヘッダー

属性

説明

ユーザー・インタフェース

順序

このコンポーネントの表示順序を指定します。これによって評価の順序が決まります。

ユーザー・インタフェース

リージョン

アイテムを表示するリージョンを定義します。すべてのアイテムは、リージョンに存在します。

ユーザー・インタフェース

テンプレート

アイテム・テンプレートを示します。アイテム・テンプレートを使用すると、中心部のユーザー・インタフェースの属性の定義、および多くのページ・アイテム間での定義の共有ができます。

グリッド・レイアウト

新規グリッドの開始

このページ・アイテムが新規グリッドに表示されるか、前のページ・アイテムと同じグリッドに表示されるかを決定します。

グリッド・レイアウト

新規行の開始

このページ・アイテムが前のページ・アイテムまたはボタンと同じ行に表示されるか、次の行に表示されるかを決定します。

グリッド・レイアウト

列

ページ・アイテムを特定のグリッド列に表示するかどうかを決定します。ページ・アイテムを表示できる次のグリッド列を自動的に決定するには、「自動」を使用します。

グリッド・レイアウト

列スパン

ページ・アイテムが占有するグリッド列数を決定します。同じグリッド行のすべてのページ・アイテムおよびボタンで使用可能なグリッド列を均等にするには、「自動」を使用します。

グリッド・レイアウト

行スパン

アイテムがHTML表に配置される場合、この属性は、ページ・アイテムが表示される表セルのROWSPAN属性に使用される値を決定します。

グリッド・レイアウト

列の属性

グリッド列に対して設定される追加属性を入力します。この値によって、グリッド・レイアウト列テンプレートの#ATTRIBUTES#置換プレースホルダが置き換えられます。

ラベル

ラベル

ページ・アイテムのフィールド・ラベルを識別します。ラベルは、アイテムが表示される場合にのみページに表示されます。ラベルの位置合せに応じて、ラベルは一部の表示では固有のHTML表セルに表示され、他の表示では同じセルに表示されます。"SHORTCUT_NAME"構文を使用して、アイテム・ラベルにショートカットを含めることができます。

ラベル

横/縦の位置合せ

ラベルの配置および縦横の位置合せを制御します。ラベルは、アイテムの上、下または左に表示できます。ラベルがフォーム要素の横に表示される場合、ラベルは固有のHTML表セルを占有します。ここで位置合せを変更することによって、その表セル内のラベルの位置を制御します。

ラベル

HTML表のセル属性

このラベルを含むHTML表セルで使用される追加属性を入力します。

要素

要素の前のテキスト

ラジオ・グループまたは一連のチェック・ボックスの個々のオプションの表示に使用されるHTML表セルに、追加の属性を指定します。HTML、JavaScriptおよびショートカットを含めることができます。次の置換文字列を参照できます。

- #CURRENT_FORM_ELEMENT#: この要素の後のテキストが関連付けられるHTMLフォーム要素の名前を取得します。

- #CURRENT_ITEM_NAME#: この要素の後のテキストが関連付けられるアイテムの名前を取得します。

要素

要素の後のテキスト

ラジオ・グループまたは一連のチェック・ボックスの個々のオプションの表示に使用されるHTML表セルに、追加の属性を指定します。HTML、JavaScriptおよびショートカットを含めることができます。次の置換文字列を参照できます。

- #CURRENT_FORM_ELEMENT#: この要素の後のテキストが関連付けられるHTMLフォーム要素の名前を取得します。

- #CURRENT_ITEM_NAME#: この要素の後のテキストが関連付けられるアイテムの名前を取得します。

条件

条件タイプと式

アイテムを表示するかどうかを決定する条件および適切な式を定義します。

関連項目: 「条件付きのレンダリングおよびプロセスの理解」

読取り専用の表示設定

読取り専用条件タイプ

アイテムを読取り専用で表示するかどうかを決定する条件および式を定義します。この属性を使用すると、一連のユーザーに対する特定のアイテムを更新可能として表示し、その同じアイテムを他のユーザーに対しては更新不可として表示します。異なるユーザーでコードが重複するインタフェースの必要性を低減します。

他のWebサイトからのコンテンツの統合

通常、アプリケーションのページは、Oracle Databaseに格納されたデータに基づきます。他のサーバーからコンテンツを組み込むには、コンテンツを表示するURLに基づくリージョンを作成できます。たとえば、現在のオラクル社の株価を参照すると想定します。次のようなURLに基づく、URLタイプのリージョンを作成します。

http://quote.yahoo.com/q?d=b&s=ORCL

次に、STOCK_SYMBOLというアイテムを作成して、ユーザーが入力した株価をリージョンの基にします。次に例を示します。

http://quote.yahoo.com/q?d=b&s=&STOCK_SYMBOL.

リージョンに対して必要以上に多くのHTMLが戻される場合があります(前述の例の場合など)。表示されるHTMLを制限するには、次のリージョン属性を使用できます。

- URL(破棄の終了、このテキストを含まず)

- URL(破棄の開始、このテキストを含む)

前述の例では、プロキシ・サーバー・アプリケーション属性の設定が必要な場合があることに注意してください。プロキシ・サーバー・アプリケーション属性を指定しない場合、エラー・メッセージが表示されます。Oracle Application Expressは、Oracleのutl_http.request_piecesファンクションを使用して、指定したURLから生成されたHTMLを取得します。「アプリケーション定義の編集」を参照してください。

SSL有効URLでの作業

SSL有効URL(Webサービスの起動など)をコールする場合、またはSSL有効URLタイプのリージョンを作成する場合、ウォレットを作成する必要があります。ウォレットは、SSLに必要な認証および署名された資格証明(秘密鍵、証明書および信頼できる証明書)の格納に使用されるパスワード保護されたコンテナです。

ヒント:
Oracle Application Express管理ガイドの「ウォレット情報の構成」を参照してください。

イメージの管理

アプリケーション内のイメージは、イメージ・リポジトリにアップロードすることで参照できます。イメージをアップロードする際、そのイメージをすべてのアプリケーションで使用可能にするか、特定のアプリケーションで使用可能にするかを指定できます。

内容は次のとおりです。

- イメージのアップロード

- イメージの参照

- イメージ属性の編集

- イメージの削除

ヒント:
イメージ・ファインダを使用して、カレント・アプリケーションに使用可能なイメージを識別できます。「イメージ・ファインダの使用」を参照してください。

イメージのアップロード

イメージ・リポジトリを使用して、イメージをワークスペースにアップロードします。

イメージをワークスペースにアップロードするには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。
「共有コンポーネント」ページが表示されます。

4. 「ファイル」で、「イメージ」を選択します。
イメージ・ページが表示されます。

5. イメージをアップロードするには、「作成」をクリックします。

6. イメージの作成ページで、次の項目を指定します。

1. アプリケーション: 「関連付けられたアプリケーションなし」を選択して、ワークスペース内のすべてのアプリケーションでイメージを使用できるようにするか、特定のアプリケーションIDを選択します。

2. 新しいイメージをアップロード: 「参照」をクリックして、アップロードするファイルを指定します。

3. ノート: イメージについて説明する詳細を入力します。

7. 「アップロード」をクリックします。

イメージの参照

置換文字列#IMAGE_PREFIX#を参照するか、完全修飾されたURLをイメージに含めることで、アプリケーション内のイメージを参照できます。

内容は次のとおりです。

- 仮想イメージ・ディレクトリの接頭辞の確認

- #IMAGE_PREFIX#を使用したイメージの参照

- 完全修飾URLを使用したイメージの参照

仮想イメージ・ディレクトリの接頭辞の確認

アプリケーション・ビルダーのインストール時に、イメージ用の仮想ディレクトリがインストーラによって作成されます。この仮想ディレクトリは、アップロードされたイメージを含むファイル・システム上の実際のパスを指します。デフォルトでは、接頭辞を使用してこの仮想ディレクトリを参照します。

/i/

アプリケーションを最初に作成する際、定義の編集ページでこの接頭辞を検証する必要があります。

アプリケーションのイメージ接頭辞を検証するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「アプリケーション」ホームページで、「共有コンポーネント」をクリックします。

4. 「アプリケーション」リージョンで、「定義の編集」を選択します。

5. 「ユーザー・インタフェース」タブをクリックします。

6. 「イメージ接頭辞」フィールドを探します。
デフォルトでは、この属性は/i/と定義されています。ご使用の環境でのこの仮想ディレクトリの名前については、管理者に問い合せてください。

#IMAGE_PREFIX#を使用したイメージの参照

静的テキスト(ページ・ヘッダー、リージョン・ヘッダー、リージョン・フッターなど)にイメージを埋め込む場合は、置換文字列#IMAGE_PREFIX#を使用してイメージを参照できます。たとえば、イメージgo.gifを参照するには、次の構文を使用します。

<img src="#IMAGE_PREFIX#go.gif">

関連項目:
「組込み置換文字列について」、「IMAGE_PREFIX」、「APP_IMAGES」および「WORKSPACE_IMAGES」

完全修飾URLを使用したイメージの参照

また、完全修飾されたURLを使用してイメージを参照することもできます。次に例を示します。

<img src="http://g-images.amazon.com/images/G/01/associates/navbar2000/logo-no-border(1).gif">

イメージ属性の編集

イメージ属性の編集では、イメージについて説明する注意の追加、または関連付けられたアプリケーションの変更ができます。しかし、実際のイメージは変更できません。イメージを変更するには、イメージを削除して再度アップロードします。

関連項目:
「イメージの削除」および「イメージのアップロード」

イメージ属性を編集するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。
「共有コンポーネント」ページが表示されます。

4. 「ファイル」で、「イメージ」を選択します。
イメージ・ページが表示されます。

5. 検索バーがページの上部に表示されます。使用可能なコントロールは次のとおりです。

- 検索列の選択: 虫めがねに似ています。このアイコンをクリックして、検索を絞り込みます。すべての列を検索するには、「すべての列」を選択します。

- テキスト領域: 名前を検索するための大/小文字を区別しない検索基準(ワイルドカード文字は暗黙的に定義される)を入力し、「実行」をクリックします。

- 「実行」ボタン: 検索を実行したり、フィルタを適用します。

- アイコンの表示: 各イメージを大きいアイコンとして表示します。イメージを編集するには、該当するアイコンをクリックします。

- レポートの表示: 各イメージをレポート内の1行として表示します。イメージを編集するには、名前をクリックします。

- 「アクション」メニュー: 「アクション」メニューを使用して、レポート・ビューをカスタマイズします。「「アクション」メニューについて」を参照してください。

6. イメージを選択します。
イメージ属性の編集ページが表示されます。

7. 「アプリケーション」から、イメージの可用性を指定します。
「関連付けられたアプリケーションなし」を選択して、ワークスペース内のすべてのアプリケーションでイメージを使用できるようにするか、特定のアプリケーションIDを選択します。

8. ノートで、イメージについて説明する詳細を入力します。

9. 「変更の適用」をクリックします。

イメージの削除

イメージを削除するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。
「共有コンポーネント」ページが表示されます。

4. 「ファイル」で、「イメージ」を選択します。
イメージ・ページが表示されます。

5. 検索バーがページの上部に表示されます。使用可能なコントロールは次のとおりです。

- 検索列の選択: 虫めがねに似ています。このアイコンをクリックして、検索を絞り込みます。すべての列を検索するには、「すべての列」を選択します。

- テキスト領域: 名前を検索するための大/小文字を区別しない検索基準(ワイルドカード文字は暗黙的に定義される)を入力し、「実行」をクリックします。

- 「実行」ボタン: 検索を実行したり、フィルタを適用します。

- アイコンの表示: 各イメージを大きいアイコンとして表示します。イメージを編集するには、該当するアイコンをクリックします。

- レポートの表示: 各イメージをレポート内の1行として表示します。イメージを編集するには、名前をクリックします。

- 「アクション」メニュー: 「アクション」メニューを使用して、レポート・ビューをカスタマイズします。「「アクション」メニューについて」を参照してください。

6. イメージを選択します。

7. 「削除」をクリックします。

静的ファイルの管理

静的ファイル・リポジトリを使用して、静的ファイルをワークスペースにアップロードできます。

内容は次のとおりです。

- 静的ファイルのアップロード

- アップロードしたファイルの編集

- アップロードしたファイルのダウンロード

- アップロードしたファイルの削除

静的ファイルのアップロード

静的ファイルをアップロードするには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。
「共有コンポーネント」ページが表示されます。

4. 「ファイル」で、「静的ファイル」を選択します。
静的ファイル・ページが表示されます。

5. 検索バーがページの上部に表示されます。使用可能なコントロールは次のとおりです。

- 検索列の選択: 虫めがねに似ています。このアイコンをクリックして、検索を絞り込みます。すべての列を検索するには、「すべての列」を選択します。

- テキスト領域: 名前を検索するための大/小文字を区別しない検索基準(ワイルドカード文字は暗黙的に定義される)を入力し、「実行」をクリックします。

- 「実行」ボタン: 検索を実行したり、フィルタを適用します。

- アイコンの表示: 各ファイルを大きいアイコンとして表示します。ファイルを編集するには、該当するアイコンをクリックします。

- レポートの表示: 各ファイルをレポート内の1行として表示します。ファイルを編集するには、名前をクリックします。

- 「アクション」メニュー: 「アクション」メニューを使用して、レポート・ビューをカスタマイズします。「「アクション」メニューについて」を参照してください。

6. ファイルをアップロードするには、「作成」をクリックします。

7. 画面に表示されるステップに従います。

アップロードしたファイルの編集

30,000バイト未満の静的ファイルは、ファイル名を選択して編集できます。それ以外の場合は、ファイルをオフラインで編集し、再度アップロードする必要があります。

30,000バイト未満の静的ファイルを編集するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。
「共有コンポーネント」ページが表示されます。

4. 「ファイル」で、「静的ファイル」を選択します。
静的ファイル・ページが表示されます。

5. 検索バーがページの上部に表示されます。使用可能なコントロールは次のとおりです。

- 検索列の選択: 虫めがねに似ています。このアイコンをクリックして、検索を絞り込みます。すべての列を検索するには、「すべての列」を選択します。

- テキスト領域: 名前を検索するための大/小文字を区別しない検索基準(ワイルドカード文字は暗黙的に定義される)を入力し、「実行」をクリックします。

- 「実行」ボタン: 検索を実行したり、フィルタを適用します。

- アイコンの表示: 各ファイルを大きいアイコンとして表示します。ファイルを編集するには、該当するアイコンをクリックします。

- レポートの表示: 各ファイルがレポート内の1行として表示されます。ファイルを編集するには、名前をクリックします。

- 「アクション」メニュー: 「アクション」メニューを使用して、レポート・ビューをカスタマイズします。「「アクション」メニューについて」を参照してください。

6. ファイルを選択します。

7. ファイルが30,000バイトより小さい場合、ファイルを編集します。

8. 「注意」で、ファイルの説明のテキストを編集または入力します。

9. 「変更の適用」をクリックします。

アップロードしたファイルのダウンロード

アップロードしたファイルをダウンロードするには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。
「共有コンポーネント」ページが表示されます。

4. 「ファイル」で、「静的ファイル」を選択します。
静的ファイル・リポジトリが表示されます。

5. 「レポートの表示」をクリックします。
レポートが表示されます。

6. 該当するファイルの横にある「ダウンロード」アイコンを選択します。

関連項目:
「静的ファイルのアップロード」、「アップロードしたファイルの編集」および「アップロードしたファイルの削除」

アップロードしたファイルの削除

アップロードした静的ファイルを削除するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。
「共有コンポーネント」ページが表示されます。

4. 「ファイル」で、「静的ファイル」を選択します。
静的ファイル・リポジトリが表示されます。

5. 検索バーがページの上部に表示されます。使用可能なコントロールは次のとおりです。

- 検索列の選択: 虫めがねに似ています。このアイコンをクリックして、検索を絞り込みます。すべての列を検索するには、「すべての列」を選択します。

- テキスト領域: 名前を検索するための大/小文字を区別しない検索基準(ワイルドカード文字は暗黙的に定義される)を入力し、「実行」をクリックします。

- 「実行」ボタン: 検索を実行したり、フィルタを適用します。

- アイコンの表示: 各ファイルを大きいアイコンとして表示します。ファイルを編集するには、該当するアイコンをクリックします。

- レポートの表示: 各ファイルがレポート内の1行として表示されます。ファイルを編集するには、名前をクリックします。

- 「アクション」メニュー: 「アクション」メニューを使用して、レポート・ビューをカスタマイズします。「「アクション」メニューについて」を参照してください。

6. ファイルを選択します。

7. 「削除」をクリックします。

カスタムPL/SQLを使用したHTMLのレンダリング

Oracle Application Expressのフォーム、レポートおよびチャートによって処理されない特定のHTMLコンテンツを生成する必要がある場合、PL/SQLタイプのリージョンを使用できます。このタイプのリージョンにHTMLを生成するには、PL/SQL Webツールキットを使用する必要があります。バインド変数構文を使用して、セッション・ステートを参照できます。この方法でHTMLを生成する場合、テンプレートの場合と同じ一貫性および制御は得られないことに注意してください。

関連項目:

- PL/SQLを使用したWebアプリケーションの開発の詳細は、Oracle Databaseアドバンスト・アプリケーション開発者ガイドを参照してください。

- htpパッケージの詳細は、Oracle Database PL/SQLパッケージおよびタイプ・リファレンスを参照してください。

リージョン内に生成されるHTMLをより動的に制御するには、PL/SQLを使用できます。たとえば、現在の日付を出力するには、次のソースを持つリージョンを作成できます。

htp.p(TO_CHAR(SYSDATE,'Day Month DD, YYYY'));

次の例では、表にアクセスします。

DECLARE
l_max_sal NUMBER;
BEGIN
SELECT max(sal) INTO l_max_sal FROM emp;
htp.p('The maximum salary is: '||TO_CHAR(l_max_sal,'999,999.00'));
END;

13 テーマおよびテンプレートの管理

ここでは、テーマおよびテンプレートを使用して、データベース・アプリケーションのユーザー・インタフェースおよびページ・レイアウトを変更する様々な方法について説明します。

内容は次のとおりです。

- テーマの管理

- テンプレートのカスタマイズ

- カスタム・カスケード・スタイルシートの使用

関連項目:
「ナビゲーションの追加」

テーマの管理

テーマは、アプリケーション全体のレイアウトおよびスタイルの定義に使用できるテンプレートのコレクションです。テーマにはテンプレートの完全なセットが用意され、アプリケーションに必要となる可能性があるすべてのUIパターンが提供されます。テンプレートは、最初にタイプで、次にテンプレート・クラスで編成されています。テンプレート・タイプには、ブレッドクラム、ボタン、カレンダ、ラベル、リスト、ページ、ポップアップLOV、リージョンおよびレポートがあります。テンプレート・クラスは、特定のタイプの各テンプレートの目的を示します。各テンプレート・タイプには、標準クラスのグループおよび8つのカスタム・クラスが用意されています。このような分類によって、Oracle Application Expressではテーマ間でのテンプレートのマッピングが可能になり、アプリケーション全体のルック・アンド・フィールを簡単に変更できます。

Oracle Application Expressには、広範なテーマ・リポジトリが同梱されています。次のように、テーマをテーマ・リポジトリに追加できます。

- ワークスペース管理者はワークスペース・テーマを作成できます。ワークスペース・テーマはワークスペース内のすべての開発者が使用できます。「ワークスペース・テーマの管理」を参照してください。

- インスタンス管理者はパブリック・テーマを作成できます。Application Express管理サービスを使用して、パブリック・テーマを追加します。追加すると、これらのテーマはすべてのワークスペースですべての開発者が使用できます。詳細は、『Oracle Application Express管理ガイド』のパブリック・テーマの管理に関する説明を参照してください。

内容は次のとおりです。

- テーマ・ページへのアクセス

- テーマの編集

- テーマの作成

- アクティブなテーマの切替え

- テーマのコピー

- テーマの削除

- ワークスペース・テーマの管理

- テーマのエクスポートおよびインポートについて

- テーマ識別番号の変更

- テーマ・レポートの表示

関連項目:
「テンプレートのカスタマイズ」

テーマ・ページへのアクセス

テーマ・ページでテーマを管理します。共有コンポーネント・ページまたは「ページ定義」からテーマ・ページにアクセスできます。

ヒント:
テーマに選択したデフォルトのテンプレートを、テーマの作成/編集ページで変更できます。「テーマの編集」を参照してください。

テーマ・ページにアクセスするには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「ユーザー・インタフェース」で、「テーマ」を選択します。
テーマ・ページが表示されます。「カレント」列のチェック・マークはどのテーマが選択されているかを示します。

5. テーマ名をクリックします。
テーマの作成/編集ページが表示されます。

テーマの編集

標準テーマには、すべてのタイプのアプリケーション・コンポーネントおよびリージョン・タイプのテンプレートが含まれます。テーマの編集では、テーマ名の変更、コンポーネントおよびリージョンのデフォルトのテンプレートの編集、ページ遷移の変更、日付ピッカー・アイテムに対して表示されるアイコンの変更、およびカスタム・イメージがサポートされるかどうかの指定を行うことができます。この後の項では、テーマの作成および編集ページの各セクションについて説明します。

テーマを確認または編集するには、次のステップを実行します。

1. テーマ・ページにナビゲートします。「テーマ・ページへのアクセス」を参照してください。

2. テーマ名をクリックします。
テーマの作成/編集ページが表示されます。

テーマの作成/編集ページはいくつかのセクションに分かれています。これらのセクションにアクセスするには、ページをスクロールするか、ページ上部のナビゲーション・ボタンをクリックします。ページ上部のボタンを選択すると、選択されたセクションが表示され、その他のセクションはすべて一時的に非表示になります。ページのすべてのセクションを表示するには、「すべて表示」をクリックします。

アプリケーションIDおよびテーマ識別番号は、ページの上部に表示されます。

3. テーマ名を変更するには、「名前」フィールドに名前を入力します。

4. コンポーネントのデフォルトのテンプレートを変更するには、「コンポーネントのデフォルト値」までスクロールします。該当するリストから選択します。
表13-1に、 「コンポーネントのデフォルト値」で使用可能なデフォルトのテンプレートを示します。

表13-1 コンポーネントのデフォルトのテンプレート

属性

説明

ページ

ページを表示するためのデフォルトのテンプレートを指定します。開発者が明示的にテンプレートを選択しない場合、Application Expressエンジンは、ここで指定されたテンプレートを使用します。

関連項目: ページ属性ページでのページ・テンプレートの上書きについては、「表示属性」を参照してください。

エラー・ページ

インライン表示されるエラーではなく、個別のページに表示されるエラーに使用するページ・テンプレートを指定します。エラーを表示するように設計されたテンプレートを使用しない場合、この属性は、空白のままにします。

印刷用ページ

Application Expressエンジンが印刷用モードの場合に使用するテンプレートを指定します。

関連項目: 「印刷用ページの最適化」

ブレッドクラム

ブレッドクラムを作成する場合に使用するデフォルトのブレッドクラム・テンプレートを指定します。

ボタン

ボタンを作成する場合に使用するデフォルトのボタン・テンプレートを指定します。

カレンダ

カレンダを作成する場合に使用するデフォルトのカレンダ・テンプレートを指定します。

ラベル

ラベルを作成する場合に使用するデフォルトのラベル・テンプレートを指定します。

リスト

リストを作成する場合に使用するデフォルトのリスト・テンプレートを指定します。

リージョン

リージョンを作成する場合に使用するデフォルトのリージョン・テンプレートを指定します。

レポート

レポートを作成する場合に使用するデフォルトのリージョン・テンプレートを指定します。

ヘッダー・ツールバー

ヘッダー・ツールバーに使用するデフォルトのテンプレートを指定します。

フッター・ツールバー

フッター・ツールバーに使用するデフォルトのテンプレートを指定します。

5. リージョンのデフォルトのテンプレートを変更するには、「リージョンのデフォルト値」までスクロールします。該当するリストから選択します。
表13-2に、「リージョンのデフォルト値」で使用可能なデフォルトのテンプレートを示します。

表 13-2 リージョンのデフォルト値

属性

説明

ブレッドクラム

ブレッドクラムを作成する場合に使用するデフォルトのリージョン・テンプレートです。

チャート

チャートを作成する場合に使用するデフォルトのチャート・テンプレートです。

フォーム

フォームを作成する場合に使用するデフォルトのフォーム・テンプレートです。

リスト

リストを作成する場合に使用するデフォルトのリージョン・テンプレートです。

対話モード・レポート

対話モード・レポートを作成する場合に使用するデフォルトのリージョン・テンプレートです。

レポート

レポートを作成する場合に使用するデフォルトのリージョン・テンプレートです。

表形式フォーム

表形式フォームを作成する場合に使用するデフォルトのリージョン・テンプレートです。

ウィザード

新しいウィザード・コンポーネントを作成する場合に使用するデフォルトのリージョン・テンプレートです。

対話モード・レポート

対話モード・レポートを作成する場合に使用するデフォルトのリージョン・テンプレートです。

6. 「カレンダ・アイコンの詳細」で、次の項目を指定します。

1. アイコン名: 次に示すように、日付ピッカー・タイプのアイテムが表示されるときに使用するイメージの名前および位置を指定します。

/i/new_cal.bmp

2. アイコン名: 次に示すように、カレンダ・アイコンのイメージ属性を指定します。

width="16" height="16" alt="Display Calendar"

7. 「カスタム・イメージ」で、デフォルトのテーマ・イメージを使用するかカスタム・テーマ・イメージのサポートを有効にするかを指定します。「はい」または「いいえ」を選択します。

8. 「変更の適用」をクリックします。

テーマの作成

テーマを作成すると、テーマ・ページに表示されます。新しく作成するか、またはリポジトリから既存のテーマを選択することによって、テーマを作成できます。

テーマを作成するには、次のステップを実行します。

1. テーマ・ページにナビゲートします。「テーマ・ページへのアクセス」を参照してください。

2. 「作成」をクリックします。

3. 次のいずれかの作成方法を選択します。

- リポジトリから: リポジトリからテーマを表示および選択します。

- 最初から: テーマを最初から作成します。

- エクスポートから: エクスポート・リポジトリからインポートするテーマを作成します。

4. 画面に表示されるステップに従います。

5. 特定のフィールドの詳細を表示するには、フィールド・ラベルをクリックします。
ヘルプが使用可能な場合は、アイテムにカーソルをあわせると、カーソルが疑問符付きの矢印に変わります。「フィールドレベル・ヘルプについて」を参照してください。

関連項目:
「テーマの編集」

テーマ・ページについて

テーマを作成すると、テーマ・ページに表示されます。ページの外観は、ページ上部にある検索バーを使用して変更できます。使用可能なコントロールは次のとおりです。

- 検索列の選択: 虫めがねに似ています。このアイコンをクリックして、検索を絞り込みます。すべての列を検索するには、「すべての列」を選択します。

- テキスト領域: 名前で検索するための大/小文字を区別しない検索基準(ワイルドカード文字は暗黙的に定義される)を入力し、「実行」をクリックします。

- 「実行」ボタン: 検索を実行したり、フィルタを適用します。

- アイコンの表示: 各テーマを大きいアイコンとして表示します。テーマを編集するには、アイコンをクリックします。

- レポートの表示: 各テーマをレポート内の1行として表示します。テーマを編集するには、名前をクリックします。

- 「アクション」メニュー: 「アクション」メニューを使用して、レポート・ビューをカスタマイズします。「「アクション」メニューについて」を参照してください。

アクティブなテーマの切替え

テーマに切り替えると、テンプレートに割り当てられたすべてのコンポーネントは、テーマの対応するテンプレートに割り当てられます。アプリケーション・ビルダーは、テンプレート・クラス識別子の割当てによってテンプレート・マッピングを行います。

アクティブなテーマを切り替える際は、次の点に注意してください

- テーマが存在する場合にのみ、そのテーマに切り替えることができます。たとえば、リポジトリで使用可能なテーマに切り替える前に、最初にテーマを作成する必要があります。「テーマの作成」を参照してください。

- ウィザードで複数の一致が見つかった場合(つまり、複数のテンプレートで同じテンプレート・タイプおよびテンプレート・クラスが共有されている場合)、デフォルトはタイプ、クラスおよび名前が一致するテンプレートです。一致するものがない場合は、同じタイプおよびクラスの別のテンプレートを選択する必要があります。

- 一致するテンプレートが見つからない場合(つまり、同じタイプおよびクラスのテンプレートが存在しない場合)、同じタイプだが異なるクラスのテンプレートの選択を求めるプロンプトが表示されます。次に、この問題がページ機能の問題またはページの表示の問題につながる可能性があることを説明する警告が表示されます。同じテンプレート・タイプのテンプレートが存在しない場合は、テーマを切り替えることはできません。テーマの切替えはブロックされます。

アクティブなテーマを切り替えるには、次のステップを実行します。

1. テーマ・ページにナビゲートします。「テーマ・ページへのアクセス」を参照してください。

2. 「テーマの切替え」をクリックします。
テーマの切替えページが表示されます。

ヒント:
インストール済のテーマが2つ以上存在しない場合は、「テーマの作成」をクリックします。テーマを最初から作成するか、単にリポジトリから既存のテーマを選択できます。「テーマの作成」を参照してください。

3. 「テーマの指定」で、次の項目を指定します。

1. 現在アクティブなテーマ: アプリケーションの現在のテーマを選択します。

2. 次のテーマに切替え: アプリケーションの新しいテーマを選択します。

3. 「次へ」をクリックします。

4. 「ステータス」列を確認し、マッピング上の問題を特定します。

- チェック: マッピングが成功したことを示します。

- 警告: 切替え先のテーマに、指定されたクラスを持つ複数のテンプレートがあることを示します。この警告では、適切なテンプレートを選択するための選択リストが提供されます。

- エラー: アプリケーション・ビルダーがテーマ間でクラスをマップできなかったことを示します。クラスが両方のテーマのテンプレートで指定されていることを確認します。

注意:
警告を解決できないと、機能が失われ、アプリケーションが適切に表示されなくなる場合があります。

5. 「次へ」をクリックして続行します。

6. 「テーマの切替え」をクリックします。

新しいテーマでの以前のアプリケーションの更新

Oracle Application Expressには、様々なテーマが付属しています。これらのテーマの多くは更新され、新しい現代的なスタイルが採用されています。

以前のOracle Application Expressリリースからアプリケーションをインポートまたはアップグレードしても、アプリケーションの外観は変更されません。新しいテーマを取得するためには、次の操作を実行する必要があります。

1. 別のテーマに切り替えます。「アクティブなテーマの切替え」を参照してください。

2. リポジトリから使用するテーマを再作成します。「テーマの作成」。

3. その新しいテーマに切り替えます。「アクティブなテーマの切替え」

テーマのコピー

すべてのテーマは、数値による識別番号(ID)で識別されます。テーマをコピーする場合は、テーマIDを指定します。テーマのコピーは、テーマの編集を試行したり、テーマに異なるIDを付けてエクスポートする場合に便利です。

テーマをコピーするには、次のステップを実行します。

1. テーマ・ページにナビゲートします。「テーマ・ページへのアクセス」を参照してください。

2. 「タスク」リストで、「テーマのコピー」をクリックします。

3. 「テーマのコピー」で、次の操作を実行します。

1. 次のテーマからコピー: コピーするテーマを選択します。

2. このテーマ識別番号にコピー: そのテーマの新しいIDを入力します。

3. 「次へ」をクリックします。

4. 「テーマのコピー」をクリックします。

テーマの削除

アクティブではないテーマのみ削除できます。テーマを削除すると、アプリケーション・ビルダーによって、アクティブではないテンプレートのみ削除されます。

ヒント:
テーマはアプリケーションに関連付けられています。テーマを変更した場合、その変更は編集中のアプリケーションにのみ適用されます。テーマを削除した場合、テンプレートの変更はすべて失われます。テンプレートの変更を維持するには、テーマをエクスポートする必要があります。「テーマのエクスポート」を参照してください。

テーマを削除するには、次のステップを実行します。

1. テーマ・ページにナビゲートします。「テーマ・ページへのアクセス」を参照してください。

2. 「タスク」リストで、「テーマの削除」をクリックします。

3. 「テーマの削除」で、削除するテーマを選択し、「次へ」をクリックします。

4. 「テーマの削除」をクリックします。

ワークスペース・テーマの管理

ワークスペース管理者は、ワークスペースのテーマ・リポジトリを管理します。ワークスペース管理者は、リポジトリにテーマを追加してワークスペース内のすべての開発者がそのテーマを使用できるようにしたり、テーマを削除することができます。

内容は次のとおりです。

- テーマ・リポジトリへのテーマの追加

- ワークスペース・テーマの変更

- ワークスペース・テーマの削除

- ワークスペース・テーマの変更

- ワークスペース・テーマのエクスポートについて

関連項目:
『Oracle Application Express管理ガイド』のパブリック・テーマの管理に関する説明

テーマ・リポジトリへのテーマの追加

テーマをテーマ・リポジトリに追加するには、次のステップを実行します。

1. テーマ・ページにナビゲートします。「テーマ・ページへのアクセス」を参照してください。

2. 「タスク」リストから「ワークスペース・テーマの管理」をクリックします。

3. 「作成」を選択し、「次へ」をクリックします。

4. 「コピーするアプリケーション・テーマ」では、必要なテーマを選択して「次へ」をクリックします。

5. 「名前の指定」では、テーマ番号、名前およびオプションで説明を入力し、「次へ」をクリックします。

6. 「ワークスペース・テーマの作成」をクリックします。

既存のワークスペース・テーマの表示

既存のワークスペース・テーマを表示するには、次のステップを実行します。

1. テーマ・ページにナビゲートします。「テーマ・ページへのアクセス」を参照してください。

2. 「タスク」リストから「ワークスペース・テーマの管理」をクリックします。

3. 「既存の表示」をクリックし、「次へ」をクリックします。
ワークスペース・テーマ・ページが表示されます。

ヒント:
ワークスペース・テーマを直接編集することはできません。ワークスペース・テーマを変更するには、そのテーマを使用してアプリケーションを作成し、変更し、ワークスペース・テーマ・リポジトリに手動で追加する必要があります。「ワークスペース・テーマの変更」を参照してください。

ワークスペース・テーマの削除

ワークスペース・テーマを削除するには、次のステップを実行します。

1. テーマ・ページにナビゲートします。「テーマ・ページへのアクセス」を参照してください。

2. 「タスク」リストから「ワークスペース・テーマの管理」をクリックします。

3. 「削除」をクリックし、「次へ」をクリックします。

4. 削除するワークスペース・テーマを選択し、「テーマの削除」をクリックします。

ワークスペース・テーマの変更

ワークスペース・テーマを直接編集することはできません。ワークスペース・テーマを変更するには、そのテーマを使用してアプリケーションを作成し、変更し、ワークスペース・テーマ・リポジトリに手動で追加する必要があります。

ワークスペース・テーマを変更するには、次のステップを実行します。

1. 変更するテーマを使用して、アプリケーションを作成します。「データベース・アプリケーションの作成について」。

2. テーマを変更します。「テーマの編集」を参照してください。

3. 既存のワークスペース・テーマを削除します。「ワークスペース・テーマの削除」を参照してください。

4. 変更したテーマをワークスペース・テーマ・リポジトリに追加します。「テーマ・リポジトリへのテーマの追加」を参照してください。

ワークスペース・テーマのエクスポートについて

テーマのエクスポートは、関連するアプリケーション・ファイルのエクスポートと同様の方法で行います。ワークスペース・テーマをエクスポートするには、次のステップを実行します。

1. テーマを使用して、アプリケーションを作成します。「データベース・アプリケーションの作成について」。

2. アプリケーションをエクスポートします。「アプリケーションのエクスポート」を参照してください。

3. エクスポートされたファイルをターゲットのOracle Application Expressインスタンスにインポートします。「アプリケーション、ページまたはコンポーネントのエクスポートのインポート」を参照してください。

4. エクスポートされたファイルをエクスポート・リポジトリからインストールします。「エクスポート・ファイルのインストール」を参照してください。

テーマのエクスポートおよびインポートについて

テーマのエクスポートは、関連するアプリケーション・ファイルのエクスポートと同様の方法で行います。1つの開発インスタンスから別のインスタンスへテーマをエクスポートするには、次のステップを実行します。

1. テーマを使用して、アプリケーションを作成します。「データベース・アプリケーションの作成について」。

2. 「テーマのエクスポート」ユーティリティを使用してテーマをエクスポートします。「テーマのエクスポート」を参照してください。

3. エクスポートされたファイルをターゲットのOracle Application Expressインスタンスにインポートします。「エクスポート・ファイルのインポート」を参照してください。

4. エクスポートされたファイルをエクスポート・リポジトリからインストールします。「エクスポート・ファイルのインストール」を参照してください。

テーマ識別番号の変更

すべてのテーマには、識別番号(ID)があります。テーマIDの変更ユーティリティを使用して、テーマIDを別の識別番号に変更できます。テーマIDの変更は、テーマに異なる番号を付けてエクスポートし、別のアプリケーションにインポートする場合に便利です。

テーマ識別番号を変更するには、次のステップを実行します。

1. テーマ・ページにナビゲートします。「テーマ・ページへのアクセス」を参照してください。

2. 「タスク」リストで、「指定番号の変更」をクリックします。

3. テーマ番号の場合は、次のステップを実行します。

1. テーマの指定: テーマを選択します。

2. このテーマ指定番号に変更: 識別番号を指定します。

3. 「次へ」をクリックします。

4. 変更内容を確認して、「テーマIDの変更」をクリックします。

テーマ・レポートの表示

アプリケーション・ビルダーには、テーマおよびテンプレートの管理に役立つ多くのレポートが含まれています。

内容は次のとおりです。

- テーマのすべてのテンプレートの表示

- テーマ・テンプレート数の表示

- ファイル参照の表示

- クラス参照の表示

- テンプレートの置換文字列の表示

テーマのすべてのテンプレートの表示

テーマを構成しているすべてのテンプレートを表示するには、次のステップを実行します。

1. テーマ・ページにナビゲートします。「テーマ・ページへのアクセス」を参照してください。

2. 「レポート」をクリックします。

3. テーマ・レポート・ページで、次のステップを実行します。

1. 「レポート」から「アプリケーション・テンプレート」を選択します。

2. 「テーマ」からテーマを選択します。

3. 「実行」をクリックします。

テンプレートのリストには、テンプレート・タイプ、テンプレート名、対応するテーマおよびテンプレート・クラスの一覧が表示されます。

4. テンプレートを編集するには、テンプレート名を選択します。

テーマ・テンプレート数の表示

「テーマ・テンプレート数」レポートには、現在、テンプレート・クラス用に作成されたテンプレートがあるテンプレート・クラスが表示されます。

テーマ・テンプレート数レポートを表示するには、次のステップを実行します。

1. テーマ・ページにナビゲートします。「テーマ・ページへのアクセス」を参照してください。

2. 「レポート」をクリックします。

3. テーマ・レポート・ページで、次のステップを実行します。

1. 「レポート」から「テーマ・テンプレート数」を選択します。

2. 「テーマ」からテーマを選択します。

3. 「実行」をクリックします。

4. カスタムの分類を使用する場合は、「カスタムの表示」を選択し、「実行」をクリックします。

ファイル参照の表示

ファイル参照のレポートには、テンプレートに関連付けられたすべてのファイル、共有コンポーネント、カレント・アプリケーションのページ・コンポーネントの一覧が表示されます。

「ファイル参照」のレポートを表示するには、次のステップを実行します。

1. テーマ・ページにナビゲートします。「テーマ・ページへのアクセス」を参照してください。

2. テーマ・ページで「レポート」をクリックします。

3. テーマ・レポート・ページで、次のステップを実行します。

1. 「レポート」から「ファイル参照」を選択します。

2. 「テーマ」からテーマを選択します。

3. 「実行」をクリックします。

4. 「ファイル参照」ページで、次のステップを実行します。

1. 「表示」から、レポートに含めるコンポーネントのタイプを選択します。選択しない場合は、結果が戻されません。

2. 「ファイルの表示」から次のいずれかの項目を選択します。

- コンテキスト付き: コンポーネント、テーマ識別番号、コンポーネント名、イメージ(使用可能な場合)、およびページ番号を表示します。「ページ定義」にリンクするには、ページ番号を選択します。

- コンテキストなし: ファイル名およびイメージ(使用可能な場合)のみ表示します。

3. 「ファイル拡張子」から検索する拡張子のタイプを選択します。

4. 「実行」をクリックします。

5. このレポートのカンマ区切りファイル(.csv)をダウンロードするには、ページ下部の「ダウンロード」をクリックします。

クラス参照の表示

クラス参照のレポートにアクセスすると、テンプレートに関連付けられたクラス、共有コンポーネント、カレント・アプリケーションのページ・コンポーネントの一覧が表示されます。

クラス参照のレポートを表示するには、次のステップを実行します。

1. テーマ・ページにナビゲートします。「テーマ・ページへのアクセス」を参照してください。

2. 「レポート」をクリックします。

3. テーマ・レポート・ページで、次のステップを実行します。

1. 「レポート」から「クラス参照」を選択します。

2. 「テーマ」からテーマを選択します。

3. 「実行」をクリックします。

4. 「クラス参照」ページで、次のステップを実行します。

1. 「表示」から、クラス参照を確認するコンポーネントを選択します。選択しない場合は、結果が戻されません。

2. 「クラス名の表示」から、次のいずれかを選択します。

- コンテキスト付き: コンポーネント、テーマ識別番号、コンポーネント名、イメージ(使用可能な場合)、およびページ番号を表示します。

- コンテキストなし: 参照されるクラスのみを表示します。

3. 「実行」をクリックします。

5. このレポートのカンマ区切りファイル(.csv)をダウンロードするには、ページ下部の「ダウンロード」をクリックします。

テンプレートの置換文字列の表示

「テンプレート置換文字列」レポートを使用すると、コンポーネントがサポートする置換文字列がすべて表示されます。

「置換文字列」レポートを表示するには、次のステップを実行します。

1. テーマ・ページにナビゲートします。「テーマ・ページへのアクセス」を参照してください。

2. 「レポート」をクリックします。

3. テーマ・レポート・ページで、次のステップを実行します。

1. 「レポート」リストから、「テンプレート置換文字列」を選択します。

2. 「テーマ」リストから、レポートに含めるテーマを選択します。

3. 「実行」をクリックします。

4. テンプレート定義にリンクするには、コンポーネント名を選択します。

関連項目:
「置換文字列の理解」

テンプレートのカスタマイズ

Application Expressエンジンは、テーマと呼ばれるテンプレートのコレクションに基づいて、アプリケーションのユーザー・インタフェースを作成します。テンプレートは、アプリケーション内のコンポーネントのルック・アンド・フィールを制御します。カスタム・テンプレートを作成するには、まず既存のテンプレートを変更する方法が最も簡単です。作成した1つ以上のデフォルト・テンプレートは、必要に応じて変更できます。

内容は次のとおりです。

- カスケード・スタイルシートについて

- デフォルトのページ・テンプレートの選択

- 新しいテンプレートの作成

- テンプレート・レポートの表示

- テンプレートの管理

- ブレッドクラム・テンプレート

- ボタン・テンプレート

- カレンダ・テンプレート

- ラベル・テンプレート

- リスト・テンプレート

- ページ・テンプレート

- ポップアップLOVテンプレート

- リージョン・テンプレート

- レポート・テンプレート

関連項目:
「テーマの管理」

カスケード・スタイルシートについて

カスケード・スタイルシート(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はOracle Application Expressバージョン番号です。テーマ固有のCSSファイルにはOracle Application Expressのバージョン番号が含まれており、以前のバージョンのテーマを使用しているアプリケーションをインポートした場合の下位互換性が維持されるようになっています。

関連項目:
「カスタム・カスケード・スタイルシートの使用」

デフォルトのページ・テンプレートの選択

デフォルトのページ・テンプレートは、2つの方法で指定できます。

- 特定のテーマ内のデフォルトのページ・テンプレートを選択します。

- ページごとに特定のページ・テンプレートを選択します。

デフォルトでは、Application Expressエンジンは、テーマ・ページで指定されたページ・テンプレートを使用します。

内容は次のとおりです。

- テーマ内のページ・レベル・テンプレートの選択

- 特定のページのページ・レベル・テンプレートの選択

テーマ内のページ・レベル・テンプレートの選択

テーマ内のデフォルトのページ・テンプレートを指定するには、次のステップを実行します。

1. テーマ・ページにナビゲートします。「テーマ・ページへのアクセス」を参照してください。

2. テーマ名を選択します。
テーマの作成/編集ページが表示されます。

3. 「コンポーネントのデフォルト値」までスクロールします。「ページ」リストから選択します。

4. ページ上部の「変更の適用」をクリックします。

関連項目:
「テーマの編集」

特定のページのページ・レベル・テンプレートの選択

特定のページにページ・レベル・テンプレートを指定するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. ページを選択します。
「ページ定義」が表示されます。

4. 「ページ定義」の編集ページにアクセスするには、次のステップを実行します。

- ツリー・ビュー: 「ページ・レンダリング」で、ツリーの上部のページ・タイトルをダブルクリックします。

- コンポーネント・ビュー: 「ページ」で、「編集」アイコンをクリックします。

ページ属性ページが表示されます。

5. 「表示属性」セクションを探します。

6. 「ページ・テンプレート」リストから選択します。

7. 「変更の適用」をクリックします。

新しいテンプレートの作成

カスタム・テンプレートを作成するには、まず既存のテンプレートを変更する方法が最も簡単です。作成した1つ以上のデフォルト・テンプレートは、必要に応じて変更できます。

カスタム・テンプレートを作成するには、次のステップを実行します。

1. 「テンプレート」ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「ユーザー・インタフェース」で、「テンプレート」を選択します。

2. 「作成」をクリックします。

3. 作成するテンプレートのタイプを選択し、「次へ」をクリックします。

4. 次のいずれかの作成方法を選択します。

- 最初から

- 既存のテンプレートのコピーとして

5. 画面に表示されるステップに従います。

ヒント:
テンプレートが適切なテーマに関連付けられていることを確認します。

テンプレート・レポートの表示

アプリケーション・ビルダーには、テンプレートの使用状況、サブスクリプション、パブリッシュされたテンプレートおよび編集履歴を示すレポートがあります。

カレント・アプリケーションについてのテンプレート・レポートを表示するには、次のステップを実行します。

1. 「テンプレート」ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「ユーザー・インタフェース」で、「テンプレート」を選択します。

2. 次のリストから選択し、「実行」をクリックして、表示を絞り込むことができます。

- テンプレート名: 大/小文字を区別しない問合せを入力します。

- テーマ: 特定のテーマのテンプレートのみを表示します。

- 参照: 表示するテンプレートのタイプを選択します。オプションは次のとおりです。

- すべてのテンプレート

- 参照されるテンプレート

- 参照されていないテンプレート

- タイプ: テンプレート・タイプを選択します。

- 期間: レポートを特定の時間枠に制限します。レポートに含める時間を選択します。

- サブスクライブ: すべてのテンプレート、サブクライブされたテンプレートまたはサブスクライブされていないテンプレートを表示するかどうかを指定します。

3. テンプレート・レポートを表示するには、次のタブをクリックします。

- サブスクリプション: アプリケーションでサブスクライブされたテンプレートを表示します。

- 使用状況: カレント・アプリケーションのすべてのテンプレート・タイプ(ページ、レポート、リージョン、レベルおよびリスト)についてテンプレートの使用状況を表示します。

- 履歴: 開発者によるテンプレートへの最近の変更および最終更新日を表示します。

テンプレートの管理

テンプレート・ページで、すべての使用可能なテンプレートを表示できます。また、「ページ定義」で、特定のページに関連付けられているテンプレートにアクセスできます。

内容は次のとおりです。

- テンプレート・ページでのテンプレートの表示

- 特定のページに関連付けられているテンプレートの表示

- テンプレートの置換

- アプリケーション内のすべてのテンプレートの置換

- ページ・テンプレート別のリージョン位置の使用状況の表示

- テンプレートのサブスクライブ解除

- テンプレートのパブリッシュ

関連項目:
「テーマのすべてのテンプレートの表示」

テンプレート・ページでのテンプレートの表示

既存のテンプレートを表示するには、次のステップを実行します。

1. 「テンプレート」ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「ユーザー・インタフェース」で、「テンプレート」を選択します。
テンプレート・ページが表示されます。

2. 次のリストから選択し、「実行」をクリックして、表示を絞り込むことができます。

- テンプレート名: 大/小文字を区別しない問合せを入力します。

- テーマ: 特定のテーマのテンプレートのみを表示します。

- 参照: 表示するテンプレートのタイプを選択します。

- タイプ: テンプレート・タイプを選択します。

- 期間: レポートを特定の時間枠に制限します。レポートに含める時間を選択します。

- サブスクライブ: すべてのテンプレート、サブクライブされたテンプレートまたはサブスクライブされていないテンプレートを表示するかどうかを指定します。

3. テンプレートのプレビューを確認するには、「プレビュー」列で「実行」アイコンをクリックします。
一部のテンプレート・タイプには、プレビュー機能はありません。

4. テンプレート定義を表示または編集するには、テンプレート名をクリックします。
テンプレート定義が表示されます。

各テンプレート定義は複数のセクションに分かれています。これらのセクションにアクセスするには、手動でスクロールするか、ページ上部のナビゲーション・ボタンをクリックします。ページ上部のボタンを選択すると、選択されたセクションが表示され、その他のセクションはすべて一時的に非表示になります。ページのすべてのセクションを表示するには、「すべて表示」をクリックします。

5. 対象となる属性を編集します。
テンプレートを編集する場合、1つのウィンドウで変更を行い、テンプレート定義ページの右側で「ページに戻る」チェック・ボックスを選択することで、別のウィンドウでアプリケーションを実行できます。このチェック・ボックスを選択すると、「変更の適用」をクリックした後、現在編集中のページが維持されます。

6. 「変更の適用」をクリックします。

特定のページに関連付けられているテンプレートの表示

特定のページに関連付けられているテンプレートを表示するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. ページを選択します。
「ページ定義」が表示されます。右端の列の「テンプレート」ヘッダーの下に、カレント・ページに関連付けられたテンプレートが表示されます。

4. テンプレート定義を表示または編集するには、テンプレート名をクリックします。
テンプレート定義が表示されます。

各テンプレート定義は複数のセクションに分かれています。これらのセクションにアクセスするには、手動でスクロールするか、ページ上部のナビゲーション・ボタンをクリックします。ページ上部のボタンを選択すると、選択されたセクションが表示され、その他のセクションはすべて一時的に非表示になります。ページのすべてのセクションを表示するには、「すべて表示」をクリックします。

5. 対象となる属性を編集します。
テンプレートを編集する場合、1つのウィンドウで変更を行い、テンプレート定義ページの右側で「ページに戻る」チェック・ボックスを選択することで、別のウィンドウでアプリケーションを実行できます。このチェック・ボックスを選択すると、「変更の適用」をクリックした後、現在編集中のページが維持されます。

6. 「変更の適用」をクリックします。

テンプレートの置換

テンプレートの置換ウィザードを使用してコンポーネントに関連付けられているテンプレートを更新できます。

コンポーネントに関連付けられているテンプレートを置換するには、次のステップを実行します。

1. 「テンプレート」ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「ユーザー・インタフェース」で、「テンプレート」を選択します。
テンプレート・ページが表示されます。

2. 「タスク」リストから「テンプレートの置換」を選択します。

3. 「テンプレート・タイプ」からテンプレートを選択し、「次へ」をクリックします。

4. 「テンプレートの置換」で、次の項目を選択します。

1. 変更前: 変更するテンプレートを選択します。

2. 変更後: 変更後のテンプレートを選択します。

3. 「次へ」をクリックします。

5. 「終了」をクリックします。

アプリケーション内のすべてのテンプレートの置換

アプリケーション内のすべてのテンプレートを別のアプリケーションのテンプレートに置換するには、次のステップを実行します。

1. 「テンプレート」ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「ユーザー・インタフェース」で、「テンプレート」を選択します。
テンプレート・ページが表示されます。

2. 「タスク」リストから「このアプリケーションのテンプレートを別のアプリケーションのテンプレートに置換。」を選択します。

3. 「テンプレートの置換」で、次の項目を指定します。

1. アプリケーションから置換: アプリケーションを選択します。

2. ユーザー・インタフェース: このアプリケーションの開発対象のユーザー・インタフェースのタイプを選択します。

3. 「次へ」をクリックします。

4. 「テンプレートの置換」で、各コンポーネントの新しいテンプレートを選択し、「アクション」で次のいずれかを選択します。

- 置換: テンプレート定義をコピーします。

- 置換/サブスクライブ: テンプレートをコピーしてサブスクリプションを追加します。

5. 「テンプレートの置換」をクリックします。

ページ・テンプレート別のリージョン位置の使用状況の表示

ページ上のリージョンは、位置(表示ポイント)で構成されます。リージョンで使用可能な表示ポイントは、ページ・レベルのテンプレートによって決まります。

ページ・テンプレート別のリージョン位置の使用状況を表示するには、次のステップを実行します。

1. 「テンプレート」ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「ユーザー・インタフェース」で、「テンプレート」を選択します。
テンプレート・ページが表示されます。

2. 「タスク」リストから「ページ・テンプレートのリージョン位置の使用状況の表示」を選択します。
「リージョン表示ポイントの使用状況」レポートが表示されます。

テンプレートのサブスクライブ解除

サブスクライブされるテンプレートとは、定義を別のテンプレートで管理されているテンプレート、つまり参照されるテンプレートです。アプリケーションで、サブスクライブされるテンプレートを使用している場合は、テンプレートのサブスクライブ解除ページでテンプレートのサブスクライブを解除できます。

テンプレートのサブスクライブを解除するには、次のステップを実行します。

1. 「テンプレート」ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「ユーザー・インタフェース」で、「テンプレート」を選択します。
テンプレート・ページが表示されます。

2. 「タスク」リストから「テンプレートのサブスクライブ解除」を選択します。
テンプレートのサブスクライブ解除ページが表示されます。

3. 現行のテーマ内で特定のテンプレート・タイプをサブスクライブ解除するには、テンプレート・タイプを選択し、「サブスクライブ解除」をクリックします。

テンプレートのパブリッシュ

テンプレートのパブリッシュ・ページを使用して、ワークスペースの他のテンプレートによってサブスクライブされるテンプレートを表示します。

マスター・テンプレートの内容を、サブスクライブしているテンプレートにパブリッシュするには、次のステップを実行します。

1. 「テンプレート」ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「ユーザー・インタフェース」で、「テンプレート」を選択します。
テンプレート・ページが表示されます。

2. 「パブリッシュ」タブをクリックします。
テンプレートのパブリッシュ・ページが表示されます。

3. パブリッシュするテンプレートを選択し、「チェックした項目のパブリッシュ」をクリックします。

ブレッドクラム・テンプレート

ブレッドクラム・テンプレートは、ブレッドクラム・エントリの表示方法を制御します。このテンプレートは、リージョンの作成時に選択します。

関連項目:
「テンプレートのカスタマイズ」および「テーマの管理」

ブレッドクラム・スタイルのナビゲーションについて

ブレッドクラムは通常、現在のページが、アプリケーション内の他のページに対してどの位置にあるかを示します。また、ユーザーは特定のページをクリックするだけで、そのページを表示することができます。たとえば、Oracle Application Expressのサンプル・データベース・アプリケーションでは、各ページの上部にブレッドクラム・パスが表示されます。

図bc_menu.gifの説明

関連項目:

- 「ブレッドクラム・テンプレートの編集」ページ固有のセクションを使用する方法については、オンライン・ヘルプを参照してください。

- 「ブレッドクラムの作成」

ブレッドクラム・テンプレート属性

ここでは、ブレッドクラム・テンプレートの編集ページの特定のセクションについて説明します。ページの各セクションにアクセスするには、ページをスクロールするか、ページ上部のナビゲーション・ボタンをクリックします。ページ上部のボタンを選択すると、選択されたセクションが表示され、その他のセクションはすべて一時的に非表示になります。ページのすべてのセクションを表示するには、「すべて表示」をクリックします。

名前

「名前」は、テンプレートの名前を示します。テンプレートに翻訳が必要なテキスト文字列が含まれていることを示すには、「翻訳可能」チェック・ボックスを使用します。「テーマ」は、テンプレートが関連付けられているテーマを示します。

「テンプレート・クラス」は、そのテンプレートに固有の用途を示します。テーマに切り替えると、あるテーマのすべてのテンプレートは、別のテーマの対応するテンプレートにマップされます。アプリケーション・ビルダーは、テンプレート・クラスの割当てによってこのテンプレート・マッピングを行います。

サブスクリプション

「サブスクリプション」を使用して、カレント・アプリケーションに既存のテンプレートを適用します。

「マスター・ブレッドクラム・テンプレートの参照元」を使用して、対象のアプリケーションの既存のテンプレート、またはワークスペースのスキーマの別のテンプレートを選択します。既存のテンプレートを選択すると、ユーザーはそのテンプレートのサブスクライバになります。

マスター・テンプレートのコピーをロードするには、「リフレッシュ」をクリックします。

テンプレート・タイプ

次のいずれかのテンプレート・スタイルを選択します。

- 子ブレッドクラム・エントリ: カレント・ページの親ブレッドクラムの子(現在のブレッドクラムと同等)であるすべてのブレッドクラム・エントリを表示します。

- カレント・ブレッドクラム: 共通の親を持つすべてのブレッドクラム・エントリを順番に表示します。

- 親ブレッドクラム・エントリ: カレント・ページの親ブレッドクラム(現在のブレッドクラム・エントリよりも1階層上のブレッドクラム)のすべてのブラッドクラム・エントリを表示します。

- 親からリーフ(ブレッドクラム・スタイル): カレント・ページのブレッドクラム・エントリと、その左側にルート・ノードまでの親エントリを表示します。

定義

表 13-3に、使用可能なブレッドクラム・エントリの属性を示します。

表 13-3 ブレッドクラム・エントリの制御属性

属性

説明

最初の前

最初のブレッドクラム・エントリの前に表示するテキストを定義します。

カレント・ページのブレッドクラム・エントリ

カレント・ページに対応するブレッドクラム・エントリの外観を定義します。この属性は、次の置換文字列をサポートします。

- #NAME#: ブレッドクラム・エントリの短縮名を指定します。

- #LINK#: ブレッドクラム・エントリのアンカー・ターゲットを指定します。

- #LONG_NAME#: ブレッドクラム・エントリの詳細名を指定します。

次に例を示します。

&lt;li&gt;&lt;a href="#LINK#"&gt;#NAME#&lt;/a&gt;

カレント・ページ以外のブレッドクラム・エントリ

カレント・ページに対応していないブレッドクラム・エントリの外観を定義します。この属性は、次の置換文字列をサポートします。

- #NAME#: ブレッドクラム・エントリの短縮名を指定します。

- #LINK#: ブレッドクラム・エントリのアンカー・ターゲットを指定します。

- #LONG_NAME#: ブレッドクラム・エントリの詳細名を指定します。

次に例を示します。

&lt;li&gt;&lt;a href="#LINK#"&gt;#NAME#&lt;/a&gt;

最後の後

最後のブレッドクラム・エントリの後に表示するテキストを定義します。

レベル間

ブレッドクラム・エントリのレベル間に表示するテキストを定義します。たとえば、ブレッドクラムに3つのレベルがある場合、このテキストは、次の例の「X」の位置に表示されます。

main X cars X porsche X 911

最大レベル

ブレッドクラムをブレッドクラム・スタイルで表示する際に使用するレベル数を指定します。

リンク属性

「ブレッドクラム・リンク属性」を使用して、ブレッドクラム・エントリのハイパーテキスト・リンク属性を指定します。たとえば、ブレッドクラム・エントリのハイパーテキスト・リンクを表示し、HTMLアンカー・タグのXの位置に次のテキストを追加します。

&lt;A HREF="..." X&gt;

コメント

この属性を使用して、このコンポーネントに関するコメントを記録します。

置換文字列

カレント・テンプレートで使用されている置換文字列のリストを表示します。置換文字列は、サブテンプレート内でコンポーネント値を参照するために使用されます。

ボタン・テンプレート

ボタン・テンプレートを使用すると、開発者は、ボタンのルック・アンド・フィールをカスタマイズできます。ボタンを構築する場合、複数のイメージまたはHTMLタグを使用できます。ボタン・テンプレートの使用はオプションです。

関連項目:
「テンプレートのカスタマイズ」および「テーマの管理」

ボタン・テンプレート属性

ここでは、ボタン・テンプレートの編集ページの特定のセクションについて説明します。ページの各セクションにアクセスするには、ページをスクロールするか、ページ上部のナビゲーション・ボタンをクリックします。ページ上部のボタンを選択すると、選択されたセクションが表示され、その他のセクションはすべて一時的に非表示になります。ページのすべてのセクションを表示するには、「すべて表示」をクリックします。

名前

「テンプレート名」は、テンプレートの名前を示します。テンプレートに変換が必要なテキスト文字列が含まれているかどうかを示すには、「翻訳可能」チェック・ボックスを使用します。「テーマ」は、テンプレートが関連付けられているテーマを示します。

「テンプレート・クラス」は、そのテンプレートに固有の用途を示します。テーマに切り替えると、あるテーマのすべてのテンプレートは、別のテーマの対応するテンプレートにマップされます。アプリケーション・ビルダーは、テンプレート・クラスの割当てによってこのテンプレート・マッピングを行います。

サブスクリプション

「サブスクリプション」を使用して、カレント・アプリケーションに既存のテンプレートを適用します。

「マスター・テンプレートの参照元」を使用して、対象のワークスペースの既存のテンプレート、またはワークスペースのスキーマの別のテンプレートを選択します。既存のテンプレートを選択すると、ユーザーはそのテンプレートのサブスクライバになります。

マスター・テンプレートのコピーをロードするには、「リフレッシュ」をクリックします。

定義

「通常のテンプレート」によって、ボタン・タイプが「標準」の場合に表示されるボタン・テンプレートが定義されます。標準のアプリケーション置換文字列を含めることができます。たとえば、&ITEM_NAME値はレンダリング時に置換できます。

「ホット・テンプレート」によって、ボタン・タイプが「ホット」の場合に表示されるボタン・テンプレートが定義されます。標準のアプリケーション置換文字列を含めることもできます。たとえば、&ITEM_NAME値はレンダリング時に置換できます。

ボタン・テンプレートは、次の置換文字列をサポートします。

- #LABEL#: ボタン・ラベルで置換されます。

- #LINK#: ボタンの動作を制御するために生成されたJavaScriptコードで置換されます。ボタンのアクションに応じて、このコードはページを送信するためのapex.submitのコール、ページへのリダイレクト、指定された他のURLへのリダイレクト、一部のカスタムJavaScriptの実行、何も実行しないvoid(0) (動作が動的アクションで個別に定義される場合)のいずれかです。#LINK#では生成されたJavaScriptコードの前にjavascript:が付くため、HREF属性で使用する必要があります。

- #JAVASCRIPT#: ボタンの動作を制御するために生成されたJavaScriptコードで置換されます。ボタンのアクションに応じて、このコードはページを送信するためのapex.submitのコール、ページへのリダイレクト、指定された他のURLへのリダイレクト、一部のカスタムJavaScriptの実行、何も実行しないvoid(0) (動作が動的アクションで個別に定義される場合)のいずれかです。

ヒント:
#JAVASCRIPT#では生成されたJavaScriptコードの前にjavascript:が付かないため、onclick属性で使用する必要があります。

- #BUTTON_ID#: ボタンのIDで置換されます。これは、ボタンの静的ID (定義されている場合)または特定の書式の内部生成IDです。次に例を示します。

'B' || [Internal Button ID]

- #BUTTON_CSS_CLASSES#: ボタン定義内のボタンCSSクラス・プロパティで置換されます。

- #BUTTON_ATTRIBUTES#: ボタン定義内のボタン属性プロパティで置換されます。

置換文字列はすべて大文字にする必要があることに注意してください。

コメント

この属性を使用して、このコンポーネントに関するコメントを記録します。

置換文字列

対象のテンプレートで使用されている置換文字列のリストを表示します。置換文字列は、サブテンプレート内でコンポーネント値を参照するために使用されます。

カレンダ・テンプレート

カレンダ・テンプレートは、カレンダの外観と配置を制御します。このテンプレートは、頻繁にHTML表を使用して日付を配置します。#DD#や#MONTH#などの置換文字列を使用してカレンダ属性を配置します。

関連項目:
「カレンダの作成」、「テンプレートのカスタマイズ」および「テーマの管理」

サポートされるカレンダ・テンプレートの置換文字列について

サポートされている置換文字列のリストは、カレンダ・テンプレートの編集ページの右側に表示されます。テンプレートの置換文字列は大文字で指定し、シャープ記号(#)で囲む必要があることに注意してください。

カレンダ・テンプレート属性

ここでは、カレンダ・テンプレートの編集ページの特定のセクションについて説明します。ページの各セクションにアクセスするには、ページをスクロールするか、ページ上部のナビゲーション・ボタンをクリックします。ページ上部のボタンを選択すると、選択されたセクションが表示され、その他のセクションはすべて一時的に非表示になります。ページのすべてのセクションを表示するには、「すべて表示」をクリックします。

カレンダ定義

名前

「名前」は、テンプレートの名前を示します。テンプレートに変換が必要なテキスト文字列が含まれているかどうかを示すには、「翻訳可能」チェック・ボックスを使用します。「テーマ」は、テンプレートが関連付けられているテーマを示します。

「テンプレート・クラス」は、そのテンプレートに固有の用途を示します。テーマに切り替えると、あるテーマのすべてのテンプレートは、別のテーマの対応するテンプレートにマップされます。アプリケーション・ビルダーは、テンプレート・クラスの割当てによってこのテンプレート・マッピングを行います。

サブスクリプション

「サブスクリプション」を使用して、カレント・アプリケーションに既存のテンプレートを適用します。

「マスター・ラベル・テンプレートの参照元」を使用して、対象のワークスペースの既存のテンプレート、またはワークスペースのスキーマの別のテンプレートを選択します。既存のテンプレートを選択すると、ユーザーはそのテンプレートのサブスクライバになります。

マスター・テンプレートのコピーをロードするには、「リフレッシュ」をクリックします。

コメント

この属性を使用して、このコンポーネントに関するコメントを記録します。

月次カレンダ、週次カレンダ、日次カレンダおよびリスト・カレンダ

「月次カレンダ」、「週次カレンダ」、「日次カレンダ」および「リスト・カレンダ」属性を使用して、特定のカレンダの外観および配置を制御します。

特定の属性の詳細を表示するには、属性ラベルをクリックします。ヘルプが使用可能な場合は、アイテムにカーソルをあわせると、カーソルが疑問符付きの矢印に変わります。「フィールドレベル・ヘルプについて」を参照してください。

ラベル・テンプレート

ラベル・テンプレートは、ページ・アイテム・ラベルのHTMLマークアップを集中管理することを目的としています。各アイテムにはオプションのラベルがあります。ラベル・テンプレートを使用して、これらのラベルの表示方法を制御できます。たとえば、ユーザーに必須であることを示すイメージ(アスタリスクなど)を参照する「必須フィールド」というラベル・テンプレートを作成できます。

ラベル・テンプレートを使用すると、アイテムの先頭と末尾に追加するテキスト文字列を定義できます。

関連項目:
「テンプレートのカスタマイズ」および「テーマの管理」

ラベル・テンプレート属性

ここでは、ラベル・テンプレートの編集ページの特定のセクションについて説明します。ページの各セクションにアクセスするには、ページをスクロールするか、ページ上部のナビゲーション・ボタンをクリックします。ページ上部のボタンを選択すると、選択されたセクションが表示され、その他のセクションはすべて一時的に非表示になります。ページのすべてのセクションを表示するには、「すべて表示」をクリックします。

名前

「テンプレート名」は、テンプレートの名前を示します。テンプレートに翻訳が必要なテキスト文字列が含まれていることを示すには、「翻訳可能」チェック・ボックスを使用します。「テーマ」は、テンプレートが関連付けられているテーマを示します。

「テンプレート・クラス」は、そのテンプレートに固有の用途を示します。テーマに切り替えると、あるテーマのすべてのテンプレートは、別のテーマの対応するテンプレートにマップされます。アプリケーション・ビルダーは、テンプレート・クラスの割当てによってこのテンプレート・マッピングを行います。

サブスクリプション

「テンプレートのサブスクリプション」を使用して、カレント・アプリケーションに既存のテンプレートを適用します。

「マスター・ラベル・テンプレートの参照元」を使用して、対象のワークスペースの既存のテンプレート、またはワークスペースのスキーマの別のテンプレートを選択します。既存のテンプレートを選択すると、ユーザーはそのテンプレートのサブスクライバになります。

マスター・テンプレートのコピーをロードするには、「リフレッシュ」をクリックします。

定義

「ラベルの前」では、アイテム・ラベルの前に表示するHTMLを入力します。「ラベルの前」では、次の置換文字列がサポートされています。

- #CURRENT_FORM_ELEMENT#

- #CURRENT_ITEM_ID#

- #CURRENT_ITEM_NAME#

- #CURRENT_ITEM_HELP_TEXT#

次に例を示します。

<label for="#CURRENT_ITEM_NAME#">
<a href="javascript:popupFieldHelp('#CURRENT_ITEM_ID#',
'&APP_SESSION.','&CLOSE.')" >

この例では、このリージョンのHTMLの後にラベルが自動的に表示されます。したがって、開始タグ<a>を使用した場合、「ラベルの後」リージョンで閉じる必要があります。

「ラベルの後」では、アイテム・ラベルの後に表示するHTMLを入力します。このラベルはこのリージョンのHTMLの前に自動的に表示されるため、「ラベルの前」リージョンの開始タグを閉じる必要があります。次に例を示します。

</a></label>

「ラベルの前」では、アイテム・ラベルの前に表示するHTMLを入力します。この属性は、次の置換文字列をサポートします。

- #CURRENT_FORM_ELEMENT#

- #CURRENT_ITEM_ID#

- #CURRENT_ITEM_NAME#

- #CURRENT_ITEM_HELP_TEXT#

エラー表示

「ラベルの前のエラー発生時」では、アプリケーションがアイテムのインライン検証エラー・メッセージを表示する場合に、そのアイテム・ラベルの前に表示するHTMLを入力します。次に例を示します。

<font class="fieldtitleleft">#ERROR_MESSAGE#

この属性は、次の置換文字列をサポートします。

- #CURRENT_FORM_ELEMENT#

- #CURRENT_ITEM_ID#

- #CURRENT_ITEM_NAME#

- #CURRENT_ITEM_HELP_TEXT#

「ラベルの後のエラー発生時」では、アプリケーションがアイテムのインライン検証エラー・メッセージを表示する場合に、そのアイテム・ラベルの後に表示されるHTMLを入力します。次に例を示します。

&nbsp;]</font>

この属性は、次の置換文字列をサポートします。

- #CURRENT_FORM_ELEMENT#

- #CURRENT_ITEM_ID#

- #CURRENT_ITEM_NAME#

- #CURRENT_ITEM_HELP_TEXT#

フィールド・コンテナ

「「ラベルの前」とアイテム」に、ラベルとアイテムの前に表示するHTMLを入力します。通常、これはアイテムをDIVコンテナまたはフィールド・セットにラップするために使用されます。「「ラベルの前」とアイテム」属性は、フォーム・アイテムの表示に表グリッドを使用しないページにのみレンダリングされます。これには、モバイル・ページ・テンプレートを使用するページが含まれます。

この属性は、次の置換文字列をサポートします。

- #CURRENT_FORM_ELEMENT#

- #CURRENT_ITEM_ID#

- #CURRENT_ITEM_NAME#

- #CURRENT_ITEM_HELP_TEXT#

置換文字列

このテンプレートの置換文字列の用途を一覧します。置換文字列は、サブテンプレート内でコンポーネント値を参照するために使用されます。

コメント

この属性を使用して、このオブジェクトに関するコメントを記録します。

#CURRENT_ITEM_HELP_TEXT#を使用したアイテム・ヘルプの作成

#CURRENT_ITEM_HELP_TEXT#置換文字列を使用すると、ページのレンダリング時にインライン・ページ・アイテム・ヘルプ・テキストを作成できます。たとえば、この置換文字列を使用すると、マウスをページ・アイテム・ラベルに合わせたときにツールチップとして表示されるページ・アイテム・ヘルプ・テキストを作成できます。このプレースホルダによって、コストのかかるAJAXコールを実行せずに、レンダリング時にページにヘルプ・テキストを表示できます。

ヒント:
ヘルプ・テキストが短い場合は、このプレースホルダのみが使用されます。生成されたページには、ヘルプ・テキストを表示するために実際にページ・アイテムのラベルにカーソルを合わせているかどうかに関係なく、すべてのページ・アイテムのヘルプ・テキストが常に表示されます。

ラベル・テンプレートの例

ラベルの前:

<label for="#CURRENT_ITEM_NAME#" class="optional"><span>
class="helpText">#CURRENT_ITEM_HELP_TEXT#</span>

ラベルの後:

</label>

リスト・テンプレート

リストは、リンクの共有コレクションです。リストの外観は、リスト・テンプレートで制御します。テンプレート属性を使用すると、特定のページのカレントまたは非カレントとしてリスト要素を定義できます。

関連項目:
「リストの作成」、「テンプレートのカスタマイズ」および「テーマの管理」

階層リストについて

Oracle Application Expressでは、階層的なリストをサポートしています。階層的なリストを作成するには、次のステップを実行します。

- 階層的なリストをサポートするリスト・テンプレートを選択します。階層的なリストをサポートするリスト・テンプレートを判別するには、サブリスト付きというネーミング規則のあるテンプレートを検索します。

- 各リスト・エントリの作成時には親リスト・エントリを選択します。

関連項目:

- 「リスト・テンプレートの編集」ページ固有のセクションを使用する方法については、オンライン・ヘルプを参照してください。

- 「リストの作成」

リスト・テンプレート属性

ここでは、リスト・テンプレートの編集ページの特定のセクションについて説明します。ページの各セクションにアクセスするには、ページをスクロールするか、ページ上部のナビゲーション・ボタンをクリックします。ページ上部のボタンを選択すると、選択されたセクションが表示され、その他のセクションはすべて一時的に非表示になります。ページのすべてのセクションを表示するには、「すべて表示」をクリックします。

名前

「名前」は、テンプレートの名前を示します。テンプレートに翻訳が必要なテキスト文字列が含まれていることを示すには、「翻訳可能」チェック・ボックスを使用します。「テーマ」は、テンプレートが関連付けられているテーマを示します。

「テンプレート・クラス」は、そのテンプレートに固有の用途を示します。新しいテーマに切り替えると、あるテーマのすべてのテンプレートは、別のテーマの対応するテンプレートにマップされます。アプリケーション・ビルダーは、テンプレート・クラスの割当てによってこのテンプレート・マッピングを行います。

サブスクリプション

「サブスクリプション」を使用して、カレント・アプリケーションに既存のテンプレートを適用します。

「マスター・リスト・テンプレートの参照元」を使用して、対象のワークスペースの既存のテンプレート、またはワークスペースのスキーマの別のテンプレートを選択します。既存のテンプレートを選択すると、ユーザーはそのテンプレートのサブスクライバになります。マスター・テンプレートのコピーをロードするには、「リフレッシュ」をクリックします。

リスト前のエントリ

リスト要素の前に表示するHTMLを入力します。この属性は、HTML表またはHTML表の行を開始するために使用できます。

テンプレート定義

カレントおよび非カレントのリスト・テンプレートを定義します。サポートされる置換文字列は、#LINK#、#TEXT#、#TEXT_ESC_SC#、#IMAGE_PREFIX#、#IMAGE#、#IMAGE_ATTR#および#A01#...#A10#です。

テンプレート定義属性は次のとおりです。

- カレント・リスト・テンプレート: 選択された(カレントの)リスト・テンプレートに置換されるHTMLまたはテキストを入力します。

- サブリスト・アイテムが含まれているカレント・リスト・テンプレート:アイテムにサブリスト・アイテムが含まれる場合は、選択された(カレントの)リスト・テンプレートに置換されるHTMLまたはテキストを入力します。指定しないと、現在のリスト・アイテム・テンプレートが使用されます。

- 非カレント・リスト・テンプレート: 選択されていない(非カレントの)リスト・テンプレートに置換されるHTMLまたはテキストを入力します。

- サブリスト・アイテムが含まれている非カレント・リスト・テンプレート:アイテムにサブリスト・アイテムが含まれる場合は、選択されていない(非カレントの)リスト・テンプレートに置換されるHTMLまたはテキストを入力します。指定しない場合、現在のリスト・アイテム・テンプレートが使用されます。

- リスト要素間: リスト要素の間に表示するHTMLを入力します。HTMLを指定しないと、この属性は無視されます。

最初のエントリのテンプレート定義

選択可能な属性は次のとおりです。

- カレント・リスト・テンプレート(最初): 定義すると、最初のリスト・アイテムに使用されます。選択された(カレントの)リスト・テンプレートに置換されるHTMLまたはテキストを入力します。

- サブリスト・アイテムが含まれているカレント・リスト・テンプレート(最初): 定義されている場合、これは最初のリスト・アイテムに使用されます。アイテムにサブリスト・アイテムが含まれる場合に使用される、選択された(カレントの)リスト・テンプレートに置換されるHTMLまたはテキスト。

- 非カレント・リスト・テンプレート(最初): 定義されている場合、これは最初のリスト・アイテムに使用されます。選択されていない(非カレントの)リスト・テンプレートに置換されるHTMLまたはテキストを入力します。

- サブリスト・アイテムが含まれている非カレント・リスト・テンプレート(最初): 定義されている場合、これは最初のリスト・アイテムに使用されます。アイテムにサブリスト・アイテムが含まれる場合に使用される、選択されていない(非カレントの)リスト・テンプレートに置換されるHTMLまたはテキスト。

サブリスト・エントリ前

サブリスト要素の前に表示するHTMLを入力します。

サブリスト・エントリ

カレントおよび非カレントのリスト・テンプレートを定義します。サポートされる置換文字列は、#LINK#、#TEXT#、#IMAGE_PREFIX#、#IMAGE#、#IMAGE_ATTR#、#A01#...#A10#、#LIST_ITEM_ID#および#PARENT_LIST_ITEM_ID#です。

サブリスト・エントリ属性は次のとおりです。

- カレント・サブリスト・テンプレート:選択された(カレントの)リスト・テンプレートに置換されるHTMLまたはテキストを入力します。

- サブリスト・アイテムが含まれているカレント・サブリスト・テンプレート:アイテムにサブリスト・アイテムが含まれる場合は、選択された(カレントの)リスト・テンプレートに置換されるHTMLまたはテキストを入力します。指定しない場合、現在のリスト・アイテム・テンプレートが使用されます。

- 非カレント・サブリスト・テンプレート:選択されていない(非カレントの)リスト・テンプレートに置換されるHTMLまたはテキストを入力します。

- サブリスト・アイテムが含まれている非カレント・サブリスト・テンプレート:アイテムにサブリスト・アイテムが含まれる場合は、選択されていない(非カレントの)リスト・テンプレートに置換されるHTMLまたはテキストを入力します。指定しない場合、現在のリスト・アイテム・テンプレートが使用されます。

- サブリスト・アイテム間:リスト要素の間に表示するHTMLを入力します。HTMLを指定しないと、この属性が無視されます。

サブリスト後のエントリ

サブリスト要素を表示した後に表示するHTMLを入力します。

リスト後のエントリ

すべてのリスト要素を表示した後に表示するHTMLを入力します。この属性を使用して、リスト前の要素属性で開始したHTML表を閉じることができます。

置換文字列

このテンプレートの置換文字列の用途を一覧します。置換文字列は、サブテンプレート内でコンポーネント値を参照するために使用されます。

コメント

この属性を使用して、このオブジェクトに関するコメントを記録します。

ページ・テンプレート

ページ・テンプレートは、ページの外観を定義します。各テンプレートは、ヘッダー・テンプレート、ボディ・テンプレート、フッター・テンプレートおよび多くのサブテンプレートで構成されます。ページ・レベル属性でページ・テンプレートを指定しない場合、Application Expressエンジンは、テーマの作成/編集ページで定義したデフォルトのページ・テンプレートを使用します。

ページ・テンプレートは、静的HTMLと実行時に置換される置換文字列を組み合せたものです。置換文字列を使用して、ページ・テンプレート内のコンポーネントの存在と配置を指定します。さらに、サブテンプレートを使用して、コンポーネントの表示方法を指定できます。

関連項目:
「テンプレートのカスタマイズ」および「テーマの管理」

内容は次のとおりです。

- サポートされるページ・テンプレートの置換文字列について

- ページ・テンプレート属性

サポートされるページ・テンプレートの置換文字列について

表13-4に、使用可能なページ・テンプレートの置換文字列を示します。テンプレートのすべての置換文字列は、大文字で指定し、シャープ記号(#)で囲む必要があることに注意してください。

特定のテンプレートでサポートされる置換文字列のレポートを表示するには、ページ・テンプレートの編集ページの「置換文字列」セクションを参照します。詳細は、「ページ・テンプレート属性」を参照してください。

表 13-4 ページ・テンプレートの置換文字列

置換文字列

場所

説明

#APEX_JAVASCRIPT#

ヘッダー・テンプレート

Oracle Application Expressで使用されるJavaScriptファイルおよびコード。

#APP_CSS#

ヘッダー・テンプレート

Oracle Application Expressで使用されるCSSファイル。

#BOX_BODY#

ボディ

ボディを表示する位置。ボディがNULLの場合、かわりに#BOX_BODY#が使用されます。

#CUSTOMIZE#

フッター・テンプレート

カスタマイズ・リンク。

#FORM_CLOSE#

フッター・テンプレート

HTMLのフォームの閉じタグ<form>を配置する位置。

#FORM_OPEN#

ヘッダー・テンプレート

HTMLのフォームの開始タグ<form>を配置する位置。フォームを送信するには、この置換文字列を含める必要があります。

#GENERATED_CSS#

ヘッダー・テンプレート

コンポーネントによって作成されるカスケード・スタイルシート・ファイル。

#GENERATED_JAVASCRIPT#

ヘッダー・テンプレート

コンポーネントによってすぐに作成されるJavaScriptコード。

#GLOBAL_NOTIFICATION#

ボディ

グローバル通知属性を表示します。グローバル通知は、システム・ステータス(保留中のシステム停止時間など)との通信に使用します。APEX_APPLICATION.G_GLOBAL_NOTIFICATIONを使用すると、この値をプログラムによって設定できます。

関連項目: 「グローバル通知」

#HEAD#

ヘッダー・テンプレート

<head>開始タグと</head>閉じタグの間に使用します。オプションで、各ページの#HEAD#のコンテンツを定義できます(たとえば、追加のスタイルシートまたはJavaScriptライブラリを参照するように定義できます)。

#HIGH_CONTRAST_TOGGLE#

すべて

ハイ・コントラストの切替え。

#LOGO#

ボディ

アプリケーション・イメージまたはログ。

アプリケーション定義の編集ページの「ロゴ」セクションで、アプリケーションのロゴのイメージおよびイメージ属性を指定できます。この機能を使用するには、「ヘッダー」または「ボディ」ページ・テンプレートに置換文字列#LOGO#も含める必要があります。

関連項目: 「ロゴ」

#NAVIGATION_BAR#

ボディ

ナビゲーション・バー。

関連項目: 「ナビゲーション・バー」サブテンプレートは、サブテンプレートを参照してください。

#NOTIFICATION_MESSAGE#

ボディ

インライン・エラー・メッセージのサマリーが表示される位置を定義します。インライン・エラー・メッセージは、フィールドの横または通知領域にインライン(あるいはその両方)で表示できます。

#ONLOAD#

ヘッダー・テンプレート

ページのロード時。

Webブラウザでページがロードされたときに実行されるJavaScriptコールで、この文字列を置換文字列として使用します。コールするJavaScriptは、ページごとに変更できます。

#PAGE_CSS#

ヘッダー・テンプレート

ページ・レベルで定義されるカスケード・スタイルシート・ファイルおよびインライン・スタイル。

#PAGE_JAVASCRIPT#

ヘッダー・テンプレート

ページ・レベルで定義されるJavaScriptファイルおよびコード。

#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#

すべて

スクリーン・リーダー切替え。

#SUCCESS_MESSAGE#

ボディ

成功メッセージ。ページの成功メッセージおよびエラー・メッセージを表示する位置を定義します。エラーなしでページ・プロセスが実行されると、このテキストが表示されます。

成功メッセージの前後にHTMLを追加すると、各テンプレートの成功メッセージの表示をカスタマイズできます。

#SWITCH_UI_TO_DESKTOP#

すべて

デスクトップ・ユーザー・インタフェースのホームページのハイパーリンク。

#SWITCH_UI_TO_JQM_SMARTPHONE#

すべて

スマートフォン・ユーザー・インタフェースのホームページのハイパーリンク。

#TAB_CELLS#

ボディ

標準タブの表示。

関連項目: 「標準タブ属性」

#TEMPLATE_CSS#

ヘッダー・テンプレート

ページ・テンプレート・レベルで定義されるカスケード・スタイルシート・ファイルおよびインライン・スタイル。

#THEME_CSS#

ヘッダー・テンプレート

テーマに対して選択されたカスケード・スタイルシート・ファイル。

#TITLE#

ヘッダー・テンプレート

ページ・タイトルを定義します。通常、HTMLのtitleタグ内に含まれます。

関連項目:
「置換文字列の理解」および「データベース・アプリケーションのページの管理」

ページ・テンプレート属性

ここでは、ページ・テンプレートの編集ページの特定のセクションについて説明します。ページの各セクションにアクセスするには、ページをスクロールするか、ページ上部のナビゲーション・ボタンをクリックします。ページ上部のボタンを選択すると、選択されたセクションが表示され、その他のセクションはすべて一時的に非表示になります。ページのすべてのセクションを表示するには、「すべて表示」をクリックします。

名前

「名前」は、テンプレートの名前を示します。「テーマ」は、テンプレートが関連付けられているテーマを示します。

「テンプレート・クラス」は、そのテンプレートに固有の用途を示します。新しいテーマに切り替えると、あるテーマのすべてのテンプレートは、別のテーマの対応するテンプレートにマップされます。アプリケーション・ビルダーは、テンプレート・クラスの割当てによってこのテンプレート・マッピングを行います。

「翻訳可能」チェック・ボックスを使用して、対象のテンプレートに翻訳が必要なテキスト文字列が含まれているかどうかを示します。

サブスクリプション

「サブスクリプション」を使用して、カレント・アプリケーションに既存のテンプレートを適用します。

「マスター・ページ・テンプレートの参照元」を使用して、対象のワークスペースの既存のテンプレート、またはワークスペースのスキーマの別のテンプレートを選択します。既存のテンプレートを選択すると、ユーザーはそのテンプレートのサブスクライバになります。

マスター・テンプレートの新しいコピーをロードするには、「リフレッシュ」を選択します。

定義

各テンプレートは、ヘッダー、ボディ、フッターおよびサブテンプレートで構成されます。動的コンテンツを含めるには、置換文字列を使用します。テンプレートのすべての置換文字列は、大文字で指定し、シャープ記号(#)で囲む必要があります。サポートされている置換文字列については、アイテム・ヘルプを参照してください。

「ヘッダー」は、ページ・テンプレートの最初のセクションです。HTMLドキュメントの<Head>セクションを定義するHTMLを入力します。表示するリージョンまたはAFTER HEADERを実行するプロセスおよび計算は、テンプレートのこのセクションがレンダリングされた直後に表示または実行されます。次に例を示します。

<html> <head>   <title>#TITLE#</title>   #APEX_CSS#   #TEMPLATE_CSS#   #THEME_CSS#   #PAGE_CSS#   #HEAD# </head>

少なくとも#TITLE#および#HEAD#をこのテンプレート・セクションに含めることをお薦めします。サポートされている置換文字列の具体的なリストは、アイテム・ヘルプを参照してください。

「ボディ」はページ・テンプレートの2番目のセクションで、ヘッダー・セクションとフッター・セクションの間にレンダリングされます。HTMLドキュメントの<Body>セクションを定義するHTMLを入力します。少なくとも、#BOX_BODY#、#FORM_OPEN#および#FORM_CLOSE#置換文字列をテンプレートのこのセクションに含める必要があります。次に例を示します。

<body #ONLOAD#>      #FORM_OPEN#      #BOX_BODY#      #FORM_CLOSE#      #GENERATED_CSS#      #APEX_JAVASCRIPT#      #TEMPLATE_JAVASCRIPT#      #APPLICATION_JAVASCRIPT#      #PAGE_JAVASCRIPT#      #GENERATED_JAVASCRIPT#   </body>

サポートされている置換文字列については、アイテム・ヘルプを参照してください。

「フッター」はページ・テンプレートの3番目のセクションで、ボディの後に表示されます。サポートされている置換文字列の詳細は、アイテム・ヘルプを参照してください。

JavaScript

選択可能な属性は次のとおりです。

- ファイルURL: このページにロードするコードのJavaScriptのファイルURLを入力します。各URLを新しい行に記述する必要があります。ファイルの縮小バージョンを指定する場合、置換文字列#MIN#を使用して、通常ページ・ビューのファイルURLに.minを含めたり、ページをデバッグ・モードで表示する場合は空の文字列を含めることができます。アプリケーションのバージョンをファイルＵＲＬに含める場合は、置換文字列#APP_VERSION#を使用することもできます。ここに入力したJavaScriptのファイルURLによって、ページ・テンプレート内の#TEMPLATE_JAVASCRIPT#置換文字列が置き換えられます。
スクリプトの開始タグや閉じタグを含めず、URLのみを記述します。

Examples:

- 標準ファイル参照:

/myjs/main.js

- 通常ページ・ビューの縮小ファイルmain.min.jsおよびデバッグ・モードのmain.jsをロードする標準ファイル参照。

/myjs/main#MIN#.js

- Internet Explorerの条件付きファイル

[if IE]/myjs/ie.js

- アプリケーション・バージョンを参照するURLで問合せ文字列を使用するファイル参照(アプリケーションがアップグレードされた(バージョンが増分された)ときに、ブラウザが常に新しいファイルをロードして、以前にキャッシュされたファイルを無視するよう指示されたファイル参照):

/myjs/main.js?version=#APP_VERSION#

- ファンクションおよびグローバル変数の宣言: このページ・テンプレートで使用するコードのJavaScriptコード(ファンクション、グローバル変数の宣言など)を入力します。重複を避け、ブラウザによる静的ファイルのキャッシュを利用するために、外部ファイルに格納することを検討してください。ここに入力したコードによって、ページ・テンプレート内の#TEMPLATE_JAVASCRIPT#置換文字列が置き換えられます。
スクリプトの開始タグや閉じタグを含めず、JavaScriptコードのみを含めます。

ショートカットを参照するには、"SHORTCUTNAME"を使用します。

- ページ・ロード時に実行: ページがロードされたときに実行されるJavaScriptコードを入力します。このコードはOracle Application Expressによって生成されたJavaScriptコードの後に実行されます。ここに入力したコードによって、ページ・テンプレート内の#GENERATED_JAVASCRIPT#置換文字列が置き換えられます。
スクリプトの開始タグや閉じタグを含めずに、JavaScriptコードのみを含めます。

カスケード・スタイル・シート(Cascading Style Sheet)

選択可能な属性は次のとおりです。

- ファイルURL: このページ・テンプレートでロードされるカスケード・スタイルシート・ファイルのURLを入力します。各URLを新しい行に記述する必要があります。ファイルの縮小バージョンを指定する場合、置換文字列#MIN#を使用して、通常ページ・ビューのファイルURLに.minを含めたり、ページをデバッグ・モードで表示する場合は空の文字列を含めることができます。アプリケーションのバージョンをファイルＵＲＬに含める場合は、置換文字列#APP_VERSION#を使用することもできます。ここに入力したファイルURLによって、テンプレート内の#TEMPLATE_CSS#置換文字列が置き換えられます。
スクリプトの開始タグや閉じタグを含めず、ファイルURLのみを含めます。

Examples:

- 標準ファイル参照:

/mycss/main.css

- 通常ページ・ビューの縮小ファイルmain.min.cssおよびデバッグ・モードのmain.cssをロードする標準ファイル参照。

/mycss/main#MIN#.css

- 条件付きメディア問合せ

[media="only screen and (max-device-width: 480px)"]/mycss/smartphone.css

- Internet Explorerの条件付きファイル

[if IE]/mycss/ie.css

- アプリケーション・バージョンを参照するURLで問合せ文字列を使用するファイル参照(アプリケーションがアップグレードされた(バージョンが増分された)ときに、ブラウザが常に新しいファイルをロードして、以前にキャッシュされたファイルを無視するよう指示されたファイル参照):

/mycss/main.css?version=#APP_VERSION#

- インライン: このページ・テンプレートで使用されるカスケード・スタイルシートのコードを入力します。重複を避け、ブラウザで静的ファイルをキャッシュするため、外部ファイルに挿入することを検討してください。重複を避け、ブラウザによる静的ファイルのキャッシュを利用するために、ここに入力したコードによってテンプレート内の#TEMPLATE_CSS#置換文字列が置き換えられます。
スタイルの開始タグや閉じタグを含めず、カスケード・スタイルシートのコードのみを含めます。この例では、CSSクラスdisplay_onlyをboldに設定しています。

.display_only {
font-weight:bold;
}

サブテンプレート

次のサブテンプレートのHTMLを入力します。サブテンプレートは、置換文字列を使用してページ・テンプレートのボディ内に配置されます。選択可能なサブテンプレートは次のとおりです。

- 「成功メッセージ」。テンプレートのボディ、ヘッダーまたはフッターの文字列#SUCCESS_MESSAGE#を置き換えるHTMLを入力します。次に例を示します。

<b>#SUCCESS_MESSAGE#</b>

- 「ナビゲーション・バー」。テンプレートのヘッダー、ボディまたはフッターの文字列#NAVIGATION_BAR#を置き換えるHTMLまたはテキストを入力します。置換文字列#BAR_BODY#を使用して、ナビゲーション・バーにエントリが表示される位置を指定します。次に例を示します。

<table class="navBar"><tr>#BAR_BODY#</tr></table>

#BAR_BODY#置換文字列によって、適切なHTML表セルが生成されます。

- 「ナビゲーション・バー・エントリ」。各ナビゲーション・バー・エントリのナビゲーション・バー#BAR_BODY#置換文字列に置換されるHTMLまたはテキストを入力します。次の置換文字列を使用して、ナビゲーション・バー・エントリのサブテンプレートを作成します。

- #LINK#: エントリ・リンク

- #TEXT#: エントリ・サブ・テキスト

- #IMAGE#: エントリ・イメージ
ナビゲーション・バー・エントリで指定された場合、HTMLイメージのALT、HEIGHTおよびWIDTH引数はHTML IMGタグに含まれます。

- #EDIT#: インライン編集のリンク編集機能

- #WIDTH#: イメージの幅

- #HEIGHT#: イメージの高さ

- #COLSPAN#: HTML COLSPAN値

- #ALT#: イメージの代替テキスト

- 「通知」。#NOTIFICATION_message#置換文字列が、テンプレートのヘッダー、ボディまたはフッターで参照される際に置換されるHTMLまたはテキストを入力します。通知サブテンプレートでは、次の置換文字列がサポートされます。

- #MESSAGE#

- #NOTIFICATION_MESSAGE_HEADER#

置換文字列#MESSAGE#を使用して、通知メッセージにメッセージ本体が表示される位置を指定します。次に例を示します。

<table><tr><td>#MESSAGE#</td></tr></table>

標準タブ属性

アプリケーションに標準タブが含まれている場合は、この属性を移入する必要があります。#TAB_CELLS#置換文字列を使用して、ページ・テンプレートのヘッダー、ボディまたはフッターに標準タブを配置できます。ページ・テンプレートのヘッダー、ボディ、フッターは、HTML表および行を定義します。このサブテンプレートは、特定のセルを定義することによって、これらのタブの表示方法を定義します。サポートされている置換文字列については、アイテム・ヘルプを参照してください。

選択可能な属性は次のとおりです。

- カレント・タブ。現在選択されている標準タブに置換されるHTMLまたはテキストを入力します。タブがカレントであるかどうかは、標準タブ属性によって判別されます。タブに表示される名前を示す#TAB_TEXT#置換文字列を含めます。次に例を示します。

<td>#TAB_LABEL#</td>

サポートされている置換文字列については、アイテム・ヘルプを参照してください。

- 非カレント標準タブ:選択されていない標準タブに置換されるHTMLまたはテキストを入力します。タブに表示される名前を示す#TAB_TEXT#置換文字列を含めます。次に例を示します。

<td><a href="#TAB_LINK#">#TAB_LABEL#</a></td>

サポートされている置換文字列については、アイテム・ヘルプを参照してください。

関連項目:
「タブの作成」

親タブ属性

アプリケーションに2つのレベルのタブが含まれている場合は、この属性を移入する必要があります。選択された親タブに置換されるHTMLまたはテキストを入力します。#PARENT_TAB_CELLS#置換文字列を使用して、ページ・テンプレートのヘッダー、ボディまたはフッターに親タブを配置できます。親タブは、標準タブとのみ表示されます。

選択可能な属性は次のとおりです。

- 「カレント親タブ」。選択された親タブに置換されるHTMLまたはテキストを入力します。タブがカレントかどうかは、表示されるページと、ページで使用している標準タブ・セットで判断します。タブに表示される名前を示す#TAB_TEXT#置換文字列を含めます。次に例を示します。

<td><a href="#TAB_LINK#">#TAB_LABEL#</a></td>

サポートされている置換文字列については、アイテム・ヘルプを参照してください。

この属性は、「親タブ」サブテンプレートに含まれており、#PARENT_TAB_CELLS#置換文字列を拡張します。

- 非カレント親タブ:選択されていない親タブに置換されるHTMLまたはテキストを入力します。タブに表示される名前を示す#TAB_TEXT#置換文字列を含めます。次に例を示します。

<td><a href="#TAB_LINK#">#TAB_LABEL#</a></td>

サポートされている置換文字列については、アイテム・ヘルプを参照してください。

この属性は、「親タブ」サブテンプレートに含まれており、#PARENT_TAB_CELLS#置換文字列を拡張します。

関連項目:
「タブの作成」

イメージ・ベースのタブ属性

このサブテンプレートは、完全にイメージに基づくタブに使用します。選択可能な属性は次のとおりです。

- 「カレント・イメージ・タブ」。イメージベースのタブが現在選択されていることを示すために使用するHTMLを入力します。タブに表示される名前を示す#TAB_TEXT#置換文字列を含めます。次に例を示します。

<td>#TAB_TEXT#</td>

- 非カレント・イメージ・タブ:イメージ・タブは現在選択されていないことを示すために使用するHTMLを入力します。タブに表示される名前を示す#TAB_TEXT#置換文字列を含めます。

GridLayout

選択可能な属性は次のとおりです。

- タイプ: グリッド・レイアウトを選択します。

- HTML表: HTML表を使用してリージョン、ページ・アイテムおよびボタンを配置します。

- 固定列数: 画面を固定数のグリッド列に分割するグリッドに使用されます。

- 可変列数: リージョン、ページ・アイテムおよびボタンの位置に応じて最大n個のグリッド列を表示できるグリッドに使用されます。

- リージョン表属性: この属性によって、<table>タグの属性を制御できます。Application Expressエンジンが同じリージョン位置の複数の列にリージョンを表示する場合、Oracle Application ExpressはHTML表をレンダリングします。

表示ポイント

「ブレッドクラム表示ポイント」は、ブレッドクラムを使用する生成済コンポーネントに適用されます。ブレッドクラムが配置されるページ上の位置を定義します。「サイドバー表示ポイント」は、サイドバーを使用する生成済コンポーネントに適用されます。サイドバーが配置されるページ上の位置を定義します。

エラー・ページ・テンプレートの制御

ページ・テンプレートをエラー・テンプレートとして指定する場合は、この属性を使用します。サポートされる置換文字列は、次のとおりです。

- #MESSAGE#および#ADDITIONAL_INFO#: エラー・メッセージを表示します。

- #TECHNICAL_INFO#: 開発者に表示される詳細な内部エラー情報を表示します。

- #BACK_LINK#: 前のページに戻るリンクを表示します。

- #OK#および#RETURN_TO_APPLICATION#: 翻訳されたテキスト文字列に戻ります。

置換文字列

このテンプレートの置換文字列の用途を一覧します。置換文字列は、サブテンプレート内でコンポーネント値を参照するために使用されます。「サポートされるページ・テンプレートの置換文字列について」を参照してください。

コメント

この属性を使用して、このコンポーネントに関するコメントを記録します。

ポップアップLOVテンプレート

ポップアップLOVテンプレートは、POPUPとして定義したすべてのアイテムに対するポップアップ・リストの表示方法を制御します。ポップアップLOVテンプレートは、各テーマに1つのみ指定できます。

関連項目:
「アプリケーション・レベルでのLOVの作成」、「テンプレートのカスタマイズ」および「テーマの管理」

ポップアップLOVテンプレート属性

ここでは、ポップアップLOVテンプレートの編集ページの特定のセクションについて説明します。ページの各セクションにアクセスするには、ページをスクロールするか、ページ上部のナビゲーション・ボタンをクリックします。ページ上部のボタンを選択すると、選択されたセクションが表示され、その他のセクションはすべて一時的に非表示になります。ページのすべてのセクションを表示するには、「すべて表示」をクリックします。

アプリケーション

「テーマ」は、テンプレートが関連付けられているテーマを示します。「テンプレート・クラス」は、そのテンプレートに固有の用途を示します。新しいテーマに切り替えると、あるテーマのすべてのテンプレートは、別のテーマの対応するテンプレートにマップされます。アプリケーション・ビルダーは、テンプレート・クラスの割当てによってこのテンプレート・マッピングを行います。対象のテンプレートに翻訳が必要なテキスト文字列が含まれていることを示すには、「翻訳可能」チェック・ボックスを使用します。

サブスクリプション

「サブスクリプション」を使用して、カレント・アプリケーションに既存のテンプレートを適用します。「マスター・ポップアップLOVテンプレートの参照元」を使用して、対象のワークスペースの既存のテンプレート、またはワークスペースのスキーマの別のテンプレートを選択します。既存のテンプレートを選択すると、ユーザーはそのテンプレートのサブスクライバになります。

マスター・テンプレートの新しいコピーをロードするには、「リフレッシュ」をクリックします。

アイコン

選択可能な属性は次のとおりです。

- ポップアップ・アイコン: POPUPタイプのアイテムのフォーム・フィールドの右側に表示するアイコンを指定します。デフォルトでは、Application Expressエンジンはlist.gifイメージを使用します。

- ポップアップ・アイコン属性: ポップアップ・アイコンのイメージ属性(高さや幅など)を定義します。

- ポップアップ・カラー・ピッカー・アイコン: ポップアップ・カラー・ピッカー・タイプのアイテムのフォーム・フィールドの右側に表示するアイコンを定義します。デフォルトでは、Application Expressエンジンは/i/htmldb/icons/palette.gifイメージを使用します。

- ポップアップ・カラー・ピッカー・アイコン属性: ポップアップ・カラー・ピッカー・アイコンの表示に使用するイメージ属性(高さや幅など)を定義します。

検索フィールド

これらの属性を使用して、「検索」フィールドの表示方法を指定します。表 13-5に、使用可能な検索フィールドの属性を示します。

表 13-5 検索フィールドの属性

属性

説明

フィールド・テキストの前

ポップアップLOVの検索フィールドを表示する前に表示するテキストを定義します。

フィルタ幅

この幅を使用して、HTML INPUT TYPE = TEXTウィジェットを表示します。

フィルタ最大幅

この最大幅を使用して、HTML INPUT TYPE = TEXTウィジェットを表示します。

フィルタ・テキスト属性

これらの属性を使用して、HTML INPUT TYPE = TEXTウィジェットを表示します。これは、HTML入力タグ内に含まれます。

フィールド・テキストの後

検索フィールド、検索ボタンおよび閉じるボタンを表示した後にこのテキストを表示します。

ボタン

これらの属性を使用して、ボタン名および「検索」、「閉じる」、「次へ」および「戻る」ボタンの属性を定義します。詳細は、アイテム・ヘルプを参照してください。

ウィンドウ

JavaScriptを使用してポップアップLOVが実行されます。これらの属性を使用して、scrollbars=、resizable=、width=およびheight=の値を制御します。デフォルトの値の詳細は、アイテム・ヘルプを参照してください。詳細は、アイテム・ヘルプを参照してください。

ページ区切り

行カウント結果の表示方法を定義します。詳細は、アイテム・ヘルプを参照してください。

結果セット

これらの属性を使用して、結果セットの前後に表示するテキストまたはHTMLを定義します。詳細は、アイテム・ヘルプを参照してください。

ページ属性

これらの属性を使用してポップアップ・ページを定義します。詳細は、アイテム・ヘルプを参照してください。

リージョン・テンプレート

リージョン・テンプレートは、リージョン属性の外観と配置を制御します。#BODY#や#EDIT#などの置換文字列を使用してリージョン属性を配置します。テンプレートの置換文字列は、大文字で指定し、シャープ記号(#)で囲む必要があります。

関連項目:
「リージョンの理解」、「テンプレートのカスタマイズ」および「テーマの管理」

リージョン・テンプレート属性

ここでは、リージョン・テンプレートの編集ページの特定のセクションについて説明します。ページの各セクションにアクセスするには、ページをスクロールするか、ページ上部のナビゲーション・ボタンをクリックします。ページ上部のボタンを選択すると、選択されたセクションが表示され、その他のセクションはすべて一時的に非表示になります。ページのすべてのセクションを表示するには、「すべて表示」をクリックします。

名前

「名前」は、テンプレートの名前を示します。「テーマ」は、テンプレートが関連付けられているテーマを示します。

「テンプレート・クラス」は、そのテンプレートに固有の用途を示します。新しいテーマに切り替えると、あるテーマのすべてのテンプレートは、別のテーマの対応するテンプレートにマップされます。アプリケーション・ビルダーは、テンプレート・クラスの割当てによってこのテンプレート・マッピングを行います。テンプレートに翻訳が必要なテキスト文字列が含まれていることを示すには、「翻訳可能」チェック・ボックスを使用します。

サブスクリプション

「マスター・リージョン・テンプレートの参照元」を使用して、対象のアプリケーションの既存のテンプレート、またはワークスペースのスキーマの別のテンプレートを選択します。既存のテンプレートを選択すると、ユーザーはそのテンプレートのサブスクライバになります。

マスター・テンプレートの新しいコピーをロードするには、「テンプレートのリフレッシュ」をクリックします。

定義

リージョン・テンプレートにより、リージョンと呼ばれるページ部分の外観が決まります。置換文字列を使用して、リージョン内のコンポーネントの存在と配置を指定します。必要な置換文字列は#BODY#のみです。リージョン・ソースが配置される位置を指定します。他のすべての置換文字列はオプションです。有効な置換文字列は次のとおりです。

- #TITLE#

- #PAGE_TITLE#

- #EXPAND#

- #CHANGE#

- #BODY#

- #SUB_REGION_HEADERS#

- #SUB_REGIONS#

- #FORM_OPEN#

- #FORM_CLOSE#

- #REGION_ID#

- #REGION_STATIC_ID#

- #REGION_ATTRIBUTES#

リージョン位置にボタンを作成すると、定義した位置が選択リストに表示されます。次の置換文字列を使用して、リージョンにボタンを配置する位置を定義してください。

- #EDIT#

- #CLOSE#

- #CREATE#

- #CREATE2#

- #EXPAND#

- #HELP#

- #DELETE#

- #COPY#

- #NEXT#

- #PREVIOUS#

関連項目:
「置換文字列の理解」

GridLayout

ページ・アイテムは、リージョン内で表示されます。ページ・テンプレートのグリッド・タイプが「表」に設定されている場合、各アイテムはHTML表の一部です。この属性を使用して、この表の属性を設定できます。次に例を示します。

class="instructiontext"

サブリージョン

「ヘッダー・テンプレート」および「ヘッダー・エントリ・テンプレート」を使用して、現在のリージョンにおけるすべてのサブリージョンのリージョン・タイトルのリストを生成します。どちらのテンプレートも、必要な置換文字列は#ENTRIES#のみです。

その他の有効な置換文字列は、次のとおりです。

- #ENTRIES#

- #REGION_ID#

- #REGION_STATIC_ID#

リージョン・テンプレートで#SUB_REGION_HEADERS#を使用して、このテンプレートの出力を配置します。

「テンプレート」を使用して、サブリージョンを追加のHTMLコードでラップします。必要な置換文字列は#SUB_REGION#のみです。この置換文字列は、サブリージョンのソースの配置場所を示します。他のすべての置換文字列はオプションです。

詳細およびサポートされている置換文字列のリストについては、アイテム・ヘルプを参照してください。

コメント

この属性を使用して、このコンポーネントに関するコメントを記録します。

置換文字列

このテンプレートの置換文字列の用途を一覧します。置換文字列は、サブテンプレート内でコンポーネント値を参照するために使用されます。

レポート・テンプレート

レポート列テンプレートによって、SQL問合せによって戻される1行の結果を制御できます。このタイプのテンプレートは、行全体ではなく、セルを定義します。

各レポート・テンプレートでは、#1#、#2#、#3#などの構文を使用して列名を識別します。#ENAME#や#EMPNO#などの列名の置換構文を使用して、列に名前を付けることもできます。アプリケーションのどのアイテムもテンプレート内で参照できます。たとえば、テンプレートのABC.というアイテムを参照するには、置換文字列&ABC.を正確に含めます。ABC.の実際の値は、ABCという名前のアプリケーションのアイテムを編集するエンド・ユーザーによって提供されます。

関連項目:
「テンプレートのカスタマイズ」および「テーマの管理」

内容は次のとおりです。

- 汎用列テンプレートおよび名前付き列テンプレートについて

- 汎用列テンプレートのレポート列テンプレート属性

- 名前付き列テンプレートのレポート列テンプレート属性

- 列テンプレートでのJavaScriptの使用について

汎用列テンプレートおよび名前付き列テンプレートについて

Oracle Application Expressには、次の2種類のレポート・テンプレートが含まれています。

- 汎用列テンプレート

- 名前付き列テンプレート

汎用列テンプレート

汎用列テンプレートは、列の外観を1回定義することによって、レポートの外観を決定します。その後、この外観は、レポート定義に指定された列の数に基づいて、必要なだけ繰り返されます。このタイプのテンプレートを使用できるのは、行および列が標準的な構造のレポートに限られます。条件を使用すると、このタイプのテンプレートでレポートに追加のスタイルを適用できます。

次の例では、各列で特定のスタイルを使用する方法を示します。

<td class="tabledata" align="#ALIGN#">#COLUMN_VALUE#</td>

この例では、ページ・テンプレートにクラスtabledataを含むCSSが存在することを想定しています。また、この例では、置換文字列#ALIGN#および#COLUMN_VALUE#を使用しています。実際にこのレポートを実行すると、これらの置換文字列は、SQL問合せの結果によって生成された値に置換されます。

問合せの選択リストに式を使用する場合は、列の別名を作成して実行時エラーを回避することをお薦めします。たとえば、次のような問合せを考えてみます。

SELECT ename, (sal + comm) * 12 FROM emp

問合せをリライトして、次のように列に別名を付けることができます。

SELECT ename, (sal + comm) * 12 yearly_comp FROM emp

名前付き列テンプレート

名前付き列テンプレートを使用すると、より柔軟にレポートを設計できます。ただし、名前付きテンプレートは名前で列を参照するため、それらの列を基にしたレポートでのみ使用されます。次に例を示します。

<tr><td>#ENAME#</td><td>#SAL#</td></tr>

名前付き列テンプレートは自由度の高いものですが、問合せごとに新しいテンプレートを作成する必要がある場合があります。位置表記を含めることもできます。次の例では、HTMLおよび置換文字列を使用する方法を示します。

<tr><td>#ENAME#</td><td>#SAL#</td></tr>

<tr><td>#1#</td><td>#2#</td></tr>

汎用列テンプレートのレポート列テンプレート属性

ここでは、汎用列テンプレートのレポート・テンプレートの編集ページの特定のセクションについて説明します。ページの各セクションにアクセスするには、ページをスクロールするか、ページ上部のナビゲーション・ボタンをクリックします。ページ上部のボタンを選択すると、選択されたセクションが表示され、その他のセクションはすべて一時的に非表示になります。ページのすべてのセクションを表示するには、「すべて表示」をクリックします。

レポート・テンプレート

「テンプレート名」は、テンプレートの名前を示します。「テンプレート・タイプ」には、テンプレートのタイプを指定します。名前付き列テンプレートは、テンプレートの列名を参照します。汎用列テンプレートは、テンプレートの#COLUMN_VALUE#置換文字列を参照します。

「テーマ」は、テンプレートが関連付けられているテーマを示します。「テンプレート・クラス」は、そのテンプレートに固有の用途を示します。新しいテーマに切り替えると、あるテーマのすべてのテンプレートは、別のテーマの対応するテンプレートにマップされます。アプリケーション・ビルダーは、テンプレート・クラスの割当てによってこのテンプレート・マッピングを行います。テンプレートに翻訳が必要なテキスト文字列が含まれていることを示すには、「翻訳可能」チェック・ボックスを使用します。

テンプレート・サブスクリプション

「マスター・レポート・テンプレートの参照元」を使用して、対象のワークスペースの既存のテンプレート、またはワークスペースのスキーマの別のテンプレートを選択します。既存のテンプレートを選択すると、ユーザーはそのテンプレートのサブスクライバになります。

マスター・テンプレートの新しいコピーをロードするには、「リフレッシュ」をクリックします。

行の前

「行の前」では、レポート・テンプレートの最初に1回表示するHTMLを入力します。HTML表は、一般的に、次のようにこの属性を使用して開始します。

<table>

構文#1#、#2#、#3#を使用して列ヘッダーを指定できます。次に例を示します。

<th>#1#</th><th>#2#</th><th>#3#</th>

置換文字列#top_pagination#を含めることによって、レポートの上部にページ区切りを含めることができます。この置換文字列は、開始タグ<tr>で始まり、閉じタグ</tr>で終わるHTMLを生成します。たとえば、表の開始タグと#TOP_PAGINATION#置換文字列を含めるには、次のように入力します。

<table>#TOP_PAGINATION#

また、置換文字列 #CSV_LINK#を使用すると、ほぼすべてのスプレッドシート・プログラムと互換性があるカンマ区切り値(CSV)形式にレポートをエクスポートできるようになります。

また、置換文字列#REPORT_ATTRIBUTES#を使用することもできます。この置換文字列は、レポート属性ページのレポート・リージョンごとに設定されます。

列見出し

「列ヘッダーの前」を使用して、レポート・ヘッダーの前にテキストを表示します。

「列ヘッダー・テンプレート」を使用して、各列ヘッダーのセルをカラーにします。この属性のテキストには、セルのヘッダー・テキストをカラーにする位置を示すヘルプを含める必要があります。次に例を示します。

<th >Item Help Text</th>

列ヘッダーを使用しない場合は、次のように入力します。

OMIT

この属性を使用しない場合は、Application Expressエンジンによって、デフォルトの列ヘッダー・テンプレートが適用されます。

「列ヘッダーの後」を使用して、レポート・ヘッダーの後にテキストを表示します。

各行の前

「各行の前」では、レポートのすべての列の前に表示するテキストを入力します。この属性は、新しいHTML行を開始するために使用します。「各行の前」では、次の置換文字列をサポートします。

- #ROWNUM#
この置換文字列は、現行の行を指定するために使用します。

- #COLCOUNT#
この置換文字列は、列の数を指定するために使用します。

- #HIGHLIGHT_ROW#
この置換文字列は、ハイライトされた行の数を指定するために使用します。

列テンプレート

列テンプレートは、各列の外観を定義します。最大4つの列テンプレートを定義できます。各テンプレートは、条件付きにできます。たとえば、偶数行と奇数行に異なる背景色を指定したり、PL/SQLで定義した条件に一致する行をハイライトできます。

各列テンプレートでは、各列の外観を定義します。表13-6に、列テンプレートでサポートされる置換文字列を示します。

表 13-6 列テンプレートの置換文字列

置換文字列

説明

#ALIGNMENT#

列の位置合せを指定します。ユーザーが指定します。

#COLCOUNT#

列数のカウントを定義します。

#COLNUM#

現在の列番号を定義します。

#COLUMN_HEADER#

列ヘッダーを定義します。

#COLUMN_VALUE#

列の値に置換されます。

#ROWNUM#

現在の行番号を指定します。

次に例を示します。

<td> #ALIGNMENT#>#COLUMN_VALUE#</td>

実際にこのレポートを実行すると、これらの置換文字列は、SQL問合せの結果によって生成された値に置換されます。

条件を作成すると、指定した条件に一致するかどうかによって列の表示が異なるレポートを作成できます。条件付きで使用される列テンプレートを指定するには、列テンプレートの条件リストから条件タイプを選択します。有効な値は、次のとおりです。

- PL/SQL式に基づく使用:その行のデータに基づき、条件付きで列を書式化します。

- 偶数行で使用:偶数行を条件付きで書式化します。

- 奇数行で使用:奇数行を条件付きで書式化します。

「PL/SQL式に基づく使用」を選択する場合は、次に列テンプレートの式フィールドでPL/SQL式を入力します。たとえば、次の式で値が2000より大きい場合、その値を太字で表示します。

#SAL# > 2000

置換文字列#ROWNUM#を使用することもできます。次に例を示します。

#ROWNUM# > 2000

各行の後

「各行の後」には、レポートを表示する際にすべての列の後に表示するHTMLを入力します。多くの場合、この属性は、HTML表の行を閉じるために使用されます。次に例を示します。

</tr>

行の後

「行の後」を使用して、最後の行の後に表示するテキストを指定します。HTML表のタグは、一般的に、この属性を使用して閉じます。次に例を示します。

</table>

「行の後」属性は、次の置換文字列をサポートします。

- #PAGINATION#
ページ区切り属性で置換されます。

- #COLCOUNT#
実行時に、レポートで定義された列数に置換されます。

- #CSV_LINK#
CSVエクスポートが有効である場合は、実行時にCSVダウンロード・リンクに置換されます。それ以外の場合、文字列は表示されません。

- #EXTERNAL_LINK#
実行時に、外部処理エンジンを使用するエクスポート(PDFエクスポートなど)のダウンロード・リンクに置換されます。この機能が無効である場合、文字列は表示されません。

行選択

「チェックした行のバックグラウンド・カラー」によって、行セレクタが選択されている場合のレポート行の背景色が制御されます。「カレント行のバックグラウンド・カラー」によって、ユーザーがその行の上にマウスを移動した場合のレポート行の背景色が制御されます。

ページ区切りサブテンプレート

「ページ区切りのサブテンプレート」セクションには、「ページ区切りテンプレート」、「次のページ・テンプレート」、「前のページ・テンプレート」、「次のセット・テンプレート」および「前のセット・テンプレート」を編集する属性が含まれています。ページ区切りのサブテンプレートは、置換文字列#PAGINATION_NEXT#、#PAGINATION_NEXT_SET#、#PAGINATION_PREVIOUS#および#PAGINATION_PREVIOUS_SET#をサポートしています。表13-9に、これらのテンプレートについて示します。

表 13-7 ページ区切りのサブテンプレート属性

ページ区切りサブテンプレート属性

説明

ページ区切りテンプレート

ページ区切りサブテンプレート全体に適用します。次に例を示します。

<span class="instructiontext">#TEXT#</span>

置換文字列#TEXT#を使用して、ページ区切りサブテンプレートを表示する場所を指定します。

個々のアイテムを変更するには、その他のページ区切りサブテンプレート属性を使用します。

次のページ・テンプレート

ページ区切りサブテンプレートの「次のページ」部分を表示する方法を変更するHTMLを入力します。次に例を示します。

<a href="#LINK#">next</a>

前のページ・テンプレート

ページ区切りサブテンプレートの「前のページ」部分を表示する方法を変更するHTMLを入力します。次に例を示します。

<a href="#LINK#">previous</a>

次のセット・テンプレート

ページ区切りサブテンプレートの「次のセット」部分を表示する方法を変更するHTMLを入力します。次に例を示します。

<a href="#LINK#">next set</a>

前のセット・テンプレート

ページ区切りサブテンプレートの「前の設定」部分を表示する方法を変更するHTMLを入力します。次に例を示します。

<a href="#LINK#">previous set</a>

コメント

この属性を使用して、このコンポーネントに関するコメントを記録します。

名前付き列テンプレートのレポート列テンプレート属性

ここでは、名前付き列テンプレートのレポート・テンプレートの編集ページの特定のセクションについて説明します。ページの各セクションにアクセスするには、ページをスクロールするか、ページ上部のナビゲーション・ボタンをクリックします。ページ上部のボタンを選択すると、選択されたセクションが表示され、その他のセクションはすべて一時的に非表示になります。ページのすべてのセクションを表示するには、「すべて表示」をクリックします。

名前

「テンプレート名」は、テンプレートの名前を示します。「テンプレート・タイプ」には、テンプレートのタイプを指定します。名前付き列テンプレートは、テンプレートの列名を参照します。汎用列テンプレートは、テンプレートの#COLUMN_VALUE#置換文字列を参照します。

「テーマ」は、テンプレートが関連付けられているテーマを示します。テンプレートに翻訳が必要なテキスト文字列が含まれていることを示すには、「翻訳可能」チェック・ボックスを使用します。「テンプレート・クラス」は、そのテンプレートに固有の用途を示します。新しいテーマに切り替えると、あるテーマのすべてのテンプレートは、別のテーマの対応するテンプレートにマップされます。アプリケーション・ビルダーは、テンプレート・クラスの割当てによってこのテンプレート・マッピングを行います。

サブスクリプション

「サブスクリプション」を使用して、カレント・アプリケーションに既存のテンプレートを適用します。既存のテンプレートを選択すると、ユーザーはそのテンプレートのサブスクライバになります。

マスター・テンプレートの新しいコピーをロードするには、「リフレッシュ」をクリックします。

行テンプレート

行テンプレートは、各行の外観を定義します。最大4つの行テンプレートを定義できます。各テンプレートは、条件付きにできます。

各行テンプレートでは、各行の外観を定義します。表13-8に、行テンプレートでサポートされる置換文字列を示します。

表 13-8 行テンプレートの置換文字列

置換文字列

説明

#ALIGNMENT#

行の位置合せを指定します。ユーザーが指定します。

#COLCOUNT#

列数のカウントを定義します。

#COLNUM#

現在の列番号を定義します。

#COLUMN_HEADER#

列ヘッダーを定義します。

#COLUMN_VALUE#

列の値に置換されます。

#ROWNUM#

現在の行番号を指定します。

条件を作成すると、指定した条件に一致するかどうかによって行の表示が異なるレポートを作成できます。条件付きで使用される行テンプレートを指定するには、列テンプレートの条件リストから条件タイプを選択します。有効な値は、次のとおりです。

- PL/SQL式に基づく使用:その行のデータに基づき、条件付きで列を書式化します。

- 偶数行で使用:偶数行を条件付きで書式化します。

- 奇数行で使用:奇数行を条件付きで書式化します。

「PL/SQL式に基づく使用」を選択する場合は、次に列テンプレートの式フィールドでPL/SQL式を入力します。たとえば、次の式で値が2000より大きい場合、その値を太字で表示します。

#SAL# > 2000

置換文字列#ROWNUM#を使用することもできます。次に例を示します。

#ROWNUM# > 2000

列見出し

各列ヘッダーのセルに色を追加するには、このテンプレートを使用します。この属性のテキストには、セルのヘッダー・テキストをカラー化する位置を指定する必要があります。「列ヘッダー・テンプレート」を入力しない場合は、デフォルトの列ヘッダー・テンプレートが適用されます。列ヘッダーを使用しない場合は、OMITを入力します。次に例を示します。

<th #ALIGNMENT#>#COLUMN_HEADER#</th>

最初の前および最後の後のテキスト

「行の前」では、レポート・テンプレートの最初に1回表示するHTMLを入力します。HTML表は、一般的に、次のようにこの属性を使用して開始します。

<table>

構文#1#、#2#、#3#を使用して列ヘッダーを指定できます。次に例を示します。

<th>#1#</th><th>#2#</th><th>#3#</th>

置換文字列#top_pagination#を含めることによって、レポートの上部にページ区切りを含めることができます。この置換文字列は、開始タグ<tr>で始まり、閉じタグ</tr>で終わるHTMLを生成します。たとえば、表の開始タグと#TOP_PAGINATION#置換文字列を含めるには、次のように入力します。

<table>#TOP_PAGINATION#

また、置換文字列#CSV_LINK#を使用すると、ほぼすべてのスプレッドシート・プログラムと互換性があるCSVフォーマットにレポートをエクスポートできるようになります。

「行の後」を使用して、最後の行の後に表示するテキストを指定します。HTML表のタグは、一般的に、この属性を使用して閉じます。次に例を示します。

</table>

「行の後」属性は、次の置換文字列をサポートします。

- #PAGINATION#
ページ区切り属性で置換されます。

- #COLCOUNT#
実行時に、レポートで定義された列数に置換されます。

ページ区切り

「ページ区切り」セクションには、「ページ区切りテンプレート」、「次のページ・テンプレート」、「前のページ・テンプレート」、「次のセット・テンプレート」および「前のセット・テンプレート」を編集する属性が含まれています。ページ区切りのサブテンプレートは、置換文字列#PAGINATION_NEXT#、#PAGINATION_NEXT_SET#、#PAGINATION_PREVIOUS#および#PAGINATION_PREVIOUS_SET#をサポートしています。表13-9に、これらのテンプレートについて示します。

表 13-9 ページ区切りのサブテンプレート属性

ページ区切りサブテンプレート属性

説明

ページ区切りテンプレート

ページ区切りサブテンプレート全体に適用します。次に例を示します。

<span class="instructiontext">#TEXT#</span>

置換文字列#TEXT#を使用して、ページ区切りサブテンプレートを表示する場所を指定します。

個々のアイテムを変更するには、その他のページ区切りサブテンプレート属性を使用します。

次のページ・テンプレート

ページ区切りサブテンプレートの「次のページ」部分を表示する方法を変更するHTMLを入力します。次に例を示します。

<a href="#LINK#">next</a>

前のページ・テンプレート

ページ区切りサブテンプレートの「前のページ」部分を表示する方法を変更するHTMLを入力します。次に例を示します。

<a href="#LINK#">previous</a>

次のセット・テンプレート

ページ区切りサブテンプレートの「次のセット」部分を表示する方法を変更するHTMLを入力します。次に例を示します。

<a href="#LINK#">next set</a>

前のセット・テンプレート

ページ区切りサブテンプレートの「前の設定」部分を表示する方法を変更するHTMLを入力します。次に例を示します。

<a href="#LINK#">previous set</a>

コメント

この属性を使用して、このコンポーネントに関するコメントを記録します。

列テンプレートでのJavaScriptの使用について

JavaScriptを使用すると、データベース内の値に応じてHTMLを条件付きで表示できます。次の例では、GROUP_DESC問合せ列がNULLでない場合にのみHTML行が表示されます。

<script language="javascript">
IF ( "#GROUP_DESC#" != "" )
document.writeln( "<TR>;
<TD BGCOLOR=#336699>;</TD>
</TR>
</TR>
<TD>#GROUP_DESC#</TD>
</TR>" );
</TR>" );

関連項目:

- レポート・テンプレートの編集ページ固有のセクションを使用する方法については、オンライン・ヘルプを参照してください。

- 「リージョンの理解」

カスタム・カスケード・スタイルシートの使用

カスケード・スタイルシート(CSS)によって、構造を変更せずにWebページのスタイルを制御できます。CSSを適切に使用すると、カラー、余白、フォントなどの視覚属性がHTMLドキュメントの構造から切り離されます。Oracle Application Expressのテーマには、独自のCSSを参照するテンプレートを含めることができます。特定のテーマの各CSSで定義されたスタイル・ルールによって、レポートおよびリージョンの表示も指定されます。

内容は次のとおりです。

- カスケード・スタイルシートのアップロード

- ページ・テンプレートのアップロードされたカスケード・スタイルシートの参照

カスケード・スタイルシートのアップロード

カスケード・スタイルシートをワークスペースにアップロードするには、カスケード・スタイルシート・リポジトリを使用します。アップロードされたカスケード・スタイルシート(CSS)は、ワークスペースに作成されたすべてのアプリケーションで使用できます。カスケード・スタイルシートは、ファイル・システムに書き込まれるため、HTMLソース・コードで参照できます。

カスケード・スタイルシートをアップロードするには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。
「共有コンポーネント」ページが表示されます。

4. 「ファイル」で、「カスケード・スタイルシート」を選択します。
カスケード・スタイルシート・ページが表示されます。

5. 「レポートの表示」アイコンをクリックします。「カスケード・スタイルシート・ページについて」を参照してください。
レポートが表示されます。

6. CSSをアップロードするには、「作成」をクリックして、画面に表示されるステップに従います。

7. 既存のCSSを編集するには、CSSの名前を選択します。

8. 既存のCSSをダウンロードするには、「ダウンロード」アイコンをクリックします。

関連項目:
「ページ・テンプレートのアップロードされたカスケード・スタイルシートの参照」

カスケード・スタイルシート・ページについて

CSSをCSSリポジトリにアップロードした後、検索バーで選択して、ページの表示方法を制御します。使用可能なコントロールは次のとおりです。

- 「検索」アイコン: 虫めがねに似ています。このアイコンをクリックして、検索を特定の列のみに絞ります。すべての列を検索するには、「すべての列」を選択します。

- テキスト領域: 大/小文字を区別しない検索基準(ワイルドカード文字は暗黙的に定義される)を入力し、「実行」をクリックします。

- 「実行」ボタン: 検索を実行したり、フィルタを適用します。

- アイコンの表示: 各カスケード・スタイルシートが大きいアイコンとして表示されます。

- レポートの表示: 各カスケード・スタイルシートがレポート内の1行として表示されます。

- アクション・メニュー: アクション・メニューを表示します。このメニューを使用して、レポート・ビューをカスタマイズします。「「アクション」メニューについて」を参照してください。

ページ・テンプレートのアップロードされたカスケード・スタイルシートの参照

ページ・テンプレートのヘッダー・セクション内でアップロードされたカスケード・スタイルシートを参照できます。ヘッダー・セクションを使用して、HTMLドキュメントの<HEAD>セクションを構成するHTMLを入力します。

アップロードされたカスケード・スタイルシートを参照するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「ユーザー・インタフェース」で、「テーマ」を選択します。
テーマ・ページが表示されます。

5. 「タスク」リストで、「テンプレートの表示」をクリックします。

6. 編集するページ・テンプレートの名前を選択します。

7. 「ヘッダー」セクション内の<link>タグを使用して、適切なスタイルシートを参照します。
特定のアプリケーションに関連付けられたアップロード済ファイルを参照するには、置換文字列#APP_IMAGES#を使用します。次に例を示します。

<html>
<head>
<title>#TITLE#</title>
#HEAD#
<link rel="stylesheet" href="#APP_IMAGES#sample2.css" type="text/css">
</head>
...

特定のワークスペースに関連付けられたアップロード済ファイルを参照するには、置換文字列#WORKSPACE_IMAGES#を使用します。次に例を示します。

<html>
<head>
<title>#TITLE#</title>
#HEAD#
<link rel="stylesheet" href="#WORKSPACE_IMAGES#sample3.css" type="text/css">
</head>
...

関連項目:
「カスケード・スタイルシートのアップロード」、「新しいテンプレートの作成」、「テンプレートの管理」、「ページ・テンプレート」、「APP_IMAGES」および「WORKSPACE_IMAGES」

14 アプリケーションのデバッグ

この項では、Oracle Application Express Advisor(アドバイザ)の実行、デバッグ・モードの表示、SQLトレースの有効化、ページ・レポートの表示などのアプリケーションのデバッグ方法について説明します。また、コントロールまたはコンポーネントを手動で削除して問題を特定する方法も説明されます。

内容は次のとおりです。

- パフォーマンス・チューニングについて

- アプリケーション整合性のチェックのためのアドバイザの実行

- セッション・ステートの確認

- デバッグ・モードへのアクセス

- SQLトレースの有効化およびTKPROFの使用

- アプリケーションとページのリソース使用の監視

- ページ・レポートの表示

- 問題のあるSQL問合せのデバッグ

- コントロールおよびコンポーネントの削除による問題の特定

関連項目:
「アプリケーション・ビルダーの概念」および「アプリケーション・ビルダーの使用」

パフォーマンス・チューニングについて

多くの同時ユーザーが存在するアプリケーションでは、最適なパフォーマンスを保持することが重要です。アプリケーションのパフォーマンスを最適化するには、次の機能を使用する必要があります。

- アプリケーションではできるかぎりバインド変数を使用します。SQL問合せ、およびプロセスや検証から実行されるPL/SQLなどのアプリケーション・ロジックでバインド変数構文を使用すると、セッション・ステート値を参照できます。バインド変数を使用してセッション・ステートにアクセスすると、最も効率的にセッション・ステートを参照できます。「バインド変数構文について」を参照してください。

- #TIMING#置換文字列をリージョン・フッターに含めて、各リージョンのタイミングを表示します。「置換文字列の理解」を参照してください。

アプリケーション整合性のチェックのためのアドバイザの実行

Oracle Application Express Advisor(アドバイザ)によって、Oracle Application Expressアプリケーションの整合性と品質をチェックできます。アドバイザはコンパイラまたはLINTのように機能し、疑わしい動作またはエラーにフラグを付けます。アドバイザを実行すると、基礎となるメタデータに基づいてアプリケーションの整合性をチェックします。

内容は次のとおりです。

- Oracle Application Express Advisorについて

- アプリケーション全体でのアドバイザの実行

- 単一ページ上でのアドバイザの実行

Oracle Application Express Advisorについて

アプリケーションをデプロイする前に、Oracle Application Express Advisorを使用して、アプリケーションで様々なチェックを実行できます。アドバイザでは、エラー、セキュリティ問題、パフォーマンスのボトルネック、有用性および品質保証についてチェックします。

アプリケーション全体でのアドバイザの実行

アドバイザをアプリケーション全体で実行するには、次のステップを実行します。

1. 該当するアプリケーションにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。
アプリケーション・ビルダーのホームページが表示されます。

2. アプリケーションを選択します。
「アプリケーション」ホームページが表示されます。

2. 「ユーティリティ」をクリックします。

3. 「アドバイザ」をクリックします。
アドバイザ・ページが表示されます。

図debug_advisor.gifの説明

4. 「実行する場合は選択」で、選択されたチェックを確認します。必要に応じてチェック・ボックスを有効化および無効化します。

5. ページ上部の「チェックの実行」をクリックします。
結果ページが表示されます。チェックを次回実行するときは、現在のアドバイザの設定が使用されます。

6. アドバイザに加えた変更を削除するには、「タスク」で「プリファレンスの削除」を選択します。

7. アドバイザを再び実行するには、「チェックの実行」をクリックします。

単一ページ上でのアドバイザの実行

アドバイザを単一ページ上で実行するには、次のステップを実行します。

1. 該当するアプリケーションにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。
アプリケーション・ビルダーのホームページが表示されます。

2. アプリケーションを選択します。
「アプリケーション」ホームページが表示されます。

3. ページを選択します。
ページ定義ページが表示されます。

2. 「ユーティリティ」をクリックします。
ユーティリティ・オプションのリストが表示されます。

3. 「チェック」をクリックします。
結果ページが表示されます。結果レポートは前回のアドバイザの設定を使用して生成されます。

4. 設定を変更するには、「設定の変更」をクリックします。
アドバイザ・ページが表示されます。

5. 「実行する場合は選択」で、選択されたチェックを確認します。必要に応じてチェック・ボックスを有効化および無効化します。

6. チェックを再び実行するには、ページ上部の「チェックの実行」をクリックします。
結果ページが表示されます。チェックを次回実行するときは、現在のアドバイザの設定が使用されます。

7. 結果をフィルタするには、「フィルタ結果」のチェック・ボックスを有効化および無効化して、「フィルタの適用」をクリックします。

8. アドバイザを再実行して、レポートされた問題が修正されたことを確認するには、「再チェック」をクリックします。

セッション・ステートの確認

多くのアプリケーションは、アプリケーション・コントロールに含まれるデータに基づいています。たとえばボタンは、セッション・ステートに格納された値に基づいて、条件付きで表示できます。アプリケーションの現行のセッション・ステートを表示するには、「開発者」ツールバーの「セッション」リンクをクリックします。

関連項目:
「「開発者」ツールバーについて」、「セッション・ステートの表示」、「セッション・ステート値の管理」およびOracle Application Express管理ガイドの「セッション・ステートおよびユーザー・プリファレンスの管理」

デバッグ・モードへのアクセス

デバッグ・モードは予期しないアプリケーション動作を追跡するために使用する組込みメカニズムです。「開発者」ツールバーの「デバッグ」と「デバッグなし」リンクをクリックすることによって、現在のページとセッションのデバッグ・モードを有効化および無効化します。デバッグ・レポートを表示するには、「開発者」ツールバーの「デバッグの表示」リンクをクリックします。

図d_toolbar.gifの説明

関連項目:
「「開発者」ツールバーについて」

内容は次のとおりです。

- デバッグの有効化と無効化

- デバッグ・モードでのアプリケーションの実行

- デバッグ・モードにアクセスするためのf?p構文の使用

- デバッグ・レポートの表示

デバッグの有効化と無効化

アプリケーション定義の編集ページの「デバッグ」属性を使用して、アプリケーションレベルでデバッグ・モードを有効化および無効化します。

デバッグを有効化または無効化するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. アプリケーション名の右側にある「アプリケーション・プロパティの編集」ボタンをクリックします。
アプリケーションの編集ページが表示されます。

4. 「プロパティ」までスクロールします。

5. 「デバッグ」で、次の項目を指定します。

- 「はい」。実行時にブラウザを使用してアプリケーション・デバッグ・モードを有効化します。

- 「いいえ」。実行時にブラウザを使用してアプリケーション・デバッグ・モードを無効化します。

関連項目:
「アプリケーション属性について」

デバッグ・モードでのアプリケーションの実行

「開発者」ツールバーの「デバッグ」と「デバッグなし」をクリックすることによって、デバッグ・モードを実行時に実行および無効化します。デフォルトでは、デバッグ・モードは無効化されています。「デバッグの有効化と無効化」を参照してください。

デバッグ・モードを有効化または無効化するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを実行します。

3. 「開発者」ツールバーで、「デバッグ」をクリックします。
デバッグ・モードが有効になります。デバッグ・データがバックグラウンドで取得されます。

4. デバッグ・モードを無効化するには、「開発者」ツールバーで、「デバッグなし」をクリックします。

デバッグ・モードにアクセスするためのf?p構文の使用

f?p構文を使用してアプリケーションをデバッグ・モードで実行することもできます。この場合、ページをコールして、デバッグ引数をYESまたはLEVELnに設定するだけです。次に例を示します。

f?p=100:1:&APP_SESSION.::YES

関連項目:
「f?p構文を使用したページのリンク」

デバッグ・レポートの表示

デバッグ・レポートを表示するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. 必要なアプリケーションを選択します。
デバッグ・レポートはアプリケーションが実行中または開発モードのときに表示できます。

3. デバッグ・レポートを開発モードで表示するには、次のステップを実行します。

- 「検索」アイコンをクリックし、「デバッグ」タブをクリックします。「「検索」アイコンの使用」を参照してください。

- 「アプリケーション」ホームページで、「ユーティリティ」をクリックして、「デバッグ・メッセージ」をクリックします。

4. アプリケーションの実行中にデバッグ・レポートを表示するには、「開発者」ツールバーで「デバッグの表示」をクリックします。
デバッグ・レポートのリストが表示されます。

5. 表示するセッションの左にある「ビュー識別子」をクリックします。
次の図は、「アイテム・ファインダ」に表示されたデバッグ・レポートを示しています。

図debug_report.gifの説明

6. 最も時間がかかったステップを表示するには、レポートの上のグラフのステップにカーソルを合わせます。
ステップの詳細が表示されます。

7. レポートのそのステップに移動するには、棒グラフをクリックします。

注意:
レポートにリストされているデバッグ・セッションは最低2週間存続し、アクティビティ・ログと一緒にエージ・アウトされます。これは通常、デバッグ目的では十分な期間です。

SQLトレースの有効化およびTKPROFの使用

セッションをトレースすると、アプリケーションを効率的にデバッグできます。データベースの観点では、各ページ・リクエストが単一のデータベース・セッションとみなされます。SQLトレースを有効にすると、Oracle Application Expressによって一時ファイルが作成されます。このファイルは、TKPROFユーティリティを使用して解析できます。

Oracle Application ExpressでSQLトレースを有効にするには、f?p構文を使用して引数p_trace=YESを設定します。たとえば、アプリケーション100の1ページ目の表示をトレースするには、次の構文を使用します。

http:/.../f?p=100:1&p_trace=YES

TKPROFユーティリティを使用するには、次の操作を実行します。

1. 権限を付与されたユーザーとしてSQL*Plusにログインします。

2. 次の文を実行します。

show parameter USER_DUMP_DEST

3. トレース・ファイルが作成されたディレクトリにナビゲートします。

4. 次の構文を使用して、オペレーティング・システムのプロンプトでTKPROFユーティリティを実行します。

tkprof filename1 filename2 [waits=yes|no] [sort=option] [print=n]
[aggregate=yes|no] [insert=filename3] [sys=yes|no] [table=schema.table]
[explain=user/password] [record=filename4] [width=n]

必要な引数は、入力ファイルと出力ファイルのみです。

5. オンライン・ヘルプを表示するには、引数なしでTKPROFを起動します。

関連項目:
TKPROFプログラムの使用の詳細は、Oracle Databaseパフォーマンス・チューニング・ガイドのアプリケーション追跡ツールの使用に関するセクションを参照してください。

アプリケーションとページのリソース使用の監視

Oracle Application Expressでは、パッケージDBMS_APPLICATION_INFOをコールして、アプリケーションおよびページで使用されるリソースを簡単に監視できます。Application Expressエンジンがページをレンダリングまたは処理すると、モジュールがAPEXに設定され、アプリケーションIDおよびページ番号が含められます。設定後は、V$SESSIONおよびV$SQLAREAビューを問い合せて、トランザクションを監視できます。

ページ・レポートの表示

ページ内の問題を特定する場合は、ページで実行されているファンクションを明確に理解している必要があります。このために、アプリケーション・ビルダーには多数のページおよびアプリケーションのレポートが含まれています。

「アプリケーション・ダッシュボード」レポートの表示

「アプリケーション・ダッシュボード」は、アプリケーションについての様々な視点からの包括的なビューを提供します。このダッシュボードを使用して統計を表示したり、セキュリティ設定のレポートや、ページおよびアプリケーションのコンポーネントおよびテンプレートのレポートにアクセスできます。

アプリケーション・ダッシュボードを表示するには、次のステップを実行します。

1. 「ワークスペース」ホームページにナビゲートします。

2. 「アプリケーション・ビルダー」アイコンをクリックします。

3. アプリケーションを選択します。
「アプリケーション」ホームページが表示されます。

4. 「ユーティリティ」をクリックします。

5. 「アプリケーション・ダッシュボード」をクリックします。
アプリケーション・ダッシュボードが表示されます。左側にある最初の2つのリージョン(「アプリケーション概要」と「タイプ別の表示」)に現在のアプリケーションについての詳細情報と統計がリストされます。残りのリージョンは、次のセクションに分割されます。

- セキュリティ: 現在の認証スキーム、パブリック・ページと非パブリック・ページの数およびカレント・アプリケーション内で使用される認可スキームの数が表示されます。

- テンプレート: カレント・アプリケーション内で使用されるテンプレートのレポートへのリンクが表示されます。

- タイプ別の表示: ページがタイプ別に表示されます。

- アプリケーション・コンポーネント: アプリケーション・レベルのコントロールとロジックのレポート(LOV、タブ、リスト、アプリケーション・アイテム、アプリケーション・プロセス、アプリケーションの計算など)へのリンクが表示されます。

- ページ・コンポーネント: ページ・レベルのコントロールとロジックのレポート(アイテム、ボタン、プロセス、リージョン、ブランチ、検証、動的アクションなど)へのリンクが表示されます。

6. 特定のレポートを表示するには、コンポーネント・タイプまたはテンプレートの右にある数字をクリックします。

問題のあるSQL問合せのデバッグ

問合せが正常に実行されていない可能性がある場合、SQL*Plus、SQL DeveloperまたはSQLコマンドでの実行を試してください。いずれの方法でも、アプリケーションのコンテキスト外で問合せがテストされるため、問題を簡単に判別できます。

コントロールおよびコンポーネントの削除による問題の特定

ページを正常に実行できない場合は、コントロールとコンポーネントを一度に1つずつ削除することをお薦めします。この方法を使用すると、問題の原因となっている可能性があるコントロールまたはコンポーネントを迅速に判別できます。条件属性「なし」を選択すると、コントロールまたはコンポーネントを無効にできます。

条件付き属性を使用してコントロールまたはコンポーネントを削除するには、次のステップを実行します。

1. 該当する「ページ定義」にナビゲートします。「「ページ定義」へのアクセス」を参照してください。

2. 無効にするコントロールまたはコンポーネントの名前を選択します。
該当する属性ページが表示されます。

3. 「条件タイプ」が表示されるまでスクロールして、「条件タイプ」リストから「なし」を選択します。

4. 「変更の適用」をクリックして、「ページ定義」に戻ります。

5. ページを再度実行します。

6. ページが正常に実行されるまで、コントロールまたはコンポーネントの削除を続けます。

関連項目:
「「ページ定義」へのアクセス」、「コンポーネント・ビューでのページの編集」、「条件付きのレンダリングおよびプロセスの理解」および「アプリケーションまたはページの実行」

15 アプリケーション・セキュリティの管理

このセクションでは、Oracle Application Expressにセキュリティのベスト・プラクティスを実装する方法を説明します。管理者は、Oracle Application Expressインストールのセキュリティを保証する必要があります。開発者は、セキュアなアプリケーションを構築する必要があります。

内容は次のとおりです。

- セキュリティに関する管理者のベスト・プラクティスの理解

- セキュリティに関する開発者のベスト・プラクティスの理解

- ファイルのアップロードの保護

- 認証によるユーザー・アイデンティティの証明

- 認可を介したセキュリティの提供

関連項目:
「アプリケーション・ビルダーの概念」および「アプリケーション・ビルダーの使用」

セキュリティに関する管理者のベスト・プラクティスの理解

このセクションでは、Oracle Application Express管理者のためのセキュリティのベスト・プラクティスについて説明します。

内容は次のとおりです。

- 埋込みPL/SQLゲートウェイを使用する場合のセキュリティに関する考慮事項

- Oracle Application Expressでのmod_plsqlを使用したOracle HTTP Serverの構成について

- Secure Sockets Layer(SSL)の使用

- Oracle BI Publisherとの統合

- パスワードの複雑性ルールの設定について

- Oracle Application Expressランタイム環境の利点

- セッション・タイムアウトの理解

- Oracle Database 11gおよびOracle Database 12cのネットワーク・サービスの有効化

埋込みPL/SQLゲートウェイを使用する場合のセキュリティに関する考慮事項

埋込みPL/SQLゲートウェイは、XML DB HTTP Protocol Listenerの一部としてデータベースで実行されます。XML DB HTTP Protocol Listenerおよび埋込みPL/SQLゲートウェイには、Oracle HTTP Serverおよびmod_plsqlと同等の主要機能があります。HTTPリスナーは、Oracle Application Expressがインストールされているデータベースと同じデータベースで実行されるため、HTTPリスナーをデータベースから分けることはできません。このため、インターネット上で実行されるアプリケーションには、埋込みPL/SQLゲートウェイを使用しないことをお薦めします。また、埋込みPL/SQLゲートウェイでは、mod_plsqlを使用するOracle HTTP Serverほどに柔軟な構成および詳細なログは提供されません。

Oracle Application Expressでのmod_plsqlを使用したOracle HTTP Serverの構成について

Oracle HTTP Serverは、mod_plsqlプラグインを使用してOracle Database内のOracle Application Expressエンジンと通信します。mod_plsqlファンクションは、WebサーバーとOracle Database内のOracle Application Expressエンジン間の通信ブローカとして機能します。

mod_plsqlの各リクエストは、Database Access Descriptor(DAD)というデータベースにアクセスする際に使用する一連の構成値に関連付けられます。mod_plsqlには、リクエストされたプロシージャのさらなる処理を許可または禁止することができるPlsqlRequestValidationFunctionというDADパラメータがあります。このパラメータを使用すると、DADからの実行の許可対象にしないパッケージおよびプロシージャのコールをブロックすることで、PL/SQLアプリケーションにさらに強力なセキュリティを実装できます。Oracle Application ExpressのDAD構成では、PlsqlRequestValidationFunctionディレクティブに値wwv_flow_epg_include_modules.authorizeを使用することをお薦めします。

PlsqlRequestValidationFunctionパラメータの目的は、mod_plsqlによってどのプロシージャが起動されるかを制御することです。デフォルトでは、Oracle Application Expressのパブリックなエントリ・ポイントのみが許可されます。これは、Oracle Application Expressに付属する検証ファンクションを使用して拡張できます。詳細は、『Oracle Application Express管理ガイド』のデータベース・アクセス記述子(DAD)によるOracle Application Expressへのアクセスの制限に関する説明を参照してください。

Secure Sockets Layer (SSL)の使用

Secure Sockets Layer(SSL)は、インターネット上に転送されるデータのセキュリティを管理するためのプロトコルです。SSLは、HTTPSプロトコルを使用してWebアプリケーションに実装されます。機密データが暗号化されていない(クリアテキストの)通信チャネルに送信されないように、SSL (HTTPSプロトコル)を使用してOracle Application Expressアプリケーションを実行することをお薦めします。

Oracle Application Express管理サービスのセキュリティ設定ページで「HTTPSが必要」属性を「はい」に設定すると、Oracle Application Expressインスタンスとすべての関連アプリケーションで、HTTPSを要求できます。

「HTTPSが必要」属性を「はい」に設定してログアウトすると、プロトコルにHTTPSが使用されないかぎり、Oracle Application Express管理サービスおよびOracle Application Expressワークスペースに開発者または管理者としてログインできなくなります。

関連項目:
Oracle Application Express管理ガイドの「HTTPSの必要性」

Oracle BI Publisherとの統合

Oracle Application ExpressとOracle BI Publisherを統合する場合は、Secure Sockets Layer(SSL)を使用することをお薦めします。Oracle BI Publisherサーバー用にSSL(HTTPSプロトコル)を構成したら、ウォレットを作成して、内部管理環境設定でレポート・サーバーにHTTPSプロトコルを指定する必要があります。

関連項目:
Oracle Application Express管理ガイドの「ウォレット情報の構成」および「レポート出力の構成」

パスワードの複雑性ルールの設定について

ワークスペースの管理者および開発者は、Oracle Application Expressの開発環境にログインし、ワークスペース内で開発されたアプリケーションに対するエンド・ユーザーの認証を行うためのユーザー・アカウントを作成できます。Oracle Application Express管理者は、これらのアカウントのパスワードに対して、パスワードの複雑性ルール(またはポリシー)を作成できます。これらのルールは、全ワークスペースで、インストールのすべてのアカウントに適用されます。

次に、パスワードの複雑性ポリシーの例を示します。

すべてのパスワードには、次が含まれている必要があります。

- 1つ以上の大文字。

- 1つ以上の数字。

- 6つ以上の文字。

他にも多くのバリエーションが考えられることに注意してください。各Oracle Application Expressインスタンスに対して、管理者がパスワードの複雑性ポリシーを作成することをお薦めします。詳細は、『Oracle Application Express管理ガイド』のすべてのワークスペースに対するログイン制御の有効化に関する説明、厳密なパスワード・ポリシーに関する説明およびワークスペースに対するログイン制御の有効化に関する説明を参照してください。

パスワードの再利用の制限

サイト管理者は、すべての管理者アカウント、開発者アカウントおよびエンド・ユーザー・アカウントに対し、そのアカウントに以前使用されたパスワードの履歴に基づいて、パスワードの再利用を制限することができます。

パスワードの再利用を制限するには、次のステップを実行します。

1. SQL*Plusを起動して、Oracle Application Expressがインストールされたデータベースに、apex_administrator_roleロールを使用するか、SYSDBAロールを指定するSYSとして接続します。次に例を示します。

- Windowsの場合:

SYSTEM_DRIVE:\ sqlplus /nolog
SQL> CONNECT SYS as SYSDBA
Enter password: SYS_password

- UNIXおよびLinuxの場合:

$ sqlplus /nolog
SQL> CONNECT SYS as SYSDBA
Enter password: SYS_password

ヒント:
APEX_ADMINISTRATOR_ROLEは、別のデータベース・ロールを介してではなく、ユーザーに直接付与される必要があります。

2. 次の文を実行します。

ALTER SESSION SET CURRENT_SCHEMA = APEX_040200;

3. 次の文を実行します。

BEGIN
APEX_INSTANCE_ADMIN.SET_PARAMETER('PASSWORD_HISTORY_DAYS',365);
COMMIT;
END;
/

これによって、作成または更新するパスワードは、過去365日間にそのアカウント用として使用されていないものに制限されます。以前に使用されたパスワード(実際は、パスワードのハッシュ表現)は、Oracle Application Expressをインストールしたときから記録されます。

4. この機能を無効にするには、パラメータ値に0を指定して前述のブロックを実行します。次に例を示します。

BEGIN
APEX_INSTANCE_ADMIN.SET_PARAMETER('PASSWORD_HISTORY_DAYS',0);
COMMIT;
END;
/

ヒント:
開発者は、Oracle Application Express APIリファレンスに記載されているAPEX_UTIL.STRONG_PASSWORD_CHECKプロシージャおよびAPEX_UTIL.STRONG_PASSWORD_VALIDATIONファンクションも使用することができます。

Oracle Application Expressランタイム環境の利点

Oracle Application Expressのランタイム環境では本番アプリケーションを実行できますが、管理用のWebインタフェースは使用できず、これらのアプリケーションを直接開発することはできません。

機密の本番Oracle Application Expressアプリケーションは、Oracle Application Expressのランタイム・インストールで実行することをお薦めします。ランタイム・インストールでは、Webベースのアプリケーション開発環境が使用されないため、アプリケーション・ビルダー、SQLワークショップおよび本番インストールに関係するユーティリティが使用できません。また、ランタイム環境に含まれるのは、アプリケーションの実行に必要なOracle Application Expressデータベース・オブジェクトおよび権限のみであるため、より堅牢な環境になります。

関連項目:
Oracle Application Express管理ガイドの「ランタイム環境の管理」

セッション・タイムアウトの理解

「セッション・タイムアウト」属性を構成すると、アプリケーションの公開を抑制できます。ユーザーは、長時間コンピュータを操作しなかったり、アプリケーションを終了せずにコンピュータの元を離れることが頻繁にあります。このため、アプリケーションのユーザー・アイデンティティが、権限のないユーザーによって簡単に引き継がれる可能性があります。セッション・タイムアウトおよびアイドル・タイムアウトを設定すると、指定したタイムアウトの後、ユーザーは自動的にアプリケーションからログアウトされます。

「セッション・タイムアウト」属性には、次のものがあります。

- 最大セッションの長さ

- セッション・タイムアウトURL

- 最大セッション・アイドル時間

- アイドル・タイムアウトURL

アプリケーション・レベルでのこれらの属性の構成の詳細は、「セッション・タイムアウト」を参照してください。Oracle Application Expressインスタンス全体でのこれらの属性の構成の詳細は、Oracle Application Express管理ガイドの「セッション・タイムアウトの構成」を参照してください。

Oracle Database 11gおよびOracle Database 12cのネットワーク・サービスの有効化

Oracle Database 11gおよびOracle Database 12cでは、ネットワーク・サービスとの通信機能がデフォルトで無効になっています。このため、Oracle Database 11gおよびOracle Database 12cでOracle Application Expressを実行する場合は、新しいDBMS_NETWORK_ACL_ADMINパッケージを使用して、APEX_040200データベース・ユーザーにすべてのホストに対する接続権限を付与する必要があります。これらの権限を付与しないと、次の場合に問題が発生します。

- Oracle Application Expressによる外部への電子メールの送信
ユーザーはAPEX_MAILパッケージからメソッドをコールできますが、外部へ電子メールを送信するときに問題が発生します。

- Oracle Application Express内のWebサービスの使用

- PDF/レポートの印刷

内容は次のとおりです。

- ホストへの接続権限の付与

- ローカル・ホストへの接続権限の付与

- 無効なACLエラーのトラブルシューティング

ヒント:
この項で説明されている例を実行するには、データベースのcompatible初期化パラメータを少なくともOracle Database 11.1.0.0.0に設定する必要があります。Oracle Database 11gデータベースではデフォルトでパラメータが正しく設定されますが、以前のバージョンから11gにアップグレードされたデータベースでは正しく設定されていない場合があります。データベースの初期化パラメータの変更の詳細は、Oracle Database管理者ガイドのOracle Databaseの作成と構成に関する項を参照してください。

ホストへの接続権限の付与

次の例では、APEX_040200データベース・ユーザーにホストに対する接続権限を付与する方法が示されています。

DECLARE
ACL_PATH  VARCHAR2(4000);
BEGIN
-- Look for the ACL currently assigned to '*' and give APEX_040200
-- the "connect" privilege if APEX_040200 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_040200',
'connect') IS NULL THEN
DBMS_NETWORK_ACL_ADMIN.ADD_PRIVILEGE(ACL_PATH,
'APEX_040200', 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_040200', TRUE, 'connect');
DBMS_NETWORK_ACL_ADMIN.ASSIGN_ACL('power_users.xml','*');
END;
/
COMMIT;

ローカル・ホストへの接続権限の付与

次の例は、ローカル・ホスト上のリソースへのアクセス方法について、より低い権限で実行するデモンストレーションです。この例では、サーバーもローカル・ホスト上にある場合は、電子メールおよびPDFの印刷を有効化する可能性があります。

DECLARE
ACL_PATH  VARCHAR2(4000);
BEGIN
-- Look for the ACL currently assigned to 'localhost' and give APEX_040200
-- the "connect" privilege if APEX_040200 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_040200',
'connect') IS NULL THEN
DBMS_NETWORK_ACL_ADMIN.ADD_PRIVILEGE(ACL_PATH,
'APEX_040200', 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_040200', TRUE, 'connect');
DBMS_NETWORK_ACL_ADMIN.ASSIGN_ACL('local-access-users.xml','localhost');
END;
/
COMMIT;

無効なACLエラーのトラブルシューティング

前述のスクリプトの実行後に「ORA-44416: 無効な ACL」エラーを受信したら、次の問合せを使用して無効なACLを識別します。

REM Show the dangling references to dropped users in the ACL that is assigned
REM to '*'.

SELECT ACL, PRINCIPAL
FROM DBA_NETWORK_ACLS NACL, XDS_ACE ACE
WHERE HOST = '*' AND LOWER_PORT IS NULL AND UPPER_PORT IS NULL AND
NACL.ACLID = ACE.ACLID AND
NOT EXISTS (SELECT NULL FROM ALL_USERS WHERE USERNAME = PRINCIPAL);

次に、次のコードを実行してACLを修正します。

DECLARE
ACL_ID   RAW(16);
CNT      NUMBER;
BEGIN
-- Look for the object ID of the ACL currently assigned to '*'
SELECT ACLID INTO ACL_ID FROM DBA_NETWORK_ACLS
WHERE HOST = '*' AND LOWER_PORT IS NULL AND UPPER_PORT IS NULL;

-- If just some users referenced in the ACL are invalid, remove just those
-- users in the ACL. Otherwise, drop the ACL completely.
SELECT COUNT(PRINCIPAL) INTO CNT FROM XDS_ACE
WHERE ACLID = ACL_ID AND
EXISTS (SELECT NULL FROM ALL_USERS WHERE USERNAME = PRINCIPAL);

IF (CNT > 0) THEN

FOR R IN (SELECT PRINCIPAL FROM XDS_ACE
WHERE ACLID = ACL_ID AND
NOT EXISTS (SELECT NULL FROM ALL_USERS
WHERE USERNAME = PRINCIPAL)) LOOP
UPDATE XDB.XDB$ACL
SET OBJECT_VALUE =
DELETEXML(OBJECT_VALUE,
'/ACL/ACE[PRINCIPAL="'||R.PRINCIPAL||'"]')
WHERE OBJECT_ID = ACL_ID;
END LOOP;

ELSE
DELETE FROM XDB.XDB$ACL WHERE OBJECT_ID = ACL_ID;
END IF;

END;
/

REM commit the changes.

COMMIT;

ACLの修正後、このセクションの最初のスクリプトを実行してAPEX_040200ユーザーにACLを適用する必要があります。「ホストに対する接続権限の付与」を参照してください。

セキュリティに関する開発者のベスト・プラクティスの理解

このセクションでは、Oracle Application Express開発者のためのセキュリティのベスト・プラクティスについて説明します。

内容は次のとおりです。

- タイプ・パスワードのアイテムの理解

- 問題を引き起こす可能性のあるパスワード・アイテムの識別

- クロスサイト・スクリプティング保護の理解

- セッション・ステートおよびセキュリティについて

- セッション・ステート保護の理解

タイプ・パスワードのアイテムの理解

パスワード・アイテムは、Webブラウザ画面に入力されたテキストを表示しません。パスワード・アイテムを作成するときは、セッション・ステートを保存しないパスワード属性を使用することをお薦めします。これによって、パスワードがセッション・ステート表のデータベースに保存されるのを回避できます。

設定可能なパスワード・アイテム・タイプ属性は、次のとおりです。

- 必須の値: 「はい」に設定し、ページ・アイテムが表示されている場合、Oracle Application Expressでは、ページの送信時にNOT NULL検証が自動的に実行されます。「いいえ」に設定すると、検証が行われず、NULL値が受け入れられます。

- [Enter]を押すと送信: 「はい」に設定した場合、ユーザーがフィールドで[ENTER]キーを押すと、ページが送信されます。

- 状態を保存しない: 「はい」に設定すると、パスワードがセッション・ステートに保存されません。セキュリティ上の理由により、この属性は常に「はい」に設定する必要があります。「いいえ」に設定する場合は、「セッション・ステートに暗号化された値を保存」属性を「はい」に設定することを考慮してください。

- 認可スキーム: オプションで認可スキームを選択します。このコンポーネントをレンダリングまたは処理するためには、この認可スキームがTRUEと評価される必要があります。

- セッション・ステート保護: この属性を「制限なし」または「制限付き」に設定して、セッション・ステート保護のレベルを選択できます。

- 制限なし: URLまたはフォームでアイテムを渡して、アイテムを設定できます。URLにチェックサムは必要ありません。

- 制限付き: アイテムをブラウザから設定することはできません。アイテムの値を内部プロセス、計算などに設定できる方法を制限する場合は、このオプションを使用します。この属性は、データ・エントリ・アイテムとして使用できないアイテムのみに適用され、「セッション・ステート保護」が無効になっていても常に監視されます。

- セッション・ステートに暗号化された値を保存: 機密のセッション・ステートは、Application Expressセッション・ステート管理表に格納するときに暗号化することができます。このアイテムの暗号化されたセッション・ステートを保持するには、この値を「はい」に設定します。詳細は、「セッション・ステートおよびセキュリティについて」を参照してください。

関連項目:
「アイテム・タイプについて」および「ページ・レベル・アイテムの編集」

問題を引き起こす可能性のあるパスワード・アイテムの識別

問題を引き起こす可能性のあるパスワード・アイテムは、次のいずれかです。

- セッション・ステートを保存しないパスワード・アイテム・タイプを使用しないもの

- 暗号化していない値をセッション・ステートに格納するもの

問題を引き起こす可能性のあるパスワード・アイテムを識別するには、「セキュリティ・プロファイル」および「パスワード・アイテム」レポートを使用します。

内容は次のとおりです。

- 「セキュリティ・プロファイル」レポートの表示

- 「パスワード・アイテム」レポートの表示

「セキュリティ・プロファイル」レポートの表示

「セキュリティ・プロファイル」レポートを表示するには、次のステップを実行します。

1. 「ワークスペース」ホームページにナビゲートします。

2. 「アプリケーション・ビルダー」アイコンをクリックします。
「アプリケーション・ビルダー」ホームページが表示されます。

3. 「タスク」リストで「アプリケーション間レポート」をクリックします。

4. 「セキュリティ」で、「セキュリティ・プロファイル」レポートをクリックします。
このレポートには、現在のワークスペース内のすべてのアプリケーションに関する次の情報が表示されます。

- アプリケーション

- 名前

- 解析対象スキーマ

- アプリケーション・レベル認可スキーム

- 認証

- 認可スキーム

- 認可スキーム

- ページ

- 暗号化アイテム

- 問題を引き起こす可能性のあるパスワード・アイテム

「パスワード・アイテム」レポートの表示

問題を引き起こす可能性のあるパスワード・アイテムを識別するには、次のステップを実行します。

1. 「ワークスペース」ホームページにナビゲートします。

2. 「アプリケーション・ビルダー」アイコンをクリックします。
「アプリケーション・ビルダー」ホームページが表示されます。

3. 「タスク」リストで「アプリケーション間レポート」をクリックします。

4. 「セキュリティ」で、「パスワード・アイテム」をクリックします。
「パスワード・アイテム」レポートには、アプリケーション内にあるすべてのパスワード・アイテムが、暗号化を使用するかどうかおよびステートを保存するかどうかとともに表示されます。いずれも行わないパスワード・アイテムは、「問題を引き起こす可能性」とハイライトされます。

ヒント:
パスワード・アイテムを含むページで、ページ属性「フォームのオートコンプリート」を「オフ」に設定します。この属性を「オフ」に設定すると、Webブラウザによって、ページでアイテムのオートコンプリートが試行されなくなります。

クロスサイト・スクリプティング保護の理解

クロスサイト・スクリプティング(XSS)は、動的に生成されるWebページを利用するセキュリティ攻撃です。XSS攻撃では、ユーザーのブラウザに読み込まれたときにアクティブになるスクリプトがWebアプリケーションに送信されます。これらのスクリプトがアクティブになると、データまたは場合によってはセッション資格証明が盗まれ、それらの情報が攻撃者に送信される可能性があります。

悪意のあるコードがOracle Application Expressアプリケーションに侵入すると、通常のページ・レンダリング時に、そのコードがアプリケーション内のHTMLリージョンや他の場所にレンダリングされる可能性があります。セッション・ステートへの不正なコードの挿入を阻止するため、Application Expressエンジンは特定の場合に文字をエスケープします。

内容は次のとおりです。

- HTMLリージョンなどの静的領域の保護

- 動的出力の保護

- レポート・リージョンの保護

- フォーム・アイテムの保護

- アイテムで入力される文字の制限

HTMLリージョンなどの静的領域の保護

HTMLリージョンなどの静的表示領域では、&ITEM.表記法を使用してセッション・ステートを参照できます。静的表示領域の例には、HTMLリージョン、ページのヘッダーとフッター、リージョンのヘッダーとフッター、リージョン・タイトル、ボタン・ラベル、ヘルプ・テキスト、フォーム・アイテム・ラベルおよび要素の後のテキスト、テンプレート、(フィールド・テキストの前後の)ラジオ・グループ、イベント成功メッセージ、イベント・エラー・メッセージ、ナビゲーション・バー属性、アプリケーション静的置換文字列値、チャート・ラベルおよび凡例、ブレッドクラムおよびリスト・フレーム・テキスト、カレンダ・テキスト、ラベル、凡例などがあります。

安全なアイテム表示タイプについて

セッション・ステートがこのように参照される場合、ページに表示される値には、参照されるアイテムが「表示のみ」で「セッション・ステートの保存」属性が「いいえ」に設定されている場合にエスケープされる特殊文字(<、>、&、")が含まれません。

参照されるアイテムに「セッション・ステートの保存」属性が「いいえ」に設定されている「表示のみ」以外の表示タイプが含まれている場合、ページに表示される値には、エスケープされる特殊文字が含まれます。また、アプリケーション・レベルのアイテムには、安全な表示タイプが含まれているとみなされますが、実際にフォーム・アイテムに含まれているような表示プロパティは含まれていません。

関連項目:
「ページ・レベル・アイテムの理解」

値をエスケープするかどうかを決定するために使用されるルールについて

Application Expressエンジンは、事前定義済のスマート・エスケープ・ルールを使用して、セッション・ステートからフェッチされた値をエスケープするかどうか、およびいつそれを実行するかを決定します。

このルールを使用するのは、前にリストした表示タイプを使用したアイテムは、通常フィルタ処理(エスケープ)されずにブラウザに表示されることを意図したHTMLを含むテキスト用であるためです。安全に行われる方法は、これらのタイプのアイテムが常にエスケープされてアプリケーションに入力されるルールを実施する以外にありません。たとえば、ユーザーが、Oracle Application Expressのf?p URL構文を使用して、一部のテキストを安全なアイテムに渡す場合、Application Expressエンジンは値をセッション・ステートに保存する際に特殊文字をエスケープします。これにより次の2つの結果が予想されます。

1. 値に特殊文字が含まれていなかった場合、渡された値は指定されたとおりにセッション・ステートに保存される。

2. 値に特殊文字が含まれていた場合、値をセッション・ステートに保存する際に特殊文字をエスケープする。

いずれの状況でも、アイテムは、現在、前述のHTMLリージョンなどの静的領域で&ITEM.表記法を使用して安全に参照できます。

安全なアイテム・タイプを使用したHTMLマークアップの保持および表示

前にリストした安全なアイテム・タイプを使用して、ブラウザにHTMLマークアップを保持および表示します。たとえば、安全なページ・アイテムP1_XXX(&P1_XXXを使用)を参照して、太字で一部のテキストをレンダリングする要件があるとします。アイテムP1_XXXには次のHTMLが含まれているとします。

<b>ABABABAB</b>

実行するには、アプリケーション・コントロール(計算、プロセス、アイテムのソース式、アイテムのデフォルト値など)を使用して、値をこれらの安全なアイテムに格納します。値をこのように挿入する場合は、コンテンツの安全性を確認します。これらの方法を使用する場合、Application Expressエンジンは、値をセッション・ステートに保存する際に特殊文字をエスケープしません。

安全なアイテムの安全性は、最終的に、アイテムがページにポストされず、ページ送信の一部としてApplication Expressエンジンに発行されないルールによって確認されます。

動的出力の保護

htp.pなどの方法を使用してセッション・ステートからフェッチし、レンダリングするアイテムは、必要に応じてコードで明示的にエスケープする必要があります。たとえば、ページ上のPL/SQL動的コンテンツ・リージョンで次を使用するとします。

htp.p(v('SOME_ITEM'));

セッション・ステートからフェッチするアイテムの値に予期しないタグやスクリプトが含まれる可能性がある場合は、リージョンで次を使用できます。

htp.p(apex_escape.html(:SOME_ITEM));

ただし、フェッチする値を安全にレンダリングできることが確かな場合は、この値をエスケープする必要はありません。開発者は、出力をエスケープしない方が適切な場合を判断する必要があります。

次のように、このルールに従うことをお薦めします。

- アイテムが「安全なアイテム表示タイプについて」に示される安全なタイプでないかぎり、エスケープせずにセッション・ステートからフェッチされたアイテムを表示しないでください。

これを行うのは、開発者としてハッカーが悪意ある値を安全ではないアイテムにポストするのを防ぐ方法はないためです。アプリケーションがこれらのアイテムを一般ユーザーに見えるように表示しなくても、このルールに従わないと、ハッカーはアプリケーションを使用してXSS攻撃をマウントできることに注意してください。

レポート・リージョンの保護

Application Expressエンジンは、レポートのボディでレンダリングされるデータをエスケープします。レポートのヘッダーおよびメッセージにおけるセッション・ステートへの参照は、安全なアイテム・タイプの値はエスケープされず、その他のアイテム・タイプの値はエスケープされるように、スマート・エスケープ・ルールを使用してセッション・ステートからフェッチされます。

フォーム・アイテムの保護

ブラウザに送信されるフォーム・ページの生成中に、フォーム・アイテム(隠しアイテムなど)が値を取得する場合、結果テキストはレンダリング前にエスケープされます。一部の安全なアイテム・タイプは、各表示タイプの意図する動作をサポートするため、このルールにおける例外となります。

一部のアイテム・タイプは、「セキュリティ」リージョンに「特殊文字をエスケープ」属性があります。この属性を使用して、値をエスケープする必要があるかどうかを指定します。デフォルトでは「はい」に設定されています。HTMLコードを表示する場合は、この属性を「いいえ」に設定します。

アイテムで入力される文字の制限

ユーザーがアイテムで入力できる文字を制限することによって、クロスサイト・スクリプティングやその他のインジェクション攻撃を制限できます。これを行うには、ページ・アイテムの編集ページの「セキュリティ」リージョンの「制限付き文字」属性を使用します。

「制限付き文字」を使用して、セッション・ステートに保存可能な文字を制限します。使用可能なオプションは次のとおりです。

- - すべての文字を許可 -
制限は適用されません。

- a-Z、0-9と空白のホワイトリスト
文字a-z、A-Z、0-9および空白のみ許可されます。

- ブラックリストHTMLコマンド文字(<>")。
予約済のHTML文字は許可されません。

- ブラックリスト&<>"/;,*|=%および--
&、<、>、"、/、;、","、*、|、=、%および"--" (PL/SQLコメント)は許可されません。

- ブラックリスト&<>"/;,*|=%または--と改行
&、<、>、"、/、;、","、*、|、=、%、"--"、および改行文字は許可されません。

制限を選択した場合、選択した文字制限に準拠していないデータをユーザーが保存しようとすると、Oracle Application Expressによってエラー・メッセージが表示されます。

関連項目:
「ページ・アイテム・セキュリティの構成」

セッション・ステートおよびセキュリティについて

Oracle Application Expressは、データベース表にセッション・ステートを保持します。セッション・ステートがデータベース表で保持されるのは、サーバー側にセッション・ステートを格納すると、クライアント側に格納する場合よりセキュアになるためです。Oracle Application ExpressアプリケーションはステートレスHTTPプロトコルを使用するため、複数のページ・ビューにわたるアプリケーションのセッション・ステートがデータベース表に保持されます。各Oracle Application Expressアプリケーション・ユーザーの同期データベース接続を保持しない場合は、メモリーおよびデータベース・リソースの要件が大幅に削減されます。

開発者は、アプリケーション・ビルダーおよび組込みの監視ページを使用して、Oracle Application Expressアプリケーションによって格納されたセッション・ステートを問い合せることができます。開発者および管理者は、認証されているワークスペースのアプリケーションにアクセスできます。

開発者のベスト・プラクティスには、次のものが含まれます。

- プログラムの制御フローの標準的な実装の一環として、クリア・キャッシュ・ページ・プロセスまたはページへのナビゲートに使用されるURLのクリア・キャッシュ・ディレクティブを使用して不要な値のセッション・ステートをクリアします。

- ステートを保存しないパスワード・ページ・アイテム・タイプを使用します。これを使用すると、入力したパスワードがデータベースのセッション・ステート表に保存されません。

- セッションに機密データを保持する必要がある場合は、Oracle Application Expressのセッション・ステート表に暗号化した形式で保存する必要があります。この機能を使用するには、ページ・アイテムの「セッション・ステートに暗号化された値を保存」属性を「はい」に設定します。暗号化されて保存された値は、読取り時に自動的に複合化されます。

注意:
暗号化されたセッション・ステートの目的は、Oracle Application Expressのセッション・ステート表、デバッグ出力またはデータベース・データファイルへのアクセス権を持っている可能性のある他のOracle Application Express開発者やデータベース管理者に、暗号化された値が読み取られないようにするセッション・ステートを保持することです。データベースのバックアップを行う際は、バックアップ・ファイルでデータを暗号化する機能を使用することをお薦めします。

ヒント:
アイテム値は、最大で4000バイト長まで暗号化できます。4000バイトを超える値を暗号化しようとすると、エラー・メッセージが表示されます。

セッション・ステート保護の理解

セッション・ステート保護は、ハッカーがアプリケーション内のURLを改ざんするのを防ぐための組込み機能です。URL改ざんにより、プログラム・ロジック、セッション・ステートの内容および情報プライバシが悪影響を受ける可能性があります。

セッション・ステート保護は2ステップのプロセスで有効にします。最初に、この機能を有効にします。次に、ページおよびアイテムのセキュリティ属性を設定します。

内容は次のとおりです。

- セッション・ステート保護の仕組み

- セッション・ステート保護の有効化

- セッション・ステート保護の構成

セッション・ステート保護の仕組み

セッション・ステート保護を有効にすると、「ページ・アクセス保護」属性と「セッション・ステート保護」項目属性が、f?p= URL内に配置されたチェックサムとともに使用され、URL改ざんと、セッション・ステートに対する権限のないアクセスおよび変更が防止されます。セッション・ステート保護を無効にすると、セッション・ステート保護に関連するページ属性および項目属性が無視され、生成されるf?p= URLにはチェックサムが含まれません。

セッション・ステート保護の有効化

セッション・ステート保護は、セキュリティ属性の編集ページまたはセッション・ステート保護ページから有効にできます。

セッション・ステート保護は2ステップのプロセスで有効にします。最初に、この機能を有効にします。次に、ページおよびアイテムのセキュリティ属性を設定します。これらのステップは、ウィザードを使用して実行するか、セッション・ステート保護ページでページおよびアイテムのセキュリティ属性を手動で設定して行います。

内容は次のとおりです。

- 「セキュリティ属性の編集」からのセッション・ステート保護の有効化

- 「セッション・ステート保護」からのセッション・ステート保護の有効化

「セキュリティ属性の編集」からのセッション・ステート保護の有効化

セキュリティ属性の編集ページからセッション・ステート保護を有効にするには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」アイコンをクリックします。

4. 「セキュリティ」で、「セキュリティ属性」をクリックします。

5. 「セッション・ステート保護」までスクロールして、「セッション・ステート保護」リストの「有効」を選択します。

6. セッション・ステート保護を構成するには、「セッション・ステート保護の管理」をクリックします。
セッション・ステート保護ページが表示されます。

7. ウィザードを使用してセッション・ステート保護の有効化、無効化または構成を行うには、「保護の設定」をクリックします。

8. あるいは、適切なページまたはアイテム属性ページにナビゲートし、「セキュリティ」属性を設定します。

ヒント:
セッション・ステート保護を無効にするには、同じステップを再度実行しますが、「有効」のかわりに「無効」を選択します。セッション・ステート保護を無効にしても、既存のセキュリティ属性の設定は変更されませんが、実行時にはそれらが無視されます。

「ブックマークの無効化」ボタンについて

セッション・ステート保護を有効にすると、カレント・アプリケーションへのブックマーク・リンクが機能するかどうかに影響します。次の規則を考慮してください。

1. セッション・ステート保護を有効にした後に作成したブックマーク・リンクは、ブックマーク・リンクにチェックサムが含まれている場合に機能します。

2. セッション・ステート保護を有効にする前に作成したブックマーク・リンクは、ブックマーク・リンクにチェックサムが含まれている場合は機能しません。

3. チェックサムが含まれていないか、または不要なチェックサムが含まれているブックマークは、セッション・ステート保護の影響を受けません。

ページ・レンダリング時、Application Expressエンジンは、計算中に非表示のアプリケーション属性(チェックサムsalt)を使用し、f?p URLに含まれているチェックサムを確認します。セッション・ステート保護を有効にすると、Application Expressエンジンにチェックサムが含まれます。チェックサムsalt属性を再設定するには、セキュリティ属性の編集ページで「ブックマークの無効化」をクリックします。「ブックマークの無効化」をクリックすると、以前に生成されたチェックサムを含むアプリケーションへのアクセスに使用するブックマークURLが失敗することに注意してください。

「セッション・ステート保護」からのセッション・ステート保護の有効化

セッション・ステート保護を有効にするには、次のステップを実行します。

1. 共有コンポーネント・ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「セキュリティ」で、「セッション・ステート保護」を選択します。

セッション・ステート保護ページが表示されます。セッション・ステート保護の現行のステータス(有効または無効)がページ上部に表示されることに注意してください。

2. 「保護の設定」ボタンをクリックします。
「セッション・ステート保護」ウィザードが表示されます。

3. 「操作の選択」で、「有効化」を選択して、「次へ」をクリックします。
次に、ページおよびアイテムのセキュリティ属性を設定するかどうか決定します。

4. 「有効化」を選択して、「次へ」をクリックします。

5. 「セッション・ステート保護の有効化」をクリックします。

ヒント:
セッション・ステート保護を無効にするには、同じステップを実行しますが、「有効化」のかわりに「無効化」を選択します。セッション・ステート保護を無効にしても、既存のセキュリティ属性の設定は変更されませんが、実行時にはそれらが無視されます。

セッション・ステート保護の構成

セッション・ステート保護を有効にした後、セキュリティ属性を構成します。セキュリティ属性は2つの方法で構成できます。

- ウィザードを使用し、特定の属性カテゴリの値を選択する。この場合、選択内容がアプリケーション内のすべてのページおよびアイテムに適用されます。

- 個々のページ、アイテムまたはアプリケーション・アイテムの値を構成する。

内容は次のとおりです。

- 既存のセッション・ステート保護設定の確認

- ウィザードを使用したセッション・ステート保護の構成

- ページのセッション・ステート保護の構成

- ページ・アイテムのセッション・ステート保護の構成

- アプリケーション・アイテムのセッション・ステート保護の構成

ヒント:
セキュリティ属性を構成する前に、まずセッション・ステート保護を有効にする必要があります。「セッション・ステート保護の有効化」を参照してください。

既存のセッション・ステート保護設定の確認

「セッション・ステート保護」ウィザードの最初のページでは、ページ、アイテムおよびアプリケーション・アイテムのセッション・ステート保護設定のサマリーを確認できます。

既存のセッション・ステート保護設定のサマリーを表示するには、次のステップを実行します。

1. 「セッション・ステート保護」ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「セキュリティ」で、「セッション・ステート保護」を選択します。
セッション・ステート保護ページが表示されます。

2. 「保護の設定」をクリックします。

3. ページ下部で次のレポートを開きます。

- ページ・レベルのセッション・ステート保護サマリー

- ページ・アイテムのセッション・ステート保護サマリー

- アプリケーション・アイテムのセッション・ステート保護
図sess_state_summary.gifの説明

ウィザードを使用したセッション・ステート保護の構成

ウィザードを使用してセッション・ステート保護を構成するときは、特定の属性カテゴリの値を設定します。この場合、選択内容がアプリケーション内のすべてのページおよびアイテムに適用されます。

ウィザードを使用してセッション・ステート保護を構成するには、次のステップを実行します。

1. 「セッション・ステート保護」ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「セキュリティ」で、「セッション・ステート保護」を選択します。
セッション・ステート保護ページが表示されます。

2. 「保護の設定」をクリックします。
「セッション・ステート保護」ウィザードが表示されます。

3. 「操作の選択」で、「構成」を選択して、「次へ」をクリックします。

4. 「ページ・アクセス保護」で、次のいずれかを選択します。

- 制限なし: セッション・ステート引数(Request、Clear Cache、Name/Values)の有無にかかわらず、URLを使用してページを要求できます。

- 引数にチェックサムが必要: URLにRequest、Clear CacheまたはName/Value引数が表示されている場合は、チェックサムも提供する必要があります。チェックサム・タイプは、引数として渡されるすべてのアイテムの最も厳密なセッション・ステート保護属性と互換性がある必要があります。

- 引数使用不可: URLを使用してページを要求できますが、Request、Clear CacheまたはName/Value引数は許可されません。

- URLアクセスなし: URLを使用してページにアクセスできませんが、ページは、URLリダイレクトを行わない「ページにブランチ」ブランチ・タイプのターゲットにできます。

5. 「アプリケーション・アイテム保護」で、次のいずれかの項目を選択します。

- 制限なし: URLまたはフォームでアイテム名/値を渡して、アイテムのセッション・ステートを設定できます。URLにチェックサムは必要ありません。
注意: Ajaxを使用してこのアイテムの値をセッション・ステートに設定する必要がある場合は、アイテムに対して「制限なし」保護レベルを使用する必要があります(たとえば「動的アクション」の場合は、「値の設定」、「送信するページ・アイテム」または「カスケードLOV」、「送信するページ・アイテム」)。

- チェックサムが必要 - アプリケーション・レベル: スキーマ固有のチェックサムを入力する場合は、URLでアイテムの名前/値を渡して、アイテムのセッション・ステートを設定できます。ユーザー・レベル・チェックサムまたはセッション・レベル・チェックサムも使用できます(次の項目を参照)。現行のワークスペースの別のセッションで同じアプリケーションを実行しているユーザーが生成したチェックサムを含むURLによってのみ、このアイテムを設定できるようにする場合に、このオプションを使用します。

- チェックサムが必要: ユーザー・レベル: ワークスペース、アプリケーションおよびユーザー固有のチェックサムを入力する場合は、URLでアイテムの名前/値を渡して、アイテムのセッション・ステートを設定できます。セッション・レベル・チェックサムも使用できます(次の項目を参照)。現行のワークスペースの別のセッションで同じアプリケーションを実行しているユーザーが生成したチェックサムを含むURLによってのみ、このアイテムを設定できるようにする場合に、このオプションを使用します。

- チェックサムが必要: セッション・レベル: カレント・セッション固有のチェックサムも入力する場合は、URLでアイテムの名前/値を渡して、アイテムのセッション・ステートを設定できます。カレント・セッションで生成されたチェックサムを含むURLによってのみ、このアイテムを設定できるようにする場合に、このオプションを使用します。

- 制限付き - ブラウザから設定できない: URLまたはPOSTDATAを使用してアイテムを変更できません。アイテムの値を内部プロセス、計算などに設定できる方法を制限する場合は、このオプションを使用します。この属性は、データ・エントリ・アイテムとして使用できないアイテムのみに適用され、セッション・ステート保護が無効になっていても常に監視されます。
次の表示形式タイプのアプリケーション・アイテムまたはページ・アイテムについては、この属性を使用します。

- テキストとして表示(特殊文字をエスケープし、状態は保存しない)

- テキストとして表示(状態は保存しない)

- テキストとして表示(LOVに基づき、状態は保存しない)

- テキストとして表示(PL/SQLに基づき、状態は保存しない)

- テキスト・フィールド(無効、状態を保存しない)

- HTML表の停止および開始(ラベルのみ表示)

6. 「ページのデータ・エントリ・アイテム保護」で、次のいずれかの項目を選択します。

- 制限なし: URLまたはフォームでアイテム名/値を渡して、アイテムのセッション・ステートを設定できます。URLにチェックサムは必要ありません。
注意: Ajaxを使用してこのアイテムの値をセッション・ステートに設定する必要がある場合は、アイテムに対して「制限なし」保護レベルを使用する必要があります(たとえば「動的アクション」の場合は、「値の設定」、「送信するページ・アイテム」または「カスケードLOV」、「送信するページ・アイテム」)。

- チェックサムが必要 - アプリケーション・レベル: スキーマ固有のチェックサムを入力する場合は、URLでアイテムの名前/値を渡して、アイテムのセッション・ステートを設定できます。ユーザー・レベル・チェックサムまたはセッション・レベル・チェックサムも使用できます(次の項目を参照)。現行のワークスペースの別のセッションで同じアプリケーションを実行しているユーザーが生成したチェックサムを含むURLによってのみ、このアイテムを設定できるようにする場合に、このオプションを使用します。

- チェックサムが必要: ユーザー・レベル: ワークスペース、アプリケーションおよびユーザー固有のチェックサムを入力する場合は、URLでアイテムの名前/値を渡して、アイテムのセッション・ステートを設定できます。セッション・レベル・チェックサムも使用できます(次の項目を参照)。現行のワークスペースの別のセッションで同じアプリケーションを実行しているユーザーが生成したチェックサムを含むURLによってのみ、このアイテムを設定できるようにする場合に、このオプションを使用します。

- チェックサムが必要: セッション・レベル: カレント・セッション固有のチェックサムを入力する場合は、URLでアイテムの名前/値を渡して、アイテムのセッション・ステートを設定できます。カレント・セッションで生成されたチェックサムを含むURLによってのみ、このアイテムを設定できるようにする場合に、このオプションを使用します。

7. 「ページの表示専用アイテム保護」で、次のいずれかの項目を選択します。

- 制限なし: URLまたはフォームでアイテムの名前/値を渡して、アイテムを設定できます。URLにチェックサムは必要ありません。
注意: Ajaxを使用してこのアイテムの値をセッション・ステートに設定する必要がある場合は、アイテムに対して「制限なし」保護レベルを使用する必要があります(たとえば「動的アクション」の場合は、「値の設定」、「送信するページ・アイテム」または「カスケードLOV」、「送信するページ・アイテム」)。

- チェックサムが必要 - アプリケーション・レベル: スキーマ固有のチェックサムを入力する場合は、URLでアイテムの名前/値を渡して、アイテムのセッション・ステートを設定できます。ユーザー・レベル・チェックサムまたはセッション・レベル・チェックサムも使用できます(次の項目を参照)。現行のワークスペースの別のセッションで同じアプリケーションを実行しているユーザーが生成したチェックサムを含むURLによってのみ、このアイテムを設定できるようにする場合に、このオプションを使用します。

- チェックサムが必要: セッション・レベル: カレント・セッション固有のチェックサムを入力する場合は、URLでアイテムの名前/値を渡して、アイテムのセッション・ステートを設定できます。カレント・セッションで生成されたチェックサムを含むURLによってのみ、このアイテムを設定できるようにする場合に、このオプションを使用します。

- チェックサムが必要: ユーザー・レベル: ワークスペース、アプリケーションおよびユーザー固有のチェックサムを入力する場合は、URLでアイテムの名前/値を渡して、アイテムのセッション・ステートを設定できます。セッション・レベル・チェックサムも使用できます。現行のワークスペースの別のセッションで同じアプリケーションを実行しているユーザーが生成したチェックサムを含むURLによってのみ、このアイテムを設定できるようにする場合に、このオプションを使用します。

- 制限付き - ブラウザから設定できない: URLまたはPOSTDATAを使用してアイテムを変更できません。アイテムの値を内部プロセス、計算などに設定できる方法を制限する場合は、このオプションを使用します。この属性は、セッション・ステート保護が無効になっていても、常に監視されます。
次の表示形式タイプについては、この属性を使用します。

- テキストとして表示(特殊文字をエスケープし、状態は保存しない)

- テキストとして表示(状態は保存しない)

- テキストとして表示(LOVに基づき、状態は保存しない)

- テキストとして表示(PL/SQLに基づき、状態は保存しない)

- テキスト・フィールド(無効、状態を保存しない)

- HTML表の停止および開始(ラベルのみ表示)

8. 「次へ」をクリックします。

9. 「終了」をクリックします。

ページのセッション・ステート保護の構成

ページのセッション・ステート保護を構成するには、次のステップを実行します。

1. 「セッション・ステート保護」ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「セキュリティ」で、「セッション・ステート保護」を選択します。
セッション・ステート保護ページが表示されます。

2. 「ページ」アイコンをクリックします。

3. ページ上部の検索バーを使用してページの概観をカスタマイズできます。使用可能なコントロールは次のとおりです。

- 「検索」アイコン: 虫めがねに似ています。このアイコンをクリックして、検索を特定の列のみに絞ります。すべての列を検索するには、「すべての列」を選択します。

- テキスト領域: 大/小文字を区別しない検索基準(ワイルドカード文字は暗黙的に定義される)を入力し、「実行」をクリックします。

- 「実行」ボタン: 検索を実行したり、フィルタを適用します。

- 「チャートの表示」。このコントロールを使用して、情報をチャートで表示します。

- アクション・メニュー: アクション・メニューを表示します。このメニューを使用して、この対話モード・レポートをカスタマイズします。「「アクション」メニューについて」を参照してください。

4. ページ番号を選択します。
「ページおよびアイテム保護の設定」ページが表示されます。次の情報がページの上部に表示されます。

- アプリケーションIDおよび名前

- セッション・ステート保護のステータス(有効または無効)

- ページ番号

- ページ名

5. 「ページ・アクセス保護」で、次のいずれかを選択します。

- 制限なし: セッション・ステート引数(Request、Clear Cache、Name/Values)の有無にかかわらず、URLを使用してページを要求できます。

- 引数にチェックサムが必要: URLにRequest、Clear CacheまたはName/Value引数が表示されている場合は、チェックサムも提供する必要があります。チェックサム・タイプは、引数として渡されるすべてのアイテムの最も厳密なセッション・ステート保護属性と互換性がある必要があります。

- 引数使用不可: URLを使用してページを要求できますが、Request、Clear CacheまたはName/Value引数は許可されません。

- URLアクセスなし: URLを使用してページにアクセスできませんが、ページは、URLリダイレクトを行わない「ページにブランチ」ブランチ・タイプのターゲットにできます。

6. 「アイテム・タイプ」で、「データ・エントリ・アイテム」または「表示専用アイテム」を選択します。
データ・エントリ・アイテムは、フォームを使用して変更できるアイテムであり、非表示アイテムもこれに含まれます。表示専用アイテムはレンダリングされるだけで、フォームとともに送信されません。

7. 「データ・エントリ・アイテム」を選択した場合は、各アイテムのセッション・ステート保護レベルを選択します。

- 制限なし: URLまたはフォームでアイテム名/値を渡して、アイテムのセッション・ステートを設定できます。URLにチェックサムは必要ありません。
注意: Ajaxを使用してこのアイテムの値をセッション・ステートに設定する必要がある場合は、アイテムに対して「制限なし」保護レベルを使用する必要があります(たとえば「動的アクション」の場合は、「値の設定」、「送信するページ・アイテム」または「カスケードLOV」、「送信するページ・アイテム」)。

- チェックサムが必要 - アプリケーション・レベル: スキーマ固有のチェックサムを入力する場合は、URLでアイテムの名前/値を渡して、アイテムのセッション・ステートを設定できます。ユーザー・レベル・チェックサムまたはセッション・レベル・チェックサムも使用できます(次の項目を参照)。現行のワークスペースの別のセッションで同じアプリケーションを実行しているユーザーが生成したチェックサムを含むURLによってのみ、このアイテムを設定できるようにする場合に、このオプションを使用します。

- チェックサムが必要: ユーザー・レベル: ワークスペース、アプリケーションおよびユーザー固有のチェックサムを入力する場合は、URLでアイテムの名前/値を渡して、アイテムのセッション・ステートを設定できます。セッション・レベル・チェックサムも使用できます(次の項目を参照)。現行のワークスペースの別のセッションで同じアプリケーションを実行しているユーザーが生成したチェックサムを含むURLによってのみ、このアイテムを設定できるようにする場合に、このオプションを使用します。

- チェックサムが必要: セッション・レベル: カレント・セッション固有のチェックサムを入力する場合は、URLでアイテムの名前/値を渡して、アイテムのセッション・ステートを設定できます。カレント・セッションで生成されたチェックサムを含むURLによってのみ、このアイテムを設定できるようにする場合に、このオプションを使用します。

8. 「表示専用アイテム」を選択した場合は、各アイテムのセッション・ステート保護レベルを選択します。

- 制限なし: URLまたはフォームでアイテムの名前/値を渡して、アイテムを設定できます。URLにチェックサムは必要ありません。
注意: Ajaxを使用してこのアイテムの値をセッション・ステートに設定する必要がある場合は、アイテムに対して「制限なし」保護レベルを使用する必要があります(たとえば「動的アクション」の場合は、「値の設定」、「送信するページ・アイテム」または「カスケードLOV」、「送信するページ・アイテム」)。

- 制限付き - ブラウザから設定できない: URLまたはPOSTDATAを使用してアイテムを変更できません。アイテムの値を内部プロセス、計算などに設定できる方法を制限する場合は、このオプションを使用します。この属性は、セッション・ステート保護が無効になっていても、常に監視されます。次の表示形式タイプについては、この属性を使用します。

- テキストとして表示(特殊文字をエスケープし、状態は保存しない)

- テキストとして表示(状態は保存しない)

- テキストとして表示(LOVに基づき、状態は保存しない)

- テキストとして表示(PL/SQLに基づき、状態は保存しない)

- テキスト・フィールド(無効、状態を保存しない)

- HTML表の停止および開始(ラベルのみ表示)

- チェックサムが必要 - アプリケーション・レベル: スキーマ固有のチェックサムを入力する場合は、URLでアイテムの名前/値を渡して、アイテムのセッション・ステートを設定できます。ユーザー・レベル・チェックサムまたはセッション・レベル・チェックサムも使用できます(次の項目を参照)。現行のワークスペースの別のセッションで同じアプリケーションを実行しているユーザーが生成したチェックサムを含むURLによってのみ、このアイテムを設定できるようにする場合に、このオプションを使用します。

- チェックサムが必要: ユーザー・レベル: ワークスペース、アプリケーションおよびユーザー固有のチェックサムを入力する場合は、URLでアイテムの名前/値を渡して、アイテムのセッション・ステートを設定できます。セッション・レベル・チェックサムも使用できます(次の項目を参照)。現行のワークスペースの別のセッションで同じアプリケーションを実行しているユーザーが生成したチェックサムを含むURLによってのみ、このアイテムを設定できるようにする場合に、このオプションを使用します。

- チェックサムが必要: セッション・レベル: カレント・セッション固有のチェックサムを入力する場合は、URLでアイテムの名前/値を渡して、アイテムのセッション・ステートを設定できます。カレント・セッションで生成されたチェックサムを含むURLによってのみ、このアイテムを設定できるようにする場合に、このオプションを使用します。

9. 「変更の適用」をクリックします。

ページ・アイテムのセッション・ステート保護の構成

アイテムのセッション・ステート保護を構成するには、次のステップを実行します。

1. 「セッション・ステート保護」ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「セキュリティ」で、「セッション・ステート保護」を選択します。
セッション・ステート保護ページが表示されます。

2. 「ページ・アイテム」アイコンをクリックします。

3. ページ上部の検索バーを使用してページの概観をカスタマイズできます。使用可能なコントロールは次のとおりです。

- 「検索」アイコン: 虫めがねに似ています。このアイコンをクリックして、検索を特定の列のみに絞ります。すべての列を検索するには、「すべての列」を選択します。

- テキスト領域: 大/小文字を区別しない検索基準(ワイルドカード文字は暗黙的に定義される)を入力し、「実行」をクリックします。

- 「実行」ボタン: 検索を実行したり、フィルタを適用します。

- アクション・メニュー: アクション・メニューを表示します。レポート・ビューをカスタマイズするにはこのメニューを使用します。「「アクション」メニューについて」を参照してください。

4. ページ番号を選択します。
ページおよびアイテムのセッション・ステート保護の編集ページが表示されます。次の情報がページの上部に表示されます。

- アプリケーションIDおよび名前

- セッション・ステート保護のステータス(有効または無効)

- ページ番号

- ページ名

5. 「ページ・アクセス保護」で、各アイテムのセッション・ステート保護レベルを選択します。

- 制限なし: セッション・ステート引数(Request、Clear Cache、Name/Values)の有無にかかわらず、URLを使用してページを要求できます。

- 引数にチェックサムが必要: URLにRequest、Clear CacheまたはName/Value引数が表示されている場合は、チェックサムも提供する必要があります。チェックサム・タイプは、引数として渡されるすべてのアイテムの最も厳密なセッション・ステート保護属性と互換性がある必要があります。

- 引数使用不可: URLを使用してページを要求できますが、Request、Clear CacheまたはName/Value引数は許可されません。

- URLアクセスなし: URLを使用してページにアクセスできませんが、ページは、URLリダイレクトを行わない「ページにブランチ」ブランチ・タイプのターゲットにできます。

6. 「アイテム・タイプ」で、「データ・エントリ・アイテム」または「表示専用アイテム」を選択します。
データ・エントリ・アイテムは、フォームを使用して変更できるアイテムであり、非表示アイテムもこれに含まれます。表示専用アイテムはレンダリングされるだけで、フォームとともに送信されません。

7. 「データ・エントリ・アイテム」を選択した場合は、各アイテムのセッション・ステート保護レベルを選択します。

- 制限なし: URLまたはフォームでアイテム名/値を渡して、アイテムのセッション・ステートを設定できます。URLにチェックサムは必要ありません。
注意: Ajaxを使用してこのアイテムの値をセッション・ステートに設定する必要がある場合は、アイテムに対して「制限なし」保護レベルを使用する必要があります(たとえば「動的アクション」の場合は、「値の設定」、「送信するページ・アイテム」または「カスケードLOV」、「送信するページ・アイテム」)。

- チェックサムが必要 - アプリケーション・レベル: スキーマ固有のチェックサムを入力する場合は、URLでアイテムの名前/値を渡して、アイテムのセッション・ステートを設定できます。ユーザー・レベル・チェックサムまたはセッション・レベル・チェックサムも使用できます(次の項目を参照)。現行のワークスペースの別のセッションで同じアプリケーションを実行しているユーザーが生成したチェックサムを含むURLによってのみ、このアイテムを設定できるようにする場合に、このオプションを使用します。

- チェックサムが必要: ユーザー・レベル: ワークスペース、アプリケーションおよびユーザー固有のチェックサムを入力する場合は、URLでアイテムの名前/値を渡して、アイテムのセッション・ステートを設定できます。セッション・レベル・チェックサムも使用できます(次の項目を参照)。現行のワークスペースの別のセッションで同じアプリケーションを実行しているユーザーが生成したチェックサムを含むURLによってのみ、このアイテムを設定できるようにする場合に、このオプションを使用します。

- チェックサムが必要: セッション・レベル: カレント・セッション固有のチェックサムを入力する場合は、URLでアイテムの名前/値を渡して、アイテムのセッション・ステートを設定できます。カレント・セッションで生成されたチェックサムを含むURLによってのみ、このアイテムを設定できるようにする場合に、このオプションを使用します。

8. 「表示専用アイテム」を選択した場合は、各アイテムのセッション・ステート保護レベルを選択します。

- 制限なし: URLまたはフォームでアイテムの名前/値を渡して、アイテムを設定できます。URLにチェックサムは必要ありません。
注意: Ajaxを使用してこのアイテムの値をセッション・ステートに設定する必要がある場合は、アイテムに対して「制限なし」保護レベルを使用する必要があります(たとえば「動的アクション」の場合は、「値の設定」、「送信するページ・アイテム」または「カスケードLOV」、「送信するページ・アイテム」)。

- 制限付き - ブラウザから設定できない: URLまたはPOSTDATAを使用してアイテムを変更できません。アイテムの値を内部プロセス、計算などに設定できる方法を制限する場合は、このオプションを使用します。この属性は、セッション・ステート保護が無効になっていても、常に監視されます。次の表示形式タイプについては、この属性を使用します。

- テキストとして表示(特殊文字をエスケープし、状態は保存しない)

- テキストとして表示(状態は保存しない)

- テキストとして表示(LOVに基づき、状態は保存しない)

- テキストとして表示(PL/SQLに基づき、状態は保存しない)

- テキスト・フィールド(無効、状態を保存しない)

- HTML表の停止および開始(ラベルのみ表示)

- チェックサムが必要 - アプリケーション・レベル: スキーマ固有のチェックサムを入力する場合は、URLでアイテムの名前/値を渡して、アイテムのセッション・ステートを設定できます。ユーザー・レベル・チェックサムまたはセッション・レベル・チェックサムも使用できます(次の項目を参照)。現行のワークスペースの別のセッションで同じアプリケーションを実行しているユーザーが生成したチェックサムを含むURLによってのみ、このアイテムを設定できるようにする場合に、このオプションを使用します。

- チェックサムが必要: ユーザー・レベル: ワークスペース、アプリケーションおよびユーザー固有のチェックサムを入力する場合は、URLでアイテムの名前/値を渡して、アイテムのセッション・ステートを設定できます。セッション・レベル・チェックサムも使用できます(次の項目を参照)。現行のワークスペースの別のセッションで同じアプリケーションを実行しているユーザーが生成したチェックサムを含むURLによってのみ、このアイテムを設定できるようにする場合に、このオプションを使用します。

- チェックサムが必要: セッション・レベル: カレント・セッション固有のチェックサムを入力する場合は、URLでアイテムの名前/値を渡して、アイテムのセッション・ステートを設定できます。カレント・セッションで生成されたチェックサムを含むURLによってのみ、このアイテムを設定できるようにする場合に、このオプションを使用します。

9. 「変更の適用」をクリックします。

アプリケーション・アイテムのセッション・ステート保護の構成

アプリケーション・アイテムのセッション・ステート保護を構成するには、次のステップを実行します。

1. 「セッション・ステート保護」ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「セキュリティ」で、「セッション・ステート保護」を選択します。
セッション・ステート保護ページが表示されます。

2. 「アプリケーション・アイテム」アイコンをクリックします。

3. ページ上部の検索バーを使用してページの概観をカスタマイズできます。使用可能なコントロールは次のとおりです。

- 「検索」アイコン: 虫めがねに似ています。このアイコンをクリックして、検索を特定の列のみに絞ります。すべての列を検索するには、「すべての列」を選択します。

- テキスト領域: 大/小文字を区別しない検索基準(ワイルドカード文字は暗黙的に定義される)を入力し、「実行」をクリックします。

- 「実行」ボタン: 検索を実行したり、フィルタを適用します。

- アクション・メニュー: アクション・メニューを表示します。レポート・ビューをカスタマイズするにはこのメニューを使用します。「「アクション」メニューについて」を参照してください。

4. アプリケーション・アイテムを選択します。

5. 「セキュリティ」で、「セッション・ステート保護」リストから次のいずれかを選択します。

- 制限なし: URLまたはフォームでアイテム名/値を渡して、アイテムのセッション・ステートを設定できます。URLにチェックサムは必要ありません。
注意: Ajaxを使用してこのアイテムの値をセッション・ステートに設定する必要がある場合は、アイテムに対して「制限なし」保護レベルを使用する必要があります(たとえば「動的アクション」の場合は、「値の設定」、「送信するページ・アイテム」または「カスケードLOV」、「送信するページ・アイテム」)。

- 制限付き - ブラウザから設定できない: URLまたはPOSTDATAを使用してアイテムを変更できません。アイテムの値を内部プロセス、計算などに設定できる方法を制限する場合は、このオプションを使用します。この属性は、データ・エントリ・アイテムとして使用できないアイテムのみに適用され、セッション・ステート保護が無効になっていても常に監視されます。次の表示形式タイプのアプリケーション・アイテムについては、この属性を使用します。

- テキストとして表示(特殊文字をエスケープし、状態は保存しない)

- テキストとして表示(状態は保存しない)

- テキストとして表示(LOVに基づき、状態は保存しない)

- テキストとして表示(PL/SQLに基づき、状態は保存しない)

- テキスト・フィールド(無効、状態を保存しない)

- HTML表の停止および開始(ラベルのみ表示)

- チェックサムが必要 - アプリケーション・レベル: スキーマ固有のチェックサムを入力する場合は、URLでアイテムの名前/値を渡して、アイテムのセッション・ステートを設定できます。ユーザー・レベル・チェックサムまたはセッション・レベル・チェックサムも使用できます(次の項目を参照)。現行のワークスペースの別のセッションで同じアプリケーションを実行しているユーザーが生成したチェックサムを含むURLによってのみ、このアイテムを設定できるようにする場合に、このオプションを使用します。

- チェックサムが必要: ユーザー・レベル: ワークスペース、アプリケーションおよびユーザー固有のチェックサムを入力する場合は、URLでアイテムの名前/値を渡して、アイテムのセッション・ステートを設定できます。セッション・レベル・チェックサムも使用できます(次の項目を参照)。現行のワークスペースの別のセッションで同じアプリケーションを実行しているユーザーが生成したチェックサムを含むURLによってのみ、このアイテムを設定できるようにする場合に、このオプションを使用します。

- チェックサムが必要: セッション・レベル: カレント・セッション固有のチェックサムを入力する場合は、URLでアイテムの名前/値を渡して、アイテムのセッション・ステートを設定できます。カレント・セッションで生成されたチェックサムを含むURLによってのみ、このアイテムを設定できるようにする場合に、このオプションを使用します。

6. 「変更の適用」をクリックします。

ファイルのアップロードの保護

Oracle Application Expressを使用すると、ファイルをアップロードし、アップロードしたファイルにアクセスできるアプリケーションを簡単に作成できます。これらのファイルは、共通のファイル記憶域表にアップロードされます。データベース・ビューAPEX_APPLICATION_FILESでは、データベース・アカウント(またはワークスペース)に関連付けられたファイルが表示されますが、共通のファイル記憶域表へのプログラムを介したアクセスでは、認証が不要な場合もあり、アップロードされたファイルを他のユーザーが参照できます。このため、開発者は、「フォームおよびレポートでのBLOBサポートについて」に記載された方法か、次に示すOTNのファイル・アップロードに関するOracle Application ExpressのHow Toドキュメントに記載された方法を使用することをお薦めします。

http://www.oracle.com/technetwork/developer-tools/apex/overview/index.html

いずれの方法の場合も、アップロードされたファイルは、パブリック表ではなく、スキーマ表に格納されます。

関連項目:
ファイル参照ページ・レベル・アイテムの作成の詳細は、「ページ・アイテムとアプリケーション・アイテムの違い」および「アイテム・タイプについて」を参照してください。

認証によるユーザー・アイデンティティの証明

認証は、ユーザーがアプリケーションにアクセスする前に、そのユーザーの本人確認を行うプロセスです。認証では、ユーザーにユーザー名とパスワードの指定を要求するか、またはデジタル証明書や保護キーを使用する可能性があります。

認証スキームを作成する場合、多くの事前構成済認証スキームから選択するか、既存のアプリケーションから認証スキームをコピーするか、または独自のカスタム認証スキームを作成できます。

内容は次のとおりです。

- 認証の仕組みの理解

- 認証を含めるかどうかの決定

- 認証スキームの作成

- 事前構成済認証スキームの作成

- 既存の認証スキームの管理

- アプリケーションに関連付けられた認証スキームの表示

- アプリケーションに関連付けられた認証スキームの変更

- 認証スキーム・レポートの表示

認証の仕組みの理解

アプリケーションがユーザーとどのように対話するかを決定します。すべてのユーザーが同じ権限を持つ場合、そのユーザーはパブリック・ユーザーとみなされます。ただし、アプリケーションが各ユーザーを個別に追跡する必要がある場合は、認証方式を指定する必要があります。

認証は、アプリケーションにアクセスする各ユーザーのアイデンティティの証明を行います。多くの認証プロセスで、ユーザーはなんらかの資格証明(ユーザー名とパスワードなど)を提供する必要があります。これらの資格証明は評価され、合格または不合格のいずれかとなります。資格証明が合格した場合、ユーザーはアプリケーションにアクセスできます。不合格の場合は、アクセスが拒否されます。

ユーザーの本人確認が行われると、Application Expressエンジンが組込み置換文字列APP_USERの値を設定して、各ユーザーを追跡します。ユーザーがページ間をナビゲートすると、Application ExpressエンジンがAPP_USERの値を設定して、本人確認を行います。Application Expressエンジンは、各ユーザーのセッション・ステートを追跡するための重要なコンポーネントとしてAPP_USERを使用します。

プログラミングの観点では、次の構文を使用してAPP_USERにアクセスできます。

- PL/SQLまたはSQLのいずれかのバインド変数として使用する場合

:APP_USER

- PL/SQLパッケージおよびトリガーを使用する場合

V('APP_USER')

APP_USERを使用すると、独自のセキュリティ・チェックおよび条件付き処理を実行できます。たとえば、次の表を作成したと想定します。

CREATE TABLE my_security_table (
user_id   VARCHAR2(30),
privilege VARCHAR2(30));

表を作成したら、この表にユーザー権限情報を移入して、ページ、タブ、ナビゲーション・バー、ボタン、リージョン、または、その他のコントロールやコンポーネントの表示の制御に使用できます。

関連項目:
「APP_USER」および「セキュリティ属性の構成」

認証を含めるかどうかの決定

アプリケーションを作成する場合、認証を含めるかどうかを決定する必要があります。次の選択肢があります。

- 認証不要の選択。Oracle Application Expressはすべてのユーザーの資格証明をチェックしません。アプリケーションのすべてのページには、すべてのユーザーからアクセスできます。

- 組込み認証スキームの選択。使用可能な事前構成済の認証スキームに基づいて、認証方式を作成します。選択するスキームによっては、Oracle 10giAS、Oracle Internet Directoryまたは他の外部サービスの対応するコンポーネントを構成する必要もあります。詳細は、「事前構成済認証スキームの作成」および「アプリケーションに関連付けられた認証スキームの変更」を参照してください。

- カスタム認証スキームの作成。カスタム認証方式を作成すると、認証インタフェースを完全に制御できます。この方法を実装するには、Application Expressエンジンが各ページ・リクエストを処理する前に実行するPL/SQLファンクションを提供する必要があります。このファンクションのブール戻り値によって、Application Expressエンジンが通常どおりにページを処理するか、または失敗ページを表示するかが決まります。「認可スキームの作成」を参照してください。

認証スキームの作成

認証スキームを作成するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「アプリケーション」ホームページで、「共有コンポーネント」をクリックします。
「共有コンポーネント」ページが表示されます。

4. 「セキュリティ」で、「認証スキーム」を選択します。
認証スキーム・ページが表示されます。

5. ページ上部の検索バーを使用してページの概観をカスタマイズできます。使用可能なコントロールは次のとおりです。

- 検索列の選択: 虫めがねに似ています。このアイコンをクリックして、検索を絞り込みます。すべての列を検索するには、「すべての列」を選択します。

- テキスト領域: 名前でアイテムを検索するための大/小文字を区別しない検索基準(ワイルドカード文字は暗黙的に定義される)を入力し、「実行」をクリックします。

- 「実行」ボタン: 検索を実行したり、フィルタを適用します。

- アイコンの表示: 各スキームを大きいアイコンとして表示します。スキームを編集するには、該当するアイコンをクリックします。

- レポートの表示: 各スキームをレポート内の1行として表示します。スキームを編集するには、「編集」アイコンをクリックします。

- 「アクション」メニュー: 「アクション」メニューを使用して、レポート・ビューをカスタマイズします。「「アクション」メニューについて」を参照してください。

6. 新しい認証スキームを作成するには、「作成」をクリックします。

7. 次のいずれかの項目を選択して、スキームの作成方法を指定します。

- 「ギャラリからの事前構成済スキームに基づく」。詳細は、「事前構成済認証スキームの作成」および「カスタム認証」を参照してください。

- 「既存の認証スキームのコピーとして」。

8. 画面に表示されるステップに従います。

事前構成済認証スキームの作成

ギャラリから認証スキームを作成すると、標準動作の認証およびセッション管理を行う事前構成済認証スキームを選択できます。新しい認証スキームを作成すると、そのスキームは自動的に選択したアプリケーションのカレント認証スキームになります。この項では、Oracle Application Expressに付属するすべての事前構成済認証スキームについて説明します。

内容は次のとおりです。

- Application Expressアカウント

- カスタム認証

- データベース・アカウント

- HTTPヘッダー変数

- LDAPディレクトリの検証

- 認証なし(DADを使用)

- 公開資格証明

- Oracle Application Server Single Sign-On Server

ヒント:
認証スキームはプラグインをサポートします。詳細は、「プラグインの実装」を参照してください。

Application Expressアカウント

Application Expressアカウントは、Oracle Application Expressのユーザー・リポジトリで作成および管理されるユーザー・アカウントです。この方式を使用すると、これらのアカウントに対してアプリケーションが認証されます。

関連項目:
『Oracle Application Express管理ガイド』の「Application Expressユーザーの管理」

Application Expressアカウントは、次のような場合に有効です。

- ユーザー・アカウント・リポジトリを制御する場合

- ユーザー名およびパスワードに基づいたセキュリティで十分な場合

- シングル・サインオン・フレームワークへの統合が不要な場合

この方法は特に、ユーザー・グループを新しいアプリケーションで迅速に起動および実行する必要がある場合に適しています。

Application Expressアカウントの設定

Application Expressアカウントを設定するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「アプリケーション」ホームページで、「共有コンポーネント」をクリックします。
「共有コンポーネント」ページが表示されます。

4. 「セキュリティ」で、「認証スキーム」を選択します。

5. 認証スキーム・ページで、「作成」をクリックします。

6. 「ギャラリからの事前構成済スキームに基づく」を選択し、「次へ」をクリックします。

7. 「名前」で、次の項目を指定します。

1. 名前: 他のアプリケーション開発者が認証スキームを参照するための名前を入力します。

2. スキーム・タイプ: 「Application Expressアカウント」を選択します。

3. 「作成」をクリックします。

カスタム認証

認証スキームを最初から作成すると、認証インタフェースを完全に制御できます。これは、次のいずれかに該当する場合に最適な方法です。

- データベース認証または他の方式が適切でない。

- 独自のログイン・フォームおよび関連方式を開発する必要がある。

- セッション管理のセキュリティ面を制御する必要がある。

- ユーザー・レベルまたはセッション・レベルでアクティビティを記録または監査する必要がある。

- セッションのアクティビティ制限または存続期限を施行する必要がある。

- Oracle Application Expressページ・プロセスの前に一方向の条件付きリダイレクト・ロジックをプログラムする必要がある。

- 一般的なセッション管理フレームワークを使用して、アプリケーションをOracle Application Express以外のアプリケーションと統合する必要がある。

- アプリケーションが、シームレス(たとえば、複数のアプリケーションID)に動作する複数のアプリケーションで構成されている。

ヒント:
複数のアプリケーションで同じ認証スキームの使用を計画している場合は、カスタム認証プラグインの記述を検討してください。詳細は、「プラグインの実装」を参照してください。

内容は次のとおりです。

- カスタム認証スキームの作成

- セッション管理セキュリティについて

- ログイン・ページの構築について

カスタム認証スキームの作成

カスタム認証スキームを作成するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「アプリケーション」ホームページで、「共有コンポーネント」をクリックします。
「共有コンポーネント」ページが表示されます。

4. 「セキュリティ」で、「認証スキーム」を選択します。

5. 認証スキーム・ページで、「作成」をクリックします。

6. 「ギャラリからの事前構成済スキームに基づく」を選択し、「次へ」をクリックします。

7. 「名前」で、次の項目を指定します。

1. 名前: 他のアプリケーション開発者が認証スキームを参照するための名前を入力します。

2. スキーム・タイプ: 「カスタム」を選択します。

8. 該当するフィールドに入力します。

9. 特定のフィールドの詳細は、アイテムのヘルプを参照してください。
ヘルプが使用可能な場合は、アイテムにカーソルをあわせると、カーソルが疑問符付きの矢印に変わります。「フィールドレベル・ヘルプについて」を参照してください。

10. 「作成」をクリックします。

セッション管理セキュリティについて

Oracle Application Expressは、カスタム認証を実行する際に、次の2つの不適切な状況が発生しないようにします。

- あるユーザーが、他のユーザーに属するセッション・ステートに故意にアクセスしようとすること。ただし、ユーザーは任意のアプリケーション・セッションIDをURLに入力できます。

- 失効したセッション・ステート(多くの場合、同じユーザーに属する以前のセッション・ステート)が不注意にアクセスされること。これは一般的に、アプリケーション・ページへのブックマークを使用したために発生します。

Oracle Application Expressは、カスタム認証ファンクションによって設定されたユーザーIDトークンが、アプリケーション・セッションが最初に作成された際に記録されたユーザーIDと一致するかどうかを確認します。ユーザーがまだ認証されておらず、ユーザーIDが認識されていない場合、アクセスをしているセッション・ステートは、他のユーザーに属していません。これらの確認によって、リクエスト内のセッションIDが使用可能かどうかが判断されます。セッションIDが使用不可能な場合、Application Expressエンジンは適切なセッションIDを使用して、同じページにリダイレクトします。

ログイン・ページの構築について

Oracle Application Expressでアプリケーションを作成すると、ログイン・ページが作成されます。ページの別名は、LOGINです。このページは、認証スキームで無効なセッション・ページとして使用できます。このページは、Oracle Application ExpressのログインAPIをコールするプロセスを使用して、資格証明の検証およびセッションの登録を実行するように構成されています。

事前に構築されたモデル・ページを使用して、すべてのユーザー・インタフェースを調整し、要件に対してロジックを加工して、独自のログイン・ページを構築することもできます。

アプリケーションのログイン・ページを作成するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「ページの作成」をクリックします。

4. 「ログイン・ページ」を選択します。

5. ログイン・ページ属性を指定して、「作成」をクリックします。

ディープ・リンクについて

ディープ・リンクは、コンテキスト外(たとえば、電子メールのハイパーリンクまたはワークフロー通知から)のOracle Application Expressページにリンクする機能を指します。コンテキスト外のページにリンクし、そのアプリケーションでユーザー認証が必要な場合、ログイン・ページが表示されます。資格証明の検証後、Application Expressエンジンは元のリンクで参照されていたページを自動的に表示します。ディープ・リンクは、認証スキームを使用するアプリケーションに対してサポートされます。

データベース・アカウント

データベース・アカウント資格証明は、データベース・スキーマ・アカウントを使用します。この認証スキームでは、データベース・ユーザー(スキーマ)はローカル・データベースに存在している必要があります。この方法を使用する場合、ユーザーの認証にデータベース・アカウントのユーザー名およびパスワードが使用されます。

適用可能なアプリケーションの指定したユーザーごとに1つのデータベース・アカウントを持ち、ニーズに対応したデータベース・ツールによるアカウントのメンテナンスを行う場合に、データベース・アカウント資格証明は有効です。

データベース・アカウント資格証明の設定

データベース・アカウント資格証明を設定するには、次の手順を実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「アプリケーション」ホームページで、「共有コンポーネント」をクリックします。
「共有コンポーネント」ページが表示されます。

4. 「セキュリティ」で、「認証スキーム」を選択します。

5. 認証スキーム・ページで、「作成」をクリックします。

6. 「ギャラリからの事前構成済スキームに基づく」を選択し、「次へ」をクリックします。

7. 「名前」で、次の項目を指定します。

1. 名前: 他のアプリケーション開発者が認証スキームを参照するための名前を入力します。

2. スキーム・タイプ: 「データベース・アカウント」を選択します。

3. 「作成」をクリックします。

HTTPヘッダー変数

HTTPヘッダー変数は、ヘッダー変数を使用したユーザーの識別およびApplication Expressのユーザー・セッションの作成をサポートします。会社で、アプリケーションおよびテクノロジ全体でシングル・サインオンを実現するOracle Access Managerのような集中型Web認証ソリューションを使用する場合は、この認証スキームを使用します。これらのシステムによってユーザー資格証明検証が実行され、REMOTE_USER(デフォルト)のようなHTTPヘッダー変数を使用してOracle Application Expressにユーザー名が渡されます。

HTTPヘッダー変数の設定

HTTPヘッダー変数を設定するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「アプリケーション」ホームページで、「共有コンポーネント」をクリックします。
「共有コンポーネント」ページが表示されます。

4. 「セキュリティ」で、「認証スキーム」を選択します。

5. 認証スキーム・ページで、「作成」をクリックします。

6. 「ギャラリからの事前構成済スキームに基づく」を選択し、「次へ」をクリックします。

7. 「名前」で、次の項目を指定します。

1. 名前: 他のアプリケーション開発者が認証スキームを参照するための名前を入力します。

2. スキーム・タイプ: 「HTTPヘッダー変数」を選択します。

8. 該当するフィールドに入力します。

9. 特定のフィールドの詳細は、アイテムのヘルプを参照してください。
ヘルプが使用可能な場合は、アイテムにカーソルをあわせると、カーソルが疑問符付きの矢印に変わります。「フィールドレベル・ヘルプについて」を参照してください。

10. 「作成」をクリックします。

LDAPディレクトリの検証

ログイン・ページを使用する認証スキームは、Lightweight Directory Access Protocol(LDAP)を使用して、ログイン・ページで送信されるユーザー名およびパスワードを検証するように構成できます。

アプリケーション・ビルダーには、このオプションの構成方法を示すウィザードと編集ページが含まれています。これらのウィザードでは、この構成のために、ご使用のアプリケーションにアクセス可能なLDAPディレクトリがすでに存在していることと、LDAPディレクトリが資格証明の検証のSIMPLE_BIND_Sコールに応答できることを想定しています。LDAP資格証明の認証スキームを作成する場合、ウィザードによってLDAPホスト名、LDAPポート、DN文字列が要求および保存され、SSL、完全なDN、および完全なDNを使用しない場合のオプションの検索フィルタを使用するかどうかが決定されます。オプションの事前処理ファンクションを指定して、APIに渡されるユーザー名の書式設定を調整できます。

LDAPディレクトリの検証の設定

LDAPディレクトリを設定するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「アプリケーション」ホームページで、「共有コンポーネント」をクリックします。
「共有コンポーネント」ページが表示されます。

4. 「セキュリティ」で、「認証スキーム」を選択します。

5. 認証スキーム・ページで、「作成」をクリックします。

6. 「ギャラリからの事前構成済スキームに基づく」を選択し、「次へ」をクリックします。

7. 「名前」で、次の項目を指定します。

1. 名前: 他のアプリケーション開発者が認証スキームを参照するための名前を入力します。

2. スキーム・タイプ: 「LDAPディレクトリ」を選択します。

8. 「設定」で、次のステップを実行します。

1. ホスト: LDAPディレクトリ・サーバーのホスト名を入力します。

2. ポート: LDAPディレクトリ・ホストのポート番号を入力します。デフォルト値は389です。

3. SSLの使用: LDAPディレクトリへのバインドにSSLを使用するかどうかを選択します。認証付きSSLを選択すると、Application Expressインスタンスに対してウォレットを構成する必要があります。

4. 識別名(DN)文字列: 完全なDNを使用する場合はDBMS_LDAP.SIMPLE_BIND_Sに完全修飾識別名(DN)文字列を構築するために使用されるパターンを、非完全なDNを使用する場合は検索ベースを入力します。%LDAP_USER%をユーザー名のプレースホルダとして使用します。次に例を示します。
完全なDN:

cn=%LDAP_USER%,l=amer,dc=yourdomain,dc=com

非完全なDN(検索ベース):

Non-Exact DN (Search Base)

5. 識別名(DN)の使用: LDAP識別名(DN)文字列が完全か非完全かを選択します。非完全の場合、LDAP識別名(DN)は検索ベースで、検索フィルタを指定する必要があります。

6. LDAPユーザー名編集ファンクション: ユーザー名をLDAPディレクトリ・エントリまたはLDAPユーザー名に最適な形式に変換するために実行される追加コードを指定できます。バインド変数:USERNAMEには、エンド・ユーザーが指定した名前が含まれます。たとえば、次のコードでは、DN文字列のすべてのピリオド(.)をアンダースコア(_)に置換する関数がコールされます。

return apex_custom_auth.ldap_dnprep(p_username => :USERNAME);

7. ユーザー名エスケープ: Oracle Application Expressでの%LDAP_USER%内の特殊文字のエスケープ方法を選択します。この属性の正しい値は、使用されるLDAPサーバーおよび「LDAPユーザー名編集ファンクション」によってすでに特殊文字がエスケープされているかどうかによって異なります。

9. 特定のフィールドの詳細は、アイテムのヘルプを参照してください。
ヘルプが使用可能な場合は、アイテムにカーソルをあわせると、カーソルが疑問符付きの矢印に変わります。「フィールドレベル・ヘルプについて」を参照してください。

10. 「作成」をクリックします。

注意:
SSLモードとして「認証付きSSL」を選択する場合は、Oracle Application Expressのインスタンス設定を使用してウォレットを設定する必要があります。また、LDAPサーバーのルート証明書を信頼できる証明書としてこのウォレットにインポートする必要があります。詳細は、Oracle Application Express管理ガイドの「ウォレット情報の構成」およびOracle Database Advanced Security管理者ガイドの「Oracle Wallet Managerの使用」を参照してください。

認証なし(DADを使用)

データベース・アクセス記述子(DAD)データベース認証では、Basic認証スキームを使用してユーザーを認証するのに、Oracle Databaseのシステム固有の認証およびユーザー・メカニズムを使用します。この認証スキームでは、DAD構成に格納された値か、アカウント情報がDAD構成に格納されていない場合はBasic認証要求を使用して取得されるユーザー名のいずれかとして、データベース・アクセス記述子(DAD)からユーザー名が取得されます。

DAD資格証明の検証を使用するには、次の条件を満たす必要があります。

- 各アプリケーション・ユーザーが、Oracle Databaseにユーザー・アカウントを持っている。

- Basic認証用のPL/SQL DADを構成している(アカウント情報なし)。
これによって、アプリケーション・ユーザーは、ブラウザ・セッションごとに1回ユーザー名/パスワードを要求されます。その後、ユーザー・アイデンティティ・トークンがAPP_USERアイテム内で使用可能になります。

DADデータベース認証は、管理可能な数のユーザーに対して最小限の設定が必要な認証方式を実装する必要がある場合に役立ちます。これらのユーザーがデータベース内に自己管理されたアカウントを持っており、この認証方式を短期間(たとえば、開発のデモンストレーションまたはプロトタイプ段階の間)のみ使用することが理想です。

この方法の主なデメリットは、特にユーザーが自分のパスワードを管理していないか、またはユーザーのデータベース・アカウントがアプリケーションへの認証を容易化するためのみに存在している場合に、アカウントのメンテナンスが負担となることです。

DAD資格証明の検証の設定

DAD資格証明の検証を設定するには、次の手順を実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「アプリケーション」ホームページで、「共有コンポーネント」をクリックします。
「共有コンポーネント」ページが表示されます。

4. 「セキュリティ」で、「認証スキーム」を選択します。

5. 認証スキーム・ページで、「作成」をクリックします。

6. 「ギャラリからの事前構成済スキームに基づく」を選択し、「次へ」をクリックします。

7. 「名前」で、次の項目を指定します。

1. 名前: 他のアプリケーション開発者が認証スキームを参照するための名前を入力します。

2. スキーム・タイプ: 「認証なし(DADを使用)」を選択します。

8. 「作成」をクリックします。

公開資格証明

公開資格証明を使用すると、ユーザー名を取得する組込みログイン・ページを使用して、自分のアプリケーションがすべてのユーザーからアクセス可能になります。この認証方式は、アプリケーションの開発時に有用です。

公開資格証明の設定

公開資格証明を設定するには、次の手順を実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「アプリケーション」ホームページで、「共有コンポーネント」をクリックします。
「共有コンポーネント」ページが表示されます。

4. 「セキュリティ」で、「認証スキーム」を選択します。

5. 認証スキーム・ページで、「作成」をクリックします。

6. 「ギャラリからの事前構成済スキームに基づく」を選択し、「次へ」をクリックします。

7. 「名前」で、次の項目を指定します。

1. 名前: 他のアプリケーション開発者が認証スキームを参照するための名前を入力します。

2. スキーム・タイプ: 「公開資格証明」を選択します。

8. 「作成」をクリックします。

Oracle 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のパートナ・アプリケーションの登録手順に従い、Oracle9iAS SSO Software Developer Kit (SDK)をインストールすることで、パートナ・アプリケーションとしてアプリケーションを登録する(またはApplication Expressエンジンを登録する)必要があります。

この方法を選択する場合、ご使用のアプリケーションでは統合されたログイン・ページが使用されません。かわりに、ユーザーが新しいブラウザ・セッションでアプリケーションにアクセスすると、Application ExpressエンジンによってSingle Sign-Onログイン・ページにリダイレクトされます。ユーザーがSSOによって認証されると、SSOコンポーネントはアプリケーションにリダイレクトし、Application Expressエンジンにユーザー・アイデンティティおよびその他の情報を渡します。その後、ユーザーはログオフするか、ブラウザ・セッションを終了するか、またはその他のセッション終了イベントが発生するまでアプリケーションを使用できます。

Oracle Application Server Single Sign-Onの設定

Oracle Application Server Single Sign-Onを設定するには、次の手順を実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「アプリケーション」ホームページで、「共有コンポーネント」をクリックします。
「共有コンポーネント」ページが表示されます。

4. 「セキュリティ」で、「認証スキーム」を選択します。

5. 認証スキーム・ページで、「作成」をクリックします。

6. 「ギャラリからの事前構成済スキームに基づく」を選択し、「次へ」をクリックします。

7. 「名前」で、次の項目を指定します。

1. 名前: 他のアプリケーション開発者が認証スキームを参照するための名前を入力します。

2. スキーム・タイプ: 「Oracle Application Server Single Sign-On」を選択します。

8. 該当するフィールドに入力します。

9. 特定のフィールドの詳細は、アイテムのヘルプを参照してください。
ヘルプが使用可能な場合は、アイテムにカーソルをあわせると、カーソルが疑問符付きの矢印に変わります。「フィールドレベル・ヘルプについて」を参照してください。

10. 「作成」をクリックします。

既存の認証スキームの管理

認証スキームを作成すると、使用可能な認証スキームが認証スキーム・リポジトリに表示されます。

認証スキーム・リポジトリにナビゲートするには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「アプリケーション」ホームページで、「共有コンポーネント」をクリックします。
「共有コンポーネント」ページが表示されます。

4. 「セキュリティ」で、「認証スキーム」を選択します。

5. ページ上部の検索バーを使用してページの概観をカスタマイズできます。使用可能なコントロールは次のとおりです。

- 検索列の選択: 虫めがねに似ています。このアイコンをクリックして、検索を絞り込みます。すべての列を検索するには、「すべての列」を選択します。

- テキスト領域: 名前でアイテムを検索するための大/小文字を区別しない検索基準(ワイルドカード文字は暗黙的に定義される)を入力し、「実行」をクリックします。

- 「実行」ボタン: 検索を実行したり、フィルタを適用します。

- アイコンの表示: 各スキームを大きいアイコンとして表示します。スキームを編集するには、該当するアイコンをクリックします。

- レポートの表示: 各スキームをレポート内の1行として表示します。スキームを編集するには、該当する「編集」アイコンをクリックします。

- 「アクション」メニュー: 「アクション」メニューを使用して、レポート・ビューをカスタマイズします。「「アクション」メニューについて」を参照してください。

6. 特定の認証スキームをレポートとして編集するには、認証スキーム名の左側にある「編集」アイコンをクリックします。
認証スキーム・ページが表示されます。

7. 特定のフィールドの詳細は、アイテムのヘルプを参照してください。
ヘルプが使用可能な場合は、アイテムにカーソルをあわせると、カーソルが疑問符付きの矢印に変わります。「フィールドレベル・ヘルプについて」を参照してください。

8. 該当する属性を編集し、「変更の適用」をクリックします。

アプリケーションに関連付けられた認証スキームの表示

アプリケーションのカレント認証スキームを表示するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「セキュリティ」で、「セキュリティ属性」をクリックします。

5. 「認証」セクションに移動します。カレント認証スキームが「認証スキーム」の横に表示されます。

6. 認証スキームを編集するには、「認証スキームの定義」。

アプリケーションに関連付けられた認証スキームの変更

アプリケーションの認証スキームを変更するには、次のステップを実行します。

1. 「認証スキーム」にナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「アプリケーション」ホームページで、「共有コンポーネント」をクリックします。
「共有コンポーネント」ページが表示されます。

4. 「セキュリティ」で、「認証スキーム」を選択します。

2. アクティブ化する認証スキームの横の「編集」アイコンをクリックします。
作成/編集ページが表示されます。

3. 「カレント・スキームにする」をクリックします。

関連項目:
「事前構成済認証スキームの作成」

認証スキーム・レポートの表示

認証スキーム・レポートを表示するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「アプリケーション」ホームページで、「共有コンポーネント」をクリックします。
「共有コンポーネント」ページが表示されます。

4. 「セキュリティ」で、「認可スキーム」を選択します。

5. ページ上部の該当するタブをクリックします。

- サブスクリプション

- 履歴

サブスクリプション

「認証スキームのサブスクリプション」レポートを使用すると、アプリケーションのサブスクライブされた認証スキームを表示できます。

履歴

「認証スキーム履歴」レポートを使用すると、このアプリケーションのアイテムに最近行われた変更を表示できます。

認可を介したセキュリティの提供

認可は、ユーザー権限に基づいてリソースへのアクセスを制御することを示す広義語です。条件は特定のページ・コントロールまたはページ・コンポーネントのレンダリングおよび処理を制御しますが、認可スキームは特定のコントロールまたはコンポーネントへのユーザーのアクセスを制御します。

内容は次のとおりです。

- 認可スキームの動作方法

- 認可スキームの作成

- アプリケーション、ページまたはコンポーネントへの認可スキームの割当て

- 認可レポートの表示

認可スキームの動作方法

認可スキームは、アプリケーションの認証スキームのセキュリティを強化します。認可スキームは、アプリケーション全体、各ページ、またはリージョン、アイテム、ボタンなどの特定のコントロールに対して指定できます。たとえば、認可スキームを使用して、ユーザーに表示するタブ、リージョンまたはナビゲーション・バーを選択的に決定できます。

認可スキームの結果は、成功または失敗のいずれかです。コンポーネントまたはコントロール・レベルの認可スキームに成功すると、そのコンポーネントまたはコントロールがユーザーに表示されます。失敗すると、そのコンポーネントまたはコントロールはユーザーに表示されません。アプリケーション・レベルまたはページ・レベルの認可スキームに失敗すると、Oracle Application Expressは事前定義済のメッセージを表示します。

認可スキームを定義する場合は、一意の名前を指定します。定義した認可スキームは、アプリケーションのコンポーネントまたはコントロールに割り当てることができます。アプリケーションのコンポーネントまたはコントロールに認可スキームを割り当てるには、該当する属性ページにナビゲートして、「認可スキーム」リストから認可スキームを選択するのみです。

認可スキームの作成

認可スキームは、アプリケーションまたはアプリケーション・コンポーネントまたはコントロールに割り当てる前に作成する必要があります。

認可スキームを作成するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「アプリケーション」ホームページで、「共有コンポーネント」をクリックします。
「共有コンポーネント」ページが表示されます。

4. 「セキュリティ」で、「認可スキーム」を選択します。

5. 「作成」をクリックします。

6. 次のいずれかの項目を選択して、認可スキームの作成方法を指定します。

- 最初から

- 既存の認可スキームのコピーとして

7. 画面に表示されるステップに従います。

関連項目:
「アプリケーション、ページまたはコンポーネントへの認可スキームの割当て」

既存の認可スキーム属性の編集

既存の認可スキームの属性を編集するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「アプリケーション」ホームページで、「共有コンポーネント」をクリックします。
「共有コンポーネント」ページが表示されます。

4. 「セキュリティ」で、「認可スキーム」を選択します。
認可スキーム・ページが表示されます。デフォルトでは、各スキームがアイコンとして表示されます。

5. ページ上部の検索バーを使用してページの概観をカスタマイズできます。使用可能なコントロールは次のとおりです。

- 検索列の選択: 虫めがねに似ています。このアイコンをクリックして、検索を絞り込みます。すべての列を検索するには、「すべての列」を選択します。

- テキスト領域: 名前でアイテムを検索するための大/小文字を区別しない検索基準(ワイルドカード文字は暗黙的に定義される)を入力し、「実行」をクリックします。

- 「実行」ボタン: 検索を実行したり、フィルタを適用します。

- アイコンの表示: 各スキームを大きいアイコンとして表示します。スキームを編集するには、該当するアイコンをクリックします。

- レポートの表示: 各スキームをレポート内の1行として表示します。スキームを編集するには、該当する「編集」アイコンをクリックします。

- 「アクション」メニュー: 「アクション」メニューを使用して、レポート・ビューをカスタマイズします。「「アクション」メニューについて」を参照してください。

評価ポイント属性について

評価ポイント属性に、認可スキームを検証するタイミングを指定できます。認可スキームをセッションごとに1回検証するか、またはページ・ビューごとに1回検証するかを選択できます。

認可スキームがセッションごとに1回評価されるように指定して、その認可スキームが合格した場合、基礎となるコード、テストまたは問合せは、そのアプリケーション・セッション中に再実行されないことに注意してください。認可スキームが、セッション中の異なる時刻に評価されると結果が異なる可能性があるテストで構成されている場合、評価ポイントをページ・ビューごとに1回に指定する必要があります。

認可スキーム・ステートのリセットについて

認可スキームがセッションごとに1回検証される場合、Oracle Application Expressは各ユーザーのセッション・キャッシュ内に検証結果をキャッシュします。セッションの認可スキーム・ステートは、APEX_UTIL.RESET_AUTHORIZATIONS APIをコールしてリセットできます。

このプロシージャをコールすると、カレント・セッションに対して以前にキャッシュされた認可スキームの結果がNULLになります。このプロシージャは引数を取らず、パブリックに実行可能なAPEX_UTILパッケージの一部であることに注意してください。

関連項目:
Oracle Application Express APIリファレンスの「RESET_AUTHORIZATIONSプロシージャ」

アプリケーション、ページまたはコンポーネントへの認可スキームの割当て

作成した認可スキームは、アプリケーション全体、ページ、コントロールまたはコンポーネントに割り当てることができます。

内容は次のとおりです。

- アプリケーションへの認可スキームの割当て

- ページへの認可スキームの割当て

- コントロールまたはコンポーネントへの認可スキームの割当て

アプリケーションへの認可スキームの割当て

認可スキームをアプリケーションに割り当てるには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」アイコンをクリックします。
「共有コンポーネント」ページが表示されます。

4. 「セキュリティ」で、「セキュリティ属性」をクリックします。

5. 「認可」までスクロールして、「認可スキーム」リストから認可スキームを選択します。

6. 「パブリック・ページで実行」で、「はい」または「いいえ」を選択して、アプリケーション・レベルの認可スキームがパブリック・ページ(つまり、認可を必要としないページ)でチェックされるかどうかを指定します。詳細は、「認可」を参照してください。

7. 新しい認可スキームを定義するには、「認可スキームの定義」をクリックします。

ページへの認可スキームの割当て

認可スキームをページに割り当てるには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. ページを選択します。

4. 編集ページにアクセスするには、次の操作を実行します。

- ツリー・ビュー: 「ページ・レンダリング」で、ツリーの上部のページ・タイトルをダブルクリックします。

- コンポーネント・ビュー: 「ページ」で、ページ名をクリックします。

5. 「セキュリティ」までスクロールして、「認可スキーム」リストから認可スキームを選択します。

コントロールまたはコンポーネントへの認可スキームの割当て

認可スキームをページ・コンポーネントまたはコントロールに割り当てるには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. ページを選択します。

4. 認可スキームを適用するコンポーネントまたはコントロールの名前をクリックします。

5. 「セキュリティ」までスクロールして、「認可スキーム」リストから認可スキームを選択します。

認可レポートの表示

認可スキームのサブスクリプションおよび認可スキームの使用率レポートを使用すると、アプリケーション内の認可スキームをより効率的に管理できます。

認可スキーム・レポートを表示するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「アプリケーション」ホームページで、「共有コンポーネント」をクリックします。
「共有コンポーネント」ページが表示されます。

4. 「セキュリティ」で、「認可スキーム」を選択します。

5. ページ上部の該当するタブをクリックします。

- サブスクリプション

- コンポーネント別

- 使用状況

- 履歴

サブスクリプション

認可スキームのサブスクリプション・レポートを使用して、認可スキームのサブスクリプションの詳細を表示します。

コンポーネント別

「コンポーネント別」レポートを使用すると、認可スキームに関連するこのアプリケーション内のすべてのコンポーネントが表示されます。レンダリングするコンポーネントには、コンポーネント・レベル、ページ・レベルおよびアプリケーション・レベルにある認可スキームを渡す必要があります。

使用状況

認可スキームの使用率レポートを使用して、認可スキームの使用率の詳細を表示します。

ページの認可スキームの有無を示す詳細レポートを表示するには、「タスク」リストから次のいずれかを選択します。

- 認可スキームが指定されているレポート・ページ

- 認可スキームが指定されていないレポート・ページ

履歴

「履歴」レポートを使用すると、このアプリケーションの認可スキームに最近行われた変更が表示されます。

16 アプリケーションのデプロイ

ここでは、アプリケーション・ビルダー内で構築されたデータベースのデプロイ方法およびパッケージ方法について説明します。

内容は次のとおりです。

- Oracle Application Expressアプリケーション開発のライフ・サイクルについて

- パッケージ・プロセスの理解

- 別のインスタンスへのアプリケーションの移動方法

- カスタム・パッケージ・アプリケーションの作成方法

- アプリケーションおよび関連ファイルのエクスポート

- エクスポート・ファイルのインポート

- エクスポート・ファイルのインストール

- データベース・アプリケーションURLの公開について

- Webシート・アプリケーションURLの公開について

- ビルド・オプションを使用した構成の制御

関連項目:
「高度なプログラミング手法」およびOracle Application Express管理ガイドの「Application Expressユーザーの管理」

Oracle Application Expressアプリケーション開発のライフ・サイクルについて

アプリケーション・ビルダーを使用してアプリケーションを開発する際、次のように大きく異なる2つの開発方法を考慮する必要があります。

- 反復による、迅速なアプリケーション開発

- 計画され、段階を経る開発

1つ目の方法は、柔軟性がありすぎてプロジェクトが完成しない危険性があります。それとは対照的に2つ目の方法は、理論上は決められた要件を満たしていても、エンド・ユーザーのニーズにあわないアプリケーションが作成される可能性があります。

考慮すべきシステム開発のライフ・サイクル方法論

システム開発のライフ・サイクル(SDLC)は、定義された一連のステップを使用した、ソフトウェア開発全体のプロセスです。Oracle Application Expressでアプリケーションを開発する場合に役立つ、いくつかのSDLCモデルがあります。

SDLCウォーターフォールは、最も有名なモデルでしょう。この方法では、開発プロセスは次の段階に分類されます。

1. プロジェクトのプランニング

2. 要件の定義

3. 設計

4. 開発

5. 統合およびテスト

6. インストールおよび採用

7. メンテナンス

この方法は、ある段階の出力結果が次の段階の入力内容になることから、ウォーターフォールと呼ばれます。この方法には、前の段階ですべての要件が確立されていることが前提となります。しかし、実際には、開発プロセスの途中で要件が変更されたり、新しい要件が加わることが多くあります。

Oracle Application Expressの開発環境を使用すると、開発者は、開発においてより対話的な方法をとることができます。他の多くの開発環境とは異なり、プロトタイプの作成が容易です。Oracle Application Expressを使用すると、開発者は次のことを実行できます。

- 組込みウィザードを使用して、アプリケーションのユーザー・インタフェースを簡単に設計できます。

- ユーザーによる使用が可能なプロトタイプを作成し、フィードバックを収集できます。

- 変更をリアル・タイムに実装し、新しいプロトタイプを簡単に作成できます。

他にOracle Application Expressを使用して機能する方法論として次のものがあります。

- スパイラル: この方法は、実質的には、短いウォーターフォール・サイクルをつなげたものです。各ウォーターフォール・サイクルから新たな要件が発生し、開発チームによって堅牢なプロトタイプが作成できるようになります。

- 高速アプリケーション開発(RAD)ライフ・サイクル: この方法は、完成した製品に近いプロトタイプの作成を非常に重要視した方法です。プロトタイプは、要件フェーズの重要な部分です。このモデルの1つの短所として、プロトタイプの作成を重要視することによって要件が追加される可能性があります。開発者は、完全なアプリケーションを作成しようとして、当初の目的を見失うことがあります。

パッケージ・プロセスの理解

あるOracle Application Expressインスタンスから別のインスタンスにアプリケーションを移動するには、メタデータとアプリケーションで使用されるサポートするオブジェクトの両方を次のように移動する必要があります。

1. アプリケーション定義およびすべての関連ファイルを移動します。「別のインスタンスへのアプリケーションの移動方法」を参照してください。

2. サポートするオブジェクトを移動します。「データベース・オブジェクトの依存性」レポートを確認して、移動するオブジェクトを決定します。「「データベース・オブジェクトの依存性」レポートの使用」および「カスタム・パッケージ・アプリケーションの作成方法」を参照してください。

内容は次のとおりです。

- 考慮するデプロイ・オプション

- ワークスペースをコピーするかどうかの決定

- データベースをコピーするかどうかの決定

- アプリケーションIDについて

- 新規HTTPサーバーのインストールの決定

考慮するデプロイ・オプション

アプリケーション・ビルダーでアプリケーションを開発する場合は、特定のワークスペース内でアプリケーションを作成します。各ワークスペースには、一意のIDおよび名前が含まれます。通常は、開発インスタンスでアプリケーションを作成し、本番インスタンスにアプリケーションをデプロイします。

考慮するデプロイ・オプションには、次のものがあります。

1. 同一ワークスペースおよび同一スキーマの使用:アプリケーションをエクスポートしてからインポートし、別のアプリケーションIDを使用してインストールします。この方法は、基礎になるオブジェクトに対する変更は少ないが、アプリケーションの機能に対して頻繁に変更がある場合に有効です。

2. 別のワークスペースおよび同じスキーマの使用:アプリケーションをエクスポートしてから別のワークスペースにインポートします。この方法は、開発者によって本番アプリケーションが変更されないようにするために有効です。

3. 別のワークスペースおよび別のスキーマの使用:アプリケーションをエクスポートしてから別のワークスペースにインポートし、異なるスキーマを使用するためにアプリケーションをインストールします。この新しいスキーマには、アプリケーションに必要なデータベース・オブジェクトが含まれている必要があります。「「データベース・オブジェクトの依存性」レポートの使用」を参照してください。

4. すべてのバリエーションによる別のデータベースの使用:アプリケーションをエクスポートしてから別のOracle Application Expressインスタンスにインポートし、異なるワークスペース、スキーマおよびデータベースを使用してインストールします。

ワークスペースをコピーするかどうかの決定

既存のワークスペースをコピーするかどうかを判断する際に、プリファレンスが問題になります。本番バージョンでは関係するすべてのオブジェクトへのアクセスが必要であることを覚えておいてください。たとえば、次のような場合にワークスペースをコピーする必要があります。

- 開発および他の環境間で同じアプリケーション識別子を保持する場合。

- アプリケーションでOracle Application Express認証を行う場合。ワークスペースをコピーすると、自動的にすべての必要なユーザー・データが移行されます。

データベースをコピーするかどうかの決定

データベースをコピーするかどうかを判断する際、アプリケーションが実行されるスキーマは、開発インスタンスと同じオブジェクトにアクセスする必要があることを覚えておいてください。スキーマの実際の名前は重要ではありません。スキーマ名は、インポート・プロセスで変更できます。

アプリケーションIDについて

開発バージョンと本番バージョンのアプリケーションで、アプリケーションIDを一致させる必要はありません。実際は、アプリケーションにアプリケーションIDをハード・コードしないことをお薦めします。かわりにアプリケーションの別名(アプリケーションの編集ページで定義される)を使用するか、組込み置換文字列(APP_IDおよびAPP_ALIAS)を使用します。置換文字列は、アプリケーションの機能に影響なくアプリケーションIDを変更できるため、置換文字列の使用をお薦めします。

関連項目:
アプリケーションの別名の定義については「名前」を、APP_IDおよびAPP_ALIASの使用方法については「組込み置換文字列について」を参照してください。

新規HTTPサーバーのインストールの決定

実行時、Oracle Application Expressは、埋込みPL/SQLゲートウェイ、Oracle HTTP Serverとmod_plsqlまたはOracle Application Expressリスナーにアクセスする必要があります。HTTPサーバーをインストールすることにより、アプリケーションの開発バージョンと本番バージョンを分割することができます。HTTPサーバーの構成オプションの詳細は、『Oracle Application Expressインストレーション・ガイド』のHTTPサーバーの選択に関する説明を参照してください。

別のインスタンスへのアプリケーションの移動方法

アプリケーションを他のワークスペースに移動するか、コピーを作成するのみかにかかわらず、デプロイでは次のステップを実行します。

1. サポートするデータベース・オブジェクトを移動します(適切な場合)。「データベース・オブジェクトの依存性」レポートを確認して、移動するオブジェクトを決定します。「「データベース・オブジェクトの依存性」レポートの使用」を参照してください。

2. アプリケーション定義とサポートするオブジェクトをパッケージ化して、カスタム・パッケージ・アプリケーションを作成します。「カスタム・パッケージ・アプリケーションの作成方法」を参照してください。

3. カスタム・パッケージ・アプリケーションをエクスポートします。「アプリケーションおよび関連ファイルのエクスポート」を参照してください。

4. エクスポートされたファイルをターゲットのOracle Application Expressインスタンスにインポートします。「エクスポート・ファイルのインポート」を参照してください。

アプリケーションは、アプリケーションが開発されたワークスペース以外のワークスペースにもインポートできます。「考慮するデプロイ・オプション」を参照してください。

ヒント:
アプリケーション定義およびすべてのサポートするオブジェクトを手動でも移動できます。「アプリケーションおよび関連ファイルのエクスポート」を参照してください。

データベース・オブジェクトの管理について

アプリケーションと適切な関連ファイルをエクスポートする前に、アプリケーションによって参照されるデータベース・オブジェクトも移行する必要があるかどうかを判断する必要があります。移動するデータベース・オブジェクトがわからない場合は、データベース・オブジェクトの依存性レポートを確認します。

関連項目:
「「データベース・オブジェクトの依存性」レポートの使用」および「カスタム・パッケージ・アプリケーションの作成方法」

ターゲットのスキーマが開発環境で使用されるスキーマとは異なる場合、アプリケーションによって参照されるデータベース・オブジェクトを移行する必要があります。多くの場合、Oracle Databaseのエクスポート・ユーティリティおよびインポート・ユーティリティを使用して、開発環境からターゲットのインスタンスにアプリケーション・スキーマをコピーするのみでこれを行うことができます。次に、この方法が適切でない2つの一般的なケースを示します。

- オブジェクト開発スキーマが、ターゲット・インスタンス・スキーマがアクセス権を持たない表領域を参照している場合

- 開発インスタンス・スキーマに、ターゲット・インスタンス・スキーマに移行しないサンプル・データが含まれている場合

データベース管理者またはOracle Application Express管理者がOracle Application Expressアプリケーションのエクスポートを行う場合、それらの管理者と連絡して、次のことを明示しておく必要があります。

- アプリケーションのエクスポート時に、すべてのデータを含める必要がある

- 指定した特定の表のデータを含めない

ヒント:
『Oracle Application Express SQLワークショップ・ガイド』のデータ・ワークショップを使用したデータの管理に関する説明

カスタム・パッケージ・アプリケーションの作成方法

サポートするオブジェクト・ページでカスタム・パッケージ・アプリケーションを作成すると、アプリケーションのデプロイに必要なステップを非常に簡略化できます。

関連項目:
「別のインスタンスへのアプリケーションの移動方法」および「アプリケーションおよび関連ファイルのエクスポート」

内容は次のとおりです。

- カスタム・パッケージ・アプリケーションの作成でデプロイを簡略化する方法

- カスタム・パッケージ・アプリケーションの作成

- イメージ、カスケード・スタイルシートまたは静的ファイルへのインストール・スクリプトの追加

- カスタム・パッケージ・アプリケーションへのアクセス制御リストの追加

- サポートするオブジェクトのインストール

- サポートするオブジェクトのスクリプト、メッセージ、およびインストール・オプションの削除

- カスタム・パッケージ・アプリケーションのアップグレード

- サポートするオブジェクトの削除

- インストール・サマリーの表示

カスタム・パッケージ・アプリケーションの作成でデプロイを簡略化する方法

開発者にとって、アプリケーションのインポートおよびインストールは複雑なプロセスです。最初に、ターゲットのデータベース・オブジェクトおよびシード・データを作成します。次に、アプリケーション定義およびすべての関連ファイル(イメージ、テーマ、他のすべての必要な静的ファイルなど)をインポートしてインストールします。

サポートするオブジェクト・ユーティリティを使用してカスタム・パッケージ・アプリケーションを作成すると、このプロセスを非常に簡略化できます。多くのステップを実行して、データベース・オブジェクトを作成し、アプリケーションおよびすべてのサポートするファイルをインポートしてインストールするかわりに、サポートするオブジェクトを定義すれば、アプリケーションおよびサポートするファイルを簡単な数ステップで移行できます。

ユーザーがアプリケーション定義をインポートしてインストールした後に、ウィザードにより簡単な数ステップで構成できます。ウィザードでは、サポートするアプリケーション・オブジェクトをインストールするかどうかが要求されます。ユーザーには、サポートするアプリケーション・オブジェクトをその場でインストールするか、後でインストールするかのオプションがあります。

開発者にとって、この機能には、次のような多くの利点があります。

- サポートするオブジェクトが正しい順序で作成されていることを確認してください。

- わずかなステップで素早くアプリケーションをデプロイするための自動化プロセスを提供します。

- ユーザーがアプリケーション定義をインポートしてインストールするときにまたは後で、サポートするアプリケーション・オブジェクトをインストールするオプションをユーザーに提供します。「サポートするオブジェクトのインストール」を参照してください。

- ユーザーおよび開発者は、便利な方法で、アプリケーション定義、サポートするファイルおよびすべてのデータベース・オブジェクトを削除できます。「サポートするオブジェクトの削除」を参照してください。

- ユーザーおよび開発者は、簡単な方法で、前にリリースされたカスタム・パッケージ・アプリケーションをアップグレードできます。「カスタム・パッケージ・アプリケーションのアップグレード」を参照してください。

また、アプリケーションをサポートする基礎となるデータベース・オブジェクトを素早く編集するために、削除機能およびインストール機能を利用することができます。たとえば、すべてのデータベース・オブジェクトの削除、基礎となるデータベース・オブジェクトの作成スクリプトの編集、および再定義されたアプリケーション・オブジェクトの作成用の再インストールを行うことができます。

カスタム・パッケージ・アプリケーションの作成

カスタム・パッケージ・アプリケーションを作成するには、アプリケーションのサポートするオブジェクト(データベース・オブジェクト、イメージおよびシード・データを含む)およびすべてのインストール前の検証を定義するインストール・スクリプトを作成する必要があります。これらのオブジェクトとインストール・スクリプトおよび削除スクリプト、およびユーザーがサポートするオブジェクト・ページでインストールまたは削除する場合に表示するメッセージを定義します。

内容は次のとおりです。

- サポートするオブジェクト・ページへのアクセス

- サポートするオブジェクト・ページについて

「サポートするオブジェクト」ページへのアクセス

サポートするオブジェクト・ページで、カスタム・パッケージ・アプリケーションを作成します。

サポートするオブジェクト・ページのアプリケーションにアクセスするには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。
「アプリケーション」ホームページが表示されます。

3. 「サポートするオブジェクト」アイコンをクリックします。
サポートするオブジェクト・ページが表示されます。

サポートするオブジェクト・ページについて

サポートするオブジェクト・ページの上部に、アプリケーション名が表示され、「オブジェクトの確認」、「システム権限の検証」、「必要な空き」、「使用許諾のプロンプト」、「置換」、「ビルド・オプション」、「検証」、「インストール・スクリプト」、「アップグレード・スクリプト」、「削除スクリプト」および「エクスポートに含める」の現在の選択が示されます。

サポートするオブジェクトをアプリケーション・エクスポートに含めるかどうかを指定するには、「エクスポートに含める」リストから「はい」または「いいえ」を選択し、「適用」をクリックします。

図sup_object_sum.gifの説明

残りのページは3つのカテゴリに分かれています。

インストール

「インストール」のリンクを使用して次のタイプの情報を定義します。

- 「前提条件」。必要なディスクの空き領域、必要なシステム権限、スキーマ・オブジェクト制限など、アプリケーションのインストール前に必要な組込みチェックを定義します。

- 「アプリケーション置換文字列」。アプリケーションに対して定義された静的置換文字列をリストします。アプリケーション内の多くの語句またはラベルに対する静的置換文字列を定義できます。詳細は、「置換」を参照してください。
アプリケーションをパッケージ化する場合、カスタム・パッケージ・アプリケーションをインストールする際にユーザーが指定できる置換文字列のプロンプトを含めることができます。

- 「ビルド・オプション」。このアプリケーションに対して定義されたビルド・オプションをリストします。ビルド・オプションを使用して、アプリケーション内の特定の機能を条件付きで表示できます。「ビルド・オプションを使用した構成の制御」および「ビルド・オプションまたはビルド・オプション・ステータスのエクスポート」を参照してください。
アプリケーションをパッケージ化する場合、アプリケーションをインストールする際に表示される特定のビルド・オプションのプロンプトを含めることができます。

- 「インストール前の検証」。カスタム・パッケージ・アプリケーションに対して定義された検証をリストします。標準のページ検証と同様に、ユーザー定義条件が満たされない場合、これらの検証によりユーザーはデータベース・オブジェクトをインストールできなくなります。「作成」をクリックして、画面に表示されるステップに従います。

- 「インストール・スクリプト」。アプリケーションにサポートするオブジェクトをインストールする複数のインストール・スクリプトを定義できます。新規スクリプトを作成するには、「作成」をクリックして、画面に表示されるステップに従います。既存のスクリプトを編集するには、「編集」アイコンをクリックします。

- 「メッセージ」。ユーザーがアプリケーションをインストールまたは削除するときに表示するメッセージを定義します。サポートされるHTMLタグには、<b>、<i>、<u>、<p>、<br>、<hr>、<ul>、<ol>、<li>および<pre>が含まれます。
これらのメッセージを表示する際には、クロスサイト・スクリプティング(XSS)攻撃を防ぐために、一連の限定されたHTMLタグのみが認識されることに注意してください。「クロスサイト・スクリプティング保護の理解」を参照してください。

アップグレード

「アップグレード」のリンクを使用して次のタイプの情報を定義します。

- 「アップグレード・スクリプト」。「アップグレード・スクリプト」をクリックして、既存のアプリケーションをアップグレードする際に、データベース・オブジェクト、イメージおよびシード・データをアップグレードするスクリプトを定義します。「カスタム・パッケージ・アプリケーションのアップグレード」を参照してください。

- 「メッセージのアップグレード」。ユーザーがアプリケーションをアップグレードするときに表示するメッセージを定義します。サポートされるHTMLタグには、<b>、<i>、<u>、<p>、<br>、<hr>、<ul>、<ol>、<li>および<pre>が含まれます。
これらのメッセージを表示する際には、クロスサイト・スクリプティング(XSS)攻撃を防ぐために、一連の限定されたHTMLタグのみが認識されます。「クロスサイト・スクリプティング保護の理解」を参照してください。

削除

「削除」のリンクを使用して次のタイプの情報を定義します。

- 削除スクリプト。「削除スクリプト」をクリックして、インストール・スクリプトにより作成されたデータベース・オブジェクトおよび静的ファイルを削除するスクリプトを定義します。既存のスクリプトを編集するには、「編集」アイコンをクリックします。

- 「削除メッセージ」。ユーザーがアプリケーションを削除するときに表示するメッセージを定義します。サポートされるHTMLタグには、<b>、<i>、<u>、<p>、<br>、<hr>、<ul>、<ol>、<li>および<pre>が含まれます。
これらのメッセージを表示する際には、クロスサイト・スクリプティング(XSS)攻撃を防ぐために、一連の限定されたHTMLタグのみが認識されます。「クロスサイト・スクリプティング保護の理解」を参照してください。

イメージ、カスケード・スタイルシートまたは静的ファイルへのインストール・スクリプトの追加

インストール・スクリプト・ページで、アプリケーションまたはワークスペースに事前にアップロードしたイメージ、カスケード・スタイルシートおよび静的ファイルのインストール・スクリプトを作成できます。Oracle Application Expressでは、新規スクリプトごとに、名前として選択するファイル名が使用されます。対応するAPIコールを削除スクリプトの最後に追加(削除スクリプトが存在しない場合は作成)することもできます。削除スクリプトは、アプリケーションのサポートするオブジェクトが削除されるときに、選択したファイルを削除します。

関連項目:
「カスタム・カスケード・スタイルシートの使用」、「イメージの管理」および「静的ファイルの管理」

イメージ、カスケード・スタイルシートまたは静的ファイルのインストール・スクリプトを作成するには、次のステップを実行します。

1. 次のように、サポートするオブジェクト・ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。
「アプリケーション」ホームページが表示されます。

3. 「サポートするオブジェクト」をクリックします。
サポートするオブジェクト・ページが表示されます。

2. 「インストール」で、「インストール・スクリプト」をクリックします。
インストール・スクリプト・ページが表示されます。

3. 「作成」をクリックします。

4. 画面に表示されるステップに従います。

5. ページの下部で、「ファイルをインストールするスクリプトの作成」をクリックします。
使用可能なカスケード・スタイルシート、イメージおよび静的ファイルのリストが表示されます。

6. カスタム・パッケージ・アプリケーションに含めるファイルを選択し、「スクリプトの作成」をクリックします。

カスタム・パッケージ・アプリケーションへのアクセス制御リストの追加

アクセス制御リストを作成することによって、アプリケーション、個別ページまたはページ・コンポーネントへのアクセスを制御できます。

カスタム・パッケージ・アプリケーションのアクセス制御リストを追加するには、次のステップを実行します。

1. アクセス制御リストを作成します。「アプリケーション、ページおよびページ・コンポーネントへのアクセスの制御」を参照してください。

2. 次のように、サポートするオブジェクト・ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。
「アプリケーション」ホームページが表示されます。

3. 「サポートするオブジェクト」をクリックします。
サポートするオブジェクト・ページが表示されます。

3. 「インストール」で、「インストール・スクリプト」をクリックします。
インストール・スクリプト・ページが表示されます。

4. 「作成」をクリックします。

5. ページの下部で、「アクセス制御表のスクリプトの作成」をクリックします。
アクセス制御表が定義されている場合は、スクリプトの作成ページに、含まれる表が表示されます。

6. 「スクリプトの作成」をクリックします。

サポートするオブジェクトのインストール

サポートするオブジェクトを編集した後、適切なスクリプトを作成し、「タスク」リストの「サポートするオブジェクトのインストール」をクリックしてインストール・スクリプトを実行できます。

アプリケーション定義をインポートおよびインストールした後、カスタム・パッケージ・アプリケーション(またはサポートするオブジェクト)をインストールしないことを選択する場合は、エンド・ユーザーもこの機能を使用できます。

サポートするオブジェクトをインストールするには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「サポートするオブジェクト」をクリックします。
サポートするオブジェクト・ページが表示されます。

4. 「タスク」リストで、「サポートするオブジェクトのインストール」をクリックします。

5. インストール・スクリプトを実行する前にその詳細を表示するには、「インストール・スクリプトのプレビュー」をクリックします。
スクリプトのプレビュー・ページが表示され、サマリー情報、前提条件および実行する実際のスクリプトがリストされます。

6. スクリプトのプレビュー・ページを終了して続行するには、「閉じる」をクリックします。

7. 「サポートするオブジェクトのインストール」から、「はい」をクリックし、「次へ」をクリックします。

8. 画面に表示されるステップに従います。

サポートするオブジェクトのスクリプト、メッセージ、およびインストール・オプションの削除

サポートするオブジェクト・ページの「タスク」リストの「サポートするオブジェクトのインストールの削除」をクリックすると、カスタム・パッケージ・アプリケーションに関連付けられたサポートするオブジェクトのスクリプト、メッセージおよびインストール・オプションを定義するメタデータを削除できます。

サポートするオブジェクトのスクリプト、メッセージおよびインストール・オプションを定義するメタデータを削除するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「サポートするオブジェクト」をクリックします。
サポートするオブジェクト・ページが表示されます。

4. ページの右側の「タスク」リストで、「サポートするオブジェクトのインストールの削除」をクリックします。

5. 画面に表示されるステップに従います。

カスタム・パッケージ・アプリケーションのアップグレード

アップグレード・ページで、前に公開されたアプリケーションをアップグレードするスクリプトを定義できます。

内容は次のとおりです。

- アップグレード・スクリプトの定義

- カスタム・パッケージ・アプリケーションのアップグレード

アップグレード・スクリプトの定義

アップグレード・ページを使用して、既存のアプリケーションをアップグレードする際に、データベース・オブジェクト、イメージおよびシード・データをアップグレードするスクリプトを定義できます。

アップグレード・スクリプトを作成するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「サポートするオブジェクト」をクリックします。
サポートするオブジェクト・ページが表示されます。

4. 「アップグレード」で、「アップグレード・スクリプト」をクリックします。
「既存のサポートするオブジェクトの検出」セクションを使用して、適切なオブジェクトをインストールするか、またはアップグレードする必要があるかを決定します。

5. 「既存のサポートするオブジェクトを検査する問合せ」で、フィールドに、サポートするオブジェクトが存在する場合に少なくとも1つの行を戻す問合せを入力します。
カスタム・パッケージ・アプリケーションをインストールするユーザーにインストール・スクリプトまたはアップグレード・スクリプトを実行するように求めるかどうかが、問合せにより決定されます。

6. スクリプトを作成するには、「作成」をクリックします。

ヒント:
このアプリケーションの様々な旧バージョンをユーザーがアップグレードできるようにするために、スクリプトのプロパティ・ページに移動してアップグレード・スクリプトに条件を追加できます。

7. 画面に表示されるステップに従います。

カスタム・パッケージ・アプリケーションのアップグレード

アップグレード・スクリプトの作成後、サポートするオブジェクト・ページの「タスク」リストの「サポートするオブジェクトのアップグレード」をクリックすることによりテストできます。

また、エンド・ユーザーもこの機能を使用して既存のカスタム・パッケージ・アプリケーションをアップグレードできます。

カスタム・パッケージ・アプリケーションをアップグレードするには、次のステップを実行します。

1. アップグレードする新しいバージョンのアプリケーションをインポートします(使用可能な場合)。「アプリケーション、ページまたはコンポーネントのエクスポートのインポート」を参照してください。

2. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

3. アプリケーションを選択します。

4. 「サポートするオブジェクト」をクリックします。
サポートするオブジェクト・ページが表示されます。

5. 「タスク」リストから、「サポートするオブジェクトのアップグレード」をクリックします。

6. 画面に表示されるステップに従います。

サポートするオブジェクトの削除

カスタム・パッケージ・アプリケーションを作成またはインストールすると、次のいずれかの方法で削除できます。

- サポートするオブジェクト・ページで、「サポートされているオブジェクトの削除」をクリックします

- 「アプリケーション」ホームページで、「このアプリケーションの削除」をクリックします

アプリケーションを削除する場合、現在のアプリケーション定義を削除して、サポートするオブジェクトに定義された削除スクリプトを実行するオプションがあります。

関連項目:
「カスタム・パッケージ・アプリケーションの作成」

カスタム・パッケージ・アプリケーションを削除するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「サポートするオブジェクト」をクリックします。
サポートするオブジェクト・ページが表示されます。

4. 「タスク」リストから、「サポートされているオブジェクトの削除」をクリックします。

5. 削除オプションを次のように選択します。

- アプリケーション定義の削除: 現在のアプリケーション定義を削除します。

- データベース・オブジェクトの削除: このアプリケーションのデプロイ属性に定義された削除スクリプトを実行します。

6. 画面に表示されるステップに従います。

インストール・サマリーの表示

サポートするオブジェクト・ページで、「タスク」リストの「インストール・サマリーの表示」をクリックすると、最近のインストール・ログおよび削除ログを表示できます。このログには、現在のApplication Expressセッション中に発生した最新のインストールまたは削除の結果のみ表示されることに注意してください。

インストール・サマリーを表示するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「サポートするオブジェクト」をクリックします。
サポートするオブジェクト・ページが表示されます。

4. ページの右側の「タスク」リストで、「インストール・サマリーの表示」をクリックします。
サマリー・ページが表示されます。

アプリケーションおよび関連ファイルのエクスポート

エクスポート・ページの上部にある「エクスポート」、「ワークスペース」、「アプリケーション」、「Webシート」、「ファイル」、「テーマ」、「プラグイン」、「デフォルト値」および「フィードバック」タブを使用して、アプリケーション定義とすべての関連ファイルをエクスポートします。

図export_tabs.gifの説明

ワークスペース・ユーザーを移行するか、ターゲット・インスタンス内で共有コンポーネント・サブスクリプションを複製する場合を除いて、ワークスペース全体をエクスポートする必要はありません。

アプリケーションとすべての関連ファイルをエクスポートしたら、それらをターゲットのOracle Application Expressインスタンスにインポートしてからインストールする必要があります。一般的に、常にアプリケーションをインポートしてから関連ファイルをインポートします。「別のインスタンスへのアプリケーションの移動方法」を参照してください。

ヒント:
カスタム・パッケージ・アプリケーションを作成すると、アプリケーションのデプロイに必要なステップを単純化できます。「カスタム・パッケージ・アプリケーションの作成方法」を参照してください。

内容は次のとおりです。

- イメージ、CSSおよびスクリプト・ファイルの格納先

- アプリケーションのエクスポート

- アプリケーション・コンポーネントのエクスポート

- ワークスペースのエクスポート

- アプリケーションのページのエクスポート

- Webシートのエクスポート

- カスケード・スタイルシートのエクスポート

- イメージのエクスポート

- 静的ファイルのエクスポート

- テーマのエクスポート

- プラグインのエクスポート

- スクリプト・ファイルのエクスポート

- ユーザー・インタフェースのデフォルト値のエクスポート

- フィードバックのエクスポート

- スクリプト・ファイルのエクスポート

イメージ、CSSおよびスクリプト・ファイルの格納先

実行時、Oracle Application Expressは、Oracle HTTP Serverとmod_plsql、または埋込みPL/SQLゲートウェイにアクセスする必要があります。イメージ、CSSおよびスクリプト・ファイルの格納先は、選択したHTTPサーバーによって異なります。

内容は次のとおりです。

- Oracle HTTP ServerまたはOracle Application Expressリスナーを使用する場合のイメージ、CSSおよびスクリプト・ファイルの検索

- 埋込みPL/SQLゲートウェイを使用する場合のイメージ、CSSおよびスクリプト・ファイルの検索

Oracle HTTP ServerまたはOracle Application Expressリスナーを使用する場合のイメージ、CSSおよびスクリプト・ファイルの検索

Oracle HTTP Server、Oracle Application ServerまたはOracle Application Expressリスナーの構成で、イメージは別名/i/で参照される場所のファイル・システムに格納されます。ファイル・システムでイメージ・ディレクトリを検出するには、次のファイルを参照して、テキスト別名/i/を検索してください。

- Oracle Database 11gで配布されたOracle HTTP Serverの場合: dads.confファイルを確認します。

- Oracle Application Server10gの場合: marvel.confファイルを参照します。

テキスト別名/i/を検出するための例は、Oracle Application Expressインストレーション・ガイドを参照してください。

埋込みPL/SQLゲートウェイを使用する場合のイメージ、CSSおよびスクリプト・ファイルの検索

埋込みPL/SQLゲートウェイを使用してOracle Application Expressを実行する場合、イメージは、Oracle XML DBリポジトリ内のデータベースに直接格納されます。イメージには、Oracle XML DBのWebDAV機能またはFTPを使用してアクセスできます。詳細は、『Oracle XML DB開発者ガイド』のプロトコルによるリポジトリへのアクセスに関する説明を参照してください。

アプリケーションのエクスポート

アプリケーションのエクスポート時に、Oracle Application ExpressによってPL/SQL APIコールを含むテキスト・ファイルが生成されます。

関連項目:
「アプリケーション・コンポーネントのエクスポート」

アプリケーションをエクスポートするには、次のステップを実行します。

1. エクスポート・ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーション・ビルダーのホームページで、「タスク」リストの「エクスポート」をクリックします。

2. エクスポート・ページで、「アプリケーション」タブをクリックします。

3. 「アプリケーションの選択」で、エクスポートするアプリケーションを選択します。

4. 「アプリケーションのエクスポート」で、次の項目を指定します。

1. ファイル形式: エクスポート・ファイルの行の形式を次のように選択します。

- UNIXを選択すると、改行で区切られた行が含まれるファイルが生成されます。

- DOSを選択すると、キャリッジ・リターンと改行で区切られた行が含まれるファイルが生成されます。

2. 新しい所有者: オプションで別の所有者を選択します。デフォルトでは、アプリケーションはアプリケーション属性の所有者で識別される所有者が所有します。

3. 新しいビルド・ステータス: 次のいずれかの項目を選択します。

- アプリケーションの実行のみ: 開発者は、アプリケーションの実行のみができます。

- アプリケーションの実行および構築: 開発者は、アプリケーションを実行および編集できます。

「アプリケーションの実行のみ」の選択は、他の開発者がアプリケーションを変更できないようにするために効果的な方法です。

ヒント:
「アプリケーションの実行のみ」を選択した場合は、引数p_traceをYesに設定できません。詳細は、「ビルド・オプションを使用した構成の制御」を参照してください。また、アプリケーションのインポート後にこの設定を変更する方法は、Oracle Application Express管理サービスにログインする以外ありません。Oracle Application Express管理ガイドの「デプロイ時のアプリケーションのビルド・ステータス・セットの変更」を参照してください。

4. デバッグ: 次のいずれかの項目を選択します。

- はい: デバッグが有効な状態でアプリケーションがエクスポートされます。

- いいえ: デバッグが無効な状態でアプリケーションがエクスポートされます。

5. 現在から: 適切な時点に戻り、使用するアプリケーションの以前のバージョンをエクスポートできます。たとえば、現在は削除されているオブジェクトを含むバージョンのアプリケーションをエクスポートするためにこのオプションを使用できます。表示されるフィールドに、時間を分単位で指定します。
このユーティリティは、DBMS_FLASHBACKパッケージを使用します。システム変更番号(SCN)マッピングへのタイムスタンプが約5分ごとにリフレッシュされるため、検索しているバージョンの検出にはそれと同じ時間がかかる場合があります。元に戻す情報が保持される時間は、起動パラメータUNDO_RETENTION(デフォルトは3時間)に影響されます。ただし、このパラメータはUNDO表領域のサイズにのみ影響します。2つのデータベースに同じUNDO_RETENTIONパラメータが含まれている場合でも、トランザクション数が少ないデータベースでは、UNDO表領域が一杯ではなく、以前のデータが強制的にアーカイブされるため、より前の時点に戻ることができます。

5. 「プリファレンスのエクスポート」で、次の項目を含めるか除外するために「はい」または「いいえ」を選択します。

- サポートするオブジェクトの定義をエクスポート:「カスタム・パッケージ・アプリケーションの作成方法」を参照してください。

- パブリック対話モード・レポートのエクスポート:「対話モード・レポートの保存」を参照してください。

- プライベート対話モード・レポートのエクスポート:「対話モード・レポートの保存」を参照してください。

- 対話モード・レポートのサブスクリプションのエクスポート:「対話モード・レポートの保存」を参照してください。

- 開発者コメントのエクスポート:「開発者コメントの追加」を参照してください。

- 翻訳のエクスポート

特定の属性の詳細を表示するには、アイテム・ラベルをクリックします。ヘルプが使用可能な場合は、アイテムにカーソルをあわせると、カーソルが疑問符付きの矢印に変わります。「フィールドレベル・ヘルプについて」を参照してください。

6. 「アプリケーションのエクスポート」をクリックします。

実際のアプリケーション・ファイルをエクスポートするのみでなく、カスケード・スタイルシート、イメージ、スクリプト・ファイルなど、その他の関連ファイルもエクスポートする必要がある場合があります。

関連項目:
「SQLトレースの有効化およびTKPROFの使用」

アプリケーション・コンポーネントのエクスポート

コンポーネントのエクスポート・ページ上のページの共有コンポーネントまたはコンポーネントをエクスポートできます。このウィザードを使用して次のことを実行できます。

- 別のアプリケーションまたはワークスペースへの共有コンポーネントまたはページ・コンポーネントのエクスポート

- コンポーネントの編集前のバックアップ

- 別のOracle Application Expressインスタンスへのパッチとして機能するエクスポートの作成

関連項目:
「アプリケーションのエクスポート」、「アプリケーションのページのエクスポート」、「アプリケーション、ページまたはコンポーネントのエクスポートのインポート」および「ビルド・オプションまたはビルド・オプション・ステータスのエクスポート」

共有コンポーネントまたはページ・コンポーネントをエクスポートするには、次のステップを実行します。

1. コンポーネントのエクスポート・ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「タスク」リストから「アプリケーション・コンポーネントのエクスポート」をクリックします。
「コンポーネントのエクスポート」ページが表示されます。

2. 次のタブをクリックして、エクスポートするコンポーネントを選択します。

- 「コンポーネント」には、共有アプリケーション・コンポーネントおよびページ全体が表示されます。ページ上部のナビゲーション・バーを使用してコンポーネントを検索します。「共有コンポーネントを使用する機能」および「ビルド・オプションまたはビルド・オプション・ステータスのエクスポート」を参照してください。

- 「ページ別のコンポーネント」には、選択したページのコンポーネントがリストされます。ページから選択して特定のページにナビゲートします。「Check All」をクリックして、すべてのコンポーネントを選択します。

- 「ビルド・オプションのステータス」には、使用可能なビルド・オプションが表示されます。このページを使用してビルド・オプションを選択および選択解除します。「ビルド・オプションまたはビルド・オプション・ステータスのエクスポート」を参照してください。

3. 「エクスポートに追加」をクリックします。

4. 「次へ」をクリックします。

5. エクスポートするコンポーネントに対して、次のステップを実行します。

1. 「ファイル形式」から、エクスポート・ファイルで行を書式設定する方法を選択します。

- UNIXを選択すると、改行で区切られた行が含まれるファイルが生成されます。

- DOSを選択すると、キャリッジ・リターンと改行で区切られた行が含まれるファイルが生成されます。

2. 事前に定義されたとおりにページをエクスポートするには、「現在から」フィールドを使用します。表示されるフィールドに、時間を分単位で指定します。
このユーティリティは、DBMS_FLASHBACKパッケージを使用します。システム変更番号(SCN)マッピングへのタイムスタンプが約5分ごとにリフレッシュされるため、検索しているバージョンの検出にはそれと同じ時間がかかる場合があります。元に戻す情報が保持される時間は、起動パラメータUNDO_RETENTION(デフォルトは3時間)に影響されます。ただし、このパラメータはUNDO表領域のサイズにのみ影響します。2つのデータベースに同じUNDO_RETENTIONパラメータが含まれている場合でも、トランザクション数が少ないデータベースでは、UNDO表領域が一杯ではなく、以前のデータが強制的にアーカイブされるため、より前の時点に戻ることができます。

3. 「コンポーネントのエクスポート」をクリックします。

ワークスペースのエクスポート

ワークスペースをエクスポートすることによって、アプリケーションが他のユーザーから使用可能になります。ワークスペースをエクスポートすると、Oracle Application Expressは、ユーザー、すべての定義されたユーザー・グループおよびチーム開発データのASCIIテキストのSQLスクリプトを作成します。

ワークスペースをエクスポートするには、次のステップを実行します。

1. エクスポート・ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーション・ビルダーのホームページの「タスク」リストで、「エクスポート」をクリックします。

2. エクスポート・ページで、「ワークスペース」タブをクリックします。

3. 「ワークスペースのエクスポート」で、次の項目を指定します。

- チーム開発を含める: 機能、マイルストン、To Do、バグ、フィードバック、リンク、ニュースなどのチーム開発データを含める場合は「はい」を設定します。そうでない場合は、「いいえ」を選択します。

- ファイル形式: エクスポート・ファイルでの行の書式設定の方法を選択します。

- UNIXを選択すると、改行で区切られた行が含まれるファイルが生成されます。

- DOSを選択すると、キャリッジ・リターンと改行で区切られた行が含まれるファイルが生成されます。

4. 「ワークスペースのエクスポート」をクリックします。

関連項目:
『Oracle Application Express管理ガイド』の「Application Expressユーザーの管理」

アプリケーションのページのエクスポート

「ページ定義」で「ページのエクスポート」アイコンをクリックすると、アプリケーション内の特定のページをエクスポートすることもできます。ページのエクスポート時に、エクスポートされるページが同じアプリケーションIDとワークスペースIDを持っている場合のみ正常にインポートされることを覚えておいてください。

関連項目:
「アプリケーション・コンポーネントのエクスポート」、「アプリケーションのエクスポート」および「アプリケーション、ページまたはコンポーネントのエクスポートのインポート」

アプリケーションのページをエクスポートするには、次のステップを実行します。

1. 該当する「ページ定義」にナビゲートします。「「ページ定義」へのアクセス」を参照してください。

2. 「ページ定義」で、右上隅にある「ページのエクスポート」アイコンをクリックします。
図export_pg_ico.gifの説明

ページのエクスポート・ウィザードが表示されます。

3. 「ページ」で、エクスポートするページを選択します。

4. 「ファイル形式」から、エクスポート・ファイルで行を書式設定する方法を選択します。

- UNIXを選択すると、改行で区切られた行が含まれるファイルが生成されます。

- DOSを選択すると、キャリッジ・リターンと改行で区切られた行が含まれるファイルが生成されます。

5. 事前に定義されたとおりにページをエクスポートするには、「現在から」フィールドを使用します。表示されるフィールドに、時間を分単位で指定します。
このユーティリティは、DBMS_FLASHBACKパッケージを使用します。システム変更番号(SCN)マッピングへのタイムスタンプが約5分ごとにリフレッシュされるため、検索しているバージョンの検出にはそれと同じ時間がかかる場合があります。元に戻す情報が保持される時間は、起動パラメータUNDO_RETENTION(デフォルトは3時間)に影響されます。ただし、このパラメータはUNDO表領域のサイズにのみ影響します。2つのデータベースに同じUNDO_RETENTIONパラメータが含まれている場合でも、トランザクション数が少ないデータベースでは、UNDO表領域が一杯ではなく、以前のデータが強制的にアーカイブされるため、より前の時点に戻ることができます。

6. 「ページのエクスポート」をクリックします。

Webシートのエクスポート

Webシートのエクスポート・ユーティリティを使用して、Webシート・アプリケーションを他のユーザーが使用できるようにします。

関連項目:
「Webシート・アプリケーションについて」

Webシート・アプリケーションをエクスポートするには、次のステップを実行します。

1. エクスポート・ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーション・ビルダーのホームページで、「エクスポート」をクリックします。

2. エクスポート・ページで、「Webシート」タブをクリックします。

3. 「Webシート・アプリケーション」で、エクスポートするWebシートを選択して、「アプリケーションの設定」をクリックします。

4. 画面の指示に従います。

カスケード・スタイルシートのエクスポート

エクスポート・カスケード・スタイルシート・ユーティリティを使用して、アップロードしたカスケード・スタイルシートをエクスポートできます。このユーティリティを使用して、アップロードしたカスケード・スタイルシートのみエクスポートできることに注意してください。

関連するカスケード・スタイルシートをエクスポートするには、次のステップを実行します。

1. エクスポート・ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーション・ビルダーのホームページの「タスク」リストで、「エクスポート」をクリックします。

2. エクスポート・ページで、「CSS」をクリックします。

3. 「カスケード・スタイルシートのエクスポート」ページで、次のステップを実行します。

1. スタイルシート: エクスポートするカスケード・スタイルシートを選択します。

2. ファイル形式: エクスポート・ファイルでの行の書式設定の方法を選択します。

- UNIXを選択すると、改行で区切られた行が含まれるファイルが生成されます。

- DOSを選択すると、キャリッジ・リターンと改行で区切られた行が含まれるファイルが生成されます。

3. 「スタイルシートのエクスポート」をクリックします。

関連項目:
「カスケード・スタイルシートのインポート」および「カスタム・カスケード・スタイルシートの使用」

イメージのエクスポート

エクスポート・イメージ・ユーティリティを使用して、アップロードしたイメージをエクスポートできます。このユーティリティを使用してイメージをエクスポートする場合、イメージはテキスト・ドキュメントに変換されます。このユーティリティを使用してアップロードしたイメージのみエクスポートできることに注意してください。

アップロードしたイメージをエクスポートするには、次のステップを実行します。

1. エクスポート・ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーション・ビルダーのホームページの「タスク」リストで、「エクスポート」をクリックします。

2. エクスポート・ページで、「イメージ」をクリックします。

3. 「イメージのエクスポート」ページで、次のステップを実行します。

1. 次のアプリケーションのイメージをエクスポート: イメージのエクスポート元のアプリケーションを選択します。
「ワークスペースイメージ」を選択した場合、特定のアプリケーションに関連付けられていないリポジトリ内のイメージのみがエクスポートされることに注意してください。すべてのイメージが特定のアプリケーションに関連付けられている場合、ワークスペースイメージのエクスポート・ファイルは空になります。

2. ファイル形式: エクスポート・ファイルでの行の書式設定の方法を選択します。

- UNIXを選択すると、改行で区切られた行が含まれるファイルが生成されます。

- DOSを選択すると、キャリッジ・リターンと改行で区切られた行が含まれるファイルが生成されます。

4. 「イメージのエクスポート」をクリックします。

関連項目:
「イメージのインポート」、「イメージの管理」および「イメージ・ファインダの使用」

静的ファイルのエクスポート

静的ファイルのエクスポート・ユーティリティを使用して、インポートした静的ファイルをエクスポートできます。このユーティリティを使用して、アップロードした静的ファイルのみエクスポートできることに注意してください。

関連する静的ファイルをエクスポートするには、次のステップを実行します。

1. エクスポート・ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーション・ビルダーのホームページで、「タスク」リストの「エクスポート」をクリックします。

2. エクスポート・ページで、「ファイル」をクリックします。

3. 静的ファイルのエクスポート・ページで、次のステップを実行します。

1. 静的ファイル: エクスポートするファイルを選択します。

2. ファイル形式: エクスポート・ファイルでの行の書式設定の方法を選択します。

- UNIXを選択すると、改行で区切られた行が含まれるファイルが生成されます。

- DOSを選択すると、キャリッジ・リターンと改行で区切られた行が含まれるファイルが生成されます。

3. 「ファイルのエクスポート」をクリックします。

別のOracle Application Expressインスタンスへのインポートについて

この項で説明したWebインタフェースを使用して、エクスポートした静的ファイルを別のOracle Application Expressインスタンスにインポートすることはできません。静的ファイルを別のOracle Application Expressインスタンスをインポートするには、データベースに接続してSQL*Plusを使用します。同じ名前とワークスペースIDを持つワークスペースからエクスポートおよびワークスペースにエクスポートする必要があることに注意してください。

テーマのエクスポート

テーマのエクスポート・ユーティリティを使用して、Oracle Application Expressの1つの開発インスタンスからファイルにテーマをエクスポートします。

関連項目:
「テーマのインポート」および「テーマの管理」

エクスポート・ページからのテーマのエクスポート

エクスポート・ページからアプリケーション・テーマをエクスポートするには、次のステップを実行します。

1. エクスポート・ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーション・ビルダーのホームページの「タスク」リストで、「エクスポート」をクリックします。

2. ページ上部の「テーマ」をクリックします。

3. テーマ・ページで、次のステップを実行します。

1. アプリケーション: アプリケーションを選択します。

2. テーマのエクスポート: エクスポートするテーマを選択します。

3. ファイル形式: エクスポート・ファイルでの行の書式設定の方法を選択します。

- UNIXを選択すると、改行で区切られた行が含まれるファイルが生成されます。

- DOSを選択すると、キャリッジ・リターンと改行で区切られた行が含まれるファイルが生成されます。

4. 「テーマのエクスポート」をクリックします。

テーマ・ページからのテーマのエクスポート

テーマ・ページからアプリケーション・テーマをエクスポートするには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「アプリケーション」ホームページで、「共有コンポーネント」をクリックします。

4. 「ユーザー・インタフェース」で、「テーマ」を選択します。
テーマ・ページが表示されます。

5. 「タスク」リストで、「テーマのエクスポート」をクリックします。

6. 「テーマ」ページで、次のステップを実行します。

1. アプリケーション: アプリケーションを選択します。

2. テーマのエクスポート: エクスポートするテーマを選択します。

3. ファイル形式: エクスポート・ファイルでの行の書式設定の方法を選択します。

- UNIXを選択すると、改行で区切られた行が含まれるファイルが生成されます。

- DOSを選択すると、キャリッジ・リターンと改行で区切られた行が含まれるファイルが生成されます。

4. 「テーマのエクスポート」をクリックします。

プラグインのエクスポート

プラグインのエクスポート・ユーティリティを使用して、Oracle Application Expressの1つの開発インスタンスからファイルにプラグインをエクスポートします。

エクスポート・ページからプラグインをエクスポートするには、次のステップを実行します。

1. エクスポート・ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーション・ビルダーのホームページの「タスク」リストで、「エクスポート」をクリックします。

2. 「プラグイン」をクリックします。

3. プラグイン・ページで、次のステップを実行します。

1. アプリケーション: アプリケーションを選択します。

2. プラグイン: エクスポートするプラグインを選択します。

3. ファイル形式: エクスポート・ファイルでの行の書式設定の方法を選択します。

- UNIXを選択すると、改行で区切られた行が含まれるファイルが生成されます。

- DOSを選択すると、キャリッジ・リターンと改行で区切られた行が含まれるファイルが生成されます。

4. 「プラグインのエクスポート」をクリックします。

ユーザー・インタフェースのデフォルト値のエクスポート

ユーザー・インタフェースのデフォルト値のエクスポートは、ターゲット・システムでの開発を予定している場合に便利です。ユーザー・インタフェースのデフォルト値は、表ディクショナリと属性ディクショナリの2つのカテゴリに分かれています。

- 表ディクショナリは、選択されたスキーマ内の表および列に固有です。これらのデフォルト値は、属性ディクショナリに定義されている値に優先して使用されます。

- 属性ディクショナリは、フォームとレポートの作成に使用する列についての属性のセットを含みます。定義は列名によって照合され、シノニムを使用することで特定の定義を複数の列間で共有できます。

ユーザー・インタフェースのデフォルト値をエクスポートする場合は、選択したディクショナリとスキーマに対するすべてのユーザー・インタフェースのデフォルト値が、1つのSQLコマンド・スクリプトにエクスポートされます。プロンプトが表示されたら、このファイルをハードディスク・ドライブに保存してください。このファイルには、アプリケーションのPL/SQL APIをコールして表のヒントを作成するAPIコールが含まれています。このファイルを使用して、ユーザー・インタフェースのデフォルト値を別のデータベースおよびOracle Application Expressインスタンスにインポートできます。

関連項目:
『Oracle Application Express SQLワークショップ・ガイド』の「ユーザー・インタフェースのデフォルト値のインポート」および「ユーザー・インタフェースのデフォルト値の管理」

エクスポート・ページからのユーザー・インタフェースのデフォルト値のエクスポート

エクスポート・ページからユーザー・インタフェースのデフォルト値をエクスポートするには、次のステップを実行します。

1. エクスポート・ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーション・ビルダーのホームページの「タスク」リストで、「エクスポート」をクリックします。

2. エクスポート・ページで、「ユーザー・インタフェースのデフォルト値」をクリックします。

3. ユーザー・インタフェースのデフォルト値のエクスポート - 表ディクショナリ・ページで、次のステップを実行します。

1. スキーマ: ユーザー・インタフェースのデフォルト値に関連付けられた表を所有するスキーマを選択します。

2. ファイル形式: エクスポート・ファイルでの行の書式設定の方法を選択します。

- UNIXを選択すると、改行で区切られた行が含まれるファイルが生成されます。

- DOSを選択すると、キャリッジ・リターンと改行で区切られた行が含まれるファイルが生成されます。

3. 「エクスポート」をクリックします。

4. 属性ディクショナリをエクスポートするには、「属性ディクショナリ」タブをクリックします。

5. 「エクスポート」をクリックします。

ユーザー・インタフェースのデフォルト値ページからのユーザー・インタフェースのデフォルト値のエクスポート

ユーザー・インタフェースのデフォルト値ページからユーザー・インタフェースのデフォルト値をエクスポートするには、次のステップを実行します。

1. ワークスペースホームページで、「SQLワークショップ」アイコンをクリックします。

2. 「ユーティリティ」をクリックします。

3. 「ユーザー・インタフェースのデフォルト値」をクリックします。
ユーザー・インタフェースのデフォルト値ページが表示されます。

4. エクスポートするディクショナリを選択します。

- 表ディクショナリの管理: 選択されたスキーマ内の特定の表と列をエクスポートするには、このボタンを選択します。

- 属性ディクショナリの管理: フォームとレポートを作成するために使用する列属性のセットをエクスポートするには、このボタンを選択します。

5. 「タスク」で、「エクスポート」をクリックします。

6. 表ディクショナリ・ページで、ファイル形式を選択します。

- UNIXを選択すると、改行で区切られた行が含まれるファイルが生成されます。

- DOSを選択すると、キャリッジ・リターンと改行で区切られた行が含まれるファイルが生成されます。

7. 「エクスポート」をクリックします。

フィードバックのエクスポート

フィードバックのエクスポート・ユーティリティを使用して、本番またはテスト・システムからのフィードバックを開発システムと同期します。開発システムは、ワークスペース情報の編集ページで設定されるワークスペース設定の「フィードバック同期のソース識別子」を使用することによって識別されます。開発システムからエクスポートする場合、エクスポート・プロセスには「デプロイメント・システム」という追加属性があり、更新されたフィードバックを同期するデプロイメント・システム(本番またはテスト)は、この属性で指定します。

フィードバックをエクスポートするには、次のステップを実行します。

1. エクスポート・ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーション・ビルダーのホームページの「タスク」リストで、「エクスポート」をクリックします。

2. エクスポート・ページで、「フィードバック」タブをクリックします。

3. 「フィードバックのエクスポート」で、次の項目を指定します。

- デプロイメント・システム: フィードバック・エントリをエクスポートするデプロイメント・システムの名前を選択します。

- 変更時期: エクスポートする最も古いフィードバックの日付を選択します。この選択された日付から現在の日付までのすべてのフィードバックがエクスポートされます。

- ファイル形式: エクスポート・ファイルの形式を選択します。

4. 「エクスポート」をクリックします。

5. 画面の指示に従います。

スクリプト・ファイルのエクスポート

エクスポートおよびインポート・タスクを使用して、選択したスクリプトを現行のスクリプト・リポジトリから別のワークスペース内のスクリプト・リポジトリに送信できます。

スクリプト・ファイルをエクスポートするには、次のステップを実行します。

1. ワークスペースホームページで、「SQLワークショップ」アイコンをクリックします。

2. 「SQLスクリプト」をクリックします。

3. 「タスク」リストで、「エクスポート」をクリックします。

4. 適切なスクリプト・ファイルを選択し、「エクスポートに追加」をクリックします。

5. ファイル名を確認し、「すべてのエクスポート」をクリックします。
スクリプトを削除するには、「削除」チェック・ボックスを選択します。

関連項目:
Oracle Application Express SQLワークショップ・ガイドの「SQLスクリプトの使用」

エクスポート・ファイルのインポート

アプリケーションとすべての関連ファイルをエクスポートしたら、それらをターゲットのOracle Application Expressインスタンスにインポートしてからインストールする必要があります。特定のリリースで作成されたアプリケーションを以前のバージョンにインポートすることはできません。一般的に、常にアプリケーションをインポートしてから関連ファイルをインポートします。「別のインスタンスへのアプリケーションの移動方法」を参照してください。

ヒント:
カスタム・パッケージ・アプリケーションを作成すると、アプリケーションのデプロイに必要なステップを単純化できます。「カスタム・パッケージ・アプリケーションの作成方法」を参照してください。

内容は次のとおりです。

- アプリケーション、ページまたはコンポーネントのエクスポートのインポート

- Webシートのインポート

- プラグインのインポート

- カスケード・スタイルシートのインポート

- イメージのインポート

- 静的ファイルのインポート

- テーマのインポート

- ユーザー・インタフェースのデフォルト値のインポート

- フィードバックのインポート

アプリケーション、ページまたはコンポーネントのエクスポートのインポート

アプリケーション、ページまたはコンポーネントのエクスポートをターゲットのOracle Application Expressインスタンスにインポートするには、次のステップを実行します。

1. 次のように、インポート・ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーション・ビルダーのホームページで、「インポート」をクリックします。

2. 「ファイルの指定」で、次のステップを実行します。

1. ファイルのインポート: ファイルにナビゲートします。

2. 「ファイル・タイプ」で、「アプリケーション、ページまたはコンポーネントのエクスポート」を選択します。

3. ファイルのキャラクタ・セットが正しいことを確認します。

4. 「次へ」をクリックします。

ファイルをインポートすると、ファイルをインストールするオプションが含まれています。

3. ファイルをインストールするには、「次へ」をクリックします。
アプリケーションのインストール・ウィザードが表示されます。

4. インストール・ウィザードで、次のステップを実行します。

1. 解析対象スキーマ: スキーマを選択します。
これが、アプリケーションのすべてのSQLおよびPL/SQLの解析対象となるスキーマです。

2. ビルド・ステータス: 次のいずれかの項目を選択します。

- アプリケーションの実行のみ: ユーザーはアプリケーションの実行のみ可能です。

- アプリケーションの実行および構築: ユーザーはアプリケーションの実行を、開発者はアプリケーションの実行および編集を行うことができます。

「アプリケーションの実行のみ」の選択は、他の開発者がアプリケーションを変更できないようにするために効果的な方法です。

ヒント:
「アプリケーションの実行のみ」を選択する場合、アプリケーションのインポート後にこの設定を変更する方法は、Oracle Application Express管理サービスにログインする以外ありません。Oracle Application Express管理ガイドの「デプロイ時のアプリケーションのビルド・ステータス・セットの変更」を参照してください。

3. 次のアプリケーションとしてインストール: 次のいずれかの項目を選択します。

- 新しいアプリケーションIDを自動割当て

- エクスポート・ファイルからアプリケーションIDを再利用

- アプリケーションIDの変更

これらのオプションは、アプリケーションIDの競合を回避するために使用します。これらのオプションは、同じインスタンスに同じアプリケーションの2つのバージョンをインストールする場合に役立ちます。たとえば、本番インスタンスにアプリケーションを移行しているが、まだ開発バージョンを保持する必要がある場合などです。

4. 「インストール」をクリックします。
カスタム・パッケージ・アプリケーション(サポートするオブジェクトを定義したアプリケーション)をインストールしている場合、インストーラはカスタム・パッケージ・インストール・スクリプトをインストールするよう要求します。画面に表示されるステップに従います。

関連項目:
「カスタム・パッケージ・アプリケーションの作成方法」

アプリケーション・グループのインポートについて

アプリケーション・グループはアプリケーションと共にエクスポートされます。アプリケーションのエクスポートには、グループID、名前およびコメントが含まれます。アプリケーションをインポートするときは、次のルールに従ってアプリケーションのインポートが行われます。

- インポートの際、アプリケーションはIDが一致すれば既存のグループを使用します。

- ターゲット・システム上に同じIDを持つアプリケーション・グループが存在しない場合は、アプリケーションのインポートで同じ名前を持つ別のグループIDが検索されます。名前の一致が検出されたら、このアプリケーション・グループ名に応じたIDを使用してアプリケーションがインポートされます。

- ターゲット・システムの既存のアプリケーション・グループとIDも名前も一致しない場合、新しいアプリケーション・グループが作成されます。新しいアプリケーション・グループは、IDがOracle Application Expressインスタンスで使用されていない場合、そのアプリケーション・グループIDを使用します。グループIDが使用されている場合、新しいIDが生成されます。

Webシートのインポート

関連項目:
「Webシート・アプリケーションについて」

WebシートをターゲットのOracle Application Expressインスタンスにインポートするには、次のステップを実行します。

1. 次のように、インポート・ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーション・ビルダーのホームページで、「インポート」をクリックします。

2. 「ファイルの指定」で、次のステップを実行します。

1. インポート・ファイル: ファイルにナビゲートします。

2. ファイル・タイプ: 「Webシート・アプリケーションのエクスポート」を選択します。

3. 「次へ」をクリックします。

ファイルをインポートすると、ファイルをインストールするオプションが含まれています。

3. インポートしたファイルをインストールするには、「次へ」をクリックします。
アプリケーションのインストール・ウィザードが表示されます。

4. アプリケーションのインストール・ウィザードで、次のステップを実行します。

1. 次のアプリケーションとしてインストール: 次のいずれかの項目を選択します。

- 新しいアプリケーションIDを自動割当て

- エクスポート・ファイルからアプリケーションIDを再利用

- アプリケーションIDの変更

これらのオプションは、アプリケーションIDの競合を回避するために使用します。これらのオプションは、同じインスタンスに同じアプリケーションの2つのバージョンをインストールする場合に役立ちます。たとえば、本番インスタンスにアプリケーションを移行しているが、まだ開発バージョンを保持する必要がある場合などです。

2. 「インストール」をクリックします。

プラグインのインポート

エクスポートしたプラグイン・ファイルをインポートするには、次のステップを実行します。

1. 次のように、インポート・ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーション・ビルダーのホームページで、「インポート」をクリックします。

2. 「ファイルの指定」で、次のステップを実行します。

1. インポート・ファイル: ファイルにナビゲートします。

2. ファイル・タイプ: 「プラグイン」を選択します。

3. ファイルのキャラクタ・セットが正しいことを確認します。

4. 「次へ」をクリックします。

ファイルをインポートすると、ファイルをインストールするオプションが含まれています。

3. インポートしたファイルをインストールするには、「次へ」をクリックします。

4. 「プラグインのインストール」をクリックします。

注意:
同じ名前のプラグインが存在する場合、既存のプラグインを上書きする権限を要求するダイアログが表示されます。

カスケード・スタイルシートのインポート

アプリケーションをターゲットのOracle Application Expressインスタンスにインポートした後に、すべての関連ファイルをインポートする必要があります。

CSSのエクスポート・ファイルをインポートするには、次のステップを実行します。

1. 次のように、インポート・ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーション・ビルダーのホームページで、「インポート」をクリックします。

2. 「ファイルの指定」で、次のステップを実行します。

1. インポート・ファイル: ファイルにナビゲートします。

2. ファイル・タイプ: 「CSSのエクスポート」を選択します。

3. ファイルのキャラクタ・セット: ファイルのキャラクタ・セットが正しいことを確認します。

4. 「次へ」をクリックします。

ファイルをインポートすると、ファイルをインストールするオプションが含まれています。

3. インポートしたファイルをインストールするには、「次へ」をクリックします。

4. 「CSSのインストール」をクリックします。

関連項目:
「カスタム・カスケード・スタイルシートの使用」および「カスケード・スタイルシートのエクスポート」

イメージのインポート

アプリケーションをターゲットのOracle Application Expressインスタンスにインポートした後に、すべての関連ファイルをインポートする必要があります。

イメージのエクスポート・ファイルをインポートするには、次のステップを実行します。

1. 次のように、インポート・ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーション・ビルダーのホームページで、「インポート」をクリックします。

2. 「定義のインポート」で、次のステップを実行します。

1. インポート・ファイル: ファイルにナビゲートします。

2. ファイル・タイプ: 「イメージのエクスポート」を選択します。

3. ファイルのキャラクタ・セット: ファイルのキャラクタ・セットが正しいことを確認します。

4. 「次へ」をクリックします。

ファイルをインポートすると、ファイルをインストールするオプションが含まれています。

3. インポートしたファイルをインストールするには、「次へ」をクリックします。

4. 「イメージのインストール」をクリックします。

関連項目:
「イメージの管理」、「イメージ・ファインダの使用」および「イメージのエクスポート」

静的ファイルのインポート

アプリケーションをターゲットのOracle Application Expressインスタンスにインポートした後に、すべての関連ファイルをインポートする必要があります。

静的ファイルをインポートするには、次のステップを実行します。

1. 次のように、インポート・ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーション・ビルダーのホームページで、「インポート」をクリックします。

2. 「ファイルの指定」で、次のステップを実行します。

1. インポート・ファイル: ファイルにナビゲートします。

2. ファイル・タイプ: 「エクスポート済のファイル」を選択します。

3. ファイルのキャラクタ・セット: ファイルのキャラクタ・セットが正しいことを確認します。

4. 「次へ」をクリックします。

ファイルをインポートすると、ファイルをインストールするオプションが含まれています。

3. インポートしたファイルをインストールするには、「次へ」をクリックします。

4. 「静的ファイルのインストール」をクリックします。

関連項目:
「静的ファイルのエクスポート」

テーマのインポート

アプリケーションをターゲットのOracle Application Expressインスタンスにインポートした後に、すべての関連ファイルをインポートする必要があります。

テーマのエクスポート・ファイルをインポートするには、次のステップを実行します。

1. 次のように、インポート・ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーション・ビルダーのホームページで、「インポート」をクリックします。

2. 「定義のインポート」で、次の内容を選択します。

1. インポート・ファイル: ファイルにナビゲートします。

2. ファイル・タイプ: 「エクスポート済のテーマ」を選択します。

3. ファイルのキャラクタ・セット: ファイルのキャラクタ・セットが正しいことを確認します。

4. 「次へ」をクリックします。

ファイルをインポートすると、ファイルをインストールするオプションが含まれています。

3. インポートしたファイルをインストールするには、「次へ」をクリックします。

4. 「テーマのインストール」をクリックします。

関連項目:
「テーマの管理」および「テーマのエクスポート」

ユーザー・インタフェースのデフォルト値のインポート

ユーザー・インタフェースのデフォルト値を使用して、指定したスキーマ内の表、列またはビューにデフォルトのユーザー・インタフェースのプロパティを割り当てることができます。

アプリケーションをターゲットのOracle Application Expressインスタンスにインポートした後に、すべての関連ファイルをインポートする必要があります。

ユーザー・インタフェースのデフォルト値をインポートするには、次のステップを実行します。

1. 次のように、インポート・ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーション・ビルダーのホームページで、「インポート」をクリックします。

2. アプリケーションを選択します。

3. 「定義のインポート」で、次のステップを実行します。

1. インポート・ファイル: ファイルにナビゲートします。

2. ファイル・タイプ: 「ユーザー・インタフェースのデフォルト値」を選択します。

3. ファイルのキャラクタ・セット: ファイルのキャラクタ・セットが正しいことを確認します。

4. 「次へ」をクリックします。

ファイルをインポートすると、ファイルをインストールするオプションが含まれています。

4. インポートしたファイルをインストールするには、「次へ」をクリックします。

5. 「ユーザー・インタフェースのデフォルト値のインストール」をクリックします。

関連項目:
Oracle Application Express SQLワークショップ・ガイドの「ユーザー・インタフェースのデフォルト値の管理」および「ユーザー・インタフェースのデフォルト値のエクスポート」

フィードバックのインポート

フィードバックをインポートするには、次のステップを実行します。

1. 次のように、インポート・ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーション・ビルダーのホームページで、「インポート」をクリックします。

2. 「フィードバック」を選択します。

3. 「ファイルのキャラクタ・セット」で、ファイルのキャラクタ・セットが正しいことを確認して、「次へ」をクリックします。
ファイルをインポートすると、ファイルをインストールするオプションが含まれています。

4. インポートしたファイルをインストールするには、「次へ」をクリックします。

5. フィードバックのインストールをクリックします。

エクスポート・ファイルのインストール

アプリケーションおよびすべての関連ファイルをターゲットのOracle Application Expressインスタンスにインポートすると、ファイルはエクスポート・リポジトリに格納されます。次に、そのファイルをインストールする必要があります。

次のようにエクスポート・ファイルをインストールできます。

- エクスポート・ファイルをインポートしたら、「インストール」ボタンをクリックして、画面に表示されるステップに従います。

- エクスポート・ファイルをアプリケーション・ビルダーにインポートした後、エクスポート・リポジトリからファイルをインストールします。

- エクスポート・ファイルをSQL*Plusからインストールします。

ヒント:
カスタム・パッケージ・アプリケーションを作成すると、アプリケーションのデプロイに必要なステップを単純化できます。「カスタム・パッケージ・アプリケーションの作成方法」を参照してください。

内容は次のとおりです。

- エクスポート・リポジトリへのアクセス

- エクスポート・リポジトリからのアプリケーション・エクスポートのインストール

- エクスポート・リポジトリからのその他ファイルのインストール

- エクスポート・リポジトリからのファイルの削除

- SQL*Plusからのエクスポート・ファイルのインストール

エクスポート・リポジトリへのアクセス

アプリケーションおよびすべての関連ファイルをターゲットのOracle Application Expressインスタンスにインポートすると、ファイルはエクスポート・リポジトリに格納されます。エクスポート・リポジトリを使用して、アーカイブされたアプリケーション・エクスポート、インポートおよびその他のファイルを管理できます。

エクスポート・リポジトリにアクセスするには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「アプリケーション」ホームページで、「ユーティリティ」をクリックします。

4. 「エクスポート・リポジトリ」をクリックします。
「エクスポート・リポジトリ」が表示されます。

エクスポート・リポジトリからのアプリケーション・エクスポートのインストール

Oracle Application Expressインスタンスにアプリケーション・エクスポートをインポートした後に、そのファイルがアプリケーション・ビルダーでアクティブまたは使用可能になる前にインストールする必要があります。

エクスポート・リポジトリからアプリケーション・エクスポートをインストールするには、次のステップを実行します。

1. エクスポート・リポジトリにナビゲートします。「エクスポート・リポジトリへのアクセス」を参照してください。

2. アプリケーション・エクスポートを選択して、「アクション」列で「インストール」をクリックします。

3. 次を指定します。

1. 解析対象スキーマ: スキーマを選択します。
このスキーマに対して、すべてのアプリケーションのSQLおよびPL/SQLが解析されます。

2. ビルド・ステータス: 次のいずれかの項目を選択します。

- アプリケーションの実行のみ

- アプリケーションの実行および構築

ターゲット・インスタンスでアプリケーションを実行し、開発者がアクセスできないようにするには、「Run Application Only」を選択します。

ヒント:
「アプリケーションの実行のみ」を選択する場合、アプリケーションのインポート後にこの設定を変更する方法は、Oracle Application Express管理サービスにログインする以外ありません。Oracle Application Express管理ガイドの「デプロイ時のアプリケーションのビルド・ステータス・セットの変更」を参照してください。

3. 次のアプリケーションとしてインストール: 次のいずれかの項目を選択します。

- 新しいアプリケーションIDを自動割当て

- エクスポート・ファイルからアプリケーションIDを再利用

- アプリケーションIDの変更

これらのオプションは、アプリケーションIDの競合を回避するために使用します。これらのオプションは、同じインスタンスに同じアプリケーションの2つのバージョンをインストールする必要がある場合に使用します。たとえば、本番インスタンスにアプリケーションを移行しているが、まだ開発バージョンを保持する必要がある場合などです。

4. 「インストール」をクリックします。

カスタム・パッケージ・アプリケーションのインストールについて

カスタム・パッケージ・アプリケーションをインストールしている場合、インストーラはカスタム・パッケージ・インストール・スクリプトをインストールするよう要求します。画面に表示されるステップに従います。

関連項目:
「カスタム・パッケージ・アプリケーションの作成方法」

エクスポート・リポジトリからのその他ファイルのインストール

Oracle Application Expressインスタンスにファイルをインポートした後、そのファイルがアプリケーション・ビルダーでアクティブまたは使用可能になる前にインストールする必要があります。

エクスポート・リポジトリに格納されたファイルをインストールするには、次のステップを実行します。

1. エクスポート・リポジトリにナビゲートします。「エクスポート・リポジトリへのアクセス」を参照してください。

2. インストールするファイルを選択して、「アクション」列で「インストール」をクリックします。

3. 画面に表示されるステップに従います。

エクスポート・リポジトリからのファイルの削除

エクスポート・リポジトリからファイルを削除できます。

エクスポート・リポジトリからファイルを削除するには、次のステップを実行します。

1. エクスポート・リポジトリにナビゲートします。「エクスポート・リポジトリへのアクセス」を参照してください。

2. 削除するファイルを選択し、「チェックした項目の削除」をクリックします。

SQL*Plusからのエクスポート・ファイルのインストール

エクスポート・ファイルはSQL*Plusからもインストールできます。

エクスポート・ファイルには次の制限が適用されます。

- エクスポート・ファイルは、インストール先と同じユーザー・データベース・アカウントで作成されている必要があります。

- エクスポート・ファイルがデータベース・アプリケーションの場合は、アプリケーションIDが上書きされます。そのため、ターゲットワークスペースは、インストールするアプリケーションのIDを所有している必要があります。

- エクスポート・ファイルにサポートするオブジェクトのスクリプトが含まれる場合は、アプリケーションをインストールする際、スクリプトは実行されません。アプリケーション・ビルダーにログインしてサポートするオブジェクトをインストールするか、またはインストール・スクリプトをスタンドアロンSQL*Plusスクリプトにコピーしてそこからインストール・スクリプトを実行できます。

- エクスポート・ファイルがWebシート・アプリケーションの場合、ターゲット・ワークスペースにWebシート・データベース・オブジェクト設定が存在する必要があります。

- エクスポート・ファイルがWebシート・アプリケーションの場合、エクスポート・ファイルはWebシート・スキーマを使用してターゲット・ワークスペースにインストールする必要があります。

- エクスポート・ファイルがWebシート・アプリケーションの場合は、アプリケーションIDが上書きされます。

内容は次のとおりです。

- SQL*Plusを使用したエクスポート・ファイルのインストール

SQL*Plusを使用したエクスポート・ファイルのインストール

Oracle Application Expressエクスポート・ファイルをSQL*Plusからインストールするには、次のステップを実行します。

1. SQL*Plusにログインします。

2. エクスポート・ファイルを実行します。
たとえば、エクスポート・ファイルの名前がデフォルトでf144.sqlの場合は、コマンド・プロンプトで@f144と入力します。

データベース・アプリケーションURLの公開について

アプリケーションのデプロイ、データのロードおよびユーザーの作成が終了すると、本番URLを公開できます。アプリケーションへのURLは、次のいずれかの方法で指定できます。

- 「アプリケーション」ホームページでアプリケーションを選択し、「実行」ボタンを右クリックします。次に、ブラウザに応じて、リンク・アドレスのコピーまたはリンク場所のコピーを選択します。

- アプリケーションを実行してからURLをコピーします。

「実行」アイコンは、セキュリティ属性の編集ページのホーム・リンク属性から値を取得します。このリンクを参照するのは、このアイコンと、Oracle Application ExpressログインAPIを使用しないアプリケーションのみです。次に例を示します。

http://apex.somewhere.com/pls/apex/f?p=11563:1:3397731373043366363

説明:

- apex.somewhere.comは、サーバーのURLです。

- plsは、mod_plsqlカートリッジを使用するためのインジケータです。

- apexは、データベース・アクセス記述子(DAD)名です。DADはHTTPリクエストを実行できるようにOracle HTTP Serverがデータベース・サーバーに接続する方法を示します。デフォルト値はapexです。

- f?p=は、Oracle Application Expressによって使用される接頭辞です。

- 11563は、コールされるアプリケーションです。

- 1は、表示されるアプリケーション内のページです。

- 3397731373043366363は、セッション番号です。

このサンプル・アプリケーションを実行するには、次のURLを使用します。

http://apex.somewhere.com/pls/apex/f?p=11563:1

ユーザーはログイン時に一意のセッション番号を受信します。URLにはセッション番号を含めないでください。

関連項目:
「定義の編集ページへのアクセス」

Webシート・アプリケーションURLの公開について

Webシート・アプリケーションを完成した後で、本番URLを公開できます。Webシート・アプリケーションへのURLは、次のいずれかの方法で指定できます。

- 「アプリケーション」ホームページでWebシート・アプリケーションを選択し、「実行」ボタンを右クリックします。その後、使用するブラウザに応じて、「Copy link address」または「Copy link location」を選択します。

- アプリケーションを実行し、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に含めないでください。

ビルド・オプションを使用した構成の制御

ビルド・オプションを使用すると、アプリケーションで特定の機能を条件付きで表示できます。

ビルド・オプションは、INCLUDEおよびEXCLUDEという2つの値をとることができます。属性を含めるように指定すると、Application Expressエンジンは、実行時にその属性をアプリケーション定義の一部として認識します。逆に、属性を除外するように指定すると、Application Expressエンジンは、その属性を存在しないものとして処理します。

内容は次のとおりです。

- ビルド・オプションの作成

- ビルド・オプションの管理

- ビルド・オプションまたはビルド・オプション・ステータスのエクスポート

- ビルド・オプションの使用状況レポートの表示

関連項目:
『Oracle Application Express管理ガイド』の「複数のアプリケーションのビルド・ステータスの変更」を参照してください。

ビルド・オプションの作成

ビルド・オプション・ページのアプリケーションに対してビルド・オプションを作成します。

ビルド・オプションを作成するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「アプリケーション」ホームページで、「共有コンポーネント」をクリックします。

4. 「ロジック」で、「ビルド・オプション」をクリックします。

5. 新しいビルド・オプションを作成するには、「作成」をクリックします。

6. 画面に表示されるステップに従います。

ビルド・オプションの管理

ビルド・オプションは、INCLUDEおよびEXCLUDEという2つの値をとることができます。属性を含めるように指定すると、Application Expressエンジンは、実行時にその属性をアプリケーション定義の一部として認識します。逆に、属性を除外するように指定すると、Application Expressエンジンは、その属性を存在しないものとして処理します。

ビルド・オプションを含めるまたは除外するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「アプリケーション」ホームページで、「共有コンポーネント」をクリックします。

4. 「ロジック」で、「ビルド・オプション」をクリックします。
ビルド・オプション・ページが表示されます。

5. ページの外観は、ページ上部にある検索バーを使用して変更できます。使用可能なコントロールは次のとおりです。

- 検索列の選択: 虫めがねに似ています。このアイコンをクリックして、検索を絞り込みます。すべての列を検索するには、「すべての列」を選択します。

- テキスト領域: 名前でビルド・オプションを検索するための大/小文字を区別しない検索基準(ワイルドカード文字は暗黙的に定義される)を入力し、「実行」をクリックします。

- 「実行」ボタン: 検索を実行したり、フィルタを適用します。

- アイコンの表示: 各ビルド・オプションを大きいアイコンとして表示します。ビルド・オプションを編集するには、該当するアイコンをクリックします。

- レポートの表示: 各ビルド・オプションをレポート内の1行として表示します。ビルド・オプションを編集するには、「名前」をクリックします。

- 「アクション」メニュー: 「アクション」メニューを使用して、レポート・ビューをカスタマイズします。「「アクション」メニューについて」を参照してください。

6. ビルド・オプション名を選択します。
ビルド・オプションの作成/編集ページが表示されます。

7. 「ステータス」で、「INCLUDE」または「EXCLUDE」のいずれかを選択します。

ビルド・オプションの選択

ビルド・オプションを作成すると、ページ、コンポーネント(レポート、グラフまたはフォーム)、特定のページ・コントロール(ボタン・アイテム、LOV)、および別の共有コンポーネント(ブレッドクラム、リストまたはタブ)に対して選択できます。適切な属性ページに移動して、ビルド・オプションをページ、コンポーネント、ページ・コントロールまたは共有コンポーネントに適用します。ほとんどの属性ページには、定義済のビルド・オプションを選択できる「構成」セクションがあります。

関連項目:
「ページ属性の変更」

ビルド・オプションまたはビルド・オプション・ステータスのエクスポート

コンポーネントのエクスポート・ページで、ビルド・オプションまたはビルド・オプション・ステータスをエクスポートできます。ビルド・オプション・ステータスのエクスポートは、別の環境内でビルド・オプションをオンまたはオフに切り替えるために効果的な方法です。たとえば、この機能を使用して、隠し機能を備えた本番アプリケーションをデプロイできます。

これを行うには、隠し機能のあるコンポーネントとEXCLUDEのステータスを持つビルド・オプションを関連付けます。デプロイ後、ビルド・オプションのステータスをINCLUDEに変更して、ビルド・オプション・ステータスをエクスポートすると隠し機能を有効化できます。

ビルド・オプション・ステータスを本番インスタンスに適用すると、新しい機能が表示されます。

関連項目:
「カスタム・パッケージ・アプリケーションの作成方法」および「アプリケーション・コンポーネントのエクスポート」

ビルド・オプションまたはビルド・オプション・ステータスをエクスポートするには、次のステップを実行します。

1. コンポーネントのエクスポート・ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「タスク」リストから「アプリケーション・コンポーネントのエクスポート」をクリックします。
「コンポーネントのエクスポート」ページが表示されます。

2. エクスポートするビルド・オプションを次のように選択します。

1. 「コンポーネント」タブをクリックして、エクスポートするビルド・オプションを選択します。

2. 「エクスポートに追加」をクリックします。

3. 次のように、エクスポートする「ビルド・オプションのステータス」を選択します。

1. 「ビルド・オプションのステータス」タブをクリックして、エクスポートするビルド・オプションを選択します。

2. 「エクスポートに追加」をクリックします。

4. 「次へ」をクリックします。

5. エクスポートするコンポーネントに対して、次のステップを実行します。

1. 「ファイル形式」から、エクスポート・ファイルの行を形式化する方法を選択します。

- UNIXを選択すると、改行で区切られた行が含まれるファイルが生成されます。

- DOSを選択すると、キャリッジ・リターンと改行で区切られた行が含まれるファイルが生成されます。

2. 事前に定義されたとおりにページをエクスポートするには、「現在から」フィールドを使用します。表示されるフィールドに、時間を分単位で指定します。
このユーティリティは、DBMS_FLASHBACKパッケージを使用します。システム変更番号(SCN)マッピングへのタイムスタンプが約5分ごとにリフレッシュされるため、検索しているバージョンの検出にはそれと同じ時間がかかる場合があります。元に戻す情報が保持される時間は、起動パラメータUNDO_RETENTION(デフォルトは3時間)に影響されます。ただし、このパラメータはUNDO表領域のサイズにのみ影響します。2つのデータベースに同じUNDO_RETENTIONパラメータが含まれている場合でも、トランザクション数が少ないデータベースでは、UNDO表領域が一杯ではなく、以前のデータが強制的にアーカイブされるため、より前の時点に戻ることができます。

3. 「コンポーネントのエクスポート」をクリックします。

ビルド・オプションの使用状況レポートの表示

ビルド・オプションを作成すると、ビルド・オプション・ページに「使用状況」タブが表示されます。このレポートには、カレント・アプリケーションでのビルド・オプションの使用状況が詳述されます。

注意:
「使用状況」タブは、ビルド・オプションを作成した後のビルド・オプション・ページにのみ表示されます。

ビルド・オプションの使用状況レポートを表示するには、次のステップを実行します。

1. 「ビルド・オプション」ページにナビゲートします。

1. 「ワークスペース」ホームページにナビゲートします。

2. 「アプリケーション・ビルダー」アイコンをクリックします。

3. 「アプリケーション」ホームページで、「共有コンポーネント」をクリックします。

4. 「アプリケーション」で、「ビルド・オプション」をクリックします。
ビルド・オプション・ページが表示されます。

2. ビルド・オプション・ページで、「使用状況」をクリックします。
ビルド・オプションの使用状況レポートが表示されます。

3. ビルド・オプションを選択して、「実行」をクリックします。

17 高度なプログラミング手法

このセクションでは、自動的なデータ操作言語を使用した作業、データベース・リンクの確立、コレクションの使用、バックグラウンドSQLの実行、Webサービスの使用、ユーザー・プリファレンスの管理など、高度なプログラミング手法について説明します。

内容は次のとおりです。

- DMLロックについて

- データベース・リンクを使用したデータへのアクセス

- アプリケーションからの電子メール送信

- コレクションの使用

- APEX_ACTIVITY_LOGを使用したカスタム・アクティビティ・レポートの作成

- バックグラウンドPL/SQLの実行

- Webサービスの実装

- プラグインの実装

- 動的アクションの実装

- フォームおよびレポートでのBLOBサポートについて

- データベース・アプリケーションでのスクリーン・リーダー・モードの使用

- データベース・アプリケーションでのハイ・コントラスト・モードの使用

- データ・ロード機能によるアプリケーションの作成

- コンポーネント設定の管理

関連項目:
Oracle Application Express APIリファレンスおよび「アプリケーションのデプロイ」

DMLロックについて

自動的なデータ操作言語(DML)が表内の行を更新または削除するためにOracle Application Expressで使用される場合、トランザクションが開始されるとまず行をロックし、ページに表示されてから変更されたかどうかを確認して、最後に行に対するUPDATEまたはDELETE文を発行します。

行のロックが頻繁に発生する一部の環境では、DML操作を制御してDML操作が次の状態かどうかを判別する場合があります。

- 無期限に待機

- 即時に失敗

- 指定した一定時間待機

APEX_DML_LOCK_WAIT_TIMEについて

アプリケーション置換文字列、アプリケーション・アイテムまたはページ・アイテムの値をAPEX_DML_LOCK_WAIT_TIMEに設定すると、DML操作を制御できます。サポートされている値は次のとおりです。

- NULLの場合(デフォルト)、Oracle Application Expressの以前のバージョンと同じ動作、つまり、無期限に待機します。

- 0の場合、他のデータベース・セッションによって行がロックされていると、即時に失敗します。

- 0以上で行がロックされている場合、指定した秒数間待機します。

アプリケーションで設定する場合、APEX_DML_LOCK_WAIT_TIMEの値はアプリケーション全体の自動DMLを使用するすべてのUPDATEおよびDELETE DML操作に適用されます。特定の自動DMLプロセスを制御するには、自動DMLプロセスの前にAPEX_DML_LOCK_WAIT_TIMEの値を更新して、自動DMLプロセスの後にリセットします。これは、表形式フォームを使用した更新および削除には影響しないことに注意してください。

FSP_DML_LOCK_ROWについて

アプリケーション置換文字列、アプリケーション・アイテムまたはページ・アイテムの値をFSP_DML_LOCK_ROWに設定して、DML操作を制御することもできます。サポートされている値は次のとおりです。

- 値をFALSEに設定すると、SELECT FOR UPDATEは発行されません。

- 値がFALSE以外の場合は、自動DMLを使用してUPDATEまたはDELETE DML操作を発行すると、SELECT FOR UPDATEのデフォルトの動作が実行されます。

データベース・リンクを使用したデータへのアクセス

ワークスペースのホームページはOracle Database上で実行されるため、ユーザーは、すべての分散Oracle Database機能を使用できます。通常、分散データベース操作は、データベース・リンクを使用して実行します。

データベース・リンクは1つのデータベースのスキーマ・オブジェクトであり、これを使用すると、別のデータベース上のオブジェクトにアクセスできます。データベース・リンクを作成すると、表名またはビュー名に@dblinkを追加することによって、リモート・オブジェクトにアクセスできます。この場合のdblinkは、データベース・オブジェクトの作成ウィザードで指定するデータベース・リンク名です。

注意:
デフォルトでは、CREATE DATABASE LINKシステム権限は、割り当てられたワークスペースまたはデータベース・ユーザーに付与されません。この機能を使用するには、DBAまたは管理者が、この特定の権限をユーザーのワークスペースのデータベース・ユーザーに付与する必要があります。『Oracle Database管理者ガイド』のデータベース・リンクの作成に関する説明を参照してください。

データベース・リンクを作成するには、次のステップを実行します。

1. ワークスペースホームページで、「SQLワークショップ」をクリックして、「オブジェクト・ブラウザ」をクリックします。
オブジェクト・ブラウザ・ホームページが表示されます。

2. 「作成」をクリックします。

3. 「データベース・リンク」を選択して、「次へ」をクリックします。

4. 画面に表示されるステップに従います。
データベース・リンク名は、Oracleのネーミング規則に従う必要があり、空白を含めたり、数字やアンダースコアから開始することはできません。

既存のデータベース・リンクを表示するには、次のステップを実行します。

1. ワークスペースホームページで、「SQLワークショップ」をクリックして、「オブジェクト・ブラウザ」をクリックします。
オブジェクト・ブラウザが表示されます。

2. ページ上部のオブジェクト・タイプ「データベース・リンク」を選択します。

関連項目:
Oracle Application Express SQLワークショップ・ガイドの「オブジェクト・ブラウザでのデータベース・オブジェクトの管理」、およびOracle Database管理者ガイドの「データベース・リンク」

アプリケーションからの電子メール送信

APEX_MAILパッケージを使用してOracle Application Expressアプリケーションから電子メールを送信できます。このパッケージは、Oracleで提供されるUTL_SMTPパッケージをベースとして構築されています。このような依存性があるため、APEX_MAILを使用するには、UTL_SMTPパッケージがインストールされており、機能している必要があります。

関連項目:
UTL_SMTPパッケージの詳細は、Oracle Database PL/SQLパッケージおよびタイプ・リファレンスを参照してください。

APEX_MAILには3つのプロシージャが含まれています。アプリケーションから外部へ電子メール・メッセージを送信するには、APEX_MAIL.SENDを使用します。APEX_MAIL_QUEUEに格納されたメール・メッセージを配信するには、APEX_MAIL.PUSH_QUEUEを使用します。アプリケーションから外部へ添付ファイルとして電子メール・メッセージを送信するには、APEX_MAIL.ADD_ATTACHMENTを使用します。Oracle Application Express用のすべてのApplication Program Interfaceパッケージについては、『Oracle Application Express APIリファレンス』に記載されています。

関連項目:
『Oracle Application Express APIリファレンス』のAPEX_MAILに関する説明および『Oracle Application Express管理ガイド』のメールの構成に関する説明

コレクションの使用

コレクションを使用すると、1つ以上の非スカラー値を一時的に取得できます。コレクションを使用して、現在セッション・ステートにある行および列を格納します。これによって、あるユーザーの特定のセッション中にそれらの行および列に対してアクセス、操作または処理を行うことができます。コレクションは、バケツのようなものと考えることができます。その中に情報の行を一時的に格納し、その情報を指定できます。

次に、コレクションを使用する場合の例を示します。

- データ入力ウィザードを作成しており、そのウィザードで、まず論理トランザクション中に複数行の情報を収集する必要がある場合。物理トランザクションと論理トランザクションの両方の完了時、ウィザードの最終ステップを実行する前に、コレクションを使用して、複数行の情報のコンテンツを一時的に格納できます。

- アプリケーションに、ユーザーが1つのページで複数の詳細行を更新する更新ページが含まれている場合。ユーザーは、複数の更新を行い、それらの更新をコレクションに適用した後、最終プロセスをコールしてそれらの変更をデータベースに適用できます。

- 任意の数の属性を収集するウィザードを構築している場合。コレクションに一時的に格納された情報が取得され、データベースに適用されるタスクをウィザードの最後にユーザーが実行するようにします。

コレクション情報は、PL/SQL API APEX_COLLECTIONを使用して挿入、更新および削除します。Oracle Application Express用のApplication Program Interfaceパッケージの詳細は、『Oracle Application Express APIリファレンス』を参照してください。

関連項目:
『Oracle Application Express APIリファレンス』のAPEX_COLLECTIONに関する説明

APEX_ACTIVITY_LOGを使用したカスタム・アクティビティ・レポートの作成

APEX_ACTIVITY_LOGビューには、開発者アクティビティ、アプリケーション実行時アクティビティなど、ワークスペースのすべてのアクティビティが記録されます。APEX_ACTIVITY_LOG使用して、現在のワークスペースに関するすべてのアクティビティの問合せを表示できます。たとえば、このビューを使用して、リアルタイムのパフォーマンス分析を提供する特定のアプリケーション内の監視レポートを開発できます。

表 17-1に、APEX_ACTIVITY_LOGビューの列を示します。

表 17-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ブラウザ・ユーザー・エージェントが含まれます。

次に、アプリケーション9529に関する過去24時間のページ・ビュー合計数および平均ページ・ビュー時間がユーザーID別に表示されるレポートを作成する方法の例を示します。

SELECT COUNT(*), AVG(elap), userid
FROM APEX_ACTIVITY_LOG
WHERE time_stamp > (SYSDATE-1)
AND flow_id = 9529
GROUP BY userid

Oracle Application Expressインスタンスでのアクティビティのロギングは2つの異なるログ表を順番に使用することに注意してください。このため、ロギング情報はログのうち古い方の使用可能なエントリのみとなります。アプリケーションの特定のログ情報を常に保持する場合は、所有するアプリケーション表に両方のログ情報をコピーするか、アプリケーションに直接ロギングを実装する必要があります。

関連項目:
定義の編集ページで、有効なロギングの情報に関する「名前」を参照してください。

バックグラウンドPL/SQLの実行

APEX_PLSQL_JOBパッケージを使用すると、アプリケーションのバックグラウンドでPL/SQLコードを実行できます。操作が完了していない状態でもユーザーがアプリケーションで作業を継続できるため、長時間実行操作の管理に有効な方法です。

APEX_PLSQL_JOBは、Oracle Databaseで提供されるDBMS_JOB機能をラップしたラッパー・パッケージです。APEX_PLSQL_JOBパッケージでは、PL/SQLをバックグラウンドで実行するために必要な機能のみが公開されることに注意してください。

表17-2に、APEX_PLSQL_JOBパッケージで使用可能なファンクションを示します。

表 17-2 APEX_PLSQL_JOBパッケージ: 使用可能なファンクション

ファンクションまたはプロシージャ

説明

SUBMIT_PROCESS

このプロシージャを使用すると、バックグラウンドPL/SQLを送信できます。このプロシージャは、一意のジョブ番号を戻します。このジョブ番号は、このパッケージ内の他のプロシージャおよびファンクションの参照点として使用できるため、自分のスキーマ内に格納しておくと役に立ちます。

UPDATE_JOB_STATUS

このプロシージャをコールすると、現在実行しているジョブのステータスを更新できます。このプロシージャは、送信されたPL/SQLからコールされたときに最も有効です。

TIME_ELAPSED

このファンクションを使用すると、ジョブが送信されてから経過した時間を確認できます。

JOBS_ARE_ENABLED

このファンクションをコールすると、そのデータベースが現在、APEX_PLSQL_JOBパッケージへのジョブの送信をサポートするモードであるかどうかを確認できます。

PURGE_PROCESS

このプロシージャをコールすると、送信されたジョブをクリーンアップできます。送信されたジョブは、Oracle Application Expressによってそれらのレコードがクリーンアップされるか、またはPURGE_PROCESSのコールによって手動で削除するまで、APEX_PLSQL_JOBSビューに保持されます。

APEX_PLSQL_JOBパッケージに送信したすべてのジョブは、APEX_PLSQL_JOBビューで表示できます。

Oracle Application Express用のすべてのApplication Program Interfaceパッケージについては、『Oracle Application Express APIリファレンス』に記載されています。

関連項目:
Oracle Application Express APIリファレンスの「APEX_PLSQL_JOB」

システム・ステータスの更新について

送信されたジョブには、次のいずれかのシステム・ステータス設定が含まれています。

- SUBMITTED: ジョブが送信済であるが、開始されていないことを示します。DBMS_JOBでは、ジョブの即時開始は保証されていません。

- IN PROGRESS: DBMS_JOBがプロセスを開始したことを示します。

- COMPLETED: ジョブが完了したことを示します。

- BROKEN (sqlcode) sqlerrm: ジョブに問題があり、エラーが発生したことを示します。エラーが発生したことを示すSQLコードおよびSQLエラー・メッセージがシステム・ステータスに表示されます。この情報を参照して、エラーの原因を判別してください。

プロセスを使用したバックグラウンドPL/SQLの実装

テストおよび説明用に、PL/SQLジョブをバックグラウンドで実行する例を次に示します。

001  BEGIN
002    FOR i IN 1 .. 100 LOOP
003      INSERT INTO emp(a,b) VALUES (:APP_JOB,i);
004      IF MOD(i,10) = 0 THEN
005        APEX_PLSQL_JOB.UPDATE_JOB_STATUS(
006          P_JOB     => :APP_JOB,
007          P_STATUS  => i || 'rows inserted');
008      END IF;
009      APEX_UTIL.PAUSE(2);
010    END LOOP;
011  END;

この例の説明を次に示します。

- 002から010行では、100個のレコードをemp表に挿入するループを実行します。

- APP_JOBは、INSERTのVALUE句内でバインド変数として参照され、UPDATE_JOB_STATUSへのコール内でP_JOBパラメータの値として指定されます。

- APP_JOBは、APEX_PLSQL_JOBに送信される際に、このプロセスに割り当てられるジョブ番号を表します。プロセス・コード内にこの予約アイテムを指定すると、実行時に実際のジョブ番号に置換されます。

- この例では、コード・ブロック内で、10個のレコードごとにUPDATE_JOB_STATUSがコールされることに注意してください。通常、Oracleトランザクション規則では、コード・ブロック内で実行された更新は、トランザクション全体がコミットされるまで表示されません。一方、APEX_PLSQL_JOB.UPDATE_JOB_STATUSプロシージャは、ジョブが成功したか失敗したかにかかわらず更新を実行するように実装されています。このことは、次の2つの理由から重要です。

1. ステータスが「100 rows inserted」の場合でも、操作全体が成功したわけではありません。コード・ブロックでコミットが試行されたときにエラーが発生した場合、ステータスの更新は個別にコミットされるため、APEX_PLSQL_JOBSのuser_status列は影響を受けません。

2. 更新は自律的に実行されます。ジョブが完了する前にジョブ・ステータスを表示できます。これによって、バックグラウンドで実行中の各操作についてステータス・テキストを表示できます。

Webサービスの実装

Webサービスを使用すると、プラットフォームおよび言語に依存しない環境で、Webを介したアプリケーション間の通信が可能になります。通常のWebサービス・シナリオでは、ビジネス・アプリケーションが、HTTPプロトコルを使用して、特定のURLにあるサービスに対してリクエストを送信します。サービスは、リクエストを受信すると、これを処理し、レスポンスを返します。外部Webサービスへのコールをアプリケーション・ビルダーで開発されたアプリケーションに組み込むことができます。

通常、Webサービスは、Simple Object Access Protocol(SOAP)またはRepresentational State Transfer(REST)アーキテクチャに基づいています。SOAPは、World Wide Web Consortium (W3C)が策定した、インターネットを介したリクエストとレスポンスの送受信用の標準プロトコルです。SOAPメッセージは、サービス・プロバイダとサービス・ユーザー間でSOAPエンベロープに入れて送受信できます。RESTful Webサービスはリソース指向です。WebサービスのスコープはURI内から検出され、サービスのメソッドは使用されるHTTPメソッドによって記述されます。これらのHTTPメソッドには、GET、POST、PUT、HEADおよびDELETEなどがあります。

SOAPには、主に2つのメリットがあります。

- SOAPはXMLをベースとしており、使用方法も容易です。

- このプロトコルではHTTPなどの単純な転送プロトコルが使用されているため、SOAPメッセージはファイアウォールでブロックされることはありません。

ヒント:
Oracle Application ExpressをOracle Database 11gリリース1 (11.1)以上と同時に実行する場合は、Webサービスを使用するためにネットワーク・サービスを有効にする必要があります。「Oracle Database 11gおよびOracle Database 12cのネットワーク・サービスの有効化」を参照してください。

RESTには、同様のメリットがあります。

- このプロトコルではHTTPプロトコルが使用されるため、RESTメッセージもファイアウォールでブロックされません。

- RESTリクエストではXMLエンベロープやSOAPエンベロープのオーバーヘッドが不要であり、入力は、通常、URI内に指定されます。

内容は次のとおりです。

- Webサービス参照の理解

- SSL有効Webサービスでの作業

- WSDLに基づいたWebサービス参照の作成

- Webサービス参照の手動作成

- RESTful Webサービス参照の作成

- Webサービス参照リポジトリの使用

- WSDLから作成されたWebサービス参照のテスト

- 手動作成されたWebサービス参照のテスト

- REST Webサービス参照のテスト

- Webサービスでの入力フォームとレポートの作成

- Webサービスでのフォームの作成

- プロセスとしてのWebサービスの起動

- Webサービス・プロセスの編集

- Webサービス参照履歴の表示

- RESTful Webサービスとしてのレポート・リージョンの公開

注意:
SOAP 1.1仕様はW3C技術ノートです。SOAPバージョン1.2仕様はW3C勧告です。
Simple Object Access Protocol(SOAP)については、次のWebサイトを参照してください。

http://www.w3.org/TR/SOAP/

Webサービス参照の理解

Oracle Application ExpressでWebサービスを使用するには、ウィザードを使用してWebサービス参照を作成します。Webサービス参照は、Web Services Description Language(WSDL)ドキュメントに基づくか、RESTfulスタイルに基づくか、サービスに関する情報を指定して手動で作成することができます。

WSDLに基づいてWebサービス参照を作成する場合、ウィザードはWSDLを分析し、すべての必要な情報を収集して、次を含んだ有効なSOAPメッセージを作成します。

- HTTP(S)を介したSOAPリクエストのポストに使用するURL

- SOAP HTTPリクエストを識別するUniversal Resource Identifier(URI)

- Webサービスの操作

- 各操作の入力パラメータ

- 各操作の出力パラメータ

手動でWebサービス参照を作成する場合、必要な情報を指定して、次を含んだ有効なSOAPリクエストを作成します。

- HTTP(S)を介したSOAPリクエストのポストに使用するURL

- SOAP HTTPリクエストを識別するUniversal Resource Identifier(URI)

- アイテムの置換を含んだリクエストのSOAPエンベロープ

- オプションで、Webサービスからのレスポンスを格納するコレクション名

RESTful Webサービス参照を作成する場合、次を含むリクエストおよびレスポンスの構造に関する必要な情報を指定します。

- RESTfulリクエストを識別するUniversal Resource Identifier(URI)

- Webサービスのメソッドを識別するHTTPメソッド

- リクエストの一部であるHTTPヘッダー(必要に応じて)

- Webサービスに必要な入力のタイプ

- レスポンスの書式およびレスポンス・パラメータの識別方法

Webサービス参照ページへのアクセス

Webサービス参照は、Webサービス参照ページで管理します。

Webサービス参照ページにアクセスするには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。
アプリケーション・ビルダーのホームページが表示されます。

2. アプリケーションを選択します。
アプリケーションのホームページが表示されます。

3. 「共有コンポーネント」をクリックします。
「共有コンポーネント」ページが表示されます。

4. 「ロジック」で、「Webサービス参照」をクリックします。
Webサービス参照ページが表示されます。

アプリケーション・プロキシ・サーバー・アドレスの指定

インターネットのアクセスにプロキシ・サーバーが必要な環境の場合は、Webサービス参照を作成する前にアプリケーション属性ページでプロキシ・サーバー・アドレスを指定する必要があります。

アプリケーションにプロキシ・アドレスを指定するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。
アプリケーション・ビルダーのホームページが表示されます。

2. アプリケーションを選択します。
「アプリケーション」ホームページが表示されます。

3. 「アプリケーション・プロパティの編集」をクリックします。

4. 「プロパティ」で、「プロキシ・サーバー」フィールドにプロキシ・サーバーを入力します。

5. 「変更の適用」をクリックします。

SSL有効Webサービスでの作業

Secure Sockets Layer(SSL)は、RSA公開鍵による暗号化と対称鍵による暗号化を使用して、認証、暗号化およびデータの整合性を実現する業界標準プロトコルです。

通信する必要のあるWebサービスがSSL有効Webサービスの場合(つまり、Webサービスに対するURLにhttpsと表示される)、ウォレットを作成し、そのウォレットがOracle Application Expressによって使用されるように構成する必要があります。ウォレットは、SSLに必要な認証および署名された資格証明(秘密鍵、証明書および信頼できる証明書)の格納に使用されるパスワード保護されたコンテナです。

関連項目:
Oracle Application Express管理ガイドの「ウォレット情報の構成」

WSDLに基づいたWebサービス参照の作成

WSDLに基づいたWebサービス参照を作成する場合、WSDLの位置の特定方法を決定する必要があります。WSDLの位置の特定には、次の2つの方法があります。

- Universal Description, Discovery and Integration (UDDI)レジストリを検索する

- WSDLドキュメントのURLを入力する

UDDIレジストリは企業がWebサービスを登録するディレクトリです。

内容は次のとおりです。

- UDDIレジストリの検索によるWebサービス参照の作成

- WSDLドキュメントの指定によるWebサービス参照の作成

UDDIレジストリの検索によるWebサービス参照の作成

UDDIレジストリを検索して、Webサービスを作成するには、次のステップを実行します。

1. Webサービス参照ページにナビゲートします。「Webサービス参照ページへのアクセス」を参照してください。

2. 「作成」をクリックします。

3. 「WSDLに基づく」を選択し、「次へ」をクリックします。

4. WSDLを検出するためにUDDIレジストリを検索することを確認するプロンプトが表示されたら、「はい」の次に「次へ」をクリックします。

5. 「UDDIの位置」で、UDDIレジストリへのURLエンドポイントを入力し、「次へ」をクリックします。

6. 「検索」で、次を指定します。

1. 検索タイプ: ビジネス名またはサービス名のどちらを検索するかを指定します。両方を検索することはできません。

2. 名前: 検索に使用するビジネス名またはサービス名を入力します。ワイルドカードにはパーセント(%)を使用します。

3. オプションで、完全一致検索または大文字/小文字を区別する検索を指定できます。

4. 「検索」をクリックします。

5. 検索結果が表示されたら、選択した後で「次へ」をクリックします。

選択したWebサービスについて説明するサマリー・ページが表示されます。

7. 選択内容を確認し、「次へ」をクリックして続行します。
WSDLドキュメントへのURLが「WSDLの位置」フィールドに表示されます。

8. 「終了」をクリックします。

Webサービス参照がWebサービス参照リポジトリに追加されます。

WSDLドキュメントの指定によるWebサービス参照の作成

特定のWSDLドキュメントへのURLを指定して、Webサービスを作成するには、次のステップを実行します。

1. Webサービス参照ページにナビゲートします。「Webサービス参照ページへのアクセス」を参照してください。

2. 「作成」をクリックします。

3. 「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サービス参照の手動作成

Webサービス参照を手動作成するには、次のステップを実行します。

1. Webサービス参照ページにナビゲートします。「Webサービス参照ページへのアクセス」を参照してください。

2. 「作成」をクリックします。

3. 「手動」を選択し、「次へ」をクリックします。
Webサービスの作成/編集ページが表示されます。

4. 「Webサービス」の「名前」で、参照を識別する名前を入力します。

5. 「サービスの説明」で、次の変更を加えます。

1. URL: HTTPを介したSOAPリクエストのポストに使用するURLを入力します。これは、WSDLのサービス・ポートのsoap:addressの位置に対応します。

2. アクション: SOAP HTTPリクエストの目的を入力します(オプション)。値は目的を識別するURIです。SOAPは、URIの形式や特性、または変換可能かどうかについて制限を加えません。

3. プロキシ: このサービスのアプリケーション・プロキシを上書きするプロキシを入力します。

4. SOAPのバージョン: 「1.1」または「1.2」を選択します。

5. Basic認証: Webサービスが認証を必要とするかどうかを選択します。「はい」または「いいえ」を選択します。

6. 「SOAPエンベロープ」の「SOAPエンベロープ」で、WebサービスへのSOAPリクエストに使用するSOAPエンベロープを入力します。

注意:
#ITEM_NAME#構文を使用すると、SOAPエンベロープのセッション・ステートからアイテムを参照できます。

7. 「SOAPレスポンス」の「コレクションにレスポンスを格納」で、レスポンスを格納するコレクション名を入力します(オプション)。レスポンスはCLOB001列に格納されます。

8. 「作成」をクリックします。

Webサービス参照がWebサービス参照リポジトリに追加されます。

RESTful Webサービス参照の作成

アプリケーションからRESTful Webサービスを使用する場合、RESTful Webサービス参照を作成する必要があります。

RESTful Webサービス参照を作成するには、次のステップを実行します。

1. Webサービス参照ページにナビゲートします。「Webサービス参照ページへのアクセス」を参照してください。

2. 「作成」をクリックします。

3. 「REST」を選択して「次へ」をクリックします。

4. 「RESTの詳細」で、次の項目を指定します。

1. 名前: 参照を識別する名前を入力します。

2. URL: WebサービスのURLエンドポイントを入力します。

3. プロキシ: このサービスのアプリケーション・プロキシを上書きするプロキシを入力します(オプション)。この設定は、このインスタンスのプロキシ設定によって上書きされます。『Oracle Application Express管理ガイド』のインスタンスのプロキシ・サーバーの作成に関する説明を参照してください。

4. HTTPメソッド: Webサービスへのリクエストに使用するhttpメソッドを選択します。「GET」、「HEAD」、「POST」、「PUT」または「DELETE」を選択します。

5. 基本認証: HTTP基本認証が必要な場合は「はい」を選択します。そうでない場合は、「いいえ」を選択します。

6. REST HTTPヘッダー: リクエストで送信するHTTPヘッダーの名前を入力します。

7. 「次へ」をクリックします。

5. 「REST入力パラメータ」で、次の項目を指定します。

1. 名前: メソッドに必要な入力パラメータの名前を入力します。

2. タイプ: 入力タイプを選択します。

3. 「パラメータの追加」をクリックします。

4. 必要な各入力に対して、ステップaからcを繰り返します。

5. 「次へ」をクリックします。

6. 「REST出力パラメータ」で、次の項目を指定します。

1. 出力形式: Webサービスから返されるレスポンス形式について「XML」、「テキスト」または「JSON」を選択します。

2. 出力パラメータへのXPath(XMLのみ): レスポンスの関連部分へのXPath式を入力します。
次に例を示します。

/ListBucketResult/Contents

3. レスポンス・ネームスペース(XMLのみ): レスポンスXPathに対応する名前空間を入力します。
次に例を示します。

http://s3.amazonaws.com/doc/2006-03-01/

4. パラメータ・デリミタ(テキストのみ): Webサービスから返されるパラメータを区切る文字またはシーケンスを入力します。新しい行を表すには\nを、タブ文字を表すには\tを使用します。

5. 新規レコード・デリミタ(テキストのみ): Webサービスからのテキスト・レスポンスに含まれる新規レコードを特定する文字またはシーケンスを入力します。新しい行を表すには\nを、タブ文字を表すには\tを使用します。

6. 名前: メソッドによって戻される出力パラメータの名前を入力します。

7. パス: パスを入力します。レスポンスがXMLの場合、パスはノードへのXPath式です。レスポンスがテキストの場合、パスは数値です。レスポンスがJSONの場合、レスポンス全体が指定したコレクションのCLOB001列に格納されます。

8. タイプ: 出力タイプを選択します。

9. 「パラメータの追加」をクリックします。

10. 返される各出力パラメータに対して、ステップfからhを繰り返します。

注意:
「テスト」をクリックしてRESTful Webサービスにリクエストを送信し、レスポンスを確認します。このテスト・プロセスは、適切な出力パラメータを指定する際に役立ちます。

7. 「作成」をクリックします。

Webサービス参照の作成成功ページが表示されます。Webサービス参照がWebサービス参照リポジトリに追加されます。

Webサービス参照リポジトリの使用

Webサービス参照がWebサービス参照リポジトリに格納されます。

Webサービス参照リポジトリにアクセスするには、次のステップを実行します。

1. Webサービス参照ページにナビゲートします。「Webサービス参照ページへのアクセス」を参照してください。
Webサービス参照ページが表示されます。

ページの上部に検索バーが表示されます。使用可能なコントロールは次のとおりです。

- 「列の検索」アイコン: 虫めがねに似ています。このアイコンをクリックして、検索を絞り込みます。すべての列を検索するには、「すべての列」を選択します。

- テキスト領域: 大/小文字を区別しない検索基準(ワイルドカード文字は暗黙的に定義される)を入力し、「実行」をクリックします。

- 「実行」ボタン: 検索を実行したり、フィルタを適用します。

- アイコンの表示: 各Webサービス参照を大きいアイコンとして表示します。Webサービス参照を編集するには、該当するアイコンをクリックします。

- レポートの表示: 各Webサービス参照をレポート内の1行として表示します。

- アクション・メニュー: アクション・メニューを表示します。レポート・ビューをカスタマイズするにはこのメニューを使用します。「「アクション」メニューについて」を参照してください。

2. 「レポートの表示」アイコンをクリックします。

3. レポート・ビューでは、次の操作が可能です。

- 参照名をクリックして参照を編集します。

- 「テスト」アイコンをクリックして参照をテストします。

- 「ビュー」アイコンをクリックして参照に関する詳細を表示します。このオプションは、手動作成されたWebサービス参照またはREST Webサービス参照には使用できないことに注意してください。

WSDLから作成されたWebサービス参照のテスト

Webサービス参照を作成した後、Webサービス参照のテスト・ページでテストできます。

Webサービス参照をテストするには、次のステップを実行します。

1. Webサービス参照ページにナビゲートします。「Webサービス参照ページへのアクセス」を参照してください。

2. 「レポートの表示」アイコンを選択します。

3. テストするWebサービス参照の「テスト」アイコンをクリックします。
Webサービス参照のテスト・ページが表示されます。ページの上部に、Webサービス名とURLエンドポイントが表示されます。

4. 「操作」から、実行する操作を選択します。

5. 「入力パラメータ」で、適切な値を入力します。

6. 「テスト」をクリックします。
メッセージのリクエストとレスポンスがページの下部の「メッセージ」の下に表示されます。

手動作成されたWebサービス参照のテスト

Webサービス参照を作成した後、Webサービス参照のテスト・ページでテストできます。

Webサービス参照をテストするには、次のステップを実行します。

1. Webサービス参照ページにナビゲートします。「Webサービス参照ページへのアクセス」を参照してください。

2. 「レポートの表示」アイコンを選択します。

3. テストするWebサービス参照の「テスト」アイコンをクリックします。
Webサービス参照のテスト・ページが表示されます。ページの上部に、Webサービス名とURLエンドポイントが表示されます。

4. 必要に応じて、「Basic認証」でユーザー名およびパスワードを入力します。

5. 「SOAPエンベロープ」テキスト領域では、オプションで、SOAPリクエスト・エンベロープを編集します。

6. 「テスト」をクリックします。
ページの下部の「メッセージ」の下に、メッセージ・リクエストとレスポンスが表示されます。

REST Webサービス参照のテスト

Webサービス参照を作成した後、Webサービス参照のテスト・ページでテストできます。

Webサービス参照をテストするには、次のステップを実行します。

1. Webサービス参照ページにナビゲートします。「Webサービス参照ページへのアクセス」を参照してください。

2. 「レポートの表示」アイコンを選択します。

3. テストするWebサービス参照の「テスト」アイコンをクリックします。
Webサービス参照のテスト・ページが表示されます。ページの上部に、Webサービス名とURLエンドポイントが表示されます。

4. 「URL」および「プロキシ・オーバーライド」フィールドで、オプションでテストの値を編集します。

5. 必要に応じて、「Basic認証」でユーザー名およびパスワードを入力します。

6. 「HTTPヘッダー」で、適切な値を入力します。

7. 「入力パラメータ」で、適切な値を入力します。

8. 「テスト」をクリックします。
ページの下部の「メッセージ」の下にメッセージのレスポンスが表示されます。

Webサービスでの入力フォームとレポートの作成

Webサービスのフォームとレポートの作成ウィザードでは、入力フォーム、送信ボタンおよび結果を表示するレポートが作成されます。WSDLまたはRESTfulスタイルWebサービスからWebサービス参照を作成した直後に、またはページを追加して、このウィザードを実行できます。

このウィザードは、Webサービスの結果が非スカラーであることが予想される場合に使用します。Amazon社のProduct API Webサービスがよい例です。このWebサービスでは、入力フォームに入力された検索基準に基づいて多くの結果が戻されます。

参照を作成した後のフォームとレポートの作成

Webサービス参照を作成した後に、フォームとレポートを作成するには、次のステップを実行します。

1. Webサービス参照を作成します。「WSDLに基づいたWebサービス参照の作成」および「RESTful Webサービス参照の作成」を参照してください。

2. Webサービス参照が追加された後で、「Webサービスのフォームとレポートの作成」を選択します。

3. 「サービスと操作の選択」で、次の選択を行い、「次へ」をクリックします。

1. Webサービス参照: Webサービス参照を選択します。

2. 操作: 実行方法を選択します。RESTスタイルWeb参照の場合、「doREST」を選択します。

3. ユーザー・インタフェース: デスクトップのフォームとレポートを作成するには、「デスクトップ」を選択します。モバイル・フォンのフォームとレポートを作成するには、「jQuery Mobileスマートフォン」を選択します。「jQuery Mobileスマートフォン」オプションは、アプリケーション・プロパティのユーザー・インタフェース・オプションで「jQuery Mobileスマートフォン」が選択されている場合にのみ使用できます。「アプリケーションのユーザー・インタフェースの管理」を参照してください。

4. 「ページおよびリージョン属性」で、表示された属性を確認し、「次へ」をクリックします。

注意:
指定したページが存在しない場合は、ウィザードによってページが作成されます。

5. 「入力アイテム」で、次の選択を行い、「次へ」をクリックします。

1. フォームに追加するアイテムを指定します。アイテムを含めるには、「作成」列で「はい」を選択します。そうでない場合は、「いいえ」を選択します。

2. 必要に応じて、アイテム名を編集します。

3. 必要に応じて、アイテム・ラベルを編集します。

6. 該当する場合、基本認証に「アイテム名」および「アイテム・ラベル」を指定し、「次へ」をクリックします。

注意:
このステップは、Webサービス参照を作成したときに、基本認証がこのWebサービス参照に対して指定された場合にのみ表示されます。

7. 「Webサービスの結果」で、次の選択を行い、「次へ」をクリックします。

1. 一時結果セット名: Webサービスの結果を格納するコレクションの名前を入力します。

2. レポート対象の結果ツリー(RESTスタイルWebサービス参照では表示されない): レポートに含める情報を格納する、作成されるXML文書の一部を選択します。

8. 「レポート・パラメータ」で、レポートに含めるパラメータを選択し、「次へ」をクリックします。

9. 「タブ・オプション」で、ページにタブを含めるかどうか、およびタブの作成方法を選択し、「次へ」をクリックします。

10. 確認ページを確認して、「作成」をクリックします。

新しいページの追加によるフォームとレポートの作成

既存のWebサービス参照がある場合は、新しいページを追加して、入力フォームとレポートを作成できます。

新しいページを追加して、フォームとレポートを作成するには、次のステップを実行します。

1. Webサービス参照を作成します。「WSDLに基づいたWebサービス参照の作成」、「Webサービス参照の手動作成」および「RESTful Webサービス参照の作成」を参照してください。

2. 新しいページを作成します。「データベース・アプリケーションのページの管理」を参照してください。
「ページの作成」ウィザードで、次のステップを実行します。

1. 「ユーザー・インタフェース」で、デスクトップのフォームとレポートを作成するには、「デスクトップ」を選択します。携帯電話用のフォームとレポートを作成する場合は、「jQuery Mobileスマートフォン」を選択します。「jQuery Mobileスマートフォン」オプションは、アプリケーション・プロパティのユーザー・インタフェース・オプションで「jQuery Mobileスマートフォン」が選択されている場合にのみ使用可能です。「アプリケーションのユーザー・インタフェースの管理」を参照してください。

2. 「フォーム」を選択して、「次へ」をクリックします。

3. 「Webサービスのフォームとレポート」を選択し、「次へ」をクリックします。

3. 「サービスと操作の選択」で、次の選択を行い、「次へ」をクリックします。

1. Webサービス参照: Webサービス参照を選択します。

2. 操作: 実行方法を選択します。RESTfulスタイルWeb参照の場合、doRESTが自動的に選択されます。手動スタイルWeb参照については、「操作」オプションは表示されません。

4. 「ページおよびリージョン属性」で、ページおよびリージョン属性を確認し、「次へ」をクリックします。

注意:
指定したページが存在しない場合は、ウィザードによってページが作成されます。

5. 「入力アイテム」で、次の選択を行い、「次へ」をクリックします。

1. フォームに追加するアイテムを指定します。アイテムを含めるには、「作成」列で「はい」を選択します。そうでない場合は、「いいえ」を選択します。

2. 必要に応じて、アイテム名を編集します。

3. 必要に応じて、アイテム・ラベルを編集します。

6. 該当する場合、基本認証に「アイテム名」および「アイテム・ラベル」を指定し、「次へ」をクリックします。

注意:
このステップは、Webサービス参照を作成したときに、Basic認証がこのWebサービス参照に対して指定された場合にのみ表示されます。

7. 画面に表示されるステップに従います。

8. 「終了」をクリックします。

Webサービスでのフォームの作成

Webサービスのフォームの作成ウィザードでは、フォームと送信ボタンが作成されます。WSDLから、またはRESTfulスタイルのWebサービスで、Webサービス参照を作成した後に、または「ページ定義」から、このウィザードを実行できます。

このウィザードは、Webサービスの結果がスカラーであることが予想される場合に使用します。株価を調べるWebサービスがよい例です。入力は銘柄記号で、出力はスカラーの適正価格であるためです。

参照を作成した後のフォームの作成

Webサービス参照を作成した後に、フォームを作成するには、次のステップを実行します。

1. Webサービス参照を作成します。「WSDLに基づいたWebサービス参照の作成」、「RESTful Webサービス参照の作成」および「Webサービス参照の手動作成」を参照してください。

2. Webサービス参照が追加された後で、「Webサービスのフォームの作成」を選択します。

3. 「サービスと操作の選択」で、次の選択を行い、「次へ」をクリックします。

1. Webサービス参照: Webサービス参照を選択します。

2. 操作: 実行方法を選択します。RESTfulスタイルWeb参照の場合、doRESTが自動的に選択されます。手動スタイルWeb参照については、「操作」オプションは表示されません。

3. ユーザー・インタフェース: デスクトップ用のフォームとレポートを作成する場合は、「デスクトップ」を選択します。携帯電話用のフォームとレポートを作成する場合は、「jQuery Mobileスマートフォン」を選択します。「jQuery Mobileスマートフォン」オプションは、アプリケーション・プロパティのユーザー・インタフェース・オプションで「jQuery Mobileスマートフォン」が選択されている場合にのみ使用可能です。「アプリケーションのユーザー・インタフェースの管理」を参照してください。

4. 「ページおよびリージョン属性」で、ページおよびリージョンの属性を確認し、「次へ」をクリックします。

注意:
指定したページが存在しない場合は、ウィザードによってページが作成されます。

5. 「入力アイテム」で、次の選択を行い、「次へ」をクリックします。

1. フォームに追加するアイテムを指定します。アイテムを含めるには、「作成」列で「はい」を選択します。そうでない場合は、「いいえ」を選択します。

2. 必要に応じて、アイテム名を編集します。

3. 必要に応じて、アイテム・ラベルを編集します。

6. 該当する場合、Basic認証に「アイテム名」および「アイテム・ラベル」を指定して「次へ」をクリックします。

注意:
このステップは、Webサービス参照を作成したときに、Basic認証がこのWebサービス参照に対して指定された場合にのみ表示されます。

7. 該当する場合、Basic認証に「アイテム名」および「アイテム・ラベル」を指定します。
このステップは、Webサービス参照を作成したときに、Basic認証がこのWebサービス参照に対して指定された場合にのみ表示されることに注意してください。

8. 「出力アイテム」で、次の選択を行い、「次へ」をクリックします。

1. フォームに追加するアイテムを指定します。アイテムを含めるには、「作成」列で「はい」を選択します。そうでない場合は、「いいえ」を選択します。

2. 必要に応じて、アイテム名を編集します。

3. 必要に応じて、アイテム・ラベルを編集します。

9. 「タブ・オプション」で、ページにタブを含めるかどうかとタブの作成方法を選択し、「次へ」をクリックします。

10. 確認ページを確認して、「作成」をクリックします。

新しいページの追加によるフォームの作成

既存のWebサービス参照がある場合は、新しいページを追加して、Webサービス参照に基づいてフォームを作成できます。

新しいページを追加して、フォームを作成するには、次のステップを実行します。

1. Webサービス参照を作成します。「WSDLに基づいたWebサービス参照の作成」、「RESTful Webサービス参照の作成」および「Webサービス参照の手動作成」を参照してください。

2. 新しいページを作成します。「データベース・アプリケーションのページの管理」を参照してください。
「ページの作成」ウィザードで、次のステップを実行します。

1. 「ユーザー・インタフェース」で、「デスクトップ」を選択して、デスクトップのフォームおよびレポートを作成します。携帯電話用のフォームとレポートを作成する場合は、「jQuery Mobileスマートフォン」を選択します。「jQuery Mobileスマートフォン」オプションは、アプリケーション・プロパティのユーザー・インタフェース・オプションで「jQuery Mobileスマートフォン」が選択されている場合にのみ使用可能です。「アプリケーションのユーザー・インタフェースの管理」を参照してください。

2. 「フォーム」を選択して、「次へ」をクリックします。

3. 「Webサービスのフォーム」を選択し、「次へ」をクリックします。

3. 「サービスと操作の選択」で、次の選択を行い、「次へ」をクリックします。

1. Webサービス参照: Webサービス参照を選択します。

2. 操作: 実行方法を選択します。RESTfulスタイルWeb参照の場合、doRESTが自動的に選択されます。手動スタイルWeb参照については、「操作」オプションは表示されません。

4. 「ページおよびリージョン属性」で、ページおよびリージョンの属性を確認し、「次へ」をクリックします。

注意:
指定したページが存在しない場合は、ウィザードによってページが作成されます。

5. 「入力アイテム」で、次の選択を行い、「次へ」をクリックします。

1. フォームに追加するアイテムを指定します。アイテムを含めるには、「作成」列で「はい」を選択します。そうでない場合は、「いいえ」を選択します。

2. 必要に応じて、アイテム名を編集します。

3. 必要に応じて、アイテム・ラベルを編集します。

6. 該当する場合、Basic認証に「アイテム名」および「アイテム・ラベル」を指定して「次へ」をクリックします。

注意:
このステップは、Webサービス参照を作成したときに、Basic認証がこのWebサービス参照に対して指定された場合にのみ表示されます。

7. 該当する場合、Basic認証に「アイテム名」および「アイテム・ラベル」を指定します。
このステップは、Webサービス参照を作成したときに、Basic認証がこのWebサービス参照に対して指定された場合にのみ表示されることに注意してください。

8. 「出力アイテム」で、次の選択を行い、「次へ」をクリックします。

1. フォームに追加するアイテムを指定します。アイテムを含めるには、「作成」列で「はい」を選択します。そうでない場合は、「いいえ」を選択します。

2. 必要に応じて、アイテム名を編集します。

3. 必要に応じて、アイテム・ラベルを編集します。

9. 「タブ・オプション」で、ページにタブを含めるかどうかとタブの作成方法を選択し、「次へ」をクリックします。

10. 確認ページを確認して、「作成」をクリックします。

プロセスとしてのWebサービスの起動

Webサービスをページ上でプロセスとして起動することもできます。Webサービス用のいずれかのフォームの作成ウィザードを実行すると、プロセスが作成されます。このプロセスを実行すると、リクエストがサービス・プロバイダに送信されます。その後で、レポートにリクエスト結果を表示できます。

Webサービスをプロセスとして起動するには、次のステップを実行します。

1. Webサービス参照を作成します。「WSDLに基づいたWebサービス参照の作成」、「Webサービス参照の手動作成」または「RESTful Webサービス参照の作成」を参照してください。

2. ページを作成します。「データベース・アプリケーションのページの管理」を参照してください。
「ページの作成」ウィザードで、次のステップを実行します。

1. 「空白ページ」を選択します。

2. タブの使用を確認するプロンプトが表示されたら、「いいえ」を選択します。

3. 「ページの編集」をクリックします。「ページ属性の変更」を参照してください。

4. 「ページ・レンダリング」または「ページ・プロセス」で、「プロセス」セクションを探し、右クリックして「プロセスの作成」を選択します。
ページ・プロセスの作成ウィザードが表示されます。

5. 「プロセス・タイプ」で、「Webサービス」を選択して「次へ」をクリックします。

6. 「プロセス属性」で、次の項目を指定し、「次へ」をクリックします。

1. 名前: プロセス名を入力します。

2. 順序: このコンポーネントの順序を入力します。これによって評価の順序が決まります。

3. ポイント: プロセス・ポイントを選択します。

7. 「プロセス」で、次の項目を指定します。

1. Webサービス参照: このプロセスのWebサービス参照を選択します。
Web参照がWSDLから作成されたか、またはRESTfulスタイルである場合、「操作」の選択が表示されます。

2. 操作(WSDLまたはRESTfulスタイルWebサービス参照のみ): このプロセスが実行するWebサービス操作を選択します。
「Webサービスの入力パラメータ」と「Webサービスの出力パラメータ」が表示されます。

3. 「Webサービスの入力パラメータ」で、Webサービス・プロセスの入力を指定します。

- ソース: ソース・タイプを選択します。

- 値: ソース値を選択します。

4. 「Webサービスの出力パラメータ」で、結果の格納先を指定します。
コレクションに結果を格納するには、次のステップを実行します。

- 結果の格納場所: 「コレクション」を選択します。

- 値: コレクションの名前を入力します。

ページ上のアイテムに結果を格納するには、次のステップを実行します。

- 結果の格納場所: 「アイテム」を選択します。

- 値: 適切なアイテム値を選択します。

5. 「次へ」をクリックします。

8. 「メッセージ」で、次の入力を行い、「次へ」をクリックします。

1. 成功メッセージ: プロセスが正常に実行された場合に次のページに表示されるメッセージを入力します。

2. 失敗メッセージ: 未処理例外が発生した場合に表示されるメッセージを入力します。エラー・プロセスが停止した後は、常にロールバックが実行され、エラー・メッセージが表示されます。

9. 「プロセス条件」で、次の選択を行い、「次へ」をクリックします。

1. 対象ボタン: プロセスを実行させるボタンを選択します。

2. 条件タイプ: このコンポーネントを処理するために満たされる必要がある条件タイプを選択します。条件タイプに比較用の式が必要な場合、「式1」と、場合によっては「式2」フィールドが表示されます。必要に応じてこれらのフィールドに式を入力します。

10. 「プロセスの作成」をクリックします。

レポートでのWebサービス結果の表示

Webサービスのリクエスト結果を表示するレポートを作成するには、次のステップを実行します。

1. 「ページ定義」にナビゲートします。「コンポーネント・ビューでのページの編集」を参照してください。

2. コンポーネント・ビューの「リージョン」で、「作成」アイコンをクリックします。
「リージョンの作成」ウィザードが表示されます。

3. 「リージョン・タイプ」で、「レポート」を選択して「次へ」をクリックします。

4. 「リージョン」で、「Webサービスの結果」を選択し、「次へ」をクリックします。

5. 「表示属性」で、リージョン・タイトルを入力し、オプションでリージョン属性を編集して「次へ」をクリックします。

6. Web参照が手動で作成されたか、WSDLから作成されたか、またはRESTfulスタイルかを選択し、「次へ」をクリックします。

7. Webサービス参照がWSDLから作成された場合、次のステップを実行します。

1. 「Webサービス参照」で、実行するWebサービス参照を選択します。

2. 「操作」で、実行するメソッドを選択します。

3. 「レポート対象の結果ツリー」で、作成されるXML文書(レポートに含める情報を含む)の一部を選択します。

4. 「レポート・パラメータとレポート・オプション」で、次の操作を実行します。

- 「一時結果セット名」に、Webサービスの結果を格納するコレクションの名前を入力します。

- 該当するパラメータを選択した後、選択解除します。

8. Webサービス参照が手動で作成された場合、次のステップを実行します。

1. Webサービス参照を選択します。

2. SOAPスタイルを選択します。

3. メッセージの書式を選択します。

4. レポートの対象となるノードへのXPath式を入力します。

5. SOAPレスポンス・エンベロープのネームスペースを入力して、「次へ」をクリックします。

6. レスポンス・メッセージが格納されているコレクション名を入力します。

7. レポートに含めるパラメータ名を入力します。

9. Webサービス参照がRESTスタイルの場合、次のステップを実行します。

1. Webサービス参照を選択します。

2. レスポンス・メッセージが格納されているコレクション名を入力します。

3. レポート・テンプレートと、ページごとに表示される行数を選択します。

4. レポートに含めるパラメータを選択します。

10. 「SQLレポートの作成」をクリックします。

Webサービス・プロセスの編集

WSDLから作成されたWebサービス参照またはRESTfulスタイルのWeb参照でWebサービス・タイプのプロセスを作成した後、サービスへの入力パラメータおよび出力パラメータの属性を変更できます。

Webサービス・プロセスを編集するには、次のステップを実行します。

1. Webサービス・プロセスを作成します。詳細は、「プロセスとしてのWebサービスの起動」を参照してください。

2. Webサービス・プロセスが含まれている「ページ定義」にナビゲートします。

3. プロセス名を選択します。
「ページ・プロセスの編集」ページが表示されます。

4. 入力パラメータを静的な値にマップするには、次のステップを実行します。

1. 「Webサービスの入力パラメータ」までスクロールします。

2. 該当するパラメータ名の横にある「値」フィールドに値を入力します。

5. 出力パラメータをコレクションにマップするには、次のステップを実行します。

1. 「Webサービスの出力パラメータ」までスクロールします。

2. レスポンスの格納場所で、「コレクション」を選択します。

3. 「値」で、レスポンスを格納するコレクションの名前を入力します。レスポンスは、予想されるレスポンスに基づいてCLOB001またはXMLTYPE001に格納されます。

6. 出力パラメータをアイテムにマップするには、次のステップを実行します。

1. 「Webサービスの出力パラメータ」までスクロールします。

2. レスポンスの格納場所で、「アイテム」を選択します。

3. 該当するパラメータ名の横にある「値」フィールドにアイテム名を入力します。

7. 「変更の適用」をクリックします。

Webサービス参照履歴の表示

「Webサービス履歴」では、カレント・アプリケーションのWebサービス参照の変更が、アプリケーションID、Webサービス参照名、開発者および日付ごとに表示されます。

Webサービス参照の変更履歴を表示するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。
「共有コンポーネント」ページが表示されます。

4. 「ロジック」で、「Webサービス参照」をクリックします。

5. 「履歴」をクリックします。

注意:
Webサービス参照ページに「履歴」ボタンが表示されるのは、少なくとも1つの参照が存在する場合のみです。

RESTful Webサービスとしてのレポート・リージョンの公開

レポート・リージョンをRESTful Webサービスとして公開するには、次のステップを実行します。

1. インスタンス管理者は、インスタンス設定のRESTプロバイダ機能を有効化する必要があります。Oracle Application ExpressインスタンスへのRESTfulアクセスを有効化するには、『Oracle Application Express管理ガイド』のRESTfulアクセスの有効化に関する説明を参照してください。

2. 開発者はレポート・リージョンへのRESTfulアクセスを有効にする必要があります。「レポート・リージョンへのRESTfulアクセスの有効化」を参照してください。

3. レポートを格納するページでは、認証を要求しない必要があります。

関連項目:
『Oracle Application Express SQLワークショップ・ガイド』のRESTfulサービスの使用に関する説明

内容は次のとおりです。

- レポート・リージョンへのRESTfulアクセスの有効化

- Webサービス・クライアントからのRESTful有効レポート・リージョンへのアクセス

レポート・リージョンへのRESTfulアクセスの有効化

レポート・リージョンへのRESTfulアクセスを有効化するには、認証が不要になるようにページを公開し、レポートをRESTfulアクセスのために有効化する必要があります。Oracle Application ExpressインスタンスへのRESTfulアクセスを有効化するには、『Oracle Application Express管理ガイド』のRESTfulアクセスの有効化に関する説明を参照してください。

ページを公開するには、次のステップを実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。
アプリケーション・ビルダーのホームページが表示されます。

2. アプリケーションを選択します。

3. 有効にするレポートが格納されているページを選択します。
「ページ定義」が表示されます。

4. 「ページ」で、「編集」アイコンをクリックします。

5. 「セキュリティ」で、「認証」リストから「パブリック・ページ」を選択します。

6. 「変更の適用」をクリックします。

レポート・リージョンをRESTfulアクセスのために有効化するには、次のステップを実行します。

1. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。

2. アプリケーションを選択します。
アプリケーション・ビルダーのホームページが表示されます。

3. 有効にするレポートが格納されているページを選択します。
「ページ定義」が表示されます。

4. 「リージョン」で、有効化するレポートが格納されているリージョンの名前をクリックします。

5. 「属性」で、「静的ID」フィールドの値を入力します。この値はレポートにRESTfulにアクセスするために使用されます。

6. 「RESTfulアクセスの有効化」リストで、「はい」を選択します。

注意:
「RESTfulアクセスの有効化」リスト・オプションが表示されるのは、このOracle Application ExpressインスタンスへのRESTfulアクセスが有効になっている場合のみです。『Oracle Application Express管理ガイド』のRESTfulアクセスの有効化に関する説明を参照してください。

7. 「変更の適用」をクリックします。

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

なし

はい

RESTful有効レポートが格納されているアプリケーションの数値IDまたは別名。

page

なし

はい

RESTful有効レポートが格納されているページの数値IDまたは別名。

reportid

なし

はい

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ノードの子としてリストされます。

プラグインの実装

このセクションでは、プラグインをアプリケーションに追加する方法と、再利用および共有を管理する方法について説明します。プラグインの例はOracle Technology NetworkのOracle Application Expressプラグイン・リポジトリから入手可能で、「サンプル・データベース・アプリケーション」に含まれています。

関連項目:
「プラグイン・リポジトリの表示」

内容は次のとおりです。

- プラグインについて

- プラグインへのアクセス

- プラグインの編集

- プラグインの作成

- プラグインへのカスタム属性の追加

- プラグインに関連付けるファイルのアップロード

- プラグインへのイベントの追加

- プラグインの削除

- プラグイン・リポジトリの表示

- プラグイン・ページからのプラグインのインポート

- プラグイン・ページからのプラグインのエクスポート

- プラグイン対話モード・レポートのリセット

- プラグインの使用状況の表示

- プラグイン履歴の表示

プラグインについて

開発者はプラグインを使用して、Oracle Application Expressで使用可能な組込みタイプを宣言的に拡張、共有および再利用できます。

Oracle Application Expressは、認証スキーム、認可スキーム、アイテム、リージョン、動的アクションとプロセス・タイプのグループ・セットをサポートします。プラグインによってアプリケーション内で新しいタイプを宣言的に作成および使用することによって、これらの組込みタイプを拡張する手段が提供されます。プラグインは再利用を目的として設計されているため、開発者はプラグインを別のワークスペースにエクスポートおよびインポートしたり、プラグイン・リポジトリを使用してプラグインをOracle Application Expressプラグイン・コミュニティと共有できます。

プラグインを実装するプロセスには、次のステップがあります。

1. アプリケーション・ワークスペースでプラグインを作成するか、またはインポートします。

2. プラグインを使用するための認可スキーム、アイテム、リージョン、プロセスまたは動的アクション・タイプを編集または作成します。

3. プラグインをテストするためにアプリケーションを実行します。

プラグインの実装例は、次の場所にあるOracleプラグイン・リポジトリを参照してください。

http://apex.oracle.com/plugins

その他のプラグインの実装例については、次の場所にあるOracle Learning Libraryに移動し、ページの下部にあるリンクをクリックしてライブラリにアクセスし、Oracle Application Express (APEX)製品OBEの検索基準を入力します。

http://www.oracle.com/technetwork/tutorials/index.html

プラグインへのアクセス

プラグインにアクセスするには、次の手順を実行します。

1. プラグイン・ページにナビゲートします。

1. 「ワークスペース」ホームページにナビゲートします。

2. 「アプリケーション・ビルダー」をクリックします。

3. アプリケーションを選択します。

4. 「共有コンポーネント」をクリックします。

5. 「ユーザー・インタフェース」で、「プラグイン」を選択します。
プラグイン・ページが表示され、「プラグイン」タブがデフォルトで選択されます。使用可能なすべてのプラグインが表示されます。

2. ページの外観は、ページ上部にある検索バーを使用してカスタマイズできます。使用可能なコントロールは次のとおりです。

- 「検索」アイコン: 虫めがねに似ています。このアイコンをクリックして、検索を特定の列のみに絞ります。すべての列を検索するには、「すべての列」を選択します。

- テキスト・フィールド: 大/小文字を区別しない検索基準(ワイルドカード文字は暗黙的に定義される)を入力し、「実行」をクリックします。

- 「実行」ボタン: 検索を実行したり、フィルタを適用します。

- アイコンの表示: (デフォルト)各プラグインを大きいアイコンとして表示します。プラグインを編集するには、該当するアイコンをクリックします。

- レポートの表示: 各プラグインをレポート内の1行として表示します。

- アクション・メニュー: アクション・メニューを表示します。レポート・ビューをカスタマイズするにはこのメニューを使用します。「「アクション」メニューについて」を参照してください。

プラグインの編集

プラグインを編集するには、次のようにします。

1. プラグイン・ページにナビゲートします。「プラグインへのアクセス」を参照してください。

2. 編集または表示するプラグインをクリックします。
プラグインの作成/編集ページが表示されます。

3. 変更を加えます。
各オプションの詳細は、アイテム・ヘルプ、「プラグインの作成」、「プラグインへのカスタム属性の追加」、「プラグインに関連付けるファイルのアップロード」および「プラグインへのイベントの追加」を参照してください

4. 「変更の適用」をクリックします。

プラグインの作成

ヒント:
次のステップの実行中、特定のフィールドに関する詳細を見るには、アイテム・ヘルプを参照してください。

プラグインを作成するには、次のようにします。

1. プラグイン・ページにナビゲートします。「プラグインへのアクセス」を参照してください。

2. 「作成」をクリックします。
プラグインの作成/編集ページが表示されます。

3. 「名前」で、次の項目を指定します。

1. 名前(必須): プラグインの名前を入力します。

2. 内部名(必須): プラグインの内部名を入力します。この名前は、現在のアプリケーション内で一意である必要があります。

ヒント:
内部名をワールドワイドでグローバルな一意名とするために、組織のドメイン名を内部プラグイン名の接頭辞として使用することをお薦めします。たとえば、ドメイン名mycompany.comをSliderという名前のプラグインに接頭辞として付けると、内部名はCOM.MYCOMPANY.SLIDERとなります。

3. タイプ(必須): このプラグインを使用するコンポーネントのタイプを選択します。「コールバック」と「標準属性」の設定は選択されるプラグイン・タイプによって異なります。詳細は、次のセクションを参照してください。

4. カテゴリ(「タイプ」が「動的アクション」の場合は必須): UIでプラグインをどのカテゴリの下に表示するかを選択します。

4. 「サブスクリプション」で、次の項目を指定します。

- マスター・プラグインの参照元: このプラグインを、このワークスペースの別のプラグインに基づくようにするには、ポップアップ・リストからプラグインを選択します。それ以外の場合、このフィールドをブランクのままにし、これをこのプラグインのマスター・コピーとします。

5. 「ソース」で、次の項目を指定します。

1. 「PL/SQLコード」: このプラグインのレンダリング、検証、実行およびAJAXコールバックの実行用のプロシージャを含むコードのPL/SQL無名ブロックを入力します。

2. PL/SQLコードを検証しない(実行時にのみPL/SQLコードを解析)。: PL/SQLコードを実行時にのみ解析するには、このオプションを選択します。選択しない場合、コードはプラグインが作成されるときに解析されます。

6. 「コールバック」で、次の項目を指定します。

1. レンダリング・ファンクション名(リージョン、アイテムおよび動的アクション・タイプのプラグインの場合のみ使用可能): プラグインをレンダリングするためにコールされるPL/SQLファンクションの名前を入力します。

2. AJAXファンクション名(認証、リージョン、アイテムおよび動的アクション・タイプのプラグインの場合のみ使用可能): AJAXのコールで追加データをロードするためにプラグインによって使用されるPL/SQLファンクションの名前を入力します。

3. 検証ファンクション名(アイテム・タイプのプラグインの場合のみ使用可能): 送信済データについて基本検証を実行するためにプラグインが使用できるPL/SQLファンクションの名前を入力します。

4. 実行ファンクション名(認可とプロセス・タイプのプラグインの場合のみ使用可能): プラグインを実行するためにコールされるPL/SQLファンクションの名前を入力します。

5. セッション監視ファンクション名(認証タイプのプラグインの場合のみ使用可能): セッション監視検証を実行するためにプラグインが使用するPL/SQLファンクションの名前を入力します。

6. セッション・ファンクション名が無効です。(認証タイプのプラグインの場合のみ使用可能): 無効なセッションが検出された場合にプラグインがコールするPL/SQLファンクションの名前を入力します。たとえば、このファンクションを使用してシングル・サインオン・サーバーをコールします。

7. 認証ファンクション名(認証タイプのプラグインの場合のみ使用可能): 入力されたユーザー資格証明の検証を実行するためにプラグインが使用するPL/SQLファンクションの名前を入力します。

8. ログアウト後ファンクション名(認証タイプのプラグインの場合のみ使用可能): Application Expressがカレント・セッションを終了した後にプラグインがコールするPL/SQLファンクションの名前を入力します。このファンクションを使用して、シングル・サインオン・サーバーなどの他のシステムからログアウトしてください。

注意:
すべてのコールバック・ファンクション名は、無名PL/SQLコード・ブロックのファンクション、パッケージ内のファンクションまたはデータベース内のスタンドアロン・ファンクションを参照できます。詳細情報と例についてはアイテム・ヘルプを参照してください。

7. 「ユーザー・インタフェース」で、このプラグインに対してアプリケーション・ビルダーでサポートする必要がある表示デバイスを選択します。

- サポート:

- デスクトップ: プラグインをデスクトップに表示する場合は、このオプションを選択します。

- jQuery Mobileスマートフォン: プラグインをモバイル・スマートフォンに表示する場合は、このオプションを選択します。

8. 「標準属性」(認可スキームとプロセス・タイプのプラグインでは使用不可)で、次の項目を指定します。
認証スキーム・タイプのプラグインでは、次の属性を指定します。

- エラー時に実行停止: 選択された場合、アクションの「エラー時に実行停止」フィールドが使用できます。

動的アクション・タイプのプラグインでは、このプラグインに適用される属性を次のように指定します。

1. アイテムの場合: 動的アクションでは、影響を受ける要素としてアイテムの選択がサポートされます。

2. ボタン用: 動的アクションでは、影響を受ける要素としてボタンの選択がサポートされます。

3. リージョンの場合: 動的アクションでは、影響を受ける要素としてリージョンの選択がサポートされます。

4. DOMオブジェクトの場合: 動的アクションでは、影響を受ける要素としてDOMオブジェクトの選択がサポートされます。

5. jQueryセレクタの場合: 動的アクションでは、影響を受ける要素としてjQueryセレクタの選択がサポートされます。

6. トリガー要素: 動的アクションでは、影響を受ける要素としてトリガー要素の選択がサポートされます。

7. イベント・ソース: 動的アクションでは、影響を受ける要素としてイベント・ソースの選択がサポートされます。

8. 影響を受ける要素が必要です: 動的アクションでは、影響を受ける要素の指定が必要となります。

9. 「ページ・ロード時に実行」を選択: アクションの「ページのロード時に実行」フィールドのデフォルト値を定義します。

10. エラー時に実行停止属性を指定: アクションの「エラー時に実行停止」フィールドが使用できます。

11. 「結果を待機」属性を指定: アクションの「結果を待機」フィールドを使用できます。

アイテム・タイプのプラグインでは、このプラグインに適用される属性を次のように指定します。

1. ウィジェットの表示: ウィジェットが表示されます。

2. セッション・ステート変更可能: アイテムの値をセッション・ステート中に変更できます。「ウィジェットの表示」属性が選択されている必要があります。

3. 読取り専用属性を指定: ユーザーはアイテムの読取り専用条件を指定できます。この属性を有効にするには「ウィジェットの表示」属性が選択されている必要があります。

4. 「特殊文字をエスケープ」属性がある: アイテムの編集時に、アイテムの「セキュリティ」セクションに「特殊文字をエスケープ」フィールドが存在します。「ウィジェットの表示」属性が選択されている必要があります。

5. クイック選択属性を指定: アイテムにクイック選択属性が存在します。「ウィジェットの表示」属性が選択されている必要があります。

6. ソース属性を指定: 「使用されるソース」、「ソース・タイプ」、「書式マスク」などのソースに関連した属性がアイテムに表示されます。

7. 日付のみの書式マスク: 日付情報を処理するアイテムについて、「書式マスク」フィールド・ポップアップで選択する日付値を表示することによって日付の選択を制限します。「ソース属性を指定」が選択されている必要があります。

8. 数値のみの書式マスク: 数値情報を処理するアイテムについて、「書式マスク」フィールド・ポップアップで選択する数値を表示することによって数値の選択を制限します。

9. 要素属性を指定: アイテムには、「横/縦の位置合せ」、「HTMLフォームの要素属性」、「要素の前のテキスト」、「要素の後のテキスト」などの要素属性が存在します。

10. 幅属性を指定: アイテムの幅を制御できます。

11. 高さ属性を指定: アイテムの高さを制御できます。

12. 要素オプション属性を指定: チェック・ボックスのラジオ・グループなどの複数の選択要素をレンダリングするときに、アイテムで追加のオプション属性を指定できます。

13. プレースホルダ属性を指定: アイテムは、要素に表示されるプレースホルダ・テキストの指定をサポートします。

14. 暗号化セッション・ステート属性を指定: アイテムを編集するとき、「セキュリティ」リージョンの下に「セッション・ステートに暗号化された値を保存」が表示されます。

15. LOVを指定: アイテムに関連付けられたLOVが存在します。「ウィジェットの表示」属性が選択されている必要があります。

16. LOVが必須: LOVを処理するアイテムで、LOVを定義する必要があります。「LOVを指定」属性が選択されている必要があります。

17. LOVのNULL表示属性を指定: アイテムは、null値を含むことが可能なLOVに関連付けられます。「LOVを指定」属性が選択されている必要があります。

18. カスケードLOV属性を指定: アイテムにカスケードLOV関連の属性が存在します。「LOVを指定」属性が選択されている必要があります。

リージョン・タイプ・プラグインでは、次のオプションを選択して有効化します。

1. リージョン・ソースはSQL文です: リージョン・ソースはSQL文です。選択すると、問合せによって戻すことができる最小と最大の列数を指定でき、ユーザーを支援するために、SQLの例が表示されます。

2. リージョン・ソースはプレーン・テキストです: リージョン・ソースはプレーン・テキストです。

3. リージョン・ソースが必要です: リージョン・ソースがSQL文の場合は、この属性が必須の値になります。

4. 「送信するページ・アイテム」属性がある: リージョン・ソースがSQL文の場合、この属性により、そのリージョンに対してAJAXコールを実行する際にセッション・ステート内に設定する必要があるそれらのページ・アイテムを指定できます。

5. 「フェッチされた行数」属性を指定: リージョンの編集時に、リージョンの「詳細」セクションに「フェッチされた行数」フィールドが存在します。

6. 「データが見つからなかった場合のメッセージ」属性を指定: リージョンの編集時に、リージョンの「詳細」セクションに「データが見つからなかった場合のメッセージ」フィールドが存在します。

7. 「特殊文字をエスケープ」属性がある: リージョンの編集時に、リージョンの「セキュリティ」セクションに「特殊文字をエスケープ」フィールドが存在します。

9. 「情報」で、次の項目を指定します。

1. バージョン: プラグインのバージョンを識別する文字列を入力します。

2. URL情報: プラグイン作成者のホームページのURL、またはプラグインに関する追加情報のURLです。

10. 「ヘルプ・テキスト」に、ユーザーがプラグインの機能を理解するのに使用するヘルプ・テキストを入力します。

11. 「コメント」に、アプリケーションが実行されているときに表示されないコメントおよび注意を入力します。
各オプションの詳細は、アイテムのヘルプを参照してください。

12. 「作成」をクリックします。
プラグインが作成されたら、追加のカスタム属性の指定、プラグインと関連付けるイメージ、CSSおよびJavaScriptファイルなどのファイルのアップロードおよびイベントの追加を実行できます。「プラグインへのカスタム属性の追加」、「プラグインと関連付けるファイルのアップロード」および「プラグインへのイベントの追加」を参照してください。

プラグインへのカスタム属性の追加

プラグイン属性は、プラグインが使用されるとき、開発者に追加データの入力を求めるプロンプトをアプリケーション・ビルダー内で表示するために使用します。

ヒント:
次のステップの実行中、特定のフィールドに関する詳細を見るには、アイテム・ヘルプを参照してください。

プラグインにカスタム属性を追加するには、次の手順を実行します。

1. プラグイン・ページにナビゲートします。「プラグインへのアクセス」を参照してください。

2. 変更するプラグインをクリックします。
プラグインの作成/編集ページが表示されます。

3. 「カスタム属性」で、属性値の置換を有効化または無効化します。

- 代替属性値: 開発者が指定するカスタム属性値には、&P1_DNAMEなどの置換構文で参照されるアイテムが含まれる場合があります。
「はい」に設定すると、Application Expressにより自動的に置換構文が実際の値で置き換えられます。

「いいえ」に設定すると、p_plugin、p_item、p_regionなどのattribute_01からattribute_15までのレコード・タイプ属性に置換構文が変更されずに書き込まれます。プラグインの開発者は、これらの置換構文の参照をapex_plugin_util.replace_substitutionsのコールで置換するか、同様の置換を行う必要があります。詳細は、アイテム・ヘルプを参照してください。

4. 「カスタム属性」で、「属性の追加」をクリックします。
属性の編集ページが表示されます。

5. 「名前」で、次の項目を指定します。

1. 有効範囲: 属性がアプリケーションについて1回のみ定義される場合は「アプリケーション」を選択します。プラグインがコンポーネント内で参照されるたびに属性が定義される場合は「コンポーネント」を選択します。

2. 属性: ATTRBUTE_XX列に関連付けられ、APEX_PLUGINパッケージに定義されたPL/SQLタイプと関連するシーケンスを入力します。

3. 表示順序: アプリケーション・ビルダー内でのこのプラグイン属性の表示順序を入力します。

4. ラベル: アプリケーション・ビルダー内でのこの属性に表示されるラベルを入力します。

6. 「設定」で、次の項目を指定します。

1. タイプ: 属性タイプを選択します。

2. 必須: この属性を指定する必要がある場合は、「はい」を選択します。そうでない場合は、「いいえ」を選択します。

3. 翻訳可能: この属性を翻訳ファイルに含める場合は「はい」を選択します。それ以外の場合は、「いいえ」を選択します。

4. 表示幅: アプリケーション・ビルダー内でこの属性に表示する長さを文字数で入力します。

5. 最大幅: アプリケーション・ビルダー内でこの属性に対してユーザーが入力できる最大の文字数を入力します。

7. 「デフォルト値」で、このプラグインを使用する新しいコンポーネントが作成されるときにこのプラグイン属性について使用する値を指定します。Yes/Noタイプの属性ではYとNを使用します。

8. 「条件」で、次の項目を指定します。

1. 依存先: 現在の属性が依存する属性を選択します。

2. 条件タイプ(依存属性の場合のみ表示): この属性がレンダリングされるために満たされる必要がある条件のタイプを選択します。

3. 式(条件タイプで必要な場合のみ表示): 選択された条件タイプを満たす必要がある式を入力します。詳細は、アイテム・ヘルプを参照してください。

9. 「ヘルプ・テキスト」で、アプリケーション・ビルダー内でこの属性の状況依存ヘルプとして表示されるヘルプ・テキストを指定します。

10. 「コメント」に、アプリケーションが実行されているときに表示されないコメントまたは注意を入力します。

11. 属性を作成して編集ページに戻るために「作成」をクリックするか、属性を作成して別の属性の作成を続行するために「作成後、さらに作成」をクリックします。

注意:
「作成」または「作成後、さらに作成」をクリックするとき、右側のパネルの「プラグイン」の下の「ページに戻る」チェック・ボックスが選択されていると、同じ属性の編集ページが表示されます。

プラグインに関連付けるファイルのアップロード

プラグインに関連付けるイメージ、CSSおよびJavaScriptファイルをアップロードします。アップロードする別のファイルを参照するには、アップロードするCSSファイルおよびJavaScriptファイル内で#PLUGIN_PREFIX#を使用します。詳細は、新規ファイルのアップロード・ページの右側の「プラグイン・ファイル」リージョンを参照してください。

たとえばCSSファイルでは、参照は次のようになります。

.sidebar{
background-image:url(#PLUGIN_PREFIX#flowers.png);
}

ファイルをアップロードする手順は、次のとおりです。

1. プラグイン・ページにナビゲートします。「プラグインへのアクセス」を参照してください。

2. アップロード先のプラグインをクリックします。
プラグインの作成/編集ページが表示されます。

3. 「ファイル」をクリックします。
「ファイル」オプションが表示されます。

4. ファイルの接頭辞: データベースのプラグイン定義とともに格納されたファイルを参照するには、デフォルトの#PLUGIN_PREFIX#を使用します。この接頭辞は、Webサーバーがプラグインのファイルを指定する場合に使用する仮想パスを特定します。パフォーマンスを向上するために、プラグイン・ファイルをWebサーバーに格納し、#IMAGE_PREFIX#または任意の有効なURLを使用してプラグイン・ファイルを参照することもできます。

5. 「新規ファイルのアップロード」をクリックします。
新規ファイルのアップロード・ページが表示されます。

6. 「ファイル」で、アップロードするファイルを参照して選択します。

7. 「アップロード」をクリックします。
作成/編集ページが表示されます。アップロード対象ファイルの名前が「ファイル」の下に表示されます。

8. 「変更の適用」をクリックします。

プラグインへのイベントの追加

アイテム、リージョンまたは動的アクション・タイプのプラグインにイベントを追加すると、イベントを動的アクションに公開できます。たとえば、Start Slide、Sliding、Stop Slideなどのイベントを公開するSliderプラグインによって、これらのイベントが発生したときに応答できる動的アクションを作成できます。

プラグインにイベントを追加するには、次の手順を実行します。

1. プラグイン・ページにナビゲートします。「プラグインへのアクセス」を参照してください。

2. 編集するプラグインをクリックします。
プラグインの作成/編集ページが表示されます。

3. 「イベント」までスクロールし、「イベントの追加」をクリックします。
「イベント」の下に新しい行が表示されます。

4. 「イベント」で、次の項目を指定します。

1. 名前: 動的アクション内でプラグイン・イベントが表示される表示名。例: Start Slide。

2. 内部名: 動的アクションをトリガーする割り当てられたJavaScriptイベントの名前。例: slidestart。

5. 「イベントの追加」をクリックします。

6. 手順3から4を繰り返して、別のイベントを追加します。

7. 「変更の適用」をクリックします。

プラグインの削除

プラグインは使用中でなければ削除できます。プラグインを使用中の場合、「削除」ボタンは表示されません。

プラグインを削除するには、次のようにします。

1. プラグイン・ページにナビゲートします。「プラグインへのアクセス」を参照してください。

2. 削除するプラグインをクリックします。
プラグインの作成/編集ページが表示されます。

3. 「削除」をクリックします。

4. 確認するには、「OK」をクリックします。

プラグイン・リポジトリの表示

プラグイン・リポジトリの目的は、開発者がプラグインを共有およびダウンロードできる一元的な場所を提供することです。リポジトリはOracle Technology Networkにあります。

プラグイン・リポジトリを表示するには、次の手順を実行します。

1. プラグイン・ページにナビゲートします。「プラグインへのアクセス」を参照してください。

2. 「プラグイン・リポジトリの表示」をクリックします。
Oracle Application Expressプラグイン・リポジトリが表示されます。

プラグイン・ページからのプラグインのインポート

エクスポートされたプラグインをアプリケーションにインポートするにはこのオプションを使用します。プラグインのインポートは、ここで説明するように、プラグイン・ページの「共有コンポーネント」またはアプリケーション・ビルダーのホームページから実行できます。「プラグインのインポート」を参照してください。

プラグインをインポートするには、次の手順を実行します。

1. プラグイン・ページにナビゲートします。「プラグインへのアクセス」を参照してください。

2. 「インポート」をクリックします。
プラグインのインポート・ページが表示されます。

3. 「ファイルの指定」で次の選択を行い、「次へ」をクリックします。

- ファイルのインポート: インポート・ファイルの名前を入力するか参照します。

- ファイル・タイプ: 「プラグイン」を選択します。

- ファイルのキャラクタ・セット: インポート・ファイルのキャラクタ・セット・エンコードを選択します。

4. 「ファイルのインポートの確認」で、「次へ」をクリックします。

5. 「インストール」で、「プラグインのインストール」をクリックします。

プラグイン・ページからのプラグインのエクスポート

プラグイン定義をファイルにエクスポートするにはこのオプションを使用します。このファイルは任意のAPEXアプリケーションにインポートできます。プラグインのエクスポートは、ここで説明するように、プラグイン・ページの「共有コンポーネント」からか、「ワークスペース」ホームページから実行できます。「プラグインのエクスポート」を参照してください。

1. プラグイン・ページにナビゲートします。「プラグインへのアクセス」を参照してください。

2. 「タスク」で、「プラグインのエクスポート」をクリックします。
プラグインのエクスポート・ページが表示されます。

3. 「アプリケーション」で、プラグインのエクスポート元のアプリケーションを選択します。

4. 「アプリケーションの設定」をクリックします。

5. 「プラグインのエクスポート」で、次の項目を指定します。

- プラグイン: プラグインを選択します。

- ファイル形式: プラグイン・エクスポートのファイル形式を選択します。

6. 「プラグインのエクスポート」をクリックします。

7. 「ファイルを保存」を選択して、「OK」をクリックします。
ダウンロード完了メッセージが表示されます。

プラグイン対話モード・レポートのリセット

プラグイン対話モード・レポートをリセットして、レポートに現在適用されているすべてのフィルタをクリアできます。

対話モード・レポートをリセットするには、次の手順を実行します。

1. プラグイン・ページにナビゲートします。「プラグインへのアクセス」を参照してください。

2. 「リセット」をクリックします。

関連項目:

プラグインの使用状況の表示

プラグインの使用状況ページには、各プラグインを使用するページ、コンポーネントおよびリージョンが表示されます。

プラグインの使用状況を表示するには、次の手順を実行します。

1. プラグイン・ページにナビゲートします。「プラグインへのアクセス」を参照してください。

2. 「使用状況」をクリックします。
使用状況ページが表示されます。

プラグイン履歴の表示

プラグイン履歴ページには、各プラグインで実行されたアクション、アクションを実行した開発者および各アクションの日付が表示されます。

プラグインの履歴を表示するには、次の手順を実行します。

1. プラグイン・ページにナビゲートします。「プラグインへのアクセス」を参照してください。

2. 「履歴」をクリックします。
履歴ページが表示されます。

動的アクションの実装

このセクションでは、動的アクションの概要と、動的アクションの作成および変更方法について説明します。

内容は次のとおりです。

- 動的アクションの理解

- 動的アクションの作成

- 動的アクションの編集

- Trueアクションの追加

- 頻度と有効範囲の定義

- 動的アクションのデバッグ

関連項目:
「ページ固有のユーティリティについて」

動的アクションの理解

動的アクションは、JavaScriptを必要としないで複雑なクライアント側の動作を宣言的に定義する方法を提供します。動的アクションの作成ウィザードを使用して、定義された条件セットが発生したときに実行されるアクションを指定します。また、アクションの影響を受ける要素や、影響を受ける時期と影響も指定できます。

動的アクションを使用するとき、ページに追加する動的アクションが多くなるほど全体のページ・サイズが大きくなることに注意する必要があります。これは、動的アクション・フレームワークでは、定義された各動的アクションについてクライアントへの追加コードを生成し、そのコードはクライアント内のフレームワークによってダウンロードおよび実行される必要があるためです。問題をデバッグする方法についての情報は、「動的アクションのデバッグ」を参照してください。

動的アクションを実装するプロセスには、次の手順があります。

1. ページ上で、アイテム、ボタン、リージョン、DOMオブジェクトまたはjQueryセレクタを編集または作成します。このコンポーネントは、起動される時期を定義する際、動的アクション内で参照されます。

2. アクションを起動するアプリケーション・ページから動的アクションを作成します。

3. 動的アクションをテストするためにアプリケーションを実行します。

動的アクションの実装例については、次の場所にあるLearning Libraryに移動し、「All Content」タブをクリックして、Application Express(APEX)製品OBEの検索基準を入力します。

http://www.oracle.com/technetwork/tutorials/index.html

動的アクションの作成

動的アクションの作成には、アクションが発生する時期(オプション条件を指定する)、実行されるアクションおよびアクションの影響を受ける要素を指定する手順が含まれます。

1. 該当する「ページ定義」にナビゲートします。「「ページ定義」へのアクセス」を参照してください。

2. 「ページ・レンダリング」で、「動的アクション」までスクロールして、「作成」アイコンをクリックします。
動的アクション・ウィザードが表示されます。

3. 「指定」で、次の内容を入力し、「次へ」をクリックします。

- 名前: 動的アクションの名前を入力します。

- 順序: このコンポーネントの順序を入力します。これによって実行の順序が決まります。

4. 「時期」では、アクションを実行する時期を指定して「次へ」をクリックします。使用可能なオプションは次のとおりです。

1. イベント: 動的アクションは、ページで発生するイベントに基づいて起動するように定義できます。使用できるイベントには、ブラウザ・イベント、フレームワーク・イベント、コンポーネント・イベントおよびカスタム・イベントの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): (デバイスを垂直または水平にして)デバイスの方向を変更すると起動します。JavaScriptオブジェクトthis.browserEventには、portraitまたはlandscapeと等しいorientationプロパティが含まれます。サポートされるユーザー・インタフェース・タイプ: jQuery Mobileスマートフォン。

- ページのロード(デスクトップ・ユーザー・インタフェースはreadyを使用し、jQuery Mobileスマートフォン・ユーザー・インタフェースはpageintを使用): ページがロードされるときに起動します。サポートされているユーザー・インタフェース・タイプ: デスクトップおよびjQuery Mobileスマートフォン。

- ページのアンロード(unload): ページがアンロードされるときに起動します。サポートされているユーザー・インタフェース・タイプ: デスクトップおよびjQuery Mobileスマートフォン。

- サイズ変更(resize): ブラウザ・ウィンドウがサイズ変更されるときに起動します。サポートされているユーザー・インタフェース・タイプ: デスクトップ。

- リソースのロード(load): トリガー要素がウィンドウ要素の場合(「時期」属性の「DOMオブジェクト」値に「window」を使用)、ブラウザでドキュメント内のすべてのコンテンツ(ウィンドウ、フレーム、オブジェクトおよびイメージを含む)のロードが完了したときにイベントが起動します。他の要素の場合、ターゲット要素とそのすべてのコンテンツのロードが完了したときに起動します。サポートされているユーザー・インタフェース・タイプ: デスクトップおよびjQuery Mobileスマートフォン。

- スクロール(scroll): スクロール可能なトリガー要素がスクロールされるときに起動します。これは、ブラウザ・ウィンドウ(「時期」属性の「DOMオブジェクト」値に「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): touchまたはmousecancelイベントを処理するための正規化されたイベント。サポートされるユーザー・インタフェース・タイプ: jQuery Mobileスマートフォン。

- タッチ・エンド(vmouseup): touchendまたはmouseupイベントを処理するための正規化されたイベント。サポートされるユーザー・インタフェース・タイプ: jQuery Mobileスマートフォン。

- タッチ・ムーブ(vmousemove): touchmoveまたはmousemoveイベントを処理するための正規化されたイベント。サポートされるユーザー・インタフェース・タイプ: jQuery Mobileスマートフォン。

- タッチ・スタート(vmousedown): touchstartまたはmousedownイベントを処理するための正規化されたイベント。サポートされるユーザー・インタフェース・タイプ: jQuery Mobileスマートフォン。

- 仮想クリック(vclick): touchendまたはmouse clickイベントを処理するための正規化されたイベント。タッチ・デバイスでは、このイベントはタッチ・エンドの後にディスパッチされます。サポートされるユーザー・インタフェース・タイプ: jQuery Mobileスマートフォン。

フレームワーク・イベント

- リフレッシュ後(apexafterrefresh): トリガー要素がリフレッシュされた後に起動します。このイベントは、部分ページ・リフレッシュを実行してこのイベントを起動するトリガー要素でのみ有効です。これをサポートするネイティブ・コンポーネントは、対話モード・レポート、クラシック・レポート、チャート、リスト・ビューおよびカスケードLOVサポートを持つすべてのアイテム・タイプです。プラグインでもこのイベントがサポートされる場合があります。サポートされているユーザー・インタフェース・タイプ: デスクトップおよびjQuery Mobileスマートフォン。

- ページの送信前(apexbeforepagesubmit): ページが送信される前に起動します。サポートされているユーザー・インタフェース・タイプ: デスクトップおよびjQuery Mobileスマートフォン。

- リフレッシュ前(apexbeforerefresh): トリガー要素がリフレッシュされる前に起動します。このイベントは、部分ページ・リフレッシュを実行し、このイベントを起動するトリガー要素にのみ有効です。これをサポートするネイティブ・コンポーネントは、「対話モード・レポート」、「クラシック・レポート」、「チャート」、「リスト・ビュー」およびカスケードLOVサポートが存在するすべてのアイテム・タイプです。プラグインでもこのイベントがサポートされる場合があります。サポートされているユーザー・インタフェース・タイプ: デスクトップおよびjQuery Mobileスマートフォン。

コンポーネント・イベント

これらのイベントは、カスタム・イベントをトリガーする、アプリケーションで使用可能なコンポーネント(アイテム、リージョンまたは動的アクションのいずれか)が存在する場合に使用できます。これらのイベントは、イベント名[コンポーネント名]の書式で表示され、たとえばShuttleネイティブ・アイテム・タイプによってトリガーされるChange Orderイベントは、Change Order [Shuttle]と表示されます。コンポーネント・イベントは、Oracle Application Expressに付属のネイティブ・コンポーネントまたはアプリケーションにインストールしたプラグイン・コンポーネントからトリガーされます。

- ネイティブ・コンポーネントによってトリガーされるイベント
順序の変更[シャトル](shuttlechangeorder): 右側の選択リストの値の順序が変更された(Move Top、Move Up、Move DownまたはMove Bottomを使用)ときに起動します。Oracle Application Expressでは現在、ネイティブ・コンポーネントによってトリガーされるイベントは他にありません。サポートされているユーザー・インタフェース・タイプ: デスクトップおよびjQuery Mobileスマートフォン。

- プラグイン・コンポーネントによってトリガーされるイベント
これらは現在のアプリケーションに追加されると使用可能になり、イベント名[コンポーネント名]の書式になります。プラグインによって実行されるイベントに関連したヘルプについては、「共有コンポーネント」、「プラグイン」、「プラグイン名」、「ヘルプ・テキスト」をナビゲートして、プラグイン構成ページのヘルプ・テキストを参照してください。ここにプラグイン作成者がドキュメントを格納している場合があります。サポートされるユーザー・インタフェース・タイプ: プラグインの「ユーザー・インタフェース」→「サポート対象」設定によって決まります。

- カスタム・イベント:
「カスタム」を選択すると、追加フィールドが表示され、カスタム・イベントを定義できます。このことは、ネイティブまたはプラグイン提供イベントでは十分でない場合に役立ちます。

2. 選択タイプ: 動的アクションをトリガーするページ要素のタイプを選択します。ページ要素の名前を指定するための対応する名前フィールドが表示されます。

注意:
選択されたイベントでページ要素の定義がサポートされている場合にのみ、使用できます。「ページのロード」、「ページのアンロード」、「サイズ変更」、「ページの送信前」、「方向の変更」のイベントを選択すると、このフィールドは非表示になります。他のすべてのイベント・タイプでは、このフィールドが表示されます。

3. アイテム、ボタン、リージョン、DOMオブジェクトまたはjQueryセレクタ: ページ要素の名前を次のように選択します。

- アイテム: 動的アクションをトリガーする1つ以上のページ・アイテム名を入力または選択します。複数のアイテムを指定する場合は、アイテムをカンマで区切ります。

- ボタン: 動的アクションをトリガーするボタンを選択します。ボタンがテンプレート・ボタンの場合、選択されたボタンは、#BUTTON_ID#に設定されたID属性を含むボタン・テンプレートを使用する必要があります。動的アクション・フレームワークは、ボタンを参照するためにこのID値を使用します。

- リージョン: 動的アクションをトリガーするリージョン名を選択します。選択されたリージョンは、ID属性を#REGION_STATIC_ID#に設定したコンテナ要素を含むリージョン・テンプレートを使用する必要があります。動的アクション・フレームワークは、リージョンを参照するためにこのID値を使用します。
リージョンは、イベント自体を起動したり(「リフレッシュ前」や「リフレッシュ後」のイベントの場合など)、リージョン内のアイテムまたは他の要素を起動するイベントをキャッチするコンテナになることもできます。このことがサポートされているイベントのサブセットは、変更(change)、クリック(click)、ダブルクリック(dblclick)、フォーカスの取得(focus)、キー・ダウン(keydown)、キー・プレス、キー・リリース(keyup)、フォーカスを失う(blur)、マウス・ボタン・プレス(mousedown)、マウス・ボタン・リリース(mouseup)、マウス・ムーブ(mousemove)のみです。

- DOMオブジェクト: 動的アクションをトリガーするDocument Object Model (DOM)オブジェクト定数(たとえば、documentやwindow)またはDOMオブジェクトのIDを入力します。

- jQueryセレクタ: 動的アクションをトリガーする1つ以上のページ要素を戻すjQueryセレクタ構文を入力します。

4. 条件: 条件を指定するには、「条件」リストから選択します。条件タイプに応じて、テストする条件の値の入力が必要になることがあります。条件を指定しない場合、Trueアクションのみが起動されます。条件を指定した場合、条件が満たされるとTrueアクションが起動され、条件が満たされないとFalseアクションが起動されます。

5. 以前指定されたイベントが発生して条件が満たされた場合に実行されるアクションを指定し、「次へ」をクリックします。

- Trueアクションの場合: 選択されたアクションによっては、追加のオプションが表示されます。これらのオプションを使用して、アクションを実行するために必要な追加の設定と値を指定します。
コンポーネント

- クリア: 影響を受ける要素をクリアします。

- 無効化: 影響を受ける要素を無効化します。影響を受ける要素を無効化することによって、ページ要素は編集不可能になり、ページが送信されるときにアイテムの値を保存しません。

- 有効化: 影響を受ける要素を有効化します。

- 非表示: 影響を受ける要素を非表示にします。「同じ行のすべてのページ・アイテムを非表示」にするオプションもあります。

- リフレッシュ: 影響を受ける要素のリフレッシュをトリガーします。すべての要素でリフレッシュがサポートされるわけではありません。リフレッシュは、対話モード・レポート、クラシック・レポート、チャート、カスケードLOVサポートが存在するすべてのアイテム・タイプに使用できます。プラグインでもこのアクションがサポートされる場合があります。

- フォーカスの設定: 影響を受ける要素にフォーカスを設定します。影響を受ける要素が複数ある場合、先頭の要素にデフォルトで設定されます。このことは、特に、適切なアイテムをユーザーに直接示すために、「表示」および「有効化」アクションと組み合せて使用する場合に役立ちます。

- 値の設定: 影響を受ける要素の値を設定します。これは、「静的割当て」、「JavaScript式」、「SQL文」、「PL/SQL式」、「PL/SQLファンクション本体」のタイプの設定をサポートします。「SQL文」のタイプの設定は、問合せで1から100の間の列を選択することによる、1から100の間のページ・アイテム値の設定をサポートします。それ以外のすべてのタイプの設定では、1つのページ・アイテムの設定しかサポートしません。ページで複数の値を設定する他の方法については、「PL/SQLコードの実行」アクションを参照してください。

- 表示: 影響を受ける要素を表示します。「同じ行のすべてのページ・アイテムを表示」のオプションもあります。

実行

- JavaScriptコードの実行: 動的アクション・フレームワーク内で使用する、ページ固有のカスタムJavaScriptコードを定義またはコールできます。1つのページについてのみ固有のJavaScriptコードを定義する場合、新しいページ・レベル属性「ファンクションおよびグローバル変数の宣言」を使用してこれを定義することもできます。ここで定義されるファンクションと変数は、後でこのアクションから参照できます。

- PL/SQLコードの実行: サーバー上でPL/SQLコードを実行します。実行中にエラーが発生した場合、ユーザーにアラートが表示されます。セッション・ステートの値に基づいて、サーバーへのコールが返されたときページに設定されるページ・アイテムを指定するには、「返されるページ・アイテム」を定義します。「返されるページ・アイテム」オプションが使用された場合に、「返されるページ・アイテム」に対して変更ベースの動的アクションがそれ以降起動されないようにするには、「変更イベントの禁止」を「はい」に設定します。

通知

- アラート: アラートを表示します。

- 確認: 確認ダイアログを表示します。ユーザーが「取消」を選択した場合、続行アクションは実行されず、現在のイベントは取り消されます。

スタイル

- クラスの追加: 影響を受ける要素に1つ以上のCSSクラスを追加します。

- クラスの削除: 影響を受ける要素から1つ以上またはすべてのクラスを削除します。

- スタイルの設定: スタイル、CSS、プロパティを影響を受ける要素に設定します。

その他

- イベントの取消: ある特定の条件に基づき、後続の動的アクションまたはイベントの起動を取り消します。このことは、次の状況で役立つ場合があります。
同じイベント(「クリック」など)に基づく複数の動的アクションが1つのページ上にあり、かつ、それらの動的アクションがそのページ上の同じ要素を参照する場合、「イベントの取消」アクションは、アクションの「WHEN条件」に基づく条件によって、後続の動的アクションの起動を防止するために使用できます。

1つの動的アクションに複数のtrueアクションがある場合、「イベントの取消」は、後続のアクションが処理されるのを停止するために使用できます。動的アクションのアクションを条件付きで起動するように定義できないため、現在は値が制限されています。したがって、このイベントでは、常に、後続のアクションの処理を防止するのみです。アクションを防止することは、デバッグに役立つ場合があります。

動的アクションの「ページの送信前」イベントと組み合せて使用して、ページの送信を取り消すために使用します。たとえば、「ページの送信前」イベントで起動される動的アクションを定義するとします。「条件」で、「JavaScript式」を定義し、「値」に$v('P2_ENAME') == 'DO NOT SUBMIT'のような式を入力します。その後、「イベントの取消」アクションを使用するTrueアクションを定義すると、ページはENAMEフィールドがDO NOT SUBMITに等しいときに送信されません。

- ページの送信: ページを送信します。またオプションで、ページの送信時にカレント・ページを無効化して、プロセス・スタイルのGIFを表示できます。

プラグイン

- my_plugin_action[Plug-in]: アプリケーション構成によっては、ここで追加のプラグイン動的アクションを使用できる場合もあります。これらはmy_plugin_action [Plug-in]と表示されます。プラグイン動的アクションはアプリケーションの共有コンポーネント内にインストールされます。プラグイン開発者はアクションに対応するカテゴリを割り当てます(コンポーネント、実行など)。

- ページのロード時に実行: ページをロードするときにこのアクションもトリガーするには、このオプションを選択します。このオプションがデフォルトで選択されているかどうかは、選択されたアクションのタイプによって異なります。

- 反対のFALSEアクションの生成: 反対のfalseアクションも生成するには、このオプションを選択します。反対として扱われるアクションは、「表示/非表示」、「有効/無効」および「クラスの追加」/「クラスの削除」です。このオプションは、前述のアクションのいずれかが選択され、「WHEN条件」が指定されている場合にのみ表示されます。

6. 「影響を受ける要素」(影響を受ける要素がサポートされているアクションでのみ使用可能)で、この動的アクションによる影響を受ける要素と要素が受ける影響を指定し、「次へ」をクリックします。
動的アクションを作成する最終ステップは、影響を受ける要素の選択が、選択したアクションによってサポートされているかどうかによって異なります。「ページの送信」のような一部のアクションでは、影響を受ける要素を選択する必要はありません。「表示」などの他のアクションでは、影響を受ける要素を選択する必要があります。影響を受ける要素の選択が、選択したアクションによってサポートされていない場合、最後のページは動的アクションの詳細を確認できる、単なる確認ページとなります。影響を受ける要素の選択が、選択したアクションによってサポートされている場合、このページのオプションは次のとおりです。

- 選択タイプ: 動的アクションによる影響を受けるページ要素のタイプを選択します。選択されたタイプによって、追加のオプションが表示されます。これらのオプションを使用して、要素が受ける影響を指定するために必要な追加の設定と値を指定します。

- アイテム、ボタン、リージョン、DOMオブジェクトまたはjQueryセレクタ: ページ要素の名前を次のように選択します。

- アイテム: 動的アクションによる影響を受けるアイテム名を選択します。

- ボタン: 動的アクションの影響を受けるボタンを選択します。ボタンがテンプレート・ボタンの場合、選択されたボタンは、#BUTTON_ID#に設定されたID属性を含むボタン・テンプレートを使用する必要があります。動的アクション・フレームワークは、ボタンを参照するためにこのID値を使用します。

- リージョン: 動的アクションによる影響を受けるリージョン名を入力または選択します。選択されたリージョンは、ID属性を#REGION_STATIC_ID#に設定したコンテナ要素を含むリージョン・テンプレートを使用する必要があります。動的アクション・フレームワークは、リージョンを参照するためにこのID値を使用します。

- DOMオブジェクト: 動的アクションの影響を受けるDocument Object Model (DOM)オブジェクト定数(たとえば、documentやwindow)またはDOMオブジェクトのIDを入力します。

- jQueryセレクタ: 動的アクションの影響を受ける1つ以上のページ要素を戻すjQueryセレクタ構文を入力します。

- トリガー要素: 動的アクションの「時期」で定義されているページ要素にアクセスできます。

- イベント・ソース: イベントが発生したページ要素にアクセスできます。これは、「トリガー要素」とは異なる場合があります。たとえば、「WHEN要素」がコンテナ要素(リージョンなど)で、そのコンテナ要素が下位要素(そのリージョン内のページ・アイテムなど)によって起動されたイベントを処理するように定義されている場合、「イベント・ソース」を使用して、イベントをトリガーした下位要素に容易に対応できます。

7. 「動的アクションの作成」をクリックします。

動的アクションの編集

動的アクションを作成した後、作成プロセス中に定義した属性を変更したり、プロセス中に指定できなかった属性を指定したり(「認可スキーム」の指定など)、追加のtrueアクションを追加できます。

関連項目:
「動的アクションの作成」、「Trueアクションの追加」、「頻度と有効範囲の定義」

動的アクションを編集するには、次のステップを実行します。

1. 該当する「ページ定義」にナビゲートします。「「ページ定義」へのアクセス」を参照してください。

2. 「ページ・レンダリング」で、「動的アクション」までスクロールして、変更する動的アクションをクリックします。
動的アクションの編集ページが表示されます。

3. 変更を行い、「適用」をクリックします。

Trueアクションの追加

動的アクションには、Trueアクションが起動する時期を制御するために指定できる条件が含まれています。たとえば、従業員情報をマネージャに表示するアプリケーションについて考えます。従業員が上級一般職の場合は給与が表示され、それ以外の場合は時給が表示されます。

動的アクション作成ウィザードでは、1つのTrueアクションのみ指定できます。複数のアクションを追加するには、動的アクションを作成するための作成ウィザードを使用した後、Trueアクションを追加するようにアクションを編集する必要があります。

アクションを追加するには、次の手順を実行します。

1. 該当する「ページ定義」にナビゲートします。「「ページ定義」へのアクセス」を参照してください。

2. 「ページ・レンダリング」で、「動的アクション」までスクロールして、変更する動的アクションをクリックします。
動的アクションの編集ページが表示されます。

3. 条件が満たされたとき、または条件が指定されなかったときに実行されるアクションを追加するには、「Trueアクション」までスクロールして、「Trueアクションの追加」をクリックします。
アクションの作成/編集ページが表示されます。

4. 「指定」で、次の項目を指定します。

1. 順序: このコンポーネントの順序を入力します。これにより、実行順序を指定します。

2. アクション: 条件がtrueのときにトリガーされるアクションを選択します。

5. 「実行オプション」で、次の項目を指定します。

1. ページのロード時に実行: ページをロードするときにもアクションをトリガーする場合に選択します。

2. エラー時に実行停止: 現在のアクションの実行中にエラーが発生した場合、続行アクションを実行するかどうかを指定します。「PL/SQLコードの実行」など、選択されたアクションがこの属性を公開するように定義されている場合のみ使用可能です。

3. 結果を待機: 現在のアクションの結果を待機してからアクションを実行するか(アクションが結果に依存している場合)、または待機せずに実行するかを指定します。「PL/SQLコードの実行」など、選択されたアクションがこの属性を公開するように定義されている場合のみ使用可能です。

6. 「影響を受ける要素」で、次の項目を指定します(選択されたアクションで、影響を受ける要素の定義がサポートされる場合にのみ使用可能)。

注意:
選択されたアクションのタイプによって、次のフィールドの一部またはすべてを選択できないことがあります。たとえば、「無効化」アクションでは、影響を受ける要素として「リージョン」を選択することがサポートされていません。

1. 選択タイプ: 動的アクションによる影響を受けるページ要素のタイプを選択します。ページ要素の名前を指定するための対応する名前フィールドが表示されます。

2. アイテム、ボタン、リージョン、DOMオブジェクトまたはjQueryセレクタ: ページ要素の名前を次のように選択します。

- アイテム: 動的アクションによる影響を受けるアイテム名を入力または選択します。

- ボタン: 動的アクションによって影響を受けるボタンを選択します。ボタンがテンプレート・ボタンの場合、選択されたボタンは、#BUTTON_ID#に設定されたID属性を含むボタン・テンプレートを使用する必要があります。動的アクション・フレームワークは、ボタンを参照するためにこのID値を使用します。

- リージョン: 動的アクションによる影響を受けるリージョン名を入力または選択します。選択されたリージョンは、ID属性を#REGION_STATIC_ID#に設定したコンテナ要素を含むリージョン・テンプレートを使用する必要があります。動的アクション・フレームワークは、リージョンを参照するためにこのID値を使用します。

- DOMオブジェクト: 動的アクションの影響を受けるDocument Object Model(DOM)オブジェクトまたはDOMオブジェクトのIDを入力します。

- jQueryセレクタ: 動的アクションの影響を受ける1つ以上のページ要素を戻すjQueryセレクタ構文を入力します。

7. 「コメント」に、開発者のコメントまたは注意を入力します。これらのコメントは、アプリケーションの実行中に表示されません。

8. 「作成」をクリックします。
動的アクションの編集ページが表示され、追加したアクションが「Trueアクション」の下に表示されます。

頻度と有効範囲の定義

動的アクションを作成した後、アクションの有効範囲を1回のみのトリガーとするか、現在のページの存続期間中とするか、トリガー要素が部分ページ・リフレッシュ(PPR)によって更新されるまでとするかを変更できます。

有効範囲を指定するには、次のステップを実行します。

1. 該当する「ページ定義」にナビゲートします。「「ページ定義」へのアクセス」を参照してください。

2. 「ページ・レンダリング」で、「動的アクション」までスクロールして、変更する動的アクションをクリックします。
動的アクションの編集ページが表示されます。

3. 「詳細」までスクロールして、「イベント有効範囲」で次のいずれかを選択します。

1. 静的(デフォルト): 現在のページの存続期間中、イベント・ハンドラをトリガー要素にバインドします。ただし、トリガー要素が部分ページ・リフレッシュ(PPR)を通じて更新された場合はバインドされなくなります。

2. 動的: 現在のページの存続期間中、イベント・ハンドラをトリガー要素にバインドします(部分ページ・リフレッシュ(PPR)を通じて更新されたトリガー要素を含む)。「動的」を指定すると、追加フィールド「静的コンテナ(jQueryセレクタ)」が表示されます。静的コンテナを指定すると、動的なイベント有効範囲を使用したイベントの処理のパフォーマンスを改善できます。これは、再作成されないページ要素ですが、部分ページ・リフレッシュ(PPR)によって再作成されるトリガー要素を含みます。この要素参照は、jQueryセレクタとして定義する必要があります。たとえば、(PPRによって再作成される)対話モード・レポート・リージョンの行になんらかの処理を実行する動的アクションがある場合、レポートのリフレッシュ後も動的アクションが機能するようにするには、「イベント有効範囲」を「動的」にする必要があります。また、静的コンテナの値を、リージョンの静的ID値を選択するjQueryセレクタに設定できます(例: '#my_region')。

3. 1回: 1回のみのイベントについて、イベント・ハンドラをトリガー要素にバインドします。

4. 「変更の適用」をクリックします。

動的アクションのデバッグ

Oracle Application Express内での動的アクションのデバッグは、他のデバッグと少し異なります。これは、動的アクション・フレームワーク内で実行される処理の多くが、サーバー側でなくクライアント側で実行されるためです。動的アクションをデバッグするために、ブラウザでJavaScriptコンソールがサポートされている場合、Oracle Application Expressはデバッグ情報をブラウザのJavaScriptコンソールに出力します(たとえば、FirebugがインストールされたFirefoxは、デバッグ情報を「Console」ペインに表示します)。デバッグ情報によって、動的アクションが起動された時期、動的アクションの名前およびアクションJavaScriptオブジェクトがわかります。これには、クライアントがアクションを実行するために必要なすべての情報(イベント名、時期の詳細、アクション、影響を受ける要素など)が含まれます。

動的アクションをデバッグするには、次のステップを実行します。

1. 動的アクションが含まれているアプリケーションのデバッグが有効化されていることを確認します。「デバッグ・モードへのアクセス」を参照してください。

2. 動的アクションが含まれているページを実行します。

3. ブラウザのJavaScriptコンソールを開きます。

4. 「開発者」ツールバーで、「デバッグ」をクリックします。
ページがリフレッシュされます。ページのロード時に起動するように設定されている動的アクションがある場合は、コンソールに次のテキスト出力が表示されます。

Dynamic Action Fired: [Dynamic action name] ({JavaScript Object containing all Dynamic Action information})

デバッグ情報はデバッグ・モードで実行されている場合にのみ出力されるため、デバッグ・モードをオンのままにすることで、動的アクションが予期される時期に起動されるかどうかをさらにテストできます。たとえば、ある特定のアイテムの値が変更されるときに起動する動的アクションを定義した場合、そのアイテムの値を変更すると、動的アクションが起動したかどうかのデバッグ出力がコンソールに表示されます。

フォームおよびレポートでのBLOBサポートについて

Oracle Application Expressでは、宣言的なBLOBサポートが提供されているため、開発者はフォームでのファイルの宣言的なアップロードや、レポートでのファイルのダウンロードおよび表示を行うことができます。BLOBの表示とダウンロードは、PL/SQLを使用して手続き的に作成することもできます。このセクションでは、ファイルのアップロード、ダウンロードおよび表示を行う方法と、BLOB列に格納されているファイルを正しく管理するために重要となる追加のファイル属性(MIMEタイプやファイル名など)の管理方法について説明します。この機能を使用すると、簡単にOracle Application Expressアプリケーションを拡張して、イメージ、ドキュメント、ビデオなどのファイルを管理できます。

内容は次のとおりです。

- フォームでのBLOBについて

- レポートでのBLOBサポートについて

- 手続き的なBLOBの使用

フォームでのBLOBについて

フォームを作成する場合(アプリケーションの作成ウィザードを使用して、フォーム・タイプ(またはレポートおよびフォーム・タイプ)のページを作成するか、フォーム・タイプのリージョンを作成する)、または既存のフォームにアイテムを追加する場合、BLOBタイプのデータベース列がソースであるアイテムは、ファイル参照タイプのアイテムになります。フォームがINSERTにコールされる場合、ユーザーが選択したファイルは、BLOB列にロードされます。フォームが更新にコールされる場合、ダウンロード・リンクが「参照」ボタンの右に表示されます。ユーザーは、このリンクを使用してファイルをダウンロードできます。

BLOBへのファイルのアップロードとダウンロード

デフォルトのBLOBサポートでは、一般的なアプリケーションでBLOBを効果的に管理するために必要とされるすべての情報が提供されているわけではありません。列がBLOBであるという情報に加えて、ファイルの詳細情報も提供されると、エンド・ユーザーの使いやすさが向上します。ファイル参照ページ・アイテムには、この追加情報を完全に宣言的に管理することを容易にするための追加設定があります。

関連項目:
付録A、「アイテム・タイプについて」の「ファイル参照」、「ファイル参照」設定のアイテム・レベル・ヘルプ

ファイル参照アイテム・タイプ内では、次の2つの異なるタイプの記憶域タイプが使用できます。

- アイテム・ソース属性で指定されたBLOB列: ここで説明する追加設定の構成をサポートする、完全に宣言的なアプローチです。この記憶域タイプでは、所有するデータベース表のBLOBを参照します。

- WWV_FLOW_FILES表: WWV_FLOW_FILES表に格納されたBLOBを参照する場合の拡張オプションです。

この追加情報を提供するには、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列」である「ファイル参照」アイテム・タイプを使用します。このプロセスによって、表名と主キー列が決定されます。

BLOBの表示

作業中のBLOBがイメージである場合は、そのイメージをフォームでも表示できます。これを宣言的に処理するために、イメージの表示アイテム・タイプを使用できます。付録A、「アイテム・タイプについて」を参照してください。手続き的に処理するには、「手続き的なBLOBの使用」を参照してください。

イメージ参照の削除

ファイル参照の使用時はNULLへの設定が存在しないため、イメージ参照を削除するメカニズムを提供する必要がある場合は、イメージを削除する特別なボタン(必要な列を無効化する機能を持つボタン)を含める必要があります。次に例を示します。

UPDATE demo_product_info
SET product_image = NULL,
MIMETYPE = NULL,
FILENAME = NULL,
IMAGE_LAST_UPDATE = NULL,
CHARSET = NULL
WHERE product_id = :P6_PRODUCT_ID;

レポートでのBLOBサポートについて

Oracle Application Expressでは、従来のレポートと対話モード・レポートの両方に対するBLOBサポートが提供されています。ウィザードを使用してレポートを作成し、BLOBタイプの列を含める場合は、基本的なサポートが含まれます。ダウンロード機能を使いやすくするために、生成後に詳細情報を追加する必要があります。

ダウンロード・リンクの提供

レポートにダウンロード・リンクを容易に含めることができるように、レポートにはBLOBの長さ(dbms_lob.getlength(RESUME)など)を選択します。長さが0の場合、BLOBはNULLとなり、ダウンロード・リンクは表示されません。同様に、ダウンロード・リンクの書式を設定できる、日付または数に対する書式マスクを指定します。DOWNLOAD書式は、次の例のように3つ以上のパラメータを指定する必要があるという点で他の書式マスクより複雑です。

DOWNLOAD:EMP:RESUME:EMPNO

次の表に、DOWNLOAD書式のパラメータの説明を示します。

位置

属性

必須

説明

1

DOWNLOAD

はい

DOWNLOADレポート書式マスクを指定します。

2

表名

はい

BLOBタイプのターゲット列を含む表の名前(大/小文字が区別されます)。

3

BLOBを含む列

はい

BLOBタイプの列の名前(大/小文字が区別されます)。

4

主キー列1

はい

主キー列1の名前。大文字と小文字が区別されます。

5

主キー列2

いいえ

主キー列2の名前。大文字と小文字が区別されます。

6

MIMEタイプ列

いいえ

MIMEタイプを格納するために使用する列名(大/小文字が区別されます)。

7

ファイル名列

いいえ

BLOBのファイル名を格納するために使用する列名(大/小文字が区別されます)。ユーザーがファイルをダウンロードするときにNULLの場合は、この列名がデフォルトで使用されます。

8

最終更新列

いいえ

BLOBの最終更新日付を格納するために使用する列名(大/小文字が区別されます)。これを使用すると、ファイルをダウンロードする際のHTTPヘッダーに最終変更日が示され、BLOBをWebブラウザにキャッシュできるようになります。指定しない場合は、ファイルをブラウザにキャッシュできない場合があります。

9

キャラクタ・セット列

いいえ

BLOBのキャラクタ・セットを格納するために使用する列名(大/小文字が区別されます)。キャラクタ・セットのエンコーディングを維持する必要がある場合など、アジア言語で最も使用されます。

10

コンテンツ配置

いいえ

inlineまたはattachmentを指定します。その他の値はすべて無視されます。MIMEタイプが提供され、ファイルが表示可能なタイプである場合は、ファイルが表示されます。MIMEタイプが提供されていない場合、またはファイルをインラインで表示できない場合、ユーザーはダウンロードを行うように求められます。

11

ダウンロード・テキスト

いいえ

ダウンロード・リンクに使用する文字列。何も指定されていない場合は、Downloadが使用されます。これは置換をサポートしています(翻訳されたアプリケーションに有効です)。

次に例を示します。

DOWNLOAD:EMP:RESUME:EMPNO::RESUME_MIMETYPE:RESUME_FILENAME:RESUME_LAST_UPDATE::attachment:Resume

これらのパラメータを入力し、前述の書式を作成できるためには、条件があります。「数値/日付書式」アイテムに対して「BLOBフォーマット」を選択する必要があります。選択すると、新しいリージョン「BLOB列属性」が表示され、前述のすべてのパラメータを入力できます。

BLOBの表示

作業中のBLOBがイメージである場合は、レポートでも表示できます。そのためには、新しいレポート書式マスク「IMAGE」を使用します。MIMEタイプに関係なく、レポートでは常にBLOBの表示が試行されます。BLOBをレンダリングできない場合、壊れたイメージが表示されます。

次の表に、IMAGE書式マスクのパラメータの説明を示します。

位置

属性

必須

説明

1

IMAGE

はい

IMAGEレポート書式マスクを指定します。

2

表名

はい

BLOBタイプのターゲット列を含む表の名前(大/小文字が区別されます)。

3

BLOBを含む列

はい

BLOBタイプの列の名前(大/小文字が区別されます)。

4

主キー列1

はい

主キー列1の名前。大文字と小文字が区別されます。

5

主キー列2

いいえ

主キー列2の名前。大文字と小文字が区別されます。

6

MIMEタイプ列

いいえ

MIMEタイプを格納するために使用する列名(大/小文字が区別されます)。

7

ファイル名列

いいえ

IMAGE書式には使用しませんが、IMAGEとDOWNLOAD間で書式を簡単に変更する場合に必要です。

8

最終更新列

いいえ

BLOBの最終更新日付を格納するために使用する列名(大/小文字が区別されます)。これを指定すると、ファイルをダウンロードする際のHTTPヘッダーに最終変更日が示され、BLOBをWebブラウザにキャッシュできるようになります。指定しない場合は、ファイルをブラウザにキャッシュできない場合があります。

9

キャラクタ・セット列

いいえ

IMAGE書式には使用しませんが、IMAGEとDOWNLOAD間で書式を簡単に変更する場合に必要です。

10

コンテンツ配置

いいえ

IMAGE書式には使用しませんが、IMAGEとDOWNLOAD間で書式を簡単に変更する場合に必要です。

11

代替テキスト

いいえ

イメージに関連付けられている代替タグに使用する文字列です。

次に例を示します。

IMAGE:EMP:RESUME:EMPNO::RESUME_MIMETYPE:RESUME_FILENAME:RESUME_LAST_UPDATE::attachment:Resume

上述の説明に従い、これらのパラメータを入力し、形式を作成します。「数値/日付書式」アイテムに対して「BLOBフォーマット」を選択する必要があります。選択すると、新しいリージョン「BLOB列属性」が表示され、前述のすべてのパラメータを入力できます。

手続き的なBLOBの使用

ダウンロード・リンクを指定した組込み方式を使用するかわりに、APEX_UTIL.GET_BLOB_FILE_SRCファンクションを使用できます。この方法を使用すると、イメージの表示形式をより具体的に設定できます(高さタグおよび幅タグを使用)。この方法は、有効なOracle Application Expressセッションからコールされた場合のみ有効であることに注意してください。また、BLOBを記述するパラメータを、アプリケーション内の有効なアイテムの書式としてリストする必要もあります。この項目は後でファンクションが参照します。

関連項目:
Oracle Application Express APIリファレンスの「GET_BLOB_FILE_SRCファンクション」

データベース・アプリケーションでのスクリーン・リーダー・モードの使用

Oracle Application Express開発環境、Webシート・ランタイムに加え、独自のデータベース・アプリケーション内でも、Oracle Application Expressのセッションがスクリーン・リーダー用に最適化されました。デフォルトでは、セッションはスクリーン・リーダー・モードで実行するようにフラグ付けされていません。この項では、独自のデータベース・アプリケーションのユーザーがこのモードを使用できるようにする方法とそれを拡張する方法について説明します。

このモードによって、スクリーン・リーダーによるOracle Application Expressの使いやすさが向上されますが、未解決の問題が残っている領域がある場合があります。未解決の問題とその回避策(ある場合)の完全なリストは、「Oracle Application Expressのアクセシビリティ」とOracle Application Expressリリース・ノートを参照してください。

内容は次のとおりです。

- スクリーン・リーダー・モードのプロビジョニング

- スクリーン・リーダー・モードの拡張

関連項目:
「スクリーン・リーダー・モードについて」

スクリーン・リーダー・モードのプロビジョニング

独自のデータベース・アプリケーションでの使用に対してこのモードをプロビジョニングするには、3つの方法があります。

1. ページ・テンプレート#SCREEN_READER_TOGGLE#置換文字列: この置換文字列をページ・テンプレートに追加すると、Oracle Application Expressでは、モードをオンまたはオフにする(切り替える)ためのリンクをカレント・ページに表示します。したがって、標準モードの場合、このプロシージャによってモードをオンに切り替えるリンクが生成されます。

2. このモードを制御するために使用できるAPIもあります。1つの場所でのみ切替えをレンダリングし、ページ・テンプレート・レベルではこのことを行わない場合や、実際に表示されるリンク・テキストをより詳細に制御する場合に、APIを使用することがあります。これらのAPIの詳細は、Oracle Application Express APIリファレンスを参照してください。

3. f?p構文のREQUEST属性を使用してスクリーン・リーダー・モードを有効化および無効化します。f?pの一般的な構文は、次のとおりです。

f?p=application:page:session:request:...

リクエストがSET_SESSION_SCREEN_READER_ONまたはSET_SESSION_SCREEN_READER_OFFの場合、セッションのスクリーン・リーダー・モードがオンまたはオフになります。次に例を示します。

<a href="f?p=100:1:&SESSION.:SET_SESSION_SCREEN_READER_ON">Set Screen Reader On</a>

スクリーン・リーダー・モードの拡張

「スクリーン・リーダー・モードの機能」で説明されている、このモードのデフォルトの機能に加えて、ユーザー独自のページ・コンポーネントを制御することもできます。たとえば、スクリーン・リーダー・モードでの実行時に、条件付きでリージョンを表示できます。関連するデータベース・ファンクション、APEX_UTIL.IS_SCREEN_READER_SESSIONおよびAPEX_UTIL.IS_SCREEN_READER_SESSION_YNの詳細は、『Oracle Application Express APIリファレンス』を参照してください。

データベース・アプリケーションでのハイ・コントラスト・モードの使用

Oracle Application Express開発環境、Webシート・ランタイムに加え、独自のデータベース・アプリケーション内でも、セッションがハイ・コントラスト用に最適化されていることを確認できます。この項では、独自のデータベース・アプリケーションのユーザーがこのモードを使用できるようにする方法とそれを拡張する方法について説明します。

内容は次のとおりです。

- ハイ・コントラスト・モードのプロビジョニング

- ハイ・コントラスト・モードの拡張

関連項目:
「ハイ・コントラスト・モードについて」

ハイ・コントラスト・モードのプロビジョニング

独自のデータベース・アプリケーションのユーザーに対してこのモードをプロビジョニングするには、次の3つの方法があります。

- ページ・テンプレート#HIGH_CONTRAST_TOGGLE#置換文字列: この置換文字列をページ・テンプレートに追加すると、Oracle Application Expressでは、モードをオンまたはオフにする(切り替える)ためのリンクがカレント・ページに表示されます。つまり、標準モードの場合、このプロシージャによってモードをオンに切り替えるリンクが生成されます。

- APEX_UTIL API: このモードを制御するために使用できるAPIもあります。1つの場所でのみ切替えをレンダリングし、ページ・テンプレート・レベルではこのことを行わない場合や、実際に表示されるリンク・テキストをより詳細に制御する場合に、APIを使用することがあります。詳細は、『Oracle Application Express APIリファレンス』のAPEX_UTILに関する説明を参照してください。

- f?p構文のREQUEST属性: この属性を使用して、ハイ・コントラスト・モードを有効化および無効化します。f?p構文のREQUEST属性の一般的な構文は、次のとおりです。

f?p=application:page:session:request:...

リクエストがSET_SESSION_HIGH_CONTRAST_ONまたはSET_SESSION_HIGH_CONTRAST_OFFの場合、セッションのハイ・コントラスト・モードがオンまたはオフになります。次に例を示します。

<a href="f?p=100:1:&SESSION.:SET_SESSION_HIGH_CONTRAST_ON">Set High Contrast On</a>

ハイ・コントラスト・モードの拡張

「ハイ・コントラスト・モードの機能」で説明されている、このモードのデフォルトの機能に加えて、ユーザー独自のコンポーネントを制御することもできます。たとえば、ハイ・コントラスト・モードでの実行時に、ハイ・コントラストに固有のCSSファイルを条件付きで含めることができます。

ファンクションAPEX_UTIL.IS_HIGH_CONTRAST_SESSIONとAPEX_UTIL.IS_HIGH_CONTRAST_SESSION_YNの詳細は、『Oracle Application Express APIリファレンス』のAPEX_UTILに関する説明を参照してください。

データ・ロード機能によるアプリケーションの作成

データ・ロード機能を持つアプリケーションでは、エンド・ユーザーは、アクセスできる任意のスキーマ内にある表にデータを動的にインポートできます。これを行うには、エンド・ユーザーは、ファイルからデータをアップロードするか、エンド・ユーザーがウィザードに直接入力したデータをコピー・アンド・ペーストするデータ・ロード・ウィザードを実行します。

アプリケーションの開発者は、ページの作成ウィザードにより「データ・ロード」タイプのページを作成して、データ・ロード・ウィザードを作成します。作成プロセスで、開発者はアップロード表とその固有の列、表参照とデータ・トランスフォーメーション・ルールを指定できます。「データ・ロード・ウィザードの作成」を参照してください。

ページの作成ウィザードにより、データ・ロード・ウィザードを定義するデータ・ロード表が作成されます。開発者は、アプリケーションの「共有コンポーネント」で、該当するデータ・ロード表を見つけてクリックし、表参照やデータ・トランスフォーメーション・ルールなどのデータ・ロード・ウィザードの定義を編集します。「データ・ロード・ウィザードの編集」を参照してください。

データ・ロード・ウィザードの使用方法の詳細は、『Oracle Application Expressエンド・ユーザーズ・ガイド』のデータのアップロードに関する説明を参照してください。

内容は次のとおりです。

- データ・ロード・ウィザードの作成

- データ・ロード・ウィザードの編集

データ・ロード・ウィザードの作成

ページの作成ウィザードは、複数のページで構成されるデータ・ロード・ウィザードを作成するために、開発者が使用します。データ・ロード・ウィザードは、次を含めるように定義できます。

- 表の定義: この定義は、一意のキー列を持つデータ・アップロード表の名前を指定します。

- データ・トランスフォーメーション・ルール: インポート・データを大文字や小文字に変更するといったトランスフォーメーションのフォーマットを行うために、データ・トランスフォーメーション・ルールを定義します。インポート・ファイルに大文字と小文字の両方を含む列データがあり、アップロード表では大文字のみが必要な場合、データのアップロード時にその列には大文字のみを挿入するようにデータ・トランスフォーメーション・ルールを定義します。

- 表参照: 別の表に含まれる可能性があるデータにマップする必要があるデータがインポート・ファイルに存在する場合、マッピングを実行する表参照を指定します。たとえば、インポート・ファイルにはDEPTNO列に部門名が含まれているが、アップロード表ではその列に数値が必要な場合、表参照ルールを使用して、別の表でその部門名に対応する部門番号を探します。

- 列名の別名: エンド・ユーザーは、表の列名に基づいてアップロードする列を正しく特定できない場合があります。そのため、各列の別名を定義できます。これらの別名は、スプレッドシート・データのアップロード中にエンド・ユーザーに対して表示されます。LOVを作成する場合、データ列のマッピング中にアプリケーションで別名が自動的に選択されます。それ以外の場合は、表の列名が使用されます。作成したLOVは、編集したり、列をリストから削除することもできます。

- 同時実行性の管理: デフォルトでは、最後にデータを送信したユーザーがレコードを更新します。このオプションを使用すると、開発者はレコード・バージョンの追跡に使用できる列を選択できます。このことは、異なるユーザーが定期的に更新する表を処理する場合に特に重要となります。ユーザーがデータをアップロードしようとするたびに、データのロード機能によって、レコード・バージョンを追跡するために、この列が使用されます。この列の値のアップロード中に値の変更が検出された場合、レコードにはフラグが付けられ、そのレコードが直接更新されることはなく、エンド・ユーザーがさらにアクションを実行するときにそのことが通知されます。

データ・ロード・ウィザードを作成するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。
アプリケーション・ビルダーのホームページが表示されます。

2. アプリケーションを選択します。
「アプリケーション」ホームページが表示されます。

3. 「ページの作成」をクリックします。

4. 「データのロード」を選択し、「次へ」をクリックします。

5. 「データ・ロード表」で、次を指定してから、「次へ」をクリックします。

- データ・ロード定義名: このデータ・ロード定義の名前を入力します。

- 所有者: データ・ロード表の所有者を選択します。

- 表名: データのロードに使用する表を選択します。アップロード表とも呼ばれます。

- 一意列1: データ・ロードの処理で一意の主キー列として使用する列名を選択します。少なくとも1つの一意のキー列が必要です。

- 大/小文字区別: 「一意列1」に選択した列で大文字と小文字を区別する場合は、「はい」を選択します。そうでない場合は、「いいえ」を選択します。

- 一意列2: データ・ロード表の一意キーの定義が、2つ以上の列から構成される複合キーの場合、データ・ロードの処理中に2番目の一意キーの列として使用される列名を選択します。

- 大/小文字区別: 「一意列2」に選択した列で大文字と小文字を区別する場合は、「はい」を選択します。そうでない場合は、「いいえ」を選択します。

- 一意列3: データ・ロード表の一意キーの定義が、3つ以上の列から構成される複合キーの場合、データ・ロードの処理中に3番目の一意キーの列として使用される列名を選択します。

- 大/小文字区別: 「一意列3」に選択した列で大文字と小文字を区別する場合は、「はい」を選択します。そうでない場合は、「いいえ」を選択します。

6. 「トランスフォーメーション・ルール」(オプション)で次を指定し、「追加」をクリックします。

- 順序: トランスフォーメーション・ルールの順序を指定します。これによって実行の順序が決まります。

- ルール名: このトランスフォーメーション・ルールの名前を入力します。

- 列の選択: トランスフォーメーションが必要な列の名前を選択し、右に移動します。

- タイプ: 実行するトランスフォーメーション・ルールのタイプを選択します。

7. 追加するトランスフォーメーション・ルールごとに前のステップを繰り返し、「次へ」をクリックします。

8. 「表参照」(オプション)で、次を指定して「追加」をクリックします。

- 列名: 関連する値で置換するインポート・ファイル内の列を選択します。

- 所有者: 参照表の所有者を選択します。

- 表名: 参照表の名前を選択します。これは、インポート・ファイルの値を置換するために使用する関連値を含む表です。

- 戻り列: 表参照で戻される列の名前を選択します。この値は、指定したロード列に挿入され、通常、外部キー・リレーションシップの親のキー値です。たとえば、DEPTNOのように指定します。

- アップロード列: エンド・ユーザーによって戻り列のかわりにアップロードされる列の名前を選択します。これは、参照表の表示値を含む列です。たとえば、DNAMEのように指定します。

- アップロード列2: 必要に応じて、戻り列を一意に識別するためにアップロードされる2番目の列の名前を選択します。NEW YORKとSAN FRANCISCOでは、部門IDがSALES部門とは異なる可能性があります。値を取得するには、2番目の列としてLOCATION(この場合)を渡す必要があります。

- アップロード列3: 必要に応じて、戻り列を一意に識別するためにアップロードされる3番目の列の名前を選択します。

9. 追加する表参照ごとに前のステップを繰り返し、「次へ」をクリックします。
ページ属性ページが表示され、作成されるデータ・ロード・ウィザードの各ページの短い説明が示されます。

10. ページ属性で、作成されるデータ・ロード・ウィザードの各ページのデフォルト・ページ名、ページ番号およびリージョン名を必要に応じて変更し、「次へ」をクリックします。

11. 「タブ・オプション」で、ウィザードのページのタブ・タイプを選択し、「次へ」をクリックします。

12. 「ブレッドクラム」で、データ・ロード・ウィザードのページで使用するブレッドクラムのタイプを選択し、「次へ」をクリックします。

13. 「ボタンとブランチ」で、データ・ロード・ウィザードのページのボタンに使用するブランチを指定して、「次へ」をクリックします。

14. 確認ページを確認し、「作成」をクリックします。

15. データ・ロード・ウィザードの定義を変更する場合は「ページの編集」をクリックし、そうでない場合は「ページの実行」をクリックしてデータ・ロード・ウィザードをテストします。

データ・ロード・ウィザードの編集

データ・ロード表の追加/編集ページでは、アップロード表列と一意キーの定義、表参照とトランスフォーメーション・ルールを変更できます。表参照とトランスフォーメーション・ルールは、変更、追加および削除できます。

データ・ロード・ウィザードを編集するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。
アプリケーション・ビルダーのホームページが表示されます。

2. アプリケーションを選択します。
「アプリケーション」ホームページが表示されます。

3. 「共有コンポーネント」をクリックします。

4. 「ロジック」で、「データのロード」をクリックします。

5. 編集するデータ・ロード定義をクリックします。
データ・ロード表の詳細ページが表示されます。

6. 次のデータ・ロード表の詳細を変更します。

- データ・ロード表: データ・ロード表の名前を編集し、一意列を追加、削除または編集します。

- トランスフォーメーション・ルール: トランスフォーメーション・ルールを追加、削除または編集します。

- 表参照: 表参照を追加、削除または編集します。

- 列名の別名: 「データのロード」列の別名のLOVを編集します。

- 同時実行性の管理: データのロード機能で同時実行性の管理列として使用される列を編集します。

- コメント: このデータ・ロード表のコメントを編集します。

7. 「変更の適用」をクリックします。

コンポーネント設定の管理

コンポーネント設定ページを使用して、組込みのOracle Application Expressコンポーネントおよびインストール済プラグインのアプリケーション・レベルの値を設定します。

内容は次のとおりです。

- コンポーネント設定の編集

- コンポーネント設定の履歴レポートの表示

コンポーネント設定の編集

コンポーネント設定を編集するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。
アプリケーションのホームページが表示されます。

3. 「共有コンポーネント」をクリックします。
共有コンポーネント・ページが表示されます。

4. 「ユーザー・インタフェース」で、「コンポーネント設定」をクリックします。
コンポーネント設定ページが対話モード・レポートとして表示されます。レポートをカスタマイズするには、ページ上部にある検索バーを使用します。詳細は、「対話モード・レポートのカスタマイズ」を参照してください。

5. 設定を編集し、「変更の適用」をクリックします。

コンポーネント設定の履歴レポートの表示

コンポーネント設定履歴ページでは、Oracle Application Expressコンポーネントおよびインストール済プラグインの変更のレポートを表示できます。

コンポーネント設定の履歴レポートを表示するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。
アプリケーションのホームページが表示されます。

3. 「共有コンポーネント」をクリックします。
共有コンポーネント・ページが表示されます。

4. 「ユーザー・インタフェース」で、「コンポーネント設定」をクリックします。

5. 「履歴」タブをクリックします。
履歴ページが対話モード・レポートとして表示されます。レポートをカスタマイズするには、ページ上部にある検索バーを使用します。詳細は、「対話モード・レポートのカスタマイズ」を参照してください。

18 アプリケーションのグローバリゼーションの管理

このセクションでは、アプリケーション・ビルダーで構築したアプリケーションを翻訳する方法を説明します。

内容は次のとおりです。

- アプリケーションの翻訳およびグローバリゼーション・サポートについて

- アプリケーションへのプライマリ言語の指定

- 翻訳プロセスの理解

- メッセージの翻訳

- LOVをサポートするデータの翻訳

- サポートされるグローバリゼーション・コードについて

関連項目:
Oracle Application Express管理ガイドの「インストール済の翻訳の表示」

アプリケーションの翻訳およびグローバリゼーション・サポートについて

アプリケーション・ビルダーで、同時に異なる言語で実行可能なアプリケーションを開発できます。1つのOracle DatabaseインスタンスとOracle Application Expressで、異なる言語をサポートするようにカスタマイズされた複数のデータベース・セッションをサポートできます。

一般的に、アプリケーション・ビルダーで構築したアプリケーションの翻訳は、次のようなステップになります。

- プライマリおよびターゲットのアプリケーションIDをマップします

- 翻訳用のファイルにテキストをシードおよびエクスポートします

- ファイルのテキストを翻訳します

- 翻訳済ファイルを適用します

- 翻訳済ファイルを公開します

関連項目:
「翻訳プロセスの理解」

内容は次のとおりです。

- 言語の指定について

- アプリケーション・ビルダーで構築したアプリケーションの翻訳ルール

- 翻訳済アプリケーションのレンダリング方法

- 翻訳可能なコンポーネントについて

言語の指定について

アプリケーションの作成後、グローバリゼーション属性の編集ページで言語プリファレンスを指定します。次にプライマリ・アプリケーションの言語を選択し、Application Expressエンジンによるアプリケーション言語の決定方法を決定します。ユーザーのブラウザの言語プリファレンス、アプリケーション・プリファレンスまたはアイテム・プリファレンスに基づいてアプリケーション言語を指定できます。

関連項目:
「アプリケーションへのプライマリ言語の指定」

アプリケーション・ビルダーで構築したアプリケーションの翻訳ルール

次のルールを使用して、使用する翻訳のバージョンを決定します。

- ユーザーの言語設定に完全一致する言語コードの翻訳済アプリケーションを検索します。

- 部分一致を検索します。つまり、言語およびロケールが存在するかどうかを確認します。たとえば、ユーザーの言語設定がen-usで、en-usの翻訳済バージョンが存在しない場合は、言語コードがenの翻訳済アプリケーションを検索します。

- プライマリのアプリケーションを使用します。

たとえば、プライマリ言語がドイツ語(de)のアプリケーションを作成し、言語コードがen-usの翻訳済バージョンを作成すると想定します。ユーザーがブラウザ言語en-usを使用してこのアプリケーションにアクセスすると、英語(en-us)バージョンのアプリケーションが実行されます。ユーザーがブラウザ言語en-gbを使用してこのアプリケーションにアクセスすると、アプリケーションがプライマリ言語(つまりドイツ語)で表示されます。この例では、enのすべてのバリエーションに対応するために、言語コードenを使用して英語に翻訳されたバージョンを作成する必要があります。

翻訳済アプリケーションのレンダリング方法

Oracle Application Expressがアプリケーションの言語を決定した後、Application Expressエンジンは、特定のページ・リクエストに対してデータベース言語を変更します。その後、適切な言語に翻訳されたアプリケーションを検索します。その言語を検出すると、その定義を使用してアプリケーションをレンダリングします。それ以外の場合は、ベース(プライマリ)のアプリケーション言語でアプリケーションをレンダリングします。

アプリケーション内に表示されるテキストは、すぐには翻訳されないことに注意してください。Oracle Application Expressは、ベース言語アプリケーション定義または代替アプリケーション定義のいずれかから動的にページ属性を収集します。

関連項目:
「テキスト文字列の動的翻訳について」および「LOVをサポートするデータの翻訳」

翻訳可能なコンポーネントについて

Application Builderでアプリケーションを作成する際、フィールド・ラベル、リージョン・ヘッダー、ページ・ヘッダー・テキストなど、多数の宣言的な属性を定義します。このセクションで説明するステップを使用して、アプリケーション内のすべてのアプリケーション定義属性を翻訳可能にできます。

メッセージの言語変換をサポートするショートカットについて

Application Builderには、翻訳可能なメッセージを参照できる2つのタイプのショートカットがあります。

- メッセージ:翻訳可能なメッセージを実行時に参照するには、このショートカットを使用します。ショートカット名は、対応するメッセージ名と一致させる必要があります。実行時、ショートカット名は、現在の言語に変換可能なメッセージのテキストに拡張されます。

- JavaScriptにより一重引用符がエスケープされたメッセージ:JavaScriptリテラル文字列内部のショートカットを参照し、実行時に翻訳可能なメッセージを参照するには、このショートカットを使用します。このショートカットは、テキスト文字列を定義します。ショートカットが参照されると、JavaScriptに必要な一重引用符がエスケープされます。

関連項目:
「ショートカットの使用」

メッセージについて

アプリケーションにPL/SQLリージョンまたはPL/SQLプロセスが含まれている場合には、生成されるHTMLまたはテキストを翻訳する必要がある場合があります。また、Oracle Application Expressが翻訳されている10の言語以外の言語をアプリケーションで使用する場合、レポートで使用されているメッセージの翻訳が必要な場合もあります。

関連項目:
「メッセージの翻訳」

テキスト文字列の動的翻訳について

動的翻訳は、実行時に翻訳する必要があるデータベース・データに使用されます。たとえば、動的翻訳を使用して、データベース問合せに基づくLOVを翻訳する場合があります。動的翻訳は、翻訳元の言語文字列、言語コードおよび翻訳先の文字列で構成されています。また、APEX_LANG.LANG APIを使用して、動的翻訳をプログラム的に取得できます。

関連項目:
「LOVをサポートするデータの翻訳」

リージョン・タイトルの翻訳について

デフォルトでは、ページ・リージョン・タイトルは、生成された翻訳ファイルに含まれます。ただし、リージョン・タイトルは、翻訳不可と指定できます。

リージョン・タイトルを翻訳不可と指定するには、次のステップを実行します。

1. 「ページ定義」にナビゲートします。「「ページ定義」について」を参照してください。

2. 「ページ定義」で、リージョン・タイトルをクリックします。
リージョンの編集ページが表示されます。

3. 「タイトルを翻訳から除外」チェック・ボックスを選択します。

翻訳テンプレートについて

デフォルトでは、テンプレートは翻訳可能ではないため、生成された翻訳ファイルには含まれません。通常、テンプレートには翻訳可能なテキストを含めません。ただし、テンプレートを翻訳可能として指定する必要がある場合は、ページ・テンプレートの編集ページで、「翻訳可能」チェック・ボックスを選択します。

テンプレートを翻訳可能として指定するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「アプリケーション」ホームページで、「共有コンポーネント」をクリックします。

4. 「ユーザー・インタフェース」で、「テンプレート」を選択します。
テンプレート・ページが表示されます。

5. 編集するテンプレートを検索して、テンプレート名を選択します。

6. 「名前」の下で「翻訳可能」を選択します。

静的置換文字列を使用して翻訳可能なテキストを定義することで、翻訳可能なテキストをアプリケーション・レベルで含めることができます。アプリケーション・レベル属性は翻訳されるため、静的置換文字列として定義された任意のテキストは、生成された翻訳ファイルに含まれます。

関連項目:
「テンプレートのカスタマイズ」および「置換」

アプリケーションへのプライマリ言語の指定

グローバリゼーション属性は、Application Expressエンジンによるアプリケーションのプライマリ言語の決定方法を指定します。

グローバリゼーション属性を編集するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「グローバリゼーション」で、「グローバリゼーション属性」を選択します。

5. 「アプリケーションのプライマリ言語」から、アプリケーションが開発されている言語を選択します。

6. 「アプリケーション言語の派生元」から、Application Expressエンジンによるアプリケーション言語の決定(派生)方法を指定します。表18-1に、使用可能なオプションを示します。

表18-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. 「変更の適用」をクリックします。

関連項目:
「アプリケーション定義の編集」、「セキュリティ属性の構成」および「サポートされるグローバリゼーション・コードについて」

アイテムの書式マスクの使用

Application Expressエンジンは、レンダリングされた各ページにグローバリゼーション設定を適用します。デフォルトの動作は、数字や日付などの特定のアイテムの表示に影響する可能性があります。

たとえば、ユーザーのブラウザの言語設定に基づいて、アプリケーション言語を決定するとします。Application Expressエンジンが、ユーザーのブラウザの言語設定をフランス語と決定した場合、日付および数字は、フランス語の標準に合わせた書式で表示されます。書式マスクを適用することによって、このデフォルトの動作をオーバーライドし、アイテムの表示方法を明示的に制御できます。「表示形式」リストから選択して、書式マスクを適用します。

- アイテム作成時

- アイテム属性を編集してアイテムを作成した後

次のステップでは、データベース列のソース・タイプを持つアイテムの属性の編集方法を説明します。

アイテム属性を編集するには、次のステップを実行します。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. ページを選択します。
「ページ定義」が表示されます。

4. アイテムを選択します。
「ページ・アイテムの編集」ページが表示されます。

5. 「名前」の下で、「表示形式」リストから選択します。

6. 「ソース」の下で書式マスクを選択または入力します。

マルチバイト言語用のアプリケーション翻訳

アプリケーションを複数の言語(中国語と日本語など)で同時に実行する必要がある場合、すべての言語をサポートするキャラクタ・セットを使用してデータベースを構成することを検討してください。同じキャラクタ・セットは、mod_plsqlの対応するデータベース・アクセス記述子(DAD)で構成する必要があります。UTF8およびAL32UTF8は、ほぼすべての言語をサポートするために使用できるキャラクタ・セットです。

翻訳プロセスの理解

アプリケーション・ビルダーで開発したアプリケーションを翻訳するには、プライマリおよびターゲット言語をマップし、テキストを翻訳ファイルにシードおよびエクスポートし、テキストを翻訳し、翻訳ファイルを適用し、翻訳済アプリケーションを公開する必要があります。

内容は次のとおりです。

- ステップ1: ターゲット言語のマップ

- ステップ2: 翻訳ファイルへのシードおよびダウンロード

- ステップ3: XLIFFファイルの翻訳

- ステップ4: 翻訳済XLIFFドキュメントのアップロードおよび適用

- ステップ5: アプリケーションのパブリッシュ

- 翻訳の手動編集

関連項目:
「メッセージの翻訳」および「LOVをサポートするデータの翻訳」

ステップ1: ターゲット言語のマップ

アプリケーション翻訳の最初のステップは、プライマリおよびターゲットのアプリケーション言語をマップすることです。プライマリ・アプリケーションは、翻訳されるアプリケーションです。ターゲット・アプリケーションは、翻訳結果のアプリケーションです。

プライマリおよびターゲットのアプリケーション言語をマップするには、次のステップを実行します。

1. アプリケーションの翻訳ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「グローバリゼーション」の下で「アプリケーションの翻訳」をクリックします。
翻訳ページが表示されます。

2. 「翻訳されたアプリケーションにプライマリ言語アプリケーションをマップ」をクリックします。
マッピング・ページが表示されます。

3. 「作成」をクリックします。

4. 翻訳アプリケーション・マッピング・ページで、次のステップを実行します。

- 翻訳アプリケーション: アプリケーションを識別する一意の整数値を入力します。アプリケーションIDは、Oracle Application Expressのインスタンスで一意である必要があります。

- 言語: 翻訳する言語を選択します。

- イメージ・ディレクトリ: イメージが取得されるディレクトリを入力します。翻訳されるイメージ・ディレクトリからの静的ファイルを使用する場合を除き、このフィールドは空白のままにします。これはデフォルトで、最も一般的なオプションです。
この属性は、翻訳されたイメージの仮想パスを指定します。たとえば、プライマリ言語アプリケーションのイメージ接頭辞が/i/の場合、ドイツ語には/i/de/、スペイン語には/i/es/のように、その他の言語の仮想ディレクトリを追加で定義できます。

5. 「作成」をクリックします。

関連項目:
「ステップ2: 翻訳ファイルへのシードおよびダウンロード」

ステップ2: 翻訳ファイルへのシードおよびダウンロード

2番目のステップでは、翻訳表をシードし、翻訳テキストを翻訳ファイルにエクスポートします。

内容は次のとおりです。

- 翻訳可能なテキストのシード

- XLIFFファイルのダウンロード

翻訳可能なテキストのシード

翻訳のシードにより、すべての翻訳可能なテキストが翻訳テキスト・リポジトリにコピーされます。言語を指定して翻訳テキストをシードすると、翻訳用のXLIFFファイルを生成してエクスポートできます。

シード・プロセスでは、プライマリ言語アプリケーションと翻訳テキスト・リポジトリの同期がとられます。プライマリ言語アプリケーションを変更するたびに、シード・プロセスを実行する必要があります。

翻訳可能なテキストをシードするには、次のステップを実行します。

1. アプリケーションの翻訳ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「グローバリゼーション」の下で「アプリケーションの翻訳」をクリックします。
翻訳ページが表示されます。

2. 「翻訳リポジトリに翻訳可能なテキストをシード」を選択します。

3. 適切なターゲット・アプリケーションを選択します。

4. 「シード」をクリックします。
完了すると、次のメッセージが表示されます。

Successfully seeded translatable text.

XLIFFファイルのダウンロード

翻訳のマッピングが確立されると、アプリケーション内の翻訳可能なテキストが翻訳リポジトリにシードされます。このリポジトリを翻訳用のXLIFF(XML Localization Interchange File Format)ファイルにエクスポートできます。

XLIFFのエクスポート・ページは、2つのセクションに分かれています。アプリケーション全体の翻訳可能なテキスト(すべてのページ、LOV、メッセージなど)をエクスポートするには、上のセクションを使用します。特定のページの翻訳可能なテキストをエクスポートするには、下のセクションを使用します。

注意:
XLIFF(XML Localization Interchange File Format)は、ローカリゼーション・データを変換するためのXMLベースのフォーマットです。XLIFFについて、またはXLIFF仕様を確認するには、次のURLを参照してください。

http://www.xliff.org

アプリケーションのXLIFFファイルのダウンロード

完全なアプリケーションのXLIFFファイルをダウンロードするには、次のステップを実行します。

1. 翻訳可能なテキストをシードします。「翻訳可能なテキストのシード」を参照してください。

2. 翻訳ページで、「翻訳リポジトリからXLIFF翻訳ファイルをダウンロード」をクリックします。

3. 「完全なアプリケーション用のXLIFFファイルのダウンロード」で、次のステップを実行します。

1. 言語: XLIFFファイルでダウンロードする言語を選択します。

2. XLIFFターゲット要素を含める: XLIFFターゲット要素を含めるかどうかを指定します。含めるには、「XLIFFターゲット要素を含める」を選択します。

3. エクスポート: アプリケーションのすべての翻訳可能な要素をエクスポートするか、新規または更新された要素のみをエクスポートするかを選択します。

4. 「XLIFFのエクスポート」をクリックします。

4. 画面に表示されるステップに従います。

アプリケーション・ページのXLIFFファイルのダウンロード

特定ページのXLIFFファイルをダウンロードするには、次のステップを実行します。

1. 「翻訳可能なテキストのシード」のとおり、翻訳可能なテキストをシードします。

2. 翻訳ページで、「翻訳リポジトリからXLIFF翻訳ファイルをダウンロード」をクリックします。

3. 「アプリケーション・ページ用のXLIFFファイルのダウンロード」で、次のステップを実行します。

1. 言語: XLIFFファイルでダウンロードする言語を選択します。

2. ページ: ページを選択します。

3. XLIFFターゲット要素を含める: XLIFFターゲット要素を含めるかどうかを指定します。含めるには、「XLIFFターゲット要素を含める」を選択します。

4. エクスポート: ページのすべての翻訳可能な要素をエクスポートするか、新規または更新された要素のみをエクスポートするかを選択します。

5. 「XLIFFのエクスポート」をクリックします。

4. 画面に表示されるステップに従います。

含まれるXLIFFターゲット要素について

Oracle Application ExpressがXLIFFドキュメントを生成すると、各ドキュメントには複数の翻訳単位が含まれます。各翻訳単位は、ソース要素とターゲット要素で構成されます。XLIFFドキュメントは、各翻訳単位ごとのソースおよびターゲットの両方の要素で生成できます。生成するファイルにソース要素のみを含めることもできます。更新された翻訳は、翻訳単位のターゲット要素から適用されます。

ステップ3: XLIFFファイルの翻訳

翻訳可能なファイルをXLIFFフォーマットにエクスポートすると、これを適切な言語に翻訳できます。XLIFFは翻訳のためのオープン標準のXMLファイルであるため、ほとんどの翻訳ベンダーでサポートされています。Oracle Application Expressは、UTF-8キャラクタ・セットでエンコードされたXLIFFファイルのみをサポートしています。つまり、Oracle Application Expressでは、翻訳用のXLIFFファイルはUTF-8でエクスポートされ、翻訳済XLIFFファイルも同じキャラクタ・セットであることを前提としています。

翻訳は時間のかかるタスクです。Oracle Application Expressでは、アプリケーション開発と翻訳を並行して行えるように、増分的な翻訳をサポートしています。XLIFFファイルの一部のみが翻訳されている場合でも、ファイルを翻訳してOracle Application Expressにアップロードできます。対応する翻訳済アプリケーションに翻訳がない文字列の場合、Oracle Application Expressは、プライマリ言語の対応する文字列を使用します。

関連項目:
XLIFFの詳細またはXLIFF仕様を確認するには、次のURLを参照してください。

http://www.xliff.org

ステップ4: 翻訳済XLIFFドキュメントのアップロードおよび適用

XLIFFドキュメントの翻訳後に、ドキュメントをアップロードして適用します。

内容は次のとおりです。

- 翻訳済XLIFFドキュメントのアップロード

- アップロードしたXLIFFドキュメントの適用

- アップロードしたXLIFFドキュメントの削除

翻訳済XLIFFドキュメントのアップロード

翻訳済XLIFFドキュメントをアップロードするには、次のステップを実行します。

1. アプリケーションの翻訳ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「グローバリゼーション」の下で「アプリケーションの翻訳」をクリックします。
翻訳ページが表示されます。

2. 翻訳リポジトリへのXLIFF翻訳ファイルのアップロードおよび適用をクリックします。
XLIFF翻訳ファイル・ページが表示されます。

3. 「ファイルのアップロード」をクリックします。

4. XLIFFのアップロード・ページで、次のステップを実行します。

1. 説明を入力します。

2. アップロードするファイルを選択します。

3. 「アップロード」をクリックします。

アップロードされたドキュメントが、XLIFF翻訳ファイル・ページに表示されます。

アップロードしたXLIFFドキュメントの適用

XLIFFドキュメントをアップロードした後、そのXLIFFドキュメントを適用して翻訳済アプリケーションを公開します。XLIFFドキュメントを適用すると、Application Expressエンジンはファイルを解析して、翻訳表を新しい翻訳可能なテキストで更新します。

アプリケーションを公開すると、ベース言語のアプリケーションのコピーが作成され、翻訳表の翻訳されたテキスト文字列が置換されます。その後、この公開されたアプリケーションを使用して、代替言語でアプリケーションをレンダリングできます。

アプリケーションを代替言語で実行するには、代替言語バージョンで表示するようにグローバリゼーション設定を行ってアプリケーションを実行する必要があります。たとえば、言語がブラウザ言語に従う場合は、ブラウザ言語を翻訳済アプリケーションと同じ言語に設定する必要があります。

関連項目:
「アプリケーションへのプライマリ言語の指定」

翻訳済XLIFFドキュメントを適用するには、次のステップを実行します。

1. アプリケーションの翻訳ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「グローバリゼーション」の下で「アプリケーションの翻訳」をクリックします。
アプリケーションの翻訳ページが表示されます。

2. 翻訳リポジトリへのXLIFF翻訳ファイルのアップロードおよび適用をクリックします。
XLIFF翻訳ファイル・ページが表示されます。

3. XLIFFドキュメントを適用するには、次のステップを実行します。

1. 適用するXLIFFファイルを選択します。

2. 「翻訳に適用」から、翻訳のマッピングを選択します。

3. 「チェックした項目の適用」をクリックします。

XLIFFファイルが解析され、コンテンツが翻訳リポジトリに適用されます。このプロセスが完了すると、各翻訳のアプリケーションをパブリッシュする必要があります。詳細は、「ステップ5: アプリケーションのパブリッシュ」を参照してください。

アップロードしたXLIFFドキュメントの削除

アップロードしたXLIFFドキュメントを削除するには、次のステップを実行します。

1. アプリケーションの翻訳ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「グローバリゼーション」の下で「アプリケーションの翻訳」をクリックします。
翻訳ページが表示されます。

2. 翻訳リポジトリへのXLIFF翻訳ファイルのアップロードおよび適用をクリックします。
XLIFF翻訳ファイル・ページが表示されます。

3. XLIFFファイル・リポジトリで、ファイル名列の左側にあるチェック・ボックスを選択します。

4. 「チェックした項目の削除」をクリックします。

関連項目:
「アプリケーションへのプライマリ言語の指定」

ステップ5: アプリケーションのパブリッシュ

アプリケーションを公開すると、ベース言語のアプリケーションのコピーが作成され、翻訳表の翻訳されたテキスト文字列が置換されます。その後、この公開されたアプリケーションを使用して、代替言語でアプリケーションをレンダリングできます。

アプリケーションを代替言語で実行するには、代替言語バージョンで表示するようにグローバリゼーション設定を行ってアプリケーションを実行する必要があります。たとえば、言語がブラウザ言語に従う場合は、ブラウザ言語を翻訳済アプリケーションと同じ言語に設定する必要があります。

関連項目:
「アプリケーションへのプライマリ言語の指定」

アプリケーションを公開するには、次の手順を実行します。

1. アプリケーションの翻訳ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「グローバリゼーション」の下で「アプリケーションの翻訳」をクリックします。
アプリケーションの翻訳ページが表示されます。

2. 「翻訳済アプリケーションのパブリッシュ」をクリックします。
XLIFF翻訳ファイル・ページが表示されます。

3. パブリッシュするアイテムを選択し、「パブリッシュ」をクリックします。

アプリケーションを公開した後、翻訳済アプリケーションの有無を確認する必要があります。翻訳済アプリケーションは、アプリケーション・ビルダーのホームページの「選択可能なアプリケーション」リストには表示されません。かわりに、そのページの左側のアプリケーション・ナビゲート・リストを使用します。

翻訳済アプリケーションをアプリケーション・ビルダーに表示するには、アプリケーションのグローバリゼーション属性を正しく設定する必要があります。

翻訳の手動編集

ターゲット言語をマップし、翻訳可能なテキストをシードした後は、手動で翻訳を編集できます。

手動で翻訳を編集するには、次のステップを実行します。

1. ターゲット言語をマップします。「ステップ1: ターゲット言語のマップ」を参照してください。

2. 翻訳可能なテキストをシードします。「翻訳可能なテキストのシード」を参照してください。

3. 翻訳可能なテキストにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「グローバリゼーション」の下で「アプリケーションの翻訳」をクリックします。

4. 「翻訳ユーティリティ」リストから、「翻訳リポジトリの手動編集」をクリックします。
翻訳可能なテキスト・ページが表示されます。ページ上部の「ナビゲーション・バー」を使用してレポート表示を変更します。使用可能なオプションは次のとおりです。

- 言語のマッピング: 言語のマッピングを選択し、「実行」をクリックします。

- ページ: ページ番号を入力し、「実行」をクリックします。

- 翻訳: 大/小文字を区別しない問合せを入力し、「実行」をクリックします。

- 表示: 表示する行数を選択し、「実行」をクリックします。

5. 翻訳可能なテキストを編集するには、「編集」アイコンをクリックします。
「翻訳可能なテキスト」フィールドが表示されます。

6. 適切なテキストを編集し、「変更の適用」をクリックします。

メッセージの翻訳

アプリケーションが次に当てはまる場合、メッセージを翻訳する必要があることがあります。

- PL/SQLリージョンまたはPL/SQLプロセスが含まれる場合、あるいはPL/SQLパッケージ、プロシージャ、またはファンクションをコールする場合。この場合、生成されたHTMLを翻訳する必要があることがあります。

- Oracle Application Expressが翻訳されている10言語以外の言語を使用する場合。この場合、レポートに使用されているメッセージを翻訳する必要があることがあります。

内容は次のとおりです。

- PL/SQLプロシージャで使用されるメッセージの翻訳

- Oracle Application Expressにより内部使用されるメッセージの翻訳

PL/SQLプロシージャで使用されるメッセージの翻訳

アプリケーションにPL/SQLリージョンまたはPL/SQLプロセスが含まれる場合、あるいはアプリケーションがPL/SQLパッケージ、プロシージャ、またはファンクションをコールする場合は、生成されるHTMLを翻訳する必要がある場合があります。最初に、翻訳可能なメッセージ・ページで、各メッセージを定義します。次に、APEX_LANG.MESSAGE APIを使用して、PL/SQLストアド・プロシージャ、ファンクション、トリガーまたはパッケージ化されたプロシージャおよびファンクションのメッセージを翻訳します。

翻訳可能なメッセージ・ページで、翻訳可能なメッセージを作成します。

新しい翻訳メッセージを定義するには、次のステップを実行します。

1. アプリケーションの翻訳ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「グローバリゼーション」の下で「テキスト・メッセージ」をクリックします。

2. メッセージの翻訳ページで、「テキスト・メッセージの作成」をクリックします。

3. テキスト・メッセージを指定ページで、次のステップを実行します。

1. 名前: メッセージを識別するための名前を入力します。

2. 言語: メッセージが使用される言語を選択します。

3. テキスト: テキスト・メッセージがコールされたときに戻されるテキストを入力します。
たとえば、メッセージGREETING_MSGを次のように英語で定義できます。

Good morning %0

また、メッセージGREETING_MSGを次のようにドイツ語で定義できます。

Guten Tag %0

4. 「テキスト・メッセージの作成」をクリックします。

APEX_LANG.MESSAGE APIについて

PL/SQLストアド・プロシージャ、ファンクション、トリガー、パッケージ化されたプロシージャおよびファンクションから生成されたテキスト文字列(メッセージ)を翻訳するには、APEX_LANG.MESSAGE APIを使用します。

構文

APEX_LANG.MESSAGE (
p_name    IN    VARCHAR2 DEFAULT NULL,
p0        IN    VARCHAR2 DEFAULT NULL,
p1        IN    VARCHAR2 DEFAULT NULL,
p2        IN    VARCHAR2 DEFAULT NULL,
...
p9        IN    VARCHAR2 DEFAULT NULL,
p_lang    IN    VARCHAR2 DEFAULT NULL)
RETURN VARCHAR2;

パラメータ

表 18-2に、 APEX_LANG.MESSAGE APIで使用可能なパラメータを示します。

表18-2 APEX_LANG.MESSAGEのパラメータ

パラメータ

説明

p_name

Oracle Application Expressで定義されたメッセージの名前。

p0

...

p9

動的置換値。p0は、メッセージの0%に対応します。p1は、メッセージの1%に対応します。p2は、メッセージの2%に対応します(以降同様)。

p_lang

取得されるメッセージの言語コード。指定しない場合、Oracle Application Expressは、アプリケーション言語の派生元属性で定義されているとおり、ユーザーの現行の言語を使用します。

関連項目: 「アプリケーションへのプライマリ言語の指定」

例

次の例では、アプリケーションのGREETING_MSGというメッセージを、英語でGood morning%0、ドイツ語でGuten Tag%1と定義したと仮定しています。この例は、PL/SQLからこのメッセージを呼び出す方法を示しています。

BEGIN
--
-- Print the greeting
--
APEX_LANG.MESSAGE('GREETING_MSG', V('APP_USER'));
END;

p_lang属性の定義は、Application Expressエンジンがアプリケーションのプライマリ言語を導出する方法によって異なります。たとえば、アプリケーションをドイツ語で実行中で、前回のコールがAPEX_LANG.MESSAGE APIに対して行われた場合、Application Expressエンジンは、最初にLANG_CODEがdeであるGREETING_MSGというメッセージを検索します。見つからない場合は、アプリケーションのプライマリ言語属性に戻ります。それでも見つからない場合、Application Expressエンジンは、言語コードがen-usであるこの名前のメッセージを検索します。

関連項目:
アプリケーションのプライマリ言語属性については、「アプリケーションへのプライマリ言語の指定」およびOracle Application Express APIリファレンスの「APEX_LANG」を参照してください。

Oracle Application Expressにより内部使用されるメッセージの翻訳

Oracle Application Expressはドイツ語、スペイン語、フランス語、イタリア語、日本語、韓国語、ポルトガル語(ブラジル)、簡体字中国語、および繁体字中国語に翻訳されています。これらの翻訳された10言語以外の言語をアプリケーションで使用する場合は、Application Expressレポート・エンジンによって表示されるメッセージを翻訳する必要があります。

たとえば、ロシア語のアプリケーションを開発してロシア語のレポート・メッセージ(ページ区切りなど)を使用する場合は、レポートに表示されるメッセージで使用される文字列を翻訳する必要があります。

メッセージを翻訳するには、次のステップを実行します。

1. アプリケーションの翻訳ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「グローバリゼーション」の下で「テキスト・メッセージ」をクリックします。

2. メッセージの翻訳ページで、「テキスト・メッセージの作成」をクリックします。

3. 「テキスト・メッセージを指定」で次を指定します。

1. 名前: 翻訳する必要のある各メッセージの名前を入力します。表18-3を参照してください。

2. 言語: メッセージが使用される言語を選択します。

3. テキスト: テキスト・メッセージがコールされたときに戻されるテキストを入力します。英語のテキスト・メッセージに定位置の置換値(%0、%1など)が含まれている場合、ユーザー定義のメッセージにも同じ名前と数字の定位置の置換値を含めてください。

4. 「テキスト・メッセージの作成」をクリックします。

表 18-3に、翻訳が必要な内部メッセージを示します。

表 18-3 翻訳が必要な内部メッセージ

メッセージ名

英語のテキスト

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_VALUE_GREATER_MAX_DATE

#LABEL# is greater than specified maximum date %0.

APEX.DATEPICKER_VALUE_INVALID

#LABEL# does not match format %0.

APEX.DATEPICKER_VALUE_LESS_MIN_DATE

#LABEL# is less than specified minimum date %0.

APEX.DATEPICKER_VALUE_NOT_BETWEEN_MIN_MAX

#LABEL# is not between the valid range of %0 and %1.

APEX.DATEPICKER_VALUE_NOT_IN_YEAR_RANGE

#LABEL# is not within valid year range of %0 and %1.

APEX.FILE_BROWSE.DOWNLOAD_LINK_TEXT

Download.

APEX.GO_TO_ERROR

Go to error.

APEX.ITEM_TYPE.SLIDER.VALUE_NOT_BETWEEN_MIN_MAX

#LABEL# is not between the valid range of %0 and %1.

APEX.ITEM_TYPE.SLIDER.VALUE_NOT_MULTIPLE_OF_STEP

#LABEL# is not a multiple of %0.

APEX.ITEM_TYPE.YES_NO.INVALID_VALUE

#LABEL# must match to the values %0 and %1.

APEX.ITEM_TYPE.YES_NO.NO_LABEL

No

APEX.ITEM_TYPE.YES_NO.YES_LABEL

Yes

APEX.NUMBER_FIELD.VALUE_GREATER_MAX_VALUE

#LABEL# is greater than specified maximum %0.

APEX.NUMBER_FIELD.VALUE_INVALID

#LABEL# must be Numeric.

APEX.NUMBER_FIELD.VALUE_INVALID2

#LABEL# does not match number format %0 (For example, %1).

APEX.NUMBER_FIELD.VALUE_LESS_MIN_VALUE

#LABEL# is less than specified minimum %0.

APEX.NUMBER_FIELD.VALUE_NOT_BETWEEN_MIN_MAX

#LABEL# is not between the valid range of %0 and %1.

APEX.PAGE_ITEM_IS_REQUIRED

#LABEL# must have some value.

FLOW.SINGLE_VALIDATION_ERROR

1 error has occurred

FLOW.VALIDATION_ERROR

%0 errors have occurred

INVALID_CREDENTIALS

Invalid Login Credentials

OUT_OF_RANGE

Invalid set of rows requested, the source data of the report has been modified

PAGINATION.NEXT

Next

PAGINATION.NEXT_SET

Next Set

PAGINATION.PREVIOUS

Previous

PAGINATION.PREVIOUS_SET

Previous Set

REPORT_TOTAL

report total

RESET

reset pagination

SINCE_DAYS_AGO

%0 days ago

SINCE_DAYS_FROM_NOW

%0 days from now

SINCE_HOURS_AGO

%0 hours ago

SINCE_HOURS_FROM_NOW

%0 hours from now

SINCE_MINUTES_AGO

%0 minutes ago

SINCE_MINUTES_FROM_NOW

%0 minutes from now

SINCE_MONTHS_AGO

%0 months ago

SINCE_MONTHS_FROM_NOW

%0 months from now

SINCE_NOW

Now

SINCE_SECONDS_AGO

%0 seconds ago

SINCE_SECONDS_FROM_NOW

%0 seconds from now

SINCE_WEEKS_AGO

%0 weeks ago

SINCE_WEEKS_FROM_NOW

%0 weeks from now

SINCE_YEARS_AGO

%0 years ago

SINCE_YEARS_FROM_NOW

%0 years from now

TOTAL

Total

WWV_FLOW_UTILITIES.CAL

Calendar

WWV_FLOW_UTILITIES.CLOSE

Close

WWV_FLOW_UTILITIES.OK

Ok

WWV_RENDER_REPORT3.FOUND_BUT_NOT_DISPLAYED

Minimum row requested: %0, rows found but not displayed: %1

WWV_RENDER_REPORT3.SORT_BY_THIS_COLUMN

Sort by this column

WWV_RENDER_REPORT3.UNSAVED_DATA

This form contains unsaved changes.Press Ok to proceed without saving your changes.

WWV_RENDER_REPORT3.X_Y_OF_MORE_THAN_Z

row(s) %0 - %1 of more than %2

WWV_RENDER_REPORT3.X_Y_OF_Z

row(s)%0 - %1 of %2

WWV_RENDER_REPORT3.X_Y_OF_Z_2

%0 - %1 of %2

表 18-4に、翻訳が必要な内部メッセージを示します。

表 18-4 翻訳が必要な対話モード・レポート・メッセージ

メッセージ名

英語のテキスト

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_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

4150_COLUMN_NUMBER

Column %0

APEXIR_3D

3D

APEXIR_ACTIONS

Actions

APEXIR_ACTIONS_MENU

Actions Menu

APEXIR_ADD

Add

APEXIR_ADD_SUBSCRIPTION

Add Subscription

APEXIR_AGGREGATE

Aggregate

APEXIR_AGGREGATE_DESCRIPTION

Aggregates are displayed after each control break and at the end of the report.

APEXIR_AGGREGATION

Aggregation

APEXIR_AGG_AVG

Average

APEXIR_AGG_COUNT

Count

APEXIR_AGG_MAX

Maximum

APEXIR_AGG_MEDIAN

Median

APEXIR_AGG_MIN

Minimum

APEXIR_AGG_MODE

Mode

APEXIR_AGG_SUM

Sum

APEXIR_ALL

All

APEXIR_ALL_COLUMNS

All Columns

APEXIR_ALTERNATIVE

Alternative

APEXIR_ALTERNATIVE_DEFAULT_NAME

Alternative Default: %0

APEXIR_AND

and

APEXIR_APPLY

Apply

APEXIR_ASCENDING

Ascending

APEXIR_AS_OF

As of %0

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_TYPE

Chart Type

APEXIR_CHOOSE_DOWNLOAD_FORMAT

Choose report download format

APEXIR_CLEAR

clear

APEXIR_COLUMN

Column

APEXIR_COLUMNS

Columns

APEXIR_COLUMN_HEADING

Column Heading

APEXIR_COLUMN_HEADING_MENU

Column Heading Menu

APEXIR_COLUMN_INFO

Column Information

APEXIR_COMPARISON_CONTAINS

contains

APEXIR_COMPARISON_DOESNOT_CONTAIN

does not contain

APEXIR_COMPARISON_IN

in

APEXIR_COMPARISON_ISNOT_IN_LAST

is not in the last

APEXIR_COMPARISON_ISNOT_IN_NEXT

is not in the next

APEXIR_COMPARISON_IS_IN_LAST

is in the last

APEXIR_COMPARISON_IS_IN_NEXT

is in the next

APEXIR_COMPARISON_IS_NOT_NULL

is not null

APEXIR_COMPARISON_IS_NULL

is null

APEXIR_COMPARISON_LIKE

like

APEXIR_COMPARISON_NOT_IN

not in

APEXIR_COMPARISON_NOT_LIKE

not like

APEXIR_COMPARISON_REGEXP_LIKE

matches regular expression

APEXIR_COMPUTATION

Computation

APEXIR_COMPUTATION_FOOTER

Create a computation using column aliases.

APEXIR_COMPUTATION_FOOTER_E1

(B+C)*100

APEXIR_COMPUTATION_FOOTER_E2

INITCAP(B)||', '||INITCAP(C)

APEXIR_COMPUTATION_FOOTER_E3

CASE WHEN A = 10 THEN B + C ELSE B END

APEXIR_COMPUTE

Compute

APEXIR_CONTROL_BREAK

Control Break

APEXIR_CONTROL_BREAKS

Control Breaks

APEXIR_COUNT_DISTINCT

Count Distinct

APEXIR_COUNT_DISTINCT_X

Count Distinct

APEXIR_COUNT_X

Count %0

APEXIR_DAILY

Daily

APEXIR_DATA_AS_OF

Report data as of %0 minutes ago.

APEXIR_DATE

Date

APEXIR_DAY

Day

APEXIR_DEFAULT

Default

APEXIR_DEFAULT_REPORT_TYPE

Default Report Type

APEXIR_DELETE

Delete

APEXIR_DELETE_CHECKED

Delete Checked

APEXIR_DELETE_CONFIRM

Would you like to delete these report settings?

APEXIR_DELETE_CONFIRM_JS_DIALOG

Would you like to perform this delete action?

APEXIR_DELETE_REPORT

Delete Report

APEXIR_DESCENDING

Descending

APEXIR_DESCRIPTION

Description

APEXIR_DETAIL_VIEW

Single Row View

APEXIR_DIRECTION

Direction

APEXIR_DISABLE

Disable

APEXIR_DISABLED

Disabled

APEXIR_DISPLAY

Display

APEXIR_DISPLAYED

Displayed

APEXIR_DISPLAYED_COLUMNS

Displayed Columns

APEXIR_DISPLAY_IN_REPORT

Display in Report

APEXIR_DOWN

Down

APEXIR_DOWNLOAD

Download

APEXIR_DO_NOT_AGGREGATE

- Do not aggregate -

APEXIR_DO_NOT_DISPLAY

Do Not Display

APEXIR_EDIT_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_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_SEE_ATTACHED

See attached.

APEXIR_EMAIL_SUBJECT

Subject

APEXIR_EMAIL_TO

To

APEXIR_ENABLE

Enable

APEXIR_ENABLED

Enabled

APEXIR_ENABLE_DISABLE_ALT

Enable/Disable

APEXIR_ERROR

Error

APEXIR_EXAMPLES

Examples

APEXIR_EXAMPLES_WITH_COLON

Examples:

APEXIR_EXCLUDE_NULL

Exclude Null Values

APEXIR_EXPAND_COLLAPSE_ALT

Expand/Collapse

APEXIR_EXPRESSION

Expression

APEXIR_FILTER

Filter

APEXIR_FILTER_EXPRESSION

Filter Expression

APEXIR_FILTERS

Filters

APEXIR_FILTER_TYPE

Filter Type

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 Mask

APEXIR_FORMAT_MASK

Format

APEXIR_FUNCTION

Function

APEXIR_FUNCTIONS_OPERATORS

Functions / Operators

APEXIR_FUNCTIONS

Functions

APEXIR_GO

Go

APEXIR_GROUP_BY

Group By

APEXIR_GROUP_BY_COLUMN

Group By Column

APEXIR_GREEN

green

APEXIR_HCOLUMN

Horizontal Column

APEXIR_HELP

Help

APEXIR_HELP_01

An Interactive Report displays a predetermined set of columns.The report may be further customized with an initial filter clause, a default sort order, control breaks, highlighting, computations, aggregates and a chart.Each Interactive Report can then be further customized and the results can be viewed, or downloaded, and the report definition can be stored for later use.

<p/>

An Interactive Report can be customized in three ways: the search bar, actions menu and column heading menu.

APEXIR_HELP_ACTIONS_MENU

The actions menu is used to customize the display of your Interactive Report.

APEXIR_HELP_AGGREGATE

Aggregates are mathematical computations performed against a column.Aggregates are displayed after each control break and at the end of the report within the column they are defined.

<p/>

<ul><li><b>Aggregation</b> allows you to select a previously defined aggregation to edit.</li>

<li><b>Function</b> is the function to be performed (e.g. SUM, MIN).</li>

<li><b>Column</b> is used to select the column to apply the mathematical function to.Only numeric columns will be displayed.</li></ul>

APEXIR_HELP_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_HIGHLIGHT

Highlighting allows you to define a filter.The rows that meet the filter are highlighted using the characteristics associated with the filter.

<p/>

<ul><li><b>Name</b> is used only for display.</li>

<li><b>Sequence</b> identifies the sequence in which the rules will be evaluated.</li>

<li><b>Enabled</b> identifies if the rule is enabled or disabled.</li>

<li><b>Highlight Type</b> identifies whether the Row or Cell should be highlighted.If Cell is selected, the column referenced in the Highlight Condition is highlighted.</li>

<li><b>Background Color</b> is the new color for the background of the highlighted area.</li>

<li><b>Text Color</b> is the new color for the text in the highlighted area.</li>

<li><b>Highlight Condition</b> defines your filter condition.</li></ul>

APEXIR_HELP_REPORT_SETTINGS

If you have customized your Interactive Report, the report settings will be displayed below the Search Bar and above the report.If you have saved customized reports, they will be shown as tabs.You can access your alternate views by clicking the tabs.Below the tabs are the report settings for the current report.This area can be collapsed and expanded using the icon on the left.

<p/>

For each report setting, you can:

<ul><li><b>Edit</b> by clicking the name.</li>

<li><b>Disable/Enable</b> by unchecking or checking the Enable/Disable check box.This is used to temporarily turn off and on the setting.</li>

<li><b>Remove</b> by click the Remove icon.This permanently removes the setting.</li></ul>

<p/>

If you have created a chart, you can toggle between the report and chart using the Report View and Chart View links shown on the right.If you are viewing the chart, you can also use the Edit Chart link to edit the chart settings.

APEXIR_HELP_RESET

Resets the report back to the default settings, removing any customizations that you have made.

APEXIR_HELP_SAVE_REPORT

Saves the customized report for future use.You provide a name and an optional description.

APEXIR_HELP_SEARCH_BAR

At the top of each report page is a search region.The region provides the following features:

<p/>

<ul><li><b>Select columns icon</b> allows you to identify which column to search (or all).</li>

<li><b>Text area</b> allows for case insensitive search criteria (no need for wild cards).</li>

<li><b>Rows</b> selects the number of records to display per page.</li>

<li><b>[Go] button</b> executes the search.</li>

<li><b>Actions Menu icon</b> displays the actions menu (discussed next).</li></ul>

<p/>

Please note that all features may not be available for each report.

APEXIR_HELP_SELECT_COLUMNS

Used to modify the columns displayed.The columns on the right are displayed.The columns on the left are hidden.You can reorder the displayed columns using the arrows on the far right.Computed columns are prefixed with <b>**</b>.

APEXIR_HELP_SORT

Used to change the column(s) to sort on and whether to sort ascending or descending.You can also specify how to handle nulls (use the default setting, always display them last or always display them first).The resulting sorting is displayed to the right of column headings in the report.

APEXIR_HIDE_COLUMN

Hide Column

APEXIR_HIGHLIGHT

Highlight

APEXIR_HIGHLIGHTS

Highlights

APEXIR_HIGHLIGHT_CONDITION

Highlight Condition

APEXIR_HIGHLIGHT_TYPE

Highlight Type

APEXIR_HIGHLIGHT_WHEN

Highlight When

APEXIR_INTERACTIVE_REPORT_HELP

Interactive Report Help

APEXIR_INVALID

Invalid

APEXIR_INVALID_COMPUTATION

Invalid computation expression. %0

APEXIR_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_LAST_DAY

Last Day

APEXIR_LAST_HOUR

Last Hour

APEXIR_LAST_MONTH

Last Month

APEXIR_LAST_WEEK

Last Week

APEXIR_LAST_X_DAYS

Last %0 Days

APEXIR_LAST_X_HOURS

Last %0 Hours

APEXIR_LAST_X_YEARS

Last %0 Years

APEXIR_LAST_YEAR

Last Year

APEXIR_LINE

Line

APEXIR_MAX_QUERY_COST

The query is estimated to exceed the maximum allowed resources.Please modify your report settings and try again.

APEXIR_MAX_X

Maximum %0

APEXIR_MAX_ROW_CNT

This query returns more then %0 rows, please filter your data to ensure complete results.

APEXIR_MEDIAN_X

Median %0

APEXIR_MIN_AGO

%0 minutes ago

APEXIR_MIN_X

Minimum %0

APEXIR_MONTH

Month

APEXIR_MONTHLY

Monthly

APEXIR_MORE_DATA

More Data

APEXIR_MOVE

Move

APEXIR_MOVE_ALL

Move All

APEXIR_NAME

Name

APEXIR_NEW_AGGREGATION

New Aggregation

APEXIR_NEW_CATEGORY

- New Category -

APEXIR_NEW_COMPUTATION

New Computation

APEXIR_NEXT

&gt;

APEXIR_NEXT_DAY

Next Day

APEXIR_NEXT_HOUR

Next Hour

APEXIR_NEXT_MONTH

Next Month

APEXIR_NEXT_WEEK

Next Week

APEXIR_NEXT_X_DAYS

Next %0 Days

APEXIR_NEXT_X_HOURS

Next %0 Hours

APEXIR_NEXT_X_YEARS

Next %0 Years

APEXIR_NEXT_YEAR

Next Year

APEXIR_NO

No

APEXIR_NO_END_DATE

- No End Date -

APEXIR_NONE

- None -

APEXIR_NO_AGGREGATION_DEFINED

No aggregation defined.

APEXIR_NO_COLUMN_INFO

No column information available.

APEXIR_NO_COMPUTATION_DEFINED

No computation defined.

APEXIR_NULLS_ALWAYS_FIRST

Nulls Always First

APEXIR_NULLS_ALWAYS_FIRST

Nulls Always First

APEXIR_NULLS_ALWAYS_LAST

Nulls Always Last

APEXIR_NULL_SORTING

Null Sorting

APEXIR_NUMERIC_FLASHBACK_TIME

Flashback time must be numeric.

APEXIR_NUMERIC_SEQUENCE

Sequence must be numeric.

APEXIR_OPERATOR

Operator

APEXIR_ORANGE

orange

APEXIR_OTHER

Other

APEXIR_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_PREVIOUS

&lt;

APEXIR_PRIMARY

Primary

APEXIR_PRIMARY_REPORT

Primary Report

APEXIR_PRIVATE

Private

APEXIR_PUBLIC

Public

APEXIR_RED

red

APEXIR_REMOVE

Remove

APEXIR_REMOVE_AGGREGATE

Remove Aggregate

APEXIR_REMOVE_ALL

Remove All

APEXIR_REMOVE_CONTROL_BREAK

Remove Control Break

APEXIR_REMOVE_FILTER

Remove Filter

APEXIR_REMOVE_FLASHBACK

Remove Flashback

APEXIR_REMOVE_HIGHLIGHT

Remove Highlight

APEXIR_RENAME_REPORT

Rename Report

APEXIR_REPORT

Report

APEXIR_REPORTS

Reports

APEXIR_REPORT_DOES_NOT_EXIST

Report does not exist.

APEXIR_REPORT_SETTINGS

Report Settings

APEXIR_REPORT_VIEW

&lt; Report View

APEXIR_RESET

Reset

APEXIR_RESET_CONFIRM

Restore report to the default settings.

APEXIR_ROW

Row

APEXIR_ROWS

Rows

APEXIR_ROW_OF

Row %0 of %1

APEXIR_ROW_ORDER

Row Order

APEXIR_ROWS_PER_PAGE

Rows Per Page

APEXIR_ROW_TEXT_CONTAINS

Row text contains

APEXIR_SAVE

Save

APEXIR_SAVED_REPORT

Saved Report

APEXIR_SAVED_REPORT_MSG

Saved Report = "%0"

APEXIR_SAVE_AS_DEFAULT

Save as Default

APEXIR_SAVE_DEFAULT_CONFIRM

The current report settings will be used as the default for all users.

APEXIR_SAVE_REPORT

Save Report

APEXIR_SEARCH

Search

APEXIR_SEARCH_BAR

Search Bar

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_SORT_COLUMN

- Select Sort Column -

APEXIR_SELECT_VALUE

Select Value

APEXIR_SEQUENCE

Sequence

APEXIR_SORT

Sort

APEXIR_SORT_ASCENDING

Sort Ascending

APEXIR_SORT_COLUMN

Sort Column

APEXIR_SORT_DESCENDING

Sort Descending

APEXIR_SPACE_AS_IN_ONE_EMPTY_STRING

space

APEXIR_STATUS

Status

APEXIR_SUBSCRIPTION_ENDING

Ending

APEXIR_SUBSCRIPTION_STARTING_FROM

Starting From

APEXIR_SUM_X

Sum %0

APEXIR_TEXT_COLOR

Text Color

APEXIR_TIME_DAYS

days

APEXIR_TIME_HOURS

hours

APEXIR_TIME_MINS

minutes

APEXIR_TIME_MONTHS

months

APEXIR_TIME_WEEKS

weeks

APEXIR_TIME_YEARS

years

APEXIR_TOP

Top

APEXIR_UNAUTHORIZED

Unauthorized

APEXIR_UNIQUE_COLUMN_HEADING

Column Heading must be unique.

APEXIR_UNIQUE_HIGHLIGHT_NAME

Highlight Name must be unique.

APEXIR_UNSUPPORTED_DATA_TYPE

unsupported data type

APEXIR_UP

Up

APEXIR_VALID_COLOR

Please enter a valid color.

APEXIR_VALID_FORMAT_MASK

Please enter a valid format mask.

APEXIR_VALUE

Value

APEXIR_VALUE_AXIS_TITLE

Axis Title for Value

APEXIR_VALUE_REQUIRED

Value Required

APEXIR_VCOLUMN

Vertical Column

APEXIR_VIEW_CHART

View Chart

APEXIR_VIEW_DETAIL

View Detail

APEXIR_VIEW_GROUP_BY

View Group By

APEXIR_VIEW_ICONS

View Icons

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

LOVをサポートするデータの翻訳

動的データを翻訳するには、動的翻訳を作成します。たとえば、データベース問合せに基づくLOVで動的翻訳を使用する場合があります。

動的翻訳は、メッセージ名ではなく特定の文字列を問い合せるという点でメッセージとは異なります。動的翻訳は、動的翻訳ページで定義します。その後、APEX_LANG.LANG APIを使用して、パラメータp_primary_text_stringで指定された動的翻訳文字列を戻します。

動的翻訳の定義

動的翻訳は、動的翻訳ページで定義します。動的翻訳は、翻訳元の言語文字列、言語コードおよび翻訳先の文字列で構成されています。

動的翻訳を定義するには、次のステップを実行します。

1. アプリケーションの翻訳ページにナビゲートします。

1. 「ワークスペース」ホームページで、「アプリケーション・ビルダー」アイコンをクリックします。

2. アプリケーションを選択します。

3. 「共有コンポーネント」をクリックします。

4. 「グローバリゼーション」の下で「アプリケーションの翻訳」をクリックします。

2. アプリケーションの翻訳ページで、「(オプション)SQLに基づくLOVをサポートするために動的に翻訳する必要があるデータを指定」を選択します。

3. 動的翻訳ページで、「作成」をクリックし、次の項目を指定します。

1. 言語: ターゲットの言語を選択します。

2. 翻訳元テキスト: 翻訳するテキストを入力します。

3. 翻訳先: 翻訳したテキストを入力します。

4. 「作成」をクリックします。

APEX_LANG.LANG API

構文

APEX_LANG.LANG (
p_primary_text_string    IN    VARCHAR2 DEFAULT NULL,
p0                       IN    VARCHAR2 DEFAULT NULL,
p1                       IN    VARCHAR2 DEFAULT NULL,
p2                       IN    VARCHAR2 DEFAULT NULL,
...
p9                       IN    VARCHAR2 DEFAULT NULL,
p_primary_language       IN    VARCHAR2 DEFAULT NULL)
RETURN VARCHAR2;

パラメータ

表 18-5に、APEX_LANG.LANG APIで使用可能なパラメータを示します。

表18-5 APEX_LANG.LANGのパラメータ

パラメータ

説明

p_primary_string

プライマリ言語のテキスト文字列。これは、「動的翻訳」の「翻訳元テキスト」の値になります。

p0

...

p9

動的置換値。p0は、翻訳文字列の0%に対応します。p1は、翻訳文字列の1%に対応します。p2は、翻訳文字列の2% に対応します(以降同様)。

p_primary_language

取得されるメッセージの言語コード。指定しない場合、Oracle Application Expressは、アプリケーション言語の派生元属性で定義されているとおり、ユーザーの現行の言語を使用します。

関連項目: 「アプリケーションへのプライマリ言語の指定」

例

すべての1次色を定義する表があるとします。それぞれの色に動的メッセージを定義し、問合せで定義された値にLANGファンクションを適用します。次に例を示します。

SELECT APEX_LANG.LANG(color)
FROM my_colors

アプリケーションをドイツ語で実行中の場合、my_colors表の「カラー」列の値がREDであったとすると、赤にドイツ語を定義すると、前述の例では、ROTが戻されます。

関連項目:
Oracle Application Express APIリファレンスの「APEX_LANG」

サポートされるグローバリゼーション・コードについて

多言語アプリケーションを構築する場合、グローバリゼーション・コードが、アプリケーションの実行方法に与える影響を理解しておくことが重要です。これらのコードは、選択したアプリケーション・レベルのグローバリゼーション属性に基づいて自動的に設定されます。

関連項目:
「アプリケーションへのプライマリ言語の指定」

NLS_LANGUAGEおよびNLS_TERRITORY によって、数字、日付および通貨のデフォルトの表示形式が決まります。

表18-6に、Oracle Application Expressのグローバリゼーション・コードを示します。

表18-6 Oracle Application Expressのグローバリゼーション・コード

言語名

言語コード

NLS_LANGUAGE

NLS_TERRITORY

アフリカーンス語

af

ENGLISH

SOUTH AFRICA

アラビア語

ar

ARABIC

UNITED ARAB EMIRATES

アラビア語(アルジェリア)

ar-dz

ARABIC

ALGERIA

アラビア語(バーレーン)

ar-bh

ARABIC

BAHRAIN

アラビア語(エジプト)

ar-eg

EGYPTIAN

EGYPT

アラビア語(イラク)

ar-iq

ARABIC

IRAQ

アラビア語(ヨルダン)

ar-jo

ARABIC

JORDAN

アラビア語(クウェート)

ar-kw

ARABIC

KUWAIT

アラビア語(レバノン)

ar-lb

ARABIC

LEBANNON

アラビア語(リビア)

ar-ly

ARABIC

LIBYA

アラビア語(モロッコ)

ar-ma

ARABIC

MOROCCO

アラビア語(オマーン)

ar-om

ARABIC

OMAN

アラビア語(カタール)

ar-qa

ARABIC

QATAR

アラビア語(サウジアラビア)

ar-sa

ARABIC

SAUDI ARABIA

アラビア語(シリア)

ar-sy

ARABIC

SYRIA

アラビア語(チュニジア)

ar-tn

ARABIC

TUNISIA

アラビア語(アラブ首長国連邦)

ar-ae

ARABIC

UNITED ARAB EMIRATES

アラビア語(イエメン)

ar-ye

ARABIC

YEMEN

アッサム語

as

ASSAMESE

INDIA

バスク語

eu

FRENCH

FRANCE

ベラルーシ語

be

RUSSIAN

RUSSIA

ベンガル語

bn

BANGLA

BANGLADESH

ブルガリア語

bg

BULGARIAN

BULGARIA

カタロニア語

ca

CATALAN

CATALONIA

中国語

zh

SIMPLIFIED CHINESE

CHINA

中国語(中国)

zh-cn

SIMPLIFIED CHINESE

CHINA

中国語(香港SAR)

zh-hk

TRADITIONAL CHINESE

HONG KONG

中国語(マカオSAR)

zh-mo

TRADITIONAL CHINESE

HONG KONG

中国語(シンガポール)

zh-sg

SIMPLIFIED CHINESE

SINGAPORE

中国語(台湾)

zh-tw

TRADITIONAL CHINESE

TAIWAN

クロアチア語

hr

CROATIAN

CROATIA

チェコ語

cs

CZECH

CZECH REPUBLIC

デンマーク語

da

DANISH

DENMARK

オランダ語(ベルギー)

nl-be

DUTCH

BELGIUM

オランダ語(オランダ)

nl

DUTCH

THE NETHERLANDS

英語

en

AMERICAN

AMERICA

英語(オーストラリア)

en-au

ENGLISH

AUSTRALIA

英語(ベリーズ)

en-bz

ENGLISH

UNITED KINGDOM

英語(カナダ)

en-ca

ENGLISH

CANADA

英語(アイルランド)

en-ie

ENGLISH

IRELAND

英語(ジャマイカ)

en-jm

ENGLISH

UNITED KINGDOM

英語(ニュージーランド)

en-nz

ENGLISH

NEW ZEALAND

英語(フィリピン)

en-ph

ENGLISH

PHILIPPINES

英語(南アフリカ)

en-za

ENGLISH

SOUTH AFRICA

英語(トリニダード)

en-tt

ENGLISH

UNITED KINGDOM

英語(イギリス)

en-gb

ENGLISH

UNITED KINGDOM

英語(米国)

en-us

AMERICAN

AMERICA

英語(ジンバブエ)

en-zw

ENGLISH

UNITED KINGDOM

エストニア語

et

ESTONIAN

ESTONIA

フェロー語

fo

ENGLISH

UNITED KINGDOM

ペルシア語

fa

ENGLISH

UNITED KINGDOM

フィンランド語

fi

FINNISH

FINLAND

フランス語(ベルギー)

fr-be

FRENCH

BELGIUM

フランス語(カナダ)

fr-ca

CANADIAN FRENCH

CANADA

フランス語(フランス)

fr

FRENCH

FRANCE

フランス語(ルクセンブルグ)

fr-lu

FRENCH

LUXEMBOURG

フランス語(モナコ)

fr-mc

FRENCH

FRANCE

フランス語(スイス)

fr-ch

FRENCH

SWITZERLAND

FYROマケドニア語

mk

MACEDONIAN

FYR MACEDONIA

ゲール語

gd

ENGLISH

UNITED KINGDOM

ガリシア語

gl

SPANISH

SPAIN

ドイツ語(オーストリー)

de-at

GERMAN

AUSTRIA

ドイツ語(ドイツ)

de

GERMAN

GERMANY

ドイツ語(リヒテンシュタイン)

de-li

GERMAN

GERMANY

ドイツ語(ルクセンブルグ)

de-lu

GERMAN

LUXEMBOURG

ドイツ語(スイス)

de-ch

GERMAN

SWITZERLAND

ギリシャ語

el

GREEK

GREECE

グジャラト語

gu

GUJARATI

INDIA

ヘブライ語

he

HEBREW

ISRAEL

ヒンディー語

hi

HINDI

INDIA

ハンガリー語

hu

HUNGARIAN

HUNGARY

アイスランド語

is

ICELANDIC

ICELAND

インドネシア語

id

INDONESIAN

INDONESIA

イタリア語(イタリア)

it

ITALIAN

ITALY

イタリア語(スイス)

it-ch

ITALIAN

SWITZERLAND

日本語

ja

JAPANESE

JAPAN

カンナダ語

kn

KANNADA

INDIA

カザフ語

kk

CYRILLIC KAZAKH

KAZAKHSTAN

コンカニ語

kok

KOREAN

KOREA

韓国語

ko

KOREAN

KOREA

キルギス語

kz

RUSSIAN

RUSSIA

ラトビア語

lv

LATVIAN

LATVIA

リトアニア語

lt

LITHUANIAN

LITHUANIANA

マラヤーラム語(マレーシア)

ms

MALAY

MALAYSIA

マラヤーラム語

ml

MALAYALAM

INDIA

マルタ語

mt

ENGLISH

UNITED KINGDOM

マラーティー語

mr

ENGLISH

INDIA

ネパール語(インド)

ne

ENGLISH

UNITED KINGDOM

ノルウェー語(ブークモール)

nb-no

NORWEGIAN

NORWAY

ノルウェー語(ブークモール)

no

NORWEGIAN

NORWAY

ノルウェー語(ニーノシュク)

nn-no

NORWEGIAN

NORWAY

オリヤー語

or

ORIYA

INDIA

ポーランド語

pl

POLISH

POLAND

ポルトガル語(ブラジル)

pt-br

BRAZILIAN PORTUGUESE

BRAZIL

ポルトガル語(ポルトガル)

pt

PORTUGUESE

PORTUGAL

パンジャブ語

pa

PUNJABI

INDIA

ルーマニア語

ro

ROMANIAN

ROMANIA

ロシア語

ru

RUSSIAN

RUSSIA

ロシア語(モルドバ)

ru-md

RUSSIAN

RUSSIA

セルビア語

sr

CYRILLIC SERBIAN

SERBIA AND MONTENEGRO

スロバキア語

sk

SLOVAK

SLOVAKIA

スロベニア語

sl

SLOVENIAN

SLOVENIA

スペイン語(アルゼンチン)

es-ar

LATIN AMERICAN SPANISH

ARGENTINA

スペイン語(ボリビア)

es-bo

LATIN AMERICAN SPANISH

ARGENTINA

スペイン語(チリ)

es-cl

LATIN AMERICAN SPANISH

CHILE

スペイン語(コロンビア)

ec-co

LATIN AMERICAN SPANISH

COLUMBIA

スペイン語(コスタリカ)

es-cr

LATIN AMERICAN SPANISH

COSTA RICA

スペイン語(ドミニカ共和国)

es-do

LATIN AMERICAN SPANISH

PUERTO RICO

スペイン語(エクアドル)

es-ec

LATIN AMERICAN SPANISH

ECUDOR

スペイン語(エルサルバドル)

es-sv

LATIN AMERICAN SPANISH

EL SALVADOR

スペイン語(グアテマラ)

es-gt

LATIN AMERICAN SPANISH

GUATEMALA

スペイン語(ホンジュラス)

es-hn

LATIN AMERICAN SPANISH

GUATEMALA

スペイン語(メキシコ)

es-mx

MEXICAN SPANISH

MEXICO

スペイン語(ニカラグア)

es-ni

LATIN AMERICAN SPANISH

NICARAGUA

スペイン語(パナマ)

es-pa

LATIN AMERICAN SPANISH

PANAMA

スペイン語(パラグアイ)

es-py

LATIN AMERICAN SPANISH

ARGENTINA

スペイン語(ペルー)

es-pe

LATIN AMERICAN SPANISH

PERU

スペイン語(プエルトリコ)

es-pr

LATIN AMERICAN SPANISH

PUERTO RICO

スペイン語(標準)

es

LATIN AMERICAN SPANISH

SPAIN

スペイン語(米国)

es-us

LATIN AMERICAN SPANISH

AMERICAN

スペイン語(ウルグアイ)

es-uy

LATIN AMERICAN SPANISH

ARGENTINA

スペイン語(ベネズエラ)

es-ve

LATIN AMERICAN SPANISH

VENEZUELA

スウェーデン語

sv

SWEDISH

SWEDEN

スウェーデン語

sv-fi

SWEDISH

FINLAND

タミル語

ta

TAMIL

INDIA

テルグ語

te

TELUGU

INDIA

タイ語

th

THAI

THAILAND

トルコ語

tr

TURKISH

TURKEY

ウクライナ語

uk

UKRAINIAN

UKRAINE

ウルドゥー語

ur

ENGLISH

UNITED KINGDOM

ウズベク語

uz

LATIN UZBEK

UZBEKISTAN

ベトナム語

vi

VIETNAMESE

VIETNAM

A アイテム・タイプについて

アイテムの作成時に、アイテム・タイプを指定します。アイテムを作成すると、ページ・アイテムの編集ページの「表示形式」リストに、アイテムのタイプが表示されます。表A-1 使用可能なアイテム・タイプに、使用できるアイテム・タイプを示します。

関連項目:
「ページ・レベル・アイテムの理解」

アイテム属性の編集によるアイテム機能の制御

ページ・アイテムの機能を制御するには、そのページ・アイテムの属性を編集します。表A-1「使用可能なアイテム・タイプ」の各アイテム・タイプには、アイテムの機能を制御する重要な属性がリストされています。属性の編集についての詳細は、「ページ・レベル・アイテムの編集」を参照してください。

使用可能なアイテム・タイプ

アイテムの作成時に、アイテム・タイプを指定します。アイテムを作成すると、ページ・アイテムの編集ページの「表示形式」リストに、アイテムのタイプが表示されます。ここでは、使用可能なアイテム・タイプおよびアイテムの動作を制御する重要なアイテム属性について説明します。

表A-1 使用可能なアイテム・タイプ

アイテム・タイプ

説明

チェック・ボックス

LOVを使用して表示します。チェック・ボックスとして表示されるアイテムには、LOVが必要です。選択したチェック・ボックスに対応する値が、コロンで区切られた文字列で戻されます。

次の例に、YESを戻す単一のチェック・ボックスを作成する方法を示します。この例では、チェック・ボックスとフィールド・ラベルの両方が表示されます。

SELECT NULL display_text, 'YES' return_value FROM DUAL;

次の例では、追加テキストClick to selectを含めます。

SELECT 'Click to select' display_text, 'YES' return_value FROM DUAL;

参照: 戻り値の分割については、Oracle Application Express APIリファレンスの「APEX_UTIL」を参照してください。

設定属性:

- 必須の値: 「はい」を選択し、ページ・アイテムが表示されている場合、Oracle Application Expressでは、ページの送信時にNOT NULL検証が自動的に実行されます。詳細は、アイテム・ヘルプを参照してください。

- チェック・ボックス列の数: LOVに定義された値を表示するために使用するレイアウト列の数を定義します。

参照: 「カスケードLOVの作成」

カラー・ピッカー

アイコン付きのテキスト・フィールドとしてレンダリングします。アイコンをクリックすると、ポップアップ・ウィンドウが表示されます。ユーザーがパレットから色を選択すると、その色のHTML値(黒の場合は#000000など)が戻されます。

注意: このタイプのアイテムを新規作成する場合は、「ポップアップLOV」を選択してから「カラー・ピッカー」を選択します。

設定属性:

- 必須の値: 「はい」を選択し、ページ・アイテムが表示されている場合、Oracle Application Expressでは、ページの送信時にNOT NULL検証が自動的に実行されます。詳細は、アイテム・ヘルプを参照してください。

日付ピッカー

横にカレンダ・アイコンが付いたテキスト・フィールドを表示します。このアイコンをクリックすると小さいカレンダが表示され、ユーザーは日付および時刻を選択できます(オプション)。

設定属性:

- 必須の値: 「はい」を選択し、ページ・アイテムが表示されている場合、Oracle Application Expressでは、ページの送信時にNOT NULL検証が自動的に実行されます。

- 書式マスク: アイテム・タイプで使用される日付書式マスクを指定します。置換構文を使用して、アプリケーションまたはページ・アイテムから動的書式マスクを参照できます。

- ハイライトされた日付: 日付ピッカーでハイライトされる必要がある日付を入力します。詳細は、アイテム・ヘルプを参照してください。

- 最小日付: 選択可能な最小日付を入力します。

- 最大日付: 選択可能な最大日付を入力します。

- 表示: 日付ピッカーをいつ表示するかを決定します。

- 他の月を表示: 現在の月の初めまたは終わりに他の月の日付(選択不可)を表示します。

- ナビゲーション・リスト: 選択リストを使用して、月または年あるいはその両方を変更します。

日付ピッカー(クラシック)

横にカレンダ・アイコンが付いたテキスト・フィールドを表示します。このアイコンをクリックすると小さいカレンダが表示され、ユーザーは日付および時刻を選択できます(オプション)。

必要な書式が「表示形式」リストに表示されない場合は、「日付ピッカー(アプリケーションの書式マスクを使用)」か「日付ピッカー(アイテムの書式マスクを使用)」を選択します。後者はページ・アイテムの編集ページの「ソース」セクションの「書式マスク」フィールドの値を使用します。

イメージの表示

別のページ・アイテムまたはBLOB列に格納されているイメージURLに格納されているイメージの表示を有効にします。イメージの格納場所を変更するには、アイテムを編集し、「基準」属性を構成します。オプションは次のとおりです。

設定属性:

- 基準: アイテムの取得元を決定します。詳細は、アイテムのヘルプを参照してください。

- 代替テキスト列: 指定した場合、戻されるテキストはイメージの代替テキストとして使用されます。

- ファイル名列: 指定した場合、戻されるファイル名は、ユーザーがイメージの保存を試行したときにブラウザの「名前を付けて保存」ダイアログで使用されます。

- BLOB最終更新列: 指定した場合、この列はブラウザのキャッシュに使用されます。ブラウザからの最後のリクエスト以降にイメージが変更されているかどうかを識別します。入力していない場合、キャッシュは実行されません。注意: この属性では大/小文字が区別されます。また、列のタイプはDATEである必要があります。

表示のみ

アイテムを表示のみテキストとして表示します。

設定属性:

- セッション・ステートの保存: ページの送信時にセッション・ステートの現在の値が保存されます。

- 基準: フィールドに表示される内容を指定します。オプションは次のとおりです。
ページ・アイテム値: ページ・アイテムの現在の値が表示されます。

LOVの値の表示: ページ・アイテムの現在の値がLOVを使用して別の表示値にマップされます。

PL/SQLコードの出力: 指定したPL/SQLコードにより、ページ・アイテムの必要な出力が生成されます。

- 改行の表示: 「はい」を選択すると、表示値の改行がHTML改行に変換されて、HTML出力で表示されます。

ファイル参照

「参照」ボタンが付いたテキスト・フィールドを表示します。ユーザーは「参照」ボタンを使用して、ローカル・ファイル・システムのファイルを検索し、アップロードすることができます。

関連項目: 「ファイルのアップロードの保護」

設定属性:

- 必須の値: 「はい」を選択し、ページ・アイテムが表示されている場合、Oracle Application Expressでは、ページの送信時にNOT NULL検証が自動的に実行されます。

- 記憶域タイプ: アップロードしたファイルの格納場所を指定します。

- MIMEタイプ列: アップロードしたファイルのMIMEタイプが格納される列の名前を指定します。

- ファイル名列: アップロードしたファイルのファイル名が格納される列の名前を指定します。

- キャラクタ・セット列: アップロードしたファイルのキャラクタ・セットが格納される列の名前を指定します。

- BLOB最終更新列: ファイルのアップロード時に現在のタイムスタンプを使用して更新する列の名前を指定します。

- ダウンロード・リンクの表示: 「はい」を選択すると、「参照」ボタンの横にダウンロード・リンクが表示されます。

- リンク・テキストのダウンロード: ダウンロード・リンクに使用されるテキストです。

- コンテンツ配置: ダウンロードしたコンテンツをブラウザ・ウィンドウ内にインラインで表示するか、オープン・ダイアログを表示するかを決定します。

非表示

非表示のページ・アイテムを作成します。

設定属性:

- 保護された値: 「はい」を選択すると、ページがポストされたときに非表示の値が操作できないようになります。

リスト・マネージャ

LOVに基づきます。このアイテムを使用すると、アイテムを選択し、リストに追加してアイテム・リストを管理できます。LOVはポップアップ表示されます。

設定属性:

- 必須の値: 「はい」を選択し、ページ・アイテムが表示されている場合、Oracle Application Expressでは、ページの送信時にNOT NULL検証が自動的に実行されます。

- フェッチ: ユーザーがポップアップLOVを開いたときにデータを表示するかどうかを指定します。

参照: 「カスケードLOVの作成」

数値フィールド

数値フィールドを表示します。入力する値の数値範囲チェックを設定するには、「最小値」属性および「最大値」属性を設定します。このアイテム・タイプでは、入力された値が数値かどうかが自動的にチェックされます。追加検証は必要ありません。

設定属性:

- 必須の値: 「はい」を選択し、ページ・アイテムが表示されている場合、Oracle Application Expressでは、ページの送信時にNOT NULL検証が自動的に実行されます。

- 書式マスク: アイテム・タイプで使用される数値書式マスクを指定します。置換構文を使用して、アプリケーションまたはページ・アイテムから動的書式マスクを参照できます。

- 最小値: 入力可能な最小値を入力します。

- 最大値: 入力可能な最大値を入力します。

- 数字の位置合せ: フィールド内の値の位置合せを選択します。

パスワード

HTMLのパスワードのフォーム要素としてレンダリングします。

設定属性:

- 必須の値: 「はい」を選択し、ページ・アイテムが表示されている場合、Oracle Application Expressでは、ページの送信時にNOT NULL検証が自動的に実行されます。詳細は、アイテム・ヘルプを参照してください。

- [Enter]を押すと送信: 「はい」を選択すると、[ENTER]を押したときにページが送信されます。これにより、ページの送信時にパスワードがデータベース表に保存されます。「いいえ」を選択すると、パスワードはデータベース表に保存されません。
セッション・ステートで、セッション中に他のページが使用するためパスワードが必要な場合にのみ、「はい」を選択します。

- 状態を保存しない: 「はい」を選択すると、フィールドに入力されたテキストが非表示になり、セッション・ステートに値が保存されません。
セキュリティ上の理由により、この属性は常に「はい」に設定する必要があります。

アプリケーションでパスワードの値を参照および取得する必要がある場合は、「セッション・ステートに暗号化された値を保存」属性を「はい」に設定します。詳細は、「セッション・ステートおよびセキュリティについて」を参照してください。

ポップアップLOV

アイコン付きのテキスト・フィールドとしてレンダリングします。アイコンをクリックすると、LOVを含むポップアップ・ウィンドウが表示されます。このLOVは、一連のリンクとして表示されます。このリストから値を選択すると、選択した値がテキスト・フィールドに配置されます。

テンプレートでポップアップLOVを制御します。アプリケーションごとに1つのみポップアップLOVを指定できます。ポップアップLOVは、単一のページに戻すには大きすぎるLOVに対して有効です。

ポップアップLOVは、異なる列別名を持つ2つの列を選択する問合せに基づく必要があります。次に例を示します。

SELECT ename name, empno id
FROM emp

いずれかの列が式の場合は、別名を使用します。次に例を示します。

SELECT ename||' '||job display_value, empno FROM emp

注意: このタイプのアイテムを新規作成する場合は、「ポップアップLOV」を選択してから「ポップアップ計算機付きテキスト・フィールド」を選択します。

設定属性:

- 必須の値: 「はい」を選択し、ページ・アイテムが表示されている場合、Oracle Application Expressでは、ページの送信時にNOT NULL検証が自動的に実行されます。詳細は、アイテム・ヘルプを参照してください。

- 入力フィールド: ポップアップLOVの入力フィールドに表示される内容とその動作方法を指定します。

- フェッチ: ユーザーがポップアップLOVを開いたときにデータを表示するかどうかを指定します。
注意: 「入力フィールド」および「フェッチ」は、「ポップアップ計算機付きテキスト・フィールド」には使用できません。

- 複数選択を許可: カンマ区切りの値を複数選択できます。

参照: 「カスケードLOVの作成」

ラジオ・グループ

LOVに基づき、HTMLラジオ・グループ・フォーム要素としてレンダリングします。

次の例では、従業員名(ename)が表示されますが、従業員番号(empno)が戻されます。

SELECT ename, empno FROM emp

設定およびその他の属性:

- 必須の値: 「はい」を選択し、ページ・アイテムが表示されている場合、Oracle Application Expressでは、ページの送信時にNOT NULL検証が自動的に実行されます。詳細は、アイテム・ヘルプを参照してください。

- ラジオ列の数: LOVに定義された値を表示するために使用する列の数を定義します。

- 値の変更時のページ・アクション: オプションは、「なし」(デフォルト)、「ページの送信」または「値のリダイレクトと設定」です。
「ページの送信」を選択すると、ラジオ・ボタンの選択時にページが送信されます。

- 検証の実行: 「値の変更時のページ・アクション」が「ページの送信」に設定されているかどうかを表示します。ページの送信時の検証の実行を制御します。この属性を「いいえ」に設定すると、検証が実行されず、関連エラー・メッセージが表示されません。この属性を「はい」に設定すると、ページの送信時にすべてのページ検証、ビルトイン検証が実行され、関連エラー・メッセージが表示されます。この属性は、検証属性「常に実行」と組み合せて使用します。詳細は、「アイテムとページ検証の作成」を参照してください。

参照: 「カスケードLOVの作成」

リッチ・テキスト・エディタ

HTMLのテキスト領域としてレンダリングします。テキスト領域として表示されるアイテムの最大長はありません。「高さ」および「幅」アイテム属性を編集して、高さと幅を制御します。

設定属性:

- 必須の値: 「はい」を選択し、ページ・アイテムが表示されている場合、Oracle Application Expressでは、ページの送信時にNOT NULL検証が自動的に実行されます。詳細は、アイテム・ヘルプを参照してください。

- エディタ: エディタを選択します。

- ツールバー: ツールバーのスタイルを選択します。

- ツールバーの拡張: リッチ・テキスト・エディタをロードするときにツールバーを展開して起動する必要があるかどうかを決定します。

- スキン: リッチ・テキスト・エディタの外観に使用されるスキンです。

選択リスト

LOVを使用して表示します。選択リストとしてアイテムを表示するには、LOVが必要です。選択リストは、HTMLフォーム要素<selectを使用してレンダリングされます。選択リストの値は、名前付きLOVまたはアイテム・レベルで定義されたLOVで決まります。表示値および戻り値にはNULLを指定できます。

次の例では、従業員名(ename)および従業員番号(empno)がemp表から戻されます。列の別名は必須ではありませんが、この例では、意味を明確にするために含まれています。

SELECT ename display_text, empno return_value FROM emp

設定およびその他の属性:

- 必須の値: 「はい」を選択し、ページ・アイテムが表示されている場合、Oracle Application Expressでは、ページの送信時にNOT NULL検証が自動的に実行されます。詳細は、アイテム・ヘルプを参照してください。

- 値の変更時のページ・アクション: オプションは、「なし」、「ページの送信」、「値のリダイレクトと設定」、「ページにリダイレクト」(選択値に基づく)または「URLにリダイレクト」(選択値に基づく)です。

- 複数選択を許可: 選択リストで複数の値を選択できるようにします。「高さ」属性を使用して、選択リストに一度に表示されるエントリの数を定義します。

- 検証の実行: 「値の変更時のページ・アクション」が「ページの送信」に設定されているかどうかを表示します。ページの送信時の検証の実行を制御します。この属性を「いいえ」に設定すると、検証が実行されず、関連エラー・メッセージが表示されません。この属性を「はい」に設定すると、ページの送信時にすべてのページ検証、ビルトイン検証が実行され、関連エラー・メッセージが表示されます。この属性は、検証属性「常に実行」と組み合せて使用します。詳細は、「アイテムとページ検証の作成」を参照してください。

参照: 「カスケードLOVの作成」

シャトル

複数のリストを含むボックスが2つある複数の選択リストとしてレンダリングします。左側にあるリストにはソースのLOVが表示されます。ユーザーはシャトル・コントロール・アイコンとボタンを使用してリスト・アイテムを選択し、左側にある「ソース」リストから右側にある「宛先」リストに移動します。各シャトルには、次の5つの制御があります。

- すべて移動: 「ソース」リストのすべてのアイテムを「宛先」リストに移動します。

- 選択項目を移動: 選択したアイテム([Ctrl]+[Shift]でアイテムを選択)のみを「宛先」リストに移動します。

- 選択対象の削除: 選択したアイテム([Ctrl]+[Shift]でアイテムを選択)のみを「ソース」リストに移動します。

- すべて削除: 「宛先」リストのすべてのアイテムを「ソース」リストに戻します。

- リフレッシュ: 「ソース」リストおよび「宛先」リストをリセットします。

右側にある「宛先」リストにはソート制御の「最上位に移動」ボタン、「上に移動」ボタン、「下に移動」ボタンおよび「最下位に移動」ボタンが含まれています。

設定属性:

- 必須の値: 「はい」を選択し、ページ・アイテムが表示されている場合、Oracle Application Expressでは、ページの送信時にNOT NULL検証が自動的に実行されます。詳細は、アイテム・ヘルプを参照してください。

- コントロールの表示: シャトルで表示されるコントロールを指定します。オプションは、「なし」、「移動のみ」、「並替えのみ」または「すべて」です。

注意: このアイテム・タイプを作成するにはLOVを定義する必要があります。「アプリケーション・レベルでのLOVの作成」、「複数選択リスト・アイテムでの操作」および「カスケードLOVの作成」を参照してください。

スライダ

jQuery Mobileアプリケーションのスライダ・アイテム・タイプをレンダリングします。このアイテム・タイプを使用すると、ユーザーはスライド・ハンドラを使用して値を設定できます。

ポップアップ計算機付きテキスト・フィールド

アイコン付きのテキスト・フィールドとしてレンダリングします。このアイコンをクリックすると、計算機付きの小さいウィンドウが表示されます。計算結果は、テキスト・フィールドに表示されます。

注意: このタイプのアイテムを新規作成する場合は、「ポップアップLOV」を選択してから「ポップアップ計算機付きテキスト・フィールド」を選択します。

設定属性:

- 必須の値: 「はい」を選択し、ページ・アイテムが表示されている場合、Oracle Application Expressでは、ページの送信時にNOT NULL検証が自動的に実行されます。詳細は、アイテム・ヘルプを参照してください。

- 複数選択を許可: カンマ区切りの値を複数選択できます。

オートコンプリートが有効なテキスト・フィールド

ユーザーがフィールドへの入力を開始すると、指定可能な値のリストが表示されます。値は、定義済のLOV SQL文に基づきます。次の例では、従業員の名前(ename)を表示して、フィールドに格納しています。

SELECT ename FROM emp
ORDER BY 1

設定属性:

- 必須の値: 「はい」を選択し、ページ・アイテムが表示されている場合、Oracle Application Expressでは、ページの送信時にNOT NULL検証が自動的に実行されます。詳細は、アイテム・ヘルプを参照してください。

- 検索: 入力値による検索の実行方法を定義します。「次を含む」および「大/小文字区別なし」を使用すると、「遅延ロード」が「はい」に設定されている場合に、列の既存の索引が使用されません。

- 遅延ロード: 「はい」を選択すると、ユーザーが文字を入力するたびにデータベースから一致する値が読み取られます。LOV SQL文によって数多くのレコードが戻される場合は、「はい」を選択します。選択しない場合、オートコンプリートの使用の有無にかかわらず、ページのレンダリング時にすべての値が含まれます。「いいえ」を選択すると、ページのレンダリング時にすべての値が一度だけ読み取られます。

- リスト内の最大値: 選択ボックスのアイテム数を指定して、多数の行が戻されることで発生するパフォーマンス上の問題を回避します。

- 自動入力: 「はい」を選択すると、値の選択中にテキスト・フィールドに入力されます。値が入力されていたり、別の値が選択されている場合は置き換えられます。

- 最初の選択: 「はい」を選択すると、ユーザーが[Tab]または[Return]を押したときに最初のオートコンプリート値が自動的に選択されます。

- 検索をハイライト: 「はい」を選択すると、一致するエントリの選択ボックスで入力した値がハイライトされます。

テキスト領域

HTMLのテキスト領域としてレンダリングします。テキスト領域として表示されるアイテムの最大長はありません。「高さ」、「幅」および「最大幅」属性を編集して、高さと幅を制御します。

設定属性:

- 必須の値: 「はい」を選択し、ページ・アイテムが表示されている場合、Oracle Application Expressでは、ページの送信時にNOT NULL検証が自動的に実行されます。
「共有コンポーネント」の「テキスト・メッセージ」でメッセージAPEX.PAGE_ITEM_IS_REQUIREDを定義すると、事前定義されたエラー・テキストをアプリケーション固有のエラー・テキストに置換できます。メッセージの表示位置は、アプリケーション・レベル設定の「デフォルトのエラー表示位置」によって定義します。

- サイズ変更可能: 「はい」を選択すると、ユーザーがマウスでテキスト領域のサイズを変更できます。

- 高さ自動調整機能: 「はい」を選択すると、データの量に応じてテキスト領域をスケーリングすることができます。このオプションでは、テキストの量によって高さが変更されます。

- 文字カウント機能: 「はい」を選択すると、フィールドに表示された文字数を表示するカウンタが含まれます。

はい/いいえ

非モバイル環境で、フリップ切替えスイッチをjQuery Mobileユーザー・インタフェースに選択リストとして表示します。

設定属性:

- 必須の値: 「はい」を選択し、ページ・アイテムが表示されている場合、Oracle Application Expressでは、ページの送信時にNOT NULL検証が自動的に実行されます。詳細は、アイテム・ヘルプを参照してください。

- 設定: オプションは「コンポーネント設定の使用」または「カスタム」です。

「設定」を「カスタム」に設定した場合は、次の属性が表示されます。

- Yes値: ユーザーが「はい」オプションを選択した場合にページ・アイテムに格納される値を指定します。

- Yesラベル: 「はい」オプションとして表示されるテキストを指定します。

- No値: ユーザーが「いいえ」オプションを選択した場合にページ・アイテムに格納される値を指定します。No値が選択されたときにNULLを格納する場合、この属性を空白のままにしておくこともできます。

- Noラベル: 「いいえ」オプションとして表示されるテキストを指定します。

B Oracle Application Expressの制限事項

この付録では、Oracle Application Express開発環境およびアプリケーション・コンポーネントに関連した制限事項を示します。

内容は次のとおりです。

- 開発環境の制限事項

- コンポーネントの制限事項

開発環境の制限事項

Oracle Application Express開発環境には、ワークスペース数や特定のワークスペース内に存在できるユーザー数に関する制限はありません。

コンポーネントの制限事項

表B-1「コンポーネントの制限事項」に、対話モード・レポート、クラシック・レポート、フォーム、表形式フォームなど、Oracle Application Expressコンポーネントに関連した制限事項を示します。

表B-1 コンポーネントの制限事項

コンポーネント

制限

対話モード・レポート

ページごとに1つの対話モード・レポート。

レポート列を使用すると、100列表示できます。追加の列を編集するには、「ツリー」ビューを使用するか、または「レポート列属性」によってページ区切りします。

列ヘッダー・フィルタごとに1,000,000行(列属性にカスタムLOVが指定されていない場合)。

追加の列を編集するには、「ツリー」ビューを使用するか、または「レポート列属性」によってページ区切りします。

関連項目: 「レポートの作成」

クラシック・レポート

レポート列を使用すると、100列表示できます。追加の列を編集するには、「ツリー」ビューを使用するか、または「レポート列属性」によってページ区切りします。

関連項目: 「レポートの作成」

フォーム

ページごとに200の入力可能アイテム。

32767バイトのテキスト領域またはリッチ・テキスト・エディタ・アイテム。

主キー用に2列(組込みDMLプロセスを使用する場合)。主キー列が3つ以上定義されているユーザーの場合、ROWIDも指定できます。

関連項目: 「フォームの作成」

表形式フォーム

ページごとに1つのウィザード生成表形式フォーム(組込みDMLを使用)。

50の編集可能な表形式フォーム列(apex_application.g_f01-apex_application.g_f50)が、apex_itemまたは組込み表形式フォーム表示タイプによって生成されます。

関連項目: 「表形式フォームの作成」

アイテム名

アイテム名は30文字以下にする必要があります。30文字を超えるアイテムは、バインド変数構文を使用して参照できません。

参照: 「バインド変数構文について」および「アイテムのネーミング規則について」

検証

検証に対して入力するテキストは、3,950文字以下にする必要があります。

関連項目: 「検証の理解」

データのロード

データをロードする際に、列の最大数は45です。

関連項目: 「データ・ロード機能によるアプリケーションの作成」

C 使用可能な条件

条件とは、リージョン、アイテム、ボタンおよびタブの表示と、プロセス、計算および検証の実行を制御するために役立つ論理単位です。条件をコントロールまたはコンポーネントに適用すると、条件が評価されます。条件が真であるかどうかによって、コントロールまたはコンポーネントが表示されるかどうか、または処理が実行されるかどうかが決まります。

コントロール(リージョン、ボタンまたはアイテム)またはコンポーネント(タブ、リストまたはナビゲーション・バー)の作成時に条件タイプを選択するか、または条件属性で選択することによって、条件を指定できます。

関連項目:
「条件付きのレンダリングおよびプロセスの理解」

アプリケーション・ビルダーの条件

表C-1「使用可能な条件」に、アプリケーション・ビルダーで使用可能な条件を示します。任意のコントロールまたはコンポーネントに対して使用可能なすべての条件のリストを表示するには、「条件タイプ」リストの右にある「ビュー」アイコンをクリックします。「タイプ」リストのすぐ下に、一般的な選択項目へのショートカットが表示されます。条件に式が必要な場合は、該当するフィールドにその式を入力します。

表C-1「使用可能な条件」

条件

説明

常時

常にtrueを戻します。主にページ・アイテムの読取り専用条件に使用されます。

クライアントのブラウザ: Microsoft Internet Explorer 5.5/6.0以上

クライアントのブラウザがMicrosoft Internet Explorer 5.5/6.0以上である場合は、trueと評価されます。

この条件をアイテムに設定すると、Microsoft Internet Explorer 5.5/6.0以上のブラウザを除くすべてのクライアントのブラウザでアイテムを非表示にします。

クライアントのブラウザ: Mozilla、Netscape 6.x/7x以上

クライアントのブラウザがMozilla、Netscape 6.x/7x以上のいずれかである場合は、trueと評価されます。

この条件をコンポーネントに設定すると、Mozilla、Netscape 6.x/7x以上のブラウザを除くすべてのクライアントのブラウザでコンポーネントが非表示になります。

クライアントのブラウザ: その他のブラウザ(または以前のバージョン)

クライアントのブラウザが、その他のブラウザ(または以前のバージョン)のいずれかである場合は、trueと評価されます。

クライアントのブラウザ: XHTML/CSS対応ブラウザ(NS 6.x/7x、Mozilla、IE 5.5/6.0以上)

クライアントのブラウザがNetscape 6.x/7x、MozillaまたはMicrosoft Internet Explorer 5.5/6.0以上のいずれかである場合は、trueと評価されます。

この条件をアイテムに設定すると、Netscape 6.x/7x、MozillaまたはMicrosoft Internet Explorer 5.5/6.0以上のブラウザを除くすべてのクライアントのブラウザでアイテムを非表示にします。

現在の言語!=式1

クライアント・ブラウザが現在実行されていない言語の設定を確認します。現在の言語が「式1」に入力した言語ではないことを確認します。

現在の言語=式1

クライアント・ブラウザが現在実行されている言語の設定を確認します。現在の言語が「式1」に入力した言語ではないことを確認します。

現在の言語が式1に含まれる

ブラウザの現在の言語が文字列に含まれているかどうかを判断します。現在の言語が「式1」に入力した文字列と一致する場合は、trueと評価されます。

たとえば、現在の言語がen-USまたはen-GBのいずれかであることを確認するには、この条件を選択して、「式1」に次の文字列を入力します。

en-us,en-gb

現在の言語が式1に含まれない

アプリケーションの現在の言語が、指定した文字列に含まれていないことを確認します。現在の言語が「式1」に入力した文字列に含まれていない場合は、trueと評価されます。

カレント・ページ!=式1

カレント・ページが「式1」に入力したページと同じでない場合は、trueと評価されます。

カレント・ページ!=送信ページ(このページはポストされたページではない)

指定したページがポストされていないかどうかを判断します。カレント・ページが「式1」に入力した値と一致しない場合は、trueと評価されます。

カレント・ページ=式1

カレント・ページが「式1」に入力したページと同じである場合は、trueと評価されます。

カレント・ページ=送信ページ(このページはポストされたページ)

指定したページがポストされたかどうかを確認します。カレント・ページが「式1」に入力した値と一致する場合は、trueと評価されます。

カレント・ページが式1(カンマで区切られたページ・リスト)に含まれる

カレント・ページが、「式1」に指定したページ・リストに含まれているかどうかを確認します。カレント・ページが1、2、3または4ページのいずれかであることを確認するには、この条件タイプを選択して、「式1」に次の文字列を入力します。

1,2,3,4

カレント・ページが「印刷用」モード

ユーザーが「印刷用」モードを選択した際に、特定のページ・コントロールまたはコンポーネントのみを表示します。カレント・ページが「印刷用」モードである場合、この条件はtrueと評価されます。「印刷用」モードを指定するには、f?p構文を使用します。

カレント・ページは「印刷用」モードではない

ユーザーが「印刷用」モードを選択した際に、ページ・コントロールまたはコンポーネントを非表示にします。「印刷用」モードを指定するには、f?p構文を使用します。

関連項目: f?p構文については、「f?p構文を使用したページのリンク」を参照してください。

カレント・ページが式1(カンマで区切られたページ・リスト)に含まれない

カレント・ページが「式1」に入力した、カンマで区切られたページ・リストに含まれていないかどうかを確認します。

存在する(SQL問合せが1行以上を戻す)

この条件は、SQL問合せとして表されます。問合せで1行以上が戻される場合、この条件はtrueと評価されます。次に例を示します。

select 1 from emp where deptno = :P101_DEPTNO

この例では、アイテムP101_DEPTNOがバインド変数として参照されます。アプリケーション・プロセスおよびSQL問合せリージョン内でバインド変数を使用すると、アイテムのセッション・ステートを参照できます。P101_DEPTNOの値に指定した部門に1人以上の従業員が存在する場合、この条件はtrueと評価されます。

関連項目: バインド変数については、「バインド変数の構文について」を参照してください。

インライン検証エラーあり

この条件タイプは、インライン検証エラーがページに表示されたときにページ・コントロールまたはページ・コンポーネントを非表示にします。

「なし」

この条件タイプは、常にfailと評価されます。これは、コントロールまたはコンポーネント(リージョン、ボタン、アイテムなど)のページ上でのレンダリングを一時的に制限したり、プロセス、計算および検証の実行を制限するために役立ちます。

インライン検証エラーなし

この条件タイプは、インライン検証エラーがページに表示されなかったときにページ・コントロールまたはページ・コンポーネントを非表示にします。

存在しない(SQL問合せが行を戻さない)

この条件は、SQL問合せとして表されます。問合せで行が戻されない場合は、trueと評価されます。

PL/SQL式

PL/SQL式は、trueまたはfalseと評価される有効なPL/SQL構文内の任意の式です。次に例を示します。

nvl(:MY_FLOW_ITEM,'NO') = 'YES'

MY_FLOW_ITEMの値がYESの場合、この条件はtrueと評価されます。それ以外の場合は、falseと評価されます。

ブールを戻すPL/SQLファンクション本体

trueまたはfalseを戻すPL/SQLファンクション本体です。次に例を示します。

BEGIN
IF :P1_DAY = 'MONDAY' THEN
RETURN TRUE;
ELSE
RETURN FALSE;
END IF;
END;

リクエスト!=式1

REQUESTは、ページの送信方法を追跡する内部属性です。デフォルトでは、ページの送信時に、ページを送信させたオブジェクトの名前に応じてアプリケーション属性REQUESTの値が設定されます。通常のボタンでは、REQUESTは、ボタンのラベルではなくボタンの名前(「取消」、「保存」など)に設定されます。リクエストは、f?p構文を使用して設定することもできます。

たとえば、ユーザーがボタンをクリックしたり、タブ・メニューを選択した場合にページが送信されます。イベントによっては、REQUESTアプリケーション属性の値を参照して、異なる操作を実行できます。

REQUESTが「式1」に入力した値と同じでない場合、この条件はtrueと評価されます。

関連項目: 「URL構文の理解」、「REQUEST」および「ボタン名とREQUESTの関係の理解」

リクエスト=式1

この条件は、「リクエスト!=式1」の反対の条件です。

REQUESTが「式1」に入力した値と同じである場合、この条件はtrueと評価されます。PL/SQLでは、次の構文を使用してアプリケーション属性を参照することもできます。

V('REQUEST')

関連項目: 「URL構文の理解」、「REQUEST」および「ボタン名とREQUESTの関係の理解」

式1がリクエストを含む

REQUESTは、ページの送信方法を追跡する内部アプリケーション属性です。デフォルトでは、ページの送信時に、ページを送信させたイベントに従ってREQUESTの値が設定されます。たとえば、ユーザーがボタンをクリックしたり、タブを選択した場合にページが送信されます。イベントによっては、REQUESTアプリケーション属性の値を参照して、異なる操作を実行できます。

この条件を使用すると、許可するリクエスト(SAVEやUPDATEなど)のカンマで区切られたリストを「式1」に指定できます。REQUESTの値がリストに含まれている場合、この条件はtrueと評価されます。

関連項目: 「REQUEST」および「ボタン名とREQUESTの関係の理解」

式1がリクエストを含まない

この条件は、「式1がリクエストを含む」の反対の条件です。REQUESTの値が「式1」に含まれていない場合は、trueと評価されます。

関連項目: 「REQUEST」および「ボタン名とREQUESTの関係の理解」

SQL式

SQL文のWHERE句として評価されます。たとえば、式:MY_ITEM = 'ABC'の場合を考えてみます。

Application Expressエンジンで次の処理が実行されます。

select 1 from dual where :MY_ITEM = 'ABC'

行が戻された場合、この条件はtrueと評価されます。

SQLレポート(「OK」をクリックすると「戻る」ボタンを表示)

この条件は、ページ区切りが含まれているレポートに使用します。この条件は、結果セット内でページを戻るボタンを含めるタイミングを自動的に判断します。

SQLレポート(「OK」をクリックすると「次へ」ボタンを表示)

この条件は、ページ区切りが含まれているレポートに使用します。この条件は、結果セット内でページを進むボタンを含めるタイミングを自動的に判断します。

式1のテキスト!=式2 (ITEM置換を含む)

この条件を使用すると、文字列を含む2つの式を比較できます。いずれかの式には、&MY_ITEM.構文を使用して、セッション・ステートへの参照を含めることができます。

関連項目: &MY_ITEM.構文については、「置換文字列の理解」を参照してください。

式1のテキスト=式2 (ITEM置換を含む)

この条件は、「式1のテキスト!=式2 (ITEM置換を含む)」の反対の条件です。文字列を含む2つの式が比較されます。&ITEM.構文を使用して、片方の式にセッション・ステートの参照を含めることができます。

アイテムF100_P2_DAY_DATEが「Wednesday」と同じであるかどうかを確認するには、この条件を選択して、「式1」および「式2」に次のように入力します。

- 式1: F100_P2_DAY_DATE

- 式2: Wednesday

関連項目: &MY_ITEM.構文については、「置換文字列の理解」を参照してください。

式1のテキストが式2のアイテムの値に含まれる

この条件は、式1に含まれている文字列と、式2で参照されるアイテムの値を比較します。式1には、&ITEM.構文を使用して、セッション・ステートへの参照を含めることができます。

アイテムF100_P2_DAY_DATEがテキストWedを含むかどうかを確認するには、この条件を選択して、「式1」および「式2」に次のように入力します。

- 式1: Wed

- 式2: F100_P2_DAY_DATE

関連項目: &MY_ITEM.構文については、「置換文字列の理解」を参照してください。

式1のテキストが式2のテキストに含まれる

この条件は、文字列を含む2つの式を比較できます。いずれかの式には、&ITEM.構文を使用して、セッション・ステートへの参照を含めることができます。

関連項目: &MY_ITEM.構文については、「置換文字列の理解」を参照してください。

式1のテキストが式2のテキストに含まれない

この条件は、「式1のテキストが式2のテキストに含まれる」の反対の条件です。&ITEM.構文を使用して、片方の式にセッション・ステートの参照を含めることができます。

関連項目: &MY_ITEM.構文については、「置換文字列の理解」を参照してください。

認証済ユーザー(非パブリック・ユーザー)

カレント・ユーザーが組込み認証スキームまたはカスタム認証スキームのいずれかを使用して認証されたかどうかを確認します。

関連項目: 認証の詳細は、「認証によるユーザー・アイデンティティの証明」を参照してください。

パブリック・ユーザー(認証されていないユーザー)

パブリック・ユーザーは、アプリケーション属性として定義されます。特定のアプリケーションに対してパブリック・ユーザーを設定するには、アプリケーション・ビルダーのホームページに移動し、そのアプリケーションに対応する編集リンクをクリックします。

パブリック・ユーザーは、複数のユーザーで使用されるユーザーです。アプリケーションには、認証およびログインが必要なパブリック・ページが含まれる場合があります。ユーザーがパブリック・ユーザーである(ユーザーがユーザー自身として認証されたか、またはアプリケーション属性Public Userで識別されたパブリック・ユーザー以外のユーザーとして認証された)場合、この条件はtrueを戻します。

関連項目: パブリック・ユーザーについては、「認証」を参照してください。

式1のアイテムの値!=式2

この条件は、「式1のアイテムの値=式2」の反対の条件です。これはアイテムの値を特定の文字列と比較します。この条件を使用した比較では、大/小文字が区別されます。

たとえば、アイテムF100_IDが値10と等しくないかどうかを確認するには、「式1」および「式2」フィールドに次のとおり入力します。

- 式1: F100_ID

- 式2: 10

式1のアイテムの値=式2

アイテムの値を特定の文字列と比較します。この条件を使用した比較では、大/小文字が区別されます。

たとえば、アイテムF100_P2_WORDの値が文字列「the quick brown fox」に含まれているかどうかを確認するには、「式1」および「式2」フィールドに次のとおり入力します。

- 式1: F100_P2_WORD

- 式2: the quick brown fox

式1のアイテムの値=0(ゼロ)

「式1」内のアイテムの値が0 (ゼロ)であるかどうかを確認します。

式1のアイテムの値が空白を含まない

「式1」に指定したアイテムの値に空白が含まれていない場合は、trueと評価されます。

式1のアイテムの値が英数字

「式1」の文字列に英数字のみが含まれている場合は、trueと評価されます。

式1のアイテムの値が、式2のコロンで区切られたリストに含まれる

この条件タイプを使用すると、特定の文字列がセッション・ステート・アイテムの値に含まれているかどうかを確認できます。「式1」に指定した文字列が、「式2」に指定したアイテムの値に含まれているかどうかを確認します。

式1のアイテムの値が、式2のコロンで区切られたリストに含まれない

「式1」に指定した値に、コロンで区切られた要素リストの文字列が含まれている場合は、trueと評価されます。

P1_TODAYが「Monday」、「Tuesday」または「Wednesday」のいずれかであるかどうかを確認するには、この条件を選択して、「式1」および「式2」に次のとおり入力します。

- 式1: P1_TODAY

- 式2: Monday: Tuesday:Wednesday

式1のアイテムの値がNOT NULL

「式1」に、アプリケーションまたはページ・アイテムの名前(大文字)を入力します。アイテムのキャッシュの現在の値がNULLでない(値を持つ)場合は、trueと評価されます。そうでない場合は、falseと評価されます。

式1のアイテムの値がNOT NULLかつ0(ゼロ)以外

この条件は、「式1」がNULLでなく、ゼロでないかどうかを確認するために使用します。

たとえば、アイテムF100_IDの値がNULLでなく、ゼロでないかどうかを確認するには、「式1」に次のとおり入力します。

- 式1: F100_ID

式1のアイテムの値が数値ではない

この条件は、「式1」の値が数値でないことを確認するために使用します。

たとえば、アイテムF100_USER_NAMEが数値でないかどうかを確認するには、「式1」に次のとおり入力します。

- 式1: F100_USER_NAME

式1のアイテムの値がNULL

「式1」のアイテムが値を持たない場合は、trueと評価されます。

式1のアイテムの値がNULLまたは0 (ゼロ)

「式1」のアイテムの値がNULLまたは0 (ゼロ)のいずれかである場合は、trueと評価されます。

式1のアイテムの値が数値

「式1」のアイテムの値が数値である場合は、trueと評価されます。

「式1のユーザー・プリファレンスの値!=式2」

この条件は、「式1のユーザー・プリファレンスの値=式2」の反対の条件です。「式1」に指定したユーザー・プリファレンスの名前が「式2」の文字列と同じでない場合は、trueと評価されます。

式1のユーザー・プリファレンスの値=式2

ユーザー・プリファレンスの値を確認します。「式1」に指定したユーザー・プリファレンスの名前が「式2」の文字列と同じである場合は、trueと評価されます。

カンマで区切られたアイテム・リストのアイテムを変更した場合

「式1」に指定したアイテム・リストに含まれる、NULLでない任意のセッション・ステート・アイテムの値を変更した場合は、trueと評価されます。

カンマで区切られたページ・リストのアイテムを変更した場合

「式1」に指定したページ・リストに含まれる、NULLでない任意のセッション・ステート・アイテムの値を変更した場合は、trueと評価されます。

カレント・アプリケーションのアイテムを変更した場合

カレント・アプリケーションのNULLでない任意のセッション・ステート・アイテムの値を変更した場合は、trueと評価されます。

カレント・ページのアイテムを変更した場合

カレント・ページのNULLでない任意のセッション・ステート・アイテムの値を変更した場合は、trueと評価されます。

カレント・セッションのアイテムを変更した場合

カレント・セッションのNULLでない任意のセッション・ステート・アイテムの値を変更した場合は、trueと評価されます。

CGI_ENV DAD_NAME!=式1

この条件は、「CGI_ENV DAD_NAME=式1」の反対の条件です。

アプリケーションのカレント・ページを呼び出すURLに使用されているデータ・アクセス記述子(DAD)を確認し、それを「式1」と比較します。DADが「式1」と同じでない場合は、trueと評価されます。

CGI_ENV DAD_NAME=式1

アプリケーションのカレント・ページを呼び出すURLに使用されているデータ・アクセス記述子(DAD)を確認し、それを「式1」と比較します。DADが「式1」と同じである場合は、trueと評価されます。

CGI_ENV HTTP_HOST!=式1

この条件は、「CGI_ENV HTTP_HOST=式1」の反対の条件です。

Common Gateway Interface(CGI)環境変数HTTP_HOSTの値を確認します。これは、owa_util.get_cgi_env ('HTTP_HOST')によって戻される値です。この値が「式1」の文字列と同じでない場合は、trueと評価されます。

CGI_ENV HTTP_HOST=式1

Common Gateway Interface(CGI)環境変数HTTP_HOSTの値を確認します。これは、owa_util.get_cgi_env ('HTTP_HOST')によって戻される値です。この値が「式1」の文字列と同じである場合は、trueと評価されます。

CGI_ENV SERVER_NAME!=式1

この条件は、「CGI_ENV SERVER_NAME=式1」の反対の条件です。

Common Gateway Interface(CGI)環境変数SERVER_NAMEの値を確認します。これは、owa_util.get_cgi_env ('SERVER_NAME')によって戻される値です。この値が「式1」の文字列と同じでない場合は、trueと評価されます。

CGI_ENV SERVER_NAME=式1

Common Gateway Interface(CGI)環境変数SERVER_NAMEの値を確認します。これは、owa_util.get_cgi_env ('SERVER_NAME')によって戻される値です。この値が「式1」の文字列と同じである場合は、trueと評価されます。

D 付与された権限について

このセクションでは、付与された権限について説明します。

内容は次のとおりです。

- データベース・ユーザーへの権限の付与について

- PUBLICに付与された権限について

データベース・ユーザーへの権限の付与について

Oracle Application Expressリリース4.2では、既存のスキーマでワークスペースを作成するときにデータベース・ユーザーに権限が付与されません。直接付与がない場合、Oracle Application Expressのデータベース・ユーザーは表などのデータベース・オブジェクトを作成できません。標準データベース・オブジェクトの作成を許可するために、オラクル社では次に示す直接付与による権限をお薦めします。

grant CREATE SESSION to [database username]

grant CREATE CLUSTER to [database username]

grant CREATE DIMENSION to [database username]

grant CREATE INDEXTYPE to [database username]

grant CREATE JOB to [database username]

grant CREATE MATERIALIZED VIEW to [database username]

grant CREATE OPERATOR to [database username]

grant CREATE PROCEDURE to [database username]

grant CREATE SEQUENCE to [database username]

grant CREATE SNAPSHOT to [database username]

grant CREATE SYNONYM to [database username]

grant CREATE TABLE to [database username]

grant CREATE TRIGGER to [database username]

grant CREATE TYPE to [database username]

grant CREATE VIEW to [database username]

PUBLICに付与された権限について

このセクションでは、既存のパブリック・シノニムについて説明します。パブリック・シノニムでは、Oracle Application Express製品スキーマ(たとえば、APEX_040200)が所有するパッケージ、プロシージャ、ファンクション、表およびビューに対するEXECUTE権限がPUBLICに付与されています。

内容は次のとおりです。

- パッケージ

- プロシージャ

- ファンクション

- 表

- ビュー

- 順序

- タイプ

パッケージ

パブリック・シノニムが存在し、Oracle Application Express製品スキーマ(たとえば、APEX_040200)が所有する次のパッケージに対する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_040200)が所有する次のパッケージに対するEXECUTE権限がPUBLICに付与されます。

WWV_CALCULATOR

WWV_FLOW_FLASH_CHART

WWV_FLOW_GENERATE_DDL

WWV_FLOW_IMAGE_GENERATOR

WWV_FLOW_TREE_GLOBAL_VARS

プロシージャ

パブリック・シノニムが存在し、Oracle Application Express製品スキーマ(たとえば、APEX_040200)が所有する次のプロシージャに対する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

Functions

パブリック・シノニムが存在し、Oracle Application Express製品スキーマ(たとえば、APEX_040200)が所有する次のファンクションに対するEXECUTE権限がPUBLICに付与されます。

NV

V

WWV_FLOW_HOT_HTTP_LINKS

Oracle Application Express製品スキーマ(たとえば、APEX_040200)が所有する次のファンクションに対するEXECUTE権限がPUBLICに付与されます。

WWV_POPUP_FILTER

表

パブリック・シノニムが存在し、Oracle Application Express製品スキーマ(たとえば、APEX_040200)が所有する次の表に対するSELECT権限がPUBLICに付与されます。

WWV_FLOW_DUAL100

WWV_FLOW_TEMP_TABLE

WWV_FLOW_LOV_TEMP

ビュー

パブリック・シノニムが存在し、Oracle Application Express製品スキーマ(たとえば、APEX_040200)が所有する次のビューに対するSELECT権限がPUBLICに付与されます。

APEX_APPLICATIONS

APEX_APPLICATION_ALL_AUTH

APEX_APPLICATION_AUTH

APEX_APPLICATION_AUTHORIZATION

APEX_APPLICATION_BC_ENTRIES

APEX_APPLICATION_BREADCRUMBS

APEX_APPLICATION_BUILD_OPTIONS

APEX_APPLICATION_CACHING

APEX_APPLICATION_COMPUTATIONS

APEX_APPLICATION_GROUPS

APEX_APPLICATION_ITEMS

APEX_APPLICATION_LISTS

APEX_APPLICATION_LIST_ENTRIES

APEX_APPLICATION_LOVS

APEX_APPLICATION_LOV_ENTRIES

APEX_APPLICATION_NAV_BAR

APEX_APPLICATION_PAGES

APEX_APPLICATION_PAGE_BRANCHES

APEX_APPLICATION_PAGE_BUTTONS

APEX_APPLICATION_PAGE_COMP

APEX_APPLICATION_PAGE_DA

APEX_APPLICATION_PAGE_DA_ACTS

APEX_APPLICATION_PAGE_DB_ITEMS

APEX_APPLICATION_PAGE_FLASH5

APEX_APPLICATION_PAGE_FLASH5_S

APEX_APPLICATION_PAGE_FLASH_CH

APEX_APPLICATION_PAGE_GROUPS

APEX_APPLICATION_PAGE_IR

APEX_APPLICATION_PAGE_IR_CAT

APEX_APPLICATION_PAGE_IR_CGRPS

APEX_APPLICATION_PAGE_IR_COL

APEX_APPLICATION_PAGE_IR_COMP

APEX_APPLICATION_PAGE_IR_COND

APEX_APPLICATION_PAGE_IR_GRPBY

APEX_APPLICATION_PAGE_IR_RPT

APEX_APPLICATION_PAGE_IR_SUB

APEX_APPLICATION_PAGE_ITEMS

APEX_APPLICATION_PAGE_MAP

APEX_APPLICATION_PAGE_PROC

APEX_APPLICATION_PAGE_REGIONS

APEX_APPLICATION_PAGE_RPT

APEX_APPLICATION_PAGE_RPT_COLS

APEX_APPLICATION_PAGE_TREES

APEX_APPLICATION_PAGE_VAL

APEX_APPLICATION_PARENT_TABS

APEX_APPLICATION_PROCESSES

APEX_APPLICATION_SHORTCUTS

APEX_APPLICATION_SUBSTITUTIONS

APEX_APPLICATION_SUPP_OBJECTS

APEX_APPLICATION_SUPP_OBJ_BOPT

APEX_APPLICATION_SUPP_OBJ_CHCK

APEX_APPLICATION_SUPP_OBJ_SCR

APEX_APPLICATION_TABS

APEX_APPLICATION_TEMPLATES

APEX_APPLICATION_TEMP_BC

APEX_APPLICATION_TEMP_BUTTON

APEX_APPLICATION_TEMP_CALENDAR

APEX_APPLICATION_TEMP_LABEL

APEX_APPLICATION_TEMP_LIST

APEX_APPLICATION_TEMP_PAGE

APEX_APPLICATION_TEMP_POPUPLOV

APEX_APPLICATION_TEMP_REGION

APEX_APPLICATION_TEMP_REPORT

APEX_APPLICATION_THEMES

APEX_APPLICATION_TRANSLATIONS

APEX_APPLICATION_TRANS_MAP

APEX_APPLICATION_TREES

APEX_APPLICATION_WEB_SERVICES

APEX_APPL_PLUGINS

APEX_APPL_PLUGIN_ATTRIBUTES

APEX_APPL_PLUGIN_ATTR_VALUES

APEX_APPL_PLUGIN_EVENTS

APEX_APPL_PLUGIN_FILES

APEX_DEBUG_MESSAGES

APEX_DEVELOPER_ACTIVITY_LOG

APEX_DICTIONARY

APEX_MIGRATION_ACC_FORMS

APEX_MIGRATION_ACC_PROJECTS

APEX_MIGRATION_ACC_QUERIES

APEX_MIGRATION_ACC_RPTS

APEX_MIGRATION_ACC_TABLES

APEX_MIGRATION_PROJECTS

APEX_MIGRATION_REV_FORMS

APEX_MIGRATION_REV_QUERIES

APEX_MIGRATION_REV_RPTS

APEX_MIGRATION_REV_TABLES

APEX_RELEASE

APEX_STANDARD_CONDITIONS

APEX_TEAM_BUGS

APEX_TEAM_FEEDBACK

APEX_TEAM_MILESTONES

APEX_TEAM_TODOS

APEX_THEMES

APEX_UI_DEFAULTS_ATTR_DICT

APEX_UI_DEFAULTS_COLUMNS

APEX_UI_DEFAULTS_GROUPS

APEX_UI_DEFAULTS_LOV_DATA

APEX_UI_DEFAULTS_TABLES

APEX_WORKSPACES

APEX_WORKSPACE_ACCESS_LOG

APEX_WORKSPACE_ACTIVITY_LOG

APEX_WORKSPACE_APEX_USERS

APEX_WORKSPACE_CLICKS

APEX_WORKSPACE_DEVELOPERS

APEX_WORKSPACE_FILES

APEX_WORKSPACE_LOG_SUMMARY

APEX_WORKSPACE_LOG_SUMMARY_USR

APEX_WORKSPACE_SCHEMAS

APEX_WORKSPACE_SESSIONS

APEX_WORKSPACE_SQL_SCRIPTS

APEX_WS_APPLICATIONS

APEX_WS_APP_PAGES

APEX_WS_DATA_GRID

APEX_WS_DATA_GRID_COL

WWV_FLOW_CLICKTHRU_LOG

WWV_FLOW_COLLECTIONS

WWV_FLOW_FEEDBACK_TYPES

WWV_FLOW_GROUP_USERS

WWV_FLOW_LISTS_OF_VALUES$_V

WWV_FLOW_LIST_OF_VALUES_DATA_V

WWV_FLOW_MONTHS_MON

WWV_FLOW_MONTHS_MONTH

WWV_FLOW_PLSQL_JOBS

WWV_FLOW_USERS

WWV_FLOW_USER_ACCESS_LOG

WWV_FLOW_USER_ACTIVITY_LOG

WWV_FLOW_USER_MAIL_LOG

WWV_FLOW_YEARS

また、次のビューにはINSERTが付与されています。

WWV_FLOW_FILES

さらに、次のビューではPUBLICにSELECT権限が付与されていますが、シノニムが存在しません。

WWV_FLOW_HOURS_12

WWV_FLOW_HOURS_24

WWV_FLOW_MINUTES

WWV_FLOW_MINUTES_5

順序

次の順序にはパブリック・シノニムがあり、PUBLICにSELECT権限が付与されています。

WWV_FLOW_SESSION_SEQ

WWV_SEQ

タイプ

次のタイプでは、PUBLICにEXECUTEが付与されていますが、シノニムが存在しません。

WWV_FLOW_TREE_ENTRY

WWV_FLOW_TREE_SUBS

E Oracle Application Expressのアクセシビリティ

このセクションでは、キーボードまたはFreedom Scientific社のスクリーン・リーダーJAWSのみを使用してOracle Application Expressにアクセスするユーザーに情報を提供します。

内容は次のとおりです。

- スクリーン・リーダー・モードについて

- ハイ・コントラスト・モードについて

- JAWSを使用した対話モード・レポートへのアクセス

- JAWSを使用したフォーム・ページへのアクセス

- キーボードを使用したコンポーネントへのアクセス

Oracle製品のアクセシビリティの詳細は、次のWebサイトを参照してください。

http://www.oracle.com/accessibility

注意:
このセクションに記載されている内容は、すべてデフォルト設定のJAWSリリース13.0を使用しています。この項の手順はすべて、フル・サイズのキーボードの使用に基づきます。ラップトップのキーボードを使用している場合は、手順が異なることがあることに注意してください。

スクリーン・リーダー・モードについて

セッションは、スクリーン・リーダーでの使用に最適化するように定義できます。これには、Application Express開発環境を使用する場合と、ユーザー独自のアプリケーションを使用する場合の両方が含まれています。

内容は次のとおりです。

- スクリーン・リーダー・モードの機能

- スクリーン・リーダー・モードの有効化

関連項目:
「データベース・アプリケーションでのスクリーン・リーダー・モードの使用」

スクリーン・リーダー・モードの機能

スクリーン・リーダー・モードを有効化すると、現在はデフォルトで次の機能を実行します。

- Oracle Application Express Flashチャートはスクリーン・リーダーから現在アクセスできないため、スクリーン・リーダー・モードで実行すると、ユーザーはチャートで伝達される情報のレポート表示を受け取ります。複数シリーズのチャートでは、各シリーズについて別々のレポートが生成されます。スクリーン・リーダー・モードで実行するとき、これらのデータ表には説明テキストが次の形式で格納されます。

- データベース・アプリケーションの場合

- サマリー・テキスト: チャート・タイトルとチャート・シリーズ・タイトルの組合せが使用されます。

- 列ヘッダー: レポートの列を識別するために、チャート・シリーズ問合せの列名または別名が使用されます。

- Webシート・アプリケーションの場合

- サマリー・テキスト: セクション・タイトルがサマリー・テキストとして使用されます。

- 列ヘッダー: レポートの列を識別するために「データ・グリッド」レポート・ラベルが使用されます。

- 使用するスクリーン・リーダーとブラウザの両方でWAI-ARIA Liveリージョンがサポートされている必要があります。Oracle Application Expressは、Liveリージョンがサポートされている、最新のJAWSスクリーン・リーダー(13.0)でのみテストされています。現時点でこのことがサポートされているブラウザのリストは、次のとおりです。

- Mozilla Firefox 3.0以上

- Microsoft Internet Explorerバージョン8

- Report ViewまたはGroup By Viewの対話モード・レポート・リージョンでは、情報を伝達するためにデータ表が使用されます。データ表では、スクリーン・リーダーのユーザーに対して表が格納する情報を記述するテキスト記述が必要です。スクリーン・リーダー・モードで実行するとき、これらのデータ表には詳細なサマリー・テキストが次の形式で格納されます。

- リージョン: 開発者により定義されるリージョンの名前。

- レポート: 「対話モード・レポート」内の現在の「保存されたレポート」の名前。「保存されたレポート」が定義されていない場合は、デフォルトの「プライマリ・デフォルト」に設定されます。

- ビュー: レポートの現在のビュー(「レポート」または「グループ化」のいずれか)。

- 表示行の開始: 現在表示されている行セットの開始行。

- 表示行の終了: 現在表示されている行セットの終了行。

- 行合計: レポートにより返された行の合計数。

- 対話モード・レポート・リージョンには、レポート・データにAggregatesを追加する機能が提供されています。使用可能な集計の1つが列の値のSumです。スクリーン・リーダー・モードでの実行中、合計された値の接頭辞としてSum:のテキストが表示されます。標準モードでは、合計された値のみが表示されます。その他の集計では、モードにかかわらず、集計タイプ接頭辞がデフォルトで表示されます。

- アイテム・レベルのヘルプ・テキストは、スクリーン・リーダー・モードでは別の方法で提供されます。標準モードでは、特定アイテムのヘルプ・テキストを表示するダイアログがページに表示されます。ただし、これらのダイアログはスクリーン・リーダーと一緒に使用する場合に多くの問題があるため、スクリーン・リーダー・モードで実行するときは、クラシック・ポップアップ・ページを使用してアイテムのヘルプ・テキストを表示します。

- アプリケーション・ビルダーで、ページ情報を管理するために使用するページ定義ページには、「コンポーネント・ビュー」と「ツリー・ビュー」の2つの異なるビューが含まれています。「ツリー・ビュー」で使用されるツリーには、スクリーン・リーダーを使用してアクセスできないため、このページをスクリーン・リーダー・モードで実行する場合、デフォルトは「コンポーネント・ビュー」です。

- データベース・アプリケーションで使用できる、Application Expressのツリー・リージョン・コンポーネントは、スクリーン・リーダーではアクセスできません。このため、スクリーン・リーダー・モードで実行すると、ユーザーはツリーで伝達される情報の表示として、順序付けられていない階層リストを受け取ります。

- スクリーン・リーダー・モードでは、発生した検証エラーに対するユーザーの処理プロセスが大きく改善されています。次の例を想定してください。フォーム・ページが送信され、検証が失敗して、エラーが表示されました。ページ・アイテムに関連付けられているエラーがある場合、マークアップがページ・アイテムに追加され、フォーム・フィールドを移動する際に、スクリーン・リーダーによってアイテムに無効なエントリが含まれていることがユーザーに通知されます。さらに、フォーム・フィールドを移動する際に、対応するエラー・メッセージがユーザーに通知されます。

ヒント:
これらの改善を利用するには、使用するスクリーン・リーダーとブラウザの両方でWAI-ARIAがサポートされている必要があります。

- Webシート・アプリケーションのホームページには、カレント・ページ、親ページとホームページを示すブレッドクラムが表示されます。親ページのブレッドクラム・エントリで、ユーザーがエントリにカーソルを重ねると、そのページのすべての兄弟ページを表示するツールチップが表示されます。スクリーン・リーダー・モードでは、この情報はかわりに階層型ページ・リストとして表示されます。これは、<h2>レベル・ヘッダーの「子ページがある階層型ページ・リスト」の直下にあるため、スクリーン・リーダーのユーザーはこれを容易に判別できます。

スクリーン・リーダー・モードの有効化

Oracle Application Express開発環境でスクリーン・リーダー・モードを有効にするには、「ワークスペース」ホームページとOracle Application Express管理サービスのページにある「アクセシビリティ・モード」リストから「スクリーン・リーダー」を選択します。

図accessibility_mode_reader.gifの説明

Webシート・アプリケーションでスクリーン・リーダー・モードを有効にするには、「Webシート」ホームページの右側下にある「スクリーン・リーダー」リンクをクリックします。

Oracle Application Express開発環境をスクリーン・リーダーとともに使用する場合は、このオプションを有効にしてあることを確認してください。

ハイ・コントラスト・モードについて

Oracle Application Express開発環境、Webシート・ランタイムに加え、独自のデータベース・アプリケーション内でも、セッションがハイ・コントラスト用に最適化されていることを確認できます。デフォルトでは、セッションはハイ・コントラスト・モードで実行するようにフラグ付けされていません。

内容は次のとおりです。

- ハイ・コントラスト・モードの機能

- ハイ・コントラスト・モードの有効化

関連項目:
「データベース・アプリケーションでのハイ・コントラスト・モードの使用」

ハイ・コントラスト・モードの機能

ハイ・コントラスト・モードを有効化すると、次の動作が行われます。

- Oracle Application Express開発環境の場合
対話モード・レポート・リージョンの検索バーのコントロールがアイコンなしで表示され、アイコンを含むすべてのコントロールが、ボタンのような見た目のクリア・テキストとして表示されます。また、同じレポート・テンプレートを共有するレポートがApplication Express全体に数多く存在し、これらの列ヘッダーにはコントラストの問題があります。これらのレポートについてハイ・コントラスト・モードを有効にすると、グラデーション背景が削除され、かわりにより色の濃い無地の背景が表示されます。

- Application Express Webシート・ランタイムの場合
Webシート・アプリケーションにより、CSSベースのイメージ・リンクがテキスト・リンクで置き換えられます。これらのテキスト・リンクは、ソース・イメージが透明であり、その場所でCSS背景プロパティが使用されているイメージについてのみ作成されます。

- カスタム・データベース・アプリケーションの場合
フレームワークからネイティブには何も行われません。各開発者が、モードをプロビジョニングし、必要に応じて変更を行う必要があります。

ハイ・コントラスト・モードの有効化

Oracle Application Express開発環境でハイ・コントラスト・モードを有効にするには、「ワークスペース」ホームページとOracle Application Express管理サービスのページにある「アクセシビリティ・モード」リストから「ハイ・コントラスト」を選択します。

図accessibility_mode.gifの説明

実行しているWebシート・アプリケーションでハイ・コントラスト・モードを有効にするには、「Webシート」ホームページの右側下にある「ハイ・コントラスト」リンクをクリックします。

Windowsのハイ・コントラスト・モードでOracle Application Express開発環境を使用する場合は、このオプションが有効になっていることを確認してください。

JAWSを使用した対話モード・レポートへのアクセス

この項では、JAWSを使用して対話モード・レポートにアクセスする方法について説明します。

内容は次のとおりです。

- 「アクション」メニューへのアクセス

関連項目:
「対話モード・レポート・リージョンへのアクセス」

「アクション」メニューへのアクセス

対話モード・レポート・リージョンには、これらのリージョンによって提供される多くの機能へのメイン・エントリ・ポイントである「アクション」メニューがあります。

JAWSを使用して「アクション」メニューにアクセスするには、次のステップを実行します。

1. [Insert]＋[F5]を押して、フォーム・フィールドの選択ダイアログ・ボックスをロードします。

2. 「アクション・ボタン」フィールドに達するまで、[A]を繰り返し押します。

3. [Enter]を押して、「アクション」ボタンにナビゲートします。

4. [Enter]を押して、「アクション」メニューを開きます。
ここで、JAWS仮想PCカーソルをオフにする必要があります。「アクション」メニューがキーボードで完全にアクセス可能になります。

5. [Insert]＋[Z]を押して、JAWS仮想PCカーソルをオフにします。
JAWSによって、仮想PCカーソルの使用が無効化されたことが通知されます。

6. [↑]および[↓]を押して、現在のメニュー・レベルを上および下に移動し、[←]および[→]を押して、サブメニューに対するナビゲートを行います。メニューは、次の項目で構成されています。

- 列の選択

- フィルタ

- ページごとの行数(レポートが表示する行数を選択するためのサブメニューが含まれています)

- 書式(「ソート」、「コントロール・ブレーク」、「ハイライト」、「計算」、「集計」、「チャート」、「グループ化」を指定するためのサブメニューが含まれています)

- レポートの保存

- リセット

- ヘルプ

- ダウンロード

- サブスクリプション

7. 実行する特定のアクションを選択したら、[Enter]を押して、関連するダイアログをロードします。
たとえば、「フィルタ」を選択したとします。「フィルタ」ダイアログがロードされます。これが更新されると、フォーカスされているダイアログの最初のフォーム・フィールドの前にあるカレント・ページの名前がJAWSによって通知されます。

8. ここで、[Insert]＋[Esc]を押して、仮想カーソルをリフレッシュします。
JAWSによって、画面が更新されたことが通知されます。

9. JAWS仮想PCカーソルを再び有効にするには、[Insert]＋[Z]を押します。
JAWSによって、仮想PCカーソルの使用が有効化されたことが通知されます。

次に、フィルタ属性を定義します。このダイアログには、フィルタ・タイプごとに若干異なるフォーム・フィールドと、それに続く選択内容が含まれています。列フィルタを定義するためのデフォルトのフィールドは、「列」選択リスト、「演算子」選択リストおよび「式」入力です。

10. これらのフィールドを通知させるために、JAWSショートカット・キー[F]および[Shift]＋[F]を数回押して、これらのフィールド・アイテムを移動します。その後で、フォーム・フィールドでフィルタの詳細を選択または入力します。
次に、フィルタを適用します。ダイアログの終わりに、「取消」および「適用」ボタンが表示されます。ここには、JAWSショートカット・キー[B]を使用してナビゲートできます。

11. 「適用」と通知があるまで[B]を押し、その後で[Enter]を押します。
ページがリフレッシュされます。コンテンツがリフレッシュされるとJAWSによって通知が行われ、レポートの現在の設定が読み上げられます。

12. レポート情報に直接移動するには、JAWSショートカット・キー[T]を押して、フィルタが適用された情報を格納しているデータ表に移動します。
他の機能に対する他のダイアログも同様の方法で追加できます。

JAWSを使用したフォーム・ページへのアクセス

Oracle Application Expressのページの多くは、アプリケーションのメタデータを保持するために設計されたフォーム・ページです。このセクションでは、これらのページの構造について理解し、JAWSなどのスクリーン・リーダーを使用して対話する方法について説明します。

内容は次のとおりです。

- ページの構造の理解

- ページの「タスク」リンクの使用

- ヘルプ・テキストへのアクセス

- 検証エラーの処理

ページ構造の理解

多くのフォーム・ページは、論理的に異なるリージョンに分けられます。たとえば、「ページ・アイテムの編集」ページには、ページ・アイテムに関する情報を保持するためのフォーム・フィールドを含む次のリージョンがあります。

- 名前

- 表示

- ラベル

- 設定

- LOV(アイテム・タイプに応じたもの)

- 要素

- ソース

- デフォルト

- クイック選択(アイテム・タイプに応じたもの)

- 条件

- 読取り専用

- セキュリティ

- 構成

- ヘルプ・テキスト

- コメント

Oracle Application Expressでは、その開発インタフェース全体を通じてヘッダー(Hn)・タグが使用されており、ページの構造の定義が容易になっています。たとえば、ページ・アイテムの編集ページには、次のヘッダーが定義されています。

- レベル1(H1)*

- Application Express

- レベル2(H2)*

- 名前

- 表示

- ラベル

- 設定

- 要素

- ソース

- デフォルト

- 条件

- 読取り専用

- セキュリティ

- 構成

- ヘルプ・テキスト

- コメント

- レベル3(H3)*

- ページ・アイテム

- タスク

前述のリストは、ヘッダーがOracle Application Express開発環境でどのように使用されるかを表しています。次の点に注意してください。

- レベル1ヘッダー(H1)は、対象となっている開発環境のコンテキストに応じて、関連するルート・ページへのリンクを提供します(たとえば、アプリケーションを編集している場合は、Application Builderのアプリケーション用のホームページに移動されます)。

- レベル2ヘッダー(H2)には、カレント・ページの主要な機能に必要なセクションが含まれています。

- レベル3ヘッダー(H3)には、カレント・ページの機能に関連するセクションが含まれています。

カレント・ページにあるすべてのヘッダーの概要を参照するには、[Insert]＋[F6]を押して、カレント・ページのヘッダーをリストします。

また、他のJAWSキーストロークを利用して、ページ・ヘッダーをナビゲートすることもできます。たとえば、レベル2ヘッダーをナビゲートするには、次のステップを実行します。

1. [Insert]＋[Alt]＋[Ctrl]＋[2]を押して、ページにあるレベル2の最初のヘッダーに移動します。
JAWSによって、ページ・アイテムの編集ページの「名前」ヘッダー・レベル2であることが通知されます。

2. [2]を押して、レベル2の次のヘッダーに移動します。
JAWSによって、ページ・アイテムの編集ページの「表示」ヘッダー・レベル2であることが通知されます。

3. [Shift]＋[2]を押して、レベル2の前のヘッダーに移動します。
JAWSによって、ページ・アイテムの編集ページの「名前」ヘッダー・レベル2であることが通知されます。

ページの「タスク」リンクの使用

Oracle Application Expressの多くのページには、ページの右側に「タスク」リージョンが含まれています。たとえば、ページ・アイテムの編集ページの右側には、現在のアイテム・タイプに関連するリンクのリストを含む「タスク」リージョンがあります。このリージョンには、セクション・タイトル「タスク」に定義されているレベル3のヘッダー(H3)があります(これは、ここがカレント・ページの主要な機能に関連するセクションであるためです)。

JAWSを使用して「タスク」リージョンにナビゲートするには、次のステップを実行します。

1. [Insert]＋[Alt]＋[Ctrl]＋[3]を押して、ページにあるレベル3の最初のヘッダーに移動します。
ページ・アイテムの編集ページの「ページ・アイテム」ヘッダー・レベル3であることが通知されます。これには、ページ・アイテムに関する一般的なヘルプ情報が含まれています。

2. [3]を押して、レベル3の次のヘッダーに移動します。
ページ・アイテムの編集ページの「タスク」ヘッダー・レベル3であることが通知されます。これには、関連するタスクへのリンクのリストが含まれています。

3. [L]を1回押して、リストにナビゲートします。
JAWSによって、xのアイテムのリストであることが通知されます(xは、現在編集しているページ・アイテムのタイプによって異なります)。

4. [I]を押してリスト・アイテムをナビゲートし、リンクをアクティブ化する場合は、[Enter]を押します。

ヘルプ・テキストへのアクセス

このセクションでは、JAWSを使用してOracle Application Expressのアイテムレベル・ヘルプにアクセスする方法について説明します。

内容は次のとおりです。

- アイテム・ヘルプへのアクセス

アイテム・ヘルプへのアクセス

ユーザー・インタフェース内のほとんどのアイテムでは、フィールド・ラベルをアクティブ化またはクリックすることによって、フィールドレベル・ヘルプを使用できます。ヘルプ・テキストが使用可能な場合は、リンクとして隣接するラベルが実装されます。リンク・テキストは、現在のフォーム・アイテムのラベル・テキストに一致します。このリンクをアクティブ化すると、ヘルプ・テキストを含む別のウィンドウがロードされます。

JAWSを使用してアイテムのこのフィールドレベル・ヘルプにアクセスするには、次のステップを実行します。

1. [Ctrl]＋[Home]を押して、ページの上部に移動します。
JAWSによってページ名が通知されます。

2. [Insert]＋[F7]を押して、リンク・リストダイアログ・ボックスをロードします。

3. 特定するリンク・テキストの最初の文字を押します。この操作を繰り返します。
ヘルプを表示しようとしているフォーム・アイテムのラベルと一致するリンク・テキストがない場合は、そのアイテムのヘルプは使用できません。

4. 適切なリンクが見つかった場合は、[Enter]を押してリンクをアクティブ化します。
ヘルプ・テキストを含む別のウィンドウが表示されます。

5. JAWSナビゲーション・クイック・キー[N]を押して、ヘルプ・テキストに移動します。

6. ヘルプ・テキストの読取りが終了したら[Alt]＋[F4]を押し、「ヘルプ」ウィンドウを閉じてページに戻ります。

検証エラーの処理

Oracle Application Expressには、JAWSユーザーがフォーム・ページの検証エラーを処理する際に役立つ機能が多数組み込まれています。この項では、これらの機能について説明します。

内容は次のとおりです。

- 「エラーが発生しました」の理解

- エラーの確認

- エラーを修正するために関連フィールドにナビゲート

- WAI-ARIAサポートについて

エラーが発生しましたの理解

スクリーン・リーダー・モードの使用時にフォーム・ページで検証が失敗すると、ページ・タイトルの前に次の接頭辞が付けられます。

x errors have occurred - [page title]

ページがロードされると、JAWSによりページ・タイトルが通知されます。つまり、JAWSのユーザーには、検証が失敗したことがすぐに伝わります。

ヒント:
この動作は、スクリーン・リーダー・モードをプロビジョニングするカスタム・データベース・アプリケーションでも、デフォルトで使用可能です。「スクリーン・リーダー・モードについて」を参照してください。

エラーの確認

エラー・メッセージが表示されているページのセクションにナビゲートするには、このセクションの上部で「通知メッセージ」というテキストを含むH2(ヘッダー・レベル2)タグを見つけます。このヘッダーは視覚的には非表示になっていますが、スクリーン・リーダーのユーザーは使用できます。

データベース・アプリケーションへの検証通知の追加

この機能は、独自のデータベース・アプリケーションに簡単に追加できます。これを行うには、ページ・テンプレートの「ページ・テンプレート」、「サブテンプレート」、「通知」セクションに、置換文字列#NOTIFICATION_MESSAGE_HEADING#を追加します。このプレースホルダにより、組込みシステム・メッセージAPEX.NOTIFICATION_MESSAGE_HEADINGの内容が「通知メッセージ」というテキストに置換されます。

この表示テキストをカスタマイズするには、お使いのアプリケーションで、使用するテキストとともに、APEX.NOTIFICATION_MESSAGE_HEADINGという名前のテキスト・メッセージを定義してください。

たとえば、ページ・テンプレートの「通知」セクションに、次を追加できます。

<h2 class="hideMeButHearMe">#NOTIFICATION_MESSAGE_HEADING#</h2>

この例では、hideMeButHearMe CSSクラスの使用によりコンテンツが視覚的に非表示になりますが、スクリーン・リーダーのユーザーはこれを使用できます。

エラーを修正するために関連フィールドにナビゲート

特定のページ・アイテムに関連する検証では、Oracle Application Expressにより、該当するエラー・メッセージの隣にある「通知」セクションに「エラーに移動」リンクが表示されます。ユーザーが「エラーに移動」リンクをクリック(またはアクティブ化)すると、関連するアイテムにフォーカスが移動します。これにより、(スクリーン・リーダーのユーザーだけでなく)すべてのユーザーが、エラーに関連するページにすぐに移動できるようになります。

「エラーに移動」テキストを変更して、デフォルトのテキストを変更したり、Oracle Application Expressによってデフォルトでは翻訳されない言語に翻訳することができます。いずれの場合でも、必要なテキストと言語とともに、APEX.GO_TO_ERRORという名前のテキスト・メッセージを定義してください。さらに、APEX.GO_TO_ERRORテキスト・メッセージのテキストを単なるシングル・スペースに設定して、この機能を無効化し、「エラーに移動」リンクを削除できます。詳細は、「Oracle Application Expressにより内部使用されるメッセージの翻訳」を参照してください。

WAI-ARIAサポートについて

スクリーン・リーダー・モードで実行する場合、Oracle Application Expressにより、無効なページ・アイテムにWeb Accessibility Initiative - Accessible Rich Internet Applications(WAI-ARIA)マークアップが含められます。この拡張により、WAI-ARIAをサポートするスクリーン・リーダーとブラウザの組合せに対するスクリーン・リーダーのユーザーの操作性が向上します。

特定のページ・アイテムに関連するエラーが発生すると、そのページ・アイテムに次の追加の属性が付けられます。

- aria-invalid="true"
これは、スクリーン・リーダーのユーザーがそのページ・アイテムにフォーカスすると、スクリーン・リーダーにより無効なエントリであることが通知されることを意味します。

- aria-describedby="[page_item_name]_error"
この属性値はそのアイテムに関連するエラー・メッセージに対応付けられているため、スクリーン・リーダーのユーザーがそのページ・アイテムにフォーカスすると、スクリーン・リーダーにより実際のエラーが通知されます。

この拡張が行われる前は、エラーのあるページ・アイテムにスクリーン・リーダーのユーザーがナビゲートすると、スクリーン・リーダーによりジョブ、編集、テキストのタイプと通知されることがありました。現在は、スクリーン・リーダーによりジョブの編集、無効なエントリ、ジョブに値が必要です、テキストのタイプと通知されます。

ヒント:
プラグイン・アイテムの開発者が独自のプラグインで同じWAI-ARIAサポートを提供するには、『Oracle Application Express APIリファレンス』のAPEX_ERROR.GET_ARIA_ERROR_ATTRIBUTESファンクションに関する説明を参照してください。

キーボードを使用したコンポーネントへのアクセス

このセクションでは、キーボードを使用してOracle Application Expressのコンポーネントにアクセスする方法について説明します。

内容は次のとおりです。

- 新しい日付ピッカーの使用

- 対話モード・レポート・リージョンへのアクセス

ヒント:
ツリー・リージョンはキーボード・アクセスできないため、キーボードのみでOracle Application Expressを使用する場合は、「スクリーン・リーダー・モード」を有効にする必要があります。スクリーン・リーダー・モードで実行していると、かわりに、順序付けされていない階層的なリストが表示され、[Tab]、[Shift]＋[Tab]および[Enter]キーを使用して特定のリスト・アイテムをアクティブにすることで、キーボードのみのナビゲートを簡単に実行できます。詳細は、「スクリーン・リーダー・モードについて」を参照してください。

新しい日付ピッカーの使用

日付ピッカー用の多数のキーボード・ショートカットがあります。

日付ピッカーを開くには、次のステップを実行します。

1. [Tab]を使用して、適切な入力フィールドに移動します。

2. [Ctrl]+[Home]を押して、日付ピッカーを開きます。

3. 日付ピッカーが開くと、次のナビゲート・オプションを使用できます。

- 月単位:

- [Page Up]を押すと、前の月に移動します。

- [Page Down]を押すと、次の月に移動します。

- [Ctrl]＋[Home]を押すと、現在の月に移動します。

- 週単位:

- [Ctrl]＋[↑]を押すと、前の週に移動します。

- [Ctrl]＋[↓]を押すと、次の週に移動します。

- 日単位:

- [Ctrl]＋[←]を押すと、前の日に移動します。

- [Ctrl]＋[→]を押すと、次の日に移動します。

日付ピッカーでの作業が終了したら、次のステップを実行します。

1. [Enter]を押して、選択された日付を受け入れます。

2. [Esc]を押して、選択せずに日付ピッカーを閉じます。

3. [Ctrl]＋[End]を押して、日付ピッカーを閉じて、日付を消去します。

対話モード・レポート・リージョンへのアクセス

このセクションでは、対話モード・レポート・リージョン内の一般的な機能にアクセスする方法について説明します。

内容は次のとおりです。

- 対話モード・レポートでのデータの検索

- 「アクション」メニューの使用

- バルク更新の管理

- ドリルダウン・リンクの使用

- 既存のフィルタの編集

- 保存済レポートのロード

対話モード・レポートでのデータの検索

検索バーが対話モード・レポートの上に表示されている場合は、「レポート属性」の「検索バーを含める」属性が有効になっています。新しい対話モード・レポートを作成すると、この属性はデフォルトで有効になります。

関連項目:

検索を行うには、次のステップを実行します。

1. 検索フィールドがフォーカスされるまで、[Tab]を押します。

2. 検索フィールドに、検索キーワードを入力します。

3. [Enter]を押して、検索を実行します。

4. 特定の列に検索を絞り込むには、次のステップを実行します。

1. [Tab]を押して、検索フィールドの左にある虫眼鏡アイコンにアクセスします。

2. [Enter]を押して、プルダウン・メニューをアクティブにし、検索に使用できるすべての列のリストを表示します。

3. キーボードの[↓]または[↑]キーを押して、列のリストをナビゲートします。

4. [Enter]を押して、検索対象の列を選択します。これによって、後続の検索のコンテキストが、選択した列に特化したものに設定されます。

5. ステップ1および2を繰り返して、列に特化した検索を実行します。

「アクション」メニューの使用

新しい対話モード・レポートには、デフォルトで、検索バーおよび「アクション」メニューの両方が含まれています。これらの両方の機能は、レポート属性ページの「検索バーを含める」および「アクション」メニュー属性を有効にすることによって、開発者が制御します。開発者がレポートを作成する方法に応じて、「アクション」メニューには様々なオプションを含めることができます。

詳細は、「「アクション」メニューについて」を参照してください。

キーボードを使用して「アクション」メニューにアクセスするには、次のステップを実行します。

1. 「アクション」メニューがフォーカスされるまで、[Tab]を押します。

2. [Enter]を押して、メニューを開きます。

3. メニューが開くと、次のナビゲート・オプションを使用できます。

- [↓]キーを押して、メニューを下に移動します。

- [↑]キーを押して、メニューを上に移動します。

- [→]キーを押して(右矢印で示されている)サブメニューを開き、フォーカスをサブメニューの最初のアイテムに移動します。

- [←]キーを押してサブメニューを閉じ、フォーカスを親メニューの適切なアイテムに戻します。

4. 「アクション」メニューを終了するには、次のステップを実行します。

- [Enter]を押して、アクション固有のダイアログをロードします。フォーカスは、ダイアログ・ボックス内のフォーカス可能な最初の要素に設定されます。

- [Esc]を押して、選択せずにメニューを閉じます。

バルク更新の管理

Oracle Application Expressの一部の対話モード・レポートには、バルク更新をコンポーネントに適用するためのフォーム・アイテムが含まれています。レポート内のすべてのフォーム・アイテムと、変更を適用するためのボタンには、キーボードでアクセスできます。また、一部のページには、バルク処理を実行するためのチェック・ボックスが最初の行にあり、対応する「すべて選択」と「すべて選択解除」リンクがレポートの下にあります。これらのすべてのアイテムには、キーボードでアクセスできます。

ドリルダウン・リンクの使用

Oracle Application Expressの一部の対話モード・レポートには、特定のサブコンポーネントを編集または表示するための1つ以上のリンクが含まれています。これらはすべて標準のリンクであるため、キーボードでアクセスできます。

既存のフィルタの編集

対話モード・レポートに既存の検索フィルタを適用すると、検索バーの下に検索フィルタが表示されます。

検索フィルタには、次のようにキーボードを使用してアクセスできます。

- 検索フィルタの編集
[Tab]を押して検索フィルタにナビゲートし、[Enter]を押して「フィルタ」ダイアログ・ボックスを開きます。フォーカスは、ダイアログ・ボックス内のフォーカス可能な最初の要素に自動的に設定されます。

- 検索フィルタの有効化または無効化
[Tab]を押してフィルタの右側にあるチェック・ボックスにナビゲートし、[Space]を押して、フィルタを有効化または無効化します。

- 検索フィルタの削除
[Tab]を押して検索フィルタにナビゲートし、[Enter]を押して、「フィルタ」ダイアログ・ボックスを開きます。[Tab]または[Shift]＋[Tab]を押して「削除」ボタンにナビゲートし、[Enter]を押します。

保存済レポートのロード

対話モード・レポートに、検索バー、「アクション」メニューおよび保存済レポートのサポートが含まれている場合、これらのオプションはレポート属性ページで開発者によって有効にされています。詳細は、「開発者としての対話モード・レポートの編集」を参照してください。

保存済レポートをロードするには、次のステップを実行します。

1. 「レポート」選択リストがフォーカスされるまで、[Tab]を押します。「レポート」選択リストが表示されるのは、保存済レポートが存在する場合のみであることに注意してください。

2. [↑]および[↓]キーを押して、表示する特定の保存済レポートを選択します。

3. [Enter]を押して、保存済レポートを表示します。

索引

A B C D E F G H I J L M N O P Q R S T U V W X

A

ページ受入れ, 2.3.1

アクセス制御リスト

概要, 10.10

ユーザーの追加, 10.10.3.2

作成, 10.10.2

ユーザーの削除, 10.10.3.3

アプリケーション・モードの選択, 10.10.3

ユーザー権限の選択, 10.10.3.2

アクセス制御, 認可スキーム, 10.10.4 アクセシビリティ

概要, E

「ハイ・コントラスト」モードについて, E.2

「アクセシビリティ・モード」リスト, E.1.2

コンポーネントへのキーボードを使用しないアクセス, E.5

「ハイ・コントラスト」モード, E.2.2

「スクリーン・リーダー・モード」, E.1

WAI-ARIAサポート, E.4.4.4

「アクセシビリティ・モード」リスト, 1.5

ハイ・コントラスト, E.2.2

スクリーン・リーダー, E.1.2

アクション・バー

概要, 8.1.8.1

「コメント」アイコン, 8.1.8.1

「ページのエクスポート」アイコン, 8.1.8.1

「検索」アイコン, 8.1.8.1

「ロック」アイコン, 8.1.8.1

「ページの実行」アイコン, 8.1.8.1

「共有コンポーネント」アイコン, 8.1.8.1

「アクション」メニュー, 9.3.4

JAWSを使用したアクセス, E.3.1

集計, 9.3.4

チャート, 9.3.4

計算, 9.3.4

コントロール・ブレーク, 9.3.4

ダウンロード, 9.3.4

フィルタ, 9.3.4

フラッシュバック, 9.3.4

書式, 9.3.4

グループ化, 9.3.4

ヘルプ, 9.3.4

ハイライト, 9.3.4

リセット, 9.3.4

ページごとの行数, 9.3.4

レポートの保存, 9.3.4

列の選択, 9.3.4

ソート, 9.3.4

サブスクリプション, 9.3.4

アクティビティ・ログ, 17.5 アクティビティ・レポート, カスタムの作成, 17.5 管理

ダッシュボード, 1.5

ユーザーとグループの管理, 1.5

アクティビティの監視, 1.5

「管理」アイコン, 1.5 「フィードバックを許可」属性, 7.2.1.2.2 SQLとPL/SQLの許可, 有効化, 5.7.2 代替デフォルト対話モード・レポート

編集, 9.4.18.1

名前変更, 9.4.18.1

注釈

注釈ページへのアクセス, 5.13.4.1

Webシートへの追加, 5.13.4

削除, 5.13.4.2

AnyCo IT Department

概要, 3.4

インストール, 3.4.1

ナビゲーション, 3.4.2

実行, 3.4.1

APEX_ACTIVITY_LOGビュー, 17.5 APEX_LANG

LANG, 18.5.2

MESSAGE API, 18.4.1.1

APEX_MAIL, 17.3 APEX_UTIL.STRING_TO_TABLE, 7.7.7.1 アプリケーション

Webサイトからのコンテンツの追加, 12.5

認可スキームの割当て, 15.5.3.1

認証スキームの変更, 15.4.6, 15.4.7

ブランチを使用したナビゲーションの制御, 11.5

コピー, 6.3

作成, 2.1

デバッグ, 14

プライマリ言語の定義, 18.2

削除, 6.3

デプロイ, 16.2, 16.3, 16.5.2

エクスポート, 16.3, 16.5.2

グループ化, 7.6

非表示機能, 16.10.3

エクスポート・ファイルのインポート, 16.6

SQL*Plusからのインポート, 16.7.5

言語プリファレンス, 18.1.1

パフォーマンス・チューニング, 14.1

リソース使用, 14.6

アクティブなテーマの切替え, 13.1.4

翻訳可能なコンポーネント, 18.1.3

翻訳, 18.1

コンポーネントの翻訳, 18.1.4

マルチバイト言語の翻訳, 18.2.2

翻訳のレンダリング, 18.1.3

アップグレード, 7.9.1.5

「アプリケーションの別名」属性, 7.2.1.2.1 アプリケーション属性

可用性, 7.2.4.2.5

ビルド・オプション, 7.2.1.2.7

データベース・セッション, 7.2.2.2.7

編集, 7.2.1

エラー処理, 7.2.1.2.4

エクスポート, 16.5.3

JavaScript, 7.2.4.2.3

ロゴ, 7.2.4.2.2

置換, 7.2.1.2.6

アプリケーション・ビルダー

アクセス, 6.1

ホームページ, 6.2

ページ定義, 2.2

ユーティリティ, 7.9.1

アプリケーション・ビルダーのホームページ, 6.1, 6.2 アプリケーション・ビルダー・ユーティリティ

アドバイザ, 7.9.1.1

アプリケーション・ダッシュボード, 7.9.1.1

Application Expressビュー, 7.9.1.1

変更履歴, 7.9.1.1

データベース・オブジェクトの依存性, 7.9.1.1

デバッグ・メッセージ, 7.9.1.1

エクスポート・リポジトリ, 7.9.1.1

属性ディクショナリの管理, 7.9.1.1

最近更新されたページ, 7.9.1.1

アプリケーションのアップグレード, 7.9.1.1

アプリケーションの計算

概要, 8.9.1

アプリケーションの計算ページ, 8.9.2.1

作成, 8.9.2

「新しいインスタンス開始時」の実行, 8.9.1.1

履歴レポート, 8.9.3

アプリケーション・ダッシュボード, 7.9.1.2

表示, 7.9

「アプリケーション日付書式」属性, 7.2.3.2.3 「アプリケーションの日時書式」属性, 7.2.3.2.4 アプリケーション定義, 編集, 7.2.1 Application Express管理サービス, 1.4.2 Application Expressビュー, 7.9.1.7 アプリケーション・グループ, 7.6.1 アプリケーション・グループの属性, 7.2.1.2.1 「アプリケーション」ホームページ, 6.3

データベース・アプリケーション・ページの追加, 7.3.2

データベース・アプリケーション・ページのコピー, 7.3.4

「エクスポート/インストール」アイコン, 3.3.3.2, 6.3

「アプリケーションの実行」アイコン, 3.3.3.2, 6.3

「共有コンポーネント」アイコン, 3.3.3.2, 6.3

アプリケーション・ホームの「タスク」リスト

このアプリケーションのコピー, 6.3

このアプリケーションの削除, 6.3

アプリケーション・アイテム

概要, 7.7.1, 7.8

作成, 7.8.1

グローバル変数の作成, 7.8.4

属性の編集, 7.8.3

履歴, 7.8.2

アプリケーション・アイテム・ページ, 7.8.1.1 アプリケーション言語, 7.2.3 「アプリケーション言語の派生元」属性, 7.2.3.2.2, 18.2 アプリケーション・レイアウト

印刷プレビュー・モード, 10.13

ショートカット, 10.7

アプリケーション・モデル, 7.1.7

利用, 7.1.7.1

「アプリケーションのプライマリ言語」属性, 7.2.3.2.1, 18.2 アプリケーション・プロセス

アプリケーション・プロセス・ページ, 8.8.3.1, 8.8.3.1

作成, 8.8.3

エラー・メッセージの作成, 8.8.5

属性の編集, 8.8.4

例, 8.8.2

オンデマンド, 8.8.1

レポート, 8.8.6

理解, 8.8

アプリケーションのタイムスタンプ書式, 7.2.3.2.5 アプリケーションのタイムスタンプ・タイムゾーン書式, 7.2.3.2.6 「アプリケーション・ユーティリティ」アイコン, 6.3.1.4, 8.1.8.1.3 アーキテクチャ, 1.2 属性ディクショナリ, 8.10 認証, 2.3.3, 15.4

「認証スキーム履歴」レポート, 15.4.8.2

「認証スキームのサブスクリプション」レポート, 15.4.8.1

認証スキーム・リポジトリ, 15.4.5

変更, 15.4.6, 15.4.7

認証スキームの作成, 15.4.3

既存のスキームの管理, 15.4.5

事前構成された認証スキーム, 15.4.4

レポート, 15.4.8

セキュリティ属性, 7.2.2.2.1

カレント・スキームの表示, 15.4.6

「認証スキーム」属性, 7.2.2.2.1 認証スキーム

Application Expressアカウント, 15.4.4.1

Cookieユーザー・アカウント, 15.4.4.1

「カスタム」認証, 15.4.4.2

DAD資格証明, 15.4.4.6

データベース・アカウント, 15.4.4.3

HTTPヘッダー変数, 15.4.4.4

LDAP資格証明, 15.4.4.5

公開資格証明, 15.4.4.7

シングル・サインオン, 15.4.4.8

認可, 2.3.4 「認可」属性, 7.2.2.2.2 認可スキーム

アプリケーションへの割当て, 15.5.3.1

コンポーネントへの割当て, 15.5.3.3

コントロールへの割当て, 15.5.3.3

ページへの割当て, 15.5.3.2

「コンポーネント別」レポート, 15.5.4.2

履歴レポート, 15.5.4.4

アプリケーション, 7.2.2.2.2

レポート, 15.5.4

指定, 7.2.2.2.2

「サブスクリプション」レポート, 15.5.4.1

使用状況レポート, 15.5.4.3

認可スキーム, 15.5.1

アプリケーションへの割当て, 15.5.3.1

コンポーネントへの割当て, 15.5.3.3

コントロールへの割当て, 15.5.3.3

ページへの割当て, 15.5.3.2

作成, 15.5.2

アクセス制御, 10.10.4

「自動CSVエンコーディング」属性, 7.2.3.2.10 自動タイムゾーン, 7.2.3.2.9

B

バックグラウンドPL/SQL, 17.6

プロセスの使用, 17.6.2

バインド変数

構文, 2.6.4

リージョンでの使用, 2.6.4.1

PL/SQLに基づいたリージョンでの使用, 2.6.4.2

BLOB

概要, 17.10.1

表示, 17.10.1.2

ファイルのアップロードとダウンロード, 17.10.1.1

BLOB

APEX_UTIL.GET_BLOB_FILE_SRC, 17.10.3

表示, 17.10.2.2

サポートのダウンロード, 17.10.1

移入, 17.10.1

イメージ参照の削除, 17.10.1.3

フォームでのサポート, 17.10

レポートでのサポート, 17.10.2

ブランチ

概要, 8.6

作成, 11.5, 11.5.1

「対象ボタン」属性, 2.7.2.22.3

ブランチ

アクション, 8.6.1

ブランチ・ポイント, 8.6.1

「ブランチ・ポイント」リスト, 8.6.1

条件付き, 8.6.2

ロード時, ヘッダーの前, 8.6.1

送信時, プロセスの後, 8.6.1

送信時, 計算の前, 8.6.1

送信時, プロセスの前, 8.6.1

送信時, 検証の前, 8.6.1

ボタンの使用, 10.5.5

ブレッドクラム・レポート, 11.3.6

ブレッドクラムの例外, 11.3.6

ブレッドクラム階層, 11.3.6

ブレッドクラム履歴, 11.3.6

ブレッドクラムの使用状況, 11.3.6

ブレッドクラムのグリッド編集, 11.3.6

ブレッドクラム・テンプレート, 13.2.6

コメント, 13.2.6.2.6

定義, 13.2.6.2.4

名前, 13.2.6.2.1

サブスクリプション, 13.2.6.2.2

置換文字列, 13.2.6.2.7

テンプレート属性, 13.2.6.2.5

テンプレート・タイプ, 13.2.6.2.3

ブレッドクラム, 8.1.7.3

概要, 11.3.1

ブレッドクラム・リージョンの追加, 11.3.2.2.4

エントリの追加, 11.3.2.2.3, 11.3.2.2.3

ページへの追加, 11.3.2.2.4

作成, 11.3, 11.3.2

動的の作成, 11.3.2.2.5, 11.3.2.2.5

未使用の削除, 11.3.5

編集, 11.3.3

ナビゲーション, 13.2.6.1

エントリの親の変更, 11.3.4

共有コンポーネント, 8.1.7.3

「参照」ボタン, A.1 バグ

ファイルの添付, 4.5.4

バグ・ダッシュボード, 4.5.5.1

バグ・ページ, 4.5.1.1

日別ページ, 4.5.5.4

開発者別ページ, 4.5.5.3

カレンダ・ページ, 4.5.5.2

作成, 4.5.2

編集, 4.5.3

管理, 4.5

レポート, 4.5.5

表示, 4.5.1

ビルド・オプション, 16.10

ステータスの変更, 16.10.2

作成, 16.10.1

除外, 16.10.2

エクスポート, 16.10.3

ステータスのエクスポート, 16.10.3

含める, 16.10.2

レポート, 16.10.4

「ビルド・オプション」属性, 7.2.1.2.7 「ビルド・ステータス」属性, 7.2.1.2.3 組込み置換文字列, 2.7.2 「アイテム・ヘルプをバルク編集」レポート, 10.14.2.3 ボタン

概要, 8.1.5.3

ブランチ処理, 10.5.5

作成, 10.5, 10.5.1

コンポーネント・ビューでの作成, 10.5.1.1

ツリー・ビューでの作成, 10.5.1.2

一度に複数を作成, 10.5.2

複数を削除, 10.5.3.2.1

条件付きの表示, 10.5.6

編集, 10.5.3

属性の編集, 10.5.3.1

複数を編集, 10.5.3.2

名前, 10.5.4

テンプレート, 13.2.7

ボタン・テンプレート

コメント, 13.2.7.1.4

定義, 13.2.7.1.3

名前, 13.2.7.1.1

サブスクリプション, 13.2.7.1.2

置換文字列, 13.2.7.1.5

C

リージョンのキャッシュ, 12.3.3.5

カレンダ

「簡易カレンダ」について, 10.2.1

「SQLカレンダ」について, 10.2.1

属性へのアクセス, 10.2.5.1

ページへの「簡易カレンダ」の追加, 10.2.3.1

新しいページへの「簡易カレンダ」の追加, 10.2.3.2

ページへの「SQLカレンダ」の追加, 10.2.4.1

新しいページへの「SQLカレンダ」の追加, 10.2.4.2

SQLへの簡単な変換, 10.2.10

作成, 10.2

列リンクの作成, 10.2.5.2.3

日付リンクの作成, 10.2.5.2.4

「簡易カレンダ」の作成, 10.2.3

「SQLカレンダ」の作成, 10.2.4

カレンダの間隔の定義, 10.2.5.2.2

表示属性の定義, 10.2.5.2.2

属性の編集, 10.2.5

タイトルの編集, 10.2.8

ドラッグ・アンド・ドロップの有効化, 10.2.3.2, 10.2.4.1

ドラッグ・アンド・ドロップの有効化, 10.2.7

書式設定, 10.2.5.2.1

追加および編集ファンクションの追加, 10.2.6

サポートされる置換文字列, 10.2.1.2

タイプ, 10.2.1

アップグレード, 10.2.9

サンプルの表示, 10.2.2

カレンダ属性

アクセス, 10.2.5.1

カレンダ表示, 10.2.5.2.1

列リンク, 10.2.5.2.3

日付のリンク, 10.2.5.2.4

表示属性, 10.2.5.2.2

カレンダ・テンプレート, 13.2.8

コメント, 13.2.8.2.3

日次カレンダ, 13.2.8.2.3

月別カレンダ, 13.2.8.2.3

名前, 13.2.8.2.1

テンプレートのサブスクリプション, 13.2.8.2.2

週間カレンダ, 13.2.8.2.3

カスケード・スタイルシート

概要, 13.2.1

エクスポート, 16.5.7

インポート, 16.6.4

SVGチャートの参照, 10.4.4.3

ページ・テンプレートでの参照, 13.3.2

インラインの参照(SVGチャート) , 10.4.4.4

アップロード, 13.3.1

カスタムの使用, 13.3

「変更履歴」レポート, 7.9.1.3 文字の値の比較, 7.2.3.2.7 文字の値の比較動作, 7.2.3.2.8 チャート

Flashの概要, 10.4.3.1

ウィザードについて, 10.3.4, 10.4.1

表示の変更, 10.4.6

非同期更新, 10.4.9

ローソク足構文, 10.4.1

作成, 10.4

ダイアル・チャート構文, 10.4.1

他の言語での表示, 10.4.4.5

属性の編集, 10.4.6

Flash, 10.4.3

ガント構文, 10.4.1

HTMLチャート, 10.4.5

HTML5チャート, 10.4.2

HTML5チャートの概要, 10.4.2.1

SVGのFlashへの移行, 10.4.4.1.2

監視情報, 10.4.9

複数シリーズ構文, 10.4.1

SQL問合せの指定, 10.3.4, 10.4.1

範囲構文, 10.4.1

スキャッタ構文, 10.4.1

SQL問合せ構文, 10.4.1

SVGチャート, 10.4.4

タイプ, 10.3.4, 10.4.1

SVGチャートのHTML5へのアップグレード, 10.4.4.1.2

すべてのSVGチャートのHTML5へのアップグレード, 10.4.4.1.3

チェック・ボックス, A.1

依存LOVの作成, 7.7.3.4

クラシック・レポート

ダウンロード・リンクの追加, 9.5.5

列ブレークの制御, 9.5.12

列表示の制御, 9.5.11

更新可能な列の作成, 9.5.9

LOVとして列を定義, 9.5.10

エクスポート, 9.5.7

列の順序とリージョン・ソースの同期化, 9.5.13, 10.1.2.5

クラシック・レポート・リージョン

出力属性の構成, 9.6.6

出力メソッド, 9.6.3

クラシック・レポート

変更, 9.5

位置の変更, 9.5

列属性の変更, 9.5

列テキストの変更, 9.5

ページ区切りの変更, 9.5.3

合計の作成, 9.5

列の非表示, 9.5

列のソート, 9.5

コレクション, 17.4 カラー・ピッカー, A.1 列テンプレート, JavaScriptの使用, 13.2.14.4 「コメント」属性, 8.2.2.14 「互換性モード」属性, 7.2.1.2.2 コンポーネント

認可スキームの割当て, 15.5.3.3

コンポーネント設定

編集, 17.14.1

管理, 17.14

履歴レポートの表示, 17.14.2

「コンポーネント」ビュー, 8.1.4

「すべて編集」アイコン, 8.1.4.1.1

「ページ・プロセス」アイコン, 8.1.4.3

「ページ・レンダリング」アイコン, 8.1.4.2

「共有コンポーネント」アイコン, 8.1.4.4

コンポーネント

翻訳について, 18.1.4

キーボードを使用したアクセス, E.5

アクセス制御, 2.3.4

すべてのページでの表示, 12.2

各ページでの表示, 12.1

メッセージの翻訳, 18.4, 18.4.1, 18.4.2

条件タイプ, 2.3.2 条件付き

処理, 2.3.2

レンダリング, 2.3.2

条件

リージョンの表示, 12.3.3.2

リスト, C

使用, 2.3.2

ボタンでの使用, 10.5.6

構成, 制御, 16.10 「コンテンツ配信ネットワーク」属性, 7.2.4.2.1 コントロール, アクセスの制御, 2.3.4 アプリケーションの作成ウィザード, 2.1 ブランチの作成ウィザード, 11.5, 11.5.1 ブレッドクラムの作成ウィザード, 11.3.2.2 ボタンの作成ウィザード, 10.5.1 ナビゲーション・バー・エントリの作成ウィザード, 11.4.2.1, 11.4.2.2, 11.4.2.3 ページ計算の作成ウィザード, 8.3.1, 17.7.12 ページ・プロセスの作成ウィザード, 8.5.1 ページの作成ウィザード, 7.3.1 リージョンの作成ウィザード, 10.2.3.1, 10.2.4.1, 10.3.2, 10.4.2.2, 10.4.3.2, 11.2.5, 11.3.2.2.4, 12.3.1, 12.3.1, 12.3.4 検証の作成ウィザード, 8.4.1.1, 8.4.1.2, 8.4.1.3, 8.4.1.4 クロス・ページ・ユーティリティ

アクセス, 7.9.3.1

すべてのページのグリッド編集, 7.9.3.3, 7.9.3.4, 7.9.3.6, 7.9.3.7

ページ属性, 7.9.3.5

最近更新されたページ, 7.9.3.2

「クロス・ページ」ユーティリティ, 7.9.3 クロスサイト・スクリプティング

概要, 15.2.3

動的出力, 15.2.3.2

フォーム・アイテム, 15.2.3.4

HTMLリージョン, 15.2.3.1

レポート・リージョン, 15.2.3.3

アイテムでの文字の制限, 15.2.3.5

静的表示領域, 15.2.3.1

CSSクラス, SVGチャート, 10.4.4.2 「CSSファイルURL」属性, 7.2.4.2.4 CSSファインダ, 10.9 CSSリポジトリ, 13.3.1.1 カスタム・パッケージ・アプリケーション

概要, 16.4.1

サポートするオブジェクト・ページの概要, 16.4.2.2

アクセス制御リストの追加, 16.4.4

CSSインストール・スクリプトの追加, 16.4.3

イメージのインストール・スクリプトの追加, 16.4.3

静的ファイルのインストール・スクリプトの追加, 16.4.3

ビルド・オプション, 16.4.2.2.1

サポートするオブジェクトの作成, 16.4.2

アップグレード・スクリプトの定義, 16.4.7.1

削除スクリプト, 16.4.2.2.3

削除, 16.4.8

インストール・オプションの削除, 16.4.6

メッセージの削除, 16.4.6

サポートするオブジェクトのスクリプトの削除, 16.4.6

作成方法, 16.4

インストール・スクリプト, 16.4.2.2.1

サポートするオブジェクトのインストール, 16.4.5

メッセージ, 16.4.2.2.1, 16.4.2.2.3

前提条件, 16.4.2.2.1

置換文字列, 16.4.2.2.1

インストール・スクリプトのテスト, 16.4.5

アップグレード・メッセージ, 16.4.2.2.2

アップグレード・スクリプト, 16.4.2.2.2

アップグレード, 16.4.7.2

検証, 16.4.2.2.1

インストール・サマリーの表示, 16.4.9

D

データ

追加について, 5.7

データ・グリッドについて, 5.7.1

編集について, 5.7

レポートについて, 5.7.1

Webシート・ページへの組込み, 5.7.3

データ・グリッド

データ・ページヘのアクセス, 5.6.4.1

単一データ行への注釈の追加, 5.6.4.5.1

新しい列の追加, 5.6.4.3

行の追加, 5.6.4.4

コピー, 5.6.3

作成, 5.6.2

ブックマーク・リンクの作成, 5.6.4.7

値リストの作成, 5.6.4.3

検証の作成, 5.6.4.3

列グループの作成, 5.6.4.3

削除, 5.6.6

列の削除, 5.6.4.3

行の削除, 5.6.4.4

編集, 5.6.4.2

列プロパティの編集, 5.6.4.3

手動での列の編集, 5.6.4.3

プロパティの編集, 5.6.4.6

手動での行の編集, 5.6.4.4

単一行の編集, 5.6.4.5

入力, 5.6.4.4

行の検索および置換, 5.6.4.4

列値の設定, 5.6.4.4

表示および編集, 5.6.4

履歴の表示, 5.6.5

データ・レポート

概要, 5.8.1

作成, 5.8.2

削除, 5.8.4

編集, 5.8.3, 5.9.2

表示, 5.8.3

データ・セクション, Webシートへの追加, 5.9.1 データベース・アプリケーション

概要, 2.1.1

ページの追加, 7.3

アプリケーション・モデル, 7.1.7

グループへの割当て, 7.6.3

問合せに基づく, 7.1.1

スプレッドシートに基づく, 7.1.2

コピー, 7.1.3

「アプリケーション」ホームページからのコピー, 7.1.3.2

アプリケーションの作成ウィザードでのコピー, 7.1.3.1

テンプレート・アプリケーションからの作成, 7.1.4

グループの作成, 7.6.2

表での作成, 7.1.1

削除, 7.1.6

グループ, 7.6.1

グループからの削除, 7.6.4

実行, 7.3.5

データベース・アプリケーション・グループ

ページの割当て, 7.6.3

作成, 7.6.2

グループ定義の編集, 7.6.2.1

削除, 7.6.5

ページの削除, 7.6.4

データベース・アプリケーション・ページ

追加, 7.3

グループへの割当て, 7.3.6.4

コピー, 7.3.4

作成, 7.3.1

アプリケーションのホームからの作成, 7.3.2

「開発者」ツールバーからの作成, 7.3.3

削除, 7.3.8

範囲の削除, 7.3.8.4

「ページ定義」からの削除, 7.3.8.1

複数の削除, 7.3.8.3

ページ属性の編集中に削除, 7.3.8.2

ロック・ステータスの判別, 7.3.7.1

グループ化, 7.3.6

ロック, 7.3.7, 7.3.7.2

管理, 7.3

競合の回避, 7.3.7

グループからの削除, 7.3.6.5

実行, 7.3.5

タイプ, 7.3.3.1

ロック解除, 7.3.7, 7.3.7.3

データベース・アプリケーション・ページ・グループ, 7.3.6.2

ページの割当て, 7.3.6.4

作成, 7.3.6.2

グループ定義の編集, 7.3.6.3

削除, 7.3.6.6

ページの削除, 7.3.6.5

表示, 7.3.6.1

データベース・リンク, 17.2 「データベース・オブジェクトの依存性」レポート, 7.9.1.6 データベース・スキーマ

アプリケーション, 7.2.2.2.3, 7.2.2.2.4

指定, 7.2.2.2.3, 7.2.2.2.4

「データベース・スキーマ」属性, 7.2.2.2.3, 7.2.2.2.4 「データベース・セッション」属性, 7.2.2.2.7 データベース・ユーザー

付与される権限, D.1

権限の付与, D.1

日付ピッカー, A.1 日付ピッカー(クラシック), A.1 DBMS_APPLICATION_INFO, 14.6 デバッグ, 14

エラーのチェック, 14.2

デバッグ・モード, 14.4

有効化および無効化, 14.4.1

問題の特定, 14.9

アプリケーションでの実行, 14.4.2

SQL問合せ, 14.8

SQLトレース, 14.5

f?pを使用したアクセス, 14.4.3

レポートの表示, 14.4.4

「デバッグ」属性, 7.2.1.2.2 ディープ・リンク, 15.4.4.2.4 「ディープ・リンク」属性, 7.2.2.2.1 定義, 17.7.1.2 エクスポート・ファイルの削除, 16.7.4 デモンストレーション・アプリケーション

サンプル・データベース・アプリケーションについて, 3.3

依存LOV, 7.7.3.4 デプロイ, 16.3

サポートするオブジェクトの作成, 16.4.2

ページのエクスポート, 16.5.5

Webシートのエクスポート, 16.5.6

アプリケーション定義のエクスポート, 16.5.2

カスケード・スタイルシートのエクスポート, 16.5.7

フィードバックのエクスポート, 16.5.13

イメージのエクスポート, 16.5.8

スクリプト・ファイルのエクスポート, 16.5.14

静的ファイルのエクスポート, 16.5.9

テーマのエクスポート, 16.5.10, 16.5.11

「ユーザー・インタフェースのデフォルト値」のエクスポート, 16.5.12

ワークスペースのエクスポート, 16.5.4

SQL*Plusからのアプリケーションのインポート, 16.7.5

エクスポート・ファイルのインポート, 16.6

ファイルのインポート, 16.6

アプリケーション・エクスポートのインストール, 16.7.2

ファイルのインストール, 16.7.3

データベース・オブジェクトの管理, 16.3.1

アプリケーション, 16.2

オプション, 16.2.1

アプリケーションのパッケージ化, 16.2

URLの公開, 16.8

Webシート・アプリケーションURLの公開, 16.9

開発者アクション・バー, 6.3.1 「開発者のコメント(バグまたはTo Do)」アイコン, 6.3.1.5, 8.1.8.1.4 開発者コメント

概要, 7.5

ページへの追加, 7.5.1

データベース・アプリケーションへの追加, 7.5.1

削除, 7.5.3

編集, 7.5.2

表示, 7.5.2

レポートの表示, 7.5.4

開発者コメントのカレンダ, 7.5.5 「開発者のコメント」レポート

アクセス, 7.5.4.1

コメントの削除, 7.5.4.3

複数のコメントの削除, 7.5.4.4

コメントの編集, 7.5.4.2

「開発者」ツールバー

概要, 3.3.3.1

データベース・アプリケーション・ページの作成, 7.3.3

「セッション」, 2.4.3

使用, 8.1.8.4

開発のライフ・サイクル, 16.1 開発プロセス

管理, 4

開発プロセス, 管理, 1.5, 4 ダイアル・チャート構文, 10.4.1 DML

ロックの概要, 17.1

APEX_DML_LOCK_WAIT_TIME, 17.1

DML操作の制御, 17.1

FSP_DML_LOCK_ROW, 17.1

ドキュメント・ライブラリ

概要, 1.6.1

アクセス, 1.6

ダウンロード, 1.6.2

検索, 1.6.1

マスター索引の使用, 1.6.1

動的アクション

TrueまたはFalseアクションの追加, 17.9.4

作成, 8.1.5.6, 17.9.2

デバッグ, 17.9.6

編集, 17.9.3

頻度と有効範囲, 17.9.5

実装, 17.9

理解, 17.9.1

動的リスト

概要, 11.2.3

最初から作成, 11.2.3.2

構文, 11.2.3.1

動的な翻訳, 18.5

E

アプリケーション定義の編集

フィードバックを許可, 7.2.1.2.2

アプリケーションの別名, 7.2.1.2.1

アプリケーション・グループ, 7.2.1.2.1

ビルド・ステータス, 7.2.1.2.3

互換性モード, 7.2.1.2.2

デバッグ, 7.2.1.2.2

電子メール送信者アドレス, 7.2.1.2.2

エラー処理, デフォルトのエラー表示位置, 7.2.1.2.4

エラー処理, エラー処理ファンクション, 7.2.1.2.4

グローバル通知, 7.2.1.2.5

ロギング, 7.2.1.2.2

使用できないアプリケーションに対するメッセージ, 7.2.1.2.3

「名前」属性, 7.2.1.2.1

プロキシ・サーバー, 7.2.1.2.2

アクセスの制限, 7.2.1.2.3

ステータス, 7.2.1.2.3

バージョン, 7.2.1.2.1

アプリケーションの編集・ページ

データベース・セッション, 7.2.2.2.7

グローバリゼーション属性の編集

アプリケーション日付書式, 7.2.3.2.3

アプリケーションの日時書式, 7.2.3.2.4

アプリケーション言語の導出元, 7.2.3.2.2

アプリケーションのプライマリ言語, 7.2.3.2.1

アプリケーションのタイムスタンプ書式, 7.2.3.2.5

アプリケーションのタイムスタンプ・タイムゾーン書式, 7.2.3.2.6

自動CSVエンコーディング, 7.2.3.2.10

自動タイムゾーン, 7.2.3.2.9

文字の値の比較, 7.2.3.2.7

文字の値の比較動作, 7.2.3.2.8

グローバリゼーション属性の編集ページ, 7.2.3 「ページの編集」アイコン, 6.3.1.2 ページ・アイテムの編集

認可スキーム, 7.7.4.3

特殊文字をエスケープ, 7.7.4.3

制限付き文字, 7.7.4.3

セッション・ステート保護, 7.7.4.3

バージョン, 7.7.4.3

セキュリティ属性の編集, 7.2.2

認証, 7.2.2.2.1

認可, 7.2.2.2.2

データベース・スキーマ, 7.2.2.2.3, 7.2.2.2.4

セッション・ステート保護, 7.2.2.2.5

電子メール

電子メール・ログ, 17.3

電子メール・キュー, 17.3

管理, 17.3

送信の問題, 15.1.8

「電子メール送信者アドレス」属性, 7.2.1.2.2 埋込みPL/SQLゲートウェイ

イメージ、CSSおよびスクリプト・ファイルの場所, 16.5.1.2

セキュリティの実行, 15.1.1

エンジン, 1.2 環境, 構成, 1.4.2 エラー・メッセージ

ページ・プロセス用の作成, 8.5.4

アプリケーション・プロセス用の作成, 8.8.5

エラー, 処理, 7.2.1.2.4, 8.2.2.12 エクスポート

アプリケーション, 16.5, 16.5.2

アプリケーション属性, 16.5.3

ビルド・オプション・ステータス, 16.5.3

CSS, 16.5.7

デフォルト, 16.5

フィードバック, 16.5, 16.5.13

ファイル, 16.5

イメージ, 16.5.8

データベース・オブジェクトの管理, 16.3.1

ページ, 16.5.5

ページ・コンポーネント, 16.5.3

プラグイン, 16.5.11

プラグイン, 16.5

関連ファイル, 16.5

スクリプト・ファイル, 16.5.14

共有コンポーネント, 16.5.3

静的ファイル, 16.5.9

翻訳用テキスト, 18.3.2

テーマ, 16.5, 16.5.10, 16.5.11

ユーザー・インタフェースのデフォルト値, 16.5.12

Webシート, 16.5, 16.5.6

ワークスペース, 16.5

ワークスペース, 16.5.4

「エクスポート」アイコン, 8.1.8.1.6 エクスポート・リポジトリ, 16.7.2, 16.7.3, 16.7.4

アクセス, 16.7.1

エクスポートしたアプリケーション, インポート, 16.6 「エクスポート/インストール」アイコン, 3.3.3.2, 6.3

F

f?p構文, 2.5.2

ブックマークの容易化, 2.5.5

機能

ファイルの添付, 4.2.4

カレンダ・ページ, 4.2.5.3

変更履歴ページ, 4.2.5.4

作成, 4.2.2

所有者別の機能ページ, 4.2.5.7

フォーカス領域ページ, 4.2.5.6

進捗ログ・ページ, 4.2.5.5

追跡, 4.2

ツリー・ページ, 4.2.5.2

更新, 4.2.3

ユーティリティ・ページ, 4.2.5.8

表示, 4.2.1

レポートの表示, 4.2.5

フィードバック

ページの追加, 4.6.2

アプリケーション別ページ, 4.6.4.3

ファイリング・ユーザー別ページ, 4.6.4.4

カレンダ・ページ, 4.6.4.2

フィードバック・ダッシュボード, 4.6.4.1

フィードバック・ページ, 4.6.1.1

レポート, 4.6.4

コメントの確認, 4.6.3

使用, 4.6.2.2

表示, 4.6.1

ファイル・アップロード表

セキュリティ・リスク, 15.3

「ファイルURL」属性, 7.2.4.2.3 ファイル

アップロードしたファイルの削除, 12.7.4

アップロードしたファイルのダウンロード, 12.7.3

アップロードしたファイルの編集, 12.7.2

管理, 12.7

アップロード, 12.7.1

「検索」アイコン, 6.3.1.6, 8.1.8.1.7, 10.9, 10.9.1 Flashチャート

既存のページへの追加, 10.4.3.2

新しいページへの追加, 10.4.3.3

ローソク足構文, 10.4.1

ガント構文, 10.4.1

複数シリーズ構文, 10.4.1

範囲構文, 10.4.1

ローカルへの保存, 10.4.7

スキャッタ構文, 10.4.1

HTML5への切替え, 10.4.3.8

すべてのFlashチャートのFlash 6へのアップグレード, 10.4.3.4

Flash 3からFlash 6へのアップグレード, 10.4.3.6

Flash 3チャートのHTML5へのアップグレード, 10.4.3.7

FlashチャートのHTML5へのアップグレード, 10.4.3.5

カスタムXMLの使用, 10.4.8

フッター, 置換文字列, 12.3.3.3 フォームのオートコンプリート, 8.2.2.8 フォーム・ウィザード

Webサービスのフォームとレポート, 10.1.1

プロシージャのフォーム, 10.1.1

SQL問合せのフォーム, 10.1.1

レポート付きの表のフォーム, 10.1.1

表またはビューのフォーム, 10.1.1

Webサービスのフォーム, 10.1.1

マスター・ディテール・フォーム, 10.1.1

サマリー・ページ, 10.1.1

表形式フォーム, 10.1.1

フォーム

JAWSを使用したアクセス, E.4

行の自動処理(DML)プロセス, 10.1.4.2

作成, 10.1

マスター・ディテールの作成, 10.1.3

表形式フォームの作成, 10.1.2

手動作成, 10.1.4

ウィザードを使用した作成, 10.1.1

ページ・タイプ, 10.1.1

移入, 10.1.4.5

タイプ, 10.1.1

プロセスの理解, 10.1.4.1

入力の検証, 10.1.5

完全開発環境, 1.2 ファンクション, 検索, 10.9.6

G

「グローバル通知」属性, 7.2.1.2.5

グローバル・ページ, 12.2

作成, 12.2.1

ナビゲーション, 12.2.2

グローバル変数, 作成, 7.8.4 グローバル化

属性, 18.2

アプリケーション言語の決定, 7.2.3

書式マスク, 18.2.1

理解, 18.1

グラフィック

管理, 12.6

参照, 12.6.2

アップロード, 12.6.1

グループ化, 編集, 9.3.14.2 グループ

アプリケーション, 7.6

データベース・アプリケーション・ページ, 7.3.6

H

ヘルプ

アクセス, 1.6

作成, 10.14

ナビゲーション・バー・エントリの作成, 10.14.3

編集, 10.14.2.3

検索, 1.6

使用, 1.6

「ヘルプ」アイコン, 6.3.1.7 ヘルプ・テキスト

JAWSを使用したアクセス, E.4.3

アイテムの定義, 10.14.2.2

ページの定義, 10.14.2.1

バルク編集, 10.14.2.3

アイテムの編集, 10.14.2.3

アイテム・ラベルの検索, 10.14.2.3.4

トピックの検索, 10.14.2.3.3

シード, 10.14.2.3.2

非表示アイテム, A.1 「ハイ・コントラスト」モード, E.2 「ハイ・コントラスト」モード

概要, E.2.1

有効化, E.2.2

HTML

カスタムPL/SQLを使用した生成, 12.8

Application Expressの処理対象外, 12.8

HTMLチャート

すべてのチャートのHTML5へのアップグレード, 10.4.5.2

HTML5へのアップグレード, 10.4.5.1

HTMLパスワード・フォーム要素, A.1 HTMLテキスト領域, A.1 HTML5チャート

概要, 10.4.2.1

新しいページへの追加, 10.4.2.3

既存ページへの追加, 10.4.2.2

複数シリーズ構文, 10.4.1

Flashチャートへの切替え, 10.4.2.4

カスタムXMLの使用, 10.4.8

I

イメージ・ファインダ, 10.9

イメージ接頭辞, 12.6.2

「イメージ接頭辞」属性, 7.2.4.2.1

イメージ・リポジトリ, 12.6, 12.6.1

イメージ, URLからの表示, A.1

イメージ

エクスポート, 16.5.8

インポート, 16.6.5

管理, 12.6

参照, 12.6.2

検索, 10.9.7

アップロード, 12.6.1

使用可能の表示, 10.9.7

イメージ・ファインダ, 10.9.7 実装

プラグイン, 17.8

インポート

フィードバック, 16.6.9

Webシート, 16.6.2

インポート

アプリケーション, 16.6.1

SQL*Plusを使用するアプリケーション, 16.7.5

カスケード・スタイルシート, 16.6.4

エクスポート・ファイル, 16.6, 16.6

イメージ, 16.6.5

ページ, 16.6.1

プラグイン, 16.6.3

静的ファイル, 16.6.6

テーマ, 16.6.7

ユーザー・インタフェースのデフォルト値, 16.6.8

「レガシーJavaScriptを含める」属性, 7.2.4.2.3 インジェクション攻撃, アイテムでの文字の制限, 15.2.3.5 インストール

アプリケーション・ファイル, 16.7.2

エクスポート・ファイル, 16.7.3

アプリケーション・エクスポートのインストール, 16.7.2 エクスポート・ファイルのインストール, 16.7.3 対話モード・レポート・リージョン

出力属性の構成, 9.6.7

対話モード・レポート

概要, 9.1

「列ヘッダー」メニューの概要, 9.3.3

リンク列について, 9.4.8

検索バーについて, 9.3.1

「アクション」メニュー, 9.3.4

計算の追加, 9.3.11

ダウンロード・オプションの追加, 9.4.7

フィルタの追加, 9.3.6

ハイライトの追加, 9.3.10

詳細属性, 9.4.15

列の集計, 9.3.12

属性のページ, 9.4.1

ページ区切りの変更, 9.4.4

列属性, 9.4.2

チャートの作成, 9.3.13

列リンクの作成, 9.4.9

ブレーク制御の作成, 9.3.9

グループの作成, 9.4.3

LOVとして列を定義, 9.4.11

開発者としての削除, 9.4.18.2

プライベート・レポートの削除, 9.3.16.6

パブリック・レポートの削除, 9.3.16.6

条件付きの表示, 9.4.10

ダウンロード, 9.3.18

代替デフォルト・レポートの編集, 9.4.18.1

開発者としての編集, 9.4

電子メール送信者アドレス, 9.4.15

「アイコン」ビューの有効化, 9.4.13

Flashback問合せの実行, 9.3.15

エクスポート, 9.4.7

列の書式設定, 9.4.12

列のグループ化, 9.3.14

リンク付け, 9.4.16

開発者としての管理, 9.4.18

列のソートの管理, 9.4.5

リージョン別名, 9.4.15

代替デフォルト・レポートの名前変更, 9.4.18.1

プライベート・レポートの名前変更, 9.3.16.5, 9.4.18.1

パブリック・レポートの名前変更, 9.3.16.5, 9.4.18.1

レポートIDアイテム, 9.4.15

リセット, 9.3.17

保存, 9.3.16

代替の保存, 9.3.16.4

プライベートとして保存, 9.3.16.3

パブリックとして保存, 9.3.16.3

プライマリ・デフォルトの保存, 9.3.16.4

「検索列の選択」アイコン, 9.3.2

列のソート順序の選択, 9.3.8

表示する列の選択, 9.3.5

ソート順序の選択, 9.3.8

ページごとの行数の指定, 9.3.7

サブスクライブ, 9.3.19

ユーザーの保存オプション, 9.3.16.1

使用, 9.3

JAWSの使用, E.3

開発者としての表示, 9.4.18.2

保存済のレポートのアクティビティの表示, 9.4.19

アイテム

概要, 8.1.5.4

アプリケーション・アイテム・ページ, 7.8.1.1

条件付き, 7.7.6

複数選択リスト・アイテム, 7.7.7

ネーミング規則, 7.7.3.1

読取り専用, 7.7.6

JavaScriptを使用した参照, 10.11.1

値の参照, 7.7.5

検索, 10.9.2

翻訳時に書式マスクを使用, 18.2.1

アイテム属性

レイアウトへの影響, 12.4

列スパン, 12.4

列, 12.4

列属性, 12.4

条件タイプと式, 12.4

横/縦の位置合せ, 12.4

HTML表のセル属性, 12.4

ラベル, 12.4

要素の後のテキスト, 12.4

要素の前のテキスト, 12.4

読取り専用条件タイプ, 12.4

リージョン, 12.4, 12.4

行スパン, 12.4

順序, 12.4

新規グリッドの開始, 12.4

新規行の開始, 12.4

アイテム・ファインダ, 10.9, 10.9.2 アイテム・ヘルプ, 7.2.1.2.3

編集, 10.14.2.3

アイテム・タイプ

チェック・ボックス, A.1

カラー・ピッカー, A.1

日付ピッカー, A.1

日付ピッカー(クラシック), A.1

イメージの表示, A.1

表示のみ, A.1

ファイル参照, A.1

非表示, A.1

リスト・マネージャ, A.1

数値フィールド, A.1

パスワード, A.1

ポップアップLOV, A.1

ラジオ, A.1

リッチ・テキスト・エディタ, A.1

選択リスト, A.1

シャトル, A.1

スライダ, A.1

テキスト領域, A.1

J

JavaScript, 13.2.11.1, 13.2.11.1

アプリケーション属性, 7.2.4.2.3

ボタンからのコール, 10.11.5

行テンプレート内, 13.2.14.4

「HTMLヘッダー」属性に追加, 10.11.2

.jsファイルに追加, 10.11.4

ページ・テンプレートに追加, 10.11.4

組込み, 10.11

ライブラリ, 13.2.11.1

参照アイテム, 10.11.1

jQueryライブラリの参照, 10.12.2

アイテムへのフォーカスの設定, 8.2.2.2

プラグインでの使用, 10.12.2.2

jQueryの使用, 10.12.2.1

JavaScriptファインダ, 10.9 JAWS, E

検証エラーについて, E.4.4

フォームへのアクセス, E.4

ヘルプ・テキストへのアクセス, E.4.3

対話モード・レポートへのアクセス, E.3

「タスク」リンクへのアクセス, E.4.2

jQuery

サポート, 10.12

JavaScriptでの使用, 10.12.2.1

jQuery UI

他のjQuery UIコンポーネントへのアクセス, 10.12.1.1

使用可能な機能, 10.12.1

サポート, 10.12

L

ラベル・テンプレート

#CURRENT_ITEM_HELP_TEXT#, 13.2.9.2

コメント, 13.2.9.1.7

ページ・アイテム・ヘルプの作成, 13.2.9.2

定義, 13.2.9.1.3

編集, 13.2.9

エラー表示, 13.2.9.1.4

フィールド・コンテナ, 13.2.9.1.5

名前, 13.2.9.1.1

サブスクリプション, 13.2.9.1.2

置換文字列, 13.2.9.1.6

言語

アプリケーションの定義, 18.2

マルチバイト, 18.2.2

プリファレンス, 18.1.1

レイアウト

リージョン属性について, 12.3.3.2

アイテム属性を使用した変更, 12.4

制御, 13

「詳細」リンク, 1.5 制限事項

クラシック・レポート, B.2

環境, B.1

フォーム, B.2

対話モード・レポート, B.2

アイテム名, B.2

表形式フォーム, B.2

検証, B.2, B.2

リンク列

概要, 9.4.8

除外, 9.4.8.4

単一行ビューのリンク, 9.4.8.1

ページへのリンク, 9.4.8.2

URLへのリンク, 9.4.8.3

リンク

ディープ,概要, 15.4.4.2.4

リスト

動的について, 11.2.3

リスト・タイプについて, 11.2.1

静的について, 11.2.2

ページへの追加, 11.2.5

コピー, 11.2.4

アプリケーション間のコピー, 11.2.4.2

カレント・アプリケーションからのコピー, 11.2.4.1

作成, 11.2

階層の作成, 13.2.10.1

編集, 11.2.6

属性の編集, 11.2.6

リスト・ページ, 11.2.6

レポート, 11.2.7

リスト・マネージャ, 依存LOVの作成, 7.7.3.4 値リスト, 8.1.7.2

静的LOVのバルク編集, 10.6.3.2

作成, 10.6

アプリケーション・レベルでの作成, 10.6.1

編集, 10.6.3

「LOV履歴」レポート, 10.6.5.7

LOVページ, 10.6.1.1

「LOVのサブスクリプション」レポート, 10.6.5.5

名前付き, 10.6.1

セッション・ステートの参照, 10.6.4

レポート, 10.6.5

「動的LOVの検索」レポート, 10.6.5.4

共有, 10.6.1

静的, 10.6.2

翻訳, 18.5

LOVページ, 10.6.1.1 リスト・レポート

条件付きエントリ, 11.2.7

履歴, 11.2.7

未使用, 11.2.7

使用状況, 11.2.7

リスト・テンプレート

リスト後のエントリ, 13.2.10.2.9

サブリスト後のエントリ, 13.2.10.2.8

リスト前のエントリ, 13.2.10.2.3

サブリスト前のエントリ, 13.2.10.2.6

コメント, 13.2.10.2.11

編集, 13.2.10

名前, 13.2.10.2.1

サブリスト・エントリ, 13.2.10.2.7

サブスクリプション, 13.2.10.2.2

置換文字列, 13.2.10.2.10, 13.2.11.2.13

テンプレート定義, 13.2.10.2.4

最初のエントリのテンプレート定義, 13.2.10.2.5

リスト, 8.1.7.4 用語のリスト, A.1 リスト・ページ, 11.2.6 リストウィザード, 11.2.2, 11.2.3 「ロック」アイコン, 8.1.8.1.5 ロック

ロック・ステータスの判別, 7.3.7.1

データベース・アプリケーション・ページ用, 7.3.7

「ロギング」属性, 7.2.1.2.2 ログイン, Oracle Application Express, 1.4.3 ログアウト, 1.4.3.5 ログイン資格証明, 1.4.3.2 ログイン・ページ, 1.4

構築, 15.4.4.2.3

ログイン資格証明の理解, 1.4.3.2

「ロゴ」属性, 7.2.4.2.2

M

マップ

Flashマップのサポートについて, 10.3.1

ページへの追加, 10.3.2

新しいページへの追加, 10.3.3

作成, 10.3

SQL問合せの作成, 10.3.4

マップ属性の編集, 10.3.5

非同期更新の有効化, 10.3.7

カスタムXMLの使用, 10.3.6

マスター・ディテール・フォーム, 作成, 10.1.3 メディアのタイプ属性, 7.2.4.2.1 使用できないアプリケーションに対するメッセージ, 7.2.1.2.3 メッセージ

翻訳, 18.4, 18.4.1

内部の翻訳, 18.4.2

PL/SQLプロシージャでのメッセージ, 18.4.1

翻訳, 18.4.1

レポートでのメッセージ, 18.4.2

翻訳, 18.4.2

マイルストン

所有者別ページ, 4.3.4.3

カレンダ・ページ, 4.3.4.2

作成, 4.3.2

マイルストン別の機能ページ, 4.3.4.4

マイルストン・ダッシュボード, 4.3.4.1

レポート, 4.3.4

追跡, 4.3

更新, 4.3.3

表示, 4.3.1

N

ナビゲーション

ブランチ, 11.5

ブレッドクラム, 11.3

リスト, 11.2

親タブ, 11.1

標準タブ, 11.1

タブ, 11.1

ツリー, 10.8.3

ナビゲーション・バー, 11.4 ナビゲーション・バー・エントリ, 11.4

概要, 11.4.1

コピー, 11.4.2.3

作成, 11.4.2

フィードバック用の作成, 11.4.2.2

最初から作成, 11.4.2.1

編集, 11.4.3

複数を編集, 11.4.4

履歴, 11.4.5.2

レポート, 11.4.5

ナビゲーション・バー・エントリ・レポート

履歴, 11.4.5.2

サブスクリプション, 11.4.5.1

新しいコンポーネント・ウィザード, 7.3.3, 10.10.2.3 ノート

Webシートへの追加, 5.13.3

Webシートからの削除, 5.13.3.2

編集, 5.13.3.2

数値フィールド, A.1

O

オンライン・ヘルプ, 1.6

問題, 15.1.8

検索, 1.6

Oracle Application Express

概要, 1.1

アーキテクチャ, 1.2

ブラウザ要件, 1.4.1

コンポーネントの制限, B.2

環境の構成, 1.4.2

環境の制限, B.1

ログイン, 1.4

開発者としてログイン, 1.4.3

ユーザー・ロール, 1.3

Oracle Application Express管理者, 1.3 Oracle Application Expressアドバイザ

概要, 14.2.1

アプリケーションの整合性のチェック, 14.2

アプリケーションでの実行, 14.2.2

単一ページ上での実行, 14.2.3

Oracle Application Expressエンジン, 1.2 Oracle Application Expressリスナー

CSSファイルの検索, 16.5.1.1

イメージの検索, 16.5.1.1

スクリプト・ファイルの検索, 16.5.1.1

Oracle BI Publisher, 統合, 15.1.4 Oracle HTTP Server

セキュリティについて, 15.1.2

イメージ、CSSおよびスクリプト・ファイルの検索, 16.5.1.1

Oracle XML DB HTTP Server, HTTP Serverポートの検証, 1.4.3.2.1

P

パッケージ・アプリケーション

認証の変更, 3.2.7

エクスポート, 3.2.6

インストール, 3.2.2

管理, 3.2

生産性アプリケーション, 3.1

削除, 3.2.4

実行, 3.2.3

サンプル・アプリケーション, 3.1

更新, 3.2.8

パッケージ・アプリケーション・ページ, 3.2.1

概要, 3.2.1

アクセス, 3.2.1

パッケージ, 検索, 10.9.6 ページ属性, 8.1.5.1

概要, 8.2

アクセス, 8.2.1

認証, 8.2.2.8, 8.2.2.8

認可スキーム, 8.2.2.8

キャッシュ, 8.2.2.10

ユーザー別のキャッシュ, 8.2.2.10

キャッシュ・ページ, 8.2.2.10

キャッシュ・ページ条件, 8.2.2.10

キャッシュ・タイムアウト, 8.2.2.10

コメント, 8.2.2.14

構成, 8.2.2.11

CSS, インライン, 8.2.2.4

カーソル・フォーカス, 8.2.2.2, 8.2.2.2

ディープ・リンク, 8.2.2.8

表示属性, 8.2.2.2

重複する送信, 8.2.2.9

エラー処理, 8.2.2.12

エラー処理ファンクション, 8.2.2.12

式1, 8.2.2.10, 8.2.2.10

ファイルURL, 8.2.2.4

フッター, 8.2.2.5, 8.2.2.6

グループ, 8.2.2.1

ヘッダーおよびフッター, 8.2.2.6

ヘッダー・テキスト, 8.2.2.5, 8.2.2.6

ヘルプ, 8.2.2.13

インライン・エラー通知テキスト, 8.2.2.12, 8.2.2.12

JavaScript, ページ・ロード時に実行, 8.2.2.3

JavaScript, ファイルURL, 8.2.2.3

JavaScript, ファンクションおよびグローバル変数の宣言, 8.2.2.3

名前, 8.2.2.1

ページの別名, 8.2.2.1

ページ・テンプレート, 8.2.2.2

読取り専用, 8.2.2.7

セキュリティ, 8.2.2.8

標準タブ・セット, 8.2.2.2

タイトル, 8.2.2.2

ページ・コンポーネント, アクセスの制御, 10.10.4 ページ計算

計算ポイント, 8.3.2

作成, 8.3.1

計算ポイントの定義, 8.3.3.1

計算ソースの定義, 8.3.3.1

属性の編集, 8.3.3

計算を条件付きにする, 8.3.3.2

構文, 8.3.2

ページ定義

概要, 2.2

コンポーネント・ビューについて, 8.1.2

「ツリー」ビューについて, 8.1.2

アクション・バー, 8.1.8.1

コンポーネント・ビューでの編集, 8.1.4

ツリー・ビューでの編集, 8.1.3

ページ・プロセス, 8.1.6

ページ・レンダリング, 8.1.5

コンポーネントの順序変更, 8.1.3.4

ページ・メタデータの検索, 6.3.2, 8.1.8.2

名前とラベルの切替え, 8.1.3.5

ビューの切替え, 8.1.2.1

表示, 8.1

ページ・ファインダ, 10.9 ページ・ヘルプ, 作成, 10.14 ページ・アイテム

概要, 7.7.1

セキュリティの構成, 7.7.4.3

選択した値の変換, 7.7.7.1

作成, 7.7, 7.7.3

シャトル・アイテムの作成, 7.7.7.2

「ページ定義」からの作成, 7.7.3.2

表形式フォームを使用して複数を作成, 7.7.3.5

デフォルト値の定義, 7.7.4.2

クイック選択の定義, 7.7.4.4

複数の削除, 7.7.4.5.3

条件付きでの表示, 7.7.6.1

読取り専用での表示, 7.7.6.2

属性の編集, 7.7.4.1

ページの表示の編集, 7.7.4.5.1

複数を編集, 7.7.4.5

複数選択リスト・アイテム, 7.7.7

ネーミング規則, 7.7.3.1, 7.7.3.1

リージョンへの再割当て, 7.7.4.5.2

値の参照, 7.7.5

静的LOV, 7.7.3.3

タイプ, A

ページ・アイテム, 表示, 7.7.2 ページ・レイアウト, 概要, 12.1 ページ番号, 8.1.4 ページ・プロセス

プロセス・ポイントの変更, 8.5.3

ソースの変更, 8.5.3

作成, 8.1.5.5, 8.5.1

エラー・メッセージの作成, 8.5.4

成功メッセージの作成, 8.5.4

属性の編集, 8.5.2

条件付き, 8.5.5

「対象ボタン」属性, 2.7.2.22.3

ページ・プロセス, 2.3.1

理解, 2.3

ページ・プロセス

概要, 8.1.6

ブランチ, 8.1.6.4

計算, 8.1.6.1

プロセス, 8.1.6.3

検証, 8.1.6.2

ページ・レンダリング, 2.3.1

理解, 2.3

ページ・レンダリング

概要, 8.1.5

ボタン, 8.1.5.3

動的アクション

概要, 8.1.5.6

アイテム, 7.7.2, 8.1.5.4 ページ, 8.1.5.1 プロセス, 8.1.5.5 リージョン, 8.1.5.2 ページ固有のユーティリティ

ブランチ・ユーティリティ, 7.9.2

ボタン・ユーティリティ, 7.9.2

計算ユーティリティ, 7.9.2

クロス・ページ・ユーティリティ, 7.9.2

動的アクション・ユーティリティ, 7.9.2

アイテム・ユーティリティ, 7.9.2

プロセス・ユーティリティ, 7.9.2

リージョン・ユーティリティ, 7.9.2

ページ固有のユーティリティ, 7.9.2 ページ・テンプレート

ボディ, 13.2.11.2.3

カスケード・スタイル・シート, 13.2.11.2.5

定義, 13.2.11.2.3

表示ポイント, 13.2.11.2.11

編集, 13.2.11

エラー・ページ・テンプレートの制御, 13.2.11.2.12

フッター, 13.2.11.2.3

グリッド・レイアウト, 13.2.11.2.10

ヘッダー, 13.2.11.2.3

イメージ・ベースのタブ属性, 13.2.11.2.9

JavaScript, 13.2.11.2.4

名前, 13.2.11.2.1

親タブ属性, 13.2.11.2.8

選択, 13.2.2

デフォルトの指定, 13.2.2.1, 13.2.2.2

標準タブ属性, 13.2.11.2.7

サブスクリプション, 13.2.11.2.2

置換文字列, 13.2.11

サブテンプレート, 13.2.11.2.6

ページ・テンプレート置換文字列, 13.2.11

#APP_VERSION#, 13.2.11.1, 13.2.11.1, 13.2.11.1, 13.2.11.1, 13.2.11.1, 13.2.11.1, 13.2.11.1, 13.2.11.1, 13.2.11.1, 13.2.11.1

#BOX_BODY#, 13.2.11.1

#FORM_CLOSE#, 13.2.11.1

#FORM_OPEN#, 13.2.11.1

#GLOBAL_NOTIFICATION#, 13.2.11.1

#HEAD#, 13.2.11.1

#LOGO#, 13.2.11.1, 13.2.11.1

#NAVIGATION_BAR#, 13.2.11.1

#NOTIFICATION_MESSAGE#, 13.2.11.1, 13.2.11.1, 13.2.11.1

#ONLOAD#, 13.2.11.1

#REGION_POSITION_NN#, 13.2.11.1, 13.2.11.1, 13.2.11.1, 13.2.11.1, 13.2.11.1, 13.2.11.1, 13.2.11.1, 13.2.11.1

#SUCCESS_MESSAGE#, 13.2.11.1

#TAB_CELLS#, 13.2.11.1, 13.2.11.1

#TITLE#, 13.2.11.1

ページ・ゼロ, 12.1 ページ, 認可スキームの添付, 15.5.3.2 ページ・レベル・アイテム

すべてのページ・アイテム, 7.7.4.5.4

条件付きアイテム, 7.7.4.5.4

すべてのアイテム・ヘルプ・テキストのグリッド編集, 7.7.4.5.4

すべてのアイテム・ラベルのグリッド編集, 7.7.4.5.4

履歴, 7.7.4.5.5

アイテム・ヘルプのサブスクリプション, 7.7.4.5.4

ユーティリティ, 7.7.4.5.4

ページ・レベル・テンプレート, 13.2.2.2 ページ

概要, 2.2

グローバル・ページの概要, 12.2

キャッシュ, 8.2.2.10

ボタンからのコール, 2.5.4

別名を使用したコール, 2.5.3

アクセス制御, 10.10.4

重複送信, 8.2.2.9

ユーザーによるカスタマイズの有効化, 12.3.3.4

エクスポート, 16.5.5

f?p構文を使用したリンク, 2.5.2

印刷用の最適化, 10.13

リソース使用, 14.6

検索, 10.9.3

ページ・テンプレートの指定, 13.2.2.2

ページ・ファインダ, 10.9.3 ページ区切りの挿入

クラシック・レポート, 9.5.3

対話モード・レポート, 9.4.4

レポート, 13.2.14.2.3, 13.2.14.3.5

ページ区切りサブテンプレート

次のページ・テンプレート, 13.2.14.3.6

次のセット・テンプレート, 13.2.14.3.6

ページ区切りテンプレート, 13.2.14.3.6

前のページ・テンプレート, 13.2.14.3.6

前のセット・テンプレート, 13.2.14.3.6

親タブ, 作成, 11.1 パスワード

変更, 1.4.3.4

リセット, 1.4.3.4

パスワードの複雑性, 15.1.5 「パスワード・アイテム」レポート, 15.2.2.2 パスワード

ベスト・プラクティス, 15.2.1

問題の識別, 15.2.2

パッチ, 作成, 16.5.3 PDF出力, 問題, 15.1.8 パフォーマンス・チューニング, 14.1 PL/SQLコード, 検索, 10.9.6 PL/SQLファインダ, 10.9 PL/SQL, バックグラウンドでの実行, 17.6 プラグイン

「プラグイン」について, 17.8.1

「プラグイン」へのアクセス, 17.8.2

イベントの追加, 17.8.7

プラグインの作成, 17.8.4

カスタム属性, 17.8.5

プラグインの削除, 17.8.8

プラグインの編集, 17.8.3

プラグインのエクスポート, 17.8.11

実装, 17.8

インポート, 16.6.3

プラグインのインポート, 17.8.10

プラグインのリセット, 17.8.12

関連付けられているファイルのアップロード, 17.8.6

JavaScriptコードの使用, 10.12.2.2

使用状況, 17.8.13

履歴の表示, 17.8.14

プラグイン・リポジトリの表示, 17.8.9

ポップアップLOV, A.1 ポップアップLOVテンプレート

アプリケーション, 13.2.12.1.1

ボタン, 13.2.12.1.5

編集, 13.2.12

アイコン, 13.2.12.1.3

ページ属性, 13.2.12.1.9

ページ区切り, 13.2.12.1.7

結果セット, 13.2.12.1.8

検索フィールド, 13.2.12.1.4

サブスクリプション, 13.2.12.1.2

ウィンドウ, 13.2.12.1.6

ポップアップLOV, 依存LOVの作成, 7.7.3.4 事前構成された認証スキーム, 15.4.4 印刷用テンプレート, 10.13 レポートの印刷, 9.6 権限

データベース・ユーザーへの付与について, D.1

データベース・ユーザーへの付与, D.1

PUBLICへの付与, D.2

プロシージャ・ファインダ, 10.9.6 プロシージャ, 検索, 10.9.6 プロセス

キャッシュ管理, 8.5.1.1, 8.5.1.2

データ操作, 8.5.1.1, 8.5.1.2

フォーム・ページ区切り, 8.5.1.1, 8.5.1.2

バックグラウンドPL/SQLの実装, 17.6.2

オンデマンド, 8.5.1.1, 8.5.1.2

PL/SQL, 8.5.1.1, 8.5.1.2

レポート・ページ区切り, 8.5.1.1, 8.5.1.2

Webサービス, 8.5.1.1, 8.5.1.2

生産性アプリケーション, ロック解除, 3.2.5 プログラミング手法

コレクション, 17.4

データベース・リンク, 17.2

Webサービスの実装, 17.7

バックグラウンドPL/SQLの実行, 17.6

プロキシ・サーバー, 17.7.1.2 「プロキシ・サーバー」属性, 7.2.1.2.2 PUBLIC

付与される権限, D.2

パブリック・シノニム, D.2 「パブリック・ユーザー」属性, 7.2.2.2.1

Q

問合せファインダ, 10.9, 10.9.4

問合せ, 検索, 10.9.4

R

ラジオ・グループ, A.1

LOV, 7.7.3.4

「最近更新されたページ」レポート, 7.9.1.4 リージョン

概要, 8.1.5.2

タイプの概要, 12.3.2

ユーティリティおよびレポートへのアクセス, 12.3.3.8.2

イメージの追加, 12.3.3.7

URLに基づく, 12.5

位置の制御, 12.3.3.2.1

コピー, 12.3.5

作成, 12.3.1, 12.3.1

リスト用の作成, 11.2.5

リージョン表示セレクタの作成, 12.3.4

サブリージョンの作成, 12.3.1.1

削除, 12.3.6

一度に複数のリージョンを削除, 12.3.6.1

条件付きの表示, 12.3.3.2

属性の編集, 12.3.3.1

複数のリージョンの属性の編集, 12.3.3.8.1

リージョン属性の編集, 12.3.3.1

カスタマイズの有効化, 12.3.3.4

ユーザーによるページのカスタマイズの可能化, 12.3.3.4

属性がレイアウトに与える影響, 12.3.3.2

静的リージョンIDの指定, 12.3.3.6

ヘッダーとフッターの指定, 12.3.3.3

理解, 12.3

リージョン属性

キャッシュ, 12.3.3.5

列, 12.3.3.2

列属性, 12.3.3.2

列スパン, 12.3.3.2

「条件タイプ」, 12.3.3.2

カスタマイズ, 12.3.3.2

表示ポイント, 12.3.3.2

式, 12.3.3.2

イメージ・タグ属性, 12.3.3.2

アイテム表示位置, 12.3.3.2

リージョンのCSSクラス, 12.3.3.2, 12.3.3.2

リージョン表示セレクタ, 12.3.3.2

リージョン・フッター, 12.3.3.2

リージョン・ヘッダー, 12.3.3.2

リージョン・イメージ, 12.3.3.2

順序, 12.3.3.2, 12.3.3.2

新規グリッドの開始, 12.3.3.2, 12.3.3.2

静的ID, 12.3.3.6

テンプレート, 12.3.3.2

リージョン表示セレクタ, 作成, 12.3.4 リージョン・テンプレート

コメント, 13.2.13.1.6

定義, 13.2.13.1.3

編集, 13.2.13

フォーム表属性, 13.2.13.1.4

名前, 13.2.13.1.1

「サブリージョン」属性, 13.2.13.1.5

サブスクリプション, 13.2.13.1.2

置換文字列, 13.2.13.1.7

リージョン・タイプ

カレンダ, 12.3.2

チャート, 12.3.2

フォーム, 12.3.2

ヘルプ・テキスト, 12.3.2

HTML, 12.3.2

リスト, 12.3.2, 12.3.2, 12.3.2

PL/SQL動的コンテンツ, 12.3.2

プラグイン, 12.3.2

レポート, 12.3.2

ツリー, 12.3.2

URL, 12.3.2

レポート列テンプレート

セル・ヘッダーのカラー化, 13.2.14.2.4

ヘッダーの省略, 13.2.14.2.4

レポート列テンプレート(汎用)

行の後, 13.2.14.2.8

各行の前, 13.2.14.2.5, 13.2.14.2.7

行の前, 13.2.14.2.3

列ヘッダー, 13.2.14.2.4

列テンプレート, 13.2.14.2.6

HTMLをすべての列の後に表示, 13.2.14.2.7

HTMLを最後の行の後に表示, 13.2.14.2.8

次のページ・テンプレート, 13.2.14.2.10

次のセット・テンプレート, 13.2.14.2.10

ページ区切りサブテンプレート, 13.2.14.2.10, 13.2.14.2.10

前のページ・テンプレート, 13.2.14.2.10

前のセット・テンプレート, 13.2.14.2.10

レポート・テンプレート, 13.2.14.2.1

行選択, 13.2.14.2.9

テンプレートのサブスクリプション, 13.2.14.2.2

レポート列テンプレート(名前付き)

行の前属性, 13.2.14.3.5

列ヘッダー・セルのカラー化, 13.2.14.3.4

列ヘッダー, 13.2.14.3.4

ページ区切りのサブテンプレート, 13.2.14.3.6

レポート・テンプレートの指定, 13.2.14.3.1

行テンプレート, 13.2.14.3.3

サブスクリプション, 13.2.14.3.2

レポート・レイアウト

概要, 9.6.5

コピー, 9.6.5.4

作成, 9.6.5.2

編集, 9.6.5.3

オプション, 9.6.5.1

レポート出力, 問題, 15.1.8 レポート問合せ

概要, 9.6.4

コピー, 9.6.4.3

作成, 9.6.4.1

編集, 9.6.4.2

レポート・リージョン

構成オプションの概要, 9.6.2

出力, 9.6

PDFへの出力, 9.6.1

レポート・テンプレート, 13.2.14

編集, 13.2.14

汎用列テンプレート, 13.2.14.1.1

名前付き列テンプレート, 13.2.14.1.2

JavaScriptの使用, 13.2.14.4

レポート, 13.2.4

概要, 9

データベース・アプリケーションについて, 7.9

アプリケーション・ダッシュボード, 7.9.1.2

アイテム・ヘルプをバルク編集, 10.14.2.3

変更履歴, 7.9.1.3

クラス参照, 13.1.10.4

列リンクの作成, 9.5.8

ウィザードを使用した作成, 9.2

CSVのエクスポート, 13.2.14.2.5

データベース・アプリケーション, 7.9

CSV形式へのエクスポート, 13.2.14.2.3, 13.2.14.3.5

ページ区切りを上に追加, 13.2.14.2.3, 13.2.14.3.5

出力, 9.6

最近更新されたページ, 7.9.1.4

列のソート, 9.5.4

SQL, 9.2

サポートされる置換文字列, 13.1.10.5

テンプレート・サブスクリプション, 13.2.4

テンプレートの使用状況, 13.2.4

テーマのテンプレート, 13.1.10.1

テーマ・ファイル参照, 13.1.10.3

テーマ・テンプレート数, 13.1.10.2

テーマ, 13.1.10

違いの理解, 9.1

ウィザード・レポート, 9.2

REQUEST

ボタン名, 10.5.4

値の参照, 2.7.2.22

置換文字列, 2.7.2.22

リソース使用, 監視, 14.6 アクセスの制限, アプリケーション, 7.2.1.2.3 「アプリケーションの実行」アイコン, 3.3.3.2, 6.3 「ページの実行」アイコン, 6.3.1.1, 8.1.8.1.1 ランタイム環境, 1.2

利点, 15.1.6

S

サンプル・アプリケーション, インストール, 7.1.5

サンプル・データベース・アプリケーション

概要, 3.3

管理ページ, 3.3.2.6

Customersページ, 3.3.2.2

編集, 3.3.3, 3.3.3.2

アプリケーションの編集, 3.3.3.2

ホームページ, 3.3.2.1

インストール, 3.3.1

モバイル・ページ, 3.3.2.7

変更, 3.3.3, 3.3.3.2

Ordersページ, 3.3.2.4

Productsページ, 3.3.2.3

Reportsページ, 3.3.2.5

実行, 3.3.1

理解, 3.3, 3.3.2

「スクリーン・リーダー」モード, E.1

概要, E.1.1

有効化, E.1.2

スクリーン・リーダー・モード

概要, 17.11

拡張, 17.11.2

プロビジョニング, 17.11.1

SDLC, 16.1

高速アプリケーション開発, 16.1.1

スパイラル, 16.1.1

ウォーターフォール, 16.1

検索アプリケーション, 6.3.2, 8.1.8.2 ワークスペースの検索, 1.5 Secure Sockets Layer, ベスト・プラクティス, 15.1.3 セキュリティ

属性, 7.2.2

ページ用, 8.2.2.8

セキュリティ属性

認証, 7.2.2.2.1

認証スキーム, 7.2.2.2.1

認可スキーム, 7.2.2.2.2

データベース・スキーマ, 7.2.2.2.3, 7.2.2.2.4

ディープ・リンク, 7.2.2.2.1

パブリック・ユーザー, 7.2.2.2.1

セッション・ステート保護, 7.2.2.2.5

セキュリティに関するベスト・プラクティス

管理者のタスク, 15.1

問題を引き起こす可能性のあるパスワード, 15.2.2

クロスサイト・スクリプティング保護, 15.2.3

埋込みPL/SQLゲートウェイ, 15.1.1

ネットワーク・サービスの有効化, 15.1.8

タイプ・パスワードのアイテム, 15.2.1

Oracle BI Publisher, 15.1.4

Oracle HTTP Server, 15.1.2

パスワードの複雑性, 15.1.5

ランタイム環境, 15.1.6

Secure Sockets Layer, 15.1.3

セッション・ステート, 15.2.4

セッション・タイムアウト, 15.1.7

「セキュリティ・プロファイル」レポート, 15.2.2.1 セキュリティ・リスク, ファイル・アップロード表, 15.3 シード, 18.3.2 選択リスト, A.1 選択リスト, 依存LOVの作成, 7.7.3.4 セッションID, 2.4.2

ブックマークの容易化, 2.5.5

セッション・ステート

クリア, 2.6.3

アプリケーション・キャッシュのクリア, 2.6.3.3

アイテムごとのキャッシュのクリア, 2.6.3.1

ページごとのキャッシュのクリア, 2.6.3.2

カレント・ユーザー・セッションのキャッシュのクリア, 2.6.3.4

2ページごとのキャッシュのクリア, 2.6.3.2.1

保護の有効化, 7.2.2.2.5

管理, 2.4

アイテム値の引渡し, 2.6.3.2.2

保護, 15.2.5

参照, 2.6.1

セキュリティに関するベスト・プラクティス, 15.2.4

設定, 2.6.2

アプリケーション間での共有, 7.8.4

表示, 2.4.3

セッション・ステート保護

すべての属性の構成, 15.2.5.3.2

セキュリティ属性の構成, 15.2.5.3

無効化, 15.2.5.2

有効化, 15.2.5.2

「セキュリティ属性の編集」からの有効化, 15.2.5.2.1

「セッション・ステート保護」からの有効化, 15.2.5.2.3

ウィザードを使用した有効化, 15.2.5.2.3

レポート, 15.2.5.3.1

理解, 15.2.5.1

既存の設定の表示, 15.2.5.3.1

サマリーの表示, 15.2.5.3.1

「セッション・ステート保護」属性, 7.2.2.2.5 セッション・ステート値, 管理, 2.6 セッション・タイムアウト, 15.1.7 共有コンポーネント

概要, 8.1.7, 8.7.2

アクセス, 8.7.1

バックアップ, 16.5.3

ブレッドクラム, 8.1.7.3

作成, 8.7.1

エクスポート, 8.7.3, 16.5.3

アイコン, 3.3.3.2, 6.3

値リスト, 8.1.7.2

リスト, 8.1.7.4

LOV, 8.1.7.2

ナビゲーション・バー, 8.1.7.8

セキュリティ, 8.1.7.7

共有コンポーネント・ページ, 8.7

タブ, 8.1.7.1

テンプレート, 8.1.7.6

テーマ, 8.1.7.5

「共有コンポーネント」アイコン, 6.3.1.3, 8.1.8.1.2 共有コンポーネント・ページ

アプリケーションの計算, 8.7.2.1.3

アプリケーション・アイテム, 8.7.2.1.1

アプリケーション・プロセス, 8.7.2.1.2, 8.8

認証スキーム, 8.7.2.3.1

認可スキーム, 8.7.2.3.2

ブレッドクラム, 8.7.2.2.3

ビルド・オプション, 8.7.2.1.5

カスケード・スタイルシート, 8.7.2.5.1

コメント, 8.7.2.8.2

コンポーネント設定, 8.7.2.4.7, 8.7.2.4.8

定義, 8.7.2.8.1

グローバリゼーション属性, 8.7.2.6.3

イメージ, 8.7.2.5.2

リスト, 8.7.2.2.2

LOV, 8.7.2.4.4

ナビゲーション・バー・エントリ, 8.7.2.2.4

プラグイン, 8.7.2.4.6

レポート・レイアウト, 8.7.2.7.2

レポート問合せ, 8.7.2.7.1

セキュリティ属性, 8.7.2.3.4

セッション・ステート保護, 8.7.2.3.3

ショートカット, 8.7.2.4.5

静的ファイル, 8.7.2.5.3

タブ, 8.7.2.2.1

テンプレート, 8.7.2.4.3

テスト・メッセージ, 8.7.2.6.2

テーマ, 8.7.2.4.2

アプリケーションの翻訳, 8.7.2.6.1

ユーザー・インタフェース属性, 8.7.2.4.1

Webサービス参照, 8.7.2.1.4

共有対話モード・レポート, リンク, 9.4.17 ショートカット・ページ, 10.7.2.1 ショートカット, 10.7

定義, 10.7.2

属性の編集, 10.7.3

HTMLテキスト, 10.7.1

エスケープされた特殊文字のあるHTMLテキスト, 10.7.1

イメージ, 10.7.1

メッセージ, 10.7.1

JavaScriptにより一重引用符がエスケープされたメッセージ, 10.7.1

PL/SQLファンクション本体, 10.7.1

レポート, 10.7.4

ショートカット履歴, 10.7.4.2

ショートカット・ページ, 10.7.2.1

サブスクライブされたショートカット, 10.7.4.1

翻訳可能なメッセージのサポート, 18.1.4.1

JavaScriptにより一重引用符がエスケープされたテキスト, 10.7.1

タイプ, 10.7.1

表示ページ, 2.3.1 シャトルの複数選択リスト, A.1 シャトル, 依存LOVの作成, 7.7.3.4 単一のデータ・グリッド行, 編集, 5.6.4.5 単一のデータ行, 注釈の追加, 5.6.4.5.1 スライダ・アイテム・タイプ, A.1 SOAP, 17.7 「SQL」レポート, 9.2, SQLトレース, 有効化, 14.5 標準タブ, 作成, 11.1 静的ファイル・リポジトリ, 12.7, 12.7.1 静的ファイル

削除, 12.7.4

ダウンロード, 12.7.3

編集, 12.7.2

エクスポート, 16.5.9, 16.5.9

インポート, 16.6.6

他のインスタンスへのインポート, 16.5.9

管理, 12.7

アップロード, 12.7.1

静的リスト

概要, 11.2.2

リスト・エントリの追加, 11.2.2.2

サブリストの追加, 11.2.2.2

エントリのコピー, 11.2.2.3

最初から作成, 11.2.2.1

孤立リスト・エントリの管理, 11.2.2.5

エントリの親の変更, 11.2.2.4

エントリの順序変更, 11.2.2.6

静的置換文字列, 7.2.1.2.6 「ステータス」属性, 7.2.1.2.3 セッション・ステートに暗号化された値を保存, 7.7.4.3 スタイルシート, 13.2.1 置換文字列

#COLCOUNT#, 13.2.14.2.5

#CSV_LINK#, 13.2.14.2.3, 13.2.14.3.5

#GLOBAL_NOTIFICATION#, 7.2.1.2.5

#HIGHLIGHT_ROW#, 13.2.14.2.5

#IMAGE_PREFIX#, 12.6.2

#ROWNUM#, 13.2.14.2.5

組込みについて, 2.7.2

APEX$ROW_NUM, 2.7.2.1

APEX$ROW_SELECTOR, 2.7.2.2

APEX$ROW_STATUS, 2.7.2.3

APP_ALIAS, 2.7.2.5

APP_ID, 2.7.2.4

APP_IMAGES, 2.7.2.6

APP_PAGE_ID, 2.7.2.7

APP_SESSION, 2.7.2.8

APP_UNIQUE_PAGE_ID, 2.7.2.9

APP_USER, 2.7.2.10

Application Expressスキーマ所有者, 2.7.2.23

AUTHENTICATED_URL_PREFIX, 2.7.2.11

BROWSER_LANGUAGE, 2.7.2.12

カレンダ, 10.2.1.2

CURRENT_PARENT_TAB_TEXT, 2.7.2.13

DEBUG, 2.7.2.14

IMAGE_PREFIX, 2.7.2.16

ページ・テンプレート内, 13.2.11

LOGOUT_URL, 2.7.2.18

PRINTER_FRIENDLY, 2.7.2.19

PROXY SERVER, 2.7.2.20

PUBLIC_URL_PREFIX, 2.7.2.21

サポート対象に関するレポート, 13.1.10.5

REQUEST, 2.7.2.22

SQLERRM, 2.7.2.24

静的, 7.2.1.2.6

サポートされるリージョン・フッター, 12.3.3.3

SYSDATE_YYYYMMDD, 2.7.2.25

理解, 2.7

テンプレート内での使用方法, 2.7.1.1

使用, 2.7.1

WORKSPACE_IMAGES, 2.7.2.26

成功メッセージ, ページ・プロセスの作成, 8.5.4 サポートされるオブジェクト

作成, 16.4.2

削除, 16.4.8

SVGチャート

Flashへ移行, 10.4.4.1.2

移行制限, 10.4.4.1.1

CSSスタイル・インラインの参照, 10.4.4.4

カスタムCSSの参照, 10.4.4.3

すべてのHTML5へのアップグレード, 10.4.4.1.3

HTML5へのアップグレード, 10.4.4.1.2

SVGチャート, CSSクラスの概要, 10.4.4.2 構文, 動的リスト, 11.2.3.1

T

タブ

タブ・ページについて, 11.1.2

追加, 11.1

作成, 11.1.2, 11.1.3

編集, 11.1.4

複数を編集, 11.1.4.1

管理, 11.1.2

レポート, 11.1.5

テンプレートのサポート, 11.1.1.1

タブ・レポート

条件付き表示, 11.1.5.1

履歴, 11.1.5.3

表ファインダ, 10.9 表ファインダ, 10.9.5 表, 検索, 10.9.5 タブ・ページ, 11.1.2 表形式フォーム

作成, 10.1.2

タグ・クラウド, 4.7 チーム開発

ユーティリティについて, 4.8.5

機能ユーティリティ, 4.8.5

機能ダッシュボード, 4.2.1

ホームページ, 4.1

チーム開発の設定の管理, 4.8.5

バグの管理, 4.5

フィードバックの管理, 4.6

リンクの管理, 4.8.1

ニュース・エントリの管理, 4.8.2

設定の管理, 4.8.3

チーム・アクションの管理, 4.8

To Doの管理, 4.4

データの消去, 4.8.5

期限経過したバグのプッシュ, 4.8.5

リリース・サマリー, 4.8.4

リンクの共有, 4.6.4

タグ・クラウド, 4.7

機能の追跡, 4.2

マイルストンの追跡, 4.3

割当て先の更新, 4.8.5

テンプレート・アプリケーション, 7.1.4 テンプレート編集履歴, 13.2.4 テンプレート

ブレッドクラム, 13.2.6

ボタン, 13.2.7

カレンダ, 13.2.8

デフォルトの変更, 13.1.2

列, 13.2.14.2.6, 13.2.14.4

作成, 13.2.3

カスタマイズ, 13.2

ラベル, 13.2.9

リスト, 13.2.10

管理, 13.2.5

ページ, 13.2.11

ポップアップLOV, 13.2.12

パブリッシュ, 13.2.5.7

リージョン, 13.2.13

置換, 13.2.5.3

すべて置換, 13.2.5.4

レポート, 13.2.14

ページに対する選択, 13.2.2.2

テーマのデフォルトの選択, 13.2.2.1

サポートされる置換文字列, 13.1.10.5

サブスクライブ解除, 13.2.5.6

特定のページの表示, 13.2.5.2

テンプレート・ページでの表示, 13.2.5.1

リージョン位置の使用状況の表示, 13.2.5.5

レポートの表示, 13.2.4

テキスト領域, A.1 テキスト文字列, 18.4.2

翻訳, 18.4.1

テキスト文字列, 翻訳, 18.4 テーマ・レポート

アプリケーション・テンプレート, 13.1.10.1

クラス参照, 13.1.10.4

クラス参照, 13.1.10.4

ファイル参照, 13.1.10.3

ファイル参照, 13.1.10.3

サポートされる置換文字列, 13.1.10.5

テンプレート数, 13.1.10.2

テンプレート置換文字列, 13.1.10.5

テーマのテンプレート, 13.1.10.1

テーマ・テンプレート数, 13.1.10.2

テーマ

アクセス, 13.1.1

コンポーネントのデフォルトのテンプレートの変更, 13.1.2

IDの変更, 13.1.9

識別番号(ID)の変更, 13.1.9

名前の変更, 13.1.2

コピー, 13.1.5, 13.1.5

作成, 13.1.3, 13.1.3

デフォルト・テンプレート, 13.1.2

削除, 13.1.6, 13.1.6

編集, 13.1.2

エクスポート, 13.1.8, 16.5.10, 16.5.11

エクスポートとインポート, 13.1.8

異なるIDを使用したエクスポート, 13.1.9

インポート, 13.1.8, 16.6.7

管理, 13.1

レポート, 13.1.10, 13.1.10

ページ・レベル・テンプレートの選択, 13.2.2.1

切替え, 13.1.4

アクティブなテーマの切替え, 13.1.4

テーマ・ページ, 13.1.1

テーマ・ページ, 13.1.3.1

「ページ定義」からのアクセス, 13.1.1

共有コンポーネントからのアクセス, 13.1.1

To Do

ファイルの添付, 4.4.4

カレンダ・ページ, 4.4.5.2

作成, 4.4.2

管理, 4.4

進捗ログ・ページ, 4.4.5.3

レポート, 4.4.5

To Doページ, 4.4.1.1

タスクの更新, 4.4.3

表示, 4.4.1

ツールバー, 8.1.8.4 翻訳可能なメッセージ, 定義, 18.4.1 翻訳, 18.4.2 翻訳, 18.1

アプリケーション, 18.1

動的, 18.5

動的テキスト文字列, 18.1.4.1

動的な翻訳, 18.1.4.3

手動編集, 18.3.6

テキストのエクスポート, 18.3.2

グローバル・サポート, 18.1

言語の指定, 18.1.1

プライマリ・アプリケーションIDのマッピング, 18.3.1

ターゲット・アプリケーションIDのマッピング, 18.3.1

メッセージ, 18.1.4.1, 18.1.4.2

リージョン・タイトル, 18.1.4.4

ルール, 18.1.2, 18.1.2

シード, 18.3.2

ショートカット, 18.1.4.1, 18.1.4.1

手順, 18.3

テンプレート, 18.1.4.5

翻訳可能なコンポーネント, 18.1.4

翻訳ファイル, 18.3.2.2

理解, 18.3

アプリケーション・レンダリングの理解, 18.1.3

XLIFF, 18.3.2.2

XLIFFターゲット要素, 18.3.2.2.3

翻訳ファイル, 18.3.2.2

公開, 18.3.4

アップロード, 18.3.4

ツリー

共有コンポーネントとして作成, 10.8.3

編集, 10.8.3.1

レポート, 10.8.3.2

ツリー・ページ, 10.8.3.1

ツリー・レポート

履歴, 10.8.3.2

使用状況, 10.8.3.2

ツリー・ページ, 10.8.3.1

U

UDDIレジストリ, 17.7.3

ロック解除, 生産性アプリケーション, 3.2.5

「アプリケーションのアップグレード」アイコン, 7.9.1.5

URL

公開, 16.8, 16.9

SSL有効, 12.5

構文, 2.5

URL, セッションIDとしてのゼロ, 2.5.5 ユーザー・アイデンティティ

証明, 15.4

検証, 2.3.3

ユーザー・インタフェース

概要, 1.1

制御, 13

ユーザー・インタフェース属性

構成, 7.2.4

一般プロパティ, コンテンツ配信ネットワーク, 7.2.4.2.1

イメージ接頭辞, 7.2.4.2.1

JavaScript, CSSファイルURL, 7.2.4.2.4

JavaScript, 「ファイルURL」属性, 7.2.4.2.3

JavaScript, レガシーJavaScriptを含める, 7.2.4.2.3

メディアのタイプ, 7.2.4.2.1

ユーザー・インタフェースのデフォルト値, 7.1.7

エクスポート, 16.5.12

インポート, 16.6.8

利用, 7.1.7.1

ユーザー・ロール

開発者, 1.3

Oracle Application Express管理者, 1.3

ワークスペース管理者, 1.3

ユーティリティ, 7.9.1

V

検証エラー, JAWSの実行, E.4.4

検証

概要, 8.4

「エラーに移動」リンクについて, E.4.4.2.1

エラー・メッセージの定義, 8.4.3

「エラーに移動」リンク, 8.4.3.1

条件付き, 8.4.4

「対象ボタン」属性, 2.7.2.22.3

「バージョン」属性, 7.2.1.2.1 ビュー, データの表示, 7.9.1.7

W

WAI-ARIAサポート, E.4.4.4

Webサービス・プロセス

プロセスの編集, 17.7.13

静的値への入力パラメータのマッピング, 17.7.13

Webサービス参照, 17.7.1

作成, 17.7.3

フォームの作成, 17.7.11

フォームおよびレポートの作成, 17.7.10

手動作成, 17.7.4, 17.7.8

UDDIレジストリの検索, 17.7.3.1

WSDLの指定, 17.7.3.2

履歴の表示, 17.7.14

Webサービス参照ページ, 17.7.1.1 Webサービス, 17.7

WSDLからの参照の作成, 17.7.7

RESTful Webサービスの作成, 17.7.5

レポートでのWebサービス結果の表示, 17.7.12.1

Webサービス・プロセスの編集, 17.7.13

プロセスとしての起動, 17.7.12

問題, 15.1.8

RESTful Webサービス

レポート・リージョンの公開, 17.7.15

プロキシ・サーバー・アドレスの指定, 17.7.1.2 SSL有効, 17.7.2 RESTful Webサービス参照のテスト, 17.7.9 Webサービス参照の手動でのテスト, 17.7.8 使用, 17.7.1 Webサービス参照履歴の表示, 17.7.14 Webサービス参照リポジトリ, 17.7.6 Webサービス参照ページ, 17.7.1.1 Webシート・アプリケーション

概要, 2.1.1, 5

注釈について, 5.13

データ・グリッドについて, 5.6.1

データ・セクションの追加について, 5.9

PL/SQLセクションについて, 5.11

セクションについて, 5.3.1

テキスト・セクションについて, 5.4

アクセス制御リスト, 5.14.4

「プレゼンテーション・モード」へのアクセス, 5.15.1

チャート・セクションの追加, 5.10.1

チャートの追加, 5.10

データの追加, 5.6

データ・セクションの追加, 5.6, 5.9.1

ナビゲーションの追加, 5.5.1

新しいページの追加, 5.2.4

ノートの追加, 5.13.3

PL/SQLセクションの追加, 5.11.1

タグの追加, 5.13.2

テキスト・セクションの追加, 5.4.1

パスワードの変更, 5.14.5

コントロール・パネル, 5.1.7

アクセス制御, 5.14.4

ページのコピー, 5.2.5

作成, 5

アクセス制御リスト・エントリの作成, 5.14.4.3

「アプリケーション・ビルダー」から作成, 5.2.1

実行中のWebシートからの作成, 5.2.2

削除, 5.2.7

セクションの削除, 5.3.3

表形式データの表示, 5.6.2

アップロード済イメージのインライン表示, 5.13.1.3

チャートの編集, 5.10.2

ページ詳細の編集, 5.2.6

PL/SQLセクションの編集, 5.11.2

プロパティの編集, 5.14.3

セクション順序の編集, 5.3.4

セクション・タイトルの編集, 5.3.4

セクションの編集, 5.3.2

テキスト・セクションの編集, 5.4.2

電子メール, 5.14.6

アップロード済ファイルへのリンクの追加, 5.13.1.2

「言語」リンク, 5.1.2

ページへのリンク, 5.12.1

データ・グリッドへのリンク, 5.12.4

セクションへのリンク, 5.12.2

URLへのリンク, 5.12.3

ログアウト, 5.1.5

マークアップ構文, 5.12

アクティビティの監視, 5.14.2

ページ間のナビゲート, 5.1.1

オンライン・ヘルプ, 5.1.3

出力, 5.14.7

「アプリケーション・ビルダー」に戻る, 5.1.4

実行, 5.2.3

アクセス制御リストの指定, 5.14.4.2

ファイルおよびイメージのアップロード, 5.13.1

ブレッドクラムの使用, 5.1.1

SQLおよびSQLVALUE構文の使用, 5.12.5

「ページ・ディレクトリ」の表示, 5.15.2

「ページ履歴」の表示, 5.15.3

Webシート・ダッシュボードの表示, 5.14.1

Webシート・ディレクトリの表示, 5.15.4

Webシート認証

Application Expressアカウント, 5.14.3.3.5

カスタム, 5.14.3.3.5

LDAP, 5.14.3.3.5

シングル・サインオン, 5.14.3.3.5

Webシート・ダッシュボード, 表示, 5.14.1 Webシート・プロパティ

概要, 5.14.3.3

アクセス制御リスト・タイプ, 5.14.3.3.6

アクセス, 5.14.3.1

パブリック・アクセスを許可, 5.14.3.3.6

アプリケーション日付書式, 5.14.3.3.1

認証, 5.14.3.3.5

Cookieドメイン, 5.14.3.3.5

Cookie名, 5.14.3.3.5

Cookieパス, 5.14.3.3.5

デフォルトのアプリケーション言語, 5.14.3.3.1

デフォルトのアプリケーション地域, 5.14.3.3.1

説明, 5.14.3.3.2

SQLとPL/SQLアクセスの編集, 5.14.3.3.7

ホームページ, 5.14.3.3.1

ログイン・メッセージ, 5.14.3.3.2

ロゴ, 5.14.3.3.3

ロゴ・タイプ, 5.14.3.3.3

ログアウトURL, 5.14.3.3.5

名前, 5.14.3.3.1

所有者, 5.14.3.3.2

セキュア, 5.14.3.3.5

パスワードのリセットの表示, 5.14.3.3.1

ステータス, 5.14.3.3.1

スタイル, 5.14.3.3.4

Webシートの電子メール送信元アドレス, 5.14.3.3.1

Webシート

ナビゲーションの概要, 3.4.3

ブレッドクラム, 5.1.1

共通のUI要素, 5.1

コントロール・パネル, 3.4.4.3

編集, 3.4.5

ファイル・リージョン, 3.4.4.4

メニュー, 3.4.4.1

変更, 3.4.5

ナビゲーション, 3.4.2

「ノート」リージョン, 3.4.4.6

「タグ」リージョン, 3.4.4.5

ナビゲーションの理解, 3.4.3.1

ブレッドクラムの使用, 3.4.2.1

Webシート検索, 3.4.4.2, 5.1.6

ウィザード・レポート, 9.2 ウィザード

ページの作成, 7.3.1

ブランチの作成, 11.5.1

ブレッドクラムの作成, 11.3.2.2

ボタンの作成, 10.5.1

カレンダの作成, 10.2

チャートの作成, 10.4

リストの作成, 11.2.2, 11.2.3

LOVの作成, 10.6.1

新規コンポーネントの作成, 7.3.3, 10.10.2.3

ページ計算の作成, 8.3.1, 17.7.12

ページ・プロセスの作成, 8.5.1

リージョンの作成, 12.3.1

アプリケーションの作成, 2.1.2

アプリケーションの作成, 2.1

ナビゲーション・バー・エントリの作成, 11.4.2.1, 11.4.2.2, 11.4.2.3

レポートの作成, 9.2

検証の作成, 8.4.1.1, 8.4.1.2, 8.4.1.3, 8.4.1.4

ワークスペース

ログイン, 1.4.3.2

ログアウト, 1.4.3.5

リクエスト, 1.4.3.1

検索, 1.5

ワークスペース管理者, 1.3 ワークスペースホームページ

概要, 1.5

「アクセシビリティ・モード」リスト, 1.5

「使用可能な更新」リージョン, 1.5

「詳細」リンク, 1.5

「ニュース」リージョン, 1.5

システム・メッセージ, 1.5

「トップ・アプリケーション」リージョン, 1.5

「トップ・ユーザー」リージョン, 1.5

ワークスペース・テーマ

追加, 13.1.7.1

削除, 13.1.7.3

エクスポート, 13.1.7.5

管理, 13.1.7

変更, 13.1.7.4

既存の表示, 13.1.7.2

WSDLドキュメント, 17.7.1

X

XLIFF, 18.3.2.2

適用, 18.3.4.2

アップロードしたドキュメントの削除, 18.3.4.3

ターゲット要素, 18.3.2.2.3

アップロード, 18.3.4.1

アップロードおよび公開, 18.3.4

Copyright © 2003, 2012, Oracle and/or its affiliates. All rights reserved.