In musdb, unserem Inventarisierungs- und Verwaltungstool, war und ist die Situation schwieriger. Einerseits ist musdb bezüglich seines Funktionsumfangs schlicht ungleich größer. Andererseits verunmöglichen die Reiter-basierte Struktur der Benutzeroberfläche und die bisher an vielen Stellen leider noch zu enge Kopplung zwischen Benutzeroberfläche und zugrundeliegender Abfragelogik ein API-Design wie in der Ausgabe, wo sich die API durch das einfache Anfügen von &output=json (bzw. ?output=json) aufrufen lässt. An vielen Stellen lässt sich zwar genau das tun, aber die Ergebnisse sind zwangsläufig unvollständig und von der Benutzeroberfläche gefärbt.

Andererseits ist eine API gerade für musdb interessant. Wenn Museen ihr lokales Inventarisierungsprogramm der Wahl verwenden könnten, und die Updates sofort auch in musdb und den öffentlichen Seiten gespiegelt würden, wäre das ein großer Fortschritt. Bisher bräuchte es dafür die Importfunktion, dass heißt, dass selbst bei einer vollen Automatisierung des Synchronisationsablaufs immer eine Verzögerung im Updatefluss bliebe.

Ein Anfang: Objekte per API updaten

Ein erster Schritt in Richtung einer dedizierten API für musdb, die unabhängig von der Benutzeroberfläche benutzt werden kann, ist nun getan. Zumindest Objektinformationen sind nun über eine gezielt dafür eingerichtete API auslesbar und bearbeitbar. Weitere Funktionen kommen sobald ein Bedarf besteht.

Und wenn man einmal damit anfängt, macht man es natürlich am besten gleich sauber. Mit der neuen API wurde ein Umformulieren und Neusortieren von vielen grundlegenden Funktionen auf technischer Ebene notwendig, die uns eine gute Gelegenheit gegebenen hat, gleich automatische Tests für alle in der API benutzten Funktionen zu schreiben. Ihre jetzt bestehenden Funktionen bleiben also sicher stabil.

Andererseits lag es nahe, die API beim Bauen gleich mithilfe eines Standards wie OpenAPI maschinenlesbar zu beschreiben. Gesagt, getan. Eine in JSON gefasste OpenAPI-Beschreibung der API von musdb findet sich in jeder regionalen Instanz unter /musdb/api, also etwa unter https://hessen.museum-digital.de/musdb/api.

Mit der Verwendung von OpenAPI eröffnen sich auch all die Tools, die allgemein für mit OpenAPI beschriebene Schnittstellen existieren. Eine vollständige menschenlesbare API-Dokumentation findet sich nun also im Handbuch (weil die API immer an die jeweilige regionale Instanz gebunden ist, funktioniert die Ausprobieren-Funktion im Handbuch nicht; eine gleich geformte API-Übersicht mit funktionierender Ausprobieren-Funktion ist in musdb in der Navigation verlinkt).

Nächste Schritte

Auch wenn sich jetzt alle Objektinformationen über die Schnittstelle bearbeiten lassen, ist die neue API von musdb noch sehr unvollständig. Ein nächster Schritt wird also definitiv die Erweiterung der API mindestens um die direkt anliegenden Funktionalitäten sein – z.B. das Auflisten der verfügbaren Sammlungen, sodass man überhaupt erst einmal die IDs zum Verlinken von Sammlungen ermitteln kann.

Auf der anderen Seite ist die API-Dokumentation mit OpenAPI ein großer Fortschritt auch gegenüber der Dokumentation der API der Ausgabe. Es bleibt zu hoffen, dass wir bald dazu kommen, auch für die API der Ausgabe eine OpenAPI-Beschreibung bereitzustellen. Geplant ist es auf jeden Fall.

This content is licensed under a Creative Commons Attribution 4.0 International license.

