背景说明当某一个租户下安装的原生服务需要提供给其他租户服务时，安装了的原生服务的租户为服务端，需要使用原生服务的租户为客户端。在客户端还需要配置原生服务的相关参数和AppCube平台的URL地址。操作步骤以其他需要使用原生服务的租户用户登录AppCube平台。选择“管理 > 应用管理 > BO配置”。单击“Template”，进入模板BO配置页面。单击“模板功能配置”，若是参数不存在，则新增以下相关参数；若参数已存在，则修改其参数值。表1 新增模板参数参数名说明BUCKET桶名称。取值请在“应用管理 > 连接器 > 对象存储代理”中获取对应对象存储代理使用的桶名称。建议获取SmartCampus__FileOperator对象存储代理使用的桶名称。CONNECTOR_NAME连接器名称。取值请在“应用管理 > 连接器 > 对象存储代理”中获取对象存储代理的名称。建议值：SmartCampus__FileOperator。单击“系统参数配置”，配置TemplateBO_URL系统参数。TemplateBO_URL设置为提供原生服务的AppCube平台的URL，例如https://abc_dev.test.com。

操作步骤进入AppCube的租户管理台。依次选择“管理 > 应用管理> BO配置”，单击“GIS”，进入GIS BO配置界面。（可选）单击“GIS系统参数”菜单，检查对应的GIS地图相关的系统参数。GIS地图服务的地址，管理员账户和密码已经在开通时配置完成，可参考《调测指南》中的“调测参考-BO配置 > 配置GIS BO”章节，检查对应GIS厂商的相关参数是否已经配置。单击“GIS类型管理”，创建GIS系统用户。表1 创建GIS系统用户参数如何配置GIS厂商根据实际GIS服务选择，例如“伟岸纵横”，“超图”。GIS用户名配置需要创建的GIS用户名，建议配置为租户名。（可选）单击“地图权限管理”，进入地图权限管理页面。单击“上传地图”，显示地图上传弹窗。开发环境中已经导入了华为基地J区的地图。默认可以直接使用。如果要用项目其他区域的地图，则还需要自己导入。“地图名称”：自定义“GIS厂商”：从下拉框中选择对应GIS厂商。“单击上传”：需要向地图供应商获取。“权限编码”：用户自定义权限编码，“权限编码”是地图的唯一标识符，用户根据需要自行填写，具有唯一性。（可选）修改基线应用中使用的GIS地图。默认基线应用中的地图使用的是超图，如果需要在GIS BO中切换APP的地图为伟岸纵横，可以参考《调测指南》中的“调测参考-系统间对接 > AppCube平台与GIS对接 > 在运行态切换地图服务”章节切换。

