1. 功能与应用目标
设备导入模块支持通过标准模板文件一次性批量导入设备信息，构建设备资产清单，为后续注册和策略配置打下基础。
支持查看导入记录、导入进度与每条导入数据详情。
注意：
该功能模块主要用于非iMin品牌设备信息的导入，只适用于KMA设备类型的设备信息导入。
iMin的设备信息会由iMin的IT系统自动同步至KiwiCloud中，无需手动导入。
如果KMA、IMA的设备信息没有导入，那么KMA和IMA设备就无法注册。
典型应用场景：
项目部署前按批次导入设备信息，准备设备清单
系统集成商上传多个品牌设备 SN，实现集中管理
渠道或客户交付环节用作上线前台账准备
大批量设备统一初始化绑定前操作
主要操作：
下载设备导入模板，填写并上传设备清单
查看导入任务列表，跟踪导入进度
查看每个导入任务下设备导入状态与明细
次要操作：
查询指定 SN 的导入记录
导出导入明细数据
2. 主要操作
2.1 下载并填写导入模板
准备标准格式的设备导入文件。
步骤：
1）点击页面右上角【模板下载】按钮，下载 CSV 格式模板：import-device-template.csv
2）按照模板格式填写设备信息，模板字段说明如下：
字段名 | 示例 | 说明 |
ID | 1 | 行编号，可留空或填序号 |
SN | 0123456789ABCDEF | 设备序列号（唯一标识，必填） |
Manufacturer | iMin Technology | 设备厂商名称（必填） |
Model | I23M02 | 设备型号标识（必填） |
CustomField | {"field":"value"} | 自定义字段，可空，格式为 JSON |
3）保存文件为 .csv 格式
2.2 执行导入任务
将设备清单批量导入 KC 系统。
步骤：
1）点击页面右上角【创建导入】按钮
2）选择准备好的导入模板文件并上传
3）系统开始处理数据，生成导入任务并显示在列表中
4）每次导入会分配唯一「流水号」，用于后续查看状态
2.3 查看导入任务列表与进度
跟踪每次导入的整体进度。
操作步骤：
1）页面显示所有历史导入任务，按时间倒序排列
2）列表显示字段包括：
流水号
导入进度（成功 / 总数）
注册进度（成功注册 / 总数）
操作人、开始时间、完成时间
3）可点击右侧【详情】按钮查看每条导入任务的导入详情
2.4 查看导入明细
查看每个导入任务中每条设备记录的导入状态。
操作步骤：
1）点击【详情】后进入导入任务详情页
2）查看以下字段：
SN
设备型号
分组
状态（SUCCESS / FAIL）
开始时间、完成时间
3）可点击【数据导出】按钮，导出该任务的所有导入明细记录
3. 次要操作
3.1 查询 SN 对应导入记录
1）在导入详情页面，搜索框中输入设备 SN
2）点击【查询】，系统将显示包含该 SN 的导入任务记录
3.2 导出导入明细数据
1）在导入详情页点击【数据导出】按钮
2）生成 Excel 文件，包含所有 SN、设备型号、导入状态、时间信息
4. 配置项说明
字段 / 配置项 | 说明 |
SN | 设备序列号，唯一标识设备，必填 |
Model | 型号标识，建议与平台识别字段一致 |
Manufacturer | 厂商名称，用于资产管理与筛选 |
CustomField | 自定义字段，支持嵌入结构化信息 |
导入进度 | 成功导入 / 总数（例如 2/2） |
注册进度 | 已注册设备 / 已导入设备（例如 1/2） |
状态 | 每条记录状态（成功 / 失败） |
流水号 | 系统生成的导入任务唯一编号 |