Release Notes
1 Administration
1.1 Advanced URL Creator: Optimierung für den URL-Parameter useWelcomeFilenames
Wenn eine Content-Projektionsseite als Startseite eines Ordners gesetzt ist, wurde diese bei entsprechender Konfiguration des „Advanced URL Creators“ (Parameter useWelcomeFilenames) bisher nicht mit einem „Welcome-Filename“ (z.B. index.html) versehen.
Dieses Verhalten wurde geändert, sofern die definierte Anzahl der Einträge pro Seite ungleich 1 ist. In diesem Fall wird die [erste] Seite der Content-Projektion nun mit dem „Welcome-Filename“ versehen.
1.2 Ankündigung: Java 17
Seit dem Release 2022.3 ist Java 17 offiziell für die Verwendung mit FirstSpirit freigegeben.
Beginnend mit dem FirstSpirit-Release 2023.1 ändert sich die empfohlene Java-Version für den Betrieb von FirstSpirit auf Java 17.
1.3 Derby-Layer deaktivierbar
Das Anlegen von Derby-Layern lässt sich jetzt mit
internalDB.hide=true in der fs-server.conf verhindern.
So werden in der GUI die Stellen ausgeblendet, an denen eine Derby DB konfiguriert werden kann. Eine versehentliche Nutzung dieser für den produktiven Einsatz nicht geeigneten Datenbank wird somit verhindert.
1.4 Import von Projekten per fs-cli (FSDevTool) als Projekt-Administrator
Mit dem aktuellen FirstSpirit Release ist es nun möglich Projekte per fs-cli (FSDevTool) als Projekt-Administrator zu importieren.
Zuvor war das nur für Server-Administrator möglich.
Über den Parameter devProjectAdminPermissions=true in der fs-server.conf kann konfiguriert werden, dass Projekt-Administratoren eines beliebigen Projektes auf dem Server weitere Projekte importieren dürfen. Dies kann per API oder über fs-cli (Befehle project import oder import mit Angabe eines neuen Projektnamens) erfolgen. Der entsprechende Benutzer wird diesem Projekt automatisch als Projekt-Administrator hinzugefügt.
Hinweis: Der Parameter erlaubt es Projekt-Administratoren nicht, ein neues Projekt über den FirstSpirit ServerManager anzulegen.
2 Administration / Module
Konflikterkennung bei Modul-Resourcen mit Server-Scope
Mit dem aktuellen FirstSpirit Release wurde die Erkennung von Konflikten verbessert, die durch Modul-Resourcen im Server-Scope verursacht werden.
Die Konflikt-Erkennung erfolgt bei der Installation von Modulen und Ergebnisse werden entsprechend geloggt und visualisiert.
ServerManager Modul-Übersicht
In der Übersichtsliste der Module („ServerManager / Server / Eigenschaften / Module“) werden nun Probleme mit und zwischen den Modulen visualisiert.

ServerManager Modul-Übersicht

INFO: Module, die Ressourcen auf den globalen Classpath legen, die aber von keinem anderen Modul benötigt werden.
Resource may influence other modules (INFO)
Das Modul bringt generell eine globale Ressource mit, die aber (noch) kein anderes Modul bringt.
Unnamed resource found (INFO)
Das Modul bringt eine globale Ressource mit, die kein "name" Attribut hat, und somit nicht identifizierbar oder vergleichbar ist.

WARN: Es wird auf Probleme hingewiesen, die Auswirkungen auf die Funktionalität von FirstSpirit oder den entsprechenden Modulen haben können. Entweder wurden hier FirstSpirit Jars eingebunden oder Ressourcen auf den globalen Classpath gelegt, die auch von anderen Modulen mitgebracht werden.
Resource may negatively impact other modules (WARN)
Das Modul bringt eine globale Ressource mit, die von mindestens einem Modul ebenfalls mitgebracht wird.
Module may be negatively impacted by global resources (WARN)
Das Modul bringt eine private Ressource mit, die zusätzlich von einem anderen Modul als globale Ressource mitgebracht wird.
FirstSpirit artifact detected (WARN)
Das Modul bringt ein FirstSpirit Artefakt mit.

Ein gelbes Ausrufezeichen wird angezeigt, wenn ein Modul Ressourcen auf eine Art einbindet, die zukünftig nicht mehr unterstützt werden wird (legacy Ressourcen).
Legacy resource found (WARN)
Das Modul bringt eine Legacy Ressource mit.
Hinweis: Es wird immer nur das Symbol mit dem höchsten Schweregrad angezeigt.
Über die Schaltfläche „Ressource-Konflikte anzeigen“ kann man sich entsprechende Konflikte anzeigen lassen.
3 Externe Synchronisierung / Content Transport
FSDevTools-Kommandos für ContentTransport
Das Kommandozeilenwerkzeug FSDevTools vereinfacht Export- und Import-Operationen zwischen einem FirstSpirit-Projekt und dem Dateisystem über vordefinierte Kommandos. Ab der FSDevTools-Version 4.1.0 wird die Funktionalität „FirstSpirit ContentTransport“ unterstützt.
Es ist nun über das Kommando feature möglich,
- sich die Features eines Projektes anzeigen zu lassen (
list), - Features herunterzuladen (
download), - Features zu analysieren, ob diese in ein Projekt importiert werden können (
analyze), - Features in ein Projekt zu importieren (
import).
Desweiteren ist es ab der FSDevTools-Version 4.3.0 möglich, die Revision eines Features anzupassen (revision), um so den Download der darin enthaltenen Daten mit einer beliebigen Revision zu ermöglichen.
Die Dokumentation der einzelnen Befehle und ihrer Parameter findet sich wie üblich im HTML-Format im Release unter docs/index.html oder kann über die Kommandozeile (fs-cli help feature) aufgerufen werden.

