PDF-Vorschau im Kundenportal statt Download
Kurz gesagt: In vielen Kundenportalen und internen Web-Apps liegen Dokumente als PDF: Angebote, Rechnungen, Lieferscheine, Prüfberichte, Pläne. Wer nur kurz nachsehen will, was in einem Angebot stand, muss die Datei oft herunterladen, im Download-Ordner suchen und in einer anderen App öffnen. Auf dem Handy endet das nicht selten in einem Ordner voller „angebot (3).pdf“. Eine Vorschau direkt im Portal spart diesen Umweg. Je nach Bedarf reicht die eingebaute PDF-Anzeige des Browsers, oder Sie setzen eine Bibliothek wie PDF.js ein. Wichtig sind dabei der richtige Server-Header, ein Rückfall für Geräte ohne Vorschau und der Schutz der Dokumente vor fremden Blicken.
Wann eine Vorschau sinnvoll ist
Nicht jedes PDF braucht eine Vorschau. Lohnend ist sie vor allem dann, wenn Menschen ein Dokument nur ansehen und nicht ablegen wollen:
- Angebote, die vor einer Freigabe kurz geprüft werden
- Lieferscheine und Auftragsbestätigungen im Kundenportal
- technische Datenblätter oder Pläne, die Monteure vor Ort auf dem Tablet ansehen
- Prüfberichte und Protokolle in internen Tools
- Rechnungen, die jemand nur auf den Betrag hin kontrolliert
Wer ein Dokument archivieren oder weiterleiten will, braucht trotzdem einen Download. Die Vorschau ersetzt ihn nicht, sie ergänzt ihn.
Variante 1: Die eingebaute Anzeige des Browsers
Moderne Desktop-Browser bringen eine eigene PDF-Anzeige mit. Damit ein PDF darin angezeigt statt heruntergeladen wird, spielt der Server-Header eine Rolle. MDN beschreibt, dass der Header Content-Disposition angibt, ob ein Inhalt im Browser angezeigt werden soll, als Wert inline, oder als Anhang heruntergeladen, als Wert attachment. Für die Vorschau setzen Sie also inline, für den Download-Knopf attachment, idealerweise mit einem sprechenden Dateinamen.
Sie können das PDF dann in einem neuen Tab öffnen oder in einem Rahmen innerhalb der Seite anzeigen. Der neue Tab ist am robustesten, weil er die volle Bildschirmfläche nutzt. Ein eingebetteter Rahmen wirkt eleganter, ist aber auf kleinen Bildschirmen oft zu eng.
Der Nachteil dieser Variante: Das Verhalten hängt vom Gerät ab. Auf manchen Smartphones und in manchen Apps, die Links in einem eigenen Browserfenster öffnen, wird ein eingebettetes PDF nicht angezeigt oder nur die erste Seite. Testen Sie daher die Geräte, die Ihre Kundschaft tatsächlich nutzt.
Variante 2: Eine eigene Anzeige mit PDF.js
Wenn Sie mehr Kontrolle brauchen, etwa eine einheitliche Anzeige auf allen Geräten, Seitenvorschauen am Rand oder eine Suche im Dokument, bietet sich eine eigene Anzeige an. Die bekannteste Bibliothek dafür ist PDF.js, die das Mozilla-Projekt als universelle, auf Webstandards basierende Plattform zum Auslesen und Darstellen von PDFs beschreibt. Sie zeichnet das Dokument direkt im Browser, unabhängig von der eingebauten Anzeige.
Das bringt Vorteile, aber auch Aufwand: Die Bibliothek muss geladen werden, große Dokumente brauchen Zeit, und die Bedienelemente müssen Sie selbst gestalten. Für ein Kundenportal mit wenigen, kleinen Dokumenten ist das oft zu viel. Für eine App, in der Monteure täglich Pläne ansehen, kann es sich lohnen.
Variante 3: Vorschaubilder statt Vorschau
Manchmal genügt ein Bild der ersten Seite. Ein kleines Vorschaubild in der Dokumentenliste zeigt sofort, um welches Dokument es sich handelt, ohne dass etwas geöffnet werden muss. Solche Bilder lassen sich beim Hochladen oder Erzeugen des PDFs auf dem Server berechnen. In Kombination mit einem Knopf „Ansehen“, der das PDF im neuen Tab öffnet, ist das eine einfache und sehr robuste Lösung.
Die richtige Variante wählen
Für die Entscheidung helfen drei Fragen. Wie viele Dokumente sieht eine Person typischerweise an, eines pro Monat oder zwanzig am Tag? Auf welchen Geräten geschieht das, am Schreibtisch oder auf dem Tablet auf der Baustelle? Und brauchen die Nutzer Funktionen wie Suche im Dokument oder Zoomen in Plänen? Bei wenigen Dokumenten am Desktop reicht der neue Tab mit eingebauter Anzeige. Bei häufigem Gebrauch auf Tablets lohnt eine eigene Anzeige. Und wenn es vor allem darum geht, das richtige Dokument zu finden, sind Vorschaubilder in der Liste der größte Gewinn für den kleinsten Aufwand.
Dokumente schützen
Kundenportale enthalten oft vertrauliche Unterlagen. Eine Vorschau darf diese nicht öffentlich machen:
- Liefern Sie PDFs nur nach einer Anmeldeprüfung aus, nicht über eine frei zugängliche Adresse.
- Verwenden Sie für Dokumente keine erratbaren Dateinamen oder fortlaufenden Nummern in der Adresse.
- Wenn Sie zeitlich begrenzte Links einsetzen, wählen Sie eine kurze Gültigkeit.
- Prüfen Sie, dass zwischengespeicherte Kopien nicht bei anderen Personen landen, etwa durch passende Caching-Header.
Bedenken Sie auch: Was im Browser angezeigt wird, kann gespeichert werden. Eine Vorschau ist kein Kopierschutz.
Barrierefreiheit und Lesbarkeit
PDFs sind für Screenreader nur gut lesbar, wenn sie mit Struktur erzeugt wurden, also mit Überschriften, Lesereihenfolge und Alternativtexten. Eine Vorschau ändert daran nichts. Wenn Ihre Web-App PDFs selbst erzeugt, lohnt es sich, die wichtigsten Angaben zusätzlich als normalen Text im Portal anzuzeigen, etwa Betrag, Datum und Status einer Rechnung. Dann muss niemand das PDF öffnen, nur um eine Zahl nachzusehen.
Schnelle Ladezeiten
Große PDFs mit vielen Bildern laden auf dem Handy lange. Achten Sie beim Erzeugen auf komprimierte Bilder und vermeiden Sie unnötig hohe Auflösungen. Für mehrseitige Pläne kann es sinnvoll sein, das Dokument so zu speichern, dass der Browser die erste Seite schon anzeigt, bevor der Rest geladen ist.
Beispiel aus der Praxis
Ein Elektrotechnikbetrieb in Klagenfurt stellt seinen Gewerbekunden Prüfprotokolle im Kundenportal bereit (Beispiel zur Veranschaulichung). Bisher löste jeder Klick einen Download aus, und Hausverwaltungen beschwerten sich über unübersichtliche Download-Ordner. Der Betrieb zeigt nun in der Liste ein Vorschaubild der ersten Seite, öffnet das PDF per Klick im neuen Tab mit Content-Disposition inline und bietet daneben einen eigenen Download-Knopf mit sprechendem Dateinamen. Datum, Anlage und Ergebnis stehen zusätzlich als Text in der Liste.
Typische Fehler
- Nur Download, keine Möglichkeit zum schnellen Ansehen.
- Eingebettete Vorschau, die auf dem Handy nicht funktioniert.
- PDFs über frei zugängliche Adressen ausliefern.
- Wichtige Angaben nur im PDF, nicht als Text.
- Riesige PDFs mit unkomprimierten Bildern.
Häufige Fragen
Brauche ich für die Vorschau eine zusätzliche Software?
Für einfache Fälle nicht. Die eingebaute Anzeige der Browser reicht oft. Eine Bibliothek lohnt sich erst bei besonderen Anforderungen.
Kann ich das Herunterladen verhindern?
Nicht wirklich. Was angezeigt wird, kann gespeichert werden. Schützen Sie den Zugang, nicht die Anzeige.
Was ist mit Word- oder Bilddateien?
Bilder lassen sich direkt anzeigen. Für andere Formate ist es meist einfacher, beim Hochladen zusätzlich ein PDF zu erzeugen.
Wie teste ich das?
Auf Desktop, Tablet und Smartphone, jeweils in den Browsern Ihrer Kundschaft und einmal aus einer Mail-App heraus.
Wenn Ihr Kundenportal Dokumente besser zeigen soll, ohne dass jemand sie erst herunterladen muss, planen wir das gern mit Ihnen: Dokumentenvorschau besprechen.