Release Notes FirstSpirit™ 2024.1

Release Notes

FirstSpirit™ 2024.1

1 Administration

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

1.2 Update of internally used software

As of the release 2024.1, the following internally used software has been updated.

  • Apache HttpClient
    Update to version 4.5.14 respectively 5.2.1
  • Apache PDFBox
    Update to version 1.8.17

1.3 Recognition of large images during scaling

The FirstSpirit server now optionally outputs a message in the log when a scalable image exceeds a specific size.

The threshold in megapixels can be specified through the newly added parameters in the configuration file fs-server.conf. The settings apply to both info and warning logging.

  • imageio.logging.largeImageInfo
    Default value: 75
  • imageio.logging.largeImageWarn
    Default value: -1

When the value is -1, the corresponding log message is disabled.

1.4 Websocket-Endpoint

For a client connection in HTTP mode, a web socket is used for data transfer if possible.

The websocket endpoint can be deactivated via the websocket.endpoint.enabled parameter in the configuration file fs-server.conf:

websocket.endpoint.enabled=false

Default value: true

2 External Synchronization / Content Transport

Transport of store element GIDs

To improve the discoverability of elements in distributed scenarios, the GIDs of store elements are also transported.

Import and update behaviour

The behavior surrounding GID import and updates is now aligned with the existing behavior observed during operations using external synchronization. Specifically, GIDs will be imported and updated under the following circumstances:

Here's the spell-checked and fixed version of the text:

  • GID Availability: GIDs will be imported only if they have not already been assigned to another element (whether in the Current or Release state). In cases where a GID conflict is detected, a warning will be logged.
  • Element Type: GIDs will be transported for elements that are not categorized as Datasets. This ensures that GIDs are appropriately managed for the relevant content.
  • Explicit Import: Elements explicitly imported or imported as children of explicit nodes will have their GIDs transported. This ensures that GIDs remain consistent throughout the hierarchy.
  • Implicit Import: GIDs will also be transported for elements that are implicitly imported and did not exist before the import operation. This facilitates the inclusion of GIDs in evolving content structures.
  • Newly Imported Parent Chain: When a parent chain is newly imported, GIDs for parent elements within this chain will be automatically carried over. This maintains coherence within the content hierarchy.

3 FirstSpirit Content Experience Tools (CXT)

Latest module versions

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

Module / file nameVersion number
FirstSpirit CXT Plattform
platform-[version].fsm
6.0.1
FirstSpirit CXT DAP Bridge
dataservice-[version].fsm
1.44.17
FirstSpirit CXT FragmentCreator
fragment-creator-[version].fsm
5.0.4
FirstSpirit Fragment DAP
fragmentdap-[version].fsm
1.40.26
FirstSpirit Media DAP
mediadap-[version].fsm
1.31.16
FirstSpirit PageRef DAP
pageref-[version].fsm
1.9.16
FirstSpirit Markdown Editor
markdown-editor-[version].fsm
1.29.15
FirstSpirit Tagging Editor
tagging-editor-[version].fsm
1.29.15
FirstSpirit CXT FragmentCreator - CaaS Integration
caas-integration-[version].fsm
1.31.15

4 SiteArchitect

Discontinuation: "Advanced Image Editing" function in SiteArchitect

The feature “Advanced Image Editing” uses a third-party component that is no longer actively developed. Therefore, this function will be discontinued with a future release of FirstSpirit.

Overview

ID Description Categories
CORE-15602

The transportation of GIDs of store elements is now achievable with ContentTransport through the FirstSpirit API by utilizing the FeatureInstallOptions interface (FirstSpirit Access API, package de.espirit.firstspirit.feature).

Further information can be found in chapter “External Synchronization / Content Transport: Transport of store element GIDs”.

Content Transport, FirstSpirit API
CORE-15706

For a client connection in HTTP mode, a web socket is used for data transfer if possible.

Further information can be found in chapter “Administration: Websocket-Endpoint”.

FirstSpirit Administrator
CORE-15779

The FirstSpirit server now optionally logs a message if a scalable image exceeds a certain size.

Further information can be found in chapter “Administration: Recognition of large images during scaling”.

Media, Server Administrator
CORE-15832

Discontinuation of the “Advanced Image Editing” Feature in SiteArchitect

Further information can be found in chapter “SiteArchitect: Discontinuation: "Advanced Image Editing" function in SiteArchitect”.

SiteArchitect
CORE-15833

Discontinuation 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-15837

In the context of the revision of the debug logging for CMS_RENDER, unnecessary log outputs were removed respectively classified with the log level Trace.

Developer, Logging
CORE-15839

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

A problem with deleting image crops for resolutions and setting image crops for resolutions with manually uploaded image content in SiteArchitect has been fixed.

Media, SiteArchitect
CORE-15880

Update of internally used software

Further information can be found in chapter “Administration: Update of internally used software”.

Integrated software
CXT-3101

In the DOM editor, the order of link templates and table format templates was corrected.

ContentCreator

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