字段类型详解（Fields）

本文详述 EspoCRM 字段类型与常用参数，供管理员在 实体管理器 → 字段 中正确选型。Bring 外贸场景下的应用示例一并说明。

通用参数（多数类型共有）

参数	说明
Label 标签	界面显示的中文名
Required 必填	不填无法保存
Audited 审计	变更记入 Stream / 审计日志
Read-only 只读	不可编辑，可由公式赋值
Read-only After Create	仅创建时可填，之后只读
Default 默认值	新建记录预填；对已有记录可能写库默认值
Disable Inline Edit	列表行内不可改
Tooltip Text 提示	字段旁 ? 说明，支持 Markdown
Not Lockable	记录锁定时仍 editable

可创建的字段类型

文本类

Varchar 单行文本

用途：PO 号、港口、单号后缀、简短备注
参数：Max-length、Options（自动完成列表）、Pattern（正则校验）、复制按钮
Bring 示例：customerPoNo 客户 PO 号

Text 多行文本

用途：包装要求、条款补充、长备注
参数：Max-length、Markdown、行数、截断高度
Bring 示例：CQuote 的 terms 条款

Enum 下拉单选

用途：固定选项状态、分类
参数：Options（值=>标签）、颜色 Display as Label、Options Reference 复用另一字段选项
Bring 示例：followUpProgress 跟进进度、status 单据状态
技巧：第一项留空可表示「未选」

Multi-Enum / Checklist / Array

Multi-Enum：多选有序列表
Checklist：多选复选框
Array：类似 Multi-Enum，可无预定义选项让用户自填

数字与日期

Int / Float / Decimal / Number

类型	说明
Int	整数
Float	小数
Decimal	高精度小数（v9.3+，字符串存储）
Number	自动编号，可 Prefix + 补零，如 `QT-00001`

Date / Date-Time

参数：After/Before 字段校验、Use Numeric Format（否则显示「今天」等相对词）
Bring 示例：quoteDate、contractDate、nextFollowUpDate

Currency 货币

数值 + 货币代码
参数：Min/Max、Only default currency、Disable Conversion
Bring 示例：明细 unitPrice + unitPriceCurrency

Boolean 布尔

复选框 true/false

联系与地址

Address 地址

街道、城市、省、邮编、国家
Account 发货地址等

Url / Url-Multiple

单个或多个链接

富文本与媒体

Wysiwyg

HTML 富文本（少用在外贸单证字段，PDF 用 {{{field}}} 输出 HTML）

File / Image / Attachment-Multiple

类型	说明
File	单文件
Image	单图，可设预览尺寸
Attachment-Multiple	多附件

Bring 示例：CProduct productImage；销售单 attachment 合同扫描件

条码 Barcode

可打印到 PDF，类型 CODE128、QRcode 等

Foreign 关联字段只读

显示关联记录上的某个字段，只读
参数：Link + Field
例：在自定义实体上显示 account.name 的镜像（一般用模板占位符即可，不必建 Foreign）

不可直接创建的类型（由关系自动生成）

类型	说明
Email	多邮箱+主邮箱+退订标记
Phone	多电话+类型
Link	belongsTo 关系的单选关联
Link-Parent	多类型父记录
Link-Multiple	hasMany 多选（关系启用 Link Multiple 时）

Bring 单据上的 客户 account、供应商 supplier 均为 Link 类型。

Bring 模块特殊字段（勿重复创建）

字段	实体	类型	说明
productsData	报价/销售/采购/出运	jsonArray	产品明细行编辑器
placeholderHelp	ExcelTemplate	base	占位符帮助 UI
cReceiptStatus	CSalesOrder	enum	收款状态，只读
cPaymentStatus	CPurchaseOrder	enum	付款状态，只读

自定义字段请用 varchar/text/enum 等常规类型。

动态逻辑

字段可见性、必填、只读、enum 条件选项 → 动态逻辑

字段与 PDF/Excel 占位符

字段 Name	PDF	Excel
customerPoNo	`{{customerPoNo}}`	`{{customerPoNo}}`
account（Link）	`{{account.name}}`	`{{account.name}}`
productsData 明细	`{{#each productsData}}` …	`{{productsData[quantity]}}`

添加字段后，Excel 模板编辑页 可用占位符 列表会自动出现（按 Label 选择）。

字段权限

管理 → 角色 → {角色} → {实体} → 字段

可单独禁止某角色查看/编辑敏感字段（如成本价 costPrice）。

常见问题

Q：默认值没应用到旧数据？

数据库 DEFAULT 仅影响新列创建时；旧记录需批量更新或导入

Q：Link 只读时不能从关系面板创建子记录？

只读 Link 不传当前 ID，需先解除只读或改用非只读 Link

Q：Bring 扩展常用字段类型顺序？

模块在 fieldManager 中优先：varchar、text、enum、currency、date…