ExternalWeb Component | X4Documentation

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