Release Notes

Generell funktioniert FirstSpirit immer mit der aktuellen Version einer Fremdkomponente. Sie werden seitens der e-Spirit AG regelmäßig getestet und Maßnahmen zur Behebung eventueller Fehler und Inkompatibilitäten ergriffen. Dies betrifft auch Browser zur Verwendung von FirstSpirit ServerMonitoring, ContentCreator und FragmentCreator.

Für den FirstSpirit FragmentCreator sind aktuell die empfohlenen Browser:

• Google Chrome
• Microsoft Edge

Aktuell wurde Microsoft Edge herstellerseitig auf eine neue technologische Basis gehoben (Chromium). Diese neue Version wird planmäßig mit einem Windows-Update ab Mitte Januar 2020 automatisch an die Kunden ausgeliefert.
Auch in diesem Fall unterstützt FirstSpirit die neueste Version von Microsoft Edge. Speziell funktionieren MicroApps (MicroApp Framework) mit „alten“ Edge-Versionen nicht, daher sollte für die Arbeit mit FirstSpirit die neue (auf Chromium basierende) Version von Microsoft Edge verwendet werden.

Design und technische Basis des FirstSpirit ContentCreator wurden überarbeitet. Mit dem aktuellen FirstSpirit-Release wird die Verwendung des überarbeiteten ContentCreator (auch „FirstSpirit CXT ContentCreator“) offiziell freigegeben, die Ramp-up- / EAP-Phase ist beendet.

Prinzipiell sind mit dem neuen Design keine funktionalen Änderungen für Redakteure verbunden. An wenigen zentralen Stellen wurde die Benutzerführung zusätzlich optimiert.

Neben dem neuen Design mit frischeren Farben und moderner Formensprache fällt speziell die umgestaltete Menüleiste auf: Die Statusanzeige wurde an den rechten Rand des ContentCreator verlagert und Aktionen zur Neuerstellung von Inhalten findet der Benutzer jetzt zentral und prominent unter dem +-Icon. Neu ist auch, dass im Arbeitsbereich jetzt nicht nur Seiten und Datensätze dargestellt werden, sondern auch Medien: Im Gegensatz zur bisher eingesetzten Dialog-/Fenstervariante der Medien-Verwaltung bringt dies ganz neue Ansichts- und Bearbeitungsoptionen mit sich: beispielsweise ist dort jetzt auch der Zuschnitt von Bildern möglich. Für eine leichtere Orientierung zeigt die Menüleiste dazu jetzt auch an, auf welcher Element-Ebene sich der Benutzer aktuell befindet.
Der Reportbereich ist um die Anzeige von zuletzt besuchten Elementen erweitert worden („Zuletzt besucht“). Darüber hinaus werden im sogenannten „Dashboard“ jetzt die Informationen der wichtigsten Reports dargestellt: der Status des aktuellen Elements, Möglichkeit zum Starten bzw. Weiterschalten von Arbeitsabläufen auf dem Element, offene Aufgaben und zuletzt besuchte Elemente.

Für Entwickler bringt ein Wechsel zum überarbeiteten ContentCreator prinzipiell ebenfalls keinen Migrationsaufwand mit sich. Nur in ganz seltenen Fällen kann es zu eventuellen Kompatibilitätsproblemen mit kundenspezifischen Modulen kommen. Bitte wenden Sie sich in diesem Fall an den e-Spirit Technical Support (https://help.e-spirit.com).

Aktivierung des überarbeiteten „FirstSpirit CXT ContentCreator“
Der überarbeitete ContentCreator steht mit dem aktuellen FirstSpirit-Release automatisch in Form eines Moduls zur Verfügung. Neue Features und Bugfixes erhält das Modul in künftigen Releases – wie andere Module auch – automatisch durch Updates des FirstSpirit-Servers.

Standardmäßig wird für alle Projekte der klassische ContentCreator im „alten“ Design verwendet.
Um den überarbeiteten „FirstSpirit CXT ContentCreator“ zu verwenden, muss dieser (je nach Bedarf serverweit oder projektweise) aktiviert werden. Dies geschieht im FirstSpirit ServerManager, und zwar jeweils über die Checkbox „Neues Design verwenden“. Diese muss an folgenden Stellen aktiviert sein:

1) Unter „Server-Eigenschaften / Web-Applikationen“ / Register „ContentCreator“:

Diese Einstellung wirkt sich auf alle Projekte aus, die die globale ContentCreator-Instanz verwenden. („Globale ContentCreator-Instanz“: Auf dem Register „ContentCreator“ unter „Projekt-Eigenschaften / Web-Komponenten“ ist kein Webserver konfiguriert: „[Keiner]“).

