Release Notes

Mit Entfall des Java-8-Supports wird, wie bereits angekündigt, auch der Support für das Windows-Installationsprogramm (.exe) für Microsoft Windows Server (abgekündigt mit Release 2018-06) und zeitgleich auch das bisherige tar-Archiv (.tgz) für alle Unix-Systeme entfallen.

Die bisherigen Installationsmöglichkeiten werden durch neue Installationsmöglichkeiten für den FirstSpirit-Server und Aktualisierungsmöglichkeit für das FirstSpirit-Backend ersetzt, die mit FirstSpirit Release 2019-06 freigeben wurden:

• fs-install-[version].tar.gz zur Installation des FirstSpirit-Servers und
• fs-update-[version].tar.gz zur Aktualisierung des FirstSpirit-Backends.

Die neuen Archive können flexibel bei unterschiedlichen Anforderungen eingesetzt werden. Sie sind kompatibel zu allen unterstützten Betriebssystemen und können für Server im Isolated- und Legacy-Modus verwendet werden.

Ein weiterer Vorteil der neuen Installations- und Aktualisierungsmöglichkeiten liegt in der automatischen Aktualisierung der (Java-)Versions-spezifischen Startparameter für den Serverstart. Dabei wird für alle Neuinstallationen mit dem Installationsarchiv fs-install-[version].tar.gz eine Konfigurationsdatei fs-wrapper-vendor.conf mit den empfohlenen Hersteller-Startoptionen für den Start des FirstSpirit-Servers angelegt. Diese Datei wird bei einer Aktualisierung des FirstSpirit-Backends über das FirstSpirit Aktualisierungsarchiv fs-update-[version].tar.gz automatisch aktualisiert - enthält also immer die aktuellen Startoptionen für die jeweilige Java-Version.

Weiterführende Dokumentation:

• FirstSpirit installieren
• FirstSpirit aktualisieren
• Java-VM und -Wrapper (fs-wrapper*.conf)
• FirstSpirit ServerMonitoring / FirstSpirit / Konfiguration / Startoptionen

Start und Aktualisierung (Rollout) der FirstSpirit Desktop-Anwendungen (FirstSpirit SiteArchitect und ServerManager) konnten bislang mithilfe der Java Web Start-Technologie oder mithilfe des FirstSpirit Launcher erfolgen.

Die Java Web Start-Funktionalität ist in Oracle Java 8 noch enthalten, mit Oracle Java 11 ist Java Web Start jedoch entfallen. OpenJDK bietet keine vergleichbare Technologie an. Da FirstSpirit Oracle Java 8 nicht mehr unterstützt, wird die Unterstützung von Java Web Start für Start und Rollout der FirstSpirit Desktop-Anwendungen mit der aktuellen FirstSpirit-Version entfallen (abgekündigt mit 2019-10). Die FirstSpirit-JNLP-Dateien, die für Java Web Start benötigt wurden, werden zukünftig ebenfalls entfallen.

Ein Wechsel zum FirstSpirit Launcher ist in der Regel ohne Konfigurationsaufwand möglich. Der FirstSpirit Launcher ermöglicht ein vollautomatisches Update (sowohl des Launcher selbst als auch des JREs). Dabei wird bei der Verwendung des Launcher die auf dem entsprechenden FirstSpirit-Server verfügbare Launcher-Version ermittelt und ein Update gestartet, wenn die Version auf dem Server aktueller ist. Darüber hinaus bietet der neue Launcher eine Tray-Anwendung, mit der der Benutzer eine komfortable Übersicht über aktuell laufende sowie kürzlich verwendete FirstSpirit-Java-Anwendungen erhält.

Weiterführende Dokumentation:

• Installation FirstSpirit Launcher

Mit dem aktuellen FirstSpirit-Release wird Oracle Java 8 bzw. OpenJDK 8 von FirstSpirit nicht mehr unterstützt.

