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