字段
翻訳準備中このガイドは現在、簡体字中国語版のみ提供しています。翻訳版は今後追加されます。
字段保存任务的业务数据，并可用于表单、流程条件、任务列表和 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，不重复创建标题、状态、创建人等系统信息。
images/pd-fields-list-01.webp2. 创建字段
- 进入 Task Configuration → Fields。
- 点击 New Field。
- 填写 Label，选择 Field Type 和 Category。
- 按需填写 Default Value 和 Description。
- 完成类型专属配置并保存。
字段保存时，系统会自动生成用于持久化、查询和流程表达式的 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 Department | Department | 必填 |
| Amount | Number | 必填，单位 CNY |
| Category | Select | Hardware、Software、Service |
| Required Date | Date | 必填 |
| Reason | Text Area | 必填 |
| Attachments | Attachment | 可选 |
images/pd-fields-type-config-02.webp5. User 字段的部门范围
User 字段可按当前实现选择弹窗选择器、单选或多选，并限制候选人的部门范围。部门范围可能来自：
- 不限制部门
- 固定部门
- 表单中的 Department 字段
如果选择表单字段作为范围，请确认该 Department 字段在用户选择前已有值，并按业务需要决定是否包含子部门。
6. 字段可见性与查询
- 是否显示由表单中的 Hidden、Read Only、Required 和 Show When Empty（空值时显示）配置共同决定。
- 是否能被 TQL 查询取决于字段能力和搜索配置。
- 是否出现在任务列表列候选项取决于字段的列表能力。
- 工作流条件引用字段时，应从编辑器候选项选择并通过语义校验。
7. 常见问题
字段在表单设计器中不可用：确认字段已经保存、属于当前版本，并且表单分类和字段能力允许使用。
字段不能用于 TQL：检查字段是否支持搜索，并通过 TQL 补齐确认真实字段引用，不要手写猜测格式。
附件字段上传失败：先验证当前环境的附件存储配置；附件字段本身只保存附件引用，不负责配置存储提供者。