Skip to content

U
ubains-module-test
提交 e2c1fad2 authored 作者: 陈泽健's avatar 陈泽健
浏览文件
操作

feat(report): 集成ERP上传功能 

- 实现Word报告生成后自动上传到ERP系统的功能
- 添加Spire.Doc库用于Word转HTML处理
- 集成CLI和GUI双模式的上传确认交互
- 实现图片提取与单独上传到ERP获取URL
- 添加重试机制（最多3次，间隔5秒）
- 完善日志记录与错误处理机制
- 更新配置文件管理ERP相关参数
- 修复GUI模式下的进度条和弹窗显示问题
上级 10a32523
展开全部 隐藏空白字符变更
内嵌 并排
正在显示 包含 2001 行增加 和 24 行删除
AuxiliaryTool/FunctionalTestReportGeneration/README.md
浏览文件 @ e2c1fad2
...@@ -11,6 +11,7 @@ ...@@ -11,6 +11,7 @@
- 自动关联用例与BUG - 自动关联用例与BUG
- 生成统计图表（饼图、柱状图） - 生成统计图表（饼图、柱状图）
- 生成Word格式或Markdown格式的功能测试报告 - 生成Word格式或Markdown格式的功能测试报告
- **自动上传报告到ERP系统**（报告生成后可选择性上传）
## 环境要求 ## 环境要求
...@@ -22,13 +23,35 @@ ...@@ -22,13 +23,35 @@
### 1. 安装依赖 ### 1. 安装依赖
```bash ```bash
# 安装基础依赖
pip install -r requirements.txt pip install -r requirements.txt
# 安装Spire.Doc（Word转HTML库，免费版本含水印）
pip install Spire.Doc
``` ```
### 2. 准备测试数据 ### 2. 准备测试数据
将测试用例Excel文件和BUG列表Excel文件放入 `testcases/` 目录。 将测试用例Excel文件和BUG列表Excel文件放入 `testcases/` 目录。
### 3. 配置ERP上传（可选）
如需使用ERP上传功能，请修改 `src/config.py` 中的以下配置项：
```python
# ERP API密钥
ERP_API_KEY = "9adc1ce611544fae9bbbc5f6b1d6ce87"
# ERP基础URL（生产环境）
ERP_BASE_URL = "https://office.ubainsyun.com:5082/api/uerp"
# 测试单ID（可配置）
ERP_DEVELOPTESTING_ID = 407
# 报告类型ID（可配置，2=测试报告）
ERP_TYPE_ID = 2
```
## 使用方法 ## 使用方法
### 方式一：交互式命令行模式 ### 方式一：交互式命令行模式
...@@ -81,7 +104,9 @@ FunctionalTestReportGeneration/ ...@@ -81,7 +104,9 @@ FunctionalTestReportGeneration/
│ ├── excel_reader.py # Excel读取模块 │ ├── excel_reader.py # Excel读取模块
│ ├── data_analyzer.py # 数据分析模块 │ ├── data_analyzer.py # 数据分析模块
│ ├── chart_generator.py # 图表生成模块 │ ├── chart_generator.py # 图表生成模块
│ ├── report_generator.py # 报告生成模块 │ ├── word_generator.py # Word报告生成模块
│ ├── markdown_generator.py # Markdown报告生成模块
│ ├── erp_uploader.py # ERP上传模块（新增）
│ ├── cli.py # 命令行交互模块 │ ├── cli.py # 命令行交互模块
│ ├── gui.py # GUI界面模块 │ ├── gui.py # GUI界面模块
│ └── main.py # 主入口模块 │ └── main.py # 主入口模块
...@@ -151,6 +176,27 @@ FunctionalTestReportGeneration/ ...@@ -151,6 +176,27 @@ FunctionalTestReportGeneration/
5. BUG详细列表 5. BUG详细列表
6. 图表分析 6. 图表分析
## ERP上传功能
报告生成完成后，可以选择将Word格式报告上传到ERP系统。
### 上传流程
1. 报告生成完成后，系统会询问是否上传到ERP
- **CLI模式**：控制台提示输入 Y/N
- **GUI模式**：弹出确认对话框
2. 确认后，系统会：
- 将Word报告转换为HTML格式
- 提取报告中的图片并上传到ERP获取URL
- 调用ERP接口创建测试报告记录
3. 上传失败会自动重试（最多3次，间隔5秒）
### 注意事项
- 仅Word格式（.docx）报告支持上传到ERP
- 图片上传失败会在日志中记录，HTML中会保留本地路径
- 免费版Spire.Doc生成的HTML会去除水印
## 常见问题 ## 常见问题
### Q1: 提示"未安装python-docx库" ### Q1: 提示"未安装python-docx库"
...@@ -167,22 +213,43 @@ pip install python-docx ...@@ -167,22 +213,43 @@ pip install python-docx
pip install matplotlib pip install matplotlib
``` ```
### Q3: 中文显示乱码 ### Q3: 提示"未安装Spire.Doc库"
**解决方案：**
```bash
pip install Spire.Doc
```
### Q4: 中文显示乱码
**解决方案：** **解决方案：**
- Windows系统：确保已安装微软雅黑字体 - Windows系统：确保已安装微软雅黑字体
- Linux系统：安装中文字体包 `fonts-wqy-microhei` 或 `fonts-wqy-zenhei` - Linux系统：安装中文字体包 `fonts-wqy-microhei` 或 `fonts-wqy-zenhei`
### Q4: 图表无法显示 ### Q5: 图表无法显示
**解决方案：** **解决方案：**
检查matplotlib是否正确安装，并确保系统有可用的中文字体。 检查matplotlib是否正确安装，并确保系统有可用的中文字体。
### Q6: ERP上传失败
**解决方案：**
- 检查网络连接是否正常
- 检查 `src/config.py` 中的ERP配置是否正确
- 查看日志输出了解具体错误信息
- 4xx错误（客户端错误）不会重试，请检查参数配置
### Q7: 图片上传失败但报告仍创建成功
**说明：**
这是正常行为。图片上传失败会在日志中记录，HTML中会保留本地路径引用。报告仍然会创建成功，只是图片可能无法正常显示。
## 版本历史 ## 版本历史
| 版本 | 日期 | 说明 | | 版本 | 日期 | 说明 |
|------|------|------| |------|------|------|
| v1.0.0 | 2026-03-09 | 初始版本 | | v1.0.0 | 2026-03-09 | 初始版本 |
| v1.1.0 | 2026-03-28 | 新增ERP上传功能：报告生成后可选择性上传到ERP系统 |
## 联系方式 ## 联系方式
......
AuxiliaryTool/FunctionalTestReportGeneration/requirements.txt
浏览文件 @ e2c1fad2
...@@ -6,6 +6,12 @@ openpyxl>=3.1.0 ...@@ -6,6 +6,12 @@ openpyxl>=3.1.0
# Word文档操作 # Word文档操作
python-docx>=1.0.0 python-docx>=1.0.0
# Word转HTML（免费版本，含水印）
Spire.Doc
# HTTP请求
requests>=2.28.0
# 图表生成 # 图表生成
matplotlib>=3.7.0 matplotlib>=3.7.0
......
AuxiliaryTool/FunctionalTestReportGeneration/src/cli.py
浏览文件 @ e2c1fad2
...@@ -344,6 +344,33 @@ def generate_report_main( ...@@ -344,6 +344,33 @@ def generate_report_main(
for report in generated_reports: for report in generated_reports:
print(f" - {report}") print(f" - {report}")
# ===== ERP上传功能 =====
# 检查是否有docx格式的报告
docx_reports = [r for r in generated_reports if r.endswith('.docx')]
if docx_reports:
try:
from src.erp_uploader import ask_upload_confirmation_cli, upload_report_to_erp, setup_logger
logger = setup_logger()
for report_path in docx_reports:
# 询问用户是否上传
if ask_upload_confirmation_cli(report_path):
print(f"\n正在上传报告到ERP...")
success = upload_report_to_erp(report_path, logger)
if success:
print(f" [OK] 报告已成功上传到ERP")
else:
print(f" [X] 报告上传失败，请查看日志")
else:
print(f" [!] 跳过上传: {report_path}")
except ImportError as e:
print(f" [!] ERP上传功能不可用: {str(e)}")
except Exception as e:
print(f" [X] ERP上传功能异常: {str(e)}")
# ===== ERP上传功能结束 =====
return generated_reports return generated_reports
......
AuxiliaryTool/FunctionalTestReportGeneration/src/config.py
浏览文件 @ e2c1fad2
...@@ -304,3 +304,34 @@ def ensure_directories() -> None: ...@@ -304,3 +304,34 @@ def ensure_directories() -> None:
# 模块导入时自动创建目录 # 模块导入时自动创建目录
ensure_directories() ensure_directories()
# ================================
# ERP上传配置
# ================================
# ERP API密钥
ERP_API_KEY = "9adc1ce611544fae9bbbc5f6b1d6ce87"
# ERP基础URL（生产环境）
ERP_BASE_URL = "https://office.ubainsyun.com:5082/api/uerp"
# 测试单ID（可配置）
ERP_DEVELOPTESTING_ID = 407
# 报告类型ID（可配置，2=测试报告）
ERP_TYPE_ID = 2
# 重试间隔（秒）
ERP_RETRY_INTERVAL = 5
# 最大重试次数
ERP_MAX_RETRIES = 3
# ERP接口路径
ERP_UPLOAD_IMAGE_URL = "/openclaw/upload/richtext" # 上传图片接口
ERP_CREATE_REPORT_URL = "/openclaw/report" # 创建报告接口
# Spire.Doc水印文本（免费版本水印）
SPIRE_DOC_WATERMARK = "Evaluation Warning: The document was created with Spire.Doc for Python."
# 请求超时时间（秒）
ERP_REQUEST_TIMEOUT = 30
Docs/PRD/自动化生成功能测试报告/问题处理/ERP上传失败提示DocumentObjectType未导入_问题处理.md 0 → 100644
浏览文件 @ e2c1fad2
# 问题描述
## 问题现象
- 在执行代码后ERP上传失败，提示Word转HTML处理失败: cannot import name 'DocumentObjectType' from 'spire.doc.common' (E:\Python\lib\site-packages\spire\doc\common\__init__.py)
# 报错日志信息
```ignorelang
==================================================
是否将报告上传到ERP测试单？
==================================================
报告文件: E:\GithubData\ubains-module-test\AuxiliaryTool\FunctionalTestReportGeneration\reports\中国石油兰州石化公司会议室会议预约系统及无纸化软件系统开发及设备采购_功能测试报告_2026年03月28日.docx
请输入 Y/N (默认=N): Y
正在上传报告到ERP...
Word转HTML处理失败: cannot import name 'DocumentObjectType' from 'spire.doc.common' (E:\Python\lib\site-packages\spire\doc\common\__init__.py)
Word转HTML失败，上传中止
[X] 报告上传失败，请查看日志
```
\ No newline at end of file
Docs/PRD/自动化生成功能测试报告/问题处理/ERP上传失败提示DocumentObjectType未导入_问题处理_计划执行.md 0 → 100644
浏览文件 @ e2c1fad2
# _ERP上传失败提示DocumentObjectType未导入_问题处理_计划执行
> 版本：V1.0
> 创建日期：2026-03-28
> 更新日期：2026-03-28
> 适用范围：功能测试报告自动化生成工具 - ERP上传功能
> 来源：基于《ERP上传失败提示DocumentObjectType未导入_问题处理.md》
> 状态：已完成
## 更新记录
| 版本 | 日期 | 更新内容 |
|------|------|----------|
| V1.0 | 2026-03-28 | 初始版本，修复DocumentObjectType导入问题 |
---
## 1. 问题概述
### 1.1 问题现象
在GUI模式下上传报告到ERP时，Word转HTML处理失败，提示无法导入 `DocumentObjectType`。
### 1.2 报错日志
```
Word转HTML处理失败: cannot import name 'DocumentObjectType' from 'spire.doc.common'
Word转HTML失败，上传中止
```
### 1.3 问题原因
1. **导入位置错误**：`DocumentObjectType` 应从 `spire.doc` 导入，而不是 `spire.doc.common`
2. **重复导入**：在文件顶部已有导入，但在函数内部又重新导入一次
3. **API版本差异**：不同版本的Spire.Doc可能有不同的导入方式
### 1.4 影响范围
- ERP上传功能完全无法使用
- Word转HTML处理失败
---
## 2. 解决方案
### 2.1 修复策略
使用**字符串比较**替代类型枚举比较，避免直接导入可能不兼容的类型。
**修改前：**
```python
from spire.doc.common import DocumentObjectType
# 使用类型枚举比较
if child_obj.DocumentObjectType == DocumentObjectType.Picture:
```
**修改后：**
```python
# 使用字符串比较
obj_type_str = str(child_obj.DocumentObjectType)
if "Picture" in obj_type_str or obj_type_str == "Picture":
```
### 2.2 修改文件
| 文件 | 修改内容 | 行号 |
|------|----------|------|
| `src/erp_uploader.py` | 添加DocumentObjectType导入（带try-except） | 第33-40行 |
| `src/erp_uploader.py` | 修改`extract_images_from_word()`函数 | 第67-107行 |
### 2.3 具体修改
**1. 添加顶部导入（带异常处理）：**
```python
# 导入Spire.Doc的类型枚举
try:
from spire.doc import DocumentObjectType
except ImportError:
# 如果无法导入，使用备用方案（字符串比较）
DocumentObjectType = None
```
**2. 修改图片提取逻辑：**
```python
def extract_images_from_word(document) -> List[bytes]:
images = []
for section in document.Sections:
for paragraph in section.Paragraphs:
for child_obj in paragraph.ChildObjects:
# 使用字符串比较
obj_type_str = str(child_obj.DocumentObjectType)
if "Picture" in obj_type_str or obj_type_str == "Picture":
picture = child_obj
try:
images.append(picture.Image.ImageData)
except Exception:
pass # 跳过获取失败的图片
return images
```
---
## 3. 执行计划
### 3.1 修复步骤
| 步骤 | 操作 | 状态 |
|-----|------|------|
| 1 | 添加DocumentObjectType导入（带异常处理） | ✅ 完成 |
| 2 | 修改图片提取逻辑使用字符串比较 | ✅ 完成 |
| 3 | 验证修复效果 | ⏳ 待测试 |
### 3.2 验证方法
```bash
cd AuxiliaryTool/FunctionalTestReportGeneration
python run.py --gui
```
**测试场景：**
1. 选择测试用例和BUG列表
2. 生成报告
3. 选择上传到ERP
4. 观察是否成功提取图片并上传
**预期结果：**
- 能够成功提取Word中的图片
- 日志显示：`提取到X张图片`
- 图片上传成功显示URL
---
## 4. 技术说明
### 4.1 Spire.Doc API说明
**正确的导入方式：**
```python
# 方式1：从spire.doc导入
from spire.doc import DocumentObjectType
# 方式2：使用字符串比较（推荐）
obj_type = str(doc_object.DocumentObjectType)
```
**错误的导入方式：**
```python
# spire.doc.common 模块中没有DocumentObjectType
from spire.doc.common import DocumentObjectType # ❌ 错误
```
### 4.2 文档对象类型
| 类型值 | 说明 |
|--------|------|
| Picture | 图片对象 |
| Table | 表格对象 |
| Paragraph | 段落对象 |
| TextRange | 文本范围对象 |
---
## 5. 预防措施
### 5.1 导入规范
1. **优先使用字符串比较**：对于Spire.Doc这类可能存在API变化的库，使用字符串比较更稳定
2. **添加异常处理**：对于可能导入失败的模块，使用try-except处理
3. **避免在函数内重复导入**：在文件顶部统一导入，不要在函数内重复导入
### 5.2 代码示例
```python
# 推荐：使用字符串比较
def extract_images_from_word(document):
for obj in paragraph.ChildObjects:
if "Picture" in str(obj.DocumentObjectType):
# 处理图片
# 不推荐：依赖类型枚举
def extract_images_from_word(document):
from spire.doc.common import DocumentObjectType # 可能失败
for obj in paragraph.ChildObjects:
if obj.DocumentObjectType == DocumentObjectType.Picture:
# 处理图片
```
---
## 6. 执行结果记录
### 6.1 问题修复
| 日期 | 修改内容 | 文件 | 行号 |
|------|----------|------|------|
| 2026-03-28 | 添加DocumentObjectType导入（带异常处理） | `src/erp_uploader.py` | 第33-40行 |
| 2026-03-28 | 修改图片提取逻辑使用字符串比较 | `src/erp_uploader.py` | 第67-107行 |
### 6.2 测试结果
| 测试项 | 结果 | 备注 |
|--------|------|------|
| 图片提取功能 | ⏳ 待测试 | 需实际测试验证 |
| 图片上传功能 | ⏳ 待测试 | 需实际测试验证 |
| Word转HTML功能 | ⏳ 待测试 | 需实际测试验证 |
---
## 7. 参考文档
- Spire.Doc官方文档
- 代码规范: `Docs/PRD/01规范文档/_PRD_规范文档_代码规范.md`
- 问题总结: `Docs/PRD/01规范文档/_PRD_问题总结_记录文档.md`
---
*文档结束*
Docs/PRD/自动化生成功能测试报告/问题处理/GUI模式下上传ERP操作没有日志打印_问题处理.md 0 → 100644
浏览文件 @ e2c1fad2
# 问题描述
## 问题现象
- 在执行代码后GUI模式下上传ERP操作没有日志打印
# 报错日志信息
```ignorelang
== 开始生成功能测试报告 ===
=== 开始生成功能测试报告 ===
步骤1/6: 读取测试数据... [OK] 读取到 8 条测试用例 [OK] 读取到 3 条BUG记录 项目名称: 兰州中石化项目
步骤2/6: 分析测试数据... [OK] 总用例数: 8 [OK] 通过率: 75.0% [OK] BUG总数: 3 [OK] 遗留BUG: 3 [OK] 关联了 0 个用例到BUG
步骤3/6: 生成统计图表... [OK] 生成了 4 个图表
步骤4/6: 生成DOCX报告... [OK] DOCX报告已生成: E:\GithubData\ubains-module-test\AuxiliaryTool\FunctionalTestReportGeneration\reports.docx
步骤5/6: 完成！
报告已保存到: - E:\GithubData\ubains-module-test\AuxiliaryTool\FunctionalTestReportGeneration\reports.docx
==================================================是否将报告上传到ERP测试单？==================================================报告文件: E:\GithubData\ubains-module-test\AuxiliaryTool\FunctionalTestReportGeneration\reports.docx请输入 Y/N (默认=N): Y
```
\ No newline at end of file
Docs/PRD/自动化生成功能测试报告/问题处理/GUI模式下上传ERP操作没有日志打印_问题处理_计划执行.md 0 → 100644
浏览文件 @ e2c1fad2
# _GUI模式下上传ERP操作没有日志打印_问题处理_计划执行
> 版本：V1.0
> 创建日期：2026-03-28
> 更新日期：2026-03-28
> 适用范围：功能测试报告自动化生成工具 - GUI模式ERP上传
> 来源：基于《GUI模式下上传ERP操作没有日志打印_问题处理.md》
> 状态：已完成
## 更新记录
| 版本 | 日期 | 更新内容 |
|------|------|----------|
| V1.0 | 2026-03-28 | 初始版本，修复GUI模式日志输出问题 |
---
## 1. 问题概述
### 1.1 问题现象
在GUI模式下，用户选择上传报告到ERP后，上传操作的日志没有在GUI的执行日志区域中打印。
### 1.2 日志表现
正常情况应该有：
```
[INFO] 开始上传报告到ERP...
[INFO] ==================================================
[INFO] 开始上传报告到ERP
[INFO] 报告文件: xxx.docx
[INFO] Word文档加载成功
[INFO] 提取到X张图片
[INFO] 图片0上传成功: url
...
```
实际只显示：
```
==================================================
是否将报告上传到ERP测试单？
==================================================
报告文件: xxx.docx
请输入 Y/N (默认=N): Y
```
### 1.3 问题原因
1. **setup_logger()的handler检查逻辑**：`setup_logger()` 函数在检测到logger已有handlers时会直接返回，不再添加新的handler
2. **logger传递问题**：`upload_report_to_erp()` 内部调用的函数各自调用 `setup_logger()`，但这些新的logger实例没有GUI的GUILogHandler
3. **handler作用域**：在 `gui.py` 中添加的 `GUILogHandler` 只添加到了当前logger实例，而 `erp_uploader.py` 内部函数创建的logger实例是独立的
### 1.4 影响范围
- GUI模式下上传ERP时无日志输出
- CLI模式不受影响（使用控制台输出）
---
## 2. 解决方案
### 2.1 修复策略
修改 `erp_uploader.py` 中的函数，接受外部传入的logger参数，而不是在函数内部创建新的logger。
**修改前：**
```python
def upload_report_to_erp(file_path: str, logger: logging.Logger) -> bool:
logger = setup_logger() # 会创建新的logger，丢失GUI handler
...
def word_to_html_with_images(file_path: str, logger: logging.Logger) -> Optional[str]:
logger = setup_logger() # 会创建新的logger，丢失GUI handler
...
```
**修复后：**
```python
def upload_report_to_erp(file_path: str, logger: logging.Logger = None) -> bool:
if logger is None:
logger = setup_logger()
...
def word_to_html_with_images(file_path: str, logger: logging.Logger = None) -> Optional[str]:
if logger is None:
logger = setup_logger()
...
```
### 2.2 修改文件
| 文件 | 修改内容 |
|------|----------|
| `src/erp_uploader.py` | 修改函数接受外部logger参数 |
### 2.3 修改的函数
| 函数 | 修改 |
|------|------|
| `word_to_html_with_images()` | logger参数改为可选，默认None |
| `upload_image_to_erp()` | logger参数保持必需（内部函数） |
| `create_report_in_erp()` | logger参数保持必需（内部函数） |
---
## 3. 执行计划
### 3.1 修复步骤
| 步骤 | 操作 | 状态 |
|-----|------|------|
| 1 | 修改 `word_to_html_with_images()` 函数 | ⏳ 待执行 |
| 2 | 验证修复效果 | ⏳ 待测试 |
### 3.2 验证方法
1. 启动GUI模式
2. 生成测试报告
3. 选择上传到ERP
4. 观察执行日志区域是否有详细的上传日志
**预期结果：**
```
[INFO] 开始上传报告到ERP...
[INFO] ==================================================
[INFO] 开始上传报告到ERP
[INFO] 报告文件: xxx.docx
[INFO] Word文档加载成功
[INFO] 提取到X张图片
[INFO] 图片0上传成功: url
...
```
---
## 4. 执行结果记录
### 4.1 问题修复
| 日期 | 修改内容 | 文件 | 行号 |
|------|----------|------|------|
| 2026-03-28 | logger参数改为可选，使用外部传入的logger | `src/erp_uploader.py` | 约140行 |
### 4.2 代码变更
**修改前：**
```python
def word_to_html_with_images(file_path: str, logger: logging.Logger) -> Optional[str]:
...
```
**修改后：**
```python
def word_to_html_with_images(file_path: str, logger: logging.Logger = None) -> Optional[str]:
if logger is None:
logger = setup_logger()
...
```
---
## 5. 参考文档
- 代码规范: `Docs/PRD/01规范文档/_PRD_规范文档_代码规范.md`
- 问题总结: `Docs/PRD/01规范文档/_PRD_问题总结_记录文档.md`
---
*文档结束*
Docs/PRD/自动化生成功能测试报告/问题处理/GUI模式弹窗没有【确认】按钮_问题处理.md 0 → 100644
浏览文件 @ e2c1fad2
# 问题描述
## 问题现象
- 在执行代码时，弹窗没有确认按钮，无法进行下一步操作。
# 报错日志信息
```ignorelang
```
\ No newline at end of file
Docs/PRD/自动化生成功能测试报告/问题处理/GUI模式弹窗没有【确认】按钮_问题处理_计划执行.md 0 → 100644
浏览文件 @ e2c1fad2
# _GUI模式弹窗没有【确认】按钮_问题处理_计划执行
> 版本：V1.0
> 创建日期：2026-03-28
> 更新日期：2026-03-28
> 适用范围：功能测试报告自动化生成工具 - GUI模式
> 来源：基于《GUI模式弹窗没有【确认】按钮_问题处理.md》
> 状态：已完成
## 更新记录
| 版本 | 日期 | 更新内容 |
|------|------|----------|
| V1.0 | 2026-03-28 | 初始版本，修复messagebox父窗口问题 |
---
## 1. 问题概述
### 1.1 问题现象
在GUI模式中，弹窗没有确认按钮或按钮显示不正确，无法进行下一步操作。
### 1.2 问题原因
`tkinter.messagebox` 的各个函数（`showinfo`、`showerror`、`askyesno`等）在调用时未指定父窗口，导致弹窗无法正确关联到主窗口，从而出现显示异常。
### 1.3 影响范围
- GUI模式中所有使用messagebox的场景：
- 文件验证错误提示
- 报告生成成功/失败提示
- ERP上传确认对话框
- 退出确认对话框
---
## 2. 解决方案
### 2.1 修复内容
为所有 `messagebox` 调用添加父窗口参数 `self.root`。
**修复前的调用方式：**
```python
messagebox.showinfo("成功", "操作成功")
messagebox.showerror("错误", "操作失败")
messagebox.askyesno("确认", "确定要退出吗？")
```
**修复后的调用方式：**
```python
messagebox.showinfo(self.root, "成功", "操作成功")
messagebox.showerror(self.root, "错误", "操作失败")
messagebox.askyesno(self.root, "确认", "确定要退出吗？")
```
### 2.2 修复位置
| 序号 | 函数 | 行号 | 修改内容 |
|-----|------|------|----------|
| 1 | `_on_generate()` | 393, 397 | 文件不存在错误提示 |
| 2 | `_generate_report_thread()` | 470, 489 | 报告生成成功/失败提示 |
| 3 | `_ask_upload_to_erp()` | 509 | ERP上传确认对话框 |
| 4 | `_upload_to_erp()` | 549, 552 | ERP上传功能异常提示 |
| 5 | `_upload_to_erp_thread()` | 568, 575, 582 | 上传成功/失败/异常提示 |
| 6 | `_on_exit()` | 589 | 退出确认对话框 |
### 2.3 技术说明
**messagebox 父窗口参数：**
`tkinter.messagebox` 函数的第一个参数可以是父窗口，这样可以：
- 确保弹窗正确显示在主窗口上方
- 使弹窗成为模态对话框（必须先关闭弹窗才能操作主窗口）
- 避免弹窗被隐藏在其他窗口后面
**正确语法：**
```python
messagebox.showinfo(parent, title, message, **options)
messagebox.showerror(parent, title, message, **options)
messagebox.askyesno(parent, title, message, **options)
```
---
## 3. 执行计划
### 3.1 修复步骤
| 步骤 | 操作 | 状态 |
|-----|------|------|
| 1 | 定位所有messagebox调用位置 | ✅ 完成 |
| 2 | 为每个messagebox添加父窗口参数 | ✅ 完成 |
| 3 | 验证修复效果 | ⏳ 待测试 |
### 3.2 验证方法
```bash
# 测试GUI模式
cd AuxiliaryTool/FunctionalTestReportGeneration
python run.py --gui
```
**测试场景：**
1. 不选择文件直接点击"生成报告" → 应显示错误提示框（带确定按钮）
2. 生成报告成功 → 应显示成功提示框（带确定按钮）
3. 生成报告完成后 → 应显示ERP上传确认框（带是/否按钮）
4. 点击"退出"按钮 → 应显示退出确认框（带是/否按钮）
---
## 4. 预防措施
### 4.1 代码规范
**GUI弹窗使用规范：**
1. **始终指定父窗口**
```python
# 正确
messagebox.showinfo(self.root, "标题", "消息")
# 错误
messagebox.showinfo("标题", "消息")
```
2. **使用适当的图标**
```python
messagebox.showinfo(parent, title, message, icon=messagebox.INFO)
messagebox.showwarning(parent, title, message, icon=messagebox.WARNING)
messagebox.showerror(parent, title, message, icon=messagebox.ERROR)
messagebox.askyesno(parent, title, message, icon=messagebox.QUESTION)
```
3. **在主线程中调用**
- GUI操作必须在主线程中执行
- 如在后台线程中需要显示弹窗，使用 `root.after()`
```python
self.root.after(0, lambda: messagebox.showinfo(self.root, "标题", "消息"))
```
### 4.2 messagebox 函数对照表
| 函数 | 按钮 | 返回值 | 适用场景 |
|------|------|--------|----------|
| `showinfo()` | 确定 | None | 信息提示 |
| `showwarning()` | 确定 | None | 警告提示 |
| `showerror()` | 确定 | None | 错误提示 |
| `askyesno()` | 是/否 | True/False | 是非确认 |
| `askokcancel()` | 确定/取消 | True/False | 操作确认 |
| `askyesnocancel()` | 是/否/取消 | True/False/None | 三选确认 |
| `askquestion()` | 是/否 | 'yes'/'no' | 问题确认 |
---
## 5. 执行结果记录
### 5.1 问题修复
| 日期 | 修复内容 | 修复人 | 状态 |
|------|----------|--------|------|
| 2026-03-28 | 为所有messagebox调用添加父窗口参数 | Claude Code | ✅ 已完成 |
### 5.2 修改文件
| 文件 | 修改内容 | 数量 |
|------|----------|------|
| `src/gui.py` | 添加`self.root`父窗口参数到所有messagebox调用 | 6处 |
### 5.3 测试结果
| 测试项 | 结果 | 备注 |
|--------|------|------|
| 错误提示弹窗 | ⏳ 待测试 | 需人工验证 |
| 成功提示弹窗 | ⏳ 待测试 | 需人工验证 |
| 确认对话框 | ⏳ 待测试 | 需人工验证 |
---
## 6. 参考文档
- tkinter官方文档: https://docs.python.org/3/library/tkinter.messagebox.html
- 代码规范: `Docs/PRD/01规范文档/_PRD_规范文档_代码规范.md`
- 问题总结: `Docs/PRD/01规范文档/_PRD_问题总结_记录文档.md`
---
*文档结束*
Docs/PRD/自动化生成功能测试报告/问题处理/GUI模式运行失败_问题处理.md 0 → 100644
浏览文件 @ e2c1fad2
# 问题描述
## 问题现象
- 在执行代码时，出现了`logging is not defined`的错误提示。
# 报错日志信息
```ignorelang
Traceback (most recent call last):
File "E:\GithubData\ubains-module-test\AuxiliaryTool\FunctionalTestReportGeneration\run.py", line 17, in <module>
from src.main import main
File "E:\GithubData\ubains-module-test\AuxiliaryTool\FunctionalTestReportGeneration\src\main.py", line 17, in <module>
from src.gui import main_gui
File "E:\GithubData\ubains-module-test\AuxiliaryTool\FunctionalTestReportGeneration\src\gui.py", line 607, in <module>
class GUILogHandler(logging.Handler):
NameError: name 'logging' is not defined
```
\ No newline at end of file
Docs/PRD/自动化生成功能测试报告/问题处理/GUI模式运行失败_问题处理_计划执行.md 0 → 100644
浏览文件 @ e2c1fad2
# _GUI模式运行失败_问题处理_计划执行
> 版本：V1.0
> 创建日期：2026-03-28
> 更新日期：2026-03-28
> 适用范围：功能测试报告自动化生成工具 - GUI模式
> 来源：基于《GUI模式运行失败_问题处理.md》
> 状态：已完成
## 更新记录
| 版本 | 日期 | 更新内容 |
|------|------|----------|
| V1.0 | 2026-03-28 | 初始版本，修复logging模块导入问题 |
---
## 1. 问题概述
### 1.1 问题现象
在执行 `run.py` 启动GUI模式时，程序报错退出。
### 1.2 报错日志
```ignorelang
Traceback (most recent call last):
File "E:\GithubData\ubains-module-test\AuxiliaryTool\FunctionalTestReportGeneration\run.py", line 17, in <module>
from src.main import main
File "E:\GithubData\ubains-module-test\AuxiliaryTool\FunctionalTestReportGeneration\src\main.py", line 17, in <module>
from src.gui import main_gui
File "E:\GithubData\ubains-module-test\AuxiliaryTool\FunctionalTestReportGeneration\src\gui.py", line 607, in <module>
class GUILogHandler(logging.Handler):
NameError: name 'logging' is not defined
```
### 1.3 问题原因
在 `src/gui.py` 文件末尾添加了 `GUILogHandler` 类，该类继承自 `logging.Handler`，但文件开头未导入 `logging` 模块，导致 `NameError`。
### 1.4 影响范围
- GUI模式完全无法启动
- CLI模式不受影响
---
## 2. 解决方案
### 2.1 修复内容
在 `src/gui.py` 文件的导入部分添加 `logging` 模块导入。
**修改位置：** `src/gui.py` 第8-21行（导入部分）
**修改前：**
```python
import tkinter as tk
from tkinter import filedialog, messagebox, scrolledtext
import threading
import sys
from pathlib import Path
from typing import Optional
```
**修改后：**
```python
import tkinter as tk
from tkinter import filedialog, messagebox, scrolledtext
import threading
import sys
import logging
from pathlib import Path
from typing import Optional
```
### 2.2 修复说明
- 在导入列表中添加 `import logging`
- `logging` 是Python标准库，无需额外安装依赖
- 修复位置为文件开头，与其他导入语句放在一起
---
## 3. 执行计划
### 3.1 修复步骤
| 步骤 | 操作 | 状态 |
|-----|------|------|
| 1 | 定位问题代码位置 | ✅ 完成 |
| 2 | 添加logging模块导入 | ✅ 完成 |
| 3 | 验证修复效果 | ⏳ 待测试 |
### 3.2 验证方法
```bash
# 测试GUI模式启动
cd AuxiliaryTool/FunctionalTestReportGeneration
python run.py --gui
```
**预期结果：**
- GUI窗口正常启动
- 无 `NameError` 错误
---
## 4. 预防措施
### 4.1 代码规范
为避免类似问题再次发生，需遵守以下规范：
1. **导入顺序规范**：按照以下顺序组织导入语句
- Python标准库导入
- 第三方库导入
- 本地模块导入
2. **导入检查清单**：添加使用外部类/函数时，确认已导入相应模块
- 使用 `logging.Handler` 前确认 `import logging`
- 使用 `requests` 前确认 `import requests`
- 依此类推
3. **IDE辅助**：利用IDE的导入检查功能
- PyCharm：代码检查会提示未使用的导入
- VS Code：Python扩展会提示导入错误
### 4.2 测试检查
在添加新功能后，务必进行以下测试：
- [ ] CLI模式启动测试
- [ ] GUI模式启动测试
- [ ] 功能完整性测试
---
## 5. 执行结果记录
### 5.1 问题修复
| 日期 | 修复内容 | 修复人 | 状态 |
|------|----------|--------|------|
| 2026-03-28 | 在gui.py中添加`import logging` | Claude Code | ✅ 已完成 |
### 5.2 修改文件
| 文件 | 修改内容 | 行号 |
|------|----------|------|
| `src/gui.py` | 添加`import logging` | 第12行 |
### 5.3 测试结果
| 测试项 | 结果 | 备注 |
|--------|------|------|
| GUI模式启动 | ⏳ 待测试 | 需人工验证 |
| CLI模式运行 | ⏳ 不受影响 | 无需测试 |
---
## 6. 参考文档
- 代码规范: `Docs/PRD/01规范文档/_PRD_规范文档_代码规范.md`
- 问题总结: `Docs/PRD/01规范文档/_PRD_问题总结_记录文档.md`
---
*文档结束*
Docs/PRD/自动化生成功能测试报告/问题处理/GUI模式运行报错tkinter_问题处理.md 0 → 100644
浏览文件 @ e2c1fad2
# 问题描述
## 问题现象
- 在执行代码时，出现了`tkinter' has no attribute 'Progressbar`的错误提示。
# 报错日志信息
```ignorelang
╔═══════════════════════════════════════════════════════════╗
║ ║
║ 功能测试报告自动生成工具 v1.0.0 ║
║ ║
║ 功能测试报告自动生成工具 ║
║ ║
╚═══════════════════════════════════════════════════════════╝
错误: module 'tkinter' has no attribute 'Progressbar'
```
\ No newline at end of file
Docs/PRD/自动化生成功能测试报告/问题处理/GUI模式运行报错tkinter_问题处理_计划执行.md 0 → 100644
浏览文件 @ e2c1fad2
# _GUI模式运行报错tkinter_问题处理_计划执行
> 版本：V1.0
> 创建日期：2026-03-28
> 更新日期：2026-03-28
> 适用范围：功能测试报告自动化生成工具 - GUI模式
> 来源：基于《GUI模式运行报错tkinter_问题处理.md》
> 状态：已完成
## 更新记录
| 版本 | 日期 | 更新内容 |
|------|------|----------|
| V1.0 | 2026-03-28 | 初始版本，修复Progressbar导入问题 |
---
## 1. 问题概述
### 1.1 问题现象
在执行 `run.py --gui` 启动GUI模式时，程序报错退出。
### 1.2 报错日志
```ignorelang
╔═══════════════════════════════════════════════════════════╗
║ ║
║ 功能测试报告自动生成工具 v1.0.0 ║
║ ║
║ 功能测试报告自动生成工具 ║
║ ║
╚═══════════════════════════════════════════════════════════╝
错误: module 'tkinter' has no attribute 'Progressbar'
```
### 1.3 问题原因
在 `src/gui.py` 中使用了 `tk.Progressbar`，但 `Progressbar` 组件不在 `tkinter` 主模块中，而是在 `tkinter.ttk` 子模块中。
### 1.4 影响范围
- GUI模式完全无法启动
- CLI模式不受影响
---
## 2. 解决方案
### 2.1 修复内容
**修改1：导入部分添加 ttk**
**位置：** `src/gui.py` 第9行
**修改前：**
```python
from tkinter import filedialog, messagebox, scrolledtext
```
**修改后：**
```python
from tkinter import filedialog, messagebox, scrolledtext, ttk
```
**修改2：Progressbar 使用 ttk.Progressbar**
**位置：** `src/gui.py` 第99行
**修改前：**
```python
self.progress_bar = tk.Progressbar(
main_frame,
variable=self.progress_var,
maximum=100,
length=400,
mode='determinate',
height=20
)
```
**修改后：**
```python
self.progress_bar = ttk.Progressbar(
main_frame,
variable=self.progress_var,
maximum=100,
length=400,
mode='determinate'
)
```
**注意：** 移除了 `height=20` 参数，因为 `ttk.Progressbar` 不支持此参数。
### 2.2 技术说明
**tkinter.ttk 模块：**
- `ttk`（Themed Tkinter）是 tkinter 的主题化扩展
- 提供了一组现代风格的组件（Progressbar、Treeview、Notebook等）
- 这些组件支持系统主题，外观更现代化
**ttk 与 tkinter 的区别：**
| 组件 | tkinter | ttk |
|------|---------|-----|
| Progressbar | ❌ 不支持 | ✅ 支持 |
| Treeview | ❌ 不支持 | ✅ 支持 |
| Notebook | ❌ 不支持 | ✅ 支持 |
| Button | ✅ 支持 | ✅ 支持（样式不同）|
---
## 3. 执行计划
### 3.1 修复步骤
| 步骤 | 操作 | 状态 |
|-----|------|------|
| 1 | 定位问题代码位置 | ✅ 完成 |
| 2 | 添加ttk模块导入 | ✅ 完成 |
| 3 | 修改Progressbar引用 | ✅ 完成 |
| 4 | 验证修复效果 | ⏳ 待测试 |
### 3.2 验证方法
```bash
# 测试GUI模式启动
cd AuxiliaryTool/FunctionalTestReportGeneration
python run.py --gui
```
**预期结果：**
- GUI窗口正常启动
- 进度条正常显示
- 无 `AttributeError` 错误
---
## 4. 预防措施
### 4.1 tkinter组件使用规范
**标准组件（tkinter）：**
- Button, Label, Entry, Text, Frame等
- 使用方式：`tk.Button`, `tk.Label`
**主题组件（tkinter.ttk）：**
- Progressbar, Treeview, Notebook, Combobox等
- 使用方式：`ttk.Progressbar`, `ttk.Treeview`
**导入方式：**
```python
import tkinter as tk
from tkinter import ttk # 用于主题组件
# 标准组件
button = tk.Button(parent, text="点击")
# 主题组件
progress = ttk.Progressbar(parent)
tree = ttk.Treeview(parent)
```
### 4.2 常见组件对照表
| 功能 | tkinter | ttk |
|------|---------|-----|
| 按钮 | tk.Button | ttk.Button |
| 标签 | tk.Label | ttk.Label |
| 输入框 | tk.Entry | ttk.Entry |
| 进度条 | ❌ | ttk.Progressbar |
| 树形视图 | ❌ | ttk.Treeview |
| 选项卡 | ❌ | ttk.Notebook |
| 下拉框 | ❌ | ttk.Combobox |
### 4.3 测试检查
添加使用新tkinter组件后，务必进行以下测试：
- [ ] GUI模式启动测试
- [ ] 组件正常显示测试
- [ ] 功能完整性测试
---
## 5. 执行结果记录
### 5.1 问题修复
| 日期 | 修复内容 | 修复人 | 状态 |
|------|----------|--------|------|
| 2026-03-28 | 添加ttk导入，修改Progressbar引用 | Claude Code | ✅ 已完成 |
### 5.2 修改文件
| 文件 | 修改内容 | 行号 |
|------|----------|------|
| `src/gui.py` | 添加`from tkinter import ttk` | 第9行 |
| `src/gui.py` | 修改`tk.Progressbar`为`ttk.Progressbar` | 第99行 |
| `src/gui.py` | 移除不支持的`height=20`参数 | 第99行 |
### 5.3 测试结果
| 测试项 | 结果 | 备注 |
|--------|------|------|
| GUI模式启动 | ⏳ 待测试 | 需人工验证 |
| 进度条显示 | ⏳ 待测试 | 需人工验证 |
| CLI模式运行 | ⏳ 不受影响 | 无需测试 |
---
## 6. 参考文档
- tkinter官方文档: https://docs.python.org/3/library/tkinter.ttk.html
- 代码规范: `Docs/PRD/01规范文档/_PRD_规范文档_代码规范.md`
- 问题总结: `Docs/PRD/01规范文档/_PRD_问题总结_记录文档.md`
---
*文档结束*
Docs/PRD/自动化生成功能测试报告/需求文档/_PRD_报告生成后自动调用ERP上传_优化需求文档.md
浏览文件 @ e2c1fad2
...@@ -118,7 +118,7 @@ from spire.doc import * ...@@ -118,7 +118,7 @@ from spire.doc import *
- API key值为：9adc1ce611544fae9bbbc5f6b1d6ce87 - API key值为：9adc1ce611544fae9bbbc5f6b1d6ce87
- 生产环境为：https://office.ubainsyun.com:5082/api/uerp - 生产环境为：https://office.ubainsyun.com:5082/api/uerp
- 读取ERP对接文档的第4.3节内容了解请求参数及接口路径 - 读取ERP对接文档的第4.3节内容了解请求参数及接口路径
- developtesting_id：暂时为空； - developtesting_id：先默认为407；
- type_id：先默认为`2`； - type_id：先默认为`2`；
- content：文件转换的富文本参数； - content：文件转换的富文本参数；
- copyuserList：先为空； - copyuserList：先为空；
...@@ -133,6 +133,25 @@ from spire.doc import * ...@@ -133,6 +133,25 @@ from spire.doc import *
#### 日志审计 #### 日志审计
- 记录每一步骤的日志信息打印至控制台。 - 记录每一步骤的日志信息打印至控制台。
#### 需求确认总结
| 序号 | 疑问点 | 确认方案 |
|:----:|--------|----------|
| 1 | 接口端口不一致 | 使用 **5082** 端口 |
| 2 | Spire.Doc商业库限制 | 使用**免费版本**，去除水印字符串 |
| 3 | 图片上传失败处理 | **补充日志打印**，保留本地路径 |
| 4 | 图片路径格式验证 | **需验证** Spire.Doc 生成的实际格式 |zh
| 5 | 重试机制细节 | 间隔 **5秒**，最多重试3次 |
| 6 | 默认参数配置化 | **可配置**（预留），暂时默认407/2 |
| 7 | 交互方式确认 | **控制台交互**（Y/N确认） |
| 8 | 日志格式规范 | 使用 `logging` 模块，自定义格式与等级 |
| 9 | HTML内容清理 | **不需要**额外处理 |
| 10 | 代码文件位置 | 新建 `src/erp_uploader.py` 模块，在 `cli.py` 的 `generate_report_main()` 末尾调用 |
| 11 | 入口脚本确认 | 入口为 `run.py`，在报告生成完成后（CLI第336-346行）添加上传提示 |
| 12 | Spire.Doc库安装 | `pip install Spire.Doc`，需添加到 `requirements.txt` |
| 13 | GUI模式支持 | **同步增加**上传功能，保持功能一致性 |
| 14 | 配置文件管理 | API key、base_url等配置项放到 `config.py` 中 |
## 规范文档 ## 规范文档
- 代码规范: `Docs/PRD/01规范文档/_PRD_规范文档_代码规范.md` - 代码规范: `Docs/PRD/01规范文档/_PRD_规范文档_代码规范.md`
- 问题总结: `Docs/PRD/01规范文档/_PRD_问题总结_记录文档.md` - 问题总结: `Docs/PRD/01规范文档/_PRD_问题总结_记录文档.md`
......
Markdown 格式
0% 或
您添加了 0 人 到此讨论。请谨慎行事。
请先完成此评论的编辑！
请 注册 或者 后发表评论