Direkt zum Hauptbereich

Standard Approval Process anpassen

Ein Kunde nutzt den Standard Approval Process von Salesforce im Vertriebsprozess.
Bearbeiter versenden viele Angebote mit vielen Positionen.
Wer mit Approvals gearbeitet hat, weiss, dass die Approval-Maske ganz simpel aussieht. Das Layout lässt sich nicht bearbeiten.
Der Kunde möchte aber eine Übersicht aller Produkte aus dem jeweiligen Angebot sowie den Approval Status dieser Produkte sehen.
Salesforce bietet leider keine Möglichkeit, weder den Approval Process noch dessen Layout zu überschreiben.

Lösung: mit einem unschönen, aber funktionierenden Hack lässt sich die Anforderung umsetzen:
wir überschreiben die Standard Approval Process URL:
   Standard URL: /p/process/ProcessInstanceWorkitemWizardStageManager
mit einer anderen URL mittels JavaScript. Diese neue URL verlinkt auf eine VisualForce Page:
  Ersetzten durch URL: /apex/QuoteApprovalProcess

Die Standard Approval URLs können sowohl auf der Homepage als auch im Kontext erscheinen.
Daher brauchen wir eine zentrale Lösung, die immer greift.
Dazu wird eine neue Homepage Komponente erstellt: Custom Approval Process.


Diese Komponente muss auf der Navigationsseite (links) erscheinen, und vom Typ "HTML" sein.



Die implementierte JavaScript Funktion ersetzt alle Standard Approval URLs durch eine neue URL mit  der Referenz auf eine VisualForce Seite.

<script>
 window.onload=customApprovalProcess;
 function customApprovalProcess(){
  var allHrefs = document.getElementsByTagName("a");
  var strSearch = "/p/process/ProcessInstanceWorkitemWizardStageManager";
  var strReplace = "/apex/QuoteApprovalProcess";
  for (var i=0; i< allHrefs.length; i++) {  
   var str = allHrefs[i].href;  
   allHrefs[i].href = str.replace(strSearch, strReplace);
  }
 }
</script>



Nach der Übernahme der neuen Komponente in das Homepage Layout,

erscheint diese im Frontend, auf der Navigationsleiste ganz unten.
Ein weiterer, aber zu vernachlässigender Nachteil dieser Lösung ist die Ausführung der JavaScript Funktion bei jeder Seitenaktualisierung. Da JavaScript lokal ausgeführt wird, und die Funktion "nur" URLs ersetzt, ist keine Performancebeeinträchtigung zu spüren.


Jetzt muss nur noch eine auf die Kundenwünsche zugeschnittene VisualForce Seite gebaut werden.

Eine neue VisualForce Seite:

<apex:page controller="QuoteApporvalProcessController">
 <apex:pagemessages ></apex:pagemessages>
 <apex:sectionHeader title="{!$Label.ApprovalRequest}"/>

 <apex:form >
 <apex:pageBlock title="{!$Label.QAProcess_BlockTitle}">

 <!-- BUTTONS -->
 <!-- ++++++++++++++++++++++++++++++++++++++++++++++++++ -->
 <apex:pageBlockButtons location="bottom">
  <apex:commandButton value="Approve" action="{!approve}"/>
  <apex:commandButton value="Reject" action="{!reject}"/>
  <apex:commandButton value="Cancel" action="{!cancel}"/>
 </apex:pageBlockButtons>

 <!-- FORM -->
 <!-- ++++++++++++++++++++++++++++++++++++++++++++++++++ -->
 <apex:pageBlockSection columns="1">
   Darstellung der Felder aus dem Angebot
 </apex:pageBlockSection>
</apex:pageBlock>


<!-- TABLE WITH PRODUCTS (POSITION LINE ITEMS) -->
<!-- ++++++++++++++++++++++++++++++++++++++++++++++++++ -->
<apex:pageBlock title="{!$Label.QAProcess_BlockTitleProducts}">
 Darstellung einzelner Positionen aus dem Angebot
</apex:pageBlock>

</apex:form>

<!-- Approvals related list -->
<!-- +++++++++++++++++++++++++++++++++++++++++++++++++++++ -->
Darstellung des aktuellen Approval Status aller Produkte aus dem Angebot
<apex:relatedList subject="{!quote}" list="ProcessSteps" />
</apex:page>



Wie kriegt der Controller mit, um welchen Approval Process es sich handelt?
Ganz einfach! Mit JavaScript ersetzen wir nur einen Teil der Standard Approval URLs. Jede URL enthält einen Parameter - ID. Das ist die ID des jeweiligen Prozess-Datensatzes.
Über diese ID (genannt processId ) findet der Controller das aktuelle Angebot und dessen einzelnen Positionen.



