Release Notes

Wie auch der FirstSpirit-Kern wird die Verwendung von Fremdkomponenten einer intensiven Qualitätssicherung unterzogen. Eine Fülle an unterstützten Betriebssystemen, Java-Versionen, Schnittstellen zu Fremdsystemen sowie deren Kombinations- und Konfigurationsmöglichkeiten führt zu einer extrem hohen Testkomplexität. Um auf Dauer eine gute Wartbarkeit und Nachhaltigkeit bei der Weiterentwicklung von FirstSpirit gewährleisten zu können, wird der Support von nicht mehr unterstützten und / oder verwendeten Komponenten in regelmäßigen Abständen abgekündigt. Während einer Übergangszeit haben Kunden und Partner ausreichend Zeit, den Betrieb – auch mit Unterstützung durch den e-Spirit Technical Support – auf alternative Lösungen umzustellen. In einem finalen Schritt wird dann softwareseitig der Code für die nicht mehr unterstützten Komponenten entfernt.

Für den integrierten Webserver „InternalJetty“ wurde dieser letzte Schritt jetzt mit dem aktuellen FirstSpirit Release vorgenommen.
Die Funktionalität wird seit August 2018 (2018-08) nicht mehr unterstützt und ist bereits seit längerer Zeit e-Spirit-seitig abgekündigt.

Als Ersatz wird die Verwendung eines externen Webservers (speziell „Apache Tomcat“) empfohlen.
Für Neu-Installationen von FirstSpirit ab Release 2022.1 wird standardmäßig der „Jetty Web Server“ als Webserver verwendet. Dabei handelt es sich um ein in FirstSpirit enthaltenes Systemmodul („FirstSpirit Jetty Server“). Eine Konfiguration kann über dieses Modul vorgenommen werden (FirstSpirit ServerManager / Module / Server-Eigenschaften / „FirstSpirit Jetty Server“).

Hinweise für bestehende FirstSpirit-Installationen (Migration)
Eine Migration betrifft nur On-Premises-Kunden und sollte bereits vollzogen sein.
In dem seltenen Fall, dass der InternalJetty noch für eine oder mehrere Web-Anwendungen konfiguriert ist, wurde FirstSpirit-Administratoren bisher auf der Startseite des FirstSpirit-Servers ein entsprechender Hinweis angezeigt („Verwendung(en) des internen Jetty erkannt...“).
Wird nicht bereits ein externer Webserver verwendet, sollte vor einem Update auf FirstSpirit 2022.1 der „InternalJetty“ deaktiviert werden (Parameter INTERNAL_SERVLET_ENGINE=0 in der Datei fs-server.conf) und „FirstSpirit Jetty Server“ als Webserver aktiviert und konfiguriert werden.
Mit einem Update auf FirstSpirit 2022.1 werden Web-Anwendungen, die noch den „InternalJetty“ verwenden, automatisch auf den Webserver migriert, der für die FirstSpirit Standard-Web-Anwendung „FirstSpirit Startseite“ (fs5root) konfiguriert ist. Ist dies nicht möglich, werden die Web-Anwendungen auf den „FirstSpirit Jetty Server“ migriert.
Zu weiteren Informationen für die Migration eines Webservers siehe https://docs.e-spirit.com/odfs/edocs/admi/firstspirit-ser/server-eigensch/webserver/#migrieren_eines_webservers.

Fallback-Generierungsverzeichnis
Ist kein Webserver konfiguriert oder für Webserver vom Typ „Tomcat“ kein Webverzeichnis angegeben (= das Feld „Webverzeichnis“ ist leer), erfolgt eine Generierung (wie bisher) automatisch in das Verzeichnis

~/web/fs5staging

Das Verzeichnis ~/web diente bislang als Generierungsverzeichnis des „InternalJetty“ und soll künftig komplett entfallen.
Daher ist geplant, auch das Fallback-Generierungsverzeichnis mit einem zukünftigen Release entsprechend anzupassen.
Um bereits jetzt einfacher ermitteln zu können, ob das Verzeichnis ~/web noch in Projekten verwendet wird, wird mit FirstSpirit 2022.1 im Fallback-Fall Folgendes im Log festgehalten (Log-Level INFO):

Fallback to web directory:[...]

Entfernen von nicht mehr benötigten Parametern und Dateien
Folgende Parameter in der Datei fs-server.conf werden nicht mehr benötigt und sollten entfernt werden, wenn der „InternalJetty“ nicht (mehr) verwendet wird:

INTERNAL_SERVLET_ENGINE

# root directory of all web applications
WEB_DIR

# WEBAPP_xyz_PATH: directory of this web application
WEBAPP_ROOT_PATH
WEBAPP_WEBEDIT5_PATH
WEBAPP_WEBMON_PATH
WEBAPP_STAGING_PATH
WEBAPP_PREVIEW_PATH

WEBAPP_WEBEDIT_PATH

Ebenso wird die Datei fs-webapp.xml nicht mehr benötigt und kann entfernt werden.

Folgende Module und Erweiterungen sind kompatibel mit FirstSpirit 2022.1:

