Release Notes

e-Spirit unterstützt für das Produkt FirstSpirit:

• 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.

Mit FirstSpirit 2020-11 wird OpenJDK 15 (non-LTS; Release Date 2020-09) für die Verwendung mit FirstSpirit (für den FirstSpirit-Server und die FirstSpirit-Desktop-Anwendungen) freigegeben.

AdoptOpenJDK 15 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 15 gestartet werden. (Dokumentation zum Modul FirstSpirit Launcher JRE siehe entsprechende Dokumentation).

Mit der Freigabe der Unterstützung von OpenJDK 15 erlischt gleichzeitig die Unterstützung für OpenJDK 14 (non-LTS; Release Date 2020-03).

FirstSpirit wird mit OpenJDK 14 voraussichtlich weiter funktionsfähig bleiben. Es werden aber seitens der e-Spirit AG weder Tests mit OpenJDK 14 ausgeführt noch FirstSpirit-Probleme behoben, die ausschließlich im Zusammenhang mit der Verwendung von OpenJDK 14 auftreten.

Aktueller Status: Für FirstSpirit 2020-11 sind damit die folgenden JDKs kompatibel:

• OpenJDK 15 (in der aktuellen Version) (non-LTS) (*)
• OpenJDK 11 (in der aktuellen Version) (LTS) (*)
• Oracle Java 11 (in der aktuellen Version) (LTS)

(*) Empfohlen: Verwendung der OpenJDK-Distribution AdoptOpenJDK (HotSpot JVM)

Weiterführende Dokumentation siehe FirstSpirit: Technische Voraussetzungen und Empfehlungen.

Bilder sind wichtig für jede Internetpräsenz, um Inhalte anschaulich und emotional vermitteln zu können. Oft muss angeliefertes Bildmaterial aber erst zugeschnitten werden, damit es optimal für die Webseite genutzt werden kann: Sei es, dass die Proportionen der Ausgangsbilder nicht zu den Proportionen und Größen passen, die für die Internetpräsenz benötigt werden. Oder bei Bildern mit mehreren Motiven bzw. Objekten möchte der Redakteur einen bestimmten Ausschnitt in den „Mittelpunkt“ rücken. Dies kann erheblichen manuellen Aufwand bedeuten. Nicht zuletzt, wenn mit unterschiedlichen Formaten (in der FirstSpirit-Welt: „Auflösungen“) gearbeitet wird und auch für unterschiedlich Formate unterschiedliche Ausschnitte erzeugt werden sollen.

Die neue ContentCreator-Funktionalität „SmartCropping“ unterstützt Redakteurinnen und Redakteure mit intelligenter Technik dabei, mit nur wenigen Klicks einen passenden Ausschnitt gleichzeitig für alle Auflösungen eines Bildes zu finden und zu bestimmen. Dazu wird anhand eines Bereichs, den der Redakteur im Bild als Hauptmotiv per Auswahlrahmen bestimmen kann („Fokusbereich“), für jede Auflösung automatisch ein passender Zuschnitt berechnet. Dabei wird der „Goldene Schnitt“ berücksichtigt: Dieser sorgt dafür, dass die Bildkomposition organisch und harmonisch proportioniert wirkt statt starr und konstruiert.
Die Bedienung durch Redakteure ist intuitiv, da das Ergebnis eines Zuschnitts direkt sichtbar und prüfbar ist und sich einfach wieder zurücksetzen lässt.

Mit FirstSpirit 2020-07 startete die Ramp-Up-Phase für die neue Funktionalität „Smart Cropping“. Seitdem konnte die Funktionalität von ausgewählten Kunden und Partnern getestet werden.
Mit FirstSpirit 2020-10 konnte die Funktionalität durch Erweiterung der Datei fs-server.conf um einen Konfigurationsparameter aktiviert und ebenfalls getestet werden.
Mit dem aktuellen Release steht die Funktionalität jetzt standardmäßig allen Kunden und Partnern in allen Projekten zur Verfügung.

Sie ist im ContentCreator erreichbar über das Icon

auf Bildern in der Medien-Verwaltung oder (bei entsprechender Konfiguration, „editorId“) auf Bildern in der Vorschau.

Wie bisher werden standardmäßig die Auflösungen zu einem Bild automatisch vom System berechnet. Sie werden mit diesem Icon markiert:

Bei Mouseover wird die Leiste der Bearbeitungsoptionen oberhalb des Bildes eingeblendet.

Passende Bildbereiche für alle automatisch berechneten Auflösungen können folgendermaßen festgelegt werden:

• Im Bild mit dem Mauszeiger einen Rahmen über dem Hauptmotiv aufziehen.
• Weitere Rahmen zeigen für eine grobe Prüfung an, wie sich der Zuschnitt für die anderen Auflösungen auswirkt.
• Den Rahmen so verschieben, vergrößern/verkleinern, dass für alle Auflösungen ein passender Bereich gewählt wird.
• Mit dem Blickwinkel-Anfasser können die automatisch berechneten Zuschnitte auf Basis des Fokusbereichs in eine bestimmte Blickrichtung erweitert werden.
• Ist das Ergebnis für alle Auflösungen wie gewünscht, kann es gespeichert werden.

Für eine Feinabstimmung kann für jede Auflösung die Auswirkung einzeln geprüft werden.
Dazu den Mauszeiger einfach über die gewünschte Auflösung halten.
Mit einem Klick wird die Auflösung gewählt. Für diese kann dann ein passender Bereich manuell per Rahmen gewählt werden („Manueller Zuschnitt“).

Zurücksetzen lassen sich Zuschnitte einfach durch die Icons

Liste der Auflösungen

oder

Bearbeitungsoptionen am Bild (Mouseover)

Hinweis
Aktuell kann beim Zuschnitt sprachabhängiger Bilder die zu bearbeitende Sprache nicht direkt ausgewählt werden. Dieser Fehler wird mit dem nächsten FirstSpirit-Release behoben.

Weiterführende Dokumentation:

• für Redakteure: „Dokumentation ContentCreator“, Seite Bildausschnitt bearbeiten
• für Administratoren: „Dokumentation für Administratoren“, Seite Auflösungen

Migrationshinweis: Wurde mit FirstSpirit 2020-10 der Parameter webedit.eap.focuscrop=true in der Konfigurationsdatei fs-server.conf bzw. im FirstSpirit ServerMonitoring gesetzt, sollte dieser mit FirstSpirit 2020-11 wieder entfernt werden. Er wird nicht mehr benötigt.

Ausblick: Spezielle Online-Dienste (z. B. von Google, Amazon, Microsoft) ermöglichen heute bereits eine automatische Erkennung von Objekten auf Bildern. Aktuell entwickelt e-Spirit ein FirstSpirit-Modul, die eine Verwendung dieser automatischen Erkennung mit dem Bildzuschnitt im ContentCreator ermöglicht. Zuschnitte auf Basis einer web-basierten Bilderkennung könnten dann auch schon direkt bei einem Upload nach FirstSpirit erzeugt werden. Im Idealfall ist dann keine Aktion durch den Redakteur mehr erforderlich.

Datensätze können jetzt im ContentCreator auch dem „Suche“-Report heraus bearbeitet werden. Damit wird ein direkteres Bearbeiten von Datensätzen möglich, speziell für Datensätze, die nicht über die Navigation erreicht werden können („Content Projektion“).

Dazu steht folgendes Icon zur Verfügung:

Datensatz in einem Such-Report

Änderungen an einem Datensatz spiegeln sich in der Anzeige im Such-Report erst nach einem Aktualisieren des Reports wider.

FirstSpirit ermöglicht den Zugriff aus einem Projekt auf andere Projekte (sogenannte „Remote-Projekte“), die sich auf demselben FirstSpirit-Server befinden. Auf diese Weise können beispielsweise Objekte (z. B. Medien), die in einem zentralen Projekt verwaltet werden, von verschiedenen Projekten (auch „Zielprojekte“ genannt) verwendet werden. Die Objekte werden in den Zielprojekten dabei lediglich referenziert, verbleiben physikalisch aber im Remote-Projekt.

Die Vorteile:

• Kein zusätzlicher Speicherbedarf für Medien, die in mehreren Projekten verwendet werden.
• Vereinfachte Aktualisierung und Verwaltung, da alle Medien in einem zentralen Medienprojekt liegen.
• Verkürzte Generierungszeit für die beteiligten Zielprojekte.

Mit dem aktuellen Release können bei entsprechender Projektkonfiguration jetzt auch Medien aus anderen Projekten („remote“) in der Medien-Verwaltung im ContentCreator bearbeitet werden.

Die zur Verfügung stehenden Projekte werden oberhalb der Medien-Verwaltung horizontal angezeigt:

Medien-Verwaltung mit Remote-Projekten

Das gewünschte Projekt kann per Klick ausgewählt werden. Das jeweils aktuell ausgewählte Projekt wird in blauer Schriftfarbe und unterstrichen dargestellt.

Die aus anderen Projekten dargestellten Medien und Ordner können analog zu denen im aktuellen Projekt („lokal“) bearbeitet werden.
Ausnahmen:

• Es können keine Lesezeichen auf Elemente aus Remote-Projekten gesetzt werden.
• Arbeitsabläufe für Remote-Medien-Projekte werden aktuell noch nicht unterstützt.
• Elemente können innerhalb eines Projektes verschoben werden, nicht aber in andere Projekte.

