Migration MIR LTS 2022.06 nach 2023.06

Migrationsanleitung MIR

Hier sind weitere Schritte zur MIR-Migration gelistet, die neben der Migrationsanleitung für MyCoRe noch relevant sind.

Migration von mods:originInfo/mods:publisher-Elementen nach Crossref-Import

Während des Crossref-Imports wird das Stylesheet crossref2mods.xsl verwendet, um Crossref-Metadaten in MODS zu transformieren. Problematisch sind Publisher-Information (mods:originInfo/mods:publisher). Hier fehlt das eventType-Attribut. Dadurch ist das resultierende MODS nicht kompatibel mit dem Editor und kann nicht bearbeitet werden.

Alle Elemente, die über Crossref importiert wurden sollten daher jedenfalls mit dem Stylesheet mycoreobject-migrate-origininfo.xsl migriert werden. Allgemein bietet sich hierfür der select-Befehl für alle fehlerhaften Objekte an:

select objects with xpath /mycoreobject//mods:originInfo[not(@eventType)]
list selected

execute for selected xslt {x} with file mycoreobject-migrate-origininfo.xsl

Änderung der Behandlung von mods:displayForm bei Konferenzen

Im Editor gab es für Konferenzen (mods:name[@type='conference']) ein Preprocessing für das mods:displayForm-Element. War kein mods:displayForm-Element gesetzt, wurde es automatisch aus dem mods:namePart abgeleitet. Existierte bereits ein mods:displayForm-Element, wurde kein neues erzeugt oder überschrieben. Dieses Verhalten führte dazu, dass spätere Updates am mods:namePart keine Auswirkung mehr auf das mods:displayForm-Element hatten und die Ausgabe dadurch inkonsistent war.

Das Preprocessing wurde mit MIR-1522 entfernt. Das mods:displayForm-Element soll für Konferenzen künftig grundsätzlich nicht mehr verwendet werden. Aus diesem Grund müssen alle bestehenden mods:displayForm-Elemente für Konferenzen entfernt werden. Hierfür steht das Stylesheet mycoreobject-migrate-name-displayform zur Migration zur Verfügung. Generell bietet sich der select-Befehl an für die Bestimmung aller fehlerhaften Objekte und eine anschließende Migration:

select objects with xpath /mycoreobject//mods:name[@type='conference']/mods:displayForm
execute for selected xslt {x} with file mycoreobject-migrate-name-displayform.xsl

Verschiebung der "Saxon ready"-Stylesheets nach xslt/

Mit MCR-2966 wurden die XSLT3-fähigen ("Saxon ready") Stylesheets aus dem Verzeichnis xsl/ nach xslt/ verschoben. Für die meisten Stylesheets ist das unkritisch, da die zugehörigen Properties in der MIR-mycore.properties mitgepflegt wurden und beim Update automatisch übernommen werden.

Problematisch ist das Stylesheet für den DeepGreen-JATS-Import (sword/jats2mods.xsl). Die zugehörige Property ist in der MIR-mycore.properties nur auskommentiert enthalten:

# MCR.ContentTransformer.deepgreenjats2mods.Stylesheet=xslt/sword/jats2mods.xsl

Betroffene Anwendungen (mit aktiviertem DeepGreen-/SWORD-Import) müssen den Pfad in ihrer eigenen mycore.properties daher manuell anpassen:

MCR.ContentTransformer.deepgreenjats2mods.Stylesheet=xslt/sword/jats2mods.xsl

Zugriffsrechte für gesperrte und gelöschte Objekte ergänzen

Mit MIR-1613 wurde behoben, dass die Dateien von Objekten im Zustand blocked (gesperrt) oder deleted (gelöscht) über das MCRFileNodeServlet auch an nicht angemeldete bzw. unprivilegierte Nutzer ausgeliefert wurden – selbst dann, wenn auf der Metadatenseite die Hinweise „Das Dokument ist gesperrt!“ bzw. „Das Dokument wurde gelöscht!“ angezeigt wurden. Die Zugriffsstrategie berücksichtigte bislang nur die Klassifikation mir_access, nicht aber den Objektzustand.

Die zugehörige Property-Anpassung wird durch das Update automatisch übernommen, sofern sie nicht in der eigenen mycore.properties überschrieben wurde. Anwendungen, die diese Property selbst gesetzt haben, müssen den Zustand state ergänzen:

MIR.Access.Strategy.Classifications=state,mir_access

Die neuen Zugriffsrechte liegen pro Installation in der Datenbank und werden durch das Update nicht automatisch angelegt. Sie müssen daher in bestehenden Installationen manuell ergänzt werden. Am einfachsten geschieht dies über die Oberfläche der Rechteverwaltung (ACL-Editor) im Administrationsbereich. Dort sind folgende Zugriffsdefinitionen anzulegen:

• derivate:state:blocked – Berechtigungen read und view, Regel grant-editors („administrators and editors“)
• derivate:state:deleted – Berechtigungen read und view, Regel grant-editors („administrators and editors“)
• derivate:mir_access:unlimited – zusätzlich die Berechtigung view, Regel grant-all („always allowed“)

Alternativ können die Rechte über die Kommandozeile mit dem Werkzeug mir-cli gesetzt werden. Der Platzhalter {mir-cli} in den folgenden Kommandos ist dabei durch das Installationsverzeichnis von mir-cli zu ersetzen (das Verzeichnis, in dem die Regeldateien unter config/acl/ liegen):

update permission view for id derivate:mir_access:unlimited with rulefile {mir-cli}/config/acl/grant-all.xml described by always allowed
update permission read for id derivate:state:blocked with rulefile {mir-cli}/config/acl/grant-editors.xml described by administrators and editors
update permission view for id derivate:state:blocked with rulefile {mir-cli}/config/acl/grant-editors.xml described by administrators and editors
update permission read for id derivate:state:deleted with rulefile {mir-cli}/config/acl/grant-editors.xml described by administrators and editors
update permission view for id derivate:state:deleted with rulefile {mir-cli}/config/acl/grant-editors.xml described by administrators and editors