View a markdown version of this page

Intégration Airtable - Amazon Quick
Avant de commencerConfiguration d'AirtableConfiguration du connecteur dans Amazon QuickActions disponiblesGestion et résolution des problèmes

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Intégration Airtable

Avec le connecteur d'action Airtable, vous pouvez accéder à la plateforme Airtable directement dans Amazon Quick via le langage naturel. Vous pouvez créer et mettre à jour des enregistrements, gérer des bases et des tables, filtrer les vues et effectuer des opérations sur les données relationnelles sans quitter Amazon Quick.

Amazon Quick prend en charge plusieurs méthodes d'authentification pour Airtable. Choisissez la méthode qui répond le mieux aux exigences de sécurité de votre entreprise.

  • Application OAuth par défaut — Utilise une application OAuth AWS gérée par OAuth. Aucune information d'identification supplémentaire n'est requise. Les utilisateurs s'authentifient directement avec leur compte Airtable.

  • Application OAuth personnalisée — Utilise une application OAuth gérée par le client enregistrée dans Airtable. Cette option donne à votre organisation le contrôle total de la configuration OAuth.

  • Clé API — Utilise un jeton d'accès personnel Airtable pour l'authentification. Convient pour une utilisation individuelle ou pour des tests.

Pour plus d'informations sur les méthodes d'authentification prises en charge par Amazon Quick, consultezMéthodes d’authentification.

Avant de commencer

Assurez-vous de disposer des éléments suivants avant de configurer l'intégration.

  • Un compte Airtable actif avec accès aux bases et aux données que vous souhaitez utiliser.

  • Pour l'application OAuth personnalisée : accédez au Airtable Builder Hub sur le site Web d'Airtable pour enregistrer une intégration OAuth.

  • Pour la clé API : un jeton d'accès personnel provenant du hub Airtable Builder sur le site Web d'Airtable.

  • Pour connaître les exigences relatives à l'abonnement Amazon Quick, consultezConfiguration des intégrations dans la console.

Configuration d'Airtable

Si vous utilisez l'authentification par défaut de l'application OAuth, ignorez cette section et passez à. Configuration du connecteur dans Amazon Quick

Pour l'authentification par application OAuth personnalisée ou par clé d'API, suivez les étapes applicables dans Airtable avant de configurer Amazon Quick.

Enregistrer une intégration OAuth (application OAuth personnalisée)

Créez une intégration OAuth dans le Airtable Builder Hub pour obtenir les informations d'identification client dont vous avez besoin pour Amazon Quick.

  1. Connectez-vous au Airtable Builder Hub sur le site Web d'Airtable et choisissez les intégrations OAuth.

  2. Choisissez Enregistrer une nouvelle intégration OAuth.

  3. Entrez un nom pour votre intégration.

  4. Pour les URL de redirection OAuth, entrez l'URL de redirection depuis Amazon Quick : https://{region}.quicksight.aws.amazon.com/sn/oauthcallback

  5. Choisissez Enregistrer l'intégration.

  6. Après l'enregistrement, générez un secret client en choisissant Régénérer le secret client.

  7. Enregistrez les valeurs suivantes. Vous en avez besoin lorsque vous configurez Amazon Quick.

    • Identifiant du client

    • Secret client

  8. Sous Étendue, sélectionnez les autorisations requises pour votre intégration. Pour la liste complète des étendues recommandées, voirÉscopes recommandés.

Création d'un jeton d'accès personnel (clé API)

Créez un jeton d'accès personnel dans le hub Airtable Builder pour l'authentification par clé d'API.

  1. Connectez-vous au Airtable Builder Hub sur le site Web d'Airtable et choisissez les jetons d'accès personnels.

  2. Choisissez Créer un jeton.

  3. Configurez le nom du jeton, les étendues et l'accès de base selon les besoins de votre cas d'utilisation.

  4. Copiez et stockez en toute sécurité le jeton généré. Vous en avez besoin lorsque vous configurez Amazon Quick.

Éscopes recommandés

Lorsque vous enregistrez une intégration OAuth ou que vous créez un jeton d'accès personnel, configurez les étendues suivantes en fonction des actions que vous souhaitez utiliser.

Lunettes recommandées par Airtable
Scope Description
data.records:read Lisez les données contenues dans les enregistrements.
data.records:write Créez, modifiez et supprimez des enregistrements.
data.recordComments:read Lisez les commentaires dans les dossiers.
data.recordComments:write Créez, modifiez et supprimez des commentaires d'enregistrement.
schema.bases:read Lisez la structure des bases, y compris les noms des tables et les types de champs.
schema.bases:write Modifiez la structure des bases, y compris les noms des tables et les types de champs.
user.email:read Lisez l'adresse e-mail de l'utilisateur authentifié.

Configuration du connecteur dans Amazon Quick

Se connecter depuis l'onglet Disponible

Si vous souhaitez utiliser l'authentification par défaut de l'application OAuth, vous pouvez vous connecter directement depuis l'onglet Disponible sans configuration supplémentaire.

  1. Dans la console Amazon Quick, choisissez Connectors.

  2. Dans l'onglet Disponible, recherchez Airtable et choisissez Connect.

  3. Complétez le flux de connexion à Airtable et accordez les autorisations demandées.

Pour configurer un connecteur avec une application OAuth personnalisée ou une clé d'API à la place, utilisez l'onglet Créer pour votre équipe, comme décrit ci-dessous.

Créez à partir de l'onglet Créer pour votre équipe

