对接流程给如下API添加白名单，白名单地址配置为VCM的服务地址。VCM可以调用该API推送告警消息。对于“人员检索”、“人脸库对比”和“车辆检索”场景，因为不需要推送告警消息，所以无需添加白名单。南向是IVS1800时：需要给“IVS1800告警回调接口”、“推送VCM告警消息（ivs1800）”接口添加白名单。南向是IVS3800时：需要给“IVSSDC车辆告警回调”、“推送VCM告警消息”接口添加白名单。设置参数：将登录VCM的参数和MQS相关的参数设入ROMA平台。启动定时任务：启动“华为视频分析平台登录”定时任务。对接操作添加白名单。“人员检索”、“人脸库对比”和“车辆检索”场景不需要执行本步骤。以“admin”用户登录ROMA平台。admin用户的密码请向运维人员获取。切换应用到“华为视频分析平台”。选择“服务集成 > API网关 > API授权”。单击如下接口对应的“授权”，分别为它们添加白名单。南向是IVS1800时：需要给“IVS1800告警回调接口”、“推送VCM告警消息（ivs1800）”接口添加白名单。南向是IVS3800时：需要给“IVSSDC车辆告警回调”、“推送VCM告警消息”接口添加白名单。表1 配置白名单参数名称参数说明应用ID选择需要授权的应用ID：xxx__video.huawei.vcm。白名单如果是南向系统是IVS1800，配置为IVS的业务IP。如果是南向系统是IVS3800XF，配置为IVS的PDPC的“外部业务IP”，IP之间用“,”隔开。获取方法：登录IVS的CSP Portal，选择“应用配置 > 配置管理 > 节点管理”，搜索“PDPC”，查看PDPC容器的外部业务IP。线下ROMA平台的浮动IP地址，在ROMA平台“服务集成 > API网关 > 网关管理 > 网关域管理”中获取。注意：白名单中的IP地址可以访问ROMA API，存在安全风险，请慎重配置。插件配置添加插件：插件名称：sign request插件值：{"enable": "false"}绿色通道打开开关。注意：白名单配合绿色通道同时使用，标识白名单中的IP地址是否需要身份验证。关闭：白名单中IP地址访问ROMA API时，需要进行密钥认证或JWT认证。开启：白名单中IP地址访问ROMA API时，不需要进行密钥认证或JWT认证。开启后，系统将以白名单中应用IP地址作为绿色通道入口，此模式存在安全风险，请慎重选择。API参数无需配置。流控配置无需配置。图1 API授权并添加白名单

在校验人脸通行权限时，北向的人员类型是按照项目需求配置的，IO支持人员类型映射表配置，把北向的人员类型映射成对应PAD支持的人员类型。以普通用户登录ROMA Portal。在ROMA管理控制台的菜单栏中，切换到“XXX__依图闸机通行PAD接口IO”，XXX对应当前的登录用户名。依次选择“环境管理 > 服务配置”。系统进入“服务配置”页面。新增参数。以“STAFF”为例，方法如下：单击“新增”。补充必填信息。“key”对应AppCube平台人员BO配置的“人员类型定义”的“标识符”。“value”可选为11或者12，“模块”为“APIC”。表1 参数说明参数名称参数说明STAFF依图闸机通行PAD拍照发送给园区人员通行服务后，返回的值，可配置。该参数的值可配置为“11”，代表可以通行，根据实际情况配置。VISTOR依图闸机通行PAD拍照发送给园区人员通行服务后，返回的值，可配置。该参数的值可配置为“12”，代表不可以通行，根据实际情况配置。选中所有参数，单击“全部发布”。

