当前基线应用的页面中，默认使用的是超图地图服务。如果项目也是使用超图，参见本章节步骤完成对接，基线应用即可使用地图服务。对接步骤配置系统参数。登录AppCube平台。依次选择“管理 > 应用管理> BO配置”，单击“GIS”，进入GIS BO配置界面。单击“GIS系统参数”菜单，配置如下系统参数。表1 GIS系统参数参数名称说明GIS_AdminUserNameGIS厂商（超图2D/3D）管理员账户，安装服务器时的管理员账号。GIS_AdminPasswordGIS厂商（超图2D/3D）管理员密码，安装服务器时管理员账号的密码。GIS_SuperMap_URL超图地图服务地址。例如：https://app.besclouds.com/iserver在安装GIS系统阶段，需要在AppCube平台的nginx中配置GIS系统的路由信息。配置规则是AppCube平台域名+GIS系统上下文根。如果已配置路由信息，则地图服务地址为：AppCube地址+/iserver。GISBO_SecurityMode本参数仅影响：中地标准版2D/3D地图，超图2D、伟岸标准版2D。选择GIS服务安全模式，当SDK升级而地图服务器未升级时，该参数配置为1，默认为0。0：GIS SDK访问地图服务的时候，Token放在请求Header中。1：GIS SDK访问地图服务的时候，Token放在请求URL中。创建GIS用户。在GIS BO配置界面，单击“GIS类型管理”，进入类型管理页面。单击“新建”，根据选择的地图厂商创建GIS系统用户。GIS厂商：使用2D地图时，选择“超图”；使用3D地图时，选择“超图3D”。GIS用户名：自定义。图1 新建GIS用户单击“保存”。系统会使用系统参数中配置的GIS服务基地址、管理员账号、密码，在GIS系统中新建一个用户。如果原来有超图的记录，执行本操作会更新记录，使用新的GIS用户名，同一个厂商的GIS用户记录在AppCube上仅保留最后创建的一份。创建地图权限编码。在GIS BO配置界面，单击“地图权限管理”，进入地图权限管理页面。单击“上传地图”，显示地图上传弹窗。图2 上传地图表2 上传地图参数说明参数名称说明地图名称自定义。GIS厂商使用超图2D地图时：选择“超图”。使用超图3D地图时：选择“超图3D”。权限编码自定义。地图数据包单击“点击上传”按钮，选择地图厂商提供的地图数据包，上传到GIS BO中。数据包命名需要与smwu文件命名保存一致。例如，华为J区地图数据包的smwu文件为areaJ.smwu，则数据包压缩包需命名为areaJ.zip。如果厂商在提供地图服务器时已经发布了项目需要的地图服务，此处无需上传地图数据包。地图服务如果地图数据包是在GIS BO中上传的，该参数无需配置。如果厂商在提供地图服务器时已经发布了项目需要的地图服务，该参数配置为厂商发布的地图服务的信息，由超图厂商提供。以areaJ服务为例，格式如下，其中红色的部分根据厂商提供的服务信息替换：[{ "serviceAddress":"data-areaJ/rest", "serviceType":"RESTDATA" },{ "serviceAddress":"map-areaJ/rest", "serviceType":"RESTMAP" },{ "serviceAddress":"areaJ_P3D/path3D", "serviceType":"path3d" }]外部编码仅在需要实现园区内地图与空间联动时，才需要配置。配置为当前地图对应的空间实例的“空间编码”，详见按空间切换地图。信息填充完成后，单击“保存”。

公有云HC形态下安装后调测前，需要先检查BO、IO、DO资产和APP应用的安装情况。检查APP、BO和大屏工程。登录AppCube平台。登录用户名为安装阶段自定义的租户名或者注册时申请的租户名。请联系安装人员获取。选择“管理>应用管理>软件包管理>软件包安装”，可以看到已经订购/安装的园区BO和APP，则说明订购成功。表1 基线BO序号BO名称描述1Alarm告警BO2AIServiceAI服务BO3AuditLog日志BO4Barcode条码服务BO5BatchFile批量处理BO6CommonBO依赖的公共能力7Device设备BO8GISGIS BO9Identity身份BO10Organization组织BO11Permission权限BO12Person人员BO13Space空间BO14Template模板BO15VideoAnalysis视频分析BO16VideoProxy视频代理BO17Workorder工单BO表2 园区APP序号APP名称APP说明1SecurityDashboard安防态势2OperationAnalysis运营态势3SecurityWorkbenchBase安防作业中心基础应用4SecurityWorkbenchExtend安防作业中心扩展应用5MobileSecurityWorkbench安防作业Welink应用6PersonAccess人员通行7MobileAccess通行二维码Welink应用8Person Management人员管理9Facility Management设施管理10Space Management空间及组织管理11System Management系统管理12Unified Portal统一门户单击顶部的“DMAX”，如果可以查看到大屏应用，则说明订购成功。表3 园区的大屏应用大屏应用名称大屏应用说明SecurityDashboard_IOC安防态势PortalOperationAnalysis_IOC运营态势Portal检查IO。登录华为云ROMA Connect服务，在左上角切换区域，选择项目实际所在的区域（例如“北京一”）。单击ROMA实例名称，进入实例信息界面。图1 进入ROMA实例选择“集成应用”，检查已安装IO的应用列表。相关IO清单列表请参考《集成资产说明》。如果可以查看到集成应用，则说明IO订购成功。图2 集成应用检查DO。登录华为云，进入DGC控制台。单击左侧“”进入作业开发界面。检查已安装的DO作业。如果看到作业开发中显示相关的作业列表，则说明DO安装成功。图3 作业开发检查业务流。登录华为云的ROMA业务流，在左上角切换区域，选择项目实际所在的区域（例如“北京一”），查看对应的业务流。“业务流”对应ROMA线下版本中的“FDI任务”。图4 检查业务流检查数据服务。登录华为云ROMA Connect服务，在左上角切换区域，选择项目实际所在的区域（例如“北京一”）。单击ROMA实例名称，进入实例信息界面。图5 进入ROMA实例选择“服务集成 APIC > API管理”，根据“请求路径”搜索“/dataservice/api”，查看相DO服务API。检查DLI作业。登录华为云平台，选择对应IAM项目，进入DLI环境，查看作业是否已启动。图6 DLI环境界面选择“作业管理 > Flink作业”，确认作业都在“运行中”状态。图7 公有云实时作业

