ヘッダーをスキップ
Oracle Application Expressアプリケーション・ビルダー・ユーザーズ・ガイド
リリース 3.1.2
B51321-01
  目次
目次
索引
索引

前へ
前へ
 
次へ
次へ
 

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

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

このセクションの内容は次のとおりです。

テーマの管理

テーマは、アプリケーション全体のレイアウトおよびスタイルの定義に使用できるテンプレートのコレクションです。テーマにはテンプレートの完全なセットが用意され、アプリケーションに必要となる可能性があるすべてのUIパターンが提供されます。テンプレートは、まずタイプ別(ブレッドクラム、ボタン、カレンダ、ラベル、リスト、ページ、ポップアップLOV、リージョンおよびレポート)に分類され、次に、そのタイプ内の各テンプレートの用途を示すテンプレート・クラスごとに分類されます。各テンプレート・タイプには、標準クラスのグループおよび8つのカスタム・クラスが用意されています。このような分類によって、Oracle Application Expressではテーマ間でのテンプレートのマッピングが可能になり、アプリケーション全体のルック・アンド・フィールを簡単に変更できます。

「作業領域テーマの管理」

このセクションの構成は次のとおりです。

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

テーマ・ページでテーマを管理します。共有コンポーネント・ページまたは「ページ定義」からテーマ・ページにアクセスできます。

このセクションの構成は次のとおりです。

「共有コンポーネント」からのテーマ・ページへのアクセス

「共有コンポーネント」からテーマ・ページにアクセスするには、次のステップを実行します。

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

  2. アプリケーションを選択します。

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

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

    テーマ・ページが表示されます。

  5. 「ビュー」リストから「詳細」を選択して、「実行」をクリックします。

    現在の列のチェック・マークはどのテーマが選択されたかを示します。

  6. テーマ名をクリックします。

    テーマの作成/編集ページが表示されます。

「ページ定義」からのテーマ・ページへのアクセス

ページ定義からテーマ・ページにアクセスするには、次のステップを実行します。

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

  2. アプリケーションを選択します。

  3. ページを選択します。

    ページ定義が表示されます。

  4. 「共有コンポーネント」で、「テーマ」セクションを特定します。

  5. テーマ名をクリックします。

    テーマの作成/編集ページが表示されます。

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

標準テーマには、すべてのタイプのアプリケーション・コンポーネントおよびリージョン・タイプのテンプレートが含まれます。テーマに選択したデフォルトのテンプレートを、テーマの作成/編集ページで変更できます。

テーマのデフォルトのテンプレートは、新しいコンポーネントやリージョンの作成時に別のテンプレートを選択するか、またコンポーネントやリージョンの属性ページでテンプレートを変更することによって、オーバーライドできます。

テーマのデフォルトのテンプレーを確認または変更するには、次のステップを実行します。

  1. テーマ・ページにナビゲートします。

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

    2. アプリケーションを選択します。

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

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

      テーマ・ページが表示されます。

  2. テーマを編集するには、次のステップを実行します。

    1. 「ビュー」リストから「詳細」を選択し、「実行」をクリックします。

    2. テーマ名をクリックします。

    テーマの作成/編集ページが表示されます。

    テーマの作成/編集ページはいくつかのセクションに分かれています。これらのセクションにアクセスするには、ページをスクロール・ダウンするか、ページ上部のナビゲーション・ボタンをクリックします。ページの上部でボタンを選択すると、選択したセクションが表示され、その他すべてのセクションは一時的に非表示になります。ページの全セクションを表示するには、「すべての表示」をクリックします。

    アプリケーションIDおよびテーマ識別番号は、ページの上部に表示されます。

  3. テーマ名を変更するには、「名前」フィールドに新しい名前を入力します。

  4. デフォルトのテンプレートを変更するには、該当するリストから新しく選択します。

    表10-1に、 「コンポーネントのデフォルト値」で使用可能なデフォルトのテンプレートを示します。

    表10-1 コンポーネントのデフォルトのテンプレート

    属性 説明

    ページ

    ページを表示するためのデフォルトのテンプレートを指定します。開発者が明示的にテンプレートを選択しない場合、Application Expressエンジンは、ここで指定されたテンプレートを使用します。

    デフォルトのテンプレートを定義すると、定義の編集ページのヘッダー「デフォルトのアプリケーション・テンプレート」に、このテンプレートが表示されます。

    参照: ページ属性ページでのページ・テンプレートの上書きについては、「表示属性」を参照してください。

    エラー・ページ

    インライン表示されるエラーではなく、個別のページに表示されるエラーに使用するページ・テンプレートを指定します。エラーを表示するように設計されたテンプレートを使用しない場合、この属性は、空白のままにします。

    デフォルトのテンプレートを定義すると、定義の編集ページのヘッダー「デフォルトのアプリケーション・テンプレート」に、このテンプレートが表示されます。

    印刷用ページ

    Application Expressエンジンが印刷用モードの場合に使用するテンプレートを指定します。

    参照: 「印刷用ページの最適化」

    ブレッドクラム

    ブレッドクラムを作成する場合に使用するデフォルトのブレッドクラム・テンプレートを指定します。

    ボタン

    ボタンを作成する場合に使用するデフォルトのボタン・テンプレートを指定します。

    カレンダ

    カレンダを作成する場合に使用するデフォルトのカレンダ・テンプレートを指定します。

    ラベル

    ラベルを作成する場合に使用するデフォルトのラベル・テンプレートを指定します。

    リスト

    リストを作成する場合に使用するデフォルトのリスト・テンプレートを指定します。

    リージョン

    リージョンを作成する場合に使用するデフォルトのリージョン・テンプレートを指定します。

    レポート

    レポートを作成する場合に使用するデフォルトのリージョン・テンプレートを指定します。


    表10-2に、「リージョンのデフォルト値」セクションで使用可能なデフォルトのテンプレートを示します。

    表10-2 リージョンのデフォルト値

    属性 説明

    ブレッドクラム

    ブレッドクラムを作成する場合に使用するデフォルトのリージョン・テンプレートです。

    チャート

    チャートを作成する場合に使用するデフォルトのチャート・テンプレートです。

    フォーム

    フォームを作成する場合に使用するデフォルトのフォーム・テンプレートです。

    リスト

    リストを作成する場合に使用するデフォルトのリージョン・テンプレートです。

    レポート

    レポートを作成する場合に使用するデフォルトのリージョン・テンプレートです。

    表形式フォーム

    表形式フォームを作成する場合に使用するデフォルトのリージョン・テンプレートです。

    ウィザード

    ウィザード・コンポーネントを作成する場合に使用するデフォルトのリージョン・テンプレートです。


新しいテーマの作成

新しく作成するか、またはリポジトリから既存のテーマを選択することによって、新しいテーマを作成できます。

新しいテーマを作成するには、次のステップを実行します。

  1. テーマ・ページにナビゲートします。

    1. 作業領域のホームページで、「アプリケーション・ビルダー」をクリックします。

    2. アプリケーションを選択します。

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

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

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

  3. 次のいずれかの作成方法を選択します。

    • リポジトリから

    • 最初から

    • エクスポートから

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

  5. 特定のフィールドの詳細を表示するには、フィールド・ラベルをクリックします。

    ヘルプが使用できる場合、アイテム・ラベルの上にカーソルを置くとアイテム・ラベルは赤に変わり、カーソルは矢印と疑問符マークに変わります。「フィールドレベル・ヘルプについて」を参照してください。

テーマ・ページについて

テーマを作成すると、テーマ・ページに表示されます。ナビゲーション・バーはページの上部に表示され、次のコントロールが含まれています。

  • テーマ: テーマ名に対し大/小文字を区別しない問合せを入力して、「実行」をクリックします。すべてのテーマを表示するには、このフィールドを空白のままにして「実行」をクリックします。

  • ビュー: ページの表示方法を制御できます。オプションは次のとおりです。

    • アイコン(デフォルト): 各テーマを大きいアイコンとして表示します。テーマを編集するには、該当するアイコンをクリックします。

    • 詳細: 各テーマをレポートで1行に表示します。テーマ名またはデフォルトのテンプレートを変更するには、テーマ名をクリックします。「詳細」ビューで、「表示」リストから次のオプションを選択できます。

      • サマリー・ビュー: テーマ番号、名前および現在のステータスが表示されます。

      • 詳細ビュー: テーマ番号、名前、現在のステータス、および各テンプレート・タイプのテンプレート数が表示されます。

  • 表示: テーマの表示方法を指定します。数の増減を行うには、「表示」リストで選択を行ってから「実行」をクリックします。

テーマの編集

新しく作成するか、またはリポジトリから既存のテーマを選択することによって、新しいテーマを作成できます。

新しいテーマを作成するには、次のステップを実行します。

  1. テーマ・ページにナビゲートします。

    1. 作業領域のホームページで、「アプリケーション・ビルダー」をクリックします。

    2. アプリケーションを選択します。

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

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

  2. 「タスク」リストで、「テーマの編集」をクリックします。

    テーマの作成/編集ページが表示されます。

  3. 特定のフィールドの詳細を表示するには、フィールド・ラベルをクリックします。

    ヘルプが使用できる場合、アイテム・ラベルの上にカーソルを置くとアイテム・ラベルは赤に変わり、カーソルは矢印と疑問符マークに変わります。「フィールドレベル・ヘルプについて」を参照してください。

  4. 適切に編集を行い、「変更の適用」をクリックします。

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

新しいテーマに切り替えると、テンプレートに割り当てられたすべてのコンポーネントは、新しいテーマの対応するテンプレートに割り当てられます。アプリケーション・ビルダーは、テンプレート・クラス識別子の割当てによってテンプレート・マッピングを行います。


注意:

テーマがすでに存在する場合にのみ、新しいテーマに切り替えられます。たとえば、リポジトリで使用可能なテーマに切り替える前に、最初にテーマを作成する必要があります。「新しいテーマの作成」を参照してください。

アプリケーションにテーマを使用するには、次のステップを実行します。

  1. テーマ・ページにナビゲートします。

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

    2. アプリケーションを選択します。

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

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

  2. テーマの切替え」をクリックします。

    テーマの切替えページが表示されます。

  3. 「次のテーマに切替え」から新しいテーマを選択し、「次へ」をクリックします。

  4. 「ステータス」列を確認し、マッピング上の問題を特定します。

    • チェック: マッピングが成功したことを示します。

    • 警告: 切替え先のテーマに、指定されたクラスを持つ複数のテンプレートがあることを示します。この警告では、適切なテンプレートを選択するための選択リストが提供されます。

    • エラー: アプリケーション・ビルダーがテーマ間でクラスをマップできなかったことを示します。クラスが両方のテーマのテンプレートで指定されていることを確認します。

  5. 「次へ」をクリックして続行します。

  6. テーマの切替え」をクリックします。

テーマのコピー

すべてのテーマは、数値による識別番号(ID)で識別されます。テーマをコピーする場合は、新しいテーマIDを指定します。テーマのコピーは、テーマの編集を試行したり、テーマに異なるIDを付けてエクスポートする場合に便利です。

テーマをコピーするには、次のステップを実行します。

  1. テーマ・ページにナビゲートします。

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

    2. アプリケーションを選択します。

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

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

  2. 「タスク」リストで、「テーマのコピー」をクリックします。

  3. 「テーマのコピー」で、次の操作を実行します。

    1. 次のテーマからコピー: コピーするテーマを選択します。

    2. このテーマ識別番号にコピー: そのテーマの新しいIDを入力します。

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

  4. テーマIDをコピー」をクリックします。

