salesforce 零基础开发入门学习(九)Approval Process 介绍

在阅读此篇文章前,可以先参考阅读一个前辈总结的关于Approval Process的操作。以下为参考的链接:

http://www.cnblogs.com/mingmingruyuedlut/p/3765777.html

Approval Process用于流程审批,Apex主要涉及到的命名空间和类为Approval命名空间以及System命名空间下的Approval类。

其中Approval命名空间下主要的类为:

  • ProcessRequest
  • ProcessSubmitRequest
  • ProcessWorkitemRequest
  • ProcessResult

下面通过一段代码来进行介绍这些类的作用以及使用方式,此代码copy于官方PDF文档的sample。

 1 public class TestApproval { 
 2     void submitAndProcessApprovalRequest() { 
 3         // Insert an account 
 4         Account a = new Account(Name='Test',annualRevenue=100.0); 
 5         insert a; 
 6         User user1 = [SELECT Id FROM User WHERE Alias='SomeStandardUser']; 
 7         // Create an approval request for the account 
 8         Approval.ProcessSubmitRequest req1 = new Approval.ProcessSubmitRequest(); 
 9         req1.setComments('Submitting request for approval.'); 
10         req1.setObjectId(a.id); 
11         // Submit on behalf of a specific submitter 
12         req1.setSubmitterId(user1.Id); 
13         // Submit the record to specific process and skip the criteria evaluation 
14         req1.setProcessDefinitionNameOrId('PTO_Request_Process'); 
15         req1.setSkipEntryCriteria(true); // Submit the approval request for the account 
16         Approval.ProcessResult result = Approval.process(req1); // Verify the result 
17         System.assert(result.isSuccess()); 
18         System.assertEquals( 'Pending', result.getInstanceStatus(), 'Instance Status'+result.getInstanceStatus()); 
19         // Approve the submitted request 
20         // First, get the ID of the newly created item 
21         List<Id> newWorkItemIds = result.getNewWorkitemIds(); 
22         // Instantiate the new ProcessWorkitemRequest object and populate it 
23         Approval.ProcessWorkitemRequest req2 = new Approval.ProcessWorkitemRequest(); 
24         req2.setComments('Approving request.'); 
25         req2.setAction('Approve'); 
26         req2.setNextApproverIds(new Id[] {UserInfo.getUserId()}); 
27         // Use the ID from the newly created item to specify the item to be worked
28         req2.setWorkitemId(newWorkItemIds.get(0)); 
29         // Submit the request for approval 
30         Approval.ProcessResult result2 = Approval.process(req2); 
31         // Verify the results 
32         System.assert(result2.isSuccess(), 'Result Status:'+result2.isSuccess()); 
33         System.assertEquals( 'Approved', result2.getInstanceStatus(), 'Instance Status'+result2.getInstanceStatus());
34     }
35 }

注:此代码无法直接运行,如果需要运行此代码,请参照上方的链接为Account表设置名为'PTO_Request_Process'的审批流程。

通过上述代码来更好的了解以下的类的使用。

一)ProcessRequest

ProcessRequest类作为ProcessSubmitRequest和ProcessWorkitemRequest类的父类,提供了四个内置方法:

  1. setComments(comments):此方法用于设置审批提交时的审批意见;
  2. setNextApproverIds(ID[] nextApproverIds):此方法用于流程审批的下一级审批者;
  3. getComments():此方法用于获取审批意见;
  4. getNextApproverIds():返回一个作为审批者的用户的用户ID列表。

ProcessRequest封装的方法为最基础的流程审批方法,并且这些方法都是实例化方法。通常新建流程审批的类时并不实例化此类,而是实例化他对应的两个子类。

二)ProcessSubmitRequest

使用此类来提交一条记录到流程审批中,除继承ProcessRequest类方法以外,如下为自身的方法:

  1. setObjectId(recordId):设置指定的sObject的记录ID到流程审批中。如上述sample中,insert一条Account,可以将Account提交到审批流程中,比如annualRevenue字段超过多少情况下执行流程审批
  2. setProcessDefinitionNameOrId(nameOrId):设置流程定义的名称或者编号,记录提交给特定的审批流程。可以在salesforce中通过setup->Create->Workflow&Approvals->Approval Processes设置指定的审批流程,如果设置为null,则遵循标准流程,默认值为null;
  3. setSkipEntryCriteria(skipEntryCriteria):如果skipEntryCriterial设置为true,请求提交则跳过在setProcessDefinitionNameOrId流程设置中的校验,如果没有指定nameOrId则自动忽略此参数,并且按照标准流程顺序走。如果设置为false,或不调用此方法,则不跳过校验;
  4. setSubmittedId(userId):设置需要提交到流程审批的记录的用户ID,这个用户必须是在流程定义设置中允许提交流程的一个用户,如果不设置则默认当前用户;
  5. 相应get方法。

