Best practice
Accorgimenti pratici per usare Magic Reports senza sorprese.
Non accumulare troppi report nello stesso foglio
"Run reports" esegue tutti i report del foglio uno dopo l'altro, nella stessa esecuzione. Google Apps Script interrompe qualunque esecuzione dopo 6 minuti, un limite della piattaforma che non dipende da Magic Reports e non può essere alzato: se i report da eseguire sono troppi (o alcuni impiegano molto tempo, ad esempio periodi molto lunghi o connettori che scaricano molti dati), l'esecuzione può fermarsi a metà e i report rimasti in coda semplicemente non vengono eseguiti in quel giro. Non ricevi un errore per i report saltati in questo modo: puoi accorgertene controllando la colonna "Report status" (i report non eseguiti mantengono lo stato dell'ultima esecuzione riuscita).
Se ti serve gestire molti report, alcune opzioni pratiche: dividerli su più fogli Google Sheets separati (ciascuno con la propria pianificazione), oppure programmarli in fasce orarie diverse con "Schedule reports" invece di eseguirli tutti insieme.
Nomi dei report devono essere unici
Se due report nello stesso foglio hanno lo stesso nome, solo uno dei due viene eseguito: l'altro viene saltato senza errore visibile. Controlla la colonna "Report name" se un report smette inaspettatamente di aggiornarsi.
Le due opzioni "Altre opzioni" nel form
Nella sidebar, sotto "Other Settings", trovi due checkbox comuni a (quasi) tutti i connettori:
- Convert numeric-looking values to numbers: converte i valori che sembrano numeri (es. la stringa "42") in numeri veri, così puoi usarli in formule, grafici e ordinamenti di Google Sheets invece che come testo.
- Append new results to old: invece di cancellare e riscrivere il foglio del report a ogni esecuzione, aggiunge le nuove righe in fondo a quelle già presenti. Utile per costruire uno storico nel tempo (es. uno snapshot al giorno), ma tieni presente che i totali del report non vengono mostrati quando questa opzione è attiva (vedi la pagina sui campi del foglio).
Alcuni campi si impostano solo scrivendo direttamente nella cella
Non tutti i campi del foglio di configurazione hanno un controllo corrispondente nella sidebar: Compare start date, Compare end date, Offset, Limit, Skip report, Show Quotas, Hide report header, Send to e-mail e Currency code (dove si applica) vanno scritti a mano nella cella della colonna corrispondente, non li trovi in nessun form. Il dettaglio di ciascuno è nella pagina Campi del foglio di configurazione.
Non modificare a mano la cella "Data Source"
Quella cella collega la colonna al connettore e alla connessione giusti. Se la modifichi o la cancelli, il report smette di funzionare: per cambiare connettore o connessione, ricrea il report dalla sidebar invece di editare quella cella.