Cube形态下安装后调测前，需要先检查BO、IO、DO资产和APP应用的安装情况。安装结果检查对于Cube环境，需要在园区应用租户下检查APP、IO、BO、DO资产的安装。检查APP和BO。登录AppCube平台。登录用户名为安装阶段自定义的租户名或者注册时申请的租户名。请联系安装人员获取。选择“管理>应用管理>软件包管理>软件包安装”，可以看到已经订购/安装的园区BO和APP，则说明订购成功。表1 安装后的BOBO描述Alarm告警BOAIServiceAI服务BOAuditLog日志BOBarcode条码服务BOBatchFile批量处理BOCommonBO依赖的公共能力Device设备BOGISGIS BOIdentity身份BOOrganization组织BOPermission权限BOPerson人员BOSpace空间BOTemplate模板BOVideoAnalysis视频分析BOVideoProxy视频代理BOWorkorder工单BO表2 安装后的APP场景APP名称APP说明公共Facility Management设施管理Space Management空间及组织管理System Management系统管理Unified Portal统一门户智慧安防OperationAnalysis运营态势SecurityDashboard安防态势SecurityWorkbenchBase安防作业中心基础应用SecurityWorkbenchExtend安防作业中心扩展应用MobileSecurityWorkbench安防作业Welink应用PersonAccess人员通行MobileAccess通行二维码Welink应用Person Management人员管理设施管理Device Operations设备运维BAconfigApplication组态应用FacilityWorkbench工作台WorkorderManagement工单管理AlarmManagement告警管理Operation Client技术支持DatatoolApp数据加工RuleEngine规则引擎能效管理EnergyEfficiency智慧能效单击“项目”，再单击“业务大屏”，如果可以查看到大屏应用，则说明订购成功。表3 安装后的大屏应用大屏应用名称大屏应用说明SecurityDashboard_IOC安防态势PortalOperationAnalysis_IOC运营态势Portal检查IO。登录对应的ROMA环境。Cube中的ROMA平台访问URL一般为：https://roma-docker.huawei.com，用户名：sctest1001。实际地址和租户账号都是在Cube安装阶段自定义的，请从安装人员处获取。选择左上角的应用名，单击“应用中心”，进入应用中心管理界面，如图1所示。下图中sctest1001为IO前缀示例，会根据实际项目变化。图1 应用中心检查已安装IO的应用列表。相关IO清单列表请参考《集成资产说明》。如果可以查看到应用详情，则说明IO订购成功。图2 应用详情检查DO。不支持在“数据加工”中对作业和任务进行定制修改，包括新增、修改、删除作业。登录智慧园区运营中心。单击“数据加工”，选择“数据调测>作业调测”，进入作业调测页面。检查已安装DO。如果看到作业开发中显示相关的作业列表，则说明DO安装成功。图3 作业开发检查Flink作业。在数据加工页面，选择“实时调测 > Flink作业”，查看已安装的Flink作业，确认Flink作业的状态都是“运行中”。图4 Cube实时作业检查FDI任务。登录对应的ROMA环境，查看对应模块下的FDI资产。图5 检查FDI任务检查数据服务。在ROMA环境中，查看各模块下是否存在API。图6 检查数据服务API

