組込み置換文字列について

APP_ALIAS

APP_ALIASは、カレント・アプリケーションの英数字の名前です。APP_ALIASは、APP_IDが1つのデータベースでホスティングされているすべての作業領域およびすべてのアプリケーションで一意である必要があるという点で、APP_IDと異なります。APP_ALIASは、作業領域内で一意である必要があります。たとえば、1つのAPP_ALIASを使用して2つの異なる作業領域にABCというアプリケーションを作成することができます。APP_ALIASは、APP_IDを使用できる場所であればほぼすべての場合に使用できます。たとえば、次の例に示すように、f?p構文にAPP_ALIASまたはアプリケーションIDを使用できます。

f?p=ABC:1:&APP_SESSION.

この例では、アプリケーションABCのページ1が、カレント・セッションを使用して実行されます。

表「APP_ALIAS構文」に、APP_ALIASを参照するためにサポートされている構文を示します。

次に、HTMLの例を示します。

Click me to go to page 1 <a href="f?p=&APP_ALIAS.:1:&APP_SESSION."> of the current application</a>

APP_ID

APP_IDは、現在実行されているアプリケーションのアプリケーションIDを示します。表「APP_ID構文」に、APP_IDを参照するためにサポートされている構文を示します。

次に、置換文字列の参照の例を示します。

f?p=&APP_ID.:40:&APP_SESSION.

APP_IMAGES

この置換文字列を使用して、特定のアプリケーションに固有で、複数のアプリケーションでは共有されていないアップロードされたイメージ、JavaScriptおよびカスケード・スタイルシートを参照します。ファイルをアップロードして、そのファイルをアプリケーション固有に設定した場合、この置換文字列またはバインド変数を使用する必要があります。表「APP_IMAGES構文」に、APP_IMAGESを参照するためにサポートされている構文を示します。

APP_PAGE_ID

APP_PAGE_IDはカレント・アプリケーションIDです。たとえば、アプリケーションが3ページ目に存在した場合、結果は3になります。この構文の使用は、複数のアプリケーションで汎用的に動作する必要があるアプリケーション・コンポーネントを記述する場合に有効です。表「APP_PAGE_ID構文」に、APP_PAGE_IDを参照するためにサポートされている構文を示します。

次に、置換文字列の参照の例を示します。

f?p=&APP_ID.:&APP_PAGE_ID.:&APP_SESSION.

APP_SESSION

APP_SESSIONは、最もよく使用される組込み置換文字列の1つです。この置換文字列を使用して、セッション番号を渡すことによりセッション・ステートを維持するアプリケーション・ページ間のハイパーテキスト・リンクを作成できます。APP_SESSIONのかわりに置換文字列SESSIONを使用することもできます。表「APP_SESSION構文」に、APP_SESSIONを参照するためにサポートされている構文を示します。

次に例を示します。

• HTMLリージョン内からの参照:

  <a href="f?p=100:5:&APP_SESSION.">click me</a> 
  

• PL/SQLを使用した参照:

  htf.anchor('f?p=100:5:'||V('APP_SESSION'),'click me');
  

• SQL問合せを使用した参照:

  SELECT htf.anchor('f?p=100:5:'||:APP_SESSION,'clickme') FROM DUAL;
  

APP_UNIQUE_PAGE_ID

APP_UNIQUE_PAGE_IDは、各ページ・ビューに固有なOracle順序から生成される整数です。この数値は、アプリケーションで重複したページの送信を防止するために使用され、その他の用途にも使用できます。たとえば、一意のURLを作成し、ブラウザのキャッシュの問題を防止するには、この数値を、fプロシージャへのコール内のリクエスト列またはデバッグ列に埋め込むことができます。表「APP_UNIQUE_PAGE_ID構文」に、APP_UNIQUE_PAGE_IDを参照するためにサポートされている構文を示します。

次に、HTMLの例を示します。

SELECT 'f?p=100:1:'||:APP_SESSION||':'||:APP_UNIQUE_PAGE_ID||
    ':::P1_EMPNO:'||employee_id,
   first_name,
    job_id
FROM employees

