113 lines
3.5 KiB
Markdown
113 lines
3.5 KiB
Markdown
# FieldNameSync — 模块字段配置迁移工具
|
|
|
|
从旧库 `G3HY2025.dbo.s_columnLib` 同步字段配置到新库 `fms`。
|
|
|
|
## 同步的三项内容
|
|
|
|
| 序号 | 旧库来源 | 新库目标 | 说明 |
|
|
| --- | --- | --- | --- |
|
|
| 1 | `col_Caption` | `s_module_field.b_name` | 字段中文名称 |
|
|
| 2 | `col_Visible` | `s_module_field_list.b_visible` | 列表是否显示（1=显示, 0=隐藏） |
|
|
| 3 | `col_edit` | `s_module_field_edit.b_visible` | 编辑表单是否显示（1=显示, 0=隐藏） |
|
|
|
|
## 匹配规则
|
|
|
|
通过视图名和字段名关联新旧库：
|
|
|
|
```
|
|
旧库 s_columnLib.col_TableName = 新库 s_module.b_viewtable
|
|
旧库 s_columnLib.col_FieldName = 新库 s_module_field.b_field
|
|
```
|
|
|
|
- 旧库字段匹配不上的，对应配置**不做修改**（保留原值）
|
|
- 列表配置或编辑配置记录不存在时，**自动插入**新记录
|
|
|
|
## 前置条件
|
|
|
|
### 1. JDK 21
|
|
|
|
工具使用 Java 文本块语法（`"""`），需要 JDK 21+ 编译。
|
|
|
|
### 2. mssql-jdbc 驱动
|
|
|
|
确保本地 Maven 仓库存在驱动 jar：
|
|
```
|
|
%USERPROFILE%\.m2\repository\com\microsoft\sqlserver\mssql-jdbc\13.4.0.jre11\mssql-jdbc-13.4.0.jre11.jar
|
|
```
|
|
|
|
如果不存在，从项目根目录 `fms-api/` 执行 `mvnw dependency:resolve` 下载。
|
|
|
|
### 3. 数据库连接
|
|
|
|
工具硬编码连接 `118.89.70.199:1433`，数据库 `fms`，直连新旧两库（同一实例）。
|
|
|
|
### 4. 新库已有 `s_module_field_edit.b_visible` 列
|
|
|
|
如果报 `Invalid column name 'b_visible'`，执行以下 SQL 添加列：
|
|
```sql
|
|
ALTER TABLE dbo.s_module_field_edit ADD b_visible int NOT NULL DEFAULT 1;
|
|
```
|
|
|
|
### 5. 模块已在 s_module 中注册
|
|
|
|
目标模块的 `b_viewtable` 必须已在 `s_module` 表中配置，且已有 `s_module_field` 记录。
|
|
|
|
## 编译和运行
|
|
|
|
```bash
|
|
# 进入迁移工具目录
|
|
cd fms-api/tools/migration
|
|
|
|
# 设置 JDK 21
|
|
export JAVA_HOME=/path/to/jdk-21 # Linux/Mac
|
|
set JAVA_HOME=D:\devtool\jdk\jdk-21 # Windows
|
|
|
|
# 编译
|
|
javac -cp "%USERPROFILE%\.m2\repository\com\microsoft\sqlserver\mssql-jdbc\13.4.0.jre11\mssql-jdbc-13.4.0.jre11.jar" FieldNameSync.java
|
|
|
|
# 运行（以 v_b_othercompany 为例）
|
|
java -cp ".;%USERPROFILE%\.m2\repository\com\microsoft\sqlserver\mssql-jdbc\13.4.0.jre11\mssql-jdbc-13.4.0.jre11.jar" FieldNameSync v_b_othercompany
|
|
```
|
|
|
|
## 输出示例
|
|
|
|
```
|
|
=== 同步前 ===
|
|
b_field b_name list edit
|
|
------------------------------------------------------------------
|
|
b_id 系统编号 显示 显示
|
|
b_name 公司全称 显示 显示
|
|
...
|
|
|
|
=== 1) 字段名称 (col_Caption → b_name) ===
|
|
更新: 47 条
|
|
|
|
=== 2) 列表显示 (col_Visible → s_module_field_list.b_visible) ===
|
|
更新已有: 50 条
|
|
新增: 0 条
|
|
|
|
=== 3) 编辑显示 (col_edit → s_module_field_edit.b_visible) ===
|
|
更新已有: 44 条
|
|
新增: 0 条
|
|
|
|
=== 事务已提交 ===
|
|
```
|
|
|
|
## 用 AI 助手调用
|
|
|
|
如果通过 AI 助手（如 CodeBuddy）执行，告诉 AI 以下步骤即可：
|
|
|
|
> 帮我用 FieldNameSync 工具同步视图 `<viewName>` 的字段配置。
|
|
>
|
|
> 1. 进入 `fms-api/tools/migration/` 目录
|
|
> 2. 用 JDK 21 编译：`javac -cp "mssql-jdbc 驱动 jar 路径" FieldNameSync.java`
|
|
> 3. 运行：`java -cp ".;驱动 jar 路径" FieldNameSync <viewName>`
|
|
> 4. 运行完毕后删除 `FieldNameSync.class` 文件
|
|
|
|
## 已有同步记录
|
|
|
|
| 视图名 | 同步日期 | 字段数 | 备注 |
|
|
| --- | --- | --- | --- |
|
|
| `v_b_othercompany` | 2026-07-30 | 50 | 已同步 |
|
|
| `v_b_contact` | 2026-07-30 | 36 | 已同步 |
|