Modules Google Sheets
Dans un scénario Adobe Workfront Fusion, vous pouvez automatiser les workflows qui utilisent Google Sheets et le connecter à plusieurs applications et services tiers.
Pour savoir comment connecter votre compte Google Sheets à Workfront Fusion, voir la section Créer une connexion à 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 :
Pour connaître la formule, le type de licence ou l’accès dont vous disposez, contactez votre équipe d’administration Workfront.
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 :
Déclencheurs
Surveiller les lignes
Récupère les valeurs de chaque ligne nouvellement ajoutée 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 énuméré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, consultez la section Mapper des informations d’un module à l’autre dans Adobe Workfront Fusion.
Mettre à jour une ligne
Ce module permet de modifier le contenu d’une cellule dans une ligne sélectionnée.
Effacer une ligne
Supprime les valeurs d’une ligne spécifiée.
Supprimer une ligne
Supprime une ligne spécifiée.
Obtenir une cellule
Récupère une valeur d’une cellule sélectionnée.
Mettre à jour une cellule
Effacer une cellule
Supprime une valeur d’une cellule spécifiée.
Ajouter une feuille
Crée une feuille dans une feuille de calcul sélectionnée.
Créer une feuille de calcul
Supprimer une feuille
Supprime une feuille spécifique.
Réaliser 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.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 autour de l’instruction conditionnelle.
Recherches
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.
Obtenir des valeurs de plage
Répertorier les feuilles
Ce module renvoie une liste de toutes les feuilles d’une feuille de calcul.
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
Comment obtenir les cellules vides d’une Google Sheet
Utilisez le module Effectuer une recherche dans les lignes (avancé) et utilisez cette formule pour obtenir les colonnes qui sont vides.
select * where E is null
Ajouter un bouton dans une feuille pour exécuter un scénario
-
Dans Workfront Fusion, insérez le module/déclencheur Webhook > Webhooks personnalisés dans le scénario et configurez-le (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 sera 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.
function runScenario() {UrlFetchApp.fetch("<webhook que vous avez copié>");}
-
-
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 bien exécuté.
Stocker des dates dans une feuille de calcul
Si vous stockez une valeur de date dans une feuille de calcul sans aucun formatage, elle apparaîtra dans la feuille de calcul sous forme de texte au format ISO 8601. Cependant, les formules ou fonctions de Google Sheets qui travaillent avec des dates et qui ne comprennent pas ce texte (exemple : formule =A1+10) afficheront l’erreur suivante :
Pour permettre à Google Sheets de comprendre la date, formatez-la avec la fonction formatDate (date; format; [timezone]). Le format correct transmis à la fonction en tant que deuxième argument dépend des paramètres locaux de la feuille de calcul.
Pour déterminer le format correct :
-
Choisissez les paramètres Fichier > Feuille de calcul dans le menu principal pour vérifier/régler les paramètres locaux.
-
Une fois que vous avez vérifié/réglé les paramètres locaux, 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(), consultez la liste des Jetons pour le formatage de la date et de l’heure dans Adobe Workfront Fusion.
Exemple : l'utilisation du format MM/DD/YYYY HH:mm:ss pour les États-Unis :
Exploiter les fonctions de Google Sheets
Si une fonction intégrée vous manque, mais qu’elle est disponible sur Google Sheets, vous pouvez l’exploiter. Pour plus d’informations, voir Utiliser les fonctions de Google Sheetsdans Mapper des éléments à l’aide des fonctions de Adobe Workfront Fusion.
Empêcher Google Sheets de transformer des nombres en dates
Vous pouvez constater qu’une chaîne de chiffres que vous utilisez comme texte est interprétée comme une date dans une feuille de calcul Google. Par exemple, vous tapez 1-2019, en pensant que c’est du texte, mais Google l’interprète comme une date. Pour éviter cela, vous pouvez préformater le numéro en texte brut.
- 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 après l’envoi des données depuis Workfront Fusion.