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

2026-10-22 13:46:33 +08:00
parent 84009be804
commit 4c183f510d
59 changed files with 636 additions and 260 deletions
@@ -10,11 +10,11 @@
    </toc-element>
    <toc-element topic="功能转码.md">
        <toc-element topic="业务转码.md">
-            <toc-element topic="按需转码.md"/>
        </toc-element>
        <toc-element topic="代码检索.md"/>
    </toc-element>
    <toc-element topic="功能查询.md">
+        <toc-element topic="UF20-内存表映射查询.md"/>
        <toc-element topic="UFT3功能查询.md"/>
        <toc-element topic="UF20功能查询.md"/>
    </toc-element>
@@ -25,7 +25,7 @@
    </toc-element>
    <toc-element topic="元数据更新.md"/>
    <toc-element topic="更新记录.md">
-        <toc-element topic="update-1-6-0.md"/>
+        <toc-element topic="update-2-0-0.md"/>
        <toc-element topic="update-1-5-0.md"/>
        <toc-element topic="update-1-4-0.md"/>
        <toc-element topic="update-1-3-0.md"/>
@@ -10,4 +10,8 @@
        <description>Created after removal of "Empty MD Topic" from Uft30ChangeCode</description>
        <accepts>Empty-MD-Topic.html</accepts>
    </rule>
+    <rule id="41fa593">
+        <description>Created after removal of "按需转码" from Uft30ChangeCode</description>
+        <accepts>按需转码.html</accepts>
+    </rule>
 </rules>
@@ -0,0 +1,19 @@
+
+# UF20 &amp; 内存表映射查询
+
+检索 UF20（2.0）表与内存表之间的映射关系，结果四列： UF20表名 、 UF20表中文名 、 内存表名 、 内存表中文名 ；双击结果行可添加映射到「数据映射 → 表替换」
+
+<img src="内存表映射关系.png" alt="内存表映射关系">
+
+**操作步骤：**
+1. 进入 功能查询 → UF20 & 内存表映射查询；
+
+2. 输入 UF20 表名或内存表名（二者均可检索），回车或点搜索图标；
+   - 批量查询：多个表名用逗号、分号或空格分隔（中英文均可），各关键词命中结果取并集展示；
+   
+   - 搜索框内可切换精确匹配（默认模糊匹配，不区分大小写）；
+
+3. 双击结果行将该映射关系添加到「数据映射 → 表替换」：
+   - 仅当该行 UF20 表名与内存表名均非空（有完整映射关系）才可添加；
+   
+   - 表替换中已存在该 UF20 表名时自动跳过，并在提示栏注明当前映射值（不覆盖）；
@@ -5,20 +5,23 @@
 ## 查询条件
 从下拉框选择查询（功能名称、功能编号），输入框输入查询关键词，点击"Aa"切换精确/模糊匹配模式，点击放大镜图标或按回车执行查询

- 功能名称
-  <img src="功能名称查询.png" alt="功能名称查询"/>
+<img src="uf20功能查询.png" alt="uf20功能查询">

- 功能编号
-  <img src="模糊查询uf20.png" alt="模糊查询uf20"/>
-  <img src="精准查询uf20.png" alt="精准查询uf20"/>
+**操作步骤：**
+1. 进入 UF20功能查询 页；
+2. 左侧下拉选择检索字段：函数名 / 功能号，输入关键字回车或点搜索图标；
+   批量查询：多个关键词用逗号、分号或空格分隔（中英文均可），如 LS_证券参数, LS_股票
+   名单 ；各关键词命中结果取并集展示；
+   单个关键词可命中同一功能的多个字段，结果按"函数名+功能号"自动去重；
+3. 搜索框内可切换精确匹配（默认模糊匹配）；
+4. 查看结果列表，列： 函数名 、 英文名 、 功能号 ；
+5. 双击或右键选中行一键加入转码工作台：LS_ 开头功能 → 全量转码；其它功能 → 按需转码；
+  - 支持 Ctrl/Shift 多选后一次加入；右键行不在选区内时仅加入该行；

