Orbeon表单设置校验:如何实现应用名与表单名的唯一性校验
来自Orbeon官方文档:
应用名:每个表单定义都有一个应用名,用于标识一组相互关联的表单。实际使用中,应用名可对应某个项目、部门或公司,例如所有由Orbeon构建的表单都使用"orbeon"作为应用名。注意:根据您的权限不同,应用名可能已被预先选定,或您仅能从受限的应用名集合中选择。
表单名:每个表单定义还包含一个表单名,用于在特定应用内唯一标识该表单定义。
由于Orbeon的持久层API通过应用名与表单名检索表单定义,因此需要在表单设置页添加校验逻辑,防止用户保存与已有定义具有相同应用名和表单名的重复表单定义。最初的思路是在持久层添加自定义响应,但Orbeon无法区分通用持久化错误与校验错误,持久层/API的错误回传至用户的机制尚未成熟,请问应如何实现该需求?
实现方案
核心思路是把校验逻辑前置到保存请求发起的环节,完全避开持久层错误回传链路不完善的问题,按实现成本从低到高可选:
- 方案1:Form Builder前端内置校验扩展(推荐)
表单设置页的应用名、表单名字段,分别绑定Orbeon标准元数据节点/fr-form-metadata/metadata/application-name、/fr-form-metadata/metadata/form-name,不需要修改原有页面结构。
给保存按钮绑定提交前置拦截事件:在保存请求发出前,读取当前两个字段的输入值,调用Orbeon自带的表单元数据查询接口,检索是否存在相同「应用名+表单名」的已有表单。
注意要加排除逻辑:如果当前是编辑已有表单的场景,要把当前正在编辑的表单自身从查询结果里排除,避免把合法的自身修改误判为重名。
校验不通过时直接用Orbeon原生的xxforms:message组件弹出友好提示,同时阻断提交流程,整个环节都在前端完成,不会走到持久层的错误处理环节。 - 方案2:请求层拦截校验(低侵入,适配版本升级)
如果不想改动Form Builder的原生前端代码,可以在Orbeon的XPL请求管线里加自定义拦截规则:拦截Form Builder的保存请求,先查持久层有没有相同的app/form组合,存在的话直接返回和原生校验格式一致的错误响应,阻止请求写入持久层。
这种方式不用动前端代码,后续升级Orbeon版本的兼容性更好。
兜底机制
前端预校验只能覆盖绝大多数正常场景,解决不了极端并发(两个用户同时提交相同的app/form)的问题。可以在持久层的表单定义存储表上加application_name + form_name的联合唯一约束做最后兜底。如果出现这种极端冲突,只需要单独给这个唯一约束冲突加错误映射规则,把它和通用的持久层错误区分开,返回给前端对应的重名提示即可,不需要改动原有持久层的错误处理逻辑。
额外注意:如果你的权限系统已经限制了用户可选的应用名范围,校验时要先过滤出用户有权限的应用名列表,避免跨权限的重名判断出现误报。
内容的提问来源于stack exchange,提问作者m4gic
相关产品推荐
相关产品推荐

