Erste Schritte mit Apex-Auslösern

• Schreiben eines Auslösers für ein Salesforce-Objekt
• Verwenden von Auslöser-Kontextvariablen
• Aufrufen einer Klassenmethode über einen Auslöser
• Verwenden der sObject-Methode addError() in einem Auslöser, um Speichervorgänge zu beschränken

Hinweis

Lernen Sie auf Deutsch? In diesem Badge ist für die praktischen Trailhead-Aufgaben Englisch als Bearbeitungssprache festgelegt. Übersetzungen werden zur Referenz in Klammern angegeben. Vergewissern Sie sich, dass Sie in Ihrem Trailhead-Playground (1) das Gebietsschema auf USA und (2) die Sprache auf Englisch festgelegt haben. (3) Verwenden Sie zum Kopieren und Einfügen nur die englischen Werte. Die zugehörigen Anweisungen finden Sie hier.

Im Badge "Trailhead in Ihrer Sprache" erfahren Sie, wie Sie die übersetzte Trailhead-Umgebung nutzen.

Bevor Sie loslegen

Apex-Auslöser sind überaus nützlich. Dieses Modul hilft Ihnen nicht nur bei den ersten Schritten, sondern enthält auch Verweise auf andere Salesforce-Funktionen, um Ihnen die Leistungsfähigkeit von Apex-Auslösern zu zeigen. Um den größten Nutzen aus diesem Modul zu ziehen, empfehlen wir Ihnen wärmstens, sich zuerst diese Module anzusehen:

• Schnelleinstieg: Apex
• Apex – Grundlagen und Datenbank
• SOQL für Administratoren
• Grundlagen der Entwicklerkonsole

Beispiel eines Auslösers

Typen von Auslösern

Es gibt zwei Typen von Auslösern.

• Before-Auslöser werden zum Aktualisieren oder Validieren von Datensatzwerten verwendet, bevor diese in der Datenbank gespeichert werden.
• After-Auslöser werden verwendet, um auf Feldwerte zuzugreifen, die vom System festgelegt werden (z. B. das Feld Id oder LastModifiedDate eines Datensatzes), und um Änderungen in anderen Datensätzen zu bewirken. Die Datensätze, durch die der after-Auslöser ausgeführt wird, sind schreibgeschützt.

Verwenden von Kontextvariablen

Verwenden Sie zum Zugreifen auf die Datensätze, durch die der Auslöser ausgeführt wurde, Kontextvariablen. Trigger.new enthält beispielsweise alle Datensätze, die in "insert"- oder "update"-Auslöser eingefügt wurden. Trigger.old enthält die alte Version von sObjects, bevor sie in "update"-Auslösern aktualisiert wurden, oder eine Liste mit gelöschten sObjects in "delete"-Auslösern. Auslöser können ausgeführt werden, wenn ein einzelner Datensatz eingefügt wird oder wenn mehrere Datensätze als Massenvorgang über die API oder Apex eingefügt werden. Daher können Kontextvariablen wie Trigger.new nur einen oder mehrere Datensätze enthalten. Sie können Trigger.new durchlaufen, um jedes einzelne sObject abzurufen.

Das folgende Beispiel ist eine geänderte Version des Beispielauslösers HelloWorldTrigger. Darin wird jeder Account in einer "for"-Schleife durchlaufen und das jeweilige Description (Beschreibungsfeld) aktualisiert.

trigger HelloWorldTrigger on Account (before insert) {
    for(Account a : Trigger.new) {
        a.Description = 'New description';
    }   
}

Das System speichert die Datensätze, durch die der before-Auslöser ausgeführt wurde, nach der Ausführung des Auslösers. Sie können die Datensätze im Auslöser ändern, ohne explizit einen DML-insert- oder -update-Vorgang aufzurufen. Wenn Sie bei diesen Datensätzen DML-Anweisungen ausführen, wird ein Fehler ausgegeben.

Einige andere Kontextvariablen geben einen booleschen Wert zurück, um anzugeben, ob der Auslöser aufgrund einer Aktualisierung oder eines anderen Ereignisses ausgeführt wurde. Diese Variablen sind nützlich, wenn ein Auslöser mehrere Ereignisse kombiniert. Beispiel:

trigger ContextExampleTrigger on Account (before insert, after insert, after delete) {
    if (Trigger.isInsert) {
        if (Trigger.isBefore) {
            // Process before insert
        } else if (Trigger.isAfter) {
            // Process after insert
        }        
    }
    else if (Trigger.isDelete) {
        // Process after delete
    }
}

Die folgende Tabelle enthält eine vollständige Liste aller für Auslöser verfügbaren Kontextvariablen.

