Release Notes FirstSpirit™ 2023.3

Release Notes

FirstSpirit™ 2023.3

1 Administration

1.1 Aktualisierung von integrierter Fremdsoftware

Mit dem Release 2023.3 sind folgende intern verwendete Software aktualisiert worden.

  • Java Service Wrapper (Konfiguration und Überwachung der FirstSpirit Java VM, 3.5.46 --> 3.5.50)
    Hinweis: Bei einer Aktualisierung des FirstSpirit-Servers (Auto-Update, Inplace-Upgrade) werden die Dateien des Java Service Wrappers nicht automatisch aktualisiert. Der Java Service Wrapper kann gemäß FirstSpirit Installationsanleitung über das Tar-Gzip-Aktualisierungsarchiv (Datei fs-update-[version].tar.gz) aktualisiert werden.
    Weiterführende Dokumentation:
  • Log4j (2.17.2 --> 2.19.0)
  • Google Web Toolkit („GWT“, verwendet für den ContentCreator, 2.9.0 --> 2.10.0)
  • Gson (2.8.0 --> 2.10)
  • metadata-extractor (2.11.0 --> 2.18.0)
  • Apache POI (3.7 --> 5.2.2)
  • commons-codec (1.11 --> 1.15)
  • commons-collections (4.1 --> 4.4)
  • commons-math (3.6.1, neu)
  • xmlbeans (2.5.0 --> 5.0.3)
  • dom4j (1.6.1 --> wird nicht mehr verwendet)

Module, die noch den „Legacy Mode“ und die (in diesem Modus) über FirstSpirit erreichbare Library nutzen, müssen gegebenenfalls entsprechend angepasst werden.
Da der „Legacy Mode“ nicht mehr unterstützt wird, sollten betroffene Module möglichst auf den „Isolated Mode“ umgestellt werden (siehe Modulentwicklung).

1.2 FirstSpirit mit Apple M1 bzw. Linux AArch64

Bei einer lokalen FirstSpirit-Installation auf einem Gerät mit einem Apple M1- oder Linux AArch64-Prozessor ist es nun möglich, die Java-Version einzusetzen, die direkt für diese Architektur ausgelegt ist.

Hinweis: Für produktive FirstSpirit-Server kann weiterhin ausschließlich ein Linux- oder Windows-Betriebssystem verwendet werden (siehe Technische Voraussetzungen und Empfehlungen (→Dokumentation für Administratoren)).

1.3 Projekt per Kopie anlegen

Mithilfe dieser Funktion können auf dem Server liegende Projekte direkt kopiert werden, ohne die Funktionen „Exportieren“ und „Importieren“ nacheinander nutzen zu müssen.

Diese Möglichkeit steht nur Server-Administratoren zur Verfügung!

Im Feld Projektvorlage kann das gewünschte Projekt, das kopiert werden sollte, ausgewählt werden. Die Optionen können frei definiert werden (ähnlich wie beim Importieren).

Projekt kopieren
Projekt kopieren

Werden innerhalb des zu kopierenden Projekts Datenbank-Inhalte verwendet, so müssen diese Inhalte auf einen neuen Datenbank-Layer gemappt werden. Es muss jedem einzelnen Schema des Projekts ein neuer oder ein bereits auf dem Server vorhandener Datenbank-Layer zugewiesen werden.

UID=select_layer

Ein Schließen des Fortschrittfensters und des ServerManagers haben keine Auswirkung auf den Vorgang.

UID=project_copy_progress

Zu weiteren Informationen siehe FirstSpirit Dokumentation für Administratoren, Kapitel „Projekt“.

1.4 Speicherplatz-Prüfung bei Projekt-Export

Im Verlauf eines Projekt-Exports wird der verbleibende Speicherplatz kontinuierlich geprüft.

Wenn der verbleibende Speicherplatz den eingestellten Warnungs-Mindestwert erreicht, wird der Export abgebrochen und die unvollständige Exportdatei wird gelöscht. Nähere Informationen zur Einstellung des Warnungs- und Shutdown-Werts (FirstSpirit ServerManager / Server-Eigenschaften / Globale Server-Eigenschaften (→Dokumentation für Administratoren)).

2 FirstSpirit Content Experience Tools (CXT)

