Coming soon

• IIIF Manifeste mit nur einem Bild

• Neue Widgets für Download, Metadaten, Links und Zitieren

• Live-Aufbereitung von Inhalten

• Überarbeitung von EAD Strukturen

Entwicklungen

Solr

Die größte Änderung im Februar hat unter der Haube stattgefunden. Apache Solr wurde auf die Version 9.5.0 aktualisiert. Damit wird endlich eine aktuelle Version der Software eingesetzt.

Merkliste

Bei der Absicherung des E-Mailversands war uns eine Stelle noch durch die Lappen gegangen. Hier wurden wir im Februar auf die Möglichkeit zum Versand von Merklisten aufmerksam gemacht. Auch dieser Bereich ist jetzt mit einer Sicherheitsabfrage gesichert.

Stöbern

Für die Stöbern Funktionalität gibt es jetzt das neue, optionale Attribut skipInWidget="true". Das führt dazu, dass ein fürs Stöbern konfiguriertes Feld nicht im Widget angezeigt wird. Allerdings steht es weiterhin für das Stöbern-Element auf CMS-Seiten zur Verfügung. Dadurch können individuelle CMS-Stöbern Seiten angelegt werden.

Goobi viewer Indexer

Im Goobi viewer Indexer gab es zwei nennenswerte Entwicklungen:

1. Es können Namen von METS Dateigruppen konfiguriert werden, die - bei Vorhandensein - für die Indexierung von Bilddateipfaden verwendet werden. Siehe dafür auch den Schalter mets/preferredImageFileGroup

2. Durch einen Fehler in der Logik wurden teilweise Werke gelöscht, wenn eine CMS-Seite, die mit einem Werk verknüpft war, depubliziert wurde. Dieser Fehler wurde behoben.

Snippets

• Auch die Docker Container laufen jetzt komplett mit Java 17

Codeanalyse

Die folgenden Screenshots zeigen die SonarCloud Analyse des aktuellen Releases. Weitere Informationen gibt es direkt auf der Projektseite.

Versionsnummern

Die Versionen die in der pom.xml des Themes eingetragen werden müssen um die in diesem Digest beschriebenen Funktionen zu erhalten lauten:

<dependency>
    <groupId>io.goobi.viewer</groupId>
    <artifactId>viewer-core</artifactId>
    <version>24.02.2</version>
</dependency>
<dependency>
    <groupId>io.goobi.viewer</groupId>
    <artifactId>viewer-core-config</artifactId>
    <version>24.02</version>
</dependency>
<dependency>
    <groupId>io.goobi.viewer</groupId>
    <artifactId>viewer-connector</artifactId>
    <version>24.02</version>
</dependency>

Der Goobi viewer Indexer hat die Versionsnummer 24.02 Das Goobi viewer Crowdsourcing Modul hat die Versionsnummer 24.02

Coming soon

• Solr 9

• IIIF Manifeste mit nur einem Bild

• Neue Widgets für Download, Metadaten, Links und Zitieren

• Live-Aufbereitung von Inhalten

Ankündigungen

Entwicklungen

Core

Der Januar war vor allem geprägt von dem Einspielen von Updates auf Kundensystemen und den Arbeiten darum herum. Deswegen gibt es keine nennenswerten Feature-Entwicklungen sondern vor allem Bugfixes.

Im Hintergrund gab es in der letzten Zeit dennoch viele Änderungen, die in dem Januar Digest Erwähnung finden sollen. Die Offensichtlichste ist, dass wir auf Java 17 geschwenkt sind. Das bedeutet, dass der Goobi viewer mit einer aktuellen Java Version kompiliert und auch betrieben werden muss. Die Umstellung ist zum Beispiel dafür notwendig, um auch in Zukunft aktuelle Java-Libraries einsetzen zu können. Nur so kann die Applikation aktuell gehalten und schnell auf etwaige Sicherheitslücken reagiert werden.

Außerdem wurden die automatischen Unit Tests auf JUnit 5 migriert. Auch hier kommt damit eine aktuelle Technologie zum Einsatz.

Zuletzt arbeiten wir im Hintergrund daran bestimmte stilistische Code-Konventionen zu erfüllen. Dafür haben wir das Tool Checkstyle in der CI-Pipeline im Einsatz. Über die vergangenen Monate konnten bereits tausende Anmerkungen bearbeitet und korrigiert werden, so dass nun nur noch knapp 200 übrig sind. Auch diese Violations werden wir in den nächsten Monaten noch weiter reduzieren um dann in Zukunft einen einheitlichen Programmierstil über den gesamten Quelltext hinweg sicherzustellen.

Codeanalyse

Die folgenden Screenshots zeigen die SonarCloud Analyse des aktuellen Releases. Weitere Informationen gibt es direkt auf der Projektseite.

Versionsnummern

Die Versionen die in der pom.xml des Themes eingetragen werden müssen um die in diesem Digest beschriebenen Funktionen zu erhalten lauten:

<dependency>
    <groupId>io.goobi.viewer</groupId>
    <artifactId>viewer-core</artifactId>
    <version>24.01.7</version>
</dependency>
<dependency>
    <groupId>io.goobi.viewer</groupId>
    <artifactId>viewer-core-config</artifactId>
    <version>24.01</version>
</dependency>
<dependency>
    <groupId>io.goobi.viewer</groupId>
    <artifactId>viewer-connector</artifactId>
    <version>24.01</version>
</dependency>

Der Goobi viewer Indexer hat die Versionsnummer 24.01.2 Das Goobi viewer Crowdsourcing Modul hat die Versionsnummer 24.01.1

Coming soon

• Suchmaschinenoptimierung

• Live-Aufbereitung von Datensätzen

Ankündigungen

Entwicklungen

Karten

Die Karten im Goobi viewer Backend haben jetzt Featuresets. Damit können verschiedene Markertypen auf einer Karte gesetzt werden. Das können manuell gesetzte Orte sein, aber auch eine Kombination aus mehreren verschiedenen automatisch generierten Solr-Treffersets kann entsprechend angezeigt werden.

Entwickelt wurde diese Funktionalität für das Lëtzebuerger Konschtlexikon. Hier können zum verschiedene Ortstypen auf einer Karte in unterschiedlichen Farben visualisiert werden. Hier ein Beispiel:

Die Karte kann auf der folgenden Seite in einem Goobi viewer betrachtet und ausprobiert werden:

Für die Verbesserung der Performance von Karten wurde weiter eine Hintergrundaufgabe implementiert, die die Karten automatisch vorgeneriert und cached.

Goobi viewer Indexer

Der Goobi viewer Indexer unterstützt jetzt auch die Indexierung von Metadaten aus einer METS/MARC Sektion. Es sind keine weiteren Einstellungen dafür notwendig, es reicht in der config_indexer.xml die entsprechenden XPATH Ausdrücke bei den Feldern zu definieren.

Snippets

• Der Client wurde aktualisiert um eine Chromium WebP Sicherheitslücke zu schließen.

Codeanalyse

Versionsnummern

Die Versionen die in der pom.xml des Themes eingetragen werden müssen um die in diesem Digest beschriebenen Funktionen zu erhalten lauten:

Der Goobi viewer Indexer hat die Versionsnummer 23.10.1 Das Goobi viewer Crowdsourcing Modul hat die Versionsnummer 23.10

Coming soon

• Überarbeitung von EAD Strukturen

• technische Metadaten aus Bildern

• S3 Speicher

• zugriffsbeschränkte Metadaten

Entwicklungen

Backend: Themes

Im Goobi viewer Backend gibt es die Möglichkeit Themes zu konfigurieren. Bereits seit längerem kann dort mit der Quick CSS Funktionalität das CSS des Goobi viewers überschrieben werden. Mit diesem Release kommen in dem Bereich verschiedene kleinere Veränderungen und Verbesserungen hinzu.

Zum einen wurde auch ein Quick JS eingeführt, so dass auch JavaScript Code im Theme gesetzt werden kann. Damit kann zum Beispiel eine generische Core Funktionalität themespezifisch konfiguriert werden. Zum anderen wurde für das Quick CSS wie auch für das Quick JS CodeMirror eingebunden. Damit steht ein Syntaxhighlighting zur Verfügung, mit dem auch Syntaxfehler einfacher erkannt werden können.

Zuletzt wurde auch bei der Logik der Einbindung in die Templates gearbeitet. Gibt es ein Haupt- und Subthemes, dann taucht ab sofort das Quick CSS und Quick JS aus dem Haupttheme auch in den Subthemes auf. Das war vorher nicht der Fall und jede Änderung die global gültig war, musste in jedem Subtheme einzeln hinterlegt werden.

Facettierung

Sofern in der Facettierung ein einfaches "Ja/Nein" angeboten wird, zum Beispiel "Bilder vorhanden Ja/Nein" oder "Volltext vorhanden Ja/Nein", kann diese Facette jetzt vom type="boolean" definiert werden. Anschließend wird nicht mehr die klassische Listenauswahl angezeigt, sondern zwei Buttons mit denen die Auswahl an- oder abgewählt werden kann.

ALTO

Mit Named Entities angereichertes, getaggtes ALTO, wird im Goobi viewer schon lange unterstützt. Dabei werden die verschiedenen Entitäten farblich hervorgehoben. Neu ist, dass wir jetzt auch mit Normdaten angereicherte Named Entities unterstützen. Ist das vorhanden, wird über eine Unterstreichung visuell hervorgehoben, dass man das Wort anklicken kann. Es öffnet sich daraufhin ein Popover, aus dem heraus entweder der verlinkte Normdatensatz in dem bekannten Overlay angezeigt, oder alternativ eine Suche nach anderen Stellen mit dem Normdatensatz ausgelöst werden kann.

CMS

Für das Erstellen von CMS-Seiten gibt es jetzt drei neue Elemente: Suchschlitz, Trennlinie und Text (zweispaltig).

Dem Suchschlitz kann eine optionale Überschrift mitgegeben werden, zeigt aber ansonsten einen Suchschlitz an, mit dem eine globale Suche ausgelöst werden kann.

Die Trennlinie kann eingesetzt werden, um Abschnitte auch visuell stärker voneinander abzusetzen.

Der Text (zweispaltig) zeigt den eingegebene Fließtext automatisch in zwei Spalten an.

Slider

Die integrierte Slidervorschau wurde überarbeitet und wertet jetzt das Frontend-Styling aus. Außerdem ist es möglich die Breite der Vorschau dynamisch zu ändern, um so die Darstellung auf verschiedenen Bildschirmgrößen direkt testen zu können.

Barrierefreiheit

Zur Verbesserung der Barrierfreiheit sind verschiedene Änderungen in den Core eingeflossen. Die größte Änderung betrifft die Slider, die nun über ein Update der verwendeten Javascript Library erstmals barrierefrei sind. Ergänzend wurden dort noch übersetzte Sprachvariablen zur besseren Orientierung eingepflegt. Außerdem wurden in der Sprachumschaltung die Links zu Buttons geändert, da hier semantisch gesehen mehr die Aktion: "Ändere die Sprache" ausgeführt wird als das "Lade die Seite neu". Letzteres passiert zwar, ist aber nur eine Folge der Aktion. Schlussendlich wurden auch weitere aria-label oder alt Attribute ergänzt oder unnötige title Attribut entfernt. Die Bedienbarkeit vom Widget Chronology wurde genauso verbessert wie die Kompatibilität von Screenreadern im Bereich von Suchtreffergruppen sowie dem Highlighting innerhalb von Suchtreffern.

Goobi viewer Indexer

Es gibt eine signifikante Performanceverbesserung bei der Indexierung von EAD Dateien nachdem wir eine 70MB große EAD Datei mit über 140.000 Knoten zum Testen bekommen haben. Diese wird jetzt in unter 30 Sekunden verarbeitet. Dieselbe Logik ist auch für andere Metadatenformate implementiert aber wir sind uns nicht sicher ob die Verbesserung hier auch spürbar oder eher theoretischer Natur ist.

Snippets

• Core: Bei dem Feedback Formular wird jetzt der reply-to Header auf den Absender des Feedbacks gesetzt.

• Core: Bei der Definition von Karten im Backend gab es kleinere Anpassungen am Wording und den Hilfetexten.

• Core: Die unscharfe Suche wird jetzt bei neuen Suchanfragen konsequent zurückgesetzt. Vorher kam es teilweise zu unerwünschten Verhalten.

• Connector: Für die OAI Schnittstelle wurden verschiedene kleine Anpassungen für eine verbesserte Validierung der ausgelieferten Ergebnisse vorgenommen.

Codeanalyse

Versionsnummern

Die Versionen die in der pom.xml des Themes eingetragen werden müssen um die in diesem Digest beschriebenen Funktionen zu erhalten lauten:

Der Goobi viewer Indexer hat die Versionsnummer 24.05 Das Goobi viewer Crowdsourcing Modul hat die Versionsnummer 24.05

Coming soon

• Karten

• Suchmaschinenoptimierung

• Live-Aufbereitung von Datensätzen

Entwicklungen

Suche in CMS-Seiten

Die Textinhalte von CMS-Seiten können optional mit indexiert werden, so dass sie in einer Suche gefunden werden. Dafür wurde der Goobi viewer Indexer entsprechend erweitert und im Goobi viewer Backend steht im CMS-Bereich bei der Bearbeitung von CMS-Seiten ein neues Widget zur Verfügung, bei dem die Indexierung der Textinhalte aktiviert werden kann.

Ist eine CMS-Seite einer Kategorie zugeordnet, wird diese als Publikationstyp angezeigt. Dadurch kann zwischen verschiedenen CMS-Seitentypen wie zum Beispiel FAQ Fragen und Antworten oder Projektseiten unterschieden werden. Ist eine CMS-Seite keiner Kategorie zugewiesen wird sie als "CMS-Seite" angezeigt.

Sofern ein Element "Vorschaubild" auf der CMS-Seite enthalten ist, wird das Bild in den Suchtreffern angezeigt, wenn die indexierten Inhalte gefunden werden.

Suchtreffergruppen

Neu ist die Entwicklung der Suchtreffergruppen. Sofern aktiviert, können Suchtreffer in einzelne Abschnitte aufgeteilt werden. Im folgenden Beispiel gibt es vier Suchtreffergruppen: LIDO Datensätze, Monographien, CMS-Seiten der Kategorie Stories und CMS-Seiten der Kategorie Exhibitions.

Sind Suchtreffergruppen aktiv, wird die eingegebene Suche nur über die jeweils konfigurierten Teilbestände durchgeführt. Sind Treffer auch in nicht konfigurierten Gruppen enthalten werden diese nicht angezeigt.

Pro Suchtreffergruppe kann festgelegt werden, wie viele Treffer in der Gruppenübersicht angezeigt werden sollen bis ein "Alle durchsuchen" Link gerendert wird.

Konfiguration:

Hier eine Sneak Preview wie das ganze in einem Theme aussieht:

Suchtrefferperformance

In der Suche des Goobi viewers werden immer komplette Werke / Objekte / Datensätze gefunden. Darin enthalten sind eventuelle Untertreffer von verschiedenen Typen, zum Beispiel Volltext. Dieser Bereich wurde aufgeräumt und von der verwendeten Technologie vereinfacht. Dadurch konnte die Performance gesteigert und Komplexität verringert werden.

Coming soon

• Überarbeitung von EAD Strukturen

• Styling von Booleans in der Facettierung

• neue CMS-Elemente

• technische Metadaten aus Bildern

Entwicklungen

Live-Aufbereitung von Inhalten

Der Goobi viewer kann jetzt bei Born Digital Dokumenten externe Inhalte abfragen und live aufbereiten. Dadurch ist es möglich zu Born-Digital Dokumenten nur die Metadaten in den Goobi viewer zu exportieren und die eigentlichen Inhalte bei Bedarf herunterzuladen, aufzubereiten, zu präsentieren und nach einem definierten Zeitintervall auch wieder automatisch vom Server zu löschen.

Barrierefreiheit

If pointer hover can trigger the additional content, then the pointer can be moved over the additional content without the additional content disappearing;

Download einer Seitenauswahl

Vor vielen vielen Jahren haben wir für einen Kunden in einem Theme eine Funktionalität entwickelt um mit der Angabe einer Start- und Endseite genau diesen Bereich als PDF-Datei zu generieren. Diese Funktionalität haben wir jetzt komplett neu entwickelt, in den Core integriert und mit einem Konfigurationsschalter versehen, so dass sie bei Bedarf in jeder Installation aktiviert werden kann.

Download von zusätzlichen Dateien

Schon sehr lange gibt es die Möglichkeit zu einem Datensatz zusätzliche Dateien zum Download anzubieten. Dort existiert auch die Möglichkeit Dateien, die auf einen regulären Ausdruck matchen, auszublenden.

Der Bereich wurde überarbeitet und um generische Filter und Bedingungen erweitert. Damit ist es jetzt möglich nicht nur bestimmte Dateien auszublenden, sondern auch nur bestimmte Dateien anzuzeigen. Die Filter können weiterhin als regulärer Ausdruck angegeben werden, aber darin kann auch mit Variablen gearbeitet werden. Hier ein Beispiel, dass die Möglichkeiten auch mit den Bedingungen aufzeigt.

Übersetzt bedeutet das folgendes: Zeige alle Dateien an, die Audio_XXX.mp3 oder Notensatz_XXX.pdf oder XXX.mp3 oder XXX.pdf heißen, wobei XXX jeweils die Signatur des aktuell aktiven Strukturelementes ist, aber nur unter der Bedingung, dass der komplette Datensatz in der Sammlung oder einer Untersammlung von archive.100uaghgw.020volksliedarchiv ist.

IIIF

Sofern in den Metadaten URLs zu IIIF Presentation Manifesten vorliegen kann der Goobi viewer Core diese nun auch in seine Oberfläche weiterreichen und verwenden. Dafür steht ein neuer Konfigurationsschalter zur Verfügung. Ist dieser aktiv und ein Solr Feld konfiguriert, wird bei den in der Oberfläche angebotenen IIIF Manifesten auf den indexierten Wert verwiesen. Auch leitet der REST Endpoint für das IIIF Manifest fürs Werk automatisch auf die externe Manifest-URL weiter.

Snippets

• Core: Die Funktionalität zur Doppelseitenansicht kann jetzt nicht nur ein- und ausgeschaltet, sondern auch standardmäßig aktiviert werden.

• Core: Bei dem OpenID Connect Authentifizierungsprovider können jetzt weitere Parameter konfiguriert werden, um auch speziellere Setups in Betrieb zu nehmen.

Codeanalyse

Versionsnummern

Die Versionen die in der pom.xml des Themes eingetragen werden müssen um die in diesem Digest beschriebenen Funktionen zu erhalten lauten:

Der Goobi viewer Indexer hat die Versionsnummer 24.04 Das Goobi viewer Crowdsourcing Modul hat die Versionsnummer 24.04

Coming soon

• Live-Aufbereitung von Inhalten

• Überarbeitung von EAD Strukturen

• Barrierefreiheit

Entwicklungen

Widgets

Lange hat es gedauert, jetzt ist es endlich so weit. Das Widget "Zitieren und Nachnutzen" wurde aufgeteilt und die Sidebar auf den verschiedenen Ansichten der Werksansicht aufgeräumt und entschlackt. Basierend auf einem Feedback aus einer UX Studie haben wir das "Weniger ist mehr"-Motto zu Herzen genommen und uns die Fragen gestellt:

• Was für eine Terminologie wird erwartet? ... und

• Was für eine Funktionalität wird erwartet?

Herausgekommen sind verschiedene Widgets, die kontextbezogen Inhalte anbieten. Auf der Seite "Inhaltsverzeichnis" und "Seitenvorschau" ist die Sidebar jetzt sehr aufgeräumt und es stehen keine zusätzlichen Widgets mehr zur Verfügung. Auf der Seite "Bibliographische Daten" gibt es das neue Widget "Formate und Verlinkungen", bei dem die angezeigten Metadaten in verschiedenen Formaten aber auch Verlinkungen zu externen Seiten, wie zum Beispiel dem Bibliothekskatalog, dem DFG-Viewer oder auch einer Mirador-Instanz zur Verfügung stehen. Auf der Seite "Volltext" gibt es das neue Widget "Downloads". Hier kann entweder der aktuelle Text der Seite, oder auch der Volltext des gesamten Datensatzes in verschiedenen Formaten heruntergeladen werden.

Admin

Für Entwickler gibt es jetzt einen neuen Bereich im Backend, in dem ein Paket für die Inbetriebnahme in der lokalen Entwicklungsumgebung heruntergeladen werden kann. Außerdem gibt es die Möglichkeit ein per git auf dem Server ausgechecktes Theme über einen Knopfdruck im Backend zu aktualisieren. Dieser Bereich unterstützt die Entwickler beim Nachstellen von gemeldeten Bugs sowie dem Einspielen von kleinen Updates beim Styling.

IIIF

Ab sofort ist es auch Möglich ein vollständiges IIIF Presentation Manifest NUR mit dem aktuellen Bild zu generieren. Diese Möglichkeit steht in dem neuen "Downloads" Widget in der Werksansicht zur Verfügung.

Goobi viewer Indexer

Der Goobi viewer Indexer hat die Möglichkeit erhalten vollständige EAD Dateien zu indexieren und im Solr Suchindex zu speichern. Dieses ist die Vorbereitung für eine überarbeitete Archivanzeige im Goobi viewer Core.

Weiter sind jetzt die Werte vom TYPE Attribut im physischen Baum von METS-Dateien, die der Goobi viewer als zulässige Werte erkennt, konfigurierbar. Bisher war hard codiert page erlaubt, ab jetzt können auch weitere Werte wie object, audio oder video konfiguriert werden, die dann als "Seite" im Werk prozessiert werden sollen.

Zuletzt wurde ein Bug behoben, bei dem die Prüfung auf verfügbaren freien Speicher fehlschlug, wenn dieser freie Speicherbereich sehr groß war. Siehe dazu auch den folgenden Thread im Community Forum:

Snippets

• Connector: Hier gab es einen Bugfix für den Cursor in Resumption Token

• Core: Inhalte aus CMS-Seiten, die noch nicht veröffentlicht waren, sind teilweise trotzdem sichtbar gewesen.

• Core: Japanisch und Polnisch sind als weitere potentielle Sprachen hinzugefügt worden

Codeanalyse

Versionsnummern

Die Versionen die in der pom.xml des Themes eingetragen werden müssen um die in diesem Digest beschriebenen Funktionen zu erhalten lauten:

Der Goobi viewer Indexer hat die Versionsnummer 24.03 Das Goobi viewer Crowdsourcing Modul hat die Versionsnummer 24.03

Coming soon

• Java 17 und Solr 9

• IIIF Manifeste mit nur einem Bild

• Neue Widgets für Download, Metadaten, Links und Zitieren

• Live-Aufbereitung von Datensätzen

Ankündigungen

Entwicklungen

Suchmaschinenoptimierung

Nach längerer Zeit ist in diesem Kontext wieder etwas passiert. Wir haben die Auszeichnung von alternativen Links zu den Inhalten erweitert, um so für Suchmaschinen genauer kennzeichnen zu können, was die Primär-URL und was alternative URLs zum selben Inhalt sind.

Facettierung

Der Slider in der Jahressuche kann jetzt optional auf einen Start- und Endzeitpunkt festgesetzt werden. Damit können Ausreißer in der Facette bewusst ausgeklammert werden, wenn die Datensätze nicht einfach zu korrigieren sind.

CMS

Die Aktionen auf der Seite zum Bearbeiten einer CMS-Seite sind um eine Abbrechen-Möglichkeit erweitert worden, die auf die Übersichtsseite verlinkt.

Hintergrundaufgaben

Manchmal kommt es vor, dass die Warteschlange stecken bleibt und ein Neustart notwendig ist. Dafür haben wir einen neuen Button in die Seite integriert.

