修改布局(布局管理器)
布局管理器决定用户在列表、详情、编辑、搜索筛选等界面看到哪些字段、以什么顺序和分组展示。添加 自定义字段 后,必须在这里把字段放到页面上,业务员才能录入并在单证中打印。
参考 Espo 官方说明(英文):Layouts
入口
- 管理 → 布局管理器(Layout Manager)
- 左侧选择实体(如 报价单 CQuote、销售订单 CSalesOrder)
- 选择要编辑的布局类型
布局类型说明
| 布局类型 | 作用 | 典型调整 |
|---|---|---|
| 详情(Detail) | 只读查看页 | 调整面板顺序、隐藏内部字段 |
| 编辑(Edit) | 新建/修改表单 | 把自定义字段放到「基本信息」等面板 |
| 列表(List) | 列表页列 | 增加「客户 PO」等列便于筛选浏览 |
| 搜索(Search) | 列表顶部的筛选区 | 加入常用筛选项 |
| 筛选(Filters) | 高级筛选 | 按状态、日期等过滤 |
| 批量编辑 | 列表批量改字段 | 可选配置 |
| 侧边面板 | 详情页右侧 Stream 等 | 一般保持默认 |
Bring 外贸单据常见面板(以报价单为例):
- 基本信息 — 单号、客户、日期、状态
- 明细与金额 — 产品明细行、其它费用、总金额
- 条款与备注 — 报价条款等
- 关联 — 关联销售单、样品等
把新字段加到编辑/详情页
- 布局管理器 → 选择实体 → 编辑(或 详情)
- 界面为网格:每一格可放一个字段,空行为面板标题
- 从右侧 添加字段 列表中,拖拽或点击添加到目标面板
- 可拖动调整顺序;点击字段可设为「全宽」占一整行(适合 text 长文本)
- 点击 保存
建议
- 编辑 与 详情 布局保持一致,避免「能填不能看」或相反
- 重要自定义字段放在「基本信息」靠前位置
- 列表页只放最常看的 5~8 列,避免过宽
列表示例:销售订单列表
建议列(可按企业习惯调整):
| 列 | 说明 |
|---|---|
| 名称 | 销售单号 |
| 客户 | 关联客户 |
| 合同日期 | |
| 订单状态 | 看板/筛选常用 |
| 总金额 | |
| 指派用户 | 负责人 |
动态逻辑(可选)
管理 → 动态逻辑(Dynamic Logic)可设置:当某字段等于某值时,显示/隐藏/必填其他字段。
示例:当「贸易条款」= FOB 时,才显示「装运港」自定义字段。
布局与打印的关系
- 布局只影响屏幕上的录入与展示
- PDF / Excel 模板独立配置,通过占位符引用字段值
- 字段只要在实体中存在且有数据,即使不在详情布局中,仍可在模板里用
{{字段名}}打印(但不便业务员核对,仍建议加入布局)
恢复默认布局
若改乱,可在布局编辑器中使用 恢复默认(Restore Default)。注意:会丢失对该布局的自定义修改,但不会删除字段本身。
常见问题
Q:保存后前台没变化?
- 管理 → 清除缓存,浏览器强制刷新(Ctrl+F5)
Q:明细行里的列能改吗?
- 产品明细(
productsData)的列由模块专用表格组件控制,与布局管理器中普通字段不同;明细持久化字段见各*Item实体布局
Q:手机端布局?
- 编辑/详情布局在窄屏会自动折行,全宽字段体验更好