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.

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

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 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.

1. 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").
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 data (Commencer avec vos propres données).
5. Vous pouvez également modifier le nom de l'application et sélectionner une catégorie.
6. Cliquez sur Sélectionner vos données.

7. Cliquez sur google pour accéder à votre compte Google Drive.
8. 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.

9. 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.

1. Sélectionnez Automatisation > Bots.
2. Cliquez sur + Nouveau bot.
3. Sélectionnez le premier élément de la liste des suggestions: Lorsqu'un enregistrement de chemises est créé ou mis à jour, envoyez 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 Browse (Parcourir) (icône Fichier).
8. Accédez au projet Apps Script Hello World dans votre Drive, puis sélectionnez-le.
9. 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.

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

Le champ Function Arguments (Arguments de 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 Save (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 chemise, puis cliquez sur Enregistrer.
15. Cliquez sur Sync (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 consultez le projet Hello World.
2. 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.

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

1. Pour commencer, faites une copie du projet Apps Script.
2. Cliquez sur l'icône de copie.
3. 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.