Release Notes FirstSpirit™ 2022.11

Release Notes

FirstSpirit™ 2022.11

1 Administration

1.1 ContentCreator für neue Projekte aktiv

In den Projekteigenschaften wird unter dem Menüpunkt „ContentCreator“ festgelegt, ob das Projekt im FirstSpirit ContentCreator bearbeitet werden kann (siehe FirstSpirit Dokumentation für Administratoren, „FirstSpirit ServerManager / Projekteigenschaften / ContentCreator“).

Ab der FirstSpirit Version 2022.11 wird bei der Neuanlage eines FirstSpirit Projektes der ContentCreator automatisch aktiviert.

ContentCreator für neue Projekte aktiv
ContentCreator für neue Projekte aktiv

1.2 Installieren/Deinstallieren von projektlokalen Web-Anwendungen nur für Server-Administratoren

Web-Anwendungen benötigen Ressourcen auf dem Webserver, die entsprechend eingeplant werden müssen. Um zu vermeiden, dass FirstSpirit-Web-Anwendungen ohne entsprechende Abstimmung auf einen Webserver installiert werden, wurden die Rechte, die zum Installieren/Deinstallieren dieser Web-Anwendungen benötigt werden, eingeschränkt.

Ab FirstSpirit-Version 2022.11 ist es nur noch Server-Administratoren möglich, Web-Anwendungen zu installieren und zu deinstallieren. Dies war bereits der Fall für globale Web-Anwendungen und wurde nun auch auf projektlokale Web-Anwendungen ausgeweitet.

Download und Aktualisieren von projektlokalen Web-Applikationen sind weiterhin auch für Projekt-Administratoren möglich.

2 Administration / Module

Treiber für die Berkeley DB V7 werden nun im FirstSpirit Server integriert

Seit dem Entfall der Unterstützung der Berkeley DB Versionen 3 und 5 in der FirstSpirit-Version 2018-11 wird ausschließlich die Berkeley DB V7 für das FirstSpirit Backend verwendet („FirstSpirit ServerManager / Projekt-Eigenschaften / Repository / Backend“).

Die entsprechenden Treiber für die Berkeley DB V7 werden nun im FirstSpirit Server integriert, so dass das bisher genutzte Standard-Modul fs-berkeleydb7.fsm nicht länger benötigt wird und beim Update des Servers automatisch entfernt wird.

Sollte Ihr Server mit der Version 2018-11 (oder älter) installiert worden sein, so können Sie die nicht benötigen Module fs-berkeleydb3.fsm und fs-berkeleydb5.fsm im Verzeichnis ~firstspirit/data/modules manuell löschen.

3 FirstSpirit Content Experience Tools (CXT)

3.1 Aktuelle Modul-Versionen

Folgende Modul-Versionen für „FirstSpirit Content Experience Tools“ werden von FirstSpirit 2022.11 unterstützt.

Modul- / DateinameVersionsnummer
FirstSpirit CXT Plattform
platform-[version].fsm
2.5.7
FirstSpirit CXT DAP Bridge
dataservice-[version].fsm
1.44.8
FirstSpirit CXT FragmentCreator
fragment-creator-[version].fsm
3.4.11
FirstSpirit Fragment DAP
fragmentdap-[version].fsm
1.40.12
FirstSpirit Media DAP
mediadap-[version].fsm
1.31.7*
FirstSpirit PageRef DAP
pageref-[version].fsm
1.9.7
FirstSpirit Markdown Editor
markdown-editor-[version].fsm
1.29.6*
FirstSpirit Tagging Editor
tagging-editor-[version].fsm
1.29.6
FirstSpirit CXT FragmentCreator - CaaS Integration
caas-integration-[version].fsm
1.31.7

* Diese Module benötigen ab dieser Version FirstSpirit 2020-03 oder höher.

3.2 Erweiterung und Änderung der MicroApp-JavaScript-API

Achtung! Folgende Änderungen werden mit dem nächsten FirstSpirit Release 2022.12 (November) aktiv.

Die MicroApps API wird geändert: es werden neue Methoden ergänzt und eine Methode umbenannt. Dies betrifft die JavaScript-Objekte

