Modules Airtable

Avec le connecteur Airtable pour Adobe Workfront Fusion, vous pouvez démarrer un scénario en fonction des événements de votre compte Airtable, créer, charger et mettre à jour des enregistrements, rechercher des enregistrements et effectuer des appels API personnalisés vers l’API Airtable.

Conditions d’accès

Vous devez disposer des accès suivants pour utiliser les fonctionnalités de cet article :

Adobe Workfront formule*
Pro ou version supérieure
Adobe Workfront licence*
Plan, Work
Adobe Workfront Fusion licence**
Workfront Fusion for Work Automation and Integration
Produit
Votre entreprise doit acheter Adobe Workfront Fusion ainsi qu’Adobe Workfront pour utiliser les fonctionnalités décrites dans cet article.

Pour connaître le plan, le type de licence ou l’accès dont vous disposez, contactez votre administrateur ou administratrice Workfront.

Pour plus d’informations sur les licences Adobe Workfront Fusion, voir Licences Adobe Workfront Fusion.

Conditions préalables

Vous devez disposer d’un compte Airtable pour utiliser les fonctionnalités de cet article.

Informations sur l’API Airtable

Le connecteur Airtable utilise les éléments suivants :

URL de base
https://api.airtable.com/v0
Balise API
v3.3.28

Connecter Airtable à Workfront Fusion connect-airtable-to-workfront-fusion

  1. Ouvrez Workfront Fusion et la boîte de dialogue Créer une connexion du module souhaité.
  2. Saisissez un nom pour la connexion.
  3. (Facultatif) Cliquez sur Afficher les paramètres avancés, puis saisissez votre ID client Airtable et votre secret client.
  4. Cliquez sur le bouton Continuer pour créer la connexion et revenir au module.

Modules Airtable et leurs champs

Enregistrements

Créer un enregistrement create-a-record

Ce module d’action crée un nouvel enregistrement.

Vous indiquez les données que vous souhaitez dans l’enregistrement et leur emplacement de stockage.

Le module renvoie tous les champs standard associés à l’enregistrement, ainsi que tous les champs et valeurs personnalisés auxquels la connexion accède. Vous pouvez mettre en correspondance ces informations dans les modules suivants du scénario.

Lorsque vous configurez ce module, les champs suivants s’affichent.

Connexion
Pour des instructions sur la connexion de votre compte Airtable à Workfront Fusion, voir Connecter Airtable à Workfront Fusion dans cet article.
Base
Sélectionnez la base à laquelle doit appartenir le nouvel enregistrement.
Tableau
Sélectionnez le tableau auquel doit appartenir le nouvel enregistrement.
Enregistrement
Liens intelligents
Activez cette option pour saisir des noms plutôt que des ID d’enregistrement pour les champs liés à un autre tableau. L’enregistrement est automatiquement créé dans le tableau lié en cas d’absence de correspondance.

Supprimer un enregistrement delete-a-record

Ce module d’action supprime un enregistrement particulier.

Vous spécifiez l’ID et les emplacements de l’enregistrement.

Le module renvoie l’ID de l’enregistrement et tous les champs associés, ainsi que les champs personnalisés et les valeurs auxquels la connexion accède. Vous pouvez mettre en correspondance ces informations dans les modules suivants du scénario.

Lorsque vous configurez ce module, les champs suivants s’affichent.

Connexion
Pour des instructions sur la connexion de votre compte Airtable à Workfront Fusion, voir Connecter Airtable à Workfront Fusion dans cet article.
Base
Sélectionnez la base contenant l’enregistrement que vous souhaitez supprimer.
Tableau
Sélectionnez le tableau contenant l’enregistrement à supprimer.
ID de l’enregistrement
Saisissez ou mappez l’ID Airtable unique de l’enregistrement que vous souhaitez que le module supprime. Vous pouvez récupérer l’ID, par exemple, à l’aide du module Rechercher des enregistrements.

Obtenir un enregistrement get-a-record

Ce module d’action récupère les détails des enregistrements.

Connexion
Pour des instructions sur la connexion de votre compte Airtable à Workfront Fusion, voir Connecter Airtable à Workfront Fusion dans cet article.
Base
Sélectionnez la base contenant le tableau avec l’enregistrement que vous souhaitez récupérer.
Tableau
Sélectionnez le tableau contenant l’enregistrement pour lequel vous souhaitez récupérer les détails.
ID de l’enregistrement
Saisissez ou mappez l’ID de l’enregistrement pour lequel vous souhaitez récupérer des détails.

Rechercher des enregistrements search-records

Ce module recherche les enregistrements dans un objet d’Airtable correspondant à la requête que vous spécifiez.

Vous pouvez mettre en correspondance ces informations dans les modules suivants du scénario.