介绍智慧园区解决方案中所用到的术语和缩略语。表1 术语缩略语表AAdapterFDI的任务调度和资源调度。AHUAir Handling Unit，末端空调。AIArtificial Intelligence，人工智能。APIApplication Programming Interface，应用程序编程接口，应用将自身的服务能力封装成API，开放给用户调用。APICAPI Connect，ROMA平台的API管理产品，涵盖API网关、LiveData和API Market三个子产品。聚焦在API轻量化集成，存量系统服务化改造，全球跨云跨数据中心路由等核心功能，实现从API设计、开发、管理到发布的全生命周期管理和端到端集成。API GatewayAPI网关，提供API的完整生命周期管理，包括创建、维护、发布、运行、下线等。API授权网关授权给某个appid使用此API。AppCubeAppCube是一个面向企业商业应用的云开发平台，为您提供便捷、高效的应用开发能力。帮助您完成一个应用的在线开发、测试和部署。BBOBusiness Object，商业对象，一个BO相当于一个完整场景的服务。CCOPCoefficient of Performance，性能系统。DDDCDirect Digit Control，直接数字控制，简称为DDC系统，是用一台计算机对被控参数进行检测，再根据设定值和控制算法进行运算，然后输出到执行机构对生产进行控制，使被控参数稳定在给定值上。利用计算机的分时处理功能直接对多个控制回路实现多种形式控制的多功能数字控制系统。DLIData Lake Insight，数据湖探索。DOData Object，数据对象，数据平台沉淀的资产。EEIEnterprise Intelligence，企业智能。FFDIFast Data Integration，ROMA平台的数据集成产品，支持文本、消息、API、结构和非结构化数据等多种数据源之间的灵活、快速、无侵入式的数据集成，可以实现跨机房、跨数据中心、跨云的数据集成方案，并能自助实施、运维、监控集成数据。GGISGeographic Information System，地理信息系统。IIAMIdentity and Access Management，统一身份认证服务。IOIntegration Object，集成对象。IOCIntelligent Operation Center，智能运营中心。IoTInternet of Things，物联网。IVSIntelligent Video System，智能视频系统。J节点(DGC)定义对数据执行的操作。例如，使用“数据迁移”节点将数据从OBS导入到MRS Hive。LLiveData提供将各种DB内提供的数据服务，转换为REST接口的能力。MMQTTMessage Queueing Telemetry Transport Protocol，MQTT是一个物联网传输协议，被设计用于轻量级的发布/订阅式消息传输，旨在为低带宽和不稳定的网络环境中的物联网设备提供可靠的网络服务。MQSMessage Queue Service，开源分布式消息系统RocketMQ进行封装满足三大集成场景要求Active RealTime Integration，主动实时消息集成。通过消息通道，实现IT系统间的数据/应用集成。NNFCNear Field Communication，近距离无线通信技术。OOBSObject Storage Service，对象存储服务。RROMARelationship，Open，MultiCloud，AnyConnect，集成平台。TTOPIC消息主题。消息的生产与消费，围绕消息主题进行生产、消费以及其他消息管理操作。Topic也是消息队列的一种发布与订阅消息模型。生产者向消息主题发布消息，多个消费者订阅该消息主题的消息，生产者与消费者彼此并无直接关系。VVAV BOXVariable Air Volume BOX，变风量空调系统的末端装置，其作为变风量空调系统的关键设备之一。空调系统通过末端装置调节一次风送风量，跟踪负荷变化，维持室温。VCMVCM和VCN是IVS平台两大业务模块：VCN：视频调阅平台，指图像管理服务，主要负责视图的接入、存储和转发。VCM：视频分析平台，指图像解析服务和图像检索服务，主要负责智能业务的处理。VCNVDCPVideo Disk Control Protocol ，视频磁盘通讯协议。WWelink华为云WeLink，企业数字化办公协作平台，融合消息、会议、邮件、知识、能力开放等，实现团队、知识、业务、设备的全面连接。X消息轨迹在一条消息从发布者发出到订阅者消费处理过程中，由各个相关节点的时间、地点等数据汇聚而成的完整链路信息。通过消息轨迹，用户能清晰定位消息从发布者发出，经由MQS服务端，投递给消息订阅者的完整链路，方便定位排查问题。Y应用通过对应用的角色权限定义，对API、数据、消息等进行权限隔离。Z作业(DGC)作业由一个或多个节点组成，共同执行以完成对数据的一系列操作。

智慧园区解决方案以物联网、大数据、云计算、人工智能、移动互联、GIS/BIM等新型数字化技术为基础，通过集成的数字化运营平台对园区的人、车、资产设施进行全联接，实现数据全融合，状态全可视，业务全可管，事件全可控，使园区具备更安全、更舒适、更高效、更低运营成本的特点。调测说明园区智慧安防场景支持公有云HC、混合云HCSO和Cube三种安装形态，请先参考相关《安装指南》完成部署，再参考本手册进行业务功能调测。三种安装形态下，调测流程、调测方法大致相同，不同点在相应章节会分别列出。基线说明使用奥看转码服务的视频场景，必须使用奥看客户端进入智慧园区运营中心（以下简称IOC）浏览视频。IOC页面不支持缩放，请在电脑“显示设置”中将“显示分辨率”设置为“1920 * 1080”及以上，将显示大小设置为“100%”，再将浏览器网页缩放设置为100%。图1 显示设置图2 浏览器缩放设置浏览器支持Chrome， 请使用最近发布的3个版本，建议使用最新版本。如果需要使用3D GIS功能，对浏览器所在机器的显卡配置有要求，集成显卡的显示效果比较差。3D GIS：建议显卡配置是GTX 1080系列及以上。

