Neben dem grundsätzlichen Prinzip von n2pdf, die PDF-Datei aus einzelnen Notes-Dokumenten, RichText Feldern oder unformatierten Texten und somit aus variablen Inhalten, zusammenzubauen, besteht aber auch die Möglichkeit, in diesen Elementen (Haupttext, Kopf- und Fußzeile) Platzhalter zu definieren. Diese Platzhalter, bei n2pdf Variablen genannt, weisen eine bestimmte Formatierung auf und können mit anderen RichText- oder Textinhalten gefüllt (ersetzt) werden. Durch den Aufruf von N2PDFProcess oder N2PDFSearchAndReplace werden die definierten Variablen dann in dem PDF-Dokument eingesetzt.
Zur Verwendung von Variablen sind drei Schritte notwendig:
•Definition der Variablen im PDF durch eine Format-Syntax
•Füllen der Variablen mit RichText oder Textinhalten
•Einsetzen der Variablen in die PDF-Datei
Definition der Platzhalter
Der Aufbau einer Variablen besteht aus einem beliebigen Namen und der Einklammerung (siehe Begrenzerzeichen bei „Systemeinstellungen ") mit den Zeichen „[„ und „]". Ein so formatierter Text wird von n2pdf als Variable erkannt und kann durch andere RichText- oder Textinhalte ersetzt werden. Sie haben dabei die Möglichkeit, eine solche Variable z. B. direkt in ein Notes-RichText-Feld zu schreiben und dieses dann mit N2PDFAddRTContent an das PDF zu übergeben, oder Sie können auch in einem unformatierten Text eine solche Variable definieren und diese dann mit N2PDFAddContent an das PDF übergeben.
|
Sie können bei den Variablen keine Namen verwenden, die als Name für eine Konstante definiert sind. |
Beispiel für eine Variable in einem RichText-Feld
Dear [Salutation],
n2pdf has received a considerable increase in functionality: The table of contents …
Beispiel für eine Variable in unformatiertem Text (direkter Zusammenbau in Lotus Script):
Dim Salutation As String
Salutation = "Dear [Salutation]," + Chr$(13)+_
"n2pdf has received a considerable increase ..."
Call N2PDFAddContent ( JobID, N2PDFVALUE_CONTENT_BODY, 0, Salutation )
Füllen der Variable
Um eine definierte Variable mit einem entsprechenden Wert zu füllen kennt n2pdf zwei Befehle: Entweder N2PDFAddVariable zur Definition des Inhalts als unformartierter Text oder N2PDFAddRTVariable, um die Variable mit einem Notes RichText Feld zu füllen. Bei dem Aufruf dieser Funktionen wird der Name der Variablen (ohne die Klammern) und der Inhalt angegeben. Bei N2PDFAddVariable übergeben Sie direkt den Inhalt für die Variable, während Sie bei N2PDFAddRTVariable ein Notes-Dokument referenzieren, das n2pdf dann exportiert und als Variableninhalt benutzt.
Erweiterung des oben aufgeführten Beispiels:
Salutation = "Dear [Salutation]," + Chr$(13)+_
"n2pdf has received a considerable increase ..."
Call N2PDFAddContent ( JobID, N2PDFVALUE_CONTENT_BODY, 0, Salutation )
Call N2PDFAddVariable ( JobID, 0, "Salutation", "Mr. John Doe" )
… oder …
Call N2PDFAddRTVariable ( JobID, 0, "Salutation", db.Server,_
db.FilePath, docVar.UniversalID, "NotesDocField" )
Einsetzen der Variable
Abschließend müssen dann noch alle Variableninhalte in die Platzhalter im Text eingesetzt werden. Dieses wird von n2pdf automatisch bei dem Aufruf der Funktion N2PDFProcess (oder durch gezielten Aufruf von N2PDFSearchAndReplace) durchgeführt.