导入导出的模板(ImportTemplate)
导入模板用于批量导入 CSV/Excel 数据时,预设列映射、分隔符、默认值等,避免每次导入重复配置。专业版功能。
参考 Espo 官方说明(英文):Import
入口
管理 → Bring外贸 → 导入模板
预装模板
安装 Bring 扩展时会为以下实体创建默认导入模板(名称含 Default Import Template),包括但不限于:
客户、联系人、产品库、供应商、货代、报价单、销售单、销售明细、采购单、出运单、样品寄送、应收应付、收付款、利润、退税、资金账户、检测相关等。
模板主要字段
| 字段 | 说明 |
|---|---|
| 模板名称 | 识别用 |
| 实体类型 | 导入目标实体 |
| 状态 | 启用 / 停用 |
| 默认模板 | 同实体多个模板时,「按模板导入」优先用默认 |
| 导入动作 | 创建 / 更新 / 创建并更新 |
| 标题行 | 文件首行是否为列名 |
| 字段分隔符 | CSV 分隔符 |
| 列映射 attributeList | 文件列 ↔ 系统字段 |
| 按字段更新 updateBy | 更新模式下匹配键(如 name、id) |
| 默认值 defaultValues | 未在文件中提供的字段默认值 |
| 样本文件 | 供用户下载的导入样例 |
管理导入模板
- 打开 导入模板 记录或 创建
- 选择 实体类型
- 在 列映射 面板配置 Excel/CSV 列与系统字段对应关系
- 可选配置 默认值(如默认币种、默认状态)
- 保存为模板样本:可从一次成功导入截取前 10 行作为样本(系统支持时)
- 状态设为 启用
业务端:按模板导入
- 进入目标实体 列表页(如客户、产品库、报价单)
- 点击 按模板导入
- 系统加载该实体的默认/启用导入模板,进入 导入数据 向导
- 上传文件 → 确认映射 → 执行导入
也可从 More → 导入数据 进入通用导入,再选择模板。
导出与「按模板导出」
支持增强导出的实体,列表 导出 时可:
- 标准导出 Xlsx/Csv
- 按模板导出 — 字段集与导入模板一致,便于「导出 → 修改 → 再导入」
- 下载模板样本 — 获取带列头的样例文件
详见 导入数据/导出数据。
常见问题
Q:导入失败提示字段不匹配?
- 检查文件列名与模板映射;或重新上传并调整映射
Q:免费版能用吗?
- 导入模板为 专业版 功能;免费版可使用 Espo 基础导入但无 Bring 预置模板与「按模板导入」按钮