Release Notes FirstSpirit™ 2023.4

Release Notes

FirstSpirit™ 2023.4

1 Administration

Automatisches Löschen der Exportdatei

Beim Importieren von Projekten war die Standard-Einstellung bisher, die Exportdatei auf dem Server beizubehalten. Das Löschen der Datei musste entweder manuell erfolgen oder für ein automatisches Vorgehen aktiv eingestellt werden.

Beim Import von Projekten ist die Option zum automatischen Löschen der Exportdatei nun standardmäßig aktiviert. Damit wird der Speicherplatz auf dem Server gleich nach Import-Abschluss freigegeben.

UID=delete_server_file_after_successful_import_de

2 Administration / Module

Abkündigung von Web-Compatibility-Modul

Das Web-Compatibility-Modul (fs-web-compatibility.fsm) gewährleistet den Betrieb bestehender Web-Applikationen, die das Vorhandensein externer Klassen im fs-webrt.jar voraussetzen, beim Umstieg auf einen Isolated-Server. Zusätzlich gibt es Abhängigkeiten des Moduls, welche in fs-isolated-webrt.jar nicht mehr verfügbar sind.

Das Modul wird nur noch extrem selten eingesetzt und wurde, wie angekündigt, seit einiger Zeit nur in Ausnahmefällen aktualisiert.

Das Modul wird ab der aktuellen FirstSpirit-Version nicht mehr ausgeliefert.

Wenn das Modul noch benötigt wird, kann eine alte Version problemlos verwendet werden.

Weitere Informationen: Module: Kompatibilität sicherstellen (→Leitfaden Isolated Mode), Kapitel „Module mit Webanwendungen“.

3 ContentCreator

Unterstützung für Struktur-Variablen im ContentCreator

Struktur-Variablen können nun auch im ContentCreator bearbeitet werden.

Diese Funktionalität kann nur von Server- oder Projekt-Administratoren verwendet werden. Der Personenkreis der Administratoren kann in der TailoredUI eingeschränkt werden.

Bearbeitung von Struktur-Variablen

Im Kontextmenü der SiteStore-Ordner-Navigation wurde die Möglichkeit hinzugefügt, Struktur-Variablen zu bearbeiten:

UID=cxt_2861_1_en

Im Pop-Up-Dialog werden die Variablen aufgelistet, die für den aktuellen Ordner definiert wurden:

UID=cxt_2861_2_en

  • Neue Variablen werden mit einem „+“-Icon gekennzeichnet
  • Vererbte Variablen werden grau dargestellt
  • Vererbte, aber veränderte Variablen werden mit einem „Stift“-Icon gekennzeichnet
  • Die Spalte „Definiert für“ bezeichnet den Ordner, für den der angezeigte Wert der Variable definiert wurde
  • Wenn die Variable nicht für alle Sprachen den gleichen Wert aufweist, wird sie mit einem entsprechenden Icon gekennzeichnet

Aktionen

UID=cxt_2861_4

Bei neuen Variablen können die eingetragenen Werte überarbeitet werden. Mit einem „Mülleimer“-Icon wird die Variable gelöscht.

UID=cxt_2861_5

Bei vererbten Variablen können die ursprünglichen Werte überarbeitet werden.

UID=cxt_2861_3

Hinweis: Vererbte Werte werden nicht auf ihre Gültigkeit validiert.

Bei vererbten und bereits veränderten Variablen können die eingetragenen Werte überarbeitet werden. Mit dem „X“-Icon werden die Änderungen an den vererbten Werten zurückgesetzt: Die Variable wird in den ursprünglichen Zustand versetzt.

Variable bearbeiten

Beim Bearbeiten einer Variable wird ein Pop-Up-Dialog angezeigt:

UID=cxt_2861_6_en

