Google Sheets模块
在Adobe Workfront Fusion方案中,您可以自动使用Google Sheets的工作流,并将其连接到多个第三方应用程序和服务。
有关将Google Sheets帐户连接到Workfront Fusion的说明,请参阅创建与 Adobe Workfront Fusion 的连接 — 基本说明
访问要求
您必须具有以下权限才能使用本文中的功能:
要了解您拥有什么计划、许可证类型或访问权限,请与Workfront管理员联系。
有关Adobe Workfront Fusion许可证的信息,请参阅Adobe Workfront Fusion 许可证。
先决条件
要使用Google工作表模块,您必须具有Google帐户。
Google Sheets API信息
Google Sheets连接器使用以下对象:
触发器
观察行
从电子表格中每个新添加的行检索值。
模块仅检索以前未填充的新行。 触发器不会处理被覆盖的行。
操作
添加行
此模块用于在工作表中添加行。
配置Google Sheets模块时,Workfront Fusion显示下面列出的字段。 除此以外,可能还会显示其他Google Sheets字段,具体取决于应用程序或服务中的访问级别等因素。 模块中的粗体标题表示必填字段。
如果看到字段或函数上方的映射按钮,则可以使用该按钮设置该字段的变量和函数。 有关详细信息,请参阅在 Adobe Workfront Fusion中将信息从一个模块映射到另一个模块。
更新行
此模块允许您更改选定行中的单元格内容。
清除行
从指定行中删除值。
删除行
删除指定的行。
获取单元格
从选定的单元格中检索值。
更新单元格
清除单元格
从指定的单元格中删除值。
添加工作表
在选定电子表格中创建新工作表。
创建电子表格
搜索行(高级)
返回与给定条件匹配的结果。
获取范围值
列表工作表
此模块返回电子表格中所有工作表的列表。
使用限制
如果发生错误429: RESOURCE_EXHAUSTED
,则表示您已超出API速率限制。
Google Sheets API限制每个项目每100秒500个请求,每个用户每100秒100个请求。 对读取和写入的限制将单独进行跟踪。 没有每日使用量限制。
有关更多详细信息,请访问developers.google.com/sheets/api/limits。
提示和技巧
如何从Google Sheet获取空单元格
使用搜索行(高级)模块并使用此公式获取空列。
选择*,其中E为null
在工作表中添加按钮以运行方案
-
在Workfront Fusion中,在场景中插入 Webhook > 自定义Webhook 模块/触发器并对其进行配置(请参阅Webhooks)。
-
复制webhook的URL。
-
执行方案。
-
在Google工作表中,从主菜单栏中选择 插入 > 绘图…。
-
在绘图窗口中,单击窗口顶部附近的 文本框 图标 。
-
设计一个按钮,然后单击右上角的 保存并关闭 按钮:
-
该按钮将放置在您的工作表中。 单击按钮右上角的三个垂直圆点:
-
选择 分配脚本……。菜单中的。
-
输入脚本(函数)的名称,如
runScenario
,然后单击 确定: -
从主菜单栏中选择 工具 > 脚本编辑器。
-
插入以下代码:
-
函数的名称必须对应于您在步骤9中指定的名称。
-
将URL替换为您在步骤2中复制的webhook URL。
函数runScenario() {
UrlFetchApp.fetch("<您已复制的webhook>");
}
-
-
按 Ctrl+S 保存脚本文件,输入项目名称,然后单击 确定。
-
切换回Google Sheets并单击新按钮。
-
向脚本授予所需的授权:
-
在Workfront Fusion中,验证方案是否已成功执行。
在电子表格中存储日期
如果在没有任何格式的电子表格中存储日期值,则该日期值将在电子表格中显示为ISO 8601格式的文本。 但是,使用日期的Google Sheets公式或函数不理解此文本(示例:公式=A1+10
)将显示以下错误:
为了帮助Google Sheets了解日期,请使用formatDate (date; format; [timezone])函数设置其格式。 传递给函数的正确格式(作为第二个参数)取决于电子表格的区域设置设置。
要确定正确的格式,请执行以下操作:
-
从主菜单中选择 文件 > 电子表格 设置以验证/设置区域设置。
-
验证/设置正确的区域设置后,从主菜单中选择 格式 > 数字 来确定相应的日期和时间格式。 格式显示在日期时间菜单项旁边:
-
要撰写应传递到formatDate()函数的正确格式,请参阅令牌列表,了解 Adobe Workfront Fusion中的日期和时间格式。
示例: 对美国区域设置使用MM/DD/YYYY HH:mm:ss
格式:
正在利用Google Sheets功能
如果您缺少内置功能,但它由Google Sheets提供,则您可以利用它。 有关详细信息,请参阅使用 Adobe Workfront Fusion中的函数映射项中的使用 Google Sheets 函数。
保留Google Sheets不将数字更改为日期
您可能会发现用作文本的字符串被解释为Google工作表中的日期。 例如,您键入1-2019,打算将其解释为文本,但Google会将其解释为日期。 您可以将此数字预设置为纯文本格式以防止出现这种情况。
- 在Google Sheets中,突出显示包含数字的列或单元格。
- 单击 格式 > 数字 > 纯文本。
Workfront Fusion中的另一种解决方法是在数字前键入撇号('),例如,'1-2019或'1/47。 从Workfront Fusion发送数据后,单元格中不显示撇号。