通过环境配置/密码配置，将参数或者密码设为全局变量，后续代码中通过这里配置的Key获取对应参数、参数值、密钥和密码等。在ROMA管理控制台菜单栏，切换应用到：GTM001__人行闸机设备IO。选择“服务集成 > Live Data > 资源管理 > 环境配置”，进入环境配置界面。根据表1依次新增参数，其中“Value”以实际环境获取的值为准。表1 环境配置KeyValue描述publisherAppIdGTM001__io.basepoint.connectionmax.iot新基点IoT IO的应用ID。mqsHost192.168.39.77:9776;192.168.39.8:9776MQS服务地址。timeZoneAsia/Shanghai新基点IOT服务时区，值为时区ID。全选上一步创建的参数，选择“全部发布”。在“资源管理”菜单下，选择“密码箱管理”，进入密码箱管理界面。根据表2依次新增3组参数，其中“密码”以实际环境获取的值为准。表2 密码箱配置名称所属应用Key类型密码人行闸机设备IO应用的密钥GTM001__人行闸机设备IOconsumerAppKey密码yGxn*****IROejY6G/eb9g==新基点IoT IO应用的密钥GTM001__人行闸机设备IOpublisherAppKey密码4eGO*****J+IvwQOqMxdsQ==

创建接收设备原始消息的Topic、接收设备原始告警消息的Topic。创建Topic根据规划，人行闸机IO需要2个Topic接收新基点IoT发来的消息。在ROMA管理控制台的菜单栏中，切换应用到：GTM001__人行闸机设备IO。选择“消息集成 > 消息队列服务MQS > Topic管理 > 创建Topic”，依次创建规划中的2个Topic。其中GTM001为租户名称，实际开发时请替换为自己实际的租户名或者用户名。表1 创建TopicTopic名称所属应用说明T_IO_DATACHANGED_Turnstile_BP__GTM001GTM001__人行闸机设备IO接收设备原始消息的TopicT_IO_ALARM_Turnstile_BP__GTM001GTM001__人行闸机设备IO接收设备原始告警消息的Topic配置Topic的订阅/发布本示例中设备是通过新基点IoT系统接入到ROMA平台，ROMA上的新基点IoT应用需要向上面创建的2个Topic中写数据，所以需要配置Topic的发布应用为“新基点IoT”（GTM001__io.basepoint.connectionmax.iot）。如果设备是通过其他IoT系统接入ROMA，例如华为云IoT，则此处Topic的发布应用应该配置为“华为云IoT”。发布应用可以向Topic中写数据，订阅应用可以读取Topic中的数据。根据设备IO数据规划，人行闸机设备IO的Topic发布/订阅关系如表2所示。表2 Topic的订阅/发布Topic名称发布应用订阅应用IDT_IO_DATACHANGED_Turnstile_BP__GTM001新基点IoTGTM001__人行闸机设备IOT_IO_ALARM_Turnstile_BP__GTM001新基点IoTGTM001__人行闸机设备IO登录ROMA平台。选择“消息集成 > 消息队列服务MQS > Topic管理”，单击Topic操作列的“发布”，发布应用选择“新基点IoT”。图1 选择发布应用2个Topic的发布应用都要配置为“新基点IoT”。单击Topic操作列的“订阅”，订阅应用选择“GTM001__人行闸机设备IO”。2个Topic的订阅应用都要配置为“GTM001__人行闸机设备IO”。在“发布”或者“订阅”界面，单击“查看连接地址”可获取MQS服务地址。根据网络区域选择，开发设备IO时一般选择内部访问的地址为MQS服务地址。例如：192.168.39.77:9776;192.168.39.8:9776，拷贝到本地以便后续步骤使用。图2 获取MQS服务地址

