Release Notes
1 Administration
Rechte zum Anlegen von internen Gruppen einschränken
Standardmäßig können Projekt-Administratoren (interne) Gruppen anlegen, bearbeiten und löschen (z. B. per „FirstSpirit ServerManager“ / „Projekteigenschaften“ / „Gruppen“).
Mit dem aktuellen Release kann dieses Recht deaktiviert werden, und zwar über den Parameter
localGroupManagementDisabledin der Datei fs-server.conf.
Um Projekt-Administratoren das Recht zum Anlegen, Bearbeiten und Löschen von Gruppen zu entziehen, muss der Wert true gesetzt werden, also
localGroupManagementDisabled=trueIn diesem Fall können Gruppen nur noch von Server-Administratoren modifiziert werden.
Für Projekt-Administratoren wird das entsprechende Kontextmenü im Bereich „Gruppen“ ausgeblendet, Im Log wird eine java.lang.SecurityException festgehalten.
Externe Gruppen sind von dieser Einschränkung nicht betroffen und können weiterhin von Projekt-Administratoren modifiziert werden, auch wenn der Parameter auf true gesetzt ist.
2 ContentCreator
2.1 "Bearbeiten" im InEdit-Modus
Einige Eingabekomponenten bieten die InEdit-Funktionalität an. Diese Funktion ermöglicht das Ändern von Inhalten, ohne dass zuvor ein Formular geöffnet werden muss. Ein Stift-Symbol am Mauszeiger zeigt dem Redakteur an, ob der entsprechende Wert per InEdit bearbeitet werden kann. Der InEdit-Modus wird gestartet, indem der Redakteur die gewünschte Stelle in der Vorschau (per Strg + KLICK ) anklickt.
Mit einem weiteren Klick auf das Icon „Bearbeiten“ wird mit dem aktuellen Release das gesamte Formular geöffnet.

Dadurch können jetzt Inhalte benachbarter Eingabekomponenten komfortabel gepflegt werden sowie die Inhalte in anderen Sprachen.
Zuvor wurde nur die einzelne Eingabekomponente in dem sich öffnenden Dialog dargestellt.
2.2 Sprachauswahl für Inhalte
Speziell in Projekten mit vielen Sprachen können Redakteure jetzt einstellen, in welchen Sprachen sie Inhalte vorrangig angezeigt bekommen möchten.
Die Konfiguration wird über den Menüpunkt „Sichtbare Projektsprachen“ im „Drei-Punkt“-Menü vorgenommen:

Inhaltssprache/n wählen
Standardmäßig werden Inhalte in allen verfügbaren Projektsprachen angezeigt.
Über das Menü können die Sprachen deaktiviert werden, die für den User weniger relevant sind: Inhalte in der bzw. den aktivierte/n Sprache/n können direkt per Menü ausgewählt werden, die deaktivierte/n Sprache/n können über ein ausklappbares Untermenü „Weitere Sprachen“ erreicht werden.
Die Wahl der sichtbaren Projektsprachen wirkt sich an mehreren Stellen aus:
Formulare

Sprachauswahl in Formularen
Navigationsleiste

Sprachauswahl in der Navigationsleiste
Erstellen, Bearbeiten und Download von (sprachabhängigen) Medien
Im Falle von Medien wird das Menü zur Sprachwahl bei folgenden Funktionen angezeigt, wenn die Checkbox „Sprachabhängig“ aktiviert ist:
- Neues Medium hochladen (Menüleiste):

Sprachauswahl beim Upload von sprachabhängigen Medien
- Medium bearbeiten
Für folgende Funktionen wird das Sprachwahl-Menü angezeigt, wenn es sich um ein sprachabhängiges Medium handelt. Es werden nur die Sprachen zur Wahl angeboten, zu denen eine Sprachvariante vorliegt:
- Bildausschnitt bearbeiten
- Medium herunterladen
Zu detaillierten Informationen dazu siehe https://docs.e-spirit.com/contentcreator/menuefunktionen/weitere-funktio/index.html.
Die über den Menüpunkt „Sichtbare Projektsprachen“ vorgenommenen Einstellungen werden für alle Projekte des jeweiligen Users auf dem betreffenden Server gespeichert.
Die Konfigurierbarkeit hängt von der Einstellung „Sprachen ausblendbar“ im FirstSpirit ServerManager in den Eigenschaften des betreffenden Projekts ab (Bereich „Optionen“):

