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.
- Vai alla home page di Apps Script e fai clic su + Nuovo progetto.
- Cambia il titolo del progetto in
Hello World.
- Aggiorna lo script nell'editor nel seguente modo:
function logThis(msg) {
Logger.log('Message from AppSheet was: ' + msg);
}
- 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.
- 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").
- Accedi ad AppSheet.
- Nella pagina Le mie app, fai clic su + Crea nuova app. Viene visualizzata la finestra di dialogo Crea una nuova app.
- Fai clic su Inizia con i tuoi dati.
- Se vuoi, modifica il nome dell'app e seleziona una categoria.
- Fai clic su Scegli i tuoi dati.
- Fai clic su google per accedere a Google Drive.
- Apri e seleziona il foglio di lavoro Ordini di camicie che hai copiato in precedenza.
AppSheet configura la tua app.
- 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.
- Seleziona Automazione > Bot.
- Fai clic su + Nuovo bot.
- Seleziona il primo elemento nell'elenco dei suggerimenti: Quando un record Ordini di camicie viene creato o aggiornato, invia una notifica.
- Fai clic sul passaggio Invia una notifica per modificarla.
- Cambia il nome in
Call a script
.
- In Impostazioni, modifica il tipo di attività in Chiama uno script.
- Nel campo Progetto Apps Script, fai clic su Sfoglia (icona del file).
- Vai al progetto Apps Script
Hello World
e selezionalo nel tuo Drive. - 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.
- Seleziona logThis(msg) dall'elenco Nome funzione.
Viene visualizzato il campo Argomenti funzione.
- Per l'argomento msg, inserisci la seguente espressione utilizzando l'Assistente espressioni: 'Hello from AppSheet'
- Fai clic su Salva per salvare l'app.
- Nel riquadro Anteprima, fai clic sull'icona del dispositivo mobile o del tablet per visualizzare l'emulatore di app.
- Aggiungi un nuovo ordine di camicie e fai clic su Salva.
- Fai clic su Sincronizza per sincronizzare le modifiche.
5. Conferma l'esecuzione di Apps Script
Una volta richiamato lo script, torna all'editor di Apps Script per confermarne l'esecuzione.
- Torna alla home page di Apps Script e visualizza il progetto Hello World.
- 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.
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
- Per iniziare, crea una copia del progetto di esempi di Apps Script.
- Fai clic sull'icona di copia.
- 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.