1. 概述
1.1 应用场景
公司通过飞书多维表格设计了一套数据填报应用,但数据均在云上,需要通过API接口进行下载数据,并关联目前的应用数据等。
1.2 接口说明
接口文档详情参见:读取多个范围
1.3 实现思路
1)获取访问凭证(access_token)对调用者身份进行鉴权,并设置为参数,便于后续认证使用。
2)使用 获取工作表 接口获取表格sheet_id,便于后续进行接口取数。
3)循环容器滚动取数。
Demo 示例详情参见:https://demo.finedatalink.com/ 「API取数-读取飞书多Sheet表格」任务
2. 操作步骤
2.1 获取 access_token
参考文档获取访问凭证,如下图所示:
设置输出参数 tenant_access_token ,如下图所示:
2.2 获取工作表的 sheet_id
使用 获取工作表 接口获取表格 sheet_id,其中路径参数直接放在 API 的 URL 中即可,如下图所示:
其中 spreadsheetToken 可通过电子表格的 URL 获取。
Hearders 中输入 2.1 节获取的 token ,如下图所示:
将获取的 sheet_id 设置为参数,如下图所示:
2.3 循环取出多 Sheet 表格数据
由于 sheet_id 有多个,因此需要使用循环容器,依次分批将每个 sheet_id 参数传入,使用循环容器,设置遍历对象 sheet_id ,如下图所示:
在循环容器中拖入数据转换,如下图所示:
在数据转换中拖入 API 输入算子,使用 读取多个范围 接口读取表格数据,其中路径参数直接放在 API 的 URL 中即可,设置取数范围,如下图所示:
spreadsheetToken 可通过电子表格的 URL 获取。
取数范围 range 写法可参考 电子表格概述
Hearders 中输入 2.1 节获取的 token ,如下图所示:
点击数据预览即可看到取出的表格数据,如下图所示:
设置 JSON解析,将API数据解析,如下图所示:
即可预览解析好的其中一个 sheet 数据,如下图所示:
注:如果输出的多个 sheet 表字段不同,可以使用输出单个范围接口依次输出。
设置输出位置,如下图所示:
2.4 效果查看
运行任务后,即可看到数据库表中,多个 Sheet 表都合并输出到指定的数据库,如下图所示: