Release Notes
1 Allgemeines
Ausblick: Unterstützung für OpenJDK 16
e-Spirit unterstützt für das Produkt „FirstSpirit“:
- OpenJDK: die aktuelle freigegebene Java-Version sowie die letzte LTS-Variante (Long-Term-Support).
- Oracle Java: nur die letzte LTS-Variante.
Dies gilt sowohl für den FirstSpirit-Server als auch für die FirstSpirit-Desktop-Anwendungen.
Das sind für die aktuelle FirstSpirit-Version:
- Oracle Java 11 (in der aktuellen Version)
- OpenJDK 15 (in der aktuellen Version)
- OpenJDK 11 (in der aktuellen Version)
Im Februar 2021 startete e-Spirit die Testphase für den Einsatz von OpenJDK 16 (non-LTS; Release Date 2021-03) mit FirstSpirit. Dabei werden die FirstSpirit-Desktop-Anwendungen (SiteArchitect, ServerManager) und der FirstSpirit-Server intensiven internen Tests unterzogen. Aktuell gehen wir davon aus, OpenJDK 16 mit FirstSpirit-Version 2021-04 für die Verwendung mit FirstSpirit freizugeben.
Mit der Freigabe der Unterstützung von OpenJDK 16 wird gleichzeitig die Unterstützung für OpenJDK 15 (non-LTS; Release Date 2020-09) entfallen. (FirstSpirit wird mit OpenJDK 15 voraussichtlich weiter funktionsfähig bleiben. Es werden aber seitens der e-Spirit AG weder Tests mit OpenJDK 15 ausgeführt noch FirstSpirit-Probleme behoben, die ausschließlich im Zusammenhang mit der Verwendung von OpenJDK 15 auftreten).
Weiterführende Dokumentation siehe FirstSpirit: Technische Voraussetzungen und Empfehlungen.
2 ContentCreator
Handling der Rich-Text-Editoren (CMS_INPUT_DOM/TABLE)
Zwischenzeitlich gab es Probleme beim Einfügen von formatiertem Text in Rich-Text-Editoren im ContentCreator (CMS_INPUT_DOM und CMS_INPUT_DOMTABLE) sowie bei der Verwendung der Funktion „Rückgängig“ per Icon.
Diese wurden behoben.
Rich-Text-Editoren ermöglichen Redakteurinnen und Redakteuren vielfältige Formatierungsmöglichkeiten. Je nach Projektkonfiguration kann dies jedoch in der Ausgabe zu ungültigem HTML führen.
Mit folgenden neuen Funktionen wird der Redakteur dabei unterstützt, Formatierungen zu erkennen, die ungültig sind.
Allgemein werden jetzt projektspezifische Zeichenformatierungen in eckige Pfeile eingefasst, um sie im Editor besser identifizieren zu können:

Zusätzlich wird jetzt Text mit ungültiger Formatierung im Rich-Text-Editor farbig markiert und dies als Regelverletzung visualisiert:
- orange: Es handelt sich um eine Formatvorlage, die im Projekt vorhanden, aber für den jeweiligen Richt-Text-Editor nicht zugelassen ist.
Ein Speichern ist möglich. Vor einer Freigabe sollte die betroffene Formatierung jedoch entfernt werden („freigabeverhindernde Regelverletzung“). - rot: Es handelt sich um eine Formatvorlage, die nachträglich gelöscht wurde oder aus einem anderen Grund unbekannt ist.
Die betroffene Formatierung muss entfernt werden, damit ein Speichern möglich ist („speicherverhindernde Regelverletzung“).

