ai-business-write/README_模板字段导出说明.md

69 lines
2.5 KiB
Markdown
Raw Permalink 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.

# 模板字段导出说明
## 功能说明
`export_template_fields_to_excel.py` 脚本用于导出所有模板及其关联的输入字段和输出字段到Excel表格方便汇总整理模板和字段关系。
## 使用方法
```bash
python export_template_fields_to_excel.py
```
## 输出文件
脚本会在当前目录生成Excel文件文件名格式`template_fields_export_YYYYMMDD_HHMMSS.xlsx`
## Excel表格结构
生成的Excel表格包含以下列
1. **模板ID** - 模板在数据库中的唯一标识
2. **模板名称** - 模板的中文名称
3. **模板上级** - 模板的分类路径(从文件路径或模板名称推断,可能不完整,需要手动补充)
4. **输入字段** - 该模板关联的输入字段列表,格式:`字段名称(字段编码); 字段名称(字段编码)`
5. **输出字段** - 该模板关联的输出字段列表,格式:`字段名称(字段编码); 字段名称(字段编码)`
6. **输入字段数量** - 输入字段的个数
7. **输出字段数量** - 输出字段的个数
## 注意事项
1. **模板上级字段**脚本会尝试从文件路径或模板名称推断模板的分类但可能不完整或不准确。您可以在Excel中手动补充或修正。
2. **字段格式**:输入字段和输出字段以分号分隔,每个字段的格式为 `字段名称(字段编码)`
3. **数据来源**所有数据来自数据库只导出状态为启用state=1的模板和字段。
4. **后续使用**您可以基于这个Excel表格
- 手动补充或修正模板上级分类
- 新增模板和字段关系
- 创建导入脚本将修改后的数据导入数据库
## 示例数据
```
模板ID: 1765432134276990
模板名称: 1.请示报告卡(初核谈话)
模板上级: 2-初核模版/2.谈话审批
输入字段: 线索信息(clue_info); 被核查人员工作基本情况线索(target_basic_info_clue)
输出字段: 被核查人姓名(target_name); 被核查人员单位及职务(target_organization_and_position); ...
输入字段数量: 2
输出字段数量: 3
```
## 导入脚本开发建议
后续开发导入脚本时,可以参考以下步骤:
1. 读取Excel文件
2. 解析模板名称、模板上级、输入字段、输出字段
3. 根据模板名称查找或创建模板记录
4. 根据字段编码查找字段ID
5. 创建或更新模板和字段的关联关系
## 相关文件
- `export_template_fields_to_excel.py` - 导出脚本
- `template_fields_export_*.xlsx` - 生成的Excel文件