跳到主要内容

字段

字段保存任务的业务数据，并可用于表单、流程条件、任务列表和 TQL 查询。字段分为系统字段和自定义字段。

1. 系统字段与自定义字段​

系统字段由 Spark 提供，例如 Title、Description、Assignee、Status、Task Level、Task Tag、Department、Plan Start Time 和 Plan Finish Time。它们可以按支持范围放入表单或用于查询，但不能像普通自定义字段一样删除。

自定义字段用于当前应用独有的业务信息。采购案例只创建 Applicant Department、Amount、Category、Required Date、Reason 和 Attachments，不重复创建标题、状态、创建人等系统信息。

Fields 列表展示系统字段与自定义字段分组，以及字段类型、分类和操作。images/pd-fields-list-01.webp
截图待补充

2. 创建字段​

  1. 进入 Task Configuration → Fields。
  2. 点击 New Field。
  3. 填写 Label，选择 Field Type 和 Category。
  4. 按需填写 Default Value 和 Description。
  5. 完成类型专属配置并保存。

字段保存时，系统会自动生成用于持久化、查询和流程表达式的 Field Key，用户不需要填写。后续配置流程条件、处理人规则或 TQL 时，应从编辑器候选项选择对应字段，不要手写或根据 Label 猜测 Key。

3. 常用字段类型​

类型适用数据常见配置
Text / Text Area短文本、原因、备注默认值、长度或显示方式
Rich Text / Markdown格式化说明编辑与展示方式
Number金额、数量、评分单位
Select / Radio Group单选枚举选项列表
Multi Select多选枚举选项列表
User申请人、协作人单/多选、部门范围
Department申请部门部门选择
Attachment / Group Image文件或图片数量、类型等附件规则
Switch二元状态选中和未选中文案
Date / DateTime日期和时间日期格式与行为
Sub Form重复的结构化明细子表单字段
Node Handler流程节点处理人引用来源步骤

实际可选类型由当前插件和版本决定。隐藏的高级或兼容类型不应作为普通字段类型使用，除非系统已在界面中明确开放。

4. 采购字段配置​

Label类型建议设置
Applicant DepartmentDepartment必填
AmountNumber必填，单位 CNY
CategorySelectHardware、Software、Service
Required DateDate必填
ReasonText Area必填
AttachmentsAttachment可选
字段类型配置展示 Number 的单位、Select 的选项，以及 Attachment 的规则配置。images/pd-fields-type-config-02.webp
截图待补充

5. User 字段的部门范围​

User 字段可按当前实现选择弹窗选择器、单选或多选，并限制候选人的部门范围。部门范围可能来自：

  • 不限制部门
  • 固定部门
  • 表单中的 Department 字段

如果选择表单字段作为范围，请确认该 Department 字段在用户选择前已有值，并按业务需要决定是否包含子部门。

6. 字段可见性与查询​

  • 是否显示由表单中的 Hidden、Read Only、Required 和 Show When Empty（空值时显示）配置共同决定。
  • 是否能被 TQL 查询取决于字段能力和搜索配置。
  • 是否出现在任务列表列候选项取决于字段的列表能力。
  • 工作流条件引用字段时，应从编辑器候选项选择并通过语义校验。

7. 常见问题​

字段在表单设计器中不可用：确认字段已经保存、属于当前版本，并且表单分类和字段能力允许使用。

字段不能用于 TQL：检查字段是否支持搜索，并通过 TQL 补齐确认真实字段引用，不要手写猜测格式。

附件字段上传失败：先验证当前环境的附件存储配置；附件字段本身只保存附件引用，不负责配置存储提供者。

下一步​

最后于 更新