Aufrufen einer Klassenmethode über einen Auslöser

Sie können öffentliche Dienstprogrammmethoden über einen Auslöser aufrufen. Das Aufrufen von Methoden anderer Klassen ermöglicht die Wiederverwendung von Code, reduziert die Größe der Auslöser und vereinfacht die Pflege des Apex-Codes. Außerdem können Sie damit objektorientierte Programmierung verwenden.

Der folgende Beispielauslöser zeigt, wie eine statische Methode über einen Auslöser aufgerufen wird. Wenn der Auslöser aufgrund eines insert-Ereignisses ausgeführt wurde, ruft das Beispiel die statische Methode "sendMail()" in der Klasse "EmailManager" auf. Diese Dienstprogrammmethode sendet eine E-Mail an den angegebenen Empfänger und enthält die Anzahl der eingefügten Kontaktdatensätze.

1. Klicken Sie in der Developer Console auf File (Datei) | New (Neu) | Apex Class (Apex-Klasse).
2. Geben Sie EmailManager ein und klicken Sie auf "OK".
3. Ersetzen Sie den Standardtext der Klasse durch das nachfolgenden Beispiel für die "EmailManager"-Klasse.

   public class EmailManager {
       // Public method
       public static void sendMail(String address, String subject, String body) {
           // Create an email message object
           Messaging.SingleEmailMessage mail = new Messaging.SingleEmailMessage();
           String[] toAddresses = new String[] {address};
           mail.setToAddresses(toAddresses);
           mail.setSubject(subject);
           mail.setPlainTextBody(body);
           // Pass this email message to the built-in sendEmail method 
           // of the Messaging class
           Messaging.SendEmailResult[] results = Messaging.sendEmail(
                                     new Messaging.SingleEmailMessage[] { mail });
           // Call a helper method to inspect the returned results
           inspectResults(results);
       }
       // Helper method
       private static Boolean inspectResults(Messaging.SendEmailResult[] results) {
           Boolean sendResult = true;
           // sendEmail returns an array of result objects.
           // Iterate through the list to inspect results. 
           // In this class, the methods send only one email, 
           // so we should have only one result.
           for (Messaging.SendEmailResult res : results) {
               if (res.isSuccess()) {
                   System.debug('Email sent successfully');
               }
               else {
                   sendResult = false;
                   System.debug('The following errors occurred: ' + res.getErrors());                 
               }
           }
           return sendResult;
       }
   }

4. Klicken Sie in der Developer Console auf File (Datei) | New (Neu) | Apex Trigger (Apex-Auslöser).
5. Geben Sie als Auslösernamen ExampleTrigger ein und wählen Sie dann Contact für das sObject aus. Klicken Sie auf Submit (Senden).
6. Ersetzen Sie den Standardcode durch Folgendes und ersetzen Sie dann den Platzhaltertext für die E-Mail-Adresse in sendMail() durch Ihre E-Mail-Adresse.

   trigger ExampleTrigger on Contact (after insert, after delete) {
       if (Trigger.isInsert) {
           Integer recordCount = Trigger.new.size();
           // Call a utility method from another class
           EmailManager.sendMail('Your email address', 'Trailhead Trigger Tutorial', 
                       recordCount + ' contact(s) were inserted.');
       }
       else if (Trigger.isDelete) {
           // Process after delete
       }
   }

7. Speichern Sie mit Strg+S.
8. Um den Auslöser zu testen, erstellen Sie einen Kontakt.
   1. Klicken Sie auf Debug | Open Execute Anonymous Window (Debuggen | Fenster für die anonyme Ausführung öffnen).
   2. Fügen Sie in dem neuen Fenster Folgendes hinzu und klicken Sie dann auf Execute (Ausführen).

      Contact c = new Contact(LastName='Test Contact');
      insert c;

9. Überprüfen Sie im Debug-Protokoll, dass der Auslöser ausgeführt wurde. Suchen Sie am Ende des Protokolls nach der Debug-Meldung, die von der Dienstprogrammmethode geschrieben wurde: DEBUG|Email sent successfully
10. Kontrollieren Sie jetzt, dass Sie eine E-Mail mit dem Nachrichtentext 1 contact(s) were inserted (1 Kontakt(e) wurde(n) eingefügt) erhalten haben.
    
    Mit dem neuen Auslöser erhalten Sie jedes Mal eine E-Mail, wenn Sie einen oder mehrere Kontakte hinzufügen.

Hinzufügen verknüpfter Datensätze

Auslöser werden oft zum Zugreifen auf und Verwalten von Datensätzen verwendet, die mit den Datensätzen im Auslöserkontext, d. h. den Datensätzen, durch die dieser Auslöser ausgeführt wurde, verknüpft sind.

