Vorlage des InternetExpress-Seitengenerators anpassen
Nach oben zu Mehrschichtige Anwendungen erstellen - Index
Die Vorlage eines InternetExpress-Seitengenerators ist ein HTML-Dokument mit zusätzlichen Tags, die von der Anwendung dynamisch übersetzt werden. Der InternetExpress-Seitengenerator generiert zunächst eine Standardvorlage als Wert der Eigenschaft HTMLDoc. Diese Standardvorlage hat folgende Form:
<HTML> <HEAD> </HEAD> <BODY> <#INCLUDES> <#STYLES> <#WARNINGS> <#FORMS> <#SCRIPT> </BODY> </HTML>
Die HTML-transparenten Tags in der Standardvorlage werden folgendermaßen übersetzt:
<#INCLUDES> generiert die Anweisungen, mit deren Hilfe die Javascript-Bibliotheken aufgenommen werden. Diese Anweisungen haben folgende Form:
<SCRIPT language=Javascript type="text/javascript" SRC="IncludePathURL/xmldom.js"> </SCRIPT> <SCRIPT language=Javascript type="text/javascript" SRC="IncludePathURL/xmldb.js"> </SCRIPT> <SCRIPT language=Javascript type="text/javascript" SRC="IncludePathURL/xmlbind.js"> </SCRIPT>
- <#STYLES> generiert die Anweisungen, die aus den in der Eigenschaft Styles bzw. StylesFile des MIDAS-Seitengenerators enthaltenen Definitionen eine Formatvorlage erstellen.
- <#WARNINGS> hat zur Laufzeit keine Funktion. Während des Entwurfs generiert <#WARNINGS> Warnmeldungen für Probleme, die bei der Erstellung des HTML-Dokuments auftreten. Diese Meldungen werden im Web-Seiteneditor angezeigt.
- <#FORMS> generiert den HTML-Code, der von den im Web-Seiteneditor hinzugefügten Komponenten erstellt wird. Der HTML-Code für jede Komponente wird in der in WebPageItems festgelegten Reihenfolge generiert.
- <#SCRIPT> generiert einen Block mit Javascript-Deklarationen. Diese werden in dem HTML-Code verwendet, der von den im Web-Seiteneditor hinzugefügten Komponenten generiert wird.
Sie können die Standardvorlage ersetzen, indem Sie den Wert von HTMLDoc oder der Eigenschaft HTMLFile ändern. Die angepasste HTML-Vorlage kann alle HTML-transparenten Tags enthalten, die in der Standardvorlage vorhanden sind. Der InternetExpress-Seitengenerator übersetzt diese Tags automatisch, wenn die Methode Content aufgerufen wird. Die drei folgenden Tags werden vom InternetExpress-Seitengenerator ebenfalls automatisch übersetzt:
- <#BODYELEMENTS> wird durch den HTML-Code ersetzt, der sich aus den fünf Tags in der Standardvorlage ergibt. Dies ist bei der Erstellung einer Vorlage in einem HTML-Editor sinnvoll, wenn das Standardlayout durch zusätzliche Elemente ergänzt werden soll.
- <#COMPONENT Name=WebKomponentenName> wird durch den HTML-Code ersetzt, den die Komponente WebKomponentenName generiert. Diese Komponente kann im Web-Seiteneditor hinzugefügt worden sein. Es kann sich aber auch um eine Komponente handeln, welche die Schnittstelle WebComp.IWebContent unterstützt und denselben Eigentümer wie der MIDAS-Seitengenerator hat.
- <#DATAPACKET XMLBroker=BrokerName> wird durch das XML-Datenpaket ersetzt, das von dem in BrokerName festgelegten XML-Broker übergeben wurde. Im Web-Seiteneditor enthält der vom InternetExpress-Seitengenerator erzeugte HTML-Code dieses Tag anstelle des eigentlichen XML-Datenpakets.
Zusätzlich zu diesen Tags kann eine angepasste Vorlage weitere HTML-transparente Tags enthalten, die Sie definieren. Wenn der InternetExpress-Seitengenerator auf ein Tag trifft, das nicht zu den sieben automatisch übersetzten Tags gehört, generiert er eine HTML-Vorlage.
Tipp: Die im Web-Seiteneditor angezeigten Komponenten generieren statischen Quellcode. Es wird deshalb immer derselbe HTML-Code erzeugt (sofern die in den Datenpaketen enthaltenen Metadaten nicht vom Anwendungsserver geändert werden). Damit dieser Quellcode zur Laufzeit nicht für jede Anforderungsbotschaft dynamisch erstellt werden muss, können Sie den generierten HTML-Code im Web-Seiteneditor kopieren und als Vorlage verwenden. Die Anwendung kann trotzdem Datenpakete dynamisch vom Anwendungsserver abrufen, da im Web-Seiteneditor anstelle des XML-Datenpakets das Tag <#DATAPACKET> angezeigt wird.