DIV-Elemente (<div>) sind in HTML Block-Elemente. War im Projekt für DIV-Elemente eine Formatvorlage als Zeichenformatierung („Inline“) deklariert, konnte es zu Problemen beim Speichern von Absatzformatierungen kommen. Mit dem aktuellen Release werden solche ungültigen DIV-Formatierungen automatisch entfernt.
Darüber hinaus wurde das Verhalten für Listen und Inline-Tabellen (Attribute list und table) verbessert, wenn die Einstellung vorlagenseitig nachträglich geändert wurde: Bereits vorhandene Inhalte bleiben in jedem Fall weiterhin bearbeitbar.
3 FirstSpirit Content Experience Tools (CXT)
Aktuelle Modul-Versionen
Folgende Modul-Versionen für „FirstSpirit Content Experience Tools“ werden von FirstSpirit 2021-02 unterstützt:
| Modul- / Dateiname | Versionsnummer |
FirstSpirit CXT DAP Bridgedataservice-[version].fsm | 1.38 |
FirstSpirit CXT FragmentCreatorfragment-creator-[version].fsm | 2.19 |
FirstSpirit Fragment DAPfragmentdap-[version].fsm | 1.33 |
FirstSpirit Media DAPmediadap-[version].fsm | 1.27* |
FirstSpirit PageRef DAPpageref-[version].fsm | 1.5 |
FirstSpirit Markdown Editormarkdown-editor-[version].fsm | 1.26* |
FirstSpirit Tagging Editortagging-editor-[version].fsm | 1.26 |
FirstSpirit CXT FragmentCreator - CaaS Integrationcaas-integration-[version].fsm | 1.27 |
* Diese Module benötigen ab dieser Version FirstSpirit 2020-03 oder höher.
4 Kompatibilität
Module und Erweiterungen für FirstSpirit 2021-02
Folgende Module und Erweiterungen sind kompatibel mit FirstSpirit 2021-02:
| Modul- / Dateiname | Versionsnummer | Kompatibel |
FirstSpirit Aktualisierungsarchivfs-update-[version].tar.gz | 1.0.12 | - |
FirstSpirit Installationsarchiv fs-install-[version].tar.gz | 1.0.12 | - |
FirstSpirit LauncherFSLauncher.exe | 1.0.37 | ab FirstSpirit 2018-08 |
FirstSpirit Launcher JRE Modulfs-launcher-jre-[version].fsm | 1.16 | ab FirstSpirit 2020-11 |
FirstSpirit SAML Login Modulfs-saml-login-[version].fsm | 1.1 | ab FirstSpirit 2019-02 |
FSDevToolsfs-cli-[version].tar.gzfs-cli-[version].zip | 2.6.4 | ab FirstSpirit 2020-08 |
FirstSpirit Module Gradle Pluginfirstspirit-module-gradle-plugin-[version].jar | 0.15.9 | ab FirstSpirit 2019-06 |
5 SiteArchitect / ServerManager
5.1 Modul „FirstSpirit Launcher JRE“: Aktualisierung der Java-Versionen
Mit dem aktuellen FirstSpirit-Release wurden die im Modul „FirstSpirit Launcher JRE“ enthaltenen Java-Versionen aktualisiert:
Neben der mit dem FirstSpirit Launcher ausgelieferten Version, AdoptOpenJDK 11.0.10+9 64bit (Default) ist aktuell folgende Java-Variante verfügbar:
- AdoptOpenJDK 15.0.2+7 64bit
Dokumentation zum Modul „FirstSpirit Launcher JRE“ siehe entsprechende Dokumentation.
5.2 Start und Rollout der FirstSpirit-Desktop-Anwendungen über den FirstSpirit Launcher (neues Standardverhalten)
Neues Verhalten (Standardeinstellung: Start über den FirstSpirit Launcher):
Die FirstSpirit-Desktop-Anwendungen (SiteArchitect, ServerManager) werden ab der aktuellen FirstSpirit-Version automatisch für alle Benutzer über den FirstSpirit Launcher gestartet. Die Option „FirstSpirit Launcher verwenden“ auf der Startseite wird mit der aktuellen FirstSpirit-Version nicht mehr angezeigt. Das bedeutet, die Verwendung des FirstSpirit Launchers kann nicht mehr vom Benutzer aktiviert bzw. deaktiviert werden.
Die Möglichkeit, die FirstSpirit-Desktop-Anwendungen über Java Web Start zu starten entfällt. Die FirstSpirit-JNLP-Dateien, die für Java Web Start benötigt wurden, entfallen ebenfalls.
Der FirstSpirit Launcher stellt eine ständig aktualisierte, ausführlich getestete und lizenzkostenfreie Java-Laufzeitumgebung zur Verfügung, die bei der Installation des Launchers mit ausgerollt wird. Dadurch können SiteArchitect und ServerManager in einer vorkonfigurierten Umgebung betrieben werden, die unabhängig von der auf dem Client-Rechner vorhandenen Java-Version ist, selbst wenn diese ganz fehlen sollte (siehe Vorteile FirstSpirit Launcher).
Sollte es bei der Verwendung des FirstSpirit Launchers zu Problemen kommen, besteht für eine Übergangszeit die Möglichkeit, den Start über Java Web Start temporär zu reaktivieren. Wenden Sie sich hierzu bitte an den e-Spirit Technical Support.Bisheriges Verhalten (Standardeinstellung: Start über Java Web Start):
Bisher wurden die FirstSpirit-Desktop-Anwendungen nur dann über den FirstSpirit Launcher gestartet, wenn die Option „FirstSpirit Launcher verwenden“ aktiviert war.
Diese Einstellung konnte:
- für jeden Benutzer gesondert in den Verbindungseinstellungen auf der Startseite aktiviert werden (siehe Verbindungseinstellungen konfigurieren) oder
- innerhalb der Konfigurationsdatei
fs-server.confüber den ParameterexternalLauncherGroupfür eine Gruppe von Clientrechnern gesetzt werden (siehe Konfiguration fs-server.conf). Bei dieser Möglichkeit wurde die Verwendung des Launchers für alle Mitglieder der angegebenen Gruppe vorgegeben und konnte vom einzelnen Benutzer nicht deaktiviert werden.
Sind Anpassungen an das neue Verhalten notwendig?
Installation des FirstSpirit Launchers auf allen Arbeitsplatzrechnern:
Der Launcher muss zuvor auf dem Arbeitsplatzrechner des Benutzers installiert werden (siehe Installation FirstSpirit Launcher).
Bei Verwendung des Parameters externalLauncherGroup:
Sollten sie die Einstellung externalLauncherGroup verwenden, wird beim Start des FirstSpirit-Servers die folgende Meldung im Log ausgegeben:
WARN(...): External launcher groups are configured.
This is deprecated since the launcher is always active for all users (...)Die Konfiguration hat abgesehen von der Warn-Meldung aber keine negativen Auswirkungen. Die fs-server.conf sollte dennoch zeitnah angepasst und der Parameter aus der Konfiguration entfernt werden.
Übersicht: Ablauf der Ramp-down Phase für Java Web Start in FirstSpirit
- Release Notes 2019-10: Abkündigung für die Verwendung von Java Web Start für Start und Rollout der FirstSpirit-Desktop-Anwendungen.
- Release Notes 2020-06: Die Unterstützung von Java Web Start für Start und Rollout der FirstSpirit-Desktop-Anwendungen entfällt. Die Anwendungen können jedoch weiterhin über Java Web Start gestartet werden.
- Release Notes 2021-02: Ab FirstSpirit 2021-02 ist es nun für den Redakteur nicht mehr möglich, Java Web Start für Start und Rollout der FirstSpirit-Desktop-Anwendungen auszuwählen.
6 System
6.1 Aktualisierung von integrierter Fremdsoftware
Mit dem aktuellen FirstSpirit-Release wurde folgende intern verwendete Software aktualisiert:
- Java Die folgende neue Java-Version ist verfügbar:
- In FirstSpirit integriert (Standard): 11.0.10+9 64bit AdoptOpenJDK
- Im FirstSpirit Launcher JRE Modul: 15.0.2+7 64bit AdoptOpenJDK
6.2 Die Steuerungsdateien fs5 für Linux und fs5.cmd für Windows sind entfallen
Planmäßig entfallen mit dem aktuellen FirstSpirit-Release die Steuerungsdateien fs5 und fs5.cmd (siehe „Abkündigungen“). Die Steuerungsdateien werden durch die neuen verbesserten Steuerungsdateien fs-server für Linux- und fs-server.bat für Windows-Betriebssysteme abgelöst, die mit FirstSpirit 2020-08 freigegeben und für den produktiven Einsatz empfohlen wurden.
e-Spirit empfiehlt bestehenden Installationen, die noch die alten Steuerungsdateien verwenden, baldmöglichst auf die neuen Steuerungsdateien umzustellen.
Bereitstellung und Voraussetzungen für den Einsatz der neuen Steuerungsdateien: Voraussetzungen für den Betrieb eines FirstSpirit-Servers sind Java und der Java Service Wrapper. Der Java Service Wrapper und zugehörige Steuerungsdateien werden von e-Spirit über:
- das Installationsarchiv (für Neuinstallationen) bzw.
- das Aktualisierungsarchiv (für bestehende Installationen) bereitgestellt.
Beide Archive sind per Download erhältlich (für Zugangsdaten wenden Sie sich bitte an den Technical Support).
Um die neuen Steuerungsdateien verwenden zu können, ist ein Tanuki Java Service Wrappers Version 3.5.42 oder neuer notwendig. Eine aktuelle Wrapperversion ist im Installations- und Aktualisierungsarchiv enthalten.
Für eine Neuinstallation folgen sie bitte der Anleitung Installation per Installationsarchiv.
Für die Aktualisierung einer bestehenden Installation folgen sie bitte der Anleitung Aktualisierung des FirstSpirit-Backends.
Der FirstSpirit Server kann anschließend über die neuen Steuerungsdateien fs-server (für Linux) oder fs-server.bat (für Windows) gestartet werden.
Weiterführende Informationen zum Funktionsumfang und zur Steuerung siehe:
7 Vorlagenentwicklung
Ausgabemöglichkeit für Schnipsel um das Objekt #now erweitert.
Mit dem aktuellen Release wurden die Ausgabemöglichkeiten für Schnipsel um das Objekt #now erweitert.
#now liefert das aktuelle Datum zum Abfragezeitpunkt zurück.
So kann z. B. geprüft werden, ob das Datum in der Eingabekomponente CMS_INPUT_DATE in der Zukunft liegt, um dies im Schnipsel entsprechend zu kennzeichnen.
Übersicht
| ID | Beschreibung | Kategorien |
|---|---|---|
| CORE-11297 | Die FirstSpirit-Desktop-Anwendungen (SiteArchitect, ServerManager) werden ab der aktuellen FirstSpirit-Version automatisch für alle Benutzer über den FirstSpirit Launcher gestartet. Die Möglichkeit, die FirstSpirit-Desktop-Anwendungen über Java Web Start zu starten, entfällt. |
Entwickler, FirstSpirit-Administrator, Launcher, Redakteur, ServerManager, SiteArchitect |
| CORE-11927 | Ausgabemöglichkeit für Schnipsel um das Objekt |
Eingabekomponenten, Entwickler, Schnipsel, Vorlagenentwicklung |
| CORE-12612 | Das Verhalten wurde verbessert, wenn versucht wird, von einem Client eine Verbindung zu einem nicht kompatiblen Server aufzubauen. |
FirstSpirit-Administrator |
| CORE-13021 | Diese Module und Erweiterungen sind kompatibel mit FirstSpirit 2021-02. |
Entwickler, FirstSpirit-Administrator, Module, Server-Administrator |
| CORE-13084 | Es sind nun auch Minus-Zeichen im Namen einer globalen Web-Applikation erlaubt. |
Modul-Entwicklung |
| CORE-13171 | Mit FirstSpirit 2020-08 wurden die neuen verbesserten Steuerungsdateien für Windows- und Linux-Betriebssysteme freigegeben und für den Einsatz in produktiven Umgebungen empfohlen. Wie bereits in den Release Notes zu FirstSpirit 2020-08 und FirstSpirit 2020-11 angekündigt, entfallen die alten Steuerungsdateien mit der aktuellen FirstSpirit-Version. |
Server-Administrator |
| CORE-13173 | Geplant: Unterstützung OpenJDK 16: Mit FirstSpirit 2021-04 wird OpenJDK 16 (non-LTS; Release Date 2021-03) voraussichtlich für die Verwendung mit FirstSpirit (für den FirstSpirit-Server und die FirstSpirit-Desktop-Anwendungen) freigegeben. Mit der Freigabe der Unterstützung von OpenJDK 16 wird gleichzeitig die Unterstützung für OpenJDK 15 (non-LTS; Release Date 2020-09) entfallen. |
Entwickler, FirstSpirit-Administrator, Java, Server-Administrator |
| CORE-13179 | Beim Start des FirstSpirit-Servers werden die Dienste („Services“) jetzt zeitlich etwas später gestartet. Damit wird sichergestellt, dass die von den Diensten benötigte Infrastruktur zur Verfügung steht. |
Dienste, Server-Administrator |
| CORE-13211 | Mit dem aktuellen FirstSpirit-Release wurden die im Modul „FirstSpirit Launcher JRE“ enthaltenen Java-Versionen aktualisiert. |
Java, Launcher |
| CORE-13246 | Mit dem aktuellen FirstSpirit-Release wurde intern verwendete Software aktualisiert. |
Java, Launcher |
| CORE-13266 | Bei der Verwendung der neuen Kontrollskripte unter SysVinit konnte es zu Problemen bei der Auswertung von Variablen kommen, die in der optionalen Konfigurationsdatei |
Server-Administrator |
| CXT-2080 | Handling der Rich-Text-Editoren (CMS_INPUT_DOM und CMS_INPUT_DOMTABLE) im ContentCreator |
ContentCreator, Debugging, Dynamische Formulare, Eingabekomponenten, Entwickler, Redakteur |
| CXT-2102 | FirstSpirit Content Experience Tools: Aktuelle Modul-Versionen |
Entwickler, FirstSpirit Content Experience Tools (CXT), FirstSpirit-Administrator, FragmentCreator, Module |
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 | |
| Legacy mode für den FirstSpirit-Server | 2019-06 | 2022-03 |
| Steuerungsdateien für Windows- und Linux-Betriebssysteme (alt) | 2020-08 | 2021-02 |
| Datenbank-Layer Oracle Database 11g/12c | 2020-12 | 2025-05 |