Release Notes FirstSpirit™ 2022.12

Release Notes

FirstSpirit™ 2022.12

1 Administration

1.1 'externalGroupFilter': Gruppen-Filter beim Login

Standardmäßig werden bei der Anmeldung eines Benutzers, der sich über einen externen Provider (z.B. LDAP, SAML Identity Provider) authentifiziert, die vollständigen Gruppeninformationen, die übermittelt werden, in FirstSpirit gespeichert.

Über den neuen Parameter

externalGroupFilter

der in der fs-server.conf definiert wird, kann nun über eine regulären Ausdruck definiert werden, welche Teilmenge dieser Gruppeninformationen von FirstSpirit übernommen werden sollen.

Beispiel:

externalGroupFilter=.*(csm_admin|FirstSpirit).*

1.2 Automatische Bereitstellung von Sprach-Vorlagen

Mit dem aktuellen Release stellt FirstSpirit Vorlagen für alle von der vom FirstSpirit Server genutzten Java Version unterstützten Sprachen zur Verfügung.

Sprach-Vorlagen
Sprach-Vorlagen

1.3 Platzhalter bei der Definition von externen Gruppen

Bei der Definition von externen Gruppen ist es seit der FirstSpirit Version 2022.12 möglich, einen Platzhalter in der Form

${Name des Platzhalters} 

zu definieren. Dieser Platzhalter wird beim Projektimport entsprechend ersetzt.

Die Platzhalter können als -D-Parameter in der fs-wrapper.isolated.conf, als Variablen über das Betriebssystem, in der fs-server-aux.conf oder der fs-server.conf definiert werden (mit sinkender Priorität). Variablen, die als -D-Parameter dem FirstSpirit Java Prozess übergeben werden, haben also die höchste Priorität, während in der fs-server.conf definierte Variablen von allen anderen Stellen überschrieben werden (siehe FirstSpirit ServerMonitoring / FirstSpirit / Konfiguration / Server (→Dokumentation für Administratoren)).

Beispiel (mit 3 Platzhaltern):

cn=${developer},ou=${Department},dc=${company},dc=com

Hinweis: Sinnvoll ist diese Funktion in Verbindung mit Projektvorlagen (siehe FirstSpirit ServerManager / Elemente der Menüleiste / Projekt (→Dokumentation für Administratoren)).

1.4 Projekt neu aus Vorlage anlegen

Für FirstSpirit Server, auf denen häufig Projekte angelegt werden, die auf derselben Grundlage basieren (z.B. vordefinierte Gruppen, User, Aufträge, Vorlagen, ...) besteht nun die Möglichkeit, entsprechende Projekt-Vorlagen zu erstellen, die bei der Neuanlage eines Projektes ausgewählt werden können.

Diese Möglichkeit steht nur Server-Administratoren zur Verfügung!

Eine Projektvorlage kann erstellt werden, indem ein Projekt entsprechend aufgesetzt und exportiert wird.
Hinweis: Der Name des Projektes wird als Anzeigename der Vorlage verwendet.

Die Projekt-Export-Datei muss in dem Verzeichnis <FirstSpiritROOT>/data/templates/projects abgelegt werden.

Beim Anlegen eines neuen Projektes wird das Feld „Projekvorlage“ nur dann angezeigt, wenn auf dem FirstSpirit Server auch Projektvorlagen abgelegt sind. Die dort hinterlegten Projektvorlagen werden zur Auswahl in einer Drop-Down Eingabekomponente angeboten.

Projekt neu aus Vorlage
Projekt neu aus Vorlage

Wird eines dieser Projektes ausgewählt, so wird das entsprechende Projekt importiert (Aufträge werden aktiviert, evtl. vorhandene Schemata müssen mit dem entsprechenden Datenbank Layer verknüpft werden.)

Zu weiteren Informationen siehe FirstSpirit Dokumentation für Administratoren, Kapitel „Projekt“.

2 ContentCreator

TailoredUI: Server-weite Konfiguration über Service

Über den „Feature Configuration Service“ kann nun eine serverweite Konfiguration der Tailored UI vorgenommen werden, eine projekt-lokale Einstellung ist nicht mehr zwingend notwendig.

Für Projekte, zu denen die Projekt-Komponente „CXT ContentCreator Extension: Feature Configuration“ („FirstSpirit ServerManager / Projekt-Eigenschaften / Projekt-Komponenten“) hinzugefügt wird bzw. wurde, wird die dort vorgenommene Konfiguration berücksichtigt.
Für Projekte ohne diese Projekt-Komponente wird die Konfiguration des „Feature Configuration Service“ berücksichtigt.

Bestehende Konfiguration, die vor einem Upgrade auf FirstSpirit 2022.12 auf Projekt-Ebene vorgenommen wurde, ist nach einem Upgrade auf FirstSpirit 2022.12 weiterhin gültig. Soll eine Konfiguration auf Serverebene vorgenommen werden, muss die Projekt-Komponente „CXT ContentCreator Extension: Feature Configuration“ für das oder die betreffenden Projekte entfernt werden, damit eine auf Serverebene vorgenommene Konfiguration im Projekt zum Tragen kommt. Um eine bestehende Projekt-Konfiguration auf Serverebene zu übernehmen, kann dazu die Schaltfläche From Project verwendet werden.

