Unterschiede eSciDoc-INGe

Diese Seite beinhaltet Informationen darüber, welche Änderungen sich für die Nutzer mit der Ablösung von eSciDoc durch INGe ergeben. Die Liste wird vom MPDL-Team nach und nach ergänzt und vervollständigt werden.

Allgemein

 * HTTPS über die gesamte Applikation (auch für CoNE)
 * Veränderte URLs (Re-direct)
 * eSciDoc-IDs werden ersetzt (s.u., im Abschnitt XML)

Einbindung von Publikationen auf den Webseiten
Als neues Standard-Export-Format wird JSON zur Verfügung stehen. Dieses stellt aus unserer Sicht die einfachste Möglichkeit dar und wird daher für alle künftig erstellten Anbindungen von uns empfohlen. Aber um die Umstellung für Sie so einfach wie möglich zu machen, werden wir das eSciDoc-Format, bis auf sehr kleine Änderungen (siehe XML), weiterhin auch zur Verfügung stellen. Hinweis: Es ist möglich, dass sich im Hinblick auf die hier angesprochenen Punkte in den kommenden Wochen noch sehr kleine Ergänzungen oder Anpassungen im Detail ergeben. Sollte das passieren, werden wir die Punkte ensprechend kenntlich machen und per Mail darauf hinweisen.

REST
REST-Anfragen sind nicht mehr als Lesezeichen (URL) speicherbar, da es kein GET-Request mehr ist, sondern ein POST-Request. Dies ist nötig aufgrund der sehr umfangreichen Suchanfragen. Es wird auch künftig eine Größenbeschränkung für einzelne Abrufe geben (vermutlich 5000). Eventuell wird es ratsam sein, kleinere Schritte (1000) zu wählen, um die Performance zu verbessern. Zum Anschauen (Hier handelt es sich um unsere interne Test-Umgebung, die hin und wieder nicht erreichbar sein könnte. Sie stellt einen vorläufigen Stand dar, bei dem sich kleine Dinge durchaus noch ändern können. Diese Umgebung eignet sich für Sie noch nicht zum realistischen Testing! Zu diesem Zweck werden wir zu einem späteren Zeitpunkt eine entsprechende Instanz auf dem QA-Server bereitstellen.):
 * Schnittstelle (Test-Server): https://dev.inge.mpdl.mpg.de/rest/items
 * Übersicht (für Items): https://dev.inge.mpdl.mpg.de/rest/swagger-ui.html#/item-rest-controller - (Examples sind noch nicht korrekt)

XML
Hinweis: Bisher waren 2 eSciDoc-Formate für PuRe im Umlauf. Das hat jedoch nur diejenigen betroffen, welche sowohl die "Suchen und Exportieren"-Schnittstelle (REST) von PuRe direkt, als auch die eSciDoc-Coreservice-Schnittstelle genutzt hatten. Da der direkte Zugriff seit geraumer Zeit nur noch für einen sehr eingeschränkten Nutzerkreis möglich war, werden wir nur die "Suchen und Exportieren"-Schnittstelle mit der neuen INGe-Schnittstelle vergleichen. Hier jedoch ein Beispiel für den unterschied der beiden "alten" Formate:

Außerdem werden wir uns folgend nur auf das  und nicht den Wrapper darum beziehen.

[|Ein direkter DIFF beider XMLs] (links: alt/eSciDoc; rechts: neu/INGe)

An allen Stellen, an denen entweder "objid" oder "href" stand, ist in der INGe Repräsentation beides zu finden. Außerdem werden neue IDs für INGe eingeführt, welche die bisherigen eSciDoc-IDs ersetzen. Der hintere Teil der bestehenden IDs (nach "escidoc:") bleibt dabei bestehen. Die IDs sind typisiert und starten je nach Typ mit:


 * ctx_ - für Kontexte
 * file_ - für Dateien
 * item_ - für Publikationen
 * ou_ - für Organistation
 * user_ - für Personen

Für Dateien und externe Referenzen gültig: (betrifft alle Typen)

Für externe Referenzen fallen folgende Ausgaben in INGe weg, da Sie für externe Referenzen eh nicht bekannt waren und nur standardmäßig befüllt waren.

Suche
Basiert komplett auf elasticsearch, wodurch sich einige grundlegende Änderungen ergeben.


 * Neue Anfragesprache

Workflow

 * Neue Version für eine Publikation werden nur noch nach der (erneuten) Freigabe der Publikation erzeugt.

Export

 * JSON als internes Format, ist auch im Export verfügbar. Dies ist die schnellste Option für Exporte, da keine Transfomrationen nötig sind. Zudem ist es die einzige völlig verlustfreie Option, Daten zu exportieren.
 * REST-Anfragen sind nicht mehr als Lesezeichen speicherbar, da es kein GET-Request mehr ist, sondern ein POST-Request. Dies ist nötig aufgrund der sehr umfangreichen Suchanfragen.

Verschiedenes

 * "Revision of" fällt weg
 * Statistiken beziehen sich nur noch auf eindeutige Besuche