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.

Tooltip

• Verwendung: Über eine Wert-Konfiguration für den Parameter Inhalt zum Anzeigen kann ein Datenobjekt des Typs "Inhalt" (Content), "Dokument" (Document) oder "Dateiinformation" (FileInfo) oder ein Byte Array (byte[]) bereitgestellt werden, das an den Browser zur Anzeige oder zum Download übergeben werden soll. Für alle anderen Datentypen wird das String-Abbild des Datenobjekts als Klartext im geöffneten Browser Tab angezeigt.

• Parameter: Es muss eine Wert-Konfiguration für den Inhalt zum Anzeigen vorliegen. Die dabei verwendeten Wertauflöser können sich auf das Bezugsobjekt im Ausführungskontext beziehen.

  • Ohne eine Wert-Konfiguration wird nicht auf das Bezugsobjekt als Inhalt zum Anzeigen zurückgegriffen.

  • Falls keine Wert-Konfiguration vorliegt oder diese zur Laufzeit "Kein Wert" ($null) liefert, ist die Inhalt anzeigen-Ereignisaktion wirkungslos.

• Hinweis: Die Inhalt anzeigen-Ereignisaktion ist - im Unterschied zu Dokument anzeigen (Ereignisaktion) - im Client-Kontext (Client Workflow, Client Workflows) nicht verfügbar.

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:

►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.

{
	"class": "de.lobster.scm.authentication.SessionInformation",
	"additionalData": {
		"\u0022$integrationClientId$\u0022": "-1",
		"\u0022welcomeTooltip\u0022": "Karola(1901)\nSuper user limited\nXflow AG (1902)",
		"\u0022welcomeText\u0022": "Frau Karola",
		"\u0022apiUser\u0022": false,
		"\u0022parentCompanies\u0022": {
			"class": "list",
			"data": [
				{
					"class": "java.lang.Long",
					"value": "702"
				},
...