更新时间:2025-06-23 GMT+08:00
分享

设置物料插件的设置参与者组件属性

适用场景

在企业日常审批场景中,“设置参与者”组件通过表单展示审批角色对应的用户配置。该组件能够实时同步服务端数据,更新表单项。流程发起人可以通过输入姓名或工号等方式快速选定合适的审批人员,从而高效确定审批流程的参与者。

基础属性

属性名

说明

支持变量绑定

组件名

设置参与者组件的名称,默认为“设置参与者”,不可修改。

×

ref引用类

设置参与者组件的ID,系统自动生成,且不可修改。

×

Style

配置设置参与者组件样式,支持通过CSS代码自定义设置参与者组件的样式。

表单数据

配置参与者数据。

表单项

表单项与“流程编辑”页面中已指定具体角色的“用户任务”流程组件相关联。您可以根据实际业务需求设置如下属性,从而实现不同的功能与交互效果。

  • :存在多个表单项时,长按此图标并上下拖动,调整“用户任务”审批人的排序。
  • /:显示或隐藏某个“用户任务”的审批人表单项。
  • :编辑某个“用户任务”的审批人表单项。
    • 字段名:用户任务审批人的字段名称,系统自动生成,且不可修改。
    • 回显当前用户:用于在流程启动时,自动将当前登录用户预填充为默认审批人,简化用户操作。
      • :不自动填充。
      • :自动填充。
    • 是否隐藏当前项:开启“回显当前用户”后,您可以通过此配置隐藏当前表单项,从而避免用户误修改审批人信息。
      • :不隐藏。
      • :隐藏。
    • 是否多选:关闭“回显当前用户”后,您可以进一步设置此配置项。
      • :关闭多选,发起人只能从指定角色下的有效成员中选择1位审批人。
      • :启用后,发起人可以从指定角色下的有效成员中选择多位审批人。
    • 最多选中人数:开启“是否多选”后,您可以设置审批人数量上限,用于限制发起人在启动流程时最多选择的审批人数,最大支持100人。
    • 最多选中人数提示语:开启“是否多选”后,您可以自定义最多选中人数的提示文案,以适用不同业务场景的交互需求。
    • 不允许选中当前用户:关闭“回显当前用户”后,您可以通过此配置项控制是否允许发起人选择自己作为审批人,避免“自审自批”的情况,确保流程合规性。
      • :允许选择当前用户作为审批人。
      • :不允许选择当前用户作为审批人。

表单布局

用于设置“设置参与者”组件的排列方式,以便更高效、清晰地展示和收集用户信息。目前支持以下三种布局方式,默认采用 “一列布局”

  • 一列布局:将表单元素从上到下依次排列在单一列中。适用于表单字段数量较少,或者字段之间逻辑联系紧密、需要用户按顺序依次处理的情况。
  • 二列布局:将表单元素分为左右两列进行排列。适用于表单字段数量适中,且字段可以合理分组的情况。例如,将相关的个人信息字段放在一列,联系方式字段放在另一列,有助于用户对表单内容进行分类和理解。
  • 三列布局:将表单元素分布在三列中。适用于表单字段较多且较为复杂的场景,例如一些需要收集大量详细信息的注册表单、调查问卷等。

×

自定义输入内容校验规则

为了确保用户输入的数据符合特定的格式和要求,允许用户根据具体业务需求,灵活设置输入内容的校验规则,有效防止用户输入无效或不规范的信息。例如审批人允许为邮箱格式,则可以设置为如下校验规则。

^[-_a-zA-Z 0-9\u4E00-\u9FA5]+$|^\w+([-+.]\w+)*@\w+([-.]\w+)*\.\w+([-.]\w+)*$

只读

用于控制“设置参与者”组件的可编辑状态。

  • :允许编辑。
  • :启用后,流程启动时,只显示指定角色下的有效成员,不允许用户编辑。

更多选项类型

属性名

说明

支持变量绑定

禁用

用于控制“设置参与者”组件是否生效。

  • :不禁用“设置参与者”组件。
  • :禁用后,“设置参与者”组件置灰,无法被用户操作。

数据类型

系统自动生成,且不可修改。

×

基本映射配置

属性名

说明

支持变量绑定

输入框用户名关键字映射

用于控制输入框前显示的用户名称。

在流程启动时,系统会根据发起人在输入框中输入的关键字,按照一定的映射规则,从存储的用户信息中筛选出匹配的审批人,并将其名称展示在输入框前,为用户提供直观的选择参考。

输入框用户标识关键字映射

流程启动时,当发起人从输入框前展示的列表中选中某个审批人后,系统传递给后台的关键字。该关键字是后台识别和处理审批人相关业务逻辑的重要依据。

用户信息展示映射

用于配置流程启动时,前端页面中审批人用户列表的显示规则,实现后端数据字段到前端展示内容的智能转换。配置时,您至少需指定2个列字段。如果需要展示更多信息,可以通过单击,按需添加更多列字段。

  • 列字段关键字:用于标识后端接口返回的原始数据字段,例如dept_code。
  • 列字段名:定义审批人用户列表显示的列标题,例如所属部门。

服务定义配置

属性名

说明

支持变量绑定

是否自定义请求

设置是否自定义配置参与者请求。

  • :不配置参与者请求。
  • :自定义配置参与者请求。

用户查询服务

开启“是否自定义请求”后,您可以选择已定义的流程服务编排供用户查询。

请求参数

开启“是否自定义请求”后,您可以进一步设置请求参数。

header参数

开启“是否自定义请求”后,您可以进一步设置header参数。

用户搜索关键字映射

开启“是否自定义请求”后,您可以进一步设置用户搜索关键字映射。

角色名搜索关键字映射

开启“是否自定义请求”后,您可以进一步设置角色名搜索关键字映射。

高级配置

属性名

说明

支持变量绑定

是否渲染

在页面开发中,可能需要根据某些条件来动态显示或隐藏页面中的组件内容,您可以设置此配置项。

  • :关闭渲染。
  • :开启渲染。

循环数据

表示需要循环渲染的数组。当页面存在若干份重复的、动态生成的内容时,您可以在高级面板中自定义循环数据。

迭代变量名

在循环渲染子项对应的变量名,默认为item。

×

索引变量名

循环渲染的索引变量名,默认为index。

×

key

用于标识每个循环项的唯一键值,默认为index。建议根据实际需求选择一个更合适的字段作为唯一标识符,以提高性能和避免潜在问题。

×

相关文档