Der Wert einer Struktur-Variable – einer Seiten- oder Medienreferenz – kann verändert werden, indem der exakte Wert der Variablen ins Feld „Wert“ eingetragen wird. Alternativ ist es möglich, im Suchfeld nach einem Wert zu suchen und ihn auszuwählen. Der Name der Variable wird automatisch befüllt.

„Für alle Sprachen übernehmen“: Der Wert der Variable wird für alle Sprachen übernommen. Die Option ist standardmäßig aktiv, wenn der Wert der Variable bereits in allen Sprachen gleich ist.

Variable erstellen

Beim Erstellen einer Variable wird ein Pop-Up-Dialog angezeigt:

UID=cxt_2861_7_en

Um eine Struktur-Variable anzulegen, müssen ein Name und ein Wert angegeben werden.

„Für alle Sprachen übernehmen“: Der Wert der Variable wird für alle Sprachen übernommen.

4 FirstSpirit Content Experience Tools (CXT)

Aktuelle Modul-Versionen

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

Modul- / DateinameVersionsnummer
FirstSpirit CXT Plattform
platform-[version].fsm
3.0.5
FirstSpirit CXT DAP Bridge
dataservice-[version].fsm
1.44.10
FirstSpirit CXT FragmentCreator
fragment-creator-[version].fsm
4.0.4
FirstSpirit Fragment DAP
fragmentdap-[version].fsm
1.40.17
FirstSpirit Media DAP
mediadap-[version].fsm
1.31.9*
FirstSpirit PageRef DAP
pageref-[version].fsm
1.9.9
FirstSpirit Markdown Editor
markdown-editor-[version].fsm
1.29.8*
FirstSpirit Tagging Editor
tagging-editor-[version].fsm
1.29.8
FirstSpirit CXT FragmentCreator - CaaS Integration
caas-integration-[version].fsm
1.31.9

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

5 Kompatibilität

FSDevTools in Version 4.4.1 für FirstSpirit-Version 2023.4 erforderlich

Um das „fs-cli“ (FSDevTools) mit der FirstSpirit-Version 2023.4 nutzen zu können, ist mindestens die Version 4.4.1 des „fs-cli“ erforderlich.

Kompatibilität: Die neue Version des „fs-cli“ ist weiterhin mit älteren Versionen von FirstSpirit (bis 2023.3) kompatibel.

6 Medien

Verarbeitung von SVG-Bilder

Die kürzlich mit der FirstSpirit-Version 2023.3 bekannt gegebene Änderung zur Verbesserung der Verarbeitung falsch konfigurierter SVG-Bilddateien wird in der nächsten FirstSpirit-Version 2023.4 nicht verfügbar sein. In einer späteren FirstSpirit-Version wird diese Änderung wiederhergestellt werden.

Leider haben wir festgestellt, dass die Umsetzung dieser Änderung zu einigen unerwarteten Problemen führen kann. Daher haben wir diese Änderung vorübergehend deaktiviert und weisen darauf hin, dass das Hochladen und Verwenden von SVG-Dateien mit nicht unterstützten Konfigurationen in der Version 2023.4 wieder zu einem Fehlverhalten führen könnte.

7 Modul-Entwicklung, Skripte, API

Rekursionserkennung bei der JSON-Ausgabe über die inline JSON-Funktion

Mit der aktuellen FirstSpirit-Version wurden im Rahmen einer Verbesserung der Rekursionserkennung bei der JSON-Ausgabe über die inline JSON-Funktion Änderungen vorgenommen, die zu einer Verhaltensänderung führen.

Die JSON-Funktion kann beim Rendern mehrfach auch rekursiv aufgerufen werden. Bei rekursiven Aufrufen von Absätzen und Datensätzen konnte es je nach Konfiguration des FirstSpirit-Servers entweder zu einer fehlenden Ausgabe oder zu einer OutOfMemoryException des FirstSpirit-Servers kommen.

Die Erkennung von Rekursionen beim Aufruf der JSON-Funktion wurde verbessert. Wenn eine Rekursion erkannt wird, wird die Referenz auf den Absatz oder Datensatz als Platzhalter ausgegeben und die Rekursion an der Stelle beendet.

