完整的接口解决方案说明书VIP免费

文档编号：T-JKJS文档版本：0.01项目编号：XX-DX-PECS《XX电信工程外部协作系统》ProjectExteriorCooperationSystem施工单位接口技术解决方案编写人：南疯日期：2006-10-30审核人：日期：批准人：日期：XXXXXX信息科技股份有限公司地址：XXXXXXX邮编：XXXXXX电话：XXXXXXXX传真：XXXXXX网站：XXXXXXXXX修改记录（RevisionChart）版本号批准人修改人修改日期0.01南疯2006-10-300.02详细修改记录：序号1引言1.1编写目的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获得文档的所有父亲信息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网页地址11WebService接口11.1接口命名规范11.2输入参数11.3输出参数11.4外协系统提供的其他接口12附录：待定问题1引言1.1编写目的本文档为XX电信工程外部协作系统（以下简称外协系统）与电信工程施工单位内部系统（以下简称施工系统）接口技术解决方案，以此作为外协系统与施工系统实施接口的技术方案依据和项目设计标准。1.2覆盖范围XX电信工程外部协作系统项目组施工系统接口开发技术组1.3预期读者与阅读建议XX电信企业信息化部XX电信工程建设部XXXX公司开发人员施工系统开发人员1.4文档约定粗体正文表示强调内容红色正文表示未完成或需要今后考虑的内容蓝色正文表示待讨论内容1.5术语与缩略语术语、缩略语定义外协系统XX电信工程外部协作系统施工系统电信工程施工单位内部系统PECSXX电信工程外部协作系统英文简称1.6参考文献(XXXX)2概述建设XX电信工程外部协作系统的目标，是在工程项目的管理、建设、使用和实施单位之间搭建起数据交换和协同工作的信息平台，延伸与拓展工程建设管理信息化的应用范围，实现通信工程建设过程的信息化管理，促进工程项目的管理部门、建设部门、实施部门和使用部门之间业务流程协调有序地开展，实现工程项目设计、施工、监理管理功能，将相关的设计、施工、监理单位纳入到工程建设管理中，完善工程项目建设过程管理体系，通过信息化推动管理的规范化，在信息化的应用过程中不断探索市场环境下工程建设管理的新思路和新方法。根据工程部业务工作的实际情况，项目首先满足工程建设管理中应用最广泛、问题最突出的基本需求。项目功能需求包括：Ø建立工程外部协作系统与MSS等系统的接口；Ø建立设计协作服务、监理协作服务、施工协作服务模块，为邮电设计院、电话监理公司和电信工程公司提供工程部所需的协作服务，保证工程建设实施流程的开展；Ø在建立工程协作服务模块的基础上，建立工程外部协作系统与邮电设计院、电话监理公司、电信工程公司信息系统的接口，实现工程部与三家实施单位的信息交互与业务协作；本技术解决方案就是针对实现工程建设部与三家实施单位信息交互与业务协作接口中施工单位接口的技术解决方案的组成部分。在接口的调用过程中，存在施工系统调用外协系统接口的情况，这时候，施工系统作为客户端，外协系统作为服务端；也存在外协系统调用施工系统的情况，这时候，外协系统作为客户端，施工系统作为服务端。本方案中，除了特殊另外说明外，不考虑外协系统和施工系统角色换位的问题。如果一方发起了调用，那么它就是客户端，另一方就是服务端。反之亦然。4接口方式u工程外协系统与施工系统之间的接口采用WebService接口形式来进行业务数据的交互。u接口数据传输采用XML数据交换格式，utf-8编码。u在外协系统中提供WebService的API接口。提供由施工系统调用获得信息；并且提供施工系统提交信息的API接口。u同样，在施工系统中提供WebService的API接...