Öffne externe URL
Aktionen - Kurzfassung
Die Aktion Öffne externe URL öffnet eine als Eingabewert ($input) übergebene URL in einem neuen Tab des Client-Browers.
Siehe auch Externe URL öffnen (für Ereignisbehandlungen) bzw. Ribbon-Makro-Befehl "Externe URL öffnen" (s. Verfügbare Befehle)
Die Aktion Öffne externe URL öffnet eine als Eingabewert ($input) übergebene URL in einem neuen Tab des Client-Browers.
Der neu geöffnete Browser-Tab erhält sofort den Fokus.
Das Formular wartet nicht bis die aufgerufene Seite aufgebaut ist. Ggf. nachfolgende Aktionen werden sofort ausgeführt.
Soweit beim Öffnen der URL Fehler auftreten, werden diese im zugehörigen Browser-Tab angezeigt. Sie haben aber keinen Einfluss auf das Formular.
Konfiguration
Die Aktion bietet keine Parameter an. Die zu öffnende URL muss direkt als Eingabewert ($input) bereitgestellt werden.
Ein einfacher Weg, eine konkrete URL festzulegen, ist die Verhaltensweise Berechnen (s. Beispiele unten). Diese kann für statische Zuweisungen ("Literale" als Ausdruck) genutzt werden, bietet aber auch die Möglichkeit die URL per "Berechnungsausdruck" dynamisch aufzubauen (s. Beispiele).
►WICHTIG◄ Der Eingabewert ($input) muss eine Zeichenfolge sein, da sonst kein Browser-Tab geöffnet wird. Anders als innerhalb Lobster Data Platform / Orchestration sonst üblich (s. a. Externe URL öffnen), findet keine automatische Konvertierung anderer Datentypen (z. B. Long oder Objekt) zu einer Zeichenfolge statt.
Vor der Weitergabe an den Browser-Tab wird die Zeichenfolge getrimmt, also von ggf. einleitenden oder anhängenden Whitespace-Zeichen (Leerzeichen, Zeilenwechsel, etc.) "befreit".
Verzichtet die URL auf die Angabe eines spezifischen Protokolls (z. B. http:), wird der übergebene Text als relativer Pfad im Kontext des Lobster Data Platform / Orchestration-Clients interpretiert (s. Beispiele).
►HINWEIS◄ Eine Verknüpfung zu einem Zielelement ist wirkungslos!
Beispiele
Einfacher Anwendungsfall mit statischer URL
Innerhalb verschiedener Formulare sollen per Klick auf einen Button die "Allgemeinen Geschäftsbedingungen" (AGB) angezeigt werden können. Zu diesem Zweck wird bei jeder Aktualisierung der AGB ein PDF-Dokument erstellt und von einem berechtigten Benutzer mit dem Dateimanager in ein bestimmtes Unterverzeichnis im web-Ordner von Lobster Data Platform / Orchestration hochgeladen. Dabei wird immer das eigens eingerichtete Unterverzeichnis public/documents und der Dateiname agb.pdf verwendet:
Per Definition stehen alle innerhalb des web-Ordners platzierten Inhalte als "Unterseiten" der Client-URL zur Verfügung.
Für den Zugriff auf das AGB-Dokument reicht beim Zugriff ausgehend von einem Client-Formular der folgende Pfad als "URL" aus:
public/documents/agb.pdf
Konfiguration:
|
In jedem Formular, das Zugriff auf das AGB-Dokument gewähren soll, wird ein entsprechender Button platziert und mit den rechts abgebildeten Verhalten ausgestattet:
|
|
Einfacher Anwendungsfall mit "berechneter" URL
Ausgehend vom vorigen Anwendungsfall, soll nun erreicht werden, dass passend zur Anmeldesprache in einer bestimmten Sitzung entweder das deutsche Dokument agb.pdf oder die englische Version tscs.pdf ("Terms and Conditions") geöffnet wird.
Die Sprachverwaltung bietet sich an, um für jede Anmeldesprache festzulegen, ob das deutsche oder das englische Dokument angezeigt werden soll. Konkret wird dazu ein benutzerdefinierter Lokalisierungseintrag erstellt:
Als "Lokalisierung" für den Lokalisierungseintrag "publicDocuments/TERMS_AND_CONDITIONS" können wie im Bild gezeigt unterschiedliche Dateinamen je Anmeldesprache hinterlegt werden.
In der Konfiguration aus dem vorherigen Beispiel muss dann lediglich der Berechnungsausdruck in der Verhaltensweise Berechnen so angepasst werden, dass die URL "passend" aufgebaut wird:
Per Notation [Bundle, Resource] kann der variable "Spracheintrag" direkt an den einheitlichen Basispfad public/documents angehängt werden.
Zur Laufzeit erscheint dann immer das über die Sprachverwaltung für die Aktuelle Sprache zugeordnete Dokument, wenn der Button gedrückt wird.
►ANMERKUNG◄ Firmenspezifische Sprachanpassungen könnten in diesem Kontext verwendet werden, um innerhalb einer komplexeren Firmenhierarchie nicht nur sprach- sondern auch firmenspezifische Dokumente über den immer gleichen AGB-Button anzuzeigen.
Komplexerer Anwendungsfall
Ein Portal soll einen vom Benutzer eingegebenen Suchbegriff an eine Firmen-Website (hier: www.lobster-world.com) weiterzuleiten und das Suchergebnis in einem neu geöffneten Browser-Tab anzuzeigen.
Die Lobster-Homepage unterstützt diesen Zugriff über folgende Syntax: www.lobster-world.com/<language>//?s=<searchText>.
Der Platzhalter <language> ist durch ein zweistelliges Kürzel für eine der auf der Website unterstützten Sprachen zu ersetzen, z. B. "de" für Deutsch oder "en" für Englisch.
Als Wert für den URL-Parameter s muss der Begriff übergeben werden, nach dem gesucht werden soll.
Konfiguration:
|
Im Portal werden ein Textfeld für die Eingabe des Suchbegriffs und ein Auswahlfeld/Combobox für die Auswahl der Sprache für die "Suche" wie rechts abgebildet konfiguriert. Für das Textfeld (Element #14) werden zwei Verhalten eingerichtet. Das erste Verhalten "enter" löst beim Drücken der Enter-Taste im "Suchfeld" das zweite Verhalten "openURL" aus. Die Konfiguration für das Verhalten "openURL" ist rechts aufgeklappt. Innerhalb der Verhaltensweise Berechnen wird der Berechnungsausdruck verwendet um die Ziel-URL aus folgenden Komponenten aufzubauen:
Unter den Aktionen bei "wahr" wird die Aktion Öffne externe URL hinzugefügt, die keine spezifische Parametrierung erfordert. |
|
