Release Notes FirstSpirit™ 2023.6

Release Notes

FirstSpirit™ 2023.6

1 Administration

1.1 Aktualisierung von integrierter Fremdsoftware

Mit dem Release 2023.6 sind folgende intern verwendete Software aktualisiert worden.

  • ASM (Bibliothek für die Analyse und Modifikation von Java-Bytecode)
    Aktualisierung von Version 9.3 auf Version 9.5
  • Google Guava
    Aktualisierung von Version 27.0 auf Version 31.1

1.2 Logging: Log4j2-Konfigurationsdateien im XML-Format

Im FirstSpirit-Logging wird ab der FirstSpirit-Version 2022.5 der Versionsstrang „Log4j 2“ des Logging-Frameworks „Apache Log4j“ verwendet.

Mit dem aktuellen FirstSpirit-Release werden nun auch „Log4j 2“-Konfigurationsdateien im XML-Format unterstützt. Die Beispielkonfigurationen befinden sind nach dem Update des FirstSpirit-Servers im Ordner <FirstSpiritROOT>/conf/conf-all (fs-logging*.xml.default.txt).

Die neue „Log4j 2“-Konfiguration hat Vorrang vor der alten „Log4j 1“-Konfiguration.

Bei FirstSpirit-Servern, auf denen die FirstSpirit-Version 2023.6 oder neuer installiert wird, wird standardmäßig „Log4j 2“ verwendet. Bei FirstSpirit-Servern, auf denen ältere FirstSpirit-Versionen installiert sind, muss die Konfiguration angepasst werden, um von „Log4j 1“ zu „Log4j 2“ zu wechseln.

Hinweis: Mischkonfigurationen sind möglich. So kann z. B. das DEBUG-Logging mit „Log4J 1“ und das INFO-Logging mit „Log4J 2“ konfiguriert werden.

Wichtig: In einem zukünftigen Release wird der Support für „Log4j 1“ endgültig eingestellt. Crownpeak empfiehlt, die Konfiguration frühzeitig auf „Log4j 2“ umzustellen.

Für weitere Informationen, siehe Log4j 2 Configuration.

1.3 Repository-Kompression mit LZ4

Für eine bessere Server-Performance wird mit der aktuellen FirstSpirit-Version wird das Repository neuer Projekte standardmäßig mit dem LZ4-Kompressionsalgorithmus komprimiert. Die kleinere Größe der komprimierten Repository-Datenbank benötigt weniger Filehandles und im komprimierten Datenbank-Cache können mehr Daten zwischengespeichert werden.

Der Standardwert kann mit dem neuen Parameter repository.defaultCompressor in der Konfigurationsdatei fs-server.conf konfiguriert werden.

Mögliche Werte sind:

LZ4 (Standard):

repository.defaultCompressor=de.espirit.firstspirit.storage.backend.LZ4Compressor

Deflate

repository.defaultCompressor=de.espirit.firstspirit.storage.backend.DeflaterCompressor

[keiner]

repository.defaultCompressor=
Ein geänderter Parameter wirkt sich nur auf neu angelegte Projekte aus.

2 Administration / Module

Herunterladen von auf dem FirstSpirit-Server installierten Modulen

Server-Administratoren haben nun die Möglichkeit, Module, die auf dem FirstSpirit-Server installiert sind, unter „Rechtliche Hinweise“ auf der Startseite herunterzuladen:

UID=rechtliche_hinweise_1

Hinweis: Systemmodule können auf diese Weise nicht heruntergeladen werden.

3 FirstSpirit Content Experience Tools (CXT)

Aktuelle Modul-Versionen

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

Modul- / DateinameVersionsnummer
FirstSpirit CXT Plattform
platform-[version].fsm
3.0.9
FirstSpirit CXT DAP Bridge
dataservice-[version].fsm
1.44.12
FirstSpirit CXT FragmentCreator
fragment-creator-[version].fsm
4.0.6
FirstSpirit Fragment DAP
fragmentdap-[version].fsm
1.40.19
FirstSpirit Media DAP
mediadap-[version].fsm
1.31.11
FirstSpirit PageRef DAP
pageref-[version].fsm
1.9.11
FirstSpirit Markdown Editor
markdown-editor-[version].fsm
1.29.10
FirstSpirit Tagging Editor
tagging-editor-[version].fsm
1.29.10
FirstSpirit CXT FragmentCreator - CaaS Integration
caas-integration-[version].fsm
1.31.11

4 Vorlagenentwicklung

Bilder: Verwerfen der Metadaten des Originalbildes für automatisch erzeugte Bilddateien

Bilder werden beim Upload nach FirstSpirit zunächst unverändert hinsichtlich Format und Auflösung im Projekt abgelegt (Auflösung „Original“). Bei bestimmten Aktionen werden (basierend auf den ursprünglichen Bilddaten) jedoch automatisch neue Bilddateien von FirstSpirit erzeugt, beispielsweise:

  • beim Erzeugen eines Vorschaubilds
  • beim Erzeugen neuer Auflösungen
  • bei der Verwendung einer automatisch generierten Auflösung
  • bei einem Bildzuschnitt (im FirstSpirit ContentCreator oder SiteArchitect)
Diese Erzeugung kann über über die benutzerdefinierte Projekteigenschaft

ImageWriteParams

