Direkt zum Hauptbereich

Lead-Konvertierung in Zusammenspiel mit Personenaccounts

Bevor ich die Besonderheiten der Lead-Konvertierung beschreibe, mache ich einen kurzen Exkurs in das Thema "Personenaccounts".
Personenaccounts ist ein Salesforce-Feature, das die Differenzierung zwischen den Business- und Consumer-Kunden ermöglicht.

Business-to-business (B2B):
- Standard (muss nicht aktiviert werden)
- ein Account mit einem oder mehreren Kontakten

Business-to-consumer (B2C):
- muss bei Bedarf von Salesforce aktiviert werden
- ein Account mit einem einzigen Kontakt

Wird ein Personenaccount (B2C) erstellt, sind zwangsweise 2 Datensätze (Account und Contact) in Salesforce sichtbar. Die Basis der beiden Datensätze ist dieselbe. Das bedeutet, jede Contact-Änderung hat sofort Auswirkung auf den Account und umgekehrt.

Das Öffnen eines B2C-Kontaktes aktiviert den Account-Tab.


Bei der Konvertierung von Leads wird das Feld "Company" ausgewertet.
Ein Eintrag im Feld "Company" erzeugt nach der Konvertierung einen B2B-Account.
Bleibt Company dagegen leer, wird ein Personenaccount (mit einem Contact) erstellt.

Was muss ich eigentlich bei der Lead-Konvertierung tun, wenn weitere Objekte am Lead dranhängen?
- Diese Unterobjekte müssen programmatisch mittels Trigger umgehängt werden. 
Glücklicherweise müssen wir im Backend die beiden Account-Typen, B2B und B2C, nicht unterscheiden. Nach der Lead-Konvertierung wird unter anderem das Feld "ConvertedContactId" mit der neuen Kontakt-ID gefüllt. Diese Id wird bei der Neu-Zuordnung von Unterobjekten genutzt.

Auszug aus dem Lead-Trigger:
/**********************
CONSTRUCTOR
***/
public f42_Lead_Helper(){
//******* OBJECT NAME , LOOKUP FIELD NAME (for LEAD) | LOOKUP FIELD NAME (for Contact) **********************
mapObjectsToUpdateAfterConversion = new map<String, String>();
mapObjectsToUpdateAfterConversion.put('Unterobjekt1', 'Lead__c|Contact__c');
mapObjectsToUpdateAfterConversion.put('Unterobjekt2', 'Lead_Name__c|Name__c');
}

/*++++++++++++++++++++
startAfterConversionProcess
+++*/
public void startAfterConversionProcess(list<Lead> lstObj, map<Id, Lead> mapObjOld){
 // map with all converted lead ids and account ids
 map<Id, id> mapConvertedContactByLead = new map<Id, Id>();
 // Initialize list with sObject to update
 list<sObject> lstObjUpdate = new list<sObject>();
 // Leads updated
 if(mapObjOld != null){
  for(Lead l :lstObj){
    // was the current lead converted?
   if(l.IsConverted == true && mapObjOld.get(l.id).IsConverted != true){
     // check the corresponding Person Account Id
    if(l.ConvertedContactId != null){
      mapConvertedContactByLead.put(l.id, l.ConvertedContactId);
    }
   }
  }
 }
 // get all related objects, reassign to the person account and put into update list
 if(!mapConvertedContactByLead.isEmpty()){
   reassignRecords(lstObjUpdate, mapConvertedContactByLead);
  if(!lstObjUpdate.isEmpty()){
   update lstObjUpdate;
  }
 }
}

/*------------------
reassignRecords
---*/
private void reassignRecords(list<sObject> lstObjUpdate, map<Id, id> mapConvertedContactByLead){
 // loop through all settings defined in constructor
 for(String s :mapObjectsToUpdateAfterConversion.keySet()){
  String sFields = mapObjectsToUpdateAfterConversion.get(s);
  String sFieldLead = sFields.substringBefore('|'); // LEAD Lookup Field
  String sFieldContact = sFields.substringAfter('|'); // CONTACT Lookup Field
  // all converted lead ids
  set<Id> setIdLeads = new set<Id>(mapConvertedContactByLead.keySet());
  // find lead's related records
  String q = 'Select ' + sFieldLead + ', ' + sFieldContact + ' From ' + s + ' Where ' + sFieldLead + ' in :setIdLeads';
  for(sObject sobj : database.query(q)){
   Id idLead = Id.valueOf(String.valueof(sobj.get(sFieldLead)));
   Id idContact = mapConvertedContactByLead.get(idLead);
   sobj.put(sFieldContact, idContact);
   lstObjUpdate.add(sobj);
  }
 }
}

