日日是Oracle APEX: ページ・アイテムに含まれるコロンの扱いについて

2022年10月26日水曜日

ページ・アイテムに含まれるコロンの扱いについて

ページ・アイテムの値に含まれるコロンの扱いについて、調べてみました。

ふたつのページ・アイテムP1_DATE1、P1_DATE2があり、送信ボタンでページを送信します（時刻以外のデータを後で投入するため、タイプはテキスト・フィールドとします）。

ブランチを作成して別ページに遷移します。ページ・アイテムの値を引き継ぐように、ブランチのターゲットを設定します。

結果を確認します。ページ・アイテムP1_DATE2の秒の値が引き継がれていません。

内部動作を確認してみます。以下のPL/SQLスクリプトをSQLコマンドにて実行します。

declare
    l_url varchar2(4000);
    l_prepared_url varchar2(4000);
begin
    l_url   := 'f?p=102:2:0::::P1_DATE1,P1_DATE2:2022-10-12 01:15:03,2022-10-25 00:30:02';
    l_prepared_url := apex_util.prepare_url(
        p_url => l_url
        , p_plain_url=>false
    );
    dbms_output.put_line(l_prepared_url);
 end;

APEX_UTIL.PREPARE_URLのP_URLに与える値は以下です。

f?p=102:2:0::::P1_DATE1,P1_DATE2:2022-10-12 01:15:03,2022-10-25 00:30:02

以下の結果が得られます。

f?p=102:2:0::::P1_DATE1,P1_DATE2:2022-10-12%2001%3A15%3A03,2022-10-25%2000%3A30:02&cs=12kqt5FOaWV4L6visvq5RIzLHr2w2OjPGYYc9RzAIZW9YqzdELIY1VUVzbo3KaTVesLRcZdC0_cSWVxikLnsVdw

チェックサムを除くと以下になります。

f?p=102:2:0::::P1_DATE1,P1_DATE2:2022-10-12%2001%3A15%3A03,2022-10-25%2000%3A30:02

マニュアルでは、ページ・アイテムにカンマが含まれる可能性がある場合は、バックスラッシュ(\)でページ・アイテムの値を囲むように案内されています。

https://docs.oracle.com/cd/F70953_01/htmdb/understanding-legacy-url-syntax.html#GUID-D5510BFC-AF94-4AAD-8B82-FF780A47601D

itemValues

URLでセッション・ステートを設定するために使用されるアイテム値のリストです。アイテム値にカンマを渡すには、文字をバックスラッシュで囲んでください。次に例を示します。

\123,45\

backslash comma (\,)以外のすべての文字列は、バックスラッシュで囲むことができます。

しかし、コロンについてはそのような記述はありません。また、カンマとは異なり、つねに区切り文字として扱われているわけでもありません。ページ・アイテムP1_DATE1については、秒の値も引き継がれています。

調べたところ、最後のコロン以降はPrinterFriendlyとして認識することが理由でした。

PrinterFriendly

ページを「印刷用」モードでレンダリングするかどうかを決定します。PrinterFriendlyが「はい」に設定されている場合は、ページが「印刷用」モードでレンダリングされます。PrinterFriendlyの値は、リージョンなどの要素をページから削除して印刷される出力を最適化するための条件のレンダリングに使用されます。

印刷用プリファレンスを参照するには、次の構文を使用します。

V('PRINTER_FRIENDLY')

参照すると、印刷用テンプレートを使用してページが表示されます。APEXエンジンは、HTMLフォーム・フィールド内のすべてのテキストをテキストとして表示します。印刷用テンプレートには、#FORM_OPEN#タグまたは#FORM_CLOSE#タグは必要ありません。目的は、表をほとんど使用しないで、印刷に適した書式で情報を表示できるようにすることです。

ターゲットのページでPrinterFriendlyの値を確認するために、ページ・アイテムを追加します。ソースのタイプを式として、PL/SQL式に以下を記述します。

V('PRINTER_FRIENDLY')