版本兼容规范规则1、基线版本发布要有兼容性说明，定义版本兼容程度：完全兼容、部分兼容、不兼容。对不兼容部分应有重点说明，并给出解决方案建议，甚至是配套工具。[原则上是不允许出现违反兼容性的情况出现]；规则2、产品对外提供的接口的变动，在接口文档中必须要有变更记录，并准确说明变动原因、变动方式。如某接口需要废弃，则需要在变更记录中明确变动原因、废弃时间、替代（新的）接口是哪个等；在两个R版本（或1年时间）后会正式删除该废弃接口。数据库兼容规范规则3、对于基线版本，不能删除上个版本已存在的表。表名称一经发布，后续版本不能修改。规则4、对于基线版本，对上一版本已存在的数据库表，可以增加字段、不能修改字段、不能删除字段。不能修改字段包括：不能修改字段名称、不能减小字段长度、不能修改字段类型、不能修改字段默认值、不能缩小字段约束范围（比如原来是可空不能修改为必填，非唯一不能改为唯一约束，取值类型不能减少）。能够修改字段包括：可以增加字段的长度、可以扩大字段的约束范围（比如增加枚举值）。规则5、对表的访问，必须指定字段访问，不能直接操作表的所有字段，如“select *”，“insert table values”。例外的情况是能够直接根据所有基线+定制的字段自动生成接口或界面，或指定字段访问查询出的数据集。配置兼容规范配置项，包含平台和基线的参数、权限项、profile、桶内的默认图片、连接器定义等，不包括项目的实例化数据。以下如非特别指明，配置项指这里说明的定义。规则6、定制不能修改基线发布给现场的配置项。定制一旦修改，该配置项的行为如果不属于基线定义的项目实例化参数，修改后变成不可控，需要具体分析实际影响，可能需要割接脚本或者修改代码。规则7、基线已发布的配置项只增不删。规则8、基线提供的配置文件/配置项不能删除。规则9、基线的配置项ID建议采用独立编码/编码段。规则10、对于对外所提供的配置项，配置项取值约束和配置含义不允许变化，如果有变化，需要有开关管理。规则11、配置项的格式不能改变（特殊情况如果修改，要提供配套工具转换到新的格式上）。Core资产（BO/DO/IO）兼容规范规则12、BO、IO、DO对象不能删除。确实需要废弃的采取废弃方式，2个R版本（或1年时间）后正式删除。规则13、BO、IO、DO正式暴露的服务原则上不能删除。确实需要废弃的采取废弃方式，2个R版本（或1年时间）后正式删除。规则14、BO、IO、DO正式暴露的服务的方法名、入参值类型 、出参值类型、异常类型不能修改。规则15、BO、IO、DO正式暴露的服务的方法的入参、出参不能增加必填字段，如果需要增加必填字段，则必须设置默认值。可以增加可选的入参。规则16、BO、IO、DO正式暴露的服务的方法入参、出参不能为已有参数添加必填约束。规则17、BO、IO、DO正式暴露的服务的方法参数、路径不能删减或变更。规则18、BO、IO、DO正式暴露的服务的协议、协议请求方式不能变更或删除，只能新增。确实需要废弃的采取废弃方式，2个R版本（或1年时间）后正式删除。规则19、BO、IO、DO正式暴露的服务的错误码不能变更或删除，只能新增。规则20、BO、IO、DO正式暴露的消息主题不能删除。确实需要废弃的采取废弃方式，2个R版本后正式删除。规则21、BO、IO、DO正式暴露的消息的主题、格式、消息头、属性、属性类型不能修改。规则22、BO、IO、DO正式暴露的消息体的参数及数据类型不能删减或变更。不能修改参数包括：不能修改参数名称、不能减小参数长度、不能修改参数类型、不能修改参数默认值、不能缩小参数约束范围（比如原来是可空不能修改为必填，非唯一不能改为唯一约束，取值类型不能减少）。能够修改参数包括：可以增加参数的长度、可以扩大参数的约束范围（比如增加枚举值）。规则23、BO、IO、DO正式暴露的消息体不能为已有参数添加必填约束。规则24、BO、IO、DO正式暴露的消息体不能增加必填参数，如果需要增加必填参数，则必须设置默认值。可以增加可选的参数。规则25、BO的DataAccess原则上不能删除。确实需要废弃的采取废弃方式，2个R版本后正式删除。规则26、BO的DataAccess的入参、出参不能修改和删除，只能新增。规则27、BO的DataAccess的入参、出参不能增加必填字段，如果需要增加必填字段，则必须设置默认值。可以增加可选的入参。规则28、BO的DataAccess的入参、出参不能为已有参数添加必填约束。规则29、BO的正式暴露的聚合对象原则上不能删除。确实需要废弃的采取废弃方式，2个R版本（或1年时间）后正式删除。规则30、BO的正式暴露的聚合对象访问路径不能变更。Resources（ Widget、 Connector、 Library ） 兼容规范规则31、Global Widget只增不删。规则32、Global Widget可变配置属性只增不删，属性的名称及类型不能修改。规则33、Global Widget消费的View Model JSON只增不减。规则34、正式发布的Connector只增不删。规则35、正式引入的Library只增不删。规则36、正式引入的异常错误码只增不删。第三方接口兼容规范规则37、涉及第三方接口，一旦正式发布，接口、接口协议不能变更和裁剪。规则38、涉及第三方接口，一旦正式发布，入参、出参不能修改和删除，只能新增。规则39、涉及第三方接口，一旦正式发布，入参、出参不能增加必填字段，如果需要增加必填字段，则必须设置默认值。可以增加可选的入参。规则40、涉及第三方接口，一旦正式发布，入参、出参不能为已有参数添加必填约束。规则41、涉及第三方接口，一旦正式发布，错误码、返回码不能变更或删除，只能新增。

