Collections Airtable

Vous pouvez utiliser Airtable en tant que collection afin de générer des pages dynamiques. Pour plus d'informations sur les collections, consultez l'article Define a Collection for Dynamic Pages (Définir une collection pour les pages dynamiques).

Remarque

Airtable remplace progressivement les clés API par des jetons d'accès personnels.

À compter du 1er août 2023, un jeton d'accès personnel doit être utilisé pour les nouvelles collections.

Attention

À partir du 1er février 2024, les clés API seront complètement obsolètes. À cette date, des problèmes pourraient se produire avec les collections dont la clé API n'aura pas été remplacée par un jeton d'accès personnel.

Les collections Airtable comportent les limitations suivantes :

  Airtable
Nombre de collections par site 100
Champs (colonnes) 100
Limite de caractère du nom de la collection 50
Limite de caractère du nom du champ 50
URL de l'élément de la page 350 caractères
Mise à jour des données Automatiquement chaque heure

Pour créer une collection Airtable :

  1. Dans le panneau de gauche, cliquez sur Content (Contenu), puis sur Collections, puis sur + New Collection (+ Nouvelle collection).
  2. Cliquez sur Airtable.
  3. Saisissez vos informations d'identification pour l'API Airtable.
    •  Clé API
      1. Cliquez sur la page de compte Airtable (située à l'étape 1 de l'article Comment se connecter à Airtable).
      2. Un nouvel onglet s'ouvrira sur la page de votre compte Airtable (vous devrez peut-être vous connecter).
      3. Une fois connecté(e), rendez-vous sur airtable.com/create/tokens (si vous n'êtes pas connecté(e) à Airtable, une page 404 s'affichera).
      4. Sur la page des jetons d'accès personnels, cliquez sur Create token (Créer un jeton).

      5. Saisissez le nom du jeton.

      6. Dans la section Scopes (Portées), cliquez sur Add a scope (Ajouter une portée).

      7. Sélectionnez l'option data.records:read (voir les données dans les enregistrements).

      8. Dans la section Access (Accès), cliquez sur Add a base (Ajouter une base).

      9. Sélectionnez l'option All current and future bases in all current and future workspaces (Toutes les bases actuelles et futures dans tous les espaces de travail actuels et futurs) qui se trouve sous All Workspaces (Tous les espaces de travail).

      10. Cliquez sur Create token (Créer un jeton).

      11. Cliquez sur le bouton de copie situé à côté du jeton.

      12. Revenez sur IONOS et collez le jeton dans le champ Clé API.

    • Exemple d'URL

      1. Cliquez sur la page de l'API Airtable (située à l'étape 2 de l'article Comment se connecter à Airtable).
      2. Un nouvel onglet s'ouvrira dans Airtable (vous devrez peut-être vous connecter).
      3. Sur la page de référence de l'API, faites défiler vers le bas et sélectionnez le tableau souhaité.
      4. Dans le panneau latéral, cliquez sur Authentication (Authentification).
      5. Dans l'onglet Curl, copiez le lien sous EXAMPLE (EXEMPLE).
      6. Revenez sur IONOS et collez-le dans le champ Exemple d'URL.
  4. Cliquez sur Importer les champs.
  5. Définissez le type de données pour chaque champ.
  6. Cliquez sur Continuer.

Mettre à jour la clé API d'une collection avec un jeton d'accès personnel

Pour mettre à jour l'API d'une collection avec un jeton d'accès personnel :

  1. Dans le panneau de gauche, cliquez sur Content (Contenu), puis sur Collections, puis sur la collection Airtable de votre choix.

  2. Cliquez sur Collection Settings (Paramètres de la collection) vers le bas.

  3. Dans le champ API Key (Clé API), remplacez la clé API par un jeton d'accès personnel.

    • Pour récupérer un jeton d'accès personnel :

      1. Cliquez sur la page de compte Airtable (située à l'étape 1 de l'article Comment se connecter à Airtable).
      2. Un nouvel onglet s'ouvrira sur la page de votre compte Airtable (vous devrez peut-être vous connecter).
      3. Une fois connecté(e), rendez-vous sur airtable.com/create/tokens (si vous n'êtes pas connecté(e) à Airtable, une page 404 s'affichera).
      4. Sur la page des jetons d'accès personnels, cliquez sur Create token (Créer un jeton).

      5. Saisissez le nom du jeton.

      6. Dans la section Scopes (Portées), cliquez sur Add a scope (Ajouter une portée).

      7. Sélectionnez l'option data.records:read (voir les données dans les enregistrements).

      8. Dans la section Access (Accès), cliquez sur Add a base (Ajouter une base).

      9. Sélectionnez l'option All current and future bases in all current and future workspaces (Toutes les bases actuelles et futures dans tous les espaces de travail actuels et futurs) qui se trouve sous All Workspaces (Tous les espaces de travail).

      10. Cliquez sur Create token (Créer un jeton).

      11. Cliquez sur le bouton de copie situé à côté du jeton.

      12. Revenez sur IONOS et collez le jeton dans le champ Clé API.

  4. Cliquez sur Récupérer la collection à nouveau.

  5. Cliquez sur Terminé.

Champs pris en charge

Remarque

Airtable a apporté des modifications à ses URL en pièce jointe (comme les liens et les images), de sorte que ceux-ci expirent au bout de deux heures. IONOS n'est pas concerné par ce changement puisqu'il extrait les données d'Airtable toutes les heures.