Hintergrund: FirstSpirit wird mit einer Vielzahl unterschiedlicher Fremdkomponenten (Betriebssysteme, JDKs, Servlet Engines, Application Server, Datenbanken) und unter Verwendung externer Bibliotheken erfolgreich bei Kunden und Partnern eingesetzt. Einige dieser Komponenten / Bibliotheken sind in der aktuellen Version nicht mehr mit Java 8 kompatibel. Das betrifft z. B. die mit FirstSpirit ausgelieferte, interne Datenbank Apache Derby. Damit können keine Aktualisierungen für diese Fremdkomponenten / Bibliotheken mehr durchgeführt werden, was insbesondere für sicherheitsrelevante Updates kritisch ist.

Oracle selbst stellt bereits seit Februar 2019 keine öffentlichen Updates für Java 8 mehr zur Verfügung und empfiehlt Entwicklern und Endbenutzern eine Umstellung auf eine höhere Java-Version, um weiterhin öffentlich zugängliche Updates und Sicherheitsverbesserungen zu erhalten.

Mit Entfall des Java-8-Supports wird, wie bereits angekündigt, auch:

• der Support für den Windows-Installer und das bisherige tar-Archiv (.tgz) für alle Unix-Systeme entfallen. Benutzern wird empfohlen, für Neuinstallationen das Installationsarchiv zu verwenden (siehe FirstSpirit installieren) und
• die Möglichkeit entfallen, die FirstSpirit-Desktop-Anwendungen über Java Web Start zu starten. (Die Java Web Start-Funktionalität ist in der Java 8 noch enthalten, mit Oracle Java 11 jedoch entfallen. OpenJDK bietet keine vergleichbare Technologie). SiteArchitect und ServerManager können jetzt ausschließlich über den FirstSpirit Launcher gestartet werden (siehe Dokumentation zum FirstSpirit Launcher). Die FirstSpirit-JNLP-Dateien, die für Java Web Start benötigt wurden, werden ebenfalls entfallen.

Die Ramp-Down-Phase für Java 8:

• startete planmäßig in Q2-2020. Dabei wurden zunächst schrittweise die Java-8-Kompatibilitätstests reduziert.
• Mit der aktuellen FirstSpirit Version wird nun Java-8-Funktionalität aus FirstSpirit ausgebaut:
  • Wrapper-Konfiguration: Aus den von e-spirit bereitgestellten Standard-Konfigurationsdateien für den Java Service Wrapper (fs-wrapper[.isolated].conf, fs-wrapper-vendor.conf) wurden alle Definitionen für Java 8 entfernt.
    Die Standard-Konfigurationsdateien werden über das FirstSpirit Installationsarchiv bzw. das FirstSpirit Aktualisierungsarchiv bereitgestellt und finden sich nach einer Neuinstallation bzw. nach einer Aktualisierung des FirstSpirit Backends im Ordner „<FirstSpiritROOT>/conf/conf-all/“. Die Anpassungen sind ab Wrapper-Version 1.0.8 enthalten.
    Zum Start des FirstSpirit-Servers wird eine Java Version 11 oder höher vorausgesetzt.
  • Launcher-JRE-Modul: Oracle Java 8 und AdoptOpenJDK 8 sind im Modul FirstSpirit Launcher JRE nicht mehr enthalten. Über das Modul FirstSpirit Launcher JRE werden aktuell die Versionen AdoptOpenJDK 11.0.7+10 (Default) und AdoptOpenJDK 14+36 bereitgestellt.
• In Q4-2020 wird dann nachgelagert das Byte-Code-Level von Java 8 auf Java 11 umgestellt. Ab diesem Zeitpunkt werden alle Java-Versionen vor Java 11 (LTS) mit FirstSpirit inkompatibel sein.

Das bedeutet, dass FirstSpirit nicht mehr mit Oracle Java 8 bzw. OpenJDK 8 lauffähig sein wird und seitens der e-Spirit AG keine Maßnahmen mehr zur Beseitigung von Fehlern oder Problemen ergriffen werden, die mit Java 8 in Zusammenhang stehen. Ein frühzeitiger Wechsel auf eine höhere Java-Version wird empfohlen.