3 FirstSpirit Content Experience Tools (CXT)

3.1 Aktuelle Modul-Versionen

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

Modul- / DateinameVersionsnummer
FirstSpirit CXT Plattform
platform-[version].fsm
3.0.0
FirstSpirit CXT DAP Bridge
dataservice-[version].fsm
1.44.9
FirstSpirit CXT FragmentCreator
fragment-creator-[version].fsm
4.0.0
FirstSpirit Fragment DAP
fragmentdap-[version].fsm
1.40.13
FirstSpirit Media DAP
mediadap-[version].fsm
1.31.8*
FirstSpirit PageRef DAP
pageref-[version].fsm
1.9.8
FirstSpirit Markdown Editor
markdown-editor-[version].fsm
1.29.7*
FirstSpirit Tagging Editor
tagging-editor-[version].fsm
1.29.7
FirstSpirit CXT FragmentCreator - CaaS Integration
caas-integration-[version].fsm
1.31.8

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

3.2 Erweiterung und Änderung der MicroApp-JavaScript-API

Die MicroApps API wurde geändert: es wurden 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 wurde umbenannt in

requestMicroAppActions

Bei dieser Abfrage kann jetzt 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(...)

jetzt

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

4 SiteArchitect / ServerManager

Eindeutige GID eines Projekte in Projekt-Eigenschaften

Mit der aktuellen FirstSpirit-Version wird in den Projekt-Eigenschaften die eindeutige GID eines Projektes angezeigt. Diese GID kann kopiert, aber nicht geändert werden.

Die eindeutige GID eines Projektes
Die eindeutige GID eines Projektes

5 System

Integrierte Software

Mit der aktuellen FirstSpirit-Version wurde folgende intern verwendete Software aktualisiert:

  • JxBrowser (Chrome-Browser-Engine zur Darstellung der integrierten Vorschau im FirstSpirit SiteArchitect)
    Aktualisierung auf Version 7.27
    Die Engine verwendet nun „Chromium“ in der Version 102.0.5005.167.

Übersicht

ID Beschreibung Kategorien
CLOUDPROV-19

Mit der Version 1.6.11 wurde ein Fehlverhalten im AWS-S3-Deployment-Modul behoben, das dazu führte, dass der Upload nicht beendet wurde, wenn der dazugehörige Auftrag abgebrochen wurde.

AWS S3-Deployment
CORE-11147

Die standardisierte JSON-Ausgabe wurde angepasst. Der Vorwärts-Schrägstrich wird nicht länger durch einen vorangestellten umgekehrten Schrägstrich geschützt.

JSON-Unterstützung
CORE-11161

Mit der aktuellen FirstSpirit-Version wurde intern verwendete Software aktualisiert.

Weitere Informationen können dem Kapitel „System: Integrierte Software“ entnommen werden.

Integrierte Software, SiteArchitect, Vorschau
CORE-14401

In seltenen Fällen konnte es bei der Benutzung von Read-Only Schemata, die auf durch FirstSpirit verwalteten Datenbanken beruhen, zu einer WARN Meldung Failure adapting gid kommen. Diese nicht korrekte Warnung wird nun nicht mehr ausgegeben.

Datenbank, FirstSpirit-Administrator
CORE-14577

Der URL für die Verbindung vom Java-Client (z.B. SiteArchitect) zum FirstSpirit Server lässt jetzt die Portangabe weg, wenn es sich um einen Standardport (z.B. 443 bei HTTPS) handelt.

FirstSpirit-Administrator
CORE-14646

Das BerkeleyUtil.jar wurde um die Maven Metainformationen der verwendeten Libraries erweitert, um deren Versionen leichter ermitteln zu können.

FirstSpirit-Administrator
CORE-14691

Das Javadoc der Methode setCropData() aus dem Interface PictureResolution (Package de.espirit.firstspirit.access.store.mediastore, FirstSpirit Access API) wurde verbessert. Beim Setzen von Zuschnitt-Informationen von Bildern wird nun auch eine Warnung Removing cropData for picture XY because the selection is null! geloggt, wenn das übergebende cropData-Objekt keine Selektion enthält. Die Zuschnitt-Informationen werden in diesem Fall entfernt.

FirstSpirit-API
CORE-14699

FirstSpirit stellt Vorlagen für alle von der vom FirstSpirit Server genutzten Java Version unterstützten Sprachen zur Verfügung.

Weitere Informationen können dem Kapitel „Administration: Automatische Bereitstellung von Sprach-Vorlagen“ entnommen werden.

Server-Administrator
CORE-14703

Ein neues Projekt kann nun aus einer Projektvorlage erzeugt werden.

Weitere Informationen können dem Kapitel „Administration: Projekt neu aus Vorlage anlegen“ entnommen werden.

FirstSpirit-Administrator
CORE-14705

Es wurde ein Fehler behoben, der in sehr seltenen Fällen bei einem „Enterprise Backup“ Lauf dazu führen konnte, dass dieser mit dem Fehler „unknown revision“ fehlgeschlug.

