flexi-pdf-collection¶
Die PDF-Sammlung ermöglicht es, eine oder mehrere PDF-Dateien an ein Formular anzuhängen. Die hochgeladenen Dateien werden in einer Tabelle aufgelistet, können geöffnet und wieder entfernt werden. Optional lässt sich festlegen, wie viele PDFs mindestens bzw. höchstens zulässig sind, in welcher Ausrichtung sie vorliegen müssen und wie groß die einzelnen Dateien maximal sein dürfen.
Einstellungen¶
| Einstellung | Beschreibung |
|---|---|
| Bezeichnung | Der angezeigte Text über der PDF-Sammlung |
| Name | Eindeutiger Bezeichner des Feldes (wird automatisch aus der Bezeichnung abgeleitet) |
| Pflichtfeld | Wenn aktiv, gilt das Feld nur als gültig, wenn die Anzahl der angehängten PDFs im erlaubten Bereich liegt |
| Mindestanzahl | (Pflichtfeld) Kleinste zulässige Anzahl an PDFs |
| Maximalanzahl | (Pflichtfeld) Größte zulässige Anzahl an PDFs |
| Fehlertext | (Pflichtfeld) Meldung, die angezeigt wird, wenn die Anzahl außerhalb des erlaubten Bereichs liegt |
| Eingabe deaktivieren | Sperrt das Feld vollständig — es können keine PDFs hinzugefügt oder gelöscht werden |
| Abhängig deaktivieren | Sperrt das Feld nur, wenn ein anderes Feld einen bestimmten Zustand hat |
Bedienung¶
In der Kopfzeile der PDF-Sammlung wird angezeigt, wie viele PDFs aktuell angehängt sind. Bei aktivem Pflichtfeld erscheint zusätzlich der erlaubte Bereich (z. B. 2 / 1–5). Die Zählerfarbe zeigt den Status:
- Grau – kein Pflichtfeld, der Zähler dient nur zur Information
- Grün – Anzahl liegt innerhalb des erlaubten Bereichs
- Rot – Mindestanzahl ist noch nicht erreicht
Über die Schaltfläche Datei hinzufügen öffnet sich ein Datei-Dialog, in dem eine oder mehrere PDF-Dateien ausgewählt werden können. Die Schaltfläche ist gesperrt, sobald die Maximalanzahl erreicht ist oder das Feld deaktiviert ist.
Jeder Eintrag in der Tabelle bietet:
- Lupen-Schaltfläche – öffnet das PDF zur Ansicht
- Papierkorb-Schaltfläche – entfernt das PDF aus der Sammlung (nur sichtbar, wenn das Feld nicht deaktiviert ist)
Statusanzeige¶
Zu jedem PDF wird ein Status-Etikett angezeigt, das informiert, wo die Datei verfügbar ist:
| Status | Bedeutung |
|---|---|
| Cloud + Lokal | PDF ist sowohl in der Cloud als auch lokal auf dem Gerät verfügbar |
| Cloud | PDF ist nur in der Cloud verfügbar — beim Öffnen wird sie heruntergeladen |
| Lokal | PDF ist nur lokal auf dem Gerät verfügbar (noch nicht synchronisiert) |
| Nicht gespeichert | PDF wurde gerade ausgewählt und ist noch nicht gespeichert |
Pflichtfeld¶
Ist das Feld als Pflichtfeld markiert, müssen mindestens Mindestanzahl und höchstens Maximalanzahl PDFs angehängt sein. Liegt die Anzahl außerhalb dieses Bereichs, wird der unter Fehlertext hinterlegte Hinweis angezeigt.
Ohne Pflichtfeld-Markierung gibt es keine Untergrenze; die Maximalanzahl wirkt aber weiterhin als Begrenzung der Schaltfläche Datei hinzufügen.
Eingabe deaktivieren¶
Mit Eingabe deaktivieren wird das Feld vollständig gesperrt: Es können keine PDFs hinzugefügt oder gelöscht werden, vorhandene PDFs lassen sich nur noch öffnen.
Ist zusätzlich Abhängig deaktivieren aktiv, wird das Feld nur unter bestimmten Bedingungen gesperrt:
| Einstellung | Beschreibung |
|---|---|
| Abhängiges Feld | Name oder Pfad des Feldes, das geprüft wird. Für ein Feld im selben Abschnitt genügt der Name, für ein Feld in einem anderen Abschnitt: abschnitt.feld |
| Vergleichswert | Optionaler Wert. Ist er gesetzt, wird der Wert des abhängigen Feldes mit ihm verglichen |
| Deaktivieren wenn | Bei gesetztem Vergleichswert: Wert stimmt überein oder Wert stimmt nicht überein. Ohne Vergleichswert: Feld leer oder Feld gesetzt |
Erweiterte Einstellungen¶
Über die erweiterten Einstellungen lassen sich zusätzliche Vorgaben für die hochgeladenen PDFs hinterlegen.
| Einstellung | Beschreibung |
|---|---|
| Ausrichtung | Erlaubt nur PDFs im Hoch- oder Querformat. Ohne Auswahl sind beide Ausrichtungen zulässig |
| Maximale Dateigröße (MB) | Größte zulässige Dateigröße pro PDF in Megabyte |
Ausrichtung¶
Wird Hochformat oder Querformat ausgewählt, werden PDFs in der falschen Ausrichtung beim Hinzufügen abgelehnt und ein entsprechender Hinweis angezeigt.
Maximale Dateigröße¶
Überschreitet eine ausgewählte PDF-Datei die festgelegte Größe in Megabyte, wird sie abgelehnt und ein Hinweis mit dem zulässigen Maximalwert eingeblendet. Ist keine Maximalgröße festgelegt, gilt nur die allgemeine technische Obergrenze für PDF-Seitenformate (max. DIN A4).
Beim Hinzufügen geprüfte Bedingungen¶
Beim Auswählen einer Datei werden vor dem Anhängen folgende Prüfungen durchgeführt. Schlägt eine Prüfung fehl, wird die Datei nicht übernommen und ein Hinweis angezeigt.
- Die Datei muss eine PDF-Datei sein.
- Eine PDF mit demselben Dateinamen darf noch nicht in der Sammlung enthalten sein.
- Die Seitenabmessungen dürfen DIN A4 nicht überschreiten.
- Die Ausrichtung muss zur Vorgabe passen (sofern eingestellt).
- Die Dateigröße darf den Maximalwert nicht überschreiten (sofern eingestellt).
- Beim gleichzeitigen Auswählen mehrerer Dateien darf deren Anzahl die Maximalanzahl nicht überschreiten.
- Passwortgeschützte PDFs können nicht hinzugefügt werden. In diesem Fall hilft es, das Dokument zu öffnen und erneut als PDF auszudrucken.
Offline-Verhalten¶
Das Hinzufügen, Anzeigen und Löschen von PDFs funktioniert auch offline, solange die Datei lokal auf dem Gerät verfügbar ist. Eingaben werden bei der nächsten Synchronisation in die Cloud übertragen.
Sind PDFs ausschließlich in der Cloud gespeichert (Status Cloud), erscheint im Offline-Betrieb ein Warnhinweis. Beim Versuch, eine solche Datei zu öffnen, wird eine Meldung eingeblendet, dass das PDF offline nicht verfügbar ist. Sobald die Verbindung wiederhergestellt ist, kann das PDF normal geöffnet werden.