Datenmodell

Diese Seite erklärt, welche Datensätze Librario führt, wie sie zusammenhängen und unter welchen Namen sie in der Oberfläche, im KI-Assistenten (MCP) und in der REST-API v3 erscheinen. Sie hilft Bibliotheksteams, Integrator:innen und KI-Assistenten, ähnlich klingende Begriffe auseinanderzuhalten: eine Publikation ist kein PDF, und eine interne ID ist keine ISBN.

Publikation, Datei, Leihexemplar und Leihvorgang

Im Mittelpunkt steht die Publikation. Alles andere hängt an ihr:

Publikation
├── Publikationstyp (genau einer, z. B. Buch, Artikel, Norm)
├── Beitragende: Autor:innen und Herausgeber:innen (beliebig viele, geordnet)
├── Organisation (höchstens eine)
├── Kennungen (beliebig viele)
├── Kategorien (beliebig viele)
├── übergeordnete Publikation (höchstens eine)
├── Dateien (beliebig viele)
└── Leihexemplare (beliebig viele)
    └── Leihvorgänge (beliebig viele, höchstens einer offen)

• Publikation – der bibliografische Datensatz eines Werks: Titel, Beitragende, Veröffentlichungsdatum, Kennungen, Schlagwörter und Kategorien. Eine Publikation existiert auch ohne Datei und ohne Leihexemplar. Der Publikationstyp bestimmt, welche Zusatzfelder es gibt, etwa Status und Nachfolger bei Normen.
• Datei – eine hochgeladene Datei, meist ein PDF. Jede Datei gehört zu genau einer Publikation. Die Volltextsuche liest den Text aller Dateien einer Publikation mit.
• Leihexemplar – ein physisches Exemplar im Regal, beschrieben durch Standort und Signatur. Jedes Leihexemplar gehört zu genau einer Publikation, eine Publikation hat kein, ein oder mehrere Leihexemplare. Ein Präsenzexemplar ist nicht ausleihbar.
• Leihvorgang (Ausleihe) – verbindet ein Leihexemplar mit der entleihenden Person, dem Ausleihdatum und später dem Rückgabedatum. Ein Leihexemplar hat höchstens einen offenen Leihvorgang. Abgeschlossene Leihvorgänge bleiben als Verlauf erhalten.
• Leihanfrage – eine Aufgabe, mit der eine Person eine Publikation anfordert oder vormerkt. Sie gilt der Publikation, nicht einem bestimmten Leihexemplar, und ist noch kein Leihvorgang. Erst wenn ein Exemplar tatsächlich an die anfragende Person ausgeliehen wird, ist das Leihexemplar an die Leihanfrage gebunden (hard_copy_id ist gesetzt). Dann entsteht der Leihvorgang, und die Leihanfrage für diese Publikation wird erledigt.

Daraus folgt: „Es gibt ein PDF“, „es gibt ein Leihexemplar“ und „das Leihexemplar ist verfügbar“ sind drei verschiedene Aussagen. Wie Ausleihen ablaufen, beschreibt Leihexemplare ausleihen.

Beitragende und Organisationen

Personen und Organisationen sind eigene Datensätze, die sich alle Publikationen eines Kontos teilen. Ein Name kommt im Konto nur einmal vor. Dieselbe Person kann bei einer Publikation Autor:in und bei einer anderen Herausgeber:in sein. Die Reihenfolge der Autor:innen und Herausgeber:innen bleibt so erhalten, wie sie erfasst wurde.

• Autor:innen und Herausgeber:innen – Personen, zusammengefasst als Beitragende. Ein Personendatensatz kann GND, VIAF, ORCID und Namensvarianten tragen.
• Organisation – höchstens eine pro Publikation, zum Beispiel das herausgebende Institut, die Behörde oder das Normungsgremium.

Kennungen

Librario unterscheidet drei Arten von Kennungen. Verwechseln Sie sie nicht, denn nur die dritte ist außerhalb von Librario aussagekräftig.

1. Interne Publikations-ID: eine Zahl, die Librario jeder Publikation vergibt, zum Beispiel 42. Sie steht in der Adresse der Publikationsseite (/publications/42) und ist der Schlüssel für alle Abfragen über MCP und REST-API. Sie ist keine bibliografische Angabe: Zitieren Sie sie nicht und suchen Sie sie nicht in externen Katalogen.
2. Datei-ID: eine UUID, die jede Datei bekommt. Sie adressiert genau eine Datei, nie die Publikation. Ein KI-Assistent braucht sie, um eine Datei herunterzuladen.
3. Bibliografische Kennungen: Werte, die das Werk auch außerhalb von Librario bezeichnen:
   • ISBN, ISSN, DOI, PubMed ID (PMID) und arXiv-ID als typisierte Felder. Eine Publikation kann mehrere Werte desselben Typs haben, etwa die ISBN der gedruckten und der digitalen Ausgabe.
   • Das Feld „Kennung“ für alles andere: Normbezeichnungen wie DIN EN 1992-1-1:2011-01, Patentnummern oder hausinterne Nummern. Auch davon sind mehrere Werte möglich.

