← Indice del corso Digital Mentor
MODULO 3 · LEZIONE 5 DI 8
Automatizzare diventa utile quando le regole sono già chiare. In questo laboratorio crei un modulo e un foglio, poi elabori le richieste alla chiusura delle iscrizioni.
Tempo indicativo: 120 minuti, comprese lettura, prove e attività.
Che cosa saprai fare
- Tradurre un processo in una richiesta di codice verificabile.
- Creare una simulazione con Forms e Sheets.
- Distinguere test della logica ed esecuzione nel proprio ambiente Google.
Chi fa che cosa
Il docente definisce campi, capienza e criterio; l’IA può proporre progetto e codice; Apps Script esegue le istruzioni con le autorizzazioni concesse dall’account. Un prompt, da solo, non crea un modulo nel tuo Drive. Qui trovi un esempio completo da leggere, copiare e provare in un progetto separato.
Il prompt per progettare l’automazione
Agisci come analista dei processi scolastici ed esperto Apps Script.
Crea un sistema dimostrativo di iscrizione ai corsi IA 1,
Digital Mentor 1 e Digital Mentor 2, un’edizione da 10 posti ciascuna.
Raccogli nome, cognome, email istituzionale, ordine di scuola,
prima scelta e seconda scelta diversa oppure nessuna alternativa.
Limita a una risposta per account. Alla chiusura assegna prima
tutte le prime scelte e poi le seconde, in ordine cronologico.
Mantieni le risposte originali; scrivi gli esiti in un altro foglio.
Genera codice completo, casi di prova e istruzioni.
Non inviare email e non pubblicare automaticamente il modulo.
Prima del codice chiarisci ipotesi e limiti.
Regole e limiti dell’esempio
Il codice seguente lavora con un’edizione per corso. Non apre automaticamente altre edizioni. Le prime scelte hanno priorità; le richieste valide vengono ordinate per data e ora. La prima richiesta valida di una email viene elaborata, le successive sono segnalate. Preferenze uguali o dati incompleti richiedono verifica; nessuna alternativa o posti esauriti producono attesa.
Il modulo nasce non pubblicato e non invia messaggi. La seconda scelta uguale alla prima viene segnalata durante l’elaborazione, perché questo esempio non implementa una convalida incrociata in Forms. L’email inserita è controllata nel formato, non certificata come istituzionale. Per usare il sistema in un istituto servono le sue regole di accesso e gestione dei dati.
Codice completo da copiare in Apps Script
Apri il codice Apps Script completo
/* Laboratorio Digital Mentor - InformaticaScuola.it, Gianluca Palmieri.
* Un'edizione da 10 posti per ciascuno dei tre corsi.
* Progetto Apps Script autonomo, esecuzione manuale dopo chiusura iscrizioni.
* I fogli Risposte restano intatti; Assegnazioni viene rigenerato.
*/
const DM = {
corsi: ['Intelligenza Artificiale 1', 'Digital Mentor 1', 'Digital Mentor 2'],
posti: 10,
campi: ['Nome', 'Cognome', 'Email istituzionale', 'Ordine di scuola',
'Prima scelta', 'Seconda scelta'],
nessuna: 'Nessuna alternativa'
};
function creaSistema() {
const lock = LockService.getScriptLock();
lock.waitLock(30000);
try {
const p = PropertiesService.getScriptProperties();
let sid = p.getProperty('DM_SHEET_ID');
let fid = p.getProperty('DM_FORM_ID');
if (!sid) {
const ss = SpreadsheetApp.create('Digital Mentor - iscrizioni DEMO');
sid = ss.getId();
p.setProperty('DM_SHEET_ID', sid);
ss.getSheets()[0].setName('Istruzioni');
ss.getSheets()[0].getRange('A1:A4').setValues([
['DEMO: usare dati fittizi.'],
['Dopo la chiusura eseguire assegnaIscrizioni.'],
['Assegnazioni è un output rigenerato: conservarne una copia prima di modificarlo.'],
['Risposte originali non modificate; nessuna email inviata.']
]);
}
if (!fid) {
const f = FormApp.create('Iscrizioni corsi - DEMO Digital Mentor', false);
fid = f.getId();
p.setProperty('DM_FORM_ID', fid);
}
const form = FormApp.openById(fid);
if (p.getProperty('DM_SETUP_OK') !== '1') {
if (form.getItems().length > 0) {
throw new Error('Configurazione interrotta: controllare il modulo prima di proseguire.');
}
form.setDescription('Simulazione didattica. Inserire soltanto dati fittizi. ' +
'Scegliere una seconda preferenza diversa dalla prima.');
form.setLimitOneResponsePerUser(true);
form.setCollectEmail(false);
form.setPublishingSummary(false);
form.setAllowResponseEdits(false);
form.setConfirmationMessage("Ti comunicheremo l'edizione assegnata dopo la chiusura delle iscrizioni");
form.addTextItem().setTitle('Nome').setRequired(true);
form.addTextItem().setTitle('Cognome').setRequired(true);
form.addTextItem().setTitle('Email istituzionale').setRequired(true)
.setValidation(FormApp.createTextValidation().requireTextIsEmail().build());
form.addListItem().setTitle('Ordine di scuola').setChoiceValues([
'Infanzia', 'Primaria', 'Secondaria di I grado', 'Secondaria di II grado'
]).setRequired(true);
form.addListItem().setTitle('Prima scelta').setChoiceValues(DM.corsi).setRequired(true);
form.addListItem().setTitle('Seconda scelta')
.setChoiceValues(DM.corsi.concat([DM.nessuna])).setRequired(true);
if (form.getDestinationId() !== sid) {
form.setDestination(FormApp.DestinationType.SPREADSHEET, sid);
}
p.setProperty('DM_SETUP_OK', '1');
}
console.log('Modifica modulo: ' + form.getEditUrl());
console.log('Foglio: ' + SpreadsheetApp.openById(sid).getUrl());
console.log('Modulo creato NON pubblicato. Verificare impostazioni e accesso prima di pubblicarlo.');
} finally {
lock.releaseLock();
}
}
function assegnaIscrizioni() {
const lock = LockService.getScriptLock();
lock.waitLock(30000);
try {
const p = PropertiesService.getScriptProperties();
if (p.getProperty('DM_SETUP_OK') !== '1') throw new Error('Eseguire prima creaSistema.');
const form = FormApp.openById(p.getProperty('DM_FORM_ID'));
if (form.isAcceptingResponses()) {
throw new Error('Chiudere prima la raccolta delle risposte in Google Forms.');
}
const ss = SpreadsheetApp.openById(p.getProperty('DM_SHEET_ID'));
const candidati = ss.getSheets().filter(s => {
if (s.getLastColumn() < DM.campi.length) return false;
const h = s.getRange(1, 1, 1, s.getLastColumn()).getDisplayValues()[0];
return DM.campi.every(c => h.includes(c));
});
if (candidati.length !== 1) {
throw new Error('Serve un unico foglio risposte con le sei intestazioni originali.');
}
const valori = candidati[0].getDataRange().getValues();
const h = valori.shift().map(String);
const righe = valori.filter(r => r.some(v => v !== '')).map((r, i) => ({
ordine: i, data: r[0], nome: r[h.indexOf('Nome')],
cognome: r[h.indexOf('Cognome')], email: r[h.indexOf('Email istituzionale')],
scuola: r[h.indexOf('Ordine di scuola')],
prima: r[h.indexOf('Prima scelta')], seconda: r[h.indexOf('Seconda scelta')]
}));
const risultati = calcolaAssegnazioni(righe, DM.corsi, DM.posti);
const out = ss.getSheetByName('Assegnazioni') || ss.insertSheet('Assegnazioni');
const tabella = [['Data richiesta', 'Nome', 'Cognome', 'Email',
'Corso assegnato', 'Esito']].concat(risultati.map(r => [
r.data, r.nome, r.cognome, r.email, r.assegnato, r.esito
].map(cellaSicura)));
out.clearContents();
out.getRange(1, 1, tabella.length, 6).setValues(tabella);
out.setFrozenRows(1);
out.autoResizeColumns(1, 6);
console.log('Elaborate ' + risultati.length + ' richieste. Verificare Assegnazioni.');
} finally {
lock.releaseLock();
}
}
// Evita che testo inserito nel modulo diventi una formula nel foglio di output.
function cellaSicura(v) {
return typeof v === 'string' && /^\s*[=+@-]/.test(v) ? "'" + v : v;
}
// Funzione indipendente da Google: priorità alle prime scelte, poi seconde scelte.
function calcolaAssegnazioni(righe, corsi, posti) {
if (!Number.isInteger(posti) || posti < 1) throw new Error('Capienza non valida.');
const occupati = Object.fromEntries(corsi.map(c => [c, 0]));
const viste = new Set();
const ordinate = righe.map((r, i) => ({...r, ordine: i,
assegnato: '', esito: '', tempo: new Date(r.data).getTime()}));
ordinate.sort((a, b) => {
const ta = Number.isFinite(a.tempo) ? a.tempo : Infinity;
const tb = Number.isFinite(b.tempo) ? b.tempo : Infinity;
return ta === tb ? a.ordine - b.ordine : ta - tb;
});
ordinate.forEach(r => {
const email = String(r.email || '').trim().toLowerCase();
if (!Number.isFinite(r.tempo) || !String(r.nome || '').trim() ||
!String(r.cognome || '').trim() || !/^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(email) ||
!corsi.includes(r.prima) ||
!(corsi.includes(r.seconda) || r.seconda === DM.nessuna) ||
r.prima === r.seconda) {
r.esito = 'Da verificare: dati o preferenze non validi';
return;
}
if (viste.has(email)) { r.esito = 'Duplicata: verificare manualmente'; return; }
viste.add(email);
if (occupati[r.prima] < posti) {
occupati[r.prima]++;
r.assegnato = r.prima;
r.esito = 'Assegnato - prima scelta';
}
});
ordinate.forEach(r => {
if (r.esito) return;
if (corsi.includes(r.seconda) && occupati[r.seconda] < posti) {
occupati[r.seconda]++;
r.assegnato = r.seconda;
r.esito = 'Assegnato - seconda scelta';
} else {
r.esito = 'In attesa';
}
});
return ordinate;
}
// Prova senza creare file, senza dati reali e senza inviare messaggi.
function provaAlgoritmo() {
const [a, b, c] = DM.corsi;
const righe = Array.from({length: 11}, (_, i) => ({
data: new Date(2026, 0, 1, 9, i), nome: 'Docente', cognome: String(i + 1),
email: 'docente' + (i + 1) + '@example.org', scuola: 'Primaria',
prima: a, seconda: b
}));
righe.push({data: new Date(2026, 0, 1, 10), nome: 'Docente', cognome: '12',
email: 'docente12@example.org', scuola: 'Primaria', prima: b, seconda: c});
const risultati = calcolaAssegnazioni(righe, DM.corsi, 10);
if (risultati.filter(r => r.assegnato === a).length !== 10 ||
risultati.filter(r => r.assegnato === b).length !== 2) {
throw new Error('Test non superato.');
}
console.log('Test superato: A=10, B=2, nessuna attesa.');
}
Come eseguirlo
- Apri script.google.com con l’account scelto per la prova e crea un nuovo progetto.
- Sostituisci il contenuto di Codice.gs con il codice completo. Salva.
- Esegui
provaAlgoritmo: il registro deve indicare A=10 e B=2. Questa funzione non crea file. - Esegui
creaSistema. Leggi i permessi richiesti e autorizza soltanto se coerenti con la prova. - Apri dal registro il modulo e il foglio creati. Verifica campi, destinatari e messaggio finale.
- Dopo il collaudo delle impostazioni pubblica il modulo di prova per gli account autorizzati e inserisci dati fittizi.
- Chiudi la raccolta delle risposte in Forms e poi esegui
assegnaIscrizioni. - Controlla la scheda Assegnazioni e confrontala con le risposte originali.
La funzione di creazione memorizza gli identificativi nel progetto e riutilizza i file alle esecuzioni successive. Se la configurazione si interrompe dopo aver inserito alcune domande, si ferma per consentire un controllo manuale. Se un file memorizzato è stato eliminato o è diventato inaccessibile, correggi il problema prima di rieseguire.
Attenzione all’output: ogni esecuzione dell’assegnazione rigenera la scheda «Assegnazioni». Conserva altrove le eventuali correzioni manuali e una copia del risultato validato. Il foglio con le risposte del modulo viene letto senza modificarlo. Non sono installati trigger: l’elaborazione si avvia soltanto quando esegui la funzione.
Il collaudo che deve precedere l’uso
| Prova | Esito atteso |
|---|---|
| 11 prime scelte per IA 1 con alternativa DM 1 | 10 in IA 1; l’undicesima in DM 1 dopo le prime scelte |
| Prima e seconda scelta uguali | Da verificare |
| Due richieste con la stessa email | Prima valida elaborata; successiva duplicata |
| Tutti i corsi indicati sono pieni | In attesa |
| Ripetere l’elaborazione sugli stessi dati | Stesse assegnazioni, nessuna duplicazione del risultato |
| Raccolta ancora aperta | Elaborazione bloccata con messaggio esplicito |
È stato verificato il comportamento della logica di assegnazione con test locali. La creazione e l’accesso a Forms dipendono dall’ambiente Google dell’istituto e vanno collaudati lì. In caso di errore leggi la voce Esecuzioni, individua funzione e riga e descrivi il problema all’IA senza allegare dati personali o credenziali.
Laboratorio · Automazione sotto controllo
Tempo: 35 minuti. Lavora con dati fittizi e con gli strumenti autorizzati dalla tua scuola.
- Esegui prima la prova della logica.
- Crea i file dimostrativi e verifica le impostazioni.
- Compila il modulo con una piccola simulazione consentita dai tuoi account di prova.
- Chiudi la raccolta, elabora e confronta manualmente due assegnazioni.
Da consegnare: Link ai file di prova e verbale dei casi verificati.
Prova di riuscita: Sai spiegare ogni esito e distinguere un errore nei dati da un errore nello script.
Controlla la comprensione
Il codice blocca l’undicesima iscrizione durante la compilazione?
No. Raccoglie le richieste e assegna dopo la chiusura, usando le alternative o la lista d’attesa.
Si possono aggiungere invii automatici senza altri controlli?
Prima si definiscono destinatari, contenuto, condizioni di invio e gestione degli errori, quindi si collauda la modifica.
Materiali del laboratorio
Scarica il kit operativo Digital Mentor in formato Word: scheda di progetto, piano, collaudo e rubrica modificabili. Il codice completo è nella lezione 5. Gli esempi usano soltanto dati fittizi.
Fonti e guide ufficiali
A cura di Gianluca Palmieri · Adattamento web dei materiali Digital Mentor · Aggiornato a novembre 2026. Le interfacce e le funzioni disponibili possono variare in base all’account scolastico.


