確認目前以哪個 UOF 帳號身份操作，並檢查 Token / Session 是否有效。

何時使用：對話開始時、或任何工具回報認證錯誤時，用來確認身份與連線。 每個 Server 程序只代表一個固定帳號（由設定綁定）。

列出所有表單類別與表單，含 formId 與表單版本代號（recentVersionId）。

何時使用：使用者問「系統有哪些表單」，或要起單但還不知道目標表單的 formId / formVersionId 時。這是起單流程的第一步。有 recentVersionId 的表單才可外部起單。

列出被標記為「非線上使用」的表單。

何時使用：少數需要查詢非線上表單的情況。注意：此清單不等於可外部起單的表單 （採購單就不在其中卻能起單）。要判斷能否起單，請改看 get_form_list 的 recentVersionId。

以表單版本代號取得欄位結構（只有 fieldId 與名稱，無型別）。

何時使用：手上只有 formVersionId 時。一般建議改用 get_form_structure_by_id（資訊較完整）。

以表單代號取得欄位結構，含每個欄位的型別與填寫方式，並附上起單提示。

何時使用：要起單前，先用本工具查清楚這張表單要填哪些欄位、怎麼填。 建議優先用本工具（比 get_form_structure 多回 fieldType 與填寫指引）。 注意：回傳的是表單對外開放的「中介欄位」，可能少於 UOF 網頁上的完整表單。

模擬簽核流程走向，不會真的起單。參數與 apply_form 完全相同。

何時使用：呼叫 apply_form 正式起單之前，用相同參數先驗證流程與簽核路徑是否正確。 註：網頁起單的表單(如採購單)改以「試填到送出前」的填寫驗證代替（其簽核路徑於送出時的確認視窗呈現）。

正式起單，成功回傳 TaskId（後續查詢與結案都要用到，務必保存）。

何時使用：已用 get_form_structure_by_id 確認這張表單要帶哪些欄位後，要正式送出時。 呼叫端只要挑表單、填內容即可——這張表單背後怎麼起（系統內部用哪種方式）不需要你管。

限制：起單不會驗證網頁必填欄位，缺欄位仍可能起單成功但內容不完整；附檔、多站/並簽會簽尚未支援。

查詢一張單的摘要：申請者、目前結果（簽核中/同意/否決/作廢）、結案日期。

何時使用：想快速知道某張單目前的狀態時。需要逐站簽核歷程請改用 get_task_result。 系統沒有待簽清單 API，TaskId 必須由使用者提供。

查詢一張單的逐站簽核歷程（每一站的簽核者、結果、意見、時間）。

何時使用：想看簽核走到哪一站、誰簽了什麼意見時。站點顯示「待簽」代表表單停在該站。 只要摘要狀態用 get_task_data 即可。

結案一張單。可作為申請人撤單(Cancel)、或主管/管理員核准否決(Adopt/Reject)。

何時使用：

• 申請人要撤回自己的單 → result=Cancel

• 主管要同意/否決停在自己這站的單 → result=Adopt/Reject（單站自由流程中等同簽核）

• 管理員要強制結案卡住的單 → 任一動作 操作者固定為本 Server 綁定的身份（UOF_ACCOUNT），不由呼叫端指定。 注意：這是「整張單終結」，多站流程會跳過後續站點；對已結案的單會被擋下。

搜尋 UOF 表單（依日期範圍 + 關鍵字），回傳含 TaskId 的清單。

何時使用：使用者沒有 TaskId、但想列出自己最近的單或搜尋特定關鍵字時。 本工具是補上「UOF 一代沒有待簽清單 API」這個缺口最直接的入口； 取得 TaskId 後可丟給 get_task_data / get_task_result 看單張詳情。

限制：

• 範圍是「目前帳號可看到的單」，等同於使用者在 UOF 網頁「查詢表單」頁所看到的範圍。

• 只取第一頁結果；極端情況需要更精確過濾請縮日期範圍或加關鍵字。

依姓名或帳號關鍵字查詢 UOF 人員，回傳姓名、帳號與 UserGuid。

何時使用：需要指定 apply_form 的 first_signer_account（第一簽核者帳號）時， 先用本工具確認對方在 UOF 的正確帳號，避免帳號輸錯導致起單失敗。

限制：回傳範圍為目前帳號可看到的 UOF 人員（同 ChoiceCenter 選人清單）。

將固定流程的表單推進到下一站並指定簽核者。

何時使用：僅適用於後台設計好的固定流程表單。 自由流程（如採購單）不支援本工具；要在自由流程上同意/否決請改用 terminate_task。 site_id/node_seq/signer_guid 無法由查詢 API 取得，需由表單流程設計提供。