Release Notes

Wie bereits mit FirstSpirit 2026.3 angekündigt, werden die FirstSpirit Web-Anwendungen auf Spring Boot 4 migriert. Diese Migration wird mit FirstSpirit 2026.5 durchgeführt und erfordert zwingend den Einsatz von Tomcat 11.

Bitte stellen Sie sicher, dass Ihre Web-Anwendungen, Module und Komponenten mit Tomcat 11 und der Servlet-API 6.1 kompatibel sind.
Bestehende Deployments auf Basis von Tomcat 10 oder älter werden nach der Migration nicht mehr unterstützt.

In diesem Zusammenhang weisen wir darauf hin, dass mit FirstSpirit 2026.5 ebenfalls die Umstellung des Bytecode-Levels auf Java 21 erfolgt (siehe Ankündigung zu FirstSpirit 2026.2). Für den Betrieb des FirstSpirit-Servers ist dann eine Java-Laufzeitumgebung mindestens in Version 21 erforderlich.
Der Betrieb mit Java 17 ist ab diesem Zeitpunkt nicht mehr möglich.

Das neue FirstSpirit OIDC Login Modul ermöglicht die Authentifizierung von FirstSpirit-Benutzern über einen externen OpenID-Connect-Provider.

OpenID Connect (OIDC) ist ein Authentifizierungsprotokoll, das auf dem OAuth 2.0-Standard basiert. Es ermöglicht Clients, die Identität eines Benutzers anhand der Authentifizierung durch einen Authorization Server (OpenID Provider) zu verifizieren. Darüber hinaus können grundlegende Profilinformationen des Benutzers abgerufen werden.

Weitere Informationen können der Dokumentation entnommen werden.

Mit Java 24 wurden neue, restriktivere Standardwerte für die Verarbeitung von XML-Daten über JAXP (Java API for XML Processing) eingeführt. Diese können bei großen FirstSpirit-Projekten zu Fehlern bei der XML-Verarbeitung führen – beispielsweise beim Import umfangreicher Inhalte.

Die aktuelle Version des FirstSpirit-Backends setzt die bis einschließlich Java 23 gültigen Standardwerte nun explizit für alle Java-Versionen, sodass bestehende Projekte ohne Anpassungen weiterhin korrekt verarbeitet werden.

Hinweis für besonders große Projekte

Wenn Projekte mit Datenbankinhalten importiert werden sollen, die mehr als 50 Millionen XML-Tags umfassen, kann in der Datei fs-wrapper.isolated.conf der Parameter -Djdk.xml.totalEntitySizeLimit= mit einem entsprechend höheren Wert konfiguriert werden. Der zugehörige wrapper.java.additional.##-Parameter muss dabei einen Index von 80 oder höher verwenden.

Die Erzeugung externer Prozesse aus Skripten und Templates ist ab dem aktuellen Release durch eine Whitelist eingeschränkt. Standardmäßig sind nur ausführbare Dateien im Verzeichnis <FirstSpirit-Server>/shared/bin/ zugelassen.

Konfiguration: Die neue optionale Datei fs-exec.conf unter <FirstSpirit-Server>/conf/ ermöglicht die gezielte Konfiguration der Constraints (RuntimeExitConstraint, ServerFileConstraint, ProcessStartConstraint) pro Ausführungskontext. Änderungen werden zur Laufzeit automatisch übernommen.

Externe Prozesse erlauben

Wenn aus Skripten oder Templates externe Prozesse gestartet werden sollen, gibt es drei Möglichkeiten:

• Die ausführbare Datei (oder ein Skript bzw. symbolischer Link) wird im Verzeichnis <FirstSpirit-Server>/shared/bin/ abgelegt. Dieses Verzeichnis ist in der Standardkonfiguration bereits erlaubt.
• Die Whitelist wird über zusätzliche Einträge in der fs-exec.conf erweitert.
• Über den Parameter execControlConstraints=false in der fs-server.conf können alle Constraints vollständig deaktiviert werden.
  

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

Das Interface StoreElementAgent wurde um neue Methoden erweitert, die den Zugriff auf Store-Elemente per UID und Java-Klasse ermöglichen. Die Angabe des IDProvider.UidType entfällt — der passende UidType wird automatisch aus der übergebenen Klasse abgeleitet.

Neue Methoden:

• Optional<T> requestStoreElement(String uid, Class<T> type, boolean release)
• Optional<T> requestStoreElement(String uid, Class<T> type)
• T requireStoreElement(String uid, Class<T> type, boolean release)
• T requireStoreElement(String uid, Class<T> type)

Beispiel

Bisher:

IDProvider element = agent.loadStoreElement(
   "myPage", IDProvider.UidType.PAGESTORE_LEAF, false); 
Page page = (Page) element;

Neu:

Optional<Page> page = agent.requestStoreElement("myPage", Page.class); 

oder

Page page = agent.requireStoreElement("myPage", Page.class); 

Hinweis: Der Typ-Parameter muss eine (Sub-)Klasse mit eigenem UID_TYPE-Feld sein.
Unterstützt werden unter anderem Page, Media, PageRef, PageTemplate, SectionTemplate, Script und Schema.

Für die Ausführung von Workflows oder Skripten im Anschluss an das Deployment von Bundles kann in der "Bundle management"-ProjectApp jetzt ein technischer Benutzer hinterlegt werden.

Dies ist vor allem dann nötig, wenn man im Anschluss an ein Deployment verändernde Operationen in den Zielprojekten durchführen möchte.

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.

Mit dem aktuellen Release wurden die enthaltenen Java-Versionen aktualisiert.

• 21.0.9+10 -> 21.0.10+7
  (Default - die mit dem FirstSpirit Launcher ausgelieferte Version)
• 25.0.1+8 -> 25.0.2+10
  

Mit der FirstSpirit-Version 2026.4 wird die Funktion „Sprachabhängige Freigabe“ offiziell freigegeben.

Sie ermöglicht es berechtigten Redakteuren, Inhalte in mehrsprachigen Projekten gezielt pro Sprache freizugeben und zu veröffentlichen.

Standardmäßig ist die sprachunabhängige Freigabe für alle Projekte aktiviert.

Das Feature Sprachabhängige Freigabe kann im Server-Manager unter den Projekt-Einstellungen individuell für jedes Projekt aktiviert werden.

Zu weiteren Informationen siehe auch die Dokumentation.