Dieser Auslöser fügt für jeden neuen oder aktualisierten Account eine verknüpfte Opportunity hinzu, wenn dem betreffenden Account noch keine Opportunity zugeordnet ist. Der Auslöser führt zuerst eine SOQL-Abfrage durch, um alle untergeordneten Opportunities für die Accounts abzurufen, bei denen der Auslöser ausgeführt wurde. Als Nächstes durchläuft der Auslöser die Liste der sObjects in Trigger.new, um jedes Account-sObject abzurufen. Wenn mit dem Account noch kein Opportunity-sObject verknüpft ist, erstellt die For-Schleife eines. Wenn der Auslöser neue Opportunities erstellt hat, werden diese durch die letzte Anweisung eingefügt.

1. Fügen Sie den folgenden Auslöser mithilfe der Entwicklerkonsole hinzu (führen Sie dazu die Schritte im Beispiel HelloWorldTrigger aus, geben Sie jedoch als Auslösernamen AddRelatedRecord ein).

   trigger AddRelatedRecord on Account(after insert, after update) {
       List<Opportunity> oppList = new List<Opportunity>();
       // Get the related opportunities for the accounts in this trigger
       Map<Id,Account> acctsWithOpps = new Map<Id,Account>(
           [SELECT Id,(SELECT Id FROM Opportunities) FROM Account WHERE Id IN :Trigger.new]);
       // Add an opportunity for each account if it doesn't already have one.
       // Iterate through each account.
       for(Account a : Trigger.new) {
           System.debug('acctsWithOpps.get(a.Id).Opportunities.size()=' + acctsWithOpps.get(a.Id).Opportunities.size());
           // Check if the account already has a related opportunity.
           if (acctsWithOpps.get(a.Id).Opportunities.size() == 0) {
               // If it doesn't, add a default opportunity
               oppList.add(new Opportunity(Name=a.Name + ' Opportunity',
                                          StageName='Prospecting',
                                          CloseDate=System.today().addMonths(1),
                                          AccountId=a.Id));
           }           
       }
       if (oppList.size() > 0) {
           insert oppList;
       }
   }

2. Um den Auslöser zu testen, erstellen Sie auf der Salesforce-Benutzeroberfläche einen Account und nennen Sie ihn Apples & Oranges.
3. Suchen Sie in der Themenliste "Opportunities" auf der Seite des Accounts nach der neuen Opportunity. Der Auslöser hat diese Opportunity automatisch hinzugefügt!

Der Auslöser, den Sie hinzugefügt haben, durchläuft alle Datensätze, die Teil des Auslöserkontexts sind, d. h., die "for"-Schleife durchläuft Trigger.new. Die Schleife in diesem Auslöser könnte jedoch effizienter sein. Wir benötigen nicht wirklich Zugriff auf jeden Account in diesem Auslöserkontext, sondern nur auf einen Teil davon, nämlich die Accounts ohne Opportunities. Im nächsten Abschnitt wird veranschaulicht, wie dieser Auslöser effizienter gestaltet werden kann. Im Abschnitt "Designmuster für Massenauslöser" wird gezeigt, wie die SOQL-Abfrage geändert wird, sodass nur die Accounts ohne Opportunities abgerufen werden. Anschließend lernen Sie, wie Sie nur diese Datensätze durchlaufen.

Verwenden von Auslöserausnahmen

In manchen Fällen müssen Sie Beschränkungen für bestimmte Datenbankvorgänge hinzufügen, z. B. wenn Sie verhindern möchten, dass Datensätze gespeichert werden, sobald bestimmte Bedingungen erfüllt sind. Um das Speichern von Datensätzen in einem Auslöser zu verhindern, rufen Sie die Methode "addError()" für das betreffende sObject auf. Die Methode "addError()" löst einen schwerwiegenden Fehler in einem Auslöser aus. Die Fehlermeldung wird auf der Benutzeroberfläche angezeigt und protokolliert.

Der folgende Auslöser verhindert das Löschen eines Accounts, wenn damit Opportunities verknüpft sind. Standardmäßig führt das Löschen eines Accounts zu einer Kaskadenlöschung aller seiner verknüpften Datensätze. Dieser Auslöser verhindert die Kaskadenlöschung von Opportunities. Probieren Sie diesen Auslöser selbst aus. Wenn Sie das vorherige Beispiel ausgeführt haben, verfügt Ihre Organisation jetzt über einen Account namens Apples & Oranges mit einer verknüpften Opportunity. In folgendem Beispiel wird dieser Beispielaccount verwendet.

