表单

Traduction en coursCe guide est actuellement disponible en chinois simplifié. Une version traduite sera ajoutée ultérieurement.

任务表单决定用户在创建、查看或办理任务时看到哪些字段。一个 Task Type 只有 Create、Edit 和 View 三个表单位置；审批等办理场景使用绑定在工作流连线上的 Transition Form（流转表单）。

1. 设计表单集合

先按场景拆分表单，而不是把所有用户都放进同一张可编辑表单。采购案例使用：

Form	绑定位置	使用者与目的
purchaseCreate	Task Type · Create / Edit Form	Applicant 创建或编辑采购申请
purchaseView	Task Type · View Form	有查看权限的用户只读查看申请、审核结果和审核意见
managerReview	Department Review · Transition Form	Department Manager 填写部门审核意见
financeReview	Finance Review · Transition Form	Finance Approver 查看部门结果并填写财务审核意见

Forms 列表可以维护任意数量的表单资产，但这不代表 Task Type 会出现更多表单类型。Task Type 始终只有 Create、Edit、View 三个位置；其他表单必须被工作流流转或页面控件明确引用。

2. 创建表单

1. 进入 Task Configuration → Forms。
2. 点击 New Form。
3. 填写 Name、Category 和 Description。
4. 保存后点击 Configure 进入表单设计器。

Forms 列表展示采购案例的四个表单和 Configure 操作。images/pd-forms-list-01.webp

截图待补充

3. 配置布局

表单设计器支持标签页和列布局。推荐步骤：

1. 新建或重命名标签页。
2. 选择每个区域的列数。
3. 将系统字段和自定义字段拖入画布。
4. 调整字段顺序和宽度。
5. 配置 Label、Required、Read Only、Hidden 和 Show When Empty（空值时显示）。
6. 保存表单。

普通业务表单建议使用一至两列；字段关联紧密且显示空间足够时再增加列数。长文本、Rich Text、附件和子表单通常占整行更易阅读。

表单设计器展示标签页、字段库、两列画布以及右侧字段属性配置。images/pd-forms-designer-02.webp

截图待补充

4. 创建采购表单

purchaseCreate

• Title、Applicant Department、Amount、Category、Required Date：必填。
• Reason：必填并占整行。
• Attachments：可选并占整行。

purchaseView

• 原申请字段、Department Review Result、Department Review Comment、Finance Review Result 和 Finance Review Comment 均只读。
• 可展示系统状态、当前处理人、创建时间和更新时间。
• 它是统一任务详情，不承担审批输入。

managerReview

• 原申请字段只读。
• Department Review Comment 可编辑，并按业务需要设为必填。
• Department Review Result 不允许手工编辑，由 Approve / Reject 流转的 Set Task Field 自动写入。
• 不在表单中伪造 Approve / Reject 按钮；按钮来自绑定该表单的工作流流转。

financeReview

• 原申请字段、Department Review Result 和 Department Review Comment 只读。
• Finance Review Comment 可编辑，并按业务需要设为必填。
• Finance Review Result 不允许手工编辑，由 Approve / Reject 流转的 Set Task Field 自动写入。
• 不在表单中伪造 Approve / Reject 按钮。

5. 绑定表单

• 在 Task Type 中绑定 Create、Edit、View Form。
• 在 Workflow 中选中人工节点的离开连线，在右侧 Transition Form 选择对应审核表单；Approve 和 Reject 流转可以引用同一张审核表单。
• 为每条审批流转配置审核意见必填校验，避免只打开表单却提交空意见。
• 在 Approve / Reject 流转的 Functions 中分别使用 Set Task Field 写入 Approved / Rejected；不要让审批人手工选择结果。
• 页面设计器中的 Task Form 需要关联已配置并发布的任务表单。

表单资产只是布局定义。没有绑定到 Task Type、Workflow Transition 或 Task Form 控件的表单不会自动出现在运行页面。

6. 验证表单

在 DEV 预览或 TEST 运行时分别验证：

1. Applicant 可以填写创建表单。
2. Department Manager 点击 Approve / Reject 后打开 managerReview，只能填写部门审核意见；提交后 Department Review Result 自动变为 Approved / Rejected。
3. Finance Approver 点击 Approve / Reject 后打开 financeReview，能看到部门结果并填写财务审核意见；提交后 Finance Review Result 自动变为 Approved / Rejected。
4. purchaseView 能展示两级审核结果和意见，但不允许改变业务数据。
5. 必填、隐藏和只读状态与节点操作一致。

7. 常见问题

字段拖不进表单：确认选中的是 Task Form 配置画布，字段已保存且当前版本可编辑。

表单运行时很空：检查字段是否已经放入可见标签页、是否全部 Hidden，以及 Task Type 或节点操作是否绑定了正确表单。

改了表单但 TEST 没变化：DEV 修改不会自动进入 TEST，需要发布包含该表单变更的新版本。

下一步

• 创建步骤库
• 构建工作流
• 关联页面设计器