有奖捉虫:办公协同&微信生态&物联网文档专题 HOT
BI 支持接入您在腾讯文档上的在线表格数据,以用于报表配置。具体使用流程如下:

新建腾讯文档数据表

1. 数据 > 数据表模块中,单击新建数据表。n


2. 首次使用需要进行授权以拉取您的腾讯文档,单击授权按提示进行扫码授权即可。n


3. 授权后,您可以选择“输入 URL”或者直接在“我的文档”中指定要接入的腾讯文档。若您登录错账号,可单击底部的切换账号,将回到未授权状态,此时可重新授权。n


4. 若选择 URL 方式,您可以在输入框中粘贴腾讯文档的 URL,输入后单击下一步(当前版本仅支持微信、QQ 登录的文档接入,暂不支持企业微信登录的文档接入)。n


5. 若选择我的文档方式,将拉取当前登录账号下,具有查看权限的在线 Excel 文件。您可通过单击的形式,指定某个 Excel 文件中的某个 sheet。同时,我们还提供了对文档名称的搜索能力,助您快速找到对应文档。n


6. 指定好某个 sheet 后,底部下一步按钮将亮起,此时可单击进行下一步。若您进入错了文档,可单击文档上方的面包屑返回。n


7. 在接入界面底部,我们提供了格式要求说明,方便您了解接入文档时的一些格式要求,具体格式要求如下:
将以第一行作为字段名称,标题为空的列将不会被添加;
若时间被 BI 识别为数值或字符,建议手动更改为对应格式。若时间为 YYYY/MM/DD HH:MM:SS 且未在文档设置时间格式,预览时会乱码,此时在 BI 选择对应时间格式建表后可正常使用。 详见 腾讯文档时间格式
时间可以只有日期如2021、2021/04、2021/04/31,不能只有后半部分如13:00:00,否则将返回乱码;
单元格不能合并,否则只能取得合并单元格的第一行数据,其他行将为空值;
若表格中有计算公式,请先在腾讯文档将单元格粘贴为数值,否则会直接返回空值而不是计算结果;
将包含隐藏和过滤的单元格;
若数值型字段中存在非数值型的单元格数据,将转为空值处理。
8. 单击下一步后,我们将进行字段的配置。这里的参数说明如下:
显示名称:指数据表在 BI 上显示的名称。
所属文件夹:数据表所属的文件夹。
字段中文名:字段在 BI 上展示的名称,默认为文档的首行内容。
字段类型:若您在腾讯文档对该列设置了格式,则默认值为设置的格式。若未设置,我们将根据内容智能判断。若判断与实际有差入,例如时间被判断为数值或字符格式,强烈建议您手动调整格式,方便后续报表配置。n


9. 单击确认后,则建表成功,此时接入的腾讯文档可用于报表的配置。

n



自动更新腾讯文档

当您接入腾讯文档后,BI将支持每分钟自动更新文档数据,以及时同步您在腾讯文档上做的修改。

适用的场景有:
当您在使用报表进行汇报前,发现数据有误,此时可以直接使用手机腾讯文档进行修改,修改后,使用BI制作的报表将自动进行变更
当您的数据产生了增加,需要在腾讯文档需要新增几行数据。新增后,使用BI制作的报表也会自动进行变更
当出现以下情况时,自动更新将暂停:
当您接入的腾讯文档结构发生变化(例如新增列或者减少列),则自动更新将暂停
当您接入的腾讯文档被删除,或者您的不具备该文档的查看权限,则自动更新将暂停

手动更新腾讯文档

若您对已建好的腾讯文档,有跨文档或者新增/删除列的数据更新等需求,可在列表页通过“更新”操作手动进行更新。


n更新方式分为“追加”和“替换”两种。n

n追加指在原有数据上进行新增,需保证追加表的“列标题”与被追加表的“字段显示名”完全一致。例如原先数据有50行,新的文档有60行数据,则追加后共有50+60=110行数据。如果您需要新增的数据在另一个在线 Excel 中,建议选择“追加”模式。如果在同一个在线 Excel,建议选择“替换”模式,避免产生重复数据。

替换指将完全替换原有数据!替换表无需与原表结构一致,可用于增加或删除列等场景,例如原来的数据有5列,需要新增1列到6列,此时可以将6列的文档用替换方式进行更新。若数据表已进行报表配置,不建议删除列,避免被删除的列已用于报表配置导致报表报错。

腾讯文档时间格式

由于腾讯文档的时间格式多种多样,不同格式的时间接入到 BI 会有不同的处理逻辑,此章节对此进行说明。n首先建议对于时间、日期的列,提前在文档中如下图所示,设置恰当的时间日期格式。提前设置好接入到 BI 时,BI 便能读取设置的格式,方便后续配置。

n

n若您未在文档中设置时间日期格式,则 BI 将根据内容自动推断。若部分内容识别为数值或字符,建议手动更改为对应格式,例如2022是年份,但是 BI 会识别是数值,请手动更改为“时间-YYYY 格式”。受文档能力限制若您的时间为 YYYY/MM/DD HH:MM:SS,且未在文档设置时间日期格式,在 BI 上接入预览时会乱码,此时手动更改为“时间 YYYY-MM-DD HH:MM:SS”,保存后再查看则不会乱码可正常使用。n