public without sharing class QuoteApporvalProcessController {
 public Quote__c quote {get; set;}
 public PageReference redirectPage;
 public String processId;
 public String quoteId;

 // CONSTRUCTOR
 public QuoteApporvalProcessController(){

Prozess ID ist als Parameter verfügbar
  processId = ApexPages.currentPage().getParameters().get('id');
  // get quote id from the Process Instance
  if(processId != ''){
   ProcessInstanceWorkitem piw = [select Id, 
                                  ProcessInstanceId,
                                  IsDeleted, 
                                  p.ProcessInstance.TargetObjectId 
                                from ProcessInstanceWorkitem
                                where p.id=: processId Limit 1];
   if(piw != null){
     quoteId = piw.ProcessInstance.TargetObjectId;

    // OBJECT: Quote with POSITION LINE ITEMS
    if(quoteId != ''){
      quote = [select Name,
                      (Select Id,
                          Name,
                      from Positionen__r)
              from Quote__c
              where id = :quoteId];
      redirectPage = new PageReference('/'+ quoteId);
    }
   }
  }
}

Funktionalität der einzelnen Buttons: Approve, Reject, Cancel.
//BUTTON APPROVE
public PageReference Approve(){
Approval.ProcessWorkitemRequest req = new Approval.ProcessWorkitemRequest();
req.setComments(quote.QAProcess_Comments__c);
req.setAction('Approve');
req.setWorkitemId(processId);
Approval.ProcessResult result = Approval.process(req);

System.assert(result.isSuccess());

return redirectPage;
}

//BUTTON REJECT
public PageReference Reject(){
Approval.ProcessWorkitemRequest req = new Approval.ProcessWorkitemRequest();
req.setComments(quote.QAProcess_Comments__c);
req.setAction('Reject');
req.setWorkitemId(processId);
Approval.ProcessResult result = Approval.process(req);
return redirectPage;
}

//BUTTON CANCEL
public PageReference Cancel(){
return redirectPage ;
}
}

-------------------------------------------------------------------------------
Einige Ideen während der Umsetzung habe ich aus dem Blog Running Apex Code in a Standard Approval Process übernommen: http://comitydesigns.com/blog/running-apex-code-in-a-standard-approval-process/

Kommentare

Beliebte Posts aus diesem Blog

Salesforce - Datensätze sperren (Umsetzung)

Record Lock - nun, die Umsetzung.Wir haben bereits mehrere VisualForce Pages im Einsatz. Aus dem Grund ist das zuvor beschriebene Konzept darauf zugeschnitten. Selbstverständlich lässt sich der Code auch für Standard und Custom Objects verwenden, ohne den Einsatz von VisualForce Pages. Na ja, mindestens eine VF Page brauchen wir eigentlich schon - diejenige, die von dem dem "Edit" Button aufgerufen wird.

Ich zeige jetzt die wichtigsten Bausteine aus der Umsetzung.
1) Diese VF Page wird aufgerufen sobald man den "Edit" Button betätigt

<apex:pagestandardController="myObject"title="{!myObject.Name}"extensions="LockController"action="{!SwitchToPage}">
<!-- READ MODE --> <apex:includepageName="myObjectRead"rendered="{!isEditMode == false}"/>
<!-- EDIT MODE --> <apex:includepageName="myObjectEdit"rendered="{!isEditMode == true}"/>
</apex:page>

Folgendes passiert …

Bad value for restricted picklist field

Der Einsatz von "Restricted Picklists" bereitet spätestens im Deployment Kopfschmerzen.
Basiert das Deployment auf Basis eines Drittanbietertools, dann sind die Kopfschmerzen noch intensiver.

In meinem Fall habe ich versucht, ein neues Picklist-Feld mit Copado zu deployen.
Während der Bereitstellung bekomme ich die folgende Fehlermeldung:

System.DmlException: Insert failed. First exception on row 0; first error: INVALID_OR_NULL_FOR_RESTRICTED_PICKLIST, bad value for restricted picklist field: Z012: [CountryGroup__c]

Das neue Picklist-Feld übernimmt alle Werte aus einem Global Value Set.
Das bedeutet, die Option "Restrict to the values defined in the value set" ist automatisch aktiv und lässt sich nicht deaktivieren.


Eine APEX-Testklasse beschreibt ebenfalls die neue Pickliste.

Mit dem folgenden Workaround konnte ich das Deployment-Problem lösen:
1) Global Value Set samt Pickliste per Changeset in die Zielorg übertragen und bereitstellen

ggf. Profilberechtigungen anpa…

Salesforce.com Certified Advanced Administrator (WI15)

Im Vergleich zu den beiden Consultants Zertifizierungen war die Advanced Admin ein Spaziergang!
Allerdings ganz ohne Vorbereitung schafft man die Prüfung auch nicht.


Hier sind einige Fragen/Antworten aus der aktuellen Prüfung.

1. Capabilities of collaborative forecasting?
- Rename categories
- Forecast using opportunity splits
- Overlay Quota
- Add categories
- Select a default forecast currency setting

2. We have four Sales Regions. Each of the region's VPs wants to have a dashboard emailed every Monday.
- Create a separate dashboard for each VP
- Create one dashboard using Visualforce
- Create one dashboard that includes a filter for each region
- Create a reporting snapshot

3. User is trying to access content in a library, but receiving an insufficent privileges message.
How to troubleshoot?
- has the user's profile the CRM content permission enabled
- user has been granted permission "Viewer" to the library
- user's record has the CRM content permisson enabled
- …