Release Notes FirstSpirit™ 2024.8

Release Notes

FirstSpirit™ 2024.8

1 Administration

1.1 Set initial admin password via environment variable

For a newly installed FirstSpirit server, the password for the admin user can now be set with an environment variable FS_ADMIN_PASSWORD.

If the admin user has already been created, the environment variable has no effect.

1.2 Permissions check for Content Transport

With the current FirstSpirit version, there is a new option in the project properties called "Permissions check for Content Transport".

Permissions check for Content Transport
Permissions check for Content Transport

If this checkbox is enabled, it is requisite that the user possesses all necessary permissions for all adjustments (including changing, creating, and deleting) to be performed during the feature installation in the target project.

If the checkbox is disabled, no permissions check is performed during feature installation.

This option is enabled by default when creating a new project.

For existing projects, it is necessary to activate the checkbox if a permissions check is desired.

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.

With the current FirstSpirit version 2024.8, a warning message appears on the FirstSpirit start page for server or project administrators if web components are still being used in a global or project-local web application that are not marked as Jakarta-compliant (i.e. not marked with Servlet API 6.0).

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 FirstSpirit Content Experience Tools (CXT)

Latest module versions

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

Module / file nameVersion number
FirstSpirit CXT Plattform
platform-[version].fsm
6.1.6
FirstSpirit CXT DAP Bridge
dataservice-[version].fsm
1.44.24
FirstSpirit CXT FragmentCreator
fragment-creator-[version].fsm
5.0.11
FirstSpirit Fragment DAP
fragmentdap-[version].fsm
1.40.32
FirstSpirit Media DAP
mediadap-[version].fsm
1.31.22
FirstSpirit PageRef DAP
pageref-[version].fsm
1.9.22
FirstSpirit Markdown Editor
markdown-editor-[version].fsm
1.29.22
FirstSpirit Tagging Editor
tagging-editor-[version].fsm
1.29.22
FirstSpirit CXT FragmentCreator - CaaS Integration
caas-integration-[version].fsm
1.31.22
FirstSpirit Image Assistant
imagerecognition-module-[version].fsm
1.0.50
FirstSpirit Analyze Asisstant
FirstSpirit-AiAnalyze-[version].fsm
0.9.3 (Beta)
Template Development MicroApp
fs-sitedev-microapp-[version].fsm
0.9.31
FirstSpirit Multisite Management
fs-multisite-[version].fsm
0.30.7

4 FirstSpirit Omnichannel Manager

Release: Omnichannel Manager 3.0

With the current version of FirstSpirit, the Omnichannel Manager 3.0 is officially released.

The Omnichannel Manager (OCM) is an integral part of cross-platform content management in FirstSpirit. In combination with the FirstSpirit ContentCreator, the OCM allows preview editing of external applications, enabling editors to make changes and see them in real time.

For more information, see the documentation for the Omnichannel Manager 3.0.

Support for Omnichannel Manager 2.x will be discontinued in the medium term.

5 AI-powered tools

5.1 AI-powered tools: Analyze Assistant (Beta status)

The Analyze Assistant helps the editor in the ContentCreator to carry out text-related analyses on the displayed page in the current language and to directly implement the suggested improvements.

With the current release, Crownpeak is expanding the user circle to obtain further feedback and insights from partners and clients on the functionality that results from concrete use cases.
The functionality itself has already been subjected to intensive quality assurance. However, it has not yet been officially released. So, if you are interested, we recommend that you first test it in a development environment.

For more information, see the documentation for the Analyze Assistant.

Note: A corresponding license is required to use the Analyze Assistant as well as other AI-powered tools.

5.2 AI-powered tools: Content Assistant

With the current version of FirstSpirit, the Content Assistant is officially released.

The Content Assistant supports editors in ContentCreator in creating and editing content more efficiently and intuitively. Through intelligent automation, the Content Assistant facilitates daily workflows and contributes to higher productivity.

For more information, see the documentation for the Content Assistant.

Note: A corresponding license is required to use the Content Assistant as well as other AI-powered tools.

5.3 AI-powered tools: Image Assistant

With the current version of FirstSpirit, the Image Assistant is officially released.

In the ContentCreator, alt text can be automatically generated for uploaded images with the help of AI. AI-assisted alt text generation is an extension of the automatic image cropping functionality.

For more information, see the documentation for the Image Assistant.

Note: A corresponding license is required to use the Image Assistant as well as other AI-powered tools.