Lorsque vous configurez ce module, les champs suivants s’affichent.

Connexion
Pour des instructions sur la connexion de votre compte Airtable à Workfront Fusion, voir Connecter Airtable à Workfront Fusion dans cet article.
Base
Sélectionnez la base à rechercher pour les enregistrements.
Tableau
Sélectionnez le tableau à rechercher pour les enregistrements.
Formule

Formule de filtrage des enregistrements. La formule est évaluée pour chaque enregistrement et si le résultat n’est pas 0, false, "", NaN, [] ou #Error!, l’enregistrement est inclus dans la réponse.

Si elle est combinée avec view, seuls les enregistrements de cette vue qui correspondent à la formule sont renvoyés.

Par exemple, pour inclure uniquement les enregistrements dont le nom n’est pas vide, transmettez ce qui suit : NOT({Name} = '')

Pour en savoir plus, recherchez des informations sur les références de champs de formule dans la documentation d’assistance Airtable.

Trier
Sélectionnez la direction du tri et le champ selon lequel vous souhaitez trier les résultats.
Afficher
Sélectionnez la vue dans laquelle vous souhaitez rechercher des enregistrements.
Limite
Saisissez ou mappez le nombre maximum d’enregistrements que le module doit renvoyer pour chaque cycle d’exécution du scénario.

Mettre à jour un enregistrement update-a-record

Ce module d’action met à jour un enregistrement particulier.

Vous indiquez l’ID de l’enregistrement et les nouvelles données que vous souhaitez qu’il contienne.

Le module renvoie tous les champs standard associés à l’enregistrement, ainsi que tous les champs et valeurs personnalisés auxquels la connexion accède. Vous pouvez mettre en correspondance ces informations dans les modules suivants du scénario.

Lorsque vous configurez ce module, les champs suivants s’affichent.

Connexion
Pour des instructions sur la connexion de votre compte Airtable à Workfront Fusion, voir Connecter Airtable à Workfront Fusion dans cet article.
Base
Sélectionnez la base contenant l’enregistrement que vous souhaitez mettre à jour.
Tableau
Sélectionnez le tableau contenant l’enregistrement que vous souhaitez mettre à jour.
ID de l’enregistrement
Saisissez ou mappez lID Airtable unique de l’enregistrement que vous souhaitez que le module mette à jour. Vous pouvez récupérer l’ID, par exemple, à l’aide du module Rechercher des enregistrements.
Enregistrement
Liens intelligents
Saisissez des noms plutôt que des ID d’enregistrement pour les champs liés à un autre tableau. L’enregistrement est automatiquement créé dans le tableau lié en cas d’absence de correspondance.

Insérer un enregistrement

Ce module d’action met à jour ou insère un enregistrement particulier.

Vous indiquez l’ID de l’enregistrement et les nouvelles données que vous souhaitez qu’il contienne.

Le module renvoie tous les champs standard associés à l’enregistrement, ainsi que tous les champs et valeurs personnalisés auxquels la connexion accède. Vous pouvez mettre en correspondance ces informations dans les modules suivants du scénario.

Lorsque vous configurez ce module, les champs suivants s’affichent.

Connexion
Pour des instructions sur la connexion de votre compte Airtable à Workfront Fusion, voir Connecter Airtable à Workfront Fusion dans cet article.
Base
Sélectionnez la base contenant l’enregistrement que vous souhaitez mettre à jour.
Tableau
Sélectionnez le tableau contenant l’enregistrement que vous souhaitez mettre à jour.
ID de l’enregistrement
Si vous mettez à jour un enregistrement, saisissez ou mappez l’ID Airtable unique de l’enregistrement que vous souhaitez que le module mette à jour. Vous pouvez récupérer l’ID, par exemple, à l’aide du module Rechercher des enregistrements.
Enregistrement
Liens intelligents
Saisissez des noms plutôt que des ID d’enregistrement pour les champs liés à un autre tableau. L’enregistrement est automatiquement créé dans le tableau lié en cas d’absence de correspondance.

Surveillez des enregistrements watch-records

Ce module de déclenchement lance un scénario lorsqu’un enregistrement est créé ou mis à jour dans le tableau spécifié.

NOTE
Pour utiliser ce module, le champ Heure de création ou Heure de dernière modification doit être créé dans votre tableau.
Connexion
Pour des instructions sur la connexion de votre compte Airtable à Workfront Fusion, voir Connecter Airtable à Workfront Fusion dans cet article.
Base
Sélectionnez la base que vous souhaitez surveiller pour de nouveaux enregistrements.
Tableau
Sélectionnez le tableau sur lequel rechercher les nouveaux enregistrements.
Configuration du déclencheur

Champ Déclencheur

