Inhalt anzeigen
Ereignisaktion - Kurzfassung
Zweck: Öffnet einen zusätzlichen Browser-Tab, um den über eine Wert-Konfiguration für den Parameter Inhalt zum Anzeigen bereitgestellten "Inhalt" (Content) anzuzeigen bzw. herunterzuladen.
Siehe auch: Dokument anzeigen (Ereignisaktion)
Die Inhalt anzeigen-Ereignisaktion öffnet einen zusätzlichen Browser-Tab, um den über eine Wert-Konfiguration für den Parameter Inhalt zum Anzeigen bereitgestellten "Inhalt" (Content) anzuzeigen.
ACHTUNG
Der Inhalt zum Anzeigen wird komplett in den Arbeitsspeicher des Servers geladen, bevor er zum Herunterladen/Öffnen angeboten werden kann. Es wird nicht empfohlen, die Inhalt anzeigen-Ereignisaktion für besonders umfangreiche Dateien (z. B. Videos) einzusetzen.
►WICHTIG◄ Die Inhalt anzeigen-Ereignisaktion ist - im Unterschied zu Dokument anzeigen (Ereignisaktion) - im Client-Kontext (Client Workflow, Client Workflows) nicht verfügbar.
Falls für den Parameter Inhalt zum Anzeigen keine Wert-Konfiguration vorliegt oder diese zur Laufzeit "Kein Wert" ($null) liefert, wird kein Browser-Tab geöffnet.
Ein im Ausführungskontext vorliegendes Bezugsobjekt gilt auch für eine Wert-Konfiguration im Parameter Inhalt zum Anzeigen als Bezugsobjekt, wird aber nicht als Standardwert herangezogen, falls keine Wert-Konfiguration vorliegt.
Häufig wird der Inhalt zum Anzeigen über einen Wertauflöser aus der Kategorie Inhaltserzeuger (Wertauflöser) bereitgestellt oder erzeugt.
Die Wertauflöser der Kategorie Inhaltserzeuger (Wertauflöser) liefern Rückgabewerte des Typs "Inhalt" (Content) oder Text (String).
Text (String) wird grundsätzlich direkt im Browser-Tab ausgegeben.
Ob "Inhalt" (Content) abhängig von dessen "Medientyp" (mediaType) direkt im Browser-Tab angezeigt oder als Download behandelt wird, entscheidet letztendlich der Browser ggf. auch unter Berücksichtigung der Erweiterung im Dateinamen (name).
►HINWEIS◄ Auch bei einem Download erscheint vorübergehend ein Browser-Tab, der aber automatisch wieder geschlossen wird.Für einige "verwandte" Datentypen für "Inhalt" (Content) greift eine automatische Typumwandlung:
Dokumente können wahlweise komplett - als "Dokument" (Document)-Objekt (inkl. Dateiname) - oder als Byte Array (byte[]) aus dem Document-Feld "Dokumentinhalt" (documentContent) bereitgestellt werden.
Ein "Dateiinformation" (FileInfo)-Objekt (z. B. aus einem Datei-Element in einem Formular) kann direkt als Inhalt angezeigt werden. Dabei kann die "MIME Typ" (type) Eigenschaft entscheidend dafür sein, wie der Browser die Daten aufbereitet (z. B. text/plain vs. text/html).
Für alle anderen Datentypen wird das serverseitig definierte String-Abbild als Test im Browser-Tab ausgegeben.
Beispiele
Einfacher Anwendungsfall: Bilddatei aus dem Server-Dateisystem anzeigen
Innerhalb einer Ereignisbehandlung soll unter bestimmten Voraussetzungen eine hinterlegte Bilddatei (overview.png) in einem neuen Browser-Tab geöffnet werden.
Konfiguration:
Im Parameter Inhalt zum Anzeigen wird der Dateireferenz-Wertauflöser verwendet, um die Datei als "Inhalt" (Content) bereitzustellen:
|
|
►ANMERKUNG◄ Da die betreffende Datei nicht "öffentlich" (ohne Anmeldung an Lobster Data Platform / Orchestration) zugänglich sein soll, wurde sie nicht im web-Ordner des Server-Dateisystem platziert, sondern direkt im übergeordneten upload-Verzeichnis, das als Stammverzeichnis ($home) für den Dateimanager dient.
Läge die Datei innerhalb des web-Ordners (z. B. im Pfad $home/web/pics/overview.png) "öffentlich" ab, könnte anstelle der Inhalt anzeigen-Ereignisaktion auch die Externe URL öffnen-Ereignisaktion (mit der relativen URL pics/overview.png) zum Anzeigen des Bilds in einem neuen Browser-Tab verwendet werden.
Komplexerer Anwendungsfall: Daten einer Entität im Browser anzeigen
Der Info der Session--Wertauflöser stellt vielfältige Informationen zur aktuellen Sitzung in strukturierter Form - als Entität des Typs "Session Information" (SessionInformation) bereit.
Die folgenden Konfiguration demonstrieren unterschiedliche Ansätze, mit denen die enthaltenen Informationen per Inhalt anzeigen in einem eigenen Broswer-Tab visualisiert werden können.
Konfigurationsvarianten |
Ergebnis (Anzeige im geöffneten Browser-Tab) |
|
Hier wird der Rückgabewert des Info der Session-Wertauflösers direkt als Inhalt zum Anzeigen definiert. Ausgegeben wird daraufhin das String-Abbild der Entität (s. rechts). |
|
4:de.lobster.scm.authentication.SessionInformation@a8a42e83 |
Damit die im "Session Information"-Objekt enthaltenen Informationen im Browser-Tab untersucht werden können, wird hier der Info der Session-Wertauflöser mit einem JSON aus Objekt erzeugen-Wertauflöser verkettet. Als Inhalt zum Anzeigen erhalten wir damit einen ggf. recht umfangreichen Text, der das "Session Information"-Objekt im JSON-Format ausführlich beschreibt und damit lesbar macht (s. Ausschnitt rechts). ►ANMERKUNG◄ Der JSON aus Objekt erzeugen-Wertauflöser stellt das JSON-Abbild direkt als Text bereit, der als Inhalt zum Anzeigen direkt in den Browser-Tab ausgegeben wird. Mit der etwas aufwändigeren Konfigurationsvariante unten kann man dem Browser zusätzlich "mitteilen", dass der Text (String) eine JSON-Struktur beschreibt. Sofern der Browser das unterstützt, erhält man dann eine nützlichere Aufbereitung der Ansicht (s. rechts unten). |
|
{ |
►HINWEIS◄ Analog zu diesem Beispiel kann ein XML-String (z. B. aus dem XML-Export-Wertauflöser) mit dem Typ text/xml verknüpft werden, damit es strukturiert dargestellt wird, sofern der Browser das unterstützt. |
|