Modules Google Sheets
Dans un scénario Adobe Workfront Fusion, vous pouvez automatiser les workflows qui utilisent Google Sheets et les connecter à plusieurs applications et services tiers.
Pour obtenir des instructions sur la procédure de connexion de votre compte Google Sheets à Workfront Fusion, voir Créer une connexion vers Adobe Workfront Fusion - Instructions de base
Conditions d’accès
Vous devez disposer des accès suivants pour utiliser les fonctionnalités de cet article :
| table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header | |
|---|---|
| Package Adobe Workfront | Tous |
| Licence Adobe Workfront |
Nouveau : Standard Ou En cours : Travail ou version ultérieure |
| Licence Adobe Workfront Fusion ** |
Actuel : aucune exigence de licence Workfront Fusion Ou Hérité : Workfront Fusion pour l’automatisation et l’intégration du travail |
| Produit |
Nouveau :
Ou Actuel : votre entreprise doit acheter Adobe Workfront Fusion. |
Pour plus d’informations sur les informations contenues dans ce tableau, voir Conditions d’accès requises dans la documentation.
Pour plus d’informations sur les licences Adobe Workfront Fusion, voir Licences Adobe Workfront Fusion.
Conditions préalables
Pour utiliser les modules Google Sheets, vous devez avoir un compte Google.
Informations sur l’API Google Sheets
Le connecteur Google Sheets utilise les éléments suivants :
Modules Google Sheets et leurs champs
Lorsque vous configurez les modules Google Forms, Workfront Fusion affiche les champs répertoriés ci-dessous. En plus de ces derniers, des champs Google Sheets supplémentaires peuvent s’afficher, selon des facteurs tels que votre niveau d’accès dans l’application ou le service. Un titre en gras dans un module indique un champ obligatoire.
Si le bouton « Mapper » apparaît au-dessus d’un champ ou d’une fonction, vous pouvez l’utiliser pour définir des variables et des fonctions pour ce champ. Pour plus d’informations, voir Mappage des informations d’un module à un autre.
Déclencheurs
Surveiller les lignes
Récupère les valeurs des nouvelles lignes ajoutées dans la feuille de calcul.
Le module récupère uniquement les nouvelles lignes qui n’ont pas été remplies auparavant. Le déclencheur ne traite pas une ligne remplacée.
Actions
Ajouter une ligne
Ce module ajoute une ligne à une feuille.
Lorsque vous configurez les modules Google Sheets, Workfront Fusion affiche les champs répertoriés ci-dessous. En plus de ces derniers, des champs Google Sheets supplémentaires peuvent s’afficher, selon des facteurs tels que votre niveau d’accès dans l’application ou le service. Un titre en gras dans un module indique un champ obligatoire.
Si le bouton « Mapper » apparaît au-dessus d’un champ ou d’une fonction, vous pouvez l’utiliser pour définir des variables et des fonctions pour ce champ. Pour plus d’informations, voir Mappage des informations d’un module à un autre.
Ajouter une feuille
Crée une feuille dans une feuille de calcul sélectionnée.
Effacer une cellule
Supprime une valeur d’une cellule spécifiée.
Effacer une ligne
Supprime les valeurs d’une ligne spécifiée.
Créer une feuille de calcul
Supprimer une ligne
Supprime une ligne spécifiée.
Supprimer une feuille
Supprime une feuille spécifique.
Obtenir une cellule
Récupère une valeur d’une cellule sélectionnée.
Effectuer un appel API
Ce module d’action vous permet d’effectuer un appel API personnalisé.
https://sheets.googleapis.com/v4/.{"Content-type":"application/json"}. Workfront Fusion ajoute les en-têtes d’autorisation pour vous.Ajoutez le contenu du corps de l’appel API sous la forme d’un objet JSON standard.
Note :
Lorsque vous utilisez des instructions conditionnelles telles que if dans votre JSON, placez les guillemets à l’extérieur de l’instruction conditionnelle.
Mettre à jour une cellule
Mettre à jour une ligne
Ce module permet de modifier le contenu d’une cellule dans une ligne sélectionnée.
Recherches
Obtenir les valeurs de plage
Répertorier les feuilles
Ce module renvoie une liste de toutes les feuilles d’une feuille de calcul.
Effectuer une recherche dans les lignes
Effectue une recherche dans les lignes à l’aide des options de filtre.
Effectuer une recherche sur les lignes (avancé)
Renvoie des résultats correspondant aux critères donnés.
Limites d’utilisation
Si l’erreur 429: RESOURCE_EXHAUSTED se produit, vous avez dépassé la limite de l’API.
L’API Google Sheets est limitée à 500 requêtes par 100 secondes par projet et à 100 requêtes par 100 secondes par personne. Les limites de lecture et d’écriture sont suivies séparément. Il n’y a pas de limite d’utilisation quotidienne.
Pour plus de détails, voir developers.google.com/sheets/api/limits.
Conseils et astuces
Récupérer des cellules vides à partir d’un Google Sheet
Pour obtenir des cellules vides, vous pouvez utiliser le module Rechercher des lignes (avancé). Utilisez cette formule pour obtenir les colonnes vides.
select * where E is null
Ici, « E » est la colonne et « est nul » est la condition. Vous pouvez créer une requête plus avancée à l’aide du langage de requête Google. Pour plus d’informations, consultez Google Query Lang dans la documentation de Google.
Ajouter un bouton dans une feuille pour exécuter un scénario
-
Dans Workfront Fusion, insérez le module Webhook > Custom webhooks dans le scénario et configurez-le. Pour obtenir des instructions, voir Webhooks.
-
Copiez l’URL du webhook.
-
Exécutez le scénario.
-
Dans Google Sheets, choisissez Insérer > Dessin… dans la barre de menu principale.
-
Dans la fenêtre Dessin, cliquez sur l'icône Zone de texte
-
Créez un bouton et cliquez sur le bouton Enregistrer et fermer dans le coin supérieur droit :
-
Le bouton est placé dans votre feuille de calcul. Cliquez sur les trois points verticaux dans le coin supérieur droit du bouton :
-
Choisissez Attribuer un script… dans le menu.
-
Saisissez le nom de votre script (fonction), par exemple
runScenario, et cliquez sur OK : -
Choisissez Outils > Éditeur de script dans la barre de menu principale.
-
Insérez le code suivant :
-
Le nom de la fonction doit correspondre au nom que vous avez spécifié à l’étape 9.
-
Remplacez l’URL par l’URL du webhook que vous avez copié à l’étape 2.
code language-none function runScenario() { UrlFetchApp.fetch("<webhook you copied>"); }
-
-
Appuyez sur Ctrl + S pour enregistrer le fichier script, saisissez un nom de projet et cliquez sur OK.
-
Revenez à Google Sheets et cliquez sur votre nouveau bouton.
-
Accorder l’autorisation obligatoire au script :
-
Dans Workfront Fusion, vérifiez que le scénario s’est exécuté correctement.
Stocker des dates dans une feuille de calcul
Si vous stockez une valeur Date dans une feuille de calcul sans mise en forme, elle apparaît dans la feuille de calcul sous forme de texte au format ISO 8601. Toutefois, Google Sheets formules ou fonctions qui fonctionnent avec des dates qui ne comprennent pas ce texte (exemple : formule =A1+10) affichent l'erreur suivante :
Pour Google Sheets aider à comprendre la date, mettez-la en forme avec la fonction formatDate . Le format correct transmis à la fonction en tant que deuxième argument dépend des paramètres régionaux de la feuille de calcul.
Pour plus d’informations sur cette fonction, voir formatDate (date ; format ; [fuseau horaire]) dans l’article Fonctions de date et d’heure.
Pour déterminer le format correct :
-
Dans Google Sheets, choisissez Fichier > Feuille de calcul dans le menu principal pour vérifier et définir le paramètre régional.
-
Après avoir vérifié ou défini le paramètre régional approprié, déterminez le format de date et d’heure correspondant en choisissant Format > Nombre dans le menu principal. Le format est affiché à côté de l’élément de menu Date et heure :
-
Pour composer le format correct à transmettre à la fonction formatDate(), reportez-vous à la liste de Jetons pour le formatage de la date et de l’heure.
Exemple :
Pour le format MM/DD/YYYY HH:mm:ss (pour la langue des États-Unis) :
Exploiter les fonctions de Google Sheets
Pour utiliser une fonction intégrée à partir de Google Sheets, vous pouvez l’exploiter. Pour plus d’informations, voir Utiliser Google Sheets fonctions dans l’article Mappage d’un élément à l’aide de fonctions.
Empêcher les Google Sheets de transformer des nombres en dates
Si une chaîne de nombres que vous utilisez comme texte est interprétée comme une date dans une feuille de calcul Google, vous pouvez préformater le nombre en tant que texte brut pour éviter cela. Par exemple, si vous tapez 1-2019, dans le but de l’utiliser comme texte, Google peut l’interpréter comme une date.
- Dans Google Sheets, mettez en évidence la colonne ou la cellule contenant le ou les nombres.
- Cliquez sur Format > Nombre > Texte brut.
Une autre solution dans Workfront Fusion consiste à saisir une apostrophe (’) avant un nombre, par exemple « 1-2019 » ou « 1/47 ». L’apostrophe ne s’affiche pas dans la cellule une fois les données envoyées depuis Workfront Fusion.