工作流（WorkflowService）WebService接口使用说明.doc

工作流（WorkflowService）是泛微协同办公系统中一个关键组件，它提供了通过WebService接口与外部业务系统进行数据交互的能力。本使用说明旨在详细介绍如何利用这些接口进行有效的流程管理和任务处理。 1. **检查部署是否成功** 要确认WorkflowService是否已成功部署，可以通过访问指定地址`http://192.168.4.183:8060/services/`（将IP和端口号替换为实际值）来查看服务列表。如果列表中包含了协同系统所提供的Web Service服务，即表示部署成功。 2. **接口功能介绍** - **流程创建接口**: 使用`doCreateWorkflowRequest`方法，传入`WorkflowRequestInfo`对象，包括用户ID、流程ID以及表单数据，返回新流程的requestid。若返回值小于0，表示创建失败，具体错误代码如-1表示创建失败，-2表示无创建权限等。 - **流程流转控制接口**: - `submitWorkflowRequest`: 提交流程，传入请求信息对象、请求id、提交人ID、提交类型和意见，返回布尔值表示操作成功与否。 - `nextNodeByReject`: 退回流程，传入请求id、提交人ID和退回意见，返回布尔值表示操作成功与否。 - `forwardWorkflowRequest`: 转发流程，传入请求id、接收人ID、转发意见、用户ID和客户端IP地址，返回布尔值表示操作成功与否。 - **任务列表接口**: - `getToDoWorkflowRequestCount`: 获取用户待办任务数量，根据用户ID和查询条件。 - `getToDoWorkflowRequestList`: 获取用户待办任务列表，支持分页和查询条件，返回`WorkflowRequestInfo`数组。 - `getProcessedRequest`: 获取已归档任务列表，同样支持分页和查询条件，返回归档任务的基本信息。 - **表单数据接口**: - `getRequest`: 根据请求requestid获取表单数据，返回`RequestInfo`对象。 - **其他接口**: - `getRejectRequestCount`: 获取已归档任务数量。 - `getAllWorkflowRequestCount`: 获取所有可用流程数量。 - `getAllWorkflowRequestList`: 获取所有可用流程列表，支持分页和查询条件。 3. **使用步骤** - 在业务系统中创建Web Service本地代理，以调用协同系统的接口。 - 调用`doCreateWorkflowRequest`创建新流程，处理流程创建相关的异常。 - 根据需求调用流程流转控制接口，如提交、退回或转发任务，并处理相应结果。 - 使用`getToDoWorkflowRequestCount`和`getToDoWorkflowRequestList`获取待办任务并展示给用户。 - 通过`getProcessedRequest`获取已归档任务，以便于数据分析和历史记录查看。 - 通过`getRequest`获取任务的表单数据，以供用户处理和查看。 - 定期同步任务状态和更新数据，确保业务系统与协同系统的数据一致性。 在实际应用中，业务系统开发者需要根据自身系统的需求，结合上述接口提供的功能，进行接口调用和逻辑处理，以实现与泛微工作流系统的无缝集成，提升工作效率并优化业务流程。同时，需要注意错误处理和异常捕获，确保系统的稳定性和用户体验。