Champ Created Time ou Last Modified Time utilisé pour trier les enregistrements. Si vous n’avez pas de champ Created Time ou Last Modified Time dans votre schéma, vous devez en créer un.

Champ Libellé

Champ utilisé comme libellé pour un enregistrement, par exemple, dans la boîte de dialogue Choisir où commencer.

Limite
Saisissez ou mappez le nombre maximal d’enregistrements que le module doit surveiller pour chaque cycle d’exécution de scénario.
Afficher
Sélectionnez la vue à utiliser.
Formule

Formule de filtrage des enregistrements. La formule est évaluée pour chaque enregistrement et si le résultat n’est pas 0, false, "", NaN, [] ou #Error!, l’enregistrement est inclus dans la réponse.

Si elle est combinée avec view, seuls les enregistrements de cette vue qui correspondent à la formule sont renvoyés.

Par exemple, pour inclure uniquement les enregistrements dont le nom n’est pas vide, transmettez ce qui suit : NOT({Name} = '')

Pour en savoir plus, consultez les informations sur les références de champ de formule dans la documentation de l’assistance Airtable.

Regarder des réponses

Ce module de déclenchement lance un scénario lorsqu’un formulaire est envoyé.

NOTE
Cette fonctionnalité est disponible uniquement pour le forfait Airtable Pro payant.

L’URL du webhook doit être générée dans Workfront Fusion, puis ajoutée à la configuration du formulaire dans Airtable.

  1. Ajoutez le module Regarder les nouvelles réponses à votre scénario Workfront Fusion.

  2. Générez et copiez l’URL du webhook.

    Pour obtenir des instructions, voir Déclencheurs instantanés (webhooks) dans Adobe Workfront Fusion.

  3. Connectez-vous à votre compte Airtable.

  4. Ouvrez la Base et le tableau à utiliser pour le formulaire et créez une vue de formulaire.

  5. Définissez le formulaire selon vos besoins, faites défiler le formulaire vers le bas et activez l’option Rediriger vers l’URL après l’envoi du formulaire.

  6. Saisissez l’URL du webhook générée à l’étape 2 dans la boîte de dialogue affichée et ajoutez ?record_id={record_id} juste après l’URL du webhook pour inclure l’ID d’enregistrement dans la sortie du module, puis cliquez sur Enregistrer. L’URL qui en résulte, par exemple, se présente comme suit :

  7. Revenez à votre scénario Workfront Fusion et exécutez le module Regarder des réponses uniquement pour charger les champs d’Airtable et pour pouvoir mapper ces champs dans les autres modules.

  8. Envoyez le formulaire dans Airtable, où l’option Rediriger vers l’URL après l’envoi du formulaire est activée et où l’URL du webhook est ajoutée (étape 6 ci-dessus).

    Le module Regarder des réponses est déclenché et les données souhaitées sont chargées.

  9. Ajoutez le module Airtable > Obtenir un enregistrement juste après le module Airtable > Regarder des réponses et mappez le paramètre record_id au champ ID d’enregistrement.

Désormais, chaque fois que le formulaire est envoyé, le module Regarder des réponses dans votre scénario Workfront Fusion est déclenché et le module Obtenir un enregistrement renvoie les détails du formulaire envoyé.

Effectuer un appel API

Appel API personnalisé

Ce module d’action vous permet d’effectuer un appel authentifié personnalisé vers l’API Airtable. Vous pouvez ainsi créer une automatisation du flux de données que les autres modules Airtable ne peuvent pas réaliser.

L’action est basée sur le type d’entité (type d’objet Allocadia) que vous spécifiez.

Lorsque vous configurez ce module, les champs suivants s’affichent.

Connexion
Pour savoir comment connecter votre compte Airtable à Workfront Fusion, voir la section Connecter Airtable à Workfront Fusion dans cet article.
URL
Saisissez un chemin d’accès relatif à https://api.airtable.com/}. Exemple : v0/{base}/{table}
Méthode
Sélectionnez la méthode de requête HTTP dont vous avez besoin pour configurer l’appel API. Pour plus d’informations, voir la section Méthodes de requête HTTP dans Adobe Workfront Fusion.
En-têtes

Ajoutez les en-têtes de la requête sous la forme d’un objet JSON standard.

Par exemple, {"Content-type":"application/json"}

Workfront Fusion ajoute les en-têtes d’autorisation pour vous.

Chaîne de requête
Ajouter la requête pour l’appel API sous la forme d’une clé et d’une valeur
Corps

Ajoutez le contenu du corps de l’appel API sous la forme d’un objet JSON standard.

Note :

Lors de l’utilisation d’instructions conditionnelles telles que if dans votre fichier JSON, placez les guillemets en dehors de l’instruction conditionnelle.

recommendation-more-help
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43