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