文件WorkfrontAdobe Workfront Fusion

Google Sheets模組

Last update: Fri Mar 14 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 主題：
  • 數位內容和文件

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

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

存取需求

展開以檢視本文中功能的存取需求。

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

Adobe Workfront套件
任何
Adobe Workfront授權

新增：標準

或

目前：工作或以上

Adobe Workfront Fusion授權**

目前：無Workfront Fusion授權需求

或

舊版：Workfront Fusion for Work Automation and Integration

產品

新增：

  • 選取或Prime Workfront套件：您的組織必須購買Adobe Workfront Fusion。
  • Ultimate Workfront套件：包含Workfront Fusion。

或

目前：您的組織必須購買Adobe Workfront Fusion。

如需此表格中資訊的詳細資訊，請參閱檔案🔗中的存取需求。

如需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

Google工作表模組及其欄位

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

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

地圖切換

觸發程序

觀看列

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

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

IMPORTANT
如果工作表包含空白列，則不會處理空白列之後的任何列。
Connection
如需有關將您的Google Sheets帳戶連線到Workfront Fusion的指示，請參閱建立連線 — 基本指示。
Spreadsheet
選取包含您要觀看之表格的試算表。
工作表
選取要監視新列的工作表。
表格包含標題

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

  • 是

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

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

  • 號碼

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

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

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

  • 格式值

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

  • 未格式化的值

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

  • 公式

    不會計算值。 回覆包含公式。 例如，如果A1是1.23，A2是=A1且已格式化為貨幣，則A2會傳回"=A1"。

日期和時間轉譯選項

  • 序號

    日期、時間、日期時間和持續時間欄位會以「序號」格式輸出為兩倍，並由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在一個執行週期內可處理的最大結果數量。

動作

  • 新增列
  • 新增工作表
  • 清除儲存格
  • 清除列
  • 建立試算表
  • 刪除列
  • 刪除工作表
  • 取得儲存格
  • 進行API呼叫
  • 更新儲存格
  • 更新列

新增列

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

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

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

地圖切換

Connection
如需有關將您的Google Sheets帳戶連線到Workfront Fusion的指示，請參閱建立連線 — 基本指示。
模式

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

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

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

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

  • 是

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

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

  • 號碼

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

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

值
在要新增的資料列中，輸入或對應所需的儲存格。
值輸入選項

  • 使用者已進入

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

  • Raw

    使用者輸入的值不會剖析並儲存為輸入值。

插入資料選項

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

  • 插入列

    會為新資料插入列。

  • 覆寫

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

新增工作表

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

Connection
如需有關將您的Google Sheets帳戶連線到Workfront Fusion的指示，請參閱建立連線 — 基本指示。
Spreadsheet
選取您要新增工作表的Google試算表。
屬性

  • 標題

    輸入新頁面的名稱。

  • Index

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

清除儲存格

刪除指定儲存格的值。

Connection
如需有關將您的Google Sheets帳戶連線到Workfront Fusion的指示，請參閱建立連線 — 基本指示。
Spreadsheet
選取包含您要清除儲存格之工作表的Google試算表。
工作表
選取您要清除儲存格的頁面。
儲存格
輸入或對應您要清除的儲存格識別碼。 範例： A5。

清除列

從指定的列刪除值。

Connection
如需有關將您的Google Sheets帳戶連線到Workfront Fusion的指示，請參閱建立連線 — 基本指示。
Spreadsheet
選取包含您要清除資料列之工作表的Google試算表。
工作表
選取您要清除其資料的工作表。
列號
輸入您要清除資料的資料列編號。 範例： 23。

建立試算表

Connection
如需有關將您的Google Sheets帳戶連線到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的指示，請參閱建立連線 — 基本指示。
Spreadsheet
選取包含您要刪除列之工作表的Google試算表。
表
選取您要從中刪除資料列的頁面。
列號
輸入要刪除的列數。 範例： 23

刪除工作表

刪除特定工作表。

Connection
如需有關將您的Google Sheets帳戶連線到Workfront Fusion的指示，請參閱建立連線 — 基本指示。
Spreadsheet
選取Google試算表。
工作表
選取您要刪除的頁面。

取得儲存格

從選取的儲存格擷取值。

Connection
如需有關將您的Google Sheets帳戶連線到Workfront Fusion的指示，請參閱建立連線 — 基本指示。
Spreadsheet
選取Google試算表。
工作表
選取包含您要擷取資料之儲存格的工作表。
儲存格
輸入您要擷取資料的儲存格識別碼。 範例： A6
值演算選項

  • 格式值

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

  • 未格式化的值

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

  • 公式

    不會計算值。 回覆包含公式。 例如，如果A1是1.23，A2是=A1且已格式化為貨幣，則A2會傳回"=A1"。

Date and time render option

  • Serial number

    日期、時間、日期時間和持續時間欄位會以「序號」格式輸出為兩倍，並由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

    日期、時間、日期時間和持續時間欄位會以其指定的數字格式（視試算表的地區設定而定）輸出為字串。

進行API呼叫

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

