Release Notes

In den Verbindungseinstellungen ist es nun möglich, deutlich mehr Speicher für die FirstSpirit-Desktop-Anwendungen (SiteArchitect, ServerManager) zu allokieren.

Außerdem gibt es in den Verbindungseinstellungen nun für den Benutzer standardmäßig eine Vorbelegung mit den empfohlenen Werten für Speicher (2048 MB), Kompression (deflate speed) und Verschlüsselung (TLS).

Hinweis: Wurden die Verbindungseinstellungen in der Vergangenheit bereits modifiziert oder die durch die Option „Einstellungen verwenden“ aktiviert, dann bleiben die bisherigen Werte erhalten.

Der Upload von Bildern ist im ContentCreator an vielen Stellen möglich, z. B.:

• über die Menüfunktion „Neues Medium hochladen“
• in der Medien-Verwaltung
• über die Eingabeelemente (bei entsprechender Konfiguration; sowohl per Formular als auch über die (Vorschau)Seite selbst)
  • FS_REFERENCE
  • CMS_INPUT_IMAGEMAP
  • FS_BUTTON
• über die Funktion „Bild bearbeiten“ auf Bildern in Reports und in der Navigationsleiste

Zusätzlich zu einem Upload vom Arbeitsplatzrechner können im ContentCreator Bilder jetzt auch aus anderen Browserfenstern/-tabs hochgeladen werden.
Damit dies möglich ist, muss der Server, der das Bild ausliefert, Cross-Origin-Requests erlauben. Ansonsten wird eine Fehlermeldung angezeigt.

Wird der Mauszeiger über einen Bereich einer Vorschauseite gehalten, an dem ein Bild fallengelassen werden kann, wird dieser Bereich umrahmt.

