省集中平台与业务应用系统接口规范1.docVIP

云南省电信翼机通集中平台与应用子系统接入方案和接口规范说明书 v2.0 云南省电信公司 云南省通信产业服务有限公司 2012-05-07 一、接入方案 1.1 消费系统接入方案 离线消费系统升级成省集中管理模式，用户侧可部署一台前置机，并在前置机上安装一个前置应用程序（伺服器），用户通过统一登录接口登录到省平台，省平台再转到各相应的子应用系统进行应用管理。 根据上图，数据从消费机端通过用户局域网传输数据到通信前置机。根据以往经验，使用五类或超五类非屏蔽网线过长（一般超过100米）时，会产生丢包现象，为时数据正确，在通信前置机采集消费机数据时需要尽量保证数据的正确和完整。 1.2 联网考勤系统和会议签到接入方案 联网考勤应用采用白名单与黑名单方式进行。可实现联网跨地域考勤。考勤系统不需要前置机作为数据传输中介。考勤通过EVDO/1X无线或ADSL/LAN有线方式直接连接到翼机通考勤子系统上传考勤数据。 1.3 门禁系统接入方案 门禁系统不使用省集中管理模式。 二、统一登录接口 2.1 接口定义 企业进入子系统由统一登录界面提供登录方法。统一登录界面由省集中平台提供。用户进入 http://222.221.*.*或指定登录域名进入统一登录界面。 注：登录过程均需要有日志记录，失败错误页面跳转省翼机通平台错误页面。 在登录完毕之后，将出现统一管理界面，由菜单和框架组成。具体的应用功能由子系统提供。 其菜单也由统一界面提供，如下： 在用户点击应用子系统后，将使用FrameSet框架为子系统提供嵌入式管理界面。提供地址和参数为如下。 模版 http://{iphost:port}/SubLogin.jsp?u={username}f={function}k={keypass} 参数说明 名称 说明 数据类型 长度 厂商子系统的IP地址 string 20 port 厂商子系统端口 string 5 username 登录用户名 string 20 function 子系统功能，用于区别同厂家的不同应用。1: 消费 2: 考勤 3: 门禁 4: 会议签到 5: 彩门。 string 2 keypass 算法：MD5({password}+{yyyyMMdd}+{ipaddress}) 其中：password: MD5加密后的用户密码。 yyyyMMdd: 日期，格式：年月日，例 ipaddress: 用户的IP地址。 string 32 三、系统接口规范 3.1 接口综述 通过公网或VPDN接入远程网络，数据发送到服务器，接入方式有VPDN/EVDO/1X/ADSL/LAN等。由于EVDO和1X稳定性与信号有关，丢包率尚难控制，因此建议在有有线网络的情况下，尽量采用ADSL/LAN的接入方式；在无有线网络的情况下，优先采用EVDO无线上网的形式，最后考虑1X上线模式。 子应用系统采用主动模式和被动模式，向省平台获取数据（平台信息、人员信息、部门信息、卡片信息、机具信息等），并上传数据至省集中平台。可参考下列示意图： 所有接口采用Web Service标准接口。 接口分为：消费子系统(省翼机通集中共享平台（简称省平台）、考勤子系统(省平台、短信子系统(省平台。各个部分均需要进行数据交换，以提供正常的应用数据。 接口均为双向接口，省平台和子系统均提供，原则上谁拥有原始数据，就由谁主动传数据，被动方也可主动向拥有数据一方请求数据。 由于省平台接口采用动态webservice技术,不是单独针对某子应用系统进行开发,子应用系统接口必须满足以下几点 接收方面的接口命名空间唯一 参数大小写,包结构严格按照下文提供的XML格式进行传输 采用soap协议 省平台提供的接口,通用入参在供应商子应用系统接入平台时生成,是子应用系统主动与平台通信的唯一标识与依据 3.2 接口协议 本接口采用WEBSERVICE协议来实时进行数据传递。采用相应的实体作为入参与出参。 3.3 服务接口列表 服务 服务名称 说明 EntSync 校企信息同步，省平台管理所有校企信息数据，校企信息由省平台根据用户订购的应用，下发到各应用子平台；应用子平台也可主动向省平台拉数据。 校企群信息同步 EntGroupSync 校企群信息同步，校企群仅用于联网考勤，校企群可理解成一个集团公司下有多个分公司，校企群就是集团公司的概念。省平台管理所有校企群信息数据，校企群信息由省平台下发到各子平台；子平台也可主动向省平台拉数据。 人员信息同步 EmployeeSync 人员信息同步，省平台管理所有人员信息数据，人员信息由省平台下发到各应用子平台；应用子平台也可主动向省平台拉数据。 卡片信息同步 CardSyn