esb部署webservice接口(统一用户和待办).doc

统一待办(WebService方式) 概述 门户系统做为用户访问各集成应用系统的统一入口，用户访问企业内部信息资源时只需要登录到门户系统，就可使用门户系统集成的各个应用，而待办做为各系统中用户需要处理的工作，门户系统需要提供收集建投内部应用系统中产生的待办信息，并且进行统一展现的功能，即统一待办功能。 统一待办应用业务涉及到的系统其中包括本期门户系统建设过程中所需集成的OA、WCM、EAM系统。 为保证门户系统接入各应用系统待办信息的规范性，现就各应用系统接入实现做统一要求，以确保门户系统统一待办功能实现的规范性、重用性及安全性。不满足本技术方案提供的接入规则的相关应用系统，应参考本文档完成对应用系统改造后方可进行门户系统统一待办接入工作。 统一待办实现共分为以下部分： 系统待办信息获取 系统待办信息展示 系统待办信息处理 待办信息获取 设计思路：应用系统通过门户系统提供的webservice接口向门户系统统一待办系统库写入代表信息，如下图 数据获取设计示意图 步骤如下： 1.应用系统需获得最新的待办信息。 2.应用系统通过门户接口，将获得的最新待办信息发送到门户系统。 3.统一待办系统将应用系统提供的待办信息展示给用户。 4.应用系统通过调用集成接口后获得信息，可以判断发送信息操作是否正常。 待办信息展示 设计思路：应用系统将最新的待办信息发送到统一待办系统中，并最终展示到门户首页上的待办栏目上，如下图 待办集中展示设计示意图 场景如下： 在所有的待办类标题前加上”请办理”，待阅类标题前加上”请审阅”。此外，如果信息是未办或者未阅，用红色表示 待办信息处理 设计思路：用户点击门户系统上“待办栏目”里的一条待办时，弹出一个新页面，首先同应用系统实现SSO，然后跳转到应用系统的待办页面，完成待办处理后，由应用系统调用门户接口通知门户系统，并关闭弹出的待办处理页面，门户系统负责即时刷新门户待办页。如下图： 待办信息集中处理设计示意图 系统待办规范 WebService服务端 服务地址：http://域名:8080/jicpending/services/IPandingInterfaceWebservice?wsdl 服务文件： 服务方法： 方法1. putPandingInfo：新待办 方法2. changePangdingStatus：当OPTTYPE值为2时，则表示修改待办，当为3时，则表示删除待办 方法3.仅供OA系统使用 . putOaPandingInfo：新待办， 方法4. 仅供OA系统使用 changeOaPangdingStatus：当OPTTYPE值为2时，则表示修改待办，当为3时，则表示删除待办，仅供OA系统使用 服务参数：具体定义如下表 表描述1 新待办 第一步：应用系统有新待办信息时，调用门户系统接口，将数据传送给门户系统提供的接口，流程如下： WebService接口图 在此过程中，各个应用系统以传递对象的形式传递参数，提供的参数自身包括的值为以下表说明，另外，OA系统传递参数的时候不用传递对象，只要依次传入以下表说明即可。 属性名 说明 类型 长度 备注 OPTTYPE 待办操作类型 String 10 只出现数值型字符，分别代表1:add 2:modify3:delete,此外，修改操作时只修改pstatus一个字段 PSCODE 待办对应的应用系统编号 String 10 由门户系统事先编制，参考应用系统统一编码表 (1.3) PCODE 待办编码 String 50 待办编码,各应用系统待办的唯一标识 PTITLE 待办标题 String 200 待办标题 PDATE 待办时间 String 20 待办时间,日期格式如下: yyyy-MM-dd HH:mm:ss PPRINCIPAL 待办人标示 String 100 待办负责人标示,即用户登录名 PURL URL地址 String 400 待办信息URL,应用系统提供相对的URL PSTATUS 待办状态 String 2 待办状态 0:待办 (阅)，1已阅，2:已办 PORANIGER 待办发起人标示 String 100 待办发起人标示，不要 PTYPE 待办类别：是待办类还是待阅类 String 2 待办类别:1.待办类(包括0、1、2三个状态)：2待阅类(包括0、1两个状态) PSCODEZH 应用系统编号对应的中文名称 String 30 Eg:oa—oa系统 Eam—企业资产管理系统 NGRERSON 拟稿人 String 20 拟稿人 NGDEPT 拟稿部门 String 40 拟稿部门 WENHAO 文号 String 60 文号eg:中建投发文XX号 NGDATE 拟稿日期 String 2