飞书审批配置教程

一、基础信息

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

二、飞书信息获取操作

表单设计位置

表单控件ID设置

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

员工编码获取

表单ID获取

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

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

1. 创建应用

   

2. 获取链接信息

   

3. 开启应用权限

   

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

   

三、请求调度者配置

四、写入调度者配置

在轻易云配置的每个控件字段都要包含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"]
    }

  轻易云：