Release Notes FirstSpirit™ 2023.9

Release Notes

FirstSpirit™ 2023.9

1 Administration

Anzeige der im Projekt verwendeten Derby-Layer

Im ServerManager werden in den Projekt-Eigenschaften unter der Option „Datenbanken“ nun Derby-Layer versteckt, wenn sie nicht ausgewählt wurden.

Mithilfe der neuen Checkbox „Datenbanken für alle Projekte anzeigen“ können alle Datenbank-Layer eingeblendet werden.

Datenbanken für alle Projekte anzeigen
Datenbanken für alle Projekte anzeigen

2 Administration / Module

Umstellung auf Jakarta Servlet 6.0

Die Umstellung auf Jakarta Servlet 6.0 ist ein wesentlicher Schritt, um die Sicherheit der Webanwendungen zu gewährleisten.

Mit der aktuellen FirstSpirit-Version 2023.9 erfolgte die Umstellung auf Jakarta Servlet 6.0 mit Unterstützung für automatische Migration.

Die Unterstützung der automatischen Migration wird mit FirstSpirit 2024.9 eingestellt.

Im Gegensatz zum schrittweise erfolgenden Rollout für Cloud-Kunden können On-Premises-Kunden ihre FirstSpirit-Server nach Erscheinen der Version 2023.9 testen und migrieren.

Wir empfehlen jedoch dringend, mit dem Update von produktiven Servern mindestens bis zum Release 2023.11 zu warten, da wir mit diesem Release die Kompatibilität für die von Crownpeak bereitgestellten Module gewährleisten wollen.

Wichtig:

  • Wenn FirstSpirit in einem On-Premises-Szenario betreiben wird, muss beim Wechsel auf die FirstSpirit JakartaEE-Edition die Tomcat-Version aktualisiert werden. Da die Servlet-Version auf 6.0 aktualisiert wird, wird eine 10.1.x Version von Tomcat benötigt.
  • Die Verwendung der FirstSpirit-Version 2023.9 setzt voraus, dass Java in der Version 17 eingesetzt ist.

Die FirstSpirit-Installation kann betroffen sein, wenn eine der folgenden Bedingungen zutrifft:

  • Die FirstSpirit-Installation wird nicht in der Crownpeak Cloud gepflegt.
  • Es wird ein benutzerdefiniertes Modul verwendet, das eine WebApp-Komponente mit Code enthält, der die alte Java-Servlet-API verwendet.
  • Es wird ein benutzerdefiniertes Modul eingesetzt, das eine WebApp-Komponente mit Abhängigkeiten enthält, die das alte JavaEE-API verwenden, z. B. Spring Boot 2.x.

Weitere Informationen und Updates sind in der Crownpeak Community und in den ausführlichen Jakarta FAQ zu finden.
Bei Fragen oder Feedback zur Migration wenden Sie sich bitte an das Customer Support Team.

3 ContentCreator

SEO-URLs im ContentCreator

SEO-URLs konnten bislang nur im SiteArchitect verwaltet werden (siehe Globale Einstellungen / URL-Einstellungen / Register „SEO-URLs“ (→Handbuch FirstSpirit SiteArchitect)).

Die SEO-URL-Funktionalität ist nun auch im ContentCreator verfügbar.

Konfiguration

Mir der neuen Projeckt-Komponente „CXT ContentCreator: URL Configuration ProjectApp“ kann eine Liste von „UrlCreators“ konfiguriert werden.

Aktion

Es gibt eine neue Aktion „URLs anzeigen“, mit der sich die neue Funktionalität aufrufen lässt. Die Aktion steht in der Navigation für die Menüstruktur zur Verfügung.

UID=access_menu

Für Medien und Medienordner ist die Funktionalität über das Icon im Aktionsmenü erreichbar:

UID=access_media

Beide Aktionen lassen sich über TailoredUI deaktivieren und sind standardmäßig aktiv.

Für weitere Informationen siehe auch FirstSpirit Handbuch für Redakteure (ContentCreator), „Menüfunktionen / Navigation / SEO-URLs“.

4 FirstSpirit Content Experience Tools (CXT)

4.1 Aktuelle Modul-Versionen

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

Modul- / DateinameVersionsnummer
FirstSpirit CXT Plattform
platform-[version].fsm
5.0.1
FirstSpirit CXT DAP Bridge
dataservice-[version].fsm
1.44.14
FirstSpirit CXT FragmentCreator
fragment-creator-[version].fsm
5.0.0
FirstSpirit Fragment DAP
fragmentdap-[version].fsm
1.40.22
FirstSpirit Media DAP
mediadap-[version].fsm
1.31.13
FirstSpirit PageRef DAP
pageref-[version].fsm
1.9.13
FirstSpirit Markdown Editor
markdown-editor-[version].fsm
1.29.12
FirstSpirit Tagging Editor
tagging-editor-[version].fsm
1.29.12
FirstSpirit CXT FragmentCreator - CaaS Integration
caas-integration-[version].fsm
1.31.12

