批量导入文档怎么操作？AnQiCMS ZIP和Excel导入功能详解

AnQiCMS提供两种批量导入文档的方式：ZIP压缩包导入和Excel表格导入，均通过/api/import/archive接口实现。该接口支持按标题查询文档是否已存在，避免重复导入，适合从旧系统迁移大量内容或执行规律性的批量发布任务。

批量导入的适用场景

旧系统迁移。企业从其他平台切换到AnQiCMS时，历史文章数量可能达到数百甚至数千篇。手动逐篇复制粘贴不仅耗时，还容易遗漏图片、标签、发布时间等元数据。批量导入功能可一次性迁移全部内容。

规律性内容发布。某些行业需要定时发布大量标准化格式的内容。通过预先准备Excel表格或ZIP归档，配合时间因子-定时发布功能，可实现一次准备、分批上线的自动化流程。

多渠道内容聚合。企业可能从多个来源收集内容（如合作伙伴供稿、爬虫采集、AI生成），这些内容通常以文件或表格形式存储。批量导入将这些分散的内容快速整合到AnQiCMS中。

ZIP压缩包导入如何操作

ZIP导入适合保留原始HTML结构和嵌入媒体的场景：

第一步：准备ZIP文件结构。创建一个文件夹，包含articles目录（存放文章HTML文件）、images目录（存放文章中引用的图片），以及可选的metadata.json元数据文件。

第二步：压缩为ZIP文件。选中上述文件夹中的所有文件和子文件夹，压缩为zip格式。注意不要压缩文件夹本身，而是压缩其内容。

第三步：上传并导入。登录AnQiCMS后台，进入内容管理的批量导入，选择ZIP导入选项，上传准备好的ZIP文件。系统会自动解析文件结构，提取HTML内容和图片资源。

第四步：映射元数据。若提供了metadata.json，系统会自动匹配HTML文件与元数据；若未提供，需在导入界面手动设置默认分类、标签和发布状态。

第五步：验证导入结果。导入完成后，系统返回成功数和失败数清单。检查失败原因，修正后重新导入失败的条目。

ZIP导入的优势在于能保留富文本格式和嵌入式媒体，适合从其他CMS导出的HTML片段。缺点是元数据配置相对复杂。

Excel表格导入如何操作

Excel导入适合结构化强、元数据丰富的场景：

第一步：准备Excel表格。创建一个xlsx格式文件，第一行为表头，定义title（标题）、content（正文）、category_id（分类ID）、tags（标签）、publish_time（发布时间）、status（发布状态）等列。

第二步：填写内容数据。按列填入每篇文章的信息。正文列可直接粘贴HTML代码或纯文本。若包含图片，可将图片URL填入正文。

第三步：上传Excel文件。在批量导入界面选择Excel导入，上传准备好的Excel文件。系统会解析表格内容，预览前几行数据供确认。

第四步：字段映射与校验。系统将Excel列名映射到内部字段。若列名不匹配，需手动选择对应的目标字段。系统会校验必填字段是否完整、分类ID是否存在等。

第五步：执行导入。确认映射和校验通过后，点击开始导入。系统逐行读取表格数据，创建对应的文档记录。可通过接口的标题查重功能跳过已存在的文章。

Excel导入的优势在于元数据配置直观，适合大批量结构化数据的迁移。缺点是无法直接嵌入图片，需额外处理媒体资源。

导入接口API如何调用

对于需要自动化集成的场景，可直接调用/api/import/archive接口。该接口支持title、content、category_id、tags、publish_time、draft、keywords、description等参数。

接口返回该标题是否已存在，若存在则跳过导入，若不存在则创建新文档。这种幂等性设计确保多次调用不会产生重复数据。

两种导入方式的对比

企业可根据数据来源格式和技术能力选择合适的导入方式，也可混合使用。

常见问题

Q1: 导入后图片无法显示怎么办？

检查ZIP中图片路径是否与HTML中的引用一致，或Excel中的图片URL是否可公开访问。

Q2: 如何避免导入重复内容？

接口会自动按标题查重，相同标题的文章不会重复创建。若需基于其他字段去重，需在导入前自行清洗数据。

Q3: 导入失败的文章如何排查？

系统会返回失败清单，包含每篇失败文章的原因。根据提示信息修正数据后，可单独重新导入失败的条目。