input et transmettent leurs résultats aux étapes suivantes via la fonction output.set().
Quand utiliser Exécuter un script plutôt que les actions intégrées
En général, utilisez les actions intégrées lorsqu’elles répondent à vos besoins. Utilisez Exécuter un script lorsque vous avez besoin d’une logique personnalisée, d’une transformation de données ou d’une interaction complexe avec une API.
Environnement
Configuration
- Ajoutez une action Exécuter un script à votre workflow.
- L’éditeur de script s’ouvre sur une zone vide. Écrivez-y votre code JavaScript.
- Votre script peut lire les données des étapes précédentes à l’aide de l’objet
input(voir ci-dessous). - Utilisez
output.set(key, value)pour transmettre des résultats aux étapes suivantes. - (Facultatif) Ajoutez des dépendances npm dans le panneau de configuration si votre script nécessite des bibliothèques externes.
- Cliquez sur Tester pour exécuter le script avec des données réelles provenant de la dernière exécution du déclencheur.
- Consultez le résultat du test et les journaux de la console afin de vérifier que votre script fonctionne correctement.
- Enregistrez l’action.
Lire les données d’entrée
L’objetinput contient les données de toutes les étapes précédentes du workflow. Chaque étape est identifiée par son ID d’action.
Structure des données d’entrée
Obtenir les données du déclencheur (champs d’un enregistrement)
Obtenir les données d’une étape Obtenir des enregistrements
Obtenir les données des résultats d’autres actions
Écrire des données de sortie
Utilisezoutput.set(key, value) pour rendre des données accessibles aux étapes suivantes. Vous pouvez définir plusieurs clés.
output.set("status", "success"), l’étape suivante peut référencer status dans le résultat de ce script.
Débogage avec console.log
Pendant le développement, utilisezconsole.log() pour inspecter les données et suivre le déroulement de l’exécution. La sortie du journal apparaît dans le panneau de test lorsque vous cliquez sur Tester.
Gestion des paquets npm
Vous pouvez utiliser des paquets npm dans vos scripts. Déclarez les dépendances dans le panneau de configuration :require() :
Variables intégrées
Sécurité : portée d’AUTOMATION_TOKEN
Le jetonAUTOMATION_TOKEN est généré automatiquement pour chaque exécution d’automatisation. Il dispose des mêmes autorisations que le créateur de l’automatisation et sa portée est limitée à l’exécution actuelle. Points essentiels :
- Il peut accéder à toutes les tables auxquelles le créateur de l’automatisation a accès.
- Il n’est valide que pendant l’exécution du script (délai d’attente de 60 secondes).
- N’exposez pas ce jeton à des systèmes externes : il est destiné aux appels de l’API Teable depuis votre script.
Appeler l’API Teable
Appeler l’IA depuis un script
POST /api/automation/runtime/ai envoie un prompt au modèle d’IA de votre base. La base est déterminée par le contexte de l’automatisation ; aucun ID de base n’est donc nécessaire. Le corps accepte prompt, ainsi que les paramètres facultatifs attachments, modelKey, temperature et outputType ; la réponse est { "message": ... }.
Les pièces jointes sont des éléments { url, mimetype, name }, dans la limite de 10 par appel, chacun inférieur à 20 Mo et téléchargeable en moins de 30 secondes. Elles peuvent être des images, des PDF ou des documents Office. Le modèle de chat par défaut peut ne pas lire les images et pièces jointes similaires ; transmettez donc modelKey lorsque vous envoyez des fichiers. Chaque appel consomme des crédits.
Gestion des erreurs
Encadrez toujours les opérations risquées de blocs try/catch afin que votre workflow puisse gérer correctement les échecs :Exemple complet : traiter et acheminer des tickets d’assistance
Conseils
- Commencez par console.log. Lorsque vous créez un script, journalisez d’abord l’objet
inputentier afin d’en comprendre la structure. - Gardez des scripts ciblés. Réalisez correctement une seule tâche plutôt que de regrouper de nombreuses opérations dans un même script. Enchaînez plusieurs actions Exécuter un script si nécessaire.
- Tenez compte du délai d’attente de 60 secondes. Les opérations longues, comme le traitement de grandes quantités de données ou de nombreux appels d’API séquentiels, peuvent atteindre cette limite. Divisez les tâches volumineuses en blocs plus petits.
- Testez avec des données réelles. Le panneau de test utilise les données réelles de la dernière exécution du déclencheur afin de produire des résultats réalistes.
- Gérez les données manquantes. Utilisez des valeurs par défaut (opérateur
||) pour les champs susceptibles d’être vides ou non définis.
Pages connexes
- Générer avec l’IA — pour les tâches d’IA fondées sur des prompts qui ne nécessitent pas de code personnalisé
- Requête HTTP — pour les appels d’API simples qui ne nécessitent pas de script