Eine neue Suchfunktion in musdb bietet endlich die Möglichkeit, nach Ereignissen zu suchen (nicht nur ihren Bestandteilen), negative Suchen durchzuführen (z.B. „Objekte, die nicht aus Hamburg kommen“), „oder“-Suchen zu machen, und – mir persönlich seit langem ein Anliegen – Objekte mit Maßangaben größer oder kleiner als ein gegebener Wert zu suchen. Damit spiegelt die Objekt-Suchfunktion in musdb die Logik der hier noch nicht besprochenen, aber schon länger verfügbaren neuen Suchfunktion der Ausgabe von museum-digital.

Weil es sich aber um so eine einschneidende Überarbeitung handelt, war es umso dringlicher, die entsprechende Seite im Handbuch zu überarbeiten. Einmal dabei, haben wir die Gelegenheit genutzt, das Handbuch technisch auf ganz neue Beine zu stellen.

Die Handbuchseite zur neuen Suchfunktion in musdb kann hier gefunden werden.

Neues Handbuch

Warum also ein neues Handbuch? Der grundlegendste Grund ist die zugrundeliegende Software: Das alte Handbuch basierte auf einer selbst geschriebenen Software, die einerseits dem Anspruch eines Handbuchs nicht in allen Belangen entsprach, und andererseits in Ermangelung von Zeit schlicht nicht oft genug upgedatet wurde.

Das neue Handbuch wird mit der Software mdbook generiert, die etwa auch für die Benutzer-Dokumentation der Programmiersprache Rust zum Einsatz kommt. Damit kommen nützliche, vorher nicht vorhandene Features wie etwa eine Druckfunktion für das gesamte Handbuch und eine besser navigierbare Navigation.

Für die Bearbeitung des Handbuchs bedeutet der Wechsel der Software, dass das Handbuch jetzt in simplen Plain-Text-Dateien geschieht, statt wie bisher direkt auf dem Server mit einem Login und eigenen Editor. Dadurch, dass diese Plain-Text-Dateien auch auf dem lokalen Rechner bearbeitet werden, kann in Zukunft theoretisch jeder zum Handbuch beitragen.

Die neue Software hilft aber natürlich noch nicht, das bisher sehr unvollständige Handbuch auch tatsächlich zu schreiben, auch wenn die Arbeit jetzt auch mehr Schultern verteilt werden kann.

Beitragsbild: Zuccarelli, Francesco: Cicero entdeckt das Grabmal des Archimede / CC BY-NC-SA @ Stiftung Preußische Schlösser und Gärten Berlin-Brandenburg & Murza, Gerhard (1994)

This content is licensed under a Creative Commons Attribution 4.0 International license.

Ähnlich verhält es sich bei Zeiten, die sehr verschieden Eingegeben werden können. Die übliche „Basis“-Schreibweise für Zeiten in der Datenbanktabelle für Zeiten ist das deutsche TT.MM.JJJJ, aber häufig werden Zeiten wie „15. Januar 1920“ eingegeben oder importiert. In vielen Fällen lassen sich diese automatisch in die normalisierte Form umwandeln – was wir im Vokabularkontroll-Tool (nodac) schon länger tun.

Beide Funktionalitäten, das automatische Erkennen von Ungewissheit aus dem Import-Tool und das Normalisieren von Zeit-Angaben aus nodac, haben wir im Zuge einiger sehr großer Importe (dazu später vielleicht mehr) überarbeitet und in ein eigenes Modul verschoben, sodass wir sie auch ins eigentliche Eingabetool musdb einbauen konnten.

Erkennen von Ungewissheit und Zeiten in musdb

musdb kann also jetzt Ungewissheit auf Basis von Listen von bekannten Indikatoren erkennen. Bei Zeiten sind das beispielsweise „um „, „wohl um „, „circa „, „ca. “ oder „ca “ am Beginn des eingegebenen Zeitnamens und „(?)“ oder „?“ am Ende der Eingabe. Wird einer dieser Indikatoren erkannt, wird er aus dem Zeitnamen gelöscht und die Angabe als unsicher gespeichert. Analog funktioniert es bei Akteurs- und Ortsangaben.

