Release Notes FirstSpirit™ 2023.5

Release Notes

FirstSpirit™ 2023.5

1 Administration

Update of internally used software

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

  • Apache FOP (Formatting Objects Processor)
    Via the module fs-fop.fsm (for the output of FirstSpirit content in PDF format).
    Updated from version 2.5 to version 2.8.
    Furthermore, Apache Batik was updated to version 1.16 in the module.
    Note: Besides closing several security holes, this also results in a better display of SVG graphics in the generated PDF files.
  • Commons FileUpload
    Updated from version 1.3.1 to version 1.5

2 General

JSON size limit for JSON generation with json() function

In the JSON output configuration, the json.outputLengthLimit parameter can be used to set a size limit in bytes for the JSON file to be generated. If the set value is exceeded, the generation of the JSON file is aborted with an error message, the non-valid file is not deleted. Without setting the value, the file size will be limited to 2GB.

Example (size limit at 15MB):

$CMS_SET(#global.json.outputLengthLimit, 15728640)$

3 FirstSpirit Content Experience Tools (CXT)

3.1 Latest module versions

FirstSpirit 2023.5 supports the following module versions for “FirstSpirit Content Experience Tools”.

Module / file nameVersion number
FirstSpirit CXT Plattform
platform-[version].fsm
3.0.7
FirstSpirit CXT DAP Bridge
dataservice-[version].fsm
1.44.11
FirstSpirit CXT FragmentCreator
fragment-creator-[version].fsm
4.0.5
FirstSpirit Fragment DAP
fragmentdap-[version].fsm
1.40.18
FirstSpirit Media DAP
mediadap-[version].fsm
1.31.10*
FirstSpirit PageRef DAP
pagerefdap-[version].fsm
1.9.910
FirstSpirit Markdown Editor
markdown-editor-[version].fsm
1.29.9*
FirstSpirit Tagging Editor
tagging-editor-[version].fsm
1.29.9
FirstSpirit CXT FragmentCreator - CaaS Integration
caas-integration-[version].fsm
1.31.10

* These modules require FirstSpirit 2020-03 or higher from this version.

3.2 MicroApp connection logic

The CXT MicroApp API URL configuration was moved from the “FirstSpirit FragmentDAP” module (Web component “Fragment DAP for ContentCreator”) to the “FirstSpirit CXT Platform” module (“CXT Platform | Configuration Service”) starting with version 3.0.6.

CXT-Platform Configuration Service
CXT-Platform Configuration Service

The “CXT-Platform | Configuration Service” provides a configuration interface that can be opened by clicking on “Configure” or by double-clicking on the service. Here, the URL to the MicroApp is configured. In this case, the URL is used to integrate the CXT MicroApp API into a website.

This is the value of the cxt.platform.external-url parameter configured for the CXT platform (see Installation / Modules / Installing modules / Platform (→Documentation “Content Experience Tools”)):

https://external/cxt-platform/microapps/api.js

4 Module Development, Scripts, API

RenderingAgent: rendering result for processing

The interface RenderingAgent (package de.espirit.firstspirit.agency, FirstSpirit Developer API) allows to manage the generating process for certain dynamic FirstSpirit content directly via the API.

With the new method getResult(@NotNull Writer contentWriter, @Nullable Writer logWriter), the rendering results are written directly into the transferred writers.

Overview

ID Description Categories
CORE-15200

Update of internally used software

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

Integrated software, Media, Modules
CORE-15217

The handling of bookmarks created with very old FirstSpirit versions has been improved.

Bookmarks, Project export / import
CORE-15223

A security issue allowed to access user credentials from connected third-party systems. The issue has been fixed.

Security
CORE-15224

In very rare cases, a permanently high CPU utilisation could occur when processing images.

Media Store, Server Administrator
CORE-15247

It could happen that datasets which were never released prevented the creation of features that used the release status. The problem has been resolved.

Content Transport
CORE-15253

When generating JSON with the json() function, a size limit can be set.

Further information can be found in chapter “General: JSON size limit for JSON generation with json() function”.

Support for JSON
CORE-15255

In very rare cases, a problem with accessing a Berkeley database competitively could occur. The problem has been resolved.

Repository
CORE-15259

The FirstSpirit server could change to the degraded status when the search index was recalculated (“Rebuild Search Index” schedule). The high utilisation on the server caused by this schedule is as expected. It will not lead to a change in the status of the server in the future.

ServerMonitoring
CORE-15261

When content is output using the JSON function and a circular dependency is detected, the log file will contain additional information. A render stack of the processed elements will be included in which the first occurrence of the duplicate element is highlighted.

Developer, Support for JSON
CORE-15280

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

In the RenderingAgent interface (package de.espirit.firstspirit.agency, FirstSpirit Developer API), a new method getResult(...) has been added. With the new method, the rendering results are written directly into the transferred writers.

Further information can be found in chapter “Module Development, Scripts, API: RenderingAgent: rendering result for processing”.

Developer, FirstSpirit API
CXT-1485

The CXT platform now supports closing modal MicroApp dialogs with ESC .

FirstSpirit Content Experience Tools (CXT)
CXT-1710

Moving the configuration for the CXT MicroApp API URL from the “FirstSpirit FragmentDAP” module (version 1.40.18) to the “FirstSpirit CXT Platform” module (version 3.0.6).

Further information can be found in chapter “FirstSpirit Content Experience Tools (CXT): MicroApp connection logic”.

FirstSpirit Content Experience Tools (CXT)
CXT-2871

Under certain circumstances it could happen that some actions, e.g. displaying of references or the history of an element, were not executed. The problem has been resolved.

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