Release Notes FirstSpirit™ 2022.8

Release Notes

FirstSpirit™ 2022.8

1 Administration

1.1 Aktualisierung von integrierter Fremdsoftware

Mit dem aktuellen Release wurde folgende intern verwendete Software aktualisiert:

  • Spring Boot
    Aktualisierung auf Version 2.7.0
  • ASM (Bibliothek für die Analyse und Modifikation von Java-Bytecode)
    Aktualisierung auf Version 9.3

1.2 Ankündigung: Java 11, 17 und Jakarta

Seit dem Release 2022.3 ist Java 17 offiziell für die Verwendung mit FirstSpirit freigegeben. Als Referenz gilt aktuell weiterhin Java 11.
Herstellerseitig ist Java 17 die aktuelle LTS (Long-Term-Support)-Version, der Support für Java 11 endet planmäßig im September 2023.

Generell unterstützt FirstSpirit nur die letzte LTS-Version von OpenJDK und Oracle Java sowie die jeweils aktuell freigegebene Version von OpenJDK. Darüber hinaus werden einige von FirstSpirit verwendete Drittsoftware-Komponenten zum Ende des Jahres 2022 nicht mehr mit Java 11 lauffähig sein (z. B. Spring Boot 3.0, Jakarta / Java EE). FirstSpirit wird dann nur noch mit Java 17 lauffähig sein.

Falls noch nicht geschehen, empfiehlt e-Spirit Kunden und Partnern aufgrund dessen einen frühzeitigen Wechsel auf Java 17. Aktuell sind keine Probleme bei der Verwendung von Java 17 mit FirstSpirit bekannt. Java 17 sollte jedoch zunächst auf Testsystemen eingesetzt und potenzielle Probleme zeitnah an e-Spirit gemeldet werden.

Es ist geplant, den Support für eine Verwendung von Java 11 mit FirstSpirit zum Ende des Jahres 2022 abzukündigen und Java 17 als Referenz-Version auszuweisen.

Darüber hinaus ist zu einem späteren Zeitpunkt geplant, von Java EE auf Jakarta EE zu wechseln, da einige von FirstSpirit verwendete Drittsoftware-Komponenten in deren zukünftigen Version nicht mehr mit Java EE lauffähig sein werden (z. B. Spring Boot 3.0, Tomcat 10). Dies wird erst relevant, sobald FirstSpirit auf diese neueren Versionen umgestellt wird. Durch diesen Wechsel wird sich der Namensraum (Package) für alle implementierten APIs von javax.* zu jakarta.* ändern, z. B. würde javax.servlet.Servlet zu jakarta.servlet.Servlet. Dies bedeutet auch eine Umstellung von kundenspezifischen Modulen, ist aber unabhängig von der o.g. Umstellung auf Java 17. Derzeit ist hier keine Aktion nötig, ein Migrationspfad wird rechtzeitig kommuniziert.

1.3 Interface UrlFactory: Neuer Parameter "readOnlyRegistry"

Alle Klassen, die das Interface UrlFactory implementieren, können jetzt mit einem weiteren Parameter konfiguriert werden:

Der neue Parameter

readOnlyRegistry

ermöglicht die rein lesende Nutzung der in der Registry gespeicherten URLs. Neue URLs werden nach dem Setzen dieses Parameters nicht gespeichert und gelöschte URLs nicht entfernt.
Auf diese Weise kann geprüft werden, ob eine URL bereits in der Registry vorhanden ist, um diese dann zu verwenden. Neue URLs werden dieser nicht hinzugefügt. Der Parameter kann somit beispielsweise für Generierungen genutzt werden, die keine permanenten URLs erzeugen sollen (z. B. Generierungen des aktuellen Stands auf einen Testserver).

Um den Read-only-Modus zu aktivieren, muss der Wert true übergeben werden.
Beispiel:

factorySettings = new HashMap();
factorySettings.put("readOnlyRegistry","true");
factorySettings.put("useWelcomeFileNames","true");
factorySettings.put("stripWelcomeFileNames","true");
context.setProperty("#urlCreatorSettings", factorySettings);

