Zum Inhalt springen

Apex-Abschlussaktion erstellen

Nach diesen Schritten können Benutzer Ihre Apex-Logik auf den Ergebnissen einer Zielgruppe ausführen.

Bevor Sie beginnen

Edition
Professional und Ultimate
Berechtigung
Zugriff auf die CAB-Einstellungen über den Berechtigungssatz Campaign Audience Builder Admin und die Berechtigung, Apex bereitzustellen. Siehe Berechtigungssätze.

Was eine Abschlussaktion ist und wer sie ausführen kann, steht in So funktionieren Abschlussaktionen. Schnittstellen, Argumente und Ausführungsregeln stehen in Apex-Abschlussaktionen.

  1. Erstellen Sie eine global-Klasse mit einem zugänglichen parameterlosen Konstruktor, die lb.FinalAction_ManagedAsync_Interface implementiert.

  2. Lesen Sie in runSync die Datensätze aus AUDIENCE_RESULTS und Ihre eigenen Eingaben über ihre API-Namen:

    global with sharing class CreateFollowUpTasks
    implements lb.FinalAction_ManagedAsync_Interface {
    global CreateFollowUpTasks() {}
    global void runSync(String actionApiName, Map<String, Object> args) {
    List<Contact> contacts = (List<Contact>) args.get(
    lb.FinalAction.Variable.AUDIENCE_RESULTS.name()
    );
    String subject = (String) args.get('subject');
    List<Task> tasks = new List<Task>();
    for (Contact contact : contacts) {
    tasks.add(new Task(WhoId = contact.Id, OwnerId = contact.OwnerId, Subject = subject));
    }
    insert tasks;
    }
    }
  3. Verarbeiten Sie nur die Datensätze, die Sie bekommen: Bei großen Ergebnissen ruft CAB runSync einmal je Batch auf. Gestalten Sie die Logik so, dass sie sich gefahrlos wiederholen lässt, falls Salesforce einen Batch erneut ausführt.

  4. Stellen Sie die Klasse mit ihren Tests bereit.

  1. Wechseln Sie in den CAB-Einstellungen zu Konfigurieren → Automatisierung → Abschlussaktionen konfigurieren und wählen Sie Neu.

  2. Geben Sie den Name der Abschlussaktion ein. Der API-Name füllt sich von selbst; Ihre Klasse bekommt ihn als actionApiName.

  3. Setzen Sie Metadatentyp auf Apex und suchen Sie Ihre Klasse unter Apex-Klasse. Nur Klassen, die eine Schnittstelle für Abschlussaktionen implementieren, erscheinen.

  4. Optional: Geben Sie eine Beschreibung ein. Legen Sie unter Erweitert anzeigen eine Erfolgsmeldung, einen Name der benutzerdefinierten Berechtigung oder die Batch-Größe fest, die höchste Zahl an Datensätzen je Aufruf von runSync. Wählen Sie Weiter.

  5. Wählen Sie das Objekt unter Zielgruppen-Objekt auswählen, hier Kontakt. Fügen Sie unter Verfügbare Felder festlegen jedes Feld hinzu, das die Klasse liest, hier OwnerId. Wählen Sie Weiter.

  6. Wählen Sie unter Eingabewerte definieren für jede Eingabe, die die Klasse liest, Variable erstellen. Ihr Name ist der Schlüssel in args, hier subject mit dem Typ Text. Setzen Sie optional einen Standardwert.

  7. Wählen Sie Erledigt.

Alle Einstellungen beschreibt Flow-Abschlussaktionen; für Apex sind sie dieselben.

Öffnen Sie die Ergebnisse einer Kontakt-Zielgruppe. Die Abschlussaktion erscheint im Menü neben Zu Kampagne hinzufügen. Ihr Fenster zeigt die Beschreibung und die Eingaben; Ausführen startet sie.

Um eine ältere Klasse auf die verwaltete Schnittstelle umzustellen, siehe Apex-Abschlussaktionen.