PREPARE_URLファンクション

このファンクションは、レンダリング可能なf?p相対URLを指定すると、セッション・ステート保護チェックサム引数（&cs=）が必要な場合に追加します。

注意:

PREPARE_URLファンクションは、&cs=<large hex value>を追加したf?p URLを戻します。たとえば、この戻り値をJavaScriptで使用する場合、特定のコンテクストの構文規則に従うため、URLのアンパサンドをエスケープする必要があります。PREPARE_URLのコールを含むSVGチャートのSQL問合せでは、このエスケープが必要な場合があります。

構文

APEX_UTIL.PREPARE_URL (
   p_url           IN VARCHAR2
   p_url_charset   IN VARCHAR2 default null,
   p_checksum_type IN VARCHAR2 default null)
RETURN VARCHAR2;

パラメータ

表「PREPARE_URLパラメータ」に、PREPARE_URLファンクションで使用可能なパラメータを示します。

PREPARE_URLパラメータ

パラメータ	説明
p_url	すべての置換が解決されているf?p相対URL
p_url_charset	引数値に含まれている特殊文字をエスケープする場合に使用するキャラクタ・セット名（`UTF-8`など）
p_checksum type	NULL、あるいは6つの値（`SESSION`または`3`、 `PRIVATE_BOOKMARK`または`2`、あるいは`PUBLIC_BOOKMARK`または`1`）のいずれか

例

DECLARE
l_url varchar2(2000);
l_session number := v('APP_SESSION');
BEGIN
l_url := 
APEX_UTIL.PREPARE_URL('f?p=100:1:'||l_session||'::NO::P1_ITEM:xyz');
END;