Macro di Fogli Google

Fogli Google consente di registrare le macro che duplicano una serie specifica di interazioni dell'interfaccia utente da te definite. Dopo aver registrato una macro, puoi collegarla a una scorciatoia da tastiera nel modulo Ctrl+Alt+Shift+Number. Puoi usare questa scorciatoia per ripetere rapidamente i passaggi esatti della macro, in genere in una posizione diversa o su dati diversi. Puoi anche attivare la macro dal menu Estensioni di Fogli Google > Macro.

Quando registri una macro, Fogli Google crea automaticamente una funzione Apps Script (la funzione macro) che replica i passaggi della macro. La funzione macro viene aggiunta a un progetto Apps Script associato al foglio, in un file denominato macros.gs. Se esiste già un file di progetto associato al foglio con questo nome, gli viene aggiunta la funzione macro. Fogli Google aggiorna automaticamente anche il manifest del progetto di script, registrando il nome e la scorciatoia da tastiera assegnati alla macro.

Poiché ogni macro registrata è definita interamente in Apps Script, puoi modificarla direttamente nell'editor di Apps Script. Puoi persino scrivere macro da zero in Apps Script o utilizzare le funzioni che hai già scritto e trasformarle in macro.

Creare macro in Apps Script

Puoi utilizzare le funzioni scritte in Apps Script come funzioni macro. Il modo più semplice per farlo è importare una funzione esistente dall'editor di Fogli Google.

In alternativa, puoi creare macro nell'editor di Apps Script seguendo questa procedura:

  1. Nell'interfaccia utente di Fogli Google, seleziona Estensioni > Apps Script per aprire lo script associato al foglio nell'editor di Apps Script.
  2. Scrivi la funzione macro. Le funzioni macro non devono accettare argomenti e non restituire valori.
  3. Modifica il manifest dello script per creare la macro e collegarla alla funzione macro. Assegna una scorciatoia da tastiera e un nome univoci.
  4. Salva il progetto di script. La macro diventa quindi disponibile per l'utilizzo nel foglio.
  5. Testa la funzione macro nel foglio per verificare che funzioni come previsto.

Modifica di macro

Puoi modificare le macro allegate a un foglio nel seguente modo:

  1. Nell'interfaccia utente di Fogli Google, seleziona Estensioni > Macro > Gestisci macro.
  2. Trova la macro che vuoi modificare e seleziona > Modifica macro. In questo modo, l'editor di Apps Script apre il file di progetto che contiene la funzione macro.
  3. Modifica la funzione macro per cambiare il comportamento della macro.
  4. Salva il progetto di script. La macro diventa quindi disponibile per l'utilizzo nel foglio.
  5. Testa la funzione macro nel foglio per verificare che funzioni come previsto.

Importare le funzioni come macro

Se esiste già uno script associato a un foglio, puoi import una funzione nello script come nuova macro e assegnare una scorciatoia da tastiera. Puoi farlo modificando il file manifest e aggiungendo un altro elemento alla proprietà sheets.macros[].

In alternativa, segui questi passaggi per importare una funzione come macro dall'interfaccia utente di Fogli:

  1. Nell'interfaccia utente di Fogli Google, seleziona Estensioni > Macro > Importa.
  2. Seleziona una funzione dall'elenco visualizzato e fai clic su Aggiungi funzione.
  3. Seleziona per chiudere la finestra di dialogo.
  4. Seleziona Estensioni > Macro > Gestisci macro.
  5. Individua nell'elenco la funzione appena importata. Assegna alla macro una scorciatoia da tastiera univoca. Puoi anche modificare il nome della macro qui; il nome predefinito corrisponde al nome della funzione.
  6. Fai clic su Aggiorna per salvare la configurazione della macro.

Struttura del manifest per le macro

Il seguente snippet di esempio del file manifest mostra la sezione di un manifest che definisce le macro di Fogli Google. La sezione sheets del manifest definisce il nome e la scorciatoia da tastiera assegnati alla macro, nonché il nome della funzione stessa.

  {
    ...
    "sheets": {
      "macros": [{
        "menuName": "QuickRowSum",
        "functionName": "calculateRowSum",
        "defaultShortcut": "Ctrl+Alt+Shift+1"
      }, {
        "menuName": "Headerfy",
        "functionName": "updateToHeaderStyle",
        "defaultShortcut": "Ctrl+Alt+Shift+2"
      }]
    }
  }

Consulta la risorsa relativa al manifest delle macro di Fogli per ulteriori dettagli su come vengono creati i manifest delle macro di Fogli.

Best practice

Per la creazione o la gestione delle macro in Apps Script, è consigliabile attenersi alle linee guida riportate di seguito.

  1. Le macro sono più performanti quando sono leggere. Se possibile, limita il numero di azioni intraprese da una macro.
  2. Le macro sono più adatte per le operazioni automatiche che devono essere ripetute con una configurazione minima o nulla. Per altre operazioni, valuta la possibilità di utilizzare una voce di menu personalizzata.
  3. Ricorda sempre che le scorciatoie da tastiera delle macro devono essere univoche e che un determinato foglio può avere solo dieci macro con scorciatoie alla volta. Eventuali macro aggiuntive possono essere eseguite solo dal menu Estensioni > Macro.
  4. Le macro che apportano modifiche a una singola cella possono essere applicate a un intervallo di celle selezionando prima l'intervallo completo e poi attivando la macro. Ciò significa che spesso non è necessario creare macro che ripetono la stessa operazione in un intervallo di celle predefinito.

Cosa non è possibile fare

Esistono alcune restrizioni su ciò che è possibile fare con le macro:

Utilizzare macro al di fuori degli script associati

Le macro sono definite in script associati a Fogli Google specifici. Le definizioni delle macro vengono ignorate se definite in uno script autonomo o in un'app web.

Definire le macro nei componenti aggiuntivi di Fogli

Non puoi distribuire le definizioni delle macro utilizzando un componente aggiuntivo di Fogli. Tutte le definizioni di macro in un progetto di componente aggiuntivo di Fogli vengono ignorate dagli utenti di quel componente aggiuntivo.

Distribuire le macro nelle librerie di script

Non puoi distribuire le definizioni delle macro utilizzando le librerie di Apps Script.

Utilizzare le macro al di fuori di Fogli Google

Le macro sono solo una funzionalità di Fogli Google e non esistono per Documenti, Moduli o Presentazioni Google.