Skip to main content
Wir empfehlen dringend, Automatisierungen mit „Skript ausführen“ zu erstellen, da diese Funktion alle Aktionsarten abdecken kann – auch solche, die andernfalls manuell erstellt werden müssten. Beschreiben Sie Ihre Anforderungen einfach im KI-Chat.Bitte beachten Sie: Wenn Sie Aktionen manuell hinzufügen, kann die KI sie später weder erkennen noch ändern.
Mit der Aktion „Skript ausführen“ können Sie benutzerdefiniertes JavaScript schreiben, um Logik umzusetzen, die integrierte Aktionen nicht abdecken. Sie können Daten transformieren, externe APIs aufrufen, Berechnungen durchführen, bedingte Verzweigungen implementieren und vieles mehr – alles in einer sicheren Sandbox-Umgebung. Skripte empfangen Daten aus vorherigen Schritten über das Objekt input und übergeben Ergebnisse mit der Funktion output.set() an nachfolgende Schritte.

„Skript ausführen“ oder integrierte Aktionen verwenden

Verwenden Sie grundsätzlich integrierte Aktionen, wenn diese Ihre Anforderungen erfüllen. Verwenden Sie „Skript ausführen“, wenn Sie benutzerdefinierte Logik, Datentransformationen oder komplexe API-Interaktionen benötigen.

Umgebung

Einrichtung

  1. Fügen Sie Ihrem Workflow die Aktion Skript ausführen hinzu.
  2. Der Skripteditor wird mit einer leeren Arbeitsfläche geöffnet. Schreiben Sie hier Ihren JavaScript-Code.
  3. Ihr Skript kann mit dem Objekt input Daten aus vorherigen Schritten lesen (siehe unten).
  4. Verwenden Sie output.set(key, value), um Ergebnisse an nachfolgende Schritte zu übergeben.
  5. (Optional) Fügen Sie im Konfigurationsbereich npm-Abhängigkeiten hinzu, wenn Ihr Skript externe Bibliotheken benötigt.
  6. Klicken Sie auf Testen, um das Skript mit echten Daten aus der letzten Ausführung des Auslösers zu starten.
  7. Prüfen Sie Testausgabe und Konsolenprotokolle, um die korrekte Funktion Ihres Skripts zu bestätigen.
  8. Speichern Sie die Aktion.

Eingabedaten lesen

Das Objekt input enthält Daten aus allen vorherigen Schritten des Workflows. Jeder Schritt wird anhand seiner Aktions-ID identifiziert.

Eingabestruktur

Auslöserdaten abrufen (Datensatzfelder)

Daten aus einem Schritt „Datensätze abrufen“ erhalten

Daten aus den Ausgaben anderer Aktionen abrufen

Verwenden Sie beim Testen console.log(JSON.stringify(input, null, 2)), um die genaue Struktur Ihrer Eingabedaten zu sehen. So erkennen Sie am schnellsten, welche Daten verfügbar sind.

Ausgabe schreiben

Verwenden Sie output.set(key, value), um Daten für nachfolgende Schritte verfügbar zu machen. Sie können mehrere Schlüssel festlegen.
Jeder von Ihnen festgelegte Schlüssel wird zu einer separaten Variable, auf die nachfolgende Schritte über die Variablenauswahl + verweisen können. Wenn Sie beispielsweise output.set("status", "success") aufrufen, kann der nächste Schritt aus der Ausgabe dieses Skripts auf status verweisen.

Debugging mit console.log

Verwenden Sie während der Entwicklung console.log(), um Daten zu prüfen und den Ausführungsablauf nachzuverfolgen. Wenn Sie auf Testen klicken, erscheint die Protokollausgabe im Testbereich.
Konsolenprotokolle sind nur während Tests sichtbar – sie erscheinen nicht im Ausführungsverlauf der Produktionsumgebung. Nutzen Sie sie beim Erstellen Ihres Skripts ausgiebig.

Verwaltung von npm-Paketen

