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。

public class TestApproval { 
    void submitAndProcessApprovalRequest() { 
        // Insert an account 
        Account a = new Account(Name='Test',annualRevenue=100.0); 
        insert a; 
        User user1 = [SELECT Id FROM User WHERE Alias='SomeStandardUser']; 
        // Create an approval request for the account 
        Approval.ProcessSubmitRequest req1 = new Approval.ProcessSubmitRequest(); 
        req1.setComments('Submitting request for approval.'); 
        req1.setObjectId(a.id); 
        // Submit on behalf of a specific submitter 
        req1.setSubmitterId(user1.Id); 
        // Submit the record to specific process and skip the criteria evaluation 
        req1.setProcessDefinitionNameOrId('PTO_Request_Process'); 
        req1.setSkipEntryCriteria(true); // Submit the approval request for the account 
        Approval.ProcessResult result = Approval.process(req1); // Verify the result 
        System.assert(result.isSuccess()); 
        System.assertEquals( 'Pending', result.getInstanceStatus(), 'Instance Status'+result.getInstanceStatus()); 
        // Approve the submitted request 
        // First, get the ID of the newly created item 
        List<Id> newWorkItemIds = result.getNewWorkitemIds(); 
        // Instantiate the new ProcessWorkitemRequest object and populate it 
        Approval.ProcessWorkitemRequest req2 = new Approval.ProcessWorkitemRequest(); 
        req2.setComments('Approving request.'); 
        req2.setAction('Approve'); 
        req2.setNextApproverIds(new Id[] {UserInfo.getUserId()}); 
        // Use the ID from the newly created item to specify the item to be worked
        req2.setWorkitemId(newWorkItemIds.get(0)); 
        // Submit the request for approval 
        Approval.ProcessResult result2 = Approval.process(req2); 
        // Verify the results 
        System.assert(result2.isSuccess(), 'Result Status:'+result2.isSuccess()); 
        System.assertEquals( 'Approved', result2.getInstanceStatus(), 'Instance Status'+result2.getInstanceStatus());
    }
}

 注：此代码无法直接运行，如果需要运行此代码，请参照上方的链接为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()方法设置审批用户编号便可以将审批流程跑通，于是上述代码可以做如下变形便直接跑通：

public class TestApproval { 
    public void submitAndProcessApprovalRequest() { 
        // Insert an account 
        Account a = new Account(Name='Test',annualRevenue=100.0); 
        insert a; 
        User user1 = [SELECT Id FROM User WHERE Alias='zero']; 
        // Create an approval request for the account 
        Approval.ProcessSubmitRequest req1 = new Approval.ProcessSubmitRequest(); 
        req1.setComments('Submitting request for approval.'); 
        req1.setObjectId(a.id); 
        // Submit on behalf of a specific submitter 
        req1.setSubmitterId(user1.Id);
        ID[] ids = new ID[]{user1.Id}; 
        req1.setNextApproverIds(ids);
        // Submit the record to specific process and skip the criteria evaluation 
        //req1.setProcessDefinitionNameOrId('PTO_Request_Process'); 
        req1.setSkipEntryCriteria(true); // Submit the approval request for the account 
        Approval.ProcessResult result = Approval.process(req1); // Verify the result 
        System.assert(result.isSuccess()); 
        System.assertEquals( 'Pending', result.getInstanceStatus(), 'Instance Status'+result.getInstanceStatus()); 
        // Approve the submitted request 
        // First, get the ID of the newly created item 
        List<Id> newWorkItemIds = result.getNewWorkitemIds(); 
        // Instantiate the new ProcessWorkitemRequest object and populate it 
        Approval.ProcessWorkitemRequest req2 = new Approval.ProcessWorkitemRequest(); 
        req2.setComments('Approving request.'); 
        req2.setAction('Approve'); 
        req2.setNextApproverIds(new Id[] {UserInfo.getUserId()}); 
        // Use the ID from the newly created item to specify the item to be worked
        req2.setWorkitemId(newWorkItemIds.get(0)); 
        // Submit the request for approval 
        Approval.ProcessResult result2 = Approval.process(req2); 
        // Verify the results 
        System.assert(result2.isSuccess(), 'Result Status:'+result2.isSuccess()); 
        System.assertEquals( 'Approved', result2.getInstanceStatus(), 'Instance Status'+result2.getInstanceStatus());
    }
}

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