2) Unter „Projekt-Eigenschaften / Web-Komponenten“ / Register „ContentCreator“:
Gibt es projektlokale ContentCreator-Instanzen, muss auch für diese die Checkbox aktiviert werden. („Projektlokale ContentCreator-Instanz“: Auf dem Register „ContentCreator“ unter „Projekt-Eigenschaften / Web-Komponenten“ ist ein abweichender Webserver konfiguriert.)

Die Änderungen müssen deployed werden (Schaltfläche „Aktualisieren“ bzw. „Installieren“).

Mit diesen Einstellungen verwenden alle Projekte auf dem Server den ContentCreator im neuen Design.
Um das neue Design beispielsweise nur an einem Projekt zu testen, muss dafür eine projektlokale ContentCreator-Instanz vorhanden sein. Für diese wird das neue Design per Checkbox aktiviert. In den Server-Eigenschaften sollte die Checkbox dann deaktiviert werden.
Bei Bedarf kann per Aktivieren / Deaktivieren der Checkbox (und anschließendem Deployen) problemlos zwischen den beiden ContentCreator-Versionen gewechselt werden.

Dokumentation
Aktuell wird die Benutzerdokumentation für den ContentCreator überarbeitet und an das neue Design angepasst, andere Dokumentationen (z. B. „FirstSpirit Online Dokumentation“ (ODFS)) folgen. Die Darstellung in der Dokumentation entspricht daher stellenweise noch nicht der Oberfläche im neuen Design und kann sich von dem ContentCreator unterscheiden, den Sie im Einsatz haben.

Weitere Planung

• FirstSpirit 2020-02/03: Der überarbeitete ContentCreator wird standardmäßig für alle Projekte verwendet (zunächst für Cloud-, dann auch für On-premise-Kunden). Zum „alten“ ContentCreator kann bei Bedarf durch Deaktivieren der Checkbox zurückgewechselt werden.
• FirstSpirit 2020-07: Entfall des „alten“ ContentCreator. Dann steht allen Kunden ausschließlich der überarbeitete ContentCreator zur Verfügung. Bis dahin sollte die Funktionsweise und Kompatibilität von kundenspezifischen Modulen geprüft und – ggf. mit Hilfe von e-Spirit – an die neue technologische Basis angepasst werden.

Mit FirstSpirit 2020-01 wird die Eingabekomponente FS_LIST nicht länger unterstützt. Die Komponente kann ab diesem Zeitpunkt nicht mehr verwendet werden. Das bedeutet: Formulare mit FS_LIST können nicht mehr bearbeitet werden und ausgabeseitig werden nicht mehr die erwarteten Inhalte erzeugt.

Übersicht: Ablauf der Ramp-Down-Phase für die Eingabekomponente FS_LIST

Um das Ausphasen der FS_LIST möglichst risikoarm zu gestalten, wird der Ausbau in mehreren Schritten vollzogen:

• (Abgeschlossen) Mit FirstSpirit 5.2R3 wurde die Eingabekomponente zur Erstellung und Verwaltung von Listen FS_LIST abgekündigt.
• (Abgeschlossen) Mit FirstSpirit 2019-11 wurde zunächst in allen Projekten, bei einer Generierung oder Vorschau von Daten aus einer Eingabekomponente vom Typ FS_LIST eine Deprecation-Warning protokolliert.
• (Abgeschlossen) Mit FirstSpirit 2020-01 wurde die Eingabekomponente FS_LIST nicht mehr unterstützt. Die Komponente kann ab diesem Zeitpunkt nicht mehr verwendet werden.
• Um - insbesondere bei Kunden mit längeren Updatezyklen - das Risiko von Produktionsproblemen zu minimieren, besteht für eine sechsmonatige Übergangszeit die Möglichkeit, FS_LIST temporär zu reaktivieren. Wenden Sie sich hierzu bitte an den e-Spirit Technical Support.
• Mit FirstSpirit 2020-07 wird die Eingabekomponente in FirstSpirit ausgebaut und kann ab diesem Zeitpunkt in keinem Projekt mehr verwendet werden.

Migration: Umstellung auf alternative FirstSpirit-Eingabekomponenten

Als Ersatz stehen die Eingabekomponenten FS_CATALOG, FS_INDEX und CMS_INPUT_SECTIONLIST zur Verfügung, die ebenfalls Funktionalitäten zur Bündelung von Inhalten bereitstellen und somit weitgehend die Funktionen von FS_LIST übernehmen.

