Damit es nicht untergeht, sollen hier zwei neue, zusätzliche Optionen zur Benutzung des Resolvers besprochen werden. Beide sind aber auch beim Aufrufen des Resolvers ohne weitere Parameter dokumentiert.

„Einfache“ Beacon-(Konkordanz-)Listen

Eine traditionelle Beacon-Datei besteht neben ihrem „Kopf“ aus einer Liste, grob gemäß CSV, in auf der einen Seite eines Trennzeichens jeweils eine ID aus einem Repositorium aufgelistet wird, und auf der anderen Seite des Trennzeichens die ID derselben Entität in einem anderen Repositorium. Mittlerweile ist eine alternative Form dazugekommen, in der nur noch die IDs verfügbarer Einträge aus dem „Quell-Repositorium“ (etwa die GND) aufgelistet werden, und in der der „Kopf“ der Datei Auskunft über eine URL gibt, die auf den richtigen Eintrag im lokalen Repositorium (hier eine Instanz von museum-digital), der über die ID im Quell-Repositorium aufgerufen werden kann, verweist.

Eine solche Liste kann nun über das Anfügen des GET-Parameters „beaconHideLocal“ eingetragen werden. https://global.museum-digital.org/resolver/actor/gnd gibt eine Liste aller Akteure, die sowohl in der Gemeinsamen Normdatei (GND) als auch bei museum-digital erfasst sind, mit beiden IDs zurück. https://global.museum-digital.org/resolver/actor/gnd?beaconHideLocal=1 gibt im Gegensatz dazu eine „einfache“ Beacon-Datei zurück, die alle GND-IDs auflistet, die Entsprechungen in museum-digital haben.

„No-Referral“: Text statt Weiterleitungen

Ein weiterer kleiner Zusatz ist das Hinzufügen einer Option, um Suchen nach einer ID direkt die URL, auf die weitergeleitet werden würde als Text zu bekommen. Je nach benutzter Programmiersprache kann so das automatische Arbeiten mit dem Resolver wesentlich erleichtert werden.

Ein Beispiel: Ruft man https://global.museum-digital.org/resolver/place/geonames/2950159 auf, wird man auf des Ortes weitergeleitet, der bei Geonames die ID 2950159 trägt (das ist Berlin). Diese Weiterleitung geschieht über HTTP-Header. Möchte man aber eigentlich nur die URL, auf die man weitergeleitet würde, erfahren, kann man jetzt https://global.museum-digital.org/resolver/place/geonames/2950159?noReferral=1 aufrufen und erhält nur diese als Text.

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

Getting Started

Zum Benutzen der neuen Funktion muss an die URL der Startseite nur „/resolver“ angehängt werden. Der Einfachheit halber folgen Beispiele aus der deutschlandweiten Instanz von museum-digital. Hier kann der Resolver also unter https://nat.museum-digital.de/resolver/ aufgerufen werden.

Unter dieser URL findet sich eine kurze Anleitung für die Benutzung.

Listen der verknüpften Repositorien aufrufen

An die gebene Basis-URL kann nun der gewünschte Daten-Typ angehängt werden. Verfügbar sind derzeit Institutionen (institution), Objekte (object), Akteure (actor), Orte (place) und Schlagworte (tag). Durch Anhängen des entsprechenden Typs kann eine Liste von passenden, verlinkten Repositorien aufgerufen werden.

Für Orte sind derzeit etwa Verknüpfungen zu und über die folgenden Repositorien verfügbar:

• geonames
• gnd
• nomisma
• pleiades
• Website
• wikidata

Diese Liste kann unter https://nat.museum-digital.de/resolver/place gefunden werden.

Beacon-Datei / Konkordanzliste generieren

Durch ein weiteres Anhängen des Names eines gegebenen Quell-Repositoriums aus dieser Liste kann nun eine Konkordanzliste zwischen den Einträgen bei museum-digital und den Einträgen aus der Quelle aufgerufen werden (Beispiel: https://nat.museum-digital.de/resolver/place/gnd).

Diese Konkordanzliste wird in Form einer Beacon-Datei generiert. Mehr zum Beacon-Format kann etwa hier gefunden werden.

Link Resolving

Die eigentliche Hauptfunktion des Resolvers (wie der Name schon sagt) besteht in der Vereinfachung des Verlinkens von Inhalten aus museum-digital über IDs aus externen Repositorien.

Hängt man also z.B. an die eben genannte URL eine GND-ID eines Ortes an, wird zur entsprechenden Ortsseite weitergeleitet. 4078337-6 entspricht in der GND Tokyo, https://nat.museum-digital.de/resolver/place/gnd/4078337-6 führt also zur Ortsseite von Tokio in der deutschlandweiten Instanz von museum-digital.

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