Google Sheets模块

在Adobe Workfront Fusion方案中,您可以自动使用Google Sheets的工作流,并将其连接到多个第三方应用程序和服务。

有关将Google Sheets帐户连接到Workfront Fusion的说明,请参阅创建与 Adobe Workfront Fusion 的连接 — 基本说明

访问要求

您必须具有以下权限才能使用本文中的功能:

Adobe Workfront 计划*
Pro 或更高
Adobe Workfront 许可证*
Plan, Work
Adobe Workfront Fusion 许可证**

当前许可证要求:无Workfront Fusion许可证要求。

旧版许可证要求:Workfront Fusion用于工作自动化和集成

产品

当前产品要求:如果您有Select或Prime Adobe Workfront计划,则您的组织必须购买Adobe Workfront Fusion和Adobe Workfront才能使用本文中描述的功能。 Workfront Fusion包含在Ultimate Workfront计划中。

旧版产品要求:您的组织必须购买Adobe Workfront Fusion和Adobe Workfront,才能使用本文中介绍的功能。

要了解您拥有什么计划、许可证类型或访问权限,请与Workfront管理员联系。

有关Adobe Workfront Fusion许可证的信息,请参阅Adobe Workfront Fusion 许可证

先决条件

要使用Google Sheets模块,您必须具有Google帐户。

Google Sheets API信息

Google Sheets连接器使用以下对象:

基本URL
https://sheets.googleapis.com/v4
API版本
v4
API标记
v2.5.7

触发器

Watch Rows

从电子表格中每个新添加的行检索值。

模块仅检索以前未填充的新行。 触发器不会处理被覆盖的行。

IMPORTANT
如果工作表包含空白行,则不会处理空白行之后的行。
Connection
有关将Google Sheets帐户连接到Workfront Fusion的说明,请参阅创建连接 — 基本说明
Spreadsheet
选择包含要监视的工作表的电子表格。
Sheet
选择要监视新行的工作表。
Table contains headers

选择电子表格是否包含标题行。

  • Yes

    模块不会检索标题行作为输出数据。

    输出中的变量名称由标头调用。

  • No

    模块还会检索第一个表行

    输出中的变量名称称为A、B、C、D等。

Row with headers
输入标题行的范围。 例如,A1:F1
First table row
输入表第一行的范围。 例如,A1:F1
Value render option

Formatted value

将根据单元格的格式在回复中计算这些值并设置其格式。 格式设置基于电子表格的区域设置,而不是请求用户的区域设置。 例如,如果A11.23A2=A1并且格式为货币,则A2将返回"$1.23"

Unformatted value

将计算这些值,但不会在回复中设置格式。 例如,如果A11.23A2=A1并且格式为货币,则A2将返回数字"1.23"

Formula

将不计算这些值。 回复将包含公式。 例如,如果A11.23A2=A1并且格式为货币,则A2将返回"=A1"

Date and time render option

Serial number

指示date、time、datetime和duration字段以“序列号”格式输出为两倍,如Lotus 1-2-3所推广。 值的整数部分(小数点左侧)计算自1899年12月30日以来的天数。 小数部分(小数的右侧)将时间计为一天中的小数。 例如,1900年1月1日中午是2.5, 2 ,因为是在1899年12月30日后的2天, 0.5 ,因为中午是半天。 1900年2月1日下午3点将为33:625。这正确地将1900年视为非闰年。

Formatted string

指示日期、时间、日期时间和持续时间字段以给定的数字格式(取决于电子表格的区域设置)作为字符串输出。

Limit
设置Workfront Fusion在一个执行周期内可处理的最大结果数。

操作

Add a Row

此模块用于在工作表中添加行。

配置Google Sheets模块时,Workfront Fusion显示下面列出的字段。 除此以外,可能还会显示其他Google Sheets字段,具体取决于应用程序或服务中的访问级别等因素。 模块中的粗体标题表示必填字段。

如果看到字段或函数上方的映射按钮,则可以使用该按钮设置该字段的变量和函数。 有关详细信息,请参阅将信息从一个模块映射到另一个模块

映射切换

Connection
有关将Google Sheets帐户连接到Workfront Fusion的说明,请参阅创建连接 — 基本说明
Mode

