跳转到主要内容

在表单动作中调用自定义服务

让表单按钮调用已发布的服务,把返回值保存到表单变量供后续步骤使用。

例如,在采购申请中添加「生成明细」按钮。点击时调用易企办自定义服务,把采购明细转换为 HTML 表格,并将结果存入表单变量。

易企办表单动作示意。按钮把采购明细传给 subListJson,自定义服务返回 htmlTable,表单变量接收并供后续步骤使用。

准备服务和表单变量

  1. 在测试应用中导入并测试子列表转邮件表格模板,核对 subListJson 输入和 htmlTable 输出均为文本,再发布服务。导入和导出自定义服务

  2. 在测试表单中准备采购明细及用于接收结果的文本变量,例如「明细表格」。

配置表单动作

  1. 在表单设计器打开动作,新建或打开一个动作。若「添加步骤」列表提供「调用自定义服务」,选择它并选中已发布的服务。

  2. 需要按条件执行时,设置动作执行条件,例如只在存在采购明细时调用。找不到服务时,先核对应用范围、发布状态及调用权限。

  3. 将明细行转换为有效的 JSON 数组文本,映射到 subListJson。若使用的是需要连接的其他服务,同时设置连接变量。

  4. 将 htmlTable 映射到文本变量「明细表格」。后续动作可以读取该变量;要展示为表格,应将它传给明确支持 HTML 的目标。

绑定按钮并验证结果

  1. 保存动作,再将「生成明细」按钮绑定到该动作。使用两条样例明细验证返回结果,核对记录数、列名和文本编号的前导零。

  2. 再试空明细、无效 JSON 和重复点击,检查空结果或报错时后续步骤会怎样运行,并确认没有误用旧输出。

  3. 用目标角色重新验证后发布表单。若应由审批流程自动执行,请参考在工作流中调用自定义服务。

这是否解答了您的问题?