CxtMicroAppBridge
CxtMicroApps

Das Abfragen möglicher MicroApps erfolgte bisher über die Methode

getButtons

Die Methode wird umbenannt in

requestMicroAppActions

Bei dieser Abfrage kann eine Liste von

contextTypes (optional) 

und

clientIds (Pflichtfeld) 

übergeben werden.

MicroApps definieren selbst, welche contextTypes und clientIds sie unterstützen.
Mögliche clientIds sind beispielsweise

content-creator oder 
fragment-creator

Beispiel
vorher

window.CxtMicroApps.getButtons(context).then(...)

neu

window.CxtMicroApps.requestMicroAppActions(clientId, contextTypes, context).then(...)

4 Modul-Entwicklung, Skripte, API

API-Status über Annotation sichtbar machen

Die bereitgestellten Artefakte für Modulentwickler, etwa das fs-isolated-runtime.jar, enthalten jetzt Informationen darüber, ob Java-Methoden, Felder oder gar ganze Klassen nicht Teil der stabilen FirstSpirit-API sind. Dazu wird die von Jetbrains bereitgestellte Annotation @ApiStatus.Internal verwendet. So wird direkt in der IDE ersichtlich, welche Aufrufe problematisch sein können.

API-Status über Annotation
API-Status über Annotation

5 Module: AWS S3-Deployment

5.1 S3 Deployment bei fehlendem Generierungsverzeichnis

Wenn bei einer Generierung das Generierungsverzeichnis nicht erzeugt wird (z.B. bei einer Delta-Generierung ohne Änderungen), so wird ein folgendes S3 Deployment nun nicht mehr als fehlerhaft markiert.

Statt dessen wird das fehlende Generierungsverzeichnis dort mit einer INFO Meldung protokolliert und das S3-Deployment nicht durchgeführt, wobei der Auftragstask als erfolgreich markiert wird.

INFO ... (com.espirit.ps.aws.services.s3.execution.S3Executable): Staging Folder ... does not exist. Nothing to deploy. Stopping S3 Deployment.

5.2 Teilgenerierung: Auswertung der fullMatching List

Bei der Nutzung des AWS-S3-Deployment-Moduls ist es, über die Nutzung der fullMatching List, möglich auch bei partiellen Deployments einen Abgleich der Daten zu erzwingen.

Bisher war es dazu erforderlich, dass mindestens eine Datei in dem entsprechenden Teilbaum mit der lokalen Generierung erzeugt wurde. Ein Löschen kompletter Teilbäume war auf diese Art somit nicht möglich.

Weiterhin konnte der im Deployment konfigurierte S3 Folder selber nicht in die fullMatching List aufgenommen werden. Abgeglichen werden konnte erst ab der zweiten Ebene.

Beide Einschränkungen entfallen mit der neuen Version des AWS-S3-Deployment-Moduls.

Übersicht

ID Beschreibung Kategorien
CLOUDPROV-15

Die Auswertung der fullMatching List bei der Teilgenerierung wurde optimiert.

Weitere Informationen können dem Kapitel „Module: AWS S3-Deployment: Teilgenerierung: Auswertung der fullMatching List“ entnommen werden.

AWS S3-Deployment, FirstSpirit-Administrator
CORE-13876

Nach einem Projekt Export/-Import konnte es dazu kommen, dass in einem Auftrag ein in einer „Content Transport“ Aktion ausgewähltes Feature nicht gefunden wurde und neu ausgewählt werden musste.

Projektexport / Projektimport
CORE-14238

Es wurde ein Fehler behoben, der in seltenen Fällen nach der Aktualisierung eines Moduls zu Verbindungsfehlern bei von dem Modul registrierten Listenern führen konnte.

FirstSpirit-Administrator, Module
CORE-14309

Die Synchronisation des SearchManagers wurde verbessert, um sehr selten auftretende Probleme bei der parallelen Indexierung von Knoten in verschiedenen Projekten zu verhindern.

Aufträge, FirstSpirit-Administrator, Performance
CORE-14536