Hardening

Um die Sicherheit weiter zu erhöhen haben wir in diesem Release für die Benutzeravatare eine Beschränkung und Prüfung auf die verwendeten Bildtypen sowie eine Größenbeschränkung für die hochgeladenen Dateien eingeführt.

Codeanalyse

Versionsnummern

Die Versionen die in der pom.xml des Themes eingetragen werden müssen um die in diesem Digest beschriebenen Funktionen zu erhalten lauten:

Der Goobi viewer Indexer hat die Versionsnummer 23.12 Das Goobi viewer Crowdsourcing Modul hat die Versionsnummer 23.12

Coming soon

• Suchtreffergruppen

Entwicklungen

TEI Anzeige

Was bisher über ein kundenspezifisches Modul realisiert wurde ist jetzt in den Goobi viewer Kern integriert: Eine native TEI Anzeige. Der hier abgedeckte Anwendungsfall ist, dass für ein digitalisiertes Werk eine TEI Datei mit einer Transkription sowie weitere TEI-Dateien mit Übersetzungen vorliegen. Die Dateien beziehen sich jeweils auf das gesamte Werk und nicht nur auf eine einzelne Seite.

Sofern diese TEI Dateien vorliegen werden sie bei der Indexierung mit bedacht und im Frontend des Goobi viewers stehen dann in der Werksansicht mehrere Volltextlinks zur Verfügung. Im Widget "Zitieren und Nachnutzen" können die einzelnen TEI-Dateien heruntergeladen werden.

Annotationen

Bisher konnten im Goobi viewer Backend auf der Seite "Annotationen" entweder nur die selektierten oder alle der aktuellen Seite heruntergeladen werden. Eine seitenübergreifende Downloadmöglichkeit für alle Annotationen bestand nicht.

Dieses wurde im August implementiert und steht jetzt als zusätzlicher Download-Button oberhalb der Tabelle zur Verfügung

Client

Der Druckdialog innerhalb des Goobi viewer Desktop Clients kann jetzt optional aktiviert werden. Dafür steht in der app.config.js eine neue Konfigurationsoption allowPrint: true|false zur Verfügung. Der Standardwert ist false.

Weiter können PDF-Dateien im Client jetzt nativ in einem eigenen Fenster angezeigt werden.

Metadaten

Wenn ein Datum indexiert wurde, kann dieses in der Metadatenkonfiguration jetzt als type="datefield" konfiguriert und die Datumsanzeige dann mit dem pattern="" Attribut auf das gewünschte Format eingestellt werden.

Die Goobi viewer Digests geben einen regelmäßigen Überblick über die Entwicklungen im Goobi viewer. Sie sind eine kurze Zusammenstellung der Themen, die in dem Monat bearbeitet wurden.

Im Inhaltsverzeichnis auf der linken Seite findet sich eine Auflistung der jeweiligen Monate, zu denen eine solche Zusammenstellung bereits vorliegt. Und zusätzlich sind im Folgenden auch einmal die 6 letzten Digests verlinkt:

Coming soon

• technische Metadaten aus Bildern

• S3 Speicher

• zugriffsbeschränkte Metadaten

Ankündigungen

Entwicklungen

Archive

Die Präsentation von Archivbeständen im Goobi viewer wurde im Unterbau komplett neu entwickelt. Dafür haben wir uns von BaseX als Datenbank und Datenquelle gelöst und die EAD-Dateien werden jetzt - wie alle anderen Metadatenformate auch - in den Apache Solr Suchindex geschrieben. Dieser Ansatz hat verschiedene Vorteile. Zum Beispiel ist der Datenfluss jetzt wieder für alle unterstützen Formate gleich: die Dateien werden im Hotfolder abgelegt und der Goobi viewer Indexer kümmert sich um die Aufbereitung. Ein weiterer Vorteil ist, dass durch den einheitlichen Ort der Datenspeicherung eine formatübergreifende Suche im Gesamtbestand des Goobi viewers möglich ist. In der bekannten Suchmaske werden jetzt auch Archivbestände gefunden. Das war vorher nicht der Fall, da nicht innerhalb von Solr und BaseX gleichzeitig gesucht und die Ergebnisse dann zusammengeführt werden konnten. Ein positiver Nebeneffekt ist auch, dass jetzt Knoten gefunden werden können, zu denen kein Digitalisat existiert. Bei den einzelnen Treffern kann jetzt Wahlweise die Werksansicht oder die Archivansicht geöffnet werden:

Durch die Umstellung wurde auch die Konfiguration der Archivmetadaten angeglichen. Die bisherige, ganz eigene Art- und Weise wurde entfernt und die Konfiguration erfolgt nun über die überall in der config_viewer.xml verwendete Syntax.

Durch die Umstellung konnte weiter eine massive Performanceverbesserung erreicht werden. Auch sehr große Archivbäume (60MB EAD-Datei mit knapp 170.000 Knoten) können jetzt schnell geladen, betrachtet und darin navigiert werden.

Ein weiteres Feature ist die Unterstützung von Zugriffsbeschränkungen für einzelne Knoten im Archivbestand. Dadurch lassen sich einzelne Äste verstecken und nur für bestimmte Benutzer / Gruppen oder sonstige Rechtenehmer zugänglich machen.

Config Editor

Die Möglichkeiten zur Bearbeitung von Konfigurationsdateien im Goobi viewer Backend wurde erweitert. Neu hinzugekommen ist die Möglichkeit Konfigurationsdateien auch direkt hoch und runterladen zu können. Um die dafür notwendigen Icons im bestehenden Design unterzubringen ist der Statusindikator (Datei nur lesend oder Datei gesperrt) jetzt an den Anfang der jeweiligen Zeile gewandert.

Außerdem können Backups von Dateien jetzt nicht mehr nur heruntergeladen, sondern per Klick auch direkt in den integrierten Editor übernommen werden. Dadurch erhöht sich die Bedienbarkeit deutlich!

Im Hintergrund wurde noch eine Änderung am Encoding beim Speichern der config_viewer.xml vorgenommen. Diese wurde immer mit CRLF (Carriage Return, Line Feed) Zeilenumbrüchen geschrieben, auch wenn der Goobi viewer auf einem Linuxserver installiert war. Das führte dann beim Bearbeiten der Datei auf der Kommandozeile zu unschönen ^M Zeichen an jedem Zeilenende. Jetzt werden die Zeilenumbrüche gemäß Systemeinstellung gesetzt. CRLF wird weiterhin auf Windows Systemen genutzt, Linuxsysteme nutzen jetzt aber korrekterweise NL (New Line).

3D-Objekte

3D Dateien werden nicht mehr sofort beim Öffnen der entsprechenden Seite im Goobi viewer heruntergeladen, sondern es erscheint eine vorgeschaltete Information, die darauf hinweist, wie viele Daten dafür heruntergeladen werden müssen. Klickt man dann auf den Anzeigen Button erscheint ein Fortschrittsbalken, der über den Download informiert.

Die Anzeige der 3D Objekte ist gleich geblieben, aber die Bedienbarkeit wurde gerade bei großen Dateien durch diese Änderung deutlich verbessert.

Snippets

• Core: In der erweiterten Suche werden die Filter jetzt standardmäßig automatisch in dem ersten DropDown Feld mit aufgelistet.

• Core: Badges von Zitierlinks wurden trotz korrekter Konfiguration nicht vollständig angezeigt. Der Fehler wurde behoben.

• Core: Wenn Bilder über eine externe IIIF Schnittstelle eingebunden werden, stehen dort nun auch die Standard Downloadoptionen zur Verfügung

• Core: Die Anzeige für das Widget zur Suche im Werk kann jetzt optional an die Verfügbarkeit von Volltexten geknüpft werden.

• Indexer: Die Indexierung von METS/MARC Datensätzen wurde erweitert.

Codenanalyse

Versionsnummern

Die Versionen die in der pom.xml des Themes eingetragen werden müssen um die in diesem Digest beschriebenen Funktionen zu erhalten lauten:

Der Goobi viewer Indexer hat die Versionsnummer 24.06 Das Goobi viewer Crowdsourcing Modul hat die Versionsnummer 24.06

Coming soon

• Suchtreffergruppen

• Text als Hauptanzeige für Werke

Entwicklungen

Externe Downloadlinks

Immer wieder kommt es vor, dass in METS-Dateien eine Dateigruppe DOWNLOAD existiert, in der für Portallösungen eine URL zu einer PDF-Datei oder einer dedizierten Download-Seite für das Werk verwiesen wird. Der Goobi viewer Indexer und der Goobi viewer Core unterstützen diese Lösung jetzt.

Hier ein Beispiel für die Dateigruppe:

Sofern der Indexer die METS Dateigruppe erkennt, indexiert er die darin enthaltene URL in das Feld MD2_DOWNLOAD_URL. Der Goobi viewer wiederum erkennt eine solche URL und blendet dann in dem Inhaltsverzeichnis oder in dem Widget "Zitieren und Nachnutzen" die eigene Funktionalität zur PDF-Generierung aus. Anstelle dessen wird im Widget ein Download Badge angeboten, der auf die indexierte URL verweist.

Zugriffsbeschränkungen

Wenn ein Werk mehreren Zugriffsbeschränkungen unterliegt, dann werden jetzt die Texte aller Beschränkungen im Sidebar Widget mit den Informationen zu Zugriffsbeschränkungen und Nutzungslizenz angezeigt.

Suche

Das Standardfilterset für die Suche kann ab sofort mit einem neuen default="true" Attribut auf einen individuellen Filter festgelegt werden.

Goobi viewer Indexer

Manche Dateisysteme sind nicht so schnell. Aus diesem Grund hält der Goobi viewer Indexer jetzt im Speicher eine Liste mit bis zu maximal 500 Dateien vor, die im Hotfolder liegen und abgearbeitet werden sollen. Dadurch wird ein potentiell zeitaufwendiges Dateisystemlisting vermieden, was bei langsamen Speichersystemen und vielen Dateien im Hotfolder die Performance stark ausgebremst hat.

Zusätzlich besteht ab diesem Release die Möglichkeit einen zweiten Hotfolder zu konfigurieren, der für Neuindexierungen verwendet werden kann. Ausschlaggebend ist die Reihenfolge in der config_indexer.xml. Dabei werden die Datensätze aus dem Standard Hotfolder prioritär behandelt, so dass eine normale Produktion mit dazugehörigem schnellen Export auch während einer umfangreichen Neuindexierung mit sehr vielen Datensätzen nicht gestört wird.

Der Goobi viewer Indexer kann einen Wert anhand des neuen Platzhalters {SPLIT} in mehrere aufteilen. In dem folgenden Beispiel wird nach über einen regulären Ausdruck nach "international" gesucht und dann anschließend im Index die Werte LUX_YES und LUX_NO geschrieben:

Codeanalyse

Versionsnummern

Die Versionen die in der pom.xml des Themes eingetragen werden müssen um die in diesem Digest beschriebenen Funktionen zu erhalten lauten:

Der Goobi viewer Indexer hat die Versionsnummer 23.07.1 Das Goobi viewer Crowdsourcing Modul hat die Versionsnummer 23.07

Coming soon

• kompakte und hochaufgelöste PDF Dateien

• Highlights

Ankündigungen

Im Februar haben wir viel für Projekte und weniger am Core selbst gearbeitet. Deswegen fällt der Digest in diesem Monat kürzer aus als sonst.

Entwicklungen

Facettierung

In der Facettierung ist es nun möglich mehr als eine Facette mit einem Slider anzuzeigen. So können zum Beispiel Werte wie "Geburtsdatum" und "Sterbedatum" beide konfiguriert werden.

Zusätzlich ist es möglich den Slider optional als Graphen anzuzeigen. Dadurch wird innerhalb der Facette direkt visuell hervorgehoben wie viele Treffer zu erwarten sind.

REST

Der REST Endpoint für das Monitoring wurde überarbeitet und beinhaltet nun weitere Statusinformationen die im Fehlerfall eine Diagnose vereinfachen.

Codeanalyse

Versionsnummern

Die Versionen die in der pom.xml des Themes eingetragen werden müssen um die in diesem Digest beschriebenen Funktionen zu erhalten lauten:

Der Goobi viewer Indexer hat die Versionsnummer 23.02 Das Goobi viewer Crowdsourcing Modul hat die Versionsnummer 23.02

Coming soon

• kompakte und hochaufgelöste PDF Dateien

Entwicklungen

CMS

Endlich ist es da. Wir haben lange darüber geredet und viel zu lange daran entwickelt, aber der initiale Aufschlag für die Überarbeitung des CMS-Bereichs ist fertig. Die Ideen dafür sind bereits fast drei Jahre alt, ein Konzept wurde vor zwei Jahren erstellt und die Vorstellung im Community Forum ist auch schon über ein einhalb Jahre her. Lange haben wir entwickelt und dabei auch immer wieder feststellen müssen, dass Ideen in der Form nicht realisierbar waren oder wir Bereiche vergessen hatten mit zu bedenken. Jetzt sind wir in einem Status angelangt, bei dem wir die Entwicklungen veröffentlichen möchten.

Hintergrund

Der CMS-Bereich des Goobi viewers wurde im Bereich 2014 konzipiert und seitdem immer nur inhaltlich erweitert, nie aber von seinem Aufbau und seiner Struktur evaluiert. Das hatte verschiedene Gründe aber sollte dann vor ein paar Jahren nicht mehr als Ausrede gelten, wo wir den CMS-Bereich neben der Bildanzeige und dem Suchindex als eine der Kernkomponenten des Goobi viewers sehen.

Der Kerngedanke des CMS-Bereichs war, dass über Templates ein Seitenaufbau vorgegeben werden kann. Diese Templates stehen einerseits global zur Verfügung, können andererseits aber auch kundenspezifisch entwickelt und dann im Theme hinterlegt werden. Dabei besteht ein CMS-Template aus verschiedenen Inhalten wie Text, Bild, Suchtreffern, etc. Neben diesen Inhalten selbst, sollen diese aber teilweise auch konfigurierbar sein und die Seite selbst enthält auch Einstellmöglichkeiten für die Seite selbst. Konfiguration von Inhalten sind zum Beispiel eine Solr-Query zur Einschränkung für Suchtreffer, Konfiguration von der Seite selbst ist zum Beispiel die alternative URL. Darüber hinaus enthält jede CMS-Seite eine Sidebar und auch diese ist seitenspezifisch konfigurierbar.

Bisherige Einschränkungen

Eine der Haupteinschränkungen im bisherigen Modell war die Starrheit der Seiten. Wenn auf einer Seite zwei Texte, ein Kachelgrid und eine Suchtrefferliste angezeigt werden sollten, dann konnten wir genau das über ein kundenspezifisches Template abbilden. Wenn dann aber ein weiterer Text hinzukommen sollte, mussten wir das Template aktualisieren und im Zweifelsfall damit einher gehend auch den ganzen Goobi viewer. Für eine kleine Textanpassung an einer CMS-Seite die innerhalb von fünf Minuten gemacht sein kann kamen da vielleicht mehrere Stunden Aufwand auf unserer Seite zu. Das war nicht nur für die Anwender, sondern auch für uns unbefriedigend. Das einfache und kreative Erstellen von Seiten war nicht möglich.

Dazu kam, das ein über viele Jahre gewachsenes System einfach unübersichtlich wurde. Ideen, die wir bei der initialen Konzeption hatten, haben sich als als nicht praxistauglich herausgestellt, wurden aber nicht geändert. Neue Funktionalität kam hinzu und wurde einfach irgendwo hinzugefügt wo es gerade passte. Dazu kommt auch, dass es einfacher ist eine Checkbox zur Verfügung zu stellen in der ein Anwender klicken muss ob er etwas möchte als es mit Logik im Code zu lösen und "intelligent" zu gestalten.

Was neu ist

Bei der Überarbeitung des Bereichs haben wir als erstes darauf geachtet, dass wir die visuellen Elemente aus dem Bedienkonzept der anderen Bereiche auf den CMS-Bereich adaptieren. So wird zum Beispiel der Übersetzungsstatus von einer Seite in der Übersicht jetzt auch über die farbigen Kästen angezeigt und nicht mehr über die Checkboxen. Das hat den Vorteil, dass auch teilweise übersetzte Seiten visualisiert werden können.

Wenn eine neue CMS-Seite hinzugefügt werden soll, steht ab sofort eine Auswahl zur Verfügung, ob mit einer leeren Seite begonnen, einer Seite basierend auf einem Template angelegt oder ein neues Seitentemplate angelegt werden soll.

Die Anzeige zum Hinzufügen oder Bearbeiten einer Seite oder Template ist immer gleich aufgebaut. Der Hauptbereich beinhaltet die bekannten Reiter für die verfügbaren Sprachen die auch den Übersetzungsstatus visualisieren. Rechtsbündig von den Übersetzungen ist der Reiter für die Sidebar der Seite verortet. In der Sidebar sind alle Optionen die generelle Seiteneinstellungen beinhalten. Ganz unten auf der Seite gibt es immer sichtbar eine Aktionsleiste, die - je nach Seitenstatus - die Buttons zum Speichern, Löschen und Anzeigen enthält. So können die Aktionen nicht mehr rausscrollen.

Innerhalb des Hauptbereiches befindet sich mit dem Titel das einzige Pflichtfeld für eine Seite.

Komplett neu ist ab dann die Möglichkeit die Elemente auf einer CMS-Seite auszuwählen, anzuordnen und zu konfigurieren. In einem DropDown Menü stehen alphabetisch sortiert die Elemente zur Verfügung, die auf der Seite hinzugefügt werden können. Ein Element besteht aus verschiedenen Inhalten. Neben der Überschrift gibt es Attribute die das Element steuern. In dem folgenden Beispiel für einen HTML Text sind das die folgenden:

• 50% und 100%: Steuert wie viel Breite das Element im Content-Bereich der Seite einnehmen soll. Zwei 50% Inhalte werden dabei automatisch nebeneinander dargestellt.

• Hide on desktop / mobile: Steuert ob das Element auf einem einem großen Bildschirm beziehungsweise auf einem Mobilgerät ausgeblendet werden soll

• Private: Steuert ob das Element grundsätzlich veröffentlicht sein soll oder nicht. Als Privat markierter Elemente sind nur für Administratoren sichtbar und werden auf der Seite auch visuell gekennzeichnet

• Reihenfolge: Über die beiden Pfeile nach oben und unten kann die Reihenfolge der Elemente auf einer Seite frei nach oben und unten geschoben werden

In der Regel hat ein Element auch einen kleinen Hilfetext. Je nachdem was mit einem Element dann möglich ist, gibt es weitere Optionen. In dem Beispiel von dem HTML Text kann ein entsprechender Text eingegeben werden.

Andere Elemente, wie zum Beispiel ein Tracking Opt-Out haben keine weiteren Einstellmöglichkeiten sondern werden nur als Element angezeigt.

Elemente wie die Suchtreffer können dann dann weiter konfiguriert werden: Solr-Query, Sortierfelder, Gruppierung etc.

Die einzige Einschränkung die an dieser Stelle existiert ist, dass nicht mehr als ein Element pro CMS-Seite verwendet werden darf, dass potentiell mehrere Seiten hat. Da die Paginierung über die URL abgebildet wird, um die aktuell sichtbare Seite einfach weitergeben zu können, wäre sonst nicht klar in welchem Element geblättert worden wäre.

In den Reitern mit den Übersetzungen werden alle Elemente angezeigt, aber nur die übersetzbaren Inhalte sind steuerbar. Attribute, Konfigurationsoptionen oder die Möglichkeit zum Löschen steht nur in der Primärsprache zur Verfügung. Dadurch soll vermieden werden, dass der Eindruck entsteht, dass für verschiedene Sprachen verschiedene Einstellmöglichkeiten zur Verfügung stehen.

Bestehende CMS-Seiten aus früheren Core-Templates werden bei einem Update automatisch migriert. Dafür wurde pro altem Template eine Legacy-Komponente angelegt. Dennoch sollten bei jedem Update auf einen Goobi viewer mit dem neuen CMS einmal alle bestehenden Seiten von Hand geprüft werden. Auch empfehlen wir die bestehenden Seiten von Legacy-Templates in dynamische Seiten zu überführen. Wenn wir nach einem Update gefragt werden bieten wir das gerne mit an. Bestehende Theme-Templates müssten geprüft und gegebenenfalls in neue Elemente überführt werden. Das wird individuell von Installation zu Installation geprüft.

Snippets

• Der Goobi viewer Core wie auch der Goobi viewer Indexer können jetzt beim Verbindungsaufbau nach extern einen Proxy Server verwenden. Das ist zum Beispiel bei der Live-Abfrage von Normdaten sinnvoll.

• Bei aktivierten DataRepositories prüft der Goobi viewer Indexer nach dem Indexieren ob derselbe Datensatz auch in einem anderen DataRepository enthalten ist und löscht den dort sofern vorhanden.

• Tabellen im Backend enthalten jetzt deutlich mehr Einträge, so dass weniger geblättert werden muss

• Seiten im Backend haben jetzt Breadcrumbs. Dadurch wird die Navigation in der Seitenhierarchie deutlich ergonomischer.

Was kommen wird

Warteschlange

Bereits in der Entwicklung ist eine überarbeitete Warteschlangenfunktionalität die die bisher über nur in der REST-API verfügbaren Tasks um Funktionalitäten wie Persistenz, graphische Oberfläche, potentielles Clustering sowie erweiterte Steuerungsmöglichkeiten wie zum Beispiel dem Pausieren von einzelnen Jobtypem ermöglicht. Mit der Entwicklung einher geht die Möglichkeit PDF-Dateien im Goobi viewer automatisch vorrendern zu lassen.

Facetten

Auch in diesem Jahr wollen wir weiter an der Ergometrie der Suche arbeiten. Dabei stehen zum Beispiel verbesserte Facettierungsoptionen auf dem Plan. Die Facettierung nach Zeit soll über mehrere verschiedene Metadaten unabhängig möglich sein (zum Beispiel Geburtsdatum und Sterbedatum). Außerdem soll ein Graph die Anzahl der Suchtreffer in einem Zeitabschnitt visualisieren.

Ebenfalls neu hinzukommen soll die Möglichkeit der Facettierung nach Anfangsbuchstaben. Ähnlich wie das Stöbern, allerdings mit vollwertigen Suchtreffern, die gleich auch Thumbnail und weitere Informationen mitbringen

Karten

Marker auf Karten sollen einen Typ mitbekommen können, so dass zum Beispiel eine Karte mit Lebensstationen eines Künstlers angezeigt werden kann, auf der einzelne Stationstypen (Geburtsort, Ausbildungsort, Entstehungsort eines Werkes, Ausstellungsorte, Sterbeort) jeweils eigene Marker bekommen

Sidebar

Geplant ist auch die Steuerung der Sidebarkomponenten pro Seite konfigurierbasr zu machen. Dafür sind größere technische Umbauten notwendig um die Konfigurierbarkeit im Java Code zu ermöglichen. Die Steuerung ist bisher nur für CMS-Seiten möglich, soll ab dann aber auch für Core-Seiten gelten.

Diese Entwicklung soll dann auch die automatische Ausdehnung des Content-Bereiches auf die gesamte Seitenbreite ermöglichen, wenn keine Sidebar Widgets angezeigt werden.

Weiteres

Grundsätzlich ist bei uns geplant gerade den Bereich der Bedienbarkeit im Frontend zu verbessern. Dabei wollen wir in Absprache mit den Anwendern größere und kleinere Teilbereiche identifizieren und überarbeiten, so dass sich diese Bereiche weniger gewachsen und konsistenter anfühlen.

Codeanalyse

Die folgenden Screenshots zeigen die SonarCloud Analyse des aktuellen Releases. Weitere Informationen gibt es direkt auf der Projektseite.

Versionsnummern

