Apex-Code – Übersicht

Apex kann in zwei verschiedenen Formen auf der Plattform gespeichert werden:

• Eine Klasse ist eine Vorlage oder ein Entwurf zum Erstellen von Apex-Objekten. Klassen bestehen aus anderen Klassen, benutzerdefinierten Methoden, Variablen, Ausnahmetypen und statischem Initialisierungscode. Geben Sie unter "Setup" im Feld Schnellsuche den Text Apex-Klassen ein und wählen Sie dann Apex-Klassen aus.
• Ein Auslöser ist Apex-Code, der ausgeführt wird, bevor oder nachdem bestimmte DML-Ereignisse (Data Manipulation Language) eintreten, beispielsweise vor dem Einfügen von Objektdatensätzen in die Datenbank oder nach dem Löschen von Datensätzen. Auslöser werden in Salesforce als Metadaten gespeichert. Eine Liste aller Auslöser in Ihrer Organisation finden Sie unter "Setup" auf der Seite "Apex-Auslöser".

Apex wird in der Regel innerhalb des Systemkontexts ausgeführt. Dies bedeutet, dass die Berechtigungen des aktuellen Benutzers und die Feldebenensicherheit bei der Code-Ausführung nicht berücksichtigt werden. Freigaberegeln werden jedoch nicht immer umgangen: die Klasse muss mit dem Stichwort without sharing deklariert werden, um sicherzustellen, dass Freigaberegeln nicht erzwungen werden.

Bevor Ihre Codes in Produktionsumgebungen bereitgestellt werden können, müssen mindestens 75 % Ihres Apex-Codes durch Einheitentests abgedeckt sein. Zudem müssen alle Auslöser eine gewisse Testabdeckung aufweisen.

Wiederholen Sie die Ausführung nach dem Erstellen der Klassen und Auslöser sowie der Tests mit der Developer Console.

Sie können Apex nur in einer Organisation mit einer Developer Edition, einer Testorganisation mit Salesforce Enterprise Edition oder einer Organisation mit Sandbox über die Salesforce-Benutzeroberfläche hinzufügen, bearbeiten oder löschen. In einer Salesforce-Produktionsorganisation können Sie Apex nur mit dem Metadaten-API-Aufruf "deploy", Salesforce-Erweiterungen für Visual Studio Code oder dem Ant-Migrationstool ändern. Die Salesforce-Erweiterungen für Visual Studio Code und das Ant-Migrationstool sind kostenlose Ressourcen, die von Salesforce zur Unterstützung der Benutzer und Partner zur Verfügung gestellt werden, gelten jedoch gemäß dem Rahmen-Abonnementvertrag (MSA) von Salesforce nicht als Teil der Salesforce-Services.

Weitere Informationen zur Syntax und Verwendung von Apex finden Sie im Apex Code Developer's Guide.

• Apex Developer Guide und Entwicklertools
  Der Apex Developer Guide und der Apex Reference Guide bieten eine vollständige Referenz für die Apex-Programmiersprache. Im Apex Developer Guide wird das Aufrufen von Apex, das Arbeiten mit Obergrenzen, das Schreiben von Tests usw. erläutert. Der Apex Reference Guide stellt Referenzinformationen zu Apex-Klassen, -Schnittstellen, -Ausnahmen usw. bereit. Zum Schreiben von Apex-Code können Sie aus unterschiedlichen Salesforce- und Drittanbietertools auswählen.
• Definieren von Apex-Klassen
  Salesforce speichert Apex-Klassen als Metadaten.
• Definieren von Apex-Auslösern
  Apex-Code kann mithilfe von Auslösern aufgerufen werden. Apex-Auslöser können konfiguriert werden, um benutzerdefinierte Aktionen vor oder nach Änderungen an Salesforce-Datensätzen durchzuführen, beispielsweise Einfügungen, Aktualisierungen oder Löschungen.
• Ausführen von anonymem Apex-Code
  Mithilfe der Developer Console können Sie Apex-Code ausführen, um Debug-Protokolle zu bestimmter Anwendungslogik zu generieren.
