Google Sheets 插件
AutomaDoc 插件在电子表格旁边的侧边栏中运行。电子表格的每个工作表都有自己的模板；标题行下方的每一行是一条记录，每一列是一个占位符。
- 从 Google Workspace Marketplace 安装 AutomaDoc（即将上架）。上架之前，请在 Company Portal 的集成中连接 Google Sheets，并通过 HTTP 触发器或文档 API 生成文档。
- 打开一个电子表格，选择扩展程序 → AutomaDoc → 打开。
第一次使用时，Google 会请您授权该插件。它请求的权限很少：读取您当前打开的电子表格（而不是您的其他文件）、显示其菜单和侧边栏，以及获取您的邮箱地址以便为您登录。
侧边栏有四个选项卡：生成、模板、变量和更多。
插件会用您在 Google Sheets 中使用的 Google 账户自动为您登录，无需单独的密码。您进入哪个 AutomaDoc 账户取决于这个 Google 账户：
- Google Workspace 账户会加入您所在域的 AutomaDoc 账户（该域第一个使用的人创建该账户并成为管理员）；
- 个人 Google 账户（例如 Gmail）拥有自己的邮箱账户。
Google 必须已验证您的邮箱地址，否则 AutomaDoc 无法为您登录。更多下的退出登录会让您退出插件；重新登录可再次登录。账户的工作方式请参见使用 Microsoft、Google 或邮箱登录。
连接此电子表格
Section titled “连接此电子表格”插件自身的权限只允许侧边栏读取当前打开的电子表格。文档在 AutomaDoc 的服务器上生成，服务器以您的 Google 权限读取表格，因此每个人在某个电子表格上创建或使用模板之前，都需要先连接该电子表格一次。
- 点击连接此电子表格。会打开一个 Google 窗口。如果浏览器拦截了它，请允许 Google Sheets 的弹出窗口，然后重试。
- 使用与 Sheets 中相同的 Google 账户登录，并保持勾选对您所选 Google Drive 文件的访问权限。
- Google 的文件选择器只显示一个文件：您当前打开的电子表格。选择它。
- 窗口显示电子表格已连接。关闭窗口，回到 Google Sheets。
侧边栏会自动察觉。如果它仍在等待，请点击我已完成。
这是 Google 的 drive.file 权限：AutomaDoc 只能打开您以这种方式选择的电子表格，以及它在您的 Google Drive 中创建的文件，不能打开 Google Drive 中的其他任何内容。
如果 AutomaDoc 的访问权限之后失效（您断开了连接、Google 管理员撤销了授权，或登录已过期），侧边栏会显示重新连接 Google。按同样的方式再次连接即可。
模板属于您当前打开的工作表。顶部的选择器在**“{tab}”的模板**（即该工作表的名称）下列出它们；在 Sheets 中切换到另一个工作表，侧边栏就会显示那个工作表的模板。
- 点击新建模板（在生成选项卡中，或选择器中的新建模板）。
- 填写模板名称。
- 设置标题行：存放列名的那一行。记录是它下方的各行。除非您的表格从更靠下的位置开始，否则它就是第 1 行。
- 选择键列：值唯一的列，例如发票编号。无：使用行号则用行号来标识每条记录。
- 点击创建模板。
只要有其他人编辑表格，就请选择一个键列。AutomaDoc 在写回状态或链接时会按键值重新找到每一行，因此在生成文档期间对表格排序或插入行，都不会把结果写到错误的行。键值为空的行会被跳过，而同一个键值出现在多行时，相应文档会失败：侧边栏会在您生成之前对这两种情况发出提醒。
选择器中的导入模板会根据 .automadoc 文件为此工作表创建模板。参见导出、导入与复制。
上传模板文件
Section titled “上传模板文件”在模板选项卡中，点击上传模板文件，选择 Word（.docx）、Excel（.xlsx）或 PowerPoint（.pptx）文件。文件会在上传时接受检查；如果有错误，侧边栏会说明，您可以用替换文件上传修正后的文件。
占位符以您的列名命名，语法与所有平台相同。空格、点号和其他符号会变成 _，任何语言的字母和数字都会保留：
| 列名 | 占位符 |
|---|---|
Customer |
{Customer} |
Invoice No. |
{Invoice_No_} |
Unit price |
{Unit_price} |
第二个同名列会变成 {Notes_2}，第三个变成 {Notes_3}，因此不会互相覆盖。没有名称的列会被忽略。
各类单元格提供给模板的内容
Section titled “各类单元格提供给模板的内容”每个单元格都打印表格中显示的内容。number、currency 和 date 等过滤器则作用于其底层的值。
| 单元格中的内容 | 在模板中 |
|---|---|
| 文本 | 文本 |
| 数字、货币、百分比 | 一个数字，按表格的格式打印 |
| 日期、日期时间 | 一个日期，按表格的格式打印 |
| 复选框 | 是或否，用于 {#if Paid}…{/if} |
| 下拉列表 | 所选选项；多选下拉列表是一个列表 |
| 人员智能条状标签 | 人员列表（姓名和邮箱） |
| 链接，或富链接智能条状标签 | 链接 |
| 文件智能条状标签，或 Google Drive 文件的链接 | 文件，用于图片和 {ATTACH:…} |
=IMAGE("https://…") |
一张图片 |
数据与写回设置
Section titled “数据与写回设置”数据部分包含模板名称、标题行和键列，以及一个开关，用于生成 PDF 文档 (.pdf) 而不是模板本身的格式。更改后请点击保存。
写回表格会把结果写入表格：
- 状态列：每一行的生成状态会写入此列。
- 链接列：每份生成文档的链接会写入此列。在当单元格已有链接时下，选择替换或添加新的一行（保留之前的链接，每行一个）。
链接列需要专业版、试用或您自己的席位。状态列需要专业版、试用或 Business 席位。不具备这些条件时，侧边栏会说明，相关设置保持关闭。参见套餐、席位与文档包。
选项卡底部的删除模板会删除该模板。您的表格不会被改动。
上传模板文件（或替换文件）旁的从列生成会生成一个 Word 模板，其中包含该工作表每一列的占位符，关联工作表的列作为循环，并将其保存为模板文件。请先保存更改：入门模板根据已保存的标题行和关联工作表生成。
文件名与每次生成的文档
Section titled “文件名与每次生成的文档”在数据部分，输出文件名格式为每个文件命名：花括号中的列名会替换为该行的值，例如 发票-{发票号}。留空则使用模板名称和行号。
对于 Word 模板，每次生成的文档可选择每条记录一份文档，或由所有选中行生成一份文档：列表、每行重复一次的模板，或一页标签。请参阅合并文档。
其他工作表的行可以放入每份文档：例如发票的明细行、客户信息。在关联工作表中点击添加关联，然后设置：
- 模板中的名称：占位符，例如
Items； - 来源工作表：包含这些行的工作表；
- 其用于匹配的列：该工作表中包含本行值的列，例如发票号；
- 与本工作表的此列匹配：键列，或本工作表的其他列；
- 行：
{#Items}{说明}{/Items}选所有匹配的行（循环），{客户.名称}选第一个匹配的行。
点击保存。工作表重命名后，关联仍会跟随该工作表。一个模板最多可有 20 个关联。
变量选项卡列出模板的所有占位符，读取自该工作表及其关联工作表。点击即可复制，然后粘贴到模板中。关联工作表的列列在其循环或嵌套记录下方。
选择行并生成
Section titled “选择行并生成”- 打开生成选项卡，在选择器中选择模板。
- 在表格中选择行：点击行号，按住 Shift 或 Ctrl（Mac 上为 ⌘）可选择多行。选中单元格时，会计算它们所在的行。
- 侧边栏会统计行数（已选择 1 行、已选择 12 行）。点击生成文档或生成 {count} 份文档。
一次生成最多 500 行。如果侧边栏不再跟随您的选择（一段时间无操作后它会暂停），请点击刷新。
进度卡片会跟踪这些文档。每份完成的文档都有下载和打印；取消会停止尚未开始的文档。
如果模板设置为多条记录生成一份文档，侧边栏会提供已选（n）或整个工作表两个选项，并用最多 500 行生成一份文档。
- 始终：在侧边栏的进度卡片中，可下载或打印。
- 设置了链接列时：文件还会保存到您的 Google Drive 中，与电子表格位于同一文件夹；AutomaDoc 无法访问该文件夹时，则保存到“我的云端硬盘”。该行的单元格会得到一个指向它的链接，以文件名命名。用多行生成的一份文档只保存一次，并从它的每一行链接过去。
- 设置了状态列时：生成文档期间，每一行都会显示其状态。
由于 AutomaDoc 只读取您为它选择的文件，图片必须是以下之一：
- 图片的公开链接，写在单元格中或
=IMAGE("https://…")中； - AutomaDoc 能打开的 Google Drive 文件：您为 AutomaDoc 选择的文件，或它自己创建的文件。
AutomaDoc 无法打开的 Google Drive 文件不会出现在文档中，并会有一条指明该列的警告。Google 文档、表格、幻灯片和绘图文件会由 {ATTACH:…} 以 PDF 形式添加到 PDF 中；此类文件只有在 10 MB 以内时，Google 才能将其导出为 PDF。单个文件最大 20 MB。
在更多下，断开 Google 云端硬盘访问会移除 AutomaDoc 对您 Google Drive 文件的访问权限：授权会在 Google 端撤销，您的模板会保留，生成时会要求您重新连接电子表格。您也可以在企业门户的连接页面断开连接（参见连接您的数据）。
如需移除插件本身，请在 Google Sheets 中使用扩展程序 → 插件 → 管理插件。
在更多下，套餐会向管理员显示管理套餐：套餐、席位和文档包在企业门户中购买，门户会在浏览器中打开。成员会看到可以联系哪些管理员。帮助与文档会打开这些文档页面。