1. 首页
  2. 文档
  3. 企业微信智能表格-批量添加字段

白皮书下载

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

企业微信智能表格-批量添加字段

发刊日期:
2025/10/28

编辑团队:
实在学院

一、功能描述

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

二、属性说明

组件输入

  • 访问令牌:字符串;企业微信访问令牌access_token,可使用【企业微信智能表格-建立表格连接】组件进行获取
  • 智能表ID:字符串;操作目标智能表ID
  • 工作表ID:字符串;操作目标工作表ID
  • 字段列表:列表;字段列表, 每个字段是一个字典,包含字段标题和类型,参考字段节点结构请查看:企业微信开发者中心-添加字段
  • 参考字段:fields = [ { "field_title": "文本字段", "field_type": "FIELD_TYPE_TEXT" }, { "field_title": "数字字段", "field_type": "FIELD_TYPE_NUMBER", "property_number": { "decimal_places": 0, "use_separate": False } }, { "field_title": "复选框字段", "field_type": "FIELD_TYPE_CHECKBOX", "property_checkbox": { "checked": False } }, { "field_title": "日期字段", "field_type": "FIELD_TYPE_DATE_TIME", "property_date_time": { "format": "yyyy-mm-dd", "auto_fill": False } }, { "field_title": "文件字段", "field_type": "FIELD_TYPE_ATTACHMENT", "property_attachment": { "display_mode": "list" } }, { "field_title": "成员字段", "field_type": "FIELD_TYPE_USER", "property_user": { "is_multiple": True, "is_notified": False } }, { "field_title": "超链接字段", "field_type": "FIELD_TYPE_URL", "property_url": { "type": "LINK_TYPE_PURE_TEXT" } }, { "field_title": "多选字段", "field_type": "FIELD_TYPE_SELECT", "property_select": { "is_quick_add": True, "options": [] } }, { "field_title": "创建时间字段", "field_type": "FIELD_TYPE_CREATED_TIME", "property_created_time": { "format": "yyyy-mm-dd" } }, { "field_title": "最后编辑时间字段", "field_type": "FIELD_TYPE_MODIFIED_TIME", "property_modified_time": { "format": "yyyy-mm-dd" } }, { "field_title": "进度字段", "field_type": "FIELD_TYPE_PROGRESS", "property_progress": { "decimal_places": 0 } }, { "field_title": "单选字段", "field_type": "FIELD_TYPE_SINGLE_SELECT", "property_single_select": { "is_quick_add": True, "options": [] } }, { "field_title": "地理位置字段", "field_type": "FIELD_TYPE_LOCATION", "property_location": { "input_type": "LOCATION_INPUT_TYPE_MANUAL" } }, { "field_title": "自动编号字段", "field_type": "FIELD_TYPE_AUTONUMBER", "property_auto_number": { "type": "NUMBER_TYPE_INCR", "rules": [{"type": "NUMBER_RULE_TYPE_INCR", "value": "1"}], "reformat_existing_record": False } }, { "field_title": "货币字段", "field_type": "FIELD_TYPE_CURRENCY", "property_currency": { "currency_type": "CURRENCY_TYPE_CNY", "decimal_places": 2, "use_separate": False } }, { "field_title": "群字段", "field_type": "FIELD_TYPE_WWGROUP", "property_ww_group": { "allow_multiple": False } }, { "field_title": "百分数字段", "field_type": "FIELD_TYPE_PERCENTAGE", "property_percentage": { "decimal_places": 2, "use_separate": False } }, { "field_title": "条码字段", "field_type": "FIELD_TYPE_BARCODE", "property_barcode": { "mobile_scan_only": False } } ]

组件输出

  • 响应内容:此处输出企业微信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参数是否正确

Q5、不合法的字段标题

组件运行提示:API错误 (errcode=2022030)
解决方案:字段标题重复、为空等,检查标题是否为空、重复
 
 
 
企业培训
技术支持
加入社群
公众号
实在智能Agent学习群
扫码关注微信公众号