You need to enable JavaScript to run this app.
导航

飞书表格

最近更新时间2023.05.17 11:05:29

首次发布时间2021.05.25 18:28:53

1. 概述

支持上传飞书表格创建数据集。 开启飞书数据集,需先行完成接入飞书应用中“2. 基础配置”。

2. 快速入门

(1)点击数据准备,选择数据集—新建数据集。

(2)点击选择飞书表格。

(3)填写需要上传的文档链接,点击确定,显示飞书表格信息即完成连接。

3. 功能介绍

数据更新:支持离线数据定时更新

3.1 飞书日期/时间格式处理

由于飞书对日期做了特殊的处理,在导入产品时,需要对日期字段作转化处理,以便在产品可视化查询时正常使用。以下以日期字段为例(yyyy/mm/dd)展示导入飞书表格时,对时间字段进行的处理步骤。

(1)在字段配置中,编辑日期字段的表达式

(2)修改字段表达式为: toDate((`日期` * 86400000 - 2209190400000)) 注:`日期` 为示例数据集中日期字段的模型字段名。实际操作中建议直接点击左侧"模型字段"中的对应字段进行字段引用。

(3)进行下一步配置和保存即可。

如字段为时间字段(yyyy/mm/dd hh:mm:ss),字段名为"时间",仅需将上述第2步的转化表达式更改为: toDateTime((`时间` * 86400000 - 2209190400000)) 即可

3.2 注意事项

  • 填写的链接,扫码者需要有读权限;

  • 填写一个链接,会把该文档下所有sheet都导入;

  • 只支持普通电子表格的识别;

  • 文档需命名,不能是“未命名表格”,文档和sheet名字不要包含英文的点号'.',否则可能会导致文档schema获取失败;

  • 只会读取第一组列名连续不为空的列;第一列列名不能为空,否则会报错;

  • 列名尽量是一个普通文本,不能以数字开头,不能是图片、超链接,不能命名为p_date,不要包含$,`(反引号),!,否则可能会同步失败;创建数据集之后飞书表格的列名不要随便修改,否则会导致同步失败。列名太长可能会同步失败;

  • 列名不应重复;

  • 行尽量不要为空,全为空的行,因为计入到sheet的行数里面,也会以类似[null,null,null,null]的格式加入到数据里;

  • 不支持合并单元格的处理,不支持公式的处理;

  • 一列里尽量不要有不同数据类型,否则可能会导致同步失败。

3.3 常见报错原因

连接信息有误。

  • 链接不合法
  • 无权限
  • 未命名表格
  • token 过期
  • schema 出错
  • 第一列列名为空
  • 列名格式不合法

说明:如果您出现以上问题并未覆盖的报错提示,请你联系 CSM 或发起售后服务咨询。