Google Sheets模組

在Adobe Workfront Fusion案例中,您可以自動化使用Google Sheets的工作流程,並將其連線至多個協力廠商應用程式和服務。

如需有關將您的Google Sheets帳戶連線到Workfront Fusion的指示,請參閱建立連線到 Adobe Workfront Fusion — 基本指示

存取需求

您必須具有下列存取權才能使用本文中的功能:

Adobe Workfront 計畫*
Pro或更高版本
Adobe Workfront 授權*
計畫,工作
Adobe Workfront Fusion 授權**

目前授權需求:無Workfront Fusion授權需求。

舊版授權需求:Workfront Fusion for Work Automation and Integration

產品

目前產品需求:如果您有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工作表模組,您必須有Google帳戶。

Google Sheets API資訊

Google Sheets聯結器使用下列專案:

基礎URL
https://sheets.googleapis.com/v4
API版本
v4
API標籤
v2.5.7

觸發器

觀看列

從試算表中每個新新增的列擷取值。

模組只會擷取之前未填入的新列。 觸發器不會處理覆寫的列。

IMPORTANT
如果工作表包含空白列,則不會處理空白列之後的列。
Connection
如需有關將您的Google Sheets帳戶連線到Workfront Fusion的說明,請參閱在Adobe Workfront Fusion中建立案例一文中的將模組的應用程式或Web服務連線到Workfront Fusion
Spreadsheet
選取包含您要觀看之表格的試算表。
工作表
選取要監視新列的工作表。
表格包含標題

選取試算表是否包含標題列。

  • 模組不會將標題列擷取為輸出資料。

    輸出中的變數名稱由標題呼叫。

  • 號碼

    模組也會擷取第一個表格列

    輸出中的變數名稱稱為A、B、C、D等等。

含標題列
輸入頁首列的範圍。 例如,A1:F1
第一個表格列
輸入表格第一列的範圍。 例如,A1:F1
值演算選項

格式值

將根據儲存格的格式在回覆中計算並格式化值。 格式設定是以試算表的地區設定為基礎,而非請求使用者的地區設定。 例如,如果A11.23A2=A1且已格式化為貨幣,則A2會傳回"$1.23"

未格式化的值

系統會計算值,但不會在回覆中設定格式。 例如,如果A11.23A2=A1且已格式化為貨幣,則A2會傳回數字"1.23"

公式

將不會計算值。 回覆將包含公式。 例如,如果A11.23A2=A1且已格式化為貨幣,則A2會傳回"=A1"

日期和時間轉譯選項

序號

指示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年視為閏年。

格式字串

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

限制
設定Workfront Fusion在一個執行週期內可處理的最大結果數量。

動作

新增列

此模組會附加一列至工作表。

當您設定Google Sheets模組時,Workfront Fusion會顯示下列欄位。 除了這些欄位以外,可能還會顯示其他Google Sheets欄位,視您在應用程式或服務中的存取層級等因素而定。 模組中的粗體標題表示必填欄位。

如果您在欄位或函式上方看到對應按鈕,則可以使用它來設定該欄位的變數和函式。 如需詳細資訊,請參閱在 Adobe Workfront Fusion中將資訊從一個模組對應到另一個模組。

Connection
如需有關將您的Google Sheets帳戶連線到Workfront Fusion的說明,請參閱在Adobe Workfront Fusion中建立案例一文中的將模組的應用程式或Web服務連線到Workfront Fusion
模式

選取您要手動選取試算表與工作表,還是透過對應。

附註:例如在Workfront Fusion案例中建立新的試算表,而您想要直接在案例中新增資料到新建立的試算表時,手動對應就很實用。

Spreadsheet
選取Google試算表。
工作表
選取要新增列的頁面。
欄範圍
選取您要使用的欄範圍。
表格包含標題

選取試算表是否包含標題列。

  • 模組不會將標題列擷取為輸出資料。

    輸出中的變數名稱由標題呼叫。

  • 號碼

    模組也會擷取第一個表格列

    輸出中的變數名稱稱為A、B、C、D等等。

在要新增的資料列中,輸入或對應所需的儲存格。
值輸入選項
  • 使用者已進入

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

  • Raw

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

插入資料選項

指定輸入新資料時如何變更現有資料。

  • 插入列

    會為新資料插入列。

  • 覆寫

    新資料會覆寫其寫入區域中的現有資料。 將資料加入工作表結尾會插入新的列或欄,以便寫入資料。

更新列

此模組可讓您變更所選列中的儲存格內容。