FirstSpirit-Administrator
CORE-14709

Es konnte im SiteArchitect zu einem Fehler kommen, wenn beim Start ein Datensatz geladen wurde, für den der aktuelle Nutzer keine Leseberechtigung hat.

SiteArchitect
CORE-14724

Es wurde ein Fehler behoben, der bei der projektübergreifenden Datenbanknutzung (wie z. B. in bestimmten Corporate Content-Szenarien) zu Problemen bei der Indexierung in den Remote-Projekten führen konnte.

Corporate Content, Datenbank, Entwickler, FirstSpirit-Administrator
CORE-14726

Neuer Parameter externalGroupFilter.

Weitere Informationen können dem Kapitel „Administration: 'externalGroupFilter': Gruppen-Filter beim Login“ entnommen werden.

FirstSpirit-Administrator
CORE-14747

In den Projekt-Eigenschaften wird die eindeutige GID eines Projektes angezeigt.

Weitere Informationen können dem Kapitel „SiteArchitect / ServerManager: Eindeutige GID eines Projekte in Projekt-Eigenschaften“ entnommen werden.

ServerManager
CORE-14759

Im „fs-server Startskript“ für Linux wurde ein irreführender Konfigurationseintrag (WRAPPER_CONF="../conf/wrapper.conf" zu WRAPPER_CONF="../conf/fs-wrapper.isolated.conf") korrigiert. Dieser Konfigurationseintrag wird in der Praxis nicht genutzt, da der Wert in der fs-server.shconf überschrieben wird.

Server-Administrator
CORE-14761

Anpassungen im FirstSpirit SecurityFilter: Bei dem Strict-Transport-Security Header wird jetzt in der Standardkonfiguration auch die Eigenschaft includeSubDomains gesetzt.

FirstSpirit-Administrator, Sicherheit
CORE-14787

Das Modul „FirstSpirit Security“ hatte in den FirstSpirit Versionen 2022.10 und 2022.11 nicht den vollen Funktionsumfang.

FirstSpirit-Administrator, Module
CORE-14799

Wenn ein Auftrag abgebrochen wird, aber die laufende Auftragsaktion nicht innerhalb von 5 Minuten beendet wird, so wird nun eine FATAL Fehlermeldung ausgegeben.

timeout waiting for task cancellation - "<Name der Aktion>", schedule entry "<Name des Auftrags>" (id="<id>", project id="<projekt ID>")

FirstSpirit-Administrator
CORE-14811

Bei der Definition von externen Gruppen ist es möglich, einen Platzhalter zu definieren.

Weitere Informationen können dem Kapitel „Administration: Platzhalter bei der Definition von externen Gruppen“ entnommen werden.

FirstSpirit-Administrator
CORE-14818

Bei Verwendung der neuen Chrome-Integration (JxBrowser 7.x) konnte es zu einer IllegalStateException während der Vorschau-Navigation kommen.

Vorschau
CORE-14823

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

Beim Anlegen eines neuen Projekts wird bei der standardmäßig gewählten Sprache jetzt UTF-8 als HTML-Encoding konfiguriert.

FirstSpirit-Administrator
CORE-14856

Wenn das Staging-Verzeichnis auf einen Application Server gemappt ist, ohne dass dessen Webapps Verzeichnis FirstSpirit bekannt ist (z. B. Tomcat ohne entsprechende Konfiguration), verwendet ein Generierungsauftrag, zusammen mit der Einstellung webserver.jetty.hide=true in der fs-server.conf, als Basisverzeichnis das Verzeichnis „null“ im FirstSpirit Installationsverzeichnis. Dies Verhalten wurde behoben und das Verzeichnis „null“ wird automatisch bei Nutzung der neuen FirstSpirit Version entfernt.

FirstSpirit-Administrator
CORE-14884

Bei der Verwendung der aktualisierten Chrome Integration konnte es zu Reload-Schleifen kommen, wenn die Vorschau innere Frames enthielt und das Content-Highlighting dem Arbeitsbereich und der Vorschau folgt.

SiteArchitect, Vorschau
CXT-2018

Über den „Feature Configuration Service“ kann nun eine serverweite Konfiguration der Tailored UI vorgenommen werden, eine projekt-lokale Einstellung ist nicht mehr zwingend notwendig.

Weitere Informationen können dem Kapitel „ContentCreator: TailoredUI: Server-weite Konfiguration über Service“ entnommen werden.

ContentCreator, Entwickler, FirstSpirit-Administrator, Redakteur
CXT-2715

Bei der Verwendung von eigenen UploadHooks konnte es bei einem abgelehnten Dateiupload zu leeren Media Elementen kommen.

ContentCreator
CXT-2722

Die MicroApps API wurde geändert: es wurden 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-2723

Innerhalb von Unterformularen konnte die Gruppenzugehörigkeit über IN_GROUP-Regeln nicht korrekt geprüft werden.

ContentCreator, Dynamische Formulare
DEVEX-567

Es wurde ein Fehler beim Kommando module installBulk behoben, bei dem im Fehlerfall kein Hinweis auf die Ursache des Problems ausgegeben wurde.

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