[Translate to English:]

Dokumentation

Eine umfangreiche Dokumentation der Schnittstellen befindet sich auf GitHub: github.com/WIAG-ADW-GOE/WIAGweb2/blob/main/doc/wiag-manual.md

API

Die Daten zu Personen und Bistümern können in verschiedenen Formaten auch über ein API (Application Programming Interface) abgerufen werden. Die URL lauten

Parameter-Liste: Parameter-Zuordnung(&Parameter-Zuordnung) Parameter-Zuordnung: parameter=wert

Beispiel: https://wiag-vocab.adw-goe.de/domherr/data?name=Hohen&domstift=Bamberg

Folgende Ausgabeformate werden unterstützt: CSV, JSON, RDF-XML, JSON-LD. Das Format wird über den Parameter format angegeben. Ohne eine Angabe zu diesem Parameter wird JSON ausgeliefert.

Die Paramter entsprechen dabei den Eingabefeldern der Suchmaske in der Abfrage:

  • „Bischöfe Gatz“: name, diocese, office, year, someid,
  • „Domherren-Datenbank“: name, domstift, office, year, someid,
  • „Bistümer Gatz“: name.

Semantische Auszeichnung

Die Ziele Einfachheit und Informationsgehalt bestimmen die Auswahl der Ontologien, welche für die Serialisierung genutzt werden. Weitere Kriterien sind Beständigkeit und Verbreitung. Da jede bestehende Ontologie einen eigenen Fokus hat, oder für ein bestimmtes Themengebiet entwickelt wurde, decken sich die Begrifflichkeiten nicht zu hundert Prozent mit den Inhalten der Forschungsdaten der Germania Sacra. Meistens sind die Abweichungen aber tolerierbar und die Gefahr von Fehlinterpretationen sind gering. In Bezug auf strukturelle Fragen ergibt sich die gleiche Problematik, zumal hier Dokumentationen zu den Ontologien nicht immer eindeutig sind.

Gemeinsame Normdatei

https://d-nb.info/standards/elementset/gnd
Die Gemeinsame Normdatei wird von der Deutschen Nationalbibliothek bereitgestellt. Sie ist ein Instrument, um Personen, Veranstaltungen und Institutionen zu identifizieren, damit Mehrdeutigkeiten vermieden werden können. Zur GND ist eine Ontologie entwickelt worden. Sie ist eine Formatspezifikation für die Beschreibung von GND-Entitäten im semantischen Web.

Die GND-Ontologie zeichnet sich durch einen hohen Standardisierungsgrad aus und deckt viele Aspekte von für die Germania-Sacra relevanten Entitäten ab. Sie umfasst Klassen (Classes), Objekteigenschaften (Object Properties), Datentyp-Eigenschaften und Annotations-Eigenschaften (Annotation Properties).

Elemente der Gemeinsamen Normdatei sind im Folgenden mit gndo: gekennzeichnet.

Friend of a Friend

http://xmlns.com/foaf/0.1/
Die Entwicklung der Friend of a Friend-Ontologie (FOAF) war motiviert durch die Nutzung von Kontaktdaten, die Menschen in sozialen Netzwerken verbinden. Die Ontologie gliedert sich in Klassen (Classes) und Eigenschaften (Properties). Der Kernbestand (Core) umfasst Eigenschaften von Personen und sozialen Gruppen, die wenig Änderungen unterworfen sind.

Elemente aus Friend of a Friend sind im Folgenden mit foaf: gekennzeichnet.

Web Ontology Language

http://www.w3.org/2002/07/owl#
Die Web Ontology Language (OWL) ist eine Spezifikation zur Beschreibung von Ontologien, umfasst aber selbst auch eine Ontologie.

Elemente der Web Ontology Language sind im Folgenden mit owl: gekennzeichnet.

Schema.org

https://schema.org/
Die Initiative Schema.org geht auf große IT/Internet-Konzerne zurück. Die Initiative entwickelt auch die Spezifikation Microdata, die es erlaubt, Metadaten direkt in HTML-Dokumente einzubetten.

Elemente aus schema.org sind im Folgenden mit schema: gekennzeichnet.

Mapping der Daten

  • person -- gndo:DifferentiatedPerson
    Typ des Wurzelknotens, der Struktur, welche eine Person beschreibt
  • person.givenname, person.prefixname, person.familyname -- gndo:preferredName
    Die Elemente aus WIAG werden zu einer einzigen Zeichenkette zusammengefügt.
  • -- gndo:preferredNameEntityForThePerson
    Strukturknoten für Elemente des Namens einer Person
  • person.givenname -- gndo:forename
  • person.prefixname -- gndo:prefix
  • person.familyname -- gndo:surname
  • -- gndo:variantNameEntityForThePerson
    Strukturknoten für Elemente eines alternativen Namens einer Person
  • givenname_variant.name -- gndo:forname
  • familyname_variant.name -- gndo:surname
  • item.academic_title, item.notePerson -- gndo:biographicalOrHistoricalInformation
  • url_external.value -- gndo:gndIdentifier
    sofern url_external.authority_id auf die GND verweist
  • url_external.value -- foaf:page
    sofern url_external.authority_id auf Wikipedia verweist
  • url_external.value -- owl:sameAs
    sofern url_external.authority_id auf eine bestimme Auswahl von Institutionen verweist
  • -- schema:hasOccupation -- Strukturknoten für Amtsdaten
  • -- schema:Role
    Typ des Strukturknotens für Amtsdaten
  • role_name oder person_role.role_name -- schema:roleName
    Für normierte Amtsbezeichnungen wird role.name ausgegeben.
  • person_role.date_begin-- schema:startDate
  • person_role.date_end-- schema:endDate
  • -- schema:affiliation
    Strukturknoten für Angaben zu einem Domstift, Kloster oder Bistum
  • institution.name oder person_role.institution_name -- schmema:name
  • instituion.id_gsn -- schema:url
    URI in der Klosterdatenbank im Falle eines Domstiftes oder Klosters
  • item_corpus.id_public -- schmem:url
    URI in WIAG im Falle eines Bistums

To top