Release Notes FirstSpirit™ 2021.12

Release Notes

FirstSpirit™ 2021.12

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.1

für das erste Release des Jahres 2022.

Der Release-Name wird an den bekannten Stellen, z. B. in Info-Dialogen, verwendet.

UID=neue_releasenamen_1

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.

UID=servermanager_verwendungen_aktualisieren

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.

UID=contentcreator_status_anzeige

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.

UID=contentcreator_umgenickte_ecke

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.

UID=contentcreator_status_anpinnen

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).

UID=contentcreator_status_notifications

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- / DateinameVersionsnummer
FirstSpirit CXT Plattform
platform-[version].fsm
2.5.2
FirstSpirit CXT DAP Bridge
dataservice-[version].fsm
1.44.2
FirstSpirit CXT FragmentCreator
fragment-creator-[version].fsm
3.4.4
FirstSpirit Fragment DAP
fragmentdap-[version].fsm
1.40.4
FirstSpirit Media DAP
mediadap-[version].fsm
1.31.3*
FirstSpirit PageRef DAP
pageref-[version].fsm
1.9.3
FirstSpirit Markdown Editor
markdown-editor-[version].fsm
1.29.2*
FirstSpirit Tagging Editor
tagging-editor-[version].fsm
1.29.2
FirstSpirit CXT FragmentCreator - CaaS Integration
caas-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- / DateinameVersionsnummerKompatibel
FirstSpirit Aktualisierungsarchiv
fs-update-[version].tar.gz
2.1.0-
FirstSpirit Installationsarchiv
fs-install-[version].tar.gz
2.1.0-
FirstSpirit Launcher
FSLauncher.exe
1.0.42ab FirstSpirit 2018-08
FirstSpirit Launcher JRE Modul
fs-launcher-jre-[version].fsm
1.19ab FirstSpirit 2020-11
FirstSpirit SAML Login Modul
fs-saml-login-[version].fsm
1.3ab FirstSpirit 2019-02
FSDevTools
fs-cli-[version].tar.gz
fs-cli-[version].zip
3.1.0ab FirstSpirit 2021-07
FirstSpirit Module Gradle Plugin
firstspirit-module-gradle-plugin-[version].jar
3.0.2ab 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"
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.

Weitere Informationen können dem Kapitel „Vorlagenentwicklung: Schnipsel: Syntax-Validierung“ entnommen werden.

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.

Weitere Informationen können dem Kapitel „Vorlagenentwicklung: JSON: Neues Attribut "translated" für Seiten“ entnommen werden.

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 PermissionMode zwischen zwei Exporten nicht zum erwarteten Ergebnis führte.

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.
Meldungen im Log z. B. java.lang.IllegalStateException: not connected und de.espirit.firstspirit.server.ManagerNotFoundException: de.espirit.firstspirit.webedit.server.report.task.ProjectTasksManager.

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 RepositoryManager werden jetzt zusätzliche Informationen über die aktuell geöffneten Repositories angezeigt.

Aus diesen lassen sich sowohl Informationen darüber ablesen, in wieweit der entsprechende Cache ausgelastet wird (z. B. BdbCacheSizePercent) als auch, wieviele Nutzdaten die geöffneten Repositories enthalten (BdbLogUtilizationPercent).
Letzteres kann für einzelne, aktuell geöffnete Repositories auch unter de.espirit.firstspirit.manager.BerkeleyDbBackend abgelesen werden.

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: Fehler beim Laden der Bilddaten oder nicht unterstütztes Bildformat.
Im Rahmen dieses Bugfixes wurde darüber hinaus bei SVG-Bildern das Verhalten der Größenermittlung anhand des Attributs viewBox (statt einer Angabe der Attribute width und height) verbessert.

Debugging, Medien, Redakteur
CORE-14032

Handling von Projekt-Komponenten für deaktivierte Projekte

Weitere Informationen können dem Kapitel „Administration: Handling von Projekt-Komponenten für deaktivierte Projekte“ entnommen werden.

FirstSpirit-Administrator, Module, ServerManager
CORE-14043

Bei Verwendung des Moduls „FirstSpirit Image Recognition“ konnten Bilder bestimmter Formate nicht in den FirstSpirit SiteArchitect hochgeladen werden.
Jetzt betrifft dies nur noch Bilder über 5 MB, für die – konzeptionell begründet – ein S3-Bucket eingerichtet werden muss.

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“).
Jetzt wird eine entsprechende Fehlermeldung in der Datei fs-server.log festgehalten, und Bilder werden nach FirstSpirit hochgeladen.

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 NullPointerException kam.

Arbeitsablauf, Externe Synchronisierung, FSDevTools, Rechte
CORE-14062

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

Ankündigung: Neues Release-Namen-Schema

Weitere Informationen können dem Kapitel „Administration: Ankündigung: Neues Release-Namen-Schema“ entnommen werden.

FirstSpirit-Administrator
CXT-2407

Mit dem aktuellen FirstSpirit-Release wurde intern verwendete Software aktualisiert.

Weitere Informationen können dem Kapitel „System: Aktualisierung von integrierter Fremdsoftware“ entnommen werden.

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.

Weitere Informationen können dem Kapitel „ContentCreator: Erweiterung der Status-Anzeige“ entnommen werden.

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 (java.lang.IllegalArgumentException). Diese Fehlermeldung wird jetzt nicht mehr ausgegeben: Klicks auf Einträge der Projekthistorie, die sich auf eine ältere Version beziehen, haben jetzt keine Auswirkung mehr.

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.

Weitere Informationen können dem Kapitel „Kompatibilität: Module und Erweiterungen für FirstSpirit 2021-12“ entnommen werden.

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