リクエスト列にAPP_UNIQUE_PAGE_IDが使用されていることに注意してください。これによって、このURLが一意になり、ブラウザによる過度のキャッシュの問題を回避できます。

APP_USER

APP_USERは、アプリケーションを実行しているカレント・ユーザーです。認証モデルに応じて、ユーザーの値の設定も異なります。アプリケーションがデータベース認証を使用して実行されている場合、ユーザーの値はデータベースの擬似列USERと同じになります。アプリケーションが、ユーザー認証を必要とする認証スキームを使用する場合、APP_USERの値はその認証スキームによって設定され、通常は、認証時に使用されるユーザー名に設定されます。表「APP_USER構文」に、APP_USERを参照するためにサポートされている構文を示します。

次に例を示します。

• HTMLリージョン内からの参照:

  Hello you are logged in as &APP_USER.
  

• PL/SQLを使用した参照:

  htp.p('Hello you are logged in as'||V('APP_USER')); 
  

• バインド変数としての参照:

  SELECT * FROM some_table WHERE user_id = :APP_USER
  

  
  

  参照: パブリック・ユーザー属性の詳細は、「認証」を参照してください。

  
  

AUTHENTICATED_URL_PREFIX

このアプリケーション・レベルの属性は、有効な認証済接頭辞（ログインしているURLの接頭辞）を示します。相対パスまたはhttpで始まるフルパスを使用できます。このアイテムは、アプリケーションが認証済（ログイン済）モードとパブリック（未ログイン）・モードの両方で実行可能な場合に有効です。AUTHENTICATED_URL_PREFIXを使用すると、認証済のページへのリンクを作成できます。このアイテムは、Basicデータベース認証の使用時に最も有効です。これは、URLの変更に認証が必要になる場合があるためです。表「AUTHENTICATED_URL_PREFIX構文」に、AUTHENTICATED_URL_PREFIXを参照するためにサポートされている構文を示します。

BROWSER_LANGUAGE

BROWSER_LANGUAGEは、Webブラウザの現行の言語プリファレンスを参照します。表「BROWSER_LANGUAGE構文」に、BROWSER_LANGUAGEを参照するためにサポートされている構文を示します。

CURRENT_PARENT_TAB_TEXT

CURRENT_PARENT_TAB_TEXTは、ページ・テンプレートで最も有効です。ただし、この文字列は、2つのレベルのタブ（親タブと標準タブ）が使用されるアプリケーションでのみ使用できます。この文字列は、親タブ・ラベルの参照に使用します。この置換文字列を使用すると、現在選択されている親タブを、ページ・テンプレート内で繰り返すことができます。表「CURRENT_PARENT_TAB_TEXT構文」に、CURRENT_PARENT_TAB_TEXTを参照するためにサポートされている構文を示します。

DEBUG

DEBUGフラグの有効値はYesまたはNoです。デバッグを有効にすると、アプリケーション・プロセスの詳細が表示されます。カスタム・コードを記述する場合、デバッグ・モードがYesに設定されている場合にのみデバッグ情報を生成できます。表「DEBUG構文」に、DEBUGを参照するためにサポートされている構文を示します。

次に、DEBUGの現行の値を保持する置換文字列の参照の例を示します。

f?p=100:1:&APP_SESSION.::&DEBUG

HOME_LINK

HOME_LINKは、アプリケーションのホームページです。ページが指定されておらず、かつ認証スキームのロジックによって代替ページが指定されていない場合、Application Expressエンジンによって、この場所にリダイレクトされます。HOME_LINKはアプリケーション属性ページで定義します。

表「HOME_LINK構文」に、HOME_LINKを参照するためにサポートされている構文を示します。

LOGIN_URL

現在ログインしていないユーザー用のログイン・ページへのリンクを表示するには、LOGIN_URLを使用します。表「LOGIN_URL構文」に、LOGIN_URLを参照するためにサポートされている構文を示します。

IMAGE_PREFIX

IMAGE_PREFIXの値によって、Oracle Application Expressによって分散されたイメージ・ディレクトリを指すためにWebサーバーが使用する仮想パスが決まります。アップロードされたイメージを参照するには、WORKSPACE_IMAGESおよびAPP_IMAGESを使用します。表「IMAGE_PREFIX構文」に、IMAGE_PREFIXを参照するためにサポートされている構文を示します。

