文档商店运营
导入产品
使用 Runner 的 CSV 模板启动目录导入并跟踪其处理历史。
当逐个输入相同的结构化目录信息效率低下时，从准备好的 CSV 导入产品。
为什么以及何时使用导入
当您已经在电子表格或其他系统中拥有产品数据并可以将其映射到 Runner 的 CSV 模板时，使用导入。对于小型目录或需要先了解字段时，使用手动产品表单。
可用性和前提条件
- 在就绪的商店中打开商店运营 → 产品。
- 完成创建其实时店面目录渠道的商店发布/就绪设置；导入任务无法在没有该渠道的情况下继续。
- 填充的桌面产品列表显示导入。在空目录中，首先使用添加第一个产品；移动视图强调手动创建。
- 导入仅接受 CSV 文件。
- 使用 Runner 的当前模板。必需的列是
handle和title；变体行必须包括模板显示的必需sku和选项值。 - 启动导入会更改商店目录。提交文件前请查看。
打开导入产品
入口路径： 工作区 → 选择商店 → 商店运营 → 产品 → 导入
主要控件
| 控件 | 使用原因 | 选中时发生的情况 |
|---|---|---|
| 导入 | 打开批量导入工作流 | 打开导入产品对话框而不启动任务。 |
| 模板 | 从 Runner 的预期列开始 | 下载当前 product-import-template.csv 文件。 |
| 历史 | 检查早期的导入任务 | 切换到导入文件及其最新状态的列表。 |
| 上传区域 | 选择准备好的 CSV | 在本地读取文件并在内容可用时将其显示为就绪。 |
| 移除文件控件 | 更正错误的选择 | 清除选定的文件，以便您可以选择另一个。 |
| 启动导入 | 提交选定的 CSV | 启动导入任务，然后在 Runner 接受时移动到历史。 |
| 取消 | 不提交而离开 | 关闭对话框并清除选定的文件。 |
| 刷新在历史中 | 请求最新的任务状态 | 重新加载可见的导入历史。 |
| 返回导入 | 准备另一个文件 | 从历史返回到上传视图。 |
| 关闭 | 离开历史 | 关闭对话框而不更改已提交的任务。 |
准备并提交 CSV
- 选择导入，然后模板。
- 在保留 CSV 格式的电子表格编辑器中打开下载的 CSV。
- 保留模板标题。为产品完成
handle和title，加上变体显示的sku和选项值。 - 在导出为 CSV 前查看产品句柄、标题、价格、变体和任何重复的行。
- 返回对话框并将 CSV 选择或拖动到上传区域。
- 等待文件显示准备导入。
- 仅选择一次启动导入。
- 在历史中，跟踪提交的文件直到达到终端状态，然后刷新产品列表并检查结果行。
理解历史状态
| 状态 | 含义 | 要做什么 |
|---|---|---|
| 待处理 | 任务正在等待启动 | 将其保留在原位并稍后再检查；不要立即提交重复项。 |
| 处理中 | Runner 正在处理文件 | 保持对话框打开或稍后返回历史。 |
| 已完成 | Runner 完成了将文件交给目录导入器 | 产品处理可以在此状态后继续。刷新产品并检查名称、变体、价格、状态和库存。 |
| 失败 | Runner 无法完成导入任务 | 当前历史卡记录失败状态但不记录详细原因。在提交新文件前检查前提条件和源 CSV。 |
| 已取消 | 任务未继续 | 确认是否创建了任何产品，然后决定接下来提交什么。 |
历史还可以显示文件大小、总行数和事务 ID（当 Runner 拥有这些值时）。这些详细信息标识任务；它们不能替代检查产品记录。
限制和故障排除
- 启动导入已禁用： 选择
.csv文件并等待 Runner 完成读取非空内容。 - 无效的文件类型： 将电子表格导出为 CSV；重命名另一个文件格式不会转换它。
- 文件读取错误： 重新导出 CSV，确认它在您的设备上正常打开，然后再次选择它。
- 导入失败： 确认商店发布/就绪设置创建了实时店面目录渠道，然后使用提供的模板、恢复必需的列并检查变体
sku和选项值。 - 任务看起来卡住了： 打开历史并选择刷新。待处理和处理中不是完成的证明。
- 出现意外的产品行： 不要盲目重复相同的导入。比较 CSV 句柄与产品列表并有意更正记录。