Release Notes
1 Administration
1.1 Generierungsverzeichnisse von gelöschten Aufträgen werden aufgeräumt
Wird ein Auftrag mit Generierungsaktion gelöscht und ist für diesen Auftrag ein entsprechendes Verzeichnis auf dem Application Server vorhanden, auf dem die Staging Webanwendung läuft, dann wird auch das entsprechende Verzeichnis auf dem Application Server gelöscht.
1.2 Java-Versions-spezifische Wrapper-Dateien automatisch aktualisieren
Über den Tanuki Java Service Wrapper wird die FirstSpirit Java VM gestartet und beendet.
Bisheriges Verhalten:
Die Konfiguration der Startparameter der Java VM wurde bisher über eine entsprechende Konfigurationsdatei für den Wrapper durchgeführt (fs-wrapper[.isolated].conf).
Bei einem Wechsel der Java-Version wurden die Startparameter angepasst. Die geänderte Konfiguration stand für neue FirstSpirit-Installationen direkt zur Verfügung. Für bestehende Installationen musste die geänderte Konfiguration der Startparameter bisher aber manuell angepasst werden.
Neues Verhalten:
Dieses Verhalten wird mit dem aktuellen FirstSpirit Release verbessert. Dazu wurden die Startoptionen auf zwei getrennte Konfigurationsdateien aufgeteilt:
- Neu:
fs-wrapper-vendor.confenthält die empfohlenen Hersteller-Startoptionen - Geändert:
fs-wrapper[.isolated].confenthält nur noch die Startoptionen, die serverspezifisch angepasst werden sollten
Zielsetzung: Die neue Konfigurationsdatei fs-wrapper-vendor.conf ist Bestandteil des FirstSpirit Aktualisierungsarchivs fs-update-[version].tar.gz. Bei der Aktualisierung des FirstSpirit-Servers über das Aktualisierungsarchiv fs-update-[version].tar.gz werden die Startoptionen automatisch aktualisiert. Damit sind die Konfigurationsanpassungen ohne manuelle Anpassung auch für bestehende FirstSpirit-Installationen verfügbar.
fs-wrapper-vendor.conf sollte nicht geändert werden. Sollte es in Einzelfällen notwendig sein, die empfohlenen Hersteller-Startoptionen anzupassen, sollten die entsprechenden Startparameter in der Konfigurationsdatei fs-wrapper[.isolated].conf erneut definiert werden (und nicht in der fs-wrapper-vendor.conf überschrieben werden). Darstellung über das FirstSpirit ServerMonitoring
Die Startoptionen aus beiden Konfigurationsdateien werden über das FirstSpirit ServerMonitoring (unter „FirstSpirit“ / „Konfiguration“ / „Startoptionen“) dargestellt. Dabei werden die Werte aus beiden Dateien in einer Ansicht zusammengefasst:
.png)
Darstellung der Startoptionen (ServerMonitoring)
Bearbeiten über das FirstSpirit ServerMonitoring
Mit einem Klick auf „Editieren“, können die Startoptionen über das FirstSpirit ServerMonitoring (unter „FirstSpirit“ / „Konfiguration“ / „Startoptionen“) angepasst werden. Hier wird nur der Inhalt der Konfigurationsdatei fs-wrapper[.isolated].conf zum Bearbeiten angeboten.
Die Startparameter der Konfigurationsdatei fs-wrapper-vendor.conf werden darunter „readonly“ angezeigt, mit dem Hinweis, dass die Werte zum Überschreiben erneut definiert werden sollen („Herstellereigenschaften: Eigenschaft erneut definieren, um den empfohlenen Wert zu überschreiben“).
Mit einem Klick auf „Speichern“ werden die Änderungen in der Konfigurationsdatei gespeichert. Werden ungültige Konfigurationen vorgenommen, wird beim Speichern der Konfiguration im ServerMonitoring auf den Fehler hingewiesen und der Speichervorgang wird nicht ausgeführt.
Durch das Übertragen und Ändern der Werte in der Konfigurationsdatei fs-wrapper[.isolated].conf können alle Parameter der Konfigurationsdatei fs-wrapper-vendor.conf überschrieben werden (nicht nur die allgemeinen Java-Parameter wrapper.java.additional.#)
.png)
Bearbeiten der Startoptionen (ServerMonitoring)
Migrationsanleitung
Zur Umstellung auf das neue Verfahren sollten für alle bestehenden FirstSpirit-Installationen die folgenden Schritte durchgeführt werden:
- Das Aktualisierungsarchiv
fs-update-[version].tar.gzherunterladen.
Die Änderungen ist für Aktualisierungsarchive ab Version 1.0.5 verfügbar.
Das Aktualisierungsarchiv ist per Download erhältlich (für Zugangsdaten wenden Sie sich bitte an den Technical Support). - Den FirstSpirit-Server beenden.
- Das Aktualisierungsarchiv
fs-update-[version].tarzunächst dekomprimieren (G(un)zip) und anschließend im gewünschten FirstSpirit-Server-Installationsverzeichnis entpacken. Exemplarischer Aufruf unter Linux:~/firstspirit5$ tar xvfz fs-update-[version].tar.gz - Die Konfigurationsdatei
<FirstSpiritROOT>/conf/fs-wrapper[.isolated].confmit der Datei<FirstSpiritROOT>/conf/conf-all/fs-wrapper[.isolated].conf.default.txtvergleichen.
Dabei die Parameter mit unterschiedlichen Werten in der Datei<FirstSpiritROOT>/conf/conf-all/fs-wrapper[.isolated].conf.default.txtentsprechend anpassen. Insbesondere die folgenden Parameter sind zu beachten:wrapper.java.commandwrapper.java.maxmemorywrapper.java.initmemory(auf den Wert vonwrapper.java.maxmemorysetzen)wrapper.ntservice.name(nur unter Windows)wrapper.umask
Sofern bekannt, die selbstdefinierten Parameter in die Datei<FirstSpiritROOT>/conf/conf-all/fs-wrapper[.isolated].conf.default.txtübernehmen (idealerweise sind hier keine Anpassungen erforderlich). - Nach der Anpassung die Datei
<FirstSpiritROOT>/conf/fs-wrapper[.isolated].confin<FirstSpiritROOT>/conf/fs-wrapper[.isolated].oldumbenennen. - Anschließend die Datei
<FirstSpiritROOT>/conf/conf-all/fs-wrapper[.isolated].conf.default.txtin<FirstSpiritROOT>/conf/fs-wrapper[.isolated].confumbenennen. - Den FirstSpirit-Server starten.
- Optional: Wenn nach einigen Tagen Betrieb keine Auffälligkeiten aufgetreten sind, kann die Datei
<FirstSpiritROOT>/conf/fs-wrapper[.isolated].oldgelöscht werden.
Weiterführende Dokumentation:
2 Allgemeines
2.1 FirstSpirit-Dokumentation: Entfall der PDF-Versionen
Alle FirstSpirit-Produktdokumentationen werden als HTML-Versionen über https://docs.e-spirit.com/ bereitgestellt.
Zusätzlich wurden bislang auch immer PDF-Versionen der Dokumente angeboten, dies entfällt mit dieser Version.
Das bedeutet konkret:
- Der Navigationspunkt „Dokumentation“ wurde aus der Online Dokumentation FirstSpirit entfernt.
- Der DVD-Index, der auf den Strukturen des entfernten Navigationspunktes basiert, wurde auf dem Stand des FirstSpirit Releases 2020-03 eingefroren.
- Die FirstSpirit Release Notes werden aktuell auf eine HTML-Version umgestellt (bis dahin werden sie noch als PDF-Version angeboten).
- Einige FirstSpirit Moduldokumentationen sind aktuell nur als PDF-Version verfügbar, und können weiterhin über https://docs.e-spirit.com/ bezogen werden.
2.2 Java: Aktueller Status und Ausblick
e-Spirit unterstützt für das Produkt FirstSpirit jeweils:
- OpenJDK: die aktuelle freigegebene Java-Version sowie die letzte LTS-Variante (Long-Term-Support).
- Oracle Java: nur die letzte LTS-Variante.
Dies gilt sowohl für den FirstSpirit-Server als auch für die FirstSpirit-Desktop-Anwendungen.
Abweichend von dieser Regel unterstützt e-Spirit momentan noch Oracle Java und OpenJDK in Version 8. Der Support wird jedoch zukünftig entfallen (siehe unten „Ausblick Unterstützung von Java 8“).
Mit FirstSpirit 2020-04 wird OpenJDK 14 (non-LTS; Release Date 2020-03) für die Verwendung mit FirstSpirit (für den FirstSpirit-Server und die FirstSpirit-Desktop-Anwendungen) freigegeben.
AdoptOpenJDK 14 ist im Modul „FirstSpirit Launcher JRE“ enthalten (siehe dazu Modul „FirstSpirit Launcher JRE“: Aktualisierung der Java-Versionen). Die FirstSpirit-Desktop-Anwendungen können nach der entsprechenden Konfiguration über das Modul „FirstSpirit Launcher JRE“ mithilfe des FirstSpirit Launchers mit AdoptOpenJDK 14 gestartet werden. (Dokumentation zum Modul „FirstSpirit Launcher JRE“ siehe entsprechende Dokumentation).
Mit der Freigabe der Unterstützung von OpenJDK 14 erlischt gleichzeitig die Unterstützung für OpenJDK 13 (non-LTS; Release Date 2019-07).
FirstSpirit wird mit OpenJDK 13 voraussichtlich weiter funktionsfähig bleiben. Es werden aber seitens der e-Spirit AG weder Tests mit OpenJDK 13 ausgeführt noch FirstSpirit-Probleme behoben, die ausschließlich im Zusammenhang mit der Verwendung von OpenJDK 13 auftreten.
Aktueller Status: Für FirstSpirit 2020-04 sind damit die folgenden JDKs kompatibel:
- Oracle Java 11 (in der aktuellen Version) (LTS)
- Oracle Java 8 (in der aktuellen Version) (LTS; outdated)
- OpenJDK 14 (in der aktuellen Version) (non-LTS) (**)
- OpenJDK 11 (in der aktuellen Version) (LTS) (**)
- OpenJDK 8 (in der aktuellen Version) (LTS; outdated) (*) (**)
(*) Die im Modul „FirstSpirit Launcher JRE“ enthaltene Version 8u242 (Outdated) wird im April 2020 nicht mehr auf Version 8u252 (Outdated) aktualisiert werden.
(**) Empfohlen: Verwendung der OpenJDK-Distribution AdoptOpenJDK (HotSpot JVM)
Eine vollständige Auflistung der unterstützten Java-Versionen findet sich unter Technische Voraussetzungen und Empfehlungen (Dokumentation für Administratoren).
Ausblick Unterstützung von Java 8:
Im Rahmen der Produktpflege wurde mit FirstSpirit-Version 2019-05 der Support für Java 8 abgekündigt (**):
Planmäßig wird Oracle Java 8 bzw. OpenJDK 8 damit ab Juni 2020 von FirstSpirit nicht mehr unterstützt.
(**) 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.
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.
Sollten sich zukünftig Sicherheitslücken bzw. sicherheitsrelevante Probleme unter Java 8 ergeben, behält die e-Spirit AG sich vor, die Java-8-Unterstützung für FirstSpirit vorzeitig (vor Juni 2020) zu beenden.
Mit Entfall des Java-8-Supports wird, wie bereits angekündigt, auch:
- der Support für den Windows-Installer 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 Oracle Java 8 noch enthalten, mit Oracle Java 11 jedoch entfallen. OpenJDK bietet keine vergleichbare Technologie). SiteArchitect und ServerManager können dann 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 werden zunächst schrittweise die Java-8-Kompatibilitätstest reduziert. 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.
Serverseitig sollte der Wechsel von Java 8 auf Java 11 (und höher) vorab ausgiebig auf einem Testsystem geprüft werden, speziell bei Verwendung von Fremdkomponenten und kundenspezifischen Erweiterungen! Java 8 und 11 unterscheiden sich teilweise immens voneinander, sodass verwendete Bibliotheken und Implementierungen mit Java 11 (und höher) inkompatibel sein können. In diesem Fall kann es häufig helfen, die betroffenen Bibliotheken zu aktualisieren, falls eine Aktualisierung existiert. Beim Wechsel von Java 8 auf Java 11 (und höher) empfiehlt es sich gleichzeitig, den Server auf den Isolated Mode umzustellen, da hier eine doppelte Prüfung von Modulen und Implementierungen vermieden werden kann. Siehe dazu Umstellung auf den Isolated Mode.2.3 Unterstützung externer Datenbanken durch das DatasetDataAccessPlugin
Das DatasetDataAccessPlugin wurde derart erweitert, dass jetzt auch in FirstSpirit konfigurierte, externe Datenquellen über die FS_INDEX Eingabekomponente angebunden werden können, auf denen FirstSpirit keine Schreibrechte besitzt (z. B. nur lesend angebundene Datenbanken).
Als Identifikator wird in diesem Fall eine kodierte Variante des Primärschlüssels der entsprechenden Tabelle verwendet.
3 ContentCreator
3.1 Neue Navigationsansicht im ContentCreator vereint hierarchische Strukturdarstellung, Kontextinformation und Bearbeitungsmöglichkeit
Um die Arbeit für Redakteurinnen und Redakteure besonders einfach und intuitiv zu gestalten, steht die Vorschau im Mittelpunkt des Bedienkonzepts des FirstSpirit ContentCreator: Das Bearbeiten von Inhalten erfolgt direkt auf der Webseite im Browser. Dadurch kann der Redakteur sofort sehen, wie sich Änderungen später auf der Webseite auswirken. Für die Navigation zu den zu bearbeitenden Seiten wurde bisher ausschließlich die Vorschau selbst genutzt, sowie Reports (z. B. Suche, Verwandte Elemente).
Aufgrund gestiegener Anforderungen an die Bearbeitung von Projekten per ContentCreator bildet dieser mit dem aktuellen Release jetzt zusätzlich die Projekt- bzw. Website-Struktur in einem Strukturbaum ab.
Er ermöglicht u.a.
- einen schnellen Überblick über strukturelle Zusammenhänge innerhalb der Website-Struktur (Hierarchie)
- ein unkompliziertes, direktes Annavigieren von Seiten, auch wenn diese nicht über die Website-Navigation erreichbar sind (typisch bei Landing-Pages oder technischen Projektseiten)
- einen schnellen Überblick über Kontextinformationen zu einzelnen Seiten (z. B. Freigabe-Zustand, Vorhandensein von Metadaten...)
- die Bearbeitung von Eigenschaften und Inhalten von Seiten und Absätzen
- einfaches und intuitives Verschieben von Menüpunkten
Die Brücke zwischen Vorschau und Strukturinformation schlagen dabei Synchronisierung und Highlighting: ein Klick auf ein Element in der Struktur zeigt in der Vorschau die betreffende Seite an und hebt es in der Vorschau hervor. Andersherum folgt die neue Navigationsansicht auch dem Mauszeiger des Redakteurs in der Vorschau.
Zusätzlich gestattet die neue Navigationsansicht einen Wechsel zwischen unterschiedlichen Sprachen des Projekts.

