# 把连续扫码器的扫码记录同步到腾讯文档

授权腾讯文档后，草料连续扫码器会把台账里新录的扫码记录自动写进一张腾讯文档在线表格，一条记录一行；你在台账「记录内容」里加的字段也会各占一列。适用于把扫码结果分享给同事查看、在表格里汇总统计等场景，不用再手动导出。

开始前请确认：

1. **腾讯文档账号**：授权时会打开腾讯文档小程序，用你的腾讯文档账号登录并同意授权。
2. **台账创建者**：只有台账的创建者能授权、开始或暂停同步，其他成员只能查看。

> **注**：要把扫码记录推送到自己的系统，而不是表格，请看 [用 Webhook 把连续扫码器的扫码记录推送到自己的系统](/help/integration-and-connection/continuous-scanner/webhook)。

## 什么时候同步

每录一条扫码记录同步一行，同步时机如下：

| 情况 | 同步不同步 |
|------|------|
| 录了一条新记录 | 新增一行。连续扫码时，扫下一条时写入上一条；不再扫的话，大约 1 分钟后写入 |
| 同步之后又改了这条记录（改状态、补备注等） | 更新表格里原来那一行 |
| 删除记录 | 表格里的那一行不会删，需要的话在表格里手动删 |
| 开始同步之前录的记录 | 不同步，以后也不补 |
| 暂停期间录的记录 | 不同步，恢复后也不补 |

同步是单向的：只从小程序写到表格。在表格里改了内容不会同步回小程序；之后小程序里再改这条记录，表格里这一行会按小程序里的内容重新写一遍。

## 一、授权腾讯文档账号

授权一次后，这个草料账号下的台账都能同步，不用每个台账各授权一次。

1. 在草料连续扫码器里打开台账，点「流程设计」，切到最右边的「自动化设置」标签。
2. 在「同步到在线表格」下，「腾讯文档」那一行点「授权」，会打开腾讯文档小程序。
3. 在腾讯文档小程序里同意授权，回到连续扫码器，看到「腾讯文档已授权」即授权成功。

授权成功后，当前台账会自动新建一张和台账同名的在线表格，开始同步。

## 二、在其他台账开始同步

已经授权过的账号，其他台账要各自点一次「开始同步」，每个台账写进自己的一张表格。

打开另一个台账的「自动化设置」，「同步到在线表格」下的「腾讯文档」一行写着「会新建表格「台账名」」。点「开始同步」，看到「已同步到本台账」即可。

每个台账同步到自己新建的那张表格，不能选择已有的表格。

## 三、确认表格里有了扫码记录

开始同步后扫一条码，接着扫下一条（或等 1 分钟），再回到「自动化设置」，点「同步到在线表格」下的表名那一行打开表格，确认表格里多了这一行。

那一行写着表名和「同步中」时，表示这个台账正在同步。没看到新的一行时，依次检查：

1. 表名那一行的开关是否打开（关掉是暂停，会写「已暂停」）；
2. 这条记录是不是在开始同步之前、或暂停期间录的；
3. 是否弹出「腾讯文档授权已失效」，失效时点「重新授权」。

## 表格里有哪些列

表格的前 7 列是固定的，后面依次是「扫码照片」和台账「记录内容」里的字段：你在「记录内容」里加的每个字段（比如「签到状态」「数量」），都会在表格里各占一列，列名就是字段名。

| 列 | 内容 |
|------|------|
| 扫码记录编号 | 记录序号，例如 R4 |
| 扫码时间 | 扫码的时间 |
| 扫码批次 | 这条记录所在的批次 |
| 扫码类型 | 二维码或条码 |
| 扫码结果 | 扫到的内容（二维码或条码里的文字、链接） |
| 备注 | 备注的文字 |
| 扫码人 | 录入这条记录的人在小程序里的名字 |
| 扫码照片 | 这条记录的图片链接，见下一节 |
| 记录内容里的字段 | 你在台账「记录内容」里加的字段，每个字段一列，列名就是字段名 |

「备注」列以前叫「扫码备注」，已经在同步的表格会在下一次同步时自动改名，列里已有的内容不变。如果你在「记录内容」里也加了一个叫「备注」的字段，为了不出现两列同名，这一列仍叫「扫码备注」。

记录内容里的字段按类型写成不同的列：

| 字段类型 | 表格里的列 |
|------|------|
| 选择（单选） | 下拉单选列，下拉框里有台账里这个字段的全部选项 |
| 选择（多选） | 下拉多选列 |
| 图片 | 链接列，见下一节 |
| 文字、数字、日期 | 文本列，写的就是小程序里看到的样子 |

在台账里新加字段、新增或改名选项后，下一次同步时表格会补上新列、更新下拉框。

台账开了「扫码位置」时，表格最后还有一列「扫码位置」，写扫码时所在的地名，例如「浙江省杭州市西湖区文三路90号」；地名查不到时写「纬度,经度」。开位置之前就绑好的表格，下一次同步时会补上这一列。

用 [清单核对](/help/integration-and-connection/continuous-scanner/sheet-check) 的台账，导入清单时选了数量列，表格里还会多一列「数量」，写这一条记录算几件，没改过就是 1。

## 图片为什么以链接形式同步

图片不能直接放进腾讯文档的格子里，是因为腾讯文档在线表格的图片列有限制，扫码时的速度跟不上。

腾讯文档的图片列只收传到腾讯文档里的图片：每张图要先上传给腾讯文档，换一个图片编号才能写进格子，这个编号 24 小时内有效；而且每个腾讯文档账号每分钟最多只能传 5 张。连续扫码时一分钟可能录几十条，照这个速度图片会越积越多、一直补不上。

所以图片改成以链接形式同步：

- 格子里显示「查看照片」，点开就是原图。
- 一个格子只能放一个链接。一条记录有多张图时，链接打开第一张，格子里写「查看照片（共 3 张）」；其余的图在小程序里打开这条记录查看。
- 图片链接长期有效，不用登录就能打开，能看到这张表格的人都能打开。分享表格前请留意这一点。

## 常见问题

### 开始同步之前录的记录能同步吗？

不能。只同步开始同步之后录的记录，暂停期间录的也不同步，以后都不补。要之前的记录，可以在台账里导出。

### 同步失败会重试吗？

不会自动重试。这一次没写进表格的记录，之后有人改了这条记录，会再写一次。

### 怎么暂停或停止同步？

暂停一个台账：关掉表名那一行的开关，打开即恢复。停止所有台账：点「同步到在线表格」旁的「?」，在弹窗最下面点「解除授权」，已经写进表格的数据会保留在表格里。

### 删除了记录，表格里为什么还在？

删除记录不会同步到表格，需要的话在表格里手动删掉那一行。

## 相关文档

- 想把扫码记录推送到自己的系统：[用 Webhook 把连续扫码器的扫码记录推送到自己的系统](/help/integration-and-connection/continuous-scanner/webhook)
- 草料二维码表单数据同步到腾讯文档：[腾讯文档×草料二维码插件](/help/integration-and-connection/third-party-integration/tencent-docs-plugin)