Mit FirstSpirit 2021-09 wurde das Release-Intervall von FirstSpirit von einmal monatlich auf alle 4 Wochen geändert.
Mit dem Jahreswechsel zu 2022 wurde jetzt die Bezeichnung der Releases an diese Gegebenheit angepasst: Um Releases flexibler gestalten zu können, orientiert sich die Release-Bezeichnung jetzt nicht mehr an der Monatszahl (z. B. FirstSpirit 2021-12), sondern verwendet einen durchgängigen Zähler. Die Jahreszahl wird durch einen Punkt von diesem Zähler getrennt, z. B.

2022.1

für das erste Release des Jahres 2022.

Der Release-Name wird an den bekannten Stellen, z. B. in Info-Dialogen, verwendet.

Informationen zu neuen Releases erhalten Sie wie bisher in der Community.
FirstSpirit-Instanzen von Cloud-Kunden werden automatisch auf das jeweils neueste Release aktualisiert (im Rahmen der sogenannten „Patch Days“).

Die Navigationsleiste, die an der linken Bildschirmseite geöffnet werden kann, bildet die Struktur der Website (Register „Navigation“) bzw. der aktuell gewählten Seite (Register „Seite“) hierarchisch und übersichtlich in einer Baumstruktur ab.

Zu den Elementen der Navigationsleiste werden unterschiedliche Informationen in Form von Icons visualisiert, z. B. der Arbeitsablauf-Zustand, ob Metadaten gesetzt sind usw.
Mit dem aktuellen Release wurde die Darstellung überarbeitet:

• Während die Element-Typ-Icons weiterhin vor dem jeweiligen Knoten angezeigt werden, werden für eine bessere Übersichtlichkeit alle weiteren Icons jetzt hinter dem Element angezeigt.
• Das Design einiger Icons wurde marginal überarbeitet.

Übersicht über einige Visualisierungen:

freigegeben	keine spezielle Visualisierung
bearbeitet / verändert
im Arbeitsablauf
Startknoten
versteckt
Metadaten definiert

Ist ein entsprechender Arbeitsablauf für das Projekt konfiguriert (FirstSpirit ServerManager / Projekteigenschaften / Optionen / Arbeitsablauf zum Löschen von Elementen), können jetzt auch Menüebenen direkt in der Navigationsleiste gelöscht werden, und zwar über die Aktion „Löschen“.

Die Funktionalität „Tailored UI“ ermöglicht das projektspezifische Anordnen, Ausblenden, Deaktivieren von Funktionen im ContentCreator. Auf diese Weise kann die Oberfläche des ContentCreator komfortabel an die Erfordernisse eines jeden Projekts sowie der Redakteurinnen angepasst werden. Die Konfiguration erfolgt über die Projekt-Komponente „CXT ContentCreator: Feature Configuration ProjectApp“ („FirstSpirit ServerManager / Projekteigenschaften / Projekt-Komponenten“).

Bislang wirkte sich die Konfiguration auf alle User des betreffenden Projekts aus. Mit dem aktuellen Release kann die Konfiguration auf bestimmte User-Gruppen beschränkt werden.

Dazu wurde der entsprechende Konfigurationsdialog jetzt erweitert und marginal angepasst:

Konfigurationsdialog
Standardmäßig gilt die „Default Availability“ für die gewählte Funktion. In der Regel ist die Funktion damit für alle User des Projekts verfügbar / verwendbar.

Über die Optionen

• „Available for all users“
• „Available for selected groups only“

kann jetzt zwischen einer Verfügbarkeit für alle User einerseits und für User bestimmter Gruppen andererseits gewählt werden.

Available for all users: Die Funktion ist für alle User des Projekts verfügbar.

Available for selected groups only: Die Funktion ist auf (eine bzw. mehrere) User-Gruppe(n) beschränkt. Die gewünschten Gruppen können über das Plus-Icon gewählt werden. Dabei stehen alle Gruppen zu Verfügung, die für das Projekt definiert sind. Siehe dazu auch Abschnitt Dialog „Add groups“.
Sind Gruppen definiert (es werden Gruppen in der Box angezeigt), werden diese nur ausgewertet, wenn die Option „Available for selected groups only“ aktiviert ist.
Sind keine Gruppen definiert (es werden keine Gruppen in der Box angezeigt), ist die Option „Available for selected groups only“ aber aktiviert, so ist die Funktion für keinen User verfügbar („unavailable“).

Dialog „Add groups“
Die Liste der Gruppen im Dialog „Add groups“ ist alphabetisch sortiert. Externe Gruppen sind am Ende der Liste zu finden.
Gruppen, die nicht mehr gültig sind (z. B. gelöscht wurden), werden mit roter Schrift angezeigt.

Konfiguration auf Serverebene
Im betreffenden Konfgurationsdialog werden im Dialog „Add groups“ alle externen Gruppen bekannter Projekte angeboten.

Ob Gruppenbeschränkungen für eine Funktion vorgenommen wurden, kann in der Übersicht abgelesen werden.

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

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

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

Die neue Methode .getGid des Interfaces GidAgent (FirstSpirit Developer-API, Package de.espirit.firstspirit.common) ermöglicht die Ermittlung der GID von Elementen.

Wenn bei der JSON-Generierung die Ausgabe von Metadaten aktiviert wurde, über

$CMS_SET(#global.json.metaDataRendering, true)$

so werden diese nun auch für Absätze entsprechend mit ausgegeben, z. B.

...
 "meta_field": {
         "fsType": "CMS_INPUT_TEXT",
         "name": "meta_field1",
         "value": "content_value1"
      }
...