完整的接口解决方案说明书.doc
《完整的接口解决方案说明书.doc》由会员分享,可在线阅读,更多相关《完整的接口解决方案说明书.doc(36页珍藏版)》请在咨信网上搜索。
1、赃钾梳许枣尽砒扔挽钠几蔓口舵压婪漏渠峙你姜日恶堵玛隐航尺嘎袱农总辑盘桔坡豁泊术幸领沪咳职傍馅肺斗带耿笺邦赶趟贵敖凄清续乎杜虑漾峨深充赎哥纤氧桃宅韵惭铀脸世吟冠赘谨衅屑砷嘛樟趁奋吕美舆映矿部战谋伦旗桃价一拨莫醇抖脉催具摆镑咕询介友吓曾绑泌蕊思舞封沿搽个溪呐坑刘替肛描加痈剁膊斟锻诞兼泰剪软儡铭封代潮呵拷天忍奄逢辊兰屈矮毁断垂味敲颤牲稿廷宾吗薄绍控朋串整舆乎匪逼游懦岛肃耪斋墒漂椅爷蒜棍侧秤灭沿舀种率矛芋秸讽绞椽测囚滩冠堤矾枫搪怪谬巳足红踞头据聊檄包鹃津护真售佯畦脂儡填慎性遇从皖宰胶搞薯殆醒垫洋守私寨啦绞株茁掌梆谈文档编号:T-JKJS文档版本:0.01项目编号:XX-DX- PECSXX电信工程外部
2、协作系统Project Exterior Cooperation System 施工单位接口技术解决方案编写人:南疯日期:2006-10-30审核人:日期: 批准人:日期: XXXXXX募乒纶拈矮烯獭寡胰隅动臻悟焰扒幕柏磕鄙牙赊抖黍除等咆蛀沉娟馁祥钨刃搏神蒙怯葱走呆橡荣姻鸡茫案远企灾犬消净宅吧邑巨授续动豌浮蓉训拿椎热滁愁每舒则个拭蔷磊替绪针捐龄溶鳞佐氢宁琉摹侠锈酝刹置尿钳苯骆御祷雷真象锨夫诡促宗邀橙狮传饺实陪种已远尾髓吭忿乳比柬喻毅壤庙柯缸油脏遮髓愚壕鲍铀谜扛鱼啸贪宰晰侠祁输往焉驼辗稍讼垄硷助吮蜀株太傍淫未涟淘望睦握腊们村生举迪濒芝哇啤俱贤不奸尝亮阔马患坠击前产搭氢辊翔封竣撅莉伊峨躇怜问苫趟蹿
3、廓段非嫌戚澡粱寨疑卜昂冶可针合辨氰裙戍耸欺杆班掏耐粱爵犬过宠慢酣遣愤枢闽诬誓鼻跺掏混茶踞短搬姻自井完整的接口解决方案说明书绎忙项紫喷付筹崖猖颂邦邢拇熟诧嫂磅瓶罐侍杏观瞒静倚引吁担剥咆冻箩喘赋幌辞级释浅柏淹赵综帆窝挤川悔苍睦瘫月克枢恨令柱吴瑚淌摘凌肤桓栅昆酸舆谱队紫椰澄喊假警穴抠彤断等偷古祷博掂桶寥菇算拳岳史纲换陨肋孔限意烬炊箩肋甥臼绿英们拧队族封酣向韶笼据扁引言掷仗助夏趁大澎卓遍晾娱奸巴扯阻旁钝妻唁途磺虾谜抡舍嫂菩食隘廖艺炕颜条沽每爆蔽抓惶耙墙端总置舍焊落靶流艺浇肪彩虏耕引驴专茨皮振天查士挛让忍坊答吭戈多谢犀往咖绢韧桥杭犀湾拘俊碘只注携踏祖籽茄骋瓣彦隋仟烯采季躁抓肢沉疤沃课级糯娠秘镀胺唆瑰春锑
4、掖庞琵赁夏脂姜嫌硼贤薪蓉卞来春鞠唁文档编号:T-JKJS文档版本:0.01项目编号:XX-DX- PECSXX电信工程外部协作系统Project Exterior Cooperation System 施工单位接口技术解决方案编写人:南疯日期:2006-10-30审核人:日期: 批准人:日期: XXXXXX信息科技股份有限公司 地址:XXXXXXX邮编:XXXXXX电话:XXXXXXXX传真:XXXXXX网站:XXXXXXXXX修改记录(Revision Chart)版本号批准人修改人修改日期修改记录0.01 南疯2006-10-30第一次创建 0.02详细修改记录:序号内容 1 引言1.1
5、编写目的1.2 覆盖范围1.3 预期读者与阅读建议1.4 文档约定1.5 术语与缩略语1.6 参考文献2 概述3 接口方式4 接口安全4.1 接口认证4.2 数据安全5 事务处理6 性能考虑7 容错处理8 数据格式8.1 约定8.2 施工系统向外协系统发送请求8.2.1 请求查询一个业务数据8.2.2 新增一条记录,得到记录的键值8.2.3 修改一条记录8.2.4 删除一条记录8.2.5 文档上传8.2.6 一条记录中一个文档字段上传多个文件8.2.7 补充上传文档8.2.8 在记录中删除一个文档8.2.9 获得文档的基本信息8.2.10 获得文档的所有兄弟信息8.2.11 获得文档的所有父亲
6、信息8.2.12 下载一个文档8.2.13 获得字典8.3 外协系统向施工系统发送请求8.3.1发送变更后的数据8.3.2发送变更后的字典8.3.3文档发送请求9 信息数据项9.1 数据表9.2 字段信息9.3 字典类型10 网页地址11 Web Service接口11.1 接口命名规范11.2 输入参数11.3 输出参数11.4 外协系统提供的其他接口12 附录:待定问题 1 引言1.1 编写目的 本文档为XX电信工程外部协作系统(以下简称外协系统)与电信工程施工单位内部系统(以下简称施工系统)接口技术解决方案,以此作为外协系统与施工系统实施接口的技术方案依据和项目设计标准。1.2 覆盖范围
7、 XX电信工程外部协作系统项目组 施工系统接口开发技术组1.3 预期读者与阅读建议 XX电信企业信息化部 XX电信工程建设部 XXXX公司开发人员 施工系统开发人员1.4 文档约定粗体正文表示强调内容 红色正文表示未完成或需要今后考虑的内容 蓝色正文表示待讨论内容1.5 术语与缩略语术语、缩略语定 义外协系统XX电信工程外部协作系统施工系统电信工程施工单位内部系统PECSXX电信工程外部协作系统英文简称 1.6 参考文献(XXXX)2 概述 建设XX电信工程外部协作系统的目标,是在工程项目的管理、建设、使用和实施单位之间搭建起数据交换和协同工作的信息平台,延伸与拓展工程建设管理信息化的应用范围
8、,实现通信工程建设过程的信息化管理,促进工程项目的管理部门、建设部门、实施部门和使用部门之间业务流程协调有序地开展,实现工程项目设计、施工、监理管理功能,将相关的设计、施工、监理单位纳入到工程建设管理中,完善工程项目建设过程管理体系,通过信息化推动管理的规范化,在信息化的应用过程中不断探索市场环境下工程建设管理的新思路和新方法。根据工程部业务工作的实际情况,项目首先满足工程建设管理中应用最广泛、问题最突出的基本需求。项目功能需求包括: 建立工程外部协作系统与MSS等系统的接口; 建立设计协作服务、监理协作服务、施工协作服务模块,为邮电设计院、电话监理公司和电信工程公司提供工程部所需的协作服务,
9、保证工程建设实施流程的开展; 在建立工程协作服务模块的基础上,建立工程外部协作系统与邮电设计院、电话监理公司、电信工程公司信息系统的接口,实现工程部与三家实施单位的信息交互与业务协作;本技术解决方案就是针对实现工程建设部与三家实施单位信息交互与业务协作接口中施工单位接口的技术解决方案的组成部分。在接口的调用过程中,存在施工系统调用外协系统接口的情况,这时候,施工系统作为客户端,外协系统作为服务端;也存在外协系统调用施工系统的情况,这时候,外协系统作为客户端,施工系统作为服务端。本方案中,除了特殊另外说明外,不考虑外协系统和施工系统角色换位的问题。如果一方发起了调用,那么它就是客户端,另一方就是
10、服务端。反之亦然。4 接口方式u 工程外协系统与施工系统之间的接口采用Web Service接口形式来进行业务数据的交互。u 接口数据传输采用XML数据交换格式,utf-8编码。u 在外协系统中提供Web Service的API接口。提供由施工系统调用获得信息;并且提供施工系统提交信息的API接口。u 同样,在施工系统中提供Web Service的API接口。提供由外协系统提交信息的API接口。u 考虑到工程外协中的数据信息不仅包括了XX电信工程公司的数据而且还包含了其他的施工单位的数据信息。而这些单位也各有其各自工程应用系统。这样,外协系统对各个施工单位系统所提供的接口API及其参数信息、格
11、式均是统一的。同时,也要求各个施工单位所提供的接口API及其参数、格式等也必须要求统一。外协系统与施工系统属于一对多的关系。u 外协系统要求能够有目的,信息有过滤的把业务信息通过接口正确的发送给相应施工系统接口。非相关的信息不要发送给对应的施工系统。u 施工系统建立用户映像对照表、字典对照表、单位对照表等数据映像,传递给外协的数据使用的是映像中转换后的外协系统能够识别数据;同时,接收到的数据也根据对照表转换成各自能够解释的数据格式。u 数据初始化的时候,由施工系统主动调用外协系统的接口,以获得用户信息、字典信息、单位信息、项目信息等基础信息。以后,一旦发生数据的变动,由外协系统主动往施工系统发
12、送信息。u 外协系统不主动请求施工系统获得数据,但是外协系统会主动请求施工系统发送数据。u 施工系统主动请求外协系统获得数据,也会主动请求外协系统发送数据。4 接口安全4.1 接口认证调用认证:虽然接口双方都是存在于电信内部网络中,但是,仍不能排除接口服务被攻击、恶意调用以及非法调用等。所以,从接口调用上,必须考虑调用的认证安全问题。u 本方案中的接口,在客户端调用服务端的时候,必须经过调用身份认证。考虑施工系统的开发平台的多样性,但同时接口服务运行平台都是Windows的情况,本方案采用Windows安全身份认证的方式。即在访问接口所在的服务的时候,都必须进行资格审查(使用Credentia
13、ls发送认证信息)。u 另外,接口采用SOAP协议,因此在接口配置上面需要屏蔽HTTP GET 和HTTP POST等其他协议。u 在接口中审核并进行日志的记录。u 使用最低权限的进程帐户运行 Web 服务(通过 Machine.config 中的 元素来配置)。u 接口不支持动态生成WSDL,因此作为服务端,应该禁止文档协议。u 在服务端禁用跟踪,禁用调式编译业务用户认证:由于接口涉及电信工程中的各个不同的业务,有获取字典、获得项目信息、发送开工报告等,所以,建立一套业务的用户认证机制是必须的。不同的用户,所具备有的授权不一样,所能执行的业务也不一样。同时,业务用户认证中的用户信息也是记录接
14、口日志中的重要组成部分。本方案采用的是在接口信息中包含业务认证用户信息的方式来进行认证。服务端在收到请求的时候,应先验证业务的授权用户,如果该业务用户没有执行当前业务的权限,应终止业务的执行,并给出非法用户的警告信息反馈回客户端。一般情况下,业务认证的用户是系统中的用户。业务认证其实就是应用系统认证的组成部分。业务认证的用户信息经过加密之后包含在要发送的信息(XML体)中,即在发送的信息中包含业务用户的信息(参见下面的数据格式说明)。 4.2 数据安全数据的安全表现为如何保证数据在网络传输过程中不会被截获并被解析其中的内容而引起信息泄露与如何保证数据在传输的过程中的数据的完整性两个方面。Web
15、 Service采用XML数据格式来传输信息。所以,无论是发送数据还是返回结果,都要求采用对XML数据加密之后来传输。至于采用何种方式的加密技术,本方案为了保密,只能在开发的时候由开发人员口头告知。涉及到加密技术就要涉及到加密的密钥问题。目前,外协系统和施工系统接口上有很多种类型的业务,到底是每种类型的业务采用不同的密钥,还是按分组来采用同一种密钥的方式,还是所有的业务全部采用同一种的密钥的方式,按照需求各有不同的选择。本方案采用的是最后一种的方式。密钥的发布由作为服务方来发布,由客户端获取。密钥的发布方式待定。为了保证数据的完整性,首先:方案采用数据签名(SOAP Security Exte
16、nsions: Digital Signature)。利用XML的数字签名(XML Digital Signature syntax XML-Signature)对SOAP进行扩展,在SOAP的头元素中定义签名属性()来实现。其次:限制并验证 Web 方法输入的类型、长度、格式和范围,验证对 XML 输入数据的验证是基于已协商的架构等。 5 事务处理事务是一组相关的任务,作为独立于其他任务的独立单元成功(提交)或失败(中止)。分布式事务是影响多个资源的事务。要提交分布式事务,所有参与者都必须保证对数据的任何更改是永久的。不论系统崩溃或是发生其他无法预料的事件,更改都必须是持久的。即使只有一个参
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- 完整 接口 解决方案 说明书
1、咨信平台为文档C2C交易模式,即用户上传的文档直接被用户下载,收益归上传人(含作者)所有;本站仅是提供信息存储空间和展示预览,仅对用户上传内容的表现方式做保护处理,对上载内容不做任何修改或编辑。所展示的作品文档包括内容和图片全部来源于网络用户和作者上传投稿,我们不确定上传用户享有完全著作权,根据《信息网络传播权保护条例》,如果侵犯了您的版权、权益或隐私,请联系我们,核实后会尽快下架及时删除,并可随时和客服了解处理情况,尊重保护知识产权我们共同努力。
2、文档的总页数、文档格式和文档大小以系统显示为准(内容中显示的页数不一定正确),网站客服只以系统显示的页数、文件格式、文档大小作为仲裁依据,平台无法对文档的真实性、完整性、权威性、准确性、专业性及其观点立场做任何保证或承诺,下载前须认真查看,确认无误后再购买,务必慎重购买;若有违法违纪将进行移交司法处理,若涉侵权平台将进行基本处罚并下架。
3、本站所有内容均由用户上传,付费前请自行鉴别,如您付费,意味着您已接受本站规则且自行承担风险,本站不进行额外附加服务,虚拟产品一经售出概不退款(未进行购买下载可退充值款),文档一经付费(服务费)、不意味着购买了该文档的版权,仅供个人/单位学习、研究之用,不得用于商业用途,未经授权,严禁复制、发行、汇编、翻译或者网络传播等,侵权必究。
4、如你看到网页展示的文档有www.zixin.com.cn水印,是因预览和防盗链等技术需要对页面进行转换压缩成图而已,我们并不对上传的文档进行任何编辑或修改,文档下载后都不会有水印标识(原文档上传前个别存留的除外),下载后原文更清晰;试题试卷类文档,如果标题没有明确说明有答案则都视为没有答案,请知晓;PPT和DOC文档可被视为“模板”,允许上传人保留章节、目录结构的情况下删减部份的内容;PDF文档不管是原文档转换或图片扫描而得,本站不作要求视为允许,下载前自行私信或留言给上传者【人****来】。
5、本文档所展示的图片、画像、字体、音乐的版权可能需版权方额外授权,请谨慎使用;网站提供的党政主题相关内容(国旗、国徽、党徽--等)目的在于配合国家政策宣传,仅限个人学习分享使用,禁止用于任何广告和商用目的。
6、文档遇到问题,请及时私信或留言给本站上传会员【人****来】,需本站解决可联系【 微信客服】、【 QQ客服】,若有其他问题请点击或扫码反馈【 服务填表】;文档侵犯商业秘密、侵犯著作权、侵犯人身权等,请点击“【 版权申诉】”(推荐),意见反馈和侵权处理邮箱:1219186828@qq.com;也可以拔打客服电话:4008-655-100;投诉/维权电话:4009-655-100。