⬜ Airtable

Le bloc Airtable permet de connecter votre projet Celestory à une base de données Airtable pour lire, modifier, ajouter ou supprimer des données. Il est particulièrement utile pour gérer des informations structurées comme des scores de joueurs, des inventaires ou des listes de contacts directement depuis un tableur en ligne.

Ce bloc facilite l'intégration avec Airtable en offrant des opérations CRUD (Create, Read, Update, Delete) pour interagir dynamiquement avec vos données.

📥 Entrées

• in (Trigger) : Déclenche l'exécution du bloc. Doit être relié à un bloc précédent pour activer l'action.
• config (Object) : Configuration principale du bloc, incluant :
• • Base : Nom de l'espace de travail Airtable contenant votre base de données.
  • Table : Nom de la feuille de calcul (table) spécifique à utiliser.
  • Opération : Action à effectuer parmi :
  • • Lire (Read) : Récupère des données (nécessite un id ou une query).
    • Créer (Create) : Ajoute une nouvelle ligne avec les valeurs fournies.
    • Mettre à jour (Update) : Modifie une ligne existante (nécessite un id).
    • Supprimer (Delete) : Efface une ligne (nécessite un id).
• id (String) : Identifiant unique d'une ligne Airtable (requis pour les opérations Update et Delete).
• query (String) : Formule de filtrage pour l'opération Lire (ex: Name = 'Pierre'). Utilisé si aucun id n'est fourni.
• [Nom des colonnes] (Dynamique) : Champs dynamiques correspondant aux colonnes de votre table Airtable, apparaissant automatiquement pour les opérations Create et Update. Permettent de définir les valeurs à insérer ou modifier.

📤 Sorties

• out (Trigger) : S'active lorsque l'opération avec Airtable est terminée avec succès.
• onError (Trigger) : S'active en cas d'erreur (connexion échouée, ID introuvable, etc.).
• id (String) : Identifiant unique de la ligne créée (disponible après une opération Create).
• [Nom des champs] (Dynamique) : Sorties dynamiques correspondant aux colonnes de votre table Airtable, disponibles après une opération Lire. Permettent d'accéder aux données récupérées (texte, nombre, etc.).

💡 Exemple d'utilisation

Scénario : Mettre à jour le score d'un joueur dans un jeu

1. Un joueur termine une partie et obtient un nouveau score de 1500 points.
2. Vous souhaitez enregistrer ce score dans votre base Airtable, qui contient déjà une ligne pour ce joueur (identifiée par son id).
3. Ajoutez un bloc Airtable dans votre graphe et configurez-le comme suit :

• Base : MonJeu
• Table : ScoresJoueurs
• Opération : Mettre à jour (Update)
• id : rec123456789 (ID de la ligne du joueur dans Airtable)
• Score : 1500 (branchez ici la variable contenant le nouveau score)

4. Le bloc met à jour la ligne correspondante dans Airtable avec le nouveau score.
5. Si la mise à jour réussit, le flux continue via la sortie out pour afficher un message de confirmation au joueur. En cas d'erreur, la sortie onError est activée pour gérer le problème (ex: afficher un message d'erreur).

⚙️ Détails Techniques

• Gestion des variables dynamiques : Les entrées et sorties correspondant aux colonnes de votre table Airtable sont générées dynamiquement en fonction de la configuration du bloc. Ces champs apparaissent automatiquement après avoir sélectionné la Base et la Table.
• Clé API : La clé API Airtable doit être configurée au préalable dans le menu Intégrations de Celestory. Sans cette clé, le bloc ne pourra pas communiquer avec votre base de données.
• Format des données : Les types de données (texte, nombre, booléen, etc.) sont automatiquement mappés entre Celestory et Airtable. Assurez-vous que les valeurs fournies correspondent aux types attendus par votre table.
• Limites : Les opérations Lire sans id ni query renverront toutes les lignes de la table, ce qui peut impacter les performances si la table est volumineuse. Privilégiez les filtres pour cibler les données nécessaires.

Mis à jour le : 04/03/2026