Syntax
Dieses Dokument beschreibt den Aufbau der Templates von EDPweb.
Allgemeines
Die Templates von EDPweb werden alle im Unterordner „html“ gespeichert. Es ist zu empfehlen, für jede Seite in diesem Unterordner einen weiteren Unterordner mit eindeutiger Namensbezeichnung zu erstellen.
Templatedateien sollten möglichst auf die Dateiendung *.htm aufweisen.
Die CSS-Bibliothek basiert auf der Metro-UI CSS. Eine erweiterte Dokumentation dazu ist unter www.metroui.org einzusehen.
Tags in den Templates in EDPweb
Im Folgenden werden die unterstützten Tags in den Templates von EDPweb beschrieben. Im Allgemeinen werden die Tags durch {} Klammer-Zeichen umrahmt.
Allgemeine Tags
{LAGEID} – Gibt die ID der aktuell ausgewählten Lage (Tabelle LF_LAGEN) an. Ist keine Lage aktiv, ist der Wert -1.
{VERSION} – Gibt die aktuelle Versionsnummer von EDPweb aus.
{MELDUNG} – Wird von der geladenen Seite eine Hinweismeldung übergeben, so wird diese hier ausgegeben. Ansonsten wird dieser Tag gelöscht.
{DATUM} – Gibt das aktuelle Datum aus.
{UHRZEIT} – Aktuelle Uhrzeit
{ORGANISATION} – Name der Organisation, auf die EDPweb registriert ist.
{FUNKTION} – Funktion des angemeldeten Benutzers.
{BENUTZER} – Name des Benutzers
{SEITENTITEL} – Seitentitel innerhalb der Masterseite (siehe 2.6)
Andere Template-Datei einbinden
Über den Tag {inc}Dateiname{/inc} können Sie eine andere Datei in das Template einbinden. Dabei muss der Dateiname dem lokalen relativen Pfad im Unterordner „html“ entsprechen. Die darüber eingefügte Seite wird nun vor dem Einfügen wie unter 3. beschrieben prozessiert. Es wird also die schon komplett erstelle Seite in die bestehende Template-Datei eingefügt. Übergebene Parameter werden 1:1 übernommen.
Einbindung in Master-Seite
Um die Gestaltung der Templates möglichst einfach zu gestalten, sollte der Inhalt immer an einer bestimmten Stelle innerhalb einer Masterseite eingefügt werden. Die Master-Seite entspricht quasi Header und Footer. Dazwischen wird der Inhalt der Template-Seite eingefügt. Daher sollte die Template-Seite auch keine <html>, <header> und <body> Tags enthalten, da diese Bestandteil der Masterdatei sind.
Die Masterdatei verknüpfen Sie über den Tag {master}Dateiname{/master}. Dieser Tag kann überall in der Templatedatei stehen und wird automatisch erkannt.
Innerhalb der Master-Seite müssen Sie den Tag {content} platzieren. Dort wird dann der Inhalt der eigentlichen Template-Datei ausgegeben. Auch die Masterdatei wird zu Beginn wie unter 3.) beschrieben komplett prozessiert, so dass auch diese mit Tags versehen werden kann.
Parameter übernehmen
Übergebene Parameter können in EDPweb über den Tag {$Parameter} ausgegeben werden.
SQL Abfragen
In EDPweb können Sie innerhalb des Tags {sql} eine SQL-Abfrage mit Zugriff auf die EDP-Datenbank erstellen. Innerhalb des Tags schreiben Sie zunächst die SQL-Abfrage. Anschließend wird ein | platziert. Danach erfolgt noch innerhalb des SQL-Tags die Definition, wie ein einzelner Datensatz der Abfrage ausgegeben werden soll. Pro in der Abfrage enthaltenem Datensatz, wird dies dann in das fertige Template eingefügt. Den Inhalt eines Datenfeldes geben Sie hier über %FELDNAME% aus. Auch innerhalb dieser Definition können Sie die normalen Tags von EDPweb nutzen.
Beispiel
{sql}SELECT * FROM EINSAETZE|<a href=“service.html?showsite=einsatz&nr=%EINSATZNUMMER%“> %EINSATZNUMMER%</a> <br>{/sql}
In diesem Beispiel werden alle Einsätze untereinander mit Ihrer Nummer aufgelistet und können per Link geöffnet werden.
Möchten Sie innerhalb einer SQL-Abfrage eine weitere SQL-Abfrage einbauen, so ist dies prinzipiell möglich. Sie müssen hier allerdings statt {sql} {innersql} verwenden.
Der Seitentitel
Da im Standard-Template der Seitentitel innerhalb der Masterseite definiert ist, muss dieser Titel aus dem Template zur Masterseite übergeben werden. Dazu kann in der Masterseite der Tag {SEITENTITEL} gesetzt werden. Hier wird dann der Seitentitel ausgegeben.
Innerhalb der Template-Seite definieren Sie den Seitentitel wie folgt:
<!– Titel:SEITENTITEL –>
Hinterlegte Dateien anzeigen
{file"C:\EDP\test.doc"}
{file"C:\EDP\testordner"}
Zeigt den Inhalt eines Ordners oder den Link zu einer Datei an. Dabei wird zusätzlich zu jedem Button noch eine Tabellenzeile (
<tr><td><button....</td></tr>
) mitgeliefert.
Bedingte Anweisung (IF)
Über IF-Bedingungen kann angegeben werden, dass gewisse Inhalte nur ausgegeben werden, wenn eine bestimmte Bedingung erfüllt ist. Üblicherweise wäre die Bedingung, ob ein Datenbankfeld einen gewissen Wert enthält oder nicht. Die Syntax der IF-Abfrage sieht wie folgt aus:
Bedingung Feld muss bestimmten Wert haben:
{if}"%FELD%"=="WERT"{then}Text der ausgegeben werden soll, wenn die Bedingung erfüllt ist{endif}
Bedingung Feld darf bestimmten Wert nicht haben:
{if}"%FELD%"<>"WERT"{then}Text der ausgegeben werden soll, wenn die Bedingung erfüllt ist{endif}
Prozessierung einer Template-Seite in EDPweb
Erfolgt über „Showsite“ der Aufruf einer Template-Seite in EDPweb, so wird diese Templateseite nach einem definierten Prozess erstellt. Kenntnisse über diesen Prozess sind wichtig, um die Tags in den Templates richtig einzubauen.