Ein Fehler bei der Referenzberechnung wurde korrigiert, der potentiell zu fehlenden ausgehenden Referenzen geführt hat.

FirstSpirit-Administrator
CORE-14608

Es wurde ein Fehler behoben, der in sehr seltenen Fällen dazu führen konnte, dass beim Versuch die Projekt-Einstellungen zu bearbeiten, der FirstSpirit ServerManager für einige Zeit nicht benutzbar war.

ServerManager
CORE-14642

Es wurde ein Fehler behoben, der dazu führen konnte, dass bei Verweiszielen, auf die der Benutzer keinen Zugriff hat, im SiteArchitect fälschlicherweise eine Fehlermeldung erzeugt wurde.

SiteArchitect
CORE-14651

Bei der Module-Entwicklung wird nun der API-Status der verwendeten FirstSpirit-APIs sichtbar.

Weitere Informationen können dem Kapitel „Modul-Entwicklung, Skripte, API: API-Status über Annotation sichtbar machen“ entnommen werden.

Modul-Entwicklung
CORE-14664

Die Treiber für die Berkeley DB V7 werden nun im Standard integriert, so dass das bisher genutzte Standard-Modul fs-berkeleydb7.fsm nicht länger benötigt wird und beim Update des Servers automatisch entfernt wird.

Weitere Informationen können dem Kapitel „Administration / Module: Treiber für die Berkeley DB V7 werden nun im FirstSpirit Server integriert“ entnommen werden.

Server-Administrator
CORE-14689

Bei der Verwendung von Sonderzeichen in Anzeigenamen konnte es in seltenen Fällen zu Darstellungsfehlern im SiteArchitect kommen. Dieses Verhalten wurde korrigiert.

SiteArchitect
CORE-14697

Durch eine Umstellung des „FirstSpirit Portal“ Modul („SAP Business Package for FirstSpirit“, fs-portal.fsm) mit FirstSpirit 2022.10 konnten einige Java-Klassen nicht gefunden werden, dies wurde behoben.

FirstSpirit-Administrator, Module
CORE-14701

Ab der FirstSpirit Version 2022.11 wird bei der Neuanlage eines FirstSpirit Projektes der ContentCreator automatisch aktiviert.

Weitere Informationen können dem Kapitel „Administration: ContentCreator für neue Projekte aktiv“ entnommen werden.

FirstSpirit-Administrator
CORE-14702

Das Installieren/Deinstallieren von projektlokalen Web-Anwendungen ist nur für Server-Administratoren möglich.

Weitere Informationen können dem Kapitel „Administration: Installieren/Deinstallieren von projektlokalen Web-Anwendungen nur für Server-Administratoren“ entnommen werden.

FirstSpirit-Administrator, Server-Administrator
CORE-14708

In sehr seltenen Fällen konnte es bei der Aktualisierung eines Moduls zu einer java.lang.IllegalArgumentException kommen, wenn dieses einen Service mitbringt, der bei einem fehlgeschlagenen Start keine Exception ausgibt (startService also erfolgreich war, isRunning aber false liefert).

Dieses Problem wurde behoben. Im fs-server.log wird nun in diesem Fall ein entsprechender Fehler ausgegeben, dass der Service nicht gestartet werden konnte:
ERROR ... (de.espirit.firstspirit.server.module.ServiceManagerImpl): Service not running '...' (module=..., version=..., componentClass=...)

Module
CORE-14720

Bei Sprachen mit Unterstrich funktionierte die Auswahl einer sprachabhängigen Datenquellen Spalte für den Text der Menü-Übersicht (Sitemap) in einer Content-Projektion nicht.

SiteArchitect
CORE-14723

Wurde die json()-Funktion innerhalb der integrierten Vorschau im ContentCreator verwendet, konnte es zu ungültigen Link-URLs kommen.

ContentCreator, JSON-Unterstützung
CORE-14737

Wenn bei einer Generierung das Generierungsverzeichnis nicht erzeugt wird, so wird ein folgendes S3 Deployment nicht durchgeführt.

Weitere Informationen können dem Kapitel „Module: AWS S3-Deployment: S3 Deployment bei fehlendem Generierungsverzeichnis“ entnommen werden.

