Release Notes FirstSpirit™ 2024.3

Release Notes

FirstSpirit™ 2024.3

1 Administration

Discontinuation of the logging configuration in Log4j1 format

Since FirstSpirit 2023.6, it is possible to create the configuration of the logging framework using the XML syntax of Log4j2. At the same time, the old configuration in the style of Log4j1 is still supported.

With FirstSpirit 2024.6, this support will be discontinued.

Crownpeak recommends migrating to the new syntax early. Further details can be found in the release notes of FirstSpirit 2023.6.

Please also pay attention to Logging Best Practices in FirstSpirit.

2 Administration / Modules

Discontinuation: Automatic Jakarta EE Migrator for WebApps

The Jakarta EE Migrator for web applications introduced with FirstSpirit 2023.9 is planned to be removed with version 2024.9.

As preparation, web app components that have not been manually migrated yet are now being noted in the fs-server.log.

Example:

WARN 07.02.2024 10:50:34.465 
(de.espirit.firstspirit.server.module.WebServerManagerImpl):
Web-app component '[...] WebApp' packaged in module '[...]'
does not define an XML schema version of 5.0 or later.
This causes the web-app 'global_test' to be migrated by FirstSpirit automatically.
The migration will not be availabe in FirstSpirit 2024.9 or later,
so please contact the developers of this component about an updated version.

More information and updates can be found in the Crownpeak Community.
Contact Customer Support Team if you have questions or feedback regarding the migration.

3 External Synchronization

FSDevTools: Execute Beanshell scripts

The command line tool FSDevTools simplifies export and import operations between a FirstSpirit project and the file system via predefined commands. With the current FSDevTools release 4.7.1, the execution of Beanshell scripts is supported.

The fs-cli has now been expanded with the following commands:

script parse: compiles the script with the specified ScriptEngine (default: beanshell)

script parse [--scriptEngine|-se <NAME>] 
--scriptFile|-sf <NAME>
[-- optional string parameterlist in form key=value]

script run: compiles the script with the specified ScriptEngine (default: beanshell) and executes it

script run [--scriptEngine|-se <NAME>] 
--scriptFile|-sf <NAME>
[-- optional string parameterlist in form key=value]

The documentation of the individual commands and their parameters can be found as usual in HTML format in the release under docs/index.html or can be called up via the command line (fs-cli help script).

4 FirstSpirit Content Experience Tools (CXT)

Latest module versions

FirstSpirit 2024.3 supports the following module versions for FirstSpirit Content Experience Tools.

Module / file nameVersion number
FirstSpirit CXT Plattform
platform-[version].fsm
6.1.1
FirstSpirit CXT DAP Bridge
dataservice-[version].fsm
1.44.19
FirstSpirit CXT FragmentCreator
fragment-creator-[version].fsm
5.0.6
FirstSpirit Fragment DAP
fragmentdap-[version].fsm
1.40.28
FirstSpirit Media DAP
mediadap-[version].fsm
1.31.18
FirstSpirit PageRef DAP
pageref-[version].fsm
1.9.18
FirstSpirit Markdown Editor
markdown-editor-[version].fsm
1.29.17
FirstSpirit Tagging Editor
tagging-editor-[version].fsm
1.29.17
FirstSpirit CXT FragmentCreator - CaaS Integration
caas-integration-[version].fsm
1.31.17

5 SiteArchitect / ServerManager

Java version update

The FirstSpirit desktop apps (FirstSpirit SiteArchitect and ServerManager) are started and updated (rolled out) via the FirstSpirit Launcher.

The “FirstSpirit Launcher JRE” module enables customers and partners to easily switch between different Java versions for the operation of Java-based applications. The desired Java version can be selected server-wide for Microsoft Windows and macOS separately.

The included Java versions have been updated with the current release.

  • 17.0.9+9 --> 17.0.10+7 (Default - the version delivered with the FirstSpirit Launcher)
  • 21+35 --> 21.0.2+13

6 System

Updates to integrated third-party software

As of the current release, the following internally used software has been updated:

  • Spring Boot
    Update from version 3.1.2 to version 3.2.2
  • Google Guava
    Update from version 31.1 to version 33.0.0
  • TinyMCE
    Update from version 6.7.0 to version 6.8.2
  • Google Web Toolkit (“GWT”)
    Update from version 2.10.0 to version 2.11.0
  • Apache FOP (Formatting Objects Processor)
    Via the module fs-fop.fsm (for the output of FirstSpirit content in PDF format).
    Updated from version 2.8 to version 2.9.
  • Log4j
    Updated from version 2.19.0 to version 2.22.1

Overview

ID Description Categories
CORE-9816

When defining default values, a CMS_COMMENT form component was shown as an error if it was defined as a standalone CMS_GROUP tab.