Connection
如需有關將您的Google Sheets帳戶連線到Workfront Fusion的指示，請參閱建立與Adobe Workfront Fusion的連線 — 基本指示。
URL
輸入相對於https://sheets.googleapis.com/v4/的路徑。
方法
選取設定API呼叫所需的HTTP要求方法。 如需詳細資訊，請參閱HTTP要求方法。
Headers
以標準JSON物件的形式新增請求的標頭。 例如，{"Content-type":"application/json"}。 Workfront Fusion為您新增授權標頭。
查詢字串
以標準JSON物件的形式新增API呼叫的查詢。
Body

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

注意：

在JSON中使用條件陳述式（例如if）時，請將引號放在條件陳述式之外。

更新儲存格

Connection
如需有關將您的Google Sheets帳戶連線到Workfront Fusion的指示，請參閱建立連線 — 基本指示。
Spreadsheet
選取Google試算表。
工作表
選取要更新儲存格的工作表。
儲存格
輸入要更新的儲存格識別碼。 範例： A5
值
輸入儲存格的新值。
值輸入選項

  • 使用者已進入

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

  • Raw

    使用者輸入的值不會剖析並儲存為輸入值。

更新列

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

Connection
如需有關將您的Google Sheets帳戶連線到Workfront Fusion的指示，請參閱建立連線 — 基本指示。
模式

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

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

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

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

  • 是

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

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

  • 號碼

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

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

值
輸入值或將值對應至要變更（更新）之列的所需儲存格。
值輸入選項

  • 使用者已進入

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

  • Raw

    使用者輸入的值不會剖析並儲存為輸入值。

搜尋

  • 取得範圍值
  • 清單工作表
  • 搜尋列
  • 搜尋列（進階）

取得範圍值

Connection
如需有關將您的Google Sheets帳戶連線到Workfront Fusion的指示，請參閱建立連線 — 基本指示。
Spreadsheet
選取Google試算表。
工作表
選取您要取得範圍內容的工作表。
範圍
輸入您要取得的範圍。 範例： A1:D25。
表格包含標題
如果工作表有標題列，請核取此方塊
含標題列
輸入表格標題的範圍。 範例A1:F1。 如果您將欄位留空，Workfront Fusion會將指定範圍的第一列視為標頭。
值演算選項

  • 格式值

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

  • 未格式化的值

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

  • 公式

    不會計算值。 回覆包含公式。 例如，如果A1是1.23，A2是=A1且已格式化為貨幣，則A2會傳回"=A1"。

日期和時間轉譯選項

  • 序號

    日期、時間、日期時間和持續時間欄位會以「序號」格式輸出為兩倍，並由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的指示，請參閱建立連線 — 基本指示。
Spreadsheet
選取包含您要列出工作表的Google試算表。

搜尋列

使用篩選選項來搜尋列。

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

設定您要用來搜尋列的篩選器。

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

  • 格式值

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

  • 未格式化的值

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

  • 公式

    不會計算值。 回覆包含公式。 例如，如果A1是1.23，A2是=A1且已格式化為貨幣，則A2會傳回"=A1"。

日期和時間轉譯選項

  • 序號

    日期、時間、日期時間和持續時間欄位會以「序號」格式輸出為兩倍，並由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的指示，請參閱建立連線 — 基本指示。
Spreadsheet
選取包含您要搜尋之工作表的Google試算表。
工作表
選取包含要搜尋之資料列的工作表。
Query

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

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

使用量限制

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

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

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

提示與秘訣

  • 從 Google 工作表取得空白儲存格
  • 在工作表中新增按鈕以執行案例

從Google Sheet取得空白儲存格

若要取得空白儲存格，您可以使用搜尋列（進階）模組。 使用此公式來取得空白欄。

select * where E is null

其中，「E」為欄，而「is null」為條件。 您可以使用Google查詢語言建立更進階的查詢。 如需詳細資訊，請參閱Google檔案中的Google Query Lang。

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

  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。

      function 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函式將其格式化。 傳遞給函式做為第二個引數的正確格式，取決於試算表的地區設定。

如需有關這個函式的詳細資訊，請參閱文章日期和時間函式中的formatDate (date； format； [timezone])。

若要判斷正確的格式：

  1. 在Google Sheets中，從主功能表選擇​ 檔案 > 試算表 ​設定，以驗證和設定地區設定。

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

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

recommendation-more-help

範例：

對於MM/DD/YYYY HH:mm:ss格式（美國地區設定）：

地區設定時間公式

正在利用Google Sheets功能

若要使用Google Sheets的內建函式，您可以加以利用。 如需詳細資訊，請參閱文章中的使用 Google Sheets 函式使用函式對應專案。

防止Google Sheets將數字變更為日期

如果您用來作為文字的數字字串被解譯為Google工作表中的日期，您可以將數字預先格式化為純文字以防止此情況。 例如，如果您輸入1-2019，打算將它當作文字，Google可能會將其解譯為日期。

  1. 在Google Sheets中，反白顯示包含數字的欄或儲存格。
  2. 按一下​ 格式 > 數字 > 純文字。

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

7e1891ad-4d59-4355-88ab-a2e62ed7d1a3