Google Sheets 模块
在 Adobe Workfront Fusion 场景中，您可以自动化使用 Google Sheets 的工作流，并将其连接到多个第三方应用程序和服务。
有关将Google Sheets帐户连接到Workfront Fusion的说明，请参阅创建与Adobe Workfront Fusion的连接 — 基本说明
访问权限要求
| table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header | |
|---|---|
| Adobe Workfront 包 |
任意 Adobe Workfront Workflow 包以及任意 Adobe Workfront 自动化和集成包 Workfront Ultimate Workfront Prime 和 Select 包，且需额外购买 Workfront Fusion。 |
| Adobe Workfront 许可证 |
标准 工作版或更高版本 |
| Adobe Workfront Fusion 许可证 |
基于操作：不需要 Workfront Fusion 许可证 基于连接器（旧版）：Workfront Fusion for Work Automation and Integration |
| 产品 | 如果您的组织使用的 Workfront Select 或 Prime 包不包含 Workfront 自动化和集成，则必须单独购买 Adobe Workfront Fusion。 |
有关此表中信息的更多详细说明，请参阅文档中的访问权限要求。
有关 Adobe Workfront Fusion 许可证的详细信息，请参阅 Adobe Workfront Fusion 许可证。
先决条件
要使用Google工作表模块，您必须具有Google帐户。
Google Sheets API信息
Google Sheets连接器使用以下对象：
Google Sheets模块及其字段
在您配置 Google Forms 模块时，Workfront Fusion 会显示以下字段。 除这些字段外，根据您的应用程序或服务访问权限级别，可能会显示更多 Google Sheets 字段。 模块中的加粗标题表示必填字段。
如果您看到字段或功能上方的映射按钮，可使用它为该字段设置变量和函数。 有关详细信息，请参阅将信息从一个模块映射到另一个模块。
触发器
观察行
从电子表格中新添加的行检索值。
模块仅检索之前未填充的新行。 触发器不会处理被覆盖的行。
操作
添加行
此模块用于在工作表中添加行。
在您配置 Google Sheets 模块时，Workfront Fusion 会显示以下字段。 除这些字段外，根据您的应用程序或服务访问权限级别，可能会显示更多 Google Sheets 字段。 模块中的加粗标题表示必填字段。
如果您看到字段或功能上方的映射按钮，可使用它为该字段设置变量和函数。 有关详细信息，请参阅将信息从一个模块映射到另一个模块。
添加工作表
在选定电子表格中创建新工作表。
清除单元格
从指定的单元格中删除值。
清除行
从指定行中删除值。
创建电子表格
删除行
删除指定的行。
删除工作表
删除特定工作表。
获取单元格
从选定的单元格中检索值。
进行API调用
此操作模块允许您执行自定义API调用。
https://sheets.googleapis.com/v4/ 的路径。{"Content-type":"application/json"}。 Workfront Fusion会为您添加授权标头。以标准 JSON 对象的形式添加 API 调用的正文内容。
注意：
在 JSON 中使用 if 等条件语句时，需将引号置于条件语句外部。
更新单元格
更新行
此模块允许您更改选定行中的单元格内容。
列表工作表
此模块返回电子表格中所有工作表的列表。
搜索行
使用过滤器选项搜索行。
搜索行（高级）
返回与给定条件匹配的结果。
使用限制
如果发生错误429: RESOURCE_EXHAUSTED，则表示您已超出API速率限制。
Google Sheets API限制每个项目每100秒500个请求，每个用户每100秒100个请求。 对读取和写入的限制将单独进行跟踪。 没有每日使用量限制。
有关更多详细信息，请访问developers.google.com/sheets/api/limits。
提示和技巧
从Google Sheet获取空单元格
若要获取空单元格，您可以使用搜索行（高级）模块。 使用此公式可获取空列。
select * where E is null
其中，“E”是列，“is null”是条件。 您可以使用Google查询语言创建更高级的查询。 有关详细信息，请参阅Google文档中的Google查询Lang。
在工作表中添加按钮以运行方案
-
在Workfront Fusion中，在场景中插入Webhook > 自定义Webhook模块并对其进行配置。 有关说明，请参阅Webhooks。
-
复制webhook的URL。
-
执行方案。
-
在Google工作表中，从主菜单栏中选择插入 > 绘图…。
-
在绘图窗口中，单击窗口顶部附近的 文本框 图标
-
设计一个按钮，然后单击右上角的 保存并关闭 按钮：
-
该按钮即放置在您的工作表中。 单击按钮右上角的三个垂直圆点：
-
从菜单中选择分配脚本…….。
-
输入脚本（函数）的名称，如
runScenario，然后单击确定： -
从主菜单栏中选择工具 > 脚本编辑器。
-
插入以下代码：
-
函数的名称必须对应于您在步骤9中指定的名称。
-
将URL替换为您在步骤2中复制的webhook URL。
code language-none function runScenario() { UrlFetchApp.fetch("<webhook you copied>"); }
-
-
按 Ctrl+S 保存脚本文件，输入项目名称，然后单击确定。
-
切换回Google Sheets并单击新按钮。
-
向脚本授予所需的授权：
-
在Workfront Fusion中，验证场景是否已成功执行。
在电子表格中存储日期
如果在没有任何格式的电子表格中存储日期值，则该日期值会在电子表格中显示为ISO 8601格式的文本。 但是，使用不了解此文本的日期的Google Sheets公式或函数（示例：公式=A1+10）显示以下错误：
为了帮助Google Sheets了解日期，请使用formatDate函数设置其格式。 传递给函数的正确格式（作为第二个参数）取决于电子表格的区域设置设置。
有关此函数的更多信息，请参阅日期和时间函数一文中的formatDate (date； format； [timezone])。
要确定正确的格式，请执行以下操作：
-
在Google Sheets中，从主菜单中选择文件 > 电子表格设置以验证和设置区域设置。
-
验证或设置正确的区域设置后，从主菜单中选择格式 > 数字来确定相应的日期和时间格式。 格式显示在日期时间菜单项旁边：
-
要撰写应传递到formatDate()函数的正确格式，请参阅令牌列表以了解日期和时间格式。
示例：
对于MM/DD/YYYY HH:mm:ss格式（适用于美国区域设置）：
正在利用Google Sheets功能
要使用Google Sheets中的内置函数，您可以对其进行利用。 有关详细信息，请参阅“使用函数映射项”一文中的使用 Google Sheets 函数。
阻止Google Sheets将数字更改为日期
如果用作文本的字符串被解释为Google工作表中的日期，您可以将此数字预设置为纯文本格式以防止出现这种情况。 例如，如果您键入1-2019，打算将其解释为文本，Google可能会将其解释为日期。
- 在Google Sheets中，突出显示包含数字的列或单元格。
- 单击格式 > 数字 > 纯文本。
Workfront Fusion中的另一种解决方法是在数字前键入撇号(')，例如，“1-2019”或“1/47”。 从Workfront Fusion发送数据后，单元格中不显示撇号。