Im Rahmen dieses Features wurde auch das Design und weitere Funktionalität der Medien-Verwaltung marginal überarbeitet:

• Die Darstellung der Elemente wurde überarbeitet. U.a. sind jetzt weitere Darstellungsmodi möglich.
  
  
  
• Es gibt jetzt Anfasser zum Verschieben von Ordnern.
  
  
  

Hinweis: Die Nutzung von Remote-Projekten erfordert eine gültige Lizenz.

Um ein versehentliches Verschieben zu unterbinden, wird zum Verschieben von Elementen im Navigationsbaum jetzt ein Anfasser-Icon eingesetzt. Dieses wird eingeblendet, wenn der Mauszeiger über ein entsprechendes Element gehalten wird:

Anfasser zum Verschieben einer Seite

Das per Anfasser gewählte Element kann wie bisher mit gedrückter Maustaste verschoben und an der gewünschten Position durch Loslassen in die Struktur eingefügt werden. Anhand dieses Icons lässt sich – auch während des Verschiebe-Vorgangs – genau erkennen, welches Element verschoben wird.

Dies gilt für alle aktuell verschiebbaren Elemente auf den Registern „Navigation“ und „Seite“, also für Seiten, Menüebenen und Absätze.

Seit FirstSpirit 2020-08 kann mithilfe des Parameters cxt.platform.csrf-samesite die Konfiguration des Attributs SameSite von Cookies für das MicroApp Framework vorgenommen werden. Standardwert war bisher Unset, was bedeutet, dass das Attribut für das Cross-Site-Cookie standardmäßig nicht gesetzt wurde.
Um eine Kommunikation zwischen MicroApp-API und FragmentCreator zu ermöglichen, wenn diese auf unterschiedlichen Domains liegen (beispielsweise für die Integration von kundenspezifischen MicroApps), musste explizit der Wert None gesetzt werden (cxt.platform.csrf-samesite=None).

Diese Konfiguration (SameSite=None) erfordert allerdings eine HTTPS-Verbindung, HTTP ist nicht erlaubt.
Mit dem aktuellen Release wird daher jetzt bei Verwendung von HTTPS-Verbindungen standardmäßig das entsprechende Cookie (XSRF) und SameSite=None gesetzt. Damit ist bei Verwendung von HTTPS keine manuelle Konfiguration des Parameters cxt.platform.csrf-samesite mehr erforderlich.

Bei Verwendung von HTTP wird das Cookie nicht gesetzt und der CSRF-Schutz vollständig deaktiviert.

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

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

Über das „PageRef Access Plugin“ (PageRef DAP, Modul-Dateiname: pagerefdap-[version].fsm) können Seiten referenziert werden.
Die durch den Nutzer gewählten Referenzen auf Seiten können als HTML-Verweise ausgegeben werden.

Mit dem aktuellen Release wird jetzt auch der Aspekt UrlSupporting (Package de.espirit.firstspirit.client.plugin.dataaccess.aspects, FirstSpirit Developer-API) durch das PageRef DAP unterstützt.

Mittels diesem kann ein URL-String für ein Objekt, das aus dem PageRef DAP stammt, ermittelt werden. Dazu wird ein UrlGenerationContext übergeben. Dieser gewährt u.a. Zugriff auf den zu verwendenden URL-Creator (Provider), die Sprache und den Bearbeitungsstand des Objekts (freigegeben bzw. nicht freigegeben).

Dies kann z. B. im Markdown-Editor „Quill“ eingesetzt werden, um Text mit Seiten (beispielsweise aus einem anderen FirstSpirit-Projekt) zu referenzieren, und zwar über das Icon

Code-Beispiel:

<FS_MARKDOWN name="text" useLanguages="no">
    <DATALINKSOURCES>
      <DATALINKSOURCE name="Pages"
          plugin="FirstSpiritPageRefAccess/PageRefConnector">
           <PROJECT remote="pageref"/>
      </DATALINKSOURCE>
      <DATALINKSOURCE name="Media" 
          plugin="FirstSpiritMediaAccess/Connector">
        <LANGINFOS>
          <LANGINFO lang="*" label="Media"/>
        </LANGINFOS>
      </DATALINKSOURCE>
    </DATALINKSOURCES>
    <LANGINFOS>
      <LANGINFO lang="*" label="Content"/>
      <LANGINFO lang="DE" label="Inhalt"/>
    </LANGINFOS>
</FS_MARKDOWN>

Text in Markdown mit einer Seite referenzieren

Ausgabe / JSON
Attribut url:
Bei der JSON-Erzeugung der betreffenden FS_INDEX Eingabekomponente wird jetzt auch bei Verwendung eines PageRef DAP das Attribut url zurückgeliefert.
Es beinhaltet die aufgelöste URL der durch den User gewählte Seite.

