> ## Documentation Index
> Fetch the complete documentation index at: https://docs.alforse.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 自訂欄位

> 為客戶、品項、訂單與其他核心記錄加入貴公司自己的欄位——如何定義、哪些記錄支援，以及它們的值存放在哪裡。

管理員使用自訂欄位來記錄 Alforse 預設不追蹤的資訊，例如零件的出口分類，或客戶的重點客戶負責人。每個欄位只需定義一次；之後它就會顯示在該記錄類型的表單上、與標準欄位一起儲存，並可透過 API 讀取。不涉及任何資料庫變更。

## 新增欄位

1. 開啟**設定 → 自訂欄位**。每種符合資格的記錄類型各有一列，顯示**表格**、其**模組**，以及它已有多少個**欄位**。
2. 開啟記錄類型的列選單並選取**新增欄位**。您也可以選取**檢視自訂欄位**來查看該類型現有的欄位，並從那裡新增。**新增自訂欄位**表單隨即開啟。
3. 填寫下面說明的設定，然後選取**儲存**。

在記錄類型的欄位清單中，您還可以拖曳把手來變更欄位出現的順序，並編輯或刪除其中任何一個。

Alforse screenshot**設定 → 自訂欄位：含表格、模組與欄位欄的實體目錄，以及含名稱、資料類型與標籤的欄位表單**

每個符合資格的實體一列；欄位表單在建立後會鎖定其資料類型。

### 欄位設定

FieldType

<details>
  <summary>**Name**required`text`</summary>

  使用者看到的輸入標籤。貴公司同一個資料表上的兩個欄位不可使用相同的名稱。
</details>

<details>
  <summary>**Data Type**required`enum`</summary>

  決定使用者取得哪種輸入；請從下一節的九種類型中選擇。**儲存後即固定**，因此要更換就必須刪除該欄位並新增另一個。
</details>

<details>
  <summary>**List Options**`text[]`</summary>

  僅在類型為**清單**時顯示。在此輸入每個下拉選項；若清單為空或包含空白選項，表單會拒絕。
</details>

<details>
  <summary>**Required**`boolean`</summary>

  在輸入值之前阻止儲存記錄。此旗標對**是／否**欄位無效。
</details>

<details>
  <summary>**Tags**`text[]`</summary>

  將欄位限制在以相同方式加上標籤的記錄；留空時，該資料表的每筆記錄都會有此欄位。只有零件、物料、工具、耗材、治具、服務與工單提供此設定。
</details>

### 資料類型

| 類型 | 使用者輸入的內容 |
| - | - |
| **是／否** | 布林開關 |
| **日期** | 日期 |
| **清單** | **清單選項**中的一個選項 |
| **數值** | 數字 |
| **文字** | 自由文字 |
| **使用者** | 對 Alforse 使用者的參照 |
| **客戶** | 對客戶的參照 |
| **供應商** | 對供應商的參照 |
| **檔案** | 已定義，但記錄表單目前還沒有對應的輸入 |

選擇**使用者**、**客戶**或**供應商**會讓輸入變成選擇器：儲存的值是對該現有記錄的參照，而不是輸入的文字。

NOTE

**請謹慎選擇資料類型**

第一次儲存後，就無法再編輯類型。如果您需要不同的類型，請新增一個類型正確的欄位，並重新輸入舊欄位中儲存的值。

## 哪些記錄支援自訂欄位

自訂欄位提供給一份固定的記錄類型清單，而不是所有記錄。設定頁面才是權威清單：如果某個記錄類型在那裡沒有列，就表示它目前還不能使用自訂欄位。

| 模組 | 記錄類型 |
| - | - |
| **銷售** | 客戶、報價單、銷售訂單、銷售發票與 RFQ，以及它們的聯絡人、地點與明細 |
| **採購** | 供應商、採購單、供應商報價與採購 RFQ，以及它們的明細與聯絡人 |
| **發票** | 採購發票、付款、備忘單 |
| **品項** | 零件、工具、物料、耗材、治具與服務，連同它們的成本與規劃記錄（請參閱[品項](https://docs.alforse.com/zh-Hant/docs/reference/items.md)） |
| **資源** | 員工職務、工作中心、部門、地點、流程、班次 |
| **庫存** | 收貨、出貨、倉庫調撥、揀料清單、貨架 |
| **生產** | 工單 |
| **品質** | 量規、問題 |
| **會計** | 科目、付款條件、日記帳 |

## 值存放在哪裡

在記錄的表單上，您的自訂輸入排在標準輸入之後。使用者輸入的任何內容，都保存在該記錄的 `customFields` JSON 欄中。

該欄位會包含在 API 回應中，也可以用作篩選條件。由於它是以欄位 ID 而不是使用者看到的標籤作為鍵，在解讀之前，請先在設定目錄中將每個鍵對應回它的定義。

HEADS UP

**CSV 匯入與匯出會忽略自訂欄位**

CSV 只處理標準欄位：匯入絕不會填入 `customFields` 欄，資料表下載也會省略它。自訂值請使用記錄表單或 API，並查看[匯入與匯出](https://docs.alforse.com/zh-Hant/docs/reference/import-export.md)了解 CSV 處理的內容。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.