プライマリ・コンテンツに移動

Oracle® Application Expressアプリケーション・ビルダー・ユーザーズ・ガイド リリース5.1 E83810-03 |
| 目次 | 索引

前 | 次 |

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

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

トピック:

- カスケード・スタイルシートについて
- ページ・テンプレートからのJavaScriptファイルのコールについて
- 置換文字列でのエスケープ構文の使用について
- デフォルトのページ・テンプレートの選択
- 新しいテンプレートの作成
- テンプレート・オプションの使用
- テンプレート・レポートの表示
- テンプレートの管理
- ブレッドクラム・テンプレート
- ボタン・テンプレート
- レガシー・カレンダ・テンプレート
- ラベル・テンプレート
- リスト・テンプレート
- ページ・テンプレート
- ポップアップLOVテンプレート
- リージョン・テンプレート
- レポート・テンプレート

関連項目:

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

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

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

組込みのテーマを使用する場合、テーマ固有のCSSファイルは次の場所にあります。

    /i/themes/theme_xx
    /i/themes/theme_xx/css

テーマ固有のイメージは次の場所にあります。

    /i/themes/theme_xx
    /i/themes/theme_xx/images

`xx`はテーマ番号です。テーマ固有のCSSファイルにはOracle Application Expressのバージョン番号が含まれており、以前のバージョンのテーマを使用しているアプリケーションをインポートした場合の下位互換性が維持されるようになっています。

関連項目:

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

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

Oracle Application Expressではページ・テンプレートで`.js`ファイルを参照できます。このアプローチによって、そのファイル内のすべてのJavaScriptがアプリケーションにアクセス可能になります。`.js`ファイルはアプリケーションの最初のページ・ビューにロードされてからブラウザでキャッシュされるため、これは最も効率的なアプローチです。

関連項目:

JavaScript

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

開発者は、先頭に感嘆符(`!`)の付いた事前定義済のフィルタ名を置換文字列に追加することで、置換値の特殊文字をエスケープできます。出力のエスケープは、ブラウザでクロス・サイト・スクリプティング(XSS)攻撃を回避するための重要なセキュリティ手法です。

関連項目:

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

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

この項では、デフォルト・ページ・テンプレートの選択方法について説明します。デフォルトのページ・テンプレートは、2つの方法で指定できます。

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

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

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

トピック:

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

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

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

1. テーマ・ページにナビゲートします。
   1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。
   2. アプリケーションを選択します。
   3. 「共有コンポーネント」をクリックします。
   4. 「ユーザー・インタフェース」で、「テーマ」を選択します。

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

2. テーマ名を選択します。

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

3. 「コンポーネントのデフォルト値」までスクロールします。
4. 「ページ」から、新しい選択を行います。
5. ページ上部の「変更の適用」をクリックします。

関連項目:

テーマの編集

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

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

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。
2. アプリケーションを選択します。
3. 「ページ・デザイナ」でページ・レベル・テンプレートを編集するには、次のステップを実行します。

   1. ページ・デザイナでページを表示します。

   2. 「レンダリング」タブで、ページ・タイトルをクリックします。

   3. プロパティ・エディタで「外観」を見つけます。「ページ・テンプレート」から新しいテンプレートを選択します。

   4. 「保存」をクリックします。

4. 「コンポーネント・ビュー」でページ・レベル・テンプレートを編集するには、次のステップを実行します。

   1. コンポーネント・ビューでページを表示します。

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

      編集ページが表示されます。

   3. 「表示属性」を見つけます。「ページ・テンプレート」から新しいテンプレートを選択します。

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

関連項目:

「ページ・デザイナでのページの表示」および「レガシー・コンポーネント・ビューでのページの表示」

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

カスタム・テンプレートを作成するには、まず既存のテンプレートをコピーし、それを変更する必要があります。作成した1つ以上のデフォルト・テンプレートは、必要に応じて変更できます。

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

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。
2. テンプレートをコピーするアプリケーションを選択します。
3. 「共有コンポーネント」をクリックします。
4. 「ユーザー・インタフェース」で、「テンプレート」を選択します。
5. 「作成」をクリックします。
6. 作成するテンプレートのタイプを選択し、「次へ」をクリックします。
7. 次のいずれかの作成方法を選択します。

   - 最初から

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

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

ヒント:

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

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

開発者はテンプレート・オプションを使用して、宣言的な方法でOracle Application Expressのページ上のコンポーネントに様々なスタイルを適用できます。

トピック:

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

関連項目:

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

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

グローバル・テンプレート・オプション・グループはテーマレベルで定義され、特定のタイプのコンポーネントすべてで使用できます。この項では、グローバル・テンプレート・オプション・グループを作成および編集する方法について説明します。

トピック:

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

関連項目:

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

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

グローバル・テンプレート・オプション・グループを作成するには、次のステップを実行します。

1. テーマ・ページにナビゲートします。
   1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。
   2. アプリケーションを選択します。
   3. 「共有コンポーネント」をクリックします。
   4. 「ユーザー・インタフェース」で、「テーマ」を選択します。

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

2. テーマを選択します。
3. 「グローバル・テンプレート・オプション」を見つけます。
4. 「テンプレート・オプション・グループの編集」をクリックします。
   「テンプレート・オプション・グループ」ダイアログが表示されます。
5. グループを作成するには:
   1. 「作成」をクリックします。
   2. 対象となる属性を編集します。
      属性の詳細は、フィールドレベル・ヘルプを参照してください。
   3. 「作成」をクリックします。

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

グローバル・テンプレート・オプション・グループを編集するには、次のステップを実行します。

1. テーマ・ページにナビゲートします。
   1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。
   2. アプリケーションを選択します。
   3. 「共有コンポーネント」をクリックします。
   4. 「ユーザー・インタフェース」で、「テーマ」を選択します。

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

2. テーマを選択します。
3. 「グローバル・テンプレート・オプション」を見つけます。
4. 「テンプレート・オプション・グループの編集」をクリックします。
   「テンプレート・オプション・グループ」ダイアログが表示されます。
5. グループを編集するには:
   1. グループ名をクリックします。
   2. 対象となる属性を編集します。
      属性の詳細は、フィールドレベル・ヘルプを参照してください。
   3. 「変更の適用」をクリックします。
6. 次の手順を実行して、グループを削除します。
   1. グループ名をクリックします。
   2. 「削除」をクリックします。

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

この項では、グローバル・テンプレート・オプションを作成および編集する方法について説明します。

トピック:

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

関連項目:

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

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

グローバル・テンプレート・オプションを作成するには、次のステップを実行します。

1. テーマ・ページにナビゲートします。
   1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。
   2. アプリケーションを選択します。
   3. 「共有コンポーネント」をクリックします。
   4. 「ユーザー・インタフェース」で、「テーマ」を選択します。

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

2. テーマを選択します。
3. 「グローバル・テンプレート・オプション」を見つけます。
4. 「テンプレート・オプションの追加」をクリックします。
   「テンプレート・オプション・グループ」ダイアログが表示されます。
5. 「テンプレート・オプション」で、次のステップを実行します。

   1. 表示順序 - このオプションの順序を指定します。

   2. テンプレート・タイプ - テンプレート・オプションを定義するテンプレートのタイプを選択します。

   3. グループ - 一意のグループ名を入力します。グループ名によってテンプレート・オプションをグループ化し、競合するオプションが選択されないようにすることができます。

      表示名 - テンプレート・オプションの名前を入力します。

   4. オプション識別子 - テンプレート・オプションの識別子を大文字の英数字で入力します。識別子によって、テーマを切り替えるときにテンプレート・オプションが対応するテンプレート・オプションにマップされます。

   5. CSSクラス - このテンプレート・オプションを定義する1つ以上のCSSクラスを入力します。

   6. ヘルプ・テキスト - テンプレート・オプションの説明を入力します。

   7. 「作成」または「作成後、別のものを追加」をクリックします。

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

グローバル・テンプレート・オプションを編集するには、次のステップを実行します。

