> ## 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>**名称**required`text`</summary>

  用户看到的输入框标签。贵公司同一张表上的两个字段不能同名。
</details>

<details>
  <summary>**数据类型**required`enum`</summary>

  决定用户获得哪种输入；从下一节的九种类型中选择。**保存后即固定**，因此要更换类型，需要删除该字段并添加新字段。
</details>

<details>
  <summary>**列表选项**`text[]`</summary>

  仅当类型为**列表**时显示。在此输入每个下拉选项；表单会拒绝空列表或含有空白选项的列表。
</details>

<details>
  <summary>**必需**`boolean`</summary>

  在输入值之前阻止保存记录。该标志对**是/否**字段无效。
</details>

<details>
  <summary>**标签**`text[]`</summary>

  将字段限制在以相同方式打上标签的记录上；留空时，该表的每条记录都有该字段。只有零件、原材料、工具、耗材、工装夹具、服务和工单提供此设置。
</details>

### 数据类型

| 类型 | 用户输入的内容 |
| - | - |
| **是/否** | 布尔开关 |
| **日期** | 一个日期 |
| **列表** | 从**列表选项**中选一项 |
| **数字** | 一个数字 |
| **文本** | 自由文本 |
| **用户** | 对某个 Alforse 用户的引用 |
| **客户** | 对某个客户的引用 |
| **供应商** | 对某个供应商的引用 |
| **文件** | 已定义，但记录表单尚无对应的输入 |

选择**用户**、**客户**或**供应商**会使输入变为选择器：保存的值是对该现有记录的引用，而不是键入的文本。

NOTE

**谨慎选择数据类型**

首次保存之后无法再编辑类型。如果需要不同的类型，请添加一个类型正确的新字段，并重新输入旧字段中存储的值。

## 哪些记录支持自定义字段

自定义字段适用于固定的记录类型列表，而不是所有记录。设置页面是权威列表：如果某记录类型在那里没有对应行，则它暂时不能使用自定义字段。

| 模块 | 记录类型 |
| - | - |
| **销售** | 客户、报价、销售订单、销售发票和询价单（RFQ），以及它们的联系人、位置和行 |
| **采购** | 供应商、采购订单、供应商报价和采购询价单，以及它们的行和联系人 |
| **开票** | 采购发票、付款、备忘录 |
| **物料** | 零件、工具、原材料、耗材、工装夹具和服务，以及它们的成本和计划记录（参见[物料](https://docs.alforse.com/zh/docs/reference/items.md)） |
| **资源** | 员工岗位、工作中心、部门、位置、工艺、班次 |
| **库存** | 收据、发货、仓库转移、拣货单、货架 |
| **生产** | 工单 |
| **质量** | 量具、问题 |
| **会计** | 账户、付款条件、凭证 |

## 值存放在哪里

在记录的表单上，您的自定义输入排在标准输入之后。用户输入的内容保存在该记录的 `customFields` JSON 列中。

该列包含在 API 响应中，并可用作筛选条件。由于它是按字段 ID 而不是用户看到的标签作为键，因此在解读之前，请先到设置目录中将每个键对应回其定义。

HEADS UP

**CSV 导入和导出会忽略自定义字段**

CSV 只处理标准字段：导入从不填充 `customFields` 列，表格下载也会将其排除。自定义值请使用记录表单或 API，并查看[导入与导出](https://docs.alforse.com/zh/docs/reference/import-export.md)了解 CSV 支持的内容。


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