Seit Version 4.0.287
Asset-Deep-Links sind HTML-Snippets die Sie per E-Mail verschicken oder in eine Webseite einbinden können (z.B. über ein CMS), um Inhalte aus der easydb extern zugänglich zu machen. Ein Asset-Deep-Link verweist immer auf eine Version oder das Original eines Assets. Es kann nur für das mit einem Datensatz verlinkte Asset ein Asset-Deep-Link erzeugt werden.
Die Asset-Deep-Links dienen zum Anzeigen von Assets, es werden keine Metadaten in die Assets geschrieben und es steht für den Nutzer der Webseite auch keine weitere Funktionalität (wie z.B. Download) zur Verfügung.
Für eigenes Design der HTML-Snippets werden einige Element-Klassen an die ausgebenen Elemente gesetzt. Beachten Sie, dass Sie Elemente, die innerhalb des IFRAME-Element ausgegeben werden nicht designen können.
Um Asset-Deep-Links erzeugen zu können benötigen Sie das System-Recht EAS ASSETDEEPLINKTOOL (ehemals EAS SNIPPETTOOL). Sie können die HTML-Snippets für alle Originale und Versionen erzeugen, für die Sie auch das Download-Recht haben. Asset-Deep-Links funktionieren nur für Originale und Versionen für die der Asset-Deep-Link aktiviert ist. Durch Entfernen des Aktiv-Häckchens werden alle für das Asset erzeugten Asset-Deep-Links ungültig.
Um die Links abzusichern wird eine Checksumme auf Basis eines Shared-Secret erzeugt, welches automatisch in der Datenbank-Tabelle eadb_base_attrs abgelegt wird. Falls im Nachhinein alle Snippets ungültig gemacht werden sollen, kann das Shared-Secret manuell mit SQL aus der Datenbank gelöscht werden.
Asset-Deep-Links können im Downloadmanager oder auf Wunsch direkt über die Detailansicht eines Datensatzes erzeugt werden 1.
Asset-Deep-Links stehen bei durch den Nutzer erzeugten Versionen nur zur Verfügung sofern es sich hierbei um ein Bild-Asset handelt.
Grundsätzlich gibt es folgende Arten um Assets in fremde Webseiten einzubinden:
Das IMG-Element steht nur für Versionen und Originale der Fileclass image zur Verfügung, aber nur für Bilder der Formate JPEG, PNG, BMP und GIF (andere Formate können von den Web-Browser nicht angezeigt werden). Für alle anderen Bild-Formate und die Fileclassen video, office, audio, andere und für Zoom-Ansichten wird grundsätzlich das IFRAME-Element benutzt. Für das IFRAME-Element ist die Angabe einer Breite und Höhe des Ausgabebereichs in Pixeln zwingend notwendig. Im IFRAME-Modus werden Bilder maximal in ihrer tatsächlichen (Original)-Größe angezeigt.
Für office-Dateien wird bei Verwendung des Originals automatisch ein Pager zum Blättern in den Seiten angezeigt.
| Feld | Beschreibung |
| Für Version | Die Version für die das HTML-Snippet erzeugt wird. Je Version stehen verschiedene weitere Felder zur Verfügung. |
| Aktiv | Voraussetzung für das Erzeugen eines HTML-Snippet. Ein HTML-Snippet kann damit auch im Nachhinein wieder deaktiviert werden und wird dann für die Verwendung gesperrt. Die Sperre bezieht sich auf alle erzeugten HTML-Snippets für dieses Original oder diese Version. |
| Breite | Die Breite der Ausgabe in Pixeln. Für direkte Links kann die Angabe entfallen. Es wird dann die aktuelle Breite der Version verwendet. Sollten Sie eine Höhe angegeben haben, aber keine Breite, so wird die Breite proportional angepasst. Für IFRAME-Snippets müssen zwingend Breite und Höhe angegeben werden. Mindestens 10, maximal 3000 Pixel. |
| Höhe | Die Höhe der Ausgabe in Pixeln. Für direkte Links kann die Angabe entfallen. Es wird dann die aktuelle Höhe der Version verwendet. Sollten Sie eine Breite angegeben haben, aber keine Höhe, so wird die Höhe proportional angepasst. Für IFRAME-Snippets müssen zwingend Breite und Höhe angegeben werden. Mindestens 10, maximal 3000 Pixel. |
| IFRAME benutzen | Für Originale vom Typ image kann ein IFRAME-Element aktiviert werden. Damit bleibt die Ausgabe flexibel, sollte aus dem Typ image durch Update des easydb-Datensatzes ein anderer Typ wie z.B. office oder video werden. |
| Zoomer | Für zoomfähige Versionen kann der Zoomer aktiviert werden. Der Zoomer wird immer in einem IFRAME ausgegeben und erlaubt ein stufenloses Zoomen innerhalb des Bildes. |
| Bild zentrieren | Verfügbar nur für Versionen vom Typ image. Bei der Zentrierung wird eine Breite & Höhe vorausgesetzt. In dem verfügbaren Platz wird das Bild optimal in der Mitte zentriert. Dafür wird ein extra DIV-Element um das IMG-Element geschrieben, um das Bild in der Mitte zu zentrieren. Als Eingabehilfe wird die aktuelle maximale Breite oder Höhe der Version automatisch übernommen, sollte weder Höhe noch Breite angegeben sein. |
Pro Asset und Version können mehrere Asset-Deep-Links erzeugt werden. Das Formular zum Erzeugen der Asset-Deep-Links behält allerdings nur die Einstellungen des zuletzt erzeugten Asset-Deep-Links bei. Durch Entfernen des Aktiv-Häckchens werden alle für das Asset erzeugten Asset-Deep-Links ungültig.
Benutzen Sie "Vorschau…" um das erzeugte HTML-Snippet auszuprobieren. Die Config-Variable SNIPPET_TRY_LINK_HTTP_HOST erlaubt das Setzen einer anderen Domain (für ein realistischeren Test in Bezug auf Cross-Domain-Effekte). Wenn die Variable nicht gesetzt ist, wird das Vorschau-Fenster bei Aktualisierungen des HTML-Snippets automatisch neu geladen.
Die direkt per Email verschickbaren Links sind reine Asset-Deep-Links, dass heisst es gibt keine weiteren Funktionen. Zusätzlich zum Bild wird die easydb-ID des Datensatzes angezeigt.
Im Einstellungsbereich der easydb kann mit der Variable ASSET_DEEP_LINK von Administratoren konfiguriert werden, welche Funktionen zur Verfügung stehen sollen.
| Option | Beschreibung |
| Höhe & Breite ausgeben | Ermöglicht es im Asset-Deep-Link-Tool eine Höhe und Breite anzugeben. |
| Force Iframe ausgeben | Ermöglicht es im Asset-Deep-Link-Tool einen IFRAME zu benutzen. |
| Zoomer | Ermöglicht es im Asset-Deep-Link-Tool für zoomfähige Versionen einen Zoomer zu aktivieren. |
| Bild zentrieren | Ermöglicht es das Bild zentriert darzustellen. |
| HTML-Snippet ausgeben | Zeigt im Asset-Deep-Link-Tool ein HTML-Snippet an (z.B. zum direkten Einbinden in eine Webseite). |
| Email-Link ausgeben | Ermöglicht es im Asset-Deep-Link-Tool einen Asset-Deep-Link per Email zu verschicken. |
| Email-Betreff | Geben Sie einen Betreff an, der beim Verschicken von Email-Links verwendet werden soll. |
| Email-Text | Geben Sie einen Text an, der beim Verschicken von Email-Links verwendet werden soll. |
| Asset-Direkt-URL ausgeben | Zeigt im Asset-Deep-Link-Tool einen Direkt-Link an (z.B. zum Einbinden in ein CMS). |
| Custom-Button Beschriftung | Mit Hilfe des Custom-Button können Sie eine eigene Javascript-Funktion im Asset-Deep-Link-Tool verwenden. Geben Sie hier die Beschriftung des Buttons an. |
| Custom-Button Funktion (Javascript) | Geben Sie hier eine Javascript-Funktion an die im Asset-Deep-Link-Tool aufgerufen werden kann. |
Erfordert eine Option die Angabe von Höhe und Breite (z.B. "Force Iframe", "Bild zentrieren", "Zoomer"), so werden diese Optionen angezeigt, auch wenn sie deaktiviert wurden.
Ersetzungen sind im Email-Text, Email-Betreff und Javascript des Custom-Button möglich. Welche Ersetzungen es gibt, können der nachstehenden Tabelle entnommen werden.
| Variable | Ersetzung |
%ASSET_URL% |
Ausgabe der Asset-URL: Die URL direkt zum Asset. Hierbei handelt es sich um den gleichen Link, der bei Direkt-Link (CMS) erstellt wird. |
%TABLE_NAME% |
Gibt den Namen der Tabelle aus in der sich das Asset befindet. |
%EASYDB_INSTANCE% |
Ausgabe der aktuellen easydb Instanz. |
%SNIPPET_LINK% |
Ausgabe des Snippet-Links. Hierbei handelt es sich um den gleichen Link, der beim Email-Link erstellt wird. |
%SNIPPET% |
Ausgabe des HTMLs für das Snippet. |
%FILE_EXTENSION% |
Gibt den Dateityp des Assets aus. |
%WIDTH% |
Gibt die eingegebene Breite des Assets aus. |
%HEIGHT% |
Gibt die eingegebene Höhe des Assets aus. |
Die Custom-Button-Funktion kann man z.B. so Belegen, dass ein eigenes PHP-Script in einem separaten Fenster geöffnet wir.
easydb.window_open('http://www.meine-webseite.me/asset_cms.php?asset_url='+
encodeURIComponent(%ASSET_URL%),'_new','width=600,height=400');
Das Beispiel öffnet in einem Fenster mit der Größe 600 × 400 Pixel die URL mit dem PHP-Script asset_cms.php. Als Parameter wird asset_url übergeben. Achten Sie bei der Übergabe von Daten auf das korrekte Encoding, welches hier mit encodeURIComponent durchgeführt wird.
Wenn Sie die easydb Funktion easydb.window_open benutzt (an Stelle von window.open), dann schließt easydb das neue Fenster automatisch, wenn das Fenster geschlossen wird, aus dem der Link aufgerufen wurde.
Die Config-Variable GET_PARAMS_IN_JAVASCRIPT erlaubt es, beim Aufruf der easydb Informationen zu übergeben, die dann per Javascript zugänglich sind.
Durch die Auswahl in Frontend für den Asset-Deep-Link entstehen verschiedene Szenarien in der easydb die zu unterschiedlichen Auslieferungen von Versionen oder Originalen führen. Je nach Einstellungen im Rechtemanagement und Freigabe der Asset-Deep-Links werden die ausgelieferten Dateien beinflusst.
| # | Format des Originals | Link-Ergebnis | Größenangabe | Verwendete Version | URL Parameter |
| 1 | Video | IFRAME mit Video-Player | Ja/Pflicht | Version wird nach den Regeln der easydb ausgewählt, d.h. es wird die beste Version für die angegebene Größe ausgewählt. | embed=1 |
| 2 | Audio | IFRAME mit Audio-Player | Ja/Pflicht | Version wird nach den Regeln der easydb ausgewählt, d.h. es wird die beste Version für die angegebene Größe ausgewählt. | embed=1 |
| 3 | Office | IFRAME mit Seiten-Vorschau | Ja/Pflicht | Version wird nach den Regeln der easydb ausgewählt, d.h. es wird die beste Version für die angegebene Größe ausgewählt. | embed=1 |
| 4 | Bild (nicht darstellbar) | IMG-Tag | Nein | Am besten passenste direkt darstellbare Version wird ausgewählt und falls nötig proportional auf die Größe des Originals skaliert. | – |
| 5 | Bild (nicht darstellbar) | IMG-Tag | Ja | Am besten passenste direkt darstellbare Version wird ausgewählt und falls nötig proportional skaliert. | – |
| 6 | Bild (nicht darstellbar) | IFRAME | Ja/Pflicht | Am besten passenste direkt darstellbare Version wird ausgewählt und falls proportional nötig skaliert. | embed=1 |
| 7 | Bild (nicht darstellbar) | Zoomer | Ja/Pflicht | Am besten passenste zoomfähige Version wird verwendet. | embed=1&zoomer=1 |
| 8 | Bild (JPEG, PNG, GIF, BMP) | IMG-Tag | Nein | Original wird direkt ausgegeben. | – |
| 9 | Bild (JPEG, PNG, GIF, BMP) | IMG-Tag | Ja | Original wird verwendet und falls nötig proportional skaliert. | – |
| 10 | Bild (JPEG, PNG, GIF, BMP) | IFRAME | Ja/Pflicht | Version wird nach den Regeln der easydb ausgewählt, d.h. es wird die beste Version für die angegebene Größe ausgewählt und falls nötig proportional skaliert. | embed=1 |
| 11 | Bild (JPEG, PNG, GIF, BMP) | Zoomer | Ja/Pflicht | Am besten passenste zoomfähige Version wird verwendet. | embed=1&zoomer=1 |
| # | Format der Version | Link-Ergebnis | Größenangabe | Verwendete Version | URL-Parameter |
| 12 | Video | IFRAME mit Video-Player | Ja/Pflicht | Angegebene Version wird verwendet. Wenn die Version als Ausgabe-Version in EAS_OUTPUT_DEFAULT_FLASHPLAYER oder EAS_OUTPUT_DEFAULT_HTML5AUDIO konfiguriert ist, wird ein Player angezeigt, falls nicht, erscheint eine Fehlermeldung. | embed=1 |
| 13 | Audio | IFRAME mit Audio-Player | Ja/Pflicht | Angegebene Version wird verwendet. Wenn die Version als Ausgabe-Version in EAS_OUTPUT_DEFAULT_FLASHPLAYER oder EAS_OUTPUT_DEFAULT_HTML5AUDIO konfiguriert ist, wird ein Player angezeigt, falls nicht, erscheint eine Fehlermeldung. | embed=1 |
| 14 | Office | IFRAME ohne Seiten-Vorschau | Ja/Pflicht | Eine einfache Vorschau-Version wird angezeigt. Bitte beachten Sie, dass es für Versionen keine Seiten-Vorschauen gibt. | embed=1 |
| 15 | Bild (nicht darstellbar) | IMG-Tag | Nein | Angegebene Version wird in eine darstellbare Version konvertiert, die Größe wird beibehalten. | – |
| 16 | Bild (nicht darstellbar) | IMG-Tag | Ja | Angegebene Version wird in eine darstellbare Version konvertiert und proportional skaliert. | – |
| 17 | Bild (JPEG, PNG, GIF, BMP) | IMG-Tag | Nein | Angegebene Version wird direkt ausgegeben. | – |
| 18 | Bild (JPEG, PNG, GIF, BMP) | IMG-Tag | Ja | Angegebene Version wird verwendet und falls nötig proportional skaliert. | – |
| 19 | Bild (JPEG, PNG, GIF, BMP) | Zoomer | Ja/Pflicht | Angegebene Version wird verwendet. | embed=1&zoomer=1 |
| # | Format des Originals | Größenangabe | Verwendete Version | URL-Parameter |
| 20 | Video | Ja/Pflicht | Original wird unskaliert ausgegeben. | asset=1 |
| 21 | Audio | Ja/Pflicht | Original wird unskaliert ausgegeben. | asset=1 |
| 22 | Office | Ja/Pflicht | Original wird unskaliert ausgegeben. | asset=1 |
| 23 | Bild (nicht darstellbar) | Nein | Original wird ausgegeben. | asset=1 |
| 24 | Bild (nicht darstellbar) | Ja | Original wird proportional skaliert ausgegeben, Format des Originals wird beibehalten. | asset=1 |
| 25 | Bild (JPEG, PNG, GIF, BMP) | Nein | Original wird ausgegeben. | asset=1 |
| 26 | Bild (JPEG, PNG, GIF, BMP) | Ja | Original wird proportional skaliert ausgegeben, Format des Originals wird beibehalten. | asset=1 |
| # | Format der Version | Größenangabe | Verwendete Version | URL-Parameter |
| 27 | Video | Ja/Pflicht | Die angegebene Größe wird ignoriert. Version wird unskaliert ausgegeben. | asset=1 |
| 28 | Audio | Ja/Pflicht | Die angegebene Größe wird ignoriert. Version wird unskaliert ausgegeben. | asset=1 |
| 29 | Office | Ja/Pflicht | Die angegebene Größe wird ignoriert. Version wird unskaliert ausgegeben. | asset=1 |
| 30 | Bild (nicht darstellbar) | Nein | Version wird ausgegeben. | asset=1 |
| 31 | Bild (nicht darstellbar) | Ja | Version wird proportional skaliert ausgegeben, Format der Version wird beibehalten. | asset=1 |
| 32 | Bild (JPEG, PNG, GIF, BMP) | Nein | Version wird ausgegeben. | asset=1 |
| 33 | Bild (JPEG, PNG, GIF, BMP) | Ja | Version wird proportional skaliert ausgegeben, Format der Version wird beibehalten. | asset=1 |