通过此类的方法讲解可以看出此类主要用于将一条数据提交到流程审批时使用。

三)ProcessWorkitemRequest

此类用于当一个记录提交到流程审批后,处理一个流程审批的请求,处理的状态可以分为Approve,Reject,Removed三种情况。除继承ProcessRequest类的方法以外,如下为自身的方法:

  1. setAction(actionType):设置action类型来处理一个流程审批请求,其中actionType可以为一下的值:Approve,Reject,Removed.其中,只有系统管理员可以指定Removed;
  2. setWorkitemId(id):设置被批准,拒绝或者移除的审批请求的编号,此编号可以在ProcessInstanceWorkitem表中获取,此表为salesforce自身封装的表;
  3. 相应的get方法。

通过此类的方法介绍可以看出,此类主要用于对已经提交到流程审批的记录进行审批处理时用到的类。

四)ProcessResult

当提交一条记录到流程审批后,可以通过此类来处理流程审批的结果状态。

此类方法如下:

  1. getEntityId():获取正在被提交到流程审批的记录的编号,可以在ProcessInstanceWorkitem表中看到,对应于此表的字段TargetObjectId值;
  2. getErrors():如果发生错误,返回包含数据库对象错误代码和描述的数组;
  3. getInstanceId():获取流程审批的编号,可以在ProcessInstanceWorkitem表中看到,对应于此表的字段Id值;
  4. getInstanceStatus():获取流程审批的状态,主要有以下的几种:Approved,Reject,Removed,Pending;
  5. getNewWorkitemIds():获取提交到流程审批的新项目的ID,可以有0个或者1个流程审批。可以在ProcessInstanceWorkitem表中看到,对应于此表的Id字段值;
  6. isSuccess():如果审批流程正常提交则返回true,否则返回false。

五)Approval

Approval位于System命名空间下,上述1-4均在Approval命名空间下。

Approval类含有很多方法,这里主要介绍process()方法,其他方法请自行查看官方PDF文档。此方法作用为提交一个新的请求,或者通过或者拒绝已经存在的审批的记录。此方法形参有一项为ProcessRequest,可以指定ProcessSubmitRequest或者ProcessWorkitemRequest类作为参数以实现不同功能,此方法返回类型为Approval.ProcessResult对象。当正确提交一条记录到审批流程后,相应的ProcessInstanceWorkitem表以及ProcessInstance表便新增一条关于此条记录的信息记录。

总结:ProcessRequest作为审批请求的父类,封装了两个重要的方法,扩展的两个子类分别实现不同功能,ProcessSubmitRequest实现将一条记录传到审批流程中,ProcessWorkitemRequest实现审批已经存在审批流程中的记录。

对上述例子进行调整一下,使之可以不通过前辈那种方式(链接在上方)操作。

通过上面介绍可以发现,当将setProcessDefinitionNameOrId()方法参数设置为null或者不调用此方法时,可以不执行上述方法,通过定义父类的setNextApproverIds()方法设置审批用户编号便可以将审批流程跑通,于是上述代码可以做如下变形便直接跑通:

 1 public class TestApproval { 
 2     public void submitAndProcessApprovalRequest() { 
 3         // Insert an account 
 4         Account a = new Account(Name='Test',annualRevenue=100.0); 
 5         insert a; 
 6         User user1 = [SELECT Id FROM User WHERE Alias='zero']; 
 7         // Create an approval request for the account 
 8         Approval.ProcessSubmitRequest req1 = new Approval.ProcessSubmitRequest(); 
 9         req1.setComments('Submitting request for approval.'); 
10         req1.setObjectId(a.id); 
11         // Submit on behalf of a specific submitter 
12         req1.setSubmitterId(user1.Id);
13         ID[] ids = new ID[]{user1.Id}; 
14         req1.setNextApproverIds(ids);
15         // Submit the record to specific process and skip the criteria evaluation 
16         //req1.setProcessDefinitionNameOrId('PTO_Request_Process'); 
17         req1.setSkipEntryCriteria(true); // Submit the approval request for the account 
18         Approval.ProcessResult result = Approval.process(req1); // Verify the result 
19         System.assert(result.isSuccess()); 
20         System.assertEquals( 'Pending', result.getInstanceStatus(), 'Instance Status'+result.getInstanceStatus()); 
21         // Approve the submitted request 
22         // First, get the ID of the newly created item 
23         List<Id> newWorkItemIds = result.getNewWorkitemIds(); 
24         // Instantiate the new ProcessWorkitemRequest object and populate it 
25         Approval.ProcessWorkitemRequest req2 = new Approval.ProcessWorkitemRequest(); 
26         req2.setComments('Approving request.'); 
27         req2.setAction('Approve'); 
28         req2.setNextApproverIds(new Id[] {UserInfo.getUserId()}); 
29         // Use the ID from the newly created item to specify the item to be worked
30         req2.setWorkitemId(newWorkItemIds.get(0)); 
31         // Submit the request for approval 
32         Approval.ProcessResult result2 = Approval.process(req2); 
33         // Verify the results 
34         System.assert(result2.isSuccess(), 'Result Status:'+result2.isSuccess()); 
35         System.assertEquals( 'Approved', result2.getInstanceStatus(), 'Instance Status'+result2.getInstanceStatus());
36     }
37 }