选择您要手动还是通过映射选择电子表格和工作表。

注意:手动映射很有用,例如,在Workfront Fusion方案中创建新电子表格时,而您希望将数据直接添加到方案中新建的电子表格中。

Spreadsheet
选择Google电子表格。
Sheet
选择要向其添加行的工作表。
Column Range
选择要使用的列范围。
Table contains headers

选择电子表格是否包含标题行。

  • Yes

    模块不会检索标题行作为输出数据。

    输出中的变量名称由标头调用。

  • No

    模块还会检索第一个表行

    输出中的变量名称称为A、B、C、D等。

Values
在要添加的行中输入或映射所需的单元格。
Value input option
  • User entered

    这些值会像用户在UI中键入值一样进行解析。 数字仍为数字,但字符串可能会转换为数字、日期或其他格式,这些规则与通过Google Sheets UI在单元格中输入文本时应用的规则相同。

  • Raw

    用户输入的值不会进行解析,而是按原样存储。

Insert data option

指定在输入新数据时如何更改现有数据。

  • Insert rows

    为新数据插入行。

  • Overwrite

    新数据将覆盖其写入区域中的现有数据。 将数据添加到工作表末尾会插入新的行或列,以便写入数据。

Update a Row

此模块允许您更改选定行中的单元格内容。

Connection
有关将Google Sheets帐户连接到Workfront Fusion的说明,请参阅创建连接 — 基本说明
Mode

选择您要手动还是通过映射选择电子表格和工作表。

注意:手动映射很有用,例如,在Workfront Fusion方案中创建新电子表格时,而您希望将数据直接添加到方案中新创建的电子表格时。

Spreadsheet
选择Google电子表格。
Sheet
选择要在其中更新行的工作表。
Row number
输入要更新的行号。
Table contains headers

选择电子表格是否包含标题行。

  • Yes

    模块不会检索标题行作为输出数据。

    输出中的变量名称由标头调用。

  • No

    模块还会检索第一个表行

    输出中的变量名称称为A、B、C、D等。

Values
输入值或将值映射到要更改(更新)的行的所需单元格。
Value input option
  • User entered

    这些值会像用户在UI中键入值一样进行解析。 数字仍为数字,但字符串可能会转换为数字、日期或其他格式,这些规则与通过Google Sheets UI在单元格中输入文本时应用的规则相同。

  • Raw

    用户输入的值不会进行解析,而是按原样存储。

Clear a Row

从指定行中删除值。

Connection
有关将Google Sheets帐户连接到Workfront Fusion的说明,请参阅创建连接 — 基本说明
Spreadsheet
选择包含要从中清除行的工作表的Google电子表格。
Sheet
选择要从中清除数据的工作表。
Row number
输入要从中清除数据的行的编号。 例如, 23

Delete a Row

删除指定的行。

Connection
有关将Google Sheets帐户连接到Workfront Fusion的说明,请参阅创建连接 — 基本说明
Spreadsheet
选择包含您要从中删除行的工作表的Google电子表格。
电子表格
选择要从中删除行的工作表。
行号
输入要删除的行号。 示例: 23

Get a Cell

从选定的单元格中检索值。

Connection
有关将Google Sheets帐户连接到Workfront Fusion的说明,请参阅创建连接 — 基本说明
Spreadsheet
选择Google电子表格。
Sheet
选择包含要从中检索数据的单元格的工作表。
Cell
输入要从中检索数据的单元格的ID。 示例: A6
Value render option

Formatted value

将根据单元格的格式在回复中计算这些值并设置其格式。 格式设置基于电子表格的区域设置,而不是请求用户的区域设置。 例如,如果A11.23A2=A1并且格式为货币,则A2将返回"$1.23"

Unformatted value

将计算这些值,但不会在回复中设置格式。 例如,如果A11.23A2=A1并且格式为货币,则A2将返回数字"1.23"

Formula

将不计算这些值。 回复将包含公式。 例如,如果A11.23A2=A1并且格式为货币,则A2将返回"=A1"

Date and time render option

Serial number

