Google Sheets模組
在Adobe Workfront Fusion案例中,您可以自動化使用Google Sheets的工作流程,並將其連線至多個協力廠商應用程式和服務。
如需有關將您的Google Sheets帳戶連線到Workfront Fusion的指示,請參閱建立連線到 Adobe Workfront Fusion — 基本指示
存取需求
您必須具有下列存取權才能使用本文中的功能:
若要瞭解您擁有的計畫、授權型別或存取權,請連絡您的Workfront管理員。
如需Adobe Workfront Fusion授權的相關資訊,請參閱Adobe Workfront Fusion 授權。
先決條件
若要使用Google Sheets模組,您必須有Google帳戶。
Google Sheets API資訊
Google Sheets聯結器使用下列專案:
觸發程序
Watch Rows
從試算表中每個新新增的列擷取值。
模組只會擷取之前未填入的新列。 觸發器不會處理覆寫的列。
動作
Add a Row
此模組會附加一列至工作表。
當您設定Google Sheets模組時,Workfront Fusion會顯示下列欄位。 除了這些欄位以外,可能還會顯示其他Google Sheets欄位,視您在應用程式或服務中的存取層級等因素而定。 模組中的粗體標題表示必填欄位。
如果您在欄位或函式上方看到對應按鈕,則可以使用它來設定該欄位的變數和函式。 如需詳細資訊,請參閱將資訊從一個模組對應到另一個模組。
Update a Row
此模組可讓您變更所選列中的儲存格內容。
Clear a Row
從指定的列刪除值。
Delete a Row
刪除指定的列。
Get a Cell
從選取的儲存格擷取值。
Update a Cell
Clear a Cell
刪除指定儲存格的值。
Add a Sheet
在選取的試算表中建立新工作表。
Create a Spreadsheet
Delete a Sheet
刪除特定工作表。
Make an API Call
此動作模組可讓您執行自訂API呼叫。
搜尋
Search Rows
使用篩選選項來搜尋列。
Search Rows (Advanced)
傳回符合指定准則的結果。
Get Range Values
List Sheets
此模組會傳回試算表中所有工作表的清單。
使用量限制
如果發生錯誤429: RESOURCE_EXHAUSTED
,表示您已超過API速率限制。
Google Sheets API限制每個專案每100秒500個要求,每個使用者每100秒100個要求。 讀取和寫入限制會個別追蹤。 沒有每日使用量限制。
如需詳細資訊,請參閱developers.google.com/sheets/api/limits。
提示與秘訣
如何從Google Sheet取得空白儲存格
使用Search Rows (Advanced)模組並使用此公式來取得空白欄。
選取*,其中E為Null
在工作表中新增按鈕以執行案例
-
在Workfront Fusion中,在情境中插入 Webhook > Custom webhooks 模組/觸發器並加以設定(請參閱Webhooks)。
-
複製webhook的URL。
-
執行情境。
-
在Google工作表中,從主功能表列選擇 Insert > Drawing…。
-
在Drawing視窗中,按一下視窗頂端附近的 Text box 圖示
-
設計按鈕並按一下右上角的 Save and Close 按鈕:
-
此按鈕將會放置在您的工作表中。 按一下按鈕右上角的三個垂直點:
-
選擇 Assign script…。功能表中的。
-
輸入指令碼(函式)的名稱,例如
runScenario
,然後按一下 OK: -
從主功能表列選擇 Tools > Script editor。
-
插入下列程式碼:
-
函式的名稱必須對應到您在步驟9中指定的名稱。
-
將URL取代為您在步驟2中複製的webhook URL。
函式runScenario() {
UrlFetchApp.fetch("<webhook you copied>");
}
-
-
按 Ctrl+S 儲存指令碼檔案,輸入專案名稱並按一下 OK。
-
切換回Google Sheets並按一下您的新按鈕。
-
將所需的授權授與指令碼:
-
在Workfront Fusion中,確認案例已成功執行。
將日期儲存在試算表中
如果您將「日期」值儲存在沒有任何格式的試算表中,該值會在試算表中以ISO 8601格式顯示為文字。 但是,使用日期的Google Sheets公式或函式若不瞭解此文字(範例:公式=A1+10
),將會顯示下列錯誤:
為協助讓Google Sheets瞭解日期,請使用formatDate (date; format; [timezone])函式將其格式化。 傳遞給函式做為第二個引數的正確格式,取決於試算表的地區設定。
若要判斷正確的格式:
-
從主功能表選擇 File > Spreadsheet 設定以驗證/設定地區設定。
-
驗證/設定適當的地區設定後,從主功能表選擇 Format > Number 以決定對應的日期和時間格式。 格式會顯示在日期時間功能表專案旁:
-
若要撰寫應傳遞至formatDate()函式的正確格式,請參閱代號清單中的日期與時間格式。
範例: 美國地區設定使用MM/DD/YYYY HH:mm:ss
格式:
正在利用Google Sheets功能
如果您遺漏內建功能,但此功能是由Google Sheets所提供,則您可以加以利用。 如需詳細資訊,請參閱使用 Adobe Workfront Fusion中的函式對映專案中的使用 Google Sheets 函式。
保留Google Sheets不要將數字變更為日期
您可能會發現您當作文字使用的數字字串正在解譯為Google工作表中的日期。 例如,您輸入1-2019,打算將它當作文字,但Google將其解譯為日期。 您可以預先將數字格式設定為純文字以防止此情況發生。
- 在Google Sheets中,反白顯示包含數字的欄或儲存格。
- 按一下 Format > Number > Plain text。
Workfront Fusion中的另一個因應措施是在數字前輸入撇號('),例如,'1-2019或'1/47。 從Workfront Fusion傳送資料後,儲存格中不會顯示單引號。