Release Notes FirstSpirit™ 2022.6

Release Notes

FirstSpirit™ 2022.6

1 Administration

1.1 Projektimport: Prüfen von Plattenplatz

Mit dem aktuellen Release kann jetzt bei einem Projektimport geprüft werden, ob ausreichend Plattenplatz zur Verfügung steht (FirstSpirit ServerManager | Projekt | Import).

UID=servermanager_projekt_importieren_markiert

Ist die Checkbox „Prüfen, ob genügend freier Plattenplatz vorhanden ist“ aktiviert, wird vor dem Import geprüft, ob ein Projektimport mit dem zur Verfügung stehenden Plattenplatz möglich ist, ohne dass der freie Speicherplatz so stark abnimmt, dass der FirstSpirit Server heruntergefahren würde.

Hinweis: Bei dieser Prüfung wird davon ausgegangen, dass Datenbankinhalte nicht den FirstSpirit zur Verfügung stehenden Plattenplatz belegen. Weiterhin wird bei der Prüfung der über die reinen Datenspeicherung hinausgehende zusätzlich benötigte Plattenplatz (z. B. für den Suchindex, Referenzgraph, ...) geschätzt. In seltenen Fällen kann es somit vorkommen, dass der Server trotz dieser Prüfung wegen Speichermangels herunterfährt.

Siehe dazu auch https://docs.e-spirit.com/odfs/edocs/admi/firstspirit-ser/elemente-menuel/projekt/index.html#text_bild_3.

1.2 S3 Deployment: Generierungstyp wählen

Die Erkennung des Generierungstyps durch das AWS-S3-Deployment-Modul wurde verbessert (full bzw. partial generation), z. B.

INFO  18.03.2022 17:31:11.365 {uID=0,seID=885317,pID=881777} (com.espirit.ps.aws.
services.s3.GenerationType): Generation type was set to [full | partial generation].

In der FirstSpirit Developer-API wurden in diesem Kontext im Package de.espirit.firstspirit.scheduling, Interface ScheduleTaskExecutionContext neue Methoden geschaffen, die in einer ScheduleTaskApplication Zugriff auf den ausführenden ScheduleTask ermöglichen:

getTask();
getTaskIndex();

Darüber hinaus wurde die automatische Erkennung des Generierungstyps verbessert:

  • Bisher wurde aufgrund der ersten gefundenen Generierungsaktion (oder des ersten Generierungstasks) entschieden, ob bei einem Deployment Dateien aus dem S3-Bucket gelöscht werden oder nicht. Dabei wurde die Aktion / der Task berücksichtigt, unabhängig davon, ob sie aktiv war oder nicht.
  • Jetzt werden alle aktiven Generierungsaktionen betrachtet, die in der Reihenfolge vor dem S3 Deployment Task liegen. Handelt es sich bei einem dieser Aktionen um eine partielle Generierung („Teilgenerierung“), wird ein Deployment ohne Löschen durchgeführt.

Das Deployment kann jetzt über eine neu implementierte Dropdown-Box je nach individueller Projektanforderung konfiguriert werden („Deployment options“), in der Projekt-Komponente und / oder in einer AWS S3-Deployment-Aktion (unter „Auftragsverwaltung“).

UID=s3_deployment_options

  • (Leer)
    Es wird die Einstellung aus der Projekt-Komponente verwendet (AWS Services Configuration ProjectApp).
  • Auto detect (any partial generation leads to Deploy only):
    Es wird die automatische Erkennung verwendet (siehe Erklärung oben):
    Es werden alle aktiven Generierungsaufträge betrachtet, die in der Reihenfolge vor dem S3 Deployment Task liegen. Handelt es sich bei einem dieser Aufträge um eine partielle Generierung („Teilgenerierung“), wird ein Deployment ohne Löschen durchgeführt.
  • Complete sync (with deletion, use with full generation only!):
    Das S3 Deployment wird mit Löschen von obsoleten Dateien im S3-Bucket durchgeführt.
    Diese Option sollte nur für Vollgenerierungen gewählt werden.
  • Deploy only (no files will be deleted, usually used with partial generation):
    Das S3 Deployment wird ohne Löschen von obsoleten Dateien im S3-Bucket durchgeführt.
    Diese Option bietet sich normalerweise für Teilgenerierungen an.

Hinweis: Es wird empfohlen, den zu den individuellen Projektanforderungen passenden Deployment-Typ über diese Dropdown-Box manuell auszuwählen und die automatische Erkennung nicht zu verwenden.

Weitere Informationen

1.3 ServerManager: Darstellung von Web-Anwendungen und Web-Komponenten

Die Anzeige der verfügbaren Web-Anwendungen und Web-Komponenten wurde verbessert (FirstSpirit Server Manager / „Servereigenschaften / Web-Applikationen“ und „Projekt-Eigenschaften / Web-Komponenten“):

