Manipolazione di Documenti Google Docs con Google Apps Script

La manipolazione di documenti Google Docs con Google Apps Script ti consente di automatizzare la creazione, modifica e formattazione dei documenti. Che tu stia generando report, lettere o qualsiasi altro tipo di documento, Google Apps Script offre un potente set di strumenti per gestire i documenti in modo programmatico. In questa guida, esploreremo le tecniche principali per lavorare con Google Docs utilizzando Google Apps Script.

Creazione di un Nuovo Documento Google Docs

1. Creazione di un Documento Vuoto

Puoi creare un nuovo documento Google Docs direttamente da Google Apps Script.

function createNewDocument() {
  var doc = DocumentApp.create("Nuovo Documento");
  Logger.log("Documento creato con ID: " + doc.getId());
}

2. Creazione di un Documento con Contenuto Predefinito

Puoi anche creare un documento e aggiungere subito del contenuto iniziale.

function createDocumentWithContent() {
  var doc = DocumentApp.create("Documento con Contenuto");
  var body = doc.getBody();
  body.appendParagraph(
    "Questo è un nuovo documento creato con Google Apps Script."
  );
}

Modifica di un Documento Esistente

1. Apertura di un Documento Esistente

Per manipolare un documento esistente, devi prima aprirlo utilizzando il suo ID.

function openExistingDocument() {
  var docId = "ID_DEL_DOCUMENTO";
  var doc = DocumentApp.openById(docId);
  return doc;
}

2. Aggiunta di Testo e Paragrafi

Puoi aggiungere testo o paragrafi a un documento aperto.

function addTextToDocument() {
  var doc = openExistingDocument();
  var body = doc.getBody();
  body.appendParagraph("Aggiunta di un nuovo paragrafo.");
  body.appendText(" Questo è un testo aggiunto alla fine del documento.");
}

3. Inserimento di Tabelle

Google Apps Script consente di inserire tabelle nei documenti Google Docs.

function insertTableInDocument() {
  var doc = openExistingDocument();
  var body = doc.getBody();
  var table = body.appendTable([
    ["Intestazione 1", "Intestazione 2"],
    ["Cella 1", "Cella 2"],
    ["Cella 3", "Cella 4"],
  ]);
  table.setBorderWidth(1);
}

Formattazione di Documenti

1. Formattazione del Testo

Puoi applicare stili di formattazione come grassetto, corsivo, sottolineato e colori.

function formatTextInDocument() {
  var doc = openExistingDocument();
  var body = doc.getBody();
  var text = body.appendParagraph("Testo formattato");
  text.setBold(true).setForegroundColor("#FF0000").setFontSize(14);
}

2. Formattazione di Paragrafi

La formattazione dei paragrafi include l’allineamento, l’interlinea e lo stile del paragrafo.

function formatParagraphInDocument() {
  var doc = openExistingDocument();
  var body = doc.getBody();
  var paragraph = body.appendParagraph(
    "Questo paragrafo è allineato al centro."
  );
  paragraph.setAlignment(DocumentApp.HorizontalAlignment.CENTER);
}

3. Gestione delle Immagini

Puoi inserire e manipolare immagini all’interno di un documento Google Docs.

function insertImageInDocument() {
  var doc = openExistingDocument();
  var body = doc.getBody();
  var imageUrl = "URL_IMMAGINE";
  var image = UrlFetchApp.fetch(imageUrl).getBlob();
  body.appendImage(image);
}

Automazione della Creazione di Report

1. Generazione di Report Dinamici

Puoi automatizzare la generazione di report popolando un documento con dati dinamici.

function generateDynamicReport() {
  var doc = DocumentApp.create("Report Dinamico");
  var body = doc.getBody();
  body.appendParagraph("Report generato automaticamente");

  var data = [
    ["Data", "Valore"],
    ["01/01/2024", "100"],
    ["02/01/2024", "200"],
  ];

  var table = body.appendTable(data);
  table.getRow(0).editAsText().setBold(true);
}

2. Invio di Documenti via Email

Dopo aver creato un documento, puoi inviarlo via email come allegato.

function sendDocumentByEmail() {
  var doc = DocumentApp.create("Documento da Inviare");
  var body = doc.getBody();
  body.appendParagraph("Questo documento sarà inviato via email.");

  var pdf = doc.getAs("application/pdf");
  MailApp.sendEmail({
    to: "recipient@example.com",
    subject: "Documento Google Docs",
    body: "In allegato trovi il documento richiesto.",
    attachments: [pdf],
  });
}

Conclusione

La manipolazione di documenti Google Docs con Google Apps Script offre un’ampia gamma di possibilità per automatizzare la creazione e la gestione dei documenti. Che tu stia generando report, automatizzando la formattazione o integrando documenti con altre applicazioni, Google Apps Script ti consente di gestire i documenti in modo efficiente e personalizzato.