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 disposer d’un compte Google.
Informations sur l’API Google Sheets
Le connecteur Google Sheets utilise les éléments suivants :
Déclencheurs
Watch Rows
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
Add a Row
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, voir Mappage des informations d’un module à un autre.
Update a Row
Ce module permet de modifier le contenu d’une cellule dans une ligne sélectionnée.
Clear a Row
Supprime les valeurs d’une ligne spécifiée.
Delete a Row
Supprime une ligne spécifiée.
Get a Cell
Récupère une valeur d’une cellule sélectionnée.
Update a Cell
Clear a Cell
Supprime une valeur d’une cellule spécifiée.
Add a Sheet
Crée une feuille dans une feuille de calcul sélectionnée.
Create a Spreadsheet
Delete a Sheet
Supprime une feuille spécifique.
Make an API Call
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
Search Rows
Effectue une recherche dans les lignes à l’aide des options de filtre.
Search Rows (Advanced)
Renvoie des résultats correspondant aux critères donnés.
Get Range Values
List Sheets
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 Search Rows (Advanced) 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 > Custom webhooks dans le scénario et configurez-le (voir Webhooks).
-
Copiez l’URL du webhook.
-
Exécutez le scénario.
-
Dans Google Sheets, choisissez Insert > Drawing… dans la barre de menus principale.
-
Dans la fenêtre Drawing, cliquez sur l’icône Text box
-
Créez un bouton et cliquez sur le bouton Save and Close 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 Assign script… dans le menu.
-
Saisissez le nom de votre script (fonction), par exemple
runScenarioet cliquez sur OK : -
Choisissez Tools > Script editor dans la barre de menus 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 you copied> »);}
-
-
Appuyez sur Ctrl+S pour enregistrer le fichier de 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 Google Sheets aider à comprendre la date, mettez-la en forme avec la fonction formatDate (date ; format ; [fuseau horaire]). 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 :
-
Sélectionnez File > Paramètres Spreadsheet dans le menu principal pour vérifier/définir le paramètre régional.
-
Une fois que vous avez vérifié/défini le paramètre régional approprié, déterminez le format de date et d’heure correspondant en choisissant Format > Number 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 : 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 > Number > Plain text.
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.