Diese Funktion ermöglicht es, bei Anhängen für Tickets und Wissensdatenbank-Artikel eine Bildvorschau einer PDF-Datei anzuzeigen. Dies ist hilfreich, um den Inhalt eines PDFs anzuzeigen, ohne die Datei herunterzuladen.
Zusätzlich bietet das Paket die Möglichkeit für eine Bildvorschau in dynamischen Feldern vom Typ „Anhang“ (für PDF-Dateien).
Bemerkung
Um diese Funktion zu nutzen, sollte ImageMagick auf dem Server installiert sein, auf dem STORM läuft.
Einrichtung
-
Laden Sie ImageMagick herunter und installieren Sie es. In den neuesten Versionen von ImageMagick ist die Verwendung von PDF-Dateien eingeschränkt. Um die Verwendung von PDF zu ermöglichen, müssen Sie die ImageMagick-Konfiguration manuell aktualisieren.
-
Suchen Sie nach der Datei
/usr/local/etc/ImageMagick-7/policy.xml
(der Dateipfad kann je nach ImageMagick-Version variieren). -
Prüfen Sie, ob die Datei einen
PDF
-Eintrag enthält und ob dieser Eintrag nicht als Kommentar markiert ist. -
Prüfen Sie, ob der Eintrag mindestens ein
read
-Recht enthält.<policy domain="coder" rights="read" pattern="PDF" />
-
Gehen Sie zur Systemkonfiguration und suchen Sie die Einstellung
Magick::Bin
. -
Aktivieren Sie die Einstellung und geben Sie den Dateipfad zum ImageMagick-Binary an.
-
Öffnen Sie die Datei
$OTRS_HOME/Kernel/Config.pm
und fügen Sie die Programme in die Liste der erlaubten Programme ein.$Self->{'SystemConfiguration::ValueType::SystemCommand::BinaryWhiteList'}->{'001-OTRSSTORM'} = [ 'magick', 'pkcs15-tool', ];
-
Bauen Sie die Systemkonfiguration neu auf.
Verwendung
Nach der Installation des Pakets zeigt das Widget Anhänge nun in der Spalte Vorschau zusätzlich zu den regulären Symbolen für Bilder, Audio- und Videodateien ein Symbol für die PDF-Dateien an.
So zeigen Sie eine Bildvorschau des PDFs an:
-
Öffnen Sie die Ticket-Detailansicht oder die Detailansicht des Wissensdatenbank-Artikels.
-
Klicken Sie auf das Vorschausymbol für eine PDF-Datei im Widget Anhänge.
Das PDF wird nun als Bild in einem kleinen Vorschaufenster angezeigt. Für den Fall, dass es sich bei der Datei nicht wirklich um ein PDF handelt, wird im Vorschaufenster nichts angezeigt. In diesem Fall ist es empfehlenswert, das PDF nicht herunterzuladen.
Bemerkung
Das angezeigte Bild des PDFs enthält nur die erste Seite des PDFs.
Dynamische Felder vom Typ „Anhang“
Wenn das Feature Dynamic Field Attachment installiert ist und ein dynamisches Feld zu einer Eigenschaftskarte hinzugefügt wurde, enthält das dynamische Feld ein zusätzliches Vorschau-Symbol neben dem Download-Symbol.
Die PDF-Bildvorschau kann mit diesem Feature überall dort verwendet werden, wo ein dynamisches Feld vom Typ „Anhang“ zum System hinzugefügt wird.