跳轉到

傳出值說明

以下說明在「外部資料來源、外部程式站點、按鈕」功能設定中，各參數來源的傳出值格式。

欄位名稱 資料型態 傳出格式／範例
表單編號 文字 "REQ-20250701-001"
申請者帳號 文字 "ray"
申請者姓名 文字 "王小明"
申請者員工編號 文字 "E00123"
申請者主要部門職稱代號 文字 "D001-MGR"
申請者主要部門代號 文字 "D001"
上一位簽核者帳號 文字 "jane"
上一位簽核者姓名 文字 "張淑芬"
上一位簽核者員工編號 文字 "E00321"
上一位簽核者主要部門職稱代號 文字 "D002-ENG"
上一位簽核者主要部門代號 文字 "D002"
申請時間 日期時間 yyyy/MM/dd HH:mm
表單發布版本 數值 2
緊急程度代號 文字 一般：General，急件：Urgent
單據結果 文字 Approve、Reject、Cancel
簽核事件 JSON 範例

簽核事件

  // 申請 / 簽核（共通格式）
  {
    "action": "Apply" | "Sign",             // Apply: 申請、Sign: 簽核
    "applicant": "user123",                 // 申請人帳號
    "signer": "approver456",                // 執行簽核的帳號
    "currentSiteCode": "S001",              // 當前站點代碼
    "previousSiteCode": "S000"              // 上一站點代碼
  }

  // 退回 / 取回
  {
    "action": "Return" | "Retrieve",        // Return: 退回、Retrieve: 取回
    "applicant": "user123",
    "signer": "approver456",
    "currentSiteCode": "S001",
    "previousSiteCode": "S002",
    "targetSiteCode": "S000"                // 目標站點代碼
  }

  // 變更狀態
  {
    "action": "ChangeResult",               // 動作為狀態變更
    "applicant": "user123",
    "signer": "approver456",
    "currentSiteCode": "S003",
    "previousSiteCode": "S002",
    "currentTaskResult": "Approve",         // 單據目前狀態
    "previousTaskResult": "Pending"         // 單據變更前狀態
  }

action 對應表

動作 (action) 說明
Apply 申請
Sign 簽核
Return 退回
Retrieve 取回
ChangeResult 單據變更結果
資料欄位 資料型態 值與說明
單行文字 文字
多行文字 文字 跳行以空格分隔，例如：第一行文字 第二行文字 第三行文字
日期 日期時間 yyyy/MM/dd
日期時間 日期時間 yyyy/MM/dd HH:mm
數值 數值
欄位計算 數值
下拉選單 文字 根據選項來源不同，會有不同的傳出值 範例
單選清單 文字 根據選項來源不同，會有不同的傳出值 範例
複選清單 JSON 根據選項來源不同，會有不同的傳出值 範例
選擇人員 JSON 提供「帳號、員工編號」，例如：兩個人員(ray、tom) ，傳出值為 [{"account":"ray","employeeNo":"24001"},{"account":"tom","employeeNo":"24002"}]
選擇部門 JSON 提供「部門代號」，例如：兩個部門(管理部 B008、財務部 C009)，
傳出值為["B008","C009"]
文件檢視器 文字 完整網址，例如：["http://xxx.xx.x.xxx/api/file/Download/xxxxx"]
上傳檔案 文字 完整網址，例如：["http://xxx.xx.x.xxx/api/file/Download/xxxxx"]
明細 JSON 範例

下拉、單選

✅ 選項來自「表單手動新增」

在表單中新增了下列選項：
  • 電腦
  • 滑鼠
  • 鍵盤
使用者選取「電腦」，傳出值為：
"電腦"

✅ 選項來自「外部資料來源」

外部資料來源提供選項如下：
選項名稱 選項 ID
電腦 computer
滑鼠 mouse
鍵盤 keyboard
使用者選取「電腦」，傳出值為：
"computer"

🔄 對照

資料來源 選項顯示名稱 傳出值
表單手動新增 電腦 "電腦"
外部資料來源 電腦 "computer"

複選

✅ 選項來自「表單手動新增」

在表單中新增了下列選項：
  • 電腦
  • 滑鼠
  • 鍵盤
使用者勾選「電腦」和「滑鼠」，傳出值是
["電腦", "滑鼠"]

✅ 選項來自「外部資料來源」

外部資料來源提供選項如下：
選項名稱 選項 ID
電腦 computer
滑鼠 mouse
鍵盤 keyboard
使用者勾選選項 ID 分別是 computer 和 mouse，傳出值是
["computer", "mouse"]

🔄 對照

資料來源 選項顯示名稱 傳出值
表單手動新增 電腦、滑鼠 ["電腦", "滑鼠"]
外部資料來源 電腦、滑鼠 ["computer", "mouse"]

明細欄位

{
  "rows": [
    {
      "columns": [
        { "code": "C009.C010", "value": "單行文字" },
        { "code": "C009.C012", "value": "2023/11/22" },
        { "code": "C009.C013", "value": "2023/11/22 20:11" },
        { "code": "C009.C014", "value": "選項3" },
        { "code": "C009.C015", "value": ["選項1", "選項2", "選項3", "有沒有機會"] },
        { "code": "C009.C016", "value": "選項3" },
        { "code": "C009.C021", "value": ["http://xxx.xx.x.xxx/api/file/Download/xxxxx"] },
        { "code": "C009.C022", "value": [{ "account": "rita", "employeeNo": "001" }] },
        { "code": "C009.C023", "value": ["C013", "C014"] }
      ]
    }
  ]
}
資料項目 資料類型 值與說明
外掛欄位名稱 JSON 由外掛欄位自行定義