Connection
如需有關將您的Google Sheets帳戶連線到Workfront Fusion的說明,請參閱在Adobe Workfront Fusion中建立案例一文中的將模組的應用程式或Web服務連線到Workfront Fusion
模式

選取您要手動選取試算表與工作表,還是透過對應。

注意:例如在Workfront Fusion情境中建立新試算表時,而您想要直接在情境中新增資料至新建立的試算表時,手動對應就相當實用。

Spreadsheet
選取Google試算表。
工作表
選取要更新資料列的工作表。
列號
輸入您要更新的資料列編號。
表格包含標題

選取試算表是否包含標題列。

  • 模組不會將標題列擷取為輸出資料。

    輸出中的變數名稱由標題呼叫。

  • 號碼

    模組也會擷取第一個表格列

    輸出中的變數名稱稱為A、B、C、D等等。

輸入值或將值對應至要變更(更新)之列的所需儲存格。
值輸入選項
  • 使用者已進入

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

  • Raw

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

清除列

從指定的列刪除值。

Connection
如需有關將您的Google Sheets帳戶連線到Workfront Fusion的說明,請參閱在Adobe Workfront Fusion中建立案例一文中的將模組的應用程式或Web服務連線到Workfront Fusion
Spreadsheet
選取包含您要清除資料列之工作表的Google試算表。
工作表
選取您要清除其資料的工作表。
列號
輸入您要清除資料的資料列編號。 例如, 23

刪除列

刪除指定的列。

Connection
如需有關將您的Google Sheets帳戶連線到Workfront Fusion的說明,請參閱在Adobe Workfront Fusion中建立案例一文中的將模組的應用程式或Web服務連線到Workfront Fusion
Spreadsheet
選取包含您要刪除列之工作表的Google試算表。
選取您要從中刪除資料列的頁面。
列號
輸入要刪除的列數。 範例: 23

取得儲存格

從選取的儲存格擷取值。

Connection
如需有關將您的Google Sheets帳戶連線到Workfront Fusion的說明,請參閱在Adobe Workfront Fusion中建立案例一文中的將模組的應用程式或Web服務連線到Workfront Fusion
Spreadsheet
選取Google試算表。
工作表
選取包含您要擷取資料之儲存格的工作表。
儲存格
輸入您要擷取資料的儲存格識別碼。 範例: A6
值演算選項

格式值

將根據儲存格的格式在回覆中計算並格式化值。 格式設定是以試算表的地區設定為基礎,而非請求使用者的地區設定。 例如,如果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

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

更新儲存格

Connection
如需有關將您的Google Sheets帳戶連線到Workfront Fusion的說明,請參閱在Adobe Workfront Fusion中建立案例一文中的將模組的應用程式或Web服務連線到Workfront Fusion
Spreadsheet
選取Google試算表。
儲存格
輸入要更新的儲存格識別碼。 範例: A5
輸入儲存格的新值。
值輸入選項
  • 使用者已進入

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

  • Raw

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

清除儲存格

刪除指定儲存格的值。

Connection
如需有關將您的Google Sheets帳戶連線到Workfront Fusion的說明,請參閱在Adobe Workfront Fusion中建立案例一文中的將模組的應用程式或Web服務連線到Workfront Fusion
Spreadsheet
選取包含您要清除儲存格之工作表的Google試算表。
工作表
選取您要清除儲存格的頁面。
儲存格
輸入您要清除的儲存格識別碼。 範例: A5

新增工作表

在選取的試算表中建立新工作表。

Connection
如需有關將您的Google Sheets帳戶連線到Workfront Fusion的說明,請參閱在Adobe Workfront Fusion中建立案例一文中的將模組的應用程式或Web服務連線到Workfront Fusion
Spreadsheet
選取您要新增工作表的Google試算表。
屬性
  • 標題

    輸入新頁面的名稱。

  • Index

    輸入頁面位置。 預設值為0 (將頁面放在第一位)

建立試算表

Connection
如需有關將您的Google Sheets帳戶連線到Workfront Fusion的說明,請參閱在Adobe Workfront Fusion中建立案例一文中的將模組的應用程式或Web服務連線到Workfront Fusion
標題
輸入新試算表的名稱。
Locale

以下列格式之一輸入試算表的地區設定:

  • ISO 639-1語言代碼,例如 en
  • ISO 639-2語言代碼,例如haw (如果沒有639-1代碼)
  • ISO語言代碼和國家/地區代碼的組合,例如 en_US
重新計算間隔

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

變更時

每次變更時,都會更新易失性函式。

開啟變更且每分鐘

易失性函式會在每一次變更和每分鐘更新一次。

