Inhaltsverzeichnis
Benutzerhandbuch
Programminstallation und Programmstart
|
|
Um die Veranstaltungen im Internet anzeigen zu können sind drei Schritte
notwendig.
- Im ersten Schritt wird die XML Datei erstellt. Dazu muß man das Perlskript
gen_xml.pl einmal auf einem Rechner mit Verbindung zum SQL-Server aufrufen. Das
Skript generiert dann eine Datei veranstaltungen.xml.
- Die Datei wird dann im zweiten Schritt von einem Tclskript start_unix.tcl verarbeitet.
Dieses Skript legt Indexstrukturen für das CGI-Skript an, damit der Zugriff
schneller erfolgen kann.
- Im dritten und letzten Schritt muß das CGI-Skript search-cgi ins CGI-Verzeichnis
des Webservers installiert werden.
Programmteil 1
Als erstes muß ActivePerl installiert werden. Wie dies geschieht entnehmen sie
bitte der Beschreibung des Herstellers. Nach erfolgreicher Installation können nun
die beiden benötigten Perl Pakete installiert werden.
Um das Paket DBI zu installieren gehen sie in das Unterverzeichnis db_to_xml\DBI und tippen dort
ppm install dbi.ppd ein.
Um das Paket dbd-odbc zu installieren gehen sie in das Unterverzeichnis
db_to_xml\dbd-odbc und tippen dort ppm install dbd-odbc.ppd ein.
Zum Schluß müssen noch zwei ODBC Datenquellen definiert werden.
Eine ODBC-Quelle ist für die zu konvertierende Exceltabelle von Herrn
Schmitt zu definieren. Die andere ODBC-Datenquelle ist für die SQL-Server
Datenbank zu definieren.
Für die Übernahme der Exceltabelle in die SQL-Server Datenbank
wird ein Delphi Programm im Verzeichnis Excel_to_db bereitgestellt. In
den beiden Database Komponenten sind die eben definierten ODBC Datenquellen
einzutragen. Danach kann das Programm erstellt werden. Mit dem Button
Start wird die Übernahme in die Datenbank gestartet. Bevor das Programm
gestartet werden kann, muß die Exceltabelle aber noch vorbereitet werden.
Exceltabelle umsetzen
- Einfügen einer neuen Spalte nach Spalte C
- Benennen der Spalte mit dem Namen sanr
- entfernen aller Dokuzeilen innerhalb der Spalten A - AJ
- Da nicht alle Namen mit denen aus der Datenbank übereinstimmen, wurden
in der Spalte sanr manuell jeweils die passende Satznummer aus der Tabelle
Veranstaltungen eingetragen. Es konnten allerdings nicht für jede
Excelzeile eine Satznummer ermittelt werden.
- einige Veranstaltungen in der Exceltabelle scheinen doppelt zu sein !!
Im Perlskript gen_xml welches sich im Verzeichnis db_to_xml befindet
gibt es zwei Variablen, die evtl. noch angepaßt werden müssen.
Die Variable AktuellePO enthält eine Liste mit den Prüfungsordnungen,
die berücksichtigt werden. Defaultmäßig arbeitet das Skript
nur mit den jeweils aktuellen Prüfungsordnungen. In der Variablen ODBC
steht der Name der ODBC-Datenquelle für den SQL-Server.
Programm 2: XML_TO_HTML
Systemanforderungen:
Um dieses Programm einsetzen zu können, müssen Sie auf ihren Computer
die Skriptsprache TCL 8.0 oder 8.1 und einen Webserver korrekt
installiert haben. Hilfen zur Installation und Inbetriebnahme dieser Programme
finden Sie in den dazugehörigen Handbüchern. Der Name des Tcl-Interpreters
muß im Verzeichnissuchpfad des Betriebssystems vorhanden sein.
Für die Programmentwicklung ist TCL 8.0 bzw. TCL 8.1 und der
Apache HTTP Server Version 1.3 für Windows 95 eingesetzt worden.
weitere Systemanforderungen (Mindestanforderungen):
Pentium 200 (empfohlen)
40 MB Arbeitsspeicher
SVGA-Bildschirm 640 x 480 mit 256 Farben (empfohlen)
Programminstallation
Installation des TclXML-Parsers
- Kopieren Sie das Verzeichnis TclXML der Programmdiskette auf Ihre Festplatte.
Beachten Sie, daß hierbei die Verzeichnisstruktur TclXML\TclXML-1.1.1 erhalten bleibt.
Beispiel:
mount /a
cp -r /a/TclXML /meinVerzeichnis
- Fügen Sie dieses Verzeichnis in den Bibliothekssuchpfad von TCL ein.
Beispiel:
set auto_path=%PATH%;/meinVerzeichnis/TclXML (nicht TclXML-1.1.1 !)
Installation der Programmdateien
- Kopieren Sie das Verzeichnis XML_TO_HTML der Programmdiskette auf Ihre Festplatte.
(Idealerweise kopieren Sie die Dateien in das Verzeichnis, das Sie für den
CGI-Zugriff ihres Webservers freigegeben haben !)
Für die Datei search.cgi Zugriffsrechte aktivieren (nur bei UNIX)
- Wechseln Sie in das XML_TO_HTML-Verzeichnis
- Tippen Sie folgendes Kommando:
Beispiel:
chmod +x search.cgi
Webserver-Anweisung #!
- Modifizieren Sie die erste Zeile des CGI-Skripts search.cgi so,
daß die Webserver-Anweisung #! den Verzeichnispfad des Tcl-Interpreters enthält.
#!/usr/bin/tclsh8.0
Webserver konfigurieren
- Geben Sie das Verzeichnis XML_TO_HTML für CGI-Zugriffe frei
Beispiel Apache-Server:
<Location cgi-bin/projekt/programm>
AllowOverride None
Options +ExecCGI -Includes
SetHandler cgi-script
</Location>
- Starten Sie den Server erneut
XML-Datei kopieren
- Kopieren Sie die XML-Datei, in der die Vorlesungen der FH-Wedel gespeichert sind,
in das Verzeichnis XML_TO_HTML\XML_DATA\.
Programmstart
Wechseln Sie in das Verzeichnis XML_TO_HTML ihrer Festplatte
Beispiel:
cd /meinVerzeichnis/XML_TO_HTML
Erstellung der Indexdateien (Parsen der Vorlesungs-XML-Datei)
Das Vorlesungs-XML-Dokument wird geparst und die Indexstrukturen werden im
Verzeichnis /INDEX angelegt.
- Geben Sie folgende Befehlszeile in die Kommandozeile ein:
Beispiel:
tclsh81 start.tcl tclxml_path xml_datei startseite url
tclsh81 |
Name des Tcl-Interpreters |
start_dat |
Startprogramm (Tcl-Skript)
|
tclxml_path |
Pfad zum TclXML-Verzeichnis (nicht TclXML-1.1.1) |
xml_datei |
XML-Datei mit den Vorlesungen |
startseite |
Dateiname der zukünftigen HTML-Einstiegsseite |
url |
URL zur Datei search.cgi (inkl. Web-Server-Location)
Beispiel:
"http://localhost:8080/cgi-bin/projekt/programm/search-cgi"
|
Das Programm ist genau dann fehlerfrei abgelaufen, wenn die folgende Meldungen ausgegeben werden:
- XML-Dokument gelesen
- Indizes abgespeichert
- Startseite erstellt
CGI-Anfrage an das CGI-Skript stellen
- Starten SieWebservererver
- Starten Sie eWebbrowserowser
- Öffnen Sie die Einstiegs-HTML-Seite, die Sie beim Erstellen der Indexdateien angelegt haben
- Führen Sie einen Doppelklick auf den Link "START" aus
Inhaltsverzeichnis
Benutzerhandbuch