工作流表单对接开发指南

1. 表单字段信息获取

通过轻易云数据集成平台对接OA系统工作流时，首先需要获取目标表单的字段结构。访问接口域名/api/workflow/reqform/loadForm可获取完整的表单元数据，该接口返回的数据包含主表字段（main）和明细表字段（detail_1）的结构定义。

2. 字段结构解析

在返回的JSON数据中，关键字段说明如下：

• tableInfo：包含主表和明细表的结构定义
• fieldinfomap：字段属性映射表
• fieldid：前端提交时的字段标识符
• fieldlabel：前端显示名称
• fieldname：后端数据库存储字段名

3. WebService请求规范

通过轻易云平台提交工作流申请时，需按照以下JSON格式构造请求体。平台会自动处理字段映射和数据类型转换：

{
    "workflowBaseInfo":{
        "workflowId":"38"
    },
    "requestName":"测试流程",
    "requestLevel":"1",
    "creatorId":"14720",
    "workflowMainTableInfo":{
        "requestRecords":[
            {
                "workflowRequestTableFields":[
                    {
                        "fieldName":"yzgsmc",
                        "fieldValue":"测试公司"
                    }
                ]
            }
        ]
    }
}

4. 数据提交与捕获

使用轻易云数据监听器可以实时捕获OA系统提交的原始数据包，包含以下关键参数：

• workflowid：流程模板ID
• requestid：流程实例ID
• creatorId：创建人ID

5. 适配器配置

轻易云平台提供专用适配器简化对接：

• DoCreateWorkflowRequestAdapter：自动化流程创建
• WeaverE9V2QueryAdapter：实时查询流程状态

6. 流程实例创建

通过轻易云可视化配置界面，可快速生成测试流程实例。成功创建后将获得：

• workflowid：流程模板ID（如377）
• creatorId：测试用户ID

7. 流程数据查询

使用轻易元数据探查功能，可获取已提交流程的完整字段信息。关键操作包括：

1. 通过getWorkflowRequest接口查询实例数据
2. 解析返回的metadata结构
3. 映射字段到目标系统

8. 完整对接流程

轻易云平台提供端到端的对接方案：

1. 系统认知：自动识别OA系统版本和接口规范
2. 流程建模：可视化配置字段映射关系
3. 数据同步：建立实时数据通道
4. 监控运维：提供全链路日志追踪

通过轻易云平台的智能映射引擎，企业可将传统OA工作流与现代业务系统无缝集成，典型实施周期缩短60%以上。