Über dieses Tool

Normhaster ist ein webbasiertes Tool, welches die Suche nach Daten in verschiedenen Normdatenbanken ermöglicht. Die Ergebnisse werden anhand von Identifikationsnummern (z.B. GND-Nummer) zusammengefasst und dargestellt. Als Datenquelle werden die Datenbanken der GND (Deutsche National Bibliothek), VIAF (Virtual International Authority File) und LOC (Library of Congress) genutzt.

Suche

Über die Eingabefelder des Suchinterfaces können die Art des zu suchenden Objektes und das Suchwort eingegeben werden. Im Moment wird die Suche nach Personen und Werken unterstützt. Für die Eingabe des Suchwortes steht eine Autovervollständigung zur Verfügung, welche eine Liste von Vorschlägen für das gesuchte Objekt anbietet. Des weiteren kann der Zeitraum für die Suche über einen Schieberegler oder über die darunter liegenden Eingabefelder eingestellt werden. Dabei werden alle Jahre zwischen 3000 v. Chr. und heute unterstützt. Die Eingabe von Jahreszahlen vor Christus wird über die Kürzel "v. Chr." oder "BC" erkannt.

Um eine schnelle Suche zu ermöglichen wird sowohl die Autovervollständigung als auch die Suche zunächst in der lokalen Normhaster-Datenbank durchgeführt. Diese wurde aus einem Abbild der GND-Datenbank erstellt, welches von der Deutschen National Bibliothek in regelmäßigen Abständen veröffentlicht wird. Über den Button "weitere Treffer online suchen" kann die Suche online in den Datenbanken der GND, VIAF und LOC durchgeführt werden. Diese Suche ist meist etwas zeitintensiver.

API

Für die Suche nach Daten stehen zwei URLs zur Verfügung.

Die Suche nach einem Suchwort liefert eine Trefferliste mit mehreren Einträgen, die auf die eingegebenen Suchparameter passen:

http://normhamster.uzi.uni-halle.de/interface/hitList?obj_type=person&search_phrase=SUCHWORT&type=db

Parameter:

• obj_type: Type des zu suchenden Objektes ("person" oder "publication")
• search_phrase: Suchwort
• type: (optional) Suche in interner Datenbank (type=db) oder im Internet (type=web) (voreingestellt: db)
• search_year_from und search_year_to: (optional) Zeitraum für die Suche (Jahre vor Christus werden als negative Zahl angegeben: z.B. 2000 v. Chr. -> search_year_from=-2000)
• max_hit: (optional) Anzahl an zurückgelieferten Treffern (voreingestellt: 20)

Beispiel:
http://normhamster.uzi.uni-halle.de/interface/hitList?obj_type=person&search_phrase=heinrich&type=db&search_year_from=-2000&search_year_to=1990&max_hit=10

Die Suche nach einer oder mehreren IDs liefert die Detailseite zu dem Eintrag:

http://normhamster.uzi.uni-halle.de/interface/hitDetails?obj_type=person&id=GND&source=gnd&type=db

Parameter:

• obj_type: Type des zu suchenden Objektes ("person" oder "publication")
• id: ID des Objektes. Es werden IDs von der GND, VIAF und LOC unterstützt. Die Quelle der ID muss über den Parameter source angegeben werden. Meherer IDs für das gleiche Objekt werden mit "|" getrennt.
• source: Art der angegebenen ID. Mehrere Quellen werden mit "|" getrennt. Die Reihenfolge muss mit der der IDs übereintimmen.
• type: (optional) Suche in interner Datenbank (type=db) oder im Internet (type=web) (voreingestellt: web). Bei der online-Suche werden alle Quellen, zu denen eine passende ID vorliegt durchsucht.

Beispiel:
http://normhamster.uzi.uni-halle.de/interface/hitDetails?obj_type=person&id=123456|654321&source=gnd|viaf&type=web

Ausgabeformat

Das Ausgabeformat für die Suche kann über den HTTP-Header gesetzt werden:

• für eine HTML-Ausgabe:  Accept: text/html
• für eine JSON-Ausgabe:  Accept: application/json

Beispiel:

JSON-Format Trefferliste: Die wichtigsten Informationen zu jedem Treffer werden mitgeliefert

[{"Person":
  {"gnd":["118577158","126650675","4037360-5"],
   "name":["Mann, Klaus"],
   "lifetime":["1906-1949"],
   "professions":["Schriftsteller","Journalist","Theaterkritiker"]
  }},
 {"Person":
  ...
 }
]

JSON-Format Trefferdetails: Alle Informationen zu dem Treffer werden mitgeliefert

{"Person":
  {"gnd":["118577158","126650675","4037360-5"],
   "name":["Mann, Klaus"],
   "name_variants":["Mann, Klaus Heinrich Thomas","Man, Klaus", ...],
   "lifetime":["1906-1949"],
   "born_where":["München"],
   "died_where":["Cannes"],
   "professions":["Schriftsteller","Journalist","Theaterkritiker"],
   "publications":["Mann, Klaus: Flucht in den Norden. - 1934", ...]
  }
}