Release Notes

Für FirstSpirit-Skripte können (wie alle Vorlagentypen) Formulare und Regeln („Dynamische Formulare“) definiert werden. Das Formular kann dann per

context.showForm();

an der gewünschten Stelle angezeigt werden.

Die Validierung (Auswertung der Regeln) lässt sich sprachweise deaktivieren, sodass für das Formular definierte Regeln für die betreffende/n Sprache/n ignoriert werden (FirstSpirit ServerManager / Projekteigenschaften / Sprachen, Checkbox „Sprache validieren“).

Im Falle von sprachunabhängigen Formularen wurden Regeln im ContentCreator bisher teilweise nicht ausgewertet, da für das Formular anstelle der Mastersprache die Vorschausprache berücksichtigt wurde.

Mit dem aktuellen Release wird jetzt auch im Fall von sprachunabhängigen Formularen (analog zum Verhalten im FirstSpirit SiteArchitect) die Einstellung in den Projekteigenschaften („Sprachen“, Checkbox „Sprache validieren“) entsprechend der Mastersprache berücksichtigt.

Ebenso wurde die Verwendung von ShowFormDialogOperation (Package de.espirit.firstspirit.ui.operations, FirstSpirit Developer-API) an das Verhalten des SiteArchitect angepasst. Mit diesem Interface können projektspezifische Dialoge erstellt und konfiguriert werden.

• Vorselektierung der Sprache: setPreselectedLanguage(...)
  Ist setPreselectedLanguage(...) nicht definiert, wird der Dialog in der Mastersprache geöffnet.
• Definition der Sprachmenge: setMultiLanguage(...)
  Für sprachabhängige (mehrsprachige) Formulare ist ein Aufruf von setMultiLanguage(true) erforderlich. Die zu bearbeitende Sprachmenge wird an perform(...) übergeben, und kann im Anschluss im Dialog per Menü ausgewählt werden.
  
  Alternativ kann setMultiLanguage(false) (Default) verwendet werden, wenn Inhalte nur in einer vorgegebenen Sprache geändert werden sollen können. Werden in diesem Fall mit perform(...) mehrere Sprachen übergeben, kann nur die vorselektierte oder erste Sprache bearbeitet werden, und es wird eine Debug-Log-Meldung ausgegeben.

Beispiel:

...
import de.espirit.firstspirit.agency.FormsAgent;
import de.espirit.firstspirit.agency.LanguageAgent;
import de.espirit.firstspirit.agency.OperationAgent;
import de.espirit.firstspirit.ui.operations.ShowFormDialogOperation;

...

formsAgent = context.requireSpecialist(FormsAgent.TYPE);
form = formsAgent.getForm(formdefinition);

la = context.requireSpecialist(LanguageAgent.TYPE);
langs = la.getLanguages();
en = la.getProjectLanguages(false).get("EN");
de = la.getProjectLanguages(false).get("DE");
fr = la.getProjectLanguages(false).get("FR");

sfd = context.requireSpecialist(OperationAgent.TYPE).getOperation
 (ShowFormDialogOperation.TYPE);
sfd.setTitle("My form");
sfd.setMultiLanguage(true);
sfd.setPreselectedLanguage(fr);
sfd.setRuleset(rules);
sfd.setValidation(true);
sfd.perform(form, langs);

In diesem Beispiel wird der Dialog mit der vordefinierten Sprache („FR“) geöffnet. Die Sprache kann im Dialog per Menü ausgewählt werden.

Die Struktur einer Website wird im FirstSpirit ContentCreator durch so genannte Menüpunkte und Seiten abgebildet:
Während jede Seite

eine konkrete Webseite darstellt, entspricht jeder Menüpunkt

einem Menüpunkt in der Navigation der Website.

Festlegen von Startmenü bzw. -seite
Je nach Website-Struktur kann ein Menüpunkt nicht nur mehrere Unter-Menüpunkte, sondern auch mehrere unterschiedliche Seiten umfassen. Ebenso kann es auch Menüpunkt geben, die keine Seite haben.
Welche Seite oder welcher Menüpunkt konkret geöffnet wird, wenn der User Menüpunkte in der Website anklickt, konnte bisher nur über den FirstSpirit SiteArchitect eingestellt werden.

