Release Notes FirstSpirit™ 2021.5

Release Notes

FirstSpirit™ 2021.5

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

localGroupManagementDisabled

in 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=true

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

UID=contentcreator_inedit_bearbeiten

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
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
Sprachauswahl in Formularen

Navigationsleiste

Sprachauswahl in der 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
Sprachauswahl beim Upload von sprachabhängigen Medien

  • Medium bearbeiten

UID=contentcreator_medium_bearbeiten_icon

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

UID=icon_bildausschnitt_bearbeiten

  • Medium herunterladen

UID=contentcreator_medium_download_icon

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
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
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- / DateinameVersionsnummer
FirstSpirit CXT DAP Bridge
dataservice-[version].fsm
1.41
FirstSpirit CXT FragmentCreator
fragment-creator-[version].fsm
2.21
FirstSpirit Fragment DAP
fragmentdap-[version].fsm
1.37
FirstSpirit Media DAP
mediadap-[version].fsm
1.29*
FirstSpirit PageRef DAP
pageref-[version].fsm
1.7
FirstSpirit Markdown Editor
markdown-editor-[version].fsm
1.27*
FirstSpirit Tagging Editor
tagging-editor-[version].fsm
1.27
FirstSpirit CXT FragmentCreator - CaaS Integration
caas-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

jsonSupporting

im 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- / DateinameVersionsnummerKompatibel
FirstSpirit Aktualisierungsarchiv
fs-update-[version].tar.gz
1.0.12-
FirstSpirit Installationsarchiv
fs-install-[version].tar.gz
1.0.12-
FirstSpirit Launcher
FSLauncher.exe
1.0.40ab FirstSpirit 2018-08
FirstSpirit Launcher JRE Modul
fs-launcher-jre-[version].fsm
1.18ab FirstSpirit 2020-11
FirstSpirit SAML Login Modul
fs-saml-login-[version].fsm
1.1ab FirstSpirit 2019-02
FSDevTools
fs-cli-[version].tar.gz
fs-cli-[version].zip
2.6.9ab FirstSpirit 2020-08
FirstSpirit Module Gradle Plugin
firstspirit-module-gradle-plugin-[version].jar
1.0.3ab 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.0

Hinweis: 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

Der Einsatz von Eclipse Jetty für Produktivzwecke wird weiterhin nicht empfohlen!
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 fs-server.log und in den Details des Installationsergebnisdialogs des Moduls angezeigt. Das Loglevel dieser Meldungen wurde von WARN auf INFO geändert.

FirstSpirit-Administrator, Module
CORE-11307

Die FirstSpirit Access-API wurde um Klassen erweitert, mit denen auf verschiedene Events bei Änderungen reagiert werden kann.

Weitere Informationen können dem Kapitel „Modul-Entwicklung, Skripte, API: API-Erweiterung zum Reagieren auf Events“ entnommen werden.

Entwickler, FirstSpirit-API
CORE-12975

Mit dem aktuellen FirstSpirit-Release wurde intern verwendete Software aktualisiert.

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

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.

Weitere Informationen können dem Kapitel „Administration: Rechte zum Anlegen von internen Gruppen einschränken“ entnommen 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.

Weitere Informationen können dem Kapitel „SiteArchitect: Neue Kontextmenü-Funktion “GID kopieren” auf Datensätzen“ entnommen werden.

SiteArchitect
CORE-13484

Das Standardprotokoll bei der Nutzung einer verschlüsselten Verbindung zum SMTP-Server wurde auf TLS 1.2 geändert.

Weitere Informationen können dem Kapitel „Sicherheit: Verschlüsselung der Verbindung zum SMTP-Server (TLS)“ entnommen werden.

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 RenderingAgent.Renderer und Deprecation der Methode redirectTemplateLogToDefaultLog().

Weitere Informationen können dem Kapitel „Modul-Entwicklung, Skripte, API: Automatisches Logging bei Verwendung von "RenderingAgent.Renderer"“ entnommen werden.

Entwickler, FirstSpirit-API
CORE-13537

Diese Module und Erweiterungen sind kompatibel mit FirstSpirit 2021-05.

Weitere Informationen können dem Kapitel „Kompatibilität: Module und Erweiterungen für FirstSpirit 2021-05“ entnommen werden.

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 url ausgegeben, wenn eine gültige URL erzeugt werden kann. Wenn dies nicht der Fall ist, wird das Attribut nicht ausgegeben.

Eingabekomponenten, JSON-Unterstützung
CXT-1681

Optimierung der Formularanzeige bei Sprachwechsel und Verwendung von mehreren Registern (CMS_GROUP).

Weitere Informationen können dem Kapitel „ContentCreator: Sprachwechsel in Formularen mit mehreren Registern (CMS_GROUP)“ entnommen werden.

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.

Weitere Informationen können dem Kapitel „ContentCreator: Sprachauswahl für Inhalte“ entnommen werden.

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.

Weitere Informationen können dem Kapitel „FirstSpirit Content Experience Tools (CXT): PageRef DAP und Media DAP: JSON-Ausgabe konfigurieren“ entnommen 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.

Weitere Informationen können dem Kapitel „ContentCreator: "Bearbeiten" im InEdit-Modus“ entnommen werden.

ContentCreator, Eingabekomponenten, Entwickler, FirstSpirit Omnichannel Manager, Redakteur, Vorschau
CXT-2194

Im ContentCreator konnte es bei Modulen bei Verwendung der Abhängigkeit org.springframework:spring-context-indexer zu Start-Problemen kommen.

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 de.espirit.firstspirit.store.WebeditStoreMappingPlugin) berücksichtigt. Ist dort beispielsweise „Synchronous site- and page-store“ eingestellt, werden nun auch die entsprechenden Knoten in der Inhalte-Verwaltung verschoben.

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

Weitere Informationen können dem Kapitel „FirstSpirit Content Experience Tools (CXT): Aktuelle Modul-Versionen“ entnommen werden.

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