Die Integration Datentabelle liest und schreibt Ihre Datentabellen aus einem Workflow heraus. Sie ist fest eingebaut und braucht keine Verbindung.
In der Knotenauswahl liegen unter Integrationen → Datentabellen vier dieser Knoten: Zeilen abrufen, Zeile einfügen, Zeilen aktualisieren und Zeilen löschen. Find First Row, Upsert Row und Count Rows gehören zum Eintrag Data Table in der Liste der Integrationen.
Wie Sie Tabellen anlegen und Spalten festlegen, steht auf der Seite Datentabellen.
Filter und Zeilen-IDs
Jede Zeile hat in der Spalte _id eine automatisch vergebene, numerische ID. Die meisten Aktionen nehmen entweder eine Row ID für genau eine Zeile oder einen Filter mit Bedingungen auf Ihre Spalten. Aktualisieren und Löschen brauchen eines von beiden.
Aktionen
Die Eingaben und Ausgaben heißen im Knoten so wie unten angegeben, auch in der deutschen Oberfläche.
Data Table: Get Rows
Gibt Zeilen zurück, wahlweise eingeschränkt durch eine Zeilen-ID oder einen Filter.
| Eingabe | Erforderlich | Beschreibung |
|---|---|---|
| Data Table | Ja | Die Tabelle, aus der gelesen wird |
| Row ID | Nein | Nur diese Zeile zurückgeben |
| Filter | Nein | Bedingungen, die die Zeilen erfüllen müssen |
| Limit | Nein | Höchstzahl der zurückgegebenen Zeilen |
| Offset | Nein | Anzahl übersprungener Zeilen, zum Blättern |
| Ausgabe | Typ | Beschreibung |
|---|---|---|
rows | array | Die gefundenen Zeilen |
count | number | Anzahl der gefundenen Zeilen |
Data Table: Find First Row
Gibt die erste Zeile zurück, die zu einem Filter passt.
| Eingabe | Erforderlich | Beschreibung |
|---|---|---|
| Data Table | Ja | Die Tabelle, die durchsucht wird |
| Filter | Nein | Bedingungen |
| Ausgabe | Typ | Beschreibung |
|---|---|---|
row | object | Die erste passende Zeile oder null |
found | boolean | Ob eine Zeile gefunden wurde |
rowId | number | ID der gefundenen Zeile |
Data Table: Insert Row
Fügt eine Zeile hinzu, oder mehrere auf einmal, wenn Sie ein Array übergeben.
| Eingabe | Erforderlich | Beschreibung |
|---|---|---|
| Data Table | Ja | Die Zieltabelle |
| Row Data | Ja | Ein Objekt aus Spaltenschlüsseln und Werten oder ein Array solcher Objekte |
| Ausgabe | Typ | Beschreibung |
|---|---|---|
rows | array | Alle eingefügten Zeilen |
insertedIds | array | IDs aller eingefügten Zeilen |
row | object | Die erste eingefügte Zeile |
insertedId | number | ID der ersten eingefügten Zeile |
Data Table: Upsert Row
Aktualisiert die Zeilen, die zu den Match Filters passen. Passt keine, wird eine neue Zeile eingefügt. Das ist nützlich, wenn ein Workflow denselben Eintrag mehrfach verarbeiten kann.
| Eingabe | Erforderlich | Beschreibung |
|---|---|---|
| Data Table | Ja | Die Zieltabelle |
| Match Filters | Ja | Bedingungen, an denen eine vorhandene Zeile erkannt wird |
| Row Data | Ja | Zu schreibende Werte, für Aktualisieren und Einfügen |
| Ausgabe | Typ | Beschreibung |
|---|---|---|
row | object | Die resultierende Zeile |
wasInserted | boolean | true, wenn eine neue Zeile angelegt wurde |
insertedId | number | ID der neuen Zeile, falls eingefügt |
updatedCount | number | Anzahl der aktualisierten Zeilen |
Data Table: Update Rows
Ändert die Zeile mit der angegebenen ID oder alle Zeilen, die zum Filter passen.
| Eingabe | Erforderlich | Beschreibung |
|---|---|---|
| Data Table | Ja | Die Zieltabelle |
| Row ID | Eins von beiden | Die zu ändernde Zeile |
| Filter | Eins von beiden | Bedingungen für die zu ändernden Zeilen |
| Updates | Ja | Die zu setzenden Spaltenwerte |
| Ausgabe | Typ | Beschreibung |
|---|---|---|
updatedCount | number | Anzahl der geänderten Zeilen |
updatedRows | array | Die Zeilen nach der Änderung |
Data Table: Delete Rows
Entfernt die Zeile mit der angegebenen ID oder alle Zeilen, die zum Filter passen.
| Eingabe | Erforderlich | Beschreibung |
|---|---|---|
| Data Table | Ja | Die Zieltabelle |
| Row ID | Eins von beiden | Die zu löschende Zeile |
| Filter | Eins von beiden | Bedingungen für die zu löschenden Zeilen |
| Ausgabe | Typ | Beschreibung |
|---|---|---|
deletedCount | number | Anzahl der entfernten Zeilen |
Gelöschte Zeilen lassen sich nicht wiederherstellen. Schalten Sie bei Update Rows und Delete Rows am besten Genehmigung erforderlich im Knoten ein, damit eine Person die Änderung vorher bestätigt. Mehr dazu unter Genehmigungen.
Data Table: Count Rows
Zählt die Zeilen, die zu einem Filter passen, ohne sie zurückzugeben.
| Eingabe | Erforderlich | Beschreibung |
|---|---|---|
| Data Table | Ja | Die Tabelle, die gezählt wird |
| Filter | Nein | Bedingungen |
| Ausgabe | Typ | Beschreibung |
|---|---|---|
count | number | Anzahl der passenden Zeilen |