Release Notes

Mit dem aktuellen Release wurde folgende intern, für FirstSpirit Content Experience Tools (CXT) verwendete Software aktualisiert:

• Spring Boot
  Aktualisierung auf Version 2.5.12

Die Informationen zu einigen Statistiken, die im FirstSpirit ServerMonitoring bisher einzeln als CSV-Dateien heruntergeladen werden konnten, können jetzt komfortabel gleichzeitig heruntergeladen werden, und zwar in einer ZIP-Datei, die die CSV-Dateien enthält.

FirstSpirit ServerMonitoring:

• Übersicht / Aktivitäten
• FirstSpirit / Monitoring / Kennzahlen

Liegen zu einem Bild Zuschnitte vor und wird das Originalbild nachträglich ausgetauscht, wurden die Ausschnitte bisher beibehalten. Potenziell passten die vorgenommenen Zuschnitte nicht mehr zum neuen Bild und sollten daher geprüft und bei Bedarf angepasst werden.

Mit dem aktuellen Release kann der Redakteur jetzt im „Bearbeiten“-Dialog im FirstSpirit ContentCreator wählen, wie in diesem Fall mit bestehenden Ausschnitten verfahren werden soll:

• Bildausschnitte zurücksetzen
  Bestehende Bildausschnitte werden entfernt und müssen neu erstellt werden. Diese Option ist initial ausgewählt.
• Bildausschnitte nicht verändern
  Bestehende Bildausschnitte werden beibehalten. Potenziell passen sie nicht mehr zum neuen Originalbild. Dies ist das bisherige Standardverhalten.
• Bildausschnitte erneuern, falls möglich
  Bildausschnitte werden neu berechnet und angewendet. Dies ist beispielsweise sinnvoll, wenn Motiv und Größe des Originalbildes unverändert geblieben sind.

Im Zuschnittsdialog des FirstSpirit ContentCreator wird darüber hinaus jetzt ein entsprechender Hinweis angezeigt, wenn Ausschnitte vorliegen und das Originalbild ausgetauscht wurde:

Einige Auflösungen haben einen veralteten Ausschnitt!

In der Eingabekomponente FS_CATALOG („Katalog-Liste“) lassen sich Listen von Absätzen oder Verweisen erstellen und pflegen.

Enthält eine solche Komponente wiederum einen FS_CATALOG, konnte die Reihenfolge der inneren Elemente bisher per Drag-and-drop nur im Formular selbst geändert werden.

Mit dem aktuellen Release kann die Reihenfolge jetzt auch per Drag-and-drop direkt in der Vorschau geändert werden:

Mit dem aktuellen Release wurden einige, kleinere Optimierungen hinsichtlich Design und Benutzerführung (UI und UX) im FirstSpirit ContentCreator vorgenommen:

• Nach dem Anlegen eines neuen Mediums oder Datensatzes wird dieses jetzt entsprechend selektiert und kann so besser wiedergefunden werden.
• Beim Speichern von Änderungen an Medien-Elementen zeigt jetzt ein Indikator den Lade-Prozess an.
• Die Standardgröße von Formularen wurde marginal vergrößert.
• Die Skalierung der Schriftgröße wirkt sich jetzt auch auf den Rich-Text-Editor aus.
• Die Darstellung von Thumbnails in den Reports ist durch einen zusätzlichen Abstand verbessert worden.
• Beim Löschen von Einträgen einer FS_CATALOG-Komponente in der Vorschau wird jetzt eine Sicherheitsabfrage angezeigt („Möchten Sie das Element ... wirklich löschen?“).
• Die Anzeige von Aufgaben stellt jetzt auch Kommentare seit der letzten nicht-automatischen Transition dar.
• Einträge des Element-Status werden jetzt mit !-Icon visualisiert (statt zuvor mit Bearbeiten-Icon), wenn sie Validierungsprobleme aufweisen:

Folgende Modul-Versionen für „FirstSpirit Content Experience Tools“ werden von FirstSpirit 2022.4 unterstützt.

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

Das Registrieren von MicroApps kann speziell im Fall des Neustarts eines FirstSpirit-Servers bzw. des Tomcat Webservers einige Zeit in Anspruch nehmen.
Bisher kam es beim Starten des FragmentCreator nach einem Timeout von 5 Minuten zur Fehlermeldung

x MicroApps could not be registered in a reasonable amount of time.

wenn sich die vorhandenen MicroApps nicht innerhalb dieser Zeit registrieren konnten, und der FragmentCreator wurde nicht gestartet.

Mit dem aktuellen Release wurde der Standardwert für den Timeout auf 10 Min. erhöht.
Bei Bedarf können Sie ihn an die Anforderungen Ihrer Installation jetzt auch individuell anpassen, und zwar über den neuen Parameter

cxt.fragmentcreator.microAppRegistration.timeoutInMinutes

in der Properties-Datei cxt-fragment-creator.properties.

Ausschnitt aus der Properties-Datei:

<context-param>
   		<param-name>cxt.fragmentcreator.microAppRegistration.timeoutInMinutes</param-name>
   		<param-value>10</param-value>
	</context-param>

Zu weiteren Informationen zu cxt-fragment-creator.properties siehe https://docs.e-spirit.com/odfs/edocs/cxt/installation-mo/module-installi/fragmentcreator/index.html#web_xml.

Bilder werden beim Upload nach FirstSpirit zunächst unverändert hinsichtlich Format und Auflösung im Projekt abgelegt (Auflösung „Original“). Bei bestimmten Aktionen werden (basierend auf den ursprünglichen Bilddaten) jedoch automatisch neue Bilddateien von FirstSpirit erzeugt, beispielsweise:

• beim Erzeugen eines Vorschaubilds
• beim Erzeugen neuer Auflösungen
• bei der Verwendung einer automatisch generierten Auflösung
• bei einem Bildzuschnitt (im FirstSpirit ContentCreator oder SiteArchitect)

ImageWriteParams

beeinflusst werden (FirstSpirit Access-API, Package de.espirit.firstspirit.access.project, Interface Project, Methode setCustomProperties). Beispielsweise kann die Kompressionsrate von Bildern konfiguriert werden, um bei der Erzeugung eine bessere Bildqualität oder eine geringere Dateigröße zu erreichen.

Mit dem aktuellen Release ist es jetzt zusätzlich möglich, das Bild-Format von automatisch erzeugten Bilder vorzugeben (targetType).

Beispielskript, mit dem alle automatisch erzeugten Bilddateien im Format WebP erzeugt werden:

project = context.getProject();
project.lock();
properties = new java.util.LinkedHashMap();
properties.put("default.targetType", "webp");
project.setCustomProperties("ImageWriteParam", properties);
project.save();
project.unlock(); 

Dieses Skript muss einmalig mit Administrator-Rechten in dem Projekt ausgeführt werden.

Die Änderung betrifft alle Bilder, die nach dem Ausführen des Skripts automatisch erzeugt werden.
Für eine Anleitung, wie Sie bereits berechnete Auflösungen aus dem Projekt entfernen können, kontaktieren Sie bitte den e-Spirit Technical Support.

Wichtig: ImageWriteParams, die für das betreffende Projekt bereits konfiguriert sind, müssen ebenfalls mit in das Skript aufgenommen werden, da sie ansonsten überschrieben werden.
Ob und welche Parameter bereits konfiguriert sind, ermitteln Sie mittels

context.project.getCustomProperties("ImageWriteParam");

Sie können darüber hinaus entsprechende Definitionen für einzelne Bildformate und/oder Auflösungen definieren.
Dabei wird die Einstellung für den aktuellen bestimmten Bildtypen verwendet. Wenn nicht vorhanden, wird die für die Auflösung und als Fallback die globale Einstellung verwendet.

Beispielskript, das bei PNG-Bildern den Typ beibehält, für die Auflösung „Icon“ den Typ JPG verwendet und für alle anderen skalierten Bilder den Typ WebP anwendet:

project = context.getProject();
project.lock();
properties = new java.util.LinkedHashMap();
properties.put("default.targetType", "webp");
properties.put("default.png.targetType", "png");
properties.put("resolution.Icon.targetType", "jpg");
project.setCustomProperties("ImageWriteParam", properties);
project.save();
project.unlock(); 

Sollen Bilder, die durch die font(...)-Funktion erzeugt werden, im Format WebP auszugeben, muss als filetyp webp übergeben werden.

Zu weiteren Informationen siehe:

• ImageWriteParam: https://docs.e-spirit.com/odfs/vorlagenentwick/vorlagensyntax/funktionen/anweisungen/ref/index.html#hinweis_zu_automatisch_erzeugten_bilddateien
• font(...)-Funktion: https://docs.e-spirit.com/odfs/vorlagenentwick/vorlagensyntax/funktionen/anweisungen/font/index.html#filetype