1. Fügen Sie mithilfe der Entwicklerkonsole folgenden Auslöser hinzu.

   trigger AccountDeletion on Account (before delete) {
       // Prevent the deletion of accounts if they have related opportunities.
       for (Account a : [SELECT Id FROM Account
                        WHERE Id IN (SELECT AccountId FROM Opportunity) AND
                        Id IN :Trigger.old]) {
           Trigger.oldMap.get(a.Id).addError(
               'Cannot delete account with related opportunities.');
       }
   }

2. Wechseln Sie auf der Salesforce-Benutzeroberfläche zur Seite des Accounts Apples & Oranges und klicken Sie auf Löschen.
3. Klicken Sie im eingeblendeten Bestätigungsfenster auf OK.
   
   Suchen Sie nach dem Validierungsfehler mit der benutzerdefinierten Fehlermeldung Cannot delete account with related opportunities. (Account mit verknüpften Opportunities kann nicht gelöscht werden).
   
   
4. Deaktivieren Sie den Auslöser AccountDeletion. Wenn Sie diesen Auslöser im aktiven Status belassen, können Sie Ihre Abfragen nicht überprüfen.
   1. Suchen Sie im Setup nach Apex Triggers (Apex-Auslöser).
   2. Klicken Sie auf der Seite "Apex Triggers" (Apex-Auslöser) neben dem Auslöser AccountDeletion auf Edit (Bearbeiten).
   3. Deaktivieren Sie die Option Is Active (Ist aktiv).
   4. Klicken Sie auf Speichern.

Durch Aufrufen von addError() in einem Auslöser werden alle Vorgänge per Rollback zurückgesetzt, es sei denn, ein DML-Massenvorgang wird mit Teilerfolg aufgerufen.

• Wenn der Ursprung des Auslösers ein DML-Massenaufruf in der Lightning-Plattform-API ist, stellt die Laufzeit-Engine die fehlerhaften Datensätze beiseite. Anschließend versucht die Laufzeit-Engine, eine teilweise Speicherung der Datensätze vorzunehmen, die keine Fehler erzeugt haben.
• Wenn der Ursprung des Auslösers eine DML-Anweisung in Apex ist, führt jeder Fehler dazu, dass der gesamte Vorgang zurückgesetzt wird. Die Laufzeit-Engine verarbeitet jedoch weiterhin jeden Datensatz im Vorgang, um eine ausführliche Fehlerliste zusammenzustellen.

Auslöser und Callouts

Mit Apex können Sie Aufrufe bei externen Webservices vornehmen und Ihren Apex-Code in externe Webservices integrieren. Apex-Aufrufe bei externen Webservices werden als Callouts bezeichnet. Sie können beispielsweise einen Callout bei einem Kursabfragesystem vornehmen, um die aktuellen Aktienkurse abzurufen. Beim Senden eines Callouts über einen Auslöser muss der Callout asynchron erfolgen, sodass der Auslöserprozess Sie nicht am Arbeiten hindert, während auf die Antwort vom externen Service gewartet wird. Der asynchrone Callout erfolgt in einem Prozess im Hintergrund und die Antwort wird empfangen, sobald der externe Service sie zurückgibt.

Um einen Callout über einen Auslöser vorzunehmen, rufen Sie eine Klassenmethode auf, die asynchron ausgeführt wird. Eine solche Methode wird als future-Methode bezeichnet und mit der Anmerkung "@future(callout=true)" gekennzeichnet. Die folgende Beispielklasse enthält die future-Methode, die den Callout vornimmt.

In dem Beispiel wird zur Veranschaulichung ein hypothetischer Endpunkt-URL verwendet. Sie können dieses Beispiel nur ausführen, wenn Sie den Endpunkt in einen gültigen URL ändern und für Ihren Endpunkt einen Remote-Standort in Salesforce hinzufügen.

public class CalloutClass {
    @future(callout=true)
    public static void makeCallout() {
        HttpRequest request = new HttpRequest();
        // Set the endpoint URL.
        String endpoint = 'http://yourHost/yourService';
        request.setEndPoint(endpoint);
        // Set the HTTP verb to GET.
        request.setMethod('GET');
        // Send the HTTP request and get the response.
        HttpResponse response = new HTTP().send(request);
    }
}

Das folgende Beispiel zeigt den Auslöser, der die Methode in der Klasse aufruft, um einen Callout asynchron vorzunehmen.

trigger CalloutTrigger on Account (before insert, before update) {
    CalloutClass.makeCallout();
}

Dieser Abschnitt bietet nur einen Überblick über Calllouts und ist nicht dazu gedacht, Callouts im Detail zu behandeln. Weitere Informationen finden Sie im Apex Developer Guide unter Invoking Callouts Using Apex.