Release Notes

Das MBean HealthManager übermittelt jetzt auch Informationen zu den Web-Applikationen, die standardmäßig von FirstSpirit mitgeliefert werden.
Die Datei server-incidents.log (herunterladbar im FirstSpirit ServerMonitoring unter „FirstSpirit / Monitoring / Kennzahlen“ über das Umschlag-Icon) beinhaltet jetzt auch folgende Informationen:

• Anmeldungen der Standard-Web-Applikationen
• vollständiger Ausfall einer oder mehrerer der Standard-Web-Applikationen

Beispiel-Logmeldungen:

WEBAPP INFO 15.09.2021 14:43:59.037 (de.espirit.firstspirit.server.ServerManagerImpl) 
   Web application started: fs5root
RUN_LEVEL INFO 27.09.2021 09:09:44.091 (de.espirit.firstspirit.server.RunLevelHolder)
   Reached run level: CORE_WEBAPPS_STARTED(080)

Darüber hinaus berücksichtigt das MBean HealthManager nun auch den freien Festplatten-Speicherplatz bei der Berechnung des Server-Status.
Für alle schreibbaren und am FirstSpirit-Server beteiligten Dateisystem gibt es dazu jetzt eigene MBeans, die unterhalb des HealthManager MBeans dargestellt werden. Als Name wird der relative Pfad im Serververzeichnis verwendet.

Fällt in einem der beteiligten Dateisysteme der freie Speicher unter 5% der Dateisystemgröße oder 640 MB (je nach dem, welcher Wert kleiner ist), gilt der Server als degraded, und für das betroffene Dateisystem wird eine Warnung ausgegeben.
Ist im FirstSpirit ServerManager eine Warnungs-E-Mail bei zu geringem zur Verfügung stehenden Festplattenplatz konfiguriert (unter Server-Eigenschaften / Globale Server-Eigenschaften / „Warnung bei“), wird stattdessen die Prozentzahl als Warnungs-Limit für die MBeans verwendet.

Unzureichender Festplattenplatz wird ebenfalls in der Datei server-incidents.log festgehalten, z. B.

Insufficient free space on '/home/fsserver/Daten/CMSServer4/work
   (name=tmpfs, type=tmpfs)' detected, 185.801 MB left on file store.

Zusätzlich prüft das MBean HealthManager jetzt auch die Last auf dem Server: Ist diese zu hoch (z. B. solange mehr als 5 % der Prozessorzeit für Garbage Collections genutzt werden), wird der Server ebenfalls als degraded angesehen. Das Über- und danach das Unterschreiten der Grenze wird in der Datei server-incidents.log festgehalten, z. B.

High Java VM garbage collection overhead detected: 5.30 %

Der Status des MBean HealthManager des Servers wird jetzt auch im FirstSpirit Health Center visualisiert (im FirstSpirit ServerMonitoring). Dort kann im Bereich „FirstSpirit Landschaft“ direkt in der Statusleiste oberhalb des betreffenden Servernamens abgelesen werden, ob sich der Server in einem problematischen Zustand befindet.
Die Farb- und Symbolcodierung ist jetzt wie folgt:

Der Haken auf grünem Hintergrund bedeutet, dass der Server keine aktuellen Probleme meldet.

Das Ausrufungszeichen auf gelbem Hintergrund bedeutet, dass der Server keine aktuellen Probleme meldet. Allerdings wird die Lizenz innerhalb der nächsten 30 Tage ablaufen und sollte erneuert werden.

Das Ausrufungszeichen auf rotem Hintergrund bedeutet, dass sich der Server im Zustand degraded befindet.

Um unabhängiger von der Java-Entwicklung durch Oracle zu werden und auch im Sinne seiner Kunden langfristiger planen zu können, setzt e-Spirit bereits seit geraumer Zeit auf die Verwendung von OpenJDK, speziell vom Hersteller AdoptOpenJDK. Alle AdoptOpenJDK Binaries and Skripte sind Open Source lizensiert und kostenlos verfügbar.

Ca. im April 2021 ist das Projekt „AdoptOpenJDK“ zur „Eclipse Foundation“ gewechselt und heißt jetzt Eclipse Adoptium. Das JDK trägt den Namen „Temurin“.
Die neuesten Releases können unter https://adoptium.net heruntergeladen werden.

Siehe dazu auch AdoptOpenJDK-Blog.

Darüber hinaus wurde Mitte September 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.
Intern wurden die ersten Vorbereitungen für die Testphase zum Einsatz von Java 17 (Temurin) mit FirstSpirit vorgenommen. Ziel ist es, Java 17 in einem zukünftigen FirstSpirit-Release für die Verwendung mit FirstSpirit freizugeben.

