Release Notes
1 Administration
1.1 Aktualisierung von integrierter Fremdsoftware
Mit dem aktuellen Release wurde folgende intern, für FirstSpirit Content Experience Tools (CXT) verwendete Software aktualisiert:
- Spring Boot
Aktualisierung auf Version 2.6.6
1.2 Logging: Log4j-Aktualisierung auf Version 2.x
FirstSpirit verwendet als Logging-Framework „Apache Log4j“. Nicht zuletzt, um vor Sicherheitslücken in integrierter Drittsoftware optimal geschützt zu sein (Stichwort: „Log4Shell“), wurde das FirstSpirit-Logging mit dem aktuellen Release jetzt auf die aktuelle Version von „Log4j 2“ aktualisiert (Version 2.17.2).
Die Versionslinie 2.x ist durch die Verwendung von asynchronen Loggern u.a. erheblich schneller als die bisher eingesetzte Version „Log4j 1“ und bietet darüber hinaus erweiterten Funktionsumfang.
In der Regel sind trotz der Implementierungsunterschiede zwischen „Log4j 1“ zu „Log4j 2“ aktuell keine Migrationsmaßnahmen durch FirstSpirit-Nutzer erforderlich (z. B. hinsichtlich der Konfiguration), wenn die Standard-Loggingfunktionalitäten von FirstSpirit genutzt werden, da die Log4j 1.2 Bridge verwendet wird (https://logging.apache.org/log4j/2.x/manual/migration.html#Log4j1.2Bridge): Mit dieser kann die bisherige API weiterverwendet werden, Methodenaufrufe werden aber größtenteils an die neue API gesendet.
In einigen Fällen kann es hinsichtlich der Fehlerprotokollierung durch das Update auf „Log4j 2“ zu einem veränderten Loglevel kommen.
Es wird empfohlen, „Log4j“ nicht direkt zu verwenden, sondern die von FirstSpirit bereitgestellten Logging-Klassen zu nutzen.
Wichtig: In einem zukünftigen Release wird der Support für „Log4j 1“ endgültig entfallen. Dann wird die Bridge entfernt und alle Verwendungen von „Log4j 1“ müssen kundenseitig auf die Erfordernisse von „Log4j 2“ umgestellt werden.
Wichtig: Bei der Aktualisierung auf „Log4j 2“ wurden bei Implementierung und Qualitätssicherung bekannte Standard-Anwendungsfälle und Standard-Konfigurationen von „Log4j “ berücksichtigt. Sollte es darüber hinaus spezielle Anwendungsfälle geben, die noch nicht berücksichtigt wurden, wenden Sie sich für Feedback an unseren e-Spirit Technical Support.
Zu weiteren Informationen zum Logging durch „Apache Log4j“ in FirstSpirit siehe https://docs.e-spirit.com/odfs/edocs/admi/konfiguration-f/konfigurationsd/konfiguration-l/index-2.html.
1.3 Module und Erweiterungen für FirstSpirit 2022.5
Folgende Module und Erweiterungen sind kompatibel mit FirstSpirit 2022.5:
| Modul- / Dateiname | Versionsnummer | Kompatibel |
FirstSpirit Aktualisierungsarchivfs-update-[version].tar.gz | 3.0.0 | - |
FirstSpirit Installationsarchiv fs-install-[version].tar.gz | 3.0.0 | - |
FirstSpirit LauncherFSLauncher.exe | 1.0.43 | ab FirstSpirit 2018-08 |
FirstSpirit Launcher JRE Modulfs-launcher-jre-[version].fsm | 1.19 | ab FirstSpirit 2020-11 |
FirstSpirit SAML Login Modulfs-saml-login-[version].fsm | 1.3 | ab FirstSpirit 2019-02 |
FSDevToolsfs-cli-[version].tar.gzfs-cli-[version].zip | 4.0.0 | ab FirstSpirit 2021-07 |
FirstSpirit Module Gradle Pluginfirstspirit-module-gradle-plugin-[version].jar | 3.0.3 | ab FirstSpirit 2019-06 |
1.4 Update von fs-cli
„fs-cli“ (FSDevTools) verwendet ab der Version 4.0.0
- „Log4j“ in der Version 2.17.2 und
- „SLF4J“ in der Version 1.7.36
Neben der entsprechenden jar-Datei müssen im lib-Verzeichnis auch aktuelle fs-cli.cmd- bzw. fs-cli.sh-Dateien verwendet werden. Die mitgelieferte Datei log4j2.xml aus dem conf-Verzeichnis muss ebenfalls verwendet werden.
2 ContentCreator
2.1 Bildzuschnitt: Der gewählte Ausschnitt ist zu klein
Beim manuellen Zuschnitt von Bildern im FirstSpirit ContentCreator wird jetzt ein entsprechender Text angezeigt, wenn der gewählte Ausschnitt zu klein ist. Neben der Zielgröße der jeweiligen Auflösung enthält der Text auch die Pixelmaße des gewählten Ausschnitts:
2.2 Element Status Provider: Anzeige des Status von referenzierten Elementen
Das Interface WorkflowGroup (Package de.espirit.firstspirit.workflow, FirstSpirit Developer-API) wurde um die optionale Methode hasReleaseStateDetection erweitert. Zusätzlich wurde in der entsprechenden WebeditElementStatusProviderPlugin.Factory eine weitere create Methode mit zusätzlichem detectReleaseState Parameter hinzugefügt. Das Verhalten für die bereits existierende Methode bleibt unverändert.
Der Gesamt-Status einer Seite wird normalerweise über die Methode getReleaseState in WebeditElementStatusProviderPlugin ermittelt. Dabei können je nach Plugin auch referenzierte Objekte der Seite berücksichtigt werden. Die zur kontextuellen Seite gehörige WorkflowGroup wird dabei in dem ermittelten Gesamt-Status angezeigt.
In speziellen Szenarien, z. B. bei der Verwendung von mehr als einer WorkflowGroup, kann es gewünscht sein, bestimmte Gruppen nicht mit dem ermittelten Gesamt-Status darzustellen. Der optionale detectReleaseState-Parameter sorgt dafür, dass der Status der Gruppe automatisch auf Basis der referenzierten Objekte ermittelt wird.
Zu weiteren Informationen siehe
- https://docs.e-spirit.com/odfs/plug-developmen/contentcreator/interactive-fea/element-status/code-example/index.html
- https://docs.e-spirit.com/odfs/dev/de/espirit/firstspirit/workflow/WebeditElementStatusProviderPlugin.html
- https://docs.e-spirit.com/odfs/dev/de/espirit/firstspirit/workflow/WebeditElementStatusProviderPlugin.Factory.html
2.3 Neue Seiten anlegen
In Projekten, in denen noch keine Seiten vorhanden sind, können jetzt auch per FirstSpirit ContentCreator die ersten Seiten erstellt werden.
Dazu wurde im Dialog „Neue Seite anlegen“ (Menü „Neu - Neue Seite anlegen“) der Menüpunkt (Wurzel-/Root-Knoten) „Menüstruktur“ ergänzt:
2.4 Verbesserung von Drag-and-drop-Mechanismen
Der FirstSpirit ContentCreator ermöglicht an vielen Stellen ein intuitives Bedienen per Drag-and-drop.
Mit dem aktuellen Release wurden einige Mechanismen verbessert, z. B.
- Ungültige Drop-Ziele werden ausgegraut.
- Ein erfolgreicher Drop in CMS_INPUT_DOM wird jetzt temporär mit grüner Hintegrundfarbe visualisiert:
3 FirstSpirit Content Experience Tools (CXT)
Aktuelle Modul-Versionen
Folgende Modul-Versionen für „FirstSpirit Content Experience Tools“ werden von FirstSpirit 2022.5 unterstützt.
| Modul- / Dateiname | Versionsnummer |
FirstSpirit CXT Plattformplatform-[version].fsm | 2.5.5 |
FirstSpirit CXT DAP Bridgedataservice-[version].fsm | 1.44.5 |
FirstSpirit CXT FragmentCreatorfragment-creator-[version].fsm | 3.4.9 |
FirstSpirit Fragment DAPfragmentdap-[version].fsm | 1.40.10 |
FirstSpirit Media DAPmediadap-[version].fsm | 1.31.5* |
FirstSpirit PageRef DAPpageref-[version].fsm | 1.9.5 |
FirstSpirit Markdown Editormarkdown-editor-[version].fsm | 1.29.4* |
FirstSpirit Tagging Editortagging-editor-[version].fsm | 1.29.4 |
FirstSpirit CXT FragmentCreator - CaaS Integrationcaas-integration-[version].fsm | 1.31.5 |
* Diese Module benötigen ab dieser Version FirstSpirit 2020-03 oder höher.
Übersicht
| ID | Beschreibung | Kategorien |
|---|---|---|
| CORE-5002 | Das FirstSpirit-Logging verwendet mit dem aktuellen Release jetzt den aktuellen Versionsstrang des Logging-Frameworks „Apache Log4j“ :„Log4j 2“. Der Support für „Log4j 1“ wird mit einem zukünftigen Release entfallen. |
Entwickler, FirstSpirit-Administrator, Integrierte Software, Monitoring |
| CORE-13597 | Es wurde ein Fehler beseitigt, der bei der Nutzung der Auto-Freigabe mit FirstSpirit Corporate Content dazu führen konnte, dass in sehr seltenen Fällen ein abonnierter Teilbaum nicht komplett freigegeben wurden. |
Arbeitsablauf, Corporate Content, Entwickler, FirstSpirit-Administrator, Redakteur |
| CORE-14049 | FirstSpirit Server werden nicht mehr im „Legacy mode“ unterstützt. Mit dem aktuellen Release wurden alle Legacy-Implementierungen und deren Verwendungen entfernt. Hinweis: Diese Änderungen haben keine Auswirkung auf die Funktionsfähigkeit von (Legacy-)Modulen. |
Entwickler, FirstSpirit-Administrator, Modul-Entwicklung, Module |
| CORE-14075 | Es wurde ein Fehler behoben, der in sehr seltenen Fällen dazu führen konnte, dass es beim Starten eines Services zu einer |
FirstSpirit-Administrator, Monitoring |
| CORE-14216 | Projektkomponenten, die aus einem Projekt entfernt wurden, sind jetzt nicht mehr im Projektexport enthalten. |
FirstSpirit-Administrator, Projektexport / Projektimport |
| CORE-14275 | Wurde der „Jetty Web Server“ ohne Portangabe konfiguriert, der entsprechende Service beim Server-Start aber trotzdem gestartet wird, wurde bisher eine |
FirstSpirit-Administrator, Webserver |
| CORE-14277 | Es werden jetzt zur schnelleren Identifizierung für weitere Dateitypen spezifische Icons angezeigt: Audio: wma, mid, m4a, mka, flac, ogg, opus, mp2, aac, Video: mkv, webm, Archive: 7z. |
ContentCreator, Medien, Medien-Verwaltung, Redakteur, SiteArchitect |
| CORE-14279 | Es wurde ein Fehler behoben, der in sehr seltenen Fällen dazu führen konnte, dass Datensätze („Entities“) beim Transport mittels FirstSpirit ContentTransport bzw. ExternalSync im Ziel mehrfach angelegt wurden. |
Content Transport, Datenbank, Datenquellen-Verwaltung, Entwickler, Externe Synchronisierung, FirstSpirit-Administrator |
| CORE-14281 | Der Element Status Provider kann nun |
Arbeitsablauf, ContentCreator, Entwickler, FirstSpirit-API |
| CORE-14284 | Für die Dauer des Aufbaus einer DAP (DataAccessPlugin)-Session werden jetzt im Log korrekte Werte protokolliert (nur für Analysezwecke im Loglevel |
FirstSpirit-Administrator, Monitoring |
| CORE-14299 | In den über das FirstSpirit ServerMonitoring herunterladbaren CSV-Dateien mit Statistik-Informationen werden nun nicht beendete Aktionen, deren Startzeitpunkt vor dem Zeitpunkt des Server-Starts liegt, nicht mehr angezeigt. |
FirstSpirit-Administrator, Monitoring, ServerMonitoring |
| CORE-14320 | FirstSpirit überprüft nun beim Start und bei jeder Änderung der Datei fs-server.conf (also der Server-Konfiguration) die Verwendung der Web-Komponenten der installierten Module. Ungültige Referenzen (z. B. in manuell gelöschten Web-Applikationen) werden dabei bereinigt. |
FirstSpirit-Administrator, Modul-Entwicklung, Module |
| CORE-14329 | Der Umgang mit Medien wurde verbessert, sodass bei den entsprechenden Zugriffen keine temporären Dateien mehr benutzt werden. |
FirstSpirit-Administrator, Medien, Monitoring, Performance |
| CORE-14337 | FirstSpirit Content Experience Tools: Aktuelle Modul-Versionen |
Entwickler, FirstSpirit Content Experience Tools (CXT), FirstSpirit-Administrator, FragmentCreator, Module |
| CORE-14367 | Diese Module und Erweiterungen sind kompatibel mit FirstSpirit 2022.5. |
Entwickler, FSDevTools, FirstSpirit-Administrator, Launcher, Module |
| CXT-2394 | Beim Bearbeiten von Absatzreferenzen im ContentCreator wurde ein Fehler behoben, der in seltenen Fällen dazu führen konnte, dass die Änderung nicht gespeichert werden konnte. |
ContentCreator, Redakteur |
| CXT-2452 | Beim Setzen oder Entfernen von Lesezeichen wurde das Logging angepasst. Aus Timing-Gründen konnte es zuvor zu unzutreffenden Meldungen vom Typ |
ContentCreator, Lesezeichen, Redakteur |
| CXT-2508 | Mit dem aktuellen Release wurden einige Drag-and-drop-Mechanismen im FirstSpirit ContentCreator verbessert. |
ContentCreator, Redakteur |
| CXT-2547 | Falls verfügbar, wird jetzt beim Aufrufen von Lesezeichen auf Seiten oder Absätzen die entsprechende Seitenreferenz statt der Seite angezeigt, so dass jetzt auch die Navigationsleiste entsprechend synchronisiert werden kann. |
ContentCreator, Lesezeichen, Navigationsansicht, Redakteur, Reports |
| CXT-2569 | Der Zuschnitt von sehr großen Bildern und / oder in vielen Auflösungen im FirstSpirit ContentCreator wurde verbessert, so dass es jetzt nicht mehr zu einem 504-Fehler / Gateway Timeout kommen kann. |
ContentCreator, Medien, Medien-Verwaltung, Redakteur |
| CXT-2571 | In Projekten, in denen noch keine Seiten vorhanden sind, können jetzt auch per FirstSpirit ContentCreator die ersten Seiten erstellt werden. Weitere Informationen können dem Kapitel „ContentCreator: Neue Seiten anlegen“ entnommen werden. |
ContentCreator, Redakteur |
| CXT-2585 | Im FirstSpirit ContentCreator werden jetzt Änderungen in Imagemaps (CMS_INPUT_IMAGEMAP) wieder korrekt erkannt. Zeitweise wurde der „Speichern“-Button bei Änderungen nicht aktiv. |
ContentCreator, Redakteur |
| CXT-2588 | Beim manuellen Zuschnitt von Bildern im FirstSpirit ContentCreator wird jetzt ein entsprechender Text angezeigt, wenn der gewählte Ausschnitt zu klein ist. |
ContentCreator, Medien, Redakteur |
| CXT-2591 | Aktualisierung von integrierter Fremdsoftware |
FirstSpirit Content Experience Tools (CXT), Integrierte Software |
| DEVEX-537 | Die von „fs-cli“ (FSDevTools) verwendeten Libraries für „Log4j“ und „SLF4J“ wurden aktualisiert. Weitere Informationen können dem Kapitel „Administration: Update von fs-cli“ entnommen werden. |
Entwickler, FSDevTools, FirstSpirit-Administrator, Integrierte Software |
| DEVEX-539 | Mit dem aktuellen Release sind wieder „fs-cli“-Aufrufe möglich (FSDevTools), die mit einem doppelten Anführungszeichen (") enden. |
Entwickler, 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 |