Google Sheets 模組

在 Adobe Workfront Fusion 情境中,您可以將使用 Google Sheets 的工作流程自動化,以及將其連接至多個第三方應用程式和服務。

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

存取權要求

展開以檢視這篇文章中所述功能的存取權要求。
table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
Adobe Workfront 封裝

任何 Adobe Workfront Workflow 封裝及任何 Adobe Workfront Automation and Integration 封裝

Workfront Ultimate

Workfront Prime 和 Select 封裝,以及額外購買的 Workfront Fusion。

Adobe Workfront 授權

標準

工作或更高層級

Adobe Workfront Fusion 授權

作業型:無 Workfront Fusion 授權要求

連接器型 (舊版):Workfront Fusion for Work Automation and Integration

產品 如果您的組織擁有 Select 或 Prime Workfront 封裝,但不包括 Workfront Automation and Integration,則您的組織必須購買 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
如果工作表包含空白列,則不會處理空白列之後的任何列。
連線
如需有關將您的Google Sheets帳戶連線到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"

日期和時間轉譯選項
  • 序號

    日期、時間、日期時間和持續時間欄位會以「序號」格式輸出為兩倍,並由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 欄位。 在模組中,粗體標題表示那是必要欄位。

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

對應切換

連線
如需有關將您的Google Sheets帳戶連線到Workfront Fusion的說明,請參閱建立連線 — 基本說明
模式

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

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

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

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

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

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

  • 號碼

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

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

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

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

  • Raw

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

插入資料選項

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

  • 插入列

    會為新資料插入列。

  • 覆寫

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

新增工作表

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

連線
如需有關將您的Google Sheets帳戶連線到Workfront Fusion的說明,請參閱建立連線 — 基本說明
Spreadsheet
選取您要新增工作表的Google試算表。
屬性
  • 標題

    輸入新頁面的名稱。

  • Index

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

清除儲存格

刪除指定儲存格的值。

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

清除列

從指定的列刪除值。

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

建立試算表

連線
如需有關將您的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的索引代表第一個工作表。

刪除列

刪除指定的列。

連線
如需有關將您的Google Sheets帳戶連線到Workfront Fusion的說明,請參閱建立連線 — 基本說明
Spreadsheet
選取包含您要刪除列之工作表的Google試算表。
選取您要從中刪除資料列的頁面。
列號
輸入要刪除的列數。 範例: 23

刪除工作表

刪除特定工作表。

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

取得儲存格

從選取的儲存格擷取值。

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

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

  • 未格式化的值

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

  • 公式

    不會計算值。 回覆包含公式。 例如,如果A11.23A2=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呼叫。

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

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

注意:

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

更新儲存格

連線
如需有關將您的Google Sheets帳戶連線到Workfront Fusion的說明,請參閱建立連線 — 基本說明
Spreadsheet
選取Google試算表。
工作表
選取要更新儲存格的工作表。
儲存格
輸入要更新的儲存格識別碼。 範例: A5
輸入儲存格的新值。
值輸入選項
  • 使用者已進入

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

  • Raw

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

更新列

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

連線
如需有關將您的Google Sheets帳戶連線到Workfront Fusion的說明,請參閱建立連線 — 基本說明
模式

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

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

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

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

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

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

  • 號碼

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

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

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

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

  • Raw

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

搜尋

取得範圍值

連線
如需有關將您的Google Sheets帳戶連線到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"

日期和時間轉譯選項
  • 序號

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

  • 格式字串

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

清單工作表

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

連線
如需有關將您的Google Sheets帳戶連線到Workfront Fusion的說明,請參閱建立連線 — 基本說明
Spreadsheet
選取包含您要列出工作表的Google試算表。

搜尋列

使用篩選選項來搜尋列。

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

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

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

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

  • 未格式化的值

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

  • 公式

    不會計算值。 回覆包含公式。 例如,如果A11.23A2=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在一個執行週期內傳回的最大列數。

搜尋列(進階)

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

連線
如需有關將您的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 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。

      code language-none
      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清單中的日期和時間格式

範例:

對於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傳送資料後,儲存格中不會顯示單引號。

recommendation-more-help
workfront-fusion-help-workfront-fusion