修改帮助文档;修复若干问题

This commit is contained in:
taocong
2026-10-22 13:46:33 +08:00
committed by taocong45644
parent 84009be804
commit 4c183f510d
59 changed files with 636 additions and 260 deletions
+38 -21
View File
@@ -1,36 +1,53 @@
# 业务转码
将UF20函数转换为UFT3函数格式的核心功能。
业务转码页顶部通过 Tab 切换 全量转码 / 按需转码 两个工作台。
## 功能列表管理
## 全量转码
<img src="全量转码.png" alt="全量转码"/>
点击"添加"按钮,输入函数名添加到转码列表
<img src="添加函数.png" alt="添加函数"/>
**说明:** 全量转码仅支持 LS_ 开头的功能("内存交易"改造范围),按清单对功能进行整体转码。
双击表格中函数名所在行,可在弹窗中修改函数名(页面顶部有操作提示),如下:
<img src="编辑.png" alt="编辑"/>
**表格列:** UF20函数名 | 是否存在 | 核心 | 是否柜面接口 (双击函数名所在行可在弹窗中修改函数
名)。
- "是否存在"显示 否:说明元数据未更新或该功能在 UF20 元数据中检索不到;
选中行后点击"删除选中"移除函数、点击"清空列表"清空所有函数,如下:
<img src="删除.png" alt="删除"/>
- 核心:下拉选择该功能转码后归属的核心,可选 ucbp(默认)/ uses / uarg / usms;SQL 方言 由核心自动派生——ucbp/uses 对应 mdb,uarg/usms 对应 db;
## 核心 与 是否柜面接口
- 是否柜面接口:下拉选择 否(默认)/ 是,标识该功能是否为柜面接口;
每行提供"核心"与"是否柜面接口"两个下拉框:
- 每次显示页面时自动刷新"是否存在"列。
- **核心**:选择该功能转码后归属的核心,可选 ucbp(默认)/ uses / uarg / usms;SQL 方言由核心自动派生——ucbp/uses 对应 mdb,uarg/usms 对应 db;
- **是否柜面接口**:选择 否(默认)/ 是,标识该功能是否为柜面接口。
**操作步骤:**
1. 切到 全量转码 Tab;
2. 点击 添加,弹窗内每行输入一个 LS_ 函数名(支持批量粘贴);输入非 LS 函数将被拒绝,并提示
切换到"按需转码";
3. 也可在 UF20功能查询 中双击或右键选中 LS_ 功能直接加入;
4. 双击函数名所在行可在弹窗中修改函数名;删除选中 / 清空列表(二次确认)维护清单;
5. 点击 开始转换,进度条与状态文字显示转换进度;转换中按钮变为 停止转换,可随时点击终止任务。
切换后立即写入配置并生效。
## 按需转码
<img src="按需转码.png" alt="按需转码">
## 配置文件同步
**说明:** 按需转码针对非 LS 功能转码,支持单文件转码与递归转码两种模式,转码范围不包含核心文件、module 模块文件。
- 自动读取 bin/uf2touft3/config/cust.json 配置(convert.dir 为对象数组 {name, core, viaUmgr, dialect},兼容旧版字符串数组格式);
- 配置文件外部修改时自动刷新列表
- 非递归模式:仅对目标文件本身执行转码,不会处理该文件内调用的函数;
## 转换操作
- 递归模式:转码目标文件的同时,自动对文件中所调用的关联函数一并完成转码。
点击"开始转换"启动转换任务,转换过程中可查看进度条和状态信息,如下:
<img src="转码.png" alt="转码"/>
点击"停止转换"中止当前任务,如下:
<img src="停止转码.png" alt="停止转码"/>
**添加功能(三种方式):**
- 方式一(推荐):进入 UF20功能查询,双击或右键目标非 LS 函数(支持多选后右键批量加入)→ 弹窗提示"已将 N 个功能加入按需转码";
- 方式二:按需转码 Tab 点击 添加,弹窗内每行输入一个函数短名(如 AS_xxx );误带 .service_design 等后缀会自动剥离;新增功能递归模式默认 否;若输入 LS_ 开头函数仅给出提示(建议放入全量转码),不会拦截;
- 方式三:手工编辑配置文件 cust_nonls.json (见 §6.2),保存后程序自动检测并刷新界面。
**表格列:** UF20函数名 | 是否存在 | 是否递归 | db模式 (双击函数名所在行可在弹窗中修改函数名)。
- LS_ 开头的函数名以橙色字体显示提醒(不拦截)。
**设置递归模式与 db 模式:**
1. 在目标行的 是否递归 下拉框选择 否(单文件)或 是(递归);
2. 在 db模式 下拉框选择 SQL 语法转换方言:否 = mdb(默认)、是 = db;
3. 选择后立即写入 cust_nonls.json 并生效,无需额外点击。
**执行转码:** 点击 开始转换,进度显示与停止方式同全量转码;任务互斥规则相同。