AndoLib Web-OPAC - technische Dokumentation - Abschnitt §3

Anpassung

3.1. Html-Templates

Das Layout wird über ein frei gestaltbares Html-Template festgelegt. Die zu präsentierenden Daten werden über Platzhalter eingebunden.

Für das Parsen der Templates wird Anandos Template Parser in der Version 4 benutzt.
 

3.2. eingebettete Funktionen und Variablen

3.2.1. Template-Funktionen und  -Funktionsparameter

Liste der im HTTP-Request per Parameter  ansprechbaren Funktionen

Liste der speziellen OPAC-ATP-Funktionen (im Template verwendbar)

3.2.2. Template-Formularvariablen und -funktionen, Input-Felder und Bedienelemente

3.2.3.    feste class-Namen zur Verwendung in den Templates

3.2.4.    Das Standard-Template

In den Allegro-Exportparamertern verwendete Klassennamen:

3.2.5.    Mechanismen zu Template-Umschalting

1. Umschaltung über API-Funktion 'display'
   Mittels sFkt=display&sATP_TplDir=(neues Verzeichnis) kann bis zum Session-Ende ein neues default-Templateverzeichnis gesetzt werden.
2. Über die Variable 'sStartPla' können in Abhängigkeit von der Plattform zu Beginn der Session sowohl Template-Verzeichnis als auch Template-Datei initial gesetzt werden. 

3.3. Konfigurationsdateien

3.3.1.  ATP-Konfiguration

Die Templates und Funktionen des AndoLib-WebOPAC werden über den Template-Parser ATP V3 ausgeführt. Dessen Konfiguration steht in einer Datei namens atp.conf.php und enthält im wesentlichen den Pfad zum Template- und Funktions-Unterverzeichnis.

Näheres kann in der Dokumentation des Template-Parsers nachgelesen werden.
 

3.3.2.  AL-OPAC-Konfiguration

Die Konfigurationsdatei al-opac.ini.php enthält die Einstellungen zum WebOPAC und den Datenbanken.
Das Format entspricht dem einer Ini-Datei mit Abschnitten.

Mit ; eingeleitete Zeilen können Kommentare enthalten
Das allgemeine Format ist Variablenname=Inhalt. Enthält der Inhalt Leerzeichen, ist er in zu setzen.

Werte aus dem Bereich [Global] werden durch gleichlautende aus den Datenbank-Abschnitten (hier im Beispiel [katalog1]) überschrieben
 

3.3.3. #u-Variablen für die formatierte Ausgabe

3.4. Allegro-Exportparameter

Die im Abschn. 4.3 aufgelisteten #u-Variablen werden an die Allegro-Exportfunktion übergeben, damit auf diese dann in den Exportparamern (*.apr bzw. *.opr-Dateien) zurückgegriffen werden kann.

3.4.1. Ergebnislisten-Parameter

Die Parameter für die Ergebnislisten werden in der Ergebnisanzeige, Merkliste und Kontoanzeige verwendet und werden mit Hilfe der OPAC-Parserfunktionen im Quelltext durch die zugehörigen Daten ersetzt.

Diese Allegro-Exportparameter stellen für jeden Datensatz eine mit [<CR>]<LF> abgeschlossene Textzeile in folgendem XML-Format zur Verfügung:

Innerhalb des SET-Tags dürfen keine Zeilenumbrüche (Codes 0a oder 10 hex) enthalten sein.

reales Beispiel:
(todo - hier Quelltext ergänzen)
Eger, Anando Der erste Test-Titel R 11 Buch 2011

• <SET>...</SET> enthält das gesamte Listenelement
• <PAR .../> enthält Statusinformationen zum Listenelement
• <CONTENT>...</CONTENT>  enthält die Inhalte der Tabellenfelder

Die Kind-Elemente von <CONTENT> können in Übereinstimmung mit dem verwendeten Template beliebig definiert werden.

Das <PAR />-Tag kann folgende Attribute besitzen:

*) Plicht-Angabe: R = für Recherche- und Benutzer-Variante, B = nur für Benutzervariante

3.4.2. Vollanzeigen-Parameter

Die Allegro-Exportparameter für die Vollanzeige stellen den Datensatz als eine einzelne mit [] abgeschlossene Textzeile in folgendem XML-Format zur Verfügung:

In dieser Zeile dürfen keine Zeilenumbrüche enthalten sein - die Umbrüche und Einrückungen oben wurden nur zur besseren Lesbarkeit eingefügt..