根据规划的人行闸机设备IO的应用名称和ID，在ROMA平台注册应用。登录ROMA平台。鼠标移到左上角应用名上，在下拉框中选择“应用注册”。图1 应用注册设置应用信息，如图2所示，单击“提交”。其中GTM001为租户名称，实际开发时请替换为自己实际的租户名或者用户名。应用ID：GTM001__io.device.basepoint.Turnstile_BP应用名称：GTM001__人行闸机设备IO所属组织：选择默认值ROMA。认证类型：选择“私钥认证”。图2 注册新应用应用注册成功后返回“应用管理”界面，单击上一步创建的应用的“密钥管理 > 显示密钥”，验证用户后获取GTM001__人行闸机设备IO的请求密钥（AppKey）。将“请求密钥”拷贝到本地写字本中，以便后续步骤使用。在“应用管理”界面搜索“新基点IoT”，获取新基点IoT IO的应用ID和请求密钥，保存到本地以便后续步骤使用。

开发流程设备IO的开发流程如表1，开发规范请参考《集成平台开发规范》。表1 设备IO开发流程流程说明注册应用在ROMA平台注册设备IO的应用名称和应用ID。创建Topic并设置订阅/发布创建接收设备原始消息的Topic、接收设备原始告警消息的Topic。环境配置/密码配置通过环境配置/密码配置，将参数或者密码设为全局变量，后续代码中通过全局变量获取对应参数、参数值、密钥和密码等。开发消息上报接口设备IO的消息上报接口，共包含3个LiveData接口。开发指令下发接口设备IO的指令下发接口，1个LiveData接口。设备IO数据规划规划应用ID、Topic和接口URL，如表2所示。表2 设备IO的数据规划参数样例说明租户GTM001下面样例中的“GTM001”为租户名称。本章节在开发过程中，要在设计内容的基础上增加后缀“__GTM001”或者前缀“GTM001__”，即携带租户信息。deviceTypeTurnstile_BPIoT系统对应的IO通过消息体中的“deviceType”参数，确定要路由的设备IO。其中“BP”指新基点IoT（BasePoint），在多IoT场景中以“deviceType”中的后缀（例如“_BP”）区分不同的IoT。在实际开发过程中，根据设备实际接入的IoT系统来增加后缀。应用IDGTM001__io.device.basepoint.Turnstile_BP人行闸机IO在ROMA平台的应用ID。其中GTM001为租户名称，实际开发时请替换为自己实际的租户名或者用户名。应用名称GTM001__人行闸机设备IO人行闸机IO在ROMA平台的应用名称。Topic接收新基点IoT发来的设备原始消息的Topic：T_IO_DATACHANGED_Turnstile_BP__GTM001人行闸机IO需要2个Topic接收新基点IoT发来的消息：一个接收设备原始消息，一个接收设备告警消息。其中GTM001为租户名称，实际开发时请替换为自己实际的租户名或者用户名。接收新基点IoT发来的设备原始告警消息的Topic：T_IO_ALARM_Turnstile_BP__GTM001接收设备信息变化的标准Topic：T_IO_DEVICE_DATACHANGED__GTM001消息格式标准化之后：转换后的设备原始消息，推送给设备信息变化标准Topic。转换后的设备告警消息，推送给设备告警的标准Topic。这2个Topic只需要创建一次即可，所有设备IO转换后的标准消息都推送给它们，不需要重复创建。接收设备告警的标准Topic：T_IO_DEVICE_ALARM__GTM001API设备数据变化消息回调（人行闸机）URL：/io/GTM001__io.device.basepoint.Turnstile_BP/device/data-changed人行闸机IO的2个LiveData接口，分别订阅如下2个Topic进行数据格式标准化。T_IO_DATACHANGED_Turnstile_BP__GTM001T_IO_ALARM_Turnstile_BP__GTM001其中GTM001为租户名称，实际开发时请替换为自己实际的租户名或者用户名。设备告警消息回调（人行闸机）URL：/io/GTM001__io.device.basepoint.Turnstile_BP/device/alarm开放订阅关系的配置接口URL：/io/GTM001__io.device.basepoint.Turnstile_BP/device/mqsSet消息订阅接口，开放订阅关系的配置接口，用于订阅设备变化、告警消息。人行闸机设备IO指令下发URL：/io/GTM001__io.device.basepoint.Turnstile_BP/south/send-command/0.1.0人行闸机设备IO指令下发包含一个LiveData接口，名称为“指令下发（人行闸机）”。