Application Express SCHEMA OWNER

PL/SQLコードからアプリケーションへのコールを生成する場合、Oracle Application Expressスキーマの所有者を参照する必要がある場合があります。次に、直接PL/SQLを参照する際の正しい構文を示します。

APEX_APPLICATION.G_FLOW_SCHEMA_OWNER

また、#FLOW_OWNER#を使用してSQL問合せおよびPL/SQL（リージョンやプロセスなど）でこの値を参照することもできます。

PRINTER_FRIENDLY

PRINTER_FRIENDLYの値によって、Application Expressエンジンが印刷表示モードで実行するかどうかが決定されます。この設定は、印刷されるドキュメントには不適切な要素をページから排除する条件で参照できます。表「PRINTER_FRIENDLY構文」に、PRINTER_FRIENDLYを参照するためにサポートされている構文を示します。

LOGOUT_URL

LOGOUT_URLはアプリケーション・レベルの属性であり、ログアウトURLの指定に使用されます。これは、ユーザーをログアウト・ページに移動するか、またはオプションで直接ユーザーをログアウトさせるURLです。ログアウト・ナビゲーション・バー・エントリを作成するには、&LOGOUT_URLの最後にピリオドを追加します（&LOGOUT_URL.）。ページ・テンプレートをコーディングしている場合は、#LOGOUT_URL#を使用します。表「LOGOUT_URL構文」に、LOGOUT_URLを参照するためにサポートされている構文を示します。

PROXY_SERVER

PROXY SERVERは、アプリケーション属性です。この属性は、ソースがURLであるリージョンによって使用される場合があります。次に、直接PL/SQLを参照する際の正しい構文を示します。この参照は、データベースからリモートWebサーバーにアクセスするためのPL/SQLを記述する場合に使用します（たとえば、データベースに付属するutl_httpパッケージを使用する場合）。

APEX_APPLICATION.G_PROXY_SERVER

PUBLIC_URL_PREFIX

PUBLIC_URL_PREFIXは、アプリケーション・レベルの属性であり、ログイン・モードをパブリック表示に切り替えるURLを指定します。表「PUBLIC_URL_PREFIX構文」に、PUBLIC_URL_PREFIXを参照するためにサポートされている構文を示します。

REQUEST

REQUESTの値は、各アプリケーションのボタンによって、そのボタンの名前またはそのボタンに関連付けられているリクエスト値属性に設定されます。これによって、ユーザーがボタンをクリックしたときに、受入れプロセスでそのボタンの名前が参照されるようになります。f?p構文では、REQUESTは4つ目の引数を使用して設定できます。

f?p=100:1:&APP_SESSION.:GO

IF V ('REQUEST') = 'GO' THEN
   htp.p('hello');
END IF;

SQLERRM

SQLERRMは、アプリケーション・リージョン・エラー・メッセージでのみ使用可能なテンプレート置換です。次に、リージョン・テンプレート置換を参照する際の正しい構文を示します。

#SQLERRM#

SYSDATE_YYYYMMDD

SYSDATE_YYYYMMDDは、データベース・サーバーの現在の日付にYYYYMMDD書式マスクを適用して表示します。この値を、SYSDATE()ファンクションを繰り返しコールするかわりに使用できます。次のリストに、SYSDATE_YYYYMMDDを参照するためにサポートされている構文を示します。

• バインド変数

  :SYSDATE_YYYYMMDD
  

• PL/SQL

  V('SYSDATE_YYYYMMDD')
  

• 直接PL/SQL

  APEX_APPLICATION.G_SYSDATE (DATE DATATYPE)
  

WORKSPACE_IMAGES

この置換文字列を使用して、作業領域内の複数のアプリケーションで共有されているアップロードされたイメージ、JavaScriptおよびカスケード・スタイルシートを参照します。表「WORKSPACE_IMAGES構文」に、WORKSPACE_IMAGESを参照するためにサポートされている構文を示します。