Release Notes

If a content projection page is set as the start page of a folder, it was not previously provided with a “welcome file name” (e.g. index.html) if the “Advanced URL Creator” was configured accordingly (parameter useWelcomeFilenames).

This behaviour has been changed if the defined number of entries per page is not equal to 1. In this case, the [first] page of the content projection is now provided with the “welcome file name”.

As of release 2022.3, Java 17 has been officially approved for use with FirstSpirit.

Beginning with the FirstSpirit release 2023.1, the recommended Java version for operating FirstSpirit will change to Java 17.

The creation of derby layers can now be hidden with

internalDB.hide=true 

in the fs-server.conf to prevent the creation of derby layers.

This hides the places in the GUI where a Derby DB can be configured. Accidental use of this database, which is not suitable for productive use, is thus prevented.

With the current FirstSpirit release it is possible to import projects via fs-cli (FSDevTool) as a project administrator.

Previously, this was only possible for server administrators.

The parameter devProjectAdminPermissions=true in fs-server.conf can be used to configure that project administrators of any project on the server will be allowed to import other projects. This is possible via API or via fs-cli (commands project import or import with specification of a new project name). The corresponding user is automatically added to this project as project administrator.

Note: The parameter does not allow project administrators to create a new project via the FirstSpirit ServerManager.

With the current FirstSpirit release, the detection of conflicts caused by module resources in the server scope has been improved.

Conflict detection takes place when modules are installed and results are logged and visualised accordingly.

ServerManager Module Overview

In the overview list of modules (“ServerManager / Server / Properties / Modules”) , problems with and between modules are now visualised.

ServerManager Module Overview

INFO: Modules that put resources on the global classpath, or contain unknown resources.

Resource may influence other modules (INFO)
The module generally brings a global resource, but no other module brings it (yet).

Unnamed resource found (INFO)
The module brings a global resource that has no “name” attribute, and thus cannot be identified or compared.

WARN: Problems are pointed out which can have an impact on the functionality of FirstSpirit or the corresponding modules. Either FirstSpirit jars have been integrated here or resources have been placed on the global classpath that are also brought along by other modules.

Resource may negatively impact other modules (WARN)
The module brings a global resource that is also brought by at least one module.

Module may be negatively impacted by global resources (WARN)
The module brings a private resource, which is additionally brought by another module as a global resource.

FirstSpirit artifact detected (WARN)
The module brings a FirstSpirit artefact.

A yellow exclamation mark is displayed when a module embeds resources in a way that will no longer be supported in the future (legacy resources).

Legacy resource found (WARN)
The module brings a legacy resource.

Note: Only the icon with the highest level of severity is displayed.

The button “Show Resource Issues” can be used to display corresponding conflicts.

The command line tool FSDevTools simplifies export and import operations between a FirstSpirit project and the file system via predefined commands. From FSDevTools version 4.1.0 the “FirstSpirit ContentTransport” functionality is supported.

It is now possible via the command feature,

• display the features of a project (list),
• download features (download),
• analyse features to see if they can be imported into a project (analyse),
• import features into a project (import).

Additionally, as of FSDevTools version 4.3.0, it is possible to adjust the revision of a feature (revision) in order to enable the download of the data contained therein with any revision.

The documentation of the individual commands and their parameters can be found as usual in HTML format in the release under docs/index.html or can be called up via the command line (fs-cli help feature).

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

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

The “FirstSpirit Module Gradle Plugin” is now publicly available on GitHub. In the repository (https://github.com/e-Spirit/firstspirit-module-gradle-plugin) you can find the complete source code as well as a detailed README describing the usage and various example projects.