Release Notes
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
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 name | Version number | Compatibility |
FirstSpirit Update Archivefs-update-[version].tar.gz | 3.0.0 | - |
FirstSpirit Install Archiv fs-install-[version].tar.gz | 3.0.0 | - |
FirstSpirit LauncherFSLauncher.exe | 1.0.43 | as of FirstSpirit 2018-08 |
FirstSpirit Launcher JRE modulefs-launcher-jre-[version].fsm | 1.19 | as of FirstSpirit 2020-11 |
FirstSpirit SAML Login modulefs-saml-login-[version].fsm | 1.3 | as of FirstSpirit 2019-02 |
FSDevToolsfs-cli-[version].tar.gzfs-cli-[version].zip | 4.0.0 | as of FirstSpirit 2021-07 |
FirstSpirit Module Gradle Pluginfirstspirit-module-gradle-plugin-[version].jar | 3.0.3 | as 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:

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
- https://docs.e-spirit.com/odfs/plug-developmen/contentcreator/interactive-fea/element-status/code-example/index.html
- https://docs.e-spirit.com/odfs/dev/de/espirit/firstspirit/workflow/WebeditElementStatusProviderPlugin.html
- https://docs.e-spirit.com/odfs/dev/de/espirit/firstspirit/workflow/WebeditElementStatusProviderPlugin.Factory.html
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”:

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:

3 FirstSpirit Content Experience Tools (CXT)
Latest module versions
FirstSpirit 2022.5 supports the following module versions for “FirstSpirit Content Experience Tools”.
| Module / file name | Version number |
FirstSpirit CXT Plattformplatform-[version].fsm | 2.5.5 |
FirstSpirit CXT DAP Bridgedataservice-[version].fsm | 1.44.5 |
FirstSpirit CXT FragmentCreatorfragment-creator-[version].fsm | 3.4.9 |
FirstSpirit Fragment DAPfragmentdap-[version].fsm | 1.40.10 |
FirstSpirit Media DAPmediadap-[version].fsm | 1.31.5* |
FirstSpirit PageRef DAPpagerefdap-[version].fsm | 1.9.5 |
FirstSpirit Markdown Editormarkdown-editor-[version].fsm | 1.29.4* |
FirstSpirit Tagging Editortagging-editor-[version].fsm | 1.29.4 |
FirstSpirit CXT FragmentCreator - CaaS Integrationcaas-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. |
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 |
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 |
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 |
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 |
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 |
Developer, FirstSpirit Administrator, FirstSpirit Content Experience Tools (CXT), FragmentCreator, Modules |
| CORE-14367 | 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 |
Bookmarks, ContentCreator, Editor |
| CXT-2508 | With the latest release, some drag-and-drop mechanisms were improved in the FirstSpirit ContentCreator. |
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. |
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 |