Skip to main content

智能表格数据同步

访问路径:数据功能 -> 企业微信 -> 智能表格数据同步

功能简述

提供向企业微信智能表格同步数据的功能,从而可以实现基于智能表格的数据发布、数据报表分析等功能的自动更新的目的。

Smart Sheet

配置任务脚本

如果没有配置数据源的话,默认读取的是当前工作库的内容。如果指定了,则会读取指定数据源数据。任务脚本中提供的是SQL查询脚本,系统会将该查询结果同步到智能表格。
注:查询结果的字段名和智能表格中的列名需要保持一致。智能表格中缺失的栏位,系统在同步数据前会自动补齐。同时,智能表格中多余的栏位不会受到影响。

功能调用

系统基于特定的企业微信自建应用来访问智能表格。(需要先配置该应用对智能表格API接口的访问权限)

  • 企微自建应用:拥有访问智能文档权限的自建应用
  • 智能表格ID:唯一标识智能表格文档的ID,初始运行时可以为空,系统会自动创建。创建完成后,需要从日志中获取该ID值,并更新回当前栏位,后续将针对该智能表格进行持续更新,否则每次调用都将创建新的智能表格。 注意:该ID不能丢失,如果丢失,将不能再通过API接口自动同步该表单内的内容,而且腾讯客服也不支持后台查询该ID的服务。

Doc Id

  • 智能表格名称:智能表格的文件名称。初次创建时,因为没有ID,系统会基于该文件名创建一个新的智能表格,并在日志中返回ID。后续将使用ID来访问文档。
  • 工作表名:数据将同步到的工作表名称,如果该表名不存在,系统将自动创建。
  • 更新模式:
    • 全量更新:每次同步数据前,会清空表格中原有内容,再上传新数据。
    • 增量更新:在不改变现有数据的前提下,追加新查询出来的数据集合。
  • 表格管理员ID:初次创建时,用来设置文档管理员的企业微信员工UserID/注册手机号。最多支持3个管理员,多个ID信息使用分号进行分割。
  • 管理员ID类型:用于澄清上述提供的管理员ID是UserID,还是注册时提供的手机号码。

注:如果初次更新时,忘记提供管理员ID,则需要企业微信管理员登录后台,手工添加文档管理员:协作 -> 文档 -> 文档管理工具 -> 应用文档管理 -> 查看。 再选择当前使用的企业微信应用,即可查询由该应用创建的所有文档,并手工添加文档管理员。

WeComm Doc