Q-107.931

Nutzung von Server Side Includes

Frage
Problem Die so genannten Server Side Includes sind spezielle Befehle der WebBox, die an beliebiger Stelle einer HTML-Datei eingefügt werden können und bestimmte Funktionen zur Verfügung stellen.
Produkt Web und WAP Access
Priorität normal
Effekt normal
Datum 16.09.2005

Antwort
Folgende Server Side Includes können verwendet werden:
  • Dateidatum
    ##FileDate##
    Gibt das Erstellungsdatum der genannten Datei aus. Befindet sich die Datei im aktuellen Verzeichnis, braucht der Pfad nicht angegeben zu werden.

    Beispiel:
    ##FileDate VOLUME:DAVID \APPS\WEBBOX\HOME\INDEX.HTM## (NetWare)
    ##FileDate DAVID \APPS\WEBBOX\HOME\INDEX.HTM## (Windows)

  • Dateigröße
    ##FileSize##
    Gibt die Dateigröße der genannten Datei in Bytes aus. Befindet sich die Datei im aktuellen Verzeichnis, braucht der Pfad nicht angegeben zu werden.

    Beispiel:
    ##FileSize VOLUME:DAVID\APPS\WEBBOX\HOME\INDEX.HTM## (NetWare)
    ##FileSize DAVID\APPS\WEBBOX\HOME\INDEX.HTM## (Windows)
    ##FileSize INDEX.HTM##

  • Dateizeit
    ##FileTime##
    Gibt die Erstellungszeit der genannten Datei aus. Befindet sich die Datei im aktuellen Verzeichnis, braucht der Pfad nicht angegeben zu werden.

    Beispiel:
    ##FileTime VOLUME:DAVID\APPS\WEBBOX\HOME\INDEX.HTM## (NetWare)
    ##FileTime DAVID\APPS\WEBBOX\HOME\INDEX.HTM## (Windows)
    ##FileTime INDEX.HTM##

  • Archive Root Pfad anzeigen
    ##ReqRootPath##
    Gibt den kompletten Pfad des Root Archives an,wie in der Systemkonfiguration der WebBox definiert.

    Beispiel:
    SERVERNAME\VOLUME:DAVID\ARCHIVE\WWW (NetWare)
    SERVERNAME\DAVID\ARCHIVE\WWW (Windows)

  • Variablenname
    Übernimmt den übergebenen Wert der Variablen in ein Eingabefeld eines Formulars. Der Wert muss von der vorherigen HTML-Seite mit einem Hyperlink übergeben werden. Somit können Sie den Inhalt eines Eingabefeldes bereits vordefinieren.

    Beispiel:
    Eintrag in der ersten HTML-Seite:
    < A HREF="index.htm!Betreff=WebBox" >
    Eintrag in der Datei INDEX.HTM:
    < INPUT NAME=„Betreff” VALUE=##Betreff## >

    In diesem Beispiel wird die Zieldatei (INDEX.HTM) angegeben und der Variablenwert (WebBox) übergeben. Dieser Wert erscheint dann im Eingabefeld der Datei INDEX.HTM.

  • Include
    Fügt das angegebene Dokument an der aktuellen Stelle der Web-Seite ein. Hierdurch können Sie beispielsweise erreichen, dass Ihre Web-Seiten immer das gleiche Layout haben, ohne jede Seite einzeln ändern zu müssen. Nehmen Sie hierzu in der Include-Datei die globalen Formatierungen vor und tragen Sie in jeder Seite den Verweis auf diese Include-Datei ein. Änderungen an der Formatierung der Include-Datei gelten dann auch gleichzeitig für alle anderen Web-Seiten.

    Die Include-Datei wird standardmäßig in dem Include-Archive erwartet, das in der WebBox Konfiguration angegeben wurde.

    Beispiel:
    ##Include HEAD##

  • Define und Undefine
    Um die Erstellung unnötig vieler Include-Dateien mit evtl. nur geringfügigen Unterschieden zu vermeiden, können in Verbindung mit dem Befehl ##INCLUDE## so genannte Defines verwendet werden. Dabei werden im Web-Dokument mit Hilfe der Befehle ##DEFINE=## und ##UNDEF=## bestimmte Bedingungen definiert, die dann in der Include-Datei über den Befehl ##IFDEF=## abgefragt werden können. In Verbindung mit dem Befehl ##ENDIF=## ist es dann möglich, im Include-Dokument nach diesen Kriterien zu verzweigen.

    Dazu folgendes Beispiel:
    Web-Dokument: …

    ##DEFINE=deutsch##
    Preisliste Deutsch
    Produkt A : € 5,-
    Produkt B : € 8,50
    Produkt C : € 12,-
    ##INCLUDE Preise##
    ##UNDEF=deutsch##
    ##DEFINE=englisch##
    Price list English
    Product A : £ 3.-
    Product B : £ 5.-
    Product C : £ 7.-
    ##INCLUDE Preise##
    ##UNDEF=englisch##
    ...
    Include-Datei:
    ...
    ##IFDEF=deutsch##
    Alle Preise sind unverbindliche Verkaufspreise.
    Preisänderungen vorbehalten.

    ##ENDIF=deutsch##
    ##IFDEF=englisch##
    All prices are non-binding sales prices and
    subject to change
    ##ENDIF=englisch##
    ...

    Alternativ zu diesem Anwendungsbeispiel können Define- bzw. Undefine-Befehle auch direkt beim Aufruf eines Includes als Parameter übergeben werden. Dabei steht »D=« für ##DEFINE=## und »U=« für ##UNDEFINE##.

    Beispiel:
    ##INCLUDE Preise /D=englisch /U=deutsch##

    Es werden maximal 30 Defines unterstützt, wobei die ##IFDEF## Bedingungen ineinander verschachtelt werden können. Die Bedingungen hinter den Define-Befehlen dürfen eine Länge von 10 Zeichen nicht überschreiten. Der Befehl ##ENDIF=## muss zwingend in einer eigenen Zeile stehen. Es darf weder davor noch dahinter anderer Text in dieser Zeile auftauchen.

  • Anzahl der Zugriffe von einer fremden Webseite:
    ##refcount##
    Gibt die Anzahl der Zugriffe von einer fremden WebSite auf die WebBox aus. Wenn ein Anwender durch einen Link von einer externen WebSite zur WebBox gelangt, wird die Adresse dieser WebSite übergeben und erscheint im DvISE Administrator unter demMenüpunkt »WebBox/Monitor/Referer«.

    Beispiel:
    ##RefCount http://www.domain.de/index.htm##

  • Anzahl der Zugriffe durch eine IP-Adresse:
    ##IpCount#
    Gibt die Anzahl der Zugriffe durch die eingetragene IP-Adresse aus. So lässt sich feststellen, wie oft ein Browser mit der genannten IP-Adresse auf die WebBox zugegriffen hat.

    Der angezeigte Wert entspricht der Information, die Sie auch in der WebBox Konfiguration unter dem Menüpunkt »WebBox -> Monitor -> IP-Adressen« erhalten.
    Beispiel: ##IPCount 194.194.194.194##

  • Anzahl der Zugriffe auf eine Web-Seite:
    ##DocCount##
    Gibt die Anzahl der Zugriffe auf die angegebene Web-Seite aus.
    Somit lässt sich beispielsweise die Resonanz bezüglich einer Web-Seite anzeigen oder ein »Counter« integrieren. Wird kein Parameter angegeben, so bezieht sich der Zähler auf die aktuelle Seite. Optional kann der Dateiname als Parameter angegeben werden. Hierbei muss der komplette Pfad eingetragen werden. Der angezeigte Wert entspricht der Information, die Sie auch im DvISE Administrator unter dem Menüpunkt »WebBox -> Monitor -> Dokumente« erhalten. Sie können diesen Parameter auch in der Template Datei »WebText« verwenden, um auf diese Weise die bisherige Anzahl der Zugriffe direkt im entsprechenden Dokument darzustellen (Web Counter).

    Beispiele:
    ##DocCount##
    ##DocCount SERVERNAME\VOL:DAVID\...\I42FF623.001## NetWare
    ##DocCount DAVID\VOL:DAVID\...\HOME\INDEX.HTM## NetWare
    ##DocCount \\SERVERNAME\DAVID\...\I42FF623.001## Windows
    ##DocCount DAVID\...\HOME\INDEX.HTM## Windows

  • Datum
    ##Date##
    Gibt das aktuelle Systemdatum des Servers aus.

    Beispiel:
    ##Date##

  • Zeit
    ##Time##
    Gibt die aktuelle Systemzeit des Servers aus.

    Beispiel:
    ##Time##

  • DomainName
    ##Domainname##
    Gibt den Domain Namen des Servers aus. Ist kein Domainname eingetragen, so bleibt das Feld leer.

    Beispiel:
    ##DomainName##

  • CurrentConPeak
    ##CurrentConPeak##
    Gibt den Maximalwert gleichzeitiger Verbindungen aus.

  • TotalConPeak
    ##TotalConPeak##
    Gibt den Maximalwert gleichzeitiger Verbindungen seit der Installation aus.

  • TotalUpTime
    ##TotalUpTime##
    Gibt die gesamte bisherige Laufzeit der WebBox an. Die Anzeige hat das Format Tage/Stunden/Minuten/Sekunden.

  • CurrentUpTime
    ##CurrentUpTime##
    Gibt die bisherige Laufzeit der WebBox seit dem letztem Programmstart an. Die Anzeige hat folgendes Format: Tage/Stunden/Minuten/Sekunden.

  • ServerIP
    ##ServerIp##
    Gibt die IP-Adresse des Servers aus.

  • ServerPort
    ##ServerPort##
    Gibt die Port-Adresse des Servers aus.

  • TotalBytes
    ##TotalBytes##
    Gibt die Summe aller bisher übertragenen Bytes aus.

  • TotalConCount
    ##TotalConCount##
    Gibt die Summe aller Verbindungen seit der Installation aus.

  • CurrentConCount
    ##CurrentConCount##
    Gibt die Summe aller Verbindungen seit dem letzten Programmstart aus.

  • Version
    ##Version##
    Gibt die Versionsnummer der WebBox aus.

  • HomeDir
    ##HomeDir##
    Gibt das Home-Verzeichnis der WebBox aus. Dieser Eintrag entspricht der Einstellung der WebBox-Konfiguration »Konfiguration -> System -> Domain -> Domain Name«.

  • DistantIP
    ##DistantIP##
    Gibt die IP-Adresse aus, über die der Browser gerade auf die aktuelle Seite zugreift.