Der WWW-OPAC (Public Online Access Catalogue) von HANS ist eine Perl/CGI-basierende Applikation, die das Templating-System populo.pl benutzt. Der Zugriff auf die Daten erfolgt mittels der Avanti™-Datenbankservers von allegro-C™, die CGI-Applikation kommuniziert mit diesem über TCP/IP..

Dieser Ansatz hat zur Folge, dass insbesondere die Darstellung der Ergebnisse (Eingabemasken, Registerabschnitte, Vollanzeigen) über Templates, d.h. HTML-Seiten mit speziell formatierten Platzhaltern statt der konkreten Inhalte, gestaltet wird, zur Laufzeit werden dann für die Platzhalter die konkreten Werte (Benutzereingaben, Rechercheresultate) eingesetzt. Die Datenbank (bzw. genauer: Der Avanti-Server, der den Zugang zur Datenbank realisiert) kann, muss aber nicht auf dem Webserver installiert sein.

Die Systemvoraussetzungen im einzelnen:

Clientseitige Voraussetzung ist ein (halbwegs) standardkonformanter Webbrowser und eine Verbindung zum Internet. Die Ausführung von JavaScript™ sollte erlaubt werden.

Die Anbindung erwartet, dass Avanti alle benötigten Parameterdateien im Datenverzeichnis vorfinden kann. Zusätzlich benötigte Dateien sowie solche, die normalerweise im Programmverzeichnis liegen, sind im Unterverzeichnis htm des Programmverzeichnisses vorgehalten und müssen ins Datenverzeichnis kopiert werden.

Für die Zukunft automatisieren lässt sich dies, indem in der Konfigurationsdatei hansconf.xml zur entsprechenden Datenbank noch ein Konfigurationselement WWWAdd hinzugefügt wird:

  <section name="databases">
...
    <vardef name="wwwdemo" value="m:\h2kdbs\wwwdemo"/>      
...
  </section>
...
<section name="m:\h2kdbs\wwwdemo">                          
    <vardef name="DbDir" value="m:\h2kdbs\wwwdemo"/>
    <vardef name="DbName" value="demo"/>
    <vardef name="DbTitle" value="Demodatenbank HANS mit WWW-Parametern"/>
    <vardef name="Site" value="demo"/>
    <vardef name="ExtraOpts" value="!Stat !debug"/>
    <vardef name="WWWAdd" value="1"/>         
  </section>
...

[Ab Build 24-009:] Für eine vorhandene Datenbank kann dieser Eintrag auch über einen Befehl erzeugt werden:

%-H2k%\config\flagdb --setvar wwwdemo WWWAdd "e-oaidc.hpr e-hnsxml.hpr"

Die Installation von Avanti erfolgt gemäß der Avanti-Dokumentation http://www.allegro-c.de/doku/avanti/. Unter Win32 empfiehlt es sich dringend, den Avanti-Server als Systemdienst zu aktivieren.

In der Konfigurationsdatei avanti.conf des Avanti-Servers (im Unterverzeichnis etc der Avanti-Installation) ist eine neue Section für die zur Verfügung zu stellende Datenbank einzufügen, z.B.:

[hansplay]    
directory = d:/hans/h2kdbs/wwwdemo  
access = 0            
konfiguration = hnono 
indexparameter = demo 
opac=OPAC:0           

Der Avanti-Dienst bzw. -Daemon ist nach dem Ändern der Konfiguration ggfls. neu zu starten.

Weitere Erläuterungen in der Avanti-Dokumentation http://www.allegro-c.de/doku/avanti/.

Webserver ordnen der hierarchischen Gliederung von Pfaden in URLs (virtuelle Pfade) reale Verzeichnisse im Dateisystem des Servers (reale Pfade) zu und sind dabei relativ frei konfigurierbar. Allerdings unterscheiden sie normalerweise stark zwischen Verzeichnissen, aus denen Dateien geliefert werden dürfen und jenen, in denen Skripte oder Applikationen ausgeführt, jedoch nicht im Quelltext gezeigt werden dürfen (CGI-Verzeichnisse).

Die CGI-Skripte von HANS gehören in ein CGI-Verzeichnis, die CSS-Stylesheets und eventuelle Graphiken (für die Buttons) gehören in reguläre virtuelle Verzeichnisse. Da alle Dateien für den HANS-OPAC in einem einzigen ZIP-Archiv ausgeliefert werden (mit Unterordnern), muss entweder durch Konfiguration des Webservers oder durch Umkopieren einzelner Verzeichnisse die richtige Zuordnung zu "CGI" bzw. "regulär" vorgenommen werden.

