Oracle APEX 21.2の新機能およびその他の変更で、気に留まったものを紹介します。
テンプレート・ディレクティブの条件追加
Oracle APEX 21.2までのテンプレート・ディレクティブのifの条件はページ・アイテムまたは列の値が、空文字列ではなく、かつ、F、N、0の文字列でもないときに真と評価されました。Oracle APEX 21.2より？および＝のプレフィックス・オペレータが追加されています。
{if P2_COND/}
P2_CONDの条件では、&P2_COND.は空文字列ではなくN0Fでもないので印刷される。<br>
{endif/}
{if =P2_COND/}
=P2_CONDの条件では、&P2_COND.はN0Fではないので空文字列でも印刷される。<br>
{endif/}
{if ?P2_COND/}
?P2_CONDの条件では、&P2_COND.は空文字列ではないので印刷される。<br>
{endif/}=オペレータはページ・アイテムまたは列の値がN、0、F以外であれば、空文字列を含め真となります。つまり真偽値だけを検証します。
?オペレータはページ・アイテムまたは列の値が空文字列以外であれば真となります。N、０、Fであっても条件としては真になります。つまり空文字列かどうかだけを検証します。
P2_CONDとしてAが渡されると、上記のスクリプトは以下を印刷します。
P2_CONDの条件では、Aは空文字列ではなくN0Fでもないので印刷される。
=P2_CONDの条件では、AはN0Fではないので空文字列でも印刷される。
?P2_CONDの条件では、Aは空文字列ではないので印刷される。
?P2_CONDの条件では、Fは空文字列ではないので印刷される
空文字列の場合は以下になります。
=P2_CONDの条件では、はN0Fではないので空文字列でも印刷される。
空文字列とN、0、Fといった真偽値の判定を異なる条件として扱えるようになり、条件設定が容易になっています。
POSTリクエストに問い合わせ引数p_contextを追加
ORDSにアクセス・ログを出力する設定を追加し、POSTリクエストのURLを確認してみます。アクセス・ログを出力する設定については、こちらの記事が参考になります。
フォームの送信でのログは以下のようになっています。簡易URLはONです。
10.0.2.2 - - [26/Nov/2021:04:25:12 +0000] "POST /ords/xepdb1/wwv_flow.accept?p_context=employees/employee/8528313532441 HTTP/1.1" 200 101
Ajaxのリクエストの場合は以下です、
10.0.2.2 - - [26/Nov/2021:04:25:13 +0000] "POST /ords/xepdb1/wwv_flow.ajax?p_context=employees/employees-report/8528313532441 HTTP/1.1" 200 22038
簡易URLがOFFの場合の例です。
10.0.2.2 - - [26/Nov/2021:04:24:07 +0000] "POST /ords/xepdb1/wwv_flow.accept?p_context=4550:1:8705366998123 HTTP/1.1" 302 0
GETリクエストの場合はアプリケーション名(もしくはID)、ページ名(または番号)およびセッションIDがURLに含まれていました。POSTやAjaxはそうではなかったのですが、これからはURLから呼び出し元を確認できます。
アクセス・ログの解析が、今までより容易になりました。
新規ページ作成時のページ・アクセス保護のデフォルト値
新規にページを作成したときのページ・プロパティページ・アクセス保護の値が引数にチェックサムが必要になりました。今までは制限なしだったので、デフォルト値がより安全な設定になっています。
apex.util.escapeHTMLAttrの追加
これまでJavaScript APIとしてapex.util.escapeHTMLがありましたが、より多くの特殊文字をエスケープの対象とするapex.util.escapeHTMLAttrが追加されました。英数字とカンマ、ピリオド、ダッシュ、アンダースコア以外はエスケープされます。
例えば、!#$%&をそれぞれエスケープすると、結果は以下になります。
apex.util.escapeHTML("!#$%&");
'!#$%&'
apex.util.escapeHTMLAttr("!#$&");
'!#$&'
クロスサイト・スクリプティングに対応するために追加されたファンクションになります。HTMLの属性となる文字列は、apex.util.escapeHTMLAttrを呼び出してエスケープすることが推奨されています。
リリース・ノートなどの記載から気に留まった変更点は以上になります。
Oracle APEXのアプリケーション作成の参考になれば幸いです。
完
