1. 首页
  2. 文档
  3. 企业微信智能表格-添加记录

白皮书下载

实在智能Agent产品白皮书 V.7.3.4.pdf

企业微信智能表格-添加记录

发刊日期:
2025/10/28

编辑团队:
实在学院

一、功能描述

在智能表中给指定工作表添加记录,本组件与下图操作实现效果一致

二、属性说明

组件输入

  • 访问令牌:字符串;企业微信访问令牌access_token,可使用【企业微信智能表格-建立表格连接】组件进行获取
  • 智能表ID:字符串;操作目标智能表ID
  • 工作表ID:字符串;操作目标工作表ID
  • key类型:单选;写入记录的key类型,默认用标题(CELL_VALUE_KEY_TYPE_FIELD_TITLE), 字段 ID (CELL_VALUE_KEY_TYPE_FIELD_ID)
  • 记录列表:列表;记录列表, 每个记录是一个字典,包含字段类型和对应的值;参考记录节点结构请查看:企业微信开发者中心-添加记录
  • 参考记录列表:

    # 列表1
    records1 = [{
            "文本字段": [{"type": "text","text": "这是一条测试文本",} ],
            "数字字段": 100,
            "复选框字段": True,
            "日期字段": "1735689600000",
            "超链接字段": [{"type": "url","text": "企业微信开发者中心","link": "https://developer.work.weixin.qq.com"}],
            "多选字段": [{"text": "新增选项", "style": 1}],
            "进度字段": 75,
            "单选字段": [{"text": "单选新增项", "style": 2}],
            "地理位置字段": [{"source_type": 1,"id": "14313005936863363130","latitude": "23.10647","longitude": "113.32446","title": "广州塔"}],
            "货币字段": 99.99,
            "百分数字段": 88.50,
            "条码字段": [{"text": "123456789012"}]
        }]

    # 列表2
    records2 = [{
            "文本字段": [{"type": "url", "text": "点击访问官网", "link": "https://work.weixin.qq.com"}],
            "数字字段": 200,
            "复选框字段": False,
            "日期字段": "1735776000000",  # 2025-01-02 00:00:00
            "进度字段": 50,
            "货币字段": 150.50,
            "百分数字段": 60.25
        }]

组件输出

  • 响应内容:此处输出企业微信API响应内容

高级属性

  • 错误继续执行:组件运行异常时,流程是否继续运行
  • 执行前延时(秒):运行组件前的延时时间
  • 执行后延时(秒):运行组件后的延时时间
  • 超时时间(秒):运行组件的超时时间限制

 

三、使用实例

实例描述

企业微信智能表格-添加记录,在智能表格"组件需求表"的"业务组件"工作表中添加记录;并将执行结果输出至控制台。

前置环境

该流程需要使用【企业微信智能表格-建立表格连接】组件来获取访问令牌-access_token(关于该组件的具体使用详情可参考其使用文档)

流程编辑

运行结果

运行前表格展示

运行后表格展示

四、常见问题

Q1、访问令牌过期/错误

组件运行提示:企业微信API错误(errcode=40014)
解决方案:访问令牌失效,重新运行【企业微信智能表格-建立表格连接】组件即可

Q2、未添加可信IP

组件运行提示:API错误 (errcode=60020)
解决方案:未添加可信IP,需在应用管理中添加应用的企业可信IP

Q3、智能表ID参数错误

组件运行提示:企业微信API错误 (errcode=301085)
解决方案:智能表ID参数输入错误,检查智能表ID参数是否正确

Q4、工作表ID参数错误

组件运行提示:API错误 (errcode=2543303)
解决方案:工作表ID参数输入错误,检查工作表ID参数是否正确
 
 
 
 
企业培训
技术支持
加入社群
公众号
实在智能Agent学习群
扫码关注微信公众号