oracle apex ajax process + dy 校验

目前apex的后端校验，即用户输入后，点击提交才触发与后端服务器的校验，为了提升用户体验，可以把这一步前置，用js事件触发后端校验，以监测用户名是否重复为例。
演示环境为 apex 20.2

建立Ajax process

DECLAREl_count NUMBER := 0;
BEGIN--名称重复校验IF :P5_1 IS NOT NULL THENSELECT COUNT(1)INTO l_countFROM 666 vWHERE v.1 = :P5_1AND ROWNUM = 1;IF l_count > 0  THENhtp.p('客户:' || :P5_1 || '已存在');ELSEhtp.p('success');END IF;END IF;--号重复校验IF :P5_2 IS NOT NULL THENSELECT COUNT(1)INTO l_countFROM 666 vWHERE v.2 = :P5_2AND ROWNUM = 1;IF l_count > 0  THENhtp.p('已存号为:' || :P5_2|| '的客户!');ELSEhtp.p('success');END IF;END IF;END;

先在process直接建立proce，然后位置选择 ajax,注意pl/sql要有返回值，后面的js需要根据返回值进行判断。
注意：htp.p打印的后面会有一个空格或者制表符，js判断时需要考虑进行字符串去空格操作。或者这个地方直接打印json也可以（参加文末勘误）

在对应的表单页项上建立动态操作

js事件选择改变（onchange）或者失去焦点（onblur），真操作为执行js代码

apex.server.process('ajax_validate_customer_repeat',//这儿的名称为process的名称{pageItems: '#P5_PARTY_NAME'//注意带#号},{dataType: 'text', success: function (data) {if (  /*data*/ data.trim() != 'success') {//用htp.p打印的后面带一个空格，不知道为啥，此处要注意，也可以用apex封装的api直接打印jsonapex.message.clearErrors();apex.message.showErrors([{type: "error",location: ["page", "inline"],pageItem: "P5_PARTY_NAME",message: data,unsafe: false}/*,{type: "error",location: "page",message: data,unsafe: false}*/]);}else {apex.message.clearErrors();}}}
)

效果如下

后续改进

可以把重复校验的单独封装成一个js函数

function repeat_validate(page_item_name) {apex.server.process('ajax_validate_customer_repeat',{pageItems: "#" + page_item_name},{dataType: 'text', success: function (data) {if (  /*data*/ data.trim() != 'success') {apex.message.clearErrors();apex.message.showErrors([{type: "error",location: ["page", "inline"],pageItem: page_item_name,message: data,unsafe: false}]);}else {apex.message.clearErrors();}}})
}

把上面这段js放到页》JavaScript 》函数和全局变量声明里面去。

然后在要验证的表单项上高级》定制: οnchange=“repeat_validate(‘P5_XXX’);”

这样就实现了公用，不必再在此页项上定义动态操作了。

参考文档：

https://apex.oracle.com/pls/apex/germancommunities/apexcommunity/tipp/3341/index-en.html

https://www.foxinfotech.in/2020/04/oracle-apex-validation-without-submit-using-javascript-and-ajax-callback.html

json

不用动态操作实现

勘误

htp.p 、htp.print 、htp.prn 三者是有区别的：

HTP.p is a shortcut (undocumented) to htp.print. HTP. Print adds a new line to the output.
HTP. PRN does not add a line break.

htp.p和htp.print 会在后面自动多一个/n 新行
hpt.prn不会多/n

https://docs.oracle.com/database/121/ARPLS/w_htp.htm#ARPLS70586