e-cology工作流Web Service接口使用说明.doc

文档版本历史 变更序号 日期 版本 文件变更 申请编号 变更说明 修改人 1 2007年5月23日 V1.0 无 新文件 张小丰 2 2010年7月20日 V2.0 无 修改 周定勇 3 2010年9月25日 V3.0 无 修改 周定勇 目 录 一、前言 4 1.1编写目的 4 1.2名词定义 4 二、接口调用步骤 5 2.1 Ecology系统流程接口部署 5 2.2表单字段 5 2.3检查ecology web service是否已部署 6 2.4接口方法概述 7 2.5 流程相关对象说明 10 2.6 生成客户端 15 三、示例程序 17 3.1创建带附件的留言 17 3.2 使用客户端代理创建留言 17 3.3 使用客户端查询留言 20 3.4 使用客户端实现流程转发 21 3.5 使用客户端实现流程提交 22 3.6 使用客户端实现流程退回 23 3.7 使用客户端获得待办列表 23 3.8 使用客户端获得已办列表 24 3.9 使用客户端获得办结列表 25 3.10 使用客户端获得我的请求列表 26 一、前言 1.1编写目的 本文给有研发能力的客户或有系统集成需求的客户提供web service接口调用的参考例程。本文的面向具有一定web service开发能力或了解web service技术的开发人员。 1.2名词定义 1、Axis： 著名的开源web service引擎。 2、外部系统： 指调用或实现e-cology工作流输入输出接口，与e-cology系统进行数据交接的其他系统。 二、接口调用步骤 2.1 Ecology系统流程接口部署 更新lib目录下文件 将spring.jar更新为spring-1.2.6.jar 将xfire-all-1.1.2.jar更新为xfire-all-1.2.6.jar 添加xbean-spring-2.8.jar文件 修改/WEB-INF/web.xml文件 在相应处增加servlet部署（参考系统中已有很多servlet部署），加入如下描述 servlet servlet-nameXFireServlet/servlet-name servlet-classorg.codehaus.xfire.transport.http.XFireConfigurableServlet/servlet-class /servlet servlet-mapping servlet-nameXFireServlet/servlet-name url-pattern/services/*/url-pattern /servlet-mapping 注意：不要添加在注释中（即以“!—”开始至“--”结束为注释）！ 修改/classbean/META-INF/xfire/services.xml文件，增加红色部分描述 beans xmlns=/config/1.0 service nameDocService/name namespacehttp://localhost/services/DocService/namespace serviceClassweaver.docs.webservices.DocService/serviceClass implementationClassweaver.docs.webservices.DocServiceImpl/implementationClass /service service nameRequestService/name namespacehttp://localhost/services/RequestService/namespace serviceClassweaver.soa.workflow.request.RequestService/serviceClass /service /beans 2.2表单字段 在确定调用web service接口之前需要在ecology系统中设计好表单, 记下表单字段名（主字段和明细字段），在调用接口的时候需要用到。字段名在‘工作流程-表单管理-编辑字段’菜单中可以查到，如下图所示为留言表单的字段列表： 2.3检查ecology web service是否已部署 在浏览器中输入http://ecologyServer/services,应显示如下页面： 点击RequestService后面的wsdl链接应出现如下页面： wsdl具体描述文件如下： 如果未