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

e-cology工作流接口使用说明-1-e-cology工作流接口使用白皮书SUBMITEDBYWEAVERe-cology工作流接口使用说明-2-文档版本历史变更序号日期版本文件变更申请编号变更说明修改人12007年5月23日V1.0无新文件张小丰22010年7月20日V2.0无修改周定勇32010年9月25日V3.0无修改周定勇e-cology工作流接口使用说明-3-目录一、前言...................................................................................................................................................................41.1编写目的....................................................................................................................................................41.2名词定义....................................................................................................................................................4二、接口调用步骤....................................................................................................................................................52.1Ecology系统流程接口部署......................................................................................................................52.2表单字段....................................................................................................................................................52.3检查ecologywebservice是否已部署......................................................................................................62.4接口方法概述............................................................................................................................................72.5流程相关对象说明.................................................................................................................................102.6生成客户端.............................................................................................................................................15三、示例程序.........................................................................................................................................................193.1创建带附件的留言..................................................................................................................................193.2使用客户端代理创建留言......................................................................................................................193.3使用客户端查询留言.............................................................................................................................223.4使用客户端实现流程转发......................................................................................................................233.5使用客户端实现流程提交......................................................................................................................243.6使用客户端实现流程退回......................................................................................................................253.7使用客户端获得待办列表......................................................................................................................253.8使用客户端获得已办列表......................................................................................................................263.9使用客户端获得办结列表......................................................................................................................273.10使用客户端获得我的请求列表............................................................................................................28e-cology工作流接口使用说明-4-一、前言1.1编写目的本文给有研发能力的客户或有系统集成需求的客户提供webservice接口调用的参考例程。本文的面向具有一定webservice开发能力或了解webservice技术的开发人员。1.2名词定义1、Axis：著名的开源webservice引擎。2、外部系统：指调用或实现e-cology工作流输入输出接口，与e-cology系统进行数据交接的其他系统。e-cology工作流接口使用说明-5-二、接口调用步骤2.1Ecology系统流程接口部署1.更新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文件2.修改/WEB-INF/web.xml文件在相应处增加servlet部署（参考系统中已有很多servlet部署），加入如下描述servletservlet-nameXFireServlet/servlet-nameservlet-classorg.codehaus.xfire.transport.http.XFireConfigurableServlet/servlet-class/servletservlet-mappingservlet-nameXFireServlet/servlet-nameurl-pattern/services/*/url-pattern/servlet-mapping注意：不要添加在注释中（即以“!—”开始至“--”结束为注释）！3.修改/classbean/META-INF/xfire/services.xml文件，增加红色部分描述beansxmlns=://localhost/services/DocService/namespaceserviceClassweaver.docs.webservices.DocService/serviceClassimplementationClassweaver.docs.webservices.DocServiceImpl/implementationClass/serviceservicenameRequestService/namenamespace表单字段在确定调用webservice接口之前需要在ecology系统中设计好表单,记下表单字段名（主字段和明细字段），在调用接口的时候需要用到。字段名在‘工作流程-表单管理-编辑字段’菜单中可以查到，如下图所示为留言表单的字段列表：e-cology工作流接口使用说明-6-2.3检查ecologywebservice是否已部署在浏览器中输入应显示如下页面：点击RequestService后面的wsdl链接应出现如下页面：e-cology工作流接口使用说明-7-wsdl具体描述文件如下：如果未出先上述页面，则webservice未部署成功，请与泛微项目人员联系。2.4接口方法概述名称参数返回值功能描述createRequestRequestInforequestinfo：请求信息对象String：新流程的requestid如果小于0表示失败-1：创建流程失败-2：用户没有流程创建权限-3：创建流程基本信息失败-4：保存表单主表信息失败-5：更新紧急程度失败-6：流程操作者失败-7：流转至下一节点失败根据请求信息对象创建一条新的流程e-cology工作流接口使用说明-8--8：节点附加操作失败getMyReq