GOK

Importiert Daten aus Fächerhierarchien und zeigt sie in einem Content-Element an. Die Fächerhierarchien können in einer CSV-Datei hinterlegt werden. Für die SUB Göttingen ist ein automatischer Import aus dem Opac implementiert.

Die Hierarchien können als Baum, Spalten oder Menüs dargestellt werden. Es gibt Scheduler Tasks, um die benötigten Daten automatisch neu zu importieren.

Grundeinstellungen im Extension Manager

Wird die Extension im TYPO3 Extension-Manager ausgewählt, gibt es zwei Grundeinstellungen:

Opac Base URL with trailing /: Aus dieser URL werden die Links in den Opac gebaut. [Standardwert: https://opac.sub.uni-goettingen.de/DB=1/]
replace included CSS with path: Pfad einer eigenen CSS-Datei für die Baum- und Menüdarstellung [Standardwert: leer, die CSS-Datei der Extension wird genutzt]

Einstellungen für das Content Element

Jeder Seitenhinhalt mit GOK Plug-In hat drei Einstellungsmöglichkeiten:

Startknoten: Der Startknoten kann auf zwei Arten festgelegt werden:
1. ‘Fachhierarchie beginnen mit’: Knoten der oberen 2 Ebenen der Hierarchie auswählbar
2. ‘Notation(en) für die Startknoten angeben’: Eine durch Komma getrennte Liste der Notationen für die Anzeige eingeben
Anzeigestil:
1. Baum – hierarchische Baumstruktur
2. Spalten – hierarchische Struktur als Spalten abgebildet. Nach Auswahl eines Themengebietes, werden dessen Untergebiete in einer neuen Spalte angezeigt.
3. Menüs – es erscheint ein Menü mit den Untergebieten. Nach Auswahl eines Menüpunktes erscheint ein weiteres Menü mit den Untergebieten des ausgewählten Faches.
GOK-ID anzeigen: hiermit kann die Anzeige der GOK-IDs wie ‘IA 663’ an- bzw. abgestellt werden

Weitere Einstellungsmöglichkeiten mit TypoScript plugin.tx_nkwgok_pi1.

shallowSearch konfiguriert die Art der Kataloglinks, die im Anzeigestil ‘Baum’ verwendet werden:
- 0 [Standard]: Suche nach Büchern aller Kindelemente des GOK-Datensatzes
- 1: Suche nach Büchern speziell zu dieser GOK
menuInlineThreshold [2]: Hat ein Element im Anzeigestil ‘Menü’ höchstens so viele Kindelemente, werden diese Kindelemente direkt im Menü der übergeordneten Ebene angezeigt.

Datenimport im Scheduler

Die Extension kann aus zwei Quellen Fachhierarchien importieren:

Durch Auslesen der GOK Normdaten (Tev)-Sätze im XML-Format aus dem Opac
Über CSV-Dateien mit den zu importierenden Informationen

Hierfür gibt es verschiedene TYPO3 Scheduler Tasks, die die notwendigen Schritte durchführen.

Beim Ausführen der Tasks auftretende Fehler werden in das TYPO3 Developer Log geschrieben.

1+2+3: GOK Daten laden, konvertieren und importieren

Dieser Scheduler Task führt die anderen drei Scheduler Tasks in der benötigten Reihenfolge aus:

GOK Daten aus Opac laden
CSV Dateien laden und zu XML konvertieren
GOK XML Dateien importieren

Im regulären Betrieb sollte dieser Task gelegentlich regelmäßig, z.B. einmal wöchentlich, ausgeführt werden. Wegen der vielen Zugriffe auf Opac und TYPO3 Datenbank, erscheint eine Ausführung abseits der starken Nutzungszeiten sinnvoll.

auto 2+3: Prüfen, ob die CSV Dateien aktualisiert wurden und konvertieren/reimportieren wenn sie es sind

Dieser Scheduler Task prüft, ob es zu allen CSV Dateien in fileadmin/gok/csv/ entsprechende XML Dateien in fileadmin/gok/xml/ mit einem neueren Änderungsdatum gibt. Ist dies nicht der Fall, werden die CSV Dateien erneut konvertiert und alle XML Daten nenu importiert.

Dieser Scheduler Task kann häufig aufgerufen werden, damit Änderungen an den CSV Dateien schnell auf der Seite verfügbar sind.

2+3: CSV Dateien konvertieren und alle XML Dateien neu importieren

Dieser Scheduler Task führt nur die bei einer Aktualisierung der CSV Dateien nötigen Schritte aus:

CSV Dateien laden und zu XML konvertieren
GOK XML Dateien importieren

1: GOK XML-Daten importieren

Dieser Scheduler Task lädt die GOK (Tev) Normdatensätze sowie die Anzahl der Treffer pro GOK aus dem Opac.

Die Abfrage für die Normdaten ist MAK tev NOT LKL p*, also alle GOK Normdatensätze außer denen, deren GOK mit P beginnt. Der Bereich P (Geschichte) liegt in einer verfeinerten Fassung as CSV Datei vor (Ansprechpartner hierfür ist Herr Enderle).

Die geladenen Daten sind im XML-Format des Opac (URL-Optionen XML=1/PRS=XML) und enthalten Pica-Daten. Sie werden im Ordner fileadmin/gok/xml/ abgelegt. Der Inhalt dieses Ordners wird beim Start des Scheduler Tasks gelöscht.

Die Abfrage der Trefferzahlen geschieht über ein Browsing der LKL und MSC Indexe. Die resultierenden XML Dateien werden im Ordner fileadmin/gok/hitcounts/ abgelegt. Der Inhalt dieses Ordners wird beim Start des Scheduler Tasks gelöscht.

2: CSV Daten laden und zu XML konvertieren

Dieser Scheduler Task konvertiert spezielle CSV-Dateien mit Fachinhierarchie Informationen in das Pica-XML Format.

Solche CSV-Dateien liegen momentan vor für:

das Fach Geschichte (GOK P*) mit einer feinsinnigeren Aufteilung als die reine GOK
SSG-FI Guides
Neuerwerbungslisten

Eingabedateien kommen aus zwei Quellen:

können CSV Dateien heruntergeladen werden. Hierzu muß:
1. im Setup der Root-Seite der Site ein Array der zu ladenden Dateien in der TypoScript Einstellung plugin.tx_nkwgok_pi1.downloadUrl hinterlegt werden.
  
  Beispiel:
```
 plugin.tx_nkwgok_pi1.downloadUrl {
 	Neuerwerbungen = http://aac.sub.uni-goettingen.de/fileadmin/gok/csv/AACNeuerwerbungen.csv
 	NeuerwerbungenHist = http://aac.sub.uni-goettingen.de/fileadmin/gok/csv/AACNeuerwerbungenHistory.csv
 	NeuerwerbungenLit = http://aac.sub.uni-goettingen.de/fileadmin/gok/csv/AACNeuerwerbungenLiterature.csv
 }
```
2. in den Optionen des verwandten Scheduler-Tasks die ID der Root-Seite eingetragen sein
Mit diesen Einstellungen werden die Dateien an den hinterlegten URLs beim Ausführen des Scheduler Tasks in den Ordner fileadmin/gok/csv geladen und ersetzen dabei ältere Dateien mit denselben Namen.
können CSV Dateien im Ordner fileadmin/gok/csv hinterlegt werden. Ihre Dateinamen sollten sich nicht mit denen aus Schritt 1 überschneiden.

Dateiformat: Als Spaltentrenner wird ein Semikolon (;) erwartet, Spalteninhalte können von Anführungszeichen (") umschlossen sein.

Jede Zeile muß mindestens 3 Spalten enthalten:

PPN des Datensatzen (wie 003@ $0 in Tev-Sätzen)
PPN der Eltern-GOK (045C $9)
deutscher Name der GOK (045A $j)
CCL Suchabfrage für diesen Eintrag [möglicherweise leer/nicht vorhanden] Stücke dieser Suchabfragen haben die Form Suchschlüssel=Begriff?. Sie können geklammert und mit and, not und or verbunden werden. Es ist wichtig, für die Suchschlüssel dieselbe Groß- und Kleinschreibung wie in den pazpar2 Einstellungen zu verwenden (unsere Konvention: Kleinbuchstaben).
englischer Name der GOK (044F $a) [möglicherweise leer/nicht vorhanden]
komma-separierte Liste von Tags zur beliebigen Nutzung [möglicherweise leer/nicht vorhanden]

Ausgabedateien: Die CSV-Dateien werden zunächst in XML-Dateien im Format der Pica-Opac-Ausgabe umgewandelt. Die umgewandelten Dateien werden in den Ordner fileadmin/gok/xml/ geschrieben, der Dateiname ist der der Ausgangsdatei, in dem das abschließende ‘csv’ durch ‘xml’ ersetzt ist.

3: GOK XML Daten importieren

Überschreibt die Daten in der GOK Tabelle in der TYPO3-Datenbank und mit neuen Daten aus den XML-Dateien in fileadmin/gok/xml/*.xml.

Die Dauer dieses Imports hängt von der Anzahl der Datensätze, der Rechnergeschwindigkeit und der Datenbankanbindung ab. Für den Import aller aller 40000 GOK-Normsätze werden typischerweise 30-300 Sekunden benötigt.

dsimm / typo3-nkwgok

GOK