• FS_LIST, Typ DATABASE kann durch eine Eingabekomponente vom Typ FS_INDEX ersetzt werden.
• FS_LIST, Typ INLINE kann durch eine Eingabekomponente vom Typ FS_CATALOG ersetzt werden.
• FS_LIST mit Tag MEDIAMODE kann durch eine Eingabekomponente vom Typ FS_INDEX unter Verwendung des standardmäßig mitgelieferten DatasetDataAccessPlugin (Tag SOURCE) ersetzt werden.
• FS_LIST, Typ PAGE kann durch die Eingabekomponente CMS_INPUT_SECTIONLIST ersetzt werden.
• FS_LIST, Typ SERVICE kann durch eine Eingabekomponente vom Typ FS_INDEX unter Verwendung eines entsprechenden Datenzugriff-Plug-ins ersetzt werden.

Ein ausführlicher Leitfaden zur Umstellung in Bestandsprojekten wird über die FirstSpirit Dokumentation bereitgestellt.

Bei Fragen oder Feedback zur Migration der FS_LIST wenden Sie sich bitte an den e-Spirit Technical Support.

Ab FirstSpirit 2019-11 wird bei einer Generierung oder Vorschau von Daten aus einer Eingabekomponente mit dem Status „deprecated“ eine Deprecation-Warning protokolliert. Diese Meldung soll Anwendern das Auffinden und Migrieren von Eingabekomponenten im Status „deprecated“ erleichtern (und beispielsweise die Ramp-down-Phase der Eingabekomponente FS_LIST unterstützen).

Mit dem aktuellen FirstSpirit-Release wird dieses Verhalten verbessert. Dazu werden alle Deprecation-Warnings eines Projekts zusammengefasst und im ersten Abschnitt des Logfiles protokolliert (bei einer Generierung im Generierungs-Logfile und bei einer Vorschau unter „Fehler der Vorschau“).
Hinweis: Dabei werden nun auch beim Aufruf von „Fehlern der Vorschau“ auf einer Seite die Deprecation-Warnings für weitere Eingabekomponenten ausgegeben, die keinen Bezug zur aktuellen Seite haben.

Eingabekomponenten mit dem Status „deprecated“:

• werden von e-spirit nicht mehr gewartet
• sind aber weiterhin funktionsfähig und können in FirstSpirit-Projekten verwendet werden
• werden zukünfig entfallen

Folgende Eingabekomponenten befinden sich aktuell im Status „deprecated“:

• CMS_INPUT_CONTENTAREALIST (soll auf die Eingabekomponente FS_CATALOG umgestellt werden)
• CMS_INPUT_CONTENTLIST (soll auf die Eingabekomponente FS_INDEX umgestellt werden)
• CMS_INPUT_FILE (soll auf die Eingabekomponente FS_REFERENCE umgestellt werden)
• CMS_INPUT_LINKLIST (soll auf die Eingabekomponente FS_CATALOG umgestellt werden)
• CMS_INPUT_OBJECTCHOOSER (soll auf die Eingabekomponente FS_INDEX umgestellt werden)
• CMS_INPUT_PAGEREF (soll auf die Eingabekomponente FS_REFERENCE umgestellt werden)
• CMS_INPUT_PICTURE (soll auf die Eingabekomponente FS_REFERENCE umgestellt werden)
• CMS_INPUT_TABLIST (soll auf die Eingabekomponente FS_INDEX umgestellt werden)

Bei einer Verwendung von Eingabekomponenten mit dem Status „deprecated“ werden:

• bei einer Generierung oder
• beim Aufruf des Kontextmenü-Eintrags „Fehler der Vorschau anzeigen“ auf einer Seite

alle Deprecation-Warnings eines Projekts protokolliert und die verwendenden Stellen (d.h. das jeweilige Template) geloggt, z. B.

Usage of deprecated form element CMS_INPUT_PICTURE for variable 'ttPicture' in 
template 'testschema.testtable' (ID: 455559)

Das betrifft auch Komponenten, die zwar im Formular verwendet werden, deren Inhalte aber nicht im Template ausgegeben werden.

Die Deprecation-Warning kann beseitigt werden, indem:

• Die Eingabekomponenten im Formular mittels CMS_COMMENT auskommentiert werden.
• Die Eingabekomponenten im Projekt auf alternative Eingabekomponenten umgestellt werden.

Bei Fragen oder Feedback zur Migration wenden Sie sich bitte an den e-Spirit Technical Support.

Folgende Modul-Versionen für „FirstSpirit Content Experience Tools“ werden von FirstSpirit 2020-01 unterstützt:

* Das Modul „FirstSpirit Markdown Editor“ benötigt ab Version 1.17 FirstSpirit 2019-12 oder höher.

Medien in einer Eingabekomponente FS_INDEX mit DataAccessPlugin-Komponente „FirstSpiritMediaAccess/Connector“ können jetzt einfacher ausgetauscht werden. Dazu wurde folgendes Icon eingeführt:

Mit einem Klick darauf öffnet sich der Auswahldialog, aus dem das gewünschte Medium ausgewählt werden kann.