Testen von Apex-Auslösern
Lernziele
Nachdem Sie diese Lektion abgeschlossen haben, sind Sie in der Lage, die folgenden Aufgaben auszuführen:
- Schreiben eines Tests für einen Auslöser, der durch einen einzelnen Datensatzvorgang ausgeführt wird
- Ausführen aller Testmethoden in einer Klasse
Voraussetzungen
Lassen Sie uns einen Auslöser testen, mit dem wir bereits im Modul Apex-Auslöser gearbeitet haben. Wenn ein Accountdatensatz mit Opportunities verknüpft ist, verhindert der Auslöser AccountDeletion, dass der Datensatz gelöscht wird.
Wenn Sie den Auslöser AccountDeletion noch nicht hinzugefügt haben, gehen Sie wie folgt vor.
- Drücken Sie in der Web Console (Webkonsole) Strg+Umschalt+P (Windows) oder ⌘+Shift+P (macOS), um die Command Palette (Befehlspalette) zu öffnen.
- Geben Sie
SFDX: Create Apex Trigger(SFDX: Apex-Auslöser erstellen) ein und drücken Sie die Eingabetaste.
- Geben Sie als Auslösernamen
AccountDeletionein und drücken Sie die Eingabetaste.
- Wählen Sie für das sObject Account aus und drücken Sie dann die Eingabetaste.
- Wählen Sie für das Auslöserereignis before delete aus und drücken Sie anschließend die Eingabetaste.
- Wählen Sie für das Ausgabeverzeichnis force-app/main/default/triggers aus und drücken Sie dann die Eingabetaste.
- Ersetzen Sie den standardmäßigen Auslösertext durch dieses Beispiel:
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 WITH USER_MODE]) {
Trigger.oldMap.get(a.Id).addError('Cannot delete account with related opportunities.');
}
}Wenn Sie den Auslöser AccountDeletion in einem vorherigen Abschnitt hinzugefügt, ihn jedoch deaktiviert haben, damit das System Ihre Abfrage prüfen kann, aktivieren Sie ihn wieder.
- Suchen Sie im Setup nach
Apex Triggers(Apex-Auslöser).
- Klicken Sie auf der Seite "Apex Triggers" (Apex-Auslöser) neben dem Auslöser
AccountDeletionauf Edit (Bearbeiten).
- Wählen Sie die Option Is Active (Ist aktiv) aus.
- Klicken Sie auf Speichern.
Wenn Ihre Organisation Auslöser namens AddRelatedRecord, CalloutTrigger oder HelloWorldTrigger aus einem vorherigen Abschnitt enthält, deaktivieren Sie diese. So deaktivieren Sie beispielsweise den Auslöser AddRelatedRecord:
- Suchen Sie im Setup nach
Apex Triggers(Apex-Auslöser).
- Klicken Sie auf der Seite "Apex Triggers" (Apex-Auslöser) neben dem Auslöser
AddRelatedRecordauf Edit (Bearbeiten).
- Deaktivieren Sie die Option Is Active (Ist aktiv).
- Klicken Sie auf Speichern.
Um auch die Auslöser HelloWorldTrigger und CalloutTrigger zu deaktivieren, wiederholen Sie die obigen Schritte.
Hinzufügen und Ausführen eines Einheitentests
Bevor Sie den Auslöser bereitstellen, schreiben Sie Einheitentests, um die Aktionen durchzuführen, durch die der Auslöser ausgeführt wird und die erwarteten Ergebnisse überprüft werden.
Fügen Sie zunächst eine Testmethode hinzu. Diese Testmethode prüft, was der Auslöser tun soll (der Gutfall): verhindern, dass ein Account gelöscht wird, wenn mit ihm Opportunities verknüpft sind.
- Drücken Sie in der Web Console (Webkonsole) Strg+Umschalt+P (Windows) oder ⌘+Shift+P (macOS), um die Command Palette (Befehlspalette) zu öffnen.
- Geben Sie
SFDX: Create Apex Class(SFDX: Apex-Klasse erstellen) ein und drücken Sie die Eingabetaste.
- Wählen Sie als Vorlagentyp DefaultApexClass aus und drücken Sie dann die Eingabetaste.
- Geben Sie als Klassennamen
TestAccountDeletionein und drücken Sie die Eingabetaste.
- Wählen Sie für das Ausgabeverzeichnis force-app/main/default/classes aus und drücken Sie dann die Eingabetaste.
- Ersetzen Sie den Standardtext der Klasse durch Folgendes:
@IsTest
private with sharing class TestAccountDeletion {
@IsTest
static void TestDeleteAccountWithOneOpportunity() {
// Test data setup
// Create an account with an opportunity, and then try to delete it
Account acct = new Account(Name='Test Account');
insert as user acct;
Opportunity opp = new Opportunity(
Name=acct.Name + ' Opportunity',
StageName='Prospecting',
CloseDate=System.today().addMonths(1),
AccountId=acct.Id);
insert as user opp;
// Perform test
Test.startTest();
Database.DeleteResult result = Database.delete(acct, false, AccessLevel.USER_MODE);
Test.stopTest();
// Verify
// In this case the deletion should have been stopped by the trigger,
// so verify that we got back an error.
Assert.isFalse(result.isSuccess());
Assert.isTrue(result.getErrors().size() > 0);
Assert.areEqual('Cannot delete account with related opportunities.',
result.getErrors()[0].getMessage());
}
}Die Testmethode richtet zuerst einen Testaccount mit einer Opportunity ein. Als Nächstes löscht sie den Testaccount, wodurch der Auslöser AccountDeletion ausgeführt wird. Die Testmethode prüft, ob der Auslöser das Löschen des Testaccounts verhindert hat, indem sie den Rückgabewert des Aufrufs Database.delete() überprüft. Bei dem Rückgabewert handelt es sich um ein Database.DeleteResult-Objekt, das Informationen über den Löschvorgang enthält. Die Testmethode prüft, dass der Löschvorgang nicht erfolgreich war, und überprüft die abgerufenen Fehlermeldungen.
- Speichern Sie die Testklasse.
- Klicken Sie in der Web Console (Webkonsole) in der "Activity Bar" (Aktivitätsleiste) auf
. Der seitliche Bereich "Testing" (Testen) wird geöffnet.
- Geben Sie in der Suchleiste "Testing" (Testen)
TestAccountDeletionein.
- Um alle Testmethoden in der Klasse auszuführen, bewegen Sie die Maus über die Zeile TestAccountDeletion und klicken auf
.
Die Testklasse TestAccountDeletion enthält nur eine Testmethode, die einen einzigen Accountdatensatz testet. Dieser Test ist außerdem für den Gutfall konzipiert. Testen Sie stets noch mehr Szenarien, um sicherzugehen, dass der Auslöser in allen Fällen funktioniert, z. B. beim Löschen eines Accounts ohne Opportunities oder beim Massenlöschen von Accounts.
Testdaten werden innerhalb der Testmethode eingerichtet, was zeitaufwändig sein kann, je mehr Testmethoden Sie hinzufügen. Wenn Sie über viele Testmethoden verfügen, verschieben Sie die Erstellung der Testdaten in eine Test-Dienstprogrammklasse und rufen Sie die Dienstprogrammklasse über mehrere Testmethoden auf. Im nächsten Abschnitt erfahren Sie, wie Sie eine Test-Dienstprogrammklasse nutzen und mehr Testmethoden hinzufügen können.
Weitere Infos
Die Testmethode enthält das Methodenpaar Test.startTest() und Test.stopTest(), das einen Codeblock begrenzt, für den neue Obergrenzen verwendet werden. In diesem Test werden für die Testdateneinrichtung zwei DML-Anweisungen angewendet, bevor der Test durchgeführt wird. Um zu testen, dass Apex-Code innerhalb der geltenden Obergrenzen ausgeführt wird, trennen Sie die Obergrenzenausnutzung der Dateneinrichtung vom Test selbst. Fügen Sie dazu den Testaufruf in den Block zwischen Test.startTest() und Test.stopTest() ein. Verwenden Sie diesen Testblock auch zum Testen von asynchronem Apex. Weitere Informationen finden Sie unter Using Limits, startTest, and stopTest.
Ressourcen
Vorbereiten auf die praktische Aufgabe
Damit Sie die praktische Aufgabe am Ende dieser Lektion absolvieren können, müssen Sie für das Objekt "Contact (Kontakt)" einen Apex-Auslöser namens RestrictContactByName mit dem nachfolgend angegebenen Code erstellen:
trigger RestrictContactByName on Contact (before insert, before update) {
//check contacts prior to insert or update for invalid data
for(Contact c : Trigger.New) {
if(c.LastName == 'INVALIDNAME') {
//invalidname is invalid
c.AddError('The Last Name "'+c.LastName+'" is not allowed for DML');
}
}
}