Release Notes
1 Administration
1.1 Ankündigung: Neues Release-Namen-Schema
Mit FirstSpirit 2021-09 wurde das Release-Intervall von FirstSpirit von einmal monatlich auf alle 4 Wochen geändert.
Es ist geplant, mit dem Jahreswechsel zu 2022 die Bezeichnung der Releases an diese Gegebenheit anzupassen: Um Releases flexibler gestalten zu können, orientiert sich die Release-Bezeichnung dann nicht mehr an der Monatszahl (z. B. FirstSpirit 2021-12), sondern verwendet einen durchgängigen Zähler. Die Jahreszahl wird durch einen Punkt von diesem Zähler getrennt, z. B.
2022.1für das erste Release des Jahres 2022.
Der Release-Name wird an den bekannten Stellen, z. B. in Info-Dialogen, verwendet.

1.2 Handling von Projekt-Komponenten für deaktivierte Projekte
Beim Aktualisieren der Verwendungen von Modulen (FirstSpirit ServerManager / Server-Eigenschaften / Module, „Verwendungen aktualisieren“ / „Aktualisieren“) werden jetzt Projekt-Komponenten von deaktivierten Projekten nicht mehr berücksichtigt.

Darüber hinaus wird der Administrator bei der Reaktivierung eines Projektes (FirstSpirit ServerManager / Projekt / Reaktivieren) gegebenenfalls darauf hingewiesen, wenn dieses eine Projekt-Komponente nutzt, deren Modul auf dem Server nicht (mehr) installiert ist. Er kann in diesem Fall die Projekt-Komponente entfernen oder das Modul installieren.
2 ContentCreator
Erweiterung der Status-Anzeige
In der Menüleiste wird rechts oben der Status von Elementen angezeigt. Dort können – abhängig vom jeweiligen Element-Typ und Status – unterschiedliche Aktionen ausgeführt werden, z. B. Arbeitsabläufe starten und weiterschalten, frühere Versionen einer Seite anzeigen usw.
Der Status für selektierte Medien und Datensätze war bisher im „Dashboard“ zu finden.
Mit dem aktuellen Release wurde das Design der Status-Anzeige überarbeitet, um auch den Status von Medien und Datensätzen sowie Mehrfachselektionen berücksichtigen zu können.

Welche Informationen und Aktionen bietet die Status-Anzeige?
Der Status zeigt neben Informationen zum betreffenden Element Informationen zur letzten Änderung an.
Zur Verfügung stehende Arbeitsablauf-Aktionen werden per Button visualisiert.
Unterhalb der farbigen Status-Informationen können für Seiten weitere Ansichten aufgerufen (z. B. frühere Versionen der Seite, versteckte oder gelöschte Absätze) oder Validierungsprobleme behoben werden.
Für welches Element gilt der Status?
- Befindet man sich in der Vorschau (also auf einer Seite), bezieht sich der angezeigte Status auf diese Seite.
Weitere Ansichten der Seite (z. B. eine frühere Version) können über entsprechende Buttons aufgerufen werden. - Befindet man sich in der Medien-Verwaltung oder der Datenquellen-Ansicht, bezieht sich der angezeigte Status jeweils auf den in der Navigationsleiste gewählten Ordner.
Für Elemente, die sich innerhalb dieses Ordners befinden und per Klick ausgewählt wurden (Medien, Datensätze oder weitere Ordner), werden Status und zur Verfügung stehende Aktionen unterhalb als eigene Status-Einträge dargestellt (visualisiert durch den Pfeil nach unten).
In der Medien-Verwaltung und der Datenquellen-Ansicht können mehrere Element per Klick ausgewählt werden und auf diesen Arbeitsabläufe gestartet werden. Eine abgeknickte Ecke zeigt an, dass eine Auswahl getroffen wurde und die Status-Anzeige den gewählten Ordner sowie mindestens ein darin befindliches gewähltes Element betrifft.

Befinden sich mehrere der ausgewählten Elemente im gleichen Arbeitsablaufschritt, wird der Arbeitsablauf durch Betätigen des entsprechenden Buttons für diese gleichzeitig geschaltet.
Weitere Informationen zur Bedienung
Ein Klick auf das Status-Icon oder auf den Button „Status Report öffnen“ fixiert die Status-Anzeige: Auf diese Weise bleibt sie bei einem Wechsel zu anderen Elementen geöffnet, sodass der Status jedes gewünschten Elements komfortabel geprüft werden kann.
Die Anzeige bleibt solange geöffnet, bis der User erneut auf den Status-Button klickt oder einen anderen Report öffnet.