4 FirstSpirit Content Experience Tools (CXT)
Aktuelle Modul-Versionen
Folgende Modul-Versionen für „FirstSpirit Content Experience Tools“ werden von FirstSpirit 2023.1 unterstützt.
| Modul- / Dateiname | Versionsnummer |
FirstSpirit CXT Plattformplatform-[version].fsm | 3.0.1 |
FirstSpirit CXT DAP Bridgedataservice-[version].fsm | 1.44.9 |
FirstSpirit CXT FragmentCreatorfragment-creator-[version].fsm | 4.0.1 |
FirstSpirit Fragment DAPfragmentdap-[version].fsm | 1.40.14 |
FirstSpirit Media DAPmediadap-[version].fsm | 1.31.8* |
FirstSpirit PageRef DAPpageref-[version].fsm | 1.9.8 |
FirstSpirit Markdown Editormarkdown-editor-[version].fsm | 1.29.7* |
FirstSpirit Tagging Editortagging-editor-[version].fsm | 1.29.7 |
FirstSpirit CXT FragmentCreator - CaaS Integrationcaas-integration-[version].fsm | 1.31.8 |
* Diese Module benötigen ab dieser Version FirstSpirit 2020-03 oder höher.
5 Modul-Entwicklung, Skripte, API
FirstSpirit Module Gradle Plugin öffentlich auf GitHub
Das „FirstSpirit Module Gradle Plugin“ ist jetzt öffentlich auf GitHub verfügbar. Im Repository (https://github.com/e-Spirit/firstspirit-module-gradle-plugin) befindet sich neben dem gesamten Quellcode auch die ausführliche README zur Verwendung sowie diverse Beispielprojekte.
Übersicht
| ID | Beschreibung | Kategorien |
|---|---|---|
| CORE-14695 | Das Verhalten bei der Verwendung von „Advanced URL Creator“ wurde optimiert. |
Advanced URL, Generierung |
| CORE-14735 | Mit dem FirstSpirit-Release 2023.1 ändert sich die empfohlene Java-Version für den Betrieb von FirstSpirit auf Java 17. Weitere Informationen können dem Kapitel „Administration: Ankündigung: Java 17“ entnommen werden. |
Java |
| CORE-14866 | Die Methode |
FirstSpirit-API |
| CORE-14903 | Die Lizenzinformationen auf der FirstSpirit Startseite wurden erweitert und beinhalten nun die verfügbaren Versionsinformationen zu den eingebundenen Bibliotheken und die Versionsnummern aller installierten Module. |
FirstSpirit Startseite, Lizenz |
| CORE-14908 | Bei der Verwendung der Funktionalität „Externe Synchronisierung“ werden die Daten nun bereits beim Export von veralteten Informationen (z. B. Rechte von gelöschten Gruppen) bereinigt. |
Externe Synchronisierung |
| CORE-14909 | Das Importieren von Projekten per fs-cli (FSDevTool) ist nun auch als Projekt-Administrator möglich. |
FSDevTools, FirstSpirit-Administrator |
| CORE-14912 | Das Anlegen von Derby-Layern lässt sich jetzt mit dem Parameter |
Datenbank, FirstSpirit-Administrator |
| CORE-14928 | Mit dem aktuellen FirstSpirit Release wurde die Erkennung von Konflikten verbessert, die durch Modul-Resourcen im Server-Scope verursacht werden. |
FirstSpirit-Administrator, Module |
| CORE-14964 | Wenn ein Auftrag abgebrochen ist und eine Aktion darin sich nicht innerhalb von 5 Minuten beendet, so wird eine FATAL Fehlermeldung erzeugt. Um die Analyse dieses Problems zu erleichtern, wird nun der Stacktrace der Auftragsaktion mit ausgegeben. |
FirstSpirit-Administrator, ServerMonitoring |
| CORE-14988 | FirstSpirit Content Experience Tools: Aktuelle Modul-Versionen |
FirstSpirit Content Experience Tools (CXT) |
| CORE-14992 | Im FirstSpirit ServerManager wurde das Laden von Benutzerlisten verbessert (z. B. in dem Dialog „Benutzer/Bearbeiten“ oder beim Hinzufügen von Benutzern zu einem Projekt). Die initiale Wartezeit wurde deutlich reduziert. |
FirstSpirit-Administrator |
| DEVEX-563 | Ab dem FSDevTools-Release 4.1.0 wird die Funktionalität „FirstSpirit ContentTransport“ unterstützt. |
FSDevTools |
| DEVEX-578 | Das „FirstSpirit Module Gradle Plugin“ ist jetzt öffentlich auf GitHub verfügbar. |
Entwickler |
| DEVEX-581 | Beim Update oder Installation von Modulen über „fs-cli“ (FSDevTools 4.2.0) führen Fehler nun nicht mehr zum sofortigen Abbruch der gesamten Aktion. Im Log werden entsprechende Fehler gesammelt ausgegeben. |
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 |