Release Notes

Der „Isolated mode“ des FirstSpirit-Servers hat als wesentliches Ziel, dem Modulentwickler eine größere Freiheit bei der Auswahl der verwendeten Bibliotheken zu ermöglichen. Gerade die potenziellen Konflikte zu Bibliotheken, die vom FirstSpirit-Kern im „Legacy mode“ mitgeliefert wurden, werden dabei minimiert.

Im Februar 2019 (2019-02) wurde der „Isolated mode“ freigegeben. Seitdem ist dies der Standard für alle neu installierten Server.
Seit 2019-06 ist der „Legacy mode“ abgekündigt.
Mit dem aktuellen Release werden FirstSpirit Server, die noch im „Legacy mode“ betrieben werden, nicht mehr auf neuere Releases upgedatet (fs-update tar.gz).

Entfall von Dateien
Ab dem aktuellen FirstSpirit-Release werden jetzt folgende Dateien nicht mehr bereitgestellt und sollten wie folgt ersetzt werden:

fs-access.jar -> fs-isolated-runtime.jar
fs-server.jar -> fs-isolated-server.jar
fs-webrt.jar -> fs-isolated-webrt.jar

Migrationshinweis / Kompatibilität
Ab dem aktuellen Release unterstützen der Installer (fs-install tar.gz) und Updater (fs-update tar.gz) nicht mehr den „Legacy mode“.
Das bedeutet, dass ein Server vor einem Update des Backend-Systems auf die Version 3.0.0 auf den „Isolated mode“ umgestellt werden muss!

Ist mein Server betroffen?
Ein Indiz dafür, dass ein Server im „Isolated mode“ betrieben wird, ist das I (für „Isolated“) in der Server-Versionsnummer in den entsprechenden Dialogen (z. B. 5.2.220309.80296 (I)), beispielsweise auf der FirstSpirit Startseite.
FirstSpirit Server, die im „Isolated mode“ laufen, verwenden darüber hinaus die Datei fs-isolated-server.jar im Verzeichnis ~/server/lib-isolated (statt der Datei fs-server.jar im Verzeichnis ~/server/lib im „Legacy mode“).
Server und kundenspezifische Module, die noch nicht auf den „Isolated mode“ umgestellt sind, sollten entsprechend angepasst werden.
Benötigen Sie Unterstützung bei der Umstellung, wenden Sie sich bitte an den e-Spirit Technical Support.

Zur Umstellung von FirstSpirit Server und kundenspezifischen Modulen auf den „Isolated mode“ siehe auch https://docs.e-spirit.com/odfs/edocs/modd/index.html.

Über die FirstSpirit Startseite können die auf dem Server zur Verfügung stehenden Projekte geöffnet werden. Dabei kann der User auch den gewünschten Client wählen, mit dem das Projekt geöffnet werden soll.
Welche Clients zur Verfügung stehen sollen, kann in den

• Server-Eigenschaften
  (FirstSpirit ServerManager / Server-Eigenschaften / Startseite)
• Projekt-Eigenschaften
  (FirstSpirit ServerManager / Projekt-Eigenschaften / Applikationen)

konfiguriert werden.

War für ein Projekt in den Projekt-Eigenschaften im Bereich „Applikationen“ der FragmentCreator zugelassen („ApplicationPlugin: FragmentCreator“), konnte dies zu langen Ladezeiten der Startseite führen. Die Projektauswahl des FragmentCreator (beim Starten oder bei Projektwechsel) zeigte nur Projekte an, in denen die für Fragment-Projekte obligatorische Metadaten-Vorlage enthalten war.

Mit dem aktuellen Release wird jetzt nur noch die Einstellung der Checkbox „ApplicationPlugin: FragmentCreator“ in der Liste der zugelassenen Applikationen ausgewertet: d.h., in der Projektauswahl werden jetzt alle Projekte angezeigt, für die die Checkbox „ApplicationPlugin: FragmentCreator“ nicht explizit deaktiviert ist.
Soll ein Projekt in der Projektauswahlliste des FragmentCreator erscheinen, muss die Checkbox aktiviert werden.

Bei neu angelegten Projekten ist die Checkbox standardmäßig deaktiviert:

Enthält das Projekt die erforderliche Metadaten-Vorlage nicht, wird beim Öffnen des Projekts auf der FirstSpirit Startseite folgende Nachricht eingeblendet:

The project is not yet prepared for fragments. You may change the project settings 
   and remove the FragmentCreator from the allowed applications, if necessary.

Im September 2021 wurde Java 17 veröffentlicht. JDK 17 wird von den meisten Anbietern als Long-Term-Support (LTS)-Version herausgegeben. Sie folgt auf Java 11, das aktuell LTS-Status innehat.

Mit dem aktuellen Release wird Java 17 offiziell für die Verwendung mit FirstSpirit freigegeben. Als Referenz gilt weiterhin Java 11.

Mit dieser Freigabe entfällt gleichzeitig die Unterstützung für Java 16.
Voraussichtlich wird FirstSpirit weiterhin mit Java 16 funktionsfähig bleiben. Es werden aber seitens der e-Spirit AG weder Tests mit Java 16 durchgeführt noch FirstSpirit-Probleme behoben, die mit Java 16 in Zusammenhang stehen.

Weiterführende Dokumentation siehe https://docs.e-spirit.com/odfs/edocs/admi/technische-vora/index.html.

Mit dem aktuellen Release wird PostgreSQL 14.x offiziell für die Verwendung mit FirstSpirit freigegeben. Als Referenz gilt weiterhin PostgreSQL 11.
Es ist geplant, dass PostgreSQL 14 in einem folgenden Release die offizielle Referenz-Version wird.

Zusätzlich wurden PostgreSQL 12.x und PostgreSQL 13.x in die Liste der kompatiblen Datenbanken aufgenommen.

Die Version PostgreSQL 9.x wird hingegen seit November 2021 nicht mehr vom Hersteller gewartet/unterstützt, sodass auch der Support durch FirstSpirit entfällt.

Folgende Module und Erweiterungen sind kompatibel mit FirstSpirit 2022.3:

Mit dem aktuellen FirstSpirit-Release werden zwei neue MBeans bereitgestellt. Mittels dieser kann beispielsweise die Last auf Webservern beurteilt werden.

• WebAppManager: Über dieses MBean können alle WebApps aus den installierten Modulen und deren Verwendung in den konfigurierten Web-Applikationen ausgelesen werden.
• WebServerManager: Über dieses MBean kann ermittelt werden, welche Web-Applikationen auf welchem Webserver installiert sind.

Hiccups der Java VM werden jetzt zusätzlich auch von dem Application Server, auf dem die FirstSpirit-Webapps laufen, registriert und in der Datei fs-server.log protokolliert. Darüber hinaus auch in der Datei server-incidents.log, z. B.

WARN  08.02.2022 09:09:58.299 (de.espirit.firstspirit.server.HealthStatus):
   HICCUP (de.espirit.firstspirit.server.statistic.HiccupMeter) Web application VM 
   hiccup detected: ...

Dabei gelten die Einstellungen der fs-server.conf im Bereich VM hiccup detector MBean.

Hinweis: Pro Java VM erfolgt nur eine Registrierung des entsprechenden MBeans HiccupMeter.
Das bedeutet, dass für den Jetty Web Server kein Monitoring der Java VM-Hiccups über die Webapps stattfindet, da dieses bereits über den FirstSpirit Server erfolgt. Wenn auf einem Application Server Webapps von mehr als einem FirstSpirit Server laufen sollten, werden die Hiccups nur an den FirstSpirit Server reportet, dessen Webapp den HiccupMeter zuerst registriert hat.