テーマの削除

アクティブではないテーマのみ削除できます。テーマを削除すると、アプリケーション・ビルダーによって、アクティブではないテンプレートのみ削除されます。

テーマを削除するには、次のステップを実行します。

  1. テーマ・ページにナビゲートします。

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

    2. アプリケーションを選択します。

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

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

  2. 「タスク」リストで、「テーマの削除」をクリックします。

  3. 「テーマの削除」で、削除するテーマを選択し、「次へ」をクリックします。

  4. 「テーマの削除」をクリックします。

作業領域テーマの管理

作業領域管理者は、作業領域のテーマ・リポジトリを管理します。作業領域管理者は、リポジトリにテーマを追加して作業領域内のすべての開発者がそのテーマを使用できるようにしたり、テーマを削除することができます。

このセクションの構成は次のとおりです。


参照:

Oracle Application Express管理ガイドの「Oracle Application Expressインスタンスのテーマの管理」

テーマ・リポジトリへのテーマの追加

テーマをテーマ・リポジトリに追加するには、次のステップを実行します。

  1. テーマ・ページにナビゲートします。

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

    2. アプリケーションを選択します。

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

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

  2. 「タスク」リストから「作業領域テーマの管理」をクリックします。

  3. 「作成」を選択し、「次へ」をクリックします。

  4. 「コピーするアプリケーション・テーマ」では、必要なテーマを選択して「次へ」をクリックします。

  5. 「名前の指定」では、テーマ番号、名前およびオプションで説明を入力し、「次へ」をクリックします。

  6. 「作業領域テーマの作成」をクリックします。

作業領域テーマの削除

作業領域テーマを削除するには、次のステップを実行します。

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

  2. 「タスク」リストで「作業領域テーマ」をクリックします。

  3. 削除するテーマを選択します。

  4. 「削除」をクリックします。

作業領域テーマの変更

作業領域テーマを直接編集することはできません。作業領域テーマを変更するには、そのテーマを使用して新しいアプリケーションを作成し、テーマを変更します。次に、関連するアプリケーション・ファイルをエクスポートするのと同じ方法で、テーマを作業領域テーマ・リポジトリに手動で追加する必要があります。

作業領域テーマを変更するには、次のステップを実行します。

  1. 変更するテーマを使用して、アプリケーションを作成します。「アプリケーションの作成」を参照してください。

  2. テーマを変更します。「テーマの編集」を参照してください。

  3. 既存の作業領域テーマを削除します。「作業領域テーマの削除」を参照してください。

  4. 変更したテーマを作業領域テーマ・リポジトリに追加します。「テーマ・リポジトリへのテーマの追加」を参照してください。

作業領域テーマのエクスポートについて

テーマのエクスポートは、関連するアプリケーション・ファイルのエクスポートと同様の方法で行います。作業領域テーマをエクスポートするには、次のステップを実行します。

  1. テーマを使用して、アプリケーションを作成します。「アプリケーションの作成」を参照してください。

  2. アプリケーションをエクスポートします。「アプリケーションのエクスポート」を参照してください。

  3. エクスポートされたファイルをターゲットのOracle Application Expressインスタンスにインポートします。「アプリケーションまたはページのインポート」を参照してください。

  4. エクスポートされたファイルをエクスポート・リポジトリからインストールします。「エクスポート・ファイルのインストール」を参照してください。

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

関連するアプリケーション・ファイルのエクスポートと同様の方法でテーマをエクスポートします。1つの開発インスタンスから別のインスタンスへテーマをエクスポートするには、次のステップを実行します。

  1. テーマを使用して、アプリケーションを作成します。「アプリケーションの作成」を参照してください。

  2. 「テーマのエクスポート」ユーティリティを使用してテーマをエクスポートします。詳細は、「テーマのエクスポート」を参照してください。

  3. エクスポートされたファイルをターゲットのOracle Application Expressインスタンスにインポートします。詳細は、「エクスポート・ファイルのインポート」を参照してください。

  4. エクスポートされたファイルをエクスポート・リポジトリからインストールします。「エクスポート・ファイルのインストール」を参照してください。

テーマ識別番号の変更

すべてのテーマには、識別番号(ID)があります。テーマIDの変更ユーティリティを使用して、テーマIDを別の識別番号に変更できます。テーマIDの変更は、テーマに異なる番号を付けてエクスポートし、別のアプリケーションにインポートする場合に便利です。

テーマ識別番号を変更するには、次のステップを実行します。

  1. テーマ・ページにナビゲートします。

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

    2. アプリケーションを選択します。

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

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

  2. 「タスク」リストで、「指定番号の変更」をクリックします。

  3. テーマ番号の場合は、次のステップを実行します。

    1. テーマの指定: テーマを選択します。

    2. このテーマ指定番号に変更

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

    4. 変更内容を確認して、「テーマIDの変更」をクリックします。

テーマ・レポートの表示

アプリケーション・ビルダーには、テーマおよびテンプレートの管理に役立つ多くのレポートが含まれています。

このセクションの構成は次のとおりです。

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

テーマを構成しているすべてのテンプレートを表示するには、次のステップを実行します。

  1. テーマ・ページにナビゲートします。

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

    2. アプリケーションを選択します。

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

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

  2. 「レポート」をクリックします。

  3. テーマ・レポート・ページで、次のステップを実行します。

    1. 「レポート」から「アプリケーション・テンプレート」を選択します。

    2. 「テーマ」からテーマを選択します。

    3. 「実行」をクリックします。

    テンプレートのリストには、テンプレート・タイプ、テンプレート名、対応するテーマおよびテンプレート・クラスの一覧が表示されます。

  4. テンプレートを編集するには、テンプレート名を選択します。

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

「テーマ・テンプレート数」レポートには、現在、テンプレート・クラス用に作成されたテンプレートがあるテンプレート・クラスが表示されます。

テーマ・テンプレート数レポートを表示するには、次のステップを実行します。

  1. テーマ・ページにナビゲートします。

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

    2. アプリケーションを選択します。

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

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

  2. 「レポート」をクリックします。

  3. テーマ・レポート・ページで、次のステップを実行します。

    1. 「レポート」から「テーマ・テンプレート数」を選択します。

    2. 「テーマ」からテーマを選択します。

    3. 「実行」をクリックします。

  4. カスタムの分類を使用する場合は、「カスタムの表示」を選択し、「実行」をクリックします。

ファイル参照の表示

ファイル参照のレポートには、テンプレートに関連付けられたすべてのファイル、共有コンポーネント、カレント・アプリケーションのページ・コンポーネントの一覧が表示されます。

「ファイル参照」のレポートを表示するには、次のステップを実行します。

  1. テーマ・ページにナビゲートします。

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

    2. アプリケーションを選択します。

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

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

  2. テーマ・ページで「レポート」をクリックします。

  3. テーマ・レポート・ページで、次のステップを実行します。

    1. 「レポート」から「ファイル参照」を選択します。

    2. 「テーマ」からテーマを選択します。

    3. 「実行」をクリックします。

  4. ファイル参照ページで、次のステップを実行します。

    1. 「表示」から、レポートに含めるコンポーネントのタイプを選択します。選択しない場合は、結果が戻されません。

    2. 「ファイルの表示」から次のいずれかの項目を選択します。

      • コンテキスト付き: コンポーネント、テーマ識別番号、コンポーネント名、イメージ(使用可能な場合)、およびページ番号を表示します。ページ定義にリンクするには、ページ番号を選択します。

      • コンテキストなし: ファイル名およびイメージ(使用可能な場合)のみ表示します。

    3. 「ファイル拡張子」から検索する拡張子のタイプを選択します。

    4. 「実行」をクリックします。

  5. このレポートのカンマ区切りファイル(.csv)をダウンロードするには、ページ下部の「ダウンロード」をクリックします。

クラス参照の表示

クラス参照のレポートにアクセスすると、テンプレートに関連付けられたクラス、共有コンポーネント、カレント・アプリケーションのページ・コンポーネントの一覧が表示されます。

クラス参照のレポートを表示するには、次のステップを実行します。

  1. テーマ・ページにナビゲートします。

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

    2. アプリケーションを選択します。

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

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

  2. 「レポート」をクリックします。

  3. テーマ・レポート・ページで、次のステップを実行します。

    1. 「レポート」から「クラス参照」を選択します。

    2. 「テーマ」からテーマを選択します。

    3. 「実行」をクリックします。

  4. クラス参照ページで、次のステップを実行します。

    1. 「表示」から、クラス参照を確認するコンポーネントを選択します。選択しない場合は、結果が戻されません。

    2. 「クラス名の表示」から、次のいずれかを選択します。

      • コンテキスト付き: コンポーネント、テーマ識別番号、コンポーネント名、イメージ(使用可能な場合)、およびページ番号を表示します。

      • コンテキストなし: 参照されるクラスのみを表示します。

    3. 「実行」をクリックします。

  5. このレポートのカンマ区切りファイル(.csv)をダウンロードするには、ページ下部の「ダウンロード」をクリックします。

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

「テンプレート置換文字列」レポートを使用すると、コンポーネントがサポートする置換文字列がすべて表示されます。

「置換文字列」レポートを表示するには、次のステップを実行します。

  1. テーマ・ページにナビゲートします。

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

    2. アプリケーションを選択します。

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

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

  2. 「レポート」をクリックします。

  3. テーマ・レポート・ページで、次のステップを実行します。

    1. 「レポート」リストから、「テンプレート置換文字列」を選択します。

    2. 「テーマ」リストから、レポートに含めるテーマを選択します。

    3. 「実行」をクリックします。

  4. テンプレート定義にリンクするには、コンポーネント名を選択します。

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

Application Expressエンジンは、テーマと呼ばれるテンプレートのコレクションに基づいて、アプリケーションのユーザー・インタフェースを作成します。テンプレートは、アプリケーション内のコンポーネントのルック・アンド・フィールを制御します。カスタム・テンプレートを作成するには、既存のテンプレートを変更する方法がより簡単です。作成した1つ以上のデフォルト・テンプレートは、必要に応じて変更できます。

このセクションの構成は次のとおりです。

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

カスケード・スタイルシート(CSS)によって、構造を変更せずにWebページのスタイルを制御できます。CSSを適切に使用すると、カラー、余白、フォントなどの視覚属性がHTMLドキュメントの構造から切り離されます。Oracle Application Expressのテーマには、独自のCSSを参照するテンプレートを含めることができます。特定のテーマの各CSSで定義されたスタイル・ルールによって、レポートおよびリージョンの表示も指定されます。

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

デフォルトのページ・テンプレートは、2つの方法で指定できます。

  • 特定のテーマ内のデフォルトのページ・テンプレートを選択します。

  • ページごとに特定のページ・テンプレートを選択します。

デフォルトでは、Application Expressエンジンは、テーマ・ページで指定されたページ・テンプレートを使用します。

このセクションの構成は次のとおりです。

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

テーマ内のデフォルトのページ・テンプレートを指定するには、次のステップを実行します。

  1. テーマ・ページにナビゲートします。

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

    2. アプリケーションを選択します。

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

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

      テーマ・ページが表示されます。

  2. 「ビュー」から「詳細」を選択し、「実行」をクリックします。

  3. 「テーマ」リストで、テーマ名を選択します。

    テーマの作成/編集ページが表示されます。

  4. 「コンポーネントのデフォルト値」で、「ページ」リストから選択します。

  5. ページ上部の「変更の適用」をクリックします。

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

