📄自訂欄位

鑑於不同行業別,或企業商務邏輯的不同,勢必對於資料需求也會有差異,坊間固定的表單形式很難滿足所有用戶的需求,因此 FIRST LINE 能透過自訂欄位讓用戶打造自己所需的資料。

自訂類型

自訂欄位共分為四種用途,分別套用於「客戶」、「工單」資料關聯

代碼

名稱

描述

0

客戶 表單

即從原本表單額外新增欄位,例如客戶的體重、血型...等,此種欄位屬於表單欄位。

1

客戶 表格

即從原本表單新增一對多的關聯,例如客戶的多筆購買紀錄,即屬於關聯表格。

2

工單 表單

即從原本表單額外添新增欄位,例如工單的批號、處理狀態...等,此種欄位屬於表單欄位

3

工單 表格

即從原本表單新增一對多的關聯,例如工單的多筆運送紀錄,即屬於關聯表格

欄位類型

自訂欄位目前共有以下類型,各代碼分別代表不同的儲存型態

代碼

欄位類型

0

數字欄位

1

文字欄位

2

布林值

3

日期

4

時間

5

日期時間

6

單選

7

多選

其中 6(單選) 以及 7(多選) 擁有 options 參數,此欄位以 JSON 格式紀錄選項,下面以血型為範例:

[
    { "text":"A型",  "value": "A"},
    { "text":"B型",  "value": "B"},
    { "text":"AB型", "value": "AB"},
    { "text":"O型",  "value": "O"}
]

即從原本的表單額外添加的欄位,例如 客戶體重,此種欄位屬於 動態表單欄位

即從原本的表單添加 "一對多" 的關聯,例如 客戶購買紀錄,即屬於 動態關聯表格

查詢系統自訂欄位

目前系統現有的自訂欄位

GET https://{API_DOMAIN}/api/v1/cz-col
curl -X GET
    -H "Content-Type: application/json:Authorization: Bearer eyJhbGciOiJIUzI1NiI..." https://{API_HOST}/api/v1/cz-col

Parameters

PARAMETER

REQUIRED

DEFAULT

TYPE

DESCRIPTION

page

false

1

Number

目前在第幾頁

per_page

false

15

Number

每頁呈現多少筆

category_id

false

NULL

Number

types

false

NULL

Number

0: 客戶動態表單欄位 1: 客戶動態關聯表格 2: 工單動態表單欄位 3: 工單動態關聯表格

Response

PROPERTY

TYPE

DESCRIPTION

data

Array of objects

meta

Object

Pagination meta

{
    "data": [
        {
            "id": 1,
            "name": "Cyril223",
            "description": "Assumenda est corrupti voluptas aut. Beatae quisquam ex asperiores sit ullam.",
            "is_allowed_null": true,
            "default": null,
            "type": 4,
            "category_id": null,
            "category": null,
            "creater_id": null,
            "creater": null
        }
    ],
    "meta": {
        "current_page": 1,
        "from": 1,
        "last_page": 10,
        "per_page": 1,
        "to": 1,
        "total": 10
    }
}

Last updated