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 条评论
登录 后参与评论

相关文章

来自专栏Linux驱动

26.QT-模型视图之自定义委托

由于模型负责组织数据,而视图负责显示数据,所以当用户想修改显示的数据时,就要通过视图中的委托来完成

712
来自专栏存储

spring boot redis分布式锁

随着现在分布式架构越来越盛行,在很多场景下需要使用到分布式锁。分布式锁的实现有很多种,比如基于数据库、zookeeper等,本文主要介绍使用Redis做分布式锁...

4235
来自专栏LanceToBigData

XML(二)之DTD——XML文件约束

前面介绍了XML的作用和基本的格式,今天我给大家分享的是关于XML的约束。废话不多说,我们直接来正题! 一、DTD简介 1.1、DTD概述   DTD(Docu...

2229
来自专栏移动开发之家

Flutter完整开发实战详解(五、 深入探索)

作为系列文章的第五篇,本篇主要探索下 Flutter 中的一些有趣原理,帮助我们更好的去理解和开发。

1503
来自专栏Linux驱动

2.QT-窗口组件(QWidget),QT坐标系统,初探消息处理(信号与槽)

本章主要内容如下: 1) 窗口组件(QWidget) 2) QT坐标系统 3) 初探消息处理(信号与槽) ---- 窗口组件(QWidget) 介绍 Qt以组件...

3134
来自专栏ionic3+

【技巧】ionic3中content的resize知多少

resize这个方法官方文档有写,所以我以为没什么特别,直至有几人问我,才发现不少人是不知道这个东西的,所以还是写一下。resize官网说明如下:

783
来自专栏熊二哥

快速入门系列--MVC--03控制器和IOC应用

    Asp.net MVC也接触好久了,但由于自己一直主要负责后台,尤其是数据库方面的工作对于该框架并没有一个很好的了解,尤其是蒋金楠大师的ASP.NET ...

1756
来自专栏吴伟祥

JAVA_OPTS设置 转

JVM:JAVA_OPTS="-server -Xms2048m -Xmx2048m -Xss512k"

571
来自专栏一名叫大蕉的程序员

关于Java健壮性的一些思考与实践 No.102

上面两种模式都可以实现标准的 response 的封装,那么具体要封装哪些东西呢?其实最主要的就是统一的 try catch,防止出现任何的 500 错误给到调...

792
来自专栏Android相关

X86处理器架构--Nehalem

最开始的处理器比较简单,8086处理器是评估当前的指令指针(CS:IP)指向的指令,然后再执行解码、执行、退出,并移动指令指针到下一个位置,每一个新的芯片都做了...

1084

扫码关注云+社区