指示date、time、datetime和duration字段以“序列号”格式输出为两倍,如Lotus 1-2-3所推广。 值的整数部分(小数点左侧)计算自1899年12月30日以来的天数。 小数部分(小数的右侧)将时间计为一天中的小数。 例如,1900年1月1日中午是2.5, 2 ,因为是在1899年12月30日后的2天, 0.5 ,因为中午是半天。 1900年2月1日下午3点将为33:625。这正确地将1900年视为非闰年。

Formatted string

指示日期、时间、日期时间和持续时间字段以给定的数字格式(取决于电子表格的区域设置)作为字符串输出。

Update a Cell

Connection
有关将Google Sheets帐户连接到Workfront Fusion的说明,请参阅创建连接 — 基本说明
Spreadsheet
选择Google电子表格。
Cell
输入要更新的单元格的ID。 示例: A5
Value
输入单元格的新值。
Value input option
  • User entered

    这些值会像用户在UI中键入值一样进行解析。 数字仍为数字,但字符串可能会转换为数字、日期或其他格式,这些规则与通过Google Sheets UI在单元格中输入文本时应用的规则相同。

  • Raw

    用户输入的值不会进行解析,而是按原样存储。

Clear a Cell

从指定的单元格中删除值。

Connection
有关将Google Sheets帐户连接到Workfront Fusion的说明,请参阅创建连接 — 基本说明
Spreadsheet
选择包含要从中清除单元格的工作表的Google电子表格。
Sheet
选择要从中清除单元格的工作表。
Cell
输入要清除的单元格的ID。 示例: A5

Add a Sheet

在选定电子表格中创建新工作表。

Connection
有关将Google Sheets帐户连接到Workfront Fusion的说明,请参阅创建连接 — 基本说明
Spreadsheet
选择要添加工作表的Google电子表格。
Properties
  • Title

    输入新工作表的名称。

  • Index

    输入工作表位置。 缺省值为0(将页面放在第一位)

Create a Spreadsheet

Connection
有关将Google Sheets帐户连接到Workfront Fusion的说明,请参阅创建连接 — 基本说明
Title
输入新电子表格的名称。
Locale

使用以下格式之一输入电子表格的区域设置:

  • ISO 639-1语言代码,例如 en
  • ISO 639-2语言代码,例如haw(如果没有639-1代码)
  • ISO语言代码和国家/地区代码的组合,例如 en_US
Recalculation interval

重新计算volatile函数前等待的时间:

On change

在每次更改时更新易失性函数。

On change and every minute

易失性函数在每次更改时和每分钟都会更新。

On change and hourly

易失性函数会在每次更改时每小时更新一次。

Time zone
选择电子表格的时区。
Number format

选择电子表格中所有单元格的默认格式。

Text:文本格式。 示例: 1000. 12

Number:数字格式。 示例: 1,000.12

Percent:百分比格式。 示例: 10. 12%

Currency:货币格式。 示例: $1,000.12

Date:日期格式。 示例: 9/26/2008

Time:时间格式。 示例: 3:59:00 PM

Date time:日期和时间格式。 示例: 9/26/08 15:59:00

Scientific 科学数字格式。 示例: 1. 01E+03

Sheets
单击 Add 向电子表格添加工作表。 对于每个工作表,输入或映射工作表的标题以及工作表的索引。 索引0表示第一个工作表。

Delete a Sheet

删除特定工作表。

Connection
有关将Google Sheets帐户连接到Workfront Fusion的说明,请参阅创建连接 — 基本说明
Spreadsheet
选择Google电子表格。
Sheet
选择要删除的工作表。

Make an API Call

此操作模块允许您执行自定义API调用。

Connection
有关将[Fusion App]帐户连接到Workfront Fusion的说明,请参阅创建与Adobe Workfront Fusion的连接 — 基本说明
URL
输入相对于https://sheets.googleapis.com/v4/的路径。
Method
选择配置API调用所需的HTTP请求方法。 有关详细信息,请参阅HTTP请求方法
Headers
以标准JSON对象的形式添加请求的标头。 例如,{"Content-type":"application/json"}。 Workfront Fusion为您添加授权标头。
Query String
以标准JSON对象的形式添加API调用的查询。
Body

以标准JSON对象的形式添加API调用的正文内容。

注意:

在JSON中使用条件语句(如if)时,请将引号放在条件语句之外。

搜索

Search Rows

使用过滤器选项搜索行。

Connection
有关将[Fusion App]帐户连接到Workfront Fusion的说明,请参阅创建与Adobe Workfront Fusion的连接 — 基本说明
Spreadsheet
选择Google电子表格。
Sheet
选择要在其中搜索行的工作表。
Table contains headers
选择电子表格是否包含标题行。 如果选择Yes选项,模块不会检索标头行,因为输出数据以及输出中的变量名称随后由标头调用。 如果选择了No选项,则模块还会检索第一个表行,然后只调用输出中的变量名称A、B、C、D等。
Column range
选择要使用的列范围。 示例: A-F
Filter

为要搜索的行设置过滤器。

Sort order
选择是要升序排序还是降序排序。
Order by
选择要作为排序依据的列。
Value render option

Formatted value

将根据单元格的格式在回复中计算这些值并设置其格式。 格式设置基于电子表格的区域设置,而不是请求用户的区域设置。 例如,如果A11.23A2=A1并且格式为货币,则A2将返回"$1.23"

Unformatted value

将计算这些值,但不会在回复中设置格式。 例如,如果A11.23A2=A1并且格式为货币,则A2将返回数字"1.23"

Formula

将不计算这些值。 回复将包含公式。 例如,如果A11.23A2=A1并且格式为货币,则A2将返回"=A1"

Date and time render option

Serial number

指示date、time、datetime和duration字段以“序列号”格式输出为两倍,如Lotus 1-2-3所推广。 值的整数部分(小数点左侧)计算自1899年12月30日以来的天数。 小数部分(小数的右侧)将时间计为一天中的小数。 例如,1900年1月1日中午是2.5, 2 ,因为是在1899年12月30日后的2天, 0.5 ,因为中午是半天。 1900年2月1日下午3点将为33:625。这正确地将1900年视为非闰年。

Formatted string

指示日期、时间、日期时间和持续时间字段以给定的数字格式(取决于电子表格的区域设置)作为字符串输出。

Maximum number of returned rows
设置Workfront Fusion在一个执行周期内返回的最大行数。

Search Rows (Advanced)

返回与给定条件匹配的结果。

Connection
有关将Google Sheets帐户连接到Workfront Fusion的说明,请参阅创建连接 — 基本说明
Spreadsheet
选择包含要搜索的工作表的Google电子表格。
Sheet
选择包含要搜索的行的工作表。
Query

使用Google Charts Query Language。 示例: select * where B = "John"

有关Google Charts Query Language的详细信息,请参阅Google文档中的查询语言引用

Get Range Values

Connection
有关将Google Sheets帐户连接到Workfront Fusion的说明,请参阅创建连接 — 基本说明
Spreadsheet
选择Google电子表格。
Sheet
选择要从中获取范围内容的工作表。
Range
输入要获取的范围。 示例: A1:D25
Table contains headers
如果工作表具有标题行,请选中此框
Row with headers
输入表标题的范围。 示例A1:F1。 如果将字段留空,Workfront Fusion将假定标题位于指定范围的第一行。
Value render option

Formatted value

将根据单元格的格式在回复中计算这些值并设置其格式。 格式设置基于电子表格的区域设置,而不是请求用户的区域设置。 例如,如果A11.23A2=A1并且格式为货币,则A2将返回"$1.23"

Unformatted value

将计算这些值,但不会在回复中设置格式。 例如,如果A11.23A2=A1并且格式为货币,则A2将返回数字"1.23"

Formula

将不计算这些值。 回复将包含公式。 例如,如果A11.23A2=A1并且格式为货币,则A2将返回"=A1"

Date and time render option

Serial number

指示date、time、datetime和duration字段以“序列号”格式输出为两倍,如Lotus 1-2-3所推广。 值的整数部分(小数点左侧)计算自1899年12月30日以来的天数。 小数部分(小数的右侧)将时间计为一天中的小数。 例如,1900年1月1日中午是2.5, 2 ,因为是在1899年12月30日后的2天, 0.5 ,因为中午是半天。 1900年2月1日下午3点将为33:625。这正确地将1900年视为非闰年。