Die Funktion der „Status Notifications“ wurde optisch an das neue Design der Status-Anzeige angeglichen („Status Notifications“: Plugin, FirstSpirit Developer-API, Package de.espirit.firstspirit.webedit.plugin.status).

Im „Dashboard“ werden jetzt keine Status-Informationen mehr angezeigt. Bisher wurden dort Status-Informationen zu Elementen der Medien- und Datenquellen-Verwaltung angezeigt.
Zu weiteren Informationen siehe auch https://docs.e-spirit.com/contentcreator/menuefunktionen/element-status/index.html.
3 FirstSpirit Content Experience Tools (CXT)
Aktuelle Modul-Versionen
Folgende Modul-Versionen für „FirstSpirit Content Experience Tools“ werden von FirstSpirit 2021-12 unterstützt.
| Modul- / Dateiname | Versionsnummer |
FirstSpirit CXT Plattformplatform-[version].fsm | 2.5.2 |
FirstSpirit CXT DAP Bridgedataservice-[version].fsm | 1.44.2 |
FirstSpirit CXT FragmentCreatorfragment-creator-[version].fsm | 3.4.4 |
FirstSpirit Fragment DAPfragmentdap-[version].fsm | 1.40.4 |
FirstSpirit Media DAPmediadap-[version].fsm | 1.31.3* |
FirstSpirit PageRef DAPpageref-[version].fsm | 1.9.3 |
FirstSpirit Markdown Editormarkdown-editor-[version].fsm | 1.29.2* |
FirstSpirit Tagging Editortagging-editor-[version].fsm | 1.29.2 |
FirstSpirit CXT FragmentCreator - CaaS Integrationcaas-integration-[version].fsm | 1.31.3 |
* Diese Module benötigen ab dieser Version FirstSpirit 2020-03 oder höher.
4 Kompatibilität
Module und Erweiterungen für FirstSpirit 2021-12
Folgende Module und Erweiterungen sind kompatibel mit FirstSpirit 2021-12:
| Modul- / Dateiname | Versionsnummer | Kompatibel |
FirstSpirit Aktualisierungsarchivfs-update-[version].tar.gz | 2.1.0 | - |
FirstSpirit Installationsarchiv fs-install-[version].tar.gz | 2.1.0 | - |
FirstSpirit LauncherFSLauncher.exe | 1.0.42 | ab FirstSpirit 2018-08 |
FirstSpirit Launcher JRE Modulfs-launcher-jre-[version].fsm | 1.19 | ab FirstSpirit 2020-11 |
FirstSpirit SAML Login Modulfs-saml-login-[version].fsm | 1.3 | ab FirstSpirit 2019-02 |
FSDevToolsfs-cli-[version].tar.gzfs-cli-[version].zip | 3.1.0 | ab FirstSpirit 2021-07 |
FirstSpirit Module Gradle Pluginfirstspirit-module-gradle-plugin-[version].jar | 3.0.2 | ab FirstSpirit 2019-06 |
5 System
Aktualisierung von integrierter Fremdsoftware
Mit dem aktuellen FirstSpirit-Release wurde folgende intern verwendete Software aktualisiert:
- AWS SDK (API von Amazon zur automatischen Bilderkennung, verwendet im Modul „FirstSpirit Image Recognition“)
Aktualisierung auf Version 2.17.58
Durch diese Aktualisierung können bei einer Analyse per Modul „FirstSpirit Image Recognition“ jetzt mehr Attribute zu Bildern ermittelt und gespeichert werden.
Siehe dazu u.a. auch Amazon Rekognition News. - Apache Batik (Darstellung, Erzeugen und Manipulation von Skalierbaren Verktorgrafiken, SVG)
Aktualisierung auf Version 1.14 - TwelveMonkeys ImageIO (erweiterte Java-Unterstützung von Bilddateiformaten)
Aktualisierung auf Version 3.7.0
6 Vorlagenentwicklung
6.1 JSON: Neues Attribut "translated" für Seiten
Mit dem aktuellen Release enthält die JSON-Ausgabe jetzt für Seiten auch die Information, ob der Haken „Seite für diese Sprache vollständig übersetzt“ im SiteArchitect aktiviert ist oder nicht.