Zu weiteren Informationen siehe „Dokumentation zum FirstSpirit ContentCreator“ (https://docs.e-spirit.com/contentcreator/vorschauseite-b/medien/index.html#upload)

Mithilfe der Eingabekomponenten FS_REFERENCE und CMS_INPUT_IMAGEMAP können bei entsprechender Konfiguration Medien hochgeladen werden (Attribut upload).

Verfügt der aktuelle User nicht über ausreichende Rechte zum Hochladen des Mediums (per Drag-and-drop oder Icon „Medium hinzufügen“ bzw. „Bild hochladen“), wird dies jetzt bereits im Dialog „Neues Medium hochladen“ durch Schloss-Symbole visualisiert, z. B.

Ein Knoten mit diesem Symbol kann nicht ausgewählt werden, so dass ein Schließen des Dialogs per „Fertigstellen“ nicht möglich ist.

Zuvor wurde auf die fehlenden Rechte erst beim Speichern bzw. Schließen des Dialogs hingewiesen. Fehlermeldung:

Das Hochladen ist fehlgeschlagen.
Sie haben nicht die notwendigen Rechte, um das Medium am ausgewählten Ort abzulegen.

Sind mehrere (Remote-)Projekte als Ziel zugelassen (Tag <PROJECTS>), ist jetzt der Upload über FS_REFERENCE und CMS_INPUT_IMAGEMAP im ContentCreator auch dann möglich, wenn für ein Projekt keine ausreichenden Rechte vorhanden sind.
Zuvor wurde ein Upload mit der Fehlermeldung

Es ist ein unerwarteter Fehler aufgetreten.

abgewiesen.

Mit FirstSpirit 2021-02 wurde eine farbige Markierung von ungültiger Formatierung im Rich-Text-Editor eingeführt:

• orangefarbene Markierung: Es handelt sich um eine Formatvorlage, die im Projekt vorhanden, aber für den jeweiligen Rich-Text-Editor nicht zugelassen ist.
• rote Markierung: Es handelt sich um eine Formatvorlage, die nachträglich gelöscht wurde oder aus einem anderen Grund unbekannt ist.

Mit dem aktuellen Release wurde die Visualisierung marginal angepasst:

orangefarbene Markierung:

rote Markierung:

Die Verwendung von Eingabekomponenten, die auf dem Server nicht (mehr) verfügbar sind, führt nun nicht mehr dazu, dass das gesamte Formular als fehlerhaft dargestellt wird, es wird ausschließlich die unbekannte Eingabekomponente als fehlerhaft dargestellt.

Die fehlende Komponente wird im Formular mit dem folgenden Hinweis markiert:

Anzeigefehler im Editor (...). There is no component registered as (...)!

Für fehlende Eingabekomponenten innerhalb eines Formulars gilt:

• Die Verwendung einer unbekannten Eingabekomponente hat keinen Einfluss auf andere Eingabekomponenten in dem entsprechenden Formular, das Bearbeiten und Speichern entsprechender Knoten ist nun möglich.
• Beim Speichern wird sichergestellt, dass der Inhalt der unbekannten Eingabekomponente nicht modifiziert wird.
• Wenn die unbekannte Eingabekomponente später auf dem Server nachinstalliert (z. B. FS_MARKDOWN) oder durch eine kompatible Eingabekomponente ersetzt wird (z. B. FS_LIST), dann werden die entsprechenden Inhalte wieder zur Verfügung stehen. So ist sichergestellt, dass es trotz der nicht unterstützten Eingabekomponenten nicht zu Datenverlusten kommt.
• Es ist nicht möglich, die Inhalte einer unbekannten Eingabekomponente in der Vorschau oder der Generierung auszugeben.
• Wenn eine nicht unterstützte Eingabekomponente (z. B. FS_LIST) in einem Datensatz dazu verwendet wird, über eine Fremdschlüsselbeziehung einen anderen Datensatz zu referenzieren, so kann der entsprechende Datensatz nicht gespeichert werden. Der Redakteur bekommt in diesem Fall eine entsprechende Fehlermeldung angezeigt.
  Hintergrund: Eine solche Speicheroperation würde zu Datenverlusten führen, da die Informationen über die referenzierten Datensätze nicht zur Verfügung stehen.

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

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

Mit dem aktuellen Release wurden für mehr Übersichtlichkeit im FragmentCreator neue Darstellungsmöglichkeiten von Eingabekomponenten geschaffen:

Darstellung nebeneinander (noBreak)
Standardmäßig werden Eingabekomponenten im FragmentCreator jeweils in einer Zeile dargestellt.
Mit dem aktuellen Release können Eingabekomponenten jetzt auch nebeneinander dargestellt werden, z. B.

Dazu unterstützen die Eingabekomponenten

• CMS_INPUT_TEXT
• CMS_INPUT_NUMBER
• CMS_INPUT_DATE

jetzt das Attribut noBreak.
Mit diesem Attribut kann der automatische Zeilenumbruch nach einer Eingabekomponente unterdrückt werden.
Um den automatischen Zeilenumbruch zu unterdrücken, ist der Wert yes anzugeben:

noBreak="yes"

Beispiel:

...
<CMS_INPUT_TEXT name="author1" noBreak="yes">
     <LANGINFOS>
       <LANGINFO lang="*" label="Name"/>
     </LANGINFOS>
</CMS_INPUT_TEXT>
 
<CMS_INPUT_TEXT name="author2">
     <LANGINFOS>
       <LANGINFO lang="*" label="Last name"/>
     </LANGINFOS>
</CMS_INPUT_TEXT>
 

<CMS_INPUT_DATE name="creationDate" mode="date" noBreak="yes">
     <LANGINFOS>
       <LANGINFO lang="*" label="Date"/>
     </LANGINFOS>
</CMS_INPUT_DATE>
 
<CMS_INPUT_NUMBER name="number" type="double">
     <LANGINFOS>
       <LANGINFO lang="*" label="Number"/>
     </LANGINFOS>
</CMS_INPUT_NUMBER>

Standardwert für noBreak ist no (also: kein Umbruch).

Hinweis: Bei zu geringer Breite (d.h. es passen nicht alle Eingabekomponenten in die vorgesehene Zeile) werden Formularzeilen trotz gesetztem noBreak="yes" umgebrochen, um eine Mindestbreite der Eingabekomponenten zu gewährleisten.
Die Möglichkeit, die Eingabekomponenten auf die volle Breite zu strecken (Attribut hFill), wird nicht unterstützt.

Gruppierungen (CMS_GROUP)
CMS_GROUP dient der graphischen Gruppierung von Eingabekomponenten eines Formulars, um so eine bessere Übersichtlichkeit zu erreichen.
Eingabekomponenten können dabei

• auf mehreren Registern
• untereinander mit Rahmen

dargestellt werden.

Mit dem aktuellen Release wird CMS_GROUP auch im FragmentCreator unterstützt.

Code-Beispiel:

<CMS_MODULE>

   <CMS_GROUP name="group" tabs="top">
 
     <CMS_GROUP name="text">
       <LANGINFOS>
         <LANGINFO lang="*" label="Text"/>
       </LANGINFOS>
 
       <CMS_INPUT_TEXT name="headline" useLanguages="no">
         <LANGINFOS>
           <LANGINFO lang="*" label="Headline"/>
           <LANGINFO lang="DE" label="Überschrift"/>
         </LANGINFOS>
       </CMS_INPUT_TEXT>
 
       <FS_MARKDOWN name="markdown">
         <LANGINFOS>
           <LANGINFO lang="*" label="Text"/>
         </LANGINFOS>
       </FS_MARKDOWN>
 
     </CMS_GROUP>
 
     <CMS_GROUP name="picture">
       <LANGINFOS>
         <LANGINFO lang="*" label="Picture"/>
         <LANGINFO lang="DE" label="Bild"/>
       </LANGINFOS>
 
       <FS_INDEX name="picture">
         <LANGINFOS>
           <LANGINFO lang="*" label="Picture"/>
           <LANGINFO lang="DE" label="Bild"/>
         </LANGINFOS>
         <SOURCE name="FirstSpiritMediaAccess/Connector"/>
       </FS_INDEX>
 
       <CMS_INPUT_TOGGLE name="toggle">
         <LANGINFOS>
           <LANGINFO lang="*" label="Alignment"/>
           <LANGINFO lang="DE" label="Ausrichtung"/>
         </LANGINFOS>
         <OFF>
           <LANGINFO lang="*" label="Right"/>
           <LANGINFO lang="DE" label="Rechts"/>
         </OFF>
         <ON>
           <LANGINFO lang="*" label="Left"/>
           <LANGINFO lang="DE" label="Links"/>
         </ON>
       </CMS_INPUT_TOGGLE>
 
     </CMS_GROUP>
 
   </CMS_GROUP>
 
</CMS_MODULE>

Attribute:

• name: Über dieses optionale Attribut kann ein technischer Bezeichner für die Gruppierung angegeben werden.
  Anders als Bezeichner von Eingabekomponenten (ebenfalls Attribut name) muss der Bezeichner für CMS_GROUP innerhalb eines Formulars nicht eindeutig sein.
• tabs: Standardmäßig werden Gruppierungen mit Rahmen untereinander dargestellt. Um sie auf einzelnen Registern darzustellen, kann tabs="top" verwendet werden.
• scrollable: Mit diesem optionalen Attribut kann festgelegt werden, ob Scrollleisten dargestellt werden sollen oder nicht.
  Mögliche Werte sind:
  fixed: Keine Scrollleisten verwenden.
  vertical: Vertikale Scrollleisten verwenden.
  horizontal: Horizontale Scrollleisten verwenden.
  both: Horizontale und vertikale Scrollleisten verwenden.
• height: Mit diesem optionalen Attribut kann die Anzeigehöhe der Gruppierung in Pixeln festgelegt werden.
  Wird der Parameter nicht angegeben, orientiert sich die Höhe an den enthaltenen Eingabekomponenten.
• LANGINFOS / LANGINFO: Mithilfe dieser Tags wird die Beschriftung definiert.
  Werden diese Tags nicht angegeben, wird keine Beschriftung an der Gruppierung dargestellt.

Hinweis: Die Werte left, bottom und right für das Attribut tabs, mit denen die Reiter im SiteArchitect links, rechts oder unten dargestellt werden können, werden für die Darstellung im FragmentCreator nicht berücksichtigt.

„FirstSpirit Content Experience Tools“ (CXT) erlaubt die Referenzierung von Elementen aus anderen Projekten (sog. „Remote“-Projekte): Fragmente, Medien und Seitenreferenzen. Dazu werden die Module „FirstSpirit Fragment DAP“ (fragmentdap-[version].fsm) , „FirstSpirit Media DAP“ (mediadap-[version].fsm) bzw. „FirstSpirit PageRef DAP“ (pagerefdap-[version].fsm) verwendet.

Bei einer Generierung eines FirstSpirit-Projektes, in dem Elemente über diese Module referenziert sind, wird jetzt der freigegebene Stand des referenzierten Elements berücksichtigt.
Zuvor musste im generierenden FirstSpirit-Projekt erst eine neue Revision erzeugt werden, damit (freigegebene) Änderungen der dort referenzierten Remote-Fragmente bei einer Generierung berücksichtigt wurden.

Aufgrund dieser Änderung können jetzt keine historischen Stände der referenzierten Elemente mehr generiert werden (per

context.setStartTime(<Datum in der Vergangenheit>);

in einem dem Generierungsauftrag vorgeschalteten Skript).

Folgende Module und Erweiterungen sind kompatibel mit FirstSpirit 2021-03:

Für Seitenreferenzen, die auf Seiten mit eingebundener Datenquelle verweisen, kann das Ausgabeverhalten der Datenbankinhalte auf der Seite beeinflusst werden. Bei der Auswahl der Seitenreferenz im FirstSpirit SiteArchitect wird dazu im Bearbeitungsbereich, neben den Registern für die Projektsprachen, das Register „Daten“ angezeigt.

Einstellung auf Seitenreferenzebene (Register Daten)

Über die Einstellung „Variable für Text der Menü-Übersicht (Sitemap)“ kann eine Spalte aus der Datenquelle ausgewählt werden. Der Inhalt dieser Spalte wird dann für die Darstellung/Beschriftung der referenzierten Seite in einer Sitemap ausgegeben (siehe Dokumentation: Einstellungen auf Seitenreferenzebene). Diese Einstellung kann verwendet werden, um die Ausgabe von Seitenreferenzen in einer Menü-Übersicht, in Seitengruppen, auf Mehrfachseiten („multiPages“) oder für eine Navigation dynamisch zu gestalten (siehe z. B. Dokumentation: Navigation/multiPages).

Neues Verhalten:

Für die Einstellung „Variable für Text der Menü-Übersicht (Sitemap)“ können ab FirstSpirit 2021-03 auch Datenbankinhalte ausgewählt werden, deren Werte in FirstSpirit in komplexen Eingabekomponenten gepflegt werden (z. B. CMS_INPUT_DOM). Das FirstSpirit Framework versucht dabei, automatisch nur die in diesem Kontext relevanten Werte auszugeben. Das bedeutet, dass beispielsweise für den Wert einer Eingabekomponente vom Typ CMS_INPUT_DOM, die Formatierungen automatisch entfernt und nur der reine Text ausgegeben wird.

Einschränkungen:

• Die Verwendung komplexer Eingabekomponenten ist nur möglich, wenn diese auf eine FirstSpirit Editor-Spalte des entsprechenden Datensatzes abgebildet werden.
• Wird ein Feld über eine Fremdschlüsselbeziehung ausgewählt, so wird, wie bisher, der unveränderte Inhalt des Felds aus der Datenbank ausgegeben. Wir empfehlen, in diesem Fall nur einfache Text-Eingabekomponenten zu verwenden.
• Bitte beachten Sie, dass bei der Verwendung eines entsprechenden URL Creators (z. B. Advanced URLs) die Einstellung auch für den Dateinamen der entsprechenden Seite verwendet wird. Es muss sichergestellt werden, dass die Inhalte nicht die zulässigen Grenzen des Dateisystems für Dateinamen überschreiten, ansonsten werden die Dateien nicht erzeugt. Bei der Generierung wird in diesem Fall der Fehler java.io.FileNotFoundException:...(File name too long) protokolliert.

Bisheriges Verhalten:

Bisher wurde der unveränderte Inhalt des Felds aus der Datenbank ausgegeben, was nur für Eingabekomponenten sinnvoll ist, die reinen Text speichern (z. B. CMS_INPUT_TEXT).

Im Rahmen der ersten Vorarbeiten für die geplante Umstellung des FirstSpirit Bytecode-Levels von Java 8 auf Java 11, werden aktuell intern verwendete Java-Funktionalitäten angepasst und ersetzt. Mit der internen Umstellung von AWTUtilities auf Standard-Java-API wurde mit FirstSpirit 2021-03 auch ein bestehendes Darstellungsproblem in FirstSpirit unter Java 11 behoben. In den Java-basierten FirstSpirit Desktop Apps (SiteArchitect, ServerManager) werden Dialoge (z. B. Dialog Hilfe / Über FirstSpirit) nun wieder mit transparenten Rahmen dargestellt.

Im Rahmen der Produktpflege wurde der Support für Java 8 mit FirstSpirit 2020-06 eingestellt. Dabei wurden auch die im Modul „FirstSpirit Launcher JRE“ enthaltenen Java-Versionen für Oracle Java 8 und AdoptOpenJDK 8 entfernt.

Ältere Versionen des Moduls „FirstSpirit Launcher JRE“ konnten jedoch weiterhin zusammen mit einer aktuellen Version des FirstSpirit Launchers zum Starten der FirstSpirit Desktop Apps (SiteArchitect, ServerManager) eingesetzt werden. Wurde in dieser älteren Modulversion die Option „Java 8“ ausgewählt, so war diese Konfiguration weiterhin möglich.

Mit der aktuellen Version 1.0.38 des FirstSpirit Launchers wurde diese Möglichkeit (aufgrund einer Inkompatibilität zu Java 16+) nun ausgebaut. Eine entsprechende Konfiguration (aktueller Launcher, älteres Modul „FirstSpirit Launcher JRE“ mit Java 8) führt dazu, dass die FirstSpirit Desktop Apps nicht mehr starten. Diese Anpassung ist notwendig, um OpenJDK 16 (non-LTS; Release Date 2021-03) für die Verwendung mit FirstSpirit (für den FirstSpirit-Server und die FirstSpirit Desktop Apps) freizugeben. Diese Freigabe ist für FirstSpirit 2021-04 geplant.

Sind Anpassungen an das neue Verhalten notwendig?

Sollte es zu Problemen beim Starten der FirstSpirit Desktop Apps (SiteArchitect, ServerManager) kommen, prüfen Sie bitte, ob über das Modul „FirstSpirit Launcher JRE“ noch der Start über Java 8 konfiguriert ist. In diesem Fall sollte die alte Konfiguration entfernt werden.

Mit dem aktuellen FirstSpirit-Release wurde folgende intern verwendete Software aktualisiert:

ASM (Bibliothek für die Analyse und Modifikation von Java-Bytecode)

Aktualisierung von Version 9.0 auf Version 9.1.