Der Parameter readOnlyRegistry überschreibt die Parameter useRegistry und removeDeleted (Wert: false), falls sie gesetzt sind.

2 ContentCreator

Absatzreferenzen erstellen

Absatzreferenzen können in FirstSpirit verwendet werden, um Inhalte komfortabel über mehrere Seiten hinweg wiederzuverwenden.
Anders als bei einer Kopie wirken sich Änderungen an Absatzreferenzen (bzw. am so genannten „Quellabsatz“) an allen referenzierten Absätzen gleichzeitig aus.

Bisher konnten Absatzreferenzen nur per FirstSpirit SiteArchitect erzeugt werden.
Mit dem aktuellen Release können jetzt auch im FirstSpirit ContentCreator Absatzreferenzen erstellt werden.

Die Aktion steht in der Navigation und in der Vorschau zur Verfügung und zwar auf Kopiervorlagen im Dialog „Neuer Absatz“

UID=contentcreator_absatzreferenz_anlegen_vorschau

Zu weiteren Informationen siehe auch https://docs.e-spirit.com/contentcreator/vorschauseite-b/absaetze/index.html.

Das Icon kann per „Tailored UI“ ausgeblendet werden.
Zu weiteren Informationen zur „Tailored UI“ siehe auch https://docs.e-spirit.com/odfs/vorlagenentwick/contentcreator/customization/standardfunktio/index.html.

3 FirstSpirit Content Experience Tools (CXT)

Aktuelle Modul-Versionen

Folgende Modul-Versionen für „FirstSpirit Content Experience Tools“ werden von FirstSpirit 2022.8 unterstützt.

Modul- / DateinameVersionsnummer
FirstSpirit CXT Plattform
platform-[version].fsm
2.5.6
FirstSpirit CXT DAP Bridge
dataservice-[version].fsm
1.44.7
FirstSpirit CXT FragmentCreator
fragment-creator-[version].fsm
3.4.10
FirstSpirit Fragment DAP
fragmentdap-[version].fsm
1.40.11
FirstSpirit Media DAP
mediadap-[version].fsm
1.31.6*
FirstSpirit PageRef DAP
pageref-[version].fsm
1.9.6
FirstSpirit Markdown Editor
markdown-editor-[version].fsm
1.29.5*
FirstSpirit Tagging Editor
tagging-editor-[version].fsm
1.29.5
FirstSpirit CXT FragmentCreator - CaaS Integration
caas-integration-[version].fsm
1.31.6

* Diese Module benötigen ab dieser Version FirstSpirit 2020-03 oder höher.

4 SiteArchitect / ServerManager

Modul FirstSpirit Launcher JRE: Aktualisierung der Java-Versionen

Start und Aktualisierung („Rollout“) der FirstSpirit Desktop Apps (FirstSpirit SiteArchitect und ServerManager) erfolgen über den FirstSpirit Launcher.

Das Modul „FirstSpirit Launcher JRE“ ermöglicht Kunden und Partnern einen einfachen Wechsel zwischen unterschiedlichen Java-Versionen für den Betrieb der FirstSpirit Desktop Apps. Die Auswahl der gewünschten Java-Version kann serverweit jeweils für Microsoft Windows und macOS getrennt vorgenommen werden.

Dokumentation zum Modul „FirstSpirit Launcher JRE“ siehe „FirstSpirit Launcher JRE“ unter FirstSpirit Online Dokumentation, Dokumentation / Für Administratoren.

Mit dem aktuellen Release wurden die enthaltenen Java-Versionen aktualisiert: Neben der mit dem FirstSpirit Launcher ausgelieferten Version, AdoptOpenJDK 11.0.11 „(Default)“, ist aktuell Java-Variante Eclipse Temurin 17.0.3 verfügbar.

Übersicht

ID Beschreibung Kategorien
CORE-14223

