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

1、泛微OA工作流WebService接口使用说明工作流WebService接口使用说明一、检查部署是否成功:输入下面的地址192.168.4.183(换成实际的地址):8060(实际的端口号)/services/,界面中有如下服务即可:采用Web Serverice技术进行协同系统和业务系统进行数据交互，由协同系统方开发实现Web Serverice服务，业务系统方需在本地实现Web Serverice本地代理来进行调用。协同系统方需提供的服务接口如下：1、流程创建接口2、流程流转控制接口提供流程提交，退回和转发控制接口3、需业务系统处理的任务列表根据用户id和流程id获取该人员需要业务系统处理

2、的任务列表，如果需要获取表单的数据在通过reqestid调用获取表单数据接口4、获取表单数据接口根据协同系统中流程主键requestid获取表单中所有数据5、已归档任务列表根据创建人id和流程id获取已经归档的任务列表2.2.2接口说明接口名称参数说明返回值功能描述创建新流程：doCreateWorkflowRequestWorkflowRequestInfowri：请求信息对象userId:用户idString：新流程的requestid如果小于0表示失败-1：创建流程失败-2：用户没有流程创建权限-3：创建流程基本信息失败-4：保存表单主表信息失败-5：更新紧急程度失败-6：流程操作者失败

3、-7：流转至下一节点失败-8：节点附加操作失败根据请求信息对象创建一条新的流程，请求信息对象中需包含创建人、创建流程id和表单的数据代办数量:getToDoWorkflowRequestCountint userId:用户idString conditions:查询流程的条件,为字符串数组Int:代办的数量返回满足条件的用户可以得到的代办数目代办列表：getToDoWorkflowRequestListint pageNo:当前页数int pageSize:每页的分页数量int recordCount:总行数int userId:用户idString conditions:查询流程的条件,为字

4、符串数组类型WorkflowRequestInfo ：请求基本信息列表根据参数条件获取需处理任务列表排除创建节点任务归档数目:getRejectRequestCountint userId:用户idString conditions:查询流程的条件,为字符串数组Int:归档的数量归档任务：getProcessedRequestint pageNo:当前页数int pageSize:每页的分页数量int recordCount:总行数int userId:用户idString conditions:查询流程的条件,为字符串数组类型WorkflowRequestInfo ：请求基本信息列表根据参数

5、条件获取归档任务列表表单数据：getRequestint requestId：请求requestidRequestInfo：请求信息对象根据流程requestid获得表单数据流程提交：submitWorkflowRequestWorkflowRequestInfo request：请求信息对象int requestid：请求idint userid：提交人IDString type:类型String remark：提交意见Boolean：True 成功False 失败流程提交流程退回：nextNodeByRejectint requestid：请求idint userid：提交人IDStrin

6、g remark：退回意见Boolean：True 成功False 失败流程退回流程转发：forwardWorkflowRequestint requestid：请求idString forwardoperator：接收人id 多个用逗号分隔String remark：转发意见String userId：用户用户idString clientip：客户端ip地址Boolean：True 成功False 失败流程转发搜索所有可用流程数量:getAllWorkflowRequestCountInt userid:用户idString conditions:查询条件字符串数组Int返回数目所有可用流

7、程列表getAllWorkflowRequestListint pageNo:当前页数int pageSize:每页的分页数量int recordCount:总行数int userId:用户idString conditions:查询流程的条件,为字符串数组类型WorkflowRequestInfo ：请求基本信息列表根据参数条件获取可用任务列表得到所有抄送的流程数量getCCWorkflowRequestCountInt userid:用户idString conditions:查询条件字符串数组Int返回数目得到所有抄送流程列表getCCWorkflowRequestListint pag

8、eNo:当前页数int pageSize:每页的分页数量int recordCount:总行数int userId:用户idString conditions:查询流程的条件,为字符串数组类型WorkflowRequestInfo ：请求基本信息列表根据参数条件获得抄送流程列表得到可创建的工作流数量getCreateWorkflowCountInt userid:用户idString conditions:查询条件字符串数组Int返回数目取得可创建的工作流列表getCreateWorkflowListint pageNo:当前页数int pageSize:每页的分页数量int recordCo

9、unt:总行数int userId:用户idString conditions:查询流程的条件,为字符串数组类型WorkflowBaseInfo ：流程基本信息列表根据参数条件获得可创建流程列表取得可创建的工作流类型数量getCreateWorkflowTypeCountInt userid:用户idString conditions:查询条件字符串数组Int可创建的工作流类型数量取得可创建的工作流类型列表getCreateWorkflowTypeListint pageNo:当前页数int pageSize:每页的分页数量int recordCount:总行数int userId:用户idS

10、tring conditions:查询流程的条件,为字符串数组类型WorkflowBaseInfo:工作流基本信息数组根据参数条件获得可创建的流程类型列表取得创建流程的相关信息getCreateWorkflowRequestInfoInt workflowId:流程idInt userid:用户idWorkflowRequestInfo:流程信息对象取得已办工作流类型数量getHendledWorkflowRequestCountInt userid:用户idString conditions:查询条件字符串数组Int:可创建流程数量取得已办流程列表getHendledWorkflowRequ