Sie können npm-Pakete in Ihren Skripten verwenden. Deklarieren Sie Abhängigkeiten im Konfigurationsbereich:
Verwenden Sie sie anschließend mit require() in Ihrem Skript:
Bevorzugen Sie nach Möglichkeit integrierte JavaScript-Funktionen gegenüber npm-Paketen. Modernes JavaScript bietet bereits viele Hilfsmittel – Array.map(), Array.filter(), Object.entries(), Template-Literale, Destrukturierung usw. Fügen Sie npm-Pakete nur hinzu, wenn sie einen deutlichen Mehrwert bieten.

Integrierte Variablen

Sicherheit: Gültigkeitsbereich von AUTOMATION_TOKEN

Das AUTOMATION_TOKEN wird für jede Automatisierungsausführung automatisch generiert. Es besitzt dieselben Berechtigungen wie der Ersteller der Automatisierung und ist auf die aktuelle Ausführung beschränkt. Wichtige Punkte:
  • Es kann auf jede Tabelle zugreifen, auf die der Ersteller der Automatisierung Zugriff hat.
  • Es ist nur für die Dauer der Skriptausführung gültig (Zeitüberschreitung nach 60 Sekunden).
  • Geben Sie dieses Token nicht an externe Systeme weiter – es ist für Aufrufe der Teable-API aus Ihrem Skript bestimmt.

Teable-API aufrufen

KI aus einem Skript aufrufen

POST /api/automation/runtime/ai sendet einen Prompt an das KI-Modell Ihrer Base. Die Base stammt aus dem Kontext der Automatisierung, daher ist keine Base-ID erforderlich. Der Text erwartet prompt sowie optional attachments, modelKey, temperature und outputType; die Antwort lautet { "message": ... }. Anhänge sind Elemente des Formats { url, mimetype, name }: bis zu 10 pro Aufruf, jeweils unter 20 MB und mit 30 Sekunden Zeit zum Herunterladen. Unterstützt werden Bilder, PDFs und Office-Dokumente. Das Standard-Chatmodell kann Bilder und ähnliche Anhänge möglicherweise nicht lesen; übergeben Sie daher modelKey, wenn Sie Dateien senden. Jeder Aufruf verbraucht Guthaben.

Fehlerbehandlung

Schließen Sie riskante Vorgänge immer in try/catch-Blöcke ein, damit Ihr Workflow Fehler kontrolliert behandeln kann:
Ohne Fehlerbehandlung bringt ein fehlgeschlagener Abruf oder ein unerwartetes Datenformat das Skript zum Absturz, und nachfolgende Schritte erhalten keine Ausgabe.

Vollständiges Beispiel: Support-Tickets verarbeiten und weiterleiten

Tipps

  • Beginnen Sie mit console.log. Protokollieren Sie beim Erstellen eines neuen Skripts zunächst das gesamte Objekt input, um dessen Struktur zu verstehen.
  • Beschränken Sie Skripte auf eine klare Aufgabe. Erledigen Sie eine Aufgabe gut, statt mehrere Aufgaben in ein Skript zu packen. Verketten Sie bei Bedarf mehrere Aktionen „Skript ausführen“.
  • Beachten Sie die Zeitüberschreitung von 60 Sekunden. Langwierige Vorgänge – umfangreiche Datenverarbeitung oder viele sequenzielle API-Aufrufe – können die Zeitüberschreitung erreichen. Teilen Sie große Aufgaben in kleinere Abschnitte auf.
  • Testen Sie mit echten Daten. Der Testbereich verwendet tatsächliche Daten aus der letzten Ausführung des Auslösers und liefert dadurch realistische Ergebnisse.
  • Behandeln Sie fehlende Daten. Verwenden Sie Standardwerte (Operator ||) für Felder, die leer oder nicht definiert sein können.

Verwandte Themen

  • Mit KI generieren – für promptbasierte KI-Aufgaben, die keinen benutzerdefinierten Code benötigen
  • HTTP-Anfrage – für einfache API-Aufrufe, die kein Skript benötigen
Zuletzt geändert am 4. September 2026