Workiva Scripting 讓構建者建立可在 Workiva 平台上安全執行的自訂 Python 邏輯。由於該代碼歸您所有並歸您維護,因此成功取決於在開始之前讓具有合適技能的構建者。本文概述了Python 知識、認證、Workiva 特定的培訓和工程實踐,幫助構建者提供強大、可靠且可擴展的腳本實施。
無論是您自己的技術團隊、合格的合作夥伴或 Workiva 的資料管理實踐,建立實施的是誰 — 都應符合以下期望。
Python 技能
建立指令碼實施需要紮實的 Python 能力。以下技能按層級分組。
初級(必填)
- 了解 Python 的邏輯和結構
- 在程式碼中引入文字和變數
- 選擇足以解決問題的運算子和資料類型
- 執行輸入/輸出主控台操作
- 了解控制流程 — 條件式區塊和循環
- 了解資料收集 — 元組、字典、清單和字串
- 了解函數和例外狀況
中級(必要)
- 了解模組和套件
- 了解字串
- 了解面向對象的方法 — 屬性、方法和繼承
- 了解清單推導、拉姆達斯、閉包和 I/O 操作
進階(推薦)
- 進階物件導向程式設計
- 編碼慣例、最佳做法和標準化
- 了解並解釋網路程式設計的基本概念(API、REST 等)
建議的 Python 認證
您可以使用以下任何方式驗證 Python 的熟練程度。
中級
- PCAP (Python 學院)
- Python 基礎 – 第 2 部分 (OpenEDG / Python 學院)
- Python Essentials 2 (思科 / Python 學院)
- Python 3 程式設計專業化 (Coursera)
- CS50's Python 程式設計簡介 (哈佛)
- Python II:準備Python 程式設計認證副學士 (斯坦福)
進階
Workiva 專屬知識
僅有 Python 技能是不夠的,開發者還需了解 Workiva 指令碼本身、執行指令碼的平台,以及用於與 Workiva 資料互動的 API。建議建設者完成:
- 使用指令碼自訂 Workiva — 如何建立、執行和管理指令碼,以及使用 Workiva 的公共 API。
- Workiva 平台認證 — 執行指令碼的平台內容、物件、權限和治理模型。
建構強大、可靠且可擴充的指令碼
除了編寫可運作的程式碼外,成功的開發人員還應設計出在生產環境中經得起考驗的實現方式。無論誰編寫腳本,從一開始就關注以下工程實踐:
- 驗證 — 安全地處理憑證和存取。
- 模組性 — 結構化程式碼,使其可重複使用、可讀且更易於維護。
- 日誌記錄 — 使指令碼行為可觀察且更容易疑難排解。
- 錯誤處理 — 預測失敗並從容處理。
預先解決這些問題比在實施後加以改造要容易得多。如需詳細指導,請參閱 Workiva 指令碼:開發流程最佳做法。
擁有權與維護
建立器負責編寫和測試自訂程式碼。交付後,持續維護和故障排除通常是您的責任,除非常設維護協議或後續 SOW 另有規定—因此請確保負責實施的團隊擁有或有權使用上述技能。
為了防止業務連續性風險,我們建議至少配備兩個具有此專業知識的內部人員。依賴於單一構建工具是有風險的,如果該人員無法聯繫到,則無人負責維護或疑難排解實施。擁有至少兩名技術熟練的人員有助於使您的實施隨著時間的推移具有可支援性。