Une fois que vous avez terminé toute configuration Airtable requise, créez le connecteur dans Amazon Quick.

  1. Dans la console Amazon Quick, choisissez Connectors.

  2. Choisissez l'onglet Créer pour votre équipe.

  3. Trouvez et choisissez Airtable.

    Note

    Si un connecteur Airtable existe déjà, une boîte de dialogue s'affiche avec vos connecteurs existants. Pour utiliser un connecteur existant, choisissez-le. Pour en créer un nouveau, choisissez Non, créer un nouveau.

  4. Entrez un nom pour votre connecteur. Choisissez éventuellement + Ajouter une description pour ajouter une description.

  5. Pour Type de connexion, sélectionnez Réseau public.

  6. Pour la configuration OAuth, choisissez l'une des méthodes d'authentification suivantes et configurez les champs obligatoires.

    1. Pour l'application OAuth par défaut :

      Aucune information d'identification supplémentaire n'est requise. Choisissez Next (Suivant) pour continuer.

    2. Pour l'application OAuth personnalisée, configurez les champs suivants :

      • URL de base (facultatif) — URL de base de l'API Airtable. Exemple : https://api.airtable.com

      • ID client — L'ID client de votre intégration Airtable OAuth.

      • Secret client — Le secret client de votre intégration Airtable OAuth.

      • URL du jeton : point de terminaison du jeton. Exemple : https://airtable.com/oauth2/v1/token

      • URL d'autorisation : point de terminaison d'autorisation. Exemple : https://airtable.com/oauth2/v1/authorize

      • URL de redirection : Pre-filled avec l'URL de rappel Amazon Quick.

    3. Pour la clé d'API, configurez les champs suivants :

      • URL de base (facultatif) — URL de base de l'API Airtable. Exemple : https://api.airtable.com

      • Clé API — Votre jeton d'accès personnel Airtable.

      • E-mail (facultatif) — L'adresse e-mail associée à votre compte Airtable.

  7. Choisissez Suivant.

  8. Si vous avez choisi l'application OAuth par défaut ou l'application OAuth personnalisée, une fenêtre d'autorisation Airtable s'ouvre. Passez en revue les autorisations demandées, choisissez les bases et les espaces de travail auxquels vous souhaitez accorder l'accès, puis choisissez Accorder l'accès.

  9. Sur la page Révision, passez en revue les actions disponibles pour le connecteur. Choisissez Suivant.

  10. Sur la page Publier, choisissez qui peut accéder au connecteur. Vous pouvez autoriser l'accès à tous les membres de votre organisation ou rechercher des équipes ou des groupes spécifiques.

  11. Choisissez Publier.

Actions disponibles

Après avoir configuré le connecteur, les actions suivantes sont disponibles.

Actions disponibles dans Airtable
Catégorie Action Description
Enregistrements Lister les enregistrements Répertorie les enregistrements dans un tableau avec filtrage et tri optionnels.
Enregistrements Obtenir un enregistrement Récupère un enregistrement spécifique par identifiant.
Enregistrements Création d'un enregistrement par lots Crée un ou plusieurs nouveaux enregistrements dans une table.
Enregistrements Mettre à jour l'enregistrement Met à jour les champs d'un enregistrement existant.
Enregistrements Enregistrement de mise à jour par lots Met à jour plusieurs enregistrements en une seule opération à l'aide de PATCH.
Enregistrements Enregistrement Batch Put Imprime plusieurs enregistrements en une seule opération à l'aide de PUT.
Commentaires Commentaires sur la liste Répertorie les commentaires d'un enregistrement.
Commentaires Créer un commentaire Ajoute un commentaire à un enregistrement.
Commentaires Mettre à jour le commentaire Modifie un commentaire existant sur un enregistrement.
Schema Bases de listes Répertorie toutes les bases accessibles à l'utilisateur authentifié.
Schema Obtenir le schéma de base Récupère le schéma d'une base, y compris les tables et les définitions de champs.
Schema Créer une table Crée une nouvelle table dans une base.
Schema Mettre à jour une table Met à jour les propriétés de la table, telles que le nom ou la description.
Schema Créer un champ Ajoute un nouveau champ à une table.
Schema Mettre à jour le champ Met à jour les propriétés des champs telles que le nom ou le type.
Pièces jointes Créer une pièce jointe Télécharge une pièce jointe dans un enregistrement.
Utilisateurs Obtenir des informations sur l'utilisateur Récupère les informations relatives à l'utilisateur authentifié.
Note

Les actions que vous pouvez utiliser dépendent des bases et des espaces de travail accessibles à l'utilisateur authentifié.

Gestion et résolution des problèmes

Pour modifier, partager ou supprimer votre connecteur, consultezGestion des intégrations existantes.

Problèmes d’authentification

  • Sign-in échoue (application OAuth par défaut ou application OAuth personnalisée) — Vérifiez que votre compte Airtable est actif et que vous pouvez vous connecter directement à airtable.com sur le site Web d'Airtable. Pour l'application OAuth personnalisée, vérifiez que l'URL de redirection dans votre intégration Airtable OAuth correspond à l'URL de rappel Amazon Quick.

  • Informations d'identification client non valides (application OAuth personnalisée) — Vérifiez que l'ID client et le secret du client correspondent aux valeurs de votre intégration Airtable OAuth. Si vous avez régénéré le secret client, mettez à jour la valeur dans Amazon Quick.

  • Clé d'API rejetée : vérifiez que votre jeton d'accès personnel est actif et qu'il possède les étendues requises. Les jetons peuvent être révoqués ou expirés dans le Airtable Builder Hub.

  • Autorisations insuffisantes : vérifiez que les étendues configurées pour votre méthode d'authentification incluent les autorisations requises pour les actions que vous souhaitez utiliser. Consultez Éscopes recommandés.