beeinflusst werden (FirstSpirit Access-API, Package de.espirit.firstspirit.access.project, Interface Project, Methode setCustomProperties). Beispielsweise kann die Kompressionsrate von Bildern konfiguriert werden, um bei der Erzeugung eine bessere Bildqualität oder eine geringere Dateigröße zu erreichen.

Mit dem aktuellen Release ist es jetzt zusätzlich möglich, mithilfe des Parameters discardMetadata die Metadaten des Originalbildes (bspw. EXIF-Informationen) zu verwerfen. Standardmäßig werden diese übernommen.

Im folgenden Beispiel werden für alle Bilder bis auf PNGs die Metadaten verworfen.

project = context.getProject();
project.lock();
properties = new java.util.LinkedHashMap();
properties.put("default.discardMetadata", "true");
properties.put("default.png.discardMetadata", "false");
project.setCustomProperties("ImageWriteParam", properties);
project.save();
project.unlock();

Zu weiteren Informationen siehe Dokumentation zu ImageWriteParam.

Übersicht

ID Beschreibung Kategorien
CORE-14888

In Projekten werden bei der Vorschau-Generierung in einigen Fällen FormData-Objekte von StoreElementen verwendet. Dies wird nun für die Identifikation solcher Datenstrukturen in der editorId-Funktion unterstützt.

Generierung, Vorlagenentwicklung
CORE-14921

Ab dem aktuellen FirstSpirit-Release werden „Log4j 2“-Konfigurationsdateien im XML-Format unterstützt.

Weitere Informationen können dem Kapitel „Administration: Logging: Log4j2-Konfigurationsdateien im XML-Format“ entnommen werden.

FirstSpirit-Administrator, Logging
CORE-15101

Die Standardwerte für die integrierte Vorschau von Medien wurden angepasst. Das Bild-Format SVG ist jetzt in der Liste der Dateierweiterungen für die Browser-Engine und das Bild-Format WebP in der Liste der Dateierweiterungen für die integrierte Bild-Ansicht enthalten. Die Standardwerte werden nur bei neuen Projekten oder bei einer Wiederherstellung der Standard-Einstellungen angewendet (siehe FirstSpirit ServerManager / Projekteigenschaften / Client-Applikationen (→Dokumentation für Administratoren)).

Medien, SiteArchitect, Vorschau
CORE-15113

Bei der Vorschau-Anzeige konnte es zu einem Fehlverhalten kommen, wenn die Vorschau auf einem Remote-Projekte basierte oder Remote-Medien enthielt. Das Problem wurde behoben.

ContentCreator, Remote-Zugriff, Vorschau
CORE-15149

Mit der aktuellen FirstSpirit-Version ist das Modul „FirstSpirit Agency Support“ kein Systemmodul mehr und somit kann deinstalliert werden.

Server-Administrator
CORE-15151

Mit der aktuellen JxBrowser-Integration existierten Einschränkungen bei der Verwendung der JC_API (Interface JavaClientApi, Package de.espirit.firstspirit.client.gui). Die Einschränkungen wurden behoben.

FirstSpirit-API
CORE-15257

Mittels der Projekteigenschaft ImageWriteParam können für automatisch erzeugte Bilddateien die Metadaten des Originalbildes (bspw. EXIF-Informationen) verworfen werden.

Weitere Informationen können dem Kapitel „Vorlagenentwicklung: Bilder: Verwerfen der Metadaten des Originalbildes für automatisch erzeugte Bilddateien“ entnommen werden.

Entwickler, Medien
CORE-15267

Es konnte in sehr seltenen Fällen vorkommen, dass Einträge in der fs-server-aux.conf nach einem Server-Neustart nicht berücksichtigt wurden. Das Problem wurde behoben.

Server-Administrator
CORE-15273

Aktualisierung von integrierter Fremdsoftware

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

Integrierte Software
CORE-15285

Server-Administratoren können nun auf dem FirstSpirit-Server installierte Module unter „Rechtliche Hinweise“ auf der Startseite herunterladen.

Weitere Informationen können dem Kapitel „Administration / Module: Herunterladen von auf dem FirstSpirit-Server installierten Modulen“ entnommen werden.

Module
CORE-15298

Bei der Verwendung des SiteArchitect mit bestimmten Versionen von Dritt-Bibliotheken (z.B. Apache commons-lang3) konnten auf dem Server-Scope Problemen auftreten, z.B. bei der Auflistung von Suchergebnissen. Die Fehleranfälligkeit wurde reduziert. Modulentwicklern wird weiterhin empfohlen, Abhängigkeiten im Server-Scope möglichst zu vermeiden.

Entwickler, Modul-Entwicklung
CORE-15326

Das Repository neuer Projekte wird standardmäßig mit dem LZ4-Algorithmus komprimiert.

Weitere Informationen können dem Kapitel „Administration: Repository-Kompression mit LZ4“ entnommen werden.

Repository, Server-Administrator
CORE-15337

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-15354

Das BerkeleyUtil.jar wird nicht mehr signiert.

Datenbank
CXT-2870

Geöffnete Skript-Formulare lassen sich nun auch mit den ursprünglich angezeigten Werten speichern.

ContentCreator
CXT-2881

Die Projekt-Startseite wird wieder standardmäßig in der Master-Sprache des Projekts geöffnet. Die Oberflächen-Spracheinstellung wird nicht mehr berücksichtigt.

ContentCreator

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