Le tableau ci-dessous répertorie les types de champs Airtable pris en charge, les champs IONOS correspondants, ainsi que des exemples.

Champ IONOS Champ Airtable Exemple
Texte Texte brut

Bienvenue dans mon cabinet de dentiste.

Remarque

L'utilisation du champ de texte enrichi de lien intégré d'AirTable n'est pas prise en charge. Par exemple, pour ajouter un lien, utilisez la balise HTML <a> </a>.

Texte Texte long
Remarque

Ce site prend en charge HTML et les sauts de ligne.

Texte Texte brut bienvenue dans mon cabinet
Numérique Numéro

10,000

Remarque

Ne doit contenir que des chiffres et des points (pour les décimales).

Booléen Case à cocher
Remarque

Seulement pour les widgets personnalisés.

Image Pièce jointe avec une image Image ajoutée via Airtable.
Lien URL

https://goo.gl/maps/F81HPm4CBTQSTsJ5A

Vidéo URL ou texte https://www.youtube.com/watch?v=8EsYwAKxAFU
numéro de téléphone Numéro de téléphone ou texte 123456789
E-mail Adresse e-mail ou texte email@email.com
Emplacement Texte

ligneAdresse, codePostal, région, ville, pays

846 Kerry way, 90017, CA, Los Angeles, États-Unis

heures d'ouverture Texte SAM, DIM: 08:00-20:00; JEU, VEN: 08:00-12:00;

Collection interne contenant un champ d'image

Pièce jointe avec plusieurs images Images ajoutées via Airtable.
Texte Numéro  
Texte Devise
Remarque

Affiche uniquement le chiffre, sans le symbole $.

Texte Pourcentage
Remarque

Affiche les décimales mais pas le symbole %.

Texte Évaluation
Remarque

Affiche le numéro.

Texte Formule
Remarque

Le résultat de la formule peut être une chaîne.

Texte Numéro automatique  
compte de réseau social Valeur

Doit respecter le format nom : valeur ; nom : valeur ;

adresse e-mail : mon@gmail.com ; WhatsApp : 123456 ; Facebook : IONOS;

Remarque

Réseaux sociaux pris en charge : messagerie, whatsapp, facebook, twitter, instagram, youtube, linkedin, yelp, pinterest, google_my_business, waze, vimeo, snapchat, reddit, tripadvisor, foursquare, rss.

 

Date et heure Texte

La structure par défaut est AAAA-MM-JJ HH:mm:SS, par exemple : 2021-10-06 16:12:00. Consultez la liste complète des formats de date et heure et leur affichage dans Class DateTimeFormatter.

Remarque
  • Le site s’affiche toujours dans le fuseau horaire UTC, quel que soit ce qui est défini dans Airtable, même si l’option Utiliser le même fuseau horaire pour tous les collaborateurs est activée (dans Airtable).

    Pour éviter toute confusion entre le site et Airtable, il est recommandé d'activer l'option Utiliser le même fuseau horaire pour tous les collaborateurs (situés dans Airtable) et de sélectionner le fuseau horaire GTM/UTC.

  • Ce champ peut servir à faire le tri lors de l'utilisation de filtres ou de la fonction de tri dans la fenêtre contextuelle Données connectées.

Sélection multiple Sélection multiple

Après avoir créé un champ à sélection multiple, cliquez sur Options pour ajouter des options. Chaque ligne de la collection peut se voir attribuer une ou plusieurs des options créées.

Remarque

Ce champ peut être utilisé pour filtrer la collection affichée dans les widgets, comme les widgets Galerie photo, Liste, Accordéon et personnalisés connectés aux collections.

Remarque

En raison des restrictions de l'API, les champs sans contenu dans les 10 premières lignes ne sont pas importés par IONOS.

Ordre des lignes

Si vous utilisez des collections Airtable, l'ordre des lignes sera tiré au hasard en raison d'une limitation de l'API sur le site de Airtable. Les filtres et le tri ne sont pas pris en charge dans Airtable.

Pour récupérer les lignes dans le même ordre que celui d'Airtable, ainsi que les filtres et le tri associés, ajoutez le nom Airtable View à l'URL d'exemple que vous utilisez pour importer la collection. Pour plus d'informations, consultez l'assistance Airtable.

Pour appliquer les données d'affichage après avoir ajouté l'URL d'exemple, insérez '?view=View Name'. Le nom de l'affichage est sensible à la casse et doit correspondre strictement à celui d'Airtable.

Attention

La suppression ou la modification du nom de l'affichage après l'importation de la collection brisera la connexion.

Voici un exemple d'URL avant l'ajout du nom de l'affichage :

https://api.airtable.com/v0/appbiL1pCyvFcW8WG/Feedback%20Session?view=Main%20View

Voici un exemple d'URL après l'ajout du nom de l'affichage :

https://api.airtable.com/v0/appbiL1pCyvFcW8WG/Feedback%20Session?view=Main View

Pour plus d'informations sur l'ajout du nom de l'affichage à l'URL, consultez cette vidéo.

L'étape suivante consiste à créer ou à convertir une page dynamique afin de pouvoir la connecter à la collection que vous venez de créer. Vous pouvez également connecter les lignes de collection aux pages normales. Pour en savoir plus, consultez l'article Connecter les lignes de collection aux pages normales.