Die Rechteverwaltung in FirstSpirit ermöglicht das Zuweisen von Rechten an Benutzer und Gruppen. Rechte können feingranular für jedes FirstSpirit-Element in einem Projekt zugewiesen werden. Die Rechtevergabe erfolgt im FirstSpirit SiteArchitect über die Kontextmenü-Funktion „Extras / Rechte ändern“ auf dem gewünschten Element bzw. Teil-Baum eines Projekts.

Elemente der Struktur-Verwaltung (Menüebenen, Seitenreferenzen...)

die für den aktuellen Benutzer nicht sichtbar ist (Checkbox „Sichtbar“ ist deaktiviert), z. B.

werden jetzt in der Navigationsansicht am linken Bildschirmrand nicht mehr dargestellt.
Zuvor wurde in diesen Fällen dort ** Kein Zugriff ** angezeigt:

Sollen Inhalte einer Seite von einem Benutzer oder einer Gruppe auch nicht bearbeitet werden können, müssen die Rechte für die entsprechende Seite in der Inhalte-Verwaltung vergeben werden.

Zu weiteren Informationen zur Rechtevergabe in FirstSpirit siehe https://docs.e-spirit.com/odfs/edocs/fsar/rechte-sitearch/redaktionsrecht/index.html.

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

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

FirstSpirit unterstützt konsequent das Konzept der Mehrsprachigkeit:

• Über die Startseite kann ausgewählt werden, in welcher Sprache die Beschriftung der Menüleiste, der Dialoge usw. erscheint (Oberflächensprache).
  Aktuell sind die verfügbaren Oberflächensprachen: Deutsch, Englisch, Spanisch, Französisch, Italienisch, Niederländisch, Russisch.
• In welcher Sprache Eingabeelemente, Tooltips usw. dargestellt werden, steuert der Projektentwickler hingegen über die Redaktionssprache (auch Anzeigesprache).

Für die Redaktionssprache wird jetzt das Attribut lang (im Tag LANGINFOS / LANGINFO) berücksichtigt, z. B.

<CMS_INPUT_TEXT name="headline" useLanguages="no">
     <LANGINFOS>
       <LANGINFO lang="*" label="Headline"/>
       <LANGINFO lang="DE" label="Überschrift"/>
     </LANGINFOS>
</CMS_INPUT_TEXT>

Ist als Oberflächensprache „Deutsch“ ausgewählt, wird jetzt für die Beschriftung des Eingabeelements (Attribut label) ebenfalls „Deutsch“ (im Beispiel oben: „DE“) berücksichtigt:

Für Oberflächensprachen, die nicht zu den Redaktionssprachen gehören, wird als Fallback die Mastersprache verwendet.

Im Editierbereich oder in MicroApps wurde nicht immer der aktuellste Stand einer Variante angezeigt, wenn beispielsweise ein anderer Nutzer Änderungen am Inhalt vorgenommen hat.
Eine manuelle Aktualisierung ist jetzt nur noch erforderlich, wenn eine gleichzeitige Bearbeitung der Inhalte durch einen anderen Nutzer stattfindet.
In diesem Fall werden alle Eingabeelemente der Variante („Formular“) für eine Bearbeitung gesperrt, und es wird folgende Meldung ausgegeben:

Die Änderungen können nicht gespeichert werden, weil das Element auf dem Server
  verändert wurde.

Mit einem Klick auf

KONFLIKTÄRE ÄNDERUNGEN! Hier klicken, um neu zu laden.

wird die Anzeige aktualisiert und die Variante kann wieder bearbeitet werden.

Hinweis: Bei Verwendung von FS_INDEX werden referenzierte Fragmente nicht automatisch aktualisiert.

Mit dem aktuellen Release können jetzt auch Referenzen auf Seiten erstellt werden, und zwar über das neue Modul PageRef Access Plugin (PageRef DAP).
Die durch den Nutzer gewählten Referenzen auf Seiten können als HTML-Verweise ausgegeben werden.

