增加字段（实体管理器）

BringCRM 基于 EspoCRM，绝大多数外贸实体（客户、报价单、销售单、采购单、出运单、产品库等）均支持自定义字段。管理员可在不修改代码的情况下，为单据增加企业特有信息（如客户 PO 号、交货港口、包装要求、业务员英文名等），并在布局中展示，再通过 PDF 模板或 Excel 单证模板的占位符打印出来。

更详细的 Espo 官方能力说明

权限要求

仅管理员可使用实体管理器。业务员日常在详情页/编辑页录入您配置好的字段即可。

完整流程

添加字段 → 调整布局 → 模板占位符 → 业务录单后 打印 PDF / 导出 Excel

入口

使用管理员账号登录
顶部菜单 → 管理
左侧 → 实体管理器（Entity Manager）

参考 Espo 官方说明（英文）：Fields

选择要扩展的实体

在实体管理器列表中，常见 Bring 外贸实体如下：

实体中文名	内部名称	典型自定义场景
客户	Account	客户等级备注、行业细分、信用额度
报价单	CQuote	客户 PO、报价有效期、Incoterms
销售订单	CSalesOrder	合同号、交期、收款条款
采购订单	CPurchaseOrder	工厂订单号、质检要求
出运单	CShippingOrder	报关抬头、货代备注
产品库	CProduct	海关编码、材质、品牌
样品寄送	CSampleShipment	样品用途、快递要求

点击实体名称进入该实体的字段列表。

添加新字段

在实体详情页点击 添加字段（Add Field）
选择字段类型（Bring 扩展将常用类型排在前面，其余类型仍可选）
填写字段属性后保存

常用属性说明

属性	说明
名称（Name）	系统内部标识，英文 camelCase，如 `customerPoNo`，创建后不可改
标签（Label）	界面显示的中文名，如「客户 PO 号」
必填	保存记录时是否必须填写
默认值	新建记录时的预填值
最大长度	文本类字段的长度限制
选项列表	enum / multiEnum 的可选值
只读	仅展示、不可编辑（常用于公式或自动计算字段）

保存后系统会自动更新缓存；若界面未立即出现新字段，请 清除缓存（管理 → 清除缓存）并刷新浏览器。

修改或删除字段

实体管理器 → 选择实体 → 在字段列表中点击字段名
可修改标签、必填、选项等（名称一般不可改）
删除字段会永久删除该字段在所有历史记录中的数据，操作前请确认

删除前请备份

删除自定义字段不可恢复。专业版用户请先在数据备份与恢复中手动备份。

将新字段用于打印

添加字段并完成布局后：

PDF 模板

占位符格式：{{字段名}}
示例：字段名为 customerPoNo，模板中写 {{customerPoNo}}
关联客户上的字段：{{account.字段名}}
详见制作报价单 PDF 模板

Excel 单证模板

占位符格式：{{字段名}}（写在 .xlsx 单元格中）
在 管理 → Bring外贸 → Excel单证模板 编辑页，「可用占位符」下拉中按中文标签选择字段，复制后粘贴到 Excel
自定义字段会出现在占位符列表中，与系统字段相同
详见其它 Excel 模板

常见问题

Q：业务员看不到新字段？

检查布局管理器是否把字段加到了详情/编辑布局
检查角色权限是否禁止了该字段的「读/编辑」

Q：占位符列表里没有我的字段？

确认字段已保存且未被设为「仅管理员 / 内部 / 禁用」
Excel 模板需先选择正确的「实体类型」
执行清除缓存后重试

Q：能否复制别的实体的字段？

实体管理器支持「复制字段到当前实体」（若 Espo 版本提供该按钮）
不同实体的字段名可相同，但数据各自独立

类型	中文	适用场景
varchar	单行文本	PO 号、港口、简短备注
text	多行文本	条款说明、包装要求
enum	下拉单选	固定选项（如贸易条款细分）
multiEnum	下拉多选	多个标签
int / float / number	整数 / 小数 / 数字	数量、比例
currency	货币	带币种的金额
bool	布尔	是否含税、是否加急
date / datetime	日期 / 日期时间	交期、截关日
url	链接	客户网站、文件链接
image / file	图片 / 文件	单张图或单文件
attachmentMultiple	多附件	多张图片或附件