# 模板字段导出说明

## 功能说明

`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文件