工作流打开 UX 与传参

先区分两个跳转入口

处理人的任务入口：在单人任务或多人任务的待办设置中，配置待办跳转界面。这里有当前任务上下文，可以传 acp$task_id。

发起人的流程入口：在工作流全局配置的待办设置中配置，用于从“我发起的流程”等入口查看整个流程。这里应传 wfp$proc_id 及业务信息，不要假定存在某一条人工任务的 acp$task_id。

两个入口可以关联同一个 UX，但 UX 中的查询条件要覆盖对应场景。

第一步：准备 UX 接收端

在 UX 中配置业务表单数据源和工作流控件。下面采用三个自定义 URL 参数：

• contract：业务数据源按 $urlQuery.contract 查询合同。

• task：任务处理控件的任务实例 ID 填 $urlQuery.task。

• proc：流程记录和流程图的流程实例 ID 填 $urlQuery.proc。

这些表达式写在 UX 的表达式配置 中。wfi$contract_id 等工作流变量不能直接当作 UX 页面变量读取。

保存 UX 后，再回到工作流选择此元素。UX 中已配置的外部变量可用于加载参数清单；同时可按需要添加自定义跳转参数。新增清单项后仍需在工作流侧明确赋值。

第二步：配置人工任务跳转

1. 选择人工任务节点，进入待办跳转界面设置并启用。

2. 选择已保存的 UX 业务处理页。

3. 添加参数 contract，值使用工作流表达式 wfi$contract_id。

4. 添加参数 task，值使用 acp$task_id。

5. 添加参数 proc，值使用 wfp$proc_id。

6. 保存并发布工作流，从一条真实任务打开页面验证。

对应关系：工作流的键 task 决定 UX 读取 $urlQuery.task；值 acp$task_id 决定传入的是当前任务 ID。键名不是固定保留名，可以调整，但两端要一起改。

第三步：配置发起人查看入口

在工作流全局配置的待办设置中，关联查看页，至少传入 contract = wfi$contract_id 和 proc = wfp$proc_id。

查看页可用业务表单和流程记录展示审批进度。如果还放置任务处理控件，需要按业务启用“基于流程实例查询”等后备方式；是否能操作仍取决于当前用户的任务身份与按钮规则。

URL 参数的边界

URL 参数适合传递业务主键和实例 ID。页面拿到主键后，再通过数据源加载业务记录。

• 不要把整份业务对象、附件内容或大数组拼到 URL 中。

• 不要使用 elementName、folderId、path、sign 等页面定位参数作为自定义业务参数名。

• 参数名应唯一并保持大小写一致。

• URL 中的数字、布尔值等通常按文本读取，需要数值运算时再按业务类型转换。

• 值包含 &、#、+、空格等字符时，应先测试实际链接是否被截断或改变。优先传不含这些字符的稳定主键；确需传递特殊文本时，由实施人员核对编码与解码，避免重复编码。

• URL 中的值不能代替权限校验；能定位业务记录，不代表当前用户可以修改它。

最容易混淆的情况

页面能显示合同，任务处理却为空：只配了业务参数，还需配任务 ID 或启用后备查询。

任务处理正常，合同表单为空：任务参数正确，但业务数据源未使用 contract，或当前用户没有业务数据权限。

直接预览正常，从待办进入异常：检查任务实际链接的参数。预览中的固定测试值不等于真实任务传入值。

新配置已发布，旧待办仍不符合预期：核对流程实例版本和任务链接；用新发起的实例检查新配置，不假定既有任务链接会自动重建。

检查结果

使用指定审批人的账号，从待办打开测试合同：业务编号正确；任务处理显示当前任务；流程记录和流程图指向同一流程实例。再从发起人的流程入口查看，确认即使没有 task 参数，也能正常显示业务和流程记录。