Mit dem aktuellen Release kann dies jetzt auch über den FirstSpirit ContentCreator gesteuert werden, und zwar über folgende Kontextmenüfunktionen in der Navigationsansicht:

• Als Startmenü festlegen
  Besitzt ein Menüpunkt keine konkrete Seite oder mehrere Unter-Menüpunkte, wird bei einem Klick auf den entsprechenden Menüpunkt auf der Website direkt zu den Seiten in dem als „Startmenü“ festgelegten Unterseiten weitergeleitet.
• Als Startseite festlegen
  Befinden sich mehrere Seiten in einer Menüebene, wird bei einem Klick auf den entsprechenden Menüpunkt auf der Website die als „Startseite“ festgelegte Seite angezeigt.

Änderungen in diesem Bereich müssen freigegeben werden, damit sie sich auf der Website auswirken.
Welches Element jeweils Startmenü bzw. -seite ist, kann in der Navigationsansicht anhand des Icons

Sichtbarkeit von Menüpunkten steuern
Bisher konnte im FirstSpirit SiteArchitect die Sichtbarkeit von Menüpunkten für jede Sprache eingestellt werden, und zwar über die Option „In Navigationsmenü anzeigen“ einer Menüebene (Register „Eigenschaften“):

Über diese Option können Menüpunkte sprachweise vorübergehend aus der Webseite herausgenommen und später wieder hinzugefügt werden.

Mit dem aktuellen Release kann diese Einstellung jetzt auch im FirstSpirit ContentCreator vorgenommen werden, und zwar in der Navigationsansicht:

• Im Navigationsmenü verstecken
  Der betreffende Menüpunkt wird in der gewählten Sprache nicht mehr auf der Website angezeigt.
• Im Navigationsmenü anzeigen
  Versteckte bzw. ausgeblendete Menüpunkte werden in der gewählten Sprache wieder auf der Website angezeigt.

Änderungen in diesem Bereich müssen freigegeben werden, damit sie sich auf der Website auswirken.

Menüpunkte, die auf der Website nicht sichtbar / versteckt sind, werden durch folgendes Icon in der Navigationsansicht visualisiert:

Zusätzlich ist der Menüname ausgegraut.

