飞书审批集成配置指南

核心组件说明

• 查询适配器：\Adapter\FeiShu\FSApprovalQueryAdapter
• 执行适配器：\Adapter\FeiShu\FSApprovalExecuteAdapter
• 关键API资产：
  • 查询飞书审批
  • 创建飞书审批
• 管理入口：
  • 飞书PC端后台
  • 飞书开放平台
  • 官方API文档
• 参考方案：轻易云示例方案

表单配置流程

1. 表单设计入口定位

2. 控件ID获取技巧

   关键操作：在地址栏追加&devMode=on参数激活开发者模式，即可显示自定义ID输入框

3. 关键参数获取

   • 员工编码：通过成员管理界面获取
   • 表单ID：从设计界面地址栏提取

应用配置规范

1. 自建应用创建

2. 权限配置要点

   • 必须开启审批相关API权限
   • 发布应用后权限配置才会生效

字段映射规范

1. 基础字段配置

   {
      "id": "widget1",
      "type": "input",
      "value": "data"
   }

   

2. 特殊字段处理

   • 电话字段：需分离国家码和号码

     {
      "id":"widget1",
      "type":"telephone",
      "value": {
          "countryCode":"+86",
          "nationalNumber":"13122222222"
      }
     }

   • 部门字段：需使用open_id标识

     {
      "id":"widget1",
      "type":"department",
      "value":[{"open_id":"od-xxx"}]
     }

3. 复杂字段配置

   • 明细控件：需构建二维数组结构

     {
      "id": "widget1",
      "type": "fieldList",
      "value": [[{"id":"widget1","type":"checkbox","value":["jxpsebqp-0"]}]]
     }

   • 附件/图片：需提供完整文件信息数组

     [{
      "fileName": "测试文件1.txt",
      "filePath": "/path/to/file.txt"
     }]

技术提示：轻易云平台通过智能字段映射引擎，可自动处理90%以上的字段类型转换，显著降低配置复杂度。对于特殊字段，平台提供可视化解析器配置界面，支持正则表达式、JSONPath等高级数据处理功能。