特定のページにページ・レベル・テンプレートを指定するには、次のステップを実行します。

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

  2. アプリケーションを選択します。

  3. ページを選択します。

  4. 「ページ」で、「ページ属性の編集」アイコンをクリックします。

  5. 「表示属性」セクションを探します。

  6. 「ページ・テンプレート」リストから選択します。

  7. ページ上部の「変更の適用」をクリックします。

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

カスタム・テンプレートを作成するには、まず既存のテンプレートを変更する方法が最も簡単です。作成した1つ以上のデフォルト・テンプレートは、必要に応じて変更できます。

カスタム・テンプレートを作成するには、次のステップを実行します。

  1. テンプレート・ページにナビゲートします。

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

    2. アプリケーションを選択します。

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

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

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

  3. 作成するテンプレートのタイプを選択します。

  4. 次のいずれかの作成方法を選択します。

    • 最初から

    • 既存のテンプレートのコピーとして

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


ヒント:

テンプレートが適切なテーマに関連付けられていることを確認します。

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

アプリケーション・ビルダーには、テンプレートの使用状況、サブスクリプション、パブリッシュされたテンプレートおよび編集履歴を示すレポートがあります。

カレント・アプリケーションについてのテンプレート・レポートを表示するには、次のステップを実行します。

  1. テーマ・ページにナビゲートします。

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

    2. アプリケーションを選択します。

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

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

  2. 次のリストから選択し、「実行」をクリックして、表示を絞り込むことができます。

    • テンプレート名: 大/小文字を区別しない問合せを入力します。

    • テーマ: 特定のテーマのテンプレートだけを表示します。

    • 参照: 表示するテンプレートのタイプを選択します。

    • タイプ: テンプレート・タイプのタイプを選択します。

    • 期間: レポートを特定の時間枠に制限します。レポートに含める期間を選択します。

    • サブスクライブ: 「すべてのテンプレート」、「サブスクライブされたテンプレート」または「サブスクライブされていないテンプレート」のいずれを表示するかを指定します。

  3. テンプレート・レポートを表示するには、次のいずれかのボタンをクリックします。

    • 使用状況: カレント・アプリケーションのすべてのテンプレート・タイプ(ページ、レポート、リージョン、レベルおよびリスト)についてテンプレートの使用状況を表示します。

    • サブスクリプション: アプリケーションでサブスクライブされたテンプレートを表示します。

    • 履歴: 開発者によるテンプレートへの最近の変更および最終更新日を表示します。

テンプレートの管理

テンプレート・ページで、すべての使用可能なテンプレートを表示できます。また、ページ定義で、特定のページに関連付けられているテンプレートにアクセスできます。

このセクションの構成は次のとおりです。

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

既存のテンプレートを表示するには、次のステップを実行します。

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

  2. アプリケーションを選択します。

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

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

    テンプレート・ページが表示されます。

  5. 次のリストから選択し、「実行」をクリックして、表示を絞り込むことができます。

    • テンプレート名: 大/小文字を区別しない問合せを入力します。

    • テーマ: 特定のテーマのテンプレートだけを表示します。

    • 参照: 表示するテンプレートのタイプを選択します。

    • タイプ: テンプレート・タイプのタイプを選択します。

    • 期間: レポートを特定の時間枠に制限します。レポートに含める期間を選択します。

    • サブスクライブ: 「すべてのテンプレート」、「サブスクライブされたテンプレート」または「サブスクライブされていないテンプレート」のいずれを表示するかを指定します。

  6. テンプレートのプレビューを確認するには、「プレビュー」列で「実行」アイコンをクリックします。

    一部のテンプレート・タイプには、プレビュー機能はありません。

  7. テンプレート定義を表示または編集するには、テンプレート名をクリックします。

    テンプレート定義が表示されます。

    各テンプレート定義は複数のセクションに分かれています。これらのセクションにアクセスするには、手動でスクロールするか、ページ上部のナビゲーション・ボタンをクリックします。ページの上部でボタンを選択すると、選択したセクションが表示され、その他すべてのセクションは一時的に非表示になります。ページの全セクションを表示するには、「すべて表示」をクリックします。

  8. 対象となる属性を編集します。

    テンプレートを編集する場合、1つのウィンドウで変更を行い、テンプレート定義ページの右側で「ページに戻る」チェック・ボックスを選択することで、別のウィンドウでアプリケーションを実行できます。このチェック・ボックスを選択すると、「変更の適用」をクリックした後、現在編集中のページが維持されます。

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

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

特定のページに関連付けられているテンプレートを表示するには、次のステップを実行します。

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

  2. アプリケーションを選択します。

  3. ページを選択します。

    ページ定義が表示されます。右端の列の「テンプレート」ヘッダーの下に、カレント・ページに関連付けられたテンプレートが表示されます。

  4. テンプレート定義を表示または編集するには、テンプレート名をクリックします。

    テンプレート定義が表示されます。

    各テンプレート定義は複数のセクションに分かれています。これらのセクションにアクセスするには、手動でスクロールするか、ページ上部のナビゲーション・ボタンをクリックします。ページの上部でボタンを選択すると、選択したセクションが表示され、その他すべてのセクションは一時的に非表示になります。ページの全セクションを表示するには、「すべて表示」をクリックします。

  5. 対象となる属性を編集します。

    テンプレートを編集する場合、1つのウィンドウで変更を行い、テンプレート定義ページの右側で「ページに戻る」チェック・ボックスを選択することで、別のウィンドウでアプリケーションを実行できます。このチェック・ボックスを選択すると、「変更の適用」をクリックした後、現在編集中のページが維持されます。

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

テンプレートの置換

テンプレートの置換ウィザードを使用してコンポーネントに関連付けられているテンプレートを更新できます。

コンポーネントに関連付けられているテンプレートを置換するには、次のステップを実行します。

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

  2. アプリケーションを選択します。

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

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

    テンプレート・ページが表示されます。

  5. 「タスク」リストから「テンプレートの置換」を選択します。

  6. 「テンプレート・タイプ」からテンプレートを選択し、「次へ」をクリックします。

  7. 「テンプレートの置換」で、次の項目を選択します。

    1. 変更前: 変更前のテンプレートを選択します。

    2. 変更後: 変更後のテンプレートを選択します。

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

  8. 「終了」をクリックします。

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

アプリケーション内のすべてのテンプレートを別のアプリケーションのテンプレートに置換するには、次のステップを実行します。

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

  2. アプリケーションを選択します。

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

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

    テンプレート・ページが表示されます。

  5. 「タスク」リストから「このアプリケーションのテンプレートを別のアプリケーションのテンプレートに置換。」を選択します。

  6. 「アプリケーションから置換」からアプリケーションを選択し、「次へ」をクリックします。

  7. 「テンプレートの置換」で、各コンポーネントの新しいテンプレートを選択し、次のいずれかを選択します。

    • 置換: テンプレート定義をコピーします。

    • 置換/サブスクライブ: テンプレートをコピーしてサブスクリプションを追加します。

  8. 「テンプレートの置換」をクリックします。

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

ページ上のリージョンは、位置(表示ポイント)で構成されます。リージョンで使用可能な表示ポイントは、ページ・レベルのテンプレートによって決まります。

ページ・テンプレート別のリージョン位置の使用状況を表示するには、次のステップを実行します。

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

  2. アプリケーションを選択します。

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

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

    テンプレート・ページが表示されます。

  5. 「タスク」リストから「ページ・テンプレートのリージョン位置の使用状況の表示」を選択します。

    「リージョン表示ポイントの使用状況」レポートが表示されます。

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

サブスクライブされるテンプレートとは、定義を別のテンプレートで管理されているテンプレート、つまり参照されるテンプレートです。アプリケーションで、サブスクライブされるテンプレートを使用している場合は、テンプレートのサブスクライブ解除ページでテンプレートのサブスクライブを解除できます。

テンプレートのサブスクライブを解除するには、次のステップを実行します。

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

  2. アプリケーションを選択します。

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

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

    テンプレート・ページが表示されます。

  5. 「タスク」リストから「テンプレートのサブスクライブ解除」を選択します。

    テンプレートのサブスクライブ解除ページが表示されます。

  6. 現行のテーマ内で特定のテンプレート・タイプをサブスクライブ解除するには、テンプレート・タイプを選択し、「サブスクライブ解除」をクリックします。

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

テンプレートのパブリッシュ・ページを使用して、作業領域の他のテンプレートによってサブスクライブされるテンプレートを表示します。

マスター・テンプレートの内容を、サブスクライブしているテンプレートにパブリッシュするには、次のステップを実行します。

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

  2. アプリケーションを選択します。

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

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

    テンプレート・ページが表示されます。

  5. 「パブリッシュ」タブをクリックします。

    テンプレートのパブリッシュ・ページが表示されます。

  6. パブリッシュするテンプレートを選択し、「チェックした項目のパブリッシュ」をクリックします。

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

ブレッドクラム・テンプレートは、ブレッドクラム・エントリの表示方法を制御します。このテンプレートは、リージョンの作成時に選択します。

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

ブレッドクラムは通常、現在のページが、アプリケーション内の他のページに対してどの位置にあるかを示します。また、ユーザーは特定のページをクリックするだけで、そのページを表示することができます。たとえば、Oracle Application Expressのユーザー・インタフェースでは、各ページの上部にブレッドクラム・パスが表示されます。

bc_menu.gifの説明が続きます
bc_menu.gifの説明


参照:

  • ブレッドクラム・テンプレートの編集ページ固有のセクションを使用する方法については、オンライン・ヘルプを参照してください。

  • 「ブレッドクラムの作成」


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

ここでは、ブレッドクラム・テンプレートの編集ページの特定のセクションについて説明します。ページの各セクションにアクセスするには、ページをスクロール・ダウンするか、ページ上部のナビゲーション・ボタンをクリックします。ページの上部でボタンを選択すると、選択したセクションが表示され、その他すべてのセクションは一時的に非表示になります。ページの全セクションを表示するには、「すべて表示」をクリックします。

名前

「名前」は、テンプレートの名前を示します。テンプレートに翻訳が必要なテキスト文字列が含まれていることを示すには、「翻訳可能」チェック・ボックスを使用します。「テーマ」は、テンプレートが関連付けられているテーマを示します。

「テンプレート・クラス」は、そのテンプレートに固有の用途を示します。新しいテーマに切り替えると、あるテーマのすべてのテンプレートは、別のテーマの対応するテンプレートにマップされます。アプリケーション・ビルダーは、テンプレート・クラスの割当てによってこのテンプレート・マッピングを行います。

サブスクリプション

カレント・アプリケーションに既存のテンプレートを適用するには、「サブスクリプション」を使用します。既存のテンプレートを選択すると、ユーザーはそのテンプレートのサブスクライバになります。

マスター・テンプレートの新しいコピーをロードするには、「リフレッシュ」をクリックします。

テンプレート・タイプ

次のいずれかのテンプレート・スタイルを選択します。

  • 子ブレッドクラム・エントリ: カレント・ページの親ブレッドクラムの子(現在のブレッドクラムと同等)であるすべてのブレッドクラム・エントリを表示します。

  • カレント・ブレッドクラム: 共通の親を持つすべてのブレッドクラム・エントリを順番に表示します。

  • 親ブレッドクラム・エントリ: カレント・ページの親ブレッドクラム(現在のブレッドクラム・エントリよりも1階層上のブレッドクラム)のすべてのブラッドクラム・エントリを表示します。

  • 親からリーフ(ブレッドクラム・スタイル): カレント・ページのブレッドクラム・エントリと、その左側にルート・ノードまでの親エントリを表示します。