IO Adapter用于将应用侧下发的请求，正确的路由到指定的IO适配包。创建AppCube用户。登录AppCube平台。选择“管理>用户管理>用户”，单击“新建”创建用户。输入用户信息，选择用户权限，单击“保存”。如下图所示。“权限”配置为实例化预置的“IOAdapterServiceProfile”。“用户名”建议配置为租户名_IO_User_Profile。如果是沃土平台的AppCube，无法在AppCube平台上创建用户，需要在沃土数字平台官网上单击“个人中心”。选择“我的账号 > 子账号管理”，创建子账号，子账号的默认Profile是“Standard User Profile”。必须先完成租户实名认证后才能新增子账号。实例化预置的“IOAdapterServiceProfile”拥有人员通行和人员管理应用的访问权限。如果用户名已经存在且权限是“IOAdapterServiceProfile”，不需要重复创建用户。获取AppCube的鉴权信息。登录AppCube平台。选择“管理 > 系统管理 > OAuth”。单击“新建”，输入名称，“授权类型”选择“客户端模式”，选择上个步骤创建的用户，并单击“保存”。系统会自动生成客户端ID和客户端密钥。每个OAuth都有特定的用途，因此需要为AppCube鉴权信息单独新建一个OAuth。该OAuth关联的用户需要具有访问相关API的权限，否则回调时会因为权限问题失败。单击，下载excel文件，从中获取AppCube平台鉴权ID和鉴权密钥。返回ROMA Portal，并打开“IO Adapter”应用。设置参数。选择“服务集成 > Live Data > 资源管理 > 环境配置”，编辑如下参数。表1 参数说明（IO Adapter）参数名称参数说明southDomainAppCube平台服务地址，可使用域名（例如dev.besclouds.com），也可使用IP地址加端口号（例如192.168.28.162:31134）。此参数与“southUrl”二选一。grantType鉴权模式，目前为固定模式：client_credentials。southUser客户端ID，即AppCube平台鉴权ID。southUrlAppCube平台服务地址。格式为https://+域名，或者https://+IP:端口号。此参数与“southDomain”二选一。选中所有参数，单击“全部发布”。选择“服务集成 > Live Data > 资源管理 > 密码箱管理”，编辑参数。表2 参数说明参数名称参数说明bingo服务鉴权密钥所属应用：XXX__IO Adapterkey：southSecret类型：选择“密码”。密码：AppCube平台鉴权密钥。启动定时任务。选择“服务集成 > Live Data > 资源管理 > 定时任务”。选中“ABC鉴权”，单击“启动”。单击“记录详情”，检查定时任务是否启动成功。如果日志返回中有"resultCode": "200"，表示启动成功。

人员通行场景需要先定义出入口，并为出入口关联通行设备。创建出入口创建出入口的步骤如下。登录智慧园区运营中心。依次选择“便捷通行>出入口管理>配置出入口”。选择需要创建的出入口空间位置，单击“配置出入口”，单击“创建”。图1 “配置出入口”页面弹出“创建出入口”窗口，配置出入口相关信息。出入口管理员，用于在“便捷通行>通行权限管理>通行授权”页面，管理出入口的通行权限。只有出入口的管理员，才能给该出入口进行通行授权。图2 配置出入口相关信息选择已经配置好的出入口，单击此出入口后面的设备图标。为通行设施，为其他设施。校验设备规格编码为“PAD”时，控制设备的规格编码必须为“Turnstile”。校验设备规格编码不是“PAD”时，控制设备的规格编码都为“AccessControl”。图3 关联设施弹出关联设施页面，配置相关信息，控制设备与检验设备为同一设备。“基础信息”：选择控制方向。“选择校验设备”：关联已有的设备，用于校验人员通行权限。“选择控制设备”：关联已有的设备，用于控制人员出入。图4 通行设施信息列表图5 其他设施信息列表单击“确定”。创建出入口组创建出入口组，用于管理有关联的出入口，步骤如下。登录智慧园区运营中心。依次选择“便捷通行>出入口管理>配置出入口”。选择需要创建的出入口空间位置，单击“配置出入口组”，单击“创建”。图6 “配置出入口组”页面弹出“创建出入口组”窗口，配置出入口组相关参数。“关联出入口”：选择已创建的不同出入口，添加到出入口组中，便于管理。“管理员选择”：出入口组管理员，用于在“便捷通行>通行权限管理>通行授权”页面，管理出入口组的通行权限。只有出入口组的管理员，才能给该出入口组中的出入口进行通行授权。图7 配置出入口组相关信息单击“确定”。

登录IOC后，当IOC操作员一段时间内未操作系统，登录将失效；必须重新登录后才可重新操作。园区解决方案的登录会话管理使用的是AppCube平台会话管理机制。在AppCube平台设置会话时长，即可实现对园区操作员会话访问时长的管理。配置步骤AppCube默认的会话时长已在安装阶段配置，调测阶段默认不用修改，IOC操作人员可继承该会话时长。如果项目中需要修改，可根据需要为不同的“角色”设置访问凭证时长。登录AppCube平台。登录的AppCube账号，必须拥有System Administrator Profile权限，才能修改访问凭证时长。依次选择“管理 > 用户管理 > 权限配置”。单击需要配置的权限名称，进入详情页面。IOC角色与AppCube平台权限的对应关系如下表所示。表1 角色对应的权限名称IOC角色名称AppCube权限名称说明自定义角色Portal User Profile园区用户“自定义角色”的权限对应“Portal User Profile”，园区用户创建新的“自定义角色”时，会自动继承“Portal User Profile”的设置（“自定义角色”是指非园区系统预置的角色，由用户自己创建。系统管理员SM_Administrator园区系统预置角色“系统管理员”的权限对应“SM_Administrator”名称，园区创建新的“系统管理员”时，会自动继承“SM_Administrator”的设置。普通操作员SM_Operator园区系统预置角色“普通操作员”的权限对应“SM_Operator”名称，园区创建新的“普通操作员”时，会自动继承“SM_Operator”的设置。单击页面右上角的编辑图标，页面进入修改状态。图1 编辑图标选择“自定义”，设置“访问凭证时长”和“刷新凭证时长”。单击右上角图标，修改完成。“访问凭证时长”和“刷新凭证时长”必须同时设置“默认”或者“自定义”。图2 配置详情页面

