Flow ausführen

Überblick

Die Interaktion "Flow ausführen" löst einen Hintergrundprozess (einen autogestarteten Flow) innerhalb einer dynamischen Komponente aus. Dies ist nützlich, um Aufgaben zu automatisieren, Datensätze zu aktualisieren, Berechnungen durchzuführen oder jede andere Logik in einem Flow umzusetzen.

Wichtiger Hinweis

Die "Flow ausführen"-Interaktion ist für autogestartete Flows (Flows, die im Hintergrund laufen) konzipiert. Wenn Sie einen Screen Flow (einen Flow mit Benutzeroberflächenelementen) starten möchten, verwenden Sie stattdessen die "Flow-Dialog öffnen" oder "Flow-Panel öffnen"-Interaktionen

Wie es funktioniert

Die Interaktion "Flow ausführen" folgt einem einfachen Prozess, um Ihre Komponente mit der Salesforce-Automatisierung zu verbinden:

1. Flow auslösen Wenn ein Benutzer mit Ihrer Komponente interagiert (z. B. auf eine Schaltfläche klickt), startet die Interaktion "Flow ausführen" den angegebenen autogestarteten Flow im Hintergrund.

2. Daten an den Flow senden (optional) Übergeben Sie kontextbezogene Informationen von Ihrer Komponente an den Flow mithilfe von Eingabevariablen. Dadurch kann der Flow bestimmte Daten verarbeiten, wie z. B. Datensatz-IDs, Feldwerte oder Benutzerauswahlen.

3. Flow verarbeitet Ihre Logik Der autogestartete Flow führt seine konfigurierte Automatisierung aus — sei es das Erstellen von Datensätzen, das Durchführen von Berechnungen, das Aktualisieren von Daten oder jede andere von Ihnen definierte Geschäftslogik.

4. Ergebnisse vom Flow empfangen (optional) Erfassen Sie vom Flow zurückgegebene Daten über Ausgabevariablen. Diese Ergebnisse können neu erstellte Datensatz-IDs, berechnete Werte, Statusmeldungen oder andere Informationen enthalten, die der Flow erzeugt.

5. Abschluss behandeln (optional) Konfigurieren Sie, was passiert, nachdem der Flow erfolgreich beendet wurde oder auf einen Fehler gestoßen ist. Zeigen Sie Bestätigungsnachrichten an, aktualisieren Sie Daten, navigieren Sie zu einer anderen Seite oder lösen Sie zusätzliche Aktionen aus, um Benutzer zu informieren und ein reibungsloses Erlebnis sicherzustellen.

Konfiguration

Um die Interaktion "Flow ausführen" einzurichten, müssen Sie mehrere wichtige Einstellungen konfigurieren, die steuern, welcher Flow ausgeführt wird, welche Daten hinein und heraus gelangen und was nach der Ausführung passiert. Gehen wir jede Konfigurationsoption durch.

Flow-API-Name

Dies ist der eindeutige Bezeichner, der der Interaktion mitteilt, welchen autogestarteten Flow sie ausführen soll.

Format: Der API-Name genau wie im Flow-Builder definiert (z. B., Create_Case_Records, Calculate_Discount)
Wo Sie ihn finden: Öffnen Sie im Flow-Builder Ihren Flow und prüfen Sie die Flow-Eigenschaften — Sie sehen das Feld API-Name, wenn Sie den Flow speichern oder die Flow-Details anzeigen.
Wichtige Anforderungen:
- Der Flow muss aktiviert sein, bevor er ausgeführt werden kann.
- Muss ein autogestarteter Flow (kein Screen Flow oder Record-Triggered Flow) sein.

Flow-Eingabevariablen

Eingabevariablen ermöglichen es Ihnen, Daten von Ihrer dynamischen Komponente in den Flow zu senden, wenn er ausgeführt wird. Betrachten Sie diese als Parameter, die Sie an den Flow übergeben — z. B. Datensatz-IDs, Benutzerauswahlen oder Feldwerte, die der Flow zur Arbeit benötigt.

