Sei es die Einladung zur Geburtstagsfeier, ein Rundschreiben an die Vereinsmitglieder oder eine andere Marketingaktivität. Serienbriefe ermöglichen eine automatisierte und trotzdem persönliche Ansprache der Empfänger.
In diesem Beitrag möchte ich zeigen, wie man mit Hilfe von Google Sheets und Google Docs auch aufwändig gestaltete Dokumente an eine Vielzahl an Empfängern schicken kann.
Für Lesefaule gibt es am Ende natürlich auch die Videovariante.
Ziel des Projektes
Dieser Beitrag baut auf einem älteren Beitrag von mir auf, in dem ich bereits automatisiert Dokumente erstellt habe. Damals habe ich die Platzhalter einzeln abgefragt. Das war aber recht unpraktikabel, daher möchte ich in diesem Projekt alle Platzhalter aus einem Google Spreadsheet beziehen.
Zunächst einmal die Ziele, die ich mir für diesen Hack gesetzt habe.
- Erstellen einer Serienbriefvorlage mit Platzhaltern (Format {{platzhalter}})
- Google Sheet Tabellendokument mit den Empfängern und den zu ersetzenden Platzhaltern
- Automatisches Erstellen und Ablegen der generierten Briefe als PDF in einem Ordner
Erstellen der Briefvorlage
Ich habe erst angefangen meinen Brief in Google Docs zu schreiben, wie ich es in dem vorhergehenden Beitrag gemacht habe.
Dann ist mir aber eine spannende Idee gekommen!
Google Slides bietet viel mehr Formatierungsoptionen und bietet somit eine clevere Alternative zum erstellen von Dokumenten an. Dort kann man mit Formen und Illustrationen arbeiten, und es ist hier ebenfalls möglich die Platzhalter austauschen zu lassen.
Ich werde als Dokument einfach beides unterstützen:
Erstellen eines Spreadsheets für die Platzhalter
Als letztes erstellen wir unser Spreadsheets in dem sich die einzelnen Empfänger befinden und die Werte für die Platzhalter.
Drei der Felder werden eine Bedeutung in meiner Logic haben:
- template: Document-Id der Vorlage (so sind wir flexibel)
- filename: Dateiname der erzeugt werden soll (wenn leer, wird keine Datei angelegt)
App-Script Magic
Für alle Nicht-Coder unter euch ist dieser Abschnitt, bis auf den eigentlichen Script, weniger interessant.
/*
Beim start werden neue Menüpunkte zu Sheets hinzugefügt
*/
function onOpen() {
var ui = SpreadsheetApp.getUi();
ui.createMenu('Serienbrief')
.addItem('Erstellen', 'createDocuments')
.addToUi();
}
/*
Konvertiere die aktuelle Datarange in ein Object-Array und nutze die erste Zeile als Object-Properties
*/
function spreadSheetToObjects(){
//Alle gefüllten Spalten auslesen
var range=SpreadsheetApp.getActiveSheet().getDataRange().getDisplayValues();
//Array für alle Einträge
var data=[];
for(var row=1; row<range.length; row++){ //Durchläuft alle Zeilen bis auf die Überschriften (daher row=1)
var dataObject={};
for (var col=0; col<range[0].length; col++){ //Durchläuft alle Spalten
var key=range[0][col]; //Übernimmt die Überschrift als Object-Property
var value=range[row][col]; //Schreibt den Wert der aktuellen Zeile ins Objekt
dataObject[key]=value; // Fügt den Eintrag zum Array hinzu
}
data.push(dataObject); //Fügt das Datenobjekt in die Liste hinzu
}
return data; //Gibt das Object-Array zurück
}
/*
Zielordner für die erstellten Dokumente.
Wird als "gen" auf gleicher Ebene wie das Spreadsheet angelegt
*/
function getTargetFolder(){
var folderName="gen"; //Name des Zielordners
//Aktuellen Ordner ermitteln:
var folder=DriveApp.getFileById(SpreadsheetApp.getActiveSpreadsheet().getId()).getParents().next();
//Gibt es einen "gen" Ordner?
var genFolders=folder.getFoldersByName(folderName);
console.log("genfolders", genFolders.length);
if(genFolders.hasNext()){
return genFolders.next();
}else{
//"gen" Ordner erstellen
return folder.createFolder(folderName);
}
}
function createDocument(dataObject, targetFolder){
//Template-File laden
var templateFile=DriveApp.getFileById(dataObject.template);
//Dann eine Kopie im "gen" Ordner erstellen
var document=templateFile.makeCopy(targetFolder);
//Schauen, ob es sich um eine Präsentation handelt:
if(document.getMimeType()=="application/vnd.google-apps.presentation"){
//Dann das Dokument aus der Präsentation erstellen
var slideApp=SlidesApp.openById(document.getId());
//Alle Slides durchlaufen
slideApp.getSlides().forEach(slide=>{
//Alle Platzhalter ersetzen
for(var key in dataObject){
slide.replaceAllText('{{'+key+'}}',dataObject[key]);
}
});
slideApp.saveAndClose();
}else if(document.getMimeType()=="application/vnd.google-apps.document"){
//Dokument ist ein Textdokument -> Offnen und Platzhalter tauschen
var docApp=DocumentApp.openById(document.getId());
for(var key in dataObject){
docApp.getBody().replaceText('{{'+key+'}}', dataObject[key]);
}
docApp.saveAndClose();
}else{
//unknown type - Hier abbrechen
return;
}
//Create pdf export
var pdfFile=getTargetFolder().createFile(
DriveApp.getFileById(document.getId()).getAs(MimeType.PDF),
).setName(dataObject.filename);
//Originaldokument löschen
document.setTrashed(true);
}
/*
Hauptfunktion, die alle Daten aus dem Spreadsheet ausliest und die Dokumente erzeugt
*/
function createDocuments(){
//Die Dokumente in Objekte umwandeln
var data=spreadSheetToObjects();
var targetFolder=getTargetFolder();
//Durchlaufe alle Objekte und lege die Dokumente an
data.forEach(data=>{
createDocument(data, targetFolder);
});
}
Das ganze in Action
Hier kommt, wie versprochen, noch das Endergebnis als Video:
Hi!
super einfach anzuwenden, danke!
Gibt es eine Möglichkeit einen der Datenpunkte als ein QR Code auf dem GDoc darzustellen?
VG Jan
Witzige Idee! So etwas könnte man entwickeln. Sehe da keine Hürden. Mit dem vorhanden Code aber nicht möglich.
Gute Sache! Leider gibts bei mir diesen Fehler: „Exception: Unexpected error while getting the method or property getFileById on object DriveApp.“ Weisst du woran das liegen könnte?
Wenn du den Script das erste Mal ausführst, sollte eine Berechtigungsanfrage kommen. Der muss auf jeden Fall zugestimmt werden.
Hi Tobias, cooler Code und danke für das Tutorial! Eine Frage: wenn ich statt einem PDF am Ende Word (docx) files haben möchte, was genau muss dann angepasst werden? VG
Hi Tobias, coole Sache und danke für das Tutorial. Wenn ich am Ende anstatt eines PDF ein DOCX und oder Google Docs File raushaben möchte (um es noch nachträglich etwas bearbeiten zu können bevor ich es finalisiere) oder im Zweifel sogar beides PDF und DOCX, wie würde das funktionieren? VG
Hi Yukio,
danke für dein Feedback. Das müsste dann mit
DriveApp.getFileById(document.getId()).getAs(MimeType.MICROSOFT_WORD),funktionieren, habe ich aber noch nicht getestet.Hi Tobias, leider funktioniert das bei mir nicht und ich bekomme einen Error. Sowohl GOOGLE_DOCS (ERROR: Exception: Blob-Objekt muss für diesen Vorgang eine Datenquelle, die nicht null sein darf, aufweisen.) als auch MICROSOFT_WORD (ERROR: Exception: Das Umwandeln von application/vnd.google-apps.document in application/vnd.openxmlformats-officedocument.wordprocessingml.document wird nicht unterstützt.) gehen nicht. Hast du eine Idee, was man sonst noch anpassen müsste? Würde mir super weiterhelfen, danke!
Hallo Yikio,
bist du dir sicher, dass du die richtige Document-Id eingetragen hast. Das die Datenquelle nicht existiert klingt für mich danach.
Nach Word umzuwandeln habe ich noch nie versucht. Wundert mich aber eigentlich das dass nicht geht. Oder ist deine Quelle ein Word-Dokument?
Die Quelle ist ein Google Docs Dokument und wenn ich dein Skript mit PDF belasse, dann funktioniert es auch ganz normal. Insofern sollte es eigentlich nicht an der Quelle liegen, da ändert sich ja nichts. Die einzige Änderung die ich vornehme, ist die Änderung von PDF zu MICROSOFT_WORD bzw. GOOGLE_DOCS. Bei beidem erhalte ich den Error.
Hmm, ok, dass habe ich natprlich nicht getestet.
Hallo Tobias, tolle Funktion! Leider bekomme ich beim Ausführen des Scripts folgende Fehlermeldung: Exception: SpreadsheetApp.getUi() kann aus diesem Kontext nicht aufgerufen werden. (Zeile 5, Datei „Code“). Woran kann das liegen? VG Dirk
Hallo Dirk,
hast du die Berechtigungsanfrage bestätigt? Wurde der Code bei einem Spreadsheet in den Code-Editor eingegeben oder über ein eigenständiges App-Script Projekt? Kannst du die Funktion „onOpen“ vielleicht mal direkt im Code-Editor ausführen und gucken ob die Meldung da auch kommt?
Top Sache, danke fürs teilen. Eine Frage trotzdem. Ist es auch möglich mehrseitige PDF’s zu erstellen?
Danke und viele Grüße
Danke für das Feedback. Mehrseitige PDFs sind absolut kein Problem.
Kannst Du mir einen Tipp geben was ich wo ändern muss, damit ich mehrseitige PDF’s erhalten? Zur Erklärung, ich hätte einen Brief der an x Empfänger gehen und ich hätte gern diese x Briefe in einem PDF.
Achso, es sollen mehrere Dokumente in einem Angelegt werden. Dass ist nur mit einer Script-Erweiterung möglich. Über App Script lassen sich sicherlich mehrere PDFs zu einem Zusammenfassen.
Alles klar.
Dann komme ich aktuell so damit klar. Bei Gelegenheit schaue ich mir das Script mal.
Danke schön.
Hi Tobias, vielen Dank für den hilfreichen Input. Bei mir erscheint die Fehlermeldung: Exception: Invalid argument: id. Ich habe die Doc-ID jetzt schon 3x geprüft. Hast du eine Idee, woran das liegen könnte? Gibt es ein Problem, wenn in einem Dokument nicht alle Platzhalter, die im Sheet angegeben sind, vorhanden sind?
Hat er bei Meldung zufällig noch die Zeilennummer angegeben, an welcher Stelle im Code das Problem entstanden ist? Platzhalter die im Sheet nicht drin sind, sollte er ignorieren.
Wie sieht die Id aus? Gerne können Sie mir auch privat eine Mail schreiben. Dann versuche ich das Problem zu verstehen: mail [at] tobias-sell.com
Vielen Dank für die schnelle Rückmeldung. Ich habe dir eine Mail geschickt.
Hallo Tobias,
danach habe ich gesucht! Danke. Wie können denn alle pdf in dem Ordner dann automatisiert an die einzelnen Empfänger geschickt werden?
Hallo Klaus,
sofern du GMail benutzt, kann der Script um eine Zeile mit der GmailApp-Funktion erweitert werden, die verschickt die Mails und unterstützt auch Anhänge
Hallo, bei mir sagt er „Exception: Das Argument kann nicht null sein: nameDetails“
was kann ich tuen ?
Stell sicher, dass alle Spalten ausgefüllt sind.
Hallo Tobias, vielen Dank für deine tolle Lösung! Ich habe allerdings das Problem, dass nach 34 generierten PDF’s die Fehlermeldung kommt, „Maximale Ausführzeit überschritten“ und dann stoppt. Hast du einen Tipp, wie sich das umgehen/lösen lässt?
Hi Benjamin,
Ja, Mist. Da macht Google dann irgendwann zu. Eine Möglichkeit wäre, dass man nur die markierten Zeilen in PDFs umwandelt und so dann mehrere „Batches“ a 30 pdfs macht.
In
for(var row=1; row würde man dann die ActiveRange nehmen. (Wie) muss ich dazu Zeile 20 abändern?
for(var row=1; row<range.length; row++){ //Durchläuft alle Zeilen bis auf die Überschriften (daher row=1)
Und dann einfach die Spalten in der Tabelle markieren und im Skripteditor auf Create Documents, oder wie ist da der Ablauf?
Nur die Zahl anpassen und es hat funktioniert. Danke nochmals!
Hallo, den Fehler mit der Ausführungszeit kann ich hiernach leider nicht beheben, habe das gleiche Problem. nach ca. 120 von 600 Positionen bricht das Skript ab. Kann ich das Vorgehen einfacher übersetzt bekommen, das zu vermeiden? Bin leider nicht ausreichend bewandert… Dank vorab.
Hallo Klaus,
ich werd die Tage mal schauen, ob ich das in „Batches“ verteilen kann. Kann momentan nichts versprechen.