WorkflowService Web服务接口使用指南.doc

简介：
本文档提供关于如何利用WorkflowService Web服务接口进行高效集成和应用开发的全面指导与示例。它是理解和掌握WorkflowService功能的关键资源。 工作流（WorkflowService）是泛微协同办公系统中的一个关键组件，它提供了通过WebService接口与外部业务系统进行数据交互的能力。本使用说明旨在详细介绍如何利用这些接口实现有效的流程管理和任务处理。 1. **检查部署是否成功** 确认WorkflowService是否已成功部署的方法为访问指定地址（替换实际的IP和端口号）`http:192.168.4.183:8060services`，查看服务列表。如果列表中包含了协同系统所提供的Web Service服务，则表示部署成功。 2. **接口功能介绍** - **流程创建接口**：使用`doCreateWorkflowRequest`方法，传入包含用户ID、流程ID以及表单数据的`WorkflowRequestInfo`对象，返回新流程的requestid。若返回值小于0，表示创建失败；具体错误代码如-1表示创建失败，-2表示无创建权限等。 - **流程流转控制接口**： - `submitWorkflowRequest`: 提交流程请求时使用该方法，传入请求信息对象、请求ID、提交人ID、提交类型和意见，返回布尔值以指示操作是否成功。 - `nextNodeByReject`: 使用此方法退回流程，需提供请求ID、提交人ID及退回意见。同样地，它会返回一个布尔值表示操作结果。 - `forwardWorkflowRequest`: 转发流程时使用该接口，传入请求id、接收人ID、转发意见以及用户和客户端的IP地址信息作为参数，并得到一个指示成功与否的布尔响应。 - **任务列表接口**： - `getToDoWorkflowRequestCount`：根据指定条件获取用户的待办事项数量。 - `getToDoWorkflowRequestList`: 根据分页及查询条件，返回包含用户待处理请求详情的数组。 - `getProcessedRequest`: 获取归档的任务列表，同样支持通过分页和特定筛选器来检索。 - **表单数据接口**： - `getRequest`：根据requestid获取表单的数据信息，并以对象形式返回结果。 - **其他接口** - `getRejectRequestCount`：用于计数已拒绝的请求。 - `getAllWorkflowRequestCount`: 获取所有可用流程的数量 - `getAllWorkflowRequestList`: 支持分页和查询条件，获取所有可用的工作流列表 3. **使用步骤** - 在业务系统中创建Web Service本地代理以调用协同系统的接口； - 使用`doCreateWorkflowRequest`方法建立新工作流，并处理流程创建过程中可能出现的异常情况。 - 根据实际需求利用提交、退回和转发任务等操作，同时注意检查每个请求的结果状态。 - 利用`getToDoWorkflowRequestCount`及 `getToDoWorkflowRequestList`接口获取待办事项并展示给用户； - 通过调用`getProcessedRequest`来访问已归档的任务列表以进行数据分析或历史记录查看； - 使用`getRequest`根据requestid检索表单数据，供处理和查阅。 - 定期同步任务状态及更新信息确保业务系统与协同系统的数据一致性。 在实际应用中，开发者需结合自身需求以及上述接口的功能来实现集成，并通过适当的错误处理机制保证整个系统的稳定性和用户体验。