Wie Eingabevariablen funktionieren

Jede von Ihnen konfigurierte Eingabevariable wird einer entsprechenden Variable in Ihrem Flow zugeordnet.
Die Flow-Variablen müssen als "Für Eingabe verfügbar" im Flow-Builder markiert sein.
Sie können mehrere Eingabevariablen an eine einzelne Flow-Ausführung übergeben.

Konfiguration jeder Eingabevariable

Name

Der genaue API-Name der Eingabevariable, wie er in Ihrem Flow definiert ist.

Muss exakt übereinstimmen (case-sensitive).
Beispiele: recordId, opportunityStage, accountName

Wert

Die tatsächlichen Daten, die Sie an den Flow senden möchten. Sie können diesen Wert auf zwei Arten angeben:

Statischer Wert Geben Sie einen festen Wert direkt ein, der sich nie ändert. Beispiele: "Active", 100, true, "High Priority"
Dynamischer Wert (klicken Sie auf das Abbilden Symbol) Verknüpfen Sie den Wert mit einer dynamischen Quelle aus Ihrer Komponente. Wenn Sie auf das "Abgebildet"-Symbol klicken, können Sie auswählen aus:

Werttyp

Beschreibung

Komponenten-Ressource

Variablen, Abfragen oder Formeln, die in Ihrer dynamischen Komponente definiert sind

Komponentenattribute

Eigenschaften, die an Ihre Komponente übergeben werden

Globale Variablen

Systemweite Werte wie aktueller Benutzer oder Organisationsinformationen

Ausgewählte Zeilendaten

Daten aus einer ausgewählten Zeile in einer Datentabelle

Formeln

Berechnete Werte oder Ausdrücke

💡 Tipp: Verwenden Sie das Abgebildet-(x)-Symbol, wann immer der Wert dynamisch sein oder aus dem Kontext Ihrer Komponente stammen muss. Verwenden Sie statische Werte für Konstanten, die sich nie ändern.

Ausgabevariablen

Optional

Ausgabevariablen erfassen Daten, die der Flow nach seiner Ausführung zurückgibt. So kann Ihr Flow Ergebnisse an Ihre dynamische Komponente senden — wie neu erstellte Datensatz-IDs, berechnete Werte oder Statusmeldungen — die Sie dann zur Aktualisierung der UI oder zum Auslösen zusätzlicher Aktionen verwenden können.

Wie Ausgabevariablen funktionieren:

Jede von Ihnen konfigurierte Ausgabevariable wird einer entsprechenden Variable in Ihrem Flow zugeordnet.
Die Flow-Variablen müssen als "Für Ausgabe verfügbar" im Flow-Builder markiert sein.
Die zurückgegebenen Daten werden in einer von Ihnen angegebenen dynamischen Komponenten-Ressource gespeichert.

Konfiguration jeder Ausgabevariable:

Name Der genaue API-Name der Ausgabevariable, wie er in Ihrem Flow definiert ist.

Muss exakt übereinstimmen (case-sensitive).
Beispiele: outputContentDocumentId, calculatedDiscount, errorMessage

Ressourcenname Der Name der dynamischen Komponenten-Ressource, in der die Flow-Ausgabe gespeichert wird.

Dies muss eine Variable sein, die Sie bereits in Ihrer dynamischen Komponente erstellt haben.
Der Datentyp sollte mit dem vom Flow zurückgegebenen Typ übereinstimmen (Text, Zahl, Boolean, Datensatz usw.).

Beispielzuordnungen:

Flow gibt eine Dokument-ID zurück → Speichern in: contentDocumentId (Textvariable)
Flow gibt einen Rabattbetrag zurück → Speichern in: finalDiscount (Zahlvariable)
Flow gibt Erfolgsstatus zurück → Speichern in: wasSuccessful (Boolean-Variable)

💡 Tipp: Erstellen Sie Ihre dynamischen Komponentenvariablen, bevor Sie die Interaktion "Flow ausführen" konfigurieren, damit sie im Feld Ressourcenname auswählbar sind.

Beim Abschluss

