Collegare AppSheet ad Apps Script

1. Introduzione

In questo codelab, creerai un progetto Apps Script denominato "Hello World" e aggiungi una funzione semplice, logThis, che registri un messaggio che gli è stato passato. Quindi crei un'automazione di AppSheet e fai in modo che chiami lo script. Una volta richiamato lo script, torna all'editor di Apps Script per confermarne l'esecuzione.

Cosa imparerai a fare

  • Come creare un progetto Apps Script con una funzione semplice.
  • Come creare una semplice app AppSheet basata su un foglio Google esistente.
  • Come creare un'automazione AppSheet che chiami la funzione di script.
  • Come verificare la corretta esecuzione dello script da AppSheet.

Che cosa ti serve

  • Accesso all'ambiente di sviluppo di AppSheet (appsheet.com).
  • Accesso all'ambiente di sviluppo di Apps Script (script.google.com).

2. Creare un progetto Apps Script

Innanzitutto, crea un progetto Apps Script denominato "Hello World" e aggiungi una funzione semplice, logThis, che registri un messaggio che gli è stato passato.

  1. Vai alla home page di Apps Script e fai clic su + Nuovo progetto.
  2. Cambia il titolo del progetto in Hello World. La finestra di dialogo Rinomina progetto con il nuovo nome.
  3. Aggiorna lo script nell'editor nel seguente modo:
function logThis(msg) {
  Logger.log('Message from AppSheet was: ' + msg);
}
  1. Fai clic su Salva progetto.

Per saperne di più, consulta Creare ed eliminare progetti.

3. Crea un'app AppSheet

Successivamente, genererai rapidamente una nuova app AppSheet basata su un foglio Google di esempio copiato e quindi la aggiornerà in modo da chiamare il progetto Apps Script che hai creato in precedenza.

  1. Apri il foglio di lavoro Esempio di ordini di camicie e fai clic su Crea una copia per scaricare e aprire una copia in Fogli Google. Se vuoi, puoi rinominare il foglio di lavoro (ad es. "Ordini camicie").
  2. Accedi ad AppSheet.
  3. Nella pagina Le mie app, fai clic su + Crea nuova app. Viene visualizzata la finestra di dialogo Crea una nuova app.
  4. Fai clic su Inizia con i tuoi dati. Finestra di dialogo per la creazione di una nuova app.
  5. Se vuoi, modifica il nome dell'app e seleziona una categoria.
  6. Fai clic su Scegli i tuoi dati.

Selezionando "Scegli i tuoi dati" nella finestra di dialogo di creazione della nuova app.

  1. Fai clic su google per accedere a Google Drive.
  2. Apri e seleziona il foglio di lavoro Ordini di camicie che hai copiato in precedenza.

AppSheet configura la tua app. Finestra di anteprima iniziale per l'app generata.

  1. Fai clic su Personalizza la tua app per aprirla nell'editor di AppSheet.

4. Crea un'automazione

Successivamente, dovrai creare un'automazione di AppSheet e fare in modo che chiami lo script.

  1. Seleziona Automazione > Bot.
  2. Fai clic su + Nuovo bot.
  3. Seleziona il primo elemento nell'elenco dei suggerimenti: Quando un record Ordini di camicie viene creato o aggiornato, invia una notifica.

5037cdd726e326e9.png

  1. Fai clic sul passaggio Invia una notifica per modificarla.
  2. Cambia il nome in Call a script.

Passaggi di automazione per chiamare uno script.

  1. In Impostazioni, modifica il tipo di attività in Chiama uno script.

Selezionando l'opzione "Chiama uno script" nelle impostazioni di automazione.

  1. Nel campo Progetto Apps Script, fai clic su Sfoglia (icona del file).
  2. Vai al progetto Apps Script Hello World e selezionalo nel tuo Drive.
  3. Fai clic su Seleziona e, se ti viene richiesta l'autorizzazione, fai clic su Autorizza e segui le istruzioni.

Viene aggiunto il progetto Apps Script e il campo Nome funzione viene compilato con un elenco delle funzioni disponibili.

  1. Seleziona logThis(msg) dall'elenco Nome funzione. Selezione della funzione di Apps Script "logThis()" nel menu a discesa.

Viene visualizzato il campo Argomenti funzione.

  1. Per l'argomento msg, inserisci la seguente espressione utilizzando l'Assistente espressioni: 'Hello from AppSheet'

Aggiunta di argomenti alla chiamata di funzione di Apps Script.

  1. Fai clic su Salva per salvare l'app.
  2. Nel riquadro Anteprima, fai clic sull'icona del dispositivo mobile o del tablet per visualizzare l'emulatore di app.

68471f4646fc8fbe.png

  1. Aggiungi un nuovo ordine di camicie e fai clic su Salva.
  2. Fai clic su Sincronizza per sincronizzare le modifiche.

Fai clic sull'icona di sincronizzazione in alto a destra del riquadro Anteprima per eseguire la sincronizzazione con l'origine dati.

5. Conferma l'esecuzione di Apps Script

Una volta richiamato lo script, torna all'editor di Apps Script per confermarne l'esecuzione.

  1. Torna alla home page di Apps Script e visualizza il progetto Hello World.
  2. Fai clic su Esecuzioni nella barra di navigazione per confermare che la funzione logThis è stata completata correttamente. Fai clic su Aggiorna se il log non viene visualizzato.

Visualizzazione dei log di esecuzione nell'ambiente dell'editor di Apps Script per verificare l'esecuzione della funzione dalla chiamata di AppSheet.

6. Passaggi aggiuntivi facoltativi

Come passaggio aggiuntivo in questo workshop, esamina il progetto Apps Script Example ed esegui alcuni esempi da AppSheet.

Inizia a utilizzare gli esempi di Apps Script

  1. Per iniziare, crea una copia del progetto di esempi di Apps Script.
  2. Fai clic sull'icona di copia.
  3. Salva il nuovo progetto e fai clic su Esegui per autorizzare le app nel progetto.

Prova diversi esempi

  • createCalendarEvent() - Crea un nuovo evento nel calendario.
  • createDoc(): crea automaticamente un nuovo documento.
  • createSheet() - Crea un nuovo foglio.
  • createSlideDeck() - Crea una nuova presentazione utilizzando un'immagine e del testo.

Per ulteriori informazioni su questa importante funzionalità, consulta Chiamare Apps Script da un'automazione, che fornisce una panoramica dettagliata, video delle funzionalità, tutorial e un progetto Apps Script copiabile contenente molti esempi operativi di AppSheet-Apps Script.