← Torna alla Home

Registrare uno Script (Action Recorder)

Il modo più veloce per imparare la sintassi di Office Scripts è usare il Registratore di Azioni. Esattamente come il vecchio "Registratore di Macro" in VBA, questo strumento osserva quello che fai sul foglio e scrive il codice per te in tempo reale.

💡 Perché è utile?
Non serve essere programmatori esperti. Puoi registrare un'azione complessa (come creare un grafico o una tabella pivot) e poi guardare il codice generato per capire come funziona.

Guida Passo-Passo

1
Apri la scheda Automatizza
Nel tuo file Excel (versione Web), clicca sulla scheda Automatizza nella barra multifunzione in alto.
2
Avvia la Registrazione
Clicca sul pulsante Registra azioni (icona con il cerchio rosso). Sulla destra dello schermo si aprirà un pannello laterale chiamato "Registra azioni".
3
Esegui le tue modifiche
Ora lavora normalmente su Excel. Ad esempio:
  • Scrivi "Vendite 2024" nella cella A1.
  • Colora la cella di Giallo.
  • Metti il testo in Grassetto.
Noterai che nel pannello a destra appariranno delle frasi che descrivono ciò che stai facendo.
4
Interrompi e Salva
Quando hai finito, clicca su Interrompi nel pannello laterale. Excel ti mostrerà subito l'editor con il codice generato. Dai un nome al tuo script (es. "FormattaIntestazione") e salvalo.

Il Risultato: Analisi del Codice Generato

Dopo aver registrato l'esempio sopra (Scrittura testo + Colore + Grassetto), ecco il codice che Excel ha scritto per noi:

function main(workbook: ExcelScript.Workbook) {
    // Seleziona il foglio attivo
    let selectedSheet = workbook.getActiveWorksheet();

    // 1. Scrive il testo nella cella A1
    selectedSheet.getRange("A1").setValue("Vendite 2024");

    // 2. Imposta il colore di sfondo (Giallo)
    selectedSheet.getRange("A1").getFormat().getFill().setColor("FFFF00");

    // 3. Imposta il grassetto
    selectedSheet.getRange("A1").getFormat().getFont().setBold(true);
}
⚠️ Attenzione alla "ridondanza"
Il registratore è preciso ma a volte "prolisso". Noterai che ripete spesso selectedSheet.getRange("A1"). Un programmatore esperto pulirebbe il codice usando una variabile, ma per iniziare va benissimo così!

Cosa fare adesso?

Ora che hai registrato il tuo primo script, puoi provare a: