Release Notes

Über die Projekteigenschaften im FirstSpirit Server Manager („FirstSpirit ServerManager / Projekt / Eigenschaften / Sprachen“) werden alle Sprachen für ein Projekt aufgelistet. Die definierten Projektsprachen werden im SiteArchitect in der definierten Reihenfolge angezeigt. Die Reihenfolge der Projektsprachen kann jetzt zusätzlich zur Verwendung des Kontextmenüs auch per Mauszeiger (Drag-and-drop) geändert werden.

Dabei gilt: Die Mastersprache bleibt immer an erster Stelle der Reihenfolge.

Der Metaspace (ein weiterer, nativer Speicherbereich neben dem Heap) wird von der Java-VM automatisch verwaltet. Eine abweichende Konfiguration dieses Speicherbereichs, z. B. über die Parameter MetaspaceSize bzw. MaxMetaspaceSize wird ausdrücklich nicht mehr empfohlen.

Diese Parameter können in der Konfigurationsdatei fs-wrapper*.conf konfiguriert werden und wurden bisher automatisch gesetzt, sofern die Installation bzw. Aktualisierung des FirstSpirit-Servers über einen alten Installationsweg erfolgte, z. B. das Windows-Installationsprogramm (.exe): für Microsoft Windows Server (abgekündigt mit Release 2018-06).

Bitte prüfen Sie, ob die von Ihnen verwendete Konfiguration den Empfehlungen entspricht. Sie können die Parameter MetaspaceSize bzw. MaxMetaspaceSize ggf. manuell aus der fs-wrapper*.conf entfernen.

Bei einer Installation bzw. Aktualisierung über die neuen Tar-Gzip-Archive (Freigegeben mit 2019-06) ist keine Anpassung erforderlich:

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

Weiterführende Dokumentation:

• zur Konfiguration der Java-VM und -Wrapper (fs-wrapper*.conf)
• zu allgemeinen Java-Parametern für die Java-VM
• zu Anforderungen an einen externen Application-Server

e-Spirit stellt bisher Demo-Projekte mit exemplarischen Basis-Inhalten und Konfigurationen zur Verfügung. Diese werden zukünftig durch den zeitgemäßen „FirstSpirit Experience Accelerator“ ersetzt. 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.

Das Demo-Projekt „Mithras Energy“ (für ContentCreator und SiteArchitect) wird zukünftig entfallen und nicht mehr im Auslieferungsumfang von FirstSpirit enthalten sein.

Mit dem aktuellen FirstSpirit-Release wird eine neue Version des JSON-Ausgabeformats veröffentlicht. Die neue JSON-Formatversion 1.1 enthält einige Verbesserungen gegenüber der Version 1.0 (siehe unten). Ab FirstSpirit 2020-02 wird die neue Formatversion 1.1 eingesetzt (Standardeinstellung).

Die bisherige Formatversion 1.0 bleibt weiterhin unterstützt, soll aber mittelfristig abgelöst werden.

Die Formatversion kann über die JSON-Einstellungen explizit gesetzt werden:

$CMS_SET(#global.json.formatVersion, "1.1")$

Wenn die Formatversion nicht explizit eingestellt wird, dann wird immer die aktuelle JSON-Formatversion (jetzt 1.1) verwendet.

Übersicht der Änderungen:

1) Neues Attribut „page“ für Seitenreferenzen:

Bei der Ausgabe einer Seitenreferenz wird nun die dazugehörige Seite als Kind-Attribut „page“ ausgegeben.

Das führt dazu, dass die Attribute der Seitenreferenz nur noch Werte der Seitenreferenz enthalten. Alle Werte, die zur Seite gehören (z.B. das Attribut „formData“), befinden sich nun im JSON-Objekt der Seite. (Bisher wurden bei der Ausgabe einer Seitenreferenz, die Werte aus der Seite und der Seitenreferenz zusammengeführt, um die JSON-Objektstruktur möglichst einfach zu halten.)

