建模进阶:设计组件¶
组件是可重复利用的模型。将模型开放为组件,是为了提高模型的复用性和灵活性。本文帮助设备接入和管理人员快速了解设计组件的流程。
前提条件¶
创建组件前,需要拥有模型所在分组的编辑权限。更多信息,参见 模型管理权限分配。
模型分析¶
通常在以下情况下,应该考虑将模型设为组件:
通用性强的信息
比如”设备基本信息”,包括设备名称、型号、出厂日期等通用属性,适合抽象成一个可复用的组件。其他如风机、光伏逆变器等设备模型,都可以引用这个”设备基本信息”组件,避免重复定义相同的结构。
需要统一维护和更新的信息
某些基础性质的信息一旦更新,可能需要统一更新所有模型,例如为每个模型新增“行政区域”属性。将其设计为组件后,只需要在组件中更新一次,所有引用该组件的模型都会自动更新,大大简化了维护工作。
需要精细权限管理的信息
较为敏感的信息可单独抽象为一个模型,如设备 MAC 地址、设备使用许可信息等,可限制用户对这类特性的编辑、删除权限,实现细粒度的权限控制。将这些模型抽象为组件后,为组件单独设置一个分组,利用分组对组件的编辑权限进行独立管理。
需要特别说明的是,引用组件不受分组的限制。这意味着,即使组件被放在某一分组中,当这一组件被分享到当前 OU 后,OU 内其它分组的模型也能直接引用该组件,大大增加了组件的复用范围。
组件设计原则¶
设计组件时,建议遵循以下原则:
职责单一
比如”地理位置”组件,就只包含经纬度、海拔等地理信息相关的要素,不应该混入其他无关的信息。
可扩展性
组件的设计应留有后续扩展的空间。以”天气信息”组件为例,最初可以只包含温度、湿度等基础要素,将来还可以添加降雨量、风速等新的要素。
命名规范
组件及其要素的命名应该遵循统一的规范,例如”地理位置”、”设备基本信息”等,语义清晰。
描述完善
组件及其内部要素应有完善的描述,说明组件的功能、适用场景、各要素的含义等。这样其他开发人员在引用组件时,就能快速理解和使用。
操作流程¶
设计组件的流程如下:
创建模型,添加模型要素。
(可选)如需跨 OU 引用组件,可在开发者 OU 中 将组件分享到其它 OU。
完成后,其他接入人员可在指定 OU 内 引用该组件。