智能表格数据获取

访问路径：数据功能 -> 企业微信 -> 智能表格数据获取

功能简述

提供获取企业微信智能表格中工作表数据的功能，从而可以实现基于智能表格的数据提取、本地计算、结果发布、数据可视化展示等自动化解决方案。

data-pull

任务配置

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

功能调用

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

企微应用：拥有访问智能文档权限的自建应用
智能表格ID：唯一标识智能表格文档的ID，初始运行时可以为空，系统会自动创建。创建完成后，需要从日志中获取该ID值，并更新回当前栏位，后续将针对该智能表格进行持续更新，否则每次调用都将创建新的智能表格。 注意：该ID不能丢失，如果丢失，将不能再通过API接口自动同步该表单内的内容，而且腾讯客服也不支持后台查询该ID的服务。
智能表格名称：智能表格的文件名称。初次创建时，因为没有ID，系统会基于该文件名创建一个新的智能表格，并在日志中返回ID。后续将使用ID来访问文档。
工作表名：数据将同步到的工作表名称，如果该表名不存在，系统将自动创建。
批次推送记录数：每次调用时获取的记录数，可以根据智能表中栏位数多少，适当调整批次获取的记录数，确保每次传送的数据量不至于太大。
查询模式：用于设置多个查询条件的组合关系
- 独立：只要满足一条记录即可
- 组合：满足所有条件的记录

表格字段类型提取关系

需要建立本地数据表格和在线智能表格字段的对应关系，针对字段类型按下述匹配关系进行匹配。

data-pull

智能表格栏位类型	字段类型	来原字段	案例
系统记录ID		record_id	roNtFb
创建时间		create_time	2026/4/19 18:35:52
创建人		creator_name	张三
最后修改时间		update_time	2026/4/19 18:35:52
最后修改人		updater_name	张三
人员	字符串	字段名称	A001;A002
单选	text	字段名称	北京
单选	JSON	字段名称_JSON	如下：单选JSON
多选	text	字段名称	北京;上海
多选	JSON	字段名称_JSON	如下：多选JSON
货币	numeric	字段名称	23.3
数字	numeric	字段名称	23.4
百分比	numeric	字段名称	30
进度	numeric	字段名称	30
文本	text	字段名称	你好
邮件地址	text	字段名称	support@flyenter.com
条码	text	字段名称	123456
电话	text	字段名称	12312272625
自增字段	text	字段名称	2
复选框	text	字段名称	True
日期	datetime	字段名称	2026/4/19 0:00:00
文件	text	字段名称	CNKI.enw;CNKIKK.enw
文件	JSON	字段名称_JSON	如下：附件JSON
图片	text	字段名称	130R2115157-0.jpg;150125104431-1.jpg
图片	JSON	字段名称_JSON	如下：图片JOSN
群聊	text	字段名称	业务沟通群名
群聊	JSON	字段名称_JSON	如下：群聊JSON
地理位置	text	字段名称	中国上海市上海市
地理位置	JSON	字段名称_JSON	如下：地理位置JSON
链接	text	字段名称	http://www.flyenter.com
链接	JSON	字段名称_JSON	如下：链接JSON

表格字段JSON类型案例

如果希望能提取特定字段的完整信息，可以选择对应的JSON类型字段，并在字段名称后加上后缀_JSON，这样系统会以及JSON格式赋值，并含有该字段的完整信息。

下述为系统支持的JSON类型的字段类型：

单选JSON

[{"id":"o84Ciu","text":"北京"}]

多选JSON

[{"id":"o84Ciu","text":"北京"},{"id":"oybpuL","text":"上海"}]

图片JOSN

[
	{
		"id": "1776595152598-f4e14e64e7336b2d",
		"image_url": "https://wdcdn.qpic.cn/Mxxx156?w=1920&h=1200",
		"title": "130R2115157-0.jpg",
		"height": 1200,
		"width": 1920
	},
	{
		"id": "1776595157835-6c486037e5783930",
		"image_url": "https://wdcdn.qpic.cn/MTY4xxx162?w=2880&h=1800",
		"title": "150125104431-1.jpg",
		"height": 1800,
		"width": 2880
	}
]

地址位置JSON

{
	"id": "",
	"title": "中国上海市上海市",
	"latitude": 31.23037,
	"longitude": 121.4737,
	"source_type": 1
}

附件JSON

[
	{
		"doc_type": 2,
		"file_ext": "enw",
		"file_type": "Wedrive",
		"file_url": "https://drive.weixin.qq.com/s?k=AE4AggdjAA8txwUB7eAAcAjgbdALY",
		"name": "CNKI-20260406222331252.enw",
		"size": 221.0
	}
]

群聊JSON

{
	"id": "ENCN4R8qA1yuGALhGJVbZRYwo",
	"icon": "https://wework.qpic.cn/wwpic3az/891351_SGLEEOiiQ2O0DnP_1743072169/0",
	"is_extern": false,
	"join_url": "https://work.weixin.qq.com/m/roomCode_asxbaAnv645b26j9?bar_style_type=5",
	"name": "业务沟通群",
	"qrcode_url": "https://wework.qpic.cn/wwpic3az/907211_W-3X1IyCQQyWhsH_1776595144/0",
	"vcode": "roomCode_asxbaAnv645b26j9"
}

链接JSON

{
	"link": "http://www.flyenter.com",
	"text": "近咖",
	"type": "url"
}

功能简述​

任务配置​

功能调用​

表格字段类型提取关系​

表格字段JSON类型案例​

单选JSON​

多选JSON​

图片JOSN​

地址位置JSON​

附件JSON​

群聊JSON​

链接JSON​