Es wurde ein Fehler behoben, der dazu führen konnte, dass bei der Neuanlage und Modifikation von Bildern auftretende Exceptions am Frontend nicht korrekt angezeigt wurden.
Jetzt werden entsprechende Exceptions an das Frontend durchgereicht.

Debugging, FirstSpirit-Administrator, Logging, Medien
CORE-14414

Interface UrlFactory: Neuer Parameter readOnlyRegistry

Weitere Informationen können dem Kapitel „Administration: Interface UrlFactory: Neuer Parameter "readOnlyRegistry"“ entnommen werden.

Advanced URL, Entwickler, FirstSpirit-Administrator, Generierung
CORE-14448

In seltenen Fällen konnte es im FirstSpirit ContentCreator zu einer fehlerhaften Anzeige des Formulars kommen, wenn Sonderzeichen im Verweistext in der Eingabekomponente CMS_INPUT_DOM verwendet wurden.

ContentCreator
CORE-14470

Für den integrierten Jetty-Webserver „Jetty Web Server“, der nicht für den Einsatz in produktiven Umgebungen geeignet ist, wurden bei der HTTPS-Nutzung einige unsichere Verschlüsselungen und Protokolle gesperrt.
Dieser Webserver sollte nur als Fallback (in einem „Aggregierenden Webserver“) oder für Tests verwendet werden.

FirstSpirit-Administrator, Sicherheit, Webserver
CORE-14482

Fehler in Aufträgen, die dazu führen, dass eine FATAL-Meldung protokolliert wird (z. B. Beanshell-Skripte mit ungültiger Syntax oder eine java.lang.InterruptedException) führen jetzt nicht mehr dazu, dass der Server im ServerMonitoring bzw. im MBean HealthManager als degraded eingestuft wird.

Aufträge, Debugging, FirstSpirit-Administrator, Health Center, ServerMonitoring
CORE-14490

Beim Laden von Modulen werden jetzt die Ressourcen überprüft und im Falle mindestens einer Legacy-Ressource wird dies jetzt mit einer WARN-Meldung im Logging festgehalten (Legacy resource found in module 'myMod').
Während des Deployments von Web-Apps wird außerdem geprüft, ob das „FirstSpirit WebApp Compatibility Module“ zum Einsatz kommt. Falls ja, wird dies auch mit einer WARN-Meldung im Logging festgehalten (Web compatibility module used for web-app 'myWebApp').

FirstSpirit-Administrator, Isolated mode
CORE-14491

Es ist geplant, die Verwendung von Java 11 mit FirstSpirit zum Ende des Jahres 2022 abzukündigen und Java 17 als Referenz-Version auszuweisen.

Weitere Informationen können dem Kapitel „Administration: Ankündigung: Java 11, 17 und Jakarta“ entnommen werden.

Entwickler, FirstSpirit-Administrator, Java, Modul-Entwicklung, ServerManager, SiteArchitect
CORE-14501

Mit dem aktuellen Release wurden im Modul „FirstSpirit Launcher JRE“ die enthaltenen Java-Versionen aktualisiert.

Weitere Informationen können dem Kapitel „SiteArchitect / ServerManager: Modul FirstSpirit Launcher JRE: Aktualisierung der Java-Versionen“ entnommen werden.

Launcher
CORE-14506

Bei einem Bildzuschnitt im FirstSpirit ContentCreator wurde das Berücksichtigen des definierten Bild-Formates optimiert.

ContentCreator, FirstSpirit-Administrator, Medien, Medien-Verwaltung
CORE-14516

Performanceverbesserung bei Audit-Logging, wenn ein Auftrag geändert wird.

FirstSpirit-Administrator
CORE-14523

FirstSpirit Content Experience Tools: Aktuelle Modul-Versionen

Weitere Informationen können dem Kapitel „FirstSpirit Content Experience Tools (CXT): Aktuelle Modul-Versionen“ entnommen werden.

Entwickler, FirstSpirit Content Experience Tools (CXT), FirstSpirit-Administrator, FragmentCreator, Module
CXT-2618