-## 结果反馈
-查询提示在页面底部 tip 栏显示，不会弹出对话框打断操作：
+  - 加入结果只弹一个提示框（"全量转码"、"按需转码"字样加粗）：同时包含两类功能时显
+    示"已将 N 个功能加入全量转码，已将 M 个功能加入按需转码"；重复添加的功能自动跳过并
+    在提示中注明；全部已存在时提示"均已在转码列表中"。

- 输入为空 → 提示"请输入查询内容"
- 无匹配结果 → 提示"⚠️ 未找到匹配的功能"
- 查询成功 → 表格展示结果，tip 栏恢复默认操作提示
-
-## 添加到转码工作台
-双击或右键选中行加入转码工作台：LS_ 开头的功能进入"全量转码"，其它功能进入"按需转码"
-<img src="双击添加.png" alt="双击添加"/>
+**查询提示：** 查询反馈显示在页面底部提示栏（颜色随日间/夜间主题自动适配），不弹对话框打断操作
+——输入为空提示"请输入查询内容"；无匹配结果提示"⚠️ 未找到匹配的功能"；查询成功后显示"已查
+询 X 个业务功能函数（M 个无匹配）"并接默认操作提示。
@@ -5,17 +5,13 @@
 ## 查询条件
 从下拉框选择查询（功能名称、功能编号），输入框输入查询关键词，点击"Aa"切换精确/模糊匹配模式，点击放大镜图标或按回车执行查询

- 功能名称
-  <img src="功能名称查询uft3.png" alt="功能名称查询uft3"/>
- 功能编号
-  <img src="模糊查询UFT3.png" alt="模糊查询UFT3"/>
-  <img src="精准查询uft3.png" alt="精准查询uft3"/>
+<img src="uft3功能查询.png" alt="uft3功能查询"/>
+
+- 界面与 UF20 功能查询一致（函数名 / 功能号检索、批量关键词、精确匹配），结果列为 函数名 、 英文名 、 功能号 ，查询提示同样在页面底部提示栏反馈；
+
+- 仅用于查询核对 UFT3 功能元数据，双击/右键不加入转码清单；
+
+

-## 结果反馈
-查询提示在页面底部 tip 栏显示，不会弹出对话框打断操作：

- 输入为空 → 提示"请输入查询内容"
- 无匹配结果 → 提示"⚠️ 未找到匹配的功能"
- 查询成功 → 表格展示结果，tip 栏恢复默认提示

-> 本页仅提供查询参考，结果行不支持双击加入转码工作台。
@@ -1,9 +0,0 @@
-# 1.6.0
-
-1.转码逻辑优化;
-
-2.元数据更新逻辑优化;
-
-3.元数据更新存储修改为db存储模式;
-
-4.写日志异常修复;
@@ -0,0 +1,12 @@
+# 2.0.0
+
+1.新增按需转码功能，支持核心功能转码;
+
+2.新增uf20和uft3表关系映射查找功能;
+
+3.支持批量查询和添加;
+
+4.元数据更新存储修改为db存储模式;
+
+5.写日志异常修复
+
@@ -5,6 +5,9 @@

 > 1.0.0版本是基础版本，包含所需功能，如果是第一次下载，请选择全量包。
 {style="note"}
+
+> 2.0.0版本是新的版本，不能增量替换需要下载全量包
+{style="note"}
 ## 增量更新
 下载增量包，解压后替换原文件即可
 > 1.0.0版本是基础版本，如若要从旧版升级到1.0.0及以上版本，可以选择增量版本下载，并将旧版根目录下的uf2touft3和当前目录替换覆盖到新版根目录。
@@ -12,13 +15,13 @@

 ## 下载

