飞书审批配置教程一、基础信息查询适配器：\Adapter\FeiShu\FSApprovalQueryAdapter 目标适配器：\Adapter\FeiShu\FSApprovalExecuteAdapter 查询APi资产：查询飞书审批写入API资产：创建飞书审批飞书pc端管理后台：链接地址飞书开放平台后台：链接地址飞书接口文档：链接地址轻易云平台示例方案：方案链接地址二、飞书信息获取操作表单设计位置表单控件ID设置此时你会发现这个表单设计界面没有接口文档需要的控件id字段信息，这个时候就需要在地址栏后面加上&devMode=on，加上后再重新打开就会发现在右边栏里面出现了自定义ID这个输入框员工编码获取表单ID获取打开表单设计界面找到地址栏新增自建应用以及获取连接信息创建应用获取链接信息开启应用权限应用发布由于飞书限制，有些权限必须是应用发布后才可以开启权限，还有当前改动的配置也是发布应用后才生效，记得申请后联系企业管理员通过审核才算发布成功官方教程链接三、请求调度者配置四、写入调度者配置在轻易云配置的每个控件字段都要包含form 文本控件、多行文本控件、日期控件（时间传长日期即可）、单选控件、数字控件、金额控件、计算公式控件，都按照下面格式配置即可官方： { "id": "widget1", "type": "input", "value": "data" } 轻易云：电话控件 value留空，countryCode和nationalNumber配置在外面官方： { "id":"widget1", "type":"telephone", "value": { "countryCode":"+86", "nationalNumber":"13122222222" } } 轻易云：联系人控件、关联审批控件、多选控件、 open_ids和value二选一，open_ids是传当前用户在当前应用下的唯一标识（通过接口查询获得），value是传user_id（上文有获取方式），无论单个还是多个，传值的字段都必须开解析器,多个就用,隔开。官方： { "id":"widget1", "type":"contact", "value": ["f8ca557e"], "open_ids": ["ou_12345"] } 轻易云：解析器： { "name": "StringToArray", "params": "," } 部门控件 open_id是当前应用下的部门唯一值，可以通过查询部门的接口获取到，在轻易云里面将open_id填在value字段上。切记无论单个还是多个，传值的字段都必须开解析器 , 多个就用 , 隔开。官方： { "id":"widget1", "type":"department", "value":[ { "open_id":"od-xxx" } ] } 轻易云：日期区间控件将start和end和interval的值配置在和value同级，代码会自动处理成官方格式，value字段留空。官方： { "id": "widget1", "type": "dateInterval", "value": { "start":"2019-10-01T08:12:01+08:00", "end":"2019-10-02T08:12:01+08:00", "interval": 1.0 } } 轻易云：明细控件多行分录类型的value字段必须要配上数组的key，里面字段正常取值即可。官方： { "id": "widget1", "type": "fieldList", "value": [ [ { "id": "widget1", "type": "checkbox", "value": ["jxpsebqp-0"] } ] ] } 轻易云：效果：附件控件原平台必须要有一个下载后返回一个包含附件完整名称和下载路径的二维数组，然后目标平台按照原平台的数组配置即可。原平台附件信息数组要求： [ { "fileName": "测试文件1.txt", "filePath": "/www/wwwroot/service/public/uploadFile/2023-1-4/测试文件1.txt" }, { "fileName": "测试文件2.txt", "filePath": "/www/wwwroot/service/public/uploadFile/2023-1-4/测试文件2.txt" } ] 官方： { "id":"widget1", "type":"department", "value":[ { "open_id":"od-xxx" } ] } 轻易云：图片控件原平台必须要有一个下载后返回一个包含图片完整名称和下载路径的二维数组，然后目标平台按照原平台的数组配置即可。原平台附件信息数组要求： [ { "fileName": "测试图片1.png", "filePath": "/www/wwwroot/service/public/uploadFile/2023-1-4/测试图片1.png" }, { "fileName": "测试图片2.png", "filePath": "/www/wwwroot/service/public/uploadFile/2023-1-4/测试图片2.png" } ] 官方： { "id":"widget1", "type":"image", "value": ["D93653C3-2609-4EE0-8041-61DC1D84F0B5"] } 轻易云：

飞书审批配置教程

轻易云_陈锐勤

飞书审批配置教程

一、基础信息

查询适配器：\Adapter\FeiShu\FSApprovalQueryAdapter
目标适配器：\Adapter\FeiShu\FSApprovalExecuteAdapter
查询APi资产：查询飞书审批
写入API资产：创建飞书审批
飞书pc端管理后台：链接地址
飞书开放平台后台：链接地址
飞书接口文档：链接地址
轻易云平台示例方案：方案链接地址

二、飞书信息获取操作

表单设计位置

表单控件ID设置

此时你会发现这个表单设计界面没有接口文档需要的控件id字段信息，这个时候就需要在地址栏后面加上&devMode=on，加上后再重新打开就会发现在右边栏里面出现了自定义ID这个输入框

员工编码获取

表单ID获取

打开表单设计界面找到地址栏

新增自建应用以及获取连接信息