變更時每小時

揮發性函式會在每次變更時每小時更新。

時區
選取試算表的時區。
數字格式

選取試算表中所有儲存格的預設格式。

文字:文字格式設定。 範例: 1000. 12

Number:數字格式。 範例: 1,000.12

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

貨幣:貨幣格式。 範例: $1,000.12

日期:日期格式。 範例: 9/26/2008

時間:時間格式。 範例: 3:59:00 PM

日期時間:日期與時間格式。 範例: 9/26/08 15:59:00

Scientific 科學數字格式。 範例: 1. 01E+03

工作表
按一下 新增,將工作表新增至試算表。 對於每個頁面,輸入或對應頁面的標題和頁面的索引。 0的索引代表第一個工作表。

刪除工作表

刪除特定工作表。

Connection
如需有關將您的Google Sheets帳戶連線到Workfront Fusion的說明,請參閱在Adobe Workfront Fusion中建立案例一文中的將模組的應用程式或Web服務連線到Workfront Fusion
Spreadsheet
選取Google試算表。
工作表
選取您要刪除的頁面。

進行API呼叫

此動作模組可讓您執行自訂API呼叫。

Connection
如需有關將您的[Fusion App]帳戶連線到Workfront Fusion的指示,請參閱建立與Adobe Workfront Fusion的連線 — 基本指示
URL
輸入相對於https://sheets.googleapis.com/v4/的路徑。
方法

選取設定API呼叫所需的HTTP要求方法。 如需詳細資訊,請參閱Adobe Workfront Fusion中的HTTP要求方法。

Headers
以標準JSON物件的形式新增要求的標頭。例如,{"Content-type":"application/json"}。 Workfront Fusion為您新增授權標頭。
查詢字串
以標準JSON物件的形式新增API呼叫的查詢。
Body

以標準JSON物件的形式新增API呼叫的內文內容。

注意:

在JSON中使用條件陳述式(例如if)時,請將引號放在條件陳述式之外。

搜尋

搜尋列

使用篩選選項來搜尋列。

Connection
如需有關將您的[Fusion App]帳戶連線到Workfront Fusion的指示,請參閱建立與Adobe Workfront Fusion的連線 — 基本指示
Spreadsheet
選取Google試算表。
工作表
選取要搜尋資料列的工作表。
表格包含標題
選取試算表是否包含標題列。 如果選取是選項,模組不會擷取標題列做為輸出資料,而輸出中的變數名稱隨後由標題呼叫。 如果選取了否選項,模組也會擷取第一個表格列,然後輸出中的變數名稱就只稱為A、B、C、D等。
欄範圍
選取要使用的欄範圍。 範例: A-F
篩選器

設定要搜尋之列的篩選器。

如需有關篩選器的詳細資訊,請參閱在Adobe Workfront Fusion中將篩選器新增到情境。

排序順序
選取您要遞增排序還是遞減排序。
Order by
選擇您要作為排序依據的欄。
值演算選項

格式值

將根據儲存格的格式在回覆中計算並格式化值。 格式設定是以試算表的地區設定為基礎,而非請求使用者的地區設定。 例如,如果A11.23A2=A1且已格式化為貨幣,則A2會傳回"$1.23"

未格式化的值

系統會計算值,但不會在回覆中設定格式。 例如,如果A11.23A2=A1且已格式化為貨幣,則A2會傳回數字"1.23"

公式

將不會計算值。 回覆將包含公式。 例如,如果A11.23A2=A1且已格式化為貨幣,則A2會傳回"=A1"

日期和時間轉譯選項

序號

指示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年視為閏年。

格式字串

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

傳回資料列數目上限
設定Workfront Fusion在一個執行週期內傳回的最大列數。

搜尋列(進階)

傳回符合指定准則的結果。

Connection
如需有關將您的Google Sheets帳戶連線到Workfront Fusion的說明,請參閱在Adobe Workfront Fusion中建立案例一文中的將模組的應用程式或Web服務連線到Workfront Fusion
Spreadsheet
選取包含您要搜尋之工作表的Google試算表。
工作表
選取包含要搜尋之資料列的工作表。
Query

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

如需Google Charts Query Language的詳細資訊,請參閱Google檔案中的查詢語言參考

取得範圍值

Connection
如需有關將您的Google Sheets帳戶連線到Workfront Fusion的說明,請參閱在Adobe Workfront Fusion中建立案例一文中的將模組的應用程式或Web服務連線到Workfront Fusion
Spreadsheet
選取Google試算表。
工作表
選取您要取得範圍內容的工作表。
範圍
輸入您要取得的範圍。 範例: A1:D25
表格包含標題
如果工作表有標題列,請核取此方塊
含標題列
輸入表格標題的範圍。 範例A1:F1。 如果您將欄位留空,Workfront Fusion會假設標題在指定範圍的第一列。
值演算選項

