PDF-Formular-Befüllung für Berichte

BISO unterstützt die automatische Befüllung von PDF-Formularen für Berichte. Dies ermöglicht die Verwendung von bestehenden PDF-Vorlagen (z.B. offizielle Formulare) mit ausfüllbaren Formularfeldern.

Was ist das?

Anstatt PDFs mit XML/XSL zu generieren, können Sie fertige PDF-Formulare hochladen und BISO befüllt diese automatisch mit den Daten aus dem Beratungsfall.

Verwendete Bibliotheken

BISO nutzt folgende Open-Source-Bibliotheken für die PDF-Formular-Befüllung:

• PDFtk (Java-Port): https://gitlab.com/pdftk-java/pdftk PDF Toolkit zum Lesen und Befüllen von PDF-Formularen

• php-pdftk: https://github.com/mikehaertl/php-pdftk PHP-Wrapper für PDFtk zur einfachen Integration

Voraussetzungen

Die PDF-Vorlage muss ausfüllbare Formularfelder enthalten (wie z.B. Formulare, die man in Adobe Reader ausfüllen kann).

Anleitung: Schritt für Schritt

1. Bericht-Vorlage erstellen

Gehen Sie zu: Administration → Wertelisten → Beratungsfall Bericht Vorlagen

Erstellen Sie eine neue Vorlage oder öffnen Sie eine bestehende.

2. PDF-Formular aktivieren

Im Tab "Allgemein":

• Aktivieren Sie die Checkbox "PDF-Formular verwenden"
• Die Felder "Smarty Template" und "XSL Template" werden automatisch deaktiviert (nicht mehr benötigt)

3. PDF-Vorlage hochladen

Wechseln Sie zum Tab "PDF-Formular":

1. Klicken Sie auf "PDF hochladen"
2. Wählen Sie Ihre PDF-Vorlage aus
3. Nach erfolgreichem Upload wird der Dateiname angezeigt

4. PDF-Felder analysieren

Um herauszufinden, welche Felder Ihre PDF-Vorlage hat:

1. Klicken Sie auf "PDF-Felder analysieren"
2. Es erscheint ein Fenster mit allen Formularfeldern (Name und Typ)
3. Klicken Sie auf "In Feld-Mapping übernehmen" um automatisch ein Grundgerüst zu erstellen

5. Feld-Mapping definieren

Im Textfeld "Feld-Mapping (JSON)" müssen Sie definieren, welche Daten in welche PDF-Felder gefüllt werden sollen.

Format:

{
    "pdf_feldname": "BISO-Daten",
    "weiteres_feld": "weitere Daten"
}

Beispiel:

{
    "kunde_name": "{$Kunde->name}",
    "kunde_vorname": "{$Kunde->vorname}",
    "geburtsdatum": "{$Kunde->geburtsdatum|date_format_utf8:'%d.%m.%Y'}",
    "strasse": "{$Kunde->strasse}",
    "plz": "{$Kunde->plz}",
    "ort": "{$Kunde->ort}",
    "berater_name": "{$berater->name}",
    "datum_heute": "{$smarty.now|date_format_utf8:'%d.%m.%Y'}",
    "beschaeftungsgrad": "{$Bericht->bericht_obj->beschaeftigungsgrad|default:\"---\"}"
}

Abbildung: Der PDF-Formular Tab zeigt die hochgeladene PDF-Vorlage und das Feld-Mapping in JSON-Format

6. Speichern

Speichern Sie die Bericht-Vorlage mit dem konfigurierten Feld-Mapping.

7. Verwendung

Im Beratungsfall:

1. Tab "Berichte" öffnen
2. Ihre PDF-Formular-Vorlage auswählen
3. "Dokument erstellen" klicken
4. BISO erstellt automatisch das ausgefüllte PDF

Tipps

PDF-Feldnamen herausfinden

Methode 1 (empfohlen): Verwenden Sie die Funktion "PDF-Felder analysieren" in BISO

Methode 2: Öffnen Sie das PDF in Adobe Acrobat → Formular → Felder bearbeiten

Methode 3: Online-Tool verwenden: PDF Fillable Field Reader

JSON-Syntax beachten

• Verwenden Sie doppelte Anführungszeichen für Feldnamen und Werte
• Trennen Sie Einträge mit Komma
• Der letzte Eintrag hat kein Komma am Ende
• Geschweifte Klammern { } am Anfang und Ende

Richtig:

{
    "feld1": "wert1",
    "feld2": "wert2"
}

Falsch:

{
    'feld1': 'wert1',    <- Falsche Anführungszeichen
    "feld2": "wert2",    <- Komma beim letzten Eintrag
}

Leere Felder

Felder, die nicht im Mapping enthalten sind, bleiben leer. So können Formulare teilweise ausgefüllt und vom Benutzer ergänzt werden.