设置参数。以普通用户账号登录ROMA Portal。在ROMA管理控制台的菜单栏中，切换到“XXX__华为视频分析平台”，XXX对应当前的登录用户名。选择“服务集成 > Live Data > 资源管理 > 环境配置”，进入“环境配置”页面。编辑如表2中的参数。多环境场景下有多套环境变量，每套环境变量对应一套华为视频分析平台，环境变量通过环境编号后缀区分。channel值确定了路由到哪个IO适配包，环境编号后缀确定了同一个适配包路由到哪个南向子系统，目前仅预置了2套环境变量，可根据实际环境情况，新增环境变量。园区基线版本默认对接的是0号环境。与环境变量对应的channel值为“video.huawei.vcm”，“video.huawei.vcm_1”.......，后缀可依次递增。表2 参数说明参数名称参数说明dstIp0号环境IVS服务端地址，用于判断是否NAT（Network Address Translation）场景。南向是IVS1800时，配置为IVS1800在防火墙上的Nginx 18531端口对应的IP，可从网络规划中查看。南向是IVS3800时，配置为CSP上“NAT组网管理”中“VCMMediaProcService”的“映射IP地址”。图2 VCMMediaProcService映射IP地址romaEIPROMA网关绑定的EIP地址和端口，用于NAT场景。地址类型是“https://IP:port”，具体地址和端口请向运维人员获取。注意：如果ROMA平台网关地址公开或者绑定了EIP、公网、大网，请在属性设置中设置该地址，以便南向环境将数据推送到ROMA平台，主要解决ROMA平台和南向环境不在同一网络中的问题，否则无需设置。southIP0号环境IVS服务的IP，例如“10.171.5.153”。南向是IVS3800时获取方法如下：如果ROMA能通过私网访问IVS：登录CSP，进入“应用配置 > 配置管理 > 双机管理”，查看“NGINX”的“外部业务地址”，如图3所示。图3 NGINX的外部业务地址如果ROMA不能通过私网访问IVS：配置为图3中IP映射到公网的IP。southPort0号环境IVS服务的端口。南向为IVS1800时，配置为“18531”。南向为IVS3800时，配置为VCM NGINX对第三方平台开放服务的端口，默认为“443”。使用小网地址时，请保持默认值；使用公网地址时，配置为实际的映射到公网的端口号。southUrl0号环境IVS服务地址，地址的类型是“https://IP:port”，或者“https://域名”。可以通过此参数的值也可以通过southIP与southPort的值登录IVS系统，如果两种都设置了，以southUrl的值为准。southUser0号环境IVS系统登录用户名。需要创建专用的IVS对接账号，一个IVS用户只对接一套IO环境。不能使用admin用户登录IVS，因为admin用户只允许单点在线，会导致admin用户不能登录IVS系统，做其他操作。南向为IVS1800时，IVS对接账号角色为“普通操作员”即可，该账号需要分配摄像机查看权限，并取消勾选“是否启用账户有效期”。南向为IVS3800时，账号要求如下：先创建“普通角色”和“智能角色”，再创建用户，密码设置为永不过期。创建账号后需要立即修改密码。如果账号密码或IP更改了，需要重新对接。IVS登录用户需要具备“设备管理”和“用户管理”的权限。timeZone0号环境IVS服务时区，例如“Asia/Shanghai”。dstIp_11号环境IVS服务端地址，用于判断是否NAT场景。southIP_11号环境IVS服务的IP。southPort_11号环境IVS服务的端口。southUrl_11号环境IVS服务地址，地址的类型可以是https://IP:port，或者是https://域名。可以通过此参数的值也可以通过southIP_1与southPort_1的值登录IVS系统，如果两种都设置了，以southUrl_1的值为准。southUser_11号环境IVS系统登录用户名。timeZone_11号环境IVS服务时区。mqsHostTopic的URL。获取方法请参见“获取ROMA MQS服务地址”。publisherAppIdTopic的发布应用的ID。配置为“XXX__video.huawei.vcm”，XXX对应当前登录的用户名。enableEnvironmentList多环境场景下，哪套华为视频分析平台生效。可配置多个值，用“,”分隔。选中所有参数，单击“全部发布”。选择“服务集成 > Live Data > 资源管理 > 密码箱管理”，配置VCM登录密码，编辑如表3中的参数。表3 参数说明（VCM登录密码）参数名称参数说明视频分析VCM登录密码所属应用：XXX__华为视频分析平台key：southSecret类型：密码密码：0号环境IVS系统登录密码视频分析VCM登录密码_1所属应用：XXX__华为视频分析平台key：southSecret类型：密码密码：1号环境IVS系统登录密码。华为视频分析平台Topic的发布应用的密钥所属应用：XXX__华为视频分析平台Key：publisherAppKey类型：密码密码：发布MQS消息的应用密钥，配置为“华为视频分析平台”应用的请求密钥，获取方法请参见“获取ROMA应用的请求密钥”。选择“服务集成 > Live Data > 资源管理 > 定时任务”，只能启动如下定时任务中的一个，其它定时任务都不能启动。对接的南向系统版本是ivs1800时，启动“用户保活定时任务”定时任务。对接的南向系统版本是ivs3800时，启动“华为视频分析平台登录”定时任务。单击定时任务操作列的“记录详情”，“resultCode”返回200时表示登录成功。验证对接以调用“获取摄像机列表”接口为例，验证ROMA是否与华为视频分析平台对接成功。选择“服务集成 > API网关 > API测试”。搜索“获取摄像机列表”，单击“测试”。设置请求参数，单击“测试API”。body体参数设置如下：page：单次查询页码编号。limit：单页内显示记录数，最小值为1，最大值为5000。{ "query": { "page": "1", "limit": "1" } }返回类似如下消息，表示接口调用成功。ROMA与华为视频分析平台对接成功。{ "response": { "result": { "code": "0", "errmsg": "Success." }, "onlineCount": "14", "count": "10", "total-count": "20", "camera-list": { "camera": [{ "camera-use": "0", "resolution-type": "1280*720 (720P)", "plat-name": "vcn", "sub-status": "0", "address": "", "mount-height": "0", "latitude": "", "groupId": "0", "field-no": "a30b886e9cab43d2be92e04c985c34bc", "nvr": "bb14b856376040a8b4e24e4831b100ff20181127171338", "camera-feature": "0", "vcnCameraUse": "0", "compass": "0", "stream-url": "172.xxx.xxx.20", "name": "172_20", "taskTypeList": { "taskType": ["2"] }, "id": "24", "sn": "07247090000000000101#a30b886e9cab43d2be92e04c985c34bc", "analysisList": { "analysisType": ["0010"] }, "camera-type": "2", "lane": "0", "camera-state": "0", "direction": "", "longitude": "" }] } } }

对接流程给如下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系列及以上。