Zuordnungstabelle

Zweck

Das Zuordnungstabelle-Element ermöglicht es Ihnen, aus wiederverwendbaren, beständigen Datentabellen zu lesen und in diese zu schreiben. Diese Tabellen fungieren als zentraler, gespeicherter Key-Value-Speicher, auf den über verschiedene Flows oder mehrere Ausführungen desselben Flows hinweg zugegriffen und der verwaltet werden kann.

Dies löst das Problem der Speicherung von Konfigurationsdaten, Mappings oder Übersetzungen, die nicht in der Flow-Logik selbst definiert werden müssen.

Anwendungsfälle:

• Speichern von Umgebungseinstellungen: Erstellen Sie eine Tabelle mit Schlüsseln wie api_url oder admin_email und lesen Sie diese Konfigurationswerte in jedem Flow aus.

• Übersetzen von Statusmeldungen: Mappen Sie interne Statuscodes (z. B. _PENDING_) auf benutzerfreundlichen Text (z. B. „Ihre Bestellung wird geprüft“).

• Zählen von Elementen: Verwenden Sie eine Tabelle, um bei jeder Ausführung eines Flows einen Zähler persistent zu erhöhen.

---

Praktische Anwendungshinweise

• Persistenter Speicher: Änderungen, die mit der Schreiben-Aktion vorgenommen werden, werden dauerhaft in der Tabelle gespeichert und stehen sofort jedem anderen Flow (oder Flow-Lauf) zur Verfügung, der daraus liest.

• Aktualisieren oder Einfügen (Upsert): Die Schreiben-Aktion ist technisch ein „Upsert“. Sie aktualisiert bestehende Schlüssel und fügt neue hinzu. Um einen Eintrag zu entfernen, müssen Sie dies im Hauptverwaltungsbereich der Zuordnungstabellen tun, nicht innerhalb eines Flows.

• Dynamische Schlüssel: Sie können Variablen aus vorherigen Schritten im Feld Schlüssel (für Lesen) verwenden, um Werte dynamisch nachzuschlagen (z. B. eine Übersetzung basierend auf einem Benutzer-Sprachcode).

---

Konfigurationsoptionen

Die primäre Konfiguration ist der Typ der Aktion, die Sie durchführen möchten. Die verfügbaren Felder ändern sich je nach Auswahl.

Allgemeine Optionen

Option	Beschreibung	Eingabeformat	Beispielwert
Typ	Die Operation, die auf die ausgewählte Tabelle angewendet werden soll (z. B. Lesen, Schreiben, Alles lesen).	Auswahl aus der Dropdown-Liste.	Lesen
Zuordnungstabelle	Die spezifische, vorkonfigurierte Datentabelle, mit der Sie interagieren möchten. Diese Tabellen werden außerhalb des Flow-Editors verwaltet.	Auswahl aus einer Liste verfügbarer Tabellen.	Meine Anwendungseinstellungen

Optionen für den Typ „Lesen“

Option	Beschreibung	Eingabeformat	Beispielwert
Schlüssel	Der spezifische Schlüssel, dessen Wert Sie aus der Tabelle abrufen möchten.	String.	api_url
Standardwert	Ein optionaler Standardwert, der zurückgegeben wird, falls der angegebene Schlüssel in der Tabelle nicht gefunden wird. Nützlich, um Fehler zu vermeiden.	String, Number oder JSON.	https://api.example.com/v1

Optionen für den Typ „Schreiben“

Option	Beschreibung	Eingabeformat	Beispielwert
Key-Values	Eine Liste von Schlüssel-Wert-Paaren, die zur Tabelle hinzugefügt oder darin aktualisiert werden sollen. Wenn ein Schlüssel existiert, wird der Wert aktualisiert (Upsert).	Eine Liste von Schlüssel-Wert-Paaren.	key: api_version, value: 2.1

---

Eingabe-/Ausgabe-Erwartungen

• Eingabe: Das Element wird vollständig über die Benutzeroberfläche konfiguriert; es verwendet keine Variablen aus vorherigen Schritten als Haupteingabe.

• Ausgabe: Das Element erzeugt eine einzige Ausgabevariable namens Ergebnis. Der Inhalt hängt vom ausgewählten Typ ab:

Typ der Aktion	Inhalt der Ausgabe Ergebnis	Datentyp
Lesen	Der Wert des angeforderten Schlüssels oder der Standardwert, falls der Schlüssel nicht gefunden wurde.	Entspricht dem gespeicherten Wert (z. B. String, Zahl, JSON).
Alles lesen	Ein JSON-Array, das alle Schlüssel-Wert-Objekte aus der Tabelle enthält (z. B. [{"key":"k1", "value":"v1"}, ...]).	JSON-Array.
Schreiben	Ein JSON-Array, das alle Schlüssel-Wert-Objekte aus der Tabelle enthält, nachdem der Schreibvorgang abgeschlossen ist.	JSON-Array.

---