Release Notes
1 Administration
1.1 ContentCreator-Logging konfigurieren
Im Rahmen eines Refactorings und einer grundlegenden Überarbeitung der technischen Basis nutzt der FirstSpirit ContentCreator seit einiger Zeit das Open Source Framework „Spring Boot“. Standardmäßig verwendet es das Logging-Framework „Logback“. Es ist im Vergleich zum Logging-Framework „Log4j“ schneller und bietet mehr Optionen für die Konfiguration.
Analog zur CXT-Plattform und zum FragmentCreator wird jetzt eine optionale Datei
~/config/cxt-cc.propertiesim Classpath unterstützt.
Innerhalb dieser Datei kann das Logging konfiguriert werden.
Standardmäßig loggt der ContentCreator in die Konsole.
Um auch Logging in eine Datei zu aktivieren, muss in der Properties-Datei der Parameter
logging.file.nameangegeben werden. Über diesen Parameter muss der Pfad und Name einer Datei definiert werden, in die das Logging erfolgen soll, z. B.
logging.file.name=/home/tomcat/logs/firstspirit-cc.log Das Standard-Log-Level ist INFO, das bedeutet, dass Fehler der Kategorien ERROR, WARN und INFO festgehalten werden.
Bei den zur Verfügung stehenden Properties (inkl. logging.file.name) handelt es sich um die entsprechenden Standard-Spring-Boot-Properties. Die Logging-Konfiguration kann bei Bedarf weiter angepasst werden: https://docs.spring.io/spring-boot/docs/2.4.2/reference/html/appendix-application-properties.html#common-application-properties-core.
Standardmäßig wird keine Log-Datei erzeugt.
Wurde bisher „Log4j“ für das Logging des ContentCreator verwendet, muss das Logging nun auf die hier beschriebene Weise konfiguriert werden.
Hinweis: Die Konfiguration über ~/config/cxt-cc.properties gilt für alle ContentCreator-Instanzen, sowohl für den globalen ContentCreator als auch für evtl. konfigurierte „projektlokale“ ContentCreator-Instanzen (= auf dem Register „ContentCreator“ unter „Projekt-Eigenschaften / Web-Komponenten“ ist ein Webserver konfiguriert).
1.2 Konvertierungsregeln: Upload jetzt auch in Nicht-Hexadezimalschreibweise
Konvertierungsregeln dienen in FirstSpirit dazu, eingegebene Zeichen zu konvertieren.
Um eine kundenspezifische Konvertierungsregel verwenden zu können, muss zuvor eine entsprechende Textdatei erstellt worden sein. Über den FirstSpirit ServerManager kann sie dann über „Server-Eigenschaften / Konvertierungs-Regeln“ auf den Server hochgeladen werden (Button „Hinzufügen“).
Dabei kann jetzt das in diesem Anwendungsfall zu ersetzende Zeichen direkt per Tastatur eingegeben werden, z. B.
ä = "ae"Zuvor musste der hexadezimale Unicode-Wert eingegeben werden.
Bei Verwendung von Nicht-hexadezimal-Schreibweise kam es zu einer Fehlermeldung wie: ERROR 03.08.2021 09:17:11.228 (de.espirit.firstspirit.admin.gui.ConversionTablePanel): Error creating conversion table ... de.espirit.firstspirit.access.AccessRuntimeException: Error parsing line 2...
Zu weiteren Informationen siehe https://docs.e-spirit.com/odfs/edocs/admi/firstspirit-ser/server-eigensch/konvertierungs/index.html.
1.3 MBeans und ServerMonitoring: Neue Infos zum Health-Status und zur aktuellen Lastsituation des Servers
FirstSpirit bietet mit dem „ServerMonitoring“ und der JMX-Konsole Möglichkeiten, den FirstSpirit-Server zur Laufzeit zu überwachen und zu verwalten, beispielsweise hinsichtlich Speicherverbrauch und Last.
Für die JMX-Konsole werden alle Werte und Operationen über so genannte Managed Beans („MBeans“) zur Verfügung gestellt.
Mit dem aktuellen Release sind neue MBeans-Informationen hinsichtlich des Health-Status und der aktuellen Lastsituation des Servers verfügbar:
HealthManager- Runlevel des Servers
- letzte Logmeldung vom Level
FATAL - Anzahl an Loggings vom Level
FATALpro Tag - letzte „Out-of-memory“-Logmeldung
- Anzahl der offenen Verbindungen
- ...
ScheduleManager- Anzahl der aktuell laufenden Aufträge / nach Typ
- Anzahl der aktuell laufenden Tasks
- ...
RepositoryManager- Anzahl der aktuell offenen Repositories
- Anzahl der aktuellen Schreiboperationen in allen Repositories
- Schreiboperationen pro Minute
- Erzeugte Revisionen pro Minute
- ...
MediaManager- Anzahl der hochgeladenen Medien, skalierten Medien und Vorschauberechnung
- Anzahl der aktuell hochgeladenen und skalierten Medien sowie Vorschauberechnungen / nach Typ
- Operationen hinsichtlich Upload, Skalierung und Vorschauberechnung pro Minute
- ...
Über die JMX-Konsole kann jetzt außerdem die Historie einiger Werte als Datei im CSV-Format downgeloaded werden. (Standardmäßig der letzten 14 Tage, soweit kein anderer Wert angegeben wird.)
Darüber hinaus wurde das „ServerMonitoring“ um neue Statistik-Werte erweitert, unter „FirstSpirit / Monitoring / Kennzahlen“:

Dort können einige der Werte jetzt auch als CSV-Datei heruntergeladen oder als Mail-Anhang versendet werden. Icon:
Daten zu Aufträgen können ebenfalls im ServerMonitoring unter „Übersicht / Aktivitäten“ heruntergeladen/versendet werden.
Verfügbar sind standardmäßig die Daten der letzten 21 Tage bzw. seit dem letzten Server-Neustart.
Zu weiteren Informationen siehe
1.4 Neue Konfigurationsdatei für Server-Einstellungen: "fs-server-aux.conf"
Die Datei fs-server.conf ermöglicht eine Anpassung des FirstSpirit-Servers an kundenspezifische Anforderungen. Die Konfiguration erfolgt über Parameter, die in der „Dokumentation für Administratoren“ beschrieben werden.
Mit dem aktuellen Release gibt es eine weitere Konfigurationsmöglichkeit für den Server: die Konfigurationsdatei
fs-server-aux.confMit dieser kann die Konfiguration, die per Datei fs-server.conf vorgenommen wurde, überschrieben werden.
Parameter für die Server-Konfiguration werden jetzt in folgender Reihenfolge ausgewertet (soweit verwendet):
-D-Java-Properties- Umgebungsvariablen des Betriebssystems
fs-server-aux.conffs-server.conf- Standardwerte
Die Verwendung der Datei fs-server-aux.conf ist für Szenarien gedacht, in denen die Datei fs-server.conf automatisiert erzeugt wird. Manuelle Anpassungen in dieser Datei werden durch automatische Updates überschrieben bzw. entfernt. Die Datei fs-server-aux.conf hingegen wird nicht überschrieben bzw. verändert.
Die Datei kann im FirstSpirit ServerMonitoring unter „FirstSpirit – Konfiguration – Server“ erstellt und bearbeitet werden:

Die Datei wird dann im Verzeichnis ~fs5\conf abgelegt.
Ist die Datei vorhanden und enthält sie Parameter, wird sie bei Serverstart ausgelesen. Folgende Meldung ist dazu in der Log-Datei fs-server.log zu finden:
INFO 01.09.2021 12:18:23.348 (de.espirit.firstspirit.server.ServerManagerImpl):
Loaded auxiliary ini file '~/firstspirit/conf/fs-server-aux.conf'Hinweis: Nicht alle Parameter sind für eine Verwendung in der Datei fs-server-aux.conf (z. B. services) geeignet.
Eine Dokumentation der nicht geeigneten Parameter wird mit einem der kommenden Releases erfolgen.
1.5 Projekt löschen inklusive Datenbanken
Beim Löschen eines Projektes (über den FirstSpirit ServerManager / Projekt / Löschen) werden jetzt auch die Datenbanken, die von dem Projekt verwaltet werden, mit gelöscht. Auf diese Weise kann u.a. nicht mehr benötigter Speicherplatz einfach freigegeben und die Datenbank- und Projekt-Verwaltung erleichtert werden.
Es werden generell nur Datenbanken gelöscht, wenn für die Datenbank ein Schema existiert und für den Layer keine der Optionen „Schreibgeschützt“ und „Kein Schema Sync“ aktiviert ist (im FirstSpirit ServerManager / Projekteigenschaften / Datenbanken).
Sollen entsprechende Datenbanken nicht gelöscht werden, kann dies durch Deaktivieren der Checkbox „Verbundene Datenquellen leeren“ erreicht werden:

2 ContentCreator
2.1 Beta-Phase: Datenquellen-Verwaltung im ContentCreator
Die Funktionatlität der „Datenquellen-Verwaltung“ im FirstSpirit ContentCreator befindet sich weiterhin in der Beta-Phase.
Bei Interesse wird empfohlen, sie zunächst in einer Entwicklungsumgebung zu testen.
Potenziell auftretende Probleme sollten zeitnah an e-Spirit gemeldet werden.
Zu weiteren Informationen siehe Release Notes zu FirstSpirit 2021-08 (https://docs.e-spirit.com/odfs/releasenotes/2021-08/FirstSpirit_Releasenotes_DE.pdf).
2.2 Bevorzugte Anzeigesprache
Beschriftungen von Eingabeelementen und Tooltips in Formularen werden standardmäßig in der Sprache angezeigt, die aktuell bearbeitet wird.
In der FirstSpirit-Welt wird diese Sprache auch als „Anzeigesprache“ (oder „Redaktionssprache“) bezeichnet. Welche Beschriftung dabei in welcher Sprache verwendet wird, wird vom Projektentwickler definiert.

Um die Anzeigesprache wechseln zu können, musste bisher erst die Sprache der Vorschau bzw. die Client-Sprache (über die FirstSpirit Startseite) gewechselt werden. Der Wechsel der Sprache im Formular betrifft nur die Sprache der Inhalte.
Mit dem aktuellen Release kann konfiguriert werden, welche Sprache als Anzeigesprache verwendet werden soll:

(Menü „Weitere Funktionen“ / „Bevorzugte Anzeigesprache“)
In dem Menü werden alle im ServerManager als „Redaktionssprachen“ definierten Sprachen zur Auswahl angeboten.
Sprachwahl:
- Es kann entweder eine bevorzugte Anzeigesprache ausgewählt werden, in der Inhalte angezeigt werden, oder
- Automatisch: Die Anzeigesprache wird, wie bisher, auf Basis der auf der FirstSpirit Startseite gewählten Sprache ermittelt.
Diese Sprachwahl wirkt sich generell auf die Inhalte der Medien-Verwaltung (sowie der noch nicht freigegebenen Datenquellen-Verwaltung) aus.
Wird die Sprache gewechselt (inkl. „Automatisch“), wird ein Dialog mit einer entsprechenden Information angezeigt. Der Button „Browser neu laden“ stößt den Reload des Browserinhalts an.
Immer in Formularen verwenden: Durch Aktivierung dieser Option wird die in diesem Untermenü gewählte Anzeigesprache auch für die Beschriftung in Formularen verwendet.
In der Navigationsleiste und den Reports richtet sich die Sprache weiterhin nach der gewählten Vorschausprache.
Die im Untermenü „Bevorzugte Anzeigesprache“ vorgenommenen Einstellungen werden für den jeweiligen User projektweit gespeichert.
Zu weiteren Informationen siehe:
- Sprachen im ContentCreator: https://docs.e-spirit.com/contentcreator/einleitung/mehrsprachigkei/index.html
- Menü „Weitere Funktionen“: https://docs.e-spirit.com/contentcreator/menuefunktionen/weitere-funktio/index.html
2.3 Bildzuschnitt direkt in FS_REFERENCE
Das Eingabeelement FS_REFERENCE dient der Aufnahme einer beliebigen Referenz. Damit kann es beispielsweise eingesetzt werden, um Verweise auf andere Seiten oder Bilder auf der Webseite darstellen zu können.
Mit dem aktuellen Release können User jetzt im FirstSpirit ContentCreator direkt aus einem FS_REFERENCE-Eingabeelement heraus das verwendete Bild komfortabel zuschneiden. Der User muss dazu nun nicht mehr zuvor in die Medien-Verwaltung wechseln.
Das entsprechende Icon wird nur dann angezeigt, wenn ein Bild ausgewählt wurde.

Die Funktion steht selbstverständlich nur für Bilder zur Verfügung, nicht für andere Objekttypen.
2.4 Navigationsleiste: Neue Funktionen
Die Navigationsleiste, die an der linken Bildschirmseite geöffnet werden kann, bildet die Struktur der Website (Register „Navigation“) bzw. der aktuell gewählten Seite (Register „Seite“) hierarchisch und übersichtlich in einer Baumstruktur ab.
Mit dem aktuellen Release finden Sie dort neue Funktionen:
Umbenennen von Absätzen
Mithilfe des Menüeintrags „Umbenennen“ auf Absätzen (Register „Seite“) kann jetzt der (Anzeige)Name eines Absatzes geändert werden.
Hinweis: Um eine Seite umzubennen, steht die Funktion „Umbenennen“ auf dem Register „Navigation“ zur Verfügung.

Arbeitsabläufe auf Elementen ausführen
Erst, wenn sich ein Element im Zustand „Freigegeben“ befindet, werden Änderungen, die zuletzt an dem Element vorgenommen wurden, zumeist auch bei der nächsten Veröffentlichung der Seite sichtbar. Ist eine Seite nicht freigegeben, werden die zuletzt vorgenommenen Änderungen auch bei einer Veröffentlichung nicht sichtbar.
Um Elemente freizugeben, ist ein Arbeitsablauf notwendig. Das Starten und Weiterschalten von Arbeitsabläufen war bislang im Report-Bereich bzw. über den Element-Status möglich.
Jetzt stehen Arbeitsabläufe auch auf den Elementen der Baumstruktur in der Navigationsleiste zur Verfügung, und zwar auf dem Register „Navigation“:
.png)
In dem Untermenü werden unterhalb des Status des Elements die zur Verfügung stehenden Arbeitsabläufe bzw. Arbeitsablaufschritte angezeigt. Mit einem Klick kann der gewünschte Arbeitsablauf bzw. Arbeitsablaufschritt ausgewählt werden.
Die Fehlermeldung
Das Objekt ist im Arbeitsablauf als „Nur Lesen“ markiert.weist dabei darauf hin, dass ein übergeordnetes Element durch einen Arbeitsablauf aktuell schreibgeschützt ist. Das Element kann dann erst im Arbeitsablauf weitergeschaltet werden, wenn das übergeordnete Element weitergeschaltet wird.
Hinweis: Der Arbeitsablauf-Status und die zur Verfügung stehenden Arbeitsabläufe eines Elements hängen unter Umständen von dem gewählten „Element Status Provider“ ab. Ist der „Page based“ Provider gewählt, wird im Arbeitsablauf-Dialog beispielsweise die entsprechende Seite der Inhalt-Verwaltung visualisiert.
3 Externe Synchronisierung / Content Transport
Transport von Datenbank-Schemata und -Inhalten zwischen Projekten mit unterschiedlichen Sprachmengen
Über die Funktionalitäten FirstSpirit „External Synchronization“ und FirstSpirit „Content Transport“ können Projektinhalte und Eigenschaften eines FirstSpirit-Projekts (Quellprojekt) exportiert und in weitere FirstSpirit-Projekte (Zielprojekte) importiert werden.
Das Verhalten speziell beim Transport von Datenbank-Inhalten bei unterschiedlichen Sprachmengen in Ziel- und Quellprojekt wurde jetzt verbessert:
Beim Transport von Datenbankschemata
werden jetzt beim Import für Sprachen, die nur im Zielprojekt vorhanden sind, die entsprechenden, sprachabhängigen Spalten in den Tabellen-Vorlagen entsprechend zugeordnet („Mapping“) und im Schema angelegt.
Im Export enthaltene, sprachabhängige Spalten aus Sprachen, die im Zielprojekt nicht vorhanden sind, werden ebenfalls im Schema angelegt bzw. dort nicht modifiziert.
Struktur und Inhalte von externen Datenbanken dürfen nicht verändert werden: Daher findet im Falle von externen Datenbanken kein Mapping statt.
Wichtig: Potenziell vorhandene Projektlösungen, die die Funktionalität dieses Features imitieren, müssen gegebenenfalls angepasst oder entfernt werden. Ansonsten kann es zu unerwartetem Verhalten kommen (z. B. Datenverlust oder fehlschlagende Skripte).
Die Funktionalität nutzt das FirstSpirit-Namensschema für sprachabhängige Spalten als Basis (also „Spalte_DE“, „Spalte_EN“, „Spalte_FR“ usw.). Bei Projekten, die nicht dieses Schema verwenden, kann dies potenziell zu unerwartetem Verhalten führen.
Beim Transport von Datensätzen
bleiben jetzt sprachabhängige Inhalte, die im Zielprojekt in Sprachen gepflegt wurden, im Quellprojekt aber nicht vorhanden sind, erhalten.
Die Inhalte von Sprachen, die im Quell- und Zielprojekt vorhanden sind, werden hingegen grundsätzlich mit den Inhalten aus dem Quellprojekt überschrieben.
Wichtig: Dies gilt für Eingabekomponenten, die sprachabhängig sind und auf eigene Spalten gemappt sind.
Im Falle von sprachunabhängigen Eingabekomponenten, für die innere sprachabhängige Formulare konfiguriert sind, wird der Inhalt des Quellprojekts übernommen. Inhalte, die in Sprachen gepflegt sind, die nur im Zielprojekt existieren, gehen in diesem Fall bei einem Transport weiterhin verloren.
Dies ist speziell der Fall bei der Eingabekomponente FS_CATALOG: Bei Konfiguration mit uselanguages="no" und <TEMPLATES type="section"> werden sprachabhängige Inhalte in den Eingabekomponenten der inneren Absätze bei einem Transport mit den Daten aus dem Quellprojekt aktualisiert.
Aktivierung
Um die Funktionalität nutzen zu können, muss sie zunächst aktiviert werden. Und zwar im FirstSpirit ServerManager unter „Projekteigenschaften – Kompatibilität“:

Einstellung „ExternalSync/ContentTransport: Mapping basierten Schema Import nutzen“
Der aktuelle Status kann links im Text abgelesen werden.
- Aktiviert: (empfohlen) Ist diese Option aktiviert, werden beim Import eines Datenbank-Schemas im Ziel fehlende, sprachabhängige Datenbankspalten ergänzt und sprachabhängige, nur im Ziel vorhandene Spalteninhalte, werden nicht überschrieben.
- Deaktiviert: (nicht empfohlen) Dies ist die Standardeinstellung. Ist diese Option aktiviert, werden beim Import eines Datenbank-Schemas im Ziel fehlende, sprachabhängige Datenbankspalten nicht ergänzt und sprachabhängige, nur im Ziel vorhandene Spalteninhalte, werden überschrieben.
Eine Umstellung ist per Klick auf den Button möglich („Deaktivieren“ bzw. „Aktivieren“) und muss per Sicherheitsabfrage bestätigt werden.
Das neue Verhalten stellt zwar eine Verbesserung dar, allerdings handelt es sich gleichzeitig um eine wesentliche Änderung im Software-Verhalten, im Vergleich zu vorherigen Releases. Ein Wechsel bzw. die Aktivierung sollte zuvor möglichst auf einem Testsystem ausgeführt und erprobt werden. Potenziell vorhandene Projektlösungen, die die Funktionalität dieses Features imitieren, müssen gegebenenfalls angepasst oder entfernt werden.4 FirstSpirit Content Experience Tools (CXT)
Aktuelle Modul-Versionen
Folgende Modul-Versionen für „FirstSpirit Content Experience Tools“ werden von FirstSpirit 2021-09 unterstützt.
| Modul- / Dateiname | Versionsnummer |
FirstSpirit CXT Plattformplatform-[version].fsm | 2.4.1 |
FirstSpirit CXT DAP Bridgedataservice-[version].fsm | 1.44.0 |
FirstSpirit CXT FragmentCreatorfragment-creator-[version].fsm | 3.4.1 |
FirstSpirit Fragment DAPfragmentdap-[version].fsm | 1.40.1 |
FirstSpirit Media DAPmediadap-[version].fsm | 1.31.0* |
FirstSpirit PageRef DAPpageref-[version].fsm | 1.9.0 |
FirstSpirit Markdown Editormarkdown-editor-[version].fsm | 1.29.0* |
FirstSpirit Tagging Editortagging-editor-[version].fsm | 1.29.0 |
FirstSpirit CXT FragmentCreator - CaaS Integrationcaas-integration-[version].fsm | 1.31.0 |
* Diese Module benötigen ab dieser Version FirstSpirit 2020-03 oder höher.
5 Kompatibilität
5.1 Ankündigung: Endgültiger Entfall von abgekündigten Komponenten
Wie auch der FirstSpirit-Kern wird die Verwendung von Fremdkomponenten einer intensiven Qualitätssicherung unterzogen. Eine Fülle an unterstützten Betriebssystemen, Java-Versionen, Schnittstellen zu Fremdsystemen sowie deren Kombinations- und Konfigurationsmöglichkeiten führt zu einer extrem hohen Testkomplexität. Um auf Dauer eine gute Wartbarkeit und Nachhaltigkeit bei der Weiterentwicklung von FirstSpirit gewährleisten zu können, wird der Support von nicht mehr unterstützten und / oder verwendeten Komponenten in regelmäßigen Abständen abgekündigt. Während einer Übergangszeit haben Kunden und Partner ausreichend Zeit, den Betrieb – auch mit Unterstützung durch den e-Spirit Technical Support – auf alternative Lösungen umzustellen. In einem finalen Schritt wird dann softwareseitig der Code für die nicht mehr unterstützten Komponenten entfernt.
Für einige Komponenten, die bereits seit längerer Zeit e-Spirit-seitig abgekündigt sind und nicht mehr unterstützt werden, wird dieser letzte Schritt in den nächsten FirstSpirit Releases vorgenommen.
Eine Migration betrifft nur On-Premises-Kunden und sollte bereits vollzogen sein. Entsprechende Migrationspfade wurden bereits detailliert kommuniziert.
Java Web Start (Entfall mit FirstSpirit 2021-10)
Mit „Java Web Start“ können Java-Anwendungen aus dem Internet heruntergeladen und mit einem Klick ausgeführt werden. Es ist seit Version 5.0 in Java enthalten. Mit Version 11 ist Java Web Start jedoch entfallen.
Die Abkündigung des Supports von „Java Web Start“ für FirstSpirit erfolgte mit FirstSpirit 2019-10. Seit dem Entfall von Java 8 (FirstSpirit 2020-06) kann „Java Web Start“ nicht mehr genutzt werden.
Mit FirstSpirit 2021-10 wird Java Web Start nicht mehr in FirstSpirit enthalten sein.
Als Ersatz steht der FirstSpirit Launcher zur Verfügung.
Zu weiteren Informationen zum FirstSpirit Launcher siehe https://docs.e-spirit.com/odfs/edocs/admi/firstspirit-sta/bereiche-starts/firstspirit-lau/index.html.
Legacy mode für FirstSpirit Server und Modul-Entwicklung (Entfall mit FirstSpirit 2022-01)
Der „Isolated mode“ des FirstSpirit-Servers hat als wesentliches Ziel, dem Modulentwickler eine größere Freiheit bei der Auswahl der verwendeten Bibliotheken zu ermöglichen. Gerade die potenziellen Konflikte zu Bibliotheken, die vom FirstSpirit-Kern mitgeliefert werden, sollen dabei minimiert werden.
Im Februar 2019 (2019-02) wurde der „Isolated mode“ freigegeben. Seitdem ist der „Isolated mode“ Standard für neu installierte Server. Seit 2019-06 ist der „Legacy mode“ abgekündigt.
Ab FirstSpirit 2022-01 werden die Komponenten für den „Legacy mode“ nicht mehr in FirstSpirit enthalten sein.
Ein Indiz dafür, dass ein Server im „Isolated mode“ betrieben wird, ist die Verwendung der Datei fs-isolated-server.jar im Verzeichnis ~/server/lib-isolated (statt der Datei fs-server.jar im Verzeichnis ~/server/lib im „Legacy mode“).
Server und kundenspezifische Module, die noch nicht auf den „Isolated mode“ umgestellt sind, sollten entsprechend angepasst werden.
Benötigen Sie Unterstützung bei der Umstellung, wenden Sie sich bitte an den e-Spirit Technical Support.
Zur Umstellung von FirstSpirit Server und kundenspezifischen Modulen auf den „Isolated mode“ siehe auch https://docs.e-spirit.com/odfs/edocs/modd/index.html.
InternalJetty (Entfall mit FirstSpirit 2022-01)
(Webserver vom Typ Internal)
Die Funktionalität dieses integrierten Jetty Webserver wurde im Februar 2018 (5.2R18) abgekündigt und wird seit August 2018 (2018-08) nicht mehr unterstützt.
Ab FirstSpirit 2022-01 werden die Komponenten für den „InternalJetty“ nicht mehr in FirstSpirit enthalten sein.
Ist der „InternalJetty“ auf einem FirstSpirit-Server noch für eine oder mehrere Web-Anwendungen konfiguriert, wird FirstSpirit-Administratoren auf der Startseite des FirstSpirit-Servers ein entsprechender Hinweis angezeigt („Verwendung(en) des internen Jetty erkannt...“).
Als Ersatz wird die Verwendung eines externen Webservers (z. B. „Apache Tomcat“) empfohlen.
Zu weiteren Informationen siehe auch https://docs.e-spirit.com/odfs/edocs/admi/firstspirit-ser/server-eigensch/webserver/index.html.
5.2 Module und Erweiterungen für FirstSpirit 2021-09
Folgende Module und Erweiterungen sind kompatibel mit FirstSpirit 2021-09:
| Modul- / Dateiname | Versionsnummer | Kompatibel |
FirstSpirit Aktualisierungsarchivfs-update-[version].tar.gz | 2.1.0 | - |
FirstSpirit Installationsarchiv fs-install-[version].tar.gz | 2.1.0 | - |
FirstSpirit LauncherFSLauncher.exe | 1.0.41 | ab FirstSpirit 2018-08 |
FirstSpirit Launcher JRE Modulfs-launcher-jre-[version].fsm | 1.19 | ab FirstSpirit 2020-11 |
FirstSpirit SAML Login Modulfs-saml-login-[version].fsm | 1.3 | ab FirstSpirit 2019-02 |
FSDevToolsfs-cli-[version].tar.gzfs-cli-[version].zip | 3.0.2 | ab FirstSpirit 2021-07 |
FirstSpirit Module Gradle Pluginfirstspirit-module-gradle-plugin-[version].jar | 2.3.2 | ab FirstSpirit 2019-06 |
6 Modul-Entwicklung, Skripte, API
6.1 IDProviderEventAgent: Filtern von Events anhand der Revision
Mithilfe der neuen Methode getRevision(); kann beim Eventing (z. B. Änderung an Objekten) jetzt im Filter auch die Revision ermittelt werden (FirstSpirit Access-API, Package de.espirit.firstspirit.event, Interface EventInfo).
Anhand dieser kann entschieden werden, ob das Event herausgefiltert werden soll oder nicht.
Beispiel:
eventFilter = new Predicate<EventInfo>() {
boolean test(info) {
eventrevision = info.getRevision();
...
return ...
}
};6.2 Validierung für kundenspezifische Eingabekomponenten implementieren
Für die JavaScript-Implementierung eines WebPluginGadget wurde eine Möglichkeit geschaffen, Validierungsfehler melden zu können.
Der JavaScript-Controller könnte beispielhaft so aussehen:
// method to be implemented by the JavaScript controller
validateIntegrity: function(integrity) {
// add methods for each value state
integrity.addInfo('info message');
integrity.addWarning('warning message');
integrity.addError('error message');
}Siehe dazu auch
- JavaScript-Controller: https://docs.e-spirit.com/odfs/plug-developmen/universal-exten/input-component/contentcreator/javascript-cont/index.html
- Validierung / Regeln / Dynamische Formulare: https://docs.e-spirit.com/odfs/vorlagenentwick/regeln/index.html
7 Vorlagenentwicklung
JSON: Neue Formatversion
Mit dem aktuellen FirstSpirit-Release wird eine neue Version des JSON-Ausgabeformats veröffentlicht: 1.2.
Ab FirstSpirit 2021-09 wird diese neue Formatversion 1.2 standardmäßig eingesetzt, soweit über den Parameter formatVersion (Systemobjekt #global.json) keine andere Version definiert wird.
Bei der Verwendung von „CaaSConnect“ werden mit dieser Formatversion zukünftig (in einer folgenden Version) auch Informationen zu Listenelementen und Tabellenzellen aus CMS_INPUT_DOM und CMS_INPUT_DOMTABLE ausgegeben (Attribute listConfig und propertyConfig).
Diese Änderung hat keinen Einfluss auf die JSON-Ausgabe bei Verwendung eines Ausgabekanals.
Übersicht
| ID | Beschreibung | Kategorien |
|---|---|---|
| CORE-7379 | Konfiguration der bevorzugten Anzeigesprache |
ContentCreator, Redakteur, Sprachen |
| CORE-11755 | Bei Verwendung von macOS können mehrere einzelne Elemente jetzt mit der Command-Taste ausgewählt werden (FirstSpirit SiteArchitect, ServerManager, ContentCreator: z. B. Medien-Verwaltung). |
Entwickler, FirstSpirit-Administrator, Redakteur, ServerManager, SiteArchitect |
| CORE-11954 | Filtern von Events anhand der Revision. |
Entwickler, FirstSpirit-API |
| CORE-12099 | Das Layout des Dateiauswahldialogs im FirstSpirit SiteArchitect wurde angepasst, wodurch die Anzeige von Verzeichnissen, auf deren Inhalt der Benutzer teilweise keinen Zugriff hat, deutlich beschleunigt wird. |
Redakteur, SiteArchitect |
| CORE-12410 | Beim Löschen eines Projekts werden jetzt auch die Datenbanken mit gelöscht, die von dem Projekt verwaltet werden. |
Datenbank, FirstSpirit-Administrator, Performance, ServerManager |
| CORE-13031 | Neue Version des JSON-Ausgabeformats (1.2). |
Eingabekomponenten, Entwickler, JSON-Unterstützung |
| CORE-13305 | Beim Start des FirstSpirit SiteArchitect werden jetzt dmp-Dateien im Verzeichnis |
Performance, Redakteur, SiteArchitect |
| CORE-13555 | Die Abfrage der Verwendungen einer Remote-Referenz per API ( |
Entwickler, FirstSpirit-API |
| CORE-13698 | ContentCreator-Logging konfigurieren |
ContentCreator, Debugging, Entwickler, FirstSpirit-Administrator |
| CORE-13718 | Neue Infos zum Health-Status und zur aktuellen Lastsituation des Servers (MBeans und ServerMonitoring) |
Debugging, Server-Administrator, ServerMonitoring |
| CORE-13724 | Neue Konfigurationsdatei für Server-Einstellungen: „fs-server-aux.conf“ |
FirstSpirit-Administrator, ServerMonitoring |
| CORE-13758 | Konvertierungsregeln: Upload jetzt auch in Nicht-Hexadezimalschreibweise |
FirstSpirit-Administrator, Server-Administrator, ServerManager |
| CORE-13787 | Enthält eine Seite eine Absatzreferenz, wird beim Kopieren der Seite jetzt auch im FirstSpirit ContentCreator die Absatzreferenz beibehalten. Zuvor wurde eine Kopie des Absatzes erstellt, der Bezug zum Quellabsatz ging verloren. |
ContentCreator, Redakteur |
| CORE-13789 | Das Verhalten beim Transport von Datenbank-Inhalten per FirstSpirit „External Synchronization“ und FirstSpirit „Content Transport“ bei unterschiedlichen Sprachmengen in Ziel- und Quellprojekt wurde verbessert. |
Content Transport, Datenbank, Datenquellen-Verwaltung, Entwickler, Externe Synchronisierung, Sprachen, Tabellenvorlagen |
| CORE-13798 | Ankündigung: Endgültiger Entfall einiger abgekündigter Komponenten („Legacy mode“, „InternalJetty“, Unterstützung von „Java Web Start“) |
Entwickler, FirstSpirit-Administrator, Integrierte Software, Java, Modul-Entwicklung, Webserver, Webstart |
| CORE-13803 | Im Report „Dashboard“ des FirstSpirit ContentCreator konnte es dazu kommen, dass der Status des aktuellen Elements nicht aktualisiert wurde. |
Arbeitsablauf, ContentCreator, Redakteur |
| CORE-13817 | Es wurde ein Fehler behoben, der bei dem automatischen Start aller Services ( |
FirstSpirit-Administrator, Module |
| CORE-13863 | FirstSpirit Content Experience Tools: Aktuelle Modul-Versionen |
FirstSpirit-Administrator, Module |
| CORE-13869 | Diese Module und Erweiterungen sind kompatibel mit FirstSpirit 2021-09. |
Entwickler, FSDevTools, Launcher, Module |
| CXT-1232 | Validierung für kundenspezifische Eingabekomponenten implementieren |
ContentCreator, Dynamische Formulare, Eingabekomponenten, Entwickler, FirstSpirit-API |
| CXT-1664 | Die Navigationsleiste wurde um neue Funktionen erweitert (Absätze umbenennen, Freigabe von Elementen) |
ContentCreator, Freigabe, Navigationsansicht, Redakteur |
| CXT-1894 | Die Darstellung der Eingabekomponenten CMS_INPUT_TOGGLE, CMS_INPUT_RADIOBUTTON und CMS_INPUT_CHECKBOX im ContentCreator wurde insbesondere bei Verwendung von langen Beschriftungen (Attribut |
ContentCreator, Redakteur |
| CXT-2303 | FS_REFERENCE ermöglicht jetzt auch den (smarten) Bildzuschnitt. |
ContentCreator, Eingabekomponenten, Medien, Redakteur |
| CXT-2375 | In seltenen Fällen wurde im ContentCreator ein falsches Zeichenformat auf eine Markierung angewendet. Dieser Fehler wurde behoben. |
ContentCreator, Eingabekomponenten, Redakteur |
| CXT-2396 | Metadaten können jetzt im FirstSpirit ContentCreator wieder per InEdit bearbeitet werden (Fehlermeldung zuvor: „...500 The call failed on the server...“). |
ContentCreator, Metadaten, Redakteur |
| CXT-2408 | Es wurde ein Fehler beseitigt, der dazu führen konnte, dass in seltenen Fällen der im „Dashboard“ des ContentCreator angezeigte Status nicht dem Element-Status entsprach. |
Arbeitsablauf, ContentCreator, Redakteur, Reports |
| CXT-2413 | Die Funktionatlität der „Datenquellen-Verwaltung“ im FirstSpirit ContentCreator befindet sich weiterhin in der Beta-Phase. |
ContentCreator, Datenquellen-Verwaltung, Entwickler, FirstSpirit-Administrator, Redakteur |
Deprecations
| Funktion | Abgekündigt mit | Entfällt / Entfallen mit |
|---|---|---|
| Eingabekomponente CMS_INPUT_CONTENTAREALIST | 5.2R3 | |
| Eingabekomponente CMS_INPUT_CONTENTLIST | 5.2R3 | |
| Eingabekomponente CMS_INPUT_FILE | 5.2R3 | |
| Eingabekomponente CMS_INPUT_LINKLIST | 5.2R3 | |
| Eingabekomponente CMS_INPUT_OBJECTCHOOSER | 5.2R3 | |
| Eingabekomponente CMS_INPUT_PAGEREF | 5.2R3 | |
| Eingabekomponente CMS_INPUT_PICTURE | 5.2R3 | |
| Eingabekomponente CMS_INPUT_TABLIST | 5.2R3 | |
| FirstSpirit Access-API: de.espirit.firstspirit.agency.GroupsAgent | 5.2R15 | |
| FirstSpirit Access-API: delete (de.espirit.firstspirit.access.AccessUtil) | 5.2R18 | |
| FirstSpirit Access-API: release (de.espirit.firstspirit.access.AccessUtil) | 2018-06 | |
| FirstSpirit Access-API: getLastLoginAsDate (de.espirit.firstspirit.agency.UserStatisticsAgent) | 2018-07 | |
| FirstSpirit Access-API: remainingDurationOfCurrentStageInMillis (de.espirit.firstspirit.server.MaintenanceModeInfo) | 2018-07 | 2025-13 |
| FirstSpirit Access-API: getStartingTimeOfStageAsDate (de.espirit.firstspirit.server.MaintenanceModeInfo) | 2018-07 | 2025-13 |
| FirstSpirit Access-API: getSelectedWebserverConfiguration (de.espirit.firstspirit.access.serverConfiguration) | 2018-10 | 2025-13 |
| FirstSpirit Access-API: setSelectedWebserverConfiguration (de.espirit.firstspirit.access.serverConfiguration) | 2018-10 | 2025-13 |
| FirstSpirit Access-API: getSelectedWebServer (de.espirit.firstspirit.access.project.Project) | 2018-10 | 2025-13 |
| FirstSpirit Access-API: setSelectedWebServer (de.espirit.firstspirit.access.project.Project) | 2018-10 | 2025-13 |
| FirstSpirit Access-API: getLostAndFoundStoreNodes(); (de.espirit.firstspirit.feature.FeatureInstallResult) | 2018-10 | |
| FirstSpirit Access-API: getDeletedStoreNodes(); (de.espirit.firstspirit.feature.FeatureInstallResult) | 2018-10 | |
| FirstSpirit Access-API: de.espirit.firstspirit.access.store.Previewable | 2019-01 | |
| WebSphere Application Server Support für FirstSpirit | 2019-05 | |
| Legacy mode für den FirstSpirit-Server | 2019-06 | 2022-03 |
| Datenbank-Layer Oracle Database 11g/12c | 2020-12 | 2025-05 |
| FirstSpirit Access-API: redirectTemplateLogToDefaultLog() (Interface RenderingAgent.Renderer) | 2021-05 |