Release Notes
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
externalGroupFilterder 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
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=comHinweis: 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
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- / Dateiname | Versionsnummer |
FirstSpirit CXT Plattformplatform-[version].fsm | 3.0.0 |
FirstSpirit CXT DAP Bridgedataservice-[version].fsm | 1.44.9 |
FirstSpirit CXT FragmentCreatorfragment-creator-[version].fsm | 4.0.0 |
FirstSpirit Fragment DAPfragmentdap-[version].fsm | 1.40.13 |
FirstSpirit Media DAPmediadap-[version].fsm | 1.31.8* |
FirstSpirit PageRef DAPpageref-[version].fsm | 1.9.8 |
FirstSpirit Markdown Editormarkdown-editor-[version].fsm | 1.29.7* |
FirstSpirit Tagging Editortagging-editor-[version].fsm | 1.29.7 |
FirstSpirit CXT FragmentCreator - CaaS Integrationcaas-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
CxtMicroAppsDas Abfragen möglicher MicroApps erfolgte bisher über die Methode
getButtonsDie Methode wurde umbenannt in
requestMicroAppActionsBei 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-creatorBeispiel
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
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 |
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 |
FirstSpirit-Administrator |
| CORE-14691 | Das Javadoc der Methode |
FirstSpirit-API |
| CORE-14699 | FirstSpirit stellt Vorlagen für alle von der vom FirstSpirit Server genutzten Java Version unterstützten Sprachen zur Verfügung. |
Server-Administrator |
| CORE-14703 | Ein neues Projekt kann nun aus einer Projektvorlage erzeugt 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 |
FirstSpirit-Administrator |
| CORE-14747 | In den Projekt-Eigenschaften wird die eindeutige GID eines Projektes angezeigt. |
ServerManager |
| CORE-14759 | Im „fs-server Startskript“ für Linux wurde ein irreführender Konfigurationseintrag ( |
Server-Administrator |
| CORE-14761 | Anpassungen im FirstSpirit SecurityFilter: Bei dem Strict-Transport-Security Header wird jetzt in der Standardkonfiguration auch die Eigenschaft |
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.
|
FirstSpirit-Administrator |
| CORE-14811 | Bei der Definition von externen Gruppen ist es möglich, einen Platzhalter zu definieren. |
FirstSpirit-Administrator |
| CORE-14818 | Bei Verwendung der neuen Chrome-Integration (JxBrowser 7.x) konnte es zu einer |
Vorschau |
| CORE-14823 | FirstSpirit Content Experience Tools: Aktuelle Modul-Versionen |
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 |
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 |
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. |
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. |
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 |
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 |