使用AstroZero创建业务对象
业务对象(BO)是封装了完整的数据模型、业务逻辑、页面展现的软件单元。一个BO提供一个完整场景的服务,为上层应用提供特定服务。不同用户可以开发各自的BO,在BO里创建逻辑使其具有特定的业务功能,开发好后制作成用户包并进行发布。下载用户包给其他用户,其他用户安装BO包后,在上层应用(需要使用该BO服务的应用)里导入发布好的BO,即导入特定的业务功能进行使用。
例如,设备BO,为上层应用提供对设备的统一语义,对设备自身能力进行抽象封装,不包含对设备的运营运维管理能力。告警BO,对园区的所有告警提供统一语义,从各个子系统和上层应用获取告警数据,统一模型统一展现。GIS服务BO,提供对GIS子系统的租户管理、地图管理、位置服务接口的封装和标准化接口。您可以基于设备BO、告警BO以及GIS服务BO等多种BO资产,创建智能烟雾感应用,完成设备数据的接入、处理分析以及告警监控功能。
创建BO
- 进入AstroZero服务控制台。
- 在主页中,单击“进入首页”,进入AstroZero应用开发页面。
- 在左侧导航栏中,选择“资产”,单击“新建BO”或单击。
- 设置BO基本信息,单击“新建”。
图1 设置BO基本信息
表1 新建BO参数说明 参数
说明
添加图标
单击“添加图标”按钮,可为新建的BO添加图标。
标签
新建BO的标签名,用于在页面显示。
取值范围:1~80个字符。
名称
新建BO的名称,名称是BO在系统内的唯一标识,创建后不可修改。命名要求如下:
- 长度不能超过26个字符,包括前缀命名空间的长度。
须知:
名称前的内容为命名空间,在AstroZero中为了避免不同租户间数据的重名,租户在首次创建应用时需要先定义一个命名空间。一个租户只能创建一个命名空间,创建后不支持修改。
- 必须以英文字母开头,只能由英文字母、数字或单下划线组成,且不允许以下划线结尾。
分类
BO所属的分类,直接下拉框中选择。
标志
新建BO在分类下,展示的图标。
描述
请根据需求,在输入框中输入对该BO的描述信息。
取值范围:1~255个字符。
高级设置 > 运行时版本
开发的资产包依赖所选择的运行时版本,如果线下运行版本不一致,可能会导致不兼容。
- 长度不能超过26个字符,包括前缀命名空间的长度。
- 在BO开发页面,根据业务功能开发相关对象、服务编排、事件和脚本等。
图2 BO开发页面
您可以根据业务功能开发新的系统特性,也可以复用系统中已存在的类似特性。例如,需要复用系统中已存在的服务编排“queryProfiles”,可在新建服务编排时选中“使用已有的服务编排”,选中该服务编排,单击“添加”进行复用。如何新建服务编排,请参见创建空白AstroZero服务编排。
图3 复用特性
BO新建私有接口时允许绑定服务编排、脚本、对象资源,通过定义服务的API,可迅速满足您定制所需要的业务接口,并将该接口服务注册到网关,供第三方使用。
图4 新建私有接口
- 在应用设计器的左侧导航栏中,选择“集成”。单击私有接口后的“+”,即可新建私有接口。
- 其他应用如果使用该BO里私有接口,绑定资源为服务编排类型的私有接口允许被服务编排和脚本调用,绑定为脚本、对象类型的私有接口只允许脚本调用,暂不支持服务编排调用。
- BO开发完成后,可将开发好的BO打包,并进行发布。
请根据实际需求,参考开发者将应用发布成安装包或补丁包、发布与部署AstroZero开发应用的源码包中操作,将BO发布为安装包、补丁包或源码包。其中,安装包、补丁包不支持二次开发,源码包支持二次开发。
导入BO安装包或补丁包
当其他用户需要使用已创建的BO时,可通过导入BO安装包或补丁包的方式,将其导入到AstroZero中。导入后,在AstroZero中创建应用时,即可使用该BO。
- 进入AstroZero服务控制台。
- 在主页中,单击“进入首页”,进入AstroZero应用开发页面。
- 在左侧导航栏中,选择“资产”。
- 在资产页面,单击“资产安装”,进入资产安装页面。
- 上传已获取的BO安装包或补丁包,单击“确定”。
导入成功后,在“资产 > 已安装的”页签,可查看到导入的BO。
图5 查看导入的BO
- (可选)BO资产包导入后,可执行如下操作。
- 在“已安装的”页签,将鼠标放在对应的BO上,单击,选择“编辑 ”,可进入BO编辑页面。只能查看BO,不支持二次开发。
- 在“已安装的”页签,将鼠标放在对应的BO上,单击,选择“详情”,可查看BO中定义的事件和事件参数等。
- 在“已安装的”页签,将鼠标放在对应的BO上,单击,选择“删除”,可删除已导入的BO。
导入BO源码包
当其他用户需要使用已创建的BO时,可通过导入BO源码包的方式,将其导入到AstroZero中。导入后,在AstroZero中创建应用时,即可使用该BO。导入的BO源码包支持二次开发。
- 进入AstroZero服务控制台。
- 在主页中,单击“进入首页”,进入AstroZero应用开发页面。
- 在左侧导航栏中,选择“资产”。
- 在资产页面,单击“导入项目”,进入导入项目页面。
- 上传已获取的BO源码包,单击“确定”。
导入成功后,在“资产 > 开发中的”页签,可查看到导入的BO。
图6 查看导入的BO
- (可选)BO源码包导入后,可执行如下操作。
- 在“开发中的”页签,将鼠标放在对应的BO上,单击,选择“编辑”,可进入BO编辑页面。在BO编辑页面,可根据业务需求对BO进行二次开发。
- 在“开发中的”页签,将鼠标放在对应的BO上,单击,选择“克隆”,可克隆BO。克隆BO会复制整个应用结构,但应用下的对象数据不会被同步。
- 在“开发中的”页签,将鼠标放在对应的BO上,单击,选择“导出”,可将BO源码包导出到本地。
- 在“开发中的”页签,将鼠标放在对应的BO上,单击,选择“删除”,可删除BO。
- 在“开发中的”页签,将鼠标放在对应的BO上,单击,选择“详情”,可修改BO的标签、运行时版本、删除自定义接口等。
在应用中使用BO
在AstroZero中开发应用时,通过添加依赖的方式,将BO添加到应用中。添加后,即可在应用中使用该BO,例如在标准页面的服务模型中,调用BO中的服务编排。
- 参考登录AstroZero新版应用设计器中操作,进入应用设计器。
- 在左侧导航栏中,单击“设置”,进入应用设置页面。
- 在“添加依赖”。 中,单击
- 在添加应用依赖页面,选择应用依赖的BO,单击“确认”。
图7 选择应用依赖的BO
如果发布BO时,编译设置的是源码包,在上层应用中导入BO后,在打包上层应用时,资产也会随应用打包发布出去。
- 使用导入的BO。
例如,在标准页面的服务模型中,调用BO中的服务编排。
- 在标准页面中,选中某个组件(如表单),单击数据绑定中的。
图8 数据绑定
- 在选择模型中,单击“新增模型”,设置模型名称,选择“服务”,单击“下一步”。
图9 新建模型
- 调用BO中的服务编排。
图10 调用BO中的服务编排
- 在标准页面中,选中某个组件(如表单),单击数据绑定中的。