ExternalWeb Component | X4Documentation

Eine ExternalWeb Component bettet eine externe Webseite in eine Web App ein. Eine ExternalWeb Component wird mit dem Element <ExternalWebComponent> erzeugt.

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.

Für das Element <ExternalWebComponent> lassen sich folgende Attribute festlegen:

Attribut	Beschreibung
`displayName`	Anzeigename der Component im Menü. Übersetzbar Data Binding möglich Mögliche Werte: Beliebige Zeichenkette
`path`	Erforderlich. Eindeutige URL der Component, sichtbar in der Adresszeile des Browsers. Mögliche Werte: Zeichenkette aus alphanumerischen Zeichen (keine Umlaute, Punkte usw.)
`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)
`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`)
`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/`)
`name`	Eindeutiger Name, der die Component referenziert. Mögliche Werte: Beliebige Zeichenkette
`default`	Bestimmt, ob die Ansicht auf eine Component als Voreinstellung ausgewählt ist. Mögliche Werte: `true` / `false` (maximal eine Component darf das Attribut `default="true"` besitzen)
`showInMenu`	Bestimmt, ob die ExternalWeb Component in der Navigationsleiste sichtbar ist. Mögliche Werte: `true` / `false`

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

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"/>