Bereitstellung und Installation
Die entsprechende Modul-Datei (Dateinamenerweiterung: .fsm) kann über den Technical Support angefordert werden:

pagerefdap-[version].fsm

Das Modul wird über den FirstSpirit ServerManager installiert, und zwar im Dialog „Servereigenschaften / Module“ über die Schaltfläche „Installieren“.

Remote-Konfiguration
Damit Referenzen auf Seiten aus anderen FirstSpirit-Projekten erstellt werden können, muss das gewünschte Projekt als „Remote-Projekt“ in den Projekteigenschaften (FirstSpirit ServerManager) konfiguriert werden:

Web-Komponente „PageRef DAP for ContentCreator“
Über die Web-Komponente „PageRef DAP for ContentCreator“ kann das Plugin im ContentCreator verwendet werden.
Dazu muss die Web-Komponente dem betreffenden Projekt im Bereich „ContentCreator“ hinzugefügt werden („FirstSpirit ServerManager / Projekt-Eigenschaften / Web-Komponenten“).

Verwendung in Projekten
Ist das Modul installiert, kann es von der Komponente zur Auswahl von Referenzen, FS_INDEX, angesprochen werden.
Der Redakteur kann eine oder mehrere Seitenreferenzen aus dem oder den konfigurierten Remote-Projekten auswählen.

Syntax-Beispiel für FS_INDEX, Register „Formular“:

<FS_INDEX name="links">
    <LANGINFOS>
      <LANGINFO lang="*" label="Page referencing / links"/>
      <LANGINFO lang="DE" label="Seitenreferenzen / Links"/>
    </LANGINFOS>
    <SOURCE name="FirstSpiritPageRefAccess/PageRefConnector">
      <PROJECT remote="pagerefs">
        <FOLDER uid="products"/>
      </PROJECT>
    </SOURCE>
</FS_INDEX>

• SOURCE: Über dieses Tag werden das FirstSpirit-Modul sowie die DataAccessPlugin-Komponente angegeben, und zwar über den Pflichtparameter name. In diesem Fall: FirstSpiritPageRefAccess/PageRefConnector.
• PROJECT: Über dieses Tag wird das Remote-Projekt angegeben, aus dem Referenzen möglich sein sollen. Über den Pflichtparameter remote muss dabei der symbolische Projektname des Remote-Projekts angegeben werden.
• FOLDER: Die Auswahl kann mithilfe des FOLDER-Tag auf Ordner des Remote-Projekts eingeschränkt werden. Sollen mehrere Ordner berücksichtigt werden, muss für jeden Ordner ein FOLDER-Tag angegeben werden. Der Name des betreffenden Ordners wird über den Parameter uid spezifiziert (Referenzname).

Wurde die Konfiguration korrekt vorgenommen, erhält der Redakteur in einer Variante eine Möglichkeit, Seitenreferenzen auszuwählen:

Auswahl

FS_INDEX mit ausgewählten Seitenreferenzen

Darstellung im ContentCreator:

Ausgabe in FirstSpirit-Projekten
Die durch den Redakteur gewählten Seitenreferenzen können in einem FirstSpirit-Projekt folgendermaßen ausgegeben werden:

$CMS_FOR(pageref, links.values())$<br />         
     <a href="$CMS_REF(pageref)$")$">
      $CMS_VALUE(pageref.uid)$  <br/>      
     </a>                     
$CMS_END_FOR$

Der bisherige Datenbank-Layer für Oracle Database 11g/12c ist, aufgrund von Änderungen in der Datenbank und im Treiber, nicht mit Oracle Database 19c kompatibel.
Um die Kompatibilität von FirstSpirit mit Oracle Database 11g/12c zu FirstSpirit mit Oracle Database 19c herzustellen wurde daher ein neuer Datenbank-Layer (Oracle19cLayer) implementiert.

Generell besteht die Möglichkeit, entweder einen neuen Datenbank-Layer zu verwenden oder den bestehenden Datenbank-Layer zu aktualisieren.

