Einführung
Hinweis: Diese Feature sind Teil der Visforms Subscription und in der freien Visforms Version nicht enthalten.
PDF Dokumente mit Visforms zu erstellen ist ein sehr leistungsfähiges Feature.
Mit dem PDF-Feature können Sie:
- Benutzern die Möglichkeit geben, im Frontend PDF-Dateien der von ihnen übertragenen Daten herunterzuladen.
- In der Administration sehr flexibel und direkt PDF-Dateien erzeugen und herunterladen.
PDF-Dokumentation am besten komplett von Anfang bis Ende durchlesen
Dieser Teil der Dokumentation ist eine Einführung in ein sehr leistungsfähiges aber technisch mehr oder weniger anspruchsvolles Feature. Diese Einführung enthält alle Einblicke und alle notwendigen Informationen darüber, wie die PDF-Dokumente mit Visforms funktionieren.
Wenn Sie Ihre ersten ein oder zwei PDF-Templates erstellt haben, wird Ihnen die Arbeit leicht von der Hand gehen. Den Anwendungsmöglichkeiten sowie den möglichen dynamischen Inhalten Ihrer PDF-Templates, sind kaum Grenzen gesetzt. Einfache PDF-Templates sind leicht zu erstellen.
Hinweis: Wir empfehlen Ihnen diesen Teil der Dokumentation komplett von Anfang bis Ende durchzulesen.
PDF-Dateien werden aus PDF-Templates erzeugt
PDF-Templates werden für ein bestimmtes Formular angelegt. Ein PDF-Template ist ein in HTML formatierter Text.
Das PDF-Template setzt sich aus bis zu drei einzelnen HTML-Texten zusammen:
- Seiten-HTML
- Seitenkopf-HTML
- Seitenfuß-HTML.
Das HTML kann speziell formatierte Platzhalter enthalten, die während der Laufzeit mit aktuellen Daten ersetzt werden.
Zu den möglichen Daten der Parameterersetzung gehören unter anderem:
- die Formulardaten einer Übertragung,
- die Formulardaten aller oder ausgewählter Übertragungen,
- die Formulardaten anderer Formulare,
- beliebige Daten aus der Datenbank,
- Feld-Parameter,
- Formular-Parameter,
- Benutzerinformationen,
- inhaltliche Dokumentinformationen wie laufende Seitenzahl und Druckdatum,
- Kontrollanweisungen wie
- Dokumentformatierungen, etwa ‘Neue Seite danach’,
- Anweisungen für Schleifen und Rekursionen.
Die Ersetzung der Platzhalter im PDF-Template kann auch rekursiv erfolgen. Damit werden Listen als PDF-Dokumente möglich, die etwa für alle Kunden jeweils alle Bestellungen aus dem laufenden Jahr aufzeigen. Für jeden Kunden kann ein Seitenumbruch erfolgen auf eine neue Seite, die mit Kundeninformation beginnt.
Die für Rekursion gekennzeichneten Stellen werden im PDF-Template wie folgt behandelt:
- kopiert,
- enthaltenen Platzhalter ersetzt und
- dem PDF-Dokument fortschreitend angehängt.
Welche Datensätze automatisch verwendet werden, hängt auch von der Einsatzstelle ab.
Es wird unterschieden, ob das fertige PDF-Dokument erzeugt wird
- vom Frontend aus oder
- von der Administration aus.
Nachdem die Platzhalter im PDF-Template Text ersetzt wurden, wird aus dem HTML mit Hilfe der Library TCPDF ein PDF-Dokument erzeugt.
PDF-Templates anlegen, testen und nutzen
Visforms unterstützt Sie mit flexiblen Platzhaltern, leistungsfähigen Tools für das Ersetzen der Platzhalter und einer auf SQL basierten umfangreichen Datensatzauswahl.
Sie verwalten die PDF-Templates in der Visforms Administration mit folgenden Möglichkeiten
- erzeugen,
- testen und
- direkt nutzen.
PDF-Templates können in der Administration über die entsprechenden Buttons in der Button-Leiste direkt genutzt werden. Für diesen Fall stehen Ihnen ebenfalls sehr flexible Tools zur Auswahl der Datensätze zur Verfügung, die für die konkrete Erzeugung des PDF-Dokuments aus dem PDF-Template verwendet werden sollen.
PDF-Templates können aber auch von den Benutzern Ihrer Webseite im Frontend genutzt werden. Benutzer Ihrer Webseite können etwa PDF-Dokumente mit den Daten, die sie in Formularen übermittelt haben, im Frontend herunterladen.
Bearbeitung von PDF-Templates gleicht der Bearbeitung von Feldern
Grundsätzlich funktioniert die Erstellung von PDF-Templates genauso, wie Visforms im Allgemeinen funktioniert. So wie ein Formular gleich mehrere Felder besitzt, kann ein Formular auch mehrere PDF-Templates besitzen. Was Sie von der Bearbeitung der Visforms Felder in Bezug auf ein Formular wissen, gilt grundsätzlich auch für die Visforms PDF-Templates.
PDF-Templates sind an ein Formular gebunden
Hinweis: Einige Einstellungen, wie die auf den Reitern "Allgemein" und "PDF Einstellungen" sind weitgehend selbsterklärend und werden hier nicht weiter besprochen.
Das Konzept ist Ihnen von den Formular-Feldern bereits gut vertraut.
Sie können die Verwaltung von PDF-Templates also nur erreichen, wenn Sie
- in der Konfiguration eines konkreten Formulars sind oder
- in der Formularübersichtsliste sind.