2) Das Attribut „metaFormData“ wird in der Standardeinstellung immer ausgegeben:

Die Metadaten aller Objekte werden nun ausgegeben, sofern die Ausgabe nicht über den Schalter $CMS_SET(#global.json.metaDataRendering, false)$ explizit ausgeschaltet wird.

Bisher war das Verhalten genau umgekehrt - die Ausgabe der Metadaten musste über $CMS_SET(#global.json.metaDataRendering, true)$ explizit aktiviert werden.

3) Ausgabe von Anzeigenamen (Attribut „displayname“):

Für alle Knoten, die einen Anzeigenamen haben können, wird der Anzeigename für die aktuell erzeugte Sprache über das Attribut „displayname“ ausgegeben.

Wurde kein Anzeigename definiert, wird stattdessen der Anzeigenamen der Mastersprache ausgegeben. Ist auch dieser nicht definiert, wird der Referenzname des Knotens ausgegeben.

4) Das Attribut „valueSchema“ wurde entfernt:

Das Attribut „valueSchema“ wird nicht mehr ausgegeben.

5) Das Attribut „identifier“ wurde entfernt (Ausgabe von Eingabekomponenten):

Bei der Ausgabe der Daten von Eingabekomponenten wird nur noch das Attribut „name“ ausgegeben. Das Attribut „identifier“ wurde entfernt, da beide Attribute denselben Inhalt hatten.

Ausgabe einer Seitenreferenz im Format 1.1 (vereinfachte Darstellung):

{
   "fsType": "PageRef",
   "name": "pt_metadata_selective_1",
   "displayName": "pt_metadata_selective",	
   "identifier": "15ff7b8d-9059-4721-b92b-e697e153fc85",
   "uid": "pt_metadata_selective_1",
   "uidType": "SITESTORE_LEAF",
   "metaFormData": { 
      "meta_field1": {
         "fsType": "CMS_INPUT_TEXT",
         "name": "meta_field1",
         "identifier": "meta_field1",
         "value": null,
         "valueSchema": {
            "type": "null"
         }
      },
      "meta_field2": {
         "fsType": "CMS_INPUT_TEXT",
         "name": "meta_field2",
         "identifier": "meta_field2",
         "value": "value_field2_set",
         "valueSchema": {
            "type": "string"
         }
      },
      "meta_field3": {
         "fsType": "CMS_INPUT_DATE",
         "name": "meta_field3",
         "identifier": "meta_field3",
         "value": null,
         "valueSchema": {
            "type": "null"
         }
      }
   },	
  "page": {
      "fsType": "Page",
      "name": "pt_metadata_selective_1",
      "displayName": "pt_metadata_selective",	
      "identifier": "76a0b7c2-3ec8-4908-88e8-53c2f43d9902",
      "uid": "pt_metadata_selective_1",
      "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"
      },
      "formData": { 
      },
     "metaFormData": { 
         "meta_field1": {
            "fsType": "CMS_INPUT_TEXT",
            "name": "meta_field1",
            "identifier": "meta_field1",
            "value": "value_field_1",
            "valueSchema": {
               "type": "string"
            }
         },
         "meta_field2": {
            "fsType": "CMS_INPUT_TEXT",
            "name": "meta_field2",
            "identifier": "meta_field2",
            "value": null,
            "valueSchema": {
               "type": "null"
            }
         },
         "meta_field3": {
            "fsType": "CMS_INPUT_DATE",
            "name": "meta_field3",
            "identifier": "meta_field3",
            "value": null,
            "valueSchema": {
               "type": "null"
            }
         }
      },	
      "children": [

      ]
   }
}