-| 版本    | 更新日期       | 全量包                                                                                                      | 增量包                                                                                                                    |
-|-------|------------|----------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------|
-| 1.6.0 | 2026-09-18 | [Uft30ChangeCode-1.6.0.zip](http://10.20.163.105:6045/download/uft3changecode/Uft30ChangeCode-1.6.0.zip) | [Uft30ChangeCode-1.6.0-update.zip](http://10.20.163.105:6045/download/uft3changecode/Uft30ChangeCode-1.6.0-update.zip) |
+| 版本    | 更新日期       | 全量包                                                                                                      | 增量包                                                                                                                 |
+|-------|------------|----------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------|
+| 1.2.0 | 2026-10-19 | [Uft30ChangeCode-2.0.0.zip](http://10.20.163.105:6045/download/uft3changecode/Uft30ChangeCode-2.0.0.zip) | |
 | 1.5.0 | 2026-08-07 | [Uft30ChangeCode-1.5.0.zip](http://10.20.163.105:6045/download/uft3changecode/Uft30ChangeCode-1.5.0.zip) | [Uft30ChangeCode-1.5.0-update.zip](http://10.20.163.105:6045/download/uft3changecode/Uft30ChangeCode-1.5.0-update.zip) |
 | 1.4.0 | 2026-07-21 | [Uft30ChangeCode-1.4.0.zip](http://10.20.163.105:6045/download/uft3changecode/Uft30ChangeCode-1.4.0.zip) | [Uft30ChangeCode-1.4.0-update.zip](http://10.20.163.105:6045/download/uft3changecode/Uft30ChangeCode-1.4.0-update.zip) |
 | 1.3.0 | 2026-07-07 | [Uft30ChangeCode-1.3.0.zip](http://10.20.163.105:6045/download/uft3changecode/Uft30ChangeCode-1.3.0.zip) | [Uft30ChangeCode-1.3.0-update.zip](http://10.20.163.105:6045/download/uft3changecode/Uft30ChangeCode-1.3.0-update.zip) |
 | 1.2.0 | 2026-07-02 | [Uft30ChangeCode-1.2.0.zip](http://10.20.163.105:6045/download/uft3changecode/Uft30ChangeCode-1.2.0.zip) | [Uft30ChangeCode-1.2.0-update.zip](http://10.20.163.105:6045/download/uft3changecode/Uft30ChangeCode-1.2.0-update.zip) |
 | 1.1.0 | 2026-07-01 | [Uft30ChangeCode-1.1.0.zip](http://10.20.163.105:6045/download/uft3changecode/Uft30ChangeCode-1.1.0.zip) | [Uft30ChangeCode-1.1.0-update.zip](http://10.20.163.105:6045/download/uft3changecode/Uft30ChangeCode-1.1.0-update.zip) |
-| 1.0.0 | 2026-06-01 | [Uft30ChangeCode-1.0.0.zip](http://10.20.163.105:6045/download/uft3changecode/Uft30ChangeCode-1.0.0.zip) |                                                                                                                        |
+| 1.0.0 | 2026-06-01 | [Uft30ChangeCode-1.0.0.zip](http://10.20.163.105:6045/download/uft3changecode/Uft30ChangeCode-1.0.0.zip) | |

@@ -2,29 +2,13 @@

 维护一份功能全名清单：转码时清单中的功能全名**保持原名不做替换**。入口：左侧导航"数据映射" > "不转码功能函数"。

-## 添加条目
+<img src="不转码函数.png" alt="不转码函数">

-点击"添加"按钮，在弹窗中输入功能全名（如 `AF_用户公用_用户可操作分支获取`）后确定。

- 功能全名不能为空；
- 不允许与已有条目重复，重复时提示后不会加入。
-
-## 编辑与删除
-
-双击表格单元格可直接修改条目。
-
-选中行后点击"删除选中"，确认后移除所选条目。
-
-## 保存
-
-点击"保存"按钮将清单写回 `bin/uf2touft3/config/cust.json`。
-
-保存前会校验：
-
- 存在空条目时报错并中止，需填写或删除该行；
- 存在重复条目时报错并中止，需修改后再保存。
-
-## 配置文件同步
-
- 清单持久化于 `cust.json` 的不转码功能函数数组中，与其他数据映射配置共用同一文件；
- `cust.json` 被外部修改时，清单自动刷新（未保存的修改会被覆盖，请先保存再改外部文件）。
+**操作步骤：**
+1. 进入 数据映射 → 不转码功能函数；
+2. 顶部搜索框实时过滤条目（不区分大小写）；
+3. 双击单元格直接修改；
+4. 点 添加 弹窗输入功能函数名（必填，重复时保存被拦截提示）；
+5. 删除选中 需二次确认（支持多选）；
+6. 修改后点 保存 生效；
@@ -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 并生效，无需额外点击。
+
+**执行转码：** 点击 开始转换，进度显示与停止方式同全量转码；任务互斥规则相同。
@@ -13,12 +13,25 @@
 ``E:\05.code\04.SVN\secu\dep1\hstrade20\trunk\Sources\DevCodes\经纪业务运营平台V21``
 <img src="UF20项目环境路径.png" alt="UF20项目环境路径"/>

-## UFT3元数据
-在 元数据更新 页面，选择更新范围(数据类型、标准字段、表结构、接口数据)并点击"更新UFT30"按钮完成元数据更新。
-<img src="UFT3元数据.png" alt="UFT3元数据"/>
-**备注：接口数据更新比较久**
+## 元数据更新
+<img src="元数据更新.png" alt="元数据更新">

-## 更新UF20元数据
-在 元数据更新 页面，选择更新范围(数据类型、标准字段、标准错误号、接口数据、常量、菜单功能、模块、表结构)并点击"更新UF20"按钮完成公共资源更新
-<img src="UF20元数据.png" alt="UF20元数据"/>
-**备注：接口数据更新比较久**
+**操作步骤：**
+1. 左侧导航进入 元数据更新；
+2. 页面分为 UFT30更新范围 与 UF20更新范围 两个卡片，勾选需要更新的元数据项（默认全选）：
+   - UFT30：数据类型、标准字段、表结构、接口数据；
+   
+   - UF20：数据类型、标准字段、标准错误号、接口数据、常量、菜单功能、模块、表结构；
+3. 可用 全选 / 全不选 按钮快速调整勾选范围；
+4. 点击 更新UFT30 或 更新UF20，页面显示进度与当前处理项；
+5. 等待完成提示后，再使用其他功能页面。
+   
+**选项说明：**
+   - 增量快速跳过：增量更新先对比源码目录整体修改时间，源码无任何变化时秒级完成，不再逐文件重复扫描；
+   
+   - 强制全量更新（进度条右上角复选框）：默认增量更新，仅重新处理有变化的文件；勾选后将重新
+   扫描并解析全部接口文件、重建增量缓存，耗时较久，勾选时需二次确认；
+   
+   - 源码变更后请重新执行更新，保证索引与实际代码一致；
+   
+   - 更新过程在后台线程执行，界面不会卡死。
@@ -1,5 +1,5 @@
 # 函数替换

-uf2函数和uft3函数之间的映射关系，支持增、删、改、查功能
+维护 UF20 函数名 → UFT3 函数名的映射，操作方式与表替换相同，支持增、删、改、查功能

 <img src="函数替换.png" alt="函数替换"/>
@@ -1,41 +0,0 @@
-# 按需转码
-
-针对**非 LS 功能**的按需转码工作台。入口：左侧导航"业务转码"页，顶部标签切换到"按需转码"。
-
-转码范围不包含核心文件、module 模块文件。支持两种模式：
-
- **非递归模式**：仅对目标文件本身执行转码，不会处理该文件内调用的函数；
- **递归模式**：转码目标文件的同时，自动对文件中所调用的关联函数一并完成转码。
-
-## 功能列表管理
-
-点击"添加"按钮，在弹窗中每行输入一个函数名（短名，如 AS_xxx），支持批量粘贴。若误带设计器扩展名后缀（如 .service_design）会自动剥离。
-
-对于以 LS_ 开头的函数，界面会以黄色文字提示，并弹窗建议放入"全量转码"工作台转码（不拦截添加）。
-
-选中行后点击"删除选中"移除函数、点击"清空列表"清空所有函数。双击函数名所在行，可在弹窗中修改函数名（页面顶部有操作提示）。
-
-## 递归模式 与 db模式
-
-每行提供"是否递归"与"db模式"下拉框：
-
- **是否递归**：
-  - **否**：非递归模式（默认）；
-  - **是**：递归模式，自动转码关联函数。
- **db模式**：选择 SQL 语法转换方言：
-  - **否**：mdb 方言（默认）；
-  - **是**：db 方言。
-
-切换后立即生效并保存。
-
-## 配置文件同步
-
- 自动读取 `bin/uf2touft3/config/cust_nonls.json` 配置："是否递归"对应 convert.dir 条目的 `depth`（0=否、-1=是），"db模式"对应 `dialect`（mdb=否、db=是）；
- 兼容旧版清单格式（纯函数名数组或数值条目，均按"否/mdb"加载）；
- 配置文件外部修改时自动刷新列表。
-
-## 转换操作
-
-点击"开始转换"启动转换任务，转换过程中可查看进度条和状态信息；点击"停止转换"可中止当前任务。
-
-工具以按需转码模式调用引擎，函数清单、递归开关与 SQL 方言由引擎直接读取 `cust_nonls.json`，无需手动同步。
@@ -3,4 +3,6 @@
 ## 快速跳转
 [表替换](http://10.20.163.105:6045/uft3changecode/表替换.html)

-[函数替换](http://10.20.163.105:6045/uft3changecode/函数替换.html)
+[函数替换](http://10.20.163.105:6045/uft3changecode/函数替换.html)
+
+[不转码功能函数](不转码功能函数.md)
@@ -1,6 +1,6 @@
 # 更新记录

- [1.6.0](update-1-6-0.md)：转码逻辑优化、元数据更新逻辑优化、元数据更新存储修改为db存储模式、写日志异常修复
+- [2.0.0](update-2-0-0.md)：转码逻辑优化、元数据更新逻辑优化、元数据更新存储修改为db存储模式、写日志异常修复
 - [1.5.0](update-1-5-0.md)：解决转码遇到公共已转函数导致失败部分接口转码失败问题
 - [1.4.0](update-1-4-0.md)：业务转码性能提升、元数据更新支持增量/强制全量、新增代码检索与调用链分析、全局文字可选中复制
 - [1.3.0](update-1-3-0.md)：修复设置路径不生效、修复元数据更新后函数检查状态异常
@@ -1,6 +1,19 @@
 # 表替换

-uf2表和uft3表之间的映射关系，支持增、删、改、查功能
+维护 UF20 表名 → UFT3 表名的映射，支持增、删、改、查功能

 <img src="表替换.png" alt="表替换"/>

+**操作步骤：**
+1. 进入 数据映射 → 表替换；
+2. 顶部搜索框实时过滤两列内容（不区分大小写）；
+3. 双击单元格直接修改；
+4. 点 添加 弹窗输入 UF20 / UFT3 表名（UF20 表名必填且不可重复）；
+5. 删除选中 需二次确认（支持多选）；
+6. 修改后点 保存 生效；保存成功后自动与映射文件立即可查：
+   - 新增的映射自动追加到该文件；
+   
+   - 修改一对一映射的内存表名后，文件中同名条目的值同步更新；
+   
+   - 该文件中配置为一对多数组的条目（一个 UF20 表对应多个内存表）保持不变，不会被表替换中的单值覆盖；
+
@@ -1,5 +1,7 @@
 # 设置

+<img src="设置.png" alt="设置.png">
+
 ## UFT30项目环境路径

  在设置页面，配置UFT30项目路径，转码使用，例如：