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授權

新增:標準

目前:工作或以上

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
值演算選項
  • 格式值

    系統會根據儲存格的格式,在回覆中計算值並設定格式。 格式設定是以試算表的地區設定為基礎,而非請求使用者的地區設定。 例如,如果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欄位,視您在應用程式或服務中的存取層級等因素而定。 模組中的粗體標題表示必填欄位。

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

地圖切換

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
值演算選項
  • 格式值

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

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會將指定範圍的第一列視為標頭。
值演算選項
  • 格式值

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

  • 格式字串

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

清單工作表

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

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
選擇您要作為排序依據的欄。
值演算選項
  • 格式值

    系統會根據儲存格的格式,在回覆中計算值並設定格式。 格式設定是以試算表的地區設定為基礎,而非請求使用者的地區設定。 例如,如果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在一個執行週期內傳回的最大列數。

搜尋列(進階)

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

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

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