Beim direkten Rendern von Datensätzen über den RenderingAgent ändert sich das Verhalten.

  • Bisher wurde der Datensatz trotz des Parameters dataRenderDepth=0 ausgegeben.
  • Mit der Änderung wird an der Stelle nur die Referenz auf den Datensatz ausgegeben.

Bei der Angabe von dataRenderDepth=1 (Standardwert) bleibt das Verhalten unverändert. Der Datensatz wird ausgegeben, verknüpfte Datensätze werden als Referenz ausgegeben.

Weitere Informationen siehe Erweiterte JSON-Unterstützung / Konfiguration (→Online Dokumentation FirstSpirit), Kapitel „Konfiguration“.

8 Vorlagenentwicklung

JSON-Objekt für Projekte ohne definierte Projekteinstellungsseiten-Vorlage

Wenn in einem Projekt keine Seitenvorlage für die Projekteinstellungsseite definiert wurde, so wurde bei der Ausgabe der Projekt-Einstellungen über die json-Funktion keine Ausgabe erzeugt.

Mit dem aktuellen FirstSpirit-Release wird immer ein JSON-Objekt bei der Ausgabe der Projekteinstellungsseite erzeugt. Wenn keine Seitenvorlage definiert wurde, so hat das Attribut "template" den Wert "null".

Übersicht

ID Beschreibung Kategorien
CORE-13551

Bei der Modulinstallation wurde die Fehlerbehandlung bei Ressourcenkonflikten verbessert.

Module, Server-Administrator
CORE-14890

Die API-Klassen Logger und Logging (FirstSpirit Developer-API, Package de.espirit.common.base) wurden um neue Methoden erweitert. Im Regelfall werden diese Klassen nur verwendet und nicht implementiert, daher hat diese Änderung normalerweise keine Auswirkung. Für eventuell existierende Ableitungen der Klassen sind jedoch mit dem Update Implementierungen der neuen Methoden erforderlich.

FirstSpirit-API, Logging
CORE-14914

Verbesserung der Rekursionserkennung bei der JSON-Ausgabe über die inline JSON-Funktion

Weitere Informationen können dem Kapitel „Modul-Entwicklung, Skripte, API: Rekursionserkennung bei der JSON-Ausgabe über die inline JSON-Funktion“ entnommen werden.

JSON-Unterstützung
CORE-14930

Bei der Verwendung des RenderingAgent (FirstSpirit Developer-API, Package de.espirit.firstspirit.agency) für die direkte Ausgabe von Knoten des Typs Section konnte es vorkommen, dass im Objekt #this ein unerwarteter Objekttyp vorhanden war. Der Fehler wurde behoben.

Entwickler, FirstSpirit-API
CORE-15138

Das Verhalten beim Aufräumen von Server-Verbindungen wurde verbessert.

Server-Administrator
CORE-15147

Automatisches Löschen der Exportdatei nach Abschluss des Imports

Weitere Informationen können dem Kapitel „Administration: Automatisches Löschen der Exportdatei“ entnommen werden.

Server-Administrator
CORE-15148

Wenn ContentTransport-Features lokal gespeichert wurden, konnten Sonderzeichen im Dateinamen zu einer Inkompatibilität mit dem Dateisystem führen. Der Fehler wurde behoben: Sonderzeichen im Dateinamen werden beim Speichern entfernt.

Content Transport
CORE-15157

Bei der Verwendung von Connections innerhalb des Servers gab es ein potentielles Memory-Leak. Das Problem wurde behoben.

Server-Administrator
CORE-15169

Der Umgang mit Filehandles wurde weiter verbessert.

Server-Administrator
CORE-15170