Besonders bei Zeiten ist, dass diese, so erkennbar, auch automatisch normalisiert werden können. Deutsche und ungarische Zeitgaben von einzelnen Tagen (15. Januar 1920) oder Monaten (Januar 1920) können so ausgelesen werden.

Einher mit der Normalisierung geht in vielen Fällen auch eine automatische Übersetzung. Dies ist besonders wichtig für Zeit-Angaben vor 1000 n. Chr., bei denen wo möglich eine automatische Angabe dazu gemacht wird, ob die Zeit vor oder nach Christus ist. Bisher ist dies für Zeitspannen implementiert. „312 – 315“ wird automatisch zu „312-315 n. Chr“ in Deutsch umgewandelt und in „312-315 CE“ auf English und „西暦312年から315年“ in Japanisch übersetzt.

Leichteres Massen-Veröffentlichen und Verstecken von Objekten

Eine kleine Erweiterung an anderer Stelle, ist, dass die Objektauswahl jetzt zur Veröffentlichung oder zum Verstecken von Objekten genutzt werden kann.

This content is licensed under a Creative Commons Attribution 4.0 International license.

Bis zur letzten Woche bot musdb nur eine direkt filterbasierte  Stapelverarbeitung. In Kürze: Nach dem Formulieren einer Suchanfrage kann man für alle gefundenen Objekte Aktionen (Zuordnen zu Objektgruppen, veröffentlichen und mehr) durchführen. Weil auf diese Art und Weise tausende Objekte mit einem Knopfdruck bearbeitet werden können und Fehler schnell tagelange Korrekturen nach sich ziehen, ist diese Funktion nur für Benutzer mit der Benutzerrolle „Museumsdirektor“ verfügbar.

Die Auswahl-Funktion bietet jetzt eine weniger radikale Option zur Stapelverarbeitung und steht damit allen Benutzern mit Bearbeitungsrechten zur Verfügung.

Um die Auswahlfunktion zu nutzen muss man als eingeloggter Benutzer von musdb zuerst einmal zur Objektübersichtsseite im Bilderwand-Modus gehen. Eine etwaige Suche kann dabei gestellt sein, muss aber nicht.

Vordergründig ist alles wie gehabt. Durch einen Klick auf eine Objektabbildung oder Kachel lässt sich die Objektseite öffnen. Aber mit einem langen Klick mit leichter Mausbewegung (als zöge man das Objekt) lässt sich der Auswahlmodus öffnen.

Ist der Auswahlmodus einmal aktiviert, lassen sich weitere Objekte durch Klicks auf die entsprechende Abbildung oder Kachel markieren. Ausgewählte Objekte sind dabei durch ein farbig ausgefülltes Rechteck oben rechts erkennbar.

Mit dem Aktivieren des Auswahlmodus ist während dessen auch eine gelb gefärbte Menüleiste am oberen Fensterrand aufgetaucht. Über die hier angebotenen Menüpunkte lassen sich die ausgewählten Objekte zu Objektgruppen, Sammlungen und Ausstellungen zuordnen oder verschlagworten.

Sind die gewünschten Objekte einmal ausgewählt, lässt sich durch einen Klick auf „Schlagwort“ ein Dialog öffnen. Mit dem in Dialog erschienenen Suchschlitz kann nun ein Schlagwort zur Verknüpfung suchen. Ein Klick auf den entsprechenden Listeneintrag verknüpft die ausgewählten Objekte mit dem Schlagwort.

Sind die Objekte erfolgreich verschlagwortet, bleibt der Auswahlmodus aktiviert, sodass die ausgewählten Objekte weiter verschlagwortet oder zugeornet werden können. Durch die Escape-Taste oder einen Klick auf das X am oberen rechten Fensterrand lässt sich der Auswahlmodus wieder verlassen.

P.S.: Weil es eh geplant war und den Auswahlmodus mit mehr Objekten in der Liste effektiver wird, haben wir die maximale Anzahl von Objekten, die in der Objektliste im Bilderwand-Modus angezeigt werden können, auf 200 erhöht (bisher: 120).

This content is licensed under a Creative Commons Attribution 4.0 International license.