Die Versionen die in der pom.xml des Themes eingetragen werden müssen um die in diesem Digest beschriebenen Funktionen zu erhalten lauten:

<dependency>
    <groupId>io.goobi.viewer</groupId>
    <artifactId>viewer-core</artifactId>
    <version>22.12</version>
</dependency>
<dependency>
    <groupId>io.goobi.viewer</groupId>
    <artifactId>viewer-core-config</artifactId>
    <version>22.12</version>
</dependency>
<dependency>
    <groupId>io.goobi.viewer</groupId>
    <artifactId>viewer-connector</artifactId>
    <version>22.12</version>
</dependency>

Der Goobi viewer Indexer hat die Versionsnummer 22.12 Das Goobi viewer Crowdsourcing Modul hat die Versionsnummer 22.12

Coming soon

• Highlights

• Suchtreffergruppen

Entwicklungen

Suchtreffer

Für die Darstellung von Suchtreffern hat es verschiedene kleine Entwicklungen gegeben. So können Suchtreffer jetzt optional durchnummeriert werden.

Außerdem können Metadaten in der Suchtrefferliste automatisch in ihrer Länge beschränkt werden. Liegt zum Beispiel für eine E-Publikation ein kompletter Abstract als Metadatum vor, kann die Darstellung eines Suchtreffers sehr lang werden. Mit der Neuerung kann nur das relevante Snippet mit einer konfigurierbaren Anzahl von Zeichen davor und dahinter angezeigt werden.

Gibt es mehrere Einträge für ein Metadatum wird jeder Eintrag in einer neuen Zeile angezeigt. Haben an einer E-Publikation mehrere Personen gearbeitet, kann auch dieses den Suchtreffer sehr in die Länge ziehen. Neu ist hier die Möglichkeit den Separator von einem Zeilenumbruch auf etwas eigenes zu ändern, zum Beispiel ein Semikolon.

Zuletzt gibt es bei der statischen, versteckten Sortierung von Suchtreffern noch eine kleine Neuerung, denn diese versteckten Sortierfelder können mit einem vorangestellten Ausrufezeichen jetzt auch andersherum sortiert werden.

REST API

Der Monitoring Endpoint listet jetzt auch auf, ob die ActiveMQ Warteschlange läuft.

Codeanalyse

Die folgenden Screenshots zeigen die SonarCloud Analyse des aktuellen Releases. Weitere Informationen gibt es direkt auf der Projektseite.

Versionsnummern

Die Versionen die in der pom.xml des Themes eingetragen werden müssen um die in diesem Digest beschriebenen Funktionen zu erhalten lauten:

<dependency>
    <groupId>io.goobi.viewer</groupId>
    <artifactId>viewer-core</artifactId>
    <version>23.05</version>
</dependency>
<dependency>
    <groupId>io.goobi.viewer</groupId>
    <artifactId>viewer-core-config</artifactId>
    <version>23.05</version>
</dependency>
<dependency>
    <groupId>io.goobi.viewer</groupId>
    <artifactId>viewer-connector</artifactId>
    <version>23.05</version>
</dependency>

Der Goobi viewer Indexer hat die Versionsnummer 23.05 Das Goobi viewer Crowdsourcing Modul hat die Versionsnummer 23.05

Coming soon

• Suchtreffergruppen

• externe Downloadlinks für Datensätze

Entwicklungen

Highlights

Ob jetzt als "Objekt des Monats", als "Schätze aus dem Bestand" oder einfach nur Highlights: Im Backend können jetzt Datensätze oder alternativ auch URLs zu (CMS-)Seiten als Highlights definiert werden.

Highlights können vorbereitet und dann bei Bedarf veröffentlicht werden. Zusätzlich können sie auch automatisch für einen konfigurierten Zeitraum angezeigt werden, so dass zum Beispiel für mehrere Monate jeweils schon ein Objekt des Monats vorkonfiguriert werden kann.

Die Highlights können entweder als Widget in CMS-Seiten oder als Element auf einer CMS-Seite eingebettet werden.

Goobi viewer Indexer

Die Indexierung von Repräsentanten ist jetzt weiter konfigurierbar. Die bisherige Logik sah vor, dass wenn in einem Datensatz ein Bild explizit als Repräsentant gekennzeichnet wurde diesen zu übernehmen. Wenn kein Bild markiert war gab es einen automatischen Fallback auf das erste Bild des Datensatzes.

Innerhalb dieser Logik gibt es jetzt zwei Neuerungen. Zum einen können Repräsentanten jetzt neben dem bereits bekannten use="banner" Attribut auch mit xlink:label="START_PAGE" gekennzeichnet sein. Zum anderen kann der Fallback auf das erste Bild ausgestellt werden, so dass Datensätze mit referenzierten Bildern gar keinen Repräsentanten haben.

Snippets

• Core: Die Konfiguration der Metadatenlisten wurde vereinfacht. Aus den verschiedenen XML-Elementen wie <searchHitMetadataList /> oder <sidebBarMetadataList /> wurden <metadataList type="searchHit" /> oder <metadataList type="sideBar" />. So können auch weitere Listen an Metadaten in Zukunft einfacher ohne umfassende Anpassungen am Code hinzugefügt werden

• Connector: Die über OAI ausgegebenen Metadaten für die Europeana wurden um isShownBy erweitert

• Indexer: Bildmaße können jetzt auch aus dem info.json von IIIF Bildmanifesten gelesen und indexiert werden.

Codeanalyse

Die folgenden Screenshots zeigen die SonarCloud Analyse des aktuellen Releases. Weitere Informationen gibt es direkt auf der Projektseite.

In SonarCloud lassen sich Qualitätsanforderungen, sogenannte Quality Gates, definieren. Die Quality Gates werden einmal auf den gesamten Quelltext angewendet und einmal auf den Quelltext der in den letzten 30 Tagen geändert wurde.

Das jetzt fehlschlagende Quality Gate im Goobi viewer Connector bezieht sich auf den angepassten Quelltext in den letzten 30 Tagen. Dort wird eine Testabdeckung von 25% gefordert, die aber nicht erreicht wird.

Das Quality Gate für den gesamten Quelltext wird erfüllt.

Versionsnummern

Die Versionen die in der pom.xml des Themes eingetragen werden müssen um die in diesem Digest beschriebenen Funktionen zu erhalten lauten:

<dependency>
    <groupId>io.goobi.viewer</groupId>
    <artifactId>viewer-core</artifactId>
    <version>23.06</version>
</dependency>
<dependency>
    <groupId>io.goobi.viewer</groupId>
    <artifactId>viewer-core-config</artifactId>
    <version>23.06</version>
</dependency>
<dependency>
    <groupId>io.goobi.viewer</groupId>
    <artifactId>viewer-connector</artifactId>
    <version>23.06</version>
</dependency>

Der Goobi viewer Indexer hat die Versionsnummer 23.06 Das Goobi viewer Crowdsourcing Modul hat die Versionsnummer 23.06

Coming soon

• Highlights

• Suchtreffergruppen

Ankündigungen

Entwicklungen

PDF-Generierung

Im Januar haben wir die Hintergrundaufgaben mit der Warteschlange in den Goobi viewer integriert. Mit dem Märzrelease wird diese Funktionalität genutzt um optional automatisch PDF-Dateien zu generieren und im Dateisystem vorzuhalten.

Die PDF-Generierung des Goobi viewers funktioniert so, dass basierend auf vorliegenden Bildern und optionaler METS-Datei und OCR-Ergebnissen eine PDF-Dateien on-the-fly generiert werden. Da wir nie im Vorfeld wissen können ob und wenn ja welche Seite eines Werkes, welches Strukturelement oder welches komplette Werk wann zum Download angefordert wird, kann durch diese Vorgehensweise der Speicherverbrauch minimiert werden. Die on-the-fly Generierung kann zum Clustering und für eine E-Mailbenachrichtung an den intranda TaskManager ausgelagert werden. Einmal generierte PDF-Dateien werden in einem Cache zwischengespeichert. Dieser ist in der Regel 30GB groß. Ist er voll, werden die jeweils ältesten Dateien gelöscht. Dadurch verbleiben oft angefragte Dateien im Cache und können schneller ausgeliefert werden.

Neben der on-the-fly Generierung unterstützt der Goobi viewer auch die Verkettung bereits vorhandener PDF-Dateien. Manchmal kommen aus einer OCR bereits PDF-Dateien für Einzelseiten. Liegen diese im Goobi viewer vor, wird nur noch eine Verkettung der vorhandenen Dateien vorgenommen. Das geht deutlich schneller als die on-the-fly Generierung.

Die PDF-Generierung wird vom ContentServer übernommen. Dieser wurde im letzten Monat erweitert um für die Generierung verschiedene Konfigurationsvarianten vorzuhalten. So kann die eine Variante die PDF-Dateien klein skalieren und stärker komprimieren während eine andere Variante die Originalgröße ausliefert.

Ob PDF-Dateien automatisch generiert und im Dateisystem vorgehalten werden sollen, wird vom Goobi viewer Indexer gesteuert. Die Konfigurationsdatei wurde erweitert um diese Funktionalität ein- oder ausschalten zu können. Wenn aktiv, wird die Generierung immer dann angestoßen, wenn während der Indexierung auch Bilder im Dateisystem lagen. So werden automatisch alle neuen Werke sowie die mit einem veränderten Bildstapel erfasst. Zusätzlich gibt es die Möglichkeit die Generierung zu forcieren, so dass bei der ersten Inbetriebnahme eine Neuindexierung der METS-Dateien ausreicht um für alle vorhandenen Datensätze die Generierung anzustoßen. Die zu verwendende Konfigurationsvariante im ContentServer kann über einen weiteren Schalter festgelegt werden.

Die Generierung wird dann über die Hintergrundaufgaben abgearbeitet. Dafür wurde eine zweite Warteschlange eingeführt, die parallel zu der bisherigen läuft. So kann die PDF-Generierung auch über mehrere Tage laufen und behindert die anderen Aufgaben wie das Erzeugen einer neuen Sitemap oder die Benachrichtigung bei neuen Suchtreffern nicht.

Sofern vorgenerierte PDF-Dateien vorliegen, wird in dem Widget "Zitieren und Nachnutzen" automatisch angeboten PDF-Dokumente komprimiert oder in Originalgröße herunterzuladen.

Bildnavigation

Im Vollbildmodus kann jetzt optional eine Navigation im Bild aktiviert werden. Dafür steht ein neuer Konfigurationsschalter zur Verfügung. Wenn aktiv wird in der linken unteren Ecke das Bild als Thumbnail inklusive eines Kastens angezeigt, der den aktuell ausgewählten Ausschnitt visualisiert. Das kann gerade bei größeren Karten sinnvoll sein.

Security

Im März wurden wir auf eine Cross-Site-Scripting Sicherheitslücke im Goobi viewer hingewiesen. Das Verhalten konnte schnell bestätigt werden. Nach eingehender Beleuchtung der Sachlage schätzen wir dass Risiko für eine aktive Ausnutzung wie auch das potentielle Schadenspotential jedoch als nicht kritisch ein.

Im Zuge der Überprüfung haben wir potentielle Probleme an verschiedenen Stellen analysiert und bearbeitet. Dies betrifft vor allem:

• Möglichkeit des Cross-Site-Scripting über URL Parameter oder Eingabeformulare

• Überprüfen von potentiellen Möglichkeiten der Solr-Injection

• Hardening im Kontext Upload das eventuell zu einem Denial of Service führen kann

Für die Cross-Site-Scripting Lücken haben wir auf Github jeweils ein Security Advisory erstellt, dem die CVE IDs CVE-2023-29014, CVE-2023-29015 und CVE-2023-29016 zugewiesen wurden.

Facettierung

Mehrere Facetten aus dem selben Feld wurden bisher mit ODER verknüpft. Das hat zu Verwirrung in der Bedienung geführt weswegen wir die Logik jetzt standardmäßig zu UND geändert haben. Sollte weiterhin eine ODER Verknüpfung gewünscht sein, kann das in der Konfigurationsdatei für das Feld innerhalb der Facetten explizit festgelegt werden.

Codeanalyse

Die folgenden Screenshots zeigen die SonarCloud Analyse des aktuellen Releases. Weitere Informationen gibt es direkt auf der Projektseite.

Versionsnummern

Die Versionen die in der pom.xml des Themes eingetragen werden müssen um die in diesem Digest beschriebenen Funktionen zu erhalten lauten:

<dependency>
    <groupId>io.goobi.viewer</groupId>
    <artifactId>viewer-core</artifactId>
    <version>23.03</version>
</dependency>
<dependency>
    <groupId>io.goobi.viewer</groupId>
    <artifactId>viewer-core-config</artifactId>
    <version>23.03.1</version>
</dependency>
<dependency>
    <groupId>io.goobi.viewer</groupId>
    <artifactId>viewer-connector</artifactId>
    <version>23.03</version>
</dependency>

Der Goobi viewer Indexer hat die Versionsnummer 23.03.1 Das Goobi viewer Crowdsourcing Modul hat die Versionsnummer 23.03

Coming soon

• Überarbeitung des CMS-Bereichs

• kompakte und hochaufgelöste PDF Dateien

• Authentifizierung

Entwicklungen

Suche

Die Oberfläche für die erweiterte Suche wurde vollständig überarbeitet. Dabei haben wir uns von dem bestehenden Konzept gelöst und auf Basis einer Evaluation mit der Community einen Vorschlag erarbeitet und umsetzen können.

Die neue Suchmaske ist jetzt grundsätzlich nur noch dafür ausgelegt auf einer eigenständigen Seite angezeigt zu werden. Vorher konnten optional die Suchtreffer darunter platziert werden. Der Umstand führte immer zu einem Konflikt zwischen Bedienbarkeit und Funktionalität. Die klare Trennung räumt damit auf und bringt viele Vorteile mit. So steht nun erstmals eine direkt sichtbare Hilfe in der Sidebar zur Verfügung, die die verschiedenen Suchoptionen inklusive Beispielen beschreibt. Außerdem kann die unscharfe Suche jetzt bei einer Suchabfrage optional dazugeschaltet werden. Vorher musste die Funktionalität global für eine Installation ein- oder ausgeschaltet sein.

Konfiguration

Vor einem Jahr haben wir in der Konfigurationsdatei schon einmal aufgeräumt und Schreibweisen vereinheitlicht etc. Siehe dazu auch den Digest von August 2021:

Im vergangenen Monat haben wir das Thema noch einmal aufgegriffen, ordentlich aufgeräumt und die Arbeiten in dem Bereich vorerst abgeschlossen. Elemente die zwar konfigurierbar waren aber nie angepasst wurden haben wir zurückgebaut, Schalter wurden verschoben oder überhaupt dokumentiert.

Ziel dieser Arbeiten war und ist, die inzwischen beachtlich große Konfigurationsdatei verständlich zu halten. So ist es unserer Ansicht nach zum Beispiel wichtig, dass die Terminologie im Frontend, Code und Backend einheitlich ist. Auch sollten Schalter immer gleich formuliert sein und nicht bei dem einen <functionFoo enabled="true" /> und bei einem anderen <barFunction disabled="true" /> stehen. Auch das Entfernen von obsoleten Einträgen trägt dazu bei, dass die Konfigurationsdatei trotz seines Umfangs übersichtlich bleibt.

Mehr zu dem Thema in der Updateanleitung

Zugriffsbeschränkungen

Gerade wenn Funktionalität wenig in Verwendung ist muss sie möglichst klar sein. Das ist aber umso schwerer je komplexer die Materie wird. Einer dieser Bereiche befindet sich in den Zugriffsbeschränkungen: Ein Datensatz kann mehrere Zugriffsbeschränkungen enthalten. Der folgende Anwendungsfall verdeutlicht das:

• Ein Datensatz hat die Zugriffsbeschränkung metadaten_registriert und frei_lesesaal

• Der Datensatz ist standardmäßig weltweit nicht sichtbar

• Die Zugriffsbeschränkung metadaten_registriert bedeutet, dass Forscher, die einer bestimmten Benutzergruppe angehören nach dem Anmelden die Metadaten des Datensatzes lesen dürfen.

• Die Zugriffsbeschränkung frei_lesesaal bedeutet, dass aus dem IP-Adressbereich des Lesesaals der Datensatz vollständig zugänglich ist

An dieser Stelle ist nun notwendig festzulegen welche der beiden Zugriffsbeschränkungen höher gewichtet ist und die andere überschreibt. Ansonsten kann es zu dem Fall kommen, dass sich ein Forscher im Lesesaal anmeldet und anschließend weniger sieht als vorher.

Um das klarer zu machen haben wir die Logik, Benennung und Erklärung im Backend angepasst. So wird jetzt unter anderem auf der Übersichtsseite der Zugriffsbeschränkungen in den Kacheln angezeigt ob eine Beschränkung eine andere überschreibt, oder ob sie von einer anderen überschrieben wird.

REST API

In der REST API steht ein neuer Endpoint zur Verfügung um eine Liste aller Datensätze zu generieren, die in einem bestimmten Jahr über die Moving Wall Funktionalität freigeschaltet wurden/werden.

Die Antwort liefert immer alle Datensätze für das angefragte Jahr. Wenn ein Datensatz in dem angefragten Jahr erst an einem späteren Zeitpunkt freigeschaltet wird, so ist dieser ebenfalls enthalten. Da für jeden Datensatz ein genaues Datum angezeigt wird lassen sich diese Fälle aber sehr einfach erkennen.

Der Zugriff auf die Information ist abgesichert und nur mit einem TOKEN möglich.

Desktop Client

Der Quelltext des Desktop Clients steht jetzt auf Github zur Verfügung:

Snippets

• Im Backend wurden weitere Benachrichtigungen auf Sweetalerts umgestellt um so ein homogenes UI zu gewährleisten.

• Die Indexierung von Normdaten kann jetzt im Goobi viewer Indexer komplett deaktiviert werden.

• Die Parameter from/until werden im Goobi viewer Connector bei der OAI Schnittstelle jetzt auch ausgewertet, wenn Sets abgefragt werden.

• Wir haben die Applikation mit verschiedenen externen Tools von extern gescannt um mögliche XSS Sicherheitslücken zu finden. Es wurden keine Schwachstellen gefunden.

Codeanalyse

Die folgenden Screenshots zeigen die SonarCloud Analyse des aktuellen Releases. Weitere Informationen gibt es direkt auf der Projektseite.

Ein paar Worte zu der fehlschlagenden Analyse im Connector:

In SonarCloud lassen sich Qualitätsanforderungen, sogenannte Quality Gates, definieren. Die Quality Gates werden einmal auf den gesamten Quelltext angewendet und einmal auf den Quelltext der in den letzten 30 Tagen geändert wurde.

Das jetzt fehlschlagende Quality Gate im Goobi viewer Connector bezieht sich auf den angepassten Quelltext in den letzten 30 Tagen. Dort wird eine Testabdeckung von 25% gefordert, es gibt aber nur eine Abdeckung von 17,8%. Ursache dafür ist, dass bei Refaktorisierungsarbeiten viel Quelltext angefasst wurde und dieser jetzt als neu gilt.

Das Quality Gate für den gesamten Quelltext wird erfüllt.

Absolut wurden im Goobi viewer Connector im Vergleich zum letzten Monat 178 Code Smells entfernt, 15 Unit Tests hinzugefügt und die Testabdeckung um 5% gesteigert!

Versionsnummern

Die Versionen die in der pom.xml des Themes eingetragen werden müssen um die in diesem Digest beschriebenen Funktionen zu erhalten lauten:

<dependency>
    <groupId>io.goobi.viewer</groupId>
    <artifactId>viewer-core</artifactId>
    <version>22.10.2</version>
</dependency>
<dependency>
    <groupId>io.goobi.viewer</groupId>
    <artifactId>viewer-core-config</artifactId>
    <version>22.10.1</version>
</dependency>
<dependency>
    <groupId>io.goobi.viewer</groupId>
    <artifactId>viewer-connector</artifactId>
    <version>22.10</version>
</dependency>

Der Goobi viewer Indexer hat die Versionsnummer 22.10 Das Goobi viewer Crowdsourcing Modul hat die Versionsnummer 22.10

Coming soon

• Überarbeitung des CMS-Bereichs

• kompakte und hochaufgelöste PDF Dateien

Entwicklungen

SAML / Shibboleth

Bereits im April 2020 wurde für die Authentifizierung eine erste SAML Implementierung in den Goobi viewer Core übernommen. Jetzt, zweieinhalb Jahre später, ist diese Implementierung vollständig und dabei so generisch geworden, dass sie zum Beispiel eine Authentifizierung über Shibboleth erlaubt.

Die jetzige Implementierung im Goobi viewer lehnt sich an dem an, was schon einige Zeit in Goobi workflow existiert und dort seine praxistauglichkeit unter Beweis gestellt hat. Die Lösung erlaubt für die Authentifizierung die Auswertung von HTTP-Headern oder Attributen. Das hat den großen Vorteil, dass sie für viele verschiedene Einsatzszenarien infrage kommen kann. Die eigentliche Authentifizierung wird - in dem konkreten Fall hier mit Shibboleth - jetzt nämlich dem shibd Service Provider und einem Apache Modul überlassen. Der Goobi viewer wertet am Ende nur noch das Ergebnis aus. Auf diese Art- und Weise sind noch viele weitere Authentifizierungsarten möglich.

Da die initiale Konfiguration ein bisschen komplexer ist, haben wir unsere Erfahrungen noch einmal in einem dedizierten Anwendungsfall beleuchtet. Siehe dazu auch Kapitel 1.14 im Abschnitt Verschiedenes in der Goobi viewer Dokumentation.

Snippets

• Wenn mehrere Goobi viewer Instanzen auf einem Server installiert sind und bisher bei jedem Update in der globalen Konfigurationsdatei der Standardpfad zum lokalen <configFolder /> angepasst werden musste, kann dieses ab sofort auch als Java Variable übergeben werden. Die Einstellung kann zum Beispiel in der /etc/default/tomcat9 erfolgen: JAVA_OPTS="${JAVA_OPTS} -DconfigFolder=/path/to/second/viewer/config/"

• Das Crowdsourcing Modul wurde intern auf die Standard Maven Orderstruktur umgestellt

• Basierend auf einer Diskussion im Community Forum hat es kleinere Änderungen an den Möglichkeiten zur Zitierempfehlung gegeben

• Im Goobi viewer Indexer wird nun bei einer gescheiterten Indexierung der Dateiname in der Fehleremail explizit genannt.

Codeanalyse

Die folgenden Screenshots zeigen die SonarCloud Analyse des aktuellen Releases. Weitere Informationen gibt es direkt auf der Projektseite.

Versionsnummern

Die Versionen die in der pom.xml des Themes eingetragen werden müssen um die in diesem Digest beschriebenen Funktionen zu erhalten lauten:

<dependency>
    <groupId>io.goobi.viewer</groupId>
    <artifactId>viewer-core</artifactId>
    <version>22.11.1</version>
</dependency>
<dependency>
    <groupId>io.goobi.viewer</groupId>
    <artifactId>viewer-core-config</artifactId>
    <version>22.11</version>
</dependency>
<dependency>
    <groupId>io.goobi.viewer</groupId>
    <artifactId>viewer-connector</artifactId>
    <version>22.11.1</version>
</dependency>

Der Goobi viewer Indexer hat die Versionsnummer 22.11 Das Goobi viewer Crowdsourcing Modul hat die Versionsnummer 22.11

Coming soon

• kompakte und hochaufgelöste PDF Dateien

Entwicklungen

Facettierung

Für CMS-Seiten wurde das neue Element "Facettierung" entwickelt. Es ist eine Mischung aus Suchtrefferliste und der Einschränkung nach Buchstaben so wie sie aus dem Stöbern bekannt ist. Während auf einer klassischen Stöbern-Seite eine Liste der Begriffe in Textform angezeigt wird, können mit dem Element auch Bilder angezeigt werden. Hier ein Beispiel, bei dem Monographien nach Anfangsbuchstaben nach Anfangsbuchstaben aufgelistet und facettiert werden können:

Hintergrundaufgaben

Unter der Haube hat sich in dem Monat Januar viel an Infrastruktur getan. Zwei in Goobi workflow bekannte Funktionen wurden ebenfalls in den Goobi viewer integriert:

1. eine Warteschlange (basierend auf ActiveMQ)

2. regelmäßige Aufgaben (basierend auf Quartz)

Die Funktionalität löst die bisher rein über die REST Schnittstelle und Cronjobs realisierten "Tasks" ab. Dafür wurde im Backend eine neue Seite "Hintergrundaufgaben" geschaffen. Sie teilt sich in drei Bereiche auf:

• Laufende Aufgaben

• Regelmäßige Aufgaben

• Abgeschlossene Aufgaben

Bei den laufenden Aufgaben wird der aktuelle Inhalt der Warteschlange angezeigt. Die Ausführung kann pausiert und fortgesetzt werden. In der Regel ist die Abarbeitung der laufenden Aufgaben sehr schnell, so dass es nur selten vorkommt, dass man hier in einer nicht pausierten Umgebung Einträge vorfindet. Wenn laufende Aufgaben vorliegen steht pro Aufgabentyp eine Box zur Verfügung die anzeigt wie viele Aufgaben existieren. Die Box kann optional aufgeklappt und einzelne Tickets aus der Queue gelöscht werden.

Bei den regelmäßigen Aufgaben existiert eine Liste mit Dingen, die gemäß eines Zeitplans regelmäßig ausgeführt werden können. Alle regelmäßigen Aufgaben können gemeinsam, aber auch nur einzelne für sich, pausiert werden. Es besteht die Möglichkeit eine regelmäßige Aufgabe auch einmalig auszuführen. Die Aktion wird wie gewohnt onHover über der jeweiligen Zeile eingeblendet.

Die abgeschlossenen Aufgaben sind ein Logbuch aus dem ersichtlich ist was wann ausgeführt wurde, ob die Bearbeitung erfolgreich war, wie viele Versuche dafür benötigt wurden und ob die Aufgabe am Ende erfolgreich oder nur mit einem Fehler abgeschlossen werden konnte. Einträge älter als 90 Tage werden automatisch gelöscht.

Werden laufende oder regelmäßige Aufgaben komplett pausiert visualisiert dieses ein Indikator in der Topbar.

Mit den Hintergrundaufgaben wird ein Systembruch entfernt und der Goobi viewer autarker, da er Funktionalität selbst implementiert und nicht mehr auf externe Dienste angewiesen ist. Durch die Warteschlange existiert eine Infrastruktur, mit der Aufgaben verlässlich auch über Neustarts der Applikation hinweg geplant und verarbeitet werden können. Sie ist bereits dafür vorbereitet Aufgaben auch über verschiedene Server hinweg zu Clustern sofern das notwendig wird. Über die Seite im Backend steht die Möglichkeit zur Verfügung Aufgaben für Wartungsarbeiten zu pausieren oder zu prüfen, ob alle Aufgaben ohne Fehler regelmäßig ausgeführt werden.

Snippets

• Die Dokumentation zum Aufsetzen der Entwicklungsumgebung wurde um einige Punkte ergänzt

• Der Goobi viewer Indexer hat einige Verbesserungen für die Indexierung von Dokumenten mit dem LIDO 1.1 Standard erhalten

• Im Goobi viewer Connector gab es Änderungen an der SRU Schnittstelle und der allgemeinen Wartbarkeit des Codes sowie der Testabdeckung

Codeanalyse

Die folgenden Screenshots zeigen die SonarCloud Analyse des aktuellen Releases. Weitere Informationen gibt es direkt auf der Projektseite.

Versionsnummern

Die Versionen die in der pom.xml des Themes eingetragen werden müssen um die in diesem Digest beschriebenen Funktionen zu erhalten lauten:

<dependency>
    <groupId>io.goobi.viewer</groupId>
    <artifactId>viewer-core</artifactId>
    <version>23.01.1</version>
</dependency>
<dependency>
    <groupId>io.goobi.viewer</groupId>
    <artifactId>viewer-core-config</artifactId>
    <version>23.01</version>
</dependency>
<dependency>
    <groupId>io.goobi.viewer</groupId>
    <artifactId>viewer-connector</artifactId>
    <version>23.01.1</version>
</dependency>

Der Goobi viewer Indexer hat die Versionsnummer 23.01 Das Goobi viewer Crowdsourcing Modul hat die Versionsnummer 23.01

Coming soon

• Highlights

• Suchtreffergruppen

Ankündigungen

Im Hintergrund sind wir in verschiedenen Projekten voll ausgelastet. Featureentwicklungen die hier genannt werden könnten sind noch nicht abgeschlossen und fließen nach der Fertigstellung im Projektkontext dann in die kommenden Releases ein.

Entwicklungen

RIS Export

Suchtreffer können jetzt auch im RIS Format exportiert werden. Die Funktionalität kann analog zu dem Excel-Export genutzt werden.

Docker Images

Das Unternehmen Docker Inc. hat in den letzten Monaten erst die Einstellung von kostenlosen Angeboten im Rahmen des Modells "Docker Free Team" angekündigt und Nutzer aufgefordert auf ein Bezahl-Abo-Modell umzustellen. Später wurde diese Ankündigung wieder zurückgezogen.

Wir haben uns dennoch entschieden von der Docker Hub Container Image Library zu der Github Container Registry zu wechseln.

Snippets

• Im Core ist die URL zur METS-Datei für den DFG-Viewer jetzt konfigurierbar. Das wird zum Beispiel benötigt, wenn diese in einem separaten Ordner liegen.

• Im Core wurde die Unterstützung von chinesischen Schriftzeichen in der Suche verbessert.

• Der Connector liefert XML-Antworten jetzt automatisch im korrekten Content Type aus

• Der Indexer hat verschiedene Verbesserungen erfahren, unter anderem eine bessere Fehlerbehandlung bei vermischten Rechten im Dateisystem

Codeanalyse

Die folgenden Screenshots zeigen die SonarCloud Analyse des aktuellen Releases. Weitere Informationen gibt es direkt auf der Projektseite.

Versionsnummern

Die Versionen die in der pom.xml des Themes eingetragen werden müssen um die in diesem Digest beschriebenen Funktionen zu erhalten lauten:

<dependency>
    <groupId>io.goobi.viewer</groupId>
    <artifactId>viewer-core</artifactId>
    <version>23.04</version>
</dependency>
<dependency>
    <groupId>io.goobi.viewer</groupId>
    <artifactId>viewer-core-config</artifactId>
    <version>23.04</version>
</dependency>
<dependency>
    <groupId>io.goobi.viewer</groupId>
    <artifactId>viewer-connector</artifactId>
    <version>23.04</version>
</dependency>

Der Goobi viewer Indexer hat die Versionsnummer 23.04 Das Goobi viewer Crowdsourcing Modul hat die Versionsnummer 23.04

Coming soon

• Suchmaschinenoptimierung

• Live-Aufbereitung von Datensätzen

Ankündigungen

Entwicklungen

Suche

Bei der einfachen Suche wird das DropDown für die verschiedenen Suchfilter (Suche in Allen Daten, Metadaten, Volltexten, ... ) ausgeblendet, wenn nur eine einzige Option existiert.

Facettierung

Der Goobi viewer unterstützt die Suche in möglichen Werten einer Facette. Dafür wird in dem Titel des Widgets eine kleine Lupe angezeigt. Dieses Feature ergibt bei Facetten mit nur wenig Werten oder in manchen anderen Setups keinen Sinn. Aus diesem Grund kann jetzt über einen zusätzlichen Schalter in der Konfigurationsdatei pro Facette gesteuert werden, ob die Suche zur Verfügung stehen soll, oder nicht.

Stöbern

Innerhalb der Stöbern-Funktionalität werden jetzt auch Unterelementen von Datensätzen angezeigt, wenn diese das ausgewählte Feld:Wert Paar enthalten. Bisher wurde nur der Hauptdatensatz gefunden.

Anschaulicher wird es mit einem Beispiel aus der Praxis: Wenn es innerhalb eines Zeitschriftenbandes verschiedene Artikel mit verschiedenen Autoren gibt, dann werden in der Stöbern-Funktionalität alle Autoren aufgelistet, auch die der Zeitschriften-Artikel. Hat man dann auf einen Autoren geklickt wurde der Band angezeigt. Jetzt wird der Band angezeigt und dazu der Untetreffer mit dem dazugehörigen Zeitschriften-Artikel sowie dem hervorgehobenen Namen, der für den Treffer verantwortlich ist.

Goobi viewer Indexer

Der Goobi viewer Indexer hat verschiedene kleinere Verbesserungen erhalten. So wurde zum Beispiel die Erkennung von Bänden präzisiert, wenn ein <mods:relatedItem type="host" /> etwas anderes beschreibt. Weiter wurde das Löschen von verwaisten Informationen aus dem Solr verbessert, wenn zum Beispiel ein Band fälschlicherweise mit dem Identifier des Anchors exportiert und das nachträglich korrigiert wurde.

Zuletzt wurde die Abfrage eines externen Katalogs zur Indexierung weiterer Metadaten erweitert, so dass auch eine OAI Schnittstelle abgefragt werden kann. Die Funktionalität wurde im Februar 2021 hinzugefügt und im damaligen Digest beschrieben.

Coming soon

• Neuerungen bei den Zugriffsbeschränkungen

• Überarbeitung des CMS-Bereichs

Entwicklungen

E-Pflicht

Allgemein

Gemeinsam mit der Zentral- und Landesbibliothek Berlin (ZLB) entwickeln wir eine Open Source Lösung für die Verarbeitung und Bereitstellung von E-Pflicht-Publikationen. Dabei werden sowohl Goobi workflow als auch der Goobi viewer um entsprechende Funktionalitäten und Systemkomponenten erweitert.

In Goobi workflow wird die Abliefernden-Verwaltung und Registrierung, die Ablieferungsschnittstellen und der Ablieferungsprozess gesteuert. Der Goobi viewer übernimmt die rechtskonforme Bereistellung der E-Pflicht Inhalte.

Die Entwicklungen sind noch nicht abgeschlossen aber erste Teile sind in dem Juni Release enthalten. Diese sind im folgenden beschrieben.

Client (Preview)

Der Client ist eine Desktop Applikation, die unter Windows, Mac und Linux funktioniert. Konfiguriert werden kann der Name des Clients, die zu verwendenden Icons, der zu verwendende Goobi viewer Server, unterstützte Sprachen und so weiter. Nach der Konfiguration wird der Client kompiliert. Dadurch entsteht eine native Anwendung für das jeweilige Betriebssystem.

Unter Windows kann auch ein Installer in Form einer setup.exe Datei erstellt werden. Dieser unterstützt eine sogenannte "Silent Installation", um den Client automatisch mit Systemen wie zum Beispiel OPSI oder baramundi auf vielen PCs gleichzeitig zu deployen. Der Client selber unterstützt den Parameter myid. Dieser gibt nur die einzigartige ID aus, die dann in entsprechenden Skripten für die automatische Freischaltung am Backend weiterverwendet werden kann.

Über den Client selber ist sichergestellt, dass zum Beispiel Screenshots, das Kopieren in die Zwischenablage oder auch das Speichern und Drucken von Dokumenten unterbunden ist. Die Restriktionen können sich je nach Betriebssystem unterscheiden.

Der Client wird voraussichtlich kommenden Monat auf Github als Open Source veröffentlicht.

Clientverwaltung

Im Backend des Goobi viewers gibt es eine neue Seite zur Verwaltung der Clients. Ein Client ermittelt zur Laufzeit eine für sich einzigartiges ID und überträgt diese mit an den Server. Der Server prüft dann ob diese bekannt und konfiguriert ist. Jeder Client muss mit seiner ID, sowie einem IP-Adressbereich aus dem er sich verbinden darf, bestätigt werden.

Um einen Client zu bestätigen gibt es zwei Möglichkeiten: Über die graphische Oberfläche im Backend oder über die REST API.

Gibt es einen nicht konfigurierten Client wird im Backend ein entsprechendes Widget auf dem Dashboard angezeigt. Auf der Seite "Clients" werden nicht konfigurierte im oberen Bereich aufgelistet. Darunter gibt es eine Tabelle, die alle bekannten, bereits konfigurierten Clients auflistet. Wird ein nicht konfigurierter Client angeklickt kann er bestätigt oder abgelehnt werden. Für jeden Client kann optional ein Name und eine Beschreibung hinterlegt werden.

Alternativ stehen auch neue REST Endpoints für die Clientverwaltung zur Verfügung. Sofern der richtige TOKEN mitgesendet wird können Clients auch darüber akzeptiert und konfiguriert oder abgelehnt werden. Dadurch kann auch bei einem automatischen Deployment auf vielen PCs gleichzeitig jeder Client gleich freigeschaltet werden ohne, dass dafür eine manuelle Interaktion notwendig ist

Clients sind am Ende Rechtenehmer wie Benutzer, Benutzergruppen oder IP-Bereiche und können mit Zugriffsbeschränkungen kombiniert werden. Dadurch können Datensätze oder auch nur bestimmte Funktionen wie der Zugriff auf Bilder / Dateien etc. auf einen oder alle Clients beschränkt werden.

Suche

Der Goobi viewer Indexer schreibt nun auch ein Feld, in dem nur der Tag und der Monat stehen. Dadurch ist es möglich alle Datensätze zu finden, die zu einem bestimmten Tag gehören, unabhängig von der Jahreszahl. Hierfür steht das neue URL-Pattern /searchtoday/ zur Verfügung, dass dann automatisch auf das aktuelle Datum übersetzt.

Zugriffsbeschränkungen

Schon lange kann der Goobi viewer mit einer Moving Wall umgehen. Allerdings waren wir mit der Konfiguration nicht zufrieden: Unterschiedliche Felder für Jahr und Datum sowie ein Schalter im Backend UND eine Bedingung die eingeben beziehungsweise im Blick behalten werden musste.

Mit diesem Release wurde das Prozedere vereinfacht. Das Datum wird jetzt einheitlich im Feld DATE_PUBLICRELEASEDATE gespeichert und dort auch automatisch normalisiert. Aus einer Jahreszahl innerhalb der Moving Wall wird automatisch der erste Januar des angegebenen Jahres um 00:00 Uhr. Damit entfällt auch die Notwendigkeit zur Formulierung einer Solr-Query als Bedingung, da nicht mehr zwischen MDNUM_ und DATE_ Feldern unterschieden werden muss. Die Bedingung wird nun automatisch gesetzt, wenn der Toggle im Backend für die Moving Wall aktiviert wurde.

Websockets

Der Goobi viewer verwendet an verschiedenen Stellen Websockets. Eine Stelle ist die Ermittlung der Information wie häufig ein Datensatz gleichzeitig betrachtet wird, sofern diese Zugriffsbeschränkung konfiguriert wurde.

Das Öffnen von entsprechenden Websockets findet jetzt nicht mehr grundsätzlich global, sondern nur noch auf den Seiten der entsprechenden Datensätze statt. Dadurch konnte die Anzahl der notwendigen Apache Prozesse signifikant reduziert werden.

Versionsnummern

Die Versionen die in der pom.xml des Themes eingetragen werden müssen um die in diesem Digest beschriebenen Funktionen zu erhalten lauten:

<dependency>
    <groupId>io.goobi.viewer</groupId>
    <artifactId>viewer-core</artifactId>
    <version>22.06.4</version>
</dependency>
<dependency>
    <groupId>io.goobi.viewer</groupId>
    <artifactId>viewer-core-config</artifactId>
    <version>22.06.1</version>
</dependency>
<dependency>
    <groupId>io.goobi.viewer</groupId>
    <artifactId>viewer-connector</artifactId>
    <version>22.06</version>
</dependency>

Der Goobi viewer Indexer hat die Versionsnummer 22.06

Das Goobi viewer Crowdsourcing Modul hat die Versionsnummer 22.06.1

Coming soon

• Neuerungen bei den Zugriffsbeschränkungen

• Überarbeitung des CMS-Bereichs

Behind the scenes

Im ersten halben Jahr haben wir bereits viele Projekte abgeschlossen. Zwei davon möchten wir exemplarisch an dieser Stelle erwähnen und einladen in den Ergebnissen zu stöbern.

Sudan Memory

Das Projekt „Sudan Memory“ versucht, wertvolles kulturelles Material aus und über den Sudan durch Digitalisierung und über eine Online-Plattform zu bewahren und zu fördern. Im ganzen Land sind viele interessante und reichhaltige Archive aus einer Reihe von Gründen gefährdet: extreme Wetterbedingungen, Mangel an geeigneten Lagerbedingungen, Vernachlässigung und Konflikte. Auch viele öffentliche und private Sammlungen sind verschlossen und schwer zugänglich.

Unsere Mission ist es, diese Archive und ihre Geschichten zu bewahren, damit heutige und zukünftige Generationen von diesem wertvollen und wichtigen Erbe profitieren können.

ZentralGut

ZentralGut eröffnet Chancen, um Kulturgut der Region Zentralschweiz ortsungebunden und barrierearm zugänglich zu machen und vielschichtig zu präsentieren. Das Portal für digitalisiertes Zentralschweizer Kulturgut steht interessierten Gedächtnis- und Kulturinstitutionen aus der Region offen, um Objektabbildungen, Fotografien und Texte aus ihren Beständen zu veröffentlichen.

ZentralGut ist eine vielfältige regionale Kulturgut-Plattform, die – wie unser Kulturerbe selbst – sich stetig erweitert und aktualisiert. In den Texten, Bild, Ton- und Videodokumenten kann recherchiert werden, bestehende Objekte kommentiert und umfangreiche Citizen Science-Projekte umgesetzt werden. Aber nicht nur Institutionen, sondern auch Privatpersonen sind eingeladen, ihr Wissen über die Region zu teilen und ihre eigenen Schätze beizusteuern.

Entwicklungen

Hardening

In diesem Release haben wir an der Verbesserung der Sicherheit des Goobi viewers gearbeitet. Dabei haben wir verschiedene Bereiche in den Blick genommen und verbessert.

Passwörter

Passwörter müssen eine Mindestlänge von 8 Zeichen haben. Diese Prüfung gibt es schon länger, war jedoch an einigen Stellen nicht aktiv, so dass teilweise auch kürzere Passwörter akzeptiert wurden. Das Verhalten ist jetzt abgestellt. Zusätzlich wurde der Validator erweitert, so dass auch die maximal erlaubte Bytezahl des verwendeten bcrypt Hashalgorithmus mit geprüft wird.

Möchte ein Benutzer sein Passwort ändern ist ab sofort notwendig auch das aktuelle Passwort einzugeben. Wenn sich ein Benutzer zum Beispiel im Lesesaal nicht korrekt abgemeldet hat, kann ein anderer Benutzer nicht einfach das Passwort ändern. Administratoren können Passwörter weiterhin ohne weitere Kenntnis zurücksetzen.

Brute-Force

Um Brute-Force Attacken zu erschweren wird bei einem fehlgeschlagenen Anmeldeversuch ein Zähler für die eingegebene E-Mailadresse hochgezählt. Nach einem fehlgeschlagenen Anmeldeversuch muss die Anzahl der fehlgeschlagenen Versuche mal drei Sekunden gewartet werden. Versuche vor Ablauf der Wartezeit werden grundsätzlich abgewiesen. Beim nächsten erfolgreichen Login werden alle Zähler zurückgesetzt.

Konfiguration

Die Apache Web- und Tomcat Applicationserver Standardeinstellungen wurden sowohl in den Installationsanleitungen für die klassische und die Docker basierte Installation, als auch in der Updateanleitung angepasst, so dass sie eine höhere Sicherheit bieten und weniger allgemeine Systeminformationen preisgeben.

Upload von Datensätzen

Eine neue Funktionalität ermöglicht es Besuchern des Goobi viewers eigene Inhalte beizutragen. Dadurch entstehen neue Möglichkeiten für Einrichtungen zur Interaktion. Die Funktionalität kann in der Konfigurationsdatei aktiviert werden.

Einmal eingerichtet steht angemeldeten Besuchern der neuer Bereich "Inhalte beitrage" zur Verfügung. In einem sehr einfachen Formular kann ein Titel und eine optionale Beschreibung eingegeben, sowie die Bilder hochgeladen werden. Beim Absenden wird dann im Hintergrund automatisch ein Vorgang innerhalb von Goobi workflow angelegt. Dort können die Angaben dann geprüft werden:

• Entsprechen die hochgeladenen Daten den gewünschten Anforderungen?

• Passen Titel und Beschreibung?

• Wie sieht es mit Copyright aus?

• ...

Für eine optionale Klärung wird die E-Mailadresse des Benutzers angezeigt, der die Inhalte beigetragen hat.

Der Goobi viewer prüft periodisch den Status der eingereichten Inhalte. Dabei gibt es drei mögliche Status:

• Warten. Dieser Status wird über eine Sanduhr visualisiert. Er bedeutet, dass die Bearbeitung innerhalb von Goobi workflow noch aussteht.

• Erfolgreich. Dieser Status wird über einen Haken visualisiert. Er bedeutet, dass die Bearbeitung erfolgreich abgeschlossen und der Datensatz in den Goobi viewer exportiert wurde.

• Abgewiesen. Der Status wird über ein X visualisiert. Er bedeutet, dass der Vorgang in Goobi workflow nicht gefunden werden kann, ODER, dass er abgelehnt wurde. Wenn dabei eine Begründung eingegeben wurde, dann wird diese ebenfalls im Goobi viewer angezeigt.

Mit der neuen Funktionalität wird das Portfolio für die Interaktion zwischen Nutzern und Einrichtungen um eine neue Option erweitert. Mit der Nutzung der bewährten Infrastruktur von Goobi workflow sind auch gleich nicht nur alle Fragen zur Moderation, sondern auch zum Backup, Archivierung etc. beantwortet.

Kampagnen

Für Kampagnen ist es ab sofort konfigurierbar, ob Inhalte in einer fester Reihenfolge oder zufällig geöffnet werden.

Außerdem ist es jetzt möglich für die Georeferenzierung innerhalb der Kampagnen die reguläre OpenStreetMap Ansicht zu verwenden. Auch der Mittelpunkt und der Standard Zoomfaktor sind jetzt einstellbar. Dadurch kann auch ein nicht deutschlandzentrierter Einstieg gewählt werden.

Snippets

• Annotationen werden nun besser in der Suche gefunden und dargestellt

• Alternative URLs für CMS-Seiten können jetzt keine Leerzeichen mehr enthalten

• An verschiedenen Stellen wurde Deutsch als hart codierte Standard-Fallback-Sprache entfernt und durch den konfigurierten Standardwert ersetzt.

Versionsnummern

Die Versionen die in der pom.xml des Themes eingetragen werden müssen um die in diesem Digest beschriebenen Funktionen zu erhalten lauten:

<dependency>
    <groupId>io.goobi.viewer</groupId>
    <artifactId>viewer-core</artifactId>
    <version>22.05</version>
</dependency>
<dependency>
    <groupId>io.goobi.viewer</groupId>
    <artifactId>viewer-core-config</artifactId>
    <version>22.05</version>
</dependency>
<dependency>
    <groupId>io.goobi.viewer</groupId>
    <artifactId>viewer-connector</artifactId>
    <version>22.05</version>
</dependency>

Der Goobi viewer Indexer hat die Versionsnummer 22.05

Das Goobi viewer Crowdsourcing Modul hat die Versionsnummer 22.05

Coming soon

• Upload von Datensätzen

• Überarbeitung des CMS-Bereichs