Formatted string

指示日期、时间、日期时间和持续时间字段以给定的数字格式(取决于电子表格的区域设置)作为字符串输出。

List Sheets

此模块返回电子表格中所有工作表的列表。

Connection
有关将Google Sheets帐户连接到Workfront Fusion的说明,请参阅创建连接 — 基本说明
Spreadsheet
选择包含要列出工作表的Google电子表格。

使用限制

如果发生错误429: RESOURCE_EXHAUSTED,则表示您已超出API速率限制。

Google Sheets API限制每个项目每100秒500个请求,每个用户每100秒100个请求。 对读取和写入的限制将单独进行跟踪。 没有每日使用量限制。

有关更多详细信息,请访问developers.google.com/sheets/api/limits

提示和技巧

如何从Google Sheet获取空单元格

使用Search Rows (Advanced)模块并使用此公式获取空列。

选择*,其中E为null

在工作表中添加按钮以运行方案

  1. 在Workfront Fusion中,在方案中插入​ Webhook > Custom webhooks ​模块/触发器并配置它(请参阅Webhooks)。

  2. 复制webhook的URL。

  3. 执行方案。

  4. 在Google工作表中,从主菜单栏中选择​ Insert > Drawing…。

  5. 在Drawing窗口中,单击窗口顶部附近的​ Text box ​图标 文本框

  6. 设计一个按钮并单击右上角的​ Save and Close ​按钮:

  7. 该按钮将放置在您的工作表中。 单击按钮右上角的三个垂直圆点:

  8. 选择​ Assign script…。菜单中的

  9. 输入脚本(函数)的名称,如runScenario,然后单击​ OK

  10. 从主菜单栏选择​ Tools > Script editor

  11. 插入以下代码:

    • 函数的名称必须对应于您在步骤9中指定的名称。

    • 将URL替换为您在步骤2中复制的webhook URL。

      函数runScenario() {
      
      UrlFetchApp.fetch("<您已复制的webhook>");
      
      }
      
  12. 按​ Ctrl+S ​保存脚本文件,输入项目名称,然后单击​ OK

  13. 切换回Google Sheets并单击新按钮。

  14. 向脚本授予所需的授权:

  15. 在Workfront Fusion中,验证方案是否已成功执行。

在电子表格中存储日期

如果在没有任何格式的电子表格中存储日期值,则该日期值将在电子表格中显示为ISO 8601格式的文本。 但是,使用日期的Google Sheets公式或函数不理解此文本(示例:公式=A1+10)将显示以下错误:

错误

为了帮助Google Sheets了解日期,请使用formatDate (date; format; [timezone])函数设置其格式。 传递给函数的正确格式(作为第二个参数)取决于电子表格的区域设置设置。

要确定正确的格式,请执行以下操作:

  1. 从主菜单中选择​ File > Spreadsheet ​设置以验证/设置区域设置。

  2. 验证/设置正确的区域设置后,从主菜单中选择​ Format > Number ​来确定相应的日期和时间格式。 格式显示在日期时间菜单项旁边:

  3. 要撰写应传递到formatDate()函数的正确格式,请参阅令牌列表以了解日期和时间格式

示例: ​对美国区域设置使用MM/DD/YYYY HH:mm:ss格式:

区域设置时间公式

正在利用Google Sheets功能

如果您缺少内置功能,但它由Google Sheets提供,则您可以利用它。 有关详细信息,请参阅使用 Adobe Workfront Fusion中的函数映射项中的使用 Google Sheets 函数

保留Google Sheets不将数字更改为日期

您可能会发现用作文本的字符串被解释为Google工作表中的日期。 例如,您键入1-2019,打算将其解释为文本,但Google会将其解释为日期。 您可以将此数字预设置为纯文本格式以防止出现这种情况。

  1. 在Google Sheets中,突出显示包含数字的列或单元格。
  2. 单击​ Format > Number > Plain text

Workfront Fusion中的另一种解决方法是在数字前键入撇号('),例如,'1-2019或'1/47。 从Workfront Fusion发送数据后,单元格中不显示撇号。

recommendation-more-help
7e1891ad-4d59-4355-88ab-a2e62ed7d1a3