Die entsprechende Funktion befindet sich hinter dem Icon ganz links in der Menüleiste:
In diesem Kontext wurde der Dialog zum Bearbeiten der Navigation, der bisher unter dem Menüeintrag „Navigation bearbeiten“ im Menü „AKTIONEN“ verfügbar war, entfernt, da dieselben Funktionen jetzt von der neuen Navigationsansicht angeboten werden. Statt dem Dialog öffnet sich über den Menüeintrag „Navigation bearbeiten“ jetzt die Navigationsansicht.
Es ist geplant, diese neue Navigationsansicht in kommenden Releases um Funktionen zu erweitern. Die neue Navigationsansicht steht nicht im alten ContentCreator zur Verfügung.
Hinweis für Entwickler und Administratoren: Die neue Navigationsdarstellung bildet standardmäßig die gesamte Struktur-Verwaltung eines Projekts ab. Anders als zuvor können Redakteure jetzt zu jeder Seite gelangen. Und damit ggf. auch zu eher „technischen“ Seiten, die möglicherweise keine für den Redakteur lesbare Ausgabe haben. Dies sollte bei der Projektentwicklung beachtet und Knoten in der Struktur-Verwaltung, die nicht relevant für Redakteure sind, per geeigneter Rechtevergabe ausgeblendet werden.
3.2 Verwendung des "alten" ContentCreator
Design und technische Basis des FirstSpirit ContentCreator wurden überarbeitet.
Standardmäßig wird der „neue“ ContentCreator automatisch für alle Projekte verwendet, die mit dem ContentCreator gestartet werden. Bei Bedarf kann jedoch projektweise zum „klassischen“ ContentCreator zurückgewechselt werden.
Mit FirstSpirit 2020-07 wird der ContentCreator im „alten“ Design planmäßig entfallen. Daher lautet die Empfehlung, möglichst früh den „neuen“ ContentCreator für alle Projekte einzusetzen.
Ist der „alte“ ContentCreator auf einem FirstSpirit-Server noch für eine oder mehrere Web-Anwendungen konfiguriert, wird FirstSpirit-Administratoren daher mit dem aktuellen Release auf der Startseite des FirstSpirit-Servers ein entsprechender Hinweis angezeigt:
Verwendung des alten ContentCreator erkannt. Web-Anwendung: ...Zu weiteren Informationen siehe https://docs.e-spirit.com/odfs/edocs/admi/firstspirit-ser/server-eigensch/web-applikation/index.html.
Hinweis zum neuen ContentCreator: Es wird empfohlen, für den neuen ContentCreator Google Chrome und Microsoft Edge auf Chromium-Basis zu verwenden. Mit dem Microsoft Internet Explorer ist der neue ContentCreator nicht kompatibel.4 FirstSpirit Content Experience Tools (CXT)
4.1 Aktuelle Modul-Versionen
Folgende Modul-Versionen für „FirstSpirit Content Experience Tools“ werden von FirstSpirit 2020-04 unterstützt:
| Modul- / Dateiname | Versionsnummer |
FirstSpirit CXT DAP Bridgedataservice-[version].fsm | 1.27 |
FirstSpirit CXT FragmentCreatorfragment-creator-[version].fsm | 2.2 |
FirstSpirit Fragment DAPfragmentdap-[version].fsm | 1.24 |
FirstSpirit Media DAPmediadap-[version].fsm | 1.23* |
FirstSpirit Markdown Editormarkdown-editor-[version].fsm | 1.20* |
FirstSpirit Tagging Editortagging-editor-[version].fsm | 1.20 |
FirstSpirit CXT FragmentCreator - CaaS Integrationcaas-integration-[version].fsm | 1.19 |
* Diese Module benötigen ab dieser Version FirstSpirit 2020-03 oder höher.
4.2 Fehleranalyse für MicroApp Framework
Eine Quelle für Fehler ist häufig eine fehlerhafte Konfiguration. Sie kann dazu führen, dass die Software nicht oder nicht wie erwartet funktioniert.
Mit dem aktuellen Release kann eine Fehlerseite für das MicroApp Framework eingerichtet werden, die die aktuelle Konfiguration des Servers übersichtlich darstellt und Fehlermeldungen auflistet.
Die Fehlerseite ist unter
/statusfür Administratoren erreichbar, angehängt an die URL des FragmentCreator, also z. B.
http://myServer:8080/fragments/status

Neben Informationen zum Server führt sie auch einen Test der Konfiguration durch und listet die letzten HTTP-Requests und Logmeldungen auf.
Um Logmeldungen zu erhalten, muss in der Datei web.xml der Parameter logging.file.name mit der gewünschten Log-Datei (z. B. /tmp/fc.log) angegeben werden, z. B.
logging.file.name=/home/tomcat/logs/fragments.logoder alternativ in der Properties-Datei /config/cxt-fragment-creator.properties.
Siehe dazu auch Dokumentation zum MicroApp Framework, https://docs.e-spirit.com/odfs/edocs/cxt/installation-mo/module-installi/fragmentcreator/index.html.
4.3 FS_INDEX unterstützt das Erstellen von Fragmenten unterschiedlicher Kategorien (Tag CATEGORY)
Mit dem Fragment DAP können Fragmente aus einem Fragment-Projekt in einem anderen Fragment-Projekt referenziert, dort bearbeitet und auch neue erstellt werden. Dazu wird die Eingabekomponente FS_INDEX mit DataAccessPlugin-Komponente FirstSpiritFragmentAccess/FSFAConnector eingesetzt.
Das Tag CATEGORY wurde dabei bisher verwendet, um die Auswahl auf bestimmte Kategorien einzuschränken. Wurde nur eine Kategorie spezifiziert, wurde FS_INDEX um eine Schaltfläche erweitert, über die neue Fragmente der betreffenden Kategorie neu erstellt werden konnten.
Mit dem aktuellen Release wird nun auch das Erstellen von Fragmenten unterschiedlicher Kategorien unterstützt, wenn mehrere Kategorien spezifiziert sind.
Beispiel-Syntax:
<FS_INDEX name="fragments">
<LANGINFOS>
<LANGINFO lang="*" label="Fragments"/>
<LANGINFO lang="DE" label="Fragmente"/>
</LANGINFOS>
<SOURCE name="FirstSpiritFragmentAccess/FSFAConnector">
<PROJECT remote="fragmentproject"/>
<CATEGORY uid="contact"/>
<CATEGORY uid="teaser"/>
</SOURCE>
</FS_INDEX>Das Verhalten hinsichtlich des Tags CATEGORY ist nun folgendermaßen:
- Keine Angabe von
CATEGORY: Es ist nur eine Auswahl von Fragmenten aus dem über dasPROJECT-Tag spezifizierte Projekt möglich, es können keine Fragmente erstellt werden. - Angabe eines
CATEGORY-Tags: Es können Fragmente der spezifizierten Kategorie ausgewählt und erstellt werden. Mit einem Klick auf die Schaltfläche zum Erstellen neuer Fragmente öffnet sich das betreffende Formular. - Angabe mehrerer
CATEGORY-Tags: Es können Fragmente der spezifizierten Kategorien ausgewählt und erstellt werden. Mit einem Klick auf die Schaltfläche zum Erstellen neuer Fragmente öffnet sich eine Liste mit den zur Verfügung stehenden Kategorien:

Die referenzierten Fragmente können auch bearbeitet werden.
In Projekten, in denen FS_INDEX mit DataAccessPlugin-Komponente FirstSpiritFragmentAccess/FSFAConnector und TagCATEGORY bereits verwendet wird, sollte die Konfiguration aufgrund des neuen Verhaltens geprüft werden: Sind mehrere CATEGORY-Tags spezifiziert, war bisher nur eine Auswahl von Fragmenten durch Redakteure möglich. Jetzt können Redakteure neue Fragmente der über die CATEGORY-Tags spezifizierten Typen auch neu anlegen.4.4 Konfiguration des Content-Security-Policy-Headers
Über den Konfigurationsparameter cxt.platform.microapps.csp-origins kann jetzt der Header Content-Security-Policy angepasst werden. Dies ist z.B. dann erforderlich, wenn Zugriffe auf MicroApps von anderen Domains erlaubt werden sollen.
Der Standardwert lautet 'self'.
4.5 Media DAP: Typabhängiger Upload von Dateien
Bislang konnten im FirstSpirit FragmentCreator über die Eingabekomponente FS_INDEX mit Media DAP (<SOURCE name="FirstSpiritMediaAccess/Connector">) nur Bilder hochgeladen werden. Mit dem aktuellen Release wird jetzt auch der Upload von Dateien anderer Formate unterstützt. Darüber hinaus kann über das Attribut mode im Tag SOURCE gesteuert werden, welcher Medientyp hochgeladen werden darf. Der Filter bezieht sich wie bisher auch auf die Auswahl von Medientypen:
PICTURE: Es können nur Bilder hochgeladen und ausgewählt werden.FILE: Es können nur Dateien hochgeladen und ausgewählt werden, die keine Bilder sind.ANY(Standard): Es können alle Medien (sowohl Bilder als auch Dateien) hochgeladen und ausgewählt werden.
Beispiel-Syntax:
<FS_INDEX name="files">
<LANGINFOS>
<LANGINFO lang="*" label="Files"/>
<LANGINFO lang="DE" label="Dateien"/>
</LANGINFOS>
<SOURCE name="FirstSpiritMediaAccess/Connector" mode="file">
<PROJECT remote="media"/>
</SOURCE>
</FS_INDEX>Werden Medien in den Hochladen-Dialog gedropped, die nicht dem über mode spezifizierten Typ entsprechen, wird eine entsprechende Warnung angezeigt und diese Medien werden nicht ins Projekt hochgeladen.
Zu weiteren Informationen siehe https://docs.e-spirit.com/odfs/edocs/cxt/vorlagen/medien-verwende/index.html.
5 Modul-Entwicklung, Skripte, API
API-Erweiterung für das Erzeugen von Referenzen (ReferenceConstructionAgent und ValueReferencesJournal)
Wesentliche Funktionalitäten von FirstSpirit basieren auf dem Referenzgraph eines Projekts, der verwendet wird, um die Abhängigkeiten von Objekten innerhalb komplexer Projekte zu erkennen.
Zum Erzeugen von Referenzen über die FirstSpirit Developer-API wird ein Agent vom Typ ReferenceConstructionAgent benötigt. Über einen ReferenceConstructionAgent können dann Instanzen vom Typ ReferenceHolder erzeugt werden.
Der ReferenceConstructionAgent (FirstSpirit Developer-API, Package de.espirit.firstspirit.client.access.editor) wurde mit dem aktuellen FirstSpirit-Release um Methoden erweitert, die das Erzeugen von Referenzen auf Basis von Meta-Informationen ermöglichen (über den Unique Identifier (UID) und IDProvider.UidType eines FirstSpirit-Objekts oder über den Global Identifier (GID) für Referenzen auf Datensätze). Bisher wurde für das Erzeugen von Referenzen zwingend eine Instanz vom Typ IDProvider benötigt.
Neue Methoden im ReferenceConstructionAgent:
IDProviderReferenceHolder create(String uid, IDProvider.UidType uidType,...);IDProviderReferenceHolder create(String schemaUid, String entityTypeName,...);Zeitgleich wurde das Interface ValueReferencesJournal (FirstSpirit Access-API, Package de.espirit.firstspirit.client.plugin.dataaccess.aspects) optimiert. Hier wurden mit dem aktuellen FirstSpirit-Release Methoden als „deprecated“ markiert, die speziell für die Hinzufügen von fehlerhaften Referenzen (Broken References) bereitgestellt wurden. Stattdessen wurde das Interface um neue Methoden erweitert, die gleichermaßen für das Hinzufügen von fehlerhaften als auch von regulären Referenzen (z. B. in einem DataAccessProvider) verwendet werden können. Es wird beim Hinzufügen der Referenz nur noch das gewünschte Objekt übergeben und das System prüft dann selbstständig, ob das Zielobjekt erreichbar ist oder nicht und bewertet die Referenz entsprechend.
Die neue Methode im Interface ValueReferencesJournal
addReferenceToElement(final String uid, final IDProvider.UidType uidType,...); ersetzt beispielsweise die bisherige Methode:
addBrokenReferenceToElement(String uid, IDProvider.UidType uidType,...);6 System
Aktualisierung von integrierter Fremdsoftware
Mit dem aktuellen FirstSpirit-Release wurde folgende intern verwendete Software aktualisiert:
Java (JRE, mit dem der FirstSpirit-Launcher betrieben wird)
Mit dem aktuellen FirstSpirit-Release wurden die im Modul „FirstSpirit Launcher JRE“ (siehe Dokumentation zum Modul „FirstSpirit Launcher JRE“) enthaltenen Java-Versionen aktualisiert. Neben der mit dem FirstSpirit Launcher ausgelieferten Version, AdoptOpenJDK 11.0.6 (Default), sind aktuell folgende Java-Varianten verfügbar:
- AdoptOpenJDK 14 (Neu)
- AdoptOpenJDK 8u242 (Outdated)
AdoptOpenJDK 13.0.2 wurde aus dem Modul FirstSpirit Launcher JRE entfernt.
Nach der Aktualisierung des Moduls kann ein Neustart des ServerManagers notwendig sein, um die entsprechende Konfiguration durchzuführen.Spring Boot (für das MicroApp Framework)
Aktualisierung von Version 2.2.2 auf Version 2.2.5
Spring Cloud Hoxton (für das MicroApp Framework)
Aktualisierung von Version Hoxton.SR1 auf Version Hoxton.SR3
Eclipse Jetty (im Modul fs-jetty.fsm / „FirstSpirit Jetty Service“ enthalten)
Aktualisierung von Version 9.4.23 auf Version 9.4.27
Übersicht
| ID | Beschreibung | Kategorien |
|---|---|---|
| CORE-5816 | Es wurde ein Fehler behoben, der in seltenen Fällen dazu führen konnte, dass bei der Verwendung der Funktion |
Entwickler, JSON-Unterstützung, Vorlagenentwicklung |
| CORE-10776 | Mit dem aktuellen FirstSpirit-Release können die Startoptionen der FirstSpirit Java VM automatisch aktualisiert werden. Dazu wurden die Startoptionen auf zwei getrennte Konfigurationsdateien aufgeteilt. Die neue Datei |
FirstSpirit-Administrator, Java, Migration, Server-Administrator, ServerMonitoring |
| CORE-10836 | Beim Löschen eines Auftrags mit Generierungsaktion wird nun auch das entsprechende Verzeichnis auf dem Application Server gelöscht, auf dem die Staging Webanwendung läuft. |
FirstSpirit-Administrator |
| CORE-11471 | Es wurde ein Fehler behoben, der dazu führen konnte, dass nach der Aktualisierung eines in Aufträgen verwendeten Moduls die entsprechende Aktion bis zu einem Neustart des Servers nicht mehr genutzt werden konnte. Hinweis: Das Problem kann bei Aufträgen, die zum Zeitpunkt des Updates ausgeführt wurden, innerhalb der laufenden Ausführung einmalig weiterhin auftreten. |
Aufträge, FirstSpirit-Administrator, Isolated mode, Module, Server-Administrator |
| CORE-11816 | Über das Interface |
Entwickler, FirstSpirit-API, JSON-Unterstützung |
| CORE-11827 | Mit dem aktuellen FirstSpirit-Release wurde intern verwendete Software aktualisiert. |
FirstSpirit Content Experience Tools (CXT), FirstSpirit Jetty Web Server, FirstSpirit-Administrator, Integrierte Software, Java, Launcher |
| CORE-11858 | Der |
Data Access Plugin, Entwickler, FirstSpirit-API, Modul-Entwicklung |
| CORE-11911 | Durch das DatasetDataAccessPlugin wird jetzt auch die Referenzierung von Datensätzen externer Datenbanken unterstützt. |
Data Access Plugin, Datenbank |
| CORE-12018 | Unterstützung OpenJDK 14: Mit FirstSpirit 2020-04 wird OpenJDK 14 (non-LTS; Release Date 2020-03) für die Verwendung mit FirstSpirit (für den FirstSpirit-Server und die FirstSpirit-Desktop-Anwendungen) freigegeben. Mit der Freigabe der Unterstützung von OpenJDK 14 erlischt gleichzeitig die Unterstützung für OpenJDK 13 (non-LTS; Release Date 2019-09). |
Entwickler, FirstSpirit-Administrator, Java, Server-Administrator |
| CORE-12031 | Bei der Nutzung von Services aus eigenen Services heraus konnte es zu einem Fehler kommen, wenn die beteiligten Komponenten noch nicht vollständig gestartet waren. Dieses Abhängigkeitsszenario wurde behoben. |
FirstSpirit-Administrator, Server-Administrator |
| CORE-12043 | Es wurde ein Fehler behoben, der in seltenen Fällen zu Problemen bei der Verwendung von X.509-Zertifikaten in Verbindung mit dem Modul |
FirstSpirit Jetty Web Server, Server-Administrator, Webserver |
| CORE-12060 | Alle FirstSpirit Dokumentationen, die bereits in einer HTML-Version verfügbar sind, stehen nicht mehr als PDF-Version zu Verfügung. |
Dokumentation |
| CORE-12079 | In seltenen Fällen konnten Datensätze aufgrund einer inkorrekten Auswertung der betreffenden |
ContentCreator, Datenquellen-Verwaltung, Entwickler, Redakteur, Tabellenvorlagen |
| CORE-12091 | Ist der „alte“ ContentCreator auf einem FirstSpirit-Server noch für eine oder mehrere Web-Anwendungen konfiguriert, wird FirstSpirit-Administratoren mit dem aktuellen Release auf der Startseite des FirstSpirit-Servers ein entsprechender Hinweis angezeigt. |
ContentCreator, Entwickler, FirstSpirit-Administrator |
| CXT-846 | FS_INDEX mit DataAccessPlugin-Komponente FirstSpiritFragmentAccess/FSFAConnector unterstützt jetzt auch das Erstellen von Fragmenten mehrerer unterschiedlicher Kategorien (Tag |
Eingabekomponenten, Entwickler, FirstSpirit Content Experience Tools (CXT), FragmentCreator |
| CXT-1205 | Das Media DAP erlaubt jetzt den typabhängigen Upload von Dateien. |
Entwickler, FirstSpirit Content Experience Tools (CXT), FragmentCreator, Medien, Module, Redakteur |
| CXT-1206 | Informationen für Analyse und Debugging |
Debugging, Entwickler, FirstSpirit Content Experience Tools (CXT), FirstSpirit-Administrator |
| CXT-1221 | Sprachauswahllisten erhalten jetzt bei vielen Einträgen einen Scrollbalken. |
ContentCreator, Redakteur, Sprachen |
| CXT-1319 | Der Standard-Arbeitsablauf zum Löschen von Fragmenten und Varianten „Request deletion“ entfernt jetzt wieder komplette Fragmente aus Live-CaaS-Instanzen, und nicht mehr nur einzelne Varianten. |
FirstSpirit Content Experience Tools (CXT), FirstSpirit Content as a Service (CaaS) |
| CXT-1330 | In seltenen Fällen wurde nach Drag-und-Drop von Bildern in den entsprechenden Dialog von FS_INDEX kein Vorschaubild dargestellt (Fehlermeldung: |
FirstSpirit Content Experience Tools (CXT), FragmentCreator, Medien, Redakteur |
| CXT-1338 | Die Darstellung von Schaltflächen in Dialogen im „neuen“ FirstSpirit ContentCreator wurde optimiert, sodass speziell Beschriftungen in Dialogen zur Weiterschaltung von Arbeitsabläufen jetzt besser lesbar sind. |
ContentCreator, Entwickler, Redakteur |
| CXT-1343 | Es wurde ein Fehler behoben, der im neuen ContentCreator in seltenen Fällen zu einem ungewünschten Flackern von Icons führen konnte (z. B. Lesezeichen-Icon in der Menüleiste, Icons im Bild-Zuschnittsdialog). |
ContentCreator, Entwickler, Redakteur |
| CXT-1354 | LiveEdit funktioniert nun auch wieder mit dem „neuen“ ContentCreator. |
ContentCreator, Entwickler, LiveEdit |
| CXT-1376 | Beim Upload von Dateien per Drag-und-drop im neuen ContentCreator (über FS_REFERENCE) wird jetzt der MIME-Typ wieder korrekt anhand der Dateiendung erkannt. |
ContentCreator, Medien, Redakteur |
| CXT-1378 | Das MicroApp Framework arbeitet jetzt noch stabiler mit nativen DataAccess-Plugins zusammen, die im Standard-Lieferumfang von FirstSpirit enthalten sind, wie bspw. das DatasetDataAccessPlugin. |
Data Access Plugin, Entwickler, FirstSpirit Content Experience Tools (CXT), FragmentCreator |
| CXT-1405 | Zusätzlich zur Vorschau bietet der FirstSpirit ContentCreator jetzt Navigations- und Bearbeitungsmöglichkeiten per Strukturbaum. |
ContentCreator, Redakteur |
| CXT-1419 | Der Header |
FirstSpirit Content Experience Tools (CXT), FirstSpirit-Administrator |
| CXT-1421 | Nach Änderungen an Seiten aktualisiert sich die Ansicht jetzt wieder direkt, sodass u.a. auch wieder der korrekte Status (Bearbeitungszustand/Arbeitsablauf) in Kombination mit FirstSpirit Omnichannel Manager angezeigt wird. |
Arbeitsablauf, ContentCreator, Entwickler, FirstSpirit-Administrator, Omnichannel Manager / Third Party Preview, Redakteur |
| CXT-1436 | FirstSpirit Content Experience Tools: Aktuelle Modul-Versionen |
Entwickler, FirstSpirit Content Experience Tools (CXT), FirstSpirit-Administrator, FragmentCreator, Module |
Deprecations
| Funktion | Abgekündigt mit | Entfällt / Entfallen mit |
|---|---|---|
| Eingabekomponente FS_LIST | 5.2R3 | 2020-07 |
| 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 | |
| Windows-Installer | 2018-06 | 2020-06 |
| 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 | |
| Java 8 Support für FirstSpirit | 2019-05 | 2020-06 |
| WebSphere Application Server Support für FirstSpirit | 2019-05 | |
| Legacy mode für den FirstSpirit-Server | 2019-06 | 2022-03 |
| Support von Java Web Start für FirstSpirit | 2019-10 | 2020-06 |
| FirstSpirit ContentCreator (altes Design / alte Technik) | 2019-11 | 2020-07 |
| Demo-Projekt Mithras Energy | 2020-02 | 2020-06 |