• Neuerungen bei den Zugriffsbeschränkungen

Entwicklungen

Karten

Wenn auf einer Karte viele Marker angezeigt werden sollen dann werden je nach Zoomstufe nahe beieinander liegende Marker zusammengefasst. Eine Zahl zeigt an, wie viele Marker sich in dem Bereich befinden. Klickt man darauf wird die Zoomstufe erhöht und man sieht eine genauere Position der Marker.

Diese Logik fand bisher komplett im Webbrowser statt. Der Nachteil von der Lösung war, dass alle Einzelpositionen erst übertragen werden mussten bevor dann die Berechnung stattfand. Ab ca. tausend Markern hat das zu einer Verlangsamung bei der Performance geführt.

In den letzten Monaten haben wir eine Lösung entwickelt, die es ermöglicht serverseitig zu ermitteln wie viele Marker sich in einem Gebiet befinden. Diese Funktionalität ist in dem aktuellen Release enthalten. Sie kann über neue Schalter in der Konfigurationsdatei bei Bedarf ein- oder ausgeschaltet werden. Wenn aktiv können auch Karten mit mehreren tausend Markern performant dargestellt werden.

Goobi viewer Indexer

Im Goobi viewer wurde eine Java-Libraries für die Generierung von GeoJSON ersetzt, so dass verschiedene andere Libraries auf den aktuellen Stand gebracht werden konnten. Außerdem konnte ein Bug identifiziert werden bei dem Threads nicht geschlossen wurden.

Snippets

• Bei definierten IP-Adressbereichen im Backend werden nun Network- und Broadcast-Adressen ebenfalls mit bedacht.

• Die Zitierlinks haben jetzt eine angepasste Konfiguration über Pattern. Dadurch können die URLs für die Zitierlinks besser konfiguriert werden und auch besondere Konstellationen wie bei ARK Identifiern sind dadurch möglich.

• In dem CMS-Template mit der Sammlungsauflistung in der Akkordeonansicht ist es jetzt möglich die Sammlungen auch numerisch zu sortieren.

Versionsnummern

Die Versionen die in der pom.xml des Themes eingetragen werden müssen um die in diesem Digest beschriebenen Funktionen zu erhalten lauten:

<dependency>
    <groupId>io.goobi.viewer</groupId>
    <artifactId>viewer-core</artifactId>
    <version>22.04</version>
</dependency>
<dependency>
    <groupId>io.goobi.viewer</groupId>
    <artifactId>viewer-core-config</artifactId>
    <version>22.04</version>
</dependency>
<dependency>
    <groupId>io.goobi.viewer</groupId>
    <artifactId>viewer-connector</artifactId>
    <version>22.04</version>
</dependency>

Der Goobi viewer Indexer hat die Versionsnummer 22.04

Das Goobi viewer Crowdsourcing Modul hat die Versionsnummer 22.04

Coming soon

• Anzeige eines Disclaimers für Werke

• Kommentarsichten

• Upload von Datensätzen

Ankündigungen

Dieser Digest erscheint zu einer Zeit, in der in Europa ein Krieg ausgebrochen ist. Uns erreichen entsetzliche Nachrichten aus der Ukraine.

Wir stehen in Solidarität mit allen Menschen, die von diesem schrecklichen Krieg betroffen sind.

Entwicklungen

Cookie Banner

Der Goobi viewer kann jetzt einen Cookie Banner anzeigen. Dieser wird im Backend konfiguriert. Die Funktionalität kann dort ein- oder ausgeschaltet und der Text für den Banner verwaltet werden. Außerdem steht eine Liste von CMS-Seiten zur Verfügung, auf denen der Banner nicht angezeigt werden soll. Das kann zum Beispiel für ein Impressum, eine Datenschutz- oder eine Cookie-Richtlinien-Seite notwendig sein. Weiter ist es Möglich die Zustimmung von Nutzern zurückzusetzen, zum Beispiel wenn es bei dem Text eine Änderung gab und eine erneute Zustimmung notwendig ist.

Der Cookie Banner ist mit der Matomo Tracking Funktionalität verknüpft. Sind beide aktiv, findet ein Tracking erst dann statt, wenn der im Banner angezeigte Text akzeptiert wurde. Wird der Text nicht akzeptiert, dann wird das Tracking unterbunden.

Die Information über Zustimmung oder Ablehnung des Textes wird im Local Storage des Browsers gespeichert. Damit ist sie über die Session hinaus gültig und dem Text muss nur einmalig zugestimmt werden.

Datenbank

Im Goobi viewer haben wir seit vielen Jahren ein sehr simples aber effektives Prinzip in der Entwicklung:

Bugfix geht vor Feature

Das bedeutet konkret, dass wenn wir einen Bug in der Software sehen oder gemeldet bekommen, dieser behoben wird bevor wir mit der Entwicklung von neuen Features fortfahren. Die Bugfixes fließen dann in die aktuelle Codebasis ein und - sofern möglich und nötig - portieren wir den konkreten Fix auch in frühere Versionen zurück.

In der Praxis sind das oft nur Fragen von einer halben Stunde oder einer weniger Zeilen Quelltext. Mehr braucht es häufig nicht und man kann die Arbeiten gut am Anfang oder Ende des Tage einplanen.

In diesem Monat hatten wir einen Fehler anderer Güte. Dabei verlor der Goobi viewer quasi aus heiterem Himmel seine Datenbankanbindung. Von jetzt auf gleich wurde beim Aufruf einer Seite die Meldung angezeigt "Connection has already been closed". Das Einzige was dann geholfen hat war den Tomcat Prozess komplett neu zu starten.

Uns alle hat dieser Fehler vor ein Rätsel gestellt, denn der Goobi viewer verwaltet die Datenbankanbindung gar nicht selbst sondern der Tomcat übernimmt das und reicht sie nur weiter. Der wiederum hatte jederzeit genügend offene und nicht genutzte Verbindungen, auch, wenn der Goobi viewer die Fehlermeldung gab waren die Verbindungen noch aktiv. Erschwerend kam hinzu, dass wir absolut keine Möglichkeit hatten den Fehler selbst bei uns zu nachzustellen oder zu provozieren. Wir konnten nur auf installierten Live-Systemen das Symptom sehen. Ein Nachstellen in der Entwicklungsumgebung war hingegen nicht möglich. Das Symptom trat manchmal fünf Minuten nach dem Start des Tomcats auf und dann wieder erst nach zwei Tagen. Ohne für uns erkennbare Unterschiede in der Nutzung...

Diverse Kollegen haben sich dann auf die Suche begeben. Zuerst im Quelltext ob irgendwelche Verbindungen versehentlich geschlossen werden. Auf dieser Suche wurden zwar Bugs gefunden und behoben, aber keine die konkret damit in Verbindung standen. Die Analyse wurde dann ausgeweitet auf andere Teile in der Kette: Tritt der Fehler nur mit MariaDB oder auch mit MySQL auf? Tritt der Fehler bei älteren oder neueren Tomcat Versionen nicht mehr auf? Tritt der Fehler bei einer Änderung des Connectors auf, mit dem der Tomcat sich zur Datenbank verbindet? Was passiert, wenn wir die (seit Jahren unveränderten) Parameter ändern, mit denen der Tomcat eine Verbindung zur Datenbank aufbaut? Alle Ansätze wurden geprüft und bei jeder Änderung mussten wir auf den installierten Systemen gucken ob diese zum Erfolg führen. Leider war das Ergebnis immer wieder aufs neue ernüchternd: Alle Maßnahmen führten zu keiner Änderung. Wir konnten also ab einem gewissen Zeitpunkt mit recht hoher Gewissheit sagen, dass kein Fehler im Code die Verbindung schließt und auch das Setup und die Komponenten dazwischen nicht Ursächlich sind. Der Fehler existierte aber weiterhin.

Inzwischen hatten wir ein Logging aktiviert, das zu mehreren GB großen Logdateien pro Stunde führte. Damit wurde wirklich alles was der Goobi viewer mit der Datenbank machte geloggt. Hier ein Beispiel für das Logging einer einfachen SQL Abfrage:

[EL Finer]: connection: 2022-02-24 05:01:56.878--ServerSession(1137386215)--Thread(Thread[ajp-nio-0:0:0:0:0:0:0:0-8009-exec-1,5,main])--client acquired: 33039885
[EL Finer]: transaction: 2022-02-24 05:01:56.878--ClientSession(33039885)--Thread(Thread[ajp-nio-0:0:0:0:0:0:0:0-8009-exec-1,5,main])--acquire unit of work: 964015310
[EL Finest]: query: 2022-02-24 05:01:56.879--UnitOfWork(964015310)--Thread(Thread[ajp-nio-0:0:0:0:0:0:0:0-8009-exec-1,5,main])--Execute query ReadAllQuery(referenceClass=CMSStaticPage sql="SELECT static_page_id, cms_page_Id, static_page_name FROM cms_static_pages WHERE (cms_page_Id = ?)")
[EL Finest]: connection: 2022-02-24 05:01:56.879--ServerSession(1137386215)--Connection(1350487645)--Thread(Thread[ajp-nio-0:0:0:0:0:0:0:0-8009-exec-1,5,main])--Connection acquired from connection pool [read].
[EL Finest]: connection: 2022-02-24 05:01:56.879--ServerSession(1137386215)--Connection(1350487645)--Thread(Thread[ajp-nio-0:0:0:0:0:0:0:0-8009-exec-1,5,main])--reconnecting to external connection pool
[EL Fine]: sql: 2022-02-24 05:01:56.879--ServerSession(1137386215)--Connection(2077776754)--Thread(Thread[ajp-nio-0:0:0:0:0:0:0:0-8009-exec-1,5,main])--SELECT static_page_id, cms_page_Id, static_page_name FROM cms_static_pages WHERE (cms_page_Id = ?)
        bind => [60]
[EL Finest]: connection: 2022-02-24 05:01:56.879--ServerSession(1137386215)--Connection(1350487645)--Thread(Thread[ajp-nio-0:0:0:0:0:0:0:0-8009-exec-1,5,main])--Connection released to connection pool [read].
[EL Finer]: transaction: 2022-02-24 05:01:56.879--UnitOfWork(964015310)--Thread(Thread[ajp-nio-0:0:0:0:0:0:0:0-8009-exec-1,5,main])--release unit of work
[EL Finer]: connection: 2022-02-24 05:01:56.879--ClientSession(33039885)--Thread(Thread[ajp-nio-0:0:0:0:0:0:0:0-8009-exec-1,5,main])--client released

Nachdem mehrere Kollegen über mehrere Tage rhythmisch auf diese wachsenden Logfiles gestarrt haben wurden neue Fragen formuliert und recherchiert. Am Dienstag Morgen gab es dann einen neuen Ansatz: Muss die Art- und Weise der Implementierung für jede einzelne Datenbankanbindung vielleicht anders sein? Diese existiert zwar schon immer auf genau diese Art- und Weise, aber vielleicht entspricht sie nicht dem Best-Practice? Zumindest gab es nach dem Lesen von Dokumentationen und Tutorials dazu neue Ideen. Nach kurzer Diskussion haben wir uns dann dazu entschlossen diesen Weg zu gehen. Mehrere Kollegen waren inzwischen davon überzeugt, dass eine solche Änderung auf jeden Fall eine Verbesserung des Codes darstellt, auch wenn nicht 100%tig gesagt werden kann ob die bisherige Implementierung "falsch".

Viele viele Arbeitsstunden und mehrere tausend veränderter Codezeilen später war es dann soweit und wir konnten einen -SNAPSHOT auf den Systemen prüfen die verlässlich weiterhin in nicht definierbaren Abständen zufällig die Anbindung verloren. Ab da hieß es warten und hoffen...

Am Ende stellte sich genau diese Änderung dann als Lösung herausgestellt. Alle Systeme auf denen wir die -SNAPSHOT Version installiert haben sind haben die Anbindung seitdem nicht mehr verloren. Die Graphen im Monitoring sind dabei komplett unverändert.

Es war nicht immer leicht dem Prinzip "Bugfix geht vor Feature" im vergangenen Monat treu zu bleiben. Unsere Releaseplanung und Roadmap verschiebt sich dadurch signifikant, denn wenn wir jetzt am Ende die Zeiten aller beteiligter Kollegen zusammenrechnen die an dem Problem gearbeitet haben, dann ist das fast ein kompletter Arbeitsmonat Entwicklungszeit.

CMS

Es können jetzt CMS-Seiten als Startseite für ein Werk festgelegt werden. Dadurch ist es möglich beim Öffnen von Werken über den RSS-Feed, die Suchtrefferliste oder verschiedene Resolver direkt auf eine CMS-Seite zu leiten, die weitere Informationen zu dem Werk enthält.

Diese Funktionalität steht zur Verfügung, wenn eine CMS-Seite die Option "Verknüpftes Werk" zusammen mit der Option "Als Standardansicht für verknüpftes Werk verwenden" aktiviert hat.

Suche

Bisher wurden die Werte in den Facetten immer übersetzt. Das ist zum Beispiel notwendig um nicht den internen Wert "lat", sondern dessen Übersetzung "Latein" anzuzeigen.

Es gibt aber auch Fälle, in denen das Verhalten nicht gewünscht ist. Zum Beispiel, wenn die verwendeten Schlagworte in englischer Sprache vorliegen und auch als solche sichtbar sein sollen. Dann würde der Werte "work" als "Werk" übersetzt werden, obwohl inhaltlich "Arbeit" gemeint ist.

Aus diesem Grund gibt es jetzt einen neuen Schalter in der Konfigurationsdatei, bei dem die Übersetzung von Werten in ausgewählten Facetten optional deaktiviert werden kann.

Archiv

Das bisher nur in der Werkansicht zur Verfügung stehende Widget für die Einordnung von archivalischen Beständen steht jetzt auch in der Vollbildansicht zur Verfügung.

Archivbestände wurden bisher pro Session geladen und im Speicher vorgehalten. Um hier bei vielen Aufrufen einem potentiell großen Speicherverbrauch vorzubeugen wurde dieses Verhalten umgestellt, so dass die Bestände Applikationsweit vorgehalten werden. Dadurch ist der Speicherverbrauch auch bei vielen Zugriffen immer identisch.

Backend

Einigen sind die kleinen Indikatoren in der Seitenleiste auf den Screenshots oben vielleicht bereits aufgefallen. Diese stehen ab sofort für die Seite "Zugriffslizenzen" und "Übersetzungen" zur Verfügung und weisen auf potentielle Aufgaben in den Bereichen hin.

Versionsnummern

Die Versionen die in der pom.xml des Themes eingetragen werden müssen um die in diesem Digest beschriebenen Funktionen zu erhalten lauten:

<dependency>
    <groupId>io.goobi.viewer</groupId>
    <artifactId>viewer-core</artifactId>
    <version>22.02</version>
</dependency>
<dependency>
    <groupId>io.goobi.viewer</groupId>
    <artifactId>viewer-core-config</artifactId>
    <version>22.02</version>
</dependency>
<dependency>
    <groupId>io.goobi.viewer</groupId>
    <artifactId>viewer-connector</artifactId>
    <version>22.02</version>
</dependency>

Der Goobi viewer Indexer hat die Versionsnummer 22.02

Das Goobi viewer Crowdsourcing Modul hat die Versionsnummer 22.02

Coming soon

• Performance für Karten mit vielen Pins

• Upload von Datensätzen

• Überarbeitung des CMS-Bereichs

Entwicklungen

Disclaimer Modal

Immer wieder kommt es vor, dass für angezeigte Inhalte ein zusätzlicher Kontext notwendig ist. Dafür wurde vor einiger Zeit bereits das Konzept der Werkshinweise realisiert.

Neu ist jetzt ein Disclaimer Modal, dass aktiv von Besuchern bestätigt werden muss. Dadurch ist es jetzt möglich über sensible Inhalte, wie zum Beispiel aus dem Bereich der Ethnologie oder jüdischem Archivgut, direkter zu Informieren und von den Besuchern eine Interaktion / Bestätigung zu verlangen.

Im Backend gibt es dafür den neuen Bereich "Disclaimer", in dem neben der Aktivierung oder Deaktivierung der Funktionalität selbst, der angezeigte Text, die Art der Anzeige und die Gültigkeit gesteuert werden kann. Der Text im Modal kann mit HTML formatiert und wie gewohnt in allen aktiven Sprachen hinterlegt werden.

Für die Anzeige kann konfiguriert werden, ob das Modal prinzipiell auf jeder Seite des Goobi viewers oder nur in bestimmten Datensätzen angezeigt werden soll. Die Datensätze lassen sich dann mit einer Solr-Query eingrenzen.

Bei der Gültigkeit steht entweder die Browser-Session oder eine Dauer in Tagen zur Auswahl. Das bedeutet, dass das Modal zum Beispiel beim ersten Aufrufen egal welcher Seite bestätigt werden muss und dann innerhalb der Browser Session nicht erneut angezeigt wird. Alternativ kann das Modal auch nur in bestimmten Werken angezeigt und bestätigt werden und diese Bestätigung gilt dann zum Beispiel für zwei Wochen.

Sofern der Text geändert wird, kann die Bestätigung der Benutzer, analog zu den Nutzungsbedingungen oder dem Cookie-Banner, zurückgesetzt werden.

Die Gültigkeit kann außerdem in den Rechte-Bereich überschrieben werden. Damit kann zum Beispiel ein Hinweis grundsätzlich eine Gültigkeit von 14 Tagen, innerhalb des Lesesaals aber nur von einer Browser Session haben.

Barrierefreiheit

Die Arbeiten an der Barrierefreiheit des Goobi viewers gehen beständig weiter. So haben wir in den letzten Monaten vor allem die Benutzung von Tabellen auf Screenreadern überarbeitet. Außerdem wurden Links und Buttons inhaltlich überprüft, so dass Links immer Seiten aufrufen und Buttons immer eine Aktion ausführen.

Kommentare

Bei den Kommentaren wurde das Konzept der Kommentargruppen komplett neu entwickelt. Zielsetzung war, das wenn mehrere Partner Inhalte in ein Portal beisteuern, die einzelnen Partner eine einfache Übersichts- und Moderationsmöglichkeit für die Kommentare bekommen, die zu Datensätze der eigenen Einrichtung verfasst wurden.

Aus dieser Anforderung heraus sind letztlich die Kommentargruppen entstanden. Diese basieren auf einer Solr-Query. Es sind dann alle Kommentare sichtbar, die zu den Werken innerhalb der Solr-Query angelegt wurden. Eine Kommentargruppe kann dann für eine Benutzergruppe freigegeben werden. Damit verbunden sein kann das Recht zum Bearbeiten oder Löschen von Kommentaren selbst sowie einer E-Mailbenachrichtigung bei neuen Kommentaren.

Benutzeraccounts, die Mitglied in der Benutzergruppe sind, erhalten dann automatisch Zugriff auf das Backend. Zugänglich ist allerdings nur die freigegebene Kommentargruppe.

Weiter wurde die Verwaltung der Kommentare komplett ins Backend verlegt. Einstellungen innerhalb der Konfigurationsdatei müssen bei einem Update migriert werden. Der entsprechende Abschnitt in der Konfigurationsdatei entfällt.

Zugriffsbeschränkungen

Bei den Zugriffsbeschränkungen wurde die Terminologie verbessert. Bisher haben wir von "Zugriffslizenzen" gesprochen. Durch das darin enthaltene Wort "Lizenzen" gab es oft eine Assoziierung mit "CC0" oder "Public Domain", den Nutzungslizenzen. Um hier eine klarere Trennung vorzunehmen sprechen wir ab sofort von "Zugriffsbeschränkungen" und "Nutzungslizenzen". Alle Übersetzungen, Hilfetexte etc. wurden im Backend entsprechend angepasst.

Suche

Auch im Bereich der Bedienbarkeit von der Suche arbeiten wir langsam aber beständig weiter. Im vergangenen Monat gab es zwei Entwicklungen in diesem Bereich.

Die eine Entwicklung betrifft die erweiterte Suche und die Anzeige von DropDown Menüs. Sofern für ein ausgewähltes Feld jetzt weniger als 10 Einträge zur Verfügung stehen, geschieht dieses nämlich ab sofort automatisch. Dadurch entfällt einerseits die Notwendigkeit sich für alle Felder zu überlegen ob es Sinn ergibt diese Option zu aktivieren und andererseits erhöht sich dadurch die Bedienbarkeit erheblich, da Nutzern entsprechende Werte direkt angeboten werden. Der Schwellenwert von 10 kann bei Bedarf auch über ein Attribut in der Konfigurationsdatei angepasst werden.

Die andere Entwicklung betrifft die Suchtrefferanzeige. Gerade wenn Normdaten Indexiert werden gibt es bei unterschiedlichen Schreibweisen oft lange Listen an Werten die untereinander stehen. Diese Werte können für bestimmte Felder jetzt in einer Zeile angezeigt werden. Dadurch wird die Anzeige kompakter und die Übersicht steigt.

Goobi viewer Indexer

Der Goobi viewer Indexer kann nun bei METS-Dateien zwischen einer Neuindexierung und einem aktualisierten Datensatz unterscheiden. Das macht die Meldung von URNs an die DNB via epicur / OAI robuster.

Entwicklungsprozess

Schon lange arbeiten wir daran den Entwicklungsprozess kontinuierlich zu verbessern. In diesem Monat ist eine neue Facette dazugekommen, bei der wir die Prüfung auf Sicherheitslücken in unseren Arbeitsablauf integriert haben.

Konkret sieht das so aus, dass wir automatisch die von uns verwendeten Abhängigkeiten (zum Beispiel Java oder JavaScript libraries) mittels des Dependency-Check Maven Plugins gegen die OWASP (Open Web Application Security Projekt) Datenbank prüfen. Dabei wird versucht öffentlich bekannte Schwachstellen in den Abhängigkeiten eines Projektes zu identifizieren.

Dabei gibt es natürlich auch false-positives. Diese können von uns in einer Konfigurationsdatei hinterlegt werden. Unser Ziel ist es alle Anmerkungen durchzugehen, zu bewerten und dann im Entwicklungsprozess einen Schalter umzulegen, der builds automatisch fehlschlagen lässt, wenn eine Sicherheitslücke mit einem CVSSv3 Score größer als 5 im Projekt auftaucht.

Versionsnummern

Die Versionen die in der pom.xml des Themes eingetragen werden müssen um die in diesem Digest beschriebenen Funktionen zu erhalten lauten:

<dependency>
    <groupId>io.goobi.viewer</groupId>
    <artifactId>viewer-core</artifactId>
    <version>22.03.1</version>
</dependency>
<dependency>
    <groupId>io.goobi.viewer</groupId>
    <artifactId>viewer-core-config</artifactId>
    <version>22.03</version>
</dependency>
<dependency>
    <groupId>io.goobi.viewer</groupId>
    <artifactId>viewer-connector</artifactId>
    <version>22.03.1</version>
</dependency>

Der Goobi viewer Indexer hat die Versionsnummer 22.03

Das Goobi viewer Crowdsourcing Modul hat die Versionsnummer 22.03

Coming soon

• Überarbeitung des CMS-Bereichs

• Überarbeitung der erweiterten Suche

• Goobi Anwendertreffen

Entwicklungen

Config Editor

Endlich ist es soweit: Die Konfigurationsdateien des Goobi viewers können auch direkt im Backend bearbeitet werden. Dafür steht die neue Seite "Konfiguration" zur Verfügung. In der Sidebar gibt es eine Liste an Dateien die editierbar sind. Backups werden automatisch angelegt und können bei Bedarf heruntergeladen werden. Ein intelligenter Locking-Mechanismus verhindert das gleichzeitige Zugreifen auf einzelne Dateien von mehreren Personen. Das Speichern von invalidem XML wird unterbunden, so dass die Oberfläche der Goobi viewer aufgrund von Syntaxfehlern nicht einfach kaputt gehen kann.