Das Modul „FirstSpirit Image Recognition“ unterstützt jetzt neben den Formaten „JPEG“ und „PNG“ Bilder vom Format „WebP“:
Beim Upload werden die Bilder jetzt analysiert, es werden (soweit konfiguriert) die entsprechenden Metadaten gesetzt und der Fokus gesetzt bzw. der automatische Zuschnitt vorgenommen.

Bei Verwendung der Funktion editorId werden im ContentCreator Formulare standardmäßig in der aktuellen Sprache geöffnet (#global.language).
Mit dem neuen Parameter

language

kann eine Sprache vorgegeben werden, in der ein Formular geöffnet werden soll.

Der Parameter erwartet das Kürzel der Sprache oder das Language-Objekt, z. B.

<div$CMS_VALUE(editorId(editorName:"st_text", language:"FR"))$>
<div$CMS_VALUE(editorId(editorName:"st_text", language:#global.getLanguage("FR")))$>

Zu weiteren Informationen zur Funktion editorId siehe

• https://docs.e-spirit.com/odfs/vorlagenentwick/content-highlig/einsatz-projekt/index.html
• https://docs.e-spirit.com/odfs/vorlagenentwick/vorlagensyntax/funktionen/anweisungen/editorid/index.html

Aktuell befindet sich die Funktionalität der „Datenquellen-Verwaltung“ im ContentCreator weiterhin in der Beta-Phase.

Folgende Verbesserungen wurden aufgrund von Kunden-Feedback mit dem aktuellen Release vorgenommen:

• In der Tabellenansicht werden jetzt auch Spalten dargestellt, die die Eingabekomponente CMS_INPUT_DATE enthalten.
  Beim Mapping auf die Datentypen Date oder Long ist auch eine Sortierung möglich.
• In der Tabellenansicht für Medien vom Typ „Datei“ wird jetzt der Name angezeigt (statt einem Typ-Icon wie zuvor).
  „Broken references“ (ungültige Referenzen) werden mit roter Schrift visualisiert.

Zu allgemeinen Informationen zur Beta-Phase der „Datenquellen-Verwaltung“ im ContentCreator siehe Release Notes zu FirstSpirit 2021-08 (https://docs.e-spirit.com/odfs/releasenotes/2021-08/FirstSpirit_Releasenotes_DE.pdf).

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

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

Über den Parameter

allowedRedirectHosts

können URLs definiert werden, zu denen eine Weiterleitung erlaubt sein soll.
Die Statusseiten, die für die CXT-Plattform und den FragmentCreator eingerichtet werden können (jeweils unter ~/status), prüfen jetzt auch die Konfiguration dieses Parameters.
Der Parameter kann in FirstSpirit konfiguriert werden, z. B. in der Datei fs-server.conf.

Ist die Konfiguration nicht korrekt (d.h. ist der aktuelle Host nicht über den Parameter allowedRedirectHosts konfiguriert), wird eine Fehlermeldung im Log festgehalten sowie eine entsprechende Fehlermeldung in der Browserkonsole ausgegeben.

Hinweis auf der Statusseite im Fehlerfall:

External hostname is not allowed as a redirect host in the FirstSpirit server configuration.

Mithilfe des neuen Parameters cxt.platform.firstspirit.connection-timeout kann für den FragmentCreator ein Zeitlimit (in Sekunden) definiert werden, nach dem FirstSpirit-Verbindungen automatisch geschlossen werden, wenn sie nicht mehr verwendet werden.
Der Parameter kann in der Datei web.xml der WebApp-Komponente „FragmentCreator“, die in der passenden globalen WebApp für den FragmentCreator konfiguriert ist, definiert werden („FirstSpirit ServerManager / Server-Eigenschaften / Web-Applikationen“):

oder per Properties-Datei cxt-fragment-creator.properties.

Ein zu niedriger Wert kann dazu führen, dass Benutzer unerwartet abgemeldet werden. Ein hoher Wert hingegen hält viele Verbindungen aufrecht, wenn Benutzer ihren Browser schließen, ohne sich abzumelden.

Die Standardeinstellung sieht vor, dass Verbindungen nach 12 Stunden automatisch beendet werden, wenn sie nicht mehr verwendet werden.

Ausschnitt aus der Standard-web.xml:

<context-param>
 <param-name>cxt.platform.firstspirit.connection-timeout</param-name>
 <param-value>43200</param-value>
</context-param>

Folgende Module und Erweiterungen sind kompatibel mit FirstSpirit 2021-10:

Das Interface WorkflowAgent (FirstSpirit Developer-API, Package de.espirit.firstspirit.workflow) wurde um die Methode

isTransitionAllowed

erweitert.

Die Methode ermittelt, ob eine Transition von einem bestimmten User auf einem bestimmten Store-Element ausgeführt werden darf.

Die Methode getTransitionPermission (Transition transition) im Interface WorkflowPermission (FirstSpirit Access-API, Package de.espirit.firstspirit.access.store.templatestore) hingegen ermittelt zwar die Berechtigungen einer Transition, modifiziert aber potenziell das Rechtemodell und erzeugt eine neue WorkflowTransitionPermission, wenn für die betreffende Transition noch keine Rechte definiert sind. Die API-Dokumentation wurde an dieser Stelle mit dem aktuellen Release jetzt klarifiziert.
Stattdessen sollte die neue Methode isTransitionAllowed verwendet werden.

Die Methode

isWorkflowAllowed

des Interface StoreElement (FirstSpirit Access-API, Package de.espirit.firstspirit.access.store) kann vor dem Starten eines Arbeitsablaufs genutzt werden, um zu testen, ob das Starten für den betreffenden Arbeitsablauf und das betreffende Store-Element grundsätzlich erlaubt ist.

Per API können jetzt die Seitenreferenzen einer Seite mit der Convenience-Methode

<page>.getPageRefs()

ermittelt werden.

(FirstSpirit Access-API, Package de.espirit.firstspirit.access.store.pagestore, Interface Page)

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

• Spring Boot (für das MicroApp Framework)
  Aktualisierung auf Version 2.5.4

Mit dem aktuellen Release gibt es nun eine neue Methode, um in einer Vorlage aus einer Entity (die beispielsweise von der „contentSelect“-Funktion erzeugt wird) ein Dataset zu erhalten:

getDataset

Die Methode erwartet die Angabe des Referenznamens der betreffenden Tabellenvorlage in Anführungszeichen, z. B.

getDataset("products.product")

Kann das Dataset nicht ermittelt werden, wird null zurückgeliefert.

Beispiel:

$CMS_FOR(_entity, cs_press_releases)$
    $CMS_SET(_dataset, _entity.getDataset("products.product"))$
    $-- ... --$
$CMS_END_FOR$

Dabei ist cs_press_releases die Variable / der Bezeichner der contentSelect-Funktion, products.product der Referenzname der Tabellenvorlage.

Alternativ kann folgende Schreibweise verwendet werden. Bei dieser erfolgt die Umwandlung bereits beim Aufruf der FOR-Schleife.

$CMS_FOR(_dataset, cs_press_releases.map(entity->entity.getDataset("products.product")))$
    $-- ... --$
$CMS_END_FOR$

Zu weiteren Informationen siehe:

• https://docs.e-spirit.com/odfs/vorlagenentwick/vorlagensyntax/datentypen/entity/index.html
• https://docs.e-spirit.com/odfs/vorlagenentwick/vorlagensyntax/funktionen/header/contentselect/index.html

Mit dem aktuellen Release enthält die JSON-Ausgabe jetzt auch Informationen zu Gültigkeitszeiträumen von Absätzen, soweit vorhanden.
Dazu wurde das neue Attribut

lifespan

eingeführt.

Ist ein entsprechender Gültigkeitszeitraum gesetzt, wird beim Absatz das zusätzliche Attribut lifespan mit ausgegeben.

Dieses Attribut hat immer für den Startzeitpunkt einen Wert (Attribut start):

...
"lifespan": {
                  "start": "2021-10-15T14:00:00Z",
                }

Bei zeitlich unbegrenzten Gültigkeitszeiträumen wird kein Endzeitpunkt ausgegeben.
Bei zeitlich begrenzten Gültigkeitszeiträumen wird zusätzlich der Endzeitpunkt mit ausgegeben (Attribut end):

...
"lifespan": {
                  "start": "2021-10-15T14:00:00Z",
                  "end": "2021-12-31T23:59:59Z",
                 }

Beispiel-Ausgabe eines Absatzes:

{
               "fsType": "Section",
               "name": "cms_input_text",
               "displayName": "CMS_INPUT_TEXT",
               "identifier": "1df5eccf-c5ac-40ab-805a-6411c8dc3b69",
               "lifespan": {
                  "start": "2021-10-02T11:46:06Z",
                  "end": "2021-10-03T11:46:09Z"
}