| Oracle® Application Expressアプリケーション・ビルダー・ユーザーズ・ガイド リリース5.1 E83810-03 |
|
 前 |
 次 |
アプリケーション属性はアプリケーション全体の動作を制御するものであり、定義、セキュリティ、グローバリゼーション、ユーザー・インタフェースのカテゴリに分類されます。
トピック:
関連項目:
カスタム・パッケージ・アプリケーションの作成方法(サポートするオブジェクト・ユーティリティを使用したパッケージ・アプリケーションの作成方法の詳細)
「アプリケーション定義の編集」ページでアプリケーション属性を編集すると、アプリケーション名の変更、様々なアプリケーション・プロパティおよび動作の変更、アプリケーションの可用性の制御、エラー処理の構成、置換文字列の定義などを行えます。
アプリケーション定義の編集ページにアクセスするには、次のステップを実行します。
「アプリケーション定義の編集」ページが表示されます。
アプリケーション定義の編集ページは、次のリージョンに分かれています。
注意:
必須の値には赤いアスタリスク(*)が付いています。
「名前」属性を使用して、アプリケーションの基本的な特性(アプリケーション名、英数字の別名(オプション)、バージョン番号など)を定義します。表6-3に、「名前」のすべての属性を示します。
表6-3「アプリケーション定義」の「名前」
| 属性 | 説明 |
|---|---|
アプリケーションの説明的な短い名前。この名前によって、アプリケーションを開発環境に存在する他のアプリケーションと区別します。 |
|
代替の英数字アプリケーション識別子を割り当てます。アプリケーションIDに、この識別子を使用できます。 たとえば、アプリケーション105に
関連項目: f?p構文を使用したページのリンクについて |
|
アプリケーションのバージョン番号を入力します。入力した値がページに表示されます。次に示す書式マスクを使用して、自動的にバージョンを最終更新日に結び付けることもできます。
アプリケーションのバージョンで「YYYY.MM.DD」を使用している場合、アプリケーション・ビルダーは、この書式マスクをすべてのアプリケーション属性の最終更新日に置換します。 |
|
このアプリケーションに現在関連付けられているアプリケーション・グループを表示します。別のアプリケーション・グループを選択するには、リストから選択します。既存のグループからアプリケーションを削除するには、「未割当て」を選択します。 関連項目: アプリケーション・グループの管理 |
「プロパティ」セクションを使用して、ロギング、デバッグ動作、フィードバック、互換性、電子メール送信者アドレスおよびアプリケーション・プロキシ・サーバーを構成します。表6-4に、「名前」のすべての属性を示します。
表6-4「アプリケーション定義」の「プロパティ」
| 属性 | 説明 |
|---|---|
ユーザー・アクティビティをOracle Application Expressアクティビティ・ログに記録するかどうかを決定します。「はい」を選択すると、すべてのページ・ビューがログに記録されるため、管理者はアプリケーションごとにユーザー・アクティビティを監視できます。 高容量アプリケーションでは、ロギングを無効にすることをお薦めします。 この属性は、Oracle Application Express管理サービスの「アプリケーション・アクティビティのロギング」属性が「アプリケーションの設定を使用(デフォルト)」に設定されている場合のみ変更できます。 関連項目: 『Oracle Application Express管理ガイド』のロギングのアプリケーション・アクティビティの有効化に関する説明。 |
|
カレント・アプリケーションのデバッグ・モードを制御します。使用可能なオプションは次のとおりです。
デバッグ・モードでのアプリケーションの実行は、アプリケーションが開発中の場合に役立ちます。本番アプリケーションの場合は、デバッグを無効にし、ユーザーがアプリケーション・ロジックを参照できないようにすることをお薦めします。 このデバッグ設定に関係なく、プログラム的にデバッグを有効にできます。アプリケーションがApplication Express開発環境から実行される場合、デバッグは常に有効化できます。 |
|
このアプリケーションに対するエンド・ユーザーのフィードバックへのサポートを有効にします。「はい」または「いいえ」を選択します。 このオプションを有効にする場合は、フィードバック・ページと、そのページをコールするナビゲーション・バー・アイコンを作成する必要があります。フィードバックを後で無効にすると、ナビゲーション・バー・アイコンは非表示になります。 関連項目: フィードバックの管理 |
|
Application Expressランタイム・エンジンの互換性モードを制御します。一部のランタイム動作はリリースのたびに変更されます。この属性を使用して、特定のアプリケーション動作を取得します。アプリケーションで新しい動作を認識するには、アプリケーションの互換性モードを最新バージョンに設定します。 |
|
アプリケーションで送信元アドレスとして使用する電子メール・アドレスを決定します。 電子メール・ダウンロードまたはサブスクリプションから電子メールを送信するときに送信元アドレスとしてい使用する有効な電子メール・アドレスを入力します。値には、有効な電子メールを含むリテラル文字列、または置換構文 john.doe@abc.com &MY_APP_EMAIL_FROM. アイテムの置換は、電子メール・ダウンロードでのみ機能し、サブスクリプションでは機能しないため、アプリケーションまたはページレベルでのアイテムの置換の使用はお薦めしません。 「対話モード・レポートの属性」ページで送信元アドレスを指定することもできます。コンポーネント・ビューでのクラシック・レポート属性の編集を参照してください。 |
|
プロキシ・サーバーを指定します。 たとえば、URLリージョン・ソース・タイプを使用する場合、プロキシ・サーバーが必要になる場合があります。URLリージョン・ソースは、URLの結果(URLにナビゲートすると戻されるページ)をリージョン・ソースとして埋め込みます。ファイアウォールを使用している場合に、URLがアプリケーション・ビルダーに対してファイアウォールの外側にある場合は、プロキシ・サーバーを指定する必要があります。 PL/SQLパッケージ変数 |
可用性属性を使用して、アプリケーションのステータスとビルド・ステータスを定義し、アプリケーションを管理します。たとえば、ステータス「制限されたアクセス」を選択すると、アプリケーションにアクセスして実行できるユーザーを指定できます。詳細は、表6-5を参照してください。
表6-5「アプリケーション定義」の「可用性」
| 属性 | 説明 |
|---|---|
アプリケーションが使用可能または使用不可であることを指定します。オプションは次のとおりです。
関連項目:
|
|
カレント・アプリケーションのビルド・ステータスを指定します。オプションは次のとおりです。
関連項目: Oracle Application Express管理ガイドの「デプロイ時のアプリケーションのビルド・ステータス・セットの変更」 |
|
この属性は、「ステータス」とともに使用します。「ステータス」を「使用不可」、「使用不可(PL/SQLで表示されるステータス)」または「使用不可(URLにリダイレクト)」に設定すると、この属性に入力したテキストが表示されます。「ステータス」を「使用可能」に設定した場合、この属性に入力したテキストは表示されません。 |
|
この属性はステータス「制限されたアクセス」とともに使用します。「ステータス」を「制限されたアクセス」に設定すると、この属性に示されているユーザーのみがアプリケーションを実行できます。 この属性を使用するには、次のステップを実行します。
|
表6-6に示す「エラー処理」属性を使用して、アプリケーションがエラーのログを記録する方法を制御または変更します。
ヒント:
ここで指定するエラー処理ファンクションは、同様のページ・レベル属性によって上書きされます。
表6-6 「アプリケーション定義」の「エラー処理」
| 属性 | 説明 |
|---|---|
Application Expressまたはプラグインによって実行される基本検証の検証エラー・メッセージを表示する位置を指定します。検証エラー・メッセージは、通知領域(ページ・テンプレートの一部として定義)またはフィールド・ラベル内に表示できます。オプションは次のとおりです。
|
|
既存のエラー・メッセージを変更し、よりわかりやすいメッセージを表示するか、エラーが発生した場合にそれをログに記録するためにコールするPL/SQLエラー・ファンクションの名前を入力します。このファンクションは、データベース内のパッケージ・ファンクションまたはスタンドアロンのファンクションを参照できます。次に例を示します。 log_apex_error データベースのPL/SQLパッケージまたはスタンドアロンのファンクションを参照する場合、 #OWNER#.log_apex_error
function <name of function> (
p_error in apex_error.t_error )
return apex_error.t_error_result
関連項目: 『Oracle Application Express APIリファレンス』の 注意: ここで指定するエラー処理ファンクションは、ページ・レベルで指定されるエラー処理により上書きされます。 |
「グローバル通知」属性を使用して、アプリケーション・ユーザーにシステム・ステータスを通知します。たとえば、この属性を使用して、スケジュールされた停止時間をユーザーに通知したり、アプリケーションの可用性に関するその他のメッセージを通知できます。アプリケーションで使用されるページ・テンプレートに#GLOBAL_NOTIFICATION#置換文字列が含まれている場合は、ここに入力するテキストがその文字列の場所に表示されます。
グローバル通知を作成するには、次のステップを実行します。
ページ・テンプレートに#GLOBAL_NOTIFICATION#置換文字列を含めます。
アプリケーション定義の編集ページにナビゲートし、「グローバル通知」属性にメッセージを入力します。
「変更の適用」をクリックします。
関連項目:
「置換」セクションを使用して、アプリケーションで使用する静的置換文字列を定義します。アプリケーション内の多くの場所に出現する文字列やラベルに静的置換文字列を使用できます。置換文字列を作成するには、「置換文字列」列に文字列名を、「置換値」列に文字列値を入力します。
静的置換文字列を定義すると、このページで定義した「置換値」を変更するだけで、アプリケーション内の複数の場所のテキスト文字列をまとめて変更できます。
関連項目:
「ビルド・オプション」セクションには、既存のビルド・オプションが表示されます。ほとんどのアプリケーションには、ビルド・オプション属性があります。ビルド・オプションは、INCLUDEまたはEXCLUDEという2つの値をとることができます。属性を含めるように指定すると、Application Expressエンジンは、実行時にその属性を考慮します。ただし、属性を除外するように指定すると、Application Expressエンジンは、その属性を存在しないものとして処理します。
オブジェクトを特定のインストールから除外する場合を除き、ビルド・オプションは指定しないでください。
関連項目:
「セキュリティ属性の編集」ページを使用して、アプリケーション内のすべてのページのセキュリティを構成します。セキュリティ属性は、認証、認可、セッション管理、セッション・ステート保護、ブラウザ・セキュリティ、データベース・セッションのカテゴリに分類されます。
セキュリティ属性の編集ページにアクセスするには、次のステップを実行します。
ヒント:
「アプリケーション定義の編集」にナビゲートして「セキュリティ」タブをクリックしても、「セキュリティ属性の編集」にアクセスできます。アプリケーション定義の編集ページへのアクセスを参照してください。
セキュリティ属性の編集ページは、次のセクションに分かれています。
注意:
必須の値には赤いアスタリスク(*)が付いています。
認証は、ユーザーがアプリケーションにアクセスする前に、そのユーザーの本人確認を行うプロセスです。アプリケーションに対して複数の認証スキームを定義できますが、一度にカレントに設定できるスキームは1つだけです。表6-7に、認証で使用可能な属性を示します。
表6-7 認証属性
| 属性 | 説明 |
|---|---|
データベース・アクセス記述子(DAD)を介したデータベースへの接続に使用するOracleスキーマ(またはユーザー)を示します。ユーザーの本人確認が行われると、Application Expressエンジンが組込み置換文字列
カレント・アプリケーション・ユーザー( たとえば、ユーザーがパブリック・ユーザーの場合はログイン・ボタンを表示し、ユーザーがパブリック・ユーザーでない場合にはログアウト・リンクを表示するように設定できます。この値を参照するには、 関連項目: HOME_LINKおよび条件付きのレンダリングおよびプロセスの理解 |
|
アプリケーションに定義されている認証スキームから選択します。認証スキームを作成するには、「認証スキームの定義」をクリックします。 |
アプリケーション認可スキームによって、アプリケーション内のすべてのページへのアクセスが制御されます。アプリケーションに不当にアクセスすると、リクエストしたページに関係なく、エラー・ページが表示されます。表6-8に、「認可」で使用可能な属性を示します。
表6-8 認可属性
| 属性 | 説明 |
|---|---|
アプリケーションの認可スキームを指定します。アプリケーションの認可スキームは、アクセス制御のためにアプリケーションに定義されます。ここで必要な認可スキームをアプリケーション・レベルで設定するには、アプリケーションのすべてのページが定義済の認可チェックに合格する必要があります。 |
|
「認可スキームの定義」をクリックして、認可スキームを作成します。 |
|
アプリケーション・レベルの認可スキームをパブリック・ページ(つまり、認可を必要としないページ)でチェックするかどうかを制御します。オプションは次のとおりです。
通常、認可はユーザー名に依存するため、アプリケーション・レベルの認可は、(「パブリック・ページで実行」にかかわらず)ログイン・ページでは評価されません。 |
関連項目:
「セッション・タイムアウト」属性を使用して、アプリケーションでWebブラウザが開いたまま放置されたコンピュータに対する公開を抑制します。表6-9に、「セッション・タイムアウト」で使用可能な属性を示します。
表6-9 「セッション管理」
| 属性 | 説明 |
|---|---|
この属性を使用して、Application ExpressがセッションIDを含まないアプリケーションURLをサポートするかどうかを制御します。「セッションを再結合」が有効で、URLにセッションIDが含まれていない場合、Application ExpressはセッションCookieを使用して既存のセッションを結合することを試みます。 このページ・レベルの値は、より制限的なインスタンス・レベルの設定によってオーバーライドされます。 注意: セッションの再結合を有効にすると、攻撃者が既存のエンド・ユーザー・セッションを乗っ取ることが可能になるため、アプリケーションのセキュリティが侵害される可能性があります。「セッションを再結合」についてを参照してください。 「セッションを再結合」のオプションは次のとおりです。
|
|
アプリケーションのディープ・リンクを有効または無効にします。オプションは次のとおりです。
たとえば、多くの場合、ブラウザは開いたタブのURLを保存し、再起動後にセッションをリストアしようとするため、ディープ・リンクが発生します。この動作は望ましくない場合があります(URLがマルチステップ・ウィザードの途中のページを指す場合など)。「無効化」を選択すると、Application Expressは新しいセッションを開始し、アプリケーションのホームページにリダイレクトします。 関連項目: セキュリティ(ページ・レベルでこの動作を上書きする場合の詳細) |
|
セッションが存続してこのアプリケーションで使用できる期間(秒単位)を定義します。
セッション存続期間より、8時間ごとに実行され、12時間より前から存在するセッションを削除するジョブの操作が優先される場合があります。 |
|
最大セッション存続期間を超えた際にリダイレクトされるオプションのURLを入力します。このURLのターゲット・ページは、Application Expressで実装された場合、パブリック・ページである必要があります。 このページの一般的な用途は、ユーザーにセッションの有効期間を知らせ、ログイン・リンクや他のオプションを表示することです。URLが入力されていない場合、ユーザーには、メッセージ「セッションがタイムアウトしました。」およびアプリケーションのホームページのリンクが表示されます。#LOGOUT_URL#を入力すると、Application Expressは、ユーザーがアプリケーションのログアウト・リンクをクリックした場合と同じようにログアウトを実行します。次の3つの置換アイテムのみがサポートされます。
このURLは特別な目的を持つため、リンクに |
|
セッション・アイドル時間は、最後のページ・リクエストと次のページ・リクエストの間の時間です。オプションは次のとおりです。
|
|
最大セッション・アイドル時間を超えた際にリダイレクトされるオプションのURLを入力します。このURLのターゲット・ページは、Application Expressで実装された場合、パブリック・ページである必要があります。このページの一般的な用途は、ユーザーにセッションの有効期間を知らせ、ログイン・リンクや他のオプションを表示することです。URLが入力されていない場合、ユーザーには、メッセージ「セッションがタイムアウトしました。」およびアプリケーションのホームページのリンクが表示されます。 このURLでは次の3つの置換アイテムのみがサポートされます:
このURLは特別な目的を持つため、リンクに |
関連項目:
セッション・タイムアウトの使用についておよびOracle Application Express管理ガイドの「セッション・タイムアウトの構成」
セッション・ステート保護を有効にすると、ハッカーがアプリケーション内のURLを改ざんするのを防ぐことができます。URL改ざんにより、プログラム・ロジック、セッション・ステートの内容および情報プライバシが悪影響を受ける可能性があります。表6-10に、「セッション・ステート保護」で使用可能な属性を示します。
表6-10 「セッション・ステート保護」
| 属性 | 説明 |
|---|---|
「セッション・ステート保護」リストから選択して、アプリケーションのセッション・ステート保護を有効化または無効化します。「有効」を選択すると、ページおよびアイテム・レベルで定義されたセッション・ステート保護コントロールがオンになります。詳細は、フィールドレベル・ヘルプを参照してください。 |
|
ブックマーク済リンクにチェックサムが含まれ、セッション・ステート保護がアプリケーションに対して有効な場合、ブックマーク済リンクをこのアプリケーションのページへのアクセスに使用できるようになった日時がリストされます。 この日付および時間より前に作成されたブックマークは、ブックマーク済リンクにチェックサムが含まれ、セッション・ステート保護がアプリケーションに対して有効な場合、このアプリケーションへのアクセスに使用できません。チェックサムを含まないブックマークまたは不要なチェックサムを含むブックマークは、この属性による影響を受けません。これらの有用性は、他の基準を使用して決定されます。非表示のアプリケーション属性(チェックサム・ソルト)は、計算時と、ページのレンダリング時に生成されたf?p= URLに含まれるチェックサムのその後の検証時に使用されます。チェックサムは、「セッション・ステート保護」がアプリケーションに対して有効な場合に含まれます。このチェックサム・ソルト属性は、「ブックマークの無効化」ボタンをクリックすると、いつでもリセットできます。 |
|
ブックマーク可能なURLの、アプリケーション・レベルおよびユーザー・レベルのチェックサムを作成するために使用されます。 |
|
「ブックマークの無効化」をクリックすると、この非表示のアプリケーション属性(チェックサム・ソルト)のソルト属性をいつでもリセットできます。このボタンをクリックすると、以前に生成されたチェックサムを含むブックマーク済URLは、その後にアプリケーションへのアクセスに使用されるときに失敗します。 ヒント: 「ブックマークの無効化」をクリックして、ブックマーク・ハッシュ関数を変更し、チェックサムを計算する別のアルゴリズムに切り替えることもできます。 |
|
「セッション・ステート保護の管理」をクリックして、セッション・ステート保護を構成します。 |
関連項目:
表6-11に、「ブラウザ・セキュリティ」で使用可能な属性を示します。
表6-11 「ブラウザ・セキュリティ」
| 属性 | 説明 |
|---|---|
「キャッシュ」を使用して、アプリケーションのページ・コンテンツのブラウザによるキャッシュを有効化または無効化します。有効化すると、ブラウザはこのアプリケーションのページ・コンテンツを、メモリー内とディスク上の両方のキャッシュに保存します。キャッシュが有効になっている場合に、ブラウザの「戻る」ボタンがクリックされると、通常、ページはサーバーからではなくキャッシュからロードされます。無効にすると、ブラウザはアプリケーションのページ・コンテンツを保存しないように指示され、URLが変更されるたびにサーバーから最新のページ・コンテンツをリクエストします。 機密データが保存されないようにするために、この属性を無効にすることをお薦めします。そうしない場合、ログアウト後にブラウザ履歴で前に戻り、以前のセッションのキャッシュされたコンテンツを表示できる可能性があります。ブラウザのキャッシュを無効にすると、部分ページ・リフレッシュを使用するページ(対話モード・レポートを含むページなど)での問題も回避できます。 この属性が「無効」に設定されている場合、ページ・コンテンツをディスク上またはメモリー内にキャッシュしないようにブラウザに指示するHTTPヘッダー |
|
ブラウザのフレーム内にアプリケーションのページを表示するかどうかを制御します。使用可能なオプションは次のとおりです。
フレーム内のページの表示は、クリックジャック攻撃で不正に使用される場合があります。クリックジャック攻撃では、攻撃者は複数のレイヤーを使用して、ユーザーがトップ・レベル・ページをクリックしようとしたときに、別のページ上のボタンやリンクをクリックさせます。したがって、意図したページに対するクリック(またはキーストローク)が攻撃者によりハイジャックされ、別のページに移動させられます。 詳細は、フィールドレベル・ヘルプを参照してください。 |
|
Oracle Application Expressで特殊文字をエスケープする方法を定義します。オプションは次のとおりです。
|
|
Oracle Application Expressが各レスポンスで送信する必要があり、別の方法(たとえば、「フレームへの埋込み」属性を使用した 次に例を示します。 |
ヒント:
「キャッシュ」および「フレームへの埋込み」のいずれにも、HTTPヘッダー・レスポンス変数X-Frame-Optionsをサポートする最新のブラウザが必要です。
表6-12に、「データベース・セッション」で使用可能な属性を示します。
表6-12 「データベース・セッション」
| 属性 | 説明 |
|---|---|
アプリケーション内のすべてのSQLおよびPL/SQLが解析対象となるスキーマを指定します。#OWNER#を使用すると、SQL問合せおよびPL/SQL (リージョンやプロセスなど)でこの値を参照できます。 |
|
この属性を使用して、現在の「ページの表示」または「ページの受入れ」リクエストに関連付けられたデータベース・セッションに対してコンテキストを設定するPL/SQLブロックを入力します。ここに入力したブロックは、ページ・リクエスト時の非常に早い段階( |
|
この属性を使用して、ページ・プロセスの最後に実行するPL/SQLブロックを入力します。これは、VPDコンテキストまたはデータベース・リンクなど、使用されたリソースの解放またはクリーンアップに使用できます。例を表示するには、フィールドレベル・ヘルプを参照してください。 |
|
このアプリケーションによる、アプリケーションとワークスペース・データを変更するOracle Application Express APIへの実行中のアクセス方法を制御します。オプションは次のとおりです。
|
関連項目:
認可を介したセキュリティの提供およびOracle Label Security管理者ガイド
「グローバリゼーション属性の編集」で属性を編集して、アプリケーションのグローバリゼーション・オプションを構成します。アプリケーション・ビルダーでは、異なる言語で同時に実行可能なアプリケーションを開発できます。
1つのアプリケーションを、異なる言語をサポートするよう変換できます。「グローバリゼーション属性の編集」ページの属性を使用して、アプリケーションのプライマリ言語や、日付書式、時間書式、タイムスタンプ書式、タイムゾーン書式およびCSVエンコーディングのデフォルトなどのグローバリゼーション・オプションを指定します。
グローバリゼーション属性の編集ページにアクセスするには、次のステップを実行します。
ヒント:
「アプリケーション定義の編集」にナビゲートして「グローバリゼーション」タブをクリックしても、グローバリゼーション属性の編集ページにアクセスできます。アプリケーション定義の編集ページへのアクセスを参照してください。
次の項では、グローバリゼーション属性の編集ページで使用可能な属性について説明します。
注意:
必須の値には赤いアスタリスク(*)が付いています。
トピック:
関連項目:
アプリケーションを開発する言語を指定します。この言語が、すべての変換の元となるベース言語になります。たとえば、英語で作成されたアプリケーション100が、フランス語に変換され、アプリケーション101として公開されたとします。英語がアプリケーションのプライマリ言語になります。
アプリケーションに対するすべての変更は、ここで指定したプライマリ言語で行う必要があります。
翻訳されたアプリケーション言語がApplication Expressによって導出される方法を指定します。アプリケーションのプライマリ言語は静的にすることも、Webブラウザ言語から導出したり、ユーザー・プリファレンスやアイテムから特定することもできます。
使用可能なオプションの詳細は、フィールドレベル・ヘルプを参照してください。
アプリケーションで使用する日付書式を決定します。
この日付書式を使用すると、NLS_DATE_FORMATデータベース・セッションの設定が変更されてから、アプリケーション内のページが表示または送信されます。この値には、有効なOracle日付書式マスクを含むリテラル文字列、または置換構文を使用したアイテム参照を指定できます。値が指定されていない場合は、データベース・セッションからデフォルトの日付書式が実行時に取得されます。次の例を参考にしてください。
Month DD, YYYY &MY_DATE_FORMAT.
アプリケーションで使用する日時書式を指定します。
この日時書式は、置換参照&APP_DATE_TIME_FORMAT.を使用するか、PL/SQLでv('APP_DATE_TIME_FORMAT')ファンクションを使用して、アプリケーション内で参照できます。この属性によってNLS設定が変更されることはありません。この値には、有効なOracle日付書式マスクを含むリテラル文字列、または置換構文を使用したアイテム参照を指定できます。この属性値を指定しない場合、APP_DATE_TIME_FORMATへの参照はNLSデータベース・セッションの日付書式とNLS時刻書式を返します。次の例を参考にしてください。
Month DD, RRRR HH24:MI &MY_DATE_TIME_FORMAT.
アプリケーションで使用するタイムスタンプ書式を決定します。LOVからタイムスタンプ書式を選択します。
このタイムスタンプ書式を使用すると、NLS_TIMESTAMP_FORMATデータベース・セッションの設定が変更されてから、アプリケーション内のページが表示または送信されます。この値には、有効なOracleタイムスタンプ書式マスクを含むリテラル文字列、または置換構文を使用したアイテム参照を指定できます。値が指定されていない場合は、データベース・セッションからデフォルトのタイムスタンプ書式が実行時に取得されます。次の例を参考にしてください。
DD-MON-RR HH.MI.SSXFF AM &MY_TIMESTAMP_FORMAT.
アプリケーションで使用するタイムゾーン付きのタイムスタンプ書式を決定します。
この日付書式を使用すると、NLS_TIMESTAMP_TZ_FORMATデータベース・セッションの設定が変更されてから、アプリケーション内のページが表示または送信されます。この値には、有効なOracleタイムスタンプ書式マスクを含むリテラル文字列、または置換構文を使用したアイテム参照を指定できます。値が指定されていない場合は、データベース・セッションからデフォルトのタイムゾーン付きのタイムスタンプ書式が実行時に取得されます。次の例を参考にしてください。
DD-MON-RR HH.MI.SSXFF AM TZR &MY_TIMESTAMP_TZ_FORMAT.
ORDER BY、LIKE、MIN/MAXなど、様々なSQL操作およびSQL句で文字の値を比較する際の照合順序を決定します。
この値を使用すると、クラシック・レポートおよび対話モード・レポート・リージョンのSQL問合せの実行に対するNLS_SORTデータベース・セッション・パラメータが変更されます。値が指定されていない場合は、データベース・セッションからデフォルト値が実行時に取得されます。次の例を参考にしてください。
BINARY GERMAN CANADIAN_M
LIKE、MIN/MAXなど、SQL操作の照合動作を決定します。
この値を使用して、クラシック・レポート、対話モード・レポート、リスト・ビューの各リージョン、およびプラグインAPIのSQL問合せの実行のNLS_COMPデータベース・セッション・パラメータを変更します。オプションは次のとおりです。
データベース・セッションのNLS設定(デフォルト): NLS_COMP値は、実行時にデータベース・セッションから取得されます。
バイナリ: WHERE句および他のSQL操作での比較はバイナリです。
言語形式: WHERE句および他のSQL操作での比較は、「文字の値の比較」属性(NLS_SORT)で指定した言語ソートを使用します。
データベース・セッションのタイムゾーンの設定を制御します。「はい」に設定すると、クライアント・タイムゾーンがクライアントのWebブラウザから取得され、Application Expressセッションの継続時間用に設定されます。
その後のページ・ビューには、ページ・ビューごとに適切なデータベース・セッション・タイムゾーンが設定されます。設定後、この設定はAPEX_UTIL.SET_SESSION_TIME_ZONEを使用して上書きしたり、APEX_UTIL.RESET_SESSION_TIME_ZONEを使用して再設定することができます。
関連項目:
Oracle Application Express APIリファレンス
自動CSVエンコーディングは、アプリケーションのすべてのカンマ区切り(CSV)レポートの出力エンコーディングを制御します。自動CSVエンコーディングのデフォルト値は「はい」です。自動CSVエンコーディングを「はい」に設定した場合、CSVレポートの出力は、ローカライズされたデスクトップ・アプリケーションと互換性のあるキャラクタ・セットに変換されます。CSVエンコーディングのキャラクタ・セットは、「アプリケーション言語の導出元」の設定によって決まります。
アプリケーション・ビルダーのページのエンコーディングは、Oracle Application Expressへのアクセスに使用されるデータベース・アクセス記述子(DAD)のキャラクタ・セットによって決まります。たとえば、データベース・アクセス記述子のキャラクタ・セットがAL32UTF8である場合、Oracle Application Expressユーザー・インタフェースの全アプリケーションのすべてのページはUTF-8でエンコードされます。
デフォルトでは、レポート・リージョンからのCSV出力は、データベース・アクセス記述子と同じキャラクタ・セットでエンコードされます。ただし、一部のデスクトップ・スプレッドシート・アプリケーションでは、データがクライアント・デスクトップのオペレーティング・システムのキャラクタ・セットでエンコードされる必要があります。マルチバイト・データの場合、レポート・リージョンからのCSV出力をデスクトップのスプレッドシート・アプリケーションで開くと壊れて表示されることがよくあります。これは、レポート・リージョンからのCSV出力のエンコーディングが、デスクトップ・アプリケーションで必要とされるエンコーディングと異なるためです。自動CSVエンコーディングを有効にすると、この問題が解決します。
たとえば、アプリケーションに対するユーザーの言語プリファレンスがdeである場合、データベース・アクセス記述子のキャラクタ・セット設定にかかわらず、CSVデータは西ヨーロッパ語(Windows 1252)でエンコードされます。ユーザーの言語プリファレンスがzh-cnの場合、CSVデータは中国語(GBK)でエンコードされます。
「ユーザー・インタフェース」ページの属性を編集して、アプリケーションのデフォルト特性を決定し、ターゲット環境(デスクトップまたはモバイルなど)用の表示を最適化します。ユーザー・インタフェース・ページの一般的な属性とユーザー・インタフェースの詳細ページの特定の属性を編集することで、ユーザー・インタフェースをカスタマイズできます。
ユーザー・インタフェース属性にアクセスするには、次のステップを実行します。
ヒント:
「アプリケーション定義の編集」にナビゲートして「ユーザー・インタフェース」タブをクリックしても、「ユーザー・インタフェース」属性にアクセスできます。アプリケーション定義の編集ページへのアクセスを参照してください。
関連項目:
ユーザー・インタフェース・ページは、次のセクションに分かれています。
ヒント:
このページの属性の詳細は、フィールドレベル・ヘルプを参照してください。
「一般プロパティ」を使用して、アプリケーション・ユーザー・インタフェースの基本的な特性を定義します。表6-13に、「一般プロパティ」のすべての属性を示します。
表6-13 「ユーザー・インタフェース」の「一般プロパティ」
| 属性 | 説明 |
|---|---|
データベースのアプリケーション定義とともに格納されたファイルを参照するものを指定しないでください。 パフォーマンス上の理由から、アプリケーション・ファイルをWebサーバーに格納することもできます。任意の有効なURLを使用してそれらを参照します。 次に例を示します。
|
|
アプリケーション・ビルダーによって分散されたイメージ・ディレクトリを指すためにWebサーバーが使用する仮想パスを決定します。インストール時、仮想パスは 静的テキスト(ページ、リージョン・ヘッダー、リージョン・フッターなど)にイメージを埋め込む場合は、置換文字列 <img src="#IMAGE_PREFIX#go.gif">
注意: 入力されたイメージ接頭辞がインスタンス・イメージ接頭辞と同じである場合、アプリケーション・レベル属性は常にnullになります。これにより、異なるイメージ接頭辞を持つ可能性のある様々なインスタンス間で、アプリケーションを簡単に移動できます。 関連項目: IMAGE_PREFIX |
|
インターネット・メディア・タイプを入力します。インターネット・メディア・タイプは、2つの部分で構成される、インターネット上のファイル形式を表す識別子です。メディア・タイプは、少なくともタイプとサブタイプの2つの部分で構成され、オプションで1つ以上のパラメータを指定します。メディア・タイプは、ページ描画の際にHTTPヘッダーのContent-Typeで使用されます。 ページ・レベルのメディア・タイプが、アプリケーション・レベルのメディア・タイプを上書きします。この属性のデフォルト値は |
「ロゴ」属性は、アプリケーション・ロゴを定義する際に使用します。アプリケーション・ロゴは、テキスト・ベースにもイメージ・ベースにもできます。この機能を使用するには、ページ・テンプレートに#LOGO#置換文字列が含まれている必要があります。
関連項目:
この属性にファビコンHTMLコードを入力して、ファビコン(またはショートカット・アイコン)を作成します。この機能を使用するには、ページ・テンプレートに#FAVICONS#置換文字列が含まれている必要があります。次に例を示します。
<link rel="shortcut icon" href="/i51/favicon.ico"> <link rel="icon" sizes="16x16" href="/i51/favicon-16x16.png"> <link rel="icon" sizes="32x32" href="/i51/favicon-32x32.png"> <link rel="apple-touch-icon" sizes="180x180" href="/i51/favicon-180x180.png">
自動検出が失敗した際に、Application Expressが使用可能なユーザー・インタフェースを表示するためにロードする必要のあるスタイルシートのCSSファイルURLを入力します。各URLを新しい行に記述する必要があります。ファイルの縮小バージョンを指定する場合、置換文字列#MIN#を使用して.min ,を、または#MIN_DIRECTORY#を使用して minified/を通常ページ・ビューのファイルURLに含めたり、ページをデバッグ・モードで表示する場合は空の文字列を含めることができます。アプリケーションのバージョンをファイルURLに含める場合、置換文字列#APP_VERSION#にアクセスすることもできます。
例を表示するには、フィールドレベル・ヘルプを参照してください。
アプリケーション・ロゴを定義するには、次のステップを実行します。
ユーザー・インタフェース・ページにアクセスします。
次に、ロゴ属性を指定します。
ロゴがイメージの場合:
ロゴ・タイプ - 「イメージ」を選択します。
ロゴ - ファイル名の拡張子(たとえば、/i/oracle.gif)または完全修飾されたURL (イメージを参照している場合)を含む完全なイメージ名を入力します。
ロゴ属性 - ロゴの適切な属性を入力するか、リストから選択します。
ロゴがテキストの場合:
「ロゴ・タイプ」で、「テキスト」を選択します。
ロゴ - 次のような、完全なテキスト文字列を入力します。
サンプル・アプリケーション
ロゴ属性 - ロゴの適切な属性を入力するか、リストから選択します。
「変更の適用」をクリックします。
ヒント:
置換文字列を使用して、静的ファイル・リポジトリにアップロードされたイメージを参照することもできます。詳細は、「静的アプリケーション・ファイルの参照」および「静的ワークスペース・ファイルの参照について」を参照してください。
ユーザー・インタフェースの詳細ページは、次のセクションに分かれています。
表6-15 「ユーザー・インタフェースの詳細」の「属性」
| 属性 | 説明 |
|---|---|
ユーザー・インタフェースを自動的に検出する必要があるかどうかを選択します。自動検出を有効にすると、ユーザーは対応するログイン・ページまたはホームページにリダイレクトされます。 |
|
ユーザー・インタフェースを、アプリケーションのデフォルトのインタフェースにするかどうかを選択します。 |
|
「はい」に設定すると、エンド・ユーザーは、カスタマイズ・ダイアログ内でセッションのテーマ・スタイルを選択できます。「パブリック」とマークされたテーマ・スタイルのみを選択できます。 関連項目: ユーザーによるテーマ・スタイルの選択の可能化 |
|
現在のユーザー・インタフェースに対するアプリケーションのホームページを指定します。 |
|
現在のユーザー・インタフェースに対するアプリケーションのログイン・ページを指定します。 |
|
現在ユーザー・インタフェースに関連付けられているテーマを表示します。 関連項目: テーマの切替え |
|
テーマ・スタイルを選択します。このオプションは、テーマ・スタイルをサポートする新しいテーマに対してのみ表示されます。 関連項目: テーマ・スタイルの使用 |
|
定義されている場合、アプリケーションのグローバル・ページが表示されます。 |
「ナビゲーション・メニュー」属性は、新しいテーマとともにのみ表示されます。
表6-16 「ユーザー・インタフェースの詳細」の「ナビゲーション・メニュー」
| 属性 | 説明 |
|---|---|
アプリケーションのナビゲーション・メニューに利用されるリストを選択します。 |
|
このアプリケーションにナビゲーション・メニューを配置する位置を選択します。
たとえば、「サイド」を選択すると、ページの左側のツリーとしてナビゲーションをレンダリングできます。「トップ」を選択すると、ページのヘッダーのメニュー・バーとしてナビゲーションをレンダリングできます。 |
|
このアプリケーションのナビゲーション・メニューのレンダリングに使用されるリスト・テンプレートを選択します。 |
|
アプリケーションのナビゲーション・メニュー・リストに使用されるリスト・テンプレートのテンプレート・オプションを設定します。 |
「ナビゲーション・バー」属性は、新しいテーマとともにのみ表示されます。
表6-17 「ユーザー・インタフェースの詳細」の「ナビゲーション・バー」
| 属性 | 説明 |
|---|---|
このアプリケーションのナビゲーション・バーの実装方法を選択します。
|
|
このアプリケーションのナビゲーション・バーのレンダリングに使用されるリスト・テンプレートを選択します。 |
|
このアプリケーションのナビゲーション・メニューのレンダリングに使用されるリスト・テンプレートを選択します。 |
|
アプリケーションのナビゲーション・メニュー・リストに使用されるリスト・テンプレートのテンプレート・オプションを設定します。 |
これらの属性を使用して、アプリケーションがJavaScriptを処理する方法を制御または変更します。
表6-18 「ユーザー・インタフェースの詳細」の「JavaScript」
| 属性 | 説明 |
|---|---|
Application ExpressでライブラリjQueryおよびjQuery Mobileをロードするために使用が試行されるコンテンツ配信ネットワーク(CDN)を指定します。Application Expressでは、そのCDNからこれらのライブラリをロードできない場合、かわりにWebサーバーからこれらのライブラリがロードされます。 CDNを使用すると、ユーザーがすでに同じCDNを使用する他のWebサイトを訪問して同じライブラリをロードしたことがある場合に、アプリケーションのロード時間を短縮できます。 |
|
すべてのページにロードするコードのJavaScriptのファイルURLを入力します。各URLを新しい行に記述する必要があります。ファイルの縮小バージョンを指定する場合、置換文字列 ここに入力したJavaScriptのファイルURLによって、ページ・テンプレート内の 注意: スクリプトの開始タグや閉じタグを含める必要はありません。URLのみを記述します。 次に例を示します。
|
|
レガシーJavaScriptファンクションがアプリケーション内のすべてのページに含まれているかどうかを指定します。使用しているアプリケーションに、レガシー・ファンクションへの参照が含まれていないことが確実な場合は、これを「いいえ」に設定して、ロードされるJavaScriptファイルの全体のサイズを削減します。 非推奨のjQuery機能が使用されているかどうかを特定するには、ブラウザ・コンソールのログを開いた状態でアプリケーションを実行し、jQuery移行によって表示されるログ・メッセージを検索します。 関連項目: 『Oracle Application Express APIリファレンス』のレガシーJavaScript APIに関する項 |
|
jQuery移行プラグインがアプリケーション内のすべてのページに含まれる必要があるかどうかを指定します。 プラグインはjQueryの非推奨の機能および動作をリストアし、古いJavaScriptコードおよびjQueryプラグインが、Application ExpressによってロードされたjQueryバージョンを使用して引き続き適切に実行されるようにします。 アプリケーションおよび使用しているjQueryプラグインに、非推奨のjQuery機能への参照が含まれていないことが確実な場合は、これを「いいえ」に設定すると、ロードされるJavaScriptファイルの全体のサイズが削減されます。 |
「ファイルURL」で、すべてのページにロードするカスケード・スタイルシートのファイルURLを入力します。各URLを新しい行に記述する必要があります。ファイルの縮小バージョンを指定する場合、置換文字列#MIN#を使用して.min ,を、または#MIN_DIRECTORY#を使用して minified/を通常ページ・ビューのファイルURLに含めたり、ページをデバッグ・モードで表示する場合は空の文字列を含めることができます。アプリケーションのバージョンをファイルURLに含める場合、置換文字列#APP_VERSION#にアクセスすることもできます。
ここに入力したファイルURLによって、ページ・テンプレート内の#APPLICATION_CSS#置換文字列が置き換えられます。
例は、フィールドレベル・ヘルプを参照してください。
