Release Notes FirstSpirit™ 2021.2

Release Notes

FirstSpirit™ 2021.2

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:

UID=contentcreator_dom_formatierung

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“).

UID=contentcreator_dom_ungueltige_formatierung

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- / DateinameVersionsnummer
FirstSpirit CXT DAP Bridge
dataservice-[version].fsm
1.38
FirstSpirit CXT FragmentCreator
fragment-creator-[version].fsm
2.19
FirstSpirit Fragment DAP
fragmentdap-[version].fsm
1.33
FirstSpirit Media DAP
mediadap-[version].fsm
1.27*
FirstSpirit PageRef DAP
pageref-[version].fsm
1.5
FirstSpirit Markdown Editor
markdown-editor-[version].fsm
1.26*
FirstSpirit Tagging Editor
tagging-editor-[version].fsm
1.26
FirstSpirit CXT FragmentCreator - CaaS Integration
caas-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- / DateinameVersionsnummerKompatibel
FirstSpirit Aktualisierungsarchiv
fs-update-[version].tar.gz
1.0.12-
FirstSpirit Installationsarchiv
fs-install-[version].tar.gz
1.0.12-
FirstSpirit Launcher
FSLauncher.exe
1.0.37ab FirstSpirit 2018-08
FirstSpirit Launcher JRE Modul
fs-launcher-jre-[version].fsm
1.16ab FirstSpirit 2020-11
FirstSpirit SAML Login Modul
fs-saml-login-[version].fsm
1.1ab FirstSpirit 2019-02
FSDevTools
fs-cli-[version].tar.gz
fs-cli-[version].zip
2.6.4ab FirstSpirit 2020-08
FirstSpirit Module Gradle Plugin
firstspirit-module-gradle-plugin-[version].jar
0.15.9ab 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 Parameter externalLauncherGroup fü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.

Weitere Informationen können dem Kapitel „SiteArchitect / ServerManager: Start und Rollout der FirstSpirit-Desktop-Anwendungen über den FirstSpirit Launcher (neues Standardverhalten)“ entnommen werden.

Entwickler, FirstSpirit-Administrator, Launcher, Redakteur, ServerManager, SiteArchitect
CORE-11927

Ausgabemöglichkeit für Schnipsel um das Objekt #now erweitert.

Weitere Informationen können dem Kapitel „Vorlagenentwicklung: Ausgabemöglichkeit für Schnipsel um das Objekt #now erweitert.“ entnommen werden.

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.

Weitere Informationen können dem Kapitel „Kompatibilität: Module und Erweiterungen für FirstSpirit 2021-02“ entnommen werden.

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.

Weitere Informationen können dem Kapitel „System: Die Steuerungsdateien fs5 für Linux und fs5.cmd für Windows sind entfallen“ entnommen werden.

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.

Weitere Informationen können dem Kapitel „Allgemeines: Ausblick: Unterstützung für OpenJDK 16“ entnommen werden.

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.

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

Java, Launcher
CORE-13246

Mit dem aktuellen FirstSpirit-Release wurde intern verwendete Software aktualisiert.

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

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 fs-server-custom.shconf definiert wurden. Dieses Problem wurde behoben.

Server-Administrator
CXT-2080

Handling der Rich-Text-Editoren (CMS_INPUT_DOM und CMS_INPUT_DOMTABLE) im ContentCreator

Weitere Informationen können dem Kapitel „ContentCreator: Handling der Rich-Text-Editoren (CMS_INPUT_DOM/TABLE)“ entnommen werden.

ContentCreator, Debugging, Dynamische Formulare, Eingabekomponenten, Entwickler, Redakteur
CXT-2102

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

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