Skip to content

Aktualisierungsprozess für die NWBib Raumsystematik

Adrian Pohl edited this page Nov 30, 2023 · 28 revisions

Hintergrund

Die Webseite der NWBib-Raumsystematik findet sich unter https://nwbib.de/spatial, die zugrundeliegenden strukturierten SKOS-Daten unter https://nwbib.de/spatial.ttl. Die aktuelle Raumsystematik wird aus zwei Quellen generiert:

  1. aus einer manuell gepflegten SKOS-Konfigurationsdatei mit a) den Top-Level-Konzepten, b) jenen hierarchischen Beziehungen, die sich nicht in Wikidata abbilden lassen und c) Einträgen, die abweichend von den Wikidata-Daten erfasst werden müssen: https://github.com/hbz/nwbib/blob/master/conf/nwbib-spatial-conf.ttl
  2. aus den Wikidata-Einträgen mit der Property P6814 NWBib-ID inklusive – wenn vorhanden – Qualifier P4900 Übergeordneter Begriff: https://w.wiki/Bui

Die Angaben in der Konfigurationsdatei (1.) überschreiben jene aus Wikidata (2.), sollte die Beschreibung eines Ortes in beiden auftauchen.

Update-Prozess

Für die Aktualisierung der Datei inklusive Begutachtungsprozess wir der folgende Prozess anvisiert:

  1. NWBib-Redakteur*in entscheidet sich für die Ergänzung eines Ortes und ergänzt eine Aussage mit NWBib ID (P6814) bei dem entsprechenden Wikidata-Eintrag.
  2. Redakteur*in stößt einen Neuaufbau der Systematik im Testsystem an: https://test.nwbib.de/spatial (Da die Wikidata-Schnittstelle erst mit zeitlichem Verzug aktualisiert wird, funktioniert dieser Neuaufbau der Systematik im Testsystem teilweise erst am nächsten Tag.)
  3. Redakteur*in kopiert Feldinhalt aus der Test-Systematik nach Aleph.
  4. Ein automatischer Test benachrichtigt das lobid-Team, dass die Systematik erweitert wurde.
  5. lobid-Team aktualisiert die Systematik im Produktionssystem. Bei möglicherweise unerwünschten Auswirkungen wird vorher die NWBib-Redaktion konsultiert.

Der Vorteil bei diesem Ansatz ist, dass die Aktualisierung der Systematik stattfindet, nachdem die neue Systematikstelle bereits in hbz01 verwendet wurde. Somit befinden sich in der Systematik immer und nur jene Stellen, die tatsächlich verwendet werden.

Momentan sind die Schritte 1. bis 3. umgesetzt. Die Benachrichtigung über Änderungen, um den Neuafbau der Systematik zu starten findet derzeit noch über E-Mail statt.

Technischer Workflow zur Aktualisierung

Hier der Prozess zur Aktualisierung der SKOS-Datei aus Wikidata inklusive Begutachtung der Änderungen:

  1. Ticket öffnen (#542)
  2. cd lobid-vocabs; git checkout master; git pull origin master
  3. cd ../nwbib; git checkout master; git pull origin master
  4. lokal die Änderungen generieren: rm -rf ./data ; rm conf/wikidata.json ; sbt "runMain SpatialToSkos" ; cp conf/nwbib-spatial.ttl ../lobid-vocabs/nwbib/
    • ⚠ Voraussetzungen: Nutzung von Java 8 ($ sudo apt install openjdk-8-jdk, $ sudo update-alternatives --config java) und sbt (Installation)
  5. Begutachtung des diff im lokalen lobid-vocabs-Repo
  6. Wenn nötig Anpassung in Wikidata & Re-Generierung und zurück zu 1.). Falls ok folgt
  7. Push der Änderungen in den master-Branch von lobid-Vocabs
  8. Ticket in Deploy-Spalte ziehen und @fsteeg zuweisen bzw. sol@quaoar1:~/git/nwbib$ rm -rf target/universal/stage/data/elasticsearch/ ; sh restart.sh nwbib, warten auf Listening for HTTP on /0.0.0.0:8000 im log: tail -f target/universal/stage/logs/application.log
  9. Nach Deployment: Mail an Liste und Schließen des Tickets