11、estListint pageNo:当前页数int pageSize:每页的分页数量int recordCount:总行数int userId:用户idString conditions:查询流程的条件,为字符串数组类型WorkflowRequestInfo ：请求基本信息列表根据参数条件获得已办流程列表取得已办工作流类型数量getMyWorkflowRequestCountInt userid:用户idString conditions:查询条件字符串数组Int:我的请求流程数量取得已办流程列表getMyWorkflowRequestListint pageNo:当前页数int pageSi

12、ze:每页的分页数量int recordCount:总行数int userId:用户idString conditions:查询流程的条件,为字符串数组类型WorkflowRequestInfo ：请求基本信息列表根据参数条件获得我的请求列表取得流程new标记getWorkflowNewFlagString requestIds多个流程id组成的数组String ResourceId人力资源idString:结果数组,0或者1组成的数组取得流程详细信息getWorkflowRequestInt requestid请求idInt userid用户idInt fromrequestid从相关id的

13、工作流过来WorkflowRequestInfo:流程信息写入流程查看日志writeWorkflowReadFlagString requested请求idString userId用户id无返回值取得归档工作流类型数量getProcessedWorkflowRequestCountInt userid:用户idString conditions:查询条件字符串数组Int:归档流程数量取得归档流程列表getProcessedWorkflowRequestListint pageNo:当前页数int pageSize:每页的分页数量int recordCount:总行数int userId:用户

14、idString conditions:查询流程的条件,为字符串数组类型WorkflowRequestInfo ：请求基本信息列表根据参数条件获得归档请求列表接口对象说明：1）WorkflowRequestInfo 工作流请求信息/* * 请求ID */ private String requestId; /* * 请求标题 */ private String requestName; /* * 请求重要级别 */ private String requestLevel; /* * 短信提醒 */ private String messageType; /* * 流程类型 */ private

15、 WorkflowBaseInfo workflowBaseInfo; /* * 当前节点名称 */ private String currentNodeName; /* * 当前节点Id */ private String currentNodeId; /* * 流程状态 */ private String status; /* * 创建者 */ private String creatorId; /* * 创建时间 */ private String createTime; /* * 最后操作者名称 */ private String lastOperatorName; /* * 最后操作

16、时间 */ private String lastOperateTime; /* * 是否可查看 */ private boolean canView; /* * 是否可编辑 */ private boolean canEdit; /* * 签字意见是否必填 */ private boolean mustInputRemark; /* * 主表信息 */ private WorkflowMainTableInfo workflowMainTableInfo; /* * 明细表信息 */ private WorkflowDetailTableInfo workflowDetailTableInf

17、os; /* * 流转日志信息 */ 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）W

18、orkflowBaseInfo 工作流信息 /* * 工作流ID */ private String workflowId; /* * 工作流标题 */ private String workflowName; /* * 工作流类型ID */ private String workflowTypeId; /* * 工作流类型名称 */ private String workflowTypeName;2.2.3调用实例根据实际的webservice客户端实现的客户端代码均不相同.以下仅供参考.1）创建流程 /* *创建流程，支持多明细，并且带附件字段-目前只支持一个附件，并且是（http格式的）

19、 * throws Exception */public static void createRequest() throws Exception /主字段 WorkflowRequestTableField wrti = new WorkflowRequestTableField4; /字段信息 wrti0 = new WorkflowRequestTableField(); wrti0.setFieldName(mutiresource);/被留言人 wrti0.setFieldValue(111);/被留言人字段的值，111为被留言人id wrti0.setView(true);/字段是

20、否可见 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); w

21、rti2.setEdit(true); wrti3 = new WorkflowRequestTableField(); wrti3.setFieldName(fj2);/附件 wrti3.setFieldType(http:baidu_sylogo1.gif);/http:开头代表该字段为附件字段 wrti3.setFieldValue(.baidu./img/baidu_sylogo1.gif);/附件地址 wrti3.setView(true); wrti3.setEdit(true); WorkflowRequestTableRecord wrtri = new WorkflowReq

22、uestTableRecord1;/主字段只有一行数据 wrtri0 = new WorkflowRequestTableRecord(); wrtri0.setWorkflowRequestTableFields(wrti); WorkflowMainTableInfo wmi = new WorkflowMainTableInfo(); wmi.setRequestRecords(wrtri); /明细字段 WorkflowDetailTableInfo wdti = new WorkflowDetailTableInfo2;/两个明细表0明细表1,1明细表2 /明细表1 start wr

23、tri = 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.setFieldNa

24、me(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); /

25、第二行 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);

26、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.setWorkflow

27、RequestTableRecords(wrtri);/加入明细表1的数据 /明细表1 end /明细表2 start wrtri = 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);