SiteArchitect, Template Development
CORE-15734

When editing rules in SiteArchitect, additional checks are now performed when saving, such as checking for missing editor elements. Previously, such errors only became visible during rule evaluation.

Dynamic Forms, Template Development
CORE-15830

The Log4j version has been updated from 2.19.0 to 2.22.1. Please note the deprecation of the logging configuration in Log4j1 format.

Further information can be found in chapter “Administration: Discontinuation of the logging configuration in Log4j1 format”.

Server Administrator
CORE-15852

During the configuration of a SAML Identity Provider, the setting “Single Group/Role Attribute” is no longer required for the use of the SAML login module.

Server Administrator
CORE-15907

When outputting pages using the JSON function, the order of the content areas within the page is now correctly taken into account.

Developer
CORE-15955

The “AWS S3 Deployment” module now sets the correct MIME type for .webp and .webm files.

AWS S3 Deployment
CORE-15970

A problem with displaying outdated URLs of a page reference after an update has been fixed.

SiteArchitect
CORE-15977

A modified configuration of a web app component in the ServerManager now automatically activates the “Update” button, allowing for the web app to be reinstalled.

Server Administrator
CORE-15980

External images that were embedded in an output channel using Apache FOP and accessed through HTTP(S) were not displayed correctly. This issue has been resolved.

Modules
CORE-15986

The issue with loading the CorporateContent packages on a server has been resolved.

Corporate Content
CORE-15989

With the current release, the Java versions have been updated.

Further information can be found in chapter “SiteArchitect / ServerManager: Java version update”.

Launcher
CORE-16011

The Jakarta EE Migrator for web applications introduced with FirstSpirit 2023.9 will no longer be available with version 2024.9.

Further information can be found in chapter “Administration / Modules: Discontinuation: Automatic Jakarta EE Migrator for WebApps”.

Modules, Server Administrator
CORE-16013

The installation of the “FS INTEGRATION” web component from the “FirstSpirit Dynamic Database Access” module (fs-integration.fsm) in the ContentCreator or the preview web app led to an exception.

Server Administrator
CORE-16028

FirstSpirit Content Experience Tools: Latest module versions

Further information can be found in chapter “FirstSpirit Content Experience Tools (CXT): Latest module versions”.

FirstSpirit Content Experience Tools (CXT)
CORE-16029

The use of websockets was temporarily disabled in FirstSpirit version 2024.2 because there were very rare cases of issues with their use. With the current version of FirstSpirit, websockets can be used again.

Server Administrator
CXT-3149

A misbehavior in the data source management has been corrected when the current user did not have read permissions for a part of the data sources.

ContentCreator
CXT-3153

Updates to integrated third-party software

Further information can be found in chapter “System: Updates to integrated third-party software”.

Integrated software
CXT-3156

Rule violations in forms were not highlighted correctly.

ContentCreator
CXT-3170

In the DOM editor, it was not possible to position the text cursor behind a link at the end of a line with a single mouse click.

ContentCreator
CXT-3173

The <CONTAINS> condition in the rule definition is now also supported for FS_CATALOG in ContentCreator.

ContentCreator
CXT-3174

The current preview language is now retained for the preview of datasets within the data source management.

ContentCreator
CXT-3175

Under certain circumstances, CMS_INPUT_DATE input components could display an incorrect value in the form where the date was off by one month.

ContentCreator
CXT-3176

In the snippet view within the data source management, remote media thumbnails were not displayed.

ContentCreator
CXT-3186

When creating datasets, there could be cases where CMS_INPUT_DATE input components would result in a incorrectly stored timestamp.

ContentCreator
DEVEX-632

With the FSDevTools release 4.7.1, it is possible to execute Beanshell scripts in the FirstSpirit context.

Further information can be found in chapter “External Synchronization: FSDevTools: Execute Beanshell scripts”.

FSDevTools

Deprecations

Functionality Deprecated as of Will be removed / Was removed as of
Input component CMS_INPUT_CONTENTAREALIST 5.2R3
Input component CMS_INPUT_CONTENTLIST 5.2R3
Input component CMS_INPUT_FILE 5.2R3
Input component CMS_INPUT_LINKLIST 5.2R3
Input component CMS_INPUT_OBJECTCHOOSER 5.2R3
Input component CMS_INPUT_PAGEREF 5.2R3
Input component CMS_INPUT_PICTURE 5.2R3
Input component 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 for FirstSpirit 2019-05
Database layer for Oracle Database 11g/12c 2020-12 2025-05
FirstSpirit Access API: redirectTemplateLogToDefaultLog() (Interface RenderingAgent.Renderer) 2021-05
Support for Log4j 1 2022-05 2024-06