1. テーマ・ページにナビゲートします。
   1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。
   2. アプリケーションを選択します。
   3. 「共有コンポーネント」をクリックします。
   4. 「ユーザー・インタフェース」で、「テーマ」を選択します。

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

2. テーマを選択します。
3. 「グローバル・テンプレート・オプション」を見つけます。
4. テンプレート・オプションを編集するには、次のステップを実行します。

   1. 表示名をクリックします。

   2. 対象となる属性を編集します。属性の詳細は、フィールドレベル・ヘルプを参照してください。

      ヒント:

      CSSクラスの名前を編集した場合は、そのCSSクラス名を参照するすべてのコンポーネントを手動で更新する必要があります。オプション識別子はマッピングのために必要なため、変更できません。

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

5. テンプレート・オプションを削除するには、次のステップを実行します。

   1. 表示名をクリックします。

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

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

この項では、テンプレート・オプションを作成および編集する方法について説明します。

トピック:

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

関連項目:

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

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

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

1. テーマ・ページにナビゲートします。
   1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。
   2. アプリケーションを選択します。
   3. 「共有コンポーネント」をクリックします。
   4. 「ユーザー・インタフェース」で、「テンプレート」を選択します。

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

2. テンプレートを選択します。
3. 「テンプレート・オプション」を選択します。
4. 「テンプレート・オプションの追加」をクリックします。
5. 対象となる属性を編集します。属性の詳細は、フィールドレベル・ヘルプを参照してください。
6. 「作成」または「作成後、別のものを追加」をクリックします。

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

テンプレート・オプションを編集するには、次のステップを実行します。

1. テーマ・ページにナビゲートします。
   1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。
   2. アプリケーションを選択します。
   3. 「共有コンポーネント」をクリックします。
   4. 「ユーザー・インタフェース」で、「テンプレート」を選択します。

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

2. テンプレートを選択します。
3. 「テンプレート・オプション」を選択します。
4. 該当する属性を編集し、「変更の適用」をクリックします。

   属性の詳細は、フィールドレベル・ヘルプを参照してください。

   ヒント:

   CSSクラスの名前を編集した場合は、そのCSSクラス名を参照するすべてのコンポーネントを手動で更新する必要があります。オプション識別子はマッピングのために必要なため、変更できません。

5. テンプレート・オプションを削除するには、「削除」をクリックします。
6. グローバル・テンプレート・オプションを表示するには、「グローバル・テンプレート・オプション」を展開します。

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

開発者は、実行時開発者ツールバーのクイック編集を使用して、「ライブ・テンプレート・オプション」ダイアログにアクセスすることもできます。開発者は、「ライブ・テンプレート・オプション」ダイアログを使用して、ページをリフレッシュすることなくコンポーネントのテンプレート・オプションを変更できます。

ライブ・テンプレート・オプションにアクセスするには、次のステップを実行します。

1. ページを実行します。
2. 実行時開発者ツールバーから、「クイック編集」をクリックします。
3. テンプレート・オプションを変更するコンポーネントの上にマウスを移動します。右上隅にあるレンチ・アイコンをクリックします。
   図GUID-8FCA9B5B-7668-455A-812E-8BAB3D8B7C2B-default.pngの説明

   「ライブ・テンプレート・オプション」ダイアログが表示されます。リストやクラシック・レポートなどのリージョンベース・コンポーネントの場合は、ダイアログに「属性」タブが含まれます。

   図GUID-9D192DF9-748E-4F3F-9395-FF2DA08B84ED-default.pngの説明
4. 該当するタブを選択して、該当する属性を編集し、「保存」をクリックします。

関連項目:

「実行時開発者ツールバー」

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

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

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

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。
2. アプリケーションを選択します。
3. 「共有コンポーネント」をクリックします。
4. 「ユーザー・インタフェース」で、「テンプレート」を選択します。

   テンプレート・ページは、対話モード・レポートとして表示されます。ビューをカスタマイズするには、ページ上部の検索バーを使用します。

5. テンプレート・レポートを表示するには、次のタブをクリックします。

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

   - パブリッシュ - ワークスペースの他のテンプレートによってサブスクライブされたテンプレートを表示します。マスター・テンプレートの内容を、サブスクライブしているテンプレートにパブリッシュするには、パブリッシュする対象を選択して、「チェックした項目のパブリッシュ」をクリックします。

   - 使用状況 - カレント・アプリケーションのすべてのテンプレート・タイプについてテンプレートの使用状況を表示します。「参照」列の数値は、特定のテンプレートを使用するページの合計数を示します。

   - 履歴 - このアプリケーション内のページおよびリージョン・テンプレートの最近の変更を表示します。

## 11.3.8 テンプレートの管理

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

トピック:

- テンプレート・ページでのテンプレートの表示
- 特定のページに関連付けられているテンプレートの表示
- テンプレートの置換
- アプリケーション内のすべてのテンプレートの置換
- ページ・テンプレート別のリージョン位置の使用状況の表示
- テンプレートのサブスクライブ解除
- テンプレートのパブリッシュ

関連項目:

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

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

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

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。
2. アプリケーションを選択します。
3. 「共有コンポーネント」をクリックします。
4. 「ユーザー・インタフェース」で、「テンプレート」を選択します。

   テンプレート・ページは、対話モード・レポートとして表示されます。ビューをカスタマイズするには、ページ上部の検索バーを使用します。

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

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

6. 対象となる属性を編集します。属性の詳細は、フィールドレベル・ヘルプを参照してください。

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

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

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

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

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。
2. アプリケーションを選択します。
3. ページ・デザイナでページを表示します。

   1. 「レンダリング」タブで、ページ・タイトルをクリックします。

   2. プロパティ・エディタで「外観」を見つけます。「ページ・テンプレート」に現在のテンプレートが表示されます。

   3. 変更を保存するには、「保存」をクリックします。

4. コンポーネント・ビューでページを表示します。

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

      編集ページが表示されます。

   2. 「表示属性」を見つけます。「ページ・テンプレート」に現在のテンプレートが表示されます。

   3. 変更を保存するには、「変更の適用」をクリックします。

      注意:

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

関連項目:

「ページ・デザイナでのページの表示」および「レガシー・コンポーネント・ビューでのページの表示」

### 11.3.8.3 テンプレートの置換

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

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

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。
2. アプリケーションを選択します。
3. 「共有コンポーネント」をクリックします。
4. 「ユーザー・インタフェース」で、「テンプレート」を選択します。
   ビューをカスタマイズするには、ページ上部の検索バーを使用します。
5. 「タスク」リストから「テンプレートの置換」を選択します。
6. 「テンプレート・タイプ」で、次のステップを実行します。

   1. ユーザー・インタフェース: ユーザー・インタフェースを選択します。

   2. テンプレート・タイプ - 置換されるテンプレート・タイプを示します。

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

7. 「テンプレートの置換」で、次のステップを実行します。

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

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

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

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

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

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

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。
2. アプリケーションを選択します。
3. 「共有コンポーネント」をクリックします。
4. 「ユーザー・インタフェース」で、「テンプレート」を選択します。
   ビューをカスタマイズするには、ページ上部の検索バーを使用します。
5. 「タスク」リストから「このアプリケーションのテンプレートを別のアプリケーションのテンプレートに置換。」を選択します。
6. 「テンプレートの置換」で、次のステップを実行します。

   1. アプリケーションから置換: アプリケーションを選択します。

   2. ユーザー・インタフェース: このアプリケーションを開発する対象のユーザー・インタフェースのタイプを選択します。

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

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

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

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

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

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

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

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

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。
2. アプリケーションを選択します。
3. 「共有コンポーネント」をクリックします。
4. 「ユーザー・インタフェース」で、「テンプレート」を選択します。
   ビューをカスタマイズするには、ページ上部の検索バーを使用します。
5. 「タスク」リストから「ページ・テンプレートのリージョン位置の使用状況の表示」を選択します。

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

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

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

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

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。
2. アプリケーションを選択します。
3. 「共有コンポーネント」をクリックします。
4. 「ユーザー・インタフェース」で、「テンプレート」を選択します。
   ビューをカスタマイズするには、ページ上部の検索バーを使用します。