6 Module Development, Scripts, API

Removal of Internally Used Components

As of release 2024.8, some internally used components were removed. This affects the following library:

  • Apache HttpClient 4.5.14

Modules that still use “Legacy Mode” and the library accessible (in this mode) via FirstSpirit may need to be adapted accordingly.
Note: Since “Legacy Mode” is no longer supported, affected modules should be switched to “Isolated Mode” if possible (see Module development "Isolated").

As a temporary solution, the “Legacy Libraries” module (fs-legacy-libraries.fsm) can be installed (available through Customer Support). This module contains libraries that were previously delivered with FirstSpirit.

The module provides the following libraries as legacy resources:

  • org.apache.httpcomponents:fluent-hc in the version 4.5.14
  • org.apache.httpcomponents:httpclient in the version 4.5.14
  • org.apache.httpcomponents:httpclient-win in the version 4.5.14
  • org.apache.httpcomponents:httpcore in the version 4.4.16
  • org.apache.httpcomponents:httpmime in the version 4.5.14

Overview

ID Description Categories
CORE-11185

Within form rules, complex editor values can now be used in a ValueService (e.g., for an FS_REFERENCE input component). In addition, optimizations have been made regarding the frequency of rule executions.

Dynamic Forms
CORE-13719

The countries configured in the browser are taken into account by FirstSpirit, e.g., English (United Kingdom) and English (United States). Accordingly, the correct calendar week is displayed in the date selection dialog.

Languages, SiteArchitect
CORE-14113

FirstSpirit now automatically removes outdated module files during server startup if an updated module version is available.

Server Administrator
CORE-15931

With the current FirstSpirit version, there is a new option in the project properties called "Permissions check for Content Transport".

Further information can be found in chapter “Administration: Permissions check for Content Transport”.

Content Transport, Permissions
CORE-16132

A problem with the timeout of revisions during the import via feature transport has been fixed.

Content Transport
CORE-16158

The call of a constructor of the class Attachment (FirstSpirit API, package de.espirit.firstspirit.access) could lead to a NoClassDefFoundError in the context of an application server.

FirstSpirit API
CORE-16201

The deployment of web applications to an external Tomcat server has been optimized.

Server Administrator
CORE-16257

When using the embedded Tomcat web server, in certain situations the management interface in the ServerManager might not be displayed correctly.

Server Administrator
CORE-16266

For the “Embedded Tomcat” module, the version of the application server used has been updated to 10.1.24.

Server Administrator
CORE-16272

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

The performance when accessing the server's language templates has been improved.

Performance
CORE-16303

A call to the export functionality via a Beanshell script could lead to an exception.

FirstSpirit API
CORE-16306

Limiting the logging level to WARN could lead to an inconsistent state in FirstSpirit, preventing web applications from starting.

Server Administrator
CORE-16322

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

Removal of Internally Used Components

Further information can be found in chapter “Module Development, Scripts, API: Removal of Internally Used Components”.

Integrated software
CORE-16352

The installation of web applications on a web server of the type "Embedded Tomcat" did not result in an error message when the corresponding service was stopped.

Server Administrator, Web server
CORE-16355

When saving text media with special characters, it could happen that not all lines were retained.

Template Development for ContentCreator
CORE-16369

The initial admin password can be set via the environment variable.

Further information can be found in chapter “Administration: Set initial admin password via environment variable”.

Server Administrator
CORE-16370

For the "FirstSpirit Multisite Management" module, an update to the current Spring version has been carried out. This update removes the possibility of a subsequent downgrade to a version older than 0.30.7.

Multisite Management
CORE-16377

With the current version of FirstSpirit, the Omnichannel Manager 3.0 is officially released.

Further information can be found in chapter “FirstSpirit Omnichannel Manager: Release: Omnichannel Manager 3.0”.

FirstSpirit Omnichannel Manager
CORE-16383

Beta status for the AI-powered tool Analysis Assistant.

Further information can be found in chapter “AI-powered tools: AI-powered tools: Analyze Assistant (Beta status)”.

AI-powered tools
CORE-16393

With the current version of FirstSpirit, the Image Assistant is officially released.

Further information can be found in chapter “AI-powered tools: AI-powered tools: Image Assistant”.

AI-powered tools
CXT-3324

With the current version of FirstSpirit, the Content Assistant is officially released.

Further information can be found in chapter “AI-powered tools: AI-powered tools: Content Assistant”.

AI-powered tools

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