傳出值說明¶

以下說明在「欄位串外部、按鈕欄位、表單驗證器、外部程式站點、簽核事件、外掛欄位跨欄位取值」功能設定中，各參數來源的傳出值格式。

單據資訊一般欄位外掛欄位

欄位名稱	資料型態	傳出格式／範例
表單編號	`文字`	"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`	範例

單選¶

表單手動新增外部串接

在表單中新增了下列選項： 電腦、滑鼠、鍵盤、其他

使用者選取「電腦」，傳出值為：

{"selected":"電腦","fillText":"Dell", "isOther": false}

使用者選取「其他」，傳出值為：

{"selected":"","fillText":"螢幕架", "isOther": true}

外部資料來源提供選項如下：

選項名稱	選項 ID
電腦	`computer`
滑鼠	`mouse`
鍵盤	`keyboard`

使用者選取「電腦」，傳出值為：

{"selected":"computer","fillText":"", "isOther": false}

下拉¶

表單手動新增外部串接

在表單中新增了下列選項： 電腦、滑鼠、鍵盤

使用者選取「電腦」，傳出值為：

{"selected":"電腦","fillText":"Dell", "isOther": false}

外部資料來源提供選項如下：

選項名稱	選項 ID
電腦	`computer`
滑鼠	`mouse`
鍵盤	`keyboard`

使用者選取「電腦」，傳出值為：

{"selected":"computer","fillText":"", "isOther": false}

複選¶

表單手動新增外部串接

在表單中新增了下列選項： 電腦、滑鼠、鍵盤、其他

使用者勾選「電腦」和「滑鼠」，傳出值是：

[
  {"selected":"電腦","fillText":"Dell", "isOther": false}, 
  {"selected":"滑鼠","fillText":"logitech", "isOther": false}, 
  {"selected":"","fillText":"螢幕架", "isOther": true}
]

外部資料來源提供選項如下：

選項名稱	選項 ID
電腦	`computer`
滑鼠	`mouse`
鍵盤	`keyboard`

使用者勾選選項 ID 分別是 computer 和 mouse，傳出值是：

[
  {"selected":"computer","fillText":"", "isOther": false}, 
  {"selected":"mouse","fillText":"", "isOther": false}
]

明細欄位¶

{
  "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	由外掛欄位自行定義