EZB-Pakete & Kollektionen

Link zur Schnittstelle: https://ezb-api.ur.de/collections

Titellisten von EZB-Kollektionen: https://ezb.ur.de/services/collections?title_split=0

(ohne Berücksichtigung der ZDB-Titelsplitregeln)

Abruf von EZB-Kollektionen:

1. Grundlegende Informationen zu EZB-Paketen und Kollektionen

1.1 Was sind EZB-Pakete?

In der EZB werden folgende Zeitschriftenpakete unterschieden:

Konsortialpakete, z.B. Bayern-Konsortium: Springer (EZBPaketID: BAYK1)
Allianz-Lizenzen, z.B. Allianz-Lizenz: Sage Journals Online (EZBPaketID: NALIW)
Nationallizenzen, z.B. Deutsche Nationallizenz: Oxford University Press (EZBPaketID: NALJZ)
Nationalkonsortien, z.B. Deutsches Nationalkonsortium: JSTOR (EZBPaketID: NALJE)
Aggregatorpakete, z.B. EBSCO Aggregator-Titel (EZBPaketID: EBSCO)
Verlagspakete, z.B. Taylor & Francis Pakete (EZBPaketID: TANDF)

Zeitschriftenpakete werden über die EZB-PaketID (entspricht der BIBID) identifiziert.

1.2 Was sind EZB-Kollektionen?

Zeitschriftenpakete enthalten jeweils mindestens ein Unterpaket – sogenannte (Paket)-Kollektionen – die einen bestimmten Ausschnitt eines Paketes darstellen. Kollektionen werden über die KollektionsID (entspricht dem Anker) definiert.

1.3 Wie können EZB-Paket- und Kollektionsdaten abgerufen werden?

Es werden derzeit verschiedene Schnittstellen entwickelt, um Informationen aus EZB-Paketen und Kollektionen automatisiert beziehen zu können. Aktuell stehen folgende Informationen zur Verfügung:

Abfrage der Metadaten von EZB-Kollektionen: https://ezb.ur.de/api/collections/KollektionsID
Abruf von Titellisten von EZB-Kollektionen: https://ezb.ur.de/services/collections?title_split=0
(der Paket- bzw. Kollektionsverwalter muss die Daten zuvor dafür freigeben)
Abruf von Titellisten von EZB-Kollektionen unter Berücksichtigung der ZDB-Titelsplitregeln: https://ezb.ur.de/services/collections?title_split=1
(der Paket- bzw. Kollektionsverwalter muss die Daten zuvor dafür freigeben)

1.4. Was sind ZDB-Titelsplitregeln?

Bei einer gravierenden Titeländerung einer Zeitschrift wird i.d.R. eine Neuaufnahme durchgeführt, die mit dem Vorgängertitel verknüpft wird. Es gelten nun verschiedene Regelungen, wie die Zuordnung des Lizenzzeitraums zur jeweiligen Titelaufnahme erfolgt. Bei der EZB wird der komplette Zeitraum, in der eine Zeitschrift lizenziert ist, der aktuellsten Titelaufnahme zugeordnet. Bei der ZDB wird der Lizenzzeitraum der jeweils geltenden Titelaufnahme zugeordnet. Dazu muss der Lizenzzeitraum zum Zeitpunkt der Titeländerung gesplittet und der entsprechenden Titelaufnahme zugewiesen werden. Das erfolgt automatisiert bei ‚EZB-Titellisten mit ZDB-Titelsplitregeln‘.

2. Die Collections-Schnittstelle

2.1 Was ist die Collections-Schnittstelle?

Die EZB enthält einige Arten verschiedener Kollektionen, z.B. aus Allianz- und Konsortiallizenzen oder frei zugänglich. In dieser Schnittstelle werden alle EZB-Kollektionen gelistet mit allen Informationen (z.B. IDs, Namen, Anchor…), die die EZB dazu hat.

2.2 Welche Formate können ausgegeben werden?

Die Ausgabe der angefragten Daten erfolgt über JSON.

2.3 Welche Informationen erhalte ich?

Die Ausgabe ist aufgeteilt in 10 Teile:

„collections_from_freely_available_journals“ (Freie Kollektionen),
„collection_with_subscription_journals“ (Abonnement-Zeitschriften),
„collections_from_national_license_packages“ (Nationallizenzen),
„collections_from_alliance_license_packages“ (Allianzlizenzen),
„collections_from_consortia_packages“ (Konsortiallizenzen),
„collections_from_national_consortia_packages“ (Nationalkonsortien),
„collections_from_publisher_packages“ (Verlagspakete),
„collections_from_transformative_agreements“ (Transformationsverträge),
„collections_from_aggregator_packages“ (Aggregatorpakete),
„collections_no_longer_available“ (nicht mehr verfügbare Kollektionen).

Darunter sind jeweils die Kollektionen mit folgenden Datenfelder gelistet:

Feld	Feldbeschreibung
ezb_collection_id	EZB-Kollektions-ID
ezb_collection_shortname	Kurzname der Kollektion
ezb_collection_name	Name der Kollektion
ezb_collection_source	Quelle der Infos zur Kollektion
ezb_collection_provider	Anbieter der Kollektion
ezb_collection_platform	Plattform, auf der die Kollektion zugänglich ist
ezb_collection_curatory_group	Zuständige Organisation für die Datenpflege
ezb_owner	Besitzer bzw. Verwalter der Kollektion, z.B. Konsortium, das die Lizenz verhandelt
ezb_collection_titlelist	Link zu einer Liste mit den Inhalten der Kollektion
ezb_package_id	ID des EZB-Pakets, zu dem die Kollektion gehört
ezb_package_name	Name des EZB-Pakets, zu dem die Kollektion gehört
ezb_package_type	Typ (ID) des EZB-Pakets, zu dem die Kollektion gehört
ezb_package_type_name	Typ (Name) des EZB-Pakets, zu dem die Kollektion gehört
ezb_collection_anchor	EZB-Anchor der Kollektion
esac_id	ESAC-ID
oa_transformative	Ist Teil eines Transformationsvertrags
zdb_product_id	ZDB-Produktsigel der Kollektion
national_licenses_cms_id	ggf. ID der Lizenz im Nationallizenz-CMS
collection_manager_name	Name der zuständigen Stelle für die Kollektion
collection_manager_email	E-Mail der zuständigen Stelle für die Kollektion
ezb_collection_released_date	Zeitpunkt der Veröffentlichung der Kollektion
ezb_collection_metadata_changed_date	Zeitpunkt der letzten Änderung an den Metadaten der Kollektion
ezb_collection_deactived_date	Nur bei nicht mehr verfügbaren Kollektionen: Zeitpunkt der Deaktivierung

2.4. An wen kann ich mich wenden, wenn ich Anmerkungen habe oder Fehler auftreten?

Es gibt eine Mailingliste, die sich an alle EZB-Datenbezieher richtet. Hier erhalten Sie servicespezifische Informationen vom EZB-Team. Zudem haben Sie die Möglichkeit, sich mit weiteren EZB-Datenbeziehern über Fragen bei der Anwendung auszutauschen, eigene Ideen einzubringen und neue Ansätze zu diskutieren.

Link zur Anmeldung: https://www.listserv.dfn.de/sympa/info/ur-ub-ezb-dbis-data

Für den Fall, dass Sie einen Fehler beobachtet haben, senden Sie bitte eine E-Mail an: info.ezb@ur.de