定義

表10-3に、使用可能なブレッドクラム・エントリの属性を示します。

表10-3 ブレッドクラム・エントリの制御属性

属性 説明

最初の前

最初のブレッドクラム・エントリの前に表示するテキストを定義します。

カレント・ページのブレッドクラム・エントリ

カレント・ページに対応するブレッドクラム・エントリの外観を定義します。この属性は、次の置換文字列をサポートします。

  • #NAME#: ブレッドクラム・エントリの短縮名を指定します。

  • #LINK#: ブレッドクラム・エントリのアンカー・ターゲットを指定します。

  • #LONG_NAME#: ブレッドクラム・エントリの詳細名を指定します。

カレント・ページ以外のブレッドクラム・エントリ

カレント・ページに対応していないブレッドクラム・エントリの外観を定義します。この属性は、次の置換文字列をサポートします。

  • #NAME#: ブレッドクラム・エントリの短縮名を指定します。

  • #LINK#: ブレッドクラム・エントリのアンカー・ターゲットを指定します。

  • #LONG_NAME#: ブレッドクラム・エントリの詳細名を指定します。

最後の後

最後のブレッドクラム・エントリの後に表示するテキストを定義します。

レベル間

ブレッドクラム・エントリのレベル間に表示するテキストを定義します。たとえば、ブレッドクラムに3つのレベルがある場合、このテキストは、次の例の「X」の位置に表示されます。

main X cars X porsche X 911

最大レベル

ブレッドクラムをブレッドクラム・スタイルで表示する際に使用するレベル数を指定します。


リンク属性

「ブレッドクラム・リンク属性」を使用して、ブレッドクラム・エントリのハイパーテキスト・リンク属性を指定します。

コメント

この属性を使用して、このコンポーネントに関するコメントを記録します。

置換文字列

このテンプレートの置換文字列の用途を一覧します。置換文字列は、サブテンプレート内でコンポーネント値を参照するために使用されます。

ボタン・テンプレート

ボタン・テンプレートを使用すると、アプリケーション開発者は、ボタンのルック・アンド・フィールをカスタマイズできます。ボタンを作成する場合、複数のイメージまたはHTMLタグを使用できます。ボタン・テンプレートの使用はオプションです。

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

ここでは、ボタン・テンプレートの編集ページの特定のセクションについて説明します。ページの各セクションにアクセスするには、ページをスクロール・ダウンするか、ページ上部のナビゲーション・ボタンをクリックします。ページの上部でボタンを選択すると、選択したセクションが表示され、その他すべてのセクションは一時的に非表示になります。ページの全セクションを表示するには、「すべて表示」をクリックします。

名前

「テンプレート名」は、テンプレートの名前を示します。テンプレートに変換が必要なテキスト文字列が含まれているかどうかを示すには、「翻訳可能」チェック・ボックスを使用します。「テーマ」は、テンプレートが関連付けられているテーマを示します。

「テンプレート・クラス」は、そのテンプレートに固有の用途を示します。新しいテーマに切り替えると、あるテーマのすべてのテンプレートは、別のテーマの対応するテンプレートにマップされます。アプリケーション・ビルダーは、テンプレート・クラスの割当てによってこのテンプレート・マッピングを行います。

サブスクリプション

カレント・アプリケーションに既存のテンプレートを適用するには、「サブスクリプション」を使用します。既存のテンプレートを選択すると、ユーザーはそのテンプレートのサブスクライバになります。

マスター・テンプレートの新しいコピーをロードするには、「テンプレートのリフレッシュ」をクリックします。

定義

表示するボタン・テンプレートを定義するには、テンプレートを使用します。標準のアプリケーション置換文字列を含めることもできます。たとえば、&ITEM_NAME値はレンダリング時に置換できます。ボタン・テンプレートは、次の置換文字列をサポートします。

  • #LABEL#: ボタン・ラベルで置換されます。

  • #LINK#: URLで置換されます。置換された後、URLは、#dosubmit#、またはページを送信(リクエスト値を設定)するリダイレクトJavaScriptをコールするか、あるいは指定されたURLに単純にページをリダイレクトします。

コメント

この属性を使用して、このコンポーネントに関するコメントを記録します。

置換文字列

このテンプレートの置換文字列の用途を一覧します。置換文字列は、サブテンプレート内でコンポーネント値を参照するために使用されます。

カレンダ・テンプレート

カレンダ・テンプレートは、カレンダの外観と配置を制御します。このテンプレートは、頻繁にHTML表を使用して日付を配置します。#DD##MONTH#などの置換文字列を使用してカレンダ属性を配置します。サポートされている置換文字列のリストは、カレンダ・テンプレートの編集ページの右側に表示されます。テンプレートの置換文字列は大文字で指定し、シャープ記号(#)で囲む必要があることに注意してください。

カレンダ・テンプレート属性

ここでは、カレンダ・テンプレートの編集ページの特定のセクションについて説明します。ページの各セクションにアクセスするには、ページをスクロール・ダウンするか、ページ上部のナビゲーション・ボタンをクリックします。ページの上部でボタンを選択すると、選択したセクションが表示され、その他すべてのセクションは一時的に非表示になります。ページの全セクションを表示するには、「すべて表示」をクリックします。

カレンダ定義

名前

「名前」は、テンプレートの名前を示します。「テーマ」は、テンプレートが関連付けられているテーマを示します。

「テンプレート・クラス」は、そのテンプレートに固有の用途を示します。新しいテーマに切り替えると、あるテーマのすべてのテンプレートは、別のテーマの対応するテンプレートにマップされます。アプリケーション・ビルダーは、テンプレート・クラスの割当てによってこのテンプレート・マッピングを行います。

テンプレート・サブスクリプション

カレント・アプリケーションに既存のテンプレートを適用するには、「テンプレートのサブスクリプション」を使用します。既存のテンプレートを選択すると、ユーザーはそのテンプレートのサブスクライバになります。

マスター・テンプレートの新しいコピーをロードするには、「リフレッシュ」をクリックします。

コメント

この属性を使用して、このコンポーネントに関するコメントを記録します。

月別カレンダ、週間カレンダおよび日次カレンダ

「月別カレンダ」、「週間カレンダ」および「日次カレンダ」属性を使用して、特定のカレンダの外観および配置を制御します。

特定の属性の詳細を表示するには、属性ラベルをクリックします。ヘルプが使用できる場合、アイテム・ラベルの上にカーソルを置くとアイテム・ラベルは赤に変わり、カーソルは矢印と疑問符マークに変わります。「フィールドレベル・ヘルプについて」を参照してください。

ラベル・テンプレート

ラベル・テンプレートは、ページ・アイテム・ラベルのHTMLマークアップを集中管理することを目的としています。各アイテムにはオプションのラベルがあります。ラベル・テンプレートを使用して、これらのラベルの表示方法を制御できます。たとえば、ユーザーに必須であることを示すイメージ(アスタリスクなど)を参照する必須フィールドというラベル・テンプレートを作成できます。

ラベル・テンプレートを使用すると、アイテムの先頭と末尾に追加するテキスト文字列を定義できます。

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

ここでは、ラベル・テンプレートの編集ページの特定のセクションについて説明します。ページの各セクションにアクセスするには、ページをスクロール・ダウンするか、ページ上部のナビゲーション・ボタンをクリックします。ページの上部でボタンを選択すると、選択したセクションが表示され、その他すべてのセクションは一時的に非表示になります。ページの全セクションを表示するには、「すべて表示」をクリックします。

名前

「テンプレート名」は、テンプレートの名前を示します。テンプレートに翻訳が必要なテキスト文字列が含まれていることを示すには、「翻訳可能」チェック・ボックスを使用します。「テーマ」は、テンプレートが関連付けられているテーマを示します。

「テンプレート・クラス」は、そのテンプレートに固有の用途を示します。新しいテーマに切り替えると、あるテーマのすべてのテンプレートは、別のテーマの対応するテンプレートにマップされます。アプリケーション・ビルダーは、テンプレート・クラスの割当てによってこのテンプレート・マッピングを行います。

サブスクリプション

カレント・アプリケーションに既存のテンプレートを適用するには、「テンプレートのサブスクリプション」を使用します。既存のテンプレートを選択すると、ユーザーはそのテンプレートのサブスクライバになります。

マスター・テンプレートの新しいコピーをロードするには、「テンプレートのリフレッシュ」をクリックします。

定義

ラベルの前」では、アイテム・ラベルの前に表示するHTMLを入力します。「ラベルの前」では、置換文字列#CURRENT_FORM_ELEMENT#; #CURRENT_FORM_ID#および#CURRENT_ITEM_NAME#をサポートします。次に例を示します。

<label for="#CURRENT_ITEM_NAME#">
<a href="javascript:popupFieldHelp('#CURRENT_ITEM_ID#',
  '&APP_SESSION.','&CLOSE.')" > 

「ラベルの後」では、アイテム・ラベルの後に表示するHTMLを入力します。このラベルはこのリージョンのHTMLの前に自動的に表示されるため、「ラベルの前」リージョンの開始タグをここで閉じる必要があります。次に例を示します。

</a></label>
エラー表示

「ラベルの前のエラー発生時」では、アプリケーションがアイテムのインライン検証エラー・メッセージを表示する場合に、そのアイテム・ラベルの前に表示するHTMLを入力します。次に例を示します。

<font class="fieldtitleleft">#ERROR_MESSAGE#

「ラベルの後のエラー発生時」では、アプリケーションがアイテムのインライン検証エラー・メッセージを表示する場合に、そのアイテム・ラベルの後に表示されるHTMLを入力します。この属性では、置換文字列#CURRENT_FORM_ELEMENT##CURRENT_FORM_ID#および#CURRENT_ITEM_NAME#をサポートします。次の例では、表示されている、エラーの存在するアイテム・ラベルに空白と閉じカッコを追加します。

&nbsp;]</font>
コメント

この属性を使用して、このオブジェクトに関するコメントを記録します。

置換文字列

このテンプレートの置換文字列の用途を一覧します。置換文字列は、サブテンプレート内でコンポーネント値を参照するために使用されます。

リスト・テンプレート

リストは、リンクの共有コレクションです。リストの外観は、リスト・テンプレートで制御します。テンプレート属性を使用すると、特定のページのカレントまたは非カレントとしてリスト要素を定義できます。

階層リストについて

Oracle Application Expressでは、階層的なリストをサポートしています。階層的なリストを作成するには、次のことを行う必要があります。

  • 階層的なリストをサポートするリスト・テンプレートを選択します。階層的なリストをサポートするリスト・テンプレートを判別するには、サブリスト付きというネーミング規則のあるテンプレートを検索します。

  • 各リスト・エントリの作成時には親リスト・エントリを選択します。


参照:

  • リスト・テンプレートの編集ページ固有のセクションを使用する方法については、オンライン・ヘルプを参照してください。

  • 「リストの作成」


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

ここでは、リスト・テンプレートの編集ページの特定のセクションについて説明します。ページの各セクションにアクセスするには、ページをスクロール・ダウンするか、ページ上部のナビゲーション・ボタンをクリックします。ページの上部でボタンを選択すると、選択したセクションが表示され、その他すべてのセクションは一時的に非表示になります。ページの全セクションを表示するには、「すべて表示」をクリックします。

名前