至于在setup->Create->Workflow&Approvals->Approval Processes新建一个自定义的审批流程使用比较好,还是在程序中动态设置下一个审批人比较好,看具体的项目要求吧。至于两者有什么区别,本人并没有太深入了解,有想更好了解的可以查看相关的论坛或者官方文档查看。如果内容有错误的地方,请批评指正,如果有哪里不懂得可以留言和我联系。

本文参与腾讯云自媒体分享计划,欢迎正在阅读的你也加入,一起分享。

发表于

我来说两句

0 条评论
登录 后参与评论

相关文章

来自专栏ASP.NET MVC5 后台权限管理系统

ASP.NET MVC5+EF6+EasyUI 后台管理系统(48)-工作流设计-起草新申请

创建新表单之后,我们就可以起草申请了,申请按照严格的表单步骤和分支执行。 起草的同时,我们分解流转的规则中的审批人并保存,具体流程如下 接下来创建DrafCon...

1856
来自专栏林德熙的博客

WPF 使用 SharpDX 在 D3DImage 显示 介绍创建控件D3D 设备设置指针画出来

本文告诉大家如何使用 SharpDX 在 D3DImage 显示。在上一篇WPF 使用 SharpDX只是使用窗口,也就是无法使用其它的 WPF 控件。所以这一...

521
来自专栏葬爱家族

Mvvm、RxJava、Retrofit 三剑合璧

说起现在Android流行的app架构,脱口而出MVP、MVVM,要问两者区别,张口就来,balabalabala。。但是公司所有项目用的都是MVP,从没正式用...

992
来自专栏lulianqi

一个基于.NET平台的自动化/压力测试系统设计简述

AutoTest是一个基于.NET平台实现的自动化/压力测试的系统,可独立运行于windows平台下,支持分布式部署,不需要其他配置或编译器的支持。(本质是一个...

651
来自专栏c#开发者

使用javascript+xml实现分页

今天才开通我的csdn blog,把俺以前的帖子拿出来和大家分享。 基于web的技术中,分页是一个老的不能再老的,但大家津津乐道的问题,随着xml技术的日渐应用...

3268
来自专栏我杨某人的青春满是悔恨

封装一个 Swift-Style 的网络模块

Swift 跟 OC 有着完全不同的设计哲学,它鼓励你使用 protocol 而不是 super class,使用 enum 和 struct 而不是 clas...

593
来自专栏Jerry的SAP技术分享

Hybris Enterprise Commerce Platform 服务层的设计与实现

Hybris Enterprise Commerce Platform这个系列之前已经由我的同事,SAP成都研究院Hybris开发团队的同事张健(Zhang J...

902
来自专栏恰同学骚年

呼叫中心项目学习总结

这几天一直在学习呼叫中心项目视频教程,跟着学习了下这个项目的一些关键知识点,现在回顾梳理一下重点:

653
来自专栏流媒体

MediaCodec进行AAC编解码(文件格式转换)

AAC,全称Advanced Audio Coding,是一种专为声音数据设计的文件压缩格式。与MP3不同,它采用了全新的算法进行编码,更加高效,具有更高的“性...

1235
来自专栏

Flex 解析显示.net web service的DataTable返回

<?xml version="1.0" encoding="utf-8"?> <mx:Application xmlns:mx="http://www.adob...

693

扫码关注云+社区