上千篇历史内容搬家,压缩包导入和表格导入各管哪一类数据
历史内容搬家时,压缩包导入和表格导入分别适合哪一类数据?AnQiCMS 的批量导入支持 ZIP 压缩包和 Excel 表格两种方式,选择标准不在数量而在数据形态:正文带配图的图文文章走 ZIP,字段化的目录型内容走 Excel。判断错了通道,迁移就得返工,这一篇把分法、打包要求、字段对齐和增量查重一次讲清。
哪一类数据该走哪条通道
先看内容本身长什么样,再决定用压缩包还是表格:
- 图文混排的博客文章、带正文排版的案例页:正文完整性和配图引用优先,走 ZIP 压缩包。
- 参数、门店、岗位这类结构化条目:字段齐整、行与行同构,走 Excel 表格。
- 只有标题和摘要、正文要后续补的存量目录:Excel 先把条目建起来,正文再逐篇补。
- 需要程序化分批搬运、中途可续跑的:用文档内容导入接口按标题查重,和批量导入互补。
| 数据形态 | 建议通道 | 关注点 |
|---|---|---|
| 图文混排文章 | ZIP 压缩包 | 正文与配图一起入库 |
| 目录型字段化内容 | Excel 表格 | 列名对齐自定义字段 |
| 待补正文的存量条目 | Excel 表格 | 先建条目再补内容 |
| 程序化分批迁移 | 导入接口 import/archive | 按标题查重、可续跑 |
ZIP 压缩包怎么整理才不返工
打包前的整理决定了导入后的返工量。文件名和文章标题保持对应,图片用包内相对引用,不要留外部站点的图片地址;一次打包控制在可核对的粒度,出问题好定位是哪一批。AnQiCMS 的批量导入同时支持 ZIP 压缩包与 Excel 表格,导入后内容先进入可检查的状态,抽查几篇再统一发布,比一把梭上线稳妥。
Excel 表格要对齐哪些字段
表格导入的本质是”列变成字段”,所以要在表头阶段就把结构和自定义内容模型对上:
- 列名用后台已定义的字段口径,分类、标签、标题、正文之外,品类差异参数放自定义字段。
- 一行一篇文章,单元格里只放字段值,不要写排版指令。
- 空列删掉,避免整列错位。
- 导入后按字段抽查筛选,能筛出就说明映射没错。
内容模型先定,导入才不会散
自定义内容模型决定导入后的可维护性。迁移前先定义模型:这篇内容有哪些字段、字段是否参与筛选和展示。模型没定就灌数据,字段只能塞进正文,后续想按参数检索就没有下手的地方。字段一经上线承载了内容就尽量少改类型,改字段约等于重导数据。
导入接口做增量与查重
上千篇内容很难一次跑完,中断后要能接着搬。文档内容导入接口(/api/import/archive)支持按标题查询文章是否已存在,续跑前先查后写,重复执行也不会把同一篇写两遍。接口调用的高频能力集中在文档与分类标签等内容面,具体参数可以查站内的接口文档。迁移完成后核对三件事:导入条目数与源清单是否一致、抽查字段与图片是否完整、发布与收录推送是否跟上,再用回收站和备份兜底误删。
常见问题
上千篇要分几批导入? 按可核对的粒度分批,每批抽查后再继续,配合导入接口的按标题查重,中断可随时续。
表格里的图片怎么办? Excel 只承载字段值,图片放不进表格;图文内容改走 ZIP 压缩包,或先建条目再补配图。
导入错了能回退吗? 删除正式文档是移入回收站,可恢复;批量误操作前建议先做一次备份。