Dateien vom Typ Bild (image
) oder Ressource (generic
) dienen dazu, Bilder beziehungsweise beliebige Binärdaten zu speichern. Die binären Daten werden als Blob (engl. "binary large object") in den Versionen der betreffenden Dateien abgelegt.
Die Thumbnail-Funktion bietet die Möglichkeit, aus diesen Versionsdaten kleine Vorschaubilder (Thumbnails) zu erzeugen. Auf diese Thumbnails greift die HTML-Benutzerschnittstelle des Content Managers über das Versionsfeld thumbnail
zu, um die Benutzer bei der Dateiauswahl zu unterstützen.
Immer dann, wenn einer Version einer Bilddatei oder einer Ressource Daten zugewiesen wurden, ruft der Content Manager die Tcl-Funktion generateThumbnail
auf. Diese Funktion hat die Aufgabe, aus den ihr übergebenen binären Daten ein Miniaturbild zu berechnen. Der Content Manager wird mit einer Thumbnail-Funktion ausgeliefert, die diese Aufgabe mit Hilfe der in den Content Manager eingebauten Funktionen generateThumbnailForGif
, generateThumbnailForJpeg
und generateThumbnailForPng
erfüllt. Das Vorschaubild speichert der Content Manager im Versionsfeld thumbnail
.
Die Funktion generateThumbnail
ist im Skript generateThumbnail.tcl
enthalten. Dieses Skript befindet sich im serverCmds
-Verzeichnis unterhalb des config
-Verzeichnisses des Content Managers. Die Funktion kann für Versionen mit der Dateiendung jpg
, jpeg
, gif
und png
(Groß-/Kleinschreibung spielt keine Rolle) Miniaturbilder erzeugen. Sie kann bei Bedarf so erweitert werden, dass sie auch aus Daten anderen Typs Miniaturbilder generieren kann.
Der Funktion generateThumbnail
werden die folgenden Argumente in der angegebenen Reihenfolge übergeben:
contentId
: die ID der betreffenden Version.objId
: die ID der Datei, zu der die Version mit
der ID contentId
gehört.blobFile
: der Name der Datei, die das
Quelldokument enthält, aus dem der Thumbnail berechnet werden
soll.contentType
: die Dateinamenserweiterung der
Version.thumbnailSize
: die Seitenlänge des Thumbnails in
Pixeln (gleicher Wert für Breite und Höhe). Sie kann mit dem
Systemkonfigurationseintrag thumbnailSize
konfiguriert
werden.Die Funktion liefert als Ergebnis den base-64-kodierten Thumbnail. Diesen speichert der Content Manager als Wert des Feldes thumbnail
in der betreffenden Version.