Attribut dataLinks: Die Verlinkung / die Referenz wird über ein spezielles, intern verwendetes Link-Schema abgebildet:

dap://{linkSource}/{objectId}

• dap://: URI-Schema/Protokoll
• {linkSource}: Bezeichner der DAP-Konfiguration in der Markdown-Komponente (Attribut name im Tag DATALINKSOURCE)
• {objectId}: Bezeichner des vom Redakteur gewählten DAP-Objekts

Die hier über geschweifte Klammern angegebenen Werte sind URL-encoded. Aufgelöst könnte ein Beispiel folgendermaßen aussehen:

dap://pageref/%7B%22uid%22%3A%22produkte_7%22%2C%22type%22%3A%22SITESTORE_LEAF
   %22%2C%22remote%22%3A%22pageref%22%7D

Darüber hinaus wurde in diesem Kontext ein Fehler behoben, der dazu führte, dass Referenzen aus Remote-Projekten beispielsweise im Referenzgraph nicht korrekt dargestellt wurden.

Weiterführende Informationen

• Modul Markdown-Editor
• Konfiguration der Eingabekomponente FS_MARKDOWN
• Allgemeines zur JSON-Ausgabe

Mit dem aktuellen FirstSpirit-Release wurden die im Modul „FirstSpirit Launcher JRE“ enthaltenen Java-Versionen aktualisiert:

Neben der mit dem FirstSpirit Launcher ausgelieferten Version, AdoptOpenJDK 11.0.8+10 (Default) ist aktuell folgende Java-Variante verfügbar:

• AdoptOpenJDK 15+36 (Neu)

AdoptOpenJDK 14.0.2+12 wurde aus dem Modul „FirstSpirit Launcher JRE“ entfernt.

Dokumentation zum Modul „FirstSpirit Launcher JRE“ siehe entsprechende Dokumentation.

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 8.0.1 auf Version 9.0.

Mit FirstSpirit 2020-08 wurden die neuen verbesserten Steuerungsdateien für Windows- und Linux-Betriebssysteme freigegeben und für den Einsatz in produktiven Umgebungen empfohlen.

Wie bereits in den Release Notes zu FirstSpirit 2020-08 angekündigt, werden die alten Steuerungsdateien zukünftig entfallen. Geplant ist der Entfall des Supports mit FirstSpirit 2021-02 (siehe „Abkündigungen“). Aufrufe dieser Steuerungsdateien und Funktionen in Ihrer Anwendung, die von ihnen abhängen, können nach einer Aktualisierung auf FirstSpirit 2021-02 möglicherweise nicht mehr funktionieren.

e-Spirit empfiehlt folgendes Vorgehen:

• Alle Neuinstallation sollten ausschließlich mit den neuen Steuerungsdateien durchgeführt werden.
• Alle bestehenden Installationen, die noch die alten Steuerungsdateien verwenden, sollten bis Januar 2021 auf die neuen Steuerungsdateien aktualisiert werden.

Bereitstellung und Voraussetzungen für den Einsatz der neuen Steuerungsdateien: Voraussetzungen für den Betrieb eines FirstSpirit-Servers sind Java und der Java Service Wrapper. Der Java Service Wrapper und zugehörige Steuerungsdateien werden von e-Spirit über:

• das Installationsarchiv (für Neuinstallationen) bzw.
• das Aktualisierungsarchiv (für bestehende Installationen) bereitgestellt.

Beide Archive sind per Download erhältlich (für Zugangsdaten wenden Sie sich bitte an den Technical Support).

Steuerungsdateien im Installations- bzw. Aktualisierungsarchiv:

• Neu: fs-server (für Linux)
• Neu: fs-server.bat (für Windows)
• Alt: fs5 (für Linux) (entfällt demnächst)
• Alt: fs5.cmd (für Windows) (entfällt demnächst)

Um die neuen Steuerungsdateien verwenden zu können, ist ein Update des Tanuki Java Service Wrappers auf Version 3.5.42 notwendig. Diese Wrapperversion ist im aktuellen Installations- und Aktualisierungsarchiv enthalten.

Für eine Neuinstallation folgen sie bitte der Anleitung Installation per Installationsarchiv.

Für die Aktualisierung einer bestehenden Installation folgen sie bitte der Anleitung Aktualisierung des FirstSpirit-Backends.

Der FirstSpirit Server kann anschließend über die neuen Steuerungsdateien fs-server (für Linux) oder fs-server.bat (für Windows) gestartet werden.

Weiterführende Informationen zum Funktionsumfang und zur Steuerung siehe:

• Steuerung des FirstSpirit-Servers (Linux)
• Steuerung des FirstSpirit-Servers (Windows)