diff --git a/doc/api/ccdi_purchase_transaction_api.md b/doc/api/ccdi_purchase_transaction_api.md index 93c6498..0f8d077 100644 --- a/doc/api/ccdi_purchase_transaction_api.md +++ b/doc/api/ccdi_purchase_transaction_api.md @@ -739,11 +739,49 @@ source sql/ccdi_purchase_transaction_menu.sql; --- +## 导入功能交互说明 + +### 前端交互流程 + +1. **上传文件** + - 用户点击"导入"按钮 + - 选择Excel文件 + - 点击"确定"上传 + - **导入对话框立即关闭** + +2. **后台处理** + - 右上角显示通知:"导入任务已提交,正在后台处理中,处理完成后将通知您" + - 系统每2秒轮询一次导入状态 + +3. **导入完成** + - 全部成功:显示绿色通知"导入完成!全部成功!共导入N条数据" + - 部分失败:显示橙色通知"导入完成!成功N条,失败M条" + - 如果有失败记录,操作栏显示"查看导入失败记录"按钮 + +4. **查看失败记录** + - 点击"查看导入失败记录"按钮 + - 打开对话框显示分页的失败记录 + - 包含字段:采购事项ID、项目名称、标的物名称、失败原因 + - 支持清除历史记录 + +### 状态持久化 + +- 导入状态保存在localStorage中 +- 刷新页面后仍可查看上次导入结果 +- 状态保留7天,过期自动清除 + +### 与员工信息导入的对比 + +采购交易导入完全复用了员工信息导入的逻辑,两者的交互方式完全一致。 + +--- + ## 版本历史 | 版本 | 日期 | 说明 | 作者 | |------|------|------|------| | 1.0.0 | 2026-02-06 | 初始版本,采购交易信息管理接口 | ruoyi | +| 1.1.0 | 2026-02-08 | 添加导入功能交互说明 | ruoyi | ---