格式值

將根據儲存格的格式在回覆中計算並格式化值。 格式設定是以試算表的地區設定為基礎,而非請求使用者的地區設定。 例如,如果A11.23A2=A1且已格式化為貨幣,則A2會傳回"$1.23"

未格式化的值

系統會計算值,但不會在回覆中設定格式。 例如,如果A11.23A2=A1且已格式化為貨幣,則A2會傳回數字"1.23"

公式

將不會計算值。 回覆將包含公式。 例如,如果A11.23A2=A1且已格式化為貨幣,則A2會傳回"=A1"

日期和時間轉譯選項

序號

指示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年視為閏年。

格式字串

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

清單工作表

此模組會傳回試算表中所有工作表的清單。

Connection
如需有關將您的Google Sheets帳戶連線到Workfront Fusion的說明,請參閱在Adobe Workfront Fusion中建立案例一文中的將模組的應用程式或Web服務連線到Workfront Fusion
Spreadsheet
選取包含您要列出工作表的Google試算表。

使用量限制

如果發生錯誤429: RESOURCE_EXHAUSTED,表示您已超過API速率限制。

Google Sheets API限制每個專案每100秒500個要求,每個使用者每100秒100個要求。 讀取和寫入限制會個別追蹤。 沒有每日使用量限制。

如需詳細資訊,請參閱developers.google.com/sheets/api/limits

提示與秘訣

如何從Google Sheet取得空白儲存格

使用搜尋列(進階)模組並使用此公式來取得空白欄。

選取*,其中E為Null

在工作表中新增按鈕以執行案例

  1. 在Workfront Fusion中,在情境中插入​ Webhook > 自訂Webhook ​模組/觸發器,並加以設定(請參閱Webhooks)。

  2. 複製webhook的URL。

  3. 執行情境。

  4. 在Google工作表中,從主功能表列選擇​ 插入 > 繪圖…。

  5. 在繪圖視窗中,按一下視窗頂端附近的​ 文字方塊 ​圖示

  6. 設計按鈕並按一下右上角的​ 儲存並關閉 ​按鈕:

  7. 此按鈕將會放置在您的工作表中。 按一下按鈕右上角的三個垂直點:

  8. 選擇​ 指派指令碼……。功能表中的

  9. 輸入指令碼(函式)的名稱,例如runScenario,然後按一下​ 確定

  10. 從主功能表列選擇​ 工具 > 指令碼編輯器

  11. 插入下列程式碼:

    • 函式的名稱必須對應到您在步驟9中指定的名稱。

    • 將URL取代為您在步驟2中複製的webhook URL。

      函式runScenario() {
      
      UrlFetchApp.fetch("<webhook you copied>");
      
      }
      
  12. 按​ Ctrl+S ​儲存指令碼檔案,輸入專案名稱並按一下​ 確定

  13. 切換回Google Sheets並按一下您的新按鈕。

  14. 將所需的授權授與指令碼:

  15. 在Workfront Fusion中,確認案例已成功執行。

將日期儲存在試算表中

如果您將「日期」值儲存在沒有任何格式的試算表中,該值會在試算表中以ISO 8601格式顯示為文字。 但是,使用日期的Google Sheets公式或函式若不瞭解此文字(範例:公式=A1+10),將會顯示下列錯誤:

為協助讓Google Sheets瞭解日期,請使用formatDate (date; format; [timezone])函式將其格式化。 傳遞給函式做為第二個引數的正確格式,取決於試算表的地區設定。

若要判斷正確的格式:

  1. 從主功能表選擇​ 檔案 > 試算表 ​設定以驗證/設定地區設定。

  2. 驗證/設定適當的地區設定後,請從主功能表中選擇​ 格式 > 數字 ​來決定對應的日期和時間格式。 格式會顯示在日期時間功能表專案旁:

  3. 若要撰寫應傳遞至formatDate()函式的正確格式,請參閱Token清單,以瞭解 Adobe Workfront Fusion中的日期和時間格式。

範例: ​美國地區設定使用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. 按一下​ 格式 > 數字 > 純文字

Workfront Fusion中的另一個因應措施是在數字前輸入撇號('),例如,'1-2019或'1/47。 從Workfront Fusion傳送資料後,儲存格中不會顯示單引號。

recommendation-more-help
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43