Skip to main content

智能表单同步

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

功能简述

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

Smart Sheet

配置任务脚本

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

功能调用

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

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

Doc Id

  • 表单名称:智能表单的文件名称。初次创建时,因为没有ID,系统会基于该文件名创建一个新的智能表格,并在日志中返回ID。后续将使用ID来访问文档。
  • 页签名称:智能表格内部的数据页签名称。如果没有,系统会自动创建。
  • 更新模式:
    • 全量更新:每次同步数据前,会清空表格中原有内容,再上传新数据。
    • 增量更新:在不改变现有数据的前提下,追加新查询出来的数据集合。
  • 表单用户ID:初次创建时,用来设置文档管理员的企业微信员工ID(工号)。后续数据更新时,不会被再次使用。

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

WeComm Doc