「名前」は、テンプレートの名前を示します。テンプレートに翻訳が必要なテキスト文字列が含まれていることを示すには、「翻訳可能」チェック・ボックスを使用します。「テーマ」は、テンプレートが関連付けられているテーマを示します。

「テンプレート・クラス」は、そのテンプレートに固有の用途を示します。新しいテーマに切り替えると、あるテーマのすべてのテンプレートは、別のテーマの対応するテンプレートにマップされます。アプリケーション・ビルダーは、テンプレート・クラスの割当てによってこのテンプレート・マッピングを行います。

サブスクリプション

カレント・アプリケーションに既存のテンプレートを適用するには、「サブスクリプション」を使用します。既存のテンプレートを選択すると、ユーザーはそのテンプレートのサブスクライバになります。

マスター・テンプレートの新しいコピーをロードするには、「テンプレートのリフレッシュ」をクリックします。

リスト前のエントリ

リスト要素の前に表示するHTMLを入力します。この属性は、HTML表またはHTML表の行を開始するために使用できます。

テンプレート定義

カレントおよび非カレントのリスト・テンプレートを定義します。サポートされる置換文字列は、#LINK# #TEXT##IMAGE_PREFIX##IMAGE##IMAGE_ATTR#および#A01#から#A10#です。

  • カレント・リスト・テンプレート: 選択された(カレントの)リスト・テンプレートに置換されるHTMLまたはテキストを入力します。

  • サブリスト・アイテムが含まれているカレント・リスト・テンプレート: アイテムにサブリスト・アイテムが含まれる場合は、選択された(カレントの)リスト・テンプレートに置換されるHTMLまたはテキストを入力します。このテキストを指定しないと、現在のリスト・アイテム・テンプレートが使用されます。

  • 非カレント・リスト・テンプレート:選択されていない(非カレントの)リスト・テンプレートに置換されるHTMLまたはテキストを入力します。

  • サブリスト・アイテムが含まれている非カレント・リスト・テンプレート: アイテムにサブリスト・アイテムが含まれる場合は、選択されていない(非カレントの)リスト・テンプレートに置換されるHTMLまたはテキストを入力します。このテキストを指定しないと、現在のリスト・アイテム・テンプレートが使用されます。

  • リスト要素間: リスト要素の間に表示するHTMLを入力します。HTMLを指定しないと、この属性が無視されます。

サブリスト前のエントリ

サブリスト要素の前に表示するHTMLを入力します。

サブリスト・エントリ

カレントおよび非カレントのリスト・テンプレートを定義します。サポートされる置換文字列は、#LINK# #TEXT##IMAGE_PREFIX##IMAGE##IMAGE_ATTR#および#A01#から#A10#です。

  • カレント・サブリスト・テンプレート: 選択された(カレントの)リスト・テンプレートに置換されるHTMLまたはテキストを入力します。

  • サブリスト・アイテムが含まれているカレント・サブリスト・テンプレート: アイテムにサブリスト・アイテムが含まれる場合は、選択された(カレントの)リスト・テンプレートに置換されるHTMLまたはテキストを入力します。このテキストを指定しないと、現在のリスト・アイテム・テンプレートが使用されます。

  • 非カレント・サブリスト・テンプレート: 選択されていない(非カレントの)リスト・テンプレートに置換されるHTMLまたはテキストを入力します。

  • サブリスト・アイテムが含まれている非カレント・サブリスト・テンプレート: アイテムにサブリスト・アイテムが含まれる場合は、選択されていない(非カレントの)リスト・テンプレートに置換されるHTMLまたはテキストを入力します。このテキストを指定しないと、現在のリスト・アイテム・テンプレートが使用されます。

  • サブリスト・アイテム間: リスト要素の間に表示するHTMLを入力します。HTMLを指定しないと、この属性が無視されます。

サブリスト後のエントリ

サブリスト要素を表示した後に表示するHTMLを入力します。

リスト後のエントリ

すべてのリスト要素を表示した後に表示するHTMLを入力します。この属性を使用して、リスト前の要素属性で開始したHTML表を閉じることができます。

コメント

この属性を使用して、このオブジェクトに関するコメントを記録します。

置換文字列

このテンプレートの置換文字列の用途を一覧します。置換文字列は、サブテンプレート内でコンポーネント値を参照するために使用されます。

ページ・テンプレート

ページ・テンプレートは、ページの外観を定義します。各テンプレートは、ヘッダー・テンプレート、ボディ・テンプレート、フッター・テンプレートおよび多くのサブテンプレートで構成されます。ページ・レベル属性でページ・テンプレートを指定しない場合、Application Expressエンジンは、テーマの作成/編集ページで定義したデフォルトのページ・テンプレートを使用します。

ページ・テンプレートは、静的HTMLと実行時に置換される置換文字列を組み合せたものです。置換文字列を使用して、ページ・テンプレート内のコンポーネントの存在と配置を指定します。さらに、サブテンプレートを使用して、コンポーネントの表示方法を指定できます。

このセクションの構成は次のとおりです。

サポートされるページ・テンプレートの置換文字列