Können nicht alle Web-Applikationen/-Komponenten aufgrund der Breite des Dialogs gleichzeitig dargestellt werden, können Sie jetzt per Pfeilsymbole durch die Elemente scrollen:

UID=pfeile_icons

Über folgendes Icon können Sie sich die Elemente als Liste anzeigen lassen:

UID=liste_icon

Zuvor wurden alle vorhandenen Web-Anwendungen/-Komponenten in mehreren Zeilen untereinander dargestellt, wenn die Breite des Dialogs zu schmal war, um alle Elemente gleichzeitig anzuzeigen.

UID=servermanager_web_applikationen_1

Durch die neue Darstellungsweise wird darüber hinaus die Anzeige (speziell, wenn viele Web-Anwendungen-/Komponenten vorhanden sind) deutlich schneller aufgebaut als zuvor.

1.4 Standardwert für Stack-Tiefe konfigurieren

Mit dem neuen Parameter generate.defaultMaxStackSize kann in der Datei fs-server.conf serverweit der Standardwert für die Stackgröße definiert werden.

Standardwert: 75.

Bisher war der Standardwert, der durch den Parameter #global.maxStackSize vorgegeben wird, 50.

Zu weiteren Informationen siehe

2 Administration / Module

FirstSpirit Module Gradle Plugin: Support für "Legacy mode" ist entfallen

Der Support für den „Legacy mode“ für FirstSpirit Server und Modul-Entwicklung ist mit FirstSpirit 2022.3 entfallen.
Mit dem aktuellen Release wurde jetzt auch im FirstSpirit Module Gradle Plugin (firstspirit-module-gradle-plugin-[version].jar) die Unterstützung für den „Legacy mode“ entfernt. Die aktuelle Version des Plugins ist 4.0.0.
Mit dieser Version werden jetzt ausschließlich module-isolated.xml-Dateien erzeugt. Module, die hingegen eine module.xml-Datei enthalten, verursachen eine Fehlermeldung beim Erzeugen.

3 ContentCreator

Modul "FirstSpirit Image Recognition": Verbesserung der Performanz

Die Performanz beim Aufruf der Amazon Rekognition-API wurde verbessert:
So werden jetzt nur noch Erkennungen von Gesichtern und Celebrities durchgeführt, wenn zuvor Labels wie Human, Person oder Face erkannt wurden.
Ebenso wird eine Erkennung von Text nur noch durchgeführt, wenn zuvor ein Label Text erkannt wurde.

Anhand von Debug-Log-Ausgaben kann jetzt nachvollzogen werden, welche API-Aufrufe gemacht werden, z. B.

... Calling the 'detectLabels' Amazon Image Rekognition API endpoint
... Calling the 'detectFaces' Amazon Image Rekognition API endpoint

Im Rahmen dieser Änderung wurde das AWS SDK auf Version 2.17.173 aktualisiert.

4 FirstSpirit Content Experience Tools (CXT)

Aktuelle Modul-Versionen

Folgende Modul-Versionen für „FirstSpirit Content Experience Tools“ werden von FirstSpirit 2022.6 unterstützt.

Modul- / DateinameVersionsnummer
FirstSpirit CXT Plattform
platform-[version].fsm
2.5.5
FirstSpirit CXT DAP Bridge
dataservice-[version].fsm
1.44.5
FirstSpirit CXT FragmentCreator
fragment-creator-[version].fsm
3.4.9
FirstSpirit Fragment DAP
fragmentdap-[version].fsm
1.40.10
FirstSpirit Media DAP
mediadap-[version].fsm
1.31.5*
FirstSpirit PageRef DAP
pageref-[version].fsm
1.9.5
FirstSpirit Markdown Editor
markdown-editor-[version].fsm
1.29.4*
FirstSpirit Tagging Editor
tagging-editor-[version].fsm
1.29.4
FirstSpirit CXT FragmentCreator - CaaS Integration
caas-integration-[version].fsm
1.31.5

* Diese Module benötigen ab dieser Version FirstSpirit 2020-03 oder höher.

Übersicht

ID Beschreibung Kategorien
CORE-12121

Die Anzeige der verfügbaren Web-Anwendungen und Web-Komponenten wurde verbessert.

Weitere Informationen können dem Kapitel „Administration: ServerManager: Darstellung von Web-Anwendungen und Web-Komponenten“ entnommen werden.

FirstSpirit-Administrator, ServerManager, Web-Anwendungen
CORE-12672

Bei Verwendung der Funktionalität „Fehler der Vorschau“ werden nun auch Wechsel des Ausgabekanals bei den Verlinkungen im Stacktrace entsprechend berücksichtigt, so dass auch Fehlerstellen aus anderen Ausgabekanälen direkt angesprungen werden können.

