系统页面

使用说明和建议


基本参数设置

本服务相关的运行参数在根目录config.json文件中设置
其中Host是http接口的API服务地址
NetGatePort是对边缘服务器(网关)TCP链接的端口号
AuthHeader是鉴权码
APITest表示是否启用接口测试页面
RefreshMinutes是灯具信息采集周期,单位是分钟,默认240(4小时),仅对EMN3.2网络生效,EMN SelfTuning不受此限制
如果设置的太小,可能在一个周期内采集不完所有的灯具信息,导致数据不完整
ServerIP是允许访问的服务器IP地址,多个地址用逗号分隔,留空则不限制,EMN Go相关接口不受此限制

部署环境建议

中间件会建立两个端口的服务,分别是用于API的http服务和用于边缘服务器(网关)的TCP服务
通常在云计算平台部署时,建议NAT网关指向边缘服务器的TCP监听,SLB指向http服务

平台对接建议

中间件会采集并存储原始数据,并且不会管理任何权限,所以平台服务可以从中间件获取任何数据,但是需要自行管理权限
建议的平台设计流程:
1.中间件从大的分类上看,对每个项目存储4项内容,分别是:项目档案、项目信息、运行参数、数据信息。
项目档案很少变化,只有调试人员到现场操作才可能产生变化
项目信息实时变化,包括是否在线、是否有报警、是否有故障、各种信息最后一次更新序号等等
运行参数在手动运行模式时,由平台服务下发或者读取;自动运行模式时,由中间件自行计算,只能被读取
数据信息是持续产生的,需要平台服务周期性自行获取并存储到数据库中
每天早晨6点钟之后,前一天的数据将再无变化的可能,可以存入数据库,而对于当天数据,建议直接从中间件获取,暂不写入数据库
2.平台服务以固定周期(例如1分钟)从GetAllProjectsInfo获取所有项目的运行信息,并存储到数据库中,ProjectInfo整体数据量较小
3.如果某个ProjectInfo和之前的信息不一致,则需要进一步调用对应的接口获取变化的详细信息,比如档案变化、数据变化等
4.平台的前端应从平台服务端来获取数据,而不是直接从中间件获取数据,因为中间件不管理权限,平台服务可以根据用户权限来过滤数据

项目创建流程

通常由平台服务首先调用CreateProject接口来创建项目,中间件会创建对应的ProjectID
然后平台服务在调用RequestConfigCode来创建项目的配置口令,可以设置过期时间
至此平台服务的第一阶段工作已完成,将生成的ProjectKEY发送给现场配置人员即可,现场配置人员可以使用该KEY来提交项目档案
等项目档案提交成功后,从GetAllProjectsInfo获取的项目信息里,档案最新更新时间会变化,此时平台服务可以调用GetProjectFile接口来获取最新的档案信息
如果有售后需求,平台服务可以调用RequestConfigCode来再次创建项目的配置口令,重复以上动作即可

快速填写交付至平台的参数

在用EMN Go交付项目到SaaS时要填写很多参数,比较费时,可以通过提供给调试员一个json代码快速完成
EMN Go软件会自动解析在剪贴板中的json数据,数据格式如下: { ""api"":""https://xxxxxxxx/"", ""code"":""此处填写调试口令"" } 调试员复制以上内容后,再打开交付至SaaS页面,会自动填充内容
An error has occurred. This application may no longer respond until reloaded. Reload 🗙