表10-4に、使用可能なページ・テンプレートの置換文字列を示します。テンプレートのすべての置換文字列は、大文字で指定し、シャープ記号(#)で囲む必要があることに注意してください。

特定のテンプレートでサポートされる置換文字列のレポートを表示するには、ページ・テンプレートの編集ページの「置換文字列」セクションを参照します。詳細は、「ページ・テンプレート属性」を参照してください。

表10-4 ページ・テンプレートの置換文字列

置換文字列 説明

#APP_VERSION#

ページ・テンプレートの「ヘッダー」または「フッター」セクションで使用できます。#APP_VERSION#の値は、定義の編集ページのバージョン属性で定義します。

参照: 「名前」

#BOX_BODY#

ボディを表示する位置を指定します。ボディがNULLの場合、かわりに#BOX_BODY#が使用されます。

#CUSTOMIZE#

ページ・テンプレートの「ヘッダー」、「ボディ」セクションで使用できます。

「リージョン定義」の「カスタマイズ」セクションを使用すると、エンド・ユーザーによるカスタマイズを可能にできます。この機能を使用するには、ページ・テンプレートに#CUSTOMIZE#置換文字列も含める必要があります。

エンド・ユーザーによるカスタマイズが1つ以上のリージョンでサポートされる場合、「カスタマイズ」というリンクがページ・テンプレートの#CUSTOMIZE#置換文字列が表示される場所に表示されます。このリンクをクリックするとウィンドウが表示され、ユーザーは、ページのリージョンのオン/オフを切り替えることができるようになります。

参照: 「リージョン属性の編集」

#FORM_CLOSE#

#FORM_OPEN#を含める場合は、ヘッダー、ボディまたはフッターのテンプレートに#FORM_CLOSE#を含める必要があります。#FORM_OPEN##BOX_BODY#の前、#FORM_CLOSE##BOX_BODY#置換文字列の後に指定する必要があります。

#FORM_OPEN#

HTMLのフォームの開始タグ<form>を配置する位置を指定します。フォームを送信するには、この置換文字列を含める必要があります。

ユーザー独自のフォームをオープン状態にコーディングする必要はありません。この操作はApplication Expressエンジンが行います。

#GLOBAL_NOTIFICATION#

グローバル通知属性を表示します。グローバル通知は、システム・ステータス(保留中のシステム停止時間など)との通信に使用します。APEX_APPLICATION.G_GLOBAL_NOTIFICATIONを使用すると、この値をプログラムによって設定できます。

参照: グローバル通知属性については、「グローバル通知属性」を参照してください。

#HEAD#

<head>開始タグと</head>閉じタグの間に使用します。オプションで、各ページの#HEAD#のコンテンツを定義できます(たとえば、追加のスタイルシートまたはJavaScriptライブラリを参照するように定義できます)。

#LOGO#

アプリケーションのロゴを指定します。

定義の編集ページの「ロゴ」セクションで、アプリケーションのロゴのイメージおよびイメージ属性を指定できます。この機能を使用するには、「ヘッダー」または「ボディ」ページ・テンプレートに置換文字列#LOGO#も含める必要があります。

参照: 「ロゴ」

#NAVIGATION_BAR#

ナビゲーション・バー・エントリの存在を定義します。ナビゲーション・バーは、この置換文字列を含むテンプレートを使用したアプリケーション内の各ページに表示されます。「ナビゲーション・バー」サブテンプレートを使用すると、この置換文字列を拡張できます。

参照: 「ナビゲーション・バー」サブテンプレートは、サブテンプレートを参照してください。

#NOTIFICATION_MESSAGE#

開発者がユーザーにメッセージを送信できます。インライン・エラー・メッセージのサマリーが表示される位置を定義します。インライン・エラー・メッセージは、フィールドの横または通知領域にインライン(あるいはその両方)で表示できます。

#ONLOAD#

ページ・テンプレートのヘッダーおよびフッターで使用できます。HTMLの<bodyタグ内に含める必要があります。次に例を示します。

<body #ONLOAD#>

JavaScriptコールでこの文字列を置換文字列として使用すると、Webブラウザでページがロードされたときにそのコールが実行されます。コールするJavaScriptは、ページごとに変更できます。

#PARENT_TAB_CELLS#

親タブの表示を指定します。親タブには標準タブが必要です。アプリケーションにタブの1つのレベルのみが含まれている場合は、この置換文字列は不要です。

参照: 親タブの属性の定義については、「標準タブ属性」を参照してください。

#REGION_POSITION_NN#

ページ内のリージョンの正確な位置を指定します。リージョンが指定されていない場合は、たとえば#REGION_POSITION_01#があるとすると、この#REGION_POSITION_01#は置換されません。

#SUCCESS_MESSAGE#

成功メッセージおよびエラー・メッセージを表示するページ内の位置を定義します。エラーなしでページ・プロセスが実行されると、このテキストが表示されます。

成功メッセージの前後にHTMLを追加すると、各テンプレートの成功メッセージの表示をカスタマイズできます。

#TAB_CELLS#

標準タブの表示を指定します。

参照: 「標準タブ属性」

#TITLE#

ページ・タイトルを定義します。通常、HTMLのtitleタグ内に含まれます。


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

ここでは、ページ・テンプレートの編集ページの特定のセクションについて説明します。ページの各セクションにアクセスするには、ページをスクロール・ダウンするか、ページ上部のナビゲーション・ボタンをクリックします。ページの上部でボタンを選択すると、選択したセクションが表示され、その他すべてのセクションは一時的に非表示になります。ページの全セクションを表示するには、「すべて表示」をクリックします。

名前

「名前」は、テンプレートの名前を示します。「テーマ」は、テンプレートが関連付けられているテーマを示します。

「テンプレート・クラス」は、そのテンプレートに固有の用途を示します。新しいテーマに切り替えると、あるテーマのすべてのテンプレートは、別のテーマの対応するテンプレートにマップされます。アプリケーション・ビルダーは、テンプレート・クラスの割当てによってこのテンプレート・マッピングを行います。テンプレートに翻訳が必要なテキスト文字列が含まれていることを示すには、「翻訳可能」チェック・ボックスを使用します。

サブスクリプション

カレント・アプリケーションに既存のテンプレートを適用するには、「サブスクリプション」を使用します。既存のテンプレートを選択すると、ユーザーはそのテンプレートのサブスクライバになります。

マスター・テンプレートの新しいコピーをロードするには、「テンプレートのリフレッシュ」を選択します。

定義

各テンプレートは、ヘッダー、ボディ、フッターおよびサブテンプレートで構成されます。動的コンテンツを含めるには、置換文字列を使用します。テンプレートのすべての置換文字列は、大文字で指定し、シャープ記号(#)で囲む必要があります。サポートされる置換文字列の詳細は、アイテム・ヘルプを参照してください。

「ヘッダー」は、ページ・テンプレートの最初のセクションです。HTMLドキュメントの<Head>セクションを定義するHTMLを入力します。表示するリージョンまたはAFTER HEADERを実行するプロセスおよび計算は、テンプレートのこのセクションがレンダリングされた直後に表示または実行されます。次に例を示します。

<html>
 <head>
   <title>#TITLE#</title>
   #HEAD#
 </head>

「ボディ」はページ・テンプレートの2番目のセクションで、ヘッダー・セクションとフッター・セクションの間にレンダリングされます。HTMLドキュメントの<Body>セクションを定義するHTMLを入力します。少なくとも#BOX_BODY#置換文字列を含める必要があります。#FORM_OPEN#および#FORM_CLOSE#置換文字列も含めることをお薦めします。次に例を示します。

   <body #ONLOAD#>
      #FORM_OPEN#
      #BOX_BODY#
      #FORM_CLOSE#
   </body>

「フッター」は、ボディの後に表示する、ページ・テンプレートの3番目のセクションです。

表示ポイント

「ブレッドクラム表示ポイント」は、ブレッドクラムを使用する生成済コンポーネントに適用され、ブレッドクラムが配置されるページ上の位置を定義します。「サイドバー表示ポイント」は、サイドバーを使用する生成済コンポーネントに適用され、サイドバーが配置されるページ上の位置を定義します。

サブテンプレート

「サブテンプレート」を使用すると、コンポーネントの表示方法を指定できます。選択可能なサブテンプレートは次のとおりです。

  • 成功メッセージ: #SUCCESS_MESSAGE#置換文字列を拡張します。プログラムによって、またはプロセスの属性として、成功メッセージを定義できます。成功メッセージが存在し、ページ・テンプレートが#SUCCESS_MESSAGE#置換文字列を含んでいる場合は、このサブテンプレートを使用して、メッセージをレンダリングします。

  • ナビゲーション・バー: ナビゲーション・バー・エントリの表示を制御します。#NAVIGATION_BAR#置換文字列がテンプレートのヘッダー、ボディまたはフッターで参照される際に置換されるHTMLまたはテキストを入力します。#BAR_BODY#置換文字列を使用して、各ナビゲーション・バー・アイコンが表示される位置を指定します。次の例では、#BAR_BODY#置換文字列により、適切なHTML表セルが生成されます。

    <table class="navBar"><tr>#BAR_BODY#</tr></table>
    
  • ナビゲーション・バー・エントリ: 各ナビゲーション・バー・エントリのナビゲーション・バー#BAR_BODY#置換文字列に置換されるHTMLまたはテキストを入力します。次の置換文字列を使用して、ナビゲーション・バー・エントリのサブテンプレートを作成します。

    次の置換文字列を使用して、ナビゲーション・バー・エントリのサブテンプレートを構成します。

    • #LINK#: エントリ・リンク

    • #TEXT#: エントリ・サブ・テキスト

    • #IMAGE#: エントリ・イメージ

      ナビゲーション・バー・エントリで指定された場合、HTMLイメージのALT、HEIGHTおよびWIDTH引数はHTML IMGタグに含まれます。

    • #EDIT#: インライン編集のリンク編集機能

    • #WIDTH#: イメージの幅

    • #HEIGHT#: イメージの高さ

    • #COLSPAN#: HTML COLSPAN値

    • #ALT#: イメージの代替テキスト

  • 通知: #NOTIFICATION_message#置換文字列が、テンプレートのヘッダー、ボディまたはフッターで参照される際に置換されるHTMLまたはテキストを入力します。置換文字列#MESSAGE#を使用して、通知メッセージにメッセージ本体が表示される位置を指定します。

標準タブ属性

アプリケーションに標準タブが含まれている場合は、この属性を移入する必要があります。#TAB_CELLS#置換文字列を使用して、ページ・テンプレートのヘッダー、ボディまたはフッターに標準タブを配置できます。ページ・テンプレートのヘッダー、ボディ、フッターは、HTML表および行を定義します。このサブテンプレートは、特定のセルを定義することによって、これらのタブの表示方法を定義します。選択可能な属性は次のとおりです。

  • カレント・タブ: 現在選択されている標準タブに置換されるHTMLまたはテキストを入力します。タブがカレントであるかどうかは、標準タブ属性によって判別されます。次に例を示します。

    <td>#TAB_LABEL#</td>
    
  • 非カレント標準タブ: 選択されていない標準タブに置換されるHTMLまたはテキストを入力します。#TAB_TEXT#置換文字列を使用して、テンプレート内のタブ・ラベルおよびリンクの位置を指定してください。次に例を示します。

    <td><a href="#TAB_LINK#">#TAB_LABEL#</a></td>
    
親タブ属性属性

アプリケーションに2つのレベルのタブが含まれている場合は、この属性を移入する必要があります。選択された親タブに置換されるHTMLまたはテキストを入力します。#PARENT_TAB_CELLS#置換文字列を使用して、ページ・テンプレートのヘッダー、ボディまたはフッターに親タブを配置できます。親タブは、標準タブと組み合せた場合にのみ表示されます。選択可能な属性は次のとおりです。

  • カレント親タブ: 選択された親タブに置換されるHTMLまたはテキストを入力します。タブがカレントかどうかは、表示されるページと、ページで使用している標準タブ・セットで判断します。#TAB_TEXT#置換文字列を使用して、テンプレート内のタブ・ラベルおよびリンクの位置を指定してください。次に例を示します。

    <td><a href="#TAB_LINK#">#TAB_LABEL#</a></td>
    
  • 非カレント親タブ: 選択されていない親タブに置換されるHTMLまたはテキストを入力します。#TAB_TEXT#置換文字列を使用して、テンプレート内のタブ・ラベルおよびリンクの位置を指定してください。次に例を示します。

    <td><a href="#TAB_LINK#">#TAB_LABEL#</a></td>
    
イメージ・ベースのタブ属性

このサブテンプレートは、完全にイメージに基づくタブに使用します。選択可能な属性は次のとおりです。

  • カレント・イメージ・タブ: イメージベースのタブが現在選択されていることを示すために使用するHTMLを入力します。タブに表示される名前を示す#TAB_TEXT#置換文字列を含めます。

  • 非カレント・イメージ・タブ: イメージ・タブは現在選択されていないことを示すために使用するHTMLを入力します。タブに表示される名前を示す#TAB_TEXT#置換文字列を含めます。

複数列のリージョン表属性

Application Expressエンジンが同じリージョン位置の複数の列にリージョンを表示する場合、Oracle Application ExpressはHTML表をレンダリングします。この属性によって、<table>タグの属性を制御できます。

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

ページ・テンプレートをエラー・テンプレートとして指定する場合にのみ、この属性を使用します。#MESSAGE#置換文字列を使用してエラー・メッセージを配置し、#BACK_LINK#置換文字列を使用して前のページに戻るリンクを表示します。アプリケーション属性を編集すると、テンプレートをエラー・テンプレートとして指定できます。次に例を示します。

#MESSAGE#

<br>

<a href="#BACK_LINK#">back</a>
コメント

この属性を使用して、このコンポーネントに関するコメントを記録します。

置換文字列

このテンプレートの置換文字列の用途を一覧します。置換文字列は、サブテンプレート内でコンポーネント値を参照するために使用されます。

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

ポップアップLOVテンプレートは、POPUPとして定義したすべてのアイテムに対するポップアップ・リストの表示方法を制御します。ポップアップLOVテンプレートは、各テーマに1つのみ指定できます。

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

ここでは、ポップアップLOVテンプレートの編集ページの特定のセクションについて説明します。ページの各セクションにアクセスするには、ページをスクロールするか、ページ上部のナビゲーション・ボタンをクリックします。ページの上部でボタンを選択すると、選択したセクションが表示され、その他すべてのセクションは一時的に非表示になります。ページの全セクションを表示するには、「すべての表示」をクリックします。

アプリケーション

テーマは、テンプレートが関連付けられているテーマを示します。「テンプレート・クラス」は、そのテンプレートに固有の用途を示します。新しいテーマに切り替えると、あるテーマのすべてのテンプレートは、別のテーマの対応するテンプレートにマップされます。アプリケーション・ビルダーは、テンプレート・クラスの割当てによってこのテンプレート・マッピングを行います。テンプレートに翻訳が必要なテキスト文字列が含まれていることを示すには、「翻訳可能」チェック・ボックスを使用します。

サブスクリプション

カレント・アプリケーションに既存のテンプレートを適用するには、「サブスクリプション」を使用します。既存のテンプレートを選択すると、ユーザーはそのテンプレートのサブスクライバになります。

マスター・テンプレートの新しいコピーをロードするには、「テンプレートのリフレッシュ」をクリックします。

アイコン

「ポップアップ・アイコン」を使用して、POPUPタイプのアイテムのフォーム・フィールドの右側に表示するアイコンを指定します。デフォルトでは、Application Expressエンジンはlist.gifイメージを使用します。「ポップアップ・アイコン属性」を使用して、ポップアップ・アイコンのイメージ属性(高さや幅など)を定義します。

検索

これらの属性を使用して、「検索」フィールドの表示方法を指定します。表10-5に、使用可能な検索フィールドの属性を示します。

表10-5 検索フィールドの属性

属性 説明

フィールド・テキストの前

ポップアップLOVの検索フィールドを表示する前に表示するテキストを定義します。

フィルタ幅

テキスト・フィールドをこの幅で表示します。

フィルタ最大幅

この最大幅でテキスト・フィールドを表示します。

フィルタ・テキスト属性

これらの属性でテキスト・フィールドを表示します。これはHTMLのinputタグ内に含まれます。

フィールド・テキストの後

検索フィールド、検索ボタンおよび閉じるボタンを表示した後にこのテキストを表示します。


ボタン

これらの属性を使用して、ボタン名および「検索」、「閉じる」、「次へ」および「戻る」ボタンの属性を定義します。

ウィンドウ

JavaScriptを使用してポップアップLOVが実行されます。これらの属性を使用して、scrollbars=resizable=width=およびheight=の値を制御します。デフォルトの値の詳細は、アイテム・ヘルプを参照してください。

ページ区切り

行カウント結果の表示方法を定義します。

結果セット

これらの属性を使用して、結果セットの前後に表示するテキストまたはHTMLを定義します。

ページ属性

これらの属性を使用してポップアップ・ページを定義します。詳細は、アイテム・ヘルプを参照してください。

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

リージョン・テンプレートは、リージョン属性の外観と配置を制御します。このテンプレートは、頻繁にHTML表を使用してコンテンツを配置します。

リージョン・テンプレートはリージョンにスタイル要素を適用します。また、置換文字列を表示します。#BODY#は必須の置換文字列であり、リージョン・ソースが配置される位置を指定します。他のすべての置換文字列はオプションです。これらの置換文字列を使用すると、リージョン内のページ・コントロール(ボタンなど)の存在と配置を指定できます。

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

ここでは、リージョン・テンプレートの編集ページの特定のセクションについて説明します。ページの各セクションにアクセスするには、ページをスクロールするか、ページ上部のナビゲーション・ボタンをクリックします。ページの上部でボタンを選択すると、選択したセクションが表示され、その他すべてのセクションは一時的に非表示になります。ページの全セクションを表示するには、「すべての表示」をクリックします。

名前

「名前」は、テンプレートの名前を示します。「テーマ」は、テンプレートが関連付けられているテーマを示します。

「テンプレート・クラス」は、そのテンプレートに固有の用途を示します。新しいテーマに切り替えると、あるテーマのすべてのテンプレートは、別のテーマの対応するテンプレートにマップされます。アプリケーション・ビルダーは、テンプレート・クラスの割当てによってこのテンプレート・マッピングを行います。テンプレートに翻訳が必要なテキスト文字列が含まれていることを示すには、「翻訳可能」チェック・ボックスを使用します。

サブスクリプション

カレント・アプリケーションに既存のテンプレートを適用するには、「テンプレートのサブスクリプション」を使用します。既存のテンプレートを選択すると、ユーザーはそのテンプレートのサブスクライバになります。

マスター・テンプレートの新しいコピーをロードするには、「テンプレートのリフレッシュ」をクリックします。

定義

リージョン・テンプレートにより、リージョンと呼ばれるページ部分の外観が決まります。置換文字列を使用して、リージョン内のコンポーネントの存在と配置を指定します。必要な置換文字列は#BODY#のみです。これにより、リージョンのソースを配置する位置が指定されます。その他すべての置換文字列はオプションです。有効な置換文字列は次のとおりです。

  • #TITLE#

  • #EXPAND#

  • #CHANGE#

  • #BODY#

  • #FORM_OPEN#

  • #FORM_CLOSE#

リージョン位置にボタンを作成すると、定義した位置が選択リストに表示されます。次の置換文字列を使用して、リージョンにボタンを配置する位置を定義してください。

  • #EDIT#

  • #CLOSE#

  • #CREATE#

  • #EXPAND#

  • #HELP#

  • #DELETE#

  • #COPY#

  • #NEXT#

  • #PREVIOUS#

フォーム表属性

ページ・アイテムは、リージョン内で表示されます。アイテムは、HTML表のHTMLフォームの要素としてレンダリングされます。このテンプレートのプロパティで、<table>タグに配置する属性を定義できます。次に例を示します。

class="instructiontext"
コメント

この属性を使用して、このコンポーネントに関するコメントを記録します。

置換文字列

このテンプレートの置換文字列の用途を一覧します。置換文字列は、サブテンプレート内でコンポーネント値を参照するために使用されます。

レポート・テンプレート

レポート列テンプレートによって、SQL問合せによって戻される1行の結果を制御できます。このタイプのテンプレートは、行全体ではなく、セルを定義します。

各レポート・テンプレートでは、#1#、#2#、#3#などの構文を使用して列名を識別します。#ENAME##EMPNO#などの列名の置換構文を使用して、列に名前を付けることもできます。 アプリケーションのどのアイテムもテンプレート内で参照できます。 たとえば、テンプレートのABC.というアイテムを参照するには、置換文字列&ABC.を正確に含めます。ABC.の実際の値は、ABCという名前のアプリケーションのアイテムを編集するエンド・ユーザーによって提供されます。

このセクションの構成は次のとおりです。

汎用列テンプレートおよび名前付き列テンプレートについて

Oracle Application Expressには、次の2種類のレポート・テンプレートが含まれています。

  • 汎用列テンプレート

  • 名前付き列テンプレート

汎用列テンプレート

汎用列テンプレートは、列の外観を1回定義することによって、レポートの外観を決定します。その後、この外観は、レポート定義に指定された列の数に基づいて、必要なだけ繰り返されます。このタイプのテンプレートを使用できるのは、行および列が標準的な構造のレポートに限られます。条件を使用すると、このタイプのテンプレートでレポートに追加のスタイルを適用できます。

次の例では、各列で特定のスタイルを使用する方法を示します。

<td class="tabledata" align="#ALIGN#">#COLUMN_VALUE#</td>

この例では、ページ・テンプレートにクラスtabledataを含むCSSが存在することを想定しています。また、この例では、置換文字列#ALIGN#および#COLUMN_VALUE#を使用しています。実際にこのレポートを実行すると、これらの置換文字列は、SQL問合せの結果によって生成された値に置換されます。

問合せの選択リストに式を使用する場合は、列の別名を作成して実行時エラーを回避することをお薦めします。たとえば、次のような問合せを考えてみます。

SELECT ename, (sal + comm) * 12 FROM emp

問合せをリライトして、次のように列に別名を付けることができます。

SELECT ename, (sal + comm) * 12 yearly_comp FROM emp
名前付き列テンプレート

名前付き列テンプレートを使用すると、より柔軟にレポートを設計できます。ただし、名前付きテンプレートは名前で列を参照するため、それらの列を基にしたレポートでのみ使用されます。次に例を示します。

<tr><td>#ENAME#</td><td>#SAL#</td></tr>

名前付き列テンプレートは自由度の高いものですが、問合せごとに新しいテンプレートを作成する必要がある場合があります。位置表記を含めることもできます。次の例では、HTMLおよび置換文字列を使用する方法を示します。

<tr><td>#ENAME#</td><td>#SAL#</td></tr>

<tr><td>#1#</td><td>#2#</td></tr>

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

ここでは、汎用列テンプレートのレポート・テンプレートの編集・ページの特定のセクションについて説明します。ページの各セクションにアクセスするには、ページをスクロール・ダウンするか、ページ上部のナビゲーション・ボタンをクリックします。ページの上部でボタンを選択すると、選択したセクションが表示され、その他すべてのセクションは一時的に非表示になります。ページの全セクションを表示するには、「すべて表示」をクリックします。

レポート・テンプレート

「テンプレート名」は、テンプレートの名前を示します。「テンプレート・タイプ」には、テンプレートのタイプを指定します。名前付き列テンプレートは、テンプレートの列名を参照します。汎用列テンプレートは、テンプレートの#COLUMN_VALUE#置換文字列を参照します。

「テーマ」は、テンプレートが関連付けられているテーマを示します。「テンプレート・クラス」は、そのテンプレートに固有の用途を示します。新しいテーマに切り替えると、あるテーマのすべてのテンプレートは、別のテーマの対応するテンプレートにマップされます。アプリケーション・ビルダーは、テンプレート・クラスの割当てによってこのテンプレート・マッピングを行います。テンプレートに翻訳が必要なテキスト文字列が含まれていることを示すには、「翻訳可能」チェック・ボックスを使用します。

テンプレート・サブスクリプション

カレント・アプリケーションに既存のテンプレートを適用するには、「テンプレートのサブスクリプション」を使用します。既存のテンプレートを選択すると、ユーザーはそのテンプレートのサブスクライバになります。

マスター・テンプレートの新しいコピーをロードするには、「テンプレートのリフレッシュ」をクリックします。

行の前

「行の前」では、レポート・テンプレートの最初に1回表示するHTMLを入力します。HTML表は、一般的に、次のようにこの属性を使用して開始します。

<table>

構文#1##2##3#を使用して列ヘッダーを指定できます。次に例を示します。

<th>#1#</th><th>#2#</th><th>#3#</th>

置換文字列#top_pagination#を含めることによって、レポートの上部にページ区切りを含めることができます。この置換文字列は、開始タグ<tr>で始まり、閉じタグ</tr>で終わるHTMLを生成します。たとえば、表の開始タグと#TOP_PAGINATION#置換文字列を含めるには、次のように入力します。

<table>#TOP_PAGINATION#

また、置換文字列 #CSV_LINK#を使用すると、ほぼすべてのスプレッドシート・プログラムと互換性があるカンマ区切り値(CSV)形式にレポートをエクスポートできるようになります。

列ヘッダー

「列ヘッダー・テンプレート」を使用して、各列ヘッダーのセルに色を追加します。この属性のテキストには、セルのヘッダー・テキストをカラー化する位置を指定する必要があります。次に例を示します。

 <th #ALIGNMENT#>#COLUMN_HEADER#</th>

列ヘッダーを使用しない場合は、次のように入力します。

OMIT

この属性を使用しない場合は、Application Expressエンジンによって、デフォルトの列ヘッダー・テンプレートが適用されます。

各行の前

「各行の前」では、レポートのすべての列の前に表示するテキストを入力します。この属性は、新しいHTML行を開始するために使用します。「各行の前」では、次の置換文字列をサポートします。

  • #ROWNUM#

    この置換文字列は、現行の行を指定するために使用します。

  • #COLCOUNT#

    この置換文字列は、列の数を指定するために使用します。

  • #HIGHLIGHT_ROW#

    この置換文字列は、ハイライトされた行の数を指定するために使用します。

テンプレート

列テンプレートは、各列の外観を定義します。最大4つの列テンプレートを定義できます。各テンプレートは、条件付きにできます。たとえば、偶数行と奇数行に異なる背景色を指定したり、PL/SQLで定義した条件に一致する行をハイライトできます。

各列テンプレートでは、各列の外観を定義します。表10-6に、列テンプレートでサポートされる置換文字列を示します。

表10-6 列テンプレートの置換文字列

置換文字列 説明

#ALIGNMENT#

列の位置合せを指定します。ユーザーが指定します。

#COLCOUNT#

列数のカウントを定義します。

#COLNUM#

現在の列番号を定義します。

#COLUMN_HEADER#

列ヘッダーを定義します。

#COLUMN_VALUE#

列の値に置換されます。

#ROWNUM#

現在の行番号を指定します。


次に例を示します。

<td> #ALIGNMENT#>#COLUMN_VALUE#</td>

実際にこのレポートを実行すると、これらの置換文字列は、SQL問合せの結果によって生成された値に置換されます。

条件を作成すると、指定した条件に一致するかどうかによって列の表示が異なるレポートを作成できます。条件付きで使用される列テンプレートを指定するには、列テンプレートの条件リストから条件タイプを選択します。有効な値は、次のとおりです。

  • PL/SQL式に基づく使用: その行のデータに基づき、条件付きで列を書式化します。

  • 偶数行で使用: 偶数行を条件付きで書式化します。

  • 奇数行で使用: 奇数行を条件付きで書式化します。

「PL/SQL式に基づく使用」を選択する場合は、次に列テンプレートの式フィールドでPL/SQL式を入力します。たとえば、次の式で値が2000より大きい場合、その値を太字で表示します。

#SAL# > 2000

置換文字列#ROWNUM#を使用することもできます。次に例を示します。

#ROWNUM# > 2000
各行の後

「各行の後」には、レポートを表示する際にすべての列の後に表示するHTMLを入力します。多くの場合、この属性は、HTML表の行を閉じるために使用されます。次に例を示します。

</tr>
行の後

行の後」を使用して、最後の行の後に表示するテキストを指定します。HTML表のタグは、一般的に、この属性を使用して閉じます。次に例を示します。

</table>

「行の後」属性は、次の置換文字列をサポートします。

  • #PAGINATION#

    ページ区切り属性で置換されます。

  • #COLCOUNT#

    実行時に、レポートで定義された列数に置換されます。

行選択

チェックした行のバックグラウンド・カラー」を使用して、行セレクタが選択されている場合のレポート行の背景色を制御します。「カレント行のバックグラウンド・カラー」を使用して、ユーザーがその行の上にマウスを移動した場合のレポート行の背景色を制御します。

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

ページ区切りのサブテンプレート・セクションには、「ページ区切りテンプレート」、「次のページ・テンプレート」、「前のページ・テンプレート」、「次のセット・テンプレート」および「前のセット・テンプレート」を編集する属性が含まれています。ページ区切りのサブテンプレートは、置換文字列#PAGINATION_NEXT##PAGINATION_NEXT_SET##PAGINATION_PREVIOUS#および#PAGINATION_PREVIOUS_SET#をサポートしています。表10-7に、これらのテンプレートについて示します。

表10-7 ページ区切りのサブテンプレート属性

ページ区切りサブテンプレート属性 説明

ページ区切りテンプレート

ページ区切りサブテンプレート全体に適用します。次に例を示します。

<span class="instructiontext">#TEXT#</span>

置換文字列#TEXT#を使用して、ページ区切りサブテンプレートを表示する場所を指定します。

個々のアイテムを変更するには、その他のページ区切りサブテンプレート属性を使用します。

次のページ・テンプレート

ページ区切りサブテンプレートの「次のページ」部分を表示する方法を変更するHTMLを入力します。次に例を示します。

<a href="#LINK#">next</a>

前のページ・テンプレート

ページ区切りサブテンプレートの「前のページ」部分を表示する方法を変更するHTMLを入力します。次に例を示します。

<a href="#LINK#">previous</a>

次のセット・テンプレート

ページ区切りサブテンプレートの「次のセット」部分を表示する方法を変更するHTMLを入力します。次に例を示します。

<a href="#LINK#">next set</a>

前のセット・テンプレート

ページ区切りサブテンプレートの「前の設定」部分を表示する方法を変更するHTMLを入力します。次に例を示します。

<a href="#LINK#">previous set</a>

コメント

この属性を使用して、このコンポーネントに関するコメントを記録します。

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

ここでは、名前付き列テンプレートのレポート・テンプレートの編集ページの特定のセクションについて説明します。ページの各セクションにアクセスするには、ページをスクロール・ダウンするか、ページ上部のナビゲーション・ボタンをクリックします。ページの上部でボタンを選択すると、選択したセクションが表示され、その他すべてのセクションは一時的に非表示になります。ページの全セクションを表示するには、「すべて表示」をクリックします。

名前

「テンプレート名」は、テンプレートの名前を示します。「テンプレート・タイプ」には、テンプレートのタイプを指定します。名前付き列テンプレートは、テンプレートの列名を参照します。汎用列テンプレートは、テンプレートの#COLUMN_VALUE#置換文字列を参照します。

「テーマ」は、テンプレートが関連付けられているテーマを示します。テンプレートに翻訳が必要なテキスト文字列が含まれていることを示すには、「翻訳可能」チェック・ボックスを使用します。「テンプレート・クラス」は、そのテンプレートに固有の用途を示します。新しいテーマに切り替えると、あるテーマのすべてのテンプレートは、別のテーマの対応するテンプレートにマップされます。アプリケーション・ビルダーは、テンプレート・クラスの割当てによってこのテンプレート・マッピングを行います。

サブスクリプション

カレント・アプリケーションに既存のテンプレートを適用するには、「サブスクリプション」を使用します。既存のテンプレートを選択すると、ユーザーはそのテンプレートのサブスクライバになります。

マスター・テンプレートの新しいコピーをロードするには、「リフレッシュ」をクリックします。

テンプレート

行テンプレートは、各行の外観を定義します。最大4つの行テンプレートを定義できます。各テンプレートは、条件付きにできます。

各行テンプレートでは、各行の外観を定義します。表10-8に、行テンプレートでサポートされる置換文字列を示します。

表10-8 行テンプレートの置換文字列

置換文字列 説明

#ALIGNMENT#

行の位置合せを指定します。ユーザーが指定します。

#COLCOUNT#

列数のカウントを定義します。

#COLNUM#

現在の列番号を定義します。

#COLUMN_HEADER#

列ヘッダーを定義します。

#COLUMN_VALUE#

列の値に置換されます。

#ROWNUM#

現在の行番号を指定します。


条件を作成すると、指定した条件に一致するかどうかによって行の表示が異なるレポートを作成できます。条件付きで使用される行テンプレートを指定するには、行テンプレートの条件リストから条件タイプを選択します。有効な値は、次のとおりです。

  • PL/SQL式に基づく使用: その行のデータに基づき、条件付きで列を書式化します。

  • 偶数行で使用: 偶数行を条件付きで書式化します。

  • 奇数行で使用: 奇数行を条件付きで書式化します。

「PL/SQL式に基づく使用」を選択する場合は、次に列テンプレートの式フィールドでPL/SQL式を入力します。たとえば、次の式で値が2000より大きい場合、その値を太字で表示します。

#SAL# > 2000

置換文字列#ROWNUM#を使用することもできます。次に例を示します。

#ROWNUM# > 2000
列見出し

各列ヘッダーのセルに色を追加するには、このテンプレートを使用します。この属性のテキストには、セルのヘッダー・テキストをカラー化する位置を指定する必要があります。「列ヘッダー・テンプレート」を入力しない場合は、デフォルトの列ヘッダー・テンプレートが適用されます。列ヘッダーを使用しない場合は、OMITを入力します。次に例を示します。

 <th #ALIGNMENT#>#COLUMN_HEADER#</th>
最初の前および最後の後のテキスト

「行の前」では、レポート・テンプレートの最初に1回表示するHTMLを入力します。HTML表は、一般的に、次のようにこの属性を使用して開始します。

<table>

構文#1##2##3#を使用して列ヘッダーを指定できます。次に例を示します。

<th>#1#</th><th>#2#</th><th>#3#</th>

置換文字列#top_pagination#を含めることによって、レポートの上部にページ区切りを含めることができます。この置換文字列は、開始タグ<tr>で始まり、閉じタグ</tr>で終わるHTMLを生成します。たとえば、表の開始タグと#TOP_PAGINATION#置換文字列を含めるには、次のように入力します。

<table>#TOP_PAGINATION#

また、置換文字列#CSV_LINK#を使用すると、ほぼすべてのスプレッドシート・プログラムと互換性があるCSVフォーマットにレポートをエクスポートできるようになります。

行の後」を使用して、最後の行の後に表示するテキストを指定します。HTML表のタグは、一般的に、この属性を使用して閉じます。次に例を示します。

</table>

「行の後」属性は、次の置換文字列をサポートします。

  • #PAGINATION#

    ページ区切り属性で置換されます。

  • #COLCOUNT#

    実行時に、レポートで定義された列数に置換されます。

ページ区切り

「ページ区切り」セクションには、「ページ区切りテンプレート」、「次のページ・テンプレート」、「前のページ・テンプレート」、「次のセット・テンプレート」および「前のセット・テンプレート」を編集する属性が含まれています。ページ区切りのサブテンプレートは、置換文字列#PAGINATION_NEXT##PAGINATION_NEXT_SET##PAGINATION_PREVIOUS#および#PAGINATION_PREVIOUS_SET#をサポートしています。表10-9に、これらのテンプレートについて示します。

表10-9 ページ区切りのサブテンプレート属性

ページ区切りサブテンプレート属性 説明

ページ区切りテンプレート

ページ区切りサブテンプレート全体に適用します。次に例を示します。

<span class="instructiontext">#TEXT#</span>

置換文字列#TEXT#を使用して、ページ区切りサブテンプレートを表示する場所を指定します。

個々のアイテムを変更するには、その他のページ区切りサブテンプレート属性を使用します。

次のページ・テンプレート

ページ区切りサブテンプレートの「次のページ」部分を表示する方法を変更するHTMLを入力します。次に例を示します。

<a href="#LINK#">next</a>

前のページ・テンプレート

ページ区切りサブテンプレートの「前のページ」部分を表示する方法を変更するHTMLを入力します。次に例を示します。

<a href="#LINK#">previous</a>

次のセット・テンプレート

ページ区切りサブテンプレートの「次のセット」部分を表示する方法を変更するHTMLを入力します。次に例を示します。

<a href="#LINK#">next set</a>

前のセット・テンプレート

ページ区切りサブテンプレートの「前の設定」部分を表示する方法を変更するHTMLを入力します。次に例を示します。

<a href="#LINK#">previous set</a>

コメント

この属性を使用して、このコンポーネントに関するコメントを記録します。

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

JavaScriptを使用すると、データベース内の値に応じてHTMLを条件付きで表示できます。次の例では、GROUP_DESC問合せ列がNULLでない場合にのみHTML行が表示されます。

<script language="javascript">
IF ( "#GROUP_DESC#" != "" )
document.writeln( "<TR>;
<TD BGCOLOR=#336699>;</TD>
</TR>
</TR>
<TD>#GROUP_DESC#</TD>
                </TR>" );
        </TR>" );


参照:

  • レポート・テンプレートの編集ページ固有のセクションを使用する方法については、オンライン・ヘルプを参照してください。

  • 「リージョンの理解」


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

カスケード・スタイルシート(CSS)によって、構造を変更せずにWebページのスタイルを制御できます。CSSを適切に使用すると、カラー、余白、フォントなどの視覚属性がHTMLドキュメントの構造から切り離されます。Oracle Application Expressのテーマには、独自のCSSを参照するテンプレートを含めることができます。特定のテーマの各CSSで定義されたスタイル・ルールによって、レポートおよびリージョンの表示も指定されます。

このセクションの構成は次のとおりです。

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

カスケード・スタイルシートを作業領域にアップロードするには、カスケード・スタイルシート・リポジトリを使用します。アップロードされたカスケード・スタイルシート(CSS)は、作業領域に作成されたすべてのアプリケーションで使用できます。カスケード・スタイルシートは、ファイル・システムに書き込まれるため、HTMLソース・コードで参照できます。

カスケード・スタイルシートをアップロードするには、次のステップを実行します。

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

  2. アプリケーションを選択します。

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

    共有コンポーネント・ページが表示されます。

  4. 「ファイル」で、「カスケード・スタイルシート」を選択します。

    カスケード・スタイルシート・ページが表示されます。

  5. 「ビュー」リストから「詳細」を選択します。詳細は、「カスケード・スタイルシート・ページについて」を参照してください。

  6. 新しいCSSをアップロードするには、「作成」をクリックして、画面に表示されるステップに従います。

  7. 既存のCSSを編集するには、CSSの名前を選択します。

  8. 既存のCSSをダウンロードするには、「ダウンロード」アイコンをクリックします。

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

CSSをCSSリポジトリにアップロードした後、「ビュー」リストで選択して、ページの表示方法を制御します。使用可能なオプションは次のとおりです。

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

ページ・テンプレートのヘッダー・セクション内でアップロードされたカスケード・スタイルシートを参照できます。ヘッダー・セクションを使用して、HTMLドキュメントの<HEAD>セクションを構成するHTMLを入力します。

アップロードされたカスケード・スタイルシートを参照するには、次のステップを実行します。

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

  2. アプリケーションを選択します。

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

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

    テーマ・ページが表示されます。

  5. 「タスク」リストで、「テンプレートの表示」をクリックします。

  6. 編集するページ・テンプレートの名前を選択します。

  7. Headセクション内の<link>タグを使用して、適切なスタイルシートを参照します。

    特定のアプリケーションに関連付けられたアップロード済ファイルを参照するには、置換文字列#APP_IMAGES#を使用します。次に例を示します。

    <html>
    <head>
        <title>#TITLE#</title>
        #HEAD#
        <link rel="stylesheet" href="#APP_IMAGES#sample2.css" type="text/css">
    </head>
    ...
    

    特定の作業領域に関連付けられたアップロード済ファイルを参照するには、置換文字列#WORKSPACE_IMAGES#を使用します。次に例を示します。

    <html>
    <head>
        <title>#TITLE#</title>
        #HEAD#
        <link rel="stylesheet" href="#WORKSPACE_IMAGES#sample3.css" type="text/css">
    </head>
    ...