4.2 MicroApp Managementseite über die FirstSpirit Startseite aufrufen

Unter

/management

(angehängt an die URL der Plattform) ist eine Managementseite erreichbar, über die die Verfügbarkeit vom MicroApps konfiguriert werden kann, also z. B.

http://myServer:8080/cxt-platform/management

Um die Managementseite zu erreichen ohne die URL kennen zu müssen, kann auf der FirstSpirit Startseite ein Startbutton konfiguriert werden.

Dafür ist das „ApplicationPlugin: MicroApp Management“ der Web-Applikation „Startseite“ hinzuzufügen.

UID=webapp_startseite

Dort muss die Web-Komponente auch deployed werden (Schaltfläche „Installieren“ / „Aktualisieren“).

Anschließend muss das ApplicationPlugin für „MicroApp Management“ im Bereich „Startseite“ („FirstSpirit ServerManager / Server / Eigenschaften / Startseite“) hinzugefügt werden:

UID=startseite_applications_en

Nach Auswahl des Plugins steht auf der Startseite das Icon zum Starten des „MicroApp Management“ zur Verfügung.

Die Managementseite ist nur für Server- oder Projekt-Administratoren erreichbar.

5 Modul-Entwicklung, Skripte, API

API: Synchronisieren aller existierenden Seiten mit einer Vorlage

Ab der aktuellen FirstSpirit-Version ist es per FirstSpirit-API möglich Änderungen an der Definition der Inhaltsbereiche einer Seitenvorlage an alle darauf beruhenden Seiten zu übernehmen.

Die neue SynchronizeTemplateBodiesOperation (FirstSpirit Access-API, Package de.espirit.firstspirit.store.operations) erlaubt das Synchronisieren der Inhaltsbereiche einer Vorlage in alle darauf basierende Seiten.

6 Module (allgemein)

Integration von Embedded Tomcat

Mit der aktuellen FirstSpirit-Version wird „FirstSpirit Embedded Tomcat Web Server“ als zusätzlicher Webserver neben dem „Jetty Web Server“ eingeführt.

Wie auch der „Jetty Web Server“ ist auch der „FirstSpirit Embedded Tomcat Web Server“ lediglich für Testzwecke vorgesehen und nicht für den produktiven Einsatz geeignet.

Zu weiteren Informationen siehe FirstSpirit Dokumentation für Administratoren, Kapitel „FirstSpirit ServerManager / Server-Eigenschaften / Webserver“, Abschnitt „FirstSpirit Embedded Tomcat Web Server“.

7 SiteArchitect

GID eines Store-Elements in den technischen Eigenschaften

Mit der aktuellen FirstSpirit-Version wird in den technischen Eigenschaften eines Store-Elements (Kontextmenü „Extras / Eigenschaften anzeigen“) die eindeutige GID („Global ID“) dieses Elements angezeigt.

Store-Element GID
Store-Element GID

8 System

Aktualisierung von integrierter Fremdsoftware

Mit dem aktuellen FirstSpirit-Release wurde folgende intern verwendete Software aktualisiert:

  • Eclipse Jetty
    Modul fs-jetty.fsm: Aktualisierung auf 12.0.0

Der Einsatz von Eclipse Jetty für Produktivzwecke wird weiterhin nicht empfohlen!

9 Vorlagenentwicklung

Bilder: Automatische Erkennung der Konfigurationsänderungen bezüglich der Skalierung

Wenn die Konfiguration für die Berechnung von Auflösungen über die ImageWriteParams (die benutzerdefinierte Projekteigenschaft) geändert wird, werden die entsprechenden Auflösungen beim nächsten Zugriff einmalig neu berechnet.

Hinweis: Bei der ersten Generierung mit der aktuellen FirstSpirit-Version, sofern ImageWriteParams gesetzt wurde, werden die Auflösungen einmalig neu berechnet. Das gilt aber nicht für manuell definierte Auflösungen.

Übersicht

ID Beschreibung Kategorien
CORE-4719

Ab der aktuellen FirstSpirit-Version ist es per FirstSpirit-API möglich Änderungen an der Definition der Inhaltsbereiche einer Seitenvorlage an alle darauf beruhenden Seiten zu übernehmen.

