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天,而。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
輸入您要擷取資料的儲存格識別碼。 範例: 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天,而。5,因為中午是半天。 1900年2月1日下午3點會是33.625。這正確將1900年視為閏年。

Formatted string

指示日期、時間、日期時間和持續時間欄位,以指定的數字格式(視試算表的地區設定而定)輸出為字串。

Update a Cell

Connection
如需有關將您的Google Sheets帳戶連線到Workfront Fusion的指示,請參閱建立連線 — 基本指示
Spreadsheet
選取Google試算表。
Cell
輸入要更新的儲存格識別碼。 範例: A5
Value
輸入儲存格的新值。
Value input option
  • User entered

    這些值會剖析為使用者在UI中輸入。 數字仍為數字,但字串可能會根據透過Google Sheets UI在儲存格中輸入文字時所套用的相同規則,轉換為數字、日期或其他格式。

  • Raw

    使用者輸入的值不會剖析並依原樣儲存。

Clear a Cell

刪除指定儲存格的值。

Connection
如需有關將您的Google Sheets帳戶連線到Workfront Fusion的指示,請參閱建立連線 — 基本指示
Spreadsheet
選取包含您要清除儲存格之工作表的Google試算表。
Sheet
選取您要清除儲存格的頁面。
Cell
輸入您要清除的儲存格識別碼。 範例: 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

重新計算易失性函式之前要等待的時間量:

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天,而。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天,而。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 you copied>");
      
      }
      
  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