Release Notes

Um den Betrieb des FirstSpirit Servers unter Linux weiter abzusichern und die zentrale Konfiguration zu vereinfachen, wurde eine weitere, optionale Konfigurationsdatei eingeführt.

Über diese neue Datei fs-server-custom.shconf kann

• der Benutzer festgelegt werden, mit dem der FirstSpirit Server gestartet werden soll.

• der Pfad zur Java Version definiert werden.

Bei einem Update des FirstSpirit Backends, wird die Datei nicht automatisch aktualisiert und ist daher nicht im fs-update*.tar.gz enthalten. Für bereits installierte Server kann die Datei aus dem fs-install*.tar.gz extrahiert werden.

Anschließend müssen in der Datei die entsprechenden Zeilen einkommentiert (führendes # entfernt) und mit den gewünschten Werten versehen werden

RUN_AS_USER=<Username>
export FS_JAVA_HOME=<path to java>

Planmäßig entfällt mit dem aktuellen FirstSpirit-Release der Support für Microsoft Internet Explorer als Browser zur Verwendung der FirstSpirit Web Apps. Auch herstellerseitig wird der Microsoft Internet Explorer sukzessive durch Microsoft Edge abgelöst.

Referenz für die Verwendung mit FirstSpirit ist immer der aktuellste Chrome-Browser, der auf dem jeweiligen Betriebssystem verfügbar ist. Für diesen Browser-Typ werden regelmäßige Tests durchgeführt und Schritte zur Fehlerbeseitigung auf der Basis von Fehlermeldungen unternommen.
Darüber hinaus werden auch Chrome-nahe Browser (wie Apple Safari) unterstützt und getestet, allerdings kann es dort zu Einschränkungen kommen (z. B. eingeschränkter SVG-Support).

Übersicht der aktuellen Browser-Kompatibilitäten:

Empfohlene Browser / Referenz:

• Google Chrome
• Microsoft Edge

Kompatible Browser:

• Mozilla Firefox
• Apple Safari (mit Einschränkungen)

Nicht kompatibel:

• Microsoft Internet Explorer
• Opera und andere

Das „FirstSpirit Technische Datenblatt“ wurde entsprechend angepasst (https://docs.e-spirit.com/odfs/edocs/admi/technische-vora/index.html).

Design und technische Basis des FirstSpirit ContentCreator wurden überarbeitet. Mit FirstSpirit 2020-01 wurde die Verwendung des überarbeiteten ContentCreator offiziell freigegeben, seit FirstSpirit 2020-03 wird der überarbeitete ContentCreator standardmäßig für alle Projekte verwendet. Zusätzlich zu den internen Qualitätssicherungsmaßnahmen ist Feedback aus konkreten Einsatzszenarien von Kunden und Partnern seitdem zeitnah in die Entwicklung mit eingeflossen.
Bei Bedarf konnte projektweise unkompliziert zwischen altem und neuen ContentCreator gewechselt werden. Mit dem aktuellen Release entfällt der „alte“ ContentCreator planmäßig, allen Kunden steht damit ausschließlich der überarbeitete ContentCreator zur Verfügung.
Die Checkbox, über die zuvor zwischen altem und neuen ContentCreator gewechselt werden konnte (FirstSpirit ServerManager / „Server-Eigenschaften / Web-Applikationen“ bzw. „Projekt-Eigenschaften / Web-Komponenten“ / „ContentCreator“, Option „Neues Design verwenden“) ist in diesem Kontext entfallen. Bei einem Wechsel von früheren FirstSpirit-Versionen nach 2020-07 werden Einstellungen, die dort für Server und / oder Projekt vorgenommen wurden, nicht mehr berücksichtigt, ab FirstSpirit 2020-07 wird ausschließlich der überarbeitete ContentCreator verwendet.

Für Redakteure sind mit dem neuen Design prinzipiell keine funktionalen Änderungen verbunden. Nur an wenigen zentralen Stellen wurde die Benutzerführung zusätzlich optimiert.
Mit FirstSpirit 2020-07 wurden aufgrund von Kunden-Feedback noch einige Optimierungen hinsichtlich Design und User Experience vorgenommen, z. B.

• Menü „AKTIONEN“:
  Hier wird jetzt visuell wieder zwischen Skripten, (kontextlosen) Arbeitsabläufen und PlugIns unterschieden.
• FS_CATALOG/FS_INDEX:
  Neue Darstellungsmöglichkeit „Raster“ (im Vergleich zu „Symbole“ werden die Thumbnails dabei nicht an den bestehenden Platz angepasst)
  
  
• Medien-Verwaltung:
  Die letzte Reihe der Einträge wird nun nicht mehr auf die gesamte Seitenbreite aufgezogen.
• Anpassung von Dialog-Schaltflächen für eine einheitliche Client-übergreifende UI
  
  
• Layout-Optimierung von integrierten Hilfetexten und Tooltips
• In Freigabe-Mitteilungen, die temporär oben links unterhalb der Menüleiste eingeblendet werden, werden jetzt auch für Medien-Ordner und die oberste Ebene der Medien-Verwaltung („Medien“) die betreffenden Namen angezeigt.

Für Entwickler und Administratoren bedeutet der Wechsel zum überarbeiteten ContentCreator keinen Migrationsaufwand. Nur in ganz seltenen Fällen kann es zu eventuellen Kompatibilitätsproblemen mit kundenspezifischen Modulen kommen. Wenden Sie sich in dem Fall bitte an den e-Spirit Technical Support (https://help.e-spirit.com/).

Hinweise zum Betrieb des neuen FirstSpirit ContentCreator

• Ressourcenbedarf: Der Technologiewechsel des ContentCreator („MicroApp Framework“) führt zu einem erhöhten Ressourcenbedarf und erhöhten Systemanforderungen. Daher sollten die Ressourcen speziell im Bereich des eingesetzten Applikations-Servers (z. B. Apache Tomcat) geprüft und ggf. aufgestockt werden, speziell der Festplattenplatz und der Java-Heap.
  Der ContentCreator sollte dabei, soweit möglich, als globale Web-Applikation verwendet werden. Als eigene Projektinstanz („projektlokal“) sollte der ContentCreator nur betrieben werden, wenn dies unbedingt nötig ist.
• Betrieb mit Apache Tomcat: Bei Verwendung von Apache Tomcat als Application-Server wird grundsätzlich nach jeder Aktualisierung von FirstSpirit ein Neustart des Apache Tomcat empfohlen.
• Pluggability: Für eine uneingeschränkte Verwendung des neuen FirstSpirit ContentCreator muss die Option Pluggability aktiviert sein (FirstSpirit ServerManager / „Server-Eigenschaften / Web-Applikationen“ bzw. „Projekt-Eigenschaften / Web-Komponenten“ / „ContentCreator“). Bei Verwendung des ContentCreator ist der Pluggability-Modus automatisch systemseitig aktiviert (Log-Eintrag: WARN 03.02.2020 15:58:20.902 (de.espirit.firstspirit.server.module.WebServerManagerImpl): Force enabled pluggability for 'fs5webedit' in project '-1'.). In der Oberfläche wirkt sich dies nicht aus, sodass die Option „Pluggability“ ggf. auf „Inaktiv“ steht, obwohl die Option aktiviert ist.
• Betrieb im Browser: Der neue ContentCreator ist nicht mit dem Microsoft Internet Explorer kompatibel. Es wird empfohlen, für den neuen ContentCreator Google Chrome und Microsoft Edge auf Chromium-Basis zu verwenden. Siehe dazu auch Kapitel „Entfall des Supports für Microsoft Internet Explorer“.

Dokumentation

Die Dokumentation wurde bereits großflächig an das neue Design angepasst. Nur stellenweise entspricht die Darstellung noch nicht der Oberfläche im neuen Design und kann sich von dem ContentCreator unterscheiden, den Sie im Einsatz haben.

Das Konzept der „Bild-Auflösungen“ in FirstSpirit ermöglicht seit jeher eine einheitliche Verwendung von Bildgrößen in Online-Präsenzen. Die für ein Projekt gewünschten Auflösungen werden vom System standardmäßig automatisch berechnet und erzeugt.

Je nach Bildmaterial und Projekteinstellungen müssen diese automatisch erzeugten Auflösungen jedoch oftmals vom Redakteur geprüft und manuell angepasst werden: In manchen Projekt-Set-Ups (z. B. bei einer Vorgabe von konkreten Seitenlängen) sind die Auflösungen gestaucht, die Proportionen des angelieferten Bildmaterials passen nicht zu den Proportionen und Größen, die für die Internetpräsenz benötigt werden. In anderen Fällen möchte der Redakteur für einige Bilder vielleicht einen anderen Fokus wählen und einen anderen Ausschnitt in den „Mittelpunkt“ rücken.

Mit Smart Cropping entfällt das Prüfen der einzelnen Auflösungen und eine manuelle Anpassung durch den Redakteur weitgehend: Durch intelligente Technik kann manuell gleichzeitig für alle Auflösungen eines Bildes ein passender Ausschnitt gewählt werden.
Dazu wird anhand eines Bereichs, den der Redakteur im Bild als Hauptmotiv per Auswahlrahmen bestimmen kann („Fokusbereich“), für jede Auflösung automatisch ein passender Zuschnitt berechnet.
Dabei wird der „Goldene Schnitt“ angewendet: Dieser sorgt dafür, dass die Bildkomposition organisch und harmonisch proportioniert wirkt statt starr und konstruiert.
Standardmäßig wird dabei von der Bildmitte ausgegangen, d.h. die Ausschnitte werden zur Mitte des Bildes hin erweitert. Der Redakteur kann aber auch selbst mit der „Blickwinkel“-Funktion festlegen, in welche Richtung des Originalbildes die Ausschnitte erweitert werden sollen (oben, unten, rechts, links...). Mit diesem Blickwinkel kann man somit steuern, welcher Bereich des Bildes für die Auflösungen relevant ist und für den automatischen Zuschnitt berücksichtigt werden soll.
Bei Bildern mit Personen kann der Blickwinkel z. B. idealerweise so gewählt werden, dass neben der Person und ihrer Blickrichtung auch das Blickziel im Fokusbereich liegt.

In diesem Rahmen wurde bestehende API erweitert sowie neue geschaffen, um beispielsweise Fokusbereiche ohne Benutzerinteraktion definieren zu können.

Mit FirstSpirit 2020-07 kann das neue Feature im Rahmen einer Ramp-up-Phase getestet werden und wird einigen ausgewählten Kunden und Partnern zur Erprobung zur Verfügung gestellt. Feedback aus dieser Phase fließt zeitnah in die Entwicklung mit ein. Haben Sie ebenfalls Interesse, die neue Funktionalität zu testen? Dann melden Sie sich bei Ihrem zuständigen Kunden- bzw. Partnermanager.

Eine offizielle Freigabe für alle Kunden ist für das 4. Quartal 2020 vorgesehen.

Wurden auf einem Element keine Metadaten definiert oder der Haken „Rechte definieren“ in der Eingabekomponente CMS_INPUT_PERMISSION nicht gesetzt, dann wird für die Eingabekomponente jetzt grundsätzlich eine leere Liste zurückgegeben.

Grundsätzlich sollte vor der Abfrage der Inhalte geprüft werden, ob auf diesem Element Metadaten definiert sind und ob diese Rechte dort gesetzt oder vererbt wurden.

( <IDProvider>.hasMeta() && !<IDProvider>.getMetaFormData().get(null,
   <Name der Eingabekomponente>).get().isInherited() )

Wenn die obige Abfrage „false“ zurückliefert, findet man die korrekten Werte auf dem Knoten in der Vaterkette, für den diese Abfrage „true“ zurückliefert.

Mit FirstSpirit 2020-07 entfällt die Eingabekomponente FS_LIST. Die Komponente wurde aus FirstSpirit ausgebaut und 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. Die Ramp-Down-Phase ist damit abgeschlossen.

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

Um das Ausphasen der FS_LIST möglichst risikoarm zu gestalten, wurde 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, bestand für eine sechsmonatige Übergangszeit die Möglichkeit, FS_LIST temporär zu reaktivieren.
• (Abgeschlossen) Mit FirstSpirit 2020-07 wurde die Eingabekomponente aus FirstSpirit ausgebaut und kann ab diesem Zeitpunkt in keinem Projekt mehr verwendet werden.

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.

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

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

Im Rahmen der Überarbeitung und Zusammenführung der technischen Basis für FirstSpirit ContentCreator und FragmentCreator wurde die graphische Oberfläche des FragmentCreator überarbeitet und an die Designprinzipien des ContentCreator angepasst.

Mit dem Design-Update sind grundsätzlich keine funktionalen Änderungen für Redakteure oder Entwickler verbunden. Alle Funktionen in den Oberflächen stehen prinzipiell an den bekannten Positionen zur Verfügung. Weder entwicklungs- noch betriebsseitig fallen Aufwände mit dem Update des Designs an.

Die Änderungen des aktuellen Releases betreffen die Statusleiste am unteren Bildschirmrand.

Jetzt:

Vorher:

Die Anpassung der Dokumentation hinsichtlich des Designs erfolgt sukzessive, daher entspricht die Darstellung in der Dokumentation potenziell nicht mehr dem aktuellen Software-Stand.

An den favorisierten Varianten im FragmentCreator können jetzt Aktionen aus kundenspezifischen MicroApps bereitgestellt werden. Die Varianten-Reiter („Tabs“) werden um 3 Punkte erweitert, über die Bearbeitungsoptionen der MicroApps erreichbar werden, z. B.:

Wird eine Aktion gewählt, wirkt sie sich auf die gewählte Variante aus.

Standardmäßig können dort die Standard-Arbeitsabläufe für Freigabe („Freigabe anfordern“ / request_release) und Löschen („Löschung anfordern“ / delete_fragment_wf) gestartet werden.
Siehe dazu auch https://docs.e-spirit.com/odfs/edocs/cxt/arbeitsablaeufe/index.html.
Es werden nur Aktionen angezeigt, für die der Benutzer die entsprechenden Rechte hat.

Um Aktionen aus kundenspezifischen MicroApps an dieser UI-Schnittstelle bereitzustellen, muss die MicroApp den neuen VariantActionContext unterstützen. Dieser beinhaltet

• die projectId
  ID des betreffenden Projekts
• eine documentId
  ID der betreffenden Variante
• ein command
  die gewünschte Aktion, z. B. 'EditVariant'
• die application (optional)
  Hier kann aktuell über den Wert 'fragmentcreator' definiert werden, dass an dieser Stelle in der UI MicroApps angezeigt werden sollen.

Beispiel:

{ command: 'EditVariant', documentId: '4757cadc-d71e-4a58-9f3e-5cfbe86a9caa', 
   projectId: 1, application: 'fragmentcreator'}

Hinweis: Die Verwendung der API ist aktuell noch für den internen Gebrauch bestimmt und wird intern sowie durch Partner getestet. Zukünftig soll sie auch für externe Kunden bereitgestellt werden.

Aus dem fs[-isolated-]webrt.jar wurden die Klassen der Open-Source-Bibliothek „Apache PDFBox“ entfernt.

Sofern diese Klassen bei der Modulentwicklung verwendet wurden (dies war nur für Module möglich, die Webanwendungen im Legacy Mode enthalten), müssen diese nun fehlenden Klassen der Webanwendung jetzt explizit hinzugefügt werden. Das bedeutet, die Bibliothek „Apache PDFBox“ muss im Modul als „web-resource“ mitgebracht werden, indem sie in der Datei module[-isolated].xml entsprechend hinzugefügt wird, z. B.:

<web-resources>
   <resource name="org.apache.pdfbox:pdfbox" version="2.0.17">
       lib/pdfbox-2.0.17.jar
   </resource>
</web-resources>

Folgende Properties stehen jetzt in den Regeln für entsprechende Elemente zur Verfügung:

• ID: Ermittlung der ID eines FirstSpirit-Elements
• UID: Ermittlung des Referenznamens / UID eines FirstSpirit-Elements
  Absätze haben technisch gesehen keine UID, daher wird hier der Anzeigename zurückgegeben.
• GID: Ermittlung der globalen ID (GID) eines FirstSpirit-Elements
• TEMPLATE: Ermittlung der Vorlage des aktuellen FirstSpirit-Elements
  Es wird der Referenzname der Vorlage zurückgegeben (UID).

Code-Schnipsel:

<PROPERTY name="ID" source="#global"/>

<PROPERTY name="UID" source="#global"/>

<PROPERTY name="GID" source="#global"/>

<PROPERTY name="TEMPLATE" source="#global"/>

Auf einer Seite werden beispielsweise die Informationen der Seite zurückgeliefert (auch wenn die Regel z. B. in einem Absatz innerhalb einer FS_CATALOG-Eingabekomponente ausgeführt wird).
In Metadaten werden Information des Elements zurückgeliefert, auf dem die Metadaten definiert wurden.

Die Konfiguration der Datenbankanbindung des FirstSpirit-Servers erfolgt über den FirstSpirit ServerManager (unter Servereigenschaften / Datenbanken). In diesem Bereich werden alle auf dem Server eingebundenen Datenbank-Layer aufgelistet, das bedeutet, alle auf dem Server zur Verfügung stehenden Verbindungen zu einer Datenbank. Über den optionalen JDBC-Parameter jdbc.MAXSTRINGLENGTH kann im Datenbank-Layer die maximale Anzahl der Zeichen einer VARCHAR-Spalte beim Erstellen einer neuen Datenbank-Tabelle definiert werden. Wenn für ein String-Attribut ein größerer Wert angegeben wird, als über den Parameter jdbc.MAXSTRINGLENGTH definiert, wird ein anderer Datentyp (z. B. BLOB, CLOB oder TEXT) zur Speicherung in der Datenbank genutzt. Ist hier kein Wert gesetzt, wird abhängig von der verwendeten Datenbank ein Standardwert gesetzt.

Neues Verhalten:

Mit dem aktuellen FirstSpirit Release wird der Parameter jdbc.MAXSTRINGLENGTH für die folgenden Datenbanken unterstützt:

• PostgreSQL
• Oracle 19c

Für PostgreSQL gilt:

• Standardwert: Ist kein Wert über jdbc.MAXSTRINGLENGTH definiert, wird der Standardwert 255 verwendet.
• Maximalwert: Von einer Definition von Werten größer als 65534 wird abgeraten

Für Oracle 19c gilt:

• Standardwert: Ist kein Wert über jdbc.MAXSTRINGLENGTH definiert, wird der Standardwert 2000 verwendet.
• Empfehlung: Je nach Zeichensatz (Parameter jdbc.oracle.CHARACTERSET), ist eine Anpassung der Zeichenlänge sinnvoll. Für Oracle 19c wird z. B. der Zeichensatz AL32UTF8 mit der Zeichenlänge 8191 empfohlen. Der empfohlene Wert für den jeweiligen Zeichensatz kann der Dokumentation des Parameters (siehe „Werte für Oracle 19c (abhängig vom Zeichensatz)“) entnommen werden.
• Maximalwert: Werden Werte für den Parameter angegeben, die größer als der empfohlene Wert des angegebenen Zeichensatzes (Parameter jdbc.oracle.CHARACTERSET) sind, so wird eine entsprechende Meldung im Server-Log protokolliert. Der Maximalwert für den jeweiligen Zeichensatz kann der Dokumentation des Parameters (siehe „Werte für Oracle 19c (abhängig vom Zeichensatz)“) entnommen werden.
  • Bei Werten, die größer als der Maximalwert des angegebenen Zeichensatzes sind, wird ein ERROR geloggt und der Wert auf den Maximalwert verringert.
  • Bei Werten, die größer als der empfohlene Wert und kleiner als der Maximalwert des angegebenen Zeichensatzes sind, wird eine entsprechende WARN Meldung geloggt, in der die empfohlene Größe ausgegeben wird.

Für alle weiteren empfohlen und kompatiblen Datenbanksysteme wird der Parameter jdbc.MAXSTRINGLENGTH ignoriert. Stattdessen werden immer die festkodierten Standardwerte des jeweiligen Datenbank-Layers verwendet.

Ich verwende in meiner bestehenden Layer-Konfiguration den Parameter jdbc.MAXSTRINGLENGTH. Muss ich die Konfiguration anpassen?

Hintergrund: Der Parameter wird bisher ignoriert. Nach einer Aktualisierung auf FirstSpirit 2020-07 wird der Parameter dann für bestehende PostgreSQL- bzw. Oracle-19c-Datenbankkonfiguration ausgewertet. Abhängig vom Wert, der für den Parameter in der Konfiguration hinterlegt ist, können sich dadurch beim ersten Sync in die Datenbank, die Datentypen der String-Attribute ändern und damit möglicherweise Daten verloren gehen.

Mehr Informationen:

• Servereigenschaften - Datenbanken
• Pflichtparameter für die Datenbankanbindung
• Optionale Parameter (inklusive jdbc.MAXSTRINGLENGTH)

Mit dem aktuellen FirstSpirit-Release wurde folgende intern verwendete Software aktualisiert:

• Spring Boot (für das MicroApp Framework)
  Aktualisierung von Version 2.2.5 auf Version 2.3.1
• Spring Cloud Hoxton (für das MicroApp Framework)
  Aktualisierung von Version Hoxton.SR3 auf Version Hoxton.SR5