Zugriffsbeschränkung und Nutzungslizenz

Ist der Zugriff auf ein Werk beschränkt und wenn ja was bedeutet das? Und ist ein Werk unter einer bestimmten Nutzungslizenz veröffentlicht und wenn ja welcher? Diese Fragen konnten bisher nur implizit oder versteckt beantwortet werden.

Ab sofort kann der Goobi viewer diese Information prominent in der Seitenleiste anzeigen. Direkt unterhalb der Navigation gibt es dafür ein neues Widget, dass beide Informationen auf einen Blick schnell zugänglich macht. Ob ein Werk einer Zugriffsbeschränkung unterliegt wird mit einem Schlosssymbol visualisiert. Die Nutzungslizenz hat ebenfalls entsprechende Icons. Per Klick auf das Widget werden weitere beschreibende Texte angezeigt. Diese werden über die Konfigurationsdatei gesteuert.

Eine Standardkonfiguration für die gängigsten Nutzungslizenzen wird mitgeliefert. Diese umfasst Lizenzen von Creative Commons, RightsStatements.org oder Beispiele für das deutsche Urheberrecht und VG Wort.

Die Information kann alternativ in Form einer Ampel neben neben der Überschrift oberhalb des Werkes angezeigt werden.

Zugriffsbeschränkungen

Datensätze die einer Zugriffsbeschränkung unterliegen können ab jetzt so konfiguriert werden, dass sie auf eine bestimmte URL weiterleiten. Dieses ist insbesondere dann praktisch, wenn ein Werk zurückgezogen wird und anschließend eine entsprechende Meldung angezeigt werden soll. Auch kann die Funktionalität im Zusammenspiel mit Goobi workflow dafür verwendet werden eine "Werk befindet sich in Digitalisierung" Meldung anzuzeigen.

Suche

Der Kopfbereich der Suchtrefferseite wurde überarbeitet, so dass jetzt deutlich mehr Platz zur Verfügung steht. Hier ein vorher / nachher Vergleich:

Nutzungszahlen

Ab sofort kann der Goobi viewer von sich aus die folgenden Nutzungszahlen zu einzelnen Datensätzen ermitteln und speichern:

• absolute Zahl der Seitenansichten (jeder Aufruf einer Seite eines Werkes)

• eindeutigen Seitenansichten (jeder Aufruf einer Seite eines Werkes wird pro Nutzersession nur einmal gezählt)

• absolute Zahl der Downloads (jeder Download einer Datei)

• eindeutige Downloads (jeder Download einer Datei wird pro Nutzersession nur einmal gezählt)

Eine Nutzersession ist dabei die Session aus Sicht des Goobi viewers.

Die Logik dabei ist, dass alle Aufrufe die ein Werk öffnen einer Datenbank zwischengespeichert werden. Volle Tage können dann in den Solr Suchindex übertragen werden. Sobald die Daten im Suchindex stehen können sie entweder in einem Widget angezeigt oder über die REST API abgerufen werden.

Snippets

• Werte von Metadaten können jetzt innerhalb eines IIIF Manifests dynamisch als seeAlso Referenz ausgegeben werden.

• Im Backend werden bei den Zugriffsbeschränkungen überschriebene Einträge in der Übersichts angezeigt.

Versionsnummern

Die Versionen die in der pom.xml des Themes eingetragen werden müssen um die in diesem Digest beschriebenen Funktionen zu erhalten lauten:

<dependency>
    <groupId>io.goobi.viewer</groupId>
    <artifactId>viewer-core</artifactId>
    <version>22.08.1</version>
</dependency>
<dependency>
    <groupId>io.goobi.viewer</groupId>
    <artifactId>viewer-core-config</artifactId>
    <version>22.08</version>
</dependency>
<dependency>
    <groupId>io.goobi.viewer</groupId>
    <artifactId>viewer-connector</artifactId>
    <version>22.08</version>
</dependency>

Der Goobi viewer Indexer hat die Versionsnummer 22.08.1

Das Goobi viewer Crowdsourcing Modul hat die Versionsnummer 22.08.1

Coming soon

• Überarbeitung des CMS-Bereichs

• Überarbeitung der erweiterten Suche

Ankündigungen

Im September haben wir viel an den Coming Soon Features gearbeitet. Leider sind diese noch nicht fertig für das Release, so dass der Digest in diesem Monat - auch bedingt durch die Goobi Tage - weniger umfangreich ausfällt.

Neu ist aber der Abschnitt "Codeanalyse", in der wir Informationen zu dem Release mitliefern.

Entwicklungen

Resolver

Der URN-Resolver kann jetzt URNs für ein Werk in mehr als nur einem Solr-Feld suchen. Dafür können jetzt in der Konfigurationsdatei beliebig viele Felder angegeben werden.

Suche

Im Quelltext gab es erste Vorarbeiten um die Feldauswahl bei der erweiterten Suche beim Aufruf über URLs besser vorzubelegen.

Libs

Unter der Haube haben wir das Logging Framework SLF4J gegen natives Log4j2 getauscht. Außerdem wurde für die Datenbankanbindung EclipseLink von der Version 2 auf die Version 4 gehoben, was mit einer größeren Codeanpassung aufgrund von geänderten Packagenamen (javax -> jakarta) einher ging.

Goobi viewer Indexer

Für den Mailversand kann im Goobi viewer Indexer jetzt auch der SMTP Port individuell konfiguriert werden.

Codeanalyse

Die folgenden Screenshots zeigen die SonarCloud Analyse des aktuellen Releases. Weitere Informationen gibt es direkt auf der Projektseite.

Versionsnummern

Die Versionen die in der pom.xml des Themes eingetragen werden müssen um die in diesem Digest beschriebenen Funktionen zu erhalten lauten:

<dependency>
    <groupId>io.goobi.viewer</groupId>
    <artifactId>viewer-core</artifactId>
    <version>22.09</version>
</dependency>
<dependency>
    <groupId>io.goobi.viewer</groupId>
    <artifactId>viewer-core-config</artifactId>
    <version>22.09</version>
</dependency>
<dependency>
    <groupId>io.goobi.viewer</groupId>
    <artifactId>viewer-connector</artifactId>
    <version>22.09.1</version>
</dependency>

Der Goobi viewer Indexer hat die Versionsnummer 22.09

Das Goobi viewer Crowdsourcing Modul hat die Versionsnummer 22.09

Coming soon

• Überarbeitung der Kommentare

• Änderungen am Suchalgorithmus

Ankündigungen

Wir wollen uns in den kommenden Monaten der Überarbeitung der Suche widmen. In der Regel sind Änderungen in diesen Codebereichen schwer zu greifen, da sie oft keine visuellen Anpassungen beinhalten. Gleichzeitig sind sie komplex, da viel Logik nicht nur verstanden, sondern auch in Algorithmen umgesetzt werden muss. Mehrere Wochen Arbeit führen dann dazu, das ein Suchtreffer weiter oben oder weiter unten in der Liste erscheint. Neue Buttons oder Features gibt es aber gleichzeitig nicht.

Innerhalb der Community haben sich bereits verschiedene Partner bei uns gemeldet, die eine Änderung von Teilbereichen angefragt haben um die Finanzierung zu prüfen.

Es gibt aber noch weitere Punkte die in diesem Zusammenhang wünschenswert wären. Diese beinhalten auch visuelle Änderungen und beziehen sich zum Beispiel auf die Überarbeitung der Bedienbarkeit der einfachen und der erweiterten Suche. Aber auch weitere Entwicklungen wie eine dedizierte Auflistung von Personen- und Ortstreffern, die Integration der DNB Entity Facts, Suche in Inhalten von CMS-Seiten oder Export von Trefferlisten als IIIF Collection sind Wünsche, die in der Vergangenheit geäußert wurden.

Wenn Interesse an der Konzeption und Übernahme einzelner Posten besteht freuen wir uns über eine Kontaktaufnahme!

Entwicklungen

Archivansicht

Die Archivansicht wurde an vielen Stellen überarbeitet und erweitert. Was sicherlich als erstes ins Auge springt ist, dass sie nun Farben und Logos aus dem Corporate Design enthält. Dadurch wirkt sie nativer in den Rest des Goobi viewers integriert.

Die Icons im Archivplan sind jetzt konfigurierbar und Übernehmen in der Standardkonfiguration die Icons aus dem Archivmanagement Plugin von Goobi workflow. Ein Piktogramm zeigt an hinter welchen Knoten und Verzeichnungseinheiten Digitalisate vorliegen. Außerdem wird im Baum unterhalb einer Verzeichnungseinheit der Entstehungszeitraum angezeigt, so dass eine schnelle zeitliche Navigation möglich ist.

Komplett neu ist die Auswahl und der Wechsel zwischen verschiedenen Beständen. Diese Option wird automatisch eingeblendet sobald mehr als ein Bestand vorliegt.

Zusammen mit dieser Überarbeitung ist die alternative Tektonikansicht ersatzlos weggefallen. Alle Vorteile, die diese alternative Ansicht geboten hat, sind in die Archivansicht eingeflossen.

Auch die Konfigurationsdatei wurde in dem Bereich restrukturiert und folgt jetzt einer klareren Logik.

Profil

Nachdem wir im letzten Monat die Benutzereinstellungen überarbeitet haben wird mit diesem Release eine Profilseite für Benutzer eingeführt. Dort sind zeitlich absteigend die letzten Aktivitäten aufgelistet, gefolgt von einer Übersicht der Merklisten, gespeicherten Suchen und Kommentare.

Weiter wurde mit diesem Release die Benennung der Einträge im Benutzermenü geprüft und überarbeitet. Dabei wurde sichergestellt, dass diese mit den Überschriften auf den verlinkten Seiten übereinstimmen. Auch die Breadcrumbs und teilweise die URLs wurden in dem Zuge für den Benutzerbereich geprüft. Teilweise wurde die Benennung in den Breadcrumbs angeglichen und teilweise auch neue Ebenen eingefügt, damit diese mit der URL Struktur konsistent sind.

Anmeldedialog

Der Anmeldedialog wurde nicht inhaltlich, wohl aber visuell umgestaltet. Des öfteren haben wir in den letzten Jahren die Rückmeldung bekommen, dass Funktionalität, wie die um ein neues Konto zu registrieren oder auch die Passwort vergessen Funktionalität nicht gut zu finden sein.

Wir haben das Feedback gesammelt, gesucht und jetzt eine Möglichkeit gefunden die Elemente klarer anzuordnen. Hier eine Vergleichsansicht der beiden Dialoge nebeneinander:

Barrierefreiheit

Die Barrierefreiheit wurde weiter verbessert und es erscheint nun bei der Navigation mit der Tastatur und Tabulator in der Webseite ein Fokusring. Wird eine Maus verwendet ist dieser jedoch nicht sichtbar. Diese Änderung ermöglicht eine schnellere, visuelle Navigation.

CSS und Javascript Libraries

Die Verwaltung der CSS und Javascript Libraries erfolgt jetzt über die package.json und das Tool npm. Ähnlich wie bei den Java Abhängigkeiten mit maven, wurde eine zentrale Stelle eingeführt in der die Abhängigkeiten mit ihren Versionen aufgeführt sind. Im zusammenspiel mit dem Tool Grunt, können die Libraries jetzt einfacher verwaltet und aktuell gehalten werden. Diese Änderung mag in dem Digest nur am Ende stehen, kurz sein und unscheinbar aussehen, aber sie ist ein großer Meilenstein auf dem Weg zu stets gepflegten und aktuellen Versionen der eingesetzten Libraries.

Versionsnummern

Die Versionen die in der pom.xml des Themes eingetragen werden müssen um die in diesem Digest beschriebenen Funktionen zu erhalten lauten:

Der Goobi viewer Indexer hat die Versionsnummer 21.10

Das Goobi viewer Crowdsourcing Modul hat die Versionsnummer 21.10

Coming soon

• Änderungen am Suchalgorithmus

• Verwaltung eines Cookie Banners

Ankündigungen

Wie bereits im letzten Monat erwähnt möchten wir in den kommenden Monaten an der Suche arbeiten. Wenn Interesse an der Konzeption und Übernahme einzelner Posten besteht freuen wir uns über eine Kontaktaufnahme!

Entwicklungen

Kommentare

Für angemeldete Benutzer steht ab sofort eine Übersichtsseite aller eigenen Kommentare zur Verfügung. Die neue Seite ist in dem Menü und auf der Profilseite verlinkt.

Eine große Umstellung gab es "unter der Haube". Die knapp zehn Jahre alte Datenstruktur wurde zu WebAnnotations migriert. Damit stehen sie - analog zu den Ergebnissen aus Kampagnen - in einem etablierten Standard zur Verfügung und können als Linked Open Data verwendet werden.

Suchalgorithmus

Im November hat es erste umfangreiche Anpassungen am Suchalgorithmus gegeben. Ab sofort werden Treffer, bei denen das gesuchte Wort im Titel vorkommt, stärker gewichtet und bei einer Sortierung nach Relevanz weiter oben einsortiert.

Obwohl wir zu diesem Punkt keinen Screenshot zeigen können ist er der Posten in den diesen Monat die meiste Arbeit geflossen ist.

Sortierung der Suchtreffer

Eine weitere Änderung hat es im Bereich der Sortierung von Suchtreffern gegeben. Hier wurde der Code an verschiedenen Stellen angepasst.

Abgesehen von einer einfacheren und intuitiveren Konfiguration, wird nun auch das Standardsortierfeld mit in dem Dropdown Menü aufgeführt. Außerdem besteht die Möglichkeit die Optionen "Relevanz" und "Zufällig" explizit mit anzuzeigen. Als Verbesserung der Bedienbarkeit ist sicherlich das Feature zu sehen, neben "aufsteigend" und "absteigend" eigene Wörter zu definieren. Dies ist standardmäßig bei der Sortierung nach Titel der Fall, wo alternativ "A-Z" und "Z-A" angezeigt wird.

Backend: Themes

Im Backend gibt es einen neuen Bereich für die Konfiguration des installierten Themes. Wenn Subthemes vorhanden sind, werden diese ebenfalls angezeigt. Insgesamt stehen vier Abschnitte zur Verfügung.

Im Abschnitt "Allgemein" können der Name der Instanz und Bilder wie ein Logo oder ein Favicon hinterlegt werden. Der Name und das Logo werden in der Regel im Kopfbereich der Seite angezeigt.

Im zweiten Abschnitt "Quick CSS" kann eigenes CSS eingeben werden das Angaben aus dem Core und dem Theme überschreibt.

Unter "Social Media" können Benutzernamen von Internetdiensten angegeben werden. Sobald ein Benutzername eingegeben und gespeichert wurde, wird im Theme ein entsprechendes Icon mit der Verlinkung zu dem Profil gerendert.

In dem vierten Abschnitt "Footer" können Links zu Kontakt, Impressum und Datenschutzerklärung angegeben werden. Diese Links überschreiben eventuell bereits vorhandene Standardwerte.

Goobi viewer Indexer

Ein neues Caching von Normdatendatensätzen innerhalb des Goobi viewer Indexers erhöht die Performance bei Neuindexierungen und reduziert die Anfragelast an die entsprechenden Normdatenserver. Dieses Feature steht automatisch zur Verfügung und bedarf keiner weiteren Konfiguration.

Weiter wurde die Konfigurationsdatei von solr_indexerconfig.xml zu config_indexer.xml umbenannt.

Verschiedenes

• Liegen mehrere gruppierte Metadatenwerte vor, so kann ein optionales Sortierfeld angegeben werden um die Anzeige in der Oberfläche alphabetisch sortiert anzuzeigen.

• Bilder können bei der PDF-Generierung nicht mehr nur global prozentual skaliert werden, sondern alternativ kann eine Boxgröße angegeben werden, in die die Dateien proportional skaliert werden sollen, sofern sie größer sind als die konfigurierte Box.

• Das Feedback Formular enthält ab sofort eine Zustimmung im Kontext DSGVO

Versionsnummern

Die Versionen die in der pom.xml des Themes eingetragen werden müssen um die in diesem Digest beschriebenen Funktionen zu erhalten lauten:

Der Goobi viewer Indexer hat die Versionsnummer 21.11.2

Das Goobi viewer Crowdsourcing Modul hat die Versionsnummer 21.11

Coming soon

• Neuerungen bei den Zugriffsbeschränkungen

• Überarbeitung des CMS-Bereichs

• Anzeige von Zugriffsstatus und Nutzungslizenz

• Zugriffsstatistiken

Ankündigungen

Im August wird das Goobi viewer Team wegen verschiedener Jahresurlaube nur eingeschränkt zur Verfügung stehen.

Entwicklungen

Born Digital

Bei der Anzeige von Born-Digital Dateien wurde die Komponente für den Zugriff auf die Dateien selbst an den Anfang der Seite verschoben. Außerdem wurde die Komponente zu einer tabellarischen Anzeige der Informationen umgebaut um die Informationen schneller erfassen zu können.

Tickets

Die Funktionalität der Zugriffsbeschränkungen wurde um Tickets erweitert. Mit einem Ticket, kann der Zugang Born-Digital Inhalten erst nach der Eingabe eines Ticket-Codes freigeschaltet werden.

Tickets sind Grundsätzlich ein Rechtenehmer. Das bedeutet, dass sie zum Beispiel an einen IP-Bereich geknüpft sein müssen. Dieser IP-Bereich kann zum Beispiel ein Lesesaal sein, es kann aber natürlich auch ein ein weltweit gültiger IP-Bereich konfiguriert werden.

Ist der Zugriff auf Born-Digital Inhalte von einer Zugriffsbeschränkung gesperrt und wird der Zugriff dann in einem Recht freigeschaltet, kann optional die Ticket Funktionalität aktiviert werden. Das bedeutet, dass Nutzer sehen können, dass es eine Datei gibt, aber für den Download muss ein zusätzliches Ticket eingegeben werden. Dafür öffnet sich ein Modal. Wenn noch kein Ticket vorhanden ist kann dort ein neues angefordert werden.

Wurde eine Anfrage für ein Ticket gestellt wird darüber auf dem Goobi viewer Dashboard informiert. Die Anfragen werden auf der Seite der "Rechte" verwaltet. Für jede Anfrage wird im Kopfbereich eine entsprechende Box angezeigt. Wenn aktive Tickets vorliegen werden die in einer Tabelle dargestellt. Tickets haben grundsätzlich eine Gültigkeit von 30 Tagen und können optional verlängert werden.

Abgelaufene Tickets werden automatisch rückstandslos gelöscht. Wenn keine Tickets vorliegen werden die Bereiche nicht angezeigt.

CMS

Der Bereich zum Bearbeiten von Seiten hat erste Überarbeitungen erhalten. So sind alle globalen Optionen von unterhalb der Seite in die Sidebar umgezogen. Dieses ist der erste Schritt hin zur Überarbeitung der Bedienbarkeit in diesem Bereich in den kommenden Monaten.

Goobi viewer Indexer

Der Parameter <addToParents /> hat das optionale Attribut keepOnChildren="true|false" bekommen, damit die hochvererbten Metadaten nicht nur im obersten Element landen, sondern in der ganzen Hierarchie verbleiben. Damit ist es zum Beispiel möglich Sammlungsnamen aus einem Strukturelement in das Werk zu kopieren.

Weiter wurde der Algorithmus zur Bestimmung von Ordnern, die bei der Indexierung im Hotfolder liegen und zu einem Datensatz gehören, verbessert.

Entwicklungsprozess

Schon länger lassen wir in unregelmäßigen Abständen den Quelltext der Goobi viewer Komponenten mit der statischen Codeanalyse "Sonar" überprüfen. Die Ergebnisse der Analyse sind unter der folgenden Adresse öffentlich einsehbar:

Die Prüfung und Behebung von dort angemerkten Punkten haben wir in den vergangenen Monaten intensiviert, so dass wir mit diesem Release jetzt bei allen Komponenten ein A-Rating erhalten haben.

Snippets

• Die Kalendersuche unterstützt nun die Übergabe des Jahres in der URL.

• Der Goobi viewer kann jetzt optional eine sogenannte Expand Query für Such-Untertreffer aus der aktuellen Facettierung bauen, auch wenn keine konkreten Suchbegriffe eingegeben wurden. Damit können zum Beispiel Strukturelemente gefunden werden, die einer speziellen Sammlung angehören.

Versionsnummern

Die Versionen die in der pom.xml des Themes eingetragen werden müssen um die in diesem Digest beschriebenen Funktionen zu erhalten lauten:

Der Goobi viewer Indexer hat die Versionsnummer 22.07

Das Goobi viewer Crowdsourcing Modul hat die Versionsnummer 22.07

Coming soon

• Überarbeitung der Kommentare

• Docker Container

• Benutzerseite im Frontend

Ankündigung

Entwicklungen

Docker

Gemeinsam mit dem Georg Eckert Institut, Leibniz-Institut für internationale Schulbuchforschung, entwickeln wir eine Lösung um den Goobi viewer und alle dazugehörigen Komponenten und Dienste als Docker Container zur Verfügung zu stellen.

Wir sind stolz darauf mit dem August Release die ersten Dockerfiles und Preview-Container veröffentlichen zu können. Die Arbeiten sind noch nicht abgeschlossen, für die folgenden Komponenten können aber bereits Container von Docker Hub bezogen werden:

• Apache Solr (vorkonfiguriert für den Goobi viewer)

• Goobi viewer Indexer

• Goobi viewer Connector

• Goobi viewer Reference Theme

Das Theme bindet den Core als Abhängigkeit ein, dadurch ist das Theme der eigentliche Hauptcontainer.

Im kommenden Monat werden wir noch eine zentrale docker-compose Datei veröffentlichen und eine Anleitung schreiben wie der Goobi viewer mit Docker in Betrieb genommen werden kann.

Medien

Im CMS-Bereich wird nun auch der Upload von SVG-Dateien und MP4 Videos unterstützt. Diese können anschließend zum Beispiel in CMS-Seiten oder auch im Slider eingebunden werden.

Video Dateien in Werken haben über das zusätzliche Poster-Attribut ein Platzhalterbild, dass standardmäßig einen Play-Button anzeigt.

Quality Friday

Wie in den letzten beiden Digests angekündigt war das Goobi viewer Team im August nicht durchgehend komplett. Aus diesem Grund war es schwer größere Entwicklungen durchzuführen, bei denen die Arbeiten des einen auf Vorarbeiten des anderen aufbauen. Deswegen haben wir vermehrt Arbeiten durchgeführt die bei uns unter dem Begriff "Quality Friday" fallen.

Diesen gibt es bei intranda bereits seit vielen Jahren und sagt aus, dass ein Mitarbeiter 10 % seiner Arbeitszeit für Aufgaben und Entwicklungen nutzen darf, die zum Beispiel der allgemeinen Verbesserung der Software, der Dokumentation, automatischen Tests oder der Konfiguration der Entwicklungsumgebung dienen. Diese Arbeiten sind in der Regel nicht durch Entwicklungsaufträge gedeckt, würden sie aber nicht gemacht, entstehen "technische Schulden" und die reguläre Arbeit wird mit der Zeit immer schwieriger, zäher und langwieriger.

Ausgehend von dem Spruch "Freitag ab eins macht jeder seins!" und der Berechnung, dass bei einer 40 Stunden Woche 10 % der Arbeitszeit vier Stunden, also ein halber Tag pro Woche sind, kam dann die Idee auf, den Freitag Nachmittag für diese Arbeiten zu nutzen. Dadurch wurde der Begriff "Quality Friday", kurz "QF" geboren.

Im August haben wir verschiedenste Arbeiten in diesem Kontext durchgeführt. Im Folgenden möchten wir einige davon auflisten und erklären:

Konfigurationsdatei (QF)