问题现象登录AppCube平台时报如下错误，登录提示418您的请求疑似攻击行为（APP）。原因分析由于安全问题，某些IP可能无法访问，AppCube平台的域名或者IP被华为云WAF拦截了。解决方法在本BBS论坛提问题帖子，通知运营团队将您的运营商公网IP或您开发中使用的URL加入白名单里即可。

对接步骤配置系统参数。登录AppCube平台。依次选择“管理 > 应用管理> BO配置”，单击“GIS”，进入GIS BO配置界面。单击“系统参数”，配置如下系统参数。表1 配置系统参数系统参数值GIS_WazhMap_URL2D/3D伟岸纵横标准版/高级版地图服务地址。安装完GIS系统后，需要在AppCube平台的nginx中配置GIS系统的路由信息。配置规则是AppCube平台域名+GIS系统上下文根。如果已配置路由信息，则地图服务地址为：AppCube地址+/iserver_wazh。如：https://app.besclouds.com/iserver_wazh。GISBO_WazhAdminUserNameGIS厂商（2D/3D伟岸纵横标准版/高级版）管理员账户，安装服务器时的管理员账号。GISBO_WazhAdminPassWordGIS厂商（2D/3D伟岸纵横标准版/高级版）管理员密码，安装服务器时管理员账号的密码。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”。权限编码自定义。地图数据包使用伟岸纵横2D地图时：单击“点击上传”按钮，选择地图厂商提供的地图数据包，上传到GIS BO中。使用伟岸纵横3D地图时：这里不需要上传，由地图厂商发布。地图服务如果地图数据包是在GIS BO中上传的，该参数无需配置。如果厂商在提供地图服务器时已经发布了项目需要的地图服务，该参数配置为厂商发布的地图服务的信息，由伟岸纵横厂商提供。伟岸纵横厂商给项目提供的DEMO中包含这个服务信息，可以直接获取。以areaJwazh服务为例，格式如下：[{"serviceType":"RESTMAP","serviceAddress":"map-VRGV/rest"}, {"serviceType":"RESTDATA","serviceAddress":"data-VRGV/rest"}, {"serviceType":"RESTADDRESSMATCH","serviceAddress":"addressmatch-VRGV/restjsr"}, {"serviceType":"RESTTRANSPORTATIONANALYST","serviceAddress":"transportationAnalyst-VRGV-VRGV/rest","dataset":"Park"}, {"serviceType":"RESTTRANSPORTATIONANALYST","serviceAddress":"transportationAnalyst-VRGV-VRGV-F01/rest","dataset":"F01"}, {"datasourceName":"VRGV"}, {"serviceType":"RESTTRANSPORTATIONANALYST", "serviceAddress":"transportationAnalyst-VRGV-VRGV-F02/rest","dataset":"F02"},{"serviceType":"RESTTRANSPORTATIONANALYST","serviceAddress":"transportationAnalyst-VRGV-VRGV-B01/rest","dataset":"B01"}, {"serviceType":"RESTTRANSPORTATIONANALYST","serviceAddress":"transportationAnalyst-VRGV-VRGV-B02/rest","dataset":"B02"}]外部编码仅在需要实现园区内地图与空间联动时，才需要配置。配置为当前地图对应的空间实例的“空间编码”，详见按空间切换地图。信息填充完成后，单击“保存”。切换基线APP的地图（基线预安装的APP默认使用的地图是超图，当使用其他地图时，可以在GIS BO中切换）。在GIS BO的配置界面，单击“动态地图属性配置”，单击“新建”，进入“项目地图属性详情”页面。图3 切换基线APP的地图配置基线APP的地图参数。表3 切换地图参数说明参数名称说明项目名称即AppCube中的应用名称，选择要切换哪个应用的地图，例如“FacilityManagement”。地图类型选择使用哪种地图类型。地图名称上传地图时填写的地图名称。地图中心经/纬度根据地图实际经纬度配置，尽量接近实际位置。如果偏差太远，会导致地图在页面外。例如J区的经纬度分别为：114.05771866980714、22.657455992129975。地图缩放级别仅2D地图需要配置，例如“17”。最小缩放级别仅2D地图需要配置，例如“1”。最大缩放级别仅2D地图需要配置，例如“22”。地图中心高度仅3D地图需要配置，例如“130”。倾斜角仅3D地图需要配置，例如“0”。俯视角仅3D地图需要配置，例如“-20”。旋转角仅3D地图需要配置，例如“-30”。

当前基线应用的页面中，默认使用的是超图地图服务。如果项目也是使用超图，参见本章节步骤完成对接，基线应用即可使用地图服务。对接步骤配置系统参数。登录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、涉及第三方接口，一旦正式发布，错误码、返回码不能变更或删除，只能新增。