功能预览

功能介绍

历史文章批量导入,压缩包和表格各适合哪种来源

历史内容批量导入时,带正文与配图的归档适合用压缩包进入,字段规整的纯文内容适合用表格进入。两种入口的选择取决于来源里资源与字段的比例。本文说明批量导入前后要核对的字段、导入先进草稿再放开发布的状态安排,以及导错之后借助回收站与接口查询回退的做法。

批量导入 内容迁移

功能介绍

历史文章批量导入时,压缩包和表格分别适合哪种来源?判断落在「来源里除了文字还带什么」:正文与配图绑定在一起的归档适合压缩包批量导入,字段整齐、以纯文为主的记录适合表格导入。AnQiCMS 同时支持 ZIP 压缩包和 Excel 表格两种批量导入入口,选错入口的代价通常不是失败,而是要人工补大量丢失的字段与资源。

先按来源形态选入口

从旧站导出的内容常见两类形态。一类是页面导出的归档:每篇正文配一份资源目录,图片以相对路径引用,正文与图片的对应关系写在文件结构里。这类来源用压缩包入口,资源能随正文一起落库。另一类是数据库导出或表格清单:标题、发布时间、分类、摘要各占一列,正文只有文字。这类来源用表格入口,字段映射直观,不需要为一张图再补一次处理。

来源特征 适合的批量导入入口 主要风险点
正文带本地配图目录 ZIP 压缩包 目录层级过深时资源引用要核对
纯文正文加规整字段 Excel 表格 长正文被表格单元格截断
来源是接口或抓取产物 先转成表格再导入 标题重复与状态没有约定
附件数量多且体积大 压缩包分批导入 单包过大导致失败后难定位

导入前先约定状态

批量导入不建议直接落到对外可见。文档状态分为正式文档、草稿、待发布、回收站几种,导入时先进草稿,抽样核对标题、正文与配图无误,再批量放开,可以避免一次错误把上千条半成品推到线上。需要在固定时间放开的部分走时间因子的定时发布,按设定时间自动生效,不用人工守着放。

草稿链接带 preview 标记,可以在不公开的前提下看渲染效果;这一步对表格导入尤其有用,因为表格里换行与空列很容易把段落结构改掉。

导入前后的字段核对

导入接口提供按标题查询是否已存在的能力,路径是 /api/import/archive,批量导入前先用它把重复标题筛出来,比导入之后再清理省事。要核对的字段集中在四处:标题是否被截断、分类与标签是否落到站内既有口径、摘要是否为空、正文里的相对资源路径是否被改写为站内地址。

字段口径不统一会带来后续维护成本。建议在导入表格里就固定列名与分类取值,让一次导入的字段与站内的自定义内容模型对应,避免同类内容在不同批次里落成不同结构。

导错了怎么回退

删除正式文档是移入回收站,不是物理删除,所以批量导入后发现某一批有问题,可以先批量删除再从回收站找回正确版本。要注意的是回退的边界:回收站保留的是站内文档,外部资源文件是否被一并清理,取决于导入时资源的落盘位置,回退前先在测试分类里走一遍同样的删除动作,确认资源与文档的对应关系。

问:表格里的正文有长度限制吗? 答:常见失败是单元格内容被截断,导入前把超长正文单独拆成列或改为压缩包入口更稳。

问:能不能两批内容一个用压缩包一个用表格? 答:可以,但要保证两批的分类与标签口径一致,否则同类内容在列表里排序与筛选表现会不一样。

问:导入前怎么确认标题没有重复? 答:用按标题查询的接口先比对一遍,重复的标题要么改要么先排除,避免导入后出现两个相近地址。

问:导入后想统一改发布时间可以吗? 答:可以,但要区分已放开与待放开的内容;需要延后生效的部分用定时发布安排,不要直接改线上文档的时间。