Design und technische Basis des FirstSpirit ContentCreator wurden überarbeitet. Mit FirstSpirit 2020-01 wurde die Verwendung des überarbeiteten ContentCreator offiziell freigegeben. Seitdem konnten alle Kunden den ContentCreator im überarbeiteten Design nutzen, soweit dies in den Server-/Projekteinstellungen entsprechend konfiguriert wurde.

Gemäß Zeitplan wird mit dem aktuellen Release der „neue“ ContentCreator automatisch an alle Cloud-Kunden ausgerollt: Für alle Projekte, die mit dem ContentCreator gestartet werden, wird ab diesem Release das überarbeitete Design verwendet.
Bei Bedarf kann projektweise zum „klassischen“ ContentCreator zurückgewechselt werden, und zwar durch Deaktivieren der Checkbox „Neues Design verwenden“ im FirstSpirit ServerManager unter „Projekt-Eigenschaften / Web-Komponenten“ / Register „ContentCreator“.

Für alle Kunden wird der „neue“ ContentCreator planmäßig mit dem kommenden Release (FirstSpirit 2020-03) eingesetzt: Dann wird der überarbeitete ContentCreator automatisch für alle Projekte verwendet. Sollten Probleme auftreten, kann bei Bedarf unkompliziert zum „alten“ ContentCreator zurückgewechselt werden. Mit FirstSpirit 2020-07 wird der ContentCreator im „alten“ Design jedoch planmäßig entfallen, daher lautet die Empfehlung, möglichst früh den „neuen“ ContentCreator für alle Projekte einzusetzen.

Warum wurde der ContentCreator überhaupt überarbeitet und wie? – Einen Blick hinter die Kulissen der Designentwicklung für den neuen ContentCreator gewährt Ihnen unser Blog-Beitrag: www.e-spirit.com/de/blog/contentcreator_redesign.html.

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.
Darüber hinaus finden Sie ab sofort die Benutzerdokumentation zum ContentCreator als HTML-Version (statt zuvor PDF) auf dem zentralen Dokumentationsserver docs.e-spirit.com.

Hinweise zum Betrieb des neuen FirstSpirit ContentCreator

• Bisher musste für eine uneingeschränkte Verwendung des neuen FirstSpirit ContentCreator die Option Pluggability auf „Aktiv“ gestellt werden. Mit dem aktuellen Release wird für den neuen FirstSpirit ContentCreator die Pluggability erzwungen. Das bedeutet: Wird der neue FirstSpirit ContentCreator verwendet, wird 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.
  Zu weiteren Informationen zur Option „Pluggability“ siehe auch FirstSpirit Dokumentation für Administratoren, Seite Web-Applikationen bzw. Web-Komponenten.
• Der Technologiewechsel des ContentCreator („MicroApp Framework“) führt zu einem erhöhten Ressourcenbedarf und erhöhten Systemanforderungen. Dies macht sich speziell während der aktuellen Übergangszeit bemerkbar, in der der „neue“ und der „alte“ ContentCreator parallel betrieben werden können.
  • 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, 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.
  • Beim Einsatz von Apache Tomcat als Application-Server wird grundsätzlich nach jeder Aktualisierung von FirstSpirit ein Neustart des Apache Tomcat empfohlen.

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

* Das Modul „FirstSpirit Markdown Editor“ benötigt ab Version 1.17 FirstSpirit 2019-12 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 (siehe dazu auch Kapitel „Rollout des neuen ContentCreator“).
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 Design-Änderungen beziehen sich auf Farbe und Form von Icons, Schriften und Hintergrundfarben:

Für eine bessere Orientierung wird das aktuell ausgewählte Fragment jetzt in der Fragment-Liste (linke Bildschirmseite) stärker farbig hervorgehoben. Der aktuelle Benutzer wird jetzt in der Fragment-Liste in blauer Schrift, alle anderen Benutzer in grauer Schrift angezeigt.

In der Variantenübersicht (rechte Bildschirmseite, „Variantenmanager“) können jetzt mehrere Varianten per Klick ausgewählt und für diese ein Arbeitsablauf gestartet werden.

