Release Notes

Ist ein Medium sprachabhängig angelegt, sollten Bilddateien bzw. Dateien anderer Medinformate für jede vorhandene Sprache hinterlegt werden. Standardmäßig wird das Medium sonst nicht ausgegeben und / oder das Medium verlinkt auf eine nicht-vorhandene URL.

Mit dem aktuellen Release kann jetzt definiert werden, dass für die Sprache, für die keine Datei hinterlegt ist, die Datei der Mastersprache verwendet wird.
Dazu die Option „Mastersprache verwenden“ auswählen (FirstSpirit ServerManager / Projekteigenschaften / Ersetzungen, „Sprachersatz (Medien“)):

Ist die Option „Ignorieren“ gewählt (dies ist die Standardeinstellung), wird in der Sprache des Mediums, für die keine Datei hinterlegt ist, nichts angezeigt.

Hinweis: In folgenden Fällen wird weiterhin kein Medium angezeigt:

• Für ein sprachabhängiges Medium ist in der Mastersprache keine Datei hinterlegt.
• Für ein sprachunabhängiges Medium ist keine Datei hinterlegt.
• Für ein sprachabhängiges Medium ist in einer Sprache ungleich der Mastersprache keine Datei hinterlegt, und bei „Sprachersatz (Medien)“ ist die Option „Mastersprache verwenden“ nicht aktiviert.

Für diese Fälle wird eine entsprechende Lösung mit einem der folgenden FirstSpirit-Releases bereitgestellt.

Im Kontext dieser neuen Funktionalität wurde auch die FirstSpirit Access-API erweitert, um auf diese Projekteinstellung reagieren zu können: Package de.espirit.firstspirit.access.project, Interface Project.

Im „Health Center“ (FirstSpirit ServerMonitoring) kann der aktuelle Gesundheitszustand des FirstSpirit Servers abgelesen werden. Der Zustand degraded (Symbol: Ausrufungszeichen auf rotem Hintergrund) kann beispielsweise darauf hindeuten, dass es Probleme hinsichtlich des zur Verfügung stehenden Speicherplatzes oder eine zu hohe Last auf dem Server gibt.
Aber auch, wenn die Web-Applikationen, die standardmäßig von FirstSpirit mitgeliefert werden, beim FirstSpirit-Start nicht korrekt ausgerollt („deployed“) wurden, führt dies zum Zustand degraded.
Detailliertere Informationen liefert die Datei server-incidents.log (herunterladbar im FirstSpirit ServerMonitoring unter „FirstSpirit / Monitoring / Kennzahlen“ über das Umschlag-Icon; Meldung „Server status is degraded!“). Hier können Ursachen abgelesen werden, die zu dem problematischen Zustand führen bzw. geführt haben.
Befindet sich der Server im Status degraded, sollten geeignete Maßnahmen ergriffen werden, die die Probleme beheben.

Ein FirstSpirit Server wird jetzt auch als degraded angesehen, wenn ein aggregierender Webserver verwendet wird und eine Web-Applikation nicht auf allen Webservern des aggregierenden Webservers erfolgreich ausgerollt werden kann.
Meldung in der Datei server-incidents.log:

Web server errors detected: #

wobei # die Anzahl der entsprechenden Warnungen ist.

Die Meldung

Some core web applications are not running: ...

besagt, dass mindestens eine Web-Applikation nicht korrekt ausgerollt werden konnte, und welche.

In seltenen Fällen wurde keine explizite Fehlermeldung ausgegeben, wenn eine Web-Applikation oder eine Web-Komponente nicht auf einem Webserver ausgerollt werden konnte. Dieser Fehler wurde jetzt ebenfalls behoben.

Darüber hinaus wurde das MBean HealthManager um zwei weitere Informationen erweitert:

• LastWebServerError
• WebServerErrorsPerDay

Meldungen zum Health-Status sind jetzt auch in der Datei fs-server.log enthalten. Sie werden über die Klasse de.espirit.firstspirit.server.HealthStatus ausgegeben. So können entsprechende Meldungen auch nachträglich aufgefunden werden. Beispiel:

INFO  19.01.2022 14:14:47.570 (de.espirit.firstspirit.server.HealthStatus): 
   RUN_LEVEL (de.espirit.firstspirit.server.RunLevelHolder) Reached run level:
   STARTED(100)

Hinweis: In einigen Fällen werden Meldungen jetzt zweimal ausgegeben.

Im Kontext des Health-Status wurden zudem einige Schwellenwerte, ab denen ein unter hoher Last stehender FirstSpirit Server als degraded angesehen wird, aufgrund bisher gewonnener Erfahrungen, erhöht.

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

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

Die Methode ModuleAdminAgent.getProjectAppConfig() (FirstSpirit Developer-API, Package de.espirit.firstspirit.agency) gibt – wie in der API-Dokumentation beschrieben – bereits seit FirstSpirit 2022.1 eine IllegalArgumentException zurück, wenn die Projekt-Komponente nicht im betreffenden Projekt hinzugefügt / installiert ist.
Zuvor wurde eine leere Konfiguration angelegt und zurückgegeben.

Hinweis: Dies gilt nur für Server, die im „Isolated Mode“ betrieben werden. Für Server, die noch im abgekündigten „Legacy Mode“ betrieben werden, wurde seit jeher die IllegalArgumentException zurückgegeben.

FirstSpirit-Eingabekomponenten lassen sich durch Projektentwickler äußerst flexibel und feingranular an die Anforderungen des jeweiligen Projekts und der Redakteure anpassen.
Die Eingabekomponente FS_CATALOG ermöglicht beispielsweise die komfortable Erstellung von Listen, die aus Absätzen oder Verweisen bestehen können.
Zentrale Funktion dabei ist das Anlegen von neuen Einträgen.
Diese Funktion kann durch eine spezifische Regel-Definition kontrolliert werden, und zwar über die Eigenschaft NEW.
An dieser Eigenschaft hing bisher auch die Funktionalität „Duplizieren“, die im FirstSpirit ContentCreator im Formular per Icon ausgeführt werden kann:

im FirstSpirit SiteArchitect per Kontextmenü:

Bisher konnten die Funktionen „Neu“ und „Duplizieren“ nur zusammen aktiviert und deaktiviert werden.
Mit dem aktuellen Release können die Funktionen „Neu“ und „Duplizieren“ jetzt getrennt voneinander gesteuert werden, und zwar über die neue Eigenschaft COPY:

PROPERTY name="COPY"

Aus Kompatibilitätsgründen wird für COPY der Status von NEW berücksichtigt, sofern keine explizite Definition für COPY erfolgt.
Um „Duplizieren“ zu ermöglichen, „Neu“ aber nicht, muss COPY explizit aktiviert werden, NEW deaktiviert, z. B.:

<RULES>
<RULE>
<WITH>
<TRUE/>
</WITH>
<DO>
<PROPERTY name="COPY" source="catalog"/>
<NOT>
<PROPERTY name="NEW" source="catalog"/>
</NOT>
</DO>
</RULE>
</RULES>

Hinweis: Die Icons in der Vorschau (EasyEdit-Icons) können durch Regeln nicht beeinflusst werden. Um das Duplizieren in der Vorschau generell zu unterbinden, kann dafür die Tailored-UI-Funktionalität genutzt werden.

Zu weiteren Informationen siehe:

• FS_CATALOG: https://docs.e-spirit.com/odfs/vorlagenentwick/formulare/eingabekomponen/catalog/index.html
• Eigenschaft COPY: https://docs.e-spirit.com/odfs/vorlagenentwick/regeln/formulareigensc/eigenschaft-cop/index.html
• Tailored UI: https://docs.e-spirit.com/odfs/vorlagenentwick/contentcreator/customization/standardfunktio/index.html

Nicht auflösbare Referenzen bei der JSON-Generierung führen jetzt zu Log-Meldungen des Levels WARN.

Dies ist beispielsweise der Fall, wenn ein verlinktes Medium nicht im Freigabestand erreichbar ist, weil es niemals freigegeben wurde, oder sich ein niemals freigegebener Ordner in der Vaterkette des Mediums befindet.

Beispiel:

WARN  24.01.2022 14:26:24.248{g-node=850537} (de.espirit.firstspirit.generate.
   SiteProduction): Reference 'xyz' [type=MEDIASTORE_LEAF] is set but not accessible! 
   It may have been deleted or is not correctly released.