资源描述
1 统一待办(WeServc方式)1.1 概述门户系统做为顾客访问各集成应用系统的统一入口,顾客访问公司内部信息资源时只需要登录到门户系统，就可使用门户系统集成的各个应用,而待办做为各系统中顾客需要解决的工作,门户系统需要提供收集建投内部应用系统中产生的待办信息，并且进行统一呈现的功能，即统一待办功能。统一待办应用业务波及到的系统其中涉及本期门户系统建设过程中所需集成的OA、W、EAM系统。为保证门户系统接入各应用系统待办信息的规范性,现就各应用系统接入实现做统一规定，以保证门户系统统一待办功能实现的规范性、重用性及安全性。不满足本技术方案提供的接入规则的有关应用系统,应参照本文档完毕相应用系统改造后方可进行门户系统统一待办接入工作。统一待办实现共分为如下部分： 系统待办信息获取 系统待办信息展示 系统待办信息解决1.2 待办信息获取设计思路：应用系统通过门户系统提供的wesevice接口向门户系统统一待办系统库写入代表信息,如下图数据获取设计示意图环节如下：1应用系统需获得最新的待办信息。2应用系统通过门户接口,将获得的最新待办信息发送到门户系统。3.统一待办系统将应用系统提供的待办信息展示给顾客。.应用系统通过调用集成接口后获得信息,可以判断发送信息操作与否正常。1.3 待办信息展示设计思路:应用系统将最新的待办信息发送到统一待办系统中,并最后展示到门户首页上的待办栏目上，如下图待办集中展示设计示意图场景如下：在所有的待办类标题前加上”请办理”，待阅类标题前加上”请审视”。此外,如果信息是未办或者未阅,用红色表达1.4 待办信息解决设计思路：顾客点击门户系统上“待办栏目”里的一条待办时，弹出一种新页面,一方面同应用系统实现O，然后跳转到应用系统的待办页面，完毕待办解决后，由应用系统调用门户接口告知门户系统,并关闭弹出的待办解决页面，门户系统负责即时刷新门户待办页。如下图: 待办信息集中解决设计示意图 1.5 系统待办规范1.5.1 Wvie服务端服务地址:http:/域名:8080/jicpdin/ervices/IPadigIefeWeservice?wsdl服务文献: 服务措施：措施1. puPandgno：新待办措施2. changePagdgSts:当OPTTYE值为2时，则表达修改待办,当为3时，则表达删除待办措施仅供OA系统使用. puOaPadngIo:新待办，措施. 仅供A系统使用cangeaPangingStat:当OPPE值为2时,则表达修改待办，当为3时,则表达删除待办,仅供OA系统使用服务参数：具体定义如下表 表描述11.5.2 新待办 第一步:应用系统有新待办信息时,调用门户系统接口,将数据传送给门户系统提供的接口,流程如下:WeService接口图在此过程中，各个应用系统以传递对象的形式传递参数，提供的参数自身涉及的值为如下表阐明，此外,A系统传递参数的时候不用传递对象,只要依次传入如下表阐明即可。属性名阐明类型长度备注OPTT待办操作类型Strin10只浮现数值型字符,分别代表1:d 2:moify:deet,此外，修改操作时只修改psatus一种字段PCODE待办相应的应用系统编号String10由门户系统事先编制，参照应用系统统一编码表 (1.3)PCOE待办编码 ing5待办编码，各应用系统待办的唯一标记PTE待办标题Strng00待办标题DATE待办时间Stng20待办时间，日期格式如下:yyMM-d HH:mm:ssPNCIPAL待办人标示String10待办负责人标示,即顾客登录名PURR地址ring待办信息URL,应用系统提供相对的ULPSTATUS待办状态Str2待办状态 :待办 (阅),已阅,2:已办ORANIER待办发起人标示Strg10待办发起人标示，不要PTYP待办类别:是待办类还是待阅类Strn待办类别:1.待办类(涉及0、2三个状态）：2待阅类（涉及0、两个状态）PSODEH应用系统编号相应的中文名称Strg3Eg:oaoa系统 am公司资产管理系统GRERSON拟稿人String20拟稿人NGEPT拟稿部门Srng40拟稿部门WENHA文号Strn文号e：中建投发文X号GDTE拟稿日期ting20日期格式如下:yyyy-MM-d 表描述11.5.2.1.1 Webeic应用系统样例OA应用系统: pulcstat void main(tring rgs) Srg ul nll;try ul = java.et.Iet4Adress.getLoclHst().gtHddes（).toStrng();cah （nknstxcepion e1) / OD uogented atch bloce1rtaTace()； Stringuffr rieRL=ew StigBffer(); ervceURL.ppend（htt：/).apnd(url）.apen(：8080/jipdngsevicePandingIntrfaceWbsrvce); try IPandingIntrfaebervservic =XfreClienory.etClient（service.tStrin(）, IPandnInerfacWesericeclass); /新待办,应用系统调用该接口进行待办数据插入操作，*措施名：utPndingInfo()参数名：ptTyp, sd,pCode， pTitle, pa，Oraier, pPcpal, pR, pSttus, Pyp等各个参数具体定义如上图阐明* StringValue = erie.ptPandingInf(ptTye, psCode, Code,pile，pte, raige, Prncpal, pURL, pSttus, Ptype); Sst.ou.println(新增待办成功吗?: +adVaue)； atch (xeton e) e.ttcTrace(）； 非OA应用系统: puli sati vid ain(Strig arg) trin url null;r url= ava.ne.Ie4rss.geLclos().etstAdds（).totring(）;cth (UnkonHosExepton e1) / TDO to-enered ahbocke.printStckTrace()； StringBuffe seviceUR =ne StingBufer()； servceRLaped（http:/).aed(rl)apen(:808/jicpendig/srvies/IPandinIntrfacWebsr)； try PadingInterfaceebsrvice ervice = XfireClintFaoy.etlient(srieURL.oStrin(),IPndigInterfaceebservicecss)； /新增待办 RPdingVoo = nw RPeninVo(); vo.setOptype(); vo.setPCode(）； vostsco(); vo.stPTitle（）; vo.sPstas(）； o.stPOanig(); vsePricipal(）; o.seta()； o.setPURL(); .etPtyp(）; StringaddVau = serie.utdingIno（vo); ystm.ut.println(新增待办成功吗?: adVaue); cath （Ection e) e.pintSkrac()； 1.5.3 修改、删除待办l 第一步:应用系统需要修改待办信息时，调用门户系统接口,将数据传递给门户系统提供的接口，流程如下：传播数据方式在此过程中,需要从应用系统获得的值涉及如下几种:属性名阐明类型长度备注ptTy操作类型Sri10只浮现数值型字符,分别代表1:add 2:mdiy3:dlete，此外,修改操作时只修改psts一种字段psCe待办相应的应用系统编号Stng10待办相应的应用系统编号，由门户系统事先编制,并在集成时提供应各应用系统ode待办编码String50各应用系统待办的唯一标记tp待办类别tng2待办类别:1待办类(涉及0、三个状态):2待阅类(涉及、1两个状态)PPINCIPA待办人标示tr10待办负责人标示,即顾客登录名表描述21.5.3.1.1 WebService应用系统样例应用系统: publi stai oimain(Strg ag) Sting rl null;tr url = jvanete4ddresetLcalHost（).ettAdrs().toString（）; cth （UnownHotExcptin e1) /ODOAtoeneraed catchbloce1.prnkTra(); tringBfer servcURL = new SringBuffer(）; serviceURL.ped（ttp：/)pend(url）.apped（:800/jienigevs/IPandingInterfaceWeservie); ty IPndingnterfaeWberice srice = firClitacoy.gtCient(srvcR.Strng()， IPaniInraceWebevice.class)； /修改、删除待办,应用系统调用该接口进行待办数据修改、插入操作,/措施名:caePginSta (）参数名:ptTpe,sCode， Cde, pTite， pDt， pOranigr， prncipal,RL, pStaus,Ptp等各个参数具体定义如上图阐明*/ /修改待办,当opTyp=2 Sringodfalue ervce.nPndigtus(opype,sod， pCde, tpe）; Syste.ou.printn（修改待办成功吗？: +moiyVle）； / 删除待办,当optTpe=3 Strig deetValu sri.angeangigStatus(optyp, Code, pode,Pye）; System.ot.prinln（删除待办成功吗?: +deteaue); ctch(Exceptione) e.rintSackTrae(）; 统一代办 新增：ptaPaigInf、tPandinInf属性名阐明类型长度备注PTTP待办操作类型,不能为ullSring0只浮现数值型字符，分别代表：ad:odif3:delee PSODE待办相应的应用系统编号,不能为NulSring10由门户系统事先编制,参照应用系统统一编码表PCODE待办编码 ,不能为l in50待办编码,各应用系统待办的唯一标记PTILE待办标题,不能为ulStrng200待办标题TE待办时间,不能为ulltg20待办时间,日期格式如下:yyyyM-d H:mm：sPPIPAL待办人标示,不能为ulString10待办负责人标示，即顾客登录名PULURL地址,不能为NuStrng00待办信息URL，应用系统提供相对的ULPAUS待办状态,不能为ulStng2待办状态 0:待办 (阅)，1已阅,2:已办PP待办类别：是待办类还是待阅类，不能为NullSng待办类别:1.待办类(涉及0、2三个状态)：2待阅类(涉及、1两个状态)SCODEZH应用系统编号相应的中文名称,不能为Nultrg30:oao系统 EM公司资产管理系统NGERO拟稿人，不能为ulString20拟稿人GDPT拟稿部门,不能为Nutring0拟稿部门WENHAO文号Strig60文号eg：中建投发文X号GDTE拟稿日期,不能为NllSring20日期格式如下:yyy-M-ddPNT备用，当做待办所属模块tig55Eg:发文管理 修改、删除： changeOaPaggStas、agePandingtatu属性名阐明类型长度备注optType操作类型Sring10只浮现数值型字符,分别代表:a 2:modfy3:le psCode待办相应的应用系统编号Stig0待办相应的应用系统编号,由门户系统事先编制，并在集成时提供应各应用系统pode待办编码Strig50待办编码,各应用系统待办的唯一标记Py待办类别Strin待办类别:1.待办类(涉及0、1、三个状态）:2待阅类(涉及、两个状态)PPCIPAL待办人标示Srig100待办负责人标示,即顾客登录名2 统一顾客管理2.1 统一顾客管理的必要性在门户系统建设之前，各应用系统分别具有各自独立的顾客账户和权限管理体系,公司内部不同的顾客群体在访问不同的应用系统时,需要分别进行身份的认证和授权,顾客与应用系统之间互相交叉形成了一种网状的身份管理架构，如下图所示。顾客在访问不同的系统时需要输入不同的账号和口令，不仅不以便,并且有安全隐患。门户系统的建成和投入使用，使顾客可以通过Prtl这个统一的入口、运用单点登录(Single Sign-O）技术实现对后台多种应用系统的统一访问,解决了上述的网状身份架构带来的问题。这是门户系统的一项重要功能和收益。但是对于IT系统管理和维护人员来说，目前并没有带来以便。甚至常常为门户与后台各应用系统身份信息不能自动保持一致等一系列问题而感到头疼。其因素在于虽然通过门户实现了顾客的统一登录,但是对身份信息的维护和管理仍然是分散的，如下图所示。用一句话来概括就是:顾客可以通过门户实现统一登录，但是顾客信息的维护和管理仍然是分散的，即“统一登录,分散管理”。分散的顾客管理必将带来如下多种弊端：1. 系统之间无法共享顾客基本数据,导致信息冗余2. 顾客的身份信息不能在系统间自动保持一致和同步3. 顾客管理分散,维护工作量巨大4. 存在安全隐患5. 缺少顾客管理流程保障6. 难以量化管理顾客身份信息，不能满足身份安全审计的规定2.2 顾客信息同步设计按照各应用系统及应用使用数据库类型进行辨别,数据同步设计分为如下几种同步方式：2.2.1 邮件系统顾客数据同步和2EE类应用系统顾客数据同步一致,调用门户中间数据库接口。2.2.2 Domino OA顾客数据同步通过邮件系统同步顾客到domno OA的names.nf库，但是如果O系统需要同步部门的话，则调用门户提供的部门同步服务接口。2.2.3 J2E类应用系统顾客数据同步对于J2E类通过JAA开发实现的应用系统,统一安全层的顾客数据采用 “积极”方式与应用系统进行顾客数据交互，如下图所示：一、 积极方式阐明应用系统通过中间数据库提供的JVA应用PI接口,按照一定期间规则通过轮寻方式读取中间顾客数据库中的顾客数据，并同步到应用系统相应顾客数据库表中。设计环节如下图所示具体环节：1. TDI脚本通过LAhanelg读取变化的顾客或者组织机构数据2. TDI脚本将数据写到I中完毕原则动作，同步也将数据写到中间数据库中。3. 各应用系统按照一定期间规则通过轮寻方式调用门户的bseie接口祈求从中间数据库中读取有变化的顾客或组织机构数据。4. 门户webservice接口将获得的数据返回给各应用系统,各应用系统将数据同步到相应的顾客或机构数据库表中2.2.4 门户顾客数据源门户系统顾客分为两类,第一是:实名顾客，第二是:虚拟顾客.实名顾客:此类顾客可以同步存在多种部门，产生自OA流程,在OA流程审批后，调用门户系统提供的rvce接口，把数据放入门户系统中间数据库。WebServie服务端服务地址:t:/域名:80/jdsource/services/IDsInterfacebsevce?sdl服务参数：具体定义如下表ameTyeNulle属性描述CODEVARCAR(0)员工编号_NAMEVARA2(200)Y员工姓名C_UNITODEVARCAR2(200)Y员工所属部门唯一标记，可以有多值,以#分开_UNIAMEARCHAR2(0)Y员工所属部门名称,可以有多值,由于一种员工可以同步在多种部门,以#分开C_GENDERVARAR(2)Y性别：1男女CUDTITYUMRARHA2(2)Y身份证号码，只针对实名顾客MAILRCHA2（50） Y个人内网电子邮件CUEXCPOSITNLEVELVACHR2(10）Y行政职务级别MBLEVARCR2(0)Y手机号码TELPHONMERVARCHA2(2)办公电话SICALLIYOFFICENAMEVARCR2（200)Y办公地点CUOREVARCHAR2(0)Y部门内人员排序，无排序写0000COSTVARHA2(50）现从事岗位CEXPOSITIONVRHAR2（0）行政职务CURMALARCHA2（10)Y目前顾客是实名还是虚拟,1:实名:虚拟CHNGETYPEVRCA2（20）修改类型，：ad,：modify，3：dleteHANGETMEVARR2(2)修改时间,格式如：1PRINCAIVARCHAR2(10）Y虚拟顾客:负责人唯一标记SEIDVARHAR2(1)虚拟顾客：使用人唯一标记RIIPAAMVRCHR（10)虚拟顾客:负责人姓名USRAEVARCAR(0)Y虚拟顾客：使用人姓名SECODEVARCHA(50)Y业务系统编号SYSEMNAEVACHAR2(00)Y业务系统名称.虚拟顾客:即临时顾客。涉及负责人和使用人两个属性，负责人必须从实名顾客中选择,使用人可以是多人，来自于文本填写,或者也可以提供选择非实名的顾客。具体信息如实名顾客表阐明2.2.5 门户部门数据源门户部门数据来自于OA流程。WebSei服务端服务地址:hp:/域名:8080/icpendin/srvices/DSIntracWberie?wsl服务参数：具体定义如下表ameTpNuale属性描述C_CDEVARCH2(0)N部门唯一标记C_NIAMEVARCAR2(200)部门全称C_AREUITVACR2（20)Y上级部门编码,真实的直属上级DERVRCHAR2(200)排序号，若无排序号写000UFORMLACHAR2()Y与否是临时部门:.正式.临时HANGETYPEVRCHAR2(10)N部门操作类型： 表达添加 2 表达修改 3 表达删除CHANGEIMEVARCHAR2(0）N修改时间，格式如：18DPTLEERRCHR(0）Y部门级别DPTLADEVACHAR2(100)部门领导UAK3VRCHR2(10)备用字段CUBA4VARCHR（10)Y备用字段CUAK5HAR2(1）Y备用字段CA6ARHA2(100)备用字段CUBA7VACH(100）Y备用字段2.2.6 同步顾客、部门到应用系统服务地址:http:/域名:808/jicendngsrve/IandingInterfeWbsic?wsl服务文献： 服务措施:措施. putDsDeptIfo：新增部门措施2 odfyDsepIf: 修改部门措施. eleteDsDenf:删除部门措施4. uDUsenfo：新增顾客措施5. modifUsrnfo：修改顾客措施6. deltDsUsno：删除顾客同步方式如 13.3 J2EE类应用系统顾客数据同步所述。/同步顾客sevieURLapen（htp：).apped(ur）.appd（:808/jicap/serices/DSInterfacebvie)； ty DInefaceWesrvice seric XfireClientFatorgCliet(serviURL.totrin（)，DSInterfaceWebervice.clss); / 新增顾客 DsUsrIfoVov new DUsrIfoV(）； vo.tCCo(); vo.setCe（); v.setCUntcod（); voseCUnitae（)； vosetCGender()； o.eCuidntitnur(); voseMail（); osetCexecosiionlevl（); vsetMobi(）; o.stelehoneumer(）; o.Phsildeiveryficenae(); osetCurdr()； v.seCupost（); vo.etCuxecosii(); vo.eChanetie（）; voetChangetye（); vosetCforal(）;/ v.etPrincipaid()；/ v.setTuserid();/ vo.stPrnipame();/ oseTuername（); vosetSysId(）; v.stSystemcod(); o.setSytee(）；/新增顾客 Strng addVa = serviceptDsUefo(vo）; ytem.out.pitln(新增顾客成功吗?:addValue)； /同步部门 StringBfeervceURL = nw tinuffer（)； sriURL.appe(http：/).appnd(ul).appn(：808/jicamp/sevcs/DSInterfaceebsvi); ty DSIntfaceWserviceservic = fieientFctory.geCent（eieURL.toString(）, DSIterfaceebervice.ss); Jicdptnfo jidepinfo ne cptno(); jicdetfo.eOd(10); jcetno.seCCoe(）; jicdeptinfsetCitname(); jicetino.etCarentuniti()； jicdepinsetCore()； jicdeptnfo.setCmal(); jiceptnfo.setChangetpe(); jicpinfo.seChneti(）;/ 新增部门 Stringe =service.uDsetIfo(jictif)； Syse.ut.ptln(新增部门成功吗?:ddVal);2.2.7 需要的其他服务这些服务提供的是验证顾客或修改密码的服务。如下:2.2.7.1 应用系统顾客认证服务:应用系统在单独访问自己系统的时候，调用门户系统提供的访问ldap接口,根据顾客登录ID，密码,所登录系统的标记，来判断该登录系统的顾客与否在，如果存在则登录成功,否则返回。lgini为顾客名,pwd为密码（密文)，sidentiy（系统标记)public StringrValae (Sig gini, Stringpwd,Sring ysideify)输出样例:返回值为true,则认证通过顾客，返回出错时,则根据返回的成果进行和谐提示。1提示顾客名不存在2.提示密码不对3.提示该顾客没有访问系统权限2.2.7.2 .门户密码修改服务:该服务提供修改门户系统密码功能,可以使用IBM的ii_x.war来实现这个功能。该功能会提供一张修改密码页面，只要输入门户系统顾客名、旧密码、新密码,则修改成功。2.2.7.3 验证应用系统顾客与否存在根据顾客登录ID，查询该顾客在ldap上与否存在,loinid为顾客名 pubic StrigsxisteInfo(Stingloiid）输出样例:返回值为rue,则存在此顾客，fals，则不存在此顾客。2.2.7.4 获取应用系统顾客信息根据顾客登录ID、系统标记取出顾客的信息, gnid为顾客名 ublic Srin etSpcifUseIf(Stig oginid， Strig ysinif)输出样例： geSpecifyUseInfo/meod code mesg成功/mesage user hnxiominami 1empnmbr 000/idify 管理员 1stemco1O系统 输出XM文献阐明mehd元素:解决操作的措施名cde元素:1(登录成功）、2(顾客已注销）3(顾客名或密码不对的) (系统标记错误）msage元素:登录阐明信息loginid元素: 登录名Enmer: 员工编号idntify元素: 身份证号sern元素：顾客姓名stats元素： 0（已注销)、1(已激活) syemcod元素：系统编号Sstenae元素： 系统名称Symr元素： 系统URL调用服务示例String endponthtp:/域名：9080/jicds/websricethencate.jws Sericsere = ew Srvic();Call call （Call) srvice.creaeCal（)；call.seTargetEnointAdres( nw jav.neUR(ndint)）；call.tOpeatonNme(etpecyUserInfo）;/填写要调用的措施名称btekey = x092?#8jx？sbageyts（);Sriget=(Srng) cll.invoke（nw Obect amin,ESFnctio.nycrptDes(888888,ky）);Syst.ut.rin( +rt);2.2.8 映射表设计和维护门户系统建立顾客映射对照关系采用如下的方式:1、顾客自助对照关系维护:员工可以在登录门户系统后,在门户系统中提供的页面上对个人已经集成的顾客映射进行维护,顾客可以根据实际工作状况修改个人在各应用系统中进行单点登录时使用的顾客角色，在通过应用系统提供的wbsevic接口校验信息对的性后,信息将写入对方应用系统顾客映射表，以便应用系统进行后续认证工作。业务流程如下：应用系统需按照如下方式提供信息验证返回信息: Wvie服务名服务名：eckUsrSrvc 公共接口定义Checkser解决验证顾客名及密码与否对的输入参数名称描述数据类型srame应用系统登录名户名StrngPsord应用系统登录密码Strg输出参数名称描述数据类型rsut返回字符串，0:失败 1:成功。Stg3 应用系统统一编码表规范定义:对于有英文简称的系统采用该英文简称，对于没有英文简称的系统，采用系统中文拼音首字母构成系统编码。对于本次门户的所有接口开发,如果波及到系统编码都必需遵循此编码表内系统编码定义。系统名称系统编码O系统oa邮件系统mailTRSCM系统wcmE系统eam
展开阅读全文