Für weitere Informationen siehe auch FirstSpirit Handbuch für Redakteure (ContentCreator), „Menüfunktionen / Navigation“
(https://docs.e-spirit.com/contentcreator/menuefunktionen/navigation/index.html)

Seit FirstSpirit 2020-10 können im FirstSpirit ContentCreator Funktionen projektweise ausgeblendet werden („Tailored UI“).
Mit dem aktuellen Release wurden jetzt im Rahmen dieser Funktionalität Optimierungen vorgenommen und weitere Konfigurationsmöglichkeiten implementiert:

Konfigurierbare Funktionen
Zusätzlich zu den Standardfunktionen des ContentCreator werden im Konfigurationsdialog alle von FirstSpirit erkannten ItemsPlugins aufgelistet und können dort bearbeitet werden.
Zur Konfiguration von Funktionen, die aus kundenspezifischen Modulen stammen, ist das Feld „Plugin“ jetzt nun eine editierbare Combobox. Auch diese listet die von FirstSpirit erkannten ItemsPlugins auf.

Die Tabellenspalten des Konfigurationsdialogs sind für ein komfortableres Auffinden von Funktionen jetzt per Klick auf den Spaltenkopf sortierbar.

Sortierung von Menüeinträgen und Icons beeinflussen
Über das Register „Features: Order“ kann jetzt auch die Reihenfolge von Funktionen in der Oberfläche des ContentCreator beeinflusst werden („FirstSpirit ServerManager / Projekt-Eigenschaften / Projekt-Komponenten / CXT ContentCreator Extension: Feature Configuration“).

Für eine bessere Übersicht werden die Funktionen nach Gruppen gebündelt angezeigt.
Die Funktionen lassen sich innerhalb ihrer Gruppe per Drag-and-drop sortieren. Änderungen werden ohne Nachfrage direkt gespeichert.

Wurde die Standard-Sortierung einer Gruppe verändert, wird dies durch das Label „Custom Order“ visualisiert. Die Sortierung wird darüber hinaus in der Übersicht dargestellt (Spalte „Order“).

Die Standard-Sortierung kann mit einem Klick gruppenweise wiederhergestellt werden.

Einschränkungen:
Die festgelegte Reihenfolge der Funktionen wird als Richtlinie betrachtet. Im Client kann sie leicht abweichen, um Design- und Bedienvorgaben des ContentCreator nicht zu umgehen:
Für die Funktionen in der Vorschau gibt es beispielsweise eine automatische Gruppierung, sobald mehrere Iconleisten verschachtelt werden, sowie eine Primäraktion, z. B. das Editieren.
Der „Meine Änderungen“-Report wird immer im unteren Bereich angezeigt wird, ganz unabhängig von seiner Position in der Sortierreihenfolge. Die Reports „Suche“ und „Dashboard“ können in ihrer Position nicht verändert werden. Sie können auch nicht ausgeblendet werden.
Generell werden die Funktionen rechtsbündig dargestellter Menüleisten (EasyEdit) auch rechtsbündig einsortiert.

Serverweite Konfiguration
Zusätzlich zur projekt-lokalen Konfiguration lässt sich nun über den „Feature Configuration Service“ eine serverweite Einstellung vornehmen (FirstSpirit ServerManager / „Module / FirstSpirit CXT ContentCreator Extension“):

Voraussetzung: Im Bereich „ContentCreator“ muss die Web-Komponente „CXT ContentCreator Extension: WebApp for ContentCreator“ hinzugefügt werden (FirstSpirit ServerManager / „Server-Eigenschaften / Web-Applikationen“).
Gibt es projektlokale ContentCreator-Instanzen, muss die Web-Komponente auch dort hinzugefügt werden (unter FirstSpirit ServerManager / „Projekteigenschaften / Web-Komponenten“).

Die Konfiguration erfolgt analog zu der auf Projektebene.

Hinweis: Aktuell muss für jedes Projekt eines Servers die Projekt-Komponente „CXT ContentCreator Extension: Feature Configuration“ („FirstSpirit ServerManager / Projekt-Eigenschaften / Projekt-Komponenten“) vorhanden sein, für die eine Konfiguration der ContentCreator-Funktionen vorgenommen werden soll. Über diese Projekt-Komponente wird aktuell noch die Konfiguration pro Projekt vorgenommen.
Konfiguration, die auf Serverebene (über den Service „Feature Configuration Service“) vorgenommen wird, muss aktuell über die Funktion From Service in das jeweilige Projekt übernommen werden, um sie dort verwenden zu können.
In einem zukünftigen Release wird für Projekte ohne Projekt-Komponente „CXT ContentCreator Extension: Feature Configuration“ die Konfiguration des „Feature Configuration Service“ berücksichtigt. Die Verwendung der Projekt-Komponente wird dann optional sein, eine Konfiguration auf Serverebene ist dann ausreichend.

Bestehende Konfiguration aus einem Projekt kann im „Feature Configuration Service“ über die Schaltfläche From Project für den Server übernommen werden.
Auch andersherum kann für ein Projekt eine auf Serverebene vorgenommene Konfiguration übernommen werden, und zwar über die Schaltfläche From Service.
Bestehende Konfigurationen werden ohne Nachfrage überschrieben, eine Vererbung von Einstellungen o.Ä. wird nicht unterstützt.

Bei Bedarf kann die gesamte aktuelle Konfiguration in JSON-Format exportiert und anschließend auf einen anderen FirstSpirit-Server übertragen werden.

Migrationshinweise:

• Aktionen, die bisher in der Standardgruppe StoreTree zusammengefasst wurden (Funktionen der Baumansicht in der Navigationsleiste und in der Medien-Verwaltung) finden sich jetzt in der Gruppe Navigation. Die Standardgruppe StoreTree wurde entfernt. Diese Änderung wird bei einem Update auf das aktuelle FirstSpirit-Release automatisch durchgeführt. Es ist keine manuelle Anpassung erforderlich.
• Bestehende Konfiguration, die vor einem Upgrade auf FirstSpirit 2020-12 auf Projekt-Ebene vorgenommen wurde, ist nach einem Upgrade auf FirstSpirit 2020-12 weiterhin gültig. Um eine auf Serverebene vorgenommene Konfiguration zu übernehmen, kann die Funktion From Service der Projekt-Komponente „CXT ContentCreator Extension: Feature Configuration“ für das oder die gewünschte/n Projekt/e verwendet werden, damit eine auf Serverebene vorgenommene Konfiguration im Projekt zum Tragen kommt.

Für weitere Informationen siehe auch FirstSpirit Online Dokumentation, „Vorlagenentwicklung / ContentCreator / Customization / Standardfunktionen“ (https://docs.e-spirit.com/odfs/vorlagenentwick/contentcreator/customization/standardfunktio/index.html)

Für CMS_INPUT_DOM und CMS_INPUT_DOMTABLE können über das Tag FORMATS Formatvorlagen definiert werden, die in der Eingabekomponente verwendet werden dürfen, z. B.

  <CMS_INPUT_DOM name="st_text" hFill="yes" list="no">
         <FORMATS>
           <TEMPLATE name="standard"/>
           <TEMPLATE name="h3"/>
         </FORMATS>
         <LANGINFOS>
           <LANGINFO lang="*" label="Text"/>
         </LANGINFOS>
</CMS_INPUT_DOM>

Wurde die FORMATS-Konfiguration nachträglich geändert, z. B. indem eine TEMPLATE-Definition entfernt wurde, konnte dies dazu führen, dass sich bereits vorhandene Inhalte im ContentCreator nicht mehr speichern ließen (beispielhafte Fehlermeldung: „Referenced element 'xyz' does not exist.“).

Mit dem aktuellen Release berücksichtigen CMS_INPUT_DOM und CMS_INPUT_DOMTABLE im ContentCreator nun auch (analog zum SiteArchitect) nicht mehr gültige Formatvorlagen: entsprechende Formatierungen bleiben somit auch beim Speichern erhalten.
Auch wenn innerhalb der Formatierung der Text editiert wird, bleibt die Formatierung nach dem Speichern erhalten.

Da es im Falle von langsamen Verbindungen bei Verbindungsproblemen zu einem häufigen Neuladen des gesamten Clients kommen konnte, wird jetzt bei Verbindungsproblemen statt eines Neuladens der Seite eine entsprechende Meldung am unteren Rand des Browsers eingeblendet:

(„Es bestehen Probleme mit Ihrer Netzwerk-Verbindung. Bitte wenden Sie sich an Ihren Administrator!“)

Ausnahmen:
Einen automatischen Reload gibt es weiterhin für

• Authentifizierungsfehler (Fehlercode 403 / „Zugriff verweigert/unzulässig“, mit anschließender Anzeige der Loginseite)
• den Wartungsmodus (Anzeige eines entsprechenden Texts im Client)

Beispiele für mögliche Ursachen für Verbindungsprobleme: Die Verbindung zwischen dem Browser und dem Application Server (z. B. Apache Tomcat) ist nicht stabil. Darüber hinaus kann es mit HTTP 2.0 je nach Konfiguration und langsamen Verbindungen zu Problemen kommen (siehe dazu u.a. Attribut writeTimeout auf der Seite https://tomcat.apache.org/tomcat-9.0-doc/config/http2.html).
Die jeweils betroffene Verbindung sollte vom Administrator geprüft werden (z. B. über die Network-Aktivität im Browser und das Access-Log des Application Server) und analysiert werden, warum Requests nicht beendet werden.

Im Prozess der Vorlagenentwicklung dient die Vorschau des ContentCreator auch dem Entwickler zur Prüfung seiner Änderungen an Vorlagen.
Bisher mussten oft Inhalte verändert und gespeichert werden, damit Änderungen an der zugrundeliegenden Vorlage in der Vorschau berücksichtigt wurden.
Mit dem aktuellen Release die Vorschau-Aktualisierung im ContentCreator nach Änderungen an Vorlagen verbessert und somit die Vorlagenentwicklung vereinfacht.

Werden Änderungen an zugrundeliegenden Vorlagen in der Vorschau des ContentCreator nicht dargestellt, kann die Vorschau folgendermaßen manuell aktualisiert werden:

• F5 : Der ContentCreator wird neu geladen.
• Strg + R : Lediglich die Vorschau wird neu geladen.

In beiden Fällen wird automatisch /forceRefresh=1 an die URL angehängt.

Mit dem neuen ContentCreator berücksichtigt die Status-Anzeige in der Menüleiste nicht mehr nur Seiten (Element-Typ PageRef) und Datensätze (Element-Typ Dataset), sondern auch andere Element, wie z. B. Medien-Ordner.

In diesem Kontext wurde jetzt das Interface WebeditElementStatusProviderPlugin (Package de.espirit.firstspirit.workflow, FirstSpirit Developer-API) um die optionale Methode

isSupported(IDProvider)

erweitert.
Mit dieser Methode kann das Plugin eine Unterstützung für Elemente abseits der standardmäßig unterstützten Element-Typen PageRef und Dataset anbieten.
Sie liefert zurück, ob das Plugin das jeweilige Element unterstützt (true) oder nicht (false).

Wie bisher können durch das Plugin mit den Methoden

getReleaseState()
getWorkflowGroups()

auch abhängige Objekte für die Status-Anzeige und Arbeitsabläufe berücksichtigt werden. Durch die neue Methode können diese Abhängigkeiten nun auch für andere Element-Typen berücksichtigt werden.

Für alle laut konfiguriertem Plugin nicht unterstützten IDProvider-Elemente werden hingegen keine Abhängigkeiten berücksichtigt.

Zu weiteren Informationen siehe auch das entsprechende Kapitel zur Plugin-Entwicklung des „Element Status Provider“ (ESP): https://docs.e-spirit.com/odfs/plugin-entwickl/contentcreator/interaktive-fea/elementstatus-a/funktionsuebers/index.html

Mit dem aktuellen FSDevTools-Release (Release 2.6.4) können Entwickler Webkomponenten, Projektapplikationen und Dienste über das Kommandozeilen-Werkzeug „FSDevTools“ konfigurieren.

Anwendungsfälle:

• Webkomponenten in WebApps installieren/aktualisieren (und neu ausrollen)
• Projektkomponenten zu Projekten hinzufügen/aktualisieren
• Dienste konfigurieren/neustarten

Die Konfiguration wird über eine Konfigurationsdatei im JSON-Format über das Kommando fs-cli module configure -mcf|--moduleConfigFile "path/to/configFile.json" vorgenommen.

Die Ergebnisse des Aufrufs können über das Kommando fs-cli [...] [-rf|--resultFile "path/to/result.json"] in eine weitere Datei (ebenfalls im JSON-Format) geschrieben werden.

Syntax:

fs-cli [...] [-rf|--resultFile "path/to/result.json"] 
module configure -mcf|--moduleConfigFile "path/to/configFile.json"

Werden bei der Konfiguration Dateien hochgeladen, so werden diese automatisch in das entsprechende Verzeichnis für das Modul hochgeladen.

Wird in der JSON-Konfigurationsdatei ein Ordner angegeben, so wird die entsprechende Ordnerstruktur im Dateisystem des Servers neu angelegt (wobei nur Unterordner unter dem angegebenen Ordner erzeugt werden)

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

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

Die (aktuell nur intern verfügbare) FragmentCreator-API bietet zwei neue Methoden:

isFragmentProject

Mit dieser Methode kann jetzt ermittelt werden, ob es sich bei einem Projekt um ein Fragmente-Projekt handelt.
In diesem Fall wird true zurückgeliefert. Handelt es sich nicht um ein Fragmente-Projekt, wird false zurückgeliefert.
Dabei wird geprüft, ob das Projekt eine Metadaten-Vorlage mit einer Eingabekomponente vom Typ CMS_GROUP mit dem Bezeichner editions enthält. Erst mithilfe dieser Konfiguration kann das Varianten-Konzept im Projekt umgesetzt werden. Damit ist diese Metadaten-Konfiguration obligatorisch für Fragmente-Projekte und dient als Unterscheidungsmerkmal gegenüber klassischen FirstSpirit-Projekten.

Projekte mit dieser Basis-Konfiguration können mit der ebenfalls neuen Methode

convertToFragmentProject

erstellt werden. Diese Methode kann nur auf leere FirstSpirit-Projekte angewendet werden. Für auf diese Weise konfigurierte Projekt gibt isFragmentProject true zurück.

Hinweis: Die Verwendung der API ist aktuell noch für den internen Gebrauch bestimmt und wird noch intern getestet. Zukünftig soll sie auch Partnern und Kunden bereitgestellt werden.

Mit dem aktuellen FirstSpirit-Release erfolgt die endgültige Freigabe des Datenbank-Layers Oracle Database 19c.

In der FirstSpirit Community (https://community.e-spirit.com) ist weiterhin ein ausführlicher Migrationsleitfaden für die Umstellung von Oracle Database 11g/12c auf Oracle Database 19c zur Verwendung mit FirstSpirit hinterlegt.

Der alte Datenbank-Layer Oracle Database 11g/12c (de.espirit.or.impl.oracle.OracleLayer) wird zukünftig entfallen. Geplant ist der Entfall mit FirstSpirit 2021-06.

Mit dem Prozessor M1 nimmt Apple einen Architekturwechsel zur ARM-Architektur vor. Programme, die für die x86-Architektur entwickelt wurden (wie FirstSpirit), können mithilfe der Emulationstechnik Rosetta 2 weiterhin ausgeführt werden.

Aktuell sind uns keine Probleme bei der Verwendung von FirstSpirit mit Rosetta 2 bekannt. Eine native Unterstützung der ARM-Architektur ist für FirstSpirit zurzeit nicht geplant.

Das Interface SnippetAgent (Package de.espirit.firstspirit.agency, FirstSpirit Access-API) wurde um Methoden zur Übergabe von FormData-Objekten erweitert.

Mit den neuen Methoden

getSnippetProvider(@NotNull FormData formData, @NotNull Snippet snippet)

getSnippetProvider(@NotNull FormData formData, @NotNull Snippet snippet, @NotNull 
   SnippetContext context)

ist es nun möglich, durch Übergabe des entsprechenden FormData-Objekts einen SnippetProvider zu bekommen.

Mit der aktuellen FirstSpirit-Version wurde die Regelauswertung (Funktionalität „Dynamische Formulare“) für den ContentCreator und den SiteArchitect erweitert.

Was ist neu?

Es werden die Dienste FormDataValueService und MetaDataValueService bereitgestellt. Diese Dienste bieten Zugriff auf die Informationen eines IDProviders.

Des Weiteren stehen jetzt in den Regeln drei neue Eigenschaften für entsprechende Elemente zur Verfügung:

• PAGE_ID: Ermittlung der ID eines FirstSpirit-Elements vom Typ Page
• PAGE_UID: Ermittlung des Referenznamens / UID eines FirstSpirit-Elements vom Typ Page
• PROJECT_PROPERTIES_ID: Ermittlung der ID von Projekteigenschaften.

Diese erweitern die bereits vorhandenen Eigenschaften:

• ID: Ermittlung der ID eines FirstSpirit-Elements
• UID: Ermittlung des Referenznamens / UID eines FirstSpirit-Elements. Absätze haben technisch gesehen keine UID, daher wird bei Absätzen der Anzeigename zurückgegeben.
• GID: Ermittlung der globalen ID (GID) eines FirstSpirit-Elements
• TEMPLATE: Ermittlung der Vorlage des aktuellen FirstSpirit-Elements. Es wird der Referenzname der Vorlage zurückgegeben (UID).

Wozu brauche ich diese Funktionalität?

Mithilfe der Erweiterungen kann innerhalb einer Regelausführung auf FirstSpirit-Elemente zugegriffen werden, die außerhalb des aktuellen Kontextes liegen. Damit können Informationen aus anderen Formularen (z. B. Formulardaten aus einer anderen Seite, aus Metadaten-Formularen oder aus den Projekteinstellungen) geholt und innerhalb der aktuellen Regelausführung verwendet werden.

Wie kann ich diese Funktionalität verwenden?

Bereitstellung und Konfiguration:

Die Dienste FormDataValueService und MetaDataValueService stehen mit der aktuellen FirstSpirit-Version sowohl im SiteArchitect als auch im ContentCreator automatisch zur Verfügung. Eine gesonderte Konfiguration oder Aktivierung der Funktionalität ist nicht notwendig.

Verwendung:

Die Daten werden innerhalb des Formulars (im Register „Regeln“) mithilfe des Tags <SCHEDULE/> geholt.

• Der FormDataValueService ermöglicht den Zugriff auf die Daten eines Formulars.
• Der MetaDataValueService ermöglicht den Zugriff auf die Daten eines Metadatenformulars.

Der Zugriff auf ein FirstSpirit-Element (innerhalb des <SCHEDULE/>-Tags) erfolgt über die Parameter:

• ID und Storetype,
• UID und UIDType oder
• GID und Template (nur für Datensätze).

Anschließend wird die Auswahl über weitere Parameter eingegrenzt:

• auf bestimmte Eingabekomponenten (Parameter FIELD)
• auf Inhalte in einer bestimmten Sprache (Parameter LANGUAGE)

Weiterführende Informationen zu den neuen Parametern und weitere Beispiele:

• siehe Dokumentation Auf Informationen aus anderen Formularen zugreifen.

Beispiel:

Zugriff auf Metadaten auf Seitenebene (<SCHEDULE/>-Tag):
Das Beispiel A ermöglicht den Zugriff auf Metadaten (service="MetaDataValueService").
Hier wird der Wert der Eingabekomponente („md_layout“) (über den Parameter FIELD) der Seite „PAGE_UID“ (über die Parameter UID und UIDTYPE) geholt.
Verwendung im aktuellen Kontext (<DO/>-Tag):
Dieser Wert wird in der Eingabekomponente („st_layouttext“) des aktuellen Absatzes gespeichert, um den Wert anschließend in anderen Regeln weiter zu verwenden.

	<RULE when="ONLOCK">
		<SCHEDULE delay="0" id="A" service="MetaDataValueService">
			<PARAM name="UID">
				<PROPERTY name="PAGE_UID" source="#global"/>
			</PARAM>
			<PARAM name="UIDTYPE">
				<TEXT>PAGESTORE</TEXT>
			</PARAM>
			<PARAM name="FIELD">
				<TEXT>md_layout</TEXT>
			</PARAM>
			<PARAM name="LANGUAGE">
				<PROPERTY source="#global" name="MASTER" />
			</PARAM>
		</SCHEDULE>
		<DO>
			<PROPERTY name="VALUE" source="st_layouttext"/>
		</DO>
	</RULE>

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

Eclipse Jetty (im Modul fs-jetty.fsm / „FirstSpirit Jetty Service“ enthalten)

Aktualisierung von Version 9.4.31 auf Version 9.4.33

Install4j (Verwendung für den FirstSpirit Launcher)

Aktualisierung von Version 8.0.4 auf Version 8.0.8.

Java Die folgende neue Java-Version ist verfügbar:

• In FirstSpirit integriert (Standard): 11.0.9.1+1 64bit AdoptOpenJDK
• Im FirstSpirit Launcher JRE Modul: 15.0.1+9 64bit AdoptOpenJDK

Java Service Wrapper (Konfiguration und Überwachung der FirstSpirit Java VM)

Aktualisierung von Version 3.5.42 auf Version 3.5.44.

Hinweis: Bei einer Aktualisierung des FirstSpirit-Servers (Auto-Update, Inplace-Upgrade) werden die Dateien des Java Service Wrappers nicht automatisch aktualisiert. Der Java Service Wrapper kann gemäß FirstSpirit Installationsanleitung über das Tar-Gzip-Aktualisierungsarchiv (Datei fs-update-[version].tar.gz) aktualisiert werden.

Weiterführende Dokumentation:

• zum Java Service Wrapper (Handbuch für Administratoren)
• zur Aktualisierung des Java Service Wrappers (Installationsanleitung)

Spring Boot (für das MicroApp Framework)
Aktualisierung von Version 2.3.1 auf Version 2.3.5

Spring Cloud Hoxton (für das MicroApp Framework)
Aktualisierung von Version Hoxton.SR5 auf Version Hoxton.SR8