--- type: Documentation title: Datenmodell description: Welche Datensätze Librario führt, wie sie zusammenhängen und unter welchen Namen Kennungen und Veröffentlichungsdatum in Oberfläche, KI-Assistent (MCP) und REST-API v3 erscheinen. resource: https://www.librario.de/de/docs/grundlagen/datenmodell language: de revision: e114aa541d24c57e452957a2313c85d2014b716b tags: - docs - grundlagen --- # 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: ```text 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](/de/docs/bibliothekswesen/publikationstypen) 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](/de/docs/grundlagen/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. | Angabe | Oberfläche | MCP | REST-API v3 | | ------------------------------- | ------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------- | | Interne Publikations-ID | Adresse der Publikationsseite: `/publications/42` | `publication_id`; dazu `web_url`, in `search_library` auch `resource_uri` (`librario://publications/42`) | `id` | | Datei-ID | kein eigenes Feld | `files[].file_id` aus `get_publication`, Eingabe für `download_file` | `assets[].id` in `GET /api/v3/publications/{id}`; einzeln unter `/api/v3/assets/{id}` | | ISBN, ISSN, DOI, PMID, arXiv-ID | Felder „ISBN“, „ISSN“, „DOI“, „PubMed ID (PMID)“, „arXiv-ID“ | `identifiers.isbn`, `.issn`, `.doi`, `.pmid`, `.arxiv_id`: je nur der erste Wert | `identifiers[]` mit `type` (`isbn`, `issn`, `doi`, `pmid`, `arxiv_id`) und `value`: alle Werte | | Weitere Kennungen | Feld „Kennung“ | `identifiers.generic[]`: alle Werte | `identifiers[]` mit `type: generic` | | Leihexemplar | Standort, Signatur, Präsenzexemplar, Verfügbarkeit | `hard_copies[]` mit `location`, `shelfmark`, `reference_book`, `borrowing_status` (`available`, `borrowed`); keine ID. `available` heißt nur: nicht verliehen. `reference_book: true` kennzeichnet ein Präsenzexemplar, das nur vor Ort gelesen und nicht ausgeliehen werden kann | `/api/v3/hard_copies`: `id`, `uuid`, `location`, `shelfmark`, `reference_book` | | Veröffentlichungsdatum | Feld „Veröffentlichungsdatum“: `JJJJ`, `JJJJ-MM` oder `JJJJ-MM-TT` | `published_on` als Text, so wie erfasst (`2021`, `2021-06` oder `2021-06-15`); Filter `year` als Jahr, Bereich (`1985-2010`) oder Jahrzehnt (`1970s`) | `published_on` als Text, so wie erfasst (`2021`, `2021-06` oder `2021-06-15`) | 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](/de/docs/grundlagen/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](/de/docs/grundlagen/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](/de/docs/bibliothekswesen/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. | Feld | MCP | REST-API v3 | | ------------------------- | ---------------------------------------------------------------------------- | -------------------------------------------------------------------- | | Titel der Buchreihe | `series` in `search_library`-Treffern; Filter `series` | `series`; Filter `series` | | Übergeordnete Publikation | Filter `parent_publication_id` | `parent_publication` als eingebettete Publikation; Filter `parent_publication_id` | | Originaltitel | Filter `uniform_title` (genaue Übereinstimmung) | `uniform_title` in der Antwort und beim Anlegen und Ändern; Filter `uniform_title` | `get_publication` gibt keines der drei Felder aus. Wann welches Feld passt, erklärt der Leitfaden [Publikationen gruppieren](/de/docs/bibliothekswesen/best-practices/publikationen-gruppieren). Alle Felder mit Format und Beispiel stehen in der [Feldreferenz](/de/docs/bibliothekswesen/felder-referenz).