云之家表单通用解析规则

要解决什么问题

对接云之家审批与表单推送时，同一份表单在接口里会以 widgetMap、detailMap 等形式出现：一边是平台把控件数据推给你的业务系统，一边是你把业务字段写回去发起审批。两套方向若各自猜字段含义，很容易在选项 key、毫秒时间戳、数字用字符串承载等细节上踩坑。

技能如何组织解析与构建

本技能把「推送解析」与「发起审批」明确为同一结构、相反流向：

• 推送解析：widgetMap → 业务字段（读 value、extendFieldMap 等）
• 发起审批：业务字段 → widgetMap（写回控件值，必要时补 personInfo 等附属结构）

顶层 basicInfo 说明事件与实例上下文（如 eventId、formInstId、actionType、dataType 等）。主表按控件 type 分支处理：文本直接读写 value；日期/区间把 Long 时间戳与 Date 互转；numberWidget、moneyWidget 的 value 始终是字符串；单选/多选存的是选项 key 而非展示文案；人员、部门、附件、图片等多为数组，人员控件还需结合 personInfo 还原详情。明细表在 detailMap 中：widgetVos 定义列（与主表控件同构），widgetValue 为行数组，每行以列 codeId 为键。

适用边界与注意点

• 控件类型细表、附件与明细表细节以技能内 references/widget-types.md、file-widget.md、detail-widget.md 为准，实现时按 type 分发即可。
• 构建明细行时 _id_ 可不设；多选、人员、部门、附件、图片的 value 统一按数组处理。
• dataType 区分测试/正式数据，actionType 覆盖到达、同意、提交、删除、废弃、撤回、不同意等动作，解析侧应一并纳入业务判断。