Seriendruck

Über den Seriendruck bietet n2pdf die Möglichkeit zur Erstellung von Serienbriefen oder PDF-Dateien, deren Inhalt überwiegend identisch ist und sich nur durch einfache Platzhalter (Textersetzungen) unterscheidet. In diesen Fällen müssen Sie die PDF-Datei nicht manuell n-fach erstellen. Sie bauen mit n2pdf eine PDF-Vorlage zusammen und benutzen die Felder von n2pdf, um aus dieser PDF-Vorlage n-Dokumente mit unterschiedlichen Ersetzungen zu machen. Dabei können Sie pro Ersetzung eine eigene PDF-Datei erstellen oder alle Dokumente zu einer gesamten PDF-Datei zusammenfügen.

Die Felder arbeiten nach dem gleichen Prinzip wie die Variablen, können aber n-mal definiert (mit Daten gefüllt) werden und bilden somit pro Füllung einen Datensatz. Jeder Datensatz erstellt dann aus der PDF-Vorlage ein neues Dokument. Die Felder werden wie die Variablen mit einer bestimmten Syntax und einem Namen innerhalb der Notes-RichText-Felder oder der unformatierten Texte positioniert.

Mit dem Befehl N2PDFAddField kann der Inhalt für ein Feld definiert werden. Zurzeit werden dabei nur unformatierte Inhalte unterstützt. Mit jedem Aufruf der Funktion wird ein neues Feld definiert. Um einen neuen Datensatz zu erzeugen wird bei der Funktion der Parameter N2PDFVALUE_MAIL_MERGE_NEW_RECORD mit übergeben. Innerhalb der PDF-Vorlage werden Felder mit dem Zeichen „{" eingeleitet, gefolgt von dem Namen des Feldes und mit dem Zeichen „}" abgeschlossen. Ein so formatierter Name (siehe Begrenzerzeichen bei „Systemeinstellungen ") wird als Feld erkannt und kann dann mit Inhalten, die über N2PDFAddField definiert wurden, gefüllt werden.

Nachfolgend ein Beispiel der Bildung von Datensätzen, Felddefinitionen im Text und dem Ergebnis nach der Ersetzung:

Beispiel für die Definition von Feldern (2 Datensätze mit 2 Feldern):

Call N2PDFAddField (JobID, N2PDFVALUE_MAIL_MERGE_New_RECORD,_

"Salutation", "Mr. " )

Call N2PDFAddField (JobID, 0, "Lastname", "Doe" )

Call N2PDFAddField (JobID, N2PDFVALUE_MAIL_MERGE_New_RECORD,_

"Salutation", "Mrs. " )

Call N2PDFAddField (JobID, 0, "Lastname", "Smith" )

Beispiel für zwei Felder in einem RichText-Feld:

Dear {Salutation} {Lastname},

n2pdf has received a considerable increase in functionality: The table of contents …

Aus beiden oben aufgeführten Beispielen entsteht der folgende Text:

Dear Mr. Doe,

n2pdf has received a considerable increase in functionality: The table of contents …

Dear Mrs. Smith,

n2pdf has received a considerable increase in functionality: The table of contents …

Damit die Seriendruckfunktion (entsprechend dem oben aufgeführten Beispiel) von n2pdf bei dem Aufruf von N2PDFProcess durchgeführt wird, muss sie entsprechend aktiviert werden. Diese Aktivierung erfolgt über die Funktion N2PDFSetOption:

Call N2PDFSetOption ( JobID, N2PDFOPTION_MAIL_MERGE_MODE,_

N2PDFVALUE_True,"" )        

Darüber hinaus kann definiert werden, ob für den Seriendruck eine einzelne PDF-Datei erstellt wird, d. h. der Inhalt pro PDF-Vorlage mit der Einsetzung der Felder in eine Datei geschrieben wird, oder ob pro PDF-Vorlage eine einzelne PDF-Datei erstellt werden soll. Die Option kann über N2PDFSetOption und den Parameter N2PDFOPTION_MAIL_MERGE_SINGLE_FILE eingestellt werden.

Beispiel für eine PDF-Datei:

Call N2PDFSetOption ( JobID, N2PDFOPTION_MAIL_MERGE_Single_FILE,_

N2PDFVALUE_True,"" )

Wenn der gesamte Inhalt des Seriendrucks in eine PDF-Datei erfolgen soll, dann ist es sinnvoll, dass jedes neue Dokument auf einer neuen Seite beginnt. Dieses kann über die Option N2PDFOPTION_MAIL_MERGE_PAGE_BREAK aktiviert werden.

Beispiel:

Call N2PDFSetOption ( JobID, N2PDFOPTION_MAIL_MERGE_PAGE_BREAK,_

N2PDFVALUE_True,"" )

Nachdem alle Optionen und Felder gesetzt wurden, kann mit N2PDFProcess der gesamte Vorgang des Seriendrucks aktiviert werden. Bei dem Aufruf der Funktion wird der Dateiname angegeben unter dem die PDF-Datei erstellt wird. Wurde bei den Optionen gewählt, dass für jeden Datensatz eine eigene PDF-Datei erstellt werden soll, so wird an den Dateinamen der PDF-Datei die Nummer des Datensatzes angehangen.

Beispiel:

Call N2PDFSetOption ( JobID, N2PDFOPTION_MAIL_MERGE_Single_FILE,_

N2PDFVALUE_False,"" )

PDFFileName = "C:\Temp\Default.PDF"

Call N2PDFProcess ( JobID, PDFFileName, 0 )

Erstellte Dateinamen beim Seriendruck in mehrere PDF-Dateien:

"C:\Temp\Default[1].PDF"

"C:\Temp\Default[2].PDF"

"C:\Temp\Default[3].PDF"

…