Über die Jahre ist die zentrale Konfigurationsdatei config_viewer.xml immer weiter gewachsen. Mit gewachsen ist zum Beispiel auch die Art- und Weise mit der Funktionalität ein oder ausgeschaltet wird. Hier ein Beispiel wie es bisher war:

Auch ohne tiefer in die Materie einzusteigen ist sehr schnell ersichtlich, dass verschiedenste Varianten und Begriffe existierten um immer jeweils das selbe zu tun. Nach den "Quality Friday" Arbeiten ist hier eine einheitliche Terminologie und Schreibweise zu erkennen:

Sicherlich haben wir an dieser Stelle noch Dinge übersehen die uns erst in den kommenden Monaten auffallen und dann angepasst werden. Aber wir haben einen gutes Fundament gelegt.

Änderungen wie diese machen ein Update auch immer länger, da die lokale Konfigurationsdatei an die veränderte Standardkonfiguration angepasst und migriert werden muss. Langfristig führen sie aber zu einer deutlichen Verbesserung in vielen Arbeitsabläufen: Ein Entwickler muss sich keine Gedanken mehr machen wie er einen neuen Schalter nennt, denn er kann sich an den existierenden Orientieren. Die Lernkurve ist für alle deutlich steiler, die Übertragbarkeit von Wissen von einem Element auf das andere ist einfach gegeben und muss nicht jedes Mal nachgeschaut werden. Zu guter Letzt wird auch die Konfigurationsdatei insgesamt kürzer und dadurch übersichtlicher.

Wir haben auch die in der Konfigurationsdatei enthaltenen Kommentare zu einem großen Teil überprüft und in der Art- und Weise wie Funktionalität und Schalter formuliert werden homogenisiert.

Barrierefreiheit (QF)

Im November 2020 haben wir im Goobi viewer die Barrierefreiheit nach WCAG 2.1 AA sichergestellt. Jetzt, ein gutes halbes Jahr später, sind wir den Code erneut durchgegangen und haben an einigen Stellen nachjustiert. Dies betrifft vor allem den Slider und Karten.

Sidebar (QF)

Wir sind alle Seiten im Goobi viewer Core durchgegangen und haben uns angeschaut wie die Sidebar aufgebaut wird. Das war über die Jahre gewachsen und nicht mehr einheitlich. Wir haben sichergestellt, dass nun auf allen statischen Seiten einheitliche und sinnvolle Widgets angezeigt werden, auf einigen Seiten welche entfernt und auf anderen hinzugefügt.

XHTML (QF)

Die Webseiten des Goobi viewers werden in XHTML Dateien geschrieben und dort mit dem Templating Framework JSF realisiert. In den XHTML Dateien haben wir verschiedenste Dinge aufgeräumt, wie zum Beispiel die Reihenfolge von Codeblöcken innerhalb der Dateien an die Reihenfolge der Anzeige der Seite angeglichen, Einrückungen von Code angepasst und korrigiert oder die Verwendung von sogenannten Namespaces vereinheitlicht. Typisches "Housekeeping"

Browser Console (QF)

Für Entwickler ist es notwendig, dass die Console in den Entwicklertools des Browsers funktioniert und übersichtlich ist. Jegliche Art von Fehlern, Warnungen und überflüssigen Ausgaben sollten vermieden werden. Wir sind diesen Bereich noch einmal durchgegangen und haben verschiedene Änderungen durchgeführt. Als erstes haben wir überflüssige Meldungen auskommentiert. Anschließend wurden Anpassungen in Grunt für die Generierung der Goobi viewer eigenen CSS und Javascript Dateien vorgenommen um den Pfad zu den Source Maps richtig zu setzen. Am Ende haben wir noch begonnen die Verwaltung der verwendeten Javascript Bibliotheken zu überarbeiten um auch hier die Sourcemaps mit zu übernehmen.

Goobi viewer Indexer

Die Art- und Weise wie der Goobi viewer Indexer die Konfigurationsdatei einliest und verwaltet wurde modernisiert. Dadurch ist es jetzt nicht mehr notwendig Leerzeichen durch einen Platzhalter zu ersetzen, sondern sie können in regulären Ausdrücken ohne explizite Maskierung direkt verwendet werden.

Versionsnummern

Die Versionen die in der pom.xml des Themes eingetragen werden müssen um die in diesem Digest beschriebenen Funktionen zu erhalten lauten:

Der Goobi viewer Indexer hat die Versionsnummer 21.08

Der Goobi viewer Connector hat die Versionsnummer 21.08.2

Das Goobi viewer Crowdsourcing Modul hat die Versionsnummer 21.08

Coming soon

• Überarbeitung der Kommentare

• Docker Container

• Benutzerseite im Frontend

Ankündigung

Im August wird das Goobi viewer Team wegen verschiedener Jahresurlaube nur eingeschränkt zur Verfügung stehen.

Entwicklungen

Feedback

Das Feedback Formular wurde überarbeitet und wird nun standardmäßig als Overlay über der aktuell angezeigten Seite angezeigt. Das hat den großen Vorteil, dass wenn an einer Stelle eine Nachricht verschickt wird der Nutzer nicht mehr von der Seite weggeleitet wird, sondern dort verbleibt.

Mit der visuellen Überarbeitung gibt es aber auch funktionelle Erweiterungen. So ist es ab sofort möglich eine Liste an potentiellen Empfängern zu hinterlegen. Existiert mehr als ein Eintrag wird automatisch ein DropDown Menü angezeigt in dem der gewünschte Empfänger ausgewählt werden kann.

Weiter wird eine Nachricht jetzt auch standardmäßig als Kopie an den Absender verschickt.

Neu ist ferner die Möglichkeit das Formular über das Webfragment #feedback auf jeder Seite automatisch aufzurufen. Dadurch ist es möglich die neue Funktionalität auch im Menü oder in den Werkshinweisen einfach zu nutzen.

Werkshinweise

Die Hinweise waren bisher mit einem Werksidentifier verknüpft. Ab sofort können Werkshinweise auch für Solr-Queries angelegt werden. Damit ist es möglich zum Beispiel für alle Werke einer bestimmten Sammlung oder alle Werke mit einem bestimmten Dokumenttyp einen Hinweis zu formulieren und anzuzeigen.

Über die Neuerungen im Feedback Formular können Werkshinweise zum Beispiel auch das Formular öffnen. Ein entsprechender Hinweis wie die Funktionalität zu verwenden ist, wird in der Seitenleiste angezeigt.

CMS

In der Seitenübersicht werden angelegte aber sich noch im Entwurf befindliche CMS-Seiten ausgegraut und mit einem entsprechenden Badge gekennzeichnet.

Monitoring

Über die REST API steht ein neuer Monitoring Endpoint zur Verfügung. Aus Sicht des Goobi viewers werden beim Aufruf die folgenden drei Funktionalitäten geprüft:

• Anbindung zur Datenbank

• Anbindung zum Solr Suchindex

• Bildanzeige

Die JSON Ausgabe liefert für die Funktionalitäten entweder den Status ok oder den Status error aus. Wird dieser Endpoint in ein automatisches Monitoring System wie zum Beispiel Icinga aufgenommen und darüber regelmäßig geprüft, können Fehler frühzeitig entdeckt und mit Event-Handlern darauf reagiert werden.

Beispielausgabe von dem Monitoring Endpoint:

Arbeitsaufträge im Hotfolder

Im April haben wir die Funktionalität vorgestellt, dass die Anzahl der sich im Hotfolder befindliche Arbeitsaufträge für Administratoren in der blauen Topbar angezeigt wird. Bisher wurde die Anzeige aktualisiert wenn die Seite neu geladen wurde. Ab sofort geschieht dieses ohne Zutun des Nutzers automatisch über Websockets.

Zitierlinks

Für die Bereitstellung von Zitierlinks gab es im Goobi viewer eine inzwischen zehn Jahre alte Programmlogik. Dort wurde die "PURL" zum aktuellen Werk und zur aktuellen Seite zur Verfügung gestellt. Vor ungefähr acht Jahren wurde die Logik dahingehend erweitert, dass - wenn URNs vorhanden sind -eine URL zum internen URN-Resolver ausgegeben wird. Ansonsten weiterhin die PURL des Goobi viewers.

Die Zeit ist aber nicht stehen geblieben und deswegen war es auch dringend geboten diesen Bereich zu überarbeiten. Neben PURLs und URNs gibt es ja auch DOIs und Handles und ARKs und so weiter. Außerdem ist es zum Beispiel in der Praxis herausfordernd die Persistenz von URN granular zu gewährleisten wodurch zum Beispiel die Wünsche entstanden über an den Werks-Identifier angehängte Fragmente auch Seiten referenzieren zu können.

Mit diesem Release steht eine komplett überarbeitete Logik für die Anzeige von Zitierlinks zur Verfügung. Der Zugang zu den Zitierlinks erfolgt weiterhin über das Widget "Zitieren und Nachnutzen". Wird dort auf den Badge geklickt öffnet sich ein Overlay in dem die vorhandenen Zitierlinks angezeigt und kopiert werden können. Ein neuer Abschnitt in der Konfigurationsdatei erlaubt dabei die Einstellung welche Felder aus dem Solr Suchindex als Zitierlink angeboten werden sollen und ob diese eventuell mit Prä- und Suffixen ergänzt werden sollen.

Der Goobi viewer kommt in der Standardkonfiguration mit Einträgen für URN, URN-Granular, DOIs und Handles, die - sofern vorhanden - angezeigt werden.

Verschiedenes

• Existiert für ein Werk ein Repräsentant verlinkt der RSS-Feed jetzt auch automatisch dorthin.

• Die Download Möglichkeit kann im Widget "Zitieren und Nachnutzen" jetzt global deaktiviert werden.

• Wenn in den Bibliographischen Daten Sammlungen über den Parameter "hierarchicalfield" verlinkt angezeigt werden wird nun auch ein konfiguriertes Sortierfeld für eine Sammlung mit bedacht.

• Die Übergabe eines Textes für den Footer kann jetzt abgestellt werden.

• Im Backend kann jetzt die Übersetzung von rein lokal vorliegenden Strings gepflegt werden.

Versionsnummern

Die Versionen die in der pom.xml des Themes eingetragen werden müssen um die in diesem Digest beschriebenen Funktionen zu erhalten lauten:

Der Goobi viewer Indexer hat die Versionsnummer 21.07.2

Der Goobi viewer Connector hat die Versionsnummer 21.07

Das Goobi viewer Crowdsourcing Modul hat die Versionsnummer 21.07

Coming soon

• Überarbeitung der Kommentare

• Docker Container

• Benutzerdashboard im Frontend

Entwicklungen

Docker

Mit dem September Release nimmt das Docker-Setup Gestalt an. Eine Vielzahl von Arbeiten wurde in diesem Monat in diesem Zusammenhang veröffentlicht. Dabei wurden bestehende Container angepasst und erweitert, es kamen neue hinzu und auch eine erste Installationsanleitung für den Produktivbetrieb steht ab sofort zur Verfügung.

Wir haben im Produktivszenario darauf geachtet, dass sich möglichst vieles genauso verhält wie auch bei einer klassischen Installation. Das bedeutet, dass die Ordnerstruktur identisch ist und die entsprechenden Verzeichnisse und Konfigurationsdateien in die Container hineingereicht werden. Auch bekannte Aliase wie ind oder cata stehen analog zur Verfügung.

Insgesamt besteht das Goobi viewer Docker Setup aus den folgenden Containern:

Für den kommenden Monat stehen hier jetzt neben kleineren Entwicklungen vor allem Aufräumarbeiten, Polishing, Vereinheitlichung und Dokumentation an.

Konto

Bisher konnten nur Administratoren ein Konto innerhalb des Goobi viewers löschen. Jetzt können Benutzer dieses in den überarbeiteten Kontoeinstellungen auch eigenständig. Weiter kann für ein Konto ein individuelles Profilbild hochladen werden. Bisher konnte hier nur zwischen einem Standardbild und dem Gravatar Dienst gewählt werden.

In dem Zuge der Überarbeitung des Bereiches wurde auch im Backend auf der Benutzerseite eine Sidebar eingeführt.

Metadaten

Im Kontext Metadaten hat sich sehr viel getan. Vieles ist vielleicht auf den ersten Blick gar nicht sichtbar oder fällt erst bei einem Update auf.

Der Goobi viewer unterstützt nun die Anzeige von Metadatengruppen in Gruppen. Dabei ist es egal aus welchem Dateiformat (LIDO, METS/MODS) diese stammen.

In diesem Zuge wurde im Code selbst kräftig aufgeräumt. Dieser Teil ist nämlich über die Jahre immer nur gewachsen. Er ist jetzt besser.

Für jeden sichtbar ist, dass der Dokumententyp oder ein Strukturtyp automatisch vor einem Block als Überschrift erscheint.

Auch im Kontext LIDO hat sich einiges verändert. So ist bei den Aufräumarbeiten zum Beispiel aufgefallen, dass es für die Konfiguration der Anzeige von Eventmetadaten in der Seitenleiste eine Vermischung mit dem Bereich der Hauptmetadaten gab. Ab jetzt regelt auch bei LIDO Metadaten der Block <metadataView /> nur die Anzeige auf der dedizierten Seite, und in der <sideBarMetadataList /> werden die Metadaten für die Seitenleiste definiert.

Weiter haben wir die Terminologie an den einzelnen Stellen angepasst, so dass bei LIDO Datensätzen einheitlich von "Metadaten" und nicht mehr teilweise von "Bibliographischen Daten" gesprochen wird.

Zu guter Letzt ist es jetzt auch Möglich Metadaten aus Events für die Anzeige in der <searchHitMetadataList /> zu konfigurieren.

Karten

Wenn für Strukturelemente Koordinaten erfasst sind werden diese als Marker oder als Bounding Box in der Seitenleiste angezeigt. Die Auswahl eines Strukturelementes war über die Karte bereits möglich.

Neu ist, dass das der aktive Marker oder die aktive Bounding Box jetzt visuell hervorgehoben werden. Dafür werden die Elemente rot eingefärbt. Auch wird automatisch zu dem aktiven Element gezoomt damit es gut sichtbar ist.

Bei der Facettierung können die Suchtreffer in der Karte über einen Schalter bei Bedarf initial ausgeblendet werden. Außerdem ist die Adresssuche in der Karte über Mapbox nun deaktivierbar.

Annotationen

Die Anzeige der Annotationen im Werk hat nun mehr Möglichkeiten. So ist das Widget in der Sidebar schlanker geworden und auch die Bedienbarkeit wurde verbessert. Die optionale Anzeige unter dem Bild verwendet nun die gleiche technische Infrastruktur wie das Sidebar Widget und die Anzeige der Texte im Bild lässt sich global deaktivieren, so dass nur der Rahmen sichtbar ist.

Goobi viewer Indexer

Im Goobi viewer Indexer gab es eine größere interne Umstellung die das Einlesen und Verwalten der Konfigurationsdatei betrifft. Dies wurde für die Indexierung von mehrstufig gruppierten Metadaten notwendig.

Weiter kann der Indexer jetzt auch für METS/MODS Dateien Bilder automatisch herunterladen, wenn der _downloadImages Indikatorordner im Dateisystem existiert.

Damit LIDO Events besser gefunden werden wird das Feld ACCESSCONDITION automatisch mitgeschrieben.

Verschiedenes

• In dem CMS-Template "Einzelansicht einer Sammlung" wird nun auch die Trefferanzahl angezeigt und es stehen die Optionen zur Sortierung zur Verfügung

• Wird das Feedback-Modal über das Webfragment #feedback aufgerufen, so kann bei mehreren konfigurierten Adressen der vorausgewählte Eintrag ebenfalls dem Fragment mit übergeben werden, zum Beispiel #feedback:recipient=unicorn

Versionsnummern

Die Versionen die in der pom.xml des Themes eingetragen werden müssen um die in diesem Digest beschriebenen Funktionen zu erhalten lauten:

Der Goobi viewer Indexer hat die Versionsnummer 21.09

Der Goobi viewer Connector hat die Versionsnummer 21.09

Das Goobi viewer Crowdsourcing Modul hat die Versionsnummer 21.09.1

Coming soon

• Anpassungen an den IIIF Schnittstellen

• Erweiterungen bei den Karten

• Anpassungen im Crowdsourcing

Ankündigungen

Mit jedem Release stellen wir auf Github auch eine fertig kompilierte Version mit dem Reference-Theme zur Verfügung. Sie kann direkt für eine Installation oder ein Updates verwendet werden. Bisher konnte die Datei im Goobi viewer Core Repository heruntergeladen werden. Ab sofort ist sie im Repository des Reference Themes zu finden.

Entwicklungen

Zitierempfehlung

Im Widget "Zitieren und Nachnutzen" wird ab sofort eine Zitierempfehlung für das angezeigte Werk angeboten. Dabei wird auf die Möglichkeiten der Citation Styles zurückgegriffen, über die mehrere tausend Zitierstile zur Verfügung stehen. Die Standardkonfiguration enthält unter anderem Zitierstile nach APA, MLA, Harvard oder Oscola. Der gewünschte Zitierstil kann in einem DropDown Menü ausgewählt und die darunter stehende Zitierempfehlung dann per Mausklick in die Zwischenablage kopiert werden.

Eine Zitierempfehlung kann auch in der Liste der Metadaten auf der Seite "Bibliographische Daten" konfiguriert werden.

Bilddownload

Bisher konnte das aktuell angezeigte Bild als JPEG oder im Originalformat (in der Regel TIF) heruntergeladen werden. Dafür standen im Widget "Zitieren und Nachnutzen" zwei Badges zur Verfügung. Über die Konfigurationsdatei konnte die Anzeige und die Auflösung weiter gesteuert werden.

Diese beiden Links werden ersetzt durch ein neuen Badge "Download". Per Klick öffnet sich ein Popover das verschiedene Auflösungen des Bildes zum Download zur Verfügung stellt. Dafür können in der Konfigurationsdatei Einträge mit einem Label, dem Format und einer Box in Pixeln definiert werden, in die das Bild skaliert werden soll. Der Goobi viewer berechnet Anhand der tatsächlichen Bildgröße dann die richtigen Bildmaße und prüft auch, dass keine Einträge angeboten werden die größer sind als das Originalbild. Standardmäßig werden vier Bildgrößen (Vorschau, Klein, Mittel, Groß) und das Masterbild angezeigt.

Caches leeren

Am 1. Februar 2010 um 09:06 Vormittags wurde ein Feature-Ticket für die Software "intranda Presentation" mit dem Titel "Admin-GUI: Cache leeren" erstellt. Das Ticket hatte die Nummer #3055. Zum Vergleich: heute sind wir bei Nummer #20280.

Nach 11 Jahren und 22 Tagen wurde es geschlossen. Es ist vermutlich das älteste bearbeitete Ticket in der Geschichte der Applikation die heute ja nicht mehr intranda Presentation sondern intranda viewer Goobi viewer heißt.

Das nur Administrationen in der Werksansicht zur Verfügung stehende Widget "Änderungen am Werk" wurde umbenannt zu "Aktionen" und um die Möglichkeit ergänzt entweder einzelne oder alle Caches für das Werk zu leeren.

Downloads

Das Widget "Downloads", in dem zusätzliche Dateien zu einem Werk zum Herunterladen angeboten werden können, kann nun auch analog zum Widget "Zitieren und Nachnutzen" einen einleitenden Text enthalten.

Mirador

Die im Goobi viewer integrierte Version des Mirador wurde auf die Version 3 aktualisiert. Wird für ein Werk das IIIF Manifest geöffnet oder die Vergleichsansicht genutzt, steht er dort automatisch zur Verfügung.

Anchor Datensätze

Bisher standen für Anchor Datensätze, wie sie zum Beispiel bei mehrbändigen Werken oder Zeitschriften vorliegen, zwei Ansichten zur Verfügung: Die bibliographische Daten zum Anchor und das Inhaltsverzeichnis mit den enthaltenen Bänden. Automatisch geöffnet wurde immer das Inhaltsverzeichnis.

Beide Ansichten werden mit diesem Release zusammengeführt, so dass im oberen Bereich die Metadaten und darunter das Inhaltsverzeichnis angezeigt wird.

REST API

Wenn eine REST-API nicht dokumentiert ist kann sie von Externen nur schwer verwendet werden. Ist sie dann dokumentiert und wird sie benutzt, kommen natürlich sofort Fragen auf. So auch im Goobi viewer.

Dieses Release bringt verschiedene Änderungen an der REST API mit. Hervorzuheben sind vor allem die folgenden Anpassungen:

1. Der Endpoint /index/query gibt jetzt auch die Gesamtzahl der Treffer und der Facettierfelder aus

2. Der neue Endpoint /index/fields zeigt Informationen zu den vorhandenen Solr-Feldern an. Damit kann ein leichterer Überblick über die Struktur und den Datenbestand erlangt werden.

Performance

Bei der Generierung der IIIF Manifeste und bei der Sammlungsauflistung gab es massive Performanceverbesserungen. Leider kann man zu solchen Themen nicht viel schreiben, sie sind aber absolut erwähnenswert. Die Generierzeit konnte bei manchen IIIF Manifesten von 15 auf 3 Sekunden reduziert werden. Bei der Sammlungsauflistung ist der Effekt vor allem zu beobachten, wenn die Installation viele Werke enthält. Die bisher eingesetzte Solr-Query skalierte nicht mit vielen Datensätzen. Durch eine Umstellung konnte die Zusammenstellung der Sammlungsübersicht unter Berücksichtigung der Zugriffsbeschränkungen von mehreren Sekunden auf wenige Millisekunden reduziert werden.

Falls auf einer CMS-Seite die Gruppierung von Suchtreffern verwendet wird muss diese nach dem Update neu gesetzt werden.

rechts-nach-links Leserichtung

Die XHTML und CSS Anweisungen im Core wurden überarbeitet um auch Themes mit einer rechts-nach-links Leserichtung zu unterstützen. Diese Änderung ist in Themes sichtbar, die die Sprachen arabisch oder hebräisch aktiviert haben.

Goobi viewer Indexer

Ab sofort kann der Goobi viewer Indexer während der Indexierung eines Datensatzes einen externen Katalog abfragen und dazu weitere bibliographische Daten indexieren. Das Anwendungsbeispiel, wofür diese Funktionalität entwickelt wurde, sind LIDO Datensätze zu musealen Objekten, in denen ein Identifier auf ein Werk mit beschreibender Literatur enthalten ist. Der Indexer fragt dann mit Hilfe des angegebenen Identifiers die bibliographischen Daten zum Werk ab, indexiert diese und im Goobi viewer können diese dann neben dem Objekt angezeigt werden.

Siehe dazu auch den folgenden Abschnitt in der Dokumentation:

Sonstiges

• Im Benutzermenü wird der Eintrag "Annotationen" erst sichtbar, sobald die erste Annotation erstellt wurde.

• Aus der Volltextanzeige ist nun der direkte Wechsel in die Vollbildansicht möglich. Dort wird dann auch der entsprechende Reiter mit dem Volltext direkt geöffnet angezeigt.

• Auf mehrfachen Wunsch wurde das CMS-Template für eine Bildergalerie mit Text, mit denen die Universitätsbibliothek Kassel eine virtuelle Ausstellung mit den Schätzen der Sondersammlungen realisiert hat, in den Core übernommen und steht somit für alle in der Liste der CMS-Templates zur Verfügung.

Versionsnummern

Die Versionen die in der pom.xml des Themes eingetragen werden müssen um die in diesem Digest beschriebenen Funktionen zu erhalten lauten:

Der Goobi viewer Indexer hat die Versionsnummer 21.02

Der Goobi viewer Connector hat die Versionsnummer 21.02

Das Goobi viewer Crowdsourcing Modul hat die Versionsnummer 21.02

Coming soon

• Anpassungen an den IIIF Schnittstellen

• Erweiterungen bei den Karten