2.1 Aktuelle Modul-Versionen

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

Modul- / DateinameVersionsnummer
FirstSpirit CXT Plattform
platform-[version].fsm
3.0.3
FirstSpirit CXT DAP Bridge
dataservice-[version].fsm
1.44.10
FirstSpirit CXT FragmentCreator
fragment-creator-[version].fsm
4.0.3
FirstSpirit Fragment DAP
fragmentdap-[version].fsm
1.40.16
FirstSpirit Media DAP
mediadap-[version].fsm
1.31.9*
FirstSpirit PageRef DAP
pageref-[version].fsm
1.9.9
FirstSpirit Markdown Editor
markdown-editor-[version].fsm
1.29.8*
FirstSpirit Tagging Editor
tagging-editor-[version].fsm
1.29.8
FirstSpirit CXT FragmentCreator - CaaS Integration
caas-integration-[version].fsm
1.31.9

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

2.2 Erweiterung der MicroApp-JavaScript-API

Beim Öffnen von MicroApp-Modalfenster über die MicroApp-JavaScript-API der CXT-Platform ist es möglich, den z-index des Modalfenster zu setzen (Interface CxtMicroAppConfig, optionales Feld frameZIndex).

3 Medien

Verbesserte SVG-Verarbeitung

Die Verarbeitung falsch konfigurierter SVG-Bilddateien wurde verbessert. Die Dateien können in vielen Fällen trotz der nicht unterstützen Konfiguration hochgeladen und verwendet werden.

Hinweis: Bei Problemen mit einer Bilddatei werden die Ursachen in der Log-Datei aufgeführt. Falsche Konfigurationen können Darstellungsprobleme in den Thumbnails innerhalb von FirstSpirit verursachen.

4 SiteArchitect / ServerManager

Bereingung von <FirstSpiritROOT>/data/schedule

Beim Löschen eines Auftrags wird nun auch das Verzeichnis <FirstSpiritROOT>/data/schedule bereinigt.

Hinweis: In diesem Verzeichnis können alte Daten unter folgendem Pfad bereinigt werden: ServerManager > Server > Aufräumen

Übersicht

ID Beschreibung Kategorien
CORE-7708

Mit Strg + LINKSKLICK ist es nun möglich, zu einem Skript zu wechseln, welches innerhalb eines CMS_RENDER-Aufrufs direkt referenziert wird.

Vorlagenentwicklung
CORE-12153

Bereinigung von <FirstSpiritROOT>/data/schedule beim Löschen eines Auftrags.

Weitere Informationen können dem Kapitel „SiteArchitect / ServerManager: Bereingung von <FirstSpiritROOT>/data/schedule“ entnommen werden.

Server-Administrator, ServerManager
CORE-14494

Bei einer contentSelect-Funktion kann nun eine eindeutige Bezeichner (UUID) als Konstante angegeben werden.

Vorlagenentwicklung
CORE-14704

Die Verwendung eines FS_BUTTON zum Befüllen einer FS_CATALOG-Eingabekomponente ist nun auch innerhalb einer anderen FS_CATALOG-Eingabekomponente möglich.

ContentCreator, Eingabekomponenten
CORE-14812

Mit der aktuellen FirstSpirit-Version können auf dem Server liegende Projekte direkt kopiert werden, ohne die Funktionen „Exportieren“ und „Importieren“ nacheinander nutzen zu müssen.

Weitere Informationen können dem Kapitel „Administration: Projekt per Kopie anlegen“ entnommen werden.

Server-Administrator
CORE-14955

Projekt-Export: Prüfung des verbleibenden Speicherplatzes zur Verhinderung von Server-Shutdown.

Weitere Informationen können dem Kapitel „Administration: Speicherplatz-Prüfung bei Projekt-Export“ entnommen werden.

Server-Administrator
CORE-14959

Wenn Module fehlerhaft implementiert waren, konnten das dazu führen, dass Reports, welche durch andere Module erzeugt wurden, im SiteArchitect nicht angezeigt wurden. Der Fehler wurde behoben.

Reports, SiteArchitect
CORE-15003

Aktualisierung von integrierter Fremdsoftware

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

Integrierte Software
CORE-15028