设备IO的需求园区一般集成了多种设备，不同设备上报的消息体、格式各不相同，业务平台（AppCube平台）对消息格式有统一化的要求，因此需要在集成平台（ROMA平台）对上报的消息进行拆分、格式化处理，从而屏蔽设备原始消息与标准消息之间的差异问题。基线通过设备IO来实现设备原始消息转化为标准消息的功能。设备IO的功能介绍设备通过IoT（例如新基点IoT）系统接入到ROMA平台。设备IO用于处理设备上报给ROMA平台的消息，以及ROMA平台下发给设备的指令数据，而消息上报和指令下发都要通过IoT（如新基点IoT）来实现。图1 设备IO功能下面以新基点IoT系统、人行闸机设备IO为例，介绍设备IO的消息处理流程，如表1所示。表1 设备IO的消息流程功能流程消息上报人行闸机设备数据变化/告警消息，由新基点IoT IO拆分成设备数据变化或者设备告警消息，并转发给人行闸机设备IO。人行闸机设备IO对数据格式进行转换标准化，并发送到标准Topic完成消息上报。指令下发设备管理标准接口应用路由业务侧的指令到IO Adapter应用。IO Adapter依据“channel”参数确定指令要路由到哪个IoT（南向物联网系统）。“channel”参数用于多IoT平台的场景。例如要将指令路由到新基点IoT，那么业务侧指令应该携带的“channel”值为“basepoint.connectionmax.iot”。南向物联网系统对应的IO通过消息体中的“deviceType”参数，确定要路由的设备IO，并携带accessToken。设备IO将业务侧下发的指令转换为实际物理设备可以执行的指令，并调用南向物联网系统的指令下发接口。

非常高兴能够获得2021年华为智慧园区开发者奖项，2021年我们福建省委党校项目交付全部采用ABC、ROMA、大禹等华为全栈式园区数字平台搭建、开发及应用。对于咱们开发人员来说，确实对研发人员要求，比咱们传统开发有所降低，数字平台基本上采用拖拉拽、页面配置、少量定制开发等方式实现项目应用。在生产环境一直延迟提供的情况下，华为协助我们提供开发平台环境和集成验证环境帮助我们提前开发及交付，让我们感到非常的便利。我们对未来的数字园区诉求是尽快减少定制化开发，更简易调测，问题定位协调渠道够高效；对方案方面的建议就是是否可以把所有的园区涉及到的能够汇总到一起或一个文档，方便调测，这样对实施人员来说更容易寻找。

兼容与可定制点密切相关。解决方案的定制与配置分层分为四层，参见如下示意图。Addon方式属于旧的定制模式，不推荐使用；推荐伙伴直接采用App源码包作白盒修改，基线不对参考应用/场景应用作兼容和升级保证，只保证Core的兼容。兼容性目标兼容性是以基线版本为基础，相对于定制版本而言。后向兼容（向下兼容/向后兼容）：现在版本兼容以前版本生成的数据、或扩展实现（如定制版本）。对智慧园区即，基线20.0版本支持‘for 基线C00版本’的定制程序包。前向兼容（向上兼容/向前兼容）：以前版本支持现在版本生成的数据、或扩展实现（如定制版本）。对智慧园区即，基线C00版本支持‘for 基线20.0版本’的定制程序包。兼容性主要的关注点有向前兼容和向后兼容。智慧园区基线解决方案主要满足后向兼容。兼容性设计目标：支持解决方案基线和定制版本的独立演进。基线版本升级不影响一定版本范围内的定制版本。正式发布的版本要100%后向兼容2个R版本或1年时间（取两者时间较短的一个）。兼容性范围基线解决方案定义兼容性设计的目标范围如下：Core承诺兼容性，包括：Core资产（含BO、IO、DO）、App Framework（含Unified Portal和System Management）、实例化数据等核心资产，对外暴露的服务及Widget需要保证兼容性。场景App作为参考实现（不含Unified Portal和System Management），内部包含的API、Script、Page、Widget等供平台ISV伙伴参考，不承诺兼容性。伙伴升级时，不需要升级App，只需要升级核心Core资产；伙伴可以订购新的App。配置数据需要伙伴参考规范，才能保证兼容性。影响兼容性的主要场景在基线版本交付中包含的主要实体有：业务对象BO、数据资产DO、集成资产IO、配置参数数据、参考应用App、Resouce（Global Widget等）。一个新的功能要满足版本的兼容，本质上是要解决上述关键实体的兼容性设计问题。基线版本兼容性问题的场景主要有如下几方面：1） 基线版本增加新功能：已经发布的实体承载的业务能力不能满足要求，需要在原有增加新的实体来满足业务场景的要求。2） 基线版本修改某个功能缺陷/逻辑：已经发布的功能存在Bug或者问题，需要对原有的功能进行修复，但不会对具体API、业务对象的定义进行修改。3） 基线版本增强已有功能：对原有能力的增强，已经发布的实体在继承原有能力的同时需要进一步的增强其能力。例如原有的API接口/业务对象定义保持不变，但是需要增加新的逻辑到原有的逻辑实现中。4） 基线版本修改已有功能：原有功能不再有效，或者需要把原有者功能进行修改。其本质是停止原有功能，增加新功能。5） 基线版本调整已有功能：已经发布的实体的职责进行重新的调整划分导致。例如业务实体提供的某些服务迁移到其他业务实体中。6） 基线版本删除现有功能：禁止使用或者不再提供已有的功能。如果单纯出现这种场景就直接破坏了兼容性的要求。关键场景与兼容性对应关系：兼容性设计影响场景增加新功能修改缺陷增强已有功能修改已有功能调整已有功能删除现有功能是否符合向后兼容性设计符合符合符合不符合不符合不符合基线版本升级是否影响定制版本不影响不影响不影响影响影响影响关键场景与业务对象对应关系：以BO为例分析，场景对应业务BO，BO提供实体对象的服务/api。交付件场景①增加新功能②修改缺陷③增强已有功能④修改已有功能⑤调整已有功能⑥删除现有功能开放API新增服务/API定义服务/api定义不变服务/api定义不变服务/api定义发生变化服务/api定义发生变化服务/api定义发生变化业务对象新增业务对象业务对象定义不变业务对象定义不变业务对象定义发生变化业务对象定义发生变化业务对象定义发生变化建议措施可以新增可以修改可以增强增加服务/API的新版本，保留旧版本增加服务/API的新版本，保留旧版本增加废弃标识，在2个R版本后正式删除从现有的分析来看，场景①②③满足向后兼容，场景④⑤⑥不满足向后兼容，在定制版本需要满足向后兼容的设计中要尽量避免场景④⑤⑥的出现；出现场景④⑤⑥时按照建议措施进行处理。兼容性检查和发布兼容性检查工具：在开发态，能基于系统的实现扫描并产生兼容性检查报告，同时标识出不兼容点；由开发人员对照检查不兼容点属于上一节描述的哪种场景，采取对应的处理措施。实例化工具：在升级态，能够比较定制和基线实例化数据的差异点并产生兼容性检查报告，同时标识出不兼容点，并提供对不兼容点的处理策略，比如：保留定制实例化数据、定制与基线合并、使用基线实例化数据等。实例化数据升级检查工具：在生产态，能够比对定制和基线升级的实例化数据的差异，并生成实例化数据升级兼容检查，以便升级人员针对性的检查和处理。兼容性说明资料：版本发布时，需要对应发布兼容性说明资料，说明当前版本对各个对象的兼容情况，并提供不兼容点的处理策略，比如：暂时不修改待2个R版本前完成修改即可、立即修改、修改实例化数据等。升级脚本或工具：涉及到超过2个R版本（或1年时间）的修改，根据需要可提供升级脚本或工具，辅助定制版本进行升级。兼容性前提平台兼容性平台的兼容性是基线兼容的重要前提条件。平台保证平台本身的API特性的兼容性。平台保证平台提供的参数的兼容，并支持打包在平台版本中，基线修改参数可覆盖平台的参数值。平台支持App和BO的版本机制，并能管理对于的版本对应关系。平台保证基线资产schema对象做到租户隔离升级【暂未实现】。平台支持对API进行使用检查，对于不推荐使用的API、Flow、Script在开发态进行限制和提示，避免伙伴定制超出约定范畴。定制范围约束App仅作为参考实现（不含Unified Portal和System Management），对伙伴开发直接复制一份进行完全的白盒修改。BO严格遵循兼容原则，只开放API供伙伴进行BO的Addon，BO内部的DB的扩展机制确保兼容（平台保证），BO内部的Flow、Script对伙伴不可见。App内部的Widget和api，跟随App的原则，仅供参考修改，不支持兼容。

