Release Notes FirstSpirit™ 2023.1

Release Notes

FirstSpirit™ 2023.1

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
ServerManager Modul-Übersicht

UID=sm_info

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.

UID=sm_rot

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.

UID=sm_gelb

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.

UID=fs_cli_feature

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- / DateinameVersionsnummer
FirstSpirit CXT Plattform
platform-[version].fsm
3.0.1
FirstSpirit CXT DAP Bridge
dataservice-[version].fsm
1.44.9
FirstSpirit CXT FragmentCreator
fragment-creator-[version].fsm
4.0.1
FirstSpirit Fragment DAP
fragmentdap-[version].fsm
1.40.14
FirstSpirit Media DAP
mediadap-[version].fsm
1.31.8*
FirstSpirit PageRef DAP
pageref-[version].fsm
1.9.8
FirstSpirit Markdown Editor
markdown-editor-[version].fsm
1.29.7*
FirstSpirit Tagging Editor
tagging-editor-[version].fsm
1.29.7
FirstSpirit CXT FragmentCreator - CaaS Integration
caas-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.

Weitere Informationen können dem Kapitel „Administration: Advanced URL Creator: Optimierung für den URL-Parameter useWelcomeFilenames“ entnommen werden.

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 getFiles() aus dem Interface RevisionMetaData (FirstSpirit Access-API, Package de.espirit.firstspirit.storage) wurde als „deprecated“ markiert. Zugleich wurde das Interface SendMailException (Package de.espirit.firstspirit.server.mailmanagement) in die FirstSpirit Access-API aufgenommen.

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.

Weitere Informationen können dem Kapitel „Administration: Import von Projekten per fs-cli (FSDevTool) als Projekt-Administrator“ entnommen werden.

FSDevTools, FirstSpirit-Administrator
CORE-14912

Das Anlegen von Derby-Layern lässt sich jetzt mit dem Parameter internalDB.hide=true in der fs-server.conf verhindern.

Weitere Informationen können dem Kapitel „Administration: Derby-Layer deaktivierbar “ entnommen werden.

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.

Weitere Informationen können dem Kapitel „Administration / Module: Konflikterkennung bei Modul-Resourcen mit Server-Scope“ entnommen 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.
Außerdem wird der FirstSpirit Server nun nicht mehr als degraded angesehen, wenn der Jetty Service nicht gestartet werden kann und gleichzeitig der Jetty über den Parameter webserver.jetty.hide=true in der fs-server.conf versteckt wird.

FirstSpirit-Administrator, ServerMonitoring
CORE-14988

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

Weitere Informationen können dem Kapitel „Externe Synchronisierung / Content Transport: FSDevTools-Kommandos für ContentTransport“ entnommen werden.

FSDevTools
DEVEX-578

Das „FirstSpirit Module Gradle Plugin“ ist jetzt öffentlich auf GitHub verfügbar.

Weitere Informationen können dem Kapitel „Modul-Entwicklung, Skripte, API: FirstSpirit Module Gradle Plugin öffentlich auf GitHub“ entnommen werden.

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