Bei Normen verweisen „Vorgänger“ und „Nachfolger“ auf Normbezeichnungen, nicht auf interne IDs. Librario verknüpft sie mit anderen Normen im Bestand, deren Kennung genau übereinstimmt. Der Status „Aktiv“ oder „Zurückgezogen“ gibt wieder, was Ihr Bibliotheksteam erfasst hat. Er ist keine Prüfung, ob die Norm heute anzuwenden ist.

Dieselben Daten in Oberfläche, MCP und REST-API v3

Die drei Zugänge zeigen dieselben Datensätze, aber nicht unter denselben Namen und nicht immer vollständig. MCP ist auf Lesen und Zitieren zugeschnitten, die REST-API auf Abgleich und Pflege.

Zum Veröffentlichungsdatum: Librario speichert es im Format EDTF Level 0 (JJJJ, JJJJ-MM oder JJJJ-MM-TT) in der Genauigkeit, in der es erfasst wurde, also nur das Jahr, Jahr und Monat oder ein volles Datum. MCP und REST-API geben diesen Text in published_on unverändert zurück. Fehlt der Monat oder Tag, wurde er nicht erfasst. In MCP ist year nur ein Suchfilter, kein Ergebnisfeld.

Kategorien, Sammlungen, Favoriten und Aufgaben

Diese vier Begriffe ordnen Publikationen, unterscheiden sich aber darin, wem sie gehören und wer sie sieht.

• Kategorie – ein thematisches Schlagwort für das ganze Konto, zum Beispiel „Brandschutz“. Eine Publikation kann mehrere Kategorien haben. Kategorien dienen vor allem als Suchfilter. MCP liefert sie als Liste von Namen (categories), die REST-API als Objekte mit id, uuid und name.
• Sammlung – eine benannte, kuratierte Liste mit Beschreibung, etwa der Handapparat eines Fachbereichs. Eine Publikation kann in mehreren Sammlungen liegen. Alle angemeldeten Benutzer:innen des Kontos sehen und lesen alle Sammlungen. Das ist die Rolle Betrachter:in, die das Formular für die Sichtbarkeit anzeigt. Pflegen dürfen die Eigentümer:innen und Bearbeiter:innen der Sammlung sowie Administrator:innen und Bibliothekar:innen. MCP liest Sammlungen: list_collections findet sie, get_collection zeigt eine, und search_library mit einer collection_id listet ihre Publikationen. Ändern kann MCP sie nicht. Die REST-API bietet /api/v3/collections und den Filter collection_id. Mehr dazu unter Sammlungen verwalten.
• Favorit – eine persönliche Markierung mit dem Stern. Jede Person hat ihre eigene Liste, die andere im Benutzerprofil einsehen können. MCP und REST-API filtern mit starred_by (me oder eine Benutzer-ID). Mehr dazu unter Favoriten verwalten.
• Aufgabe – ein Arbeitsauftrag für das Bibliotheksteam mit Typ, Status, Priorität und optional einer zuständigen Person. Beispiele sind Leihanfragen, Qualitätsprüfungen und Dublettenprüfungen. Eine Aufgabe kann auf eine Publikation, eine Person oder Organisation, eine Datei oder einen Import verweisen. MCP kennt keine Aufgaben. Die REST-API bietet /api/v3/tasks mit type und reference. Mehr dazu unter Aufgabenverwaltung.

Gruppierung: Buchreihe, übergeordnete Publikation und Originaltitel

Drei Felder fassen zusammengehörige Publikationen zusammen. Nur eines davon ist eine echte Verknüpfung zwischen zwei Datensätzen.

• Titel der Buchreihe (series) – freier Text. Publikationen mit gleichem Reihentitel gehören zur selben Reihe, ein eigener Reihen-Datensatz existiert nicht.
• Übergeordnete Publikation (parent_publication) – ein Verweis auf eine andere Publikation, etwa vom Band auf das mehrbändige Gesamtwerk. Eine Publikation hat höchstens eine übergeordnete Publikation, kann aber selbst beliebig viele untergeordnete haben.
• Originaltitel (uniform_title, im Bibliothekswesen Einheitssachtitel) – freier Text, der Auflagen und Übersetzungen desselben Werks zusammenführt.

get_publication gibt keines der drei Felder aus. Wann welches Feld passt, erklärt der Leitfaden Publikationen gruppieren. Alle Felder mit Format und Beispiel stehen in der Feldreferenz.