Interagire con i Google Forms tramite Google Apps Script

Nell'articolo "I vantaggi di creare un Google Form da codice tramite Google Apps Script" sono state messe in evidenza alcune qualità derivanti da una generazione dei form gestita lato codice rispetto all'uso, se pur comodissimo, del relativo editor WYSIWYG dedicato. In questo tutorial, invece, verranno mostrate le potenzialità di Google Apps Script per l'integrazione di funzionalità aggiuntive ad un Google Form, indipendentemente dal metodo con cui è stato generato, al fine di arricchire l'interfaccia con informazioni utili ed immediate basate sulla compilazione, fino a quel momento, del form stesso da parte degli utenti che l'hanno inviato.

L'obiettivo è pertanto quello di mostrare a video, nella pagina del Form, alcuni dati prelevati dal relativo Google Spreadsheet in cui sono salvate le risposte di chi ha compilato il modulo, nel caso specifico per la raccolta di informazioni sull'interesse sportivo da parte degli utenti, ovvero quello realizzato nell'articolo menzionato poco sopra (Fig. 1):

Fig. 1 - Esempio di un Google Form

Poniamo, ad esempio, che ci interessi visualizzare come informazione immediatamente disponibile il numero di utenti di sesso maschile e di sesso femminile con l'indicazione dell'intervallo di età per ciascuno dei due gruppi.
I dati su cui ci baseremo saranno quindi quelli relativi alle risposte di 'Sesso' e 'Data di nascita' che, nello Spreadsheet delle risposte al form, sono i seguenti (Fig. 2, N.B.: i dati mostrati sono puramente inventati al solo scopo illustrativo):

Fig. 2 - Esempio di uno Spreadsheet contenente le risposte ad un Google Form

Di seguito il codice da incorporare (bound-script) all'interno del Form tramite il relativo 'Editor di script...' che può essere aperto dalla schermata di modifica del Google Form cliccando sul menu rappresentato da 3 pallini in verticale e cliccando a sua volta l'opportuno elemento nel menu che si aprirà contestualmente (Fig. 3):

Fig. 3 - Apertura dell'Editor di Script di un Google Form

Il codice da inserire all'interno dell'editor e molte altre informazioni su come interagire con i Google Forms tramite Google Apps Script continuano nel mio libro "Punta in alto con... Google Apps Script":

Fig. A - Il libro in italiano - Punta in alto con... Google Apps Script - pag 280 e 281

...E QUESTO È SOLO QUANTO RIFERITO ALL'INTERAZIONE CON I GOOGLE FORMS DA APPS SCRIPT!

ACQUISTA ORA IL LIBRO SU AMAZON:

Se sei pronto a diventare un esperto nella programmazione in Google Apps Script non posso fare altro che augurarti una buona lettura e soprattutto... Buon divertimento!

Come si può notare dalla funzione presente nel trigger di tipo semplice 'onOpen', all'apertura della pagina del form verrà creato un menu personalizzato (un esempio dettagliato sulla creazione dei menu personalizzati si trova nell'articolo "Menu personalizzati in SpreadsheetApp e DocumentApp con Google Apps Script") all'interno dell'interfaccia composto da un solo elemento con la finalità di mostrare, nel corpo di una colonna laterale, le informazioni sul tipo di utenza che ha, fino a quel momento, utilizzato il form.

function onOpen() {
  ui.createMenu('Riepilogo informazioni...')
  .addItem("Mostra info sul tipo di utenza che utilizza il form...", 'showInformation')
  .addToUi();
  var current_user = Session.getActiveUser().getEmail();
  if (current_user.length == 0) {
    showTempSideBar();    
  } else {
    showInformation();
  }
}

La stessa funzione controlla se l'utente è autorizzato all'uso di questo nuovo componente ed in caso negativo, tramite un'apposita funzione (nel caso specifico showTempSideBar()) mostrerà, all'interno della colonna laterale, un messaggio di richiesta di autorizzazioni per l'utente che sta utilizzando la nuova funzionalità e le relative modalità di attivazione (Fig. 4):

Fig. 4 - Richiesta di autorizzazioni all'uso del nuovo componente aggiuntivo

Una volta autorizzato l'utente seguendo i vari passaggi della procedura di autenticazione, ovvero quanto Session.getActiveUser().getEmail() sarà valorizzato (corrispondente alla mail dell'utente autorizzato), verrà mostrato nella colonna laterale il contenuto desiderato (Fig. 5):

Fig. 5 - Colonna laterale che mostra il risultato dell'elaborazione in Google Apps Script dei dati del Form presenti nel relativo Spreadsheet

La parte di codice dedicata all'elaborazione dei dati del Form presenti all'interno del relativo Spreadsheet di trova nella funzione showInformation() che viene ora richiamata ogni volta che la pagina del form viene aperta.
Quello che viene effettivamente svolto è il recupero del foglio di calcolo in questione ed in base agli indici delle domande del Form e le righe presenti nello Sheet, viene effettuato un ciclo per il recupero delle informazioni di sesso e data di nascita in base a due modalità (mostrate a scopo illustrativo), quella tramite i loro indici, con getIndex(), oppure tramite il titolo della domanda, con getTitle(), e viene visualizzato tramite la composizione di un contenuto HTML il messaggio deiderato previa elaborazione dei dati con le funzioni di appoggio per la somma del numero dei maschi e delle femmine e per il calcolo dell'età (recuperato per differenza di date con la funzione personalizzata dateDifference(dateMin, dateMax)) e la relativa identificazione dei valori minimi e massimi.

Per aggiornare i dati sarà sufficiente ricaricare la pagina o, meglio ancora, cliccare sull'icona dei componenti aggiuntivi (il pezzo del puzzle) per poi cliccare sulla voce di menu: 'Riepilogo informazioni...'.

E' inoltre possibile richiamare una funzione, tramite i trigger dell'editor di script, nel momento in cui un utente effettua il submit del Form. Questa funzionalità può trovare utilità, ad esempio, per farsi inviare una mail di notifica ogni volta che il Form viene inviato.
Per assegnare un trigger automatico al submit del Form è necessario selezionare, dalla barra dei menu dell'editor di Apps Script incorporato al file del Form, la voce "Modifica --> Trigger del progetto corente" e scegliere la funzione da richiamare, come mostrato nell'immagine seguente, Fig. 6:

Fig. 6 - Assegnare una funzione al submit del Form tramite i Trigger del progetto

Da notare, nel codice completo, la semplicità con cui è possibile far apparire la colonna laterale, ovvero tramite il metodo ui.showSidebar() ed allo stesso tempo come la manipolazione del suo contenuto HTML e CSS avviene in poche righe grazie al servizio HtmlService.

Per quanto riguarda invece il recupero delle informazioni dallo Spreadsheet, ovvero la parte di codice dove viene utilizzato il metodo getDataRange(), consiglio la lettura dell'articolo "Google Apps Script: best practice per il miglioramento delle performance" in particolare la parte dove viene raccomandato l'utilizzo delle operazioni batch.