HAGRID
HAdW GND-basierte Webservices – Beaconizer & Discoverer

HAGRID: Dokumentation

Hagrid bietet eine Vielzahl an Zugriffen auf den aggregierten Datenbestand an Normdaten. Stand Dezember 2025 sind die Normdaten der beiden Forschungsstellen Melanchthon Briefwechsel und Theologenbriefwechsel im Südwesten des Reichs in der Frühen Neuzeit (1550-1620) erfasst und können über die Suche und über Schnittstellen abgefragt und nachgenutzt werden..

Suche

Die Suche ist der zentrale Einstiegspunkt für Recherchen im Hagrid-Datenbestand. Die Suchmaske erlaubt Recherchen in den folgenden Feldern:

  • Name des Eintrags: Hier trägt man den Namen der gesuchten Person oder des Orts ein. Nach der Eingabe des zweiten Buchstabens startet automatisch das Automplete, das zu den gemachten Eingaben passende Vorschläge macht. Man kann dann entweder mittels Maus oder Cursor-Tasten einen der vorgeschlagenen Einträge auswählen oder einfach die Eingabetasten drücken.
  • Normdata-URI (Geonames, GND): Hat man eine Normdaten-URI und möchte damit verknüpfte Ressourcen aus dem Datenbestand der Forschungsstellen der Heidelberger Akademie der Wissenschaften ermitteln, trägt man hier die vollständige URL eintragen.
  • Normdaten-Typ: Hier kann der Normdaten-Typ, also entweder GND oder Geonames, ausgewählt werden. Ohne Auswahl werden Ergebnisse aus beiden Normdaten-Typen angezeigt.
  • Rolle des Eintrags: In einem Briefnetzwerk haben Personen und Orte eine Rolle, so kann bspw. eine Person ein Absender, Empfänger oder Thema eines Briefs sein. Ohne Auswahl werden Ergebnisse aller Rollen angezeigt.
  • Forschungsstelle: Derzeit sind nur Daten aus den beiden Forschungsstellen Melanchthon-Briefwechsel und Theologenbriefwechsel integriert. Ohne Auswahl werden Ergebnisse aus beiden Forschnugsstellen angezeigt.
Zum Starten des Suche wird auf die Schaltfläche "Suche" geklickt. Auf der Ergebnisübersicht werden alle relevanten Treffer angezeigt und können dort per Mausklick ausgewählt werden, woraufhin die Detailansicht des gewählten Eintrags geöffnet wird. Auf den Detailansichten werden in einer Infobox oben auf der Seite zentrale Informationen über die Person oder eine Karte für Orte angezeigt. Darunter befinden sich Links auf alle Ressourcen, die mit dem ausgewähltem Normdatum verknüpft sind. Diese sind nach Forschungsstelle und dann nach Rolle gegliedert.

Converter

Mit Hilfe des Konverters können Identifikatoren zwischen den Normdaten-Anbietern GND, Geonames, Wikidata und Pleiades konvertiert werden. Dies geschieht durch eine Abfrage des Wikidata SPARQL-Endpunkts. Zum Konvertieren kann der Identifikator in eines der vier Eingabefelder eingetragen werden, nach einem Klick auf den Konvertieren-Button oder Drücken der Eingabetaste werden die korrespondierenden Identifikatoren angezeigt und können entweder per Mausklick in die Zwischenablage kopiert oder die externe Normdaten-Webseite geöffnet werden.

OpenRefine-Service

Der OpenRefine-Reconciliation-Service bietet eine rauscharme Alternative zu Wikipedia/Wikidata, um Personen-Normdaten aus dem Umfeld der Reformation zu ermitteln. Die OpenRefine-API URL lautet https://normdaten.hadw-bw.de/api/reconcile.

Discovery-Service

Für den als Parameter übergebenen GND-Identifikator wird basierend auf Personennennungen im Reformations-Briefnetzwerk, derzeit basierend auf den beiden Forschungstellen Melanchthon-Briefwechsel und Theologenbriefwechsel, ein gewichteter Graph erstellt, der das in den Daten vorhandene Personen-Netzwerk abbildet. Hierfür führt man in der Suche eine Recherche nach einer Person durch, indem man im Feld "Name des Eintrags" den gewünschten Namen einträgt. In der Suchtrefferübersicht wählt man anschließend den gewünschten Eintrag aus und kann dann in der Personen-Detailansicht auf den Button "GraphML-Download" klicken, um den Download zu starten. Die heruntergeladene GraphML-Datei kann nun in einem Netzwerk-Analysetool wie Gephi weiterverarbeitet werden.

Beacon-Dateien

Mittels Beacon-Dateien werden Listen von Normdaten-Identifikatoren im Internet veröffentlicht, die auf online verfügbare Ressourcen verweisen, die mit den jeweiligen Normdaten-Entitäten verlinkt sind, also weitere Informationen zu den jeweiligen Entitäten anbieten. In Hagrid werden derzeit die folgenden Beacon-Dateien online angeboten:

Zum Erstellen von Beacon-Dateien von Normdaten-Identifikatoren, die in öffentlichen Daten-Repositorien wie GitHub und GitLab vorgehalten werden, siehe auch den Hagrid-Beaconizer.

Beaconizer-Service

Beim Beaconizer-Service handelt es sich um einen Webservice, mit dessen Hilfe Normdaten aus TEI XML-Daten, die in öffentlichen Repositorien wie bspw. GitHub abgelegt sind, extrahiert und eine Beacon-Datei erstellt werden kann. Zum Aufruf des Service ist ein Benutzeraccount notwendig, die erstellten Beacon-Datei dagegen sind öffentlich verfügbar. Die Basis-URL des Beaconizers lautet /api/beaconizer/create.

Um beispielsweise Personen-Normdaten (GND-Identifikatoren) aus der Dehmel-Briefedition, verfügbar unter https://github.com/subhh/dehmel-daten , zu ermitteln, sind die folgenden Parameter für den Service notwendig (vollständige Dokumentation der Schnittstelle unter https://normdaten.hadw-bw.de/api/docs):

  • username: Für den Aufruf des Beaconizers ist ein Benutzername und Passwort notwendig.
  • project: Jeder Benutzer kann mehrere Beacon-Dateien erstellen, die durch den Projektnamen voneinander unterschieden werden.
  • github_repo_uri: URL des GitHub-Repositories, dessen Normdaten extrahiert werden sollen.
  • branch: der gewünschte GitHub-Zweig.
  • subfolder: optional kann noch ein Unterordner im Repository angegeben werden.
  • namespace: der XML-Namespace des Elements, das die Normdaten-Identifikatoren enthält.
  • element_name: Name des XML-Elements.
Das Erstellen der Beacon-Datei über den Hagrid-Beaconizer erfolgt über die URL: /api/beaconizer/create?project=dehmel&github_repo_uri=https://github.com/subhh/dehmel-daten&branch=main&subfolder=brief&namespace=http://www.tei-c.org/ns/1.0&element_name=persName&username=HAdW

Die Beacon-Datei ist anschließend unter https://normdaten.hadw-bw.de/api/beacon/gnd/hadw/dehmel erreichbar.