🚀 Nuova versione beta disponibile! Feedback o problemi? Contattaci

Creazione di Add-ons per Google Sheets utilizzando Google Apps Script

Codegrind Team•Aug 23 2024

La creazione di add-ons per Google Sheets con Google Apps Script ti consente di sviluppare strumenti personalizzati per migliorare la produttività e automatizzare attività specifiche. In questa guida, esploreremo come sviluppare un add-on per Google Sheets, testarlo e distribuirlo per l’uso individuale o da parte del tuo team.

Sviluppo di un Add-on per Google Sheets

1. Configurazione del Progetto

Per iniziare, è necessario configurare il progetto di Google Apps Script per creare un add-on.

function onOpen() {
  var ui = SpreadsheetApp.getUi();
  ui.createMenu("My Custom Add-on")
    .addItem("Esegui Funzione", "executeCustomFunction")
    .addToUi();
}

function executeCustomFunction() {
  var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
  sheet.appendRow(["Dato generato dal Custom Add-on"]);
}

2. Aggiunta di Interfacce Personalizzate

Puoi arricchire l’add-on aggiungendo interfacce utente personalizzate come finestre di dialogo o barre laterali.

function showSidebar() {
  var html = HtmlService.createHtmlOutputFromFile("Sidebar")
    .setTitle("Strumenti Aggiuntivi")
    .setWidth(300);
  SpreadsheetApp.getUi().showSidebar(html);
}

Il contenuto della barra laterale può essere definito in un file HTML separato.

<!-- Sidebar.html -->
<div>
  <h2>Strumenti Aggiuntivi</h2>
  <button onclick="google.script.run.customFunction()">Esegui Funzione</button>
</div>

Testare l’Add-on

1. Esecuzione e Debugging

Durante lo sviluppo, è fondamentale testare l’add-on per garantire che funzioni correttamente.

function testAddonFunctionality() {
  Logger.log("Test dell'add-on in corso...");
  executeCustomFunction();
  Logger.log("Test completato.");
}

2. Risoluzione dei Problemi

Google Apps Script offre strumenti di debugging per aiutarti a identificare e risolvere eventuali problemi nel codice.

function debugAddon() {
  try {
    executeCustomFunction();
  } catch (e) {
    Logger.log("Errore rilevato: " + e.message);
  }
}

Distribuzione dell’Add-on

1. Distribuzione per Uso Personale o di Gruppo

Una volta completato lo sviluppo e i test, puoi distribuire l’add-on per l’uso personale o condividerlo con il tuo team.

function distributeAddon() {
  var manifest = {
    name: "My Custom Add-on",
    description: "Un add-on personalizzato per Google Sheets.",
    iconUrl: "https://example.com/icon.png",
    homepageUrl: "https://example.com/homepage",
  };
  Logger.log("Pronto per la distribuzione: " + JSON.stringify(manifest));
}

2. Aggiornamento degli Add-ons

Puoi rilasciare aggiornamenti all’add-on man mano che aggiungi nuove funzionalità o correggi bug.

function updateAddon() {
  // Aggiunta di una nuova funzionalità
  function newFeature() {
    Logger.log("Nuova funzionalità implementata.");
  }
  newFeature();
}

Esempi di Add-ons per Google Sheets

1. Automazione della Pulizia dei Dati

Un esempio comune di add-on è uno strumento per automatizzare la pulizia dei dati in Google Sheets.

function cleanData() {
  var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
  var range = sheet.getDataRange();
  var values = range.getValues();

  for (var i = 0; i < values.length; i++) {
    for (var j = 0; j < values[i].length; j++) {
      if (typeof values[i][j] === "string") {
        values[i][j] = values[i][j].trim();
      }
    }
  }
  range.setValues(values);
  Logger.log("Dati puliti.");
}

2. Gestione di Attività e Scadenze

Puoi creare un add-on che aiuta a gestire attività e scadenze all’interno di un foglio di lavoro.

function manageTasksAndDeadlines() {
  var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
  sheet.appendRow(["Attività", "Responsabile", "Scadenza"]);
  sheet.appendRow(["Revisione Documento", "Anna", "2024-09-10"]);
  Logger.log("Attività aggiunte.");
}

Conclusione

La creazione di add-ons per Google Sheets utilizzando Google Apps Script ti consente di sviluppare strumenti su misura per migliorare la produttività e automatizzare attività ripetitive. Seguendo questa guida, puoi sviluppare, testare e distribuire i tuoi add-ons, offrendo funzionalità avanzate e personalizzate per i tuoi fogli di lavoro, rendendo più efficiente la gestione dei dati e delle attività quotidiane.