Web Template 
Definition
Web Item, mit dessen Hilfe Sie andere Web Templates in ein Web Template einfügen können.
Verwendung
Mit dem Web Item Web Template können Sie auf einfache Weise gleichbleibende Abschnitte in Ihren Web Applications zentral in einem Web Template verwalten und bei Bedarf in jedes beliebige Web Template integrieren. So können Sie z.B. einen Header- oder Footer-Abschnitt mit Firmenlogo und Überschrift als Web Template definieren und dieses Web Template als Web Item Web Template in ihre Web Applications integrieren. Zur Laufzeit wird dann dieses Web Template eingefügt. Im Gegensatz zur HTML-Frame-Technologie erzeugt hierbei das System keine neue Seite. Der Kontext des Haupttemplates bleibt erhalten.
Struktur
Neben den allgemeinen Attributen hat das Web Item Web Template folgende spezifische Attribute:
Attribute |
Beschreibung |
Nur <body>-Tag (USE_ONLY_BODY) ‘X’ = ja (Standardeinstellung), ‘ ‘ = nein |
Nur den Inhalt des <body>-Tags nutzen Wenn Sie dieses Attribut setzen, wird bei dem einzufügenden Web Template nur der Inhalt des Body-Tags verwendet.
Dieses Attribut muss gesetzt werden, wenn das einzufügende Web Template ein komplettes HTML-Dokument, inklusive <HTML> - Tag darstellt. |
Web Template (TEMPLATE_ID) |
Technischer Name des Web Templates, das eingefügt werden soll. |
Präfix für die logischen Namen (NAME_PREFIX) (optional) |
Präfix für die logischen Namen der Objekte, die im Web Template enthalten sind. Da sich die Objekte des Haupttemplates und des eingefügten Web Templates einen Namensraum teilen und über ihre Namen aneinander gebunden werden können, können Sie in einem entsprechenden Szenario mit der Präfix-Vergabe das Haupttemplate und das eingefügte Web Template eindeutig machen. Die Präfix-Vergabe ist dann sinnvoll, wenn im Haupttemplate als auch im eingefügten Web Template dieselben logischen Namen für Web Items und Data Provider verwendet werden, diese aber voneinander zu trennen sind. Beispiel: Sie verwenden im Haupttemplate einen Data Provider DP1 mit der Query „Umsatzerlöse“; im eingefügten Web Template wird ebenfalls ein Data Provider DP1 verwendet, hier jedoch mit der Query „Kosten“. Damit im eingefügten Web Template die Query „Kosten“ angezeigt wird, ist es erforderlich, dem Data Provider des eingefügten Web Templates einen Präfix zu vergeben. In der folgenden Tabelle finden Sie einen Überblick über die Auswirkungen der Präfixvergabe für das Arbeiten mit der Web API. |
Präfixvergabe und ihre Bedeutung
Voraussetzung |
Namenspräfix-Vergabe |
Keine Namenspräfix-Vergabe |
Gleicher logischer Name von Web Items im Haupttemplate und im eingefügten Web Template |
Web API – Befehle müssen das Web Item des eingebundenen Web Templates mit Namenspräfix und logischem Namen ansprechen, wobei folgende Konvention gilt: PRÄFIX.NAME Beispiel: Das Web Item des eingebunden Web Templates hat den logischen Namen ITEM_1 und das Präfix lautet ABC. Dann wird das Web Item unter ABC.ITEM_1 angesprochen. |
Die Initialisierung des Web Items entspricht der Initialisierung des Haupttemplates. |
Gleicher logischer Name von Data Providern im Haupttemplate und im eingefügten Web Template |
Web API – Befehle müssen den Data Provider des eingebundenen Web Templates mit Namenspräfix und logischem Namen ansprechen, wobei folgende Konvention gilt: PRÄFIX.NAME Beispiel: Der Data Provider des eingebundenen Web Templates hat den logischen Namen DP_1 und das Präfix lautet ABC. Dann wird der Data Provider unter ABC.DP_1 angesprochen. |
Das Data Binding erfolgt duch den Data Provider des Haupttemplates. |
Zusätzlich können Sie folgende Attribute (Parameter) nutzen, die Ihnen nicht im Web Application Designer zur Verfügung gestellt werden, die jedoch über die HTML-Sicht des Web Templates eingefügt werden können:
Attribut |
Beschreibung |
Überschreiben der Web Item-Initialisierung (SET_ITEM_I; ITEM_ID_I / ITEM_CLASS_I) |
Wenn Sie dieses Attribut nutzen, werden die initialen Web Item-Einstellungen im einzufügenden Web Template überschrieben. Ein mögliches Szenario zum Einsatz dieses Attributs finden Sie als Beispiel 3 unter Web Template. |
Überschreiben der Data Provider-Initialisierung (SET_DATA_PROVIDER_I) (optional) |
Wenn Sie dieses Attribut nutzen, werden die initialen Data Provider-Einstellungen im einzufügenden Web Template überschrieben. |
Alle aufgeführten Attribute lassen sich durch Befehl-URLs nicht ändern.
Weitere Informationen zu Verwendung und Funktion des Web Items Web Template finden Sie unter Web Template.