标准计量转换应用功能说明
1.概述
1.1.背景简介
应用开发工具 是 HOLLiMOS平台 提供的一种高效的应用开发工具。它支持工程化配置，能够灵活适应用户的个性化和定制化需求。通过应用开发工具，用户可以进行 MES、SCADA 等工业应用的组态式开发、部署、实施和运维。
为了帮助读者快速掌握如何使用应用开发工具，本手册将以 标准计量单位应用 为例，详细演示了基于应用开发工具的开发、调试、部署的整个流程。
1.2.环境准备
在开始本教程之前，我们假设您已经成功安装了 HOLLiMOS 平台环境 和 应用开发工具。本手册基于 应用开发工具 V0.10.3 版本，并向上兼容至 V0.11.4 版本。
2.标准计量应用功能简介
2.1.标准计量应用功能描述
标准计量单位用于管理系统中的计量单位，包含内置计量单位和用户自定义计量单位。
标准计量单位关系管理用来管理各个单位之间的换算关系，不支持自动的链式关系换算，例如，配置了1km=1000m 、 1m=100cm 单位换算，不会自动生成 1km=100000cm 的关系，如果需要， 用户可自行配置 1km=100000cm 关系。
2.2.标准计量单位
-
列表显示
以列表方式展示标准计量单位的数据。
-
新增
新增一条标准计量单位数据，用户可指定是否内置计量单位。
-
编辑
修改一条标准计量单位数据，内置计量单位不可修改。
-
删除
删除列表中选中的计量单位数据，内置计量单位不可删除。
-
刷新列表
2.3.标准计量单位关系管理
-
列表显示
以列表方式展示标准计量单位的数据。
-
新增
新增一条标准计量单位转换关系数据，用户可指定是否内置计量单位转换关系。计量单位和转换计量单位成对出现且唯一。
-
编辑
修改一条标准计量单位转换关系数据，内置计量单位转换关系不可修改。计量单位和转换计量单位成对出现且唯一。
-
删除
删除列表中选中的计量单位转换关系数据，内置计量单位转换关系不可删除。
-
刷新列表
2.4.标准计量单位转换接口
-
标准计量单位转换接口
根据传入的计量单位及数值，计算出转换后的计量单位和数值并返回。
3.页面设计
3.1.标准计量单位页面原型
-
列表页面
-
新增弹框
- 单位符号区分大小写
-
编辑弹框
- 内置计量单位不可编辑，用户自定义计量单位可编辑
-
删除按钮
- 内置计量单位不可删除，按钮置灰，用户自定义计量单位可删除
-
刷新按钮
3.2.标准计量单位关系管理页面原型
-
列表页面
-
新增弹框
- 单位符号禁用状态，由单位名称自动生成填入
- 换算单位符号禁用状态，由换算单位名称自动生成填入
- 不支持自动链式换算
- 换算关系保持左右单位唯一，例如 kg - g 和 g - kg 视为同条数据
-
编辑弹框
- 单位符号禁用状态，由单位名称自动生成填入
- 换算单位符号禁用状态，由换算单位名称自动生成填入
- 内置关系不可编辑，用户自定义关系可编辑
-
删除按钮
- 内置关系不可删除，按钮置灰，用户自定义计量单位可删除
-
刷新按钮
4.数据结构设计
4.1.标准计量单位表
标准计量单位表字段设计
| 编码 | 名称 | 类型 | 备注 |
|---|---|---|---|
| id | id | 整型 | 主键，唯一键，自增列 |
| unit_name | 单位名称 | 字符串 | 唯一键 |
| unit_symbol | 单位符号 | 字符串 | 唯一键 |
| creator_id | 创建人ID | 字符串 | |
| creator | 创建人 | 字符串 | |
| creation_time | 创建时间 | 日期时间 | 生成，默认值:now() |
| is_internal | 是否内置数据 | 布尔值 | 默认值:false |
| last_modifier_id | 最后修改人ID | 字符串 | |
| last_modifier | 最后修改人 | 字符串 | |
| last_modified_time | 最后更新时间 | 日期时间 | 生成，默认值:updateAt |
4.2.标准计量单位关系管理表
标准计量单位关系管理模型包含以下字段
| 编码 | 名称 | 类型 | 备注 |
|---|---|---|---|
| id | 主键ID | 整型 | 主键，唯一键，自增列 |
| unit_name | 单位名称 | 字符串 | |
| unit_symbol | 单位符号 | 字符串 | |
| convert_ratio_val | 换算比值 | 小数 | |
| convert_unit_name | 换算单位名称 | 字符串 | |
| convert_unit_symbol | 换算单位符号 | 字符串 | |
| convert_formula_preview | 换算公式预览 | 字符串 | |
| is_deleted | 是否删除 | 布尔值 | 默认值:false |
| is_internal | 是否内置数据 | 布尔值 | 默认值:false |
| creator_id | 创建人ID | 字符串 | |
| creator | 创建人 | 字符串 | |
| creation_time | 创建时间 | 日期时间 | 默认值:创建时间 |
| last_modifier_id | 最后修改人ID | 字符串 | |
| last_modifier | 最后修改人 | 字符串 | |
| last_modified_time | 最后更新时间 | 日期时间 | 默认值:修改时间 |
5.补充说明
5.1.功能补充说明
- 精度不做处理
- 需要一个计算结果的接口，输入关系（例如：kg - g）和其中一个值（kg:10），返回另一个值 （g:10000）
5.2.版本功能支持清单
| 功能 | @版本实现方式 | 备注 |
|---|---|---|
| 列表显示 | 支持（不支持序号） | |
| 新增 | 支持 | |
| 编辑 | 支持 | |
| 删除 | 支持 | |
| 刷新列表 | 支持 |