Collegare AppSheet ad Apps Script

1. Introduzione

In questo codelab, crei un progetto Apps Script denominato "Hello World" e poi aggiungi una semplice funzione, logThis, che registra un messaggio che le è stato trasmesso. Poi crei un'automazione AppSheet e la fai chiamare lo script. Dopo aver chiamato lo script, torni all'editor Apps Script e ne confermi l'esecuzione.

Cosa imparerai a fare

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

Che cosa ti serve

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

2. Crea un progetto Apps Script

Per prima cosa, crea un progetto Apps Script denominato "Hello World" e poi aggiungi una semplice funzione, logThis, che registra un messaggio che le è stato trasmesso.

  1. Vai alla home page di Apps Script e poi fai clic su + Nuovo progetto.
  2. Modifica il titolo del progetto in Hello World. 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 la sezione Creare ed eliminare progetti.

3. Creare un'app AppSheet

Successivamente, generi rapidamente una nuova app AppSheet basata su un esempio di foglio Google copiato e poi la aggiorni per chiamare il progetto Apps Script che hai creato in precedenza.

  1. Apri il foglio di lavoro Esempio di ordini di magliette e poi 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 di magliette").
  2. Accedi ad AppSheet.
  3. Nella pagina Le mie app, fai clic su + Crea una nuova app. Viene visualizzata la finestra di dialogo Crea una nuova app.
  4. Fai clic su Inizia con i tuoi dati. Finestra di dialogo Nuova creazione app.
  5. (Facoltativo) Modifica il nome dell'app e seleziona una categoria.
  6. Fai clic su Scegli i 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. Vai al foglio di lavoro Ordini di magliette che hai copiato in precedenza e selezionalo.

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

Poi crei un'automazione AppSheet e la fai chiamare lo script.

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

5037cdd726e326e9.png

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

Passaggi di automazione per chiamare uno script.

  1. Nella sezione Impostazioni, imposta il tipo di attività su Chiama uno script.

Selezionando il tipo di attività "Chiama uno script" nelle impostazioni di automazione.

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

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

  1. Seleziona logThis(msg) dall'elenco Nome funzione. Selezionando la funzione Apps Script "logThis()" nel menu a discesa.

Viene visualizzato il campo Argomenti della funzione.

  1. Per l'argomento msg, inserisci la seguente espressione utilizzando l'assistente per le espressioni: "Hello from AppSheet"

Aggiunta di argomenti alla chiamata di funzione Apps Script.

  1. Fai clic su Salva per salvare l'app.
  2. Nel riquadro di anteprima, fai clic sull'icona Dispositivo mobile o Tablet per visualizzare l'emulatore dell'app.

68471f4646fc8fbe.png

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

Fai clic sull'icona di sincronizzazione in alto a destra nel riquadro Anteprima per sincronizzare con l'origine dati.

5. Conferma l'esecuzione di Apps Script

Dopo aver chiamato lo script, torna all'editor Apps Script e conferma la sua 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. Se il log non è visualizzato, fai clic su Aggiorna.

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

6. Passaggi aggiuntivi facoltativi

Come passaggio aggiuntivo di questo workshop, esamina il progetto Esempi di Apps Script 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 di Calendar.
  • createDoc() - Crea automaticamente un nuovo documento.
  • createSheet(): crea un nuovo foglio.
  • createSlideDeck() - Crea un nuovo file di Presentazioni utilizzando un'immagine e del testo.

Per ulteriori informazioni su questa importante funzionalità, consulta l'articolo Chiamare Apps Script da un'automazione, che fornisce una panoramica dettagliata, un video sulla funzionalità, tutorial e un progetto Apps Script copiabile che contiene molti esempi di funzionamento di AppSheet e Apps Script.