32.9 GET_URLファンクション

このファンクションは、Application Expressナビゲーションを返します。連結されたURLよりも、ファンクション・コールを読み込んだ方が明確な場合があります。比較のため、次に示す例を参照してください。

指定したアプリケーションが別のワークスペースにある場合、URLにチェックサムは含まれません。

構文

FUNCTION GET_URL (
    p_application        IN VARCHAR2 DEFAULT NULL,
    p_page               IN VARCHAR2 DEFAULT NULL,
    p_session            IN NUMBER   DEFAULT APEX.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_triggering_element IN VARCHAR2 DEFAULT 'this',
    p_plain_url          IN BOOLEAN DEFAULT FALSE )
    RETURN VARCHAR2;

パラメータ

表32-3 GET_URLのパラメータ

パラメータ	説明
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_triggering_element	ダイアログのトリガーに使用する要素を特定するjQueryセレクタ(たとえば#my_button。my_buttonはボタン要素の静的ID)。これは、モーダル・ダイアログのサポートに必要です。
p_plain_url	APEX_PAGE.GET_URLのコール元のページがモーダル・ダイアログの場合に、p_plain_urlを指定して、生成されるリンク内の不要なJavaScriptコードを省略します。デフォルトでは、このファンクションがモーダル・ダイアログからコールされている場合、モーダル・ダイアログを閉じるためのJavascriptコードは生成した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')
     FROM DUAL