Diese Config-Variablen sind für Sie schon in der Default-Configuration richtig eingestellt.
Sobald ein Asset hochgeladen wird, übergibt die easydb dieses Asset an den easydb-Asset-Server (EAS). Der EAS kopiert das Asset in den EAS-eigenen Bereich auf dem Server. Im Anschluss überträgt easydb eine Liste mit Herstell-Anweisungen (PRODUCE) für verschiedene Thumbnmails und Previews ( Versionen / VERSIONS ) an den EAS. Der EAS fängt daraufhin an, die Versionen zu produzieren.
In diesem Punkt unterscheidet sich die easydb 4 wesentlich von der easydb 3. Die Berechnung der Versionen erfolgt in der 4 nicht mehr synchron während der Vereinnahmung, sondern asynchron im Hintergrund.
Die produce class ist ein Buchstabe von A-E. Je nach Creator-Output-Konfiguration in der easydb, können verschiedene produce class unterstützt werden. In der Regel gibt es nur A.
Die file class klassifiziert das Asset in die folgenden Gruppen:
Sie können in der Konfiguration je Klasse genau konfigurieren, welche VERSIONS hergestellt werden sollen. OTHER sind alle Dateitypen, die dem EAS bekannt sind und nicht unter eine der anderen Gruppen fallen.
Unbekannt sind alle Dateitypen, die dem EAS gänzlich unbekannt sind. Für diese Gruppe kann der EAS keine Versionen herstellen.
Die extension ist die Datei-Endung des Assets ( alles nach dem letzten Punkt des Datei-Namens ) und dient der Kennzeichnung des Datei-Formats.
Die Config-Variable EAS_VERSIONS sagt easydb, welche Versionen Sie vom EAS herstellen lassen soll. Dabei wird je Asset getrennt nach <produce class>, <file class> und <extension> entschieden, welche Config-Variable benutzt wird. Dabei geht easydb die verfügbaren Config-Variablen in der angegeben Reihenfolge durch.
In der Config-Variable selbst steht dann eine Liste mit den herzustellenden Versionen.
EAS_VERSIONS_IMAGE.tif=1600,1200,800,160,100
EAS_VERSIONS_IMAGE=800,160,100
EAS_VERSIONS=160,100
Im angegeben Beispiel würde für Bilder mit der Endung tif die Versionen 1600,1200,800,160 und 100 hergestellt, für alle anderen Bildern nur die Versionen 800,160 und 100, für alle anderen Assets die Versionen 160 und 100.
Mit der speziellen Notation original:<version>, erzeugt easydb ein neues Original-Asset mit den Regeln der angegeben Version. Dabei wird das ursprüngliche Original überschrieben.
EAS_VERSIONS_IMAGE.tif=orginal:orig,1200,800,160,100
EAS_VERSIONS_IMAGE=1600,1200,800,160,100
Im vorliegenden Beispiel wird für hochgelandene TIFF-Dateien automatisch die Version orig erzeugt, welche im unten angegeben Beispiel ein JPEG erzeugt. Darüber hinaus werden noch die Versionen 1200,800,160 und 100 produziert.
Für alle anderen Bildformate, wird das Original nicht verändert und die Versionen 1600,1200,800,160 und 100 erzeugt.
Die :PAGES Config-Variablen greifen für alle Assets, für die eine seitenweise Versionsberechnung erfolgen kann. Das sind zur Zeit:
EAS_VERSIONS_OFFICE:PAGES=1-,officepage:orig,360,100
In der Config-Variable steht dann zuerst ein String der angibt, welche Seiten hergestellt werden sollen. Dabei kann geschrieben werden:
Wenn Sie 1- angeben, werden alle Seiten berechnet, wenn Sie 1-n angeben, werden maximal n Seiten berechnet.
Nach dem String zur Angabe der herzustellenden Seiten steht die Version, die bestimmt, wie die Seite aus dem Dokument extrahiert wird. In unserem Beispiel officepage.
Die Konfiguration für diese Version sollte so aussehen:
EAS_PRODUCE_officepage=target_format=jpg&target_extract_dpi=600
Nach dem Doppelpunkt folgt eine Komma-separierte Liste mit Versionen, die für jede Seite erzeugt wird.
Für jede Version, die Sie in den EAS_VERSIONS* Variablen komma-separiert angeben, muß es eine entsprechende EAS_PRODUCE_<version>-Variable geben.
Als Wert bekommt diese Variable einen Anweisungs-String für den EAS, was genau hergestellt werden soll. Ein einfaches Beispiel für eine easydb, die nur Bilder verwaltet:
EAS_VERSIONS_IMAGE=orig,800,160,100
EAS_PRODUCE_orig=target_format=jpg&target_zoomer=1
EAS_PRODUCE_800=target_format=jpg&target_size=800x800
EAS_PRODUCE_160=target_format=jpg&target_size=160x160
EAS_PRODUCE_100=target_format=jpg&target_size=100x100
In diesem Beispiel werden für alle Bilder die Versionen orig,800,160 und 100 hergestellt. Für die Versionen 800, 160 und 100 werden JPEG-Thumbnails (target_format) in der jeweiligen Größe (target_size) hergestellt. Für die Version orig gibt es keine Größen-Angaben, d.h. die Größe des Original-Bildes wird beibehalten. Es erfolgt aber eine Aufbereitung für den easydb Zoomer (target_zoomer=1).
Alle verfügbaren Optionen für den EAS finden sie in den Optionen für den /produce-Request.
Um Doppeldeutigkeiten und Verwirrungen vorzubeugen, verwenden Sie nicht den Versions-Namen all. Dieser hat beim Rechtemanagement besondere Bedeutung.
Seit Version 4.0.265.
Es können in den Zuweisungen Variablen verwendet werden, die den aktuellen Datensatz berücksichtigen und Ersetzungen vornehmen. Die Ersetzungen folgen dem Muster %record.<column>[.<column2>]%. <column> ist der Spaltenname der Tabelle des Objektes, welches auf das EAS-Asset verweist. Wenn Sie beispielsweise im Pool eines Bilder ein Wasserzeichen hinterlegt haben, benutzen Sie:
EAS_PRODUCE_100w=target_format=jpg&target_size=100x100&target_wm_image_eas=%record.pool_id.watermark%&overwrite=1
Benutzen Sie "overwrite=1", um Versionen bei geänderten Parametern neu erzeugen zu lassen. Parameter können sich ändern, wenn Variablen benutzt werden.
Der easydb Zoomer benötigt eine eigene Zoom-Version, um zu funktionieren.
Folgende Voraussetzungen müssen erfüllt sein:
Sollte eine der beiden Voraussetzungen nicht erfüllt sein, sucht easydb ein für den Benutzer rechtemäßig verfügbares JPEG und gibt das Bild im einfachen Zoomer aus. Der einfache Zoomer benutzt den Browser, um das Bild zu zoomen.
Filter und Konverter dienen dazu, Dateien zum Zeitpunkt des Speicherns in der easydb kleiner zu rechnen oder in ein anderes Format umzuwandeln und dieses für den Benutzer auswählbar zu machen. Dabei wird die ursprünglich hochgeladene Datei verworfen und nur die konvertierte Version in die easydb kopiert.
Mögliche Anwendungsfälle:
Für die Konfiguration werden FILTER definiert, die den Benutzer zum Zeitpunkt der Vereinnahmung entscheiden lassen, ob eine Konvertierung/Filterung erfolgen soll oder nicht. Jeder Filter kann optional an ein System-Recht gebunden sein, so dass er nur für bestimmte Benutzer zur Verfügung gestellt wird.
Aus technischen Gründen wird zuerst immer die Original-Datei zur easydb geladen. Beim Speichern im Editor entscheidet die easydb dann anhand der Filter, ob eine Datei abgelehnt oder konvertiert wird.
Wenn Filter definiert sind, bekommt der Benutzer vor dem Speichern ein Pulldown angezeigt. In dem Pulldown wird dann der Filter ausgewählt.
Wenn – bei definierten Filtern – ein Benutzer nicht genügend Rechte hat, um mindestens einen Filter zu benutzen, kann er die Datei/Asset nicht speichern und bekommt eine entsprechende Fehlermeldung.
Es werden die folgenden Platzhalter ersetzt:
| Platzhalter | Beschreibung |
|---|---|
| produce class | Die Produce-Class, für die dieser Filter benutzt wird. Normalerweise haben alle Uploader in der easydb die Produce-Class A. Im Creator lassen sich Produce-Classen von A-*F* vergeben. |
| n | Die Nummer der Filters, verwenden Sie aufsteigend 1 – 10. Filter werden bis zur ersten fehlenden Nummer aus der Config gelesen. |
| new produce class | Die neue Produce-Class die benutzt wird, wenn der Benutzer diesen Filter auswählt. Sie können eine der bestehenden Produce-Class A-*F* verwenden oder eigene definieren. Wenn Sie new produce class nicht angeben, wird die im Creator festgelegte Produce-Class beibehalten und kein Filter angewendet. |
| require system right | Komma-separierte Liste der Namen der System-Rechte, von denen der Benutzer mindestens eins benötigt, um diesen Filtern angezeigt und benutzen zu können. Sie können hier eigene System-Rechte erfinden, diese werden dann für den Administrator im Bereich Einstellungen > System-Rechte angezeigt. |
EAS_VERSIONS_A_FILTER_1=:ADMIN:ohne Einschränkung EAS_VERSIONS_A_FILTER_2=KL:ADMIN,EDITOR:BilderEAS_VERSIONS_KL=reject EAS_VERSIONS_KL_IMAGE=original:800,360,160,100
Das vorliegende Beispiel definiert zwei Filter: ohne Einschränkung und Bilder. ohne Einschränkung wird für Benutzer angezeigt, die über das System-Recht ADMIN verfügen, Bilder zusätzlich für Benutzer mit dem System-Recht EDITOR.
Für den ersten Filter wird die Produce-Class A beibehalten (leer), für den zweiten Filter in KL umgeschrieben. In der Produce-Class KL wird definiert, dass nur Bilder angenommen werden (alle anderren Dateien werden abgelehnt durch das Keyword reject). Die Originale werden in der Version 800 aufbewahrt und zusätzlich werden Versionen 360,160 und 100 produziert.