Bei der Nutzung der CloudFront-Invalidierung mit dem AWS S3-Deploymentmodul konnte es zu einer inkorrekten Ausführung der Invalidierung kommen. Der Fehler wurde behoben.

AWS S3-Deployment
CORE-15031

Betrieb eines lokalen FirstSpirit-Servers auf Apple M1 bzw. Linux AArch64 mit direkt für diese Architektur ausgelegter Java-Version.

Weitere Informationen können dem Kapitel „Administration: FirstSpirit mit Apple M1 bzw. Linux AArch64“ entnommen werden.

Webserver
CORE-15042

Verbesserung in der Verarbeitung falsch konfigurierter SVG-Bilddateien

Weitere Informationen können dem Kapitel „Medien: Verbesserte SVG-Verarbeitung“ entnommen werden.

Medien-Verwaltung
CORE-15104

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

Für Regeln kann nun innerhalb von NULL und NOT_NULL Bedingungen auf das Vorhandensein von Properties (z. B. <PROPERTY name=„GID“ source=„#global“/>) geprüft werden.

Dynamische Formulare
CORE-15110

Aufträge, die auf einen Abbruch nicht innerhalb von 15 Minuten reagieren, führen nicht mehr zu einer Änderung des Server-Status in „degraded“. Hierbei wird im fs-server.log und im Incident-Log des Servers (SCHEDULE_CANCEL_TIMEOUT) eine FATAL-Meldung protokolliert.

Server-Administrator
CORE-15121

In sehr seltenen Fällen konnte es zu einem kontinuierlichen Anstieg an nicht authentifizierten Socket-Verbindungen und einer proportional hohen Speichernutzung auf dem FirstSpirit-Server kommen.

Server-Administrator
CORE-15136

Log4j-Klassen werden nicht mehr automatisch im Classpath von Web-Apps abgelegt. Wenn auf Log4j-Klassen zugegriffen werden soll, kann dafür die automatisch bereitgestellte Web-Komponente „Log4j Libraries“ zusätzlich in der Web-App eingebunden werden.

Logging, Server-Administrator
CXT-2756

Änderungen an Medien wurden durch die Filter-Einstellungen eines Medienordners nicht korrekt berücksichtigt.

ContentCreator
CXT-2769

Über die Managementseite kann die Verfügbarkeit vom MicroApps konfiguriert werden. Mit der aktuellen Version ist es nun Möglich mit Hilfe des „Beenden“-Buttons die Managementseite zu verlassen. Dabei wird der Benutzer auf die FirstSpirit-Startseite weitergeleitet.

FirstSpirit Content Experience Tools (CXT)
CXT-2775

Ordner in den Filtereinstellungen des Suchdialogs waren unsortiert.

ContentCreator
CXT-2785

Im ContentCreator wird die ausgewählte Mediendarstellung in der Medien-Verwaltung nun gespeichert. Die Einstellung bezieht sich auf den aktuellen Server und wird im Browser-Cache abgelegt.

ContentCreator, Medien-Verwaltung
CXT-2799

Im ContentCreator wurden Lesezeichen zu Datensätzen, für deren Datenquelle keine Vorschauseite konfiguriert war, nicht angezeigt. Der Fehler wurde behoben: Mithilfe der Lesezeichen kann der referenzierte Datensatz direkt in der Datenquellen-Verwaltung aufgerufen werden.

ContentCreator, Datenquellen-Verwaltung
CXT-2812

Die OpenElementDataFormOperation (FirstSpirit Developer-API, Package de.espirit.firstspirit.ui.operations) ermöglicht optional, die initiale Persistenzsprache festzulegen (setLanguage). Ohne diese Information trat ein Fehler auf. Das Problem wurde behoben: Die Master-Sprache wird verwendet.

ContentCreator, FirstSpirit-API
CXT-2814

Beim Öffnen von MicroApp-Modalfenstern über die MicroApp-JavaScript-API der CXT-Platform ist es nun möglich, den z-index des Modalfenster zu setzen.

Weitere Informationen können dem Kapitel „FirstSpirit Content Experience Tools (CXT): Erweiterung der MicroApp-JavaScript-API“ entnommen werden.

Entwickler, FirstSpirit Content Experience Tools (CXT), Modul-Entwicklung

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