43.4 GET_URLファンクション

APEXf?p= URLを戻します。連結されたURLよりも、ファンクション・コールを読み込んだ方が明確な場合があります。比較のため、次に示す例を参照してください。

ノート:

特定のアプリケーションが別のワークスペースにある場合、URLでチェックサムが除外されます。

構文

APEX_PAGE.GET_URL (
    p_application        IN VARCHAR2 DEFAULT NULL,
    p_page               IN VARCHAR2 DEFAULT NULL,
    p_session            IN NUMBER   DEFAULT apex_application.g_instance,
    p_request            IN VARCHAR2 DEFAULT NULL,
    p_debug              IN VARCHAR2 DEFAULT NULL,
    p_clear_cache        IN VARCHAR2 DEFAULT NULL,
    p_items              IN VARCHAR2 DEFAULT NULL,
    p_values             IN VARCHAR2 DEFAULT NULL,
    p_printer_friendly   IN VARCHAR2 DEFAULT NULL,
    p_trace              IN VARCHAR2 DEFAULT NULL,
    p_x01                IN VARCHAR2 DEFAULT NULL,
    p_hash               IN VARCHAR2 DEFAULT NULL,
    p_triggering_element IN VARCHAR2 DEFAULT 'this',
    p_plain_url          IN BOOLEAN  DEFAULT FALSE,
    p_absolute_url       IN BOOLEAN  DEFAULT FALSE )
    RETURN VARCHAR2;

パラメータ

パラメータ 説明
p_application アプリケーションのIDまたは別名。デフォルトは、現在のアプリケーションです。
p_page ページのIDまたは別名。デフォルトは、現在のページです。
p_session セッションID。デフォルトは、現在のセッションIDです。
p_request URLリクエスト・パラメータ。
p_debug URLデバッグ・パラメータ。デフォルトは、現在のデバッグ・モードです。
p_clear_cache URLキャッシュ・クリア・パラメータ。
p_items セッション・ステートを設定するための、カンマで区切られたアイテム名のリスト。
p_values セッション・ステートを設定するための、カンマで区切られたアイテム値のリスト。
p_printer_friendly URL印刷用パラメータ。デフォルトは、現在のリクエストの「印刷用」モードです。
p_trace SQLトレース・パラメータ。
p_x01 パラメータ&x01=valueをURLに追加します。
p_hash URLの末尾に#hash-valueを追加します。
p_triggering_element ダイアログのトリガーに使用する要素を特定するためのjQueryセレクタ(たとえば#my_button。ここでの"my_button"はボタン要素の静的ID)。モーダル・ダイアログのサポートのために必要です。
p_plain_url APEX_PAGE.GET_URLのコール元のページがモーダル・ダイアログの場合に、p_plain_urlを指定して、生成されるリンク内の不要なJavaScriptコードを省略します。デフォルトでは、このファンクションがモーダル・ダイアログからコールされている場合、モーダル・ダイアログを閉じるためのJavascriptコードは生成したURLに含まれています。
p_absolute_url FALSE (デフォルト)の場合、絶対URLが必要かどうかを自動判別します。TRUEの場合、常に絶対URLを生成します。

次の問合せでは、APEX_PAGE.GET_URLとその代替のAPEX_UTIL.PREPARE_URLを使用して同一のURLを2つ生成します。

SELECT APEX_PAGE.GET_URL (
            p_page   => 1,
            p_items  => 'P1_X,P1_Y',
            p_values => 'somevalue,othervalue' ) f_url_1,
         APEX_UTIL.PREPARE_URL('f?p=&APP_ID.:1:&APP_SESSION.::::P1_X,P1_Y:somevalue,othervalue') f_url_2
     FROM DUAL;