Appearance
Excel工单导入
Excel工单导入功能允许用户通过上传Excel文件批量创建工单，支持自定义字段映射规则，适合SAAS模式下不同公司的个性化需求。
功能概述
通过Excel工单导入，您可以：
- 批量创建工单: 一次最多支持30条工单数据
- 灵活字段映射: 支持将Excel列与工单字段进行灵活映射
- 规则保存复用: 映射规则可保存到本地，下次直接使用
- 数据预览验证: 导入前可预览转换后的数据
- 详细结果反馈: 实时显示导入进度和详细结果
访问路径
菜单路径: 订单来源 → Excel导入
功能特点
- ✅ 纯前端处理 - Excel文件在前端解析，无需后端支持
- ✅ 字段映射 - 支持将Excel列与工单字段进行灵活映射
- ✅ 规则保存 - 映射规则可保存到本地，下次直接使用
- ✅ 数据预览 - 导入前可预览转换后的数据
- ✅ 批量导入 - 一次最多支持30条工单数据
- ✅ 进度显示 - 实时显示导入进度和结果
- ✅ 错误处理 - 详细的错误信息和失败重试
使用流程
1. 进入导入页面
在订单来源菜单中点击"Excel导入"，或直接访问 /orderOrigin/excelImport
2. 上传Excel文件
支持格式:
.xlsx格式（推荐）.xls格式
文件要求:
- 文件大小限制：2MB
- 数据行数限制：30条
- 支持拖拽上传
上传步骤:
- 点击上传区域或拖拽文件到上传区域
- 选择Excel文件
- 系统自动解析文件内容
- 显示Excel列标题和数据预览
3. 配置字段映射
将Excel列与工单字段进行对应：
| 工单字段 | 说明 | 是否必填 |
|---|---|---|
| 订单标题 | 工单的标题 | ✅ 必填 |
| 订单描述 | 详细描述工单内容 | ❌ 选填 |
| 客户姓名 | 客户的姓名 | ❌ 选填 |
| 联系电话 | 客户的联系电话 | ❌ 选填 |
| 服务地址 | 提供服务的地址 | ❌ 选填 |
| 备注信息 | 非公开备注信息 | ❌ 选填 |
映射规则:
- 每个工单字段可以映射到多个Excel列
- 多列数据会用换行符连接
- 必填字段必须完成映射
- 选填字段可以不映射
映射步骤:
- 在"字段映射"步骤中查看Excel列标题
- 为每个工单字段选择对应的Excel列
- 必填字段（订单标题）必须完成映射
- 选填字段可以根据需要选择映射
4. 保存映射规则（可选）
保存规则:
- 输入规则名称
- 点击"保存规则"按钮
- 规则将保存到浏览器本地存储
- 下次可直接选择已保存的规则
使用规则:
- 在"选择映射规则"下拉框中选择已保存的规则
- 系统自动应用映射配置
- 可以基于已有规则进行修改
5. 数据预览
预览内容:
- 查看转换后的数据
- 检查数据有效性
- 查看统计信息（总数据、有效数据、无效数据）
预览步骤:
- 完成字段映射后，点击"下一步"
- 在"数据预览"步骤中查看转换结果
- 检查数据是否正确
- 查看统计信息
- 确认无误后点击"开始导入"
6. 开始导入
导入过程:
- 点击"开始导入"按钮
- 系统会逐条创建工单
- 显示实时进度
- 导入完成后显示详细结果
导入结果:
- 成功导入数量
- 失败数量
- 总数量
- 成功率
- 每行数据的详细状态
Excel模板格式
标准模板
下载系统提供的模板文件，包含以下列：
| A列 | B列 | C列 | D列 | E列 | F列 |
|---|---|---|---|---|---|
| 订单标题 | 订单描述 | 客户姓名 | 联系电话 | 服务地址 | 备注信息 |
自定义格式
支持任意格式的Excel文件，通过字段映射功能进行对应：
示例：客户自己的Excel格式
| 工单名称 | 详细说明 | 联系人 | 手机号 | 地址 | 其他信息 |
|---|
映射配置:
- 订单标题 ← 工单名称
- 订单描述 ← 详细说明
- 客户姓名 ← 联系人
- 联系电话 ← 手机号
- 服务地址 ← 地址
- 备注信息 ← 其他信息
数据验证规则
必填验证
- 订单标题不能为空
格式验证
- 电话号码格式验证（11位数字，1开头）
- 地址长度验证
数据清理
- 自动过滤空行
- 去除首尾空格
- 处理特殊字符
导入结果
成功统计
- 成功导入数量
- 失败数量
- 总数量
- 成功率
详细结果
- 每行数据的导入状态
- 失败原因
- 生成的工单ID
- 操作按钮（查看工单、重试）
结果导出
- 支持导出导入结果为Excel文件
- 包含所有导入数据和状态信息
注意事项
数据限制
- 一次最多30条数据
- 文件大小不超过2MB
- 建议分批导入大量数据
浏览器兼容性
- 需要支持FileReader API
- 建议使用现代浏览器
网络要求
- 需要稳定的网络连接
- 导入过程中避免刷新页面
权限要求
- 需要工单创建权限
- 管理员权限可查看所有工单
故障排除
常见问题
Q: 上传文件后无法解析？ A: 检查文件格式是否为.xlsx或.xls，文件是否损坏
Q: 字段映射不生效？ A: 确保必填字段（订单标题）已映射，检查Excel列选择是否正确
Q: 导入过程中断？ A: 检查网络连接，避免刷新页面，可使用重试功能
Q: 部分数据导入失败？ A: 查看错误信息，检查数据格式，使用重试功能
错误代码
| 错误信息 | 原因 | 解决方案 |
|---|---|---|
| 文件格式错误 | 上传了非Excel文件 | 重新选择正确的Excel文件 |
| 文件过大 | 文件超过2MB限制 | 压缩文件或分批导入 |
| 数据行数超限 | 超过30行限制 | 删除多余行或分批导入 |
| 订单标题不能为空 | 必填字段未映射 | 完成订单标题字段映射 |
| 电话号码格式不正确 | 手机号格式错误 | 检查并修正手机号格式 |
最佳实践
数据准备建议
1. Excel文件准备
- 使用标准模板: 首次使用建议下载并使用系统提供的标准模板
- 数据清理: 导入前清理空行、重复数据和无效数据
- 格式统一: 确保电话号码、日期等字段格式统一
- 必填字段检查: 确保订单标题等必填字段已填写完整
2. 数据验证
- 电话号码: 确保是11位数字，1开头的有效手机号
- 地址信息: 地址要详细完整，便于员工定位
- 订单描述: 描述要清晰明确，避免歧义
- 特殊字符: 避免使用特殊字符，可能导致导入失败
3. 批量导入策略
- 分批处理: 超过30条数据建议分批导入
- 测试导入: 首次使用建议先导入少量数据测试
- 时段选择: 避免在业务高峰期进行大批量导入
- 备份数据: 导入前备份原始Excel文件
业务场景应用
场景1：物业公司批量导入维修工单
- 数据来源: 业主通过物业APP提交的维修申请
- 导入频率: 每天早上统一导入前一天的申请
- 字段映射:
- 订单标题 ← 维修项目
- 订单描述 ← 问题描述
- 客户姓名 ← 业主姓名
- 联系电话 ← 联系方式
- 服务地址 ← 房号 + 详细地址
- 规则保存: 保存为"物业维修导入规则"
- 导入数量: 平均每天20-30条
场景2：家政公司从CRM系统导出订单
- 数据来源: CRM系统导出的客户预约信息
- 导入频率: 每周一次批量导入
- 字段映射:
- 订单标题 ← 服务类型
- 订单描述 ← 服务要求 + 服务时间
- 客户姓名 ← 客户姓名
- 联系电话 ← 手机号码
- 服务地址 ← 服务地址
- 备注信息 ← 特殊要求
- 规则保存: 保存为"CRM导入规则"
- 导入数量: 每周50-100条（分批导入）
场景3：设备维修公司从工单系统迁移数据
- 数据来源: 旧系统导出的历史工单
- 导入频率: 一次性批量导入
- 字段映射:
- 订单标题 ← 设备名称 + 故障描述
- 订单描述 ← 详细故障信息
- 客户姓名 ← 客户单位
- 联系电话 ← 联系电话
- 服务地址 ← 设备地址
- 备注信息 ← 历史记录
- 规则保存: 保存为"数据迁移规则"
- 导入数量: 分多次导入，每次30条
不同规模团队的使用建议
小型团队（5-10人）
- 导入频率: 每天1-2次
- 数据量: 每次10-20条
- 映射规则: 保存1-2个常用规则
- 质量控制: 导入后及时检查，发现问题立即修正
中型团队（10-30人）
- 导入频率: 每天2-3次
- 数据量: 每次20-30条
- 映射规则: 保存3-5个不同场景的规则
- 质量控制: 建立导入检查流程，定期统计导入质量
大型团队（30人以上）
- 导入频率: 每天多次，根据业务需求
- 数据量: 严格控制每次30条以内
- 映射规则: 保存多个规则，按业务类型分类
- 质量控制: 专人负责导入操作，建立质量监控体系
FAQ 常见问题
文件处理
Q: 支持哪些Excel文件格式？ A: 支持.xlsx（Excel 2007及以上）和.xls（Excel 2003）两种格式，推荐使用.xlsx格式。
Q: 为什么我的Excel文件无法上传？ A: 请检查：
- 文件格式是否为.xlsx或.xls
- 文件大小是否超过2MB
- 文件是否损坏（尝试在Excel中重新打开）
- 数据行数是否超过30条
Q: Excel文件中有公式会影响导入吗？ A: 不会。系统会读取单元格的最终值，不是公式本身。
Q: 可以导入多个工作表的数据吗？ A: 目前只支持读取第一个工作表的数据，其他工作表会被忽略。
字段映射
Q: 必填字段有哪些？ A: 目前只有"订单标题"是必填字段，其他字段都是选填。
Q: 一个Excel列可以映射到多个工单字段吗？ A: 不可以。每个Excel列只能映射到一个工单字段，但一个工单字段可以映射多个Excel列。
Q: 如果Excel列标题是中文，映射会受影响吗？ A: 不会。系统支持任何语言的列标题，映射时选择对应的列即可。
Q: 保存的映射规则可以在其他电脑上使用吗？ A: 不可以。映射规则保存在浏览器本地存储中，只能在当前浏览器使用。
数据导入
Q: 为什么有些数据导入失败了？ A: 常见失败原因：
- 订单标题为空
- 电话号码格式不正确
- 网络连接中断
- 服务器响应超时
Q: 导入失败的数据可以重试吗？ A: 可以。在导入结果页面可以对失败的数据进行重试。
Q: 导入过程中可以关闭页面吗？ A: 不建议。导入过程中关闭页面会中断导入，已导入的数据会保留，未导入的数据需要重新导入。
Q: 导入的工单可以批量删除吗？ A: 可以。在工单列表页面可以批量选择并删除工单。
数据验证
Q: 电话号码格式有什么要求？ A: 必须是11位数字，以1开头的有效手机号。固定电话暂不支持。
Q: 地址长度有限制吗？ A: 建议地址长度不超过200个字符，过长的地址可能会被截断。
Q: 订单描述可以包含换行符吗？ A: 可以。Excel单元格中的换行符会被保留。
Q: 特殊字符会影响导入吗？ A: 一般特殊字符不会影响导入，但建议避免使用控制字符和特殊符号。
性能优化
Q: 为什么导入速度很慢？ A: 可能原因：
- 网络连接不稳定
- 服务器负载较高
- 导入数据量较大
- 每条数据间有200ms的延迟（避免请求过于频繁）
Q: 可以同时导入多个Excel文件吗？ A: 不可以。系统一次只能处理一个Excel文件，需要等待当前导入完成后再导入下一个。
Q: 导入30条数据大概需要多长时间？ A: 正常情况下需要1-2分钟，具体时间取决于网络状况和服务器响应速度。
Q: 可以加快导入速度吗？ A: 系统已做优化，每条数据间有200ms延迟是为了避免请求过于频繁。建议在网络状况良好时进行导入。
结果处理
Q: 导入结果可以导出吗？ A: 可以。在导入结果页面支持导出导入结果为Excel文件。
Q: 导入成功的工单在哪里查看？ A: 在工单列表页面可以查看所有导入的工单，也可以通过导入结果中的"查看工单"按钮直接跳转。
Q: 导入失败的数据会保存吗？ A: 不会。导入失败的数据不会创建工单，可以在导入结果中查看失败原因。
Q: 可以查看历史导入记录吗？ A: 目前不支持查看历史导入记录，建议导出导入结果保存备份。
权限和安全
Q: 谁可以使用Excel导入功能？ A: 具有工单创建权限的用户都可以使用Excel导入功能。
Q: 导入的数据安全吗？ A: 是的。Excel文件在前端解析，数据通过HTTPS加密传输，确保数据安全。
Q: Excel文件会上传到服务器吗？ A: 不会。Excel文件仅在浏览器本地解析，不会上传到服务器，保护数据隐私。
Q: 导入的工单谁可以查看？ A: 根据工单权限设置，创建人、管理员和相关员工可以查看导入的工单。
通过合理使用Excel工单导入功能，可以大大提高工单创建效率，减少手工录入错误，支持批量业务处理。