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