Connecter AppSheet à Apps Script

1. Introduction

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

Points abordés

• Créer un projet Apps Script avec une fonction simple
• Créer une application AppSheet simple basée sur une feuille de calcul Google Sheets existante
• Créer une automatisation AppSheet qui appelle la fonction de script
• Vérifier que le script a bien été exécuté depuis AppSheet

Prérequis

• Accès à l'environnement de développement AppSheet (appsheet.com).
• 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

Vous allez maintenant générer rapidement une nouvelle application AppSheet basée sur un exemple de feuille de calcul Google Sheets copié, puis la mettre à jour pour appeler le projet Apps Script que vous avez créé auparavant.

1. Ouvrez la feuille de calcul Shirt Orders Example (Exemple de commandes de chemises), puis cliquez sur Make a copy (Créer une copie) pour télécharger et ouvrir une copie dans Google Sheets. Si vous le souhaitez, vous pouvez renommer la feuille de calcul (par exemple, « Commandes de chemises »).
2. Connectez-vous à AppSheet.
3. Sur la page "Mes applications", cliquez sur + Créer une application. La boîte de dialogue Create a new app (Créer une application) s'affiche.
4. Cliquez sur Start with your own data (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 Sélectionner vos données.

7. Cliquez sur google pour accéder à votre Google Drive.
8. Accédez à la feuille de calcul Shirts Orders (Commandes de chemises) que vous avez copiée précédemment et 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 allez ensuite créer une automatisation AppSheet et lui demander d'appeler le script.

1. Sélectionnez Automatisation > Bots
2. Cliquez sur + Nouveau bot.
3. Sélectionnez le premier élément de la liste de suggestions: Lorsqu'un enregistrement de commandes de chemises est créé ou mis à jour, envoyer une notification.

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

6. Sous Paramètres, définissez le type de tâche sur Appeler un script.

7. Dans le champ Apps Script Project (Projet Apps Script), cliquez sur Parcourir (icône Fichier).
8. Accédez au projet Apps Script Hello World dans votre Drive et sélectionnez-le.
9. Cliquez sur Sélectionner et, si vous êtes invité à autoriser l'accès, cliquez sur Autoriser et suivez les instructions.

Le projet Apps Script est ajouté et le champ Nom de la fonction contient la 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 d'Expression Assistant: ‘Hello from AppSheet'

12. Cliquez sur Save (Enregistrer) pour enregistrer l'application.
13. Dans le panneau d'aperçu, cliquez sur l'icône de mobile ou de tablette pour afficher l'émulateur d'application.

14. Ajoutez un nouvel ordre de chemises, 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 a bien été exécutée. Cliquez sur Refresh (Actualiser) si le journal ne s'affiche pas.

6. Étapes supplémentaires facultatives

Comme étape supplémentaire dans cet atelier, vous pouvez consulter le projet d'exemples Apps Script et exécuter certains des exemples tirés d'AppSheet.

Premiers pas avec les exemples Apps Script

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

Expérimenter avec plusieurs exemples

• createCalendarEvent() : créez un événement d'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, qui fournit une présentation détaillée, une vidéo sur les fonctionnalités, des tutoriels et un projet Apps Script copiable contenant de nombreux exemples de travail AppSheet-Apps Script.