SiteArchitect: Option "Seite für diese Sprache vollständig übersetzt"
(Siehe dazu auch https://docs.e-spirit.com/odfs/edocs/fsar/inhalte-verwalt/seiten-ebene/index.html)
Ist der Haken für die aktuelle Sprache der Seite aktiviert, ist der Wert des zugehörigen Attributs translated true, ist der Haken für diese Sprache nicht aktiviert, ist der Wert false, z. B.
{
"fsType": "Page",
"name": "translated_status",
"displayName": "translated_status",
"identifier": "c3af851b-7429-4d28-9487-ca6e4c3311e8",
"translated": false,
"uid": "translated_status",
"uidType": "PAGESTORE",
"template": {
"fsType": "PageTemplate",
"name": "pt_empty_page",
"displayName": "pt_empty_page",
"identifier": "7c020f2f-719c-4334-8efc-f44015333d2a",
"uid": "pt_empty_page",
"uidType": "TEMPLATESTORE"
},
...6.2 Schnipsel: Syntax-Validierung
An vielen Stellen der FirstSpirit-Clients kann die Darstellung von Objekten (Seiten, Absätze, Datensätze, Medien usw.) beeinflusst werden, z. B. in Suchergebnislisten, Reports, Auswahldialogen usw. Dazu werden die so genannten „Schnipsel“ verwendet. Die Konfiguration erfolgt auf dem Register „Schnipsel“ der betreffenden Vorlage, für Medien auf dem Register „Schnipsel“ der für das Projekt gewählten Metadaten-Vorlage.
Mit dem aktuellen FirstSpirit-Release wird die Syntax von Schnipsel-Definitionen jetzt beim Speichern geprüft: Ist sie nicht korrekt ist, erscheint ein entsprechender Hinweis und das Speichern der Vorlage ist nicht möglich.
Beispielhafte Fehlermeldung:
Fehlerhafte Syntax im Ausriss
... (at line 4, column 48)Hinweis: Es wird nur die generelle Syntax geprüft. Nicht geprüft hingegen wird, ob die verwendeten Variablennamen korrekt sind und ob die verwendeten Methoden und Operatoren mit dem jeweiligen Objekttyp kompatibel sind.
Übersicht
| ID | Beschreibung | Kategorien |
|---|---|---|
| CORE-13129 | Mit dem aktuellen FirstSpirit-Release wird die Syntax von Schnipsel-Definitionen beim Speichern geprüft. |
Debugging, Entwickler, Schnipsel, Vorlagen-Verwaltung, Vorlagenentwicklung |
| CORE-13640 | In sehr seltenen Fällen konnte es beim Wechsel der Sprachabhängigkeit eines Mediums zu einer Interaktion mit einem datenmodifizierenden Upload Hook kommen. |
Medien, SiteArchitect |
| CORE-13851 | Mit dem aktuellen Release enthält die JSON-Ausgabe jetzt auch für Seiten die Information, ob der Haken „Seite für diese Sprache vollständig übersetzt“ gesetzt ist oder nicht. |
Entwickler, Inhalte-Verwaltung, JSON-Unterstützung, Sprachen |
| CORE-13981 | Es wurde ein Fehler behoben, der bei der Nutzung von FSDevTools (fs-cli) dazu führen konnte, dass eine Änderung des |
Entwickler, FSDevTools, FirstSpirit-Administrator, Rechte |
| CORE-13986 | Beim Öffnen des FirstSpirit ContentCreator konnte es zu Fehlern kommen. Im Anschluss konnten bestimmte Funktionalitäten wie das Schalten von Arbeitsabläufen nicht verwendet werden. |
Arbeitsablauf, ContentCreator |
| CORE-14011 | In sehr seltenen Fällen konnten Probleme mit Schriftarten dazu führen, dass ein Content Transport-Feature nicht installiert werden konnte. Das Verhalten wurde geändert, so dass entsprechende Probleme die Installation eines Features nicht mehr verhindern. |
Content Transport |
| CORE-14017 | Im MBean Aus diesen lassen sich sowohl Informationen darüber ablesen, in wieweit der entsprechende Cache ausgelastet wird (z. B. |
Debugging, FirstSpirit-Administrator, ServerMonitoring |
| CORE-14020 | Das Hochladen von Bildern, deren Format nicht (als Medientyp „Bild“) von FirstSpirit unterstützt wird, führt jetzt im FirstSpirit SiteArchitect zu einer aussagekräftigeren Fehlermeldung: |
Debugging, Medien, Redakteur |
| CORE-14032 | Handling von Projekt-Komponenten für deaktivierte Projekte |
FirstSpirit-Administrator, Module, ServerManager |
| CORE-14043 | Bei Verwendung des Moduls „FirstSpirit Image Recognition“ konnten Bilder bestimmter Formate nicht in den FirstSpirit SiteArchitect hochgeladen werden. Darüber hinaus wurden Bilder nicht nach FirstSpirit hochgeladen, wenn keine bzw. keine gültigen Anmeldedaten für „FirstSpirit Image Recognition“ konfiguriert waren („Zugriffsschlüssel“). Wichtig für Nicht-Cloud-Kunden: Nach der Aktualisierung des Moduls ist ein Neustart des FirstSpirit-Servers notwendig, damit die Änderungen wirksam werden. |
Entwickler, FirstSpirit-Administrator, Medien, Redakteur |
| CORE-14044 | Es wurde ein Fehler behoben, der in sehr seltenen Fällen dazu führen konnte, dass es beim Export mittels „fs-cli“ (FSDevTools) von Knoten mit konfigurierten Arbeitsablaufrechten zu einer |
Arbeitsablauf, Externe Synchronisierung, FSDevTools, Rechte |
| CORE-14062 | FirstSpirit Content Experience Tools: Aktuelle Modul-Versionen |
Entwickler, FirstSpirit Content Experience Tools (CXT), FirstSpirit-Administrator, FragmentCreator, Module |
| CORE-14097 | Ankündigung: Neues Release-Namen-Schema |
FirstSpirit-Administrator |
| CXT-2407 | Mit dem aktuellen FirstSpirit-Release wurde intern verwendete Software aktualisiert. |
Entwickler, FirstSpirit-Administrator, Medien, Module |
| CXT-2458 | Im Eingabeelement zur Auswahl von Datensätzen (FS_DATASET) werden jetzt nur noch Datensätze passend zu der aus der Drop-down-Liste gewählten Datenquelle zur Auswahl angeboten. |
ContentCreator, Datenquellen-Verwaltung, Eingabekomponenten |
| CXT-2471 | Mit dem aktuellen Release wurde das Design der Status-Anzeige überarbeitet, um auch den Status von Medien und Datensätzen sowie Mehrfachselektionen berücksichtigen zu können. |
ContentCreator, Freigabe, Redakteur, Reports |
| CXT-2477 | Wird der FirstSpirit ContentCreator im Modus OCM (FirstSpirit Omnichannel Manager) verwendet, wurde bei einem Klick auf historische Einträge im Report „Projekthistorie“ eine Fehlermeldung in der Browser-Konsole ausgegeben ( Hintergrund: Konzeptionell begründet stehen in OCM aufgrund einer Verwendung mit FirstSpirit Content as a Service („CaaS“) in der Regel keine historischen Stände von Objekten zur Verfügung. Dort werden Inhalte im aktuellen („current“) und im freigegebenen („released“) Stand vorgehalten. Der Report „Projekthistorie“ hat aufgrund dessen in OCM keine Funktion. |
FirstSpirit Omnichannel Manager, Omnichannel Manager / Third Party Preview, Redakteur, Reports |
| CXT-2485 | Im FirstSpirit ContentCreator wurde bei Verwendung des „Site-store based“ Element Status Provider in manchen Fällen der Veränderungsstatus zwar korrekt visualisiert, aber falsch beschriftet. Diese Beschriftung wurde korrigiert. |
Arbeitsablauf, ContentCreator, Redakteur |
| DEVEX-525 | Diese Module und Erweiterungen sind kompatibel mit FirstSpirit 2021-12. |
Entwickler, FSDevTools, FirstSpirit-Administrator, Launcher, Module |
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 | |
| Legacy mode für den FirstSpirit-Server | 2019-06 | 2022-03 |
| Datenbank-Layer Oracle Database 11g/12c | 2020-12 | 2025-05 |
| FirstSpirit Access-API: redirectTemplateLogToDefaultLog() (Interface RenderingAgent.Renderer) | 2021-05 |