• Verhalten bei Auftreten einer Apex-Ausnahme
  Wenn eine Ausnahme auftritt, wird die Ausführung des Codes angehalten. Alle DML-Vorgänge, die vor der Ausnahme verarbeitet wurden, werden zurückgesetzt und nicht an die Datenbank übergeben. Ausnahmen werden in Debug-Protokollen protokolliert. Bei unbehandelten Ausnahmen, d. h. Ausnahmen, die der Code nicht erfasst, sendet Salesforce eine E-Mail mit Informationen zu der Ausnahme. Dem Endbenutzer wird auf der Salesforce-Benutzeroberfläche eine Fehlermeldung angezeigt.
• Behandlung von Apex-Ausnahmen in verwalteten Paketen
  Wenn Sie ein verwaltetes Paket für AppExchange erstellen, können Sie einen Benutzer angeben, der eine E-Mail-Benachrichtigung erhält, wenn eine Ausnahme auftritt, die nicht durch Apex abgefangen wird.
• Verwalten von Apex-Klassen
  Eine Apex-Klasse ist eine Vorlage oder ein Entwurf zum Erstellen von Apex-Objekten. Klassen bestehen aus anderen Klassen, benutzerdefinierten Methoden, Variablen, Ausnahmetypen und statischem Initialisierungscode.
• Verwalten von Apex-Auslösern
  Ein Auslöser ist Apex-Code, der ausgeführt wird, bevor oder nachdem bestimmte DML-Ereignisse (Data Manipulation Language) eintreten, beispielsweise vor dem Einfügen von Objektdatensätzen in die Datenbank oder nach dem Löschen von Datensätzen.
• Verwalten von Versionseinstellungen für Apex
  Zur Unterstützung der Abwärtskompatibilität werden Apex-Klassen und -Auslöser mit Versionseinstellungen für die Salesforce-API und alle referenzierten verwalteten Pakete gespeichert.
• Anzeigen von Apex-Klassen
  Wenn Sie eine Klasse erstellt haben, können Sie den enthaltenen Code sowie die API, für die die Klasse gespeichert wurde, anzeigen. Des Weiteren können Sie anzeigen, ob die Klasse gültig oder aktiv ist.
• Anzeigen der Details zu Apex-Auslösern
  Apex-Auslöser werden in der Anwendung, unter dem Objekt, dem sie zugeordnet sind, als Metadaten gespeichert.
• Erstellen einer Apex-Klasse aus einer WSDL
  Eine Apex-Klasse kann automatisch aus einem auf einer lokalen Festplatte oder in einem lokalen Netzwerk gespeicherten WSDL-Dokument generiert werden.
• Überwachen der Apex-Auftragswarteschlange
  Die Setup-Seite für Apex-Aufträge enthält Informationen über Apex-Aufträge, einschließlich des Prozentsatzes der asynchronen Apex-Nutzung und der Anzahl der Apex-Vorgänge, die außerhalb der zulässigen 24-Stunden-Obergrenze der Organisation verwendet wurden. Überwachen Sie den Status von Apex-Aufträgen, um möglichen Problemen mit Obergrenzen vorzubeugen, bevor sie auftreten.
• Überwachen der flexiblen Apex-Warteschlange
  Auf der Seite "Flexible Apex-Warteschlange" können Sie alle Batchaufträge mit dem Status "Halten" anzeigen und neu anordnen. Alternativ können Sie Batchaufträge auch programmatisch mithilfe von Apex-Code neu anordnen.
• Planen von Apex-Aufträgen
  Verwenden Sie den Apex-Planer und die Schnittstelle Schedulable, wenn Sie über bestimmte Apex-Klassen verfügen, die Sie regelmäßig ausführen möchten, oder um einen Apex-Batch-Auftrag über die Salesforce-Benutzeroberfläche auszuführen.
• Häufige gestellte Fragen zu Apex
  Häufig gestellte Fragen zu externen Webservices, unterstützten WSDL-Schematypen und Unterschieden zwischen Apex-Klassen und -Auslösern.