Auszug aus der Testklasse:
static testMethod void myUnitTest() {
 // Create Test Data
 createTestData();
 //-------------------
 Test.startTest();
 // CONVERT LEAD
 Database.Leadconvert lc = new Database.Leadconvert();
 lc.setLeadId(l.id);
 LeadStatus convertStatus = [select id,MasterLabel from LeadStatus where isConverted=true limit 1];
 lc.setConvertedStatus(convertStatus.MasterLabel);
 Database.LeadConvertResult lcr = Database.convertLead(lc);

 Test.stopTest();
 // Check Lead
 Lead lCheck = [Select Id, ConvertedContactId from Lead where Id =:l.id];
 // Check related objects
 Unterobjekt1 check1 = [Select Contact__c from Unterobjekt1 where Lead__c =:l.id];
 Unterobjekt2 check2 = [Select Name__c from Unterobjekt2 where Lead__c =:l.id];

 system.assertNotEquals(null, lCheck.ConvertedContactId);
 system.assertEquals(lCheck.ConvertedContactId, check1.Contact__c);
 system.assertEquals(lCheck.ConvertedContactId, check2.Name__c);
}

Kommentare

Beliebte Posts aus diesem Blog

Community Builder funktioniert nicht

Nachdem ich eine in einer Sandbox konfigurierte und getestete Lightning Community per Changeset auf die Produktion übertrage und bereitgestellt hatte, stellte ich fest, dass sich die Community nicht konfigurieren lässt. Das Deployment lief fehlerfrei durch. Alle Komponenten der Lightning Community sind verfügbar. Jedoch erscheint die Fehlermeldung Cannot read property 'def' of undefined sobald ich auf den "Builder" - Link klicke. Folgendes Workaround löst das Problem: 1. Go to "All Communities" and click on "Workspaces" beside the problematic community. 2. Go to "Administration | Pages" and click on "Go to Site.com Studio". 3. Once site.com studio has finished loading, click on the "Site Actions" icon (small cog in top right of screen), and select "Export This Site". 4. When prompted, specify a local location to save the site export, and wait for the file download to complete. 5. After the d...

Salesforce Community URL Settings

Ich habe mich in den letzten Tagen etwas ausführlicher mit Salesforce Communities in Kombination mit der API beschäftigt. Ein Problem dabei war, den richtigen Endpoint zu berechnen, wie im letzten Beitrag beschrieben API im Salesforce Partner Portal. Um die Weichen im Code für Community Benutzer einzubauen, muss während der Laufzeit berechnet werden, in welchem Context sich der aktuell eingeloggte Benutzer befindet. Dabei muss man sich zwangsweise mit den Fragen folgender Art beschäftigen: ist der eingeloggte Benuter ein Community Benutzer? ob und welche Community ist gerade aktiv? wie sieht die definierte Community URL aus? Antwort auf die Frage 1: private Boolean isCommunityUser(){         Boolean bIsCommunityUser = false;         String sUserType = UserInfo.getUserType();         sUserType = sUserType.toUpperCase();         if(sUserTyp...

API im Salesforce Partner Portal

Eine von uns entwickelte Salesforce Applikation kommt im Partner Portal zum Einsatz. Diese beinhaltet unter anderem eine Visualforce Seite mit einer integrierten Flex-Applikation. Folgendes Abbild stellt das gesamte Konstrukt vereinfacht dar. Die Flex-Applikation bedient sich der Daten aus der aktuellen Salesforce-Instanz. Fehler im Partner-Portal kann trotz der aktivierten API-Einstellung keine Datenabfrage erfolgen Ursache der Controller der Visualforce-Seite übergibt den "falschen" Endpoint an die Flex App. Im Partner-Portal Context sieht die URL (in einer Sandbox) so aus: https://full-myorg-fullsb.cs80.force.com und wird wie folgt berechnet: System.URL.getSalesforceBaseUrl().getHost(); Lösung Statt Partner-Portal-URL muss die Salesforce-Instanz-URL eingesetzt werden: https://cs80.force.com Diese lässt sich wie folgt vom Controller berechnen ApexPages.currentPage().getHeaders().get('X-...