docs: refine mmsmapping config defaults
This commit is contained in:
@@ -21,7 +21,7 @@
|
||||
|
||||
- 左上只保留 ICD 文件选择和 `解析 ICD` 按钮
|
||||
- 左下统一展示接口返回中的 `mappingJson` 和 `problems`
|
||||
- 右侧作为系统配置区,承载基础请求字段、模板配置表格和辅助信息
|
||||
- 右侧作为系统配置区,承载精简请求字段、默认模板配置表格和辅助信息
|
||||
- 页面不再要求用户直接编辑 `request JSON`
|
||||
|
||||
### 2.2 业务目标
|
||||
@@ -52,6 +52,8 @@
|
||||
- `prettyJson`
|
||||
- `outputDir`
|
||||
- `indexSelection`
|
||||
- 前端页面只对用户开放 `version`、`author` 和 `indexSelection` 相关配置
|
||||
- `saveToDisk`、`prettyJson`、`outputDir` 仍按接口契约参与请求,但采用页面内部默认值,不在右侧配置区开放编辑
|
||||
- 第一次解析时可不传有效 `indexSelection`,接口会返回 `NEED_INDEX_SELECTION`
|
||||
- 第二次生成时,`indexSelection` 必须沿用解析返回的合法候选值
|
||||
- `mappingJson` 为字符串字段,需要前端格式化展示
|
||||
@@ -90,34 +92,38 @@
|
||||
|
||||
右侧固定为配置与生成工作区,包含三部分:
|
||||
|
||||
1. 基础请求字段表单
|
||||
2. 基于 `DefaultCfg.txt` 生成的模板配置表格
|
||||
1. 精简请求字段表单
|
||||
2. 基于 `DefaultCfg.txt` 自动生成的默认模板配置表格
|
||||
3. 解析返回的辅助信息展示及 `生成映射` 操作区
|
||||
|
||||
## 6. 右侧配置区设计
|
||||
|
||||
### 6.1 基础请求字段
|
||||
### 6.1 前端可配置请求字段
|
||||
|
||||
基础字段全部保留并可配置:
|
||||
右侧仅保留以下可配置字段:
|
||||
|
||||
- `version`
|
||||
- `author`
|
||||
- `saveToDisk`
|
||||
- `prettyJson`
|
||||
- `outputDir`
|
||||
|
||||
使用表单形式维护,不再暴露底层 JSON 文本。
|
||||
|
||||
这些字段参与两类请求:
|
||||
以下字段不在右侧开放配置,而是由页面内部写死默认值:
|
||||
|
||||
- `saveToDisk = false`
|
||||
- `prettyJson = true`
|
||||
- `outputDir = ''`
|
||||
|
||||
上述字段仍参与两类请求:
|
||||
|
||||
- 解析 ICD 请求
|
||||
- 生成映射请求
|
||||
|
||||
区别在于解析请求强制使用空的 `indexSelection`。
|
||||
|
||||
### 6.2 模板表格骨架
|
||||
### 6.2 默认模板表格骨架
|
||||
|
||||
右侧表格的骨架由 `DefaultCfg.txt` 提供。
|
||||
页面在解析完成后,基于 `DefaultCfg.txt` 自动生成一份默认模板,作为右侧的初始可编辑草稿。
|
||||
|
||||
优先使用 `ReportList` 生成分组,每个分组至少展示:
|
||||
|
||||
@@ -167,7 +173,7 @@
|
||||
|
||||
### 7.2 自动匹配建议
|
||||
|
||||
解析完成后,页面尝试将模板分组与候选分组自动匹配:
|
||||
解析完成后,页面尝试将默认模板分组与候选分组自动匹配:
|
||||
|
||||
1. 优先按 `groupDesc` 匹配
|
||||
2. 若不唯一,则结合以下信息辅助判断:
|
||||
@@ -205,14 +211,18 @@
|
||||
|
||||
点击 `解析 ICD` 时:
|
||||
|
||||
- 使用当前基础请求字段
|
||||
- 使用当前前端可配置字段
|
||||
- 同时附带页面内部默认值:
|
||||
- `saveToDisk = false`
|
||||
- `prettyJson = true`
|
||||
- `outputDir = ''`
|
||||
- 强制令 `request.indexSelection = []`
|
||||
- 调用 `getIcdMmsJson`
|
||||
|
||||
解析成功后:
|
||||
|
||||
- 保存本次 `indexCandidates`
|
||||
- 生成新的配置草稿
|
||||
- 基于 `DefaultCfg.txt` 自动生成新的默认模板草稿
|
||||
- 右侧展示辅助信息与模板配置表格
|
||||
|
||||
### 8.3 生成映射
|
||||
@@ -222,6 +232,10 @@
|
||||
- 取右侧当前最新草稿
|
||||
- 做本地校验
|
||||
- 组装最终 `request.indexSelection`
|
||||
- 同时附带页面内部默认值:
|
||||
- `saveToDisk = false`
|
||||
- `prettyJson = true`
|
||||
- `outputDir = ''`
|
||||
- 再次调用 `getIcdMmsJson`
|
||||
|
||||
### 8.4 多次生成
|
||||
@@ -319,8 +333,8 @@
|
||||
|
||||
职责:
|
||||
|
||||
- 基础请求字段表单
|
||||
- 模板配置表格
|
||||
- 精简请求字段表单
|
||||
- 基于 `DefaultCfg.txt` 自动生成的默认模板配置表格
|
||||
- 辅助信息展示
|
||||
- `生成映射`
|
||||
|
||||
|
||||
Reference in New Issue
Block a user