问题现象使用FusionCompute对Cube下电后，数据平台GaussDB无法正常启动。原因分析使用FusionCompute批量提交关闭电源后，FusionCompute关闭虚拟机时异步的操作，高斯主备双机可能不是同时关闭的。例如主机先关闭，这个时候备机还没有关闭，这样就会导致触发双机切换动作，产生lock文件。lock文件产生后，备机还没有成功切主机，备机又被FusionCompute关掉，这样就会导致Lock文件遗留。等到上电时，双机检测就会产生异常。解决方法上电之后，以root用户分别登录GaussDB的主备机检查GaussDB的状态。# su - gaussadmin21.0之前的版本使用gaussdba。$ gs_ctl query然后分别在主备双机上执行gs_ctl query查看高斯数据库的状态是否为normal，角色是否正确。主机： Ha state: LOCAL_ROLE : Primary STATIC_CONNECTIONS : 1 DB_STATE : Normal DETAIL_INFORMATION : Normal ......备机： Ha state: LOCAL_ROLE : Standby STATIC_CONNECTIONS : 1 DB_STATE : Normal DETAIL_INFORMATION : Normal .....如果不是normal状态，继续下一步定位。以root用户分别登录主备机检查双机日志。检查/data01/keepalived/bin/keepalive_chk_gaussdb.log日志中是否一致在打印check lock file exist,stop switch日志。如果存在，进入到/data01/keepalived/bin目录下删除primary.lock或者standby.lock文件。等待一会后参考1检查双机状态。

监控总览监控总览页面可以看到应用App、数字平台、容器、虚拟机的告警汇总情况。登录Cube线下运维台Portal。选择“运维中心>监控中心>监控总览”，查看应用App、数字平台、容器、虚拟机的告警汇总数量。图1 监控总览单击告警数值，打开对应的告警查询页面，可进一步查看告警详情。图2 告警列表单击可以查看告警详细信息，根据详细信息中的处理步骤完成告警的处理。图3 告警详细信息