Lettura e Scrittura di Dati nelle Celle con Google Apps Script

La lettura e scrittura di dati nelle celle di Google Sheets è una delle operazioni fondamentali che puoi eseguire con Google Apps Script. Queste operazioni ti permettono di automatizzare il processo di inserimento, aggiornamento e recupero dei dati dai tuoi fogli di calcolo, rendendo le tue attività più efficienti e riducendo il rischio di errori manuali.

Lettura dei Dati dalle Celle

1. Accesso a un Foglio di Calcolo

Per leggere i dati da un foglio di Google Sheets, è necessario prima accedere al foglio desiderato. Questo può essere fatto utilizzando l’ID del foglio di calcolo o il suo nome.

function accessSheet() {
  var sheet =
    SpreadsheetApp.openById("ID_DEL_FOGLIO").getSheetByName("NomeFoglio");
  return sheet;
}

2. Lettura di Dati da un Intervallo

Dopo aver ottenuto l’accesso al foglio, puoi leggere i dati da un intervallo specifico di celle.

function readData() {
  var sheet = accessSheet();
  var data = sheet.getRange("A1:B10").getValues();
  Logger.log(data);
}

In questo esempio, i dati vengono letti dall’intervallo A1:B10 e memorizzati come un array bidimensionale.

3. Lettura di una Singola Cella

Puoi anche leggere il contenuto di una singola cella.

function readSingleCell() {
  var sheet = accessSheet();
  var cellValue = sheet.getRange("A1").getValue();
  Logger.log(cellValue);
}

Scrittura di Dati nelle Celle

1. Scrittura di Dati in un Intervallo

Per scrivere dati in un intervallo specifico di celle, è necessario specificare i dati come un array bidimensionale e l’intervallo in cui scriverli.

function writeData() {
  var sheet = accessSheet();
  var data = [
    ["Valore1", "Valore2"],
    ["Valore3", "Valore4"],
  ];
  sheet.getRange("A1:B2").setValues(data);
}

2. Scrittura di un Valore Singolo in una Cella

Se devi aggiornare solo una cella, puoi farlo utilizzando il metodo setValue.

function writeSingleCell() {
  var sheet = accessSheet();
  sheet.getRange("A1").setValue("Nuovo Valore");
}

3. Aggiornamento di Celle Esistenti

Puoi anche aggiornare i dati esistenti in un foglio di calcolo. Ad esempio, puoi cercare una cella specifica basata sul contenuto e aggiornare il suo valore.

function updateData() {
  var sheet = accessSheet();
  var range = sheet.getRange("A1:B10");
  var values = range.getValues();

  for (var i = 0; i < values.length; i++) {
    for (var j = 0; j < values[i].length; j++) {
      if (values[i][j] == "Vecchio Valore") {
        values[i][j] = "Nuovo Valore";
      }
    }
  }

  range.setValues(values);
}

Manipolazione Avanzata dei Dati

1. Copia e Incolla di Dati

Puoi facilmente copiare dati da un intervallo e incollarli in un altro intervallo.

function copyPasteData() {
  var sheet = accessSheet();
  var sourceRange = sheet.getRange("A1:B10");
  var targetRange = sheet.getRange("C1:D10");
  sourceRange.copyTo(targetRange);
}

2. Cancellazione di Dati

Se hai bisogno di cancellare i contenuti di un intervallo, puoi farlo con il metodo clear.

function clearData() {
  var sheet = accessSheet();
  sheet.getRange("A1:B10").clear();
}

Conclusione

La lettura e scrittura di dati nelle celle con Google Apps Script ti consente di automatizzare molte delle attività quotidiane relative ai fogli di calcolo, rendendo i tuoi processi più efficienti e meno soggetti a errori. Con le tecniche illustrate in questa guida, puoi iniziare a manipolare i dati in Google Sheets in modo rapido e affidabile.