input e passano i risultati ai passaggi successivi tramite la funzione output.set().
Quando usare Esegui script anziché le azioni integrate
In generale, usa le azioni integrate quando soddisfano le tue esigenze. Usa Esegui script quando ti servono logica personalizzata, trasformazione dei dati o interazioni API complesse.
Ambiente
Come configurarlo
- Aggiungi un’azione Esegui script al workflow.
- L’editor di script si apre con un’area vuota. Scrivi qui il codice JavaScript.
- Lo script può leggere i dati dei passaggi precedenti usando l’oggetto
input(vedi sotto). - Usa
output.set(key, value)per passare i risultati ai passaggi successivi. - (Facoltativo) Aggiungi le dipendenze npm nel pannello di configurazione se lo script richiede librerie esterne.
- Fai clic su Test per eseguire lo script con dati reali provenienti dall’esecuzione più recente del trigger.
- Controlla l’output del test e i log della console per verificare che lo script funzioni correttamente.
- Salva l’azione.
Leggere i dati di input
L’oggettoinput contiene i dati di tutti i passaggi precedenti del workflow. Ogni passaggio è identificato dal proprio ID azione.
Struttura dell’input
Ottenere i dati del trigger (Campi del Record)
Ottenere i dati da un passaggio Ottieni Record
Ottenere i dati dagli output di altre azioni
Scrivere l’output
Usaoutput.set(key, value) per rendere disponibili i dati ai passaggi successivi. Puoi impostare più chiavi.
output.set("status", "success"), il passaggio successivo può fare riferimento a status nell’output di questo script.
Debug con console.log
Durante lo sviluppo, usaconsole.log() per esaminare i dati e tenere traccia del flusso di esecuzione. L’output dei log viene visualizzato nel pannello di test quando fai clic su Test.
Gestione dei pacchetti npm
Puoi utilizzare pacchetti npm negli script. Dichiara le dipendenze nel pannello di configurazione:require():
Variabili integrate
Sicurezza: ambito di AUTOMATION_TOKEN
AUTOMATION_TOKEN viene generato automaticamente per ogni esecuzione dell’Automazione. Ha le stesse autorizzazioni dell’autore dell’Automazione e il suo ambito è limitato all’esecuzione corrente. Punti chiave:
- Può accedere a qualsiasi Tabella a cui ha accesso l’autore dell’Automazione.
- È valido soltanto per la durata dell’esecuzione dello script (timeout di 60 secondi).
- Non esporre questo token a sistemi esterni: è destinato a chiamare l’API di Teable dall’interno dello script.
Chiamare l’API di Teable
Chiamare l’IA da uno script
POST /api/automation/runtime/ai invia un prompt al modello IA della Base. La Base deriva dal contesto dell’Automazione, quindi non è necessario alcun ID Base. Il corpo accetta prompt e, facoltativamente, attachments, modelKey, temperature e outputType; la risposta è { "message": ... }.
Gli allegati sono elementi { url, mimetype, name }, fino a 10 per chiamata, ciascuno di dimensioni inferiori a 20 MB e con un timeout di download di 30 secondi; sono supportati immagini, PDF e documenti Office. Il modello di chat predefinito potrebbe non leggere immagini e allegati simili, quindi specifica modelKey quando invii file. Ogni chiamata consuma Crediti.
Gestione degli errori
Racchiudi sempre le operazioni rischiose in blocchi try/catch, in modo che il workflow possa gestire correttamente gli errori:Esempio completo: elaborare e instradare i ticket di assistenza
Suggerimenti
- Inizia da console.log. Quando crei un nuovo script, registra innanzitutto l’intero oggetto
inputper comprenderne la struttura. - Mantieni gli script mirati. Svolgi bene una singola attività anziché concentrare più attività in un unico script. Se necessario, concatena più azioni Esegui script.
- Tieni presente il timeout di 60 secondi. Le operazioni lunghe (elaborazione di grandi quantità di dati, molte chiamate API sequenziali) possono raggiungere il timeout. Suddividi le attività grandi in blocchi più piccoli.
- Esegui i test con dati reali. Il pannello di test usa i dati effettivi dell’esecuzione più recente del trigger, offrendo risultati realistici.
- Gestisci i dati mancanti. Usa valori predefiniti (operatore
||) per i Campi che potrebbero essere vuoti o non definiti.
Contenuti correlati
- Genera con l’IA — per attività IA basate su prompt che non richiedono codice personalizzato
- Richiesta HTTP — per semplici chiamate API che non richiedono scripting