reales Beispiel:

Signatur : O 613

Rath, Matthias:
Warum kennen Tiere keinen Herzinfakt ... aber wir Menschen : Natürliche Vorbeugung von Durchblutungsstörungen, Herzinfarkt, Schlaganfall, Gefäßleiden bei Diabetes, Bluthochdruck, Herzschwäche, Herzrhythmusstörungen und anderen Herz-Kreislauf-Problemen / Matthias Rath. - vollst. überarb. u. erw. Neusausg. der 3. Aufl.. - AW Almelo : MR Publishing Inc., 2003. - 336 S. : Ill. (farb.)
ISBN 90-76332-54-1

3.4.3. Kontolistenparameter

wie Ergebnislisten-Parameter

3.5. Allegro-Jobs

Funktionen wie Verlängerung, Reservierung usw. werden über Allegro-Flex-Jobs für Avanti realisiert.
Diese Jobs sind als *.flb-Dateien im Include-Verzeichnis (modpar) abgelegt.

Namenskonventionen: av_al_{Funktionsname).flb
Beispiel: Die Verlängerungsfunktion renew für die O-Konfiguration ist in der Datei renew-o.flb abgelegt.

Der Aufruf bzw. die Benutzung (es sind keine Unterprogramme) erfolgt: das Setzen der Parametervariablen und über include .Zurückgelifert wirde eine Zeichenkette.
Beginnt die Zeichenkette mit einem !, ist der Text ein Fehlertext. Im Fehlerfall ist gleichzeitig das globale Fehlerobjekt $oErr gesetzt.

3.6. Stammdaten in der Datenbank

3.6.1. Anzeige der Medientypen in den Listen

Im OPAC wird als Medientyp in den Ergebnislisten immer das erste Wort der Bezeichnung aus dem Medientypstammsatz angezeigt. Diese Stammsätze lassen sich in der ÖB-Version der Allegro-Datenbank über die Einstellungen in der Benutzungsornung anpassen.

Wenn z.B. statt Digital  DVD angezeigt werden soll, schreibt man als Bezeichnung des Medientyps (in Allegro-OEB: Medienart) statt  Digital versatile Disc  DVD oder statt elektronische Spiele  Spiel elektronisch.

3.6.2. spezielle Felder in der Datenbank

Zur Darstellung von Cover- und Dateien mit Inhaltsangaben werden in den Beispiel-Templates folgende Felder verwendet:
 

3.6.3. Opac-Konfigurationssatz
 

Format:     lS;vM;dM;
            Ort:            Größe
            l - Liste        S - klein
            v - Vollanzeige  M - mittelgroß
            d - Druckliste   L - Groß

3.7 externe Authentifizierung

Sollen die Leser nicht über die Datenbank-Inhalte authentifiziert werden, lassen sich eigene Verfahren zur Anmeldung in der Datei auth.php implementieren.

Die auth.php enthält eine Funktion alo2_AuthExt($patron, $passwd), über die geregelt wird, ob die Anmeldung über die Allegro-Datenbank erfolgen soll oder über eine selbst zu schaffende Funktion über eine externe Authentifizierungsstelle (z.B. LADP)

3.8 Schema-spezifische Anpassungen

3.8.1 ÖB-Datenbanken (O-Schema)

Filter

Medienarten werden in OEB-Datenbanken (O-Schema) der Büchereizentrale Niedersachsen für Statistik-Zwecke über FILTER-Einträge im Register 9 unterschieden und/oder zusammengefasst. Die Registereinträge sind hier typisch in der Datei filter.opt definiert und dienen als Grundlage für die Auswahl der Medenarten (synonym: Medientypen). für die Sucheinschränkung im OPAC. Die Konfiguration dazu erfolgt in der Initialisierungsdatei al-opac.ini.php über die Variable sMedientypen.

Grundsätzlich können das Register und die Art der Einträge für jede Allegro-Datenbank individuell eingestellt werden.  Für Allegro-OEB (Parametrierung Brandenburger Menü) sind folgende Filter im Register 9  definiert: 

3.8.2 WB-Datenbanken ($A-Schema)

(wird noch ergänzt)

3.9 In der Katalog-Datenbank gespeicherte Einstellungen

siehe ModPar-Funktionen - Einstellungen zum AndoLib Web-OPAC
(Version 4.08)