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
- Fügen Sie Ihrem Workflow die Aktion Skript ausführen hinzu.
- Der Skripteditor wird mit einer leeren Arbeitsfläche geöffnet. Schreiben Sie hier Ihren JavaScript-Code.
- Ihr Skript kann mit dem Objekt
inputDaten aus vorherigen Schritten lesen (siehe unten). - Verwenden Sie
output.set(key, value), um Ergebnisse an nachfolgende Schritte zu übergeben. - (Optional) Fügen Sie im Konfigurationsbereich npm-Abhängigkeiten hinzu, wenn Ihr Skript externe Bibliotheken benötigt.
- Klicken Sie auf Testen, um das Skript mit echten Daten aus der letzten Ausführung des Auslösers zu starten.
- Prüfen Sie Testausgabe und Konsolenprotokolle, um die korrekte Funktion Ihres Skripts zu bestätigen.
- Speichern Sie die Aktion.
Eingabedaten lesen
Das Objektinput 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
Ausgabe schreiben
Verwenden Sieoutput.set(key, value), um Daten für nachfolgende Schritte verfügbar zu machen. Sie können mehrere Schlüssel festlegen.
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 Entwicklungconsole.log(), um Daten zu prüfen und den Ausführungsablauf nachzuverfolgen. Wenn Sie auf Testen klicken, erscheint die Protokollausgabe im Testbereich.
Verwaltung von npm-Paketen
Sie können npm-Pakete in Ihren Skripten verwenden. Deklarieren Sie Abhängigkeiten im Konfigurationsbereich:require() in Ihrem Skript:
Integrierte Variablen
Sicherheit: Gültigkeitsbereich von AUTOMATION_TOKEN
DasAUTOMATION_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: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

