Externe URL öffnen

Siehe auch Öffne externe URL (für Formulare) bzw. Ribbon-Makro-Befehl "Externe URL öffnen" (s. Verfügbare Befehle)

Ereignisaktion - Kurzfassung

Zweck: Öffnet eine externe URL im aktuellen Client als neuen Browser Tab.

images/download/attachments/62866166/image2021-2-16_12-8-24-version-1-modificationdate-1613473706202-api-v2.png

Die Ereignisaktion Externe URL öffnen öffnet eine URL auf dem aktuellen Client in einem neuen Browser Tab.

  • Der neu geöffnete Browser-Tab erhält sofort den Fokus.

  • Die Ereignisbehandlung wartet nicht bis die aufgerufene Seite aufgebaut ist.

  • Soweit beim Öffnen der URL Fehler auftreten, werden diese im zugehörigen Browser-Tab angezeigt. Sie haben aber keinen Einfluss auf die Ereignisverarbeitung.

HINWEIS◄ Wenn die Ereignisbehandlung einem nicht-interaktiven Kontext (z. B. Import) ausgelöst wurde, wird die Ereignisaktion Externe URL öffnen ignoriert.

Konfiguration

Im Parameter URL kann eine beliebige URL als statischer Textwert oder per Wertauflöser definiert werden.

Per Standard sieht das Eingabefeld die Direkteingabe vor, die intern als Parameter für einen Wertauflöser für statischen Text (s. Statische Werte) interpretiert wird.

Ein Klick auf den grauen Pfeil links unten im Eingabefeld macht diesen Wertauflöser sichtbar, so dass er bearbeitet oder durch andere Wertauflöser ersetzt werden kann:

images/download/attachments/62866166/image2021-2-16_13-19-26-version-1-modificationdate-1613477968098-api-v2.png

Beispiele

Einfacher Anwendungsfall

Innerhalb einer Ereignisbehandlung soll unter bestimmten Voraussetzungen eine statische definierte URL geöffnet werden, die einen neuen Browser-Tab neben der aktuellen Client-Sitzung belegt:

Konfiguration:

images/download/attachments/62866166/image2021-2-16_13-22-59-version-1-modificationdate-1613478181227-api-v2.png

HINWEIS◄ Das Präfix für das http-Protokoll (http://) muss in der URL explizit enthalten sein. Es wird nicht automatisch ergänzt!

Beginnt der Wert im Parameter URL nicht mit einem Kürzel für ein Protokoll, dann wird die URL relativ zum Pfad des Lobster_pro-Clients aufgelöst, so dass z. B. auch Dokumente angezeigt werden können, die per Dateimanager in den web-Ordner hochgeladen wurden:

images/download/attachments/62866166/image2021-2-16_13-40-45-version-1-modificationdate-1613479247572-api-v2.png

images/download/attachments/62866166/image2021-2-16_13-43-29-version-1-modificationdate-1613479410820-api-v2.png

Auch andere Inhalte, die relativ zum Client-Pfad verfügbar sind können aufgerufen werden. Der folgende Aufruf öffnet eine Übersicht mit technischen Informationen zur verwendeten Lobster Data Platform / Orchestration-Installation:

images/download/attachments/62866166/image2021-2-16_13-47-6-version-1-modificationdate-1613479628012-api-v2.png

Komplexerer Anwendungsfall

Über ein Eigenes Aktionsevent soll ein Ribbon-Button die Suchfunktion einer Firmenwebsite (hier: www.lobster-world.com) in der Sprache der Lobster Data Platform / Orchestration-Sitzung adressieren und dazu dem Anwender vorab die Eingabe eines Suchbegriffs ermöglichen.

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:

Der Wert für den Parameter URL soll in diesem Fall durch die Konfiguration rechts zur Laufzeit "dynamisch" definiert werden:

  • Für den Parameter URL wird zunächst ein Wertauflöser vom Typ Textverkettung eingesetzt, in dem die zu verkettenden Inhalte per Direkteingabe oder über andere Wertauflöser definiert werden können.


  • Die Basis-URL wird hier inklusive Protokoll-Präfix als statischer Text direkt eingegeben: http://ww.lobster-world.com/


  • Es folgt ein Aktuelle Sprache-Wertauflöser, der die zweistellige Kennung für die Sprache zurückgeben soll. Die Option Sprache ohne Land soll dabei sicherstellen, dass in Lobster Data Platform / Orchestration ggf. verwendete länderspezifische Ausprägungen einer Sprache (z. B. en_us oder de_ch) abgetrennt werden.


  • Der Übergang von der Webadresse zu den Parametern wird wiederum als statischer Text (//?s=) definiert.


  • Der Suchbegriff selbst wird durch einen Benutzereingabe-Wertauflöser vom Benutzer abgefragt, so dass zur Laufzeit ein Dialog mit einem Textfeld erscheint. Die dabei verwendeten Parameter sind rechts zu sehen:

    • Im Titel wird - rein informativ - die aufgerufene Website benannt.

    • Die Meldung wird aus einem hier nicht näher bezeichneten Eintrag der Sprachverwaltung bezogen.

    • Der Timeout (s) wird auf den Wert 0 gesetzt, damit der Dialog dem Benutzer ohne Zeitbegrenzung angezeigt wird.

ANMERKUNG◄ Die Konfiguration für dieses Beispiel sieht keine inhaltlichen Anforderungen an die Benutzereingabe vor, insbesondere wird auch "kein Wert" als Eingabe akzeptiert. Demnach wird die Suchfunktion der Website auch dann beansprucht, wenn der Benutzer keinen Suchbegriff eingegeben hat. Auf eine entsprechende Fallunterscheidung, ggf. in Verbindung mit der Option Abbrechen erlaubt, wurde hier zugunsten einer kompakteren Darstellung bewusst verzichtet.

images/download/attachments/62866166/image2021-2-16_14-41-19-version-1-modificationdate-1613482881558-api-v2.png

Laufzeitbeispiel:

images/download/attachments/62866166/image2021-2-16_18-48-2-version-1-modificationdate-1613497684235-api-v2.png

Innerhalb einer Anmeldung, die die Anmeldesprache "Deutsch" verwendet, ergibt die Eingabe des Suchbegriffs "dmz" die rechts oben ersichtliche URL.

ANMERKUNG◄ Die tatsächlich mit diesem Suchbegriff erzielten Suchergebnisse können natürlich vom hier festgehaltenen Stand ebenso abweichen, wie das Design und die Funktionalität der Website.

images/download/attachments/62866166/image2021-2-16_18-49-51-version-1-modificationdate-1613497793598-api-v2.png