Ausgabe und Download von Dateien und Vorschauen

Diese Config-Variablen sind für Sie schon in der Default-Configuration richtig eingestellt.

Ausgabe im Browser

Die Ausgabe der Asset Versionen wird über EAS_OUTPUT_*-Variablen gesteuert.

easydb kennt innerhalb des Creators verschiedene Output-Klassen (output class) für Assets:

  • DEFAULT
  • PRINT
  • PRINT_MEDIUM
  • PRINT_LOW
  • HQ
  • LQ

Zusätzlich gibt es noch die Sonder-Klassen:

Je nach easydb werden nicht alle dieser Klassen genutzt. Standardmäßig wird die Klasse DEFAULT genutzt für die Sie auch zwingend eine OUTPUT Variable definieren müssen.

Die output class PRINT (und entsprechend auch PRINT_MEDIUM und PRINT_LOW) kann beispielsweise für die Erzeugung von PDF-Steckbriefen Ihrer Assets genutzt werden. Damit ist es möglich in den PDFs größere Previews für bessere Druckqualität zu benutzen als in der normalen Asset-Detailansicht.

EAS_OUTPUT_<output class>_<file class>
EAS_OUTPUT_<output class>

Immer wenn die easydb ein Asset anzeigen möchte, wird in der Config-Variable für die entsprechende Ausgabe geschaut, welche Versionen dafür in Frage kommen. Wenn keine Version konfiguriert ist, erscheint bei der Ausgabe eine Platzhalter-Grafik mit einem Warndreieck.

EAS_OUTPUT_DEFAULT=orig,800,160,100

Im Beispiel definieren wir, dass standardmäßig diese Versionen verwendet werden können. Wenn es das Rechtemanagement zulässt, wird von der easydb die für den jeweiligen Ausgabe-Bedarf ( Thumbnail, Preview ) die bestmögliche Größe ausgewählt.

Für die Sonder-Klassen ZOOMER, FLASHPLAYER und HTML5AUDIO teilen Sie der easydb mit, welche Versionen für diese Fälle Verwendung finden sollen, soweit es das Rechtemanagement zulässt. Für den FLASHPLAYER gibt es noch die Möglichkeit der Kombination mit der Klasse HQ. Damit bietet der Flashplayer dem Benutzer eine Umschaltung zwischen Standard-Quality und High-Quality an.

EAS_VERSIONS_VIDEO=360,160,100,flv,flvhq
EAS_VERSIONS_AUDIO=360,160,100,flvaudio,html5wav,html5mp3

EAS_PRODUCE_flv=target_format=flv&target_size=320x320
EAS_PRODUCE_flvhq=target_format=flv&target_size=720x720
EAS_PRODUCE_flvaudio=target_format=flv&target_size=360x360
EAS_PRODUCE_html5wav=target_format=wav
EAS_PRODUCE_html5mp3=target_format=mp3

EAS_OUTPUT_DEFAULT_FLASHPLAYER=flv,flvaudio
EAS_OUTPUT_HQ_FLASHPLAYER=flvhq

EAS_OUTPUT_DEFAULT_HTML5AUDIO=html5wav,html5mp3

In diesem Beispiel sieht der Benutzer für Flash-Videos zwei Qualitäts-Stufen und einen entsprechenden Umschalter. Für den Standard-Fall werden ein Audio-Flash produziert mit einem Vorschaubild von 360 Pixeln Kantenlänge, sowie ein Flash-Video mit 320 Pixeln Kantenlänge und ein 720p-Video mit 720 Pixeln Kantenlänge.

Audio kann ab Version 4.0.310 alternativ auch mit einem HTML-5-Audioplayer angezeigt werden. Es können verschiedene Versionen konfiguriert werden (html5wav und html5mp3 im Beispiel), je nach Browser wird die erste benutzbare Version verwendet. Sind für Audio-Dateien sowohl Flash-Versionen (EAS_OUTPUT_DEFAULT_FLASHPLAYER) als auch HTML-5-Versionen (EAS_OUTPUT_DEFAULT_HTML5AUDIO) konfiguriert, so wird HTML 5 bevorzugt.

Download

Für den Download der Assets stehen Config-Variablen zur Verfügung, um den Dateinamen des Downloads zu bestimmen.

EAS_DOWNLOAD_FILENAME
EAS_DOWNLOAD_FILENAME.<TABLE>

Der EAS_DOWNLOAD_FILENAME bestimmt allgemein das Format des Dateinamen, für eine bestimmte Tabelle können Sie
.<TABLE> anfügen. Ersetzen Sie <TABLE> durch den Namen der Tabelle. Die speziellere Config-Variable hat dann Vorrang vor der Allgemeinen.

EAS_DOWNLOAD_FILENAME=easydb-%easfile.id%-%easfile.version%%-profile%.%easfile.type.extension%

Der Format-String ersetzt die folgenden Variablen:

%easfile.id% Die EAS-ID des Assets.
%easfile.version% Der Name der Version des Assets.
%easfile.filename% Der Original-Dateiname ohne Pfad des Assets. (ab Version 4.0.159)
%easfile.barename% Der Original-Dateiname ohne Pfad und Endung des Assets.
%easfile.type.extension% Die Endung der Version des Assets, hergeleitet aus dem tatsächlichen Dateityp der Version Assets.
%profile% Beim Herunterladen mit Metadaten-Profil der interne Name des Profils.
%-profile% Beim Herunterladen mit Metadaten-Profil der interne Name des Profils, mit Vorangestellten -.
%profilename% Beim Herunterladen mit Metadaten-Profil der Frontend-Name des Profils.
%-profilename% Beim Herunterladen mit Metadaten-Profil der Frontend-Name des Profils, mit Vorangestellten -.
%record.<column>[.<column2>]% <column> ist der Spaltenname der Tabelle des Objektes, welches auf das EAS-Asset verweist. Wenn Sie beispielsweise den Titel eines Bildes im Dateinamen integrieren möchten und die Spalte in der Datenbank title heisst, benutzen Sie *%record.title%. Seit Version 4.0.130.

1-n Verlinkungen werden aufgelöst und können über die Angabe des Feldes (*column2*) ersetzt werden. Seit Version 4.0.241.

Wird der Download-Dateiname nicht gesetzt, wird als Vorgabe %easfile.id%-%easfile.version%.%easfile.type.extension% verwendet.

Zusätzlich zu diesen Ersetzungen gibt es in cell/EASFILE_FILEDATA/download_link_anchor oder grid/LINK-result/emsfile_download_version noch die Möglichkeit aus dem aktuellen Result-Set Werte in den Dateinamen zu integrieren.

Der vom easydb-Asset-Server gesendete Mime-Type ist von dem Dateinamen unabhängig. Der Mime-Type wird vom Asset-Server abhängig vom tatsächlichen Asset-Typ gesetzt.

EAS_OUTPUT_DOWNLOAD
EAS_OUTPUT_DOWNLOAD_<file class>

Seit Version 4.0.130.

In der easydb gibt es zwei Arten von Direkt-Download-Buttons für Assets:

  • Download des Original-Assets
  • Download des Assets, welches nach der Konfigurations-Variable EAS_OUTPUT_DOWNLOAD[_<file class>]

Welcher Button erscheint, wird im Creator in eingestellt.

Geben Sie hier eine Liste von Versionen an, die für den Download zur Verfügung stehen. easydb verwendet dann die erste Version der Liste für die der Benutzer die Rechte hat. Findet easydb keine Version, so wird der entsprechende Download-Button nicht angezeigt.

EAS_OUTPUT_DOWNLOAD=orig,1600w
EAS_OUTPUT_DOWNLOAD_OFFICE=pdfoffice
EAS_OUTPUT_DOWNLOAD_AUDIO=
EAS_OUTPUT_DOWNLOAD_VIDEO=		
EAS_OUTPUT_DOWNLOAD_OTHER=		

Das vorliegende Beispiel erlaubt für Office-Assets den Download der Version pdfoffice, für Audio, Video und andere Assets keine Download und für alle anderen (in diesem Fall nur Bilder), den Download der Version orig und – wenn die Rechte nicht vorhanden sind – den Download von 1600w.

Bitte beachten Sie, dass für diese Konfiguration die Versionen orig, 1600w und pdfoffice je Asset auch produziert worden sein müssen.

Sie können im Creator festlegen, ob der easydb Zoomer ein Download-Icon als Werkzeug anbietet. Dieser Download wird über die Config EAS_OUTPUT_DOWNLOAD_<file class> gesteuert. Hat der Benutzer nicht genügend Rechte erscheint der Download-Link nicht.

Für mehrseitige Assets bezieht sich die Download-Version im easydb Zoomer momentan auf die aktuell dargestellte Seite. Das wird sich mit der nächsten easydb-Version ändern, so dass auch das mehrseitige Dokument hier heruntergeladen werden kann.

Export

EAS_EXPORT_VERSIONS (ab Version 4.0.229)

Die Werkzeuge "E-Mail" und "Zip-Archiv" bieten eine Liste an Versionen an, normalerweise wird dafür EAS_VERSIONS herangezogen. Diese Liste kann mit EAS_EXPORT_VERSIONS überschrieben werden, dazu werden komma-separiert die aufzulistenden Versionsnamen angegeben:

EAS_EXPORT_VERSIONS=1280x1024,1600x1200,JPEG-Version

Wenn EAS_EXPORT_VERSIONS gesetzt wird, muss seit 4.0.310 auch für die Originalversion und für eigene Versionen ein Eintrag erfolgen, damit die entsprechenden Optionen sichtbar werden. Ist original in EAS_EXPORT_VERSIONS enthalten, werden die Optionen Original und Original (verändert) angeboten, bei __custom__ wird der Punkt eigene Version… erscheinen:

EAS_EXPORT_VERSIONS=1280x1024,1600x1200,JPEG-Version,original,__custom__