实体管理器能做什么
实体管理器是 Espo 平台的核心配置入口:每个业务对象(客户、报价单、产品、角色…)都是一个实体。Bring 外贸模块的 CQuote、CSalesOrder、CProduct 等也在这里管理结构。
入口:管理 → 实体管理器 → 点击实体名称。
完整说明见 实体管理器(详解);本文是管理员快速对照表。
首页:实体列表
- 搜索/浏览所有实体(Espo 原生 + Bring 外贸)
- 创建实体:一般企业不必新建与 Bring 重复的业务实体,用 自定义字段 即可
- Bring 核心实体(CQuote、CProfit 等)请勿删除或禁用
进入某一实体后
| 按钮/菜单 | 做什么 | 典型场景 |
|---|---|---|
| 编辑 | 改实体级参数:标签、Stream、看板状态字段、文本过滤字段、排序 | 让自定义字段可被列表搜索框搜到 → 顶栏搜不到某个字段 |
| 字段 | 添加/编辑/删除字段(类型、必填、选项) | 增加字段 |
| 关系 | 查看/创建实体间 One-to-Many、Many-to-Many 等 | 自定义「合同」关联客户 |
| 布局 | 进入 List / Detail / Edit / filters 等布局 | 列表加列、详情排版、搜索筛选可选字段 |
| 公式 | Before-save 公式脚本 | 自动计算字段(Bring 利润等多由模块 Hook 实现) |
| 删除 | 仅适用于自建实体 | 勿删 Bring 预置实体 |
布局:最常改的几项
| 布局名 | 影响界面 | 技巧文档 |
|---|---|---|
| List | 列表页列与默认列宽 | 列表列宽太窄 |
| Detail / Edit | 详情与编辑表单 | 修改布局 |
| filters(Search Filters) | 列表 按字段搜索 ▼ 里能选哪些字段 | 列表筛选与保存过滤器 |
| listQuote / listSales 等 | 报价/销售/采购/出运明细子表列 | 增加字段 — 明细行加列 |
在布局编辑器中:加行、加单元格、设列 Width;建议 留一列不设宽度 以自动撑满。详见 布局管理器。
编辑实体:关键参数
| 参数(中文界面) | 作用 |
|---|---|
| 文本过滤字段 | 列表顶栏搜索框搜哪些列 → text-filter-search.md |
| 状态字段 + 看板 | 启用看板视图 → kanban-view.md |
| Stream | 详情页跟进/动态流 |
| 默认排序 | 列表默认按哪列排 |
| 全文搜索 | 顶栏全局搜索是否索引该实体 |
| 禁用 | 整个实体从系统中隐藏(慎用) |
Bring 示例:CQuote 状态字段 status + 看板;Account 状态字段 followUpProgress(跟进进度看板)。
主要预设筛选(Primary Filters)
管理员在 实体管理器 → 编辑实体 中可配置 Primary Filters(主要预设筛选),会出现在列表左侧 筛选 ▼ 中,全员可见,例如:
- 客户:公海客户、我的客户
- 与用户在列表上 保存过滤器(个人私有)不同
用户如何保存个人筛选:见 列表筛选与保存过滤器。
添加字段后的必做三步
- Detail / Edit 布局 — 否则详情/编辑页看不到字段
- filters 布局(若要按字段筛) + 文本过滤字段(若要搜索框可搜)
- 清除缓存;PDF/Excel 模板中加占位符(若要打印)