Die Möglichkeit für eine Höhenanpassung der Eingabekomponente „Rich-Text-Editor“ (CMS_INPUT_DOM) wurde anderen Eingabekomponenten mit dieser Funktion angeglichen (Icon, Position und auch der Anfassbereich).

ContentCreator
CXT-2627

Die Darstellung der aktiven Selektion beim Hinzufügen von Einträgen in einer FS_INDEX-Eingabekomponente wurde an bestehende Auswahllisten dieser Art angeglichen.

ContentCreator
CXT-2629

Im FirstSpirit ContentCreator können jetzt Absatzreferenzen erstellt werden.

Weitere Informationen können dem Kapitel „ContentCreator: Absatzreferenzen erstellen“ entnommen werden.

ContentCreator, Redakteur
CXT-2631

Die Verwendung des Fragment Data Access Plugin im FirstSpirit ContentCreator führte zu lizenzpflichtigen Sessions, die nicht automatisch wieder geschlossen wurden.

ContentCreator, Performance, Server-Administrator, Sitzungen
CXT-2633

Aktualisierung von integrierter Fremdsoftware

Weitere Informationen können dem Kapitel „Administration: Aktualisierung von integrierter Fremdsoftware“ entnommen werden.

Integrierte Software

Deprecations

Funktion Abgekündigt mit Entfällt / Entfallen mit
Eingabekomponente CMS_INPUT_CONTENTAREALIST 5.2R3
Eingabekomponente CMS_INPUT_CONTENTLIST 5.2R3
Eingabekomponente CMS_INPUT_FILE 5.2R3
Eingabekomponente CMS_INPUT_LINKLIST 5.2R3
Eingabekomponente CMS_INPUT_OBJECTCHOOSER 5.2R3
Eingabekomponente CMS_INPUT_PAGEREF 5.2R3
Eingabekomponente CMS_INPUT_PICTURE 5.2R3
Eingabekomponente CMS_INPUT_TABLIST 5.2R3
FirstSpirit Access-API: de.espirit.firstspirit.agency.GroupsAgent 5.2R15
FirstSpirit Access-API: delete (de.espirit.firstspirit.access.AccessUtil) 5.2R18
FirstSpirit Access-API: release (de.espirit.firstspirit.access.AccessUtil) 2018-06
FirstSpirit Access-API: getLastLoginAsDate (de.espirit.firstspirit.agency.UserStatisticsAgent) 2018-07
FirstSpirit Access-API: remainingDurationOfCurrentStageInMillis (de.espirit.firstspirit.server.MaintenanceModeInfo) 2018-07 2025-13
FirstSpirit Access-API: getStartingTimeOfStageAsDate (de.espirit.firstspirit.server.MaintenanceModeInfo) 2018-07 2025-13
FirstSpirit Access-API: getSelectedWebserverConfiguration (de.espirit.firstspirit.access.serverConfiguration) 2018-10 2025-13
FirstSpirit Access-API: setSelectedWebserverConfiguration (de.espirit.firstspirit.access.serverConfiguration) 2018-10 2025-13
FirstSpirit Access-API: getSelectedWebServer (de.espirit.firstspirit.access.project.Project) 2018-10 2025-13
FirstSpirit Access-API: setSelectedWebServer (de.espirit.firstspirit.access.project.Project) 2018-10 2025-13
FirstSpirit Access-API: getLostAndFoundStoreNodes(); (de.espirit.firstspirit.feature.FeatureInstallResult) 2018-10
FirstSpirit Access-API: getDeletedStoreNodes(); (de.espirit.firstspirit.feature.FeatureInstallResult) 2018-10
FirstSpirit Access-API: de.espirit.firstspirit.access.store.Previewable 2019-01
WebSphere Application Server Support für FirstSpirit 2019-05
Datenbank-Layer Oracle Database 11g/12c 2020-12 2025-05
FirstSpirit Access-API: redirectTemplateLogToDefaultLog() (Interface RenderingAgent.Renderer) 2021-05
Support für Log4j 1 2022-05 2024-06