泛微OA 工作流WebService接口使用说明.doc

工作流WebService接口使用说明一、检查部署是否成功:输入下面的地址83(换成实际的地址):8060(实际的端口号)/services/,界面中有如下服务即可:采用Web Serverice技术进行协同系统和业务系统进行数据交互，由协同系统方开发实现Web Serverice服务，业务系统方需在本地实现Web Serverice本地代理来进行调用。协同系统方需提供的服务接口如下：1、 流程创建接口2、 流程流转控制接口提供流程提交，退回和转发控制接口3、 需业务系统处理的任务列表根据用户id和流程id获取该人员需要业务系统处理的任务列表，如果需要获取表单的数据在通过reqestid调用获取表单数据接口4、 获取表单数据接口根据协同系统中流程主键requestid获取表单中所有数据5、 已归档任务列表根据创建人id和流程id获取已经归档的任务列表2.2.2接口说明接口名称参数说明返回值功能描述创建新流程：doCreateWorkflowRequestWorkflowRequestInfowri：请求信息对象userId:用户idString：新流程的requestid如果小于0表示失败-1：创建流程失败-2：用户没有流程创建权限-3：创建流程基本信息失败-4：保存表单主表信息失败-5：更新紧急程度失败-6：流程操作者失败-7：流转至下一节点失败-8：节点附加操作失败根据请求信息对象创建一条新的流程，请求信息对象中需包含创建人、创建流程id和表单的数据代办数量:getToDoWorkflowRequestCountint userId:用户idString conditions:查询流程的条件,为字符串数组Int:代办的数量返回满足条件的用户可以得到的代办数目代办列表：getToDoWorkflowRequestListint pageNo:当前页数int pageSize:每页的分页数量int recordCount:总行数int userId:用户idString conditions:查询流程的条件,为字符串数组类型WorkflowRequestInfo ：请求基本信息列表根据参数条件获取需处理任务列表排除创建节点任务归档数目:getRejectRequestCountint userId:用户idString conditions:查询流程的条件,为字符串数组Int:归档的数量归档任务：getProcessedRequestint pageNo:当前页数int pageSize:每页的分页数量int recordCount:总行数int userId:用户idString conditions:查询流程的条件,为字符串数组类型WorkflowRequestInfo ：请求基本信息列表根据参数条件获取归档任务列表表单数据：getRequestint requestId：请求requestidRequestInfo：请求信息对象根据流程requestid获得表单数据流程提交：submitWorkflowRequestWorkflowRequestInfo request：请求信息对象int requestid：请求idint userid：提交人IDString type:类型String remark：提交意见Boolean：True 成功False 失败流程提交流程退回：nextNodeByRejectint requestid：请求idint userid：提交人IDString remark：退回意见Boolean：True 成功False 失败流程退回流程转发：forwardWorkflowRequestint requestid：请求idString forwardoperator：接收人id 多个用逗号分隔String remark：转发意见String userId：用户用户idString clientip：客户端ip地址Boolean：True 成功False 失败流程转发搜索所有可用流程数量:getAllWorkflowRequestCountInt userid:用户idString conditions:查询条件字符串数组Int返回数目所有可用流程列表getAllWorkflowRequestListint pageNo:当前页数int pageSize:每页的分页数量int recordCount:总行数int userId:用户idString conditions:查询流程的条件,为字符串数组类型WorkflowRequestInfo ：请求基本信息列表根据参数条件获取可用任务列表得到所有抄送的流程数量getCCWorkflowRequestCountInt userid:用户idString conditions:查询条件字符串数组Int返回数目得到所有抄送流程列表getCCWorkflowRequestListint pageNo:当前页数int pageSize:每页的分页数量int recordCount:总行数int userId:用户idString conditions:查询流程的条件,为字符串数组类型WorkflowRequestInfo ：请求基本信息列表根据参数条件获得抄送流程列表得到可创建的工作流数量getCreateWorkflowCountInt userid:用户idString conditions:查询条件字符串数组Int返回数目取得可创建的工作流列表getCreateWorkflowListint pageNo:当前页数int pageSize:每页的分页数量int recordCount:总行数int userId:用户idString conditions:查询流程的条件,为字符串数组类型WorkflowBaseInfo ：流程基本信息列表根据参数条件获得可创建流程列表取得可创建的工作流类型数量getCreateWorkflowTypeCountInt userid:用户idString conditions:查询条件字符串数组Int可创建的工作流类型数量取得可创建的工作流类型列表getCreateWorkflowTypeListint pageNo:当前页数int pageSize:每页的分页数量int recordCount:总行数int userId:用户idString conditions:查询流程的条件,为字符串数组类型WorkflowBaseInfo:工作流基本信息数组根据参数条件获得可创建的流程类型列表取得创建流程的相关信息getCreateWorkflowRequestInfoInt workflowId:流程idInt userid:用户idWorkflowRequestInfo:流程信息对象取得已办工作流类型数量getHendledWorkflowRequestCountInt userid:用户idString conditions:查询条件字符串数组Int:可创建流程数量取得已办流程列表getHendledWorkflowRequestListint pageNo:当前页数int pageSize:每页的分页数量int recordCount:总行数int userId:用户idString conditions:查询流程的条件,为字符串数组类型WorkflowRequestInfo ：请求基本信息列表根据参数条件获得已办流程列表取得已办工作流类型数量getMyWorkflowRequestCountInt userid:用户idString conditions:查询条件字符串数组Int:我的请求流程数量取得已办流程列表getMyWorkflowRequestListint pageNo:当前页数int pageSize:每页的分页数量int recordCount:总行数int userId:用户idString conditions:查询流程的条件,为字符串数组类型WorkflowRequestInfo ：请求基本信息列表根据参数条件获得我的请求列表取得流程new标记getWorkflowNewFlagString requestIds多个流程id组成的数组String ResourceId人力资源idString:结果数组,0或者1组成的数组取得流程详细信息getWorkflowRequestInt requestid请求idInt userid用户idInt fromrequestid从相关id的工作流过来WorkflowRequestInfo:流程信息写入流程查看日志writeWorkflowReadFlagString requested请求idString userId用户id无返回值取得归档工作流类型数量getProcessedWorkflowRequestCountInt userid:用户idString conditions:查询条件字符串数组Int:归档流程数量取得归档流程列表getProcessedWorkflowRequestListint pageNo:当前页数int pageSize:每页的分页数量int recordCount:总行数int userId:用户idString conditions:查询流程的条件,为字符串数组类型WorkflowRequestInfo ：请求基本信息列表根据参数条件获得归档请求列表接口对象说明：1）WorkflowRequestInfo 工作流请求信息/* * 请求ID */private String requestId;/* * 请求标题 */private String requestName;/* * 请求重要级别 */private String requestLevel;/* * 短信提醒 */private String messageType;/* * 流程类型 */private WorkflowBaseInfo workflowBaseInfo;/* * 当前节点名称 */private String currentNodeName;/* * 当前节点Id */private String currentNodeId;/* * 流程状态 */private String status;/* * 创建者 */private String creatorId; /* * 创建时间 */private String createTime;/* * 最后操作者名称 */private String lastOperatorName;/* * 最后操作时间 */private String lastOperateTime;/* * 是否可查看 */private boolean canView;/* * 是否可编辑 */private boolean canEdit;/* * 签字意见是否必填 */private boolean mustInputRemark; /* * 主表信息 */private WorkflowMainTableInfo workflowMainTableInfo;/* * 明细表信息 */private WorkflowDetailTableInfo workflowDetailTableInfos;/* * 流转日志信息 */private WorkflowRequestLog workflowRequestLogs;/* * HTML显示模板 * 0 iPad * 1 iPhone */private String WorkflowHtmlTemplete;/* * 解析后的HTML显示内容 * 0 iPad * 1 iPhone */private String WorkflowHtmlShow; /* * 被代理人 */private String beagentid; /* * 流程短语 */private String workflowPhrases;2）WorkflowBaseInfo 工作流信息/* * 工作流ID */private String workflowId;/* * 工作流标题 */private String workflowName;/* * 工作流类型ID */private String workflowTypeId;/* * 工作流类型名称 */private String workflowTypeName;2.2.3调用实例根据实际的webservice客户端实现的客户端代码均不相同.以下仅供参考.1） 创建流程/* *创建流程，支持多明细，并且带附件字段-目前只支持一个附件，并且是（http格式的） * throws Exception */public static void createRequest() throws Exception /主字段WorkflowRequestTableField wrti = new WorkflowRequestTableField4; /字段信息wrti0 = new WorkflowRequestTableField(); wrti0.setFieldName(mutiresource);/被留言人wrti0.setFieldValue(111);/被留言人字段的值，111为被留言人idwrti0.setView(true);/字段是否可见wrti0.setEdit(true);/字段是否可编辑wrti1 = new WorkflowRequestTableField(); wrti1.setFieldName(remark);/留言内容wrti1.setFieldValue(test);wrti1.setView(true);wrti1.setEdit(true);wrti2 = new WorkflowRequestTableField(); wrti2.setFieldName(resource_n);/留言人wrti2.setFieldValue(111);wrti2.setView(true);wrti2.setEdit(true);wrti3 = new WorkflowRequestTableField(); wrti3.setFieldName(fj2);/附件wrti3.setFieldType(http:baidu_sylogo1.gif);/http:开头代表该字段为附件字段wrti3.setFieldValue(/img/baidu_sylogo1.gif);/附件地址wrti3.setView(true);wrti3.setEdit(true);WorkflowRequestTableRecord wrtri = new WorkflowRequestTableRecord1;/主字段只有一行数据wrtri0 = new WorkflowRequestTableRecord();wrtri0.setWorkflowRequestTableFields(wrti);WorkflowMainTableInfo wmi = new WorkflowMainTableInfo();wmi.setRequestRecords(wrtri);/明细字段WorkflowDetailTableInfo wdti = new WorkflowDetailTableInfo2;/两个明细表0明细表1,1明细表2/明细表1 startwrtri = new WorkflowRequestTableRecord2;/数据 行数，假设添加2行明细数据/第一行wrti = new WorkflowRequestTableField3; /每行3个字段wrti0 = new WorkflowRequestTableField(); wrti0.setFieldName(sl);/数量wrti0.setFieldValue(11);wrti0.setView(true);wrti0.setEdit(true);wrti1 = new WorkflowRequestTableField(); wrti1.setFieldName(dj);/单价wrti1.setFieldValue(2);wrti1.setView(true);wrti1.setEdit(true);wrti2 = new WorkflowRequestTableField(); wrti2.setFieldName(xj);/小记wrti2.setFieldValue(22);wrti2.setView(true);wrti2.setEdit(true);wrtri0 = new WorkflowRequestTableRecord();wrtri0.setWorkflowRequestTableFields(wrti);/第二行wrti = new WorkflowRequestTableField3; /每行3个字段wrti0 = new WorkflowRequestTableField(); wrti0.setFieldName(sl);/数量wrti0.setFieldValue(110);wrti0.setView(true);wrti0.setEdit(true);wrti1 = new WorkflowRequestTableField(); wrti1.setFieldName(dj);/单价wrti1.setFieldValue(2);wrti1.setView(true);wrti1.setEdit(true);wrti2 = new WorkflowRequestTableField(); wrti2.setFieldName(xj);/小记wrti2.setFieldValue(220);wrti2.setView(true);wrti2.setEdit(true);wrtri1 = new WorkflowRequestTableRecord();wrtri1.setWorkflowRequestTableFields(wrti);wdti0 = new WorkflowDetailTableInfo();wdti0.setWorkflowRequestTableRecords(wrtri);/加入明细表1的数据/明细表1 end/明细表2 startwrtri = new WorkflowRequestTableRecord1;/数据行数，假设添加1行明细数据/第一行wrti = new WorkflowRequestTableField3; /每行3个字段wrti0 = new WorkflowRequestTableField(); wrti0.setFieldName(cl3);/wrti0.setFieldValue(11);wrti0.setView(true);wrti0.setEdit(true);wrti1 = new WorkflowRequestTableField(); wrti1.setFieldName(cl1111);/wrti1.setFieldValue(2);wrti1.setView(true);wrti1.setEdit(true);wrtri0 = new WorkflowRequestTableRecord();wrtri0.setWorkflowRequestTableFields(wrti);wdti1 = new WorkflowDetailTableInfo();wdti1.setWorkflowRequestTableRecords(wrtri);/加入明细表2的数据/明细表2 endWorkflowBaseInfo wbi = new WorkflowBaseInfo();wbi.setWorkflowId(5);/workflowid 5 代表内部留言 WorkflowRequestInfo wri = new WorkflowRequestInfo();/流程基本信息wri.setCreatorId(111);/创建人idwri.setRequestLevel(2);/0 正常，1重要，2紧急wri.setRequestName(留言测试接口);/流程标题 wri.setWorkflowMainTableInfo(wmi);/添加主字段数据wri.setWorkflowBaseInfo(wbi);wri.setWorkflowDetailTableInfos(wdti);/执行创建流程接口WorkflowServicePortTypeProxy WorkflowServicePortTypeProxy = new WorkflowServicePortTypeProxy();String requestid = WorkflowServicePortTypeProxy.doCreateWorkflowRequest(wri, 111);System.out.println(requestid:+requestid);2） 获取代办列表数量/* * 获得代办事宜数量 * throws RemoteException */public static void getDaiBanShuLiang() throws RemoteExceptionWorkflowServicePortTypeProxy WorkflowServicePortTypeProxy = new WorkflowServicePortTypePro