• Anpassungen im Crowdsourcing

Entwicklungen

Metadaten

Anwender, die viel Liebe in ihre Metadaten stecken, können diese jetzt noch besser präsentieren. Im letzten Monat wurden hierfür zwei Features entwickelt.

Zum einen können Metadaten jetzt auf mehrere Seiten aufgeteilt werden. Der konkrete Anwendungsfall für diese Entwicklung war der Wunsch, sehr umfassende kodikologische Daten für Handschriften separiert von den anderen bibliographischen Daten des Werkes anzuzeigen. Dafür wurde die Konfigurationsdatei angepasst, die es jetzt erlaubt dynamisch Seiten für die Metadatenanzeige zu konfigurieren. Siehe dazu auch in der Goobi viewer Dokumentation.

Die andere Entwicklung betrifft die Anzeige von Metadaten von Strukturelementen. Bisher wurden diese immer angezeigt, auch wenn sie eigentlich keine zusätzlichen relevanten Informationen enthielten. So stand dort häufig nur der Titel des Strukturelementes und der war ja bereits aus dem Inhaltsverzeichnis klar. Über einen neuen Schalter in der Konfigurationsdatei können nun die Metadaten markiert werden die - wenn sie die einzigen für die Anzeige wären - automatisch ignoriert werden.

Wir haben in die ein paar Punkte aufgenommen die bei einem Update geprüft werden sollten. Vielleicht fällt das Ergebnis auf den ersten Blick gar nicht auf. Aber auf den zweiten ist es logischer und übersichtlicher.

Slider

Im Goobi viewer Backend gibt es einen neuen Bereich um Slider zu definieren. Dafür können die folgenden Quellen verwendet werden:

• Werke Diese werden über eine Solr-Query ausgewählt. Verwendet werden der Titel und der Repräsentant der Werke. Es wird automatisch auf das Werk verlinkt.

• Sammlungen Hier steht ein Multiselect Feld zur Verfügung. Der übersetzte Sammlungsname und der konfigurierte Repräsentant einer Sammlung werden hier verwendet. Es wird automatisch auf die Sammlung verlinkt.

• CMS-Seiten Hier können Kategorien ausgewählt werden in denen CMS-Seiten zusammengefasst sind. Aus den Seiten wird dann die Überschrift und ein enthaltenes Bild verwendet. Es wird automatisch auf die CMS-Seite verlinkt.

• Medien Erstellt einen Slider auf Basis von Bildern die im Medien Bereich hochgeladen und einer gemeinsamen Kategorie zugewiesen wurden. Verwendet werden der Titel und das Bild selbst. Sofern ein Link angegeben wurde wird auch dorthin verlinkt.

Der Goobi viewer kommt mit einer Vorauswahl von verschiedenen Slider Styles. Diese können im Theme visuell angepasst und alternativ auch durch eigene Konfigurationen ergänzt werden.

Für die Verwendung des Sliders steht ein neues CMS-Template zur Verfügung.

Widget: Aktionen

Das im letzten Monat inhaltlich überarbeitete Widget "Aktionen" wurde noch einmal visuell angepasst. Aus der Community kam der Vorschlag das Widget, das administrative Tätigkeiten erlaubt und nur Nutzern mit entsprechenden Rechten zur Verfügung steht, in dem blauton des Backends einzufärben. Damit wäre eine visuelle Verbindung geschaffen und es ist auch optisch sofort ersichtlich, dass es sich hierbei um eine administrative Möglichkeit handelt.

Diese Idee haben wir sehr gerne aufgegriffen und umgesetzt. Hier noch einmal das alte und neue Styling nebeneinander:

REST API

Zugriffslizenzen für Werke können mit IP-Adressen verknüpft werden. Damit ist es Möglich den Zugang zum Beispiel auf einen Lesesaal einzuschränken. Bei größeren Netzwerken mit Proxies und NAT ist es manchmal schwer herauszufinden, welche IP-Adresse der Goobi viewer eigentlich am Ende sieht um die Zugriffslizenz zu prüfen. Um dieses zu vereinfachen wurde ein neuer REST Endpoint entwickelt, der genau diese IP-Adresse zurück gibt. So kann von dem gewünschten PC einfach die URL aufgerufen und dann für die weitere Konfiguration verwendet werden.

Der Endpoint ist in der Swagger Dokumentation aufgelistet und befindet sich unter /users/current/. Er kann auf der Demoinstanz unter der folgenden URL ausprobiert werden:

Sonstiges

• Für angemeldete Benutzer gibt es eine Auflistung der Merklisten im DropDown Menü. Die Sortierung erfolgte darin bisher in der Reihenfolge in der die Merklisten angelegt wurden. Sie erfolgt jetzt absteigend nach zuletzter Bearbeitung. Die Listen, zu denen zuletzt Werke oder Bilder hinzugefügt wurden, stehen an oberster Stelle.

• Die Anzeige von Annotationen ist jetzt auch wieder unter dem Bild möglich. Das Widget in der Seitenleiste wird dann ausgeblendet. Siehe dazu auch Kapitel 1.24 in der Goobi viewer Dokumentation.

• Deaktivierte Elemente werden im Backend visuell stärker gekennzeichnet.

• Ein sehr alter und langwieriger Bug konnte behoben werden. Wenn bei der Authentifizierung mit Google eine weiße Seite angezeigt wird, dann muss der Timeout für den Authentication Provider erhöht werden, zum Beispiel auf den Wert 60000.

Versionsnummern

Die Versionen die in der pom.xml des Themes eingetragen werden müssen um die in diesem Digest beschriebenen Funktionen zu erhalten lauten:

Der Goobi viewer Indexer hat die Versionsnummer 21.03

Der Goobi viewer Connector hat die Versionsnummer 21.03.1

Das Goobi viewer Crowdsourcing Modul hat die Versionsnummer 21.03

Coming soon

• Erweiterungen bei den Karten

• Anpassungen im Crowdsourcing

• URL Anpassungen bei Doppelseiten

Entwicklungen

IIIF

Der Goobi viewer Core implementiert jetzt die IIIF Presentation API und die IIIF Image API in den jeweiligen 3.0er Versionen. Dafür wurde in der REST API der neue Namespace /api/v2/ eingeführt. Dadurch bleiben die URLs zu den bisherigen Manifesten stabil. In der Konfigurationsdatei kann eingestellt werden welche IIIF Version der Goobi viewer in seiner eigenen Oberfläche standardmäßig ausliefert.

Zu dieser und weiterer Konfigurationsoptionen siehe auch in der Goobi viewer Dokumentation.

Übersetzungen

Das Thema Übersetzungen im Goobi viewer war in der Vergangenheit sehr umständlich und komplex. Ursächlich dafür war vor allem, dass die in der Oberfläche angezeigten Inhalte an verschiedenen Stellen übersetzt werden müssen. Erschwerend kommt hinzu, dass die Inhalte oft auch aus unterschiedlichen Quellen kommen. Für die Übersetzung gab es:

• Die globalen messages mit den Werten die der Goobi viewer Core selbst mitbringt und bei jedem Update überschreibt

• Die lokalen messages mit lokal überschriebenen und angepassten Werten

• Das CMS-Backend mit individuellen Texten

Als potentielle Quellen für die Anzeige diente neben den drei bereits genannten Bereichen aber auch noch der Solr-Suchindex bei dem einerseits die Feldnamen selbst und andererseits Teile der Feldinhalte relevant sind. So soll in der Oberfläche nicht der Feldname MD_LANGUAGE sondern Sprache stehen. Außerdem soll bei der Sprache nicht der Feldwert ger auftauchen sondern die entsprechende Übersetzung deutsch.

Wenn man jetzt noch bedenkt, dass die globale messages Datei gute 3.400 Einträge umfasst war schnell klar, dass das zum selber bearbeiten für Anwender viel zu kompliziert war.

Aus diesem Grund wurde im Backend ein neuer Bereich "Übersetzungen" implementiert. Dieser Bereich kann über die Konfigurationsdatei gesteuert werden um relevante beziehungsweise gewünschte Übersetzungsgruppen freizugeben. Anschließend steht im Backend ein Editor zur Verfügung, der es erlaubt die Übersetzungen für die gewünschten Sprachen zu pflegen.

Alle Arbeiten werden dabei konsequent in den lokalen messages Dateien gespeichert, es gibt keine Datenbank dazwischen oder ähnliches. Ein Locking-Mechanismus verhindert, dass mehrere Administratoren gleichzeitig an den Dateien arbeiten.

Die Standardkonfiguration bringt eine Vorauswahl fünf Gruppen mit, die in der Vergangenheit für die Übersetzung oft angefragt wurden:

1. Die Namen der Solr-Felder (Angezeigter Name eines Metadatums)

2. Die Werte des Solr-Feldes DC (Sammlungsnamen)

3. Die Werte des Solr-Feldes DOCSTRCT_TOP (Publikationstypen)

4. Die Werte des Solr-Feldes DOCSTRCT_SUB (Strukturtypen)

5. Die E-Mailtexte der versendeten E-Mails

Zugriffsbeschränkungen

Neu ist die Möglicheit den Zoom und den Download von Bildern über eine Zugriffslizenz einzuschränken. Damit ist die normale Bildanzeige zwar zugänglich aber die ausgelieferten Inhalte werden beschränkt. Dafür stehen die neuen Funktionen "Bildzoom" und "Bild-Download" für Zugriffslizenzen und Rechte zur Verfügung.

Ist die Einstellung für einen Datensatz aktiv, ist auch die Bildauslieferung über die IIIF API entsprechend eingeschränkt.

Strukturelement-Navigation

In der Vollbildansicht besteht die Möglichkeit zwei zusätzliche Navigationselemente einzublenden um zwischen definierten Strukturelementen zu navigieren. Als Anwendungsfall für die Entwicklung dient ein digitalisierter Archivbestand, wo zwischen den einzelnen Dokumenten innerhalb einer Mappe navigiert werden soll.

Archivansicht

Die Bildvorschau in der Archivansicht wurde erweitert. Lagen für eine Verzeichnungseinheit bisher Digitalisate vor, wurde der Repräsentant angezeigt und man konnte in die Bildanzeige wechseln. Diese Funktionalität wurde erweitert, so dass wenn Strukturelemente vorliegen von der ersten Hierarchieebene jeweils das erste Bild des Strukturelements als Thumbnail angezeigt wird. Bei Klick auf ein Thumbnail öffnet sich das Bild in der Vollbildansicht. Bei einer Mappe mit mehreren enthaltenen einzelnen Dokumenten ist so ein schneller Überblick über den Inhalt der Mappe und das gezielte Springen zu einem gewünschten Dokument möglich.

Arbeitsaufträge im Hotfolder

In der blauen Topbar kann die Anzahl der sich im Hotfolder befindlichen Dateien / Arbeitsauträge angezeigt werden. Dafür wurden der Goobi viewer Indexer und der Goobi viewer Core entsprechend erweitert.

Bereits heute gibt der Goobi viewer Indexer nach einer erfolgreichen Indexierung Informationen an den Goobi viewer Core weiter. Wenn Bilder verarbeitet wurden veranlasst er zum Beispiel die Leerung des Bildcaches für das Werk oder er übermittelt seine eigene Versionsnummer für die Anzeige auf dem Dashboard des Admin Backends. Neu hinzugekommen ist, dass der Goobi viewer Indexer nun auch die Anzahl der Arbeitsaufträge im Hotfolder ermitteln kann und dann weiterleitet. Dieses wird dann in der blauen Topbar im Backend angezeigt. Auf diese Weise ist für Administratoren schnell ersichtlich ob und wenn ja wie viele Dateien noch in der Queue sind.

Optional kann die Topbar auch nur für Administratoren im Frontend angezeigt werden.

Versionsnummern

Die Versionen die in der pom.xml des Themes eingetragen werden müssen um die in diesem Digest beschriebenen Funktionen zu erhalten lauten:

Der Goobi viewer Indexer hat die Versionsnummer 21.04

Der Goobi viewer Connector hat die Versionsnummer 21.04

Das Goobi viewer Crowdsourcing Modul hat die Versionsnummer 21.04

Coming soon

• Anpassungen an den IIIF Schnittstellen

• Themes mit rechts-nach-links Leserichtung

• werksbasierte Hinweise mit formatiertem Text

Allgemeines

In den letzten Arbeitstagen im Dezember hat es im Goobi viewer keine bedeutenden Entwicklungen mehr gegeben. Der Fokus lag ganz auf Aufräumen, Bugfixing und Abschluss des Jahres.

Deswegen berichten wir in diesem Digest auch über keine neuen Entwicklungen. Anstelle auf die letzten zwölf Monate zurück zu blicken, möchten wir aber einen Ausblick geben über das was in 2021 definitiv kommen wird und das, was wir uns für 2021 vorgenommen haben.

Was kommen wird

IIIF

In der Coming soon Sektion steht der Punkt nun bereits seit einem halben Jahr. Im Januar soll mit der Entwicklung endlich begonnen werden. Die IIIF Community hat Mitte des Jahres 2020 für die Image- und Presentation API die Spezifikationen für die Version 3.0 verabschiedet und als stabil deklariert. Der Goobi viewer wird diese Spezifikationen in Kürze ebenfalls unterstützen. In dem Zuge werden auch die weiteren in diesem Kontext bereits implementieren APIs (IIIF Search und IIIF ChangeDiscovery API) mit aktualisiert.

Eventuell werden wir in 2021 auch die Implementierung der IIIF Authentication API sehen. Allerdings gibt es dort gerade ungelöste Herausforderungen mit Ankündigungen verschiedener Browserhersteller die Unterstützung für "Third-Party-Cookies" abzuschaffen. Der Hintergrund von dieser Entscheidung ist, dass diese spezielle Art von Cookies von der Werbebranche stark zum Tracking genutzt wird und dem Einhalt geboten werden soll. Die Third-Party-Cookies sind aber ein essentieller Bestandteil der IIIF Authentication API, ja sie beruht auf genau dieser Funktionalität. Deswegen ist die um sich in dem Entscheidungsprozess einzubringen um entweder die Funktionalität der API sicherzustellen oder an der Entwicklung einer Alternative mitzuarbeiten. Je nachdem wie die weitere Diskussion ausfällt wird das Ergebnis auch unsere Entscheidung maßgeblich beeinflussen die API zu implementieren oder nicht.

Rechts-nach-Links Themes

Wie bereits im letzten Digest angekündigt werden wir in den kommenden Monaten umfangreiche Änderungen am Goobi viewer Core vornehmen. Konkret geht es darum, dass für ein Projekt ein Theme realisieren werden soll, dessen Zielgruppe zu gleichen Teilen Arabisch und Englisch als Muttersprache hat. Die Sprachen haben jedoch eine unterschiedliche Leserichtung. Dementsprechend soll sich auch das komplette Theme bei einem Sprachwechsel quasi spiegeln. Um dieses Ziel zu erreichen müssen XHTML Strukturen angepasst und CSS Anweisungen auf neuere Konzepte wie zum Beispiel CSS Grid und Flexbox umgestellt werden. Als veraltet geltende Konzepte wie floats werden entfernt. Weiter müssen individuelle Lösungen, zum Beispiel für absolut positionierte Elemente oder Pfeile erarbeitet werden. Ein Beispiel für ein absolut positioniertes Element ist das Fähnchen "Zur Merkliste hinzufügen" oberhalb eines Thumbnails in der Suchtrefferliste. Pfeile befinden sich zum Beispiel in der Vollbildanzeige oben rechts zum Verlassen oder darunter zum Ein- und Ausklappen der Sidebar.

Ein positiver Nebeneffekt ist eine verbesserte Responsivität für mobile Endgeräte.

Werksbasierte Hinweise

Der Goobi viewer wird die Möglichkeit bekommen - je nach Theme in der Seitenleiste oder im Contentbereich - werksbasierte Hinweise anzuzeigen. Dafür wird es im Widget "Änderungen am Werk" einen neuen Link geben der dann auf einen neuen Bereich im Backend zeigt. Dort kann für die aktivierten Sprachen ein Titel und ein Text hinzugefügt werden können. Der Text kann dabei mit dem bekannten WYSIWIG Editor formatiert werden.

Zitierempfehlungen

Der Goobi viewer wird die Unterstützung für verschiedene Zitierstile bekommen. Die unterstützten Formate müssen in der Konfigurationsdatei hinterlegt werden. Das Format kann dann im Widget "Zitieren und Nachnutzen" ausgewählt werden. Anschließend wird eine Zitierempfehlung im selben Widget direkt angezeigt. Typische Beispiele wären die Zitierstile American Psychological Association (APA), Modern Language Association (MLA), Harvard, Chicago, ... .

Weiteres

Ohne zu weit ins Detail gehen zu wollen, aber es stehen auch weitere visuelle Veränderungen für die Anzeige von mehrbändigen Werken, Entwicklungen im Kontext Karten oder die Fertigstellung des Bedienkonzeptes im Admin-Backend etc. an. Dazu aber zu gegebener Zeit mehr.

Was wir uns vornehmen

Vorgenommen haben wir uns einen großen Punkt: Wir wollen die Suche besser machen. Die letzte größere Rekonzeption ist nun einige Jahre her und immer wieder fallen uns Dinge auf oder werden uns zurückgemeldet die intuitiver und besser sein könnten.

Für diesen Vorsatz brauchen wir die Mithilfe der Community! Die Suche umfasst verschiedenste Bereiche und alle wollen irgendwie bedacht sein. Das ist zum Beispiel:

• Die Bedienführung bei der einfachen und der erweiterten Suche

• Die Bedienführung nach einer Suche zur weiteren Verfeinerung der Suchanfrage

• Die visuelle Ausgestaltung der Suchtrefferanzeige

• Performance!

Das alles entscheidende ist aber:

• Der Algorithmus zum bestimmen der richtigen Suchtreffer

Gerade bei diesem Punkt brauchen wir Hilfe. Wir sammeln nämlich konkrete Anwendungsfälle in Form von User-Stories. Die sind umgangssprachlich verfasst und beschreiben aus der Sicht eines Nutzers eine Arbeitsweise um ein Ziel zu erreichen. Zum Beispiel:

Auf der Startseite klicke ich im Widget Neuzugänge auf einen Titel um dieses Werk zu öffnen.

Bei der Suche sammeln wir User-Stories die ein kleines bisschen ausführlicher formuliert sind. Zum Beispiel:

Ein weiteres Beispiel für eine User-Story ist:

Mit diesen User-Stories können wir dann mit einem konkreten Datenbestand ein Verhalten nachvollziehen. Ab dem dritten Quartal 2021 möchten wir dann in eine detaillierte Planung für die Überarbeitung und Verbesserung der Suche gehen. Im Optimalfall können wir das Ganze dann zum Herbst hin (bei einem Anwendertreffen??) diskutieren und darüber sprechen können wie die Umsetzung aussieht.

Einen direkten Aufruf für die User-Stories wird es im kommenden Jahr auch noch einmal im Community Forum geben. Dort werden wir die Stories öffentlich dokumentieren und diskutieren.

Coming soon

• Anpassungen an den IIIF Schnittstellen

• Themes mit rechts-nach-links Leserichtung

• Aus der Oberfläche heraus Caches leeren

Ankündigungen

Der Goobi viewer hat das Schema der Versionierung mit Goobi workflow synchronisiert. Dadurch ist jetzt immer direkt ersichtlich aus welchem Jahr und Monat eine Version stammt. Diese Version ist jetzt die 21.01. Die beiden FAQ Beiträge um herauszufinden wie alt ein Goobi viewer ist und wie die Versionierung funktioniert wurden entsprechend überarbeitet.

Mit dieser Version wird die Funktionalität um Strukturtypen während der Indexierung automatisch durch andere zu ersetzen (siehe ) offiziell abgekündigt. Wenn sie noch von Einrichtungen genutzt wird werden diese hiermit aufgefordert sich per E-Mail oder im Community Forum mit uns in Verbindung zu setzen. Wir planen die Funktionalität mit einem der kommenden Versionen im Goobi viewer Indexer ersatzlos zu löschen.

Entwicklungen

Werkshinweise

Im Backend gibt es einen neuen Bereich für Werkshinweise. Über die neue Funktionalität ist es möglich für ein Werk ein individuelles neues Sidebar Widget mit einem eigenen Titel und eigenem Text hinzuzufügen. Je nach Styling im Theme kann die Funktionalität aber auch an andere Stellen verschoben werden.

In der Werkansicht steht dafür eingeloggten Benutzern mit Administratorenrechten im Widget "Änderungen am Werk" ein neuer Link zur Verfügung: "Werkshinweis hinzufügen". Nach einem Klick öffnet sich automatisch der neue Bereich im Backend. Während in der Seitenleiste ein paar Informationen zum Werk selbst angezeigt werden, können in der Mitte Titel und Text eingegeben werden. Dabei steht die inzwischen bekannte Reiteransicht mit der visuellen Hervorhebung der Übersetzungen zur Verfügung. Im Backend gibt es weiter eine tabellarische Übersicht der angelegten Hinweise. Dort lässt sich unter Eingabe eines Identifiers auch ein Hinweis anlegen.

API

Die Arbeiten zur Refaktorisierung der API sind endlich komplett fertiggestellt. Im Juli letzten Jahres war bereits ein großer Teil der API refaktorisiert und in einen neuen Namespace umgezogen. In den letzen Monaten sind nun auch die letzten, vornehmlich internen Teile final umgezogen. Damit entfällt der Bereich unter /rest/ komplett und wird durch die neue Struktur unterhalb von /api/v1/ ersetzt.

Der neue Bereich /api/v1/ biete viele Vorteile. So ist zum erstem Mal die API komplett dokumentiert (siehe /api/swagger/). Außerdem gibt es eine Testinfrastruktur in der bereits viel Code automatisch getestet wird und die ermöglicht die Abdeckung dort in Zukunft auch noch weiter zu erhöhen. Auch ist die API ab jetzt versioniert. Das bedeutet, dass nicht abwärtskompatible Änderungen in einem anderen Namespace durchgeführt werden können (zum Beispiel /api/v2/). Aufrufe an /api/v1/ sind dadurch dann nicht betroffen.

Einen sauren Apfel gibt es trotzdem noch: Es handelt sich hierbei um einen sogenannten Breaking Change. Sofern noch die alte REST Schnittstelle verwendet wird müssen die Aufrufe entsprechend angepasst werden.

Karten

Messages

Mit der Maven Umstellung ging einher, dass die globalen Messages Dateien nach einer Installation nicht mehr entpackt im Dateisystem lagen, sondern gepackt innerhalb der viewer-core.jar enthalten waren. Wir konnten die messages Dateien jetzt in das goobi-viewer-core-config Repository umziehen. Damit liegen diese nach der Installation wieder im Dateisystem und sind deutlich einfacher zugänglich.

Goobi viewer Indexer

Der Goobi viewer Indexer hat einen neuen Parameter bekommen um automatisch ein Boolean-Feld zu generieren wenn das dazugehörige Metadatum vorhanden ist. Diese können dann zum Beispiel in der Facettierung eingesetzt werden. Ein Anwendungsbeispiel ist zum Beispiel, dass nur bestimmte Werke Ortsangaben besitzen und man nur nach diesen Werken facettieren möchte.

Dokumentation

Versionsnummern

Die Versionen die in der pom.xml des Themes eingetragen werden müssen um die in diesem Digest beschriebenen Funktionen zu erhalten lauten:

Der Goobi viewer Indexer hat die Versionsnummer 21.01.1

Der Goobi viewer Connector hat die Versionsnummer 21.01

Das Goobi viewer Crowdsourcing Modul hat die Versionsnummer 21.01

Coming soon

• Verwaltung eines Cookie Banners

• Anzeige eines Disclaimers für Werke

• CMS-Seite als Startseite für Werke

• Upload von Datensätzen

Entwicklungen

Backend