Connecter AppSheet à Apps Script

1. Introduction

Dans cet atelier de programmation, vous allez créer un projet Apps Script nommé "Hello World", puis ajouter une fonction simple, logThis, qui enregistre un message qui lui a été transmis. Vous créez ensuite une automatisation AppSheet et lui demandez d'appeler le script. Une fois le script appelé, vous revenez à l'éditeur Apps Script et confirmez son exécution.

Points abordés

• Découvrez comment créer un projet Apps Script avec une fonction simple.
• Comment créer une application AppSheet simple à partir d'une feuille de calcul Google Sheets existante
• Créer une automatisation AppSheet qui appelle la fonction de script.
• Comment vérifier que le script a bien été exécuté depuis AppSheet ?

Prérequis

• Un accès à l'environnement de développement AppSheet (appsheet.com)
• Un accès à l'environnement de développement Apps Script (script.google.com)

2. Créer un projet Apps Script

Commencez par créer un projet Apps Script nommé "Hello World", puis ajoutez une fonction simple, logThis, qui consigne un message qui lui a été transmis.

1. Accédez à la page d'accueil d'Apps Script, puis cliquez sur + Nouveau projet.
2. Remplacez le titre du projet par Hello World.
3. Mettez à jour le script dans l'éditeur comme suit :

function logThis(msg) {
  Logger.log('Message from AppSheet was: ' + msg);
}

4. Cliquez sur Enregistrer le projet.

Pour en savoir plus, consultez Créer et supprimer des projets.

3. Créer une application AppSheet

Ensuite, vous générez rapidement une application AppSheet basée sur un exemple de feuille de calcul Google Sheets copiée, puis vous la mettez à jour pour appeler le projet Apps Script que vous avez créé précédemment.

1. Ouvrez la feuille de calcul Exemple de commandes de t-shirts, puis cliquez sur Créer une copie pour la télécharger et l'ouvrir dans Google Sheets. Si vous le souhaitez, vous pouvez renommer la feuille de calcul (par exemple,"Commandes de t-shirts").
2. Connectez-vous à AppSheet.
3. Sur la page "Mes applications", cliquez sur + Créer une application. La boîte de dialogue Créer une application s'affiche.
4. Cliquez sur Commencer avec vos propres données.
5. Si vous le souhaitez, modifiez le nom de l'application et sélectionnez une catégorie.
6. Cliquez sur Choisir vos données.

7. Cliquez sur google pour accéder à votre Google Drive.
8. Accédez à la feuille de calcul Shirt Orders (Commandes de t-shirts) que vous avez copiée précédemment, puis sélectionnez-la.

AppSheet configure votre application.

9. Cliquez sur Customize your app (Personnaliser votre application) pour ouvrir l'application dans l'éditeur AppSheet.

4. Créer une automatisation

Vous créez ensuite une automatisation Appsheet et lui demandez d'appeler le script.

1. Sélectionnez Automatisation > Robots.
2. Cliquez sur + Nouveau bot.
3. Sélectionnez le premier élément de la liste des suggestions : Envoyer une notification lorsqu'un enregistrement de commande de t-shirt est créé ou mis à jour.

4. Cliquez sur l'étape Envoyer une notification pour la modifier.
5. Remplacez le nom par Call a script.

6. Sous Paramètres, remplacez le type de tâche par Appeler un script.

7. Dans le champ Projet Apps Script, cliquez sur Parcourir (icône de fichier).
8. Accédez au projet Apps Script Hello World dans votre Drive, puis sélectionnez-le.
9. Cliquez sur Sélectionner, puis, si vous êtes invité à donner votre autorisation, cliquez sur Autoriser et suivez les instructions.

Le projet Apps Script est ajouté et le champ Nom de la fonction est rempli avec une liste des fonctions disponibles.

10. Sélectionnez logThis(msg) dans la liste Nom de la fonction.

Le champ Arguments de la fonction s'affiche.

11. Pour l'argument msg, saisissez l'expression suivante à l'aide de l'assistant d'expression : 'Hello from AppSheet'

12. Cliquez sur Enregistrer pour enregistrer l'application.
13. Dans le panneau d'aperçu, cliquez sur l'icône Mobile ou Tablette pour afficher l'émulateur d'application.

14. Ajoutez une commande de t-shirts, puis cliquez sur Enregistrer.
15. Cliquez sur Synchroniser pour synchroniser vos modifications.

5. Confirmer l'exécution d'Apps Script

Une fois le script appelé, revenez à l'éditeur Apps Script et confirmez son exécution.

1. Revenez à la page d'accueil d'Apps Script et affichez le projet Hello World.
2. Cliquez sur Exécutions dans la barre de navigation pour vérifier que la fonction logThis s'est bien exécutée. Cliquez sur Actualiser si le journal ne s'affiche pas.

6. Étapes supplémentaires facultatives

Dans cet atelier, vous allez également examiner le projet "Exemples Apps Script" et exécuter certains exemples à partir d'AppSheet.

Premiers pas avec les exemples Apps Script

1. Pour commencer, copiez le projet d'exemples Apps Script.
2. Cliquez sur l'icône de copie.
3. Enregistrez le nouveau projet, puis cliquez sur Exécuter pour autoriser les applications du projet.

Testez plusieurs exemples.

• createCalendarEvent() : créez un événement Agenda.
• createDoc() : crée automatiquement un document.
• createSheet() : créez une feuille.
• createSlideDeck() : créez une présentation à l'aide d'une image et de texte.

Pour en savoir plus sur cette fonctionnalité importante, consultez Appeler Apps Script à partir d'une automatisation. Vous y trouverez une présentation détaillée, une vidéo sur la fonctionnalité, des tutoriels et un projet Apps Script à copier qui contient de nombreux exemples de fonctionnement d'AppSheet et Apps Script.