Voraussetzung PDF

Geändert am Mi, 24 Jun um 11:41 VORMITTAGS

Mit der Aktion "PDF-Datei befüllen/PDF-Fill" können bestehende PDF-Formulare mit Werten aus einem formcycle-Formular befüllt werden.

Vorbereitung: Feldnamen ermitteln

Um die Felder im PDF befüllen zu können, müssen die Namen der PDF-Formularfelder bekannt sein. Es gibt zwei Wege:

Das PDF im Originalprogramm öffnen, mit dem es erstellt wurde.
Das PDF im formcycle-Designer über Mehr → Import laden – dort werden die Feldnamen ebenfalls angezeigt.

Vorbereitung PDF

Schriftarten

Alle Zeichen, die in ein PDF-Formularfeld eingetragen werden, müssen in der festgelegten Schriftart vorhanden sein. Die Schriftart muss außerdem entweder im PDF eingebettet oder auf dem formcycle-Server als Systemschrift installiert sein. Als sadmin kann das unter Systemeinstellungen → Systeminformationen → Schriftarten geprüft werden.

Zuordnung zu Formularfeldern

Die PDF-Feldnamen müssen den formcycle-Formularelementen zugeordnet werden. Dafür gibt es zwei Möglichkeiten:

Gleiche Feldnamen: Wenn die Feldnamen im PDF mit denen im Formular übereinstimmen (z.B. tf1), ist keine weitere Konfiguration nötig.

Alias: Wenn die PDF-Feldnamen nicht geändert werden können oder ungültige HTML-Zeichen enthalten (z.B. ein Leerzeichen, Umlaute ...), wird im formcycle-Designer ein Alias am jeweiligen Element vergeben (unter Grundeigenschaften). Der PDF-Drucker verwendet dann automatisch den Alias für das Mapping.

Bei Radiobuttons und Checkboxen gibt es immer einen Wert für „An" und „Aus" – der Wert für „An" ist in der Regel "on".

Dynamische Felder

Auf dynamisch erzeugte Felder wird über feldname_index zugegriffen, wobei der Index bei 0 beginnt. Beispiel: Das dritte Feld mit dem Namen tfMail wird als tfMail_2 referenziert.

Konvertierung von Formularwerten

Auswahllisten: Anzeigetext statt internem Wert

Der Wert eines Auswahllisten-Elements entspricht dem internen HTML-Wert, nicht dem angezeigten Text. Um stattdessen den Anzeigetext zu verwenden, wird -lsttxt an den Feldnamen bzw. Alias angehängt – z.B. sel1-lsttxt statt sel1. Allgemein werden Funktionen mit einem Bindestrich getrennt angehängt (ein Punkt ist laut PDF-Standard 2.0 nicht erlaubt). Siehe Abschnitt Konvertierungsfunktionen

Bilder übernehmen

Um ein Bild (z.B. aus einem Upload-Feld) im PDF anzuzeigen, muss es per Workflow in einen Base64-String konvertiert und anschließend über die Aktion „Formularwerte ändern" an das entsprechende PDF-Element übergeben werden. Dieses muss im PDF als Textfeld angelegt sein.

Beispiel

Siehe Anhang: PDF-Fill-Beispiel.xfp

Konvertierungsfunktionen

Es stehen folgende Funktionen zur Verfügung, mit denen die Werte, mit denen das PDF befüllt wird, zu ändern.

Funktion	Beschreibung	Beispiel	Erläuterung
lsttxt	Ersetzung aller Werte einer Auswahl mit dem Text-Wert. Steht für list text.	SEL1-lsttxt	Liefert den Text-Wert des Auswahlelements mit Namen SEL1 zurück
lsttitle	Ersetzung aller Werte einer Auswahl mit dem Titel-Wert. Steht für list title.	SEL1-lsttitle	Liefert den Titel-Wert (falls hinterlegt) des Auswahlelements mit Namen SEL1 zurück
b64img	Interpretiert den Wert als Base64-kodiertes Bild und fügt das Bild in das Dokument ein.	edSig-b64img	Fügt die im Formular eingegebene Unterschrift in das Dokument in Bildform ein.
[+]	Ermöglicht es, den Wert von 2 Formularfeldern zu verknüpfen. Nimmt den Wert vor und nach dem [+] und sucht nach Formularfeldern mit diesen Namen.	Vorname[+]Nachname	Verknüpft den Wert des Formularfelds mit Namen Vorname mit dem Wert des Formularfelds Nachname.
[br]	Fügt einen Zeilenumbruch \n ein. Muss mit dem Operator [+] genutzt werden.	Wort1[+][br][+]Wort2[+][br][+]Wort3	Fügt die Werte der Formularelemente mit Namen Wort1, Wort2 und Wort3 getrennt mit Zeilenumbruch ein.
[sp]	Fügt eine Leerzeichen ein. Muss mit dem Operator [+] genutzt werden.	Wort1[+][sp][+]Wort2[+][sp][+]Wort3	Fügt die Werte der Formularelemente mit Namen Wort1, Wort2 und Wort3 getrennt mit Leerzeichen ein.
[cb_]	Genutzt für Auswahlelemente, die mehr als eine Option ausgewählt haben können. In einem PDF-Dokument müssen alle Optionsfelder einen unterschiedlichen Namen haben. Um die Zuordnung zu dem Auswahlelement von formcycle zu ermöglichen, müssen die Optionselemente im PDF-Dokument das Namensschema [cb_<index>]. haben. Beispielsweise sollten die Namen zweier Optionselemente für ein Auswahlelement mit Namen sel1sel1[cb_1] und sel1[cb_2] sein.	selEntscheidung[cb_1]	Die erste Option Ja eines Auswahlelementes mit dem Namen selEntscheidung.

Videos

Workshop-Video (Der Workshop bezieht sich auf formcycle Version 6. Die grundsätzlichen Inhalte sind aber auf Version 8 übertragbar)

Anhänge (1)

xfp

PDF-Fill-Beispiel.xfp
44.2 KB