Das Verzeichnis ~/web diente bislang als Generierungsverzeichnis des „InternalJetty“ und wird seit dem Ausbau des „InternalJetty“ (ist erfolgt mit FirstSpirit 2022.1) nicht mehr benötigt.

Automatisches Entfernen von nicht mehr benötigten Dateien und Verzeichnissen
Beim Update auf FirstSpirit-Release 2022.3 oder höher werden einmalig alle FirstSpirit-Webanwendungen aus dem Verzeichnis ~/web entfernt. Sofern das Verzeichnis keine anderen Daten enthält, wird es ebenfalls gelöscht. (INFO-Meldung im Logging: ...Deleting legacy web directory:...)
Enthält das Verzeichnis Dateien, bei denen es sich nicht um FirstSpirit-Webanwendungen handelt, bleibt die entsprechende Verzeichnisstruktur sowie Dateien erhalten. (WARN-Meldung im Logging: ...Legacy web directory not deleted, the directory is not empty:...)
So können Webserver, die das Verzeichnis ~/web nutzen, problemlos weiterhin verwendet werden.

Fallback-Generierungsverzeichnis
Ist kein Webserver konfiguriert oder für Webserver vom Typ „Tomcat“ kein Webverzeichnis angegeben (= das Feld „Webverzeichnis“ ist leer, z. B. weil FirstSpirit keinen Zugriff auf das Dateisystem des Tomcat hat), erfolgte eine Generierung als Fallback bisher automatisch in das Verzeichnis

~/web/fs5staging

Mit dem aktuellen Release (FirstSpirit 2022.3) wird daher im Fallback-Fall jetzt das Verzeichnis der Web-Anwendung fs5staging des „Jetty Web Server“ verwendet:

~/data/modules/FirstSpirit Jetty Server.JettyService/webapps/fs5staging/webapp

Beim „Jetty Web Server“ handelt es sich um einen in FirstSpirit integrierten Jetty-Webserver, der in Form des System-Moduls fs-jetty.fsm zur Verfügung gestellt wird.
Standardmäßig läuft der zugehörige Dienst (JettyService). Läuft dieser Dienst nicht, wird das Generierungsverzeichnis im Fallback-Fall ebenfalls verwendet, der „Jetty Web Server“ ist dann aber nicht erreichbar und ein Zugriff auf das Generierungsverzeichnis ist nicht möglich.

Wenn Sie auf Ihrem Server kundenspezifische Erweiterungen (Skripte, Module usw.) einsetzen, die auf Änderungen im Verzeichnis ~/web/fs5staging reagieren, müssen diese entsprechend an den neuen Pfad angepasst werden.

Um einfacher ermitteln zu können, ob das Verzeichnis ~/web noch in Projekten verwendet wird, wird seit FirstSpirit 2022.1 im Fallback-Fall Folgendes im Log festgehalten (Log-Level INFO):

Fallback to web directory:[...]

Für Medien kann jetzt auch im FirstSpirit ContentCreator ein beschreibender Text hinterlegt werden. Dieser Text kann beispielsweise auf der Webseite als alternativer Text ausgegeben werden (alt-Tag).
Das entsprechende Feld wird nach Auswahl einer Datei neben dem Medium eingeblendet:

• Für sprachabhängige Medien kann für jede Sprache, in der eine Datei ausgewählt wurde, eine Beschreibung eingepflegt werden.
• Für sprachunabhängige Medien kann eine sprachunabhängige Beschreibung eingepflegt werden.

Die Navigationsleiste im FirstSpirit ContentCreator kann jetzt über das Feature

Navigation: Enabled

der „Tailored UI“ konfiguriert werden (z. B. deaktiviert).

Der Menüeintrag „Navigation bearbeiten“ im Menü „Aktionen“, der die Navigationsleiste öffnete, wird nicht mehr benötigt und ist in diesem Kontext entfallen.

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