Neuen Datenbank-Layer verwenden:
Um den neuen Datenbank-Layer (Oracle19cLayer) zu verwenden, muss dieser lediglich in den Server-Eigenschaften (ServerManager) im Bereich Datenbanken hinzugefügt und passend zu den lokalen Anforderungen konfiguriert werden (siehe Server-Eigenschaften / Datenbanken).

Bestehenden Datenbank-Layer aktualisieren:
Um eine bestehende, mit FirstSpirit verwendete Oracle Database 12c auf 19c zu aktualisieren, besteht die Möglichkeit,

• ein FirstSpirit-Projekt zu exportieren und als neues Projekt mit Oracle-19-DB zu importieren oder
• den Datenbank-Layer zu wechseln, indem der Server pausiert, die Datenbank aktualisiert und der Datenbank-Layer manuell umgestellt wird.

Bei einer Umstellung von Oracle Database 11g/12c auf 19c ohne Änderung der Datenbank können die neuen Funktionalitäten von Oracle Database 19c nicht genutzt werden. Ein solches Vorgehen wird daher nicht empfohlen!

Achtung! Beim Aktualisieren einer Oracle Database 12c auf 19c sind unbedingt die Hersteller-Hinweise zu beachten!

Die EAP-Phase wird intensiv in der FirstSpirit Community (https://community.e-spirit.com) begleitet. Fragen und Probleme sollen so zeitnah geklärt werden.
In der Community wird auch eine ausführliche Dokumentation zur Verwendung einer Oracle Database 19c mit FirstSpirit hinterlegt. Die in dieser Dokumentation enthaltenen Empfehlungen für die Konfiguration der Oracle Database und des FirstSpirit-Servers sollten unbedingt beachtet werden.

Die endgültige Freigabe des neuen Layers ist für Q3/2020 geplant.

Das Demo-Projekt Mithras Energy für ContentCreator und SiteArchitect entfällt und wird mit dem aktuellen FirstSpirit Release nicht mehr im Auslieferungsumfang von FirstSpirit enthalten sein (abgekündigt mit FirstSpirit 2020-02).

e-Spirit ersetzt das Demo-Projekt durch den zeitgemäßen FirstSpirit Experience Accelerator (siehe Dokumentation zum FirstSpirit Experience Accelerator).
Der FirstSpirit Experience Accelerator ist ein neuer, wichtiger Baustein im FirstSpirit-Ökosystem. Er enthält Referenzimplementierungen zu wichtigen Contentmodulen (u. a. Shoppable Image und Video, Touchpoint Editing, Teaserkarussel und Banner) und kann als schneller Einstieg in ein neues FirstSpirit-Projekt verwendet werden. Zielsetzung des FirstSpirit Experience Accelerators ist eine schnellere Produkteinführung im Enterprise- und eCommerce-Umfeld.

Mit dem aktuellen FirstSpirit-Release wurden die im Modul „FirstSpirit Launcher JRE“ enthaltenen Java-Versionen aktualisiert:

Neben der mit dem FirstSpirit Launcher ausgelieferten Version, AdoptOpenJDK 11.0.7+10.2 (Default) ist aktuell folgende Java-Variante verfügbar:

• AdoptOpenJDK 14.0.1+7.1

Dokumentation zum Modul „FirstSpirit Launcher JRE“ siehe entsprechende Dokumentation.

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

Eclipse Jetty (im Modul fs-jetty.fsm / „FirstSpirit Jetty Service“ enthalten)
Aktualisierung von Version 9.4.27 auf Version 9.4.28

Library com.fasterxml.jackson.core:jackson-databind
(im Beispielmodul zur DataAccessPlugin-Implementierung für den Zugriff auf Web Services über das standardisierte Open Data Protocol (OData))
Aktualisierung von Version 2.4.2 auf Version 2.11.0
Allgemeine Informationen zum Modul siehe: https://docs.e-spirit.com/ (Examples)