table-replacer/README.md
yuuko 88d9df8961 feat: 添加Excel表头转换工具及相关文档
- 新增Excel表头转换工具的可执行文件
- 添加打包说明文档,包含一键打包和手动打包方法
- 添加README文档说明工具功能和使用方法
- 包含转换规则、安装要求和使用注意事项
- 添加requirements.txt指定依赖版本
- 包含build.spec打包配置文件
2025-09-28 15:57:01 +08:00

94 lines
2.5 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# Excel表头转换工具
这是一个用于批量转换Excel文件表头的图形界面工具可以根据预定义的规则将老系统的表头转换为新系统的表头格式。
## 功能特点
- 图形化用户界面,操作简单
- 批量处理指定目录下的所有Excel文件
- 保持原有目录结构输出
- 详细的转换日志记录
- 错误处理和进度显示
## 转换规则
### 1. 表头重命名A转B
- 件号 → 部门件号
- 题名 → 文件题名
- 责任者 → 责任者
- 文件编号 → 文号
- 形成日期 → 文件形成日期
- 页数 → 页数
- 关键词 → 关键词
- 内容描述 → 内容描述
- 附注 → 附注
- 档号 → 档号
### 2. 删除列
以下列将被删除:
- 表格名称
- 性别
- 出生年月
- 文件名称
- 图片文件名
- PDF名称
### 3. 新增空值列
以下列将被添加并填入空值:
- 流水号、附件数量、张页号、顺序号、涉及人名、所属卷宗
- 保管期限、密级、年度、案卷分类、移交部门、存址号
- 部门归档时间、相关案卷、所属项目、单位名称、状态、备注
- 类型、文件类型、次要责任者、文种、物理存址号、主送者
- 附件名称、交替题名、组卷字段、全宗号、案卷号
### 4. 固定值列
以下列将被添加并填入固定值:
- 著录人zhongyuan
- 档案状态:已入库
- 语种:中文
- 载体类型:纸质
## 安装要求
确保已安装Python 3.6+,然后安装依赖包:
```bash
pip install -r requirements.txt
```
## 使用方法
1. 运行程序:
```bash
python excel_converter.py
```
2. 在图形界面中:
- 选择输入路径包含要转换的Excel文件的根目录
- 选择输出路径(转换后文件的保存位置)
- 点击"开始转换"按钮
3. 程序将:
- 递归扫描输入路径下的所有子文件夹
- 找到所有.xlsx文件
- 按照转换规则处理每个文件
- 保持原有目录结构输出到指定位置
- 显示转换进度和详细日志
## 注意事项
- 程序只处理.xlsx格式的文件
- 假设每个Excel文件只有一个工作表
- 第一行为表头,数据从第二行开始
- 转换过程中会生成详细的日志文件
- 如果遇到错误,会在界面和日志中显示详细信息
## 日志文件
程序运行时会自动生成日志文件,文件名格式为:`conversion_log_YYYYMMDD_HHMMSS.log`
日志包含:
- 转换开始和结束时间
- 处理的文件列表
- 转换成功和失败的统计
- 详细的错误信息(如果有)