Se connecter à Airtable

Connectez simplement votre application à une base Airtable pour récupérer et envoyer des données.

Créer un compte gratuit sur Airtable

Airtable est un outil très connu mêlant tableur, base de données et gestion de projet. Airtable permet facilement de gérer de manière hybride un grand nombre de données, et pas seulement des chiffres : numéro de téléphone, dates, code-barres, photos… Son utilisation simple, intuitive et souvent gratuite en fait un outil incontournable de l’écosystème no code.

Pour créer un compte gratuit sur Airtable : https://airtable.com/signup

Préparer votre base Airtable

Créez une nouvelle base de données en cliquant sur Add a base.

Structurez vos données au sein d’une table en ajoutant des champs (Fields) pour chaque type de donnée.

Voici l’exemple d’une base de biens immobiliers :

Vous avez plusieurs types de champs (Field type): checkbox, texte, date, image etc…

Importez vos données manuellement ou via un fichier .csv, Microsoft Excel ou Google Sheets:

Créer un jeton personnel (token)

Pour créer un jeton personnel :

• Rendez-vous dans l’espace dédié de votre compte Airtable: https://airtable.com/create/tokens

• Cliquer sur le bouton Create token

• Définissez un Nom, un périmètre Scope et associez une base.

• Concernant les Droits, tout dépend de votre usage :

  • Si vous souhaitez simplement afficher des données, choisissez Read.
  • Si vous avez besoin d’afficher des données et de les modifier, choisisser Write. Dans ce cas, attention à bien protéger ce token contre de mauvaises intentions en appliquant le mode proxy (voir ci-dessous).

• Votre jeton personnel est prêt à être utilisé. Copiez-collez le dans un endroit sécurisé.

Configurer le composant HTTP

Connectez votre base Airtable à votre application PandaSuite grâce au composant HTTP.

Pour configurer votre composant HTTP :

• Sélectionnez votre Projet : en le plaçant à cet endroit, votre composant sera accessible tout au long de votre application
• Cliquez sur Composants > HTTP pour l’insérer.

• Pour saisir les propriétés correspondant à votre base et votre compte Airtable, retournez dans la section HELP > API Documentation d’Airtable pour retrouver les paramètres de l’API Airtable.

URL

Pour récupérer l’URL de l’API, sélectionnez votre Table sur la gauche et cliquez sur List Records.

Copiez-collez l’URL de l’API. Voici un exemple d’URL:

https://api.airtable.com/v0/appIGPMYLUbwWCCbZ/Table%201

Jeton personnel (token)

Il existe différentes méthodes pour ajouter votre jeton personnel (token) en fonction des droits d’accès.

Si votre token est en READ :

• Dans le champ En-tête, cliquez sur + Ajouter.
• Ajoutez Authorization comme clé et Bearer TOKEN comme valeur, dans lequel vous remplacez TOKEN par votre jeton personnel.

Si votre token est en WRITE, il ne faut pas que le token puisse être récupéré par les utilisateurs finaux :

• Dans le champ Autorisation, sélectionnez Clé API.
• Comme Valeur, ajoutez le TOKEN : le Mode proxy s’activera automatiquement. Le mode proxy permet de sécuriser le token en utilisant les serveurs de PandaSuite, en tant que “reverse proxy”.

Méthode

Pour requêter de la donnée, sélectionnez la méthode GET. Si vous souhaitez en envoyer, choisissez la méthode POST.

Gestion du cache

La mise en cache vous permet de réutiliser efficacement des données de l’API précédemment récupérées ou traitées, et gérer la disponibilité de ces données sans connexion Internet.

Choisissez parmi les options suivantes :

• Aucun cache : l’application fera un appel réseau et ne lira pas le cache
• Cache en premier : l’application recherche le résultat dans le cache avant de faire une requête au réseau.
• Réseau et cache : l’application retournera le contenu du cache mais fera tout de même la requête afin de le mettre à jour. Cette option permet d’avoir une réponse rapide.

L’option Cache persistant permet de conserver le cache même après la fermeture de l’application.

Cas d’utilisation

Afficher des données Airtable dans votre application

Tester la requête

Double-cliquez sur le composant HTTP.

Cliquez sur Test Request pour envoyer une requête.

Vérifiez que les données s’affichent correctement.

Si les données brutes apparaissent, l’API est bien configurée. PandaSuite Studio pourra alors afficher ces données dans l’explorateur Data Binding.

Affichage dynamique avec le data Binding

Ajoutez un composant Collection pour afficher les données en mode dynamique.

Liez la source de données à votre requête HTTP.

Personnalisez l’affichage des champs selon votre mise en page grâce au data binding.

Gérer la pagination

Airtable limite l’affichage à 100 enregistrements par page.

Ajoutez un paramètre offset à l’URL pour charger les pages suivantes.

Envoyer des données vers Airtable

• Changez la méthode en POST.

• Consultez les paramètres attendus par Airtable dans la section HELP > API Documentation

• Dans l’onglet Type de contenu, choisissez JSON.

• Dans Contenu, vous pouvez le reconstruire dans le composant ou utiliser la Vue JSON pour vous faciliter la tâche.

• N’oubliez pas d’ajouter une action Lancer la requête sur le composant HTTP.

Si tout est correct, un nouvel enregistrement apparaîtra dans votre base Airtable.

Voici un template qui montre comment envoyer des données vers Airtable :