可以使用自動化面板中的指令碼執行動作來執行網站中的指令碼。這可讓您從文件、試算表或簡報中手動執行腳本。
註: 目前僅可透過 Customize Workiva 使用腳本。深入了解。
要求
- 您的工作區必須啟用 Workiva Scripting。進一步了解 Workiva Scripting。
- 腳本只能在其託管的同一工作區執行。進一步了解。
- 只有檔案擁有者才能建立自動化。
- 需要Script Editor 角色才能建立指令碼。
建立您的自動化
從您擁有的檔案建立自動化：
- 從首頁 ，開啟一個文件、簡報或試算表。
- 在螢幕最右側，從面板選取自動化 。
- 按一下+ 或建立 ，以新增自動化。
- 從自動化觸發 下拉式功能表中，選擇手動執行 。
- 在下，當 選擇執行時，可選擇給予其他使用者手動執行此自動化的能力。
- 在動作詳細資訊下 ，選擇執行腳本 。
- 在 Script ID 下，輸入腳本網址末端的 ID 。
- 選擇包含指令碼輸入的試算表和區段。這是選項。
- 按一下建立以完成。
執行和管理自動化
您的新自動化會在自動化面板中顯示為 「啟動中」。作為檔案擁有者，您可以從下拉式功能表中執行幾個動作：
- 執行 ：手動執行自動化指令碼。
- 編輯：更新自動化的詳細資訊，例如其觸發準則。
- Disable/Activate ：選擇自動化是否可執行。
- 檢視活動 ：開啟自動化的活動記錄。
- 刪除 ：從檔案中永久移除自動化。
注意: 為防止重複執行，Run 選項會在點擊之間停用 20 秒。
指令碼接收的資訊
自動化執行時，會傳送腳本讀取為環境變數的資訊：
- DOCUMENT_ID: 執行自動化的文件 ID。
- INPUT_SHEET_ID: 用於管理自動化輸入參數的試算表 WURL。
- INPUT_RESOURCE_ID: 上述電子表格中該章節的 WURL。
- INPUT_SPREADSHEET_ID: 上述電子表格的 ID。
- INPUT_SPREADSHEET_SHEET_ID: 上述試算表中章節的 ID。
WURL 是專屬的 Workiva 特定 URL，包含電子表格或節的 ID 及其他資訊。
若要從參數中擷取 ID，請使用此指令碼：
# 歡迎來到 Workiva Scripting import requests import json import os DOCUMENT_ID = os.getenv('DOCUMENT_ID') SPREADSHEET_ID = os.getenv('INPUT_SPREADSHEET_ID') SHEET_ID = os.getenv('INPUT_SPREADSHEET_SHEET_ID') print("RAW parameters:") print(os.environ) print("") print("Actual IDs:") print(DOCUMENT_ID) print(SPREADSHEET_ID) print(SHEET_ID) 注意: 自动化目前不会向脚本发送任何 Workiva 公共 API 凭据 - 如客户端 ID 或秘密。您可能需要將這些認證直接編碼到腳本中。
常見問題集|常見問題
我可以在其他工作區、組織或環境 (APAC, EU,US) 執行腳本嗎？
Workiva 中的automations 功能 只能在文件所在的同一工作区中执行脚本。但是，Workiva Scripting connector 或Workiva Scripting API 可用于执行托管在另一位置的脚本。
如果使用腳本 API，您必須在主工作區中建立並執行一個腳本，其唯一目的是呼叫 Scripting API 並在次工作區中執行腳本。
我可以在執行指令碼時傳送執行時輸入/參數嗎？
目前，自動化功能不允許在執行指令碼時，將執行時輸入的內容傳送到指令碼。
自動化會傳送哪些元資料到執行的指令碼？ 是否傳送工作區 id？
從自動化執行腳本時，唯一傳送的參數是設定自動化的文件 ID。
如何從腳本執行中存取 Workiva 和非 Workiva 系統的憑證？
從自動化執行腳本時，唯一的選擇是在程式碼本身硬體編碼憑證。
同一個指令碼可以從兩個或多個檔案同時執行嗎？
可以，一個指令碼可以從同一個檔案或多個檔案同時執行。