> For the complete documentation index, see [llms.txt](https://docs.avonnicomponents.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.avonnicomponents.com/experience-cloud/experience-cloud-de/eigenschaftenbereich/interactions/execute-flow.md). # Flow ausführen Führe im Hintergrund einen automatisch gestarteten Salesforce-Flow aus einer Avonni-Komponente aus, ohne einen Dialog zu öffnen oder die Seite zu verlassen. ## Übersicht Die Interaktion „Flow ausführen“ startet einen automatisch gestarteten Flow, wenn ein Benutzer mit einer Komponente auf Ihrer Experience Site interagiert — etwa durch Klicken auf eine Schaltfläche, eine Zeilenaktion, eine Kopfzeilenaktion oder ein Element in einer Liste. Auf dem Bildschirm öffnet sich nichts: Der Flow läuft serverseitig, erledigt seine Arbeit (Datensätze aktualisieren, einen Wert berechnen, ein anderes System aufrufen) und die Seite, auf der sich der Benutzer befindet, bleibt genau dort, wo sie ist. Richte es wie jede andere Interaktion ein. Experience Builder hat keinen Tab „Interaktionen“, daher befindet sich die Einstellung im Editor für das Ereignis, das du verknüpfst — einer Schaltfläche **Bei Klick**, einer Zeilenaktion **Bei Klick**, einer Spaltenkopfaktion **Bei Klick** — wo du auswählst **Flow ausführen** als Interaktion **Typ**. {% hint style="warning" %} **Flow ausführen** führt *automatisch gestartete* nur Flows aus. Um einen Bildschirm-Flow — einen Flow mit Benutzeroberfläche — zu starten, verwende [Flow-Dialog öffnen](/experience-cloud/experience-cloud-de/eigenschaftenbereich/interactions/open-flow-dialog.md) oder [Flow-Panel öffnen](/experience-cloud/experience-cloud-de/eigenschaftenbereich/interactions/open-flow-panel.md) stattdessen. {% endhint %} Im Gegensatz zu diesen beiden Interaktionen muss der Flow nicht auf einer Seite deiner Website liegen: „Flow ausführen“ startet ihn serverseitig, sodass keine Website-Seite ihn hostet und nichts veröffentlicht werden muss, damit er gefunden werden kann. {% hint style="info" %} **Flow ausführen wird weder im Experience Builder noch in der Site-Vorschau ausgeführt.** Wenn du es dort auslöst, erscheint ein Toast, der darauf hinweist, dass die Interaktion in der Vorschau nicht ausgeführt wird, und der Flow wird übersprungen. Teste es auf der veröffentlichten Site. {% endhint %} ## Konfiguration | Name | Beschreibung | | ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Flow-API-Name** | Der auszuführende Flow. Die Liste bietet die automatisch gestarteten Flows in deiner Organisation nach ihrem **Label**, nicht nach ihrem API-Namen, und kann durchsucht werden. Lege ihn zuerst fest: Die drei Einstellungen unten bleiben ausgeblendet, bis er festgelegt ist. | | **Flow-Eingabevariablen** | Die Werte, die vor dem Start an den Flow übergeben werden, ein Eintrag pro Variable. Siehe unten. | | **Bei Abschluss** | Die Interaktionen, die ausgeführt werden, sobald der Flow erfolgreich abgeschlossen wurde. Akzeptierte Interaktionen sind **Toast anzeigen** und **Alle Abfragen aktualisieren**. | | **Bei Fehler** | Die Interaktionen, die ausgeführt werden, wenn der Flow fehlschlägt. Akzeptierte Interaktionen sind **Toast anzeigen** und **Alle Abfragen aktualisieren**. | ### Flow-Eingabevariablen Jeder Eintrag ordnet eine der Eingabevariablen des Flows zu. Die Variable muss in Flow Builder als **Für Eingabe verfügbar** markiert sein, und ihr API-Name ist groß-/kleinschreibungssensitiv. * **Name:** die Flow-Variable, die gesetzt werden soll. Die Liste bietet die Eingabevariablen des ausgewählten Flows. * **Wert:** der zuzuweisende Wert. Was diese Eingabe anbietet, hängt vom Editor ab, in dem du dich befindest. In einem Zeilen- oder Element-Editor — eine Daten-Tabellenzeilenaktion, ein Listen-Element, eine Spaltenkopfaktion in einem Baumraster — kannst du **Benutzerdefiniert** wählen, um einen statischen Wert einzugeben, oder eines der Datensatzfelder auswählen, die die Komponente an diesem Punkt bereitstellt; dadurch wird ein `{{Record.}}` Token eingefügt, sodass jede Zeile oder jedes Element ihren bzw. seinen eigenen Wert übergibt; diese Feldoptionen stammen aus der Komponente **Abfrage** Datenquelle. Im Button-, Banner-, Metrik- und Kopfzeilenaktions-Editor gibt es keinen Datensatz hinter dem Klick, daher ist **Wert** ein einfaches Texteingabefeld. * **Typ:** der Datentyp des Werts — **Text** (Standard), **Zahl**, **Boolesch**, **Datum**, **Datum/Uhrzeit** oder **Salesforce-Objekt**. Wähle **Benutzerdefiniert** um einen Typ einzugeben, der nicht in der Liste enthalten ist. * **Objekt-API-Name:** das Objekt, das der Wert repräsentiert, zum Beispiel `Account` oder `Contact`. Erfordert **Typ** zu sein **Salesforce-Objekt**. * **Mehrere Werte zulassen (Sammlung):** schalte dies ein, wenn der Wert eine Sammlung statt eines einzelnen Werts ist. Nur **Name** und **Wert** werden an den Flow gesendet. **Typ**, **Objekt-API-Name** und **Mehrere Werte zulassen (Sammlung)** beschreiben den Wert für die Komponente, damit sie das Token vor dem Aufruf auflösen kann – sie teilen dem Flow nichts mit und können eine Abweichung davon, wie die Variable in Flow Builder deklariert ist, nicht beheben. ### Bei Abschluss und bei Fehler **Bei Abschluss** ist der Ort, an dem du dem Benutzer mitteilst, was passiert ist, und die Seite auf den neuesten Stand bringst – ein **Toast anzeigen** Toast, der die Aktion bestätigt, ein **Alle Abfragen aktualisieren** Aktualisierung aller Abfragen, damit die Komponenten auf der Seite die Datensätze neu lesen, die der Flow geändert hat. **Bei Fehler** deckt den umgekehrten Fall ab. Wenn du dort keine **Toast anzeigen** konfigurierst, zeigt die Komponente ihren eigenen Fehler-Toast an, mit dem Titel „Fehler bei der Ausführung des Flows“, und verweist auf die zwei üblichen Ursachen: Der Flow ist nicht aktiv oder der Benutzer, der ihn ausführt, hat keinen Zugriff darauf. ## Beispiel Eine Datentabelle listet die Fälle auf, die ein Portalbenutzer geöffnet hat, und du möchtest eine Zeilenaktion, die den Fall an die Support-Warteschlange übergibt. 1. Erstelle im Flow Builder einen automatisch gestarteten Flow — mit der Bezeichnung `Fall eskalieren`, API-Name `Escalate_Case` — mit einer Text-Eingabevariablen `recordId` mit dem Kennzeichen **Für Eingabe verfügbar**, einem Datensätze aktualisieren-Element, das den Status und die Warteschlange des Falls setzt, und speichere und aktiviere ihn dann. 2. Wähle im Experience Builder die Datentabelle aus und ordne eine Spalte zu mit **Typ** festgelegt auf **Aktion**. Unter **Zeilenaktionen**, füge einen Eintrag hinzu mit einem **Label** von `Eskalieren` und einem **Name** von `eskalieren`. 3. In den Einstellungen dieser Aktion **Bei Klick**setze **Typ** auf **Flow ausführen** und wähle **Fall eskalieren** in **Flow-API-Name** — die Liste zeigt das Label jedes Flows. 4. Unter **Flow-Eingabevariablen**, füge einen Eintrag hinzu: **Name** `recordId`, **Wert** **Datensatz: Fall-ID**, **Typ** **Text**. Die **Wert** Optionen sind nach den Feldbezeichnungen der Abfrage der Tabelle benannt. 5. Unter **Bei Abschluss**, füge eine **Toast anzeigen** („Fall eskaliert“) und eine **Alle Abfragen aktualisieren** Aktualisierung aller Abfragen hinzu, damit die Tabelle mit dem neuen Status neu geladen wird. Wenn du **Eskalieren** auf eine Zeile klickst, wird der Flow jetzt für diesen Fall ausgeführt, ohne dass ein Dialog im Weg ist. ## Problembehandlung **Die Namensliste unter Flow-Eingabevariablen ist leer.** Der Flow ist nicht aktiv. **Flow-API-Name** listet inaktive Flows neben aktiven auf, aber die Eingabevariablen werden aus der aktiven Version des Flows gelesen – ein inaktiver Flow hat keine, daher gibt es nichts anzuzeigen. Aktiviere den Flow in Flow Builder und öffne dann den Editor erneut. **Es passiert nichts, wenn ich die Interaktion im Builder oder in der Site-Vorschau ausprobiere.** Das ist erwartbar: „Flow ausführen“ wird dort übersprungen und ein Toast weist darauf hin. Veröffentliche die Site und teste es als Site-Benutzer. **Der Flow läuft für mich, aber nicht für Site-Benutzer.** Prüfe, ob das Gast- oder Portal-Benutzerprofil der Site Zugriff auf den Flow selbst und auf die Datensätze hat, die er liest und schreibt. ## Wichtige Hinweise * **Der Flow muss aktiv sein.** Ein inaktiver Flow schlägt fehl, wenn ein Site-Benutzer ihn auslöst, ohne dass dich der Builder darauf hinweist. * **Site-Benutzer benötigen Zugriff auf den Flow** und auf die Datensätze, auf die er zugreift. Ein Flow, der als Admin für dich funktioniert, kann für einen Gast- oder Portal-Benutzer dennoch fehlschlagen. * **Variablennamen müssen exakt übereinstimmen** zwischen dem Flow und der Interaktion, einschließlich der Groß-/Kleinschreibung. * **Keine Ausgabevariablen.** In Experience Sites liest die Interaktion keine Werte aus dem Flow zurück. Erfasse, was der Flow geändert hat, mit einem **Alle Abfragen aktualisieren** in **Bei Abschluss** stattdessen. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://docs.avonnicomponents.com/experience-cloud/experience-cloud-de/eigenschaftenbereich/interactions/execute-flow.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.