创建应用
获取链接信息
开启应用权限
应用发布
由于飞书限制，有些权限必须是应用发布后才可以开启权限，还有当前改动的配置也是发布应用后才生效，记得申请后联系企业管理员通过审核才算发布成功官方教程链接

三、请求调度者配置

四、写入调度者配置

在轻易云配置的每个控件字段都要包含form

文本控件、多行文本控件、日期控件（时间传长日期即可）、单选控件、数字控件、金额控件、计算公式控件，都按照下面格式配置即可

官方：
```
  {                                     
      "id": "widget1",
      "type": "input",
      "value": "data"
  }
```
轻易云：

电话控件
value留空，countryCode和nationalNumber配置在外面

官方：

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

轻易云：

联系人控件、关联审批控件、多选控件、

open_ids和value二选一，open_ids是传当前用户在当前应用下的唯一标识（通过接口查询获得），value是传user_id（上文有获取方式），无论单个还是多个，传值的字段都必须开解析器,多个就用,隔开。

官方：
```
  {
      "id":"widget1",
      "type":"contact",
      "value": ["f8ca557e"],
      "open_ids": ["ou_12345"]
  }
```
轻易云：

解析器：
```
  {
    "name": "StringToArray",
    "params": ","
  }
```

部门控件

open_id是当前应用下的部门唯一值，可以通过查询部门的接口获取到，在轻易云里面将open_id填在value字段上。切记无论单个还是多个，传值的字段都必须开解析器 , 多个就用 , 隔开。

官方：
```
  {
      "id":"widget1",
      "type":"department",
      "value":[
          {
              "open_id":"od-xxx"
          }
      ]
  }
```
轻易云：

日期区间控件

将start和end和interval的值配置在和value同级，代码会自动处理成官方格式，value字段留空。

官方：

  {
      "id": "widget1",
      "type": "dateInterval",
      "value": {
           "start":"2019-10-01T08:12:01+08:00",
           "end":"2019-10-02T08:12:01+08:00",
           "interval": 1.0
       }
  }

轻易云：

明细控件

多行分录类型的value字段必须要配上数组的key，里面字段正常取值即可。

官方：

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

轻易云：

效果：

附件控件

原平台必须要有一个下载后返回一个包含附件完整名称和下载路径的二维数组，然后目标平台按照原平台的数组配置即可。

原平台附件信息数组要求：

  [
      {
          "fileName": "测试文件1.txt",
          "filePath": "/www/wwwroot/service/public/uploadFile/2023-1-4/测试文件1.txt"
      },
      {
          "fileName": "测试文件2.txt",
          "filePath": "/www/wwwroot/service/public/uploadFile/2023-1-4/测试文件2.txt"
      }
  ]

官方：

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

轻易云：

图片控件

原平台必须要有一个下载后返回一个包含图片完整名称和下载路径的二维数组，然后目标平台按照原平台的数组配置即可。

原平台附件信息数组要求：

  [
      {
          "fileName": "测试图片1.png",
          "filePath": "/www/wwwroot/service/public/uploadFile/2023-1-4/测试图片1.png"
      },
      {
          "fileName": "测试图片2.png",
          "filePath": "/www/wwwroot/service/public/uploadFile/2023-1-4/测试图片2.png"
      }
  ]

官方：

  {
      "id":"widget1",
      "type":"image",
      "value": ["D93653C3-2609-4EE0-8041-61DC1D84F0B5"]
  }

轻易云：

轻易云

一、文档集成

推荐方式：品质系统提供文件列表 API 查询，轻易云定时查询文档变化。

1.1 提供文档列表查询接口（推荐）

可以根据：目录 ID+最近更新时间+分页参数，查询文件列表请求参数

请求参数示例

{
  "folder":"文件夹",
  "modify":"2023-12-12 11:00:00",
  "page":1,
  "pageSize":10
}

响应参数示例

{
  "data":[
    {
      "name":"名称",
      "type":"文件/文件夹", // 用来区分类型是文件还是下级子文件夹
      "modify":"修改时间",
      "downloadUrl":"下载路径", // 可以根据该下载URL去完成下载
      "version":"1.0" // 版本号
    }
  ]
}

二、单点登录授权

与之前蓝凌 OA 集成逻辑保持一致。

2.1 轻易云提供知识库分享地址

例如： https://aigc.by-health.com/pc/sso/29381728/?1=1&oaLoginName={用户登录信息密文}

注意：轻易云可以根据不同的文件夹目录提供不同的 URL 地址。对应也是不同的知识库，可以方便品质系统进行权限鉴定。轻易云本身不需要存储权限相关内容。

2.2 品质系统嵌入

品质系统生成当前已登录用户的密文信息，和 2.1 的 URL 进行字符串拼接。然后在品质系统前端渲染。

2.3 轻易云根据密文获取用户信息

轻易云根据 URL 中的加密信息，调用品质系统开放的验证接口验证用户是否有效，并且返回对应的用户信息。

品质系统需要提供用户验证接口：

请求参数示例：

{
  "oaLoginName": "{用户登录信息密文}"
}

响应参数示例：

{
  "status":true,
  "userId":12,
  "username":"张三",
  ......
}