Bei einer Auslastung von ThreadPool-Queues des FirstSpirit-Servers von mindestens 90%, bekommt der Server den Status „Degraded“. Die Recherche solcher Vorfälle ist im server-incidents.log möglich (Umschlag-Icon, Informationen siehe: FirstSpirit ServerMonitoring / FirstSpirit / Monitoring / Kennzahlen (→Dokumentation für Administratoren)).

ServerMonitoring
CORE-15176

Das Web-Compatibility-Modul (fs-web-compatibility.fsm) wird nicht mehr ausgeliefert.

Weitere Informationen können dem Kapitel „Administration / Module: Abkündigung von Web-Compatibility-Modul“ entnommen werden.

Isolated mode, Module
CORE-15188

FirstSpirit Content Experience Tools: Aktuelle Modul-Versionen

Weitere Informationen können dem Kapitel „FirstSpirit Content Experience Tools (CXT): Aktuelle Modul-Versionen“ entnommen werden.

FirstSpirit Content Experience Tools (CXT)
CORE-15202

Bei der Verwendung der Funktionalität „Externe Synchronisierung“ bzw. FSDevTools (fs-cli) konnte es in seltenen Fällen vorkommen, dass Displaynamen nicht korrekt exportiert wurden. Der Fehler wurde behoben.

Externe Synchronisierung
CORE-15227

Ein JSON-Objekt wird bei der Ausgabe der Projekteinstellungsseite immer erzeugt, auch wenn der Projekteinstellungsseite keine Seitenvorlage zugewiesen ist.

Weitere Informationen können dem Kapitel „Vorlagenentwicklung: JSON-Objekt für Projekte ohne definierte Projekteinstellungsseiten-Vorlage“ entnommen werden.

JSON-Unterstützung
CORE-15250

Die kürzlich mit der FirstSpirit-Version 2023.3 bekannt gegebene Änderung zur Verbesserung der Verarbeitung falsch konfigurierter SVG-Bilddateien (CORE-15042) wird in der nächsten FirstSpirit-Version 2023.4 nicht verfügbar sein. In einer späteren FirstSpirit-Version wird diese Änderung wiederhergestellt werden.

Weitere Informationen können dem Kapitel „Medien: Verarbeitung von SVG-Bilder“ entnommen werden.

Medien-Verwaltung
CXT-2681

Anlegen und Bearbeiten von Struktur-Variablen im ContentCreator

Weitere Informationen können dem Kapitel „ContentCreator: Unterstützung für Struktur-Variablen im ContentCreator“ entnommen werden.

ContentCreator
CXT-2823

Im ContentCreator wurden Deep-Links nicht berücksichtigt, das gewünschte Element wurde nicht angezeigt. Das Problem wurde behoben.

ContentCreator
CXT-2827

Bei Verschiebe-Operationen in der Navigation wurde kein Event für in der WE_API registrierte NavigationChangeListener versendet.

ContentCreator
CXT-2850

Wenn beim Start der CXT-Plattform keine Verbindung zum FirstSpirit-Server aufgebaut werden konnte, so führte dies zu Authentifizierungsproblemen in der CXT-Plattform. Das Problem wurde behoben: Wenn der FirstSpirit-Server innerhalb von 5 Minuten wieder erreichbar ist, kommt es zu keinen Authentifizierungsproblemen.

FirstSpirit Content Experience Tools (CXT)
DEVEX-608

Um das „fs-cli“ (FSDevTools) mit der aktuellen FirstSpirit-Version 2023.4 nutzen zu können, ist mindestens die Version 4.4.1 des „fs-cli“ erforderlich.

Weitere Informationen können dem Kapitel „Kompatibilität: FSDevTools in Version 4.4.1 für FirstSpirit-Version 2023.4 erforderlich“ entnommen werden.

FSDevTools

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
Datenbank-Layer Oracle Database 11g/12c 2020-12 2025-05
FirstSpirit Access-API: redirectTemplateLogToDefaultLog() (Interface RenderingAgent.Renderer) 2021-05
Support für Log4j 1 2022-05 2024-06