Konfiguration aktivieren
Um den Menüpunkt „Sprache“ im ContentCreator anzuzeigen und damit die neue Funktionalität nutzen zu können, muss die Checkbox aktiviert werden.
Hinweis: Die hier vorgenommene Einstellung wirkt sich auch im FirstSpirit SiteArchitect aus.
2.3 Sprachwechsel in Formularen mit mehreren Registern (CMS_GROUP)
In Formularen mit mehreren Registern (CMS_GROUP) werden nun die gewählten Register bei einem Wechsel der Sprache synchronisiert:

Sprachwechsel in Formularen mit mehreren Registern
3 FirstSpirit Content Experience Tools (CXT)
3.1 Aktuelle Modul-Versionen
Folgende Modul-Versionen für „FirstSpirit Content Experience Tools“ werden von FirstSpirit 2021-05 unterstützt:
| Modul- / Dateiname | Versionsnummer |
FirstSpirit CXT DAP Bridgedataservice-[version].fsm | 1.41 |
FirstSpirit CXT FragmentCreatorfragment-creator-[version].fsm | 2.21 |
FirstSpirit Fragment DAPfragmentdap-[version].fsm | 1.37 |
FirstSpirit Media DAPmediadap-[version].fsm | 1.29* |
FirstSpirit PageRef DAPpageref-[version].fsm | 1.7 |
FirstSpirit Markdown Editormarkdown-editor-[version].fsm | 1.27* |
FirstSpirit Tagging Editortagging-editor-[version].fsm | 1.27 |
FirstSpirit CXT FragmentCreator - CaaS Integrationcaas-integration-[version].fsm | 1.28 |
* Diese Module benötigen ab dieser Version FirstSpirit 2020-03 oder höher.
3.2 PageRef DAP und Media DAP: JSON-Ausgabe konfigurieren
In der FS_INDEX-Komponente können mithilfe des Media Data Access Plugins („Media DAP“) Medien, mithilfe des PageRef Access Plugins („PageRef DAP“) Seitenreferenzen referenziert werden.
Mit dem aktuellen Release können jetzt die JSON-Informationen der in der FS_INDEX-Komponente referenzierten Medien bzw. Seitenreferenzen mit ausgegeben werden. Dies kann über das neue Attribut
jsonSupportingim SOURCE-Tag der FS_INDEX-Komponente aktiviert werden, und zwar mit dem Wert yes.
Beispiel:
...
<SOURCE name="FirstSpiritMediaAccess/Connector" jsonSupporting="yes">
<PROJECT remote="remote"/>
</SOURCE>
...Das Attribut steht nur bei Verwendung der DataAccessPlugin-Komponenten „FirstSpiritMediaAccess/Connector“ und „FirstSpiritPageRefAccess/PageRefConnector“ zur Verfügung.
Standardmäßig werden die JSON-Informationen der referenzierten Medien bzw. Seitenreferenzen nicht mit ausgegeben (entspricht jsonSupporting="no").
Zu weiteren Informationen zur JSON-Ausgabe von Medien siehe auch https://docs.e-spirit.com/odfs/erweiterte-json/json-ausgabe-me/index.html.
4 Kompatibilität
Module und Erweiterungen für FirstSpirit 2021-05
Folgende Module und Erweiterungen sind kompatibel mit FirstSpirit 2021-05:
| Modul- / Dateiname | Versionsnummer | Kompatibel |
FirstSpirit Aktualisierungsarchivfs-update-[version].tar.gz | 1.0.12 | - |
FirstSpirit Installationsarchiv fs-install-[version].tar.gz | 1.0.12 | - |
FirstSpirit LauncherFSLauncher.exe | 1.0.40 | ab FirstSpirit 2018-08 |
FirstSpirit Launcher JRE Modulfs-launcher-jre-[version].fsm | 1.18 | ab FirstSpirit 2020-11 |
FirstSpirit SAML Login Modulfs-saml-login-[version].fsm | 1.1 | ab FirstSpirit 2019-02 |
FSDevToolsfs-cli-[version].tar.gzfs-cli-[version].zip | 2.6.9 | ab FirstSpirit 2020-08 |
FirstSpirit Module Gradle Pluginfirstspirit-module-gradle-plugin-[version].jar | 1.0.3 | ab FirstSpirit 2019-06 |
5 Modul-Entwicklung, Skripte, API
5.1 API-Erweiterung zum Reagieren auf Events
Die FirstSpirit Access-API wurde um folgende Klassen erweitert, mit denen auf verschiedene Events bei Änderungen reagiert werden kann:
de.espirit.firstspirit.agency.IDProviderEventAgent;
de.espirit.firstspirit.event.RevisionEvent;
de.espirit.firstspirit.event.EventInfo;
de.espirit.firstspirit.event.EntityInfo;
de.espirit.firstspirit.event.DatasetChange;
de.espirit.firstspirit.event.IDProviderChange;5.2 Automatisches Logging bei Verwendung von "RenderingAgent.Renderer"
Die Methode
redirectTemplateLogToDefaultLog()im Interface RenderingAgent.Renderer (Package de.espirit.firstspirit.agency, FirstSpirit Developer-API) ist jetzt standardmäßig aktiviert, sodass entsprechende Logausgaben automatisch im Standard-Log ausgegeben werden. Dies erleichtert die Analyse im Falle von Problemen.
Die Methode selbst wurde in diesem Rahmen als deprecated gekennzeichnet und kann mit einem folgenden FirstSpirit-Release entfallen.
Sie sollte daher aus Skripten, in denen sie verwendet wird, entfernt werden.
6 Sicherheit
Verschlüsselung der Verbindung zum SMTP-Server (TLS)
Das Standardprotokoll bei der Nutzung einer verschlüsselten Verbindung zum SMTP Server wurde auf TLS 1.2 geändert.
Sollte ein anderes Protokoll benötigt werden, so kann dies weiterhin über den Parameter javamail.mail.smtp.ssl.protocols in der fs-server.conf definiert werden.
Um bei Problemen mit der empfohlenen Verschlüsselung auf den vorhergehenden Standardwert zu wechseln, wäre folgender Eintrag notwendig:
javamail.mail.smtp.ssl.protocols=TLSv1.0Hinweis: Die TLS-Protokolle V1.0 und V1.1 gelten als veraltet und unsicher. Sie sollten vor der Aktivierung sicherheitskritisch bewertet werden.
7 SiteArchitect
Neue Kontextmenü-Funktion “GID kopieren” auf Datensätzen
Mit dem aktuellen Release ist es nun möglich, über das Kontextmenü eines Datensatzes die Funktion „GID kopieren“ aufzurufen. Über diese Funktion wird die GID des aktuellen Datensatzes im Zwischenspeicher abgelegt.
Diese Funktion kann nur auf einem Datensatz aufgerufen werden, der auch eine GID besitzt. Handelt es sich z. B. um einen neuen, noch niemals gespeicherten Datensatz, ist dieser Menüeintrag deaktiviert.
8 System
Aktualisierung von integrierter Fremdsoftware
Mit dem aktuellen FirstSpirit-Release wurde folgende intern verwendete Software aktualisiert:
- Java (JRE, mit dem der FirstSpirit-Launcher betrieben wird)
Aktuell sind folgende Java-Varianten verfügbar: - Neu: In FirstSpirit integriert (Standard): 11.0.11+9 64bit AdoptOpenJDK
- Neu: Im FirstSpirit Launcher JRE Modul: 16.0.1+9 64bit AdoptOpenJDK
- Java Mail Library (für den Mail-Versand)
Aktualisierung von Java Mail 1.4.4 auf Jakarta Mail 1.6.6 - Eclipse Jetty (im Modul
fs-jetty.fsm/ „FirstSpirit Jetty Service“ enthalten)
Aktualisierung von Version 9.4.33 auf Version 9.4.39
Für den Betrieb mit FirstSpirit Content Experience Tools (CXT) wird Eclipse Jetty nicht unterstützt.
Übersicht
| ID | Beschreibung | Kategorien |
|---|---|---|
| CORE-10613 | Das Verhalten bei der Installation von Modulen wurde angepasst, so dass nun Ressourcen-Konflikte zwischen anderen Modulen nicht mehr zu der Meldung führen, dass es ein Problem bei der Installation gab. Sollten die Konflikte das aktuell zu installierende Modul betreffen, so wird weiterhin ein entsprechender Fehler bei der Installation ausgegeben. Werden Konflikte zwischen anderen Modulen gefunden, so wird ein entsprechender Konflikt weiterhin in der Datei |
FirstSpirit-Administrator, Module |
| CORE-11307 | Die FirstSpirit Access-API wurde um Klassen erweitert, mit denen auf verschiedene Events bei Änderungen reagiert werden kann. |
Entwickler, FirstSpirit-API |
| CORE-12975 | Mit dem aktuellen FirstSpirit-Release wurde intern verwendete Software aktualisiert. |
Entwickler, FirstSpirit Jetty Web Server, FirstSpirit-Administrator, Integrierte Software, Java, Launcher, Server-Administrator |
| CORE-13139 | Es wurde ein Fehler behoben, der bei einer ungünstigen Konfiguration dazu führen konnte, dass es bei der Nutzung von SingleSignOn (z. B. mittels SAML) zu einem endlosen Ladezustand im Browser kommen konnte. |
Server-Administrator |
| CORE-13141 | Mit dem aktuellen Release können die Rechte zum Anlegen von internen Gruppen auf Server-Administratoren eingeschränkt werden. |
FirstSpirit-Administrator, Rechte |
| CORE-13265 | Die Stabilität des Systems in Szenarien mit einer hohen Anzahl an Änderungen wurde verbessert. |
Performance |
| CORE-13299 | Über das Kontextmenü eines Datensatzes steht die neue Funktion „GID kopieren“ zu Verfügung. |
SiteArchitect |
| CORE-13484 | Das Standardprotokoll bei der Nutzung einer verschlüsselten Verbindung zum SMTP-Server wurde auf |
FirstSpirit-Administrator, Java, Sicherheit |
| CORE-13515 | Es wurde ein Fehler behoben, der in sehr seltenen Fällen dazu führen konnte, dass ein Update des Launchers aufgrund abgelaufener Benutzersitzungen fehlschlägt. |
Launcher, Sitzungen |
| CORE-13528 | Automatisches Logging bei Verwendung von |
Entwickler, FirstSpirit-API |
| CORE-13537 | Diese Module und Erweiterungen sind kompatibel mit FirstSpirit 2021-05. |
Entwickler, FirstSpirit-Administrator, Module, Server-Administrator |
| CORE-13538 | Es wurde ein Fehler behoben, der dazu führen konnte, dass bei der JSON-Ausgabe von Remote-Bildern die Informationen über deren Auflösungen unvollständig waren. |
Entwickler, JSON-Unterstützung, Medien |
| CORE-13546 | Bei der JSON-Ausgabe der Eingabekomponente FS_REFERENCE wird jetzt nur noch das Attribut |
Eingabekomponenten, JSON-Unterstützung |
| CXT-1681 | Optimierung der Formularanzeige bei Sprachwechsel und Verwendung von mehreren Registern (CMS_GROUP). |
ContentCreator, Redakteur, Sprachen |
| CXT-1769 | Speziell in Projekten mit vielen Sprachen können Redakteure jetzt einstellen, in welchen Sprachen sie Inhalte vorrangig angezeigt bekommen möchten. |
ContentCreator, FirstSpirit-Administrator, Redakteur, ServerManager, Sprachen |
| CXT-1916 | Die JSON-Ausgabe für PageRef DAP und Media DAP kann jetzt um die Informationen für referenzierte Seitenreferenzen bzw. Medien erweitert werden. |
Entwickler, FirstSpirit Content Experience Tools (CXT), FirstSpirit-API, FragmentCreator, JSON-Unterstützung, Medien, Modul-Entwicklung |
| CXT-1968 | „Bearbeiten“ im InEdit-Modus ermöglicht jetzt die Formular-Bearbeitung. |
ContentCreator, Eingabekomponenten, Entwickler, FirstSpirit Omnichannel Manager, Redakteur, Vorschau |
| CXT-2194 | Im ContentCreator konnte es bei Modulen bei Verwendung der Abhängigkeit |
ContentCreator, Entwickler, Modul-Entwicklung |
| CXT-2212 | Inhaltliche Änderungen in FS_CATALOG-Komponenten werden im ContentCreator jetzt korrekt visualisiert (über „Alle Änderungen anzeigen“). |
ContentCreator, Eingabekomponenten, Redakteur |
| CXT-2269 | Beim Verschieben von Menüpunkten und/oder Seiten in der Navigationsleiste wird nun das konfigurierte „Store Mapping“ (Projekteigenschaften im FirstSpirit ServerManager im Bereich „ContentCreator“, FirstSpirit Developer-API |
ContentCreator, Entwickler, Redakteur |
| CXT-2293 | Beim automatischen Zuschnitt von Bildern im ContentCreator kam es je nach Anzahl von betroffenen Auflösungen zu vermehrten Zwischenrevisionen. In Kombination mit CaaS Connect konnten die daraus resultierenden Änderungs-Events zu unnötigen Deployments der betroffenen Medien führen. |
ContentCreator, Entwickler, FirstSpirit-Administrator, Medien |
| CXT-2294 | FirstSpirit Content Experience Tools: Aktuelle Modul-Versionen |
Entwickler, FirstSpirit Content Experience Tools (CXT), FirstSpirit-Administrator, FragmentCreator, Module |
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 | |
| Legacy mode für den FirstSpirit-Server | 2019-06 | 2022-03 |
| Datenbank-Layer Oracle Database 11g/12c | 2020-12 | 2025-05 |
| FirstSpirit Access-API: redirectTemplateLogToDefaultLog() (Interface RenderingAgent.Renderer) | 2021-05 |