Da die HANS-Anbindung unter populo.pl aus mehreren Dateien und Unterverzeichnissen besteht, empfiehlt es sich aus Gründen der Übersicht, diese in ein separates Verzeichnis zu legen und nicht mit bereits vorhandenen CGI-Applikationen zu mischen. Sofern nicht andere Überlegungen dagegen sprechen, kann aber dazu geraten, werden, mehrere Datenbankanbindungen unter populo.pl durchaus in dasselbe Verzeichnis zu installieren.

Der Administrator des Webservers muss unabhängig voneinander folgende Entscheidungen treffen:

Anhand dieser Entscheidungen wird der Administrator ein reales Verzeichnis für die Installation festlegen und dafür sorgen, dass Perl-Skripte in diesem Verzeichnis unter einer bestimmten URL aufrufbar sind.

	Obacht für Apache-Anwender: Skripte, die populo.pl nutzen, sind CGI-Applikationen, keine mod_perl™-Anwendungen!

	Im IIS von Microsoft und anderen Webservern ist darauf zu achten, dass dieses virtuelle Verzeichnis ein "Wurzelverzeichnis für Web-Applikationen" oder "Ausgangspunkt für Anwendungen" ist. Falls sich das nicht einfach einstellen lässt, können Sie alternativ in den CGI-Skripten folgenden kryptischen Code als zweite Zeile der Datei einfügen: BEGIN { ($0 =~ m=^(.*)[/\\][^/\\]+=) && chdir $1 };

In dieses Verzeichnis muss nun populo.pl™ installiert werden sowie die eigentliche HANS-Anbindung:

	Unter U**X-Betriebssystemen ist mit "unzip -a" zu entpacken, damit die Zeilenumbrüchen in den Skripten auf die richtige Konvention eingestellt werden.

Es ist gängige Praxis, parallel zu einem Populo-Interface xy.pl noch ein "diagnostisches" Interface xy2.pl aufzusetzen. Die beiden Skripte sollten identisch sein, bis auf die Setzung von $Debug und das Aktivieren der Belegung von @WantDebug (vgl. die mit "$$" gekennzeichneten Stellen in hansdemo2.pl . Gerade beim Aufsetzen einer neuen Datenbank erleichtern die diagnostischen Funktionen die Fehlersuche ungemein. Die Empfehlung ist nun, ausgehend vom diagnostischen Interface xy2.pl alle Einstellungen und Anpassungen zu testen und erst abschliessend xy2.pl auf xy.pl zu kopieren und dort dann erst $Debug=0 (und $Border=0) einzustellen.

Wenn Sie eine Kopie des Skripts hansdemo.pl unter dem Namen xy.pl (oder – je nach Betriebssystem und Fähigkeiten des Webservers – xy.cgi oder xy ohne Extension) erstellen, so wird es bei Ausführung versuchen, die Avanti-Datenbank xy unter dem Avanti-Server auf seinem Standardport 4949 auf dem lokalen Rechner anzusprechen, dabei wird der Standard-Avanti-Benutzer opac mit Password opac benutzt. Unter günstigen Bedingungen ist Ihre Datenbank dann also sofort ansprechbar.

Falls Konfigurationseinstellungen notwendig sind und (dies ist die Regel) weitere Anpassungen anfallen, gehen Sie bitte wie folgt vor: Kopieren Sie die "externe" Konfigurationsdatei hansgenerisch.conf nach xy.conf und nehmen dort Ihre Anpassungen vor. Es wird empfohlen, nach Abschluss der Anpassungsarbeiten aus der Datei xy.conf alle nicht genutzten (also Kommentar gebliebenen) Einstellungen zu löschen, damit die tatsächlich vorgenommenen Abänderungen zum Standard besser sichtbar sind.

Nehmen Sie möglichst keine Änderungen am Stylesheet hans-opac.css vor, sondern kreieren Sie eine eigene css-Datei, die als erste Anweisung(en) ggfls. Ihr globales Stylesheet und anschliessend hans-opac.css importiert (vgl. hansdemo.css für die Demo-Datenbank), Die URL dieses Stylesheets muss dann in xy.conf angegeben werden (vgl. die Anbindung von hansdemo.css in hansdemo.conf). Alternativ können Sie in xy.conf auch das Einbinden mehrerer Stylesheets konfigurieren.

Der Einführungstext in hansdemo_cf/text/intro.htm muß gewiss angepasst werden. Alternativ können Sie einen völlig freien, eigenen Text entwerfen, dessen URL Sie dann in xy.conf in den Variablen $ForceStaticHSIntro und $ForceStaticHSUsage vermerken. Da dieser Text dann nicht mehr unter Kontrolle von populo präsentiert wird, müssen Sie in eventuellen Verlinkungen auf den Katalog dessen URL (im Beispiel /<Ihr/Virtueller/Pfad>/xy.pl explizit eingetragen werden.