5. 「タスク」リストから「テンプレートのサブスクライブ解除」を選択します。

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

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

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

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

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

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。
2. アプリケーションを選択します。
3. 「共有コンポーネント」をクリックします。
4. 「ユーザー・インタフェース」で、「テンプレート」を選択します。
   ビューをカスタマイズするには、ページ上部の検索バーを使用します。
5. 「パブリッシュ」タブをクリックします。

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

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

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

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

関連項目:

テーマの使用

トピック:

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

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

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

図GUID-8EE282AC-E549-431D-8AE2-524AF526ADEE-default.pngの説明

関連項目:

ブレッドクラムの作成

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

ブレッドクラム・テンプレートは、ブレッドクラム・リージョン・タイプの表示方法を制御します。このテンプレートは、リージョンの作成時に選択します。特定の属性の詳細は、フィールドレベル・ヘルプを参照してください。

トピック:

- 名前
- 定義
- 置換文字列

#### 11.3.9.2.1 名前

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

#### 11.3.9.2.2 定義

定義属性は、ブレッドクラムの表示方法を制御します。表11-8に、定義属性を示します。

表11-8 定義属性

属性 | 説明
--- | ---
最初の前 | 最初のブレッドクラム・エントリの前に表示するテキストを定義します。置換文字列`#COMPONENT_CSS_CLASSES#`を使用して、CSSクラスをブレッドクラム・テンプレートに適用します。コンポーネントCSSクラスを編集するには、リージョン属性を編集します。 関連項目: ページ・デザイナでのリージョン属性の編集およびコンポーネント・ビューでのリージョン属性の編集
カレント・ページのブレッドクラム・エントリ | カレント・ページに対応するブレッドクラム・エントリの外観を定義します。
カレント・ページ以外のブレッドクラム・エントリ | カレント・ページに対応していないブレッドクラム・エントリの外観を定義します。
最後の後 | 最後のブレッドクラム・エントリの後に表示するテキストを定義します。
レベル間 | ブレッドクラム・エントリのレベル間に表示するテキストを定義します。
最大レベル | ブレッドクラムをブレッドクラム・スタイルで表示する際に使用するレベル数を指定します。

#### 11.3.9.2.3 置換文字列

置換文字列は、コンポーネント値を参照するためにサブテンプレート内で使用されます。表11-9に、使用可能なボタン・テンプレートの置換文字列を示します。

ヒント:

テンプレートのすべての置換文字列は、大文字で指定し、シャープ記号(#)で囲む必要があります。特定のテンプレートでサポートされる置換文字列のレポートを表示するには、ブレッドクラム・テンプレートの編集ページの「置換文字列」セクションを参照してください。

表11-9 ブレッドクラム・テンプレートの置換文字列

参照元 | 置換文字列 | 説明
--- | --- | ---
最初の前 | `#COMPONENT_CSS_CLASSES#` | コンポーネントCSSクラス。 `#COMPONENT_CSS_CLASSES#`文字列は、テンプレート・オプションが定義されているテンプレートの最初の前属性に含める必要があります。`#COMPONENT_CSS_CLASSES#`文字列には、対応するテンプレート・オプション・クラスが実行時に注入されます。
カレント・エントリ | `#LINK#` | URLリンク。
カレント・エントリ | `#LONG_NAME#` | ブレッドクラムの詳細な名前。
カレント・エントリ | `#NAME#` | ブレッドクラム・ラベル。
カレント・エントリ | `#NAME_ESC_SC#` | ブレッドクラム・ラベル(HTML文字をエスケープ)。
非カレント・エントリ | `#LINK#` | URLリンク。
非カレント・エントリ | `#LONG_NAME#` | ブレッドクラムの詳細な名前。
非カレント・エントリ | `#NAME#` | ブレッドクラム・ラベル。
非カレント・エントリ | `#NAME_ESC_SC#` | ブレッドクラム・ラベル(HTML文字をエスケープ)。

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

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

関連項目:

テーマの使用

トピック:

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

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

この項では、ボタン・テンプレートの編集ページの一部のセクションについて説明します。特定の属性の詳細は、フィールドレベル・ヘルプを参照してください。

トピック:

- 名前
- 定義
- 置換文字列

関連項目:

テンプレート・オプションの理解およびテーマのサブスクリプションの理解

#### 11.3.10.1.1 名前

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

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

#### 11.3.10.1.2 定義

「通常のテンプレート」では、ボタン・タイプが「標準」の場合に表示されるボタン・テンプレートが定義されます。たとえば、`&ITEM_NAME`値はレンダリング時に置換できます。「ホット・テンプレート」では、ボタン・タイプが「ホット」の場合に表示されるボタン・テンプレートが定義されます。標準のアプリケーション置換文字列を含めることもできます。たとえば、`&ITEM_NAME`値はレンダリング時に置換できます。

サポートされている置換文字列の詳細は、フィールドレベル・ヘルプを参照してください。

ヒント:

置換文字列はすべて大文字である必要があります。

#### 11.3.10.1.3 置換文字列

置換文字列は、コンポーネント値を参照するためにサブテンプレート内で使用されます。表11-10に、使用可能なボタン・テンプレートの置換文字列を示します。

ヒント:

テンプレートのすべての置換文字列は、大文字で指定し、シャープ記号(#)で囲む必要があります。特定のテンプレートでサポートされる置換文字列のレポートを表示するには、ページ・テンプレートの編集ページの「置換文字列」セクションを参照してください。

表11-10 ボタン・テンプレートの置換文字列

参照元 | 置換文字列 | 説明
--- | --- | ---
ホット・テンプレート | `#BUTTON_ATTRIBUTES#` | ボタン属性。
ホット・テンプレート | `#BUTTON_CSS_CLASSES#` | ボタンCSSクラス。 `#BUTTON_CSS_CLASSES#`文字列は、テンプレート・オプションが定義されているテンプレートに含める必要があります。`#BUTTON_CSS_CLASSES#`文字列には、対応するテンプレート・オプション・クラスが実行時に注入されます。
ホット・テンプレート | `#BUTTON_ID#` | 生成されるボタンIDは、ボタンの静的ID (定義されている場合)または`'B' || [Internal Button ID]`という形式の内部生成されたID (定義されていない場合)です。
ホット・テンプレート | `#ICON_CSS_CLASSES#` | アイコンCSSクラス。
ホット・テンプレート | `#JAVASCRIPT#` | onclick属性で使用されます。
ホット・テンプレート | `#LABEL#` | ボタン・ラベル。
ホット・テンプレート | `#LINK#` | `href`属性で使用されます。
テンプレート | `#BUTTON_ATTRIBUTES#` | ボタン属性。
テンプレート | `#BUTTON_CSS_CLASSES#` | ボタンCSSクラス。 `#BUTTON_CSS_CLASSES#`文字列は、テンプレート・オプションが定義されているテンプレートに含める必要があります。`#BUTTON_CSS_CLASSES#`文字列には、対応するテンプレート・オプション・クラスが実行時に注入されます。
テンプレート | `#BUTTON_ID#` | 生成されるボタンIDは、ボタンの静的ID (定義されている場合)または`'B' || [Internal Button ID]`という形式の内部生成されたID (定義されていない場合)です。
テンプレート | `#ICON_CSS_CLASSES#` | アイコンCSSクラス。
テンプレート | `#JAVASCRIPT#` | onclick属性で使用されます。
テンプレート | `#LABEL#` | ボタン・ラベル。
テンプレート | `#LINK#` | `href`属性で使用されます。

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

レガシー・カレンダ・テンプレートは、カレンダの外観と配置を制御します。このテンプレートは、頻繁にHTML表を使用して日付を配置します。`#DD#`や`#MONTH#`などの置換文字列を使用してカレンダ属性を配置します。

トピック:

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

関連項目:

サポートされているカレンダについて、カレンダの作成およびテーマの使用

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

サポートされている置換文字列のリストは、カレンダ・テンプレートの編集ページの右側に表示されます。テンプレートの置換文字列は大文字で指定し、シャープ記号(`#`)で囲む必要があることに注意してください。

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

この項では、カレンダ・テンプレートの編集ページの一部のセクションについて説明します。特定の属性の詳細は、フィールドレベル・ヘルプを参照してください。

関連項目:

テンプレート・オプションの理解およびテーマのサブスクリプションの理解

カレンダ定義

トピック:

- 名前
- サブスクリプション
- コメント

#### 11.3.11.2.1 名前

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

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

#### 11.3.11.2.2 サブスクリプション

「サブスクリプション」を使用して、カレント・アプリケーションに既存のテンプレートを適用します。

「マスター・ラベル・テンプレートの参照元」を使用して、対象のワークスペースの既存のテンプレート、またはワークスペースのスキーマの別のテンプレートを選択します。既存のテンプレートを選択すると、ユーザーはそのテンプレートのサブスクライバになります。

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

#### 11.3.11.2.3 コメント

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

月次カレンダ、週次カレンダ、日次カレンダ、カスタム・カレンダおよびリスト・カレンダ

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

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

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

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

トピック:

- ラベル・テンプレート属性
- #CURRENT_ITEM_HELP_TEXT#を使用したアイテム・ヘルプの作成について

関連項目:

テーマの使用

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

関連項目:

テンプレート・オプションの理解およびテーマのサブスクリプションの理解

ここでは、ラベル・テンプレートの編集ページの特定のセクションについて説明します。特定の属性の詳細は、フィールドレベル・ヘルプを参照してください。

トピック:

- 名前
- 定義
- エラー表示
- フィールド・コンテナ
- 置換文字列

#### 11.3.12.1.1 名前

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

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

#### 11.3.12.1.2 定義

定義属性は次のとおりです。

ヒント:

サポートされている置換文字列のリストおよび例は、フィールドレベル・ヘルプを参照してください。

- ラベルの前 - アイテム・ラベルの前に表示するHTMLを入力します。`#ITEM_CSS_CLASSES#`置換文字列は、テンプレート・オプションが定義されているテンプレートに含める必要があります。

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

- アイテムの前 - フォーム・アイテムの直前に表示するHTMLを入力します。これは通常、アイテムをDIVコンテナにラップするか、フォーム・アイテムの前または後にヘルプ・ボタンを表示するために使用されます。

- アイテムの後 - フォーム・アイテムの直後に表示するHTMLを入力します。これは通常、アイテムをDIVコンテナにラップするか、フォーム・アイテムの前または後にヘルプ・ボタンを表示するために使用されます。

- アイテム事前テキスト - アイテム属性の前のテキストとして格納されるコンテンツを書式設定するためのアイテム事前テキスト・サブテンプレートのHTMLを入力します。このサブテンプレートは、`#ITEM_PRE_TEXT#`の置換を使用して要素前テンプレートで参照できます。

- アイテム事後テキスト - アイテム属性の後のテキストとして格納されるコンテンツを書式設定するためのアイテム事後テキスト・サブテンプレートのHTMLを入力します。このサブテンプレートは、`#ITEM_PRE_TEXT#`の置換を使用して要素後テンプレートで参照できます。

- ヘルプ・テンプレート - ヘルプ・サブテンプレートでは、開発者がアイテム・レベルのヘルプの起動に使用されるリンクまたはボタンを定義できます。このサブテンプレートは、ヘルプが定義されているアイテムに対してのみレンダリングされます。#CURRENT_ITEM_HELP_TEXT#を使用したアイテム・ヘルプの作成についてを参照してください。

- インライン・ヘルプ・テンプレート - ヘルプ・サブテンプレートでは、開発者がアイテムとともに即座に表示するインライン・ヘルプ・テキストを定義できます。このサブテンプレートは、インライン・ヘルプ・テキストが定義されているアイテムに対してのみレンダリングされます。

#### 11.3.12.1.3 エラー表示

エラー表示属性は次のとおりです。

ヒント:

サポートされている置換文字列のリストおよび例は、フィールドレベル・ヘルプを参照してください。

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

- ラベルの後のエラー発生時 - アプリケーションがアイテムのインライン検証エラー・メッセージを表示する場合に、そのアイテム・ラベルに追加するHTMLを入力します。

- エラー・テンプレート - インライン検証エラー・メッセージを表示するためにレンダリングされるHTMLを入力します。メッセージ・テキストを参照するには、`#ERROR_MESSAGE#`置換文字列を使用します。`#ERROR_TEMPLATE#`置換文字列を使用して、アイテム属性の前後にエラー・テンプレートを含めることができます。

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

フィールド・コンテナ属性は次のとおりです。

ヒント:

サポートされている置換文字列のリストおよび例は、フィールドレベル・ヘルプを参照してください。

- 「ラベルの前」とアイテム - ラベルおよびアイテムの前に表示するHTMLを入力します。これは、通常、アイテムをDIVコンテナまたはフィールド・セットにラップするために使用されます。「「ラベルの前」とアイテム」属性は、表グリッドを使用してフォーム・アイテムを表示しないページにのみレンダリングされます。これには、モバイル・ページ・テンプレートを使用したページが含まれます。

- 「ラベルの後」とアイテム - ラベルおよびアイテムの後に表示するHTMLを入力します。これは、通常、アイテムをDIVコンテナまたはフィールド・セットにラップするために使用されます。後のアイテムおよびラベル属性は、表グリッドを使用してフォーム・アイテムを表示しないページにのみレンダリングされます。これには、モバイル・ページ・テンプレートを使用したページが含まれます。

#### 11.3.12.1.5 置換文字列

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

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

`#CURRENT_ITEM_HELP_TEXT#`置換文字列を使用すると、ページのレンダリング時にインライン・ページ・ヘルプ・テキストを作成できます。たとえば、この置換文字列を使用すると、マウスをページ・アイテム・ラベルにあわせたときにツールチップとして表示されるページ・ヘルプ・テキストを作成できます。このプレースホルダによって、コストのかかるAjaxコールを実行せずに、レンダリング時にページにヘルプ・テキストを表示できます。

ヒント:

ヘルプ・テキストが短い場合は、このプレースホルダのみが使用されます。生成されるページには常に、すべてのページ・アイテムのヘルプ・テキストが含まれます。

ラベル・テンプレートの例

ラベルの前:

    <label for="#CURRENT_ITEM_NAME#" id="#LABEL_ID#">
    <span class="helpText">#CURRENT_ITEM_HELP_TEXT#</span>

ラベルの後:

    </label>

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

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

トピック:

- 階層リストについて
- リスト・テンプレート属性

関連項目:

リストの作成およびテーマの使用

### 11.3.13.1 階層リストについて

Oracle Application Expressでは、階層的なリストをサポートしています。階層的なリストを作成するには、次のステップを実行します。

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

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

関連項目:

リストの作成

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

関連項目:

テンプレート・オプションの理解およびテーマのサブスクリプションの理解

この項では、リスト・テンプレートの編集ページの一部のセクションについて説明します。特定の属性の詳細は、フィールドレベル・ヘルプを参照してください。

トピック:

- 名前
- リスト前のエントリ
- テンプレート定義
- 最初のエントリのテンプレート定義
- サブリスト・エントリ前
- サブリスト・エントリ
- サブリスト後のエントリ
- リスト後のエントリ
- 置換文字列

#### 11.3.13.2.1 名前

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

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

#### 11.3.13.2.2 リスト前のエントリ

リスト要素の前に表示するHTMLを入力します。この属性は、HTML表またはHTML表の行を開始するために使用できます。`#COMPONENT_CSS_CLASSES#`置換文字列は、テンプレート・オプションが定義されているテンプレートの行の前のリスト・テンプレート属性に含める必要があります。

#### 11.3.13.2.3 テンプレート定義

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

テンプレート定義属性は次のとおりです。

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

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

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

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

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

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

選択可能な属性は次のとおりです。

- カレント・リスト・テンプレート(最初):定義されている場合、これは最初のリスト・アイテムに使用されます。選択された(カレントの)リスト・テンプレートに置換されるHTMLまたはテキストを入力します。

- サブリスト・アイテムが含まれているカレント・リスト・テンプレート(最初):定義されている場合、これは最初のリスト・アイテムに使用されます。アイテムにサブリスト・アイテムが含まれる場合に使用される、選択された(カレントの)リスト・テンプレートに置換されるHTMLまたはテキスト。

- 非カレント・リスト・テンプレート(最初):定義されている場合、これは最初のリスト・アイテムに使用されます。選択されていない(非カレントの)リスト・テンプレートに置換されるHTMLまたはテキストを入力します。

- サブリスト・アイテムが含まれている非カレント・リスト・テンプレート(最初):定義されている場合、これは最初のリスト・アイテムに使用されます。アイテムにサブリスト・アイテムが含まれる場合に使用される、選択されていない(非カレントの)リスト・テンプレートに置換されるHTMLまたはテキスト。

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

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

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

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

サブリスト・エントリ属性は次のとおりです。

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

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

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

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

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

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

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

#### 11.3.13.2.8 リスト後のエントリ

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

#### 11.3.13.2.9 置換文字列

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

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

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

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

トピック:

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

関連項目:

テーマの使用

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

関連項目:

テンプレート・オプションの理解およびテーマのサブスクリプションの理解

ここでは、ページ・テンプレートの編集ページの特定のセクションについて説明します。サポートされている置換文字列など、特定の属性の詳細は、フィールドレベル・ヘルプを参照してください。

トピック:

- 名前
- 定義
- JavaScript
- カスケード・スタイル・シート
- サブテンプレート
- イメージ・ベースのタブ属性
- レイアウト
- 表示ポイント
- ダイアログ
- エラー・ページ・テンプレートの制御
- 置換文字列

#### 11.3.14.1.1 名前

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

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

「翻訳可能」チェック・ボックスを使用して、対象のテンプレートに翻訳が必要なテキスト文字列が含まれているかどうかを示します。

「テンプレート・タイプ」はページ・テンプレート・タイプを指定します。「ダイアログ・ページ」に設定すると、そのテンプレートを選択できるのは、ページ・モードが「モーダル」または「非モーダル」のページのみになります。「標準ページ」に設定すると、そのテンプレートを選択できるのは、ページ・モードが「標準」のページのみになります。

関連項目:

ダイアログ・ページの作成および必須のダイアログ・ページ・テンプレート属性

#### 11.3.14.1.2 定義

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

ヒント:

サポートされている置換文字列のリストおよび例は、フィールドレベル・ヘルプを参照してください。

定義属性は次のとおりです。

- ヘッダー: HTMLドキュメントの`<Head>`セクションを定義するHTMLを入力します。このテンプレート・セクションには、少なくとも`#TITLE#`および`#HEAD#`を含めることをお薦めします。

- ボディ: HTMLドキュメントの`<Body>`セクションを構成するHTMLを入力します。ボディ・コンテンツの配置場所および追加のリージョン位置を定義する置換文字列を含めます。

- フッター: ボディの後に表示する、ページ・テンプレートの3番目のセクションを定義するHTMLを入力します。

#### 11.3.14.1.3 JavaScript

選択可能な属性は次のとおりです。

ヒント:

サポートされている置換文字列のリストおよび例は、フィールドレベル・ヘルプを参照してください。

- ファイルURL: このページにロードするコードのJavaScriptファイルURLを入力します。各URLを新しい行に記述する必要があります。ファイルの縮小バージョンを指定する場合、置換文字列`#MIN#`を使用して、通常ページ・ビューのファイルURLに.minを含めたり、ページをデバッグ・モードに表示する場合は空の文字列を含めることができます。置換文字列`#APP_VERSION#`を使用すると、ファイルURLにアプリケーションのバージョンを含めることができます。ここに入力したJavaScriptのファイルURLによって、ページ・テンプレート内の`#TEMPLATE_JAVASCRIPT#`置換文字列が置き換えられます。

  スクリプトの開始タグや閉じタグを含めずに、URLのみを記述します。

- ファンクションおよびグローバル変数の宣言: 対象のページ・テンプレートで使用するコード用のJavaScriptコード(たとえば、ファンクションまたはグローバル変数宣言)を入力します。重複を避け、ブラウザで静的ファイルをキャッシュするため、外部ファイルに挿入することを検討してください。ここに入力したコードによって、ページ・テンプレート内の`#TEMPLATE_JAVASCRIPT#`置換文字列が置き換えられます。

  スクリプトの開始タグや閉じタグを含めずに、JavaScriptコードのみを含めます。

  ショートカットを参照するには、`"SHORTCUTNAME"`を使用します。

- ページ・ロード時に実行: ページのロード時に実行するJavaScriptコードを入力します。このコードはOracle Application Expressによって生成されたJavaScriptコードの後に実行されます。ここに入力したコードによって、ページ・テンプレート内の`#GENERATED_JAVASCRIPT#`置換文字列が置き換えられます。

- ダイアログ初期化コード: この属性は、「テンプレート・タイプ」が「ダイアログ・ページ」の場合にのみ表示されます。ダイアログとしてページを初期化するJavaScriptコードを入力します。置換文字列は、レンダリング時に該当する値で置換されます。

- 「ダイアログ・クロージャ・コード」。この属性は、「テンプレート・タイプ」が「ダイアログ・ページ」の場合にのみ表示されます。ダイアログ・ページを閉じるJavaScriptコードを入力します。

- 「ダイアログ取消コード」。この属性は、「テンプレート・タイプ」が「ダイアログ・ページ」の場合にのみ適用されます。ダイアログ・ページを取り消すJavaScriptコードを入力します。

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

選択可能な属性は次のとおりです。

- ファイルURL - このページ・テンプレートにロードされるカスケード・スタイルシート・ファイルURLを入力します。各URLを新しい行に記述する必要があります。ファイルの縮小バージョンを指定する場合、置換文字列`#MIN#`を使用して、通常ページ・ビューのファイルURLに`.min`を含めたり、ページをデバッグ・モードで表示する場合は空の文字列を含めることができます。置換文字列`#APP_VERSION#`を使用すると、ファイルURLにアプリケーションのバージョンを含めることができます。ここに入力したファイルURLによって、テンプレート内の`#TEMPLATE_CSS#`置換文字列が置き換えられます。

  スクリプトの開始タグや閉じタグを含めずに、ファイルURLのみを含めます。

- インライン - このページ・テンプレートに使用されるカスケード・スタイルシートのコードを入力します。重複を避け、ブラウザで静的ファイルをキャッシュするため、外部ファイルに挿入することを検討してください。ここに入力したコードによって、テンプレート内の`#TEMPLATE_CSS#`置換文字列が置き換えられます。

  開始スタイル・タグや閉じスタイル・タグを含めずに、カスケード・スタイルシートのコードのみを含めます。

#### 11.3.14.1.5 サブテンプレート

次のサブテンプレートのHTMLを入力します。サブテンプレートは、置換文字列を使用してページ・テンプレートのボディ内に配置されます。

サブテンプレートは次のとおりです。

- 成功メッセージ - テンプレート・ボディ、ヘッダー、フッター内の文字列`#SUCCESS_MESSAGE#`を置換するHTMLを入力します。

- ナビゲーション・バー - テンプレート・ヘッダー、ボディ、フッター内の文字列`#NAVIGATION_BAR#`を置換するHTMLまたはテキストを入力します。置換文字列`#BAR_BODY#`を使用して、ナビゲーション・バーにエントリが表示される位置を指定します。

- ナビゲーション・バー・エントリ - 各ナビゲーション・バー・エントリのナビゲーション・バー`#BAR_BODY#`置換文字列に置換されるHTMLまたはテキストを入力します。

- 通知 - `#NOTIFICATION_MESSAGE#`置換文字列が、テンプレートのヘッダー、ボディまたはフッターで参照される際に置換されるHTMLまたはテキストを入力します。

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

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

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

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

#### 11.3.14.1.7 レイアウト

ページで使用するレイアウトのタイプを指定します。選択したタイプによって、表示される属性が決まります。属性の詳細は、フィールドレベル・ヘルプを参照してください。

「タイプ」から、レイアウトを選択します。

- HTML表: HTML表を使用して、リージョン、ページ・アイテムおよびボタンを配置します。

- 固定列数: 画面を固定のグリッド列数で分割するグリッドに使用します。

- 可変列数: リージョン、ページ・アイテムおよびボタンの配置方法に応じて、グリッド列を最大n列まで表示できるグリッドに使用します。

#### 11.3.14.1.8 表示ポイント

選択可能な属性は次のとおりです。

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

- サイドバー表示ポイント - サイドバーを使用する生成済コンポーネントに適用されます。サイドバーが配置されるページ上の位置を定義します。

#### 11.3.14.1.9 ダイアログ

ダイアログ属性は、「テンプレート・タイプ」に「ダイアログ・ページ」を選択した場合にのみ表示されます。これらの設定は、ページ・レベルで指定された類似の属性によって上書きされます。

選択可能なダイアログ属性は次のとおりです。

- 幅 - ダイアログの幅をピクセル単位または比率で入力します。

- 高さ - ダイアログの高さをピクセル単位で入力します(たとえば、500)。

- 最大幅 - ダイアログの最大幅をピクセル単位で入力します。jQuery Mobileスマートフォン・ユーザー・インタフェースを使用しているページの場合、最大幅は500です。

- CSSクラス - ダイアログに適用する追加のCSSクラスを、空白区切りのリストとして入力します。

- フレームへの埋込みを許可 - ページ・テンプレート・レベルのブラウザ・フレーム・オプションが、各オプションの現在の設定とともに下に示されます。ブラウザでアプリケーションのページをフレーム内に表示できるかどうかを選択します。現在の設定が、このページ・テンプレートを使用する各モーダルおよび非モーダル・ページのデフォルトです。詳細は、フィールドレベル・ヘルプを参照してください。

  Oracle Application Expressは、iframeにモーダル・ダイアログを埋め込みます。アプリケーション・セキュリティ属性ブラウザ・フレームを「拒否」に設定する場合、「モーダル・ダイアログ」の「フレームへの埋込みを許可」を選択すると、かわりにこのテンプレートを使用するダイアログ・ページの「同じ起点から許可」が使用されます

関連項目:

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

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

ページ・テンプレートをエラー・テンプレートとして指定する場合は、この属性を使用します。

#### 11.3.14.1.11 置換文字列

表 11-11に、使用可能なページ・テンプレートの置換文字列を示します。置換文字列は、サブテンプレート内でコンポーネント値を参照するために使用されます。

ヒント:

テンプレートのすべての置換文字列は、大文字で指定し、シャープ記号(#)で囲む必要があります。特定のテンプレートでサポートされる置換文字列のレポートを表示するには、ページ・テンプレートの編集ページの「置換文字列」セクションを参照してください。

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

参照元 | 置換文字列 | 説明
--- | --- | ---
すべて | `#HIGH_CONTRAST_TOGGLE#` | ハイ・コントラストの切替え。
すべて | `#PAGE_STATIC_ID#` | ページの静的ID (例: `'P100'`)。
すべて | `#PARENT_TAB_CELLS#` | 親タブの表示。
すべて | `#REGION_POSITION_01#` | リージョン位置1。
すべて | `#REGION_POSITION_02#` | リージョン位置2。
すべて | `#REGION_POSITION_03#` | リージョン位置3。
すべて | `#REGION_POSITION_04#` | リージョン位置4。
すべて | `#REGION_POSITION_05#` | リージョン位置5。
すべて | `#REGION_POSITION_06#` | リージョン位置6。
すべて | `#REGION_POSITION_07#` | リージョン位置7。
すべて | `#REGION_POSITION_08#` | リージョン位置8。
すべて | `#REQUESTED_URL#` | ブラウザによってリクエストされたページURL
すべて | `#SCREEN_READER_TOGGLE#` | スクリーン・リーダーの切替え。
すべて | `#SWITCH_UI_TO_DESKTOP#` | デスクトップ・ユーザー・インタフェースのホームページへのハイパーリンク。
すべて | `#SWITCH_UI_TO_JQM_SMARTPHONE#` | スマートフォン・ユーザー・インタフェースのホーム・ページへのハイパーリンク。
すべて | `#TITLE#` | ページ・タイトルを定義します。通常、HTMLのtitleタグ内に含まれます。
ボディ | `#BODY#` | ページ・ボディ。
ボディ | `#BOX_BODY#` | ボディを表示する位置。ボディがNULLの場合、かわりに`#BOX_BODY#`が使用されます。
ボディ | `#FORM_OPEN#` | HTMLのフォームの開始タグ`<form>`を配置する位置。フォームを送信するには、この置換文字列を含める必要があります。
ボディ | `#GENERATED_CSS#` | コンポーネントによって作成されるカスケード・スタイルシート・ファイル。
ボディ | `#GLOBAL_NOTIFICATION#` | グローバル通知属性を表示します。グローバル通知は、システム・ステータス(保留中のシステム停止時間など)との通信に使用します。`APEX_APPLICATION`.`G_GLOBAL_NOTIFICATION`を使用すると、この値をプログラムによって設定できます。 関連項目: グローバル通知
ボディ | `#LOGO#` | アプリケーション・イメージまたはログ。 「アプリケーション定義の編集」ページの「ロゴ」セクションで、アプリケーションのロゴのイメージおよびイメージ属性を指定できます。この機能を使用するには、「ヘッダー」または「ボディ」ページ・テンプレートに置換文字列`#LOGO#`も含める必要があります。 関連項目: ロゴ
ボディ | `#NAVIGATION_BAR#` | ナビゲーション・バー。 関連項目: 「ナビゲーション・バー」サブテンプレートは、サブテンプレートを参照してください。
ボディ | `#NOTIFICATION_MESSAGE#` | インライン・エラー・メッセージのサマリーが表示される位置を定義します。インライン・エラー・メッセージは、フィールドの横または通知領域にインライン(あるいはその両方)で表示できます。
ボディ | `#POPUP_TRANSITION#` | jQuery Mobileアプリケーションでダイアログを開くために使用されるデフォルトのページ遷移。この新しいプレースホルダは、タイプ`role="page"`の`DIV`で使用する必要があります。次に例を示します。
    <div id="#PAGE_STATIC_ID#" data-role="page" data-apex-page-transition="#PAGE_TRANSITION#" data-apex-popup-transition="#POPUP_TRANSITION#" data-url="#REQUESTED_URL#">
ボディ | `#SUCCESS_MESSAGE#` | 成功メッセージ。ページの成功メッセージおよびエラー・メッセージを表示する位置を定義します。エラーなしでページ・プロセスが実行されると、このテキストが表示されます。 成功メッセージの前後にHTMLを追加すると、各テンプレートの成功メッセージの表示をカスタマイズできます。
ボディ | `#TAB_CELLS#` | 標準タブの表示。
ボディ | `#TEMPLATE_JAVASCRIPT#` | 標準タブの表示。
フッター | `#CUSTOMIZE#` | 「カスタマイズ」リンク。
フッター | `#FORM_CLOSE#` | HTMLのフォームの終了タグ`<form>`を配置する位置。
ヘッダー | #`APEX_CSS`# | Application Expressによって使用されるカスケード・スタイルシート・ファイル。
ヘッダー | `#APEX_JAVASCRIPT#` | Oracle Application Expressによって使用されるJavaScriptファイルとコード。
ヘッダー | `#APPLICATION_CSS#` | ユーザー・インタフェース・レベルで定義されているCSSファイル。
ヘッダー | `#APPLICATION_JAVASCRIPT#` | ユーザー・インタフェース・レベルで定義されているJavaScriptファイル。
ヘッダー | `#GENERATED_JAVASCRIPT#` | コンポーネントによって必要に応じて作成されるJavaScriptコード。
ヘッダー | `#HEAD#` | `<head>`開始タグと`</head>`閉じタグの間に使用します。オプションで、各ページの`#HEAD#`のコンテンツを定義できます(たとえば、追加のスタイルシートまたはJavaScriptライブラリを参照するように定義できます)。
ヘッダー | `#ONLOAD#` | ページのonload。 Webブラウザでページがロードされたときに実行される JavaScriptコールで、この文字列を置換文字列として使用します。コールするJavaScriptは、ページごとに変更できます。
ヘッダー | `#PAGE_CSS#` | ページ・レベルで定義されているカスケード・スタイルシート・ファイルとインライン・スタイル。
ヘッダー | `#PAGE_JAVASCRIPT#` | ページ・レベルで定義されているJavaScriptファイルとコード。
ヘッダー | `#TEMPLATE_CSS#` | ページ・テンプレート・レベルで定義されているカスケード・スタイルシート・ファイルとインライン・スタイル。
ヘッダー | `#THEME_CSS#` | テーマレベルで定義されているカスケード・スタイルシート・ファイル。
ヘッダー | `#THEME_JAVASCRIPT#` | テーマレベルで定義されているJavaScriptファイル。
ヘッダー | `#THEME_STYLE_CSS#` | テーマ・スタイル・レベルで定義されているカスケード・スタイルシート・ファイル。
ページ | `#FAVICONS#` | アプリケーションのユーザー・インタフェース属性ファビコンのサポートを有効化します。開発者は、ファビコン(またはショートカット・アイコン)を作成するために、ファビコン属性を使用できます。この機能を使用するには、ページ・テンプレートに`#FAVICONS#`置換文字列が含まれている必要があります。
ページ | `#PAGE_TRANSITION#` | jQuery Mobileアプリケーションの他のページにナビゲートするために使用されるデフォルトのページ遷移。この新しいプレースホルダは、タイプ`role="page"`の`DIV`で使用する必要があります。次に例を示します。
    <div id="#PAGE_STATIC_ID#" data-role="page" data-apex-page-transition="#PAGE_TRANSITION#" data-apex-popup-transition="#POPUP_TRANSITION#" data-url="#REQUESTED_URL#">
ページ | `#PAGE_URL#` | ページURL。
JavaScript | `#DIALOG_ATTRIBUTES#` | 宣言的にサポートされていないダイアログ属性を定義します。
JavaScript | `#DIALOG_CSS_CLASSES#` | ダイアログCSSクラス。
JavaScript | `#DIALOG_HEIGHT#` | ダイアログの高さ。
JavaScript | `#DIALOG_MAX_WIDTH#` | ダイアログの最大幅。
JavaScript | `#DIALOG_WIDTH#` | ダイアログの幅。
JavaScript | `#IS_MODAL#` | ダイアログ・ページ・モード(たとえば、モーダルの場合は`true`、非モーダルの場合は`false`)。
JavaScript | `#SIDE_GLOBAL_NAVIGATION_LIST#` | ナビゲーション・メニュー(サイド)。
JavaScript | `#TOP_GLOBAL_NAVIGATION_LIST#` | ナビゲーション・メニュー(トップ)。
JavaScript | `#TRIGGERING_ELEMENT#` | トリガー要素(たとえば、現在のDOM要素)。

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

ダイアログ・ページ・テンプレートを作成するには、表11-12に示すページ・テンプレート属性を定義する必要があります。

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

属性 | 説明
--- | ---
名前、テンプレート・タイプ | 「ダイアログ・ページ」として定義する必要があります。
JavaScript、ダイアログ初期化コード | ダイアログとしてページを初期化するJavaScriptコードを入力します。ファンクション・コール構文は、フィールドレベル・ヘルプを参照してください。
JavaScript、ダイアログ・クロージャ・コード | ダイアログ・ページを閉じるJavaScriptコードを入力します。ファンクション・コール構文は、フィールドレベル・ヘルプを参照してください。
JavaScript、ダイアログ取消コード | ダイアログ・ページを取り消すJavaScriptコードを入力します。ファンクション・コール構文は、フィールドレベル・ヘルプを参照してください。
ダイアログ、幅 | ダイアログのデフォルトの幅を設定します。ページ・テンプレート・レベルの設定は、ページ・レベルで上書きできます。
ダイアログ、高さ | ダイアログのデフォルトの高さを設定します。ページ・テンプレート・レベルの設定は、ページ・レベルで上書きできます。
ダイアログ、最大幅 | ダイアログの最大幅をピクセル単位で設定します。ページ・テンプレート・レベルの設定は、ページ・レベルで上書きできます。
ダイアログ、CSSクラス | ダイアログに適用する追加のCSSクラスを入力します。ページ・テンプレート・レベルの設定は、ページ・レベルで上書きできます。
ダイアログ、フレームへの埋込みを許可 | この属性を使用してブラウザでアプリケーションのページをフレーム内に表示できるかどうかを制御するページ・モードを選択します。Application Expressは、iframeにモーダル・ダイアログを埋め込みます。アプリケーション・セキュリティ属性ブラウザ・フレームを「拒否」に設定する場合、「モーダル・ダイアログ」の「フレームへの埋込みを許可」を選択すると、かわりにこのテンプレートを使用するダイアログ・ページの「同じ起点から許可」が使用されます。

関連項目:

ダイアログ・ページの作成およびページ・テンプレート属性

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

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

トピック:

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

関連項目:

アプリケーション・レベルでのLOVの作成およびテーマの使用

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

関連項目:

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

この項では、ポップアップLOVテンプレートの編集ページの一部のセクションについて説明します。属性の詳細は、フィールドレベル・ヘルプを参照してください。

トピック:

- 検索フィールド
- ボタン
- ウィンドウ
- ページ区切り
- 結果セット
- ページ属性

#### 11.3.15.1.1 検索フィールド

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

表 11-13 検索フィールドの属性

属性 | 説明
--- | ---
フィールド・テキストの前 | ポップアップLOVの検索フィールドを表示する前に表示するテキストを定義します。
フィールド・テキストの後 | 検索フィールド、検索ボタンおよび閉じるボタンを表示した後にこのテキストを表示します。
フィルタ幅 | この幅を使用して、`HTML INPUT TYPE = TEXT`ウィジェットを表示します。
フィルタ最大幅 | この最大幅を使用して、`HTML INPUT TYPE = TEXT`ウィジェットを表示します。
フィルタ・テキスト属性 | これらの属性を使用して、`HTML INPUT TYPE = TEXT`ウィジェットを表示します。これは、HTML入力タグ内に含まれます。

#### 11.3.15.1.2 ボタン

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

#### 11.3.15.1.3 ウィンドウ

JavaScriptを使用してポップアップLOVが実行されます。これらの属性を使用して、`scrollbars=`、`resizable=`、`width=`および`height=`の値を制御します。

#### 11.3.15.1.4 ページ区切り

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

#### 11.3.15.1.5 結果セット

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

#### 11.3.15.1.6 ページ属性

これらの属性を使用してポップアップ・ページを定義します。

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

関連項目:

テンプレート・オプションの理解およびテーマのサブスクリプションの理解

リージョン・テンプレートは、リージョン属性の外観と配置を制御します。`#BODY#`や`#EDIT#`などの置換文字列を使用してリージョン属性を配置します。テンプレートの置換文字列は、大文字で指定し、シャープ記号(#)で囲む必要があります。

トピック:

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

関連項目:

リージョンについておよびテーマの使用

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

関連項目:

テンプレート・オプションの理解およびテーマのサブスクリプションの理解

この項では、リージョン・テンプレートの編集ページの一部の属性について説明します。特定の属性の詳細は、フィールドレベル・ヘルプを参照してください。

トピック:

- 名前
- 定義
- レイアウト
- サブリージョン
- 置換文字列

#### 11.3.16.1.1 名前

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

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

#### 11.3.16.1.2 定義

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

- `#TITLE#`

- `#PAGE_TITLE#`

- `#EXPAND#`

- `#CHANGE#`

- `#BODY#`

- `#SUB_REGION_HEADERS#`

- `#SUB_REGIONS#`

- `#FORM_OPEN#`

- `#FORM_CLOSE#`

- `#REGION_ID#`

- `#REGION_STATIC_ID#`

- `#REGION_CSS_CLASSES#`

- `#REGION_ATTRIBUTES#`

- `#REGION_HEADER#`

- `#REGION_FOOTER#`

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

- `#EDIT#`

- `#CLOSE#`

- `#CREATE#`

- `#CREATE2#`

- `#EXPAND#`

- `#HELP#`

- `#DELETE#`

- `#COPY#`

- `#NEXT#`

- `#PREVIOUS#`

関連項目:

置換文字列の理解

#### 11.3.16.1.3 レイアウト

ページ・アイテムは、リージョン内で表示されます。ページ・テンプレートのレイアウトが「表」に設定されている場合、各アイテムはHTML表に含まれます。この属性を使用して、この表の属性を設定します。

#### 11.3.16.1.4 サブリージョン

「ヘッダー・テンプレート」および「ヘッダー・エントリ・テンプレート」を使用して、現在のリージョンにおけるすべてのサブリージョンのリージョン・タイトルのリストを生成します。どちらのテンプレートでも、必要な置換文字列は`#ENTRIES#`のみです。

「テンプレート」を使用して、サブリージョンを追加のHTMLコードでラップします。必要な置換文字列は`#SUB_REGION#`のみです。この置換文字列は、サブリージョンのソースの配置場所を示します。他のすべての置換文字列はオプションです。

#### 11.3.16.1.5 置換文字列

コンポーネント値を参照するためにテンプレート内で使用される置換文字列を示します。

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

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

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

トピック:

- 汎用列テンプレートおよび名前付き列テンプレート
- 汎用列テンプレートのレポート列テンプレート属性
- 名前付き列テンプレートのレポート列テンプレート属性
- 列テンプレートでのJavaScriptの使用について

関連項目:

テーマの使用、テンプレート・オプションの理解およびテーマのサブスクリプションの理解

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

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

トピック:

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

#### 11.3.17.1.1 汎用列テンプレート

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

ここでは、汎用列テンプレートのレポート・テンプレートの編集ページの特定のセクションについて説明します。特定の属性の詳細は、フィールドレベル・ヘルプを参照してください。

トピック:

- レポート・テンプレート
- 行の前
- 列ヘッダー
- 各行の前
- 列テンプレート
- 各行の後
- 行の後
- 行選択
- ページ区切りサブテンプレート
- コメント

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

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

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

#### 11.3.17.2.2 行の前

「行の前」では、レポート・テンプレートの最初に1回表示するHTMLを入力します。

HTML表は、一般的に、次のようにこの属性を使用して開始します。

    <table>

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

    <table>#TOP_PAGINATION#

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

また、置換文字列`#REPORT_ATTRIBUTES#`を使用することもできます。この置換文字列は、レポート属性ページのレポート・リージョンごとに設定されます。

#### 11.3.17.2.3 列ヘッダー

「列ヘッダーの前」を使用して、レポート・ヘッダーの前にテキストを表示します。

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

    <th >Item Help Text</th>

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

    OMIT

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

「列ヘッダーの後」を使用して、レポート・ヘッダーの後にテキストを表示します。

#### 11.3.17.2.4 各行の前

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

- `#ROWNUM#`

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

- `#COLCOUNT#`

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

- `#HIGHLIGHT_ROW#`

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

#### 11.3.17.2.5 列テンプレート

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

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

表 11-14 列テンプレートの置換文字列

置換文字列 | 説明
--- | ---
`#ALIGNMENT#` | 列の位置合せを指定します。ユーザーが指定します。
`#COLCOUNT#` | 列数のカウントを定義します。
`#COLNUM#` | 現在の列番号を定義します。
`#COLUMN_HEADER#` | 列ヘッダーを定義します。
`#COLUMN_VALUE#` | 列の値に置換されます。
`#ROWNUM#` | 現在の行番号を指定します。

次に例を示します。

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

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

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

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

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

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

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

    #SAL# > 2000

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

    #ROWNUM# > 2000

#### 11.3.17.2.6 各行の後

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

    </tr>

#### 11.3.17.2.7 行の後

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

    </table>

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

- `#PAGINATION#`

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

- `#COLCOUNT#`

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

- `#CSV_LINK#`

  CSVのエクスポートが有効な場合に、CSVダウンロード・リンクに実行時に置換されます。それ以外の場合、文字列は表示されません。

- `#EXTERNAL_LINK#`

  実行時に、外部処理エンジン(PDFエクスポートなど)を使用するエクスポートのダウンロード・リンクに置換されます。この機能が有効でない場合、文字列は表示されません。

#### 11.3.17.2.8 行選択

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

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

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

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

ページ区切りサブテンプレート属性 | 説明
--- | ---
ページ区切りテンプレート | ページ区切りサブテンプレート全体に適用します。次に例を示します。
    <span class="instructiontext">#TEXT#</span>
置換文字列`#TEXT#`を使用して、ページ区切りサブテンプレートを表示する場所を指定します。 個々のアイテムを変更するには、その他のページ区切りサブテンプレート属性を使用します。
次のページ・テンプレート | ページ区切りサブテンプレートの「次のページ」部分を表示する方法を変更するHTMLを入力します。次に例を示します。
    <a href="#LINK#">next</a>
前のページ・テンプレート | ページ区切りサブテンプレートの「前のページ」部分を表示する方法を変更するHTMLを入力します。次に例を示します。
    <a href="#LINK#">previous</a>
次のセット・テンプレート | ページ区切りサブテンプレートの「次のセット」部分を表示する方法を変更するHTMLを入力します。次に例を示します。
    <a href="#LINK#">next set</a>
前のセット・テンプレート | ページ区切りサブテンプレートの「前の設定」部分を表示する方法を変更するHTMLを入力します。次に例を示します。
    <a href="#LINK#">previous set</a>

#### 11.3.17.2.10 コメント

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

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

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

トピック:

- 名前
- サブスクリプション
- 行テンプレート
- 列ヘッダー
- 最初の前および最後の後のテキスト
- ページ区切り
- コメント

#### 11.3.17.3.1 名前

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

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

#### 11.3.17.3.2 サブスクリプション

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

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

#### 11.3.17.3.3 行テンプレート

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

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

表 11-16 行テンプレートの置換文字列

置換文字列 | 説明
--- | ---
`#ALIGNMENT#` | 行の位置合せを指定します。ユーザーが指定します。
`#COLCOUNT#` | 列数のカウントを定義します。
`#COLNUM#` | 現在の列番号を定義します。
`#COLUMN_HEADER#` | 列ヘッダーを定義します。
`#COLUMN_VALUE#` | 列の値に置換されます。
`#ROWNUM#` | 現在の行番号を指定します。

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

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

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

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

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

    #SAL# > 2000

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

    #ROWNUM# > 2000

#### 11.3.17.3.4 列ヘッダー

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

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

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

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

    <table>

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

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

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

    <table>#TOP_PAGINATION#

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

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

    </table>

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

- `#PAGINATION#`

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

- `#COLCOUNT#`

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

#### 11.3.17.3.6 ページ区切り

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

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

ページ区切りサブテンプレート属性 | 説明
--- | ---
ページ区切りテンプレート | ページ区切りサブテンプレート全体に適用します。次に例を示します。
    <span class="instructiontext">#TEXT#</span>
置換文字列`#TEXT#`を使用して、ページ区切りサブテンプレートを表示する場所を指定します。 個々のアイテムを変更するには、その他のページ区切りサブテンプレート属性を使用します。
次のページ・テンプレート | ページ区切りサブテンプレートの「次のページ」部分を表示する方法を変更するHTMLを入力します。次に例を示します。
    <a href="#LINK#">next</a>
前のページ・テンプレート | ページ区切りサブテンプレートの「前のページ」部分を表示する方法を変更するHTMLを入力します。次に例を示します。
    <a href="#LINK#">previous</a>
次のセット・テンプレート | ページ区切りサブテンプレートの「次のセット」部分を表示する方法を変更するHTMLを入力します。次に例を示します。
    <a href="#LINK#">next set</a>
前のセット・テンプレート | ページ区切りサブテンプレートの「前の設定」部分を表示する方法を変更するHTMLを入力します。次に例を示します。
    <a href="#LINK#">previous set</a>

#### 11.3.17.3.7 コメント

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

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

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

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

関連項目:

リージョンについて