Debugging, Entwickler, SiteArchitect
CORE-13411

Es wurde ein Fehler behoben, der in sehr seltenen Fällen dazu führen konnte, dass im Verzeichnis <FirstSpiritROOT>/work/storage/jars abgelegte jar-Dateien gelöscht wurden, obwohl diese von FirstSpirit noch benötigt wurden.

FirstSpirit-Administrator, ServerManager
CORE-13705

Die Erkennung des Generierungstyps durch das AWS-S3-Deployment-Modul wurde verbessert.
Weiterhin wurde die Möglichkeit geschaffen, im AWS-S3-Deployment-Modul den Deployment-Typ (kompletter Abgleich inkl. Löschen oder nur Hochladen der Dateien) manuell zu definieren. Zusätzlich wurde die FirstSpirit Developer-API um neue Methoden im ScheduleTaskExecutionContext ergänzt.

Weitere Informationen können dem Kapitel „Administration: S3 Deployment: Generierungstyp wählen“ entnommen werden.

FirstSpirit-Administrator, Generierung, Module
CORE-13886

Mit dem aktuellen Release kann jetzt bei einem Projektimport geprüft werden, ob ausreichend Plattenplatz zur Verfügung steht.

Weitere Informationen können dem Kapitel „Administration: Projektimport: Prüfen von Plattenplatz“ entnommen werden.

FirstSpirit-Administrator, Projektexport / Projektimport, ServerManager
CORE-13962

Wurde die entsprechende Revision archiviert, wird beim Laden eines Features statt einer WARN jetzt eine INFO geloggt.

Content Transport, Debugging, Entwickler, FirstSpirit-Administrator, Logging
CORE-14333

Der neue Parameter generate.defaultMaxStackSize definiert den Standardwert für die Stackgröße. Der Standardwert wurde von 50 auf 75 erhöht.

Weitere Informationen können dem Kapitel „Administration: Standardwert für Stack-Tiefe konfigurieren“ entnommen werden.

FirstSpirit-Administrator, Performance
CORE-14349

Aufgrund der Umstellung auf „Log4j 2“ konnte es beim Deployen von Web-Anwendungen zu Fehlern vom Typ java.lang.ClassCastException kommen.
Mit dem aktuellen Release erfolgt jetzt eine Prüfung, ob der LoggerContext kompatibel ist. Wenn nicht, wird dies im Log mit einer INFO-Meldung statt einer Exception festgehalten.

Debugging, FirstSpirit-Administrator, Logging
CORE-14380

Es wurde ein Fehler behoben, der in seltenen Fällen dazu führen konnte, dass über den ServerManager geöffnete Sitzungen temporär erhalten blieben.

FirstSpirit-Administrator, ServerManager, Sitzungen
CORE-14386

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
CORE-14391

Sind für Parameter der Datei fs-server.conf ungültige Werte eingetragen, wird dies jetzt mit einer WARN-Meldung im Logging festgehalten. Zuvor wurde nur ein DEBUG geloggt.
Beispiel: WARN 13.05.2022 12:50:48.310 (de.espirit.firstspirit.server.ServerManagerImpl): wrong numerical format for property memory.limit: '95x'

Debugging, FirstSpirit-Administrator, ServerMonitoring
CXT-1910

Die Performanz beim Aufruf der Amazon Rekognition -API wurde verbessert.

Weitere Informationen können dem Kapitel „ContentCreator: Modul "FirstSpirit Image Recognition": Verbesserung der Performanz“ entnommen werden.

ContentCreator, FirstSpirit-Administrator, Medien, Performance
CXT-2579

In FirstSpirit können Elemente mehrfach verwendet werden, z. B. Bilder, Absätze, Seiten, Datensätze usw. Der Begriff „Verwendungen“ in der Titelleiste von Bearbeitungsdialogen im FirstSpirit ContentCreator zeigt an, dass das jeweilige Element (z. B. ein Bild) auf einer Seite oder in einem Datensatz verwendet („referenziert“) wird.
Mit dem aktuellen Release werden dort jetzt alle für den Redakteur relevanten Referenzen angezeigt, zuvor wurden einige Element-Typen nicht berücksichtigt. Für Elemente aus Remote-Projekten wird jetzt zusätzlich der Name des Remote-Projekts angezeigt.

ContentCreator, Redakteur
DEVEX-510

Mit dem „FirstSpirit Module Gradle Plugin“ können mit dem aktuellen Release keine Module im „Legacy mode“ mehr erzeugt werden.

Weitere Informationen können dem Kapitel „Administration / Module: FirstSpirit Module Gradle Plugin: Support für "Legacy mode" ist entfallen“ entnommen werden.

Entwickler, FirstSpirit-Administrator, Isolated mode, Modul-Entwicklung, 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
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