一个完整的接口技术解决方案(八)

 题注: 
      发表这篇解决方案,属于非盈利目的。主要是为了让大家了解一种接口技术解决方案文档的编写格式以及让大家评审在我的这个技术解决方案中的不足之处,以便大家指出并加以改进。 
      转载,下载或与各种形式使用这篇文章,必须注明文章的作者,出处。 
      其他未尽事宜,以国家法律规定的为准! 
                     作者:南疯

10       网页地址

u       外协系统Web Service测试地址(ENI内网)

http://xxx.xxx.xxx.xxx/PECS_CONSTRUCTION_INTERFACE/INTERFACE.ASMX

u       WSDL文档地址:

http://xxx.xxx.xxx.xxx/PECS_CONSTRUCTION_INTERFACE/INTERFACE.ASMX?WSDL

u       外协系统正式使用地址:

待定。

u       施工系统Web Service测试地址(ENI内网)

 

u       施工系统正式使用地址:

 

11       Web Service接口

11.1    接口命名规范

对于业务数据,根据前面的表英文名,接口名称全部是大写。如果:

u       前面带有 QUERY_ 的,表示对这个表进行查询并下载记录。

比如:UPDATE_ BEGINWORKREPORT 表示对开工报告进行进行查询并下载记录

u       前面带有 UPDATE_ 的,表示对这个表进行新增或者修改记录。

比如:UPDATE_ BEGINWORKREPORT 表示对开工报告进行新增或修改记录

u       施工系统接受外协系统发送的变更字典信息接口为:UPDATE_DICTIONARY

u       前面带有 DELETE_ 的,表示对这个表进行删除记录。

比如:DELETE _ BEGINWORKREPORT 表示对开工报告进行删除记录

u       其他的外协系统特别提供的接口命名,请见后面的11.4

11.2    输入参数

所有的接口都仅仅接受一个参数,参数变量名为:strXML,文本类型

11.3    输出参数

所有的接口都返回文本数据类型的数据,接受返回值的客户端变量由客户端自行定义。

 

 

 

 

 

 

11.4    外协系统提供的其他接口

外协系统特别提供的Web Service接口名(注意:不全部是大写)(参数遵循前面的规则):

接口名称

GetFileInfo

获得文档的基本信息

GetFileInfoWithBrother

获得文档的基本信息(带有所有的兄弟记录)

GetFileInfoWithParent

获得文档的基本信息(带有所有的父亲记录)

UploadFile

上传文档

DeleteFile

删除文档

GetDictionary

获得字典信息

 

 

 

 

 

 

 

12          附录:待定问题

 

posted @ 2006-11-04 19:28 南疯 阅读(735) 评论(2)  编辑 收藏

  回复  引用    
#1楼 2006-11-05 14:11 | henry[匿名] [未注册用户]
这样制定WS接口不归范吧?
应该采用WSDL来描述WS接口,这样对不同平台来说就更合理.
  回复  引用  查看    
#2楼 [楼主]2006-11-05 19:10 | 南疯      
@henry[匿名]
你的提议不错。但是我考虑我已经给出了wsdl的地址,做技术的人应该能够从wsdl文档中看到不同接口之间的各种声明。
不知道这样考虑是否正确。如果有进一步的建议,万望毋吝惜给与指教!

标题  
姓名  
主页
Email (博主才能看到) 
验证码 *  看不清,换一张 [登录][注册]
内容(请不要发表任何与政治相关的内容)  
  博客园首页

  新闻频道

  社区

  小组

  博问

  网摘

  闪存

  登录  使用高级评论  新用户注册  返回页首  恢复上次提交      


相关链接: