Release Notes

Ein FirstSpirit Dienst ist eine Server-Komponente, die über eine öffentliche Schnittstelle aus Eingabekomponenten oder Skripten angesprochen werden kann.

Starten und Stoppen von Diensten

Dienste können automatisch beim Start des Servers mitgestartet werden:

• per Autostart-Option im ServerManager oder
• per Autostart-Option im ServerMonitoring oder
• über die Konfiguration des Parameters SERVICES in der Konfigurationsdatei fs-server.conf

Dienste können auch jederzeit manuell gestartet bzw. gestoppt werden:

• per Dienst starten / Dienst stoppen im ServerManager
• per Dienst starten / Dienst stoppen im ServerMonitoring

Neue Konfigurationsmöglichkeit für den automatischen Start aller Dienste

Für den automatischen Start von Diensten wird mit dem aktuellen FirstSpirit Release eine neue Möglichkeit bereitgestellt. Über den Parameter SERVICES innerhalb der Konfigurationsdatei fs-server.conf kann nun das Zeichen * verwendet werden:

SERVICES=*

In diesem Fall startet der FirstSpirit-Server beim Serverstart automatisch alle auf dem Server installierten Dienste, d.h.:

• FirstSpirit-eigene Systemdienste, wie z. B. den Permission-Service und
• Dienste, die über ein Modul auf dem FirstSpirit-Server installiert wurden

Vorteil: Es können keine Dienste vergessen oder übersehen werden, die dann im Folgebetrieb (nach dem Serverstart) zu Problemen führen würden.

Ist nicht gewünscht, dass alle Dienste automatisch gestartet werden, empfiehlt e-Spirit, die zu startenden Dienste über die Autostart-Option im ServerManager oder die Autostart-Option im ServerMonitoring zu aktivieren.

In seltenen Fällen kann es notwendig sein, dass nicht alle Umgebungsvariablen, die im Betriebssystem definiert wurden, an die Java VM des Launchers weitergereicht werden. Diese speziellen Sonderfälle können nun in der Datei ~/AppData/Local/Programs/FSLauncher/FSLauncher.vmoptions über den neuen Parameter
-DclientEnvironmentVariablesIgnoreList konfiguriert werden. Hierbei werden alle Umgebungsvariablen, die nicht an die Java VM des Launchers weitergereicht werden sollen, in einer kommaseparierten Liste angegeben.

Beispielkonfiguration:

-DclientEnvironmentVariablesIgnoreList=JAVA_TOOL_OPTIONS,_JAVA_OPTIONS,IBM_JAVA_OPTIONS

Wird der Parameter nicht angegeben, so werden alle Umgebungsvariablen an die Java VM weitergegeben.

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.

Das sind für die aktuelle FirstSpirit-Version:

• Oracle Java 11 (in der aktuellen Version)
• OpenJDK 14 (in der aktuellen Version)
• OpenJDK 11 (in der aktuellen Version)

Im September 2020 startete e-Spirit die Testphase für den Einsatz von OpenJDK 15 (non-LTS; Release Date 2020-09) mit FirstSpirit. Dabei werden die FirstSpirit-Desktop-Anwendungen (SiteArchitect, ServerManager) und der FirstSpirit-Server intensiven internen Tests unterzogen. Im Vergleich zu vorherigen Versionsaktualisierungen erfordert OpenJDK 15 umfassende Änderungen. Aktuell gehen wir davon aus, OpenJDK 15 mit FirstSpirit-Version 2020-11 für die Verwendung mit FirstSpirit freizugeben.

Mit der Freigabe der Unterstützung von OpenJDK 15 wird gleichzeitig die Unterstützung für OpenJDK 14 (non-LTS; Release Date 2020-03) entfallen. (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).

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

Mit dem aktuellen Release können im ContentCreator Funktionen projektweise ausgeblendet werden, wie z. B. einzelne Icons in der Vorschau zur Bearbeitung von Absätzen, Menü-Funktionen wie „Neue Seite anlegen“ oder Reports.

Auf diese Weise können Funktionen, die nicht benötigt werden oder nicht verwendet werden sollen, für ein Projekt komplett außer Kraft gesetzt werden. Dadurch lässt sich die Oberfläche des ContentCreator je nach Projektanforderung übersichtlicher und für den Anwender einfacher bedienbar gestalten. Auch Fehlbedienung kann durch das Ausblenden von Funktionen einfach minimiert bzw. unterbunden werden.
Ebenso können Standardfunktionen einfacher durch kundenspezifische Implementierungen mit eigenen Logiken bzw. eigener Benutzerführung ersetzt werden, die sich so harmonischer in die Oberfläche des ContentCreator einfügen.

Ausgeblendete Funktionen: Menüleiste

Ausgeblendete Funktionen: Reports

Die Konfiguration der auszublendenden Aktionen erfolgt über ein Systemmodul („FirstSpirit CXT ContentCreator Extension“), das standardmäßig mit FirstSpirit ausgeliefert wird.
Um die Funktion nutzen zu können, muss sie über den FirstSpirit ServerManager aktiviert werden:

1) Unter „Server-Eigenschaften / Web-Applikationen“ / Register „ContentCreator“:

Hinzufügen der Web-Komponente

CXT ContentCreator Extension: WebApp for ContentCreator

Gibt es projektlokale ContentCreator-Instanzen, muss die Web-Komponente auch dort hinzugefügt werden.
(„Projektlokale ContentCreator-Instanz“ = auf dem Register „ContentCreator“ unter „Projekt-Eigenschaften / Web-Komponenten“ ist ein Webserver konfiguriert.)
Das Hinzufügen zu einer projektlokalen ContentCreator-Instanz erfolgt unter „Projekt-Eigenschaften / Web-Komponenten“ / Register „ContentCreator“.

2) Unter „Projekt-Eigenschaften / Projekt-Komponenten“:

Hinzufügen der Projekt-Komponente

CXT ContentCreator Extension: Feature Configuration

Über diese Projekt-Komponente kann die Verfügbarkeit von Funktionen über eine Liste konfiguriert werden. Grundsätzlich enthält die Liste die Standardfunktionen des ContentCreator:

Dabei sind Funktionen zu unterscheiden, die über eine grafische Repräsentation verfügen (z. B. Icon, Button, Menüeintrag...) oder nicht (z. B. Aktivieren von InEdit per Strg + Klick, Verschieben von Ordnern in einer Baumansicht, Upload von Medien per Drag-and-drop...)

Um eine Funktion zu deaktivieren (bzw. zu aktivieren), kann sie über das Suchfeld gesucht werden.
Zuoberst in der Liste werden Funktionen angezeigt, deren Standardverfügbarkeit verändert wurde. Diese Funktionen können auch mithilfe der Checkbox „Show only modified Features“ gefiltert werden.

Funktionen, deren Standardverfügbarkeit nicht verändert wurde, werden für eine bessere Übersicht nach Gruppen sortiert angezeigt.
Folgende Standardgruppen gibt es:

• MediaManagement (Medien-Verwaltung)
• Navigation (Navigationsleiste)
• Preview (Vorschau: EasyEdit, InEdit, ...)
• Report (Reportleiste)
• Status (Statusanzeige)
• StoreTree (Baumansicht, z. B. in der Navigationsleiste oder in der Medien-Verwaltung)
• Toolbar (Menüleiste)

Über „Edit“ bzw. Doppelklick auf eine Funktion öffnet sich ein Fenster, in dem die Verfügbarkeit konfiguriert werden kann:

• Available: Die Funktion ist verfügbar und kann verwendet werden.
• Unavailable: Die Funktion ist nicht verfügbar und kann nicht verwendet werden.
  Funktionen mit grafischer Repräsentation werden dazu aus der Oberfläche ausgeblendet.
  Bei der Verwendung von Funktionen ohne grafische Repräsentation wird eine entsprechende Meldung im ContentCreator angezeigt, dass die betreffende Funktion deaktivert ist.
• Default Availability: Für diese Funktion gilt die Standardeinstellung.
• Disabled: Funktionen mit grafischer Repräsentation werden weiterhin in der Oberfläche angezeigt, sind aber ausgegraut dargestellt und können nicht verwendet werden.
  Bei der Verwendung von Funktionen ohne grafische Repräsentation wird eine entsprechende Meldung im ContentCreator angezeigt, dass die betreffende Funktion deaktiviert ist.
  Diese Option überschreibt die Einstellung der zuvor genannten Optionen, d.h. auch wenn eine Funktion verfügbar ist, kann sie nicht verwendet werden, wenn Disabled gesetzt ist.

Darüber hinaus kann auch die Verfügbarkeit von Funktionen, die aus kundenspezifischen Modulen stammen, konfiguriert werden.
Aktuell betrifft dies Module, die das Interface de.espirit.firstspirit.client.plugin.ItemsPlugin (FirstSpirit Developer-API) implementieren. In Zukunft wird die Konfigurierbarkeit aber auch auf Funktionen aus anderen Modul-/Plugin-Typen ausgeweitet.
Über „Add“ öffnet sich folgendes Fenster:

• Group: Optionale Angabe einer Gruppe, zu der die Funktion gehört. Aktuell wird dies nur für Standardfunktionen des ContentCreator unterstützt, daher sollte dieses Feld aktuell nicht ausgefüllt werden.
• Identifier: Hier muss ein Identifier für die Funktion angegeben werden.
  Dieser wird entweder explizit über das optionale Interface ItemIdentifiable definiert (de.espirit.firstspirit.client.plugin.ItemIdentifiable, FirstSpirit Developer-API), oder es ist der Klassenname der Item-Implementierung (de.espirit.firstspirit.client.plugin.Item, FirstSpirit Developer-API).
• Plugin: Hier muss der Klassenname der Public-Komponente angegeben werden.
• Context: Hier muss der Kontext der betreffenden Funktion angegeben werden.
  Im Fall von Funktionen, die das Interface ItemsPlugin implementieren (de.espirit.firstspirit.client.plugin.ItemsPlugin, FirstSpirit Developer-API), handelt es sich bei Context um BaseContext (de.espirit.firstspirit.access.BaseContext, FirstSpirit Developer-AP), die dem Plugin als Kontext übergeben wird. Ansonsten ist Context zumeist Void („nicht vorhanden“).
  Die Dropdown-Liste bietet eine Auswahl aus bekannten Typen. Darüber hinaus können eigene Kontexte manuell eingegeben werden.

Die Verfügbarkeit kann über die oben beschriebenen Optionen konfiguriert werden (Available, Unavailable, Default Availability, Disabled).

Bei Bedarf können projektspezifische Funktionen auch wieder entfernt werden, und zwar über „Remove“.
Hinweis: Die im Lieferumfang des ContentCreator standardmäßig enthaltenen Funktionen können nicht entfernt werden.

Damit Änderungen an der Konfiguration im jeweiligen Projekt aktiv werden, müssen Redakteure das Projekt neu starten (z. B. über die Menüfunktion „Projekt wechseln“).

Im Rahmen dieser Funktionalität wurde neue API geschaffen. Diese wird zurzeit intern erprobt und wird erst mit einem kommenden Release für alle Kunden zur Verfügung gestellt und freigegeben.

Hinweis: Die Verfügbarkeit von Funktionen kann mithilfe dieses Moduls nur projektweise beeinflusst werden. Sollen Funktionen benutzer- oder bereichsspezifisch (z. B. für eine Seite oder einen Teilbaum) deaktiviert werden, muss dies über geeignete Rechte und / oder API umgesetzt werden.

Am linken Bildschirmrand des ContentCreator kann die Navigationsansicht eingeblendet werden.

Mit dem aktuellen Release kann nun auch im Bereich „Navigation“ die gewünschte Sprache ausgewählt werden:

Sowohl die Beschriftung der Baumelemente (Menüpunkte und Seiten) als auch die Inhalte der Vorschau und in den Reports werden in der über die Drop-down-Liste gewählte Sprache angezeigt.

Mit FirstSpirit 2020-07 startete die Ramp-Up-Phase für die neue ContentCreator-Funktionalität „SmartCropping“. Seitdem konnte die Funktionalität von ausgewählten Kunden und Partnern getestet werden.

Mit „SmartCropping“ entfällt das Prüfen und Bearbeiten von einzelnen Bildvarianten (in FirstSpirit: „Auflösungen“) beim Hochladen von neuen Bildern durch den Redakteur weitgehend: Durch intelligente Technik kann manuell gleichzeitig für alle Auflösungen eines Bildes ein passender Ausschnitt gewählt werden. 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“ angewendet: Dieser sorgt dafür, dass die Bildkomposition organisch und harmonisch proportioniert wirkt statt starr und konstruiert.

Mit dem aktuellen Release erweitert e-Spirit den User-Kreis, um weiteres Feedback und Erkenntnisse von Partnern und Kunden zu der Funktionalität einzuholen, die sich aus konkreten Anwendungsfällen ergeben.
Die Funktionalität an sich wurde bereits einer intensiven Qualitätssicherung unterzogen. Sie ist aber noch nicht offiziell freigegeben. Daher wird empfohlen, sie bei Interesse zunächst in einer Entwicklungsumgebung zu testen.

Um die Funktionalität zu aktivieren, muss folgender Eintrag in die Konfigurationsdatei fs-server.conf eingetragen werden:

webedit.eap.focuscrop=true

Damit wird die „SmartCropping“-Funktion auf dem gesamten Server aktiviert und steht in jedem Projekt zur Verfügung.

Die „SmartCropping“-Funktion 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)

Eine ausführlichere Dokumentation wird mit FirstSpirit 2020-11 zur Verfügung gestellt. Die Bedienung durch Redakteure ist intuitiv, da das Ergebnis eines Zuschnitts direkt sichtbar und prüfbar ist und sich wieder zurücksetzen lässt.

Für Fragen und Feedback wenden Sie sich gern an Ihren zuständigen Ansprechpartner.

FirstSpirit unterstützt konsequent das Konzept der Mehrsprachigkeit, das sich durch alle Aspekte von FirstSpirit zieht.
Dabei wird u.a. unterschieden zwischen

• Projektsprachen: Sprachen, für die von Redakteuren Inhalte erfasst und gespeichert werden sollen. In Elemente wie Absätzen, Datensätzen und Medien können sprachabhängige Inhalte erfasst werden, welche z. B. in verschiedenen Sprachvarianten auf einer Webseite ausgegeben werden können. Für die Erfassung dieser Inhalte kann in Formularen zwischen den Projektsprachen gewechselt werden.
  Projektsprachen werden definiert in den Projekteigenschaften (FirstSpirit ServerManager) im Bereich „Sprachen“.
• Redaktionssprachen: Sprache, die für die Beschriftung von Eingabeelementen in Formularen/Dialoge herangezogen wird.
  Redaktionssprachen werden definiert in den Projekteigenschaften (FirstSpirit ServerManager) im Bereich „Optionen“, „Konfiguration der Redaktionssprachen“.

An folgenden Stellen können im ContentCreator sprachabhängige Namen für Seiten vergeben werden:

• Funktion „Neue Seite anlegen“ in der Menüleiste
• Funktion „Umbenennen“ in der Navigationsleiste

Dialog "Neue Seite anlegen"

Navigationsleiste: "Umbenennen"

Mit dem aktuellen Release stehen dort jetzt alle Projektsprachen zur Verfügung. Zuvor konnte nur für die Redaktionssprachen Seitennamen vergeben werden.
In bestimmten Sprach-Konfigurationen konnte dies zu Problemen führen.
Fehlermeldung:

...
java.lang.IllegalArgumentException: invalid language 'ES'
...

Die Navigationsleiste bildet die Struktur-Verwaltung eines Projekts ab.
Wurde beim Umbenennen bisher der Name für Menüpunkt (technisch: „Menüebene“) und abhängige Seite (technisch: „Seitenreferenz“) gleichzeitig geändert, kann dies nun für jedes Element einzeln vorgenommen werden. Das bedeutet: Sollen Menüpunkt und Seite umbenannt werden, muss dies jetzt für beide Elemente getrennt vorgenommen werden. Zuvor war das Umbenennen von Menüpunkt oder Seite ausreichend.
Bei entsprechender Projektkonfiguration („Store Mapping“, siehe dazu auch Dokumentation für Administratoren) werden die Anzeigenamen der betreffenden Seiten in der Inhalte-Verwaltung ebenfalls umbenannt.

Das Kommandozeilenwerkzeug FSDevTools vereinfacht Export- und Import-Operationen zwischen einem FirstSpirit-Projekt und dem Dateisystem über vordefinierte Kommandos. Mit dem aktuellen FSDevTools-Release (Release 2.6.3) wird die Angabe einer Servlet Zone für Verbindung zum FirstSpirit Server unterstützt. Der Parameter:

--servletzone 

(Kurzform: -sz)

wird optional über die Kommandozeile übergeben.

Beispielaufruf:

fs-cli -h example.com -port 4242 -c HTTP -sz "/examplezone"  [...]

Logausgabe bei erfolgreichem Aufruf, z. B.:

User: userA
Host: example.com
Port: 4242
Servlet zone: /examplezone
Connection Mode: HTTP
Project: DevProject
Connection to FirstSpirit closed!
Execution time: 10.591s

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

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

Es wurde ein Fehler behoben, der dazu führte, dass bei Suchen im ContentCreator nur Datensatz-Inhalte gefunden wurden, die beim Start der ContentCreator-Sitzung bereits vorhanden waren. Änderungen an Datensätzen, die zu einem späteren Zeitpunkt in anderen Sitzungen durchgeführt wurden, wurden nicht berücksichtigt. Mit der aktuellen FirstSpirit-Version werden nun immer die zum Zeitpunkt der Suche korrekten Treffer zurückgeliefert.

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

Google Web Toolkit („GWT“, verwendet für den ContentCreator)
Aktualisierung von Version 2.8.2 auf 2.9.0

Apache FOP (Formatting Objects Processor)
Über das Modul fs-fop.fsm (für die Ausgabe von FirstSpirit-Inhalten im PDF-Format).
Aktualisierung von Version 2.4 auf Version 2.5.

Eclipse Jetty (im Modul fs-jetty.fsm / „FirstSpirit Jetty Service“ enthalten)
Aktualisierung von Version 9.4.28 auf Version 9.4.31

Pack200 für die Verwendung im FirstSpirit Launcher entfällt (JAR Packing Tool)
Die Pack200-Komprimierung der JAR-Dateien, die beim Ausführen der FirstSpirit-Desktop-Anwendungen vom Server zum Anwender-Rechner übertragen werden, wurde nun auch im FirstSpirit Launcher ausgebaut. (Der Ausbau in FirstSpirit erfolgte bereits mit FirstSpirit 2020-03).
Sofern die FirstSpirit-Desktop-Anwendungen über den FirstSpirit Launcher gestartet werden, werden nun auch hier die unkomprimierten JARs übertragen.

Bei der Ausgabe eines Datums über die JSON-Funktion werden jetzt auch die beiden Modi TIME und DATE für Datumsfelder gesondert berücksichtigt.

Der Modus wird nun ebenfalls bei der Ausgabe der Eingabekomponente CMS_INPUT_DATE ausgegeben, z. B.:

         "datetime": {
            "fsType": "CMS_INPUT_DATE",
            "name": "datetime",
            "value": "2020-10-01T09:51:12Z",
            "mode": "DATETIME"
         }

Wird der Wert der Eingabekomponente CMS_INPUT_DATE im Modus TIME oder DATE ausgegeben, wird der eingegebene Zeitpunkt unmodifiziert ausgegeben. Aus Kompatibilitätsgründen wird hierbei ebenfalls die Zeitzone UTC verwendet.

Beispiele:

• 1.10.2020: „2020-10-01T00:00Z“,
• 18:51Uhr: „1970-01-01T18:51:16Z“

Wird der Wert der Eingabekomponente CMS_INPUT_DATE im Modus DATETIME ausgegeben, wird der eingegebene Zeitpunkt in die Zeitzone UTC umgerechnet und entsprechend modifiziert ausgegeben.

Beispiele:

• Berlin: 1.10.2020 21:00 Uhr: „2020-10-01T19:00:00.000Z“
• New York: 1.10.2020 21:00 Uhr: „2020-10-02T01:00:00.000Z“
• Tokyo: 1.10.2020 21:00 Uhr: „2020-10-01T13:00:00.000Z“