View Javadoc

1   /**
2    * Copyright 2005-2012 The Kuali Foundation
3    *
4    * Licensed under the Educational Community License, Version 2.0 (the "License");
5    * you may not use this file except in compliance with the License.
6    * You may obtain a copy of the License at
7    *
8    * http://www.opensource.org/licenses/ecl2.php
9    *
10   * Unless required by applicable law or agreed to in writing, software
11   * distributed under the License is distributed on an "AS IS" BASIS,
12   * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13   * See the License for the specific language governing permissions and
14   * limitations under the License.
15   */
16  package org.kuali.rice.kew.actions;
17  
18  import org.kuali.rice.kew.actiontaken.ActionTakenValue;
19  import org.kuali.rice.kew.api.WorkflowRuntimeException;
20  import org.kuali.rice.kew.api.exception.InvalidActionTakenException;
21  import org.kuali.rice.kew.api.exception.WorkflowException;
22  import org.kuali.rice.kew.doctype.bo.DocumentType;
23  import org.kuali.rice.kew.engine.BlanketApproveEngine;
24  import org.kuali.rice.kew.engine.OrchestrationConfig;
25  import org.kuali.rice.kew.engine.OrchestrationConfig.EngineCapability;
26  import org.kuali.rice.kew.exception.*;
27  import org.kuali.rice.kew.routeheader.DocumentRouteHeaderValue;
28  import org.kuali.rice.kew.service.KEWServiceLocator;
29  import org.kuali.rice.kew.api.KewApiConstants;
30  import org.kuali.rice.kim.api.identity.principal.PrincipalContract;
31  
32  
33  import java.util.ArrayList;
34  import java.util.Collections;
35  import java.util.List;
36  
37  
38  /**
39   * Does a node level super user approve action.  All approve/complete requests outstanding for
40   * this node are satisfied by this action.
41   *
42   * @author Kuali Rice Team (rice.collab@kuali.org)
43   *
44   */
45  public class SuperUserNodeApproveEvent extends SuperUserActionTakenEvent {
46  
47      private static final org.apache.log4j.Logger LOG = org.apache.log4j.Logger.getLogger(SuperUserNodeApproveEvent.class);
48      private String nodeName;
49  
50      public SuperUserNodeApproveEvent(DocumentRouteHeaderValue routeHeader, PrincipalContract principal) {
51          super(KewApiConstants.ACTION_TAKEN_SU_ROUTE_LEVEL_APPROVED_CD, routeHeader, principal);
52          this.superUserAction = KewApiConstants.SUPER_USER_ROUTE_LEVEL_APPROVE;
53      }
54  
55      public SuperUserNodeApproveEvent(DocumentRouteHeaderValue routeHeader, PrincipalContract principal, String annotation, boolean runPostProcessor, String nodeName) {
56          super(KewApiConstants.ACTION_TAKEN_SU_ROUTE_LEVEL_APPROVED_CD, routeHeader, principal, annotation, runPostProcessor);
57          this.superUserAction = KewApiConstants.SUPER_USER_ROUTE_LEVEL_APPROVE;
58          this.nodeName = nodeName;
59      }
60  
61      public void recordAction() throws InvalidActionTakenException {
62  
63          if (org.apache.commons.lang.StringUtils.isEmpty(nodeName)) {
64              throw new InvalidActionTakenException("No approval node name set");
65          }
66  
67          DocumentType docType = getRouteHeader().getDocumentType();
68  
69          String errorMessage = super.validateActionRules();
70          if (!org.apache.commons.lang.StringUtils.isEmpty(errorMessage)) {
71              LOG.info("User not authorized");
72              List<WorkflowServiceErrorImpl> errors = new ArrayList<WorkflowServiceErrorImpl>();
73              errors.add(new WorkflowServiceErrorImpl(errorMessage, SuperUserActionTakenEvent.AUTHORIZATION));
74              throw new WorkflowServiceErrorException(errorMessage, errors);
75          }
76  
77          ActionTakenValue actionTaken = saveActionTaken();
78  
79          notifyActionTaken(actionTaken);
80  
81              if (getRouteHeader().isInException()) {
82                  LOG.debug("Moving document back to Enroute from Exception");
83                  String oldStatus = getRouteHeader().getDocRouteStatus();
84                  getRouteHeader().markDocumentEnroute();
85                  String newStatus = getRouteHeader().getDocRouteStatus();
86                  notifyStatusChange(newStatus, oldStatus);
87                  KEWServiceLocator.getRouteHeaderService().saveRouteHeader(getRouteHeader());
88              }
89  
90              OrchestrationConfig config = new OrchestrationConfig(EngineCapability.BLANKET_APPROVAL, Collections.singleton(nodeName), actionTaken, docType.getSuperUserApproveNotificationPolicy().getPolicyValue(), isRunPostProcessorLogic());
91              try {
92              	BlanketApproveEngine blanketApproveEngine = KEWServiceLocator.getWorkflowEngineFactory().newEngine(config);
93      			blanketApproveEngine.process(getRouteHeader().getDocumentId(), null);
94              } catch (Exception e) {
95              	if (e instanceof RuntimeException) {
96          		throw (RuntimeException)e;
97          	} else {
98          		throw new WorkflowRuntimeException(e.toString(), e);
99          	}
100             }
101 
102         //queueDocument();
103     }
104 
105     protected void markDocument() throws WorkflowException {
106         // do nothing since we are overriding the entire behavior
107     }
108 
109 
110 
111 
112 
113 }