Release Notes FirstSpirit™ 2022.5

Release Notes

FirstSpirit™ 2022.5

1 Administration

1.1 Update of internally used software

As of the current release, the following internally used software for FirstSpirit Content Experience Tools (CXT) has been updated:

  • Spring Boot
    Update to version 2.6.6

1.2 Logging: Log4j-Update to Version 2.x

Modules must not ship their own “log4j” implementation, otherwise this will cause severe problems running FirstSpirit.

FirstSpirit uses “Apache Log4j” as the logging framework. Last, but not least, for optimal protection from security gaps in integrated third-party software (keyword: “Log4Shell”), FirstSpirit-Logging has now been updated with the latest release to the current version of “Log4j 2” (Version 2.17.2).
Because asynchronous loggers are used, version line 2.x is significantly faster than the previously used “Log4j 1” version and offers an extended scope of functions.

In spite of the implementation differences between “Log4j 1” and “Log4j 2”, migration measures to be taken by FirstSpirit users are generally not required (e.g., with respect to the configuration) when the standard logging functions of FirstSpirit are used because the Log4j 1.2 Bridge is used (https://logging.apache.org/log4j/2.x/manual/migration.html#Log4j1.2Bridge): With this, the use of the current API can continue; however, method calls are mainly sent to the new API.

With respect to error logging, the update to “Log4j 2” may cause a changed log level in some cases.

It is recommended not to use “Log4j” directly but to use the logging classes provided by FirstSpirit instead.

Important: In a future release, the support for “Log4j 1” will be discontinued permanently. The bridge will then be removed and all applications of “Log4j 1” must be converted to the requirements of “Log4j 2” by the customer.

Important: With the update to “Log4j 2”, known standard applications and default configurations of “Log4j ” were taken into consideration during implementation and quality assurance. In case of specific application cases that have not yet been taken into consideration, contact e-Spirit Technical Support.

For more information on logging via “Apache Log4j” in FirstSpirit, see https://docs.e-spirit.com/odfs/edocs/admi/firstspirit-ser/configuration-f/logging-configu/index.html.

1.3 Modules and extensions for FirstSpirit 2022.5

The following modules and extensions are compatible with FirstSpirit 2022.5:

Module name/File nameVersion numberCompatibility
FirstSpirit Update Archive
fs-update-[version].tar.gz
3.0.0-
FirstSpirit Install Archiv
fs-install-[version].tar.gz
3.0.0-
FirstSpirit Launcher
FSLauncher.exe
1.0.43as of FirstSpirit 2018-08
FirstSpirit Launcher JRE module
fs-launcher-jre-[version].fsm
1.19as of FirstSpirit 2020-11
FirstSpirit SAML Login module
fs-saml-login-[version].fsm
1.3as of FirstSpirit 2019-02
FSDevTools
fs-cli-[version].tar.gz
fs-cli-[version].zip
4.0.0as of FirstSpirit 2021-07
FirstSpirit Module Gradle Plugin
firstspirit-module-gradle-plugin-[version].jar
3.0.3as of FirstSpirit 2019-06

1.4 Update of fs-cli

“fs-cli” (FSDevTools) uses as of version 4.0.0

  • “Log4j” in version 2.17.2 and
  • “SLF4J” in version 1.7.36

In addition to the corresponding jar file, current fs-cli.cmd or fs-cli.sh files must also be used in the lib directory. The supplied log4j2.xml file from the conf directory must also be used.

2 ContentCreator

2.1 Image cropping: The selected crop selection is too small

When manually cropping images in the FirstSpirit ContentCreator, a corresponding text is now displayed if the crop selection is too small. In addition to the target size of the respective resolution, the text also contains the pixel dimensions of the selected section:

UID=contentcreator_bildausschnitt_zu_klein

2.2 Element Status Provider: display of the state of referenced elements

The WorkflowGroup (Package de.espirit.firstspirit.workflow, FirstSpirit Developer API) package has been extended with the optional hasReleaseStateDetection method. Additionally, the corresponding WebeditElementStatusProviderPlugin.Factory was extended with another create method with an additional detectReleaseState parameter. The behavior for the already existing method remains unchanged.

Normally, the overall state of a page is determined via the getReleaseState method in WebeditElementStatusProviderPlugin. Depending on the plugin, this can also include referenced objects of the page. The WorkflowGroup that belongs to the contextual page is thereby displayed in the identified overall state.

In special scenarios, such as when more than one WorkflowGroup is used, it may be desirable to show certain groups without the detected overall state. The optional detectReleaseState parameter ensures that the state of the group is detected automatically on the basis of the referenced objects.

For more information, see

2.3 Create new pages

In projects that do not yet contain pages, the first pages can now also be created with the FirstSpirit ContentCreator.

For this purpose, the “Create new page” dialog (Menu “New - Create new page”) has been extended with the menu item (Root node) “Menu Structure”:

UID=contentcreator_neue_seite_anlegen

2.4 Improvement of drag-and-drop mechanisms

The FirstSpirit ContentCreator allows intuitive operation using drag-and-drop in many different places.
With the latest release, some mechanisms were improved, e.g.,

  • Invalid drop targets are grayed out.
  • A successful drop in CMS_INPUT_DOM is now temporarily visualized with green background color:

UID=contentcreator_drop_im_dom

3 FirstSpirit Content Experience Tools (CXT)

Latest module versions

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

Module / file nameVersion number
FirstSpirit CXT Plattform
platform-[version].fsm
2.5.5
FirstSpirit CXT DAP Bridge
dataservice-[version].fsm
1.44.5
FirstSpirit CXT FragmentCreator
fragment-creator-[version].fsm
3.4.9
FirstSpirit Fragment DAP
fragmentdap-[version].fsm
1.40.10
FirstSpirit Media DAP
mediadap-[version].fsm
1.31.5*
FirstSpirit PageRef DAP
pagerefdap-[version].fsm
1.9.5
FirstSpirit Markdown Editor
markdown-editor-[version].fsm
1.29.4*
FirstSpirit Tagging Editor
tagging-editor-[version].fsm
1.29.4
FirstSpirit CXT FragmentCreator - CaaS Integration
caas-integration-[version].fsm
1.31.5

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

Overview

ID Description Categories
CORE-5002

With the latest release, FirstSpirit-Logging now uses the current version string of the logging framework “Apache Log4j” :“Log4j 2”.

Support for “Log4j 1” will be discontinued with a future release.

Further information can be found in chapter “Administration: Logging: Log4j-Update to Version 2.x”.

Developer, FirstSpirit Administrator, Integrated software, Monitoring
CORE-13597

An error has been eliminated, which, in very rare cases, could cause an incomplete release of a subscribed parts tree when using auto-release with FirstSpirit Corporate Content.
This applies to nodes that can be released. If the release is not possible due to errors (e.g., validation), it will not be executed and noted in the Corporate Content logging accordingly.

Corporate Content, Developer, Editor, FirstSpirit Administrator, Workflow
CORE-14049

FirstSpirit Server are no longer supported in the “Legacy mode”. The most recent release has removed all Legacy implementations and their applications.

Note: These changes do not affect the functionality of (Legacy) modules.

Developer, FirstSpirit Administrator, Module development, Modules
CORE-14075

An error has been eliminated that, in very rare cases, could result in java.lang.IllegalStateException: Circular service dependency detected: when starting a service.

FirstSpirit Administrator, Monitoring
CORE-14216

Project components that have been removed from a project are now no longer included in project exports.

FirstSpirit Administrator, Project export / import
CORE-14275

If the “Jetty Web Server” was configured without port indication, but the corresponding service is started at the server start anyway, a JettyServiceException was previously logged as ERROR. Now, only a WARN with an informational error text is issued in this case.

FirstSpirit Administrator, Web server
CORE-14277

Specific icons are now displayed for a faster identification for additional file types: Audio: wma, mid, m4a, mka, flac, ogg, opus, mp2, aac, Video: mkv, webm, Archive: 7z.

ContentCreator, Editor, Media, Media Store, SiteArchitect
CORE-14279

An error has been fixed, which, in very rare cases could cause that datasets (“Entities”) were created in duplicate at the target with transport via FirstSpirit ContentTransport or ExternalSync.

Content Store, Content Transport, Database, Developer, External synchronization, FirstSpirit Administrator
CORE-14281

The Element Status Provider can now return WorkflowGroups with a visualized status that is automatically determined based on the referenced objects.

Further information can be found in chapter “ContentCreator: Element Status Provider: display of the state of referenced elements”.

ContentCreator, Developer, FirstSpirit API, Workflow
CORE-14284

For the duration of the establishment of a DAP (DataAccessPlugin) session, the correct values are now logged in the log (only for analytic purposes in log level TRACE), e.g., TRACE 30.03.2022 16:21:53.817 (de.espirit.firstspirit.client.plugin.dataaccess.DataAccessSessions): DataAccessPlugin(cloudinary-integration/Cloudinary DAP) - 101150705 - DAS#createSession took '33ms.

FirstSpirit Administrator, Monitoring
CORE-14299

In the CSV files containing statistics information that can be downloaded via FirstSpirit ServerMonitoring, finished actions with a start time prior to the time of the server start are now no longer displayed.

FirstSpirit Administrator, Monitoring, ServerMonitoring
CORE-14320

FirstSpirit now checks the use of the web components of the installed modules at startup and whenever the fs-server.conf file (i.e. the server configuration) is changed. Invalid references (e.g. in manually deleted web applications) are cleaned up in the process.

FirstSpirit Administrator, Module development, Modules
CORE-14329

Media handling was improved so that temporary files are no longer used in case of the respective accesses.

FirstSpirit Administrator, Media, Monitoring, Performance
CORE-14337

FirstSpirit Content Experience Tools: Latest module versions

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

Developer, FirstSpirit Administrator, FirstSpirit Content Experience Tools (CXT), FragmentCreator, Modules
CORE-14367

Modules and extensions for FirstSpirit 2022.5.

Further information can be found in chapter “Administration: Modules and extensions for FirstSpirit 2022.5”.

Developer, FSDevTools, FirstSpirit Administrator, Launcher, Modules
CXT-2394

An error has been fixed that, in rare cases, could lead to the change not being saved when editing section references in the ContentCreator.

ContentCreator, Editor
CXT-2452

Logging has been adjusted when setting or removing bookmarks. For timing reasons, incorrect messages of the type Refreshing report 'Bookmarks' failed, identifier is unknown. could occur before.

Bookmarks, ContentCreator, Editor
CXT-2508

With the latest release, some drag-and-drop mechanisms were improved in the FirstSpirit ContentCreator.

Further information can be found in chapter “ContentCreator: Improvement of drag-and-drop mechanisms”.

ContentCreator, Editor
CXT-2547

If available, bookmarks on pages or in sections now displays the corresponding page reference instead of the page so that it is now also possible to synchronize the navigation bar accordingly.

Bookmarks, ContentCreator, Editor, Navigation view, Reports
CXT-2569

Cropping of very large images and/or various resolutions in the FirstSpirit ContentCreator was improved so that a 504 error/Gateway Timeout can no longer occur.

ContentCreator, Editor, Media, Media Store
CXT-2571

In projects that do not yet contain pages, the first pages can now also be created with the FirstSpirit ContentCreator.

Further information can be found in chapter “ContentCreator: Create new pages”.

ContentCreator, Editor
CXT-2585

In the FirstSpirit ContentCreator, changes in image maps (CMS_INPUT_IMAGEMAP) are now correctly recognized again. The “Save” button was temporarily disabled with changes.

ContentCreator, Editor
CXT-2588

When manually cropping images in the FirstSpirit ContentCreator, a corresponding text is now displayed if the crop selection is too small.

Further information can be found in chapter “ContentCreator: Image cropping: The selected crop selection is too small”.

ContentCreator, Editor, Media
CXT-2591

Update of internally used software

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

FirstSpirit Content Experience Tools (CXT), Integrated software
DEVEX-537

The libraries used by “fs-cli” (FSDevTools) for “Log4j” and “SLF4J” have been updated.

Further information can be found in chapter “Administration: Update of fs-cli”.

Developer, FSDevTools, FirstSpirit Administrator, Integrated software
DEVEX-539

With the current release, “fs-cli” calls (FSDevTools) ending with a double quote (") can be made again.

Developer, 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