X4 Produktdokumentation
X4 Produktdokumentation
Breadcrumbs

ExternalWeb Component

Eine ExternalWeb Component bettet eine externe Webseite in eine Web App ein. Eine ExternalWeb Component wird mit dem Element <ExternalWebComponent> in der .wad-Datei oder in einer Master/Detail Component (.masterdetail-Datei) erzeugt.

Hinweis:

  • Wenn der Eigentümer der Webseite das Einbetten untersagt, z. B. durch Einbinden eines entsprechenden HTTP-Antwort-Headers, kann diese Webseite nicht in eine Web App eingebettet werden.

  • Beachten Sie, dass eingebettete Webseiten Cookies auf dem Endgerät speichern und verwenden können.

Attribute der ExternalWeb Component definieren

Hinweis:

Abhängig davon, ob Sie das Element <ExternalWebComponent> in der .wad-Datei oder in einer Master/Detail Component (.masterdetail-Datei) erzeugen, können Sie unterschiedliche Attribute definieren. Ausführliche Informationen zu den Attributen, die Sie in einer .wad-Datei für die ExternalWeb Component definieren können, finden Sie unter Components in der Web App-Definition referenzieren.

Wenn Sie die ExternalWeb Component in einer .masterdetail-Datei anlegen, können Sie folgende Attribute definieren:

Attribut

Beschreibung

allowForms

Erlaubt eingebetteten Inhalten, Formulare zu übermitteln.

Mögliche Werte:

  • true

  • false (Standard)

allowModals

Erlaubt eingebetteten Inhalten, einen modalen Dialog anzuzeigen.

Mögliche Werte:

  • true

  • false (Standard)

allowPointerLock

Erlaubt eingebetteten Inhalten, Mausbewegungen direkt als Eingabemethode zu interpretieren.

Mögliche Werte:

  • true

  • false (Standard)

allowPopups

Erlaubt eingebetteten Inhalten, eine Webseite in einem neuen Fenster oder Registerkarte zu öffnen.

Mögliche Werte:

  • true

  • false (Standard)

allowSameOrigin

Erlaubt eingebetteten Inhalten, gemeinsamen Speicherplatz zu verwenden, wenn der Ursprung der eingebetteten Inhalte derselbe ist wie der Ursprung der Host-Webanwendung.

Mögliche Werte:

  • true

  • false (Standard)

allowScripts

Erlaubt eingebetteten Inhalten, JavaScript auszuführen.

Mögliche Werte:

  • true

  • false (Standard)

allowTopNavigation

Erlaubt eingebetteten Inhalten, eine Webseite im selben Fenster oder Registerkarte zu öffnen.

Mögliche Werte:

  • true

  • false (Standard)

name

Eindeutiger Name, der die Component referenziert.

Mögliche Werte: 

Beliebige Zeichenkette 

process

Repository-Pfad zu einem Technical Process.

Mögliche Werte: 

Beliebiger Pfad im X4 Repository ohne führenden Schrägstrich (z. B. Project/Folder/Process.wrf)

Hinweis:

Das Attribut process kann nicht gleichzeitig mit dem Attribut url verwendet werden.

title

Titel der Component. Wird in der Component als Header angezeigt.

  • Data Binding möglich

Mögliche Werte: 

Beliebige Zeichenkette mit dem Titel der Component

titleBackground

Definiert eine Titel-Hintergrundfarbe.

Mögliche Werte:

  • Hexadezimaler Farbwert, z. B. ff5a00

Hinweis:

Verwenden Sie keine Raute vor dem Farbwert und keine verkürzte Schreibweise des Farbwerts!

  • Farbcode aus der Farbpalette der Web App (vgl. Theming), z. B. A200

Hinweis:

Verwenden Sie keine Raute vor dem Farbwert und keine verkürzte Schreibweise des Farbwerts!

titleForeground

Definiert eine Farbe für den Titel-Vordergrund.

Mögliche Werte:

  • Hexadezimaler Farbwert, z. B. ff5a00

Hinweis:

Verwenden Sie keine Raute vor dem Farbwert und keine verkürzte Schreibweise des Farbwerts!

  • Farbcode aus der Farbpalette der Web App (vgl. Theming), z. B. A200

url

Uniform Resource Locator (URL) mit beliebigem gültigen Protokoll (http://, https://, etc.)

Mögliche Werte: 

Beliebige gültige URL (z. B. https://www.softproject.de/)

Hinweis:

Das Attribut url kann nicht gleichzeitig mit dem Attribut process verwendet werden.

visible

Legt die Sichtbarkeit fest.

  • Data Binding (Boolean) möglich.

Mögliche Werte: 

Boolean oder Zeichenkette für Data Binding

Input

Wenn der Parameter process gesetzt wurde, wird eine XML-Datei mit der URL als Input in folgender Struktur erwartet:

XML
<?xml version="1.0" encoding="UTF-8"?>
<Ok
	url="URL"/>

Beispiel

URL in ExternalWeb Component

Das folgende Beispiel in der .wad erzeugt eine ExternalWeb Component:

XML
<ExternalWebComponent 
	path="ExternalWebUrl"
	displayName="SoftProject Website"
	url="https://www.softproject.de" />

URL über Technical Process

Das folgende Beispiel in der .wad erzeugt eine ExternalWeb Component:

XML
<ExternalWebComponent 
	path="ExternalWebUrl"
	displayName="SoftProject Website"
	process="provideURL.wrf" />

Der Technical Process provideURL.wrf liefert folgenden Output, der die URL festsetzt:

XML
<?xml version="1.0" encoding="UTF-8"?>
<Ok
	url="https://www.softproject.de"/>