aitable-workflow-cli 0.1.13-beta.1

package/templates/support-qa/profiles/aitable/wiki/faq-support/.kb/wiki/concepts//351/242/204/350/247/210/351/253/230/347/272/247/346/235/203/351/231/220/347/273/223/346/236/234.md

@@ -0,0 +1,51 @@
+---
+title: 预览高级权限结果
+category: concept
+sources: [12-高级权限/预览高级权限结果.md]
+original_sources: [https://wolai.dingtalk.com/7zY3qQg4UrgB3oK5TS2sCp]
+created: 2026-07-20
+updated: 2026-07-20
+tags: [高级权限, 权限预览, 权限校验]
+aliases: [权限预览, 预览权限]
+confidence: high
+summary: 高级权限预览功能允许管理员以不同角色/成员的视角查看AI表格，从而检查权限配置是否准确。预览中的操作均为临时展示，退出后自动清空。
+---
+
+> 高级权限预览功能是权限配置后的校验工具，管理员可以模拟不同角色和成员的视角来检查权限设置是否正确，确保数据安全性。
+
+## 开启预览
+
+完成高级权限配置并添加成员后，点击右下角的**保存并预览**进入预览页面。
+
+![](https://img.alicdn.com/imgextra/i1/O1CN01kanisD1vLVKsOxQGH_!!6000000006156-2-tps-2832-1440.png)
+
+点击上方进行不同角色/成员之间的切换，检查高级权限设置是否准确无误。
+
+![](https://img.alicdn.com/imgextra/i1/O1CN01XBFxCv1EmxbHfUhnY_!!6000000000395-2-tps-2832-1438.png)
+
+## 退出预览
+
+在预览模式中，点击左上角的**退出预览**即可退出。
+
+![](https://img.alicdn.com/imgextra/i1/O1CN01F2EqTT1fEbW2akOTr_!!6000000003975-2-tps-2832-1434.png)
+
+## 常见问题
+
+**问：在预览状态下，如果其他人对高级权限进行修改，是否会实时同步？**
+
+答：不会。需要退出预览状态后，再对权限进行修改，才能使更改生效。
+
+**问：在预览状态下，修改AI表格内容是否会生效？**
+
+答：不会。在预览状态下，所有操作结果均为临时展示，仅供示意。退出预览状态后，相关操作及其结果将被全部清空。
+
+## See Also
+
+- [使用AI表格高级权限](../topics/使用AI表格高级权限.md)
+- [高级权限常见问题](../references/高级权限常见问题.md)
+- [高级权限的默认角色](../concepts/高级权限的默认角色.md)
+- [[行列权限设置及高级权限对表单公式的影响|行列权限设置及高级权限对表单公式的影响]] ([行列权限设置及高级权限对表单公式的影响](../concepts/行列权限设置及高级权限对表单公式的影响.md))
+
+## Sources
+
+- [预览高级权限结果](https://wolai.dingtalk.com/7zY3qQg4UrgB3oK5TS2sCp)

package/templates/support-qa/profiles/aitable/wiki/faq-support/.kb/wiki/concepts//351/253/230/347/272/247/346/235/203/351/231/220/347/232/204/351/273/230/350/256/244/350/247/222/350/211/262.md

@@ -0,0 +1,50 @@
+---
+title: 高级权限的默认角色
+category: concept
+sources: [12-高级权限/高级权限的默认角色.md]
+original_sources: [https://wolai.dingtalk.com/ijXBhqpFzp9qe1i4FMgRSn]
+created: 2026-07-20
+updated: 2026-07-20
+tags: [高级权限, 默认角色, 权限管理]
+aliases: [默认角色, 高级权限默认角色]
+confidence: high
+summary: 高级权限的默认角色用于为新加入或未分配角色的协作者自动设定访问权限，简化授权流程并保证数据安全。支持选择自定义角色或设置为禁止访问。
+---
+
+> 默认角色是高级权限中为未分配角色的协作者自动生效的权限方案，在保证数据安全的同时简化了授权流程，避免为每位新成员单独配置权限。
+
+## 使用场景
+
+- 新协作者加入启用高级权限的AI表格时，自动以默认角色的权限访问，无需额外授权
+- 某自定义角色被删除后，原成员自动以默认角色的权限访问AI表格数据
+
+## 基础操作
+
+首次开启高级权限时，系统默认将普通用户角色设为默认角色。
+
+在高级设置弹窗下方**默认角色**中，可选择已创建的自定义角色设为默认角色。未分配角色的协作者按默认角色权限访问，已获得角色的协作者（包括群成员）以自己所属角色的权限为准。
+
+![](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/XNkOMM8dLb3zOY74/img/c33928b2-87e2-45e0-a937-7e81ce9126bd.png)
+
+### 设置为禁止访问
+
+设置默认角色为禁止访问时，通过链接访问和被邀请但未指定角色的协作者均无法看到AI表格内容，需要申请高级权限并通过后才能访问。
+
+![](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/XNkOMM8dLb3zOY74/img/2d152b3e-00f7-4612-a196-11a63f0a6885.png)
+
+![](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/XNkOMM8dLb3zOY74/img/7c36b3a5-d024-4566-a802-69b2928525ac.png)
+
+## 注意事项
+
+- 当前默认角色仅支持选择 1 个角色
+- 对于开启过高级权限的AI表格，重新设定高级权限时，系统默认不会出现普通用户角色，可直接选取任意自定义角色为默认角色
+
+## See Also
+
+- [使用AI表格高级权限](../topics/使用AI表格高级权限.md)
+- [高级权限常见问题](../references/高级权限常见问题.md)
+- [预览高级权限结果](../concepts/预览高级权限结果.md)
+
+## Sources
+
+- [高级权限的默认角色](https://wolai.dingtalk.com/ijXBhqpFzp9qe1i4FMgRSn)

package/templates/support-qa/profiles/aitable/wiki/faq-support/.kb/wiki/log.md

@@ -0,0 +1,4 @@
+# Wiki 编译日志
+
+## [2026-07-20] 全量编译 | 189 新建, 0 更新, 0 跳过
+## [2026-07-30] 增量编译 | 0 新建, 1 更新, 188 跳过

package/templates/support-qa/profiles/aitable/wiki/faq-support/.kb/wiki/references/AI /350/241/250/346/240/274 AI /345/255/227/346/256/265/345/270/270/350/247/201/346/212/245/351/224/231/350/257/264/346/230/216.md"

@@ -0,0 +1,223 @@
+---
+title: AI 表格 AI 字段常见报错说明
+category: reference
+sources: [18-开发者指南/AI表格字段模版 使用指南/AI 表格 AI 字段常见报错说明.md]
+created: 2026-07-20
+updated: 2026-07-20
+tags: [AI字段, 报错, 故障排查, FAQ, 字段模板]
+aliases: [AI字段报错, 字段模板错误说明]
+confidence: high
+summary: AI 表格 AI 字段执行过程中常见错误信息的完整汇总，包含每种错误的原因说明和对应解决方案，涵盖配置异常、服务限流、权限、附件、AI 调用等场景。
+---
+
+> AI 字段是 AI 表格中用于快速批量处理数据的功能模块，执行过程中可能因配置、服务、权限等原因出现错误。本文档汇总常见错误信息及解决方案，帮助快速定位和解决问题。
+
+## 服务与限流类错误
+
+### 用户需求火爆，AI 调用繁忙，请稍后再试
+
+- **原因**: AI 模型请求量过大导致服务限流或超时，也可能是字段模板配置异常
+- **解决**: 等待 1-2 分钟重试；选中单个单元格点击"更新"逐条生成；避免同时对大量记录执行
+
+### AI 服务繁忙，请稍后再试
+
+- **原因**: 字段模板插件执行异常或 AI 模型调用超时
+- **解决**: 稍等后重试；检查字段模板配置是否正确
+
+### 请求的服务超出限制，请稍后重试
+
+- **原因**: FaaS 插件请求频率超限
+- **解决**: 降低执行频率，分批执行
+
+### AI字段使用超限，请明日再试
+
+- **原因**: 当日字段模板执行次数达到每日上限
+- **解决**: 等待次日额度刷新；关闭不必要的自动更新减少消耗
+
+### AI字段运行超时，请稍后重试
+
+- **原因**: 子任务执行时间超过系统限制
+- **解决**: 减少单次数据量分批执行；稍后重试
+
+### 当前AI字段正在运行中
+
+- **原因**: 同一字段已有正在执行的任务
+- **解决**: 等待当前任务完成后再发起新任务
+
+## 配置类错误
+
+### AI字段配置异常，请检查后重试
+
+- **原因**: 字段模板的任务参数非法或配置数据损坏
+- **解决**: 检查配置项是否填写完整；确认引用字段和参数正确；必要时删除后重新创建
+
+### 指令引用字段已被删除或为非法字段
+
+- **原因**: 依赖的引用字段已被删除或不存在
+- **解决**: 编辑配置重新选择有效字段；通过操作历史恢复误删字段
+
+### 所选字段形成循环引用
+
+- **原因**: 多个字段模板间形成循环依赖关系
+- **解决**: 检查引用关系，调整引用链路消除环形依赖
+
+### 引用字段不能为空，请填写后重试
+
+- **原因**: 引用字段值为空
+- **解决**: 填写引用字段内容后重试；或在配置面板设置允许引用字段为空
+
+![允许引用字段为空配置](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/8oLl95257zd7Mlap/img/d271080a-a510-4f80-9470-559205a524c2.png)
+
+### 字段模板配置错误，请联系插件开发者
+
+- **原因**: FaaS 插件配置参数有误
+- **解决**: 检查配置参数；联系开发者获取正确配置方式
+
+## 权限与授权类错误
+
+### 当前 AI 表格归属其他组织
+
+- **原因**: 当前组织与 AI 表格所属组织不同，AI 功能不支持跨组织调用
+- **解决**: 确认在正确组织下操作；联系文档所有者；申请加入该组织
+
+### 你没有权限访问该文件
+
+- **原因**: 对引用的附件或文档没有查看/下载权限
+- **解决**: 确认文件权限；联系文件所有者授权
+
+### 授权错误，请检查是否正确关联账号
+
+- **原因**: FaaS 插件授权信息无效或已过期
+- **解决**: 重新关联账号授权
+
+### 当前算粒资源不足，请开通后继续使用
+
+- **原因**: AI 算粒额度不足
+- **解决**: 前往算粒管理页面查看额度；联系管理员充值
+
+## 内容安全类错误
+
+### 由于可能涉及敏感内容，AI暂时无法回答
+
+- **原因**: 输入或输出触发了内容安全审核机制
+- **解决**: 检查输入数据；修改提示词避免不当内容；换种表述方式
+
+### 输入内容长度超出上限
+
+- **原因**: 提示词或引用内容超过模型最大限制
+- **解决**: 精简提示词；减少引用字段文本长度或数量
+
+## 附件与文件类错误
+
+### 附件解析失败
+
+- **原因**: 附件格式不标准或文件损坏
+- **解决**: 检查格式是否正确；重新上传
+
+### 引用字段中没有找到合适的附件
+
+- **原因**: 引用字段无支持的附件类型（支持 .pdf .docx .png .jpeg .jpg .webp）
+- **解决**: 确认附件字段有文件且格式在支持范围内
+
+### 附件文件超出大小限制
+
+- **限制**: 图片 ≤ 10 MB，视频和音频 ≤ 1 GB，PDF ≤ 50 MB
+- **解决**: 压缩或裁剪文件
+
+### 文件类型不支持 / 文件大小超出限制 / 文件页数超出限制 / 文件内容为空
+
+- **解决**: 检查文件类型、大小、页数和内容，转换格式或拆分文件
+
+### 文件加密或损坏
+
+- **解决**: 解除加密保护或重新获取未损坏的文件
+
+## 图片与多媒体类错误
+
+### 参考图需满足 PNG 格式且分辨率不超过 1280×1280
+
+- **解决**: 转换为 PNG 格式，确保分辨率在限制内
+
+### 图片尺寸必须在 384 到 5000 像素之间
+
+- **解决**: 使用编辑工具调整尺寸
+
+### 音频文件解码失败 / 采样率不符合 / 时长过长 / 有效时长过短
+
+- **解决**: 检查格式、转换采样率、裁剪时长
+
+### 视频时长超出限制 / 分辨率和时长不匹配
+
+- **解决**: 裁剪视频或降低分辨率
+
+### 文字超过限制
+
+- **解决**: 缩短文本内容或拆分为多段
+
+## FaaS 插件类错误
+
+### 系统错误，请联系技术支持
+
+- **原因**: FaaS 插件执行过程中出现未知系统异常
+
+### 字段模板运行超时/运行错误，请联系插件开发者
+
+- **解决**: 减少单次处理数据量；联系开发者优化
+
+### 账号用量已耗尽
+
+- **解决**: 联系开发者确认额度；检查其他可用账号
+
+### 暂不支持当前模型
+
+- **解决**: 更换为支持的模型
+
+### 数据写入失败
+
+- **解决**: 检查表格写入权限；稍后重试
+
+### 文档不存在或没有权限
+
+- **解决**: 确认文档存在且有访问权限
+
+## 物流查询类错误
+
+### 运单号无效或缺失查询信息
+
+- **原因**: 物流查询服务受限
+- **注意事项**: 顺丰需手机号；海外快递不支持；极兔基本不支持；韵达查询经常失败可闲时再试；非淘天包裹可能失败；可去菜鸟裹裹平台确认
+
+## 常见问题
+
+### 错误面板上的"联系开发者"按钮是做什么的？
+
+点击后会打开插件开发者提供的咨询群链接，用于联系开发者获取帮助。
+
+### 错误面板上的"复制错误信息"按钮是做什么的？
+
+将完整错误信息（含 Sheet ID、Record ID 等调试信息）复制到剪贴板，便于提供给开发者定位问题。
+
+### 为什么同一个字段模板部分记录成功部分失败？
+
+字段模板逐条执行，每条记录输入数据不同可能触发不同错误：引用字段为空、附件格式不支持或大小超限、内容触发安全审核等。
+
+### 为什么 AI 字段不能自动更新？
+
+1. 未开启自动更新（需创建时手动开启）
+2. 当天运行次数超限
+3. 引用公式/查找引用/关联引用字段时，服务端公式尚未计算完成（可开启 AI 表格加速验证）
+4. 自动化触发的变更暂不支持 AI 字段自动更新
+5. 表单提交、自动化新增行等场景，计算列过多导致无法触发
+
+![自动更新开关](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/ybEnB5jkEVrZzlP1/img/301da0ef-9f20-49bb-b695-b00c51338daa.png)
+
+![表格加速](https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/ybEnB5jkEVrZzlP1/img/064ac00d-f5cd-4512-bd83-3043bd5fb80a.png)
+
+## See Also
+
+- [AI表格 AI 字段 开发指南](../topics/AI表格%20AI%20字段%20开发指南.md)
+- [AI表格 AI 字段开发指南（FaaS版）](../topics/AI表格%20AI%20字段开发指南（FaaS版）.md)
+
+## Sources
+
+- AI 表格 AI 字段常见报错说明

package/templates/support-qa/profiles/aitable/wiki/faq-support/.kb/wiki/references/AI/350/241/250/346/240/274/350/241/214/346/225/260/350/257/264/346/230/216.md

@@ -0,0 +1,95 @@
+---
+title: AI表格行数说明
+category: reference
+sources: [01-快速入门/AI表格行数说明.md]
+original_sources: [https://wolai.dingtalk.com/di25xh4ZR5MzEBR3svBCBN]
+created: 2026-07-20
+updated: 2026-07-20
+tags: [行数限制, 版本权益, 扩容]
+aliases: [行数上限, 单表行数, 行数扩容]
+confidence: high
+summary: 钉钉AI表格各版本单表行数上限及扩容说明，涵盖免费版、企业版、旗舰版的行数权益差异，以及数据同步、导入等特殊场景的行数限制规则。
+---
+
+> AI表格针对不同版本提供差异化的单表行数支持，所有版本均保持热行数据秒级响应。企业版和旗舰版用户可申请付费扩容至千万行，满足大规模数据分析需求。
+
+## 版本行数对比
+
+| 版本类型 | 单表默认最大行数 | 扩展行数支持 | 适用场景 |
+| --- | --- | --- | --- |
+| 免费版 | 20,000行 | 不支持扩容 | 小团队协作、个人项目管理、基础数据记录 |
+| 企业版 | 30,000行 | 可申请扩容至千万行 | 中大型企业日常运营、多门店数据汇总 |
+| 旗舰版 | 50,000行 | 可申请扩容至千万行 | 集团化管理、高频数据迭代、超大规模数据分析 |
+
+行数统计包含表格内所有有效数据行，空行不计入额度；1000万行可按表申请付费使用。
+
+## 单表行数用量规则
+
+### 超限提示
+
+当单表行数超过当前上限后，将无法新增记录，需升级扩容。
+
+![](https://img.alicdn.com/imgextra/i1/O1CN01muKjCS1F9rP5OPMwR_!!6000000000445-2-tps-968-338.png)
+
+### 管理员查看行数使用情况
+
+操作路径：打开钉钉客户端 > 更多 > 管理后台，或直接访问 https://oa.dingtalk.com/#/welcome 进入钉钉管理后台，在左侧菜单中打开 AI表格 > 权益数据。
+
+1. 点击单表最大行数卡片上的「用量明细」
+
+   ![](https://img.alicdn.com/imgextra/i4/O1CN01p8Z1Kt1Yj6a8jB0pj_!!6000000003094-2-tps-724-474.png)
+
+2. 跳转到数据表行数用量界面，可查询企业内数据表的行数用量
+
+   ![](https://img.alicdn.com/imgextra/i3/O1CN01JqTVKv1mmDtpAaEW8_!!6000000004996-2-tps-1090-885.png)
+
+## 扩容权益说明
+
+- 企业版、旗舰版用户可申请将单表行数扩容至 1000 万热行，为业内首个支持千万热行量级的智能表格产品
+- 扩容后仍保持秒级计算响应，支持多表关联、AI字段分析、动态仪表盘实时更新等核心功能
+- 扩容服务为付费增值权益，[扩容申请入口](https://alidocs.dingtalk.com/notable/share/form/v01eLbnj1bgP0ARrlaN_hERWDMS_BbIMDo9?dontjump=true)
+
+## 特殊场景行数限制
+
+| 场景 | 限制说明 |
+| --- | --- |
+| 复制粘贴 | 单次复制上限 20,000 行 |
+| 本地文件导入（.xlsx/.csv） | 单个文件不超过 20MB，行数需在版本额度内 |
+| 数据源同步 | 单表页同步上限 20,000 行，每次同步全量覆盖 |
+
+### 超限处理规则
+
+- 免费版超限后需升级或清理数据至 20,000 行以下方可继续新增
+- 通过表单提交、自动化运行、接口调用等超限时，系统自动暂停新增并通知表格所有者
+- 超限后可升级版本或申请扩容恢复新增功能，已有数据可正常查看、编辑、导出
+
+## 常见问题
+
+**Q：单表行数达到上限后，是否影响已有的数据计算和视图展示？**
+
+A：不影响。已存储数据可正常筛选、排序、分组、公式计算，视图和仪表盘功能均保持正常，仅限制新增数据行。
+
+**Q：不同版本之间升级，行数额度如何衔接？**
+
+A：升级后单表行数额度即时提升至对应版本默认值，已达上限的表格可直接新增数据至新版本额度。
+
+**Q：单表行数最多支持扩容到多少万行？**
+
+A：企业版和旗舰版可按单表付费扩容，按 100 万行阶梯递增，最高支持 1000 万行。
+
+**Q：扩容后可支持多少张数据表享受权益？**
+
+A：一张表里支持 5 个数据表享受额外扩容行数权益，超出 5 张的其他数据表回归版本默认行数上限。
+
+**Q：千万行扩容后，数据存储安全是否有保障？**
+
+A：采用阿里云 ADB-PG 存算一体架构，具备银行级数据加密、多副本备份、异地容灾能力，符合国家信息安全等级保护三级标准。
+
+## See Also
+
+- [钉钉AI表格常见上限](../references/钉钉AI表格常见上限.md)
+- [将Excel文件导入AI表格](../topics/将Excel文件导入AI表格.md)
+
+## Sources
+
+- [AI表格行数说明](https://wolai.dingtalk.com/di25xh4ZR5MzEBR3svBCBN)

package/templates/support-qa/profiles/aitable/wiki/faq-support/.kb/wiki/references/AttachmentField /351/231/204/344/273/266/345/255/227/346/256/265.md"

@@ -0,0 +1,65 @@
+---
+title: AttachmentField 附件字段 API
+category: reference
+sources: [18-开发者指南/AI表格对象模型API参考文档/Field 模块/AttachmentField 附件字段.md]
+created: 2026-07-20
+updated: 2026-07-20
+tags: [API, Field模块, 附件字段, AttachmentField, 文件上传]
+aliases: [附件字段API, AttachmentField]
+confidence: high
+summary: AttachmentField 附件字段的 API 参考，提供文件附件的上传、获取、URL 列表和详细信息查询等方法，支持图片、文档、音视频等多种文件格式。
+---
+
+> AttachmentField 用于存储和管理各种文件附件（图片、文档、音频、视频等），提供上传、获取和管理附件的完整 API。
+
+## 数据类型
+
+- **IOpenFile**: 要上传的文件（base64 建议文件大小 10MB 以下）
+- **AttachmentValue**: 已上传的附件对象
+
+## API 方法
+
+### getValueAsync
+
+获取指定记录的所有附件。
+
+```typescript
+getValueAsync(recordId: string): Promise<AttachmentValue[] | null>
+```
+
+返回附件对象数组，包含 url、filename、type、size 等属性。
+
+### setValueAsync
+
+上传并设置附件字段值。
+
+```typescript
+setValueAsync(recordId: string, attachment: IOpenFile | IOpenFile[] | AttachmentValue | AttachmentValue[]): Promise<boolean>
+```
+
+在边栏插件中追加附件时，需先通过 `getValueAsync` 获取现有附件，再合并新附件一起设置。
+
+### getAttachmentUrls
+
+获取指定记录所有附件的 URL 列表。
+
+```typescript
+getAttachmentUrls(recordId: string): Promise<string[]>
+```
+
+### getAttachmentDetails
+
+获取所有附件的详细信息（下载 URL、类型、文件名）。
+
+```typescript
+getAttachmentDetails(recordId: string): Promise<Array<{ filename: string; type: string; url: string }>>
+```
+
+## See Also
+
+- [Base 模块 API 参考](../references/Base%20模块.md)
+- [BarcodeField 条码字段 API](../references/BarcodeField%20条码字段.md)
+
+## Sources
+
+- [AttachmentField 附件字段](https://alidocs.dingtalk.com/notable/record?dentryUuid=GZLxjv9VGGDA9Ro2u05KgqMnV6EDybno&rowId=0VuOwCWaVq&sheetId=hERWDMS&viewId=qvGDAH2)

package/templates/support-qa/profiles/aitable/wiki/faq-support/.kb/wiki/references/AutoNumberField /350/207/252/345/212/250/347/274/226/345/217/267/345/255/227/346/256/265.md"

@@ -0,0 +1,47 @@
+---
+title: AutoNumberField 自动编号字段 API
+category: reference
+sources: [18-开发者指南/AI表格对象模型API参考文档/Field 模块/AutoNumberField 自动编号字段.md]
+created: 2026-07-20
+updated: 2026-07-20
+tags: [API, Field模块, 自动编号, AutoNumberField, 只读字段]
+aliases: [自动编号字段API, AutoNumberField]
+confidence: high
+summary: AutoNumberField 自动编号字段的 API 参考，系统自动为每条记录生成唯一递增编号，是只读字段，适用于订单编号、工单编号等场景。
+---
+
+> AutoNumberField 是系统自动为每条记录生成唯一递增编号的只读字段，编号值以字符串形式存储，适用于订单、工单、客户编号等场景。
+
+## API 方法
+
+### getValueAsync
+
+获取指定记录的自动编号值。
+
+```typescript
+getValueAsync(recordId: string): Promise<string | null>
+```
+
+返回自动编号字符串，字段值为空时返回 null。
+
+## 使用场景
+
+- 订单编号：为每个订单自动生成唯一编号
+- 工单编号：为每个工单分配递增编号
+- 客户编号：为每个客户记录生成唯一标识
+- 任务编号：为项目中的任务自动编号
+
+## 注意事项
+
+- 自动编号字段是只读的，无法通过 API 手动设置值
+- 删除记录后，编号不会被重新分配给新记录
+- 编号格式由字段配置决定，可能包含前缀、日期等信息
+
+## See Also
+
+- [Base 模块 API 参考](../references/Base%20模块.md)
+- [BarcodeField 条码字段 API](../references/BarcodeField%20条码字段.md)
+
+## Sources
+
+- [AutoNumberField 自动编号字段](https://alidocs.dingtalk.com/i/nodes/np9zOoBVBy2AdzEju0z93rx2W1DK0g6l?utm_scene=person_space)

package/templates/support-qa/profiles/aitable/wiki/faq-support/.kb/wiki/references/BarcodeField /346/235/241/347/240/201/345/255/227/346/256/265.md"

@@ -0,0 +1,55 @@
+---
+title: BarcodeField 条码字段 API
+category: reference
+sources: [18-开发者指南/AI表格对象模型API参考文档/Field 模块/BarcodeField 条码字段.md]
+created: 2026-07-20
+updated: 2026-07-20
+tags: [API, Field模块, 条码字段, BarcodeField, 商品管理]
+aliases: [条码字段API, BarcodeField]
+confidence: high
+summary: BarcodeField 条码字段的 API 参考，用于存储和管理条码信息，支持读取和设置条码值，常用于商品管理和库存跟踪场景。
+---
+
+> BarcodeField 用于存储和管理条码信息，常用于商品管理、库存跟踪等场景，支持条码值的读取和设置操作。
+
+## API 方法
+
+### getValueAsync
+
+获取指定记录的条码值。
+
+```typescript
+getValueAsync(recordId: string): Promise<string | null>
+```
+
+返回条码字符串，字段值为空时返回 null。
+
+### setValueAsync
+
+设置指定记录的条码值。
+
+```typescript
+setValueAsync(recordId: string, text: string): Promise<boolean>
+```
+
+**参数**:
+- `recordId` — 记录 ID
+- `text` — 条码值
+
+**示例**:
+
+```typescript
+const barcodeField = sheet.getField('商品条码');
+if (Base.isFieldOfType(barcodeField, 'barcode')) {
+  await barcodeField.setValueAsync('rec123456', '6901234567890');
+}
+```
+
+## See Also
+
+- [Base 模块 API 参考](../references/Base%20模块.md)
+- [AutoNumberField 自动编号字段 API](../references/AutoNumberField%20自动编号字段.md)
+
+## Sources
+
+- [BarcodeField 条码字段](https://alidocs.dingtalk.com/i/nodes/np9zOoBVBy2AdzEju0z93rx2W1DK0g6l?utm_scene=person_space)