Associer AppSheet à Apps Script

1. Présentation

Dans cet atelier de programmation, vous allez créer un projet Apps Script nommé "Hello World", puis ajouter une fonction simple logThis qui consigne un message qui lui a été transmis. Vous créez ensuite une automatisation AppSheet et demandez-lui 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 à l'aide d'une fonction simple
Découvrez 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é à partir d'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.

Accédez à la page d'accueil d'Apps Script, puis cliquez sur + New Project (+ Nouveau projet).
Remplacez le titre du projet par Hello World. .
Modifiez le script dans l'éditeur de la manière suivante:

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

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 application AppSheet basée sur un exemple de feuille de calcul Google Sheets, puis la mettre à jour pour appeler le projet Apps Script que vous avez créé précédemment.

Ouvrez la feuille de calcul Exemple de commandes de chemises, puis cliquez sur 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").
Connectez-vous à AppSheet.
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.
Cliquez sur Start with your data (Commencer avec vos propres données).
Vous pouvez également modifier le nom de l'application et sélectionner une catégorie.
Cliquez sur Sélectionner vos données.

Sélectionnez "Sélectionner vos données" dans la boîte de dialogue de création de l'application.

Cliquez sur google pour accéder à votre compte Google Drive.
Accédez à la feuille de calcul Hauts de chemise que vous avez copiée précédemment et sélectionnez-la.

AppSheet configure votre application. Fenêtre d'aperçu initiale de l'application générée.

Cliquez sur Personnaliser votre application pour ouvrir l'application dans l'éditeur AppSheet.

4. Créer une automatisation

Vous allez maintenant créer une automatisation AppSheet et l'appeler.

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

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

Procédure d'automatisation pour appeler un script.

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

Sélectionnez le type de tâche "Appeler un script" dans les paramètres "Automatisation".

Dans le champ Apps Script Project (Projet Apps Script), cliquez sur Browse (Parcourir) (icône Fichier).
Accédez au projet Apps Script Hello World dans votre Drive, puis sélectionnez-le.
Cliquez sur Sélectionner et, si vous y êtes invité, cliquez sur Autoriser et suivez les instructions.

Le projet Apps Script est ajouté et le champ Function Name (Nom de la fonction) est renseigné avec la liste des fonctions disponibles.

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

Le champ Function Arguments (Arguments de fonction) s'affiche.

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

Ajout d'arguments à l'appel de fonction Apps Script

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

Ajoutez une commande de chemise, puis cliquez sur Enregistrer.
Cliquez sur Sync (Synchroniser) pour synchroniser vos modifications.

Cliquez sur l'icône de synchronisation en haut à droite du panneau des aperçus pour synchroniser les données avec la source de données.

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

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

Revenez à la page d'accueil d'Apps Script et consultez le projet Hello World.
Cliquez sur Executions (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 n'apparaît pas.

Affichage des journaux d'exécution dans l'environnement de l'éditeur Apps Script pour vérifier l'exécution de la fonction depuis l'appel AppSheet

6. Étapes supplémentaires facultatives

Un autre point de cet atelier est nécessaire pour examiner le projet d'exemples Apps Script et exécuter quelques exemples d'AppSheet.

Premiers pas avec les exemples Apps Script

Pour commencer, faites une copie du projet Apps Script.
Cliquez sur l'icône de copie.
Enregistrez le nouveau projet, puis cliquez sur Exécuter pour autoriser les applications qui s'y trouvent.

Testez plusieurs exemples

createCalendarEvent() - Créez un événement Agenda.
createDoc() : crée automatiquement un document.
createSheet() : permet de créer une feuille.
createSlideDeck() : créez une présentation avec une image et du 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 de fonctionnalité, des tutoriels et un projet Apps Script pouvant être copié, qui contient de nombreux exemples de fonctionnement d'AppSheet.