Weitere Informationen können dem Kapitel „Modul-Entwicklung, Skripte, API: API: Synchronisieren aller existierenden Seiten mit einer Vorlage“ entnommen werden.

FirstSpirit-API, Vorlagenentwicklung
CORE-7880

In Projekt-Eigenschaften werden standardmässig nur im Projekt verwendete Derby-Layer angezeigt („FirstSpirit ServerManager / Projekt-Eigenschaften / Datenbanken“).

Weitere Informationen können dem Kapitel „Administration: Anzeige der im Projekt verwendeten Derby-Layer“ entnommen werden.

Datenbank, ServerManager
CORE-13284

Im SiteArchitect wird beim Öffnen der Übersetzungshilfe für ein Element nun automatisch die aktuell ausgewählte Sprache für das Element gezeigt.

SiteArchitect
CORE-15194

Versteckte Verweisvorlagen werden im SiteArchitect nun nicht mehr in der Auswahlliste einer FS_CATALOG-Eingabekomponente angezeigt.

SiteArchitect
CORE-15222

Mit der aktuellen FirstSpirit-Version 2023.9 wurde ein neuer eingebetteter Webserver „FirstSpirit Embedded Tomcat Web Server“ mit Tomcat 10.1 zur Verfügung gestellt.

Weitere Informationen können dem Kapitel „Module (allgemein): Integration von Embedded Tomcat“ entnommen werden.

Integrierte Software, Module, Server-Administrator
CORE-15240

Probleme beim Laden von bestimmten Bildformaten wurden durch das Hinzufügen einer expliziten Initialisierung der Java ImageIO-Plugins verbessert.

Medien
CORE-15396

Die technischen Eigenschaften eines Store-Elements in SiteArchitect zeigen nun auch die GID („Global ID“) an.

Weitere Informationen können dem Kapitel „SiteArchitect: GID eines Store-Elements in den technischen Eigenschaften“ entnommen werden.

SiteArchitect
CORE-15406

Wenn die Konfiguration für die Berechnung von Auflösungen über die ImageWriteParams geändert wird, werden die entsprechenden Auflösungen beim nächsten Zugriff einmalig neu berechnet.

Weitere Informationen können dem Kapitel „Vorlagenentwicklung: Bilder: Automatische Erkennung der Konfigurationsänderungen bezüglich der Skalierung“ entnommen werden.

Medien
CORE-15430

Es wurde ein Fehler behoben, der in sehr seltenen Fällen dazu führen konnte, dass Änderungen an SEO-URLs für Ordner nicht sofort berücksichtigt wurden.

SiteArchitect
CORE-15480

Das Diskussionsforum („Menüleiste / Extras“) wurde aus dem SiteArchitect ausgebaut.

SiteArchitect
CORE-15518

Ein Classloading-Problem mit Gson auf dem Server wurde beseitigt.

Entwickler
CORE-15520

FirstSpirit Content Experience Tools: Aktuelle Modul-Versionen

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

FirstSpirit Content Experience Tools (CXT)
CORE-15525

Das Modul „FirstSpirit Personalisation“ hat benötigte Abhängigkeiten zu Log4J nicht definiert, was bei einer Verwendung in Webanwendungen, die nicht selbst Log4J bereitgestellt haben, zu Fehlermeldungen führte. Dies wurde behoben.

Module
CORE-15534

Umstellung auf Jakarta Servlet 6.0

Weitere Informationen können dem Kapitel „Administration / Module: Umstellung auf Jakarta Servlet 6.0“ entnommen werden.

FirstSpirit-Administrator, Java, Modul-Entwicklung, Module, Server-Administrator
CORE-15546

Aktualisierung von integrierter Fremdsoftware

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

Integrierte Software
CXT-1621

Bei mehreren geöffneten MicroApps (z. B. Fragment bearbeiten --> Medien hochladen) wurde die Anzeige verbessert. 

FirstSpirit Content Experience Tools (CXT), FragmentCreator
CXT-2414

SEO-URLs-Management im ContentCreator möglich

Weitere Informationen können dem Kapitel „ContentCreator: SEO-URLs im ContentCreator“ entnommen werden.

ContentCreator
CXT-2819

Die MicroApp Managementseite kann nun über die FirstSpirit Startseite aufgerufen werden.

Weitere Informationen können dem Kapitel „FirstSpirit Content Experience Tools (CXT): MicroApp Managementseite über die FirstSpirit Startseite aufrufen“ entnommen werden.

FirstSpirit Content Experience Tools (CXT), Server-Administrator
CXT-2947

Bei der Anzeige des Markdown-Editors konnte es in seltenen Fällen zu einem Fehlverhalten kommen.

FragmentCreator

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