Die On-Finish-Konfiguration definiert, was passiert, nachdem der Flow erfolgreich abgeschlossen wurde. Hier schaffen Sie ein reaktionsfähiges Benutzererlebnis, indem Sie Rückmeldungen geben, die Oberfläche aktualisieren oder Folgeaktionen auslösen.

Schritt-für-Schritt-Beispiel

Massenaktualisierung des Kontaktstatus

Dieses Beispiel zeigt, wie Sie eine Kopfzeilenaktions-Schaltfläche in einer Datentabelle erstellen, die den Status ausgewählter Kontaktdatensätze mithilfe eines autogestarteten Flows auf "Active" setzt.

Szenario

Sie haben eine Datentabelle in Ihrer dynamischen Komponente, die Kontaktdatensätze anzeigt. Sie möchten eine "Als aktiv setzen" Schaltfläche in den Kopfzeilenaktionen der Datentabelle hinzufügen. Wenn Benutzer eine oder mehrere Kontaktzeilen auswählen und auf diese Schaltfläche klicken, soll der Status der ausgewählten Kontakte automatisch über einen autogestarteten Flow auf "Active" gesetzt werden.

Was Sie erstellen werden:

Eine Datentabelle, die Kontaktdatensätze mit auswählbaren Zeilen anzeigt
Eine Kopfzeilenaktions-Schaltfläche mit der Bezeichnung "Als aktiv setzen"
Einen autogestarteten Flow, der das Statusfeld aktualisiert
Eine Interaktion "Flow ausführen", die beim Klicken der Schaltfläche ausgelöst wird

Erstellen Sie den autogestarteten Flow

Erstellen Sie zunächst den Flow, der die Massenstatusaktualisierung in Salesforce übernimmt.

Flow-Einrichtung

Gehen Sie in Salesforce Setup zu Flows → Neuer Flow
Wählen Sie Autogestarteter Flow (kein Trigger) und klicken Sie Erstellen

Flow-Logik

Der Flow benötigt drei Hauptkomponenten:

Eingabevariable (Collection):
- Name: ContactIds
- Typ: Text-Collection (muss mehrere Werte zulassen)
- Wesentlich: Diese muss als Collection konfiguriert sein, um mehrere Kontakt-IDs von der Datentabelle zu erhalten, wenn Benutzer mehrere Zeilen auswählen.
- Dadurch kann der Flow Massenaktualisierungen verarbeiten und nicht nur einen einzelnen Datensatz.
Aktualisiere-Datensätze-Element:
- Finde Kontakte, bei denen: Id ist in {!ContactIds}
- Feld aktualisieren: Status__c = "Active"
- Dies aktualisiert alle ausgewählten Kontaktdatensätze in der Masse.

Speichern und Aktivieren:

Speichern Sie den Flow mit einem beschreibenden Namen (z. B., Set_Contact_Status_Active)
Aktivieren Sie den Flow

Das zentrale Prinzip: Der Flow erhält eine Collection von Kontakt-IDs als Eingabe, findet alle passenden Kontaktdatensätze und aktualisiert deren Statusfeld auf "Active".

Konfigurieren Sie Ihre Datentabelle in der dynamischen Komponente

Sobald Ihr Flow erstellt und aktiviert ist, wechseln Sie zur Konfiguration Ihrer dynamischen Komponente, in der die Datentabelle die Kontaktdatensätze anzeigt.

Wo Sie sich befinden: Im Builder der dynamischen Komponente (nicht mehr im Flow-Builder)

Richten Sie Ihre Datentabelle so ein, dass Kontakte mit Zeilenauswahl angezeigt werden:

Wählen Sie Ihre Datentabelle-Komponente in der dynamischen Komponente
Konfigurieren Sie die Datenquelle und Spalten:
- Stellen Sie sicher, dass Ihre Datentabelle mit einer Abfrage-Ressource verbunden ist, die Kontaktdatensätze abruft.
- Fügen Sie der Datentabelle Spalten hinzu, indem Sie die anzuzeigenden Felder auswählen (z. B., Name, Status__c, E-Mail)
Aktivieren Sie die Mehrfachzeilen-Auswahl:
- Suchen Sie in den Eigenschaften der Datentabelle das Maximale Zeilenauswahl Attribut
- Stellen Sie sicher, dass es nicht auf 1 gesetzt ist damit Benutzer mehrere Datensätze in der Datentabelle auswählen können.
- So können Benutzer mehrere Kontakte gleichzeitig in der Masse aktualisieren.

Fügen Sie die Kopfzeilenaktions-Schaltfläche hinzu

Fügen Sie die Schaltfläche "Als aktiv setzen" zur Kopfzeile Ihrer Datentabelle hinzu:

Mit ausgewählter Datentabelle, navigieren Sie zum Kopfzeile Abschnitt im Eigenschaftenbereich
Klicken Sie auf "Kopfzeilenaktion hinzufügen"
Konfigurieren Sie die Schaltfläche:
- Beschriftung: Als aktiv setzen
- Symbol (optional): utility:check
- Typ: Schaltfläche

Konfigurieren der Interaktion "Flow ausführen"

Verbinden Sie nun die Kopfzeilenaktions-Schaltfläche mit Ihrem autogestarteten Flow, damit sie beim Klicken ausgelöst wird.

Wo Sie sich befinden: Noch im Builder der dynamischen Komponente, jetzt die Interaktion konfigurierend

Fügen Sie die Interaktion hinzu:
- Im Interaktionen-Bereich, klicken Sie auf "Interaktion hinzufügen"
- Interaktionstyp: Wählen Sie Kopfzeilen-Aktionsklick
- Zielname: Wählen Sie die in Schritt 3 erstellte Kopfzeilenaktions-Schaltfläche "Als aktiv setzen" aus.
Legen Sie den Aktionstyp fest:
- Typ: Wählen Sie Flow ausführen
Konfigurieren Sie die Flow-Verbindung: Flow-API-Name:
- Geben Sie ein: Set_Contact_Status_Active
- Dies muss genau mit dem API-Namen des in Schritt 1 erstellten autogestarteten Flows übereinstimmen.
Übergabe der ausgewählten Kontakt-IDs an den Flow: Flow-Eingabevariablen:
- Klicken Sie auf "Eingabevariable hinzufügen"
- Name: ContactIds (muss exakt mit dem Namen der Eingabevariable in Ihrem Flow übereinstimmen).
- Wert: Klicken Sie auf das Abgebildet-Symbol (🔗)
  - Navigieren Sie zu Ihrer Datentabelle-Komponente
  - Wählen Sie: {!DataTableComponentName.SelectedRowsKeyValue}
- Wichtig: Schalten Sie um auf "Mehrere Werte erlauben (Collection)"
  - Dies erlaubt das Übergeben mehrerer ausgewählter Kontakt-IDs aus der Datentabelle an den Flow als Collection.
  - Ohne dies würde nur eine Kontakt-ID übergeben werden.
Konfigurieren Sie, was passiert, nachdem der Flow abgeschlossen ist: On-Finish-Aktionen:
- Klicken Sie "Element hinzufügen" → "Alle Abfragen aktualisieren"
- Dies lädt die Datentabelle automatisch neu, damit nach Abschluss des Flows die aktualisierten Statuswerte angezeigt werden.

Was Sie konfiguriert haben: Wenn Benutzer auf die Schaltfläche "Als aktiv setzen" klicken, erfasst die Interaktion "Flow ausführen" alle ausgewählten Kontakt-IDs aus der Datentabelle, übergibt sie als Collection an Ihren Flow und aktualisiert die Tabelle, sobald die Aktualisierung abgeschlossen ist.

Aktivieren und testen

Jetzt, da alles konfiguriert ist, ist es Zeit, Ihre Arbeit zu testen:

Speichern Sie Ihre dynamische Komponente:
- Klicken Sie Speichern im Builder der dynamischen Komponente, um alle Änderungen zu speichern.
Auf einer Lightning-Seite bereitstellen:
- Navigieren Sie zu einer Lightning-Seite, auf der Sie diese Funktionalität verwenden möchten (z. B. eine Kontaktlisten-Seite oder Startseite).
- Bearbeiten Sie die Seite und fügen Sie Ihre dynamische Komponente hinzu.
- Speichern und Aktivieren die Seite
Testen Sie die Funktionalität:
- Gehen Sie zu der Lightning-Seite, auf der Sie Ihre Komponente hinzugefügt haben.
- Wählen Sie eine oder mehrere Kontaktzeilen, indem Sie die Kontrollkästchen anklicken.
- Klicken Sie auf das "Als aktiv setzen" Kopfzeilen-Schaltfläche
- Überprüfen Sie, dass:
  - Der Status der ausgewählten Kontakte auf "Active" aktualisiert wird.
  - Die Datentabelle sich automatisch aktualisiert, um die Änderungen anzuzeigen.
  - Sie können mehrere Kontakte gleichzeitig auswählen und aktualisieren.

Wichtige Überlegungen

Nur autogestartete Flows: Die Interaktion "Flow ausführen" funktioniert nur mit autogestartete autogestarteten Flows, nicht mit Screen Flows.
Namen von Ein-/Ausgabevariablen: Die API-Namen Ihrer Ein- und Ausgabevariablen müssen streng übereinstimmen zwischen dem Flow und der "Flow ausführen"-Konfiguration.
Fehlerbehandlung: Verwenden Sie die Aktion "Bei Fehler", um eventuelle Fehler während der Flow-Ausführung auf elegante Weise zu behandeln.
Datentypen: Stellen Sie sicher, dass die Datentypen Ihrer Ein- und Ausgabevariablen zwischen Flow und Komponente übereinstimmen.

Zusammenfassung

Die Flow ausführen Interaktion ermöglicht es Ihnen, autogestartete Flows direkt aus Ihren dynamischen Komponenten auszulösen und somit leistungsstarke Automatisierungen zu erstellen, ohne dass Benutzer die Seite verlassen müssen.

Hauptfunktionen

Aufgaben im Hintergrund automatisieren - Aktualisieren Sie Datensätze, führen Sie Berechnungen durch oder führen Sie komplexe Geschäftslogik aus, wenn Benutzer mit Ihrer Komponente interagieren.
Dynamische Daten an Flows übergeben - Senden Sie kontextspezifische Informationen wie ausgewählte Datensatz-IDs, Benutzereingaben oder Feldwerte über Eingabevariablen.
Ergebnisse intelligent verarbeiten - Erfassen Sie Flow-Ausgaben und nutzen Sie sie, um Ihre Benutzeroberfläche zu aktualisieren, Meldungen anzuzeigen oder Folgeaktionen auszulösen.
Nahtlose Erlebnisse schaffen - Kombinieren Sie "Flow ausführen" mit Aktionen wie dem Aktualisieren von Daten, dem Anzeigen von Toast-Benachrichtigungen oder der Navigation zu anderen Seiten, um Benutzer informiert zu halten.

Best Practices

Verwenden Sie stets autogestartete Flows (keine Screen Flows) mit dieser Interaktion.
Stellen Sie sicher, dass Variablennamen genau zwischen Ihrem Flow und der "Flow ausführen"-Konfiguration übereinstimmen.
Verwenden Sie Collections für Eingabevariablen, wenn Sie mit mehreren ausgewählten Datensätzen arbeiten.
Konfigurieren Sie Beim Abschluss und "Bei Fehler"- Aktionen, um den Benutzern klare Rückmeldungen zu geben.
Testen Sie gründlich mit sowohl einzelner als auch mehrfacher Datensatzauswahl.

Die Interaktion "Flow ausführen" überbrückt die Lücke zwischen Benutzeroberfläche und Automatisierung und ermöglicht es Ihnen, anspruchsvolle, benutzerfreundliche Anwendungen zu erstellen, die die volle Leistungsfähigkeit von Salesforce Flows nutzen.

Zuletzt aktualisiert vor 22 Tagen

War das hilfreich?