Orbeon表单验证时调用外部API的正确方法是什么？

我完全懂你的困扰——Orbeon默认的HTTP服务配置界面看起来没给太多自定义JSON的空间，但其实通过表单流程（Processes）结合XPath表达式，完全可以实现你想要的：验证通过后把表单字段打包成自定义JSON，调用Nuxeo的文档更新API。下面是一步步的具体操作：

1. 先配置HTTP服务 #

打开你的Orbeon表单，进入Form Builder的「HTTP Services」面板：

• 点击「Add」新建一个服务，选择POST方法
• 填写Nuxeo的文档更新端点URL（比如/nuxeo/api/v1/id/[你的文档ID]，如果文档ID需要动态获取，也可以用表单里的字段值拼接，比如concat('/nuxeo/api/v1/id/', /form/Document-ID)）
• 切换到「Request」标签页，在「Body」部分选择「XPath Expression」，这就是我们自定义JSON的关键入口

2. 用XPath构造自定义JSON请求体 #

你有两种可靠的方式生成JSON：

方式一：手动拼接（适合简单场景） #

直接用concat()函数把字段值嵌入JSON结构，记得处理特殊字符：

concat('{
  "properties": {
    "dc:title": "', replace(string(/form/First-name), '"', '\\"'), ' ', replace(string(/form/Second-name), '"', '\\"'), '",
    "dc:description": "', replace(string(/form/Case-description), '"', '\\"'), '",
    "my:email": "', replace(string(/form/e-mail), '"', '\\"'), '",
    "my:phone": "', replace(string(/form/Phone), '"', '\\"'), '"
  }
}')

注意：/form/First-name这类路径要和你表单里字段的实际ID对应，你可以在Form Builder里右键字段查看「Edit Name」确认ID。

方式二：用xxf:serialize()自动生成（推荐，更安全） #

这个函数可以把XML元素序列化成JSON，自动处理转义和格式问题：

xxf:serialize(
  element properties {
    element "dc:title" { concat(/form/First-name, ' ', /form/Second-name) },
    element "dc:description" { /form/Case-description },
    element "my:email" { /form/e-mail },
    element "my:phone" { /form/Phone }
  },
  map { "method": "json" }
)

这样生成的JSON会自动处理字段里的双引号、换行等特殊字符，比手动拼接省心多了。

3. 设置验证通过后的触发流程 #

回到Form Builder的「Settings」→「Processes」面板，找到「Success」事件（也就是表单验证通过、提交成功后触发的事件）：

• 添加一个send动作，选择你刚才创建的HTTP服务
• 可以再加一个提示动作，比如success-message("表单已提交，正在更新Nuxeo文档...")
  最终的流程代码大概是这样：

send("my-nuxeo-update-service") then success-message("Nuxeo文档更新成功！")

（my-nuxeo-update-service是你给HTTP服务起的名字，记得对应上）

4. 处理Nuxeo的认证（必选项） #

Nuxeo的API需要认证，你可以在HTTP服务的「Headers」里添加认证头：

• 比如Basic Auth，添加一个Authorization头，值用XPath生成：

  concat('Basic ', encode-for-uri(concat('你的Nuxeo用户名', ':', '你的Nuxeo密码')))
  

安全提示：不要把密码硬编码在表单里！更好的方式是把凭证存在Orbeon的配置文件（比如properties-local.xml）里，用property()函数读取，比如property("nuxeo.auth.token")。

最后检查点 #

• 测试表单时，打开浏览器的开发者工具，查看Network面板，确认发送的请求体是不是你想要的JSON结构
• 如果API调用失败，检查Nuxeo的日志，看是不是权限、字段映射或者JSON格式的问题

内容的提问来源于stack exchange，提问作者Joaquín