ELN企业信息化公共服务平台接口规范.docVIP

ELN企业信息化公共服务平台接口规范 上海时代光华 2008-9-12 制作：李鹏 ELN web service ELN企业信息化公共服务平台接口是为客户自主提交数据所提供的符合SOAP标准的 Web Service服务程序。 可以通过：/eln3_asp/services查询ELN提供的web service接口。注意ELN提供的所有接口调用需要ELN的身份验证。可参见第2节。 1 用户使用应用服务流程 1~2.用户登陆AP。 3.AP用户成功登陆后，AP将该用户所有的应用显示出来。 4.用户请求WS服务。 5.AP系统进行参数处理，转发请求应用服务提供商（ELN）。 6~7. ELN验证请求的有效性，并返回处理结果给AP。 8．AP返回操作信息给用户。 2 身份认证 服务端利用ValidateUserTokenHandler进行身份认证。 所有调用ELN web service服务的SOAP请求头中必须包含身份验证信息。对应结点名和格式如： soap:Envelope xmlns:soap=/soap/envelope/ xmlns:xsd=/2001/XMLSchema xmlns:xsi=/2001/XMLSchema-instance soap:Header AuthenticationToken coopCode coopCode /coopCode userName userName /userName contents DES(username=””password=””coopcode=””time=””) /contents verify MD5(Contents+key) /verify /AuthenticationToken /soap:Header soap:Body ……… /soap:Body /soap:Envelope 参数解释： CoopCode = 企业在ELN系统中的ID userName = 公司系统管理员的用户名 Contents = DES(username=””password=””coopcode=””time=””) username:公司系统管理员的用户名 password:公司系统系统管理员的密码的MD5值 coopcode:企业ID time: 1970-01-01 00:00:00到当前时间的秒数。 DES加密的密钥为password进行MD5后的值。 Verify = MD5(Contents+key) Key= Contents 进行DES的加密的密钥 3 学员管理服务接口 ELN 学员管理的web service描述地址是： http://localhost:8080/eln3_asp/services/PersonnelService?wsdl 当前的ELN学员管理提供了如下接口： A 修改/增加学员 public String saveSysPersonnelInfoWS(String coopCode, SysPersonnelInfo sysPersonnelInfo, String loginName) B 删除学员 public void removeSysPersonnelInfoWS(String coopCode, String username, String password, String userId) C 查看学员 public SysPersonnelInfo getSysPersonnelInfoWS(String coopCode, final String userId) D 查看学员列表 public List getPersonnelInfoByCoopCodeWS(String coopCode, int pageNo, int pageSize) E 修改学员 public String modifySysPersonnelInfoWS(String coopCode, SysPersonnelInfo sysPersonnelInfo, String loginName) throws XFireFault; ELN学员管理的接口定义如下： 3.1.添加/修改学员： 接口名称 增加学员接口 接口描述 增加或者修改学员学员基本信息。 接口协议 SOAP 命名空间 接口描述 /eln3_asp/services/ PersonnelService?wsdl 接口方法 saveSysPersonnelInfoWS(S