AWS S3-Deployment
CORE-14748

Mit der FirstSpirit Version 2022.10 wurde eine Sicherheitsfunktion eingeführt, die den unbefugten Zugriff auf Vorschaudateien eingeschränkt hat. Diese Funktion konnte in sehr seltenen Fällen zu einer erhöhten Last auf dem FirstSpirit Server führen und im schlimmsten Fall die Berechnung der Vorschauseiten verhindern. Dieses Problem wurde behoben.

FirstSpirit-Administrator
CORE-14751

Die Speicherung der Informationen über die externen Gruppen der Benutzer wurde optimiert, so dass für diese deutlich weniger Speicher benötigt wird. Insbesondere auf Servern mit sehr vielen parallelen Benutzern, die in sehr vielen externen Gruppen sind, führt dies zu einer merklichen Verbesserung des Speicherverbrauchs.

FirstSpirit-Administrator
CORE-14757

FirstSpirit Content Experience Tools: Aktuelle Modul-Versionen

Weitere Informationen können dem Kapitel „FirstSpirit Content Experience Tools (CXT): Aktuelle Modul-Versionen“ entnommen werden.

Entwickler, FirstSpirit Content Experience Tools (CXT), FirstSpirit-Administrator, FragmentCreator, Module
CORE-14797

Der integrierte Browser konnte mit FirstSpirit 2022.10 nicht in das FirstSpirit Installationsverzeichnis ausgerollt werden. Dies konnte dazu führen, dass die integrierte Vorschau im SiteArchitect nicht funktionierte.

FirstSpirit-Administrator, Vorschau
CXT-2029

Bei der Verwendung der NewSectionOperation konnte es beim Abbrechen zu einer Fehlermeldung kommen, wenn die Seite bereits Validierungsfehler enthielt.

ContentCreator
CXT-2108

Im Fall von Netzwerkproblemen wurden Fehlermeldungen verbessert.

ContentCreator
CXT-2360

Die MicroApps API wird mit den nächsten FirstSpirit Version 2022.12 geändert: es werden neue Methoden ergänzt und eine Methode umbenannt.

Weitere Informationen können dem Kapitel „FirstSpirit Content Experience Tools (CXT): Erweiterung und Änderung der MicroApp-JavaScript-API“ entnommen werden.

Entwickler, FirstSpirit Content Experience Tools (CXT), Modul-Entwicklung
CXT-2691

An vielen Stellen werden für die Ermittlung von Anzeigenamen Schnipsel verwendet. In einigen Fällen wurden dort definierte Formatierungen vor der Anzeige nicht korrekt entfernt.

ContentCreator, Schnipsel
CXT-2704

Bei der Eingabekomponenten CMS_INPUT_TEXT und CMS_INPUT_NUMBER wurden die Eingabefelder zu klein dargestellt, wenn in der Formulardefinition das Attribut length=1 definiert wurde.

ContentCreator, Eingabekomponenten
DEVEX-554

Mit dem aktuellen Release 4.0.1 wurde „fc-cli“ (FSDevTools) angepasst, um die Kompatibilität zu Java 17 zu verbessern.

FSDevTools

Deprecations

Funktion Abgekündigt mit Entfällt / Entfallen mit
Eingabekomponente CMS_INPUT_CONTENTAREALIST 5.2R3
Eingabekomponente CMS_INPUT_CONTENTLIST 5.2R3
Eingabekomponente CMS_INPUT_FILE 5.2R3
Eingabekomponente CMS_INPUT_LINKLIST 5.2R3
Eingabekomponente CMS_INPUT_OBJECTCHOOSER 5.2R3
Eingabekomponente CMS_INPUT_PAGEREF 5.2R3
Eingabekomponente CMS_INPUT_PICTURE 5.2R3
Eingabekomponente 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 für FirstSpirit 2019-05
Datenbank-Layer Oracle Database 11g/12c 2020-12 2025-05
FirstSpirit Access-API: redirectTemplateLogToDefaultLog() (Interface RenderingAgent.Renderer) 2021-05
Support für Log4j 1 2022-05 2024-06