| Oracle® Application Expressアプリケーション・ビルダー・ユーザーズ・ガイド リリース18.1 E98591-01 |
|
 前 |
 次 |
既存のテンプレートを変更することで、カスタム・テーマを作成します。
Application Expressエンジンは、テーマと呼ばれるテンプレートのコレクションに基づいて、アプリケーション・ユーザー・インタフェースを作成します。テンプレートは、アプリケーション内のコンポーネントのルック・アンド・フィールを制御します。カスタム・テンプレートを作成するには、まず既存のテンプレートを変更する方法が最も簡単です。作成した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のバージョン番号が含まれており、以前のバージョンのテーマを使用しているアプリケーションをインポートした場合の下位互換性が維持されるようになっています。
親トピック: カスタム・テーマの作成
Oracle Application Expressではページ・テンプレートで.jsファイルを参照できます。このアプローチによって、そのファイル内のすべてのJavaScriptがアプリケーションにアクセス可能になります。.jsファイルはアプリケーションの最初のページ・ビューにロードされてからブラウザでキャッシュされるため、これは最も効率的なアプローチです。
関連項目:
親トピック: カスタム・テーマの作成
開発者は、先頭に感嘆符(!)の付いた事前定義済のフィルタ名を置換文字列に追加することで、置換値の特殊文字をエスケープできます。出力のエスケープは、ブラウザでクロス・サイト・スクリプティング(XSS)攻撃を回避するための重要なセキュリティ手法です。
関連項目:
親トピック: カスタム・テーマの作成
この項では、デフォルト・ページ・テンプレートの選択方法について説明します。デフォルトのページ・テンプレートは、2つの方法で指定できます。
特定のテーマ内のデフォルトのページ・テンプレートを選択します。
ページごとに特定のページ・テンプレートを選択します。
デフォルトでは、Application Expressエンジンは、テーマ・ページで指定されたページ・テンプレートを使用します。
テーマ内のデフォルトのページ・テンプレートを指定するには、次のステップを実行します。
関連項目:
親トピック: デフォルトのページ・テンプレートの選択
カスタム・テンプレートを作成するには、まず既存のテンプレートをコピーし、それを変更する必要があります。作成した1つ以上のデフォルト・テンプレートは、必要に応じて変更できます。
カスタム・テンプレートを作成するには、次のステップを実行します。
ヒント:
テンプレートが適切なテーマに関連付けられていることを確認します。
親トピック: カスタム・テーマの作成
開発者はテンプレート・オプションを使用して、宣言的な方法でOracle Application Expressのページ上のコンポーネントに様々なスタイルを適用できます。
関連項目:
親トピック: カスタム・テーマの作成
グローバル・テンプレート・オプション・グループはテーマレベルで定義され、特定のタイプのコンポーネントすべてで使用できます。この項では、グローバル・テンプレート・オプション・グループを作成および編集する方法について説明します。
親トピック: テンプレート・オプションの使用
グローバル・テンプレート・オプション・グループを作成するには、次のステップを実行します。
親トピック: グローバル・テンプレート・オプション・グループの管理
グローバル・テンプレート・オプション・グループを編集するには、次のステップを実行します。
親トピック: グローバル・テンプレート・オプション・グループの管理
この項では、グローバル・テンプレート・オプションを作成および編集する方法について説明します。
グローバル・テンプレート・オプションを作成するには、次のステップを実行します。
親トピック: グローバル・テンプレート・オプションの管理
グローバル・テンプレート・オプションを編集するには、次のステップを実行します。
親トピック: グローバル・テンプレート・オプションの管理
この項では、テンプレート・オプションを作成および編集する方法について説明します。
関連項目:
親トピック: テンプレート・オプションの使用
開発者は、実行時開発者ツールバーのクイック編集を使用して、「ライブ・テンプレート・オプション」ダイアログにアクセスすることもできます。開発者は、「ライブ・テンプレート・オプション」ダイアログを使用して、ページをリフレッシュすることなくコンポーネントのテンプレート・オプションを変更できます。
ライブ・テンプレート・オプションにアクセスするには、次のステップを実行します。
「ライブ・テンプレート・オプション」ダイアログが表示されます。リストやクラシック・レポートなどのリージョンベース・コンポーネントの場合は、ダイアログに「属性」タブが含まれます。
関連項目:
親トピック: テンプレート・オプションの管理
アプリケーション・ビルダーには、テンプレートの使用状況、サブスクリプション、パブリッシュされたテンプレートおよび編集履歴を示すレポートがあります。
カレント・アプリケーションについてのテンプレート・レポートを表示するには、次のステップを実行します。
親トピック: カスタム・テーマの作成
テンプレート・ページで、すべての使用可能なテンプレートを表示できます。また、特定のページに関連付けられているテンプレートにアクセスできます。
関連項目:
親トピック: カスタム・テーマの作成
特定のページに関連付けられているテンプレートを表示するには、次のステップを実行します。
関連項目:
親トピック: テンプレートの管理
テンプレートの置換ウィザードを使用してコンポーネントに関連付けられているテンプレートを更新できます。
コンポーネントに関連付けられているテンプレートを置換するには、次のステップを実行します。
親トピック: テンプレートの管理
アプリケーション内のすべてのテンプレートを別のアプリケーションのテンプレートに置換するには、次のステップを実行します。
親トピック: テンプレートの管理
ページ上のリージョンは、位置(表示ポイント)で構成されます。リージョンで使用可能な表示ポイントは、ページ・レベルのテンプレートによって決まります。
ページ・テンプレート別のリージョン位置の使用状況を表示するには、次のステップを実行します。
親トピック: テンプレートの管理
サブスクライブされるテンプレートとは、定義を別のテンプレートで管理されているテンプレート、つまり参照されるテンプレートです。アプリケーションで、サブスクライブされるテンプレートを使用している場合は、テンプレートのサブスクライブ解除ページでテンプレートのサブスクライブを解除できます。
テンプレートのサブスクライブを解除するには、次のステップを実行します。
親トピック: テンプレートの管理
テンプレートのパブリッシュ・ページを使用して、ワークスペースの他のテンプレートによってサブスクライブされるテンプレートを表示します。
マスター・テンプレートの内容を、サブスクライブしているテンプレートにパブリッシュするには、次のステップを実行します。
親トピック: テンプレートの管理
ブレッドクラム・テンプレートは、ブレッドクラム・エントリの表示方法を制御します。このテンプレートは、リージョンの作成時に選択します。
関連項目:
ブレッドクラムは通常、現在のページが、アプリケーション内の他のページに対してどの位置にあるかを示します。また、ユーザーは特定のページをクリックするだけで、そのページを表示することができます。たとえば、Oracle Application Expressのサンプル・データベース・アプリケーションでは、Administrationページの上部にブレッドクラム・メニューが表示されます。
関連項目:
親トピック: ブレッドクラム・テンプレート
ブレッドクラム・テンプレートは、ブレッドクラム・リージョン・タイプの表示方法を制御します。このテンプレートは、リージョンの作成時に選択します。特定の属性の詳細は、フィールドレベル・ヘルプを参照してください。
親トピック: ブレッドクラム・テンプレート
「名前」は、テンプレートの名前を示します。テンプレートに翻訳が必要なテキスト文字列が含まれていることを示すには、「翻訳可能」チェック・ボックスを使用します。「テーマ」は、テンプレートが関連付けられているテーマを示します。「テンプレート・クラス」は、そのテンプレートに固有の用途を示します。テーマに切り替えると、あるテーマのすべてのテンプレートは、別のテーマの対応するテンプレートにマップされます。アプリケーション・ビルダーは、テンプレート・クラスの割当てによってこのテンプレート・マッピングを行います。
親トピック: ブレッドクラム・テンプレート属性
定義属性は、ブレッドクラムの表示方法を制御します。表12-8に、定義属性を示します。
表12-8 定義属性
| 属性 | 説明 |
|---|---|
最初の前 |
最初のブレッドクラム・エントリの前に表示するテキストを定義します。置換文字列 参照: リージョン属性の編集 |
カレント・ページのブレッドクラム・エントリ |
カレント・ページに対応するブレッドクラム・エントリの外観を定義します。 |
カレント・ページ以外のブレッドクラム・エントリ |
カレント・ページに対応していないブレッドクラム・エントリの外観を定義します。 |
最後の後 |
最後のブレッドクラム・エントリの後に表示するテキストを定義します。 |
レベル間 |
ブレッドクラム・エントリのレベル間に表示するテキストを定義します。 |
最大レベル |
ブレッドクラムをブレッドクラム・スタイルで表示する際に使用するレベル数を指定します。 |
親トピック: ブレッドクラム・テンプレート属性
置換文字列は、コンポーネント値を参照するためにサブテンプレート内で使用されます。表12-9に、使用可能なボタン・テンプレートの置換文字列を示します。
ヒント:
テンプレートのすべての置換文字列は、大文字で指定し、シャープ記号(#)で囲む必要があります。特定のテンプレートでサポートされる置換文字列のレポートを表示するには、ブレッドクラム・テンプレートの編集ページの「置換文字列」セクションを参照してください。
表12-9 ブレッドクラム・テンプレートの置換文字列
| 参照元 | 置換文字列 | 説明 |
|---|---|---|
最初の前 |
|
コンポーネントCSSクラス。
|
カレント・エントリ |
URLリンク。 |
|
カレント・エントリ |
ブレッドクラムの詳細な名前。 |
|
カレント・エントリ |
ブレッドクラム・ラベル。 |
|
カレント・エントリ |
ブレッドクラム・ラベル(HTML文字をエスケープ)。 |
|
非カレント・エントリ |
URLリンク。 |
|
非カレント・エントリ |
ブレッドクラムの詳細な名前。 |
|
非カレント・エントリ |
ブレッドクラム・ラベル。 |
|
非カレント・エントリ |
ブレッドクラム・ラベル(HTML文字をエスケープ)。 |
親トピック: ブレッドクラム・テンプレート属性
ボタン・テンプレートを使用すると、開発者は、ボタンのルック・アンド・フィールをカスタマイズできます。ボタンを構築する場合、複数のイメージまたはHTMLタグを使用できます。ボタン・テンプレートの使用はオプションです。
関連項目:
親トピック: カスタム・テーマの作成
この項では、ボタン・テンプレートの編集ページの一部のセクションについて説明します。特定の属性の詳細は、フィールドレベル・ヘルプを参照してください。
「テンプレート名」は、テンプレートの名前を示します。テンプレートに変換が必要なテキスト文字列が含まれているかどうかを示すには、「翻訳可能」チェック・ボックスを使用します。「テーマ」は、テンプレートが関連付けられているテーマを示します。
「テンプレート・クラス」は、そのテンプレートに固有の用途を示します。テーマに切り替えると、あるテーマのすべてのテンプレートは、別のテーマの対応するテンプレートにマップされます。アプリケーション・ビルダーは、テンプレート・クラスの割当てによってこのテンプレート・マッピングを行います。
親トピック: ボタン・テンプレート属性
「通常のテンプレート」では、ボタン・タイプが「標準」の場合に表示されるボタン・テンプレートが定義されます。たとえば、&ITEM_NAME値はレンダリング時に置換できます。「ホット・テンプレート」では、ボタン・タイプが「ホット」の場合に表示されるボタン・テンプレートが定義されます。標準のアプリケーション置換文字列を含めることもできます。たとえば、&ITEM_NAME値はレンダリング時に置換できます。
サポートされている置換文字列の詳細は、フィールドレベル・ヘルプを参照してください。
ヒント:
置換文字列はすべて大文字である必要があります。
親トピック: ボタン・テンプレート属性
置換文字列は、コンポーネント値を参照するためにサブテンプレート内で使用されます。表12-10に、使用可能なボタン・テンプレートの置換文字列を示します。
ヒント:
テンプレートのすべての置換文字列は、大文字で指定し、シャープ記号(#)で囲む必要があります。特定のテンプレートでサポートされる置換文字列のレポートを表示するには、ページ・テンプレートの編集ページの「置換文字列」セクションを参照してください。
表12-10 ボタン・テンプレートの置換文字列
| 参照元 | 置換文字列 | 説明 |
|---|---|---|
ホット・テンプレート |
|
ボタン属性。 |
ホット・テンプレート |
ボタンCSSクラス。
|
|
ホット・テンプレート |
生成されるボタンIDは、ボタンの静的ID (定義されている場合)または |
|
ホット・テンプレート |
|
アイコンCSSクラス。 |
ホット・テンプレート |
onclick属性で使用されます。 |
|
ホット・テンプレート |
ボタン・ラベル。 |
|
ホット・テンプレート |
|
|
テンプレート |
ボタン属性。 |
|
テンプレート |
ボタンCSSクラス。
|
|
テンプレート |
生成されるボタンIDは、ボタンの静的ID (定義されている場合)または |
|
テンプレート |
アイコンCSSクラス。 |
|
テンプレート |
onclick属性で使用されます。 |
|
テンプレート |
ボタン・ラベル。 |
|
テンプレート |
|
親トピック: ボタン・テンプレート属性
レガシー・カレンダ・テンプレートは、カレンダの外観と配置を制御します。このテンプレートは、頻繁にHTML表を使用して日付を配置します。#DD#や#MONTH#などの置換文字列を使用してカレンダ属性を配置します。
関連項目:
親トピック: カスタム・テーマの作成
サポートされている置換文字列のリストは、カレンダ・テンプレートの編集ページの右側に表示されます。テンプレートの置換文字列は大文字で指定し、シャープ記号(#)で囲む必要があることに注意してください。
親トピック: レガシー・カレンダ・テンプレート
この項では、カレンダ・テンプレートの編集ページの一部のセクションについて説明します。特定の属性の詳細は、フィールドレベル・ヘルプを参照してください。
関連項目:
カレンダ定義
親トピック: レガシー・カレンダ・テンプレート
「名前」は、テンプレートの名前を示します。テンプレートに変換が必要なテキスト文字列が含まれているかどうかを示すには、「翻訳可能」チェック・ボックスを使用します。「テーマ」は、テンプレートが関連付けられているテーマを示します。
「テンプレート・クラス」は、そのテンプレートに固有の用途を示します。テーマに切り替えると、あるテーマのすべてのテンプレートは、別のテーマの対応するテンプレートにマップされます。アプリケーション・ビルダーは、テンプレート・クラスの割当てによってこのテンプレート・マッピングを行います。
親トピック: レガシー・カレンダ・テンプレート属性
「サブスクリプション」を使用して、カレント・アプリケーションに既存のテンプレートを適用します。
「マスター・ラベル・テンプレートの参照元」を使用して、対象のワークスペースの既存のテンプレート、またはワークスペースのスキーマの別のテンプレートを選択します。既存のテンプレートを選択すると、ユーザーはそのテンプレートのサブスクライバになります。
マスター・テンプレートのコピーをロードするには、「リフレッシュ」をクリックします。
親トピック: レガシー・カレンダ・テンプレート属性
この属性を使用して、このコンポーネントに関するコメントを記録します。
月次カレンダ、週次カレンダ、日次カレンダ、カスタム・カレンダおよびリスト・カレンダ
親トピック: レガシー・カレンダ・テンプレート属性
ラベル・テンプレートは、ページ・アイテム・ラベルのHTMLマークアップを集中管理することを目的としています。各アイテムにはオプションのラベルがあります。ラベル・テンプレートを使用して、これらのラベルの表示方法を制御できます。たとえば、ユーザーに必須であることを示すイメージ(アスタリスクなど)を参照する「必須フィールド」というラベル・テンプレートを作成できます。
ラベル・テンプレートを使用すると、アイテムの先頭と末尾に追加するテキスト文字列を定義できます。
関連項目:
ここでは、ラベル・テンプレートの編集ページの特定のセクションについて説明します。特定の属性の詳細は、フィールドレベル・ヘルプを参照してください。
親トピック: ラベル・テンプレート
「テンプレート名」は、テンプレートの名前を示します。テンプレートに翻訳が必要なテキスト文字列が含まれていることを示すには、「翻訳可能」チェック・ボックスを使用します。 「テーマ」は、テンプレートが関連付けられているテーマを示します。
「テンプレート・クラス」は、そのテンプレートに固有の用途を示します。テーマに切り替えると、あるテーマのすべてのテンプレートは、別のテーマの対応するテンプレートにマップされます。アプリケーション・ビルダーは、テンプレート・クラスの割当てによってこのテンプレート・マッピングを行います。
親トピック: ラベル・テンプレート属性
定義属性は次のとおりです。
ヒント:
サポートされている置換文字列のリストおよび例は、フィールドレベル・ヘルプを参照してください。
ラベルの前 - アイテム・ラベルの前に表示するHTMLを入力します。#ITEM_CSS_CLASSES#置換文字列は、テンプレート・オプションが定義されているテンプレートに含める必要があります。
ラベルの後 - アイテム・ラベルの後に表示するHTMLを入力します。このラベルはこのリージョンのHTMLの前に自動的に表示されるため、「ラベルの前」リージョンの開始タグを閉じる必要があります。
アイテムの前 - フォーム・アイテムの直前に表示するHTMLを入力します。これは通常、アイテムをDIVコンテナにラップするか、フォーム・アイテムの前または後にヘルプ・ボタンを表示するために使用されます。
アイテムの後 - フォーム・アイテムの直後に表示するHTMLを入力します。これは通常、アイテムをDIVコンテナにラップするか、フォーム・アイテムの前または後にヘルプ・ボタンを表示するために使用されます。
アイテム事前テキスト - アイテム属性の前のテキストとして格納されるコンテンツを書式設定するためのアイテム事前テキスト・サブテンプレートのHTMLを入力します。このサブテンプレートは、#ITEM_PRE_TEXT#の置換を使用して要素前テンプレートで参照できます。
アイテム事後テキスト - アイテム属性の後のテキストとして格納されるコンテンツを書式設定するためのアイテム事後テキスト・サブテンプレートのHTMLを入力します。このサブテンプレートは、#ITEM_PRE_TEXT#の置換を使用して要素後テンプレートで参照できます。
ヘルプ・テンプレート - ヘルプ・サブテンプレートでは、開発者がアイテム・レベルのヘルプの起動に使用されるリンクまたはボタンを定義できます。このサブテンプレートは、ヘルプが定義されているアイテムに対してのみレンダリングされます。#CURRENT_ITEM_HELP_TEXT#を使用したアイテム・ヘルプの作成についてを参照してください。
インライン・ヘルプ・テンプレート - ヘルプ・サブテンプレートでは、開発者がアイテムとともに即座に表示するインライン・ヘルプ・テキストを定義できます。このサブテンプレートは、インライン・ヘルプ・テキストが定義されているアイテムに対してのみレンダリングされます。
親トピック: ラベル・テンプレート属性
エラー表示属性は次のとおりです。
ヒント:
サポートされている置換文字列のリストおよび例は、フィールドレベル・ヘルプを参照してください。
ラベルの前のエラー発生時 - アプリケーションがアイテムのインライン検証エラー・メッセージを表示する場合に、そのアイテム・ラベルの前に表示するHTMLを入力します。
ラベルの後のエラー発生時 - アプリケーションがアイテムのインライン検証エラー・メッセージを表示する場合に、そのアイテム・ラベルに追加するHTMLを入力します。
エラー・テンプレート - インライン検証エラー・メッセージを表示するためにレンダリングされるHTMLを入力します。メッセージ・テキストを参照するには、#ERROR_MESSAGE#置換文字列を使用します。#ERROR_TEMPLATE#置換文字列を使用して、アイテム属性の前後にエラー・テンプレートを含めることができます。
親トピック: ラベル・テンプレート属性
フィールド・コンテナ属性は次のとおりです。
ヒント:
サポートされている置換文字列のリストおよび例は、フィールドレベル・ヘルプを参照してください。
「ラベルの前」とアイテム - ラベルおよびアイテムの前に表示するHTMLを入力します。これは、通常、アイテムをDIVコンテナまたはフィールド・セットにラップするために使用されます。「「ラベルの前」とアイテム」属性は、表グリッドを使用してフォーム・アイテムを表示しないページにのみレンダリングされます。これには、モバイル・ページ・テンプレートを使用したページが含まれます。
「ラベルの後」とアイテム - ラベルおよびアイテムの後に表示するHTMLを入力します。これは、通常、アイテムをDIVコンテナまたはフィールド・セットにラップするために使用されます。後のアイテムおよびラベル属性は、表グリッドを使用してフォーム・アイテムを表示しないページにのみレンダリングされます。これには、モバイル・ページ・テンプレートを使用したページが含まれます。
親トピック: ラベル・テンプレート属性
このテンプレートの置換文字列の用途を一覧します。置換文字列は、サブテンプレート内でコンポーネント値を参照するために使用されます。
親トピック: ラベル・テンプレート属性
#CURRENT_ITEM_HELP_TEXT#置換文字列を使用すると、ページのレンダリング時にインライン・ページ・ヘルプ・テキストを作成できます。たとえば、この置換文字列を使用すると、マウスをページ・アイテム・ラベルにあわせたときにツールチップとして表示されるページ・ヘルプ・テキストを作成できます。このプレースホルダによって、コストのかかるAjaxコールを実行せずに、レンダリング時にページにヘルプ・テキストを表示できます。
ヒント:
ヘルプ・テキストが短い場合は、このプレースホルダのみが使用されます。生成されるページには常に、すべてのページ・アイテムのヘルプ・テキストが含まれます。
ラベル・テンプレートの例
ラベルの前:
<label for="#CURRENT_ITEM_NAME#" id="#LABEL_ID#"> <span class="helpText">#CURRENT_ITEM_HELP_TEXT#</span>
ラベルの後:
</label>
親トピック: ラベル・テンプレート
リストは、リンクの共有コレクションです。リストの外観は、リスト・テンプレートで制御します。テンプレート属性を使用すると、特定のページのカレントまたは非カレントとしてリスト要素を定義できます。
Oracle Application Expressでは、階層的なリストをサポートしています。階層的なリストを作成するには、次のステップを実行します。
階層的なリストをサポートするリスト・テンプレートを選択します。階層的なリストをサポートするリスト・テンプレートを判別するには、サブリスト付きというネーミング規則のあるテンプレートを検索します。
各リスト・エントリの作成時には親リスト・エントリを選択します。
関連項目:
親トピック: リスト・テンプレート
関連項目:
この項では、リスト・テンプレートの編集ページの一部のセクションについて説明します。特定の属性の詳細は、フィールドレベル・ヘルプを参照してください。
親トピック: リスト・テンプレート
「名前」は、テンプレートの名前を示します。テンプレートに翻訳が必要なテキスト文字列が含まれていることを示すには、「翻訳可能」チェック・ボックスを使用します。 「テーマ」は、テンプレートが関連付けられているテーマを示します。
「テンプレート・クラス」は、そのテンプレートに固有の用途を示します。新しいテーマに切り替えると、あるテーマのすべてのテンプレートは、別のテーマの対応するテンプレートにマップされます。アプリケーション・ビルダーは、テンプレート・クラスの割当てによってこのテンプレート・マッピングを行います。
親トピック: リスト・テンプレート属性
リスト要素の前に表示するHTMLを入力します。この属性は、HTML表またはHTML表の行を開始するために使用できます。#COMPONENT_CSS_CLASSES#置換文字列は、テンプレート・オプションが定義されているテンプレートの行の前のリスト・テンプレート属性に含める必要があります。
親トピック: リスト・テンプレート属性
カレントおよび非カレントのリスト・テンプレートを定義します。サポートされている置換文字列は、#LINK#、#TEXT#、#TEXT_ESC_SC#、#ICON_CSS_CLASSES#、#IMAGE_PREFIX#、#IMAGE#、#IMAGE_ATTR#および#A01#...#A10#です。
テンプレート定義属性は次のとおりです。
カレント・リスト・テンプレート: 選択された(カレントの)リスト・テンプレートに置換されるHTMLまたはテキストを入力します。
サブリスト・アイテムが含まれているカレント・リスト・テンプレート:アイテムにサブリスト・アイテムが含まれる場合は、選択された(カレントの)リスト・テンプレートに置換されるHTMLまたはテキストを入力します。指定しない場合、現在のリスト・アイテム・テンプレートが使用されます。
非カレント・リスト・テンプレート:選択されていない(非カレントの)リスト・テンプレートに置換されるHTMLまたはテキストを入力します。
サブリスト・アイテムが含まれている非カレント・リスト・テンプレート:アイテムにサブリスト・アイテムが含まれる場合は、選択されていない(非カレントの)リスト・テンプレートに置換されるHTMLまたはテキストを入力します。指定しない場合、現在のリスト・アイテム・テンプレートが使用されます。
リスト要素間: リスト要素の間に表示するHTMLを入力します。HTMLを指定しないと、この属性が無視されます。
親トピック: リスト・テンプレート属性
選択可能な属性は次のとおりです。
カレント・リスト・テンプレート(最初):定義されている場合、これは最初のリスト・アイテムに使用されます。選択された(カレントの)リスト・テンプレートに置換されるHTMLまたはテキストを入力します。
サブリスト・アイテムが含まれているカレント・リスト・テンプレート(最初):定義されている場合、これは最初のリスト・アイテムに使用されます。アイテムにサブリスト・アイテムが含まれる場合に使用される、選択された(カレントの)リスト・テンプレートに置換されるHTMLまたはテキスト。
非カレント・リスト・テンプレート(最初):定義されている場合、これは最初のリスト・アイテムに使用されます。選択されていない(非カレントの)リスト・テンプレートに置換されるHTMLまたはテキストを入力します。
サブリスト・アイテムが含まれている非カレント・リスト・テンプレート(最初):定義されている場合、これは最初のリスト・アイテムに使用されます。アイテムにサブリスト・アイテムが含まれる場合に使用される、選択されていない(非カレントの)リスト・テンプレートに置換されるHTMLまたはテキスト。
親トピック: リスト・テンプレート属性
カレントおよび非カレントのリスト・テンプレートを定義します。サポートされている置換文字列は、#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を指定しないと、この属性が無視されます。
親トピック: リスト・テンプレート属性
すべてのリスト要素を表示した後に表示するHTMLを入力します。この属性を使用して、リスト前の要素属性で開始したHTML表を閉じることができます。
親トピック: リスト・テンプレート属性
このテンプレートの置換文字列の用途を一覧します。置換文字列は、サブテンプレート内でコンポーネント値を参照するために使用されます。
親トピック: リスト・テンプレート属性
ページ・テンプレートは、ページの外観を定義します。各テンプレートは、ヘッダー・テンプレート、ボディ・テンプレート、フッター・テンプレートおよび多くのサブテンプレートで構成されます。ページ・レベル属性でページ・テンプレートを指定しない場合、Application Expressエンジンは、テーマの作成/編集ページで定義したデフォルトのページ・テンプレートを使用します。
ページ・テンプレートは、静的HTMLと実行時に置き換えられる置換文字列を組み合せたものです。置換文字列を使用して、ページ・テンプレート内のコンポーネントの存在と配置を指定します。さらに、サブテンプレートを使用して、コンポーネントの表示方法を指定できます。
関連項目:
ここでは、ページ・テンプレートの編集ページの特定のセクションについて説明します。サポートされている置換文字列など、特定の属性の詳細は、フィールドレベル・ヘルプを参照してください。
親トピック: ページ・テンプレート
「名前」は、テンプレートの名前を示します。「テーマ」は、テンプレートが関連付けられているテーマを示します。
「テンプレート・クラス」は、そのテンプレートに固有の用途を示します。新しいテーマに切り替えると、あるテーマのすべてのテンプレートは、別のテーマの対応するテンプレートにマップされます。アプリケーション・ビルダーは、テンプレート・クラスの割当てによってこのテンプレート・マッピングを行います。
「翻訳可能」チェック・ボックスを使用して、対象のテンプレートに翻訳が必要なテキスト文字列が含まれているかどうかを示します。
「テンプレート・タイプ」はページ・テンプレート・タイプを指定します。「ダイアログ・ページ」に設定すると、そのテンプレートを選択できるのは、ページ・モードが「モーダル」または「非モーダル」のページのみになります。「標準ページ」に設定すると、そのテンプレートを選択できるのは、ページ・モードが「標準」のページのみになります。
親トピック: ページ・テンプレート属性
各テンプレートは、ヘッダー、ボディ、フッターおよびサブテンプレートで構成されます。動的コンテンツを含めるには、置換文字列を使用します。テンプレートのすべての置換文字列は、大文字で指定し、シャープ記号(#)で囲む必要があります。
ヒント:
サポートされている置換文字列のリストおよび例は、フィールドレベル・ヘルプを参照してください。
定義属性は次のとおりです。
ヘッダー: HTMLドキュメントの<Head>セクションを定義するHTMLを入力します。このテンプレート・セクションには、少なくとも#TITLE#および#HEAD#を含めることをお薦めします。
ボディ: HTMLドキュメントの<Body>セクションを構成するHTMLを入力します。ボディ・コンテンツの配置場所および追加のリージョン位置を定義する置換文字列を含めます。
フッター: ボディの後に表示する、ページ・テンプレートの3番目のセクションを定義するHTMLを入力します。
親トピック: ページ・テンプレート属性
選択可能な属性は次のとおりです。
ヒント:
サポートされている置換文字列のリストおよび例は、フィールドレベル・ヘルプを参照してください。
ファイル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コードを入力します。
親トピック: ページ・テンプレート属性
選択可能な属性は次のとおりです。
ファイルURL - このページ・テンプレートにロードされるカスケード・スタイルシート・ファイルURLを入力します。各URLを新しい行に記述する必要があります。ファイルの縮小バージョンを指定する場合、置換文字列#MIN#を使用して、通常ページ・ビューのファイルURLに.minを含めたり、ページをデバッグ・モードで表示する場合は空の文字列を含めることができます。置換文字列#APP_VERSION#を使用すると、ファイルURLにアプリケーションのバージョンを含めることができます。ここに入力したファイルURLによって、テンプレート内の#TEMPLATE_CSS#置換文字列が置き換えられます。
スクリプトの開始タグや閉じタグを含めずに、ファイルURLのみを含めます。
インライン - このページ・テンプレートに使用されるカスケード・スタイルシートのコードを入力します。重複を避け、ブラウザで静的ファイルをキャッシュするため、外部ファイルに挿入することを検討してください。ここに入力したコードによって、テンプレート内の#TEMPLATE_CSS#置換文字列が置き換えられます。
開始スタイル・タグや閉じスタイル・タグを含めずに、カスケード・スタイルシートのコードのみを含めます。
親トピック: ページ・テンプレート属性
次のサブテンプレートのHTMLを入力します。サブテンプレートは、置換文字列を使用してページ・テンプレートのボディ内に配置されます。
サブテンプレートは次のとおりです。
成功メッセージ - テンプレート・ボディ、ヘッダー、フッター内の文字列#SUCCESS_MESSAGE#を置換するHTMLを入力します。
ナビゲーション・バー - テンプレート・ヘッダー、ボディ、フッター内の文字列#NAVIGATION_BAR#を置換するHTMLまたはテキストを入力します。置換文字列#BAR_BODY#を使用して、ナビゲーション・バーにエントリが表示される位置を指定します。
ナビゲーション・バー・エントリ - 各ナビゲーション・バー・エントリのナビゲーション・バー#BAR_BODY#置換文字列に置換されるHTMLまたはテキストを入力します。
通知 - #NOTIFICATION_MESSAGE#置換文字列が、テンプレートのヘッダー、ボディまたはフッターで参照される際に置換されるHTMLまたはテキストを入力します。
親トピック: ページ・テンプレート属性
このサブテンプレートは、完全にイメージに基づくタブに使用します。選択可能な属性は次のとおりです。
カレント・イメージ・タブ - イメージベースのタブが現在選択されていることを示すために使用するHTMLを入力します。タブに表示される名前を示す#TAB_TEXT#置換文字列を含めます。
非カレント・イメージ・タブ - イメージ・タブが現在選択されていないことを示すために使用するHTMLを入力します。タブに表示される名前を示す#TAB_TEXT#置換文字列を含めます。
親トピック: ページ・テンプレート属性
ページで使用するレイアウトのタイプを指定します。選択したタイプによって、表示される属性が決まります。属性の詳細は、フィールドレベル・ヘルプを参照してください。
「タイプ」から、レイアウトを選択します。
HTML表: HTML表を使用して、リージョン、ページ・アイテムおよびボタンを配置します。
固定列数: 画面を固定のグリッド列数で分割するグリッドに使用します。
可変列数: リージョン、ページ・アイテムおよびボタンの配置方法に応じて、グリッド列を最大n列まで表示できるグリッドに使用します。
親トピック: ページ・テンプレート属性
選択可能な属性は次のとおりです。
ブレッドクラム表示ポイント - ブレッドクラムを使用する生成済コンポーネントに適用されます。ブレッドクラムが配置されるページ上の位置を定義します。サイドバー表示ポイント
サイドバー表示ポイント - サイドバーを使用する生成済コンポーネントに適用されます。サイドバーが配置されるページ上の位置を定義します。
親トピック: ページ・テンプレート属性
ダイアログ属性は、「テンプレート・タイプ」に「ダイアログ・ページ」を選択した場合にのみ表示されます。これらの設定は、ページ・レベルで指定された類似の属性によって上書きされます。
選択可能なダイアログ属性は次のとおりです。
幅 - ダイアログの幅をピクセル単位または比率で入力します。
高さ - ダイアログの高さをピクセル単位で入力します(たとえば、500)。
最大幅 - ダイアログの最大幅をピクセル単位で入力します。jQuery Mobileスマートフォン・ユーザー・インタフェースを使用しているページの場合、最大幅は500です。
CSSクラス - ダイアログに適用する追加のCSSクラスを、空白区切りのリストとして入力します。
フレームへの埋込みを許可 - ページ・テンプレート・レベルのブラウザ・フレーム・オプションが、各オプションの現在の設定とともに下に示されます。ブラウザでアプリケーションのページをフレーム内に表示できるかどうかを選択します。現在の設定が、このページ・テンプレートを使用する各モーダルおよび非モーダル・ページのデフォルトです。詳細は、フィールドレベル・ヘルプを参照してください。
Oracle Application Expressは、iframeにモーダル・ダイアログを埋め込みます。アプリケーション・セキュリティ属性ブラウザ・フレームを「拒否」に設定する場合、「モーダル・ダイアログ」の「フレームへの埋込みを許可」を選択すると、かわりにこのテンプレートを使用するダイアログ・ページの「同じ起点から許可」が使用されます
親トピック: ページ・テンプレート属性
表 12-11に、使用可能なページ・テンプレートの置換文字列を示します。置換文字列は、サブテンプレート内でコンポーネント値を参照するために使用されます。
ヒント:
テンプレートのすべての置換文字列は、大文字で指定し、シャープ記号(#)で囲む必要があります。特定のテンプレートでサポートされる置換文字列のレポートを表示するには、ページ・テンプレートの編集ページの「置換文字列」セクションを参照してください。
表 12-11 ページ・テンプレートの置換文字列
| 参照元 | 置換文字列 | 説明 |
|---|---|---|
すべて |
ハイ・コントラストの切替え。 |
|
すべて |
ページの静的ID (例: |
|
すべて |
親タブの表示。 |
|
すべて |
リージョン位置1。 |
|
すべて |
リージョン位置2。 |
|
すべて |
リージョン位置3。 |
|
すべて |
リージョン位置4。 |
|
すべて |
リージョン位置5。 |
|
すべて |
リージョン位置6。 |
|
すべて |
リージョン位置7。 |
|
すべて |
リージョン位置8。 |
|
すべて |
ブラウザによってリクエストされたページURL |
|
すべて |
スクリーン・リーダーの切替え。 |
|
すべて |
|
デスクトップ・ユーザー・インタフェースのホームページへのハイパーリンク。 |
すべて |
|
スマートフォン・ユーザー・インタフェースのホーム・ページへのハイパーリンク。 |
すべて |
ページ・タイトルを定義します。通常、HTMLのtitleタグ内に含まれます。 |
|
ボディ |
ページ・ボディ。 |
|
ボディ |
ボディを表示する位置。ボディがNULLの場合、かわりに |
|
ボディ |
HTMLのフォームの開始タグ |
|
ボディ |
コンポーネントによって作成されるカスケード・スタイルシート・ファイル。 |
|
ボディ |
グローバル通知属性を表示します。グローバル通知は、システム・ステータス(保留中のシステム停止時間など)との通信に使用します。 関連項目: グローバル通知 |
|
ボディ |
アプリケーション・イメージまたはログ。 「アプリケーション定義の編集」ページの「ロゴ」セクションで、アプリケーションのロゴのイメージおよびイメージ属性を指定できます。この機能を使用するには、「ヘッダー」または「ボディ」ページ・テンプレートに置換文字列 関連項目: ロゴ |
|
ボディ |
ナビゲーション・バー。 関連項目: 「ナビゲーション・バー」サブテンプレートは、サブテンプレートを参照してください。 |
|
ボディ |
インライン・エラー・メッセージのサマリーが表示される位置を定義します。インライン・エラー・メッセージは、フィールドの横または通知領域にインライン(あるいはその両方)で表示できます。 |
|
ボディ |
jQuery Mobileアプリケーションでダイアログを開くために使用されるデフォルトのページ遷移。この新しいプレースホルダは、タイプ <div id="#PAGE_STATIC_ID#" data-role="page" data-apex-page-transition="#PAGE_TRANSITION#" data-apex-popup-transition="#POPUP_TRANSITION#" data-url="#REQUESTED_URL#"> |
|
ボディ |
成功メッセージ。ページの成功メッセージおよびエラー・メッセージを表示する位置を定義します。エラーなしでページ・プロセスが実行されると、このテキストが表示されます。 成功メッセージの前後にHTMLを追加すると、各テンプレートの成功メッセージの表示をカスタマイズできます。 |
|
ボディ |
標準タブの表示。 |
|
ボディ |
標準タブの表示。 |
|
フッター |
「カスタマイズ」リンク。 |
|
フッター |
HTMLのフォームの終了タグ |
|
フッター |
「Built with ♥ using Oracle APEX」を表示します。 |
|
ヘッダー |
Application Expressによって使用されるカスケード・スタイルシート・ファイル。 |
|
ヘッダー |
Oracle Application Expressによって使用されるJavaScriptファイルとコード。 |
|
ヘッダー |
ユーザー・インタフェース・レベルで定義されているCSSファイル。 |
|
ヘッダー |
ユーザー・インタフェース・レベルで定義されているJavaScriptファイル。 |
|
ヘッダー |
コンポーネントによって必要に応じて作成されるJavaScriptコード。 |
|
ヘッダー |
|
|
ヘッダー |
ページのonload。 Webブラウザでページがロードされたときに実行されるJavaScriptコールで、この文字列を置換文字列として使用します。コールするJavaScriptは、ページごとに変更できます。 |
|
ヘッダー |
ページ・レベルで定義されているカスケード・スタイルシート・ファイルとインライン・スタイル。 |
|
ヘッダー |
ページ・レベルで定義されているJavaScriptファイルとコード。 |
|
ヘッダー |
ページ・テンプレート・レベルで定義されているカスケード・スタイルシート・ファイルとインライン・スタイル。 |
|
ヘッダー |
テーマレベルで定義されているカスケード・スタイルシート・ファイル。 |
|
ヘッダー |
|
テーマレベルで定義されているJavaScriptファイル。 |
ヘッダー |
テーマ・スタイル・レベルで定義されているカスケード・スタイルシート・ファイル。 |
|
ページ |
アプリケーションのユーザー・インタフェース属性ファビコンのサポートを有効化します。開発者は、ファビコン(またはショートカット・アイコン)を作成するために、ファビコン属性を使用できます。この機能を使用するには、ページ・テンプレートに |
|
ページ |
jQuery Mobileアプリケーションの他のページにナビゲートするために使用されるデフォルトのページ遷移。この新しいプレースホルダは、タイプ <div id="#PAGE_STATIC_ID#" data-role="page" data-apex-page-transition="#PAGE_TRANSITION#" data-apex-popup-transition="#POPUP_TRANSITION#" data-url="#REQUESTED_URL#"> |
|
ページ |
ページURL。 |
|
JavaScript |
宣言的にサポートされていないダイアログ属性を定義します。 |
|
JavaScript |
ダイアログCSSクラス。 |
|
JavaScript |
ダイアログの高さ。 |
|
JavaScript |
ダイアログの最大幅。 |
|
JavaScript |
ダイアログの幅。 |
|
JavaScript |
ダイアログ・ページ・モード(たとえば、モーダルの場合は |
|
JavaScript |
|
ナビゲーション・メニュー(サイド)。 |
JavaScript |
|
ナビゲーション・メニュー(トップ)。 |
JavaScript |
|
トリガー要素(たとえば、現在のDOM要素)。 |
親トピック: ページ・テンプレート属性
ダイアログ・ページ・テンプレートを作成するには、表12-12に示すページ・テンプレート属性を定義する必要があります。
表12-12 ダイアログ・ページ・テンプレートの必須属性
| 属性 | 説明 |
|---|---|
名前、テンプレート・タイプ |
「ダイアログ・ページ」として定義する必要があります。 |
JavaScript、ダイアログ初期化コード |
ダイアログとしてページを初期化するJavaScriptコードを入力します。ファンクション・コール構文は、フィールドレベル・ヘルプを参照してください。 |
JavaScript、ダイアログ・クロージャ・コード |
ダイアログ・ページを閉じるJavaScriptコードを入力します。ファンクション・コール構文は、フィールドレベル・ヘルプを参照してください。 |
JavaScript、ダイアログ取消コード |
ダイアログ・ページを取り消すJavaScriptコードを入力します。ファンクション・コール構文は、フィールドレベル・ヘルプを参照してください。 |
ダイアログ、幅 |
ダイアログのデフォルトの幅を設定します。ページ・テンプレート・レベルの設定は、ページ・レベルで上書きできます。 |
ダイアログ、高さ |
ダイアログのデフォルトの高さを設定します。ページ・テンプレート・レベルの設定は、ページ・レベルで上書きできます。 |
ダイアログ、最大幅 |
ダイアログの最大幅をピクセル単位で設定します。ページ・テンプレート・レベルの設定は、ページ・レベルで上書きできます。 |
ダイアログ、CSSクラス |
ダイアログに適用する追加のCSSクラスを入力します。ページ・テンプレート・レベルの設定は、ページ・レベルで上書きできます。 |
ダイアログ、フレームへの埋込みを許可 |
この属性を使用してブラウザでアプリケーションのページをフレーム内に表示できるかどうかを制御するページ・モードを選択します。Application Expressは、iframeにモーダル・ダイアログを埋め込みます。アプリケーション・セキュリティ属性ブラウザ・フレームを「拒否」に設定する場合、「モーダル・ダイアログ」の「フレームへの埋込みを許可」を選択すると、かわりにこのテンプレートを使用するダイアログ・ページの「同じ起点から許可」が使用されます。 |
関連項目:
親トピック: ページ・テンプレート
ポップアップLOVテンプレートは、POPUPとして定義したすべてのアイテムに対するポップアップ・リストの表示方法を制御します。ポップアップLOVテンプレートは、各テーマに1つのみ指定できます。
関連項目:
この項では、ポップアップLOVテンプレートの編集ページの一部のセクションについて説明します。属性の詳細は、フィールドレベル・ヘルプを参照してください。
これらの属性を使用して、「検索」フィールドの表示方法を指定します。表 12-13に、使用可能な検索フィールドの属性を示します。
表 12-13 検索フィールドの属性
| 属性 | 説明 |
|---|---|
フィールド・テキストの前 |
ポップアップLOVの検索フィールドを表示する前に表示するテキストを定義します。 |
フィールド・テキストの後 |
検索フィールド、検索ボタンおよび閉じるボタンを表示した後にこのテキストを表示します。 |
フィルタ幅 |
この幅を使用して、 |
フィルタ最大幅 |
この最大幅を使用して、 |
フィルタ・テキスト属性 |
これらの属性を使用して、 |
親トピック: ポップアップLOVテンプレート属性
JavaScriptを使用してポップアップLOVが実行されます。これらの属性を使用して、scrollbars=、resizable=、width=およびheight=の値を制御します。
親トピック: ポップアップLOVテンプレート属性
関連項目:
リージョン・テンプレートは、リージョン属性の外観と配置を制御します。#BODY#や#EDIT#などの置換文字列を使用してリージョン属性を配置します。テンプレートの置換文字列は、大文字で指定し、シャープ記号(#)で囲む必要があります。
関連項目:
この項では、リージョン・テンプレートの編集ページの一部の属性について説明します。特定の属性の詳細は、フィールドレベル・ヘルプを参照してください。
「テーマ」は、テンプレートが関連付けられているテーマを示します。「名前」は、テンプレートの名前を示します。
「テンプレート・クラス」は、そのテンプレートに固有の用途を示します。新しいテーマに切り替えると、あるテーマのすべてのテンプレートは、別のテーマの対応するテンプレートにマップされます。アプリケーション・ビルダーは、テンプレート・クラスの割当てによってこのテンプレート・マッピングを行います。テンプレートに翻訳が必要なテキスト文字列が含まれていることを示すには、「翻訳可能」チェック・ボックスを使用します。
親トピック: リージョン・テンプレート属性
リージョン・テンプレートにより、リージョンと呼ばれるページ部分の外観が決まります。置換文字列を使用して、リージョン内のコンポーネントの存在と配置を指定します。必要な置換文字列は#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#
関連項目:
親トピック: リージョン・テンプレート属性
ページ・アイテムは、リージョン内で表示されます。ページ・テンプレートのレイアウトが「表」に設定されている場合、各アイテムはHTML表に含まれます。この属性を使用して、この表の属性を設定します。
親トピック: リージョン・テンプレート属性
「ヘッダー・テンプレート」および「ヘッダー・エントリ・テンプレート」を使用して、現在のリージョンにおけるすべてのサブリージョンのリージョン・タイトルのリストを生成します。どちらのテンプレートでも、必要な置換文字列は#ENTRIES#のみです。
「テンプレート」を使用して、サブリージョンを追加のHTMLコードでラップします。必要な置換文字列は#SUB_REGION#のみです。この置換文字列は、サブリージョンのソースの配置場所を示します。他のすべての置換文字列はオプションです。
親トピック: リージョン・テンプレート属性
レポート列テンプレートによって、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>
置換文字列#TOP_PAGINATION#を含めることによって、レポートの上部にページ区切りを含めることができます。この置換文字列は、開始タグ<tr>で始まり、閉じタグ</tr>で終わるHTMLを生成します。たとえば、表の開始タグと#TOP_PAGINATION#置換文字列を含めるには、次のように入力します。
<table>#TOP_PAGINATION#
また、置換文字列 #CSV_LINK#を使用すると、ほぼすべてのスプレッドシート・プログラムと互換性があるカンマ区切り値(CSV)形式にレポートをエクスポートできるようになります。
また、置換文字列#REPORT_ATTRIBUTES#を使用することもできます。この置換文字列は、レポート属性ページのレポート・リージョンごとに設定されます。
親トピック: 汎用列テンプレートのレポート列テンプレート属性
「列ヘッダーの前」を使用して、レポート・ヘッダーの前にテキストを表示します。
「列ヘッダー・テンプレート」を使用して、各列ヘッダーのセルをカラーにします。この属性のテキストには、セルのヘッダー・テキストをカラーにする位置を示すヘルプを含める必要があります。次に例を示します。
<th >Item Help Text</th>
列ヘッダーを使用しない場合は、次のように入力します。
OMIT
この属性を使用しない場合は、Application Expressエンジンによって、デフォルトの列ヘッダー・テンプレートが適用されます。
「列ヘッダーの後」を使用して、レポート・ヘッダーの後にテキストを表示します。
親トピック: 汎用列テンプレートのレポート列テンプレート属性
「各行の前」では、レポートのすべての列の前に表示するテキストを入力します。この属性は、新しいHTML行を開始するために使用します。「各行の前」では、次の置換文字列をサポートします。
#ROWNUM#
この置換文字列は、現行の行を指定するために使用します。
#COLCOUNT#
この置換文字列は、列の数を指定するために使用します。
#HIGHLIGHT_ROW#
この置換文字列は、ハイライトされた行の数を指定するために使用します。
親トピック: 汎用列テンプレートのレポート列テンプレート属性
列テンプレートは、各列の外観を定義します。最大4つの列テンプレートを定義できます。各テンプレートは、条件付きにできます。たとえば、偶数行と奇数行に異なる背景色を指定したり、PL/SQLで定義した条件に一致する行をハイライトできます。
各列テンプレートでは、各列の外観を定義します。表12-14に、列テンプレートでサポートされる置換文字列を示します。
表 12-14 列テンプレートの置換文字列
| 置換文字列 | 説明 |
|---|---|
|
列の位置合せを指定します。ユーザーが指定します。 |
|
列数のカウントを定義します。 |
|
現在の列番号を定義します。 |
|
列ヘッダーを定義します。 |
|
列の値に置換されます。 |
|
現在の行番号を指定します。 |
次に例を示します。
<td> #ALIGNMENT#>#COLUMN_VALUE#</td>
実際にこのレポートを実行すると、これらの置換文字列は、SQL問合せの結果によって生成された値に置換されます。
条件を作成すると、指定した条件に一致するかどうかによって列の表示が異なるレポートを作成できます。条件付きで使用される列テンプレートを指定するには、列テンプレートの条件リストから条件タイプを選択します。有効な値は、次のとおりです。
PL/SQL式に基づく使用: その行のデータに基づき、条件付きで列を書式化します。
偶数行で使用:偶数行を条件付きで書式化します。
奇数行で使用:奇数行を条件付きで書式化します。
「PL/SQL式に基づく使用」を選択する場合は、次に列テンプレートの式フィールドでPL/SQL式を入力します。たとえば、次の式で値が2000より大きい場合、その値を太字で表示します。
#SAL# > 2000
置換文字列#ROWNUM#を使用することもできます。次に例を示します。
#ROWNUM# > 2000
親トピック: 汎用列テンプレートのレポート列テンプレート属性
「各行の後」には、レポートを表示する際にすべての列の後に表示するHTMLを入力します。多くの場合、この属性は、HTML表の行を閉じるために使用されます。次に例を示します。
</tr>
親トピック: 汎用列テンプレートのレポート列テンプレート属性
「行の後」を使用して、最後の行の後に表示するテキストを指定します。HTML表のタグは、一般的に、この属性を使用して閉じます。次に例を示します。
</table>
「行の後」属性は、次の置換文字列をサポートします。
#PAGINATION#
ページ区切り属性で置換されます。
#COLCOUNT#
実行時に、レポートで定義された列数に置換されます。
#CSV_LINK#
CSVのエクスポートが有効な場合に、CSVダウンロード・リンクに実行時に置換されます。それ以外の場合、文字列は表示されません。
#EXTERNAL_LINK#
実行時に、外部処理エンジン(PDFエクスポートなど)を使用するエクスポートのダウンロード・リンクに置換されます。この機能が有効でない場合、文字列は表示されません。
親トピック: 汎用列テンプレートのレポート列テンプレート属性
「チェックした行のバックグラウンド・カラー」では、行セレクタが選択されている場合のレポート行の背景色が制御されます。「カレント行のバックグラウンド・カラー」では、ユーザーがその行の上にマウスを移動した場合のレポート行の背景色を制御します。
親トピック: 汎用列テンプレートのレポート列テンプレート属性
「ページ区切りのサブテンプレート」セクションには、「ページ区切りテンプレート」、「次のページ・テンプレート」、「前のページ・テンプレート」、「次のセット・テンプレート」および「前のセット・テンプレート」を編集する属性が含まれています。ページ区切りのサブテンプレートは、置換文字列#PAGINATION_NEXT#、#PAGINATION_NEXT_SET#、#PAGINATION_PREVIOUS#および#PAGINATION_PREVIOUS_SET#をサポートしています。表12-17に、これらのテンプレートについて示します。
表 12-15 ページ区切りのサブテンプレート属性
| ページ区切りサブテンプレート属性 | 説明 |
|---|---|
ページ区切りサブテンプレート全体に適用します。次に例を示します。 <span class="instructiontext">#TEXT#</span> 置換文字列 個々のアイテムを変更するには、その他のページ区切りサブテンプレート属性を使用します。 |
|
ページ区切りサブテンプレートの「次のページ」部分を表示する方法を変更する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つの行テンプレートを定義できます。各テンプレートは、条件付きにできます。
各行テンプレートでは、各行の外観を定義します。表12-16に、行テンプレートでサポートされる置換文字列を示します。
表 12-16 行テンプレートの置換文字列
| 置換文字列 | 説明 |
|---|---|
|
行の位置合せを指定します。ユーザーが指定します。 |
|
列数のカウントを定義します。 |
|
現在の列番号を定義します。 |
|
列ヘッダーを定義します。 |
|
列の値に置換されます。 |
|
現在の行番号を指定します。 |
条件を作成すると、指定した条件に一致するかどうかによって行の表示が異なるレポートを作成できます。条件付きで使用される行テンプレートを指定するには、列テンプレートの条件リストから条件タイプを選択します。有効な値は、次のとおりです。
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#をサポートしています。表12-17に、これらのテンプレートについて示します。
表 12-17 ページ区切りのサブテンプレート属性
| ページ区切りサブテンプレート属性 | 説明 |
|---|---|
ページ区切りサブテンプレート全体に適用します。次に例を示します。 <span class="instructiontext">#TEXT#</span> 置換文字列 個々のアイテムを変更するには、その他のページ区切りサブテンプレート属性を使用します。 |
|
ページ区切りサブテンプレートの「次のページ」部分を表示する方法を変更する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を使用すると、データベース内の値に応じて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>" );
関連項目:
親トピック: レポート・テンプレート