Neue Absätze können jetzt in der Navigationsleiste des FirstSpirit ContentCreator auch auf Inhaltsbereichen angelegt werden (im Bereich „Seite“, per RECHTSKLICK oder Kontextmenü).
Er wird dann an erster Stelle des Inhaltsbereichs eingefügt.

Über die „Tailored UI“ kann das Anlegen von Absätzen jetzt getrennt für die Navigationsleiste und die EasyEdit-Leiste folgendermaßen gesteuert werden:

• Navigation: Create Section
  Dieser Schalter ist neu im aktuellen FirstSpirit-Release.
  Er steuert die Funktion „Neuer Absatz“ in der Navigationsleiste.
  Standardmäßig ist die Funktion in allen Projekten für alle User verfügbar.
• Preview: Create Section
  Dieser Schalter steuert die Funktion „Neuer Absatz“ in der EasyEdit-Leiste:

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

Skripte ermöglichen eine schnelle Umsetzung von Funktionalitäten, die in FirstSpirit nicht vorhanden sind.

Im FirstSpirit ContentCreator waren Skript-Funktionalitäten bisher über das Menü „Aktionen“ erreichbar, sowie über die EasyEdit-Toolbar und die Navigationsleiste, dort allerdings nur für Elemente der Inhalte-Verwaltung (Skripttyp „ContentCreator“).

Mit dem aktuellen Release sind die Skripte vom Typ „ContentCreator“ jetzt auch für Elemente der Struktur-, Medien- und Datenquellen-Verwaltung verfügbar.
Ausnahme: Elemente aus Remote-Projekten

Die Skript-Aktionen sind über die Tailored UI einzeln steuerbar:

• EntityManagement: Execute script
• MediaManagement: Execute script
• Navigation: Execute script
• Preview: Execute script

Zu weiterführenden Informationen siehe https://docs.e-spirit.com/odfs/vorlagen-grundl/aufbau-vorlagen/skripte/index.html

Hinweis: FirstSpirit-Skripte stellen eine leichtgewichtige Möglichkeit dar, neue Funktionaliäten in FirstSpirit zu integrieren. Aus Gründen der Stabilität wird jedoch empfohlen, Funktionalitäten, die langfristig benötigt und eingesetzt werden, als FirstSpirit-Modul mit Executable oder Plugin umzusetzen.

Im Report „Suche“ werden jetzt nur noch Elemente in der Suchergebnisliste angezeigt, für die der Redakteur über das Recht „Sichtbar“ verfügt. Ansonsten wird das Element nicht als Suchergebnis angezeigt. Zuvor wurden auch Elemente angezeigt, für die der Redakteur keine Sichtbarkeitsrechte hatte, und zwar mit dem Schriftzug ** Kein Zugriff **.

Hinweis: Fehlen Sichtbarkeitsrechte in der Vaterkette des betreffenden Elements, wird es weiterhin mit dem Schriftzug ** Kein Zugriff ** in der Suchergebnisliste angezeigt. Mehrere nicht sichtbare Elemente werden dabei zu einem zusammengefasst.

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

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

Der Status des Quellabsatzes hinsichtlich der Ausgabe („diesen Absatz in der Ausgabe generieren“) wird beim Anlegen einer Absatzreferenz jetzt übernommen. Er kann später wieder geändert werden, unabhängig jeweils für den Quellabsatz und die Absatzreferenz. Der Status der Ausgabe wird nach dem Anlegen einer Absatzreferenz nicht mehr zwischen Quellabsatz und Absatzreferenz synchronisiert.

In der contentSelect-Funktion können jetzt direkt Abfragen referenziert werden, und zwar über den Parameter queryUid.

Beispiel:

<CMS_FUNCTION name="contentSelect" resultname="myContentSelectFunction">
   	<CMS_PARAM name="queryUid" value="mySchema.myQuery"/>
</CMS_FUNCTION> 

Zu weiteren Informationen siehe https://docs.e-spirit.com/odfs/vorlagenentwick/vorlagensyntax/funktionen/header/contentselect/index.html.