MyCoRe Logo
Deutsch English
2025.12

Migration MIR LTS 2025.06 nach 2025.12

Listet die einzelnen Schritte zur Migration von MIR LTS 2025.06 nach 2025.12 auf.

Diese Seite ist Work in Progress.
Sie wird im Rahmen der Fertigstellung des aktuellen MIR-Releases weiter ergänzt!

Migrationsanleitung MIR

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

Aktualisierung des Solr-Schemas und nachfolgende Neuindizierung der Metadaten

Damit ggf. vorhandende Abstracts in der aktuellen Sprache automatisch angezeigt werden können, müssen die folgenden CLI-Kommandos einmal ausgeführt werden.

  • reload solr configuration main in core main
  • rebuild solr metadata index in core main

HTML-Validierung

Mit 2024.06 wurden der XEditor fĂĽr die Eingabe von formatierten Texten von CKEditor auf TinyMCE umgestellt. Seit dem gibt es zwei Properties zur Konfiguration der hierbei erlaubten HTML-Elemente.

  • FĂĽr die clientseitige Validierung in TinyMCE wird das Property MIR.WebConfig.Editor.TinyMCE.ValidElements verwendet. Hierbei wird, der Spezifikation von TinyMCE folgend, die Liste der erlaubten Elemente mit Kommas getrennt.
  • FĂĽr die serverseitigen Validierung in MIREditorUtils wird das Property MIR.Editor.HTML.Elements verwendet. Hierbei wird, der Spezifikation von CKEditor folgend, die Liste der erlaubten Elemente mit Semikolons getrennt.

Mit diesem Release von MIR wird das vereinheitlicht. Durch MIR-1495 muss ab sofort nur noch das Property MIR.Editor.HTML.AllowedElements gepflegt werden. Hierbei wird der TinyMCE-Spezifikation folgend die Liste der erlaubten Elemente mit Kommas getrennt. Jedem Element-Namen kann in eckigen Klammern eine durch Senkrechtstriche getrennte Liste von erlaubten Attributen angehängt werden.

Beispiel: a[href],b,i,div[style|class],span[style|class]

TinyMCE erlaubt die Konfiguration weiterer Details. Dieser werden von der serverseitigen Implementierung in MIR jedoch nicht unterstützt. Es muss sich auf die hier beschriebenen Möglichkeiten beschränkt werden.

Standardmäßig wir das Property MIR.Editor.HTML.AllowedElements aus den beiden Properties %MIR.Editor.HTML.HTMLElements und MIR.Editor.HTML.MathMLElements zusammengesetzt. In einer eigenen Anwendung können je nach Bedarf entweder die Gesamtliste oder die beiden Teillisten angepasst werden.

Für die clientseitige Validierung wird die in MIR.Editor.HTML.AllowedElements konfigurierte Liste in das Property MIR.WebConfig.Editor.TinyMCE.AllowedElements übernommen und clientseitig dem XEditor zur Verfügung gestellt. Dieses Property sollte nicht direkt verändert werden.

Wer bisher eines der alten Properties angepasst hat, muss es in seiner Anwendung auf das neue umstellen.

TinyMCE verwendet die Liste der erlaubten HTML-Elemente ausschließlich zum Validieren der Eingabe. Buttons und Menü-Einträge für verschiedene Formatierungen werden nicht automatisch ausgeblendet, wenn entsprechende Elemente nicht erlaubt sind. Gegebenenfalls muss die Konfiguration des TinyMCE den eigenen Bedarfen entsprechend angepasst werden. Hierzu kann die von MIR unter /assets/tinymce/config.js ausgelieferte Datei als Ausgangsbasis genommen werden. Sie kann in einem eigenen Anwendungsmodul als Web-Ressource unter demselben Web-Pfad bereitgestellt werden.

Migration der OpenAIRE-Projekte

Bisher konnten ausschlieĂźlich OpenAIRE-Projekte erfasst werden. Die grundlegenden Informationen wurden dabei in einem mods:identifier wie folgt kodiert: 

1
2
3

<mods:identifier type="open-aire">
  info:eu-repo/grantAgreement/EC/H2020/862695/EU/Towards climate-smart sustainable management of agricultural soils/EJP SOIL
</mods:identifier>

Mit der Umsetzung von MIR-1451 ist es nun möglich, allgemein Projekt- und Förderinformationen zu erfassen. Dabei werden die Projekt- und Förderinformationen mittels mods:extension über die fundingReferences des DataCite-Metadaten-Schemas erfasst. Bezogen auf das obige Beispiel sieht die neue Darstellung folgendermaßen aus: 

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12

<mods:extension type="datacite-funding">
  <resource xsi:schemaLocation="http://datacite.org/schema/kernel-4 http://schema.datacite.org/meta/kernel-4.3/metadata.xsd">
    <fundingReferences>
      <fundingReference>
        <funderName>European Commission</funderName>
        <funderIdentifier funderIdentifierType="Crossref Funder ID">https://doi.org/10.13039/501100000780</funderIdentifier>
        <awardNumber awardURI="https://cordis.europa.eu/project/id/862695">862695</awardNumber>
        <awardTitle>Towards climate-smart sustainable management of agricultural soils</awardTitle>
      </fundingReference>
    </fundingReferences>
  </resource>
</mods:extension>

Daher ist es erforderlich, alle bisherigen OpenAIRE-Identifier zu migrieren. Für diesen Zweck steht der Transformer migrate-openaire zur Verfügung. Die betroffenen Objekte können wir folgt selected werden und anschließend migriert werden: 

select objects with xpath /mycoreobject//mods:identifier[@type='open-aire']
execute for selected transform object {x} with transformer migrate-open-aire

Der Transformer/Migration setzt voraus, dass die bisherigen OpenAIRE-Identifier korrekt genutzt wurden und sich auf die European Commission beziehen. Wurde das Feld anderweitig verwendet, sollte die Migration manuell erfolgen.

AuĂźerdem ist das OAI2-Set ec_fundedresources damit obsolet und sollte aus MCR.OAIDataProvider.OAI2.Sets entfernt werden.

- 20.06.2025