Die Detailinformationen, die bisher unterhalb des Aufgabenbereichs rechts unten für das ausgewählte Fragment bzw. die Variante angezeigt wurden, waren redundant zu den Informationen der Status-Anzeige und sind daher nun für mehr Übersichtlichkeit entfallen.

Die Benutzerführung beim Hochladen und Auswählen von Bildern in einem Eingabeelement (Schaltfläche „Upload Picture“) wurde in diesem Kontext ebenfalls verbessert:
Prinzipiell werden jetzt alle Bilder, die per Drag-and-drop in den Upload-Dialog gezogen werden, nach dem Upload auch im betreffenden Eingabeelement referenziert (visualisiert durch Häkchen-Symbole). Zuvor mussten die Bilder aktiv ausgewählt werden, die im Eingabeelement referenziert werden sollten.

Durch Anklicken der gewünschten Bilder können sie jetzt weiterhin an-/abgewählt werden. So lässt sich steuern, welche Bilder im betreffenden Eingabeelement referenziert werden.
Nach erfolgreichem Upload (Schaltfläche „Hochladen“) schließt sich der Upload-Dialog jetzt automatisch und muss nicht mehr manuell geschlossen werden. Ausnahme: Im Fehlerfall bleibt der Dialog geöffnet, zeigt eine entsprechende Fehlermeldung, und die betroffenen Bilder werden nicht hochgeladen.

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

Bilder/Medien können im Projekt in unterschiedlichen Auflösungen vorliegen. Die Bilddaten werden bei Bedarf automatisch vom System berechnet, wenn ein Medium erstmalig in einer Auflösung angefordert wird. Anschließend werden die Bilddaten (zu einer Auflösung) serverseitig in einem Image Cache (MEDIA_STORE_CACHED_PICTURES) gespeichert.

Dieses Verhalten ermöglicht schnelle Generierungszeiten, da insbesondere die Generierung vieler Medien in vielen, unterschiedlichen Auflösungen sehr zeitintensiv ist. Der Image Cache vergrößert aber auch die Datenmenge des Projekts, da automatisch berechnete Auflösungen bisher nur durch einen Projektexport (über das Deaktivieren der Option „Automatisch berechnete Auflösungen exportieren“) wieder aus dem Datenbestand des Projekts entfernt werden konnten.

Mit dem aktuellen FirstSpirit-Release wurde dieses Verhalten verbessert. Über die Projektarchivierung (Auftrag „Alte Projektstände archivieren“) können nun alle berechneten Bilder/Medien aus dem Image Cache entfernt werden, deren Auflösungen im Projekt nicht mehr vorhanden sind (d.h. die zuvor über „Projekteigenschaften“ - „Auflösungen“ - „Löschen“ entfernt wurden).

Dazu muss Option „Inhalte, Medien und Datenquellen“ unter „Objekte“ aktiviert werden:

ServerManager - Projektbezogene Aufträge - Projektarchivierung

Beim Ausführen der Archivierung werden die nicht mehr benötigten, automatisch berechneten Auflösungen anschließend aus dem Projekt entfernt und nicht mehr in die Archivdatei übernommen.

Das Entfernen der nicht mehr benötigten, automatisch berechneten Auflösungen wird unabhängig von den weiteren Einstellungen für die Projektarchivierung ausgeführt (z. B. für „Versionshistorie“ und „Optionen“).

Vorteile:

• Die Projektgröße wird reduziert.
• Die Ladezeiten werden reduziert.
• Die Gesamtperformance des FirstSpirit-Servers wird verbessert.

Weiterführende Dokumentation siehe:

• Projektstände archivieren

Mit dem aktuellen Release wurde folgende intern verwendete Software aktualisiert:

• Spring Boot (für das MicroApp Framework)
  Aktualisierung von Version 2.2.1 auf Version 2.2.2